diff --git a/SOL004/LICENSE b/SOL004/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..8dada3edaf50dbc082c9a125058f25def75e625a
--- /dev/null
+++ b/SOL004/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/README.md b/SOL004/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..efd6db060fb1e89fd061befb421de88ffc15a5c5
--- /dev/null
+++ b/SOL004/README.md
@@ -0,0 +1,170 @@
+# README
+
+## Cloning the repo
+
+You need to clone the repo with the option "--recursive" to fetch all the dependent git modules:
+
+```bash
+# Clone with SSH
+git clone --recursive ssh://git@osm.etsi.org:29419/vnf-onboarding/osm-packages.git
+# Clone with HTTPS
+git clone --recursive https://osm.etsi.org/gitlab/vnf-onboarding/osm-packages.git
+```
+
+## Structure of the repo
+
+This repo contains OSM packages used for testing and for the hackfest.
+
+There is typically a folder for each VNF under test and NS to run the test, for instance:
+
+- `hackfest_basic_vnf`: the VNF package to run the hackfest basic test
+- `hackfest_basic_ns`: the NS package to run the hackfest basic test
+
+Please use the following conventions:
+
+- VNF folders should end with "_vnf"
+- NS folders should end with "_ns"
+
+Charm sources must be stored in the folder of the package, in `charms/layers` folder. If relations are in place, the charm interfaces must be stored in `charms/interfaces` folder.
+
+Thanks to the new way for building and generating packages, charms sources can be placed directly in the package folder, under `charms/layers/` folder, thus simplifying the structure. When building the package, the charm will be built and only the binaries will be placed in the tar.gz file.
+
+## Working with packages
+
+Osmclient has been improved so that all utilities required to validate and build the packages have been
+added. Now the single `osm` command line client is able to do everything you need to work with VNF and
+NS packages.
+
+### Uploading a package from a folder
+
+This is by far the simplest way of working. The following command will validate the package,
+build the charm from source if it exists under `PKGFOLDER/charms/layers`, build the tar.gz,
+and onboard/upload it to OSM.
+
+```bash
+osm nfpkg-create PKGFOLDER
+```
+
+For NS packages, the same applies.
+
+```bash
+osm nspkg-create PKGFOLDER
+```
+
+Full help for both commands is show below:
+
+```bash
+$ osm nfpkg-create --help
+Usage: osm nfpkg-create [OPTIONS] FILENAME
+
+  onboards a new NFpkg (alias of nfpkg-create)
+
+  FILENAME: NF Package tar.gz file, NF Descriptor YAML file or NF Package folder
+            If FILENAME is a file (NF Package tar.gz or NF Descriptor YAML), it is onboarded.
+            If FILENAME is an NF Package folder, it is built and then onboarded.
+
+Options:
+  --overwrite TEXT     Deprecated. Use override
+  --override TEXT      overrides fields in descriptor, format: "key1.key2...=value[;key3...=value;...]"
+  --skip-charm-build   The charm will not be compiled, it is assumed to already exist
+  --override-epa       adds guest-epa parameters to all VDU
+  --override-nonepa    removes all guest-epa parameters from all VDU
+  --override-paravirt  overrides all VDU interfaces to PARAVIRT
+  -h, --help           Show this message and exit.
+```
+
+```bash
+$ osm nspkg-create --help
+Usage: osm nspkg-create [OPTIONS] FILENAME
+
+  onboards a new NSpkg
+
+  FILENAME: NF Package tar.gz file, NF Descriptor YAML file or NF Package folder
+            If FILENAME is a file (NF Package tar.gz or NF Descriptor YAML), it is onboarded.
+            If FILENAME is an NF Package folder, it is built and then onboarded.
+
+Options:
+  --overwrite TEXT    Deprecated. Use override
+  --override TEXT     overrides fields in descriptor, format: "key1.key2...=value[;key3...=value;...]"
+  --skip-charm-build  The charm will not be compiled, it is assumed to already exist
+  -h, --help          Show this message and exit.
+```
+
+### Validating a descriptor
+
+The following command will look for all the descriptor files in a folder and validate them
+
+```bash
+osm package-validate PKGFOLDER
+```
+
+Some relevant options are shown below:
+
+```bash
+$ osm package-validate --help
+Usage: osm package-validate [OPTIONS] [BASE_DIRECTORY]
+
+  Validate descriptors given a base directory.
+
+  BASE_DIRECTORY: Stub folder for NS, VNF or NST package.
+
+Options:
+  --recursive / --no-recursive  The activated recursive option will validate the yaml files within the indicated directory and in its subdirectories
+  -h, --help                    Show this message and exit.
+```
+
+### Building a package
+
+The following command will validate and build the tar.gz file. It will als
+
+```bash
+osm package-build PKGFOLDER
+```
+
+Some relevant options are shown below:
+
+```bash
+$ osm package-build --help
+Usage: osm package-build [OPTIONS] PACKAGE_FOLDER
+
+  Build the package NS, VNF given the package_folder.
+
+  PACKAGE_FOLDER: Folder of the NS, VNF or NST to be packaged
+
+Options:
+  --skip-validation   skip package validation
+  --skip-charm-build  the charm will not be compiled, it is assumed to already exist
+  -h, --help          Show this message and exit.
+```
+
+### Creating a package structure
+
+The best way to work is by copying a previous one that is up-to-date. But you can also create
+a first skeleton using this command:
+
+```bash
+Usage: osm package-create [OPTIONS] PACKAGE_TYPE PACKAGE_NAME
+
+  Creates an OSM NS, VNF, NST package
+
+  PACKAGE_TYPE: Package to be created: NS, VNF or NST.
+  PACKAGE_NAME: Name of the package to create the folder with the content.
+
+Options:
+  --base-directory TEXT       (NS/VNF/NST) Set the location for package creation. Default: "."
+  --image TEXT                (VNF) Set the name of the vdu image. Default "image-name"
+  --vdus INTEGER              (VNF) Set the number of vdus in a VNF. Default 1
+  --vcpu INTEGER              (VNF) Set the number of virtual CPUs in a vdu. Default 1
+  --memory INTEGER            (VNF) Set the memory size (MB) of the vdu. Default 1024
+  --storage INTEGER           (VNF) Set the disk size (GB) of the vdu. Default 10
+  --interfaces INTEGER        (VNF) Set the number of additional interfaces apart from the management interface. Default 0
+  --vendor TEXT               (NS/VNF) Set the descriptor vendor. Default "OSM"
+  --override                  (NS/VNF/NST) Flag for overriding the package if exists.
+  --detailed                  (NS/VNF/NST) Flag for generating descriptor .yaml with all possible commented options
+  --netslice-subnets INTEGER  (NST) Number of netslice subnets. Default 1
+  --netslice-vlds INTEGER     (NST) Number of netslice vlds. Default 1
+  -h, --help                  Show this message and exit.
+```
+
+
+
diff --git a/SOL004/charm-packages/ha_proxy_charm_ns/ha_proxy_charm_nsd.yaml b/SOL004/charm-packages/ha_proxy_charm_ns/ha_proxy_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b9cb16a0ebbb47d9b22179263c2d9124683af21c
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_ns/ha_proxy_charm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - id: ha_proxy_charm-ns
+    name: ha_proxy_charm-ns
+    version: '1.0'
+    description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: ha_proxy_charm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: ha_proxy_charm-vnf
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: datanet
+    vnfd-id:
+    - ha_proxy_charm-vnf
diff --git a/SOL004/charm-packages/ha_proxy_charm_ns/icons/osm.png b/SOL004/charm-packages/ha_proxy_charm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/ha_proxy_charm_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/actions.yaml b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f9882c47bba960254e0381e5b5ab1c0688de6cf5
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,54 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/config.yaml b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..93e3cab01c0843418c57e4bc918eb933f2daf934
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/config.yaml
@@ -0,0 +1,41 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/install b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/start b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/charms/osm b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/charms/osm
new file mode 120000
index 0000000000000000000000000000000000000000..48bb95e0a5f6ba4f472c2d761cf84d3f9734fea4
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/charms/osm
@@ -0,0 +1 @@
+../../mod/charms.osm/charms/osm/
\ No newline at end of file
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/ops b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/metadata.yaml b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d6d0cd70360fb011c2b2a36442d967b104050810
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,27 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-ha-proxy
+summary: A simple example proxy charm
+description: |
+  Simple proxy charm is an example charm used in OSM Hackfests
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/src/charm.py b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/charms/simple/src/charm.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/ha_proxy_charm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/ha_proxy_charm_vnfd.yaml b/SOL004/charm-packages/ha_proxy_charm_vnf/ha_proxy_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2b6ebd280767b74ac002568c9314005da9c13493
--- /dev/null
+++ b/SOL004/charm-packages/ha_proxy_charm_vnf/ha_proxy_charm_vnfd.yaml
@@ -0,0 +1,97 @@
+vnfd:
+  id: ha_proxy_charm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: ha_proxy_charm-vnf
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  version: 1.0
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+          - id: ha_proxy_charm-vnf
+            execution-environment-list:
+            - id: simple-ee
+              juju:
+                charm: simple
+            config-access:
+              ssh-access:
+                default-user: ubuntu
+                required: true
+            config-primitive:
+            - name: touch
+              execution-environment-ref: simple-ee
+              parameter:
+              - data-type: STRING
+                default-value: /home/ubuntu/touched
+                name: filename
+            initial-config-primitive:
+            - name: config
+              execution-environment-ref: simple-ee
+              parameter:
+              - name: ssh-hostname
+                value: <rw_mgmt_ip>
+              - name: ssh-username
+                value: ubuntu
+              - name: ssh-password
+                value: osm4u
+              seq: 1
+            - name: touch
+              execution-environment-ref: simple-ee
+              parameter:
+              - data-type: STRING
+                name: filename
+                value: /home/ubuntu/first-touch
+              seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: "1"
+    virtual-memory:
+      size: "1.0"
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: "10"  
diff --git a/SOL004/charm-packages/ha_proxy_charm_vnf/icons/osm.png b/SOL004/charm-packages/ha_proxy_charm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/ha_proxy_charm_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/k8s_proxy_charm_ns/icons/osm.png b/SOL004/charm-packages/k8s_proxy_charm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/k8s_proxy_charm_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/k8s_proxy_charm_ns/k8s_proxy_charm_nsd.yaml b/SOL004/charm-packages/k8s_proxy_charm_ns/k8s_proxy_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..beae3243b71a197f06f18c76c3fb3d277842df19
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_ns/k8s_proxy_charm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: k8s_proxy_charm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: k8s_proxy_charm-vnf
+    id: k8s_proxy_charm-ns
+    name: k8s_proxy_charm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: datanet
+    vnfd-id:
+    - k8s_proxy_charm-vnf
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/actions.yaml b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f9882c47bba960254e0381e5b5ab1c0688de6cf5
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,54 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/config.yaml b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..93e3cab01c0843418c57e4bc918eb933f2daf934
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/config.yaml
@@ -0,0 +1,41 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/install b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/start b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/charms b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/charms
new file mode 120000
index 0000000000000000000000000000000000000000..bbb3079ba31017d6958b659dc899d072b1c8e724
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/charms
@@ -0,0 +1 @@
+../mod/charms.osm/charms
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/ops b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/metadata.yaml b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..4b5b352850eb98a4e2028942957cebc622a2395e
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-k8s-proxy
+summary: A simple example proxy charm
+description: |
+  Simple proxy charm is an example charm used in OSM Hackfests
+series:
+  - kubernetes
+peers:
+  proxypeer:
+    interface: proxypeer
+deployment:
+  mode: operator
\ No newline at end of file
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/src/charm.py b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/charms/simple/src/charm.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/k8s_proxy_charm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/icons/osm.png b/SOL004/charm-packages/k8s_proxy_charm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/k8s_proxy_charm_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/k8s_proxy_charm_vnf/k8s_proxy_charm_vnfd.yaml b/SOL004/charm-packages/k8s_proxy_charm_vnf/k8s_proxy_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..30f617e8ade1d467db87a2120bd15f31c259cf30
--- /dev/null
+++ b/SOL004/charm-packages/k8s_proxy_charm_vnf/k8s_proxy_charm_vnfd.yaml
@@ -0,0 +1,98 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+              cloud: k8s
+          id: k8s_proxy_charm-vnf
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm4u
+            seq: 1
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: k8s_proxy_charm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: k8s_proxy_charm-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10  
diff --git a/SOL004/charm-packages/native_charm_ns/icons/osm.png b/SOL004/charm-packages/native_charm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/native_charm_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/native_charm_ns/native_charm_nsd.yaml b/SOL004/charm-packages/native_charm_ns/native_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..43633090c6a3e9289bef2fdb161aec40e3fbd0e6
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_ns/native_charm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: native_charm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: native_charm-vnf
+    id: native_charm-ns
+    name: native_charm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: datanet
+    vnfd-id:
+    - native_charm-vnf
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/actions.yaml b/SOL004/charm-packages/native_charm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/config.yaml b/SOL004/charm-packages/native_charm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/install b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/start b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/lib/ops b/SOL004/charm-packages/native_charm_vnf/charms/simple/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/metadata.yaml b/SOL004/charm-packages/native_charm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5e832fb61f0c21dd8c17f06822679164f855e0c8
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
\ No newline at end of file
diff --git a/SOL004/charm-packages/native_charm_vnf/charms/simple/src/charm.py b/SOL004/charm-packages/native_charm_vnf/charms/simple/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..9ef7d07286257338ea1ef940fb34f67a9052f998
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/charms/simple/src/charm.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/native_charm_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/native_charm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/native_charm_vnf/icons/osm.png b/SOL004/charm-packages/native_charm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/native_charm_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/native_charm_vnf/native_charm_vnfd.yaml b/SOL004/charm-packages/native_charm_vnf/native_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e037d32a5c2f53f533917b2b8352c5b6a200e6a7
--- /dev/null
+++ b/SOL004/charm-packages/native_charm_vnf/native_charm_vnfd.yaml
@@ -0,0 +1,88 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: mgmtVM
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+              proxy: false
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: native_charm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: native_charm-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/native_k8s_charm_ns/native_k8s_charm_nsd.yaml b/SOL004/charm-packages/native_k8s_charm_ns/native_k8s_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..96897b9434bcd9a54bf16d5207f9ff45010fee0a
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_ns/native_k8s_charm_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: NS with 1 KDU connected to the mgmtnet VL
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: native_k8s_charm-vnf
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: native_k8s_charm-vnf
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: native_k8s_charm-vnf
+    id: native_k8s_charm-ns
+    name: native_k8s_charm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - native_k8s_charm-vnf
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions.yaml b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..191e5552be1c28345ee1edb03945baa249ac5539
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions.yaml
@@ -0,0 +1,8 @@
+changecontent:
+    description: "Change content of default html"
+    params:
+        customtitle:
+            description: "New Title"
+            default: ""
+    required:
+        - customtitle
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions/changecontent b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions/changecontent
new file mode 100755
index 0000000000000000000000000000000000000000..030b8ecb9782014d271512022a7b59f798f0ae90
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/actions/changecontent
@@ -0,0 +1,31 @@
+#!/bin/bash
+
+CUSTOM_TITLE=`action-get customtitle`
+
+cat > /usr/share/nginx/html/index.html <<EOF
+<!DOCTYPE html>
+<html>
+<head>
+<title>$CUSTOM_TITLE</title>
+<style>
+    body {
+        width: 35em;
+        margin: 0 auto;
+        font-family: Tahoma, Verdana, Arial, sans-serif;
+    }
+</style>
+</head>
+<body>
+<h1>$CUSTOM_TITLE</h1>
+<p>If you see this page, the nginx web server is successfully installed and
+working. Further configuration is required.</p>
+
+<p>For online documentation and support please refer to
+<a href="http://nginx.org/">nginx.org</a>.<br/>
+Commercial support is available at
+<a href="http://nginx.com/">nginx.com</a>.</p>
+
+<p><em>Thank you for using nginx.</em></p>
+</body>
+</html>
+EOF
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/config.yaml b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..406861de0424ab9c8c75a80dda11040f4439815e
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/config.yaml
@@ -0,0 +1,9 @@
+options:
+  port:
+    description: Zookeeper client port
+    type: int
+    default: 80
+  image:
+    description: Docker image name
+    type: string
+    default: nginx
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/hooks/start b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/hooks/start
new file mode 100755
index 0000000000000000000000000000000000000000..2afc6cb6d058d843ffa9ec9a7a88d63b2fba9c19
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/hooks/start
@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+
+import sys
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    MaintenanceStatus,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class NginxK8sCharm(CharmBase):
+    state = StoredState()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+        self.state.set_default(spec=None)
+
+        # Observe Charm related events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.start, self.on_start)
+        self.framework.observe(self.on.upgrade_charm, self.on_upgrade_charm)
+
+    def _apply_spec(self):
+        # Only apply the spec if this unit is a leader.
+        if not self.framework.model.unit.is_leader():
+            return
+        new_spec = self.make_pod_spec()
+        if new_spec == self.state.spec:
+            return
+        self.framework.model.pod.set_spec(new_spec)
+        self.state.spec = new_spec
+
+    def make_pod_spec(self):
+        config = self.framework.model.config
+
+        ports = [
+            {
+                "name": "port",
+                "containerPort": config["port"],
+                "protocol": "TCP",
+            }
+        ]
+
+        spec = {
+            "version": 2,
+            "containers": [
+                {
+                    "name": self.framework.model.app.name,
+                    "image": "{}".format(config["image"]),
+                    "ports": ports,
+                }
+            ],
+        }
+
+        return spec
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Applying new pod spec")
+        self._apply_spec()
+        unit.status = ActiveStatus("Ready")
+
+    def on_start(self, event):
+        """Called when the charm is being installed"""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Applying pod spec")
+        self._apply_spec()
+        unit.status = ActiveStatus("Ready")
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Upgrading charm")
+        self.on_start(event)
+
+if __name__ == "__main__":
+    main(NginxK8sCharm)
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/__init__.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3207f5650949581c4610d830e543430d4776db7
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+__version__ = '0.6.1'
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # NOQA
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/charm.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..3d98b6ec321f3478cbf3410136abeca91054f1e9
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/charm.py
@@ -0,0 +1,574 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+class HookEvent(EventBase):
+    """A base class for events that trigger because of a Juju hook firing."""
+
+
+class ActionEvent(EventBase):
+    """A base class for events that trigger when a user asks for an Action to be run.
+
+    To read the parameters for the action, see the instance variable `params`.
+    To respond with the result of the action, call `set_results`. To add progress
+    messages that are visible as the action is progressing use `log`.
+
+    :ivar params: The parameters passed to the action (read by action-get)
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the user is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by Charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Represents the `install` hook from Juju."""
+
+
+class StartEvent(HookEvent):
+    """Represents the `start` hook from Juju."""
+
+
+class StopEvent(HookEvent):
+    """Represents the `stop` hook from Juju."""
+
+
+class RemoveEvent(HookEvent):
+    """Represents the `remove` hook from Juju. """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Represents the `config-changed` hook from Juju."""
+
+
+class UpdateStatusEvent(HookEvent):
+    """Represents the `update-status` hook from Juju."""
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Represents the `upgrade-charm` hook from Juju.
+
+    This will be triggered when a user has run `juju upgrade-charm`. It is run after Juju
+    has unpacked the upgraded charm code, and so this event will be handled with new code.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Represents the `pre-series-upgrade` hook from Juju.
+
+    This happens when a user has run `juju upgrade-series MACHINE prepare` and
+    will fire for each unit that is running on the machine, telling them that
+    the user is preparing to upgrade the Machine's series (eg trusty->bionic).
+    The charm should take actions to prepare for the upgrade (a database charm
+    would want to write out a version-independent dump of the database, so that
+    when a new version of the database is available in a new series, it can be
+    used.)
+    Once all units on a machine have run `pre-series-upgrade`, the user will
+    initiate the steps to actually upgrade the machine (eg `do-release-upgrade`).
+    When the upgrade has been completed, the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Represents the `post-series-upgrade` hook from Juju.
+
+    This is run after the user has done a distribution upgrade (or rolled back
+    and kept the same series). It is called in response to
+    `juju upgrade-series MACHINE complete`. Charms are expected to do whatever
+    steps are necessary to reconfigure their applications for the new series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Represents the `leader-elected` hook from Juju.
+
+    Juju will trigger this when a new lead unit is chosen for a given application.
+    This represents the leader of the charm information (not necessarily the primary
+    of a running application). The main utility is that charm authors can know
+    that only one unit will be a leader at any given time, so they can do
+    configuration, etc, that would otherwise require coordination between units.
+    (eg, selecting a password for a new relation)
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Represents the `leader-settings-changed` hook from Juju.
+
+    Deprecated. This represents when a lead unit would call `leader-set` to inform
+    the other units of an application that they have new information to handle.
+    This has been deprecated in favor of using a Peer relation, and having the
+    leader set a value in the Application data bag for that peer relation.
+    (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Represents the `collect-metrics` hook from Juju.
+
+    Note that events firing during a CollectMetricsEvent are currently
+    sandboxed in how they can interact with Juju. To report metrics
+    use :meth:`.add_metrics`.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Charmers should not be creating RelationEvents directly. The events will be
+    generated by the framework from Juju related events. Users can observe them
+    from the various `CharmBase.on[relation_name].relation_*` events.
+
+    Attributes:
+        relation: The Relation involved in this event
+        app: The remote application that has triggered this event
+        unit: The remote unit that has triggered this event. This may be None
+              if the relation event was triggered as an Application level event
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by Charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by Charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Represents the `relation-created` hook from Juju.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Represents the `relation-joined` hook from Juju.
+
+    This is triggered whenever a new unit of a related application joins the relation.
+    (eg, a unit was added to an existing related app, or a new relation was established
+    with an application that already had units.)
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Represents the `relation-changed` hook from Juju.
+
+    This is triggered whenever there is a change to the data bucket for a related
+    application or unit. Look at `event.relation.data[event.unit/app]` to see the
+    new information.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Represents the `relation-departed` hook from Juju.
+
+    This is the inverse of the RelationJoinedEvent, representing when a unit
+    is leaving the relation (the unit is being removed, the app is being removed,
+    the relation is being removed). It is fired once for each unit that is
+    going away.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Represents the `relation-broken` hook from Juju.
+
+    If a relation is being removed (`juju remove-relation` or `juju remove-application`),
+    once all the units have been removed, RelationBrokenEvent will fire to signal
+    that the relationship has been fully terminated.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing Storage related events."""
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Represents the `storage-attached` hook from Juju.
+
+    Called when new storage is available for the charm to use.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Represents the `storage-detaching` hook from Juju.
+
+    Called when storage a charm has been using is going away.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """The events that are generated by Juju in response to the lifecycle of an application."""
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the Charm overall.
+
+    Usually this initialization is done by ops.main.main() rather than Charm authors
+    directly instantiating a Charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            Charm.
+        key: Arbitrary key to distinguish this instance of CharmBase from another.
+            Generally is None when initialized by the framework. For charms instantiated by
+            main.main(), this is currenly None.
+    """
+
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional[str]):
+        """Initialize the Charm with its framework and application name.
+
+        """
+        super().__init__(framework, key)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """CharmMeta of this charm.
+        """
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the Charm as it is running.
+        """
+        return self.framework.charm_dir
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from metadata.yaml and/or actions.yaml. Generally charms will
+    define this information, rather than reading it at runtime. This class is
+    mostly for the framework to understand what the charm has defined.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = yaml.safe_load(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = yaml.safe_load(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by Charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/framework.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..54945cb10e0ffa5f352381aefa2fa443048ba3ae
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/framework.py
@@ -0,0 +1,1132 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import marshal
+import os
+import pdb
+import pickle
+import re
+import sqlite3
+import sys
+import types
+import weakref
+from datetime import timedelta
+
+from ops import charm
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(ObjectEvents):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path, snapshot_data):
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, snapshot_data))
+
+    def load_snapshot(self, handle_path):
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return row[0]
+        return None
+
+    def drop_snapshot(self, handle_path):
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def save_notice(self, event_path, observer_path, method_name):
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path, observer_path, method_name):
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path):
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, data_path, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self._data_path = data_path
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        self._storage = SQLiteStorage(data_path)
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+        # breakpoint(); if Python < 3.7, this doesn't affect anything
+        sys.breakpointhook = self.breakpoint
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse once the env var, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(data)
+        self._storage.save_snapshot(value.handle.path, raw_data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        raw_data = self._storage.load_snapshot(handle.path)
+        if not raw_data:
+            raise NoSnapshotError(handle.path)
+        data = pickle.loads(raw_data)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        # Save the event for all known observers before the first notification
+        # takes place, so that either everyone interested sees it, or nobody does.
+        self.save_snapshot(event)
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+
+
+class StoredStateData(Object):
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/jujuversion.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..4517886218c143f8c0249ac7285dc594976f9b01
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/jujuversion.py
@@ -0,0 +1,85 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/lib/__init__.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..716cf8c85e15a5b425bf68bfaae2810a11c8d2ed
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/lib/__init__.py
@@ -0,0 +1,185 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import os
+import re
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+from typing import Tuple, Dict, List, Iterator, Optional
+
+
+_libraries = {}  # type: Dict[Tuple[str,str], List[_Lib]]
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s+=\s+([0-9]+|['"][a-zA-Z0-9_.-@]+['"])\s*$''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    _libraries.clear()
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path: List[str]) -> Iterator[ModuleSpec]:
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except OSError:
+            continue
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except OSError:
+                continue
+            finder = get_importer(opslib)
+            if finder is None or not hasattr(finder, 'find_spec'):
+                continue
+            for lib_dir in lib_dirs:
+                spec = finder.find_spec(lib_dir)
+                if spec is None:
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    continue
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+
+
+def _parse_lib(spec: ModuleSpec) -> Optional['_Lib']:
+    if spec.origin is None:
+        return None
+
+    _expected = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_expected):
+                    break
+                if n > _MAX_LIB_LINES:
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _expected:
+                    value = literal_eval(value)
+                    if not isinstance(value, _expected[key]):
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_expected):
+                    return None
+    except Exception:
+        return None
+
+    return _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None  # type: Optional[ModuleType]
+
+    def __repr__(self):
+        return "<_Lib {0.name} by {0.author}, API {0.api}, patch {0.patch}>".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/log.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3f76a375a98e23c718e47bcde5c33b49f4031c7
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/log.py
@@ -0,0 +1,47 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/main.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..c38727168ebc223e1f0ed0a4c1d9b53f24118156
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/main.py
@@ -0,0 +1,317 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import logging
+
+from ops.log import setup_root_logging
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _load_metadata(charm_dir):
+    metadata = yaml.safe_load((charm_dir / 'metadata.yaml').read_text())
+
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = yaml.safe_load(actions_meta.read_text())
+    else:
+        actions_metadata = {}
+    return metadata, actions_metadata
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows.
+        # For Windows it is always an absolute path (any symlinks are resolved)
+        # while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(sys.argv[0])
+
+        if 'JUJU_DISPATCH_PATH' in os.environ and (charm_dir / 'dispatch').exists():
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk"""
+
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = self._charm_dir / self._dispatch_path
+        if not dispatch_path.exists():
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == self._exec_path.resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning(
+                "Legacy %s exited with status %d.",
+                self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+
+def main(charm_class):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata, actions_metadata = _load_metadata(charm_dir)
+    meta = ops.charm.CharmMeta(metadata, actions_metadata)
+    unit_name = os.environ['JUJU_UNIT_NAME']
+    model_name = os.environ.get('JUJU_MODEL_NAME')
+    model = ops.model.Model(unit_name, meta, model_backend, model_name=model_name)
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    framework = ops.framework.Framework(charm_state_path, charm_dir, meta, model)
+    try:
+        charm = charm_class(framework, None)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if dispatcher.event_name != 'collect_metrics':
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/model.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..10ae5343d05495e4558e37023507e95891cff6da
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/model.py
@@ -0,0 +1,1213 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+import ops
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    Attributes:
+        unit: A :class:`Unit` that represents the unit that is running this code (eg yourself)
+        app: A :class:`Application` that represents the application this unit is a part of.
+        relations: Mapping of endpoint to list of :class:`Relation` answering the question
+            "what am I currently related to". See also :meth:`.get_relation`
+        config: A dict of the config for the current application.
+        resources: Access to resources for this charm. Use ``model.resources.fetch(resource_name)``
+            to get the path on disk where the resource can be found.
+        storages: Mapping of storage_name to :class:`Storage` for the storage points defined in
+            metadata.yaml
+        pod: Used to get access to ``model.pod.set_spec`` to set the container specification
+            for Kubernetes charms.
+    """
+
+    def __init__(
+            self, unit_name: str, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend', *,
+            model_name: str = None):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+        self._model_name = model_name
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworKInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info['bind-addresses']:
+            interface_name = interface_info['interface-name']
+            for address_info in interface_info['addresses']:
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info['ingress-addresses']:
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info['egress-subnets']:
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        return self.interfaces[0].address
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        return self.ingress_addresses[0]
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        self.address = ipaddress.ip_address(address_info['value'])
+        cidr = address_info['cidr']
+        if not cidr:
+            # The cidr field may be empty, see LP: #1864102.
+            # In this case, make it a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address_info['value'])
+        else:
+            self.subnet = ipaddress.ip_network(cidr)
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """"Represents a storage as defined in metadata.yaml
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self):
+        self.unit_name = os.environ['JUJU_UNIT_NAME']
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        try:
+            return self._run('relation-get', '-r', str(relation_id),
+                             '-', member_name, '--app={}'.format(is_app),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        try:
+            return self._run('relation-set', '-r', str(relation_id),
+                             '{}={}'.format(key, value), '--app={}'.format(is_app))
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            app: A boolean indicating whether the status should be set for a unit or an
+                application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/testing.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..53e729ea757086d4715a18692eef28a10e0f7551
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/lib/ops/testing.py
@@ -0,0 +1,520 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pathlib
+from textwrap import dedent
+import typing
+
+from ops import charm, framework, model
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None):
+        # TODO: jam 2020-03-05 We probably want to take config as a parameter as well, since
+        #       it would define the default values of config that the charm would see.
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._unit_name, self._meta, self._backend)
+        self._framework = framework.Framework(":memory:", self._charm_dir, self._meta, self._model)
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling begin(), there is no Charm instance, so changes to the Model won't emit
+        events. You must call begin before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework, self._framework.meta.name)
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return rel_id
+        relation = self._model.get_relation(relation_name, rel_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+        return rel_id
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event and a `relation_changed` event.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        return self._resources_map[resource_name]
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/metadata.yaml b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..21c168deb5d8a722072ffa0271a8a86eee70c0f0
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/metadata.yaml
@@ -0,0 +1,10 @@
+name: nginx-k8s
+summary: A nginx charm
+description: |
+  Describe your charm here
+series:
+  - kubernetes
+min-juju-version: 2.7.0
+deployment:
+    type: stateless
+    service: loadbalancer
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/src/charm.py b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..2afc6cb6d058d843ffa9ec9a7a88d63b2fba9c19
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/charms/nginx-k8s/src/charm.py
@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+
+import sys
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    MaintenanceStatus,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class NginxK8sCharm(CharmBase):
+    state = StoredState()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+        self.state.set_default(spec=None)
+
+        # Observe Charm related events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.start, self.on_start)
+        self.framework.observe(self.on.upgrade_charm, self.on_upgrade_charm)
+
+    def _apply_spec(self):
+        # Only apply the spec if this unit is a leader.
+        if not self.framework.model.unit.is_leader():
+            return
+        new_spec = self.make_pod_spec()
+        if new_spec == self.state.spec:
+            return
+        self.framework.model.pod.set_spec(new_spec)
+        self.state.spec = new_spec
+
+    def make_pod_spec(self):
+        config = self.framework.model.config
+
+        ports = [
+            {
+                "name": "port",
+                "containerPort": config["port"],
+                "protocol": "TCP",
+            }
+        ]
+
+        spec = {
+            "version": 2,
+            "containers": [
+                {
+                    "name": self.framework.model.app.name,
+                    "image": "{}".format(config["image"]),
+                    "ports": ports,
+                }
+            ],
+        }
+
+        return spec
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Applying new pod spec")
+        self._apply_spec()
+        unit.status = ActiveStatus("Ready")
+
+    def on_start(self, event):
+        """Called when the charm is being installed"""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Applying pod spec")
+        self._apply_spec()
+        unit.status = ActiveStatus("Ready")
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+        unit = self.model.unit
+        unit.status = MaintenanceStatus("Upgrading charm")
+        self.on_start(event)
+
+if __name__ == "__main__":
+    main(NginxK8sCharm)
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/juju-bundles/bundle.yaml b/SOL004/charm-packages/native_k8s_charm_vnf/juju-bundles/bundle.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8115e959ac4502789c9ecd9d014e3139a8b636a2
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/juju-bundles/bundle.yaml
@@ -0,0 +1,6 @@
+description: Squid Bundle
+bundle: kubernetes
+applications:
+  nginx:
+    charm: '../charms/nginx-k8s'
+    scale: 1
diff --git a/SOL004/charm-packages/native_k8s_charm_vnf/native_k8s_charm_vnfd.yaml b/SOL004/charm-packages/native_k8s_charm_vnf/native_k8s_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..35d47caece1a1e997851b5da1f1ed5e417850524
--- /dev/null
+++ b/SOL004/charm-packages/native_k8s_charm_vnf/native_k8s_charm_vnfd.yaml
@@ -0,0 +1,38 @@
+vnfd:
+  df:
+  - id: default-df
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+          - id: native-kdu
+            config-primitive:
+            - name: changecontent
+              parameter:
+              - data-type: STRING
+                default-value: nginx
+                name: application-name
+              - data-type: STRING
+                default-value: ''
+                name: customtitle
+            initial-config-primitive:
+            - name: changecontent
+              parameter:
+              - data-type: STRING
+                name: application-name
+                value: nginx
+              - data-type: STRING
+                name: customtitle
+                value: Initial Config Primitive
+              seq: 1
+  ext-cpd:
+  - id: mgmt-ext
+    k8s-cluster-net: mgmtnet
+  id: native_k8s_charm-vnf
+  k8s-cluster:
+    nets:
+    - id: mgmtnet
+  kdu:
+  - name: native-kdu
+    juju-bundle: bundle.yaml
+  mgmt-cp: mgmt-ext
+  product-name: native_k8s_charm-vnf
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/icons/osm.png b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/nopasswd_k8s_proxy_charm_nsd.yaml b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/nopasswd_k8s_proxy_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8b75bb26f06e33963b54f2ba00e3a56c93d80121
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_ns/nopasswd_k8s_proxy_charm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: nopasswd_k8s_proxy_charm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: nopasswd_k8s_proxy_charm-vnf
+    id: nopasswd_k8s_proxy_charm-ns
+    name: nopasswd_k8s_proxy_charm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: datanet
+    vnfd-id:
+    - nopasswd_k8s_proxy_charm-vnf
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/actions.yaml b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f9882c47bba960254e0381e5b5ab1c0688de6cf5
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,54 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/config.yaml b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..93e3cab01c0843418c57e4bc918eb933f2daf934
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/config.yaml
@@ -0,0 +1,41 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/install b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/start b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/charms b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/charms
new file mode 120000
index 0000000000000000000000000000000000000000..5abf77aa5a04fddc6d4eb9d0d6d17e36fd00272a
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/charms
@@ -0,0 +1 @@
+../mod/charms.osm/charms/
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/ops b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..c36dab1ed4a93aee97a31b0eba0438852c5e05bf
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops/
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/metadata.yaml b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..4b5b352850eb98a4e2028942957cebc622a2395e
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-k8s-proxy
+summary: A simple example proxy charm
+description: |
+  Simple proxy charm is an example charm used in OSM Hackfests
+series:
+  - kubernetes
+peers:
+  proxypeer:
+    interface: proxypeer
+deployment:
+  mode: operator
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/src/charm.py b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/charms/simple/src/charm.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/icons/osm.png b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/nopasswd_k8s_proxy_charm_vnfd.yaml b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/nopasswd_k8s_proxy_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..bf32376cd9ac6f66e1fbf1887757a0cd1295400a
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_k8s_proxy_charm_vnf/nopasswd_k8s_proxy_charm_vnfd.yaml
@@ -0,0 +1,96 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: nopasswd_k8s_proxy_charm-vnf
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+              cloud: k8s
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            seq: 1
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: nopasswd_k8s_proxy_charm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: nopasswd_k8s_proxy_charm-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_ns/icons/osm.png b/SOL004/charm-packages/nopasswd_proxy_charm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/nopasswd_proxy_charm_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_ns/nopasswd_proxy_charm_nsd.yaml b/SOL004/charm-packages/nopasswd_proxy_charm_ns/nopasswd_proxy_charm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..859525bedcdb4e23f0fd438840f8c5ab6dc8f262
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_ns/nopasswd_proxy_charm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: nopasswd_proxy_charm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: nopasswd_proxy_charm-vnf
+    id: nopasswd_proxy_charm-ns
+    name: nopasswd_proxy_charm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: datanet
+    vnfd-id:
+    - nopasswd_proxy_charm-vnf
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/actions.yaml b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f9882c47bba960254e0381e5b5ab1c0688de6cf5
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,54 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/config.yaml b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..93e3cab01c0843418c57e4bc918eb933f2daf934
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/config.yaml
@@ -0,0 +1,41 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/install b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/start b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/charms b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/charms
new file mode 120000
index 0000000000000000000000000000000000000000..5abf77aa5a04fddc6d4eb9d0d6d17e36fd00272a
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/charms
@@ -0,0 +1 @@
+../mod/charms.osm/charms/
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/ops b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..c36dab1ed4a93aee97a31b0eba0438852c5e05bf
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops/
\ No newline at end of file
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/metadata.yaml b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d6d0cd70360fb011c2b2a36442d967b104050810
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,27 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-ha-proxy
+summary: A simple example proxy charm
+description: |
+  Simple proxy charm is an example charm used in OSM Hackfests
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/src/charm.py b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/charms/simple/src/charm.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/icons/osm.png b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/nopasswd_proxy_charm_vnf/nopasswd_proxy_charm_vnfd.yaml b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/nopasswd_proxy_charm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0777117a3badad9fed67ad3ba15fcb0a4d8db28e
--- /dev/null
+++ b/SOL004/charm-packages/nopasswd_proxy_charm_vnf/nopasswd_proxy_charm_vnfd.yaml
@@ -0,0 +1,95 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: nopasswd_proxy_charm-vnf
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            seq: 1
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: nopasswd_proxy_charm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: nopasswd_proxy_charm-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/ns_relations_ns/icons/osm.png b/SOL004/charm-packages/ns_relations_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/ns_relations_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/ns_relations_ns/ns_relations_nsd.yaml b/SOL004/charm-packages/ns_relations_ns/ns_relations_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6a10331c5c314038f0f7c1ed04e496f45b72450a
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_ns/ns_relations_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: provides-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: ns_relations_provides-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: requires-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: ns_relations_requires-vnf
+    id: ns_relations-ns
+    name: ns_relations-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    vnfd-id:
+    - ns_relations_provides-vnf
+    - ns_relations_requires-vnf
+    ns-configuration:
+      relation:
+      - name: relation
+        entities:
+        - id: '1'
+          endpoint: interface
+        - id: '2'
+          endpoint: interface
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/actions.yaml b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/config.yaml b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/install b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/start b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/upgrade-charm b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/lib/ops b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/metadata.yaml b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..db97d146a1734356dc46ec8bd549b4d1154aa418
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native-provides
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
+provides:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/src/charm.py b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..b15f847604d7ea6af2d4d1467cce6c7d1e64bf7e
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/charms/simple_provides/src/charm.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        parameter = "Hello"
+        event.relation.data[self.model.unit]["parameter"] = parameter
+        self.model.unit.status = ActiveStatus("Parameter sent: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/ns_relations_provides_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/icons/osm.png b/SOL004/charm-packages/ns_relations_provides_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/ns_relations_provides_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/ns_relations_provides_vnf/ns_relations_provides_vnfd.yaml b/SOL004/charm-packages/ns_relations_provides_vnf/ns_relations_provides_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ceb8d2953d130cd2bcface10873b9566779f508c
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_provides_vnf/ns_relations_provides_vnfd.yaml
@@ -0,0 +1,78 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: simple_provides
+    vdu-profile:
+    - id: simple_provides
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-provides-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: ns_relations_provides-vnf
+          execution-environment-list:
+          - id: simple-provides-ee
+            juju:
+              charm: simple_provides
+              proxy: false
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-provides-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+  ext-cpd:
+  - id: provides-mgmt-ext
+    int-cpd:
+      cpd: simple_provides-eth0-int
+      vdu-id: simple_provides
+  id: ns_relations_provides-vnf
+  mgmt-cp: provides-mgmt-ext
+  product-name: ns_relations_provides-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: simple_provides
+    int-cpd:
+    - id: simple_provides-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_provides-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_provides
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_provides-compute
+    virtual-storage-desc:
+    - simple_provides-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: simple_provides-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: simple_provides-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/actions.yaml b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/config.yaml b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/install b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/start b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/upgrade-charm b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/lib/ops b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/metadata.yaml b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..071f8fa8d2b605f85a78f2322ba8c096c65e1326
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native-requires
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
+requires:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/src/charm.py b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/charms/simple_requires/src/charm.py
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/ns_relations_requires_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/icons/osm.png b/SOL004/charm-packages/ns_relations_requires_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/ns_relations_requires_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/ns_relations_requires_vnf/ns_relations_requires_vnfd.yaml b/SOL004/charm-packages/ns_relations_requires_vnf/ns_relations_requires_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b4c45c0411925f63587156717ce13170700953f1
--- /dev/null
+++ b/SOL004/charm-packages/ns_relations_requires_vnf/ns_relations_requires_vnfd.yaml
@@ -0,0 +1,78 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: simple_requires
+    vdu-profile:
+    - id: simple_requires
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: ns_relations_requires-vnf
+          execution-environment-list:
+          - id: simple-requires-ee
+            juju:
+              charm: simple_requires
+              proxy: false
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+  ext-cpd:
+  - id: requires-mgmt-ext
+    int-cpd:
+      cpd: simple_requires-eth0-int
+      vdu-id: simple_requires
+  id: ns_relations_requires-vnf
+  mgmt-cp: requires-mgmt-ext
+  product-name: ns_relations_requires-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: simple_requires
+    int-cpd:
+    - id: simple_requires-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_requires-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_requires
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_requires-compute
+    virtual-storage-desc:
+    - simple_requires-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: simple_requires-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: simple_requires-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/params.yaml b/SOL004/charm-packages/params.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3dc9c71198c1ab2b2d1639f9a17ed7871485d03a
--- /dev/null
+++ b/SOL004/charm-packages/params.yaml
@@ -0,0 +1,3 @@
+additionalParamsForVnf:
+  - member-vnf-index: "1"
+    config-units: 2
diff --git a/SOL004/charm-packages/proxy_native_relation_ns/icons/osm.png b/SOL004/charm-packages/proxy_native_relation_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/proxy_native_relation_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/proxy_native_relation_ns/proxy_native_relation_nsd.yaml b/SOL004/charm-packages/proxy_native_relation_ns/proxy_native_relation_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..4039eb76a10c88965107ccfcd42fc468f1c7adce
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_ns/proxy_native_relation_nsd.yaml
@@ -0,0 +1,23 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: provides-mgmt-ext
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: requires-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: proxy_native_relation-vnf
+    id: proxy_native_relation-ns
+    name: proxy_native_relation-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    vnfd-id:
+    - proxy_native_relation-vnf
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/actions.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f9882c47bba960254e0381e5b5ab1c0688de6cf5
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/actions.yaml
@@ -0,0 +1,54 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/config.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..93e3cab01c0843418c57e4bc918eb933f2daf934
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/config.yaml
@@ -0,0 +1,41 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/install b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/install
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/install
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/start b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/start
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/start
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/upgrade-charm b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/upgrade-charm
new file mode 100755
index 0000000000000000000000000000000000000000..e23b12b7bcfddfd49d4efbc1b0ac72d92579778a
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/hooks/upgrade-charm
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/charms b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/charms
new file mode 120000
index 0000000000000000000000000000000000000000..5abf77aa5a04fddc6d4eb9d0d6d17e36fd00272a
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/charms
@@ -0,0 +1 @@
+../mod/charms.osm/charms/
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/ops b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..c36dab1ed4a93aee97a31b0eba0438852c5e05bf
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops/
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/metadata.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..76b268bfca697808056fb7386913e592df4b508d
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/metadata.yaml
@@ -0,0 +1,30 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-ha-proxy
+summary: A simple example proxy charm
+description: |
+  Simple proxy charm is an example charm used in OSM Hackfests
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
+provides:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/src/charm.py b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..1092fc34023c21e26eeb7f5cb81876c9d5b21c44
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_provides_proxy/src/charm.py
@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+
+sys.path.append("lib")
+
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.main import main
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_interface_relation_changed(self, event):
+        parameter = "Hello"
+        event.relation.data[self.model.unit]["parameter"] = parameter
+        self.model.unit.status = ActiveStatus("Parameter sent: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MySSHProxyCharm)
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/actions.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/config.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/install b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/install
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/install
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/start b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/start
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/start
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/upgrade-charm b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/upgrade-charm
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/hooks/upgrade-charm
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/lib/ops b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..c36dab1ed4a93aee97a31b0eba0438852c5e05bf
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops/
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/metadata.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..071f8fa8d2b605f85a78f2322ba8c096c65e1326
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native-requires
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
+requires:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/src/charm.py b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/charms/simple_requires/src/charm.py
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/proxy_native_relation_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/icons/osm.png b/SOL004/charm-packages/proxy_native_relation_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/proxy_native_relation_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/proxy_native_relation_vnf/proxy_native_relation_vnfd.yaml b/SOL004/charm-packages/proxy_native_relation_vnf/proxy_native_relation_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ffb49af9dc2b5279e8ed5d7440c25afd67094400
--- /dev/null
+++ b/SOL004/charm-packages/proxy_native_relation_vnf/proxy_native_relation_vnfd.yaml
@@ -0,0 +1,149 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: simple_requires
+      - number-of-instances: 1
+        vdu-id: simple_provides
+    vdu-profile:
+    - id: simple_requires
+      min-number-of-instances: 1
+    - id: simple_provides
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-provides-proxy-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: proxy_native_relation-vnf
+          execution-environment-list:
+          - id: simple-provides-proxy-ee
+            juju:
+              charm: simple_provides_proxy
+              proxy: true
+            external-connection-point-ref: provides-mgmt-ext
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-provides-proxy-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            seq: 1
+          - name: touch
+            execution-environment-ref: simple-provides-proxy-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 2
+          relation:
+          - entities:
+            - endpoint: interface
+              id: proxy_native_relation-vnf
+            - endpoint: interface
+              id: simple_requires
+            name: relation
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: simple_requires
+          execution-environment-list:
+          - id: simple-requires-ee
+            juju:
+              charm: simple_requires
+              proxy: false
+            external-connection-point-ref: requires-mgmt-ext
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+  ext-cpd:
+  - id: requires-mgmt-ext
+    int-cpd:
+      cpd: simple_requires-eth0-int
+      vdu-id: simple_requires
+  - id: provides-mgmt-ext
+    int-cpd:
+      cpd: simple_provides-eth0-int
+      vdu-id: simple_provides
+  id: proxy_native_relation-vnf
+  mgmt-cp: provides-mgmt-ext
+  product-name: proxy_native_relation-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: simple_requires
+    int-cpd:
+    - id: simple_requires-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_requires-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_requires
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_requires-compute
+    virtual-storage-desc:
+    - simple_requires-storage
+  - cloud-init-file: cloud-config.txt
+    id: simple_provides
+    int-cpd:
+    - id: simple_provides-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_provides-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_provides
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_provides-compute
+    virtual-storage-desc:
+    - simple_provides-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: simple_requires-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  - id: simple_provides-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: simple_requires-storage
+    size-of-storage: 10
+  - id: simple_provides-storage
+    size-of-storage: 10
diff --git a/SOL004/charm-packages/vnf_relations_ns/icons/osm.png b/SOL004/charm-packages/vnf_relations_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/vnf_relations_ns/icons/osm.png differ
diff --git a/SOL004/charm-packages/vnf_relations_ns/vnf_relations_nsd.yaml b/SOL004/charm-packages/vnf_relations_ns/vnf_relations_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a4578c5be4ce175423d60c1fb430db96b35a1d0e
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_ns/vnf_relations_nsd.yaml
@@ -0,0 +1,23 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: provides-mgmt-ext
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: requires-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: vnf_relations-vnf
+    id: vnf_relations-ns
+    name: vnf_relations-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    vnfd-id:
+    - vnf_relations-vnf
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/actions.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/config.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/install b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/start b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/upgrade-charm b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/lib/ops b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/metadata.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..db97d146a1734356dc46ec8bd549b4d1154aa418
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native-provides
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
+provides:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/src/charm.py b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..b15f847604d7ea6af2d4d1467cce6c7d1e64bf7e
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_provides/src/charm.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        parameter = "Hello"
+        event.relation.data[self.model.unit]["parameter"] = parameter
+        self.model.unit.status = ActiveStatus("Parameter sent: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/actions.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..53a706b4eba7347764c4711b7077146e72241de4
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/actions.yaml
@@ -0,0 +1,25 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+touch:
+  description: "Touch a file on the VNF."
+  params:
+    filename:
+      description: "The name of the file to touch."
+      type: string
+      default: ""
+  required:
+    - filename
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/config.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2be62318c6ce27156e4af585494b36d0c2b802f8
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/config.yaml
@@ -0,0 +1,17 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+options: {}
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/install b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/start b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/upgrade-charm b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/hooks/upgrade-charm
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/lib/ops b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/metadata.yaml b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..071f8fa8d2b605f85a78f2322ba8c096c65e1326
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/metadata.yaml
@@ -0,0 +1,28 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+name: simple-native-requires
+summary: A simple native charm
+description: |
+  Simple native charm
+series:
+  - bionic
+  - xenial
+  - focal
+requires:
+  interface:
+    interface: interface
\ No newline at end of file
diff --git a/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/src/charm.py b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..c243dc90a31ba2fb5c14143a5d658f7b8dfd2dcc
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/charms/simple_requires/src/charm.py
@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import sys
+import subprocess
+import logging
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.model import ActiveStatus
+
+logger = logging.getLogger(__name__)
+
+class MyNativeCharm(CharmBase):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+        # Listen to relation changed
+        self.framework.observe(
+            self.on.interface_relation_changed, self.on_interface_relation_changed
+        )
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        self.model.unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        filename = event.params["filename"]
+        try:
+            subprocess.run(["touch", filename], check=True)
+            event.set_results({"created": True, "filename": filename})
+        except subprocess.CalledProcessError as e:
+            event.fail("Action failed: {}".format(e))
+        self.model.unit.status = ActiveStatus()
+
+    def on_interface_relation_changed(self, event):
+        logger.debug("RELATION DATA: {}".format(dict(event.relation.data[event.unit])))
+        parameter = event.relation.data[event.unit].get("parameter")
+        if parameter:
+            self.model.unit.status = ActiveStatus("Parameter received: {}".format(parameter))
+
+
+if __name__ == "__main__":
+    main(MyNativeCharm)
+
diff --git a/SOL004/charm-packages/vnf_relations_vnf/cloud_init/cloud-config.txt b/SOL004/charm-packages/vnf_relations_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/charm-packages/vnf_relations_vnf/icons/osm.png b/SOL004/charm-packages/vnf_relations_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/charm-packages/vnf_relations_vnf/icons/osm.png differ
diff --git a/SOL004/charm-packages/vnf_relations_vnf/vnf_relations_vnfd.yaml b/SOL004/charm-packages/vnf_relations_vnf/vnf_relations_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f0a5b25e7dbd9bb31717f476256097be05d53b96
--- /dev/null
+++ b/SOL004/charm-packages/vnf_relations_vnf/vnf_relations_vnfd.yaml
@@ -0,0 +1,142 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: simple_requires
+      - number-of-instances: 1
+        vdu-id: simple_provides
+    vdu-profile:
+    - id: simple_requires
+      min-number-of-instances: 1
+    - id: simple_provides
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - id: vnf_relations-vnf
+          relation:
+          - entities:
+            - endpoint: interface
+              id: simple_provides
+            - endpoint: interface
+              id: simple_requires
+            name: relation
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: simple_requires
+          execution-environment-list:
+          - id: simple-requires-ee
+            juju:
+              charm: simple_requires
+              proxy: false
+            external-connection-point-ref: requires-mgmt-ext
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-requires-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-provides-ee         
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: simple_provides
+          execution-environment-list:
+          - id: simple-provides-ee
+            juju:
+              charm: simple_provides
+              proxy: false
+            external-connection-point-ref: provides-mgmt-ext
+          initial-config-primitive:
+          - name: touch
+            execution-environment-ref: simple-provides-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 1
+  ext-cpd:
+  - id: requires-mgmt-ext
+    int-cpd:
+      cpd: simple_requires-eth0-int
+      vdu-id: simple_requires
+  - id: provides-mgmt-ext
+    int-cpd:
+      cpd: simple_provides-eth0-int
+      vdu-id: simple_provides
+  id: vnf_relations-vnf
+  mgmt-cp: requires-mgmt-ext
+  product-name: vnf_relations-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: simple_requires
+    int-cpd:
+    - id: simple_requires-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_requires-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_requires
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_requires-compute
+    virtual-storage-desc:
+    - simple_requires-storage
+  - cloud-init-file: cloud-config.txt
+    id: simple_provides
+    int-cpd:
+    - id: simple_provides-eth0-int
+      virtual-network-interface-requirement:
+      - name: simple_provides-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: simple_provides
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: simple_provides-compute
+    virtual-storage-desc:
+    - simple_provides-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: simple_requires-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  - id: simple_provides-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: simple_requires-storage
+    size-of-storage: 10
+  - id: simple_provides-storage
+    size-of-storage: 10
diff --git a/SOL004/cirros_alarm_ns/cirros_alarm_nsd.yaml b/SOL004/cirros_alarm_ns/cirros_alarm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..40030c295259ca34aadbe2bc66068630e274b928
--- /dev/null
+++ b/SOL004/cirros_alarm_ns/cirros_alarm_nsd.yaml
@@ -0,0 +1,22 @@
+nsd:
+  nsd:
+  - description: Simple NS example with a cirros_alarm-vnf
+    designer: OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: eth0-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: cirros_alarm-vnf
+    id: cirros_alarm-ns
+    name: cirros_alarm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - cirros_alarm-vnf
diff --git a/SOL004/cirros_alarm_vnf/cirros_alarm_vnfd.yaml b/SOL004/cirros_alarm_vnf/cirros_alarm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8a301b5b39528af1c9c574c7aaa5a08090ccca33
--- /dev/null
+++ b/SOL004/cirros_alarm_vnf/cirros_alarm_vnfd.yaml
@@ -0,0 +1,70 @@
+vnfd:
+  description: Simple VNF example with a cirros and a VNF alarm
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: cirros_vnfd-VM
+    vdu-profile:
+    - id: cirros_vnfd-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: eth0-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: cirros_vnfd-VM
+  id: cirros_alarm-vnf
+  mgmt-cp: eth0-ext
+  product-name: cirros_alarm-vnf
+  provider: OSM
+  sw-image-desc:
+  - id: cirros-0.3.5-x86_64-disk.img
+    image: cirros-0.3.5-x86_64-disk.img
+    name: cirros-0.3.5-x86_64-disk.img
+  vdu:
+  - alarm:
+    - actions:
+        alarm:
+        - url: ${WEBHOOK_URL}
+        insufficient-data:
+        - url: ${WEBHOOK_URL}
+        ok:
+        - url: ${WEBHOOK_URL}
+      alarm-id: alarm-1
+      operation: LT
+      value: 20
+      vnf-monitoring-param-ref: cirros_vnf_cpu_util
+    description: cirros_vnfd-VM
+    id: cirros_vnfd-VM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    monitoring-parameter:
+    - id: cirros_vnf_cpu_util
+      name: cirros_vnf_cpu_util
+      performance-metric: cpu_utilization
+    - id: cirros_vnf_average_memory_utilization
+      name: cirros_vnf_average_memory_utilization
+      performance-metric: average_memory_utilization
+    name: cirros_vnfd-VM
+    sw-image-desc: cirros-0.3.5-x86_64-disk.img
+    virtual-compute-desc: cirros_vnfd-VM-compute
+    virtual-storage-desc:
+    - cirros_vnfd-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: cirros_vnfd-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1
+  virtual-storage-desc:
+  - id: cirros_vnfd-VM-storage
+    size-of-storage: 2
diff --git a/SOL004/epa_1vm_passthrough_ns/epa_1vm_passthrough_nsd.yaml b/SOL004/epa_1vm_passthrough_ns/epa_1vm_passthrough_nsd.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..35bcd0c31836c469f88e1f430bba429aa1472466
--- /dev/null
+++ b/SOL004/epa_1vm_passthrough_ns/epa_1vm_passthrough_nsd.yaml
@@ -0,0 +1,38 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs epa_1vm_passthrough-vnf connected by datanet and mgmtnet
+      VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_1vm_passthrough-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_1vm_passthrough-vnf
+    id: epa_1vm_passthrough-ns
+    name: epa_1vm_passthrough-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - epa_1vm_passthrough-vnf
diff --git a/SOL004/epa_1vm_passthrough_ns/icons/osm.png b/SOL004/epa_1vm_passthrough_ns/icons/osm.png
new file mode 100755
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_1vm_passthrough_ns/icons/osm.png differ
diff --git a/SOL004/epa_1vm_passthrough_vnf/cloud_init/cloud-config.txt b/SOL004/epa_1vm_passthrough_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..25b63cc647effa3d8c9ee922beaac1782339ba4f
--- /dev/null
+++ b/SOL004/epa_1vm_passthrough_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/epa_1vm_passthrough_vnf/epa_1vm_passthrough_vnfd.yaml b/SOL004/epa_1vm_passthrough_vnf/epa_1vm_passthrough_vnfd.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..d7512e3d155a5c5096cbded464950a9f0731bdc8
--- /dev/null
+++ b/SOL004/epa_1vm_passthrough_vnf/epa_1vm_passthrough_vnfd.yaml
@@ -0,0 +1,69 @@
+vnfd:
+  description: A VNF consisting of 1 VDU with 1 paravirt and 1 passthrough interface
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: dataVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: xe0-int
+      vdu-id: dataVM
+  id: epa_1vm_passthrough-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: epa_1vm_passthrough-vnf
+  sw-image-desc:
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: dataVM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: xe0-int
+      virtual-network-interface-requirement:
+      - name: xe0
+        position: 2
+        virtual-interface:
+          type: PCI-PASSTHROUGH
+    name: dataVM
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 2
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 4.0
+  virtual-storage-desc:
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/epa_1vm_passthrough_vnf/icons/osm.png b/SOL004/epa_1vm_passthrough_vnf/icons/osm.png
new file mode 100755
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_1vm_passthrough_vnf/icons/osm.png differ
diff --git a/SOL004/epa_1vm_sriov_ns/epa_1vm_sriov_nsd.yaml b/SOL004/epa_1vm_sriov_ns/epa_1vm_sriov_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a0c66e51b953615d0b4ec761103e2fd5614fe582
--- /dev/null
+++ b/SOL004/epa_1vm_sriov_ns/epa_1vm_sriov_nsd.yaml
@@ -0,0 +1,38 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs epa_1vm_sriov-vnf connected by datanet and mgmtnet
+      VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_1vm_sriov-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_1vm_sriov-vnf
+    id: epa_1vm_sriov-ns
+    name: epa_1vm_sriov-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - epa_1vm_sriov-vnf
diff --git a/SOL004/epa_1vm_sriov_ns/icons/osm.png b/SOL004/epa_1vm_sriov_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_1vm_sriov_ns/icons/osm.png differ
diff --git a/SOL004/epa_1vm_sriov_vnf/cloud_init/cloud-config.txt b/SOL004/epa_1vm_sriov_vnf/cloud_init/cloud-config.txt
new file mode 100644
index 0000000000000000000000000000000000000000..25b63cc647effa3d8c9ee922beaac1782339ba4f
--- /dev/null
+++ b/SOL004/epa_1vm_sriov_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/epa_1vm_sriov_vnf/epa_1vm_sriov_vnfd.yaml b/SOL004/epa_1vm_sriov_vnf/epa_1vm_sriov_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f374fae17b9073c6490bff80911862c712ac54b4
--- /dev/null
+++ b/SOL004/epa_1vm_sriov_vnf/epa_1vm_sriov_vnfd.yaml
@@ -0,0 +1,69 @@
+vnfd:
+  description: A VNF consisting of 1 VDU with 1 paravirt and 1 SRIOV interface
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: dataVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: xe0-int
+      vdu-id: dataVM
+  id: epa_1vm_sriov-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: epa_1vm_sriov-vnf
+  sw-image-desc:
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: dataVM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: xe0-int
+      virtual-network-interface-requirement:
+      - name: xe0
+        position: 2
+        virtual-interface:
+          type: SR-IOV
+    name: dataVM
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 2
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 4.0
+  virtual-storage-desc:
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/epa_1vm_sriov_vnf/icons/osm.png b/SOL004/epa_1vm_sriov_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_1vm_sriov_vnf/icons/osm.png differ
diff --git a/SOL004/epa_2vm_sriov_ns/epa_2vm_sriov_nsd.yaml b/SOL004/epa_2vm_sriov_ns/epa_2vm_sriov_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..57ae239725b33b9ab46ce11bed72c2f69a119d93
--- /dev/null
+++ b/SOL004/epa_2vm_sriov_ns/epa_2vm_sriov_nsd.yaml
@@ -0,0 +1,38 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs epa_2vm_sriov-vnf connected by datanet and mgmtnet
+      VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_2vm_sriov-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: epa_2vm_sriov-vnf
+    id: epa_2vm_sriov-ns
+    name: epa_2vm_sriov-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - epa_2vm_sriov-vnf
diff --git a/SOL004/epa_2vm_sriov_ns/icons/osm.png b/SOL004/epa_2vm_sriov_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_2vm_sriov_ns/icons/osm.png differ
diff --git a/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-data.txt b/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-data.txt
new file mode 100644
index 0000000000000000000000000000000000000000..cf1e7a5ebe6047de6c5ee5dbbdc9d5d2e46f36ed
--- /dev/null
+++ b/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-data.txt
@@ -0,0 +1,6 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+ssh_authorized_keys:
+  - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC49EBX7pW4ogqGMqT4y/SBDGXibz+XSgH8q5IEgt4BHlsHM2tWTtWFs/ULQ9Rq5BF781h96cludcLL9LnFAH8LVJCfiqfVnXEvwVNsVZqUVcTRyOnUMWGiJMptOu6JQkwVkPAnk0bMRjerWUhySCduyAQOhVE7DBcE6VjCu3q8cqAURzAcbBk8AtCPSvKCMhE45+9h+0V9joPV+MpsgHdqsoASiHIXTGhybcH5cS25epPpYuyTatQTBzz5WGiwUz//FsoI4KHZ+bcXXq4b+HkecplPgUtu+tVvRre/JoYmr6YrqCk9Qqf7bpEC6i4rjU7BzMWTuys7rrY8nAB4ytAN
diff --git a/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-mgmt.txt b/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-mgmt.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ea35add978bab82daa29a5bac425d7debe1d4410
--- /dev/null
+++ b/SOL004/epa_2vm_sriov_vnf/cloud_init/cloud-config-mgmt.txt
@@ -0,0 +1,41 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+write_files:
+-   content: |
+        -----BEGIN RSA PRIVATE KEY-----
+        MIIEowIBAAKCAQEAuPRAV+6VuKIKhjKk+Mv0gQxl4m8/l0oB/KuSBILeAR5bBzNr
+        Vk7VhbP1C0PUauQRe/NYfenJbnXCy/S5xQB/C1SQn4qn1Z1xL8FTbFWalFXE0cjp
+        1DFhoiTKbTruiUJMFZDwJ5NGzEY3q1lIckgnbsgEDoVROwwXBOlYwrt6vHKgFEcw
+        HGwZPALQj0rygjIROOfvYftFfY6D1fjKbIB3arKAEohyF0xocm3B+XEtuXqT6WLs
+        k2rUEwc8+VhosFM//xbKCOCh2fm3F16uG/h5HnKZT4FLbvrVb0a3vyaGJq+mK6gp
+        PUKn+26RAuouK41OwczFk7srO662PJwAeMrQDQIDAQABAoIBAEm73jbv/7JWr1lm
+        sUwai0QzPB70eOaIc5hWkeTIg1bw0hthzWXgEdG2t3chOHrQp4PBtMKlxE8MFXeX
+        /cNi+kL7GJjx/wzzMl92dBqZWgHO26NCtK2KbkDk5+p59wSzcH+cg5FTboMbbzAZ
+        bP9acpYAmVVsosCmhjrICEHB2iFr5sopbHgq9MEq1vQhV8fZJf8NDjmAPjug1XFa
+        2vi3G+bKuCLKBabsFVMabcCKlTlSrjUcwijJDatbJkmiz3Sg7IcczQbz++BXdhCU
+        UkjpLA5tAvIyncQpX5pAU467rO2E+Wcrq9NHl43vN2XHM3g6wIRjSBkmgndBFLds
+        En5WloUCgYEA71/Am0RCjyoF1IUJ7DpkjWxinkhzn6P0vIIAIRvMMwcEKPHoclBv
+        2k0ZdFkGfI4PDZgWwbFsvMysF/lB6bmw8tFxDL2g3cGEdVFBPC0L1qsf5jOKKe1d
+        eqtarToIgcya4/9ALNeci4DiH6coZrZ3Pg4/6rkhhhm5yWjl1prgFqsCgYEAxczf
+        VANZVg9JsbXjRnygRxOx735Ug17+dxaDdfdzYviH1XEqWMFyGCmpnk5aT8aHJpIY
+        DroaAvgAOEkVje5Pv9PpU6GuAh2USL11l4Hp8z3I1YJNkmABUa0aPe5ZQEG5NruH
+        dUTwJhXuo1buKbhg8j81DrPF/HAQOTMjpASmFCcCgYAjZmm5jJK7UV+jWjlpcglE
+        0O6UsepHhZu/9QnH27CLK1J2K7BQl4yzIAvPpQrMiMW5IPDcnDyUf0BEG1ygEBIX
+        Fto9JB4SLXhFUUrwd0j06kHBbYXVRYE5jvXOAHMZnwSZCzqWZxyDlP/b5oCXEAz6
+        ZGkXcWF/z3YmTxkOb8EMGQKBgAlHHMqSBaS1vt0pDOoHenUbBWOYZ1pqIEFxuuTT
+        oIPp6GUok7XqDPH5Mk2Mm0vWogw7GgnGzOWKwGfjdbFclj0HMZCMqt7KiGQJDvT2
+        UQTpxvvMytqsyiMMnYh+H42WB5v7m9TyUNlYegMLVsx6K4HxWQnBgO3gS8KDFY7h
+        8PBNAoGBAN+92Vayc9CD42Kg8nRN0Gy15zE4x8R6x4bxys47qC7ST3xVJgQHlOk4
+        weBWzLb+eW2bvKogRm5xS4nmXzg/fFWaLzwDGRHawKPO8LpSOdXNeV54YncaFuCZ
+        LPMO7xo6dYNtdI3mIk+K3lSjxgeIE1fMmFVm4ZJWgY5qeKPnMzfc
+        -----END RSA PRIVATE KEY-----
+
+
+    owner: root:root
+    permissions: '0600'
+    path: /home/ubuntu/test.pem
+runcmd:
+-   [ sh, -c, "chown ubuntu:ubuntu /home/ubuntu/test.pem" ]
+
diff --git a/SOL004/epa_2vm_sriov_vnf/epa_2vm_sriov_vnfd.yaml b/SOL004/epa_2vm_sriov_vnf/epa_2vm_sriov_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cdd4140bb9a77bd10e7e819576542acb927de583
--- /dev/null
+++ b/SOL004/epa_2vm_sriov_vnf/epa_2vm_sriov_vnfd.yaml
@@ -0,0 +1,115 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs with EPA capabilities connected to an internal
+    VL, 1 external CP based on paravirt, 1 external CP based on SR-IOV
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: xe0-int
+      vdu-id: dataVM
+  id: epa_2vm_sriov-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: epa_2vm_sriov-vnf
+  sw-image-desc:
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  vdu:
+  - cloud-init-file: cloud-config-mgmt.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - cloud-init-file: cloud-config-data.txt
+    id: dataVM
+    int-cpd:
+    - id: eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: xe0-int
+      virtual-network-interface-requirement:
+      - name: xe0
+        position: 2
+        virtual-interface:
+          type: SR-IOV
+    name: dataVM
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 1.0
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 8
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 4.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/epa_2vm_sriov_vnf/icons/osm.png b/SOL004/epa_2vm_sriov_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_2vm_sriov_vnf/icons/osm.png differ
diff --git a/SOL004/epa_quota_ns/epa_quota_nsd.yaml b/SOL004/epa_quota_ns/epa_quota_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c5d4a0cb8fb914ce6c081f95d7829302d6796c7e
--- /dev/null
+++ b/SOL004/epa_quota_ns/epa_quota_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: Simple NS with a single VNF and a single VL
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp0-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: epa_quota-vnf
+    id: epa_quota-ns
+    name: epa_quota-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - epa_quota-vnf
diff --git a/SOL004/epa_quota_ns/icons/osm.png b/SOL004/epa_quota_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_quota_ns/icons/osm.png differ
diff --git a/SOL004/epa_quota_vnf/epa_quota_vnfd.yaml b/SOL004/epa_quota_vnf/epa_quota_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..1b1bfb5306eec8926ea48576b8942ebf148e66a9
--- /dev/null
+++ b/SOL004/epa_quota_vnf/epa_quota_vnfd.yaml
@@ -0,0 +1,56 @@
+vnfd:
+  description: A basic VNF descriptor w/ one VDU and quota EPA
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: epa_quota-VM
+    vdu-profile:
+    - id: epa_quota-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-cp0-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: epa_quota-VM
+  id: epa_quota-vnf
+  mgmt-cp: vnf-cp0-ext
+  product-name: epa_quota-vnf
+  sw-image-desc:
+  - id: US1604
+    image: US1604
+    name: US1604
+  vdu:
+  - id: epa_quota-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        virtual-interface:
+          type: PARAVIRT
+    name: epa_quota-VM
+    sw-image-desc: US1604
+    virtual-compute-desc: epa_quota-VM-compute
+    virtual-storage-desc:
+    - epa_quota-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: epa_quota-VM-compute
+    virtual-cpu:
+      cpu-quota:
+        reserve: 512
+        shares: 3000
+      num-virtual-cpu: 2
+    virtual-memory:
+      mem-quota:
+        limit: 2048
+        reserve: 512
+        shares: 20480
+      size: 2.0
+  virtual-storage-desc:
+  - disk-io-quota:
+      shares: 1000
+    id: epa_quota-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/epa_quota_vnf/icons/osm.png b/SOL004/epa_quota_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/epa_quota_vnf/icons/osm.png differ
diff --git a/SOL004/generate-packages.sh b/SOL004/generate-packages.sh
new file mode 100755
index 0000000000000000000000000000000000000000..20f8f72d99f243c1dd75509340752291bf27f63c
--- /dev/null
+++ b/SOL004/generate-packages.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+set -eux
+for d in *vnf; do
+    osm package-build $d
+done
+for d in *ns; do
+    osm package-build $d
+done
+
diff --git a/SOL004/hackfest_basic_metrics_ns/hackfest_basic_nsd.yaml b/SOL004/hackfest_basic_metrics_ns/hackfest_basic_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a9f95c74c750cf58cec9598492a21ea88de0ef55
--- /dev/null
+++ b/SOL004/hackfest_basic_metrics_ns/hackfest_basic_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: Simple NS with a single VNF and a single VL and Metrics
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp0-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: hackfest_basic_metrics-vnf
+    id: hackfest_basic-ns-metrics
+    name: hackfest_basic-ns-metrics
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - hackfest_basic_metrics-vnf
diff --git a/SOL004/hackfest_basic_metrics_ns/icons/osm.png b/SOL004/hackfest_basic_metrics_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_metrics_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_basic_metrics_vnf/cloud_init/cloud-config b/SOL004/hackfest_basic_metrics_vnf/cloud_init/cloud-config
new file mode 100644
index 0000000000000000000000000000000000000000..25b63cc647effa3d8c9ee922beaac1782339ba4f
--- /dev/null
+++ b/SOL004/hackfest_basic_metrics_vnf/cloud_init/cloud-config
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/hackfest_basic_metrics_vnf/hackfest_basic_metrics_vnfd.yaml b/SOL004/hackfest_basic_metrics_vnf/hackfest_basic_metrics_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0da9e96134fcee393aad34cd32882b701d745141
--- /dev/null
+++ b/SOL004/hackfest_basic_metrics_vnf/hackfest_basic_metrics_vnfd.yaml
@@ -0,0 +1,84 @@
+vnfd:
+  description: A basic VNF descriptor w/ one VDU and VIM metrics
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: "1"
+        vdu-id: hackfest_basic_metrics-VM
+    scaling-aspect:
+    - aspect-delta-details:
+        deltas:
+        - id: vdu_autoscale-delta
+          vdu-delta:
+          - id: hackfest_basic_metrics-VM
+            number-of-instances: "1"
+      id: vdu_autoscale
+      max-scale-level: 1
+      name: vdu_autoscale
+      scaling-policy:
+      - cooldown-time: 120
+        name: cpu_util_above_threshold
+        scaling-criteria:
+        - name: cpu_util_above_threshold
+          scale-in-relational-operation: LT
+          scale-in-threshold: 10
+          scale-out-relational-operation: GT
+          scale-out-threshold: 60
+          vnf-monitoring-param-ref: vnf_cpu_util
+        scaling-type: automatic
+        threshold-time: 10
+    vdu-profile:
+    - id: hackfest_basic_metrics-VM
+      max-number-of-instances: "2"
+      min-number-of-instances: "1"
+  ext-cpd:
+  - id: vnf-cp0-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: hackfest_basic_metrics-VM
+  id: hackfest_basic_metrics-vnf
+  mgmt-cp: vnf-cp0-ext
+  product-name: hackfest_basic_metrics-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config
+    id: hackfest_basic_metrics-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        virtual-interface:
+          type: PARAVIRT
+    monitoring-parameter:
+    - id: vnf_cpu_util
+      name: vnf_cpu_util
+      performance-metric: cpu_utilization
+    - id: vnf_memory_util
+      name: vnf_memory_util
+      performance-metric: average_memory_utilization
+    - id: vnf_packets_sent
+      name: vnf_packets_sent
+      performance-metric: packets_sent
+    - id: vnf_packets_received
+      name: vnf_packets_received
+      performance-metric: packets_received
+    name: hackfest_basic_metrics-VM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: hackfest_basic_metrics-VM-compute
+    virtual-storage-desc:
+    - hackfest_basic_metrics-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: hackfest_basic_metrics-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: hackfest_basic_metrics-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/hackfest_basic_metrics_vnf/icons/osm.png b/SOL004/hackfest_basic_metrics_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_metrics_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_basic_ns/hackfest_basic_nsd.yaml b/SOL004/hackfest_basic_ns/hackfest_basic_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..be76b264172ba0f906d2b6d84e48c7542154e9e4
--- /dev/null
+++ b/SOL004/hackfest_basic_ns/hackfest_basic_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: Simple NS with a single VNF and a single VL
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp0-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: hackfest_basic-vnf
+    id: hackfest_basic-ns
+    name: hackfest_basic-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - hackfest_basic-vnf
diff --git a/SOL004/hackfest_basic_ns/icons/osm.png b/SOL004/hackfest_basic_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_basic_sriov_ns/hackfest_basic_sriov_nsd.yaml b/SOL004/hackfest_basic_sriov_ns/hackfest_basic_sriov_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7f7397b02d6d34db89132da39cdb8dd646e3ecf2
--- /dev/null
+++ b/SOL004/hackfest_basic_sriov_ns/hackfest_basic_sriov_nsd.yaml
@@ -0,0 +1,26 @@
+nsd:
+  nsd:
+  - description: Simple NS with a single VNF with SRIOV port
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp0-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp1-ext
+          virtual-link-profile-id: sriov_vld
+        vnfd-id: hackfest_basic_sriov-vnf
+    id: hackfest_basic_sriov-ns
+    name: hackfest_basic_sriov-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: sriov_vld
+    vnfd-id:
+    - hackfest_basic_sriov-vnf
diff --git a/SOL004/hackfest_basic_sriov_ns/icons/osm.png b/SOL004/hackfest_basic_sriov_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_sriov_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_basic_sriov_vnf/cloud_init/cloud.config b/SOL004/hackfest_basic_sriov_vnf/cloud_init/cloud.config
new file mode 100644
index 0000000000000000000000000000000000000000..25b63cc647effa3d8c9ee922beaac1782339ba4f
--- /dev/null
+++ b/SOL004/hackfest_basic_sriov_vnf/cloud_init/cloud.config
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/hackfest_basic_sriov_vnf/hackfest_basic_sriov_vnfd.yaml b/SOL004/hackfest_basic_sriov_vnf/hackfest_basic_sriov_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a6631397394010c0cd9031958d0ec4b21ddad188
--- /dev/null
+++ b/SOL004/hackfest_basic_sriov_vnf/hackfest_basic_sriov_vnfd.yaml
@@ -0,0 +1,57 @@
+vnfd:
+  description: A basic VNF descriptor w/ one VDU and SRIOV
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: hackfest_basic-VM
+    vdu-profile:
+    - id: hackfest_basic-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-cp0-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: hackfest_basic-VM
+  - id: vnf-cp1-ext
+    int-cpd:
+      cpd: vdu-eth1-int
+      vdu-id: hackfest_basic-VM
+  id: hackfest_basic_sriov-vnf
+  mgmt-cp: vnf-cp0-ext
+  product-name: hackfest_basic_sriov-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud.config
+    id: hackfest_basic-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth1-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth1
+        virtual-interface:
+          type: SR-IOV
+    name: hackfest_basic-VM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: hackfest_basic-VM-compute
+    virtual-storage-desc:
+    - hackfest_basic-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: hackfest_basic-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 2
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: hackfest_basic-VM-storage
+    size-of-storage: 30
diff --git a/SOL004/hackfest_basic_sriov_vnf/icons/osm.png b/SOL004/hackfest_basic_sriov_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_sriov_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_basic_vnf/hackfest_basic_vnfd.yaml b/SOL004/hackfest_basic_vnf/hackfest_basic_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..04832554aed141fbfb9898758218612c0bf84ed4
--- /dev/null
+++ b/SOL004/hackfest_basic_vnf/hackfest_basic_vnfd.yaml
@@ -0,0 +1,53 @@
+vnfd:
+  description: A basic VNF descriptor w/ one VDU
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: hackfest_basic-VM
+    vdu-profile:
+    - id: hackfest_basic-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-cp0-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: hackfest_basic-VM
+  id: hackfest_basic-vnf
+  mgmt-cp: vnf-cp0-ext
+  product-name: hackfest_basic-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    name: ubuntu16.04
+    image: ubuntu16.04
+  - id: ubuntu16.04-aws
+    name: ubuntu16.04-aws
+    image: ubuntu/images/hvm-ssd/ubuntu-artful-17.10-amd64-server-20180509
+    vim-type: aws
+  vdu:
+  - id: hackfest_basic-VM
+    name: hackfest_basic-VM
+    sw-image-desc: ubuntu16.04
+    alternative-sw-image-desc:
+    - ubuntu16.04-aws
+    virtual-compute-desc: hackfest_basic-VM-compute
+    virtual-storage-desc:
+    - hackfest_basic-VM-storage
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        virtual-interface:
+          type: PARAVIRT
+  version: '1.0'
+  virtual-compute-desc:
+  - id: hackfest_basic-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: "1"
+    virtual-memory:
+      size: "1.0"
+  virtual-storage-desc:
+  - id: hackfest_basic-VM-storage
+    size-of-storage: "10"
diff --git a/SOL004/hackfest_basic_vnf/icons/osm.png b/SOL004/hackfest_basic_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_basic_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_cloudinit_ns/hackfest_cloudinit_nsd.yaml b/SOL004/hackfest_cloudinit_ns/hackfest_cloudinit_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..bd8283cdb74d1eebae2ea2878909e393ff385567
--- /dev/null
+++ b/SOL004/hackfest_cloudinit_ns/hackfest_cloudinit_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_cloudinit-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_cloudinit-vnf
+    id: hackfest_cloudinit-ns
+    name: hackfest_cloudinit-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - hackfest_cloudinit-vnf
diff --git a/SOL004/hackfest_cloudinit_ns/icons/osm.png b/SOL004/hackfest_cloudinit_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_cloudinit_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_cloudinit_vnf/cloud_init/cloud-config.txt b/SOL004/hackfest_cloudinit_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/hackfest_cloudinit_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/hackfest_cloudinit_vnf/hackfest_cloudinit_vnfd.yaml b/SOL004/hackfest_cloudinit_vnf/hackfest_cloudinit_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cfa7d77631096fbd10fb238b3f45eb9c0be2bfea
--- /dev/null
+++ b/SOL004/hackfest_cloudinit_vnf/hackfest_cloudinit_vnfd.yaml
@@ -0,0 +1,94 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs connected to an internal VL, and one VDU
+    with cloud-init
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: dataVM
+  id: hackfest_cloudinit-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_cloudinit-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - id: dataVM
+    int-cpd:
+    - id: dataVM-eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: dataVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: dataVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: "1"
+    virtual-memory:
+      size: "1.0"
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: "1"
+    virtual-memory:
+      size: "1.0"
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: "10"
+  - id: dataVM-storage
+    size-of-storage: "10"
diff --git a/SOL004/hackfest_cloudinit_vnf/icons/osm.png b/SOL004/hackfest_cloudinit_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_cloudinit_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_epasriov_ns/hackfest_epasriov_nsd.yaml b/SOL004/hackfest_epasriov_ns/hackfest_epasriov_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..74a896aa3beac73bb84a4c35a320ce8f2def4a56
--- /dev/null
+++ b/SOL004/hackfest_epasriov_ns/hackfest_epasriov_nsd.yaml
@@ -0,0 +1,38 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs hackfest_epasriov-vnf connected by datanet and mgmtnet
+      VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_epasriov-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_epasriov-vnf
+    id: hackfest_epasriov-ns
+    name: hackfest_epasriov-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - hackfest_epasriov-vnf
diff --git a/SOL004/hackfest_epasriov_ns/icons/osm.png b/SOL004/hackfest_epasriov_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_epasriov_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_epasriov_vnf/cloud_init/cloud-config.txt b/SOL004/hackfest_epasriov_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..3e8d7b217417d1edb20e763b22e2b91255355310
--- /dev/null
+++ b/SOL004/hackfest_epasriov_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,18 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+write_files:
+-   encoding: b64
+    permissions: '0600'
+    path: /home/ubuntu/test4.pem
+    content: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFcEFJQkFBS0NBUUVBMTJGVDh5Q09wY0F2NFc5VHg3SUNYSDlkWm1DaU5hUkhoODNJMFBGL0QrMk1EbzlvCm9ZcEljdWlFYlp0L0I4eis3blRGbzBLSlQxR3lNelFacFhiZkg4dWhCWkdSS1grMGQwTTRnMjZzTnhSK3NDRzAKSnk2UW1WbXZUZ2hrY2o4ajNRV1AveXRHR3VXL3lBWHh1TGZpcUNGY0pDYmtodnFHRVJvUW1JWndNRVdmeUZNTQpZYld6VmJFdHVzRGZveHJHbENpRmdoQVcwdVhIQlhtL1pOM3FMeUJaQkN6UXlWVmxTYklkcmNocTFIZmgwTmZzClVCclFWSEo0cVNWZStaY0M5bWRxNmE1ekNDTGxYUGdOYlV6VmdLeDNIQzBzbjhYOXBBRGN1WXhncE1EUUI5UkUKNmQ2L0FPUVlLQldIZXpVaThTdDZHOTE4bkY3Mkw3ZjF6SzFBendJREFRQUJBb0lCQUc3bU5ZUzlvZFdrMU1LZQpRU1JVK3pSSGZIOG5pTDVZSFdER3kvMFNMQnUyYytSWFlVZTBYVU9WaUFLc0MwZW4vU2dwUms2ZkJ2YXBtVGtXClBaSmVWOXNXVFk0QmV4NUVIRmRBYkl2NFk0Sms4aXFjNEJkQXVjSE1WU0MzMzRpWURFNVUrK1Vta2cxdGVVZDAKRUJmTnowNUZCeDJ5VFA5WFpjck9nZmNYV2hMd0JObWQ5OStnVjZjUUI2TkYwWkZWbTZUTHVBN2dIM2pveWlwaQpLZmhvZDd1b25GUlZYU2c2dmlwWHMzK29INkJrcGdZeFE1RUM5VTIxcTdZUzQvSDVueUJKRFF5bWY4OEx2bTBsCklrWmFzS0M4UktrSEp1cFJPeVVVck9SVzBuNlpWNVAzalBDdHNhdi9uNlFJUVN0cUNuaVIxU2x1T05IbEkvU20KcXk3MVZwRUNnWUVBN0FQdUVzU1NSL0FRdHhNcDA1NytqcXg2VkUrVWpJeXJ0a0xCRnpIbDZHeFU0U1J6OWZJUwpMeHZJOGZUdjNBTXBKVElRY2Y3OGw4Q05CczBscHhPeE9odW9GUWN3cVpzTWIvSGc1d2RTNnIwdDZnZ0tNTWhPCmlnMHhJVHpHRVc1Y1ZNUTJ0M21FMXNIUDkyTlQ4QlR4MGVEOG5HOWI0aHhERnVqck5Pb1RNaWNDZ1lFQTZaNFgKc0ltNUxjRlJQZS9tTmhhc0x4WXVoK2Q1c2F0MjBPbTJZdE5YREEzNDlxUTllNG1DMzNtS0xSMS9FVkE1ZER1ZAp5dmp3T3Z3dmVmTEV1Qy8xVzhkOEF4VWFZVU1RSHRvUEI0cUcvL0QvY0lHaG0zWXR2VXVhSm9YRVAwa2Q0N21xClByNk51L1c1YjdqTy9yQ0lCT1pONlQraDJkeENsQ0xBcFo5dnJSa0NnWUVBMitWcGVya0ZaZHNwWjdtR0hmS2sKVUVBcEZjYXpyQ1FnbEljcnFyWEY5TUNDY09acTJIcjdNRU1kL1RsdUJibzRLcnl6ajlLNGU1ZGVqaml6WFRDKwp6bG9ZUjhkVU1xSVFlM2lNU0JTTno4SUZObWpaUGN4VFNOS3p0TGtQL2d1cUlSeFRzcXlZOVJMTTlqem9adWJNCnkvUm95RVFGQXUyOElHdFJRaExaWWI4Q2dZQkY2ZThUQVJSdkVnU2JNWmxHcEtCZzh4VjN6SmxKeDVPbVQ5c3EKVmk4ZHgyeXplMUYvRUJjZmhBTUxIMkd3cjc2Ui8ybG9uZmxlM2F2anBmaWpXbzdtS1p2K1hDbHA1Q1VGNXFKSwowblUyVVV4UXdpcTRHTFQxaXBPV1piL21aSjVTVVhVV2svWmN3dHY5Q0dUQ0tkaDdCdVZZSVpmeFdBNkF3S25BCnB5ZEh1UUtCZ1FDTUtCRk5IMFc1YlhwKzQweG1tNUNZdXZSMmhOckRsZ2pMMGc0WDRSQllFQmNnNnlDQ3ExZm8KZ3YwT0JxTmUxTDcyTFdoSTZvSTJxbEtQdmVOMWZkaDBqc0F2UHBRcGNlLzE2WTBmN3hzbDVOM3VwcCt5SEhOawp4cnVET0c3bnBTQ3lIS2ZjUWpEdGFIT1BLWWlRLzNDdVhwN09KT3ZqYk5aRmYwR0paQTlYUUE9PQotLS0tLUVORCBSU0EgUFJJVkFURSBLRVktLS0tLQo=
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
+runcmd:
+-   [ sh, -c, "chown ubuntu:ubuntu /home/ubuntu/test4.pem" ]
+
diff --git a/SOL004/hackfest_epasriov_vnf/hackfest_epasriov_vnfd.yaml b/SOL004/hackfest_epasriov_vnf/hackfest_epasriov_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..87bc4aa1b20ac0499b3427e98a5664eecd0f1941
--- /dev/null
+++ b/SOL004/hackfest_epasriov_vnf/hackfest_epasriov_vnfd.yaml
@@ -0,0 +1,117 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs with EPA capabilities connected to an internal
+    VL, mgmtVM VDU with cloud-init
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: xe0-int
+      vdu-id: dataVM
+  id: hackfest_epasriov-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_epasriov-vnf
+  sw-image-desc:
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  - id: hackfest-pktgen
+    image: hackfest-pktgen
+    name: hackfest-pktgen
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - id: dataVM
+    int-cpd:
+    - id: eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: xe0-int
+      virtual-network-interface-requirement:
+      - name: xe0
+        position: 2
+        virtual-interface:
+          type: SR-IOV
+    name: dataVM
+    sw-image-desc: hackfest-pktgen
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 1.0
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 8
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: 1
+        node-cnt: 1
+      size: 4.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/hackfest_epasriov_vnf/icons/osm.png b/SOL004/hackfest_epasriov_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_epasriov_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/README.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2bdcab20c1a6d39aaffe9a450ba3bdbc44044b42
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/README.md
@@ -0,0 +1,3 @@
+# Vyos-config
+
+This is a proxy charm used by Open Source Mano (OSM) to configure Vyos Router PNF, written in the [Python Operator Framwork](https://github.com/canonical/operator)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/actions.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..80497e105a10016e2dec0329f6157dbad382a298
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/actions.yaml
@@ -0,0 +1,46 @@
+# VyOS Action
+add-port-forward:
+  description: "Adds a port forwarding rule"
+  params:
+    ruleNumber:
+        description: "Rule number, must be unique and needed to remove the rule later"
+        type: "string"
+        default: "10"
+    sourcePort:
+        description: "Source port to listen on"
+        type: "string"
+    destinationPort:
+        description: "Target port number on remote host to forward"
+        type: "string"
+    destinationAddress:
+        description: "Target host or IP address to forward traffic"
+        type: "string"
+  required:
+    - sourcePort
+    - destinationPort
+    - destinationAddress
+
+remove-port-forward:
+  description: "Removes a port forwarding rule by number"
+  params:
+    ruleNumber:
+        description: "Rule number to remove"
+        type: "string"
+        default: "10"
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/config.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7f6d4408bec64af0b5c3ebf0e8cae30b33609f74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/config.yaml
@@ -0,0 +1,25 @@
+options:
+    ssh-hostname:
+        type: string
+        default: ""
+        description: "The hostname or IP address of the machine to"
+    ssh-username:
+        type: string
+        default: ""
+        description: "The username to login as."
+    ssh-password:
+        type: string
+        default: ""
+        description: "The password used to authenticate."
+    ssh-public-key:
+        type: string
+        default: ""
+        description: "The public key of this unit."
+    ssh-key-type:
+        type: string
+        default: "rsa"
+        description: "The type of encryption to use for the SSH key."
+    ssh-key-bits:
+        type: int
+        default: 4096
+        description: "The number of bits to use for the SSH key."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61ef90719b5d5d759de1a6b80a1ea748d8bb0911
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/__init__.py
@@ -0,0 +1,97 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Bootstrap charm-helpers, installing its dependencies if necessary using
+# only standard libraries.
+from __future__ import print_function
+from __future__ import absolute_import
+
+import functools
+import inspect
+import subprocess
+import sys
+
+try:
+    import six  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-six'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-six'])
+    import six  # NOQA:F401
+
+try:
+    import yaml  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-yaml'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-yaml'])
+    import yaml  # NOQA:F401
+
+
+# Holds a list of mapping of mangled function names that have been deprecated
+# using the @deprecate decorator below.  This is so that the warning is only
+# printed once for each usage of the function.
+__deprecated_functions = {}
+
+
+def deprecate(warning, date=None, log=None):
+    """Add a deprecation warning the first time the function is used.
+    The date, which is a string in semi-ISO8660 format indicate the year-month
+    that the function is officially going to be removed.
+
+    usage:
+
+    @deprecate('use core/fetch/add_source() instead', '2017-04')
+    def contributed_add_source_thing(...):
+        ...
+
+    And it then prints to the log ONCE that the function is deprecated.
+    The reason for passing the logging function (log) is so that hookenv.log
+    can be used for a charm if needed.
+
+    :param warning:  String to indicat where it has moved ot.
+    :param date: optional sting, in YYYY-MM format to indicate when the
+                 function will definitely (probably) be removed.
+    :param log: The log function to call to log.  If not, logs to stdout
+    """
+    def wrap(f):
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            try:
+                module = inspect.getmodule(f)
+                file = inspect.getsourcefile(f)
+                lines = inspect.getsourcelines(f)
+                f_name = "{}-{}-{}..{}-{}".format(
+                    module.__name__, file, lines[0], lines[-1], f.__name__)
+            except (IOError, TypeError):
+                # assume it was local, so just use the name of the function
+                f_name = f.__name__
+            if f_name not in __deprecated_functions:
+                __deprecated_functions[f_name] = True
+                s = "DEPRECATION WARNING: Function {} is being removed".format(
+                    f.__name__)
+                if date:
+                    s = "{} on/around {}".format(s, date)
+                if warning:
+                    s = "{} : {}".format(s, warning)
+                if log:
+                    log(s)
+                else:
+                    print(s)
+            return f(*args, **kwargs)
+        return wrapped_f
+    return wrap
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/README.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..f7901c09c79c268d353825776a74072a7ee4dee7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/README.rst
@@ -0,0 +1,57 @@
+==========
+Commandant
+==========
+
+-----------------------------------------------------
+Automatic command-line interfaces to Python functions
+-----------------------------------------------------
+
+One of the benefits of ``libvirt`` is the uniformity of the interface: the C  API (as well as the bindings in other languages) is a set of functions that accept parameters that are nearly identical to the command-line arguments.  If you run ``virsh``, you get an interactive command prompt that supports all of the same commands that your shell scripts use as ``virsh`` subcommands.
+
+Command execution and stdio manipulation is the greatest common factor across all development systems in the POSIX environment.  By exposing your functions as commands that manipulate streams of text, you can make life easier for all the Ruby and Erlang and Go programmers in your life.
+
+Goals
+=====
+
+* Single decorator to expose a function as a command.
+  * now two decorators - one "automatic" and one that allows authors to manipulate the arguments for fine-grained control.(MW)
+* Automatic analysis of function signature through ``inspect.getargspec()``
+* Command argument parser built automatically with ``argparse``
+* Interactive interpreter loop object made with ``Cmd``
+* Options to output structured return value data via ``pprint``, ``yaml`` or ``json`` dumps.
+
+Other Important Features that need writing
+------------------------------------------
+
+* Help and Usage documentation can be automatically generated, but it will be important to let users override this behaviour
+* The decorator should allow specifying further parameters to the parser's add_argument() calls, to specify types or to make arguments behave as boolean flags, etc.
+    - Filename arguments are important, as good practice is for functions to accept file objects as parameters.
+    - choices arguments help to limit bad input before the function is called
+* Some automatic behaviour could make for better defaults, once the user can override them.
+    - We could automatically detect arguments that default to False or True, and automatically support --no-foo for foo=True.
+    - We could automatically support hyphens as alternates for underscores
+    - Arguments defaulting to sequence types could support the ``append`` action.
+
+
+-----------------------------------------------------
+Implementing subcommands
+-----------------------------------------------------
+
+(WIP)
+
+So as to avoid dependencies on the cli module, subcommands should be defined separately from their implementations. The recommmendation would be to place definitions into separate modules near the implementations which they expose.
+
+Some examples::
+
+    from charmhelpers.cli import CommandLine
+    from charmhelpers.payload import execd
+    from charmhelpers.foo import bar
+
+    cli = CommandLine()
+
+    cli.subcommand(execd.execd_run)
+
+    @cli.subcommand_builder("bar", help="Bar baz qux")
+    def barcmd_builder(subparser):
+        subparser.add_argument('argument1', help="yackety")
+        return bar
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..389b490f4eec27f18118ab6a5f3f529dbf2e9ecc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/__init__.py
@@ -0,0 +1,189 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import argparse
+import sys
+
+from six.moves import zip
+
+import charmhelpers.core.unitdata
+
+
+class OutputFormatter(object):
+    def __init__(self, outfile=sys.stdout):
+        self.formats = (
+            "raw",
+            "json",
+            "py",
+            "yaml",
+            "csv",
+            "tab",
+        )
+        self.outfile = outfile
+
+    def add_arguments(self, argument_parser):
+        formatgroup = argument_parser.add_mutually_exclusive_group()
+        choices = self.supported_formats
+        formatgroup.add_argument("--format", metavar='FMT',
+                                 help="Select output format for returned data, "
+                                      "where FMT is one of: {}".format(choices),
+                                 choices=choices, default='raw')
+        for fmt in self.formats:
+            fmtfunc = getattr(self, fmt)
+            formatgroup.add_argument("-{}".format(fmt[0]),
+                                     "--{}".format(fmt), action='store_const',
+                                     const=fmt, dest='format',
+                                     help=fmtfunc.__doc__)
+
+    @property
+    def supported_formats(self):
+        return self.formats
+
+    def raw(self, output):
+        """Output data as raw string (default)"""
+        if isinstance(output, (list, tuple)):
+            output = '\n'.join(map(str, output))
+        self.outfile.write(str(output))
+
+    def py(self, output):
+        """Output data as a nicely-formatted python data structure"""
+        import pprint
+        pprint.pprint(output, stream=self.outfile)
+
+    def json(self, output):
+        """Output data in JSON format"""
+        import json
+        json.dump(output, self.outfile)
+
+    def yaml(self, output):
+        """Output data in YAML format"""
+        import yaml
+        yaml.safe_dump(output, self.outfile)
+
+    def csv(self, output):
+        """Output data as excel-compatible CSV"""
+        import csv
+        csvwriter = csv.writer(self.outfile)
+        csvwriter.writerows(output)
+
+    def tab(self, output):
+        """Output data in excel-compatible tab-delimited format"""
+        import csv
+        csvwriter = csv.writer(self.outfile, dialect=csv.excel_tab)
+        csvwriter.writerows(output)
+
+    def format_output(self, output, fmt='raw'):
+        fmtfunc = getattr(self, fmt)
+        fmtfunc(output)
+
+
+class CommandLine(object):
+    argument_parser = None
+    subparsers = None
+    formatter = None
+    exit_code = 0
+
+    def __init__(self):
+        if not self.argument_parser:
+            self.argument_parser = argparse.ArgumentParser(description='Perform common charm tasks')
+        if not self.formatter:
+            self.formatter = OutputFormatter()
+            self.formatter.add_arguments(self.argument_parser)
+        if not self.subparsers:
+            self.subparsers = self.argument_parser.add_subparsers(help='Commands')
+
+    def subcommand(self, command_name=None):
+        """
+        Decorate a function as a subcommand. Use its arguments as the
+        command-line arguments"""
+        def wrapper(decorated):
+            cmd_name = command_name or decorated.__name__
+            subparser = self.subparsers.add_parser(cmd_name,
+                                                   description=decorated.__doc__)
+            for args, kwargs in describe_arguments(decorated):
+                subparser.add_argument(*args, **kwargs)
+            subparser.set_defaults(func=decorated)
+            return decorated
+        return wrapper
+
+    def test_command(self, decorated):
+        """
+        Subcommand is a boolean test function, so bool return values should be
+        converted to a 0/1 exit code.
+        """
+        decorated._cli_test_command = True
+        return decorated
+
+    def no_output(self, decorated):
+        """
+        Subcommand is not expected to return a value, so don't print a spurious None.
+        """
+        decorated._cli_no_output = True
+        return decorated
+
+    def subcommand_builder(self, command_name, description=None):
+        """
+        Decorate a function that builds a subcommand. Builders should accept a
+        single argument (the subparser instance) and return the function to be
+        run as the command."""
+        def wrapper(decorated):
+            subparser = self.subparsers.add_parser(command_name)
+            func = decorated(subparser)
+            subparser.set_defaults(func=func)
+            subparser.description = description or func.__doc__
+        return wrapper
+
+    def run(self):
+        "Run cli, processing arguments and executing subcommands."
+        arguments = self.argument_parser.parse_args()
+        argspec = inspect.getargspec(arguments.func)
+        vargs = []
+        for arg in argspec.args:
+            vargs.append(getattr(arguments, arg))
+        if argspec.varargs:
+            vargs.extend(getattr(arguments, argspec.varargs))
+        output = arguments.func(*vargs)
+        if getattr(arguments.func, '_cli_test_command', False):
+            self.exit_code = 0 if output else 1
+            output = ''
+        if getattr(arguments.func, '_cli_no_output', False):
+            output = ''
+        self.formatter.format_output(output, arguments.format)
+        if charmhelpers.core.unitdata._KV:
+            charmhelpers.core.unitdata._KV.flush()
+
+
+cmdline = CommandLine()
+
+
+def describe_arguments(func):
+    """
+    Analyze a function's signature and return a data structure suitable for
+    passing in as arguments to an argparse parser's add_argument() method."""
+
+    argspec = inspect.getargspec(func)
+    # we should probably raise an exception somewhere if func includes **kwargs
+    if argspec.defaults:
+        positional_args = argspec.args[:-len(argspec.defaults)]
+        keyword_names = argspec.args[-len(argspec.defaults):]
+        for arg, default in zip(keyword_names, argspec.defaults):
+            yield ('--{}'.format(arg),), {'default': default}
+    else:
+        positional_args = argspec.args
+
+    for arg in positional_args:
+        yield (arg,), {}
+    if argspec.varargs:
+        yield (argspec.varargs,), {'nargs': '*'}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/benchmark.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/benchmark.py
new file mode 100644
index 0000000000000000000000000000000000000000..303af14b607d31e338aefff0df593609b7b45feb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/benchmark.py
@@ -0,0 +1,34 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.contrib.benchmark import Benchmark
+
+
+@cmdline.subcommand(command_name='benchmark-start')
+def start():
+    Benchmark.start()
+
+
+@cmdline.subcommand(command_name='benchmark-finish')
+def finish():
+    Benchmark.finish()
+
+
+@cmdline.subcommand_builder('benchmark-composite', description="Set the benchmark composite score")
+def service(subparser):
+    subparser.add_argument("value", help="The composite score.")
+    subparser.add_argument("units", help="The units the composite score represents, i.e., 'reads/sec'.")
+    subparser.add_argument("direction", help="'asc' if a lower score is better, 'desc' if a higher score is better.")
+    return Benchmark.set_composite_score
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/commands.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/commands.py
new file mode 100644
index 0000000000000000000000000000000000000000..b93105650be8226aa390fda46aa08afb23ebc7bc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/commands.py
@@ -0,0 +1,30 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module loads sub-modules into the python runtime so they can be
+discovered via the inspect module. In order to prevent flake8 from (rightfully)
+telling us these are unused modules, throw a ' # noqa' at the end of each import
+so that the warning is suppressed.
+"""
+
+from . import CommandLine  # noqa
+
+"""
+Import the sub-modules which have decorated subcommands to register with chlp.
+"""
+from . import host  # noqa
+from . import benchmark  # noqa
+from . import unitdata  # noqa
+from . import hookenv  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd72f448bf0092251a454ff6dd3145f09048ae72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/hookenv.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import hookenv
+
+
+cmdline.subcommand('relation-id')(hookenv.relation_id._wrapped)
+cmdline.subcommand('service-name')(hookenv.service_name)
+cmdline.subcommand('remote-service-name')(hookenv.remote_service_name._wrapped)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..40396849907976fd077cc9c53a0852c4380c6266
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/host.py
@@ -0,0 +1,29 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import host
+
+
+@cmdline.subcommand()
+def mounts():
+    "List mounts"
+    return host.mounts()
+
+
+@cmdline.subcommand_builder('service', description="Control system services")
+def service(subparser):
+    subparser.add_argument("action", help="The action to perform (start, stop, etc...)")
+    subparser.add_argument("service_name", help="Name of the service to control")
+    return host.service
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..acce846f84ef32ed0b5829cf08e67ad33f0eb5d1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/cli/unitdata.py
@@ -0,0 +1,46 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import unitdata
+
+
+@cmdline.subcommand_builder('unitdata', description="Store and retrieve data")
+def unitdata_cmd(subparser):
+    nested = subparser.add_subparsers()
+
+    get_cmd = nested.add_parser('get', help='Retrieve data')
+    get_cmd.add_argument('key', help='Key to retrieve the value of')
+    get_cmd.set_defaults(action='get', value=None)
+
+    getrange_cmd = nested.add_parser('getrange', help='Retrieve multiple data')
+    getrange_cmd.add_argument('key', metavar='prefix',
+                              help='Prefix of the keys to retrieve')
+    getrange_cmd.set_defaults(action='getrange', value=None)
+
+    set_cmd = nested.add_parser('set', help='Store data')
+    set_cmd.add_argument('key', help='Key to set')
+    set_cmd.add_argument('value', help='Value to store')
+    set_cmd.set_defaults(action='set')
+
+    def _unitdata_cmd(action, key, value):
+        if action == 'get':
+            return unitdata.kv().get(key)
+        elif action == 'getrange':
+            return unitdata.kv().getrange(key)
+        elif action == 'set':
+            unitdata.kv().set(key, value)
+            unitdata.kv().flush()
+            return ''
+    return _unitdata_cmd
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..01864740e89633f6c65f43c32ed89ef9d5e857c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/context.py
@@ -0,0 +1,205 @@
+# Copyright 2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+A Pythonic API to interact with the charm hook environment.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+'''
+
+import six
+
+from charmhelpers.core import hookenv
+
+from collections import OrderedDict
+if six.PY3:
+    from collections import UserDict  # pragma: nocover
+else:
+    from UserDict import IterableUserDict as UserDict  # pragma: nocover
+
+
+class Relations(OrderedDict):
+    '''Mapping relation name -> relation id -> Relation.
+
+    >>> rels = Relations()
+    >>> rels['sprog']['sprog:12']['client/6']['widget']
+    'remote widget'
+    >>> rels['sprog']['sprog:12'].local['widget'] = 'local widget'
+    >>> rels['sprog']['sprog:12'].local['widget']
+    'local widget'
+    >>> rels.peer.local['widget']
+    'local widget on the peer relation'
+    '''
+    def __init__(self):
+        super(Relations, self).__init__()
+        for relname in sorted(hookenv.relation_types()):
+            self[relname] = OrderedDict()
+            relids = hookenv.relation_ids(relname)
+            relids.sort(key=lambda x: int(x.split(':', 1)[-1]))
+            for relid in relids:
+                self[relname][relid] = Relation(relid)
+
+    @property
+    def peer(self):
+        peer_relid = hookenv.peer_relation_id()
+        for rels in self.values():
+            if peer_relid in rels:
+                return rels[peer_relid]
+
+
+class Relation(OrderedDict):
+    '''Mapping of unit -> remote RelationInfo for a relation.
+
+    This is an OrderedDict mapping, ordered numerically by
+    by unit number.
+
+    Also provides access to the local RelationInfo, and peer RelationInfo
+    instances by the 'local' and 'peers' attributes.
+
+    >>> r = Relation('sprog:12')
+    >>> r.keys()
+    ['client/9', 'client/10']     # Ordered numerically
+    >>> r['client/10']['widget']  # A remote RelationInfo setting
+    'remote widget'
+    >>> r.local['widget']         # The local RelationInfo setting
+    'local widget'
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also known as relation type).
+    service = None  # The remote service name, if known.
+    local = None    # The local end's RelationInfo.
+    peers = None    # Map of peer -> RelationInfo. None if no peer relation.
+
+    def __init__(self, relid):
+        remote_units = hookenv.related_units(relid)
+        remote_units.sort(key=lambda u: int(u.split('/', 1)[-1]))
+        super(Relation, self).__init__((unit, RelationInfo(relid, unit))
+                                       for unit in remote_units)
+
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.local = RelationInfo(relid, hookenv.local_unit())
+
+        for relinfo in self.values():
+            self.service = relinfo.service
+            break
+
+        # If we have peers, and they have joined both the provided peer
+        # relation and this relation, we can peek at their data too.
+        # This is useful for creating consensus without leadership.
+        peer_relid = hookenv.peer_relation_id()
+        if peer_relid and peer_relid != relid:
+            peers = hookenv.related_units(peer_relid)
+            if peers:
+                peers.sort(key=lambda u: int(u.split('/', 1)[-1]))
+                self.peers = OrderedDict((peer, RelationInfo(relid, peer))
+                                         for peer in peers)
+            else:
+                self.peers = OrderedDict()
+        else:
+            self.peers = None
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.service)
+
+
+class RelationInfo(UserDict):
+    '''The bag of data at an end of a relation.
+
+    Every unit participating in a relation has a single bag of
+    data associated with that relation. This is that bag.
+
+    The bag of data for the local unit may be updated. Remote data
+    is immutable and will remain static for the duration of the hook.
+
+    Changes made to the local units relation data only become visible
+    to other units after the hook completes successfully. If the hook
+    does not complete successfully, the changes are rolled back.
+
+    Unlike standard Python mappings, setting an item to None is the
+    same as deleting it.
+
+    >>> relinfo = RelationInfo('db:12')  # Default is the local unit.
+    >>> relinfo['user'] = 'fred'
+    >>> relinfo['user']
+    'fred'
+    >>> relinfo['user'] = None
+    >>> 'fred' in relinfo
+    False
+
+    This class wraps hookenv.relation_get and hookenv.relation_set.
+    All caching is left up to these two methods to avoid synchronization
+    issues. Data is only loaded on demand.
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also know as the relation type).
+    unit = None     # The unit id.
+    number = None   # The unit number (integer).
+    service = None  # The service name.
+
+    def __init__(self, relid, unit):
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.unit = unit
+        self.service, num = self.unit.split('/', 1)
+        self.number = int(num)
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.unit)
+
+    @property
+    def data(self):
+        return hookenv.relation_get(rid=self.relid, unit=self.unit)
+
+    def __setitem__(self, key, value):
+        if self.unit != hookenv.local_unit():
+            raise TypeError('Attempting to set {} on remote unit {}'
+                            ''.format(key, self.unit))
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure relation-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.relation_set(self.relid, {key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju relations.
+        self[key] = None
+
+
+class Leader(UserDict):
+    def __init__(self):
+        pass  # Don't call superclass initializer, as it will nuke self.data
+
+    @property
+    def data(self):
+        return hookenv.leader_get()
+
+    def __setitem__(self, key, value):
+        if not hookenv.is_leader():
+            raise TypeError('Not the leader. Cannot change leader settings.')
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure leader-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.leader_set({key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju leadership settings.
+        self[key] = None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..d21d01d8ffe242d686283b0ed977b88be6bfc74e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/deployment.py
@@ -0,0 +1,99 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import os
+import six
+
+
+class AmuletDeployment(object):
+    """Amulet deployment.
+
+       This class provides generic Amulet deployment and test runner
+       methods.
+       """
+
+    def __init__(self, series=None):
+        """Initialize the deployment environment."""
+        self.series = None
+
+        if series:
+            self.series = series
+            self.d = amulet.Deployment(series=self.series)
+        else:
+            self.d = amulet.Deployment()
+
+    def _add_services(self, this_service, other_services):
+        """Add services.
+
+           Add services to the deployment where this_service is the local charm
+           that we're testing and other_services are the other services that
+           are being used in the local amulet tests.
+           """
+        if this_service['name'] != os.path.basename(os.getcwd()):
+            s = this_service['name']
+            msg = "The charm's root directory name needs to be {}".format(s)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        if 'units' not in this_service:
+            this_service['units'] = 1
+
+        self.d.add(this_service['name'], units=this_service['units'],
+                   constraints=this_service.get('constraints'),
+                   storage=this_service.get('storage'))
+
+        for svc in other_services:
+            if 'location' in svc:
+                branch_location = svc['location']
+            elif self.series:
+                branch_location = 'cs:{}/{}'.format(self.series, svc['name']),
+            else:
+                branch_location = None
+
+            if 'units' not in svc:
+                svc['units'] = 1
+
+            self.d.add(svc['name'], charm=branch_location, units=svc['units'],
+                       constraints=svc.get('constraints'),
+                       storage=svc.get('storage'))
+
+    def _add_relations(self, relations):
+        """Add all of the relations for the services."""
+        for k, v in six.iteritems(relations):
+            self.d.relate(k, v)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _deploy(self):
+        """Deploy environment and wait for all hooks to finish executing."""
+        timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 900))
+        try:
+            self.d.setup(timeout=timeout)
+            self.d.sentry.wait(timeout=timeout)
+        except amulet.helpers.TimeoutError:
+            amulet.raise_status(
+                amulet.FAIL,
+                msg="Deployment timed out ({}s)".format(timeout)
+            )
+        except Exception:
+            raise
+
+    def run_tests(self):
+        """Run all of the methods that are prefixed with 'test_'."""
+        for test in dir(self):
+            if test.startswith('test_'):
+                getattr(self, test)()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..54283088e1ddd53bc85008bc7446620e87b42278
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/amulet/utils.py
@@ -0,0 +1,820 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import json
+import logging
+import os
+import re
+import socket
+import subprocess
+import sys
+import time
+import uuid
+
+import amulet
+import distro_info
+import six
+from six.moves import configparser
+if six.PY3:
+    from urllib import parse as urlparse
+else:
+    import urlparse
+
+
+class AmuletUtils(object):
+    """Amulet utilities.
+
+       This class provides common utility functions that are used by Amulet
+       tests.
+       """
+
+    def __init__(self, log_level=logging.ERROR):
+        self.log = self.get_logger(level=log_level)
+        self.ubuntu_releases = self.get_ubuntu_releases()
+
+    def get_logger(self, name="amulet-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def valid_ip(self, ip):
+        if re.match(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$", ip):
+            return True
+        else:
+            return False
+
+    def valid_url(self, url):
+        p = re.compile(
+            r'^(?:http|ftp)s?://'
+            r'(?:(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+(?:[A-Z]{2,6}\.?|[A-Z0-9-]{2,}\.?)|'  # noqa
+            r'localhost|'
+            r'\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})'
+            r'(?::\d+)?'
+            r'(?:/?|[/?]\S+)$',
+            re.IGNORECASE)
+        if p.match(url):
+            return True
+        else:
+            return False
+
+    def get_ubuntu_release_from_sentry(self, sentry_unit):
+        """Get Ubuntu release codename from sentry unit.
+
+        :param sentry_unit: amulet sentry/service unit pointer
+        :returns: list of strings - release codename, failure message
+        """
+        msg = None
+        cmd = 'lsb_release -cs'
+        release, code = sentry_unit.ssh(cmd)
+        if code == 0:
+            self.log.debug('{} lsb_release: {}'.format(
+                sentry_unit.info['unit_name'], release))
+        else:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, release, code))
+        if release not in self.ubuntu_releases:
+            msg = ("Release ({}) not found in Ubuntu releases "
+                   "({})".format(release, self.ubuntu_releases))
+        return release, msg
+
+    def validate_services(self, commands):
+        """Validate that lists of commands succeed on service units.  Can be
+           used to verify system services are running on the corresponding
+           service units.
+
+        :param commands: dict with sentry keys and arbitrary command list vals
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # /!\ DEPRECATION WARNING (beisner):
+        # New and existing tests should be rewritten to use
+        # validate_services_by_name() as it is aware of init systems.
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_services_by_name instead of validate_services '
+                      'due to init system differences.')
+
+        for k, v in six.iteritems(commands):
+            for cmd in v:
+                output, code = k.run(cmd)
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(k.info['unit_name'],
+                                           cmd, code))
+                if code != 0:
+                    return "command `{}` returned {}".format(cmd, str(code))
+        return None
+
+    def validate_services_by_name(self, sentry_services):
+        """Validate system service status by service name, automatically
+           detecting init system based on Ubuntu release codename.
+
+        :param sentry_services: dict with sentry keys and svc list values
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # Point at which systemd became a thing
+        systemd_switch = self.ubuntu_releases.index('vivid')
+
+        for sentry_unit, services_list in six.iteritems(sentry_services):
+            # Get lsb_release codename from unit
+            release, ret = self.get_ubuntu_release_from_sentry(sentry_unit)
+            if ret:
+                return ret
+
+            for service_name in services_list:
+                if (self.ubuntu_releases.index(release) >= systemd_switch or
+                        service_name in ['rabbitmq-server', 'apache2',
+                                         'memcached']):
+                    # init is systemd (or regular sysv)
+                    cmd = 'sudo service {} status'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0
+                elif self.ubuntu_releases.index(release) < systemd_switch:
+                    # init is upstart
+                    cmd = 'sudo status {}'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0 and "start/running" in output
+
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(sentry_unit.info['unit_name'],
+                                           cmd, code))
+                if not service_running:
+                    return u"command `{}` returned {} {}".format(
+                        cmd, output, str(code))
+        return None
+
+    def _get_config(self, unit, filename):
+        """Get a ConfigParser object for parsing a unit's config file."""
+        file_contents = unit.file_contents(filename)
+
+        # NOTE(beisner):  by default, ConfigParser does not handle options
+        # with no value, such as the flags used in the mysql my.cnf file.
+        # https://bugs.python.org/issue7005
+        config = configparser.ConfigParser(allow_no_value=True)
+        config.readfp(io.StringIO(file_contents))
+        return config
+
+    def validate_config_data(self, sentry_unit, config_file, section,
+                             expected):
+        """Validate config file data.
+
+           Verify that the specified section of the config file contains
+           the expected option key:value pairs.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('Validating config file data ({} in {} on {})'
+                       '...'.format(section, config_file,
+                                    sentry_unit.info['unit_name']))
+        config = self._get_config(sentry_unit, config_file)
+
+        if section != 'DEFAULT' and not config.has_section(section):
+            return "section [{}] does not exist".format(section)
+
+        for k in expected.keys():
+            if not config.has_option(section, k):
+                return "section [{}] is missing option {}".format(section, k)
+
+            actual = config.get(section, k)
+            v = expected[k]
+            if (isinstance(v, six.string_types) or
+                    isinstance(v, bool) or
+                    isinstance(v, six.integer_types)):
+                # handle explicit values
+                if actual != v:
+                    return "section [{}] {}:{} != expected {}:{}".format(
+                           section, k, actual, k, expected[k])
+            # handle function pointers, such as not_null or valid_ip
+            elif not v(actual):
+                return "section [{}] {}:{} != expected {}:{}".format(
+                       section, k, actual, k, expected[k])
+        return None
+
+    def _validate_dict_data(self, expected, actual):
+        """Validate dictionary data.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('actual: {}'.format(repr(actual)))
+        self.log.debug('expected: {}'.format(repr(expected)))
+
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                if (isinstance(v, six.string_types) or
+                        isinstance(v, bool) or
+                        isinstance(v, six.integer_types)):
+                    # handle explicit values
+                    if v != actual[k]:
+                        return "{}:{}".format(k, actual[k])
+                # handle function pointers, such as not_null or valid_ip
+                elif not v(actual[k]):
+                    return "{}:{}".format(k, actual[k])
+            else:
+                return "key '{}' does not exist".format(k)
+        return None
+
+    def validate_relation_data(self, sentry_unit, relation, expected):
+        """Validate actual relation data based on expected relation data."""
+        actual = sentry_unit.relation(relation[0], relation[1])
+        return self._validate_dict_data(expected, actual)
+
+    def _validate_list_data(self, expected, actual):
+        """Compare expected list vs actual list data."""
+        for e in expected:
+            if e not in actual:
+                return "expected item {} not found in actual list".format(e)
+        return None
+
+    def not_null(self, string):
+        if string is not None:
+            return True
+        else:
+            return False
+
+    def _get_file_mtime(self, sentry_unit, filename):
+        """Get last modification time of file."""
+        return sentry_unit.file_stat(filename)['mtime']
+
+    def _get_dir_mtime(self, sentry_unit, directory):
+        """Get last modification time of directory."""
+        return sentry_unit.directory_stat(directory)['mtime']
+
+    def _get_proc_start_time(self, sentry_unit, service, pgrep_full=None):
+        """Get start time of a process based on the last modification time
+           of the /proc/pid directory.
+
+        :sentry_unit:  The sentry unit to check for the service on
+        :service:  service name to look for in process table
+        :pgrep_full:  [Deprecated] Use full command line search mode with pgrep
+        :returns:  epoch time of service process start
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns:  None if successful; Failure message otherwise
+        """
+        pid_list = self.get_process_id_list(
+            sentry_unit, service, pgrep_full=pgrep_full)
+        pid = pid_list[0]
+        proc_dir = '/proc/{}'.format(pid)
+        self.log.debug('Pid for {} on {}: {}'.format(
+            service, sentry_unit.info['unit_name'], pid))
+
+        return self._get_dir_mtime(sentry_unit, proc_dir)
+
+    def service_restarted(self, sentry_unit, service, filename,
+                          pgrep_full=None, sleep_time=20):
+        """Check if service was restarted.
+
+           Compare a service's start time vs a file's last modification time
+           (such as a config file for that service) to determine if the service
+           has been restarted.
+           """
+        # /!\ DEPRECATION WARNING (beisner):
+        # This method is prone to races in that no before-time is known.
+        # Use validate_service_config_changed instead.
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_service_config_changed instead of '
+                      'service_restarted due to known races.')
+
+        time.sleep(sleep_time)
+        if (self._get_proc_start_time(sentry_unit, service, pgrep_full) >=
+                self._get_file_mtime(sentry_unit, filename)):
+            return True
+        else:
+            return False
+
+    def service_restarted_since(self, sentry_unit, mtime, service,
+                                pgrep_full=None, sleep_time=20,
+                                retry_count=30, retry_sleep_time=10):
+        """Check if service was been started after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if service found and its start time it newer than mtime,
+                False if service is older than mtime or if service was
+                not found.
+        """
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s service restarted since %s on '
+                       '%s' % (service, mtime, unit_name))
+        time.sleep(sleep_time)
+        proc_start_time = None
+        tries = 0
+        while tries <= retry_count and not proc_start_time:
+            try:
+                proc_start_time = self._get_proc_start_time(sentry_unit,
+                                                            service,
+                                                            pgrep_full)
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'OK'.format(tries, service, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, proc may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'failed\n{}'.format(tries, service,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not proc_start_time:
+            self.log.warn('No proc start time found, assuming service did '
+                          'not start')
+            return False
+        if proc_start_time >= mtime:
+            self.log.debug('Proc start time is newer than provided mtime'
+                           '(%s >= %s) on %s (OK)' % (proc_start_time,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('Proc start time (%s) is older than provided mtime '
+                          '(%s) on %s, service did not '
+                          'restart' % (proc_start_time, mtime, unit_name))
+            return False
+
+    def config_updated_since(self, sentry_unit, filename, mtime,
+                             sleep_time=20, retry_count=30,
+                             retry_sleep_time=10):
+        """Check if file was modified after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check the file mtime on
+          filename (string): The file to check mtime of
+          mtime (float): The epoch time to check against
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if file was modified more recently than mtime, False if
+                file was modified before mtime, or if file not found.
+        """
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s updated since %s on '
+                       '%s' % (filename, mtime, unit_name))
+        time.sleep(sleep_time)
+        file_mtime = None
+        tries = 0
+        while tries <= retry_count and not file_mtime:
+            try:
+                file_mtime = self._get_file_mtime(sentry_unit, filename)
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'OK'.format(tries, filename, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, file may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'failed\n{}'.format(tries, filename,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not file_mtime:
+            self.log.warn('Could not determine file mtime, assuming '
+                          'file does not exist')
+            return False
+
+        if file_mtime >= mtime:
+            self.log.debug('File mtime is newer than provided mtime '
+                           '(%s >= %s) on %s (OK)' % (file_mtime,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('File mtime is older than provided mtime'
+                          '(%s < on %s) on %s' % (file_mtime,
+                                                  mtime, unit_name))
+            return False
+
+    def validate_service_config_changed(self, sentry_unit, mtime, service,
+                                        filename, pgrep_full=None,
+                                        sleep_time=20, retry_count=30,
+                                        retry_sleep_time=10):
+        """Check service and file were updated after mtime
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          filename (string): The file to check mtime of
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep in seconds to pass to test helpers
+          retry_count (int): If service is not found, how many times to retry
+          retry_sleep_time (int): Time in seconds to wait between retries
+
+        Typical Usage:
+            u = OpenStackAmuletUtils(ERROR)
+            ...
+            mtime = u.get_sentry_time(self.cinder_sentry)
+            self.d.configure('cinder', {'verbose': 'True', 'debug': 'True'})
+            if not u.validate_service_config_changed(self.cinder_sentry,
+                                                     mtime,
+                                                     'cinder-api',
+                                                     '/etc/cinder/cinder.conf')
+                amulet.raise_status(amulet.FAIL, msg='update failed')
+        Returns:
+          bool: True if both service and file where updated/restarted after
+                mtime, False if service is older than mtime or if service was
+                not found or if filename was modified before mtime.
+        """
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        service_restart = self.service_restarted_since(
+            sentry_unit, mtime,
+            service,
+            pgrep_full=pgrep_full,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        config_update = self.config_updated_since(
+            sentry_unit,
+            filename,
+            mtime,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        return service_restart and config_update
+
+    def get_sentry_time(self, sentry_unit):
+        """Return current epoch time on a sentry"""
+        cmd = "date +'%s'"
+        return float(sentry_unit.run(cmd)[0])
+
+    def relation_error(self, name, data):
+        return 'unexpected relation data in {} - {}'.format(name, data)
+
+    def endpoint_error(self, name, data):
+        return 'unexpected endpoint data in {} - {}'.format(name, data)
+
+    def get_ubuntu_releases(self):
+        """Return a list of all Ubuntu releases in order of release."""
+        _d = distro_info.UbuntuDistroInfo()
+        _release_list = _d.all
+        return _release_list
+
+    def file_to_url(self, file_rel_path):
+        """Convert a relative file path to a file URL."""
+        _abs_path = os.path.abspath(file_rel_path)
+        return urlparse.urlparse(_abs_path, scheme='file').geturl()
+
+    def check_commands_on_units(self, commands, sentry_units):
+        """Check that all commands in a list exit zero on all
+        sentry units in a list.
+
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns: None if successful; Failure message otherwise
+        """
+        self.log.debug('Checking exit codes for {} commands on {} '
+                       'sentry units...'.format(len(commands),
+                                                len(sentry_units)))
+        for sentry_unit in sentry_units:
+            for cmd in commands:
+                output, code = sentry_unit.run(cmd)
+                if code == 0:
+                    self.log.debug('{} `{}` returned {} '
+                                   '(OK)'.format(sentry_unit.info['unit_name'],
+                                                 cmd, code))
+                else:
+                    return ('{} `{}` returned {} '
+                            '{}'.format(sentry_unit.info['unit_name'],
+                                        cmd, code, output))
+        return None
+
+    def get_process_id_list(self, sentry_unit, process_name,
+                            expect_success=True, pgrep_full=False):
+        """Get a list of process ID(s) from a single sentry juju unit
+        for a single process name.
+
+        :param sentry_unit: Amulet sentry instance (juju unit)
+        :param process_name: Process name
+        :param expect_success: If False, expect the PID to be missing,
+            raise if it is present.
+        :returns: List of process IDs
+        """
+        if pgrep_full:
+            cmd = 'pgrep -f "{}"'.format(process_name)
+        else:
+            cmd = 'pidof -x "{}"'.format(process_name)
+        if not expect_success:
+            cmd += " || exit 0 && exit 1"
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output).split()
+
+    def get_unit_process_ids(
+            self, unit_processes, expect_success=True, pgrep_full=False):
+        """Construct a dict containing unit sentries, process names, and
+        process IDs.
+
+        :param unit_processes: A dictionary of Amulet sentry instance
+            to list of process names.
+        :param expect_success: if False expect the processes to not be
+            running, raise if they are.
+        :returns: Dictionary of Amulet sentry instance to dictionary
+            of process names to PIDs.
+        """
+        pid_dict = {}
+        for sentry_unit, process_list in six.iteritems(unit_processes):
+            pid_dict[sentry_unit] = {}
+            for process in process_list:
+                pids = self.get_process_id_list(
+                    sentry_unit, process, expect_success=expect_success,
+                    pgrep_full=pgrep_full)
+                pid_dict[sentry_unit].update({process: pids})
+        return pid_dict
+
+    def validate_unit_process_ids(self, expected, actual):
+        """Validate process id quantities for services on units."""
+        self.log.debug('Checking units for running processes...')
+        self.log.debug('Expected PIDs: {}'.format(expected))
+        self.log.debug('Actual PIDs: {}'.format(actual))
+
+        if len(actual) != len(expected):
+            return ('Unit count mismatch.  expected, actual: {}, '
+                    '{} '.format(len(expected), len(actual)))
+
+        for (e_sentry, e_proc_names) in six.iteritems(expected):
+            e_sentry_name = e_sentry.info['unit_name']
+            if e_sentry in actual.keys():
+                a_proc_names = actual[e_sentry]
+            else:
+                return ('Expected sentry ({}) not found in actual dict data.'
+                        '{}'.format(e_sentry_name, e_sentry))
+
+            if len(e_proc_names.keys()) != len(a_proc_names.keys()):
+                return ('Process name count mismatch.  expected, actual: {}, '
+                        '{}'.format(len(expected), len(actual)))
+
+            for (e_proc_name, e_pids), (a_proc_name, a_pids) in \
+                    zip(e_proc_names.items(), a_proc_names.items()):
+                if e_proc_name != a_proc_name:
+                    return ('Process name mismatch.  expected, actual: {}, '
+                            '{}'.format(e_proc_name, a_proc_name))
+
+                a_pids_length = len(a_pids)
+                fail_msg = ('PID count mismatch. {} ({}) expected, actual: '
+                            '{}, {} ({})'.format(e_sentry_name, e_proc_name,
+                                                 e_pids, a_pids_length,
+                                                 a_pids))
+
+                # If expected is a list, ensure at least one PID quantity match
+                if isinstance(e_pids, list) and \
+                        a_pids_length not in e_pids:
+                    return fail_msg
+                # If expected is not bool and not list,
+                # ensure PID quantities match
+                elif not isinstance(e_pids, bool) and \
+                        not isinstance(e_pids, list) and \
+                        a_pids_length != e_pids:
+                    return fail_msg
+                # If expected is bool True, ensure 1 or more PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is True and a_pids_length < 1:
+                    return fail_msg
+                # If expected is bool False, ensure 0 PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is False and a_pids_length != 0:
+                    return fail_msg
+                else:
+                    self.log.debug('PID check OK: {} {} {}: '
+                                   '{}'.format(e_sentry_name, e_proc_name,
+                                               e_pids, a_pids))
+        return None
+
+    def validate_list_of_identical_dicts(self, list_of_dicts):
+        """Check that all dicts within a list are identical."""
+        hashes = []
+        for _dict in list_of_dicts:
+            hashes.append(hash(frozenset(_dict.items())))
+
+        self.log.debug('Hashes: {}'.format(hashes))
+        if len(set(hashes)) == 1:
+            self.log.debug('Dicts within list are identical')
+        else:
+            return 'Dicts within list are not identical'
+
+        return None
+
+    def validate_sectionless_conf(self, file_contents, expected):
+        """A crude conf parser.  Useful to inspect configuration files which
+        do not have section headers (as would be necessary in order to use
+        the configparser).  Such as openstack-dashboard or rabbitmq confs."""
+        for line in file_contents.split('\n'):
+            if '=' in line:
+                args = line.split('=')
+                if len(args) <= 1:
+                    continue
+                key = args[0].strip()
+                value = args[1].strip()
+                if key in expected.keys():
+                    if expected[key] != value:
+                        msg = ('Config mismatch.  Expected, actual:  {}, '
+                               '{}'.format(expected[key], value))
+                        amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def get_unit_hostnames(self, units):
+        """Return a dict of juju unit names to hostnames."""
+        host_names = {}
+        for unit in units:
+            host_names[unit.info['unit_name']] = \
+                str(unit.file_contents('/etc/hostname').strip())
+        self.log.debug('Unit host names: {}'.format(host_names))
+        return host_names
+
+    def run_cmd_unit(self, sentry_unit, cmd):
+        """Run a command on a unit, return the output and exit code."""
+        output, code = sentry_unit.run(cmd)
+        if code == 0:
+            self.log.debug('{} `{}` command returned {} '
+                           '(OK)'.format(sentry_unit.info['unit_name'],
+                                         cmd, code))
+        else:
+            msg = ('{} `{}` command returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output), code
+
+    def file_exists_on_unit(self, sentry_unit, file_name):
+        """Check if a file exists on a unit."""
+        try:
+            sentry_unit.file_stat(file_name)
+            return True
+        except IOError:
+            return False
+        except Exception as e:
+            msg = 'Error checking file {}: {}'.format(file_name, e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def file_contents_safe(self, sentry_unit, file_name,
+                           max_wait=60, fatal=False):
+        """Get file contents from a sentry unit.  Wrap amulet file_contents
+        with retry logic to address races where a file checks as existing,
+        but no longer exists by the time file_contents is called.
+        Return None if file not found. Optionally raise if fatal is True."""
+        unit_name = sentry_unit.info['unit_name']
+        file_contents = False
+        tries = 0
+        while not file_contents and tries < (max_wait / 4):
+            try:
+                file_contents = sentry_unit.file_contents(file_name)
+            except IOError:
+                self.log.debug('Attempt {} to open file {} from {} '
+                               'failed'.format(tries, file_name,
+                                               unit_name))
+                time.sleep(4)
+                tries += 1
+
+        if file_contents:
+            return file_contents
+        elif not fatal:
+            return None
+        elif fatal:
+            msg = 'Failed to get file contents from unit.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def port_knock_tcp(self, host="localhost", port=22, timeout=15):
+        """Open a TCP socket to check for a listening sevice on a host.
+
+        :param host: host name or IP address, default to localhost
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :returns: True if successful, False if connect failed
+        """
+
+        # Resolve host name if possible
+        try:
+            connect_host = socket.gethostbyname(host)
+            host_human = "{} ({})".format(connect_host, host)
+        except socket.error as e:
+            self.log.warn('Unable to resolve address: '
+                          '{} ({}) Trying anyway!'.format(host, e))
+            connect_host = host
+            host_human = connect_host
+
+        # Attempt socket connection
+        try:
+            knock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            knock.settimeout(timeout)
+            knock.connect((connect_host, port))
+            knock.close()
+            self.log.debug('Socket connect OK for host '
+                           '{} on port {}.'.format(host_human, port))
+            return True
+        except socket.error as e:
+            self.log.debug('Socket connect FAIL for'
+                           ' {} port {} ({})'.format(host_human, port, e))
+            return False
+
+    def port_knock_units(self, sentry_units, port=22,
+                         timeout=15, expect_success=True):
+        """Open a TCP socket to check for a listening sevice on each
+        listed juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :expect_success: True by default, set False to invert logic
+        :returns: None if successful, Failure message otherwise
+        """
+        for unit in sentry_units:
+            host = unit.info['public-address']
+            connected = self.port_knock_tcp(host, port, timeout)
+            if not connected and expect_success:
+                return 'Socket connect failed.'
+            elif connected and not expect_success:
+                return 'Socket connected unexpectedly.'
+
+    def get_uuid_epoch_stamp(self):
+        """Returns a stamp string based on uuid4 and epoch time.  Useful in
+        generating test messages which need to be unique-ish."""
+        return '[{}-{}]'.format(uuid.uuid4(), time.time())
+
+    # amulet juju action helpers:
+    def run_action(self, unit_sentry, action,
+                   _check_output=subprocess.check_output,
+                   params=None):
+        """Translate to amulet's built in run_action(). Deprecated.
+
+        Run the named action on a given unit sentry.
+
+        params a dict of parameters to use
+        _check_output parameter is no longer used
+
+        @return action_id.
+        """
+        self.log.warn('charmhelpers.contrib.amulet.utils.run_action has been '
+                      'deprecated for amulet.run_action')
+        return unit_sentry.run_action(action, action_args=params)
+
+    def wait_on_action(self, action_id, _check_output=subprocess.check_output):
+        """Wait for a given action, returning if it completed or not.
+
+        action_id a string action uuid
+        _check_output parameter is no longer used
+        """
+        data = amulet.actions.get_action_output(action_id, full_output=True)
+        return data.get(u"status") == "completed"
+
+    def status_get(self, unit):
+        """Return the current service status of this unit."""
+        raw_status, return_code = unit.run(
+            "status-get --format=json --include-data")
+        if return_code != 0:
+            return ("unknown", "")
+        status = json.loads(raw_status)
+        return (status["status"], status["message"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ansible/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ansible/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..824780aca93c406f7331ec3f0da8f22bee1272ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ansible/__init__.py
@@ -0,0 +1,303 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""
+The ansible package enables you to easily use the configuration management
+tool `Ansible`_ to setup and configure your charm. All of your charm
+configuration options and relation-data are available as regular Ansible
+variables which can be used in your playbooks and templates.
+
+.. _Ansible: https://www.ansible.com/
+
+Usage
+=====
+
+Here is an example directory structure for a charm to get you started::
+
+    charm-ansible-example/
+    |-- ansible
+    |   |-- playbook.yaml
+    |   `-- templates
+    |       `-- example.j2
+    |-- config.yaml
+    |-- copyright
+    |-- icon.svg
+    |-- layer.yaml
+    |-- metadata.yaml
+    |-- reactive
+    |   `-- example.py
+    |-- README.md
+
+Running a playbook called ``playbook.yaml`` when the ``install`` hook is run
+can be as simple as::
+
+    from charmhelpers.contrib import ansible
+    from charms.reactive import hook
+
+    @hook('install')
+    def install():
+        ansible.install_ansible_support()
+        ansible.apply_playbook('ansible/playbook.yaml')
+
+Here is an example playbook that uses the ``template`` module to template the
+file ``example.j2`` to the charm host and then uses the ``debug`` module to
+print out all the host and Juju variables that you can use in your playbooks.
+Note that you must target ``localhost`` as the playbook is run locally on the
+charm host::
+
+    ---
+    - hosts: localhost
+      tasks:
+        - name: Template a file
+          template:
+            src: templates/example.j2
+            dest: /tmp/example.j2
+
+        - name: Print all variables available to Ansible
+          debug:
+            var: vars
+
+Read more online about `playbooks`_ and standard Ansible `modules`_.
+
+.. _playbooks: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
+.. _modules: https://docs.ansible.com/ansible/latest/user_guide/modules.html
+
+A further feature of the Ansible hooks is to provide a light weight "action"
+scripting tool. This is a decorator that you apply to a function, and that
+function can now receive cli args, and can pass extra args to the playbook::
+
+    @hooks.action()
+    def some_action(amount, force="False"):
+        "Usage: some-action AMOUNT [force=True]"  # <-- shown on error
+        # process the arguments
+        # do some calls
+        # return extra-vars to be passed to ansible-playbook
+        return {
+            'amount': int(amount),
+            'type': force,
+        }
+
+You can now create a symlink to hooks.py that can be invoked like a hook, but
+with cli params::
+
+    # link actions/some-action to hooks/hooks.py
+
+    actions/some-action amount=10 force=true
+
+Install Ansible via pip
+=======================
+
+If you want to install a specific version of Ansible via pip instead of
+``install_ansible_support`` which uses APT, consider using the layer options
+of `layer-basic`_ to install Ansible in a virtualenv::
+
+    options:
+      basic:
+        python_packages: ['ansible==2.9.0']
+        include_system_packages: true
+        use_venv: true
+
+.. _layer-basic: https://charmsreactive.readthedocs.io/en/latest/layer-basic.html#layer-configuration
+
+"""
+import os
+import json
+import stat
+import subprocess
+import functools
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+import charmhelpers.fetch
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+ansible_hosts_path = '/etc/ansible/hosts'
+# Ansible will automatically include any vars in the following
+# file in its inventory when run locally.
+ansible_vars_path = '/etc/ansible/host_vars/localhost'
+
+
+def install_ansible_support(from_ppa=True, ppa_location='ppa:ansible/ansible'):
+    """Installs Ansible via APT.
+
+    By default this installs Ansible from the `PPA`_ linked from
+    the Ansible `website`_ or from a PPA set in ``ppa_location``.
+
+    .. _PPA: https://launchpad.net/~ansible/+archive/ubuntu/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If ``from_ppa`` is ``False``, then Ansible will be installed from
+    Ubuntu's Universe repositories.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install('ansible')
+    with open(ansible_hosts_path, 'w+') as hosts_file:
+        hosts_file.write('localhost ansible_connection=local ansible_remote_tmp=/root/.ansible/tmp')
+
+
+def apply_playbook(playbook, tags=None, extra_vars=None):
+    """Run a playbook.
+
+    This helper runs a playbook with juju state variables as context,
+    therefore variables set in application config can be used directly.
+    List of tags (--tags) and dictionary with extra_vars (--extra-vars)
+    can be passed as additional parameters.
+
+    Read more about playbook `_variables`_ online.
+
+    .. _variables: https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html
+
+    Example::
+
+        # Run ansible/playbook.yaml with tag install and pass extra
+        # variables var_a and var_b
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['install'],
+            extra_vars={'var_a': 'val_a', 'var_b': 'val_b'}
+        )
+
+        # Run ansible/playbook.yaml with tag config and extra variable nested,
+        # which is passed as json and can be used as dictionary in playbook
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['config'],
+            extra_vars={'nested': {'a': 'value1', 'b': 'value2'}}
+        )
+
+        # Custom config file can be passed within extra_vars
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            extra_vars="@some_file.json"
+        )
+
+    """
+    tags = tags or []
+    tags = ",".join(tags)
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        ansible_vars_path, namespace_separator='__',
+        allow_hyphens_in_keys=False, mode=(stat.S_IRUSR | stat.S_IWUSR))
+
+    # we want ansible's log output to be unbuffered
+    env = os.environ.copy()
+    env['PYTHONUNBUFFERED'] = "1"
+    call = [
+        'ansible-playbook',
+        '-c',
+        'local',
+        playbook,
+    ]
+    if tags:
+        call.extend(['--tags', '{}'.format(tags)])
+    if extra_vars:
+        call.extend(['--extra-vars', json.dumps(extra_vars)])
+    subprocess.check_call(call, env=env)
+
+
+class AnsibleHooks(charmhelpers.core.hookenv.Hooks):
+    """Run a playbook with the hook-name as the tag.
+
+    This helper builds on the standard hookenv.Hooks helper,
+    but additionally runs the playbook with the hook-name specified
+    using --tags (ie. running all the tasks tagged with the hook-name).
+
+    Example::
+
+        hooks = AnsibleHooks(playbook_path='ansible/my_machine_state.yaml')
+
+        # All the tasks within my_machine_state.yaml tagged with 'install'
+        # will be run automatically after do_custom_work()
+        @hooks.hook()
+        def install():
+            do_custom_work()
+
+        # For most of your hooks, you won't need to do anything other
+        # than run the tagged tasks for the hook:
+        @hooks.hook('config-changed', 'start', 'stop')
+        def just_use_playbook():
+            pass
+
+        # As a convenience, you can avoid the above noop function by specifying
+        # the hooks which are handled by ansible-only and they'll be registered
+        # for you:
+        # hooks = AnsibleHooks(
+        #     'ansible/my_machine_state.yaml',
+        #     default_hooks=['config-changed', 'start', 'stop'])
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, playbook_path, default_hooks=None):
+        """Register any hooks handled by ansible."""
+        super(AnsibleHooks, self).__init__()
+
+        self._actions = {}
+        self.playbook_path = playbook_path
+
+        default_hooks = default_hooks or []
+
+        def noop(*args, **kwargs):
+            pass
+
+        for hook in default_hooks:
+            self.register(hook, noop)
+
+    def register_action(self, name, function):
+        """Register a hook"""
+        self._actions[name] = function
+
+    def execute(self, args):
+        """Execute the hook followed by the playbook using the hook as tag."""
+        hook_name = os.path.basename(args[0])
+        extra_vars = None
+        if hook_name in self._actions:
+            extra_vars = self._actions[hook_name](args[1:])
+        else:
+            super(AnsibleHooks, self).execute(args)
+
+        charmhelpers.contrib.ansible.apply_playbook(
+            self.playbook_path, tags=[hook_name], extra_vars=extra_vars)
+
+    def action(self, *action_names):
+        """Decorator, registering them as actions"""
+        def action_wrapper(decorated):
+
+            @functools.wraps(decorated)
+            def wrapper(argv):
+                kwargs = dict(arg.split('=') for arg in argv)
+                try:
+                    return decorated(**kwargs)
+                except TypeError as e:
+                    if decorated.__doc__:
+                        e.args += (decorated.__doc__,)
+                    raise
+
+            self.register_action(decorated.__name__, wrapper)
+            if '_' in decorated.__name__:
+                self.register_action(
+                    decorated.__name__.replace('_', '-'), wrapper)
+
+            return wrapper
+
+        return action_wrapper
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/benchmark/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/benchmark/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c35f7fe785a29519a257f1ed5aa33fdfa19129c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/benchmark/__init__.py
@@ -0,0 +1,124 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import time
+import os
+from distutils.spawn import find_executable
+
+from charmhelpers.core.hookenv import (
+    in_relation_hook,
+    relation_ids,
+    relation_set,
+    relation_get,
+)
+
+
+def action_set(key, val):
+    if find_executable('action-set'):
+        action_cmd = ['action-set']
+
+        if isinstance(val, dict):
+            for k, v in iter(val.items()):
+                action_set('%s.%s' % (key, k), v)
+            return True
+
+        action_cmd.append('%s=%s' % (key, val))
+        subprocess.check_call(action_cmd)
+        return True
+    return False
+
+
+class Benchmark():
+    """
+    Helper class for the `benchmark` interface.
+
+    :param list actions: Define the actions that are also benchmarks
+
+    From inside the benchmark-relation-changed hook, you would
+    Benchmark(['memory', 'cpu', 'disk', 'smoke', 'custom'])
+
+    Examples:
+
+        siege = Benchmark(['siege'])
+        siege.start()
+        [... run siege ...]
+        # The higher the score, the better the benchmark
+        siege.set_composite_score(16.70, 'trans/sec', 'desc')
+        siege.finish()
+
+
+    """
+
+    BENCHMARK_CONF = '/etc/benchmark.conf'  # Replaced in testing
+
+    required_keys = [
+        'hostname',
+        'port',
+        'graphite_port',
+        'graphite_endpoint',
+        'api_port'
+    ]
+
+    def __init__(self, benchmarks=None):
+        if in_relation_hook():
+            if benchmarks is not None:
+                for rid in sorted(relation_ids('benchmark')):
+                    relation_set(relation_id=rid, relation_settings={
+                        'benchmarks': ",".join(benchmarks)
+                    })
+
+            # Check the relation data
+            config = {}
+            for key in self.required_keys:
+                val = relation_get(key)
+                if val is not None:
+                    config[key] = val
+                else:
+                    # We don't have all of the required keys
+                    config = {}
+                    break
+
+            if len(config):
+                with open(self.BENCHMARK_CONF, 'w') as f:
+                    for key, val in iter(config.items()):
+                        f.write("%s=%s\n" % (key, val))
+
+    @staticmethod
+    def start():
+        action_set('meta.start', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+        """
+        If the collectd charm is also installed, tell it to send a snapshot
+        of the current profile data.
+        """
+        COLLECT_PROFILE_DATA = '/usr/local/bin/collect-profile-data'
+        if os.path.exists(COLLECT_PROFILE_DATA):
+            subprocess.check_output([COLLECT_PROFILE_DATA])
+
+    @staticmethod
+    def finish():
+        action_set('meta.stop', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+    @staticmethod
+    def set_composite_score(value, units, direction='asc'):
+        """
+        Set the composite score for a benchmark run. This is a single number
+        representative of the benchmark results. This could be the most
+        important metric, or an amalgamation of metric scores.
+        """
+        return action_set(
+            "meta.composite",
+            {'value': value, 'units': units, 'direction': direction}
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..d41cb041f45cb19b87aee7d3f5fd4d47a3d3fb2d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/IMPORT
@@ -0,0 +1,4 @@
+Source lp:charm-tools/trunk
+
+charm-tools/helpers/python/charmhelpers/__init__.py -> charmhelpers/charmhelpers/contrib/charmhelpers/__init__.py
+charm-tools/helpers/python/charmhelpers/tests/test_charmhelpers.py -> charmhelpers/tests/contrib/charmhelpers/test_charmhelpers.py
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed63e8121e23a8e01ccb8ddcbf9aea34543d3666
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmhelpers/__init__.py
@@ -0,0 +1,203 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import warnings
+warnings.warn("contrib.charmhelpers is deprecated", DeprecationWarning)  # noqa
+
+import operator
+import tempfile
+import time
+import yaml
+import subprocess
+
+import six
+if six.PY3:
+    from urllib.request import urlopen
+    from urllib.error import (HTTPError, URLError)
+else:
+    from urllib2 import (urlopen, HTTPError, URLError)
+
+"""Helper functions for writing Juju charms in Python."""
+
+__metaclass__ = type
+__all__ = [
+    # 'get_config',             # core.hookenv.config()
+    # 'log',                    # core.hookenv.log()
+    # 'log_entry',              # core.hookenv.log()
+    # 'log_exit',               # core.hookenv.log()
+    # 'relation_get',           # core.hookenv.relation_get()
+    # 'relation_set',           # core.hookenv.relation_set()
+    # 'relation_ids',           # core.hookenv.relation_ids()
+    # 'relation_list',          # core.hookenv.relation_units()
+    # 'config_get',             # core.hookenv.config()
+    # 'unit_get',               # core.hookenv.unit_get()
+    # 'open_port',              # core.hookenv.open_port()
+    # 'close_port',             # core.hookenv.close_port()
+    # 'service_control',        # core.host.service()
+    'unit_info',              # client-side, NOT IMPLEMENTED
+    'wait_for_machine',       # client-side, NOT IMPLEMENTED
+    'wait_for_page_contents',  # client-side, NOT IMPLEMENTED
+    'wait_for_relation',      # client-side, NOT IMPLEMENTED
+    'wait_for_unit',          # client-side, NOT IMPLEMENTED
+]
+
+
+SLEEP_AMOUNT = 0.1
+
+
+# We create a juju_status Command here because it makes testing much,
+# much easier.
+def juju_status():
+    subprocess.check_call(['juju', 'status'])
+
+# re-implemented as charmhelpers.fetch.configure_sources()
+# def configure_source(update=False):
+#    source = config_get('source')
+#    if ((source.startswith('ppa:') or
+#         source.startswith('cloud:') or
+#         source.startswith('http:'))):
+#        run('add-apt-repository', source)
+#    if source.startswith("http:"):
+#        run('apt-key', 'import', config_get('key'))
+#    if update:
+#        run('apt-get', 'update')
+
+
+# DEPRECATED: client-side only
+def make_charm_config_file(charm_config):
+    charm_config_file = tempfile.NamedTemporaryFile(mode='w+')
+    charm_config_file.write(yaml.dump(charm_config))
+    charm_config_file.flush()
+    # The NamedTemporaryFile instance is returned instead of just the name
+    # because we want to take advantage of garbage collection-triggered
+    # deletion of the temp file when it goes out of scope in the caller.
+    return charm_config_file
+
+
+# DEPRECATED: client-side only
+def unit_info(service_name, item_name, data=None, unit=None):
+    if data is None:
+        data = yaml.safe_load(juju_status())
+    service = data['services'].get(service_name)
+    if service is None:
+        # XXX 2012-02-08 gmb:
+        #     This allows us to cope with the race condition that we
+        #     have between deploying a service and having it come up in
+        #     `juju status`. We could probably do with cleaning it up so
+        #     that it fails a bit more noisily after a while.
+        return ''
+    units = service['units']
+    if unit is not None:
+        item = units[unit][item_name]
+    else:
+        # It might seem odd to sort the units here, but we do it to
+        # ensure that when no unit is specified, the first unit for the
+        # service (or at least the one with the lowest number) is the
+        # one whose data gets returned.
+        sorted_unit_names = sorted(units.keys())
+        item = units[sorted_unit_names[0]][item_name]
+    return item
+
+
+# DEPRECATED: client-side only
+def get_machine_data():
+    return yaml.safe_load(juju_status())['machines']
+
+
+# DEPRECATED: client-side only
+def wait_for_machine(num_machines=1, timeout=300):
+    """Wait `timeout` seconds for `num_machines` machines to come up.
+
+    This wait_for... function can be called by other wait_for functions
+    whose timeouts might be too short in situations where only a bare
+    Juju setup has been bootstrapped.
+
+    :return: A tuple of (num_machines, time_taken). This is used for
+             testing.
+    """
+    # You may think this is a hack, and you'd be right. The easiest way
+    # to tell what environment we're working in (LXC vs EC2) is to check
+    # the dns-name of the first machine. If it's localhost we're in LXC
+    # and we can just return here.
+    if get_machine_data()[0]['dns-name'] == 'localhost':
+        return 1, 0
+    start_time = time.time()
+    while True:
+        # Drop the first machine, since it's the Zookeeper and that's
+        # not a machine that we need to wait for. This will only work
+        # for EC2 environments, which is why we return early above if
+        # we're in LXC.
+        machine_data = get_machine_data()
+        non_zookeeper_machines = [
+            machine_data[key] for key in list(machine_data.keys())[1:]]
+        if len(non_zookeeper_machines) >= num_machines:
+            all_machines_running = True
+            for machine in non_zookeeper_machines:
+                if machine.get('instance-state') != 'running':
+                    all_machines_running = False
+                    break
+            if all_machines_running:
+                break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    return num_machines, time.time() - start_time
+
+
+# DEPRECATED: client-side only
+def wait_for_unit(service_name, timeout=480):
+    """Wait `timeout` seconds for a given service name to come up."""
+    wait_for_machine(num_machines=1)
+    start_time = time.time()
+    while True:
+        state = unit_info(service_name, 'agent-state')
+        if 'error' in state or state == 'started':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    if state != 'started':
+        raise RuntimeError('unit did not start, agent-state: ' + state)
+
+
+# DEPRECATED: client-side only
+def wait_for_relation(service_name, relation_name, timeout=120):
+    """Wait `timeout` seconds for a given relation to come up."""
+    start_time = time.time()
+    while True:
+        relation = unit_info(service_name, 'relations').get(relation_name)
+        if relation is not None and relation['state'] == 'up':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for relation to be up')
+        time.sleep(SLEEP_AMOUNT)
+
+
+# DEPRECATED: client-side only
+def wait_for_page_contents(url, contents, timeout=120, validate=None):
+    if validate is None:
+        validate = operator.contains
+    start_time = time.time()
+    while True:
+        try:
+            stream = urlopen(url)
+        except (HTTPError, URLError):
+            pass
+        else:
+            page = stream.read()
+            if validate(page, contents):
+                return page
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for contents of ' + url)
+        time.sleep(SLEEP_AMOUNT)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..554fddda9f48d6d17abaff942834493b2cca2dbe
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/IMPORT
@@ -0,0 +1,14 @@
+Source: lp:charmsupport/trunk
+
+charmsupport/charmsupport/execd.py -> charm-helpers/charmhelpers/contrib/charmsupport/execd.py
+charmsupport/charmsupport/hookenv.py -> charm-helpers/charmhelpers/contrib/charmsupport/hookenv.py
+charmsupport/charmsupport/host.py -> charm-helpers/charmhelpers/contrib/charmsupport/host.py
+charmsupport/charmsupport/nrpe.py -> charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py
+charmsupport/charmsupport/volumes.py -> charm-helpers/charmhelpers/contrib/charmsupport/volumes.py
+
+charmsupport/tests/test_execd.py -> charm-helpers/tests/contrib/charmsupport/test_execd.py
+charmsupport/tests/test_hookenv.py -> charm-helpers/tests/contrib/charmsupport/test_hookenv.py
+charmsupport/tests/test_host.py -> charm-helpers/tests/contrib/charmsupport/test_host.py
+charmsupport/tests/test_nrpe.py -> charm-helpers/tests/contrib/charmsupport/test_nrpe.py
+
+charmsupport/bin/charmsupport -> charm-helpers/bin/contrib/charmsupport/charmsupport
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/nrpe.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/nrpe.py
new file mode 100644
index 0000000000000000000000000000000000000000..d775861b0868a174a3f0f4a8d4a42320272a4cb0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/nrpe.py
@@ -0,0 +1,500 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Compatibility with the nrpe-external-master charm"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import subprocess
+import pwd
+import grp
+import os
+import glob
+import shutil
+import re
+import shlex
+import yaml
+
+from charmhelpers.core.hookenv import (
+    config,
+    hook_name,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    relation_set,
+    relations_of_type,
+)
+
+from charmhelpers.core.host import service
+from charmhelpers.core import host
+
+# This module adds compatibility with the nrpe-external-master and plain nrpe
+# subordinate charms. To use it in your charm:
+#
+# 1. Update metadata.yaml
+#
+#   provides:
+#     (...)
+#     nrpe-external-master:
+#       interface: nrpe-external-master
+#       scope: container
+#
+#   and/or
+#
+#   provides:
+#     (...)
+#     local-monitors:
+#       interface: local-monitors
+#       scope: container
+
+#
+# 2. Add the following to config.yaml
+#
+#    nagios_context:
+#      default: "juju"
+#      type: string
+#      description: |
+#        Used by the nrpe subordinate charms.
+#        A string that will be prepended to instance name to set the host name
+#        in nagios. So for instance the hostname would be something like:
+#            juju-myservice-0
+#        If you're running multiple environments with the same services in them
+#        this allows you to differentiate between them.
+#    nagios_servicegroups:
+#      default: ""
+#      type: string
+#      description: |
+#        A comma-separated list of nagios servicegroups.
+#        If left empty, the nagios_context will be used as the servicegroup
+#
+# 3. Add custom checks (Nagios plugins) to files/nrpe-external-master
+#
+# 4. Update your hooks.py with something like this:
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE()
+#        nrpe_compat.add_check(
+#            shortname = "myservice",
+#            description = "Check MyService",
+#            check_cmd = "check_http -w 2 -c 10 http://localhost"
+#            )
+#        nrpe_compat.add_check(
+#            "myservice_other",
+#            "Check for widget failures",
+#            check_cmd = "/srv/myapp/scripts/widget_check"
+#            )
+#        nrpe_compat.write()
+#
+#    def config_changed():
+#        (...)
+#        update_nrpe_config()
+#
+#    def nrpe_external_master_relation_changed():
+#        update_nrpe_config()
+#
+#    def local_monitors_relation_changed():
+#        update_nrpe_config()
+#
+# 4.a If your charm is a subordinate charm set primary=False
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE(primary=False)
+#
+# 5. ln -s hooks.py nrpe-external-master-relation-changed
+#    ln -s hooks.py local-monitors-relation-changed
+
+
+class CheckException(Exception):
+    pass
+
+
+class Check(object):
+    shortname_re = '[A-Za-z0-9-_.@]+$'
+    service_template = ("""
+#---------------------------------------------------
+# This file is Juju managed
+#---------------------------------------------------
+define service {{
+    use                             active-service
+    host_name                       {nagios_hostname}
+    service_description             {nagios_hostname}[{shortname}] """
+                        """{description}
+    check_command                   check_nrpe!{command}
+    servicegroups                   {nagios_servicegroup}
+}}
+""")
+
+    def __init__(self, shortname, description, check_cmd):
+        super(Check, self).__init__()
+        # XXX: could be better to calculate this from the service name
+        if not re.match(self.shortname_re, shortname):
+            raise CheckException("shortname must match {}".format(
+                Check.shortname_re))
+        self.shortname = shortname
+        self.command = "check_{}".format(shortname)
+        # Note: a set of invalid characters is defined by the
+        # Nagios server config
+        # The default is: illegal_object_name_chars=`~!$%^&*"|'<>?,()=
+        self.description = description
+        self.check_cmd = self._locate_cmd(check_cmd)
+
+    def _get_check_filename(self):
+        return os.path.join(NRPE.nrpe_confdir, '{}.cfg'.format(self.command))
+
+    def _get_service_filename(self, hostname):
+        return os.path.join(NRPE.nagios_exportdir,
+                            'service__{}_{}.cfg'.format(hostname, self.command))
+
+    def _locate_cmd(self, check_cmd):
+        search_path = (
+            '/usr/lib/nagios/plugins',
+            '/usr/local/lib/nagios/plugins',
+        )
+        parts = shlex.split(check_cmd)
+        for path in search_path:
+            if os.path.exists(os.path.join(path, parts[0])):
+                command = os.path.join(path, parts[0])
+                if len(parts) > 1:
+                    command += " " + " ".join(parts[1:])
+                return command
+        log('Check command not found: {}'.format(parts[0]))
+        return ''
+
+    def _remove_service_files(self):
+        if not os.path.exists(NRPE.nagios_exportdir):
+            return
+        for f in os.listdir(NRPE.nagios_exportdir):
+            if f.endswith('_{}.cfg'.format(self.command)):
+                os.remove(os.path.join(NRPE.nagios_exportdir, f))
+
+    def remove(self, hostname):
+        nrpe_check_file = self._get_check_filename()
+        if os.path.exists(nrpe_check_file):
+            os.remove(nrpe_check_file)
+        self._remove_service_files()
+
+    def write(self, nagios_context, hostname, nagios_servicegroups):
+        nrpe_check_file = self._get_check_filename()
+        with open(nrpe_check_file, 'w') as nrpe_check_config:
+            nrpe_check_config.write("# check {}\n".format(self.shortname))
+            if nagios_servicegroups:
+                nrpe_check_config.write(
+                    "# The following header was added automatically by juju\n")
+                nrpe_check_config.write(
+                    "# Modifying it will affect nagios monitoring and alerting\n")
+                nrpe_check_config.write(
+                    "# servicegroups: {}\n".format(nagios_servicegroups))
+            nrpe_check_config.write("command[{}]={}\n".format(
+                self.command, self.check_cmd))
+
+        if not os.path.exists(NRPE.nagios_exportdir):
+            log('Not writing service config as {} is not accessible'.format(
+                NRPE.nagios_exportdir))
+        else:
+            self.write_service_config(nagios_context, hostname,
+                                      nagios_servicegroups)
+
+    def write_service_config(self, nagios_context, hostname,
+                             nagios_servicegroups):
+        self._remove_service_files()
+
+        templ_vars = {
+            'nagios_hostname': hostname,
+            'nagios_servicegroup': nagios_servicegroups,
+            'description': self.description,
+            'shortname': self.shortname,
+            'command': self.command,
+        }
+        nrpe_service_text = Check.service_template.format(**templ_vars)
+        nrpe_service_file = self._get_service_filename(hostname)
+        with open(nrpe_service_file, 'w') as nrpe_service_config:
+            nrpe_service_config.write(str(nrpe_service_text))
+
+    def run(self):
+        subprocess.call(self.check_cmd)
+
+
+class NRPE(object):
+    nagios_logdir = '/var/log/nagios'
+    nagios_exportdir = '/var/lib/nagios/export'
+    nrpe_confdir = '/etc/nagios/nrpe.d'
+    homedir = '/var/lib/nagios'  # home dir provided by nagios-nrpe-server
+
+    def __init__(self, hostname=None, primary=True):
+        super(NRPE, self).__init__()
+        self.config = config()
+        self.primary = primary
+        self.nagios_context = self.config['nagios_context']
+        if 'nagios_servicegroups' in self.config and self.config['nagios_servicegroups']:
+            self.nagios_servicegroups = self.config['nagios_servicegroups']
+        else:
+            self.nagios_servicegroups = self.nagios_context
+        self.unit_name = local_unit().replace('/', '-')
+        if hostname:
+            self.hostname = hostname
+        else:
+            nagios_hostname = get_nagios_hostname()
+            if nagios_hostname:
+                self.hostname = nagios_hostname
+            else:
+                self.hostname = "{}-{}".format(self.nagios_context, self.unit_name)
+        self.checks = []
+        # Iff in an nrpe-external-master relation hook, set primary status
+        relation = relation_ids('nrpe-external-master')
+        if relation:
+            log("Setting charm primary status {}".format(primary))
+            for rid in relation:
+                relation_set(relation_id=rid, relation_settings={'primary': self.primary})
+        self.remove_check_queue = set()
+
+    def add_check(self, *args, **kwargs):
+        shortname = None
+        if kwargs.get('shortname') is None:
+            if len(args) > 0:
+                shortname = args[0]
+        else:
+            shortname = kwargs['shortname']
+
+        self.checks.append(Check(*args, **kwargs))
+        try:
+            self.remove_check_queue.remove(shortname)
+        except KeyError:
+            pass
+
+    def remove_check(self, *args, **kwargs):
+        if kwargs.get('shortname') is None:
+            raise ValueError('shortname of check must be specified')
+
+        # Use sensible defaults if they're not specified - these are not
+        # actually used during removal, but they're required for constructing
+        # the Check object; check_disk is chosen because it's part of the
+        # nagios-plugins-basic package.
+        if kwargs.get('check_cmd') is None:
+            kwargs['check_cmd'] = 'check_disk'
+        if kwargs.get('description') is None:
+            kwargs['description'] = ''
+
+        check = Check(*args, **kwargs)
+        check.remove(self.hostname)
+        self.remove_check_queue.add(kwargs['shortname'])
+
+    def write(self):
+        try:
+            nagios_uid = pwd.getpwnam('nagios').pw_uid
+            nagios_gid = grp.getgrnam('nagios').gr_gid
+        except Exception:
+            log("Nagios user not set up, nrpe checks not updated")
+            return
+
+        if not os.path.exists(NRPE.nagios_logdir):
+            os.mkdir(NRPE.nagios_logdir)
+            os.chown(NRPE.nagios_logdir, nagios_uid, nagios_gid)
+
+        nrpe_monitors = {}
+        monitors = {"monitors": {"remote": {"nrpe": nrpe_monitors}}}
+        for nrpecheck in self.checks:
+            nrpecheck.write(self.nagios_context, self.hostname,
+                            self.nagios_servicegroups)
+            nrpe_monitors[nrpecheck.shortname] = {
+                "command": nrpecheck.command,
+            }
+
+        # update-status hooks are configured to firing every 5 minutes by
+        # default. When nagios-nrpe-server is restarted, the nagios server
+        # reports checks failing causing unnecessary alerts. Let's not restart
+        # on update-status hooks.
+        if not hook_name() == 'update-status':
+            service('restart', 'nagios-nrpe-server')
+
+        monitor_ids = relation_ids("local-monitors") + \
+            relation_ids("nrpe-external-master")
+        for rid in monitor_ids:
+            reldata = relation_get(unit=local_unit(), rid=rid)
+            if 'monitors' in reldata:
+                # update the existing set of monitors with the new data
+                old_monitors = yaml.safe_load(reldata['monitors'])
+                old_nrpe_monitors = old_monitors['monitors']['remote']['nrpe']
+                # remove keys that are in the remove_check_queue
+                old_nrpe_monitors = {k: v for k, v in old_nrpe_monitors.items()
+                                     if k not in self.remove_check_queue}
+                # update/add nrpe_monitors
+                old_nrpe_monitors.update(nrpe_monitors)
+                old_monitors['monitors']['remote']['nrpe'] = old_nrpe_monitors
+                # write back to the relation
+                relation_set(relation_id=rid, monitors=yaml.dump(old_monitors))
+            else:
+                # write a brand new set of monitors, as no existing ones.
+                relation_set(relation_id=rid, monitors=yaml.dump(monitors))
+
+        self.remove_check_queue.clear()
+
+
+def get_nagios_hostcontext(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_host_context
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_host_context' in rel:
+            return rel['nagios_host_context']
+
+
+def get_nagios_hostname(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_hostname
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_hostname' in rel:
+            return rel['nagios_hostname']
+
+
+def get_nagios_unit_name(relation_name='nrpe-external-master'):
+    """
+    Return the nagios unit name prepended with host_context if needed
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    host_context = get_nagios_hostcontext(relation_name)
+    if host_context:
+        unit = "%s:%s" % (host_context, local_unit())
+    else:
+        unit = local_unit()
+    return unit
+
+
+def add_init_service_checks(nrpe, services, unit_name, immediate_check=True):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param list services: List of services to check
+    :param str unit_name: Unit name to use in check description
+    :param bool immediate_check: For sysv init, run the service check immediately
+    """
+    for svc in services:
+        # Don't add a check for these services from neutron-gateway
+        if svc in ['ext-port', 'os-charm-phy-nic-mtu']:
+            next
+
+        upstart_init = '/etc/init/%s.conf' % svc
+        sysv_init = '/etc/init.d/%s' % svc
+
+        if host.init_is_systemd():
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_systemd.py %s' % svc
+            )
+        elif os.path.exists(upstart_init):
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_upstart_job %s' % svc
+            )
+        elif os.path.exists(sysv_init):
+            cronpath = '/etc/cron.d/nagios-service-check-%s' % svc
+            checkpath = '%s/service-check-%s.txt' % (nrpe.homedir, svc)
+            croncmd = (
+                '/usr/local/lib/nagios/plugins/check_exit_status.pl '
+                '-e -s /etc/init.d/%s status' % svc
+            )
+            cron_file = '*/5 * * * * root %s > %s\n' % (croncmd, checkpath)
+            f = open(cronpath, 'w')
+            f.write(cron_file)
+            f.close()
+            nrpe.add_check(
+                shortname=svc,
+                description='service check {%s}' % unit_name,
+                check_cmd='check_status_file.py -f %s' % checkpath,
+            )
+            # if /var/lib/nagios doesn't exist open(checkpath, 'w') will fail
+            # (LP: #1670223).
+            if immediate_check and os.path.isdir(nrpe.homedir):
+                f = open(checkpath, 'w')
+                subprocess.call(
+                    croncmd.split(),
+                    stdout=f,
+                    stderr=subprocess.STDOUT
+                )
+                f.close()
+                os.chmod(checkpath, 0o644)
+
+
+def copy_nrpe_checks(nrpe_files_dir=None):
+    """
+    Copy the nrpe checks into place
+
+    """
+    NAGIOS_PLUGINS = '/usr/local/lib/nagios/plugins'
+    if nrpe_files_dir is None:
+        # determine if "charmhelpers" is in CHARMDIR or CHARMDIR/hooks
+        for segment in ['.', 'hooks']:
+            nrpe_files_dir = os.path.abspath(os.path.join(
+                os.getenv('CHARM_DIR'),
+                segment,
+                'charmhelpers',
+                'contrib',
+                'openstack',
+                'files'))
+            if os.path.isdir(nrpe_files_dir):
+                break
+        else:
+            raise RuntimeError("Couldn't find charmhelpers directory")
+    if not os.path.exists(NAGIOS_PLUGINS):
+        os.makedirs(NAGIOS_PLUGINS)
+    for fname in glob.glob(os.path.join(nrpe_files_dir, "check_*")):
+        if os.path.isfile(fname):
+            shutil.copy2(fname,
+                         os.path.join(NAGIOS_PLUGINS, os.path.basename(fname)))
+
+
+def add_haproxy_checks(nrpe, unit_name):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param str unit_name: Unit name to use in check description
+    """
+    nrpe.add_check(
+        shortname='haproxy_servers',
+        description='Check HAProxy {%s}' % unit_name,
+        check_cmd='check_haproxy.sh')
+    nrpe.add_check(
+        shortname='haproxy_queue',
+        description='Check HAProxy queue depth {%s}' % unit_name,
+        check_cmd='check_haproxy_queue_depth.sh')
+
+
+def remove_deprecated_check(nrpe, deprecated_services):
+    """
+    Remove checks fro deprecated services in list
+
+    :param nrpe: NRPE object to remove check from
+    :type nrpe: NRPE
+    :param deprecated_services: List of deprecated services that are removed
+    :type deprecated_services: list
+    """
+    for dep_svc in deprecated_services:
+        log('Deprecated service: {}'.format(dep_svc))
+        nrpe.remove_check(shortname=dep_svc)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/volumes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/volumes.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ea43f0888cd92ac4344f908aa7c9d0afe7568ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/charmsupport/volumes.py
@@ -0,0 +1,173 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Functions for managing volumes in juju units. One volume is supported per unit.
+Subordinates may have their own storage, provided it is on its own partition.
+
+Configuration stanzas::
+
+  volume-ephemeral:
+    type: boolean
+    default: true
+    description: >
+      If false, a volume is mounted as sepecified in "volume-map"
+      If true, ephemeral storage will be used, meaning that log data
+         will only exist as long as the machine. YOU HAVE BEEN WARNED.
+  volume-map:
+    type: string
+    default: {}
+    description: >
+      YAML map of units to device names, e.g:
+        "{ rsyslog/0: /dev/vdb, rsyslog/1: /dev/vdb }"
+      Service units will raise a configure-error if volume-ephemeral
+      is 'true' and no volume-map value is set. Use 'juju set' to set a
+      value and 'juju resolved' to complete configuration.
+
+Usage::
+
+    from charmsupport.volumes import configure_volume, VolumeConfigurationError
+    from charmsupport.hookenv import log, ERROR
+    def post_mount_hook():
+        stop_service('myservice')
+    def post_mount_hook():
+        start_service('myservice')
+
+    if __name__ == '__main__':
+        try:
+            configure_volume(before_change=pre_mount_hook,
+                             after_change=post_mount_hook)
+        except VolumeConfigurationError:
+            log('Storage could not be configured', ERROR)
+
+'''
+
+# XXX: Known limitations
+# - fstab is neither consulted nor updated
+
+import os
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+import yaml
+
+
+MOUNT_BASE = '/srv/juju/volumes'
+
+
+class VolumeConfigurationError(Exception):
+    '''Volume configuration data is missing or invalid'''
+    pass
+
+
+def get_config():
+    '''Gather and sanity-check volume configuration data'''
+    volume_config = {}
+    config = hookenv.config()
+
+    errors = False
+
+    if config.get('volume-ephemeral') in (True, 'True', 'true', 'Yes', 'yes'):
+        volume_config['ephemeral'] = True
+    else:
+        volume_config['ephemeral'] = False
+
+    try:
+        volume_map = yaml.safe_load(config.get('volume-map', '{}'))
+    except yaml.YAMLError as e:
+        hookenv.log("Error parsing YAML volume-map: {}".format(e),
+                    hookenv.ERROR)
+        errors = True
+    if volume_map is None:
+        # probably an empty string
+        volume_map = {}
+    elif not isinstance(volume_map, dict):
+        hookenv.log("Volume-map should be a dictionary, not {}".format(
+            type(volume_map)))
+        errors = True
+
+    volume_config['device'] = volume_map.get(os.environ['JUJU_UNIT_NAME'])
+    if volume_config['device'] and volume_config['ephemeral']:
+        # asked for ephemeral storage but also defined a volume ID
+        hookenv.log('A volume is defined for this unit, but ephemeral '
+                    'storage was requested', hookenv.ERROR)
+        errors = True
+    elif not volume_config['device'] and not volume_config['ephemeral']:
+        # asked for permanent storage but did not define volume ID
+        hookenv.log('Ephemeral storage was requested, but there is no volume '
+                    'defined for this unit.', hookenv.ERROR)
+        errors = True
+
+    unit_mount_name = hookenv.local_unit().replace('/', '-')
+    volume_config['mountpoint'] = os.path.join(MOUNT_BASE, unit_mount_name)
+
+    if errors:
+        return None
+    return volume_config
+
+
+def mount_volume(config):
+    if os.path.exists(config['mountpoint']):
+        if not os.path.isdir(config['mountpoint']):
+            hookenv.log('Not a directory: {}'.format(config['mountpoint']))
+            raise VolumeConfigurationError()
+    else:
+        host.mkdir(config['mountpoint'])
+    if os.path.ismount(config['mountpoint']):
+        unmount_volume(config)
+    if not host.mount(config['device'], config['mountpoint'], persist=True):
+        raise VolumeConfigurationError()
+
+
+def unmount_volume(config):
+    if os.path.ismount(config['mountpoint']):
+        if not host.umount(config['mountpoint'], persist=True):
+            raise VolumeConfigurationError()
+
+
+def managed_mounts():
+    '''List of all mounted managed volumes'''
+    return filter(lambda mount: mount[0].startswith(MOUNT_BASE), host.mounts())
+
+
+def configure_volume(before_change=lambda: None, after_change=lambda: None):
+    '''Set up storage (or don't) according to the charm's volume configuration.
+       Returns the mount point or "ephemeral". before_change and after_change
+       are optional functions to be called if the volume configuration changes.
+    '''
+
+    config = get_config()
+    if not config:
+        hookenv.log('Failed to read volume configuration', hookenv.CRITICAL)
+        raise VolumeConfigurationError()
+
+    if config['ephemeral']:
+        if os.path.ismount(config['mountpoint']):
+            before_change()
+            unmount_volume(config)
+            after_change()
+        return 'ephemeral'
+    else:
+        # persistent storage
+        if os.path.ismount(config['mountpoint']):
+            mounts = dict(managed_mounts())
+            if mounts.get(config['mountpoint']) != config['device']:
+                before_change()
+                unmount_volume(config)
+                mount_volume(config)
+                after_change()
+        else:
+            before_change()
+            mount_volume(config)
+            after_change()
+        return config['mountpoint']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..64fac9def6101c1de83cd5dafe7fdb5213d6a955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/__init__.py
@@ -0,0 +1,11 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/mysql.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/mysql.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9ecce5f793eedeb963557d109deaf5e1271e65f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/database/mysql.py
@@ -0,0 +1,821 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper for working with a MySQL database"""
+import collections
+import copy
+import json
+import re
+import sys
+import platform
+import os
+import glob
+import six
+
+# from string import upper
+
+from charmhelpers.core.host import (
+    CompareHostReleases,
+    lsb_release,
+    mkdir,
+    pwgen,
+    write_file
+)
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    related_units,
+    unit_get,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    leader_get,
+    leader_set,
+    is_leader,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+    filter_installed_packages,
+)
+from charmhelpers.contrib.network.ip import get_host_ip
+
+try:
+    import MySQLdb
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install(filter_installed_packages(['python-mysqldb']), fatal=True)
+    else:
+        apt_install(filter_installed_packages(['python3-mysqldb']), fatal=True)
+    import MySQLdb
+
+
+class MySQLSetPasswordError(Exception):
+    pass
+
+
+class MySQLHelper(object):
+
+    def __init__(self, rpasswdf_template, upasswdf_template, host='localhost',
+                 migrate_passwd_to_leader_storage=True,
+                 delete_ondisk_passwd_file=True, user="root", password=None, port=None):
+        self.user = user
+        self.host = host
+        self.password = password
+        self.port = port
+
+        # Password file path templates
+        self.root_passwd_file_template = rpasswdf_template
+        self.user_passwd_file_template = upasswdf_template
+
+        self.migrate_passwd_to_leader_storage = migrate_passwd_to_leader_storage
+        # If we migrate we have the option to delete local copy of root passwd
+        self.delete_ondisk_passwd_file = delete_ondisk_passwd_file
+        self.connection = None
+
+    def connect(self, user='root', password=None, host=None, port=None):
+        _connection_info = {
+            "user": user or self.user,
+            "passwd": password or self.password,
+            "host": host or self.host
+        }
+        # port cannot be None but we also do not want to specify it unless it
+        # has been explicit set.
+        port = port or self.port
+        if port is not None:
+            _connection_info["port"] = port
+
+        log("Opening db connection for %s@%s" % (user, host), level=DEBUG)
+        self.connection = MySQLdb.connect(**_connection_info)
+
+    def database_exists(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("SHOW DATABASES")
+            databases = [i[0] for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+
+        return db_name in databases
+
+    def create_database(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("CREATE DATABASE `{}` CHARACTER SET UTF8"
+                           .format(db_name))
+        finally:
+            cursor.close()
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = "GRANT ALL PRIVILEGES ON `{}`.* " \
+                      "TO '{}'@'{}'".format(db_name, db_user, remote_ip)
+        try:
+            cursor.execute("SHOW GRANTS for '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # TODO: review for different grants
+        return priv_string in grants
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            # TODO: review for different grants
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_name,
+                                                       db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def create_admin_grant(self, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON *.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def cleanup_grant(self, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("DROP FROM mysql.user WHERE user='{}' "
+                           "AND HOST='{}'".format(db_user,
+                                                  remote_ip))
+        finally:
+            cursor.close()
+
+    def flush_priviledges(self):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("FLUSH PRIVILEGES")
+        finally:
+            cursor.close()
+
+    def execute(self, sql):
+        """Execute arbitary SQL against the database."""
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+        finally:
+            cursor.close()
+
+    def select(self, sql):
+        """
+        Execute arbitrary SQL select query against the database
+        and return the results.
+
+        :param sql: SQL select query to execute
+        :type sql: string
+        :returns: SQL select query result
+        :rtype: list of lists
+        :raises: MySQLdb.Error
+        """
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+            results = [list(i) for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+        return results
+
+    def migrate_passwords_to_leader_storage(self, excludes=None):
+        """Migrate any passwords storage on disk to leader storage."""
+        if not is_leader():
+            log("Skipping password migration as not the lead unit",
+                level=DEBUG)
+            return
+        dirname = os.path.dirname(self.root_passwd_file_template)
+        path = os.path.join(dirname, '*.passwd')
+        for f in glob.glob(path):
+            if excludes and f in excludes:
+                log("Excluding %s from leader storage migration" % (f),
+                    level=DEBUG)
+                continue
+
+            key = os.path.basename(f)
+            with open(f, 'r') as passwd:
+                _value = passwd.read().strip()
+
+            try:
+                leader_set(settings={key: _value})
+
+                if self.delete_ondisk_passwd_file:
+                    os.unlink(f)
+            except ValueError:
+                # NOTE cluster relation not yet ready - skip for now
+                pass
+
+    def get_mysql_password_on_disk(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username on disk."""
+        if username:
+            template = self.user_passwd_file_template
+            passwd_file = template.format(username)
+        else:
+            passwd_file = self.root_passwd_file_template
+
+        _password = None
+        if os.path.exists(passwd_file):
+            log("Using existing password file '%s'" % passwd_file, level=DEBUG)
+            with open(passwd_file, 'r') as passwd:
+                _password = passwd.read().strip()
+        else:
+            log("Generating new password file '%s'" % passwd_file, level=DEBUG)
+            if not os.path.isdir(os.path.dirname(passwd_file)):
+                # NOTE: need to ensure this is not mysql root dir (which needs
+                # to be mysql readable)
+                mkdir(os.path.dirname(passwd_file), owner='root', group='root',
+                      perms=0o770)
+                # Force permissions - for some reason the chmod in makedirs
+                # fails
+                os.chmod(os.path.dirname(passwd_file), 0o770)
+
+            _password = password or pwgen(length=32)
+            write_file(passwd_file, _password, owner='root', group='root',
+                       perms=0o660)
+
+        return _password
+
+    def passwd_keys(self, username):
+        """Generator to return keys used to store passwords in peer store.
+
+        NOTE: we support both legacy and new format to support mysql
+        charm prior to refactor. This is necessary to avoid LP 1451890.
+        """
+        keys = []
+        if username == 'mysql':
+            log("Bad username '%s'" % (username), level=WARNING)
+
+        if username:
+            # IMPORTANT: *newer* format must be returned first
+            keys.append('mysql-%s.passwd' % (username))
+            keys.append('%s.passwd' % (username))
+        else:
+            keys.append('mysql.passwd')
+
+        for key in keys:
+            yield key
+
+    def get_mysql_password(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username using peer relation cluster."""
+        excludes = []
+
+        # First check peer relation.
+        try:
+            for key in self.passwd_keys(username):
+                _password = leader_get(key)
+                if _password:
+                    break
+
+            # If root password available don't update peer relation from local
+            if _password and not username:
+                excludes.append(self.root_passwd_file_template)
+
+        except ValueError:
+            # cluster relation is not yet started; use on-disk
+            _password = None
+
+        # If none available, generate new one
+        if not _password:
+            _password = self.get_mysql_password_on_disk(username, password)
+
+        # Put on wire if required
+        if self.migrate_passwd_to_leader_storage:
+            self.migrate_passwords_to_leader_storage(excludes=excludes)
+
+        return _password
+
+    def get_mysql_root_password(self, password=None):
+        """Retrieve or generate mysql root password for service units."""
+        return self.get_mysql_password(username=None, password=password)
+
+    def set_mysql_password(self, username, password, current_password=None):
+        """Update a mysql password for the provided username changing the
+        leader settings
+
+        To update root's password pass `None` in the username
+
+        :param username: Username to change password of
+        :type username: str
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+
+        if username is None:
+            username = 'root'
+
+        # get root password via leader-get, it may be that in the past (when
+        # changes to root-password were not supported) the user changed the
+        # password, so leader-get is more reliable source than
+        # config.previous('root-password').
+        rel_username = None if username == 'root' else username
+        if not current_password:
+            current_password = self.get_mysql_password(rel_username)
+
+        # password that needs to be set
+        new_passwd = password
+
+        # update password for all users (e.g. root@localhost, root@::1, etc)
+        try:
+            self.connect(user=username, password=current_password)
+            cursor = self.connection.cursor()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using password in '
+                                         'leader settings (%s)') % ex, ex)
+
+        try:
+            # NOTE(freyes): Due to skip-name-resolve root@$HOSTNAME account
+            # fails when using SET PASSWORD so using UPDATE against the
+            # mysql.user table is needed, but changes to this table are not
+            # replicated across the cluster, so this update needs to run in
+            # all the nodes. More info at
+            # http://galeracluster.com/documentation-webpages/userchanges.html
+            release = CompareHostReleases(lsb_release()['DISTRIB_CODENAME'])
+            if release < 'bionic':
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET password = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            else:
+                # PXC 5.7 (introduced in Bionic) uses authentication_string
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET "
+                                     "authentication_string = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            cursor.execute(SQL_UPDATE_PASSWD, (new_passwd, username))
+            cursor.execute('FLUSH PRIVILEGES;')
+            self.connection.commit()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError('Cannot update password: %s' % str(ex),
+                                        ex)
+        finally:
+            cursor.close()
+
+        # check the password was changed
+        try:
+            self.connect(user=username, password=new_passwd)
+            self.execute('select 1;')
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using new password: '
+                                         '%s') % str(ex), ex)
+
+        if not is_leader():
+            log('Only the leader can set a new password in the relation',
+                level=DEBUG)
+            return
+
+        for key in self.passwd_keys(rel_username):
+            _password = leader_get(key)
+            if _password:
+                log('Updating password for %s (%s)' % (key, rel_username),
+                    level=DEBUG)
+                leader_set(settings={key: new_passwd})
+
+    def set_mysql_root_password(self, password, current_password=None):
+        """Update mysql root password changing the leader settings
+
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+        self.set_mysql_password(
+            'root',
+            password,
+            current_password=current_password)
+
+    def normalize_address(self, hostname):
+        """Ensure that address returned is an IP address (i.e. not fqdn)"""
+        if config_get('prefer-ipv6'):
+            # TODO: add support for ipv6 dns
+            return hostname
+
+        if hostname != unit_get('private-address'):
+            return get_host_ip(hostname, fallback=hostname)
+
+        # Otherwise assume localhost
+        return '127.0.0.1'
+
+    def get_allowed_units(self, database, username, relation_id=None):
+        """Get list of units with access grants for database with username.
+
+        This is typically used to provide shared-db relations with a list of
+        which units have been granted access to the given database.
+        """
+        self.connect(password=self.get_mysql_root_password())
+        allowed_units = set()
+        for unit in related_units(relation_id):
+            settings = relation_get(rid=relation_id, unit=unit)
+            # First check for setting with prefix, then without
+            for attr in ["%s_hostname" % (database), 'hostname']:
+                hosts = settings.get(attr, None)
+                if hosts:
+                    break
+
+            if hosts:
+                # hostname can be json-encoded list of hostnames
+                try:
+                    hosts = json.loads(hosts)
+                except ValueError:
+                    hosts = [hosts]
+            else:
+                hosts = [settings['private-address']]
+
+            if hosts:
+                for host in hosts:
+                    host = self.normalize_address(host)
+                    if self.grant_exists(database, username, host):
+                        log("Grant exists for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+                        if unit not in allowed_units:
+                            allowed_units.add(unit)
+                    else:
+                        log("Grant does NOT exist for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+            else:
+                log("No hosts found for grant check", level=INFO)
+
+        return allowed_units
+
+    def configure_db(self, hostname, database, username, admin=False):
+        """Configure access to database for username from hostname."""
+        self.connect(password=self.get_mysql_root_password())
+        if not self.database_exists(database):
+            self.create_database(database)
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        if not self.grant_exists(database, username, remote_ip):
+            if not admin:
+                self.create_grant(database, username, remote_ip, password)
+            else:
+                self.create_admin_grant(username, remote_ip, password)
+            self.flush_priviledges()
+
+        return password
+
+
+# `_singleton_config_helper` stores the instance of the helper class that is
+# being used during a hook invocation.
+_singleton_config_helper = None
+
+
+def get_mysql_config_helper():
+    global _singleton_config_helper
+    if _singleton_config_helper is None:
+        _singleton_config_helper = MySQLConfigHelper()
+    return _singleton_config_helper
+
+
+class MySQLConfigHelper(object):
+    """Base configuration helper for MySQL."""
+
+    # Going for the biggest page size to avoid wasted bytes.
+    # InnoDB page size is 16MB
+
+    DEFAULT_PAGE_SIZE = 16 * 1024 * 1024
+    DEFAULT_INNODB_BUFFER_FACTOR = 0.50
+    DEFAULT_INNODB_BUFFER_SIZE_MAX = 512 * 1024 * 1024
+
+    # Validation and lookups for InnoDB configuration
+    INNODB_VALID_BUFFERING_VALUES = [
+        'none',
+        'inserts',
+        'deletes',
+        'changes',
+        'purges',
+        'all'
+    ]
+    INNODB_FLUSH_CONFIG_VALUES = {
+        'fast': 2,
+        'safest': 1,
+        'unsafe': 0,
+    }
+
+    def human_to_bytes(self, human):
+        """Convert human readable configuration options to bytes."""
+        num_re = re.compile('^[0-9]+$')
+        if num_re.match(human):
+            return human
+
+        factors = {
+            'K': 1024,
+            'M': 1048576,
+            'G': 1073741824,
+            'T': 1099511627776
+        }
+        modifier = human[-1]
+        if modifier in factors:
+            return int(human[:-1]) * factors[modifier]
+
+        if modifier == '%':
+            total_ram = self.human_to_bytes(self.get_mem_total())
+            if self.is_32bit_system() and total_ram > self.sys_mem_limit():
+                total_ram = self.sys_mem_limit()
+            factor = int(human[:-1]) * 0.01
+            pctram = total_ram * factor
+            return int(pctram - (pctram % self.DEFAULT_PAGE_SIZE))
+
+        raise ValueError("Can only convert K,M,G, or T")
+
+    def is_32bit_system(self):
+        """Determine whether system is 32 or 64 bit."""
+        try:
+            return sys.maxsize < 2 ** 32
+        except OverflowError:
+            return False
+
+    def sys_mem_limit(self):
+        """Determine the default memory limit for the current service unit."""
+        if platform.machine() in ['armv7l']:
+            _mem_limit = self.human_to_bytes('2700M')  # experimentally determined
+        else:
+            # Limit for x86 based 32bit systems
+            _mem_limit = self.human_to_bytes('4G')
+
+        return _mem_limit
+
+    def get_mem_total(self):
+        """Calculate the total memory in the current service unit."""
+        with open('/proc/meminfo') as meminfo_file:
+            for line in meminfo_file:
+                key, mem = line.split(':', 2)
+                if key == 'MemTotal':
+                    mtot, modifier = mem.strip().split(' ')
+                    return '%s%s' % (mtot, modifier[0].upper())
+
+    def get_innodb_flush_log_at_trx_commit(self):
+        """Get value for innodb_flush_log_at_trx_commit.
+
+        Use the innodb-flush-log-at-trx-commit or the tunning-level setting
+        translated by INNODB_FLUSH_CONFIG_VALUES to get the
+        innodb_flush_log_at_trx_commit value.
+
+        :returns: Numeric value for innodb_flush_log_at_trx_commit
+        :rtype: Union[None, int]
+        """
+        _iflatc = config_get('innodb-flush-log-at-trx-commit')
+        _tuning_level = config_get('tuning-level')
+        if _iflatc:
+            return _iflatc
+        elif _tuning_level:
+            return self.INNODB_FLUSH_CONFIG_VALUES.get(_tuning_level, 1)
+
+    def get_innodb_change_buffering(self):
+        """Get value for innodb_change_buffering.
+
+        Use the innodb-change-buffering validated against
+        INNODB_VALID_BUFFERING_VALUES to get the innodb_change_buffering value.
+
+        :returns: String value for innodb_change_buffering.
+        :rtype: Union[None, str]
+        """
+        _icb = config_get('innodb-change-buffering')
+        if _icb and _icb in self.INNODB_VALID_BUFFERING_VALUES:
+            return _icb
+
+    def get_innodb_buffer_pool_size(self):
+        """Get value for innodb_buffer_pool_size.
+
+        Return the number value of innodb-buffer-pool-size or dataset-size. If
+        neither is set, calculate a sane default based on total memory.
+
+        :returns: Numeric value for innodb_buffer_pool_size.
+        :rtype: int
+        """
+        total_memory = self.human_to_bytes(self.get_mem_total())
+
+        dataset_bytes = config_get('dataset-size')
+        innodb_buffer_pool_size = config_get('innodb-buffer-pool-size')
+
+        if innodb_buffer_pool_size:
+            innodb_buffer_pool_size = self.human_to_bytes(
+                innodb_buffer_pool_size)
+        elif dataset_bytes:
+            log("Option 'dataset-size' has been deprecated, please use"
+                "innodb_buffer_pool_size option instead", level="WARN")
+            innodb_buffer_pool_size = self.human_to_bytes(
+                dataset_bytes)
+        else:
+            # NOTE(jamespage): pick the smallest of 50% of RAM or 512MB
+            #                  to ensure that deployments in containers
+            #                  without constraints don't try to consume
+            #                  silly amounts of memory.
+            innodb_buffer_pool_size = min(
+                int(total_memory * self.DEFAULT_INNODB_BUFFER_FACTOR),
+                self.DEFAULT_INNODB_BUFFER_SIZE_MAX
+            )
+
+        if innodb_buffer_pool_size > total_memory:
+            log("innodb_buffer_pool_size; {} is greater than system available memory:{}".format(
+                innodb_buffer_pool_size,
+                total_memory), level='WARN')
+
+        return innodb_buffer_pool_size
+
+
+class PerconaClusterHelper(MySQLConfigHelper):
+    """Percona-cluster specific configuration helper."""
+
+    def parse_config(self):
+        """Parse charm configuration and calculate values for config files."""
+        config = config_get()
+        mysql_config = {}
+        if 'max-connections' in config:
+            mysql_config['max_connections'] = config['max-connections']
+
+        if 'wait-timeout' in config:
+            mysql_config['wait_timeout'] = config['wait-timeout']
+
+        if self.get_innodb_flush_log_at_trx_commit() is not None:
+            mysql_config['innodb_flush_log_at_trx_commit'] = \
+                self.get_innodb_flush_log_at_trx_commit()
+
+        if self.get_innodb_change_buffering() is not None:
+            mysql_config['innodb_change_buffering'] = config['innodb-change-buffering']
+
+        if 'innodb-io-capacity' in config:
+            mysql_config['innodb_io_capacity'] = config['innodb-io-capacity']
+
+        # Set a sane default key_buffer size
+        mysql_config['key_buffer'] = self.human_to_bytes('32M')
+        mysql_config['innodb_buffer_pool_size'] = self.get_innodb_buffer_pool_size()
+        return mysql_config
+
+
+class MySQL8Helper(MySQLHelper):
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = ("GRANT ALL PRIVILEGES ON {}.* "
+                       "TO {}@{}".format(db_name, db_user, remote_ip))
+        try:
+            cursor.execute("SHOW GRANTS FOR '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # Different versions of MySQL use ' or `. Ignore these in the check.
+        return priv_string in [
+            i.replace("'", "").replace("`", "") for i in grants]
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        if self.grant_exists(db_name, db_user, remote_ip):
+            return
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}'"
+                           .format(db_name, db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def create_user(self, db_user, remote_ip, password):
+
+        SQL_USER_CREATE = (
+            "CREATE USER '{db_user}'@'{remote_ip}' "
+            "IDENTIFIED BY '{password}'")
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(SQL_USER_CREATE.format(
+                db_user=db_user,
+                remote_ip=remote_ip,
+                password=password)
+            )
+        except MySQLdb._exceptions.OperationalError:
+            log("DB user {} already exists.".format(db_user),
+                "WARNING")
+        finally:
+            cursor.close()
+
+    def create_router_grant(self, db_user, remote_ip, password):
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        # Mysql-Router specific grants
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT CREATE USER ON *.* TO '{}'@'{}' WITH GRANT "
+                           "OPTION".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT, INSERT, UPDATE, DELETE, EXECUTE ON "
+                           "mysql_innodb_cluster_metadata.* TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON mysql.user TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_members "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_member_stats "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.global_variables "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def configure_router(self, hostname, username):
+
+        if self.connection is None:
+            self.connect(password=self.get_mysql_root_password())
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        self.create_user(username, remote_ip, password)
+        self.create_router_grant(username, remote_ip, password)
+
+        return password
+
+
+def get_prefix(requested, keys=None):
+    """Return existing prefix or None.
+
+    :param requested: Request string. i.e. novacell0_username
+    :type requested: str
+    :param keys: Keys to determine prefix. Defaults set in function.
+    :type keys: List of str keys
+    :returns: String prefix i.e. novacell0
+    :rtype: Union[None, str]
+    """
+    if keys is None:
+        # Shared-DB default keys
+        keys = ["_database", "_username", "_hostname"]
+    for key in keys:
+        if requested.endswith(key):
+            return requested[:-len(key)]
+
+
+def get_db_data(relation_data, unprefixed):
+    """Organize database requests into a collections.OrderedDict
+
+    :param relation_data: shared-db relation data
+    :type relation_data: dict
+    :param unprefixed: Prefix to use for requests without a prefix. This should
+                       be unique for each side of the relation to avoid
+                       conflicts.
+    :type unprefixed: str
+    :returns: Order dict of databases and users
+    :rtype: collections.OrderedDict
+    """
+    # Deep copy to avoid unintentionally changing relation data
+    settings = copy.deepcopy(relation_data)
+    databases = collections.OrderedDict()
+
+    # Clear non-db related elements
+    if "egress-subnets" in settings.keys():
+        settings.pop("egress-subnets")
+    if "ingress-address" in settings.keys():
+        settings.pop("ingress-address")
+    if "private-address" in settings.keys():
+        settings.pop("private-address")
+
+    singleset = {"database", "username", "hostname"}
+    if singleset.issubset(settings):
+        settings["{}_{}".format(unprefixed, "hostname")] = (
+            settings["hostname"])
+        settings.pop("hostname")
+        settings["{}_{}".format(unprefixed, "database")] = (
+            settings["database"])
+        settings.pop("database")
+        settings["{}_{}".format(unprefixed, "username")] = (
+            settings["username"])
+        settings.pop("username")
+
+    for k, v in settings.items():
+        db = k.split("_")[0]
+        x = "_".join(k.split("_")[1:])
+        if db not in databases:
+            databases[db] = collections.OrderedDict()
+        databases[db][x] = v
+
+    return databases
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c1e371e179bb6926f227331f86cb14a38c229a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/apache.py
@@ -0,0 +1,86 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import os
+
+from charmhelpers.core import host
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    relation_ids,
+    related_units as relation_list,
+    log,
+    INFO,
+)
+
+
+def get_cert(cn=None):
+    # TODO: deal with multiple https endpoints via charm config
+    cert = config_get('ssl_cert')
+    key = config_get('ssl_key')
+    if not (cert and key):
+        log("Inspecting identity-service relations for SSL certificate.",
+            level=INFO)
+        cert = key = None
+        if cn:
+            ssl_cert_attr = 'ssl_cert_{}'.format(cn)
+            ssl_key_attr = 'ssl_key_{}'.format(cn)
+        else:
+            ssl_cert_attr = 'ssl_cert'
+            ssl_key_attr = 'ssl_key'
+        for r_id in relation_ids('identity-service'):
+            for unit in relation_list(r_id):
+                if not cert:
+                    cert = relation_get(ssl_cert_attr,
+                                        rid=r_id, unit=unit)
+                if not key:
+                    key = relation_get(ssl_key_attr,
+                                       rid=r_id, unit=unit)
+    return (cert, key)
+
+
+def get_ca_cert():
+    ca_cert = config_get('ssl_ca')
+    if ca_cert is None:
+        log("Inspecting identity-service relations for CA SSL certificate.",
+            level=INFO)
+        for r_id in (relation_ids('identity-service') +
+                     relation_ids('identity-credentials')):
+            for unit in relation_list(r_id):
+                if ca_cert is None:
+                    ca_cert = relation_get('ca_cert',
+                                           rid=r_id, unit=unit)
+    return ca_cert
+
+
+def retrieve_ca_cert(cert_file):
+    cert = None
+    if os.path.isfile(cert_file):
+        with open(cert_file, 'rb') as crt:
+            cert = crt.read()
+    return cert
+
+
+def install_ca_cert(ca_cert):
+    host.install_ca_cert(ca_cert, 'keystone_juju_ca_cert')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba34fba0cafa21d15a6a27946544b2c99fbd3663
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hahelpers/cluster.py
@@ -0,0 +1,451 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+"""
+Helpers for clustering and determining "cluster leadership" and other
+clustering-related helpers.
+"""
+
+import functools
+import subprocess
+import os
+import time
+
+from socket import gethostname as get_unit_hostname
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    relation_ids,
+    related_units as relation_list,
+    relation_get,
+    config as config_get,
+    INFO,
+    DEBUG,
+    WARNING,
+    unit_get,
+    is_leader as juju_is_leader,
+    status_set,
+)
+from charmhelpers.core.host import (
+    modulo_distribution,
+)
+from charmhelpers.core.decorators import (
+    retry_on_exception,
+)
+from charmhelpers.core.strutils import (
+    bool_from_string,
+)
+
+DC_RESOURCE_NAME = 'DC'
+
+
+class HAIncompleteConfig(Exception):
+    pass
+
+
+class HAIncorrectConfig(Exception):
+    pass
+
+
+class CRMResourceNotFound(Exception):
+    pass
+
+
+class CRMDCNotFound(Exception):
+    pass
+
+
+def is_elected_leader(resource):
+    """
+    Returns True if the charm executing this is the elected cluster leader.
+
+    It relies on two mechanisms to determine leadership:
+        1. If juju is sufficiently new and leadership election is supported,
+        the is_leader command will be used.
+        2. If the charm is part of a corosync cluster, call corosync to
+        determine leadership.
+        3. If the charm is not part of a corosync cluster, the leader is
+        determined as being "the alive unit with the lowest unit numer". In
+        other words, the oldest surviving unit.
+    """
+    try:
+        return juju_is_leader()
+    except NotImplementedError:
+        log('Juju leadership election feature not enabled'
+            ', using fallback support',
+            level=WARNING)
+
+    if is_clustered():
+        if not is_crm_leader(resource):
+            log('Deferring action to CRM leader.', level=INFO)
+            return False
+    else:
+        peers = peer_units()
+        if peers and not oldest_peer(peers):
+            log('Deferring action to oldest service unit.', level=INFO)
+            return False
+    return True
+
+
+def is_clustered():
+    for r_id in (relation_ids('ha') or []):
+        for unit in (relation_list(r_id) or []):
+            clustered = relation_get('clustered',
+                                     rid=r_id,
+                                     unit=unit)
+            if clustered:
+                return True
+    return False
+
+
+def is_crm_dc():
+    """
+    Determine leadership by querying the pacemaker Designated Controller
+    """
+    cmd = ['crm', 'status']
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError as ex:
+        raise CRMDCNotFound(str(ex))
+
+    current_dc = ''
+    for line in status.split('\n'):
+        if line.startswith('Current DC'):
+            # Current DC: juju-lytrusty-machine-2 (168108163) - partition with quorum
+            current_dc = line.split(':')[1].split()[0]
+    if current_dc == get_unit_hostname():
+        return True
+    elif current_dc == 'NONE':
+        raise CRMDCNotFound('Current DC: NONE')
+
+    return False
+
+
+@retry_on_exception(5, base_delay=2,
+                    exc_type=(CRMResourceNotFound, CRMDCNotFound))
+def is_crm_leader(resource, retry=False):
+    """
+    Returns True if the charm calling this is the elected corosync leader,
+    as returned by calling the external "crm" command.
+
+    We allow this operation to be retried to avoid the possibility of getting a
+    false negative. See LP #1396246 for more info.
+    """
+    if resource == DC_RESOURCE_NAME:
+        return is_crm_dc()
+    cmd = ['crm', 'resource', 'show', resource]
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError:
+        status = None
+
+    if status and get_unit_hostname() in status:
+        return True
+
+    if status and "resource %s is NOT running" % (resource) in status:
+        raise CRMResourceNotFound("CRM resource %s not found" % (resource))
+
+    return False
+
+
+def is_leader(resource):
+    log("is_leader is deprecated. Please consider using is_crm_leader "
+        "instead.", level=WARNING)
+    return is_crm_leader(resource)
+
+
+def peer_units(peer_relation="cluster"):
+    peers = []
+    for r_id in (relation_ids(peer_relation) or []):
+        for unit in (relation_list(r_id) or []):
+            peers.append(unit)
+    return peers
+
+
+def peer_ips(peer_relation='cluster', addr_key='private-address'):
+    '''Return a dict of peers and their private-address'''
+    peers = {}
+    for r_id in relation_ids(peer_relation):
+        for unit in relation_list(r_id):
+            peers[unit] = relation_get(addr_key, rid=r_id, unit=unit)
+    return peers
+
+
+def oldest_peer(peers):
+    """Determines who the oldest peer is by comparing unit numbers."""
+    local_unit_no = int(os.getenv('JUJU_UNIT_NAME').split('/')[1])
+    for peer in peers:
+        remote_unit_no = int(peer.split('/')[1])
+        if remote_unit_no < local_unit_no:
+            return False
+    return True
+
+
+def eligible_leader(resource):
+    log("eligible_leader is deprecated. Please consider using "
+        "is_elected_leader instead.", level=WARNING)
+    return is_elected_leader(resource)
+
+
+def https():
+    '''
+    Determines whether enough data has been provided in configuration
+    or relation data to configure HTTPS
+    .
+    returns: boolean
+    '''
+    use_https = config_get('use-https')
+    if use_https and bool_from_string(use_https):
+        return True
+    if config_get('ssl_cert') and config_get('ssl_key'):
+        return True
+    for r_id in relation_ids('certificates'):
+        for unit in relation_list(r_id):
+            ca = relation_get('ca', rid=r_id, unit=unit)
+            if ca:
+                return True
+    for r_id in relation_ids('identity-service'):
+        for unit in relation_list(r_id):
+            # TODO - needs fixing for new helper as ssl_cert/key suffixes with CN
+            rel_state = [
+                relation_get('https_keystone', rid=r_id, unit=unit),
+                relation_get('ca_cert', rid=r_id, unit=unit),
+            ]
+            # NOTE: works around (LP: #1203241)
+            if (None not in rel_state) and ('' not in rel_state):
+                return True
+    return False
+
+
+def determine_api_port(public_port, singlenode_mode=False):
+    '''
+    Determine correct API server listening port based on
+    existence of HTTPS reverse proxy and/or haproxy.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the API service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    if https():
+        i += 1
+    return public_port - (i * 10)
+
+
+def determine_apache_port(public_port, singlenode_mode=False):
+    '''
+    Description: Determine correct apache listening port based on public IP +
+    state of the cluster.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the HAProxy service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    return public_port - (i * 10)
+
+
+determine_apache_port_single = functools.partial(
+    determine_apache_port, singlenode_mode=True)
+
+
+def get_hacluster_config(exclude_keys=None):
+    '''
+    Obtains all relevant configuration from charm configuration required
+    for initiating a relation to hacluster:
+
+        ha-bindiface, ha-mcastport, vip, os-internal-hostname,
+        os-admin-hostname, os-public-hostname, os-access-hostname
+
+    param: exclude_keys: list of setting key(s) to be excluded.
+    returns: dict: A dict containing settings keyed by setting name.
+    raises: HAIncompleteConfig if settings are missing or incorrect.
+    '''
+    settings = ['ha-bindiface', 'ha-mcastport', 'vip', 'os-internal-hostname',
+                'os-admin-hostname', 'os-public-hostname', 'os-access-hostname']
+    conf = {}
+    for setting in settings:
+        if exclude_keys and setting in exclude_keys:
+            continue
+
+        conf[setting] = config_get(setting)
+
+    if not valid_hacluster_config():
+        raise HAIncorrectConfig('Insufficient or incorrect config data to '
+                                'configure hacluster.')
+    return conf
+
+
+def valid_hacluster_config():
+    '''
+    Check that either vip or dns-ha is set. If dns-ha then one of os-*-hostname
+    must be set.
+
+    Note: ha-bindiface and ha-macastport both have defaults and will always
+    be set. We only care that either vip or dns-ha is set.
+
+    :returns: boolean: valid config returns true.
+    raises: HAIncompatibileConfig if settings conflict.
+    raises: HAIncompleteConfig if settings are missing.
+    '''
+    vip = config_get('vip')
+    dns = config_get('dns-ha')
+    if not(bool(vip) ^ bool(dns)):
+        msg = ('HA: Either vip or dns-ha must be set but not both in order to '
+               'use high availability')
+        status_set('blocked', msg)
+        raise HAIncorrectConfig(msg)
+
+    # If dns-ha then one of os-*-hostname must be set
+    if dns:
+        dns_settings = ['os-internal-hostname', 'os-admin-hostname',
+                        'os-public-hostname', 'os-access-hostname']
+        # At this point it is unknown if one or all of the possible
+        # network spaces are in HA. Validate at least one is set which is
+        # the minimum required.
+        for setting in dns_settings:
+            if config_get(setting):
+                log('DNS HA: At least one hostname is set {}: {}'
+                    ''.format(setting, config_get(setting)),
+                    level=DEBUG)
+                return True
+
+        msg = ('DNS HA: At least one os-*-hostname(s) must be set to use '
+               'DNS HA')
+        status_set('blocked', msg)
+        raise HAIncompleteConfig(msg)
+
+    log('VIP HA: VIP is set {}'.format(vip), level=DEBUG)
+    return True
+
+
+def canonical_url(configs, vip_setting='vip'):
+    '''
+    Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration and hacluster.
+
+    :configs    : OSTemplateRenderer: A config tempating object to inspect for
+                                      a complete https context.
+
+    :vip_setting:                str: Setting in charm config that specifies
+                                      VIP address.
+    '''
+    scheme = 'http'
+    if 'https' in configs.complete_contexts():
+        scheme = 'https'
+    if is_clustered():
+        addr = config_get(vip_setting)
+    else:
+        addr = unit_get('private-address')
+    return '%s://%s' % (scheme, addr)
+
+
+def distributed_wait(modulo=None, wait=None, operation_name='operation'):
+    ''' Distribute operations by waiting based on modulo_distribution
+
+    If modulo and or wait are not set, check config_get for those values.
+    If config values are not set, default to modulo=3 and wait=30.
+
+    :param modulo: int The modulo number creates the group distribution
+    :param wait: int The constant time wait value
+    :param operation_name: string Operation name for status message
+                           i.e.  'restart'
+    :side effect: Calls config_get()
+    :side effect: Calls log()
+    :side effect: Calls status_set()
+    :side effect: Calls time.sleep()
+    '''
+    if modulo is None:
+        modulo = config_get('modulo-nodes') or 3
+    if wait is None:
+        wait = config_get('known-wait') or 30
+    if juju_is_leader():
+        # The leader should never wait
+        calculated_wait = 0
+    else:
+        # non_zero_wait=True guarantees the non-leader who gets modulo 0
+        # will still wait
+        calculated_wait = modulo_distribution(modulo=modulo, wait=wait,
+                                              non_zero_wait=True)
+    msg = "Waiting {} seconds for {} ...".format(calculated_wait,
+                                                 operation_name)
+    log(msg, DEBUG)
+    status_set('maintenance', msg)
+    time.sleep(calculated_wait)
+
+
+def get_managed_services_and_ports(services, external_ports,
+                                   external_services=None,
+                                   port_conv_f=determine_apache_port_single):
+    """Get the services and ports managed by this charm.
+
+    Return only the services and corresponding ports that are managed by this
+    charm. This excludes haproxy when there is a relation with hacluster. This
+    is because this charm passes responsability for stopping and starting
+    haproxy to hacluster.
+
+    Similarly, if a relation with hacluster exists then the ports returned by
+    this method correspond to those managed by the apache server rather than
+    haproxy.
+
+    :param services: List of services.
+    :type services: List[str]
+    :param external_ports: List of ports managed by external services.
+    :type external_ports: List[int]
+    :param external_services: List of services to be removed if ha relation is
+                              present.
+    :type external_services: List[str]
+    :param port_conv_f: Function to apply to ports to calculate the ports
+                        managed by services controlled by this charm.
+    :type port_convert_func: f()
+    :returns: A tuple containing a list of services first followed by a list of
+              ports.
+    :rtype: Tuple[List[str], List[int]]
+    """
+    if external_services is None:
+        external_services = ['haproxy']
+    if relation_ids('ha'):
+        for svc in external_services:
+            try:
+                services.remove(svc)
+            except ValueError:
+                pass
+        external_ports = [port_conv_f(p) for p in external_ports]
+    return services, external_ports
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/README.hardening.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/README.hardening.md
new file mode 100644
index 0000000000000000000000000000000000000000..91280c03e6d7b5d75b356cd94614fc821abc2644
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/README.hardening.md
@@ -0,0 +1,38 @@
+# Juju charm-helpers hardening library
+
+## Description
+
+This library provides multiple implementations of system and application
+hardening that conform to the standards of http://hardening.io/.
+
+Current implementations include:
+
+ * OS
+ * SSH
+ * MySQL
+ * Apache
+
+## Requirements
+
+* Juju Charms
+
+## Usage
+
+1. Synchronise this library into your charm and add the harden() decorator
+   (from contrib.hardening.harden) to any functions or methods you want to use
+   to trigger hardening of your application/system.
+
+2. Add a config option called 'harden' to your charm config.yaml and set it to
+   a space-delimited list of hardening modules you want to run e.g. "os ssh"
+
+3. Override any config defaults (contrib.hardening.defaults) by adding a file
+   called hardening.yaml to your charm root containing the name(s) of the
+   modules whose settings you want override at root level and then any settings
+   with overrides e.g.
+   
+   os:
+       general:
+            desktop_enable: True
+
+4. Now just run your charm as usual and hardening will be applied each time the
+   hook runs.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..30a3e94359e94011cd247de7ade76667346e7379
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3bc2ebd4760124e23c128868e098aceac610260f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.apache.checks import config
+
+
+def run_apache_checks():
+    log("Starting Apache hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("Apache hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..341da9eee10f73cbe3d7e7e5cf91b57b4d2a89b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/checks/config.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+import six
+import subprocess
+
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    NoReadWriteForOther,
+    TemplatedFile,
+    DeletedFile
+)
+from charmhelpers.contrib.hardening.audits.apache import DisabledModuleAudit
+from charmhelpers.contrib.hardening.apache import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get Apache hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'apache2'], stdout=subprocess.PIPE) != 0:
+        log("Apache server does not appear to be installed on this node - "
+            "skipping apache hardening", level=INFO)
+        return []
+
+    context = ApacheConfContext()
+    settings = utils.get_settings('apache')
+    audits = [
+        FilePermissionAudit(paths=os.path.join(
+                            settings['common']['apache_dir'], 'apache2.conf'),
+                            user='root', group='root', mode=0o0640),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'mods-available/alias.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'conf-enabled/99-hardening.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        DirectoryPermissionAudit(settings['common']['apache_dir'],
+                                 user='root',
+                                 group='root',
+                                 mode=0o0750),
+
+        DisabledModuleAudit(settings['hardening']['modules_to_disable']),
+
+        NoReadWriteForOther(settings['common']['apache_dir']),
+
+        DeletedFile(['/var/www/html/index.html'])
+    ]
+
+    return audits
+
+
+class ApacheConfContext(object):
+    """Defines the set of key/value pairs to set in a apache config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/apache/conf-enabled/hardening.conf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('apache')
+        ctxt = settings['hardening']
+
+        out = subprocess.check_output(['apache2', '-v'])
+        if six.PY3:
+            out = out.decode('utf-8')
+        ctxt['apache_version'] = re.search(r'.+version: Apache/(.+?)\s.+',
+                                           out).group(1)
+        ctxt['apache_icondir'] = '/usr/share/apache2/icons/'
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..22b68041d50ff753284bbb4b41a21e8f2bd8c18a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
@@ -0,0 +1,32 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+
+<Location / >
+  <LimitExcept {{ allowed_http_methods }} >
+    # http://httpd.apache.org/docs/2.4/upgrading.html
+    {% if apache_version > '2.2' -%}
+    Require all granted
+    {% else -%}
+    Order Allow,Deny
+    Deny from all
+    {% endif %}
+  </LimitExcept>
+</Location>
+
+<Directory />
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+<Directory /var/www/>
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+TraceEnable {{ traceenable }}
+ServerTokens {{ servertokens }}
+
+SSLHonorCipherOrder {{ honor_cipher_order }}
+SSLCipherSuite {{ cipher_suite }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf
new file mode 100644
index 0000000000000000000000000000000000000000..e46a58a30dadbb6ccffa02d82593c63a9cbf52df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf
@@ -0,0 +1,31 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+<IfModule alias_module>
+  #
+  # Aliases: Add here as many aliases as you need (with no limit). The format is
+  # Alias fakename realname
+  #
+  # Note that if you include a trailing / on fakename then the server will
+  # require it to be present in the URL.  So "/icons" isn't aliased in this
+  # example, only "/icons/".  If the fakename is slash-terminated, then the
+  # realname must also be slash terminated, and if the fakename omits the
+  # trailing slash, the realname must also omit it.
+  #
+  # We include the /icons/ alias for FancyIndexed directory listings.  If
+  # you do not use FancyIndexing, you may comment this out.
+  #
+  Alias /icons/ "{{ apache_icondir }}/"
+
+  <Directory "{{ apache_icondir }}">
+    Options -Indexes -MultiViews -FollowSymLinks
+    AllowOverride None
+{% if apache_version == '2.4' -%}
+    Require all granted
+{% else -%}
+    Order allow,deny
+    Allow from all
+{% endif %}
+  </Directory>
+</IfModule>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dd5b05fec4ffcfcdb4378a06dfda4e8ac7e8371
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/__init__.py
@@ -0,0 +1,54 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class BaseAudit(object):  # NO-QA
+    """Base class for hardening checks.
+
+    The lifecycle of a hardening check is to first check to see if the system
+    is in compliance for the specified check. If it is not in compliance, the
+    check method will return a value which will be supplied to the.
+    """
+    def __init__(self, *args, **kwargs):
+        self.unless = kwargs.get('unless', None)
+        super(BaseAudit, self).__init__()
+
+    def ensure_compliance(self):
+        """Checks to see if the current hardening check is in compliance or
+        not.
+
+        If the check that is performed is not in compliance, then an exception
+        should be raised.
+        """
+        pass
+
+    def _take_action(self):
+        """Determines whether to perform the action or not.
+
+        Checks whether or not an action should be taken. This is determined by
+        the truthy value for the unless parameter. If unless is a callback
+        method, it will be invoked with no parameters in order to determine
+        whether or not the action should be taken. Otherwise, the truthy value
+        of the unless attribute will determine if the action should be
+        performed.
+        """
+        # Do the action if there isn't an unless override.
+        if self.unless is None:
+            return True
+
+        # Invoke the callback if there is one.
+        if hasattr(self.unless, '__call__'):
+            return not self.unless()
+
+        return not self.unless
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..04825f5ada0c5b0bb9fc0955baa9a10fa199184d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apache.py
@@ -0,0 +1,100 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    ERROR,
+)
+
+from charmhelpers.contrib.hardening.audits import BaseAudit
+
+
+class DisabledModuleAudit(BaseAudit):
+    """Audits Apache2 modules.
+
+    Determines if the apache2 modules are enabled. If the modules are enabled
+    then they are removed in the ensure_compliance.
+    """
+    def __init__(self, modules):
+        if modules is None:
+            self.modules = []
+        elif isinstance(modules, six.string_types):
+            self.modules = [modules]
+        else:
+            self.modules = modules
+
+    def ensure_compliance(self):
+        """Ensures that the modules are not loaded."""
+        if not self.modules:
+            return
+
+        try:
+            loaded_modules = self._get_loaded_modules()
+            non_compliant_modules = []
+            for module in self.modules:
+                if module in loaded_modules:
+                    log("Module '%s' is enabled but should not be." %
+                        (module), level=INFO)
+                    non_compliant_modules.append(module)
+
+            if len(non_compliant_modules) == 0:
+                return
+
+            for module in non_compliant_modules:
+                self._disable_module(module)
+            self._restart_apache()
+        except subprocess.CalledProcessError as e:
+            log('Error occurred auditing apache module compliance. '
+                'This may have been already reported. '
+                'Output is: %s' % e.output, level=ERROR)
+
+    @staticmethod
+    def _get_loaded_modules():
+        """Returns the modules which are enabled in Apache."""
+        output = subprocess.check_output(['apache2ctl', '-M'])
+        if six.PY3:
+            output = output.decode('utf-8')
+        modules = []
+        for line in output.splitlines():
+            # Each line of the enabled module output looks like:
+            #  module_name (static|shared)
+            # Plus a header line at the top of the output which is stripped
+            # out by the regex.
+            matcher = re.search(r'^ (\S*)_module (\S*)', line)
+            if matcher:
+                modules.append(matcher.group(1))
+        return modules
+
+    @staticmethod
+    def _disable_module(module):
+        """Disables the specified module in Apache."""
+        try:
+            subprocess.check_call(['a2dismod', module])
+        except subprocess.CalledProcessError as e:
+            # Note: catch error here to allow the attempt of disabling
+            # multiple modules in one go rather than failing after the
+            # first module fails.
+            log('Error occurred disabling module %s. '
+                'Output is: %s' % (module, e.output), level=ERROR)
+
+    @staticmethod
+    def _restart_apache():
+        """Restarts the apache process"""
+        subprocess.check_output(['service', 'apache2', 'restart'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..cad7bf7376d6f22ce8feccd843b070c399887aa9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/apt.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import  # required for external apt import
+from six import string_types
+
+from charmhelpers.fetch import (
+    apt_cache,
+    apt_purge
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.fetch import ubuntu_apt_pkg as apt_pkg
+
+
+class AptConfig(BaseAudit):
+
+    def __init__(self, config, **kwargs):
+        self.config = config
+
+    def verify_config(self):
+        apt_pkg.init()
+        for cfg in self.config:
+            value = apt_pkg.config.get(cfg['key'], cfg.get('default', ''))
+            if value and value != cfg['expected']:
+                log("APT config '%s' has unexpected value '%s' "
+                    "(expected='%s')" %
+                    (cfg['key'], value, cfg['expected']), level=WARNING)
+
+    def ensure_compliance(self):
+        self.verify_config()
+
+
+class RestrictedPackages(BaseAudit):
+    """Class used to audit restricted packages on the system."""
+
+    def __init__(self, pkgs, **kwargs):
+        super(RestrictedPackages, self).__init__(**kwargs)
+        if isinstance(pkgs, string_types) or not hasattr(pkgs, '__iter__'):
+            self.pkgs = pkgs.split()
+        else:
+            self.pkgs = pkgs
+
+    def ensure_compliance(self):
+        cache = apt_cache()
+
+        for p in self.pkgs:
+            if p not in cache:
+                continue
+
+            pkg = cache[p]
+            if not self.is_virtual_package(pkg):
+                if not pkg.current_ver:
+                    log("Package '%s' is not installed." % pkg.name,
+                        level=DEBUG)
+                    continue
+                else:
+                    log("Restricted package '%s' is installed" % pkg.name,
+                        level=WARNING)
+                    self.delete_package(cache, pkg)
+            else:
+                log("Checking restricted virtual package '%s' provides" %
+                    pkg.name, level=DEBUG)
+                self.delete_package(cache, pkg)
+
+    def delete_package(self, cache, pkg):
+        """Deletes the package from the system.
+
+        Deletes the package form the system, properly handling virtual
+        packages.
+
+        :param cache: the apt cache
+        :param pkg: the package to remove
+        """
+        if self.is_virtual_package(pkg):
+            log("Package '%s' appears to be virtual - purging provides" %
+                pkg.name, level=DEBUG)
+            for _p in pkg.provides_list:
+                self.delete_package(cache, _p[2].parent_pkg)
+        elif not pkg.current_ver:
+            log("Package '%s' not installed" % pkg.name, level=DEBUG)
+            return
+        else:
+            log("Purging package '%s'" % pkg.name, level=DEBUG)
+            apt_purge(pkg.name)
+
+    def is_virtual_package(self, pkg):
+        return (pkg.get('has_provides', False) and
+                not pkg.get('has_versions', False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/file.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..257c6351a0b0d244273013faef913f52349f2486
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/audits/file.py
@@ -0,0 +1,550 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import grp
+import os
+import pwd
+import re
+
+from subprocess import (
+    CalledProcessError,
+    check_output,
+    check_call,
+)
+from traceback import format_exc
+from six import string_types
+from stat import (
+    S_ISGID,
+    S_ISUID
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core import unitdata
+from charmhelpers.core.host import file_hash
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.contrib.hardening.templating import (
+    get_template_path,
+    render_and_write,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+class BaseFileAudit(BaseAudit):
+    """Base class for file audits.
+
+    Provides api stubs for compliance check flow that must be used by any class
+    that implemented this one.
+    """
+
+    def __init__(self, paths, always_comply=False, *args, **kwargs):
+        """
+        :param paths: string path of list of paths of files we want to apply
+                      compliance checks are criteria to.
+        :param always_comply: if true compliance criteria is always applied
+                              else compliance is skipped for non-existent
+                              paths.
+        """
+        super(BaseFileAudit, self).__init__(*args, **kwargs)
+        self.always_comply = always_comply
+        if isinstance(paths, string_types) or not hasattr(paths, '__iter__'):
+            self.paths = [paths]
+        else:
+            self.paths = paths
+
+    def ensure_compliance(self):
+        """Ensure that the all registered files comply to registered criteria.
+        """
+        for p in self.paths:
+            if os.path.exists(p):
+                if self.is_compliant(p):
+                    continue
+
+                log('File %s is not in compliance.' % p, level=INFO)
+            else:
+                if not self.always_comply:
+                    log("Non-existent path '%s' - skipping compliance check"
+                        % (p), level=INFO)
+                    continue
+
+            if self._take_action():
+                log("Applying compliance criteria to '%s'" % (p), level=INFO)
+                self.comply(p)
+
+    def is_compliant(self, path):
+        """Audits the path to see if it is compliance.
+
+        :param path: the path to the file that should be checked.
+        """
+        raise NotImplementedError
+
+    def comply(self, path):
+        """Enforces the compliance of a path.
+
+        :param path: the path to the file that should be enforced.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def _get_stat(cls, path):
+        """Returns the Posix st_stat information for the specified file path.
+
+        :param path: the path to get the st_stat information for.
+        :returns: an st_stat object for the path or None if the path doesn't
+                  exist.
+        """
+        return os.stat(path)
+
+
+class FilePermissionAudit(BaseFileAudit):
+    """Implements an audit for file permissions and ownership for a user.
+
+    This class implements functionality that ensures that a specific user/group
+    will own the file(s) specified and that the permissions specified are
+    applied properly to the file.
+    """
+    def __init__(self, paths, user, group=None, mode=0o600, **kwargs):
+        self.user = user
+        self.group = group
+        self.mode = mode
+        super(FilePermissionAudit, self).__init__(paths, user, group, mode,
+                                                  **kwargs)
+
+    @property
+    def user(self):
+        return self._user
+
+    @user.setter
+    def user(self, name):
+        try:
+            user = pwd.getpwnam(name)
+        except KeyError:
+            log('Unknown user %s' % name, level=ERROR)
+            user = None
+        self._user = user
+
+    @property
+    def group(self):
+        return self._group
+
+    @group.setter
+    def group(self, name):
+        try:
+            group = None
+            if name:
+                group = grp.getgrnam(name)
+            else:
+                group = grp.getgrgid(self.user.pw_gid)
+        except KeyError:
+            log('Unknown group %s' % name, level=ERROR)
+        self._group = group
+
+    def is_compliant(self, path):
+        """Checks if the path is in compliance.
+
+        Used to determine if the path specified meets the necessary
+        requirements to be in compliance with the check itself.
+
+        :param path: the file path to check
+        :returns: True if the path is compliant, False otherwise.
+        """
+        stat = self._get_stat(path)
+        user = self.user
+        group = self.group
+
+        compliant = True
+        if stat.st_uid != user.pw_uid or stat.st_gid != group.gr_gid:
+            log('File %s is not owned by %s:%s.' % (path, user.pw_name,
+                                                    group.gr_name),
+                level=INFO)
+            compliant = False
+
+        # POSIX refers to the st_mode bits as corresponding to both the
+        # file type and file permission bits, where the least significant 12
+        # bits (o7777) are the suid (11), sgid (10), sticky bits (9), and the
+        # file permission bits (8-0)
+        perms = stat.st_mode & 0o7777
+        if perms != self.mode:
+            log('File %s has incorrect permissions, currently set to %s' %
+                (path, oct(stat.st_mode & 0o7777)), level=INFO)
+            compliant = False
+
+        return compliant
+
+    def comply(self, path):
+        """Issues a chown and chmod to the file paths specified."""
+        utils.ensure_permissions(path, self.user.pw_name, self.group.gr_name,
+                                 self.mode)
+
+
+class DirectoryPermissionAudit(FilePermissionAudit):
+    """Performs a permission check for the  specified directory path."""
+
+    def __init__(self, paths, user, group=None, mode=0o600,
+                 recursive=True, **kwargs):
+        super(DirectoryPermissionAudit, self).__init__(paths, user, group,
+                                                       mode, **kwargs)
+        self.recursive = recursive
+
+    def is_compliant(self, path):
+        """Checks if the directory is compliant.
+
+        Used to determine if the path specified and all of its children
+        directories are in compliance with the check itself.
+
+        :param path: the directory path to check
+        :returns: True if the directory tree is compliant, otherwise False.
+        """
+        if not os.path.isdir(path):
+            log('Path specified %s is not a directory.' % path, level=ERROR)
+            raise ValueError("%s is not a directory." % path)
+
+        if not self.recursive:
+            return super(DirectoryPermissionAudit, self).is_compliant(path)
+
+        compliant = True
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                continue
+
+            if not super(DirectoryPermissionAudit, self).is_compliant(root):
+                compliant = False
+                continue
+
+        return compliant
+
+    def comply(self, path):
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                super(DirectoryPermissionAudit, self).comply(root)
+
+
+class ReadOnly(BaseFileAudit):
+    """Audits that files and folders are read only."""
+    def __init__(self, paths, *args, **kwargs):
+        super(ReadOnly, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        try:
+            output = check_output(['find', path, '-perm', '-go+w',
+                                   '-type', 'f']).strip()
+
+            # The find above will find any files which have permission sets
+            # which allow too broad of write access. As such, the path is
+            # compliant if there is no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred checking finding writable files for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+            return False
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', 'go-w', '-R', path])
+        except CalledProcessError as e:
+            log('Error occurred removing writeable permissions for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class NoReadWriteForOther(BaseFileAudit):
+    """Ensures that the files found under the base path are readable or
+    writable by anyone other than the owner or the group.
+    """
+    def __init__(self, paths):
+        super(NoReadWriteForOther, self).__init__(paths)
+
+    def is_compliant(self, path):
+        try:
+            cmd = ['find', path, '-perm', '-o+r', '-type', 'f', '-o',
+                   '-perm', '-o+w', '-type', 'f']
+            output = check_output(cmd).strip()
+
+            # The find above here will find any files which have read or
+            # write permissions for other, meaning there is too broad of access
+            # to read/write the file. As such, the path is compliant if there's
+            # no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred while finding files which are readable or '
+                'writable to the world in %s. '
+                'Command output is: %s.' % (path, e.output), level=ERROR)
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', '-R', 'o-rw', path])
+        except CalledProcessError as e:
+            log('Error occurred attempting to change modes of files under '
+                'path %s. Output of command is: %s' % (path, e.output))
+
+
+class NoSUIDSGIDAudit(BaseFileAudit):
+    """Audits that specified files do not have SUID/SGID bits set."""
+    def __init__(self, paths, *args, **kwargs):
+        super(NoSUIDSGIDAudit, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        stat = self._get_stat(path)
+        if (stat.st_mode & (S_ISGID | S_ISUID)) != 0:
+            return False
+
+        return True
+
+    def comply(self, path):
+        try:
+            log('Removing suid/sgid from %s.' % path, level=DEBUG)
+            check_output(['chmod', '-s', path])
+        except CalledProcessError as e:
+            log('Error occurred removing suid/sgid from %s.'
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class TemplatedFile(BaseFileAudit):
+    """The TemplatedFileAudit audits the contents of a templated file.
+
+    This audit renders a file from a template, sets the appropriate file
+    permissions, then generates a hashsum with which to check the content
+    changed.
+    """
+    def __init__(self, path, context, template_dir, mode, user='root',
+                 group='root', service_actions=None, **kwargs):
+        self.context = context
+        self.user = user
+        self.group = group
+        self.mode = mode
+        self.template_dir = template_dir
+        self.service_actions = service_actions
+        super(TemplatedFile, self).__init__(paths=path, always_comply=True,
+                                            **kwargs)
+
+    def is_compliant(self, path):
+        """Determines if the templated file is compliant.
+
+        A templated file is only compliant if it has not changed (as
+        determined by its sha256 hashsum) AND its file permissions are set
+        appropriately.
+
+        :param path: the path to check compliance.
+        """
+        same_templates = self.templates_match(path)
+        same_content = self.contents_match(path)
+        same_permissions = self.permissions_match(path)
+
+        if same_content and same_permissions and same_templates:
+            return True
+
+        return False
+
+    def run_service_actions(self):
+        """Run any actions on services requested."""
+        if not self.service_actions:
+            return
+
+        for svc_action in self.service_actions:
+            name = svc_action['service']
+            actions = svc_action['actions']
+            log("Running service '%s' actions '%s'" % (name, actions),
+                level=DEBUG)
+            for action in actions:
+                cmd = ['service', name, action]
+                try:
+                    check_call(cmd)
+                except CalledProcessError as exc:
+                    log("Service name='%s' action='%s' failed - %s" %
+                        (name, action, exc), level=WARNING)
+
+    def comply(self, path):
+        """Ensures the contents and the permissions of the file.
+
+        :param path: the path to correct
+        """
+        dirname = os.path.dirname(path)
+        if not os.path.exists(dirname):
+            os.makedirs(dirname)
+
+        self.pre_write()
+        render_and_write(self.template_dir, path, self.context())
+        utils.ensure_permissions(path, self.user, self.group, self.mode)
+        self.run_service_actions()
+        self.save_checksum(path)
+        self.post_write()
+
+    def pre_write(self):
+        """Invoked prior to writing the template."""
+        pass
+
+    def post_write(self):
+        """Invoked after writing the template."""
+        pass
+
+    def templates_match(self, path):
+        """Determines if the template files are the same.
+
+        The template file equality is determined by the hashsum of the
+        template files themselves. If there is no hashsum, then the content
+        cannot be sure to be the same so treat it as if they changed.
+        Otherwise, return whether or not the hashsums are the same.
+
+        :param path: the path to check
+        :returns: boolean
+        """
+        template_path = get_template_path(self.template_dir, path)
+        key = 'hardening:template:%s' % template_path
+        template_checksum = file_hash(template_path)
+        kv = unitdata.kv()
+        stored_tmplt_checksum = kv.get(key)
+        if not stored_tmplt_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Saved template checksum for %s.' % template_path,
+                level=DEBUG)
+            # Since we don't have a template checksum, then assume it doesn't
+            # match and return that the template is different.
+            return False
+        elif stored_tmplt_checksum != template_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Updated template checksum for %s.' % template_path,
+                level=DEBUG)
+            return False
+
+        # Here the template hasn't changed based upon the calculated
+        # checksum of the template and what was previously stored.
+        return True
+
+    def contents_match(self, path):
+        """Determines if the file content is the same.
+
+        This is determined by comparing hashsum of the file contents and
+        the saved hashsum. If there is no hashsum, then the content cannot
+        be sure to be the same so treat them as if they are not the same.
+        Otherwise, return True if the hashsums are the same, False if they
+        are not the same.
+
+        :param path: the file to check.
+        """
+        checksum = file_hash(path)
+
+        kv = unitdata.kv()
+        stored_checksum = kv.get('hardening:%s' % path)
+        if not stored_checksum:
+            # If the checksum hasn't been generated, return False to ensure
+            # the file is written and the checksum stored.
+            log('Checksum for %s has not been calculated.' % path, level=DEBUG)
+            return False
+        elif stored_checksum != checksum:
+            log('Checksum mismatch for %s.' % path, level=DEBUG)
+            return False
+
+        return True
+
+    def permissions_match(self, path):
+        """Determines if the file owner and permissions match.
+
+        :param path: the path to check.
+        """
+        audit = FilePermissionAudit(path, self.user, self.group, self.mode)
+        return audit.is_compliant(path)
+
+    def save_checksum(self, path):
+        """Calculates and saves the checksum for the path specified.
+
+        :param path: the path of the file to save the checksum.
+        """
+        checksum = file_hash(path)
+        kv = unitdata.kv()
+        kv.set('hardening:%s' % path, checksum)
+        kv.flush()
+
+
+class DeletedFile(BaseFileAudit):
+    """Audit to ensure that a file is deleted."""
+    def __init__(self, paths):
+        super(DeletedFile, self).__init__(paths)
+
+    def is_compliant(self, path):
+        return not os.path.exists(path)
+
+    def comply(self, path):
+        os.remove(path)
+
+
+class FileContentAudit(BaseFileAudit):
+    """Audit the contents of a file."""
+    def __init__(self, paths, cases, **kwargs):
+        # Cases we expect to pass
+        self.pass_cases = cases.get('pass', [])
+        # Cases we expect to fail
+        self.fail_cases = cases.get('fail', [])
+        super(FileContentAudit, self).__init__(paths, **kwargs)
+
+    def is_compliant(self, path):
+        """
+        Given a set of content matching cases i.e. tuple(regex, bool) where
+        bool value denotes whether or not regex is expected to match, check that
+        all cases match as expected with the contents of the file. Cases can be
+        expected to pass of fail.
+
+        :param path: Path of file to check.
+        :returns: Boolean value representing whether or not all cases are
+                  found to be compliant.
+        """
+        log("Auditing contents of file '%s'" % (path), level=DEBUG)
+        with open(path, 'r') as fd:
+            contents = fd.read()
+
+        matches = 0
+        for pattern in self.pass_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to pass but instead it failed"
+                    % (pattern), level=WARNING)
+
+        for pattern in self.fail_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if not results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to fail but instead it passed"
+                    % (pattern), level=WARNING)
+
+        total = len(self.pass_cases) + len(self.fail_cases)
+        log("Checked %s cases and %s passed" % (total, matches), level=DEBUG)
+        return matches == total
+
+    def comply(self, *args, **kwargs):
+        """NOOP since we just issue warnings. This is to avoid the
+        NotImplememtedError.
+        """
+        log("Not applying any compliance criteria, only checks.", level=INFO)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0f940d4cfa85ca7051dd60a4805d84bb6aebed6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml
@@ -0,0 +1,16 @@
+# NOTE: this file contains the default configuration for the 'apache' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'apache' as the root key followed by any of the following with new
+#       values.
+
+common:
+    apache_dir: '/etc/apache2'
+
+hardening:
+    traceenable: 'off'
+    allowed_http_methods: "GET POST"
+    modules_to_disable: [ cgi, cgid ]
+    servertokens: 'Prod'
+    honor_cipher_order: 'on'
+    cipher_suite: 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..c112137cb45c4b63cb05384145b3edf8c443e2b8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
@@ -0,0 +1,12 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    apache_dir:
+    traceenable:
+
+hardening:
+    allowed_http_methods:
+    modules_to_disable:
+    servertokens:
+    honor_cipher_order:
+    cipher_suite:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..682d22bf3ded32eb1c8d6188486ec4468d9ec457
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml
@@ -0,0 +1,38 @@
+# NOTE: this file contains the default configuration for the 'mysql' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'mysql' as the root key followed by any of the following with new
+#       values.
+
+hardening:
+    mysql-conf: /etc/mysql/my.cnf
+    hardening-conf: /etc/mysql/conf.d/hardening.cnf
+
+security:
+    # @see http://www.symantec.com/connect/articles/securing-mysql-step-step
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_chroot
+    chroot: None
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_safe-user-create
+    safe-user-create: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-auth
+    secure-auth: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_symbolic-links
+    skip-symbolic-links: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_skip-show-database
+    skip-show-database: True
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_local_infile
+    local-infile: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_allow-suspicious-udfs
+    allow-suspicious-udfs: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_automatic_sp_privileges
+    automatic-sp-privileges: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-file-priv
+    secure-file-priv: /tmp
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..2edf325c311c6fbb062a072083b4d12cebc3d9c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
@@ -0,0 +1,15 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+hardening:
+    mysql-conf:
+    hardening-conf:
+security:
+    chroot:
+    safe-user-create:
+    secure-auth:
+    skip-symbolic-links:
+    skip-show-database:
+    local-infile:
+    allow-suspicious-udfs:
+    automatic-sp-privileges:
+    secure-file-priv:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9a8627b5ed2803828e1e4d78260c6b5f90cae659
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml
@@ -0,0 +1,68 @@
+# NOTE: this file contains the default configuration for the 'os' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'os' as the root key followed by any of the following with new
+#       values.
+
+general:
+    desktop_enable: False  # (type:boolean)
+
+environment:
+    extra_user_paths: []
+    umask: 027
+    root_path: /
+
+auth:
+    pw_max_age: 60
+    # discourage password cycling
+    pw_min_age: 7
+    retries: 5
+    lockout_time: 600
+    timeout: 60
+    allow_homeless: False  # (type:boolean)
+    pam_passwdqc_enable: True  # (type:boolean)
+    pam_passwdqc_options: 'min=disabled,disabled,16,12,8'
+    root_ttys:
+        console
+        tty1
+        tty2
+        tty3
+        tty4
+        tty5
+        tty6
+    uid_min: 1000
+    gid_min: 1000
+    sys_uid_min: 100
+    sys_uid_max: 999
+    sys_gid_min: 100
+    sys_gid_max: 999
+    chfn_restrict:
+
+security:
+    users_allow: []
+    suid_sgid_enforce: True  # (type:boolean)
+    # user-defined blacklist and whitelist
+    suid_sgid_blacklist: []
+    suid_sgid_whitelist: []
+    # if this is True, remove any suid/sgid bits from files that were not in the whitelist
+    suid_sgid_dry_run_on_unknown: False  # (type:boolean)
+    suid_sgid_remove_from_unknown: False  # (type:boolean)
+    # remove packages with known issues
+    packages_clean: True  # (type:boolean)
+    packages_list:
+        xinetd
+        inetd
+        ypserv
+        telnet-server
+        rsh-server
+        rsync
+    kernel_enable_module_loading: True  # (type:boolean)
+    kernel_enable_core_dump: False  # (type:boolean)
+    ssh_tmout: 300
+
+sysctl:
+    kernel_secure_sysrq: 244  # 4 + 16 + 32 + 64 + 128
+    kernel_enable_sysrq: False  # (type:boolean)
+    forwarding: False  # (type:boolean)
+    ipv6_enable: False  # (type:boolean)
+    arp_restricted: True  # (type:boolean)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..cc3b9c206eae56cbe68826cb76748e2deb9483e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema
@@ -0,0 +1,43 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+general:
+    desktop_enable:
+environment:
+    extra_user_paths:
+    umask:
+    root_path:
+auth:
+    pw_max_age:
+    pw_min_age:
+    retries:
+    lockout_time:
+    timeout:
+    allow_homeless:
+    pam_passwdqc_enable:
+    pam_passwdqc_options:
+    root_ttys:
+    uid_min:
+    gid_min:
+    sys_uid_min:
+    sys_uid_max:
+    sys_gid_min:
+    sys_gid_max:
+    chfn_restrict:
+security:
+    users_allow:
+    suid_sgid_enforce:
+    suid_sgid_blacklist:
+    suid_sgid_whitelist:
+    suid_sgid_dry_run_on_unknown:
+    suid_sgid_remove_from_unknown:
+    packages_clean:
+    packages_list:
+    kernel_enable_module_loading:
+    kernel_enable_core_dump:
+    ssh_tmout:
+sysctl:
+    kernel_secure_sysrq:
+    kernel_enable_sysrq:
+    forwarding:
+    ipv6_enable:
+    arp_restricted:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cd529bcae1ec00fef2e969f43dc3cf530b46ef9a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml
@@ -0,0 +1,49 @@
+# NOTE: this file contains the default configuration for the 'ssh' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'ssh' as the root key followed by any of the following with new
+#       values.
+
+common:
+    service_name: 'ssh'
+    network_ipv6_enable: False  # (type:boolean)
+    ports: [22]
+    remote_hosts: []
+
+client:
+    package: 'openssh-client'
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    roaming: False
+    password_authentication: 'no'
+
+server:
+    host_key_files: ['/etc/ssh/ssh_host_rsa_key', '/etc/ssh/ssh_host_dsa_key',
+                     '/etc/ssh/ssh_host_ecdsa_key']
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    allow_root_with_key: False  # (type:boolean)
+    allow_tcp_forwarding: 'no'
+    allow_agent_forwarding: 'no'
+    allow_x11_forwarding: 'no'
+    use_privilege_separation: 'sandbox'
+    listen_to: ['0.0.0.0']
+    use_pam: 'no'
+    package: 'openssh-server'
+    password_authentication: 'no'
+    alive_interval: '600'
+    alive_count: '3'
+    sftp_enable: False  # (type:boolean)
+    sftp_group: 'sftponly'
+    sftp_chroot: '/home/%u'
+    deny_users: []
+    allow_users: []
+    deny_groups: []
+    allow_groups: []
+    print_motd: 'no'
+    print_last_log: 'no'
+    use_dns: 'no'
+    max_auth_tries: 2
+    max_sessions: 10
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..d05e054bc234015206bb1195152fa9ffd6a33151
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
@@ -0,0 +1,42 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    service_name:
+    network_ipv6_enable:
+    ports:
+    remote_hosts:
+client:
+    package:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    roaming:
+    password_authentication:
+server:
+    host_key_files:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    allow_root_with_key:
+    allow_tcp_forwarding:
+    allow_agent_forwarding:
+    allow_x11_forwarding:
+    use_privilege_separation:
+    listen_to:
+    use_pam:
+    package:
+    password_authentication:
+    alive_interval:
+    alive_count:
+    sftp_enable:
+    sftp_group:
+    sftp_chroot:
+    deny_users:
+    allow_users:
+    deny_groups:
+    allow_groups:
+    print_motd:
+    print_last_log:
+    use_dns:
+    max_auth_tries:
+    max_sessions:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/harden.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/harden.py
new file mode 100644
index 0000000000000000000000000000000000000000..63f21b9c9855065da3be875c01a2c94db7df47b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/harden.py
@@ -0,0 +1,96 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+
+from collections import OrderedDict
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.host.checks import run_os_checks
+from charmhelpers.contrib.hardening.ssh.checks import run_ssh_checks
+from charmhelpers.contrib.hardening.mysql.checks import run_mysql_checks
+from charmhelpers.contrib.hardening.apache.checks import run_apache_checks
+
+_DISABLE_HARDENING_FOR_UNIT_TEST = False
+
+
+def harden(overrides=None):
+    """Hardening decorator.
+
+    This is the main entry point for running the hardening stack. In order to
+    run modules of the stack you must add this decorator to charm hook(s) and
+    ensure that your charm config.yaml contains the 'harden' option set to
+    one or more of the supported modules. Setting these will cause the
+    corresponding hardening code to be run when the hook fires.
+
+    This decorator can and should be applied to more than one hook or function
+    such that hardening modules are called multiple times. This is because
+    subsequent calls will perform auditing checks that will report any changes
+    to resources hardened by the first run (and possibly perform compliance
+    actions as a result of any detected infractions).
+
+    :param overrides: Optional list of stack modules used to override those
+                      provided with 'harden' config.
+    :returns: Returns value returned by decorated function once executed.
+    """
+    if overrides is None:
+        overrides = []
+
+    def _harden_inner1(f):
+        # As this has to be py2.7 compat, we can't use nonlocal.  Use a trick
+        # to capture the dictionary that can then be updated.
+        _logged = {'done': False}
+
+        def _harden_inner2(*args, **kwargs):
+            # knock out hardening via a config var; normally it won't get
+            # disabled.
+            if _DISABLE_HARDENING_FOR_UNIT_TEST:
+                return f(*args, **kwargs)
+            if not _logged['done']:
+                log("Hardening function '%s'" % (f.__name__), level=DEBUG)
+                _logged['done'] = True
+            RUN_CATALOG = OrderedDict([('os', run_os_checks),
+                                       ('ssh', run_ssh_checks),
+                                       ('mysql', run_mysql_checks),
+                                       ('apache', run_apache_checks)])
+
+            enabled = overrides[:] or (config("harden") or "").split()
+            if enabled:
+                modules_to_run = []
+                # modules will always be performed in the following order
+                for module, func in six.iteritems(RUN_CATALOG):
+                    if module in enabled:
+                        enabled.remove(module)
+                        modules_to_run.append(func)
+
+                if enabled:
+                    log("Unknown hardening modules '%s' - ignoring" %
+                        (', '.join(enabled)), level=WARNING)
+
+                for hardener in modules_to_run:
+                    log("Executing hardening module '%s'" %
+                        (hardener.__name__), level=DEBUG)
+                    hardener()
+            else:
+                log("No hardening applied to '%s'" % (f.__name__), level=DEBUG)
+
+            return f(*args, **kwargs)
+        return _harden_inner2
+
+    return _harden_inner1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e7e409f3c7e0406b40353f48acfc3479e4c1a24
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/__init__.py
@@ -0,0 +1,48 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.host.checks import (
+    apt,
+    limits,
+    login,
+    minimize_access,
+    pam,
+    profile,
+    securetty,
+    suid_sgid,
+    sysctl
+)
+
+
+def run_os_checks():
+    log("Starting OS hardening checks.", level=DEBUG)
+    checks = apt.get_audits()
+    checks.extend(limits.get_audits())
+    checks.extend(login.get_audits())
+    checks.extend(minimize_access.get_audits())
+    checks.extend(pam.get_audits())
+    checks.extend(profile.get_audits())
+    checks.extend(securetty.get_audits())
+    checks.extend(suid_sgid.get_audits())
+    checks.extend(sysctl.get_audits())
+
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("OS hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ce41b0043134e256d9c20ee729f1c4345faa3f9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/apt.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.utils import get_settings
+from charmhelpers.contrib.hardening.audits.apt import (
+    AptConfig,
+    RestrictedPackages,
+)
+
+
+def get_audits():
+    """Get OS hardening apt audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [AptConfig([{'key': 'APT::Get::AllowUnauthenticated',
+                          'expected': 'false'}])]
+
+    settings = get_settings('os')
+    clean_packages = settings['security']['packages_clean']
+    if clean_packages:
+        security_packages = settings['security']['packages_list']
+        if security_packages:
+            audits.append(RestrictedPackages(security_packages))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/limits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/limits.py
new file mode 100644
index 0000000000000000000000000000000000000000..e94f5ebef360c7c80c35eba8243d3e7f7dcbb14d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/limits.py
@@ -0,0 +1,53 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening security limits audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Ensure that the /etc/security/limits.d directory is only writable
+    # by the root user, but others can execute and read.
+    audits.append(DirectoryPermissionAudit('/etc/security/limits.d',
+                                           user='root', group='root',
+                                           mode=0o755))
+
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/security/limits.d/10.hardcore.conf',
+                                    SecurityLimitsContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    user='root', group='root', mode=0o0440))
+    return audits
+
+
+class SecurityLimitsContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'disable_core_dump':
+                not settings['security']['kernel_enable_core_dump']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/login.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/login.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe2bc6ef34a0dae612c2617dc1d13390f651e419
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/login.py
@@ -0,0 +1,65 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from six import string_types
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening login.defs audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [TemplatedFile('/etc/login.defs', LoginContext(),
+                            template_dir=TEMPLATES_DIR,
+                            user='root', group='root', mode=0o0444)]
+    return audits
+
+
+class LoginContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+
+        # Octal numbers in yaml end up being turned into decimal,
+        # so check if the umask is entered as a string (e.g. '027')
+        # or as an octal umask as we know it (e.g. 002). If its not
+        # a string assume it to be octal and turn it into an octal
+        # string.
+        umask = settings['environment']['umask']
+        if not isinstance(umask, string_types):
+            umask = '%s' % oct(umask)
+
+        ctxt = {
+            'additional_user_paths':
+            settings['environment']['extra_user_paths'],
+            'umask': umask,
+            'pwd_max_age': settings['auth']['pw_max_age'],
+            'pwd_min_age': settings['auth']['pw_min_age'],
+            'uid_min': settings['auth']['uid_min'],
+            'sys_uid_min': settings['auth']['sys_uid_min'],
+            'sys_uid_max': settings['auth']['sys_uid_max'],
+            'gid_min': settings['auth']['gid_min'],
+            'sys_gid_min': settings['auth']['sys_gid_min'],
+            'sys_gid_max': settings['auth']['sys_gid_max'],
+            'login_retries': settings['auth']['retries'],
+            'login_timeout': settings['auth']['timeout'],
+            'chfn_restrict': settings['auth']['chfn_restrict'],
+            'allow_login_without_home': settings['auth']['allow_homeless']
+        }
+
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e64be003be0b89d1416b22c35c43b6024979361
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py
@@ -0,0 +1,50 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    ReadOnly,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening access audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Remove write permissions from $PATH folders for all regular users.
+    # This prevents changing system-wide commands from normal users.
+    path_folders = {'/usr/local/sbin',
+                    '/usr/local/bin',
+                    '/usr/sbin',
+                    '/usr/bin',
+                    '/bin'}
+    extra_user_paths = settings['environment']['extra_user_paths']
+    path_folders.update(extra_user_paths)
+    audits.append(ReadOnly(path_folders))
+
+    # Only allow the root user to have access to the shadow file.
+    audits.append(FilePermissionAudit('/etc/shadow', 'root', 'root', 0o0600))
+
+    if 'change_user' not in settings['security']['users_allow']:
+        # su should only be accessible to user and group root, unless it is
+        # expressly defined to allow users to change to root via the
+        # security_users_allow config option.
+        audits.append(FilePermissionAudit('/bin/su', 'root', 'root', 0o750))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/pam.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/pam.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b38d5f0cf0b16282968825b79b44d80a1a7f577
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/pam.py
@@ -0,0 +1,132 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from subprocess import (
+    check_output,
+    CalledProcessError,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_purge,
+    apt_update,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    DeletedFile,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+def get_audits():
+    """Get OS hardening PAM authentication audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+
+    if settings['auth']['pam_passwdqc_enable']:
+        audits.append(PasswdqcPAM('/etc/passwdqc.conf'))
+
+    if settings['auth']['retries']:
+        audits.append(Tally2PAM('/usr/share/pam-configs/tally2'))
+    else:
+        audits.append(DeletedFile('/usr/share/pam-configs/tally2'))
+
+    return audits
+
+
+class PasswdqcPAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_pam_passwdqc_options'] = \
+            settings['auth']['pam_passwdqc_options']
+
+        return ctxt
+
+
+class PasswdqcPAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(PasswdqcPAM, self).__init__(path=path,
+                                          template_dir=TEMPLATES_DIR,
+                                          context=PasswdqcPAMContext(),
+                                          user='root',
+                                          group='root',
+                                          mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        for pkg in ['libpam-ccreds', 'libpam-cracklib']:
+            log("Purging package '%s'" % pkg, level=DEBUG),
+            apt_purge(pkg)
+
+        apt_update(fatal=True)
+        for pkg in ['libpam-passwdqc']:
+            log("Installing package '%s'" % pkg, level=DEBUG),
+            apt_install(pkg)
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
+
+
+class Tally2PAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_lockout_time'] = settings['auth']['lockout_time']
+        ctxt['auth_retries'] = settings['auth']['retries']
+
+        return ctxt
+
+
+class Tally2PAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(Tally2PAM, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=Tally2PAMContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        apt_purge('libpam-ccreds')
+        apt_update(fatal=True)
+        apt_install('libpam-modules')
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/profile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/profile.py
new file mode 100644
index 0000000000000000000000000000000000000000..2727428da9241ccf88a60843d05dffb26cebac96
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/profile.py
@@ -0,0 +1,49 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening profile audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/profile.d/pinerolo_profile.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0755, user='root', group='root'))
+    if settings['security']['ssh_tmout']:
+        audits.append(TemplatedFile('/etc/profile.d/99-hardening.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0644, user='root', group='root'))
+    return audits
+
+
+class ProfileContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ssh_tmout':
+                settings['security']['ssh_tmout']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/securetty.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/securetty.py
new file mode 100644
index 0000000000000000000000000000000000000000..34cd02178c1fbf1c7d467af0814ad9fd4199dc3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/securetty.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening Secure TTY audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    audits.append(TemplatedFile('/etc/securetty', SecureTTYContext(),
+                                template_dir=TEMPLATES_DIR,
+                                mode=0o0400, user='root', group='root'))
+    return audits
+
+
+class SecureTTYContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ttys': settings['auth']['root_ttys']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcbe3fde07ea0716e2de6d1d4e103fcb19166c14
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
@@ -0,0 +1,129 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import NoSUIDSGIDAudit
+from charmhelpers.contrib.hardening import utils
+
+
+BLACKLIST = ['/usr/bin/rcp', '/usr/bin/rlogin', '/usr/bin/rsh',
+             '/usr/libexec/openssh/ssh-keysign',
+             '/usr/lib/openssh/ssh-keysign',
+             '/sbin/netreport',
+             '/usr/sbin/usernetctl',
+             '/usr/sbin/userisdnctl',
+             '/usr/sbin/pppd',
+             '/usr/bin/lockfile',
+             '/usr/bin/mail-lock',
+             '/usr/bin/mail-unlock',
+             '/usr/bin/mail-touchlock',
+             '/usr/bin/dotlockfile',
+             '/usr/bin/arping',
+             '/usr/sbin/uuidd',
+             '/usr/bin/mtr',
+             '/usr/lib/evolution/camel-lock-helper-1.2',
+             '/usr/lib/pt_chown',
+             '/usr/lib/eject/dmcrypt-get-device',
+             '/usr/lib/mc/cons.saver']
+
+WHITELIST = ['/bin/mount', '/bin/ping', '/bin/su', '/bin/umount',
+             '/sbin/pam_timestamp_check', '/sbin/unix_chkpwd', '/usr/bin/at',
+             '/usr/bin/gpasswd', '/usr/bin/locate', '/usr/bin/newgrp',
+             '/usr/bin/passwd', '/usr/bin/ssh-agent',
+             '/usr/libexec/utempter/utempter', '/usr/sbin/lockdev',
+             '/usr/sbin/sendmail.sendmail', '/usr/bin/expiry',
+             '/bin/ping6', '/usr/bin/traceroute6.iputils',
+             '/sbin/mount.nfs', '/sbin/umount.nfs',
+             '/sbin/mount.nfs4', '/sbin/umount.nfs4',
+             '/usr/bin/crontab',
+             '/usr/bin/wall', '/usr/bin/write',
+             '/usr/bin/screen',
+             '/usr/bin/mlocate',
+             '/usr/bin/chage', '/usr/bin/chfn', '/usr/bin/chsh',
+             '/bin/fusermount',
+             '/usr/bin/pkexec',
+             '/usr/bin/sudo', '/usr/bin/sudoedit',
+             '/usr/sbin/postdrop', '/usr/sbin/postqueue',
+             '/usr/sbin/suexec',
+             '/usr/lib/squid/ncsa_auth', '/usr/lib/squid/pam_auth',
+             '/usr/kerberos/bin/ksu',
+             '/usr/sbin/ccreds_validate',
+             '/usr/bin/Xorg',
+             '/usr/bin/X',
+             '/usr/lib/dbus-1.0/dbus-daemon-launch-helper',
+             '/usr/lib/vte/gnome-pty-helper',
+             '/usr/lib/libvte9/gnome-pty-helper',
+             '/usr/lib/libvte-2.90-9/gnome-pty-helper']
+
+
+def get_audits():
+    """Get OS hardening suid/sgid audits.
+
+    :returns:  dictionary of audits
+    """
+    checks = []
+    settings = utils.get_settings('os')
+    if not settings['security']['suid_sgid_enforce']:
+        log("Skipping suid/sgid hardening", level=INFO)
+        return checks
+
+    # Build the blacklist and whitelist of files for suid/sgid checks.
+    # There are a total of 4 lists:
+    #   1. the system blacklist
+    #   2. the system whitelist
+    #   3. the user blacklist
+    #   4. the user whitelist
+    #
+    # The blacklist is the set of paths which should NOT have the suid/sgid bit
+    # set and the whitelist is the set of paths which MAY have the suid/sgid
+    # bit setl. The user whitelist/blacklist effectively override the system
+    # whitelist/blacklist.
+    u_b = settings['security']['suid_sgid_blacklist']
+    u_w = settings['security']['suid_sgid_whitelist']
+
+    blacklist = set(BLACKLIST) - set(u_w + u_b)
+    whitelist = set(WHITELIST) - set(u_b + u_w)
+
+    checks.append(NoSUIDSGIDAudit(blacklist))
+
+    dry_run = settings['security']['suid_sgid_dry_run_on_unknown']
+
+    if settings['security']['suid_sgid_remove_from_unknown'] or dry_run:
+        # If the policy is a dry_run (e.g. complain only) or remove unknown
+        # suid/sgid bits then find all of the paths which have the suid/sgid
+        # bit set and then remove the whitelisted paths.
+        root_path = settings['environment']['root_path']
+        unknown_paths = find_paths_with_suid_sgid(root_path) - set(whitelist)
+        checks.append(NoSUIDSGIDAudit(unknown_paths, unless=dry_run))
+
+    return checks
+
+
+def find_paths_with_suid_sgid(root_path):
+    """Finds all paths/files which have an suid/sgid bit enabled.
+
+    Starting with the root_path, this will recursively find all paths which
+    have an suid or sgid bit set.
+    """
+    cmd = ['find', root_path, '-perm', '-4000', '-o', '-perm', '-2000',
+           '-type', 'f', '!', '-path', '/proc/*', '-print']
+
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    out, _ = p.communicate()
+    return set(out.split('\n'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1ea5813036b11893e8b9a986bf30a2f7a541b5d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py
@@ -0,0 +1,209 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import platform
+import re
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    WARNING,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+SYSCTL_DEFAULTS = """net.ipv4.ip_forward=%(net_ipv4_ip_forward)s
+net.ipv6.conf.all.forwarding=%(net_ipv6_conf_all_forwarding)s
+net.ipv4.conf.all.rp_filter=1
+net.ipv4.conf.default.rp_filter=1
+net.ipv4.icmp_echo_ignore_broadcasts=1
+net.ipv4.icmp_ignore_bogus_error_responses=1
+net.ipv4.icmp_ratelimit=100
+net.ipv4.icmp_ratemask=88089
+net.ipv6.conf.all.disable_ipv6=%(net_ipv6_conf_all_disable_ipv6)s
+net.ipv4.tcp_timestamps=%(net_ipv4_tcp_timestamps)s
+net.ipv4.conf.all.arp_ignore=%(net_ipv4_conf_all_arp_ignore)s
+net.ipv4.conf.all.arp_announce=%(net_ipv4_conf_all_arp_announce)s
+net.ipv4.tcp_rfc1337=1
+net.ipv4.tcp_syncookies=1
+net.ipv4.conf.all.shared_media=1
+net.ipv4.conf.default.shared_media=1
+net.ipv4.conf.all.accept_source_route=0
+net.ipv4.conf.default.accept_source_route=0
+net.ipv4.conf.all.accept_redirects=0
+net.ipv4.conf.default.accept_redirects=0
+net.ipv6.conf.all.accept_redirects=0
+net.ipv6.conf.default.accept_redirects=0
+net.ipv4.conf.all.secure_redirects=0
+net.ipv4.conf.default.secure_redirects=0
+net.ipv4.conf.all.send_redirects=0
+net.ipv4.conf.default.send_redirects=0
+net.ipv4.conf.all.log_martians=0
+net.ipv6.conf.default.router_solicitations=0
+net.ipv6.conf.default.accept_ra_rtr_pref=0
+net.ipv6.conf.default.accept_ra_pinfo=0
+net.ipv6.conf.default.accept_ra_defrtr=0
+net.ipv6.conf.default.autoconf=0
+net.ipv6.conf.default.dad_transmits=0
+net.ipv6.conf.default.max_addresses=1
+net.ipv6.conf.all.accept_ra=0
+net.ipv6.conf.default.accept_ra=0
+kernel.modules_disabled=%(kernel_modules_disabled)s
+kernel.sysrq=%(kernel_sysrq)s
+fs.suid_dumpable=%(fs_suid_dumpable)s
+kernel.randomize_va_space=2
+"""
+
+
+def get_audits():
+    """Get OS hardening sysctl audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Apply the sysctl settings which are configured to be applied.
+    audits.append(SysctlConf())
+    # Make sure that only root has access to the sysctl.conf file, and
+    # that it is read-only.
+    audits.append(FilePermissionAudit('/etc/sysctl.conf',
+                                      user='root',
+                                      group='root', mode=0o0440))
+    # If module loading is not enabled, then ensure that the modules
+    # file has the appropriate permissions and rebuild the initramfs
+    if not settings['security']['kernel_enable_module_loading']:
+        audits.append(ModulesTemplate())
+
+    return audits
+
+
+class ModulesContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        with open('/proc/cpuinfo', 'r') as fd:
+            cpuinfo = fd.readlines()
+
+        for line in cpuinfo:
+            match = re.search(r"^vendor_id\s+:\s+(.+)", line)
+            if match:
+                vendor = match.group(1)
+
+        if vendor == "GenuineIntel":
+            vendor = "intel"
+        elif vendor == "AuthenticAMD":
+            vendor = "amd"
+
+        ctxt = {'arch': platform.processor(),
+                'cpuVendor': vendor,
+                'desktop_enable': settings['general']['desktop_enable']}
+
+        return ctxt
+
+
+class ModulesTemplate(object):
+
+    def __init__(self):
+        super(ModulesTemplate, self).__init__('/etc/initramfs-tools/modules',
+                                              ModulesContext(),
+                                              templates_dir=TEMPLATES_DIR,
+                                              user='root', group='root',
+                                              mode=0o0440)
+
+    def post_write(self):
+        subprocess.check_call(['update-initramfs', '-u'])
+
+
+class SysCtlHardeningContext(object):
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'sysctl': {}}
+
+        log("Applying sysctl settings", level=INFO)
+        extras = {'net_ipv4_ip_forward': 0,
+                  'net_ipv6_conf_all_forwarding': 0,
+                  'net_ipv6_conf_all_disable_ipv6': 1,
+                  'net_ipv4_tcp_timestamps': 0,
+                  'net_ipv4_conf_all_arp_ignore': 0,
+                  'net_ipv4_conf_all_arp_announce': 0,
+                  'kernel_sysrq': 0,
+                  'fs_suid_dumpable': 0,
+                  'kernel_modules_disabled': 1}
+
+        if settings['sysctl']['ipv6_enable']:
+            extras['net_ipv6_conf_all_disable_ipv6'] = 0
+
+        if settings['sysctl']['forwarding']:
+            extras['net_ipv4_ip_forward'] = 1
+            extras['net_ipv6_conf_all_forwarding'] = 1
+
+        if settings['sysctl']['arp_restricted']:
+            extras['net_ipv4_conf_all_arp_ignore'] = 1
+            extras['net_ipv4_conf_all_arp_announce'] = 2
+
+        if settings['security']['kernel_enable_module_loading']:
+            extras['kernel_modules_disabled'] = 0
+
+        if settings['sysctl']['kernel_enable_sysrq']:
+            sysrq_val = settings['sysctl']['kernel_secure_sysrq']
+            extras['kernel_sysrq'] = sysrq_val
+
+        if settings['security']['kernel_enable_core_dump']:
+            extras['fs_suid_dumpable'] = 1
+
+        settings.update(extras)
+        for d in (SYSCTL_DEFAULTS % settings).split():
+            d = d.strip().partition('=')
+            key = d[0].strip()
+            path = os.path.join('/proc/sys', key.replace('.', '/'))
+            if not os.path.exists(path):
+                log("Skipping '%s' since '%s' does not exist" % (key, path),
+                    level=WARNING)
+                continue
+
+            ctxt['sysctl'][key] = d[2] or None
+
+        # Translate for python3
+        return {'sysctl_settings':
+                [(k, v) for k, v in six.iteritems(ctxt['sysctl'])]}
+
+
+class SysctlConf(TemplatedFile):
+    """An audit check for sysctl settings."""
+    def __init__(self):
+        self.conffile = '/etc/sysctl.d/99-juju-hardening.conf'
+        super(SysctlConf, self).__init__(self.conffile,
+                                         SysCtlHardeningContext(),
+                                         template_dir=TEMPLATES_DIR,
+                                         user='root', group='root',
+                                         mode=0o0440)
+
+    def post_write(self):
+        try:
+            subprocess.check_call(['sysctl', '-p', self.conffile])
+        except subprocess.CalledProcessError as e:
+            # NOTE: on some systems if sysctl cannot apply all settings it
+            #       will return non-zero as well.
+            log("sysctl command returned an error (maybe some "
+                "keys could not be set) - %s" % (e),
+                level=WARNING)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
new file mode 100644
index 0000000000000000000000000000000000000000..0014191fc8152fd9147b3fb5446987e6e62f2d77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% if disable_core_dump -%}
+# Prevent core dumps for all users. These are usually only needed by developers and may contain sensitive information.
+* hard core 0
+{% endif %}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
new file mode 100644
index 0000000000000000000000000000000000000000..616cef46f492f682aca28c71a6e20176870a36f2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
@@ -0,0 +1,5 @@
+TMOUT={{ tmout }}
+readonly TMOUT
+export TMOUT
+
+readonly HISTFILE
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..101f1e1d709c268890553957f30c93259681ce59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
@@ -0,0 +1,7 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% for key, value in sysctl_settings -%}
+{{ key }}={{ value }}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/login.defs b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/login.defs
new file mode 100644
index 0000000000000000000000000000000000000000..db137d6dbb7a3a850294407199225392a880cfc2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/login.defs
@@ -0,0 +1,349 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+#
+# /etc/login.defs - Configuration control definitions for the login package.
+#
+# Three items must be defined:  MAIL_DIR, ENV_SUPATH, and ENV_PATH.
+# If unspecified, some arbitrary (and possibly incorrect) value will
+# be assumed.  All other items are optional - if not specified then
+# the described action or option will be inhibited.
+#
+# Comment lines (lines beginning with "#") and blank lines are ignored.
+#
+# Modified for Linux.  --marekm
+
+# REQUIRED for useradd/userdel/usermod
+#   Directory where mailboxes reside, _or_ name of file, relative to the
+#   home directory.  If you _do_ define MAIL_DIR and MAIL_FILE,
+#   MAIL_DIR takes precedence.
+#
+#   Essentially:
+#      - MAIL_DIR defines the location of users mail spool files
+#        (for mbox use) by appending the username to MAIL_DIR as defined
+#        below.
+#      - MAIL_FILE defines the location of the users mail spool files as the
+#        fully-qualified filename obtained by prepending the user home
+#        directory before $MAIL_FILE
+#
+# NOTE: This is no more used for setting up users MAIL environment variable
+#       which is, starting from shadow 4.0.12-1 in Debian, entirely the
+#       job of the pam_mail PAM modules
+#       See default PAM configuration files provided for
+#       login, su, etc.
+#
+# This is a temporary situation: setting these variables will soon
+# move to /etc/default/useradd and the variables will then be
+# no more supported
+MAIL_DIR        /var/mail
+#MAIL_FILE      .mail
+
+#
+# Enable logging and display of /var/log/faillog login failure info.
+# This option conflicts with the pam_tally PAM module.
+#
+FAILLOG_ENAB		yes
+
+#
+# Enable display of unknown usernames when login failures are recorded.
+#
+# WARNING: Unknown usernames may become world readable. 
+# See #290803 and #298773 for details about how this could become a security
+# concern
+LOG_UNKFAIL_ENAB	no
+
+#
+# Enable logging of successful logins
+#
+LOG_OK_LOGINS		yes
+
+#
+# Enable "syslog" logging of su activity - in addition to sulog file logging.
+# SYSLOG_SG_ENAB does the same for newgrp and sg.
+#
+SYSLOG_SU_ENAB		yes
+SYSLOG_SG_ENAB		yes
+
+#
+# If defined, all su activity is logged to this file.
+#
+#SULOG_FILE	/var/log/sulog
+
+#
+# If defined, file which maps tty line to TERM environment parameter.
+# Each line of the file is in a format something like "vt100  tty01".
+#
+#TTYTYPE_FILE	/etc/ttytype
+
+#
+# If defined, login failures will be logged here in a utmp format
+# last, when invoked as lastb, will read /var/log/btmp, so...
+#
+FTMP_FILE	/var/log/btmp
+
+#
+# If defined, the command name to display when running "su -".  For
+# example, if this is defined as "su" then a "ps" will display the
+# command is "-su".  If not defined, then "ps" would display the
+# name of the shell actually being run, e.g. something like "-sh".
+#
+SU_NAME		su
+
+#
+# If defined, file which inhibits all the usual chatter during the login
+# sequence.  If a full pathname, then hushed mode will be enabled if the
+# user's name or shell are found in the file.  If not a full pathname, then
+# hushed mode will be enabled if the file exists in the user's home directory.
+#
+HUSHLOGIN_FILE	.hushlogin
+#HUSHLOGIN_FILE	/etc/hushlogins
+
+#
+# *REQUIRED*  The default PATH settings, for superuser and normal users.
+#
+# (they are minimal, add the rest in the shell startup files)
+ENV_SUPATH	PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+ENV_PATH	PATH=/usr/local/bin:/usr/bin:/bin{% if additional_user_paths %}{{ additional_user_paths }}{% endif %}
+
+#
+# Terminal permissions
+#
+#	TTYGROUP	Login tty will be assigned this group ownership.
+#	TTYPERM		Login tty will be set to this permission.
+#
+# If you have a "write" program which is "setgid" to a special group
+# which owns the terminals, define TTYGROUP to the group number and
+# TTYPERM to 0620.  Otherwise leave TTYGROUP commented out and assign
+# TTYPERM to either 622 or 600.
+#
+# In Debian /usr/bin/bsd-write or similar programs are setgid tty
+# However, the default and recommended value for TTYPERM is still 0600
+# to not allow anyone to write to anyone else console or terminal
+
+# Users can still allow other people to write them by issuing 
+# the "mesg y" command.
+
+TTYGROUP	tty
+TTYPERM		0600
+
+#
+# Login configuration initializations:
+#
+#	ERASECHAR	Terminal ERASE character ('\010' = backspace).
+#	KILLCHAR	Terminal KILL character ('\025' = CTRL/U).
+#	UMASK		Default "umask" value.
+#
+# The ERASECHAR and KILLCHAR are used only on System V machines.
+# 
+# UMASK is the default umask value for pam_umask and is used by
+# useradd and newusers to set the mode of the new home directories.
+# 022 is the "historical" value in Debian for UMASK
+# 027, or even 077, could be considered better for privacy
+# There is no One True Answer here : each sysadmin must make up his/her
+# mind.
+#
+# If USERGROUPS_ENAB is set to "yes", that will modify this UMASK default value
+# for private user groups, i. e. the uid is the same as gid, and username is
+# the same as the primary group name: for these, the user permissions will be
+# used as group permissions, e. g. 022 will become 002.
+#
+# Prefix these values with "0" to get octal, "0x" to get hexadecimal.
+#
+ERASECHAR	0177
+KILLCHAR	025
+UMASK		{{ umask }}
+
+# Enable setting of the umask group bits to be the same as owner bits (examples: `022` -> `002`, `077` -> `007`) for non-root users, if the uid is the same as gid, and username is the same as the primary group name.
+# If set to yes, userdel will remove the user´s group if it contains no more members, and useradd will create by default a group with the name of the user.
+USERGROUPS_ENAB yes
+
+#
+# Password aging controls:
+#
+#	PASS_MAX_DAYS	Maximum number of days a password may be used.
+#	PASS_MIN_DAYS	Minimum number of days allowed between password changes.
+#	PASS_WARN_AGE	Number of days warning given before a password expires.
+#
+PASS_MAX_DAYS	{{ pwd_max_age }}
+PASS_MIN_DAYS	{{ pwd_min_age }}
+PASS_WARN_AGE	7
+
+#
+# Min/max values for automatic uid selection in useradd
+#
+UID_MIN			 {{ uid_min }}
+UID_MAX			60000
+# System accounts
+SYS_UID_MIN		  {{ sys_uid_min }}
+SYS_UID_MAX		  {{ sys_uid_max }}
+
+# Min/max values for automatic gid selection in groupadd
+GID_MIN			 {{ gid_min }}
+GID_MAX			60000
+# System accounts
+SYS_GID_MIN		  {{ sys_gid_min }}
+SYS_GID_MAX		  {{ sys_gid_max }}
+
+#
+# Max number of login retries if password is bad. This will most likely be
+# overriden by PAM, since the default pam_unix module has it's own built
+# in of 3 retries. However, this is a safe fallback in case you are using
+# an authentication module that does not enforce PAM_MAXTRIES.
+#
+LOGIN_RETRIES		{{ login_retries }}
+
+#
+# Max time in seconds for login
+#
+LOGIN_TIMEOUT		{{ login_timeout }}
+
+#
+# Which fields may be changed by regular users using chfn - use
+# any combination of letters "frwh" (full name, room number, work
+# phone, home phone).  If not defined, no changes are allowed.
+# For backward compatibility, "yes" = "rwh" and "no" = "frwh".
+# 
+{% if chfn_restrict %}
+CHFN_RESTRICT		{{ chfn_restrict }}
+{% endif %}
+
+#
+# Should login be allowed if we can't cd to the home directory?
+# Default in no.
+#
+DEFAULT_HOME	{% if allow_login_without_home %} yes {% else %} no {% endif %}
+
+#
+# If defined, this command is run when removing a user.
+# It should remove any at/cron/print jobs etc. owned by
+# the user to be removed (passed as the first argument).
+#
+#USERDEL_CMD	/usr/sbin/userdel_local
+
+#
+# Enable setting of the umask group bits to be the same as owner bits
+# (examples: 022 -> 002, 077 -> 007) for non-root users, if the uid is
+# the same as gid, and username is the same as the primary group name.
+#
+# If set to yes, userdel will remove the user´s group if it contains no
+# more members, and useradd will create by default a group with the name
+# of the user.
+#
+USERGROUPS_ENAB yes
+
+#
+# Instead of the real user shell, the program specified by this parameter
+# will be launched, although its visible name (argv[0]) will be the shell's.
+# The program may do whatever it wants (logging, additional authentification,
+# banner, ...) before running the actual shell.
+#
+# FAKE_SHELL /bin/fakeshell
+
+#
+# If defined, either full pathname of a file containing device names or
+# a ":" delimited list of device names.  Root logins will be allowed only
+# upon these devices.
+#
+# This variable is used by login and su.
+#
+#CONSOLE	/etc/consoles
+#CONSOLE	console:tty01:tty02:tty03:tty04
+
+#
+# List of groups to add to the user's supplementary group set
+# when logging in on the console (as determined by the CONSOLE
+# setting).  Default is none.
+#
+# Use with caution - it is possible for users to gain permanent
+# access to these groups, even when not logged in on the console.
+# How to do it is left as an exercise for the reader...
+#
+# This variable is used by login and su.
+#
+#CONSOLE_GROUPS		floppy:audio:cdrom
+
+#
+# If set to "yes", new passwords will be encrypted using the MD5-based
+# algorithm compatible with the one used by recent releases of FreeBSD.
+# It supports passwords of unlimited length and longer salt strings.
+# Set to "no" if you need to copy encrypted passwords to other systems
+# which don't understand the new algorithm.  Default is "no".
+#
+# This variable is deprecated. You should use ENCRYPT_METHOD.
+#
+MD5_CRYPT_ENAB	no
+
+#
+# If set to MD5 , MD5-based algorithm will be used for encrypting password
+# If set to SHA256, SHA256-based algorithm will be used for encrypting password
+# If set to SHA512, SHA512-based algorithm will be used for encrypting password
+# If set to DES, DES-based algorithm will be used for encrypting password (default)
+# Overrides the MD5_CRYPT_ENAB option
+#
+# Note: It is recommended to use a value consistent with
+# the PAM modules configuration.
+#
+ENCRYPT_METHOD SHA512
+
+#
+# Only used if ENCRYPT_METHOD is set to SHA256 or SHA512.
+#
+# Define the number of SHA rounds.
+# With a lot of rounds, it is more difficult to brute forcing the password.
+# But note also that it more CPU resources will be needed to authenticate
+# users.
+#
+# If not specified, the libc will choose the default number of rounds (5000).
+# The values must be inside the 1000-999999999 range.
+# If only one of the MIN or MAX values is set, then this value will be used.
+# If MIN > MAX, the highest value will be used.
+#
+# SHA_CRYPT_MIN_ROUNDS 5000
+# SHA_CRYPT_MAX_ROUNDS 5000
+
+################# OBSOLETED BY PAM ##############
+#						#
+# These options are now handled by PAM. Please	#
+# edit the appropriate file in /etc/pam.d/ to	#
+# enable the equivelants of them.
+#
+###############
+
+#MOTD_FILE
+#DIALUPS_CHECK_ENAB
+#LASTLOG_ENAB
+#MAIL_CHECK_ENAB
+#OBSCURE_CHECKS_ENAB
+#PORTTIME_CHECKS_ENAB
+#SU_WHEEL_ONLY
+#CRACKLIB_DICTPATH
+#PASS_CHANGE_TRIES
+#PASS_ALWAYS_WARN
+#ENVIRON_FILE
+#NOLOGINS_FILE
+#ISSUE_FILE
+#PASS_MIN_LEN
+#PASS_MAX_LEN
+#ULIMIT
+#ENV_HZ
+#CHFN_AUTH
+#CHSH_AUTH
+#FAIL_DELAY
+
+################# OBSOLETED #######################
+#						  #
+# These options are no more handled by shadow.    #
+#                                                 #
+# Shadow utilities will display a warning if they #
+# still appear.                                   #
+#                                                 #
+###################################################
+
+# CLOSE_SESSIONS
+# LOGIN_STRING
+# NO_PASSWORD_CONSOLE
+# QMAIL_DIR
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/modules b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/modules
new file mode 100644
index 0000000000000000000000000000000000000000..ef0354ee35fa363b303bb22c6ed0d2d1196aed52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/modules
@@ -0,0 +1,117 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# /etc/modules: kernel modules to load at boot time.
+#
+# This file contains the names of kernel modules that should be loaded
+# at boot time, one per line. Lines beginning with "#" are ignored.
+# Parameters can be specified after the module name.
+
+# Arch
+# ----
+# 
+# Modules for certains builds, contains support modules and some CPU-specific optimizations.
+
+{% if arch == "x86_64" -%}
+# Optimize for x86_64 cryptographic features
+twofish-x86_64-3way
+twofish-x86_64
+aes-x86_64
+salsa20-x86_64
+blowfish-x86_64
+{% endif -%}
+
+{% if cpuVendor == "intel" -%}
+# Intel-specific optimizations
+ghash-clmulni-intel
+aesni-intel
+kvm-intel
+{% endif -%}
+
+{% if cpuVendor == "amd" -%}
+# AMD-specific optimizations
+kvm-amd
+{% endif -%}
+
+kvm
+
+
+# Crypto
+# ------
+
+# Some core modules which comprise strong cryptography.
+blowfish_common
+blowfish_generic
+ctr
+cts
+lrw
+lzo
+rmd160
+rmd256
+rmd320
+serpent
+sha512_generic
+twofish_common
+twofish_generic
+xts
+zlib
+
+
+# Drivers
+# -------
+
+# Basics
+lp
+rtc
+loop
+
+# Filesystems
+ext2
+btrfs
+
+{% if desktop_enable -%}
+# Desktop
+psmouse
+snd
+snd_ac97_codec
+snd_intel8x0
+snd_page_alloc
+snd_pcm
+snd_timer
+soundcore
+usbhid
+{% endif -%}
+
+# Lib
+# ---
+xz
+
+
+# Net
+# ---
+
+# All packets needed for netfilter rules (ie iptables, ebtables).
+ip_tables
+x_tables
+iptable_filter
+iptable_nat
+
+# Targets
+ipt_LOG
+ipt_REJECT
+
+# Modules
+xt_connlimit
+xt_tcpudp
+xt_recent
+xt_limit
+xt_conntrack
+nf_conntrack
+nf_conntrack_ipv4
+nf_defrag_ipv4
+xt_state
+nf_nat
+
+# Addons
+xt_pknock
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f98d14e57428c106692e0f57e8b381f2b0a12c44
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: passwdqc password strength enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Password-Type: Primary
+Password:
+  requisite     pam_passwdqc.so {{ auth_pam_passwdqc_options }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
new file mode 100644
index 0000000000000000000000000000000000000000..fd2de791b96fbb8889811daf7340d1f2ca2ab3a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Disable core dumps via soft limits for all users. Compliance to this setting
+# is voluntary and can be modified by users up to a hard limit. This setting is
+# a sane default.
+ulimit -S -c 0 > /dev/null 2>&1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/securetty b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/securetty
new file mode 100644
index 0000000000000000000000000000000000000000..15b18d4e2f45747845d0b65c06997f154ef674a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/securetty
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# A list of TTYs, from which root can log in
+# see `man securetty` for reference
+{% if ttys -%}
+{% for tty in ttys -%}
+{{ tty }}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/tally2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/tally2
new file mode 100644
index 0000000000000000000000000000000000000000..d9620299c55e51abbee1017a227c217cd4a9fd33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/host/templates/tally2
@@ -0,0 +1,14 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: tally2 lockout after failed attempts enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Auth-Type: Primary
+Auth-Initial:
+  required      pam_tally2.so deny={{ auth_retries }} onerr=fail unlock_time={{ auth_lockout_time }}
+Account-Type: Primary
+Account-Initial:
+  required      pam_tally2.so
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1990d8513bbeef067a8d9a2168e1952efb2961dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.mysql.checks import config
+
+
+def run_mysql_checks():
+    log("Starting MySQL hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("MySQL hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..a79f33b74a5c2972a82f0b4d8de8d1073dc293ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/checks/config.py
@@ -0,0 +1,87 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.mysql import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get MySQL hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'mysql'], stdout=subprocess.PIPE) != 0:
+        log("MySQL does not appear to be installed on this node - "
+            "skipping mysql hardening", level=WARNING)
+        return []
+
+    settings = utils.get_settings('mysql')
+    hardening_settings = settings['hardening']
+    my_cnf = hardening_settings['mysql-conf']
+
+    audits = [
+        FilePermissionAudit(paths=[my_cnf], user='root',
+                            group='root', mode=0o0600),
+
+        TemplatedFile(hardening_settings['hardening-conf'],
+                      MySQLConfContext(),
+                      TEMPLATES_DIR,
+                      mode=0o0750,
+                      user='mysql',
+                      group='root',
+                      service_actions=[{'service': 'mysql',
+                                        'actions': ['restart']}]),
+
+        # MySQL and Percona charms do not allow configuration of the
+        # data directory, so use the default.
+        DirectoryPermissionAudit('/var/lib/mysql',
+                                 user='mysql',
+                                 group='mysql',
+                                 recursive=False,
+                                 mode=0o755),
+
+        DirectoryPermissionAudit('/etc/mysql',
+                                 user='root',
+                                 group='root',
+                                 recursive=False,
+                                 mode=0o700),
+    ]
+
+    return audits
+
+
+class MySQLConfContext(object):
+    """Defines the set of key/value pairs to set in a mysql config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/mysql/conf.d/hardening.cnf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('mysql')
+        # Translate for python3
+        return {'mysql_settings':
+                [(k, v) for k, v in six.iteritems(settings['security'])]}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
new file mode 100644
index 0000000000000000000000000000000000000000..8242586cd66360b7e6ae33f13018363b95cd4ea9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
@@ -0,0 +1,12 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+[mysqld]
+{% for setting, value in mysql_settings -%}
+{% if value == 'True' -%}
+{{ setting }}
+{% elif value != 'None' and value != None -%}
+{{ setting }} = {{ value }}
+{% endif -%}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edaf484b39f8c7353cebb2f4b68944c6493ba7b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.ssh.checks import config
+
+
+def run_ssh_checks():
+    log("Starting SSH hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("SSH hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..41bed2d1e7b031182edcf62710876e4073dfbc6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/checks/config.py
@@ -0,0 +1,435 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_iface_addr,
+    is_ip,
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    FileContentAudit,
+)
+from charmhelpers.contrib.hardening.ssh import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get SSH hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [SSHConfig(), SSHDConfig(), SSHConfigFileContentAudit(),
+              SSHDConfigFileContentAudit()]
+    return audits
+
+
+class SSHConfigContext(object):
+
+    type = 'client'
+
+    def get_macs(self, allow_weak_mac):
+        if allow_weak_mac:
+            weak_macs = 'weak'
+        else:
+            weak_macs = 'default'
+
+        default = 'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160'
+        macs = {'default': default,
+                'weak': default + ',hmac-sha1'}
+
+        default = ('hmac-sha2-512-etm@openssh.com,'
+                   'hmac-sha2-256-etm@openssh.com,'
+                   'hmac-ripemd160-etm@openssh.com,umac-128-etm@openssh.com,'
+                   'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160')
+        macs_66 = {'default': default,
+                   'weak': default + ',hmac-sha1'}
+
+        # Use newer ciphers on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log("Detected Ubuntu 14.04 or newer, using new macs", level=DEBUG)
+            macs = macs_66
+
+        return macs[weak_macs]
+
+    def get_kexs(self, allow_weak_kex):
+        if allow_weak_kex:
+            weak_kex = 'weak'
+        else:
+            weak_kex = 'default'
+
+        default = 'diffie-hellman-group-exchange-sha256'
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex = {'default': default,
+               'weak': weak}
+
+        default = ('curve25519-sha256@libssh.org,'
+                   'diffie-hellman-group-exchange-sha256')
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex_66 = {'default': default,
+                  'weak': weak}
+
+        # Use newer kex on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new key exchange '
+                'algorithms', level=DEBUG)
+            kex = kex_66
+
+        return kex[weak_kex]
+
+    def get_ciphers(self, cbc_required):
+        if cbc_required:
+            weak_ciphers = 'weak'
+        else:
+            weak_ciphers = 'default'
+
+        default = 'aes256-ctr,aes192-ctr,aes128-ctr'
+        cipher = {'default': default,
+                  'weak': default + 'aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        default = ('chacha20-poly1305@openssh.com,aes256-gcm@openssh.com,'
+                   'aes128-gcm@openssh.com,aes256-ctr,aes192-ctr,aes128-ctr')
+        ciphers_66 = {'default': default,
+                      'weak': default + ',aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        # Use newer ciphers on ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new ciphers',
+                level=DEBUG)
+            cipher = ciphers_66
+
+        return cipher[weak_ciphers]
+
+    def get_listening(self, listen=['0.0.0.0']):
+        """Returns a list of addresses SSH can list on
+
+        Turns input into a sensible list of IPs SSH can listen on. Input
+        must be a python list of interface names, IPs and/or CIDRs.
+
+        :param listen: list of IPs, CIDRs, interface names
+
+        :returns: list of IPs available on the host
+        """
+        if listen == ['0.0.0.0']:
+            return listen
+
+        value = []
+        for network in listen:
+            try:
+                ip = get_address_in_network(network=network, fatal=True)
+            except ValueError:
+                if is_ip(network):
+                    ip = network
+                else:
+                    try:
+                        ip = get_iface_addr(iface=network, fatal=False)[0]
+                    except IndexError:
+                        continue
+            value.append(ip)
+        if value == []:
+            return ['0.0.0.0']
+        return value
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'addr_family': addr_family,
+            'remote_hosts': settings['common']['remote_hosts'],
+            'password_auth_allowed':
+            settings['client']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'ciphers': self.get_ciphers(settings['client']['cbc_required']),
+            'macs': self.get_macs(settings['client']['weak_hmac']),
+            'kexs': self.get_kexs(settings['client']['weak_kex']),
+            'roaming': settings['client']['roaming'],
+        }
+        return ctxt
+
+
+class SSHConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/ssh_config'
+        super(SSHConfig, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=SSHConfigContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0644)
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['client']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHDConfigContext(SSHConfigContext):
+
+    type = 'server'
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'ssh_ip': self.get_listening(settings['server']['listen_to']),
+            'password_auth_allowed':
+            settings['server']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'addr_family': addr_family,
+            'ciphers': self.get_ciphers(settings['server']['cbc_required']),
+            'macs': self.get_macs(settings['server']['weak_hmac']),
+            'kexs': self.get_kexs(settings['server']['weak_kex']),
+            'host_key_files': settings['server']['host_key_files'],
+            'allow_root_with_key': settings['server']['allow_root_with_key'],
+            'password_authentication':
+            settings['server']['password_authentication'],
+            'use_priv_sep': settings['server']['use_privilege_separation'],
+            'use_pam': settings['server']['use_pam'],
+            'allow_x11_forwarding': settings['server']['allow_x11_forwarding'],
+            'print_motd': settings['server']['print_motd'],
+            'print_last_log': settings['server']['print_last_log'],
+            'client_alive_interval':
+            settings['server']['alive_interval'],
+            'client_alive_count': settings['server']['alive_count'],
+            'allow_tcp_forwarding': settings['server']['allow_tcp_forwarding'],
+            'allow_agent_forwarding':
+            settings['server']['allow_agent_forwarding'],
+            'deny_users': settings['server']['deny_users'],
+            'allow_users': settings['server']['allow_users'],
+            'deny_groups': settings['server']['deny_groups'],
+            'allow_groups': settings['server']['allow_groups'],
+            'use_dns': settings['server']['use_dns'],
+            'sftp_enable': settings['server']['sftp_enable'],
+            'sftp_group': settings['server']['sftp_group'],
+            'sftp_chroot': settings['server']['sftp_chroot'],
+            'max_auth_tries': settings['server']['max_auth_tries'],
+            'max_sessions': settings['server']['max_sessions'],
+        }
+        return ctxt
+
+
+class SSHDConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/sshd_config'
+        super(SSHDConfig, self).__init__(path=path,
+                                         template_dir=TEMPLATES_DIR,
+                                         context=SSHDConfigContext(),
+                                         user='root',
+                                         group='root',
+                                         mode=0o0600,
+                                         service_actions=[{'service': 'ssh',
+                                                           'actions':
+                                                           ['restart']}])
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['server']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/ssh_config'
+        super(SSHConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['client']['weak_hmac']:
+                self.fail_cases.append(r'^MACs.+,hmac-sha1$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['client']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['client']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['client']['roaming']:
+            self.pass_cases.append(r'^UseRoaming yes$')
+        else:
+            self.fail_cases.append(r'^UseRoaming yes$')
+
+        return super(SSHConfigFileContentAudit, self).is_compliant(*args,
+                                                                   **kwargs)
+
+
+class SSHDConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/sshd_config'
+        super(SSHDConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['server']['sftp_enable']:
+            self.pass_cases.append(r'^Subsystem\ssftp')
+        else:
+            self.fail_cases.append(r'^Subsystem\ssftp')
+
+        return super(SSHDConfigFileContentAudit, self).is_compliant(*args,
+                                                                    **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config
new file mode 100644
index 0000000000000000000000000000000000000000..9742d8e2a32cd5da01a9dcb691a5a1201ed93050
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config
@@ -0,0 +1,70 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#       be overwritten.
+###############################################################################
+# This is the ssh client system-wide configuration file.  See
+# ssh_config(5) for more information.  This file provides defaults for
+# users, and the values can be changed in per-user configuration files
+# or on the command line.
+
+# Configuration data is parsed as follows:
+#  1. command line options
+#  2. user-specific file
+#  3. system-wide file
+# Any configuration value is only changed the first time it is set.
+# Thus, host-specific definitions should be at the beginning of the
+# configuration file, and defaults at the end.
+
+# Site-wide defaults for some commonly used options.  For a comprehensive
+# list of available options, their meanings and defaults, please see the
+# ssh_config(5) man page.
+
+# Restrict the following configuration to be limited to this Host.
+{% if remote_hosts -%}
+Host {{ ' '.join(remote_hosts) }}
+{% endif %}
+ForwardAgent no
+ForwardX11 no
+ForwardX11Trusted yes
+RhostsRSAAuthentication no
+RSAAuthentication yes
+PasswordAuthentication {{ password_auth_allowed }}
+HostbasedAuthentication no
+GSSAPIAuthentication no
+GSSAPIDelegateCredentials no
+GSSAPIKeyExchange no
+GSSAPITrustDNS no
+BatchMode no
+CheckHostIP yes
+AddressFamily {{ addr_family }}
+ConnectTimeout 0
+StrictHostKeyChecking ask
+IdentityFile ~/.ssh/identity
+IdentityFile ~/.ssh/id_rsa
+IdentityFile ~/.ssh/id_dsa
+# The port at the destination should be defined
+{% for port in ports -%}
+Port {{ port }}
+{% endfor %}
+Protocol 2
+Cipher 3des
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{%- endif %}
+{% if macs -%}
+MACs {{ macs }}
+{%- endif %}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{%- endif %}
+EscapeChar ~
+Tunnel no
+TunnelDevice any:any
+PermitLocalCommand no
+VisualHostKey no
+RekeyLimit 1G 1h
+SendEnv LANG LC_*
+HashKnownHosts yes
+{% if roaming -%}
+UseRoaming {{ roaming }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config
new file mode 100644
index 0000000000000000000000000000000000000000..5f87298a8119bcab1d2578bcaefd068e5af167c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config
@@ -0,0 +1,159 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Package generated configuration file
+# See the sshd_config(5) manpage for details
+
+# What ports, IPs and protocols we listen for
+{% for port in ports -%}
+Port {{ port }}
+{% endfor -%}
+AddressFamily {{ addr_family }}
+# Use these options to restrict which interfaces/protocols sshd will bind to
+{% if ssh_ip -%}
+{% for ip in ssh_ip -%}
+ListenAddress {{ ip }}
+{% endfor %}
+{%- else -%}
+ListenAddress ::
+ListenAddress 0.0.0.0
+{% endif -%}
+Protocol 2
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{% endif -%}
+{% if macs -%}
+MACs {{ macs }}
+{% endif -%}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{% endif -%}
+# HostKeys for protocol version 2
+{% for keyfile in host_key_files -%}
+HostKey {{ keyfile }}
+{% endfor -%}
+
+# Privilege Separation is turned on for security
+{% if use_priv_sep -%} 
+UsePrivilegeSeparation {{ use_priv_sep }}
+{% endif -%}
+
+# Lifetime and size of ephemeral version 1 server key
+KeyRegenerationInterval 3600
+ServerKeyBits 1024
+
+# Logging
+SyslogFacility AUTH
+LogLevel VERBOSE
+
+# Authentication:
+LoginGraceTime 30s
+{% if allow_root_with_key -%}
+PermitRootLogin without-password
+{% else -%}
+PermitRootLogin no
+{% endif %}
+PermitTunnel no
+PermitUserEnvironment no
+StrictModes yes
+
+RSAAuthentication yes
+PubkeyAuthentication yes
+AuthorizedKeysFile %h/.ssh/authorized_keys
+
+# Don't read the user's ~/.rhosts and ~/.shosts files
+IgnoreRhosts yes
+# For this to work you will also need host keys in /etc/ssh_known_hosts
+RhostsRSAAuthentication no
+# similar for protocol version 2
+HostbasedAuthentication no
+# Uncomment if you don't trust ~/.ssh/known_hosts for RhostsRSAAuthentication
+IgnoreUserKnownHosts yes
+
+# To enable empty passwords, change to yes (NOT RECOMMENDED)
+PermitEmptyPasswords no
+
+# Change to yes to enable challenge-response passwords (beware issues with
+# some PAM modules and threads)
+ChallengeResponseAuthentication no
+
+# Change to no to disable tunnelled clear text passwords
+PasswordAuthentication {{ password_authentication }}
+
+# Kerberos options
+KerberosAuthentication no
+KerberosGetAFSToken no
+KerberosOrLocalPasswd no
+KerberosTicketCleanup yes
+
+# GSSAPI options
+GSSAPIAuthentication no
+GSSAPICleanupCredentials yes
+
+X11Forwarding {{ allow_x11_forwarding }}
+X11DisplayOffset 10
+X11UseLocalhost yes
+GatewayPorts no
+PrintMotd {{ print_motd }}
+PrintLastLog {{ print_last_log }}
+TCPKeepAlive no
+UseLogin no
+
+ClientAliveInterval {{ client_alive_interval }}
+ClientAliveCountMax {{ client_alive_count }}
+AllowTcpForwarding {{ allow_tcp_forwarding }}
+AllowAgentForwarding {{ allow_agent_forwarding }}
+
+MaxStartups 10:30:100
+#Banner /etc/issue.net
+
+# Allow client to pass locale environment variables
+AcceptEnv LANG LC_*
+
+# Set this to 'yes' to enable PAM authentication, account processing,
+# and session processing. If this is enabled, PAM authentication will
+# be allowed through the ChallengeResponseAuthentication and
+# PasswordAuthentication.  Depending on your PAM configuration,
+# PAM authentication via ChallengeResponseAuthentication may bypass
+# the setting of "PermitRootLogin without-password".
+# If you just want the PAM account and session checks to run without
+# PAM authentication, then enable this but set PasswordAuthentication
+# and ChallengeResponseAuthentication to 'no'.
+UsePAM {{ use_pam }}
+
+{% if deny_users -%}
+DenyUsers {{ deny_users }}
+{% endif -%}
+{% if allow_users -%}
+AllowUsers {{ allow_users }}
+{% endif -%}
+{% if deny_groups -%}
+DenyGroups {{ deny_groups }}
+{% endif -%}
+{% if allow_groups -%}
+AllowGroups allow_groups
+{% endif -%}
+UseDNS {{ use_dns }}
+MaxAuthTries {{ max_auth_tries }}
+MaxSessions {{ max_sessions }}
+
+{% if sftp_enable -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+Subsystem sftp internal-sftp -l VERBOSE
+
+## These lines must appear at the *end* of sshd_config
+Match Group {{ sftp_group }}
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory {{ sftp_chroot }}
+{% else -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+## These lines must appear at the *end* of sshd_config
+Match Group sftponly
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory /sftpchroot/home/%u
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b6765f7edeee4bed739fd354c6f7bdf0a8c952e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/templating.py
@@ -0,0 +1,73 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+
+try:
+    from jinja2 import FileSystemLoader, Environment
+except ImportError:
+    from charmhelpers.fetch import apt_install
+    from charmhelpers.fetch import apt_update
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, Environment
+
+
+# NOTE: function separated from main rendering code to facilitate easier
+#       mocking in unit tests.
+def write(path, data):
+    with open(path, 'wb') as out:
+        out.write(data)
+
+
+def get_template_path(template_dir, path):
+    """Returns the template file which would be used to render the path.
+
+    The path to the template file is returned.
+    :param template_dir: the directory the templates are located in
+    :param path: the file path to be written to.
+    :returns: path to the template file
+    """
+    return os.path.join(template_dir, os.path.basename(path))
+
+
+def render_and_write(template_dir, path, context):
+    """Renders the specified template into the file.
+
+    :param template_dir: the directory to load the template from
+    :param path: the path to write the templated contents to
+    :param context: the parameters to pass to the rendering engine
+    """
+    env = Environment(loader=FileSystemLoader(template_dir))
+    template_file = os.path.basename(path)
+    template = env.get_template(template_file)
+    log('Rendering from template: %s' % template.name, level=DEBUG)
+    rendered_content = template.render(context)
+    if not rendered_content:
+        log("Render returned None - skipping '%s'" % path,
+            level=WARNING)
+        return
+
+    write(path, rendered_content.encode('utf-8').strip())
+    log('Wrote template %s' % path, level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff7485c28c8748ba366dba54f1e3b8f7e6a7c619
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/hardening/utils.py
@@ -0,0 +1,155 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import grp
+import os
+import pwd
+import six
+import yaml
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+
+
+# Global settings cache. Since each hook fire entails a fresh module import it
+# is safe to hold this in memory and not risk missing config changes (since
+# they will result in a new hook fire and thus re-import).
+__SETTINGS__ = {}
+
+
+def _get_defaults(modules):
+    """Load the default config for the provided modules.
+
+    :param modules: stack modules config defaults to lookup.
+    :returns: modules default config dictionary.
+    """
+    default = os.path.join(os.path.dirname(__file__),
+                           'defaults/%s.yaml' % (modules))
+    return yaml.safe_load(open(default))
+
+
+def _get_schema(modules):
+    """Load the config schema for the provided modules.
+
+    NOTE: this schema is intended to have 1-1 relationship with they keys in
+    the default config and is used a means to verify valid overrides provided
+    by the user.
+
+    :param modules: stack modules config schema to lookup.
+    :returns: modules default schema dictionary.
+    """
+    schema = os.path.join(os.path.dirname(__file__),
+                          'defaults/%s.yaml.schema' % (modules))
+    return yaml.safe_load(open(schema))
+
+
+def _get_user_provided_overrides(modules):
+    """Load user-provided config overrides.
+
+    :param modules: stack modules to lookup in user overrides yaml file.
+    :returns: overrides dictionary.
+    """
+    overrides = os.path.join(os.environ['JUJU_CHARM_DIR'],
+                             'hardening.yaml')
+    if os.path.exists(overrides):
+        log("Found user-provided config overrides file '%s'" %
+            (overrides), level=DEBUG)
+        settings = yaml.safe_load(open(overrides))
+        if settings and settings.get(modules):
+            log("Applying '%s' overrides" % (modules), level=DEBUG)
+            return settings.get(modules)
+
+        log("No overrides found for '%s'" % (modules), level=DEBUG)
+    else:
+        log("No hardening config overrides file '%s' found in charm "
+            "root dir" % (overrides), level=DEBUG)
+
+    return {}
+
+
+def _apply_overrides(settings, overrides, schema):
+    """Get overrides config overlayed onto modules defaults.
+
+    :param modules: require stack modules config.
+    :returns: dictionary of modules config with user overrides applied.
+    """
+    if overrides:
+        for k, v in six.iteritems(overrides):
+            if k in schema:
+                if schema[k] is None:
+                    settings[k] = v
+                elif type(schema[k]) is dict:
+                    settings[k] = _apply_overrides(settings[k], overrides[k],
+                                                   schema[k])
+                else:
+                    raise Exception("Unexpected type found in schema '%s'" %
+                                    type(schema[k]), level=ERROR)
+            else:
+                log("Unknown override key '%s' - ignoring" % (k), level=INFO)
+
+    return settings
+
+
+def get_settings(modules):
+    global __SETTINGS__
+    if modules in __SETTINGS__:
+        return __SETTINGS__[modules]
+
+    schema = _get_schema(modules)
+    settings = _get_defaults(modules)
+    overrides = _get_user_provided_overrides(modules)
+    __SETTINGS__[modules] = _apply_overrides(settings, overrides, schema)
+    return __SETTINGS__[modules]
+
+
+def ensure_permissions(path, user, group, permissions, maxdepth=-1):
+    """Ensure permissions for path.
+
+    If path is a file, apply to file and return. If path is a directory,
+    apply recursively (if required) to directory contents and return.
+
+    :param user: user name
+    :param group: group name
+    :param permissions: octal permissions
+    :param maxdepth: maximum recursion depth. A negative maxdepth allows
+                     infinite recursion and maxdepth=0 means no recursion.
+    :returns: None
+    """
+    if not os.path.exists(path):
+        log("File '%s' does not exist - cannot set permissions" % (path),
+            level=WARNING)
+        return
+
+    _user = pwd.getpwnam(user)
+    os.chown(path, _user.pw_uid, grp.getgrnam(group).gr_gid)
+    os.chmod(path, permissions)
+
+    if maxdepth == 0:
+        log("Max recursion depth reached - skipping further recursion",
+            level=DEBUG)
+        return
+    elif maxdepth > 0:
+        maxdepth -= 1
+
+    if os.path.isdir(path):
+        contents = glob.glob("%s/*" % (path))
+        for c in contents:
+            ensure_permissions(c, user=user, group=group,
+                               permissions=permissions, maxdepth=maxdepth)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/infiniband.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/infiniband.py
new file mode 100644
index 0000000000000000000000000000000000000000..0edb2314114738c79859f51e505de05e5c7c8fcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/mellanox/infiniband.py
@@ -0,0 +1,153 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+import six
+
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+try:
+    from netifaces import interfaces as network_interfaces
+except ImportError:
+    if six.PY2:
+        apt_install('python-netifaces')
+    else:
+        apt_install('python3-netifaces')
+    from netifaces import interfaces as network_interfaces
+
+import os
+import re
+import subprocess
+
+from charmhelpers.core.kernel import modprobe
+
+REQUIRED_MODULES = (
+    "mlx4_ib",
+    "mlx4_en",
+    "mlx4_core",
+    "ib_ipath",
+    "ib_mthca",
+    "ib_srpt",
+    "ib_srp",
+    "ib_ucm",
+    "ib_isert",
+    "ib_iser",
+    "ib_ipoib",
+    "ib_cm",
+    "ib_uverbs"
+    "ib_umad",
+    "ib_sa",
+    "ib_mad",
+    "ib_core",
+    "ib_addr",
+    "rdma_ucm",
+)
+
+REQUIRED_PACKAGES = (
+    "ibutils",
+    "infiniband-diags",
+    "ibverbs-utils",
+)
+
+IPOIB_DRIVERS = (
+    "ib_ipoib",
+)
+
+ABI_VERSION_FILE = "/sys/class/infiniband_mad/abi_version"
+
+
+class DeviceInfo(object):
+    pass
+
+
+def install_packages():
+    apt_update()
+    apt_install(REQUIRED_PACKAGES, fatal=True)
+
+
+def load_modules():
+    for module in REQUIRED_MODULES:
+        modprobe(module, persist=True)
+
+
+def is_enabled():
+    """Check if infiniband is loaded on the system"""
+    return os.path.exists(ABI_VERSION_FILE)
+
+
+def stat():
+    """Return full output of ibstat"""
+    return subprocess.check_output(["ibstat"])
+
+
+def devices():
+    """Returns a list of IB enabled devices"""
+    return subprocess.check_output(['ibstat', '-l']).splitlines()
+
+
+def device_info(device):
+    """Returns a DeviceInfo object with the current device settings"""
+
+    status = subprocess.check_output([
+        'ibstat', device, '-s']).splitlines()
+
+    regexes = {
+        "CA type: (.*)": "device_type",
+        "Number of ports: (.*)": "num_ports",
+        "Firmware version: (.*)": "fw_ver",
+        "Hardware version: (.*)": "hw_ver",
+        "Node GUID: (.*)": "node_guid",
+        "System image GUID: (.*)": "sys_guid",
+    }
+
+    device = DeviceInfo()
+
+    for line in status:
+        for expression, key in regexes.items():
+            matches = re.search(expression, line)
+            if matches:
+                setattr(device, key, matches.group(1))
+
+    return device
+
+
+def ipoib_interfaces():
+    """Return a list of IPOIB capable ethernet interfaces"""
+    interfaces = []
+
+    for interface in network_interfaces():
+        try:
+            driver = re.search('^driver: (.+)$', subprocess.check_output([
+                'ethtool', '-i',
+                interface]), re.M).group(1)
+
+            if driver in IPOIB_DRIVERS:
+                interfaces.append(interface)
+        except Exception:
+            log("Skipping interface %s" % interface, level=INFO)
+            continue
+
+    return interfaces
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..b13277bb57c9227b1d9dfecf4f6750740e5a262a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ip.py
@@ -0,0 +1,602 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import re
+import subprocess
+import six
+import socket
+
+from functools import partial
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    network_get_primary_address,
+    unit_get,
+    WARNING,
+    NoNetworkBinding,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+
+try:
+    import netifaces
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netifaces', fatal=True)
+    else:
+        apt_install('python3-netifaces', fatal=True)
+    import netifaces
+
+try:
+    import netaddr
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netaddr', fatal=True)
+    else:
+        apt_install('python3-netaddr', fatal=True)
+    import netaddr
+
+
+def _validate_cidr(network):
+    try:
+        netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+
+def no_ip_found_error_out(network):
+    errmsg = ("No IP address found in network(s): %s" % network)
+    raise ValueError(errmsg)
+
+
+def _get_ipv6_network_from_address(address):
+    """Get an netaddr.IPNetwork for the given IPv6 address
+    :param address: a dict as returned by netifaces.ifaddresses
+    :returns netaddr.IPNetwork: None if the address is a link local or loopback
+    address
+    """
+    if address['addr'].startswith('fe80') or address['addr'] == "::1":
+        return None
+
+    prefix = address['netmask'].split("/")
+    if len(prefix) > 1:
+        netmask = prefix[1]
+    else:
+        netmask = address['netmask']
+    return netaddr.IPNetwork("%s/%s" % (address['addr'],
+                                        netmask))
+
+
+def get_address_in_network(network, fallback=None, fatal=False):
+    """Get an IPv4 or IPv6 address within the network from the host.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'. Supports multiple networks as a space-delimited list.
+    :param fallback (str): If no address is found, return fallback.
+    :param fatal (boolean): If no address is found, fallback is not
+        set and fatal is True then exit(1).
+    """
+    if network is None:
+        if fallback is not None:
+            return fallback
+
+        if fatal:
+            no_ip_found_error_out(network)
+        else:
+            return None
+
+    networks = network.split() or [network]
+    for network in networks:
+        _validate_cidr(network)
+        network = netaddr.IPNetwork(network)
+        for iface in netifaces.interfaces():
+            try:
+                addresses = netifaces.ifaddresses(iface)
+            except ValueError:
+                # If an instance was deleted between
+                # netifaces.interfaces() run and now, its interfaces are gone
+                continue
+            if network.version == 4 and netifaces.AF_INET in addresses:
+                for addr in addresses[netifaces.AF_INET]:
+                    cidr = netaddr.IPNetwork("%s/%s" % (addr['addr'],
+                                                        addr['netmask']))
+                    if cidr in network:
+                        return str(cidr.ip)
+
+            if network.version == 6 and netifaces.AF_INET6 in addresses:
+                for addr in addresses[netifaces.AF_INET6]:
+                    cidr = _get_ipv6_network_from_address(addr)
+                    if cidr and cidr in network:
+                        return str(cidr.ip)
+
+    if fallback is not None:
+        return fallback
+
+    if fatal:
+        no_ip_found_error_out(network)
+
+    return None
+
+
+def is_ipv6(address):
+    """Determine whether provided address is IPv6 or not."""
+    try:
+        address = netaddr.IPAddress(address)
+    except netaddr.AddrFormatError:
+        # probably a hostname - so not an address at all!
+        return False
+
+    return address.version == 6
+
+
+def is_address_in_network(network, address):
+    """
+    Determine whether the provided address is within a network range.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'.
+    :param address: An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :returns boolean: Flag indicating whether address is in network.
+    """
+    try:
+        network = netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+    try:
+        address = netaddr.IPAddress(address)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Address (%s) is not in correct presentation format" %
+                         address)
+
+    if address in network:
+        return True
+    else:
+        return False
+
+
+def _get_for_address(address, key):
+    """Retrieve an attribute of or the physical interface that
+    the IP address provided could be bound to.
+
+    :param address (str): An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :param key: 'iface' for the physical interface name or an attribute
+        of the configured interface, for example 'netmask'.
+    :returns str: Requested attribute or None if address is not bindable.
+    """
+    address = netaddr.IPAddress(address)
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        if address.version == 4 and netifaces.AF_INET in addresses:
+            addr = addresses[netifaces.AF_INET][0]['addr']
+            netmask = addresses[netifaces.AF_INET][0]['netmask']
+            network = netaddr.IPNetwork("%s/%s" % (addr, netmask))
+            cidr = network.cidr
+            if address in cidr:
+                if key == 'iface':
+                    return iface
+                else:
+                    return addresses[netifaces.AF_INET][0][key]
+
+        if address.version == 6 and netifaces.AF_INET6 in addresses:
+            for addr in addresses[netifaces.AF_INET6]:
+                network = _get_ipv6_network_from_address(addr)
+                if not network:
+                    continue
+
+                cidr = network.cidr
+                if address in cidr:
+                    if key == 'iface':
+                        return iface
+                    elif key == 'netmask' and cidr:
+                        return str(cidr).split('/')[1]
+                    else:
+                        return addr[key]
+    return None
+
+
+get_iface_for_address = partial(_get_for_address, key='iface')
+
+
+get_netmask_for_address = partial(_get_for_address, key='netmask')
+
+
+def resolve_network_cidr(ip_address):
+    '''
+    Resolves the full address cidr of an ip_address based on
+    configured network interfaces
+    '''
+    netmask = get_netmask_for_address(ip_address)
+    return str(netaddr.IPNetwork("%s/%s" % (ip_address, netmask)).cidr)
+
+
+def format_ipv6_addr(address):
+    """If address is IPv6, wrap it in '[]' otherwise return None.
+
+    This is required by most configuration files when specifying IPv6
+    addresses.
+    """
+    if is_ipv6(address):
+        return "[%s]" % address
+
+    return None
+
+
+def is_ipv6_disabled():
+    try:
+        result = subprocess.check_output(
+            ['sysctl', 'net.ipv6.conf.all.disable_ipv6'],
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+    except subprocess.CalledProcessError:
+        return True
+
+    return "net.ipv6.conf.all.disable_ipv6 = 1" in result
+
+
+def get_iface_addr(iface='eth0', inet_type='AF_INET', inc_aliases=False,
+                   fatal=True, exc_list=None):
+    """Return the assigned IP address for a given interface, if any.
+
+    :param iface: network interface on which address(es) are expected to
+                  be found.
+    :param inet_type: inet address family
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :return: list of ip addresses
+    """
+    # Extract nic if passed /dev/ethX
+    if '/' in iface:
+        iface = iface.split('/')[-1]
+
+    if not exc_list:
+        exc_list = []
+
+    try:
+        inet_num = getattr(netifaces, inet_type)
+    except AttributeError:
+        raise Exception("Unknown inet type '%s'" % str(inet_type))
+
+    interfaces = netifaces.interfaces()
+    if inc_aliases:
+        ifaces = []
+        for _iface in interfaces:
+            if iface == _iface or _iface.split(':')[0] == iface:
+                ifaces.append(_iface)
+
+        if fatal and not ifaces:
+            raise Exception("Invalid interface '%s'" % iface)
+
+        ifaces.sort()
+    else:
+        if iface not in interfaces:
+            if fatal:
+                raise Exception("Interface '%s' not found " % (iface))
+            else:
+                return []
+
+        else:
+            ifaces = [iface]
+
+    addresses = []
+    for netiface in ifaces:
+        net_info = netifaces.ifaddresses(netiface)
+        if inet_num in net_info:
+            for entry in net_info[inet_num]:
+                if 'addr' in entry and entry['addr'] not in exc_list:
+                    addresses.append(entry['addr'])
+
+    if fatal and not addresses:
+        raise Exception("Interface '%s' doesn't have any %s addresses." %
+                        (iface, inet_type))
+
+    return sorted(addresses)
+
+
+get_ipv4_addr = partial(get_iface_addr, inet_type='AF_INET')
+
+
+def get_iface_from_addr(addr):
+    """Work out on which interface the provided address is configured."""
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        for inet_type in addresses:
+            for _addr in addresses[inet_type]:
+                _addr = _addr['addr']
+                # link local
+                ll_key = re.compile("(.+)%.*")
+                raw = re.match(ll_key, _addr)
+                if raw:
+                    _addr = raw.group(1)
+
+                if _addr == addr:
+                    log("Address '%s' is configured on iface '%s'" %
+                        (addr, iface))
+                    return iface
+
+    msg = "Unable to infer net iface on which '%s' is configured" % (addr)
+    raise Exception(msg)
+
+
+def sniff_iface(f):
+    """Ensure decorated function is called with a value for iface.
+
+    If no iface provided, inject net iface inferred from unit private address.
+    """
+    def iface_sniffer(*args, **kwargs):
+        if not kwargs.get('iface', None):
+            kwargs['iface'] = get_iface_from_addr(unit_get('private-address'))
+
+        return f(*args, **kwargs)
+
+    return iface_sniffer
+
+
+@sniff_iface
+def get_ipv6_addr(iface=None, inc_aliases=False, fatal=True, exc_list=None,
+                  dynamic_only=True):
+    """Get assigned IPv6 address for a given interface.
+
+    Returns list of addresses found. If no address found, returns empty list.
+
+    If iface is None, we infer the current primary interface by doing a reverse
+    lookup on the unit private-address.
+
+    We currently only support scope global IPv6 addresses i.e. non-temporary
+    addresses. If no global IPv6 address is found, return the first one found
+    in the ipv6 address list.
+
+    :param iface: network interface on which ipv6 address(es) are expected to
+                  be found.
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :param dynamic_only: only recognise dynamic addresses
+    :return: list of ipv6 addresses
+    """
+    addresses = get_iface_addr(iface=iface, inet_type='AF_INET6',
+                               inc_aliases=inc_aliases, fatal=fatal,
+                               exc_list=exc_list)
+
+    if addresses:
+        global_addrs = []
+        for addr in addresses:
+            key_scope_link_local = re.compile("^fe80::..(.+)%(.+)")
+            m = re.match(key_scope_link_local, addr)
+            if m:
+                eui_64_mac = m.group(1)
+                iface = m.group(2)
+            else:
+                global_addrs.append(addr)
+
+        if global_addrs:
+            # Make sure any found global addresses are not temporary
+            cmd = ['ip', 'addr', 'show', iface]
+            out = subprocess.check_output(cmd).decode('UTF-8')
+            if dynamic_only:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.* dynamic.*")
+            else:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.*")
+
+            addrs = []
+            for line in out.split('\n'):
+                line = line.strip()
+                m = re.match(key, line)
+                if m and 'temporary' not in line:
+                    # Return the first valid address we find
+                    for addr in global_addrs:
+                        if m.group(1) == addr:
+                            if not dynamic_only or \
+                                    m.group(1).endswith(eui_64_mac):
+                                addrs.append(addr)
+
+            if addrs:
+                return addrs
+
+    if fatal:
+        raise Exception("Interface '%s' does not have a scope global "
+                        "non-temporary ipv6 address." % iface)
+
+    return []
+
+
+def get_bridges(vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of bridges on the system."""
+    b_regex = "%s/*/bridge" % vnic_dir
+    return [x.replace(vnic_dir, '').split('/')[1] for x in glob.glob(b_regex)]
+
+
+def get_bridge_nics(bridge, vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of nics comprising a given bridge on the system."""
+    brif_regex = "%s/%s/brif/*" % (vnic_dir, bridge)
+    return [x.split('/')[-1] for x in glob.glob(brif_regex)]
+
+
+def is_bridge_member(nic):
+    """Check if a given nic is a member of a bridge."""
+    for bridge in get_bridges():
+        if nic in get_bridge_nics(bridge):
+            return True
+
+    return False
+
+
+def is_ip(address):
+    """
+    Returns True if address is a valid IP address.
+    """
+    try:
+        # Test to see if already an IPv4/IPv6 address
+        address = netaddr.IPAddress(address)
+        return True
+    except (netaddr.AddrFormatError, ValueError):
+        return False
+
+
+def ns_query(address):
+    try:
+        import dns.resolver
+    except ImportError:
+        if six.PY2:
+            apt_install('python-dnspython', fatal=True)
+        else:
+            apt_install('python3-dnspython', fatal=True)
+        import dns.resolver
+
+    if isinstance(address, dns.name.Name):
+        rtype = 'PTR'
+    elif isinstance(address, six.string_types):
+        rtype = 'A'
+    else:
+        return None
+
+    try:
+        answers = dns.resolver.query(address, rtype)
+    except dns.resolver.NXDOMAIN:
+        return None
+
+    if answers:
+        return str(answers[0])
+    return None
+
+
+def get_host_ip(hostname, fallback=None):
+    """
+    Resolves the IP for a given hostname, or returns
+    the input if it is already an IP.
+    """
+    if is_ip(hostname):
+        return hostname
+
+    ip_addr = ns_query(hostname)
+    if not ip_addr:
+        try:
+            ip_addr = socket.gethostbyname(hostname)
+        except Exception:
+            log("Failed to resolve hostname '%s'" % (hostname),
+                level=WARNING)
+            return fallback
+    return ip_addr
+
+
+def get_hostname(address, fqdn=True):
+    """
+    Resolves hostname for given IP, or returns the input
+    if it is already a hostname.
+    """
+    if is_ip(address):
+        try:
+            import dns.reversename
+        except ImportError:
+            if six.PY2:
+                apt_install("python-dnspython", fatal=True)
+            else:
+                apt_install("python3-dnspython", fatal=True)
+            import dns.reversename
+
+        rev = dns.reversename.from_address(address)
+        result = ns_query(rev)
+
+        if not result:
+            try:
+                result = socket.gethostbyaddr(address)[0]
+            except Exception:
+                return None
+    else:
+        result = address
+
+    if fqdn:
+        # strip trailing .
+        if result.endswith('.'):
+            return result[:-1]
+        else:
+            return result
+    else:
+        return result.split('.')[0]
+
+
+def port_has_listener(address, port):
+    """
+    Returns True if the address:port is open and being listened to,
+    else False.
+
+    @param address: an IP address or hostname
+    @param port: integer port
+
+    Note calls 'zc' via a subprocess shell
+    """
+    cmd = ['nc', '-z', address, str(port)]
+    result = subprocess.call(cmd)
+    return not(bool(result))
+
+
+def assert_charm_supports_ipv6():
+    """Check whether we are able to support charms ipv6."""
+    release = lsb_release()['DISTRIB_CODENAME'].lower()
+    if CompareHostReleases(release) < "trusty":
+        raise Exception("IPv6 is not supported in the charms for Ubuntu "
+                        "versions less than Trusty 14.04")
+
+
+def get_relation_ip(interface, cidr_network=None):
+    """Return this unit's IP for the given interface.
+
+    Allow for an arbitrary interface to use with network-get to select an IP.
+    Handle all address selection options including passed cidr network and
+    IPv6.
+
+    Usage: get_relation_ip('amqp', cidr_network='10.0.0.0/8')
+
+    @param interface: string name of the relation.
+    @param cidr_network: string CIDR Network to select an address from.
+    @raises Exception if prefer-ipv6 is configured but IPv6 unsupported.
+    @returns IPv6 or IPv4 address
+    """
+    # Select the interface address first
+    # For possible use as a fallback bellow with get_address_in_network
+    try:
+        # Get the interface specific IP
+        address = network_get_primary_address(interface)
+    except NotImplementedError:
+        # If network-get is not available
+        address = get_host_ip(unit_get('private-address'))
+    except NoNetworkBinding:
+        log("No network binding for {}".format(interface), WARNING)
+        address = get_host_ip(unit_get('private-address'))
+
+    if config('prefer-ipv6'):
+        # Currently IPv6 has priority, eventually we want IPv6 to just be
+        # another network space.
+        assert_charm_supports_ipv6()
+        return get_ipv6_addr()[0]
+    elif cidr_network:
+        # If a specific CIDR network is passed get the address from that
+        # network.
+        return get_address_in_network(cidr_network, address)
+
+    # Return the interface address
+    return address
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd001bc2eaa9b1b511bbd1816e1089521935a50a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/__init__.py
@@ -0,0 +1,541 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helpers for interacting with OpenvSwitch '''
+import hashlib
+import subprocess
+import os
+import six
+
+from charmhelpers.fetch import apt_install
+
+
+from charmhelpers.core.hookenv import (
+    log, WARNING, INFO, DEBUG
+)
+from charmhelpers.core.host import (
+    service
+)
+
+
+BRIDGE_TEMPLATE = """\
+# This veth pair is required when neutron data-port is mapped to an existing linux bridge. lp:1635067
+
+auto {linuxbridge_port}
+iface {linuxbridge_port} inet manual
+    pre-up ip link add name {linuxbridge_port} type veth peer name {ovsbridge_port}
+    pre-up ip link set {ovsbridge_port} master {bridge}
+    pre-up ip link set {ovsbridge_port} up
+    up ip link set {linuxbridge_port} up
+    down ip link del {linuxbridge_port}
+"""
+
+MAX_KERNEL_INTERFACE_NAME_LEN = 15
+
+
+def get_bridges():
+    """Return list of the bridges on the default openvswitch
+
+    :returns: List of bridge names
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if ovs-vsctl fails
+    """
+    cmd = ["ovs-vsctl", "list-br"]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_bridges = [l.strip() for l in lines]
+    return [b for b in maybe_bridges if b]
+
+
+def get_bridge_ports(name):
+    """Return a list the ports on a named bridge
+
+    :param name: the name of the bridge to list
+    :type name: str
+    :returns: List of ports on the named bridge
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if the ovs-vsctl command fails. If
+        the named bridge doesn't exist, then the exception will be raised.
+    """
+    cmd = ["ovs-vsctl", "--", "list-ports", name]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_ports = [l.strip() for l in lines]
+    return [p for p in maybe_ports if p]
+
+
+def get_bridges_and_ports_map():
+    """Return dictionary of bridge to ports for the default openvswitch
+
+    :returns: a mapping of bridge name to a list of ports.
+    :rtype: Dict[str, List[str]]
+    :raises: subprocess.CalledProcessError if any of the underlying ovs-vsctl
+        command fail.
+    """
+    return {b: get_bridge_ports(b) for b in get_bridges()}
+
+
+def _dict_to_vsctl_set(data, table, entity):
+    """Helper that takes dictionary and provides ``ovs-vsctl set`` commands
+
+    :param data: Additional data to attach to interface
+        The keys in the data dictionary map directly to column names in the
+        OpenvSwitch table specified as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type data: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param table: Name of table to operate on
+    :type table: str
+    :param entity: Name of entity to operate on
+    :type entity: str
+    :returns: '--' separated ``ovs-vsctl set`` commands
+    :rtype: Iterator[Tuple[str, str, str, str, str]]
+    """
+    for (k, v) in data.items():
+        if isinstance(v, dict):
+            entries = {
+                '{}:{}'.format(k, dk): dv for (dk, dv) in v.items()}
+        else:
+            entries = {k: v}
+        for (colk, colv) in entries.items():
+            yield ('--', 'set', table, entity, '{}={}'.format(colk, colv))
+
+
+def add_bridge(name, datapath_type=None, brdata=None, exclusive=False):
+    """Add the named bridge to openvswitch and set/update bridge data for it
+
+    :param name: Name of bridge to create
+    :type name: str
+    :param datapath_type: Add datapath_type to bridge (DEPRECATED, use brdata)
+    :type datapath_type: Optional[str]
+    :param brdata: Additional data to attach to bridge
+        The keys in the brdata dictionary map directly to column names in the
+        OpenvSwitch bridge table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type brdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if bridge exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    log('Creating bridge {}'.format(name))
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-br', name))
+    if brdata:
+        for setcmd in _dict_to_vsctl_set(brdata, 'bridge', name):
+            cmd.extend(setcmd)
+    if datapath_type is not None:
+        log('DEPRECATION WARNING: add_bridge called with datapath_type, '
+            'please use the brdata keyword argument instead.')
+        cmd += ['--', 'set', 'bridge', name,
+                'datapath_type={}'.format(datapath_type)]
+    subprocess.check_call(cmd)
+
+
+def del_bridge(name):
+    """Delete the named bridge from openvswitch
+
+    :param name: Name of bridge to remove
+    :type name: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting bridge {}'.format(name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-br", name])
+
+
+def add_bridge_port(name, port, promisc=False, ifdata=None, exclusive=False,
+                    linkup=True, portdata=None):
+    """Add port to bridge and optionally set/update interface data for it
+
+    :param name: Name of bridge to attach port to
+    :type name: str
+    :param port: Name of port as represented in netdev
+    :type port: str
+    :param promisc: Whether to set promiscuous mode on interface
+                    True=on, False=off, None leave untouched
+    :type promisc: Optional[bool]
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :param linkup: Bring link up
+    :type linkup: bool
+    :param portdata: Additional data to attach to port. Similar to ifdata.
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-port', name, port))
+    for ovs_table, data in (('Interface', ifdata), ('Port', portdata)):
+        if data:
+            for setcmd in _dict_to_vsctl_set(data, ovs_table, port):
+                cmd.extend(setcmd)
+
+    log('Adding port {} to bridge {}'.format(port, name))
+    subprocess.check_call(cmd)
+    if linkup:
+        # This is mostly a workaround for CI environments, in the real world
+        # the bare metal provider would most likely have configured and brought
+        # up the link for us.
+        subprocess.check_call(["ip", "link", "set", port, "up"])
+    if promisc:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "on"])
+    elif promisc is False:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def del_bridge_port(name, port):
+    """Delete a port from the named openvswitch bridge
+
+    :param name: Name of bridge to remove port from
+    :type name: str
+    :param port: Name of port to remove
+    :type port: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting port {} from bridge {}'.format(port, name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-port",
+                           name, port])
+    subprocess.check_call(["ip", "link", "set", port, "down"])
+    subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def add_bridge_bond(bridge, port, interfaces, portdata=None, ifdatamap=None,
+                    exclusive=False):
+    """Add bonded port in bridge from interfaces.
+
+    :param bridge: Name of bridge to add bonded port to
+    :type bridge: str
+    :param port: Name of created port
+    :type port: str
+    :param interfaces: Underlying interfaces that make up the bonded port
+    :type interfaces: Iterator[str]
+    :param portdata: Additional data to attach to the created bond port
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'bond-mode': 'balance-tcp',
+            'lacp': 'active',
+            'other-config': {
+                'lacp-time': 'fast',
+            },
+        }
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param ifdatamap: Map of data to attach to created bond interfaces
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'eth0': {
+                'type': 'dpdk',
+                'mtu-request': '9000',
+                'options': {
+                    'dpdk-devargs': '0000:01:00.0',
+                },
+            },
+        }
+    :type ifdatamap: Optional[Dict[str,Dict[str,Union[str,Dict[str,str]]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-bond', bridge, port))
+    cmd.extend(interfaces)
+    if portdata:
+        for setcmd in _dict_to_vsctl_set(portdata, 'port', port):
+            cmd.extend(setcmd)
+    if ifdatamap:
+        for ifname, ifdata in ifdatamap.items():
+            for setcmd in _dict_to_vsctl_set(ifdata, 'Interface', ifname):
+                cmd.extend(setcmd)
+    subprocess.check_call(cmd)
+
+
+def add_ovsbridge_linuxbridge(name, bridge, ifdata=None):
+    """Add linux bridge to the named openvswitch bridge
+
+    :param name: Name of ovs bridge to be added to Linux bridge
+    :type name: str
+    :param bridge: Name of Linux bridge to be added to ovs bridge
+    :type name: str
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    """
+    try:
+        import netifaces
+    except ImportError:
+        if six.PY2:
+            apt_install('python-netifaces', fatal=True)
+        else:
+            apt_install('python3-netifaces', fatal=True)
+        import netifaces
+
+    # NOTE(jamespage):
+    # Older code supported addition of a linuxbridge directly
+    # to an OVS bridge; ensure we don't break uses on upgrade
+    existing_ovs_bridge = port_to_br(bridge)
+    if existing_ovs_bridge is not None:
+        log('Linuxbridge {} is already directly in use'
+            ' by OVS bridge {}'.format(bridge, existing_ovs_bridge),
+            level=INFO)
+        return
+
+    # NOTE(jamespage):
+    # preserve existing naming because interfaces may already exist.
+    ovsbridge_port = "veth-" + name
+    linuxbridge_port = "veth-" + bridge
+    if (len(ovsbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN or
+            len(linuxbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN):
+        # NOTE(jamespage):
+        # use parts of hashed bridgename (openstack style) when
+        # a bridge name exceeds 15 chars
+        hashed_bridge = hashlib.sha256(bridge.encode('UTF-8')).hexdigest()
+        base = '{}-{}'.format(hashed_bridge[:8], hashed_bridge[-2:])
+        ovsbridge_port = "cvo{}".format(base)
+        linuxbridge_port = "cvb{}".format(base)
+
+    interfaces = netifaces.interfaces()
+    for interface in interfaces:
+        if interface == ovsbridge_port or interface == linuxbridge_port:
+            log('Interface {} already exists'.format(interface), level=INFO)
+            return
+
+    log('Adding linuxbridge {} to ovsbridge {}'.format(bridge, name),
+        level=INFO)
+
+    check_for_eni_source()
+
+    with open('/etc/network/interfaces.d/{}.cfg'.format(
+            linuxbridge_port), 'w') as config:
+        config.write(BRIDGE_TEMPLATE.format(linuxbridge_port=linuxbridge_port,
+                                            ovsbridge_port=ovsbridge_port,
+                                            bridge=bridge))
+
+    subprocess.check_call(["ifup", linuxbridge_port])
+    add_bridge_port(name, linuxbridge_port, ifdata=ifdata)
+
+
+def is_linuxbridge_interface(port):
+    ''' Check if the interface is a linuxbridge bridge
+    :param port: Name of an interface to check whether it is a Linux bridge
+    :returns: True if port is a Linux bridge'''
+
+    if os.path.exists('/sys/class/net/' + port + '/bridge'):
+        log('Interface {} is a Linux bridge'.format(port), level=DEBUG)
+        return True
+    else:
+        log('Interface {} is not a Linux bridge'.format(port), level=DEBUG)
+        return False
+
+
+def set_manager(manager):
+    ''' Set the controller for the local openvswitch '''
+    log('Setting manager for local ovs to {}'.format(manager))
+    subprocess.check_call(['ovs-vsctl', 'set-manager',
+                           'ssl:{}'.format(manager)])
+
+
+def set_Open_vSwitch_column_value(column_value):
+    """
+    Calls ovs-vsctl and sets the 'column_value' in the Open_vSwitch table.
+
+    :param column_value:
+            See http://www.openvswitch.org//ovs-vswitchd.conf.db.5.pdf for
+            details of the relevant values.
+    :type str
+    :raises CalledProcessException: possibly ovsdb-server is not running
+    """
+    log('Setting {} in the Open_vSwitch table'.format(column_value))
+    subprocess.check_call(['ovs-vsctl', 'set', 'Open_vSwitch', '.', column_value])
+
+
+CERT_PATH = '/etc/openvswitch/ovsclient-cert.pem'
+
+
+def get_certificate():
+    ''' Read openvswitch certificate from disk '''
+    if os.path.exists(CERT_PATH):
+        log('Reading ovs certificate from {}'.format(CERT_PATH))
+        with open(CERT_PATH, 'r') as cert:
+            full_cert = cert.read()
+            begin_marker = "-----BEGIN CERTIFICATE-----"
+            end_marker = "-----END CERTIFICATE-----"
+            begin_index = full_cert.find(begin_marker)
+            end_index = full_cert.rfind(end_marker)
+            if end_index == -1 or begin_index == -1:
+                raise RuntimeError("Certificate does not contain valid begin"
+                                   " and end markers.")
+            full_cert = full_cert[begin_index:(end_index + len(end_marker))]
+            return full_cert
+    else:
+        log('Certificate not found', level=WARNING)
+        return None
+
+
+def check_for_eni_source():
+    ''' Juju removes the source line when setting up interfaces,
+    replace if missing '''
+
+    with open('/etc/network/interfaces', 'r') as eni:
+        for line in eni:
+            if line == 'source /etc/network/interfaces.d/*':
+                return
+    with open('/etc/network/interfaces', 'a') as eni:
+        eni.write('\nsource /etc/network/interfaces.d/*')
+
+
+def full_restart():
+    ''' Full restart and reload of openvswitch '''
+    if os.path.exists('/etc/init/openvswitch-force-reload-kmod.conf'):
+        service('start', 'openvswitch-force-reload-kmod')
+    else:
+        service('force-reload-kmod', 'openvswitch-switch')
+
+
+def enable_ipfix(bridge, target,
+                 cache_active_timeout=60,
+                 cache_max_flows=128,
+                 sampling=64):
+    '''Enable IPFIX on bridge to target.
+    :param bridge: Bridge to monitor
+    :param target: IPFIX remote endpoint
+    :param cache_active_timeout: The maximum period in seconds for
+                                 which an IPFIX flow record is cached
+                                 and aggregated before being sent
+    :param cache_max_flows: The maximum number of IPFIX flow records
+                            that can be cached at a time
+    :param sampling: The rate at which packets should be sampled and
+                     sent to each target collector
+    '''
+    cmd = [
+        'ovs-vsctl', 'set', 'Bridge', bridge, 'ipfix=@i', '--',
+        '--id=@i', 'create', 'IPFIX',
+        'targets="{}"'.format(target),
+        'sampling={}'.format(sampling),
+        'cache_active_timeout={}'.format(cache_active_timeout),
+        'cache_max_flows={}'.format(cache_max_flows),
+    ]
+    log('Enabling IPfix on {}.'.format(bridge))
+    subprocess.check_call(cmd)
+
+
+def disable_ipfix(bridge):
+    '''Diable IPFIX on target bridge.
+    :param bridge: Bridge to modify
+    '''
+    cmd = ['ovs-vsctl', 'clear', 'Bridge', bridge, 'ipfix']
+    subprocess.check_call(cmd)
+
+
+def port_to_br(port):
+    '''Determine the bridge that contains a port
+    :param port: Name of port to check for
+    :returns str: OVS bridge containing port or None if not found
+    '''
+    try:
+        return subprocess.check_output(
+            ['ovs-vsctl', 'port-to-br', port]
+        ).decode('UTF-8').strip()
+    except subprocess.CalledProcessError:
+        return None
+
+
+def ovs_appctl(target, args):
+    """Run `ovs-appctl` for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovs-appctl` looks for a pidfile and will build the path to
+                   a /var/run/openvswitch/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovs-appctl`
+    :type args: Tuple[str, ...]
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-appctl', '-t', target]
+    cmd.extend(args)
+    return subprocess.check_output(cmd, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovn.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovn.py
new file mode 100644
index 0000000000000000000000000000000000000000..2075f11acfbeb3d0d614cf3db5a1b535bf128824
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovn.py
@@ -0,0 +1,233 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import subprocess
+import uuid
+
+from . import utils
+
+
+OVN_RUNDIR = '/var/run/ovn'
+OVN_SYSCONFDIR = '/etc/ovn'
+
+
+def ovn_appctl(target, args, rundir=None, use_ovs_appctl=False):
+    """Run ovn/ovs-appctl for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovn-appctl` looks for a pidfile and will build the path to
+                   a /var/run/ovn/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovn-appctl`
+    :type args: Tuple[str, ...]
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    # NOTE(fnordahl): The ovsdb-server processes for the OVN databases use a
+    # non-standard naming scheme for their daemon control socket and we need
+    # to pass the full path to the socket.
+    if target in ('ovnnb_db', 'ovnsb_db',):
+        target = os.path.join(rundir or OVN_RUNDIR, target + '.ctl')
+
+    if use_ovs_appctl:
+        tool = 'ovs-appctl'
+    else:
+        tool = 'ovn-appctl'
+
+    return utils._run(tool, '-t', target, *args)
+
+
+class OVNClusterStatus(object):
+
+    def __init__(self, name, cluster_id, server_id, address, status, role,
+                 term, leader, vote, election_timer, log,
+                 entries_not_yet_committed, entries_not_yet_applied,
+                 connections, servers):
+        """Initialize and populate OVNClusterStatus object.
+
+        Use class initializer so we can define types in a compatible manner.
+
+        :param name: Name of schema used for database
+        :type name: str
+        :param cluster_id: UUID of cluster
+        :type cluster_id: uuid.UUID
+        :param server_id: UUID of server
+        :type server_id: uuid.UUID
+        :param address: OVSDB connection method
+        :type address: str
+        :param status: Status text
+        :type status: str
+        :param role: Role of server
+        :type role: str
+        :param term: Election term
+        :type term: int
+        :param leader: Short form UUID of leader
+        :type leader: str
+        :param vote: Vote
+        :type vote: str
+        :param election_timer: Current value of election timer
+        :type election_timer: int
+        :param log: Log
+        :type log: str
+        :param entries_not_yet_committed: Entries not yet committed
+        :type entries_not_yet_committed: int
+        :param entries_not_yet_applied: Entries not yet applied
+        :type entries_not_yet_applied: int
+        :param connections: Connections
+        :type connections: str
+        :param servers: Servers in the cluster
+            [('0ea6', 'ssl:192.0.2.42:6643')]
+        :type servers: List[Tuple[str,str]]
+        """
+        self.name = name
+        self.cluster_id = cluster_id
+        self.server_id = server_id
+        self.address = address
+        self.status = status
+        self.role = role
+        self.term = term
+        self.leader = leader
+        self.vote = vote
+        self.election_timer = election_timer
+        self.log = log
+        self.entries_not_yet_committed = entries_not_yet_committed
+        self.entries_not_yet_applied = entries_not_yet_applied
+        self.connections = connections
+        self.servers = servers
+
+    def __eq__(self, other):
+        return (
+            self.name == other.name and
+            self.cluster_id == other.cluster_id and
+            self.server_id == other.server_id and
+            self.address == other.address and
+            self.status == other.status and
+            self.role == other.role and
+            self.term == other.term and
+            self.leader == other.leader and
+            self.vote == other.vote and
+            self.election_timer == other.election_timer and
+            self.log == other.log and
+            self.entries_not_yet_committed == other.entries_not_yet_committed and
+            self.entries_not_yet_applied == other.entries_not_yet_applied and
+            self.connections == other.connections and
+            self.servers == other.servers)
+
+    @property
+    def is_cluster_leader(self):
+        """Retrieve status information from clustered OVSDB.
+
+        :returns: Whether target is cluster leader
+        :rtype: bool
+        """
+        return self.leader == 'self'
+
+
+def cluster_status(target, schema=None, use_ovs_appctl=False, rundir=None):
+    """Retrieve status information from clustered OVSDB.
+
+    :param target: Usually one of 'ovsdb-server', 'ovnnb_db', 'ovnsb_db', can
+                   also be full path to control socket.
+    :type target: str
+    :param schema: Database schema name, deduced from target if not provided
+    :type schema: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :returns: cluster status data object
+    :rtype: OVNClusterStatus
+    :raises: subprocess.CalledProcessError, KeyError, RuntimeError
+    """
+    schema_map = {
+        'ovnnb_db': 'OVN_Northbound',
+        'ovnsb_db': 'OVN_Southbound',
+    }
+    if schema and schema not in schema_map.keys():
+        raise RuntimeError('Unknown schema provided: "{}"'.format(schema))
+
+    status = {}
+    k = ''
+    for line in ovn_appctl(target,
+                           ('cluster/status', schema or schema_map[target]),
+                           rundir=rundir,
+                           use_ovs_appctl=use_ovs_appctl).splitlines():
+        if k and line.startswith(' '):
+            # there is no key which means this is a instance of a multi-line/
+            # multi-value item, populate the List which is already stored under
+            # the key.
+            if k == 'servers':
+                status[k].append(
+                    tuple(line.replace(')', '').lstrip().split()[0:4:3]))
+            else:
+                status[k].append(line.lstrip())
+        elif ':' in line:
+            # this is a line with a key
+            k, v = line.split(':', 1)
+            k = k.lower()
+            k = k.replace(' ', '_')
+            if v:
+                # this is a line with both key and value
+                if k in ('cluster_id', 'server_id',):
+                    v = v.replace('(', '')
+                    v = v.replace(')', '')
+                    status[k] = tuple(v.split())
+                else:
+                    status[k] = v.lstrip()
+            else:
+                # this is a line with only key which means a multi-line/
+                # multi-value item.  Store key as List which will be
+                # populated on subsequent iterations.
+                status[k] = []
+    return OVNClusterStatus(
+        status['name'],
+        uuid.UUID(status['cluster_id'][1]),
+        uuid.UUID(status['server_id'][1]),
+        status['address'],
+        status['status'],
+        status['role'],
+        int(status['term']),
+        status['leader'],
+        status['vote'],
+        int(status['election_timer']),
+        status['log'],
+        int(status['entries_not_yet_committed']),
+        int(status['entries_not_yet_applied']),
+        status['connections'],
+        status['servers'])
+
+
+def is_northd_active():
+    """Query `ovn-northd` for active status.
+
+    Note that the active status information for ovn-northd is available for
+    OVN 20.03 and onward.
+
+    :returns: True if local `ovn-northd` instance is active, False otherwise
+    :rtype: bool
+    """
+    try:
+        for line in ovn_appctl('ovn-northd', ('status',)).splitlines():
+            if line.startswith('Status:') and 'active' in line:
+                return True
+    except subprocess.CalledProcessError:
+        pass
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovsdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e50bc36333bde56674a82ad6c88e0d5de44ee07
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/ovsdb.py
@@ -0,0 +1,206 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+import uuid
+
+from . import utils
+
+
+class SimpleOVSDB(object):
+    """Simple interface to OVSDB through the use of command line tools.
+
+    OVS and OVN is managed through a set of databases.  These databases have
+    similar command line tools to manage them.  We make use of the similarity
+    to provide a generic class that can be used to manage them.
+
+    The OpenvSwitch project does provide a Python API, but on the surface it
+    appears to be a bit too involved for our simple use case.
+
+    Examples:
+    sbdb = SimpleOVSDB('ovn-sbctl')
+    for chs in sbdb.chassis:
+        print(chs)
+
+    ovsdb = SimpleOVSDB('ovs-vsctl')
+    for br in ovsdb.bridge:
+        if br['name'] == 'br-test':
+            ovsdb.bridge.set(br['uuid'], 'external_ids:charm', 'managed')
+    """
+
+    # For validation we keep a complete map of currently known good tool and
+    # table combinations.  This requires maintenance down the line whenever
+    # upstream adds things that downstream wants, and the cost of maintaining
+    # that will most likely be lower then the cost of finding the needle in
+    # the haystack whenever downstream code misspells something.
+    _tool_table_map = {
+        'ovs-vsctl': (
+            'autoattach',
+            'bridge',
+            'ct_timeout_policy',
+            'ct_zone',
+            'controller',
+            'datapath',
+            'flow_sample_collector_set',
+            'flow_table',
+            'ipfix',
+            'interface',
+            'manager',
+            'mirror',
+            'netflow',
+            'open_vswitch',
+            'port',
+            'qos',
+            'queue',
+            'ssl',
+            'sflow',
+        ),
+        'ovn-nbctl': (
+            'acl',
+            'address_set',
+            'connection',
+            'dhcp_options',
+            'dns',
+            'forwarding_group',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'load_balancer',
+            'load_balancer_health_check',
+            'logical_router',
+            'logical_router_policy',
+            'logical_router_port',
+            'logical_router_static_route',
+            'logical_switch',
+            'logical_switch_port',
+            'meter',
+            'meter_band',
+            'nat',
+            'nb_global',
+            'port_group',
+            'qos',
+            'ssl',
+        ),
+        'ovn-sbctl': (
+            'address_set',
+            'chassis',
+            'connection',
+            'controller_event',
+            'dhcp_options',
+            'dhcpv6_options',
+            'dns',
+            'datapath_binding',
+            'encap',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'igmp_group',
+            'ip_multicast',
+            'logical_flow',
+            'mac_binding',
+            'meter',
+            'meter_band',
+            'multicast_group',
+            'port_binding',
+            'port_group',
+            'rbac_permission',
+            'rbac_role',
+            'sb_global',
+            'ssl',
+            'service_monitor',
+        ),
+    }
+
+    def __init__(self, tool):
+        """SimpleOVSDB constructor.
+
+        :param tool: Which tool with database commands to operate on.
+                     Usually one of `ovs-vsctl`, `ovn-nbctl`, `ovn-sbctl`
+        :type tool: str
+        """
+        if tool not in self._tool_table_map:
+            raise RuntimeError(
+                'tool must be one of "{}"'.format(self._tool_table_map.keys()))
+        self._tool = tool
+
+    def __getattr__(self, table):
+        if table not in self._tool_table_map[self._tool]:
+            raise AttributeError(
+                'table "{}" not known for use with "{}"'
+                .format(table, self._tool))
+        return self.Table(self._tool, table)
+
+    class Table(object):
+        """Methods to interact with contents of OVSDB tables.
+
+        NOTE: At the time of this writing ``find`` is the only command
+        line argument to OVSDB manipulating tools that actually supports
+        JSON output.
+        """
+
+        def __init__(self, tool, table):
+            """SimpleOVSDBTable constructor.
+
+            :param table: Which table to operate on
+            :type table: str
+            """
+            self._tool = tool
+            self._table = table
+
+        def _find_tbl(self, condition=None):
+            """Run and parse output of OVSDB `find` command.
+
+            :param condition: An optional RFC 7047 5.1 match condition
+            :type condition: Optional[str]
+            :returns: Dictionary with data
+            :rtype: Dict[str, any]
+            """
+            # When using json formatted output to OVS commands Internal OVSDB
+            # notation may occur that require further deserializing.
+            # Reference: https://tools.ietf.org/html/rfc7047#section-5.1
+            ovs_type_cb_map = {
+                'uuid': uuid.UUID,
+                # FIXME sets also appear to sometimes contain type/value tuples
+                'set': list,
+                'map': dict,
+            }
+            cmd = [self._tool, '-f', 'json', 'find', self._table]
+            if condition:
+                cmd.append(condition)
+            output = utils._run(*cmd)
+            data = json.loads(output)
+            for row in data['data']:
+                values = []
+                for col in row:
+                    if isinstance(col, list):
+                        f = ovs_type_cb_map.get(col[0], str)
+                        values.append(f(col[1]))
+                    else:
+                        values.append(col)
+                yield dict(zip(data['headings'], values))
+
+        def __iter__(self):
+            return self._find_tbl()
+
+        def clear(self, rec, col):
+            utils._run(self._tool, 'clear', self._table, rec, col)
+
+        def find(self, condition):
+            return self._find_tbl(condition=condition)
+
+        def remove(self, rec, col, value):
+            utils._run(self._tool, 'remove', self._table, rec, col, value)
+
+        def set(self, rec, col, value):
+            utils._run(self._tool, 'set', self._table, rec,
+                       '{}={}'.format(col, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..53c9b4ddab6d68d2478d4161e658c70e2caa6a74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ovs/utils.py
@@ -0,0 +1,26 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import subprocess
+
+
+def _run(*args):
+    """Run a process, check result, capture decoded output from STDOUT.
+
+    :param args: Command and arguments to run
+    :type args: Tuple[str, ...]
+    :returns: Information about the completed process
+    :rtype: str
+    :raises subprocess.CalledProcessError
+    """
+    return subprocess.check_output(args, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ufw.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ufw.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9bf7c9df5576615e23225a7fdb6c11a28931ba4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/network/ufw.py
@@ -0,0 +1,386 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module contains helpers to add and remove ufw rules.
+
+Examples:
+
+- open SSH port for subnet 10.0.3.0/24:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.grant_access(src='10.0.3.0/24', dst='any', port='22', proto='tcp')
+
+- open service by name as defined in /etc/services:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('ssh', 'open')
+
+- close service by port number:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('4949', 'close')  # munin
+"""
+import os
+import re
+import subprocess
+
+from charmhelpers.core import hookenv
+from charmhelpers.core.kernel import modprobe, is_module_loaded
+
+__author__ = "Felipe Reyes <felipe.reyes@canonical.com>"
+
+
+class UFWError(Exception):
+    pass
+
+
+class UFWIPv6Error(UFWError):
+    pass
+
+
+def is_enabled():
+    """
+    Check if `ufw` is enabled
+
+    :returns: True if ufw is enabled
+    """
+    output = subprocess.check_output(['ufw', 'status'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Status: active\n', output, re.M)
+
+    return len(m) >= 1
+
+
+def is_ipv6_ok(soft_fail=False):
+    """
+    Check if IPv6 support is present and ip6tables functional
+
+    :param soft_fail: If set to True and IPv6 support is broken, then reports
+                      that the host doesn't have IPv6 support, otherwise a
+                      UFWIPv6Error exception is raised.
+    :returns: True if IPv6 is working, False otherwise
+    """
+
+    # do we have IPv6 in the machine?
+    if os.path.isdir('/proc/sys/net/ipv6'):
+        # is ip6tables kernel module loaded?
+        if not is_module_loaded('ip6_tables'):
+            # ip6tables support isn't complete, let's try to load it
+            try:
+                modprobe('ip6_tables')
+                # great, we can load the module
+                return True
+            except subprocess.CalledProcessError as ex:
+                hookenv.log("Couldn't load ip6_tables module: %s" % ex.output,
+                            level="WARN")
+                # we are in a world where ip6tables isn't working
+                if soft_fail:
+                    # so we inform that the machine doesn't have IPv6
+                    return False
+                else:
+                    raise UFWIPv6Error("IPv6 firewall support broken")
+        else:
+            # the module is present :)
+            return True
+
+    else:
+        # the system doesn't have IPv6
+        return False
+
+
+def disable_ipv6():
+    """
+    Disable ufw IPv6 support in /etc/default/ufw
+    """
+    exit_code = subprocess.call(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+    if exit_code == 0:
+        hookenv.log('IPv6 support in ufw disabled', level='INFO')
+    else:
+        hookenv.log("Couldn't disable IPv6 support in ufw", level="ERROR")
+        raise UFWError("Couldn't disable IPv6 support in ufw")
+
+
+def enable(soft_fail=False):
+    """
+    Enable ufw
+
+    :param soft_fail: If set to True silently disables IPv6 support in ufw,
+                      otherwise a UFWIPv6Error exception is raised when IP6
+                      support is broken.
+    :returns: True if ufw is successfully enabled
+    """
+    if is_enabled():
+        return True
+
+    if not is_ipv6_ok(soft_fail):
+        disable_ipv6()
+
+    output = subprocess.check_output(['ufw', 'enable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall is active and enabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be enabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw enabled", level='INFO')
+        return True
+
+
+def reload():
+    """
+    Reload ufw
+
+    :returns: True if ufw is successfully enabled
+    """
+    output = subprocess.check_output(['ufw', 'reload'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall reloaded\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be reloaded", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw reloaded", level='INFO')
+        return True
+
+
+def disable():
+    """
+    Disable ufw
+
+    :returns: True if ufw is successfully disabled
+    """
+    if not is_enabled():
+        return True
+
+    output = subprocess.check_output(['ufw', 'disable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Firewall stopped and disabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be disabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw disabled", level='INFO')
+        return True
+
+
+def default_policy(policy='deny', direction='incoming'):
+    """
+    Changes the default policy for traffic `direction`
+
+    :param policy: allow, deny or reject
+    :param direction: traffic direction, possible values: incoming, outgoing,
+                      routed
+    """
+    if policy not in ['allow', 'deny', 'reject']:
+        raise UFWError(('Unknown policy %s, valid values: '
+                        'allow, deny, reject') % policy)
+
+    if direction not in ['incoming', 'outgoing', 'routed']:
+        raise UFWError(('Unknown direction %s, valid values: '
+                        'incoming, outgoing, routed') % direction)
+
+    output = subprocess.check_output(['ufw', 'default', policy, direction],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+    hookenv.log(output, level='DEBUG')
+
+    m = re.findall("^Default %s policy changed to '%s'\n" % (direction,
+                                                             policy),
+                   output, re.M)
+    if len(m) == 0:
+        hookenv.log("ufw couldn't change the default policy to %s for %s"
+                    % (policy, direction), level='WARN')
+        return False
+    else:
+        hookenv.log("ufw default policy for %s changed to %s"
+                    % (direction, policy), level='INFO')
+        return True
+
+
+def modify_access(src, dst='any', port=None, proto=None, action='allow',
+                  index=None, prepend=False, comment=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :type src: Optional[str]
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :type dst: Optional[str]
+    :param port: destiny port
+    :type port: Optional[int]
+    :param proto: protocol (tcp or udp)
+    :type proto: Optional[str]
+    :param action: `allow` or `delete`
+    :type action: str
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    :type index: Optional[int]
+    :param prepend: Whether to insert the rule before all other rules matching
+                    the rule's IP type.
+    :type prepend: bool
+    :param comment: Create the rule with a comment
+    :type comment: Optional[str]
+    """
+    if not is_enabled():
+        hookenv.log('ufw is disabled, skipping modify_access()', level='WARN')
+        return
+
+    if action == 'delete':
+        if index is not None:
+            cmd = ['ufw', '--force', 'delete', str(index)]
+        else:
+            cmd = ['ufw', 'delete', 'allow']
+    elif index is not None:
+        cmd = ['ufw', 'insert', str(index), action]
+    elif prepend:
+        cmd = ['ufw', 'prepend', action]
+    else:
+        cmd = ['ufw', action]
+
+    if src is not None:
+        cmd += ['from', src]
+
+    if dst is not None:
+        cmd += ['to', dst]
+
+    if port is not None:
+        cmd += ['port', str(port)]
+
+    if proto is not None:
+        cmd += ['proto', proto]
+
+    if comment:
+        cmd.extend(['comment', comment])
+
+    hookenv.log('ufw {}: {}'.format(action, ' '.join(cmd)), level='DEBUG')
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE)
+    (stdout, stderr) = p.communicate()
+
+    hookenv.log(stdout, level='INFO')
+
+    if p.returncode != 0:
+        hookenv.log(stderr, level='ERROR')
+        hookenv.log('Error running: {}, exit code: {}'.format(' '.join(cmd),
+                                                              p.returncode),
+                    level='ERROR')
+
+
+def grant_access(src, dst='any', port=None, proto=None, index=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='allow',
+                         index=index)
+
+
+def revoke_access(src, dst='any', port=None, proto=None):
+    """
+    Revoke access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='delete')
+
+
+def service(name, action):
+    """
+    Open/close access to a service
+
+    :param name: could be a service name defined in `/etc/services` or a port
+                 number.
+    :param action: `open` or `close`
+    """
+    if action == 'open':
+        subprocess.check_output(['ufw', 'allow', str(name)],
+                                universal_newlines=True)
+    elif action == 'close':
+        subprocess.check_output(['ufw', 'delete', 'allow', str(name)],
+                                universal_newlines=True)
+    else:
+        raise UFWError(("'{}' not supported, use 'allow' "
+                        "or 'delete'").format(action))
+
+
+def status():
+    """Retrieve firewall rules as represented by UFW.
+
+    :returns: Tuples with rule number and data
+        (1, {'to': '', 'action':, 'from':, '', ipv6: True, 'comment': ''})
+    :rtype: Iterator[Tuple[int, Dict[str, Union[bool, str]]]]
+    """
+    cp = subprocess.check_output(('ufw', 'status', 'numbered',),
+                                 stderr=subprocess.STDOUT,
+                                 universal_newlines=True)
+    for line in cp.splitlines():
+        if not line.startswith('['):
+            continue
+        ipv6 = True if '(v6)' in line else False
+        line = line.replace('(v6)', '')
+        line = line.replace('[', '')
+        line = line.replace(']', '')
+        line = line.replace('Anywhere', 'any')
+        row = line.split()
+        yield (int(row[0]), {
+            'to': row[1],
+            'action': ' '.join(row[2:4]).lower(),
+            'from': row[4],
+            'ipv6': ipv6,
+            'comment': row[6] if len(row) > 5 and row[5] == '#' else '',
+        })
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/alternatives.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/alternatives.py
new file mode 100644
index 0000000000000000000000000000000000000000..547de09c6d818772191b519618fa32b08b0e6eff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/alternatives.py
@@ -0,0 +1,44 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helper for managing alternatives for file conflict resolution '''
+
+import subprocess
+import shutil
+import os
+
+
+def install_alternative(name, target, source, priority=50):
+    ''' Install alternative configuration '''
+    if (os.path.exists(target) and not os.path.islink(target)):
+        # Move existing file/directory away before installing
+        shutil.move(target, '{}.bak'.format(target))
+    cmd = [
+        'update-alternatives', '--force', '--install',
+        target, name, source, str(priority)
+    ]
+    subprocess.check_call(cmd)
+
+
+def remove_alternative(name, source):
+    """Remove an installed alternative configuration file
+
+    :param name: string name of the alternative to remove
+    :param source: string full path to alternative to remove
+    """
+    cmd = [
+        'update-alternatives', '--remove',
+        name, source
+    ]
+    subprocess.check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd3aebe97dd04bf42a2c4ee7c7b7b83b1917a678
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/deployment.py
@@ -0,0 +1,384 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import os
+import re
+import sys
+import six
+from collections import OrderedDict
+from charmhelpers.contrib.amulet.deployment import (
+    AmuletDeployment
+)
+from charmhelpers.contrib.openstack.amulet.utils import (
+    OPENSTACK_RELEASES_PAIRS
+)
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+
+class OpenStackAmuletDeployment(AmuletDeployment):
+    """OpenStack amulet deployment.
+
+       This class inherits from AmuletDeployment and has additional support
+       that is specifically for use by OpenStack charms.
+       """
+
+    def __init__(self, series=None, openstack=None, source=None,
+                 stable=True, log_level=DEBUG):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletDeployment, self).__init__(series)
+        self.log = self.get_logger(level=log_level)
+        self.log.info('OpenStackAmuletDeployment:  init')
+        self.openstack = openstack
+        self.source = source
+        self.stable = stable
+
+    def get_logger(self, name="deployment-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def _determine_branch_locations(self, other_services):
+        """Determine the branch locations for the other services.
+
+           Determine if the local branch being tested is derived from its
+           stable or next (dev) branch, and based on this, use the corresonding
+           stable or next branches for the other_services."""
+
+        self.log.info('OpenStackAmuletDeployment:  determine branch locations')
+
+        # Charms outside the ~openstack-charmers
+        base_charms = {
+            'mysql': ['trusty'],
+            'mongodb': ['trusty'],
+            'nrpe': ['trusty', 'xenial'],
+        }
+
+        for svc in other_services:
+            # If a location has been explicitly set, use it
+            if svc.get('location'):
+                continue
+            if svc['name'] in base_charms:
+                # NOTE: not all charms have support for all series we
+                #       want/need to test against, so fix to most recent
+                #       that each base charm supports
+                target_series = self.series
+                if self.series not in base_charms[svc['name']]:
+                    target_series = base_charms[svc['name']][-1]
+                svc['location'] = 'cs:{}/{}'.format(target_series,
+                                                    svc['name'])
+            elif self.stable:
+                svc['location'] = 'cs:{}/{}'.format(self.series,
+                                                    svc['name'])
+            else:
+                svc['location'] = 'cs:~openstack-charmers-next/{}/{}'.format(
+                    self.series,
+                    svc['name']
+                )
+
+        return other_services
+
+    def _add_services(self, this_service, other_services, use_source=None,
+                      no_origin=None):
+        """Add services to the deployment and optionally set
+        openstack-origin/source.
+
+        :param this_service dict: Service dictionary describing the service
+                                  whose amulet tests are being run
+        :param other_services dict: List of service dictionaries describing
+                                    the services needed to support the target
+                                    service
+        :param use_source list: List of services which use the 'source' config
+                                option rather than 'openstack-origin'
+        :param no_origin list: List of services which do not support setting
+                               the Cloud Archive.
+        Service Dict:
+            {
+                'name': str charm-name,
+                'units': int number of units,
+                'constraints': dict of juju constraints,
+                'location': str location of charm,
+            }
+        eg
+        this_service = {
+            'name': 'openvswitch-odl',
+            'constraints': {'mem': '8G'},
+        }
+        other_services = [
+            {
+                'name': 'nova-compute',
+                'units': 2,
+                'constraints': {'mem': '4G'},
+                'location': cs:~bob/xenial/nova-compute
+            },
+            {
+                'name': 'mysql',
+                'constraints': {'mem': '2G'},
+            },
+            {'neutron-api-odl'}]
+        use_source = ['mysql']
+        no_origin = ['neutron-api-odl']
+        """
+        self.log.info('OpenStackAmuletDeployment:  adding services')
+
+        other_services = self._determine_branch_locations(other_services)
+
+        super(OpenStackAmuletDeployment, self)._add_services(this_service,
+                                                             other_services)
+
+        services = other_services
+        services.append(this_service)
+
+        use_source = use_source or []
+        no_origin = no_origin or []
+
+        # Charms which should use the source config option
+        use_source = list(set(
+            use_source + ['mysql', 'mongodb', 'rabbitmq-server', 'ceph',
+                          'ceph-osd', 'ceph-radosgw', 'ceph-mon',
+                          'ceph-proxy', 'percona-cluster', 'lxd']))
+
+        # Charms which can not use openstack-origin, ie. many subordinates
+        no_origin = list(set(
+            no_origin + ['cinder-ceph', 'hacluster', 'neutron-openvswitch',
+                         'nrpe', 'openvswitch-odl', 'neutron-api-odl',
+                         'odl-controller', 'cinder-backup', 'nexentaedge-data',
+                         'nexentaedge-iscsi-gw', 'nexentaedge-swift-gw',
+                         'cinder-nexentaedge', 'nexentaedge-mgmt',
+                         'ceilometer-agent']))
+
+        if self.openstack:
+            for svc in services:
+                if svc['name'] not in use_source + no_origin:
+                    config = {'openstack-origin': self.openstack}
+                    self.d.configure(svc['name'], config)
+
+        if self.source:
+            for svc in services:
+                if svc['name'] in use_source and svc['name'] not in no_origin:
+                    config = {'source': self.source}
+                    self.d.configure(svc['name'], config)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        self.log.info('OpenStackAmuletDeployment:  configure services')
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _auto_wait_for_status(self, message=None, exclude_services=None,
+                              include_only=None, timeout=None):
+        """Wait for all units to have a specific extended status, except
+        for any defined as excluded.  Unless specified via message, any
+        status containing any case of 'ready' will be considered a match.
+
+        Examples of message usage:
+
+          Wait for all unit status to CONTAIN any case of 'ready' or 'ok':
+              message = re.compile('.*ready.*|.*ok.*', re.IGNORECASE)
+
+          Wait for all units to reach this status (exact match):
+              message = re.compile('^Unit is ready and clustered$')
+
+          Wait for all units to reach any one of these (exact match):
+              message = re.compile('Unit is ready|OK|Ready')
+
+          Wait for at least one unit to reach this status (exact match):
+              message = {'ready'}
+
+        See Amulet's sentry.wait_for_messages() for message usage detail.
+        https://github.com/juju/amulet/blob/master/amulet/sentry.py
+
+        :param message: Expected status match
+        :param exclude_services: List of juju service names to ignore,
+            not to be used in conjuction with include_only.
+        :param include_only: List of juju service names to exclusively check,
+            not to be used in conjuction with exclude_services.
+        :param timeout: Maximum time in seconds to wait for status match
+        :returns: None.  Raises if timeout is hit.
+        """
+        if not timeout:
+            timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 1800))
+        self.log.info('Waiting for extended status on units for {}s...'
+                      ''.format(timeout))
+
+        all_services = self.d.services.keys()
+
+        if exclude_services and include_only:
+            raise ValueError('exclude_services can not be used '
+                             'with include_only')
+
+        if message:
+            if isinstance(message, re._pattern_type):
+                match = message.pattern
+            else:
+                match = message
+
+            self.log.debug('Custom extended status wait match: '
+                           '{}'.format(match))
+        else:
+            self.log.debug('Default extended status wait match:  contains '
+                           'READY (case-insensitive)')
+            message = re.compile('.*ready.*', re.IGNORECASE)
+
+        if exclude_services:
+            self.log.debug('Excluding services from extended status match: '
+                           '{}'.format(exclude_services))
+        else:
+            exclude_services = []
+
+        if include_only:
+            services = include_only
+        else:
+            services = list(set(all_services) - set(exclude_services))
+
+        self.log.debug('Waiting up to {}s for extended status on services: '
+                       '{}'.format(timeout, services))
+        service_messages = {service: message for service in services}
+
+        # Check for idleness
+        self.d.sentry.wait(timeout=timeout)
+        # Check for error states and bail early
+        self.d.sentry.wait_for_status(self.d.juju_env, services, timeout=timeout)
+        # Check for ready messages
+        self.d.sentry.wait_for_messages(service_messages, timeout=timeout)
+
+        self.log.info('OK')
+
+    def _get_openstack_release(self):
+        """Get openstack release.
+
+           Return an integer representing the enum value of the openstack
+           release.
+           """
+        # Must be ordered by OpenStack release (not by Ubuntu release):
+        for i, os_pair in enumerate(OPENSTACK_RELEASES_PAIRS):
+            setattr(self, os_pair, i)
+
+        releases = {
+            ('trusty', None): self.trusty_icehouse,
+            ('trusty', 'cloud:trusty-kilo'): self.trusty_kilo,
+            ('trusty', 'cloud:trusty-liberty'): self.trusty_liberty,
+            ('trusty', 'cloud:trusty-mitaka'): self.trusty_mitaka,
+            ('xenial', None): self.xenial_mitaka,
+            ('xenial', 'cloud:xenial-newton'): self.xenial_newton,
+            ('xenial', 'cloud:xenial-ocata'): self.xenial_ocata,
+            ('xenial', 'cloud:xenial-pike'): self.xenial_pike,
+            ('xenial', 'cloud:xenial-queens'): self.xenial_queens,
+            ('yakkety', None): self.yakkety_newton,
+            ('zesty', None): self.zesty_ocata,
+            ('artful', None): self.artful_pike,
+            ('bionic', None): self.bionic_queens,
+            ('bionic', 'cloud:bionic-rocky'): self.bionic_rocky,
+            ('bionic', 'cloud:bionic-stein'): self.bionic_stein,
+            ('bionic', 'cloud:bionic-train'): self.bionic_train,
+            ('bionic', 'cloud:bionic-ussuri'): self.bionic_ussuri,
+            ('cosmic', None): self.cosmic_rocky,
+            ('disco', None): self.disco_stein,
+            ('eoan', None): self.eoan_train,
+            ('focal', None): self.focal_ussuri,
+        }
+        return releases[(self.series, self.openstack)]
+
+    def _get_openstack_release_string(self):
+        """Get openstack release string.
+
+           Return a string representing the openstack release.
+           """
+        releases = OrderedDict([
+            ('trusty', 'icehouse'),
+            ('xenial', 'mitaka'),
+            ('yakkety', 'newton'),
+            ('zesty', 'ocata'),
+            ('artful', 'pike'),
+            ('bionic', 'queens'),
+            ('cosmic', 'rocky'),
+            ('disco', 'stein'),
+            ('eoan', 'train'),
+            ('focal', 'ussuri'),
+        ])
+        if self.openstack:
+            os_origin = self.openstack.split(':')[1]
+            return os_origin.split('%s-' % self.series)[1].split('/')[0]
+        else:
+            return releases[self.series]
+
+    def get_percona_service_entry(self, memory_constraint=None):
+        """Return a amulet service entry for percona cluster.
+
+        :param memory_constraint: Override the default memory constraint
+                                  in the service entry.
+        :type memory_constraint: str
+        :returns: Amulet service entry.
+        :rtype: dict
+        """
+        memory_constraint = memory_constraint or '3072M'
+        svc_entry = {
+            'name': 'percona-cluster',
+            'constraints': {'mem': memory_constraint}}
+        if self._get_openstack_release() <= self.trusty_mitaka:
+            svc_entry['location'] = 'cs:trusty/percona-cluster'
+        return svc_entry
+
+    def get_ceph_expected_pools(self, radosgw=False):
+        """Return a list of expected ceph pools in a ceph + cinder + glance
+        test scenario, based on OpenStack release and whether ceph radosgw
+        is flagged as present or not."""
+
+        if self._get_openstack_release() == self.trusty_icehouse:
+            # Icehouse
+            pools = [
+                'data',
+                'metadata',
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        elif (self.trusty_kilo <= self._get_openstack_release() <=
+              self.zesty_ocata):
+            # Kilo through Ocata
+            pools = [
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        else:
+            # Pike and later
+            pools = [
+                'cinder-ceph',
+                'glance'
+            ]
+
+        if radosgw:
+            pools.extend([
+                '.rgw.root',
+                '.rgw.control',
+                '.rgw',
+                '.rgw.gc',
+                '.users.uid'
+            ])
+
+        return pools
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..14864198926b82afe382d07263034b020ad43c09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/amulet/utils.py
@@ -0,0 +1,1593 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import json
+import logging
+import os
+import re
+import six
+import time
+import urllib
+import urlparse
+
+import cinderclient.v1.client as cinder_client
+import cinderclient.v2.client as cinder_clientv2
+import glanceclient.v1 as glance_client
+import glanceclient.v2 as glance_clientv2
+import heatclient.v1.client as heat_client
+from keystoneclient.v2_0 import client as keystone_client
+from keystoneauth1.identity import (
+    v3,
+    v2,
+)
+from keystoneauth1 import session as keystone_session
+from keystoneclient.v3 import client as keystone_client_v3
+from novaclient import exceptions
+
+import novaclient.client as nova_client
+import novaclient
+import pika
+import swiftclient
+
+from charmhelpers.core.decorators import retry_on_exception
+from charmhelpers.contrib.amulet.utils import (
+    AmuletUtils
+)
+from charmhelpers.core.host import CompareHostReleases
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+NOVA_CLIENT_VERSION = "2"
+
+OPENSTACK_RELEASES_PAIRS = [
+    'trusty_icehouse', 'trusty_kilo', 'trusty_liberty',
+    'trusty_mitaka', 'xenial_mitaka',
+    'xenial_newton', 'yakkety_newton',
+    'xenial_ocata', 'zesty_ocata',
+    'xenial_pike', 'artful_pike',
+    'xenial_queens', 'bionic_queens',
+    'bionic_rocky', 'cosmic_rocky',
+    'bionic_stein', 'disco_stein',
+    'bionic_train', 'eoan_train',
+    'bionic_ussuri', 'focal_ussuri',
+]
+
+
+class OpenStackAmuletUtils(AmuletUtils):
+    """OpenStack amulet utilities.
+
+       This class inherits from AmuletUtils and has additional support
+       that is specifically for use by OpenStack charm tests.
+       """
+
+    def __init__(self, log_level=ERROR):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletUtils, self).__init__(log_level)
+
+    def validate_endpoint_data(self, endpoints, admin_port, internal_port,
+                               public_port, expected, openstack_release=None):
+        """Validate endpoint data. Pick the correct validator based on
+           OpenStack release. Expected data should be in the v2 format:
+           {
+               'id': id,
+               'region': region,
+               'adminurl': adminurl,
+               'internalurl': internalurl,
+               'publicurl': publicurl,
+               'service_id': service_id}
+
+           """
+        validation_function = self.validate_v2_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_endpoint_data
+            expected = {
+                'id': expected['id'],
+                'region': expected['region'],
+                'region_id': 'RegionOne',
+                'url': self.valid_url,
+                'interface': self.not_null,
+                'service_id': expected['service_id']}
+        return validation_function(endpoints, admin_port, internal_port,
+                                   public_port, expected)
+
+    def validate_v2_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected):
+        """Validate endpoint data.
+
+           Validate actual endpoint data vs expected endpoint data. The ports
+           are used to find the matching endpoint.
+           """
+        self.log.debug('Validating endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = False
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if (admin_port in ep.adminurl and
+                    internal_port in ep.internalurl and
+                    public_port in ep.publicurl):
+                found = True
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'adminurl': ep.adminurl,
+                          'internalurl': ep.internalurl,
+                          'publicurl': ep.publicurl,
+                          'service_id': ep.service_id}
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if not found:
+            return 'endpoint not found'
+
+    def validate_v3_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected, expected_num_eps=3):
+        """Validate keystone v3 endpoint data.
+
+        Validate the v3 endpoint data which has changed from v2.  The
+        ports are used to find the matching endpoint.
+
+        The new v3 endpoint data looks like:
+
+        [<Endpoint enabled=True,
+                   id=0432655fc2f74d1e9fa17bdaa6f6e60b,
+                   interface=admin,
+                   links={u'self': u'<RESTful URL of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=17f842a0dc084b928e476fafe67e4095,
+                   url=http://10.5.6.5:9312>,
+         <Endpoint enabled=True,
+                   id=6536cb6cb92f4f41bf22b079935c7707,
+                   interface=admin,
+                   links={u'self': u'<RESTful url of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=72fc8736fb41435e8b3584205bb2cfa3,
+                   url=http://10.5.6.6:35357/v3>,
+                   ... ]
+        """
+        self.log.debug('Validating v3 endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = []
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if ((admin_port in ep.url and ep.interface == 'admin') or
+                    (internal_port in ep.url and ep.interface == 'internal') or
+                    (public_port in ep.url and ep.interface == 'public')):
+                found.append(ep.interface)
+                # note we ignore the links member.
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'region_id': ep.region_id,
+                          'interface': self.not_null,
+                          'url': ep.url,
+                          'service_id': ep.service_id, }
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if len(found) != expected_num_eps:
+            return 'Unexpected number of endpoints found'
+
+    def convert_svc_catalog_endpoint_data_to_v3(self, ep_data):
+        """Convert v2 endpoint data into v3.
+
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+          """
+        self.log.warn("Endpoint ID and Region ID validation is limited to not "
+                      "null checks after v2 to v3 conversion")
+        for svc in ep_data.keys():
+            assert len(ep_data[svc]) == 1, "Unknown data format"
+            svc_ep_data = ep_data[svc][0]
+            ep_data[svc] = [
+                {
+                    'url': svc_ep_data['adminURL'],
+                    'interface': 'admin',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['publicURL'],
+                    'interface': 'public',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['internalURL'],
+                    'interface': 'internal',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null}]
+        return ep_data
+
+    def validate_svc_catalog_endpoint_data(self, expected, actual,
+                                           openstack_release=None):
+        """Validate service catalog endpoint data. Pick the correct validator
+           for the OpenStack version. Expected data should be in the v2 format:
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+
+           """
+        validation_function = self.validate_v2_svc_catalog_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_svc_catalog_endpoint_data
+            expected = self.convert_svc_catalog_endpoint_data_to_v3(expected)
+        return validation_function(expected, actual)
+
+    def validate_v2_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate service catalog endpoint data.
+
+           Validate a list of actual service catalog endpoints vs a list of
+           expected service catalog endpoints.
+           """
+        self.log.debug('Validating service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                ret = self._validate_dict_data(expected[k][0], actual[k][0])
+                if ret:
+                    return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_v3_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate the keystone v3 catalog endpoint data.
+
+        Validate a list of dictinaries that make up the keystone v3 service
+        catalogue.
+
+        It is in the form of:
+
+
+        {u'identity': [{u'id': u'48346b01c6804b298cdd7349aadb732e',
+                        u'interface': u'admin',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:35357/v3'},
+                       {u'id': u'8414f7352a4b47a69fddd9dbd2aef5cf',
+                        u'interface': u'public',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'},
+                       {u'id': u'd5ca31440cc24ee1bf625e2996fb6a5b',
+                        u'interface': u'internal',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'}],
+         u'key-manager': [{u'id': u'68ebc17df0b045fcb8a8a433ebea9e62',
+                           u'interface': u'public',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'9cdfe2a893c34afd8f504eb218cd2f9d',
+                           u'interface': u'internal',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'f629388955bc407f8b11d8b7ca168086',
+                           u'interface': u'admin',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9312'}]}
+
+        Note, that an added complication is that the order of admin, public,
+        internal against 'interface' in each region.
+
+        Thus, the function sorts the expected and actual lists using the
+        interface key as a sort key, prior to the comparison.
+        """
+        self.log.debug('Validating v3 service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                l_expected = sorted(v, key=lambda x: x['interface'])
+                l_actual = sorted(actual[k], key=lambda x: x['interface'])
+                if len(l_actual) != len(l_expected):
+                    return ("endpoint {} has differing number of interfaces "
+                            " - expected({}), actual({})"
+                            .format(k, len(l_expected), len(l_actual)))
+                for i_expected, i_actual in zip(l_expected, l_actual):
+                    self.log.debug("checking interface {}"
+                                   .format(i_expected['interface']))
+                    ret = self._validate_dict_data(i_expected, i_actual)
+                    if ret:
+                        return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_tenant_data(self, expected, actual):
+        """Validate tenant data.
+
+           Validate a list of actual tenant data vs list of expected tenant
+           data.
+           """
+        self.log.debug('Validating tenant data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'enabled': act.enabled, 'description': act.description,
+                     'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected tenant data - {}".format(ret)
+            if not found:
+                return "tenant {} does not exist".format(e['name'])
+        return ret
+
+    def validate_role_data(self, expected, actual):
+        """Validate role data.
+
+           Validate a list of actual role data vs a list of expected role
+           data.
+           """
+        self.log.debug('Validating role data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected role data - {}".format(ret)
+            if not found:
+                return "role {} does not exist".format(e['name'])
+        return ret
+
+    def validate_user_data(self, expected, actual, api_version=None):
+        """Validate user data.
+
+           Validate a list of actual user data vs a list of expected user
+           data.
+           """
+        self.log.debug('Validating user data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                if e['name'] == act.name:
+                    a = {'enabled': act.enabled, 'name': act.name,
+                         'email': act.email, 'id': act.id}
+                    if api_version == 3:
+                        a['default_project_id'] = getattr(act,
+                                                          'default_project_id',
+                                                          'none')
+                    else:
+                        a['tenantId'] = act.tenantId
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected user data - {}".format(ret)
+            if not found:
+                return "user {} does not exist".format(e['name'])
+        return ret
+
+    def validate_flavor_data(self, expected, actual):
+        """Validate flavor data.
+
+           Validate a list of actual flavors vs a list of expected flavors.
+           """
+        self.log.debug('Validating flavor data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        act = [a.name for a in actual]
+        return self._validate_list_data(expected, act)
+
+    def tenant_exists(self, keystone, tenant):
+        """Return True if tenant exists."""
+        self.log.debug('Checking if tenant exists ({})...'.format(tenant))
+        return tenant in [t.name for t in keystone.tenants.list()]
+
+    @retry_on_exception(num_retries=5, base_delay=1)
+    def keystone_wait_for_propagation(self, sentry_relation_pairs,
+                                      api_version):
+        """Iterate over list of sentry and relation tuples and verify that
+           api_version has the expected value.
+
+        :param sentry_relation_pairs: list of sentry, relation name tuples used
+                                      for monitoring propagation of relation
+                                      data
+        :param api_version: api_version to expect in relation data
+        :returns: None if successful.  Raise on error.
+        """
+        for (sentry, relation_name) in sentry_relation_pairs:
+            rel = sentry.relation('identity-service',
+                                  relation_name)
+            self.log.debug('keystone relation data: {}'.format(rel))
+            if rel.get('api_version') != str(api_version):
+                raise Exception("api_version not propagated through relation"
+                                " data yet ('{}' != '{}')."
+                                "".format(rel.get('api_version'), api_version))
+
+    def keystone_configure_api_version(self, sentry_relation_pairs, deployment,
+                                       api_version):
+        """Configure preferred-api-version of keystone in deployment and
+           monitor provided list of relation objects for propagation
+           before returning to caller.
+
+        :param sentry_relation_pairs: list of sentry, relation tuples used for
+                                      monitoring propagation of relation data
+        :param deployment: deployment to configure
+        :param api_version: value preferred-api-version will be set to
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug("Setting keystone preferred-api-version: '{}'"
+                       "".format(api_version))
+
+        config = {'preferred-api-version': api_version}
+        deployment.d.configure('keystone', config)
+        deployment._auto_wait_for_status()
+        self.keystone_wait_for_propagation(sentry_relation_pairs, api_version)
+
+    def authenticate_cinder_admin(self, keystone, api_version=2):
+        """Authenticates admin user with cinder."""
+        self.log.debug('Authenticating cinder admin...')
+        _clients = {
+            1: cinder_client.Client,
+            2: cinder_clientv2.Client}
+        return _clients[api_version](session=keystone.session)
+
+    def authenticate_keystone(self, keystone_ip, username, password,
+                              api_version=False, admin_port=False,
+                              user_domain_name=None, domain_name=None,
+                              project_domain_name=None, project_name=None):
+        """Authenticate with Keystone"""
+        self.log.debug('Authenticating with keystone...')
+        if not api_version:
+            api_version = 2
+        sess, auth = self.get_keystone_session(
+            keystone_ip=keystone_ip,
+            username=username,
+            password=password,
+            api_version=api_version,
+            admin_port=admin_port,
+            user_domain_name=user_domain_name,
+            domain_name=domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name
+        )
+        if api_version == 2:
+            client = keystone_client.Client(session=sess)
+        else:
+            client = keystone_client_v3.Client(session=sess)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(sess)
+        return client
+
+    def get_keystone_session(self, keystone_ip, username, password,
+                             api_version=False, admin_port=False,
+                             user_domain_name=None, domain_name=None,
+                             project_domain_name=None, project_name=None):
+        """Return a keystone session object"""
+        ep = self.get_keystone_endpoint(keystone_ip,
+                                        api_version=api_version,
+                                        admin_port=admin_port)
+        if api_version == 2:
+            auth = v2.Password(
+                username=username,
+                password=password,
+                tenant_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        else:
+            auth = v3.Password(
+                user_domain_name=user_domain_name,
+                username=username,
+                password=password,
+                domain_name=domain_name,
+                project_domain_name=project_domain_name,
+                project_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        return (sess, auth)
+
+    def get_keystone_endpoint(self, keystone_ip, api_version=None,
+                              admin_port=False):
+        """Return keystone endpoint"""
+        port = 5000
+        if admin_port:
+            port = 35357
+        base_ep = "http://{}:{}".format(keystone_ip.strip().decode('utf-8'),
+                                        port)
+        if api_version == 2:
+            ep = base_ep + "/v2.0"
+        else:
+            ep = base_ep + "/v3"
+        return ep
+
+    def get_default_keystone_session(self, keystone_sentry,
+                                     openstack_release=None, api_version=2):
+        """Return a keystone session object and client object assuming standard
+           default settings
+
+           Example call in amulet tests:
+               self.keystone_session, self.keystone = u.get_default_keystone_session(
+                   self.keystone_sentry,
+                   openstack_release=self._get_openstack_release())
+
+           The session can then be used to auth other clients:
+               neutronclient.Client(session=session)
+               aodh_client.Client(session=session)
+               eyc
+        """
+        self.log.debug('Authenticating keystone admin...')
+        # 11 => xenial_queens
+        if api_version == 3 or (openstack_release and openstack_release >= 11):
+            client_class = keystone_client_v3.Client
+            api_version = 3
+        else:
+            client_class = keystone_client.Client
+        keystone_ip = keystone_sentry.info['public-address']
+        session, auth = self.get_keystone_session(
+            keystone_ip,
+            api_version=api_version,
+            username='admin',
+            password='openstack',
+            project_name='admin',
+            user_domain_name='admin_domain',
+            project_domain_name='admin_domain')
+        client = client_class(session=session)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(session)
+        return session, client
+
+    def authenticate_keystone_admin(self, keystone_sentry, user, password,
+                                    tenant=None, api_version=None,
+                                    keystone_ip=None, user_domain_name=None,
+                                    project_domain_name=None,
+                                    project_name=None):
+        """Authenticates admin user with the keystone admin endpoint."""
+        self.log.debug('Authenticating keystone admin...')
+        if not keystone_ip:
+            keystone_ip = keystone_sentry.info['public-address']
+
+        # To support backward compatibility usage of this function
+        if not project_name:
+            project_name = tenant
+        if api_version == 3 and not user_domain_name:
+            user_domain_name = 'admin_domain'
+        if api_version == 3 and not project_domain_name:
+            project_domain_name = 'admin_domain'
+        if api_version == 3 and not project_name:
+            project_name = 'admin'
+
+        return self.authenticate_keystone(
+            keystone_ip, user, password,
+            api_version=api_version,
+            user_domain_name=user_domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name,
+            admin_port=True)
+
+    def authenticate_keystone_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with the keystone public endpoint."""
+        self.log.debug('Authenticating keystone user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        keystone_ip = urlparse.urlparse(ep).hostname
+
+        return self.authenticate_keystone(keystone_ip, user, password,
+                                          project_name=tenant)
+
+    def authenticate_glance_admin(self, keystone, force_v1_client=False):
+        """Authenticates admin user with glance."""
+        self.log.debug('Authenticating glance admin...')
+        ep = keystone.service_catalog.url_for(service_type='image',
+                                              interface='adminURL')
+        if not force_v1_client and keystone.session:
+            return glance_clientv2.Client("2", session=keystone.session)
+        else:
+            return glance_client.Client(ep, token=keystone.auth_token)
+
+    def authenticate_heat_admin(self, keystone):
+        """Authenticates the admin user with heat."""
+        self.log.debug('Authenticating heat admin...')
+        ep = keystone.service_catalog.url_for(service_type='orchestration',
+                                              interface='publicURL')
+        if keystone.session:
+            return heat_client.Client(endpoint=ep, session=keystone.session)
+        else:
+            return heat_client.Client(endpoint=ep, token=keystone.auth_token)
+
+    def authenticate_nova_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with nova-api."""
+        self.log.debug('Authenticating nova user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      session=keystone.session,
+                                      auth_url=ep)
+        elif novaclient.__version__[0] >= "7":
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, password=password,
+                                      project_name=tenant, auth_url=ep)
+        else:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, api_key=password,
+                                      project_id=tenant, auth_url=ep)
+
+    def authenticate_swift_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with swift api."""
+        self.log.debug('Authenticating swift user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return swiftclient.Connection(session=keystone.session)
+        else:
+            return swiftclient.Connection(authurl=ep,
+                                          user=user,
+                                          key=password,
+                                          tenant_name=tenant,
+                                          auth_version='2.0')
+
+    def create_flavor(self, nova, name, ram, vcpus, disk, flavorid="auto",
+                      ephemeral=0, swap=0, rxtx_factor=1.0, is_public=True):
+        """Create the specified flavor."""
+        try:
+            nova.flavors.find(name=name)
+        except (exceptions.NotFound, exceptions.NoUniqueMatch):
+            self.log.debug('Creating flavor ({})'.format(name))
+            nova.flavors.create(name, ram, vcpus, disk, flavorid,
+                                ephemeral, swap, rxtx_factor, is_public)
+
+    def glance_create_image(self, glance, image_name, image_url,
+                            download_dir='tests',
+                            hypervisor_type=None,
+                            disk_format='qcow2',
+                            architecture='x86_64',
+                            container_format='bare'):
+        """Download an image and upload it to glance, validate its status
+        and return an image object pointer. KVM defaults, can override for
+        LXD.
+
+        :param glance: pointer to authenticated glance api connection
+        :param image_name: display name for new image
+        :param image_url: url to retrieve
+        :param download_dir: directory to store downloaded image file
+        :param hypervisor_type: glance image hypervisor property
+        :param disk_format: glance image disk format
+        :param architecture: glance image architecture property
+        :param container_format: glance image container format
+        :returns: glance image pointer
+        """
+        self.log.debug('Creating glance image ({}) from '
+                       '{}...'.format(image_name, image_url))
+
+        # Download image
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        abs_file_name = os.path.join(download_dir, image_name)
+        if not os.path.exists(abs_file_name):
+            opener.retrieve(image_url, abs_file_name)
+
+        # Create glance image
+        glance_properties = {
+            'architecture': architecture,
+        }
+        if hypervisor_type:
+            glance_properties['hypervisor_type'] = hypervisor_type
+        # Create glance image
+        if float(glance.version) < 2.0:
+            with open(abs_file_name) as f:
+                image = glance.images.create(
+                    name=image_name,
+                    is_public=True,
+                    disk_format=disk_format,
+                    container_format=container_format,
+                    properties=glance_properties,
+                    data=f)
+        else:
+            image = glance.images.create(
+                name=image_name,
+                visibility="public",
+                disk_format=disk_format,
+                container_format=container_format)
+            glance.images.upload(image.id, open(abs_file_name, 'rb'))
+            glance.images.update(image.id, **glance_properties)
+
+        # Wait for image to reach active status
+        img_id = image.id
+        ret = self.resource_reaches_status(glance.images, img_id,
+                                           expected_stat='active',
+                                           msg='Image status wait')
+        if not ret:
+            msg = 'Glance image failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new image
+        self.log.debug('Validating image attributes...')
+        val_img_name = glance.images.get(img_id).name
+        val_img_stat = glance.images.get(img_id).status
+        val_img_cfmt = glance.images.get(img_id).container_format
+        val_img_dfmt = glance.images.get(img_id).disk_format
+
+        if float(glance.version) < 2.0:
+            val_img_pub = glance.images.get(img_id).is_public
+        else:
+            val_img_pub = glance.images.get(img_id).visibility == "public"
+
+        msg_attr = ('Image attributes - name:{} public:{} id:{} stat:{} '
+                    'container fmt:{} disk fmt:{}'.format(
+                        val_img_name, val_img_pub, img_id,
+                        val_img_stat, val_img_cfmt, val_img_dfmt))
+
+        if val_img_name == image_name and val_img_stat == 'active' \
+                and val_img_pub is True and val_img_cfmt == container_format \
+                and val_img_dfmt == disk_format:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Image validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return image
+
+    def create_cirros_image(self, glance, image_name, hypervisor_type=None):
+        """Download the latest cirros image and upload it to glance,
+        validate and return a resource pointer.
+
+        :param glance: pointer to authenticated glance connection
+        :param image_name: display name for new image
+        :param hypervisor_type: glance image hypervisor property
+        :returns: glance image pointer
+        """
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'glance_create_image instead of '
+                      'create_cirros_image.')
+
+        self.log.debug('Creating glance cirros image '
+                       '({})...'.format(image_name))
+
+        # Get cirros image URL
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        f = opener.open('http://download.cirros-cloud.net/version/released')
+        version = f.read().strip()
+        cirros_img = 'cirros-{}-x86_64-disk.img'.format(version)
+        cirros_url = 'http://{}/{}/{}'.format('download.cirros-cloud.net',
+                                              version, cirros_img)
+        f.close()
+
+        return self.glance_create_image(
+            glance,
+            image_name,
+            cirros_url,
+            hypervisor_type=hypervisor_type)
+
+    def delete_image(self, glance, image):
+        """Delete the specified image."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_image.')
+        self.log.debug('Deleting glance image ({})...'.format(image))
+        return self.delete_resource(glance.images, image, msg='glance image')
+
+    def create_instance(self, nova, image_name, instance_name, flavor):
+        """Create the specified instance."""
+        self.log.debug('Creating instance '
+                       '({}|{}|{})'.format(instance_name, image_name, flavor))
+        image = nova.glance.find_image(image_name)
+        flavor = nova.flavors.find(name=flavor)
+        instance = nova.servers.create(name=instance_name, image=image,
+                                       flavor=flavor)
+
+        count = 1
+        status = instance.status
+        while status != 'ACTIVE' and count < 60:
+            time.sleep(3)
+            instance = nova.servers.get(instance.id)
+            status = instance.status
+            self.log.debug('instance status: {}'.format(status))
+            count += 1
+
+        if status != 'ACTIVE':
+            self.log.error('instance creation timed out')
+            return None
+
+        return instance
+
+    def delete_instance(self, nova, instance):
+        """Delete the specified instance."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_instance.')
+        self.log.debug('Deleting instance ({})...'.format(instance))
+        return self.delete_resource(nova.servers, instance,
+                                    msg='nova instance')
+
+    def create_or_get_keypair(self, nova, keypair_name="testkey"):
+        """Create a new keypair, or return pointer if it already exists."""
+        try:
+            _keypair = nova.keypairs.get(keypair_name)
+            self.log.debug('Keypair ({}) already exists, '
+                           'using it.'.format(keypair_name))
+            return _keypair
+        except Exception:
+            self.log.debug('Keypair ({}) does not exist, '
+                           'creating it.'.format(keypair_name))
+
+        _keypair = nova.keypairs.create(name=keypair_name)
+        return _keypair
+
+    def _get_cinder_obj_name(self, cinder_object):
+        """Retrieve name of cinder object.
+
+        :param cinder_object: cinder snapshot or volume object
+        :returns: str cinder object name
+        """
+        # v1 objects store name in 'display_name' attr but v2+ use 'name'
+        try:
+            return cinder_object.display_name
+        except AttributeError:
+            return cinder_object.name
+
+    def create_cinder_volume(self, cinder, vol_name="demo-vol", vol_size=1,
+                             img_id=None, src_vol_id=None, snap_id=None):
+        """Create cinder volume, optionally from a glance image, OR
+        optionally as a clone of an existing volume, OR optionally
+        from a snapshot.  Wait for the new volume status to reach
+        the expected status, validate and return a resource pointer.
+
+        :param vol_name: cinder volume display name
+        :param vol_size: size in gigabytes
+        :param img_id: optional glance image id
+        :param src_vol_id: optional source volume id to clone
+        :param snap_id: optional snapshot id to use
+        :returns: cinder volume pointer
+        """
+        # Handle parameter input and avoid impossible combinations
+        if img_id and not src_vol_id and not snap_id:
+            # Create volume from image
+            self.log.debug('Creating cinder volume from glance image...')
+            bootable = 'true'
+        elif src_vol_id and not img_id and not snap_id:
+            # Clone an existing volume
+            self.log.debug('Cloning cinder volume...')
+            bootable = cinder.volumes.get(src_vol_id).bootable
+        elif snap_id and not src_vol_id and not img_id:
+            # Create volume from snapshot
+            self.log.debug('Creating cinder volume from snapshot...')
+            snap = cinder.volume_snapshots.find(id=snap_id)
+            vol_size = snap.size
+            snap_vol_id = cinder.volume_snapshots.get(snap_id).volume_id
+            bootable = cinder.volumes.get(snap_vol_id).bootable
+        elif not img_id and not src_vol_id and not snap_id:
+            # Create volume
+            self.log.debug('Creating cinder volume...')
+            bootable = 'false'
+        else:
+            # Impossible combination of parameters
+            msg = ('Invalid method use - name:{} size:{} img_id:{} '
+                   'src_vol_id:{} snap_id:{}'.format(vol_name, vol_size,
+                                                     img_id, src_vol_id,
+                                                     snap_id))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Create new volume
+        try:
+            vol_new = cinder.volumes.create(display_name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except TypeError:
+            vol_new = cinder.volumes.create(name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except Exception as e:
+            msg = 'Failed to create volume: {}'.format(e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Wait for volume to reach available status
+        ret = self.resource_reaches_status(cinder.volumes, vol_id,
+                                           expected_stat="available",
+                                           msg="Volume status wait")
+        if not ret:
+            msg = 'Cinder volume failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new volume
+        self.log.debug('Validating volume attributes...')
+        val_vol_name = self._get_cinder_obj_name(cinder.volumes.get(vol_id))
+        val_vol_boot = cinder.volumes.get(vol_id).bootable
+        val_vol_stat = cinder.volumes.get(vol_id).status
+        val_vol_size = cinder.volumes.get(vol_id).size
+        msg_attr = ('Volume attributes - name:{} id:{} stat:{} boot:'
+                    '{} size:{}'.format(val_vol_name, vol_id,
+                                        val_vol_stat, val_vol_boot,
+                                        val_vol_size))
+
+        if val_vol_boot == bootable and val_vol_stat == 'available' \
+                and val_vol_name == vol_name and val_vol_size == vol_size:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Volume validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return vol_new
+
+    def delete_resource(self, resource, resource_id,
+                        msg="resource", max_wait=120):
+        """Delete one openstack resource, such as one instance, keypair,
+        image, volume, stack, etc., and confirm deletion within max wait time.
+
+        :param resource: pointer to os resource type, ex:glance_client.images
+        :param resource_id: unique name or id for the openstack resource
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, otherwise False
+        """
+        self.log.debug('Deleting OpenStack resource '
+                       '{} ({})'.format(resource_id, msg))
+        num_before = len(list(resource.list()))
+        resource.delete(resource_id)
+
+        tries = 0
+        num_after = len(list(resource.list()))
+        while num_after != (num_before - 1) and tries < (max_wait / 4):
+            self.log.debug('{} delete check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  num_before,
+                                                  num_after,
+                                                  resource_id))
+            time.sleep(4)
+            num_after = len(list(resource.list()))
+            tries += 1
+
+        self.log.debug('{}:  expected, actual count = {}, '
+                       '{}'.format(msg, num_before - 1, num_after))
+
+        if num_after == (num_before - 1):
+            return True
+        else:
+            self.log.error('{} delete timed out'.format(msg))
+            return False
+
+    def resource_reaches_status(self, resource, resource_id,
+                                expected_stat='available',
+                                msg='resource', max_wait=120):
+        """Wait for an openstack resources status to reach an
+           expected status within a specified time.  Useful to confirm that
+           nova instances, cinder vols, snapshots, glance images, heat stacks
+           and other resources eventually reach the expected status.
+
+        :param resource: pointer to os resource type, ex: heat_client.stacks
+        :param resource_id: unique id for the openstack resource
+        :param expected_stat: status to expect resource to reach
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, False if status is not reached
+        """
+
+        tries = 0
+        resource_stat = resource.get(resource_id).status
+        while resource_stat != expected_stat and tries < (max_wait / 4):
+            self.log.debug('{} status check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  resource_stat,
+                                                  expected_stat,
+                                                  resource_id))
+            time.sleep(4)
+            resource_stat = resource.get(resource_id).status
+            tries += 1
+
+        self.log.debug('{}:  expected, actual status = {}, '
+                       '{}'.format(msg, resource_stat, expected_stat))
+
+        if resource_stat == expected_stat:
+            return True
+        else:
+            self.log.debug('{} never reached expected status: '
+                           '{}'.format(resource_id, expected_stat))
+            return False
+
+    def get_ceph_osd_id_cmd(self, index):
+        """Produce a shell command that will return a ceph-osd id."""
+        return ("`initctl list | grep 'ceph-osd ' | "
+                "awk 'NR=={} {{ print $2 }}' | "
+                "grep -o '[0-9]*'`".format(index + 1))
+
+    def get_ceph_pools(self, sentry_unit):
+        """Return a dict of ceph pools from a single ceph unit, with
+        pool name as keys, pool id as vals."""
+        pools = {}
+        cmd = 'sudo ceph osd lspools'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # For mimic ceph osd lspools output
+        output = output.replace("\n", ",")
+
+        # Example output: 0 data,1 metadata,2 rbd,3 cinder,4 glance,
+        for pool in str(output).split(','):
+            pool_id_name = pool.split(' ')
+            if len(pool_id_name) == 2:
+                pool_id = pool_id_name[0]
+                pool_name = pool_id_name[1]
+                pools[pool_name] = int(pool_id)
+
+        self.log.debug('Pools on {}: {}'.format(sentry_unit.info['unit_name'],
+                                                pools))
+        return pools
+
+    def get_ceph_df(self, sentry_unit):
+        """Return dict of ceph df json output, including ceph pool state.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :returns: Dict of ceph df output
+        """
+        cmd = 'sudo ceph df --format=json'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return json.loads(output)
+
+    def get_ceph_pool_sample(self, sentry_unit, pool_id=0):
+        """Take a sample of attributes of a ceph pool, returning ceph
+        pool name, object count and disk space used for the specified
+        pool ID number.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :param pool_id: Ceph pool ID
+        :returns: List of pool name, object count, kb disk space used
+        """
+        df = self.get_ceph_df(sentry_unit)
+        for pool in df['pools']:
+            if pool['id'] == pool_id:
+                pool_name = pool['name']
+                obj_count = pool['stats']['objects']
+                kb_used = pool['stats']['kb_used']
+
+        self.log.debug('Ceph {} pool (ID {}): {} objects, '
+                       '{} kb used'.format(pool_name, pool_id,
+                                           obj_count, kb_used))
+        return pool_name, obj_count, kb_used
+
+    def validate_ceph_pool_samples(self, samples, sample_type="resource pool"):
+        """Validate ceph pool samples taken over time, such as pool
+        object counts or pool kb used, before adding, after adding, and
+        after deleting items which affect those pool attributes.  The
+        2nd element is expected to be greater than the 1st; 3rd is expected
+        to be less than the 2nd.
+
+        :param samples: List containing 3 data samples
+        :param sample_type: String for logging and usage context
+        :returns: None if successful, Failure message otherwise
+        """
+        original, created, deleted = range(3)
+        if samples[created] <= samples[original] or \
+                samples[deleted] >= samples[created]:
+            return ('Ceph {} samples ({}) '
+                    'unexpected.'.format(sample_type, samples))
+        else:
+            self.log.debug('Ceph {} samples (OK): '
+                           '{}'.format(sample_type, samples))
+            return None
+
+    # rabbitmq/amqp specific helpers:
+
+    def rmq_wait_for_cluster(self, deployment, init_sleep=15, timeout=1200):
+        """Wait for rmq units extended status to show cluster readiness,
+        after an optional initial sleep period.  Initial sleep is likely
+        necessary to be effective following a config change, as status
+        message may not instantly update to non-ready."""
+
+        if init_sleep:
+            time.sleep(init_sleep)
+
+        message = re.compile('^Unit is ready and clustered$')
+        deployment._auto_wait_for_status(message=message,
+                                         timeout=timeout,
+                                         include_only=['rabbitmq-server'])
+
+    def add_rmq_test_user(self, sentry_units,
+                          username="testuser1", password="changeme"):
+        """Add a test user via the first rmq juju unit, check connection as
+        the new user against all sentry units.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Adding rmq user ({})...'.format(username))
+
+        # Check that user does not already exist
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+        if username in output:
+            self.log.warning('User ({}) already exists, returning '
+                             'gracefully.'.format(username))
+            return
+
+        perms = '".*" ".*" ".*"'
+        cmds = ['rabbitmqctl add_user {} {}'.format(username, password),
+                'rabbitmqctl set_permissions {} {}'.format(username, perms)]
+
+        # Add user via first unit
+        for cmd in cmds:
+            output, _ = self.run_cmd_unit(sentry_units[0], cmd)
+
+        # Check connection against the other sentry_units
+        self.log.debug('Checking user connect against units...')
+        for sentry_unit in sentry_units:
+            connection = self.connect_amqp_by_unit(sentry_unit, ssl=False,
+                                                   username=username,
+                                                   password=password)
+            connection.close()
+
+    def delete_rmq_test_user(self, sentry_units, username="testuser1"):
+        """Delete a rabbitmq user via the first rmq juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful or no such user.
+        """
+        self.log.debug('Deleting rmq user ({})...'.format(username))
+
+        # Check that the user exists
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+
+        if username not in output:
+            self.log.warning('User ({}) does not exist, returning '
+                             'gracefully.'.format(username))
+            return
+
+        # Delete the user
+        cmd_user_del = 'rabbitmqctl delete_user {}'.format(username)
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_del)
+
+    def get_rmq_cluster_status(self, sentry_unit):
+        """Execute rabbitmq cluster status command on a unit and return
+        the full output.
+
+        :param unit: sentry unit
+        :returns: String containing console output of cluster status command
+        """
+        cmd = 'rabbitmqctl cluster_status'
+        output, _ = self.run_cmd_unit(sentry_unit, cmd)
+        self.log.debug('{} cluster_status:\n{}'.format(
+            sentry_unit.info['unit_name'], output))
+        return str(output)
+
+    def get_rmq_cluster_running_nodes(self, sentry_unit):
+        """Parse rabbitmqctl cluster_status output string, return list of
+        running rabbitmq cluster nodes.
+
+        :param unit: sentry unit
+        :returns: List containing node names of running nodes
+        """
+        # NOTE(beisner): rabbitmqctl cluster_status output is not
+        # json-parsable, do string chop foo, then json.loads that.
+        str_stat = self.get_rmq_cluster_status(sentry_unit)
+        if 'running_nodes' in str_stat:
+            pos_start = str_stat.find("{running_nodes,") + 15
+            pos_end = str_stat.find("]},", pos_start) + 1
+            str_run_nodes = str_stat[pos_start:pos_end].replace("'", '"')
+            run_nodes = json.loads(str_run_nodes)
+            return run_nodes
+        else:
+            return []
+
+    def validate_rmq_cluster_running_nodes(self, sentry_units):
+        """Check that all rmq unit hostnames are represented in the
+        cluster_status output of all units.
+
+        :param host_names: dict of juju unit names to host names
+        :param units: list of sentry unit pointers (all rmq units)
+        :returns: None if successful, otherwise return error message
+        """
+        host_names = self.get_unit_hostnames(sentry_units)
+        errors = []
+
+        # Query every unit for cluster_status running nodes
+        for query_unit in sentry_units:
+            query_unit_name = query_unit.info['unit_name']
+            running_nodes = self.get_rmq_cluster_running_nodes(query_unit)
+
+            # Confirm that every unit is represented in the queried unit's
+            # cluster_status running nodes output.
+            for validate_unit in sentry_units:
+                val_host_name = host_names[validate_unit.info['unit_name']]
+                val_node_name = 'rabbit@{}'.format(val_host_name)
+
+                if val_node_name not in running_nodes:
+                    errors.append('Cluster member check failed on {}: {} not '
+                                  'in {}\n'.format(query_unit_name,
+                                                   val_node_name,
+                                                   running_nodes))
+        if errors:
+            return ''.join(errors)
+
+    def rmq_ssl_is_enabled_on_unit(self, sentry_unit, port=None):
+        """Check a single juju rmq unit for ssl and port in the config file."""
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        conf_file = '/etc/rabbitmq/rabbitmq.config'
+        conf_contents = str(self.file_contents_safe(sentry_unit,
+                                                    conf_file, max_wait=16))
+        # Checks
+        conf_ssl = 'ssl' in conf_contents
+        conf_port = str(port) in conf_contents
+
+        # Port explicitly checked in config
+        if port and conf_port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif port and not conf_port and conf_ssl:
+            self.log.debug('SSL is enabled @{} but not on port {} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        # Port not checked (useful when checking that ssl is disabled)
+        elif not port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif not conf_ssl:
+            self.log.debug('SSL not enabled @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        else:
+            msg = ('Unknown condition when checking SSL status @{}:{} '
+                   '({})'.format(host, port, unit_name))
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_rmq_ssl_enabled_units(self, sentry_units, port=None):
+        """Check that ssl is enabled on rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :param port: optional ssl port override to validate
+        :returns: None if successful, otherwise return error message
+        """
+        for sentry_unit in sentry_units:
+            if not self.rmq_ssl_is_enabled_on_unit(sentry_unit, port=port):
+                return ('Unexpected condition:  ssl is disabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def validate_rmq_ssl_disabled_units(self, sentry_units):
+        """Check that ssl is enabled on listed rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :returns: True if successful.  Raise on error.
+        """
+        for sentry_unit in sentry_units:
+            if self.rmq_ssl_is_enabled_on_unit(sentry_unit):
+                return ('Unexpected condition:  ssl is enabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def configure_rmq_ssl_on(self, sentry_units, deployment,
+                             port=None, max_wait=60):
+        """Turn ssl charm config option on, with optional non-default
+        ssl port specification.  Confirm that it is enabled on every
+        unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param port: amqp port, use defaults if None
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  on')
+
+        # Enable RMQ SSL
+        config = {'ssl': 'on'}
+        if port:
+            config['ssl_port'] = port
+
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def configure_rmq_ssl_off(self, sentry_units, deployment, max_wait=60):
+        """Turn ssl charm config option off, confirm that it is disabled
+        on every unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  off')
+
+        # Disable RMQ SSL
+        config = {'ssl': 'off'}
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def connect_amqp_by_unit(self, sentry_unit, ssl=False,
+                             port=None, fatal=True,
+                             username="testuser1", password="changeme"):
+        """Establish and return a pika amqp connection to the rabbitmq service
+        running on a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :param fatal: boolean, default to True (raises on connect error)
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: pika amqp connection pointer or None if failed and non-fatal
+        """
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        # Default port logic if port is not specified
+        if ssl and not port:
+            port = 5671
+        elif not ssl and not port:
+            port = 5672
+
+        self.log.debug('Connecting to amqp on {}:{} ({}) as '
+                       '{}...'.format(host, port, unit_name, username))
+
+        try:
+            credentials = pika.PlainCredentials(username, password)
+            parameters = pika.ConnectionParameters(host=host, port=port,
+                                                   credentials=credentials,
+                                                   ssl=ssl,
+                                                   connection_attempts=3,
+                                                   retry_delay=5,
+                                                   socket_timeout=1)
+            connection = pika.BlockingConnection(parameters)
+            assert connection.is_open is True
+            assert connection.is_closing is False
+            self.log.debug('Connect OK')
+            return connection
+        except Exception as e:
+            msg = ('amqp connection failed to {}:{} as '
+                   '{} ({})'.format(host, port, username, str(e)))
+            if fatal:
+                amulet.raise_status(amulet.FAIL, msg)
+            else:
+                self.log.warn(msg)
+                return None
+
+    def publish_amqp_message_by_unit(self, sentry_unit, message,
+                                     queue="test", ssl=False,
+                                     username="testuser1",
+                                     password="changeme",
+                                     port=None):
+        """Publish an amqp message to a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param message: amqp message string
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: None.  Raises exception if publish failed.
+        """
+        self.log.debug('Publishing message to {} queue:\n{}'.format(queue,
+                                                                    message))
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+
+        # NOTE(beisner): extra debug here re: pika hang potential:
+        #   https://github.com/pika/pika/issues/297
+        #   https://groups.google.com/forum/#!topic/rabbitmq-users/Ja0iyfF0Szw
+        self.log.debug('Defining channel...')
+        channel = connection.channel()
+        self.log.debug('Declaring queue...')
+        channel.queue_declare(queue=queue, auto_delete=False, durable=True)
+        self.log.debug('Publishing message...')
+        channel.basic_publish(exchange='', routing_key=queue, body=message)
+        self.log.debug('Closing channel...')
+        channel.close()
+        self.log.debug('Closing connection...')
+        connection.close()
+
+    def get_amqp_message_by_unit(self, sentry_unit, queue="test",
+                                 username="testuser1",
+                                 password="changeme",
+                                 ssl=False, port=None):
+        """Get an amqp message from a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: amqp message body as string.  Raise if get fails.
+        """
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+        channel = connection.channel()
+        method_frame, _, body = channel.basic_get(queue)
+
+        if method_frame:
+            self.log.debug('Retreived message from {} queue:\n{}'.format(queue,
+                                                                         body))
+            channel.basic_ack(method_frame.delivery_tag)
+            channel.close()
+            connection.close()
+            return body
+        else:
+            msg = 'No message retrieved.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_memcache(self, sentry_unit, conf, os_release,
+                          earliest_release=5, section='keystone_authtoken',
+                          check_kvs=None):
+        """Check Memcache is running and is configured to be used
+
+        Example call from Amulet test:
+
+            def test_110_memcache(self):
+                u.validate_memcache(self.neutron_api_sentry,
+                                    '/etc/neutron/neutron.conf',
+                                    self._get_openstack_release())
+
+        :param sentry_unit: sentry unit
+        :param conf: OpenStack config file to check memcache settings
+        :param os_release: Current OpenStack release int code
+        :param earliest_release: Earliest Openstack release to check int code
+        :param section: OpenStack config file section to check
+        :param check_kvs: Dict of settings to check in config file
+        :returns: None
+        """
+        if os_release < earliest_release:
+            self.log.debug('Skipping memcache checks for deployment. {} <'
+                           'mitaka'.format(os_release))
+            return
+        _kvs = check_kvs or {'memcached_servers': 'inet6:[::1]:11211'}
+        self.log.debug('Checking memcached is running')
+        ret = self.validate_services_by_name({sentry_unit: ['memcached']})
+        if ret:
+            amulet.raise_status(amulet.FAIL, msg='Memcache running check'
+                                'failed {}'.format(ret))
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache url is configured in {}'.format(
+            conf))
+        if self.validate_config_data(sentry_unit, conf, section, _kvs):
+            message = "Memcache config error in: {}".format(conf)
+            amulet.raise_status(amulet.FAIL, msg=message)
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache configuration in '
+                       '/etc/memcached.conf')
+        contents = self.file_contents_safe(sentry_unit, '/etc/memcached.conf',
+                                           fatal=True)
+        ubuntu_release, _ = self.run_cmd_unit(sentry_unit, 'lsb_release -cs')
+        if CompareHostReleases(ubuntu_release) <= 'trusty':
+            memcache_listen_addr = 'ip6-localhost'
+        else:
+            memcache_listen_addr = '::1'
+        expected = {
+            '-p': '11211',
+            '-l': memcache_listen_addr}
+        found = []
+        for key, value in expected.items():
+            for line in contents.split('\n'):
+                if line.startswith(key):
+                    self.log.debug('Checking {} is set to {}'.format(
+                        key,
+                        value))
+                    assert value == line.split()[-1]
+                    self.log.debug(line.split()[-1])
+                    found.append(key)
+        if sorted(found) == sorted(expected.keys()):
+            self.log.debug('OK')
+        else:
+            message = "Memcache config error in: /etc/memcached.conf"
+            amulet.raise_status(amulet.FAIL, msg=message)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f7e5f79a5d5fe3cb374814e32ea16f6060f4f27
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/__init__.py
@@ -0,0 +1,212 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""OpenStack Security Audit code"""
+
+import collections
+from enum import Enum
+import traceback
+
+from charmhelpers.core.host import cmp_pkgrevno
+import charmhelpers.contrib.openstack.utils as openstack_utils
+import charmhelpers.core.hookenv as hookenv
+
+
+class AuditType(Enum):
+    OpenStackSecurityGuide = 1
+
+
+_audits = {}
+
+Audit = collections.namedtuple('Audit', 'func filters')
+
+
+def audit(*args):
+    """Decorator to register an audit.
+
+    These are used to generate audits that can be run on a
+    deployed system that matches the given configuration
+
+    :param args: List of functions to filter tests against
+    :type args: List[Callable[Dict]]
+    """
+    def wrapper(f):
+        test_name = f.__name__
+        if _audits.get(test_name):
+            raise RuntimeError(
+                "Test name '{}' used more than once"
+                .format(test_name))
+        non_callables = [fn for fn in args if not callable(fn)]
+        if non_callables:
+            raise RuntimeError(
+                "Configuration includes non-callable filters: {}"
+                .format(non_callables))
+        _audits[test_name] = Audit(func=f, filters=args)
+        return f
+    return wrapper
+
+
+def is_audit_type(*args):
+    """This audit is included in the specified kinds of audits.
+
+    :param *args: List of AuditTypes to include this audit in
+    :type args: List[AuditType]
+    :rtype: Callable[Dict]
+    """
+    def _is_audit_type(audit_options):
+        if audit_options.get('audit_type') in args:
+            return True
+        else:
+            return False
+    return _is_audit_type
+
+
+def since_package(pkg, pkg_version):
+    """This audit should be run after the specified package version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_package(audit_options=None):
+        return cmp_pkgrevno(pkg, pkg_version) >= 0
+
+    return _since_package
+
+
+def before_package(pkg, pkg_version):
+    """This audit should be run before the specified package version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_package(audit_options=None):
+        return not since_package(pkg, pkg_version)()
+
+    return _before_package
+
+
+def since_openstack_release(pkg, release):
+    """This audit should run after the specified OpenStack version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_openstack_release(audit_options=None):
+        _release = openstack_utils.get_os_codename_package(pkg)
+        return openstack_utils.CompareOpenStackReleases(_release) >= release
+
+    return _since_openstack_release
+
+
+def before_openstack_release(pkg, release):
+    """This audit should run before the specified OpenStack version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_openstack_release(audit_options=None):
+        return not since_openstack_release(pkg, release)()
+
+    return _before_openstack_release
+
+
+def it_has_config(config_key):
+    """This audit should be run based on specified config keys.
+
+    :param config_key: Config key to look for
+    :type config_key: str
+    :rtype: Callable[Dict]
+    """
+    def _it_has_config(audit_options):
+        return audit_options.get(config_key) is not None
+
+    return _it_has_config
+
+
+def run(audit_options):
+    """Run the configured audits with the specified audit_options.
+
+    :param audit_options: Configuration for the audit
+    :type audit_options: Config
+
+    :rtype: Dict[str, str]
+    """
+    errors = {}
+    results = {}
+    for name, audit in sorted(_audits.items()):
+        result_name = name.replace('_', '-')
+        if result_name in audit_options.get('excludes', []):
+            print(
+                "Skipping {} because it is"
+                "excluded in audit config"
+                .format(result_name))
+            continue
+        if all(p(audit_options) for p in audit.filters):
+            try:
+                audit.func(audit_options)
+                print("{}: PASS".format(name))
+                results[result_name] = {
+                    'success': True,
+                }
+            except AssertionError as e:
+                print("{}: FAIL ({})".format(name, e))
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+            except Exception as e:
+                print("{}: ERROR ({})".format(name, e))
+                errors[name] = e
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+    for name, error in errors.items():
+        print("=" * 20)
+        print("Error in {}: ".format(name))
+        traceback.print_tb(error.__traceback__)
+        print()
+    return results
+
+
+def action_parse_results(result):
+    """Parse the result of `run` in the context of an action.
+
+    :param result: The result of running the security-checklist
+        action on a unit
+    :type result: Dict[str, Dict[str, str]]
+    :rtype: int
+    """
+    passed = True
+    for test, result in result.items():
+        if result['success']:
+            hookenv.action_set({test: 'PASS'})
+        else:
+            hookenv.action_set({test: 'FAIL - {}'.format(result['message'])})
+            passed = False
+    if not passed:
+        hookenv.action_fail("One or more tests failed")
+    return 0 if passed else 1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
new file mode 100644
index 0000000000000000000000000000000000000000..79740ed0c103e841b6e280af920f8be65e3d1d0d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
@@ -0,0 +1,270 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import configparser
+import glob
+import os.path
+import subprocess
+
+from charmhelpers.contrib.openstack.audits import (
+    audit,
+    AuditType,
+    # filters
+    is_audit_type,
+    it_has_config,
+)
+
+from charmhelpers.core.hookenv import (
+    cached,
+)
+
+"""
+The Security Guide suggests a specific list of files inside the
+config directory for the service having 640 specifically, but
+by ensuring the containing directory is 750, only the owner can
+write, and only the group can read files within the directory.
+
+By  restricting access to the containing directory, we can more
+effectively ensure that there is no accidental leakage if a new
+file is added to the service without being added to the security
+guide, and to this check.
+"""
+FILE_ASSERTIONS = {
+    'barbican': {
+        '/etc/barbican': {'group': 'barbican', 'mode': '750'},
+    },
+    'ceph-mon': {
+        '/var/lib/charm/ceph-mon/ceph.conf':
+            {'owner': 'root', 'group': 'root', 'mode': '644'},
+        '/etc/ceph/ceph.client.admin.keyring':
+            {'owner': 'ceph', 'group': 'ceph'},
+        '/etc/ceph/rbdmap': {'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'}
+    },
+    'ceph-osd': {
+        '/var/lib/charm/ceph-osd/ceph.conf':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/*': {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'},
+        '/var/lib/ceph/radosgw':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+    },
+    'cinder': {
+        '/etc/cinder': {'group': 'cinder', 'mode': '750'},
+    },
+    'glance': {
+        '/etc/glance': {'group': 'glance', 'mode': '750'},
+    },
+    'keystone': {
+        '/etc/keystone':
+            {'owner': 'keystone', 'group': 'keystone', 'mode': '750'},
+    },
+    'manilla': {
+        '/etc/manila': {'group': 'manilla', 'mode': '750'},
+    },
+    'neutron-gateway': {
+        '/etc/neutron': {'group': 'neutron', 'mode': '750'},
+    },
+    'neutron-api': {
+        '/etc/neutron/': {'group': 'neutron', 'mode': '750'},
+    },
+    'nova-cloud-controller': {
+        '/etc/nova': {'group': 'nova', 'mode': '750'},
+    },
+    'nova-compute': {
+        '/etc/nova/': {'group': 'nova', 'mode': '750'},
+    },
+    'openstack-dashboard': {
+        # From security guide
+        '/etc/openstack-dashboard/local_settings.py':
+            {'group': 'horizon', 'mode': '640'},
+    },
+}
+
+Ownership = collections.namedtuple('Ownership', 'owner group mode')
+
+
+@cached
+def _stat(file):
+    """
+    Get the Ownership information from a file.
+
+    :param file: The path to a file to stat
+    :type file: str
+    :returns: owner, group, and mode of the specified file
+    :rtype: Ownership
+    :raises subprocess.CalledProcessError: If the underlying stat fails
+    """
+    out = subprocess.check_output(
+        ['stat', '-c', '%U %G %a', file]).decode('utf-8')
+    return Ownership(*out.strip().split(' '))
+
+
+@cached
+def _config_ini(path):
+    """
+    Parse an ini file
+
+    :param path: The path to a file to parse
+    :type file: str
+    :returns: Configuration contained in path
+    :rtype: Dict
+    """
+    # When strict is enabled, duplicate options are not allowed in the
+    # parsed INI; however, Oslo allows duplicate values. This change
+    # causes us to ignore the duplicate values which is acceptable as
+    # long as we don't validate any multi-value options
+    conf = configparser.ConfigParser(strict=False)
+    conf.read(path)
+    return dict(conf)
+
+
+def _validate_file_ownership(owner, group, file_name, optional=False):
+    """
+    Validate that a specified file is owned by `owner:group`.
+
+    :param owner: Name of the owner
+    :type owner: str
+    :param group: Name of the group
+    :type group: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert owner == ownership.owner, \
+        "{} has an incorrect owner: {} should be {}".format(
+            file_name, ownership.owner, owner)
+    assert group == ownership.group, \
+        "{} has an incorrect group: {} should be {}".format(
+            file_name, ownership.group, group)
+    print("Validate ownership of {}: PASS".format(file_name))
+
+
+def _validate_file_mode(mode, file_name, optional=False):
+    """
+    Validate that a specified file has the specified permissions.
+
+    :param mode: file mode that is desires
+    :type owner: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert mode == ownership.mode, \
+        "{} has an incorrect mode: {} should be {}".format(
+            file_name, ownership.mode, mode)
+    print("Validate mode of {}: PASS".format(file_name))
+
+
+@cached
+def _config_section(config, section):
+    """Read the configuration file and return a section."""
+    path = os.path.join(config.get('config_path'), config.get('config_file'))
+    conf = _config_ini(path)
+    return conf.get(section)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_ownership(config):
+    """Verify that configuration files are owned by the correct user/group."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        owner = options.get('owner', config.get('owner', 'root'))
+        group = options.get('group', config.get('group', 'root'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_ownership(owner, group, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_ownership(owner, group, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_permissions(config):
+    """Verify that permissions on configuration files are secure enough."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        mode = options.get('mode', config.get('permissions', '600'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_mode(mode, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_mode(mode, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_keystone(audit_options):
+    """Validate that the service uses Keystone for authentication."""
+    section = _config_section(audit_options, 'api') or _config_section(audit_options, 'DEFAULT')
+    assert section is not None, "Missing section 'api / DEFAULT'"
+    assert section.get('auth_strategy') == "keystone", \
+        "Application is not using Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_keystone(audit_options):
+    """Verify that TLS is used to communicate with Keystone."""
+    section = _config_section(audit_options, 'keystone_authtoken')
+    assert section is not None, "Missing section 'keystone_authtoken'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("auth_uri"), \
+        "TLS is not used for Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_glance(audit_options):
+    """Verify that TLS is used to communicate with Glance."""
+    section = _config_section(audit_options, 'glance')
+    assert section is not None, "Missing section 'glance'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("api_servers"), \
+        "TLS is not used for Glance"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/cert_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/cert_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b494af64aeae55db44b669990725de81705104b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/cert_utils.py
@@ -0,0 +1,289 @@
+# Copyright 2014-2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charm certificats.
+
+import os
+import json
+
+from charmhelpers.contrib.network.ip import (
+    get_hostname,
+    resolve_network_cidr,
+)
+from charmhelpers.core.hookenv import (
+    local_unit,
+    network_get_primary_address,
+    config,
+    related_units,
+    relation_get,
+    relation_ids,
+    unit_get,
+    NoNetworkBinding,
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.openstack.ip import (
+    ADMIN,
+    resolve_address,
+    get_vip_in_network,
+    INTERNAL,
+    PUBLIC,
+    ADDRESS_MAP)
+
+from charmhelpers.core.host import (
+    mkdir,
+    write_file,
+)
+
+from charmhelpers.contrib.hahelpers.apache import (
+    install_ca_cert
+)
+
+
+class CertRequest(object):
+
+    """Create a request for certificates to be generated
+    """
+
+    def __init__(self, json_encode=True):
+        self.entries = []
+        self.hostname_entry = None
+        self.json_encode = json_encode
+
+    def add_entry(self, net_type, cn, addresses):
+        """Add a request to the batch
+
+        :param net_type: str netwrok space name request is for
+        :param cn: str Canonical Name for certificate
+        :param addresses: [] List of addresses to be used as SANs
+        """
+        self.entries.append({
+            'cn': cn,
+            'addresses': addresses})
+
+    def add_hostname_cn(self):
+        """Add a request for the hostname of the machine"""
+        ip = unit_get('private-address')
+        addresses = [ip]
+        # If a vip is being used without os-hostname config or
+        # network spaces then we need to ensure the local units
+        # cert has the approriate vip in the SAN list
+        vip = get_vip_in_network(resolve_network_cidr(ip))
+        if vip:
+            addresses.append(vip)
+        self.hostname_entry = {
+            'cn': get_hostname(ip),
+            'addresses': addresses}
+
+    def add_hostname_cn_ip(self, addresses):
+        """Add an address to the SAN list for the hostname request
+
+        :param addr: [] List of address to be added
+        """
+        for addr in addresses:
+            if addr not in self.hostname_entry['addresses']:
+                self.hostname_entry['addresses'].append(addr)
+
+    def get_request(self):
+        """Generate request from the batched up entries
+
+        """
+        if self.hostname_entry:
+            self.entries.append(self.hostname_entry)
+        request = {}
+        for entry in self.entries:
+            sans = sorted(list(set(entry['addresses'])))
+            request[entry['cn']] = {'sans': sans}
+        if self.json_encode:
+            req = {'cert_requests': json.dumps(request, sort_keys=True)}
+        else:
+            req = {'cert_requests': request}
+        req['unit_name'] = local_unit().replace('/', '_')
+        return req
+
+
+def get_certificate_request(json_encode=True):
+    """Generate a certificatee requests based on the network confioguration
+
+    """
+    req = CertRequest(json_encode=json_encode)
+    req.add_hostname_cn()
+    # Add os-hostname entries
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        net_config = config(ADDRESS_MAP[net_type]['override'])
+        try:
+            net_addr = resolve_address(endpoint_type=net_type)
+            ip = network_get_primary_address(
+                ADDRESS_MAP[net_type]['binding'])
+            addresses = [net_addr, ip]
+            vip = get_vip_in_network(resolve_network_cidr(ip))
+            if vip:
+                addresses.append(vip)
+            if net_config:
+                req.add_entry(
+                    net_type,
+                    net_config,
+                    addresses)
+            else:
+                # There is network address with no corresponding hostname.
+                # Add the ip to the hostname cert to allow for this.
+                req.add_hostname_cn_ip(addresses)
+        except NoNetworkBinding:
+            log("Skipping request for certificate for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    return req.get_request()
+
+
+def create_ip_cert_links(ssl_dir, custom_hostname_link=None):
+    """Create symlinks for SAN records
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param custom_hostname_link: str Additional link to be created
+    """
+    hostname = get_hostname(unit_get('private-address'))
+    hostname_cert = os.path.join(
+        ssl_dir,
+        'cert_{}'.format(hostname))
+    hostname_key = os.path.join(
+        ssl_dir,
+        'key_{}'.format(hostname))
+    # Add links to hostname cert, used if os-hostname vars not set
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        try:
+            addr = resolve_address(endpoint_type=net_type)
+            cert = os.path.join(ssl_dir, 'cert_{}'.format(addr))
+            key = os.path.join(ssl_dir, 'key_{}'.format(addr))
+            if os.path.isfile(hostname_cert) and not os.path.isfile(cert):
+                os.symlink(hostname_cert, cert)
+                os.symlink(hostname_key, key)
+        except NoNetworkBinding:
+            log("Skipping creating cert symlink for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    if custom_hostname_link:
+        custom_cert = os.path.join(
+            ssl_dir,
+            'cert_{}'.format(custom_hostname_link))
+        custom_key = os.path.join(
+            ssl_dir,
+            'key_{}'.format(custom_hostname_link))
+        if os.path.isfile(hostname_cert) and not os.path.isfile(custom_cert):
+            os.symlink(hostname_cert, custom_cert)
+            os.symlink(hostname_key, custom_key)
+
+
+def install_certs(ssl_dir, certs, chain=None, user='root', group='root'):
+    """Install the certs passed into the ssl dir and append the chain if
+       provided.
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param certs: {} {'cn': {'cert': 'CERT', 'key': 'KEY'}}
+    :param chain: str Chain to be appended to certs
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    """
+    for cn, bundle in certs.items():
+        cert_filename = 'cert_{}'.format(cn)
+        key_filename = 'key_{}'.format(cn)
+        cert_data = bundle['cert']
+        if chain:
+            # Append chain file so that clients that trust the root CA will
+            # trust certs signed by an intermediate in the chain
+            cert_data = cert_data + os.linesep + chain
+        write_file(
+            path=os.path.join(ssl_dir, cert_filename), owner=user, group=group,
+            content=cert_data, perms=0o640)
+        write_file(
+            path=os.path.join(ssl_dir, key_filename), owner=user, group=group,
+            content=bundle['key'], perms=0o640)
+
+
+def process_certificates(service_name, relation_id, unit,
+                         custom_hostname_link=None, user='root', group='root'):
+    """Process the certificates supplied down the relation
+
+    :param service_name: str Name of service the certifcates are for.
+    :param relation_id: str Relation id providing the certs
+    :param unit: str Unit providing the certs
+    :param custom_hostname_link: str Name of custom link to create
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    :returns: True if certificates processed for local unit or False
+    :rtype: bool
+    """
+    data = relation_get(rid=relation_id, unit=unit)
+    ssl_dir = os.path.join('/etc/apache2/ssl/', service_name)
+    mkdir(path=ssl_dir)
+    name = local_unit().replace('/', '_')
+    certs = data.get('{}.processed_requests'.format(name))
+    chain = data.get('chain')
+    ca = data.get('ca')
+    if certs:
+        certs = json.loads(certs)
+        install_ca_cert(ca.encode())
+        install_certs(ssl_dir, certs, chain, user=user, group=group)
+        create_ip_cert_links(
+            ssl_dir,
+            custom_hostname_link=custom_hostname_link)
+        return True
+    return False
+
+
+def get_requests_for_local_unit(relation_name=None):
+    """Extract any certificates data targeted at this unit down relation_name.
+
+    :param relation_name: str Name of relation to check for data.
+    :returns: List of bundles of certificates.
+    :rtype: List of dicts
+    """
+    local_name = local_unit().replace('/', '_')
+    raw_certs_key = '{}.processed_requests'.format(local_name)
+    relation_name = relation_name or 'certificates'
+    bundles = []
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            data = relation_get(rid=rid, unit=unit)
+            if data.get(raw_certs_key):
+                bundles.append({
+                    'ca': data['ca'],
+                    'chain': data.get('chain'),
+                    'certs': json.loads(data[raw_certs_key])})
+    return bundles
+
+
+def get_bundle_for_cn(cn, relation_name=None):
+    """Extract certificates for the given cn.
+
+    :param cn: str Canonical Name on certificate.
+    :param relation_name: str Relation to check for certificates down.
+    :returns: Dictionary of certificate data,
+    :rtype: dict.
+    """
+    entries = get_requests_for_local_unit(relation_name)
+    cert_bundle = {}
+    for entry in entries:
+        for _cn, bundle in entry['certs'].items():
+            if _cn == cn:
+                cert_bundle = {
+                    'cert': bundle['cert'],
+                    'key': bundle['key'],
+                    'chain': entry['chain'],
+                    'ca': entry['ca']}
+                break
+        if cert_bundle:
+            break
+    return cert_bundle
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..42abccf7cb9eabc063bc8d87f016e59f4dc8f898
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/context.py
@@ -0,0 +1,3177 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import copy
+import enum
+import glob
+import hashlib
+import json
+import math
+import os
+import re
+import socket
+import time
+
+from base64 import b64decode
+from subprocess import check_call, CalledProcessError
+
+import six
+
+from charmhelpers.contrib.openstack.audits.openstack_security_guide import (
+    _config_ini as config_ini
+)
+
+from charmhelpers.fetch import (
+    apt_install,
+    filter_installed_packages,
+)
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    is_relation_made,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    related_units,
+    relation_set,
+    unit_get,
+    unit_private_ip,
+    charm_name,
+    DEBUG,
+    INFO,
+    ERROR,
+    status_set,
+    network_get_primary_address,
+    WARNING,
+)
+
+from charmhelpers.core.sysctl import create as sysctl_create
+from charmhelpers.core.strutils import bool_from_string
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+
+from charmhelpers.core.host import (
+    get_bond_master,
+    is_phy_iface,
+    list_nics,
+    get_nic_hwaddr,
+    mkdir,
+    write_file,
+    pwgen,
+    lsb_release,
+    CompareHostReleases,
+    is_container,
+)
+from charmhelpers.contrib.hahelpers.cluster import (
+    determine_apache_port,
+    determine_api_port,
+    https,
+    is_clustered,
+)
+from charmhelpers.contrib.hahelpers.apache import (
+    get_cert,
+    get_ca_cert,
+    install_ca_cert,
+)
+from charmhelpers.contrib.openstack.neutron import (
+    neutron_plugin_attribute,
+    parse_data_port_mappings,
+)
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    INTERNAL,
+    ADMIN,
+    PUBLIC,
+    ADDRESS_MAP,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_ipv4_addr,
+    get_ipv6_addr,
+    get_netmask_for_address,
+    format_ipv6_addr,
+    is_bridge_member,
+    is_ipv6_disabled,
+    get_relation_ip,
+)
+from charmhelpers.contrib.openstack.utils import (
+    config_flags_parser,
+    get_os_codename_install_source,
+    enable_memcache,
+    CompareOpenStackReleases,
+    os_release,
+)
+from charmhelpers.core.unitdata import kv
+
+try:
+    from sriov_netplan_shim import pci
+except ImportError:
+    # The use of the function and contexts that require the pci module is
+    # optional.
+    pass
+
+try:
+    import psutil
+except ImportError:
+    if six.PY2:
+        apt_install('python-psutil', fatal=True)
+    else:
+        apt_install('python3-psutil', fatal=True)
+    import psutil
+
+CA_CERT_PATH = '/usr/local/share/ca-certificates/keystone_juju_ca_cert.crt'
+ADDRESS_TYPES = ['admin', 'internal', 'public']
+HAPROXY_RUN_DIR = '/var/run/haproxy/'
+DEFAULT_OSLO_MESSAGING_DRIVER = "messagingv2"
+
+
+def ensure_packages(packages):
+    """Install but do not upgrade required plugin packages."""
+    required = filter_installed_packages(packages)
+    if required:
+        apt_install(required, fatal=True)
+
+
+def context_complete(ctxt):
+    _missing = []
+    for k, v in six.iteritems(ctxt):
+        if v is None or v == '':
+            _missing.append(k)
+
+    if _missing:
+        log('Missing required data: %s' % ' '.join(_missing), level=INFO)
+        return False
+
+    return True
+
+
+class OSContextGenerator(object):
+    """Base class for all context generators."""
+    interfaces = []
+    related = False
+    complete = False
+    missing_data = []
+
+    def __call__(self):
+        raise NotImplementedError
+
+    def context_complete(self, ctxt):
+        """Check for missing data for the required context data.
+        Set self.missing_data if it exists and return False.
+        Set self.complete if no missing data and return True.
+        """
+        # Fresh start
+        self.complete = False
+        self.missing_data = []
+        for k, v in six.iteritems(ctxt):
+            if v is None or v == '':
+                if k not in self.missing_data:
+                    self.missing_data.append(k)
+
+        if self.missing_data:
+            self.complete = False
+            log('Missing required data: %s' % ' '.join(self.missing_data),
+                level=INFO)
+        else:
+            self.complete = True
+        return self.complete
+
+    def get_related(self):
+        """Check if any of the context interfaces have relation ids.
+        Set self.related and return True if one of the interfaces
+        has relation ids.
+        """
+        # Fresh start
+        self.related = False
+        try:
+            for interface in self.interfaces:
+                if relation_ids(interface):
+                    self.related = True
+            return self.related
+        except AttributeError as e:
+            log("{} {}"
+                "".format(self, e), 'INFO')
+            return self.related
+
+
+class SharedDBContext(OSContextGenerator):
+    interfaces = ['shared-db']
+
+    def __init__(self, database=None, user=None, relation_prefix=None,
+                 ssl_dir=None, relation_id=None):
+        """Allows inspecting relation for settings prefixed with
+        relation_prefix. This is useful for parsing access for multiple
+        databases returned via the shared-db interface (eg, nova_password,
+        quantum_password)
+        """
+        self.relation_prefix = relation_prefix
+        self.database = database
+        self.user = user
+        self.ssl_dir = ssl_dir
+        self.rel_name = self.interfaces[0]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        self.user = self.user or config('database-user')
+        if None in [self.database, self.user]:
+            log("Could not generate shared_db context. Missing required charm "
+                "config options. (database name and user)", level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+
+        # NOTE(jamespage) if mysql charm provides a network upon which
+        # access to the database should be made, reconfigure relation
+        # with the service units local address and defer execution
+        access_network = relation_get('access-network')
+        if access_network is not None:
+            if self.relation_prefix is not None:
+                hostname_key = "{}_hostname".format(self.relation_prefix)
+            else:
+                hostname_key = "hostname"
+            access_hostname = get_address_in_network(
+                access_network,
+                unit_get('private-address'))
+            set_hostname = relation_get(attribute=hostname_key,
+                                        unit=local_unit())
+            if set_hostname != access_hostname:
+                relation_set(relation_settings={hostname_key: access_hostname})
+                return None  # Defer any further hook execution for now....
+
+        password_setting = 'password'
+        if self.relation_prefix:
+            password_setting = self.relation_prefix + '_password'
+
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.interfaces[0])
+
+        rel = (get_os_codename_install_source(config('openstack-origin')) or
+               'icehouse')
+        for rid in rids:
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                host = rdata.get('db_host')
+                host = format_ipv6_addr(host) or host
+                ctxt = {
+                    'database_host': host,
+                    'database': self.database,
+                    'database_user': self.user,
+                    'database_password': rdata.get(password_setting),
+                    'database_type': 'mysql+pymysql'
+                }
+                # Port is being introduced with LP Bug #1876188
+                # but it not currently required and may not be set in all
+                # cases, particularly in classic charms.
+                port = rdata.get('db_port')
+                if port:
+                    ctxt['database_port'] = port
+                if CompareOpenStackReleases(rel) < 'queens':
+                    ctxt['database_type'] = 'mysql'
+                if self.context_complete(ctxt):
+                    db_ssl(rdata, ctxt, self.ssl_dir)
+                    return ctxt
+        return {}
+
+
+class PostgresqlDBContext(OSContextGenerator):
+    interfaces = ['pgsql-db']
+
+    def __init__(self, database=None):
+        self.database = database
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        if self.database is None:
+            log('Could not generate postgresql_db context. Missing required '
+                'charm config options. (database name)', level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        for rid in relation_ids(self.interfaces[0]):
+            self.related = True
+            for unit in related_units(rid):
+                rel_host = relation_get('host', rid=rid, unit=unit)
+                rel_user = relation_get('user', rid=rid, unit=unit)
+                rel_passwd = relation_get('password', rid=rid, unit=unit)
+                ctxt = {'database_host': rel_host,
+                        'database': self.database,
+                        'database_user': rel_user,
+                        'database_password': rel_passwd,
+                        'database_type': 'postgresql'}
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+def db_ssl(rdata, ctxt, ssl_dir):
+    if 'ssl_ca' in rdata and ssl_dir:
+        ca_path = os.path.join(ssl_dir, 'db-client.ca')
+        with open(ca_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_ca']))
+
+        ctxt['database_ssl_ca'] = ca_path
+    elif 'ssl_ca' in rdata:
+        log("Charm not setup for ssl support but ssl ca found", level=INFO)
+        return ctxt
+
+    if 'ssl_cert' in rdata:
+        cert_path = os.path.join(
+            ssl_dir, 'db-client.cert')
+        if not os.path.exists(cert_path):
+            log("Waiting 1m for ssl client cert validity", level=INFO)
+            time.sleep(60)
+
+        with open(cert_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_cert']))
+
+        ctxt['database_ssl_cert'] = cert_path
+        key_path = os.path.join(ssl_dir, 'db-client.key')
+        with open(key_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_key']))
+
+        ctxt['database_ssl_key'] = key_path
+
+    return ctxt
+
+
+class IdentityServiceContext(OSContextGenerator):
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-service'):
+        self.service = service
+        self.service_user = service_user
+        self.rel_name = rel_name
+        self.interfaces = [self.rel_name]
+
+    def _setup_pki_cache(self):
+        if self.service and self.service_user:
+            # This is required for pki token signing if we don't want /tmp to
+            # be used.
+            cachedir = '/var/cache/%s' % (self.service)
+            if not os.path.isdir(cachedir):
+                log("Creating service cache dir %s" % (cachedir), level=DEBUG)
+                mkdir(path=cachedir, owner=self.service_user,
+                      group=self.service_user, perms=0o700)
+
+            return cachedir
+        return None
+
+    def _get_pkg_name(self, python_name='keystonemiddleware'):
+        """Get corresponding distro installed package for python
+        package name.
+
+        :param python_name: nameof the python package
+        :type: string
+        """
+        pkg_names = map(lambda x: x + python_name, ('python3-', 'python-'))
+
+        for pkg in pkg_names:
+            if not filter_installed_packages((pkg,)):
+                return pkg
+
+        return None
+
+    def _get_keystone_authtoken_ctxt(self, ctxt, keystonemiddleware_os_rel):
+        """Build Jinja2 context for full rendering of [keystone_authtoken]
+        section with variable names included. Re-constructed from former
+        template 'section-keystone-auth-mitaka'.
+
+        :param ctxt: Jinja2 context returned from self.__call__()
+        :type: dict
+        :param keystonemiddleware_os_rel: OpenStack release name of
+            keystonemiddleware package installed
+        """
+        c = collections.OrderedDict((('auth_type', 'password'),))
+
+        # 'www_authenticate_uri' replaced 'auth_uri' since Stein,
+        # see keystonemiddleware upstream sources for more info
+        if CompareOpenStackReleases(keystonemiddleware_os_rel) >= 'stein':
+            c.update((
+                ('www_authenticate_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+        else:
+            c.update((
+                ('auth_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+
+        c.update((
+            ('auth_url', "{}://{}:{}/v3".format(
+                ctxt.get('auth_protocol', ''),
+                ctxt.get('auth_host', ''),
+                ctxt.get('auth_port', ''))),
+            ('project_domain_name', ctxt.get('admin_domain_name', '')),
+            ('user_domain_name', ctxt.get('admin_domain_name', '')),
+            ('project_name', ctxt.get('admin_tenant_name', '')),
+            ('username', ctxt.get('admin_user', '')),
+            ('password', ctxt.get('admin_password', '')),
+            ('signing_dir', ctxt.get('signing_dir', '')),))
+
+        return c
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        keystonemiddleware_os_release = None
+        if self._get_pkg_name():
+            keystonemiddleware_os_release = os_release(self._get_pkg_name())
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                serv_host = rdata.get('service_host')
+                serv_host = format_ipv6_addr(serv_host) or serv_host
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('service_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({'service_port': rdata.get('service_port'),
+                             'service_host': serv_host,
+                             'auth_host': auth_host,
+                             'auth_port': rdata.get('auth_port'),
+                             'admin_tenant_name': rdata.get('service_tenant'),
+                             'admin_user': rdata.get('service_username'),
+                             'admin_password': rdata.get('service_password'),
+                             'service_protocol': svc_protocol,
+                             'auth_protocol': auth_protocol,
+                             'api_version': api_version})
+
+                if float(api_version) > 2:
+                    ctxt.update({
+                        'admin_domain_name': rdata.get('service_domain'),
+                        'service_project_id': rdata.get('service_tenant_id'),
+                        'service_domain_id': rdata.get('service_domain_id')})
+
+                # we keep all veriables in ctxt for compatibility and
+                # add nested dictionary for keystone_authtoken generic
+                # templating
+                if keystonemiddleware_os_release:
+                    ctxt['keystone_authtoken'] = \
+                        self._get_keystone_authtoken_ctxt(
+                            ctxt, keystonemiddleware_os_release)
+
+                if self.context_complete(ctxt):
+                    # NOTE(jamespage) this is required for >= icehouse
+                    # so a missing value just indicates keystone needs
+                    # upgrading
+                    ctxt['admin_tenant_id'] = rdata.get('service_tenant_id')
+                    ctxt['admin_domain_id'] = rdata.get('service_domain_id')
+                    return ctxt
+
+        return {}
+
+
+class IdentityCredentialsContext(IdentityServiceContext):
+    '''Context for identity-credentials interface type'''
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-credentials'):
+        super(IdentityCredentialsContext, self).__init__(service,
+                                                         service_user,
+                                                         rel_name)
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                credentials_host = rdata.get('credentials_host')
+                credentials_host = (
+                    format_ipv6_addr(credentials_host) or credentials_host
+                )
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('credentials_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({
+                    'service_port': rdata.get('credentials_port'),
+                    'service_host': credentials_host,
+                    'auth_host': auth_host,
+                    'auth_port': rdata.get('auth_port'),
+                    'admin_tenant_name': rdata.get('credentials_project'),
+                    'admin_tenant_id': rdata.get('credentials_project_id'),
+                    'admin_user': rdata.get('credentials_username'),
+                    'admin_password': rdata.get('credentials_password'),
+                    'service_protocol': svc_protocol,
+                    'auth_protocol': auth_protocol,
+                    'api_version': api_version
+                })
+
+                if float(api_version) > 2:
+                    ctxt.update({'admin_domain_name':
+                                 rdata.get('domain')})
+
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+class NovaVendorMetadataContext(OSContextGenerator):
+    """Context used for configuring nova vendor metadata on nova.conf file."""
+
+    def __init__(self, os_release_pkg, interfaces=None):
+        """Initialize the NovaVendorMetadataContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        :param interfaces: list of string values to be used as the Context's
+            relation interfaces.
+        :type interfaces: List[str]
+        """
+        self.os_release_pkg = os_release_pkg
+        if interfaces is not None:
+            self.interfaces = interfaces
+
+    def __call__(self):
+        cmp_os_release = CompareOpenStackReleases(
+            os_release(self.os_release_pkg))
+        ctxt = {'vendor_data': False}
+
+        vdata_providers = []
+        vdata = config('vendor-data')
+        vdata_url = config('vendor-data-url')
+
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we do not set anything here
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data'] = True
+                # Mitaka does not support DynamicJSON
+                # so vendordata_providers is not needed
+                if cmp_os_release > 'mitaka':
+                    vdata_providers.append('StaticJSON')
+
+        if vdata_url:
+            if cmp_os_release > 'mitaka':
+                ctxt['vendor_data_url'] = vdata_url
+                vdata_providers.append('DynamicJSON')
+            else:
+                log('Dynamic vendor data unsupported'
+                    ' for {}.'.format(cmp_os_release), level=ERROR)
+        if vdata_providers:
+            ctxt['vendordata_providers'] = ','.join(vdata_providers)
+
+        return ctxt
+
+
+class NovaVendorMetadataJSONContext(OSContextGenerator):
+    """Context used for writing nova vendor metadata json file."""
+
+    def __init__(self, os_release_pkg):
+        """Initialize the NovaVendorMetadataJSONContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        """
+        self.os_release_pkg = os_release_pkg
+
+    def __call__(self):
+        ctxt = {'vendor_data_json': '{}'}
+
+        vdata = config('vendor-data')
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we return empty.
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data_json'] = vdata
+
+        return ctxt
+
+
+class AMQPContext(OSContextGenerator):
+
+    def __init__(self, ssl_dir=None, rel_name='amqp', relation_prefix=None,
+                 relation_id=None):
+        self.ssl_dir = ssl_dir
+        self.rel_name = rel_name
+        self.relation_prefix = relation_prefix
+        self.interfaces = [rel_name]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        log('Generating template context for amqp', level=DEBUG)
+        conf = config()
+        if self.relation_prefix:
+            user_setting = '%s-rabbit-user' % (self.relation_prefix)
+            vhost_setting = '%s-rabbit-vhost' % (self.relation_prefix)
+        else:
+            user_setting = 'rabbit-user'
+            vhost_setting = 'rabbit-vhost'
+
+        try:
+            username = conf[user_setting]
+            vhost = conf[vhost_setting]
+        except KeyError as e:
+            log('Could not generate shared_db context. Missing required charm '
+                'config options: %s.' % e, level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.rel_name)
+        for rid in rids:
+            ha_vip_only = False
+            self.related = True
+            transport_hosts = None
+            rabbitmq_port = '5672'
+            for unit in related_units(rid):
+                if relation_get('clustered', rid=rid, unit=unit):
+                    ctxt['clustered'] = True
+                    vip = relation_get('vip', rid=rid, unit=unit)
+                    vip = format_ipv6_addr(vip) or vip
+                    ctxt['rabbitmq_host'] = vip
+                    transport_hosts = [vip]
+                else:
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    host = format_ipv6_addr(host) or host
+                    ctxt['rabbitmq_host'] = host
+                    transport_hosts = [host]
+
+                ctxt.update({
+                    'rabbitmq_user': username,
+                    'rabbitmq_password': relation_get('password', rid=rid,
+                                                      unit=unit),
+                    'rabbitmq_virtual_host': vhost,
+                })
+
+                ssl_port = relation_get('ssl_port', rid=rid, unit=unit)
+                if ssl_port:
+                    ctxt['rabbit_ssl_port'] = ssl_port
+                    rabbitmq_port = ssl_port
+
+                ssl_ca = relation_get('ssl_ca', rid=rid, unit=unit)
+                if ssl_ca:
+                    ctxt['rabbit_ssl_ca'] = ssl_ca
+
+                if relation_get('ha_queues', rid=rid, unit=unit) is not None:
+                    ctxt['rabbitmq_ha_queues'] = True
+
+                ha_vip_only = relation_get('ha-vip-only',
+                                           rid=rid, unit=unit) is not None
+
+                if self.context_complete(ctxt):
+                    if 'rabbit_ssl_ca' in ctxt:
+                        if not self.ssl_dir:
+                            log("Charm not setup for ssl support but ssl ca "
+                                "found", level=INFO)
+                            break
+
+                        ca_path = os.path.join(
+                            self.ssl_dir, 'rabbit-client-ca.pem')
+                        with open(ca_path, 'wb') as fh:
+                            fh.write(b64decode(ctxt['rabbit_ssl_ca']))
+                            ctxt['rabbit_ssl_ca'] = ca_path
+
+                    # Sufficient information found = break out!
+                    break
+
+            # Used for active/active rabbitmq >= grizzly
+            if (('clustered' not in ctxt or ha_vip_only) and
+                    len(related_units(rid)) > 1):
+                rabbitmq_hosts = []
+                for unit in related_units(rid):
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    if not relation_get('password', rid=rid, unit=unit):
+                        log(
+                            ("Skipping {} password not sent which indicates "
+                             "unit is not ready.".format(host)),
+                            level=DEBUG)
+                        continue
+                    host = format_ipv6_addr(host) or host
+                    rabbitmq_hosts.append(host)
+
+                rabbitmq_hosts = sorted(rabbitmq_hosts)
+                ctxt['rabbitmq_hosts'] = ','.join(rabbitmq_hosts)
+                transport_hosts = rabbitmq_hosts
+
+            if transport_hosts:
+                transport_url_hosts = ','.join([
+                    "{}:{}@{}:{}".format(ctxt['rabbitmq_user'],
+                                         ctxt['rabbitmq_password'],
+                                         host_,
+                                         rabbitmq_port)
+                    for host_ in transport_hosts])
+                ctxt['transport_url'] = "rabbit://{}/{}".format(
+                    transport_url_hosts, vhost)
+
+        oslo_messaging_flags = conf.get('oslo-messaging-flags', None)
+        if oslo_messaging_flags:
+            ctxt['oslo_messaging_flags'] = config_flags_parser(
+                oslo_messaging_flags)
+
+        oslo_messaging_driver = conf.get(
+            'oslo-messaging-driver', DEFAULT_OSLO_MESSAGING_DRIVER)
+        if oslo_messaging_driver:
+            ctxt['oslo_messaging_driver'] = oslo_messaging_driver
+
+        notification_format = conf.get('notification-format', None)
+        if notification_format:
+            ctxt['notification_format'] = notification_format
+
+        notification_topics = conf.get('notification-topics', None)
+        if notification_topics:
+            ctxt['notification_topics'] = notification_topics
+
+        send_notifications_to_logs = conf.get('send-notifications-to-logs', None)
+        if send_notifications_to_logs:
+            ctxt['send_notifications_to_logs'] = send_notifications_to_logs
+
+        if not self.complete:
+            return {}
+
+        return ctxt
+
+
+class CephContext(OSContextGenerator):
+    """Generates context for /etc/ceph/ceph.conf templates."""
+    interfaces = ['ceph']
+
+    def __call__(self):
+        if not relation_ids('ceph'):
+            return {}
+
+        log('Generating template context for ceph', level=DEBUG)
+        mon_hosts = []
+        ctxt = {
+            'use_syslog': str(config('use-syslog')).lower()
+        }
+        for rid in relation_ids('ceph'):
+            for unit in related_units(rid):
+                if not ctxt.get('auth'):
+                    ctxt['auth'] = relation_get('auth', rid=rid, unit=unit)
+                if not ctxt.get('key'):
+                    ctxt['key'] = relation_get('key', rid=rid, unit=unit)
+                if not ctxt.get('rbd_features'):
+                    default_features = relation_get('rbd-features', rid=rid, unit=unit)
+                    if default_features is not None:
+                        ctxt['rbd_features'] = default_features
+
+                ceph_addrs = relation_get('ceph-public-address', rid=rid,
+                                          unit=unit)
+                if ceph_addrs:
+                    for addr in ceph_addrs.split(' '):
+                        mon_hosts.append(format_ipv6_addr(addr) or addr)
+                else:
+                    priv_addr = relation_get('private-address', rid=rid,
+                                             unit=unit)
+                    mon_hosts.append(format_ipv6_addr(priv_addr) or priv_addr)
+
+        ctxt['mon_hosts'] = ' '.join(sorted(mon_hosts))
+
+        if not os.path.isdir('/etc/ceph'):
+            os.mkdir('/etc/ceph')
+
+        if not self.context_complete(ctxt):
+            return {}
+
+        ensure_packages(['ceph-common'])
+        return ctxt
+
+    def context_complete(self, ctxt):
+        """Overridden here to ensure the context is actually complete.
+
+        We set `key` and `auth` to None here, by default, to ensure
+        that the context will always evaluate to incomplete until the
+        Ceph relation has actually sent these details; otherwise,
+        there is a potential race condition between the relation
+        appearing and the first unit actually setting this data on the
+        relation.
+
+        :param ctxt: The current context members
+        :type ctxt: Dict[str, ANY]
+        :returns: True if the context is complete
+        :rtype: bool
+        """
+        if 'auth' not in ctxt or 'key' not in ctxt:
+            return False
+        return super(CephContext, self).context_complete(ctxt)
+
+
+class HAProxyContext(OSContextGenerator):
+    """Provides half a context for the haproxy template, which describes
+    all peers to be included in the cluster.  Each charm needs to include
+    its own context generator that describes the port mapping.
+
+    :side effect: mkdir is called on HAPROXY_RUN_DIR
+    """
+    interfaces = ['cluster']
+
+    def __init__(self, singlenode_mode=False,
+                 address_types=ADDRESS_TYPES):
+        self.address_types = address_types
+        self.singlenode_mode = singlenode_mode
+
+    def __call__(self):
+        if not os.path.isdir(HAPROXY_RUN_DIR):
+            mkdir(path=HAPROXY_RUN_DIR)
+        if not relation_ids('cluster') and not self.singlenode_mode:
+            return {}
+
+        l_unit = local_unit().replace('/', '-')
+        cluster_hosts = collections.OrderedDict()
+
+        # NOTE(jamespage): build out map of configured network endpoints
+        # and associated backends
+        for addr_type in self.address_types:
+            cfg_opt = 'os-{}-network'.format(addr_type)
+            # NOTE(thedac) For some reason the ADDRESS_MAP uses 'int' rather
+            # than 'internal'
+            if addr_type == 'internal':
+                _addr_map_type = INTERNAL
+            else:
+                _addr_map_type = addr_type
+            # Network spaces aware
+            laddr = get_relation_ip(ADDRESS_MAP[_addr_map_type]['binding'],
+                                    config(cfg_opt))
+            if laddr:
+                netmask = get_netmask_for_address(laddr)
+                cluster_hosts[laddr] = {
+                    'network': "{}/{}".format(laddr,
+                                              netmask),
+                    'backends': collections.OrderedDict([(l_unit,
+                                                          laddr)])
+                }
+                for rid in relation_ids('cluster'):
+                    for unit in sorted(related_units(rid)):
+                        # API Charms will need to set {addr_type}-address with
+                        # get_relation_ip(addr_type)
+                        _laddr = relation_get('{}-address'.format(addr_type),
+                                              rid=rid, unit=unit)
+                        if _laddr:
+                            _unit = unit.replace('/', '-')
+                            cluster_hosts[laddr]['backends'][_unit] = _laddr
+
+        # NOTE(jamespage) add backend based on get_relation_ip - this
+        # will either be the only backend or the fallback if no acls
+        # match in the frontend
+        # Network spaces aware
+        addr = get_relation_ip('cluster')
+        cluster_hosts[addr] = {}
+        netmask = get_netmask_for_address(addr)
+        cluster_hosts[addr] = {
+            'network': "{}/{}".format(addr, netmask),
+            'backends': collections.OrderedDict([(l_unit,
+                                                  addr)])
+        }
+        for rid in relation_ids('cluster'):
+            for unit in sorted(related_units(rid)):
+                # API Charms will need to set their private-address with
+                # get_relation_ip('cluster')
+                _laddr = relation_get('private-address',
+                                      rid=rid, unit=unit)
+                if _laddr:
+                    _unit = unit.replace('/', '-')
+                    cluster_hosts[addr]['backends'][_unit] = _laddr
+
+        ctxt = {
+            'frontends': cluster_hosts,
+            'default_backend': addr
+        }
+
+        if config('haproxy-server-timeout'):
+            ctxt['haproxy_server_timeout'] = config('haproxy-server-timeout')
+
+        if config('haproxy-client-timeout'):
+            ctxt['haproxy_client_timeout'] = config('haproxy-client-timeout')
+
+        if config('haproxy-queue-timeout'):
+            ctxt['haproxy_queue_timeout'] = config('haproxy-queue-timeout')
+
+        if config('haproxy-connect-timeout'):
+            ctxt['haproxy_connect_timeout'] = config('haproxy-connect-timeout')
+
+        if config('prefer-ipv6'):
+            ctxt['local_host'] = 'ip6-localhost'
+            ctxt['haproxy_host'] = '::'
+        else:
+            ctxt['local_host'] = '127.0.0.1'
+            ctxt['haproxy_host'] = '0.0.0.0'
+
+        ctxt['ipv6_enabled'] = not is_ipv6_disabled()
+
+        ctxt['stat_port'] = '8888'
+
+        db = kv()
+        ctxt['stat_password'] = db.get('stat-password')
+        if not ctxt['stat_password']:
+            ctxt['stat_password'] = db.set('stat-password',
+                                           pwgen(32))
+            db.flush()
+
+        for frontend in cluster_hosts:
+            if (len(cluster_hosts[frontend]['backends']) > 1 or
+                    self.singlenode_mode):
+                # Enable haproxy when we have enough peers.
+                log('Ensuring haproxy enabled in /etc/default/haproxy.',
+                    level=DEBUG)
+                with open('/etc/default/haproxy', 'w') as out:
+                    out.write('ENABLED=1\n')
+
+                return ctxt
+
+        log('HAProxy context is incomplete, this unit has no peers.',
+            level=INFO)
+        return {}
+
+
+class ImageServiceContext(OSContextGenerator):
+    interfaces = ['image-service']
+
+    def __call__(self):
+        """Obtains the glance API server from the image-service relation.
+        Useful in nova and cinder (currently).
+        """
+        log('Generating template context for image-service.', level=DEBUG)
+        rids = relation_ids('image-service')
+        if not rids:
+            return {}
+
+        for rid in rids:
+            for unit in related_units(rid):
+                api_server = relation_get('glance-api-server',
+                                          rid=rid, unit=unit)
+                if api_server:
+                    return {'glance_api_servers': api_server}
+
+        log("ImageService context is incomplete. Missing required relation "
+            "data.", level=INFO)
+        return {}
+
+
+class ApacheSSLContext(OSContextGenerator):
+    """Generates a context for an apache vhost configuration that configures
+    HTTPS reverse proxying for one or many endpoints.  Generated context
+    looks something like::
+
+        {
+            'namespace': 'cinder',
+            'private_address': 'iscsi.mycinderhost.com',
+            'endpoints': [(8776, 8766), (8777, 8767)]
+        }
+
+    The endpoints list consists of a tuples mapping external ports
+    to internal ports.
+    """
+    interfaces = ['https']
+
+    # charms should inherit this context and set external ports
+    # and service namespace accordingly.
+    external_ports = []
+    service_namespace = None
+    user = group = 'root'
+
+    def enable_modules(self):
+        cmd = ['a2enmod', 'ssl', 'proxy', 'proxy_http', 'headers']
+        check_call(cmd)
+
+    def configure_cert(self, cn=None):
+        ssl_dir = os.path.join('/etc/apache2/ssl/', self.service_namespace)
+        mkdir(path=ssl_dir)
+        cert, key = get_cert(cn)
+        if cert and key:
+            if cn:
+                cert_filename = 'cert_{}'.format(cn)
+                key_filename = 'key_{}'.format(cn)
+            else:
+                cert_filename = 'cert'
+                key_filename = 'key'
+
+            write_file(path=os.path.join(ssl_dir, cert_filename),
+                       content=b64decode(cert), owner=self.user,
+                       group=self.group, perms=0o640)
+            write_file(path=os.path.join(ssl_dir, key_filename),
+                       content=b64decode(key), owner=self.user,
+                       group=self.group, perms=0o640)
+
+    def configure_ca(self):
+        ca_cert = get_ca_cert()
+        if ca_cert:
+            install_ca_cert(b64decode(ca_cert))
+
+    def canonical_names(self):
+        """Figure out which canonical names clients will access this service.
+        """
+        cns = []
+        for r_id in relation_ids('identity-service'):
+            for unit in related_units(r_id):
+                rdata = relation_get(rid=r_id, unit=unit)
+                for k in rdata:
+                    if k.startswith('ssl_key_'):
+                        cns.append(k.lstrip('ssl_key_'))
+
+        return sorted(list(set(cns)))
+
+    def get_network_addresses(self):
+        """For each network configured, return corresponding address and
+           hostnamr or vip (if available).
+
+        Returns a list of tuples of the form:
+
+            [(address_in_net_a, hostname_in_net_a),
+             (address_in_net_b, hostname_in_net_b),
+             ...]
+
+            or, if no hostnames(s) available:
+
+            [(address_in_net_a, vip_in_net_a),
+             (address_in_net_b, vip_in_net_b),
+             ...]
+
+            or, if no vip(s) available:
+
+            [(address_in_net_a, address_in_net_a),
+             (address_in_net_b, address_in_net_b),
+             ...]
+        """
+        addresses = []
+        for net_type in [INTERNAL, ADMIN, PUBLIC]:
+            net_config = config(ADDRESS_MAP[net_type]['config'])
+            # NOTE(jamespage): Fallback must always be private address
+            #                  as this is used to bind services on the
+            #                  local unit.
+            fallback = unit_get("private-address")
+            if net_config:
+                addr = get_address_in_network(net_config,
+                                              fallback)
+            else:
+                try:
+                    addr = network_get_primary_address(
+                        ADDRESS_MAP[net_type]['binding']
+                    )
+                except (NotImplementedError, NoNetworkBinding):
+                    addr = fallback
+
+            endpoint = resolve_address(net_type)
+            addresses.append((addr, endpoint))
+
+        return sorted(set(addresses))
+
+    def __call__(self):
+        if isinstance(self.external_ports, six.string_types):
+            self.external_ports = [self.external_ports]
+
+        if not self.external_ports or not https():
+            return {}
+
+        use_keystone_ca = True
+        for rid in relation_ids('certificates'):
+            if related_units(rid):
+                use_keystone_ca = False
+
+        if use_keystone_ca:
+            self.configure_ca()
+
+        self.enable_modules()
+
+        ctxt = {'namespace': self.service_namespace,
+                'endpoints': [],
+                'ext_ports': []}
+
+        if use_keystone_ca:
+            cns = self.canonical_names()
+            if cns:
+                for cn in cns:
+                    self.configure_cert(cn)
+            else:
+                # Expect cert/key provided in config (currently assumed that ca
+                # uses ip for cn)
+                for net_type in (INTERNAL, ADMIN, PUBLIC):
+                    cn = resolve_address(endpoint_type=net_type)
+                    self.configure_cert(cn)
+
+        addresses = self.get_network_addresses()
+        for address, endpoint in addresses:
+            for api_port in self.external_ports:
+                ext_port = determine_apache_port(api_port,
+                                                 singlenode_mode=True)
+                int_port = determine_api_port(api_port, singlenode_mode=True)
+                portmap = (address, endpoint, int(ext_port), int(int_port))
+                ctxt['endpoints'].append(portmap)
+                ctxt['ext_ports'].append(int(ext_port))
+
+        ctxt['ext_ports'] = sorted(list(set(ctxt['ext_ports'])))
+        return ctxt
+
+
+class NeutronContext(OSContextGenerator):
+    interfaces = []
+
+    @property
+    def plugin(self):
+        return None
+
+    @property
+    def network_manager(self):
+        return None
+
+    @property
+    def packages(self):
+        return neutron_plugin_attribute(self.plugin, 'packages',
+                                        self.network_manager)
+
+    @property
+    def neutron_security_groups(self):
+        return None
+
+    def _ensure_packages(self):
+        for pkgs in self.packages:
+            ensure_packages(pkgs)
+
+    def ovs_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'ovs',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return ovs_ctxt
+
+    def nuage_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nuage_ctxt = {'core_plugin': driver,
+                      'neutron_plugin': 'vsp',
+                      'neutron_security_groups': self.neutron_security_groups,
+                      'local_ip': unit_private_ip(),
+                      'config': config}
+
+        return nuage_ctxt
+
+    def nvp_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nvp_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'nvp',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return nvp_ctxt
+
+    def n1kv_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        n1kv_config = neutron_plugin_attribute(self.plugin, 'config',
+                                               self.network_manager)
+        n1kv_user_config_flags = config('n1kv-config-flags')
+        restrict_policy_profiles = config('n1kv-restrict-policy-profiles')
+        n1kv_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'n1kv',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': n1kv_config,
+                     'vsm_ip': config('n1kv-vsm-ip'),
+                     'vsm_username': config('n1kv-vsm-username'),
+                     'vsm_password': config('n1kv-vsm-password'),
+                     'restrict_policy_profiles': restrict_policy_profiles}
+
+        if n1kv_user_config_flags:
+            flags = config_flags_parser(n1kv_user_config_flags)
+            n1kv_ctxt['user_config_flags'] = flags
+
+        return n1kv_ctxt
+
+    def calico_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        calico_ctxt = {'core_plugin': driver,
+                       'neutron_plugin': 'Calico',
+                       'neutron_security_groups': self.neutron_security_groups,
+                       'local_ip': unit_private_ip(),
+                       'config': config}
+
+        return calico_ctxt
+
+    def neutron_ctxt(self):
+        if https():
+            proto = 'https'
+        else:
+            proto = 'http'
+
+        if is_clustered():
+            host = config('vip')
+        else:
+            host = unit_get('private-address')
+
+        ctxt = {'network_manager': self.network_manager,
+                'neutron_url': '%s://%s:%s' % (proto, host, '9696')}
+        return ctxt
+
+    def pg_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'plumgrid',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+        return ovs_ctxt
+
+    def midonet_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        midonet_config = neutron_plugin_attribute(self.plugin, 'config',
+                                                  self.network_manager)
+        mido_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'midonet',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': midonet_config}
+
+        return mido_ctxt
+
+    def __call__(self):
+        if self.network_manager not in ['quantum', 'neutron']:
+            return {}
+
+        if not self.plugin:
+            return {}
+
+        ctxt = self.neutron_ctxt()
+
+        if self.plugin == 'ovs':
+            ctxt.update(self.ovs_ctxt())
+        elif self.plugin in ['nvp', 'nsx']:
+            ctxt.update(self.nvp_ctxt())
+        elif self.plugin == 'n1kv':
+            ctxt.update(self.n1kv_ctxt())
+        elif self.plugin == 'Calico':
+            ctxt.update(self.calico_ctxt())
+        elif self.plugin == 'vsp':
+            ctxt.update(self.nuage_ctxt())
+        elif self.plugin == 'plumgrid':
+            ctxt.update(self.pg_ctxt())
+        elif self.plugin == 'midonet':
+            ctxt.update(self.midonet_ctxt())
+
+        alchemy_flags = config('neutron-alchemy-flags')
+        if alchemy_flags:
+            flags = config_flags_parser(alchemy_flags)
+            ctxt['neutron_alchemy_flags'] = flags
+
+        return ctxt
+
+
+class NeutronPortContext(OSContextGenerator):
+
+    def resolve_ports(self, ports):
+        """Resolve NICs not yet bound to bridge(s)
+
+        If hwaddress provided then returns resolved hwaddress otherwise NIC.
+        """
+        if not ports:
+            return None
+
+        hwaddr_to_nic = {}
+        hwaddr_to_ip = {}
+        extant_nics = list_nics()
+
+        for nic in extant_nics:
+            # Ignore virtual interfaces (bond masters will be identified from
+            # their slaves)
+            if not is_phy_iface(nic):
+                continue
+
+            _nic = get_bond_master(nic)
+            if _nic:
+                log("Replacing iface '%s' with bond master '%s'" % (nic, _nic),
+                    level=DEBUG)
+                nic = _nic
+
+            hwaddr = get_nic_hwaddr(nic)
+            hwaddr_to_nic[hwaddr] = nic
+            addresses = get_ipv4_addr(nic, fatal=False)
+            addresses += get_ipv6_addr(iface=nic, fatal=False)
+            hwaddr_to_ip[hwaddr] = addresses
+
+        resolved = []
+        mac_regex = re.compile(r'([0-9A-F]{2}[:-]){5}([0-9A-F]{2})', re.I)
+        for entry in ports:
+            if re.match(mac_regex, entry):
+                # NIC is in known NICs and does NOT hace an IP address
+                if entry in hwaddr_to_nic and not hwaddr_to_ip[entry]:
+                    # If the nic is part of a bridge then don't use it
+                    if is_bridge_member(hwaddr_to_nic[entry]):
+                        continue
+
+                    # Entry is a MAC address for a valid interface that doesn't
+                    # have an IP address assigned yet.
+                    resolved.append(hwaddr_to_nic[entry])
+            elif entry in extant_nics:
+                # If the passed entry is not a MAC address and the interface
+                # exists, assume it's a valid interface, and that the user put
+                # it there on purpose (we can trust it to be the real external
+                # network).
+                resolved.append(entry)
+
+        # Ensure no duplicates
+        return list(set(resolved))
+
+
+class OSConfigFlagContext(OSContextGenerator):
+    """Provides support for user-defined config flags.
+
+    Users can define a comma-seperated list of key=value pairs
+    in the charm configuration and apply them at any point in
+    any file by using a template flag.
+
+    Sometimes users might want config flags inserted within a
+    specific section so this class allows users to specify the
+    template flag name, allowing for multiple template flags
+    (sections) within the same context.
+
+    NOTE: the value of config-flags may be a comma-separated list of
+          key=value pairs and some Openstack config files support
+          comma-separated lists as values.
+    """
+
+    def __init__(self, charm_flag='config-flags',
+                 template_flag='user_config_flags'):
+        """
+        :param charm_flag: config flags in charm configuration.
+        :param template_flag: insert point for user-defined flags in template
+                              file.
+        """
+        super(OSConfigFlagContext, self).__init__()
+        self._charm_flag = charm_flag
+        self._template_flag = template_flag
+
+    def __call__(self):
+        config_flags = config(self._charm_flag)
+        if not config_flags:
+            return {}
+
+        return {self._template_flag:
+                config_flags_parser(config_flags)}
+
+
+class LibvirtConfigFlagsContext(OSContextGenerator):
+    """
+    This context provides support for extending
+    the libvirt section through user-defined flags.
+    """
+    def __call__(self):
+        ctxt = {}
+        libvirt_flags = config('libvirt-flags')
+        if libvirt_flags:
+            ctxt['libvirt_flags'] = config_flags_parser(
+                libvirt_flags)
+        return ctxt
+
+
+class SubordinateConfigContext(OSContextGenerator):
+
+    """
+    Responsible for inspecting relations to subordinates that
+    may be exporting required config via a json blob.
+
+    The subordinate interface allows subordinates to export their
+    configuration requirements to the principle for multiple config
+    files and multiple services.  Ie, a subordinate that has interfaces
+    to both glance and nova may export to following yaml blob as json::
+
+        glance:
+            /etc/glance/glance-api.conf:
+                sections:
+                    DEFAULT:
+                        - [key1, value1]
+            /etc/glance/glance-registry.conf:
+                    MYSECTION:
+                        - [key2, value2]
+        nova:
+            /etc/nova/nova.conf:
+                sections:
+                    DEFAULT:
+                        - [key3, value3]
+
+
+    It is then up to the principle charms to subscribe this context to
+    the service+config file it is interestd in.  Configuration data will
+    be available in the template context, in glance's case, as::
+
+        ctxt = {
+            ... other context ...
+            'subordinate_configuration': {
+                'DEFAULT': {
+                    'key1': 'value1',
+                },
+                'MYSECTION': {
+                    'key2': 'value2',
+                },
+            }
+        }
+    """
+
+    def __init__(self, service, config_file, interface):
+        """
+        :param service     : Service name key to query in any subordinate
+                             data found
+        :param config_file : Service's config file to query sections
+        :param interface   : Subordinate interface to inspect
+        """
+        self.config_file = config_file
+        if isinstance(service, list):
+            self.services = service
+        else:
+            self.services = [service]
+        if isinstance(interface, list):
+            self.interfaces = interface
+        else:
+            self.interfaces = [interface]
+
+    def __call__(self):
+        ctxt = {'sections': {}}
+        rids = []
+        for interface in self.interfaces:
+            rids.extend(relation_ids(interface))
+        for rid in rids:
+            for unit in related_units(rid):
+                sub_config = relation_get('subordinate_configuration',
+                                          rid=rid, unit=unit)
+                if sub_config and sub_config != '':
+                    try:
+                        sub_config = json.loads(sub_config)
+                    except Exception:
+                        log('Could not parse JSON from '
+                            'subordinate_configuration setting from %s'
+                            % rid, level=ERROR)
+                        continue
+
+                    for service in self.services:
+                        if service not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s service'
+                                % (rid, service), level=INFO)
+                            continue
+
+                        sub_config = sub_config[service]
+                        if self.config_file not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s'
+                                % (rid, self.config_file), level=INFO)
+                            continue
+
+                        sub_config = sub_config[self.config_file]
+                        for k, v in six.iteritems(sub_config):
+                            if k == 'sections':
+                                for section, config_list in six.iteritems(v):
+                                    log("adding section '%s'" % (section),
+                                        level=DEBUG)
+                                    if ctxt[k].get(section):
+                                        ctxt[k][section].extend(config_list)
+                                    else:
+                                        ctxt[k][section] = config_list
+                            else:
+                                ctxt[k] = v
+        log("%d section(s) found" % (len(ctxt['sections'])), level=DEBUG)
+        return ctxt
+
+
+class LogLevelContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['debug'] = \
+            False if config('debug') is None else config('debug')
+        ctxt['verbose'] = \
+            False if config('verbose') is None else config('verbose')
+
+        return ctxt
+
+
+class SyslogContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {'use_syslog': config('use-syslog')}
+        return ctxt
+
+
+class BindHostContext(OSContextGenerator):
+
+    def __call__(self):
+        if config('prefer-ipv6'):
+            return {'bind_host': '::'}
+        else:
+            return {'bind_host': '0.0.0.0'}
+
+
+MAX_DEFAULT_WORKERS = 4
+DEFAULT_MULTIPLIER = 2
+
+
+def _calculate_workers():
+    '''
+    Determine the number of worker processes based on the CPU
+    count of the unit containing the application.
+
+    Workers will be limited to MAX_DEFAULT_WORKERS in
+    container environments where no worker-multipler configuration
+    option been set.
+
+    @returns int: number of worker processes to use
+    '''
+    multiplier = config('worker-multiplier') or DEFAULT_MULTIPLIER
+    count = int(_num_cpus() * multiplier)
+    if multiplier > 0 and count == 0:
+        count = 1
+
+    if config('worker-multiplier') is None and is_container():
+        # NOTE(jamespage): Limit unconfigured worker-multiplier
+        #                  to MAX_DEFAULT_WORKERS to avoid insane
+        #                  worker configuration in LXD containers
+        #                  on large servers
+        # Reference: https://pad.lv/1665270
+        count = min(count, MAX_DEFAULT_WORKERS)
+
+    return count
+
+
+def _num_cpus():
+    '''
+    Compatibility wrapper for calculating the number of CPU's
+    a unit has.
+
+    @returns: int: number of CPU cores detected
+    '''
+    try:
+        return psutil.cpu_count()
+    except AttributeError:
+        return psutil.NUM_CPUS
+
+
+class WorkerConfigContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {"workers": _calculate_workers()}
+        return ctxt
+
+
+class WSGIWorkerConfigContext(WorkerConfigContext):
+
+    def __init__(self, name=None, script=None, admin_script=None,
+                 public_script=None, user=None, group=None,
+                 process_weight=1.00,
+                 admin_process_weight=0.25, public_process_weight=0.75):
+        self.service_name = name
+        self.user = user or name
+        self.group = group or name
+        self.script = script
+        self.admin_script = admin_script
+        self.public_script = public_script
+        self.process_weight = process_weight
+        self.admin_process_weight = admin_process_weight
+        self.public_process_weight = public_process_weight
+
+    def __call__(self):
+        total_processes = _calculate_workers()
+        ctxt = {
+            "service_name": self.service_name,
+            "user": self.user,
+            "group": self.group,
+            "script": self.script,
+            "admin_script": self.admin_script,
+            "public_script": self.public_script,
+            "processes": int(math.ceil(self.process_weight * total_processes)),
+            "admin_processes": int(math.ceil(self.admin_process_weight *
+                                             total_processes)),
+            "public_processes": int(math.ceil(self.public_process_weight *
+                                              total_processes)),
+            "threads": 1,
+        }
+        return ctxt
+
+
+class ZeroMQContext(OSContextGenerator):
+    interfaces = ['zeromq-configuration']
+
+    def __call__(self):
+        ctxt = {}
+        if is_relation_made('zeromq-configuration', 'host'):
+            for rid in relation_ids('zeromq-configuration'):
+                for unit in related_units(rid):
+                    ctxt['zmq_nonce'] = relation_get('nonce', unit, rid)
+                    ctxt['zmq_host'] = relation_get('host', unit, rid)
+                    ctxt['zmq_redis_address'] = relation_get(
+                        'zmq_redis_address', unit, rid)
+
+        return ctxt
+
+
+class NotificationDriverContext(OSContextGenerator):
+
+    def __init__(self, zmq_relation='zeromq-configuration',
+                 amqp_relation='amqp'):
+        """
+        :param zmq_relation: Name of Zeromq relation to check
+        """
+        self.zmq_relation = zmq_relation
+        self.amqp_relation = amqp_relation
+
+    def __call__(self):
+        ctxt = {'notifications': 'False'}
+        if is_relation_made(self.amqp_relation):
+            ctxt['notifications'] = "True"
+
+        return ctxt
+
+
+class SysctlContext(OSContextGenerator):
+    """This context check if the 'sysctl' option exists on configuration
+    then creates a file with the loaded contents"""
+    def __call__(self):
+        sysctl_dict = config('sysctl')
+        if sysctl_dict:
+            sysctl_create(sysctl_dict,
+                          '/etc/sysctl.d/50-{0}.conf'.format(charm_name()))
+        return {'sysctl': sysctl_dict}
+
+
+class NeutronAPIContext(OSContextGenerator):
+    '''
+    Inspects current neutron-plugin-api relation for neutron settings. Return
+    defaults if it is not present.
+    '''
+    interfaces = ['neutron-plugin-api']
+
+    def __call__(self):
+        self.neutron_defaults = {
+            'l2_population': {
+                'rel_key': 'l2-population',
+                'default': False,
+            },
+            'overlay_network_type': {
+                'rel_key': 'overlay-network-type',
+                'default': 'gre',
+            },
+            'neutron_security_groups': {
+                'rel_key': 'neutron-security-groups',
+                'default': False,
+            },
+            'network_device_mtu': {
+                'rel_key': 'network-device-mtu',
+                'default': None,
+            },
+            'enable_dvr': {
+                'rel_key': 'enable-dvr',
+                'default': False,
+            },
+            'enable_l3ha': {
+                'rel_key': 'enable-l3ha',
+                'default': False,
+            },
+            'dns_domain': {
+                'rel_key': 'dns-domain',
+                'default': None,
+            },
+            'polling_interval': {
+                'rel_key': 'polling-interval',
+                'default': 2,
+            },
+            'rpc_response_timeout': {
+                'rel_key': 'rpc-response-timeout',
+                'default': 60,
+            },
+            'report_interval': {
+                'rel_key': 'report-interval',
+                'default': 30,
+            },
+            'enable_qos': {
+                'rel_key': 'enable-qos',
+                'default': False,
+            },
+            'enable_nsg_logging': {
+                'rel_key': 'enable-nsg-logging',
+                'default': False,
+            },
+            'enable_nfg_logging': {
+                'rel_key': 'enable-nfg-logging',
+                'default': False,
+            },
+            'enable_port_forwarding': {
+                'rel_key': 'enable-port-forwarding',
+                'default': False,
+            },
+            'global_physnet_mtu': {
+                'rel_key': 'global-physnet-mtu',
+                'default': 1500,
+            },
+            'physical_network_mtus': {
+                'rel_key': 'physical-network-mtus',
+                'default': None,
+            },
+        }
+        ctxt = self.get_neutron_options({})
+        for rid in relation_ids('neutron-plugin-api'):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                # The l2-population key is used by the context as a way of
+                # checking if the api service on the other end is sending data
+                # in a recent format.
+                if 'l2-population' in rdata:
+                    ctxt.update(self.get_neutron_options(rdata))
+
+        extension_drivers = []
+
+        if ctxt['enable_qos']:
+            extension_drivers.append('qos')
+
+        if ctxt['enable_nsg_logging']:
+            extension_drivers.append('log')
+
+        ctxt['extension_drivers'] = ','.join(extension_drivers)
+
+        l3_extension_plugins = []
+
+        if ctxt['enable_port_forwarding']:
+            l3_extension_plugins.append('port_forwarding')
+
+        ctxt['l3_extension_plugins'] = l3_extension_plugins
+
+        return ctxt
+
+    def get_neutron_options(self, rdata):
+        settings = {}
+        for nkey in self.neutron_defaults.keys():
+            defv = self.neutron_defaults[nkey]['default']
+            rkey = self.neutron_defaults[nkey]['rel_key']
+            if rkey in rdata.keys():
+                if type(defv) is bool:
+                    settings[nkey] = bool_from_string(rdata[rkey])
+                else:
+                    settings[nkey] = rdata[rkey]
+            else:
+                settings[nkey] = defv
+        return settings
+
+
+class ExternalPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        ports = config('ext-port')
+        if ports:
+            ports = [p.strip() for p in ports.split()]
+            ports = self.resolve_ports(ports)
+            if ports:
+                ctxt = {"ext_port": ports[0]}
+                napi_settings = NeutronAPIContext()()
+                mtu = napi_settings.get('network_device_mtu')
+                if mtu:
+                    ctxt['ext_port_mtu'] = mtu
+
+        return ctxt
+
+
+class DataPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ports = config('data-port')
+        if ports:
+            # Map of {bridge:port/mac}
+            portmap = parse_data_port_mappings(ports)
+            ports = portmap.keys()
+            # Resolve provided ports or mac addresses and filter out those
+            # already attached to a bridge.
+            resolved = self.resolve_ports(ports)
+            # Rebuild port index using resolved and filtered ports.
+            normalized = {get_nic_hwaddr(port): port for port in resolved
+                          if port not in ports}
+            normalized.update({port: port for port in resolved
+                               if port in ports})
+            if resolved:
+                return {normalized[port]: bridge for port, bridge in
+                        six.iteritems(portmap) if port in normalized.keys()}
+
+        return None
+
+
+class PhyNICMTUContext(DataPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        mappings = super(PhyNICMTUContext, self).__call__()
+        if mappings and mappings.keys():
+            ports = sorted(mappings.keys())
+            napi_settings = NeutronAPIContext()()
+            mtu = napi_settings.get('network_device_mtu')
+            all_ports = set()
+            # If any of ports is a vlan device, its underlying device must have
+            # mtu applied first.
+            for port in ports:
+                for lport in glob.glob("/sys/class/net/%s/lower_*" % port):
+                    lport = os.path.basename(lport)
+                    all_ports.add(lport.split('_')[1])
+
+            all_ports = list(all_ports)
+            all_ports.extend(ports)
+            if mtu:
+                ctxt["devs"] = '\\n'.join(all_ports)
+                ctxt['mtu'] = mtu
+
+        return ctxt
+
+
+class NetworkServiceContext(OSContextGenerator):
+
+    def __init__(self, rel_name='quantum-network-service'):
+        self.rel_name = rel_name
+        self.interfaces = [rel_name]
+
+    def __call__(self):
+        for rid in relation_ids(self.rel_name):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                ctxt = {
+                    'keystone_host': rdata.get('keystone_host'),
+                    'service_port': rdata.get('service_port'),
+                    'auth_port': rdata.get('auth_port'),
+                    'service_tenant': rdata.get('service_tenant'),
+                    'service_username': rdata.get('service_username'),
+                    'service_password': rdata.get('service_password'),
+                    'quantum_host': rdata.get('quantum_host'),
+                    'quantum_port': rdata.get('quantum_port'),
+                    'quantum_url': rdata.get('quantum_url'),
+                    'region': rdata.get('region'),
+                    'service_protocol':
+                    rdata.get('service_protocol') or 'http',
+                    'auth_protocol':
+                    rdata.get('auth_protocol') or 'http',
+                    'api_version':
+                    rdata.get('api_version') or '2.0',
+                }
+                if self.context_complete(ctxt):
+                    return ctxt
+        return {}
+
+
+class InternalEndpointContext(OSContextGenerator):
+    """Internal endpoint context.
+
+    This context provides the endpoint type used for communication between
+    services e.g. between Nova and Cinder internally. Openstack uses Public
+    endpoints by default so this allows admins to optionally use internal
+    endpoints.
+    """
+    def __call__(self):
+        return {'use_internal_endpoints': config('use-internal-endpoints')}
+
+
+class VolumeAPIContext(InternalEndpointContext):
+    """Volume API context.
+
+    This context provides information regarding the volume endpoint to use
+    when communicating between services. It determines which version of the
+    API is appropriate for use.
+
+    This value will be determined in the resulting context dictionary
+    returned from calling the VolumeAPIContext object. Information provided
+    by this context is as follows:
+
+        volume_api_version: the volume api version to use, currently
+            'v2' or 'v3'
+        volume_catalog_info: the information to use for a cinder client
+            configuration that consumes API endpoints from the keystone
+            catalog. This is defined as the type:name:endpoint_type string.
+    """
+    # FIXME(wolsen) This implementation is based on the provider being able
+    # to specify the package version to check but does not guarantee that the
+    # volume service api version selected is available. In practice, it is
+    # quite likely the volume service *is* providing the v3 volume service.
+    # This should be resolved when the service-discovery spec is implemented.
+    def __init__(self, pkg):
+        """
+        Creates a new VolumeAPIContext for use in determining which version
+        of the Volume API should be used for communication. A package codename
+        should be supplied for determining the currently installed OpenStack
+        version.
+
+        :param pkg: the package codename to use in order to determine the
+            component version (e.g. nova-common). See
+            charmhelpers.contrib.openstack.utils.PACKAGE_CODENAMES for more.
+        """
+        super(VolumeAPIContext, self).__init__()
+        self._ctxt = None
+        if not pkg:
+            raise ValueError('package name must be provided in order to '
+                             'determine current OpenStack version.')
+        self.pkg = pkg
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """Determines the Volume API endpoint information.
+
+        Determines the appropriate version of the API that should be used
+        as well as the catalog_info string that would be supplied. Returns
+        a dict containing the volume_api_version and the volume_catalog_info.
+        """
+        rel = os_release(self.pkg)
+        version = '2'
+        if CompareOpenStackReleases(rel) >= 'pike':
+            version = '3'
+
+        service_type = 'volumev{version}'.format(version=version)
+        service_name = 'cinderv{version}'.format(version=version)
+        endpoint_type = 'publicURL'
+        if config('use-internal-endpoints'):
+            endpoint_type = 'internalURL'
+        catalog_info = '{type}:{name}:{endpoint}'.format(
+            type=service_type, name=service_name, endpoint=endpoint_type)
+
+        return {
+            'volume_api_version': version,
+            'volume_catalog_info': catalog_info,
+        }
+
+    def __call__(self):
+        return self.ctxt
+
+
+class AppArmorContext(OSContextGenerator):
+    """Base class for apparmor contexts."""
+
+    def __init__(self, profile_name=None):
+        self._ctxt = None
+        self.aa_profile = profile_name
+        self.aa_utils_packages = ['apparmor-utils']
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """
+        Validate aa-profile-mode settings is disable, enforce, or complain.
+
+        :return ctxt: Dictionary of the apparmor profile or None
+        """
+        if config('aa-profile-mode') in ['disable', 'enforce', 'complain']:
+            ctxt = {'aa_profile_mode': config('aa-profile-mode'),
+                    'ubuntu_release': lsb_release()['DISTRIB_RELEASE']}
+            if self.aa_profile:
+                ctxt['aa_profile'] = self.aa_profile
+        else:
+            ctxt = None
+        return ctxt
+
+    def __call__(self):
+        return self.ctxt
+
+    def install_aa_utils(self):
+        """
+        Install packages required for apparmor configuration.
+        """
+        log("Installing apparmor utils.")
+        ensure_packages(self.aa_utils_packages)
+
+    def manually_disable_aa_profile(self):
+        """
+        Manually disable an apparmor profile.
+
+        If aa-profile-mode is set to disabled (default) this is required as the
+        template has been written but apparmor is yet unaware of the profile
+        and aa-disable aa-profile fails. Without this the profile would kick
+        into enforce mode on the next service restart.
+
+        """
+        profile_path = '/etc/apparmor.d'
+        disable_path = '/etc/apparmor.d/disable'
+        if not os.path.lexists(os.path.join(disable_path, self.aa_profile)):
+            os.symlink(os.path.join(profile_path, self.aa_profile),
+                       os.path.join(disable_path, self.aa_profile))
+
+    def setup_aa_profile(self):
+        """
+        Setup an apparmor profile.
+        The ctxt dictionary will contain the apparmor profile mode and
+        the apparmor profile name.
+        Makes calls out to aa-disable, aa-complain, or aa-enforce to setup
+        the apparmor profile.
+        """
+        self()
+        if not self.ctxt:
+            log("Not enabling apparmor Profile")
+            return
+        self.install_aa_utils()
+        cmd = ['aa-{}'.format(self.ctxt['aa_profile_mode'])]
+        cmd.append(self.ctxt['aa_profile'])
+        log("Setting up the apparmor profile for {} in {} mode."
+            "".format(self.ctxt['aa_profile'], self.ctxt['aa_profile_mode']))
+        try:
+            check_call(cmd)
+        except CalledProcessError as e:
+            # If aa-profile-mode is set to disabled (default) manual
+            # disabling is required as the template has been written but
+            # apparmor is yet unaware of the profile and aa-disable aa-profile
+            # fails. If aa-disable learns to read profile files first this can
+            # be removed.
+            if self.ctxt['aa_profile_mode'] == 'disable':
+                log("Manually disabling the apparmor profile for {}."
+                    "".format(self.ctxt['aa_profile']))
+                self.manually_disable_aa_profile()
+                return
+            status_set('blocked', "Apparmor profile {} failed to be set to {}."
+                                  "".format(self.ctxt['aa_profile'],
+                                            self.ctxt['aa_profile_mode']))
+            raise e
+
+
+class MemcacheContext(OSContextGenerator):
+    """Memcache context
+
+    This context provides options for configuring a local memcache client and
+    server for both IPv4 and IPv6
+    """
+
+    def __init__(self, package=None):
+        """
+        @param package: Package to examine to extrapolate OpenStack release.
+                        Used when charms have no openstack-origin config
+                        option (ie subordinates)
+        """
+        self.package = package
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['use_memcache'] = enable_memcache(package=self.package)
+        if ctxt['use_memcache']:
+            # Trusty version of memcached does not support ::1 as a listen
+            # address so use host file entry instead
+            release = lsb_release()['DISTRIB_CODENAME'].lower()
+            if is_ipv6_disabled():
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '127.0.0.1'
+                else:
+                    ctxt['memcache_server'] = 'localhost'
+                ctxt['memcache_server_formatted'] = '127.0.0.1'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = '{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+            else:
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '::1'
+                else:
+                    ctxt['memcache_server'] = 'ip6-localhost'
+                ctxt['memcache_server_formatted'] = '[::1]'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = 'inet6:{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+        return ctxt
+
+
+class EnsureDirContext(OSContextGenerator):
+    '''
+    Serves as a generic context to create a directory as a side-effect.
+
+    Useful for software that supports drop-in files (.d) in conjunction
+    with config option-based templates. Examples include:
+        * OpenStack oslo.policy drop-in files;
+        * systemd drop-in config files;
+        * other software that supports overriding defaults with .d files
+
+    Another use-case is when a subordinate generates a configuration for
+    primary to render in a separate directory.
+
+    Some software requires a user to create a target directory to be
+    scanned for drop-in files with a specific format. This is why this
+    context is needed to do that before rendering a template.
+    '''
+
+    def __init__(self, dirname, **kwargs):
+        '''Used merely to ensure that a given directory exists.'''
+        self.dirname = dirname
+        self.kwargs = kwargs
+
+    def __call__(self):
+        mkdir(self.dirname, **self.kwargs)
+        return {}
+
+
+class VersionsContext(OSContextGenerator):
+    """Context to return the openstack and operating system versions.
+
+    """
+    def __init__(self, pkg='python-keystone'):
+        """Initialise context.
+
+        :param pkg: Package to extrapolate openstack version from.
+        :type pkg: str
+        """
+        self.pkg = pkg
+
+    def __call__(self):
+        ostack = os_release(self.pkg)
+        osystem = lsb_release()['DISTRIB_CODENAME'].lower()
+        return {
+            'openstack_release': ostack,
+            'operating_system_release': osystem}
+
+
+class LogrotateContext(OSContextGenerator):
+    """Common context generator for logrotate."""
+
+    def __init__(self, location, interval, count):
+        """
+        :param location: Absolute path for the logrotate config file
+        :type location: str
+        :param interval: The interval for the rotations. Valid values are
+                         'daily', 'weekly', 'monthly', 'yearly'
+        :type interval: str
+        :param count: The logrotate count option configures the 'count' times
+                      the log files are being rotated before being
+        :type count: int
+        """
+        self.location = location
+        self.interval = interval
+        self.count = 'rotate {}'.format(count)
+
+    def __call__(self):
+        ctxt = {
+            'logrotate_logs_location': self.location,
+            'logrotate_interval': self.interval,
+            'logrotate_count': self.count,
+        }
+        return ctxt
+
+
+class HostInfoContext(OSContextGenerator):
+    """Context to provide host information."""
+
+    def __init__(self, use_fqdn_hint_cb=None):
+        """Initialize HostInfoContext
+
+        :param use_fqdn_hint_cb: Callback whose return value used to populate
+                                 `use_fqdn_hint`
+        :type use_fqdn_hint_cb: Callable[[], bool]
+        """
+        # Store callback used to get hint for whether FQDN should be used
+
+        # Depending on the workload a charm manages, the use of FQDN vs.
+        # shortname may be a deploy-time decision, i.e. behaviour can not
+        # change on charm upgrade or post-deployment configuration change.
+
+        # The hint is passed on as a flag in the context to allow the decision
+        # to be made in the Jinja2 configuration template.
+        self.use_fqdn_hint_cb = use_fqdn_hint_cb
+
+    def _get_canonical_name(self, name=None):
+        """Get the official FQDN of the host
+
+        The implementation of ``socket.getfqdn()`` in the standard Python
+        library does not exhaust all methods of getting the official name
+        of a host ref Python issue https://bugs.python.org/issue5004
+
+        This function mimics the behaviour of a call to ``hostname -f`` to
+        get the official FQDN but returns an empty string if it is
+        unsuccessful.
+
+        :param name: Shortname to get FQDN on
+        :type name: Optional[str]
+        :returns: The official FQDN for host or empty string ('')
+        :rtype: str
+        """
+        name = name or socket.gethostname()
+        fqdn = ''
+
+        if six.PY2:
+            exc = socket.error
+        else:
+            exc = OSError
+
+        try:
+            addrs = socket.getaddrinfo(
+                name, None, 0, socket.SOCK_DGRAM, 0, socket.AI_CANONNAME)
+        except exc:
+            pass
+        else:
+            for addr in addrs:
+                if addr[3]:
+                    if '.' in addr[3]:
+                        fqdn = addr[3]
+                    break
+        return fqdn
+
+    def __call__(self):
+        name = socket.gethostname()
+        ctxt = {
+            'host_fqdn': self._get_canonical_name(name) or name,
+            'host': name,
+            'use_fqdn_hint': (
+                self.use_fqdn_hint_cb() if self.use_fqdn_hint_cb else False)
+        }
+        return ctxt
+
+
+def validate_ovs_use_veth(*args, **kwargs):
+    """Validate OVS use veth setting for dhcp agents
+
+    The ovs_use_veth setting is considered immutable as it will break existing
+    deployments. Historically, we set ovs_use_veth=True in dhcp_agent.ini. It
+    turns out this is no longer necessary. Ideally, all new deployments would
+    have this set to False.
+
+    This function validates that the config value does not conflict with
+    previously deployed settings in dhcp_agent.ini.
+
+    See LP Bug#1831935 for details.
+
+    :returns: Status state and message
+    :rtype: Union[(None, None), (string, string)]
+    """
+    existing_ovs_use_veth = (
+        DHCPAgentContext.get_existing_ovs_use_veth())
+    config_ovs_use_veth = DHCPAgentContext.parse_ovs_use_veth()
+
+    # Check settings are set and not None
+    if existing_ovs_use_veth is not None and config_ovs_use_veth is not None:
+        # Check for mismatch between existing config ini and juju config
+        if existing_ovs_use_veth != config_ovs_use_veth:
+            # Stop the line to avoid breakage
+            msg = (
+                "The existing setting for dhcp_agent.ini ovs_use_veth, {}, "
+                "does not match the juju config setting, {}. This may lead to "
+                "VMs being unable to receive a DHCP IP. Either change the "
+                "juju config setting or dhcp agents may need to be recreated."
+                .format(existing_ovs_use_veth, config_ovs_use_veth))
+            log(msg, ERROR)
+            return (
+                "blocked",
+                "Mismatched existing and configured ovs-use-veth. See log.")
+
+    # Everything is OK
+    return None, None
+
+
+class DHCPAgentContext(OSContextGenerator):
+
+    def __call__(self):
+        """Return the DHCPAGentContext.
+
+        Return all DHCP Agent INI related configuration.
+        ovs unit is attached to (as a subordinate) and the 'dns_domain' from
+        the neutron-plugin-api relations (if one is set).
+
+        :returns: Dictionary context
+        :rtype: Dict
+        """
+
+        ctxt = {}
+        dnsmasq_flags = config('dnsmasq-flags')
+        if dnsmasq_flags:
+            ctxt['dnsmasq_flags'] = config_flags_parser(dnsmasq_flags)
+        ctxt['dns_servers'] = config('dns-servers')
+
+        neutron_api_settings = NeutronAPIContext()()
+
+        ctxt['debug'] = config('debug')
+        ctxt['instance_mtu'] = config('instance-mtu')
+        ctxt['ovs_use_veth'] = self.get_ovs_use_veth()
+
+        ctxt['enable_metadata_network'] = config('enable-metadata-network')
+        ctxt['enable_isolated_metadata'] = config('enable-isolated-metadata')
+
+        if neutron_api_settings.get('dns_domain'):
+            ctxt['dns_domain'] = neutron_api_settings.get('dns_domain')
+
+        # Override user supplied config for these plugins as these settings are
+        # mandatory
+        if config('plugin') in ['nvp', 'nsx', 'n1kv']:
+            ctxt['enable_metadata_network'] = True
+            ctxt['enable_isolated_metadata'] = True
+
+        return ctxt
+
+    @staticmethod
+    def get_existing_ovs_use_veth():
+        """Return existing ovs_use_veth setting from dhcp_agent.ini.
+
+        :returns: Boolean value of existing ovs_use_veth setting or None
+        :rtype: Optional[Bool]
+        """
+        DHCP_AGENT_INI = "/etc/neutron/dhcp_agent.ini"
+        existing_ovs_use_veth = None
+        # If there is a dhcp_agent.ini file read the current setting
+        if os.path.isfile(DHCP_AGENT_INI):
+            # config_ini does the right thing and returns None if the setting is
+            # commented.
+            existing_ovs_use_veth = (
+                config_ini(DHCP_AGENT_INI)["DEFAULT"].get("ovs_use_veth"))
+        # Convert to Bool if necessary
+        if isinstance(existing_ovs_use_veth, six.string_types):
+            return bool_from_string(existing_ovs_use_veth)
+        return existing_ovs_use_veth
+
+    @staticmethod
+    def parse_ovs_use_veth():
+        """Parse the ovs-use-veth config setting.
+
+        Parse the string config setting for ovs-use-veth and return a boolean
+        or None.
+
+        bool_from_string will raise a ValueError if the string is not falsy or
+        truthy.
+
+        :raises: ValueError for invalid input
+        :returns: Boolean value of ovs-use-veth or None
+        :rtype: Optional[Bool]
+        """
+        _config = config("ovs-use-veth")
+        # An unset parameter returns None. Just in case we will also check for
+        # an empty string: "". Ironically, (the problem we are trying to avoid)
+        # "False" returns True and "" returns False.
+        if _config is None or not _config:
+            # Return None
+            return
+        # bool_from_string handles many variations of true and false strings
+        # as well as upper and lowercases including:
+        # ['y', 'yes', 'true', 't', 'on', 'n', 'no', 'false', 'f', 'off']
+        return bool_from_string(_config)
+
+    def get_ovs_use_veth(self):
+        """Return correct ovs_use_veth setting for use in dhcp_agent.ini.
+
+        Get the right value from config or existing dhcp_agent.ini file.
+        Existing has precedence. Attempt to default to "False" without
+        disrupting existing deployments. Handle existing deployments and
+        upgrades safely. See LP Bug#1831935
+
+        :returns: Value to use for ovs_use_veth setting
+        :rtype: Bool
+        """
+        _existing = self.get_existing_ovs_use_veth()
+        if _existing is not None:
+            return _existing
+
+        _config = self.parse_ovs_use_veth()
+        if _config is None:
+            # New better default
+            return False
+        else:
+            return _config
+
+
+EntityMac = collections.namedtuple('EntityMac', ['entity', 'mac'])
+
+
+def resolve_pci_from_mapping_config(config_key):
+    """Resolve local PCI devices from MAC addresses in mapping config.
+
+    Note that this function keeps record of mac->PCI address lookups
+    in the local unit db as the devices will disappaear from the system
+    once bound.
+
+    :param config_key: Configuration option key to parse data from
+    :type config_key: str
+    :returns: PCI device address to Tuple(entity, mac) map
+    :rtype: collections.OrderedDict[str,Tuple[str,str]]
+    """
+    devices = pci.PCINetDevices()
+    resolved_devices = collections.OrderedDict()
+    db = kv()
+    # Note that ``parse_data_port_mappings`` returns Dict regardless of input
+    for mac, entity in parse_data_port_mappings(config(config_key)).items():
+        pcidev = devices.get_device_from_mac(mac)
+        if pcidev:
+            # NOTE: store mac->pci allocation as post binding
+            #       it disappears from PCIDevices.
+            db.set(mac, pcidev.pci_address)
+            db.flush()
+
+        pci_address = db.get(mac)
+        if pci_address:
+            resolved_devices[pci_address] = EntityMac(entity, mac)
+
+    return resolved_devices
+
+
+class DPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, driver_key=None, bridges_key=None, bonds_key=None):
+        """Initialize DPDKDeviceContext.
+
+        :param driver_key: Key to use when retrieving driver config.
+        :type driver_key: str
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.driver_key = driver_key or 'dpdk-driver'
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[str,collections.OrderedDict[str,str]]]
+        """
+        driver = config(self.driver_key)
+        if driver is None:
+            return {}
+        # Resolve PCI devices for both directly used devices (_bridges)
+        # and devices for use in dpdk bonds (_bonds)
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return {'devices': pci_devices,
+                'driver': driver}
+
+
+class OVSDPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, bridges_key=None, bonds_key=None):
+        """Initialize OVSDPDKDeviceContext.
+
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    @staticmethod
+    def _parse_cpu_list(cpulist):
+        """Parses a linux cpulist for a numa node
+
+        :returns: list of cores
+        :rtype: List[int]
+        """
+        cores = []
+        ranges = cpulist.split(',')
+        for cpu_range in ranges:
+            if "-" in cpu_range:
+                cpu_min_max = cpu_range.split('-')
+                cores += range(int(cpu_min_max[0]),
+                               int(cpu_min_max[1]) + 1)
+            else:
+                cores.append(int(cpu_range))
+        return cores
+
+    def _numa_node_cores(self):
+        """Get map of numa node -> cpu core
+
+        :returns: map of numa node -> cpu core
+        :rtype: Dict[str,List[int]]
+        """
+        nodes = {}
+        node_regex = '/sys/devices/system/node/node*'
+        for node in glob.glob(node_regex):
+            index = node.lstrip('/sys/devices/system/node/node')
+            with open(os.path.join(node, 'cpulist')) as cpulist:
+                nodes[index] = self._parse_cpu_list(cpulist.read().strip())
+        return nodes
+
+    def cpu_mask(self):
+        """Get hex formatted CPU mask
+
+        The mask is based on using the first config:dpdk-socket-cores
+        cores of each NUMA node in the unit.
+        :returns: hex formatted CPU mask
+        :rtype: str
+        """
+        num_cores = config('dpdk-socket-cores')
+        mask = 0
+        for cores in self._numa_node_cores().values():
+            for core in cores[:num_cores]:
+                mask = mask | 1 << core
+        return format(mask, '#04x')
+
+    def socket_memory(self):
+        """Formatted list of socket memory configuration per NUMA node
+
+        :returns: socket memory configuration per NUMA node
+        :rtype: str
+        """
+        sm_size = config('dpdk-socket-memory')
+        node_regex = '/sys/devices/system/node/node*'
+        mem_list = [str(sm_size) for _ in glob.glob(node_regex)]
+        if mem_list:
+            return ','.join(mem_list)
+        else:
+            return str(sm_size)
+
+    def devices(self):
+        """List of PCI devices for use by DPDK
+
+        :returns: List of PCI devices for use by DPDK
+        :rtype: collections.OrderedDict[str,str]
+        """
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return pci_devices
+
+    def _formatted_whitelist(self, flag):
+        """Flag formatted list of devices to whitelist
+
+        :param flag: flag format to use
+        :type flag: str
+        :rtype: str
+        """
+        whitelist = []
+        for device in self.devices():
+            whitelist.append(flag.format(device=device))
+        return ' '.join(whitelist)
+
+    def device_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the old style '-w' flag
+
+        :returns: devices to whitelist prefixed by '-w '
+        :rtype: str
+        """
+        return self._formatted_whitelist('-w {device}')
+
+    def pci_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the new style '--pci-whitelist' flag
+
+        :returns: devices to whitelist prefixed by '--pci-whitelist '
+        :rtype: str
+        """
+        return self._formatted_whitelist('--pci-whitelist {device}')
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[bool,str]]
+        """
+        ctxt = {}
+        whitelist = self.device_whitelist()
+        if whitelist:
+            ctxt['dpdk_enabled'] = config('enable-dpdk')
+            ctxt['device_whitelist'] = self.device_whitelist()
+            ctxt['socket_memory'] = self.socket_memory()
+            ctxt['cpu_mask'] = self.cpu_mask()
+        return ctxt
+
+
+class BridgePortInterfaceMap(object):
+    """Build a map of bridge ports and interaces from charm configuration.
+
+    NOTE: the handling of this detail in the charm is pre-deprecated.
+
+    The long term goal is for network connectivity detail to be modelled in
+    the server provisioning layer (such as MAAS) which in turn will provide
+    a Netplan YAML description that will be used to drive Open vSwitch.
+
+    Until we get to that reality the charm will need to configure this
+    detail based on application level configuration options.
+
+    There is a established way of mapping interfaces to ports and bridges
+    in the ``neutron-openvswitch`` and ``neutron-gateway`` charms and we
+    will carry that forward.
+
+    The relationship between bridge, port and interface(s).
+             +--------+
+             | bridge |
+             +--------+
+                 |
+         +----------------+
+         | port aka. bond |
+         +----------------+
+               |   |
+              +-+ +-+
+              |i| |i|
+              |n| |n|
+              |t| |t|
+              |0| |N|
+              +-+ +-+
+    """
+    class interface_type(enum.Enum):
+        """Supported interface types.
+
+        Supported interface types can be found in the ``iface_types`` column
+        in the ``Open_vSwitch`` table on a running system.
+        """
+        dpdk = 'dpdk'
+        internal = 'internal'
+        system = 'system'
+
+        def __str__(self):
+            """Return string representation of value.
+
+            :returns: string representation of value.
+            :rtype: str
+            """
+            return self.value
+
+    def __init__(self, bridges_key=None, bonds_key=None, enable_dpdk_key=None,
+                 global_mtu=None):
+        """Initialize map.
+
+        :param bridges_key: Name of bridge:interface/port map config key
+                            (default: 'data-port')
+        :type bridges_key: Optional[str]
+        :param bonds_key: Name of port-name:interface map config key
+                          (default: 'dpdk-bond-mappings')
+        :type bonds_key: Optional[str]
+        :param enable_dpdk_key: Name of DPDK toggle config key
+                                (default: 'enable-dpdk')
+        :type enable_dpdk_key: Optional[str]
+        :param global_mtu: Set a MTU on all interfaces at map initialization.
+
+            The default is to have Open vSwitch get this from the underlying
+            interface as set up by bare metal provisioning.
+
+            Note that you can augment the MTU on an individual interface basis
+            like this:
+
+            ifdatamap = bpi.get_ifdatamap(bridge, port)
+            ifdatamap = {
+                port: {
+                    **ifdata,
+                    **{'mtu-request': my_individual_mtu_map[port]},
+                }
+                for port, ifdata in ifdatamap.items()
+            }
+        :type global_mtu: Optional[int]
+        """
+        bridges_key = bridges_key or 'data-port'
+        bonds_key = bonds_key or 'dpdk-bond-mappings'
+        enable_dpdk_key = enable_dpdk_key or 'enable-dpdk'
+        self._map = collections.defaultdict(
+            lambda: collections.defaultdict(dict))
+        self._ifname_mac_map = collections.defaultdict(list)
+        self._mac_ifname_map = {}
+        self._mac_pci_address_map = {}
+
+        # First we iterate over the list of physical interfaces visible to the
+        # system and update interface name to mac and mac to interface name map
+        for ifname in list_nics():
+            if not is_phy_iface(ifname):
+                continue
+            mac = get_nic_hwaddr(ifname)
+            self._ifname_mac_map[ifname] = [mac]
+            self._mac_ifname_map[mac] = ifname
+
+            # check if interface is part of a linux bond
+            _bond_name = get_bond_master(ifname)
+            if _bond_name and _bond_name != ifname:
+                log('Add linux bond "{}" to map for physical interface "{}" '
+                    'with mac "{}".'.format(_bond_name, ifname, mac),
+                    level=DEBUG)
+                # for bonds we want to be able to get a list of the mac
+                # addresses for the physical interfaces the bond is made up of.
+                if self._ifname_mac_map.get(_bond_name):
+                    self._ifname_mac_map[_bond_name].append(mac)
+                else:
+                    self._ifname_mac_map[_bond_name] = [mac]
+
+        # In light of the pre-deprecation notice in the docstring of this
+        # class we will expose the ability to configure OVS bonds as a
+        # DPDK-only feature, but generally use the data structures internally.
+        if config(enable_dpdk_key):
+            # resolve PCI address of interfaces listed in the bridges and bonds
+            # charm configuration options.  Note that for already bound
+            # interfaces the helper will retrieve MAC address from the unit
+            # KV store as the information is no longer available in sysfs.
+            _pci_bridge_mac = resolve_pci_from_mapping_config(
+                bridges_key)
+            _pci_bond_mac = resolve_pci_from_mapping_config(
+                bonds_key)
+
+            for pci_address, bridge_mac in _pci_bridge_mac.items():
+                if bridge_mac.mac in self._mac_ifname_map:
+                    # if we already have the interface name in our map it is
+                    # visible to the system and therefore not bound to DPDK
+                    continue
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[ifname] = [bridge_mac.mac]
+                self._mac_ifname_map[bridge_mac.mac] = ifname
+                self._mac_pci_address_map[bridge_mac.mac] = pci_address
+
+            for pci_address, bond_mac in _pci_bond_mac.items():
+                # for bonds we want to be able to get a list of macs from
+                # the bond name and also get at the interface name made up
+                # of the hash of the PCI address
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[bond_mac.entity].append(bond_mac.mac)
+                self._mac_ifname_map[bond_mac.mac] = ifname
+                self._mac_pci_address_map[bond_mac.mac] = pci_address
+
+        config_bridges = config(bridges_key) or ''
+        for bridge, ifname_or_mac in (
+                pair.split(':', 1)
+                for pair in config_bridges.split()):
+            if ':' in ifname_or_mac:
+                try:
+                    ifname = self.ifname_from_mac(ifname_or_mac)
+                except KeyError:
+                    # The interface is destined for a different unit in the
+                    # deployment.
+                    continue
+                macs = [ifname_or_mac]
+            else:
+                ifname = ifname_or_mac
+                macs = self.macs_from_ifname(ifname_or_mac)
+
+            portname = ifname
+            for mac in macs:
+                try:
+                    pci_address = self.pci_address_from_mac(mac)
+                    iftype = self.interface_type.dpdk
+                    ifname = self.ifname_from_mac(mac)
+                except KeyError:
+                    pci_address = None
+                    iftype = self.interface_type.system
+
+                self.add_interface(
+                    bridge, portname, ifname, iftype, pci_address, global_mtu)
+
+            if not macs:
+                # We have not mapped the interface and it is probably some sort
+                # of virtual interface. Our user have put it in the config with
+                # a purpose so let's carry out their wish. LP: #1884743
+                log('Add unmapped interface from config: name "{}" bridge "{}"'
+                    .format(ifname, bridge),
+                    level=DEBUG)
+                self.add_interface(
+                    bridge, ifname, ifname, self.interface_type.system, None,
+                    global_mtu)
+
+    def __getitem__(self, key):
+        """Provide a Dict-like interface, get value of item.
+
+        :param key: Key to look up value from.
+        :type key: any
+        :returns: Value
+        :rtype: any
+        """
+        return self._map.__getitem__(key)
+
+    def __iter__(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.__iter__()
+
+    def __len__(self):
+        """Provide a Dict-like interface, measure the length of internal map.
+
+        :returns: Length
+        :rtype: int
+        """
+        return len(self._map)
+
+    def items(self):
+        """Provide a Dict-like interface, iterate over items.
+
+        :returns: Key Value pairs
+        :rtype: Iterator[any, any]
+        """
+        return self._map.items()
+
+    def keys(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.keys()
+
+    def ifname_from_mac(self, mac):
+        """
+        :returns: Name of interface
+        :rtype: str
+        :raises: KeyError
+        """
+        return (get_bond_master(self._mac_ifname_map[mac]) or
+                self._mac_ifname_map[mac])
+
+    def macs_from_ifname(self, ifname):
+        """
+        :returns: List of hardware address (MAC) of interface
+        :rtype: List[str]
+        :raises: KeyError
+        """
+        return self._ifname_mac_map[ifname]
+
+    def pci_address_from_mac(self, mac):
+        """
+        :param mac: Hardware address (MAC) of interface
+        :type mac: str
+        :returns: PCI address of device associated with mac
+        :rtype: str
+        :raises: KeyError
+        """
+        return self._mac_pci_address_map[mac]
+
+    def add_interface(self, bridge, port, ifname, iftype,
+                      pci_address, mtu_request):
+        """Add an interface to the map.
+
+        :param bridge: Name of bridge on which the bond will be added
+        :type bridge: str
+        :param port: Name of port which will represent the bond on bridge
+        :type port: str
+        :param ifname: Name of interface that will make up the bonded port
+        :type ifname: str
+        :param iftype: Type of interface
+        :type iftype: BridgeBondMap.interface_type
+        :param pci_address: PCI address of interface
+        :type pci_address: Optional[str]
+        :param mtu_request: MTU to request for interface
+        :type mtu_request: Optional[int]
+        """
+        self._map[bridge][port][ifname] = {
+            'type': str(iftype),
+        }
+        if pci_address:
+            self._map[bridge][port][ifname].update({
+                'pci-address': pci_address,
+            })
+        if mtu_request is not None:
+            self._map[bridge][port][ifname].update({
+                'mtu-request': str(mtu_request)
+            })
+
+    def get_ifdatamap(self, bridge, port):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bridge: Name of bridge on which the port will be added
+        :type bridge: str
+        :param port: Name of port which will represent one or more interfaces
+        :type port: str
+        """
+        for _bridge, _ports in self.items():
+            for _port, _interfaces in _ports.items():
+                if _bridge == bridge and _port == port:
+                    ifdatamap = {}
+                    for name, data in _interfaces.items():
+                        ifdatamap.update({
+                            name: {
+                                'type': data['type'],
+                            },
+                        })
+                        if data.get('mtu-request') is not None:
+                            ifdatamap[name].update({
+                                'mtu_request': data['mtu-request'],
+                            })
+                        if data.get('pci-address'):
+                            ifdatamap[name].update({
+                                'options': {
+                                    'dpdk-devargs': data['pci-address'],
+                                },
+                            })
+                    return ifdatamap
+
+
+class BondConfig(object):
+    """Container and helpers for bond configuration options.
+
+    Data is put into a dictionary and a convenient config get interface is
+    provided.
+    """
+
+    DEFAULT_LACP_CONFIG = {
+        'mode': 'balance-tcp',
+        'lacp': 'active',
+        'lacp-time': 'fast'
+    }
+    ALL_BONDS = 'ALL_BONDS'
+
+    BOND_MODES = ['active-backup', 'balance-slb', 'balance-tcp']
+    BOND_LACP = ['active', 'passive', 'off']
+    BOND_LACP_TIME = ['fast', 'slow']
+
+    def __init__(self, config_key=None):
+        """Parse specified configuration option.
+
+        :param config_key: Configuration key to retrieve data from
+                           (default: ``dpdk-bond-config``)
+        :type config_key: Optional[str]
+        """
+        self.config_key = config_key or 'dpdk-bond-config'
+
+        self.lacp_config = {
+            self.ALL_BONDS: copy.deepcopy(self.DEFAULT_LACP_CONFIG)
+        }
+
+        lacp_config = config(self.config_key)
+        if lacp_config:
+            lacp_config_map = lacp_config.split()
+            for entry in lacp_config_map:
+                bond, entry = entry.partition(':')[0:3:2]
+                if not bond:
+                    bond = self.ALL_BONDS
+
+                mode, entry = entry.partition(':')[0:3:2]
+                if not mode:
+                    mode = self.DEFAULT_LACP_CONFIG['mode']
+                assert mode in self.BOND_MODES, \
+                    "Bond mode {} is invalid".format(mode)
+
+                lacp, entry = entry.partition(':')[0:3:2]
+                if not lacp:
+                    lacp = self.DEFAULT_LACP_CONFIG['lacp']
+                assert lacp in self.BOND_LACP, \
+                    "Bond lacp {} is invalid".format(lacp)
+
+                lacp_time, entry = entry.partition(':')[0:3:2]
+                if not lacp_time:
+                    lacp_time = self.DEFAULT_LACP_CONFIG['lacp-time']
+                assert lacp_time in self.BOND_LACP_TIME, \
+                    "Bond lacp-time {} is invalid".format(lacp_time)
+
+                self.lacp_config[bond] = {
+                    'mode': mode,
+                    'lacp': lacp,
+                    'lacp-time': lacp_time
+                }
+
+    def get_bond_config(self, bond):
+        """Get the LACP configuration for a bond
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Dict[str,str]]
+        """
+        return self.lacp_config.get(bond, self.lacp_config[self.ALL_BONDS])
+
+    def get_ovs_portdata(self, bond):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Union[str,Dict[str,str]]]
+        """
+        bond_config = self.get_bond_config(bond)
+        return {
+            'bond_mode': bond_config['mode'],
+            'lacp': bond_config['lacp'],
+            'other_config': {
+                'lacp-time': bond_config['lacp-time'],
+            },
+        }
+
+
+class SRIOVContext(OSContextGenerator):
+    """Provide context for configuring SR-IOV devices."""
+
+    class sriov_config_mode(enum.Enum):
+        """Mode in which SR-IOV is configured.
+
+        The configuration option identified by the ``numvfs_key`` parameter
+        is overloaded and defines in which mode the charm should interpret
+        the other SR-IOV-related configuration options.
+        """
+        auto = 'auto'
+        blanket = 'blanket'
+        explicit = 'explicit'
+
+    def _determine_numvfs(self, device, sriov_numvfs):
+        """Determine number of Virtual Functions (VFs) configured for device.
+
+        :param device: Object describing a PCI Network interface card (NIC)/
+        :type device: sriov_netplan_shim.pci.PCINetDevice
+        :param sriov_numvfs: Number of VFs requested for blanket configuration.
+        :type sriov_numvfs: int
+        :returns: Number of VFs to configure for device
+        :rtype: Optional[int]
+        """
+
+        def _get_capped_numvfs(requested):
+            """Get a number of VFs that does not exceed individual card limits.
+
+            Depending and make and model of NIC the number of VFs supported
+            vary.  Requesting more VFs than a card support would be a fatal
+            error, cap the requested number at the total number of VFs each
+            individual card supports.
+
+            :param requested: Number of VFs requested
+            :type requested: int
+            :returns: Number of VFs allowed
+            :rtype: int
+            """
+            actual = min(int(requested), int(device.sriov_totalvfs))
+            if actual < int(requested):
+                log('Requested VFs ({}) too high for device {}. Falling back '
+                    'to value supprted by device: {}'
+                    .format(requested, device.interface_name,
+                            device.sriov_totalvfs),
+                    level=WARNING)
+            return actual
+
+        if self._sriov_config_mode == self.sriov_config_mode.auto:
+            # auto-mode
+            #
+            # If device mapping configuration is present, return information
+            # on cards with mapping.
+            #
+            # If no device mapping configuration is present, return information
+            # for all cards.
+            #
+            # The maximum number of VFs supported by card will be used.
+            if (self._sriov_mapped_devices and
+                    device.interface_name not in self._sriov_mapped_devices):
+                log('SR-IOV configured in auto mode: No device mapping for {}'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(device.sriov_totalvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.blanket:
+            # blanket-mode
+            #
+            # User has specified a number of VFs that should apply to all
+            # cards with support for VFs.
+            return _get_capped_numvfs(sriov_numvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.explicit:
+            # explicit-mode
+            #
+            # User has given a list of interface names and associated number of
+            # VFs
+            if device.interface_name not in self._sriov_config_devices:
+                log('SR-IOV configured in explicit mode: No device:numvfs '
+                    'pair for device {}, skipping.'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(
+                self._sriov_config_devices[device.interface_name])
+        else:
+            raise RuntimeError('This should not be reached')
+
+    def __init__(self, numvfs_key=None, device_mappings_key=None):
+        """Initialize map from PCI devices and configuration options.
+
+        :param numvfs_key: Config key for numvfs (default: 'sriov-numvfs')
+        :type numvfs_key: Optional[str]
+        :param device_mappings_key: Config key for device mappings
+                                    (default: 'sriov-device-mappings')
+        :type device_mappings_key: Optional[str]
+        :raises: RuntimeError
+        """
+        numvfs_key = numvfs_key or 'sriov-numvfs'
+        device_mappings_key = device_mappings_key or 'sriov-device-mappings'
+
+        devices = pci.PCINetDevices()
+        charm_config = config()
+        sriov_numvfs = charm_config.get(numvfs_key) or ''
+        sriov_device_mappings = charm_config.get(device_mappings_key) or ''
+
+        # create list of devices from sriov_device_mappings config option
+        self._sriov_mapped_devices = [
+            pair.split(':', 1)[1]
+            for pair in sriov_device_mappings.split()
+        ]
+
+        # create map of device:numvfs from sriov_numvfs config option
+        self._sriov_config_devices = {
+            ifname: numvfs for ifname, numvfs in (
+                pair.split(':', 1) for pair in sriov_numvfs.split()
+                if ':' in sriov_numvfs)
+        }
+
+        # determine configuration mode from contents of sriov_numvfs
+        if sriov_numvfs == 'auto':
+            self._sriov_config_mode = self.sriov_config_mode.auto
+        elif sriov_numvfs.isdigit():
+            self._sriov_config_mode = self.sriov_config_mode.blanket
+        elif ':' in sriov_numvfs:
+            self._sriov_config_mode = self.sriov_config_mode.explicit
+        else:
+            raise RuntimeError('Unable to determine mode of SR-IOV '
+                               'configuration.')
+
+        self._map = {
+            device.interface_name: self._determine_numvfs(device, sriov_numvfs)
+            for device in devices.pci_devices
+            if device.sriov and
+            self._determine_numvfs(device, sriov_numvfs) is not None
+        }
+
+    def __call__(self):
+        """Provide SR-IOV context.
+
+        :returns: Map interface name: min(configured, max) virtual functions.
+        Example:
+           {
+               'eth0': 16,
+               'eth1': 32,
+               'eth2': 64,
+           }
+        :rtype: Dict[str,int]
+        """
+        return self._map
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..f85ae4f4cdbb6567cbdd896338bf88fbf3c9c0ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/exceptions.py
@@ -0,0 +1,21 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class OSContextError(Exception):
+    """Raised when an error occurs during context generation.
+
+    This exception is principally used in contrib.openstack.context
+    """
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh
new file mode 100755
index 0000000000000000000000000000000000000000..1df55db4816ec51d6732d68ea0a1e25e6f7b116e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh
@@ -0,0 +1,34 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+CRITICAL=0
+NOTACTIVE=''
+LOGFILE=/var/log/nagios/check_haproxy.log
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+typeset -i N_INSTANCES=0
+for appserver in $(awk '/^\s+server/{print $2}' /etc/haproxy/haproxy.cfg)
+do
+    N_INSTANCES=N_INSTANCES+1
+    output=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' --regex=",${appserver},.*,UP.*" -e ' 200 OK')
+    if [ $? != 0 ]; then
+        date >> $LOGFILE
+        echo $output >> $LOGFILE
+        /usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v | grep ",${appserver}," >> $LOGFILE 2>&1
+        CRITICAL=1
+        NOTACTIVE="${NOTACTIVE} $appserver"
+    fi
+done
+
+if [ $CRITICAL = 1 ]; then
+    echo "CRITICAL:${NOTACTIVE}"
+    exit 2
+fi
+
+echo "OK: All haproxy instances ($N_INSTANCES) looking good"
+exit 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
new file mode 100755
index 0000000000000000000000000000000000000000..91ce0246e66115994c3f518b36448f70100ecfc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
@@ -0,0 +1,30 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#                                       
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+# These should be config options at some stage
+CURRQthrsh=0
+MAXQthrsh=100
+
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+HAPROXYSTATS=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v)
+
+for BACKEND in $(echo $HAPROXYSTATS| xargs -n1 | grep BACKEND | awk -F , '{print $1}')
+do
+    CURRQ=$(echo "$HAPROXYSTATS" | grep $BACKEND | grep BACKEND | cut -d , -f 3)
+    MAXQ=$(echo "$HAPROXYSTATS"  | grep $BACKEND | grep BACKEND | cut -d , -f 4)
+
+    if [[ $CURRQ -gt $CURRQthrsh || $MAXQ -gt $MAXQthrsh ]] ; then
+        echo "CRITICAL: queue depth for $BACKEND - CURRENT:$CURRQ MAX:$MAXQ"
+        exit 2
+    fi
+done
+
+echo "OK: All haproxy queue depths looking good"
+exit 0
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5cbdf535d495a09a0b91f41fdda09862e34140d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ha/utils.py
@@ -0,0 +1,348 @@
+# Copyright 2014-2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2016 Canonical Ltd.
+#
+# Authors:
+#  Openstack Charmers <
+#
+
+"""
+Helpers for high availability.
+"""
+
+import hashlib
+import json
+
+import re
+
+from charmhelpers.core.hookenv import (
+    expected_related_units,
+    log,
+    relation_set,
+    charm_name,
+    config,
+    status_set,
+    DEBUG,
+)
+
+from charmhelpers.core.host import (
+    lsb_release
+)
+
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    is_ipv6,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_iface_for_address,
+    get_netmask_for_address,
+)
+
+from charmhelpers.contrib.hahelpers.cluster import (
+    get_hacluster_config
+)
+
+JSON_ENCODE_OPTIONS = dict(
+    sort_keys=True,
+    allow_nan=False,
+    indent=None,
+    separators=(',', ':'),
+)
+
+VIP_GROUP_NAME = 'grp_{service}_vips'
+DNSHA_GROUP_NAME = 'grp_{service}_hostnames'
+
+
+class DNSHAException(Exception):
+    """Raised when an error occurs setting up DNS HA
+    """
+
+    pass
+
+
+def update_dns_ha_resource_params(resources, resource_params,
+                                  relation_id=None,
+                                  crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration and
+    update resource dictionaries for the HA relation.
+
+    @param resources: Pointer to dictionary of resources.
+                      Usually instantiated in ha_joined().
+    @param resource_params: Pointer to dictionary of resource parameters.
+                            Usually instantiated in ha_joined()
+    @param relation_id: Relation ID of the ha relation
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+    update_hacluster_dns_ha(charm_name(),
+                            _relation_data,
+                            crm_ocf)
+    resources.update(_relation_data['resources'])
+    resource_params.update(_relation_data['resource_params'])
+    relation_set(relation_id=relation_id, groups=_relation_data['groups'])
+
+
+def assert_charm_supports_dns_ha():
+    """Validate prerequisites for DNS HA
+    The MAAS client is only available on Xenial or greater
+
+    :raises DNSHAException: if release is < 16.04
+    """
+    if lsb_release().get('DISTRIB_RELEASE') < '16.04':
+        msg = ('DNS HA is only supported on 16.04 and greater '
+               'versions of Ubuntu.')
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+    return True
+
+
+def expect_ha():
+    """ Determine if the unit expects to be in HA
+
+    Check juju goal-state if ha relation is expected, check for VIP or dns-ha
+    settings which indicate the unit should expect to be related to hacluster.
+
+    @returns boolean
+    """
+    ha_related_units = []
+    try:
+        ha_related_units = list(expected_related_units(reltype='ha'))
+    except (NotImplementedError, KeyError):
+        pass
+    return len(ha_related_units) > 0 or config('vip') or config('dns-ha')
+
+
+def generate_ha_relation_data(service,
+                              extra_settings=None,
+                              haproxy_enabled=True):
+    """ Generate relation data for ha relation
+
+    Based on configuration options and unit interfaces, generate a json
+    encoded dict of relation data items for the hacluster relation,
+    providing configuration for DNS HA or VIP's + haproxy clone sets.
+
+    Example of supplying additional settings::
+
+        COLO_CONSOLEAUTH = 'inf: res_nova_consoleauth grp_nova_vips'
+        AGENT_CONSOLEAUTH = 'ocf:openstack:nova-consoleauth'
+        AGENT_CA_PARAMS = 'op monitor interval="5s"'
+
+        ha_console_settings = {
+            'colocations': {'vip_consoleauth': COLO_CONSOLEAUTH},
+            'init_services': {'res_nova_consoleauth': 'nova-consoleauth'},
+            'resources': {'res_nova_consoleauth': AGENT_CONSOLEAUTH},
+            'resource_params': {'res_nova_consoleauth': AGENT_CA_PARAMS})
+        generate_ha_relation_data('nova', extra_settings=ha_console_settings)
+
+
+    @param service: Name of the service being configured
+    @param extra_settings: Dict of additional resource data
+    @returns dict: json encoded data for use with relation_set
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+
+    if haproxy_enabled:
+        _meta = 'meta migration-threshold="INFINITY" failure-timeout="5s"'
+        _haproxy_res = 'res_{}_haproxy'.format(service)
+        _relation_data['resources'] = {_haproxy_res: 'lsb:haproxy'}
+        _relation_data['resource_params'] = {
+            _haproxy_res: '{} op monitor interval="5s"'.format(_meta)
+        }
+        _relation_data['init_services'] = {_haproxy_res: 'haproxy'}
+        _relation_data['clones'] = {
+            'cl_{}_haproxy'.format(service): _haproxy_res
+        }
+
+    if extra_settings:
+        for k, v in extra_settings.items():
+            if _relation_data.get(k):
+                _relation_data[k].update(v)
+            else:
+                _relation_data[k] = v
+
+    if config('dns-ha'):
+        update_hacluster_dns_ha(service, _relation_data)
+    else:
+        update_hacluster_vip(service, _relation_data)
+
+    return {
+        'json_{}'.format(k): json.dumps(v, **JSON_ENCODE_OPTIONS)
+        for k, v in _relation_data.items() if v
+    }
+
+
+def update_hacluster_dns_ha(service, relation_data,
+                            crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    # Validate the charm environment for DNS HA
+    assert_charm_supports_dns_ha()
+
+    settings = ['os-admin-hostname', 'os-internal-hostname',
+                'os-public-hostname', 'os-access-hostname']
+
+    # Check which DNS settings are set and update dictionaries
+    hostname_group = []
+    for setting in settings:
+        hostname = config(setting)
+        if hostname is None:
+            log('DNS HA: Hostname setting {} is None. Ignoring.'
+                ''.format(setting),
+                DEBUG)
+            continue
+        m = re.search('os-(.+?)-hostname', setting)
+        if m:
+            endpoint_type = m.group(1)
+            # resolve_address's ADDRESS_MAP uses 'int' not 'internal'
+            if endpoint_type == 'internal':
+                endpoint_type = 'int'
+        else:
+            msg = ('Unexpected DNS hostname setting: {}. '
+                   'Cannot determine endpoint_type name'
+                   ''.format(setting))
+            status_set('blocked', msg)
+            raise DNSHAException(msg)
+
+        hostname_key = 'res_{}_{}_hostname'.format(service, endpoint_type)
+        if hostname_key in hostname_group:
+            log('DNS HA: Resource {}: {} already exists in '
+                'hostname group - skipping'.format(hostname_key, hostname),
+                DEBUG)
+            continue
+
+        hostname_group.append(hostname_key)
+        relation_data['resources'][hostname_key] = crm_ocf
+        relation_data['resource_params'][hostname_key] = (
+            'params fqdn="{}" ip_address="{}"'
+            .format(hostname, resolve_address(endpoint_type=endpoint_type,
+                                              override=False)))
+
+    if len(hostname_group) >= 1:
+        log('DNS HA: Hostname group is set with {} as members. '
+            'Informing the ha relation'.format(' '.join(hostname_group)),
+            DEBUG)
+        relation_data['groups'] = {
+            DNSHA_GROUP_NAME.format(service=service): ' '.join(hostname_group)
+        }
+    else:
+        msg = 'DNS HA: Hostname group has no members.'
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+
+
+def get_vip_settings(vip):
+    """Calculate which nic is on the correct network for the given vip.
+
+    If nic or netmask discovery fail then fallback to using charm supplied
+    config. If fallback is used this is indicated via the fallback variable.
+
+    @param vip: VIP to lookup nic and cidr for.
+    @returns (str, str, bool): eg (iface, netmask, fallback)
+    """
+    iface = get_iface_for_address(vip)
+    netmask = get_netmask_for_address(vip)
+    fallback = False
+    if iface is None:
+        iface = config('vip_iface')
+        fallback = True
+    if netmask is None:
+        netmask = config('vip_cidr')
+        fallback = True
+    return iface, netmask, fallback
+
+
+def update_hacluster_vip(service, relation_data):
+    """ Configure VIP resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    """
+    cluster_config = get_hacluster_config()
+    vip_group = []
+    vips_to_delete = []
+    for vip in cluster_config['vip'].split():
+        if is_ipv6(vip):
+            res_vip = 'ocf:heartbeat:IPv6addr'
+            vip_params = 'ipv6addr'
+        else:
+            res_vip = 'ocf:heartbeat:IPaddr2'
+            vip_params = 'ip'
+
+        iface, netmask, fallback = get_vip_settings(vip)
+
+        vip_monitoring = 'op monitor timeout="20s" interval="10s" depth="0"'
+        if iface is not None:
+            # NOTE(jamespage): Delete old VIP resources
+            # Old style naming encoding iface in name
+            # does not work well in environments where
+            # interface/subnet wiring is not consistent
+            vip_key = 'res_{}_{}_vip'.format(service, iface)
+            if vip_key in vips_to_delete:
+                vip_key = '{}_{}'.format(vip_key, vip_params)
+            vips_to_delete.append(vip_key)
+
+            vip_key = 'res_{}_{}_vip'.format(
+                service,
+                hashlib.sha1(vip.encode('UTF-8')).hexdigest()[:7])
+
+            relation_data['resources'][vip_key] = res_vip
+            # NOTE(jamespage):
+            # Use option provided vip params if these where used
+            # instead of auto-detected values
+            if fallback:
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" cidr_netmask="{netmask}" '
+                    'nic="{iface}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        iface=iface,
+                        netmask=netmask,
+                        vip_monitoring=vip_monitoring))
+            else:
+                # NOTE(jamespage):
+                # let heartbeat figure out which interface and
+                # netmask to configure, which works nicely
+                # when network interface naming is not
+                # consistent across units.
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        vip_monitoring=vip_monitoring))
+
+            vip_group.append(vip_key)
+
+    if vips_to_delete:
+        try:
+            relation_data['delete_resources'].extend(vips_to_delete)
+        except KeyError:
+            relation_data['delete_resources'] = vips_to_delete
+
+    if len(vip_group) >= 1:
+        key = VIP_GROUP_NAME.format(service=service)
+        try:
+            relation_data['groups'][key] = ' '.join(vip_group)
+        except KeyError:
+            relation_data['groups'] = {
+                key: ' '.join(vip_group)
+            }
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..723aebc172e94a5b00c385d9861dd4d45c1bc753
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ip.py
@@ -0,0 +1,197 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    unit_get,
+    service_name,
+    network_get_primary_address,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    is_address_in_network,
+    is_ipv6,
+    get_ipv6_addr,
+    resolve_network_cidr,
+)
+from charmhelpers.contrib.hahelpers.cluster import is_clustered
+
+PUBLIC = 'public'
+INTERNAL = 'int'
+ADMIN = 'admin'
+ACCESS = 'access'
+
+ADDRESS_MAP = {
+    PUBLIC: {
+        'binding': 'public',
+        'config': 'os-public-network',
+        'fallback': 'public-address',
+        'override': 'os-public-hostname',
+    },
+    INTERNAL: {
+        'binding': 'internal',
+        'config': 'os-internal-network',
+        'fallback': 'private-address',
+        'override': 'os-internal-hostname',
+    },
+    ADMIN: {
+        'binding': 'admin',
+        'config': 'os-admin-network',
+        'fallback': 'private-address',
+        'override': 'os-admin-hostname',
+    },
+    ACCESS: {
+        'binding': 'access',
+        'config': 'access-network',
+        'fallback': 'private-address',
+        'override': 'os-access-hostname',
+    },
+}
+
+
+def canonical_url(configs, endpoint_type=PUBLIC):
+    """Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration, hacluster and charm configuration.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :param endpoint_type: str endpoint type to resolve.
+    :param returns: str base URL for services on the current service unit.
+    """
+    scheme = _get_scheme(configs)
+
+    address = resolve_address(endpoint_type)
+    if is_ipv6(address):
+        address = "[{}]".format(address)
+
+    return '%s://%s' % (scheme, address)
+
+
+def _get_scheme(configs):
+    """Returns the scheme to use for the url (either http or https)
+    depending upon whether https is in the configs value.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :returns: either 'http' or 'https' depending on whether https is
+              configured within the configs context.
+    """
+    scheme = 'http'
+    if configs and 'https' in configs.complete_contexts():
+        scheme = 'https'
+    return scheme
+
+
+def _get_address_override(endpoint_type=PUBLIC):
+    """Returns any address overrides that the user has defined based on the
+    endpoint type.
+
+    Note: this function allows for the service name to be inserted into the
+    address if the user specifies {service_name}.somehost.org.
+
+    :param endpoint_type: the type of endpoint to retrieve the override
+                          value for.
+    :returns: any endpoint address or hostname that the user has overridden
+              or None if an override is not present.
+    """
+    override_key = ADDRESS_MAP[endpoint_type]['override']
+    addr_override = config(override_key)
+    if not addr_override:
+        return None
+    else:
+        return addr_override.format(service_name=service_name())
+
+
+def resolve_address(endpoint_type=PUBLIC, override=True):
+    """Return unit address depending on net config.
+
+    If unit is clustered with vip(s) and has net splits defined, return vip on
+    correct network. If clustered with no nets defined, return primary vip.
+
+    If not clustered, return unit address ensuring address is on configured net
+    split if one is configured, or a Juju 2.0 extra-binding has been used.
+
+    :param endpoint_type: Network endpoing type
+    :param override: Accept hostname overrides or not
+    """
+    resolved_address = None
+    if override:
+        resolved_address = _get_address_override(endpoint_type)
+        if resolved_address:
+            return resolved_address
+
+    vips = config('vip')
+    if vips:
+        vips = vips.split()
+
+    net_type = ADDRESS_MAP[endpoint_type]['config']
+    net_addr = config(net_type)
+    net_fallback = ADDRESS_MAP[endpoint_type]['fallback']
+    binding = ADDRESS_MAP[endpoint_type]['binding']
+    clustered = is_clustered()
+
+    if clustered and vips:
+        if net_addr:
+            for vip in vips:
+                if is_address_in_network(net_addr, vip):
+                    resolved_address = vip
+                    break
+        else:
+            # NOTE: endeavour to check vips against network space
+            #       bindings
+            try:
+                bound_cidr = resolve_network_cidr(
+                    network_get_primary_address(binding)
+                )
+                for vip in vips:
+                    if is_address_in_network(bound_cidr, vip):
+                        resolved_address = vip
+                        break
+            except (NotImplementedError, NoNetworkBinding):
+                # If no net-splits configured and no support for extra
+                # bindings/network spaces so we expect a single vip
+                resolved_address = vips[0]
+    else:
+        if config('prefer-ipv6'):
+            fallback_addr = get_ipv6_addr(exc_list=vips)[0]
+        else:
+            fallback_addr = unit_get(net_fallback)
+
+        if net_addr:
+            resolved_address = get_address_in_network(net_addr, fallback_addr)
+        else:
+            # NOTE: only try to use extra bindings if legacy network
+            #       configuration is not in use
+            try:
+                resolved_address = network_get_primary_address(binding)
+            except (NotImplementedError, NoNetworkBinding):
+                resolved_address = fallback_addr
+
+    if resolved_address is None:
+        raise ValueError("Unable to resolve a suitable IP address based on "
+                         "charm state and configuration. (net_type=%s, "
+                         "clustered=%s)" % (net_type, clustered))
+
+    return resolved_address
+
+
+def get_vip_in_network(network):
+    matching_vip = None
+    vips = config('vip')
+    if vips:
+        for vip in vips.split():
+            if is_address_in_network(network, vip):
+                matching_vip = vip
+    return matching_vip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/keystone.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/keystone.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7e02ccd90155710901e444482b589aa264158e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/keystone.py
@@ -0,0 +1,178 @@
+#!/usr/bin/python
+#
+# Copyright 2017 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+from charmhelpers.fetch import apt_install
+from charmhelpers.contrib.openstack.context import IdentityServiceContext
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+)
+
+
+def get_api_suffix(api_version):
+    """Return the formatted api suffix for the given version
+    @param api_version: version of the keystone endpoint
+    @returns the api suffix formatted according to the given api
+    version
+    """
+    return 'v2.0' if api_version in (2, "2", "2.0") else 'v3'
+
+
+def format_endpoint(schema, addr, port, api_version):
+    """Return a formatted keystone endpoint
+    @param schema: http or https
+    @param addr: ipv4/ipv6 host of the keystone service
+    @param port: port of the keystone service
+    @param api_version: 2 or 3
+    @returns a fully formatted keystone endpoint
+    """
+    return '{}://{}:{}/{}/'.format(schema, addr, port,
+                                   get_api_suffix(api_version))
+
+
+def get_keystone_manager(endpoint, api_version, **kwargs):
+    """Return a keystonemanager for the correct API version
+
+    @param endpoint: the keystone endpoint to point client at
+    @param api_version: version of the keystone api the client should use
+    @param kwargs: token or username/tenant/password information
+    @returns keystonemanager class used for interrogating keystone
+    """
+    if api_version == 2:
+        return KeystoneManager2(endpoint, **kwargs)
+    if api_version == 3:
+        return KeystoneManager3(endpoint, **kwargs)
+    raise ValueError('No manager found for api version {}'.format(api_version))
+
+
+def get_keystone_manager_from_identity_service_context():
+    """Return a keystonmanager generated from a
+    instance of charmhelpers.contrib.openstack.context.IdentityServiceContext
+    @returns keystonamenager instance
+   """
+    context = IdentityServiceContext()()
+    if not context:
+        msg = "Identity service context cannot be generated"
+        log(msg, level=ERROR)
+        raise ValueError(msg)
+
+    endpoint = format_endpoint(context['service_protocol'],
+                               context['service_host'],
+                               context['service_port'],
+                               context['api_version'])
+
+    if context['api_version'] in (2, "2.0"):
+        api_version = 2
+    else:
+        api_version = 3
+
+    return get_keystone_manager(endpoint, api_version,
+                                username=context['admin_user'],
+                                password=context['admin_password'],
+                                tenant_name=context['admin_tenant_name'])
+
+
+class KeystoneManager(object):
+
+    def resolve_service_id(self, service_name=None, service_type=None):
+        """Find the service_id of a given service"""
+        services = [s._info for s in self.api.services.list()]
+
+        service_name = service_name.lower()
+        for s in services:
+            name = s['name'].lower()
+            if service_type and service_name:
+                if (service_name == name and service_type == s['type']):
+                    return s['id']
+            elif service_name and service_name == name:
+                return s['id']
+            elif service_type and service_type == s['type']:
+                return s['id']
+        return None
+
+    def service_exists(self, service_name=None, service_type=None):
+        """Determine if the given service exists on the service list"""
+        return self.resolve_service_id(service_name, service_type) is not None
+
+
+class KeystoneManager2(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+
+        self.api_version = 2
+
+        token = kwargs.get("token", None)
+        if token:
+            api = client.Client(endpoint=endpoint, token=token)
+        else:
+            auth = v2.Password(username=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               tenant_name=kwargs.get("tenant_name"),
+                               auth_url=endpoint)
+            sess = session.Session(auth=auth)
+            api = client.Client(session=sess)
+
+        self.api = api
+
+
+class KeystoneManager3(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+
+        self.api_version = 3
+
+        token = kwargs.get("token", None)
+        if token:
+            auth = token_endpoint.Token(endpoint=endpoint,
+                                        token=token)
+            sess = session.Session(auth=auth)
+        else:
+            auth = v3.Password(auth_url=endpoint,
+                               user_id=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               project_id=kwargs.get("tenant_name"))
+            sess = session.Session(auth=auth)
+
+        self.api = client.Client(session=sess)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/neutron.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/neutron.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb5607f3e73159d90236b2d7a4051aa82119e889
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/neutron.py
@@ -0,0 +1,359 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Various utilies for dealing with Neutron and the renaming from Quantum.
+
+import six
+from subprocess import check_output
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    ERROR,
+)
+
+from charmhelpers.contrib.openstack.utils import (
+    os_release,
+    CompareOpenStackReleases,
+)
+
+
+def headers_package():
+    """Ensures correct linux-headers for running kernel are installed,
+    for building DKMS package"""
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    return 'linux-headers-%s' % kver
+
+
+QUANTUM_CONF_DIR = '/etc/quantum'
+
+
+def kernel_version():
+    """ Retrieve the current major kernel version as a tuple e.g. (3, 13) """
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    kver = kver.split('.')
+    return (int(kver[0]), int(kver[1]))
+
+
+def determine_dkms_package():
+    """ Determine which DKMS package should be used based on kernel version """
+    # NOTE: 3.13 kernels have support for GRE and VXLAN native
+    if kernel_version() >= (3, 13):
+        return []
+    else:
+        return [headers_package(), 'openvswitch-datapath-dkms']
+
+
+# legacy
+
+
+def quantum_plugins():
+    return {
+        'ovs': {
+            'config': '/etc/quantum/plugins/openvswitch/'
+                      'ovs_quantum_plugin.ini',
+            'driver': 'quantum.plugins.openvswitch.ovs_quantum_plugin.'
+                      'OVSQuantumPluginV2',
+            'contexts': [],
+            'services': ['quantum-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['quantum-plugin-openvswitch-agent']],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-openvswitch'],
+            'server_services': ['quantum-server']
+        },
+        'nvp': {
+            'config': '/etc/quantum/plugins/nicira/nvp.ini',
+            'driver': 'quantum.plugins.nicira.nicira_nvp_plugin.'
+                      'QuantumPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-nicira'],
+            'server_services': ['quantum-server']
+        }
+    }
+
+
+NEUTRON_CONF_DIR = '/etc/neutron'
+
+
+def neutron_plugins():
+    release = os_release('nova-common')
+    plugins = {
+        'ovs': {
+            'config': '/etc/neutron/plugins/openvswitch/'
+                      'ovs_neutron_plugin.ini',
+            'driver': 'neutron.plugins.openvswitch.ovs_neutron_plugin.'
+                      'OVSNeutronPluginV2',
+            'contexts': [],
+            'services': ['neutron-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-openvswitch-agent']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-openvswitch'],
+            'server_services': ['neutron-server']
+        },
+        'nvp': {
+            'config': '/etc/neutron/plugins/nicira/nvp.ini',
+            'driver': 'neutron.plugins.nicira.nicira_nvp_plugin.'
+                      'NeutronPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-nicira'],
+            'server_services': ['neutron-server']
+        },
+        'nsx': {
+            'config': '/etc/neutron/plugins/vmware/nsx.ini',
+            'driver': 'vmware',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-vmware'],
+            'server_services': ['neutron-server']
+        },
+        'n1kv': {
+            'config': '/etc/neutron/plugins/cisco/cisco_plugins.ini',
+            'driver': 'neutron.plugins.cisco.network_plugin.PluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-cisco']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-cisco'],
+            'server_services': ['neutron-server']
+        },
+        'Calico': {
+            'config': '/etc/neutron/plugins/ml2/ml2_conf.ini',
+            'driver': 'neutron.plugins.ml2.plugin.Ml2Plugin',
+            'contexts': [],
+            'services': ['calico-felix',
+                         'bird',
+                         'neutron-dhcp-agent',
+                         'nova-api-metadata',
+                         'etcd'],
+            'packages': [determine_dkms_package(),
+                         ['calico-compute',
+                          'bird',
+                          'neutron-dhcp-agent',
+                          'nova-api-metadata',
+                          'etcd']],
+            'server_packages': ['neutron-server', 'calico-control', 'etcd'],
+            'server_services': ['neutron-server', 'etcd']
+        },
+        'vsp': {
+            'config': '/etc/neutron/plugins/nuage/nuage_plugin.ini',
+            'driver': 'neutron.plugins.nuage.plugin.NuagePlugin',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server', 'neutron-plugin-nuage'],
+            'server_services': ['neutron-server']
+        },
+        'plumgrid': {
+            'config': '/etc/neutron/plugins/plumgrid/plumgrid.ini',
+            'driver': ('neutron.plugins.plumgrid.plumgrid_plugin'
+                       '.plumgrid_plugin.NeutronPluginPLUMgridV2'),
+            'contexts': [],
+            'services': [],
+            'packages': ['plumgrid-lxc',
+                         'iovisor-dkms'],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-plumgrid'],
+            'server_services': ['neutron-server']
+        },
+        'midonet': {
+            'config': '/etc/neutron/plugins/midonet/midonet.ini',
+            'driver': 'midonet.neutron.plugin.MidonetPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package()],
+            'server_packages': ['neutron-server',
+                                'python-neutron-plugin-midonet'],
+            'server_services': ['neutron-server']
+        }
+    }
+    if CompareOpenStackReleases(release) >= 'icehouse':
+        # NOTE: patch in ml2 plugin for icehouse onwards
+        plugins['ovs']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['ovs']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['ovs']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+        # NOTE: patch in vmware renames nvp->nsx for icehouse onwards
+        plugins['nvp'] = plugins['nsx']
+    if CompareOpenStackReleases(release) >= 'kilo':
+        plugins['midonet']['driver'] = (
+            'neutron.plugins.midonet.plugin.MidonetPluginV2')
+    if CompareOpenStackReleases(release) >= 'liberty':
+        plugins['midonet']['driver'] = (
+            'midonet.neutron.plugin_v1.MidonetPluginV2')
+        plugins['midonet']['server_packages'].remove(
+            'python-neutron-plugin-midonet')
+        plugins['midonet']['server_packages'].append(
+            'python-networking-midonet')
+        plugins['plumgrid']['driver'] = (
+            'networking_plumgrid.neutron.plugins'
+            '.plugin.NeutronPluginPLUMgridV2')
+        plugins['plumgrid']['server_packages'].remove(
+            'neutron-plugin-plumgrid')
+    if CompareOpenStackReleases(release) >= 'mitaka':
+        plugins['nsx']['server_packages'].remove('neutron-plugin-vmware')
+        plugins['nsx']['server_packages'].append('python-vmware-nsx')
+        plugins['nsx']['config'] = '/etc/neutron/nsx.ini'
+        plugins['vsp']['driver'] = (
+            'nuage_neutron.plugins.nuage.plugin.NuagePlugin')
+    if CompareOpenStackReleases(release) >= 'newton':
+        plugins['vsp']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['vsp']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['vsp']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+    return plugins
+
+
+def neutron_plugin_attribute(plugin, attr, net_manager=None):
+    manager = net_manager or network_manager()
+    if manager == 'quantum':
+        plugins = quantum_plugins()
+    elif manager == 'neutron':
+        plugins = neutron_plugins()
+    else:
+        log("Network manager '%s' does not support plugins." % (manager),
+            level=ERROR)
+        raise Exception
+
+    try:
+        _plugin = plugins[plugin]
+    except KeyError:
+        log('Unrecognised plugin for %s: %s' % (manager, plugin), level=ERROR)
+        raise Exception
+
+    try:
+        return _plugin[attr]
+    except KeyError:
+        return None
+
+
+def network_manager():
+    '''
+    Deals with the renaming of Quantum to Neutron in H and any situations
+    that require compatability (eg, deploying H with network-manager=quantum,
+    upgrading from G).
+    '''
+    release = os_release('nova-common')
+    manager = config('network-manager').lower()
+
+    if manager not in ['quantum', 'neutron']:
+        return manager
+
+    if release in ['essex']:
+        # E does not support neutron
+        log('Neutron networking not supported in Essex.', level=ERROR)
+        raise Exception
+    elif release in ['folsom', 'grizzly']:
+        # neutron is named quantum in F and G
+        return 'quantum'
+    else:
+        # ensure accurate naming for all releases post-H
+        return 'neutron'
+
+
+def parse_mappings(mappings, key_rvalue=False):
+    """By default mappings are lvalue keyed.
+
+    If key_rvalue is True, the mapping will be reversed to allow multiple
+    configs for the same lvalue.
+    """
+    parsed = {}
+    if mappings:
+        mappings = mappings.split()
+        for m in mappings:
+            p = m.partition(':')
+
+            if key_rvalue:
+                key_index = 2
+                val_index = 0
+                # if there is no rvalue skip to next
+                if not p[1]:
+                    continue
+            else:
+                key_index = 0
+                val_index = 2
+
+            key = p[key_index].strip()
+            parsed[key] = p[val_index].strip()
+
+    return parsed
+
+
+def parse_bridge_mappings(mappings):
+    """Parse bridge mappings.
+
+    Mappings must be a space-delimited list of provider:bridge mappings.
+
+    Returns dict of the form {provider:bridge}.
+    """
+    return parse_mappings(mappings)
+
+
+def parse_data_port_mappings(mappings, default_bridge='br-data'):
+    """Parse data port mappings.
+
+    Mappings must be a space-delimited list of bridge:port.
+
+    Returns dict of the form {port:bridge} where ports may be mac addresses or
+    interface names.
+    """
+
+    # NOTE(dosaboy): we use rvalue for key to allow multiple values to be
+    # proposed for <port> since it may be a mac address which will differ
+    # across units this allowing first-known-good to be chosen.
+    _mappings = parse_mappings(mappings, key_rvalue=True)
+    if not _mappings or list(_mappings.values()) == ['']:
+        if not mappings:
+            return {}
+
+        # For backwards-compatibility we need to support port-only provided in
+        # config.
+        _mappings = {mappings.split()[0]: default_bridge}
+
+    ports = _mappings.keys()
+    if len(set(ports)) != len(ports):
+        raise Exception("It is not allowed to have the same port configured "
+                        "on more than one bridge")
+
+    return _mappings
+
+
+def parse_vlan_range_mappings(mappings):
+    """Parse vlan range mappings.
+
+    Mappings must be a space-delimited list of provider:start:end mappings.
+
+    The start:end range is optional and may be omitted.
+
+    Returns dict of the form {provider: (start, end)}.
+    """
+    _mappings = parse_mappings(mappings)
+    if not _mappings:
+        return {}
+
+    mappings = {}
+    for p, r in six.iteritems(_mappings):
+        mappings[p] = tuple(r.split(':'))
+
+    return mappings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/policyd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/policyd.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2bb21e9db926bd2c4de8ab3e8d10d0837af563a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/policyd.py
@@ -0,0 +1,801 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import contextlib
+import os
+import six
+import shutil
+import yaml
+import zipfile
+
+import charmhelpers
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as ch_host
+
+# Features provided by this module:
+
+"""
+Policy.d helper functions
+=========================
+
+The functions in this module are designed, as a set, to provide an easy-to-use
+set of hooks for classic charms to add in /etc/<service-name>/policy.d/
+directory override YAML files.
+
+(For charms.openstack charms, a mixin class is provided for this
+functionality).
+
+In order to "hook" this functionality into a (classic) charm, two functions are
+provided:
+
+    maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=none,
+                               blacklist_keys=none,
+                               template_function=none,
+                               restart_handler=none)
+
+    maybe_do_policyd_overrides_on_config_changed(openstack_release,
+                                                 service,
+                                                 blacklist_paths=None,
+                                                 blacklist_keys=None,
+                                                 template_function=None,
+                                                 restart_handler=None
+
+(See the docstrings for details on the parameters)
+
+The functions should be called from the install and upgrade hooks in the charm.
+The `maybe_do_policyd_overrides_on_config_changed` function is designed to be
+called on the config-changed hook, in that it does an additional check to
+ensure that an already overriden policy.d in an upgrade or install hooks isn't
+repeated.
+
+In order the *enable* this functionality, the charm's install, config_changed,
+and upgrade_charm hooks need to be modified, and a new config option (see
+below) needs to be added.  The README for the charm should also be updated.
+
+Examples from the keystone charm are:
+
+@hooks.hook('install.real')
+@harden()
+def install():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+
+@hooks.hook('config-changed')
+@restart_on_change(restart_map(), restart_functions=restart_function_map())
+@harden()
+def config_changed():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides_on_config_changed(os_release('keystone'),
+                                                 'keystone')
+
+@hooks.hook('upgrade-charm')
+@restart_on_change(restart_map(), stopstart=True)
+@harden()
+def upgrade_charm():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+Status Line
+===========
+
+The workload status code in charm-helpers has been modified to detect if
+policy.d override code has been incorporated into the charm by checking for the
+new config variable (in the config.yaml).  If it has been, then the workload
+status line will automatically show "PO:" at the beginning of the workload
+status for that unit/service if the config option is set.  If the policy
+override is broken, the "PO (broken):" will be shown.  No changes to the charm
+(apart from those already mentioned) are needed to enable this functionality.
+(charms.openstack charms also get this functionality, but please see that
+library for further details).
+"""
+
+# The config.yaml for the charm should contain the following for the config
+# option:
+
+"""
+  use-policyd-override:
+    type: boolean
+    default: False
+    description: |
+      If True then use the resource file named 'policyd-override' to install
+      override YAML files in the service's policy.d directory.  The resource
+      file should be a ZIP file containing at least one yaml file with a .yaml
+      or .yml extension.  If False then remove the overrides.
+"""
+
+# The metadata.yaml for the charm should contain the following:
+"""
+resources:
+  policyd-override:
+    type: file
+    filename: policyd-override.zip
+    description: The policy.d overrides file
+"""
+
+# The README for the charm should contain the following:
+"""
+Policy Overrides
+----------------
+
+This feature allows for policy overrides using the `policy.d` directory.  This
+is an **advanced** feature and the policies that the OpenStack service supports
+should be clearly and unambiguously understood before trying to override, or
+add to, the default policies that the service uses.  The charm also has some
+policy defaults.  They should also be understood before being overridden.
+
+> **Caution**: It is possible to break the system (for tenants and other
+  services) if policies are incorrectly applied to the service.
+
+Policy overrides are YAML files that contain rules that will add to, or
+override, existing policy rules in the service.  The `policy.d` directory is
+a place to put the YAML override files.  This charm owns the
+`/etc/keystone/policy.d` directory, and as such, any manual changes to it will
+be overwritten on charm upgrades.
+
+Overrides are provided to the charm using a Juju resource called
+`policyd-override`.  The resource is a ZIP file.  This file, say
+`overrides.zip`, is attached to the charm by:
+
+
+    juju attach-resource <charm-name> policyd-override=overrides.zip
+
+The policy override is enabled in the charm using:
+
+    juju config <charm-name> use-policyd-override=true
+
+When `use-policyd-override` is `True` the status line of the charm will be
+prefixed with `PO:` indicating that policies have been overridden.  If the
+installation of the policy override YAML files failed for any reason then the
+status line will be prefixed with `PO (broken):`.  The log file for the charm
+will indicate the reason.  No policy override files are installed if the `PO
+(broken):` is shown.  The status line indicates that the overrides are broken,
+not that the policy for the service has failed. The policy will be the defaults
+for the charm and service.
+
+Policy overrides on one service may affect the functionality of another
+service. Therefore, it may be necessary to provide policy overrides for
+multiple service charms to achieve a consistent set of policies across the
+OpenStack system.  The charms for the other services that may need overrides
+should be checked to ensure that they support overrides before proceeding.
+"""
+
+POLICYD_VALID_EXTS = ['.yaml', '.yml', '.j2', '.tmpl', '.tpl']
+POLICYD_TEMPLATE_EXTS = ['.j2', '.tmpl', '.tpl']
+POLICYD_RESOURCE_NAME = "policyd-override"
+POLICYD_CONFIG_NAME = "use-policyd-override"
+POLICYD_SUCCESS_FILENAME = "policyd-override-success"
+POLICYD_LOG_LEVEL_DEFAULT = hookenv.INFO
+POLICYD_ALWAYS_BLACKLISTED_KEYS = ("admin_required", "cloud_admin")
+
+
+class BadPolicyZipFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+class BadPolicyYamlFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+if six.PY2:
+    BadZipFile = zipfile.BadZipfile
+else:
+    BadZipFile = zipfile.BadZipFile
+
+
+def is_policyd_override_valid_on_this_release(openstack_release):
+    """Check that the charm is running on at least Ubuntu Xenial, and at
+    least the queens release.
+
+    :param openstack_release: the release codename that is installed.
+    :type openstack_release: str
+    :returns: True if okay
+    :rtype: bool
+    """
+    # NOTE(ajkavanagh) circular import!  This is because the status message
+    # generation code in utils has to call into this module, but this function
+    # needs the CompareOpenStackReleases() function.  The only way to solve
+    # this is either to put ALL of this module into utils, or refactor one or
+    # other of the CompareOpenStackReleases or status message generation code
+    # into a 3rd module.
+    import charmhelpers.contrib.openstack.utils as ch_utils
+    return ch_utils.CompareOpenStackReleases(openstack_release) >= 'queens'
+
+
+def maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=None,
+                               blacklist_keys=None,
+                               template_function=None,
+                               restart_handler=None,
+                               user=None,
+                               group=None,
+                               config_changed=False):
+    """If the config option is set, get the resource file and process it to
+    enable the policy.d overrides for the service passed.
+
+    The param `openstack_release` is required as the policyd overrides feature
+    is only supported on openstack_release "queens" or later, and on ubuntu
+    "xenial" or later.  Prior to these versions, this feature is a NOP.
+
+    The optional template_function is a function that accepts a string and has
+    an opportunity to modify the loaded file prior to it being read by
+    yaml.safe_load().  This allows the charm to perform "templating" using
+    charm derived data.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The param restart_handler is an optional Callable that is called to perform
+    the service restart if the policy.d file is changed.  This should normally
+    be None as oslo.policy automatically picks up changes in the policy.d
+    directory.  However, for any services where this is buggy then a
+    restart_handler can be used to force the policy.d files to be read.
+
+    If the config_changed param is True, then the handling is slightly
+    different: It will only perform the policyd overrides if the config is True
+    and the success file doesn't exist.  Otherwise, it does nothing as the
+    resource file has already been processed.
+
+    :param openstack_release: The openstack release that is installed.
+    :type openstack_release: str
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the string
+                              prior to being processed as a Yaml document.
+    :type template_function: Union[None, Callable[[str], str]]
+    :param restart_handler: The function to call if the service should be
+                            restarted.
+    :type restart_handler: Union[None, Callable[]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :param config_changed: Set to True for config_changed hook.
+    :type config_changed: bool
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    if not is_policyd_override_valid_on_this_release(openstack_release):
+        return
+    hookenv.log("Running maybe_do_policyd_overrides",
+                level=POLICYD_LOG_LEVEL_DEFAULT)
+    config = hookenv.config()
+    try:
+        if not config.get(POLICYD_CONFIG_NAME, False):
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            if (os.path.isfile(_policy_success_file()) and
+                    restart_handler is not None and
+                    callable(restart_handler)):
+                restart_handler()
+            remove_policy_success_file()
+            return
+    except Exception as e:
+        hookenv.log("... ERROR: Exception is: {}".format(str(e)),
+                    level=POLICYD_CONFIG_NAME)
+        import traceback
+        hookenv.log(traceback.format_exc(), level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # if the policyd overrides have been performed when doing config_changed
+    # just return
+    if config_changed and is_policy_success_file_set():
+        hookenv.log("... already setup, so skipping.",
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # from now on it should succeed; if it doesn't then status line will show
+    # broken.
+    resource_filename = get_policy_resource_filename()
+    restart = process_policy_resource_file(
+        resource_filename, service, blacklist_paths, blacklist_keys,
+        template_function)
+    if restart and restart_handler is not None and callable(restart_handler):
+        restart_handler()
+
+
+@charmhelpers.deprecate("Use maybe_do_poliyd_overrrides instead")
+def maybe_do_policyd_overrides_on_config_changed(*args, **kwargs):
+    """This function is designed to be called from the config changed hook.
+
+    DEPRECATED: please use maybe_do_policyd_overrides() with the param
+    `config_changed` as `True`.
+
+    See maybe_do_policyd_overrides() for more details on the params.
+    """
+    if 'config_changed' not in kwargs.keys():
+        kwargs['config_changed'] = True
+    return maybe_do_policyd_overrides(*args, **kwargs)
+
+
+def get_policy_resource_filename():
+    """Function to extract the policy resource filename
+
+    :returns: The filename of the resource, if set, otherwise, if an error
+               occurs, then None is returned.
+    :rtype: Union[str, None]
+    """
+    try:
+        return hookenv.resource_get(POLICYD_RESOURCE_NAME)
+    except Exception:
+        return None
+
+
+@contextlib.contextmanager
+def open_and_filter_yaml_files(filepath, has_subdirs=False):
+    """Validate that the filepath provided is a zip file and contains at least
+    one (.yaml|.yml) file, and that the files are not duplicated when the zip
+    file is flattened.  Note that the yaml files are not checked.  This is the
+    first stage in validating the policy zipfile; individual yaml files are not
+    checked for validity or black listed keys.
+
+    If the has_subdirs param is True, then the files are flattened to the first
+    directory, and the files in the root are ignored.
+
+    An example of use is:
+
+        with open_and_filter_yaml_files(some_path) as zfp, g:
+            for zipinfo in g:
+                # do something with zipinfo ...
+
+    :param filepath: a filepath object that can be opened by zipfile
+    :type filepath: Union[AnyStr, os.PathLike[AntStr]]
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: (zfp handle,
+               a generator of the (name, filename, ZipInfo object) tuples) as a
+               tuple.
+    :rtype: ContextManager[(zipfile.ZipFile,
+                            Generator[(name, str, str, zipfile.ZipInfo)])]
+    :raises: zipfile.BadZipFile
+    :raises: BadPolicyZipFile if duplicated yaml or missing
+    :raises: IOError if the filepath is not found
+    """
+    with zipfile.ZipFile(filepath, 'r') as zfp:
+        # first pass through; check for duplicates and at least one yaml file.
+        names = collections.defaultdict(int)
+        yamlfiles = _yamlfiles(zfp, has_subdirs)
+        for name, _, _, _ in yamlfiles:
+            names[name] += 1
+        # There must be at least 1 yaml file.
+        if len(names.keys()) == 0:
+            raise BadPolicyZipFile("contains no yaml files with {} extensions."
+                                   .format(", ".join(POLICYD_VALID_EXTS)))
+        # There must be no duplicates
+        duplicates = [n for n, c in names.items() if c > 1]
+        if duplicates:
+            raise BadPolicyZipFile("{} have duplicates in the zip file."
+                                   .format(", ".join(duplicates)))
+        # Finally, let's yield the generator
+        yield (zfp, yamlfiles)
+
+
+def _yamlfiles(zipfile, has_subdirs=False):
+    """Helper to get a yaml file (according to POLICYD_VALID_EXTS extensions)
+    and the infolist item from a zipfile.
+
+    If the `has_subdirs` param is True, the the only yaml files that have a
+    directory component are read, and then first part of the directory
+    component is kept, along with the filename in the name.  e.g. an entry with
+    a filename of:
+
+        compute/someotherdir/override.yaml
+
+    is returned as:
+
+        compute/override, yaml, override.yaml, <ZipInfo object>
+
+    This is to help with the special, additional, processing that the dashboard
+    charm requires.
+
+    :param zipfile: the zipfile to read zipinfo items from
+    :type zipfile: zipfile.ZipFile
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: generator of (name, ext, filename, info item) for each
+              self-identified yaml file.
+    :rtype: List[(str, str, str, zipfile.ZipInfo)]
+    """
+    files = []
+    for infolist_item in zipfile.infolist():
+        try:
+            if infolist_item.is_dir():
+                continue
+        except AttributeError:
+            # fallback to "old" way to determine dir entry for pre-py36
+            if infolist_item.filename.endswith('/'):
+                continue
+        _dir, name_ext = os.path.split(infolist_item.filename)
+        name, ext = os.path.splitext(name_ext)
+        if has_subdirs and _dir != "":
+            name = os.path.join(_dir.split(os.path.sep)[0], name)
+        ext = ext.lower()
+        if ext and ext in POLICYD_VALID_EXTS:
+            files.append((name, ext, name_ext, infolist_item))
+    return files
+
+
+def read_and_validate_yaml(stream_or_doc, blacklist_keys=None):
+    """Read, validate and return the (first) yaml document from the stream.
+
+    The doc is read, and checked for a yaml file.  The the top-level keys are
+    checked against the blacklist_keys provided.  If there are problems then an
+    Exception is raised.  Otherwise the yaml document is returned as a Python
+    object that can be dumped back as a yaml file on the system.
+
+    The yaml file must only consist of a str:str mapping, and if not then the
+    yaml file is rejected.
+
+    :param stream_or_doc: the file object to read the yaml from
+    :type stream_or_doc: Union[AnyStr, IO[AnyStr]]
+    :param blacklist_keys: Any keys, which if in the yaml file, should cause
+        and error.
+    :type blacklisted_keys: Union[None, List[str]]
+    :returns: the yaml file as a python document
+    :rtype: Dict[str, str]
+    :raises: yaml.YAMLError if there is a problem with the document
+    :raises: BadPolicyYamlFile if file doesn't look right or there are
+             blacklisted keys in the file.
+    """
+    blacklist_keys = blacklist_keys or []
+    blacklist_keys.append(POLICYD_ALWAYS_BLACKLISTED_KEYS)
+    doc = yaml.safe_load(stream_or_doc)
+    if not isinstance(doc, dict):
+        raise BadPolicyYamlFile("doesn't look like a policy file?")
+    keys = set(doc.keys())
+    blacklisted_keys_present = keys.intersection(blacklist_keys)
+    if blacklisted_keys_present:
+        raise BadPolicyYamlFile("blacklisted keys {} present."
+                                .format(", ".join(blacklisted_keys_present)))
+    if not all(isinstance(k, six.string_types) for k in keys):
+        raise BadPolicyYamlFile("keys in yaml aren't all strings?")
+    # check that the dictionary looks like a mapping of str to str
+    if not all(isinstance(v, six.string_types) for v in doc.values()):
+        raise BadPolicyYamlFile("values in yaml aren't all strings?")
+    return doc
+
+
+def policyd_dir_for(service):
+    """Return the policy directory for the named service.
+
+    :param service: str
+    :returns: the policy.d override directory.
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join("/", "etc", service, "policy.d")
+
+
+def clean_policyd_dir_for(service, keep_paths=None, user=None, group=None):
+    """Clean out the policyd directory except for items that should be kept.
+
+    The keep_paths, if used, should be set to the full path of the files that
+    should be kept in the policyd directory for the service.  Note that the
+    service name is passed in, and then the policyd_dir_for() function is used.
+    This is so that a coding error doesn't result in a sudden deletion of the
+    charm (say).
+
+    :param service: the service name to use to construct the policy.d dir.
+    :type service: str
+    :param keep_paths: optional list of paths to not delete.
+    :type keep_paths: Union[None, List[str]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    keep_paths = keep_paths or []
+    path = policyd_dir_for(service)
+    hookenv.log("Cleaning path: {}".format(path), level=hookenv.DEBUG)
+    if not os.path.exists(path):
+        ch_host.mkdir(path, owner=_user, group=_group, perms=0o775)
+    _scanner = os.scandir if hasattr(os, 'scandir') else _fallback_scandir
+    for direntry in _scanner(path):
+        # see if the path should be kept.
+        if direntry.path in keep_paths:
+            continue
+        # we remove any directories; it's ours and there shouldn't be any
+        if direntry.is_dir():
+            shutil.rmtree(direntry.path)
+        else:
+            os.remove(direntry.path)
+
+
+def maybe_create_directory_for(path, user, group):
+    """For the filename 'path', ensure that the directory for that path exists.
+
+    Note that if the directory already exists then the permissions are NOT
+    changed.
+
+    :param path: the filename including the path to it.
+    :type path: str
+    :param user: the user to create the directory as
+    :param group: the group to create the directory as
+    """
+    _dir, _ = os.path.split(path)
+    if not os.path.exists(_dir):
+        ch_host.mkdir(_dir, owner=user, group=group, perms=0o775)
+
+
+@contextlib.contextmanager
+def _fallback_scandir(path):
+    """Fallback os.scandir implementation.
+
+    provide a fallback implementation of os.scandir if this module ever gets
+    used in a py2 or py34 charm. Uses os.listdir() to get the names in the path,
+    and then mocks the is_dir() function using os.path.isdir() to check for
+    directory.
+
+    :param path: the path to list the directories for
+    :type path: str
+    :returns: Generator that provides _FBDirectory objects
+    :rtype: ContextManager[_FBDirectory]
+    """
+    for f in os.listdir(path):
+        yield _FBDirectory(f)
+
+
+class _FBDirectory(object):
+    """Mock a scandir Directory object with enough to use in
+    clean_policyd_dir_for
+    """
+
+    def __init__(self, path):
+        self.path = path
+
+    def is_dir(self):
+        return os.path.isdir(self.path)
+
+
+def path_for_policy_file(service, name):
+    """Return the full path for a policy.d file that will be written to the
+    service's policy.d directory.
+
+    It is constructed using policyd_dir_for(), the name and the ".yaml"
+    extension.
+
+    For horizon, for example, it's a bit more complicated.  The name param is
+    actually "override_service_dir/a_name", where target_service needs to be
+    one the allowed horizon override services.  This translation and check is
+    done in the _yamlfiles() function.
+
+    :param service: the service name
+    :type service: str
+    :param name: the name for the policy override
+    :type name: str
+    :returns: the full path name for the file
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join(policyd_dir_for(service), name + ".yaml")
+
+
+def _policy_success_file():
+    """Return the file name for a successful drop of policy.d overrides
+
+    :returns: the path name for the file.
+    :rtype: str
+    """
+    return os.path.join(hookenv.charm_dir(), POLICYD_SUCCESS_FILENAME)
+
+
+def remove_policy_success_file():
+    """Remove the file that indicates successful policyd override."""
+    try:
+        os.remove(_policy_success_file())
+    except Exception:
+        pass
+
+
+def set_policy_success_file():
+    """Set the file that indicates successful policyd override."""
+    open(_policy_success_file(), "w").close()
+
+
+def is_policy_success_file_set():
+    """Returns True if the policy success file has been set.
+
+    This indicates that policies are overridden and working properly.
+
+    :returns: True if the policy file is set
+    :rtype: bool
+    """
+    return os.path.isfile(_policy_success_file())
+
+
+def policyd_status_message_prefix():
+    """Return the prefix str for the status line.
+
+    "PO:" indicating that the policy overrides are in place, or "PO (broken):"
+    if the policy is supposed to be working but there is no success file.
+
+    :returns: the prefix
+    :rtype: str
+    """
+    if is_policy_success_file_set():
+        return "PO:"
+    return "PO (broken):"
+
+
+def process_policy_resource_file(resource_file,
+                                 service,
+                                 blacklist_paths=None,
+                                 blacklist_keys=None,
+                                 template_function=None,
+                                 preserve_topdir=False,
+                                 preprocess_filename=None,
+                                 user=None,
+                                 group=None):
+    """Process the resource file (which should contain at least one yaml file)
+    and write those files to the service's policy.d directory.
+
+    The optional template_function is a function that accepts a python
+    string and has an opportunity to modify the document
+    prior to it being read by the yaml.safe_load() function and written to
+    disk. Note that this function does *not* say how the templating is done -
+    this is up to the charm to implement its chosen method.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The yaml filename can be modified in two ways.  If the `preserve_topdir`
+    param is True, then files will be flattened to the top dir.  This allows
+    for creating sets of files that can be grouped into a single level tree
+    structure.
+
+    Secondly, if the `preprocess_filename` param is not None and callable()
+    then the name is passed to that function for preprocessing before being
+    converted to the end location.  This is to allow munging of the filename
+    prior to being tested for a blacklist path.
+
+    If any error occurs, then the policy.d directory is cleared, the error is
+    written to the log, and the status line will eventually show as failed.
+
+    :param resource_file: The zipped file to open and extract yaml files form.
+    :type resource_file: Union[AnyStr, os.PathLike[AnyStr]]
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the yaml
+                              document.
+    :type template_function: Union[None, Callable[[AnyStr], AnyStr]]
+    :param preserve_topdir: Keep the toplevel subdir
+    :type preserve_topdir: bool
+    :param preprocess_filename: Optional function to use to process filenames
+                                extracted from the resource file.
+    :type preprocess_filename: Union[None, Callable[[AnyStr]. AnyStr]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :returns: True if the processing was successful, False if not.
+    :rtype: boolean
+    """
+    hookenv.log("Running process_policy_resource_file", level=hookenv.DEBUG)
+    blacklist_paths = blacklist_paths or []
+    completed = False
+    _preprocess = None
+    if preprocess_filename is not None and callable(preprocess_filename):
+        _preprocess = preprocess_filename
+    _user = service if user is None else user
+    _group = service if group is None else group
+    try:
+        with open_and_filter_yaml_files(
+                resource_file, preserve_topdir) as (zfp, gen):
+            # first clear out the policy.d directory and clear success
+            remove_policy_success_file()
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            for name, ext, filename, zipinfo in gen:
+                # See if the name should be preprocessed.
+                if _preprocess is not None:
+                    name = _preprocess(name)
+                # construct a name for the output file.
+                yaml_filename = path_for_policy_file(service, name)
+                if yaml_filename in blacklist_paths:
+                    raise BadPolicyZipFile("policy.d name {} is blacklisted"
+                                           .format(yaml_filename))
+                with zfp.open(zipinfo) as fp:
+                    doc = fp.read()
+                    # if template_function is not None, then offer the document
+                    # to the template function
+                    if ext in POLICYD_TEMPLATE_EXTS:
+                        if (template_function is None or not
+                                callable(template_function)):
+                            raise BadPolicyZipFile(
+                                "Template {} but no template_function is "
+                                "available".format(filename))
+                        doc = template_function(doc)
+                    yaml_doc = read_and_validate_yaml(doc, blacklist_keys)
+                # we may have to create the directory
+                maybe_create_directory_for(yaml_filename, _user, _group)
+                ch_host.write_file(yaml_filename,
+                                   yaml.dump(yaml_doc).encode('utf-8'),
+                                   _user,
+                                   _group)
+        # Every thing worked, so we mark up a success.
+        completed = True
+    except (BadZipFile, BadPolicyZipFile, BadPolicyYamlFile) as e:
+        hookenv.log("Processing {} failed: {}".format(resource_file, str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+    except IOError as e:
+        # technically this shouldn't happen; it would be a programming error as
+        # the filename comes from Juju and thus, should exist.
+        hookenv.log(
+            "File {} failed with IOError.  This really shouldn't happen"
+            " -- error: {}".format(resource_file, str(e)),
+            level=POLICYD_LOG_LEVEL_DEFAULT)
+    except Exception as e:
+        import traceback
+        hookenv.log("General Exception({}) during policyd processing"
+                    .format(str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        hookenv.log(traceback.format_exc())
+    finally:
+        if not completed:
+            hookenv.log("Processing {} failed: cleaning policy.d directory"
+                        .format(resource_file),
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+        else:
+            # touch the success filename
+            hookenv.log("policy.d overrides installed.",
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            set_policy_success_file()
+        return completed
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ssh_migrations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ssh_migrations.py
new file mode 100644
index 0000000000000000000000000000000000000000..96b9f71d42d1c81539f78b8e1c4761f81d84c304
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/ssh_migrations.py
@@ -0,0 +1,412 @@
+# Copyright 2018 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    ERROR,
+    log,
+    relation_get,
+)
+from charmhelpers.contrib.network.ip import (
+    is_ipv6,
+    ns_query,
+)
+from charmhelpers.contrib.openstack.utils import (
+    get_hostname,
+    get_host_ip,
+    is_ip,
+)
+
+NOVA_SSH_DIR = '/etc/nova/compute_ssh/'
+
+
+def ssh_directory_for_unit(application_name, user=None):
+    """Return the directory used to store ssh assets for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified directory path.
+    :rtype: str
+    """
+    if user:
+        application_name = "{}_{}".format(application_name, user)
+    _dir = os.path.join(NOVA_SSH_DIR, application_name)
+    for d in [NOVA_SSH_DIR, _dir]:
+        if not os.path.isdir(d):
+            os.mkdir(d)
+    for f in ['authorized_keys', 'known_hosts']:
+        f = os.path.join(_dir, f)
+        if not os.path.isfile(f):
+            open(f, 'w').close()
+    return _dir
+
+
+def known_hosts(application_name, user=None):
+    """Return the known hosts file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'known_hosts')
+
+
+def authorized_keys(application_name, user=None):
+    """Return the authorized keys file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'authorized_keys')
+
+
+def ssh_known_host_key(host, application_name, user=None):
+    """Return the first entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Host key
+    :rtype: str or None
+    """
+    cmd = [
+        'ssh-keygen',
+        '-f', known_hosts(application_name, user),
+        '-H',
+        '-F',
+        host]
+    try:
+        # The first line of output is like '# Host xx found: line 1 type RSA',
+        # which should be excluded.
+        output = subprocess.check_output(cmd)
+    except subprocess.CalledProcessError as e:
+        # RC of 1 seems to be legitimate for most ssh-keygen -F calls.
+        if e.returncode == 1:
+            output = e.output
+        else:
+            raise
+    output = output.strip()
+
+    if output:
+        # Bug #1500589 cmd has 0 rc on precise if entry not present
+        lines = output.split('\n')
+        if len(lines) >= 1:
+            return lines[0]
+
+    return None
+
+
+def remove_known_host(host, application_name, user=None):
+    """Remove the entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    log('Removing SSH known host entry for compute host at %s' % host)
+    cmd = ['ssh-keygen', '-f', known_hosts(application_name, user), '-R', host]
+    subprocess.check_call(cmd)
+
+
+def is_same_key(key_1, key_2):
+    """Extract the key from two host entries and compare them.
+
+    :param key_1: Host key
+    :type key_1: str
+    :param key_2: Host key
+    :type key_2: str
+    """
+    # The key format get will be like '|1|2rUumCavEXWVaVyB5uMl6m85pZo=|Cp'
+    # 'EL6l7VTY37T/fg/ihhNb/GPgs= ssh-rsa AAAAB', we only need to compare
+    # the part start with 'ssh-rsa' followed with '= ', because the hash
+    # value in the beginning will change each time.
+    k_1 = key_1.split('= ')[1]
+    k_2 = key_2.split('= ')[1]
+    return k_1 == k_2
+
+
+def add_known_host(host, application_name, user=None):
+    """Add the given host key to the known hosts file.
+
+    :param host: host name
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    cmd = ['ssh-keyscan', '-H', '-t', 'rsa', host]
+    try:
+        remote_key = subprocess.check_output(cmd).strip()
+    except Exception as e:
+        log('Could not obtain SSH host key from %s' % host, level=ERROR)
+        raise e
+
+    current_key = ssh_known_host_key(host, application_name, user)
+    if current_key and remote_key:
+        if is_same_key(remote_key, current_key):
+            log('Known host key for compute host %s up to date.' % host)
+            return
+        else:
+            remove_known_host(host, application_name, user)
+
+    log('Adding SSH host key to known hosts for compute node at %s.' % host)
+    with open(known_hosts(application_name, user), 'a') as out:
+        out.write("{}\n".format(remote_key))
+
+
+def ssh_authorized_key_exists(public_key, application_name, user=None):
+    """Check if given key is in the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Whether given key is in the authorized_key file.
+    :rtype: boolean
+    """
+    with open(authorized_keys(application_name, user)) as keys:
+        return ('%s' % public_key) in keys.read()
+
+
+def add_authorized_key(public_key, application_name, user=None):
+    """Add given key to the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    with open(authorized_keys(application_name, user), 'a') as keys:
+        keys.write("{}\n".format(public_key))
+
+
+def ssh_compute_add_host_and_key(public_key, hostname, private_address,
+                                 application_name, user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param hostname: Hostname to collect host keys from.
+    :type hostname: str
+    :param private_address:aCorresponding private address for hostname
+    :type private_address: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    # If remote compute node hands us a hostname, ensure we have a
+    # known hosts entry for its IP, hostname and FQDN.
+    hosts = [private_address]
+
+    if not is_ipv6(private_address):
+        if hostname:
+            hosts.append(hostname)
+
+        if is_ip(private_address):
+            hn = get_hostname(private_address)
+            if hn:
+                hosts.append(hn)
+                short = hn.split('.')[0]
+                if ns_query(short):
+                    hosts.append(short)
+        else:
+            hosts.append(get_host_ip(private_address))
+            short = private_address.split('.')[0]
+            if ns_query(short):
+                hosts.append(short)
+
+    for host in list(set(hosts)):
+        add_known_host(host, application_name, user)
+
+    if not ssh_authorized_key_exists(public_key, application_name, user):
+        log('Saving SSH authorized key for compute host at %s.' %
+            private_address)
+        add_authorized_key(public_key, application_name, user)
+
+
+def ssh_compute_add(public_key, application_name, rid=None, unit=None,
+                    user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param rid: Relation id of the relation between this charm and the app. If
+                none is supplied it is assumed its the relation relating to
+                the current hook context.
+    :type rid: str
+    :param unit: Unit to add ssh asserts for if none is supplied it is assumed
+                 its the unit relating to the current hook context.
+    :type unit: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    relation_data = relation_get(rid=rid, unit=unit)
+    ssh_compute_add_host_and_key(
+        public_key,
+        relation_data.get('hostname'),
+        relation_data.get('private-address'),
+        application_name,
+        user=user)
+
+
+def ssh_known_hosts_lines(application_name, user=None):
+    """Return contents of known_hosts file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    known_hosts_list = []
+    with open(known_hosts(application_name, user)) as hosts:
+        for hosts_line in hosts:
+            if hosts_line.rstrip():
+                known_hosts_list.append(hosts_line.rstrip())
+    return(known_hosts_list)
+
+
+def ssh_authorized_keys_lines(application_name, user=None):
+    """Return contents of authorized_keys file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    authorized_keys_list = []
+
+    with open(authorized_keys(application_name, user)) as keys:
+        for authkey_line in keys:
+            if authkey_line.rstrip():
+                authorized_keys_list.append(authkey_line.rstrip())
+    return(authorized_keys_list)
+
+
+def ssh_compute_remove(public_key, application_name, user=None):
+    """Remove given public key from authorized_keys file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    if not (os.path.isfile(authorized_keys(application_name, user)) or
+            os.path.isfile(known_hosts(application_name, user))):
+        return
+
+    keys = ssh_authorized_keys_lines(application_name, user=None)
+    keys = [k.strip() for k in keys]
+
+    if public_key not in keys:
+        return
+
+    [keys.remove(key) for key in keys if key == public_key]
+
+    with open(authorized_keys(application_name, user), 'w') as _keys:
+        keys = '\n'.join(keys)
+        if not keys.endswith('\n'):
+            keys += '\n'
+        _keys.write(keys)
+
+
+def get_ssh_settings(application_name, user=None):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for the
+    app + user combination.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = {}
+    keys = {}
+    prefix = ''
+    if user:
+        prefix = '{}_'.format(user)
+
+    for i, line in enumerate(ssh_known_hosts_lines(
+            application_name=application_name, user=user)):
+        settings['{}known_hosts_{}'.format(prefix, i)] = line
+    if settings:
+        settings['{}known_hosts_max_index'.format(prefix)] = len(
+            settings.keys())
+
+    for i, line in enumerate(ssh_authorized_keys_lines(
+            application_name=application_name, user=user)):
+        keys['{}authorized_keys_{}'.format(prefix, i)] = line
+    if keys:
+        keys['{}authorized_keys_max_index'.format(prefix)] = len(keys.keys())
+    settings.update(keys)
+    return settings
+
+
+def get_all_user_ssh_settings(application_name):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for root user
+    and nova user.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = get_ssh_settings(application_name)
+    settings.update(get_ssh_settings(application_name, user='nova'))
+    return settings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/ceph.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/ceph.conf
new file mode 100644
index 0000000000000000000000000000000000000000..a11ce8ab85654a4d838e448f36fe3698b59f9531
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/ceph.conf
@@ -0,0 +1,24 @@
+###############################################################################
+# [ WARNING ]
+# ceph configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+[global]
+{% if auth -%}
+auth_supported = {{ auth }}
+keyring = /etc/ceph/$cluster.$name.keyring
+mon host = {{ mon_hosts }}
+{% endif -%}
+log to syslog = {{ use_syslog }}
+err to syslog = {{ use_syslog }}
+clog to syslog = {{ use_syslog }}
+{% if rbd_features %}
+rbd default features = {{ rbd_features }}
+{% endif %}
+
+[client]
+{% if rbd_client_cache_settings -%}
+{% for key, value in rbd_client_cache_settings.items() -%}
+{{ key }} = {{ value }}
+{% endfor -%}
+{%- endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/git.upstart b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/git.upstart
new file mode 100644
index 0000000000000000000000000000000000000000..4bed404bc01087c4dec6a44a56d17ed122e1d1e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/git.upstart
@@ -0,0 +1,17 @@
+description "{{ service_description }}"
+author "Juju {{ service_name }} Charm <juju@localhost>"
+
+start on runlevel [2345]
+stop on runlevel [!2345]
+
+respawn
+
+exec start-stop-daemon --start --chuid {{ user_name }} \
+            --chdir {{ start_dir }} --name {{ process_name }} \
+            --exec {{ executable_name }} -- \
+            {% for config_file in config_files -%}
+            --config-file={{ config_file }} \
+            {% endfor -%}
+            {% if log_file -%}
+            --log-file={{ log_file }}
+            {% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..d36af2aa86f91b2ee1249594fffd106843dd0676
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg
@@ -0,0 +1,77 @@
+global
+    log /var/lib/haproxy/dev/log local0
+    log /var/lib/haproxy/dev/log local1 notice
+    maxconn 20000
+    user haproxy
+    group haproxy
+    spread-checks 0
+    stats socket /var/run/haproxy/admin.sock mode 600 level admin
+    stats timeout 2m
+
+defaults
+    log global
+    mode tcp
+    option tcplog
+    option dontlognull
+    retries 3
+{%- if haproxy_queue_timeout %}
+    timeout queue {{ haproxy_queue_timeout }}
+{%- else %}
+    timeout queue 9000
+{%- endif %}
+{%- if haproxy_connect_timeout %}
+    timeout connect {{ haproxy_connect_timeout }}
+{%- else %}
+    timeout connect 9000
+{%- endif %}
+{%- if haproxy_client_timeout %}
+    timeout client {{ haproxy_client_timeout }}
+{%- else %}
+    timeout client 90000
+{%- endif %}
+{%- if haproxy_server_timeout %}
+    timeout server {{ haproxy_server_timeout }}
+{%- else %}
+    timeout server 90000
+{%- endif %}
+
+listen stats
+    bind {{ local_host }}:{{ stat_port }}
+    mode http
+    stats enable
+    stats hide-version
+    stats realm Haproxy\ Statistics
+    stats uri /
+    stats auth admin:{{ stat_password }}
+
+{% if frontends -%}
+{% for service, ports in service_ports.items() -%}
+frontend tcp-in_{{ service }}
+    bind *:{{ ports[0] }}
+    {% if ipv6_enabled -%}
+    bind :::{{ ports[0] }}
+    {% endif -%}
+    {% for frontend in frontends -%}
+    acl net_{{ frontend }} dst {{ frontends[frontend]['network'] }}
+    use_backend {{ service }}_{{ frontend }} if net_{{ frontend }}
+    {% endfor -%}
+    default_backend {{ service }}_{{ default_backend }}
+
+{% for frontend in frontends -%}
+backend {{ service }}_{{ frontend }}
+    balance leastconn
+    {% if backend_options -%}
+    {% if backend_options[service] -%}
+    {% for option in backend_options[service] -%}
+    {% for key, value in option.items() -%}
+    {{ key }} {{ value }}
+    {% endfor -%}
+    {% endfor -%}
+    {% endif -%}
+    {% endif -%}
+    {% for unit, address in frontends[frontend]['backends'].items() -%}
+    server {{ unit }} {{ address }}:{{ ports[1] }} check
+    {% endfor %}
+{% endfor -%}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/logrotate b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/logrotate
new file mode 100644
index 0000000000000000000000000000000000000000..b2900d09a4ec2d04152ed7ce25bdc7346c349675
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/logrotate
@@ -0,0 +1,9 @@
+/var/log/{{ logrotate_logs_location }}/*.log {
+    {{ logrotate_interval }}
+    {{ logrotate_count }}
+    compress
+    delaycompress
+    missingok
+    notifempty
+    copytruncate
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/memcached.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/memcached.conf
new file mode 100644
index 0000000000000000000000000000000000000000..26cb037c72beccdb1a4f9269844abdbac2406369
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/memcached.conf
@@ -0,0 +1,53 @@
+###############################################################################
+# [ WARNING ]
+# memcached configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+
+# memcached default config file
+# 2003 - Jay Bonci <jaybonci@debian.org>
+# This configuration file is read by the start-memcached script provided as
+# part of the Debian GNU/Linux distribution.
+
+# Run memcached as a daemon. This command is implied, and is not needed for the
+# daemon to run. See the README.Debian that comes with this package for more
+# information.
+-d
+
+# Log memcached's output to /var/log/memcached
+logfile /var/log/memcached.log
+
+# Be verbose
+# -v
+
+# Be even more verbose (print client commands as well)
+# -vv
+
+# Start with a cap of 64 megs of memory. It's reasonable, and the daemon default
+# Note that the daemon will grow to this size, but does not start out holding this much
+# memory
+-m 64
+
+# Default connection port is 11211
+-p {{ memcache_port }}
+
+# Run the daemon as root. The start-memcached will default to running as root if no
+# -u command is present in this config file
+-u memcache
+
+# Specify which IP address to listen on. The default is to listen on all IP addresses
+# This parameter is one of the only security measures that memcached has, so make sure
+# it's listening on a firewalled interface.
+-l {{ memcache_server }}
+
+# Limit the number of simultaneous incoming connections. The daemon default is 1024
+# -c 1024
+
+# Lock down all paged memory. Consult with the README and homepage before you do this
+# -k
+
+# Return error when memory is exhausted (rather than removing items)
+# -M
+
+# Maximize core file limit
+# -r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
new file mode 100644
index 0000000000000000000000000000000000000000..5dcebe7c863728b040337616b492296f536b3ef3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
@@ -0,0 +1,12 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_plugin = password
+project_domain_id = default
+user_domain_id = default
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
new file mode 100644
index 0000000000000000000000000000000000000000..9356b2be4e7dabe089b4d7d39793146bb92f3f48
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
@@ -0,0 +1,10 @@
+{% if auth_host -%}
+[keystone_authtoken]
+# Juno specific config (Bug #1557223)
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/{{ service_admin_prefix }}
+identity_uri = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+admin_tenant_name = {{ admin_tenant_name }}
+admin_user = {{ admin_user }}
+admin_password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
new file mode 100644
index 0000000000000000000000000000000000000000..c281868b16a885cd01a234984974af0349a5d242
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
@@ -0,0 +1,22 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_type = password
+{% if api_version == "3" -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/v3
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}/v3
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
new file mode 100644
index 0000000000000000000000000000000000000000..d26a91fe1f00e2b12d094be727a53eddc87b829d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
@@ -0,0 +1,9 @@
+{% if auth_host -%}
+[keystone_authtoken]
+{% for option_name, option_value in keystone_authtoken.items() -%}
+{{ option_name }} = {{ option_value }}
+{% endfor -%}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache
new file mode 100644
index 0000000000000000000000000000000000000000..e056a32aafe32413cefb40b9414d064f2b0c8fd2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache
@@ -0,0 +1,6 @@
+[cache]
+{% if memcache_url %}
+enabled = true
+backend = oslo_cache.memcache_pool
+memcache_servers = {{ memcache_url }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
new file mode 100644
index 0000000000000000000000000000000000000000..bed2216aba7217022ded17dec4cdb0871f513b40
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
new file mode 100644
index 0000000000000000000000000000000000000000..365f43757719b2de3c601ea6a9752dac8a8b3545
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware
new file mode 100644
index 0000000000000000000000000000000000000000..dd73230a42aa037582989979c1bc8132d30b9b38
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware
@@ -0,0 +1,5 @@
+[oslo_middleware]
+
+# Bug #1758675
+enable_proxy_headers_parsing = true
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications
new file mode 100644
index 0000000000000000000000000000000000000000..71c7eb068eace94e8986d7a868bded236f75128c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications
@@ -0,0 +1,15 @@
+{% if transport_url -%}
+[oslo_messaging_notifications]
+driver = {{ oslo_messaging_driver }}
+transport_url = {{ transport_url }}
+{% if send_notifications_to_logs %}
+driver = log
+{% endif %}
+{% if notification_topics -%}
+topics = {{ notification_topics }}
+{% endif -%}
+{% if notification_format -%}
+[notifications]
+notification_format = {{ notification_format }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-placement b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-placement
new file mode 100644
index 0000000000000000000000000000000000000000..97724bdb5af6e0352d0b920600d7cbbc8318fa7c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-placement
@@ -0,0 +1,19 @@
+[placement]
+{% if auth_host -%}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_type = password
+{% if api_version == "3" -%}
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+{% endif -%}
+{% if region -%}
+os_region_name = {{ region }}
+{% endif -%}
+randomize_allocation_candidates = true
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
new file mode 100644
index 0000000000000000000000000000000000000000..b444c9c99bd179eaa0be31af462576e4ca9c45b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
@@ -0,0 +1,22 @@
+{% if rabbitmq_host or rabbitmq_hosts -%}
+[oslo_messaging_rabbit]
+rabbit_userid = {{ rabbitmq_user }}
+rabbit_virtual_host = {{ rabbitmq_virtual_host }}
+rabbit_password = {{ rabbitmq_password }}
+{% if rabbitmq_hosts -%}
+rabbit_hosts = {{ rabbitmq_hosts }}
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+rabbit_durable_queues = False
+{% endif -%}
+{% else -%}
+rabbit_host = {{ rabbitmq_host }}
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+rabbit_port = {{ rabbit_ssl_port }}
+{% if rabbit_ssl_ca -%}
+kombu_ssl_ca_certs = {{ rabbit_ssl_ca }}
+{% endif -%}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-zeromq b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-zeromq
new file mode 100644
index 0000000000000000000000000000000000000000..95f1a76ce87f9babdcba58da79c68d34c2776eea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/section-zeromq
@@ -0,0 +1,14 @@
+{% if zmq_host -%}
+# ZeroMQ configuration (restart-nonce: {{ zmq_nonce }})
+rpc_backend = zmq
+rpc_zmq_host = {{ zmq_host }}
+{% if zmq_redis_address -%}
+rpc_zmq_matchmaker = redis
+matchmaker_heartbeat_freq = 15
+matchmaker_heartbeat_ttl = 30
+[matchmaker_redis]
+host = {{ zmq_redis_address }}
+{% else -%}
+rpc_zmq_matchmaker = ring
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/vendor_data.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/vendor_data.json
new file mode 100644
index 0000000000000000000000000000000000000000..904f612a7f74490d4508920400d18d493d056477
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/vendor_data.json
@@ -0,0 +1 @@
+{{ vendor_data_json }}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..050f8af5c9135db4fafdbf5098edcd22c7157ff8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/templating.py
@@ -0,0 +1,379 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import six
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+    INFO,
+    TRACE
+)
+from charmhelpers.contrib.openstack.utils import OPENSTACK_CODENAMES
+
+try:
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+
+
+class OSConfigException(Exception):
+    pass
+
+
+def get_loader(templates_dir, os_release):
+    """
+    Create a jinja2.ChoiceLoader containing template dirs up to
+    and including os_release.  If directory template directory
+    is missing at templates_dir, it will be omitted from the loader.
+    templates_dir is added to the bottom of the search list as a base
+    loading dir.
+
+    A charm may also ship a templates dir with this module
+    and it will be appended to the bottom of the search list, eg::
+
+        hooks/charmhelpers/contrib/openstack/templates
+
+    :param templates_dir (str): Base template directory containing release
+        sub-directories.
+    :param os_release (str): OpenStack release codename to construct template
+        loader.
+    :returns: jinja2.ChoiceLoader constructed with a list of
+        jinja2.FilesystemLoaders, ordered in descending
+        order by OpenStack release.
+    """
+    tmpl_dirs = [(rel, os.path.join(templates_dir, rel))
+                 for rel in six.itervalues(OPENSTACK_CODENAMES)]
+
+    if not os.path.isdir(templates_dir):
+        log('Templates directory not found @ %s.' % templates_dir,
+            level=ERROR)
+        raise OSConfigException
+
+    # the bottom contains tempaltes_dir and possibly a common templates dir
+    # shipped with the helper.
+    loaders = [FileSystemLoader(templates_dir)]
+    helper_templates = os.path.join(os.path.dirname(__file__), 'templates')
+    if os.path.isdir(helper_templates):
+        loaders.append(FileSystemLoader(helper_templates))
+
+    for rel, tmpl_dir in tmpl_dirs:
+        if os.path.isdir(tmpl_dir):
+            loaders.insert(0, FileSystemLoader(tmpl_dir))
+        if rel == os_release:
+            break
+    # demote this log to the lowest level; we don't really need to see these
+    # lots in production even when debugging.
+    log('Creating choice loader with dirs: %s' %
+        [l.searchpath for l in loaders], level=TRACE)
+    return ChoiceLoader(loaders)
+
+
+class OSConfigTemplate(object):
+    """
+    Associates a config file template with a list of context generators.
+    Responsible for constructing a template context based on those generators.
+    """
+
+    def __init__(self, config_file, contexts, config_template=None):
+        self.config_file = config_file
+
+        if hasattr(contexts, '__call__'):
+            self.contexts = [contexts]
+        else:
+            self.contexts = contexts
+
+        self._complete_contexts = []
+
+        self.config_template = config_template
+
+    def context(self):
+        ctxt = {}
+        for context in self.contexts:
+            _ctxt = context()
+            if _ctxt:
+                ctxt.update(_ctxt)
+                # track interfaces for every complete context.
+                [self._complete_contexts.append(interface)
+                 for interface in context.interfaces
+                 if interface not in self._complete_contexts]
+        return ctxt
+
+    def complete_contexts(self):
+        '''
+        Return a list of interfaces that have satisfied contexts.
+        '''
+        if self._complete_contexts:
+            return self._complete_contexts
+        self.context()
+        return self._complete_contexts
+
+    @property
+    def is_string_template(self):
+        """:returns: Boolean if this instance is a template initialised with a string"""
+        return self.config_template is not None
+
+
+class OSConfigRenderer(object):
+    """
+    This class provides a common templating system to be used by OpenStack
+    charms.  It is intended to help charms share common code and templates,
+    and ease the burden of managing config templates across multiple OpenStack
+    releases.
+
+    Basic usage::
+
+        # import some common context generates from charmhelpers
+        from charmhelpers.contrib.openstack import context
+
+        # Create a renderer object for a specific OS release.
+        configs = OSConfigRenderer(templates_dir='/tmp/templates',
+                                   openstack_release='folsom')
+        # register some config files with context generators.
+        configs.register(config_file='/etc/nova/nova.conf',
+                         contexts=[context.SharedDBContext(),
+                                   context.AMQPContext()])
+        configs.register(config_file='/etc/nova/api-paste.ini',
+                         contexts=[context.IdentityServiceContext()])
+        configs.register(config_file='/etc/haproxy/haproxy.conf',
+                         contexts=[context.HAProxyContext()])
+        configs.register(config_file='/etc/keystone/policy.d/extra.cfg',
+                         contexts=[context.ExtraPolicyContext()
+                                   context.KeystoneContext()],
+                         config_template=hookenv.config('extra-policy'))
+        # write out a single config
+        configs.write('/etc/nova/nova.conf')
+        # write out all registered configs
+        configs.write_all()
+
+    **OpenStack Releases and template loading**
+
+    When the object is instantiated, it is associated with a specific OS
+    release.  This dictates how the template loader will be constructed.
+
+    The constructed loader attempts to load the template from several places
+    in the following order:
+    - from the most recent OS release-specific template dir (if one exists)
+    - the base templates_dir
+    - a template directory shipped in the charm with this helper file.
+
+    For the example above, '/tmp/templates' contains the following structure::
+
+        /tmp/templates/nova.conf
+        /tmp/templates/api-paste.ini
+        /tmp/templates/grizzly/api-paste.ini
+        /tmp/templates/havana/api-paste.ini
+
+    Since it was registered with the grizzly release, it first searches
+    the grizzly directory for nova.conf, then the templates dir.
+
+    When writing api-paste.ini, it will find the template in the grizzly
+    directory.
+
+    If the object were created with folsom, it would fall back to the
+    base templates dir for its api-paste.ini template.
+
+    This system should help manage changes in config files through
+    openstack releases, allowing charms to fall back to the most recently
+    updated config template for a given release
+
+    The haproxy.conf, since it is not shipped in the templates dir, will
+    be loaded from the module directory's template directory, eg
+    $CHARM/hooks/charmhelpers/contrib/openstack/templates.  This allows
+    us to ship common templates (haproxy, apache) with the helpers.
+
+    **Context generators**
+
+    Context generators are used to generate template contexts during hook
+    execution.  Doing so may require inspecting service relations, charm
+    config, etc.  When registered, a config file is associated with a list
+    of generators.  When a template is rendered and written, all context
+    generates are called in a chain to generate the context dictionary
+    passed to the jinja2 template. See context.py for more info.
+    """
+    def __init__(self, templates_dir, openstack_release):
+        if not os.path.isdir(templates_dir):
+            log('Could not locate templates dir %s' % templates_dir,
+                level=ERROR)
+            raise OSConfigException
+
+        self.templates_dir = templates_dir
+        self.openstack_release = openstack_release
+        self.templates = {}
+        self._tmpl_env = None
+
+        if None in [Environment, ChoiceLoader, FileSystemLoader]:
+            # if this code is running, the object is created pre-install hook.
+            # jinja2 shouldn't get touched until the module is reloaded on next
+            # hook execution, with proper jinja2 bits successfully imported.
+            if six.PY2:
+                apt_install('python-jinja2')
+            else:
+                apt_install('python3-jinja2')
+
+    def register(self, config_file, contexts, config_template=None):
+        """
+        Register a config file with a list of context generators to be called
+        during rendering.
+        config_template can be used to load a template from a string instead of
+        using template loaders and template files.
+        :param config_file (str): a path where a config file will be rendered
+        :param contexts (list): a list of context dictionaries with kv pairs
+        :param config_template (str): an optional template string to use
+        """
+        self.templates[config_file] = OSConfigTemplate(
+            config_file=config_file,
+            contexts=contexts,
+            config_template=config_template
+        )
+        log('Registered config file: {}'.format(config_file),
+            level=INFO)
+
+    def _get_tmpl_env(self):
+        if not self._tmpl_env:
+            loader = get_loader(self.templates_dir, self.openstack_release)
+            self._tmpl_env = Environment(loader=loader)
+
+    def _get_template(self, template):
+        self._get_tmpl_env()
+        template = self._tmpl_env.get_template(template)
+        log('Loaded template from {}'.format(template.filename),
+            level=INFO)
+        return template
+
+    def _get_template_from_string(self, ostmpl):
+        '''
+        Get a jinja2 template object from a string.
+        :param ostmpl: OSConfigTemplate to use as a data source.
+        '''
+        self._get_tmpl_env()
+        template = self._tmpl_env.from_string(ostmpl.config_template)
+        log('Loaded a template from a string for {}'.format(
+            ostmpl.config_file),
+            level=INFO)
+        return template
+
+    def render(self, config_file):
+        if config_file not in self.templates:
+            log('Config not registered: {}'.format(config_file), level=ERROR)
+            raise OSConfigException
+
+        ostmpl = self.templates[config_file]
+        ctxt = ostmpl.context()
+
+        if ostmpl.is_string_template:
+            template = self._get_template_from_string(ostmpl)
+            log('Rendering from a string template: '
+                '{}'.format(config_file),
+                level=INFO)
+        else:
+            _tmpl = os.path.basename(config_file)
+            try:
+                template = self._get_template(_tmpl)
+            except exceptions.TemplateNotFound:
+                # if no template is found with basename, try looking
+                # for it using a munged full path, eg:
+                # /etc/apache2/apache2.conf -> etc_apache2_apache2.conf
+                _tmpl = '_'.join(config_file.split('/')[1:])
+                try:
+                    template = self._get_template(_tmpl)
+                except exceptions.TemplateNotFound as e:
+                    log('Could not load template from {} by {} or {}.'
+                        ''.format(
+                            self.templates_dir,
+                            os.path.basename(config_file),
+                            _tmpl
+                        ),
+                        level=ERROR)
+                    raise e
+
+            log('Rendering from template: {}'.format(config_file),
+                level=INFO)
+        return template.render(ctxt)
+
+    def write(self, config_file):
+        """
+        Write a single config file, raises if config file is not registered.
+        """
+        if config_file not in self.templates:
+            log('Config not registered: %s' % config_file, level=ERROR)
+            raise OSConfigException
+
+        _out = self.render(config_file)
+        if six.PY3:
+            _out = _out.encode('UTF-8')
+
+        with open(config_file, 'wb') as out:
+            out.write(_out)
+
+        log('Wrote template %s.' % config_file, level=INFO)
+
+    def write_all(self):
+        """
+        Write out all registered config files.
+        """
+        [self.write(k) for k in six.iterkeys(self.templates)]
+
+    def set_release(self, openstack_release):
+        """
+        Resets the template environment and generates a new template loader
+        based on a the new openstack release.
+        """
+        self._tmpl_env = None
+        self.openstack_release = openstack_release
+        self._get_tmpl_env()
+
+    def complete_contexts(self):
+        '''
+        Returns a list of context interfaces that yield a complete context.
+        '''
+        interfaces = []
+        [interfaces.extend(i.complete_contexts())
+         for i in six.itervalues(self.templates)]
+        return interfaces
+
+    def get_incomplete_context_data(self, interfaces):
+        '''
+        Return dictionary of relation status of interfaces and any missing
+        required context data. Example:
+            {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+             'zeromq-configuration': {'related': False}}
+        '''
+        incomplete_context_data = {}
+
+        for i in six.itervalues(self.templates):
+            for context in i.contexts:
+                for interface in interfaces:
+                    related = False
+                    if interface in context.interfaces:
+                        related = context.get_related()
+                        missing_data = context.missing_data
+                        if missing_data:
+                            incomplete_context_data[interface] = {'missing_data': missing_data}
+                        if related:
+                            if incomplete_context_data.get(interface):
+                                incomplete_context_data[interface].update({'related': True})
+                            else:
+                                incomplete_context_data[interface] = {'related': True}
+                        else:
+                            incomplete_context_data[interface] = {'related': False}
+        return incomplete_context_data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbf0156108537f9caae35e193c346b0e4ee237b9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/utils.py
@@ -0,0 +1,2352 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charms.
+from collections import OrderedDict, namedtuple
+from functools import wraps
+
+import subprocess
+import json
+import os
+import sys
+import re
+import itertools
+import functools
+
+import six
+import traceback
+import uuid
+import yaml
+
+from charmhelpers import deprecate
+
+from charmhelpers.contrib.network import ip
+
+from charmhelpers.core import unitdata
+
+from charmhelpers.core.hookenv import (
+    WORKLOAD_STATES,
+    action_fail,
+    action_set,
+    config,
+    expected_peer_units,
+    expected_related_units,
+    log as juju_log,
+    charm_dir,
+    INFO,
+    ERROR,
+    metadata,
+    related_units,
+    relation_get,
+    relation_id,
+    relation_ids,
+    relation_set,
+    status_set,
+    hook_name,
+    application_version_set,
+    cached,
+    leader_set,
+    leader_get,
+    local_unit,
+)
+
+from charmhelpers.core.strutils import (
+    BasicStringComparator,
+    bool_from_string,
+)
+
+from charmhelpers.contrib.storage.linux.lvm import (
+    deactivate_lvm_volume_group,
+    is_lvm_physical_volume,
+    remove_lvm_physical_volume,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_ipv6_addr,
+    is_ipv6,
+    port_has_listener,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    mounts,
+    umount,
+    service_running,
+    service_pause,
+    service_resume,
+    service_stop,
+    service_start,
+    restart_on_change_helper,
+)
+from charmhelpers.fetch import (
+    apt_cache,
+    import_key as fetch_import_key,
+    add_source as fetch_add_source,
+    SourceConfigError,
+    GPGKeyError,
+    get_upstream_version,
+    filter_missing_packages,
+    ubuntu_apt_pkg as apt,
+)
+
+from charmhelpers.fetch.snap import (
+    snap_install,
+    snap_refresh,
+    valid_snap_channel,
+)
+
+from charmhelpers.contrib.storage.linux.utils import is_block_device, zap_disk
+from charmhelpers.contrib.storage.linux.loopback import ensure_loopback_device
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+from charmhelpers.contrib.openstack.policyd import (
+    policyd_status_message_prefix,
+    POLICYD_CONFIG_NAME,
+)
+
+from charmhelpers.contrib.openstack.ha.utils import (
+    expect_ha,
+)
+
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+
+DISTRO_PROPOSED = ('deb http://archive.ubuntu.com/ubuntu/ %s-proposed '
+                   'restricted main multiverse universe')
+
+OPENSTACK_RELEASES = (
+    'diablo',
+    'essex',
+    'folsom',
+    'grizzly',
+    'havana',
+    'icehouse',
+    'juno',
+    'kilo',
+    'liberty',
+    'mitaka',
+    'newton',
+    'ocata',
+    'pike',
+    'queens',
+    'rocky',
+    'stein',
+    'train',
+    'ussuri',
+)
+
+UBUNTU_OPENSTACK_RELEASE = OrderedDict([
+    ('oneiric', 'diablo'),
+    ('precise', 'essex'),
+    ('quantal', 'folsom'),
+    ('raring', 'grizzly'),
+    ('saucy', 'havana'),
+    ('trusty', 'icehouse'),
+    ('utopic', 'juno'),
+    ('vivid', 'kilo'),
+    ('wily', 'liberty'),
+    ('xenial', 'mitaka'),
+    ('yakkety', 'newton'),
+    ('zesty', 'ocata'),
+    ('artful', 'pike'),
+    ('bionic', 'queens'),
+    ('cosmic', 'rocky'),
+    ('disco', 'stein'),
+    ('eoan', 'train'),
+    ('focal', 'ussuri'),
+])
+
+
+OPENSTACK_CODENAMES = OrderedDict([
+    ('2011.2', 'diablo'),
+    ('2012.1', 'essex'),
+    ('2012.2', 'folsom'),
+    ('2013.1', 'grizzly'),
+    ('2013.2', 'havana'),
+    ('2014.1', 'icehouse'),
+    ('2014.2', 'juno'),
+    ('2015.1', 'kilo'),
+    ('2015.2', 'liberty'),
+    ('2016.1', 'mitaka'),
+    ('2016.2', 'newton'),
+    ('2017.1', 'ocata'),
+    ('2017.2', 'pike'),
+    ('2018.1', 'queens'),
+    ('2018.2', 'rocky'),
+    ('2019.1', 'stein'),
+    ('2019.2', 'train'),
+    ('2020.1', 'ussuri'),
+])
+
+# The ugly duckling - must list releases oldest to newest
+SWIFT_CODENAMES = OrderedDict([
+    ('diablo',
+        ['1.4.3']),
+    ('essex',
+        ['1.4.8']),
+    ('folsom',
+        ['1.7.4']),
+    ('grizzly',
+        ['1.7.6', '1.7.7', '1.8.0']),
+    ('havana',
+        ['1.9.0', '1.9.1', '1.10.0']),
+    ('icehouse',
+        ['1.11.0', '1.12.0', '1.13.0', '1.13.1']),
+    ('juno',
+        ['2.0.0', '2.1.0', '2.2.0']),
+    ('kilo',
+        ['2.2.1', '2.2.2']),
+    ('liberty',
+        ['2.3.0', '2.4.0', '2.5.0']),
+    ('mitaka',
+        ['2.5.0', '2.6.0', '2.7.0']),
+    ('newton',
+        ['2.8.0', '2.9.0', '2.10.0']),
+    ('ocata',
+        ['2.11.0', '2.12.0', '2.13.0']),
+    ('pike',
+        ['2.13.0', '2.15.0']),
+    ('queens',
+        ['2.16.0', '2.17.0']),
+    ('rocky',
+        ['2.18.0', '2.19.0']),
+    ('stein',
+        ['2.20.0', '2.21.0']),
+    ('train',
+        ['2.22.0', '2.23.0']),
+    ('ussuri',
+        ['2.24.0', '2.25.0']),
+])
+
+# >= Liberty version->codename mapping
+PACKAGE_CODENAMES = {
+    'nova-common': OrderedDict([
+        ('12', 'liberty'),
+        ('13', 'mitaka'),
+        ('14', 'newton'),
+        ('15', 'ocata'),
+        ('16', 'pike'),
+        ('17', 'queens'),
+        ('18', 'rocky'),
+        ('19', 'stein'),
+        ('20', 'train'),
+        ('21', 'ussuri'),
+    ]),
+    'neutron-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'cinder-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'keystone': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('17', 'ussuri'),
+    ]),
+    'horizon-common': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+    'ceilometer-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'heat-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'glance-common': OrderedDict([
+        ('11', 'liberty'),
+        ('12', 'mitaka'),
+        ('13', 'newton'),
+        ('14', 'ocata'),
+        ('15', 'pike'),
+        ('16', 'queens'),
+        ('17', 'rocky'),
+        ('18', 'stein'),
+        ('19', 'train'),
+        ('20', 'ussuri'),
+    ]),
+    'openstack-dashboard': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+}
+
+DEFAULT_LOOPBACK_SIZE = '5G'
+
+DB_SERIES_UPGRADING_KEY = 'cluster-series-upgrading'
+
+DB_MAINTENANCE_KEYS = [DB_SERIES_UPGRADING_KEY]
+
+
+class CompareOpenStackReleases(BasicStringComparator):
+    """Provide comparisons of OpenStack releases.
+
+    Use in the form of
+
+    if CompareOpenStackReleases(release) > 'mitaka':
+        # do something with mitaka
+    """
+    _list = OPENSTACK_RELEASES
+
+
+def error_out(msg):
+    juju_log("FATAL ERROR: %s" % msg, level='ERROR')
+    sys.exit(1)
+
+
+def get_installed_semantic_versioned_packages():
+    '''Get a list of installed packages which have OpenStack semantic versioning
+
+    :returns List of installed packages
+    :rtype: [pkg1, pkg2, ...]
+    '''
+    return filter_missing_packages(PACKAGE_CODENAMES.keys())
+
+
+def get_os_codename_install_source(src):
+    '''Derive OpenStack release codename from a given installation source.'''
+    ubuntu_rel = lsb_release()['DISTRIB_CODENAME']
+    rel = ''
+    if src is None:
+        return rel
+    if src in ['distro', 'distro-proposed', 'proposed']:
+        try:
+            rel = UBUNTU_OPENSTACK_RELEASE[ubuntu_rel]
+        except KeyError:
+            e = 'Could not derive openstack release for '\
+                'this Ubuntu release: %s' % ubuntu_rel
+            error_out(e)
+        return rel
+
+    if src.startswith('cloud:'):
+        ca_rel = src.split(':')[1]
+        ca_rel = ca_rel.split('-')[1].split('/')[0]
+        return ca_rel
+
+    # Best guess match based on deb string provided
+    if (src.startswith('deb') or
+            src.startswith('ppa') or
+            src.startswith('snap')):
+        for v in OPENSTACK_CODENAMES.values():
+            if v in src:
+                return v
+
+
+def get_os_version_install_source(src):
+    codename = get_os_codename_install_source(src)
+    return get_os_version_codename(codename)
+
+
+def get_os_codename_version(vers):
+    '''Determine OpenStack codename from version number.'''
+    try:
+        return OPENSTACK_CODENAMES[vers]
+    except KeyError:
+        e = 'Could not determine OpenStack codename for version %s' % vers
+        error_out(e)
+
+
+def get_os_version_codename(codename, version_map=OPENSTACK_CODENAMES):
+    '''Determine OpenStack version number from codename.'''
+    for k, v in six.iteritems(version_map):
+        if v == codename:
+            return k
+    e = 'Could not derive OpenStack version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_os_version_codename_swift(codename):
+    '''Determine OpenStack version number of swift from codename.'''
+    for k, v in six.iteritems(SWIFT_CODENAMES):
+        if k == codename:
+            return v[-1]
+    e = 'Could not derive swift version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_swift_codename(version):
+    '''Determine OpenStack codename that corresponds to swift version.'''
+    codenames = [k for k, v in six.iteritems(SWIFT_CODENAMES) if version in v]
+
+    if len(codenames) > 1:
+        # If more than one release codename contains this version we determine
+        # the actual codename based on the highest available install source.
+        for codename in reversed(codenames):
+            releases = UBUNTU_OPENSTACK_RELEASE
+            release = [k for k, v in six.iteritems(releases) if codename in v]
+            ret = subprocess.check_output(['apt-cache', 'policy', 'swift'])
+            if six.PY3:
+                ret = ret.decode('UTF-8')
+            if codename in ret or release[0] in ret:
+                return codename
+    elif len(codenames) == 1:
+        return codenames[0]
+
+    # NOTE: fallback - attempt to match with just major.minor version
+    match = re.match(r'^(\d+)\.(\d+)', version)
+    if match:
+        major_minor_version = match.group(0)
+        for codename, versions in six.iteritems(SWIFT_CODENAMES):
+            for release_version in versions:
+                if release_version.startswith(major_minor_version):
+                    return codename
+
+    return None
+
+
+def get_os_codename_package(package, fatal=True):
+    '''Derive OpenStack release codename from an installed package.'''
+
+    if snap_install_requested():
+        cmd = ['snap', 'list', package]
+        try:
+            out = subprocess.check_output(cmd)
+            if six.PY3:
+                out = out.decode('UTF-8')
+        except subprocess.CalledProcessError:
+            return None
+        lines = out.split('\n')
+        for line in lines:
+            if package in line:
+                # Second item in list is Version
+                return line.split()[1]
+
+    cache = apt_cache()
+
+    try:
+        pkg = cache[package]
+    except Exception:
+        if not fatal:
+            return None
+        # the package is unknown to the current apt cache.
+        e = 'Could not determine version of package with no installation '\
+            'candidate: %s' % package
+        error_out(e)
+
+    if not pkg.current_ver:
+        if not fatal:
+            return None
+        # package is known, but no version is currently installed.
+        e = 'Could not determine version of uninstalled package: %s' % package
+        error_out(e)
+
+    vers = apt.upstream_version(pkg.current_ver.ver_str)
+    if 'swift' in pkg.name:
+        # Fully x.y.z match for swift versions
+        match = re.match(r'^(\d+)\.(\d+)\.(\d+)', vers)
+    else:
+        # x.y match only for 20XX.X
+        # and ignore patch level for other packages
+        match = re.match(r'^(\d+)\.(\d+)', vers)
+
+    if match:
+        vers = match.group(0)
+
+    # Generate a major version number for newer semantic
+    # versions of openstack projects
+    major_vers = vers.split('.')[0]
+    # >= Liberty independent project versions
+    if (package in PACKAGE_CODENAMES and
+            major_vers in PACKAGE_CODENAMES[package]):
+        return PACKAGE_CODENAMES[package][major_vers]
+    else:
+        # < Liberty co-ordinated project versions
+        try:
+            if 'swift' in pkg.name:
+                return get_swift_codename(vers)
+            else:
+                return OPENSTACK_CODENAMES[vers]
+        except KeyError:
+            if not fatal:
+                return None
+            e = 'Could not determine OpenStack codename for version %s' % vers
+            error_out(e)
+
+
+def get_os_version_package(pkg, fatal=True):
+    '''Derive OpenStack version number from an installed package.'''
+    codename = get_os_codename_package(pkg, fatal=fatal)
+
+    if not codename:
+        return None
+
+    if 'swift' in pkg:
+        vers_map = SWIFT_CODENAMES
+        for cname, version in six.iteritems(vers_map):
+            if cname == codename:
+                return version[-1]
+    else:
+        vers_map = OPENSTACK_CODENAMES
+        for version, cname in six.iteritems(vers_map):
+            if cname == codename:
+                return version
+    # e = "Could not determine OpenStack version for package: %s" % pkg
+    # error_out(e)
+
+
+# Module local cache variable for the os_release.
+_os_rel = None
+
+
+def reset_os_release():
+    '''Unset the cached os_release version'''
+    global _os_rel
+    _os_rel = None
+
+
+def os_release(package, base=None, reset_cache=False, source_key=None):
+    """Returns OpenStack release codename from a cached global.
+
+    If reset_cache then unset the cached os_release version and return the
+    freshly determined version.
+
+    If the codename can not be determined from either an installed package or
+    the installation source, the earliest release supported by the charm should
+    be returned.
+
+    :param package: Name of package to determine release from
+    :type package: str
+    :param base: Fallback codename if endavours to determine from package fail
+    :type base: Optional[str]
+    :param reset_cache: Reset any cached codename value
+    :type reset_cache: bool
+    :param source_key: Name of source configuration option
+                       (default: 'openstack-origin')
+    :type source_key: Optional[str]
+    :returns: OpenStack release codename
+    :rtype: str
+    """
+    source_key = source_key or 'openstack-origin'
+    if not base:
+        base = UBUNTU_OPENSTACK_RELEASE[lsb_release()['DISTRIB_CODENAME']]
+    global _os_rel
+    if reset_cache:
+        reset_os_release()
+    if _os_rel:
+        return _os_rel
+    _os_rel = (
+        get_os_codename_package(package, fatal=False) or
+        get_os_codename_install_source(config(source_key)) or
+        base)
+    return _os_rel
+
+
+@deprecate("moved to charmhelpers.fetch.import_key()", "2017-07", log=juju_log)
+def import_key(keyid):
+    """Import a key, either ASCII armored, or a GPG key id.
+
+    @param keyid: the key in ASCII armor format, or a GPG key id.
+    @raises SystemExit() via sys.exit() on failure.
+    """
+    try:
+        return fetch_import_key(keyid)
+    except GPGKeyError as e:
+        error_out("Could not import key: {}".format(str(e)))
+
+
+def get_source_and_pgp_key(source_and_key):
+    """Look for a pgp key ID or ascii-armor key in the given input.
+
+    :param source_and_key: Sting, "source_spec|keyid" where '|keyid' is
+        optional.
+    :returns (source_spec, key_id OR None) as a tuple.  Returns None for key_id
+        if there was no '|' in the source_and_key string.
+    """
+    try:
+        source, key = source_and_key.split('|', 2)
+        return source, key or None
+    except ValueError:
+        return source_and_key, None
+
+
+@deprecate("use charmhelpers.fetch.add_source() instead.",
+           "2017-07", log=juju_log)
+def configure_installation_source(source_plus_key):
+    """Configure an installation source.
+
+    The functionality is provided by charmhelpers.fetch.add_source()
+    The difference between the two functions is that add_source() signature
+    requires the key to be passed directly, whereas this function passes an
+    optional key by appending '|<key>' to the end of the source specificiation
+    'source'.
+
+    Another difference from add_source() is that the function calls sys.exit(1)
+    if the configuration fails, whereas add_source() raises
+    SourceConfigurationError().  Another difference, is that add_source()
+    silently fails (with a juju_log command) if there is no matching source to
+    configure, whereas this function fails with a sys.exit(1)
+
+    :param source: String_plus_key -- see above for details.
+
+    Note that the behaviour on error is to log the error to the juju log and
+    then call sys.exit(1).
+    """
+    if source_plus_key.startswith('snap'):
+        # Do nothing for snap installs
+        return
+    # extract the key if there is one, denoted by a '|' in the rel
+    source, key = get_source_and_pgp_key(source_plus_key)
+
+    # handle the ordinary sources via add_source
+    try:
+        fetch_add_source(source, key, fail_invalid=True)
+    except SourceConfigError as se:
+        error_out(str(se))
+
+
+def config_value_changed(option):
+    """
+    Determine if config value changed since last call to this function.
+    """
+    hook_data = unitdata.HookData()
+    with hook_data():
+        db = unitdata.kv()
+        current = config(option)
+        saved = db.get(option)
+        db.set(option, current)
+        if saved is None:
+            return False
+        return current != saved
+
+
+def get_endpoint_key(service_name, relation_id, unit_name):
+    """Return the key used to refer to an ep changed notification from a unit.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param relation_id: The id of the relation the unit is on.
+    :type relation_id: str
+    :param unit_name: The name of the unit publishing the notification.
+    :type unit_name: str
+    :returns: The key used to refer to an ep changed notification from a unit
+    :rtype: str
+    """
+    return '{}-{}-{}'.format(
+        service_name,
+        relation_id.replace(':', '_'),
+        unit_name.replace('/', '_'))
+
+
+def get_endpoint_notifications(service_names, rel_name='identity-service'):
+    """Return all notifications for the given services.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: A dict containing the source of the notification and its nonce.
+    :rtype: Dict[str, str]
+    """
+    notifications = {}
+    for rid in relation_ids(rel_name):
+        for unit in related_units(relid=rid):
+            ep_changed_json = relation_get(
+                rid=rid,
+                unit=unit,
+                attribute='ep_changed')
+            if ep_changed_json:
+                ep_changed = json.loads(ep_changed_json)
+                for service in service_names:
+                    if ep_changed.get(service):
+                        key = get_endpoint_key(service, rid, unit)
+                        notifications[key] = ep_changed[service]
+    return notifications
+
+
+def endpoint_changed(service_name, rel_name='identity-service'):
+    """Whether a new notification has been recieved for an endpoint.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: Whether endpoint has changed
+    :rtype: bool
+    """
+    changed = False
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            [service_name],
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            if db.get(key) != nonce:
+                juju_log(('New endpoint change notification found: '
+                          '{}={}').format(key, nonce),
+                         'INFO')
+                changed = True
+                break
+    return changed
+
+
+def save_endpoint_changed_triggers(service_names, rel_name='identity-service'):
+    """Save the enpoint triggers in  db so it can be tracked if they changed.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    """
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            service_names,
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            db.set(key, nonce)
+
+
+def save_script_rc(script_path="scripts/scriptrc", **env_vars):
+    """
+    Write an rc file in the charm-delivered directory containing
+    exported environment variables provided by env_vars. Any charm scripts run
+    outside the juju hook environment can source this scriptrc to obtain
+    updated config information necessary to perform health checks or
+    service changes.
+    """
+    juju_rc_path = "%s/%s" % (charm_dir(), script_path)
+    if not os.path.exists(os.path.dirname(juju_rc_path)):
+        os.mkdir(os.path.dirname(juju_rc_path))
+    with open(juju_rc_path, 'wt') as rc_script:
+        rc_script.write(
+            "#!/bin/bash\n")
+        [rc_script.write('export %s=%s\n' % (u, p))
+         for u, p in six.iteritems(env_vars) if u != "script_path"]
+
+
+def openstack_upgrade_available(package):
+    """
+    Determines if an OpenStack upgrade is available from installation
+    source, based on version of installed package.
+
+    :param package: str: Name of installed package.
+
+    :returns: bool:    : Returns True if configured installation source offers
+                         a newer version of package.
+    """
+
+    src = config('openstack-origin')
+    cur_vers = get_os_version_package(package)
+    if not cur_vers:
+        # The package has not been installed yet do not attempt upgrade
+        return False
+    if "swift" in package:
+        codename = get_os_codename_install_source(src)
+        avail_vers = get_os_version_codename_swift(codename)
+    else:
+        try:
+            avail_vers = get_os_version_install_source(src)
+        except Exception:
+            avail_vers = cur_vers
+    apt.init()
+    return apt.version_compare(avail_vers, cur_vers) >= 1
+
+
+def ensure_block_device(block_device):
+    '''
+    Confirm block_device, create as loopback if necessary.
+
+    :param block_device: str: Full path of block device to ensure.
+
+    :returns: str: Full path of ensured block device.
+    '''
+    _none = ['None', 'none', None]
+    if (block_device in _none):
+        error_out('prepare_storage(): Missing required input: block_device=%s.'
+                  % block_device)
+
+    if block_device.startswith('/dev/'):
+        bdev = block_device
+    elif block_device.startswith('/'):
+        _bd = block_device.split('|')
+        if len(_bd) == 2:
+            bdev, size = _bd
+        else:
+            bdev = block_device
+            size = DEFAULT_LOOPBACK_SIZE
+        bdev = ensure_loopback_device(bdev, size)
+    else:
+        bdev = '/dev/%s' % block_device
+
+    if not is_block_device(bdev):
+        error_out('Failed to locate valid block device at %s' % bdev)
+
+    return bdev
+
+
+def clean_storage(block_device):
+    '''
+    Ensures a block device is clean.  That is:
+        - unmounted
+        - any lvm volume groups are deactivated
+        - any lvm physical device signatures removed
+        - partition table wiped
+
+    :param block_device: str: Full path to block device to clean.
+    '''
+    for mp, d in mounts():
+        if d == block_device:
+            juju_log('clean_storage(): %s is mounted @ %s, unmounting.' %
+                     (d, mp), level=INFO)
+            umount(mp, persist=True)
+
+    if is_lvm_physical_volume(block_device):
+        deactivate_lvm_volume_group(block_device)
+        remove_lvm_physical_volume(block_device)
+    else:
+        zap_disk(block_device)
+
+
+is_ip = ip.is_ip
+ns_query = ip.ns_query
+get_host_ip = ip.get_host_ip
+get_hostname = ip.get_hostname
+
+
+def get_matchmaker_map(mm_file='/etc/oslo/matchmaker_ring.json'):
+    mm_map = {}
+    if os.path.isfile(mm_file):
+        with open(mm_file, 'r') as f:
+            mm_map = json.load(f)
+    return mm_map
+
+
+def sync_db_with_multi_ipv6_addresses(database, database_user,
+                                      relation_prefix=None):
+    hosts = get_ipv6_addr(dynamic_only=False)
+
+    if config('vip'):
+        vips = config('vip').split()
+        for vip in vips:
+            if vip and is_ipv6(vip):
+                hosts.append(vip)
+
+    kwargs = {'database': database,
+              'username': database_user,
+              'hostname': json.dumps(hosts)}
+
+    if relation_prefix:
+        for key in list(kwargs.keys()):
+            kwargs["%s_%s" % (relation_prefix, key)] = kwargs[key]
+            del kwargs[key]
+
+    for rid in relation_ids('shared-db'):
+        relation_set(relation_id=rid, **kwargs)
+
+
+def os_requires_version(ostack_release, pkg):
+    """
+    Decorator for hook to specify minimum supported release
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args):
+            if os_release(pkg) < ostack_release:
+                raise Exception("This hook is not supported on releases"
+                                " before %s" % ostack_release)
+            f(*args)
+        return wrapped_f
+    return wrap
+
+
+def os_workload_status(configs, required_interfaces, charm_func=None):
+    """
+    Decorator to set workload status based on complete contexts
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args, **kwargs):
+            # Run the original function first
+            f(*args, **kwargs)
+            # Set workload status now that contexts have been
+            # acted on
+            set_os_workload_status(configs, required_interfaces, charm_func)
+        return wrapped_f
+    return wrap
+
+
+def set_os_workload_status(configs, required_interfaces, charm_func=None,
+                           services=None, ports=None):
+    """Set the state of the workload status for the charm.
+
+    This calls _determine_os_workload_status() to get the new state, message
+    and sets the status using status_set()
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _determine_os_workload_status(
+        configs, required_interfaces, charm_func, services, ports)
+    status_set(state, message)
+
+
+def _determine_os_workload_status(
+        configs, required_interfaces, charm_func=None,
+        services=None, ports=None):
+    """Determine the state of the workload status for the charm.
+
+    This function returns the new workload status for the charm based
+    on the state of the interfaces, the paused state and whether the
+    services are actually running and any specified ports are open.
+
+    This checks:
+
+     1. if the unit should be paused, that it is actually paused.  If so the
+        state is 'maintenance' + message, else 'broken'.
+     2. that the interfaces/relations are complete.  If they are not then
+        it sets the state to either 'broken' or 'waiting' and an appropriate
+        message.
+     3. If all the relation data is set, then it checks that the actual
+        services really are running.  If not it sets the state to 'broken'.
+
+    If everything is okay then the state returns 'active'.
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _ows_check_if_paused(services, ports)
+
+    if state is None:
+        state, message = _ows_check_generic_interfaces(
+            configs, required_interfaces)
+
+    if state != 'maintenance' and charm_func:
+        # _ows_check_charm_func() may modify the state, message
+        state, message = _ows_check_charm_func(
+            state, message, lambda: charm_func(configs))
+
+    if state is None:
+        state, message = _ows_check_services_running(services, ports)
+
+    if state is None:
+        state = 'active'
+        message = "Unit is ready"
+        juju_log(message, 'INFO')
+
+    try:
+        if config(POLICYD_CONFIG_NAME):
+            message = "{} {}".format(policyd_status_message_prefix(), message)
+    except Exception:
+        pass
+
+    return state, message
+
+
+def _ows_check_if_paused(services=None, ports=None):
+    """Check if the unit is supposed to be paused, and if so check that the
+    services/ports (if passed) are actually stopped/not being listened to.
+
+    If the unit isn't supposed to be paused, just return None, None
+
+    If the unit is performing a series upgrade, return a message indicating
+    this.
+
+    @param services: OPTIONAL services spec or list of service names.
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message or None, None
+    """
+    if is_unit_upgrading_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "blocked"
+            message = ("Ready for do-release-upgrade and reboot. "
+                       "Set complete when finished.")
+        return state, message
+
+    if is_unit_paused_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "maintenance"
+            message = "Paused. Use 'resume' action to resume normal service."
+        return state, message
+    return None, None
+
+
+def _ows_check_generic_interfaces(configs, required_interfaces):
+    """Check the complete contexts to determine the workload status.
+
+     - Checks for missing or incomplete contexts
+     - juju log details of missing required data.
+     - determines the correct workload status
+     - creates an appropriate message for status_set(...)
+
+    if there are no problems then the function returns None, None
+
+    @param configs: a templating.OSConfigRenderer() object
+    @params required_interfaces: {generic_interface: [specific_interface], }
+    @returns state, message or None, None
+    """
+    incomplete_rel_data = incomplete_relation_data(configs,
+                                                   required_interfaces)
+    state = None
+    message = None
+    missing_relations = set()
+    incomplete_relations = set()
+
+    for generic_interface, relations_states in incomplete_rel_data.items():
+        related_interface = None
+        missing_data = {}
+        # Related or not?
+        for interface, relation_state in relations_states.items():
+            if relation_state.get('related'):
+                related_interface = interface
+                missing_data = relation_state.get('missing_data')
+                break
+        # No relation ID for the generic_interface?
+        if not related_interface:
+            juju_log("{} relation is missing and must be related for "
+                     "functionality. ".format(generic_interface), 'WARN')
+            state = 'blocked'
+            missing_relations.add(generic_interface)
+        else:
+            # Relation ID eists but no related unit
+            if not missing_data:
+                # Edge case - relation ID exists but departings
+                _hook_name = hook_name()
+                if (('departed' in _hook_name or 'broken' in _hook_name) and
+                        related_interface in _hook_name):
+                    state = 'blocked'
+                    missing_relations.add(generic_interface)
+                    juju_log("{} relation's interface, {}, "
+                             "relationship is departed or broken "
+                             "and is required for functionality."
+                             "".format(generic_interface, related_interface),
+                             "WARN")
+                # Normal case relation ID exists but no related unit
+                # (joining)
+                else:
+                    juju_log("{} relations's interface, {}, is related but has"
+                             " no units in the relation."
+                             "".format(generic_interface, related_interface),
+                             "INFO")
+            # Related unit exists and data missing on the relation
+            else:
+                juju_log("{} relation's interface, {}, is related awaiting "
+                         "the following data from the relationship: {}. "
+                         "".format(generic_interface, related_interface,
+                                   ", ".join(missing_data)), "INFO")
+            if state != 'blocked':
+                state = 'waiting'
+            if generic_interface not in missing_relations:
+                incomplete_relations.add(generic_interface)
+
+    if missing_relations:
+        message = "Missing relations: {}".format(", ".join(missing_relations))
+        if incomplete_relations:
+            message += "; incomplete relations: {}" \
+                       "".format(", ".join(incomplete_relations))
+        state = 'blocked'
+    elif incomplete_relations:
+        message = "Incomplete relations: {}" \
+                  "".format(", ".join(incomplete_relations))
+        state = 'waiting'
+
+    return state, message
+
+
+def _ows_check_charm_func(state, message, charm_func_with_configs):
+    """Run a custom check function for the charm to see if it wants to
+    change the state.  This is only run if not in 'maintenance' and
+    tests to see if the new state is more important that the previous
+    one determined by the interfaces/relations check.
+
+    @param state: the previously determined state so far.
+    @param message: the user orientated message so far.
+    @param charm_func: a callable function that returns state, message
+    @returns state, message strings.
+    """
+    if charm_func_with_configs:
+        charm_state, charm_message = charm_func_with_configs()
+        if (charm_state != 'active' and
+                charm_state != 'unknown' and
+                charm_state is not None):
+            state = workload_state_compare(state, charm_state)
+            if message:
+                charm_message = charm_message.replace("Incomplete relations: ",
+                                                      "")
+                message = "{}, {}".format(message, charm_message)
+            else:
+                message = charm_message
+    return state, message
+
+
+def _ows_check_services_running(services, ports):
+    """Check that the services that should be running are actually running
+    and that any ports specified are being listened to.
+
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: list of ports
+    @returns state, message: strings or None, None
+    """
+    messages = []
+    state = None
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, running = _check_running_services(services)
+        if not all(running):
+            messages.append(
+                "Services not running that should be: {}"
+                .format(", ".join(_filter_tuples(services_running, False))))
+            state = 'blocked'
+        # also verify that the ports that should be open are open
+        # NB, that ServiceManager objects only OPTIONALLY have ports
+        map_not_open, ports_open = (
+            _check_listening_on_services_ports(services))
+        if not all(ports_open):
+            # find which service has missing ports. They are in service
+            # order which makes it a bit easier.
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in map_not_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "Services with ports not open that should be: {}"
+                .format(message))
+            state = 'blocked'
+
+    if ports is not None:
+        # and we can also check ports which we don't know the service for
+        ports_open, ports_open_bools = _check_listening_on_ports_list(ports)
+        if not all(ports_open_bools):
+            messages.append(
+                "Ports which should be open, but are not: {}"
+                .format(", ".join([str(p) for p, v in ports_open
+                                   if not v])))
+            state = 'blocked'
+
+    if state is not None:
+        message = "; ".join(messages)
+        return state, message
+
+    return None, None
+
+
+def _extract_services_list_helper(services):
+    """Extract a OrderedDict of {service: [ports]} of the supplied services
+    for use by the other functions.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param services: see above
+    @returns OrderedDict(service: [ports], ...)
+    """
+    if services is None:
+        return {}
+    if isinstance(services, dict):
+        services = services.values()
+    # either extract the list of services from the dictionary, or if
+    # it is a simple string, use that. i.e. works with mixed lists.
+    _s = OrderedDict()
+    for s in services:
+        if isinstance(s, dict) and 'service' in s:
+            _s[s['service']] = s.get('ports', [])
+        if isinstance(s, str):
+            _s[s] = []
+    return _s
+
+
+def _check_running_services(services):
+    """Check that the services dict provided is actually running and provide
+    a list of (service, boolean) tuples for each service.
+
+    Returns both a zipped list of (service, boolean) and a list of booleans
+    in the same order as the services.
+
+    @param services: OrderedDict of strings: [ports], one for each service to
+                     check.
+    @returns [(service, boolean), ...], : results for checks
+             [boolean]                  : just the result of the service checks
+    """
+    services_running = [service_running(s) for s in services]
+    return list(zip(services, services_running)), services_running
+
+
+def _check_listening_on_services_ports(services, test=False):
+    """Check that the unit is actually listening (has the port open) on the
+    ports that the service specifies are open. If test is True then the
+    function returns the services with ports that are open rather than
+    closed.
+
+    Returns an OrderedDict of service: ports and a list of booleans
+
+    @param services: OrderedDict(service: [port, ...], ...)
+    @param test: default=False, if False, test for closed, otherwise open.
+    @returns OrderedDict(service: [port-not-open, ...]...), [boolean]
+    """
+    test = not(not(test))  # ensure test is True or False
+    all_ports = list(itertools.chain(*services.values()))
+    ports_states = [port_has_listener('0.0.0.0', p) for p in all_ports]
+    map_ports = OrderedDict()
+    matched_ports = [p for p, opened in zip(all_ports, ports_states)
+                     if opened == test]  # essentially opened xor test
+    for service, ports in services.items():
+        set_ports = set(ports).intersection(matched_ports)
+        if set_ports:
+            map_ports[service] = set_ports
+    return map_ports, ports_states
+
+
+def _check_listening_on_ports_list(ports):
+    """Check that the ports list given are being listened to
+
+    Returns a list of ports being listened to and a list of the
+    booleans.
+
+    @param ports: LIST or port numbers.
+    @returns [(port_num, boolean), ...], [boolean]
+    """
+    ports_open = [port_has_listener('0.0.0.0', p) for p in ports]
+    return zip(ports, ports_open), ports_open
+
+
+def _filter_tuples(services_states, state):
+    """Return a simple list from a list of tuples according to the condition
+
+    @param services_states: LIST of (string, boolean): service and running
+           state.
+    @param state: Boolean to match the tuple against.
+    @returns [LIST of strings] that matched the tuple RHS.
+    """
+    return [s for s, b in services_states if b == state]
+
+
+def workload_state_compare(current_workload_state, workload_state):
+    """ Return highest priority of two states"""
+    hierarchy = {'unknown': -1,
+                 'active': 0,
+                 'maintenance': 1,
+                 'waiting': 2,
+                 'blocked': 3,
+                 }
+
+    if hierarchy.get(workload_state) is None:
+        workload_state = 'unknown'
+    if hierarchy.get(current_workload_state) is None:
+        current_workload_state = 'unknown'
+
+    # Set workload_state based on hierarchy of statuses
+    if hierarchy.get(current_workload_state) > hierarchy.get(workload_state):
+        return current_workload_state
+    else:
+        return workload_state
+
+
+def incomplete_relation_data(configs, required_interfaces):
+    """Check complete contexts against required_interfaces
+    Return dictionary of incomplete relation data.
+
+    configs is an OSConfigRenderer object with configs registered
+
+    required_interfaces is a dictionary of required general interfaces
+    with dictionary values of possible specific interfaces.
+    Example:
+    required_interfaces = {'database': ['shared-db', 'pgsql-db']}
+
+    The interface is said to be satisfied if anyone of the interfaces in the
+    list has a complete context.
+
+    Return dictionary of incomplete or missing required contexts with relation
+    status of interfaces and any missing data points. Example:
+        {'message':
+             {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+              'zeromq-configuration': {'related': False}},
+         'identity':
+             {'identity-service': {'related': False}},
+         'database':
+             {'pgsql-db': {'related': False},
+              'shared-db': {'related': True}}}
+    """
+    complete_ctxts = configs.complete_contexts()
+    incomplete_relations = [
+        svc_type
+        for svc_type, interfaces in required_interfaces.items()
+        if not set(interfaces).intersection(complete_ctxts)]
+    return {
+        i: configs.get_incomplete_context_data(required_interfaces[i])
+        for i in incomplete_relations}
+
+
+def do_action_openstack_upgrade(package, upgrade_callback, configs):
+    """Perform action-managed OpenStack upgrade.
+
+    Upgrades packages to the configured openstack-origin version and sets
+    the corresponding action status as a result.
+
+    If the charm was installed from source we cannot upgrade it.
+    For backwards compatibility a config flag (action-managed-upgrade) must
+    be set for this code to run, otherwise a full service level upgrade will
+    fire on config-changed.
+
+    @param package: package name for determining if upgrade available
+    @param upgrade_callback: function callback to charm's upgrade function
+    @param configs: templating object derived from OSConfigRenderer class
+
+    @return: True if upgrade successful; False if upgrade failed or skipped
+    """
+    ret = False
+
+    if openstack_upgrade_available(package):
+        if config('action-managed-upgrade'):
+            juju_log('Upgrading OpenStack release')
+
+            try:
+                upgrade_callback(configs=configs)
+                action_set({'outcome': 'success, upgrade completed.'})
+                ret = True
+            except Exception:
+                action_set({'outcome': 'upgrade failed, see traceback.'})
+                action_set({'traceback': traceback.format_exc()})
+                action_fail('do_openstack_upgrade resulted in an '
+                            'unexpected error')
+        else:
+            action_set({'outcome': 'action-managed-upgrade config is '
+                                   'False, skipped upgrade.'})
+    else:
+        action_set({'outcome': 'no upgrade available.'})
+
+    return ret
+
+
+def remote_restart(rel_name, remote_service=None):
+    trigger = {
+        'restart-trigger': str(uuid.uuid4()),
+    }
+    if remote_service:
+        trigger['remote-service'] = remote_service
+    for rid in relation_ids(rel_name):
+        # This subordinate can be related to two seperate services using
+        # different subordinate relations so only issue the restart if
+        # the principle is conencted down the relation we think it is
+        if related_units(relid=rid):
+            relation_set(relation_id=rid,
+                         relation_settings=trigger,
+                         )
+
+
+def check_actually_paused(services=None, ports=None):
+    """Check that services listed in the services object and ports
+    are actually closed (not listened to), to verify that the unit is
+    properly paused.
+
+    @param services: See _extract_services_list_helper
+    @returns status, : string for status (None if okay)
+             message : string for problem for status_set
+    """
+    state = None
+    message = None
+    messages = []
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, services_states = _check_running_services(services)
+        if any(services_states):
+            # there shouldn't be any running so this is a problem
+            messages.append("these services running: {}"
+                            .format(", ".join(
+                                _filter_tuples(services_running, True))))
+            state = "blocked"
+        ports_open, ports_open_bools = (
+            _check_listening_on_services_ports(services, True))
+        if any(ports_open_bools):
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in ports_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "these service:ports are open: {}".format(message))
+            state = 'blocked'
+    if ports is not None:
+        ports_open, bools = _check_listening_on_ports_list(ports)
+        if any(bools):
+            messages.append(
+                "these ports which should be closed, but are open: {}"
+                .format(", ".join([str(p) for p, v in ports_open if v])))
+            state = 'blocked'
+    if messages:
+        message = ("Services should be paused but {}"
+                   .format(", ".join(messages)))
+    return state, message
+
+
+def set_unit_paused():
+    """Set the unit to a paused state in the local kv() store.
+    This does NOT actually pause the unit
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', True)
+
+
+def clear_unit_paused():
+    """Clear the unit from a paused state in the local kv() store
+    This does NOT actually restart any services - it only clears the
+    local state.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', False)
+
+
+def is_unit_paused_set():
+    """Return the state of the kv().get('unit-paused').
+    This does NOT verify that the unit really is paused.
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-paused')))
+    except Exception:
+        return False
+
+
+def manage_payload_services(action, services=None, charm_func=None):
+    """Run an action against all services.
+
+    An optional charm_func() can be called. It should raise an Exception to
+    indicate that the function failed. If it was succesfull it should return
+    None or an optional message.
+
+    The signature for charm_func is:
+    charm_func() -> message: str
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    :param action: Action to run: pause, resume, start or stop.
+    :type action: str
+    :param services: See above
+    :type services: See above
+    :param charm_func: function to run for custom charm pausing.
+    :type charm_func: f()
+    :returns: Status boolean and list of messages
+    :rtype: (bool, [])
+    :raises: RuntimeError
+    """
+    actions = {
+        'pause': service_pause,
+        'resume': service_resume,
+        'start': service_start,
+        'stop': service_stop}
+    action = action.lower()
+    if action not in actions.keys():
+        raise RuntimeError(
+            "action: {} must be one of: {}".format(action,
+                                                   ', '.join(actions.keys())))
+    services = _extract_services_list_helper(services)
+    messages = []
+    success = True
+    if services:
+        for service in services.keys():
+            rc = actions[action](service)
+            if not rc:
+                success = False
+                messages.append("{} didn't {} cleanly.".format(service,
+                                                               action))
+    if charm_func:
+        try:
+            message = charm_func()
+            if message:
+                messages.append(message)
+        except Exception as e:
+            success = False
+            messages.append(str(e))
+    return success, messages
+
+
+def pause_unit(assess_status_func, services=None, ports=None,
+               charm_func=None):
+    """Pause a unit by stopping the services and setting 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have stopped and ports are no longer
+    being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None, None to indicate that the unit
+    didn't pause cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm pausing.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'pause',
+        services=services,
+        charm_func=charm_func)
+    set_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages and not is_unit_upgrading_set():
+        raise Exception("Couldn't pause: {}".format("; ".join(messages)))
+
+
+def resume_unit(assess_status_func, services=None, ports=None,
+                charm_func=None):
+    """Resume a unit by starting the services and clearning 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have started and ports are being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None to indicate that the unit
+    didn't resume cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are started, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm resuming.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'resume',
+        services=services,
+        charm_func=charm_func)
+    clear_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages:
+        raise Exception("Couldn't resume: {}".format("; ".join(messages)))
+
+
+def make_assess_status_func(*args, **kwargs):
+    """Creates an assess_status_func() suitable for handing to pause_unit()
+    and resume_unit().
+
+    This uses the _determine_os_workload_status(...) function to determine
+    what the workload_status should be for the unit.  If the unit is
+    not in maintenance or active states, then the message is returned to
+    the caller.  This is so an action that doesn't result in either a
+    complete pause or complete resume can signal failure with an action_fail()
+    """
+    def _assess_status_func():
+        state, message = _determine_os_workload_status(*args, **kwargs)
+        status_set(state, message)
+        if state not in ['maintenance', 'active']:
+            return message
+        return None
+
+    return _assess_status_func
+
+
+def pausable_restart_on_change(restart_map, stopstart=False,
+                               restart_functions=None):
+    """A restart_on_change decorator that checks to see if the unit is
+    paused. If it is paused then the decorated function doesn't fire.
+
+    This is provided as a helper, as the @restart_on_change(...) decorator
+    is in core.host, yet the openstack specific helpers are in this file
+    (contrib.openstack.utils).  Thus, this needs to be an optional feature
+    for openstack charms (or charms that wish to use the openstack
+    pause/resume type features).
+
+    It is used as follows:
+
+        from contrib.openstack.utils import (
+            pausable_restart_on_change as restart_on_change)
+
+        @restart_on_change(restart_map, stopstart=<boolean>)
+        def some_hook(...):
+            pass
+
+    see core.utils.restart_on_change() for more details.
+
+    Note restart_map can be a callable, in which case, restart_map is only
+    evaluated at runtime.  This means that it is lazy and the underlying
+    function won't be called if the decorated function is never called.  Note,
+    retains backwards compatibility for passing a non-callable dictionary.
+
+    @param f: the function to decorate
+    @param restart_map: (optionally callable, which then returns the
+        restart_map) the restart map {conf_file: [services]}
+    @param stopstart: DEFAULT false; whether to stop, start or just restart
+    @returns decorator to use a restart_on_change with pausability
+    """
+    def wrap(f):
+        # py27 compatible nonlocal variable.  When py3 only, replace with
+        # nonlocal keyword
+        __restart_map_cache = {'cache': None}
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            if is_unit_paused_set():
+                return f(*args, **kwargs)
+            if __restart_map_cache['cache'] is None:
+                __restart_map_cache['cache'] = restart_map() \
+                    if callable(restart_map) else restart_map
+            # otherwise, normal restart_on_change functionality
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), __restart_map_cache['cache'],
+                stopstart, restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def ordered(orderme):
+    """Converts the provided dictionary into a collections.OrderedDict.
+
+    The items in the returned OrderedDict will be inserted based on the
+    natural sort order of the keys. Nested dictionaries will also be sorted
+    in order to ensure fully predictable ordering.
+
+    :param orderme: the dict to order
+    :return: collections.OrderedDict
+    :raises: ValueError: if `orderme` isn't a dict instance.
+    """
+    if not isinstance(orderme, dict):
+        raise ValueError('argument must be a dict type')
+
+    result = OrderedDict()
+    for k, v in sorted(six.iteritems(orderme), key=lambda x: x[0]):
+        if isinstance(v, dict):
+            result[k] = ordered(v)
+        else:
+            result[k] = v
+
+    return result
+
+
+def config_flags_parser(config_flags):
+    """Parses config flags string into dict.
+
+    This parsing method supports a few different formats for the config
+    flag values to be parsed:
+
+      1. A string in the simple format of key=value pairs, with the possibility
+         of specifying multiple key value pairs within the same string. For
+         example, a string in the format of 'key1=value1, key2=value2' will
+         return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2'}.
+
+      2. A string in the above format, but supporting a comma-delimited list
+         of values for the same key. For example, a string in the format of
+         'key1=value1, key2=value3,value4,value5' will return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2,value3,value4'}
+
+      3. A string containing a colon character (:) prior to an equal
+         character (=) will be treated as yaml and parsed as such. This can be
+         used to specify more complex key value pairs. For example,
+         a string in the format of 'key1: subkey1=value1, subkey2=value2' will
+         return a dict of:
+
+             {'key1', 'subkey1=value1, subkey2=value2'}
+
+    The provided config_flags string may be a list of comma-separated values
+    which themselves may be comma-separated list of values.
+    """
+    # If we find a colon before an equals sign then treat it as yaml.
+    # Note: limit it to finding the colon first since this indicates assignment
+    # for inline yaml.
+    colon = config_flags.find(':')
+    equals = config_flags.find('=')
+    if colon > 0:
+        if colon < equals or equals < 0:
+            return ordered(yaml.safe_load(config_flags))
+
+    if config_flags.find('==') >= 0:
+        juju_log("config_flags is not in expected format (key=value)",
+                 level=ERROR)
+        raise OSContextError
+
+    # strip the following from each value.
+    post_strippers = ' ,'
+    # we strip any leading/trailing '=' or ' ' from the string then
+    # split on '='.
+    split = config_flags.strip(' =').split('=')
+    limit = len(split)
+    flags = OrderedDict()
+    for i in range(0, limit - 1):
+        current = split[i]
+        next = split[i + 1]
+        vindex = next.rfind(',')
+        if (i == limit - 2) or (vindex < 0):
+            value = next
+        else:
+            value = next[:vindex]
+
+        if i == 0:
+            key = current
+        else:
+            # if this not the first entry, expect an embedded key.
+            index = current.rfind(',')
+            if index < 0:
+                juju_log("Invalid config value(s) at index %s" % (i),
+                         level=ERROR)
+                raise OSContextError
+            key = current[index + 1:]
+
+        # Add to collection.
+        flags[key.strip(post_strippers)] = value.rstrip(post_strippers)
+
+    return flags
+
+
+def os_application_version_set(package):
+    '''Set version of application for Juju 2.0 and later'''
+    application_version = get_upstream_version(package)
+    # NOTE(jamespage) if not able to figure out package version, fallback to
+    #                 openstack codename version detection.
+    if not application_version:
+        application_version_set(os_release(package))
+    else:
+        application_version_set(application_version)
+
+
+def os_application_status_set(check_function):
+    """Run the supplied function and set the application status accordingly.
+
+    :param check_function: Function to run to get app states and messages.
+    :type check_function: function
+    """
+    state, message = check_function()
+    status_set(state, message, application=True)
+
+
+def enable_memcache(source=None, release=None, package=None):
+    """Determine if memcache should be enabled on the local unit
+
+    @param release: release of OpenStack currently deployed
+    @param package: package to derive OpenStack version deployed
+    @returns boolean Whether memcache should be enabled
+    """
+    _release = None
+    if release:
+        _release = release
+    else:
+        _release = os_release(package)
+    if not _release:
+        _release = get_os_codename_install_source(source)
+
+    return CompareOpenStackReleases(_release) >= 'mitaka'
+
+
+def token_cache_pkgs(source=None, release=None):
+    """Determine additional packages needed for token caching
+
+    @param source: source string for charm
+    @param release: release of OpenStack currently deployed
+    @returns List of package to enable token caching
+    """
+    packages = []
+    if enable_memcache(source=source, release=release):
+        packages.extend(['memcached', 'python-memcache'])
+    return packages
+
+
+def update_json_file(filename, items):
+    """Updates the json `filename` with a given dict.
+    :param filename: path to json file (e.g. /etc/glance/policy.json)
+    :param items: dict of items to update
+    """
+    if not items:
+        return
+
+    with open(filename) as fd:
+        policy = json.load(fd)
+
+    # Compare before and after and if nothing has changed don't write the file
+    # since that could cause unnecessary service restarts.
+    before = json.dumps(policy, indent=4, sort_keys=True)
+    policy.update(items)
+    after = json.dumps(policy, indent=4, sort_keys=True)
+    if before == after:
+        return
+
+    with open(filename, "w") as fd:
+        fd.write(after)
+
+
+@cached
+def snap_install_requested():
+    """ Determine if installing from snaps
+
+    If openstack-origin is of the form snap:track/channel[/branch]
+    and channel is in SNAPS_CHANNELS return True.
+    """
+    origin = config('openstack-origin') or ""
+    if not origin.startswith('snap:'):
+        return False
+
+    _src = origin[5:]
+    if '/' in _src:
+        channel = _src.split('/')[1]
+    else:
+        # Handle snap:track with no channel
+        channel = 'stable'
+    return valid_snap_channel(channel)
+
+
+def get_snaps_install_info_from_origin(snaps, src, mode='classic'):
+    """Generate a dictionary of snap install information from origin
+
+    @param snaps: List of snaps
+    @param src: String of openstack-origin or source of the form
+        snap:track/channel
+    @param mode: String classic, devmode or jailmode
+    @returns: Dictionary of snaps with channels and modes
+    """
+
+    if not src.startswith('snap:'):
+        juju_log("Snap source is not a snap origin", 'WARN')
+        return {}
+
+    _src = src[5:]
+    channel = '--channel={}'.format(_src)
+
+    return {snap: {'channel': channel, 'mode': mode}
+            for snap in snaps}
+
+
+def install_os_snaps(snaps, refresh=False):
+    """Install OpenStack snaps from channel and with mode
+
+    @param snaps: Dictionary of snaps with channels and modes of the form:
+        {'snap_name': {'channel': 'snap_channel',
+                       'mode': 'snap_mode'}}
+        Where channel is a snapstore channel and mode is --classic, --devmode
+        or --jailmode.
+    @param post_snap_install: Callback function to run after snaps have been
+    installed
+    """
+
+    def _ensure_flag(flag):
+        if flag.startswith('--'):
+            return flag
+        return '--{}'.format(flag)
+
+    if refresh:
+        for snap in snaps.keys():
+            snap_refresh(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+    else:
+        for snap in snaps.keys():
+            snap_install(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+
+
+def set_unit_upgrading():
+    """Set the unit to a upgrading state in the local kv() store.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', True)
+
+
+def clear_unit_upgrading():
+    """Clear the unit from a upgrading state in the local kv() store
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', False)
+
+
+def is_unit_upgrading_set():
+    """Return the state of the kv().get('unit-upgrading').
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-upgrading')))
+    except Exception:
+        return False
+
+
+def series_upgrade_prepare(pause_unit_helper=None, configs=None):
+    """ Run common series upgrade prepare tasks.
+
+    :param pause_unit_helper: function: Function to pause unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    set_unit_upgrading()
+    if pause_unit_helper and configs:
+        if not is_unit_paused_set():
+            pause_unit_helper(configs)
+
+
+def series_upgrade_complete(resume_unit_helper=None, configs=None):
+    """ Run common series upgrade complete tasks.
+
+    :param resume_unit_helper: function: Function to resume unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    clear_unit_paused()
+    clear_unit_upgrading()
+    if configs:
+        configs.write_all()
+        if resume_unit_helper:
+            resume_unit_helper(configs)
+
+
+def is_db_initialised():
+    """Check leader storage to see if database has been initialised.
+
+    :returns: Whether DB has been initialised
+    :rtype: bool
+    """
+    db_initialised = None
+    if leader_get('db-initialised') is None:
+        juju_log(
+            'db-initialised key missing, assuming db is not initialised',
+            'DEBUG')
+        db_initialised = False
+    else:
+        db_initialised = bool_from_string(leader_get('db-initialised'))
+    juju_log('Database initialised: {}'.format(db_initialised), 'DEBUG')
+    return db_initialised
+
+
+def set_db_initialised():
+    """Add flag to leader storage to indicate database has been initialised.
+    """
+    juju_log('Setting db-initialised to True', 'DEBUG')
+    leader_set({'db-initialised': True})
+
+
+def is_db_maintenance_mode(relid=None):
+    """Check relation data from notifications of db in maintenance mode.
+
+    :returns: Whether db has notified it is in maintenance mode.
+    :rtype: bool
+    """
+    juju_log('Checking for maintenance notifications', 'DEBUG')
+    if relid:
+        r_ids = [relid]
+    else:
+        r_ids = relation_ids('shared-db')
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    notifications = []
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        for key, value in settings.items():
+            if value and key in DB_MAINTENANCE_KEYS:
+                juju_log(
+                    'Unit: {}, Key: {}, Value: {}'.format(unit, key, value),
+                    'DEBUG')
+                try:
+                    notifications.append(bool_from_string(value))
+                except ValueError:
+                    juju_log(
+                        'Could not discern bool from {}'.format(value),
+                        'WARN')
+                    pass
+    return True in notifications
+
+
+@cached
+def container_scoped_relations():
+    """Get all the container scoped relations
+
+    :returns: List of relation names
+    :rtype: List
+    """
+    md = metadata()
+    relations = []
+    for relation_type in ('provides', 'requires', 'peers'):
+        for relation in md.get(relation_type, []):
+            if md[relation_type][relation].get('scope') == 'container':
+                relations.append(relation)
+    return relations
+
+
+def is_db_ready(use_current_context=False, rel_name=None):
+    """Check remote database is ready to be used.
+
+    Database relations are expected to provide a list of 'allowed' units to
+    confirm that the database is ready for use by those units.
+
+    If db relation has provided this information and local unit is a member,
+    returns True otherwise False.
+
+    :param use_current_context: Whether to limit checks to current hook
+                                context.
+    :type use_current_context: bool
+    :param rel_name: Name of relation to check
+    :type rel_name: string
+    :returns: Whether remote db is ready.
+    :rtype: bool
+    :raises: Exception
+    """
+    key = 'allowed_units'
+
+    rel_name = rel_name or 'shared-db'
+    this_unit = local_unit()
+
+    if use_current_context:
+        if relation_id() in relation_ids(rel_name):
+            rids_units = [(None, None)]
+        else:
+            raise Exception("use_current_context=True but not in {} "
+                            "rel hook contexts (currently in {})."
+                            .format(rel_name, relation_id()))
+    else:
+        rids_units = [(r_id, u)
+                      for r_id in relation_ids(rel_name)
+                      for u in related_units(r_id)]
+
+    for rid, unit in rids_units:
+        allowed_units = relation_get(rid=rid, unit=unit, attribute=key)
+        if allowed_units and this_unit in allowed_units.split():
+            juju_log("This unit ({}) is in allowed unit list from {}".format(
+                this_unit,
+                unit), 'DEBUG')
+            return True
+
+    juju_log("This unit was not found in any allowed unit list")
+    return False
+
+
+def is_expected_scale(peer_relation_name='cluster'):
+    """Query juju goal-state to determine whether our peer- and dependency-
+    relations are at the expected scale.
+
+    Useful for deferring per unit per relation housekeeping work until we are
+    ready to complete it successfully and without unnecessary repetiton.
+
+    Always returns True if version of juju used does not support goal-state.
+
+    :param peer_relation_name: Name of peer relation
+    :type rel_name: string
+    :returns: True or False
+    :rtype: bool
+    """
+    def _get_relation_id(rel_type):
+        return next((rid for rid in relation_ids(reltype=rel_type)), None)
+
+    Relation = namedtuple('Relation', 'rel_type rel_id')
+    peer_rid = _get_relation_id(peer_relation_name)
+    # Units with no peers should still have a peer relation.
+    if not peer_rid:
+        juju_log('Not at expected scale, no peer relation found', 'DEBUG')
+        return False
+    expected_relations = [
+        Relation(rel_type='shared-db', rel_id=_get_relation_id('shared-db'))]
+    if expect_ha():
+        expected_relations.append(
+            Relation(
+                rel_type='ha',
+                rel_id=_get_relation_id('ha')))
+    juju_log(
+        'Checking scale of {} relations'.format(
+            ','.join([r.rel_type for r in expected_relations])),
+        'DEBUG')
+    try:
+        if (len(related_units(relid=peer_rid)) <
+                len(list(expected_peer_units()))):
+            return False
+        for rel in expected_relations:
+            if not rel.rel_id:
+                juju_log(
+                    'Expected to find {} relation, but it is missing'.format(
+                        rel.rel_type),
+                    'DEBUG')
+                return False
+            # Goal state returns every unit even for container scoped
+            # relations but the charm only ever has a relation with
+            # the local unit.
+            if rel.rel_type in container_scoped_relations():
+                expected_count = 1
+            else:
+                expected_count = len(
+                    list(expected_related_units(reltype=rel.rel_type)))
+            if len(related_units(relid=rel.rel_id)) < expected_count:
+                juju_log(
+                    ('Not at expected scale, not enough units on {} '
+                     'relation'.format(rel.rel_type)),
+                    'DEBUG')
+                return False
+    except NotImplementedError:
+        return True
+    juju_log('All checks have passed, unit is at expected scale', 'DEBUG')
+    return True
+
+
+def get_peer_key(unit_name):
+    """Get the peer key for this unit.
+
+    The peer key is the key a unit uses to publish its status down the peer
+    relation
+
+    :param unit_name: Name of unit
+    :type unit_name: string
+    :returns: Peer key for given unit
+    :rtype: string
+    """
+    return 'unit-state-{}'.format(unit_name.replace('/', '-'))
+
+
+UNIT_READY = 'READY'
+UNIT_NOTREADY = 'NOTREADY'
+UNIT_UNKNOWN = 'UNKNOWN'
+UNIT_STATES = [UNIT_READY, UNIT_NOTREADY, UNIT_UNKNOWN]
+
+
+def inform_peers_unit_state(state, relation_name='cluster'):
+    """Inform peers of the state of this unit.
+
+    :param state: State of unit to publish
+    :type state: string
+    :param relation_name: Name of relation to publish state on
+    :type relation_name: string
+    """
+    if state not in UNIT_STATES:
+        raise ValueError(
+            "Setting invalid state {} for unit".format(state))
+    for r_id in relation_ids(relation_name):
+        relation_set(relation_id=r_id,
+                     relation_settings={
+                         get_peer_key(local_unit()): state})
+
+
+def get_peers_unit_state(relation_name='cluster'):
+    """Get the state of all peers.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Unit states keyed on unit name.
+    :rtype: dict
+    :raises: ValueError
+    """
+    r_ids = relation_ids(relation_name)
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    unit_states = {}
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        unit_states[unit] = settings.get(get_peer_key(unit), UNIT_UNKNOWN)
+        if unit_states[unit] not in UNIT_STATES:
+            raise ValueError(
+                "Unit in unknown state {}".format(unit_states[unit]))
+    return unit_states
+
+
+def are_peers_ready(relation_name='cluster'):
+    """Check if all peers are ready.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Whether all units are ready.
+    :rtype: bool
+    """
+    unit_states = get_peers_unit_state(relation_name)
+    return all(v == UNIT_READY for v in unit_states.values())
+
+
+def inform_peers_if_ready(check_unit_ready_func, relation_name='cluster'):
+    """Inform peers if this unit is ready.
+
+    The check function should return a tuple (state, message). A state
+    of 'READY' indicates the unit is READY.
+
+    :param check_unit_ready_func: Function to run to check readiness
+    :type check_unit_ready_func: function
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    """
+    unit_ready, msg = check_unit_ready_func()
+    if unit_ready:
+        state = UNIT_READY
+    else:
+        state = UNIT_NOTREADY
+    juju_log('Telling peers this unit is: {}'.format(state), 'DEBUG')
+    inform_peers_unit_state(state, relation_name)
+
+
+def check_api_unit_ready(check_db_ready=True):
+    """Check if this unit is ready.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Whether unit state is ready and status message
+    :rtype: (bool, str)
+    """
+    unit_state, msg = get_api_unit_status(check_db_ready=check_db_ready)
+    return unit_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_unit_status(check_db_ready=True):
+    """Return a workload status and message for this unit.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    unit_state = WORKLOAD_STATES.ACTIVE
+    msg = 'Unit is ready'
+    if is_db_maintenance_mode():
+        unit_state = WORKLOAD_STATES.MAINTENANCE
+        msg = 'Database in maintenance mode.'
+    elif is_unit_paused_set():
+        unit_state = WORKLOAD_STATES.BLOCKED
+        msg = 'Unit paused.'
+    elif check_db_ready and not is_db_ready():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Allowed_units list provided but this unit not present'
+    elif not is_db_initialised():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Database not initialised'
+    elif not is_expected_scale():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Charm and its dependencies not yet at expected scale'
+    juju_log(msg, 'DEBUG')
+    return unit_state, msg
+
+
+def check_api_application_ready():
+    """Check if this application is ready.
+
+    :returns: Whether application state is ready and status message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_application_status()
+    return app_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_application_status():
+    """Return a workload status and message for this application.
+
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_unit_status()
+    if app_state == WORKLOAD_STATES.ACTIVE:
+        if are_peers_ready():
+            return WORKLOAD_STATES.ACTIVE, 'Application Ready'
+        else:
+            return WORKLOAD_STATES.WAITING, 'Some units are not ready'
+    return app_state, msg
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/vaultlocker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/vaultlocker.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ee6c1dba910b824467c2c34e0a3d3d0f3fd906d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/openstack/vaultlocker.py
@@ -0,0 +1,179 @@
+# Copyright 2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+
+import charmhelpers.contrib.openstack.alternatives as alternatives
+import charmhelpers.contrib.openstack.context as context
+
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as host
+import charmhelpers.core.templating as templating
+import charmhelpers.core.unitdata as unitdata
+
+VAULTLOCKER_BACKEND = 'charm-vaultlocker'
+
+
+class VaultKVContext(context.OSContextGenerator):
+    """Vault KV context for interaction with vault-kv interfaces"""
+    interfaces = ['secrets-storage']
+
+    def __init__(self, secret_backend=None):
+        super(context.OSContextGenerator, self).__init__()
+        self.secret_backend = (
+            secret_backend or 'charm-{}'.format(hookenv.service_name())
+        )
+
+    def __call__(self):
+        try:
+            import hvac
+        except ImportError:
+            # BUG: #1862085 - if the relation is made to vault, but the
+            # 'encrypt' option is not made, then the charm errors with an
+            # import warning.  This catches that, logs a warning, and returns
+            # with an empty context.
+            hookenv.log("VaultKVContext: trying to use hvac pythong module "
+                        "but it's not available.  Is secrets-stroage relation "
+                        "made, but encrypt option not set?",
+                        level=hookenv.WARNING)
+            # return an emptry context on hvac import error
+            return {}
+        ctxt = {}
+        # NOTE(hopem): see https://bugs.launchpad.net/charm-helpers/+bug/1849323
+        db = unitdata.kv()
+        # currently known-good secret-id
+        secret_id = db.get('secret-id')
+
+        for relation_id in hookenv.relation_ids(self.interfaces[0]):
+            for unit in hookenv.related_units(relation_id):
+                data = hookenv.relation_get(unit=unit,
+                                            rid=relation_id)
+                vault_url = data.get('vault_url')
+                role_id = data.get('{}_role_id'.format(hookenv.local_unit()))
+                token = data.get('{}_token'.format(hookenv.local_unit()))
+
+                if all([vault_url, role_id, token]):
+                    token = json.loads(token)
+                    vault_url = json.loads(vault_url)
+
+                    # Tokens may change when secret_id's are being
+                    # reissued - if so use token to get new secret_id
+                    token_success = False
+                    try:
+                        secret_id = retrieve_secret_id(
+                            url=vault_url,
+                            token=token
+                        )
+                        token_success = True
+                    except hvac.exceptions.InvalidRequest:
+                        # Try next
+                        pass
+
+                    if token_success:
+                        db.set('secret-id', secret_id)
+                        db.flush()
+
+                        ctxt['vault_url'] = vault_url
+                        ctxt['role_id'] = json.loads(role_id)
+                        ctxt['secret_id'] = secret_id
+                        ctxt['secret_backend'] = self.secret_backend
+                        vault_ca = data.get('vault_ca')
+                        if vault_ca:
+                            ctxt['vault_ca'] = json.loads(vault_ca)
+
+                        self.complete = True
+                        break
+                    else:
+                        if secret_id:
+                            ctxt['vault_url'] = vault_url
+                            ctxt['role_id'] = json.loads(role_id)
+                            ctxt['secret_id'] = secret_id
+                            ctxt['secret_backend'] = self.secret_backend
+                            vault_ca = data.get('vault_ca')
+                            if vault_ca:
+                                ctxt['vault_ca'] = json.loads(vault_ca)
+
+            if self.complete:
+                break
+
+        if ctxt:
+            self.complete = True
+
+        return ctxt
+
+
+def write_vaultlocker_conf(context, priority=100):
+    """Write vaultlocker configuration to disk and install alternative
+
+    :param context: Dict of data from vault-kv relation
+    :ptype: context: dict
+    :param priority: Priority of alternative configuration
+    :ptype: priority: int"""
+    charm_vl_path = "/var/lib/charm/{}/vaultlocker.conf".format(
+        hookenv.service_name()
+    )
+    host.mkdir(os.path.dirname(charm_vl_path), perms=0o700)
+    templating.render(source='vaultlocker.conf.j2',
+                      target=charm_vl_path,
+                      context=context, perms=0o600),
+    alternatives.install_alternative('vaultlocker.conf',
+                                     '/etc/vaultlocker/vaultlocker.conf',
+                                     charm_vl_path, priority)
+
+
+def vault_relation_complete(backend=None):
+    """Determine whether vault relation is complete
+
+    :param backend: Name of secrets backend requested
+    :ptype backend: string
+    :returns: whether the relation to vault is complete
+    :rtype: bool"""
+    try:
+        import hvac
+    except ImportError:
+        return False
+    try:
+        vault_kv = VaultKVContext(secret_backend=backend or VAULTLOCKER_BACKEND)
+        vault_kv()
+        return vault_kv.complete
+    except hvac.exceptions.InvalidRequest:
+        return False
+
+
+# TODO: contrib a high level unwrap method to hvac that works
+def retrieve_secret_id(url, token):
+    """Retrieve a response-wrapped secret_id from Vault
+
+    :param url: URL to Vault Server
+    :ptype url: str
+    :param token: One shot Token to use
+    :ptype token: str
+    :returns: secret_id to use for Vault Access
+    :rtype: str"""
+    import hvac
+    try:
+        # hvac 0.10.1 changed default adapter to JSONAdapter
+        client = hvac.Client(url=url, token=token, adapter=hvac.adapters.Request)
+    except AttributeError:
+        # hvac < 0.6.2 doesn't have adapter but uses the same response interface
+        client = hvac.Client(url=url, token=token)
+    else:
+        # hvac < 0.9.2 assumes adapter is an instance, so doesn't instantiate
+        if not isinstance(client.adapter, hvac.adapters.Request):
+            client.adapter = hvac.adapters.Request(base_uri=url, token=token)
+    response = client._post('/v1/sys/wrapping/unwrap')
+    if response.status_code == 200:
+        data = response.json()
+        return data['data']['secret_id']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/peerstorage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/peerstorage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8fa60c2a3080d088b8e0abae370aa355c80ec56
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/peerstorage/__init__.py
@@ -0,0 +1,267 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import six
+
+from charmhelpers.core.hookenv import relation_id as current_relation_id
+from charmhelpers.core.hookenv import (
+    is_relation_made,
+    relation_ids,
+    relation_get as _relation_get,
+    local_unit,
+    relation_set as _relation_set,
+    leader_get as _leader_get,
+    leader_set,
+    is_leader,
+)
+
+
+"""
+This helper provides functions to support use of a peer relation
+for basic key/value storage, with the added benefit that all storage
+can be replicated across peer units.
+
+Requirement to use:
+
+To use this, the "peer_echo()" method has to be called form the peer
+relation's relation-changed hook:
+
+@hooks.hook("cluster-relation-changed") # Adapt the to your peer relation name
+def cluster_relation_changed():
+    peer_echo()
+
+Once this is done, you can use peer storage from anywhere:
+
+@hooks.hook("some-hook")
+def some_hook():
+    # You can store and retrieve key/values this way:
+    if is_relation_made("cluster"):  # from charmhelpers.core.hookenv
+        # There are peers available so we can work with peer storage
+        peer_store("mykey", "myvalue")
+        value = peer_retrieve("mykey")
+        print value
+    else:
+        print "No peers joind the relation, cannot share key/values :("
+"""
+
+
+def leader_get(attribute=None, rid=None):
+    """Wrapper to ensure that settings are migrated from the peer relation.
+
+    This is to support upgrading an environment that does not support
+    Juju leadership election to one that does.
+
+    If a setting is not extant in the leader-get but is on the relation-get
+    peer rel, it is migrated and marked as such so that it is not re-migrated.
+    """
+    migration_key = '__leader_get_migrated_settings__'
+    if not is_leader():
+        return _leader_get(attribute=attribute)
+
+    settings_migrated = False
+    leader_settings = _leader_get(attribute=attribute)
+    previously_migrated = _leader_get(attribute=migration_key)
+
+    if previously_migrated:
+        migrated = set(json.loads(previously_migrated))
+    else:
+        migrated = set([])
+
+    try:
+        if migration_key in leader_settings:
+            del leader_settings[migration_key]
+    except TypeError:
+        pass
+
+    if attribute:
+        if attribute in migrated:
+            return leader_settings
+
+        # If attribute not present in leader db, check if this unit has set
+        # the attribute in the peer relation
+        if not leader_settings:
+            peer_setting = _relation_get(attribute=attribute, unit=local_unit(),
+                                         rid=rid)
+            if peer_setting:
+                leader_set(settings={attribute: peer_setting})
+                leader_settings = peer_setting
+
+        if leader_settings:
+            settings_migrated = True
+            migrated.add(attribute)
+    else:
+        r_settings = _relation_get(unit=local_unit(), rid=rid)
+        if r_settings:
+            for key in set(r_settings.keys()).difference(migrated):
+                # Leader setting wins
+                if not leader_settings.get(key):
+                    leader_settings[key] = r_settings[key]
+
+                settings_migrated = True
+                migrated.add(key)
+
+            if settings_migrated:
+                leader_set(**leader_settings)
+
+    if migrated and settings_migrated:
+        migrated = json.dumps(list(migrated))
+        leader_set(settings={migration_key: migrated})
+
+    return leader_settings
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Attempt to use leader-set if supported in the current version of Juju,
+    otherwise falls back on relation-set.
+
+    Note that we only attempt to use leader-set if the provided relation_id is
+    a peer relation id or no relation id is provided (in which case we assume
+    we are within the peer relation context).
+    """
+    try:
+        if relation_id in relation_ids('cluster'):
+            return leader_set(settings=relation_settings, **kwargs)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_set(relation_id=relation_id,
+                             relation_settings=relation_settings, **kwargs)
+
+
+def relation_get(attribute=None, unit=None, rid=None):
+    """Attempt to use leader-get if supported in the current version of Juju,
+    otherwise falls back on relation-get.
+
+    Note that we only attempt to use leader-get if the provided rid is a peer
+    relation id or no relation id is provided (in which case we assume we are
+    within the peer relation context).
+    """
+    try:
+        if rid in relation_ids('cluster'):
+            return leader_get(attribute, rid)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_get(attribute=attribute, rid=rid, unit=unit)
+
+
+def peer_retrieve(key, relation_name='cluster'):
+    """Retrieve a named key from peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        return relation_get(attribute=key, rid=cluster_rid,
+                            unit=local_unit())
+    else:
+        raise ValueError('Unable to detect'
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_retrieve_by_prefix(prefix, relation_name='cluster', delimiter='_',
+                            inc_list=None, exc_list=None):
+    """ Retrieve k/v pairs given a prefix and filter using {inc,exc}_list """
+    inc_list = inc_list if inc_list else []
+    exc_list = exc_list if exc_list else []
+    peerdb_settings = peer_retrieve('-', relation_name=relation_name)
+    matched = {}
+    if peerdb_settings is None:
+        return matched
+    for k, v in peerdb_settings.items():
+        full_prefix = prefix + delimiter
+        if k.startswith(full_prefix):
+            new_key = k.replace(full_prefix, '')
+            if new_key in exc_list:
+                continue
+            if new_key in inc_list or len(inc_list) == 0:
+                matched[new_key] = v
+    return matched
+
+
+def peer_store(key, value, relation_name='cluster'):
+    """Store the key/value pair on the named peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        relation_set(relation_id=cluster_rid,
+                     relation_settings={key: value})
+    else:
+        raise ValueError('Unable to detect '
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_echo(includes=None, force=False):
+    """Echo filtered attributes back onto the same relation for storage.
+
+    This is a requirement to use the peerstorage module - it needs to be called
+    from the peer relation's changed hook.
+
+    If Juju leader support exists this will be a noop unless force is True.
+    """
+    try:
+        is_leader()
+    except NotImplementedError:
+        pass
+    else:
+        if not force:
+            return  # NOOP if leader-election is supported
+
+    # Use original non-leader calls
+    relation_get = _relation_get
+    relation_set = _relation_set
+
+    rdata = relation_get()
+    echo_data = {}
+    if includes is None:
+        echo_data = rdata.copy()
+        for ex in ['private-address', 'public-address']:
+            if ex in echo_data:
+                echo_data.pop(ex)
+    else:
+        for attribute, value in six.iteritems(rdata):
+            for include in includes:
+                if include in attribute:
+                    echo_data[attribute] = value
+    if len(echo_data) > 0:
+        relation_set(relation_settings=echo_data)
+
+
+def peer_store_and_set(relation_id=None, peer_relation_name='cluster',
+                       peer_store_fatal=False, relation_settings=None,
+                       delimiter='_', **kwargs):
+    """Store passed-in arguments both in argument relation and in peer storage.
+
+    It functions like doing relation_set() and peer_store() at the same time,
+    with the same data.
+
+    @param relation_id: the id of the relation to store the data on. Defaults
+                        to the current relation.
+    @param peer_store_fatal: Set to True, the function will raise an exception
+                             should the peer storage not be available."""
+
+    relation_settings = relation_settings if relation_settings else {}
+    relation_set(relation_id=relation_id,
+                 relation_settings=relation_settings,
+                 **kwargs)
+    if is_relation_made(peer_relation_name):
+        for key, value in six.iteritems(dict(list(kwargs.items()) +
+                                             list(relation_settings.items()))):
+            key_prefix = relation_id or current_relation_id()
+            peer_store(key_prefix + delimiter + key,
+                       value,
+                       relation_name=peer_relation_name)
+    else:
+        if peer_store_fatal:
+            raise ValueError('Unable to detect '
+                             'peer relation {}'.format(peer_relation_name))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/python.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..84cba8c4eba34fdd705f4ee39628ebd33b5175a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/python.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+# deprecated aliases for backwards compatibility
+from charmhelpers.fetch.python import debug  # noqa
+from charmhelpers.fetch.python import packages  # noqa
+from charmhelpers.fetch.python import rpdb  # noqa
+from charmhelpers.fetch.python import version  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/saltstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/saltstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d74f4039379b608b5c076fd96c906ff5237f1f83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/saltstack/__init__.py
@@ -0,0 +1,116 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Charm Helpers saltstack - declare the state of your machines.
+
+This helper enables you to declare your machine state, rather than
+program it procedurally (and have to test each change to your procedures).
+Your install hook can be as simple as::
+
+    {{{
+    from charmhelpers.contrib.saltstack import (
+        install_salt_support,
+        update_machine_state,
+    )
+
+
+    def install():
+        install_salt_support()
+        update_machine_state('machine_states/dependencies.yaml')
+        update_machine_state('machine_states/installed.yaml')
+    }}}
+
+and won't need to change (nor will its tests) when you change the machine
+state.
+
+It's using a python package called salt-minion which allows various formats for
+specifying resources, such as::
+
+    {{{
+    /srv/{{ basedir }}:
+        file.directory:
+            - group: ubunet
+            - user: ubunet
+            - require:
+                - user: ubunet
+            - recurse:
+                - user
+                - group
+
+    ubunet:
+        group.present:
+            - gid: 1500
+        user.present:
+            - uid: 1500
+            - gid: 1500
+            - createhome: False
+            - require:
+                - group: ubunet
+    }}}
+
+The docs for all the different state definitions are at:
+    http://docs.saltstack.com/ref/states/all/
+
+
+TODO:
+  * Add test helpers which will ensure that machine state definitions
+    are functionally (but not necessarily logically) correct (ie. getting
+    salt to parse all state defs.
+  * Add a link to a public bootstrap charm example / blogpost.
+  * Find a way to obviate the need to use the grains['charm_dir'] syntax
+    in templates.
+"""
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import subprocess
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+
+
+salt_grains_path = '/etc/salt/grains'
+
+
+def install_salt_support(from_ppa=True):
+    """Installs the salt-minion helper for machine state.
+
+    By default the salt-minion package is installed from
+    the saltstack PPA. If from_ppa is False you must ensure
+    that the salt-minion package is available in the apt cache.
+    """
+    if from_ppa:
+        subprocess.check_call([
+            '/usr/bin/add-apt-repository',
+            '--yes',
+            'ppa:saltstack/salt',
+        ])
+        subprocess.check_call(['/usr/bin/apt-get', 'update'])
+    # We install salt-common as salt-minion would run the salt-minion
+    # daemon.
+    charmhelpers.fetch.apt_install('salt-common')
+
+
+def update_machine_state(state_path):
+    """Update the machine state using the provided state declaration."""
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        salt_grains_path)
+    subprocess.check_call([
+        'salt-call',
+        '--local',
+        'state.template',
+        state_path,
+    ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d238b529e44ad2761d86e96b4845589f8e951c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/__init__.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def generate_selfsigned(keyfile, certfile, keysize="1024", config=None, subject=None, cn=None):
+    """Generate selfsigned SSL keypair
+
+    You must provide one of the 3 optional arguments:
+    config, subject or cn
+    If more than one is provided the leftmost will be used
+
+    Arguments:
+    keyfile -- (required) full path to the keyfile to be created
+    certfile -- (required) full path to the certfile to be created
+    keysize -- (optional) SSL key length
+    config -- (optional) openssl configuration file
+    subject -- (optional) dictionary with SSL subject variables
+    cn -- (optional) cerfificate common name
+
+    Required keys in subject dict:
+    cn -- Common name (eq. FQDN)
+
+    Optional keys in subject dict
+    country -- Country Name (2 letter code)
+    state -- State or Province Name (full name)
+    locality -- Locality Name (eg, city)
+    organization -- Organization Name (eg, company)
+    organizational_unit -- Organizational Unit Name (eg, section)
+    email -- Email Address
+    """
+
+    cmd = []
+    if config:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-config", config]
+    elif subject:
+        ssl_subject = ""
+        if "country" in subject:
+            ssl_subject = ssl_subject + "/C={}".format(subject["country"])
+        if "state" in subject:
+            ssl_subject = ssl_subject + "/ST={}".format(subject["state"])
+        if "locality" in subject:
+            ssl_subject = ssl_subject + "/L={}".format(subject["locality"])
+        if "organization" in subject:
+            ssl_subject = ssl_subject + "/O={}".format(subject["organization"])
+        if "organizational_unit" in subject:
+            ssl_subject = ssl_subject + "/OU={}".format(subject["organizational_unit"])
+        if "cn" in subject:
+            ssl_subject = ssl_subject + "/CN={}".format(subject["cn"])
+        else:
+            hookenv.log("When using \"subject\" argument you must "
+                        "provide \"cn\" field at very least")
+            return False
+        if "email" in subject:
+            ssl_subject = ssl_subject + "/emailAddress={}".format(subject["email"])
+
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", ssl_subject]
+    elif cn:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", "/CN={}".format(cn)]
+
+    if not cmd:
+        hookenv.log("No config, subject or cn provided,"
+                    "unable to generate self signed SSL certificates")
+        return False
+    try:
+        subprocess.check_call(cmd)
+        return True
+    except Exception as e:
+        print("Execution of openssl command failed:\n{}".format(e))
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/service.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..06b534ffa3b0de97a56bac4060c39a9a4485b0c2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/ssl/service.py
@@ -0,0 +1,277 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from os.path import join as path_join
+from os.path import exists
+import subprocess
+
+from charmhelpers.core.hookenv import log, DEBUG
+
+STD_CERT = "standard"
+
+# Mysql server is fairly picky about cert creation
+# and types, spec its creation separately for now.
+MYSQL_CERT = "mysql"
+
+
+class ServiceCA(object):
+
+    default_expiry = str(365 * 2)
+    default_ca_expiry = str(365 * 6)
+
+    def __init__(self, name, ca_dir, cert_type=STD_CERT):
+        self.name = name
+        self.ca_dir = ca_dir
+        self.cert_type = cert_type
+
+    ###############
+    # Hook Helper API
+    @staticmethod
+    def get_ca(type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca_path = os.path.join(os.environ['CHARM_DIR'], 'ca')
+        ca = ServiceCA(service_name, ca_path, type)
+        ca.init()
+        return ca
+
+    @classmethod
+    def get_service_cert(cls, type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca = cls.get_ca()
+        crt, key = ca.get_or_create_cert(service_name)
+        return crt, key, ca.get_ca_bundle()
+
+    ###############
+
+    def init(self):
+        log("initializing service ca", level=DEBUG)
+        if not exists(self.ca_dir):
+            self._init_ca_dir(self.ca_dir)
+            self._init_ca()
+
+    @property
+    def ca_key(self):
+        return path_join(self.ca_dir, 'private', 'cacert.key')
+
+    @property
+    def ca_cert(self):
+        return path_join(self.ca_dir, 'cacert.pem')
+
+    @property
+    def ca_conf(self):
+        return path_join(self.ca_dir, 'ca.cnf')
+
+    @property
+    def signing_conf(self):
+        return path_join(self.ca_dir, 'signing.cnf')
+
+    def _init_ca_dir(self, ca_dir):
+        os.mkdir(ca_dir)
+        for i in ['certs', 'crl', 'newcerts', 'private']:
+            sd = path_join(ca_dir, i)
+            if not exists(sd):
+                os.mkdir(sd)
+
+        if not exists(path_join(ca_dir, 'serial')):
+            with open(path_join(ca_dir, 'serial'), 'w') as fh:
+                fh.write('02\n')
+
+        if not exists(path_join(ca_dir, 'index.txt')):
+            with open(path_join(ca_dir, 'index.txt'), 'w') as fh:
+                fh.write('')
+
+    def _init_ca(self):
+        """Generate the root ca's cert and key.
+        """
+        if not exists(path_join(self.ca_dir, 'ca.cnf')):
+            with open(path_join(self.ca_dir, 'ca.cnf'), 'w') as fh:
+                fh.write(
+                    CA_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if not exists(path_join(self.ca_dir, 'signing.cnf')):
+            with open(path_join(self.ca_dir, 'signing.cnf'), 'w') as fh:
+                fh.write(
+                    SIGNING_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if exists(self.ca_cert) or exists(self.ca_key):
+            raise RuntimeError("Initialized called when CA already exists")
+        cmd = ['openssl', 'req', '-config', self.ca_conf,
+               '-x509', '-nodes', '-newkey', 'rsa',
+               '-days', self.default_ca_expiry,
+               '-keyout', self.ca_key, '-out', self.ca_cert,
+               '-outform', 'PEM']
+        output = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        log("CA Init:\n %s" % output, level=DEBUG)
+
+    def get_conf_variables(self):
+        return dict(
+            org_name="juju",
+            org_unit_name="%s service" % self.name,
+            common_name=self.name,
+            ca_dir=self.ca_dir)
+
+    def get_or_create_cert(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        return self.create_certificate(common_name)
+
+    def create_certificate(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        csr_p = path_join(self.ca_dir, "certs", "%s.csr" % common_name)
+        self._create_certificate(common_name, key_p, csr_p, crt_p)
+        return self.get_certificate(common_name)
+
+    def get_certificate(self, common_name):
+        if common_name not in self:
+            raise ValueError("No certificate for %s" % common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        with open(crt_p) as fh:
+            crt = fh.read()
+        with open(key_p) as fh:
+            key = fh.read()
+        return crt, key
+
+    def __contains__(self, common_name):
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        return exists(crt_p)
+
+    def _create_certificate(self, common_name, key_p, csr_p, crt_p):
+        template_vars = self.get_conf_variables()
+        template_vars['common_name'] = common_name
+        subj = '/O=%(org_name)s/OU=%(org_unit_name)s/CN=%(common_name)s' % (
+            template_vars)
+
+        log("CA Create Cert %s" % common_name, level=DEBUG)
+        cmd = ['openssl', 'req', '-sha1', '-newkey', 'rsa:2048',
+               '-nodes', '-days', self.default_expiry,
+               '-keyout', key_p, '-out', csr_p, '-subj', subj]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+        cmd = ['openssl', 'rsa', '-in', key_p, '-out', key_p]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+        log("CA Sign Cert %s" % common_name, level=DEBUG)
+        if self.cert_type == MYSQL_CERT:
+            cmd = ['openssl', 'x509', '-req',
+                   '-in', csr_p, '-days', self.default_expiry,
+                   '-CA', self.ca_cert, '-CAkey', self.ca_key,
+                   '-set_serial', '01', '-out', crt_p]
+        else:
+            cmd = ['openssl', 'ca', '-config', self.signing_conf,
+                   '-extensions', 'req_extensions',
+                   '-days', self.default_expiry, '-notext',
+                   '-in', csr_p, '-out', crt_p, '-subj', subj, '-batch']
+        log("running %s" % " ".join(cmd), level=DEBUG)
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+    def get_ca_bundle(self):
+        with open(self.ca_cert) as fh:
+            return fh.read()
+
+
+CA_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = ca_distinguished_name
+
+x509_extensions         = ca_extensions
+
+[ ca_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s Certificate Authority
+
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ ca_extensions ]
+basicConstraints        = critical,CA:true
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = cRLSign, keyCertSign
+"""
+
+
+SIGNING_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = req_distinguished_name
+
+x509_extensions         = req_extensions
+
+[ req_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s machine resources
+commonName              = %(common_name)s
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ req_extensions ]
+basicConstraints        = CA:false
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = digitalSignature, keyEncipherment, keyAgreement
+extendedKeyUsage        = serverAuth, clientAuth
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/bcache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/bcache.py
new file mode 100644
index 0000000000000000000000000000000000000000..605991e16a4238f4ed46fbf0791048187f375c5c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/bcache.py
@@ -0,0 +1,74 @@
+# Copyright 2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import json
+
+from charmhelpers.core.hookenv import log
+
+stats_intervals = ['stats_day', 'stats_five_minute',
+                   'stats_hour', 'stats_total']
+
+SYSFS = '/sys'
+
+
+class Bcache(object):
+    """Bcache behaviour
+    """
+
+    def __init__(self, cachepath):
+        self.cachepath = cachepath
+
+    @classmethod
+    def fromdevice(cls, devname):
+        return cls('{}/block/{}/bcache'.format(SYSFS, devname))
+
+    def __str__(self):
+        return self.cachepath
+
+    def get_stats(self, interval):
+        """Get cache stats
+        """
+        intervaldir = 'stats_{}'.format(interval)
+        path = "{}/{}".format(self.cachepath, intervaldir)
+        out = dict()
+        for elem in os.listdir(path):
+            out[elem] = open('{}/{}'.format(path, elem)).read().strip()
+        return out
+
+
+def get_bcache_fs():
+    """Return all cache sets
+    """
+    cachesetroot = "{}/fs/bcache".format(SYSFS)
+    try:
+        dirs = os.listdir(cachesetroot)
+    except OSError:
+        log("No bcache fs found")
+        return []
+    cacheset = set([Bcache('{}/{}'.format(cachesetroot, d)) for d in dirs if not d.startswith('register')])
+    return cacheset
+
+
+def get_stats_action(cachespec, interval):
+    """Action for getting bcache statistics for a given cachespec.
+    Cachespec can either be a device name, eg. 'sdb', which will retrieve
+    cache stats for the given device, or 'global', which will retrieve stats
+    for all cachesets
+    """
+    if cachespec == 'global':
+        caches = get_bcache_fs()
+    else:
+        caches = [Bcache.fromdevice(cachespec)]
+    res = dict((c.cachepath, c.get_stats(interval)) for c in caches)
+    return json.dumps(res, indent=4, separators=(',', ': '))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/ceph.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/ceph.py
new file mode 100644
index 0000000000000000000000000000000000000000..814d5c72bc246c9536d3bb5975ade1c7fbe989e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/ceph.py
@@ -0,0 +1,1810 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import collections
+import errno
+import hashlib
+import math
+import six
+
+import os
+import shutil
+import json
+import time
+import uuid
+
+from subprocess import (
+    check_call,
+    check_output,
+    CalledProcessError,
+)
+from charmhelpers.core.hookenv import (
+    config,
+    service_name,
+    local_unit,
+    relation_get,
+    relation_ids,
+    relation_set,
+    related_units,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core.host import (
+    mount,
+    mounts,
+    service_start,
+    service_stop,
+    service_running,
+    umount,
+    cmp_pkgrevno,
+)
+from charmhelpers.fetch import (
+    apt_install,
+)
+from charmhelpers.core.unitdata import kv
+
+from charmhelpers.core.kernel import modprobe
+from charmhelpers.contrib.openstack.utils import config_flags_parser
+
+KEYRING = '/etc/ceph/ceph.client.{}.keyring'
+KEYFILE = '/etc/ceph/ceph.client.{}.key'
+
+CEPH_CONF = """[global]
+auth supported = {auth}
+keyring = {keyring}
+mon host = {mon_hosts}
+log to syslog = {use_syslog}
+err to syslog = {use_syslog}
+clog to syslog = {use_syslog}
+"""
+
+# The number of placement groups per OSD to target for placement group
+# calculations. This number is chosen as 100 due to the ceph PG Calc
+# documentation recommending to choose 100 for clusters which are not
+# expected to increase in the foreseeable future. Since the majority of the
+# calculations are done on deployment, target the case of non-expanding
+# clusters as the default.
+DEFAULT_PGS_PER_OSD_TARGET = 100
+DEFAULT_POOL_WEIGHT = 10.0
+LEGACY_PG_COUNT = 200
+DEFAULT_MINIMUM_PGS = 2
+AUTOSCALER_DEFAULT_PGS = 32
+
+
+class OsdPostUpgradeError(Exception):
+    """Error class for OSD post-upgrade operations."""
+    pass
+
+
+class OSDSettingConflict(Exception):
+    """Error class for conflicting osd setting requests."""
+    pass
+
+
+class OSDSettingNotAllowed(Exception):
+    """Error class for a disallowed setting."""
+    pass
+
+
+OSD_SETTING_EXCEPTIONS = (OSDSettingConflict, OSDSettingNotAllowed)
+
+OSD_SETTING_WHITELIST = [
+    'osd heartbeat grace',
+    'osd heartbeat interval',
+]
+
+
+def _order_dict_by_key(rdict):
+    """Convert a dictionary into an OrderedDict sorted by key.
+
+    :param rdict: Dictionary to be ordered.
+    :type rdict: dict
+    :returns: Ordered Dictionary.
+    :rtype: collections.OrderedDict
+    """
+    return collections.OrderedDict(sorted(rdict.items(), key=lambda k: k[0]))
+
+
+def get_osd_settings(relation_name):
+    """Consolidate requested osd settings from all clients.
+
+    Consolidate requested osd settings from all clients. Check that the
+    requested setting is on the whitelist and it does not conflict with
+    any other requested settings.
+
+    :returns: Dictionary of settings
+    :rtype: dict
+
+    :raises: OSDSettingNotAllowed
+    :raises: OSDSettingConflict
+    """
+    rel_ids = relation_ids(relation_name)
+    osd_settings = {}
+    for relid in rel_ids:
+        for unit in related_units(relid):
+            unit_settings = relation_get('osd-settings', unit, relid) or '{}'
+            unit_settings = json.loads(unit_settings)
+            for key, value in unit_settings.items():
+                if key not in OSD_SETTING_WHITELIST:
+                    msg = 'Illegal settings "{}"'.format(key)
+                    raise OSDSettingNotAllowed(msg)
+                if key in osd_settings:
+                    if osd_settings[key] != unit_settings[key]:
+                        msg = 'Conflicting settings for "{}"'.format(key)
+                        raise OSDSettingConflict(msg)
+                else:
+                    osd_settings[key] = value
+    return _order_dict_by_key(osd_settings)
+
+
+def send_osd_settings():
+    """Pass on requested OSD settings to osd units."""
+    try:
+        settings = get_osd_settings('client')
+    except OSD_SETTING_EXCEPTIONS as e:
+        # There is a problem with the settings, not passing them on. Update
+        # status will notify the user.
+        log(e, level=ERROR)
+        return
+    data = {
+        'osd-settings': json.dumps(settings, sort_keys=True)}
+    for relid in relation_ids('osd'):
+        relation_set(relation_id=relid,
+                     relation_settings=data)
+
+
+def validator(value, valid_type, valid_range=None):
+    """
+    Used to validate these: http://docs.ceph.com/docs/master/rados/operations/pools/#set-pool-values
+    Example input:
+        validator(value=1,
+                  valid_type=int,
+                  valid_range=[0, 2])
+    This says I'm testing value=1.  It must be an int inclusive in [0,2]
+
+    :param value: The value to validate
+    :param valid_type: The type that value should be.
+    :param valid_range: A range of values that value can assume.
+    :return:
+    """
+    assert isinstance(value, valid_type), "{} is not a {}".format(
+        value,
+        valid_type)
+    if valid_range is not None:
+        assert isinstance(valid_range, list), \
+            "valid_range must be a list, was given {}".format(valid_range)
+        # If we're dealing with strings
+        if isinstance(value, six.string_types):
+            assert value in valid_range, \
+                "{} is not in the list {}".format(value, valid_range)
+        # Integer, float should have a min and max
+        else:
+            if len(valid_range) != 2:
+                raise ValueError(
+                    "Invalid valid_range list of {} for {}.  "
+                    "List must be [min,max]".format(valid_range, value))
+            assert value >= valid_range[0], \
+                "{} is less than minimum allowed value of {}".format(
+                    value, valid_range[0])
+            assert value <= valid_range[1], \
+                "{} is greater than maximum allowed value of {}".format(
+                    value, valid_range[1])
+
+
+class PoolCreationError(Exception):
+    """
+    A custom error to inform the caller that a pool creation failed.  Provides an error message
+    """
+
+    def __init__(self, message):
+        super(PoolCreationError, self).__init__(message)
+
+
+class Pool(object):
+    """
+    An object oriented approach to Ceph pool creation. This base class is inherited by ReplicatedPool and ErasurePool.
+    Do not call create() on this base class as it will not do anything.  Instantiate a child class and call create().
+    """
+
+    def __init__(self, service, name):
+        self.service = service
+        self.name = name
+
+    # Create the pool if it doesn't exist already
+    # To be implemented by subclasses
+    def create(self):
+        pass
+
+    def add_cache_tier(self, cache_pool, mode):
+        """
+        Adds a new cache tier to an existing pool.
+        :param cache_pool: six.string_types.  The cache tier pool name to add.
+        :param mode: six.string_types. The caching mode to use for this pool.  valid range = ["readonly", "writeback"]
+        :return: None
+        """
+        # Check the input types and values
+        validator(value=cache_pool, valid_type=six.string_types)
+        validator(value=mode, valid_type=six.string_types, valid_range=["readonly", "writeback"])
+
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'add', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, mode])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'set-overlay', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'pool', 'set', cache_pool, 'hit_set_type', 'bloom'])
+
+    def remove_cache_tier(self, cache_pool):
+        """
+        Removes a cache tier from Ceph.  Flushes all dirty objects from writeback pools and waits for that to complete.
+        :param cache_pool: six.string_types.  The cache tier pool name to remove.
+        :return: None
+        """
+        # read-only is easy, writeback is much harder
+        mode = get_cache_mode(self.service, cache_pool)
+        if mode == 'readonly':
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, 'none'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+        elif mode == 'writeback':
+            pool_forward_cmd = ['ceph', '--id', self.service, 'osd', 'tier',
+                                'cache-mode', cache_pool, 'forward']
+            if cmp_pkgrevno('ceph-common', '10.1') >= 0:
+                # Jewel added a mandatory flag
+                pool_forward_cmd.append('--yes-i-really-mean-it')
+
+            check_call(pool_forward_cmd)
+            # Flush the cache and wait for it to return
+            check_call(['rados', '--id', self.service, '-p', cache_pool, 'cache-flush-evict-all'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove-overlay', self.name])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+    def get_pgs(self, pool_size, percent_data=DEFAULT_POOL_WEIGHT,
+                device_class=None):
+        """Return the number of placement groups to use when creating the pool.
+
+        Returns the number of placement groups which should be specified when
+        creating the pool. This is based upon the calculation guidelines
+        provided by the Ceph Placement Group Calculator (located online at
+        http://ceph.com/pgcalc/).
+
+        The number of placement groups are calculated using the following:
+
+            (Target PGs per OSD) * (OSD #) * (%Data)
+            ----------------------------------------
+                         (Pool size)
+
+        Per the upstream guidelines, the OSD # should really be considered
+        based on the number of OSDs which are eligible to be selected by the
+        pool. Since the pool creation doesn't specify any of CRUSH set rules,
+        the default rule will be dependent upon the type of pool being
+        created (replicated or erasure).
+
+        This code makes no attempt to determine the number of OSDs which can be
+        selected for the specific rule, rather it is left to the user to tune
+        in the form of 'expected-osd-count' config option.
+
+        :param pool_size: int. pool_size is either the number of replicas for
+            replicated pools or the K+M sum for erasure coded pools
+        :param percent_data: float. the percentage of data that is expected to
+            be contained in the pool for the specific OSD set. Default value
+            is to assume 10% of the data is for this pool, which is a
+            relatively low % of the data but allows for the pg_num to be
+            increased. NOTE: the default is primarily to handle the scenario
+            where related charms requiring pools has not been upgraded to
+            include an update to indicate their relative usage of the pools.
+        :param device_class: str. class of storage to use for basis of pgs
+            calculation; ceph supports nvme, ssd and hdd by default based
+            on presence of devices of each type in the deployment.
+        :return: int.  The number of pgs to use.
+        """
+
+        # Note: This calculation follows the approach that is provided
+        # by the Ceph PG Calculator located at http://ceph.com/pgcalc/.
+        validator(value=pool_size, valid_type=int)
+
+        # Ensure that percent data is set to something - even with a default
+        # it can be set to None, which would wreak havoc below.
+        if percent_data is None:
+            percent_data = DEFAULT_POOL_WEIGHT
+
+        # If the expected-osd-count is specified, then use the max between
+        # the expected-osd-count and the actual osd_count
+        osd_list = get_osds(self.service, device_class)
+        expected = config('expected-osd-count') or 0
+
+        if osd_list:
+            if device_class:
+                osd_count = len(osd_list)
+            else:
+                osd_count = max(expected, len(osd_list))
+
+            # Log a message to provide some insight if the calculations claim
+            # to be off because someone is setting the expected count and
+            # there are more OSDs in reality. Try to make a proper guess
+            # based upon the cluster itself.
+            if not device_class and expected and osd_count != expected:
+                log("Found more OSDs than provided expected count. "
+                    "Using the actual count instead", INFO)
+        elif expected:
+            # Use the expected-osd-count in older ceph versions to allow for
+            # a more accurate pg calculations
+            osd_count = expected
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            return LEGACY_PG_COUNT
+
+        percent_data /= 100.0
+        target_pgs_per_osd = config('pgs-per-osd') or DEFAULT_PGS_PER_OSD_TARGET
+        num_pg = (target_pgs_per_osd * osd_count * percent_data) // pool_size
+
+        # NOTE: ensure a sane minimum number of PGS otherwise we don't get any
+        #       reasonable data distribution in minimal OSD configurations
+        if num_pg < DEFAULT_MINIMUM_PGS:
+            num_pg = DEFAULT_MINIMUM_PGS
+
+        # The CRUSH algorithm has a slight optimization for placement groups
+        # with powers of 2 so find the nearest power of 2. If the nearest
+        # power of 2 is more than 25% below the original value, the next
+        # highest value is used. To do this, find the nearest power of 2 such
+        # that 2^n <= num_pg, check to see if its within the 25% tolerance.
+        exponent = math.floor(math.log(num_pg, 2))
+        nearest = 2 ** exponent
+        if (num_pg - nearest) > (num_pg * 0.25):
+            # Choose the next highest power of 2 since the nearest is more
+            # than 25% below the original value.
+            return int(nearest * 2)
+        else:
+            return int(nearest)
+
+
+class ReplicatedPool(Pool):
+    def __init__(self, service, name, pg_num=None, replicas=2,
+                 percent_data=10.0, app_name=None):
+        super(ReplicatedPool, self).__init__(service=service, name=name)
+        self.replicas = replicas
+        self.percent_data = percent_data
+        if pg_num:
+            # Since the number of placement groups were specified, ensure
+            # that there aren't too many created.
+            max_pgs = self.get_pgs(self.replicas, 100.0)
+            self.pg_num = min(pg_num, max_pgs)
+        else:
+            self.pg_num = self.get_pgs(self.replicas, percent_data)
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, self.pg_num)
+                    ),
+                    self.name, str(self.pg_num)
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(self.pg_num)
+                ]
+
+            try:
+                check_call(cmd)
+                # Set the pool replica size
+                update_pool(client=self.service,
+                            pool=self.name,
+                            settings={'size': str(self.replicas)})
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+
+# Default jerasure erasure coded pool
+class ErasurePool(Pool):
+    def __init__(self, service, name, erasure_code_profile="default",
+                 percent_data=10.0, app_name=None):
+        super(ErasurePool, self).__init__(service=service, name=name)
+        self.erasure_code_profile = erasure_code_profile
+        self.percent_data = percent_data
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            # Try to find the erasure profile information in order to properly
+            # size the number of placement groups. The size of an erasure
+            # coded placement group is calculated as k+m.
+            erasure_profile = get_erasure_profile(self.service,
+                                                  self.erasure_code_profile)
+
+            # Check for errors
+            if erasure_profile is None:
+                msg = ("Failed to discover erasure profile named "
+                       "{}".format(self.erasure_code_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+            if 'k' not in erasure_profile or 'm' not in erasure_profile:
+                # Error
+                msg = ("Unable to find k (data chunks) or m (coding chunks) "
+                       "in erasure profile {}".format(erasure_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+
+            k = int(erasure_profile['k'])
+            m = int(erasure_profile['m'])
+            pgs = self.get_pgs(k + m, self.percent_data)
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, pgs)
+                    ),
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+
+            try:
+                check_call(cmd)
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+    """Get an existing erasure code profile if it already exists.
+       Returns json formatted output"""
+
+
+def enabled_manager_modules():
+    """Return a list of enabled manager modules.
+
+    :rtype: List[str]
+    """
+    cmd = ['ceph', 'mgr', 'module', 'ls']
+    try:
+        modules = check_output(cmd)
+        if six.PY3:
+            modules = modules.decode('UTF-8')
+    except CalledProcessError as e:
+        log("Failed to list ceph modules: {}".format(e), WARNING)
+        return []
+    modules = json.loads(modules)
+    return modules['enabled_modules']
+
+
+def enable_pg_autoscale(service, pool_name):
+    """
+    Enable Ceph's PG autoscaler for the specified pool.
+
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types. The name of the pool to enable sutoscaling on
+    :raise: CalledProcessError if the command fails
+    """
+    check_call(['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, 'pg_autoscale_mode', 'on'])
+
+
+def get_mon_map(service):
+    """
+    Returns the current monitor map.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :return: json string. :raise: ValueError if the monmap fails to parse.
+      Also raises CalledProcessError if our ceph command fails
+    """
+    try:
+        mon_status = check_output(['ceph', '--id', service,
+                                   'mon_status', '--format=json'])
+        if six.PY3:
+            mon_status = mon_status.decode('UTF-8')
+        try:
+            return json.loads(mon_status)
+        except ValueError as v:
+            log("Unable to parse mon_status json: {}. Error: {}"
+                .format(mon_status, str(v)))
+            raise
+    except CalledProcessError as e:
+        log("mon_status command failed with message: {}"
+            .format(str(e)))
+        raise
+
+
+def hash_monitor_names(service):
+    """
+    Uses the get_mon_map() function to get information about the monitor
+    cluster.
+    Hash the name of each monitor.  Return a sorted list of monitor hashes
+    in an ascending order.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :rtype : dict.   json dict of monitor name, ip address and rank
+    example: {
+        'name': 'ip-172-31-13-165',
+        'rank': 0,
+        'addr': '172.31.13.165:6789/0'}
+    """
+    try:
+        hash_list = []
+        monitor_list = get_mon_map(service=service)
+        if monitor_list['monmap']['mons']:
+            for mon in monitor_list['monmap']['mons']:
+                hash_list.append(
+                    hashlib.sha224(mon['name'].encode('utf-8')).hexdigest())
+            return sorted(hash_list)
+        else:
+            return None
+    except (ValueError, CalledProcessError):
+        raise
+
+
+def monitor_key_delete(service, key):
+    """
+    Delete a key and value pair from the monitor cluster
+    :param service: six.string_types. The Ceph user name to run the command under
+    Deletes a key value pair on the monitor cluster.
+    :param key: six.string_types.  The key to delete.
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'del', str(key)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_set(service, key, value):
+    """
+    Sets a key value pair on the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to set.
+    :param value: The value to set.  This will be converted to a string
+        before setting
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'put', str(key), str(value)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_get(service, key):
+    """
+    Gets the value of an existing key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for.
+    :return: Returns the value of that key or None if not found.
+    """
+    try:
+        output = check_output(
+            ['ceph', '--id', service,
+             'config-key', 'get', str(key)]).decode('UTF-8')
+        return output
+    except CalledProcessError as e:
+        log("Monitor config-key get failed with message: {}".format(
+            e.output))
+        return None
+
+
+def monitor_key_exists(service, key):
+    """
+    Searches for the existence of a key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for
+    :return: Returns True if the key exists, False if not and raises an
+     exception if an unknown error occurs. :raise: CalledProcessError if
+     an unknown error occurs
+    """
+    try:
+        check_call(
+            ['ceph', '--id', service,
+             'config-key', 'exists', str(key)])
+        # I can return true here regardless because Ceph returns
+        # ENOENT if the key wasn't found
+        return True
+    except CalledProcessError as e:
+        if e.returncode == errno.ENOENT:
+            return False
+        else:
+            log("Unknown error from ceph config-get exists: {} {}".format(
+                e.returncode, e.output))
+            raise
+
+
+def get_erasure_profile(service, name):
+    """
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name:
+    :return:
+    """
+    try:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'erasure-code-profile', 'get',
+                            name, '--format=json'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+        return json.loads(out)
+    except (CalledProcessError, OSError, ValueError):
+        return None
+
+
+def pool_set(service, pool_name, key, value):
+    """
+    Sets a value for a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param key: six.string_types
+    :param value:
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, key,
+           str(value).lower()]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def snapshot_pool(service, pool_name, snapshot_name):
+    """
+    Snapshots a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'mksnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_pool_snapshot(service, pool_name, snapshot_name):
+    """
+    Remove a snapshot from a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rmsnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def set_pool_quota(service, pool_name, max_bytes=None, max_objects=None):
+    """
+    :param service: The Ceph user name to run the command under
+    :type service: str
+    :param pool_name: Name of pool
+    :type pool_name: str
+    :param max_bytes: Maximum bytes quota to apply
+    :type max_bytes: int
+    :param max_objects: Maximum objects quota to apply
+    :type max_objects: int
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name]
+    if max_bytes:
+        cmd = cmd + ['max_bytes', str(max_bytes)]
+    if max_objects:
+        cmd = cmd + ['max_objects', str(max_objects)]
+    check_call(cmd)
+
+
+def remove_pool_quota(service, pool_name):
+    """
+    Set a byte quota on a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name, 'max_bytes', '0']
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_erasure_profile(service, profile_name):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'rm',
+           profile_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def create_erasure_profile(service, profile_name, erasure_plugin_name='jerasure',
+                           failure_domain='host',
+                           data_chunks=2, coding_chunks=1,
+                           locality=None, durability_estimator=None,
+                           device_class=None):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :param erasure_plugin_name: six.string_types
+    :param failure_domain: six.string_types.  One of ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region',
+        'room', 'root', 'row'])
+    :param data_chunks: int
+    :param coding_chunks: int
+    :param locality: int
+    :param durability_estimator: int
+    :param device_class: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    # Ensure this failure_domain is allowed by Ceph
+    validator(failure_domain, six.string_types,
+              ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region', 'room', 'root', 'row'])
+
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'set', profile_name,
+           'plugin=' + erasure_plugin_name, 'k=' + str(data_chunks), 'm=' + str(coding_chunks)
+           ]
+    if locality is not None and durability_estimator is not None:
+        raise ValueError("create_erasure_profile should be called with k, m and one of l or c but not both.")
+
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    # failure_domain changed in luminous
+    if luminous_or_later:
+        cmd.append('crush-failure-domain=' + failure_domain)
+    else:
+        cmd.append('ruleset-failure-domain=' + failure_domain)
+
+    # device class new in luminous
+    if luminous_or_later and device_class:
+        cmd.append('crush-device-class={}'.format(device_class))
+    else:
+        log('Skipping device class configuration (ceph < 12.0.0)',
+            level=DEBUG)
+
+    # Add plugin specific information
+    if locality is not None:
+        # For local erasure codes
+        cmd.append('l=' + str(locality))
+    if durability_estimator is not None:
+        # For Shec erasure codes
+        cmd.append('c=' + str(durability_estimator))
+
+    if erasure_profile_exists(service, profile_name):
+        cmd.append('--force')
+
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def rename_pool(service, old_name, new_name):
+    """
+    Rename a Ceph pool from old_name to new_name
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param old_name: six.string_types
+    :param new_name: six.string_types
+    :return: None
+    """
+    validator(value=old_name, valid_type=six.string_types)
+    validator(value=new_name, valid_type=six.string_types)
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rename', old_name, new_name]
+    check_call(cmd)
+
+
+def erasure_profile_exists(service, name):
+    """
+    Check to see if an Erasure code profile already exists.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name: six.string_types
+    :return: int or None
+    """
+    validator(value=name, valid_type=six.string_types)
+    try:
+        check_call(['ceph', '--id', service,
+                    'osd', 'erasure-code-profile', 'get',
+                    name])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def get_cache_mode(service, pool_name):
+    """
+    Find the current caching mode of the pool_name given.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: int or None
+    """
+    validator(value=service, valid_type=six.string_types)
+    validator(value=pool_name, valid_type=six.string_types)
+    out = check_output(['ceph', '--id', service,
+                        'osd', 'dump', '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    try:
+        osd_json = json.loads(out)
+        for pool in osd_json['pools']:
+            if pool['pool_name'] == pool_name:
+                return pool['cache_mode']
+        return None
+    except ValueError:
+        raise
+
+
+def pool_exists(service, name):
+    """Check to see if a RADOS pool already exists."""
+    try:
+        out = check_output(['rados', '--id', service, 'lspools'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out.split()
+
+
+def get_osds(service, device_class=None):
+    """Return a list of all Ceph Object Storage Daemons currently in the
+    cluster (optionally filtered by storage device class).
+
+    :param device_class: Class of storage device for OSD's
+    :type device_class: str
+    """
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    if luminous_or_later and device_class:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'crush', 'class',
+                            'ls-osd', device_class,
+                            '--format=json'])
+    else:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'ls',
+                            '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    return json.loads(out)
+
+
+def install():
+    """Basic Ceph client installation."""
+    ceph_dir = "/etc/ceph"
+    if not os.path.exists(ceph_dir):
+        os.mkdir(ceph_dir)
+
+    apt_install('ceph-common', fatal=True)
+
+
+def rbd_exists(service, pool, rbd_img):
+    """Check to see if a RADOS block device exists."""
+    try:
+        out = check_output(['rbd', 'list', '--id',
+                            service, '--pool', pool])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return rbd_img in out
+
+
+def create_rbd_image(service, pool, image, sizemb):
+    """Create a new RADOS block device."""
+    cmd = ['rbd', 'create', image, '--size', str(sizemb), '--id', service,
+           '--pool', pool]
+    check_call(cmd)
+
+
+def update_pool(client, pool, settings):
+    cmd = ['ceph', '--id', client, 'osd', 'pool', 'set', pool]
+    for k, v in six.iteritems(settings):
+        cmd.append(k)
+        cmd.append(v)
+
+    check_call(cmd)
+
+
+def set_app_name_for_pool(client, pool, name):
+    """
+    Calls `osd pool application enable` for the specified pool name
+
+    :param client: Name of the ceph client to use
+    :type client: str
+    :param pool: Pool to set app name for
+    :type pool: str
+    :param name: app name for the specified pool
+    :type name: str
+
+    :raises: CalledProcessError if ceph call fails
+    """
+    if cmp_pkgrevno('ceph-common', '12.0.0') >= 0:
+        cmd = ['ceph', '--id', client, 'osd', 'pool',
+               'application', 'enable', pool, name]
+        check_call(cmd)
+
+
+def create_pool(service, name, replicas=3, pg_num=None):
+    """Create a new RADOS pool."""
+    if pool_exists(service, name):
+        log("Ceph pool {} already exists, skipping creation".format(name),
+            level=WARNING)
+        return
+
+    if not pg_num:
+        # Calculate the number of placement groups based
+        # on upstream recommended best practices.
+        osds = get_osds(service)
+        if osds:
+            pg_num = (len(osds) * 100 // replicas)
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            pg_num = 200
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'create', name, str(pg_num)]
+    check_call(cmd)
+
+    update_pool(service, name, settings={'size': str(replicas)})
+
+
+def delete_pool(service, name):
+    """Delete a RADOS pool from ceph."""
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'delete', name,
+           '--yes-i-really-really-mean-it']
+    check_call(cmd)
+
+
+def _keyfile_path(service):
+    return KEYFILE.format(service)
+
+
+def _keyring_path(service):
+    return KEYRING.format(service)
+
+
+def add_key(service, key):
+    """
+    Add a key to a keyring.
+
+    Creates the keyring if it doesn't already exist.
+
+    Logs and returns if the key is already in the keyring.
+    """
+    keyring = _keyring_path(service)
+    if os.path.exists(keyring):
+        with open(keyring, 'r') as ring:
+            if key in ring.read():
+                log('Ceph keyring exists at %s and has not changed.' % keyring,
+                    level=DEBUG)
+                return
+            log('Updating existing keyring %s.' % keyring, level=DEBUG)
+
+    cmd = ['ceph-authtool', keyring, '--create-keyring',
+           '--name=client.{}'.format(service), '--add-key={}'.format(key)]
+    check_call(cmd)
+    log('Created new ceph keyring at %s.' % keyring, level=DEBUG)
+
+
+def create_keyring(service, key):
+    """Deprecated. Please use the more accurately named 'add_key'"""
+    return add_key(service, key)
+
+
+def delete_keyring(service):
+    """Delete an existing Ceph keyring."""
+    keyring = _keyring_path(service)
+    if not os.path.exists(keyring):
+        log('Keyring does not exist at %s' % keyring, level=WARNING)
+        return
+
+    os.remove(keyring)
+    log('Deleted ring at %s.' % keyring, level=INFO)
+
+
+def create_key_file(service, key):
+    """Create a file containing key."""
+    keyfile = _keyfile_path(service)
+    if os.path.exists(keyfile):
+        log('Keyfile exists at %s.' % keyfile, level=WARNING)
+        return
+
+    with open(keyfile, 'w') as fd:
+        fd.write(key)
+
+    log('Created new keyfile at %s.' % keyfile, level=INFO)
+
+
+def get_ceph_nodes(relation='ceph'):
+    """Query named relation to determine current nodes."""
+    hosts = []
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            hosts.append(relation_get('private-address', unit=unit, rid=r_id))
+
+    return hosts
+
+
+def configure(service, key, auth, use_syslog):
+    """Perform basic configuration of Ceph."""
+    add_key(service, key)
+    create_key_file(service, key)
+    hosts = get_ceph_nodes()
+    with open('/etc/ceph/ceph.conf', 'w') as ceph_conf:
+        ceph_conf.write(CEPH_CONF.format(auth=auth,
+                                         keyring=_keyring_path(service),
+                                         mon_hosts=",".join(map(str, hosts)),
+                                         use_syslog=use_syslog))
+    modprobe('rbd')
+
+
+def image_mapped(name):
+    """Determine whether a RADOS block device is mapped locally."""
+    try:
+        out = check_output(['rbd', 'showmapped'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out
+
+
+def map_block_storage(service, pool, image):
+    """Map a RADOS block device for local use."""
+    cmd = [
+        'rbd',
+        'map',
+        '{}/{}'.format(pool, image),
+        '--user',
+        service,
+        '--secret',
+        _keyfile_path(service),
+    ]
+    check_call(cmd)
+
+
+def filesystem_mounted(fs):
+    """Determine whether a filesytems is already mounted."""
+    return fs in [f for f, m in mounts()]
+
+
+def make_filesystem(blk_device, fstype='ext4', timeout=10):
+    """Make a new filesystem on the specified block device."""
+    count = 0
+    e_noent = errno.ENOENT
+    while not os.path.exists(blk_device):
+        if count >= timeout:
+            log('Gave up waiting on block device %s' % blk_device,
+                level=ERROR)
+            raise IOError(e_noent, os.strerror(e_noent), blk_device)
+
+        log('Waiting for block device %s to appear' % blk_device,
+            level=DEBUG)
+        count += 1
+        time.sleep(1)
+    else:
+        log('Formatting block device %s as filesystem %s.' %
+            (blk_device, fstype), level=INFO)
+        check_call(['mkfs', '-t', fstype, blk_device])
+
+
+def place_data_on_block_device(blk_device, data_src_dst):
+    """Migrate data in data_src_dst to blk_device and then remount."""
+    # mount block device into /mnt
+    mount(blk_device, '/mnt')
+    # copy data to /mnt
+    copy_files(data_src_dst, '/mnt')
+    # umount block device
+    umount('/mnt')
+    # Grab user/group ID's from original source
+    _dir = os.stat(data_src_dst)
+    uid = _dir.st_uid
+    gid = _dir.st_gid
+    # re-mount where the data should originally be
+    # TODO: persist is currently a NO-OP in core.host
+    mount(blk_device, data_src_dst, persist=True)
+    # ensure original ownership of new mount.
+    os.chown(data_src_dst, uid, gid)
+
+
+def copy_files(src, dst, symlinks=False, ignore=None):
+    """Copy files from src to dst."""
+    for item in os.listdir(src):
+        s = os.path.join(src, item)
+        d = os.path.join(dst, item)
+        if os.path.isdir(s):
+            shutil.copytree(s, d, symlinks, ignore)
+        else:
+            shutil.copy2(s, d)
+
+
+def ensure_ceph_storage(service, pool, rbd_img, sizemb, mount_point,
+                        blk_device, fstype, system_services=[],
+                        replicas=3):
+    """NOTE: This function must only be called from a single service unit for
+    the same rbd_img otherwise data loss will occur.
+
+    Ensures given pool and RBD image exists, is mapped to a block device,
+    and the device is formatted and mounted at the given mount_point.
+
+    If formatting a device for the first time, data existing at mount_point
+    will be migrated to the RBD device before being re-mounted.
+
+    All services listed in system_services will be stopped prior to data
+    migration and restarted when complete.
+    """
+    # Ensure pool, RBD image, RBD mappings are in place.
+    if not pool_exists(service, pool):
+        log('Creating new pool {}.'.format(pool), level=INFO)
+        create_pool(service, pool, replicas=replicas)
+
+    if not rbd_exists(service, pool, rbd_img):
+        log('Creating RBD image ({}).'.format(rbd_img), level=INFO)
+        create_rbd_image(service, pool, rbd_img, sizemb)
+
+    if not image_mapped(rbd_img):
+        log('Mapping RBD Image {} as a Block Device.'.format(rbd_img),
+            level=INFO)
+        map_block_storage(service, pool, rbd_img)
+
+    # make file system
+    # TODO: What happens if for whatever reason this is run again and
+    # the data is already in the rbd device and/or is mounted??
+    # When it is mounted already, it will fail to make the fs
+    # XXX: This is really sketchy!  Need to at least add an fstab entry
+    #      otherwise this hook will blow away existing data if its executed
+    #      after a reboot.
+    if not filesystem_mounted(mount_point):
+        make_filesystem(blk_device, fstype)
+
+        for svc in system_services:
+            if service_running(svc):
+                log('Stopping services {} prior to migrating data.'
+                    .format(svc), level=DEBUG)
+                service_stop(svc)
+
+        place_data_on_block_device(blk_device, mount_point)
+
+        for svc in system_services:
+            log('Starting service {} after migrating data.'
+                .format(svc), level=DEBUG)
+            service_start(svc)
+
+
+def ensure_ceph_keyring(service, user=None, group=None,
+                        relation='ceph', key=None):
+    """Ensures a ceph keyring is created for a named service and optionally
+    ensures user and group ownership.
+
+    @returns boolean: Flag to indicate whether a key was successfully written
+                      to disk based on either relation data or a supplied key
+    """
+    if not key:
+        for rid in relation_ids(relation):
+            for unit in related_units(rid):
+                key = relation_get('key', rid=rid, unit=unit)
+                if key:
+                    break
+
+    if not key:
+        return False
+
+    add_key(service=service, key=key)
+    keyring = _keyring_path(service)
+    if user and group:
+        check_call(['chown', '%s.%s' % (user, group), keyring])
+
+    return True
+
+
+class CephBrokerRq(object):
+    """Ceph broker request.
+
+    Multiple operations can be added to a request and sent to the Ceph broker
+    to be executed.
+
+    Request is json-encoded for sending over the wire.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, api_version=1, request_id=None):
+        self.api_version = api_version
+        if request_id:
+            self.request_id = request_id
+        else:
+            self.request_id = str(uuid.uuid1())
+        self.ops = []
+
+    def add_op(self, op):
+        """Add an op if it is not already in the list.
+
+        :param op: Operation to add.
+        :type op: dict
+        """
+        if op not in self.ops:
+            self.ops.append(op)
+
+    def add_op_request_access_to_group(self, name, namespace=None,
+                                       permission=None, key_name=None,
+                                       object_prefix_permissions=None):
+        """
+        Adds the requested permissions to the current service's Ceph key,
+        allowing the key to access only the specified pools or
+        object prefixes. object_prefix_permissions should be a dictionary
+        keyed on the permission with the corresponding value being a list
+        of prefixes to apply that permission to.
+            {
+                'rwx': ['prefix1', 'prefix2'],
+                'class-read': ['prefix3']}
+        """
+        self.add_op({
+            'op': 'add-permissions-to-key', 'group': name,
+            'namespace': namespace,
+            'name': key_name or service_name(),
+            'group-permission': permission,
+            'object-prefix-permissions': object_prefix_permissions})
+
+    def add_op_create_pool(self, name, replica_count=3, pg_num=None,
+                           weight=None, group=None, namespace=None,
+                           app_name=None, max_bytes=None, max_objects=None):
+        """DEPRECATED: Use ``add_op_create_replicated_pool()`` or
+                       ``add_op_create_erasure_pool()`` instead.
+        """
+        return self.add_op_create_replicated_pool(
+            name, replica_count=replica_count, pg_num=pg_num, weight=weight,
+            group=group, namespace=namespace, app_name=app_name,
+            max_bytes=max_bytes, max_objects=max_objects)
+
+    def add_op_create_replicated_pool(self, name, replica_count=3, pg_num=None,
+                                      weight=None, group=None, namespace=None,
+                                      app_name=None, max_bytes=None,
+                                      max_objects=None):
+        """Adds an operation to create a replicated pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param replica_count: Number of copies Ceph should keep of your data.
+        :type replica_count: int
+        :param pg_num: Request specific number of Placement Groups to create
+                       for pool.
+        :type pg_num: int
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+                       Used to calculate number of Placement Groups to create
+                       for pool.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param namespace: Group namespace
+        :type namespace: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        if pg_num and weight:
+            raise ValueError('pg_num and weight are mutually exclusive')
+
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'replicas': replica_count, 'pg_num': pg_num,
+                     'weight': weight, 'group': group,
+                     'group-namespace': namespace, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def add_op_create_erasure_pool(self, name, erasure_profile=None,
+                                   weight=None, group=None, app_name=None,
+                                   max_bytes=None, max_objects=None):
+        """Adds an operation to create a erasure coded pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param erasure_profile: Name of erasure code profile to use.  If not
+                                set the ceph-mon unit handling the broker
+                                request will set its default value.
+        :type erasure_profile: str
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'pool-type': 'erasure',
+                     'erasure-profile': erasure_profile,
+                     'weight': weight,
+                     'group': group, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def set_ops(self, ops):
+        """Set request ops to provided value.
+
+        Useful for injecting ops that come from a previous request
+        to allow comparisons to ensure validity.
+        """
+        self.ops = ops
+
+    @property
+    def request(self):
+        return json.dumps({'api-version': self.api_version, 'ops': self.ops,
+                           'request-id': self.request_id})
+
+    def _ops_equal(self, other):
+        if len(self.ops) == len(other.ops):
+            for req_no in range(0, len(self.ops)):
+                for key in [
+                        'replicas', 'name', 'op', 'pg_num', 'weight',
+                        'group', 'group-namespace', 'group-permission',
+                        'object-prefix-permissions']:
+                    if self.ops[req_no].get(key) != other.ops[req_no].get(key):
+                        return False
+        else:
+            return False
+        return True
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        if self.api_version == other.api_version and \
+                self._ops_equal(other):
+            return True
+        else:
+            return False
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+
+class CephBrokerRsp(object):
+    """Ceph broker response.
+
+    Response is json-decoded and contents provided as methods/properties.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, encoded_rsp):
+        self.api_version = None
+        self.rsp = json.loads(encoded_rsp)
+
+    @property
+    def request_id(self):
+        return self.rsp.get('request-id')
+
+    @property
+    def exit_code(self):
+        return self.rsp.get('exit-code')
+
+    @property
+    def exit_msg(self):
+        return self.rsp.get('stderr')
+
+
+# Ceph Broker Conversation:
+# If a charm needs an action to be taken by ceph it can create a CephBrokerRq
+# and send that request to ceph via the ceph relation. The CephBrokerRq has a
+# unique id so that the client can identity which CephBrokerRsp is associated
+# with the request. Ceph will also respond to each client unit individually
+# creating a response key per client unit eg glance/0 will get a CephBrokerRsp
+# via key broker-rsp-glance-0
+#
+# To use this the charm can just do something like:
+#
+# from charmhelpers.contrib.storage.linux.ceph import (
+#     send_request_if_needed,
+#     is_request_complete,
+#     CephBrokerRq,
+# )
+#
+# @hooks.hook('ceph-relation-changed')
+# def ceph_changed():
+#     rq = CephBrokerRq()
+#     rq.add_op_create_pool(name='poolname', replica_count=3)
+#
+#     if is_request_complete(rq):
+#         <Request complete actions>
+#     else:
+#         send_request_if_needed(get_ceph_request())
+#
+# CephBrokerRq and CephBrokerRsp are serialized into JSON. Below is an example
+# of glance having sent a request to ceph which ceph has successfully processed
+#  'ceph:8': {
+#      'ceph/0': {
+#          'auth': 'cephx',
+#          'broker-rsp-glance-0': '{"request-id": "0bc7dc54", "exit-code": 0}',
+#          'broker_rsp': '{"request-id": "0da543b8", "exit-code": 0}',
+#          'ceph-public-address': '10.5.44.103',
+#          'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+#          'private-address': '10.5.44.103',
+#      },
+#      'glance/0': {
+#          'broker_req': ('{"api-version": 1, "request-id": "0bc7dc54", '
+#                         '"ops": [{"replicas": 3, "name": "glance", '
+#                         '"op": "create-pool"}]}'),
+#          'private-address': '10.5.44.109',
+#      },
+#  }
+
+def get_previous_request(rid):
+    """Return the last ceph broker request sent on a given relation
+
+    @param rid: Relation id to query for request
+    """
+    request = None
+    broker_req = relation_get(attribute='broker_req', rid=rid,
+                              unit=local_unit())
+    if broker_req:
+        request_data = json.loads(broker_req)
+        request = CephBrokerRq(api_version=request_data['api-version'],
+                               request_id=request_data['request-id'])
+        request.set_ops(request_data['ops'])
+
+    return request
+
+
+def get_request_states(request, relation='ceph'):
+    """Return a dict of requests per relation id with their corresponding
+       completion state.
+
+    This allows a charm, which has a request for ceph, to see whether there is
+    an equivalent request already being processed and if so what state that
+    request is in.
+
+    @param request: A CephBrokerRq object
+    """
+    complete = []
+    requests = {}
+    for rid in relation_ids(relation):
+        complete = False
+        previous_request = get_previous_request(rid)
+        if request == previous_request:
+            sent = True
+            complete = is_request_complete_for_rid(previous_request, rid)
+        else:
+            sent = False
+            complete = False
+
+        requests[rid] = {
+            'sent': sent,
+            'complete': complete,
+        }
+
+    return requests
+
+
+def is_request_sent(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been sent
+
+    Returns True if a similair request has been sent
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['sent']:
+            return False
+
+    return True
+
+
+def is_request_complete(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been
+    completed
+
+    Returns True if a similair request has been completed
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['complete']:
+            return False
+
+    return True
+
+
+def is_request_complete_for_rid(request, rid):
+    """Check if a given request has been completed on the given relation
+
+    @param request: A CephBrokerRq object
+    @param rid: Relation ID
+    """
+    broker_key = get_broker_rsp_key()
+    for unit in related_units(rid):
+        rdata = relation_get(rid=rid, unit=unit)
+        if rdata.get(broker_key):
+            rsp = CephBrokerRsp(rdata.get(broker_key))
+            if rsp.request_id == request.request_id:
+                if not rsp.exit_code:
+                    return True
+        else:
+            # The remote unit sent no reply targeted at this unit so either the
+            # remote ceph cluster does not support unit targeted replies or it
+            # has not processed our request yet.
+            if rdata.get('broker_rsp'):
+                request_data = json.loads(rdata['broker_rsp'])
+                if request_data.get('request-id'):
+                    log('Ignoring legacy broker_rsp without unit key as remote '
+                        'service supports unit specific replies', level=DEBUG)
+                else:
+                    log('Using legacy broker_rsp as remote service does not '
+                        'supports unit specific replies', level=DEBUG)
+                    rsp = CephBrokerRsp(rdata['broker_rsp'])
+                    if not rsp.exit_code:
+                        return True
+
+    return False
+
+
+def get_broker_rsp_key():
+    """Return broker response key for this unit
+
+    This is the key that ceph is going to use to pass request status
+    information back to this unit
+    """
+    return 'broker-rsp-' + local_unit().replace('/', '-')
+
+
+def send_request_if_needed(request, relation='ceph'):
+    """Send broker request if an equivalent request has not already been sent
+
+    @param request: A CephBrokerRq object
+    """
+    if is_request_sent(request, relation=relation):
+        log('Request already sent but not complete, not sending new request',
+            level=DEBUG)
+    else:
+        for rid in relation_ids(relation):
+            log('Sending request {}'.format(request.request_id), level=DEBUG)
+            relation_set(relation_id=rid, broker_req=request.request)
+
+
+def has_broker_rsp(rid=None, unit=None):
+    """Return True if the broker_rsp key is 'truthy' (i.e. set to something) in the relation data.
+
+    :param rid: The relation to check (default of None means current relation)
+    :type rid: Union[str, None]
+    :param unit: The remote unit to check (default of None means current unit)
+    :type unit: Union[str, None]
+    :returns: True if broker key exists and is set to something 'truthy'
+    :rtype: bool
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    return True if broker_rsp else False
+
+
+def is_broker_action_done(action, rid=None, unit=None):
+    """Check whether broker action has completed yet.
+
+    @param action: name of action to be performed
+    @returns True if action complete otherwise False
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return False
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    val = kvstore.get(key=key)
+    if val and val == rsp.request_id:
+        return True
+
+    return False
+
+
+def mark_broker_action_done(action, rid=None, unit=None):
+    """Mark action as having been completed.
+
+    @param action: name of action to be performed
+    @returns None
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    kvstore.set(key=key, value=rsp.request_id)
+    kvstore.flush()
+
+
+class CephConfContext(object):
+    """Ceph config (ceph.conf) context.
+
+    Supports user-provided Ceph configuration settings. Use can provide a
+    dictionary as the value for the config-flags charm option containing
+    Ceph configuration settings keyede by their section in ceph.conf.
+    """
+    def __init__(self, permitted_sections=None):
+        self.permitted_sections = permitted_sections or []
+
+    def __call__(self):
+        conf = config('config-flags')
+        if not conf:
+            return {}
+
+        conf = config_flags_parser(conf)
+        if not isinstance(conf, dict):
+            log("Provided config-flags is not a dictionary - ignoring",
+                level=WARNING)
+            return {}
+
+        permitted = self.permitted_sections
+        if permitted:
+            diff = set(conf.keys()).difference(set(permitted))
+            if diff:
+                log("Config-flags contains invalid keys '%s' - they will be "
+                    "ignored" % (', '.join(diff)), level=WARNING)
+
+        ceph_conf = {}
+        for key in conf:
+            if permitted and key not in permitted:
+                log("Ignoring key '%s'" % key, level=WARNING)
+                continue
+
+            ceph_conf[key] = conf[key]
+        return ceph_conf
+
+
+class CephOSDConfContext(CephConfContext):
+    """Ceph config (ceph.conf) context.
+
+    Consolidates settings from config-flags via CephConfContext with
+    settings provided by the mons. The config-flag values are preserved in
+    conf['osd'], settings from the mons which do not clash with config-flag
+    settings are in conf['osd_from_client'] and finally settings which do
+    clash are in conf['osd_from_client_conflict']. Rather than silently drop
+    the conflicting settings they are provided in the context so they can be
+    rendered commented out to give some visability to the admin.
+    """
+
+    def __init__(self, permitted_sections=None):
+        super(CephOSDConfContext, self).__init__(
+            permitted_sections=permitted_sections)
+        try:
+            self.settings_from_mons = get_osd_settings('mon')
+        except OSDSettingConflict:
+            log(
+                "OSD settings from mons are inconsistent, ignoring them",
+                level=WARNING)
+            self.settings_from_mons = {}
+
+    def filter_osd_from_mon_settings(self):
+        """Filter settings from client relation against config-flags.
+
+        :returns: A tuple (
+            ,config-flag values,
+            ,client settings which do not conflict with config-flag values,
+            ,client settings which confilct with config-flag values)
+        :rtype: (OrderedDict, OrderedDict, OrderedDict)
+        """
+        ceph_conf = super(CephOSDConfContext, self).__call__()
+        conflicting_entries = {}
+        clear_entries = {}
+        for key, value in self.settings_from_mons.items():
+            if key in ceph_conf.get('osd', {}):
+                if ceph_conf['osd'][key] != value:
+                    conflicting_entries[key] = value
+            else:
+                clear_entries[key] = value
+        clear_entries = _order_dict_by_key(clear_entries)
+        conflicting_entries = _order_dict_by_key(conflicting_entries)
+        return ceph_conf, clear_entries, conflicting_entries
+
+    def __call__(self):
+        """Construct OSD config context.
+
+        Standard context with two additional special keys.
+            osd_from_client_conflict: client settings which confilct with
+                                      config-flag values
+            osd_from_client: settings which do not conflict with config-flag
+                             values
+
+        :returns: OSD config context dict.
+        :rtype: dict
+        """
+        conf, osd_clear, osd_conflict = self.filter_osd_from_mon_settings()
+        conf['osd_from_client_conflict'] = osd_conflict
+        conf['osd_from_client'] = osd_clear
+        return conf
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/loopback.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/loopback.py
new file mode 100644
index 0000000000000000000000000000000000000000..74bab40e43a978e3d9e1e2f9c8975368092145c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/loopback.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from subprocess import (
+    check_call,
+    check_output,
+)
+
+import six
+
+
+##################################################
+# loopback device helpers.
+##################################################
+def loopback_devices():
+    '''
+    Parse through 'losetup -a' output to determine currently mapped
+    loopback devices. Output is expected to look like:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img)
+
+    or:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img (deleted))
+
+    :returns: dict: a dict mapping {loopback_dev: backing_file}
+    '''
+    loopbacks = {}
+    cmd = ['losetup', '-a']
+    output = check_output(cmd)
+    if six.PY3:
+        output = output.decode('utf-8')
+    devs = [d.strip().split(' ', 2) for d in output.splitlines() if d != '']
+    for dev, _, f in devs:
+        loopbacks[dev.replace(':', '')] = re.search(r'\((.+)\)', f).groups()[0]
+    return loopbacks
+
+
+def create_loopback(file_path):
+    '''
+    Create a loopback device for a given backing file.
+
+    :returns: str: Full path to new loopback device (eg, /dev/loop0)
+    '''
+    file_path = os.path.abspath(file_path)
+    check_call(['losetup', '--find', file_path])
+    for d, f in six.iteritems(loopback_devices()):
+        if f == file_path:
+            return d
+
+
+def ensure_loopback_device(path, size):
+    '''
+    Ensure a loopback device exists for a given backing file path and size.
+    If it a loopback device is not mapped to file, a new one will be created.
+
+    TODO: Confirm size of found loopback device.
+
+    :returns: str: Full path to the ensured loopback device (eg, /dev/loop0)
+    '''
+    for d, f in six.iteritems(loopback_devices()):
+        if f == path:
+            return d
+
+    if not os.path.exists(path):
+        cmd = ['truncate', '--size', size, path]
+        check_call(cmd)
+
+    return create_loopback(path)
+
+
+def is_mapped_loopback_device(device):
+    """
+    Checks if a given device name is an existing/mapped loopback device.
+    :param device: str: Full path to the device (eg, /dev/loop1).
+    :returns: str: Path to the backing file if is a loopback device
+    empty string otherwise
+    """
+    return loopback_devices().get(device, "")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/lvm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/lvm.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8bde69263f0e917d32d0e5d70abba1409b26012
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/lvm.py
@@ -0,0 +1,182 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    Popen,
+    PIPE,
+)
+
+
+##################################################
+# LVM helpers.
+##################################################
+def deactivate_lvm_volume_group(block_device):
+    '''
+    Deactivate any volume gruop associated with an LVM physical volume.
+
+    :param block_device: str: Full path to LVM physical volume
+    '''
+    vg = list_lvm_volume_group(block_device)
+    if vg:
+        cmd = ['vgchange', '-an', vg]
+        check_call(cmd)
+
+
+def is_lvm_physical_volume(block_device):
+    '''
+    Determine whether a block device is initialized as an LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: boolean: True if block device is a PV, False if not.
+    '''
+    try:
+        check_output(['pvdisplay', block_device])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def remove_lvm_physical_volume(block_device):
+    '''
+    Remove LVM PV signatures from a given block device.
+
+    :param block_device: str: Full path of block device to scrub.
+    '''
+    p = Popen(['pvremove', '-ff', block_device],
+              stdin=PIPE)
+    p.communicate(input='y\n')
+
+
+def list_lvm_volume_group(block_device):
+    '''
+    List LVM volume group associated with a given block device.
+
+    Assumes block device is a valid LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: str: Name of volume group associated with block device or None
+    '''
+    vg = None
+    pvd = check_output(['pvdisplay', block_device]).splitlines()
+    for lvm in pvd:
+        lvm = lvm.decode('UTF-8')
+        if lvm.strip().startswith('VG Name'):
+            vg = ' '.join(lvm.strip().split()[2:])
+    return vg
+
+
+def create_lvm_physical_volume(block_device):
+    '''
+    Initialize a block device as an LVM physical volume.
+
+    :param block_device: str: Full path of block device to initialize.
+
+    '''
+    check_call(['pvcreate', block_device])
+
+
+def create_lvm_volume_group(volume_group, block_device):
+    '''
+    Create an LVM volume group backed by a given block device.
+
+    Assumes block device has already been initialized as an LVM PV.
+
+    :param volume_group: str: Name of volume group to create.
+    :block_device: str: Full path of PV-initialized block device.
+    '''
+    check_call(['vgcreate', volume_group, block_device])
+
+
+def list_logical_volumes(select_criteria=None, path_mode=False):
+    '''
+    List logical volumes
+
+    :param select_criteria: str: Limit list to those volumes matching this
+                                 criteria (see 'lvs -S help' for more details)
+    :param path_mode: bool: return logical volume name in 'vg/lv' format, this
+                            format is required for some commands like lvextend
+    :returns: [str]: List of logical volumes
+    '''
+    lv_diplay_attr = 'lv_name'
+    if path_mode:
+        # Parsing output logic relies on the column order
+        lv_diplay_attr = 'vg_name,' + lv_diplay_attr
+    cmd = ['lvs', '--options', lv_diplay_attr, '--noheadings']
+    if select_criteria:
+        cmd.extend(['--select', select_criteria])
+    lvs = []
+    for lv in check_output(cmd).decode('UTF-8').splitlines():
+        if not lv:
+            continue
+        if path_mode:
+            lvs.append('/'.join(lv.strip().split()))
+        else:
+            lvs.append(lv.strip())
+    return lvs
+
+
+list_thin_logical_volume_pools = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^t')
+
+list_thin_logical_volumes = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^V')
+
+
+def extend_logical_volume_by_device(lv_name, block_device):
+    '''
+    Extends the size of logical volume lv_name by the amount of free space on
+    physical volume block_device.
+
+    :param lv_name: str: name of logical volume to be extended (vg/lv format)
+    :param block_device: str: name of block_device to be allocated to lv_name
+    '''
+    cmd = ['lvextend', lv_name, block_device]
+    check_call(cmd)
+
+
+def create_logical_volume(lv_name, volume_group, size=None):
+    '''
+    Create a new logical volume in an existing volume group
+
+    :param lv_name: str: name of logical volume to be created.
+    :param volume_group: str: Name of volume group to use for the new volume.
+    :param size: str: Size of logical volume to create (100% if not supplied)
+    :raises subprocess.CalledProcessError: in the event that the lvcreate fails.
+    '''
+    if size:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-L',
+            '{}'.format(size),
+            '-n', lv_name, volume_group
+        ])
+    # create the lv with all the space available, this is needed because the
+    # system call is different for LVM
+    else:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-l',
+            '100%FREE',
+            '-n', lv_name, volume_group
+        ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a35617606cf52d7cffc04ac245811b770fd95e8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/storage/linux/utils.py
@@ -0,0 +1,128 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from stat import S_ISBLK
+
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    call
+)
+
+
+def _luks_uuid(dev):
+    """
+    Check to see if dev is a LUKS encrypted volume, returning the UUID
+    of volume if it is.
+
+    :param: dev: path to block device to check.
+    :returns: str. UUID of LUKS device or None if not a LUKS device
+    """
+    try:
+        cmd = ['cryptsetup', 'luksUUID', dev]
+        return check_output(cmd).decode('UTF-8').strip()
+    except CalledProcessError:
+        return None
+
+
+def is_luks_device(dev):
+    """
+    Determine if dev is a LUKS-formatted block device.
+
+    :param: dev: A full path to a block device to check for LUKS header
+    presence
+    :returns: boolean: indicates whether a device is used based on LUKS header.
+    """
+    return True if _luks_uuid(dev) else False
+
+
+def is_mapped_luks_device(dev):
+    """
+    Determine if dev is a mapped LUKS device
+    :param: dev: A full path to a block device to be checked
+    :returns: boolean: indicates whether a device is mapped
+    """
+    _, dirs, _ = next(os.walk(
+        '/sys/class/block/{}/holders/'
+        .format(os.path.basename(os.path.realpath(dev))))
+    )
+    is_held = len(dirs) > 0
+    return is_held and is_luks_device(dev)
+
+
+def is_block_device(path):
+    '''
+    Confirm device at path is a valid block device node.
+
+    :returns: boolean: True if path is a block device, False if not.
+    '''
+    if not os.path.exists(path):
+        return False
+    return S_ISBLK(os.stat(path).st_mode)
+
+
+def zap_disk(block_device):
+    '''
+    Clear a block device of partition table. Relies on sgdisk, which is
+    installed as pat of the 'gdisk' package in Ubuntu.
+
+    :param block_device: str: Full path of block device to clean.
+    '''
+    # https://github.com/ceph/ceph/commit/fdd7f8d83afa25c4e09aaedd90ab93f3b64a677b
+    # sometimes sgdisk exits non-zero; this is OK, dd will clean up
+    call(['sgdisk', '--zap-all', '--', block_device])
+    call(['sgdisk', '--clear', '--mbrtogpt', '--', block_device])
+    dev_end = check_output(['blockdev', '--getsz',
+                            block_device]).decode('UTF-8')
+    gpt_end = int(dev_end.split()[0]) - 100
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=1M', 'count=1'])
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=512', 'count=100', 'seek=%s' % (gpt_end)])
+
+
+def is_device_mounted(device):
+    '''Given a device path, return True if that device is mounted, and False
+    if it isn't.
+
+    :param device: str: Full path of the device to check.
+    :returns: boolean: True if the path represents a mounted device, False if
+        it doesn't.
+    '''
+    try:
+        out = check_output(['lsblk', '-P', device]).decode('UTF-8')
+    except Exception:
+        return False
+    return bool(re.search(r'MOUNTPOINT=".+"', out))
+
+
+def mkfs_xfs(device, force=False, inode_size=1024):
+    """Format device with XFS filesystem.
+
+    By default this should fail if the device already has a filesystem on it.
+    :param device: Full path to device to format
+    :ptype device: tr
+    :param force: Force operation
+    :ptype: force: boolean
+    :param inode_size: XFS inode size in bytes
+    :ptype inode_size: int"""
+    cmd = ['mkfs.xfs']
+    if force:
+        cmd.append("-f")
+
+    cmd += ['-i', "size={}".format(inode_size), device]
+    check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/contexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/contexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1adf94b133f41a168727a3cdd3a536633ff62b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/contexts.py
@@ -0,0 +1,137 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""A helper to create a yaml cache of config with namespaced relation data."""
+import os
+import yaml
+
+import six
+
+import charmhelpers.core.hookenv
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+
+
+def dict_keys_without_hyphens(a_dict):
+    """Return the a new dict with underscores instead of hyphens in keys."""
+    return dict(
+        (key.replace('-', '_'), val) for key, val in a_dict.items())
+
+
+def update_relations(context, namespace_separator=':'):
+    """Update the context with the relation data."""
+    # Add any relation data prefixed with the relation type.
+    relation_type = charmhelpers.core.hookenv.relation_type()
+    relations = []
+    context['current_relation'] = {}
+    if relation_type is not None:
+        relation_data = charmhelpers.core.hookenv.relation_get()
+        context['current_relation'] = relation_data
+        # Deprecated: the following use of relation data as keys
+        # directly in the context will be removed.
+        relation_data = dict(
+            ("{relation_type}{namespace_separator}{key}".format(
+                relation_type=relation_type,
+                key=key,
+                namespace_separator=namespace_separator), val)
+            for key, val in relation_data.items())
+        relation_data = dict_keys_without_hyphens(relation_data)
+        context.update(relation_data)
+        relations = charmhelpers.core.hookenv.relations_of_type(relation_type)
+        relations = [dict_keys_without_hyphens(rel) for rel in relations]
+
+    context['relations_full'] = charmhelpers.core.hookenv.relations()
+
+    # the hookenv.relations() data structure is effectively unusable in
+    # templates and other contexts when trying to access relation data other
+    # than the current relation. So provide a more useful structure that works
+    # with any hook.
+    local_unit = charmhelpers.core.hookenv.local_unit()
+    relations = {}
+    for rname, rids in context['relations_full'].items():
+        relations[rname] = []
+        for rid, rdata in rids.items():
+            data = rdata.copy()
+            if local_unit in rdata:
+                data.pop(local_unit)
+            for unit_name, rel_data in data.items():
+                new_data = {'__relid__': rid, '__unit__': unit_name}
+                new_data.update(rel_data)
+                relations[rname].append(new_data)
+    context['relations'] = relations
+
+
+def juju_state_to_yaml(yaml_path, namespace_separator=':',
+                       allow_hyphens_in_keys=True, mode=None):
+    """Update the juju config and state in a yaml file.
+
+    This includes any current relation-get data, and the charm
+    directory.
+
+    This function was created for the ansible and saltstack
+    support, as those libraries can use a yaml file to supply
+    context to templates, but it may be useful generally to
+    create and update an on-disk cache of all the config, including
+    previous relation data.
+
+    By default, hyphens are allowed in keys as this is supported
+    by yaml, but for tools like ansible, hyphens are not valid [1].
+
+    [1] http://www.ansibleworks.com/docs/playbooks_variables.html#what-makes-a-valid-variable-name
+    """
+    config = charmhelpers.core.hookenv.config()
+
+    # Add the charm_dir which we will need to refer to charm
+    # file resources etc.
+    config['charm_dir'] = charm_dir
+    config['local_unit'] = charmhelpers.core.hookenv.local_unit()
+    config['unit_private_address'] = charmhelpers.core.hookenv.unit_private_ip()
+    config['unit_public_address'] = charmhelpers.core.hookenv.unit_get(
+        'public-address'
+    )
+
+    # Don't use non-standard tags for unicode which will not
+    # work when salt uses yaml.load_safe.
+    yaml.add_representer(six.text_type,
+                         lambda dumper, value: dumper.represent_scalar(
+                             six.u('tag:yaml.org,2002:str'), value))
+
+    yaml_dir = os.path.dirname(yaml_path)
+    if not os.path.exists(yaml_dir):
+        os.makedirs(yaml_dir)
+
+    if os.path.exists(yaml_path):
+        with open(yaml_path, "r") as existing_vars_file:
+            existing_vars = yaml.load(existing_vars_file.read())
+    else:
+        with open(yaml_path, "w+"):
+            pass
+        existing_vars = {}
+
+    if mode is not None:
+        os.chmod(yaml_path, mode)
+
+    if not allow_hyphens_in_keys:
+        config = dict_keys_without_hyphens(config)
+    existing_vars.update(config)
+
+    update_relations(existing_vars, namespace_separator)
+
+    with open(yaml_path, "w+") as fp:
+        fp.write(yaml.dump(existing_vars, default_flow_style=False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/jinja.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/jinja.py
new file mode 100644
index 0000000000000000000000000000000000000000..38d4fba0e651399064a14112398a0ef43717f5cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/jinja.py
@@ -0,0 +1,38 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Templating using the python-jinja2 package.
+"""
+import six
+from charmhelpers.fetch import apt_install, apt_update
+try:
+    import jinja2
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY3:
+        apt_install(["python3-jinja2"], fatal=True)
+    else:
+        apt_install(["python-jinja2"], fatal=True)
+    import jinja2
+
+
+DEFAULT_TEMPLATES_DIR = 'templates'
+
+
+def render(template_name, context, template_dir=DEFAULT_TEMPLATES_DIR):
+    templates = jinja2.Environment(
+        loader=jinja2.FileSystemLoader(template_dir))
+    template = templates.get_template(template_name)
+    return template.render(context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/pyformat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/pyformat.py
new file mode 100644
index 0000000000000000000000000000000000000000..51a24dc42379fbee88d8952c578fc2498c852b0b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/templating/pyformat.py
@@ -0,0 +1,27 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Templating using standard Python str.format() method.
+'''
+
+from charmhelpers.core import hookenv
+
+
+def render(template, extra={}, **kwargs):
+    """Return the template rendered using Python's str.format()."""
+    context = hookenv.execution_environment()
+    context.update(extra)
+    context.update(kwargs)
+    return template.format(**context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/unison/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/unison/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61409b14c843766aa10cb957bb1c3d83ba87c6a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/contrib/unison/__init__.py
@@ -0,0 +1,314 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Easy file synchronization among peer units using ssh + unison.
+#
+# For the -joined, -changed, and -departed peer relations, add a call to
+# ssh_authorized_peers() describing the peer relation and the desired
+# user + group.  After all peer relations have settled, all hosts should
+# be able to connect to on another via key auth'd ssh as the specified user.
+#
+# Other hooks are then free to synchronize files and directories using
+# sync_to_peers().
+#
+# For a peer relation named 'cluster', for example:
+#
+# cluster-relation-joined:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-changed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-departed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# Hooks are now free to sync files as easily as:
+#
+# files = ['/etc/fstab', '/etc/apt.conf.d/']
+# sync_to_peers(peer_interface='cluster',
+#                user='juju_ssh, paths=[files])
+#
+# It is assumed the charm itself has setup permissions on each unit
+# such that 'juju_ssh' has read + write permissions.  Also assumed
+# that the calling charm takes care of leader delegation.
+#
+# Additionally files can be synchronized only to an specific unit:
+# sync_to_peer(slave_address, user='juju_ssh',
+#              paths=[files], verbose=False)
+
+import os
+import pwd
+
+from copy import copy
+from subprocess import check_call, check_output
+
+from charmhelpers.core.host import (
+    adduser,
+    add_user_to_group,
+    pwgen,
+    remove_password_expiry,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    hook_name,
+    relation_ids,
+    related_units,
+    relation_set,
+    relation_get,
+    unit_private_ip,
+    INFO,
+    ERROR,
+)
+
+BASE_CMD = ['unison', '-auto', '-batch=true', '-confirmbigdel=false',
+            '-fastcheck=true', '-group=false', '-owner=false',
+            '-prefer=newer', '-times=true']
+
+
+def get_homedir(user):
+    try:
+        user = pwd.getpwnam(user)
+        return user.pw_dir
+    except KeyError:
+        log('Could not get homedir for user %s: user exists?' % (user), ERROR)
+        raise Exception
+
+
+def create_private_key(user, priv_key_path, key_type='rsa'):
+    types_bits = {
+        'rsa': '2048',
+        'ecdsa': '521',
+    }
+    if key_type not in types_bits:
+        log('Unknown ssh key type {}, using rsa'.format(key_type), ERROR)
+        key_type = 'rsa'
+    if not os.path.isfile(priv_key_path):
+        log('Generating new SSH key for user %s.' % user)
+        cmd = ['ssh-keygen', '-q', '-N', '', '-t', key_type,
+               '-b', types_bits[key_type], '-f', priv_key_path]
+        check_call(cmd)
+    else:
+        log('SSH key already exists at %s.' % priv_key_path)
+    check_call(['chown', user, priv_key_path])
+    check_call(['chmod', '0600', priv_key_path])
+
+
+def create_public_key(user, priv_key_path, pub_key_path):
+    if not os.path.isfile(pub_key_path):
+        log('Generating missing ssh public key @ %s.' % pub_key_path)
+        cmd = ['ssh-keygen', '-y', '-f', priv_key_path]
+        p = check_output(cmd).strip()
+        with open(pub_key_path, 'wb') as out:
+            out.write(p)
+    check_call(['chown', user, pub_key_path])
+
+
+def get_keypair(user):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    priv_key = os.path.join(ssh_dir, 'id_rsa')
+    pub_key = '%s.pub' % priv_key
+
+    if not os.path.isdir(ssh_dir):
+        os.mkdir(ssh_dir)
+        check_call(['chown', '-R', user, ssh_dir])
+
+    create_private_key(user, priv_key)
+    create_public_key(user, priv_key, pub_key)
+
+    with open(priv_key, 'r') as p:
+        _priv = p.read().strip()
+
+    with open(pub_key, 'r') as p:
+        _pub = p.read().strip()
+
+    return (_priv, _pub)
+
+
+def write_authorized_keys(user, keys):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    auth_keys = os.path.join(ssh_dir, 'authorized_keys')
+    log('Syncing authorized_keys @ %s.' % auth_keys)
+    with open(auth_keys, 'w') as out:
+        for k in keys:
+            out.write('%s\n' % k)
+
+
+def write_known_hosts(user, hosts):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    known_hosts = os.path.join(ssh_dir, 'known_hosts')
+    khosts = []
+    for host in hosts:
+        cmd = ['ssh-keyscan', host]
+        remote_key = check_output(cmd, universal_newlines=True).strip()
+        khosts.append(remote_key)
+    log('Syncing known_hosts @ %s.' % known_hosts)
+    with open(known_hosts, 'w') as out:
+        for host in khosts:
+            out.write('%s\n' % host)
+
+
+def ensure_user(user, group=None):
+    adduser(user, pwgen())
+    if group:
+        add_user_to_group(user, group)
+    # Remove password expiry (Bug #1686085)
+    remove_password_expiry(user)
+
+
+def ssh_authorized_peers(peer_interface, user, group=None,
+                         ensure_local_user=False):
+    """
+    Main setup function, should be called from both peer -changed and -joined
+    hooks with the same parameters.
+    """
+    if ensure_local_user:
+        ensure_user(user, group)
+    priv_key, pub_key = get_keypair(user)
+    hook = hook_name()
+    if hook == '%s-relation-joined' % peer_interface:
+        relation_set(ssh_pub_key=pub_key)
+    elif hook == '%s-relation-changed' % peer_interface or \
+            hook == '%s-relation-departed' % peer_interface:
+        hosts = []
+        keys = []
+
+        for r_id in relation_ids(peer_interface):
+            for unit in related_units(r_id):
+                ssh_pub_key = relation_get('ssh_pub_key',
+                                           rid=r_id,
+                                           unit=unit)
+                priv_addr = relation_get('private-address',
+                                         rid=r_id,
+                                         unit=unit)
+                if ssh_pub_key:
+                    keys.append(ssh_pub_key)
+                    hosts.append(priv_addr)
+                else:
+                    log('ssh_authorized_peers(): ssh_pub_key '
+                        'missing for unit %s, skipping.' % unit)
+        write_authorized_keys(user, keys)
+        write_known_hosts(user, hosts)
+        authed_hosts = ':'.join(hosts)
+        relation_set(ssh_authorized_hosts=authed_hosts)
+
+
+def _run_as_user(user, gid=None):
+    try:
+        user = pwd.getpwnam(user)
+    except KeyError:
+        log('Invalid user: %s' % user)
+        raise Exception
+    uid = user.pw_uid
+    gid = gid or user.pw_gid
+    os.environ['HOME'] = user.pw_dir
+
+    def _inner():
+        os.setgid(gid)
+        os.setuid(uid)
+    return _inner
+
+
+def run_as_user(user, cmd, gid=None):
+    return check_output(cmd, preexec_fn=_run_as_user(user, gid), cwd='/')
+
+
+def collect_authed_hosts(peer_interface):
+    '''Iterate through the units on peer interface to find all that
+    have the calling host in its authorized hosts list'''
+    hosts = []
+    for r_id in (relation_ids(peer_interface) or []):
+        for unit in related_units(r_id):
+            private_addr = relation_get('private-address',
+                                        rid=r_id, unit=unit)
+            authed_hosts = relation_get('ssh_authorized_hosts',
+                                        rid=r_id, unit=unit)
+
+            if not authed_hosts:
+                log('Peer %s has not authorized *any* hosts yet, skipping.' %
+                    (unit), level=INFO)
+                continue
+
+            if unit_private_ip() in authed_hosts.split(':'):
+                hosts.append(private_addr)
+            else:
+                log('Peer %s has not authorized *this* host yet, skipping.' %
+                    (unit), level=INFO)
+    return hosts
+
+
+def sync_path_to_host(path, host, user, verbose=False, cmd=None, gid=None,
+                      fatal=False):
+    """Sync path to an specific peer host
+
+    Propagates exception if operation fails and fatal=True.
+    """
+    cmd = cmd or copy(BASE_CMD)
+    if not verbose:
+        cmd.append('-silent')
+
+    # removing trailing slash from directory paths, unison
+    # doesn't like these.
+    if path.endswith('/'):
+        path = path[:(len(path) - 1)]
+
+    cmd = cmd + [path, 'ssh://%s@%s/%s' % (user, host, path)]
+
+    try:
+        log('Syncing local path %s to %s@%s:%s' % (path, user, host, path))
+        run_as_user(user, cmd, gid)
+    except Exception:
+        log('Error syncing remote files')
+        if fatal:
+            raise
+
+
+def sync_to_peer(host, user, paths=None, verbose=False, cmd=None, gid=None,
+                 fatal=False):
+    """Sync paths to an specific peer host
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for p in paths:
+            sync_path_to_host(p, host, user, verbose, cmd, gid, fatal)
+
+
+def sync_to_peers(peer_interface, user, paths=None, verbose=False, cmd=None,
+                  gid=None, fatal=False):
+    """Sync all hosts to an specific path
+
+    The type of group is integer, it allows user has permissions to
+    operate a directory have a different group id with the user id.
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for host in collect_authed_hosts(peer_interface):
+            sync_to_peer(host, user, paths, verbose, cmd, gid, fatal)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/coordinator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/coordinator.py
new file mode 100644
index 0000000000000000000000000000000000000000..59bee3e5b320f6bffa0d89eef7a20888cddb0521
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/coordinator.py
@@ -0,0 +1,606 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+The coordinator module allows you to use Juju's leadership feature to
+coordinate operations between units of a service.
+
+Behavior is defined in subclasses of coordinator.BaseCoordinator.
+One implementation is provided (coordinator.Serial), which allows an
+operation to be run on a single unit at a time, on a first come, first
+served basis. You can trivially define more complex behavior by
+subclassing BaseCoordinator or Serial.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+
+
+Services Framework Usage
+========================
+
+Ensure a peers relation is defined in metadata.yaml. Instantiate a
+BaseCoordinator subclass before invoking ServiceManager.manage().
+Ensure that ServiceManager.manage() is wired up to the leader-elected,
+leader-settings-changed, peers relation-changed and peers
+relation-departed hooks in addition to any other hooks you need, or your
+service will deadlock.
+
+Ensure calls to acquire() are guarded, so that locks are only requested
+when they are really needed (and thus hooks only triggered when necessary).
+Failing to do this and calling acquire() unconditionally will put your unit
+into a hook loop. Calls to granted() do not need to be guarded.
+
+For example::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    def maybe_restart(servicename):
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart')
+        if serial.granted('restart'):
+            hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before manager.manage()
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+You can implement a similar pattern using a decorator. If the lock has
+not been granted, an attempt to acquire() it will be made if the guard
+function returns True. If the lock has been granted, the decorated function
+is run as normal::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    serial = coordinator.Serial()  # Global, instatiated on module import.
+
+    def needs_restart():
+        [ ... Introspect state. Return True if restart is needed ... ]
+
+    @serial.require('restart', needs_restart)
+    def maybe_restart(servicename):
+        hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+Traditional Usage
+=================
+
+Ensure a peers relation is defined in metadata.yaml.
+
+If you are using charmhelpers.core.hookenv.Hooks, ensure that a
+BaseCoordinator subclass is instantiated before calling Hooks.execute.
+
+If you are not using charmhelpers.core.hookenv.Hooks, ensure
+that a BaseCoordinator subclass is instantiated and its handle()
+method called at the start of all your hooks.
+
+For example::
+
+    import sys
+    from charmhelpers.core import hookenv
+    from charmhelpers import coordinator
+
+    hooks = hookenv.Hooks()
+
+    def maybe_restart():
+        serial = coordinator.Serial()
+        if serial.granted('restart'):
+            hookenv.service_restart('myservice')
+
+    @hooks.hook
+    def config_changed():
+        update_config()
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart'):
+            maybe_restart()
+
+    # Cluster hooks must be wired up.
+    @hooks.hook('cluster-relation-changed', 'cluster-relation-departed')
+    def cluster_relation_changed():
+        maybe_restart()
+
+    # Leader hooks must be wired up.
+    @hooks.hook('leader-elected', 'leader-settings-changed')
+    def leader_settings_changed():
+        maybe_restart()
+
+    [ ... repeat for *all* other hooks you are using ... ]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before execute()
+        hooks.execute(sys.argv)
+
+
+You can also use the require decorator. If the lock has not been granted,
+an attempt to acquire() it will be made if the guard function returns True.
+If the lock has been granted, the decorated function is run as normal::
+
+    from charmhelpers.core import hookenv
+
+    hooks = hookenv.Hooks()
+    serial = coordinator.Serial()  # Must instantiate before execute()
+
+    @require('restart', needs_restart)
+    def maybe_restart():
+        hookenv.service_restart('myservice')
+
+    @hooks.hook('install', 'config-changed', 'upgrade-charm',
+                # Peers and leader hooks must be wired up.
+                'cluster-relation-changed', 'cluster-relation-departed',
+                'leader-elected', 'leader-settings-changed')
+    def default_hook():
+        [...]
+        maybe_restart()
+
+    if __name__ == '__main__':
+        hooks.execute()
+
+
+Details
+=======
+
+A simple API is provided similar to traditional locking APIs. A lock
+may be requested using the acquire() method, and the granted() method
+may be used do to check if a lock previously requested by acquire() has
+been granted. It doesn't matter how many times acquire() is called in a
+hook.
+
+Locks are released at the end of the hook they are acquired in. This may
+be the current hook if the unit is leader and the lock is free. It is
+more likely a future hook (probably leader-settings-changed, possibly
+the peers relation-changed or departed hook, potentially any hook).
+
+Whenever a charm needs to perform a coordinated action it will acquire()
+the lock and perform the action immediately if acquisition is
+successful. It will also need to perform the same action in every other
+hook if the lock has been granted.
+
+
+Grubby Details
+--------------
+
+Why do you need to be able to perform the same action in every hook?
+If the unit is the leader, then it may be able to grant its own lock
+and perform the action immediately in the source hook. If the unit is
+the leader and cannot immediately grant the lock, then its only
+guaranteed chance of acquiring the lock is in the peers relation-joined,
+relation-changed or peers relation-departed hooks when another unit has
+released it (the only channel to communicate to the leader is the peers
+relation). If the unit is not the leader, then it is unlikely the lock
+is granted in the source hook (a previous hook must have also made the
+request for this to happen). A non-leader is notified about the lock via
+leader settings. These changes may be visible in any hook, even before
+the leader-settings-changed hook has been invoked. Or the requesting
+unit may be promoted to leader after making a request, in which case the
+lock may be granted in leader-elected or in a future peers
+relation-changed or relation-departed hook.
+
+This could be simpler if leader-settings-changed was invoked on the
+leader. We could then never grant locks except in
+leader-settings-changed hooks giving one place for the operation to be
+performed. Unfortunately this is not the case with Juju 1.23 leadership.
+
+But of course, this doesn't really matter to most people as most people
+seem to prefer the Services Framework or similar reset-the-world
+approaches, rather than the twisty maze of attempting to deduce what
+should be done based on what hook happens to be running (which always
+seems to evolve into reset-the-world anyway when the charm grows beyond
+the trivial).
+
+I chose not to implement a callback model, where a callback was passed
+to acquire to be executed when the lock is granted, because the callback
+may become invalid between making the request and the lock being granted
+due to an upgrade-charm being run in the interim. And it would create
+restrictions, such no lambdas, callback defined at the top level of a
+module, etc. Still, we could implement it on top of what is here, eg.
+by adding a defer decorator that stores a pickle of itself to disk and
+have BaseCoordinator unpickle and execute them when the locks are granted.
+'''
+from datetime import datetime
+from functools import wraps
+import json
+import os.path
+
+from six import with_metaclass
+
+from charmhelpers.core import hookenv
+
+
+# We make BaseCoordinator and subclasses singletons, so that if we
+# need to spill to local storage then only a single instance does so,
+# rather than having multiple instances stomp over each other.
+class Singleton(type):
+    _instances = {}
+
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super(Singleton, cls).__call__(*args,
+                                                                 **kwargs)
+        return cls._instances[cls]
+
+
+class BaseCoordinator(with_metaclass(Singleton, object)):
+    relid = None  # Peer relation-id, set by __init__
+    relname = None
+
+    grants = None  # self.grants[unit][lock] == timestamp
+    requests = None  # self.requests[unit][lock] == timestamp
+
+    def __init__(self, relation_key='coordinator', peer_relation_name=None):
+        '''Instatiate a Coordinator.
+
+        Data is stored on the peers relation and in leadership storage
+        under the provided relation_key.
+
+        The peers relation is identified by peer_relation_name, and defaults
+        to the first one found in metadata.yaml.
+        '''
+        # Most initialization is deferred, since invoking hook tools from
+        # the constructor makes testing hard.
+        self.key = relation_key
+        self.relname = peer_relation_name
+        hookenv.atstart(self.initialize)
+
+        # Ensure that handle() is called, without placing that burden on
+        # the charm author. They still need to do this manually if they
+        # are not using a hook framework.
+        hookenv.atstart(self.handle)
+
+    def initialize(self):
+        if self.requests is not None:
+            return  # Already initialized.
+
+        assert hookenv.has_juju_version('1.23'), 'Needs Juju 1.23+'
+
+        if self.relname is None:
+            self.relname = _implicit_peer_relation_name()
+
+        relids = hookenv.relation_ids(self.relname)
+        if relids:
+            self.relid = sorted(relids)[0]
+
+        # Load our state, from leadership, the peer relationship, and maybe
+        # local state as a fallback. Populates self.requests and self.grants.
+        self._load_state()
+        self._emit_state()
+
+        # Save our state if the hook completes successfully.
+        hookenv.atexit(self._save_state)
+
+        # Schedule release of granted locks for the end of the hook.
+        # This needs to be the last of our atexit callbacks to ensure
+        # it will be run first when the hook is complete, because there
+        # is no point mutating our state after it has been saved.
+        hookenv.atexit(self._release_granted)
+
+    def acquire(self, lock):
+        '''Acquire the named lock, non-blocking.
+
+        The lock may be granted immediately, or in a future hook.
+
+        Returns True if the lock has been granted. The lock will be
+        automatically released at the end of the hook in which it is
+        granted.
+
+        Do not mindlessly call this method, as it triggers a cascade of
+        hooks. For example, if you call acquire() every time in your
+        peers relation-changed hook you will end up with an infinite loop
+        of hooks. It should almost always be guarded by some condition.
+        '''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if not ts:
+            # If there is no outstanding request on the peers relation,
+            # create one.
+            self.requests.setdefault(lock, {})
+            self.requests[unit][lock] = _timestamp()
+            self.msg('Requested {}'.format(lock))
+
+        # If the leader has granted the lock, yay.
+        if self.granted(lock):
+            self.msg('Acquired {}'.format(lock))
+            return True
+
+        # If the unit making the request also happens to be the
+        # leader, it must handle the request now. Even though the
+        # request has been stored on the peers relation, the peers
+        # relation-changed hook will not be triggered.
+        if hookenv.is_leader():
+            return self.grant(lock, unit)
+
+        return False  # Can't acquire lock, yet. Maybe next hook.
+
+    def granted(self, lock):
+        '''Return True if a previously requested lock has been granted'''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if ts and self.grants.get(unit, {}).get(lock) == ts:
+            return True
+        return False
+
+    def requested(self, lock):
+        '''Return True if we are in the queue for the lock'''
+        return lock in self.requests[hookenv.local_unit()]
+
+    def request_timestamp(self, lock):
+        '''Return the timestamp of our outstanding request for lock, or None.
+
+        Returns a datetime.datetime() UTC timestamp, with no tzinfo attribute.
+        '''
+        ts = self.requests[hookenv.local_unit()].get(lock, None)
+        if ts is not None:
+            return datetime.strptime(ts, _timestamp_format)
+
+    def handle(self):
+        if not hookenv.is_leader():
+            return  # Only the leader can grant requests.
+
+        self.msg('Leader handling coordinator requests')
+
+        # Clear our grants that have been released.
+        for unit in self.grants.keys():
+            for lock, grant_ts in list(self.grants[unit].items()):
+                req_ts = self.requests.get(unit, {}).get(lock)
+                if req_ts != grant_ts:
+                    # The request timestamp does not match the granted
+                    # timestamp. Several hooks on 'unit' may have run
+                    # before the leader got a chance to make a decision,
+                    # and 'unit' may have released its lock and attempted
+                    # to reacquire it. This will change the timestamp,
+                    # and we correctly revoke the old grant putting it
+                    # to the end of the queue.
+                    ts = datetime.strptime(self.grants[unit][lock],
+                                           _timestamp_format)
+                    del self.grants[unit][lock]
+                    self.released(unit, lock, ts)
+
+        # Grant locks
+        for unit in self.requests.keys():
+            for lock in self.requests[unit]:
+                self.grant(lock, unit)
+
+    def grant(self, lock, unit):
+        '''Maybe grant the lock to a unit.
+
+        The decision to grant the lock or not is made for $lock
+        by a corresponding method grant_$lock, which you may define
+        in a subclass. If no such method is defined, the default_grant
+        method is used. See Serial.default_grant() for details.
+        '''
+        if not hookenv.is_leader():
+            return False  # Not the leader, so we cannot grant.
+
+        # Set of units already granted the lock.
+        granted = set()
+        for u in self.grants:
+            if lock in self.grants[u]:
+                granted.add(u)
+        if unit in granted:
+            return True  # Already granted.
+
+        # Ordered list of units waiting for the lock.
+        reqs = set()
+        for u in self.requests:
+            if u in granted:
+                continue  # In the granted set. Not wanted in the req list.
+            for _lock, ts in self.requests[u].items():
+                if _lock == lock:
+                    reqs.add((ts, u))
+        queue = [t[1] for t in sorted(reqs)]
+        if unit not in queue:
+            return False  # Unit has not requested the lock.
+
+        # Locate custom logic, or fallback to the default.
+        grant_func = getattr(self, 'grant_{}'.format(lock), self.default_grant)
+
+        if grant_func(lock, unit, granted, queue):
+            # Grant the lock.
+            self.msg('Leader grants {} to {}'.format(lock, unit))
+            self.grants.setdefault(unit, {})[lock] = self.requests[unit][lock]
+            return True
+
+        return False
+
+    def released(self, unit, lock, timestamp):
+        '''Called on the leader when it has released a lock.
+
+        By default, does nothing but log messages. Override if you
+        need to perform additional housekeeping when a lock is released,
+        for example recording timestamps.
+        '''
+        interval = _utcnow() - timestamp
+        self.msg('Leader released {} from {}, held {}'.format(lock, unit,
+                                                              interval))
+
+    def require(self, lock, guard_func, *guard_args, **guard_kw):
+        """Decorate a function to be run only when a lock is acquired.
+
+        The lock is requested if the guard function returns True.
+
+        The decorated function is called if the lock has been granted.
+        """
+        def decorator(f):
+            @wraps(f)
+            def wrapper(*args, **kw):
+                if self.granted(lock):
+                    self.msg('Granted {}'.format(lock))
+                    return f(*args, **kw)
+                if guard_func(*guard_args, **guard_kw) and self.acquire(lock):
+                    return f(*args, **kw)
+                return None
+            return wrapper
+        return decorator
+
+    def msg(self, msg):
+        '''Emit a message. Override to customize log spam.'''
+        hookenv.log('coordinator.{} {}'.format(self._name(), msg),
+                    level=hookenv.INFO)
+
+    def _name(self):
+        return self.__class__.__name__
+
+    def _load_state(self):
+        self.msg('Loading state')
+
+        # All responses must be stored in the leadership settings.
+        # The leader cannot use local state, as a different unit may
+        # be leader next time. Which is fine, as the leadership
+        # settings are always available.
+        self.grants = json.loads(hookenv.leader_get(self.key) or '{}')
+
+        local_unit = hookenv.local_unit()
+
+        # All requests must be stored on the peers relation. This is
+        # the only channel units have to communicate with the leader.
+        # Even the leader needs to store its requests here, as a
+        # different unit may be leader by the time the request can be
+        # granted.
+        if self.relid is None:
+            # The peers relation is not available. Maybe we are early in
+            # the units's lifecycle. Maybe this unit is standalone.
+            # Fallback to using local state.
+            self.msg('No peer relation. Loading local state')
+            self.requests = {local_unit: self._load_local_state()}
+        else:
+            self.requests = self._load_peer_state()
+            if local_unit not in self.requests:
+                # The peers relation has just been joined. Update any state
+                # loaded from our peers with our local state.
+                self.msg('New peer relation. Merging local state')
+                self.requests[local_unit] = self._load_local_state()
+
+    def _emit_state(self):
+        # Emit this units lock status.
+        for lock in sorted(self.requests[hookenv.local_unit()].keys()):
+            if self.granted(lock):
+                self.msg('Granted {}'.format(lock))
+            else:
+                self.msg('Waiting on {}'.format(lock))
+
+    def _save_state(self):
+        self.msg('Publishing state')
+        if hookenv.is_leader():
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.grants, sort_keys=True)
+            hookenv.leader_set({self.key: raw})
+
+        local_unit = hookenv.local_unit()
+
+        if self.relid is None:
+            # No peers relation yet. Fallback to local state.
+            self.msg('No peer relation. Saving local state')
+            self._save_local_state(self.requests[local_unit])
+        else:
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.requests[local_unit], sort_keys=True)
+            hookenv.relation_set(self.relid, relation_settings={self.key: raw})
+
+    def _load_peer_state(self):
+        requests = {}
+        units = set(hookenv.related_units(self.relid))
+        units.add(hookenv.local_unit())
+        for unit in units:
+            raw = hookenv.relation_get(self.key, unit, self.relid)
+            if raw:
+                requests[unit] = json.loads(raw)
+        return requests
+
+    def _local_state_filename(self):
+        # Include the class name. We allow multiple BaseCoordinator
+        # subclasses to be instantiated, and they are singletons, so
+        # this avoids conflicts (unless someone creates and uses two
+        # BaseCoordinator subclasses with the same class name, so don't
+        # do that).
+        return '.charmhelpers.coordinator.{}'.format(self._name())
+
+    def _load_local_state(self):
+        fn = self._local_state_filename()
+        if os.path.exists(fn):
+            with open(fn, 'r') as f:
+                return json.load(f)
+        return {}
+
+    def _save_local_state(self, state):
+        fn = self._local_state_filename()
+        with open(fn, 'w') as f:
+            json.dump(state, f)
+
+    def _release_granted(self):
+        # At the end of every hook, release all locks granted to
+        # this unit. If a hook neglects to make use of what it
+        # requested, it will just have to make the request again.
+        # Implicit release is the only way this will work, as
+        # if the unit is standalone there may be no future triggers
+        # called to do a manual release.
+        unit = hookenv.local_unit()
+        for lock in list(self.requests[unit].keys()):
+            if self.granted(lock):
+                self.msg('Released local {} lock'.format(lock))
+                del self.requests[unit][lock]
+
+
+class Serial(BaseCoordinator):
+    def default_grant(self, lock, unit, granted, queue):
+        '''Default logic to grant a lock to a unit. Unless overridden,
+        only one unit may hold the lock and it will be granted to the
+        earliest queued request.
+
+        To define custom logic for $lock, create a subclass and
+        define a grant_$lock method.
+
+        `unit` is the unit name making the request.
+
+        `granted` is the set of units already granted the lock. It will
+        never include `unit`. It may be empty.
+
+        `queue` is the list of units waiting for the lock, ordered by time
+        of request. It will always include `unit`, but `unit` is not
+        necessarily first.
+
+        Returns True if the lock should be granted to `unit`.
+        '''
+        return unit == queue[0] and not granted
+
+
+def _implicit_peer_relation_name():
+    md = hookenv.metadata()
+    assert 'peers' in md, 'No peer relations in metadata.yaml'
+    return sorted(md['peers'].keys())[0]
+
+
+# A human readable, sortable UTC timestamp format.
+_timestamp_format = '%Y-%m-%d %H:%M:%S.%fZ'
+
+
+def _utcnow():  # pragma: no cover
+    # This wrapper exists as mocking datetime methods is problematic.
+    return datetime.utcnow()
+
+
+def _timestamp():
+    return _utcnow().strftime(_timestamp_format)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/decorators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/decorators.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ad41ee4121f4c0816935f8b16cd84f972aff22b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/decorators.py
@@ -0,0 +1,55 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2014 Canonical Ltd.
+#
+# Authors:
+#  Edward Hope-Morley <opentastic@gmail.com>
+#
+
+import time
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+
+def retry_on_exception(num_retries, base_delay=0, exc_type=Exception):
+    """If the decorated function raises exception exc_type, allow num_retries
+    retry attempts before raise the exception.
+    """
+    def _retry_on_exception_inner_1(f):
+        def _retry_on_exception_inner_2(*args, **kwargs):
+            retries = num_retries
+            multiplier = 1
+            while True:
+                try:
+                    return f(*args, **kwargs)
+                except exc_type:
+                    if not retries:
+                        raise
+
+                delay = base_delay * multiplier
+                multiplier += 1
+                log("Retrying '%s' %d more times (delay=%s)" %
+                    (f.__name__, retries, delay), level=INFO)
+                retries -= 1
+                if delay:
+                    time.sleep(delay)
+
+        return _retry_on_exception_inner_2
+
+    return _retry_on_exception_inner_1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/files.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/files.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdd82b75709c13da0d534bf4962822984a3c1867
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/files.py
@@ -0,0 +1,43 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Jorge Niedbalski <niedbalski@ubuntu.com>'
+
+import os
+import subprocess
+
+
+def sed(filename, before, after, flags='g'):
+    """
+    Search and replaces the given pattern on filename.
+
+    :param filename: relative or absolute file path.
+    :param before: expression to be replaced (see 'man sed')
+    :param after: expression to replace with (see 'man sed')
+    :param flags: sed-compatible regex flags in example, to make
+    the  search and replace case insensitive, specify ``flags="i"``.
+    The ``g`` flag is always specified regardless, so you do not
+    need to remember to include it when overriding this parameter.
+    :returns: If the sed command exit code was zero then return,
+    otherwise raise CalledProcessError.
+    """
+    expression = r's/{0}/{1}/{2}'.format(before,
+                                         after, flags)
+
+    return subprocess.check_call(["sed", "-i", "-r", "-e",
+                                  expression,
+                                  os.path.expanduser(filename)])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/fstab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/fstab.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9fa9152c765c538adad3fd9bc45a46018c89b72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/fstab.py
@@ -0,0 +1,132 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+class Fstab(io.FileIO):
+    """This class extends file in order to implement a file reader/writer
+    for file `/etc/fstab`
+    """
+
+    class Entry(object):
+        """Entry class represents a non-comment line on the `/etc/fstab` file
+        """
+        def __init__(self, device, mountpoint, filesystem,
+                     options, d=0, p=0):
+            self.device = device
+            self.mountpoint = mountpoint
+            self.filesystem = filesystem
+
+            if not options:
+                options = "defaults"
+
+            self.options = options
+            self.d = int(d)
+            self.p = int(p)
+
+        def __eq__(self, o):
+            return str(self) == str(o)
+
+        def __str__(self):
+            return "{} {} {} {} {} {}".format(self.device,
+                                              self.mountpoint,
+                                              self.filesystem,
+                                              self.options,
+                                              self.d,
+                                              self.p)
+
+    DEFAULT_PATH = os.path.join(os.path.sep, 'etc', 'fstab')
+
+    def __init__(self, path=None):
+        if path:
+            self._path = path
+        else:
+            self._path = self.DEFAULT_PATH
+        super(Fstab, self).__init__(self._path, 'rb+')
+
+    def _hydrate_entry(self, line):
+        # NOTE: use split with no arguments to split on any
+        #       whitespace including tabs
+        return Fstab.Entry(*filter(
+            lambda x: x not in ('', None),
+            line.strip("\n").split()))
+
+    @property
+    def entries(self):
+        self.seek(0)
+        for line in self.readlines():
+            line = line.decode('us-ascii')
+            try:
+                if line.strip() and not line.strip().startswith("#"):
+                    yield self._hydrate_entry(line)
+            except ValueError:
+                pass
+
+    def get_entry_by_attr(self, attr, value):
+        for entry in self.entries:
+            e_attr = getattr(entry, attr)
+            if e_attr == value:
+                return entry
+        return None
+
+    def add_entry(self, entry):
+        if self.get_entry_by_attr('device', entry.device):
+            return False
+
+        self.write((str(entry) + '\n').encode('us-ascii'))
+        self.truncate()
+        return entry
+
+    def remove_entry(self, entry):
+        self.seek(0)
+
+        lines = [l.decode('us-ascii') for l in self.readlines()]
+
+        found = False
+        for index, line in enumerate(lines):
+            if line.strip() and not line.strip().startswith("#"):
+                if self._hydrate_entry(line) == entry:
+                    found = True
+                    break
+
+        if not found:
+            return False
+
+        lines.remove(line)
+
+        self.seek(0)
+        self.write(''.join(lines).encode('us-ascii'))
+        self.truncate()
+        return True
+
+    @classmethod
+    def remove_by_mountpoint(cls, mountpoint, path=None):
+        fstab = cls(path=path)
+        entry = fstab.get_entry_by_attr('mountpoint', mountpoint)
+        if entry:
+            return fstab.remove_entry(entry)
+        return False
+
+    @classmethod
+    def add(cls, device, mountpoint, filesystem, options=None, path=None):
+        return cls(path=path).add_entry(Fstab.Entry(device,
+                                                    mountpoint, filesystem,
+                                                    options=options))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..db7ce7282b4c96c8a33abf309a340377216922ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hookenv.py
@@ -0,0 +1,1613 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Interactions with the Juju environment"
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+
+from __future__ import print_function
+import copy
+from distutils.version import LooseVersion
+from enum import Enum
+from functools import wraps
+from collections import namedtuple
+import glob
+import os
+import json
+import yaml
+import re
+import subprocess
+import sys
+import errno
+import tempfile
+from subprocess import CalledProcessError
+
+from charmhelpers import deprecate
+
+import six
+if not six.PY3:
+    from UserDict import UserDict
+else:
+    from collections import UserDict
+
+
+CRITICAL = "CRITICAL"
+ERROR = "ERROR"
+WARNING = "WARNING"
+INFO = "INFO"
+DEBUG = "DEBUG"
+TRACE = "TRACE"
+MARKER = object()
+SH_MAX_ARG = 131071
+
+
+RANGE_WARNING = ('Passing NO_PROXY string that includes a cidr. '
+                 'This may not be compatible with software you are '
+                 'running in your shell.')
+
+
+class WORKLOAD_STATES(Enum):
+    ACTIVE = 'active'
+    BLOCKED = 'blocked'
+    MAINTENANCE = 'maintenance'
+    WAITING = 'waiting'
+
+
+cache = {}
+
+
+def cached(func):
+    """Cache return values for multiple executions of func + args
+
+    For example::
+
+        @cached
+        def unit_get(attribute):
+            pass
+
+        unit_get('test')
+
+    will cache the result of unit_get + 'test' for future calls.
+    """
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        global cache
+        key = json.dumps((func, args, kwargs), sort_keys=True, default=str)
+        try:
+            return cache[key]
+        except KeyError:
+            pass  # Drop out of the exception handler scope.
+        res = func(*args, **kwargs)
+        cache[key] = res
+        return res
+    wrapper._wrapped = func
+    return wrapper
+
+
+def flush(key):
+    """Flushes any entries from function cache where the
+    key is found in the function+args """
+    flush_list = []
+    for item in cache:
+        if key in item:
+            flush_list.append(item)
+    for item in flush_list:
+        del cache[item]
+
+
+def log(message, level=None):
+    """Write a message to the juju log"""
+    command = ['juju-log']
+    if level:
+        command += ['-l', level]
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing juju-log should not cause failures in unit tests
+    # Send log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            if level:
+                message = "{}: {}".format(level, message)
+            message = "juju-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+def function_log(message):
+    """Write a function progress message"""
+    command = ['function-log']
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing function-log should not cause failures in unit tests
+    # Send function_log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            message = "function-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+class Serializable(UserDict):
+    """Wrapper, an object that can be serialized to yaml or json"""
+
+    def __init__(self, obj):
+        # wrap the object
+        UserDict.__init__(self)
+        self.data = obj
+
+    def __getattr__(self, attr):
+        # See if this object has attribute.
+        if attr in ("json", "yaml", "data"):
+            return self.__dict__[attr]
+        # Check for attribute in wrapped object.
+        got = getattr(self.data, attr, MARKER)
+        if got is not MARKER:
+            return got
+        # Proxy to the wrapped object via dict interface.
+        try:
+            return self.data[attr]
+        except KeyError:
+            raise AttributeError(attr)
+
+    def __getstate__(self):
+        # Pickle as a standard dictionary.
+        return self.data
+
+    def __setstate__(self, state):
+        # Unpickle into our wrapper.
+        self.data = state
+
+    def json(self):
+        """Serialize the object to json"""
+        return json.dumps(self.data)
+
+    def yaml(self):
+        """Serialize the object to yaml"""
+        return yaml.dump(self.data)
+
+
+def execution_environment():
+    """A convenient bundling of the current execution context"""
+    context = {}
+    context['conf'] = config()
+    if relation_id():
+        context['reltype'] = relation_type()
+        context['relid'] = relation_id()
+        context['rel'] = relation_get()
+    context['unit'] = local_unit()
+    context['rels'] = relations()
+    context['env'] = os.environ
+    return context
+
+
+def in_relation_hook():
+    """Determine whether we're running in a relation hook"""
+    return 'JUJU_RELATION' in os.environ
+
+
+def relation_type():
+    """The scope for the current relation hook"""
+    return os.environ.get('JUJU_RELATION', None)
+
+
+@cached
+def relation_id(relation_name=None, service_or_unit=None):
+    """The relation ID for the current or a specified relation"""
+    if not relation_name and not service_or_unit:
+        return os.environ.get('JUJU_RELATION_ID', None)
+    elif relation_name and service_or_unit:
+        service_name = service_or_unit.split('/')[0]
+        for relid in relation_ids(relation_name):
+            remote_service = remote_service_name(relid)
+            if remote_service == service_name:
+                return relid
+    else:
+        raise ValueError('Must specify neither or both of relation_name and service_or_unit')
+
+
+def local_unit():
+    """Local unit ID"""
+    return os.environ['JUJU_UNIT_NAME']
+
+
+def remote_unit():
+    """The remote unit for the current relation hook"""
+    return os.environ.get('JUJU_REMOTE_UNIT', None)
+
+
+def application_name():
+    """
+    The name of the deployed application this unit belongs to.
+    """
+    return local_unit().split('/')[0]
+
+
+def service_name():
+    """
+    .. deprecated:: 0.19.1
+       Alias for :func:`application_name`.
+    """
+    return application_name()
+
+
+def model_name():
+    """
+    Name of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_NAME']
+
+
+def model_uuid():
+    """
+    UUID of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_UUID']
+
+
+def principal_unit():
+    """Returns the principal unit of this unit, otherwise None"""
+    # Juju 2.2 and above provides JUJU_PRINCIPAL_UNIT
+    principal_unit = os.environ.get('JUJU_PRINCIPAL_UNIT', None)
+    # If it's empty, then this unit is the principal
+    if principal_unit == '':
+        return os.environ['JUJU_UNIT_NAME']
+    elif principal_unit is not None:
+        return principal_unit
+    # For Juju 2.1 and below, let's try work out the principle unit by
+    # the various charms' metadata.yaml.
+    for reltype in relation_types():
+        for rid in relation_ids(reltype):
+            for unit in related_units(rid):
+                md = _metadata_unit(unit)
+                if not md:
+                    continue
+                subordinate = md.pop('subordinate', None)
+                if not subordinate:
+                    return unit
+    return None
+
+
+@cached
+def remote_service_name(relid=None):
+    """The remote service name for a given relation-id (or the current relation)"""
+    if relid is None:
+        unit = remote_unit()
+    else:
+        units = related_units(relid)
+        unit = units[0] if units else None
+    return unit.split('/')[0] if unit else None
+
+
+def hook_name():
+    """The name of the currently executing hook"""
+    return os.environ.get('JUJU_HOOK_NAME', os.path.basename(sys.argv[0]))
+
+
+class Config(dict):
+    """A dictionary representation of the charm's config.yaml, with some
+    extra features:
+
+    - See which values in the dictionary have changed since the previous hook.
+    - For values that have changed, see what the previous value was.
+    - Store arbitrary data for use in a later hook.
+
+    NOTE: Do not instantiate this object directly - instead call
+    ``hookenv.config()``, which will return an instance of :class:`Config`.
+
+    Example usage::
+
+        >>> # inside a hook
+        >>> from charmhelpers.core import hookenv
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'bar'
+        >>> # store a new key/value for later use
+        >>> config['mykey'] = 'myval'
+
+
+        >>> # user runs `juju set mycharm foo=baz`
+        >>> # now we're inside subsequent config-changed hook
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'baz'
+        >>> # test to see if this val has changed since last hook
+        >>> config.changed('foo')
+        True
+        >>> # what was the previous value?
+        >>> config.previous('foo')
+        'bar'
+        >>> # keys/values that we add are preserved across hooks
+        >>> config['mykey']
+        'myval'
+
+    """
+    CONFIG_FILE_NAME = '.juju-persistent-config'
+
+    def __init__(self, *args, **kw):
+        super(Config, self).__init__(*args, **kw)
+        self.implicit_save = True
+        self._prev_dict = None
+        self.path = os.path.join(charm_dir(), Config.CONFIG_FILE_NAME)
+        if os.path.exists(self.path) and os.stat(self.path).st_size:
+            self.load_previous()
+        atexit(self._implicit_save)
+
+    def load_previous(self, path=None):
+        """Load previous copy of config from disk.
+
+        In normal usage you don't need to call this method directly - it
+        is called automatically at object initialization.
+
+        :param path:
+
+            File path from which to load the previous config. If `None`,
+            config is loaded from the default location. If `path` is
+            specified, subsequent `save()` calls will write to the same
+            path.
+
+        """
+        self.path = path or self.path
+        with open(self.path) as f:
+            try:
+                self._prev_dict = json.load(f)
+            except ValueError as e:
+                log('Found but was unable to parse previous config data, '
+                    'ignoring which will report all values as changed - {}'
+                    .format(str(e)), level=ERROR)
+                return
+        for k, v in copy.deepcopy(self._prev_dict).items():
+            if k not in self:
+                self[k] = v
+
+    def changed(self, key):
+        """Return True if the current value for this key is different from
+        the previous value.
+
+        """
+        if self._prev_dict is None:
+            return True
+        return self.previous(key) != self.get(key)
+
+    def previous(self, key):
+        """Return previous value for this key, or None if there
+        is no previous value.
+
+        """
+        if self._prev_dict:
+            return self._prev_dict.get(key)
+        return None
+
+    def save(self):
+        """Save this config to disk.
+
+        If the charm is using the :mod:`Services Framework <services.base>`
+        or :meth:'@hook <Hooks.hook>' decorator, this
+        is called automatically at the end of successful hook execution.
+        Otherwise, it should be called directly by user code.
+
+        To disable automatic saves, set ``implicit_save=False`` on this
+        instance.
+
+        """
+        with open(self.path, 'w') as f:
+            os.fchmod(f.fileno(), 0o600)
+            json.dump(self, f)
+
+    def _implicit_save(self):
+        if self.implicit_save:
+            self.save()
+
+
+_cache_config = None
+
+
+def config(scope=None):
+    """
+    Get the juju charm configuration (scope==None) or individual key,
+    (scope=str).  The returned value is a Python data structure loaded as
+    JSON from the Juju config command.
+
+    :param scope: If set, return the value for the specified key.
+    :type scope: Optional[str]
+    :returns: Either the whole config as a Config, or a key from it.
+    :rtype: Any
+    """
+    global _cache_config
+    config_cmd_line = ['config-get', '--all', '--format=json']
+    try:
+        # JSON Decode Exception for Python3.5+
+        exc_json = json.decoder.JSONDecodeError
+    except AttributeError:
+        # JSON Decode Exception for Python2.7 through Python3.4
+        exc_json = ValueError
+    try:
+        if _cache_config is None:
+            config_data = json.loads(
+                subprocess.check_output(config_cmd_line).decode('UTF-8'))
+            _cache_config = Config(config_data)
+        if scope is not None:
+            return _cache_config.get(scope)
+        return _cache_config
+    except (exc_json, UnicodeDecodeError) as e:
+        log('Unable to parse output from config-get: config_cmd_line="{}" '
+            'message="{}"'
+            .format(config_cmd_line, str(e)), level=ERROR)
+        return None
+
+
+@cached
+def relation_get(attribute=None, unit=None, rid=None):
+    """Get relation information"""
+    _args = ['relation-get', '--format=json']
+    if rid:
+        _args.append('-r')
+        _args.append(rid)
+    _args.append(attribute or '-')
+    if unit:
+        _args.append(unit)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except CalledProcessError as e:
+        if e.returncode == 2:
+            return None
+        raise
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Set relation information for the current unit"""
+    relation_settings = relation_settings if relation_settings else {}
+    relation_cmd_line = ['relation-set']
+    accepts_file = "--file" in subprocess.check_output(
+        relation_cmd_line + ["--help"], universal_newlines=True)
+    if relation_id is not None:
+        relation_cmd_line.extend(('-r', relation_id))
+    settings = relation_settings.copy()
+    settings.update(kwargs)
+    for key, value in settings.items():
+        # Force value to be a string: it always should, but some call
+        # sites pass in things like dicts or numbers.
+        if value is not None:
+            settings[key] = "{}".format(value)
+    if accepts_file:
+        # --file was introduced in Juju 1.23.2. Use it by default if
+        # available, since otherwise we'll break if the relation data is
+        # too big. Ideally we should tell relation-set to read the data from
+        # stdin, but that feature is broken in 1.23.2: Bug #1454678.
+        with tempfile.NamedTemporaryFile(delete=False) as settings_file:
+            settings_file.write(yaml.safe_dump(settings).encode("utf-8"))
+        subprocess.check_call(
+            relation_cmd_line + ["--file", settings_file.name])
+        os.remove(settings_file.name)
+    else:
+        for key, value in settings.items():
+            if value is None:
+                relation_cmd_line.append('{}='.format(key))
+            else:
+                relation_cmd_line.append('{}={}'.format(key, value))
+        subprocess.check_call(relation_cmd_line)
+    # Flush cache of any relation-gets for local unit
+    flush(local_unit())
+
+
+def relation_clear(r_id=None):
+    ''' Clears any relation data already set on relation r_id '''
+    settings = relation_get(rid=r_id,
+                            unit=local_unit())
+    for setting in settings:
+        if setting not in ['public-address', 'private-address']:
+            settings[setting] = None
+    relation_set(relation_id=r_id,
+                 **settings)
+
+
+@cached
+def relation_ids(reltype=None):
+    """A list of relation_ids"""
+    reltype = reltype or relation_type()
+    relid_cmd_line = ['relation-ids', '--format=json']
+    if reltype is not None:
+        relid_cmd_line.append(reltype)
+        return json.loads(
+            subprocess.check_output(relid_cmd_line).decode('UTF-8')) or []
+    return []
+
+
+@cached
+def related_units(relid=None):
+    """A list of related units"""
+    relid = relid or relation_id()
+    units_cmd_line = ['relation-list', '--format=json']
+    if relid is not None:
+        units_cmd_line.extend(('-r', relid))
+    return json.loads(
+        subprocess.check_output(units_cmd_line).decode('UTF-8')) or []
+
+
+def expected_peer_units():
+    """Get a generator for units we expect to join peer relation based on
+    goal-state.
+
+    The local unit is excluded from the result to make it easy to gauge
+    completion of all peers joining the relation with existing hook tools.
+
+    Example usage:
+    log('peer {} of {} joined peer relation'
+        .format(len(related_units()),
+                len(list(expected_peer_units()))))
+
+    This function will raise NotImplementedError if used with juju versions
+    without goal-state support.
+
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: NotImplementedError
+    """
+    if not has_juju_version("2.4.0"):
+        # goal-state first appeared in 2.4.0.
+        raise NotImplementedError("goal-state")
+    _goal_state = goal_state()
+    return (key for key in _goal_state['units']
+            if '/' in key and key != local_unit())
+
+
+def expected_related_units(reltype=None):
+    """Get a generator for units we expect to join relation based on
+    goal-state.
+
+    Note that you can not use this function for the peer relation, take a look
+    at expected_peer_units() for that.
+
+    This function will raise KeyError if you request information for a
+    relation type for which juju goal-state does not have information.  It will
+    raise NotImplementedError if used with juju versions without goal-state
+    support.
+
+    Example usage:
+    log('participant {} of {} joined relation {}'
+        .format(len(related_units()),
+                len(list(expected_related_units())),
+                relation_type()))
+
+    :param reltype: Relation type to list data for, default is to list data for
+                    the realtion type we are currently executing a hook for.
+    :type reltype: str
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: KeyError, NotImplementedError
+    """
+    if not has_juju_version("2.4.4"):
+        # goal-state existed in 2.4.0, but did not list individual units to
+        # join a relation in 2.4.1 through 2.4.3. (LP: #1794739)
+        raise NotImplementedError("goal-state relation unit count")
+    reltype = reltype or relation_type()
+    _goal_state = goal_state()
+    return (key for key in _goal_state['relations'][reltype] if '/' in key)
+
+
+@cached
+def relation_for_unit(unit=None, rid=None):
+    """Get the json represenation of a unit's relation"""
+    unit = unit or remote_unit()
+    relation = relation_get(unit=unit, rid=rid)
+    for key in relation:
+        if key.endswith('-list'):
+            relation[key] = relation[key].split()
+    relation['__unit__'] = unit
+    return relation
+
+
+@cached
+def relations_for_id(relid=None):
+    """Get relations of a specific relation ID"""
+    relation_data = []
+    relid = relid or relation_ids()
+    for unit in related_units(relid):
+        unit_data = relation_for_unit(unit, relid)
+        unit_data['__relid__'] = relid
+        relation_data.append(unit_data)
+    return relation_data
+
+
+@cached
+def relations_of_type(reltype=None):
+    """Get relations of a specific type"""
+    relation_data = []
+    reltype = reltype or relation_type()
+    for relid in relation_ids(reltype):
+        for relation in relations_for_id(relid):
+            relation['__relid__'] = relid
+            relation_data.append(relation)
+    return relation_data
+
+
+@cached
+def metadata():
+    """Get the current charm metadata.yaml contents as a python object"""
+    with open(os.path.join(charm_dir(), 'metadata.yaml')) as md:
+        return yaml.safe_load(md)
+
+
+def _metadata_unit(unit):
+    """Given the name of a unit (e.g. apache2/0), get the unit charm's
+    metadata.yaml. Very similar to metadata() but allows us to inspect
+    other units. Unit needs to be co-located, such as a subordinate or
+    principal/primary.
+
+    :returns: metadata.yaml as a python object.
+
+    """
+    basedir = os.sep.join(charm_dir().split(os.sep)[:-2])
+    unitdir = 'unit-{}'.format(unit.replace(os.sep, '-'))
+    joineddir = os.path.join(basedir, unitdir, 'charm', 'metadata.yaml')
+    if not os.path.exists(joineddir):
+        return None
+    with open(joineddir) as md:
+        return yaml.safe_load(md)
+
+
+@cached
+def relation_types():
+    """Get a list of relation types supported by this charm"""
+    rel_types = []
+    md = metadata()
+    for key in ('provides', 'requires', 'peers'):
+        section = md.get(key)
+        if section:
+            rel_types.extend(section.keys())
+    return rel_types
+
+
+@cached
+def peer_relation_id():
+    '''Get the peers relation id if a peers relation has been joined, else None.'''
+    md = metadata()
+    section = md.get('peers')
+    if section:
+        for key in section:
+            relids = relation_ids(key)
+            if relids:
+                return relids[0]
+    return None
+
+
+@cached
+def relation_to_interface(relation_name):
+    """
+    Given the name of a relation, return the interface that relation uses.
+
+    :returns: The interface name, or ``None``.
+    """
+    return relation_to_role_and_interface(relation_name)[1]
+
+
+@cached
+def relation_to_role_and_interface(relation_name):
+    """
+    Given the name of a relation, return the role and the name of the interface
+    that relation uses (where role is one of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A tuple containing ``(role, interface)``, or ``(None, None)``.
+    """
+    _metadata = metadata()
+    for role in ('provides', 'requires', 'peers'):
+        interface = _metadata.get(role, {}).get(relation_name, {}).get('interface')
+        if interface:
+            return role, interface
+    return None, None
+
+
+@cached
+def role_and_interface_to_relations(role, interface_name):
+    """
+    Given a role and interface name, return a list of relation names for the
+    current charm that use that interface under that role (where role is one
+    of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A list of relation names.
+    """
+    _metadata = metadata()
+    results = []
+    for relation_name, relation in _metadata.get(role, {}).items():
+        if relation['interface'] == interface_name:
+            results.append(relation_name)
+    return results
+
+
+@cached
+def interface_to_relations(interface_name):
+    """
+    Given an interface, return a list of relation names for the current
+    charm that use that interface.
+
+    :returns: A list of relation names.
+    """
+    results = []
+    for role in ('provides', 'requires', 'peers'):
+        results.extend(role_and_interface_to_relations(role, interface_name))
+    return results
+
+
+@cached
+def charm_name():
+    """Get the name of the current charm as is specified on metadata.yaml"""
+    return metadata().get('name')
+
+
+@cached
+def relations():
+    """Get a nested dictionary of relation data for all related units"""
+    rels = {}
+    for reltype in relation_types():
+        relids = {}
+        for relid in relation_ids(reltype):
+            units = {local_unit(): relation_get(unit=local_unit(), rid=relid)}
+            for unit in related_units(relid):
+                reldata = relation_get(unit=unit, rid=relid)
+                units[unit] = reldata
+            relids[relid] = units
+        rels[reltype] = relids
+    return rels
+
+
+@cached
+def is_relation_made(relation, keys='private-address'):
+    '''
+    Determine whether a relation is established by checking for
+    presence of key(s).  If a list of keys is provided, they
+    must all be present for the relation to be identified as made
+    '''
+    if isinstance(keys, str):
+        keys = [keys]
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            context = {}
+            for k in keys:
+                context[k] = relation_get(k, rid=r_id,
+                                          unit=unit)
+            if None not in context.values():
+                return True
+    return False
+
+
+def _port_op(op_name, port, protocol="TCP"):
+    """Open or close a service network port"""
+    _args = [op_name]
+    icmp = protocol.upper() == "ICMP"
+    if icmp:
+        _args.append(protocol)
+    else:
+        _args.append('{}/{}'.format(port, protocol))
+    try:
+        subprocess.check_call(_args)
+    except subprocess.CalledProcessError:
+        # Older Juju pre 2.3 doesn't support ICMP
+        # so treat it as a no-op if it fails.
+        if not icmp:
+            raise
+
+
+def open_port(port, protocol="TCP"):
+    """Open a service network port"""
+    _port_op('open-port', port, protocol)
+
+
+def close_port(port, protocol="TCP"):
+    """Close a service network port"""
+    _port_op('close-port', port, protocol)
+
+
+def open_ports(start, end, protocol="TCP"):
+    """Opens a range of service network ports"""
+    _args = ['open-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def close_ports(start, end, protocol="TCP"):
+    """Close a range of service network ports"""
+    _args = ['close-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def opened_ports():
+    """Get the opened ports
+
+    *Note that this will only show ports opened in a previous hook*
+
+    :returns: Opened ports as a list of strings: ``['8080/tcp', '8081-8083/tcp']``
+    """
+    _args = ['opened-ports', '--format=json']
+    return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+
+
+@cached
+def unit_get(attribute):
+    """Get the unit ID for the remote unit"""
+    _args = ['unit-get', '--format=json', attribute]
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+def unit_public_ip():
+    """Get this unit's public IP address"""
+    return unit_get('public-address')
+
+
+def unit_private_ip():
+    """Get this unit's private IP address"""
+    return unit_get('private-address')
+
+
+@cached
+def storage_get(attribute=None, storage_id=None):
+    """Get storage attributes"""
+    _args = ['storage-get', '--format=json']
+    if storage_id:
+        _args.extend(('-s', storage_id))
+    if attribute:
+        _args.append(attribute)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+@cached
+def storage_list(storage_name=None):
+    """List the storage IDs for the unit"""
+    _args = ['storage-list', '--format=json']
+    if storage_name:
+        _args.append(storage_name)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except OSError as e:
+        import errno
+        if e.errno == errno.ENOENT:
+            # storage-list does not exist
+            return []
+        raise
+
+
+class UnregisteredHookError(Exception):
+    """Raised when an undefined hook is called"""
+    pass
+
+
+class Hooks(object):
+    """A convenient handler for hook functions.
+
+    Example::
+
+        hooks = Hooks()
+
+        # register a hook, taking its name from the function name
+        @hooks.hook()
+        def install():
+            pass  # your code here
+
+        # register a hook, providing a custom hook name
+        @hooks.hook("config-changed")
+        def config_changed():
+            pass  # your code here
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, config_save=None):
+        super(Hooks, self).__init__()
+        self._hooks = {}
+
+        # For unknown reasons, we allow the Hooks constructor to override
+        # config().implicit_save.
+        if config_save is not None:
+            config().implicit_save = config_save
+
+    def register(self, name, function):
+        """Register a hook"""
+        self._hooks[name] = function
+
+    def execute(self, args):
+        """Execute a registered hook based on args[0]"""
+        _run_atstart()
+        hook_name = os.path.basename(args[0])
+        if hook_name in self._hooks:
+            try:
+                self._hooks[hook_name]()
+            except SystemExit as x:
+                if x.code is None or x.code == 0:
+                    _run_atexit()
+                raise
+            _run_atexit()
+        else:
+            raise UnregisteredHookError(hook_name)
+
+    def hook(self, *hook_names):
+        """Decorator, registering them as hooks"""
+        def wrapper(decorated):
+            for hook_name in hook_names:
+                self.register(hook_name, decorated)
+            else:
+                self.register(decorated.__name__, decorated)
+                if '_' in decorated.__name__:
+                    self.register(
+                        decorated.__name__.replace('_', '-'), decorated)
+            return decorated
+        return wrapper
+
+
+class NoNetworkBinding(Exception):
+    pass
+
+
+def charm_dir():
+    """Return the root directory of the current charm"""
+    d = os.environ.get('JUJU_CHARM_DIR')
+    if d is not None:
+        return d
+    return os.environ.get('CHARM_DIR')
+
+
+def cmd_exists(cmd):
+    """Return True if the specified cmd exists in the path"""
+    return any(
+        os.access(os.path.join(path, cmd), os.X_OK)
+        for path in os.environ["PATH"].split(os.pathsep)
+    )
+
+
+@cached
+@deprecate("moved to function_get()", log=log)
+def action_get(key=None):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_get`.
+
+    Gets the value of an action parameter, or all key/value param pairs.
+    """
+    cmd = ['action-get']
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    action_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return action_data
+
+
+@cached
+def function_get(key=None):
+    """Gets the value of an action parameter, or all key/value param pairs"""
+    cmd = ['function-get']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-get']
+
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    function_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return function_data
+
+
+@deprecate("moved to function_set()", log=log)
+def action_set(values):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_set`.
+
+    Sets the values to be returned after the action finishes.
+    """
+    cmd = ['action-set']
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+def function_set(values):
+    """Sets the values to be returned after the function finishes"""
+    cmd = ['function-set']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-set']
+
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@deprecate("moved to function_fail()", log=log)
+def action_fail(message):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_fail`.
+
+    Sets the action status to failed and sets the error message.
+
+    The results set by action_set are preserved.
+    """
+    subprocess.check_call(['action-fail', message])
+
+
+def function_fail(message):
+    """Sets the function status to failed and sets the error message.
+
+    The results set by function_set are preserved."""
+    cmd = ['function-fail']
+    # Fallback for older charms.
+    if not cmd_exists('function-fail'):
+        cmd = ['action-fail']
+    cmd.append(message)
+
+    subprocess.check_call(cmd)
+
+
+def action_name():
+    """Get the name of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_NAME')
+
+
+def function_name():
+    """Get the name of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_NAME') or action_name()
+
+
+def action_uuid():
+    """Get the UUID of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_UUID')
+
+
+def function_id():
+    """Get the ID of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_ID') or action_uuid()
+
+
+def action_tag():
+    """Get the tag for the currently executing action."""
+    return os.environ.get('JUJU_ACTION_TAG')
+
+
+def function_tag():
+    """Get the tag for the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_TAG') or action_tag()
+
+
+def status_set(workload_state, message, application=False):
+    """Set the workload state with a message
+
+    Use status-set to set the workload state with a message which is visible
+    to the user via juju status. If the status-set command is not found then
+    assume this is juju < 1.23 and juju-log the message instead.
+
+    workload_state   -- valid juju workload state. str or WORKLOAD_STATES
+    message          -- status update message
+    application      -- Whether this is an application state set
+    """
+    bad_state_msg = '{!r} is not a valid workload state'
+
+    if isinstance(workload_state, str):
+        try:
+            # Convert string to enum.
+            workload_state = WORKLOAD_STATES[workload_state.upper()]
+        except KeyError:
+            raise ValueError(bad_state_msg.format(workload_state))
+
+    if workload_state not in WORKLOAD_STATES:
+        raise ValueError(bad_state_msg.format(workload_state))
+
+    cmd = ['status-set']
+    if application:
+        cmd.append('--application')
+    cmd.extend([workload_state.value, message])
+    try:
+        ret = subprocess.call(cmd)
+        if ret == 0:
+            return
+    except OSError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'status-set failed: {} {}'.format(workload_state.value,
+                                                    message)
+    log(log_message, level='INFO')
+
+
+def status_get():
+    """Retrieve the previously set juju workload state and message
+
+    If the status-get command is not found then assume this is juju < 1.23 and
+    return 'unknown', ""
+
+    """
+    cmd = ['status-get', "--format=json", "--include-data"]
+    try:
+        raw_status = subprocess.check_output(cmd)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            return ('unknown', "")
+        else:
+            raise
+    else:
+        status = json.loads(raw_status.decode("UTF-8"))
+        return (status["status"], status["message"])
+
+
+def translate_exc(from_exc, to_exc):
+    def inner_translate_exc1(f):
+        @wraps(f)
+        def inner_translate_exc2(*args, **kwargs):
+            try:
+                return f(*args, **kwargs)
+            except from_exc:
+                raise to_exc
+
+        return inner_translate_exc2
+
+    return inner_translate_exc1
+
+
+def application_version_set(version):
+    """Charm authors may trigger this command from any hook to output what
+    version of the application is running. This could be a package version,
+    for instance postgres version 9.5. It could also be a build number or
+    version control revision identifier, for instance git sha 6fb7ba68. """
+
+    cmd = ['application-version-set']
+    cmd.append(version)
+    try:
+        subprocess.check_call(cmd)
+    except OSError:
+        log("Application Version: {}".format(version))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+@cached
+def goal_state():
+    """Juju goal state values"""
+    cmd = ['goal-state', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def is_leader():
+    """Does the current unit hold the juju leadership
+
+    Uses juju to determine whether the current unit is the leader of its peers
+    """
+    cmd = ['is-leader', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_get(attribute=None):
+    """Juju leader get value(s)"""
+    cmd = ['leader-get', '--format=json'] + [attribute or '-']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_set(settings=None, **kwargs):
+    """Juju leader set value(s)"""
+    # Don't log secrets.
+    # log("Juju leader-set '%s'" % (settings), level=DEBUG)
+    cmd = ['leader-set']
+    settings = settings or {}
+    settings.update(kwargs)
+    for k, v in settings.items():
+        if v is None:
+            cmd.append('{}='.format(k))
+        else:
+            cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_register(ptype, klass, pid):
+    """ is used while a hook is running to let Juju know that a
+        payload has been started."""
+    cmd = ['payload-register']
+    for x in [ptype, klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_unregister(klass, pid):
+    """ is used while a hook is running to let Juju know
+    that a payload has been manually stopped. The <class> and <id> provided
+    must match a payload that has been previously registered with juju using
+    payload-register."""
+    cmd = ['payload-unregister']
+    for x in [klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_status_set(klass, pid, status):
+    """is used to update the current status of a registered payload.
+    The <class> and <id> provided must match a payload that has been previously
+    registered with juju using payload-register. The <status> must be one of the
+    follow: starting, started, stopping, stopped"""
+    cmd = ['payload-status-set']
+    for x in [klass, pid, status]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def resource_get(name):
+    """used to fetch the resource path of the given name.
+
+    <name> must match a name of defined resource in metadata.yaml
+
+    returns either a path or False if resource not available
+    """
+    if not name:
+        return False
+
+    cmd = ['resource-get', name]
+    try:
+        return subprocess.check_output(cmd).decode('UTF-8')
+    except subprocess.CalledProcessError:
+        return False
+
+
+@cached
+def juju_version():
+    """Full version string (eg. '1.23.3.1-trusty-amd64')"""
+    # Per https://bugs.launchpad.net/juju-core/+bug/1455368/comments/1
+    jujud = glob.glob('/var/lib/juju/tools/machine-*/jujud')[0]
+    return subprocess.check_output([jujud, 'version'],
+                                   universal_newlines=True).strip()
+
+
+def has_juju_version(minimum_version):
+    """Return True if the Juju version is at least the provided version"""
+    return LooseVersion(juju_version()) >= LooseVersion(minimum_version)
+
+
+_atexit = []
+_atstart = []
+
+
+def atstart(callback, *args, **kwargs):
+    '''Schedule a callback to run before the main hook.
+
+    Callbacks are run in the order they were added.
+
+    This is useful for modules and classes to perform initialization
+    and inject behavior. In particular:
+
+        - Run common code before all of your hooks, such as logging
+          the hook name or interesting relation data.
+        - Defer object or module initialization that requires a hook
+          context until we know there actually is a hook context,
+          making testing easier.
+        - Rather than requiring charm authors to include boilerplate to
+          invoke your helper's behavior, have it run automatically if
+          your object is instantiated or module imported.
+
+    This is not at all useful after your hook framework as been launched.
+    '''
+    global _atstart
+    _atstart.append((callback, args, kwargs))
+
+
+def atexit(callback, *args, **kwargs):
+    '''Schedule a callback to run on successful hook completion.
+
+    Callbacks are run in the reverse order that they were added.'''
+    _atexit.append((callback, args, kwargs))
+
+
+def _run_atstart():
+    '''Hook frameworks must invoke this before running the main hook body.'''
+    global _atstart
+    for callback, args, kwargs in _atstart:
+        callback(*args, **kwargs)
+    del _atstart[:]
+
+
+def _run_atexit():
+    '''Hook frameworks must invoke this after the main hook body has
+    successfully completed. Do not invoke it if the hook fails.'''
+    global _atexit
+    for callback, args, kwargs in reversed(_atexit):
+        callback(*args, **kwargs)
+    del _atexit[:]
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def network_get_primary_address(binding):
+    '''
+    Deprecated since Juju 2.3; use network_get()
+
+    Retrieve the primary network address for a named binding
+
+    :param binding: string. The name of a relation of extra-binding
+    :return: string. The primary IP address for the named binding
+    :raise: NotImplementedError if run on Juju < 2.0
+    '''
+    cmd = ['network-get', '--primary-address', binding]
+    try:
+        response = subprocess.check_output(
+            cmd,
+            stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    except CalledProcessError as e:
+        if 'no network config found for binding' in e.output.decode('UTF-8'):
+            raise NoNetworkBinding("No network binding for {}"
+                                   .format(binding))
+        else:
+            raise
+    return response
+
+
+def network_get(endpoint, relation_id=None):
+    """
+    Retrieve the network details for a relation endpoint
+
+    :param endpoint: string. The name of a relation endpoint
+    :param relation_id: int. The ID of the relation for the current context.
+    :return: dict. The loaded YAML output of the network-get query.
+    :raise: NotImplementedError if request not supported by the Juju version.
+    """
+    if not has_juju_version('2.2'):
+        raise NotImplementedError(juju_version())  # earlier versions require --primary-address
+    if relation_id and not has_juju_version('2.3'):
+        raise NotImplementedError  # 2.3 added the -r option
+
+    cmd = ['network-get', endpoint, '--format', 'yaml']
+    if relation_id:
+        cmd.append('-r')
+        cmd.append(relation_id)
+    response = subprocess.check_output(
+        cmd,
+        stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    return yaml.safe_load(response)
+
+
+def add_metric(*args, **kwargs):
+    """Add metric values. Values may be expressed with keyword arguments. For
+    metric names containing dashes, these may be expressed as one or more
+    'key=value' positional arguments. May only be called from the collect-metrics
+    hook."""
+    _args = ['add-metric']
+    _kvpairs = []
+    _kvpairs.extend(args)
+    _kvpairs.extend(['{}={}'.format(k, v) for k, v in kwargs.items()])
+    _args.extend(sorted(_kvpairs))
+    try:
+        subprocess.check_call(_args)
+        return
+    except EnvironmentError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'add-metric failed: {}'.format(' '.join(_kvpairs))
+    log(log_message, level='INFO')
+
+
+def meter_status():
+    """Get the meter status, if running in the meter-status-changed hook."""
+    return os.environ.get('JUJU_METER_STATUS')
+
+
+def meter_info():
+    """Get the meter status information, if running in the meter-status-changed
+    hook."""
+    return os.environ.get('JUJU_METER_INFO')
+
+
+def iter_units_for_relation_name(relation_name):
+    """Iterate through all units in a relation
+
+    Generator that iterates through all the units in a relation and yields
+    a named tuple with rid and unit field names.
+
+    Usage:
+    data = [(u.rid, u.unit)
+            for u in iter_units_for_relation_name(relation_name)]
+
+    :param relation_name: string relation name
+    :yield: Named Tuple with rid and unit field names
+    """
+    RelatedUnit = namedtuple('RelatedUnit', 'rid, unit')
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            yield RelatedUnit(rid, unit)
+
+
+def ingress_address(rid=None, unit=None):
+    """
+    Retrieve the ingress-address from a relation when available.
+    Otherwise, return the private-address.
+
+    When used on the consuming side of the relation (unit is a remote
+    unit), the ingress-address is the IP address that this unit needs
+    to use to reach the provided service on the remote unit.
+
+    When used on the providing side of the relation (unit == local_unit()),
+    the ingress-address is the IP address that is advertised to remote
+    units on this relation. Remote units need to use this address to
+    reach the local provided service on this unit.
+
+    Note that charms may document some other method to use in
+    preference to the ingress_address(), such as an address provided
+    on a different relation attribute or a service discovery mechanism.
+    This allows charms to redirect inbound connections to their peers
+    or different applications such as load balancers.
+
+    Usage:
+    addresses = [ingress_address(rid=u.rid, unit=u.unit)
+                 for u in iter_units_for_relation_name(relation_name)]
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: string IP address
+    """
+    settings = relation_get(rid=rid, unit=unit)
+    return (settings.get('ingress-address') or
+            settings.get('private-address'))
+
+
+def egress_subnets(rid=None, unit=None):
+    """
+    Retrieve the egress-subnets from a relation.
+
+    This function is to be used on the providing side of the
+    relation, and provides the ranges of addresses that client
+    connections may come from. The result is uninteresting on
+    the consuming side of a relation (unit == local_unit()).
+
+    Returns a stable list of subnets in CIDR format.
+    eg. ['192.168.1.0/24', '2001::F00F/128']
+
+    If egress-subnets is not available, falls back to using the published
+    ingress-address, or finally private-address.
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: list of subnets in CIDR format. eg. ['192.168.1.0/24', '2001::F00F/128']
+    """
+    def _to_range(addr):
+        if re.search(r'^(?:\d{1,3}\.){3}\d{1,3}$', addr) is not None:
+            addr += '/32'
+        elif ':' in addr and '/' not in addr:  # IPv6
+            addr += '/128'
+        return addr
+
+    settings = relation_get(rid=rid, unit=unit)
+    if 'egress-subnets' in settings:
+        return [n.strip() for n in settings['egress-subnets'].split(',') if n.strip()]
+    if 'ingress-address' in settings:
+        return [_to_range(settings['ingress-address'])]
+    if 'private-address' in settings:
+        return [_to_range(settings['private-address'])]
+    return []  # Should never happen
+
+
+def unit_doomed(unit=None):
+    """Determines if the unit is being removed from the model
+
+    Requires Juju 2.4.1.
+
+    :param unit: string unit name, defaults to local_unit
+    :side effect: calls goal_state
+    :side effect: calls local_unit
+    :side effect: calls has_juju_version
+    :return: True if the unit is being removed, already gone, or never existed
+    """
+    if not has_juju_version("2.4.1"):
+        # We cannot risk blindly returning False for 'we don't know',
+        # because that could cause data loss; if call sites don't
+        # need an accurate answer, they likely don't need this helper
+        # at all.
+        # goal-state existed in 2.4.0, but did not handle removals
+        # correctly until 2.4.1.
+        raise NotImplementedError("is_doomed")
+    if unit is None:
+        unit = local_unit()
+    gs = goal_state()
+    units = gs.get('units', {})
+    if unit not in units:
+        return True
+    # I don't think 'dead' units ever show up in the goal-state, but
+    # check anyway in addition to 'dying'.
+    return units[unit]['status'] in ('dying', 'dead')
+
+
+def env_proxy_settings(selected_settings=None):
+    """Get proxy settings from process environment variables.
+
+    Get charm proxy settings from environment variables that correspond to
+    juju-http-proxy, juju-https-proxy juju-no-proxy (available as of 2.4.2, see
+    lp:1782236) and juju-ftp-proxy in a format suitable for passing to an
+    application that reacts to proxy settings passed as environment variables.
+    Some applications support lowercase or uppercase notation (e.g. curl), some
+    support only lowercase (e.g. wget), there are also subjectively rare cases
+    of only uppercase notation support. no_proxy CIDR and wildcard support also
+    varies between runtimes and applications as there is no enforced standard.
+
+    Some applications may connect to multiple destinations and expose config
+    options that would affect only proxy settings for a specific destination
+    these should be handled in charms in an application-specific manner.
+
+    :param selected_settings: format only a subset of possible settings
+    :type selected_settings: list
+    :rtype: Option(None, dict[str, str])
+    """
+    SUPPORTED_SETTINGS = {
+        'http': 'HTTP_PROXY',
+        'https': 'HTTPS_PROXY',
+        'no_proxy': 'NO_PROXY',
+        'ftp': 'FTP_PROXY'
+    }
+    if selected_settings is None:
+        selected_settings = SUPPORTED_SETTINGS
+
+    selected_vars = [v for k, v in SUPPORTED_SETTINGS.items()
+                     if k in selected_settings]
+    proxy_settings = {}
+    for var in selected_vars:
+        var_val = os.getenv(var)
+        if var_val:
+            proxy_settings[var] = var_val
+            proxy_settings[var.lower()] = var_val
+        # Now handle juju-prefixed environment variables. The legacy vs new
+        # environment variable usage is mutually exclusive
+        charm_var_val = os.getenv('JUJU_CHARM_{}'.format(var))
+        if charm_var_val:
+            proxy_settings[var] = charm_var_val
+            proxy_settings[var.lower()] = charm_var_val
+    if 'no_proxy' in proxy_settings:
+        if _contains_range(proxy_settings['no_proxy']):
+            log(RANGE_WARNING, level=WARNING)
+    return proxy_settings if proxy_settings else None
+
+
+def _contains_range(addresses):
+    """Check for cidr or wildcard domain in a string.
+
+    Given a string comprising a comma seperated list of ip addresses
+    and domain names, determine whether the string contains IP ranges
+    or wildcard domains.
+
+    :param addresses: comma seperated list of domains and ip addresses.
+    :type addresses: str
+    """
+    return (
+        # Test for cidr (e.g. 10.20.20.0/24)
+        "/" in addresses or
+        # Test for wildcard domains (*.foo.com or .foo.com)
+        "*" in addresses or
+        addresses.startswith(".") or
+        ",." in addresses or
+        " ." in addresses)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..b33ac906d9eeb198210dceb069724ac9a35652ea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host.py
@@ -0,0 +1,1104 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tools for working with the host system"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Nick Moffitt <nick.moffitt@canonical.com>
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import os
+import re
+import pwd
+import glob
+import grp
+import random
+import string
+import subprocess
+import hashlib
+import functools
+import itertools
+import six
+
+from contextlib import contextmanager
+from collections import OrderedDict
+from .hookenv import log, INFO, DEBUG, local_unit, charm_name
+from .fstab import Fstab
+from charmhelpers.osplatform import get_platform
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.host_factory.ubuntu import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+        get_distrib_codename,
+        arch
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.host_factory.centos import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+    )  # flake8: noqa -- ignore F401 for this import
+
+UPDATEDB_PATH = '/etc/updatedb.conf'
+
+
+def service_start(service_name, **kwargs):
+    """Start a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('start', service_name, **kwargs)
+
+
+def service_stop(service_name, **kwargs):
+    """Stop a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('stop', service_name, **kwargs)
+
+
+def service_restart(service_name, **kwargs):
+    """Restart a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be restarted. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_restart('ceph-osd', id=4)
+
+    :param service_name: the name of the service to restart
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    return service('restart', service_name)
+
+
+def service_reload(service_name, restart_on_failure=False, **kwargs):
+    """Reload a system service, optionally falling back to restart if
+    reload fails.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_reload('ceph-osd', id=4)
+
+    :param service_name: the name of the service to reload
+    :param restart_on_failure: boolean indicating whether to fallback to a
+                               restart if the reload fails.
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    service_result = service('reload', service_name, **kwargs)
+    if not service_result and restart_on_failure:
+        service_result = service('restart', service_name, **kwargs)
+    return service_result
+
+
+def service_pause(service_name, init_dir="/etc/init", initd_dir="/etc/init.d",
+                  **kwargs):
+    """Pause a system service.
+
+    Stop it, and prevent it from starting again at boot.
+
+    :param service_name: the name of the service to pause
+    :param init_dir: path to the upstart init directory
+    :param initd_dir: path to the sysv init directory
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for init systems which do not support
+                     key=value arguments via the commandline.
+    """
+    stopped = True
+    if service_running(service_name, **kwargs):
+        stopped = service_stop(service_name, **kwargs)
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('disable', service_name)
+        service('mask', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        with open(override_path, 'w') as fh:
+            fh.write("manual\n")
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "disable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    return stopped
+
+
+def service_resume(service_name, init_dir="/etc/init",
+                   initd_dir="/etc/init.d", **kwargs):
+    """Resume a system service.
+
+    Reenable starting again at boot. Start the service.
+
+    :param service_name: the name of the service to resume
+    :param init_dir: the path to the init dir
+    :param initd dir: the path to the initd dir
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('unmask', service_name)
+        service('enable', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        if os.path.exists(override_path):
+            os.unlink(override_path)
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "enable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    started = service_running(service_name, **kwargs)
+
+    if not started:
+        started = service_start(service_name, **kwargs)
+    return started
+
+
+def service(action, service_name, **kwargs):
+    """Control a system service.
+
+    :param action: the action to take on the service
+    :param service_name: the name of the service to perform th action on
+    :param **kwargs: additional params to be passed to the service command in
+                    the form of key=value.
+    """
+    if init_is_systemd():
+        cmd = ['systemctl', action, service_name]
+    else:
+        cmd = ['service', service_name, action]
+        for key, value in six.iteritems(kwargs):
+            parameter = '%s=%s' % (key, value)
+            cmd.append(parameter)
+    return subprocess.call(cmd) == 0
+
+
+_UPSTART_CONF = "/etc/init/{}.conf"
+_INIT_D_CONF = "/etc/init.d/{}"
+
+
+def service_running(service_name, **kwargs):
+    """Determine whether a system service is running.
+
+    :param service_name: the name of the service
+    :param **kwargs: additional args to pass to the service command. This is
+                     used to pass additional key=value arguments to the
+                     service command line for managing specific instance
+                     units (e.g. service ceph-osd status id=2). The kwargs
+                     are ignored in systemd services.
+    """
+    if init_is_systemd():
+        return service('is-active', service_name)
+    else:
+        if os.path.exists(_UPSTART_CONF.format(service_name)):
+            try:
+                cmd = ['status', service_name]
+                for key, value in six.iteritems(kwargs):
+                    parameter = '%s=%s' % (key, value)
+                    cmd.append(parameter)
+                output = subprocess.check_output(
+                    cmd, stderr=subprocess.STDOUT).decode('UTF-8')
+            except subprocess.CalledProcessError:
+                return False
+            else:
+                # This works for upstart scripts where the 'service' command
+                # returns a consistent string to represent running
+                # 'start/running'
+                if ("start/running" in output or
+                        "is running" in output or
+                        "up and running" in output):
+                    return True
+        elif os.path.exists(_INIT_D_CONF.format(service_name)):
+            # Check System V scripts init script return codes
+            return service('status', service_name)
+        return False
+
+
+SYSTEMD_SYSTEM = '/run/systemd/system'
+
+
+def init_is_systemd():
+    """Return True if the host system uses systemd, False otherwise."""
+    if lsb_release()['DISTRIB_CODENAME'] == 'trusty':
+        return False
+    return os.path.isdir(SYSTEMD_SYSTEM)
+
+
+def adduser(username, password=None, shell='/bin/bash',
+            system_user=False, primary_group=None,
+            secondary_groups=None, uid=None, home_dir=None):
+    """Add a user to the system.
+
+    Will log but otherwise succeed if the user already exists.
+
+    :param str username: Username to create
+    :param str password: Password for user; if ``None``, create a system user
+    :param str shell: The default shell for the user
+    :param bool system_user: Whether to create a login or system user
+    :param str primary_group: Primary group for user; defaults to username
+    :param list secondary_groups: Optional list of additional groups
+    :param int uid: UID for user being created
+    :param str home_dir: Home directory for user
+
+    :returns: The password database entry struct, as returned by `pwd.getpwnam`
+    """
+    try:
+        user_info = pwd.getpwnam(username)
+        log('user {0} already exists!'.format(username))
+        if uid:
+            user_info = pwd.getpwuid(int(uid))
+            log('user with uid {0} already exists!'.format(uid))
+    except KeyError:
+        log('creating user {0}'.format(username))
+        cmd = ['useradd']
+        if uid:
+            cmd.extend(['--uid', str(uid)])
+        if home_dir:
+            cmd.extend(['--home', str(home_dir)])
+        if system_user or password is None:
+            cmd.append('--system')
+        else:
+            cmd.extend([
+                '--create-home',
+                '--shell', shell,
+                '--password', password,
+            ])
+        if not primary_group:
+            try:
+                grp.getgrnam(username)
+                primary_group = username  # avoid "group exists" error
+            except KeyError:
+                pass
+        if primary_group:
+            cmd.extend(['-g', primary_group])
+        if secondary_groups:
+            cmd.extend(['-G', ','.join(secondary_groups)])
+        cmd.append(username)
+        subprocess.check_call(cmd)
+        user_info = pwd.getpwnam(username)
+    return user_info
+
+
+def user_exists(username):
+    """Check if a user exists"""
+    try:
+        pwd.getpwnam(username)
+        user_exists = True
+    except KeyError:
+        user_exists = False
+    return user_exists
+
+
+def uid_exists(uid):
+    """Check if a uid exists"""
+    try:
+        pwd.getpwuid(uid)
+        uid_exists = True
+    except KeyError:
+        uid_exists = False
+    return uid_exists
+
+
+def group_exists(groupname):
+    """Check if a group exists"""
+    try:
+        grp.getgrnam(groupname)
+        group_exists = True
+    except KeyError:
+        group_exists = False
+    return group_exists
+
+
+def gid_exists(gid):
+    """Check if a gid exists"""
+    try:
+        grp.getgrgid(gid)
+        gid_exists = True
+    except KeyError:
+        gid_exists = False
+    return gid_exists
+
+
+def add_group(group_name, system_group=False, gid=None):
+    """Add a group to the system
+
+    Will log but otherwise succeed if the group already exists.
+
+    :param str group_name: group to create
+    :param bool system_group: Create system group
+    :param int gid: GID for user being created
+
+    :returns: The password database entry struct, as returned by `grp.getgrnam`
+    """
+    try:
+        group_info = grp.getgrnam(group_name)
+        log('group {0} already exists!'.format(group_name))
+        if gid:
+            group_info = grp.getgrgid(gid)
+            log('group with gid {0} already exists!'.format(gid))
+    except KeyError:
+        log('creating group {0}'.format(group_name))
+        add_new_group(group_name, system_group, gid)
+        group_info = grp.getgrnam(group_name)
+    return group_info
+
+
+def add_user_to_group(username, group):
+    """Add a user to a group"""
+    cmd = ['gpasswd', '-a', username, group]
+    log("Adding user {} to group {}".format(username, group))
+    subprocess.check_call(cmd)
+
+
+def chage(username, lastday=None, expiredate=None, inactive=None,
+          mindays=None, maxdays=None, root=None, warndays=None):
+    """Change user password expiry information
+
+    :param str username: User to update
+    :param str lastday: Set when password was changed in YYYY-MM-DD format
+    :param str expiredate: Set when user's account will no longer be
+                           accessible in YYYY-MM-DD format.
+                           -1 will remove an account expiration date.
+    :param str inactive: Set the number of days of inactivity after a password
+                         has expired before the account is locked.
+                         -1 will remove an account's inactivity.
+    :param str mindays: Set the minimum number of days between password
+                        changes to MIN_DAYS.
+                        0 indicates the password can be changed anytime.
+    :param str maxdays: Set the maximum number of days during which a
+                        password is valid.
+                        -1 as MAX_DAYS will remove checking maxdays
+    :param str root: Apply changes in the CHROOT_DIR directory
+    :param str warndays: Set the number of days of warning before a password
+                         change is required
+    :raises subprocess.CalledProcessError: if call to chage fails
+    """
+    cmd = ['chage']
+    if root:
+        cmd.extend(['--root', root])
+    if lastday:
+        cmd.extend(['--lastday', lastday])
+    if expiredate:
+        cmd.extend(['--expiredate', expiredate])
+    if inactive:
+        cmd.extend(['--inactive', inactive])
+    if mindays:
+        cmd.extend(['--mindays', mindays])
+    if maxdays:
+        cmd.extend(['--maxdays', maxdays])
+    if warndays:
+        cmd.extend(['--warndays', warndays])
+    cmd.append(username)
+    subprocess.check_call(cmd)
+
+
+remove_password_expiry = functools.partial(chage, expiredate='-1', inactive='-1', mindays='0', maxdays='-1')
+
+
+def rsync(from_path, to_path, flags='-r', options=None, timeout=None):
+    """Replicate the contents of a path"""
+    options = options or ['--delete', '--executability']
+    cmd = ['/usr/bin/rsync', flags]
+    if timeout:
+        cmd = ['timeout', str(timeout)] + cmd
+    cmd.extend(options)
+    cmd.append(from_path)
+    cmd.append(to_path)
+    log(" ".join(cmd))
+    return subprocess.check_output(cmd, stderr=subprocess.STDOUT).decode('UTF-8').strip()
+
+
+def symlink(source, destination):
+    """Create a symbolic link"""
+    log("Symlinking {} as {}".format(source, destination))
+    cmd = [
+        'ln',
+        '-sf',
+        source,
+        destination,
+    ]
+    subprocess.check_call(cmd)
+
+
+def mkdir(path, owner='root', group='root', perms=0o555, force=False):
+    """Create a directory"""
+    log("Making dir {} {}:{} {:o}".format(path, owner, group,
+                                          perms))
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    realpath = os.path.abspath(path)
+    path_exists = os.path.exists(realpath)
+    if path_exists and force:
+        if not os.path.isdir(realpath):
+            log("Removing non-directory file {} prior to mkdir()".format(path))
+            os.unlink(realpath)
+            os.makedirs(realpath, perms)
+    elif not path_exists:
+        os.makedirs(realpath, perms)
+    os.chown(realpath, uid, gid)
+    os.chmod(realpath, perms)
+
+
+def write_file(path, content, owner='root', group='root', perms=0o444):
+    """Create or overwrite a file with the contents of a byte string."""
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    # lets see if we can grab the file and compare the context, to avoid doing
+    # a write.
+    existing_content = None
+    existing_uid, existing_gid, existing_perms = None, None, None
+    try:
+        with open(path, 'rb') as target:
+            existing_content = target.read()
+        stat = os.stat(path)
+        existing_uid, existing_gid, existing_perms = (
+            stat.st_uid, stat.st_gid, stat.st_mode
+        )
+    except Exception:
+        pass
+    if content != existing_content:
+        log("Writing file {} {}:{} {:o}".format(path, owner, group, perms),
+            level=DEBUG)
+        with open(path, 'wb') as target:
+            os.fchown(target.fileno(), uid, gid)
+            os.fchmod(target.fileno(), perms)
+            if six.PY3 and isinstance(content, six.string_types):
+                content = content.encode('UTF-8')
+            target.write(content)
+        return
+    # the contents were the same, but we might still need to change the
+    # ownership or permissions.
+    if existing_uid != uid:
+        log("Changing uid on already existing content: {} -> {}"
+            .format(existing_uid, uid), level=DEBUG)
+        os.chown(path, uid, -1)
+    if existing_gid != gid:
+        log("Changing gid on already existing content: {} -> {}"
+            .format(existing_gid, gid), level=DEBUG)
+        os.chown(path, -1, gid)
+    if existing_perms != perms:
+        log("Changing permissions on existing content: {} -> {}"
+            .format(existing_perms, perms), level=DEBUG)
+        os.chmod(path, perms)
+
+
+def fstab_remove(mp):
+    """Remove the given mountpoint entry from /etc/fstab"""
+    return Fstab.remove_by_mountpoint(mp)
+
+
+def fstab_add(dev, mp, fs, options=None):
+    """Adds the given device entry to the /etc/fstab file"""
+    return Fstab.add(dev, mp, fs, options=options)
+
+
+def mount(device, mountpoint, options=None, persist=False, filesystem="ext3"):
+    """Mount a filesystem at a particular mountpoint"""
+    cmd_args = ['mount']
+    if options is not None:
+        cmd_args.extend(['-o', options])
+    cmd_args.extend([device, mountpoint])
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error mounting {} at {}\n{}'.format(device, mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_add(device, mountpoint, filesystem, options=options)
+    return True
+
+
+def umount(mountpoint, persist=False):
+    """Unmount a filesystem"""
+    cmd_args = ['umount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_remove(mountpoint)
+    return True
+
+
+def mounts():
+    """Get a list of all mounted volumes as [[mountpoint,device],[...]]"""
+    with open('/proc/mounts') as f:
+        # [['/mount/point','/dev/path'],[...]]
+        system_mounts = [m[1::-1] for m in [l.strip().split()
+                                            for l in f.readlines()]]
+    return system_mounts
+
+
+def fstab_mount(mountpoint):
+    """Mount filesystem using fstab"""
+    cmd_args = ['mount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+    return True
+
+
+def file_hash(path, hash_type='md5'):
+    """Generate a hash checksum of the contents of 'path' or None if not found.
+
+    :param str hash_type: Any hash alrgorithm supported by :mod:`hashlib`,
+                          such as md5, sha1, sha256, sha512, etc.
+    """
+    if os.path.exists(path):
+        h = getattr(hashlib, hash_type)()
+        with open(path, 'rb') as source:
+            h.update(source.read())
+        return h.hexdigest()
+    else:
+        return None
+
+
+def path_hash(path):
+    """Generate a hash checksum of all files matching 'path'. Standard
+    wildcards like '*' and '?' are supported, see documentation for the 'glob'
+    module for more information.
+
+    :return: dict: A { filename: hash } dictionary for all matched files.
+                   Empty if none found.
+    """
+    return {
+        filename: file_hash(filename)
+        for filename in glob.iglob(path)
+    }
+
+
+def check_hash(path, checksum, hash_type='md5'):
+    """Validate a file using a cryptographic checksum.
+
+    :param str checksum: Value of the checksum used to validate the file.
+    :param str hash_type: Hash algorithm used to generate `checksum`.
+        Can be any hash alrgorithm supported by :mod:`hashlib`,
+        such as md5, sha1, sha256, sha512, etc.
+    :raises ChecksumError: If the file fails the checksum
+
+    """
+    actual_checksum = file_hash(path, hash_type)
+    if checksum != actual_checksum:
+        raise ChecksumError("'%s' != '%s'" % (checksum, actual_checksum))
+
+
+class ChecksumError(ValueError):
+    """A class derived from Value error to indicate the checksum failed."""
+    pass
+
+
+def restart_on_change(restart_map, stopstart=False, restart_functions=None):
+    """Restart services based on configuration files changing
+
+    This function is used a decorator, for example::
+
+        @restart_on_change({
+            '/etc/ceph/ceph.conf': [ 'cinder-api', 'cinder-volume' ]
+            '/etc/apache/sites-enabled/*': [ 'apache2' ]
+            })
+        def config_changed():
+            pass  # your code here
+
+    In this example, the cinder-api and cinder-volume services
+    would be restarted if /etc/ceph/ceph.conf is changed by the
+    ceph_client_changed function. The apache2 service would be
+    restarted if any file matching the pattern got changed, created
+    or removed. Standard wildcards are supported, see documentation
+    for the 'glob' module for more information.
+
+    @param restart_map: {path_file_name: [service_name, ...]
+    @param stopstart: DEFAULT false; whether to stop, start OR restart
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result from decorated function
+    """
+    def wrap(f):
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), restart_map, stopstart,
+                restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def restart_on_change_helper(lambda_f, restart_map, stopstart=False,
+                             restart_functions=None):
+    """Helper function to perform the restart_on_change function.
+
+    This is provided for decorators to restart services if files described
+    in the restart_map have changed after an invocation of lambda_f().
+
+    @param lambda_f: function to call.
+    @param restart_map: {file: [service, ...]}
+    @param stopstart: whether to stop, start or restart a service
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result of lambda_f()
+    """
+    if restart_functions is None:
+        restart_functions = {}
+    checksums = {path: path_hash(path) for path in restart_map}
+    r = lambda_f()
+    # create a list of lists of the services to restart
+    restarts = [restart_map[path]
+                for path in restart_map
+                if path_hash(path) != checksums[path]]
+    # create a flat list of ordered services without duplicates from lists
+    services_list = list(OrderedDict.fromkeys(itertools.chain(*restarts)))
+    if services_list:
+        actions = ('stop', 'start') if stopstart else ('restart',)
+        for service_name in services_list:
+            if service_name in restart_functions:
+                restart_functions[service_name](service_name)
+            else:
+                for action in actions:
+                    service(action, service_name)
+    return r
+
+
+def pwgen(length=None):
+    """Generate a random pasword."""
+    if length is None:
+        # A random length is ok to use a weak PRNG
+        length = random.choice(range(35, 45))
+    alphanumeric_chars = [
+        l for l in (string.ascii_letters + string.digits)
+        if l not in 'l0QD1vAEIOUaeiou']
+    # Use a crypto-friendly PRNG (e.g. /dev/urandom) for making the
+    # actual password
+    random_generator = random.SystemRandom()
+    random_chars = [
+        random_generator.choice(alphanumeric_chars) for _ in range(length)]
+    return(''.join(random_chars))
+
+
+def is_phy_iface(interface):
+    """Returns True if interface is not virtual, otherwise False."""
+    if interface:
+        sys_net = '/sys/class/net'
+        if os.path.isdir(sys_net):
+            for iface in glob.glob(os.path.join(sys_net, '*')):
+                if '/virtual/' in os.path.realpath(iface):
+                    continue
+
+                if interface == os.path.basename(iface):
+                    return True
+
+    return False
+
+
+def get_bond_master(interface):
+    """Returns bond master if interface is bond slave otherwise None.
+
+    NOTE: the provided interface is expected to be physical
+    """
+    if interface:
+        iface_path = '/sys/class/net/%s' % (interface)
+        if os.path.exists(iface_path):
+            if '/virtual/' in os.path.realpath(iface_path):
+                return None
+
+            master = os.path.join(iface_path, 'master')
+            if os.path.exists(master):
+                master = os.path.realpath(master)
+                # make sure it is a bond master
+                if os.path.exists(os.path.join(master, 'bonding')):
+                    return os.path.basename(master)
+
+    return None
+
+
+def list_nics(nic_type=None):
+    """Return a list of nics of given type(s)"""
+    if isinstance(nic_type, six.string_types):
+        int_types = [nic_type]
+    else:
+        int_types = nic_type
+
+    interfaces = []
+    if nic_type:
+        for int_type in int_types:
+            cmd = ['ip', 'addr', 'show', 'label', int_type + '*']
+            ip_output = subprocess.check_output(cmd).decode('UTF-8')
+            ip_output = ip_output.split('\n')
+            ip_output = (line for line in ip_output if line)
+            for line in ip_output:
+                if line.split()[1].startswith(int_type):
+                    matched = re.search('.*: (' + int_type +
+                                        r'[0-9]+\.[0-9]+)@.*', line)
+                    if matched:
+                        iface = matched.groups()[0]
+                    else:
+                        iface = line.split()[1].replace(":", "")
+
+                    if iface not in interfaces:
+                        interfaces.append(iface)
+    else:
+        cmd = ['ip', 'a']
+        ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+        ip_output = (line.strip() for line in ip_output if line)
+
+        key = re.compile(r'^[0-9]+:\s+(.+):')
+        for line in ip_output:
+            matched = re.search(key, line)
+            if matched:
+                iface = matched.group(1)
+                iface = iface.partition("@")[0]
+                if iface not in interfaces:
+                    interfaces.append(iface)
+
+    return interfaces
+
+
+def set_nic_mtu(nic, mtu):
+    """Set the Maximum Transmission Unit (MTU) on a network interface."""
+    cmd = ['ip', 'link', 'set', nic, 'mtu', mtu]
+    subprocess.check_call(cmd)
+
+
+def get_nic_mtu(nic):
+    """Return the Maximum Transmission Unit (MTU) for a network interface."""
+    cmd = ['ip', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+    mtu = ""
+    for line in ip_output:
+        words = line.split()
+        if 'mtu' in words:
+            mtu = words[words.index("mtu") + 1]
+    return mtu
+
+
+def get_nic_hwaddr(nic):
+    """Return the Media Access Control (MAC) for a network interface."""
+    cmd = ['ip', '-o', '-0', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8')
+    hwaddr = ""
+    words = ip_output.split()
+    if 'link/ether' in words:
+        hwaddr = words[words.index('link/ether') + 1]
+    return hwaddr
+
+
+@contextmanager
+def chdir(directory):
+    """Change the current working directory to a different directory for a code
+    block and return the previous directory after the block exits. Useful to
+    run commands from a specificed directory.
+
+    :param str directory: The directory path to change to for this context.
+    """
+    cur = os.getcwd()
+    try:
+        yield os.chdir(directory)
+    finally:
+        os.chdir(cur)
+
+
+def chownr(path, owner, group, follow_links=True, chowntopdir=False):
+    """Recursively change user and group ownership of files and directories
+    in given path. Doesn't chown path itself by default, only its children.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    :param bool follow_links: Also follow and chown links if True
+    :param bool chowntopdir: Also chown path itself if True
+    """
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    if follow_links:
+        chown = os.chown
+    else:
+        chown = os.lchown
+
+    if chowntopdir:
+        broken_symlink = os.path.lexists(path) and not os.path.exists(path)
+        if not broken_symlink:
+            chown(path, uid, gid)
+    for root, dirs, files in os.walk(path, followlinks=follow_links):
+        for name in dirs + files:
+            full = os.path.join(root, name)
+            broken_symlink = os.path.lexists(full) and not os.path.exists(full)
+            if not broken_symlink:
+                chown(full, uid, gid)
+
+
+def lchownr(path, owner, group):
+    """Recursively change user and group ownership of files and directories
+    in a given path, not following symbolic links. See the documentation for
+    'os.lchown' for more information.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    """
+    chownr(path, owner, group, follow_links=False)
+
+
+def owner(path):
+    """Returns a tuple containing the username & groupname owning the path.
+
+    :param str path: the string path to retrieve the ownership
+    :return tuple(str, str): A (username, groupname) tuple containing the
+                             name of the user and group owning the path.
+    :raises OSError: if the specified path does not exist
+    """
+    stat = os.stat(path)
+    username = pwd.getpwuid(stat.st_uid)[0]
+    groupname = grp.getgrgid(stat.st_gid)[0]
+    return username, groupname
+
+
+def get_total_ram():
+    """The total amount of system RAM in bytes.
+
+    This is what is reported by the OS, and may be overcommitted when
+    there are multiple containers hosted on the same machine.
+    """
+    with open('/proc/meminfo', 'r') as f:
+        for line in f.readlines():
+            if line:
+                key, value, unit = line.split()
+                if key == 'MemTotal:':
+                    assert unit == 'kB', 'Unknown unit'
+                    return int(value) * 1024  # Classic, not KiB.
+        raise NotImplementedError()
+
+
+UPSTART_CONTAINER_TYPE = '/run/container_type'
+
+
+def is_container():
+    """Determine whether unit is running in a container
+
+    @return: boolean indicating if unit is in a container
+    """
+    if init_is_systemd():
+        # Detect using systemd-detect-virt
+        return subprocess.call(['systemd-detect-virt',
+                                '--container']) == 0
+    else:
+        # Detect using upstart container file marker
+        return os.path.exists(UPSTART_CONTAINER_TYPE)
+
+
+def add_to_updatedb_prunepath(path, updatedb_path=UPDATEDB_PATH):
+    """Adds the specified path to the mlocate's udpatedb.conf PRUNEPATH list.
+
+    This method has no effect if the path specified by updatedb_path does not
+    exist or is not a file.
+
+    @param path: string the path to add to the updatedb.conf PRUNEPATHS value
+    @param updatedb_path: the path the updatedb.conf file
+    """
+    if not os.path.exists(updatedb_path) or os.path.isdir(updatedb_path):
+        # If the updatedb.conf file doesn't exist then don't attempt to update
+        # the file as the package providing mlocate may not be installed on
+        # the local system
+        return
+
+    with open(updatedb_path, 'r+') as f_id:
+        updatedb_text = f_id.read()
+        output = updatedb(updatedb_text, path)
+        f_id.seek(0)
+        f_id.write(output)
+        f_id.truncate()
+
+
+def updatedb(updatedb_text, new_path):
+    lines = [line for line in updatedb_text.split("\n")]
+    for i, line in enumerate(lines):
+        if line.startswith("PRUNEPATHS="):
+            paths_line = line.split("=")[1].replace('"', '')
+            paths = paths_line.split(" ")
+            if new_path not in paths:
+                paths.append(new_path)
+                lines[i] = 'PRUNEPATHS="{}"'.format(' '.join(paths))
+    output = "\n".join(lines)
+    return output
+
+
+def modulo_distribution(modulo=3, wait=30, non_zero_wait=False):
+    """ Modulo distribution
+
+    This helper uses the unit number, a modulo value and a constant wait time
+    to produce a calculated wait time distribution. This is useful in large
+    scale deployments to distribute load during an expensive operation such as
+    service restarts.
+
+    If you have 1000 nodes that need to restart 100 at a time 1 minute at a
+    time:
+
+      time.wait(modulo_distribution(modulo=100, wait=60))
+      restart()
+
+    If you need restarts to happen serially set modulo to the exact number of
+    nodes and set a high constant wait time:
+
+      time.wait(modulo_distribution(modulo=10, wait=120))
+      restart()
+
+    @param modulo: int The modulo number creates the group distribution
+    @param wait: int The constant time wait value
+    @param non_zero_wait: boolean Override unit % modulo == 0,
+                          return modulo * wait. Used to avoid collisions with
+                          leader nodes which are often given priority.
+    @return: int Calculated time to wait for unit operation
+    """
+    unit_number = int(local_unit().split('/')[1])
+    calculated_wait_time = (unit_number % modulo) * wait
+    if non_zero_wait and calculated_wait_time == 0:
+        return modulo * wait
+    else:
+        return calculated_wait_time
+
+
+def install_ca_cert(ca_cert, name=None):
+    """
+    Install the given cert as a trusted CA.
+
+    The ``name`` is the stem of the filename where the cert is written, and if
+    not provided, it will default to ``juju-{charm_name}``.
+
+    If the cert is empty or None, or is unchanged, nothing is done.
+    """
+    if not ca_cert:
+        return
+    if not isinstance(ca_cert, bytes):
+        ca_cert = ca_cert.encode('utf8')
+    if not name:
+        name = 'juju-{}'.format(charm_name())
+    cert_file = '/usr/local/share/ca-certificates/{}.crt'.format(name)
+    new_hash = hashlib.md5(ca_cert).hexdigest()
+    if file_hash(cert_file) == new_hash:
+        return
+    log("Installing new CA cert at: {}".format(cert_file), level=INFO)
+    write_file(cert_file, ca_cert)
+    subprocess.check_call(['update-ca-certificates', '--fresh'])
+
+
+def get_system_env(key, default=None):
+    """Get data from system environment as represented in ``/etc/environment``.
+
+    :param key: Key to look up
+    :type key: str
+    :param default: Value to return if key is not found
+    :type default: any
+    :returns: Value for key if found or contents of default parameter
+    :rtype: any
+    :raises: subprocess.CalledProcessError
+    """
+    env_file = '/etc/environment'
+    # use the shell and env(1) to parse the global environments file.  This is
+    # done to get the correct result even if the user has shell variable
+    # substitutions or other shell logic in that file.
+    output = subprocess.check_output(
+        ['env', '-i', '/bin/bash', '-c',
+         'set -a && source {} && env'.format(env_file)],
+        universal_newlines=True)
+    for k, v in (line.split('=', 1)
+                 for line in output.splitlines() if '=' in line):
+        if k == key:
+            return v
+    else:
+        return default
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..7781a3961f23ce0b161ae08b11710466af8de814
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/centos.py
@@ -0,0 +1,72 @@
+import subprocess
+import yum
+import os
+
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Host releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+
+    def __init__(self, item):
+        raise NotImplementedError(
+            "CompareHostReleases() is not implemented for CentOS")
+
+
+def service_available(service_name):
+    # """Determine whether a system service is available."""
+    if os.path.isdir('/run/systemd/system'):
+        cmd = ['systemctl', 'is-enabled', service_name]
+    else:
+        cmd = ['service', service_name, 'is-enabled']
+    return subprocess.call(cmd) == 0
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['groupadd']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('-r')
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/os-release in a dict."""
+    d = {}
+    with open('/etc/os-release', 'r') as lsb:
+        for l in lsb:
+            s = l.split('=')
+            if len(s) != 2:
+                continue
+            d[s[0].strip()] = s[1].strip()
+    return d
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports YumBase function if the pkgcache argument
+    is None.
+    """
+    if not pkgcache:
+        y = yum.YumBase()
+        packages = y.doPackageLists()
+        pkgcache = {i.Name: i.version for i in packages['installed']}
+    pkg = pkgcache[package]
+    if pkg > revno:
+        return 1
+    if pkg < revno:
+        return -1
+    return 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3edc0687275b29762b45ebf3fe1b045bc9f568b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/host_factory/ubuntu.py
@@ -0,0 +1,116 @@
+import subprocess
+
+from charmhelpers.core.hookenv import cached
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+UBUNTU_RELEASES = (
+    'lucid',
+    'maverick',
+    'natty',
+    'oneiric',
+    'precise',
+    'quantal',
+    'raring',
+    'saucy',
+    'trusty',
+    'utopic',
+    'vivid',
+    'wily',
+    'xenial',
+    'yakkety',
+    'zesty',
+    'artful',
+    'bionic',
+    'cosmic',
+    'disco',
+    'eoan',
+    'focal'
+)
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Ubuntu releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+    _list = UBUNTU_RELEASES
+
+
+def service_available(service_name):
+    """Determine whether a system service is available"""
+    try:
+        subprocess.check_output(
+            ['service', service_name, 'status'],
+            stderr=subprocess.STDOUT).decode('UTF-8')
+    except subprocess.CalledProcessError as e:
+        return b'unrecognized service' not in e.output
+    else:
+        return True
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['addgroup']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('--system')
+    else:
+        cmd.extend([
+            '--group',
+        ])
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/lsb-release in a dict"""
+    d = {}
+    with open('/etc/lsb-release', 'r') as lsb:
+        for l in lsb:
+            k, v = l.split('=')
+            d[k.strip()] = v.strip()
+    return d
+
+
+def get_distrib_codename():
+    """Return the codename of the distribution
+    :returns: The codename
+    :rtype: str
+    """
+    return lsb_release()['DISTRIB_CODENAME'].lower()
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports apt_cache function from charmhelpers.fetch if
+    the pkgcache argument is None. Be sure to add charmhelpers.fetch if
+    you call this function, or pass an apt_pkg.Cache() instance.
+    """
+    from charmhelpers.fetch import apt_pkg
+    if not pkgcache:
+        from charmhelpers.fetch import apt_cache
+        pkgcache = apt_cache()
+    pkg = pkgcache[package]
+    return apt_pkg.version_compare(pkg.current_ver.ver_str, revno)
+
+
+@cached
+def arch():
+    """Return the package architecture as a string.
+
+    :returns: the architecture
+    :rtype: str
+    :raises: subprocess.CalledProcessError if dpkg command fails
+    """
+    return subprocess.check_output(
+        ['dpkg', '--print-architecture']
+    ).rstrip().decode('UTF-8')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hugepage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hugepage.py
new file mode 100644
index 0000000000000000000000000000000000000000..54b5b5e2fcf81eea5f2ebfbceb620ea68d725584
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/hugepage.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+from charmhelpers.core import fstab
+from charmhelpers.core import sysctl
+from charmhelpers.core.host import (
+    add_group,
+    add_user_to_group,
+    fstab_mount,
+    mkdir,
+)
+from charmhelpers.core.strutils import bytes_from_string
+from subprocess import check_output
+
+
+def hugepage_support(user, group='hugetlb', nr_hugepages=256,
+                     max_map_count=65536, mnt_point='/run/hugepages/kvm',
+                     pagesize='2MB', mount=True, set_shmmax=False):
+    """Enable hugepages on system.
+
+    Args:
+    user (str)  -- Username to allow access to hugepages to
+    group (str) -- Group name to own hugepages
+    nr_hugepages (int) -- Number of pages to reserve
+    max_map_count (int) -- Number of Virtual Memory Areas a process can own
+    mnt_point (str) -- Directory to mount hugepages on
+    pagesize (str) -- Size of hugepages
+    mount (bool) -- Whether to Mount hugepages
+    """
+    group_info = add_group(group)
+    gid = group_info.gr_gid
+    add_user_to_group(user, group)
+    if max_map_count < 2 * nr_hugepages:
+        max_map_count = 2 * nr_hugepages
+    sysctl_settings = {
+        'vm.nr_hugepages': nr_hugepages,
+        'vm.max_map_count': max_map_count,
+        'vm.hugetlb_shm_group': gid,
+    }
+    if set_shmmax:
+        shmmax_current = int(check_output(['sysctl', '-n', 'kernel.shmmax']))
+        shmmax_minsize = bytes_from_string(pagesize) * nr_hugepages
+        if shmmax_minsize > shmmax_current:
+            sysctl_settings['kernel.shmmax'] = shmmax_minsize
+    sysctl.create(yaml.dump(sysctl_settings), '/etc/sysctl.d/10-hugepage.conf')
+    mkdir(mnt_point, owner='root', group='root', perms=0o755, force=False)
+    lfstab = fstab.Fstab()
+    fstab_entry = lfstab.get_entry_by_attr('mountpoint', mnt_point)
+    if fstab_entry:
+        lfstab.remove_entry(fstab_entry)
+    entry = lfstab.Entry('nodev', mnt_point, 'hugetlbfs',
+                         'mode=1770,gid={},pagesize={}'.format(gid, pagesize), 0, 0)
+    lfstab.add_entry(entry)
+    if mount:
+        fstab_mount(mnt_point)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel.py
new file mode 100644
index 0000000000000000000000000000000000000000..e01f4f8ba73ee0d5ab7553740c2590a50e42f96d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel.py
@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+from charmhelpers.osplatform import get_platform
+from charmhelpers.core.hookenv import (
+    log,
+    INFO
+)
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.kernel_factory.ubuntu import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.kernel_factory.centos import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def modprobe(module, persist=True):
+    """Load a kernel module and configure for auto-load on reboot."""
+    cmd = ['modprobe', module]
+
+    log('Loading kernel module %s' % module, level=INFO)
+
+    subprocess.check_call(cmd)
+    if persist:
+        persistent_modprobe(module)
+
+
+def rmmod(module, force=False):
+    """Remove a module from the linux kernel"""
+    cmd = ['rmmod']
+    if force:
+        cmd.append('-f')
+    cmd.append(module)
+    log('Removing kernel module %s' % module, level=INFO)
+    return subprocess.check_call(cmd)
+
+
+def lsmod():
+    """Shows what kernel modules are currently loaded"""
+    return subprocess.check_output(['lsmod'],
+                                   universal_newlines=True)
+
+
+def is_module_loaded(module):
+    """Checks if a kernel module is already loaded"""
+    matches = re.findall('^%s[ ]+' % module, lsmod(), re.M)
+    return len(matches) > 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c402c1157900ff1ad5c6c296a409c9e8fb96d2b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/centos.py
@@ -0,0 +1,17 @@
+import subprocess
+import os
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    if not os.path.exists('/etc/rc.modules'):
+        open('/etc/rc.modules', 'a')
+        os.chmod('/etc/rc.modules', 111)
+    with open('/etc/rc.modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write('modprobe %s\n' % module)
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["dracut", "-f", version])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3de372fd3df38fe151cf79243f129cb504516f22
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/kernel_factory/ubuntu.py
@@ -0,0 +1,13 @@
+import subprocess
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    with open('/etc/modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write(module + "\n")
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["update-initramfs", "-k", version, "-u"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61fd074edc09de434859e48ae1b36baef0503708
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .base import *  # NOQA
+from .helpers import *  # NOQA
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..179ad4f0c367dd6b13c10b201c3752d1c8daf05e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/base.py
@@ -0,0 +1,362 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import json
+from inspect import getargspec
+from collections import Iterable, OrderedDict
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+__all__ = ['ServiceManager', 'ManagerCallback',
+           'PortManagerCallback', 'open_ports', 'close_ports', 'manage_ports',
+           'service_restart', 'service_stop']
+
+
+class ServiceManager(object):
+    def __init__(self, services=None):
+        """
+        Register a list of services, given their definitions.
+
+        Service definitions are dicts in the following formats (all keys except
+        'service' are optional)::
+
+            {
+                "service": <service name>,
+                "required_data": <list of required data contexts>,
+                "provided_data": <list of provided data contexts>,
+                "data_ready": <one or more callbacks>,
+                "data_lost": <one or more callbacks>,
+                "start": <one or more callbacks>,
+                "stop": <one or more callbacks>,
+                "ports": <list of ports to manage>,
+            }
+
+        The 'required_data' list should contain dicts of required data (or
+        dependency managers that act like dicts and know how to collect the data).
+        Only when all items in the 'required_data' list are populated are the list
+        of 'data_ready' and 'start' callbacks executed.  See `is_ready()` for more
+        information.
+
+        The 'provided_data' list should contain relation data providers, most likely
+        a subclass of :class:`charmhelpers.core.services.helpers.RelationContext`,
+        that will indicate a set of data to set on a given relation.
+
+        The 'data_ready' value should be either a single callback, or a list of
+        callbacks, to be called when all items in 'required_data' pass `is_ready()`.
+        Each callback will be called with the service name as the only parameter.
+        After all of the 'data_ready' callbacks are called, the 'start' callbacks
+        are fired.
+
+        The 'data_lost' value should be either a single callback, or a list of
+        callbacks, to be called when a 'required_data' item no longer passes
+        `is_ready()`.  Each callback will be called with the service name as the
+        only parameter.  After all of the 'data_lost' callbacks are called,
+        the 'stop' callbacks are fired.
+
+        The 'start' value should be either a single callback, or a list of
+        callbacks, to be called when starting the service, after the 'data_ready'
+        callbacks are complete.  Each callback will be called with the service
+        name as the only parameter.  This defaults to
+        `[host.service_start, services.open_ports]`.
+
+        The 'stop' value should be either a single callback, or a list of
+        callbacks, to be called when stopping the service.  If the service is
+        being stopped because it no longer has all of its 'required_data', this
+        will be called after all of the 'data_lost' callbacks are complete.
+        Each callback will be called with the service name as the only parameter.
+        This defaults to `[services.close_ports, host.service_stop]`.
+
+        The 'ports' value should be a list of ports to manage.  The default
+        'start' handler will open the ports after the service is started,
+        and the default 'stop' handler will close the ports prior to stopping
+        the service.
+
+
+        Examples:
+
+        The following registers an Upstart service called bingod that depends on
+        a mongodb relation and which runs a custom `db_migrate` function prior to
+        restarting the service, and a Runit service called spadesd::
+
+            manager = services.ServiceManager([
+                {
+                    'service': 'bingod',
+                    'ports': [80, 443],
+                    'required_data': [MongoRelation(), config(), {'my': 'data'}],
+                    'data_ready': [
+                        services.template(source='bingod.conf'),
+                        services.template(source='bingod.ini',
+                                          target='/etc/bingod.ini',
+                                          owner='bingo', perms=0400),
+                    ],
+                },
+                {
+                    'service': 'spadesd',
+                    'data_ready': services.template(source='spadesd_run.j2',
+                                                    target='/etc/sv/spadesd/run',
+                                                    perms=0555),
+                    'start': runit_start,
+                    'stop': runit_stop,
+                },
+            ])
+            manager.manage()
+        """
+        self._ready_file = os.path.join(hookenv.charm_dir(), 'READY-SERVICES.json')
+        self._ready = None
+        self.services = OrderedDict()
+        for service in services or []:
+            service_name = service['service']
+            self.services[service_name] = service
+
+    def manage(self):
+        """
+        Handle the current hook by doing The Right Thing with the registered services.
+        """
+        hookenv._run_atstart()
+        try:
+            hook_name = hookenv.hook_name()
+            if hook_name == 'stop':
+                self.stop_services()
+            else:
+                self.reconfigure_services()
+                self.provide_data()
+        except SystemExit as x:
+            if x.code is None or x.code == 0:
+                hookenv._run_atexit()
+        hookenv._run_atexit()
+
+    def provide_data(self):
+        """
+        Set the relation data for each provider in the ``provided_data`` list.
+
+        A provider must have a `name` attribute, which indicates which relation
+        to set data on, and a `provide_data()` method, which returns a dict of
+        data to set.
+
+        The `provide_data()` method can optionally accept two parameters:
+
+          * ``remote_service`` The name of the remote service that the data will
+            be provided to.  The `provide_data()` method will be called once
+            for each connected service (not unit).  This allows the method to
+            tailor its data to the given service.
+          * ``service_ready`` Whether or not the service definition had all of
+            its requirements met, and thus the ``data_ready`` callbacks run.
+
+        Note that the ``provided_data`` methods are now called **after** the
+        ``data_ready`` callbacks are run.  This gives the ``data_ready`` callbacks
+        a chance to generate any data necessary for the providing to the remote
+        services.
+        """
+        for service_name, service in self.services.items():
+            service_ready = self.is_ready(service_name)
+            for provider in service.get('provided_data', []):
+                for relid in hookenv.relation_ids(provider.name):
+                    units = hookenv.related_units(relid)
+                    if not units:
+                        continue
+                    remote_service = units[0].split('/')[0]
+                    argspec = getargspec(provider.provide_data)
+                    if len(argspec.args) > 1:
+                        data = provider.provide_data(remote_service, service_ready)
+                    else:
+                        data = provider.provide_data()
+                    if data:
+                        hookenv.relation_set(relid, data)
+
+    def reconfigure_services(self, *service_names):
+        """
+        Update all files for one or more registered services, and,
+        if ready, optionally restart them.
+
+        If no service names are given, reconfigures all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            if self.is_ready(service_name):
+                self.fire_event('data_ready', service_name)
+                self.fire_event('start', service_name, default=[
+                    service_restart,
+                    manage_ports])
+                self.save_ready(service_name)
+            else:
+                if self.was_ready(service_name):
+                    self.fire_event('data_lost', service_name)
+                self.fire_event('stop', service_name, default=[
+                    manage_ports,
+                    service_stop])
+                self.save_lost(service_name)
+
+    def stop_services(self, *service_names):
+        """
+        Stop one or more registered services, by name.
+
+        If no service names are given, stops all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            self.fire_event('stop', service_name, default=[
+                manage_ports,
+                service_stop])
+
+    def get_service(self, service_name):
+        """
+        Given the name of a registered service, return its service definition.
+        """
+        service = self.services.get(service_name)
+        if not service:
+            raise KeyError('Service not registered: %s' % service_name)
+        return service
+
+    def fire_event(self, event_name, service_name, default=None):
+        """
+        Fire a data_ready, data_lost, start, or stop event on a given service.
+        """
+        service = self.get_service(service_name)
+        callbacks = service.get(event_name, default)
+        if not callbacks:
+            return
+        if not isinstance(callbacks, Iterable):
+            callbacks = [callbacks]
+        for callback in callbacks:
+            if isinstance(callback, ManagerCallback):
+                callback(self, service_name, event_name)
+            else:
+                callback(service_name)
+
+    def is_ready(self, service_name):
+        """
+        Determine if a registered service is ready, by checking its 'required_data'.
+
+        A 'required_data' item can be any mapping type, and is considered ready
+        if `bool(item)` evaluates as True.
+        """
+        service = self.get_service(service_name)
+        reqs = service.get('required_data', [])
+        return all(bool(req) for req in reqs)
+
+    def _load_ready_file(self):
+        if self._ready is not None:
+            return
+        if os.path.exists(self._ready_file):
+            with open(self._ready_file) as fp:
+                self._ready = set(json.load(fp))
+        else:
+            self._ready = set()
+
+    def _save_ready_file(self):
+        if self._ready is None:
+            return
+        with open(self._ready_file, 'w') as fp:
+            json.dump(list(self._ready), fp)
+
+    def save_ready(self, service_name):
+        """
+        Save an indicator that the given service is now data_ready.
+        """
+        self._load_ready_file()
+        self._ready.add(service_name)
+        self._save_ready_file()
+
+    def save_lost(self, service_name):
+        """
+        Save an indicator that the given service is no longer data_ready.
+        """
+        self._load_ready_file()
+        self._ready.discard(service_name)
+        self._save_ready_file()
+
+    def was_ready(self, service_name):
+        """
+        Determine if the given service was previously data_ready.
+        """
+        self._load_ready_file()
+        return service_name in self._ready
+
+
+class ManagerCallback(object):
+    """
+    Special case of a callback that takes the `ServiceManager` instance
+    in addition to the service name.
+
+    Subclasses should implement `__call__` which should accept three parameters:
+
+        * `manager`       The `ServiceManager` instance
+        * `service_name`  The name of the service it's being triggered for
+        * `event_name`    The name of the event that this callback is handling
+    """
+    def __call__(self, manager, service_name, event_name):
+        raise NotImplementedError()
+
+
+class PortManagerCallback(ManagerCallback):
+    """
+    Callback class that will open or close ports, for use as either
+    a start or stop action.
+    """
+    def __call__(self, manager, service_name, event_name):
+        service = manager.get_service(service_name)
+        # turn this generator into a list,
+        # as we'll be going over it multiple times
+        new_ports = list(service.get('ports', []))
+        port_file = os.path.join(hookenv.charm_dir(), '.{}.ports'.format(service_name))
+        if os.path.exists(port_file):
+            with open(port_file) as fp:
+                old_ports = fp.read().split(',')
+            for old_port in old_ports:
+                if bool(old_port) and not self.ports_contains(old_port, new_ports):
+                    hookenv.close_port(old_port)
+        with open(port_file, 'w') as fp:
+            fp.write(','.join(str(port) for port in new_ports))
+        for port in new_ports:
+            # A port is either a number or 'ICMP'
+            protocol = 'TCP'
+            if str(port).upper() == 'ICMP':
+                protocol = 'ICMP'
+            if event_name == 'start':
+                hookenv.open_port(port, protocol)
+            elif event_name == 'stop':
+                hookenv.close_port(port, protocol)
+
+    def ports_contains(self, port, ports):
+        if not bool(port):
+            return False
+        if str(port).upper() != 'ICMP':
+            port = int(port)
+        return port in ports
+
+
+def service_stop(service_name):
+    """
+    Wrapper around host.service_stop to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_running(service_name):
+        host.service_stop(service_name)
+
+
+def service_restart(service_name):
+    """
+    Wrapper around host.service_restart to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_available(service_name):
+        if host.service_running(service_name):
+            host.service_restart(service_name)
+        else:
+            host.service_start(service_name)
+
+
+# Convenience aliases
+open_ports = close_ports = manage_ports = PortManagerCallback()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e6e30d2fe0d9c73ffdc42d70b77e864b6379c53
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/services/helpers.py
@@ -0,0 +1,290 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import yaml
+
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+from charmhelpers.core import templating
+
+from charmhelpers.core.services.base import ManagerCallback
+
+
+__all__ = ['RelationContext', 'TemplateCallback',
+           'render_template', 'template']
+
+
+class RelationContext(dict):
+    """
+    Base class for a context generator that gets relation data from juju.
+
+    Subclasses must provide the attributes `name`, which is the name of the
+    interface of interest, `interface`, which is the type of the interface of
+    interest, and `required_keys`, which is the set of keys required for the
+    relation to be considered complete.  The data for all interfaces matching
+    the `name` attribute that are complete will used to populate the dictionary
+    values (see `get_data`, below).
+
+    The generated context will be namespaced under the relation :attr:`name`,
+    to prevent potential naming conflicts.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = None
+    interface = None
+
+    def __init__(self, name=None, additional_required_keys=None):
+        if not hasattr(self, 'required_keys'):
+            self.required_keys = []
+
+        if name is not None:
+            self.name = name
+        if additional_required_keys:
+            self.required_keys.extend(additional_required_keys)
+        self.get_data()
+
+    def __bool__(self):
+        """
+        Returns True if all of the required_keys are available.
+        """
+        return self.is_ready()
+
+    __nonzero__ = __bool__
+
+    def __repr__(self):
+        return super(RelationContext, self).__repr__()
+
+    def is_ready(self):
+        """
+        Returns True if all of the `required_keys` are available from any units.
+        """
+        ready = len(self.get(self.name, [])) > 0
+        if not ready:
+            hookenv.log('Incomplete relation: {}'.format(self.__class__.__name__), hookenv.DEBUG)
+        return ready
+
+    def _is_ready(self, unit_data):
+        """
+        Helper method that tests a set of relation data and returns True if
+        all of the `required_keys` are present.
+        """
+        return set(unit_data.keys()).issuperset(set(self.required_keys))
+
+    def get_data(self):
+        """
+        Retrieve the relation data for each unit involved in a relation and,
+        if complete, store it in a list under `self[self.name]`.  This
+        is automatically called when the RelationContext is instantiated.
+
+        The units are sorted lexographically first by the service ID, then by
+        the unit ID.  Thus, if an interface has two other services, 'db:1'
+        and 'db:2', with 'db:1' having two units, 'wordpress/0' and 'wordpress/1',
+        and 'db:2' having one unit, 'mediawiki/0', all of which have a complete
+        set of data, the relation data for the units will be stored in the
+        order: 'wordpress/0', 'wordpress/1', 'mediawiki/0'.
+
+        If you only care about a single unit on the relation, you can just
+        access it as `{{ interface[0]['key'] }}`.  However, if you can at all
+        support multiple units on a relation, you should iterate over the list,
+        like::
+
+            {% for unit in interface -%}
+                {{ unit['key'] }}{% if not loop.last %},{% endif %}
+            {%- endfor %}
+
+        Note that since all sets of relation data from all related services and
+        units are in a single list, if you need to know which service or unit a
+        set of data came from, you'll need to extend this class to preserve
+        that information.
+        """
+        if not hookenv.relation_ids(self.name):
+            return
+
+        ns = self.setdefault(self.name, [])
+        for rid in sorted(hookenv.relation_ids(self.name)):
+            for unit in sorted(hookenv.related_units(rid)):
+                reldata = hookenv.relation_get(rid=rid, unit=unit)
+                if self._is_ready(reldata):
+                    ns.append(reldata)
+
+    def provide_data(self):
+        """
+        Return data to be relation_set for this interface.
+        """
+        return {}
+
+
+class MysqlRelation(RelationContext):
+    """
+    Relation context for the `mysql` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'db'
+    interface = 'mysql'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'user', 'password', 'database']
+        RelationContext.__init__(self, *args, **kwargs)
+
+
+class HttpRelation(RelationContext):
+    """
+    Relation context for the `http` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'website'
+    interface = 'http'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'port']
+        RelationContext.__init__(self, *args, **kwargs)
+
+    def provide_data(self):
+        return {
+            'host': hookenv.unit_get('private-address'),
+            'port': 80,
+        }
+
+
+class RequiredConfig(dict):
+    """
+    Data context that loads config options with one or more mandatory options.
+
+    Once the required options have been changed from their default values, all
+    config options will be available, namespaced under `config` to prevent
+    potential naming conflicts (for example, between a config option and a
+    relation property).
+
+    :param list *args: List of options that must be changed from their default values.
+    """
+
+    def __init__(self, *args):
+        self.required_options = args
+        self['config'] = hookenv.config()
+        with open(os.path.join(hookenv.charm_dir(), 'config.yaml')) as fp:
+            self.config = yaml.load(fp).get('options', {})
+
+    def __bool__(self):
+        for option in self.required_options:
+            if option not in self['config']:
+                return False
+            current_value = self['config'][option]
+            default_value = self.config[option].get('default')
+            if current_value == default_value:
+                return False
+            if current_value in (None, '') and default_value in (None, ''):
+                return False
+        return True
+
+    def __nonzero__(self):
+        return self.__bool__()
+
+
+class StoredContext(dict):
+    """
+    A data context that always returns the data that it was first created with.
+
+    This is useful to do a one-time generation of things like passwords, that
+    will thereafter use the same value that was originally generated, instead
+    of generating a new value each time it is run.
+    """
+    def __init__(self, file_name, config_data):
+        """
+        If the file exists, populate `self` with the data from the file.
+        Otherwise, populate with the given data and persist it to the file.
+        """
+        if os.path.exists(file_name):
+            self.update(self.read_context(file_name))
+        else:
+            self.store_context(file_name, config_data)
+            self.update(config_data)
+
+    def store_context(self, file_name, config_data):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'w') as file_stream:
+            os.fchmod(file_stream.fileno(), 0o600)
+            yaml.dump(config_data, file_stream)
+
+    def read_context(self, file_name):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'r') as file_stream:
+            data = yaml.load(file_stream)
+            if not data:
+                raise OSError("%s is empty" % file_name)
+            return data
+
+
+class TemplateCallback(ManagerCallback):
+    """
+    Callback class that will render a Jinja2 template, for use as a ready
+    action.
+
+    :param str source: The template source file, relative to
+        `$CHARM_DIR/templates`
+
+    :param str target: The target to write the rendered template to (or None)
+    :param str owner: The owner of the rendered file
+    :param str group: The group of the rendered file
+    :param int perms: The permissions of the rendered file
+    :param partial on_change_action: functools partial to be executed when
+                                     rendered file changes
+    :param jinja2 loader template_loader: A jinja2 template loader
+
+    :return str: The rendered template
+    """
+    def __init__(self, source, target,
+                 owner='root', group='root', perms=0o444,
+                 on_change_action=None, template_loader=None):
+        self.source = source
+        self.target = target
+        self.owner = owner
+        self.group = group
+        self.perms = perms
+        self.on_change_action = on_change_action
+        self.template_loader = template_loader
+
+    def __call__(self, manager, service_name, event_name):
+        pre_checksum = ''
+        if self.on_change_action and os.path.isfile(self.target):
+            pre_checksum = host.file_hash(self.target)
+        service = manager.get_service(service_name)
+        context = {'ctx': {}}
+        for ctx in service.get('required_data', []):
+            context.update(ctx)
+            context['ctx'].update(ctx)
+
+        result = templating.render(self.source, self.target, context,
+                                   self.owner, self.group, self.perms,
+                                   template_loader=self.template_loader)
+        if self.on_change_action:
+            if pre_checksum == host.file_hash(self.target):
+                hookenv.log(
+                    'No change detected: {}'.format(self.target),
+                    hookenv.DEBUG)
+            else:
+                self.on_change_action()
+
+        return result
+
+
+# Convenience aliases for templates
+render_template = template = TemplateCallback
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/strutils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/strutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8df0452f8203b53947eb137eed22d85ff62dff0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/strutils.py
@@ -0,0 +1,129 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import re
+
+
+def bool_from_string(value):
+    """Interpret string value as boolean.
+
+    Returns True if value translates to True otherwise False.
+    """
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as boolean" % (value)
+        raise ValueError(msg)
+
+    value = value.strip().lower()
+
+    if value in ['y', 'yes', 'true', 't', 'on']:
+        return True
+    elif value in ['n', 'no', 'false', 'f', 'off']:
+        return False
+
+    msg = "Unable to interpret string value '%s' as boolean" % (value)
+    raise ValueError(msg)
+
+
+def bytes_from_string(value):
+    """Interpret human readable string value as bytes.
+
+    Returns int
+    """
+    BYTE_POWER = {
+        'K': 1,
+        'KB': 1,
+        'M': 2,
+        'MB': 2,
+        'G': 3,
+        'GB': 3,
+        'T': 4,
+        'TB': 4,
+        'P': 5,
+        'PB': 5,
+    }
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as bytes" % (value)
+        raise ValueError(msg)
+    matches = re.match("([0-9]+)([a-zA-Z]+)", value)
+    if matches:
+        size = int(matches.group(1)) * (1024 ** BYTE_POWER[matches.group(2)])
+    else:
+        # Assume that value passed in is bytes
+        try:
+            size = int(value)
+        except ValueError:
+            msg = "Unable to interpret string value '%s' as bytes" % (value)
+            raise ValueError(msg)
+    return size
+
+
+class BasicStringComparator(object):
+    """Provides a class that will compare strings from an iterator type object.
+    Used to provide > and < comparisons on strings that may not necessarily be
+    alphanumerically ordered.  e.g. OpenStack or Ubuntu releases AFTER the
+    z-wrap.
+    """
+
+    _list = None
+
+    def __init__(self, item):
+        if self._list is None:
+            raise Exception("Must define the _list in the class definition!")
+        try:
+            self.index = self._list.index(item)
+        except Exception:
+            raise KeyError("Item '{}' is not in list '{}'"
+                           .format(item, self._list))
+
+    def __eq__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index == self._list.index(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index < self._list.index(other)
+
+    def __ge__(self, other):
+        return not self.__lt__(other)
+
+    def __gt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index > self._list.index(other)
+
+    def __le__(self, other):
+        return not self.__gt__(other)
+
+    def __str__(self):
+        """Always give back the item at the index so it can be used in
+        comparisons like:
+
+        s_mitaka = CompareOpenStack('mitaka')
+        s_newton = CompareOpenstack('newton')
+
+        assert s_newton > s_mitaka
+
+        @returns: <string>
+        """
+        return self._list[self.index]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..386428d619bc38edf02dc088bf7ec32767c0ab94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/sysctl.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+
+from subprocess import check_call, CalledProcessError
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+    WARNING,
+)
+
+from charmhelpers.core.host import is_container
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+def create(sysctl_dict, sysctl_file, ignore=False):
+    """Creates a sysctl.conf file from a YAML associative array
+
+    :param sysctl_dict: a dict or YAML-formatted string of sysctl
+                        options eg "{ 'kernel.max_pid': 1337 }"
+    :type sysctl_dict: str
+    :param sysctl_file: path to the sysctl file to be saved
+    :type sysctl_file: str or unicode
+    :param ignore: If True, ignore "unknown variable" errors.
+    :type ignore: bool
+    :returns: None
+    """
+    if type(sysctl_dict) is not dict:
+        try:
+            sysctl_dict_parsed = yaml.safe_load(sysctl_dict)
+        except yaml.YAMLError:
+            log("Error parsing YAML sysctl_dict: {}".format(sysctl_dict),
+                level=ERROR)
+            return
+    else:
+        sysctl_dict_parsed = sysctl_dict
+
+    with open(sysctl_file, "w") as fd:
+        for key, value in sysctl_dict_parsed.items():
+            fd.write("{}={}\n".format(key, value))
+
+    log("Updating sysctl_file: {} values: {}".format(sysctl_file,
+                                                     sysctl_dict_parsed),
+        level=DEBUG)
+
+    call = ["sysctl", "-p", sysctl_file]
+    if ignore:
+        call.append("-e")
+
+    try:
+        check_call(call)
+    except CalledProcessError as e:
+        if is_container():
+            log("Error setting some sysctl keys in this container: {}".format(e.output),
+                level=WARNING)
+        else:
+            raise e
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..9014015c14ee0b48c775562cd4f0d30884944439
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/templating.py
@@ -0,0 +1,93 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+def render(source, target, context, owner='root', group='root',
+           perms=0o444, templates_dir=None, encoding='UTF-8',
+           template_loader=None, config_template=None):
+    """
+    Render a template.
+
+    The `source` path, if not absolute, is relative to the `templates_dir`.
+
+    The `target` path should be absolute.  It can also be `None`, in which
+    case no file will be written.
+
+    The context should be a dict containing the values to be replaced in the
+    template.
+
+    config_template may be provided to render from a provided template instead
+    of loading from a file.
+
+    The `owner`, `group`, and `perms` options will be passed to `write_file`.
+
+    If omitted, `templates_dir` defaults to the `templates` folder in the charm.
+
+    The rendered template will be written to the file as well as being returned
+    as a string.
+
+    Note: Using this requires python-jinja2 or python3-jinja2; if it is not
+    installed, calling this will attempt to use charmhelpers.fetch.apt_install
+    to install it.
+    """
+    try:
+        from jinja2 import FileSystemLoader, Environment, exceptions
+    except ImportError:
+        try:
+            from charmhelpers.fetch import apt_install
+        except ImportError:
+            hookenv.log('Could not import jinja2, and could not import '
+                        'charmhelpers.fetch to install it',
+                        level=hookenv.ERROR)
+            raise
+        if sys.version_info.major == 2:
+            apt_install('python-jinja2', fatal=True)
+        else:
+            apt_install('python3-jinja2', fatal=True)
+        from jinja2 import FileSystemLoader, Environment, exceptions
+
+    if template_loader:
+        template_env = Environment(loader=template_loader)
+    else:
+        if templates_dir is None:
+            templates_dir = os.path.join(hookenv.charm_dir(), 'templates')
+        template_env = Environment(loader=FileSystemLoader(templates_dir))
+
+    # load from a string if provided explicitly
+    if config_template is not None:
+        template = template_env.from_string(config_template)
+    else:
+        try:
+            source = source
+            template = template_env.get_template(source)
+        except exceptions.TemplateNotFound as e:
+            hookenv.log('Could not load template %s from %s.' %
+                        (source, templates_dir),
+                        level=hookenv.ERROR)
+            raise e
+    content = template.render(context)
+    if target is not None:
+        target_dir = os.path.dirname(target)
+        if not os.path.exists(target_dir):
+            # This is a terrible default directory permission, as the file
+            # or its siblings will often contain secrets.
+            host.mkdir(os.path.dirname(target), owner, group, perms=0o755)
+        host.write_file(target, content.encode(encoding), owner, group, perms)
+    return content
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab554327b343f896880523fc627c1abea84be29a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/core/unitdata.py
@@ -0,0 +1,525 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Authors:
+#  Kapil Thangavelu <kapil.foss@gmail.com>
+#
+"""
+Intro
+-----
+
+A simple way to store state in units. This provides a key value
+storage with support for versioned, transactional operation,
+and can calculate deltas from previous values to simplify unit logic
+when processing changes.
+
+
+Hook Integration
+----------------
+
+There are several extant frameworks for hook execution, including
+
+ - charmhelpers.core.hookenv.Hooks
+ - charmhelpers.core.services.ServiceManager
+
+The storage classes are framework agnostic, one simple integration is
+via the HookData contextmanager. It will record the current hook
+execution environment (including relation data, config data, etc.),
+setup a transaction and allow easy access to the changes from
+previously seen values. One consequence of the integration is the
+reservation of particular keys ('rels', 'unit', 'env', 'config',
+'charm_revisions') for their respective values.
+
+Here's a fully worked integration example using hookenv.Hooks::
+
+       from charmhelper.core import hookenv, unitdata
+
+       hook_data = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # Print all changes to configuration from previously seen
+           # values.
+           for changed, (prev, cur) in hook_data.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+           # Directly access all charm config as a mapping.
+           conf = db.getrange('config', True)
+
+           # Directly access all relation data as a mapping
+           rels = db.getrange('rels', True)
+
+       if __name__ == '__main__':
+           with hook_data():
+               hook.execute()
+
+
+A more basic integration is via the hook_scope context manager which simply
+manages transaction scope (and records hook name, and timestamp)::
+
+  >>> from unitdata import kv
+  >>> db = kv()
+  >>> with db.hook_scope('install'):
+  ...    # do work, in transactional scope.
+  ...    db.set('x', 1)
+  >>> db.get('x')
+  1
+
+
+Usage
+-----
+
+Values are automatically json de/serialized to preserve basic typing
+and complex data struct capabilities (dicts, lists, ints, booleans, etc).
+
+Individual values can be manipulated via get/set::
+
+   >>> kv.set('y', True)
+   >>> kv.get('y')
+   True
+
+   # We can set complex values (dicts, lists) as a single key.
+   >>> kv.set('config', {'a': 1, 'b': True'})
+
+   # Also supports returning dictionaries as a record which
+   # provides attribute access.
+   >>> config = kv.get('config', record=True)
+   >>> config.b
+   True
+
+
+Groups of keys can be manipulated with update/getrange::
+
+   >>> kv.update({'z': 1, 'y': 2}, prefix="gui.")
+   >>> kv.getrange('gui.', strip=True)
+   {'z': 1, 'y': 2}
+
+When updating values, its very helpful to understand which values
+have actually changed and how have they changed. The storage
+provides a delta method to provide for this::
+
+   >>> data = {'debug': True, 'option': 2}
+   >>> delta = kv.delta(data, 'config.')
+   >>> delta.debug.previous
+   None
+   >>> delta.debug.current
+   True
+   >>> delta
+   {'debug': (None, True), 'option': (None, 2)}
+
+Note the delta method does not persist the actual change, it needs to
+be explicitly saved via 'update' method::
+
+   >>> kv.update(data, 'config.')
+
+Values modified in the context of a hook scope retain historical values
+associated to the hookname.
+
+   >>> with db.hook_scope('config-changed'):
+   ...      db.set('x', 42)
+   >>> db.gethistory('x')
+   [(1, u'x', 1, u'install', u'2015-01-21T16:49:30.038372'),
+    (2, u'x', 42, u'config-changed', u'2015-01-21T16:49:30.038786')]
+
+"""
+
+import collections
+import contextlib
+import datetime
+import itertools
+import json
+import os
+import pprint
+import sqlite3
+import sys
+
+__author__ = 'Kapil Thangavelu <kapil.foss@gmail.com>'
+
+
+class Storage(object):
+    """Simple key value database for local unit state within charms.
+
+    Modifications are not persisted unless :meth:`flush` is called.
+
+    To support dicts, lists, integer, floats, and booleans values
+    are automatically json encoded/decoded.
+
+    Note: to facilitate unit testing, ':memory:' can be passed as the
+    path parameter which causes sqlite3 to only build the db in memory.
+    This should only be used for testing purposes.
+    """
+    def __init__(self, path=None):
+        self.db_path = path
+        if path is None:
+            if 'UNIT_STATE_DB' in os.environ:
+                self.db_path = os.environ['UNIT_STATE_DB']
+            else:
+                self.db_path = os.path.join(
+                    os.environ.get('CHARM_DIR', ''), '.unit-state.db')
+        if self.db_path != ':memory:':
+            with open(self.db_path, 'a') as f:
+                os.fchmod(f.fileno(), 0o600)
+        self.conn = sqlite3.connect('%s' % self.db_path)
+        self.cursor = self.conn.cursor()
+        self.revision = None
+        self._closed = False
+        self._init()
+
+    def close(self):
+        if self._closed:
+            return
+        self.flush(False)
+        self.cursor.close()
+        self.conn.close()
+        self._closed = True
+
+    def get(self, key, default=None, record=False):
+        self.cursor.execute('select data from kv where key=?', [key])
+        result = self.cursor.fetchone()
+        if not result:
+            return default
+        if record:
+            return Record(json.loads(result[0]))
+        return json.loads(result[0])
+
+    def getrange(self, key_prefix, strip=False):
+        """
+        Get a range of keys starting with a common prefix as a mapping of
+        keys to values.
+
+        :param str key_prefix: Common prefix among all keys
+        :param bool strip: Optionally strip the common prefix from the key
+            names in the returned dict
+        :return dict: A (possibly empty) dict of key-value mappings
+        """
+        self.cursor.execute("select key, data from kv where key like ?",
+                            ['%s%%' % key_prefix])
+        result = self.cursor.fetchall()
+
+        if not result:
+            return {}
+        if not strip:
+            key_prefix = ''
+        return dict([
+            (k[len(key_prefix):], json.loads(v)) for k, v in result])
+
+    def update(self, mapping, prefix=""):
+        """
+        Set the values of multiple keys at once.
+
+        :param dict mapping: Mapping of keys to values
+        :param str prefix: Optional prefix to apply to all keys in `mapping`
+            before setting
+        """
+        for k, v in mapping.items():
+            self.set("%s%s" % (prefix, k), v)
+
+    def unset(self, key):
+        """
+        Remove a key from the database entirely.
+        """
+        self.cursor.execute('delete from kv where key=?', [key])
+        if self.revision and self.cursor.rowcount:
+            self.cursor.execute(
+                'insert into kv_revisions values (?, ?, ?)',
+                [key, self.revision, json.dumps('DELETED')])
+
+    def unsetrange(self, keys=None, prefix=""):
+        """
+        Remove a range of keys starting with a common prefix, from the database
+        entirely.
+
+        :param list keys: List of keys to remove.
+        :param str prefix: Optional prefix to apply to all keys in ``keys``
+            before removing.
+        """
+        if keys is not None:
+            keys = ['%s%s' % (prefix, key) for key in keys]
+            self.cursor.execute('delete from kv where key in (%s)' % ','.join(['?'] * len(keys)), keys)
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values %s' % ','.join(['(?, ?, ?)'] * len(keys)),
+                    list(itertools.chain.from_iterable((key, self.revision, json.dumps('DELETED')) for key in keys)))
+        else:
+            self.cursor.execute('delete from kv where key like ?',
+                                ['%s%%' % prefix])
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values (?, ?, ?)',
+                    ['%s%%' % prefix, self.revision, json.dumps('DELETED')])
+
+    def set(self, key, value):
+        """
+        Set a value in the database.
+
+        :param str key: Key to set the value for
+        :param value: Any JSON-serializable value to be set
+        """
+        serialized = json.dumps(value)
+
+        self.cursor.execute('select data from kv where key=?', [key])
+        exists = self.cursor.fetchone()
+
+        # Skip mutations to the same value
+        if exists:
+            if exists[0] == serialized:
+                return value
+
+        if not exists:
+            self.cursor.execute(
+                'insert into kv (key, data) values (?, ?)',
+                (key, serialized))
+        else:
+            self.cursor.execute('''
+            update kv
+            set data = ?
+            where key = ?''', [serialized, key])
+
+        # Save
+        if not self.revision:
+            return value
+
+        self.cursor.execute(
+            'select 1 from kv_revisions where key=? and revision=?',
+            [key, self.revision])
+        exists = self.cursor.fetchone()
+
+        if not exists:
+            self.cursor.execute(
+                '''insert into kv_revisions (
+                revision, key, data) values (?, ?, ?)''',
+                (self.revision, key, serialized))
+        else:
+            self.cursor.execute(
+                '''
+                update kv_revisions
+                set data = ?
+                where key = ?
+                and   revision = ?''',
+                [serialized, key, self.revision])
+
+        return value
+
+    def delta(self, mapping, prefix):
+        """
+        return a delta containing values that have changed.
+        """
+        previous = self.getrange(prefix, strip=True)
+        if not previous:
+            pk = set()
+        else:
+            pk = set(previous.keys())
+        ck = set(mapping.keys())
+        delta = DeltaSet()
+
+        # added
+        for k in ck.difference(pk):
+            delta[k] = Delta(None, mapping[k])
+
+        # removed
+        for k in pk.difference(ck):
+            delta[k] = Delta(previous[k], None)
+
+        # changed
+        for k in pk.intersection(ck):
+            c = mapping[k]
+            p = previous[k]
+            if c != p:
+                delta[k] = Delta(p, c)
+
+        return delta
+
+    @contextlib.contextmanager
+    def hook_scope(self, name=""):
+        """Scope all future interactions to the current hook execution
+        revision."""
+        assert not self.revision
+        self.cursor.execute(
+            'insert into hooks (hook, date) values (?, ?)',
+            (name or sys.argv[0],
+             datetime.datetime.utcnow().isoformat()))
+        self.revision = self.cursor.lastrowid
+        try:
+            yield self.revision
+            self.revision = None
+        except Exception:
+            self.flush(False)
+            self.revision = None
+            raise
+        else:
+            self.flush()
+
+    def flush(self, save=True):
+        if save:
+            self.conn.commit()
+        elif self._closed:
+            return
+        else:
+            self.conn.rollback()
+
+    def _init(self):
+        self.cursor.execute('''
+            create table if not exists kv (
+               key text,
+               data text,
+               primary key (key)
+               )''')
+        self.cursor.execute('''
+            create table if not exists kv_revisions (
+               key text,
+               revision integer,
+               data text,
+               primary key (key, revision)
+               )''')
+        self.cursor.execute('''
+            create table if not exists hooks (
+               version integer primary key autoincrement,
+               hook text,
+               date text
+               )''')
+        self.conn.commit()
+
+    def gethistory(self, key, deserialize=False):
+        self.cursor.execute(
+            '''
+            select kv.revision, kv.key, kv.data, h.hook, h.date
+            from kv_revisions kv,
+                 hooks h
+            where kv.key=?
+             and kv.revision = h.version
+            ''', [key])
+        if deserialize is False:
+            return self.cursor.fetchall()
+        return map(_parse_history, self.cursor.fetchall())
+
+    def debug(self, fh=sys.stderr):
+        self.cursor.execute('select * from kv')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+        self.cursor.execute('select * from kv_revisions')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+
+
+def _parse_history(d):
+    return (d[0], d[1], json.loads(d[2]), d[3],
+            datetime.datetime.strptime(d[-1], "%Y-%m-%dT%H:%M:%S.%f"))
+
+
+class HookData(object):
+    """Simple integration for existing hook exec frameworks.
+
+    Records all unit information, and stores deltas for processing
+    by the hook.
+
+    Sample::
+
+       from charmhelper.core import hookenv, unitdata
+
+       changes = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # View all changes to configuration
+           for changed, (prev, cur) in changes.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+       if __name__ == '__main__':
+           with changes():
+               hook.execute()
+
+    """
+    def __init__(self):
+        self.kv = kv()
+        self.conf = None
+        self.rels = None
+
+    @contextlib.contextmanager
+    def __call__(self):
+        from charmhelpers.core import hookenv
+        hook_name = hookenv.hook_name()
+
+        with self.kv.hook_scope(hook_name):
+            self._record_charm_version(hookenv.charm_dir())
+            delta_config, delta_relation = self._record_hook(hookenv)
+            yield self.kv, delta_config, delta_relation
+
+    def _record_charm_version(self, charm_dir):
+        # Record revisions.. charm revisions are meaningless
+        # to charm authors as they don't control the revision.
+        # so logic dependnent on revision is not particularly
+        # useful, however it is useful for debugging analysis.
+        charm_rev = open(
+            os.path.join(charm_dir, 'revision')).read().strip()
+        charm_rev = charm_rev or '0'
+        revs = self.kv.get('charm_revisions', [])
+        if charm_rev not in revs:
+            revs.append(charm_rev.strip() or '0')
+            self.kv.set('charm_revisions', revs)
+
+    def _record_hook(self, hookenv):
+        data = hookenv.execution_environment()
+        self.conf = conf_delta = self.kv.delta(data['conf'], 'config')
+        self.rels = rels_delta = self.kv.delta(data['rels'], 'rels')
+        self.kv.set('env', dict(data['env']))
+        self.kv.set('unit', data['unit'])
+        self.kv.set('relid', data.get('relid'))
+        return conf_delta, rels_delta
+
+
+class Record(dict):
+
+    __slots__ = ()
+
+    def __getattr__(self, k):
+        if k in self:
+            return self[k]
+        raise AttributeError(k)
+
+
+class DeltaSet(Record):
+
+    __slots__ = ()
+
+
+Delta = collections.namedtuple('Delta', ['previous', 'current'])
+
+
+_KV = None
+
+
+def kv():
+    global _KV
+    if _KV is None:
+        _KV = Storage()
+    return _KV
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cc7fc850a0632568ad78aae9716be718c9ff6b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/__init__.py
@@ -0,0 +1,209 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib
+from charmhelpers.osplatform import get_platform
+from yaml import safe_load
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+)
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse, urlunparse
+else:
+    from urlparse import urlparse, urlunparse
+
+
+# The order of this list is very important. Handlers should be listed in from
+# least- to most-specific URL matching.
+FETCH_HANDLERS = (
+    'charmhelpers.fetch.archiveurl.ArchiveUrlFetchHandler',
+    'charmhelpers.fetch.bzrurl.BzrUrlFetchHandler',
+    'charmhelpers.fetch.giturl.GitUrlFetchHandler',
+)
+
+
+class SourceConfigError(Exception):
+    pass
+
+
+class UnhandledSource(Exception):
+    pass
+
+
+class AptLockError(Exception):
+    pass
+
+
+class GPGKeyError(Exception):
+    """Exception occurs when a GPG key cannot be fetched or used.  The message
+    indicates what the problem is.
+    """
+    pass
+
+
+class BaseFetchHandler(object):
+
+    """Base class for FetchHandler implementations in fetch plugins"""
+
+    def can_handle(self, source):
+        """Returns True if the source can be handled. Otherwise returns
+        a string explaining why it cannot"""
+        return "Wrong source type"
+
+    def install(self, source):
+        """Try to download and unpack the source. Return the path to the
+        unpacked files or raise UnhandledSource."""
+        raise UnhandledSource("Wrong source type {}".format(source))
+
+    def parse_url(self, url):
+        return urlparse(url)
+
+    def base_url(self, url):
+        """Return url without querystring or fragment"""
+        parts = list(self.parse_url(url))
+        parts[4:] = ['' for i in parts[4:]]
+        return urlunparse(parts)
+
+
+__platform__ = get_platform()
+module = "charmhelpers.fetch.%s" % __platform__
+fetch = importlib.import_module(module)
+
+filter_installed_packages = fetch.filter_installed_packages
+filter_missing_packages = fetch.filter_missing_packages
+install = fetch.apt_install
+upgrade = fetch.apt_upgrade
+update = _fetch_update = fetch.apt_update
+purge = fetch.apt_purge
+add_source = fetch.add_source
+
+if __platform__ == "ubuntu":
+    apt_cache = fetch.apt_cache
+    apt_install = fetch.apt_install
+    apt_update = fetch.apt_update
+    apt_upgrade = fetch.apt_upgrade
+    apt_purge = fetch.apt_purge
+    apt_autoremove = fetch.apt_autoremove
+    apt_mark = fetch.apt_mark
+    apt_hold = fetch.apt_hold
+    apt_unhold = fetch.apt_unhold
+    import_key = fetch.import_key
+    get_upstream_version = fetch.get_upstream_version
+    apt_pkg = fetch.ubuntu_apt_pkg
+    get_apt_dpkg_env = fetch.get_apt_dpkg_env
+elif __platform__ == "centos":
+    yum_search = fetch.yum_search
+
+
+def configure_sources(update=False,
+                      sources_var='install_sources',
+                      keys_var='install_keys'):
+    """Configure multiple sources from charm configuration.
+
+    The lists are encoded as yaml fragments in the configuration.
+    The fragment needs to be included as a string. Sources and their
+    corresponding keys are of the types supported by add_source().
+
+    Example config:
+        install_sources: |
+          - "ppa:foo"
+          - "http://example.com/repo precise main"
+        install_keys: |
+          - null
+          - "a1b2c3d4"
+
+    Note that 'null' (a.k.a. None) should not be quoted.
+    """
+    sources = safe_load((config(sources_var) or '').strip()) or []
+    keys = safe_load((config(keys_var) or '').strip()) or None
+
+    if isinstance(sources, six.string_types):
+        sources = [sources]
+
+    if keys is None:
+        for source in sources:
+            add_source(source, None)
+    else:
+        if isinstance(keys, six.string_types):
+            keys = [keys]
+
+        if len(sources) != len(keys):
+            raise SourceConfigError(
+                'Install sources and keys lists are different lengths')
+        for source, key in zip(sources, keys):
+            add_source(source, key)
+    if update:
+        _fetch_update(fatal=True)
+
+
+def install_remote(source, *args, **kwargs):
+    """Install a file tree from a remote source.
+
+    The specified source should be a url of the form:
+        scheme://[host]/path[#[option=value][&...]]
+
+    Schemes supported are based on this modules submodules.
+    Options supported are submodule-specific.
+    Additional arguments are passed through to the submodule.
+
+    For example::
+
+        dest = install_remote('http://example.com/archive.tgz',
+                              checksum='deadbeef',
+                              hash_type='sha1')
+
+    This will download `archive.tgz`, validate it using SHA1 and, if
+    the file is ok, extract it and return the directory in which it
+    was extracted.  If the checksum fails, it will raise
+    :class:`charmhelpers.core.host.ChecksumError`.
+    """
+    # We ONLY check for True here because can_handle may return a string
+    # explaining why it can't handle a given source.
+    handlers = [h for h in plugins() if h.can_handle(source) is True]
+    for handler in handlers:
+        try:
+            return handler.install(source, *args, **kwargs)
+        except UnhandledSource as e:
+            log('Install source attempt unsuccessful: {}'.format(e),
+                level='WARNING')
+    raise UnhandledSource("No handler found for source {}".format(source))
+
+
+def install_from_config(config_var_name):
+    """Install a file from config."""
+    charm_config = config()
+    source = charm_config[config_var_name]
+    return install_remote(source)
+
+
+def plugins(fetch_handlers=None):
+    if not fetch_handlers:
+        fetch_handlers = FETCH_HANDLERS
+    plugin_list = []
+    for handler_name in fetch_handlers:
+        package, classname = handler_name.rsplit('.', 1)
+        try:
+            handler_class = getattr(
+                importlib.import_module(package),
+                classname)
+            plugin_list.append(handler_class())
+        except NotImplementedError:
+            # Skip missing plugins so that they can be ommitted from
+            # installation if desired
+            log("FetchHandler {} not found, skipping plugin".format(
+                handler_name))
+    return plugin_list
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/archiveurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/archiveurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..d25587adeff102c3fc9e402f98746fccbd8a3693
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/archiveurl.py
@@ -0,0 +1,165 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import hashlib
+import re
+
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource
+)
+from charmhelpers.payload.archive import (
+    get_archive_handler,
+    extract,
+)
+from charmhelpers.core.host import mkdir, check_hash
+
+import six
+if six.PY3:
+    from urllib.request import (
+        build_opener, install_opener, urlopen, urlretrieve,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+    )
+    from urllib.parse import urlparse, urlunparse, parse_qs
+    from urllib.error import URLError
+else:
+    from urllib import urlretrieve
+    from urllib2 import (
+        build_opener, install_opener, urlopen,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+        URLError
+    )
+    from urlparse import urlparse, urlunparse, parse_qs
+
+
+def splituser(host):
+    '''urllib.splituser(), but six's support of this seems broken'''
+    _userprog = re.compile('^(.*)@(.*)$')
+    match = _userprog.match(host)
+    if match:
+        return match.group(1, 2)
+    return None, host
+
+
+def splitpasswd(user):
+    '''urllib.splitpasswd(), but six's support of this is missing'''
+    _passwdprog = re.compile('^([^:]*):(.*)$', re.S)
+    match = _passwdprog.match(user)
+    if match:
+        return match.group(1, 2)
+    return user, None
+
+
+class ArchiveUrlFetchHandler(BaseFetchHandler):
+    """
+    Handler to download archive files from arbitrary URLs.
+
+    Can fetch from http, https, ftp, and file URLs.
+
+    Can install either tarballs (.tar, .tgz, .tbz2, etc) or zip files.
+
+    Installs the contents of the archive in $CHARM_DIR/fetched/.
+    """
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('http', 'https', 'ftp', 'file'):
+            # XXX: Why is this returning a boolean and a string? It's
+            # doomed to fail since "bool(can_handle('foo://'))"  will be True.
+            return "Wrong source type"
+        if get_archive_handler(self.base_url(source)):
+            return True
+        return False
+
+    def download(self, source, dest):
+        """
+        Download an archive file.
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local path location to download archive file to.
+        """
+        # propagate all exceptions
+        # URLError, OSError, etc
+        proto, netloc, path, params, query, fragment = urlparse(source)
+        if proto in ('http', 'https'):
+            auth, barehost = splituser(netloc)
+            if auth is not None:
+                source = urlunparse((proto, barehost, path, params, query, fragment))
+                username, password = splitpasswd(auth)
+                passman = HTTPPasswordMgrWithDefaultRealm()
+                # Realm is set to None in add_password to force the username and password
+                # to be used whatever the realm
+                passman.add_password(None, source, username, password)
+                authhandler = HTTPBasicAuthHandler(passman)
+                opener = build_opener(authhandler)
+                install_opener(opener)
+        response = urlopen(source)
+        try:
+            with open(dest, 'wb') as dest_file:
+                dest_file.write(response.read())
+        except Exception as e:
+            if os.path.isfile(dest):
+                os.unlink(dest)
+            raise e
+
+    # Mandatory file validation via Sha1 or MD5 hashing.
+    def download_and_validate(self, url, hashsum, validate="sha1"):
+        tempfile, headers = urlretrieve(url)
+        check_hash(tempfile, hashsum, validate)
+        return tempfile
+
+    def install(self, source, dest=None, checksum=None, hash_type='sha1'):
+        """
+        Download and install an archive file, with optional checksum validation.
+
+        The checksum can also be given on the `source` URL's fragment.
+        For example::
+
+            handler.install('http://example.com/file.tgz#sha1=deadbeef')
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local destination path to install to. If not given,
+            installs to `$CHARM_DIR/archives/archive_file_name`.
+        :param str checksum: If given, validate the archive file after download.
+        :param str hash_type: Algorithm used to generate `checksum`.
+            Can be any hash alrgorithm supported by :mod:`hashlib`,
+            such as md5, sha1, sha256, sha512, etc.
+
+        """
+        url_parts = self.parse_url(source)
+        dest_dir = os.path.join(os.environ.get('CHARM_DIR'), 'fetched')
+        if not os.path.exists(dest_dir):
+            mkdir(dest_dir, perms=0o755)
+        dld_file = os.path.join(dest_dir, os.path.basename(url_parts.path))
+        try:
+            self.download(source, dld_file)
+        except URLError as e:
+            raise UnhandledSource(e.reason)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        options = parse_qs(url_parts.fragment)
+        for key, value in options.items():
+            if not six.PY3:
+                algorithms = hashlib.algorithms
+            else:
+                algorithms = hashlib.algorithms_available
+            if key in algorithms:
+                if len(value) != 1:
+                    raise TypeError(
+                        "Expected 1 hash value, not %d" % len(value))
+                expected = value[0]
+                check_hash(dld_file, expected, key)
+        if checksum:
+            check_hash(dld_file, checksum, hash_type)
+        return extract(dld_file, dest)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/bzrurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/bzrurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4ab3ff1e6bc7dde24e8ed568a3dc0c6012ddea6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/bzrurl.py
@@ -0,0 +1,76 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import STDOUT, check_output
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+from charmhelpers.core.host import mkdir
+
+
+if filter_installed_packages(['bzr']) != []:
+    install(['bzr'])
+    if filter_installed_packages(['bzr']) != []:
+        raise NotImplementedError('Unable to install bzr')
+
+
+class BzrUrlFetchHandler(BaseFetchHandler):
+    """Handler for bazaar branches via generic and lp URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('bzr+ssh', 'lp', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.bzr'))
+        else:
+            return True
+
+    def branch(self, source, dest, revno=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+        cmd_opts = []
+        if revno:
+            cmd_opts += ['-r', str(revno)]
+        if os.path.exists(dest):
+            cmd = ['bzr', 'pull']
+            cmd += cmd_opts
+            cmd += ['--overwrite', '-d', dest, source]
+        else:
+            cmd = ['bzr', 'branch']
+            cmd += cmd_opts
+            cmd += [source, dest]
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, dest=None, revno=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+
+        if dest and not os.path.exists(dest):
+            mkdir(dest, perms=0o755)
+
+        try:
+            self.branch(source, dest_dir, revno)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..a91dcff0645ed541a79cd72af3112bdff393719a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/centos.py
@@ -0,0 +1,171 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import os
+import time
+import six
+import yum
+
+from tempfile import NamedTemporaryFile
+from charmhelpers.core.hookenv import log
+
+YUM_NO_LOCK = 1  # The return code for "couldn't acquire lock" in YUM.
+YUM_NO_LOCK_RETRY_DELAY = 10  # Wait 10 seconds between apt lock checks.
+YUM_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    yb = yum.YumBase()
+    package_list = yb.doPackageLists()
+    temp_cache = {p.base_package_name: 1 for p in package_list['installed']}
+
+    _pkgs = [p for p in packages if not temp_cache.get(p, False)]
+    return _pkgs
+
+
+def install(packages, options=None, fatal=False):
+    """Install one or more packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_yum_command(cmd, fatal)
+
+
+def upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_yum_command(cmd, fatal)
+
+
+def update(fatal=False):
+    """Update local yum cache."""
+    cmd = ['yum', '--assumeyes', 'update']
+    log("Update with fatal: {}".format(fatal))
+    _run_yum_command(cmd, fatal)
+
+
+def purge(packages, fatal=False):
+    """Purge one or more packages."""
+    cmd = ['yum', '--assumeyes', 'remove']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_yum_command(cmd, fatal)
+
+
+def yum_search(packages):
+    """Search for a package."""
+    output = {}
+    cmd = ['yum', 'search']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Searching for {}".format(packages))
+    result = subprocess.check_output(cmd)
+    for package in list(packages):
+        output[package] = package in result
+    return output
+
+
+def add_source(source, key=None):
+    """Add a package source to this system.
+
+    @param source: a URL with a rpm package
+
+    @param key: A key to be added to the system's keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk.
+    """
+    if source is None:
+        log('Source is not present. Skipping')
+        return
+
+    if source.startswith('http'):
+        directory = '/etc/yum.repos.d/'
+        for filename in os.listdir(directory):
+            with open(directory + filename, 'r') as rpm_file:
+                if source in rpm_file.read():
+                    break
+        else:
+            log("Add source: {!r}".format(source))
+            # write in the charms.repo
+            with open(directory + 'Charms.repo', 'a') as rpm_file:
+                rpm_file.write('[%s]\n' % source[7:].replace('/', '_'))
+                rpm_file.write('name=%s\n' % source[7:])
+                rpm_file.write('baseurl=%s\n\n' % source)
+    else:
+        log("Unknown source: {!r}".format(source))
+
+    if key:
+        if '-----BEGIN PGP PUBLIC KEY BLOCK-----' in key:
+            with NamedTemporaryFile('w+') as key_file:
+                key_file.write(key)
+                key_file.flush()
+                key_file.seek(0)
+                subprocess.check_call(['rpm', '--import', key_file.name])
+        else:
+            subprocess.check_call(['rpm', '--import', key])
+
+
+def _run_yum_command(cmd, fatal=False):
+    """Run an YUM command.
+
+    Checks the output and retry if the fatal flag is set to True.
+
+    :param: cmd: str: The yum command to run.
+    :param: fatal: bool: Whether the command's output should be checked and
+        retried.
+    """
+    env = os.environ.copy()
+
+    if fatal:
+        retry_count = 0
+        result = None
+
+        # If the command is considered "fatal", we need to retry if the yum
+        # lock was not acquired.
+
+        while result is None or result == YUM_NO_LOCK:
+            try:
+                result = subprocess.check_call(cmd, env=env)
+            except subprocess.CalledProcessError as e:
+                retry_count = retry_count + 1
+                if retry_count > YUM_NO_LOCK_RETRY_COUNT:
+                    raise
+                result = e.returncode
+                log("Couldn't acquire YUM lock. Will retry in {} seconds."
+                    "".format(YUM_NO_LOCK_RETRY_DELAY))
+                time.sleep(YUM_NO_LOCK_RETRY_DELAY)
+
+    else:
+        subprocess.call(cmd, env=env)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/giturl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/giturl.py
new file mode 100644
index 0000000000000000000000000000000000000000..070ca9bb5c1a2fdef39f88606ffcaf39bb049410
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/giturl.py
@@ -0,0 +1,69 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import check_output, CalledProcessError, STDOUT
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+
+if filter_installed_packages(['git']) != []:
+    install(['git'])
+    if filter_installed_packages(['git']) != []:
+        raise NotImplementedError('Unable to install git')
+
+
+class GitUrlFetchHandler(BaseFetchHandler):
+    """Handler for git branches via generic and github URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        # TODO (mattyw) no support for ssh git@ yet
+        if url_parts.scheme not in ('http', 'https', 'git', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.git'))
+        else:
+            return True
+
+    def clone(self, source, dest, branch="master", depth=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+
+        if os.path.exists(dest):
+            cmd = ['git', '-C', dest, 'pull', source, branch]
+        else:
+            cmd = ['git', 'clone', source, dest, '--branch', branch]
+            if depth:
+                cmd.extend(['--depth', depth])
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, branch="master", dest=None, depth=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+        try:
+            self.clone(source, dest_dir, branch, depth)
+        except CalledProcessError as e:
+            raise UnhandledSource(e)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bff99dc93c64f80716e2d5a2b6d0d4e8a2436955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..757135ee4cf3b5ff4c02305126f5ca3940892afc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/debug.py
@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import print_function
+
+import atexit
+import sys
+
+from charmhelpers.fetch.python.rpdb import Rpdb
+from charmhelpers.core.hookenv import (
+    open_port,
+    close_port,
+    ERROR,
+    log
+)
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+DEFAULT_ADDR = "0.0.0.0"
+DEFAULT_PORT = 4444
+
+
+def _error(message):
+    log(message, level=ERROR)
+
+
+def set_trace(addr=DEFAULT_ADDR, port=DEFAULT_PORT):
+    """
+    Set a trace point using the remote debugger
+    """
+    atexit.register(close_port, port)
+    try:
+        log("Starting a remote python debugger session on %s:%s" % (addr,
+                                                                    port))
+        open_port(port)
+        debugger = Rpdb(addr=addr, port=port)
+        debugger.set_trace(sys._getframe().f_back)
+    except Exception:
+        _error("Cannot start a remote debug session on %s:%s" % (addr,
+                                                                 port))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/packages.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/packages.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e95028bc540aace84a2ec6c1bcc4de2663e8a87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/packages.py
@@ -0,0 +1,154 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+import subprocess
+import sys
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import charm_dir, log
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def pip_execute(*args, **kwargs):
+    """Overriden pip_execute() to stop sys.path being changed.
+
+    The act of importing main from the pip module seems to cause add wheels
+    from the /usr/share/python-wheels which are installed by various tools.
+    This function ensures that sys.path remains the same after the call is
+    executed.
+    """
+    try:
+        _path = sys.path
+        try:
+            from pip import main as _pip_execute
+        except ImportError:
+            apt_update()
+            if six.PY2:
+                apt_install('python-pip')
+            else:
+                apt_install('python3-pip')
+            from pip import main as _pip_execute
+        _pip_execute(*args, **kwargs)
+    finally:
+        sys.path = _path
+
+
+def parse_options(given, available):
+    """Given a set of options, check if available"""
+    for key, value in sorted(given.items()):
+        if not value:
+            continue
+        if key in available:
+            yield "--{0}={1}".format(key, value)
+
+
+def pip_install_requirements(requirements, constraints=None, **options):
+    """Install a requirements file.
+
+    :param constraints: Path to pip constraints file.
+    http://pip.readthedocs.org/en/stable/user_guide/#constraints-files
+    """
+    command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    command.append("-r {0}".format(requirements))
+    if constraints:
+        command.append("-c {0}".format(constraints))
+        log("Installing from file: {} with constraints {} "
+            "and options: {}".format(requirements, constraints, command))
+    else:
+        log("Installing from file: {} with options: {}".format(requirements,
+                                                               command))
+    pip_execute(command)
+
+
+def pip_install(package, fatal=False, upgrade=False, venv=None,
+                constraints=None, **options):
+    """Install a python package"""
+    if venv:
+        venv_python = os.path.join(venv, 'bin/pip')
+        command = [venv_python, "install"]
+    else:
+        command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', 'index-url', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if upgrade:
+        command.append('--upgrade')
+
+    if constraints:
+        command.extend(['-c', constraints])
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Installing {} package with options: {}".format(package,
+                                                        command))
+    if venv:
+        subprocess.check_call(command)
+    else:
+        pip_execute(command)
+
+
+def pip_uninstall(package, **options):
+    """Uninstall a python package"""
+    command = ["uninstall", "-q", "-y"]
+
+    available_options = ('proxy', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Uninstalling {} package with options: {}".format(package,
+                                                          command))
+    pip_execute(command)
+
+
+def pip_list():
+    """Returns the list of current python installed packages
+    """
+    return pip_execute(["list"])
+
+
+def pip_create_virtualenv(path=None):
+    """Create an isolated Python environment."""
+    if six.PY2:
+        apt_install('python-virtualenv')
+    else:
+        apt_install('python3-virtualenv')
+
+    if path:
+        venv_path = path
+    else:
+        venv_path = os.path.join(charm_dir(), 'venv')
+
+    if not os.path.exists(venv_path):
+        subprocess.check_call(['virtualenv', venv_path])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/rpdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/rpdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b31610c22fc2d24fe5097016cf45728f87de4ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/rpdb.py
@@ -0,0 +1,56 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Remote Python Debugger (pdb wrapper)."""
+
+import pdb
+import socket
+import sys
+
+__author__ = "Bertrand Janin <b@janin.com>"
+__version__ = "0.1.3"
+
+
+class Rpdb(pdb.Pdb):
+
+    def __init__(self, addr="127.0.0.1", port=4444):
+        """Initialize the socket and initialize pdb."""
+
+        # Backup stdin and stdout before replacing them by the socket handle
+        self.old_stdout = sys.stdout
+        self.old_stdin = sys.stdin
+
+        # Open a 'reusable' socket to let the webapp reload on the same port
+        self.skt = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self.skt.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, True)
+        self.skt.bind((addr, port))
+        self.skt.listen(1)
+        (clientsocket, address) = self.skt.accept()
+        handle = clientsocket.makefile('rw')
+        pdb.Pdb.__init__(self, completekey='tab', stdin=handle, stdout=handle)
+        sys.stdout = sys.stdin = handle
+
+    def shutdown(self):
+        """Revert stdin and stdout, close the socket."""
+        sys.stdout = self.old_stdout
+        sys.stdin = self.old_stdin
+        self.skt.close()
+        self.set_continue()
+
+    def do_continue(self, arg):
+        """Stop all operation on ``continue``."""
+        self.shutdown()
+        return 1
+
+    do_EOF = do_quit = do_exit = do_c = do_cont = do_continue
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eb421036ff737f8ff1684e85ff87703e30fe543
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/python/version.py
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def current_version():
+    """Current system python version"""
+    return sys.version_info
+
+
+def current_version_string():
+    """Current system python version as string major.minor.micro"""
+    return "{0}.{1}.{2}".format(sys.version_info.major,
+                                sys.version_info.minor,
+                                sys.version_info.micro)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/snap.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/snap.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc70aa941bc4f0bb5ff126237db65705b9e4a10a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/snap.py
@@ -0,0 +1,150 @@
+# Copyright 2014-2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Charm helpers snap for classic charms.
+
+If writing reactive charms, use the snap layer:
+https://lists.ubuntu.com/archives/snapcraft/2016-September/001114.html
+"""
+import subprocess
+import os
+from time import sleep
+from charmhelpers.core.hookenv import log
+
+__author__ = 'Joseph Borg <joseph.borg@canonical.com>'
+
+# The return code for "couldn't acquire lock" in Snap
+# (hopefully this will be improved).
+SNAP_NO_LOCK = 1
+SNAP_NO_LOCK_RETRY_DELAY = 10  # Wait X seconds between Snap lock checks.
+SNAP_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+SNAP_CHANNELS = [
+    'edge',
+    'beta',
+    'candidate',
+    'stable',
+]
+
+
+class CouldNotAcquireLockException(Exception):
+    pass
+
+
+class InvalidSnapChannel(Exception):
+    pass
+
+
+def _snap_exec(commands):
+    """
+    Execute snap commands.
+
+    :param commands: List commands
+    :return: Integer exit code
+    """
+    assert type(commands) == list
+
+    retry_count = 0
+    return_code = None
+
+    while return_code is None or return_code == SNAP_NO_LOCK:
+        try:
+            return_code = subprocess.check_call(['snap'] + commands,
+                                                env=os.environ)
+        except subprocess.CalledProcessError as e:
+            retry_count += + 1
+            if retry_count > SNAP_NO_LOCK_RETRY_COUNT:
+                raise CouldNotAcquireLockException(
+                    'Could not aquire lock after {} attempts'
+                    .format(SNAP_NO_LOCK_RETRY_COUNT))
+            return_code = e.returncode
+            log('Snap failed to acquire lock, trying again in {} seconds.'
+                .format(SNAP_NO_LOCK_RETRY_DELAY), level='WARN')
+            sleep(SNAP_NO_LOCK_RETRY_DELAY)
+
+    return return_code
+
+
+def snap_install(packages, *flags):
+    """
+    Install a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to install command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Installing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with option(s) "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['install'] + flags + packages)
+
+
+def snap_remove(packages, *flags):
+    """
+    Remove a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to remove command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Removing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['remove'] + flags + packages)
+
+
+def snap_refresh(packages, *flags):
+    """
+    Refresh / Update snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to refresh command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Refreshing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['refresh'] + flags + packages)
+
+
+def valid_snap_channel(channel):
+    """ Validate snap channel exists
+
+    :raises InvalidSnapChannel: When channel does not exist
+    :return: Boolean
+    """
+    if channel.lower() in SNAP_CHANNELS:
+        return True
+    else:
+        raise InvalidSnapChannel("Invalid Snap Channel: {}".format(channel))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ddaf0dd47f23cef60d7b7e59a83c989999d9f3f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu.py
@@ -0,0 +1,805 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+import platform
+import re
+import six
+import subprocess
+import sys
+import time
+
+from charmhelpers.core.host import get_distrib_codename, get_system_env
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+    env_proxy_settings,
+)
+from charmhelpers.fetch import SourceConfigError, GPGKeyError
+from charmhelpers.fetch import ubuntu_apt_pkg
+
+PROPOSED_POCKET = (
+    "# Proposed\n"
+    "deb http://archive.ubuntu.com/ubuntu {}-proposed main universe "
+    "multiverse restricted\n")
+PROPOSED_PORTS_POCKET = (
+    "# Proposed\n"
+    "deb http://ports.ubuntu.com/ubuntu-ports {}-proposed main universe "
+    "multiverse restricted\n")
+# Only supports 64bit and ppc64 at the moment.
+ARCH_TO_PROPOSED_POCKET = {
+    'x86_64': PROPOSED_POCKET,
+    'ppc64le': PROPOSED_PORTS_POCKET,
+    'aarch64': PROPOSED_PORTS_POCKET,
+    's390x': PROPOSED_PORTS_POCKET,
+}
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+CLOUD_ARCHIVE = """# Ubuntu Cloud Archive
+deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+"""
+CLOUD_ARCHIVE_POCKETS = {
+    # Folsom
+    'folsom': 'precise-updates/folsom',
+    'folsom/updates': 'precise-updates/folsom',
+    'precise-folsom': 'precise-updates/folsom',
+    'precise-folsom/updates': 'precise-updates/folsom',
+    'precise-updates/folsom': 'precise-updates/folsom',
+    'folsom/proposed': 'precise-proposed/folsom',
+    'precise-folsom/proposed': 'precise-proposed/folsom',
+    'precise-proposed/folsom': 'precise-proposed/folsom',
+    # Grizzly
+    'grizzly': 'precise-updates/grizzly',
+    'grizzly/updates': 'precise-updates/grizzly',
+    'precise-grizzly': 'precise-updates/grizzly',
+    'precise-grizzly/updates': 'precise-updates/grizzly',
+    'precise-updates/grizzly': 'precise-updates/grizzly',
+    'grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-proposed/grizzly': 'precise-proposed/grizzly',
+    # Havana
+    'havana': 'precise-updates/havana',
+    'havana/updates': 'precise-updates/havana',
+    'precise-havana': 'precise-updates/havana',
+    'precise-havana/updates': 'precise-updates/havana',
+    'precise-updates/havana': 'precise-updates/havana',
+    'havana/proposed': 'precise-proposed/havana',
+    'precise-havana/proposed': 'precise-proposed/havana',
+    'precise-proposed/havana': 'precise-proposed/havana',
+    # Icehouse
+    'icehouse': 'precise-updates/icehouse',
+    'icehouse/updates': 'precise-updates/icehouse',
+    'precise-icehouse': 'precise-updates/icehouse',
+    'precise-icehouse/updates': 'precise-updates/icehouse',
+    'precise-updates/icehouse': 'precise-updates/icehouse',
+    'icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-proposed/icehouse': 'precise-proposed/icehouse',
+    # Juno
+    'juno': 'trusty-updates/juno',
+    'juno/updates': 'trusty-updates/juno',
+    'trusty-juno': 'trusty-updates/juno',
+    'trusty-juno/updates': 'trusty-updates/juno',
+    'trusty-updates/juno': 'trusty-updates/juno',
+    'juno/proposed': 'trusty-proposed/juno',
+    'trusty-juno/proposed': 'trusty-proposed/juno',
+    'trusty-proposed/juno': 'trusty-proposed/juno',
+    # Kilo
+    'kilo': 'trusty-updates/kilo',
+    'kilo/updates': 'trusty-updates/kilo',
+    'trusty-kilo': 'trusty-updates/kilo',
+    'trusty-kilo/updates': 'trusty-updates/kilo',
+    'trusty-updates/kilo': 'trusty-updates/kilo',
+    'kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-proposed/kilo': 'trusty-proposed/kilo',
+    # Liberty
+    'liberty': 'trusty-updates/liberty',
+    'liberty/updates': 'trusty-updates/liberty',
+    'trusty-liberty': 'trusty-updates/liberty',
+    'trusty-liberty/updates': 'trusty-updates/liberty',
+    'trusty-updates/liberty': 'trusty-updates/liberty',
+    'liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-proposed/liberty': 'trusty-proposed/liberty',
+    # Mitaka
+    'mitaka': 'trusty-updates/mitaka',
+    'mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-mitaka': 'trusty-updates/mitaka',
+    'trusty-mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-updates/mitaka': 'trusty-updates/mitaka',
+    'mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-proposed/mitaka': 'trusty-proposed/mitaka',
+    # Newton
+    'newton': 'xenial-updates/newton',
+    'newton/updates': 'xenial-updates/newton',
+    'xenial-newton': 'xenial-updates/newton',
+    'xenial-newton/updates': 'xenial-updates/newton',
+    'xenial-updates/newton': 'xenial-updates/newton',
+    'newton/proposed': 'xenial-proposed/newton',
+    'xenial-newton/proposed': 'xenial-proposed/newton',
+    'xenial-proposed/newton': 'xenial-proposed/newton',
+    # Ocata
+    'ocata': 'xenial-updates/ocata',
+    'ocata/updates': 'xenial-updates/ocata',
+    'xenial-ocata': 'xenial-updates/ocata',
+    'xenial-ocata/updates': 'xenial-updates/ocata',
+    'xenial-updates/ocata': 'xenial-updates/ocata',
+    'ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-proposed/ocata': 'xenial-proposed/ocata',
+    # Pike
+    'pike': 'xenial-updates/pike',
+    'xenial-pike': 'xenial-updates/pike',
+    'xenial-pike/updates': 'xenial-updates/pike',
+    'xenial-updates/pike': 'xenial-updates/pike',
+    'pike/proposed': 'xenial-proposed/pike',
+    'xenial-pike/proposed': 'xenial-proposed/pike',
+    'xenial-proposed/pike': 'xenial-proposed/pike',
+    # Queens
+    'queens': 'xenial-updates/queens',
+    'xenial-queens': 'xenial-updates/queens',
+    'xenial-queens/updates': 'xenial-updates/queens',
+    'xenial-updates/queens': 'xenial-updates/queens',
+    'queens/proposed': 'xenial-proposed/queens',
+    'xenial-queens/proposed': 'xenial-proposed/queens',
+    'xenial-proposed/queens': 'xenial-proposed/queens',
+    # Rocky
+    'rocky': 'bionic-updates/rocky',
+    'bionic-rocky': 'bionic-updates/rocky',
+    'bionic-rocky/updates': 'bionic-updates/rocky',
+    'bionic-updates/rocky': 'bionic-updates/rocky',
+    'rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-proposed/rocky': 'bionic-proposed/rocky',
+    # Stein
+    'stein': 'bionic-updates/stein',
+    'bionic-stein': 'bionic-updates/stein',
+    'bionic-stein/updates': 'bionic-updates/stein',
+    'bionic-updates/stein': 'bionic-updates/stein',
+    'stein/proposed': 'bionic-proposed/stein',
+    'bionic-stein/proposed': 'bionic-proposed/stein',
+    'bionic-proposed/stein': 'bionic-proposed/stein',
+    # Train
+    'train': 'bionic-updates/train',
+    'bionic-train': 'bionic-updates/train',
+    'bionic-train/updates': 'bionic-updates/train',
+    'bionic-updates/train': 'bionic-updates/train',
+    'train/proposed': 'bionic-proposed/train',
+    'bionic-train/proposed': 'bionic-proposed/train',
+    'bionic-proposed/train': 'bionic-proposed/train',
+    # Ussuri
+    'ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri/updates': 'bionic-updates/ussuri',
+    'bionic-updates/ussuri': 'bionic-updates/ussuri',
+    'ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-proposed/ussuri': 'bionic-proposed/ussuri',
+}
+
+
+APT_NO_LOCK = 100  # The return code for "couldn't acquire lock" in APT.
+CMD_RETRY_DELAY = 10  # Wait 10 seconds between command retries.
+CMD_RETRY_COUNT = 3  # Retry a failing fatal command X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    cache = apt_cache()
+    _pkgs = []
+    for package in packages:
+        try:
+            p = cache[package]
+            p.current_ver or _pkgs.append(package)
+        except KeyError:
+            log('Package {} has no installation candidate.'.format(package),
+                level='WARNING')
+            _pkgs.append(package)
+    return _pkgs
+
+
+def filter_missing_packages(packages):
+    """Return a list of packages that are installed.
+
+    :param packages: list of packages to evaluate.
+    :returns list: Packages that are installed.
+    """
+    return list(
+        set(packages) -
+        set(filter_installed_packages(packages))
+    )
+
+
+def apt_cache(*_, **__):
+    """Shim returning an object simulating the apt_pkg Cache.
+
+    :param _: Accept arguments for compability, not used.
+    :type _: any
+    :param __: Accept keyword arguments for compability, not used.
+    :type __: any
+    :returns:Object used to interrogate the system apt and dpkg databases.
+    :rtype:ubuntu_apt_pkg.Cache
+    """
+    if 'apt_pkg' in sys.modules:
+        # NOTE(fnordahl): When our consumer use the upstream ``apt_pkg`` module
+        # in conjunction with the apt_cache helper function, they may expect us
+        # to call ``apt_pkg.init()`` for them.
+        #
+        # Detect this situation, log a warning and make the call to
+        # ``apt_pkg.init()`` to avoid the consumer Python interpreter from
+        # crashing with a segmentation fault.
+        log('Support for use of upstream ``apt_pkg`` module in conjunction'
+            'with charm-helpers is deprecated since 2019-06-25', level=WARNING)
+        sys.modules['apt_pkg'].init()
+    return ubuntu_apt_pkg.Cache()
+
+
+def apt_install(packages, options=None, fatal=False):
+    """Install one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages.
+
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :param dist: Whether ``dist-upgrade`` should be used over ``upgrade``
+    :type dist: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    if dist:
+        cmd.append('dist-upgrade')
+    else:
+        cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_update(fatal=False):
+    """Update local apt cache."""
+    cmd = ['apt-get', 'update']
+    _run_apt_command(cmd, fatal)
+
+
+def apt_purge(packages, fatal=False):
+    """Purge one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'purge']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_autoremove(purge=True, fatal=False):
+    """Purge one or more packages.
+    :param purge: Whether the ``--purge`` option should be passed on or not.
+    :type purge: bool
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'autoremove']
+    if purge:
+        cmd.append('--purge')
+    _run_apt_command(cmd, fatal)
+
+
+def apt_mark(packages, mark, fatal=False):
+    """Flag one or more packages using apt-mark."""
+    log("Marking {} as {}".format(packages, mark))
+    cmd = ['apt-mark', mark]
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+
+    if fatal:
+        subprocess.check_call(cmd, universal_newlines=True)
+    else:
+        subprocess.call(cmd, universal_newlines=True)
+
+
+def apt_hold(packages, fatal=False):
+    return apt_mark(packages, 'hold', fatal=fatal)
+
+
+def apt_unhold(packages, fatal=False):
+    return apt_mark(packages, 'unhold', fatal=fatal)
+
+
+def import_key(key):
+    """Import an ASCII Armor key.
+
+    A Radix64 format keyid is also supported for backwards
+    compatibility. In this case Ubuntu keyserver will be
+    queried for a key via HTTPS by its keyid. This method
+    is less preferrable because https proxy servers may
+    require traffic decryption which is equivalent to a
+    man-in-the-middle attack (a proxy server impersonates
+    keyserver TLS certificates and has to be explicitly
+    trusted by the system).
+
+    :param key: A GPG key in ASCII armor format,
+                  including BEGIN and END markers or a keyid.
+    :type key: (bytes, str)
+    :raises: GPGKeyError if the key could not be imported
+    """
+    key = key.strip()
+    if '-' in key or '\n' in key:
+        # Send everything not obviously a keyid to GPG to import, as
+        # we trust its validation better than our own. eg. handling
+        # comments before the key.
+        log("PGP key found (looks like ASCII Armor format)", level=DEBUG)
+        if ('-----BEGIN PGP PUBLIC KEY BLOCK-----' in key and
+                '-----END PGP PUBLIC KEY BLOCK-----' in key):
+            log("Writing provided PGP key in the binary format", level=DEBUG)
+            if six.PY3:
+                key_bytes = key.encode('utf-8')
+            else:
+                key_bytes = key
+            key_name = _get_keyid_by_gpg_key(key_bytes)
+            key_gpg = _dearmor_gpg_key(key_bytes)
+            _write_apt_gpg_keyfile(key_name=key_name, key_material=key_gpg)
+        else:
+            raise GPGKeyError("ASCII armor markers missing from GPG key")
+    else:
+        log("PGP key found (looks like Radix64 format)", level=WARNING)
+        log("SECURELY importing PGP key from keyserver; "
+            "full key not provided.", level=WARNING)
+        # as of bionic add-apt-repository uses curl with an HTTPS keyserver URL
+        # to retrieve GPG keys. `apt-key adv` command is deprecated as is
+        # apt-key in general as noted in its manpage. See lp:1433761 for more
+        # history. Instead, /etc/apt/trusted.gpg.d is used directly to drop
+        # gpg
+        key_asc = _get_key_by_keyid(key)
+        # write the key in GPG format so that apt-key list shows it
+        key_gpg = _dearmor_gpg_key(key_asc)
+        _write_apt_gpg_keyfile(key_name=key, key_material=key_gpg)
+
+
+def _get_keyid_by_gpg_key(key_material):
+    """Get a GPG key fingerprint by GPG key material.
+    Gets a GPG key fingerprint (40-digit, 160-bit) by the ASCII armor-encoded
+    or binary GPG key material. Can be used, for example, to generate file
+    names for keys passed via charm options.
+
+    :param key_material: ASCII armor-encoded or binary GPG key material
+    :type key_material: bytes
+    :raises: GPGKeyError if invalid key material has been provided
+    :returns: A GPG key fingerprint
+    :rtype: str
+    """
+    # Use the same gpg command for both Xenial and Bionic
+    cmd = 'gpg --with-colons --with-fingerprint'
+    ps = subprocess.Popen(cmd.split(),
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_material)
+    if six.PY3:
+        out = out.decode('utf-8')
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material provided')
+    # from gnupg2 docs: fpr :: Fingerprint (fingerprint is in field 10)
+    return re.search(r"^fpr:{9}([0-9A-F]{40}):$", out, re.MULTILINE).group(1)
+
+
+def _get_key_by_keyid(keyid):
+    """Get a key via HTTPS from the Ubuntu keyserver.
+    Different key ID formats are supported by SKS keyservers (the longer ones
+    are more secure, see "dead beef attack" and https://evil32.com/). Since
+    HTTPS is used, if SSLBump-like HTTPS proxies are in place, they will
+    impersonate keyserver.ubuntu.com and generate a certificate with
+    keyserver.ubuntu.com in the CN field or in SubjAltName fields of a
+    certificate. If such proxy behavior is expected it is necessary to add the
+    CA certificate chain containing the intermediate CA of the SSLBump proxy to
+    every machine that this code runs on via ca-certs cloud-init directive (via
+    cloudinit-userdata model-config) or via other means (such as through a
+    custom charm option). Also note that DNS resolution for the hostname in a
+    URL is done at a proxy server - not at the client side.
+
+    8-digit (32 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x4652B4E6
+    16-digit (64 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x6E85A86E4652B4E6
+    40-digit key ID:
+    https://keyserver.ubuntu.com/pks/lookup?search=0x35F77D63B5CEC106C577ED856E85A86E4652B4E6
+
+    :param keyid: An 8, 16 or 40 hex digit keyid to find a key for
+    :type keyid: (bytes, str)
+    :returns: A key material for the specified GPG key id
+    :rtype: (str, bytes)
+    :raises: subprocess.CalledProcessError
+    """
+    # options=mr - machine-readable output (disables html wrappers)
+    keyserver_url = ('https://keyserver.ubuntu.com'
+                     '/pks/lookup?op=get&options=mr&exact=on&search=0x{}')
+    curl_cmd = ['curl', keyserver_url.format(keyid)]
+    # use proxy server settings in order to retrieve the key
+    return subprocess.check_output(curl_cmd,
+                                   env=env_proxy_settings(['https']))
+
+
+def _dearmor_gpg_key(key_asc):
+    """Converts a GPG key in the ASCII armor format to the binary format.
+
+    :param key_asc: A GPG key in ASCII armor format.
+    :type key_asc: (str, bytes)
+    :returns: A GPG key in binary format
+    :rtype: (str, bytes)
+    :raises: GPGKeyError
+    """
+    ps = subprocess.Popen(['gpg', '--dearmor'],
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_asc)
+    # no need to decode output as it is binary (invalid utf-8), only error
+    if six.PY3:
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material. Check your network setup'
+                          ' (MTU, routing, DNS) and/or proxy server settings'
+                          ' as well as destination keyserver status.')
+    else:
+        return out
+
+
+def _write_apt_gpg_keyfile(key_name, key_material):
+    """Writes GPG key material into a file at a provided path.
+
+    :param key_name: A key name to use for a key file (could be a fingerprint)
+    :type key_name: str
+    :param key_material: A GPG key material (binary)
+    :type key_material: (str, bytes)
+    """
+    with open('/etc/apt/trusted.gpg.d/{}.gpg'.format(key_name),
+              'wb') as keyf:
+        keyf.write(key_material)
+
+
+def add_source(source, key=None, fail_invalid=False):
+    """Add a package source to this system.
+
+    @param source: a URL or sources.list entry, as supported by
+    add-apt-repository(1). Examples::
+
+        ppa:charmers/example
+        deb https://stub:key@private.example.com/ubuntu trusty main
+
+    In addition:
+        'proposed:' may be used to enable the standard 'proposed'
+        pocket for the release.
+        'cloud:' may be used to activate official cloud archive pockets,
+        such as 'cloud:icehouse'
+        'distro' may be used as a noop
+
+    Full list of source specifications supported by the function are:
+
+    'distro': A NOP; i.e. it has no effect.
+    'proposed': the proposed deb spec [2] is wrtten to
+      /etc/apt/sources.list/proposed
+    'distro-proposed': adds <version>-proposed to the debs [2]
+    'ppa:<ppa-name>': add-apt-repository --yes <ppa_name>
+    'deb <deb-spec>': add-apt-repository --yes deb <deb-spec>
+    'http://....': add-apt-repository --yes http://...
+    'cloud-archive:<spec>': add-apt-repository -yes cloud-archive:<spec>
+    'cloud:<release>[-staging]': specify a Cloud Archive pocket <release> with
+      optional staging version.  If staging is used then the staging PPA [2]
+      with be used.  If staging is NOT used then the cloud archive [3] will be
+      added, and the 'ubuntu-cloud-keyring' package will be added for the
+      current distro.
+
+    Otherwise the source is not recognised and this is logged to the juju log.
+    However, no error is raised, unless sys_error_on_exit is True.
+
+    [1] deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+        where {} is replaced with the derived pocket name.
+    [2] deb http://archive.ubuntu.com/ubuntu {}-proposed \
+        main universe multiverse restricted
+        where {} is replaced with the lsb_release codename (e.g. xenial)
+    [3] deb http://ubuntu-cloud.archive.canonical.com/ubuntu <pocket>
+        to /etc/apt/sources.list.d/cloud-archive-list
+
+    @param key: A key to be added to the system's APT keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk. ppa and cloud archive keys
+    are securely added automtically, so sould not be provided.
+
+    @param fail_invalid: (boolean) if True, then the function raises a
+    SourceConfigError is there is no matching installation source.
+
+    @raises SourceConfigError() if for cloud:<pocket>, the <pocket> is not a
+    valid pocket in CLOUD_ARCHIVE_POCKETS
+    """
+    _mapping = OrderedDict([
+        (r"^distro$", lambda: None),  # This is a NOP
+        (r"^(?:proposed|distro-proposed)$", _add_proposed),
+        (r"^cloud-archive:(.*)$", _add_apt_repository),
+        (r"^((?:deb |http:|https:|ppa:).*)$", _add_apt_repository),
+        (r"^cloud:(.*)-(.*)\/staging$", _add_cloud_staging),
+        (r"^cloud:(.*)-(.*)$", _add_cloud_distro_check),
+        (r"^cloud:(.*)$", _add_cloud_pocket),
+        (r"^snap:.*-(.*)-(.*)$", _add_cloud_distro_check),
+    ])
+    if source is None:
+        source = ''
+    for r, fn in six.iteritems(_mapping):
+        m = re.match(r, source)
+        if m:
+            if key:
+                # Import key before adding the source which depends on it,
+                # as refreshing packages could fail otherwise.
+                try:
+                    import_key(key)
+                except GPGKeyError as e:
+                    raise SourceConfigError(str(e))
+            # call the associated function with the captured groups
+            # raises SourceConfigError on error.
+            fn(*m.groups())
+            break
+    else:
+        # nothing matched.  log an error and maybe sys.exit
+        err = "Unknown source: {!r}".format(source)
+        log(err)
+        if fail_invalid:
+            raise SourceConfigError(err)
+
+
+def _add_proposed():
+    """Add the PROPOSED_POCKET as /etc/apt/source.list.d/proposed.list
+
+    Uses get_distrib_codename to determine the correct stanza for
+    the deb line.
+
+    For intel architecutres PROPOSED_POCKET is used for the release, but for
+    other architectures PROPOSED_PORTS_POCKET is used for the release.
+    """
+    release = get_distrib_codename()
+    arch = platform.machine()
+    if arch not in six.iterkeys(ARCH_TO_PROPOSED_POCKET):
+        raise SourceConfigError("Arch {} not supported for (distro-)proposed"
+                                .format(arch))
+    with open('/etc/apt/sources.list.d/proposed.list', 'w') as apt:
+        apt.write(ARCH_TO_PROPOSED_POCKET[arch].format(release))
+
+
+def _add_apt_repository(spec):
+    """Add the spec using add_apt_repository
+
+    :param spec: the parameter to pass to add_apt_repository
+    :type spec: str
+    """
+    if '{series}' in spec:
+        series = get_distrib_codename()
+        spec = spec.replace('{series}', series)
+    # software-properties package for bionic properly reacts to proxy settings
+    # passed as environment variables (See lp:1433761). This is not the case
+    # LTS and non-LTS releases below bionic.
+    _run_with_retries(['add-apt-repository', '--yes', spec],
+                      cmd_env=env_proxy_settings(['https']))
+
+
+def _add_cloud_pocket(pocket):
+    """Add a cloud pocket as /etc/apt/sources.d/cloud-archive.list
+
+    Note that this overwrites the existing file if there is one.
+
+    This function also converts the simple pocket in to the actual pocket using
+    the CLOUD_ARCHIVE_POCKETS mapping.
+
+    :param pocket: string representing the pocket to add a deb spec for.
+    :raises: SourceConfigError if the cloud pocket doesn't exist or the
+        requested release doesn't match the current distro version.
+    """
+    apt_install(filter_installed_packages(['ubuntu-cloud-keyring']),
+                fatal=True)
+    if pocket not in CLOUD_ARCHIVE_POCKETS:
+        raise SourceConfigError(
+            'Unsupported cloud: source option %s' %
+            pocket)
+    actual_pocket = CLOUD_ARCHIVE_POCKETS[pocket]
+    with open('/etc/apt/sources.list.d/cloud-archive.list', 'w') as apt:
+        apt.write(CLOUD_ARCHIVE.format(actual_pocket))
+
+
+def _add_cloud_staging(cloud_archive_release, openstack_release):
+    """Add the cloud staging repository which is in
+    ppa:ubuntu-cloud-archive/<openstack_release>-staging
+
+    This function checks that the cloud_archive_release matches the current
+    codename for the distro that charm is being installed on.
+
+    :param cloud_archive_release: string, codename for the release.
+    :param openstack_release: String, codename for the openstack release.
+    :raises: SourceConfigError if the cloud_archive_release doesn't match the
+        current version of the os.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    ppa = 'ppa:ubuntu-cloud-archive/{}-staging'.format(openstack_release)
+    cmd = 'add-apt-repository -y {}'.format(ppa)
+    _run_with_retries(cmd.split(' '))
+
+
+def _add_cloud_distro_check(cloud_archive_release, openstack_release):
+    """Add the cloud pocket, but also check the cloud_archive_release against
+    the current distro, and use the openstack_release as the full lookup.
+
+    This just calls _add_cloud_pocket() with the openstack_release as pocket
+    to get the correct cloud-archive.list for dpkg to work with.
+
+    :param cloud_archive_release:String, codename for the distro release.
+    :param openstack_release: String, spec for the release to look up in the
+        CLOUD_ARCHIVE_POCKETS
+    :raises: SourceConfigError if this is the wrong distro, or the pocket spec
+        doesn't exist.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    _add_cloud_pocket("{}-{}".format(cloud_archive_release, openstack_release))
+
+
+def _verify_is_ubuntu_rel(release, os_release):
+    """Verify that the release is in the same as the current ubuntu release.
+
+    :param release: String, lowercase for the release.
+    :param os_release: String, the os_release being asked for
+    :raises: SourceConfigError if the release is not the same as the ubuntu
+        release.
+    """
+    ubuntu_rel = get_distrib_codename()
+    if release != ubuntu_rel:
+        raise SourceConfigError(
+            'Invalid Cloud Archive release specified: {}-{} on this Ubuntu'
+            'version ({})'.format(release, os_release, ubuntu_rel))
+
+
+def _run_with_retries(cmd, max_retries=CMD_RETRY_COUNT, retry_exitcodes=(1,),
+                      retry_message="", cmd_env=None):
+    """Run a command and retry until success or max_retries is reached.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param max_retries: The number of retries to attempt on a fatal
+                        command. Defaults to CMD_RETRY_COUNT.
+    :type max_retries: int
+    :param retry_exitcodes: Optional additional exit codes to retry.
+                            Defaults to retry on exit code 1.
+    :type retry_exitcodes: tuple
+    :param retry_message: Optional log prefix emitted during retries.
+    :type retry_message: str
+    :param: cmd_env: Environment variables to add to the command run.
+    :type cmd_env: Option[None, Dict[str, str]]
+    """
+    env = get_apt_dpkg_env()
+    if cmd_env:
+        env.update(cmd_env)
+
+    if not retry_message:
+        retry_message = "Failed executing '{}'".format(" ".join(cmd))
+    retry_message += ". Will retry in {} seconds".format(CMD_RETRY_DELAY)
+
+    retry_count = 0
+    result = None
+
+    retry_results = (None,) + retry_exitcodes
+    while result in retry_results:
+        try:
+            result = subprocess.check_call(cmd, env=env)
+        except subprocess.CalledProcessError as e:
+            retry_count = retry_count + 1
+            if retry_count > max_retries:
+                raise
+            result = e.returncode
+            log(retry_message)
+            time.sleep(CMD_RETRY_DELAY)
+
+
+def _run_apt_command(cmd, fatal=False):
+    """Run an apt command with optional retries.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    """
+    if fatal:
+        _run_with_retries(
+            cmd, retry_exitcodes=(1, APT_NO_LOCK,),
+            retry_message="Couldn't acquire DPKG lock")
+    else:
+        subprocess.call(cmd, env=get_apt_dpkg_env())
+
+
+def get_upstream_version(package):
+    """Determine upstream version based on installed package
+
+    @returns None (if not installed) or the upstream version
+    """
+    cache = apt_cache()
+    try:
+        pkg = cache[package]
+    except Exception:
+        # the package is unknown to the current apt cache.
+        return None
+
+    if not pkg.current_ver:
+        # package is known, but no version is currently installed.
+        return None
+
+    return ubuntu_apt_pkg.upstream_version(pkg.current_ver.ver_str)
+
+
+def get_apt_dpkg_env():
+    """Get environment suitable for execution of APT and DPKG tools.
+
+    We keep this in a helper function instead of in a global constant to
+    avoid execution on import of the library.
+    :returns: Environment suitable for execution of APT and DPKG tools.
+    :rtype: Dict[str, str]
+    """
+    # The fallback is used in the event of ``/etc/environment`` not containing
+    # avalid PATH variable.
+    return {'DEBIAN_FRONTEND': 'noninteractive',
+            'PATH': get_system_env('PATH', '/usr/sbin:/usr/bin:/sbin:/bin')}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu_apt_pkg.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu_apt_pkg.py
new file mode 100644
index 0000000000000000000000000000000000000000..929a75d7a775921c32368e8cc7950eaa97390047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/fetch/ubuntu_apt_pkg.py
@@ -0,0 +1,267 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Provide a subset of the ``python-apt`` module API.
+
+Data collection is done through subprocess calls to ``apt-cache`` and
+``dpkg-query`` commands.
+
+The main purpose for this module is to avoid dependency on the
+``python-apt`` python module.
+
+The indicated python module is a wrapper around the ``apt`` C++ library
+which is tightly connected to the version of the distribution it was
+shipped on.  It is not developed in a backward/forward compatible manner.
+
+This in turn makes it incredibly hard to distribute as a wheel for a piece
+of python software that supports a span of distro releases [0][1].
+
+Upstream feedback like [2] does not give confidence in this ever changing,
+so with this we get rid of the dependency.
+
+0: https://github.com/juju-solutions/layer-basic/pull/135
+1: https://bugs.launchpad.net/charm-octavia/+bug/1824112
+2: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845330#10
+"""
+
+import locale
+import os
+import subprocess
+import sys
+
+
+class _container(dict):
+    """Simple container for attributes."""
+    __getattr__ = dict.__getitem__
+    __setattr__ = dict.__setitem__
+
+
+class Package(_container):
+    """Simple container for package attributes."""
+
+
+class Version(_container):
+    """Simple container for version attributes."""
+
+
+class Cache(object):
+    """Simulation of ``apt_pkg`` Cache object."""
+    def __init__(self, progress=None):
+        pass
+
+    def __contains__(self, package):
+        try:
+            pkg = self.__getitem__(package)
+            return pkg is not None
+        except KeyError:
+            return False
+
+    def __getitem__(self, package):
+        """Get information about a package from apt and dpkg databases.
+
+        :param package: Name of package
+        :type package: str
+        :returns: Package object
+        :rtype: object
+        :raises: KeyError, subprocess.CalledProcessError
+        """
+        apt_result = self._apt_cache_show([package])[package]
+        apt_result['name'] = apt_result.pop('package')
+        pkg = Package(apt_result)
+        dpkg_result = self._dpkg_list([package]).get(package, {})
+        current_ver = None
+        installed_version = dpkg_result.get('version')
+        if installed_version:
+            current_ver = Version({'ver_str': installed_version})
+        pkg.current_ver = current_ver
+        pkg.architecture = dpkg_result.get('architecture')
+        return pkg
+
+    def _dpkg_list(self, packages):
+        """Get data from system dpkg database for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about installed packages, keys like
+                  ``dpkg-query --list``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['dpkg-query', '--list']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+        except subprocess.CalledProcessError as cp:
+            # ``dpkg-query`` may return error and at the same time have
+            # produced useful output, for example when asked for multiple
+            # packages where some are not installed
+            if cp.returncode != 1:
+                raise
+            output = cp.output
+        headings = []
+        for line in output.splitlines():
+            if line.startswith('||/'):
+                headings = line.split()
+                headings.pop(0)
+                continue
+            elif (line.startswith('|') or line.startswith('+') or
+                  line.startswith('dpkg-query:')):
+                continue
+            else:
+                data = line.split(None, 4)
+                status = data.pop(0)
+                if status != 'ii':
+                    continue
+                pkg = {}
+                pkg.update({k.lower(): v for k, v in zip(headings, data)})
+                if 'name' in pkg:
+                    pkgs.update({pkg['name']: pkg})
+        return pkgs
+
+    def _apt_cache_show(self, packages):
+        """Get data from system apt cache for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about package, keys like
+                  ``apt-cache show``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['apt-cache', 'show', '--no-all-versions']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+            previous = None
+            pkg = {}
+            for line in output.splitlines():
+                if not line:
+                    if 'package' in pkg:
+                        pkgs.update({pkg['package']: pkg})
+                        pkg = {}
+                    continue
+                if line.startswith(' '):
+                    if previous and previous in pkg:
+                        pkg[previous] += os.linesep + line.lstrip()
+                    continue
+                if ':' in line:
+                    kv = line.split(':', 1)
+                    key = kv[0].lower()
+                    if key == 'n':
+                        continue
+                    previous = key
+                    pkg.update({key: kv[1].lstrip()})
+        except subprocess.CalledProcessError as cp:
+            # ``apt-cache`` returns 100 if none of the packages asked for
+            # exist in the apt cache.
+            if cp.returncode != 100:
+                raise
+        return pkgs
+
+
+class Config(_container):
+    def __init__(self):
+        super(Config, self).__init__(self._populate())
+
+    def _populate(self):
+        cfgs = {}
+        cmd = ['apt-config', 'dump']
+        output = subprocess.check_output(cmd,
+                                         stderr=subprocess.STDOUT,
+                                         universal_newlines=True)
+        for line in output.splitlines():
+            if not line.startswith("CommandLine"):
+                k, v = line.split(" ", 1)
+                cfgs[k] = v.strip(";").strip("\"")
+
+        return cfgs
+
+
+# Backwards compatibility with old apt_pkg module
+sys.modules[__name__].config = Config()
+
+
+def init():
+    """Compability shim that does nothing."""
+    pass
+
+
+def upstream_version(version):
+    """Extracts upstream version from a version string.
+
+    Upstream reference: https://salsa.debian.org/apt-team/apt/blob/master/
+                                apt-pkg/deb/debversion.cc#L259
+
+    :param version: Version string
+    :type version: str
+    :returns: Upstream version
+    :rtype: str
+    """
+    if version:
+        version = version.split(':')[-1]
+        version = version.split('-')[0]
+    return version
+
+
+def version_compare(a, b):
+    """Compare the given versions.
+
+    Call out to ``dpkg`` to make sure the code doing the comparison is
+    compatible with what the ``apt`` library would do.  Mimic the return
+    values.
+
+    Upstream reference:
+    https://apt-team.pages.debian.net/python-apt/library/apt_pkg.html
+            ?highlight=version_compare#apt_pkg.version_compare
+
+    :param a: version string
+    :type a: str
+    :param b: version string
+    :type b: str
+    :returns: >0 if ``a`` is greater than ``b``, 0 if a equals b,
+              <0 if ``a`` is smaller than ``b``
+    :rtype: int
+    :raises: subprocess.CalledProcessError, RuntimeError
+    """
+    for op in ('gt', 1), ('eq', 0), ('lt', -1):
+        try:
+            subprocess.check_call(['dpkg', '--compare-versions',
+                                   a, op[0], b],
+                                  stderr=subprocess.STDOUT,
+                                  universal_newlines=True)
+            return op[1]
+        except subprocess.CalledProcessError as cp:
+            if cp.returncode == 1:
+                continue
+            raise
+    else:
+        raise RuntimeError('Unable to compare "{}" and "{}", according to '
+                           'our logic they are neither greater, equal nor '
+                           'less than each other.')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/osplatform.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/osplatform.py
new file mode 100644
index 0000000000000000000000000000000000000000..78c81af5955caee51271c830d58cacac2cab9bcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/osplatform.py
@@ -0,0 +1,46 @@
+import platform
+import os
+
+
+def get_platform():
+    """Return the current OS platform.
+
+    For example: if current os platform is Ubuntu then a string "ubuntu"
+    will be returned (which is the name of the module).
+    This string is used to decide which platform module should be imported.
+    """
+    # linux_distribution is deprecated and will be removed in Python 3.7
+    # Warnings *not* disabled, as we certainly need to fix this.
+    if hasattr(platform, 'linux_distribution'):
+        tuple_platform = platform.linux_distribution()
+        current_platform = tuple_platform[0]
+    else:
+        current_platform = _get_platform_from_fs()
+
+    if "Ubuntu" in current_platform:
+        return "ubuntu"
+    elif "CentOS" in current_platform:
+        return "centos"
+    elif "debian" in current_platform:
+        # Stock Python does not detect Ubuntu and instead returns debian.
+        # Or at least it does in some build environments like Travis CI
+        return "ubuntu"
+    elif "elementary" in current_platform:
+        # ElementaryOS fails to run tests locally without this.
+        return "ubuntu"
+    else:
+        raise RuntimeError("This module is not supported on {}."
+                           .format(current_platform))
+
+
+def _get_platform_from_fs():
+    """Get Platform from /etc/os-release."""
+    with open(os.path.join(os.sep, 'etc', 'os-release')) as fin:
+        content = dict(
+            line.split('=', 1)
+            for line in fin.read().splitlines()
+            if '=' in line
+        )
+    for k, v in content.items():
+        content[k] = v.strip('"')
+    return content["NAME"]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee55cb3d2baddb556df910f1d41638c3c7f39c59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/__init__.py
@@ -0,0 +1,15 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Tools for working with files injected into a charm just before deployment."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/archive.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/archive.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fc453f523cf49f0c123839a347c4452c6d465ca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/archive.py
@@ -0,0 +1,71 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import tarfile
+import zipfile
+from charmhelpers.core import (
+    host,
+    hookenv,
+)
+
+
+class ArchiveError(Exception):
+    pass
+
+
+def get_archive_handler(archive_name):
+    if os.path.isfile(archive_name):
+        if tarfile.is_tarfile(archive_name):
+            return extract_tarfile
+        elif zipfile.is_zipfile(archive_name):
+            return extract_zipfile
+    else:
+        # look at the file name
+        for ext in ('.tar', '.tar.gz', '.tgz', 'tar.bz2', '.tbz2', '.tbz'):
+            if archive_name.endswith(ext):
+                return extract_tarfile
+        for ext in ('.zip', '.jar'):
+            if archive_name.endswith(ext):
+                return extract_zipfile
+
+
+def archive_dest_default(archive_name):
+    archive_file = os.path.basename(archive_name)
+    return os.path.join(hookenv.charm_dir(), "archives", archive_file)
+
+
+def extract(archive_name, destpath=None):
+    handler = get_archive_handler(archive_name)
+    if handler:
+        if not destpath:
+            destpath = archive_dest_default(archive_name)
+        if not os.path.isdir(destpath):
+            host.mkdir(destpath)
+        handler(archive_name, destpath)
+        return destpath
+    else:
+        raise ArchiveError("No handler for archive")
+
+
+def extract_tarfile(archive_name, destpath):
+    "Unpack a tar archive, optionally compressed"
+    archive = tarfile.open(archive_name)
+    archive.extractall(destpath)
+
+
+def extract_zipfile(archive_name, destpath):
+    "Unpack a zip file"
+    archive = zipfile.ZipFile(archive_name)
+    archive.extractall(destpath)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/execd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/execd.py
new file mode 100644
index 0000000000000000000000000000000000000000..1502aa0b596f0b1a2017ccb4543a35999774431d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charmhelpers/payload/execd.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def default_execd_dir():
+    return os.path.join(os.environ['CHARM_DIR'], 'exec.d')
+
+
+def execd_module_paths(execd_dir=None):
+    """Generate a list of full paths to modules within execd_dir."""
+    if not execd_dir:
+        execd_dir = default_execd_dir()
+
+    if not os.path.exists(execd_dir):
+        return
+
+    for subpath in os.listdir(execd_dir):
+        module = os.path.join(execd_dir, subpath)
+        if os.path.isdir(module):
+            yield module
+
+
+def execd_submodule_paths(command, execd_dir=None):
+    """Generate a list of full paths to the specified command within exec_dir.
+    """
+    for module_path in execd_module_paths(execd_dir):
+        path = os.path.join(module_path, command)
+        if os.access(path, os.X_OK) and os.path.isfile(path):
+            yield path
+
+
+def execd_run(command, execd_dir=None, die_on_error=True, stderr=subprocess.STDOUT):
+    """Run command for each module within execd_dir which defines it."""
+    for submodule_path in execd_submodule_paths(command, execd_dir):
+        try:
+            subprocess.check_output(submodule_path, stderr=stderr,
+                                    universal_newlines=True)
+        except subprocess.CalledProcessError as e:
+            hookenv.log("Error ({}) running  {}. Output: {}".format(
+                e.returncode, e.cmd, e.output))
+            if die_on_error:
+                sys.exit(e.returncode)
+
+
+def execd_preinstall(execd_dir=None):
+    """Run charm-pre-install for each module within execd_dir."""
+    execd_run('charm-pre-install', execd_dir=execd_dir)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/libansible.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/libansible.py
new file mode 100644
index 0000000000000000000000000000000000000000..811ec4441fdde7f424a6e29800f265a528d27da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/libansible.py
@@ -0,0 +1,108 @@
+##
+# Copyright ETSI OSM
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import fnmatch
+import os
+import subprocess
+import sys
+import yaml
+
+import charmhelpers.fetch
+
+
+sys.path.append("lib")
+
+
+ansible_hosts_path = "/etc/ansible/hosts"
+
+
+def install_ansible_support(from_ppa=True, ppa_location="ppa:ansible/ansible"):
+    """Installs the ansible package.
+
+    By default it is installed from the `PPA`_ linked from
+    the ansible `website`_ or from a ppa specified by a charm config..
+
+    .. _PPA: https://launchpad.net/~rquillo/+archive/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If from_ppa is empty, you must ensure that the package is available
+    from a configured repository.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install("ansible")
+    with open(ansible_hosts_path, "w+") as hosts_file:
+        hosts_file.write("localhost ansible_connection=local")
+
+
+def create_hosts(hostname, username, password, hosts):
+    inventory_path = "/etc/ansible/hosts"
+    with open(inventory_path, 'w') as f:
+        f.write('[{}]\n'.format(hosts))
+        h1 = '{0} ansible_connection=network_cli ansible_network_os=vyos ' \
+             'ansible_ssh_user={1} ansible_ssh_pass={2} ' \
+             'ansible_python_interpreter=/usr/bin/python\n'.format(hostname, username, password)
+        f.write(h1)
+
+
+def create_ansible_cfg():
+    ansible_config_path = "/etc/ansible/ansible.cfg"
+    with open(ansible_config_path, 'w') as f:
+        f.write('[defaults]\n')
+        f.write('host_key_checking = False\n')
+        # logs playbook execution attempts to the specified path
+        f.write('log_path = /var/log/ansible.log\n')
+        f.write('[ssh_connection]\n')
+        f.write('control_path=%(directory)s/%%h-%%r\n')
+        f.write('control_path_dir=~/.ansible/cp\n')
+
+
+# Function to find the playbook path
+def find(pattern, path):
+    result = ""
+    for root, dirs, files in os.walk(path):
+        for name in files:
+            if fnmatch.fnmatch(name, pattern):
+                result = os.path.join(root, name)
+    return result
+
+
+def execute_playbook(playbook_file, hostname, user, password, vars_dict=None):
+    playbook_path = find(playbook_file, '/var/lib/juju/agents/')
+    print("Playbook " + playbook_file + " is " + playbook_path)
+    with open(playbook_path, 'r') as f:
+        playbook_data = yaml.load(f, Loader=yaml.SafeLoader)
+    hosts = 'all'
+    if 'hosts' in playbook_data[0].keys() and playbook_data[0]['hosts']:
+        hosts = playbook_data[0]['hosts']
+    create_ansible_cfg()
+    create_hosts(hostname, user, password, hosts)
+    call = 'ansible-playbook -vvvv %s ' % playbook_path
+    if vars_dict and isinstance(vars_dict, dict) and len(vars_dict) > 0:
+        call += '--extra-vars '
+        string_var = ''
+        for v in vars_dict.items():
+            string_var += '%s=%s ' % v
+        string_var = string_var.strip()
+        call += '"%s"' % string_var
+    call = call.strip()
+    print(call)
+    result = subprocess.check_output(call, shell=True)
+    lastline = result.decode('utf-8').splitlines()[-2]
+    print("Result is " + lastline)
+    return lastline
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/ns.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/ns.py
new file mode 100644
index 0000000000000000000000000000000000000000..25be4056282e48ce946632025be8b466557e3171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/ns.py
@@ -0,0 +1,301 @@
+# A prototype of a library to aid in the development and operation of
+# OSM Network Service charms
+
+import asyncio
+import logging
+import os
+import os.path
+import re
+import subprocess
+import sys
+import time
+import yaml
+
+try:
+    import juju
+except ImportError:
+    # Not all cloud images are created equal
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # Update the apt cache
+        subprocess.check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        subprocess.check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+
+    # Install the libjuju build dependencies
+    subprocess.check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    subprocess.check_call(
+        [sys.executable, "-m", "pip", "install", "juju"],
+    )
+
+from juju.controller import Controller
+
+# Quiet the debug logging
+logging.getLogger('websockets.protocol').setLevel(logging.INFO)
+logging.getLogger('juju.client.connection').setLevel(logging.WARN)
+logging.getLogger('juju.model').setLevel(logging.WARN)
+logging.getLogger('juju.machine').setLevel(logging.WARN)
+
+
+class NetworkService:
+    """A lightweight interface to the Juju controller.
+
+    This NetworkService client is specifically designed to allow a higher-level
+    "NS" charm to interoperate with "VNF" charms, allowing for the execution of
+    Primitives across other charms within the same model.
+    """
+    endpoint = None
+    user = 'admin'
+    secret = None
+    port = 17070
+    loop = None
+    client = None
+    model = None
+    cacert = None
+
+    def __init__(self, user, secret, endpoint=None):
+
+        self.user = user
+        self.secret = secret
+        if endpoint is None:
+            addresses = os.environ['JUJU_API_ADDRESSES']
+            for address in addresses.split(' '):
+                self.endpoint = address
+        else:
+            self.endpoint = endpoint
+
+        # Stash the name of the model
+        self.model = os.environ['JUJU_MODEL_NAME']
+
+        # Load the ca-cert from agent.conf
+        AGENT_PATH = os.path.dirname(os.environ['JUJU_CHARM_DIR'])
+        with open("{}/agent.conf".format(AGENT_PATH), "r") as f:
+            try:
+                y = yaml.safe_load(f)
+                self.cacert = y['cacert']
+            except yaml.YAMLError as exc:
+                print("Unable to find Juju ca-cert.")
+                raise exc
+
+        # Create our event loop
+        self.loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(self.loop)
+
+    async def connect(self):
+        """Connect to the Juju controller."""
+        controller = Controller()
+
+        print(
+            "Connecting to controller... ws://{}:{} as {}/{}".format(
+                self.endpoint,
+                self.port,
+                self.user,
+                self.secret[-4:].rjust(len(self.secret), "*"),
+            )
+        )
+        await controller.connect(
+            endpoint=self.endpoint,
+            username=self.user,
+            password=self.secret,
+            cacert=self.cacert,
+        )
+
+        return controller
+
+    def __del__(self):
+        self.logout()
+
+    async def disconnect(self):
+        """Disconnect from the Juju controller."""
+        if self.client:
+            print("Disconnecting Juju controller")
+            await self.client.disconnect()
+
+    def login(self):
+        """Login to the Juju controller."""
+        if not self.client:
+            # Connect to the Juju API server
+            self.client = self.loop.run_until_complete(self.connect())
+        return self.client
+
+    def logout(self):
+        """Logout of the Juju controller."""
+
+        if self.loop:
+            print("Disconnecting from API")
+            self.loop.run_until_complete(self.disconnect())
+
+    def FormatApplicationName(self, *args):
+        """
+        Generate a Juju-compatible Application name
+
+        :param args tuple: Positional arguments to be used to construct the
+        application name.
+
+        Limitations::
+        - Only accepts characters a-z and non-consequitive dashes (-)
+        - Application name should not exceed 50 characters
+
+        Examples::
+
+            FormatApplicationName("ping_pong_ns", "ping_vnf", "a")
+        """
+        appname = ""
+        for c in "-".join(list(args)):
+            if c.isdigit():
+                c = chr(97 + int(c))
+            elif not c.isalpha():
+                c = "-"
+            appname += c
+
+        return re.sub('-+', '-', appname.lower())
+
+    def GetApplicationName(self, nsr_name, vnf_name, vnf_member_index):
+        """Get the runtime application name of a VNF/VDU.
+
+        This will generate an application name matching the name of the deployed charm,
+        given the right parameters.
+
+        :param nsr_name str: The name of the running Network Service, as specified at instantiation.
+        :param vnf_name str: The name of the VNF or VDU
+        :param vnf_member_index: The vnf-member-index as specified in the descriptor
+        """
+
+        application_name = self.FormatApplicationName(nsr_name, vnf_member_index, vnf_name)
+
+        # This matches the logic used by the LCM
+        application_name = application_name[0:48]
+        vca_index = int(vnf_member_index) - 1
+        application_name += '-' + chr(97 + vca_index // 26) + chr(97 + vca_index % 26)
+
+        return application_name
+
+    def ExecutePrimitiveGetOutput(self, application, primitive, params={}, timeout=600):
+        """Execute a single primitive and return it's output.
+
+        This is a blocking method that will execute a single primitive and wait
+        for its completion before return it's output.
+
+        :param application str: The application name provided by `GetApplicationName`.
+        :param primitive str: The name of the primitive to execute.
+        :param params list: A list of parameters.
+        :param timeout int: A timeout, in seconds, to wait for the primitive to finish. Defaults to 600 seconds.
+        """
+        uuid = self.ExecutePrimitive(application, primitive, params)
+
+        status = None
+        output = None
+
+        starttime = time.time()
+        while(time.time() < starttime + timeout):
+            status = self.GetPrimitiveStatus(uuid)
+            if status in ['completed', 'failed']:
+                break
+            time.sleep(10)
+
+        # When the primitive is done, get the output
+        if status in ['completed', 'failed']:
+            output = self.GetPrimitiveOutput(uuid)
+
+        return output
+
+    def ExecutePrimitive(self, application, primitive, params={}):
+        """Execute a primitive.
+
+        This is a non-blocking method to execute a primitive. It will return
+        the UUID of the queued primitive execution, which you can use
+        for subsequent calls to `GetPrimitiveStatus` and `GetPrimitiveOutput`.
+
+        :param application string: The name of the application
+        :param primitive string: The name of the Primitive.
+        :param params list: A list of parameters.
+
+        :returns uuid string: The UUID of the executed Primitive
+        """
+        uuid = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        # Get the application
+        if application in model.applications:
+            app = model.applications[application]
+
+            # Execute the primitive
+            unit = app.units[0]
+            if unit:
+                action = self.loop.run_until_complete(
+                    unit.run_action(primitive, **params)
+                )
+                uuid = action.id
+                print("Executing action: {}".format(uuid))
+            self.loop.run_until_complete(
+                model.disconnect()
+            )
+        else:
+            # Invalid mapping: application not found. Raise exception
+            raise Exception("Application not found: {}".format(application))
+
+        return uuid
+
+    def GetPrimitiveStatus(self, uuid):
+        """Get the status of a Primitive execution.
+
+        This will return one of the following strings:
+        - pending
+        - running
+        - completed
+        - failed
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The status of the executed Primitive
+        """
+        status = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        status = self.loop.run_until_complete(
+            model.get_action_status(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return status[uuid]
+
+    def GetPrimitiveOutput(self, uuid):
+        """Get the output of a completed Primitive execution.
+
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The output of the execution, or None if it's still running.
+        """
+        result = None
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        result = self.loop.run_until_complete(
+            model.get_action_output(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/proxy_cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/proxy_cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..f323a3af88f3011ef9fde794cdfe343be8665abb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/proxy_cluster.py
@@ -0,0 +1,59 @@
+import socket
+
+from ops.framework import Object, StoredState
+
+
+class ProxyCluster(Object):
+
+    state = StoredState()
+
+    def __init__(self, charm, relation_name):
+        super().__init__(charm, relation_name)
+        self._relation_name = relation_name
+        self._relation = self.framework.model.get_relation(self._relation_name)
+
+        self.framework.observe(charm.on.ssh_keys_initialized, self.on_ssh_keys_initialized)
+
+        self.state.set_default(ssh_public_key=None)
+        self.state.set_default(ssh_private_key=None)
+
+    def on_ssh_keys_initialized(self, event):
+        if not self.framework.model.unit.is_leader():
+            raise RuntimeError("The initial unit of a cluster must also be a leader.")
+
+        self.state.ssh_public_key = event.ssh_public_key
+        self.state.ssh_private_key = event.ssh_private_key
+        if not self.is_joined:
+            event.defer()
+            return
+
+        self._relation.data[self.model.app][
+            "ssh_public_key"
+        ] = self.state.ssh_public_key
+        self._relation.data[self.model.app][
+            "ssh_private_key"
+        ] = self.state.ssh_private_key
+
+    @property
+    def is_joined(self):
+        return self._relation is not None
+
+    @property
+    def ssh_public_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_public_key")
+
+    @property
+    def ssh_private_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_private_key")
+
+    @property
+    def is_cluster_initialized(self):
+        return (
+            True
+            if self.is_joined
+            and self._relation.data[self.model.app].get("ssh_public_key")
+            and self._relation.data[self.model.app].get("ssh_private_key")
+            else False
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/sshproxy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2c311e5be8515a7fe19c05dfed9f042ded0576b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/charms/osm/sshproxy.py
@@ -0,0 +1,375 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# from charmhelpers.core import unitdata
+# from charmhelpers.core.hookenv import log
+
+import io
+import ipaddress
+import subprocess
+import os
+import socket
+import shlex
+import traceback
+import sys
+
+from subprocess import (
+    check_call,
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+import os
+import subprocess
+from .proxy_cluster import ProxyCluster
+
+import logging
+
+
+logger = logging.getLogger(__name__)
+
+class SSHKeysInitialized(EventBase):
+    def __init__(self, handle, ssh_public_key, ssh_private_key):
+        super().__init__(handle)
+        self.ssh_public_key = ssh_public_key
+        self.ssh_private_key = ssh_private_key
+
+    def snapshot(self):
+        return {
+            "ssh_public_key": self.ssh_public_key,
+            "ssh_private_key": self.ssh_private_key,
+        }
+
+    def restore(self, snapshot):
+        self.ssh_public_key = snapshot["ssh_public_key"]
+        self.ssh_private_key = snapshot["ssh_private_key"]
+
+
+class ProxyClusterEvents(CharmEvents):
+    ssh_keys_initialized = EventSource(SSHKeysInitialized)
+
+
+class SSHProxyCharm(CharmBase):
+
+    state = StoredState()
+    on = ProxyClusterEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        self.peers = ProxyCluster(self, "proxypeer")
+
+        # SSH Proxy actions (primitives)
+        self.framework.observe(self.on.generate_ssh_key_action, self.on_generate_ssh_key_action)
+        self.framework.observe(self.on.get_ssh_public_key_action, self.on_get_ssh_public_key_action)
+        self.framework.observe(self.on.run_action, self.on_run_action)
+        self.framework.observe(self.on.verify_ssh_credentials_action, self.on_verify_ssh_credentials_action)
+
+        self.framework.observe(self.on.proxypeer_relation_changed, self.on_proxypeer_relation_changed)
+
+    def get_ssh_proxy(self):
+        """Get the SSHProxy instance"""
+        proxy = SSHProxy(
+            hostname=self.model.config["ssh-hostname"],
+            username=self.model.config["ssh-username"],
+            password=self.model.config["ssh-password"],
+        )
+        return proxy
+
+    def on_proxypeer_relation_changed(self, event):
+        if self.peers.is_cluster_initialized and not SSHProxy.has_ssh_key():
+            pubkey = self.peers.ssh_public_key
+            privkey = self.peers.ssh_private_key
+            SSHProxy.write_ssh_keys(public=pubkey, private=privkey)
+            self.verify_credentials()
+        else:
+            event.defer()
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.verify_credentials()
+
+    def on_install(self, event):
+        SSHProxy.install()
+
+    def on_start(self, event):
+        """Called when the charm is being installed"""
+        if not self.peers.is_joined:
+            event.defer()
+            return
+
+        unit = self.model.unit
+
+        if not SSHProxy.has_ssh_key():
+            unit.status = MaintenanceStatus("Generating SSH keys...")
+            pubkey = None
+            privkey = None
+            if self.model.unit.is_leader():
+                if self.peers.is_cluster_initialized:
+                    SSHProxy.write_ssh_keys(
+                        public=self.peers.ssh_public_key,
+                        private=self.peers.ssh_private_key,
+                    )
+                else:
+                    SSHProxy.generate_ssh_key()
+                    self.on.ssh_keys_initialized.emit(
+                        SSHProxy.get_ssh_public_key(), SSHProxy.get_ssh_private_key()
+                    )
+        self.verify_credentials()
+
+    def verify_credentials(self):
+        unit = self.model.unit
+
+        # Unit should go into a waiting state until verify_ssh_credentials is successful
+        unit.status = WaitingStatus("Waiting for SSH credentials")
+        proxy = self.get_ssh_proxy()
+        verified, _ = proxy.verify_credentials()
+        if verified:
+            unit.status = ActiveStatus()
+        else:
+            unit.status = BlockedStatus("Invalid SSH credentials.")
+        return verified
+
+    #####################
+    # SSH Proxy methods #
+    #####################
+    def on_generate_ssh_key_action(self, event):
+        """Generate a new SSH keypair for this unit."""
+        if self.model.unit.is_leader():
+            if not SSHProxy.generate_ssh_key():
+                event.fail("Unable to generate ssh key")
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_get_ssh_public_key_action(self, event):
+        """Get the SSH public key for this unit."""
+        if self.model.unit.is_leader():
+            pubkey = SSHProxy.get_ssh_public_key()
+            event.set_results({"pubkey": SSHProxy.get_ssh_public_key()})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_run_action(self, event):
+        """Run an arbitrary command on the remote host."""
+        if self.model.unit.is_leader():
+            cmd = event.params["command"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(cmd)
+            event.set_results({"output": stdout})
+            if len(stderr):
+                event.fail(stderr)
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_verify_ssh_credentials_action(self, event):
+        """Verify the SSH credentials for this unit."""
+        unit = self.model.unit
+        if unit.is_leader():
+            proxy = self.get_ssh_proxy()
+            verified, stderr = proxy.verify_credentials()
+            if verified:
+                event.set_results({"verified": True})
+                unit.status = ActiveStatus()
+            else:
+                event.set_results({"verified": False, "stderr": stderr})
+                event.fail("Not verified")
+                unit.status = BlockedStatus("Invalid SSH credentials.")
+
+        else:
+            event.fail("Unit is not leader")
+            return
+
+
+class LeadershipError(ModelError):
+    def __init__(self):
+        super().__init__("not leader")
+
+class SSHProxy:
+    private_key_path = "/root/.ssh/id_sshproxy"
+    public_key_path = "/root/.ssh/id_sshproxy.pub"
+    key_type = "rsa"
+    key_bits = 4096
+
+    def __init__(self, hostname: str, username: str, password: str = ""):
+        self.hostname = hostname
+        self.username = username
+        self.password = password
+
+    @staticmethod
+    def install():
+        check_call("apt update && apt install -y openssh-client sshpass", shell=True)
+
+    @staticmethod
+    def generate_ssh_key():
+        """Generate a 4096-bit rsa keypair."""
+        if not os.path.exists(SSHProxy.private_key_path):
+            cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+                SSHProxy.key_type, SSHProxy.key_bits, SSHProxy.private_key_path,
+            )
+
+            try:
+                check_call(cmd, shell=True)
+            except CalledProcessError:
+                return False
+
+        return True
+
+    @staticmethod
+    def write_ssh_keys(public, private):
+        """Write a 4096-bit rsa keypair."""
+        with open(SSHProxy.public_key_path, "w") as f:
+            f.write(public)
+            f.close()
+        with open(SSHProxy.private_key_path, "w") as f:
+            f.write(private)
+            f.close()
+
+    @staticmethod
+    def get_ssh_public_key():
+        publickey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.public_key_path, "r") as f:
+                publickey = f.read()
+        return publickey
+
+    @staticmethod
+    def get_ssh_private_key():
+        privatekey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.private_key_path, "r") as f:
+                privatekey = f.read()
+        return privatekey
+
+    @staticmethod
+    def has_ssh_key():
+        return True if os.path.exists(SSHProxy.private_key_path) else False
+
+    def run(self, cmd: str) -> (str, str):
+        """Run a command remotely via SSH.
+
+        Note: The previous behavior was to run the command locally if SSH wasn't
+        configured, but that can lead to cases where execution succeeds when you'd
+        expect it not to.
+        """
+        if isinstance(cmd, str):
+            cmd = shlex.split(cmd)
+
+        host = self._get_hostname()
+        user = self.username
+        passwd = self.password
+        key = self.private_key_path
+
+        # Make sure we have everything we need to connect
+        if host and user:
+            return self.ssh(cmd)
+
+        raise Exception("Invalid SSH credentials.")
+
+    def scp(self, source_file, destination_file):
+        """Execute an scp command. Requires a fully qualified source and
+        destination.
+
+        :param str source_file: Path to the source file
+        :param str destination_file: Path to the destination file
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "scp",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            "-B",
+        ]
+        destination = "{}@{}:{}".format(self.username, self.hostname, destination_file)
+        cmd.extend([source_file, destination])
+        subprocess.run(cmd, check=True)
+
+    def ssh(self, command):
+        """Run a command remotely via SSH.
+
+        :param list(str) command: The command to execute
+        :return: tuple: The stdout and stderr of the command execution
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+
+        destination = "{}@{}".format(self.username, self.hostname)
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "ssh",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            destination,
+        ]
+        cmd.extend(command)
+        output = subprocess.run(cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return (output.stdout.decode("utf-8").strip(), output.stderr.decode("utf-8").strip())
+
+    def verify_credentials(self):
+        """Verify the SSH credentials.
+        
+        :return (bool, str): Verified, Stderr
+        """
+        verified = False
+        try:
+            (stdout, stderr) = self.run("hostname")
+            verified = True
+        except CalledProcessError as e:
+            stderr = "Command failed: {} ({})".format(" ".join(e.cmd), str(e.output))
+        except (TimeoutError, socket.timeout):
+            stderr = "Timeout attempting to reach {}".format(self._get_hostname())
+        except Exception as error:
+            tb = traceback.format_exc()
+            stderr = "Unhandled exception: {}".format(tb)
+        return verified, stderr
+
+    ###################
+    # Private methods #
+    ###################
+    def _get_hostname(self):
+        """Get the hostname for the ssh target.
+
+        HACK: This function was added to work around an issue where the
+        ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+        is the floating ip, and the second the non-floating ip, for an Openstack
+        instance.
+        """
+        return self.hostname.split(";")[0]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..d898de859fc444814bc19a7f8f0caaaec6f7e5f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/charm.py
@@ -0,0 +1,575 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """A base class for events that trigger because of a Juju hook firing."""
+
+
+class ActionEvent(EventBase):
+    """A base class for events that trigger when a user asks for an Action to be run.
+
+    To read the parameters for the action, see the instance variable `params`.
+    To respond with the result of the action, call `set_results`. To add progress
+    messages that are visible as the action is progressing use `log`.
+
+    :ivar params: The parameters passed to the action (read by action-get)
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the user is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by Charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Represents the `install` hook from Juju."""
+
+
+class StartEvent(HookEvent):
+    """Represents the `start` hook from Juju."""
+
+
+class StopEvent(HookEvent):
+    """Represents the `stop` hook from Juju."""
+
+
+class RemoveEvent(HookEvent):
+    """Represents the `remove` hook from Juju. """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Represents the `config-changed` hook from Juju."""
+
+
+class UpdateStatusEvent(HookEvent):
+    """Represents the `update-status` hook from Juju."""
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Represents the `upgrade-charm` hook from Juju.
+
+    This will be triggered when a user has run `juju upgrade-charm`. It is run after Juju
+    has unpacked the upgraded charm code, and so this event will be handled with new code.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Represents the `pre-series-upgrade` hook from Juju.
+
+    This happens when a user has run `juju upgrade-series MACHINE prepare` and
+    will fire for each unit that is running on the machine, telling them that
+    the user is preparing to upgrade the Machine's series (eg trusty->bionic).
+    The charm should take actions to prepare for the upgrade (a database charm
+    would want to write out a version-independent dump of the database, so that
+    when a new version of the database is available in a new series, it can be
+    used.)
+    Once all units on a machine have run `pre-series-upgrade`, the user will
+    initiate the steps to actually upgrade the machine (eg `do-release-upgrade`).
+    When the upgrade has been completed, the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Represents the `post-series-upgrade` hook from Juju.
+
+    This is run after the user has done a distribution upgrade (or rolled back
+    and kept the same series). It is called in response to
+    `juju upgrade-series MACHINE complete`. Charms are expected to do whatever
+    steps are necessary to reconfigure their applications for the new series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Represents the `leader-elected` hook from Juju.
+
+    Juju will trigger this when a new lead unit is chosen for a given application.
+    This represents the leader of the charm information (not necessarily the primary
+    of a running application). The main utility is that charm authors can know
+    that only one unit will be a leader at any given time, so they can do
+    configuration, etc, that would otherwise require coordination between units.
+    (eg, selecting a password for a new relation)
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Represents the `leader-settings-changed` hook from Juju.
+
+    Deprecated. This represents when a lead unit would call `leader-set` to inform
+    the other units of an application that they have new information to handle.
+    This has been deprecated in favor of using a Peer relation, and having the
+    leader set a value in the Application data bag for that peer relation.
+    (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Represents the `collect-metrics` hook from Juju.
+
+    Note that events firing during a CollectMetricsEvent are currently
+    sandboxed in how they can interact with Juju. To report metrics
+    use :meth:`.add_metrics`.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Charmers should not be creating RelationEvents directly. The events will be
+    generated by the framework from Juju related events. Users can observe them
+    from the various `CharmBase.on[relation_name].relation_*` events.
+
+    Attributes:
+        relation: The Relation involved in this event
+        app: The remote application that has triggered this event
+        unit: The remote unit that has triggered this event. This may be None
+              if the relation event was triggered as an Application level event
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by Charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by Charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Represents the `relation-created` hook from Juju.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Represents the `relation-joined` hook from Juju.
+
+    This is triggered whenever a new unit of a related application joins the relation.
+    (eg, a unit was added to an existing related app, or a new relation was established
+    with an application that already had units.)
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Represents the `relation-changed` hook from Juju.
+
+    This is triggered whenever there is a change to the data bucket for a related
+    application or unit. Look at `event.relation.data[event.unit/app]` to see the
+    new information.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Represents the `relation-departed` hook from Juju.
+
+    This is the inverse of the RelationJoinedEvent, representing when a unit
+    is leaving the relation (the unit is being removed, the app is being removed,
+    the relation is being removed). It is fired once for each unit that is
+    going away.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Represents the `relation-broken` hook from Juju.
+
+    If a relation is being removed (`juju remove-relation` or `juju remove-application`),
+    once all the units have been removed, RelationBrokenEvent will fire to signal
+    that the relationship has been fully terminated.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing Storage related events."""
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Represents the `storage-attached` hook from Juju.
+
+    Called when new storage is available for the charm to use.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Represents the `storage-detaching` hook from Juju.
+
+    Called when storage a charm has been using is going away.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """The events that are generated by Juju in response to the lifecycle of an application."""
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the Charm overall.
+
+    Usually this initialization is done by ops.main.main() rather than Charm authors
+    directly instantiating a Charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            Charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+    """
+
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """CharmMeta of this charm.
+        """
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the Charm as it is running.
+        """
+        return self.framework.charm_dir
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from metadata.yaml and/or actions.yaml. Generally charms will
+    define this information, rather than reading it at runtime. This class is
+    mostly for the framework to understand what the charm has defined.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by Charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/framework.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..b7c4749ff2b5bfb4f354bf1a8d4cd6ed64cf0da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/framework.py
@@ -0,0 +1,1067 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(ObjectEvents):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+        # breakpoint(); if Python < 3.7, this doesn't affect anything
+        sys.breakpointhook = self.breakpoint
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse once the env var, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/jujuversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..b2b8177dbe396f0d8c46b86e26af6b4e54ea046d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/jujuversion.py
@@ -0,0 +1,98 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if not v:
+            raise RuntimeError('environ has no JUJU_VERSION')
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edb9fcacea6f0173aed9f07ca8a683cfead989cc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/lib/__init__.py
@@ -0,0 +1,194 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import os
+import re
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except OSError:
+            continue
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except OSError:
+                continue
+            finder = get_importer(opslib)
+            if finder is None or not hasattr(finder, 'find_spec'):
+                continue
+            for lib_dir in lib_dirs:
+                spec = finder.find_spec(lib_dir)
+                if spec is None:
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    continue
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        return None
+
+    _expected = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_expected):
+                    break
+                if n > _MAX_LIB_LINES:
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _expected:
+                    value = literal_eval(value)
+                    if not isinstance(value, _expected[key]):
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_expected):
+                    return None
+    except Exception:
+        return None
+
+    return _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {0.name} by {0.author}, API {0.api}, patch {0.patch}>".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/log.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aac5543aec4d84dc393e79b772a30284712d6d4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/log.py
@@ -0,0 +1,51 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..6dc31c3575044796e8fe1f61b8415395689d6339
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/main.py
@@ -0,0 +1,348 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import logging
+import os
+import subprocess
+import sys
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows.
+        # For Windows it is always an absolute path (any symlinks are resolved)
+        # while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(sys.argv[0])
+
+        if 'JUJU_DISPATCH_PATH' in os.environ and (charm_dir / 'dispatch').exists():
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk"""
+
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = self._charm_dir / self._dispatch_path
+        if not dispatch_path.exists():
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == self._exec_path.resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning(
+                "Legacy %s exited with status %d.",
+                self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """"Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def main(charm_class, use_juju_for_storage=False):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96e89154ea9cec2b62a4fab4649412e115c304e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/model.py
@@ -0,0 +1,1237 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+
+    Attributes:
+        unit: A :class:`Unit` that represents the unit that is running this code (eg yourself)
+        app: A :class:`Application` that represents the application this unit is a part of.
+        relations: Mapping of endpoint to list of :class:`Relation` answering the question
+            "what am I currently related to". See also :meth:`.get_relation`
+        config: A dict of the config for the current application.
+        resources: Access to resources for this charm. Use ``model.resources.fetch(resource_name)``
+            to get the path on disk where the resource can be found.
+        storages: Mapping of storage_name to :class:`Storage` for the storage points defined in
+            metadata.yaml
+        pod: Used to get access to ``model.pod.set_spec`` to set the container specification
+            for Kubernetes charms.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(self._backend.unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworKInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info['bind-addresses']:
+            interface_name = interface_info['interface-name']
+            for address_info in interface_info['addresses']:
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info['ingress-addresses']:
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info['egress-subnets']:
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        return self.interfaces[0].address
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        return self.ingress_addresses[0]
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        self.address = ipaddress.ip_address(address_info['value'])
+        cidr = address_info['cidr']
+        if not cidr:
+            # The cidr field may be empty, see LP: #1864102.
+            # In this case, make it a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address_info['value'])
+        else:
+            self.subnet = ipaddress.ip_network(cidr)
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """"Represents a storage as defined in metadata.yaml
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            app: A boolean indicating whether the status should be set for a unit or an
+                application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/storage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/storage.py
new file mode 100755
index 0000000000000000000000000000000000000000..d4310ce1cfbb707c6278b70f84a9751da3ce07af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/storage.py
@@ -0,0 +1,318 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)"""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: typing.Optional[str]) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """"Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        return
+
+    def commit(self):
+        return
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str):
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    @staticmethod
+    def is_available() -> bool:
+        """Check if Juju state storage is available.
+
+        This checks if there is a 'state-get' executable in PATH.
+        """
+        p = shutil.which('state-get')
+        return p is not None
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf-8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        subprocess.run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = subprocess.run(
+            ["state-get", key],
+            stdout=subprocess.PIPE,
+            check=True,
+        )
+        if p.stdout == b'' or p.stdout == b'\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        subprocess.run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/testing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/testing.py
new file mode 100755
index 0000000000000000000000000000000000000000..b4b3fe071216238007c9f3847ca9556be626bf6b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/testing.py
@@ -0,0 +1,586 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pathlib
+from textwrap import dedent
+import tempfile
+import typing
+import yaml
+import weakref
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None):
+        # TODO: jam 2020-03-05 We probably want to take config as a parameter as well, since
+        #       it would define the default values of config that the charm would see.
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._lazy_resource_dir = None
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    @property
+    def _resource_dir(self) -> pathlib.Path:
+        if self._lazy_resource_dir is not None:
+            return self._lazy_resource_dir
+
+        self.__resource_dir = tempfile.TemporaryDirectory()
+        self._lazy_resource_dir = pathlib.Path(self.__resource_dir.name)
+        self._finalizer = weakref.finalize(self, self.__resource_dir.cleanup)
+        return self._lazy_resource_dir
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling begin(), there is no Charm instance, so changes to the Model won't emit
+        events. You must call begin before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+        resource_dir = self._resource_dir / resource_name
+        resource_dir.mkdir(exist_ok=True)
+        resource_file = resource_dir / "contents.yaml"
+        with resource_file.open('wt', encoding='utf8') as resource_yaml:
+            yaml.dump(contents, resource_yaml)
+        self._backend._resources_map[resource_name] = resource_file
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return rel_id
+        relation = self._model.get_relation(relation_name, rel_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+        return rel_id
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event and a `relation_changed` event.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        return self._resources_map[resource_name]
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..15e5478555ee0fa948bfb0ad57cc79ba7cef3721
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/lib/ops/version.py
@@ -0,0 +1,50 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from pathlib import Path
+
+__all__ = ('version',)
+
+_FALLBACK = '0.8'  # this gets bumped after release
+
+
+def _get_version():
+    version = _FALLBACK + ".dev0+unknown"
+
+    p = Path(__file__).parent
+    if (p.parent / '.git').exists():
+        try:
+            proc = subprocess.run(
+                ['git', 'describe', '--tags', '--dirty'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.DEVNULL,
+                cwd=p,
+                check=True)
+        except Exception:
+            pass
+        else:
+            version = proc.stdout.strip().decode('utf8')
+            if '-' in version:
+                # version will look like <tag>-<#commits>-g<hex>[-dirty]
+                # in terms of PEP 440, the tag we'll make sure is a 'public version identifier';
+                # everything after the first - needs to be a 'local version'
+                public, local = version.split('-', 1)
+                version = public + '+' + local.replace('-', '.')
+                # version now <tag>+<#commits>.g<hex>[.dirty]
+                # which is PEP440-compliant (as long as <tag> is :-)
+    return version
+
+
+version = _get_version()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/metadata.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c331b60d88dcfc3f1c675e24282dacdf8ec4ffdb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/metadata.yaml
@@ -0,0 +1,11 @@
+name: vyos-config
+summary: A proxy charm to configure VyOS Router
+maintainer: David García <david.garcia@canonical.com>
+description: |
+  Charm to configure VyOS PNF
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/add-port-forward.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/add-port-forward.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5d48d75870345d86b3aaa2ae06204bffe2dfe00e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/add-port-forward.yaml
@@ -0,0 +1,13 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_config:
+        lines:
+          - nat destination rule {{ ruleNumber }} destination port "{{ sourcePort }}"
+          - nat destination rule {{ ruleNumber }} inbound-interface "eth0"
+          - nat destination rule {{ ruleNumber }} protocol "tcp"
+          - nat destination rule {{ ruleNumber }} translation port    "{{ destinationPort }}"
+          - nat destination rule {{ ruleNumber }} translation address "{{ destinationAddress }}"
+        save: yes
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/backup.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/backup.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c83de0831c8271bdd5477e6fd3c012d204df7ac1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/backup.yaml
@@ -0,0 +1,9 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_config:
+        backup: yes
+        backup_options:
+          filename: "{{ backupFile }}"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/remove-port-forward.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/remove-port-forward.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..61c12f955f95d172f2da52a7049329470071bf3c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/playbooks/remove-port-forward.yaml
@@ -0,0 +1,11 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_command:
+        commands:
+          - config
+          - delete nat destination rule {{ ruleNumber }}
+          - commit
+          - save
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/src/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..6f97799ce1827c2da22ea51cd6453564bf83321c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config-src/src/charm.py
@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+import os
+import subprocess
+import sys
+import traceback
+
+from charms.osm import libansible
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+
+
+sys.path.append("lib")
+
+
+class VyosCharm(SSHProxyCharm):
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Register all of the events we want to observe
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+        self.framework.observe(self.on.upgrade_charm, self.on_upgrade_charm)
+        # Charm actions (primitives)
+        self.framework.observe(
+            self.on.add_port_forward_action, self.on_add_port_forward_action
+        )
+        self.framework.observe(
+            self.on.remove_port_forward_action, self.on_remove_port_forward_action
+        )
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+        self.unit.status = MaintenanceStatus("Installing Ansible")
+        libansible.install_ansible_support()
+        self.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_add_port_forward_action(self, event):
+        """Adds a port forward rule."""
+        self._run_playbook(
+            event,
+            "add-port-forward.yaml",
+            {
+                "sourcePort": event.params["sourcePort"],
+                "destinationPort": event.params["destinationPort"],
+                "destinationAddress": event.params["destinationAddress"],
+                "ruleNumber": event.params["ruleNumber"],
+            })
+
+    def on_remove_port_forward_action(self, event):
+        """Remove a port forward rule."""
+        self._run_playbook(
+            event,
+            "remove-port-forward.yaml",
+            {
+                "ruleNumber": event.params["ruleNumber"],
+            })
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+
+    def _run_playbook(self, event, playbook, variables):
+        try:
+            config = self.model.config
+            result = libansible.execute_playbook(
+                playbook,
+                config["ssh-hostname"],
+                config["ssh-username"],
+                config["ssh-password"],
+                variables,
+            )
+            event.set_results({"output": result})
+        except:
+            exc_type, exc_value, exc_traceback = sys.exc_info()
+            err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+            event.fail(message="Playbook " + playbook + " failed: " + str(err))
+
+
+if __name__ == "__main__":
+    main(VyosCharm)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/README.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2bdcab20c1a6d39aaffe9a450ba3bdbc44044b42
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/README.md
@@ -0,0 +1,3 @@
+# Vyos-config
+
+This is a proxy charm used by Open Source Mano (OSM) to configure Vyos Router PNF, written in the [Python Operator Framwork](https://github.com/canonical/operator)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/actions.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..80497e105a10016e2dec0329f6157dbad382a298
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/actions.yaml
@@ -0,0 +1,46 @@
+# VyOS Action
+add-port-forward:
+  description: "Adds a port forwarding rule"
+  params:
+    ruleNumber:
+        description: "Rule number, must be unique and needed to remove the rule later"
+        type: "string"
+        default: "10"
+    sourcePort:
+        description: "Source port to listen on"
+        type: "string"
+    destinationPort:
+        description: "Target port number on remote host to forward"
+        type: "string"
+    destinationAddress:
+        description: "Target host or IP address to forward traffic"
+        type: "string"
+  required:
+    - sourcePort
+    - destinationPort
+    - destinationAddress
+
+remove-port-forward:
+  description: "Removes a port forwarding rule by number"
+  params:
+    ruleNumber:
+        description: "Rule number to remove"
+        type: "string"
+        default: "10"
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/config.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7f6d4408bec64af0b5c3ebf0e8cae30b33609f74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/config.yaml
@@ -0,0 +1,25 @@
+options:
+    ssh-hostname:
+        type: string
+        default: ""
+        description: "The hostname or IP address of the machine to"
+    ssh-username:
+        type: string
+        default: ""
+        description: "The username to login as."
+    ssh-password:
+        type: string
+        default: ""
+        description: "The password used to authenticate."
+    ssh-public-key:
+        type: string
+        default: ""
+        description: "The public key of this unit."
+    ssh-key-type:
+        type: string
+        default: "rsa"
+        description: "The type of encryption to use for the SSH key."
+    ssh-key-bits:
+        type: int
+        default: 4096
+        description: "The number of bits to use for the SSH key."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/dispatch b/SOL004/hackfest_firewall_pnf/charms/vyos-config/dispatch
new file mode 100755
index 0000000000000000000000000000000000000000..fe31c0567bdce62a6542a6470997cb6a874e4bd8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/dispatch
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+JUJU_DISPATCH_PATH="${JUJU_DISPATCH_PATH:-$0}" PYTHONPATH=lib:venv ./src/charm.py
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/install b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/install
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/start b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/start
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/upgrade-charm b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/hooks/upgrade-charm
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61ef90719b5d5d759de1a6b80a1ea748d8bb0911
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/__init__.py
@@ -0,0 +1,97 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Bootstrap charm-helpers, installing its dependencies if necessary using
+# only standard libraries.
+from __future__ import print_function
+from __future__ import absolute_import
+
+import functools
+import inspect
+import subprocess
+import sys
+
+try:
+    import six  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-six'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-six'])
+    import six  # NOQA:F401
+
+try:
+    import yaml  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-yaml'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-yaml'])
+    import yaml  # NOQA:F401
+
+
+# Holds a list of mapping of mangled function names that have been deprecated
+# using the @deprecate decorator below.  This is so that the warning is only
+# printed once for each usage of the function.
+__deprecated_functions = {}
+
+
+def deprecate(warning, date=None, log=None):
+    """Add a deprecation warning the first time the function is used.
+    The date, which is a string in semi-ISO8660 format indicate the year-month
+    that the function is officially going to be removed.
+
+    usage:
+
+    @deprecate('use core/fetch/add_source() instead', '2017-04')
+    def contributed_add_source_thing(...):
+        ...
+
+    And it then prints to the log ONCE that the function is deprecated.
+    The reason for passing the logging function (log) is so that hookenv.log
+    can be used for a charm if needed.
+
+    :param warning:  String to indicat where it has moved ot.
+    :param date: optional sting, in YYYY-MM format to indicate when the
+                 function will definitely (probably) be removed.
+    :param log: The log function to call to log.  If not, logs to stdout
+    """
+    def wrap(f):
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            try:
+                module = inspect.getmodule(f)
+                file = inspect.getsourcefile(f)
+                lines = inspect.getsourcelines(f)
+                f_name = "{}-{}-{}..{}-{}".format(
+                    module.__name__, file, lines[0], lines[-1], f.__name__)
+            except (IOError, TypeError):
+                # assume it was local, so just use the name of the function
+                f_name = f.__name__
+            if f_name not in __deprecated_functions:
+                __deprecated_functions[f_name] = True
+                s = "DEPRECATION WARNING: Function {} is being removed".format(
+                    f.__name__)
+                if date:
+                    s = "{} on/around {}".format(s, date)
+                if warning:
+                    s = "{} : {}".format(s, warning)
+                if log:
+                    log(s)
+                else:
+                    print(s)
+            return f(*args, **kwargs)
+        return wrapped_f
+    return wrap
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/README.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..f7901c09c79c268d353825776a74072a7ee4dee7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/README.rst
@@ -0,0 +1,57 @@
+==========
+Commandant
+==========
+
+-----------------------------------------------------
+Automatic command-line interfaces to Python functions
+-----------------------------------------------------
+
+One of the benefits of ``libvirt`` is the uniformity of the interface: the C  API (as well as the bindings in other languages) is a set of functions that accept parameters that are nearly identical to the command-line arguments.  If you run ``virsh``, you get an interactive command prompt that supports all of the same commands that your shell scripts use as ``virsh`` subcommands.
+
+Command execution and stdio manipulation is the greatest common factor across all development systems in the POSIX environment.  By exposing your functions as commands that manipulate streams of text, you can make life easier for all the Ruby and Erlang and Go programmers in your life.
+
+Goals
+=====
+
+* Single decorator to expose a function as a command.
+  * now two decorators - one "automatic" and one that allows authors to manipulate the arguments for fine-grained control.(MW)
+* Automatic analysis of function signature through ``inspect.getargspec()``
+* Command argument parser built automatically with ``argparse``
+* Interactive interpreter loop object made with ``Cmd``
+* Options to output structured return value data via ``pprint``, ``yaml`` or ``json`` dumps.
+
+Other Important Features that need writing
+------------------------------------------
+
+* Help and Usage documentation can be automatically generated, but it will be important to let users override this behaviour
+* The decorator should allow specifying further parameters to the parser's add_argument() calls, to specify types or to make arguments behave as boolean flags, etc.
+    - Filename arguments are important, as good practice is for functions to accept file objects as parameters.
+    - choices arguments help to limit bad input before the function is called
+* Some automatic behaviour could make for better defaults, once the user can override them.
+    - We could automatically detect arguments that default to False or True, and automatically support --no-foo for foo=True.
+    - We could automatically support hyphens as alternates for underscores
+    - Arguments defaulting to sequence types could support the ``append`` action.
+
+
+-----------------------------------------------------
+Implementing subcommands
+-----------------------------------------------------
+
+(WIP)
+
+So as to avoid dependencies on the cli module, subcommands should be defined separately from their implementations. The recommmendation would be to place definitions into separate modules near the implementations which they expose.
+
+Some examples::
+
+    from charmhelpers.cli import CommandLine
+    from charmhelpers.payload import execd
+    from charmhelpers.foo import bar
+
+    cli = CommandLine()
+
+    cli.subcommand(execd.execd_run)
+
+    @cli.subcommand_builder("bar", help="Bar baz qux")
+    def barcmd_builder(subparser):
+        subparser.add_argument('argument1', help="yackety")
+        return bar
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..389b490f4eec27f18118ab6a5f3f529dbf2e9ecc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/__init__.py
@@ -0,0 +1,189 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import argparse
+import sys
+
+from six.moves import zip
+
+import charmhelpers.core.unitdata
+
+
+class OutputFormatter(object):
+    def __init__(self, outfile=sys.stdout):
+        self.formats = (
+            "raw",
+            "json",
+            "py",
+            "yaml",
+            "csv",
+            "tab",
+        )
+        self.outfile = outfile
+
+    def add_arguments(self, argument_parser):
+        formatgroup = argument_parser.add_mutually_exclusive_group()
+        choices = self.supported_formats
+        formatgroup.add_argument("--format", metavar='FMT',
+                                 help="Select output format for returned data, "
+                                      "where FMT is one of: {}".format(choices),
+                                 choices=choices, default='raw')
+        for fmt in self.formats:
+            fmtfunc = getattr(self, fmt)
+            formatgroup.add_argument("-{}".format(fmt[0]),
+                                     "--{}".format(fmt), action='store_const',
+                                     const=fmt, dest='format',
+                                     help=fmtfunc.__doc__)
+
+    @property
+    def supported_formats(self):
+        return self.formats
+
+    def raw(self, output):
+        """Output data as raw string (default)"""
+        if isinstance(output, (list, tuple)):
+            output = '\n'.join(map(str, output))
+        self.outfile.write(str(output))
+
+    def py(self, output):
+        """Output data as a nicely-formatted python data structure"""
+        import pprint
+        pprint.pprint(output, stream=self.outfile)
+
+    def json(self, output):
+        """Output data in JSON format"""
+        import json
+        json.dump(output, self.outfile)
+
+    def yaml(self, output):
+        """Output data in YAML format"""
+        import yaml
+        yaml.safe_dump(output, self.outfile)
+
+    def csv(self, output):
+        """Output data as excel-compatible CSV"""
+        import csv
+        csvwriter = csv.writer(self.outfile)
+        csvwriter.writerows(output)
+
+    def tab(self, output):
+        """Output data in excel-compatible tab-delimited format"""
+        import csv
+        csvwriter = csv.writer(self.outfile, dialect=csv.excel_tab)
+        csvwriter.writerows(output)
+
+    def format_output(self, output, fmt='raw'):
+        fmtfunc = getattr(self, fmt)
+        fmtfunc(output)
+
+
+class CommandLine(object):
+    argument_parser = None
+    subparsers = None
+    formatter = None
+    exit_code = 0
+
+    def __init__(self):
+        if not self.argument_parser:
+            self.argument_parser = argparse.ArgumentParser(description='Perform common charm tasks')
+        if not self.formatter:
+            self.formatter = OutputFormatter()
+            self.formatter.add_arguments(self.argument_parser)
+        if not self.subparsers:
+            self.subparsers = self.argument_parser.add_subparsers(help='Commands')
+
+    def subcommand(self, command_name=None):
+        """
+        Decorate a function as a subcommand. Use its arguments as the
+        command-line arguments"""
+        def wrapper(decorated):
+            cmd_name = command_name or decorated.__name__
+            subparser = self.subparsers.add_parser(cmd_name,
+                                                   description=decorated.__doc__)
+            for args, kwargs in describe_arguments(decorated):
+                subparser.add_argument(*args, **kwargs)
+            subparser.set_defaults(func=decorated)
+            return decorated
+        return wrapper
+
+    def test_command(self, decorated):
+        """
+        Subcommand is a boolean test function, so bool return values should be
+        converted to a 0/1 exit code.
+        """
+        decorated._cli_test_command = True
+        return decorated
+
+    def no_output(self, decorated):
+        """
+        Subcommand is not expected to return a value, so don't print a spurious None.
+        """
+        decorated._cli_no_output = True
+        return decorated
+
+    def subcommand_builder(self, command_name, description=None):
+        """
+        Decorate a function that builds a subcommand. Builders should accept a
+        single argument (the subparser instance) and return the function to be
+        run as the command."""
+        def wrapper(decorated):
+            subparser = self.subparsers.add_parser(command_name)
+            func = decorated(subparser)
+            subparser.set_defaults(func=func)
+            subparser.description = description or func.__doc__
+        return wrapper
+
+    def run(self):
+        "Run cli, processing arguments and executing subcommands."
+        arguments = self.argument_parser.parse_args()
+        argspec = inspect.getargspec(arguments.func)
+        vargs = []
+        for arg in argspec.args:
+            vargs.append(getattr(arguments, arg))
+        if argspec.varargs:
+            vargs.extend(getattr(arguments, argspec.varargs))
+        output = arguments.func(*vargs)
+        if getattr(arguments.func, '_cli_test_command', False):
+            self.exit_code = 0 if output else 1
+            output = ''
+        if getattr(arguments.func, '_cli_no_output', False):
+            output = ''
+        self.formatter.format_output(output, arguments.format)
+        if charmhelpers.core.unitdata._KV:
+            charmhelpers.core.unitdata._KV.flush()
+
+
+cmdline = CommandLine()
+
+
+def describe_arguments(func):
+    """
+    Analyze a function's signature and return a data structure suitable for
+    passing in as arguments to an argparse parser's add_argument() method."""
+
+    argspec = inspect.getargspec(func)
+    # we should probably raise an exception somewhere if func includes **kwargs
+    if argspec.defaults:
+        positional_args = argspec.args[:-len(argspec.defaults)]
+        keyword_names = argspec.args[-len(argspec.defaults):]
+        for arg, default in zip(keyword_names, argspec.defaults):
+            yield ('--{}'.format(arg),), {'default': default}
+    else:
+        positional_args = argspec.args
+
+    for arg in positional_args:
+        yield (arg,), {}
+    if argspec.varargs:
+        yield (argspec.varargs,), {'nargs': '*'}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/benchmark.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/benchmark.py
new file mode 100644
index 0000000000000000000000000000000000000000..303af14b607d31e338aefff0df593609b7b45feb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/benchmark.py
@@ -0,0 +1,34 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.contrib.benchmark import Benchmark
+
+
+@cmdline.subcommand(command_name='benchmark-start')
+def start():
+    Benchmark.start()
+
+
+@cmdline.subcommand(command_name='benchmark-finish')
+def finish():
+    Benchmark.finish()
+
+
+@cmdline.subcommand_builder('benchmark-composite', description="Set the benchmark composite score")
+def service(subparser):
+    subparser.add_argument("value", help="The composite score.")
+    subparser.add_argument("units", help="The units the composite score represents, i.e., 'reads/sec'.")
+    subparser.add_argument("direction", help="'asc' if a lower score is better, 'desc' if a higher score is better.")
+    return Benchmark.set_composite_score
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/commands.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/commands.py
new file mode 100644
index 0000000000000000000000000000000000000000..b93105650be8226aa390fda46aa08afb23ebc7bc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/commands.py
@@ -0,0 +1,30 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module loads sub-modules into the python runtime so they can be
+discovered via the inspect module. In order to prevent flake8 from (rightfully)
+telling us these are unused modules, throw a ' # noqa' at the end of each import
+so that the warning is suppressed.
+"""
+
+from . import CommandLine  # noqa
+
+"""
+Import the sub-modules which have decorated subcommands to register with chlp.
+"""
+from . import host  # noqa
+from . import benchmark  # noqa
+from . import unitdata  # noqa
+from . import hookenv  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd72f448bf0092251a454ff6dd3145f09048ae72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/hookenv.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import hookenv
+
+
+cmdline.subcommand('relation-id')(hookenv.relation_id._wrapped)
+cmdline.subcommand('service-name')(hookenv.service_name)
+cmdline.subcommand('remote-service-name')(hookenv.remote_service_name._wrapped)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..40396849907976fd077cc9c53a0852c4380c6266
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/host.py
@@ -0,0 +1,29 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import host
+
+
+@cmdline.subcommand()
+def mounts():
+    "List mounts"
+    return host.mounts()
+
+
+@cmdline.subcommand_builder('service', description="Control system services")
+def service(subparser):
+    subparser.add_argument("action", help="The action to perform (start, stop, etc...)")
+    subparser.add_argument("service_name", help="Name of the service to control")
+    return host.service
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..acce846f84ef32ed0b5829cf08e67ad33f0eb5d1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/cli/unitdata.py
@@ -0,0 +1,46 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import unitdata
+
+
+@cmdline.subcommand_builder('unitdata', description="Store and retrieve data")
+def unitdata_cmd(subparser):
+    nested = subparser.add_subparsers()
+
+    get_cmd = nested.add_parser('get', help='Retrieve data')
+    get_cmd.add_argument('key', help='Key to retrieve the value of')
+    get_cmd.set_defaults(action='get', value=None)
+
+    getrange_cmd = nested.add_parser('getrange', help='Retrieve multiple data')
+    getrange_cmd.add_argument('key', metavar='prefix',
+                              help='Prefix of the keys to retrieve')
+    getrange_cmd.set_defaults(action='getrange', value=None)
+
+    set_cmd = nested.add_parser('set', help='Store data')
+    set_cmd.add_argument('key', help='Key to set')
+    set_cmd.add_argument('value', help='Value to store')
+    set_cmd.set_defaults(action='set')
+
+    def _unitdata_cmd(action, key, value):
+        if action == 'get':
+            return unitdata.kv().get(key)
+        elif action == 'getrange':
+            return unitdata.kv().getrange(key)
+        elif action == 'set':
+            unitdata.kv().set(key, value)
+            unitdata.kv().flush()
+            return ''
+    return _unitdata_cmd
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..01864740e89633f6c65f43c32ed89ef9d5e857c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/context.py
@@ -0,0 +1,205 @@
+# Copyright 2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+A Pythonic API to interact with the charm hook environment.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+'''
+
+import six
+
+from charmhelpers.core import hookenv
+
+from collections import OrderedDict
+if six.PY3:
+    from collections import UserDict  # pragma: nocover
+else:
+    from UserDict import IterableUserDict as UserDict  # pragma: nocover
+
+
+class Relations(OrderedDict):
+    '''Mapping relation name -> relation id -> Relation.
+
+    >>> rels = Relations()
+    >>> rels['sprog']['sprog:12']['client/6']['widget']
+    'remote widget'
+    >>> rels['sprog']['sprog:12'].local['widget'] = 'local widget'
+    >>> rels['sprog']['sprog:12'].local['widget']
+    'local widget'
+    >>> rels.peer.local['widget']
+    'local widget on the peer relation'
+    '''
+    def __init__(self):
+        super(Relations, self).__init__()
+        for relname in sorted(hookenv.relation_types()):
+            self[relname] = OrderedDict()
+            relids = hookenv.relation_ids(relname)
+            relids.sort(key=lambda x: int(x.split(':', 1)[-1]))
+            for relid in relids:
+                self[relname][relid] = Relation(relid)
+
+    @property
+    def peer(self):
+        peer_relid = hookenv.peer_relation_id()
+        for rels in self.values():
+            if peer_relid in rels:
+                return rels[peer_relid]
+
+
+class Relation(OrderedDict):
+    '''Mapping of unit -> remote RelationInfo for a relation.
+
+    This is an OrderedDict mapping, ordered numerically by
+    by unit number.
+
+    Also provides access to the local RelationInfo, and peer RelationInfo
+    instances by the 'local' and 'peers' attributes.
+
+    >>> r = Relation('sprog:12')
+    >>> r.keys()
+    ['client/9', 'client/10']     # Ordered numerically
+    >>> r['client/10']['widget']  # A remote RelationInfo setting
+    'remote widget'
+    >>> r.local['widget']         # The local RelationInfo setting
+    'local widget'
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also known as relation type).
+    service = None  # The remote service name, if known.
+    local = None    # The local end's RelationInfo.
+    peers = None    # Map of peer -> RelationInfo. None if no peer relation.
+
+    def __init__(self, relid):
+        remote_units = hookenv.related_units(relid)
+        remote_units.sort(key=lambda u: int(u.split('/', 1)[-1]))
+        super(Relation, self).__init__((unit, RelationInfo(relid, unit))
+                                       for unit in remote_units)
+
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.local = RelationInfo(relid, hookenv.local_unit())
+
+        for relinfo in self.values():
+            self.service = relinfo.service
+            break
+
+        # If we have peers, and they have joined both the provided peer
+        # relation and this relation, we can peek at their data too.
+        # This is useful for creating consensus without leadership.
+        peer_relid = hookenv.peer_relation_id()
+        if peer_relid and peer_relid != relid:
+            peers = hookenv.related_units(peer_relid)
+            if peers:
+                peers.sort(key=lambda u: int(u.split('/', 1)[-1]))
+                self.peers = OrderedDict((peer, RelationInfo(relid, peer))
+                                         for peer in peers)
+            else:
+                self.peers = OrderedDict()
+        else:
+            self.peers = None
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.service)
+
+
+class RelationInfo(UserDict):
+    '''The bag of data at an end of a relation.
+
+    Every unit participating in a relation has a single bag of
+    data associated with that relation. This is that bag.
+
+    The bag of data for the local unit may be updated. Remote data
+    is immutable and will remain static for the duration of the hook.
+
+    Changes made to the local units relation data only become visible
+    to other units after the hook completes successfully. If the hook
+    does not complete successfully, the changes are rolled back.
+
+    Unlike standard Python mappings, setting an item to None is the
+    same as deleting it.
+
+    >>> relinfo = RelationInfo('db:12')  # Default is the local unit.
+    >>> relinfo['user'] = 'fred'
+    >>> relinfo['user']
+    'fred'
+    >>> relinfo['user'] = None
+    >>> 'fred' in relinfo
+    False
+
+    This class wraps hookenv.relation_get and hookenv.relation_set.
+    All caching is left up to these two methods to avoid synchronization
+    issues. Data is only loaded on demand.
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also know as the relation type).
+    unit = None     # The unit id.
+    number = None   # The unit number (integer).
+    service = None  # The service name.
+
+    def __init__(self, relid, unit):
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.unit = unit
+        self.service, num = self.unit.split('/', 1)
+        self.number = int(num)
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.unit)
+
+    @property
+    def data(self):
+        return hookenv.relation_get(rid=self.relid, unit=self.unit)
+
+    def __setitem__(self, key, value):
+        if self.unit != hookenv.local_unit():
+            raise TypeError('Attempting to set {} on remote unit {}'
+                            ''.format(key, self.unit))
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure relation-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.relation_set(self.relid, {key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju relations.
+        self[key] = None
+
+
+class Leader(UserDict):
+    def __init__(self):
+        pass  # Don't call superclass initializer, as it will nuke self.data
+
+    @property
+    def data(self):
+        return hookenv.leader_get()
+
+    def __setitem__(self, key, value):
+        if not hookenv.is_leader():
+            raise TypeError('Not the leader. Cannot change leader settings.')
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure leader-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.leader_set({key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju leadership settings.
+        self[key] = None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..d21d01d8ffe242d686283b0ed977b88be6bfc74e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/deployment.py
@@ -0,0 +1,99 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import os
+import six
+
+
+class AmuletDeployment(object):
+    """Amulet deployment.
+
+       This class provides generic Amulet deployment and test runner
+       methods.
+       """
+
+    def __init__(self, series=None):
+        """Initialize the deployment environment."""
+        self.series = None
+
+        if series:
+            self.series = series
+            self.d = amulet.Deployment(series=self.series)
+        else:
+            self.d = amulet.Deployment()
+
+    def _add_services(self, this_service, other_services):
+        """Add services.
+
+           Add services to the deployment where this_service is the local charm
+           that we're testing and other_services are the other services that
+           are being used in the local amulet tests.
+           """
+        if this_service['name'] != os.path.basename(os.getcwd()):
+            s = this_service['name']
+            msg = "The charm's root directory name needs to be {}".format(s)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        if 'units' not in this_service:
+            this_service['units'] = 1
+
+        self.d.add(this_service['name'], units=this_service['units'],
+                   constraints=this_service.get('constraints'),
+                   storage=this_service.get('storage'))
+
+        for svc in other_services:
+            if 'location' in svc:
+                branch_location = svc['location']
+            elif self.series:
+                branch_location = 'cs:{}/{}'.format(self.series, svc['name']),
+            else:
+                branch_location = None
+
+            if 'units' not in svc:
+                svc['units'] = 1
+
+            self.d.add(svc['name'], charm=branch_location, units=svc['units'],
+                       constraints=svc.get('constraints'),
+                       storage=svc.get('storage'))
+
+    def _add_relations(self, relations):
+        """Add all of the relations for the services."""
+        for k, v in six.iteritems(relations):
+            self.d.relate(k, v)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _deploy(self):
+        """Deploy environment and wait for all hooks to finish executing."""
+        timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 900))
+        try:
+            self.d.setup(timeout=timeout)
+            self.d.sentry.wait(timeout=timeout)
+        except amulet.helpers.TimeoutError:
+            amulet.raise_status(
+                amulet.FAIL,
+                msg="Deployment timed out ({}s)".format(timeout)
+            )
+        except Exception:
+            raise
+
+    def run_tests(self):
+        """Run all of the methods that are prefixed with 'test_'."""
+        for test in dir(self):
+            if test.startswith('test_'):
+                getattr(self, test)()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..54283088e1ddd53bc85008bc7446620e87b42278
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/amulet/utils.py
@@ -0,0 +1,820 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import json
+import logging
+import os
+import re
+import socket
+import subprocess
+import sys
+import time
+import uuid
+
+import amulet
+import distro_info
+import six
+from six.moves import configparser
+if six.PY3:
+    from urllib import parse as urlparse
+else:
+    import urlparse
+
+
+class AmuletUtils(object):
+    """Amulet utilities.
+
+       This class provides common utility functions that are used by Amulet
+       tests.
+       """
+
+    def __init__(self, log_level=logging.ERROR):
+        self.log = self.get_logger(level=log_level)
+        self.ubuntu_releases = self.get_ubuntu_releases()
+
+    def get_logger(self, name="amulet-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def valid_ip(self, ip):
+        if re.match(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$", ip):
+            return True
+        else:
+            return False
+
+    def valid_url(self, url):
+        p = re.compile(
+            r'^(?:http|ftp)s?://'
+            r'(?:(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+(?:[A-Z]{2,6}\.?|[A-Z0-9-]{2,}\.?)|'  # noqa
+            r'localhost|'
+            r'\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})'
+            r'(?::\d+)?'
+            r'(?:/?|[/?]\S+)$',
+            re.IGNORECASE)
+        if p.match(url):
+            return True
+        else:
+            return False
+
+    def get_ubuntu_release_from_sentry(self, sentry_unit):
+        """Get Ubuntu release codename from sentry unit.
+
+        :param sentry_unit: amulet sentry/service unit pointer
+        :returns: list of strings - release codename, failure message
+        """
+        msg = None
+        cmd = 'lsb_release -cs'
+        release, code = sentry_unit.ssh(cmd)
+        if code == 0:
+            self.log.debug('{} lsb_release: {}'.format(
+                sentry_unit.info['unit_name'], release))
+        else:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, release, code))
+        if release not in self.ubuntu_releases:
+            msg = ("Release ({}) not found in Ubuntu releases "
+                   "({})".format(release, self.ubuntu_releases))
+        return release, msg
+
+    def validate_services(self, commands):
+        """Validate that lists of commands succeed on service units.  Can be
+           used to verify system services are running on the corresponding
+           service units.
+
+        :param commands: dict with sentry keys and arbitrary command list vals
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # /!\ DEPRECATION WARNING (beisner):
+        # New and existing tests should be rewritten to use
+        # validate_services_by_name() as it is aware of init systems.
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_services_by_name instead of validate_services '
+                      'due to init system differences.')
+
+        for k, v in six.iteritems(commands):
+            for cmd in v:
+                output, code = k.run(cmd)
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(k.info['unit_name'],
+                                           cmd, code))
+                if code != 0:
+                    return "command `{}` returned {}".format(cmd, str(code))
+        return None
+
+    def validate_services_by_name(self, sentry_services):
+        """Validate system service status by service name, automatically
+           detecting init system based on Ubuntu release codename.
+
+        :param sentry_services: dict with sentry keys and svc list values
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # Point at which systemd became a thing
+        systemd_switch = self.ubuntu_releases.index('vivid')
+
+        for sentry_unit, services_list in six.iteritems(sentry_services):
+            # Get lsb_release codename from unit
+            release, ret = self.get_ubuntu_release_from_sentry(sentry_unit)
+            if ret:
+                return ret
+
+            for service_name in services_list:
+                if (self.ubuntu_releases.index(release) >= systemd_switch or
+                        service_name in ['rabbitmq-server', 'apache2',
+                                         'memcached']):
+                    # init is systemd (or regular sysv)
+                    cmd = 'sudo service {} status'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0
+                elif self.ubuntu_releases.index(release) < systemd_switch:
+                    # init is upstart
+                    cmd = 'sudo status {}'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0 and "start/running" in output
+
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(sentry_unit.info['unit_name'],
+                                           cmd, code))
+                if not service_running:
+                    return u"command `{}` returned {} {}".format(
+                        cmd, output, str(code))
+        return None
+
+    def _get_config(self, unit, filename):
+        """Get a ConfigParser object for parsing a unit's config file."""
+        file_contents = unit.file_contents(filename)
+
+        # NOTE(beisner):  by default, ConfigParser does not handle options
+        # with no value, such as the flags used in the mysql my.cnf file.
+        # https://bugs.python.org/issue7005
+        config = configparser.ConfigParser(allow_no_value=True)
+        config.readfp(io.StringIO(file_contents))
+        return config
+
+    def validate_config_data(self, sentry_unit, config_file, section,
+                             expected):
+        """Validate config file data.
+
+           Verify that the specified section of the config file contains
+           the expected option key:value pairs.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('Validating config file data ({} in {} on {})'
+                       '...'.format(section, config_file,
+                                    sentry_unit.info['unit_name']))
+        config = self._get_config(sentry_unit, config_file)
+
+        if section != 'DEFAULT' and not config.has_section(section):
+            return "section [{}] does not exist".format(section)
+
+        for k in expected.keys():
+            if not config.has_option(section, k):
+                return "section [{}] is missing option {}".format(section, k)
+
+            actual = config.get(section, k)
+            v = expected[k]
+            if (isinstance(v, six.string_types) or
+                    isinstance(v, bool) or
+                    isinstance(v, six.integer_types)):
+                # handle explicit values
+                if actual != v:
+                    return "section [{}] {}:{} != expected {}:{}".format(
+                           section, k, actual, k, expected[k])
+            # handle function pointers, such as not_null or valid_ip
+            elif not v(actual):
+                return "section [{}] {}:{} != expected {}:{}".format(
+                       section, k, actual, k, expected[k])
+        return None
+
+    def _validate_dict_data(self, expected, actual):
+        """Validate dictionary data.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('actual: {}'.format(repr(actual)))
+        self.log.debug('expected: {}'.format(repr(expected)))
+
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                if (isinstance(v, six.string_types) or
+                        isinstance(v, bool) or
+                        isinstance(v, six.integer_types)):
+                    # handle explicit values
+                    if v != actual[k]:
+                        return "{}:{}".format(k, actual[k])
+                # handle function pointers, such as not_null or valid_ip
+                elif not v(actual[k]):
+                    return "{}:{}".format(k, actual[k])
+            else:
+                return "key '{}' does not exist".format(k)
+        return None
+
+    def validate_relation_data(self, sentry_unit, relation, expected):
+        """Validate actual relation data based on expected relation data."""
+        actual = sentry_unit.relation(relation[0], relation[1])
+        return self._validate_dict_data(expected, actual)
+
+    def _validate_list_data(self, expected, actual):
+        """Compare expected list vs actual list data."""
+        for e in expected:
+            if e not in actual:
+                return "expected item {} not found in actual list".format(e)
+        return None
+
+    def not_null(self, string):
+        if string is not None:
+            return True
+        else:
+            return False
+
+    def _get_file_mtime(self, sentry_unit, filename):
+        """Get last modification time of file."""
+        return sentry_unit.file_stat(filename)['mtime']
+
+    def _get_dir_mtime(self, sentry_unit, directory):
+        """Get last modification time of directory."""
+        return sentry_unit.directory_stat(directory)['mtime']
+
+    def _get_proc_start_time(self, sentry_unit, service, pgrep_full=None):
+        """Get start time of a process based on the last modification time
+           of the /proc/pid directory.
+
+        :sentry_unit:  The sentry unit to check for the service on
+        :service:  service name to look for in process table
+        :pgrep_full:  [Deprecated] Use full command line search mode with pgrep
+        :returns:  epoch time of service process start
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns:  None if successful; Failure message otherwise
+        """
+        pid_list = self.get_process_id_list(
+            sentry_unit, service, pgrep_full=pgrep_full)
+        pid = pid_list[0]
+        proc_dir = '/proc/{}'.format(pid)
+        self.log.debug('Pid for {} on {}: {}'.format(
+            service, sentry_unit.info['unit_name'], pid))
+
+        return self._get_dir_mtime(sentry_unit, proc_dir)
+
+    def service_restarted(self, sentry_unit, service, filename,
+                          pgrep_full=None, sleep_time=20):
+        """Check if service was restarted.
+
+           Compare a service's start time vs a file's last modification time
+           (such as a config file for that service) to determine if the service
+           has been restarted.
+           """
+        # /!\ DEPRECATION WARNING (beisner):
+        # This method is prone to races in that no before-time is known.
+        # Use validate_service_config_changed instead.
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_service_config_changed instead of '
+                      'service_restarted due to known races.')
+
+        time.sleep(sleep_time)
+        if (self._get_proc_start_time(sentry_unit, service, pgrep_full) >=
+                self._get_file_mtime(sentry_unit, filename)):
+            return True
+        else:
+            return False
+
+    def service_restarted_since(self, sentry_unit, mtime, service,
+                                pgrep_full=None, sleep_time=20,
+                                retry_count=30, retry_sleep_time=10):
+        """Check if service was been started after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if service found and its start time it newer than mtime,
+                False if service is older than mtime or if service was
+                not found.
+        """
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s service restarted since %s on '
+                       '%s' % (service, mtime, unit_name))
+        time.sleep(sleep_time)
+        proc_start_time = None
+        tries = 0
+        while tries <= retry_count and not proc_start_time:
+            try:
+                proc_start_time = self._get_proc_start_time(sentry_unit,
+                                                            service,
+                                                            pgrep_full)
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'OK'.format(tries, service, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, proc may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'failed\n{}'.format(tries, service,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not proc_start_time:
+            self.log.warn('No proc start time found, assuming service did '
+                          'not start')
+            return False
+        if proc_start_time >= mtime:
+            self.log.debug('Proc start time is newer than provided mtime'
+                           '(%s >= %s) on %s (OK)' % (proc_start_time,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('Proc start time (%s) is older than provided mtime '
+                          '(%s) on %s, service did not '
+                          'restart' % (proc_start_time, mtime, unit_name))
+            return False
+
+    def config_updated_since(self, sentry_unit, filename, mtime,
+                             sleep_time=20, retry_count=30,
+                             retry_sleep_time=10):
+        """Check if file was modified after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check the file mtime on
+          filename (string): The file to check mtime of
+          mtime (float): The epoch time to check against
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if file was modified more recently than mtime, False if
+                file was modified before mtime, or if file not found.
+        """
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s updated since %s on '
+                       '%s' % (filename, mtime, unit_name))
+        time.sleep(sleep_time)
+        file_mtime = None
+        tries = 0
+        while tries <= retry_count and not file_mtime:
+            try:
+                file_mtime = self._get_file_mtime(sentry_unit, filename)
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'OK'.format(tries, filename, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, file may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'failed\n{}'.format(tries, filename,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not file_mtime:
+            self.log.warn('Could not determine file mtime, assuming '
+                          'file does not exist')
+            return False
+
+        if file_mtime >= mtime:
+            self.log.debug('File mtime is newer than provided mtime '
+                           '(%s >= %s) on %s (OK)' % (file_mtime,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('File mtime is older than provided mtime'
+                          '(%s < on %s) on %s' % (file_mtime,
+                                                  mtime, unit_name))
+            return False
+
+    def validate_service_config_changed(self, sentry_unit, mtime, service,
+                                        filename, pgrep_full=None,
+                                        sleep_time=20, retry_count=30,
+                                        retry_sleep_time=10):
+        """Check service and file were updated after mtime
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          filename (string): The file to check mtime of
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep in seconds to pass to test helpers
+          retry_count (int): If service is not found, how many times to retry
+          retry_sleep_time (int): Time in seconds to wait between retries
+
+        Typical Usage:
+            u = OpenStackAmuletUtils(ERROR)
+            ...
+            mtime = u.get_sentry_time(self.cinder_sentry)
+            self.d.configure('cinder', {'verbose': 'True', 'debug': 'True'})
+            if not u.validate_service_config_changed(self.cinder_sentry,
+                                                     mtime,
+                                                     'cinder-api',
+                                                     '/etc/cinder/cinder.conf')
+                amulet.raise_status(amulet.FAIL, msg='update failed')
+        Returns:
+          bool: True if both service and file where updated/restarted after
+                mtime, False if service is older than mtime or if service was
+                not found or if filename was modified before mtime.
+        """
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        service_restart = self.service_restarted_since(
+            sentry_unit, mtime,
+            service,
+            pgrep_full=pgrep_full,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        config_update = self.config_updated_since(
+            sentry_unit,
+            filename,
+            mtime,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        return service_restart and config_update
+
+    def get_sentry_time(self, sentry_unit):
+        """Return current epoch time on a sentry"""
+        cmd = "date +'%s'"
+        return float(sentry_unit.run(cmd)[0])
+
+    def relation_error(self, name, data):
+        return 'unexpected relation data in {} - {}'.format(name, data)
+
+    def endpoint_error(self, name, data):
+        return 'unexpected endpoint data in {} - {}'.format(name, data)
+
+    def get_ubuntu_releases(self):
+        """Return a list of all Ubuntu releases in order of release."""
+        _d = distro_info.UbuntuDistroInfo()
+        _release_list = _d.all
+        return _release_list
+
+    def file_to_url(self, file_rel_path):
+        """Convert a relative file path to a file URL."""
+        _abs_path = os.path.abspath(file_rel_path)
+        return urlparse.urlparse(_abs_path, scheme='file').geturl()
+
+    def check_commands_on_units(self, commands, sentry_units):
+        """Check that all commands in a list exit zero on all
+        sentry units in a list.
+
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns: None if successful; Failure message otherwise
+        """
+        self.log.debug('Checking exit codes for {} commands on {} '
+                       'sentry units...'.format(len(commands),
+                                                len(sentry_units)))
+        for sentry_unit in sentry_units:
+            for cmd in commands:
+                output, code = sentry_unit.run(cmd)
+                if code == 0:
+                    self.log.debug('{} `{}` returned {} '
+                                   '(OK)'.format(sentry_unit.info['unit_name'],
+                                                 cmd, code))
+                else:
+                    return ('{} `{}` returned {} '
+                            '{}'.format(sentry_unit.info['unit_name'],
+                                        cmd, code, output))
+        return None
+
+    def get_process_id_list(self, sentry_unit, process_name,
+                            expect_success=True, pgrep_full=False):
+        """Get a list of process ID(s) from a single sentry juju unit
+        for a single process name.
+
+        :param sentry_unit: Amulet sentry instance (juju unit)
+        :param process_name: Process name
+        :param expect_success: If False, expect the PID to be missing,
+            raise if it is present.
+        :returns: List of process IDs
+        """
+        if pgrep_full:
+            cmd = 'pgrep -f "{}"'.format(process_name)
+        else:
+            cmd = 'pidof -x "{}"'.format(process_name)
+        if not expect_success:
+            cmd += " || exit 0 && exit 1"
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output).split()
+
+    def get_unit_process_ids(
+            self, unit_processes, expect_success=True, pgrep_full=False):
+        """Construct a dict containing unit sentries, process names, and
+        process IDs.
+
+        :param unit_processes: A dictionary of Amulet sentry instance
+            to list of process names.
+        :param expect_success: if False expect the processes to not be
+            running, raise if they are.
+        :returns: Dictionary of Amulet sentry instance to dictionary
+            of process names to PIDs.
+        """
+        pid_dict = {}
+        for sentry_unit, process_list in six.iteritems(unit_processes):
+            pid_dict[sentry_unit] = {}
+            for process in process_list:
+                pids = self.get_process_id_list(
+                    sentry_unit, process, expect_success=expect_success,
+                    pgrep_full=pgrep_full)
+                pid_dict[sentry_unit].update({process: pids})
+        return pid_dict
+
+    def validate_unit_process_ids(self, expected, actual):
+        """Validate process id quantities for services on units."""
+        self.log.debug('Checking units for running processes...')
+        self.log.debug('Expected PIDs: {}'.format(expected))
+        self.log.debug('Actual PIDs: {}'.format(actual))
+
+        if len(actual) != len(expected):
+            return ('Unit count mismatch.  expected, actual: {}, '
+                    '{} '.format(len(expected), len(actual)))
+
+        for (e_sentry, e_proc_names) in six.iteritems(expected):
+            e_sentry_name = e_sentry.info['unit_name']
+            if e_sentry in actual.keys():
+                a_proc_names = actual[e_sentry]
+            else:
+                return ('Expected sentry ({}) not found in actual dict data.'
+                        '{}'.format(e_sentry_name, e_sentry))
+
+            if len(e_proc_names.keys()) != len(a_proc_names.keys()):
+                return ('Process name count mismatch.  expected, actual: {}, '
+                        '{}'.format(len(expected), len(actual)))
+
+            for (e_proc_name, e_pids), (a_proc_name, a_pids) in \
+                    zip(e_proc_names.items(), a_proc_names.items()):
+                if e_proc_name != a_proc_name:
+                    return ('Process name mismatch.  expected, actual: {}, '
+                            '{}'.format(e_proc_name, a_proc_name))
+
+                a_pids_length = len(a_pids)
+                fail_msg = ('PID count mismatch. {} ({}) expected, actual: '
+                            '{}, {} ({})'.format(e_sentry_name, e_proc_name,
+                                                 e_pids, a_pids_length,
+                                                 a_pids))
+
+                # If expected is a list, ensure at least one PID quantity match
+                if isinstance(e_pids, list) and \
+                        a_pids_length not in e_pids:
+                    return fail_msg
+                # If expected is not bool and not list,
+                # ensure PID quantities match
+                elif not isinstance(e_pids, bool) and \
+                        not isinstance(e_pids, list) and \
+                        a_pids_length != e_pids:
+                    return fail_msg
+                # If expected is bool True, ensure 1 or more PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is True and a_pids_length < 1:
+                    return fail_msg
+                # If expected is bool False, ensure 0 PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is False and a_pids_length != 0:
+                    return fail_msg
+                else:
+                    self.log.debug('PID check OK: {} {} {}: '
+                                   '{}'.format(e_sentry_name, e_proc_name,
+                                               e_pids, a_pids))
+        return None
+
+    def validate_list_of_identical_dicts(self, list_of_dicts):
+        """Check that all dicts within a list are identical."""
+        hashes = []
+        for _dict in list_of_dicts:
+            hashes.append(hash(frozenset(_dict.items())))
+
+        self.log.debug('Hashes: {}'.format(hashes))
+        if len(set(hashes)) == 1:
+            self.log.debug('Dicts within list are identical')
+        else:
+            return 'Dicts within list are not identical'
+
+        return None
+
+    def validate_sectionless_conf(self, file_contents, expected):
+        """A crude conf parser.  Useful to inspect configuration files which
+        do not have section headers (as would be necessary in order to use
+        the configparser).  Such as openstack-dashboard or rabbitmq confs."""
+        for line in file_contents.split('\n'):
+            if '=' in line:
+                args = line.split('=')
+                if len(args) <= 1:
+                    continue
+                key = args[0].strip()
+                value = args[1].strip()
+                if key in expected.keys():
+                    if expected[key] != value:
+                        msg = ('Config mismatch.  Expected, actual:  {}, '
+                               '{}'.format(expected[key], value))
+                        amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def get_unit_hostnames(self, units):
+        """Return a dict of juju unit names to hostnames."""
+        host_names = {}
+        for unit in units:
+            host_names[unit.info['unit_name']] = \
+                str(unit.file_contents('/etc/hostname').strip())
+        self.log.debug('Unit host names: {}'.format(host_names))
+        return host_names
+
+    def run_cmd_unit(self, sentry_unit, cmd):
+        """Run a command on a unit, return the output and exit code."""
+        output, code = sentry_unit.run(cmd)
+        if code == 0:
+            self.log.debug('{} `{}` command returned {} '
+                           '(OK)'.format(sentry_unit.info['unit_name'],
+                                         cmd, code))
+        else:
+            msg = ('{} `{}` command returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output), code
+
+    def file_exists_on_unit(self, sentry_unit, file_name):
+        """Check if a file exists on a unit."""
+        try:
+            sentry_unit.file_stat(file_name)
+            return True
+        except IOError:
+            return False
+        except Exception as e:
+            msg = 'Error checking file {}: {}'.format(file_name, e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def file_contents_safe(self, sentry_unit, file_name,
+                           max_wait=60, fatal=False):
+        """Get file contents from a sentry unit.  Wrap amulet file_contents
+        with retry logic to address races where a file checks as existing,
+        but no longer exists by the time file_contents is called.
+        Return None if file not found. Optionally raise if fatal is True."""
+        unit_name = sentry_unit.info['unit_name']
+        file_contents = False
+        tries = 0
+        while not file_contents and tries < (max_wait / 4):
+            try:
+                file_contents = sentry_unit.file_contents(file_name)
+            except IOError:
+                self.log.debug('Attempt {} to open file {} from {} '
+                               'failed'.format(tries, file_name,
+                                               unit_name))
+                time.sleep(4)
+                tries += 1
+
+        if file_contents:
+            return file_contents
+        elif not fatal:
+            return None
+        elif fatal:
+            msg = 'Failed to get file contents from unit.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def port_knock_tcp(self, host="localhost", port=22, timeout=15):
+        """Open a TCP socket to check for a listening sevice on a host.
+
+        :param host: host name or IP address, default to localhost
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :returns: True if successful, False if connect failed
+        """
+
+        # Resolve host name if possible
+        try:
+            connect_host = socket.gethostbyname(host)
+            host_human = "{} ({})".format(connect_host, host)
+        except socket.error as e:
+            self.log.warn('Unable to resolve address: '
+                          '{} ({}) Trying anyway!'.format(host, e))
+            connect_host = host
+            host_human = connect_host
+
+        # Attempt socket connection
+        try:
+            knock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            knock.settimeout(timeout)
+            knock.connect((connect_host, port))
+            knock.close()
+            self.log.debug('Socket connect OK for host '
+                           '{} on port {}.'.format(host_human, port))
+            return True
+        except socket.error as e:
+            self.log.debug('Socket connect FAIL for'
+                           ' {} port {} ({})'.format(host_human, port, e))
+            return False
+
+    def port_knock_units(self, sentry_units, port=22,
+                         timeout=15, expect_success=True):
+        """Open a TCP socket to check for a listening sevice on each
+        listed juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :expect_success: True by default, set False to invert logic
+        :returns: None if successful, Failure message otherwise
+        """
+        for unit in sentry_units:
+            host = unit.info['public-address']
+            connected = self.port_knock_tcp(host, port, timeout)
+            if not connected and expect_success:
+                return 'Socket connect failed.'
+            elif connected and not expect_success:
+                return 'Socket connected unexpectedly.'
+
+    def get_uuid_epoch_stamp(self):
+        """Returns a stamp string based on uuid4 and epoch time.  Useful in
+        generating test messages which need to be unique-ish."""
+        return '[{}-{}]'.format(uuid.uuid4(), time.time())
+
+    # amulet juju action helpers:
+    def run_action(self, unit_sentry, action,
+                   _check_output=subprocess.check_output,
+                   params=None):
+        """Translate to amulet's built in run_action(). Deprecated.
+
+        Run the named action on a given unit sentry.
+
+        params a dict of parameters to use
+        _check_output parameter is no longer used
+
+        @return action_id.
+        """
+        self.log.warn('charmhelpers.contrib.amulet.utils.run_action has been '
+                      'deprecated for amulet.run_action')
+        return unit_sentry.run_action(action, action_args=params)
+
+    def wait_on_action(self, action_id, _check_output=subprocess.check_output):
+        """Wait for a given action, returning if it completed or not.
+
+        action_id a string action uuid
+        _check_output parameter is no longer used
+        """
+        data = amulet.actions.get_action_output(action_id, full_output=True)
+        return data.get(u"status") == "completed"
+
+    def status_get(self, unit):
+        """Return the current service status of this unit."""
+        raw_status, return_code = unit.run(
+            "status-get --format=json --include-data")
+        if return_code != 0:
+            return ("unknown", "")
+        status = json.loads(raw_status)
+        return (status["status"], status["message"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ansible/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ansible/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..824780aca93c406f7331ec3f0da8f22bee1272ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ansible/__init__.py
@@ -0,0 +1,303 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""
+The ansible package enables you to easily use the configuration management
+tool `Ansible`_ to setup and configure your charm. All of your charm
+configuration options and relation-data are available as regular Ansible
+variables which can be used in your playbooks and templates.
+
+.. _Ansible: https://www.ansible.com/
+
+Usage
+=====
+
+Here is an example directory structure for a charm to get you started::
+
+    charm-ansible-example/
+    |-- ansible
+    |   |-- playbook.yaml
+    |   `-- templates
+    |       `-- example.j2
+    |-- config.yaml
+    |-- copyright
+    |-- icon.svg
+    |-- layer.yaml
+    |-- metadata.yaml
+    |-- reactive
+    |   `-- example.py
+    |-- README.md
+
+Running a playbook called ``playbook.yaml`` when the ``install`` hook is run
+can be as simple as::
+
+    from charmhelpers.contrib import ansible
+    from charms.reactive import hook
+
+    @hook('install')
+    def install():
+        ansible.install_ansible_support()
+        ansible.apply_playbook('ansible/playbook.yaml')
+
+Here is an example playbook that uses the ``template`` module to template the
+file ``example.j2`` to the charm host and then uses the ``debug`` module to
+print out all the host and Juju variables that you can use in your playbooks.
+Note that you must target ``localhost`` as the playbook is run locally on the
+charm host::
+
+    ---
+    - hosts: localhost
+      tasks:
+        - name: Template a file
+          template:
+            src: templates/example.j2
+            dest: /tmp/example.j2
+
+        - name: Print all variables available to Ansible
+          debug:
+            var: vars
+
+Read more online about `playbooks`_ and standard Ansible `modules`_.
+
+.. _playbooks: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
+.. _modules: https://docs.ansible.com/ansible/latest/user_guide/modules.html
+
+A further feature of the Ansible hooks is to provide a light weight "action"
+scripting tool. This is a decorator that you apply to a function, and that
+function can now receive cli args, and can pass extra args to the playbook::
+
+    @hooks.action()
+    def some_action(amount, force="False"):
+        "Usage: some-action AMOUNT [force=True]"  # <-- shown on error
+        # process the arguments
+        # do some calls
+        # return extra-vars to be passed to ansible-playbook
+        return {
+            'amount': int(amount),
+            'type': force,
+        }
+
+You can now create a symlink to hooks.py that can be invoked like a hook, but
+with cli params::
+
+    # link actions/some-action to hooks/hooks.py
+
+    actions/some-action amount=10 force=true
+
+Install Ansible via pip
+=======================
+
+If you want to install a specific version of Ansible via pip instead of
+``install_ansible_support`` which uses APT, consider using the layer options
+of `layer-basic`_ to install Ansible in a virtualenv::
+
+    options:
+      basic:
+        python_packages: ['ansible==2.9.0']
+        include_system_packages: true
+        use_venv: true
+
+.. _layer-basic: https://charmsreactive.readthedocs.io/en/latest/layer-basic.html#layer-configuration
+
+"""
+import os
+import json
+import stat
+import subprocess
+import functools
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+import charmhelpers.fetch
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+ansible_hosts_path = '/etc/ansible/hosts'
+# Ansible will automatically include any vars in the following
+# file in its inventory when run locally.
+ansible_vars_path = '/etc/ansible/host_vars/localhost'
+
+
+def install_ansible_support(from_ppa=True, ppa_location='ppa:ansible/ansible'):
+    """Installs Ansible via APT.
+
+    By default this installs Ansible from the `PPA`_ linked from
+    the Ansible `website`_ or from a PPA set in ``ppa_location``.
+
+    .. _PPA: https://launchpad.net/~ansible/+archive/ubuntu/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If ``from_ppa`` is ``False``, then Ansible will be installed from
+    Ubuntu's Universe repositories.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install('ansible')
+    with open(ansible_hosts_path, 'w+') as hosts_file:
+        hosts_file.write('localhost ansible_connection=local ansible_remote_tmp=/root/.ansible/tmp')
+
+
+def apply_playbook(playbook, tags=None, extra_vars=None):
+    """Run a playbook.
+
+    This helper runs a playbook with juju state variables as context,
+    therefore variables set in application config can be used directly.
+    List of tags (--tags) and dictionary with extra_vars (--extra-vars)
+    can be passed as additional parameters.
+
+    Read more about playbook `_variables`_ online.
+
+    .. _variables: https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html
+
+    Example::
+
+        # Run ansible/playbook.yaml with tag install and pass extra
+        # variables var_a and var_b
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['install'],
+            extra_vars={'var_a': 'val_a', 'var_b': 'val_b'}
+        )
+
+        # Run ansible/playbook.yaml with tag config and extra variable nested,
+        # which is passed as json and can be used as dictionary in playbook
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['config'],
+            extra_vars={'nested': {'a': 'value1', 'b': 'value2'}}
+        )
+
+        # Custom config file can be passed within extra_vars
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            extra_vars="@some_file.json"
+        )
+
+    """
+    tags = tags or []
+    tags = ",".join(tags)
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        ansible_vars_path, namespace_separator='__',
+        allow_hyphens_in_keys=False, mode=(stat.S_IRUSR | stat.S_IWUSR))
+
+    # we want ansible's log output to be unbuffered
+    env = os.environ.copy()
+    env['PYTHONUNBUFFERED'] = "1"
+    call = [
+        'ansible-playbook',
+        '-c',
+        'local',
+        playbook,
+    ]
+    if tags:
+        call.extend(['--tags', '{}'.format(tags)])
+    if extra_vars:
+        call.extend(['--extra-vars', json.dumps(extra_vars)])
+    subprocess.check_call(call, env=env)
+
+
+class AnsibleHooks(charmhelpers.core.hookenv.Hooks):
+    """Run a playbook with the hook-name as the tag.
+
+    This helper builds on the standard hookenv.Hooks helper,
+    but additionally runs the playbook with the hook-name specified
+    using --tags (ie. running all the tasks tagged with the hook-name).
+
+    Example::
+
+        hooks = AnsibleHooks(playbook_path='ansible/my_machine_state.yaml')
+
+        # All the tasks within my_machine_state.yaml tagged with 'install'
+        # will be run automatically after do_custom_work()
+        @hooks.hook()
+        def install():
+            do_custom_work()
+
+        # For most of your hooks, you won't need to do anything other
+        # than run the tagged tasks for the hook:
+        @hooks.hook('config-changed', 'start', 'stop')
+        def just_use_playbook():
+            pass
+
+        # As a convenience, you can avoid the above noop function by specifying
+        # the hooks which are handled by ansible-only and they'll be registered
+        # for you:
+        # hooks = AnsibleHooks(
+        #     'ansible/my_machine_state.yaml',
+        #     default_hooks=['config-changed', 'start', 'stop'])
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, playbook_path, default_hooks=None):
+        """Register any hooks handled by ansible."""
+        super(AnsibleHooks, self).__init__()
+
+        self._actions = {}
+        self.playbook_path = playbook_path
+
+        default_hooks = default_hooks or []
+
+        def noop(*args, **kwargs):
+            pass
+
+        for hook in default_hooks:
+            self.register(hook, noop)
+
+    def register_action(self, name, function):
+        """Register a hook"""
+        self._actions[name] = function
+
+    def execute(self, args):
+        """Execute the hook followed by the playbook using the hook as tag."""
+        hook_name = os.path.basename(args[0])
+        extra_vars = None
+        if hook_name in self._actions:
+            extra_vars = self._actions[hook_name](args[1:])
+        else:
+            super(AnsibleHooks, self).execute(args)
+
+        charmhelpers.contrib.ansible.apply_playbook(
+            self.playbook_path, tags=[hook_name], extra_vars=extra_vars)
+
+    def action(self, *action_names):
+        """Decorator, registering them as actions"""
+        def action_wrapper(decorated):
+
+            @functools.wraps(decorated)
+            def wrapper(argv):
+                kwargs = dict(arg.split('=') for arg in argv)
+                try:
+                    return decorated(**kwargs)
+                except TypeError as e:
+                    if decorated.__doc__:
+                        e.args += (decorated.__doc__,)
+                    raise
+
+            self.register_action(decorated.__name__, wrapper)
+            if '_' in decorated.__name__:
+                self.register_action(
+                    decorated.__name__.replace('_', '-'), wrapper)
+
+            return wrapper
+
+        return action_wrapper
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/benchmark/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/benchmark/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c35f7fe785a29519a257f1ed5aa33fdfa19129c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/benchmark/__init__.py
@@ -0,0 +1,124 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import time
+import os
+from distutils.spawn import find_executable
+
+from charmhelpers.core.hookenv import (
+    in_relation_hook,
+    relation_ids,
+    relation_set,
+    relation_get,
+)
+
+
+def action_set(key, val):
+    if find_executable('action-set'):
+        action_cmd = ['action-set']
+
+        if isinstance(val, dict):
+            for k, v in iter(val.items()):
+                action_set('%s.%s' % (key, k), v)
+            return True
+
+        action_cmd.append('%s=%s' % (key, val))
+        subprocess.check_call(action_cmd)
+        return True
+    return False
+
+
+class Benchmark():
+    """
+    Helper class for the `benchmark` interface.
+
+    :param list actions: Define the actions that are also benchmarks
+
+    From inside the benchmark-relation-changed hook, you would
+    Benchmark(['memory', 'cpu', 'disk', 'smoke', 'custom'])
+
+    Examples:
+
+        siege = Benchmark(['siege'])
+        siege.start()
+        [... run siege ...]
+        # The higher the score, the better the benchmark
+        siege.set_composite_score(16.70, 'trans/sec', 'desc')
+        siege.finish()
+
+
+    """
+
+    BENCHMARK_CONF = '/etc/benchmark.conf'  # Replaced in testing
+
+    required_keys = [
+        'hostname',
+        'port',
+        'graphite_port',
+        'graphite_endpoint',
+        'api_port'
+    ]
+
+    def __init__(self, benchmarks=None):
+        if in_relation_hook():
+            if benchmarks is not None:
+                for rid in sorted(relation_ids('benchmark')):
+                    relation_set(relation_id=rid, relation_settings={
+                        'benchmarks': ",".join(benchmarks)
+                    })
+
+            # Check the relation data
+            config = {}
+            for key in self.required_keys:
+                val = relation_get(key)
+                if val is not None:
+                    config[key] = val
+                else:
+                    # We don't have all of the required keys
+                    config = {}
+                    break
+
+            if len(config):
+                with open(self.BENCHMARK_CONF, 'w') as f:
+                    for key, val in iter(config.items()):
+                        f.write("%s=%s\n" % (key, val))
+
+    @staticmethod
+    def start():
+        action_set('meta.start', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+        """
+        If the collectd charm is also installed, tell it to send a snapshot
+        of the current profile data.
+        """
+        COLLECT_PROFILE_DATA = '/usr/local/bin/collect-profile-data'
+        if os.path.exists(COLLECT_PROFILE_DATA):
+            subprocess.check_output([COLLECT_PROFILE_DATA])
+
+    @staticmethod
+    def finish():
+        action_set('meta.stop', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+    @staticmethod
+    def set_composite_score(value, units, direction='asc'):
+        """
+        Set the composite score for a benchmark run. This is a single number
+        representative of the benchmark results. This could be the most
+        important metric, or an amalgamation of metric scores.
+        """
+        return action_set(
+            "meta.composite",
+            {'value': value, 'units': units, 'direction': direction}
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..d41cb041f45cb19b87aee7d3f5fd4d47a3d3fb2d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/IMPORT
@@ -0,0 +1,4 @@
+Source lp:charm-tools/trunk
+
+charm-tools/helpers/python/charmhelpers/__init__.py -> charmhelpers/charmhelpers/contrib/charmhelpers/__init__.py
+charm-tools/helpers/python/charmhelpers/tests/test_charmhelpers.py -> charmhelpers/tests/contrib/charmhelpers/test_charmhelpers.py
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed63e8121e23a8e01ccb8ddcbf9aea34543d3666
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmhelpers/__init__.py
@@ -0,0 +1,203 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import warnings
+warnings.warn("contrib.charmhelpers is deprecated", DeprecationWarning)  # noqa
+
+import operator
+import tempfile
+import time
+import yaml
+import subprocess
+
+import six
+if six.PY3:
+    from urllib.request import urlopen
+    from urllib.error import (HTTPError, URLError)
+else:
+    from urllib2 import (urlopen, HTTPError, URLError)
+
+"""Helper functions for writing Juju charms in Python."""
+
+__metaclass__ = type
+__all__ = [
+    # 'get_config',             # core.hookenv.config()
+    # 'log',                    # core.hookenv.log()
+    # 'log_entry',              # core.hookenv.log()
+    # 'log_exit',               # core.hookenv.log()
+    # 'relation_get',           # core.hookenv.relation_get()
+    # 'relation_set',           # core.hookenv.relation_set()
+    # 'relation_ids',           # core.hookenv.relation_ids()
+    # 'relation_list',          # core.hookenv.relation_units()
+    # 'config_get',             # core.hookenv.config()
+    # 'unit_get',               # core.hookenv.unit_get()
+    # 'open_port',              # core.hookenv.open_port()
+    # 'close_port',             # core.hookenv.close_port()
+    # 'service_control',        # core.host.service()
+    'unit_info',              # client-side, NOT IMPLEMENTED
+    'wait_for_machine',       # client-side, NOT IMPLEMENTED
+    'wait_for_page_contents',  # client-side, NOT IMPLEMENTED
+    'wait_for_relation',      # client-side, NOT IMPLEMENTED
+    'wait_for_unit',          # client-side, NOT IMPLEMENTED
+]
+
+
+SLEEP_AMOUNT = 0.1
+
+
+# We create a juju_status Command here because it makes testing much,
+# much easier.
+def juju_status():
+    subprocess.check_call(['juju', 'status'])
+
+# re-implemented as charmhelpers.fetch.configure_sources()
+# def configure_source(update=False):
+#    source = config_get('source')
+#    if ((source.startswith('ppa:') or
+#         source.startswith('cloud:') or
+#         source.startswith('http:'))):
+#        run('add-apt-repository', source)
+#    if source.startswith("http:"):
+#        run('apt-key', 'import', config_get('key'))
+#    if update:
+#        run('apt-get', 'update')
+
+
+# DEPRECATED: client-side only
+def make_charm_config_file(charm_config):
+    charm_config_file = tempfile.NamedTemporaryFile(mode='w+')
+    charm_config_file.write(yaml.dump(charm_config))
+    charm_config_file.flush()
+    # The NamedTemporaryFile instance is returned instead of just the name
+    # because we want to take advantage of garbage collection-triggered
+    # deletion of the temp file when it goes out of scope in the caller.
+    return charm_config_file
+
+
+# DEPRECATED: client-side only
+def unit_info(service_name, item_name, data=None, unit=None):
+    if data is None:
+        data = yaml.safe_load(juju_status())
+    service = data['services'].get(service_name)
+    if service is None:
+        # XXX 2012-02-08 gmb:
+        #     This allows us to cope with the race condition that we
+        #     have between deploying a service and having it come up in
+        #     `juju status`. We could probably do with cleaning it up so
+        #     that it fails a bit more noisily after a while.
+        return ''
+    units = service['units']
+    if unit is not None:
+        item = units[unit][item_name]
+    else:
+        # It might seem odd to sort the units here, but we do it to
+        # ensure that when no unit is specified, the first unit for the
+        # service (or at least the one with the lowest number) is the
+        # one whose data gets returned.
+        sorted_unit_names = sorted(units.keys())
+        item = units[sorted_unit_names[0]][item_name]
+    return item
+
+
+# DEPRECATED: client-side only
+def get_machine_data():
+    return yaml.safe_load(juju_status())['machines']
+
+
+# DEPRECATED: client-side only
+def wait_for_machine(num_machines=1, timeout=300):
+    """Wait `timeout` seconds for `num_machines` machines to come up.
+
+    This wait_for... function can be called by other wait_for functions
+    whose timeouts might be too short in situations where only a bare
+    Juju setup has been bootstrapped.
+
+    :return: A tuple of (num_machines, time_taken). This is used for
+             testing.
+    """
+    # You may think this is a hack, and you'd be right. The easiest way
+    # to tell what environment we're working in (LXC vs EC2) is to check
+    # the dns-name of the first machine. If it's localhost we're in LXC
+    # and we can just return here.
+    if get_machine_data()[0]['dns-name'] == 'localhost':
+        return 1, 0
+    start_time = time.time()
+    while True:
+        # Drop the first machine, since it's the Zookeeper and that's
+        # not a machine that we need to wait for. This will only work
+        # for EC2 environments, which is why we return early above if
+        # we're in LXC.
+        machine_data = get_machine_data()
+        non_zookeeper_machines = [
+            machine_data[key] for key in list(machine_data.keys())[1:]]
+        if len(non_zookeeper_machines) >= num_machines:
+            all_machines_running = True
+            for machine in non_zookeeper_machines:
+                if machine.get('instance-state') != 'running':
+                    all_machines_running = False
+                    break
+            if all_machines_running:
+                break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    return num_machines, time.time() - start_time
+
+
+# DEPRECATED: client-side only
+def wait_for_unit(service_name, timeout=480):
+    """Wait `timeout` seconds for a given service name to come up."""
+    wait_for_machine(num_machines=1)
+    start_time = time.time()
+    while True:
+        state = unit_info(service_name, 'agent-state')
+        if 'error' in state or state == 'started':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    if state != 'started':
+        raise RuntimeError('unit did not start, agent-state: ' + state)
+
+
+# DEPRECATED: client-side only
+def wait_for_relation(service_name, relation_name, timeout=120):
+    """Wait `timeout` seconds for a given relation to come up."""
+    start_time = time.time()
+    while True:
+        relation = unit_info(service_name, 'relations').get(relation_name)
+        if relation is not None and relation['state'] == 'up':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for relation to be up')
+        time.sleep(SLEEP_AMOUNT)
+
+
+# DEPRECATED: client-side only
+def wait_for_page_contents(url, contents, timeout=120, validate=None):
+    if validate is None:
+        validate = operator.contains
+    start_time = time.time()
+    while True:
+        try:
+            stream = urlopen(url)
+        except (HTTPError, URLError):
+            pass
+        else:
+            page = stream.read()
+            if validate(page, contents):
+                return page
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for contents of ' + url)
+        time.sleep(SLEEP_AMOUNT)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..554fddda9f48d6d17abaff942834493b2cca2dbe
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/IMPORT
@@ -0,0 +1,14 @@
+Source: lp:charmsupport/trunk
+
+charmsupport/charmsupport/execd.py -> charm-helpers/charmhelpers/contrib/charmsupport/execd.py
+charmsupport/charmsupport/hookenv.py -> charm-helpers/charmhelpers/contrib/charmsupport/hookenv.py
+charmsupport/charmsupport/host.py -> charm-helpers/charmhelpers/contrib/charmsupport/host.py
+charmsupport/charmsupport/nrpe.py -> charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py
+charmsupport/charmsupport/volumes.py -> charm-helpers/charmhelpers/contrib/charmsupport/volumes.py
+
+charmsupport/tests/test_execd.py -> charm-helpers/tests/contrib/charmsupport/test_execd.py
+charmsupport/tests/test_hookenv.py -> charm-helpers/tests/contrib/charmsupport/test_hookenv.py
+charmsupport/tests/test_host.py -> charm-helpers/tests/contrib/charmsupport/test_host.py
+charmsupport/tests/test_nrpe.py -> charm-helpers/tests/contrib/charmsupport/test_nrpe.py
+
+charmsupport/bin/charmsupport -> charm-helpers/bin/contrib/charmsupport/charmsupport
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/nrpe.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/nrpe.py
new file mode 100644
index 0000000000000000000000000000000000000000..d775861b0868a174a3f0f4a8d4a42320272a4cb0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/nrpe.py
@@ -0,0 +1,500 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Compatibility with the nrpe-external-master charm"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import subprocess
+import pwd
+import grp
+import os
+import glob
+import shutil
+import re
+import shlex
+import yaml
+
+from charmhelpers.core.hookenv import (
+    config,
+    hook_name,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    relation_set,
+    relations_of_type,
+)
+
+from charmhelpers.core.host import service
+from charmhelpers.core import host
+
+# This module adds compatibility with the nrpe-external-master and plain nrpe
+# subordinate charms. To use it in your charm:
+#
+# 1. Update metadata.yaml
+#
+#   provides:
+#     (...)
+#     nrpe-external-master:
+#       interface: nrpe-external-master
+#       scope: container
+#
+#   and/or
+#
+#   provides:
+#     (...)
+#     local-monitors:
+#       interface: local-monitors
+#       scope: container
+
+#
+# 2. Add the following to config.yaml
+#
+#    nagios_context:
+#      default: "juju"
+#      type: string
+#      description: |
+#        Used by the nrpe subordinate charms.
+#        A string that will be prepended to instance name to set the host name
+#        in nagios. So for instance the hostname would be something like:
+#            juju-myservice-0
+#        If you're running multiple environments with the same services in them
+#        this allows you to differentiate between them.
+#    nagios_servicegroups:
+#      default: ""
+#      type: string
+#      description: |
+#        A comma-separated list of nagios servicegroups.
+#        If left empty, the nagios_context will be used as the servicegroup
+#
+# 3. Add custom checks (Nagios plugins) to files/nrpe-external-master
+#
+# 4. Update your hooks.py with something like this:
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE()
+#        nrpe_compat.add_check(
+#            shortname = "myservice",
+#            description = "Check MyService",
+#            check_cmd = "check_http -w 2 -c 10 http://localhost"
+#            )
+#        nrpe_compat.add_check(
+#            "myservice_other",
+#            "Check for widget failures",
+#            check_cmd = "/srv/myapp/scripts/widget_check"
+#            )
+#        nrpe_compat.write()
+#
+#    def config_changed():
+#        (...)
+#        update_nrpe_config()
+#
+#    def nrpe_external_master_relation_changed():
+#        update_nrpe_config()
+#
+#    def local_monitors_relation_changed():
+#        update_nrpe_config()
+#
+# 4.a If your charm is a subordinate charm set primary=False
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE(primary=False)
+#
+# 5. ln -s hooks.py nrpe-external-master-relation-changed
+#    ln -s hooks.py local-monitors-relation-changed
+
+
+class CheckException(Exception):
+    pass
+
+
+class Check(object):
+    shortname_re = '[A-Za-z0-9-_.@]+$'
+    service_template = ("""
+#---------------------------------------------------
+# This file is Juju managed
+#---------------------------------------------------
+define service {{
+    use                             active-service
+    host_name                       {nagios_hostname}
+    service_description             {nagios_hostname}[{shortname}] """
+                        """{description}
+    check_command                   check_nrpe!{command}
+    servicegroups                   {nagios_servicegroup}
+}}
+""")
+
+    def __init__(self, shortname, description, check_cmd):
+        super(Check, self).__init__()
+        # XXX: could be better to calculate this from the service name
+        if not re.match(self.shortname_re, shortname):
+            raise CheckException("shortname must match {}".format(
+                Check.shortname_re))
+        self.shortname = shortname
+        self.command = "check_{}".format(shortname)
+        # Note: a set of invalid characters is defined by the
+        # Nagios server config
+        # The default is: illegal_object_name_chars=`~!$%^&*"|'<>?,()=
+        self.description = description
+        self.check_cmd = self._locate_cmd(check_cmd)
+
+    def _get_check_filename(self):
+        return os.path.join(NRPE.nrpe_confdir, '{}.cfg'.format(self.command))
+
+    def _get_service_filename(self, hostname):
+        return os.path.join(NRPE.nagios_exportdir,
+                            'service__{}_{}.cfg'.format(hostname, self.command))
+
+    def _locate_cmd(self, check_cmd):
+        search_path = (
+            '/usr/lib/nagios/plugins',
+            '/usr/local/lib/nagios/plugins',
+        )
+        parts = shlex.split(check_cmd)
+        for path in search_path:
+            if os.path.exists(os.path.join(path, parts[0])):
+                command = os.path.join(path, parts[0])
+                if len(parts) > 1:
+                    command += " " + " ".join(parts[1:])
+                return command
+        log('Check command not found: {}'.format(parts[0]))
+        return ''
+
+    def _remove_service_files(self):
+        if not os.path.exists(NRPE.nagios_exportdir):
+            return
+        for f in os.listdir(NRPE.nagios_exportdir):
+            if f.endswith('_{}.cfg'.format(self.command)):
+                os.remove(os.path.join(NRPE.nagios_exportdir, f))
+
+    def remove(self, hostname):
+        nrpe_check_file = self._get_check_filename()
+        if os.path.exists(nrpe_check_file):
+            os.remove(nrpe_check_file)
+        self._remove_service_files()
+
+    def write(self, nagios_context, hostname, nagios_servicegroups):
+        nrpe_check_file = self._get_check_filename()
+        with open(nrpe_check_file, 'w') as nrpe_check_config:
+            nrpe_check_config.write("# check {}\n".format(self.shortname))
+            if nagios_servicegroups:
+                nrpe_check_config.write(
+                    "# The following header was added automatically by juju\n")
+                nrpe_check_config.write(
+                    "# Modifying it will affect nagios monitoring and alerting\n")
+                nrpe_check_config.write(
+                    "# servicegroups: {}\n".format(nagios_servicegroups))
+            nrpe_check_config.write("command[{}]={}\n".format(
+                self.command, self.check_cmd))
+
+        if not os.path.exists(NRPE.nagios_exportdir):
+            log('Not writing service config as {} is not accessible'.format(
+                NRPE.nagios_exportdir))
+        else:
+            self.write_service_config(nagios_context, hostname,
+                                      nagios_servicegroups)
+
+    def write_service_config(self, nagios_context, hostname,
+                             nagios_servicegroups):
+        self._remove_service_files()
+
+        templ_vars = {
+            'nagios_hostname': hostname,
+            'nagios_servicegroup': nagios_servicegroups,
+            'description': self.description,
+            'shortname': self.shortname,
+            'command': self.command,
+        }
+        nrpe_service_text = Check.service_template.format(**templ_vars)
+        nrpe_service_file = self._get_service_filename(hostname)
+        with open(nrpe_service_file, 'w') as nrpe_service_config:
+            nrpe_service_config.write(str(nrpe_service_text))
+
+    def run(self):
+        subprocess.call(self.check_cmd)
+
+
+class NRPE(object):
+    nagios_logdir = '/var/log/nagios'
+    nagios_exportdir = '/var/lib/nagios/export'
+    nrpe_confdir = '/etc/nagios/nrpe.d'
+    homedir = '/var/lib/nagios'  # home dir provided by nagios-nrpe-server
+
+    def __init__(self, hostname=None, primary=True):
+        super(NRPE, self).__init__()
+        self.config = config()
+        self.primary = primary
+        self.nagios_context = self.config['nagios_context']
+        if 'nagios_servicegroups' in self.config and self.config['nagios_servicegroups']:
+            self.nagios_servicegroups = self.config['nagios_servicegroups']
+        else:
+            self.nagios_servicegroups = self.nagios_context
+        self.unit_name = local_unit().replace('/', '-')
+        if hostname:
+            self.hostname = hostname
+        else:
+            nagios_hostname = get_nagios_hostname()
+            if nagios_hostname:
+                self.hostname = nagios_hostname
+            else:
+                self.hostname = "{}-{}".format(self.nagios_context, self.unit_name)
+        self.checks = []
+        # Iff in an nrpe-external-master relation hook, set primary status
+        relation = relation_ids('nrpe-external-master')
+        if relation:
+            log("Setting charm primary status {}".format(primary))
+            for rid in relation:
+                relation_set(relation_id=rid, relation_settings={'primary': self.primary})
+        self.remove_check_queue = set()
+
+    def add_check(self, *args, **kwargs):
+        shortname = None
+        if kwargs.get('shortname') is None:
+            if len(args) > 0:
+                shortname = args[0]
+        else:
+            shortname = kwargs['shortname']
+
+        self.checks.append(Check(*args, **kwargs))
+        try:
+            self.remove_check_queue.remove(shortname)
+        except KeyError:
+            pass
+
+    def remove_check(self, *args, **kwargs):
+        if kwargs.get('shortname') is None:
+            raise ValueError('shortname of check must be specified')
+
+        # Use sensible defaults if they're not specified - these are not
+        # actually used during removal, but they're required for constructing
+        # the Check object; check_disk is chosen because it's part of the
+        # nagios-plugins-basic package.
+        if kwargs.get('check_cmd') is None:
+            kwargs['check_cmd'] = 'check_disk'
+        if kwargs.get('description') is None:
+            kwargs['description'] = ''
+
+        check = Check(*args, **kwargs)
+        check.remove(self.hostname)
+        self.remove_check_queue.add(kwargs['shortname'])
+
+    def write(self):
+        try:
+            nagios_uid = pwd.getpwnam('nagios').pw_uid
+            nagios_gid = grp.getgrnam('nagios').gr_gid
+        except Exception:
+            log("Nagios user not set up, nrpe checks not updated")
+            return
+
+        if not os.path.exists(NRPE.nagios_logdir):
+            os.mkdir(NRPE.nagios_logdir)
+            os.chown(NRPE.nagios_logdir, nagios_uid, nagios_gid)
+
+        nrpe_monitors = {}
+        monitors = {"monitors": {"remote": {"nrpe": nrpe_monitors}}}
+        for nrpecheck in self.checks:
+            nrpecheck.write(self.nagios_context, self.hostname,
+                            self.nagios_servicegroups)
+            nrpe_monitors[nrpecheck.shortname] = {
+                "command": nrpecheck.command,
+            }
+
+        # update-status hooks are configured to firing every 5 minutes by
+        # default. When nagios-nrpe-server is restarted, the nagios server
+        # reports checks failing causing unnecessary alerts. Let's not restart
+        # on update-status hooks.
+        if not hook_name() == 'update-status':
+            service('restart', 'nagios-nrpe-server')
+
+        monitor_ids = relation_ids("local-monitors") + \
+            relation_ids("nrpe-external-master")
+        for rid in monitor_ids:
+            reldata = relation_get(unit=local_unit(), rid=rid)
+            if 'monitors' in reldata:
+                # update the existing set of monitors with the new data
+                old_monitors = yaml.safe_load(reldata['monitors'])
+                old_nrpe_monitors = old_monitors['monitors']['remote']['nrpe']
+                # remove keys that are in the remove_check_queue
+                old_nrpe_monitors = {k: v for k, v in old_nrpe_monitors.items()
+                                     if k not in self.remove_check_queue}
+                # update/add nrpe_monitors
+                old_nrpe_monitors.update(nrpe_monitors)
+                old_monitors['monitors']['remote']['nrpe'] = old_nrpe_monitors
+                # write back to the relation
+                relation_set(relation_id=rid, monitors=yaml.dump(old_monitors))
+            else:
+                # write a brand new set of monitors, as no existing ones.
+                relation_set(relation_id=rid, monitors=yaml.dump(monitors))
+
+        self.remove_check_queue.clear()
+
+
+def get_nagios_hostcontext(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_host_context
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_host_context' in rel:
+            return rel['nagios_host_context']
+
+
+def get_nagios_hostname(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_hostname
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_hostname' in rel:
+            return rel['nagios_hostname']
+
+
+def get_nagios_unit_name(relation_name='nrpe-external-master'):
+    """
+    Return the nagios unit name prepended with host_context if needed
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    host_context = get_nagios_hostcontext(relation_name)
+    if host_context:
+        unit = "%s:%s" % (host_context, local_unit())
+    else:
+        unit = local_unit()
+    return unit
+
+
+def add_init_service_checks(nrpe, services, unit_name, immediate_check=True):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param list services: List of services to check
+    :param str unit_name: Unit name to use in check description
+    :param bool immediate_check: For sysv init, run the service check immediately
+    """
+    for svc in services:
+        # Don't add a check for these services from neutron-gateway
+        if svc in ['ext-port', 'os-charm-phy-nic-mtu']:
+            next
+
+        upstart_init = '/etc/init/%s.conf' % svc
+        sysv_init = '/etc/init.d/%s' % svc
+
+        if host.init_is_systemd():
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_systemd.py %s' % svc
+            )
+        elif os.path.exists(upstart_init):
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_upstart_job %s' % svc
+            )
+        elif os.path.exists(sysv_init):
+            cronpath = '/etc/cron.d/nagios-service-check-%s' % svc
+            checkpath = '%s/service-check-%s.txt' % (nrpe.homedir, svc)
+            croncmd = (
+                '/usr/local/lib/nagios/plugins/check_exit_status.pl '
+                '-e -s /etc/init.d/%s status' % svc
+            )
+            cron_file = '*/5 * * * * root %s > %s\n' % (croncmd, checkpath)
+            f = open(cronpath, 'w')
+            f.write(cron_file)
+            f.close()
+            nrpe.add_check(
+                shortname=svc,
+                description='service check {%s}' % unit_name,
+                check_cmd='check_status_file.py -f %s' % checkpath,
+            )
+            # if /var/lib/nagios doesn't exist open(checkpath, 'w') will fail
+            # (LP: #1670223).
+            if immediate_check and os.path.isdir(nrpe.homedir):
+                f = open(checkpath, 'w')
+                subprocess.call(
+                    croncmd.split(),
+                    stdout=f,
+                    stderr=subprocess.STDOUT
+                )
+                f.close()
+                os.chmod(checkpath, 0o644)
+
+
+def copy_nrpe_checks(nrpe_files_dir=None):
+    """
+    Copy the nrpe checks into place
+
+    """
+    NAGIOS_PLUGINS = '/usr/local/lib/nagios/plugins'
+    if nrpe_files_dir is None:
+        # determine if "charmhelpers" is in CHARMDIR or CHARMDIR/hooks
+        for segment in ['.', 'hooks']:
+            nrpe_files_dir = os.path.abspath(os.path.join(
+                os.getenv('CHARM_DIR'),
+                segment,
+                'charmhelpers',
+                'contrib',
+                'openstack',
+                'files'))
+            if os.path.isdir(nrpe_files_dir):
+                break
+        else:
+            raise RuntimeError("Couldn't find charmhelpers directory")
+    if not os.path.exists(NAGIOS_PLUGINS):
+        os.makedirs(NAGIOS_PLUGINS)
+    for fname in glob.glob(os.path.join(nrpe_files_dir, "check_*")):
+        if os.path.isfile(fname):
+            shutil.copy2(fname,
+                         os.path.join(NAGIOS_PLUGINS, os.path.basename(fname)))
+
+
+def add_haproxy_checks(nrpe, unit_name):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param str unit_name: Unit name to use in check description
+    """
+    nrpe.add_check(
+        shortname='haproxy_servers',
+        description='Check HAProxy {%s}' % unit_name,
+        check_cmd='check_haproxy.sh')
+    nrpe.add_check(
+        shortname='haproxy_queue',
+        description='Check HAProxy queue depth {%s}' % unit_name,
+        check_cmd='check_haproxy_queue_depth.sh')
+
+
+def remove_deprecated_check(nrpe, deprecated_services):
+    """
+    Remove checks fro deprecated services in list
+
+    :param nrpe: NRPE object to remove check from
+    :type nrpe: NRPE
+    :param deprecated_services: List of deprecated services that are removed
+    :type deprecated_services: list
+    """
+    for dep_svc in deprecated_services:
+        log('Deprecated service: {}'.format(dep_svc))
+        nrpe.remove_check(shortname=dep_svc)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/volumes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/volumes.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ea43f0888cd92ac4344f908aa7c9d0afe7568ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/charmsupport/volumes.py
@@ -0,0 +1,173 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Functions for managing volumes in juju units. One volume is supported per unit.
+Subordinates may have their own storage, provided it is on its own partition.
+
+Configuration stanzas::
+
+  volume-ephemeral:
+    type: boolean
+    default: true
+    description: >
+      If false, a volume is mounted as sepecified in "volume-map"
+      If true, ephemeral storage will be used, meaning that log data
+         will only exist as long as the machine. YOU HAVE BEEN WARNED.
+  volume-map:
+    type: string
+    default: {}
+    description: >
+      YAML map of units to device names, e.g:
+        "{ rsyslog/0: /dev/vdb, rsyslog/1: /dev/vdb }"
+      Service units will raise a configure-error if volume-ephemeral
+      is 'true' and no volume-map value is set. Use 'juju set' to set a
+      value and 'juju resolved' to complete configuration.
+
+Usage::
+
+    from charmsupport.volumes import configure_volume, VolumeConfigurationError
+    from charmsupport.hookenv import log, ERROR
+    def post_mount_hook():
+        stop_service('myservice')
+    def post_mount_hook():
+        start_service('myservice')
+
+    if __name__ == '__main__':
+        try:
+            configure_volume(before_change=pre_mount_hook,
+                             after_change=post_mount_hook)
+        except VolumeConfigurationError:
+            log('Storage could not be configured', ERROR)
+
+'''
+
+# XXX: Known limitations
+# - fstab is neither consulted nor updated
+
+import os
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+import yaml
+
+
+MOUNT_BASE = '/srv/juju/volumes'
+
+
+class VolumeConfigurationError(Exception):
+    '''Volume configuration data is missing or invalid'''
+    pass
+
+
+def get_config():
+    '''Gather and sanity-check volume configuration data'''
+    volume_config = {}
+    config = hookenv.config()
+
+    errors = False
+
+    if config.get('volume-ephemeral') in (True, 'True', 'true', 'Yes', 'yes'):
+        volume_config['ephemeral'] = True
+    else:
+        volume_config['ephemeral'] = False
+
+    try:
+        volume_map = yaml.safe_load(config.get('volume-map', '{}'))
+    except yaml.YAMLError as e:
+        hookenv.log("Error parsing YAML volume-map: {}".format(e),
+                    hookenv.ERROR)
+        errors = True
+    if volume_map is None:
+        # probably an empty string
+        volume_map = {}
+    elif not isinstance(volume_map, dict):
+        hookenv.log("Volume-map should be a dictionary, not {}".format(
+            type(volume_map)))
+        errors = True
+
+    volume_config['device'] = volume_map.get(os.environ['JUJU_UNIT_NAME'])
+    if volume_config['device'] and volume_config['ephemeral']:
+        # asked for ephemeral storage but also defined a volume ID
+        hookenv.log('A volume is defined for this unit, but ephemeral '
+                    'storage was requested', hookenv.ERROR)
+        errors = True
+    elif not volume_config['device'] and not volume_config['ephemeral']:
+        # asked for permanent storage but did not define volume ID
+        hookenv.log('Ephemeral storage was requested, but there is no volume '
+                    'defined for this unit.', hookenv.ERROR)
+        errors = True
+
+    unit_mount_name = hookenv.local_unit().replace('/', '-')
+    volume_config['mountpoint'] = os.path.join(MOUNT_BASE, unit_mount_name)
+
+    if errors:
+        return None
+    return volume_config
+
+
+def mount_volume(config):
+    if os.path.exists(config['mountpoint']):
+        if not os.path.isdir(config['mountpoint']):
+            hookenv.log('Not a directory: {}'.format(config['mountpoint']))
+            raise VolumeConfigurationError()
+    else:
+        host.mkdir(config['mountpoint'])
+    if os.path.ismount(config['mountpoint']):
+        unmount_volume(config)
+    if not host.mount(config['device'], config['mountpoint'], persist=True):
+        raise VolumeConfigurationError()
+
+
+def unmount_volume(config):
+    if os.path.ismount(config['mountpoint']):
+        if not host.umount(config['mountpoint'], persist=True):
+            raise VolumeConfigurationError()
+
+
+def managed_mounts():
+    '''List of all mounted managed volumes'''
+    return filter(lambda mount: mount[0].startswith(MOUNT_BASE), host.mounts())
+
+
+def configure_volume(before_change=lambda: None, after_change=lambda: None):
+    '''Set up storage (or don't) according to the charm's volume configuration.
+       Returns the mount point or "ephemeral". before_change and after_change
+       are optional functions to be called if the volume configuration changes.
+    '''
+
+    config = get_config()
+    if not config:
+        hookenv.log('Failed to read volume configuration', hookenv.CRITICAL)
+        raise VolumeConfigurationError()
+
+    if config['ephemeral']:
+        if os.path.ismount(config['mountpoint']):
+            before_change()
+            unmount_volume(config)
+            after_change()
+        return 'ephemeral'
+    else:
+        # persistent storage
+        if os.path.ismount(config['mountpoint']):
+            mounts = dict(managed_mounts())
+            if mounts.get(config['mountpoint']) != config['device']:
+                before_change()
+                unmount_volume(config)
+                mount_volume(config)
+                after_change()
+        else:
+            before_change()
+            mount_volume(config)
+            after_change()
+        return config['mountpoint']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..64fac9def6101c1de83cd5dafe7fdb5213d6a955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/__init__.py
@@ -0,0 +1,11 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/mysql.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/mysql.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9ecce5f793eedeb963557d109deaf5e1271e65f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/database/mysql.py
@@ -0,0 +1,821 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper for working with a MySQL database"""
+import collections
+import copy
+import json
+import re
+import sys
+import platform
+import os
+import glob
+import six
+
+# from string import upper
+
+from charmhelpers.core.host import (
+    CompareHostReleases,
+    lsb_release,
+    mkdir,
+    pwgen,
+    write_file
+)
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    related_units,
+    unit_get,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    leader_get,
+    leader_set,
+    is_leader,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+    filter_installed_packages,
+)
+from charmhelpers.contrib.network.ip import get_host_ip
+
+try:
+    import MySQLdb
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install(filter_installed_packages(['python-mysqldb']), fatal=True)
+    else:
+        apt_install(filter_installed_packages(['python3-mysqldb']), fatal=True)
+    import MySQLdb
+
+
+class MySQLSetPasswordError(Exception):
+    pass
+
+
+class MySQLHelper(object):
+
+    def __init__(self, rpasswdf_template, upasswdf_template, host='localhost',
+                 migrate_passwd_to_leader_storage=True,
+                 delete_ondisk_passwd_file=True, user="root", password=None, port=None):
+        self.user = user
+        self.host = host
+        self.password = password
+        self.port = port
+
+        # Password file path templates
+        self.root_passwd_file_template = rpasswdf_template
+        self.user_passwd_file_template = upasswdf_template
+
+        self.migrate_passwd_to_leader_storage = migrate_passwd_to_leader_storage
+        # If we migrate we have the option to delete local copy of root passwd
+        self.delete_ondisk_passwd_file = delete_ondisk_passwd_file
+        self.connection = None
+
+    def connect(self, user='root', password=None, host=None, port=None):
+        _connection_info = {
+            "user": user or self.user,
+            "passwd": password or self.password,
+            "host": host or self.host
+        }
+        # port cannot be None but we also do not want to specify it unless it
+        # has been explicit set.
+        port = port or self.port
+        if port is not None:
+            _connection_info["port"] = port
+
+        log("Opening db connection for %s@%s" % (user, host), level=DEBUG)
+        self.connection = MySQLdb.connect(**_connection_info)
+
+    def database_exists(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("SHOW DATABASES")
+            databases = [i[0] for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+
+        return db_name in databases
+
+    def create_database(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("CREATE DATABASE `{}` CHARACTER SET UTF8"
+                           .format(db_name))
+        finally:
+            cursor.close()
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = "GRANT ALL PRIVILEGES ON `{}`.* " \
+                      "TO '{}'@'{}'".format(db_name, db_user, remote_ip)
+        try:
+            cursor.execute("SHOW GRANTS for '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # TODO: review for different grants
+        return priv_string in grants
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            # TODO: review for different grants
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_name,
+                                                       db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def create_admin_grant(self, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON *.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def cleanup_grant(self, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("DROP FROM mysql.user WHERE user='{}' "
+                           "AND HOST='{}'".format(db_user,
+                                                  remote_ip))
+        finally:
+            cursor.close()
+
+    def flush_priviledges(self):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("FLUSH PRIVILEGES")
+        finally:
+            cursor.close()
+
+    def execute(self, sql):
+        """Execute arbitary SQL against the database."""
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+        finally:
+            cursor.close()
+
+    def select(self, sql):
+        """
+        Execute arbitrary SQL select query against the database
+        and return the results.
+
+        :param sql: SQL select query to execute
+        :type sql: string
+        :returns: SQL select query result
+        :rtype: list of lists
+        :raises: MySQLdb.Error
+        """
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+            results = [list(i) for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+        return results
+
+    def migrate_passwords_to_leader_storage(self, excludes=None):
+        """Migrate any passwords storage on disk to leader storage."""
+        if not is_leader():
+            log("Skipping password migration as not the lead unit",
+                level=DEBUG)
+            return
+        dirname = os.path.dirname(self.root_passwd_file_template)
+        path = os.path.join(dirname, '*.passwd')
+        for f in glob.glob(path):
+            if excludes and f in excludes:
+                log("Excluding %s from leader storage migration" % (f),
+                    level=DEBUG)
+                continue
+
+            key = os.path.basename(f)
+            with open(f, 'r') as passwd:
+                _value = passwd.read().strip()
+
+            try:
+                leader_set(settings={key: _value})
+
+                if self.delete_ondisk_passwd_file:
+                    os.unlink(f)
+            except ValueError:
+                # NOTE cluster relation not yet ready - skip for now
+                pass
+
+    def get_mysql_password_on_disk(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username on disk."""
+        if username:
+            template = self.user_passwd_file_template
+            passwd_file = template.format(username)
+        else:
+            passwd_file = self.root_passwd_file_template
+
+        _password = None
+        if os.path.exists(passwd_file):
+            log("Using existing password file '%s'" % passwd_file, level=DEBUG)
+            with open(passwd_file, 'r') as passwd:
+                _password = passwd.read().strip()
+        else:
+            log("Generating new password file '%s'" % passwd_file, level=DEBUG)
+            if not os.path.isdir(os.path.dirname(passwd_file)):
+                # NOTE: need to ensure this is not mysql root dir (which needs
+                # to be mysql readable)
+                mkdir(os.path.dirname(passwd_file), owner='root', group='root',
+                      perms=0o770)
+                # Force permissions - for some reason the chmod in makedirs
+                # fails
+                os.chmod(os.path.dirname(passwd_file), 0o770)
+
+            _password = password or pwgen(length=32)
+            write_file(passwd_file, _password, owner='root', group='root',
+                       perms=0o660)
+
+        return _password
+
+    def passwd_keys(self, username):
+        """Generator to return keys used to store passwords in peer store.
+
+        NOTE: we support both legacy and new format to support mysql
+        charm prior to refactor. This is necessary to avoid LP 1451890.
+        """
+        keys = []
+        if username == 'mysql':
+            log("Bad username '%s'" % (username), level=WARNING)
+
+        if username:
+            # IMPORTANT: *newer* format must be returned first
+            keys.append('mysql-%s.passwd' % (username))
+            keys.append('%s.passwd' % (username))
+        else:
+            keys.append('mysql.passwd')
+
+        for key in keys:
+            yield key
+
+    def get_mysql_password(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username using peer relation cluster."""
+        excludes = []
+
+        # First check peer relation.
+        try:
+            for key in self.passwd_keys(username):
+                _password = leader_get(key)
+                if _password:
+                    break
+
+            # If root password available don't update peer relation from local
+            if _password and not username:
+                excludes.append(self.root_passwd_file_template)
+
+        except ValueError:
+            # cluster relation is not yet started; use on-disk
+            _password = None
+
+        # If none available, generate new one
+        if not _password:
+            _password = self.get_mysql_password_on_disk(username, password)
+
+        # Put on wire if required
+        if self.migrate_passwd_to_leader_storage:
+            self.migrate_passwords_to_leader_storage(excludes=excludes)
+
+        return _password
+
+    def get_mysql_root_password(self, password=None):
+        """Retrieve or generate mysql root password for service units."""
+        return self.get_mysql_password(username=None, password=password)
+
+    def set_mysql_password(self, username, password, current_password=None):
+        """Update a mysql password for the provided username changing the
+        leader settings
+
+        To update root's password pass `None` in the username
+
+        :param username: Username to change password of
+        :type username: str
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+
+        if username is None:
+            username = 'root'
+
+        # get root password via leader-get, it may be that in the past (when
+        # changes to root-password were not supported) the user changed the
+        # password, so leader-get is more reliable source than
+        # config.previous('root-password').
+        rel_username = None if username == 'root' else username
+        if not current_password:
+            current_password = self.get_mysql_password(rel_username)
+
+        # password that needs to be set
+        new_passwd = password
+
+        # update password for all users (e.g. root@localhost, root@::1, etc)
+        try:
+            self.connect(user=username, password=current_password)
+            cursor = self.connection.cursor()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using password in '
+                                         'leader settings (%s)') % ex, ex)
+
+        try:
+            # NOTE(freyes): Due to skip-name-resolve root@$HOSTNAME account
+            # fails when using SET PASSWORD so using UPDATE against the
+            # mysql.user table is needed, but changes to this table are not
+            # replicated across the cluster, so this update needs to run in
+            # all the nodes. More info at
+            # http://galeracluster.com/documentation-webpages/userchanges.html
+            release = CompareHostReleases(lsb_release()['DISTRIB_CODENAME'])
+            if release < 'bionic':
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET password = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            else:
+                # PXC 5.7 (introduced in Bionic) uses authentication_string
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET "
+                                     "authentication_string = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            cursor.execute(SQL_UPDATE_PASSWD, (new_passwd, username))
+            cursor.execute('FLUSH PRIVILEGES;')
+            self.connection.commit()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError('Cannot update password: %s' % str(ex),
+                                        ex)
+        finally:
+            cursor.close()
+
+        # check the password was changed
+        try:
+            self.connect(user=username, password=new_passwd)
+            self.execute('select 1;')
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using new password: '
+                                         '%s') % str(ex), ex)
+
+        if not is_leader():
+            log('Only the leader can set a new password in the relation',
+                level=DEBUG)
+            return
+
+        for key in self.passwd_keys(rel_username):
+            _password = leader_get(key)
+            if _password:
+                log('Updating password for %s (%s)' % (key, rel_username),
+                    level=DEBUG)
+                leader_set(settings={key: new_passwd})
+
+    def set_mysql_root_password(self, password, current_password=None):
+        """Update mysql root password changing the leader settings
+
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+        self.set_mysql_password(
+            'root',
+            password,
+            current_password=current_password)
+
+    def normalize_address(self, hostname):
+        """Ensure that address returned is an IP address (i.e. not fqdn)"""
+        if config_get('prefer-ipv6'):
+            # TODO: add support for ipv6 dns
+            return hostname
+
+        if hostname != unit_get('private-address'):
+            return get_host_ip(hostname, fallback=hostname)
+
+        # Otherwise assume localhost
+        return '127.0.0.1'
+
+    def get_allowed_units(self, database, username, relation_id=None):
+        """Get list of units with access grants for database with username.
+
+        This is typically used to provide shared-db relations with a list of
+        which units have been granted access to the given database.
+        """
+        self.connect(password=self.get_mysql_root_password())
+        allowed_units = set()
+        for unit in related_units(relation_id):
+            settings = relation_get(rid=relation_id, unit=unit)
+            # First check for setting with prefix, then without
+            for attr in ["%s_hostname" % (database), 'hostname']:
+                hosts = settings.get(attr, None)
+                if hosts:
+                    break
+
+            if hosts:
+                # hostname can be json-encoded list of hostnames
+                try:
+                    hosts = json.loads(hosts)
+                except ValueError:
+                    hosts = [hosts]
+            else:
+                hosts = [settings['private-address']]
+
+            if hosts:
+                for host in hosts:
+                    host = self.normalize_address(host)
+                    if self.grant_exists(database, username, host):
+                        log("Grant exists for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+                        if unit not in allowed_units:
+                            allowed_units.add(unit)
+                    else:
+                        log("Grant does NOT exist for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+            else:
+                log("No hosts found for grant check", level=INFO)
+
+        return allowed_units
+
+    def configure_db(self, hostname, database, username, admin=False):
+        """Configure access to database for username from hostname."""
+        self.connect(password=self.get_mysql_root_password())
+        if not self.database_exists(database):
+            self.create_database(database)
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        if not self.grant_exists(database, username, remote_ip):
+            if not admin:
+                self.create_grant(database, username, remote_ip, password)
+            else:
+                self.create_admin_grant(username, remote_ip, password)
+            self.flush_priviledges()
+
+        return password
+
+
+# `_singleton_config_helper` stores the instance of the helper class that is
+# being used during a hook invocation.
+_singleton_config_helper = None
+
+
+def get_mysql_config_helper():
+    global _singleton_config_helper
+    if _singleton_config_helper is None:
+        _singleton_config_helper = MySQLConfigHelper()
+    return _singleton_config_helper
+
+
+class MySQLConfigHelper(object):
+    """Base configuration helper for MySQL."""
+
+    # Going for the biggest page size to avoid wasted bytes.
+    # InnoDB page size is 16MB
+
+    DEFAULT_PAGE_SIZE = 16 * 1024 * 1024
+    DEFAULT_INNODB_BUFFER_FACTOR = 0.50
+    DEFAULT_INNODB_BUFFER_SIZE_MAX = 512 * 1024 * 1024
+
+    # Validation and lookups for InnoDB configuration
+    INNODB_VALID_BUFFERING_VALUES = [
+        'none',
+        'inserts',
+        'deletes',
+        'changes',
+        'purges',
+        'all'
+    ]
+    INNODB_FLUSH_CONFIG_VALUES = {
+        'fast': 2,
+        'safest': 1,
+        'unsafe': 0,
+    }
+
+    def human_to_bytes(self, human):
+        """Convert human readable configuration options to bytes."""
+        num_re = re.compile('^[0-9]+$')
+        if num_re.match(human):
+            return human
+
+        factors = {
+            'K': 1024,
+            'M': 1048576,
+            'G': 1073741824,
+            'T': 1099511627776
+        }
+        modifier = human[-1]
+        if modifier in factors:
+            return int(human[:-1]) * factors[modifier]
+
+        if modifier == '%':
+            total_ram = self.human_to_bytes(self.get_mem_total())
+            if self.is_32bit_system() and total_ram > self.sys_mem_limit():
+                total_ram = self.sys_mem_limit()
+            factor = int(human[:-1]) * 0.01
+            pctram = total_ram * factor
+            return int(pctram - (pctram % self.DEFAULT_PAGE_SIZE))
+
+        raise ValueError("Can only convert K,M,G, or T")
+
+    def is_32bit_system(self):
+        """Determine whether system is 32 or 64 bit."""
+        try:
+            return sys.maxsize < 2 ** 32
+        except OverflowError:
+            return False
+
+    def sys_mem_limit(self):
+        """Determine the default memory limit for the current service unit."""
+        if platform.machine() in ['armv7l']:
+            _mem_limit = self.human_to_bytes('2700M')  # experimentally determined
+        else:
+            # Limit for x86 based 32bit systems
+            _mem_limit = self.human_to_bytes('4G')
+
+        return _mem_limit
+
+    def get_mem_total(self):
+        """Calculate the total memory in the current service unit."""
+        with open('/proc/meminfo') as meminfo_file:
+            for line in meminfo_file:
+                key, mem = line.split(':', 2)
+                if key == 'MemTotal':
+                    mtot, modifier = mem.strip().split(' ')
+                    return '%s%s' % (mtot, modifier[0].upper())
+
+    def get_innodb_flush_log_at_trx_commit(self):
+        """Get value for innodb_flush_log_at_trx_commit.
+
+        Use the innodb-flush-log-at-trx-commit or the tunning-level setting
+        translated by INNODB_FLUSH_CONFIG_VALUES to get the
+        innodb_flush_log_at_trx_commit value.
+
+        :returns: Numeric value for innodb_flush_log_at_trx_commit
+        :rtype: Union[None, int]
+        """
+        _iflatc = config_get('innodb-flush-log-at-trx-commit')
+        _tuning_level = config_get('tuning-level')
+        if _iflatc:
+            return _iflatc
+        elif _tuning_level:
+            return self.INNODB_FLUSH_CONFIG_VALUES.get(_tuning_level, 1)
+
+    def get_innodb_change_buffering(self):
+        """Get value for innodb_change_buffering.
+
+        Use the innodb-change-buffering validated against
+        INNODB_VALID_BUFFERING_VALUES to get the innodb_change_buffering value.
+
+        :returns: String value for innodb_change_buffering.
+        :rtype: Union[None, str]
+        """
+        _icb = config_get('innodb-change-buffering')
+        if _icb and _icb in self.INNODB_VALID_BUFFERING_VALUES:
+            return _icb
+
+    def get_innodb_buffer_pool_size(self):
+        """Get value for innodb_buffer_pool_size.
+
+        Return the number value of innodb-buffer-pool-size or dataset-size. If
+        neither is set, calculate a sane default based on total memory.
+
+        :returns: Numeric value for innodb_buffer_pool_size.
+        :rtype: int
+        """
+        total_memory = self.human_to_bytes(self.get_mem_total())
+
+        dataset_bytes = config_get('dataset-size')
+        innodb_buffer_pool_size = config_get('innodb-buffer-pool-size')
+
+        if innodb_buffer_pool_size:
+            innodb_buffer_pool_size = self.human_to_bytes(
+                innodb_buffer_pool_size)
+        elif dataset_bytes:
+            log("Option 'dataset-size' has been deprecated, please use"
+                "innodb_buffer_pool_size option instead", level="WARN")
+            innodb_buffer_pool_size = self.human_to_bytes(
+                dataset_bytes)
+        else:
+            # NOTE(jamespage): pick the smallest of 50% of RAM or 512MB
+            #                  to ensure that deployments in containers
+            #                  without constraints don't try to consume
+            #                  silly amounts of memory.
+            innodb_buffer_pool_size = min(
+                int(total_memory * self.DEFAULT_INNODB_BUFFER_FACTOR),
+                self.DEFAULT_INNODB_BUFFER_SIZE_MAX
+            )
+
+        if innodb_buffer_pool_size > total_memory:
+            log("innodb_buffer_pool_size; {} is greater than system available memory:{}".format(
+                innodb_buffer_pool_size,
+                total_memory), level='WARN')
+
+        return innodb_buffer_pool_size
+
+
+class PerconaClusterHelper(MySQLConfigHelper):
+    """Percona-cluster specific configuration helper."""
+
+    def parse_config(self):
+        """Parse charm configuration and calculate values for config files."""
+        config = config_get()
+        mysql_config = {}
+        if 'max-connections' in config:
+            mysql_config['max_connections'] = config['max-connections']
+
+        if 'wait-timeout' in config:
+            mysql_config['wait_timeout'] = config['wait-timeout']
+
+        if self.get_innodb_flush_log_at_trx_commit() is not None:
+            mysql_config['innodb_flush_log_at_trx_commit'] = \
+                self.get_innodb_flush_log_at_trx_commit()
+
+        if self.get_innodb_change_buffering() is not None:
+            mysql_config['innodb_change_buffering'] = config['innodb-change-buffering']
+
+        if 'innodb-io-capacity' in config:
+            mysql_config['innodb_io_capacity'] = config['innodb-io-capacity']
+
+        # Set a sane default key_buffer size
+        mysql_config['key_buffer'] = self.human_to_bytes('32M')
+        mysql_config['innodb_buffer_pool_size'] = self.get_innodb_buffer_pool_size()
+        return mysql_config
+
+
+class MySQL8Helper(MySQLHelper):
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = ("GRANT ALL PRIVILEGES ON {}.* "
+                       "TO {}@{}".format(db_name, db_user, remote_ip))
+        try:
+            cursor.execute("SHOW GRANTS FOR '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # Different versions of MySQL use ' or `. Ignore these in the check.
+        return priv_string in [
+            i.replace("'", "").replace("`", "") for i in grants]
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        if self.grant_exists(db_name, db_user, remote_ip):
+            return
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}'"
+                           .format(db_name, db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def create_user(self, db_user, remote_ip, password):
+
+        SQL_USER_CREATE = (
+            "CREATE USER '{db_user}'@'{remote_ip}' "
+            "IDENTIFIED BY '{password}'")
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(SQL_USER_CREATE.format(
+                db_user=db_user,
+                remote_ip=remote_ip,
+                password=password)
+            )
+        except MySQLdb._exceptions.OperationalError:
+            log("DB user {} already exists.".format(db_user),
+                "WARNING")
+        finally:
+            cursor.close()
+
+    def create_router_grant(self, db_user, remote_ip, password):
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        # Mysql-Router specific grants
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT CREATE USER ON *.* TO '{}'@'{}' WITH GRANT "
+                           "OPTION".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT, INSERT, UPDATE, DELETE, EXECUTE ON "
+                           "mysql_innodb_cluster_metadata.* TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON mysql.user TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_members "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_member_stats "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.global_variables "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def configure_router(self, hostname, username):
+
+        if self.connection is None:
+            self.connect(password=self.get_mysql_root_password())
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        self.create_user(username, remote_ip, password)
+        self.create_router_grant(username, remote_ip, password)
+
+        return password
+
+
+def get_prefix(requested, keys=None):
+    """Return existing prefix or None.
+
+    :param requested: Request string. i.e. novacell0_username
+    :type requested: str
+    :param keys: Keys to determine prefix. Defaults set in function.
+    :type keys: List of str keys
+    :returns: String prefix i.e. novacell0
+    :rtype: Union[None, str]
+    """
+    if keys is None:
+        # Shared-DB default keys
+        keys = ["_database", "_username", "_hostname"]
+    for key in keys:
+        if requested.endswith(key):
+            return requested[:-len(key)]
+
+
+def get_db_data(relation_data, unprefixed):
+    """Organize database requests into a collections.OrderedDict
+
+    :param relation_data: shared-db relation data
+    :type relation_data: dict
+    :param unprefixed: Prefix to use for requests without a prefix. This should
+                       be unique for each side of the relation to avoid
+                       conflicts.
+    :type unprefixed: str
+    :returns: Order dict of databases and users
+    :rtype: collections.OrderedDict
+    """
+    # Deep copy to avoid unintentionally changing relation data
+    settings = copy.deepcopy(relation_data)
+    databases = collections.OrderedDict()
+
+    # Clear non-db related elements
+    if "egress-subnets" in settings.keys():
+        settings.pop("egress-subnets")
+    if "ingress-address" in settings.keys():
+        settings.pop("ingress-address")
+    if "private-address" in settings.keys():
+        settings.pop("private-address")
+
+    singleset = {"database", "username", "hostname"}
+    if singleset.issubset(settings):
+        settings["{}_{}".format(unprefixed, "hostname")] = (
+            settings["hostname"])
+        settings.pop("hostname")
+        settings["{}_{}".format(unprefixed, "database")] = (
+            settings["database"])
+        settings.pop("database")
+        settings["{}_{}".format(unprefixed, "username")] = (
+            settings["username"])
+        settings.pop("username")
+
+    for k, v in settings.items():
+        db = k.split("_")[0]
+        x = "_".join(k.split("_")[1:])
+        if db not in databases:
+            databases[db] = collections.OrderedDict()
+        databases[db][x] = v
+
+    return databases
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c1e371e179bb6926f227331f86cb14a38c229a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/apache.py
@@ -0,0 +1,86 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import os
+
+from charmhelpers.core import host
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    relation_ids,
+    related_units as relation_list,
+    log,
+    INFO,
+)
+
+
+def get_cert(cn=None):
+    # TODO: deal with multiple https endpoints via charm config
+    cert = config_get('ssl_cert')
+    key = config_get('ssl_key')
+    if not (cert and key):
+        log("Inspecting identity-service relations for SSL certificate.",
+            level=INFO)
+        cert = key = None
+        if cn:
+            ssl_cert_attr = 'ssl_cert_{}'.format(cn)
+            ssl_key_attr = 'ssl_key_{}'.format(cn)
+        else:
+            ssl_cert_attr = 'ssl_cert'
+            ssl_key_attr = 'ssl_key'
+        for r_id in relation_ids('identity-service'):
+            for unit in relation_list(r_id):
+                if not cert:
+                    cert = relation_get(ssl_cert_attr,
+                                        rid=r_id, unit=unit)
+                if not key:
+                    key = relation_get(ssl_key_attr,
+                                       rid=r_id, unit=unit)
+    return (cert, key)
+
+
+def get_ca_cert():
+    ca_cert = config_get('ssl_ca')
+    if ca_cert is None:
+        log("Inspecting identity-service relations for CA SSL certificate.",
+            level=INFO)
+        for r_id in (relation_ids('identity-service') +
+                     relation_ids('identity-credentials')):
+            for unit in relation_list(r_id):
+                if ca_cert is None:
+                    ca_cert = relation_get('ca_cert',
+                                           rid=r_id, unit=unit)
+    return ca_cert
+
+
+def retrieve_ca_cert(cert_file):
+    cert = None
+    if os.path.isfile(cert_file):
+        with open(cert_file, 'rb') as crt:
+            cert = crt.read()
+    return cert
+
+
+def install_ca_cert(ca_cert):
+    host.install_ca_cert(ca_cert, 'keystone_juju_ca_cert')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba34fba0cafa21d15a6a27946544b2c99fbd3663
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hahelpers/cluster.py
@@ -0,0 +1,451 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+"""
+Helpers for clustering and determining "cluster leadership" and other
+clustering-related helpers.
+"""
+
+import functools
+import subprocess
+import os
+import time
+
+from socket import gethostname as get_unit_hostname
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    relation_ids,
+    related_units as relation_list,
+    relation_get,
+    config as config_get,
+    INFO,
+    DEBUG,
+    WARNING,
+    unit_get,
+    is_leader as juju_is_leader,
+    status_set,
+)
+from charmhelpers.core.host import (
+    modulo_distribution,
+)
+from charmhelpers.core.decorators import (
+    retry_on_exception,
+)
+from charmhelpers.core.strutils import (
+    bool_from_string,
+)
+
+DC_RESOURCE_NAME = 'DC'
+
+
+class HAIncompleteConfig(Exception):
+    pass
+
+
+class HAIncorrectConfig(Exception):
+    pass
+
+
+class CRMResourceNotFound(Exception):
+    pass
+
+
+class CRMDCNotFound(Exception):
+    pass
+
+
+def is_elected_leader(resource):
+    """
+    Returns True if the charm executing this is the elected cluster leader.
+
+    It relies on two mechanisms to determine leadership:
+        1. If juju is sufficiently new and leadership election is supported,
+        the is_leader command will be used.
+        2. If the charm is part of a corosync cluster, call corosync to
+        determine leadership.
+        3. If the charm is not part of a corosync cluster, the leader is
+        determined as being "the alive unit with the lowest unit numer". In
+        other words, the oldest surviving unit.
+    """
+    try:
+        return juju_is_leader()
+    except NotImplementedError:
+        log('Juju leadership election feature not enabled'
+            ', using fallback support',
+            level=WARNING)
+
+    if is_clustered():
+        if not is_crm_leader(resource):
+            log('Deferring action to CRM leader.', level=INFO)
+            return False
+    else:
+        peers = peer_units()
+        if peers and not oldest_peer(peers):
+            log('Deferring action to oldest service unit.', level=INFO)
+            return False
+    return True
+
+
+def is_clustered():
+    for r_id in (relation_ids('ha') or []):
+        for unit in (relation_list(r_id) or []):
+            clustered = relation_get('clustered',
+                                     rid=r_id,
+                                     unit=unit)
+            if clustered:
+                return True
+    return False
+
+
+def is_crm_dc():
+    """
+    Determine leadership by querying the pacemaker Designated Controller
+    """
+    cmd = ['crm', 'status']
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError as ex:
+        raise CRMDCNotFound(str(ex))
+
+    current_dc = ''
+    for line in status.split('\n'):
+        if line.startswith('Current DC'):
+            # Current DC: juju-lytrusty-machine-2 (168108163) - partition with quorum
+            current_dc = line.split(':')[1].split()[0]
+    if current_dc == get_unit_hostname():
+        return True
+    elif current_dc == 'NONE':
+        raise CRMDCNotFound('Current DC: NONE')
+
+    return False
+
+
+@retry_on_exception(5, base_delay=2,
+                    exc_type=(CRMResourceNotFound, CRMDCNotFound))
+def is_crm_leader(resource, retry=False):
+    """
+    Returns True if the charm calling this is the elected corosync leader,
+    as returned by calling the external "crm" command.
+
+    We allow this operation to be retried to avoid the possibility of getting a
+    false negative. See LP #1396246 for more info.
+    """
+    if resource == DC_RESOURCE_NAME:
+        return is_crm_dc()
+    cmd = ['crm', 'resource', 'show', resource]
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError:
+        status = None
+
+    if status and get_unit_hostname() in status:
+        return True
+
+    if status and "resource %s is NOT running" % (resource) in status:
+        raise CRMResourceNotFound("CRM resource %s not found" % (resource))
+
+    return False
+
+
+def is_leader(resource):
+    log("is_leader is deprecated. Please consider using is_crm_leader "
+        "instead.", level=WARNING)
+    return is_crm_leader(resource)
+
+
+def peer_units(peer_relation="cluster"):
+    peers = []
+    for r_id in (relation_ids(peer_relation) or []):
+        for unit in (relation_list(r_id) or []):
+            peers.append(unit)
+    return peers
+
+
+def peer_ips(peer_relation='cluster', addr_key='private-address'):
+    '''Return a dict of peers and their private-address'''
+    peers = {}
+    for r_id in relation_ids(peer_relation):
+        for unit in relation_list(r_id):
+            peers[unit] = relation_get(addr_key, rid=r_id, unit=unit)
+    return peers
+
+
+def oldest_peer(peers):
+    """Determines who the oldest peer is by comparing unit numbers."""
+    local_unit_no = int(os.getenv('JUJU_UNIT_NAME').split('/')[1])
+    for peer in peers:
+        remote_unit_no = int(peer.split('/')[1])
+        if remote_unit_no < local_unit_no:
+            return False
+    return True
+
+
+def eligible_leader(resource):
+    log("eligible_leader is deprecated. Please consider using "
+        "is_elected_leader instead.", level=WARNING)
+    return is_elected_leader(resource)
+
+
+def https():
+    '''
+    Determines whether enough data has been provided in configuration
+    or relation data to configure HTTPS
+    .
+    returns: boolean
+    '''
+    use_https = config_get('use-https')
+    if use_https and bool_from_string(use_https):
+        return True
+    if config_get('ssl_cert') and config_get('ssl_key'):
+        return True
+    for r_id in relation_ids('certificates'):
+        for unit in relation_list(r_id):
+            ca = relation_get('ca', rid=r_id, unit=unit)
+            if ca:
+                return True
+    for r_id in relation_ids('identity-service'):
+        for unit in relation_list(r_id):
+            # TODO - needs fixing for new helper as ssl_cert/key suffixes with CN
+            rel_state = [
+                relation_get('https_keystone', rid=r_id, unit=unit),
+                relation_get('ca_cert', rid=r_id, unit=unit),
+            ]
+            # NOTE: works around (LP: #1203241)
+            if (None not in rel_state) and ('' not in rel_state):
+                return True
+    return False
+
+
+def determine_api_port(public_port, singlenode_mode=False):
+    '''
+    Determine correct API server listening port based on
+    existence of HTTPS reverse proxy and/or haproxy.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the API service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    if https():
+        i += 1
+    return public_port - (i * 10)
+
+
+def determine_apache_port(public_port, singlenode_mode=False):
+    '''
+    Description: Determine correct apache listening port based on public IP +
+    state of the cluster.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the HAProxy service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    return public_port - (i * 10)
+
+
+determine_apache_port_single = functools.partial(
+    determine_apache_port, singlenode_mode=True)
+
+
+def get_hacluster_config(exclude_keys=None):
+    '''
+    Obtains all relevant configuration from charm configuration required
+    for initiating a relation to hacluster:
+
+        ha-bindiface, ha-mcastport, vip, os-internal-hostname,
+        os-admin-hostname, os-public-hostname, os-access-hostname
+
+    param: exclude_keys: list of setting key(s) to be excluded.
+    returns: dict: A dict containing settings keyed by setting name.
+    raises: HAIncompleteConfig if settings are missing or incorrect.
+    '''
+    settings = ['ha-bindiface', 'ha-mcastport', 'vip', 'os-internal-hostname',
+                'os-admin-hostname', 'os-public-hostname', 'os-access-hostname']
+    conf = {}
+    for setting in settings:
+        if exclude_keys and setting in exclude_keys:
+            continue
+
+        conf[setting] = config_get(setting)
+
+    if not valid_hacluster_config():
+        raise HAIncorrectConfig('Insufficient or incorrect config data to '
+                                'configure hacluster.')
+    return conf
+
+
+def valid_hacluster_config():
+    '''
+    Check that either vip or dns-ha is set. If dns-ha then one of os-*-hostname
+    must be set.
+
+    Note: ha-bindiface and ha-macastport both have defaults and will always
+    be set. We only care that either vip or dns-ha is set.
+
+    :returns: boolean: valid config returns true.
+    raises: HAIncompatibileConfig if settings conflict.
+    raises: HAIncompleteConfig if settings are missing.
+    '''
+    vip = config_get('vip')
+    dns = config_get('dns-ha')
+    if not(bool(vip) ^ bool(dns)):
+        msg = ('HA: Either vip or dns-ha must be set but not both in order to '
+               'use high availability')
+        status_set('blocked', msg)
+        raise HAIncorrectConfig(msg)
+
+    # If dns-ha then one of os-*-hostname must be set
+    if dns:
+        dns_settings = ['os-internal-hostname', 'os-admin-hostname',
+                        'os-public-hostname', 'os-access-hostname']
+        # At this point it is unknown if one or all of the possible
+        # network spaces are in HA. Validate at least one is set which is
+        # the minimum required.
+        for setting in dns_settings:
+            if config_get(setting):
+                log('DNS HA: At least one hostname is set {}: {}'
+                    ''.format(setting, config_get(setting)),
+                    level=DEBUG)
+                return True
+
+        msg = ('DNS HA: At least one os-*-hostname(s) must be set to use '
+               'DNS HA')
+        status_set('blocked', msg)
+        raise HAIncompleteConfig(msg)
+
+    log('VIP HA: VIP is set {}'.format(vip), level=DEBUG)
+    return True
+
+
+def canonical_url(configs, vip_setting='vip'):
+    '''
+    Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration and hacluster.
+
+    :configs    : OSTemplateRenderer: A config tempating object to inspect for
+                                      a complete https context.
+
+    :vip_setting:                str: Setting in charm config that specifies
+                                      VIP address.
+    '''
+    scheme = 'http'
+    if 'https' in configs.complete_contexts():
+        scheme = 'https'
+    if is_clustered():
+        addr = config_get(vip_setting)
+    else:
+        addr = unit_get('private-address')
+    return '%s://%s' % (scheme, addr)
+
+
+def distributed_wait(modulo=None, wait=None, operation_name='operation'):
+    ''' Distribute operations by waiting based on modulo_distribution
+
+    If modulo and or wait are not set, check config_get for those values.
+    If config values are not set, default to modulo=3 and wait=30.
+
+    :param modulo: int The modulo number creates the group distribution
+    :param wait: int The constant time wait value
+    :param operation_name: string Operation name for status message
+                           i.e.  'restart'
+    :side effect: Calls config_get()
+    :side effect: Calls log()
+    :side effect: Calls status_set()
+    :side effect: Calls time.sleep()
+    '''
+    if modulo is None:
+        modulo = config_get('modulo-nodes') or 3
+    if wait is None:
+        wait = config_get('known-wait') or 30
+    if juju_is_leader():
+        # The leader should never wait
+        calculated_wait = 0
+    else:
+        # non_zero_wait=True guarantees the non-leader who gets modulo 0
+        # will still wait
+        calculated_wait = modulo_distribution(modulo=modulo, wait=wait,
+                                              non_zero_wait=True)
+    msg = "Waiting {} seconds for {} ...".format(calculated_wait,
+                                                 operation_name)
+    log(msg, DEBUG)
+    status_set('maintenance', msg)
+    time.sleep(calculated_wait)
+
+
+def get_managed_services_and_ports(services, external_ports,
+                                   external_services=None,
+                                   port_conv_f=determine_apache_port_single):
+    """Get the services and ports managed by this charm.
+
+    Return only the services and corresponding ports that are managed by this
+    charm. This excludes haproxy when there is a relation with hacluster. This
+    is because this charm passes responsability for stopping and starting
+    haproxy to hacluster.
+
+    Similarly, if a relation with hacluster exists then the ports returned by
+    this method correspond to those managed by the apache server rather than
+    haproxy.
+
+    :param services: List of services.
+    :type services: List[str]
+    :param external_ports: List of ports managed by external services.
+    :type external_ports: List[int]
+    :param external_services: List of services to be removed if ha relation is
+                              present.
+    :type external_services: List[str]
+    :param port_conv_f: Function to apply to ports to calculate the ports
+                        managed by services controlled by this charm.
+    :type port_convert_func: f()
+    :returns: A tuple containing a list of services first followed by a list of
+              ports.
+    :rtype: Tuple[List[str], List[int]]
+    """
+    if external_services is None:
+        external_services = ['haproxy']
+    if relation_ids('ha'):
+        for svc in external_services:
+            try:
+                services.remove(svc)
+            except ValueError:
+                pass
+        external_ports = [port_conv_f(p) for p in external_ports]
+    return services, external_ports
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/README.hardening.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/README.hardening.md
new file mode 100644
index 0000000000000000000000000000000000000000..91280c03e6d7b5d75b356cd94614fc821abc2644
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/README.hardening.md
@@ -0,0 +1,38 @@
+# Juju charm-helpers hardening library
+
+## Description
+
+This library provides multiple implementations of system and application
+hardening that conform to the standards of http://hardening.io/.
+
+Current implementations include:
+
+ * OS
+ * SSH
+ * MySQL
+ * Apache
+
+## Requirements
+
+* Juju Charms
+
+## Usage
+
+1. Synchronise this library into your charm and add the harden() decorator
+   (from contrib.hardening.harden) to any functions or methods you want to use
+   to trigger hardening of your application/system.
+
+2. Add a config option called 'harden' to your charm config.yaml and set it to
+   a space-delimited list of hardening modules you want to run e.g. "os ssh"
+
+3. Override any config defaults (contrib.hardening.defaults) by adding a file
+   called hardening.yaml to your charm root containing the name(s) of the
+   modules whose settings you want override at root level and then any settings
+   with overrides e.g.
+   
+   os:
+       general:
+            desktop_enable: True
+
+4. Now just run your charm as usual and hardening will be applied each time the
+   hook runs.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..30a3e94359e94011cd247de7ade76667346e7379
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3bc2ebd4760124e23c128868e098aceac610260f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.apache.checks import config
+
+
+def run_apache_checks():
+    log("Starting Apache hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("Apache hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..341da9eee10f73cbe3d7e7e5cf91b57b4d2a89b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/checks/config.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+import six
+import subprocess
+
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    NoReadWriteForOther,
+    TemplatedFile,
+    DeletedFile
+)
+from charmhelpers.contrib.hardening.audits.apache import DisabledModuleAudit
+from charmhelpers.contrib.hardening.apache import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get Apache hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'apache2'], stdout=subprocess.PIPE) != 0:
+        log("Apache server does not appear to be installed on this node - "
+            "skipping apache hardening", level=INFO)
+        return []
+
+    context = ApacheConfContext()
+    settings = utils.get_settings('apache')
+    audits = [
+        FilePermissionAudit(paths=os.path.join(
+                            settings['common']['apache_dir'], 'apache2.conf'),
+                            user='root', group='root', mode=0o0640),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'mods-available/alias.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'conf-enabled/99-hardening.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        DirectoryPermissionAudit(settings['common']['apache_dir'],
+                                 user='root',
+                                 group='root',
+                                 mode=0o0750),
+
+        DisabledModuleAudit(settings['hardening']['modules_to_disable']),
+
+        NoReadWriteForOther(settings['common']['apache_dir']),
+
+        DeletedFile(['/var/www/html/index.html'])
+    ]
+
+    return audits
+
+
+class ApacheConfContext(object):
+    """Defines the set of key/value pairs to set in a apache config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/apache/conf-enabled/hardening.conf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('apache')
+        ctxt = settings['hardening']
+
+        out = subprocess.check_output(['apache2', '-v'])
+        if six.PY3:
+            out = out.decode('utf-8')
+        ctxt['apache_version'] = re.search(r'.+version: Apache/(.+?)\s.+',
+                                           out).group(1)
+        ctxt['apache_icondir'] = '/usr/share/apache2/icons/'
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..22b68041d50ff753284bbb4b41a21e8f2bd8c18a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
@@ -0,0 +1,32 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+
+<Location / >
+  <LimitExcept {{ allowed_http_methods }} >
+    # http://httpd.apache.org/docs/2.4/upgrading.html
+    {% if apache_version > '2.2' -%}
+    Require all granted
+    {% else -%}
+    Order Allow,Deny
+    Deny from all
+    {% endif %}
+  </LimitExcept>
+</Location>
+
+<Directory />
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+<Directory /var/www/>
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+TraceEnable {{ traceenable }}
+ServerTokens {{ servertokens }}
+
+SSLHonorCipherOrder {{ honor_cipher_order }}
+SSLCipherSuite {{ cipher_suite }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf
new file mode 100644
index 0000000000000000000000000000000000000000..e46a58a30dadbb6ccffa02d82593c63a9cbf52df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/apache/templates/alias.conf
@@ -0,0 +1,31 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+<IfModule alias_module>
+  #
+  # Aliases: Add here as many aliases as you need (with no limit). The format is
+  # Alias fakename realname
+  #
+  # Note that if you include a trailing / on fakename then the server will
+  # require it to be present in the URL.  So "/icons" isn't aliased in this
+  # example, only "/icons/".  If the fakename is slash-terminated, then the
+  # realname must also be slash terminated, and if the fakename omits the
+  # trailing slash, the realname must also omit it.
+  #
+  # We include the /icons/ alias for FancyIndexed directory listings.  If
+  # you do not use FancyIndexing, you may comment this out.
+  #
+  Alias /icons/ "{{ apache_icondir }}/"
+
+  <Directory "{{ apache_icondir }}">
+    Options -Indexes -MultiViews -FollowSymLinks
+    AllowOverride None
+{% if apache_version == '2.4' -%}
+    Require all granted
+{% else -%}
+    Order allow,deny
+    Allow from all
+{% endif %}
+  </Directory>
+</IfModule>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dd5b05fec4ffcfcdb4378a06dfda4e8ac7e8371
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/__init__.py
@@ -0,0 +1,54 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class BaseAudit(object):  # NO-QA
+    """Base class for hardening checks.
+
+    The lifecycle of a hardening check is to first check to see if the system
+    is in compliance for the specified check. If it is not in compliance, the
+    check method will return a value which will be supplied to the.
+    """
+    def __init__(self, *args, **kwargs):
+        self.unless = kwargs.get('unless', None)
+        super(BaseAudit, self).__init__()
+
+    def ensure_compliance(self):
+        """Checks to see if the current hardening check is in compliance or
+        not.
+
+        If the check that is performed is not in compliance, then an exception
+        should be raised.
+        """
+        pass
+
+    def _take_action(self):
+        """Determines whether to perform the action or not.
+
+        Checks whether or not an action should be taken. This is determined by
+        the truthy value for the unless parameter. If unless is a callback
+        method, it will be invoked with no parameters in order to determine
+        whether or not the action should be taken. Otherwise, the truthy value
+        of the unless attribute will determine if the action should be
+        performed.
+        """
+        # Do the action if there isn't an unless override.
+        if self.unless is None:
+            return True
+
+        # Invoke the callback if there is one.
+        if hasattr(self.unless, '__call__'):
+            return not self.unless()
+
+        return not self.unless
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..04825f5ada0c5b0bb9fc0955baa9a10fa199184d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apache.py
@@ -0,0 +1,100 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    ERROR,
+)
+
+from charmhelpers.contrib.hardening.audits import BaseAudit
+
+
+class DisabledModuleAudit(BaseAudit):
+    """Audits Apache2 modules.
+
+    Determines if the apache2 modules are enabled. If the modules are enabled
+    then they are removed in the ensure_compliance.
+    """
+    def __init__(self, modules):
+        if modules is None:
+            self.modules = []
+        elif isinstance(modules, six.string_types):
+            self.modules = [modules]
+        else:
+            self.modules = modules
+
+    def ensure_compliance(self):
+        """Ensures that the modules are not loaded."""
+        if not self.modules:
+            return
+
+        try:
+            loaded_modules = self._get_loaded_modules()
+            non_compliant_modules = []
+            for module in self.modules:
+                if module in loaded_modules:
+                    log("Module '%s' is enabled but should not be." %
+                        (module), level=INFO)
+                    non_compliant_modules.append(module)
+
+            if len(non_compliant_modules) == 0:
+                return
+
+            for module in non_compliant_modules:
+                self._disable_module(module)
+            self._restart_apache()
+        except subprocess.CalledProcessError as e:
+            log('Error occurred auditing apache module compliance. '
+                'This may have been already reported. '
+                'Output is: %s' % e.output, level=ERROR)
+
+    @staticmethod
+    def _get_loaded_modules():
+        """Returns the modules which are enabled in Apache."""
+        output = subprocess.check_output(['apache2ctl', '-M'])
+        if six.PY3:
+            output = output.decode('utf-8')
+        modules = []
+        for line in output.splitlines():
+            # Each line of the enabled module output looks like:
+            #  module_name (static|shared)
+            # Plus a header line at the top of the output which is stripped
+            # out by the regex.
+            matcher = re.search(r'^ (\S*)_module (\S*)', line)
+            if matcher:
+                modules.append(matcher.group(1))
+        return modules
+
+    @staticmethod
+    def _disable_module(module):
+        """Disables the specified module in Apache."""
+        try:
+            subprocess.check_call(['a2dismod', module])
+        except subprocess.CalledProcessError as e:
+            # Note: catch error here to allow the attempt of disabling
+            # multiple modules in one go rather than failing after the
+            # first module fails.
+            log('Error occurred disabling module %s. '
+                'Output is: %s' % (module, e.output), level=ERROR)
+
+    @staticmethod
+    def _restart_apache():
+        """Restarts the apache process"""
+        subprocess.check_output(['service', 'apache2', 'restart'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..cad7bf7376d6f22ce8feccd843b070c399887aa9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/apt.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import  # required for external apt import
+from six import string_types
+
+from charmhelpers.fetch import (
+    apt_cache,
+    apt_purge
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.fetch import ubuntu_apt_pkg as apt_pkg
+
+
+class AptConfig(BaseAudit):
+
+    def __init__(self, config, **kwargs):
+        self.config = config
+
+    def verify_config(self):
+        apt_pkg.init()
+        for cfg in self.config:
+            value = apt_pkg.config.get(cfg['key'], cfg.get('default', ''))
+            if value and value != cfg['expected']:
+                log("APT config '%s' has unexpected value '%s' "
+                    "(expected='%s')" %
+                    (cfg['key'], value, cfg['expected']), level=WARNING)
+
+    def ensure_compliance(self):
+        self.verify_config()
+
+
+class RestrictedPackages(BaseAudit):
+    """Class used to audit restricted packages on the system."""
+
+    def __init__(self, pkgs, **kwargs):
+        super(RestrictedPackages, self).__init__(**kwargs)
+        if isinstance(pkgs, string_types) or not hasattr(pkgs, '__iter__'):
+            self.pkgs = pkgs.split()
+        else:
+            self.pkgs = pkgs
+
+    def ensure_compliance(self):
+        cache = apt_cache()
+
+        for p in self.pkgs:
+            if p not in cache:
+                continue
+
+            pkg = cache[p]
+            if not self.is_virtual_package(pkg):
+                if not pkg.current_ver:
+                    log("Package '%s' is not installed." % pkg.name,
+                        level=DEBUG)
+                    continue
+                else:
+                    log("Restricted package '%s' is installed" % pkg.name,
+                        level=WARNING)
+                    self.delete_package(cache, pkg)
+            else:
+                log("Checking restricted virtual package '%s' provides" %
+                    pkg.name, level=DEBUG)
+                self.delete_package(cache, pkg)
+
+    def delete_package(self, cache, pkg):
+        """Deletes the package from the system.
+
+        Deletes the package form the system, properly handling virtual
+        packages.
+
+        :param cache: the apt cache
+        :param pkg: the package to remove
+        """
+        if self.is_virtual_package(pkg):
+            log("Package '%s' appears to be virtual - purging provides" %
+                pkg.name, level=DEBUG)
+            for _p in pkg.provides_list:
+                self.delete_package(cache, _p[2].parent_pkg)
+        elif not pkg.current_ver:
+            log("Package '%s' not installed" % pkg.name, level=DEBUG)
+            return
+        else:
+            log("Purging package '%s'" % pkg.name, level=DEBUG)
+            apt_purge(pkg.name)
+
+    def is_virtual_package(self, pkg):
+        return (pkg.get('has_provides', False) and
+                not pkg.get('has_versions', False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/file.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..257c6351a0b0d244273013faef913f52349f2486
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/audits/file.py
@@ -0,0 +1,550 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import grp
+import os
+import pwd
+import re
+
+from subprocess import (
+    CalledProcessError,
+    check_output,
+    check_call,
+)
+from traceback import format_exc
+from six import string_types
+from stat import (
+    S_ISGID,
+    S_ISUID
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core import unitdata
+from charmhelpers.core.host import file_hash
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.contrib.hardening.templating import (
+    get_template_path,
+    render_and_write,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+class BaseFileAudit(BaseAudit):
+    """Base class for file audits.
+
+    Provides api stubs for compliance check flow that must be used by any class
+    that implemented this one.
+    """
+
+    def __init__(self, paths, always_comply=False, *args, **kwargs):
+        """
+        :param paths: string path of list of paths of files we want to apply
+                      compliance checks are criteria to.
+        :param always_comply: if true compliance criteria is always applied
+                              else compliance is skipped for non-existent
+                              paths.
+        """
+        super(BaseFileAudit, self).__init__(*args, **kwargs)
+        self.always_comply = always_comply
+        if isinstance(paths, string_types) or not hasattr(paths, '__iter__'):
+            self.paths = [paths]
+        else:
+            self.paths = paths
+
+    def ensure_compliance(self):
+        """Ensure that the all registered files comply to registered criteria.
+        """
+        for p in self.paths:
+            if os.path.exists(p):
+                if self.is_compliant(p):
+                    continue
+
+                log('File %s is not in compliance.' % p, level=INFO)
+            else:
+                if not self.always_comply:
+                    log("Non-existent path '%s' - skipping compliance check"
+                        % (p), level=INFO)
+                    continue
+
+            if self._take_action():
+                log("Applying compliance criteria to '%s'" % (p), level=INFO)
+                self.comply(p)
+
+    def is_compliant(self, path):
+        """Audits the path to see if it is compliance.
+
+        :param path: the path to the file that should be checked.
+        """
+        raise NotImplementedError
+
+    def comply(self, path):
+        """Enforces the compliance of a path.
+
+        :param path: the path to the file that should be enforced.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def _get_stat(cls, path):
+        """Returns the Posix st_stat information for the specified file path.
+
+        :param path: the path to get the st_stat information for.
+        :returns: an st_stat object for the path or None if the path doesn't
+                  exist.
+        """
+        return os.stat(path)
+
+
+class FilePermissionAudit(BaseFileAudit):
+    """Implements an audit for file permissions and ownership for a user.
+
+    This class implements functionality that ensures that a specific user/group
+    will own the file(s) specified and that the permissions specified are
+    applied properly to the file.
+    """
+    def __init__(self, paths, user, group=None, mode=0o600, **kwargs):
+        self.user = user
+        self.group = group
+        self.mode = mode
+        super(FilePermissionAudit, self).__init__(paths, user, group, mode,
+                                                  **kwargs)
+
+    @property
+    def user(self):
+        return self._user
+
+    @user.setter
+    def user(self, name):
+        try:
+            user = pwd.getpwnam(name)
+        except KeyError:
+            log('Unknown user %s' % name, level=ERROR)
+            user = None
+        self._user = user
+
+    @property
+    def group(self):
+        return self._group
+
+    @group.setter
+    def group(self, name):
+        try:
+            group = None
+            if name:
+                group = grp.getgrnam(name)
+            else:
+                group = grp.getgrgid(self.user.pw_gid)
+        except KeyError:
+            log('Unknown group %s' % name, level=ERROR)
+        self._group = group
+
+    def is_compliant(self, path):
+        """Checks if the path is in compliance.
+
+        Used to determine if the path specified meets the necessary
+        requirements to be in compliance with the check itself.
+
+        :param path: the file path to check
+        :returns: True if the path is compliant, False otherwise.
+        """
+        stat = self._get_stat(path)
+        user = self.user
+        group = self.group
+
+        compliant = True
+        if stat.st_uid != user.pw_uid or stat.st_gid != group.gr_gid:
+            log('File %s is not owned by %s:%s.' % (path, user.pw_name,
+                                                    group.gr_name),
+                level=INFO)
+            compliant = False
+
+        # POSIX refers to the st_mode bits as corresponding to both the
+        # file type and file permission bits, where the least significant 12
+        # bits (o7777) are the suid (11), sgid (10), sticky bits (9), and the
+        # file permission bits (8-0)
+        perms = stat.st_mode & 0o7777
+        if perms != self.mode:
+            log('File %s has incorrect permissions, currently set to %s' %
+                (path, oct(stat.st_mode & 0o7777)), level=INFO)
+            compliant = False
+
+        return compliant
+
+    def comply(self, path):
+        """Issues a chown and chmod to the file paths specified."""
+        utils.ensure_permissions(path, self.user.pw_name, self.group.gr_name,
+                                 self.mode)
+
+
+class DirectoryPermissionAudit(FilePermissionAudit):
+    """Performs a permission check for the  specified directory path."""
+
+    def __init__(self, paths, user, group=None, mode=0o600,
+                 recursive=True, **kwargs):
+        super(DirectoryPermissionAudit, self).__init__(paths, user, group,
+                                                       mode, **kwargs)
+        self.recursive = recursive
+
+    def is_compliant(self, path):
+        """Checks if the directory is compliant.
+
+        Used to determine if the path specified and all of its children
+        directories are in compliance with the check itself.
+
+        :param path: the directory path to check
+        :returns: True if the directory tree is compliant, otherwise False.
+        """
+        if not os.path.isdir(path):
+            log('Path specified %s is not a directory.' % path, level=ERROR)
+            raise ValueError("%s is not a directory." % path)
+
+        if not self.recursive:
+            return super(DirectoryPermissionAudit, self).is_compliant(path)
+
+        compliant = True
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                continue
+
+            if not super(DirectoryPermissionAudit, self).is_compliant(root):
+                compliant = False
+                continue
+
+        return compliant
+
+    def comply(self, path):
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                super(DirectoryPermissionAudit, self).comply(root)
+
+
+class ReadOnly(BaseFileAudit):
+    """Audits that files and folders are read only."""
+    def __init__(self, paths, *args, **kwargs):
+        super(ReadOnly, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        try:
+            output = check_output(['find', path, '-perm', '-go+w',
+                                   '-type', 'f']).strip()
+
+            # The find above will find any files which have permission sets
+            # which allow too broad of write access. As such, the path is
+            # compliant if there is no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred checking finding writable files for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+            return False
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', 'go-w', '-R', path])
+        except CalledProcessError as e:
+            log('Error occurred removing writeable permissions for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class NoReadWriteForOther(BaseFileAudit):
+    """Ensures that the files found under the base path are readable or
+    writable by anyone other than the owner or the group.
+    """
+    def __init__(self, paths):
+        super(NoReadWriteForOther, self).__init__(paths)
+
+    def is_compliant(self, path):
+        try:
+            cmd = ['find', path, '-perm', '-o+r', '-type', 'f', '-o',
+                   '-perm', '-o+w', '-type', 'f']
+            output = check_output(cmd).strip()
+
+            # The find above here will find any files which have read or
+            # write permissions for other, meaning there is too broad of access
+            # to read/write the file. As such, the path is compliant if there's
+            # no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred while finding files which are readable or '
+                'writable to the world in %s. '
+                'Command output is: %s.' % (path, e.output), level=ERROR)
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', '-R', 'o-rw', path])
+        except CalledProcessError as e:
+            log('Error occurred attempting to change modes of files under '
+                'path %s. Output of command is: %s' % (path, e.output))
+
+
+class NoSUIDSGIDAudit(BaseFileAudit):
+    """Audits that specified files do not have SUID/SGID bits set."""
+    def __init__(self, paths, *args, **kwargs):
+        super(NoSUIDSGIDAudit, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        stat = self._get_stat(path)
+        if (stat.st_mode & (S_ISGID | S_ISUID)) != 0:
+            return False
+
+        return True
+
+    def comply(self, path):
+        try:
+            log('Removing suid/sgid from %s.' % path, level=DEBUG)
+            check_output(['chmod', '-s', path])
+        except CalledProcessError as e:
+            log('Error occurred removing suid/sgid from %s.'
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class TemplatedFile(BaseFileAudit):
+    """The TemplatedFileAudit audits the contents of a templated file.
+
+    This audit renders a file from a template, sets the appropriate file
+    permissions, then generates a hashsum with which to check the content
+    changed.
+    """
+    def __init__(self, path, context, template_dir, mode, user='root',
+                 group='root', service_actions=None, **kwargs):
+        self.context = context
+        self.user = user
+        self.group = group
+        self.mode = mode
+        self.template_dir = template_dir
+        self.service_actions = service_actions
+        super(TemplatedFile, self).__init__(paths=path, always_comply=True,
+                                            **kwargs)
+
+    def is_compliant(self, path):
+        """Determines if the templated file is compliant.
+
+        A templated file is only compliant if it has not changed (as
+        determined by its sha256 hashsum) AND its file permissions are set
+        appropriately.
+
+        :param path: the path to check compliance.
+        """
+        same_templates = self.templates_match(path)
+        same_content = self.contents_match(path)
+        same_permissions = self.permissions_match(path)
+
+        if same_content and same_permissions and same_templates:
+            return True
+
+        return False
+
+    def run_service_actions(self):
+        """Run any actions on services requested."""
+        if not self.service_actions:
+            return
+
+        for svc_action in self.service_actions:
+            name = svc_action['service']
+            actions = svc_action['actions']
+            log("Running service '%s' actions '%s'" % (name, actions),
+                level=DEBUG)
+            for action in actions:
+                cmd = ['service', name, action]
+                try:
+                    check_call(cmd)
+                except CalledProcessError as exc:
+                    log("Service name='%s' action='%s' failed - %s" %
+                        (name, action, exc), level=WARNING)
+
+    def comply(self, path):
+        """Ensures the contents and the permissions of the file.
+
+        :param path: the path to correct
+        """
+        dirname = os.path.dirname(path)
+        if not os.path.exists(dirname):
+            os.makedirs(dirname)
+
+        self.pre_write()
+        render_and_write(self.template_dir, path, self.context())
+        utils.ensure_permissions(path, self.user, self.group, self.mode)
+        self.run_service_actions()
+        self.save_checksum(path)
+        self.post_write()
+
+    def pre_write(self):
+        """Invoked prior to writing the template."""
+        pass
+
+    def post_write(self):
+        """Invoked after writing the template."""
+        pass
+
+    def templates_match(self, path):
+        """Determines if the template files are the same.
+
+        The template file equality is determined by the hashsum of the
+        template files themselves. If there is no hashsum, then the content
+        cannot be sure to be the same so treat it as if they changed.
+        Otherwise, return whether or not the hashsums are the same.
+
+        :param path: the path to check
+        :returns: boolean
+        """
+        template_path = get_template_path(self.template_dir, path)
+        key = 'hardening:template:%s' % template_path
+        template_checksum = file_hash(template_path)
+        kv = unitdata.kv()
+        stored_tmplt_checksum = kv.get(key)
+        if not stored_tmplt_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Saved template checksum for %s.' % template_path,
+                level=DEBUG)
+            # Since we don't have a template checksum, then assume it doesn't
+            # match and return that the template is different.
+            return False
+        elif stored_tmplt_checksum != template_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Updated template checksum for %s.' % template_path,
+                level=DEBUG)
+            return False
+
+        # Here the template hasn't changed based upon the calculated
+        # checksum of the template and what was previously stored.
+        return True
+
+    def contents_match(self, path):
+        """Determines if the file content is the same.
+
+        This is determined by comparing hashsum of the file contents and
+        the saved hashsum. If there is no hashsum, then the content cannot
+        be sure to be the same so treat them as if they are not the same.
+        Otherwise, return True if the hashsums are the same, False if they
+        are not the same.
+
+        :param path: the file to check.
+        """
+        checksum = file_hash(path)
+
+        kv = unitdata.kv()
+        stored_checksum = kv.get('hardening:%s' % path)
+        if not stored_checksum:
+            # If the checksum hasn't been generated, return False to ensure
+            # the file is written and the checksum stored.
+            log('Checksum for %s has not been calculated.' % path, level=DEBUG)
+            return False
+        elif stored_checksum != checksum:
+            log('Checksum mismatch for %s.' % path, level=DEBUG)
+            return False
+
+        return True
+
+    def permissions_match(self, path):
+        """Determines if the file owner and permissions match.
+
+        :param path: the path to check.
+        """
+        audit = FilePermissionAudit(path, self.user, self.group, self.mode)
+        return audit.is_compliant(path)
+
+    def save_checksum(self, path):
+        """Calculates and saves the checksum for the path specified.
+
+        :param path: the path of the file to save the checksum.
+        """
+        checksum = file_hash(path)
+        kv = unitdata.kv()
+        kv.set('hardening:%s' % path, checksum)
+        kv.flush()
+
+
+class DeletedFile(BaseFileAudit):
+    """Audit to ensure that a file is deleted."""
+    def __init__(self, paths):
+        super(DeletedFile, self).__init__(paths)
+
+    def is_compliant(self, path):
+        return not os.path.exists(path)
+
+    def comply(self, path):
+        os.remove(path)
+
+
+class FileContentAudit(BaseFileAudit):
+    """Audit the contents of a file."""
+    def __init__(self, paths, cases, **kwargs):
+        # Cases we expect to pass
+        self.pass_cases = cases.get('pass', [])
+        # Cases we expect to fail
+        self.fail_cases = cases.get('fail', [])
+        super(FileContentAudit, self).__init__(paths, **kwargs)
+
+    def is_compliant(self, path):
+        """
+        Given a set of content matching cases i.e. tuple(regex, bool) where
+        bool value denotes whether or not regex is expected to match, check that
+        all cases match as expected with the contents of the file. Cases can be
+        expected to pass of fail.
+
+        :param path: Path of file to check.
+        :returns: Boolean value representing whether or not all cases are
+                  found to be compliant.
+        """
+        log("Auditing contents of file '%s'" % (path), level=DEBUG)
+        with open(path, 'r') as fd:
+            contents = fd.read()
+
+        matches = 0
+        for pattern in self.pass_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to pass but instead it failed"
+                    % (pattern), level=WARNING)
+
+        for pattern in self.fail_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if not results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to fail but instead it passed"
+                    % (pattern), level=WARNING)
+
+        total = len(self.pass_cases) + len(self.fail_cases)
+        log("Checked %s cases and %s passed" % (total, matches), level=DEBUG)
+        return matches == total
+
+    def comply(self, *args, **kwargs):
+        """NOOP since we just issue warnings. This is to avoid the
+        NotImplememtedError.
+        """
+        log("Not applying any compliance criteria, only checks.", level=INFO)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0f940d4cfa85ca7051dd60a4805d84bb6aebed6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml
@@ -0,0 +1,16 @@
+# NOTE: this file contains the default configuration for the 'apache' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'apache' as the root key followed by any of the following with new
+#       values.
+
+common:
+    apache_dir: '/etc/apache2'
+
+hardening:
+    traceenable: 'off'
+    allowed_http_methods: "GET POST"
+    modules_to_disable: [ cgi, cgid ]
+    servertokens: 'Prod'
+    honor_cipher_order: 'on'
+    cipher_suite: 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..c112137cb45c4b63cb05384145b3edf8c443e2b8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
@@ -0,0 +1,12 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    apache_dir:
+    traceenable:
+
+hardening:
+    allowed_http_methods:
+    modules_to_disable:
+    servertokens:
+    honor_cipher_order:
+    cipher_suite:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..682d22bf3ded32eb1c8d6188486ec4468d9ec457
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml
@@ -0,0 +1,38 @@
+# NOTE: this file contains the default configuration for the 'mysql' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'mysql' as the root key followed by any of the following with new
+#       values.
+
+hardening:
+    mysql-conf: /etc/mysql/my.cnf
+    hardening-conf: /etc/mysql/conf.d/hardening.cnf
+
+security:
+    # @see http://www.symantec.com/connect/articles/securing-mysql-step-step
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_chroot
+    chroot: None
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_safe-user-create
+    safe-user-create: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-auth
+    secure-auth: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_symbolic-links
+    skip-symbolic-links: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_skip-show-database
+    skip-show-database: True
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_local_infile
+    local-infile: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_allow-suspicious-udfs
+    allow-suspicious-udfs: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_automatic_sp_privileges
+    automatic-sp-privileges: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-file-priv
+    secure-file-priv: /tmp
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..2edf325c311c6fbb062a072083b4d12cebc3d9c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
@@ -0,0 +1,15 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+hardening:
+    mysql-conf:
+    hardening-conf:
+security:
+    chroot:
+    safe-user-create:
+    secure-auth:
+    skip-symbolic-links:
+    skip-show-database:
+    local-infile:
+    allow-suspicious-udfs:
+    automatic-sp-privileges:
+    secure-file-priv:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9a8627b5ed2803828e1e4d78260c6b5f90cae659
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml
@@ -0,0 +1,68 @@
+# NOTE: this file contains the default configuration for the 'os' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'os' as the root key followed by any of the following with new
+#       values.
+
+general:
+    desktop_enable: False  # (type:boolean)
+
+environment:
+    extra_user_paths: []
+    umask: 027
+    root_path: /
+
+auth:
+    pw_max_age: 60
+    # discourage password cycling
+    pw_min_age: 7
+    retries: 5
+    lockout_time: 600
+    timeout: 60
+    allow_homeless: False  # (type:boolean)
+    pam_passwdqc_enable: True  # (type:boolean)
+    pam_passwdqc_options: 'min=disabled,disabled,16,12,8'
+    root_ttys:
+        console
+        tty1
+        tty2
+        tty3
+        tty4
+        tty5
+        tty6
+    uid_min: 1000
+    gid_min: 1000
+    sys_uid_min: 100
+    sys_uid_max: 999
+    sys_gid_min: 100
+    sys_gid_max: 999
+    chfn_restrict:
+
+security:
+    users_allow: []
+    suid_sgid_enforce: True  # (type:boolean)
+    # user-defined blacklist and whitelist
+    suid_sgid_blacklist: []
+    suid_sgid_whitelist: []
+    # if this is True, remove any suid/sgid bits from files that were not in the whitelist
+    suid_sgid_dry_run_on_unknown: False  # (type:boolean)
+    suid_sgid_remove_from_unknown: False  # (type:boolean)
+    # remove packages with known issues
+    packages_clean: True  # (type:boolean)
+    packages_list:
+        xinetd
+        inetd
+        ypserv
+        telnet-server
+        rsh-server
+        rsync
+    kernel_enable_module_loading: True  # (type:boolean)
+    kernel_enable_core_dump: False  # (type:boolean)
+    ssh_tmout: 300
+
+sysctl:
+    kernel_secure_sysrq: 244  # 4 + 16 + 32 + 64 + 128
+    kernel_enable_sysrq: False  # (type:boolean)
+    forwarding: False  # (type:boolean)
+    ipv6_enable: False  # (type:boolean)
+    arp_restricted: True  # (type:boolean)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..cc3b9c206eae56cbe68826cb76748e2deb9483e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/os.yaml.schema
@@ -0,0 +1,43 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+general:
+    desktop_enable:
+environment:
+    extra_user_paths:
+    umask:
+    root_path:
+auth:
+    pw_max_age:
+    pw_min_age:
+    retries:
+    lockout_time:
+    timeout:
+    allow_homeless:
+    pam_passwdqc_enable:
+    pam_passwdqc_options:
+    root_ttys:
+    uid_min:
+    gid_min:
+    sys_uid_min:
+    sys_uid_max:
+    sys_gid_min:
+    sys_gid_max:
+    chfn_restrict:
+security:
+    users_allow:
+    suid_sgid_enforce:
+    suid_sgid_blacklist:
+    suid_sgid_whitelist:
+    suid_sgid_dry_run_on_unknown:
+    suid_sgid_remove_from_unknown:
+    packages_clean:
+    packages_list:
+    kernel_enable_module_loading:
+    kernel_enable_core_dump:
+    ssh_tmout:
+sysctl:
+    kernel_secure_sysrq:
+    kernel_enable_sysrq:
+    forwarding:
+    ipv6_enable:
+    arp_restricted:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cd529bcae1ec00fef2e969f43dc3cf530b46ef9a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml
@@ -0,0 +1,49 @@
+# NOTE: this file contains the default configuration for the 'ssh' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'ssh' as the root key followed by any of the following with new
+#       values.
+
+common:
+    service_name: 'ssh'
+    network_ipv6_enable: False  # (type:boolean)
+    ports: [22]
+    remote_hosts: []
+
+client:
+    package: 'openssh-client'
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    roaming: False
+    password_authentication: 'no'
+
+server:
+    host_key_files: ['/etc/ssh/ssh_host_rsa_key', '/etc/ssh/ssh_host_dsa_key',
+                     '/etc/ssh/ssh_host_ecdsa_key']
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    allow_root_with_key: False  # (type:boolean)
+    allow_tcp_forwarding: 'no'
+    allow_agent_forwarding: 'no'
+    allow_x11_forwarding: 'no'
+    use_privilege_separation: 'sandbox'
+    listen_to: ['0.0.0.0']
+    use_pam: 'no'
+    package: 'openssh-server'
+    password_authentication: 'no'
+    alive_interval: '600'
+    alive_count: '3'
+    sftp_enable: False  # (type:boolean)
+    sftp_group: 'sftponly'
+    sftp_chroot: '/home/%u'
+    deny_users: []
+    allow_users: []
+    deny_groups: []
+    allow_groups: []
+    print_motd: 'no'
+    print_last_log: 'no'
+    use_dns: 'no'
+    max_auth_tries: 2
+    max_sessions: 10
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..d05e054bc234015206bb1195152fa9ffd6a33151
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
@@ -0,0 +1,42 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    service_name:
+    network_ipv6_enable:
+    ports:
+    remote_hosts:
+client:
+    package:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    roaming:
+    password_authentication:
+server:
+    host_key_files:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    allow_root_with_key:
+    allow_tcp_forwarding:
+    allow_agent_forwarding:
+    allow_x11_forwarding:
+    use_privilege_separation:
+    listen_to:
+    use_pam:
+    package:
+    password_authentication:
+    alive_interval:
+    alive_count:
+    sftp_enable:
+    sftp_group:
+    sftp_chroot:
+    deny_users:
+    allow_users:
+    deny_groups:
+    allow_groups:
+    print_motd:
+    print_last_log:
+    use_dns:
+    max_auth_tries:
+    max_sessions:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/harden.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/harden.py
new file mode 100644
index 0000000000000000000000000000000000000000..63f21b9c9855065da3be875c01a2c94db7df47b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/harden.py
@@ -0,0 +1,96 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+
+from collections import OrderedDict
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.host.checks import run_os_checks
+from charmhelpers.contrib.hardening.ssh.checks import run_ssh_checks
+from charmhelpers.contrib.hardening.mysql.checks import run_mysql_checks
+from charmhelpers.contrib.hardening.apache.checks import run_apache_checks
+
+_DISABLE_HARDENING_FOR_UNIT_TEST = False
+
+
+def harden(overrides=None):
+    """Hardening decorator.
+
+    This is the main entry point for running the hardening stack. In order to
+    run modules of the stack you must add this decorator to charm hook(s) and
+    ensure that your charm config.yaml contains the 'harden' option set to
+    one or more of the supported modules. Setting these will cause the
+    corresponding hardening code to be run when the hook fires.
+
+    This decorator can and should be applied to more than one hook or function
+    such that hardening modules are called multiple times. This is because
+    subsequent calls will perform auditing checks that will report any changes
+    to resources hardened by the first run (and possibly perform compliance
+    actions as a result of any detected infractions).
+
+    :param overrides: Optional list of stack modules used to override those
+                      provided with 'harden' config.
+    :returns: Returns value returned by decorated function once executed.
+    """
+    if overrides is None:
+        overrides = []
+
+    def _harden_inner1(f):
+        # As this has to be py2.7 compat, we can't use nonlocal.  Use a trick
+        # to capture the dictionary that can then be updated.
+        _logged = {'done': False}
+
+        def _harden_inner2(*args, **kwargs):
+            # knock out hardening via a config var; normally it won't get
+            # disabled.
+            if _DISABLE_HARDENING_FOR_UNIT_TEST:
+                return f(*args, **kwargs)
+            if not _logged['done']:
+                log("Hardening function '%s'" % (f.__name__), level=DEBUG)
+                _logged['done'] = True
+            RUN_CATALOG = OrderedDict([('os', run_os_checks),
+                                       ('ssh', run_ssh_checks),
+                                       ('mysql', run_mysql_checks),
+                                       ('apache', run_apache_checks)])
+
+            enabled = overrides[:] or (config("harden") or "").split()
+            if enabled:
+                modules_to_run = []
+                # modules will always be performed in the following order
+                for module, func in six.iteritems(RUN_CATALOG):
+                    if module in enabled:
+                        enabled.remove(module)
+                        modules_to_run.append(func)
+
+                if enabled:
+                    log("Unknown hardening modules '%s' - ignoring" %
+                        (', '.join(enabled)), level=WARNING)
+
+                for hardener in modules_to_run:
+                    log("Executing hardening module '%s'" %
+                        (hardener.__name__), level=DEBUG)
+                    hardener()
+            else:
+                log("No hardening applied to '%s'" % (f.__name__), level=DEBUG)
+
+            return f(*args, **kwargs)
+        return _harden_inner2
+
+    return _harden_inner1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e7e409f3c7e0406b40353f48acfc3479e4c1a24
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/__init__.py
@@ -0,0 +1,48 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.host.checks import (
+    apt,
+    limits,
+    login,
+    minimize_access,
+    pam,
+    profile,
+    securetty,
+    suid_sgid,
+    sysctl
+)
+
+
+def run_os_checks():
+    log("Starting OS hardening checks.", level=DEBUG)
+    checks = apt.get_audits()
+    checks.extend(limits.get_audits())
+    checks.extend(login.get_audits())
+    checks.extend(minimize_access.get_audits())
+    checks.extend(pam.get_audits())
+    checks.extend(profile.get_audits())
+    checks.extend(securetty.get_audits())
+    checks.extend(suid_sgid.get_audits())
+    checks.extend(sysctl.get_audits())
+
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("OS hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ce41b0043134e256d9c20ee729f1c4345faa3f9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/apt.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.utils import get_settings
+from charmhelpers.contrib.hardening.audits.apt import (
+    AptConfig,
+    RestrictedPackages,
+)
+
+
+def get_audits():
+    """Get OS hardening apt audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [AptConfig([{'key': 'APT::Get::AllowUnauthenticated',
+                          'expected': 'false'}])]
+
+    settings = get_settings('os')
+    clean_packages = settings['security']['packages_clean']
+    if clean_packages:
+        security_packages = settings['security']['packages_list']
+        if security_packages:
+            audits.append(RestrictedPackages(security_packages))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/limits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/limits.py
new file mode 100644
index 0000000000000000000000000000000000000000..e94f5ebef360c7c80c35eba8243d3e7f7dcbb14d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/limits.py
@@ -0,0 +1,53 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening security limits audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Ensure that the /etc/security/limits.d directory is only writable
+    # by the root user, but others can execute and read.
+    audits.append(DirectoryPermissionAudit('/etc/security/limits.d',
+                                           user='root', group='root',
+                                           mode=0o755))
+
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/security/limits.d/10.hardcore.conf',
+                                    SecurityLimitsContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    user='root', group='root', mode=0o0440))
+    return audits
+
+
+class SecurityLimitsContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'disable_core_dump':
+                not settings['security']['kernel_enable_core_dump']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/login.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/login.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe2bc6ef34a0dae612c2617dc1d13390f651e419
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/login.py
@@ -0,0 +1,65 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from six import string_types
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening login.defs audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [TemplatedFile('/etc/login.defs', LoginContext(),
+                            template_dir=TEMPLATES_DIR,
+                            user='root', group='root', mode=0o0444)]
+    return audits
+
+
+class LoginContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+
+        # Octal numbers in yaml end up being turned into decimal,
+        # so check if the umask is entered as a string (e.g. '027')
+        # or as an octal umask as we know it (e.g. 002). If its not
+        # a string assume it to be octal and turn it into an octal
+        # string.
+        umask = settings['environment']['umask']
+        if not isinstance(umask, string_types):
+            umask = '%s' % oct(umask)
+
+        ctxt = {
+            'additional_user_paths':
+            settings['environment']['extra_user_paths'],
+            'umask': umask,
+            'pwd_max_age': settings['auth']['pw_max_age'],
+            'pwd_min_age': settings['auth']['pw_min_age'],
+            'uid_min': settings['auth']['uid_min'],
+            'sys_uid_min': settings['auth']['sys_uid_min'],
+            'sys_uid_max': settings['auth']['sys_uid_max'],
+            'gid_min': settings['auth']['gid_min'],
+            'sys_gid_min': settings['auth']['sys_gid_min'],
+            'sys_gid_max': settings['auth']['sys_gid_max'],
+            'login_retries': settings['auth']['retries'],
+            'login_timeout': settings['auth']['timeout'],
+            'chfn_restrict': settings['auth']['chfn_restrict'],
+            'allow_login_without_home': settings['auth']['allow_homeless']
+        }
+
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e64be003be0b89d1416b22c35c43b6024979361
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/minimize_access.py
@@ -0,0 +1,50 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    ReadOnly,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening access audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Remove write permissions from $PATH folders for all regular users.
+    # This prevents changing system-wide commands from normal users.
+    path_folders = {'/usr/local/sbin',
+                    '/usr/local/bin',
+                    '/usr/sbin',
+                    '/usr/bin',
+                    '/bin'}
+    extra_user_paths = settings['environment']['extra_user_paths']
+    path_folders.update(extra_user_paths)
+    audits.append(ReadOnly(path_folders))
+
+    # Only allow the root user to have access to the shadow file.
+    audits.append(FilePermissionAudit('/etc/shadow', 'root', 'root', 0o0600))
+
+    if 'change_user' not in settings['security']['users_allow']:
+        # su should only be accessible to user and group root, unless it is
+        # expressly defined to allow users to change to root via the
+        # security_users_allow config option.
+        audits.append(FilePermissionAudit('/bin/su', 'root', 'root', 0o750))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/pam.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/pam.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b38d5f0cf0b16282968825b79b44d80a1a7f577
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/pam.py
@@ -0,0 +1,132 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from subprocess import (
+    check_output,
+    CalledProcessError,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_purge,
+    apt_update,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    DeletedFile,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+def get_audits():
+    """Get OS hardening PAM authentication audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+
+    if settings['auth']['pam_passwdqc_enable']:
+        audits.append(PasswdqcPAM('/etc/passwdqc.conf'))
+
+    if settings['auth']['retries']:
+        audits.append(Tally2PAM('/usr/share/pam-configs/tally2'))
+    else:
+        audits.append(DeletedFile('/usr/share/pam-configs/tally2'))
+
+    return audits
+
+
+class PasswdqcPAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_pam_passwdqc_options'] = \
+            settings['auth']['pam_passwdqc_options']
+
+        return ctxt
+
+
+class PasswdqcPAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(PasswdqcPAM, self).__init__(path=path,
+                                          template_dir=TEMPLATES_DIR,
+                                          context=PasswdqcPAMContext(),
+                                          user='root',
+                                          group='root',
+                                          mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        for pkg in ['libpam-ccreds', 'libpam-cracklib']:
+            log("Purging package '%s'" % pkg, level=DEBUG),
+            apt_purge(pkg)
+
+        apt_update(fatal=True)
+        for pkg in ['libpam-passwdqc']:
+            log("Installing package '%s'" % pkg, level=DEBUG),
+            apt_install(pkg)
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
+
+
+class Tally2PAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_lockout_time'] = settings['auth']['lockout_time']
+        ctxt['auth_retries'] = settings['auth']['retries']
+
+        return ctxt
+
+
+class Tally2PAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(Tally2PAM, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=Tally2PAMContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        apt_purge('libpam-ccreds')
+        apt_update(fatal=True)
+        apt_install('libpam-modules')
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/profile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/profile.py
new file mode 100644
index 0000000000000000000000000000000000000000..2727428da9241ccf88a60843d05dffb26cebac96
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/profile.py
@@ -0,0 +1,49 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening profile audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/profile.d/pinerolo_profile.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0755, user='root', group='root'))
+    if settings['security']['ssh_tmout']:
+        audits.append(TemplatedFile('/etc/profile.d/99-hardening.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0644, user='root', group='root'))
+    return audits
+
+
+class ProfileContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ssh_tmout':
+                settings['security']['ssh_tmout']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/securetty.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/securetty.py
new file mode 100644
index 0000000000000000000000000000000000000000..34cd02178c1fbf1c7d467af0814ad9fd4199dc3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/securetty.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening Secure TTY audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    audits.append(TemplatedFile('/etc/securetty', SecureTTYContext(),
+                                template_dir=TEMPLATES_DIR,
+                                mode=0o0400, user='root', group='root'))
+    return audits
+
+
+class SecureTTYContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ttys': settings['auth']['root_ttys']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcbe3fde07ea0716e2de6d1d4e103fcb19166c14
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
@@ -0,0 +1,129 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import NoSUIDSGIDAudit
+from charmhelpers.contrib.hardening import utils
+
+
+BLACKLIST = ['/usr/bin/rcp', '/usr/bin/rlogin', '/usr/bin/rsh',
+             '/usr/libexec/openssh/ssh-keysign',
+             '/usr/lib/openssh/ssh-keysign',
+             '/sbin/netreport',
+             '/usr/sbin/usernetctl',
+             '/usr/sbin/userisdnctl',
+             '/usr/sbin/pppd',
+             '/usr/bin/lockfile',
+             '/usr/bin/mail-lock',
+             '/usr/bin/mail-unlock',
+             '/usr/bin/mail-touchlock',
+             '/usr/bin/dotlockfile',
+             '/usr/bin/arping',
+             '/usr/sbin/uuidd',
+             '/usr/bin/mtr',
+             '/usr/lib/evolution/camel-lock-helper-1.2',
+             '/usr/lib/pt_chown',
+             '/usr/lib/eject/dmcrypt-get-device',
+             '/usr/lib/mc/cons.saver']
+
+WHITELIST = ['/bin/mount', '/bin/ping', '/bin/su', '/bin/umount',
+             '/sbin/pam_timestamp_check', '/sbin/unix_chkpwd', '/usr/bin/at',
+             '/usr/bin/gpasswd', '/usr/bin/locate', '/usr/bin/newgrp',
+             '/usr/bin/passwd', '/usr/bin/ssh-agent',
+             '/usr/libexec/utempter/utempter', '/usr/sbin/lockdev',
+             '/usr/sbin/sendmail.sendmail', '/usr/bin/expiry',
+             '/bin/ping6', '/usr/bin/traceroute6.iputils',
+             '/sbin/mount.nfs', '/sbin/umount.nfs',
+             '/sbin/mount.nfs4', '/sbin/umount.nfs4',
+             '/usr/bin/crontab',
+             '/usr/bin/wall', '/usr/bin/write',
+             '/usr/bin/screen',
+             '/usr/bin/mlocate',
+             '/usr/bin/chage', '/usr/bin/chfn', '/usr/bin/chsh',
+             '/bin/fusermount',
+             '/usr/bin/pkexec',
+             '/usr/bin/sudo', '/usr/bin/sudoedit',
+             '/usr/sbin/postdrop', '/usr/sbin/postqueue',
+             '/usr/sbin/suexec',
+             '/usr/lib/squid/ncsa_auth', '/usr/lib/squid/pam_auth',
+             '/usr/kerberos/bin/ksu',
+             '/usr/sbin/ccreds_validate',
+             '/usr/bin/Xorg',
+             '/usr/bin/X',
+             '/usr/lib/dbus-1.0/dbus-daemon-launch-helper',
+             '/usr/lib/vte/gnome-pty-helper',
+             '/usr/lib/libvte9/gnome-pty-helper',
+             '/usr/lib/libvte-2.90-9/gnome-pty-helper']
+
+
+def get_audits():
+    """Get OS hardening suid/sgid audits.
+
+    :returns:  dictionary of audits
+    """
+    checks = []
+    settings = utils.get_settings('os')
+    if not settings['security']['suid_sgid_enforce']:
+        log("Skipping suid/sgid hardening", level=INFO)
+        return checks
+
+    # Build the blacklist and whitelist of files for suid/sgid checks.
+    # There are a total of 4 lists:
+    #   1. the system blacklist
+    #   2. the system whitelist
+    #   3. the user blacklist
+    #   4. the user whitelist
+    #
+    # The blacklist is the set of paths which should NOT have the suid/sgid bit
+    # set and the whitelist is the set of paths which MAY have the suid/sgid
+    # bit setl. The user whitelist/blacklist effectively override the system
+    # whitelist/blacklist.
+    u_b = settings['security']['suid_sgid_blacklist']
+    u_w = settings['security']['suid_sgid_whitelist']
+
+    blacklist = set(BLACKLIST) - set(u_w + u_b)
+    whitelist = set(WHITELIST) - set(u_b + u_w)
+
+    checks.append(NoSUIDSGIDAudit(blacklist))
+
+    dry_run = settings['security']['suid_sgid_dry_run_on_unknown']
+
+    if settings['security']['suid_sgid_remove_from_unknown'] or dry_run:
+        # If the policy is a dry_run (e.g. complain only) or remove unknown
+        # suid/sgid bits then find all of the paths which have the suid/sgid
+        # bit set and then remove the whitelisted paths.
+        root_path = settings['environment']['root_path']
+        unknown_paths = find_paths_with_suid_sgid(root_path) - set(whitelist)
+        checks.append(NoSUIDSGIDAudit(unknown_paths, unless=dry_run))
+
+    return checks
+
+
+def find_paths_with_suid_sgid(root_path):
+    """Finds all paths/files which have an suid/sgid bit enabled.
+
+    Starting with the root_path, this will recursively find all paths which
+    have an suid or sgid bit set.
+    """
+    cmd = ['find', root_path, '-perm', '-4000', '-o', '-perm', '-2000',
+           '-type', 'f', '!', '-path', '/proc/*', '-print']
+
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    out, _ = p.communicate()
+    return set(out.split('\n'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1ea5813036b11893e8b9a986bf30a2f7a541b5d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/checks/sysctl.py
@@ -0,0 +1,209 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import platform
+import re
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    WARNING,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+SYSCTL_DEFAULTS = """net.ipv4.ip_forward=%(net_ipv4_ip_forward)s
+net.ipv6.conf.all.forwarding=%(net_ipv6_conf_all_forwarding)s
+net.ipv4.conf.all.rp_filter=1
+net.ipv4.conf.default.rp_filter=1
+net.ipv4.icmp_echo_ignore_broadcasts=1
+net.ipv4.icmp_ignore_bogus_error_responses=1
+net.ipv4.icmp_ratelimit=100
+net.ipv4.icmp_ratemask=88089
+net.ipv6.conf.all.disable_ipv6=%(net_ipv6_conf_all_disable_ipv6)s
+net.ipv4.tcp_timestamps=%(net_ipv4_tcp_timestamps)s
+net.ipv4.conf.all.arp_ignore=%(net_ipv4_conf_all_arp_ignore)s
+net.ipv4.conf.all.arp_announce=%(net_ipv4_conf_all_arp_announce)s
+net.ipv4.tcp_rfc1337=1
+net.ipv4.tcp_syncookies=1
+net.ipv4.conf.all.shared_media=1
+net.ipv4.conf.default.shared_media=1
+net.ipv4.conf.all.accept_source_route=0
+net.ipv4.conf.default.accept_source_route=0
+net.ipv4.conf.all.accept_redirects=0
+net.ipv4.conf.default.accept_redirects=0
+net.ipv6.conf.all.accept_redirects=0
+net.ipv6.conf.default.accept_redirects=0
+net.ipv4.conf.all.secure_redirects=0
+net.ipv4.conf.default.secure_redirects=0
+net.ipv4.conf.all.send_redirects=0
+net.ipv4.conf.default.send_redirects=0
+net.ipv4.conf.all.log_martians=0
+net.ipv6.conf.default.router_solicitations=0
+net.ipv6.conf.default.accept_ra_rtr_pref=0
+net.ipv6.conf.default.accept_ra_pinfo=0
+net.ipv6.conf.default.accept_ra_defrtr=0
+net.ipv6.conf.default.autoconf=0
+net.ipv6.conf.default.dad_transmits=0
+net.ipv6.conf.default.max_addresses=1
+net.ipv6.conf.all.accept_ra=0
+net.ipv6.conf.default.accept_ra=0
+kernel.modules_disabled=%(kernel_modules_disabled)s
+kernel.sysrq=%(kernel_sysrq)s
+fs.suid_dumpable=%(fs_suid_dumpable)s
+kernel.randomize_va_space=2
+"""
+
+
+def get_audits():
+    """Get OS hardening sysctl audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Apply the sysctl settings which are configured to be applied.
+    audits.append(SysctlConf())
+    # Make sure that only root has access to the sysctl.conf file, and
+    # that it is read-only.
+    audits.append(FilePermissionAudit('/etc/sysctl.conf',
+                                      user='root',
+                                      group='root', mode=0o0440))
+    # If module loading is not enabled, then ensure that the modules
+    # file has the appropriate permissions and rebuild the initramfs
+    if not settings['security']['kernel_enable_module_loading']:
+        audits.append(ModulesTemplate())
+
+    return audits
+
+
+class ModulesContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        with open('/proc/cpuinfo', 'r') as fd:
+            cpuinfo = fd.readlines()
+
+        for line in cpuinfo:
+            match = re.search(r"^vendor_id\s+:\s+(.+)", line)
+            if match:
+                vendor = match.group(1)
+
+        if vendor == "GenuineIntel":
+            vendor = "intel"
+        elif vendor == "AuthenticAMD":
+            vendor = "amd"
+
+        ctxt = {'arch': platform.processor(),
+                'cpuVendor': vendor,
+                'desktop_enable': settings['general']['desktop_enable']}
+
+        return ctxt
+
+
+class ModulesTemplate(object):
+
+    def __init__(self):
+        super(ModulesTemplate, self).__init__('/etc/initramfs-tools/modules',
+                                              ModulesContext(),
+                                              templates_dir=TEMPLATES_DIR,
+                                              user='root', group='root',
+                                              mode=0o0440)
+
+    def post_write(self):
+        subprocess.check_call(['update-initramfs', '-u'])
+
+
+class SysCtlHardeningContext(object):
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'sysctl': {}}
+
+        log("Applying sysctl settings", level=INFO)
+        extras = {'net_ipv4_ip_forward': 0,
+                  'net_ipv6_conf_all_forwarding': 0,
+                  'net_ipv6_conf_all_disable_ipv6': 1,
+                  'net_ipv4_tcp_timestamps': 0,
+                  'net_ipv4_conf_all_arp_ignore': 0,
+                  'net_ipv4_conf_all_arp_announce': 0,
+                  'kernel_sysrq': 0,
+                  'fs_suid_dumpable': 0,
+                  'kernel_modules_disabled': 1}
+
+        if settings['sysctl']['ipv6_enable']:
+            extras['net_ipv6_conf_all_disable_ipv6'] = 0
+
+        if settings['sysctl']['forwarding']:
+            extras['net_ipv4_ip_forward'] = 1
+            extras['net_ipv6_conf_all_forwarding'] = 1
+
+        if settings['sysctl']['arp_restricted']:
+            extras['net_ipv4_conf_all_arp_ignore'] = 1
+            extras['net_ipv4_conf_all_arp_announce'] = 2
+
+        if settings['security']['kernel_enable_module_loading']:
+            extras['kernel_modules_disabled'] = 0
+
+        if settings['sysctl']['kernel_enable_sysrq']:
+            sysrq_val = settings['sysctl']['kernel_secure_sysrq']
+            extras['kernel_sysrq'] = sysrq_val
+
+        if settings['security']['kernel_enable_core_dump']:
+            extras['fs_suid_dumpable'] = 1
+
+        settings.update(extras)
+        for d in (SYSCTL_DEFAULTS % settings).split():
+            d = d.strip().partition('=')
+            key = d[0].strip()
+            path = os.path.join('/proc/sys', key.replace('.', '/'))
+            if not os.path.exists(path):
+                log("Skipping '%s' since '%s' does not exist" % (key, path),
+                    level=WARNING)
+                continue
+
+            ctxt['sysctl'][key] = d[2] or None
+
+        # Translate for python3
+        return {'sysctl_settings':
+                [(k, v) for k, v in six.iteritems(ctxt['sysctl'])]}
+
+
+class SysctlConf(TemplatedFile):
+    """An audit check for sysctl settings."""
+    def __init__(self):
+        self.conffile = '/etc/sysctl.d/99-juju-hardening.conf'
+        super(SysctlConf, self).__init__(self.conffile,
+                                         SysCtlHardeningContext(),
+                                         template_dir=TEMPLATES_DIR,
+                                         user='root', group='root',
+                                         mode=0o0440)
+
+    def post_write(self):
+        try:
+            subprocess.check_call(['sysctl', '-p', self.conffile])
+        except subprocess.CalledProcessError as e:
+            # NOTE: on some systems if sysctl cannot apply all settings it
+            #       will return non-zero as well.
+            log("sysctl command returned an error (maybe some "
+                "keys could not be set) - %s" % (e),
+                level=WARNING)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
new file mode 100644
index 0000000000000000000000000000000000000000..0014191fc8152fd9147b3fb5446987e6e62f2d77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% if disable_core_dump -%}
+# Prevent core dumps for all users. These are usually only needed by developers and may contain sensitive information.
+* hard core 0
+{% endif %}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
new file mode 100644
index 0000000000000000000000000000000000000000..616cef46f492f682aca28c71a6e20176870a36f2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
@@ -0,0 +1,5 @@
+TMOUT={{ tmout }}
+readonly TMOUT
+export TMOUT
+
+readonly HISTFILE
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..101f1e1d709c268890553957f30c93259681ce59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
@@ -0,0 +1,7 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% for key, value in sysctl_settings -%}
+{{ key }}={{ value }}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/login.defs b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/login.defs
new file mode 100644
index 0000000000000000000000000000000000000000..db137d6dbb7a3a850294407199225392a880cfc2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/login.defs
@@ -0,0 +1,349 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+#
+# /etc/login.defs - Configuration control definitions for the login package.
+#
+# Three items must be defined:  MAIL_DIR, ENV_SUPATH, and ENV_PATH.
+# If unspecified, some arbitrary (and possibly incorrect) value will
+# be assumed.  All other items are optional - if not specified then
+# the described action or option will be inhibited.
+#
+# Comment lines (lines beginning with "#") and blank lines are ignored.
+#
+# Modified for Linux.  --marekm
+
+# REQUIRED for useradd/userdel/usermod
+#   Directory where mailboxes reside, _or_ name of file, relative to the
+#   home directory.  If you _do_ define MAIL_DIR and MAIL_FILE,
+#   MAIL_DIR takes precedence.
+#
+#   Essentially:
+#      - MAIL_DIR defines the location of users mail spool files
+#        (for mbox use) by appending the username to MAIL_DIR as defined
+#        below.
+#      - MAIL_FILE defines the location of the users mail spool files as the
+#        fully-qualified filename obtained by prepending the user home
+#        directory before $MAIL_FILE
+#
+# NOTE: This is no more used for setting up users MAIL environment variable
+#       which is, starting from shadow 4.0.12-1 in Debian, entirely the
+#       job of the pam_mail PAM modules
+#       See default PAM configuration files provided for
+#       login, su, etc.
+#
+# This is a temporary situation: setting these variables will soon
+# move to /etc/default/useradd and the variables will then be
+# no more supported
+MAIL_DIR        /var/mail
+#MAIL_FILE      .mail
+
+#
+# Enable logging and display of /var/log/faillog login failure info.
+# This option conflicts with the pam_tally PAM module.
+#
+FAILLOG_ENAB		yes
+
+#
+# Enable display of unknown usernames when login failures are recorded.
+#
+# WARNING: Unknown usernames may become world readable. 
+# See #290803 and #298773 for details about how this could become a security
+# concern
+LOG_UNKFAIL_ENAB	no
+
+#
+# Enable logging of successful logins
+#
+LOG_OK_LOGINS		yes
+
+#
+# Enable "syslog" logging of su activity - in addition to sulog file logging.
+# SYSLOG_SG_ENAB does the same for newgrp and sg.
+#
+SYSLOG_SU_ENAB		yes
+SYSLOG_SG_ENAB		yes
+
+#
+# If defined, all su activity is logged to this file.
+#
+#SULOG_FILE	/var/log/sulog
+
+#
+# If defined, file which maps tty line to TERM environment parameter.
+# Each line of the file is in a format something like "vt100  tty01".
+#
+#TTYTYPE_FILE	/etc/ttytype
+
+#
+# If defined, login failures will be logged here in a utmp format
+# last, when invoked as lastb, will read /var/log/btmp, so...
+#
+FTMP_FILE	/var/log/btmp
+
+#
+# If defined, the command name to display when running "su -".  For
+# example, if this is defined as "su" then a "ps" will display the
+# command is "-su".  If not defined, then "ps" would display the
+# name of the shell actually being run, e.g. something like "-sh".
+#
+SU_NAME		su
+
+#
+# If defined, file which inhibits all the usual chatter during the login
+# sequence.  If a full pathname, then hushed mode will be enabled if the
+# user's name or shell are found in the file.  If not a full pathname, then
+# hushed mode will be enabled if the file exists in the user's home directory.
+#
+HUSHLOGIN_FILE	.hushlogin
+#HUSHLOGIN_FILE	/etc/hushlogins
+
+#
+# *REQUIRED*  The default PATH settings, for superuser and normal users.
+#
+# (they are minimal, add the rest in the shell startup files)
+ENV_SUPATH	PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+ENV_PATH	PATH=/usr/local/bin:/usr/bin:/bin{% if additional_user_paths %}{{ additional_user_paths }}{% endif %}
+
+#
+# Terminal permissions
+#
+#	TTYGROUP	Login tty will be assigned this group ownership.
+#	TTYPERM		Login tty will be set to this permission.
+#
+# If you have a "write" program which is "setgid" to a special group
+# which owns the terminals, define TTYGROUP to the group number and
+# TTYPERM to 0620.  Otherwise leave TTYGROUP commented out and assign
+# TTYPERM to either 622 or 600.
+#
+# In Debian /usr/bin/bsd-write or similar programs are setgid tty
+# However, the default and recommended value for TTYPERM is still 0600
+# to not allow anyone to write to anyone else console or terminal
+
+# Users can still allow other people to write them by issuing 
+# the "mesg y" command.
+
+TTYGROUP	tty
+TTYPERM		0600
+
+#
+# Login configuration initializations:
+#
+#	ERASECHAR	Terminal ERASE character ('\010' = backspace).
+#	KILLCHAR	Terminal KILL character ('\025' = CTRL/U).
+#	UMASK		Default "umask" value.
+#
+# The ERASECHAR and KILLCHAR are used only on System V machines.
+# 
+# UMASK is the default umask value for pam_umask and is used by
+# useradd and newusers to set the mode of the new home directories.
+# 022 is the "historical" value in Debian for UMASK
+# 027, or even 077, could be considered better for privacy
+# There is no One True Answer here : each sysadmin must make up his/her
+# mind.
+#
+# If USERGROUPS_ENAB is set to "yes", that will modify this UMASK default value
+# for private user groups, i. e. the uid is the same as gid, and username is
+# the same as the primary group name: for these, the user permissions will be
+# used as group permissions, e. g. 022 will become 002.
+#
+# Prefix these values with "0" to get octal, "0x" to get hexadecimal.
+#
+ERASECHAR	0177
+KILLCHAR	025
+UMASK		{{ umask }}
+
+# Enable setting of the umask group bits to be the same as owner bits (examples: `022` -> `002`, `077` -> `007`) for non-root users, if the uid is the same as gid, and username is the same as the primary group name.
+# If set to yes, userdel will remove the user´s group if it contains no more members, and useradd will create by default a group with the name of the user.
+USERGROUPS_ENAB yes
+
+#
+# Password aging controls:
+#
+#	PASS_MAX_DAYS	Maximum number of days a password may be used.
+#	PASS_MIN_DAYS	Minimum number of days allowed between password changes.
+#	PASS_WARN_AGE	Number of days warning given before a password expires.
+#
+PASS_MAX_DAYS	{{ pwd_max_age }}
+PASS_MIN_DAYS	{{ pwd_min_age }}
+PASS_WARN_AGE	7
+
+#
+# Min/max values for automatic uid selection in useradd
+#
+UID_MIN			 {{ uid_min }}
+UID_MAX			60000
+# System accounts
+SYS_UID_MIN		  {{ sys_uid_min }}
+SYS_UID_MAX		  {{ sys_uid_max }}
+
+# Min/max values for automatic gid selection in groupadd
+GID_MIN			 {{ gid_min }}
+GID_MAX			60000
+# System accounts
+SYS_GID_MIN		  {{ sys_gid_min }}
+SYS_GID_MAX		  {{ sys_gid_max }}
+
+#
+# Max number of login retries if password is bad. This will most likely be
+# overriden by PAM, since the default pam_unix module has it's own built
+# in of 3 retries. However, this is a safe fallback in case you are using
+# an authentication module that does not enforce PAM_MAXTRIES.
+#
+LOGIN_RETRIES		{{ login_retries }}
+
+#
+# Max time in seconds for login
+#
+LOGIN_TIMEOUT		{{ login_timeout }}
+
+#
+# Which fields may be changed by regular users using chfn - use
+# any combination of letters "frwh" (full name, room number, work
+# phone, home phone).  If not defined, no changes are allowed.
+# For backward compatibility, "yes" = "rwh" and "no" = "frwh".
+# 
+{% if chfn_restrict %}
+CHFN_RESTRICT		{{ chfn_restrict }}
+{% endif %}
+
+#
+# Should login be allowed if we can't cd to the home directory?
+# Default in no.
+#
+DEFAULT_HOME	{% if allow_login_without_home %} yes {% else %} no {% endif %}
+
+#
+# If defined, this command is run when removing a user.
+# It should remove any at/cron/print jobs etc. owned by
+# the user to be removed (passed as the first argument).
+#
+#USERDEL_CMD	/usr/sbin/userdel_local
+
+#
+# Enable setting of the umask group bits to be the same as owner bits
+# (examples: 022 -> 002, 077 -> 007) for non-root users, if the uid is
+# the same as gid, and username is the same as the primary group name.
+#
+# If set to yes, userdel will remove the user´s group if it contains no
+# more members, and useradd will create by default a group with the name
+# of the user.
+#
+USERGROUPS_ENAB yes
+
+#
+# Instead of the real user shell, the program specified by this parameter
+# will be launched, although its visible name (argv[0]) will be the shell's.
+# The program may do whatever it wants (logging, additional authentification,
+# banner, ...) before running the actual shell.
+#
+# FAKE_SHELL /bin/fakeshell
+
+#
+# If defined, either full pathname of a file containing device names or
+# a ":" delimited list of device names.  Root logins will be allowed only
+# upon these devices.
+#
+# This variable is used by login and su.
+#
+#CONSOLE	/etc/consoles
+#CONSOLE	console:tty01:tty02:tty03:tty04
+
+#
+# List of groups to add to the user's supplementary group set
+# when logging in on the console (as determined by the CONSOLE
+# setting).  Default is none.
+#
+# Use with caution - it is possible for users to gain permanent
+# access to these groups, even when not logged in on the console.
+# How to do it is left as an exercise for the reader...
+#
+# This variable is used by login and su.
+#
+#CONSOLE_GROUPS		floppy:audio:cdrom
+
+#
+# If set to "yes", new passwords will be encrypted using the MD5-based
+# algorithm compatible with the one used by recent releases of FreeBSD.
+# It supports passwords of unlimited length and longer salt strings.
+# Set to "no" if you need to copy encrypted passwords to other systems
+# which don't understand the new algorithm.  Default is "no".
+#
+# This variable is deprecated. You should use ENCRYPT_METHOD.
+#
+MD5_CRYPT_ENAB	no
+
+#
+# If set to MD5 , MD5-based algorithm will be used for encrypting password
+# If set to SHA256, SHA256-based algorithm will be used for encrypting password
+# If set to SHA512, SHA512-based algorithm will be used for encrypting password
+# If set to DES, DES-based algorithm will be used for encrypting password (default)
+# Overrides the MD5_CRYPT_ENAB option
+#
+# Note: It is recommended to use a value consistent with
+# the PAM modules configuration.
+#
+ENCRYPT_METHOD SHA512
+
+#
+# Only used if ENCRYPT_METHOD is set to SHA256 or SHA512.
+#
+# Define the number of SHA rounds.
+# With a lot of rounds, it is more difficult to brute forcing the password.
+# But note also that it more CPU resources will be needed to authenticate
+# users.
+#
+# If not specified, the libc will choose the default number of rounds (5000).
+# The values must be inside the 1000-999999999 range.
+# If only one of the MIN or MAX values is set, then this value will be used.
+# If MIN > MAX, the highest value will be used.
+#
+# SHA_CRYPT_MIN_ROUNDS 5000
+# SHA_CRYPT_MAX_ROUNDS 5000
+
+################# OBSOLETED BY PAM ##############
+#						#
+# These options are now handled by PAM. Please	#
+# edit the appropriate file in /etc/pam.d/ to	#
+# enable the equivelants of them.
+#
+###############
+
+#MOTD_FILE
+#DIALUPS_CHECK_ENAB
+#LASTLOG_ENAB
+#MAIL_CHECK_ENAB
+#OBSCURE_CHECKS_ENAB
+#PORTTIME_CHECKS_ENAB
+#SU_WHEEL_ONLY
+#CRACKLIB_DICTPATH
+#PASS_CHANGE_TRIES
+#PASS_ALWAYS_WARN
+#ENVIRON_FILE
+#NOLOGINS_FILE
+#ISSUE_FILE
+#PASS_MIN_LEN
+#PASS_MAX_LEN
+#ULIMIT
+#ENV_HZ
+#CHFN_AUTH
+#CHSH_AUTH
+#FAIL_DELAY
+
+################# OBSOLETED #######################
+#						  #
+# These options are no more handled by shadow.    #
+#                                                 #
+# Shadow utilities will display a warning if they #
+# still appear.                                   #
+#                                                 #
+###################################################
+
+# CLOSE_SESSIONS
+# LOGIN_STRING
+# NO_PASSWORD_CONSOLE
+# QMAIL_DIR
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/modules b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/modules
new file mode 100644
index 0000000000000000000000000000000000000000..ef0354ee35fa363b303bb22c6ed0d2d1196aed52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/modules
@@ -0,0 +1,117 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# /etc/modules: kernel modules to load at boot time.
+#
+# This file contains the names of kernel modules that should be loaded
+# at boot time, one per line. Lines beginning with "#" are ignored.
+# Parameters can be specified after the module name.
+
+# Arch
+# ----
+# 
+# Modules for certains builds, contains support modules and some CPU-specific optimizations.
+
+{% if arch == "x86_64" -%}
+# Optimize for x86_64 cryptographic features
+twofish-x86_64-3way
+twofish-x86_64
+aes-x86_64
+salsa20-x86_64
+blowfish-x86_64
+{% endif -%}
+
+{% if cpuVendor == "intel" -%}
+# Intel-specific optimizations
+ghash-clmulni-intel
+aesni-intel
+kvm-intel
+{% endif -%}
+
+{% if cpuVendor == "amd" -%}
+# AMD-specific optimizations
+kvm-amd
+{% endif -%}
+
+kvm
+
+
+# Crypto
+# ------
+
+# Some core modules which comprise strong cryptography.
+blowfish_common
+blowfish_generic
+ctr
+cts
+lrw
+lzo
+rmd160
+rmd256
+rmd320
+serpent
+sha512_generic
+twofish_common
+twofish_generic
+xts
+zlib
+
+
+# Drivers
+# -------
+
+# Basics
+lp
+rtc
+loop
+
+# Filesystems
+ext2
+btrfs
+
+{% if desktop_enable -%}
+# Desktop
+psmouse
+snd
+snd_ac97_codec
+snd_intel8x0
+snd_page_alloc
+snd_pcm
+snd_timer
+soundcore
+usbhid
+{% endif -%}
+
+# Lib
+# ---
+xz
+
+
+# Net
+# ---
+
+# All packets needed for netfilter rules (ie iptables, ebtables).
+ip_tables
+x_tables
+iptable_filter
+iptable_nat
+
+# Targets
+ipt_LOG
+ipt_REJECT
+
+# Modules
+xt_connlimit
+xt_tcpudp
+xt_recent
+xt_limit
+xt_conntrack
+nf_conntrack
+nf_conntrack_ipv4
+nf_defrag_ipv4
+xt_state
+nf_nat
+
+# Addons
+xt_pknock
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f98d14e57428c106692e0f57e8b381f2b0a12c44
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: passwdqc password strength enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Password-Type: Primary
+Password:
+  requisite     pam_passwdqc.so {{ auth_pam_passwdqc_options }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
new file mode 100644
index 0000000000000000000000000000000000000000..fd2de791b96fbb8889811daf7340d1f2ca2ab3a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Disable core dumps via soft limits for all users. Compliance to this setting
+# is voluntary and can be modified by users up to a hard limit. This setting is
+# a sane default.
+ulimit -S -c 0 > /dev/null 2>&1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/securetty b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/securetty
new file mode 100644
index 0000000000000000000000000000000000000000..15b18d4e2f45747845d0b65c06997f154ef674a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/securetty
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# A list of TTYs, from which root can log in
+# see `man securetty` for reference
+{% if ttys -%}
+{% for tty in ttys -%}
+{{ tty }}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/tally2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/tally2
new file mode 100644
index 0000000000000000000000000000000000000000..d9620299c55e51abbee1017a227c217cd4a9fd33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/host/templates/tally2
@@ -0,0 +1,14 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: tally2 lockout after failed attempts enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Auth-Type: Primary
+Auth-Initial:
+  required      pam_tally2.so deny={{ auth_retries }} onerr=fail unlock_time={{ auth_lockout_time }}
+Account-Type: Primary
+Account-Initial:
+  required      pam_tally2.so
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1990d8513bbeef067a8d9a2168e1952efb2961dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.mysql.checks import config
+
+
+def run_mysql_checks():
+    log("Starting MySQL hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("MySQL hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..a79f33b74a5c2972a82f0b4d8de8d1073dc293ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/checks/config.py
@@ -0,0 +1,87 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.mysql import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get MySQL hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'mysql'], stdout=subprocess.PIPE) != 0:
+        log("MySQL does not appear to be installed on this node - "
+            "skipping mysql hardening", level=WARNING)
+        return []
+
+    settings = utils.get_settings('mysql')
+    hardening_settings = settings['hardening']
+    my_cnf = hardening_settings['mysql-conf']
+
+    audits = [
+        FilePermissionAudit(paths=[my_cnf], user='root',
+                            group='root', mode=0o0600),
+
+        TemplatedFile(hardening_settings['hardening-conf'],
+                      MySQLConfContext(),
+                      TEMPLATES_DIR,
+                      mode=0o0750,
+                      user='mysql',
+                      group='root',
+                      service_actions=[{'service': 'mysql',
+                                        'actions': ['restart']}]),
+
+        # MySQL and Percona charms do not allow configuration of the
+        # data directory, so use the default.
+        DirectoryPermissionAudit('/var/lib/mysql',
+                                 user='mysql',
+                                 group='mysql',
+                                 recursive=False,
+                                 mode=0o755),
+
+        DirectoryPermissionAudit('/etc/mysql',
+                                 user='root',
+                                 group='root',
+                                 recursive=False,
+                                 mode=0o700),
+    ]
+
+    return audits
+
+
+class MySQLConfContext(object):
+    """Defines the set of key/value pairs to set in a mysql config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/mysql/conf.d/hardening.cnf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('mysql')
+        # Translate for python3
+        return {'mysql_settings':
+                [(k, v) for k, v in six.iteritems(settings['security'])]}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
new file mode 100644
index 0000000000000000000000000000000000000000..8242586cd66360b7e6ae33f13018363b95cd4ea9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
@@ -0,0 +1,12 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+[mysqld]
+{% for setting, value in mysql_settings -%}
+{% if value == 'True' -%}
+{{ setting }}
+{% elif value != 'None' and value != None -%}
+{{ setting }} = {{ value }}
+{% endif -%}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edaf484b39f8c7353cebb2f4b68944c6493ba7b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.ssh.checks import config
+
+
+def run_ssh_checks():
+    log("Starting SSH hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("SSH hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..41bed2d1e7b031182edcf62710876e4073dfbc6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/checks/config.py
@@ -0,0 +1,435 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_iface_addr,
+    is_ip,
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    FileContentAudit,
+)
+from charmhelpers.contrib.hardening.ssh import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get SSH hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [SSHConfig(), SSHDConfig(), SSHConfigFileContentAudit(),
+              SSHDConfigFileContentAudit()]
+    return audits
+
+
+class SSHConfigContext(object):
+
+    type = 'client'
+
+    def get_macs(self, allow_weak_mac):
+        if allow_weak_mac:
+            weak_macs = 'weak'
+        else:
+            weak_macs = 'default'
+
+        default = 'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160'
+        macs = {'default': default,
+                'weak': default + ',hmac-sha1'}
+
+        default = ('hmac-sha2-512-etm@openssh.com,'
+                   'hmac-sha2-256-etm@openssh.com,'
+                   'hmac-ripemd160-etm@openssh.com,umac-128-etm@openssh.com,'
+                   'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160')
+        macs_66 = {'default': default,
+                   'weak': default + ',hmac-sha1'}
+
+        # Use newer ciphers on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log("Detected Ubuntu 14.04 or newer, using new macs", level=DEBUG)
+            macs = macs_66
+
+        return macs[weak_macs]
+
+    def get_kexs(self, allow_weak_kex):
+        if allow_weak_kex:
+            weak_kex = 'weak'
+        else:
+            weak_kex = 'default'
+
+        default = 'diffie-hellman-group-exchange-sha256'
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex = {'default': default,
+               'weak': weak}
+
+        default = ('curve25519-sha256@libssh.org,'
+                   'diffie-hellman-group-exchange-sha256')
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex_66 = {'default': default,
+                  'weak': weak}
+
+        # Use newer kex on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new key exchange '
+                'algorithms', level=DEBUG)
+            kex = kex_66
+
+        return kex[weak_kex]
+
+    def get_ciphers(self, cbc_required):
+        if cbc_required:
+            weak_ciphers = 'weak'
+        else:
+            weak_ciphers = 'default'
+
+        default = 'aes256-ctr,aes192-ctr,aes128-ctr'
+        cipher = {'default': default,
+                  'weak': default + 'aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        default = ('chacha20-poly1305@openssh.com,aes256-gcm@openssh.com,'
+                   'aes128-gcm@openssh.com,aes256-ctr,aes192-ctr,aes128-ctr')
+        ciphers_66 = {'default': default,
+                      'weak': default + ',aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        # Use newer ciphers on ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new ciphers',
+                level=DEBUG)
+            cipher = ciphers_66
+
+        return cipher[weak_ciphers]
+
+    def get_listening(self, listen=['0.0.0.0']):
+        """Returns a list of addresses SSH can list on
+
+        Turns input into a sensible list of IPs SSH can listen on. Input
+        must be a python list of interface names, IPs and/or CIDRs.
+
+        :param listen: list of IPs, CIDRs, interface names
+
+        :returns: list of IPs available on the host
+        """
+        if listen == ['0.0.0.0']:
+            return listen
+
+        value = []
+        for network in listen:
+            try:
+                ip = get_address_in_network(network=network, fatal=True)
+            except ValueError:
+                if is_ip(network):
+                    ip = network
+                else:
+                    try:
+                        ip = get_iface_addr(iface=network, fatal=False)[0]
+                    except IndexError:
+                        continue
+            value.append(ip)
+        if value == []:
+            return ['0.0.0.0']
+        return value
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'addr_family': addr_family,
+            'remote_hosts': settings['common']['remote_hosts'],
+            'password_auth_allowed':
+            settings['client']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'ciphers': self.get_ciphers(settings['client']['cbc_required']),
+            'macs': self.get_macs(settings['client']['weak_hmac']),
+            'kexs': self.get_kexs(settings['client']['weak_kex']),
+            'roaming': settings['client']['roaming'],
+        }
+        return ctxt
+
+
+class SSHConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/ssh_config'
+        super(SSHConfig, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=SSHConfigContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0644)
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['client']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHDConfigContext(SSHConfigContext):
+
+    type = 'server'
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'ssh_ip': self.get_listening(settings['server']['listen_to']),
+            'password_auth_allowed':
+            settings['server']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'addr_family': addr_family,
+            'ciphers': self.get_ciphers(settings['server']['cbc_required']),
+            'macs': self.get_macs(settings['server']['weak_hmac']),
+            'kexs': self.get_kexs(settings['server']['weak_kex']),
+            'host_key_files': settings['server']['host_key_files'],
+            'allow_root_with_key': settings['server']['allow_root_with_key'],
+            'password_authentication':
+            settings['server']['password_authentication'],
+            'use_priv_sep': settings['server']['use_privilege_separation'],
+            'use_pam': settings['server']['use_pam'],
+            'allow_x11_forwarding': settings['server']['allow_x11_forwarding'],
+            'print_motd': settings['server']['print_motd'],
+            'print_last_log': settings['server']['print_last_log'],
+            'client_alive_interval':
+            settings['server']['alive_interval'],
+            'client_alive_count': settings['server']['alive_count'],
+            'allow_tcp_forwarding': settings['server']['allow_tcp_forwarding'],
+            'allow_agent_forwarding':
+            settings['server']['allow_agent_forwarding'],
+            'deny_users': settings['server']['deny_users'],
+            'allow_users': settings['server']['allow_users'],
+            'deny_groups': settings['server']['deny_groups'],
+            'allow_groups': settings['server']['allow_groups'],
+            'use_dns': settings['server']['use_dns'],
+            'sftp_enable': settings['server']['sftp_enable'],
+            'sftp_group': settings['server']['sftp_group'],
+            'sftp_chroot': settings['server']['sftp_chroot'],
+            'max_auth_tries': settings['server']['max_auth_tries'],
+            'max_sessions': settings['server']['max_sessions'],
+        }
+        return ctxt
+
+
+class SSHDConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/sshd_config'
+        super(SSHDConfig, self).__init__(path=path,
+                                         template_dir=TEMPLATES_DIR,
+                                         context=SSHDConfigContext(),
+                                         user='root',
+                                         group='root',
+                                         mode=0o0600,
+                                         service_actions=[{'service': 'ssh',
+                                                           'actions':
+                                                           ['restart']}])
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['server']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/ssh_config'
+        super(SSHConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['client']['weak_hmac']:
+                self.fail_cases.append(r'^MACs.+,hmac-sha1$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['client']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['client']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['client']['roaming']:
+            self.pass_cases.append(r'^UseRoaming yes$')
+        else:
+            self.fail_cases.append(r'^UseRoaming yes$')
+
+        return super(SSHConfigFileContentAudit, self).is_compliant(*args,
+                                                                   **kwargs)
+
+
+class SSHDConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/sshd_config'
+        super(SSHDConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['server']['sftp_enable']:
+            self.pass_cases.append(r'^Subsystem\ssftp')
+        else:
+            self.fail_cases.append(r'^Subsystem\ssftp')
+
+        return super(SSHDConfigFileContentAudit, self).is_compliant(*args,
+                                                                    **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config
new file mode 100644
index 0000000000000000000000000000000000000000..9742d8e2a32cd5da01a9dcb691a5a1201ed93050
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/ssh_config
@@ -0,0 +1,70 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#       be overwritten.
+###############################################################################
+# This is the ssh client system-wide configuration file.  See
+# ssh_config(5) for more information.  This file provides defaults for
+# users, and the values can be changed in per-user configuration files
+# or on the command line.
+
+# Configuration data is parsed as follows:
+#  1. command line options
+#  2. user-specific file
+#  3. system-wide file
+# Any configuration value is only changed the first time it is set.
+# Thus, host-specific definitions should be at the beginning of the
+# configuration file, and defaults at the end.
+
+# Site-wide defaults for some commonly used options.  For a comprehensive
+# list of available options, their meanings and defaults, please see the
+# ssh_config(5) man page.
+
+# Restrict the following configuration to be limited to this Host.
+{% if remote_hosts -%}
+Host {{ ' '.join(remote_hosts) }}
+{% endif %}
+ForwardAgent no
+ForwardX11 no
+ForwardX11Trusted yes
+RhostsRSAAuthentication no
+RSAAuthentication yes
+PasswordAuthentication {{ password_auth_allowed }}
+HostbasedAuthentication no
+GSSAPIAuthentication no
+GSSAPIDelegateCredentials no
+GSSAPIKeyExchange no
+GSSAPITrustDNS no
+BatchMode no
+CheckHostIP yes
+AddressFamily {{ addr_family }}
+ConnectTimeout 0
+StrictHostKeyChecking ask
+IdentityFile ~/.ssh/identity
+IdentityFile ~/.ssh/id_rsa
+IdentityFile ~/.ssh/id_dsa
+# The port at the destination should be defined
+{% for port in ports -%}
+Port {{ port }}
+{% endfor %}
+Protocol 2
+Cipher 3des
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{%- endif %}
+{% if macs -%}
+MACs {{ macs }}
+{%- endif %}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{%- endif %}
+EscapeChar ~
+Tunnel no
+TunnelDevice any:any
+PermitLocalCommand no
+VisualHostKey no
+RekeyLimit 1G 1h
+SendEnv LANG LC_*
+HashKnownHosts yes
+{% if roaming -%}
+UseRoaming {{ roaming }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config
new file mode 100644
index 0000000000000000000000000000000000000000..5f87298a8119bcab1d2578bcaefd068e5af167c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/ssh/templates/sshd_config
@@ -0,0 +1,159 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Package generated configuration file
+# See the sshd_config(5) manpage for details
+
+# What ports, IPs and protocols we listen for
+{% for port in ports -%}
+Port {{ port }}
+{% endfor -%}
+AddressFamily {{ addr_family }}
+# Use these options to restrict which interfaces/protocols sshd will bind to
+{% if ssh_ip -%}
+{% for ip in ssh_ip -%}
+ListenAddress {{ ip }}
+{% endfor %}
+{%- else -%}
+ListenAddress ::
+ListenAddress 0.0.0.0
+{% endif -%}
+Protocol 2
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{% endif -%}
+{% if macs -%}
+MACs {{ macs }}
+{% endif -%}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{% endif -%}
+# HostKeys for protocol version 2
+{% for keyfile in host_key_files -%}
+HostKey {{ keyfile }}
+{% endfor -%}
+
+# Privilege Separation is turned on for security
+{% if use_priv_sep -%} 
+UsePrivilegeSeparation {{ use_priv_sep }}
+{% endif -%}
+
+# Lifetime and size of ephemeral version 1 server key
+KeyRegenerationInterval 3600
+ServerKeyBits 1024
+
+# Logging
+SyslogFacility AUTH
+LogLevel VERBOSE
+
+# Authentication:
+LoginGraceTime 30s
+{% if allow_root_with_key -%}
+PermitRootLogin without-password
+{% else -%}
+PermitRootLogin no
+{% endif %}
+PermitTunnel no
+PermitUserEnvironment no
+StrictModes yes
+
+RSAAuthentication yes
+PubkeyAuthentication yes
+AuthorizedKeysFile %h/.ssh/authorized_keys
+
+# Don't read the user's ~/.rhosts and ~/.shosts files
+IgnoreRhosts yes
+# For this to work you will also need host keys in /etc/ssh_known_hosts
+RhostsRSAAuthentication no
+# similar for protocol version 2
+HostbasedAuthentication no
+# Uncomment if you don't trust ~/.ssh/known_hosts for RhostsRSAAuthentication
+IgnoreUserKnownHosts yes
+
+# To enable empty passwords, change to yes (NOT RECOMMENDED)
+PermitEmptyPasswords no
+
+# Change to yes to enable challenge-response passwords (beware issues with
+# some PAM modules and threads)
+ChallengeResponseAuthentication no
+
+# Change to no to disable tunnelled clear text passwords
+PasswordAuthentication {{ password_authentication }}
+
+# Kerberos options
+KerberosAuthentication no
+KerberosGetAFSToken no
+KerberosOrLocalPasswd no
+KerberosTicketCleanup yes
+
+# GSSAPI options
+GSSAPIAuthentication no
+GSSAPICleanupCredentials yes
+
+X11Forwarding {{ allow_x11_forwarding }}
+X11DisplayOffset 10
+X11UseLocalhost yes
+GatewayPorts no
+PrintMotd {{ print_motd }}
+PrintLastLog {{ print_last_log }}
+TCPKeepAlive no
+UseLogin no
+
+ClientAliveInterval {{ client_alive_interval }}
+ClientAliveCountMax {{ client_alive_count }}
+AllowTcpForwarding {{ allow_tcp_forwarding }}
+AllowAgentForwarding {{ allow_agent_forwarding }}
+
+MaxStartups 10:30:100
+#Banner /etc/issue.net
+
+# Allow client to pass locale environment variables
+AcceptEnv LANG LC_*
+
+# Set this to 'yes' to enable PAM authentication, account processing,
+# and session processing. If this is enabled, PAM authentication will
+# be allowed through the ChallengeResponseAuthentication and
+# PasswordAuthentication.  Depending on your PAM configuration,
+# PAM authentication via ChallengeResponseAuthentication may bypass
+# the setting of "PermitRootLogin without-password".
+# If you just want the PAM account and session checks to run without
+# PAM authentication, then enable this but set PasswordAuthentication
+# and ChallengeResponseAuthentication to 'no'.
+UsePAM {{ use_pam }}
+
+{% if deny_users -%}
+DenyUsers {{ deny_users }}
+{% endif -%}
+{% if allow_users -%}
+AllowUsers {{ allow_users }}
+{% endif -%}
+{% if deny_groups -%}
+DenyGroups {{ deny_groups }}
+{% endif -%}
+{% if allow_groups -%}
+AllowGroups allow_groups
+{% endif -%}
+UseDNS {{ use_dns }}
+MaxAuthTries {{ max_auth_tries }}
+MaxSessions {{ max_sessions }}
+
+{% if sftp_enable -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+Subsystem sftp internal-sftp -l VERBOSE
+
+## These lines must appear at the *end* of sshd_config
+Match Group {{ sftp_group }}
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory {{ sftp_chroot }}
+{% else -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+## These lines must appear at the *end* of sshd_config
+Match Group sftponly
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory /sftpchroot/home/%u
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b6765f7edeee4bed739fd354c6f7bdf0a8c952e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/templating.py
@@ -0,0 +1,73 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+
+try:
+    from jinja2 import FileSystemLoader, Environment
+except ImportError:
+    from charmhelpers.fetch import apt_install
+    from charmhelpers.fetch import apt_update
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, Environment
+
+
+# NOTE: function separated from main rendering code to facilitate easier
+#       mocking in unit tests.
+def write(path, data):
+    with open(path, 'wb') as out:
+        out.write(data)
+
+
+def get_template_path(template_dir, path):
+    """Returns the template file which would be used to render the path.
+
+    The path to the template file is returned.
+    :param template_dir: the directory the templates are located in
+    :param path: the file path to be written to.
+    :returns: path to the template file
+    """
+    return os.path.join(template_dir, os.path.basename(path))
+
+
+def render_and_write(template_dir, path, context):
+    """Renders the specified template into the file.
+
+    :param template_dir: the directory to load the template from
+    :param path: the path to write the templated contents to
+    :param context: the parameters to pass to the rendering engine
+    """
+    env = Environment(loader=FileSystemLoader(template_dir))
+    template_file = os.path.basename(path)
+    template = env.get_template(template_file)
+    log('Rendering from template: %s' % template.name, level=DEBUG)
+    rendered_content = template.render(context)
+    if not rendered_content:
+        log("Render returned None - skipping '%s'" % path,
+            level=WARNING)
+        return
+
+    write(path, rendered_content.encode('utf-8').strip())
+    log('Wrote template %s' % path, level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff7485c28c8748ba366dba54f1e3b8f7e6a7c619
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/hardening/utils.py
@@ -0,0 +1,155 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import grp
+import os
+import pwd
+import six
+import yaml
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+
+
+# Global settings cache. Since each hook fire entails a fresh module import it
+# is safe to hold this in memory and not risk missing config changes (since
+# they will result in a new hook fire and thus re-import).
+__SETTINGS__ = {}
+
+
+def _get_defaults(modules):
+    """Load the default config for the provided modules.
+
+    :param modules: stack modules config defaults to lookup.
+    :returns: modules default config dictionary.
+    """
+    default = os.path.join(os.path.dirname(__file__),
+                           'defaults/%s.yaml' % (modules))
+    return yaml.safe_load(open(default))
+
+
+def _get_schema(modules):
+    """Load the config schema for the provided modules.
+
+    NOTE: this schema is intended to have 1-1 relationship with they keys in
+    the default config and is used a means to verify valid overrides provided
+    by the user.
+
+    :param modules: stack modules config schema to lookup.
+    :returns: modules default schema dictionary.
+    """
+    schema = os.path.join(os.path.dirname(__file__),
+                          'defaults/%s.yaml.schema' % (modules))
+    return yaml.safe_load(open(schema))
+
+
+def _get_user_provided_overrides(modules):
+    """Load user-provided config overrides.
+
+    :param modules: stack modules to lookup in user overrides yaml file.
+    :returns: overrides dictionary.
+    """
+    overrides = os.path.join(os.environ['JUJU_CHARM_DIR'],
+                             'hardening.yaml')
+    if os.path.exists(overrides):
+        log("Found user-provided config overrides file '%s'" %
+            (overrides), level=DEBUG)
+        settings = yaml.safe_load(open(overrides))
+        if settings and settings.get(modules):
+            log("Applying '%s' overrides" % (modules), level=DEBUG)
+            return settings.get(modules)
+
+        log("No overrides found for '%s'" % (modules), level=DEBUG)
+    else:
+        log("No hardening config overrides file '%s' found in charm "
+            "root dir" % (overrides), level=DEBUG)
+
+    return {}
+
+
+def _apply_overrides(settings, overrides, schema):
+    """Get overrides config overlayed onto modules defaults.
+
+    :param modules: require stack modules config.
+    :returns: dictionary of modules config with user overrides applied.
+    """
+    if overrides:
+        for k, v in six.iteritems(overrides):
+            if k in schema:
+                if schema[k] is None:
+                    settings[k] = v
+                elif type(schema[k]) is dict:
+                    settings[k] = _apply_overrides(settings[k], overrides[k],
+                                                   schema[k])
+                else:
+                    raise Exception("Unexpected type found in schema '%s'" %
+                                    type(schema[k]), level=ERROR)
+            else:
+                log("Unknown override key '%s' - ignoring" % (k), level=INFO)
+
+    return settings
+
+
+def get_settings(modules):
+    global __SETTINGS__
+    if modules in __SETTINGS__:
+        return __SETTINGS__[modules]
+
+    schema = _get_schema(modules)
+    settings = _get_defaults(modules)
+    overrides = _get_user_provided_overrides(modules)
+    __SETTINGS__[modules] = _apply_overrides(settings, overrides, schema)
+    return __SETTINGS__[modules]
+
+
+def ensure_permissions(path, user, group, permissions, maxdepth=-1):
+    """Ensure permissions for path.
+
+    If path is a file, apply to file and return. If path is a directory,
+    apply recursively (if required) to directory contents and return.
+
+    :param user: user name
+    :param group: group name
+    :param permissions: octal permissions
+    :param maxdepth: maximum recursion depth. A negative maxdepth allows
+                     infinite recursion and maxdepth=0 means no recursion.
+    :returns: None
+    """
+    if not os.path.exists(path):
+        log("File '%s' does not exist - cannot set permissions" % (path),
+            level=WARNING)
+        return
+
+    _user = pwd.getpwnam(user)
+    os.chown(path, _user.pw_uid, grp.getgrnam(group).gr_gid)
+    os.chmod(path, permissions)
+
+    if maxdepth == 0:
+        log("Max recursion depth reached - skipping further recursion",
+            level=DEBUG)
+        return
+    elif maxdepth > 0:
+        maxdepth -= 1
+
+    if os.path.isdir(path):
+        contents = glob.glob("%s/*" % (path))
+        for c in contents:
+            ensure_permissions(c, user=user, group=group,
+                               permissions=permissions, maxdepth=maxdepth)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/infiniband.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/infiniband.py
new file mode 100644
index 0000000000000000000000000000000000000000..0edb2314114738c79859f51e505de05e5c7c8fcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/mellanox/infiniband.py
@@ -0,0 +1,153 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+import six
+
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+try:
+    from netifaces import interfaces as network_interfaces
+except ImportError:
+    if six.PY2:
+        apt_install('python-netifaces')
+    else:
+        apt_install('python3-netifaces')
+    from netifaces import interfaces as network_interfaces
+
+import os
+import re
+import subprocess
+
+from charmhelpers.core.kernel import modprobe
+
+REQUIRED_MODULES = (
+    "mlx4_ib",
+    "mlx4_en",
+    "mlx4_core",
+    "ib_ipath",
+    "ib_mthca",
+    "ib_srpt",
+    "ib_srp",
+    "ib_ucm",
+    "ib_isert",
+    "ib_iser",
+    "ib_ipoib",
+    "ib_cm",
+    "ib_uverbs"
+    "ib_umad",
+    "ib_sa",
+    "ib_mad",
+    "ib_core",
+    "ib_addr",
+    "rdma_ucm",
+)
+
+REQUIRED_PACKAGES = (
+    "ibutils",
+    "infiniband-diags",
+    "ibverbs-utils",
+)
+
+IPOIB_DRIVERS = (
+    "ib_ipoib",
+)
+
+ABI_VERSION_FILE = "/sys/class/infiniband_mad/abi_version"
+
+
+class DeviceInfo(object):
+    pass
+
+
+def install_packages():
+    apt_update()
+    apt_install(REQUIRED_PACKAGES, fatal=True)
+
+
+def load_modules():
+    for module in REQUIRED_MODULES:
+        modprobe(module, persist=True)
+
+
+def is_enabled():
+    """Check if infiniband is loaded on the system"""
+    return os.path.exists(ABI_VERSION_FILE)
+
+
+def stat():
+    """Return full output of ibstat"""
+    return subprocess.check_output(["ibstat"])
+
+
+def devices():
+    """Returns a list of IB enabled devices"""
+    return subprocess.check_output(['ibstat', '-l']).splitlines()
+
+
+def device_info(device):
+    """Returns a DeviceInfo object with the current device settings"""
+
+    status = subprocess.check_output([
+        'ibstat', device, '-s']).splitlines()
+
+    regexes = {
+        "CA type: (.*)": "device_type",
+        "Number of ports: (.*)": "num_ports",
+        "Firmware version: (.*)": "fw_ver",
+        "Hardware version: (.*)": "hw_ver",
+        "Node GUID: (.*)": "node_guid",
+        "System image GUID: (.*)": "sys_guid",
+    }
+
+    device = DeviceInfo()
+
+    for line in status:
+        for expression, key in regexes.items():
+            matches = re.search(expression, line)
+            if matches:
+                setattr(device, key, matches.group(1))
+
+    return device
+
+
+def ipoib_interfaces():
+    """Return a list of IPOIB capable ethernet interfaces"""
+    interfaces = []
+
+    for interface in network_interfaces():
+        try:
+            driver = re.search('^driver: (.+)$', subprocess.check_output([
+                'ethtool', '-i',
+                interface]), re.M).group(1)
+
+            if driver in IPOIB_DRIVERS:
+                interfaces.append(interface)
+        except Exception:
+            log("Skipping interface %s" % interface, level=INFO)
+            continue
+
+    return interfaces
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..b13277bb57c9227b1d9dfecf4f6750740e5a262a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ip.py
@@ -0,0 +1,602 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import re
+import subprocess
+import six
+import socket
+
+from functools import partial
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    network_get_primary_address,
+    unit_get,
+    WARNING,
+    NoNetworkBinding,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+
+try:
+    import netifaces
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netifaces', fatal=True)
+    else:
+        apt_install('python3-netifaces', fatal=True)
+    import netifaces
+
+try:
+    import netaddr
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netaddr', fatal=True)
+    else:
+        apt_install('python3-netaddr', fatal=True)
+    import netaddr
+
+
+def _validate_cidr(network):
+    try:
+        netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+
+def no_ip_found_error_out(network):
+    errmsg = ("No IP address found in network(s): %s" % network)
+    raise ValueError(errmsg)
+
+
+def _get_ipv6_network_from_address(address):
+    """Get an netaddr.IPNetwork for the given IPv6 address
+    :param address: a dict as returned by netifaces.ifaddresses
+    :returns netaddr.IPNetwork: None if the address is a link local or loopback
+    address
+    """
+    if address['addr'].startswith('fe80') or address['addr'] == "::1":
+        return None
+
+    prefix = address['netmask'].split("/")
+    if len(prefix) > 1:
+        netmask = prefix[1]
+    else:
+        netmask = address['netmask']
+    return netaddr.IPNetwork("%s/%s" % (address['addr'],
+                                        netmask))
+
+
+def get_address_in_network(network, fallback=None, fatal=False):
+    """Get an IPv4 or IPv6 address within the network from the host.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'. Supports multiple networks as a space-delimited list.
+    :param fallback (str): If no address is found, return fallback.
+    :param fatal (boolean): If no address is found, fallback is not
+        set and fatal is True then exit(1).
+    """
+    if network is None:
+        if fallback is not None:
+            return fallback
+
+        if fatal:
+            no_ip_found_error_out(network)
+        else:
+            return None
+
+    networks = network.split() or [network]
+    for network in networks:
+        _validate_cidr(network)
+        network = netaddr.IPNetwork(network)
+        for iface in netifaces.interfaces():
+            try:
+                addresses = netifaces.ifaddresses(iface)
+            except ValueError:
+                # If an instance was deleted between
+                # netifaces.interfaces() run and now, its interfaces are gone
+                continue
+            if network.version == 4 and netifaces.AF_INET in addresses:
+                for addr in addresses[netifaces.AF_INET]:
+                    cidr = netaddr.IPNetwork("%s/%s" % (addr['addr'],
+                                                        addr['netmask']))
+                    if cidr in network:
+                        return str(cidr.ip)
+
+            if network.version == 6 and netifaces.AF_INET6 in addresses:
+                for addr in addresses[netifaces.AF_INET6]:
+                    cidr = _get_ipv6_network_from_address(addr)
+                    if cidr and cidr in network:
+                        return str(cidr.ip)
+
+    if fallback is not None:
+        return fallback
+
+    if fatal:
+        no_ip_found_error_out(network)
+
+    return None
+
+
+def is_ipv6(address):
+    """Determine whether provided address is IPv6 or not."""
+    try:
+        address = netaddr.IPAddress(address)
+    except netaddr.AddrFormatError:
+        # probably a hostname - so not an address at all!
+        return False
+
+    return address.version == 6
+
+
+def is_address_in_network(network, address):
+    """
+    Determine whether the provided address is within a network range.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'.
+    :param address: An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :returns boolean: Flag indicating whether address is in network.
+    """
+    try:
+        network = netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+    try:
+        address = netaddr.IPAddress(address)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Address (%s) is not in correct presentation format" %
+                         address)
+
+    if address in network:
+        return True
+    else:
+        return False
+
+
+def _get_for_address(address, key):
+    """Retrieve an attribute of or the physical interface that
+    the IP address provided could be bound to.
+
+    :param address (str): An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :param key: 'iface' for the physical interface name or an attribute
+        of the configured interface, for example 'netmask'.
+    :returns str: Requested attribute or None if address is not bindable.
+    """
+    address = netaddr.IPAddress(address)
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        if address.version == 4 and netifaces.AF_INET in addresses:
+            addr = addresses[netifaces.AF_INET][0]['addr']
+            netmask = addresses[netifaces.AF_INET][0]['netmask']
+            network = netaddr.IPNetwork("%s/%s" % (addr, netmask))
+            cidr = network.cidr
+            if address in cidr:
+                if key == 'iface':
+                    return iface
+                else:
+                    return addresses[netifaces.AF_INET][0][key]
+
+        if address.version == 6 and netifaces.AF_INET6 in addresses:
+            for addr in addresses[netifaces.AF_INET6]:
+                network = _get_ipv6_network_from_address(addr)
+                if not network:
+                    continue
+
+                cidr = network.cidr
+                if address in cidr:
+                    if key == 'iface':
+                        return iface
+                    elif key == 'netmask' and cidr:
+                        return str(cidr).split('/')[1]
+                    else:
+                        return addr[key]
+    return None
+
+
+get_iface_for_address = partial(_get_for_address, key='iface')
+
+
+get_netmask_for_address = partial(_get_for_address, key='netmask')
+
+
+def resolve_network_cidr(ip_address):
+    '''
+    Resolves the full address cidr of an ip_address based on
+    configured network interfaces
+    '''
+    netmask = get_netmask_for_address(ip_address)
+    return str(netaddr.IPNetwork("%s/%s" % (ip_address, netmask)).cidr)
+
+
+def format_ipv6_addr(address):
+    """If address is IPv6, wrap it in '[]' otherwise return None.
+
+    This is required by most configuration files when specifying IPv6
+    addresses.
+    """
+    if is_ipv6(address):
+        return "[%s]" % address
+
+    return None
+
+
+def is_ipv6_disabled():
+    try:
+        result = subprocess.check_output(
+            ['sysctl', 'net.ipv6.conf.all.disable_ipv6'],
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+    except subprocess.CalledProcessError:
+        return True
+
+    return "net.ipv6.conf.all.disable_ipv6 = 1" in result
+
+
+def get_iface_addr(iface='eth0', inet_type='AF_INET', inc_aliases=False,
+                   fatal=True, exc_list=None):
+    """Return the assigned IP address for a given interface, if any.
+
+    :param iface: network interface on which address(es) are expected to
+                  be found.
+    :param inet_type: inet address family
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :return: list of ip addresses
+    """
+    # Extract nic if passed /dev/ethX
+    if '/' in iface:
+        iface = iface.split('/')[-1]
+
+    if not exc_list:
+        exc_list = []
+
+    try:
+        inet_num = getattr(netifaces, inet_type)
+    except AttributeError:
+        raise Exception("Unknown inet type '%s'" % str(inet_type))
+
+    interfaces = netifaces.interfaces()
+    if inc_aliases:
+        ifaces = []
+        for _iface in interfaces:
+            if iface == _iface or _iface.split(':')[0] == iface:
+                ifaces.append(_iface)
+
+        if fatal and not ifaces:
+            raise Exception("Invalid interface '%s'" % iface)
+
+        ifaces.sort()
+    else:
+        if iface not in interfaces:
+            if fatal:
+                raise Exception("Interface '%s' not found " % (iface))
+            else:
+                return []
+
+        else:
+            ifaces = [iface]
+
+    addresses = []
+    for netiface in ifaces:
+        net_info = netifaces.ifaddresses(netiface)
+        if inet_num in net_info:
+            for entry in net_info[inet_num]:
+                if 'addr' in entry and entry['addr'] not in exc_list:
+                    addresses.append(entry['addr'])
+
+    if fatal and not addresses:
+        raise Exception("Interface '%s' doesn't have any %s addresses." %
+                        (iface, inet_type))
+
+    return sorted(addresses)
+
+
+get_ipv4_addr = partial(get_iface_addr, inet_type='AF_INET')
+
+
+def get_iface_from_addr(addr):
+    """Work out on which interface the provided address is configured."""
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        for inet_type in addresses:
+            for _addr in addresses[inet_type]:
+                _addr = _addr['addr']
+                # link local
+                ll_key = re.compile("(.+)%.*")
+                raw = re.match(ll_key, _addr)
+                if raw:
+                    _addr = raw.group(1)
+
+                if _addr == addr:
+                    log("Address '%s' is configured on iface '%s'" %
+                        (addr, iface))
+                    return iface
+
+    msg = "Unable to infer net iface on which '%s' is configured" % (addr)
+    raise Exception(msg)
+
+
+def sniff_iface(f):
+    """Ensure decorated function is called with a value for iface.
+
+    If no iface provided, inject net iface inferred from unit private address.
+    """
+    def iface_sniffer(*args, **kwargs):
+        if not kwargs.get('iface', None):
+            kwargs['iface'] = get_iface_from_addr(unit_get('private-address'))
+
+        return f(*args, **kwargs)
+
+    return iface_sniffer
+
+
+@sniff_iface
+def get_ipv6_addr(iface=None, inc_aliases=False, fatal=True, exc_list=None,
+                  dynamic_only=True):
+    """Get assigned IPv6 address for a given interface.
+
+    Returns list of addresses found. If no address found, returns empty list.
+
+    If iface is None, we infer the current primary interface by doing a reverse
+    lookup on the unit private-address.
+
+    We currently only support scope global IPv6 addresses i.e. non-temporary
+    addresses. If no global IPv6 address is found, return the first one found
+    in the ipv6 address list.
+
+    :param iface: network interface on which ipv6 address(es) are expected to
+                  be found.
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :param dynamic_only: only recognise dynamic addresses
+    :return: list of ipv6 addresses
+    """
+    addresses = get_iface_addr(iface=iface, inet_type='AF_INET6',
+                               inc_aliases=inc_aliases, fatal=fatal,
+                               exc_list=exc_list)
+
+    if addresses:
+        global_addrs = []
+        for addr in addresses:
+            key_scope_link_local = re.compile("^fe80::..(.+)%(.+)")
+            m = re.match(key_scope_link_local, addr)
+            if m:
+                eui_64_mac = m.group(1)
+                iface = m.group(2)
+            else:
+                global_addrs.append(addr)
+
+        if global_addrs:
+            # Make sure any found global addresses are not temporary
+            cmd = ['ip', 'addr', 'show', iface]
+            out = subprocess.check_output(cmd).decode('UTF-8')
+            if dynamic_only:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.* dynamic.*")
+            else:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.*")
+
+            addrs = []
+            for line in out.split('\n'):
+                line = line.strip()
+                m = re.match(key, line)
+                if m and 'temporary' not in line:
+                    # Return the first valid address we find
+                    for addr in global_addrs:
+                        if m.group(1) == addr:
+                            if not dynamic_only or \
+                                    m.group(1).endswith(eui_64_mac):
+                                addrs.append(addr)
+
+            if addrs:
+                return addrs
+
+    if fatal:
+        raise Exception("Interface '%s' does not have a scope global "
+                        "non-temporary ipv6 address." % iface)
+
+    return []
+
+
+def get_bridges(vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of bridges on the system."""
+    b_regex = "%s/*/bridge" % vnic_dir
+    return [x.replace(vnic_dir, '').split('/')[1] for x in glob.glob(b_regex)]
+
+
+def get_bridge_nics(bridge, vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of nics comprising a given bridge on the system."""
+    brif_regex = "%s/%s/brif/*" % (vnic_dir, bridge)
+    return [x.split('/')[-1] for x in glob.glob(brif_regex)]
+
+
+def is_bridge_member(nic):
+    """Check if a given nic is a member of a bridge."""
+    for bridge in get_bridges():
+        if nic in get_bridge_nics(bridge):
+            return True
+
+    return False
+
+
+def is_ip(address):
+    """
+    Returns True if address is a valid IP address.
+    """
+    try:
+        # Test to see if already an IPv4/IPv6 address
+        address = netaddr.IPAddress(address)
+        return True
+    except (netaddr.AddrFormatError, ValueError):
+        return False
+
+
+def ns_query(address):
+    try:
+        import dns.resolver
+    except ImportError:
+        if six.PY2:
+            apt_install('python-dnspython', fatal=True)
+        else:
+            apt_install('python3-dnspython', fatal=True)
+        import dns.resolver
+
+    if isinstance(address, dns.name.Name):
+        rtype = 'PTR'
+    elif isinstance(address, six.string_types):
+        rtype = 'A'
+    else:
+        return None
+
+    try:
+        answers = dns.resolver.query(address, rtype)
+    except dns.resolver.NXDOMAIN:
+        return None
+
+    if answers:
+        return str(answers[0])
+    return None
+
+
+def get_host_ip(hostname, fallback=None):
+    """
+    Resolves the IP for a given hostname, or returns
+    the input if it is already an IP.
+    """
+    if is_ip(hostname):
+        return hostname
+
+    ip_addr = ns_query(hostname)
+    if not ip_addr:
+        try:
+            ip_addr = socket.gethostbyname(hostname)
+        except Exception:
+            log("Failed to resolve hostname '%s'" % (hostname),
+                level=WARNING)
+            return fallback
+    return ip_addr
+
+
+def get_hostname(address, fqdn=True):
+    """
+    Resolves hostname for given IP, or returns the input
+    if it is already a hostname.
+    """
+    if is_ip(address):
+        try:
+            import dns.reversename
+        except ImportError:
+            if six.PY2:
+                apt_install("python-dnspython", fatal=True)
+            else:
+                apt_install("python3-dnspython", fatal=True)
+            import dns.reversename
+
+        rev = dns.reversename.from_address(address)
+        result = ns_query(rev)
+
+        if not result:
+            try:
+                result = socket.gethostbyaddr(address)[0]
+            except Exception:
+                return None
+    else:
+        result = address
+
+    if fqdn:
+        # strip trailing .
+        if result.endswith('.'):
+            return result[:-1]
+        else:
+            return result
+    else:
+        return result.split('.')[0]
+
+
+def port_has_listener(address, port):
+    """
+    Returns True if the address:port is open and being listened to,
+    else False.
+
+    @param address: an IP address or hostname
+    @param port: integer port
+
+    Note calls 'zc' via a subprocess shell
+    """
+    cmd = ['nc', '-z', address, str(port)]
+    result = subprocess.call(cmd)
+    return not(bool(result))
+
+
+def assert_charm_supports_ipv6():
+    """Check whether we are able to support charms ipv6."""
+    release = lsb_release()['DISTRIB_CODENAME'].lower()
+    if CompareHostReleases(release) < "trusty":
+        raise Exception("IPv6 is not supported in the charms for Ubuntu "
+                        "versions less than Trusty 14.04")
+
+
+def get_relation_ip(interface, cidr_network=None):
+    """Return this unit's IP for the given interface.
+
+    Allow for an arbitrary interface to use with network-get to select an IP.
+    Handle all address selection options including passed cidr network and
+    IPv6.
+
+    Usage: get_relation_ip('amqp', cidr_network='10.0.0.0/8')
+
+    @param interface: string name of the relation.
+    @param cidr_network: string CIDR Network to select an address from.
+    @raises Exception if prefer-ipv6 is configured but IPv6 unsupported.
+    @returns IPv6 or IPv4 address
+    """
+    # Select the interface address first
+    # For possible use as a fallback bellow with get_address_in_network
+    try:
+        # Get the interface specific IP
+        address = network_get_primary_address(interface)
+    except NotImplementedError:
+        # If network-get is not available
+        address = get_host_ip(unit_get('private-address'))
+    except NoNetworkBinding:
+        log("No network binding for {}".format(interface), WARNING)
+        address = get_host_ip(unit_get('private-address'))
+
+    if config('prefer-ipv6'):
+        # Currently IPv6 has priority, eventually we want IPv6 to just be
+        # another network space.
+        assert_charm_supports_ipv6()
+        return get_ipv6_addr()[0]
+    elif cidr_network:
+        # If a specific CIDR network is passed get the address from that
+        # network.
+        return get_address_in_network(cidr_network, address)
+
+    # Return the interface address
+    return address
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd001bc2eaa9b1b511bbd1816e1089521935a50a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/__init__.py
@@ -0,0 +1,541 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helpers for interacting with OpenvSwitch '''
+import hashlib
+import subprocess
+import os
+import six
+
+from charmhelpers.fetch import apt_install
+
+
+from charmhelpers.core.hookenv import (
+    log, WARNING, INFO, DEBUG
+)
+from charmhelpers.core.host import (
+    service
+)
+
+
+BRIDGE_TEMPLATE = """\
+# This veth pair is required when neutron data-port is mapped to an existing linux bridge. lp:1635067
+
+auto {linuxbridge_port}
+iface {linuxbridge_port} inet manual
+    pre-up ip link add name {linuxbridge_port} type veth peer name {ovsbridge_port}
+    pre-up ip link set {ovsbridge_port} master {bridge}
+    pre-up ip link set {ovsbridge_port} up
+    up ip link set {linuxbridge_port} up
+    down ip link del {linuxbridge_port}
+"""
+
+MAX_KERNEL_INTERFACE_NAME_LEN = 15
+
+
+def get_bridges():
+    """Return list of the bridges on the default openvswitch
+
+    :returns: List of bridge names
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if ovs-vsctl fails
+    """
+    cmd = ["ovs-vsctl", "list-br"]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_bridges = [l.strip() for l in lines]
+    return [b for b in maybe_bridges if b]
+
+
+def get_bridge_ports(name):
+    """Return a list the ports on a named bridge
+
+    :param name: the name of the bridge to list
+    :type name: str
+    :returns: List of ports on the named bridge
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if the ovs-vsctl command fails. If
+        the named bridge doesn't exist, then the exception will be raised.
+    """
+    cmd = ["ovs-vsctl", "--", "list-ports", name]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_ports = [l.strip() for l in lines]
+    return [p for p in maybe_ports if p]
+
+
+def get_bridges_and_ports_map():
+    """Return dictionary of bridge to ports for the default openvswitch
+
+    :returns: a mapping of bridge name to a list of ports.
+    :rtype: Dict[str, List[str]]
+    :raises: subprocess.CalledProcessError if any of the underlying ovs-vsctl
+        command fail.
+    """
+    return {b: get_bridge_ports(b) for b in get_bridges()}
+
+
+def _dict_to_vsctl_set(data, table, entity):
+    """Helper that takes dictionary and provides ``ovs-vsctl set`` commands
+
+    :param data: Additional data to attach to interface
+        The keys in the data dictionary map directly to column names in the
+        OpenvSwitch table specified as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type data: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param table: Name of table to operate on
+    :type table: str
+    :param entity: Name of entity to operate on
+    :type entity: str
+    :returns: '--' separated ``ovs-vsctl set`` commands
+    :rtype: Iterator[Tuple[str, str, str, str, str]]
+    """
+    for (k, v) in data.items():
+        if isinstance(v, dict):
+            entries = {
+                '{}:{}'.format(k, dk): dv for (dk, dv) in v.items()}
+        else:
+            entries = {k: v}
+        for (colk, colv) in entries.items():
+            yield ('--', 'set', table, entity, '{}={}'.format(colk, colv))
+
+
+def add_bridge(name, datapath_type=None, brdata=None, exclusive=False):
+    """Add the named bridge to openvswitch and set/update bridge data for it
+
+    :param name: Name of bridge to create
+    :type name: str
+    :param datapath_type: Add datapath_type to bridge (DEPRECATED, use brdata)
+    :type datapath_type: Optional[str]
+    :param brdata: Additional data to attach to bridge
+        The keys in the brdata dictionary map directly to column names in the
+        OpenvSwitch bridge table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type brdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if bridge exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    log('Creating bridge {}'.format(name))
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-br', name))
+    if brdata:
+        for setcmd in _dict_to_vsctl_set(brdata, 'bridge', name):
+            cmd.extend(setcmd)
+    if datapath_type is not None:
+        log('DEPRECATION WARNING: add_bridge called with datapath_type, '
+            'please use the brdata keyword argument instead.')
+        cmd += ['--', 'set', 'bridge', name,
+                'datapath_type={}'.format(datapath_type)]
+    subprocess.check_call(cmd)
+
+
+def del_bridge(name):
+    """Delete the named bridge from openvswitch
+
+    :param name: Name of bridge to remove
+    :type name: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting bridge {}'.format(name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-br", name])
+
+
+def add_bridge_port(name, port, promisc=False, ifdata=None, exclusive=False,
+                    linkup=True, portdata=None):
+    """Add port to bridge and optionally set/update interface data for it
+
+    :param name: Name of bridge to attach port to
+    :type name: str
+    :param port: Name of port as represented in netdev
+    :type port: str
+    :param promisc: Whether to set promiscuous mode on interface
+                    True=on, False=off, None leave untouched
+    :type promisc: Optional[bool]
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :param linkup: Bring link up
+    :type linkup: bool
+    :param portdata: Additional data to attach to port. Similar to ifdata.
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-port', name, port))
+    for ovs_table, data in (('Interface', ifdata), ('Port', portdata)):
+        if data:
+            for setcmd in _dict_to_vsctl_set(data, ovs_table, port):
+                cmd.extend(setcmd)
+
+    log('Adding port {} to bridge {}'.format(port, name))
+    subprocess.check_call(cmd)
+    if linkup:
+        # This is mostly a workaround for CI environments, in the real world
+        # the bare metal provider would most likely have configured and brought
+        # up the link for us.
+        subprocess.check_call(["ip", "link", "set", port, "up"])
+    if promisc:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "on"])
+    elif promisc is False:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def del_bridge_port(name, port):
+    """Delete a port from the named openvswitch bridge
+
+    :param name: Name of bridge to remove port from
+    :type name: str
+    :param port: Name of port to remove
+    :type port: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting port {} from bridge {}'.format(port, name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-port",
+                           name, port])
+    subprocess.check_call(["ip", "link", "set", port, "down"])
+    subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def add_bridge_bond(bridge, port, interfaces, portdata=None, ifdatamap=None,
+                    exclusive=False):
+    """Add bonded port in bridge from interfaces.
+
+    :param bridge: Name of bridge to add bonded port to
+    :type bridge: str
+    :param port: Name of created port
+    :type port: str
+    :param interfaces: Underlying interfaces that make up the bonded port
+    :type interfaces: Iterator[str]
+    :param portdata: Additional data to attach to the created bond port
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'bond-mode': 'balance-tcp',
+            'lacp': 'active',
+            'other-config': {
+                'lacp-time': 'fast',
+            },
+        }
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param ifdatamap: Map of data to attach to created bond interfaces
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'eth0': {
+                'type': 'dpdk',
+                'mtu-request': '9000',
+                'options': {
+                    'dpdk-devargs': '0000:01:00.0',
+                },
+            },
+        }
+    :type ifdatamap: Optional[Dict[str,Dict[str,Union[str,Dict[str,str]]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-bond', bridge, port))
+    cmd.extend(interfaces)
+    if portdata:
+        for setcmd in _dict_to_vsctl_set(portdata, 'port', port):
+            cmd.extend(setcmd)
+    if ifdatamap:
+        for ifname, ifdata in ifdatamap.items():
+            for setcmd in _dict_to_vsctl_set(ifdata, 'Interface', ifname):
+                cmd.extend(setcmd)
+    subprocess.check_call(cmd)
+
+
+def add_ovsbridge_linuxbridge(name, bridge, ifdata=None):
+    """Add linux bridge to the named openvswitch bridge
+
+    :param name: Name of ovs bridge to be added to Linux bridge
+    :type name: str
+    :param bridge: Name of Linux bridge to be added to ovs bridge
+    :type name: str
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    """
+    try:
+        import netifaces
+    except ImportError:
+        if six.PY2:
+            apt_install('python-netifaces', fatal=True)
+        else:
+            apt_install('python3-netifaces', fatal=True)
+        import netifaces
+
+    # NOTE(jamespage):
+    # Older code supported addition of a linuxbridge directly
+    # to an OVS bridge; ensure we don't break uses on upgrade
+    existing_ovs_bridge = port_to_br(bridge)
+    if existing_ovs_bridge is not None:
+        log('Linuxbridge {} is already directly in use'
+            ' by OVS bridge {}'.format(bridge, existing_ovs_bridge),
+            level=INFO)
+        return
+
+    # NOTE(jamespage):
+    # preserve existing naming because interfaces may already exist.
+    ovsbridge_port = "veth-" + name
+    linuxbridge_port = "veth-" + bridge
+    if (len(ovsbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN or
+            len(linuxbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN):
+        # NOTE(jamespage):
+        # use parts of hashed bridgename (openstack style) when
+        # a bridge name exceeds 15 chars
+        hashed_bridge = hashlib.sha256(bridge.encode('UTF-8')).hexdigest()
+        base = '{}-{}'.format(hashed_bridge[:8], hashed_bridge[-2:])
+        ovsbridge_port = "cvo{}".format(base)
+        linuxbridge_port = "cvb{}".format(base)
+
+    interfaces = netifaces.interfaces()
+    for interface in interfaces:
+        if interface == ovsbridge_port or interface == linuxbridge_port:
+            log('Interface {} already exists'.format(interface), level=INFO)
+            return
+
+    log('Adding linuxbridge {} to ovsbridge {}'.format(bridge, name),
+        level=INFO)
+
+    check_for_eni_source()
+
+    with open('/etc/network/interfaces.d/{}.cfg'.format(
+            linuxbridge_port), 'w') as config:
+        config.write(BRIDGE_TEMPLATE.format(linuxbridge_port=linuxbridge_port,
+                                            ovsbridge_port=ovsbridge_port,
+                                            bridge=bridge))
+
+    subprocess.check_call(["ifup", linuxbridge_port])
+    add_bridge_port(name, linuxbridge_port, ifdata=ifdata)
+
+
+def is_linuxbridge_interface(port):
+    ''' Check if the interface is a linuxbridge bridge
+    :param port: Name of an interface to check whether it is a Linux bridge
+    :returns: True if port is a Linux bridge'''
+
+    if os.path.exists('/sys/class/net/' + port + '/bridge'):
+        log('Interface {} is a Linux bridge'.format(port), level=DEBUG)
+        return True
+    else:
+        log('Interface {} is not a Linux bridge'.format(port), level=DEBUG)
+        return False
+
+
+def set_manager(manager):
+    ''' Set the controller for the local openvswitch '''
+    log('Setting manager for local ovs to {}'.format(manager))
+    subprocess.check_call(['ovs-vsctl', 'set-manager',
+                           'ssl:{}'.format(manager)])
+
+
+def set_Open_vSwitch_column_value(column_value):
+    """
+    Calls ovs-vsctl and sets the 'column_value' in the Open_vSwitch table.
+
+    :param column_value:
+            See http://www.openvswitch.org//ovs-vswitchd.conf.db.5.pdf for
+            details of the relevant values.
+    :type str
+    :raises CalledProcessException: possibly ovsdb-server is not running
+    """
+    log('Setting {} in the Open_vSwitch table'.format(column_value))
+    subprocess.check_call(['ovs-vsctl', 'set', 'Open_vSwitch', '.', column_value])
+
+
+CERT_PATH = '/etc/openvswitch/ovsclient-cert.pem'
+
+
+def get_certificate():
+    ''' Read openvswitch certificate from disk '''
+    if os.path.exists(CERT_PATH):
+        log('Reading ovs certificate from {}'.format(CERT_PATH))
+        with open(CERT_PATH, 'r') as cert:
+            full_cert = cert.read()
+            begin_marker = "-----BEGIN CERTIFICATE-----"
+            end_marker = "-----END CERTIFICATE-----"
+            begin_index = full_cert.find(begin_marker)
+            end_index = full_cert.rfind(end_marker)
+            if end_index == -1 or begin_index == -1:
+                raise RuntimeError("Certificate does not contain valid begin"
+                                   " and end markers.")
+            full_cert = full_cert[begin_index:(end_index + len(end_marker))]
+            return full_cert
+    else:
+        log('Certificate not found', level=WARNING)
+        return None
+
+
+def check_for_eni_source():
+    ''' Juju removes the source line when setting up interfaces,
+    replace if missing '''
+
+    with open('/etc/network/interfaces', 'r') as eni:
+        for line in eni:
+            if line == 'source /etc/network/interfaces.d/*':
+                return
+    with open('/etc/network/interfaces', 'a') as eni:
+        eni.write('\nsource /etc/network/interfaces.d/*')
+
+
+def full_restart():
+    ''' Full restart and reload of openvswitch '''
+    if os.path.exists('/etc/init/openvswitch-force-reload-kmod.conf'):
+        service('start', 'openvswitch-force-reload-kmod')
+    else:
+        service('force-reload-kmod', 'openvswitch-switch')
+
+
+def enable_ipfix(bridge, target,
+                 cache_active_timeout=60,
+                 cache_max_flows=128,
+                 sampling=64):
+    '''Enable IPFIX on bridge to target.
+    :param bridge: Bridge to monitor
+    :param target: IPFIX remote endpoint
+    :param cache_active_timeout: The maximum period in seconds for
+                                 which an IPFIX flow record is cached
+                                 and aggregated before being sent
+    :param cache_max_flows: The maximum number of IPFIX flow records
+                            that can be cached at a time
+    :param sampling: The rate at which packets should be sampled and
+                     sent to each target collector
+    '''
+    cmd = [
+        'ovs-vsctl', 'set', 'Bridge', bridge, 'ipfix=@i', '--',
+        '--id=@i', 'create', 'IPFIX',
+        'targets="{}"'.format(target),
+        'sampling={}'.format(sampling),
+        'cache_active_timeout={}'.format(cache_active_timeout),
+        'cache_max_flows={}'.format(cache_max_flows),
+    ]
+    log('Enabling IPfix on {}.'.format(bridge))
+    subprocess.check_call(cmd)
+
+
+def disable_ipfix(bridge):
+    '''Diable IPFIX on target bridge.
+    :param bridge: Bridge to modify
+    '''
+    cmd = ['ovs-vsctl', 'clear', 'Bridge', bridge, 'ipfix']
+    subprocess.check_call(cmd)
+
+
+def port_to_br(port):
+    '''Determine the bridge that contains a port
+    :param port: Name of port to check for
+    :returns str: OVS bridge containing port or None if not found
+    '''
+    try:
+        return subprocess.check_output(
+            ['ovs-vsctl', 'port-to-br', port]
+        ).decode('UTF-8').strip()
+    except subprocess.CalledProcessError:
+        return None
+
+
+def ovs_appctl(target, args):
+    """Run `ovs-appctl` for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovs-appctl` looks for a pidfile and will build the path to
+                   a /var/run/openvswitch/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovs-appctl`
+    :type args: Tuple[str, ...]
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-appctl', '-t', target]
+    cmd.extend(args)
+    return subprocess.check_output(cmd, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovn.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovn.py
new file mode 100644
index 0000000000000000000000000000000000000000..2075f11acfbeb3d0d614cf3db5a1b535bf128824
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovn.py
@@ -0,0 +1,233 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import subprocess
+import uuid
+
+from . import utils
+
+
+OVN_RUNDIR = '/var/run/ovn'
+OVN_SYSCONFDIR = '/etc/ovn'
+
+
+def ovn_appctl(target, args, rundir=None, use_ovs_appctl=False):
+    """Run ovn/ovs-appctl for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovn-appctl` looks for a pidfile and will build the path to
+                   a /var/run/ovn/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovn-appctl`
+    :type args: Tuple[str, ...]
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    # NOTE(fnordahl): The ovsdb-server processes for the OVN databases use a
+    # non-standard naming scheme for their daemon control socket and we need
+    # to pass the full path to the socket.
+    if target in ('ovnnb_db', 'ovnsb_db',):
+        target = os.path.join(rundir or OVN_RUNDIR, target + '.ctl')
+
+    if use_ovs_appctl:
+        tool = 'ovs-appctl'
+    else:
+        tool = 'ovn-appctl'
+
+    return utils._run(tool, '-t', target, *args)
+
+
+class OVNClusterStatus(object):
+
+    def __init__(self, name, cluster_id, server_id, address, status, role,
+                 term, leader, vote, election_timer, log,
+                 entries_not_yet_committed, entries_not_yet_applied,
+                 connections, servers):
+        """Initialize and populate OVNClusterStatus object.
+
+        Use class initializer so we can define types in a compatible manner.
+
+        :param name: Name of schema used for database
+        :type name: str
+        :param cluster_id: UUID of cluster
+        :type cluster_id: uuid.UUID
+        :param server_id: UUID of server
+        :type server_id: uuid.UUID
+        :param address: OVSDB connection method
+        :type address: str
+        :param status: Status text
+        :type status: str
+        :param role: Role of server
+        :type role: str
+        :param term: Election term
+        :type term: int
+        :param leader: Short form UUID of leader
+        :type leader: str
+        :param vote: Vote
+        :type vote: str
+        :param election_timer: Current value of election timer
+        :type election_timer: int
+        :param log: Log
+        :type log: str
+        :param entries_not_yet_committed: Entries not yet committed
+        :type entries_not_yet_committed: int
+        :param entries_not_yet_applied: Entries not yet applied
+        :type entries_not_yet_applied: int
+        :param connections: Connections
+        :type connections: str
+        :param servers: Servers in the cluster
+            [('0ea6', 'ssl:192.0.2.42:6643')]
+        :type servers: List[Tuple[str,str]]
+        """
+        self.name = name
+        self.cluster_id = cluster_id
+        self.server_id = server_id
+        self.address = address
+        self.status = status
+        self.role = role
+        self.term = term
+        self.leader = leader
+        self.vote = vote
+        self.election_timer = election_timer
+        self.log = log
+        self.entries_not_yet_committed = entries_not_yet_committed
+        self.entries_not_yet_applied = entries_not_yet_applied
+        self.connections = connections
+        self.servers = servers
+
+    def __eq__(self, other):
+        return (
+            self.name == other.name and
+            self.cluster_id == other.cluster_id and
+            self.server_id == other.server_id and
+            self.address == other.address and
+            self.status == other.status and
+            self.role == other.role and
+            self.term == other.term and
+            self.leader == other.leader and
+            self.vote == other.vote and
+            self.election_timer == other.election_timer and
+            self.log == other.log and
+            self.entries_not_yet_committed == other.entries_not_yet_committed and
+            self.entries_not_yet_applied == other.entries_not_yet_applied and
+            self.connections == other.connections and
+            self.servers == other.servers)
+
+    @property
+    def is_cluster_leader(self):
+        """Retrieve status information from clustered OVSDB.
+
+        :returns: Whether target is cluster leader
+        :rtype: bool
+        """
+        return self.leader == 'self'
+
+
+def cluster_status(target, schema=None, use_ovs_appctl=False, rundir=None):
+    """Retrieve status information from clustered OVSDB.
+
+    :param target: Usually one of 'ovsdb-server', 'ovnnb_db', 'ovnsb_db', can
+                   also be full path to control socket.
+    :type target: str
+    :param schema: Database schema name, deduced from target if not provided
+    :type schema: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :returns: cluster status data object
+    :rtype: OVNClusterStatus
+    :raises: subprocess.CalledProcessError, KeyError, RuntimeError
+    """
+    schema_map = {
+        'ovnnb_db': 'OVN_Northbound',
+        'ovnsb_db': 'OVN_Southbound',
+    }
+    if schema and schema not in schema_map.keys():
+        raise RuntimeError('Unknown schema provided: "{}"'.format(schema))
+
+    status = {}
+    k = ''
+    for line in ovn_appctl(target,
+                           ('cluster/status', schema or schema_map[target]),
+                           rundir=rundir,
+                           use_ovs_appctl=use_ovs_appctl).splitlines():
+        if k and line.startswith(' '):
+            # there is no key which means this is a instance of a multi-line/
+            # multi-value item, populate the List which is already stored under
+            # the key.
+            if k == 'servers':
+                status[k].append(
+                    tuple(line.replace(')', '').lstrip().split()[0:4:3]))
+            else:
+                status[k].append(line.lstrip())
+        elif ':' in line:
+            # this is a line with a key
+            k, v = line.split(':', 1)
+            k = k.lower()
+            k = k.replace(' ', '_')
+            if v:
+                # this is a line with both key and value
+                if k in ('cluster_id', 'server_id',):
+                    v = v.replace('(', '')
+                    v = v.replace(')', '')
+                    status[k] = tuple(v.split())
+                else:
+                    status[k] = v.lstrip()
+            else:
+                # this is a line with only key which means a multi-line/
+                # multi-value item.  Store key as List which will be
+                # populated on subsequent iterations.
+                status[k] = []
+    return OVNClusterStatus(
+        status['name'],
+        uuid.UUID(status['cluster_id'][1]),
+        uuid.UUID(status['server_id'][1]),
+        status['address'],
+        status['status'],
+        status['role'],
+        int(status['term']),
+        status['leader'],
+        status['vote'],
+        int(status['election_timer']),
+        status['log'],
+        int(status['entries_not_yet_committed']),
+        int(status['entries_not_yet_applied']),
+        status['connections'],
+        status['servers'])
+
+
+def is_northd_active():
+    """Query `ovn-northd` for active status.
+
+    Note that the active status information for ovn-northd is available for
+    OVN 20.03 and onward.
+
+    :returns: True if local `ovn-northd` instance is active, False otherwise
+    :rtype: bool
+    """
+    try:
+        for line in ovn_appctl('ovn-northd', ('status',)).splitlines():
+            if line.startswith('Status:') and 'active' in line:
+                return True
+    except subprocess.CalledProcessError:
+        pass
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovsdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e50bc36333bde56674a82ad6c88e0d5de44ee07
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/ovsdb.py
@@ -0,0 +1,206 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+import uuid
+
+from . import utils
+
+
+class SimpleOVSDB(object):
+    """Simple interface to OVSDB through the use of command line tools.
+
+    OVS and OVN is managed through a set of databases.  These databases have
+    similar command line tools to manage them.  We make use of the similarity
+    to provide a generic class that can be used to manage them.
+
+    The OpenvSwitch project does provide a Python API, but on the surface it
+    appears to be a bit too involved for our simple use case.
+
+    Examples:
+    sbdb = SimpleOVSDB('ovn-sbctl')
+    for chs in sbdb.chassis:
+        print(chs)
+
+    ovsdb = SimpleOVSDB('ovs-vsctl')
+    for br in ovsdb.bridge:
+        if br['name'] == 'br-test':
+            ovsdb.bridge.set(br['uuid'], 'external_ids:charm', 'managed')
+    """
+
+    # For validation we keep a complete map of currently known good tool and
+    # table combinations.  This requires maintenance down the line whenever
+    # upstream adds things that downstream wants, and the cost of maintaining
+    # that will most likely be lower then the cost of finding the needle in
+    # the haystack whenever downstream code misspells something.
+    _tool_table_map = {
+        'ovs-vsctl': (
+            'autoattach',
+            'bridge',
+            'ct_timeout_policy',
+            'ct_zone',
+            'controller',
+            'datapath',
+            'flow_sample_collector_set',
+            'flow_table',
+            'ipfix',
+            'interface',
+            'manager',
+            'mirror',
+            'netflow',
+            'open_vswitch',
+            'port',
+            'qos',
+            'queue',
+            'ssl',
+            'sflow',
+        ),
+        'ovn-nbctl': (
+            'acl',
+            'address_set',
+            'connection',
+            'dhcp_options',
+            'dns',
+            'forwarding_group',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'load_balancer',
+            'load_balancer_health_check',
+            'logical_router',
+            'logical_router_policy',
+            'logical_router_port',
+            'logical_router_static_route',
+            'logical_switch',
+            'logical_switch_port',
+            'meter',
+            'meter_band',
+            'nat',
+            'nb_global',
+            'port_group',
+            'qos',
+            'ssl',
+        ),
+        'ovn-sbctl': (
+            'address_set',
+            'chassis',
+            'connection',
+            'controller_event',
+            'dhcp_options',
+            'dhcpv6_options',
+            'dns',
+            'datapath_binding',
+            'encap',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'igmp_group',
+            'ip_multicast',
+            'logical_flow',
+            'mac_binding',
+            'meter',
+            'meter_band',
+            'multicast_group',
+            'port_binding',
+            'port_group',
+            'rbac_permission',
+            'rbac_role',
+            'sb_global',
+            'ssl',
+            'service_monitor',
+        ),
+    }
+
+    def __init__(self, tool):
+        """SimpleOVSDB constructor.
+
+        :param tool: Which tool with database commands to operate on.
+                     Usually one of `ovs-vsctl`, `ovn-nbctl`, `ovn-sbctl`
+        :type tool: str
+        """
+        if tool not in self._tool_table_map:
+            raise RuntimeError(
+                'tool must be one of "{}"'.format(self._tool_table_map.keys()))
+        self._tool = tool
+
+    def __getattr__(self, table):
+        if table not in self._tool_table_map[self._tool]:
+            raise AttributeError(
+                'table "{}" not known for use with "{}"'
+                .format(table, self._tool))
+        return self.Table(self._tool, table)
+
+    class Table(object):
+        """Methods to interact with contents of OVSDB tables.
+
+        NOTE: At the time of this writing ``find`` is the only command
+        line argument to OVSDB manipulating tools that actually supports
+        JSON output.
+        """
+
+        def __init__(self, tool, table):
+            """SimpleOVSDBTable constructor.
+
+            :param table: Which table to operate on
+            :type table: str
+            """
+            self._tool = tool
+            self._table = table
+
+        def _find_tbl(self, condition=None):
+            """Run and parse output of OVSDB `find` command.
+
+            :param condition: An optional RFC 7047 5.1 match condition
+            :type condition: Optional[str]
+            :returns: Dictionary with data
+            :rtype: Dict[str, any]
+            """
+            # When using json formatted output to OVS commands Internal OVSDB
+            # notation may occur that require further deserializing.
+            # Reference: https://tools.ietf.org/html/rfc7047#section-5.1
+            ovs_type_cb_map = {
+                'uuid': uuid.UUID,
+                # FIXME sets also appear to sometimes contain type/value tuples
+                'set': list,
+                'map': dict,
+            }
+            cmd = [self._tool, '-f', 'json', 'find', self._table]
+            if condition:
+                cmd.append(condition)
+            output = utils._run(*cmd)
+            data = json.loads(output)
+            for row in data['data']:
+                values = []
+                for col in row:
+                    if isinstance(col, list):
+                        f = ovs_type_cb_map.get(col[0], str)
+                        values.append(f(col[1]))
+                    else:
+                        values.append(col)
+                yield dict(zip(data['headings'], values))
+
+        def __iter__(self):
+            return self._find_tbl()
+
+        def clear(self, rec, col):
+            utils._run(self._tool, 'clear', self._table, rec, col)
+
+        def find(self, condition):
+            return self._find_tbl(condition=condition)
+
+        def remove(self, rec, col, value):
+            utils._run(self._tool, 'remove', self._table, rec, col, value)
+
+        def set(self, rec, col, value):
+            utils._run(self._tool, 'set', self._table, rec,
+                       '{}={}'.format(col, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..53c9b4ddab6d68d2478d4161e658c70e2caa6a74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ovs/utils.py
@@ -0,0 +1,26 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import subprocess
+
+
+def _run(*args):
+    """Run a process, check result, capture decoded output from STDOUT.
+
+    :param args: Command and arguments to run
+    :type args: Tuple[str, ...]
+    :returns: Information about the completed process
+    :rtype: str
+    :raises subprocess.CalledProcessError
+    """
+    return subprocess.check_output(args, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ufw.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ufw.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9bf7c9df5576615e23225a7fdb6c11a28931ba4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/network/ufw.py
@@ -0,0 +1,386 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module contains helpers to add and remove ufw rules.
+
+Examples:
+
+- open SSH port for subnet 10.0.3.0/24:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.grant_access(src='10.0.3.0/24', dst='any', port='22', proto='tcp')
+
+- open service by name as defined in /etc/services:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('ssh', 'open')
+
+- close service by port number:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('4949', 'close')  # munin
+"""
+import os
+import re
+import subprocess
+
+from charmhelpers.core import hookenv
+from charmhelpers.core.kernel import modprobe, is_module_loaded
+
+__author__ = "Felipe Reyes <felipe.reyes@canonical.com>"
+
+
+class UFWError(Exception):
+    pass
+
+
+class UFWIPv6Error(UFWError):
+    pass
+
+
+def is_enabled():
+    """
+    Check if `ufw` is enabled
+
+    :returns: True if ufw is enabled
+    """
+    output = subprocess.check_output(['ufw', 'status'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Status: active\n', output, re.M)
+
+    return len(m) >= 1
+
+
+def is_ipv6_ok(soft_fail=False):
+    """
+    Check if IPv6 support is present and ip6tables functional
+
+    :param soft_fail: If set to True and IPv6 support is broken, then reports
+                      that the host doesn't have IPv6 support, otherwise a
+                      UFWIPv6Error exception is raised.
+    :returns: True if IPv6 is working, False otherwise
+    """
+
+    # do we have IPv6 in the machine?
+    if os.path.isdir('/proc/sys/net/ipv6'):
+        # is ip6tables kernel module loaded?
+        if not is_module_loaded('ip6_tables'):
+            # ip6tables support isn't complete, let's try to load it
+            try:
+                modprobe('ip6_tables')
+                # great, we can load the module
+                return True
+            except subprocess.CalledProcessError as ex:
+                hookenv.log("Couldn't load ip6_tables module: %s" % ex.output,
+                            level="WARN")
+                # we are in a world where ip6tables isn't working
+                if soft_fail:
+                    # so we inform that the machine doesn't have IPv6
+                    return False
+                else:
+                    raise UFWIPv6Error("IPv6 firewall support broken")
+        else:
+            # the module is present :)
+            return True
+
+    else:
+        # the system doesn't have IPv6
+        return False
+
+
+def disable_ipv6():
+    """
+    Disable ufw IPv6 support in /etc/default/ufw
+    """
+    exit_code = subprocess.call(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+    if exit_code == 0:
+        hookenv.log('IPv6 support in ufw disabled', level='INFO')
+    else:
+        hookenv.log("Couldn't disable IPv6 support in ufw", level="ERROR")
+        raise UFWError("Couldn't disable IPv6 support in ufw")
+
+
+def enable(soft_fail=False):
+    """
+    Enable ufw
+
+    :param soft_fail: If set to True silently disables IPv6 support in ufw,
+                      otherwise a UFWIPv6Error exception is raised when IP6
+                      support is broken.
+    :returns: True if ufw is successfully enabled
+    """
+    if is_enabled():
+        return True
+
+    if not is_ipv6_ok(soft_fail):
+        disable_ipv6()
+
+    output = subprocess.check_output(['ufw', 'enable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall is active and enabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be enabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw enabled", level='INFO')
+        return True
+
+
+def reload():
+    """
+    Reload ufw
+
+    :returns: True if ufw is successfully enabled
+    """
+    output = subprocess.check_output(['ufw', 'reload'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall reloaded\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be reloaded", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw reloaded", level='INFO')
+        return True
+
+
+def disable():
+    """
+    Disable ufw
+
+    :returns: True if ufw is successfully disabled
+    """
+    if not is_enabled():
+        return True
+
+    output = subprocess.check_output(['ufw', 'disable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Firewall stopped and disabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be disabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw disabled", level='INFO')
+        return True
+
+
+def default_policy(policy='deny', direction='incoming'):
+    """
+    Changes the default policy for traffic `direction`
+
+    :param policy: allow, deny or reject
+    :param direction: traffic direction, possible values: incoming, outgoing,
+                      routed
+    """
+    if policy not in ['allow', 'deny', 'reject']:
+        raise UFWError(('Unknown policy %s, valid values: '
+                        'allow, deny, reject') % policy)
+
+    if direction not in ['incoming', 'outgoing', 'routed']:
+        raise UFWError(('Unknown direction %s, valid values: '
+                        'incoming, outgoing, routed') % direction)
+
+    output = subprocess.check_output(['ufw', 'default', policy, direction],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+    hookenv.log(output, level='DEBUG')
+
+    m = re.findall("^Default %s policy changed to '%s'\n" % (direction,
+                                                             policy),
+                   output, re.M)
+    if len(m) == 0:
+        hookenv.log("ufw couldn't change the default policy to %s for %s"
+                    % (policy, direction), level='WARN')
+        return False
+    else:
+        hookenv.log("ufw default policy for %s changed to %s"
+                    % (direction, policy), level='INFO')
+        return True
+
+
+def modify_access(src, dst='any', port=None, proto=None, action='allow',
+                  index=None, prepend=False, comment=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :type src: Optional[str]
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :type dst: Optional[str]
+    :param port: destiny port
+    :type port: Optional[int]
+    :param proto: protocol (tcp or udp)
+    :type proto: Optional[str]
+    :param action: `allow` or `delete`
+    :type action: str
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    :type index: Optional[int]
+    :param prepend: Whether to insert the rule before all other rules matching
+                    the rule's IP type.
+    :type prepend: bool
+    :param comment: Create the rule with a comment
+    :type comment: Optional[str]
+    """
+    if not is_enabled():
+        hookenv.log('ufw is disabled, skipping modify_access()', level='WARN')
+        return
+
+    if action == 'delete':
+        if index is not None:
+            cmd = ['ufw', '--force', 'delete', str(index)]
+        else:
+            cmd = ['ufw', 'delete', 'allow']
+    elif index is not None:
+        cmd = ['ufw', 'insert', str(index), action]
+    elif prepend:
+        cmd = ['ufw', 'prepend', action]
+    else:
+        cmd = ['ufw', action]
+
+    if src is not None:
+        cmd += ['from', src]
+
+    if dst is not None:
+        cmd += ['to', dst]
+
+    if port is not None:
+        cmd += ['port', str(port)]
+
+    if proto is not None:
+        cmd += ['proto', proto]
+
+    if comment:
+        cmd.extend(['comment', comment])
+
+    hookenv.log('ufw {}: {}'.format(action, ' '.join(cmd)), level='DEBUG')
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE)
+    (stdout, stderr) = p.communicate()
+
+    hookenv.log(stdout, level='INFO')
+
+    if p.returncode != 0:
+        hookenv.log(stderr, level='ERROR')
+        hookenv.log('Error running: {}, exit code: {}'.format(' '.join(cmd),
+                                                              p.returncode),
+                    level='ERROR')
+
+
+def grant_access(src, dst='any', port=None, proto=None, index=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='allow',
+                         index=index)
+
+
+def revoke_access(src, dst='any', port=None, proto=None):
+    """
+    Revoke access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='delete')
+
+
+def service(name, action):
+    """
+    Open/close access to a service
+
+    :param name: could be a service name defined in `/etc/services` or a port
+                 number.
+    :param action: `open` or `close`
+    """
+    if action == 'open':
+        subprocess.check_output(['ufw', 'allow', str(name)],
+                                universal_newlines=True)
+    elif action == 'close':
+        subprocess.check_output(['ufw', 'delete', 'allow', str(name)],
+                                universal_newlines=True)
+    else:
+        raise UFWError(("'{}' not supported, use 'allow' "
+                        "or 'delete'").format(action))
+
+
+def status():
+    """Retrieve firewall rules as represented by UFW.
+
+    :returns: Tuples with rule number and data
+        (1, {'to': '', 'action':, 'from':, '', ipv6: True, 'comment': ''})
+    :rtype: Iterator[Tuple[int, Dict[str, Union[bool, str]]]]
+    """
+    cp = subprocess.check_output(('ufw', 'status', 'numbered',),
+                                 stderr=subprocess.STDOUT,
+                                 universal_newlines=True)
+    for line in cp.splitlines():
+        if not line.startswith('['):
+            continue
+        ipv6 = True if '(v6)' in line else False
+        line = line.replace('(v6)', '')
+        line = line.replace('[', '')
+        line = line.replace(']', '')
+        line = line.replace('Anywhere', 'any')
+        row = line.split()
+        yield (int(row[0]), {
+            'to': row[1],
+            'action': ' '.join(row[2:4]).lower(),
+            'from': row[4],
+            'ipv6': ipv6,
+            'comment': row[6] if len(row) > 5 and row[5] == '#' else '',
+        })
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/alternatives.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/alternatives.py
new file mode 100644
index 0000000000000000000000000000000000000000..547de09c6d818772191b519618fa32b08b0e6eff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/alternatives.py
@@ -0,0 +1,44 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helper for managing alternatives for file conflict resolution '''
+
+import subprocess
+import shutil
+import os
+
+
+def install_alternative(name, target, source, priority=50):
+    ''' Install alternative configuration '''
+    if (os.path.exists(target) and not os.path.islink(target)):
+        # Move existing file/directory away before installing
+        shutil.move(target, '{}.bak'.format(target))
+    cmd = [
+        'update-alternatives', '--force', '--install',
+        target, name, source, str(priority)
+    ]
+    subprocess.check_call(cmd)
+
+
+def remove_alternative(name, source):
+    """Remove an installed alternative configuration file
+
+    :param name: string name of the alternative to remove
+    :param source: string full path to alternative to remove
+    """
+    cmd = [
+        'update-alternatives', '--remove',
+        name, source
+    ]
+    subprocess.check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd3aebe97dd04bf42a2c4ee7c7b7b83b1917a678
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/deployment.py
@@ -0,0 +1,384 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import os
+import re
+import sys
+import six
+from collections import OrderedDict
+from charmhelpers.contrib.amulet.deployment import (
+    AmuletDeployment
+)
+from charmhelpers.contrib.openstack.amulet.utils import (
+    OPENSTACK_RELEASES_PAIRS
+)
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+
+class OpenStackAmuletDeployment(AmuletDeployment):
+    """OpenStack amulet deployment.
+
+       This class inherits from AmuletDeployment and has additional support
+       that is specifically for use by OpenStack charms.
+       """
+
+    def __init__(self, series=None, openstack=None, source=None,
+                 stable=True, log_level=DEBUG):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletDeployment, self).__init__(series)
+        self.log = self.get_logger(level=log_level)
+        self.log.info('OpenStackAmuletDeployment:  init')
+        self.openstack = openstack
+        self.source = source
+        self.stable = stable
+
+    def get_logger(self, name="deployment-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def _determine_branch_locations(self, other_services):
+        """Determine the branch locations for the other services.
+
+           Determine if the local branch being tested is derived from its
+           stable or next (dev) branch, and based on this, use the corresonding
+           stable or next branches for the other_services."""
+
+        self.log.info('OpenStackAmuletDeployment:  determine branch locations')
+
+        # Charms outside the ~openstack-charmers
+        base_charms = {
+            'mysql': ['trusty'],
+            'mongodb': ['trusty'],
+            'nrpe': ['trusty', 'xenial'],
+        }
+
+        for svc in other_services:
+            # If a location has been explicitly set, use it
+            if svc.get('location'):
+                continue
+            if svc['name'] in base_charms:
+                # NOTE: not all charms have support for all series we
+                #       want/need to test against, so fix to most recent
+                #       that each base charm supports
+                target_series = self.series
+                if self.series not in base_charms[svc['name']]:
+                    target_series = base_charms[svc['name']][-1]
+                svc['location'] = 'cs:{}/{}'.format(target_series,
+                                                    svc['name'])
+            elif self.stable:
+                svc['location'] = 'cs:{}/{}'.format(self.series,
+                                                    svc['name'])
+            else:
+                svc['location'] = 'cs:~openstack-charmers-next/{}/{}'.format(
+                    self.series,
+                    svc['name']
+                )
+
+        return other_services
+
+    def _add_services(self, this_service, other_services, use_source=None,
+                      no_origin=None):
+        """Add services to the deployment and optionally set
+        openstack-origin/source.
+
+        :param this_service dict: Service dictionary describing the service
+                                  whose amulet tests are being run
+        :param other_services dict: List of service dictionaries describing
+                                    the services needed to support the target
+                                    service
+        :param use_source list: List of services which use the 'source' config
+                                option rather than 'openstack-origin'
+        :param no_origin list: List of services which do not support setting
+                               the Cloud Archive.
+        Service Dict:
+            {
+                'name': str charm-name,
+                'units': int number of units,
+                'constraints': dict of juju constraints,
+                'location': str location of charm,
+            }
+        eg
+        this_service = {
+            'name': 'openvswitch-odl',
+            'constraints': {'mem': '8G'},
+        }
+        other_services = [
+            {
+                'name': 'nova-compute',
+                'units': 2,
+                'constraints': {'mem': '4G'},
+                'location': cs:~bob/xenial/nova-compute
+            },
+            {
+                'name': 'mysql',
+                'constraints': {'mem': '2G'},
+            },
+            {'neutron-api-odl'}]
+        use_source = ['mysql']
+        no_origin = ['neutron-api-odl']
+        """
+        self.log.info('OpenStackAmuletDeployment:  adding services')
+
+        other_services = self._determine_branch_locations(other_services)
+
+        super(OpenStackAmuletDeployment, self)._add_services(this_service,
+                                                             other_services)
+
+        services = other_services
+        services.append(this_service)
+
+        use_source = use_source or []
+        no_origin = no_origin or []
+
+        # Charms which should use the source config option
+        use_source = list(set(
+            use_source + ['mysql', 'mongodb', 'rabbitmq-server', 'ceph',
+                          'ceph-osd', 'ceph-radosgw', 'ceph-mon',
+                          'ceph-proxy', 'percona-cluster', 'lxd']))
+
+        # Charms which can not use openstack-origin, ie. many subordinates
+        no_origin = list(set(
+            no_origin + ['cinder-ceph', 'hacluster', 'neutron-openvswitch',
+                         'nrpe', 'openvswitch-odl', 'neutron-api-odl',
+                         'odl-controller', 'cinder-backup', 'nexentaedge-data',
+                         'nexentaedge-iscsi-gw', 'nexentaedge-swift-gw',
+                         'cinder-nexentaedge', 'nexentaedge-mgmt',
+                         'ceilometer-agent']))
+
+        if self.openstack:
+            for svc in services:
+                if svc['name'] not in use_source + no_origin:
+                    config = {'openstack-origin': self.openstack}
+                    self.d.configure(svc['name'], config)
+
+        if self.source:
+            for svc in services:
+                if svc['name'] in use_source and svc['name'] not in no_origin:
+                    config = {'source': self.source}
+                    self.d.configure(svc['name'], config)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        self.log.info('OpenStackAmuletDeployment:  configure services')
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _auto_wait_for_status(self, message=None, exclude_services=None,
+                              include_only=None, timeout=None):
+        """Wait for all units to have a specific extended status, except
+        for any defined as excluded.  Unless specified via message, any
+        status containing any case of 'ready' will be considered a match.
+
+        Examples of message usage:
+
+          Wait for all unit status to CONTAIN any case of 'ready' or 'ok':
+              message = re.compile('.*ready.*|.*ok.*', re.IGNORECASE)
+
+          Wait for all units to reach this status (exact match):
+              message = re.compile('^Unit is ready and clustered$')
+
+          Wait for all units to reach any one of these (exact match):
+              message = re.compile('Unit is ready|OK|Ready')
+
+          Wait for at least one unit to reach this status (exact match):
+              message = {'ready'}
+
+        See Amulet's sentry.wait_for_messages() for message usage detail.
+        https://github.com/juju/amulet/blob/master/amulet/sentry.py
+
+        :param message: Expected status match
+        :param exclude_services: List of juju service names to ignore,
+            not to be used in conjuction with include_only.
+        :param include_only: List of juju service names to exclusively check,
+            not to be used in conjuction with exclude_services.
+        :param timeout: Maximum time in seconds to wait for status match
+        :returns: None.  Raises if timeout is hit.
+        """
+        if not timeout:
+            timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 1800))
+        self.log.info('Waiting for extended status on units for {}s...'
+                      ''.format(timeout))
+
+        all_services = self.d.services.keys()
+
+        if exclude_services and include_only:
+            raise ValueError('exclude_services can not be used '
+                             'with include_only')
+
+        if message:
+            if isinstance(message, re._pattern_type):
+                match = message.pattern
+            else:
+                match = message
+
+            self.log.debug('Custom extended status wait match: '
+                           '{}'.format(match))
+        else:
+            self.log.debug('Default extended status wait match:  contains '
+                           'READY (case-insensitive)')
+            message = re.compile('.*ready.*', re.IGNORECASE)
+
+        if exclude_services:
+            self.log.debug('Excluding services from extended status match: '
+                           '{}'.format(exclude_services))
+        else:
+            exclude_services = []
+
+        if include_only:
+            services = include_only
+        else:
+            services = list(set(all_services) - set(exclude_services))
+
+        self.log.debug('Waiting up to {}s for extended status on services: '
+                       '{}'.format(timeout, services))
+        service_messages = {service: message for service in services}
+
+        # Check for idleness
+        self.d.sentry.wait(timeout=timeout)
+        # Check for error states and bail early
+        self.d.sentry.wait_for_status(self.d.juju_env, services, timeout=timeout)
+        # Check for ready messages
+        self.d.sentry.wait_for_messages(service_messages, timeout=timeout)
+
+        self.log.info('OK')
+
+    def _get_openstack_release(self):
+        """Get openstack release.
+
+           Return an integer representing the enum value of the openstack
+           release.
+           """
+        # Must be ordered by OpenStack release (not by Ubuntu release):
+        for i, os_pair in enumerate(OPENSTACK_RELEASES_PAIRS):
+            setattr(self, os_pair, i)
+
+        releases = {
+            ('trusty', None): self.trusty_icehouse,
+            ('trusty', 'cloud:trusty-kilo'): self.trusty_kilo,
+            ('trusty', 'cloud:trusty-liberty'): self.trusty_liberty,
+            ('trusty', 'cloud:trusty-mitaka'): self.trusty_mitaka,
+            ('xenial', None): self.xenial_mitaka,
+            ('xenial', 'cloud:xenial-newton'): self.xenial_newton,
+            ('xenial', 'cloud:xenial-ocata'): self.xenial_ocata,
+            ('xenial', 'cloud:xenial-pike'): self.xenial_pike,
+            ('xenial', 'cloud:xenial-queens'): self.xenial_queens,
+            ('yakkety', None): self.yakkety_newton,
+            ('zesty', None): self.zesty_ocata,
+            ('artful', None): self.artful_pike,
+            ('bionic', None): self.bionic_queens,
+            ('bionic', 'cloud:bionic-rocky'): self.bionic_rocky,
+            ('bionic', 'cloud:bionic-stein'): self.bionic_stein,
+            ('bionic', 'cloud:bionic-train'): self.bionic_train,
+            ('bionic', 'cloud:bionic-ussuri'): self.bionic_ussuri,
+            ('cosmic', None): self.cosmic_rocky,
+            ('disco', None): self.disco_stein,
+            ('eoan', None): self.eoan_train,
+            ('focal', None): self.focal_ussuri,
+        }
+        return releases[(self.series, self.openstack)]
+
+    def _get_openstack_release_string(self):
+        """Get openstack release string.
+
+           Return a string representing the openstack release.
+           """
+        releases = OrderedDict([
+            ('trusty', 'icehouse'),
+            ('xenial', 'mitaka'),
+            ('yakkety', 'newton'),
+            ('zesty', 'ocata'),
+            ('artful', 'pike'),
+            ('bionic', 'queens'),
+            ('cosmic', 'rocky'),
+            ('disco', 'stein'),
+            ('eoan', 'train'),
+            ('focal', 'ussuri'),
+        ])
+        if self.openstack:
+            os_origin = self.openstack.split(':')[1]
+            return os_origin.split('%s-' % self.series)[1].split('/')[0]
+        else:
+            return releases[self.series]
+
+    def get_percona_service_entry(self, memory_constraint=None):
+        """Return a amulet service entry for percona cluster.
+
+        :param memory_constraint: Override the default memory constraint
+                                  in the service entry.
+        :type memory_constraint: str
+        :returns: Amulet service entry.
+        :rtype: dict
+        """
+        memory_constraint = memory_constraint or '3072M'
+        svc_entry = {
+            'name': 'percona-cluster',
+            'constraints': {'mem': memory_constraint}}
+        if self._get_openstack_release() <= self.trusty_mitaka:
+            svc_entry['location'] = 'cs:trusty/percona-cluster'
+        return svc_entry
+
+    def get_ceph_expected_pools(self, radosgw=False):
+        """Return a list of expected ceph pools in a ceph + cinder + glance
+        test scenario, based on OpenStack release and whether ceph radosgw
+        is flagged as present or not."""
+
+        if self._get_openstack_release() == self.trusty_icehouse:
+            # Icehouse
+            pools = [
+                'data',
+                'metadata',
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        elif (self.trusty_kilo <= self._get_openstack_release() <=
+              self.zesty_ocata):
+            # Kilo through Ocata
+            pools = [
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        else:
+            # Pike and later
+            pools = [
+                'cinder-ceph',
+                'glance'
+            ]
+
+        if radosgw:
+            pools.extend([
+                '.rgw.root',
+                '.rgw.control',
+                '.rgw',
+                '.rgw.gc',
+                '.users.uid'
+            ])
+
+        return pools
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..14864198926b82afe382d07263034b020ad43c09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/amulet/utils.py
@@ -0,0 +1,1593 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import json
+import logging
+import os
+import re
+import six
+import time
+import urllib
+import urlparse
+
+import cinderclient.v1.client as cinder_client
+import cinderclient.v2.client as cinder_clientv2
+import glanceclient.v1 as glance_client
+import glanceclient.v2 as glance_clientv2
+import heatclient.v1.client as heat_client
+from keystoneclient.v2_0 import client as keystone_client
+from keystoneauth1.identity import (
+    v3,
+    v2,
+)
+from keystoneauth1 import session as keystone_session
+from keystoneclient.v3 import client as keystone_client_v3
+from novaclient import exceptions
+
+import novaclient.client as nova_client
+import novaclient
+import pika
+import swiftclient
+
+from charmhelpers.core.decorators import retry_on_exception
+from charmhelpers.contrib.amulet.utils import (
+    AmuletUtils
+)
+from charmhelpers.core.host import CompareHostReleases
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+NOVA_CLIENT_VERSION = "2"
+
+OPENSTACK_RELEASES_PAIRS = [
+    'trusty_icehouse', 'trusty_kilo', 'trusty_liberty',
+    'trusty_mitaka', 'xenial_mitaka',
+    'xenial_newton', 'yakkety_newton',
+    'xenial_ocata', 'zesty_ocata',
+    'xenial_pike', 'artful_pike',
+    'xenial_queens', 'bionic_queens',
+    'bionic_rocky', 'cosmic_rocky',
+    'bionic_stein', 'disco_stein',
+    'bionic_train', 'eoan_train',
+    'bionic_ussuri', 'focal_ussuri',
+]
+
+
+class OpenStackAmuletUtils(AmuletUtils):
+    """OpenStack amulet utilities.
+
+       This class inherits from AmuletUtils and has additional support
+       that is specifically for use by OpenStack charm tests.
+       """
+
+    def __init__(self, log_level=ERROR):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletUtils, self).__init__(log_level)
+
+    def validate_endpoint_data(self, endpoints, admin_port, internal_port,
+                               public_port, expected, openstack_release=None):
+        """Validate endpoint data. Pick the correct validator based on
+           OpenStack release. Expected data should be in the v2 format:
+           {
+               'id': id,
+               'region': region,
+               'adminurl': adminurl,
+               'internalurl': internalurl,
+               'publicurl': publicurl,
+               'service_id': service_id}
+
+           """
+        validation_function = self.validate_v2_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_endpoint_data
+            expected = {
+                'id': expected['id'],
+                'region': expected['region'],
+                'region_id': 'RegionOne',
+                'url': self.valid_url,
+                'interface': self.not_null,
+                'service_id': expected['service_id']}
+        return validation_function(endpoints, admin_port, internal_port,
+                                   public_port, expected)
+
+    def validate_v2_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected):
+        """Validate endpoint data.
+
+           Validate actual endpoint data vs expected endpoint data. The ports
+           are used to find the matching endpoint.
+           """
+        self.log.debug('Validating endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = False
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if (admin_port in ep.adminurl and
+                    internal_port in ep.internalurl and
+                    public_port in ep.publicurl):
+                found = True
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'adminurl': ep.adminurl,
+                          'internalurl': ep.internalurl,
+                          'publicurl': ep.publicurl,
+                          'service_id': ep.service_id}
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if not found:
+            return 'endpoint not found'
+
+    def validate_v3_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected, expected_num_eps=3):
+        """Validate keystone v3 endpoint data.
+
+        Validate the v3 endpoint data which has changed from v2.  The
+        ports are used to find the matching endpoint.
+
+        The new v3 endpoint data looks like:
+
+        [<Endpoint enabled=True,
+                   id=0432655fc2f74d1e9fa17bdaa6f6e60b,
+                   interface=admin,
+                   links={u'self': u'<RESTful URL of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=17f842a0dc084b928e476fafe67e4095,
+                   url=http://10.5.6.5:9312>,
+         <Endpoint enabled=True,
+                   id=6536cb6cb92f4f41bf22b079935c7707,
+                   interface=admin,
+                   links={u'self': u'<RESTful url of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=72fc8736fb41435e8b3584205bb2cfa3,
+                   url=http://10.5.6.6:35357/v3>,
+                   ... ]
+        """
+        self.log.debug('Validating v3 endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = []
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if ((admin_port in ep.url and ep.interface == 'admin') or
+                    (internal_port in ep.url and ep.interface == 'internal') or
+                    (public_port in ep.url and ep.interface == 'public')):
+                found.append(ep.interface)
+                # note we ignore the links member.
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'region_id': ep.region_id,
+                          'interface': self.not_null,
+                          'url': ep.url,
+                          'service_id': ep.service_id, }
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if len(found) != expected_num_eps:
+            return 'Unexpected number of endpoints found'
+
+    def convert_svc_catalog_endpoint_data_to_v3(self, ep_data):
+        """Convert v2 endpoint data into v3.
+
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+          """
+        self.log.warn("Endpoint ID and Region ID validation is limited to not "
+                      "null checks after v2 to v3 conversion")
+        for svc in ep_data.keys():
+            assert len(ep_data[svc]) == 1, "Unknown data format"
+            svc_ep_data = ep_data[svc][0]
+            ep_data[svc] = [
+                {
+                    'url': svc_ep_data['adminURL'],
+                    'interface': 'admin',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['publicURL'],
+                    'interface': 'public',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['internalURL'],
+                    'interface': 'internal',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null}]
+        return ep_data
+
+    def validate_svc_catalog_endpoint_data(self, expected, actual,
+                                           openstack_release=None):
+        """Validate service catalog endpoint data. Pick the correct validator
+           for the OpenStack version. Expected data should be in the v2 format:
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+
+           """
+        validation_function = self.validate_v2_svc_catalog_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_svc_catalog_endpoint_data
+            expected = self.convert_svc_catalog_endpoint_data_to_v3(expected)
+        return validation_function(expected, actual)
+
+    def validate_v2_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate service catalog endpoint data.
+
+           Validate a list of actual service catalog endpoints vs a list of
+           expected service catalog endpoints.
+           """
+        self.log.debug('Validating service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                ret = self._validate_dict_data(expected[k][0], actual[k][0])
+                if ret:
+                    return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_v3_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate the keystone v3 catalog endpoint data.
+
+        Validate a list of dictinaries that make up the keystone v3 service
+        catalogue.
+
+        It is in the form of:
+
+
+        {u'identity': [{u'id': u'48346b01c6804b298cdd7349aadb732e',
+                        u'interface': u'admin',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:35357/v3'},
+                       {u'id': u'8414f7352a4b47a69fddd9dbd2aef5cf',
+                        u'interface': u'public',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'},
+                       {u'id': u'd5ca31440cc24ee1bf625e2996fb6a5b',
+                        u'interface': u'internal',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'}],
+         u'key-manager': [{u'id': u'68ebc17df0b045fcb8a8a433ebea9e62',
+                           u'interface': u'public',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'9cdfe2a893c34afd8f504eb218cd2f9d',
+                           u'interface': u'internal',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'f629388955bc407f8b11d8b7ca168086',
+                           u'interface': u'admin',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9312'}]}
+
+        Note, that an added complication is that the order of admin, public,
+        internal against 'interface' in each region.
+
+        Thus, the function sorts the expected and actual lists using the
+        interface key as a sort key, prior to the comparison.
+        """
+        self.log.debug('Validating v3 service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                l_expected = sorted(v, key=lambda x: x['interface'])
+                l_actual = sorted(actual[k], key=lambda x: x['interface'])
+                if len(l_actual) != len(l_expected):
+                    return ("endpoint {} has differing number of interfaces "
+                            " - expected({}), actual({})"
+                            .format(k, len(l_expected), len(l_actual)))
+                for i_expected, i_actual in zip(l_expected, l_actual):
+                    self.log.debug("checking interface {}"
+                                   .format(i_expected['interface']))
+                    ret = self._validate_dict_data(i_expected, i_actual)
+                    if ret:
+                        return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_tenant_data(self, expected, actual):
+        """Validate tenant data.
+
+           Validate a list of actual tenant data vs list of expected tenant
+           data.
+           """
+        self.log.debug('Validating tenant data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'enabled': act.enabled, 'description': act.description,
+                     'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected tenant data - {}".format(ret)
+            if not found:
+                return "tenant {} does not exist".format(e['name'])
+        return ret
+
+    def validate_role_data(self, expected, actual):
+        """Validate role data.
+
+           Validate a list of actual role data vs a list of expected role
+           data.
+           """
+        self.log.debug('Validating role data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected role data - {}".format(ret)
+            if not found:
+                return "role {} does not exist".format(e['name'])
+        return ret
+
+    def validate_user_data(self, expected, actual, api_version=None):
+        """Validate user data.
+
+           Validate a list of actual user data vs a list of expected user
+           data.
+           """
+        self.log.debug('Validating user data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                if e['name'] == act.name:
+                    a = {'enabled': act.enabled, 'name': act.name,
+                         'email': act.email, 'id': act.id}
+                    if api_version == 3:
+                        a['default_project_id'] = getattr(act,
+                                                          'default_project_id',
+                                                          'none')
+                    else:
+                        a['tenantId'] = act.tenantId
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected user data - {}".format(ret)
+            if not found:
+                return "user {} does not exist".format(e['name'])
+        return ret
+
+    def validate_flavor_data(self, expected, actual):
+        """Validate flavor data.
+
+           Validate a list of actual flavors vs a list of expected flavors.
+           """
+        self.log.debug('Validating flavor data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        act = [a.name for a in actual]
+        return self._validate_list_data(expected, act)
+
+    def tenant_exists(self, keystone, tenant):
+        """Return True if tenant exists."""
+        self.log.debug('Checking if tenant exists ({})...'.format(tenant))
+        return tenant in [t.name for t in keystone.tenants.list()]
+
+    @retry_on_exception(num_retries=5, base_delay=1)
+    def keystone_wait_for_propagation(self, sentry_relation_pairs,
+                                      api_version):
+        """Iterate over list of sentry and relation tuples and verify that
+           api_version has the expected value.
+
+        :param sentry_relation_pairs: list of sentry, relation name tuples used
+                                      for monitoring propagation of relation
+                                      data
+        :param api_version: api_version to expect in relation data
+        :returns: None if successful.  Raise on error.
+        """
+        for (sentry, relation_name) in sentry_relation_pairs:
+            rel = sentry.relation('identity-service',
+                                  relation_name)
+            self.log.debug('keystone relation data: {}'.format(rel))
+            if rel.get('api_version') != str(api_version):
+                raise Exception("api_version not propagated through relation"
+                                " data yet ('{}' != '{}')."
+                                "".format(rel.get('api_version'), api_version))
+
+    def keystone_configure_api_version(self, sentry_relation_pairs, deployment,
+                                       api_version):
+        """Configure preferred-api-version of keystone in deployment and
+           monitor provided list of relation objects for propagation
+           before returning to caller.
+
+        :param sentry_relation_pairs: list of sentry, relation tuples used for
+                                      monitoring propagation of relation data
+        :param deployment: deployment to configure
+        :param api_version: value preferred-api-version will be set to
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug("Setting keystone preferred-api-version: '{}'"
+                       "".format(api_version))
+
+        config = {'preferred-api-version': api_version}
+        deployment.d.configure('keystone', config)
+        deployment._auto_wait_for_status()
+        self.keystone_wait_for_propagation(sentry_relation_pairs, api_version)
+
+    def authenticate_cinder_admin(self, keystone, api_version=2):
+        """Authenticates admin user with cinder."""
+        self.log.debug('Authenticating cinder admin...')
+        _clients = {
+            1: cinder_client.Client,
+            2: cinder_clientv2.Client}
+        return _clients[api_version](session=keystone.session)
+
+    def authenticate_keystone(self, keystone_ip, username, password,
+                              api_version=False, admin_port=False,
+                              user_domain_name=None, domain_name=None,
+                              project_domain_name=None, project_name=None):
+        """Authenticate with Keystone"""
+        self.log.debug('Authenticating with keystone...')
+        if not api_version:
+            api_version = 2
+        sess, auth = self.get_keystone_session(
+            keystone_ip=keystone_ip,
+            username=username,
+            password=password,
+            api_version=api_version,
+            admin_port=admin_port,
+            user_domain_name=user_domain_name,
+            domain_name=domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name
+        )
+        if api_version == 2:
+            client = keystone_client.Client(session=sess)
+        else:
+            client = keystone_client_v3.Client(session=sess)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(sess)
+        return client
+
+    def get_keystone_session(self, keystone_ip, username, password,
+                             api_version=False, admin_port=False,
+                             user_domain_name=None, domain_name=None,
+                             project_domain_name=None, project_name=None):
+        """Return a keystone session object"""
+        ep = self.get_keystone_endpoint(keystone_ip,
+                                        api_version=api_version,
+                                        admin_port=admin_port)
+        if api_version == 2:
+            auth = v2.Password(
+                username=username,
+                password=password,
+                tenant_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        else:
+            auth = v3.Password(
+                user_domain_name=user_domain_name,
+                username=username,
+                password=password,
+                domain_name=domain_name,
+                project_domain_name=project_domain_name,
+                project_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        return (sess, auth)
+
+    def get_keystone_endpoint(self, keystone_ip, api_version=None,
+                              admin_port=False):
+        """Return keystone endpoint"""
+        port = 5000
+        if admin_port:
+            port = 35357
+        base_ep = "http://{}:{}".format(keystone_ip.strip().decode('utf-8'),
+                                        port)
+        if api_version == 2:
+            ep = base_ep + "/v2.0"
+        else:
+            ep = base_ep + "/v3"
+        return ep
+
+    def get_default_keystone_session(self, keystone_sentry,
+                                     openstack_release=None, api_version=2):
+        """Return a keystone session object and client object assuming standard
+           default settings
+
+           Example call in amulet tests:
+               self.keystone_session, self.keystone = u.get_default_keystone_session(
+                   self.keystone_sentry,
+                   openstack_release=self._get_openstack_release())
+
+           The session can then be used to auth other clients:
+               neutronclient.Client(session=session)
+               aodh_client.Client(session=session)
+               eyc
+        """
+        self.log.debug('Authenticating keystone admin...')
+        # 11 => xenial_queens
+        if api_version == 3 or (openstack_release and openstack_release >= 11):
+            client_class = keystone_client_v3.Client
+            api_version = 3
+        else:
+            client_class = keystone_client.Client
+        keystone_ip = keystone_sentry.info['public-address']
+        session, auth = self.get_keystone_session(
+            keystone_ip,
+            api_version=api_version,
+            username='admin',
+            password='openstack',
+            project_name='admin',
+            user_domain_name='admin_domain',
+            project_domain_name='admin_domain')
+        client = client_class(session=session)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(session)
+        return session, client
+
+    def authenticate_keystone_admin(self, keystone_sentry, user, password,
+                                    tenant=None, api_version=None,
+                                    keystone_ip=None, user_domain_name=None,
+                                    project_domain_name=None,
+                                    project_name=None):
+        """Authenticates admin user with the keystone admin endpoint."""
+        self.log.debug('Authenticating keystone admin...')
+        if not keystone_ip:
+            keystone_ip = keystone_sentry.info['public-address']
+
+        # To support backward compatibility usage of this function
+        if not project_name:
+            project_name = tenant
+        if api_version == 3 and not user_domain_name:
+            user_domain_name = 'admin_domain'
+        if api_version == 3 and not project_domain_name:
+            project_domain_name = 'admin_domain'
+        if api_version == 3 and not project_name:
+            project_name = 'admin'
+
+        return self.authenticate_keystone(
+            keystone_ip, user, password,
+            api_version=api_version,
+            user_domain_name=user_domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name,
+            admin_port=True)
+
+    def authenticate_keystone_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with the keystone public endpoint."""
+        self.log.debug('Authenticating keystone user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        keystone_ip = urlparse.urlparse(ep).hostname
+
+        return self.authenticate_keystone(keystone_ip, user, password,
+                                          project_name=tenant)
+
+    def authenticate_glance_admin(self, keystone, force_v1_client=False):
+        """Authenticates admin user with glance."""
+        self.log.debug('Authenticating glance admin...')
+        ep = keystone.service_catalog.url_for(service_type='image',
+                                              interface='adminURL')
+        if not force_v1_client and keystone.session:
+            return glance_clientv2.Client("2", session=keystone.session)
+        else:
+            return glance_client.Client(ep, token=keystone.auth_token)
+
+    def authenticate_heat_admin(self, keystone):
+        """Authenticates the admin user with heat."""
+        self.log.debug('Authenticating heat admin...')
+        ep = keystone.service_catalog.url_for(service_type='orchestration',
+                                              interface='publicURL')
+        if keystone.session:
+            return heat_client.Client(endpoint=ep, session=keystone.session)
+        else:
+            return heat_client.Client(endpoint=ep, token=keystone.auth_token)
+
+    def authenticate_nova_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with nova-api."""
+        self.log.debug('Authenticating nova user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      session=keystone.session,
+                                      auth_url=ep)
+        elif novaclient.__version__[0] >= "7":
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, password=password,
+                                      project_name=tenant, auth_url=ep)
+        else:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, api_key=password,
+                                      project_id=tenant, auth_url=ep)
+
+    def authenticate_swift_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with swift api."""
+        self.log.debug('Authenticating swift user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return swiftclient.Connection(session=keystone.session)
+        else:
+            return swiftclient.Connection(authurl=ep,
+                                          user=user,
+                                          key=password,
+                                          tenant_name=tenant,
+                                          auth_version='2.0')
+
+    def create_flavor(self, nova, name, ram, vcpus, disk, flavorid="auto",
+                      ephemeral=0, swap=0, rxtx_factor=1.0, is_public=True):
+        """Create the specified flavor."""
+        try:
+            nova.flavors.find(name=name)
+        except (exceptions.NotFound, exceptions.NoUniqueMatch):
+            self.log.debug('Creating flavor ({})'.format(name))
+            nova.flavors.create(name, ram, vcpus, disk, flavorid,
+                                ephemeral, swap, rxtx_factor, is_public)
+
+    def glance_create_image(self, glance, image_name, image_url,
+                            download_dir='tests',
+                            hypervisor_type=None,
+                            disk_format='qcow2',
+                            architecture='x86_64',
+                            container_format='bare'):
+        """Download an image and upload it to glance, validate its status
+        and return an image object pointer. KVM defaults, can override for
+        LXD.
+
+        :param glance: pointer to authenticated glance api connection
+        :param image_name: display name for new image
+        :param image_url: url to retrieve
+        :param download_dir: directory to store downloaded image file
+        :param hypervisor_type: glance image hypervisor property
+        :param disk_format: glance image disk format
+        :param architecture: glance image architecture property
+        :param container_format: glance image container format
+        :returns: glance image pointer
+        """
+        self.log.debug('Creating glance image ({}) from '
+                       '{}...'.format(image_name, image_url))
+
+        # Download image
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        abs_file_name = os.path.join(download_dir, image_name)
+        if not os.path.exists(abs_file_name):
+            opener.retrieve(image_url, abs_file_name)
+
+        # Create glance image
+        glance_properties = {
+            'architecture': architecture,
+        }
+        if hypervisor_type:
+            glance_properties['hypervisor_type'] = hypervisor_type
+        # Create glance image
+        if float(glance.version) < 2.0:
+            with open(abs_file_name) as f:
+                image = glance.images.create(
+                    name=image_name,
+                    is_public=True,
+                    disk_format=disk_format,
+                    container_format=container_format,
+                    properties=glance_properties,
+                    data=f)
+        else:
+            image = glance.images.create(
+                name=image_name,
+                visibility="public",
+                disk_format=disk_format,
+                container_format=container_format)
+            glance.images.upload(image.id, open(abs_file_name, 'rb'))
+            glance.images.update(image.id, **glance_properties)
+
+        # Wait for image to reach active status
+        img_id = image.id
+        ret = self.resource_reaches_status(glance.images, img_id,
+                                           expected_stat='active',
+                                           msg='Image status wait')
+        if not ret:
+            msg = 'Glance image failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new image
+        self.log.debug('Validating image attributes...')
+        val_img_name = glance.images.get(img_id).name
+        val_img_stat = glance.images.get(img_id).status
+        val_img_cfmt = glance.images.get(img_id).container_format
+        val_img_dfmt = glance.images.get(img_id).disk_format
+
+        if float(glance.version) < 2.0:
+            val_img_pub = glance.images.get(img_id).is_public
+        else:
+            val_img_pub = glance.images.get(img_id).visibility == "public"
+
+        msg_attr = ('Image attributes - name:{} public:{} id:{} stat:{} '
+                    'container fmt:{} disk fmt:{}'.format(
+                        val_img_name, val_img_pub, img_id,
+                        val_img_stat, val_img_cfmt, val_img_dfmt))
+
+        if val_img_name == image_name and val_img_stat == 'active' \
+                and val_img_pub is True and val_img_cfmt == container_format \
+                and val_img_dfmt == disk_format:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Image validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return image
+
+    def create_cirros_image(self, glance, image_name, hypervisor_type=None):
+        """Download the latest cirros image and upload it to glance,
+        validate and return a resource pointer.
+
+        :param glance: pointer to authenticated glance connection
+        :param image_name: display name for new image
+        :param hypervisor_type: glance image hypervisor property
+        :returns: glance image pointer
+        """
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'glance_create_image instead of '
+                      'create_cirros_image.')
+
+        self.log.debug('Creating glance cirros image '
+                       '({})...'.format(image_name))
+
+        # Get cirros image URL
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        f = opener.open('http://download.cirros-cloud.net/version/released')
+        version = f.read().strip()
+        cirros_img = 'cirros-{}-x86_64-disk.img'.format(version)
+        cirros_url = 'http://{}/{}/{}'.format('download.cirros-cloud.net',
+                                              version, cirros_img)
+        f.close()
+
+        return self.glance_create_image(
+            glance,
+            image_name,
+            cirros_url,
+            hypervisor_type=hypervisor_type)
+
+    def delete_image(self, glance, image):
+        """Delete the specified image."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_image.')
+        self.log.debug('Deleting glance image ({})...'.format(image))
+        return self.delete_resource(glance.images, image, msg='glance image')
+
+    def create_instance(self, nova, image_name, instance_name, flavor):
+        """Create the specified instance."""
+        self.log.debug('Creating instance '
+                       '({}|{}|{})'.format(instance_name, image_name, flavor))
+        image = nova.glance.find_image(image_name)
+        flavor = nova.flavors.find(name=flavor)
+        instance = nova.servers.create(name=instance_name, image=image,
+                                       flavor=flavor)
+
+        count = 1
+        status = instance.status
+        while status != 'ACTIVE' and count < 60:
+            time.sleep(3)
+            instance = nova.servers.get(instance.id)
+            status = instance.status
+            self.log.debug('instance status: {}'.format(status))
+            count += 1
+
+        if status != 'ACTIVE':
+            self.log.error('instance creation timed out')
+            return None
+
+        return instance
+
+    def delete_instance(self, nova, instance):
+        """Delete the specified instance."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_instance.')
+        self.log.debug('Deleting instance ({})...'.format(instance))
+        return self.delete_resource(nova.servers, instance,
+                                    msg='nova instance')
+
+    def create_or_get_keypair(self, nova, keypair_name="testkey"):
+        """Create a new keypair, or return pointer if it already exists."""
+        try:
+            _keypair = nova.keypairs.get(keypair_name)
+            self.log.debug('Keypair ({}) already exists, '
+                           'using it.'.format(keypair_name))
+            return _keypair
+        except Exception:
+            self.log.debug('Keypair ({}) does not exist, '
+                           'creating it.'.format(keypair_name))
+
+        _keypair = nova.keypairs.create(name=keypair_name)
+        return _keypair
+
+    def _get_cinder_obj_name(self, cinder_object):
+        """Retrieve name of cinder object.
+
+        :param cinder_object: cinder snapshot or volume object
+        :returns: str cinder object name
+        """
+        # v1 objects store name in 'display_name' attr but v2+ use 'name'
+        try:
+            return cinder_object.display_name
+        except AttributeError:
+            return cinder_object.name
+
+    def create_cinder_volume(self, cinder, vol_name="demo-vol", vol_size=1,
+                             img_id=None, src_vol_id=None, snap_id=None):
+        """Create cinder volume, optionally from a glance image, OR
+        optionally as a clone of an existing volume, OR optionally
+        from a snapshot.  Wait for the new volume status to reach
+        the expected status, validate and return a resource pointer.
+
+        :param vol_name: cinder volume display name
+        :param vol_size: size in gigabytes
+        :param img_id: optional glance image id
+        :param src_vol_id: optional source volume id to clone
+        :param snap_id: optional snapshot id to use
+        :returns: cinder volume pointer
+        """
+        # Handle parameter input and avoid impossible combinations
+        if img_id and not src_vol_id and not snap_id:
+            # Create volume from image
+            self.log.debug('Creating cinder volume from glance image...')
+            bootable = 'true'
+        elif src_vol_id and not img_id and not snap_id:
+            # Clone an existing volume
+            self.log.debug('Cloning cinder volume...')
+            bootable = cinder.volumes.get(src_vol_id).bootable
+        elif snap_id and not src_vol_id and not img_id:
+            # Create volume from snapshot
+            self.log.debug('Creating cinder volume from snapshot...')
+            snap = cinder.volume_snapshots.find(id=snap_id)
+            vol_size = snap.size
+            snap_vol_id = cinder.volume_snapshots.get(snap_id).volume_id
+            bootable = cinder.volumes.get(snap_vol_id).bootable
+        elif not img_id and not src_vol_id and not snap_id:
+            # Create volume
+            self.log.debug('Creating cinder volume...')
+            bootable = 'false'
+        else:
+            # Impossible combination of parameters
+            msg = ('Invalid method use - name:{} size:{} img_id:{} '
+                   'src_vol_id:{} snap_id:{}'.format(vol_name, vol_size,
+                                                     img_id, src_vol_id,
+                                                     snap_id))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Create new volume
+        try:
+            vol_new = cinder.volumes.create(display_name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except TypeError:
+            vol_new = cinder.volumes.create(name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except Exception as e:
+            msg = 'Failed to create volume: {}'.format(e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Wait for volume to reach available status
+        ret = self.resource_reaches_status(cinder.volumes, vol_id,
+                                           expected_stat="available",
+                                           msg="Volume status wait")
+        if not ret:
+            msg = 'Cinder volume failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new volume
+        self.log.debug('Validating volume attributes...')
+        val_vol_name = self._get_cinder_obj_name(cinder.volumes.get(vol_id))
+        val_vol_boot = cinder.volumes.get(vol_id).bootable
+        val_vol_stat = cinder.volumes.get(vol_id).status
+        val_vol_size = cinder.volumes.get(vol_id).size
+        msg_attr = ('Volume attributes - name:{} id:{} stat:{} boot:'
+                    '{} size:{}'.format(val_vol_name, vol_id,
+                                        val_vol_stat, val_vol_boot,
+                                        val_vol_size))
+
+        if val_vol_boot == bootable and val_vol_stat == 'available' \
+                and val_vol_name == vol_name and val_vol_size == vol_size:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Volume validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return vol_new
+
+    def delete_resource(self, resource, resource_id,
+                        msg="resource", max_wait=120):
+        """Delete one openstack resource, such as one instance, keypair,
+        image, volume, stack, etc., and confirm deletion within max wait time.
+
+        :param resource: pointer to os resource type, ex:glance_client.images
+        :param resource_id: unique name or id for the openstack resource
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, otherwise False
+        """
+        self.log.debug('Deleting OpenStack resource '
+                       '{} ({})'.format(resource_id, msg))
+        num_before = len(list(resource.list()))
+        resource.delete(resource_id)
+
+        tries = 0
+        num_after = len(list(resource.list()))
+        while num_after != (num_before - 1) and tries < (max_wait / 4):
+            self.log.debug('{} delete check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  num_before,
+                                                  num_after,
+                                                  resource_id))
+            time.sleep(4)
+            num_after = len(list(resource.list()))
+            tries += 1
+
+        self.log.debug('{}:  expected, actual count = {}, '
+                       '{}'.format(msg, num_before - 1, num_after))
+
+        if num_after == (num_before - 1):
+            return True
+        else:
+            self.log.error('{} delete timed out'.format(msg))
+            return False
+
+    def resource_reaches_status(self, resource, resource_id,
+                                expected_stat='available',
+                                msg='resource', max_wait=120):
+        """Wait for an openstack resources status to reach an
+           expected status within a specified time.  Useful to confirm that
+           nova instances, cinder vols, snapshots, glance images, heat stacks
+           and other resources eventually reach the expected status.
+
+        :param resource: pointer to os resource type, ex: heat_client.stacks
+        :param resource_id: unique id for the openstack resource
+        :param expected_stat: status to expect resource to reach
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, False if status is not reached
+        """
+
+        tries = 0
+        resource_stat = resource.get(resource_id).status
+        while resource_stat != expected_stat and tries < (max_wait / 4):
+            self.log.debug('{} status check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  resource_stat,
+                                                  expected_stat,
+                                                  resource_id))
+            time.sleep(4)
+            resource_stat = resource.get(resource_id).status
+            tries += 1
+
+        self.log.debug('{}:  expected, actual status = {}, '
+                       '{}'.format(msg, resource_stat, expected_stat))
+
+        if resource_stat == expected_stat:
+            return True
+        else:
+            self.log.debug('{} never reached expected status: '
+                           '{}'.format(resource_id, expected_stat))
+            return False
+
+    def get_ceph_osd_id_cmd(self, index):
+        """Produce a shell command that will return a ceph-osd id."""
+        return ("`initctl list | grep 'ceph-osd ' | "
+                "awk 'NR=={} {{ print $2 }}' | "
+                "grep -o '[0-9]*'`".format(index + 1))
+
+    def get_ceph_pools(self, sentry_unit):
+        """Return a dict of ceph pools from a single ceph unit, with
+        pool name as keys, pool id as vals."""
+        pools = {}
+        cmd = 'sudo ceph osd lspools'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # For mimic ceph osd lspools output
+        output = output.replace("\n", ",")
+
+        # Example output: 0 data,1 metadata,2 rbd,3 cinder,4 glance,
+        for pool in str(output).split(','):
+            pool_id_name = pool.split(' ')
+            if len(pool_id_name) == 2:
+                pool_id = pool_id_name[0]
+                pool_name = pool_id_name[1]
+                pools[pool_name] = int(pool_id)
+
+        self.log.debug('Pools on {}: {}'.format(sentry_unit.info['unit_name'],
+                                                pools))
+        return pools
+
+    def get_ceph_df(self, sentry_unit):
+        """Return dict of ceph df json output, including ceph pool state.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :returns: Dict of ceph df output
+        """
+        cmd = 'sudo ceph df --format=json'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return json.loads(output)
+
+    def get_ceph_pool_sample(self, sentry_unit, pool_id=0):
+        """Take a sample of attributes of a ceph pool, returning ceph
+        pool name, object count and disk space used for the specified
+        pool ID number.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :param pool_id: Ceph pool ID
+        :returns: List of pool name, object count, kb disk space used
+        """
+        df = self.get_ceph_df(sentry_unit)
+        for pool in df['pools']:
+            if pool['id'] == pool_id:
+                pool_name = pool['name']
+                obj_count = pool['stats']['objects']
+                kb_used = pool['stats']['kb_used']
+
+        self.log.debug('Ceph {} pool (ID {}): {} objects, '
+                       '{} kb used'.format(pool_name, pool_id,
+                                           obj_count, kb_used))
+        return pool_name, obj_count, kb_used
+
+    def validate_ceph_pool_samples(self, samples, sample_type="resource pool"):
+        """Validate ceph pool samples taken over time, such as pool
+        object counts or pool kb used, before adding, after adding, and
+        after deleting items which affect those pool attributes.  The
+        2nd element is expected to be greater than the 1st; 3rd is expected
+        to be less than the 2nd.
+
+        :param samples: List containing 3 data samples
+        :param sample_type: String for logging and usage context
+        :returns: None if successful, Failure message otherwise
+        """
+        original, created, deleted = range(3)
+        if samples[created] <= samples[original] or \
+                samples[deleted] >= samples[created]:
+            return ('Ceph {} samples ({}) '
+                    'unexpected.'.format(sample_type, samples))
+        else:
+            self.log.debug('Ceph {} samples (OK): '
+                           '{}'.format(sample_type, samples))
+            return None
+
+    # rabbitmq/amqp specific helpers:
+
+    def rmq_wait_for_cluster(self, deployment, init_sleep=15, timeout=1200):
+        """Wait for rmq units extended status to show cluster readiness,
+        after an optional initial sleep period.  Initial sleep is likely
+        necessary to be effective following a config change, as status
+        message may not instantly update to non-ready."""
+
+        if init_sleep:
+            time.sleep(init_sleep)
+
+        message = re.compile('^Unit is ready and clustered$')
+        deployment._auto_wait_for_status(message=message,
+                                         timeout=timeout,
+                                         include_only=['rabbitmq-server'])
+
+    def add_rmq_test_user(self, sentry_units,
+                          username="testuser1", password="changeme"):
+        """Add a test user via the first rmq juju unit, check connection as
+        the new user against all sentry units.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Adding rmq user ({})...'.format(username))
+
+        # Check that user does not already exist
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+        if username in output:
+            self.log.warning('User ({}) already exists, returning '
+                             'gracefully.'.format(username))
+            return
+
+        perms = '".*" ".*" ".*"'
+        cmds = ['rabbitmqctl add_user {} {}'.format(username, password),
+                'rabbitmqctl set_permissions {} {}'.format(username, perms)]
+
+        # Add user via first unit
+        for cmd in cmds:
+            output, _ = self.run_cmd_unit(sentry_units[0], cmd)
+
+        # Check connection against the other sentry_units
+        self.log.debug('Checking user connect against units...')
+        for sentry_unit in sentry_units:
+            connection = self.connect_amqp_by_unit(sentry_unit, ssl=False,
+                                                   username=username,
+                                                   password=password)
+            connection.close()
+
+    def delete_rmq_test_user(self, sentry_units, username="testuser1"):
+        """Delete a rabbitmq user via the first rmq juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful or no such user.
+        """
+        self.log.debug('Deleting rmq user ({})...'.format(username))
+
+        # Check that the user exists
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+
+        if username not in output:
+            self.log.warning('User ({}) does not exist, returning '
+                             'gracefully.'.format(username))
+            return
+
+        # Delete the user
+        cmd_user_del = 'rabbitmqctl delete_user {}'.format(username)
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_del)
+
+    def get_rmq_cluster_status(self, sentry_unit):
+        """Execute rabbitmq cluster status command on a unit and return
+        the full output.
+
+        :param unit: sentry unit
+        :returns: String containing console output of cluster status command
+        """
+        cmd = 'rabbitmqctl cluster_status'
+        output, _ = self.run_cmd_unit(sentry_unit, cmd)
+        self.log.debug('{} cluster_status:\n{}'.format(
+            sentry_unit.info['unit_name'], output))
+        return str(output)
+
+    def get_rmq_cluster_running_nodes(self, sentry_unit):
+        """Parse rabbitmqctl cluster_status output string, return list of
+        running rabbitmq cluster nodes.
+
+        :param unit: sentry unit
+        :returns: List containing node names of running nodes
+        """
+        # NOTE(beisner): rabbitmqctl cluster_status output is not
+        # json-parsable, do string chop foo, then json.loads that.
+        str_stat = self.get_rmq_cluster_status(sentry_unit)
+        if 'running_nodes' in str_stat:
+            pos_start = str_stat.find("{running_nodes,") + 15
+            pos_end = str_stat.find("]},", pos_start) + 1
+            str_run_nodes = str_stat[pos_start:pos_end].replace("'", '"')
+            run_nodes = json.loads(str_run_nodes)
+            return run_nodes
+        else:
+            return []
+
+    def validate_rmq_cluster_running_nodes(self, sentry_units):
+        """Check that all rmq unit hostnames are represented in the
+        cluster_status output of all units.
+
+        :param host_names: dict of juju unit names to host names
+        :param units: list of sentry unit pointers (all rmq units)
+        :returns: None if successful, otherwise return error message
+        """
+        host_names = self.get_unit_hostnames(sentry_units)
+        errors = []
+
+        # Query every unit for cluster_status running nodes
+        for query_unit in sentry_units:
+            query_unit_name = query_unit.info['unit_name']
+            running_nodes = self.get_rmq_cluster_running_nodes(query_unit)
+
+            # Confirm that every unit is represented in the queried unit's
+            # cluster_status running nodes output.
+            for validate_unit in sentry_units:
+                val_host_name = host_names[validate_unit.info['unit_name']]
+                val_node_name = 'rabbit@{}'.format(val_host_name)
+
+                if val_node_name not in running_nodes:
+                    errors.append('Cluster member check failed on {}: {} not '
+                                  'in {}\n'.format(query_unit_name,
+                                                   val_node_name,
+                                                   running_nodes))
+        if errors:
+            return ''.join(errors)
+
+    def rmq_ssl_is_enabled_on_unit(self, sentry_unit, port=None):
+        """Check a single juju rmq unit for ssl and port in the config file."""
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        conf_file = '/etc/rabbitmq/rabbitmq.config'
+        conf_contents = str(self.file_contents_safe(sentry_unit,
+                                                    conf_file, max_wait=16))
+        # Checks
+        conf_ssl = 'ssl' in conf_contents
+        conf_port = str(port) in conf_contents
+
+        # Port explicitly checked in config
+        if port and conf_port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif port and not conf_port and conf_ssl:
+            self.log.debug('SSL is enabled @{} but not on port {} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        # Port not checked (useful when checking that ssl is disabled)
+        elif not port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif not conf_ssl:
+            self.log.debug('SSL not enabled @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        else:
+            msg = ('Unknown condition when checking SSL status @{}:{} '
+                   '({})'.format(host, port, unit_name))
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_rmq_ssl_enabled_units(self, sentry_units, port=None):
+        """Check that ssl is enabled on rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :param port: optional ssl port override to validate
+        :returns: None if successful, otherwise return error message
+        """
+        for sentry_unit in sentry_units:
+            if not self.rmq_ssl_is_enabled_on_unit(sentry_unit, port=port):
+                return ('Unexpected condition:  ssl is disabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def validate_rmq_ssl_disabled_units(self, sentry_units):
+        """Check that ssl is enabled on listed rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :returns: True if successful.  Raise on error.
+        """
+        for sentry_unit in sentry_units:
+            if self.rmq_ssl_is_enabled_on_unit(sentry_unit):
+                return ('Unexpected condition:  ssl is enabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def configure_rmq_ssl_on(self, sentry_units, deployment,
+                             port=None, max_wait=60):
+        """Turn ssl charm config option on, with optional non-default
+        ssl port specification.  Confirm that it is enabled on every
+        unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param port: amqp port, use defaults if None
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  on')
+
+        # Enable RMQ SSL
+        config = {'ssl': 'on'}
+        if port:
+            config['ssl_port'] = port
+
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def configure_rmq_ssl_off(self, sentry_units, deployment, max_wait=60):
+        """Turn ssl charm config option off, confirm that it is disabled
+        on every unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  off')
+
+        # Disable RMQ SSL
+        config = {'ssl': 'off'}
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def connect_amqp_by_unit(self, sentry_unit, ssl=False,
+                             port=None, fatal=True,
+                             username="testuser1", password="changeme"):
+        """Establish and return a pika amqp connection to the rabbitmq service
+        running on a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :param fatal: boolean, default to True (raises on connect error)
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: pika amqp connection pointer or None if failed and non-fatal
+        """
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        # Default port logic if port is not specified
+        if ssl and not port:
+            port = 5671
+        elif not ssl and not port:
+            port = 5672
+
+        self.log.debug('Connecting to amqp on {}:{} ({}) as '
+                       '{}...'.format(host, port, unit_name, username))
+
+        try:
+            credentials = pika.PlainCredentials(username, password)
+            parameters = pika.ConnectionParameters(host=host, port=port,
+                                                   credentials=credentials,
+                                                   ssl=ssl,
+                                                   connection_attempts=3,
+                                                   retry_delay=5,
+                                                   socket_timeout=1)
+            connection = pika.BlockingConnection(parameters)
+            assert connection.is_open is True
+            assert connection.is_closing is False
+            self.log.debug('Connect OK')
+            return connection
+        except Exception as e:
+            msg = ('amqp connection failed to {}:{} as '
+                   '{} ({})'.format(host, port, username, str(e)))
+            if fatal:
+                amulet.raise_status(amulet.FAIL, msg)
+            else:
+                self.log.warn(msg)
+                return None
+
+    def publish_amqp_message_by_unit(self, sentry_unit, message,
+                                     queue="test", ssl=False,
+                                     username="testuser1",
+                                     password="changeme",
+                                     port=None):
+        """Publish an amqp message to a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param message: amqp message string
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: None.  Raises exception if publish failed.
+        """
+        self.log.debug('Publishing message to {} queue:\n{}'.format(queue,
+                                                                    message))
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+
+        # NOTE(beisner): extra debug here re: pika hang potential:
+        #   https://github.com/pika/pika/issues/297
+        #   https://groups.google.com/forum/#!topic/rabbitmq-users/Ja0iyfF0Szw
+        self.log.debug('Defining channel...')
+        channel = connection.channel()
+        self.log.debug('Declaring queue...')
+        channel.queue_declare(queue=queue, auto_delete=False, durable=True)
+        self.log.debug('Publishing message...')
+        channel.basic_publish(exchange='', routing_key=queue, body=message)
+        self.log.debug('Closing channel...')
+        channel.close()
+        self.log.debug('Closing connection...')
+        connection.close()
+
+    def get_amqp_message_by_unit(self, sentry_unit, queue="test",
+                                 username="testuser1",
+                                 password="changeme",
+                                 ssl=False, port=None):
+        """Get an amqp message from a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: amqp message body as string.  Raise if get fails.
+        """
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+        channel = connection.channel()
+        method_frame, _, body = channel.basic_get(queue)
+
+        if method_frame:
+            self.log.debug('Retreived message from {} queue:\n{}'.format(queue,
+                                                                         body))
+            channel.basic_ack(method_frame.delivery_tag)
+            channel.close()
+            connection.close()
+            return body
+        else:
+            msg = 'No message retrieved.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_memcache(self, sentry_unit, conf, os_release,
+                          earliest_release=5, section='keystone_authtoken',
+                          check_kvs=None):
+        """Check Memcache is running and is configured to be used
+
+        Example call from Amulet test:
+
+            def test_110_memcache(self):
+                u.validate_memcache(self.neutron_api_sentry,
+                                    '/etc/neutron/neutron.conf',
+                                    self._get_openstack_release())
+
+        :param sentry_unit: sentry unit
+        :param conf: OpenStack config file to check memcache settings
+        :param os_release: Current OpenStack release int code
+        :param earliest_release: Earliest Openstack release to check int code
+        :param section: OpenStack config file section to check
+        :param check_kvs: Dict of settings to check in config file
+        :returns: None
+        """
+        if os_release < earliest_release:
+            self.log.debug('Skipping memcache checks for deployment. {} <'
+                           'mitaka'.format(os_release))
+            return
+        _kvs = check_kvs or {'memcached_servers': 'inet6:[::1]:11211'}
+        self.log.debug('Checking memcached is running')
+        ret = self.validate_services_by_name({sentry_unit: ['memcached']})
+        if ret:
+            amulet.raise_status(amulet.FAIL, msg='Memcache running check'
+                                'failed {}'.format(ret))
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache url is configured in {}'.format(
+            conf))
+        if self.validate_config_data(sentry_unit, conf, section, _kvs):
+            message = "Memcache config error in: {}".format(conf)
+            amulet.raise_status(amulet.FAIL, msg=message)
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache configuration in '
+                       '/etc/memcached.conf')
+        contents = self.file_contents_safe(sentry_unit, '/etc/memcached.conf',
+                                           fatal=True)
+        ubuntu_release, _ = self.run_cmd_unit(sentry_unit, 'lsb_release -cs')
+        if CompareHostReleases(ubuntu_release) <= 'trusty':
+            memcache_listen_addr = 'ip6-localhost'
+        else:
+            memcache_listen_addr = '::1'
+        expected = {
+            '-p': '11211',
+            '-l': memcache_listen_addr}
+        found = []
+        for key, value in expected.items():
+            for line in contents.split('\n'):
+                if line.startswith(key):
+                    self.log.debug('Checking {} is set to {}'.format(
+                        key,
+                        value))
+                    assert value == line.split()[-1]
+                    self.log.debug(line.split()[-1])
+                    found.append(key)
+        if sorted(found) == sorted(expected.keys()):
+            self.log.debug('OK')
+        else:
+            message = "Memcache config error in: /etc/memcached.conf"
+            amulet.raise_status(amulet.FAIL, msg=message)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f7e5f79a5d5fe3cb374814e32ea16f6060f4f27
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/__init__.py
@@ -0,0 +1,212 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""OpenStack Security Audit code"""
+
+import collections
+from enum import Enum
+import traceback
+
+from charmhelpers.core.host import cmp_pkgrevno
+import charmhelpers.contrib.openstack.utils as openstack_utils
+import charmhelpers.core.hookenv as hookenv
+
+
+class AuditType(Enum):
+    OpenStackSecurityGuide = 1
+
+
+_audits = {}
+
+Audit = collections.namedtuple('Audit', 'func filters')
+
+
+def audit(*args):
+    """Decorator to register an audit.
+
+    These are used to generate audits that can be run on a
+    deployed system that matches the given configuration
+
+    :param args: List of functions to filter tests against
+    :type args: List[Callable[Dict]]
+    """
+    def wrapper(f):
+        test_name = f.__name__
+        if _audits.get(test_name):
+            raise RuntimeError(
+                "Test name '{}' used more than once"
+                .format(test_name))
+        non_callables = [fn for fn in args if not callable(fn)]
+        if non_callables:
+            raise RuntimeError(
+                "Configuration includes non-callable filters: {}"
+                .format(non_callables))
+        _audits[test_name] = Audit(func=f, filters=args)
+        return f
+    return wrapper
+
+
+def is_audit_type(*args):
+    """This audit is included in the specified kinds of audits.
+
+    :param *args: List of AuditTypes to include this audit in
+    :type args: List[AuditType]
+    :rtype: Callable[Dict]
+    """
+    def _is_audit_type(audit_options):
+        if audit_options.get('audit_type') in args:
+            return True
+        else:
+            return False
+    return _is_audit_type
+
+
+def since_package(pkg, pkg_version):
+    """This audit should be run after the specified package version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_package(audit_options=None):
+        return cmp_pkgrevno(pkg, pkg_version) >= 0
+
+    return _since_package
+
+
+def before_package(pkg, pkg_version):
+    """This audit should be run before the specified package version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_package(audit_options=None):
+        return not since_package(pkg, pkg_version)()
+
+    return _before_package
+
+
+def since_openstack_release(pkg, release):
+    """This audit should run after the specified OpenStack version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_openstack_release(audit_options=None):
+        _release = openstack_utils.get_os_codename_package(pkg)
+        return openstack_utils.CompareOpenStackReleases(_release) >= release
+
+    return _since_openstack_release
+
+
+def before_openstack_release(pkg, release):
+    """This audit should run before the specified OpenStack version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_openstack_release(audit_options=None):
+        return not since_openstack_release(pkg, release)()
+
+    return _before_openstack_release
+
+
+def it_has_config(config_key):
+    """This audit should be run based on specified config keys.
+
+    :param config_key: Config key to look for
+    :type config_key: str
+    :rtype: Callable[Dict]
+    """
+    def _it_has_config(audit_options):
+        return audit_options.get(config_key) is not None
+
+    return _it_has_config
+
+
+def run(audit_options):
+    """Run the configured audits with the specified audit_options.
+
+    :param audit_options: Configuration for the audit
+    :type audit_options: Config
+
+    :rtype: Dict[str, str]
+    """
+    errors = {}
+    results = {}
+    for name, audit in sorted(_audits.items()):
+        result_name = name.replace('_', '-')
+        if result_name in audit_options.get('excludes', []):
+            print(
+                "Skipping {} because it is"
+                "excluded in audit config"
+                .format(result_name))
+            continue
+        if all(p(audit_options) for p in audit.filters):
+            try:
+                audit.func(audit_options)
+                print("{}: PASS".format(name))
+                results[result_name] = {
+                    'success': True,
+                }
+            except AssertionError as e:
+                print("{}: FAIL ({})".format(name, e))
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+            except Exception as e:
+                print("{}: ERROR ({})".format(name, e))
+                errors[name] = e
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+    for name, error in errors.items():
+        print("=" * 20)
+        print("Error in {}: ".format(name))
+        traceback.print_tb(error.__traceback__)
+        print()
+    return results
+
+
+def action_parse_results(result):
+    """Parse the result of `run` in the context of an action.
+
+    :param result: The result of running the security-checklist
+        action on a unit
+    :type result: Dict[str, Dict[str, str]]
+    :rtype: int
+    """
+    passed = True
+    for test, result in result.items():
+        if result['success']:
+            hookenv.action_set({test: 'PASS'})
+        else:
+            hookenv.action_set({test: 'FAIL - {}'.format(result['message'])})
+            passed = False
+    if not passed:
+        hookenv.action_fail("One or more tests failed")
+    return 0 if passed else 1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
new file mode 100644
index 0000000000000000000000000000000000000000..79740ed0c103e841b6e280af920f8be65e3d1d0d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
@@ -0,0 +1,270 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import configparser
+import glob
+import os.path
+import subprocess
+
+from charmhelpers.contrib.openstack.audits import (
+    audit,
+    AuditType,
+    # filters
+    is_audit_type,
+    it_has_config,
+)
+
+from charmhelpers.core.hookenv import (
+    cached,
+)
+
+"""
+The Security Guide suggests a specific list of files inside the
+config directory for the service having 640 specifically, but
+by ensuring the containing directory is 750, only the owner can
+write, and only the group can read files within the directory.
+
+By  restricting access to the containing directory, we can more
+effectively ensure that there is no accidental leakage if a new
+file is added to the service without being added to the security
+guide, and to this check.
+"""
+FILE_ASSERTIONS = {
+    'barbican': {
+        '/etc/barbican': {'group': 'barbican', 'mode': '750'},
+    },
+    'ceph-mon': {
+        '/var/lib/charm/ceph-mon/ceph.conf':
+            {'owner': 'root', 'group': 'root', 'mode': '644'},
+        '/etc/ceph/ceph.client.admin.keyring':
+            {'owner': 'ceph', 'group': 'ceph'},
+        '/etc/ceph/rbdmap': {'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'}
+    },
+    'ceph-osd': {
+        '/var/lib/charm/ceph-osd/ceph.conf':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/*': {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'},
+        '/var/lib/ceph/radosgw':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+    },
+    'cinder': {
+        '/etc/cinder': {'group': 'cinder', 'mode': '750'},
+    },
+    'glance': {
+        '/etc/glance': {'group': 'glance', 'mode': '750'},
+    },
+    'keystone': {
+        '/etc/keystone':
+            {'owner': 'keystone', 'group': 'keystone', 'mode': '750'},
+    },
+    'manilla': {
+        '/etc/manila': {'group': 'manilla', 'mode': '750'},
+    },
+    'neutron-gateway': {
+        '/etc/neutron': {'group': 'neutron', 'mode': '750'},
+    },
+    'neutron-api': {
+        '/etc/neutron/': {'group': 'neutron', 'mode': '750'},
+    },
+    'nova-cloud-controller': {
+        '/etc/nova': {'group': 'nova', 'mode': '750'},
+    },
+    'nova-compute': {
+        '/etc/nova/': {'group': 'nova', 'mode': '750'},
+    },
+    'openstack-dashboard': {
+        # From security guide
+        '/etc/openstack-dashboard/local_settings.py':
+            {'group': 'horizon', 'mode': '640'},
+    },
+}
+
+Ownership = collections.namedtuple('Ownership', 'owner group mode')
+
+
+@cached
+def _stat(file):
+    """
+    Get the Ownership information from a file.
+
+    :param file: The path to a file to stat
+    :type file: str
+    :returns: owner, group, and mode of the specified file
+    :rtype: Ownership
+    :raises subprocess.CalledProcessError: If the underlying stat fails
+    """
+    out = subprocess.check_output(
+        ['stat', '-c', '%U %G %a', file]).decode('utf-8')
+    return Ownership(*out.strip().split(' '))
+
+
+@cached
+def _config_ini(path):
+    """
+    Parse an ini file
+
+    :param path: The path to a file to parse
+    :type file: str
+    :returns: Configuration contained in path
+    :rtype: Dict
+    """
+    # When strict is enabled, duplicate options are not allowed in the
+    # parsed INI; however, Oslo allows duplicate values. This change
+    # causes us to ignore the duplicate values which is acceptable as
+    # long as we don't validate any multi-value options
+    conf = configparser.ConfigParser(strict=False)
+    conf.read(path)
+    return dict(conf)
+
+
+def _validate_file_ownership(owner, group, file_name, optional=False):
+    """
+    Validate that a specified file is owned by `owner:group`.
+
+    :param owner: Name of the owner
+    :type owner: str
+    :param group: Name of the group
+    :type group: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert owner == ownership.owner, \
+        "{} has an incorrect owner: {} should be {}".format(
+            file_name, ownership.owner, owner)
+    assert group == ownership.group, \
+        "{} has an incorrect group: {} should be {}".format(
+            file_name, ownership.group, group)
+    print("Validate ownership of {}: PASS".format(file_name))
+
+
+def _validate_file_mode(mode, file_name, optional=False):
+    """
+    Validate that a specified file has the specified permissions.
+
+    :param mode: file mode that is desires
+    :type owner: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert mode == ownership.mode, \
+        "{} has an incorrect mode: {} should be {}".format(
+            file_name, ownership.mode, mode)
+    print("Validate mode of {}: PASS".format(file_name))
+
+
+@cached
+def _config_section(config, section):
+    """Read the configuration file and return a section."""
+    path = os.path.join(config.get('config_path'), config.get('config_file'))
+    conf = _config_ini(path)
+    return conf.get(section)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_ownership(config):
+    """Verify that configuration files are owned by the correct user/group."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        owner = options.get('owner', config.get('owner', 'root'))
+        group = options.get('group', config.get('group', 'root'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_ownership(owner, group, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_ownership(owner, group, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_permissions(config):
+    """Verify that permissions on configuration files are secure enough."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        mode = options.get('mode', config.get('permissions', '600'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_mode(mode, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_mode(mode, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_keystone(audit_options):
+    """Validate that the service uses Keystone for authentication."""
+    section = _config_section(audit_options, 'api') or _config_section(audit_options, 'DEFAULT')
+    assert section is not None, "Missing section 'api / DEFAULT'"
+    assert section.get('auth_strategy') == "keystone", \
+        "Application is not using Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_keystone(audit_options):
+    """Verify that TLS is used to communicate with Keystone."""
+    section = _config_section(audit_options, 'keystone_authtoken')
+    assert section is not None, "Missing section 'keystone_authtoken'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("auth_uri"), \
+        "TLS is not used for Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_glance(audit_options):
+    """Verify that TLS is used to communicate with Glance."""
+    section = _config_section(audit_options, 'glance')
+    assert section is not None, "Missing section 'glance'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("api_servers"), \
+        "TLS is not used for Glance"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/cert_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/cert_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b494af64aeae55db44b669990725de81705104b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/cert_utils.py
@@ -0,0 +1,289 @@
+# Copyright 2014-2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charm certificats.
+
+import os
+import json
+
+from charmhelpers.contrib.network.ip import (
+    get_hostname,
+    resolve_network_cidr,
+)
+from charmhelpers.core.hookenv import (
+    local_unit,
+    network_get_primary_address,
+    config,
+    related_units,
+    relation_get,
+    relation_ids,
+    unit_get,
+    NoNetworkBinding,
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.openstack.ip import (
+    ADMIN,
+    resolve_address,
+    get_vip_in_network,
+    INTERNAL,
+    PUBLIC,
+    ADDRESS_MAP)
+
+from charmhelpers.core.host import (
+    mkdir,
+    write_file,
+)
+
+from charmhelpers.contrib.hahelpers.apache import (
+    install_ca_cert
+)
+
+
+class CertRequest(object):
+
+    """Create a request for certificates to be generated
+    """
+
+    def __init__(self, json_encode=True):
+        self.entries = []
+        self.hostname_entry = None
+        self.json_encode = json_encode
+
+    def add_entry(self, net_type, cn, addresses):
+        """Add a request to the batch
+
+        :param net_type: str netwrok space name request is for
+        :param cn: str Canonical Name for certificate
+        :param addresses: [] List of addresses to be used as SANs
+        """
+        self.entries.append({
+            'cn': cn,
+            'addresses': addresses})
+
+    def add_hostname_cn(self):
+        """Add a request for the hostname of the machine"""
+        ip = unit_get('private-address')
+        addresses = [ip]
+        # If a vip is being used without os-hostname config or
+        # network spaces then we need to ensure the local units
+        # cert has the approriate vip in the SAN list
+        vip = get_vip_in_network(resolve_network_cidr(ip))
+        if vip:
+            addresses.append(vip)
+        self.hostname_entry = {
+            'cn': get_hostname(ip),
+            'addresses': addresses}
+
+    def add_hostname_cn_ip(self, addresses):
+        """Add an address to the SAN list for the hostname request
+
+        :param addr: [] List of address to be added
+        """
+        for addr in addresses:
+            if addr not in self.hostname_entry['addresses']:
+                self.hostname_entry['addresses'].append(addr)
+
+    def get_request(self):
+        """Generate request from the batched up entries
+
+        """
+        if self.hostname_entry:
+            self.entries.append(self.hostname_entry)
+        request = {}
+        for entry in self.entries:
+            sans = sorted(list(set(entry['addresses'])))
+            request[entry['cn']] = {'sans': sans}
+        if self.json_encode:
+            req = {'cert_requests': json.dumps(request, sort_keys=True)}
+        else:
+            req = {'cert_requests': request}
+        req['unit_name'] = local_unit().replace('/', '_')
+        return req
+
+
+def get_certificate_request(json_encode=True):
+    """Generate a certificatee requests based on the network confioguration
+
+    """
+    req = CertRequest(json_encode=json_encode)
+    req.add_hostname_cn()
+    # Add os-hostname entries
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        net_config = config(ADDRESS_MAP[net_type]['override'])
+        try:
+            net_addr = resolve_address(endpoint_type=net_type)
+            ip = network_get_primary_address(
+                ADDRESS_MAP[net_type]['binding'])
+            addresses = [net_addr, ip]
+            vip = get_vip_in_network(resolve_network_cidr(ip))
+            if vip:
+                addresses.append(vip)
+            if net_config:
+                req.add_entry(
+                    net_type,
+                    net_config,
+                    addresses)
+            else:
+                # There is network address with no corresponding hostname.
+                # Add the ip to the hostname cert to allow for this.
+                req.add_hostname_cn_ip(addresses)
+        except NoNetworkBinding:
+            log("Skipping request for certificate for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    return req.get_request()
+
+
+def create_ip_cert_links(ssl_dir, custom_hostname_link=None):
+    """Create symlinks for SAN records
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param custom_hostname_link: str Additional link to be created
+    """
+    hostname = get_hostname(unit_get('private-address'))
+    hostname_cert = os.path.join(
+        ssl_dir,
+        'cert_{}'.format(hostname))
+    hostname_key = os.path.join(
+        ssl_dir,
+        'key_{}'.format(hostname))
+    # Add links to hostname cert, used if os-hostname vars not set
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        try:
+            addr = resolve_address(endpoint_type=net_type)
+            cert = os.path.join(ssl_dir, 'cert_{}'.format(addr))
+            key = os.path.join(ssl_dir, 'key_{}'.format(addr))
+            if os.path.isfile(hostname_cert) and not os.path.isfile(cert):
+                os.symlink(hostname_cert, cert)
+                os.symlink(hostname_key, key)
+        except NoNetworkBinding:
+            log("Skipping creating cert symlink for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    if custom_hostname_link:
+        custom_cert = os.path.join(
+            ssl_dir,
+            'cert_{}'.format(custom_hostname_link))
+        custom_key = os.path.join(
+            ssl_dir,
+            'key_{}'.format(custom_hostname_link))
+        if os.path.isfile(hostname_cert) and not os.path.isfile(custom_cert):
+            os.symlink(hostname_cert, custom_cert)
+            os.symlink(hostname_key, custom_key)
+
+
+def install_certs(ssl_dir, certs, chain=None, user='root', group='root'):
+    """Install the certs passed into the ssl dir and append the chain if
+       provided.
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param certs: {} {'cn': {'cert': 'CERT', 'key': 'KEY'}}
+    :param chain: str Chain to be appended to certs
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    """
+    for cn, bundle in certs.items():
+        cert_filename = 'cert_{}'.format(cn)
+        key_filename = 'key_{}'.format(cn)
+        cert_data = bundle['cert']
+        if chain:
+            # Append chain file so that clients that trust the root CA will
+            # trust certs signed by an intermediate in the chain
+            cert_data = cert_data + os.linesep + chain
+        write_file(
+            path=os.path.join(ssl_dir, cert_filename), owner=user, group=group,
+            content=cert_data, perms=0o640)
+        write_file(
+            path=os.path.join(ssl_dir, key_filename), owner=user, group=group,
+            content=bundle['key'], perms=0o640)
+
+
+def process_certificates(service_name, relation_id, unit,
+                         custom_hostname_link=None, user='root', group='root'):
+    """Process the certificates supplied down the relation
+
+    :param service_name: str Name of service the certifcates are for.
+    :param relation_id: str Relation id providing the certs
+    :param unit: str Unit providing the certs
+    :param custom_hostname_link: str Name of custom link to create
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    :returns: True if certificates processed for local unit or False
+    :rtype: bool
+    """
+    data = relation_get(rid=relation_id, unit=unit)
+    ssl_dir = os.path.join('/etc/apache2/ssl/', service_name)
+    mkdir(path=ssl_dir)
+    name = local_unit().replace('/', '_')
+    certs = data.get('{}.processed_requests'.format(name))
+    chain = data.get('chain')
+    ca = data.get('ca')
+    if certs:
+        certs = json.loads(certs)
+        install_ca_cert(ca.encode())
+        install_certs(ssl_dir, certs, chain, user=user, group=group)
+        create_ip_cert_links(
+            ssl_dir,
+            custom_hostname_link=custom_hostname_link)
+        return True
+    return False
+
+
+def get_requests_for_local_unit(relation_name=None):
+    """Extract any certificates data targeted at this unit down relation_name.
+
+    :param relation_name: str Name of relation to check for data.
+    :returns: List of bundles of certificates.
+    :rtype: List of dicts
+    """
+    local_name = local_unit().replace('/', '_')
+    raw_certs_key = '{}.processed_requests'.format(local_name)
+    relation_name = relation_name or 'certificates'
+    bundles = []
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            data = relation_get(rid=rid, unit=unit)
+            if data.get(raw_certs_key):
+                bundles.append({
+                    'ca': data['ca'],
+                    'chain': data.get('chain'),
+                    'certs': json.loads(data[raw_certs_key])})
+    return bundles
+
+
+def get_bundle_for_cn(cn, relation_name=None):
+    """Extract certificates for the given cn.
+
+    :param cn: str Canonical Name on certificate.
+    :param relation_name: str Relation to check for certificates down.
+    :returns: Dictionary of certificate data,
+    :rtype: dict.
+    """
+    entries = get_requests_for_local_unit(relation_name)
+    cert_bundle = {}
+    for entry in entries:
+        for _cn, bundle in entry['certs'].items():
+            if _cn == cn:
+                cert_bundle = {
+                    'cert': bundle['cert'],
+                    'key': bundle['key'],
+                    'chain': entry['chain'],
+                    'ca': entry['ca']}
+                break
+        if cert_bundle:
+            break
+    return cert_bundle
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..42abccf7cb9eabc063bc8d87f016e59f4dc8f898
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/context.py
@@ -0,0 +1,3177 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import copy
+import enum
+import glob
+import hashlib
+import json
+import math
+import os
+import re
+import socket
+import time
+
+from base64 import b64decode
+from subprocess import check_call, CalledProcessError
+
+import six
+
+from charmhelpers.contrib.openstack.audits.openstack_security_guide import (
+    _config_ini as config_ini
+)
+
+from charmhelpers.fetch import (
+    apt_install,
+    filter_installed_packages,
+)
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    is_relation_made,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    related_units,
+    relation_set,
+    unit_get,
+    unit_private_ip,
+    charm_name,
+    DEBUG,
+    INFO,
+    ERROR,
+    status_set,
+    network_get_primary_address,
+    WARNING,
+)
+
+from charmhelpers.core.sysctl import create as sysctl_create
+from charmhelpers.core.strutils import bool_from_string
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+
+from charmhelpers.core.host import (
+    get_bond_master,
+    is_phy_iface,
+    list_nics,
+    get_nic_hwaddr,
+    mkdir,
+    write_file,
+    pwgen,
+    lsb_release,
+    CompareHostReleases,
+    is_container,
+)
+from charmhelpers.contrib.hahelpers.cluster import (
+    determine_apache_port,
+    determine_api_port,
+    https,
+    is_clustered,
+)
+from charmhelpers.contrib.hahelpers.apache import (
+    get_cert,
+    get_ca_cert,
+    install_ca_cert,
+)
+from charmhelpers.contrib.openstack.neutron import (
+    neutron_plugin_attribute,
+    parse_data_port_mappings,
+)
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    INTERNAL,
+    ADMIN,
+    PUBLIC,
+    ADDRESS_MAP,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_ipv4_addr,
+    get_ipv6_addr,
+    get_netmask_for_address,
+    format_ipv6_addr,
+    is_bridge_member,
+    is_ipv6_disabled,
+    get_relation_ip,
+)
+from charmhelpers.contrib.openstack.utils import (
+    config_flags_parser,
+    get_os_codename_install_source,
+    enable_memcache,
+    CompareOpenStackReleases,
+    os_release,
+)
+from charmhelpers.core.unitdata import kv
+
+try:
+    from sriov_netplan_shim import pci
+except ImportError:
+    # The use of the function and contexts that require the pci module is
+    # optional.
+    pass
+
+try:
+    import psutil
+except ImportError:
+    if six.PY2:
+        apt_install('python-psutil', fatal=True)
+    else:
+        apt_install('python3-psutil', fatal=True)
+    import psutil
+
+CA_CERT_PATH = '/usr/local/share/ca-certificates/keystone_juju_ca_cert.crt'
+ADDRESS_TYPES = ['admin', 'internal', 'public']
+HAPROXY_RUN_DIR = '/var/run/haproxy/'
+DEFAULT_OSLO_MESSAGING_DRIVER = "messagingv2"
+
+
+def ensure_packages(packages):
+    """Install but do not upgrade required plugin packages."""
+    required = filter_installed_packages(packages)
+    if required:
+        apt_install(required, fatal=True)
+
+
+def context_complete(ctxt):
+    _missing = []
+    for k, v in six.iteritems(ctxt):
+        if v is None or v == '':
+            _missing.append(k)
+
+    if _missing:
+        log('Missing required data: %s' % ' '.join(_missing), level=INFO)
+        return False
+
+    return True
+
+
+class OSContextGenerator(object):
+    """Base class for all context generators."""
+    interfaces = []
+    related = False
+    complete = False
+    missing_data = []
+
+    def __call__(self):
+        raise NotImplementedError
+
+    def context_complete(self, ctxt):
+        """Check for missing data for the required context data.
+        Set self.missing_data if it exists and return False.
+        Set self.complete if no missing data and return True.
+        """
+        # Fresh start
+        self.complete = False
+        self.missing_data = []
+        for k, v in six.iteritems(ctxt):
+            if v is None or v == '':
+                if k not in self.missing_data:
+                    self.missing_data.append(k)
+
+        if self.missing_data:
+            self.complete = False
+            log('Missing required data: %s' % ' '.join(self.missing_data),
+                level=INFO)
+        else:
+            self.complete = True
+        return self.complete
+
+    def get_related(self):
+        """Check if any of the context interfaces have relation ids.
+        Set self.related and return True if one of the interfaces
+        has relation ids.
+        """
+        # Fresh start
+        self.related = False
+        try:
+            for interface in self.interfaces:
+                if relation_ids(interface):
+                    self.related = True
+            return self.related
+        except AttributeError as e:
+            log("{} {}"
+                "".format(self, e), 'INFO')
+            return self.related
+
+
+class SharedDBContext(OSContextGenerator):
+    interfaces = ['shared-db']
+
+    def __init__(self, database=None, user=None, relation_prefix=None,
+                 ssl_dir=None, relation_id=None):
+        """Allows inspecting relation for settings prefixed with
+        relation_prefix. This is useful for parsing access for multiple
+        databases returned via the shared-db interface (eg, nova_password,
+        quantum_password)
+        """
+        self.relation_prefix = relation_prefix
+        self.database = database
+        self.user = user
+        self.ssl_dir = ssl_dir
+        self.rel_name = self.interfaces[0]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        self.user = self.user or config('database-user')
+        if None in [self.database, self.user]:
+            log("Could not generate shared_db context. Missing required charm "
+                "config options. (database name and user)", level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+
+        # NOTE(jamespage) if mysql charm provides a network upon which
+        # access to the database should be made, reconfigure relation
+        # with the service units local address and defer execution
+        access_network = relation_get('access-network')
+        if access_network is not None:
+            if self.relation_prefix is not None:
+                hostname_key = "{}_hostname".format(self.relation_prefix)
+            else:
+                hostname_key = "hostname"
+            access_hostname = get_address_in_network(
+                access_network,
+                unit_get('private-address'))
+            set_hostname = relation_get(attribute=hostname_key,
+                                        unit=local_unit())
+            if set_hostname != access_hostname:
+                relation_set(relation_settings={hostname_key: access_hostname})
+                return None  # Defer any further hook execution for now....
+
+        password_setting = 'password'
+        if self.relation_prefix:
+            password_setting = self.relation_prefix + '_password'
+
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.interfaces[0])
+
+        rel = (get_os_codename_install_source(config('openstack-origin')) or
+               'icehouse')
+        for rid in rids:
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                host = rdata.get('db_host')
+                host = format_ipv6_addr(host) or host
+                ctxt = {
+                    'database_host': host,
+                    'database': self.database,
+                    'database_user': self.user,
+                    'database_password': rdata.get(password_setting),
+                    'database_type': 'mysql+pymysql'
+                }
+                # Port is being introduced with LP Bug #1876188
+                # but it not currently required and may not be set in all
+                # cases, particularly in classic charms.
+                port = rdata.get('db_port')
+                if port:
+                    ctxt['database_port'] = port
+                if CompareOpenStackReleases(rel) < 'queens':
+                    ctxt['database_type'] = 'mysql'
+                if self.context_complete(ctxt):
+                    db_ssl(rdata, ctxt, self.ssl_dir)
+                    return ctxt
+        return {}
+
+
+class PostgresqlDBContext(OSContextGenerator):
+    interfaces = ['pgsql-db']
+
+    def __init__(self, database=None):
+        self.database = database
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        if self.database is None:
+            log('Could not generate postgresql_db context. Missing required '
+                'charm config options. (database name)', level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        for rid in relation_ids(self.interfaces[0]):
+            self.related = True
+            for unit in related_units(rid):
+                rel_host = relation_get('host', rid=rid, unit=unit)
+                rel_user = relation_get('user', rid=rid, unit=unit)
+                rel_passwd = relation_get('password', rid=rid, unit=unit)
+                ctxt = {'database_host': rel_host,
+                        'database': self.database,
+                        'database_user': rel_user,
+                        'database_password': rel_passwd,
+                        'database_type': 'postgresql'}
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+def db_ssl(rdata, ctxt, ssl_dir):
+    if 'ssl_ca' in rdata and ssl_dir:
+        ca_path = os.path.join(ssl_dir, 'db-client.ca')
+        with open(ca_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_ca']))
+
+        ctxt['database_ssl_ca'] = ca_path
+    elif 'ssl_ca' in rdata:
+        log("Charm not setup for ssl support but ssl ca found", level=INFO)
+        return ctxt
+
+    if 'ssl_cert' in rdata:
+        cert_path = os.path.join(
+            ssl_dir, 'db-client.cert')
+        if not os.path.exists(cert_path):
+            log("Waiting 1m for ssl client cert validity", level=INFO)
+            time.sleep(60)
+
+        with open(cert_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_cert']))
+
+        ctxt['database_ssl_cert'] = cert_path
+        key_path = os.path.join(ssl_dir, 'db-client.key')
+        with open(key_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_key']))
+
+        ctxt['database_ssl_key'] = key_path
+
+    return ctxt
+
+
+class IdentityServiceContext(OSContextGenerator):
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-service'):
+        self.service = service
+        self.service_user = service_user
+        self.rel_name = rel_name
+        self.interfaces = [self.rel_name]
+
+    def _setup_pki_cache(self):
+        if self.service and self.service_user:
+            # This is required for pki token signing if we don't want /tmp to
+            # be used.
+            cachedir = '/var/cache/%s' % (self.service)
+            if not os.path.isdir(cachedir):
+                log("Creating service cache dir %s" % (cachedir), level=DEBUG)
+                mkdir(path=cachedir, owner=self.service_user,
+                      group=self.service_user, perms=0o700)
+
+            return cachedir
+        return None
+
+    def _get_pkg_name(self, python_name='keystonemiddleware'):
+        """Get corresponding distro installed package for python
+        package name.
+
+        :param python_name: nameof the python package
+        :type: string
+        """
+        pkg_names = map(lambda x: x + python_name, ('python3-', 'python-'))
+
+        for pkg in pkg_names:
+            if not filter_installed_packages((pkg,)):
+                return pkg
+
+        return None
+
+    def _get_keystone_authtoken_ctxt(self, ctxt, keystonemiddleware_os_rel):
+        """Build Jinja2 context for full rendering of [keystone_authtoken]
+        section with variable names included. Re-constructed from former
+        template 'section-keystone-auth-mitaka'.
+
+        :param ctxt: Jinja2 context returned from self.__call__()
+        :type: dict
+        :param keystonemiddleware_os_rel: OpenStack release name of
+            keystonemiddleware package installed
+        """
+        c = collections.OrderedDict((('auth_type', 'password'),))
+
+        # 'www_authenticate_uri' replaced 'auth_uri' since Stein,
+        # see keystonemiddleware upstream sources for more info
+        if CompareOpenStackReleases(keystonemiddleware_os_rel) >= 'stein':
+            c.update((
+                ('www_authenticate_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+        else:
+            c.update((
+                ('auth_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+
+        c.update((
+            ('auth_url', "{}://{}:{}/v3".format(
+                ctxt.get('auth_protocol', ''),
+                ctxt.get('auth_host', ''),
+                ctxt.get('auth_port', ''))),
+            ('project_domain_name', ctxt.get('admin_domain_name', '')),
+            ('user_domain_name', ctxt.get('admin_domain_name', '')),
+            ('project_name', ctxt.get('admin_tenant_name', '')),
+            ('username', ctxt.get('admin_user', '')),
+            ('password', ctxt.get('admin_password', '')),
+            ('signing_dir', ctxt.get('signing_dir', '')),))
+
+        return c
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        keystonemiddleware_os_release = None
+        if self._get_pkg_name():
+            keystonemiddleware_os_release = os_release(self._get_pkg_name())
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                serv_host = rdata.get('service_host')
+                serv_host = format_ipv6_addr(serv_host) or serv_host
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('service_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({'service_port': rdata.get('service_port'),
+                             'service_host': serv_host,
+                             'auth_host': auth_host,
+                             'auth_port': rdata.get('auth_port'),
+                             'admin_tenant_name': rdata.get('service_tenant'),
+                             'admin_user': rdata.get('service_username'),
+                             'admin_password': rdata.get('service_password'),
+                             'service_protocol': svc_protocol,
+                             'auth_protocol': auth_protocol,
+                             'api_version': api_version})
+
+                if float(api_version) > 2:
+                    ctxt.update({
+                        'admin_domain_name': rdata.get('service_domain'),
+                        'service_project_id': rdata.get('service_tenant_id'),
+                        'service_domain_id': rdata.get('service_domain_id')})
+
+                # we keep all veriables in ctxt for compatibility and
+                # add nested dictionary for keystone_authtoken generic
+                # templating
+                if keystonemiddleware_os_release:
+                    ctxt['keystone_authtoken'] = \
+                        self._get_keystone_authtoken_ctxt(
+                            ctxt, keystonemiddleware_os_release)
+
+                if self.context_complete(ctxt):
+                    # NOTE(jamespage) this is required for >= icehouse
+                    # so a missing value just indicates keystone needs
+                    # upgrading
+                    ctxt['admin_tenant_id'] = rdata.get('service_tenant_id')
+                    ctxt['admin_domain_id'] = rdata.get('service_domain_id')
+                    return ctxt
+
+        return {}
+
+
+class IdentityCredentialsContext(IdentityServiceContext):
+    '''Context for identity-credentials interface type'''
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-credentials'):
+        super(IdentityCredentialsContext, self).__init__(service,
+                                                         service_user,
+                                                         rel_name)
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                credentials_host = rdata.get('credentials_host')
+                credentials_host = (
+                    format_ipv6_addr(credentials_host) or credentials_host
+                )
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('credentials_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({
+                    'service_port': rdata.get('credentials_port'),
+                    'service_host': credentials_host,
+                    'auth_host': auth_host,
+                    'auth_port': rdata.get('auth_port'),
+                    'admin_tenant_name': rdata.get('credentials_project'),
+                    'admin_tenant_id': rdata.get('credentials_project_id'),
+                    'admin_user': rdata.get('credentials_username'),
+                    'admin_password': rdata.get('credentials_password'),
+                    'service_protocol': svc_protocol,
+                    'auth_protocol': auth_protocol,
+                    'api_version': api_version
+                })
+
+                if float(api_version) > 2:
+                    ctxt.update({'admin_domain_name':
+                                 rdata.get('domain')})
+
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+class NovaVendorMetadataContext(OSContextGenerator):
+    """Context used for configuring nova vendor metadata on nova.conf file."""
+
+    def __init__(self, os_release_pkg, interfaces=None):
+        """Initialize the NovaVendorMetadataContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        :param interfaces: list of string values to be used as the Context's
+            relation interfaces.
+        :type interfaces: List[str]
+        """
+        self.os_release_pkg = os_release_pkg
+        if interfaces is not None:
+            self.interfaces = interfaces
+
+    def __call__(self):
+        cmp_os_release = CompareOpenStackReleases(
+            os_release(self.os_release_pkg))
+        ctxt = {'vendor_data': False}
+
+        vdata_providers = []
+        vdata = config('vendor-data')
+        vdata_url = config('vendor-data-url')
+
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we do not set anything here
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data'] = True
+                # Mitaka does not support DynamicJSON
+                # so vendordata_providers is not needed
+                if cmp_os_release > 'mitaka':
+                    vdata_providers.append('StaticJSON')
+
+        if vdata_url:
+            if cmp_os_release > 'mitaka':
+                ctxt['vendor_data_url'] = vdata_url
+                vdata_providers.append('DynamicJSON')
+            else:
+                log('Dynamic vendor data unsupported'
+                    ' for {}.'.format(cmp_os_release), level=ERROR)
+        if vdata_providers:
+            ctxt['vendordata_providers'] = ','.join(vdata_providers)
+
+        return ctxt
+
+
+class NovaVendorMetadataJSONContext(OSContextGenerator):
+    """Context used for writing nova vendor metadata json file."""
+
+    def __init__(self, os_release_pkg):
+        """Initialize the NovaVendorMetadataJSONContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        """
+        self.os_release_pkg = os_release_pkg
+
+    def __call__(self):
+        ctxt = {'vendor_data_json': '{}'}
+
+        vdata = config('vendor-data')
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we return empty.
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data_json'] = vdata
+
+        return ctxt
+
+
+class AMQPContext(OSContextGenerator):
+
+    def __init__(self, ssl_dir=None, rel_name='amqp', relation_prefix=None,
+                 relation_id=None):
+        self.ssl_dir = ssl_dir
+        self.rel_name = rel_name
+        self.relation_prefix = relation_prefix
+        self.interfaces = [rel_name]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        log('Generating template context for amqp', level=DEBUG)
+        conf = config()
+        if self.relation_prefix:
+            user_setting = '%s-rabbit-user' % (self.relation_prefix)
+            vhost_setting = '%s-rabbit-vhost' % (self.relation_prefix)
+        else:
+            user_setting = 'rabbit-user'
+            vhost_setting = 'rabbit-vhost'
+
+        try:
+            username = conf[user_setting]
+            vhost = conf[vhost_setting]
+        except KeyError as e:
+            log('Could not generate shared_db context. Missing required charm '
+                'config options: %s.' % e, level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.rel_name)
+        for rid in rids:
+            ha_vip_only = False
+            self.related = True
+            transport_hosts = None
+            rabbitmq_port = '5672'
+            for unit in related_units(rid):
+                if relation_get('clustered', rid=rid, unit=unit):
+                    ctxt['clustered'] = True
+                    vip = relation_get('vip', rid=rid, unit=unit)
+                    vip = format_ipv6_addr(vip) or vip
+                    ctxt['rabbitmq_host'] = vip
+                    transport_hosts = [vip]
+                else:
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    host = format_ipv6_addr(host) or host
+                    ctxt['rabbitmq_host'] = host
+                    transport_hosts = [host]
+
+                ctxt.update({
+                    'rabbitmq_user': username,
+                    'rabbitmq_password': relation_get('password', rid=rid,
+                                                      unit=unit),
+                    'rabbitmq_virtual_host': vhost,
+                })
+
+                ssl_port = relation_get('ssl_port', rid=rid, unit=unit)
+                if ssl_port:
+                    ctxt['rabbit_ssl_port'] = ssl_port
+                    rabbitmq_port = ssl_port
+
+                ssl_ca = relation_get('ssl_ca', rid=rid, unit=unit)
+                if ssl_ca:
+                    ctxt['rabbit_ssl_ca'] = ssl_ca
+
+                if relation_get('ha_queues', rid=rid, unit=unit) is not None:
+                    ctxt['rabbitmq_ha_queues'] = True
+
+                ha_vip_only = relation_get('ha-vip-only',
+                                           rid=rid, unit=unit) is not None
+
+                if self.context_complete(ctxt):
+                    if 'rabbit_ssl_ca' in ctxt:
+                        if not self.ssl_dir:
+                            log("Charm not setup for ssl support but ssl ca "
+                                "found", level=INFO)
+                            break
+
+                        ca_path = os.path.join(
+                            self.ssl_dir, 'rabbit-client-ca.pem')
+                        with open(ca_path, 'wb') as fh:
+                            fh.write(b64decode(ctxt['rabbit_ssl_ca']))
+                            ctxt['rabbit_ssl_ca'] = ca_path
+
+                    # Sufficient information found = break out!
+                    break
+
+            # Used for active/active rabbitmq >= grizzly
+            if (('clustered' not in ctxt or ha_vip_only) and
+                    len(related_units(rid)) > 1):
+                rabbitmq_hosts = []
+                for unit in related_units(rid):
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    if not relation_get('password', rid=rid, unit=unit):
+                        log(
+                            ("Skipping {} password not sent which indicates "
+                             "unit is not ready.".format(host)),
+                            level=DEBUG)
+                        continue
+                    host = format_ipv6_addr(host) or host
+                    rabbitmq_hosts.append(host)
+
+                rabbitmq_hosts = sorted(rabbitmq_hosts)
+                ctxt['rabbitmq_hosts'] = ','.join(rabbitmq_hosts)
+                transport_hosts = rabbitmq_hosts
+
+            if transport_hosts:
+                transport_url_hosts = ','.join([
+                    "{}:{}@{}:{}".format(ctxt['rabbitmq_user'],
+                                         ctxt['rabbitmq_password'],
+                                         host_,
+                                         rabbitmq_port)
+                    for host_ in transport_hosts])
+                ctxt['transport_url'] = "rabbit://{}/{}".format(
+                    transport_url_hosts, vhost)
+
+        oslo_messaging_flags = conf.get('oslo-messaging-flags', None)
+        if oslo_messaging_flags:
+            ctxt['oslo_messaging_flags'] = config_flags_parser(
+                oslo_messaging_flags)
+
+        oslo_messaging_driver = conf.get(
+            'oslo-messaging-driver', DEFAULT_OSLO_MESSAGING_DRIVER)
+        if oslo_messaging_driver:
+            ctxt['oslo_messaging_driver'] = oslo_messaging_driver
+
+        notification_format = conf.get('notification-format', None)
+        if notification_format:
+            ctxt['notification_format'] = notification_format
+
+        notification_topics = conf.get('notification-topics', None)
+        if notification_topics:
+            ctxt['notification_topics'] = notification_topics
+
+        send_notifications_to_logs = conf.get('send-notifications-to-logs', None)
+        if send_notifications_to_logs:
+            ctxt['send_notifications_to_logs'] = send_notifications_to_logs
+
+        if not self.complete:
+            return {}
+
+        return ctxt
+
+
+class CephContext(OSContextGenerator):
+    """Generates context for /etc/ceph/ceph.conf templates."""
+    interfaces = ['ceph']
+
+    def __call__(self):
+        if not relation_ids('ceph'):
+            return {}
+
+        log('Generating template context for ceph', level=DEBUG)
+        mon_hosts = []
+        ctxt = {
+            'use_syslog': str(config('use-syslog')).lower()
+        }
+        for rid in relation_ids('ceph'):
+            for unit in related_units(rid):
+                if not ctxt.get('auth'):
+                    ctxt['auth'] = relation_get('auth', rid=rid, unit=unit)
+                if not ctxt.get('key'):
+                    ctxt['key'] = relation_get('key', rid=rid, unit=unit)
+                if not ctxt.get('rbd_features'):
+                    default_features = relation_get('rbd-features', rid=rid, unit=unit)
+                    if default_features is not None:
+                        ctxt['rbd_features'] = default_features
+
+                ceph_addrs = relation_get('ceph-public-address', rid=rid,
+                                          unit=unit)
+                if ceph_addrs:
+                    for addr in ceph_addrs.split(' '):
+                        mon_hosts.append(format_ipv6_addr(addr) or addr)
+                else:
+                    priv_addr = relation_get('private-address', rid=rid,
+                                             unit=unit)
+                    mon_hosts.append(format_ipv6_addr(priv_addr) or priv_addr)
+
+        ctxt['mon_hosts'] = ' '.join(sorted(mon_hosts))
+
+        if not os.path.isdir('/etc/ceph'):
+            os.mkdir('/etc/ceph')
+
+        if not self.context_complete(ctxt):
+            return {}
+
+        ensure_packages(['ceph-common'])
+        return ctxt
+
+    def context_complete(self, ctxt):
+        """Overridden here to ensure the context is actually complete.
+
+        We set `key` and `auth` to None here, by default, to ensure
+        that the context will always evaluate to incomplete until the
+        Ceph relation has actually sent these details; otherwise,
+        there is a potential race condition between the relation
+        appearing and the first unit actually setting this data on the
+        relation.
+
+        :param ctxt: The current context members
+        :type ctxt: Dict[str, ANY]
+        :returns: True if the context is complete
+        :rtype: bool
+        """
+        if 'auth' not in ctxt or 'key' not in ctxt:
+            return False
+        return super(CephContext, self).context_complete(ctxt)
+
+
+class HAProxyContext(OSContextGenerator):
+    """Provides half a context for the haproxy template, which describes
+    all peers to be included in the cluster.  Each charm needs to include
+    its own context generator that describes the port mapping.
+
+    :side effect: mkdir is called on HAPROXY_RUN_DIR
+    """
+    interfaces = ['cluster']
+
+    def __init__(self, singlenode_mode=False,
+                 address_types=ADDRESS_TYPES):
+        self.address_types = address_types
+        self.singlenode_mode = singlenode_mode
+
+    def __call__(self):
+        if not os.path.isdir(HAPROXY_RUN_DIR):
+            mkdir(path=HAPROXY_RUN_DIR)
+        if not relation_ids('cluster') and not self.singlenode_mode:
+            return {}
+
+        l_unit = local_unit().replace('/', '-')
+        cluster_hosts = collections.OrderedDict()
+
+        # NOTE(jamespage): build out map of configured network endpoints
+        # and associated backends
+        for addr_type in self.address_types:
+            cfg_opt = 'os-{}-network'.format(addr_type)
+            # NOTE(thedac) For some reason the ADDRESS_MAP uses 'int' rather
+            # than 'internal'
+            if addr_type == 'internal':
+                _addr_map_type = INTERNAL
+            else:
+                _addr_map_type = addr_type
+            # Network spaces aware
+            laddr = get_relation_ip(ADDRESS_MAP[_addr_map_type]['binding'],
+                                    config(cfg_opt))
+            if laddr:
+                netmask = get_netmask_for_address(laddr)
+                cluster_hosts[laddr] = {
+                    'network': "{}/{}".format(laddr,
+                                              netmask),
+                    'backends': collections.OrderedDict([(l_unit,
+                                                          laddr)])
+                }
+                for rid in relation_ids('cluster'):
+                    for unit in sorted(related_units(rid)):
+                        # API Charms will need to set {addr_type}-address with
+                        # get_relation_ip(addr_type)
+                        _laddr = relation_get('{}-address'.format(addr_type),
+                                              rid=rid, unit=unit)
+                        if _laddr:
+                            _unit = unit.replace('/', '-')
+                            cluster_hosts[laddr]['backends'][_unit] = _laddr
+
+        # NOTE(jamespage) add backend based on get_relation_ip - this
+        # will either be the only backend or the fallback if no acls
+        # match in the frontend
+        # Network spaces aware
+        addr = get_relation_ip('cluster')
+        cluster_hosts[addr] = {}
+        netmask = get_netmask_for_address(addr)
+        cluster_hosts[addr] = {
+            'network': "{}/{}".format(addr, netmask),
+            'backends': collections.OrderedDict([(l_unit,
+                                                  addr)])
+        }
+        for rid in relation_ids('cluster'):
+            for unit in sorted(related_units(rid)):
+                # API Charms will need to set their private-address with
+                # get_relation_ip('cluster')
+                _laddr = relation_get('private-address',
+                                      rid=rid, unit=unit)
+                if _laddr:
+                    _unit = unit.replace('/', '-')
+                    cluster_hosts[addr]['backends'][_unit] = _laddr
+
+        ctxt = {
+            'frontends': cluster_hosts,
+            'default_backend': addr
+        }
+
+        if config('haproxy-server-timeout'):
+            ctxt['haproxy_server_timeout'] = config('haproxy-server-timeout')
+
+        if config('haproxy-client-timeout'):
+            ctxt['haproxy_client_timeout'] = config('haproxy-client-timeout')
+
+        if config('haproxy-queue-timeout'):
+            ctxt['haproxy_queue_timeout'] = config('haproxy-queue-timeout')
+
+        if config('haproxy-connect-timeout'):
+            ctxt['haproxy_connect_timeout'] = config('haproxy-connect-timeout')
+
+        if config('prefer-ipv6'):
+            ctxt['local_host'] = 'ip6-localhost'
+            ctxt['haproxy_host'] = '::'
+        else:
+            ctxt['local_host'] = '127.0.0.1'
+            ctxt['haproxy_host'] = '0.0.0.0'
+
+        ctxt['ipv6_enabled'] = not is_ipv6_disabled()
+
+        ctxt['stat_port'] = '8888'
+
+        db = kv()
+        ctxt['stat_password'] = db.get('stat-password')
+        if not ctxt['stat_password']:
+            ctxt['stat_password'] = db.set('stat-password',
+                                           pwgen(32))
+            db.flush()
+
+        for frontend in cluster_hosts:
+            if (len(cluster_hosts[frontend]['backends']) > 1 or
+                    self.singlenode_mode):
+                # Enable haproxy when we have enough peers.
+                log('Ensuring haproxy enabled in /etc/default/haproxy.',
+                    level=DEBUG)
+                with open('/etc/default/haproxy', 'w') as out:
+                    out.write('ENABLED=1\n')
+
+                return ctxt
+
+        log('HAProxy context is incomplete, this unit has no peers.',
+            level=INFO)
+        return {}
+
+
+class ImageServiceContext(OSContextGenerator):
+    interfaces = ['image-service']
+
+    def __call__(self):
+        """Obtains the glance API server from the image-service relation.
+        Useful in nova and cinder (currently).
+        """
+        log('Generating template context for image-service.', level=DEBUG)
+        rids = relation_ids('image-service')
+        if not rids:
+            return {}
+
+        for rid in rids:
+            for unit in related_units(rid):
+                api_server = relation_get('glance-api-server',
+                                          rid=rid, unit=unit)
+                if api_server:
+                    return {'glance_api_servers': api_server}
+
+        log("ImageService context is incomplete. Missing required relation "
+            "data.", level=INFO)
+        return {}
+
+
+class ApacheSSLContext(OSContextGenerator):
+    """Generates a context for an apache vhost configuration that configures
+    HTTPS reverse proxying for one or many endpoints.  Generated context
+    looks something like::
+
+        {
+            'namespace': 'cinder',
+            'private_address': 'iscsi.mycinderhost.com',
+            'endpoints': [(8776, 8766), (8777, 8767)]
+        }
+
+    The endpoints list consists of a tuples mapping external ports
+    to internal ports.
+    """
+    interfaces = ['https']
+
+    # charms should inherit this context and set external ports
+    # and service namespace accordingly.
+    external_ports = []
+    service_namespace = None
+    user = group = 'root'
+
+    def enable_modules(self):
+        cmd = ['a2enmod', 'ssl', 'proxy', 'proxy_http', 'headers']
+        check_call(cmd)
+
+    def configure_cert(self, cn=None):
+        ssl_dir = os.path.join('/etc/apache2/ssl/', self.service_namespace)
+        mkdir(path=ssl_dir)
+        cert, key = get_cert(cn)
+        if cert and key:
+            if cn:
+                cert_filename = 'cert_{}'.format(cn)
+                key_filename = 'key_{}'.format(cn)
+            else:
+                cert_filename = 'cert'
+                key_filename = 'key'
+
+            write_file(path=os.path.join(ssl_dir, cert_filename),
+                       content=b64decode(cert), owner=self.user,
+                       group=self.group, perms=0o640)
+            write_file(path=os.path.join(ssl_dir, key_filename),
+                       content=b64decode(key), owner=self.user,
+                       group=self.group, perms=0o640)
+
+    def configure_ca(self):
+        ca_cert = get_ca_cert()
+        if ca_cert:
+            install_ca_cert(b64decode(ca_cert))
+
+    def canonical_names(self):
+        """Figure out which canonical names clients will access this service.
+        """
+        cns = []
+        for r_id in relation_ids('identity-service'):
+            for unit in related_units(r_id):
+                rdata = relation_get(rid=r_id, unit=unit)
+                for k in rdata:
+                    if k.startswith('ssl_key_'):
+                        cns.append(k.lstrip('ssl_key_'))
+
+        return sorted(list(set(cns)))
+
+    def get_network_addresses(self):
+        """For each network configured, return corresponding address and
+           hostnamr or vip (if available).
+
+        Returns a list of tuples of the form:
+
+            [(address_in_net_a, hostname_in_net_a),
+             (address_in_net_b, hostname_in_net_b),
+             ...]
+
+            or, if no hostnames(s) available:
+
+            [(address_in_net_a, vip_in_net_a),
+             (address_in_net_b, vip_in_net_b),
+             ...]
+
+            or, if no vip(s) available:
+
+            [(address_in_net_a, address_in_net_a),
+             (address_in_net_b, address_in_net_b),
+             ...]
+        """
+        addresses = []
+        for net_type in [INTERNAL, ADMIN, PUBLIC]:
+            net_config = config(ADDRESS_MAP[net_type]['config'])
+            # NOTE(jamespage): Fallback must always be private address
+            #                  as this is used to bind services on the
+            #                  local unit.
+            fallback = unit_get("private-address")
+            if net_config:
+                addr = get_address_in_network(net_config,
+                                              fallback)
+            else:
+                try:
+                    addr = network_get_primary_address(
+                        ADDRESS_MAP[net_type]['binding']
+                    )
+                except (NotImplementedError, NoNetworkBinding):
+                    addr = fallback
+
+            endpoint = resolve_address(net_type)
+            addresses.append((addr, endpoint))
+
+        return sorted(set(addresses))
+
+    def __call__(self):
+        if isinstance(self.external_ports, six.string_types):
+            self.external_ports = [self.external_ports]
+
+        if not self.external_ports or not https():
+            return {}
+
+        use_keystone_ca = True
+        for rid in relation_ids('certificates'):
+            if related_units(rid):
+                use_keystone_ca = False
+
+        if use_keystone_ca:
+            self.configure_ca()
+
+        self.enable_modules()
+
+        ctxt = {'namespace': self.service_namespace,
+                'endpoints': [],
+                'ext_ports': []}
+
+        if use_keystone_ca:
+            cns = self.canonical_names()
+            if cns:
+                for cn in cns:
+                    self.configure_cert(cn)
+            else:
+                # Expect cert/key provided in config (currently assumed that ca
+                # uses ip for cn)
+                for net_type in (INTERNAL, ADMIN, PUBLIC):
+                    cn = resolve_address(endpoint_type=net_type)
+                    self.configure_cert(cn)
+
+        addresses = self.get_network_addresses()
+        for address, endpoint in addresses:
+            for api_port in self.external_ports:
+                ext_port = determine_apache_port(api_port,
+                                                 singlenode_mode=True)
+                int_port = determine_api_port(api_port, singlenode_mode=True)
+                portmap = (address, endpoint, int(ext_port), int(int_port))
+                ctxt['endpoints'].append(portmap)
+                ctxt['ext_ports'].append(int(ext_port))
+
+        ctxt['ext_ports'] = sorted(list(set(ctxt['ext_ports'])))
+        return ctxt
+
+
+class NeutronContext(OSContextGenerator):
+    interfaces = []
+
+    @property
+    def plugin(self):
+        return None
+
+    @property
+    def network_manager(self):
+        return None
+
+    @property
+    def packages(self):
+        return neutron_plugin_attribute(self.plugin, 'packages',
+                                        self.network_manager)
+
+    @property
+    def neutron_security_groups(self):
+        return None
+
+    def _ensure_packages(self):
+        for pkgs in self.packages:
+            ensure_packages(pkgs)
+
+    def ovs_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'ovs',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return ovs_ctxt
+
+    def nuage_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nuage_ctxt = {'core_plugin': driver,
+                      'neutron_plugin': 'vsp',
+                      'neutron_security_groups': self.neutron_security_groups,
+                      'local_ip': unit_private_ip(),
+                      'config': config}
+
+        return nuage_ctxt
+
+    def nvp_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nvp_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'nvp',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return nvp_ctxt
+
+    def n1kv_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        n1kv_config = neutron_plugin_attribute(self.plugin, 'config',
+                                               self.network_manager)
+        n1kv_user_config_flags = config('n1kv-config-flags')
+        restrict_policy_profiles = config('n1kv-restrict-policy-profiles')
+        n1kv_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'n1kv',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': n1kv_config,
+                     'vsm_ip': config('n1kv-vsm-ip'),
+                     'vsm_username': config('n1kv-vsm-username'),
+                     'vsm_password': config('n1kv-vsm-password'),
+                     'restrict_policy_profiles': restrict_policy_profiles}
+
+        if n1kv_user_config_flags:
+            flags = config_flags_parser(n1kv_user_config_flags)
+            n1kv_ctxt['user_config_flags'] = flags
+
+        return n1kv_ctxt
+
+    def calico_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        calico_ctxt = {'core_plugin': driver,
+                       'neutron_plugin': 'Calico',
+                       'neutron_security_groups': self.neutron_security_groups,
+                       'local_ip': unit_private_ip(),
+                       'config': config}
+
+        return calico_ctxt
+
+    def neutron_ctxt(self):
+        if https():
+            proto = 'https'
+        else:
+            proto = 'http'
+
+        if is_clustered():
+            host = config('vip')
+        else:
+            host = unit_get('private-address')
+
+        ctxt = {'network_manager': self.network_manager,
+                'neutron_url': '%s://%s:%s' % (proto, host, '9696')}
+        return ctxt
+
+    def pg_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'plumgrid',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+        return ovs_ctxt
+
+    def midonet_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        midonet_config = neutron_plugin_attribute(self.plugin, 'config',
+                                                  self.network_manager)
+        mido_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'midonet',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': midonet_config}
+
+        return mido_ctxt
+
+    def __call__(self):
+        if self.network_manager not in ['quantum', 'neutron']:
+            return {}
+
+        if not self.plugin:
+            return {}
+
+        ctxt = self.neutron_ctxt()
+
+        if self.plugin == 'ovs':
+            ctxt.update(self.ovs_ctxt())
+        elif self.plugin in ['nvp', 'nsx']:
+            ctxt.update(self.nvp_ctxt())
+        elif self.plugin == 'n1kv':
+            ctxt.update(self.n1kv_ctxt())
+        elif self.plugin == 'Calico':
+            ctxt.update(self.calico_ctxt())
+        elif self.plugin == 'vsp':
+            ctxt.update(self.nuage_ctxt())
+        elif self.plugin == 'plumgrid':
+            ctxt.update(self.pg_ctxt())
+        elif self.plugin == 'midonet':
+            ctxt.update(self.midonet_ctxt())
+
+        alchemy_flags = config('neutron-alchemy-flags')
+        if alchemy_flags:
+            flags = config_flags_parser(alchemy_flags)
+            ctxt['neutron_alchemy_flags'] = flags
+
+        return ctxt
+
+
+class NeutronPortContext(OSContextGenerator):
+
+    def resolve_ports(self, ports):
+        """Resolve NICs not yet bound to bridge(s)
+
+        If hwaddress provided then returns resolved hwaddress otherwise NIC.
+        """
+        if not ports:
+            return None
+
+        hwaddr_to_nic = {}
+        hwaddr_to_ip = {}
+        extant_nics = list_nics()
+
+        for nic in extant_nics:
+            # Ignore virtual interfaces (bond masters will be identified from
+            # their slaves)
+            if not is_phy_iface(nic):
+                continue
+
+            _nic = get_bond_master(nic)
+            if _nic:
+                log("Replacing iface '%s' with bond master '%s'" % (nic, _nic),
+                    level=DEBUG)
+                nic = _nic
+
+            hwaddr = get_nic_hwaddr(nic)
+            hwaddr_to_nic[hwaddr] = nic
+            addresses = get_ipv4_addr(nic, fatal=False)
+            addresses += get_ipv6_addr(iface=nic, fatal=False)
+            hwaddr_to_ip[hwaddr] = addresses
+
+        resolved = []
+        mac_regex = re.compile(r'([0-9A-F]{2}[:-]){5}([0-9A-F]{2})', re.I)
+        for entry in ports:
+            if re.match(mac_regex, entry):
+                # NIC is in known NICs and does NOT hace an IP address
+                if entry in hwaddr_to_nic and not hwaddr_to_ip[entry]:
+                    # If the nic is part of a bridge then don't use it
+                    if is_bridge_member(hwaddr_to_nic[entry]):
+                        continue
+
+                    # Entry is a MAC address for a valid interface that doesn't
+                    # have an IP address assigned yet.
+                    resolved.append(hwaddr_to_nic[entry])
+            elif entry in extant_nics:
+                # If the passed entry is not a MAC address and the interface
+                # exists, assume it's a valid interface, and that the user put
+                # it there on purpose (we can trust it to be the real external
+                # network).
+                resolved.append(entry)
+
+        # Ensure no duplicates
+        return list(set(resolved))
+
+
+class OSConfigFlagContext(OSContextGenerator):
+    """Provides support for user-defined config flags.
+
+    Users can define a comma-seperated list of key=value pairs
+    in the charm configuration and apply them at any point in
+    any file by using a template flag.
+
+    Sometimes users might want config flags inserted within a
+    specific section so this class allows users to specify the
+    template flag name, allowing for multiple template flags
+    (sections) within the same context.
+
+    NOTE: the value of config-flags may be a comma-separated list of
+          key=value pairs and some Openstack config files support
+          comma-separated lists as values.
+    """
+
+    def __init__(self, charm_flag='config-flags',
+                 template_flag='user_config_flags'):
+        """
+        :param charm_flag: config flags in charm configuration.
+        :param template_flag: insert point for user-defined flags in template
+                              file.
+        """
+        super(OSConfigFlagContext, self).__init__()
+        self._charm_flag = charm_flag
+        self._template_flag = template_flag
+
+    def __call__(self):
+        config_flags = config(self._charm_flag)
+        if not config_flags:
+            return {}
+
+        return {self._template_flag:
+                config_flags_parser(config_flags)}
+
+
+class LibvirtConfigFlagsContext(OSContextGenerator):
+    """
+    This context provides support for extending
+    the libvirt section through user-defined flags.
+    """
+    def __call__(self):
+        ctxt = {}
+        libvirt_flags = config('libvirt-flags')
+        if libvirt_flags:
+            ctxt['libvirt_flags'] = config_flags_parser(
+                libvirt_flags)
+        return ctxt
+
+
+class SubordinateConfigContext(OSContextGenerator):
+
+    """
+    Responsible for inspecting relations to subordinates that
+    may be exporting required config via a json blob.
+
+    The subordinate interface allows subordinates to export their
+    configuration requirements to the principle for multiple config
+    files and multiple services.  Ie, a subordinate that has interfaces
+    to both glance and nova may export to following yaml blob as json::
+
+        glance:
+            /etc/glance/glance-api.conf:
+                sections:
+                    DEFAULT:
+                        - [key1, value1]
+            /etc/glance/glance-registry.conf:
+                    MYSECTION:
+                        - [key2, value2]
+        nova:
+            /etc/nova/nova.conf:
+                sections:
+                    DEFAULT:
+                        - [key3, value3]
+
+
+    It is then up to the principle charms to subscribe this context to
+    the service+config file it is interestd in.  Configuration data will
+    be available in the template context, in glance's case, as::
+
+        ctxt = {
+            ... other context ...
+            'subordinate_configuration': {
+                'DEFAULT': {
+                    'key1': 'value1',
+                },
+                'MYSECTION': {
+                    'key2': 'value2',
+                },
+            }
+        }
+    """
+
+    def __init__(self, service, config_file, interface):
+        """
+        :param service     : Service name key to query in any subordinate
+                             data found
+        :param config_file : Service's config file to query sections
+        :param interface   : Subordinate interface to inspect
+        """
+        self.config_file = config_file
+        if isinstance(service, list):
+            self.services = service
+        else:
+            self.services = [service]
+        if isinstance(interface, list):
+            self.interfaces = interface
+        else:
+            self.interfaces = [interface]
+
+    def __call__(self):
+        ctxt = {'sections': {}}
+        rids = []
+        for interface in self.interfaces:
+            rids.extend(relation_ids(interface))
+        for rid in rids:
+            for unit in related_units(rid):
+                sub_config = relation_get('subordinate_configuration',
+                                          rid=rid, unit=unit)
+                if sub_config and sub_config != '':
+                    try:
+                        sub_config = json.loads(sub_config)
+                    except Exception:
+                        log('Could not parse JSON from '
+                            'subordinate_configuration setting from %s'
+                            % rid, level=ERROR)
+                        continue
+
+                    for service in self.services:
+                        if service not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s service'
+                                % (rid, service), level=INFO)
+                            continue
+
+                        sub_config = sub_config[service]
+                        if self.config_file not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s'
+                                % (rid, self.config_file), level=INFO)
+                            continue
+
+                        sub_config = sub_config[self.config_file]
+                        for k, v in six.iteritems(sub_config):
+                            if k == 'sections':
+                                for section, config_list in six.iteritems(v):
+                                    log("adding section '%s'" % (section),
+                                        level=DEBUG)
+                                    if ctxt[k].get(section):
+                                        ctxt[k][section].extend(config_list)
+                                    else:
+                                        ctxt[k][section] = config_list
+                            else:
+                                ctxt[k] = v
+        log("%d section(s) found" % (len(ctxt['sections'])), level=DEBUG)
+        return ctxt
+
+
+class LogLevelContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['debug'] = \
+            False if config('debug') is None else config('debug')
+        ctxt['verbose'] = \
+            False if config('verbose') is None else config('verbose')
+
+        return ctxt
+
+
+class SyslogContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {'use_syslog': config('use-syslog')}
+        return ctxt
+
+
+class BindHostContext(OSContextGenerator):
+
+    def __call__(self):
+        if config('prefer-ipv6'):
+            return {'bind_host': '::'}
+        else:
+            return {'bind_host': '0.0.0.0'}
+
+
+MAX_DEFAULT_WORKERS = 4
+DEFAULT_MULTIPLIER = 2
+
+
+def _calculate_workers():
+    '''
+    Determine the number of worker processes based on the CPU
+    count of the unit containing the application.
+
+    Workers will be limited to MAX_DEFAULT_WORKERS in
+    container environments where no worker-multipler configuration
+    option been set.
+
+    @returns int: number of worker processes to use
+    '''
+    multiplier = config('worker-multiplier') or DEFAULT_MULTIPLIER
+    count = int(_num_cpus() * multiplier)
+    if multiplier > 0 and count == 0:
+        count = 1
+
+    if config('worker-multiplier') is None and is_container():
+        # NOTE(jamespage): Limit unconfigured worker-multiplier
+        #                  to MAX_DEFAULT_WORKERS to avoid insane
+        #                  worker configuration in LXD containers
+        #                  on large servers
+        # Reference: https://pad.lv/1665270
+        count = min(count, MAX_DEFAULT_WORKERS)
+
+    return count
+
+
+def _num_cpus():
+    '''
+    Compatibility wrapper for calculating the number of CPU's
+    a unit has.
+
+    @returns: int: number of CPU cores detected
+    '''
+    try:
+        return psutil.cpu_count()
+    except AttributeError:
+        return psutil.NUM_CPUS
+
+
+class WorkerConfigContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {"workers": _calculate_workers()}
+        return ctxt
+
+
+class WSGIWorkerConfigContext(WorkerConfigContext):
+
+    def __init__(self, name=None, script=None, admin_script=None,
+                 public_script=None, user=None, group=None,
+                 process_weight=1.00,
+                 admin_process_weight=0.25, public_process_weight=0.75):
+        self.service_name = name
+        self.user = user or name
+        self.group = group or name
+        self.script = script
+        self.admin_script = admin_script
+        self.public_script = public_script
+        self.process_weight = process_weight
+        self.admin_process_weight = admin_process_weight
+        self.public_process_weight = public_process_weight
+
+    def __call__(self):
+        total_processes = _calculate_workers()
+        ctxt = {
+            "service_name": self.service_name,
+            "user": self.user,
+            "group": self.group,
+            "script": self.script,
+            "admin_script": self.admin_script,
+            "public_script": self.public_script,
+            "processes": int(math.ceil(self.process_weight * total_processes)),
+            "admin_processes": int(math.ceil(self.admin_process_weight *
+                                             total_processes)),
+            "public_processes": int(math.ceil(self.public_process_weight *
+                                              total_processes)),
+            "threads": 1,
+        }
+        return ctxt
+
+
+class ZeroMQContext(OSContextGenerator):
+    interfaces = ['zeromq-configuration']
+
+    def __call__(self):
+        ctxt = {}
+        if is_relation_made('zeromq-configuration', 'host'):
+            for rid in relation_ids('zeromq-configuration'):
+                for unit in related_units(rid):
+                    ctxt['zmq_nonce'] = relation_get('nonce', unit, rid)
+                    ctxt['zmq_host'] = relation_get('host', unit, rid)
+                    ctxt['zmq_redis_address'] = relation_get(
+                        'zmq_redis_address', unit, rid)
+
+        return ctxt
+
+
+class NotificationDriverContext(OSContextGenerator):
+
+    def __init__(self, zmq_relation='zeromq-configuration',
+                 amqp_relation='amqp'):
+        """
+        :param zmq_relation: Name of Zeromq relation to check
+        """
+        self.zmq_relation = zmq_relation
+        self.amqp_relation = amqp_relation
+
+    def __call__(self):
+        ctxt = {'notifications': 'False'}
+        if is_relation_made(self.amqp_relation):
+            ctxt['notifications'] = "True"
+
+        return ctxt
+
+
+class SysctlContext(OSContextGenerator):
+    """This context check if the 'sysctl' option exists on configuration
+    then creates a file with the loaded contents"""
+    def __call__(self):
+        sysctl_dict = config('sysctl')
+        if sysctl_dict:
+            sysctl_create(sysctl_dict,
+                          '/etc/sysctl.d/50-{0}.conf'.format(charm_name()))
+        return {'sysctl': sysctl_dict}
+
+
+class NeutronAPIContext(OSContextGenerator):
+    '''
+    Inspects current neutron-plugin-api relation for neutron settings. Return
+    defaults if it is not present.
+    '''
+    interfaces = ['neutron-plugin-api']
+
+    def __call__(self):
+        self.neutron_defaults = {
+            'l2_population': {
+                'rel_key': 'l2-population',
+                'default': False,
+            },
+            'overlay_network_type': {
+                'rel_key': 'overlay-network-type',
+                'default': 'gre',
+            },
+            'neutron_security_groups': {
+                'rel_key': 'neutron-security-groups',
+                'default': False,
+            },
+            'network_device_mtu': {
+                'rel_key': 'network-device-mtu',
+                'default': None,
+            },
+            'enable_dvr': {
+                'rel_key': 'enable-dvr',
+                'default': False,
+            },
+            'enable_l3ha': {
+                'rel_key': 'enable-l3ha',
+                'default': False,
+            },
+            'dns_domain': {
+                'rel_key': 'dns-domain',
+                'default': None,
+            },
+            'polling_interval': {
+                'rel_key': 'polling-interval',
+                'default': 2,
+            },
+            'rpc_response_timeout': {
+                'rel_key': 'rpc-response-timeout',
+                'default': 60,
+            },
+            'report_interval': {
+                'rel_key': 'report-interval',
+                'default': 30,
+            },
+            'enable_qos': {
+                'rel_key': 'enable-qos',
+                'default': False,
+            },
+            'enable_nsg_logging': {
+                'rel_key': 'enable-nsg-logging',
+                'default': False,
+            },
+            'enable_nfg_logging': {
+                'rel_key': 'enable-nfg-logging',
+                'default': False,
+            },
+            'enable_port_forwarding': {
+                'rel_key': 'enable-port-forwarding',
+                'default': False,
+            },
+            'global_physnet_mtu': {
+                'rel_key': 'global-physnet-mtu',
+                'default': 1500,
+            },
+            'physical_network_mtus': {
+                'rel_key': 'physical-network-mtus',
+                'default': None,
+            },
+        }
+        ctxt = self.get_neutron_options({})
+        for rid in relation_ids('neutron-plugin-api'):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                # The l2-population key is used by the context as a way of
+                # checking if the api service on the other end is sending data
+                # in a recent format.
+                if 'l2-population' in rdata:
+                    ctxt.update(self.get_neutron_options(rdata))
+
+        extension_drivers = []
+
+        if ctxt['enable_qos']:
+            extension_drivers.append('qos')
+
+        if ctxt['enable_nsg_logging']:
+            extension_drivers.append('log')
+
+        ctxt['extension_drivers'] = ','.join(extension_drivers)
+
+        l3_extension_plugins = []
+
+        if ctxt['enable_port_forwarding']:
+            l3_extension_plugins.append('port_forwarding')
+
+        ctxt['l3_extension_plugins'] = l3_extension_plugins
+
+        return ctxt
+
+    def get_neutron_options(self, rdata):
+        settings = {}
+        for nkey in self.neutron_defaults.keys():
+            defv = self.neutron_defaults[nkey]['default']
+            rkey = self.neutron_defaults[nkey]['rel_key']
+            if rkey in rdata.keys():
+                if type(defv) is bool:
+                    settings[nkey] = bool_from_string(rdata[rkey])
+                else:
+                    settings[nkey] = rdata[rkey]
+            else:
+                settings[nkey] = defv
+        return settings
+
+
+class ExternalPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        ports = config('ext-port')
+        if ports:
+            ports = [p.strip() for p in ports.split()]
+            ports = self.resolve_ports(ports)
+            if ports:
+                ctxt = {"ext_port": ports[0]}
+                napi_settings = NeutronAPIContext()()
+                mtu = napi_settings.get('network_device_mtu')
+                if mtu:
+                    ctxt['ext_port_mtu'] = mtu
+
+        return ctxt
+
+
+class DataPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ports = config('data-port')
+        if ports:
+            # Map of {bridge:port/mac}
+            portmap = parse_data_port_mappings(ports)
+            ports = portmap.keys()
+            # Resolve provided ports or mac addresses and filter out those
+            # already attached to a bridge.
+            resolved = self.resolve_ports(ports)
+            # Rebuild port index using resolved and filtered ports.
+            normalized = {get_nic_hwaddr(port): port for port in resolved
+                          if port not in ports}
+            normalized.update({port: port for port in resolved
+                               if port in ports})
+            if resolved:
+                return {normalized[port]: bridge for port, bridge in
+                        six.iteritems(portmap) if port in normalized.keys()}
+
+        return None
+
+
+class PhyNICMTUContext(DataPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        mappings = super(PhyNICMTUContext, self).__call__()
+        if mappings and mappings.keys():
+            ports = sorted(mappings.keys())
+            napi_settings = NeutronAPIContext()()
+            mtu = napi_settings.get('network_device_mtu')
+            all_ports = set()
+            # If any of ports is a vlan device, its underlying device must have
+            # mtu applied first.
+            for port in ports:
+                for lport in glob.glob("/sys/class/net/%s/lower_*" % port):
+                    lport = os.path.basename(lport)
+                    all_ports.add(lport.split('_')[1])
+
+            all_ports = list(all_ports)
+            all_ports.extend(ports)
+            if mtu:
+                ctxt["devs"] = '\\n'.join(all_ports)
+                ctxt['mtu'] = mtu
+
+        return ctxt
+
+
+class NetworkServiceContext(OSContextGenerator):
+
+    def __init__(self, rel_name='quantum-network-service'):
+        self.rel_name = rel_name
+        self.interfaces = [rel_name]
+
+    def __call__(self):
+        for rid in relation_ids(self.rel_name):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                ctxt = {
+                    'keystone_host': rdata.get('keystone_host'),
+                    'service_port': rdata.get('service_port'),
+                    'auth_port': rdata.get('auth_port'),
+                    'service_tenant': rdata.get('service_tenant'),
+                    'service_username': rdata.get('service_username'),
+                    'service_password': rdata.get('service_password'),
+                    'quantum_host': rdata.get('quantum_host'),
+                    'quantum_port': rdata.get('quantum_port'),
+                    'quantum_url': rdata.get('quantum_url'),
+                    'region': rdata.get('region'),
+                    'service_protocol':
+                    rdata.get('service_protocol') or 'http',
+                    'auth_protocol':
+                    rdata.get('auth_protocol') or 'http',
+                    'api_version':
+                    rdata.get('api_version') or '2.0',
+                }
+                if self.context_complete(ctxt):
+                    return ctxt
+        return {}
+
+
+class InternalEndpointContext(OSContextGenerator):
+    """Internal endpoint context.
+
+    This context provides the endpoint type used for communication between
+    services e.g. between Nova and Cinder internally. Openstack uses Public
+    endpoints by default so this allows admins to optionally use internal
+    endpoints.
+    """
+    def __call__(self):
+        return {'use_internal_endpoints': config('use-internal-endpoints')}
+
+
+class VolumeAPIContext(InternalEndpointContext):
+    """Volume API context.
+
+    This context provides information regarding the volume endpoint to use
+    when communicating between services. It determines which version of the
+    API is appropriate for use.
+
+    This value will be determined in the resulting context dictionary
+    returned from calling the VolumeAPIContext object. Information provided
+    by this context is as follows:
+
+        volume_api_version: the volume api version to use, currently
+            'v2' or 'v3'
+        volume_catalog_info: the information to use for a cinder client
+            configuration that consumes API endpoints from the keystone
+            catalog. This is defined as the type:name:endpoint_type string.
+    """
+    # FIXME(wolsen) This implementation is based on the provider being able
+    # to specify the package version to check but does not guarantee that the
+    # volume service api version selected is available. In practice, it is
+    # quite likely the volume service *is* providing the v3 volume service.
+    # This should be resolved when the service-discovery spec is implemented.
+    def __init__(self, pkg):
+        """
+        Creates a new VolumeAPIContext for use in determining which version
+        of the Volume API should be used for communication. A package codename
+        should be supplied for determining the currently installed OpenStack
+        version.
+
+        :param pkg: the package codename to use in order to determine the
+            component version (e.g. nova-common). See
+            charmhelpers.contrib.openstack.utils.PACKAGE_CODENAMES for more.
+        """
+        super(VolumeAPIContext, self).__init__()
+        self._ctxt = None
+        if not pkg:
+            raise ValueError('package name must be provided in order to '
+                             'determine current OpenStack version.')
+        self.pkg = pkg
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """Determines the Volume API endpoint information.
+
+        Determines the appropriate version of the API that should be used
+        as well as the catalog_info string that would be supplied. Returns
+        a dict containing the volume_api_version and the volume_catalog_info.
+        """
+        rel = os_release(self.pkg)
+        version = '2'
+        if CompareOpenStackReleases(rel) >= 'pike':
+            version = '3'
+
+        service_type = 'volumev{version}'.format(version=version)
+        service_name = 'cinderv{version}'.format(version=version)
+        endpoint_type = 'publicURL'
+        if config('use-internal-endpoints'):
+            endpoint_type = 'internalURL'
+        catalog_info = '{type}:{name}:{endpoint}'.format(
+            type=service_type, name=service_name, endpoint=endpoint_type)
+
+        return {
+            'volume_api_version': version,
+            'volume_catalog_info': catalog_info,
+        }
+
+    def __call__(self):
+        return self.ctxt
+
+
+class AppArmorContext(OSContextGenerator):
+    """Base class for apparmor contexts."""
+
+    def __init__(self, profile_name=None):
+        self._ctxt = None
+        self.aa_profile = profile_name
+        self.aa_utils_packages = ['apparmor-utils']
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """
+        Validate aa-profile-mode settings is disable, enforce, or complain.
+
+        :return ctxt: Dictionary of the apparmor profile or None
+        """
+        if config('aa-profile-mode') in ['disable', 'enforce', 'complain']:
+            ctxt = {'aa_profile_mode': config('aa-profile-mode'),
+                    'ubuntu_release': lsb_release()['DISTRIB_RELEASE']}
+            if self.aa_profile:
+                ctxt['aa_profile'] = self.aa_profile
+        else:
+            ctxt = None
+        return ctxt
+
+    def __call__(self):
+        return self.ctxt
+
+    def install_aa_utils(self):
+        """
+        Install packages required for apparmor configuration.
+        """
+        log("Installing apparmor utils.")
+        ensure_packages(self.aa_utils_packages)
+
+    def manually_disable_aa_profile(self):
+        """
+        Manually disable an apparmor profile.
+
+        If aa-profile-mode is set to disabled (default) this is required as the
+        template has been written but apparmor is yet unaware of the profile
+        and aa-disable aa-profile fails. Without this the profile would kick
+        into enforce mode on the next service restart.
+
+        """
+        profile_path = '/etc/apparmor.d'
+        disable_path = '/etc/apparmor.d/disable'
+        if not os.path.lexists(os.path.join(disable_path, self.aa_profile)):
+            os.symlink(os.path.join(profile_path, self.aa_profile),
+                       os.path.join(disable_path, self.aa_profile))
+
+    def setup_aa_profile(self):
+        """
+        Setup an apparmor profile.
+        The ctxt dictionary will contain the apparmor profile mode and
+        the apparmor profile name.
+        Makes calls out to aa-disable, aa-complain, or aa-enforce to setup
+        the apparmor profile.
+        """
+        self()
+        if not self.ctxt:
+            log("Not enabling apparmor Profile")
+            return
+        self.install_aa_utils()
+        cmd = ['aa-{}'.format(self.ctxt['aa_profile_mode'])]
+        cmd.append(self.ctxt['aa_profile'])
+        log("Setting up the apparmor profile for {} in {} mode."
+            "".format(self.ctxt['aa_profile'], self.ctxt['aa_profile_mode']))
+        try:
+            check_call(cmd)
+        except CalledProcessError as e:
+            # If aa-profile-mode is set to disabled (default) manual
+            # disabling is required as the template has been written but
+            # apparmor is yet unaware of the profile and aa-disable aa-profile
+            # fails. If aa-disable learns to read profile files first this can
+            # be removed.
+            if self.ctxt['aa_profile_mode'] == 'disable':
+                log("Manually disabling the apparmor profile for {}."
+                    "".format(self.ctxt['aa_profile']))
+                self.manually_disable_aa_profile()
+                return
+            status_set('blocked', "Apparmor profile {} failed to be set to {}."
+                                  "".format(self.ctxt['aa_profile'],
+                                            self.ctxt['aa_profile_mode']))
+            raise e
+
+
+class MemcacheContext(OSContextGenerator):
+    """Memcache context
+
+    This context provides options for configuring a local memcache client and
+    server for both IPv4 and IPv6
+    """
+
+    def __init__(self, package=None):
+        """
+        @param package: Package to examine to extrapolate OpenStack release.
+                        Used when charms have no openstack-origin config
+                        option (ie subordinates)
+        """
+        self.package = package
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['use_memcache'] = enable_memcache(package=self.package)
+        if ctxt['use_memcache']:
+            # Trusty version of memcached does not support ::1 as a listen
+            # address so use host file entry instead
+            release = lsb_release()['DISTRIB_CODENAME'].lower()
+            if is_ipv6_disabled():
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '127.0.0.1'
+                else:
+                    ctxt['memcache_server'] = 'localhost'
+                ctxt['memcache_server_formatted'] = '127.0.0.1'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = '{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+            else:
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '::1'
+                else:
+                    ctxt['memcache_server'] = 'ip6-localhost'
+                ctxt['memcache_server_formatted'] = '[::1]'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = 'inet6:{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+        return ctxt
+
+
+class EnsureDirContext(OSContextGenerator):
+    '''
+    Serves as a generic context to create a directory as a side-effect.
+
+    Useful for software that supports drop-in files (.d) in conjunction
+    with config option-based templates. Examples include:
+        * OpenStack oslo.policy drop-in files;
+        * systemd drop-in config files;
+        * other software that supports overriding defaults with .d files
+
+    Another use-case is when a subordinate generates a configuration for
+    primary to render in a separate directory.
+
+    Some software requires a user to create a target directory to be
+    scanned for drop-in files with a specific format. This is why this
+    context is needed to do that before rendering a template.
+    '''
+
+    def __init__(self, dirname, **kwargs):
+        '''Used merely to ensure that a given directory exists.'''
+        self.dirname = dirname
+        self.kwargs = kwargs
+
+    def __call__(self):
+        mkdir(self.dirname, **self.kwargs)
+        return {}
+
+
+class VersionsContext(OSContextGenerator):
+    """Context to return the openstack and operating system versions.
+
+    """
+    def __init__(self, pkg='python-keystone'):
+        """Initialise context.
+
+        :param pkg: Package to extrapolate openstack version from.
+        :type pkg: str
+        """
+        self.pkg = pkg
+
+    def __call__(self):
+        ostack = os_release(self.pkg)
+        osystem = lsb_release()['DISTRIB_CODENAME'].lower()
+        return {
+            'openstack_release': ostack,
+            'operating_system_release': osystem}
+
+
+class LogrotateContext(OSContextGenerator):
+    """Common context generator for logrotate."""
+
+    def __init__(self, location, interval, count):
+        """
+        :param location: Absolute path for the logrotate config file
+        :type location: str
+        :param interval: The interval for the rotations. Valid values are
+                         'daily', 'weekly', 'monthly', 'yearly'
+        :type interval: str
+        :param count: The logrotate count option configures the 'count' times
+                      the log files are being rotated before being
+        :type count: int
+        """
+        self.location = location
+        self.interval = interval
+        self.count = 'rotate {}'.format(count)
+
+    def __call__(self):
+        ctxt = {
+            'logrotate_logs_location': self.location,
+            'logrotate_interval': self.interval,
+            'logrotate_count': self.count,
+        }
+        return ctxt
+
+
+class HostInfoContext(OSContextGenerator):
+    """Context to provide host information."""
+
+    def __init__(self, use_fqdn_hint_cb=None):
+        """Initialize HostInfoContext
+
+        :param use_fqdn_hint_cb: Callback whose return value used to populate
+                                 `use_fqdn_hint`
+        :type use_fqdn_hint_cb: Callable[[], bool]
+        """
+        # Store callback used to get hint for whether FQDN should be used
+
+        # Depending on the workload a charm manages, the use of FQDN vs.
+        # shortname may be a deploy-time decision, i.e. behaviour can not
+        # change on charm upgrade or post-deployment configuration change.
+
+        # The hint is passed on as a flag in the context to allow the decision
+        # to be made in the Jinja2 configuration template.
+        self.use_fqdn_hint_cb = use_fqdn_hint_cb
+
+    def _get_canonical_name(self, name=None):
+        """Get the official FQDN of the host
+
+        The implementation of ``socket.getfqdn()`` in the standard Python
+        library does not exhaust all methods of getting the official name
+        of a host ref Python issue https://bugs.python.org/issue5004
+
+        This function mimics the behaviour of a call to ``hostname -f`` to
+        get the official FQDN but returns an empty string if it is
+        unsuccessful.
+
+        :param name: Shortname to get FQDN on
+        :type name: Optional[str]
+        :returns: The official FQDN for host or empty string ('')
+        :rtype: str
+        """
+        name = name or socket.gethostname()
+        fqdn = ''
+
+        if six.PY2:
+            exc = socket.error
+        else:
+            exc = OSError
+
+        try:
+            addrs = socket.getaddrinfo(
+                name, None, 0, socket.SOCK_DGRAM, 0, socket.AI_CANONNAME)
+        except exc:
+            pass
+        else:
+            for addr in addrs:
+                if addr[3]:
+                    if '.' in addr[3]:
+                        fqdn = addr[3]
+                    break
+        return fqdn
+
+    def __call__(self):
+        name = socket.gethostname()
+        ctxt = {
+            'host_fqdn': self._get_canonical_name(name) or name,
+            'host': name,
+            'use_fqdn_hint': (
+                self.use_fqdn_hint_cb() if self.use_fqdn_hint_cb else False)
+        }
+        return ctxt
+
+
+def validate_ovs_use_veth(*args, **kwargs):
+    """Validate OVS use veth setting for dhcp agents
+
+    The ovs_use_veth setting is considered immutable as it will break existing
+    deployments. Historically, we set ovs_use_veth=True in dhcp_agent.ini. It
+    turns out this is no longer necessary. Ideally, all new deployments would
+    have this set to False.
+
+    This function validates that the config value does not conflict with
+    previously deployed settings in dhcp_agent.ini.
+
+    See LP Bug#1831935 for details.
+
+    :returns: Status state and message
+    :rtype: Union[(None, None), (string, string)]
+    """
+    existing_ovs_use_veth = (
+        DHCPAgentContext.get_existing_ovs_use_veth())
+    config_ovs_use_veth = DHCPAgentContext.parse_ovs_use_veth()
+
+    # Check settings are set and not None
+    if existing_ovs_use_veth is not None and config_ovs_use_veth is not None:
+        # Check for mismatch between existing config ini and juju config
+        if existing_ovs_use_veth != config_ovs_use_veth:
+            # Stop the line to avoid breakage
+            msg = (
+                "The existing setting for dhcp_agent.ini ovs_use_veth, {}, "
+                "does not match the juju config setting, {}. This may lead to "
+                "VMs being unable to receive a DHCP IP. Either change the "
+                "juju config setting or dhcp agents may need to be recreated."
+                .format(existing_ovs_use_veth, config_ovs_use_veth))
+            log(msg, ERROR)
+            return (
+                "blocked",
+                "Mismatched existing and configured ovs-use-veth. See log.")
+
+    # Everything is OK
+    return None, None
+
+
+class DHCPAgentContext(OSContextGenerator):
+
+    def __call__(self):
+        """Return the DHCPAGentContext.
+
+        Return all DHCP Agent INI related configuration.
+        ovs unit is attached to (as a subordinate) and the 'dns_domain' from
+        the neutron-plugin-api relations (if one is set).
+
+        :returns: Dictionary context
+        :rtype: Dict
+        """
+
+        ctxt = {}
+        dnsmasq_flags = config('dnsmasq-flags')
+        if dnsmasq_flags:
+            ctxt['dnsmasq_flags'] = config_flags_parser(dnsmasq_flags)
+        ctxt['dns_servers'] = config('dns-servers')
+
+        neutron_api_settings = NeutronAPIContext()()
+
+        ctxt['debug'] = config('debug')
+        ctxt['instance_mtu'] = config('instance-mtu')
+        ctxt['ovs_use_veth'] = self.get_ovs_use_veth()
+
+        ctxt['enable_metadata_network'] = config('enable-metadata-network')
+        ctxt['enable_isolated_metadata'] = config('enable-isolated-metadata')
+
+        if neutron_api_settings.get('dns_domain'):
+            ctxt['dns_domain'] = neutron_api_settings.get('dns_domain')
+
+        # Override user supplied config for these plugins as these settings are
+        # mandatory
+        if config('plugin') in ['nvp', 'nsx', 'n1kv']:
+            ctxt['enable_metadata_network'] = True
+            ctxt['enable_isolated_metadata'] = True
+
+        return ctxt
+
+    @staticmethod
+    def get_existing_ovs_use_veth():
+        """Return existing ovs_use_veth setting from dhcp_agent.ini.
+
+        :returns: Boolean value of existing ovs_use_veth setting or None
+        :rtype: Optional[Bool]
+        """
+        DHCP_AGENT_INI = "/etc/neutron/dhcp_agent.ini"
+        existing_ovs_use_veth = None
+        # If there is a dhcp_agent.ini file read the current setting
+        if os.path.isfile(DHCP_AGENT_INI):
+            # config_ini does the right thing and returns None if the setting is
+            # commented.
+            existing_ovs_use_veth = (
+                config_ini(DHCP_AGENT_INI)["DEFAULT"].get("ovs_use_veth"))
+        # Convert to Bool if necessary
+        if isinstance(existing_ovs_use_veth, six.string_types):
+            return bool_from_string(existing_ovs_use_veth)
+        return existing_ovs_use_veth
+
+    @staticmethod
+    def parse_ovs_use_veth():
+        """Parse the ovs-use-veth config setting.
+
+        Parse the string config setting for ovs-use-veth and return a boolean
+        or None.
+
+        bool_from_string will raise a ValueError if the string is not falsy or
+        truthy.
+
+        :raises: ValueError for invalid input
+        :returns: Boolean value of ovs-use-veth or None
+        :rtype: Optional[Bool]
+        """
+        _config = config("ovs-use-veth")
+        # An unset parameter returns None. Just in case we will also check for
+        # an empty string: "". Ironically, (the problem we are trying to avoid)
+        # "False" returns True and "" returns False.
+        if _config is None or not _config:
+            # Return None
+            return
+        # bool_from_string handles many variations of true and false strings
+        # as well as upper and lowercases including:
+        # ['y', 'yes', 'true', 't', 'on', 'n', 'no', 'false', 'f', 'off']
+        return bool_from_string(_config)
+
+    def get_ovs_use_veth(self):
+        """Return correct ovs_use_veth setting for use in dhcp_agent.ini.
+
+        Get the right value from config or existing dhcp_agent.ini file.
+        Existing has precedence. Attempt to default to "False" without
+        disrupting existing deployments. Handle existing deployments and
+        upgrades safely. See LP Bug#1831935
+
+        :returns: Value to use for ovs_use_veth setting
+        :rtype: Bool
+        """
+        _existing = self.get_existing_ovs_use_veth()
+        if _existing is not None:
+            return _existing
+
+        _config = self.parse_ovs_use_veth()
+        if _config is None:
+            # New better default
+            return False
+        else:
+            return _config
+
+
+EntityMac = collections.namedtuple('EntityMac', ['entity', 'mac'])
+
+
+def resolve_pci_from_mapping_config(config_key):
+    """Resolve local PCI devices from MAC addresses in mapping config.
+
+    Note that this function keeps record of mac->PCI address lookups
+    in the local unit db as the devices will disappaear from the system
+    once bound.
+
+    :param config_key: Configuration option key to parse data from
+    :type config_key: str
+    :returns: PCI device address to Tuple(entity, mac) map
+    :rtype: collections.OrderedDict[str,Tuple[str,str]]
+    """
+    devices = pci.PCINetDevices()
+    resolved_devices = collections.OrderedDict()
+    db = kv()
+    # Note that ``parse_data_port_mappings`` returns Dict regardless of input
+    for mac, entity in parse_data_port_mappings(config(config_key)).items():
+        pcidev = devices.get_device_from_mac(mac)
+        if pcidev:
+            # NOTE: store mac->pci allocation as post binding
+            #       it disappears from PCIDevices.
+            db.set(mac, pcidev.pci_address)
+            db.flush()
+
+        pci_address = db.get(mac)
+        if pci_address:
+            resolved_devices[pci_address] = EntityMac(entity, mac)
+
+    return resolved_devices
+
+
+class DPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, driver_key=None, bridges_key=None, bonds_key=None):
+        """Initialize DPDKDeviceContext.
+
+        :param driver_key: Key to use when retrieving driver config.
+        :type driver_key: str
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.driver_key = driver_key or 'dpdk-driver'
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[str,collections.OrderedDict[str,str]]]
+        """
+        driver = config(self.driver_key)
+        if driver is None:
+            return {}
+        # Resolve PCI devices for both directly used devices (_bridges)
+        # and devices for use in dpdk bonds (_bonds)
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return {'devices': pci_devices,
+                'driver': driver}
+
+
+class OVSDPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, bridges_key=None, bonds_key=None):
+        """Initialize OVSDPDKDeviceContext.
+
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    @staticmethod
+    def _parse_cpu_list(cpulist):
+        """Parses a linux cpulist for a numa node
+
+        :returns: list of cores
+        :rtype: List[int]
+        """
+        cores = []
+        ranges = cpulist.split(',')
+        for cpu_range in ranges:
+            if "-" in cpu_range:
+                cpu_min_max = cpu_range.split('-')
+                cores += range(int(cpu_min_max[0]),
+                               int(cpu_min_max[1]) + 1)
+            else:
+                cores.append(int(cpu_range))
+        return cores
+
+    def _numa_node_cores(self):
+        """Get map of numa node -> cpu core
+
+        :returns: map of numa node -> cpu core
+        :rtype: Dict[str,List[int]]
+        """
+        nodes = {}
+        node_regex = '/sys/devices/system/node/node*'
+        for node in glob.glob(node_regex):
+            index = node.lstrip('/sys/devices/system/node/node')
+            with open(os.path.join(node, 'cpulist')) as cpulist:
+                nodes[index] = self._parse_cpu_list(cpulist.read().strip())
+        return nodes
+
+    def cpu_mask(self):
+        """Get hex formatted CPU mask
+
+        The mask is based on using the first config:dpdk-socket-cores
+        cores of each NUMA node in the unit.
+        :returns: hex formatted CPU mask
+        :rtype: str
+        """
+        num_cores = config('dpdk-socket-cores')
+        mask = 0
+        for cores in self._numa_node_cores().values():
+            for core in cores[:num_cores]:
+                mask = mask | 1 << core
+        return format(mask, '#04x')
+
+    def socket_memory(self):
+        """Formatted list of socket memory configuration per NUMA node
+
+        :returns: socket memory configuration per NUMA node
+        :rtype: str
+        """
+        sm_size = config('dpdk-socket-memory')
+        node_regex = '/sys/devices/system/node/node*'
+        mem_list = [str(sm_size) for _ in glob.glob(node_regex)]
+        if mem_list:
+            return ','.join(mem_list)
+        else:
+            return str(sm_size)
+
+    def devices(self):
+        """List of PCI devices for use by DPDK
+
+        :returns: List of PCI devices for use by DPDK
+        :rtype: collections.OrderedDict[str,str]
+        """
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return pci_devices
+
+    def _formatted_whitelist(self, flag):
+        """Flag formatted list of devices to whitelist
+
+        :param flag: flag format to use
+        :type flag: str
+        :rtype: str
+        """
+        whitelist = []
+        for device in self.devices():
+            whitelist.append(flag.format(device=device))
+        return ' '.join(whitelist)
+
+    def device_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the old style '-w' flag
+
+        :returns: devices to whitelist prefixed by '-w '
+        :rtype: str
+        """
+        return self._formatted_whitelist('-w {device}')
+
+    def pci_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the new style '--pci-whitelist' flag
+
+        :returns: devices to whitelist prefixed by '--pci-whitelist '
+        :rtype: str
+        """
+        return self._formatted_whitelist('--pci-whitelist {device}')
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[bool,str]]
+        """
+        ctxt = {}
+        whitelist = self.device_whitelist()
+        if whitelist:
+            ctxt['dpdk_enabled'] = config('enable-dpdk')
+            ctxt['device_whitelist'] = self.device_whitelist()
+            ctxt['socket_memory'] = self.socket_memory()
+            ctxt['cpu_mask'] = self.cpu_mask()
+        return ctxt
+
+
+class BridgePortInterfaceMap(object):
+    """Build a map of bridge ports and interaces from charm configuration.
+
+    NOTE: the handling of this detail in the charm is pre-deprecated.
+
+    The long term goal is for network connectivity detail to be modelled in
+    the server provisioning layer (such as MAAS) which in turn will provide
+    a Netplan YAML description that will be used to drive Open vSwitch.
+
+    Until we get to that reality the charm will need to configure this
+    detail based on application level configuration options.
+
+    There is a established way of mapping interfaces to ports and bridges
+    in the ``neutron-openvswitch`` and ``neutron-gateway`` charms and we
+    will carry that forward.
+
+    The relationship between bridge, port and interface(s).
+             +--------+
+             | bridge |
+             +--------+
+                 |
+         +----------------+
+         | port aka. bond |
+         +----------------+
+               |   |
+              +-+ +-+
+              |i| |i|
+              |n| |n|
+              |t| |t|
+              |0| |N|
+              +-+ +-+
+    """
+    class interface_type(enum.Enum):
+        """Supported interface types.
+
+        Supported interface types can be found in the ``iface_types`` column
+        in the ``Open_vSwitch`` table on a running system.
+        """
+        dpdk = 'dpdk'
+        internal = 'internal'
+        system = 'system'
+
+        def __str__(self):
+            """Return string representation of value.
+
+            :returns: string representation of value.
+            :rtype: str
+            """
+            return self.value
+
+    def __init__(self, bridges_key=None, bonds_key=None, enable_dpdk_key=None,
+                 global_mtu=None):
+        """Initialize map.
+
+        :param bridges_key: Name of bridge:interface/port map config key
+                            (default: 'data-port')
+        :type bridges_key: Optional[str]
+        :param bonds_key: Name of port-name:interface map config key
+                          (default: 'dpdk-bond-mappings')
+        :type bonds_key: Optional[str]
+        :param enable_dpdk_key: Name of DPDK toggle config key
+                                (default: 'enable-dpdk')
+        :type enable_dpdk_key: Optional[str]
+        :param global_mtu: Set a MTU on all interfaces at map initialization.
+
+            The default is to have Open vSwitch get this from the underlying
+            interface as set up by bare metal provisioning.
+
+            Note that you can augment the MTU on an individual interface basis
+            like this:
+
+            ifdatamap = bpi.get_ifdatamap(bridge, port)
+            ifdatamap = {
+                port: {
+                    **ifdata,
+                    **{'mtu-request': my_individual_mtu_map[port]},
+                }
+                for port, ifdata in ifdatamap.items()
+            }
+        :type global_mtu: Optional[int]
+        """
+        bridges_key = bridges_key or 'data-port'
+        bonds_key = bonds_key or 'dpdk-bond-mappings'
+        enable_dpdk_key = enable_dpdk_key or 'enable-dpdk'
+        self._map = collections.defaultdict(
+            lambda: collections.defaultdict(dict))
+        self._ifname_mac_map = collections.defaultdict(list)
+        self._mac_ifname_map = {}
+        self._mac_pci_address_map = {}
+
+        # First we iterate over the list of physical interfaces visible to the
+        # system and update interface name to mac and mac to interface name map
+        for ifname in list_nics():
+            if not is_phy_iface(ifname):
+                continue
+            mac = get_nic_hwaddr(ifname)
+            self._ifname_mac_map[ifname] = [mac]
+            self._mac_ifname_map[mac] = ifname
+
+            # check if interface is part of a linux bond
+            _bond_name = get_bond_master(ifname)
+            if _bond_name and _bond_name != ifname:
+                log('Add linux bond "{}" to map for physical interface "{}" '
+                    'with mac "{}".'.format(_bond_name, ifname, mac),
+                    level=DEBUG)
+                # for bonds we want to be able to get a list of the mac
+                # addresses for the physical interfaces the bond is made up of.
+                if self._ifname_mac_map.get(_bond_name):
+                    self._ifname_mac_map[_bond_name].append(mac)
+                else:
+                    self._ifname_mac_map[_bond_name] = [mac]
+
+        # In light of the pre-deprecation notice in the docstring of this
+        # class we will expose the ability to configure OVS bonds as a
+        # DPDK-only feature, but generally use the data structures internally.
+        if config(enable_dpdk_key):
+            # resolve PCI address of interfaces listed in the bridges and bonds
+            # charm configuration options.  Note that for already bound
+            # interfaces the helper will retrieve MAC address from the unit
+            # KV store as the information is no longer available in sysfs.
+            _pci_bridge_mac = resolve_pci_from_mapping_config(
+                bridges_key)
+            _pci_bond_mac = resolve_pci_from_mapping_config(
+                bonds_key)
+
+            for pci_address, bridge_mac in _pci_bridge_mac.items():
+                if bridge_mac.mac in self._mac_ifname_map:
+                    # if we already have the interface name in our map it is
+                    # visible to the system and therefore not bound to DPDK
+                    continue
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[ifname] = [bridge_mac.mac]
+                self._mac_ifname_map[bridge_mac.mac] = ifname
+                self._mac_pci_address_map[bridge_mac.mac] = pci_address
+
+            for pci_address, bond_mac in _pci_bond_mac.items():
+                # for bonds we want to be able to get a list of macs from
+                # the bond name and also get at the interface name made up
+                # of the hash of the PCI address
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[bond_mac.entity].append(bond_mac.mac)
+                self._mac_ifname_map[bond_mac.mac] = ifname
+                self._mac_pci_address_map[bond_mac.mac] = pci_address
+
+        config_bridges = config(bridges_key) or ''
+        for bridge, ifname_or_mac in (
+                pair.split(':', 1)
+                for pair in config_bridges.split()):
+            if ':' in ifname_or_mac:
+                try:
+                    ifname = self.ifname_from_mac(ifname_or_mac)
+                except KeyError:
+                    # The interface is destined for a different unit in the
+                    # deployment.
+                    continue
+                macs = [ifname_or_mac]
+            else:
+                ifname = ifname_or_mac
+                macs = self.macs_from_ifname(ifname_or_mac)
+
+            portname = ifname
+            for mac in macs:
+                try:
+                    pci_address = self.pci_address_from_mac(mac)
+                    iftype = self.interface_type.dpdk
+                    ifname = self.ifname_from_mac(mac)
+                except KeyError:
+                    pci_address = None
+                    iftype = self.interface_type.system
+
+                self.add_interface(
+                    bridge, portname, ifname, iftype, pci_address, global_mtu)
+
+            if not macs:
+                # We have not mapped the interface and it is probably some sort
+                # of virtual interface. Our user have put it in the config with
+                # a purpose so let's carry out their wish. LP: #1884743
+                log('Add unmapped interface from config: name "{}" bridge "{}"'
+                    .format(ifname, bridge),
+                    level=DEBUG)
+                self.add_interface(
+                    bridge, ifname, ifname, self.interface_type.system, None,
+                    global_mtu)
+
+    def __getitem__(self, key):
+        """Provide a Dict-like interface, get value of item.
+
+        :param key: Key to look up value from.
+        :type key: any
+        :returns: Value
+        :rtype: any
+        """
+        return self._map.__getitem__(key)
+
+    def __iter__(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.__iter__()
+
+    def __len__(self):
+        """Provide a Dict-like interface, measure the length of internal map.
+
+        :returns: Length
+        :rtype: int
+        """
+        return len(self._map)
+
+    def items(self):
+        """Provide a Dict-like interface, iterate over items.
+
+        :returns: Key Value pairs
+        :rtype: Iterator[any, any]
+        """
+        return self._map.items()
+
+    def keys(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.keys()
+
+    def ifname_from_mac(self, mac):
+        """
+        :returns: Name of interface
+        :rtype: str
+        :raises: KeyError
+        """
+        return (get_bond_master(self._mac_ifname_map[mac]) or
+                self._mac_ifname_map[mac])
+
+    def macs_from_ifname(self, ifname):
+        """
+        :returns: List of hardware address (MAC) of interface
+        :rtype: List[str]
+        :raises: KeyError
+        """
+        return self._ifname_mac_map[ifname]
+
+    def pci_address_from_mac(self, mac):
+        """
+        :param mac: Hardware address (MAC) of interface
+        :type mac: str
+        :returns: PCI address of device associated with mac
+        :rtype: str
+        :raises: KeyError
+        """
+        return self._mac_pci_address_map[mac]
+
+    def add_interface(self, bridge, port, ifname, iftype,
+                      pci_address, mtu_request):
+        """Add an interface to the map.
+
+        :param bridge: Name of bridge on which the bond will be added
+        :type bridge: str
+        :param port: Name of port which will represent the bond on bridge
+        :type port: str
+        :param ifname: Name of interface that will make up the bonded port
+        :type ifname: str
+        :param iftype: Type of interface
+        :type iftype: BridgeBondMap.interface_type
+        :param pci_address: PCI address of interface
+        :type pci_address: Optional[str]
+        :param mtu_request: MTU to request for interface
+        :type mtu_request: Optional[int]
+        """
+        self._map[bridge][port][ifname] = {
+            'type': str(iftype),
+        }
+        if pci_address:
+            self._map[bridge][port][ifname].update({
+                'pci-address': pci_address,
+            })
+        if mtu_request is not None:
+            self._map[bridge][port][ifname].update({
+                'mtu-request': str(mtu_request)
+            })
+
+    def get_ifdatamap(self, bridge, port):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bridge: Name of bridge on which the port will be added
+        :type bridge: str
+        :param port: Name of port which will represent one or more interfaces
+        :type port: str
+        """
+        for _bridge, _ports in self.items():
+            for _port, _interfaces in _ports.items():
+                if _bridge == bridge and _port == port:
+                    ifdatamap = {}
+                    for name, data in _interfaces.items():
+                        ifdatamap.update({
+                            name: {
+                                'type': data['type'],
+                            },
+                        })
+                        if data.get('mtu-request') is not None:
+                            ifdatamap[name].update({
+                                'mtu_request': data['mtu-request'],
+                            })
+                        if data.get('pci-address'):
+                            ifdatamap[name].update({
+                                'options': {
+                                    'dpdk-devargs': data['pci-address'],
+                                },
+                            })
+                    return ifdatamap
+
+
+class BondConfig(object):
+    """Container and helpers for bond configuration options.
+
+    Data is put into a dictionary and a convenient config get interface is
+    provided.
+    """
+
+    DEFAULT_LACP_CONFIG = {
+        'mode': 'balance-tcp',
+        'lacp': 'active',
+        'lacp-time': 'fast'
+    }
+    ALL_BONDS = 'ALL_BONDS'
+
+    BOND_MODES = ['active-backup', 'balance-slb', 'balance-tcp']
+    BOND_LACP = ['active', 'passive', 'off']
+    BOND_LACP_TIME = ['fast', 'slow']
+
+    def __init__(self, config_key=None):
+        """Parse specified configuration option.
+
+        :param config_key: Configuration key to retrieve data from
+                           (default: ``dpdk-bond-config``)
+        :type config_key: Optional[str]
+        """
+        self.config_key = config_key or 'dpdk-bond-config'
+
+        self.lacp_config = {
+            self.ALL_BONDS: copy.deepcopy(self.DEFAULT_LACP_CONFIG)
+        }
+
+        lacp_config = config(self.config_key)
+        if lacp_config:
+            lacp_config_map = lacp_config.split()
+            for entry in lacp_config_map:
+                bond, entry = entry.partition(':')[0:3:2]
+                if not bond:
+                    bond = self.ALL_BONDS
+
+                mode, entry = entry.partition(':')[0:3:2]
+                if not mode:
+                    mode = self.DEFAULT_LACP_CONFIG['mode']
+                assert mode in self.BOND_MODES, \
+                    "Bond mode {} is invalid".format(mode)
+
+                lacp, entry = entry.partition(':')[0:3:2]
+                if not lacp:
+                    lacp = self.DEFAULT_LACP_CONFIG['lacp']
+                assert lacp in self.BOND_LACP, \
+                    "Bond lacp {} is invalid".format(lacp)
+
+                lacp_time, entry = entry.partition(':')[0:3:2]
+                if not lacp_time:
+                    lacp_time = self.DEFAULT_LACP_CONFIG['lacp-time']
+                assert lacp_time in self.BOND_LACP_TIME, \
+                    "Bond lacp-time {} is invalid".format(lacp_time)
+
+                self.lacp_config[bond] = {
+                    'mode': mode,
+                    'lacp': lacp,
+                    'lacp-time': lacp_time
+                }
+
+    def get_bond_config(self, bond):
+        """Get the LACP configuration for a bond
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Dict[str,str]]
+        """
+        return self.lacp_config.get(bond, self.lacp_config[self.ALL_BONDS])
+
+    def get_ovs_portdata(self, bond):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Union[str,Dict[str,str]]]
+        """
+        bond_config = self.get_bond_config(bond)
+        return {
+            'bond_mode': bond_config['mode'],
+            'lacp': bond_config['lacp'],
+            'other_config': {
+                'lacp-time': bond_config['lacp-time'],
+            },
+        }
+
+
+class SRIOVContext(OSContextGenerator):
+    """Provide context for configuring SR-IOV devices."""
+
+    class sriov_config_mode(enum.Enum):
+        """Mode in which SR-IOV is configured.
+
+        The configuration option identified by the ``numvfs_key`` parameter
+        is overloaded and defines in which mode the charm should interpret
+        the other SR-IOV-related configuration options.
+        """
+        auto = 'auto'
+        blanket = 'blanket'
+        explicit = 'explicit'
+
+    def _determine_numvfs(self, device, sriov_numvfs):
+        """Determine number of Virtual Functions (VFs) configured for device.
+
+        :param device: Object describing a PCI Network interface card (NIC)/
+        :type device: sriov_netplan_shim.pci.PCINetDevice
+        :param sriov_numvfs: Number of VFs requested for blanket configuration.
+        :type sriov_numvfs: int
+        :returns: Number of VFs to configure for device
+        :rtype: Optional[int]
+        """
+
+        def _get_capped_numvfs(requested):
+            """Get a number of VFs that does not exceed individual card limits.
+
+            Depending and make and model of NIC the number of VFs supported
+            vary.  Requesting more VFs than a card support would be a fatal
+            error, cap the requested number at the total number of VFs each
+            individual card supports.
+
+            :param requested: Number of VFs requested
+            :type requested: int
+            :returns: Number of VFs allowed
+            :rtype: int
+            """
+            actual = min(int(requested), int(device.sriov_totalvfs))
+            if actual < int(requested):
+                log('Requested VFs ({}) too high for device {}. Falling back '
+                    'to value supprted by device: {}'
+                    .format(requested, device.interface_name,
+                            device.sriov_totalvfs),
+                    level=WARNING)
+            return actual
+
+        if self._sriov_config_mode == self.sriov_config_mode.auto:
+            # auto-mode
+            #
+            # If device mapping configuration is present, return information
+            # on cards with mapping.
+            #
+            # If no device mapping configuration is present, return information
+            # for all cards.
+            #
+            # The maximum number of VFs supported by card will be used.
+            if (self._sriov_mapped_devices and
+                    device.interface_name not in self._sriov_mapped_devices):
+                log('SR-IOV configured in auto mode: No device mapping for {}'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(device.sriov_totalvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.blanket:
+            # blanket-mode
+            #
+            # User has specified a number of VFs that should apply to all
+            # cards with support for VFs.
+            return _get_capped_numvfs(sriov_numvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.explicit:
+            # explicit-mode
+            #
+            # User has given a list of interface names and associated number of
+            # VFs
+            if device.interface_name not in self._sriov_config_devices:
+                log('SR-IOV configured in explicit mode: No device:numvfs '
+                    'pair for device {}, skipping.'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(
+                self._sriov_config_devices[device.interface_name])
+        else:
+            raise RuntimeError('This should not be reached')
+
+    def __init__(self, numvfs_key=None, device_mappings_key=None):
+        """Initialize map from PCI devices and configuration options.
+
+        :param numvfs_key: Config key for numvfs (default: 'sriov-numvfs')
+        :type numvfs_key: Optional[str]
+        :param device_mappings_key: Config key for device mappings
+                                    (default: 'sriov-device-mappings')
+        :type device_mappings_key: Optional[str]
+        :raises: RuntimeError
+        """
+        numvfs_key = numvfs_key or 'sriov-numvfs'
+        device_mappings_key = device_mappings_key or 'sriov-device-mappings'
+
+        devices = pci.PCINetDevices()
+        charm_config = config()
+        sriov_numvfs = charm_config.get(numvfs_key) or ''
+        sriov_device_mappings = charm_config.get(device_mappings_key) or ''
+
+        # create list of devices from sriov_device_mappings config option
+        self._sriov_mapped_devices = [
+            pair.split(':', 1)[1]
+            for pair in sriov_device_mappings.split()
+        ]
+
+        # create map of device:numvfs from sriov_numvfs config option
+        self._sriov_config_devices = {
+            ifname: numvfs for ifname, numvfs in (
+                pair.split(':', 1) for pair in sriov_numvfs.split()
+                if ':' in sriov_numvfs)
+        }
+
+        # determine configuration mode from contents of sriov_numvfs
+        if sriov_numvfs == 'auto':
+            self._sriov_config_mode = self.sriov_config_mode.auto
+        elif sriov_numvfs.isdigit():
+            self._sriov_config_mode = self.sriov_config_mode.blanket
+        elif ':' in sriov_numvfs:
+            self._sriov_config_mode = self.sriov_config_mode.explicit
+        else:
+            raise RuntimeError('Unable to determine mode of SR-IOV '
+                               'configuration.')
+
+        self._map = {
+            device.interface_name: self._determine_numvfs(device, sriov_numvfs)
+            for device in devices.pci_devices
+            if device.sriov and
+            self._determine_numvfs(device, sriov_numvfs) is not None
+        }
+
+    def __call__(self):
+        """Provide SR-IOV context.
+
+        :returns: Map interface name: min(configured, max) virtual functions.
+        Example:
+           {
+               'eth0': 16,
+               'eth1': 32,
+               'eth2': 64,
+           }
+        :rtype: Dict[str,int]
+        """
+        return self._map
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..f85ae4f4cdbb6567cbdd896338bf88fbf3c9c0ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/exceptions.py
@@ -0,0 +1,21 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class OSContextError(Exception):
+    """Raised when an error occurs during context generation.
+
+    This exception is principally used in contrib.openstack.context
+    """
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh
new file mode 100755
index 0000000000000000000000000000000000000000..1df55db4816ec51d6732d68ea0a1e25e6f7b116e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy.sh
@@ -0,0 +1,34 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+CRITICAL=0
+NOTACTIVE=''
+LOGFILE=/var/log/nagios/check_haproxy.log
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+typeset -i N_INSTANCES=0
+for appserver in $(awk '/^\s+server/{print $2}' /etc/haproxy/haproxy.cfg)
+do
+    N_INSTANCES=N_INSTANCES+1
+    output=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' --regex=",${appserver},.*,UP.*" -e ' 200 OK')
+    if [ $? != 0 ]; then
+        date >> $LOGFILE
+        echo $output >> $LOGFILE
+        /usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v | grep ",${appserver}," >> $LOGFILE 2>&1
+        CRITICAL=1
+        NOTACTIVE="${NOTACTIVE} $appserver"
+    fi
+done
+
+if [ $CRITICAL = 1 ]; then
+    echo "CRITICAL:${NOTACTIVE}"
+    exit 2
+fi
+
+echo "OK: All haproxy instances ($N_INSTANCES) looking good"
+exit 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
new file mode 100755
index 0000000000000000000000000000000000000000..91ce0246e66115994c3f518b36448f70100ecfc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
@@ -0,0 +1,30 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#                                       
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+# These should be config options at some stage
+CURRQthrsh=0
+MAXQthrsh=100
+
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+HAPROXYSTATS=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v)
+
+for BACKEND in $(echo $HAPROXYSTATS| xargs -n1 | grep BACKEND | awk -F , '{print $1}')
+do
+    CURRQ=$(echo "$HAPROXYSTATS" | grep $BACKEND | grep BACKEND | cut -d , -f 3)
+    MAXQ=$(echo "$HAPROXYSTATS"  | grep $BACKEND | grep BACKEND | cut -d , -f 4)
+
+    if [[ $CURRQ -gt $CURRQthrsh || $MAXQ -gt $MAXQthrsh ]] ; then
+        echo "CRITICAL: queue depth for $BACKEND - CURRENT:$CURRQ MAX:$MAXQ"
+        exit 2
+    fi
+done
+
+echo "OK: All haproxy queue depths looking good"
+exit 0
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5cbdf535d495a09a0b91f41fdda09862e34140d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ha/utils.py
@@ -0,0 +1,348 @@
+# Copyright 2014-2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2016 Canonical Ltd.
+#
+# Authors:
+#  Openstack Charmers <
+#
+
+"""
+Helpers for high availability.
+"""
+
+import hashlib
+import json
+
+import re
+
+from charmhelpers.core.hookenv import (
+    expected_related_units,
+    log,
+    relation_set,
+    charm_name,
+    config,
+    status_set,
+    DEBUG,
+)
+
+from charmhelpers.core.host import (
+    lsb_release
+)
+
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    is_ipv6,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_iface_for_address,
+    get_netmask_for_address,
+)
+
+from charmhelpers.contrib.hahelpers.cluster import (
+    get_hacluster_config
+)
+
+JSON_ENCODE_OPTIONS = dict(
+    sort_keys=True,
+    allow_nan=False,
+    indent=None,
+    separators=(',', ':'),
+)
+
+VIP_GROUP_NAME = 'grp_{service}_vips'
+DNSHA_GROUP_NAME = 'grp_{service}_hostnames'
+
+
+class DNSHAException(Exception):
+    """Raised when an error occurs setting up DNS HA
+    """
+
+    pass
+
+
+def update_dns_ha_resource_params(resources, resource_params,
+                                  relation_id=None,
+                                  crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration and
+    update resource dictionaries for the HA relation.
+
+    @param resources: Pointer to dictionary of resources.
+                      Usually instantiated in ha_joined().
+    @param resource_params: Pointer to dictionary of resource parameters.
+                            Usually instantiated in ha_joined()
+    @param relation_id: Relation ID of the ha relation
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+    update_hacluster_dns_ha(charm_name(),
+                            _relation_data,
+                            crm_ocf)
+    resources.update(_relation_data['resources'])
+    resource_params.update(_relation_data['resource_params'])
+    relation_set(relation_id=relation_id, groups=_relation_data['groups'])
+
+
+def assert_charm_supports_dns_ha():
+    """Validate prerequisites for DNS HA
+    The MAAS client is only available on Xenial or greater
+
+    :raises DNSHAException: if release is < 16.04
+    """
+    if lsb_release().get('DISTRIB_RELEASE') < '16.04':
+        msg = ('DNS HA is only supported on 16.04 and greater '
+               'versions of Ubuntu.')
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+    return True
+
+
+def expect_ha():
+    """ Determine if the unit expects to be in HA
+
+    Check juju goal-state if ha relation is expected, check for VIP or dns-ha
+    settings which indicate the unit should expect to be related to hacluster.
+
+    @returns boolean
+    """
+    ha_related_units = []
+    try:
+        ha_related_units = list(expected_related_units(reltype='ha'))
+    except (NotImplementedError, KeyError):
+        pass
+    return len(ha_related_units) > 0 or config('vip') or config('dns-ha')
+
+
+def generate_ha_relation_data(service,
+                              extra_settings=None,
+                              haproxy_enabled=True):
+    """ Generate relation data for ha relation
+
+    Based on configuration options and unit interfaces, generate a json
+    encoded dict of relation data items for the hacluster relation,
+    providing configuration for DNS HA or VIP's + haproxy clone sets.
+
+    Example of supplying additional settings::
+
+        COLO_CONSOLEAUTH = 'inf: res_nova_consoleauth grp_nova_vips'
+        AGENT_CONSOLEAUTH = 'ocf:openstack:nova-consoleauth'
+        AGENT_CA_PARAMS = 'op monitor interval="5s"'
+
+        ha_console_settings = {
+            'colocations': {'vip_consoleauth': COLO_CONSOLEAUTH},
+            'init_services': {'res_nova_consoleauth': 'nova-consoleauth'},
+            'resources': {'res_nova_consoleauth': AGENT_CONSOLEAUTH},
+            'resource_params': {'res_nova_consoleauth': AGENT_CA_PARAMS})
+        generate_ha_relation_data('nova', extra_settings=ha_console_settings)
+
+
+    @param service: Name of the service being configured
+    @param extra_settings: Dict of additional resource data
+    @returns dict: json encoded data for use with relation_set
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+
+    if haproxy_enabled:
+        _meta = 'meta migration-threshold="INFINITY" failure-timeout="5s"'
+        _haproxy_res = 'res_{}_haproxy'.format(service)
+        _relation_data['resources'] = {_haproxy_res: 'lsb:haproxy'}
+        _relation_data['resource_params'] = {
+            _haproxy_res: '{} op monitor interval="5s"'.format(_meta)
+        }
+        _relation_data['init_services'] = {_haproxy_res: 'haproxy'}
+        _relation_data['clones'] = {
+            'cl_{}_haproxy'.format(service): _haproxy_res
+        }
+
+    if extra_settings:
+        for k, v in extra_settings.items():
+            if _relation_data.get(k):
+                _relation_data[k].update(v)
+            else:
+                _relation_data[k] = v
+
+    if config('dns-ha'):
+        update_hacluster_dns_ha(service, _relation_data)
+    else:
+        update_hacluster_vip(service, _relation_data)
+
+    return {
+        'json_{}'.format(k): json.dumps(v, **JSON_ENCODE_OPTIONS)
+        for k, v in _relation_data.items() if v
+    }
+
+
+def update_hacluster_dns_ha(service, relation_data,
+                            crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    # Validate the charm environment for DNS HA
+    assert_charm_supports_dns_ha()
+
+    settings = ['os-admin-hostname', 'os-internal-hostname',
+                'os-public-hostname', 'os-access-hostname']
+
+    # Check which DNS settings are set and update dictionaries
+    hostname_group = []
+    for setting in settings:
+        hostname = config(setting)
+        if hostname is None:
+            log('DNS HA: Hostname setting {} is None. Ignoring.'
+                ''.format(setting),
+                DEBUG)
+            continue
+        m = re.search('os-(.+?)-hostname', setting)
+        if m:
+            endpoint_type = m.group(1)
+            # resolve_address's ADDRESS_MAP uses 'int' not 'internal'
+            if endpoint_type == 'internal':
+                endpoint_type = 'int'
+        else:
+            msg = ('Unexpected DNS hostname setting: {}. '
+                   'Cannot determine endpoint_type name'
+                   ''.format(setting))
+            status_set('blocked', msg)
+            raise DNSHAException(msg)
+
+        hostname_key = 'res_{}_{}_hostname'.format(service, endpoint_type)
+        if hostname_key in hostname_group:
+            log('DNS HA: Resource {}: {} already exists in '
+                'hostname group - skipping'.format(hostname_key, hostname),
+                DEBUG)
+            continue
+
+        hostname_group.append(hostname_key)
+        relation_data['resources'][hostname_key] = crm_ocf
+        relation_data['resource_params'][hostname_key] = (
+            'params fqdn="{}" ip_address="{}"'
+            .format(hostname, resolve_address(endpoint_type=endpoint_type,
+                                              override=False)))
+
+    if len(hostname_group) >= 1:
+        log('DNS HA: Hostname group is set with {} as members. '
+            'Informing the ha relation'.format(' '.join(hostname_group)),
+            DEBUG)
+        relation_data['groups'] = {
+            DNSHA_GROUP_NAME.format(service=service): ' '.join(hostname_group)
+        }
+    else:
+        msg = 'DNS HA: Hostname group has no members.'
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+
+
+def get_vip_settings(vip):
+    """Calculate which nic is on the correct network for the given vip.
+
+    If nic or netmask discovery fail then fallback to using charm supplied
+    config. If fallback is used this is indicated via the fallback variable.
+
+    @param vip: VIP to lookup nic and cidr for.
+    @returns (str, str, bool): eg (iface, netmask, fallback)
+    """
+    iface = get_iface_for_address(vip)
+    netmask = get_netmask_for_address(vip)
+    fallback = False
+    if iface is None:
+        iface = config('vip_iface')
+        fallback = True
+    if netmask is None:
+        netmask = config('vip_cidr')
+        fallback = True
+    return iface, netmask, fallback
+
+
+def update_hacluster_vip(service, relation_data):
+    """ Configure VIP resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    """
+    cluster_config = get_hacluster_config()
+    vip_group = []
+    vips_to_delete = []
+    for vip in cluster_config['vip'].split():
+        if is_ipv6(vip):
+            res_vip = 'ocf:heartbeat:IPv6addr'
+            vip_params = 'ipv6addr'
+        else:
+            res_vip = 'ocf:heartbeat:IPaddr2'
+            vip_params = 'ip'
+
+        iface, netmask, fallback = get_vip_settings(vip)
+
+        vip_monitoring = 'op monitor timeout="20s" interval="10s" depth="0"'
+        if iface is not None:
+            # NOTE(jamespage): Delete old VIP resources
+            # Old style naming encoding iface in name
+            # does not work well in environments where
+            # interface/subnet wiring is not consistent
+            vip_key = 'res_{}_{}_vip'.format(service, iface)
+            if vip_key in vips_to_delete:
+                vip_key = '{}_{}'.format(vip_key, vip_params)
+            vips_to_delete.append(vip_key)
+
+            vip_key = 'res_{}_{}_vip'.format(
+                service,
+                hashlib.sha1(vip.encode('UTF-8')).hexdigest()[:7])
+
+            relation_data['resources'][vip_key] = res_vip
+            # NOTE(jamespage):
+            # Use option provided vip params if these where used
+            # instead of auto-detected values
+            if fallback:
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" cidr_netmask="{netmask}" '
+                    'nic="{iface}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        iface=iface,
+                        netmask=netmask,
+                        vip_monitoring=vip_monitoring))
+            else:
+                # NOTE(jamespage):
+                # let heartbeat figure out which interface and
+                # netmask to configure, which works nicely
+                # when network interface naming is not
+                # consistent across units.
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        vip_monitoring=vip_monitoring))
+
+            vip_group.append(vip_key)
+
+    if vips_to_delete:
+        try:
+            relation_data['delete_resources'].extend(vips_to_delete)
+        except KeyError:
+            relation_data['delete_resources'] = vips_to_delete
+
+    if len(vip_group) >= 1:
+        key = VIP_GROUP_NAME.format(service=service)
+        try:
+            relation_data['groups'][key] = ' '.join(vip_group)
+        except KeyError:
+            relation_data['groups'] = {
+                key: ' '.join(vip_group)
+            }
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..723aebc172e94a5b00c385d9861dd4d45c1bc753
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ip.py
@@ -0,0 +1,197 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    unit_get,
+    service_name,
+    network_get_primary_address,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    is_address_in_network,
+    is_ipv6,
+    get_ipv6_addr,
+    resolve_network_cidr,
+)
+from charmhelpers.contrib.hahelpers.cluster import is_clustered
+
+PUBLIC = 'public'
+INTERNAL = 'int'
+ADMIN = 'admin'
+ACCESS = 'access'
+
+ADDRESS_MAP = {
+    PUBLIC: {
+        'binding': 'public',
+        'config': 'os-public-network',
+        'fallback': 'public-address',
+        'override': 'os-public-hostname',
+    },
+    INTERNAL: {
+        'binding': 'internal',
+        'config': 'os-internal-network',
+        'fallback': 'private-address',
+        'override': 'os-internal-hostname',
+    },
+    ADMIN: {
+        'binding': 'admin',
+        'config': 'os-admin-network',
+        'fallback': 'private-address',
+        'override': 'os-admin-hostname',
+    },
+    ACCESS: {
+        'binding': 'access',
+        'config': 'access-network',
+        'fallback': 'private-address',
+        'override': 'os-access-hostname',
+    },
+}
+
+
+def canonical_url(configs, endpoint_type=PUBLIC):
+    """Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration, hacluster and charm configuration.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :param endpoint_type: str endpoint type to resolve.
+    :param returns: str base URL for services on the current service unit.
+    """
+    scheme = _get_scheme(configs)
+
+    address = resolve_address(endpoint_type)
+    if is_ipv6(address):
+        address = "[{}]".format(address)
+
+    return '%s://%s' % (scheme, address)
+
+
+def _get_scheme(configs):
+    """Returns the scheme to use for the url (either http or https)
+    depending upon whether https is in the configs value.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :returns: either 'http' or 'https' depending on whether https is
+              configured within the configs context.
+    """
+    scheme = 'http'
+    if configs and 'https' in configs.complete_contexts():
+        scheme = 'https'
+    return scheme
+
+
+def _get_address_override(endpoint_type=PUBLIC):
+    """Returns any address overrides that the user has defined based on the
+    endpoint type.
+
+    Note: this function allows for the service name to be inserted into the
+    address if the user specifies {service_name}.somehost.org.
+
+    :param endpoint_type: the type of endpoint to retrieve the override
+                          value for.
+    :returns: any endpoint address or hostname that the user has overridden
+              or None if an override is not present.
+    """
+    override_key = ADDRESS_MAP[endpoint_type]['override']
+    addr_override = config(override_key)
+    if not addr_override:
+        return None
+    else:
+        return addr_override.format(service_name=service_name())
+
+
+def resolve_address(endpoint_type=PUBLIC, override=True):
+    """Return unit address depending on net config.
+
+    If unit is clustered with vip(s) and has net splits defined, return vip on
+    correct network. If clustered with no nets defined, return primary vip.
+
+    If not clustered, return unit address ensuring address is on configured net
+    split if one is configured, or a Juju 2.0 extra-binding has been used.
+
+    :param endpoint_type: Network endpoing type
+    :param override: Accept hostname overrides or not
+    """
+    resolved_address = None
+    if override:
+        resolved_address = _get_address_override(endpoint_type)
+        if resolved_address:
+            return resolved_address
+
+    vips = config('vip')
+    if vips:
+        vips = vips.split()
+
+    net_type = ADDRESS_MAP[endpoint_type]['config']
+    net_addr = config(net_type)
+    net_fallback = ADDRESS_MAP[endpoint_type]['fallback']
+    binding = ADDRESS_MAP[endpoint_type]['binding']
+    clustered = is_clustered()
+
+    if clustered and vips:
+        if net_addr:
+            for vip in vips:
+                if is_address_in_network(net_addr, vip):
+                    resolved_address = vip
+                    break
+        else:
+            # NOTE: endeavour to check vips against network space
+            #       bindings
+            try:
+                bound_cidr = resolve_network_cidr(
+                    network_get_primary_address(binding)
+                )
+                for vip in vips:
+                    if is_address_in_network(bound_cidr, vip):
+                        resolved_address = vip
+                        break
+            except (NotImplementedError, NoNetworkBinding):
+                # If no net-splits configured and no support for extra
+                # bindings/network spaces so we expect a single vip
+                resolved_address = vips[0]
+    else:
+        if config('prefer-ipv6'):
+            fallback_addr = get_ipv6_addr(exc_list=vips)[0]
+        else:
+            fallback_addr = unit_get(net_fallback)
+
+        if net_addr:
+            resolved_address = get_address_in_network(net_addr, fallback_addr)
+        else:
+            # NOTE: only try to use extra bindings if legacy network
+            #       configuration is not in use
+            try:
+                resolved_address = network_get_primary_address(binding)
+            except (NotImplementedError, NoNetworkBinding):
+                resolved_address = fallback_addr
+
+    if resolved_address is None:
+        raise ValueError("Unable to resolve a suitable IP address based on "
+                         "charm state and configuration. (net_type=%s, "
+                         "clustered=%s)" % (net_type, clustered))
+
+    return resolved_address
+
+
+def get_vip_in_network(network):
+    matching_vip = None
+    vips = config('vip')
+    if vips:
+        for vip in vips.split():
+            if is_address_in_network(network, vip):
+                matching_vip = vip
+    return matching_vip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/keystone.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/keystone.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7e02ccd90155710901e444482b589aa264158e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/keystone.py
@@ -0,0 +1,178 @@
+#!/usr/bin/python
+#
+# Copyright 2017 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+from charmhelpers.fetch import apt_install
+from charmhelpers.contrib.openstack.context import IdentityServiceContext
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+)
+
+
+def get_api_suffix(api_version):
+    """Return the formatted api suffix for the given version
+    @param api_version: version of the keystone endpoint
+    @returns the api suffix formatted according to the given api
+    version
+    """
+    return 'v2.0' if api_version in (2, "2", "2.0") else 'v3'
+
+
+def format_endpoint(schema, addr, port, api_version):
+    """Return a formatted keystone endpoint
+    @param schema: http or https
+    @param addr: ipv4/ipv6 host of the keystone service
+    @param port: port of the keystone service
+    @param api_version: 2 or 3
+    @returns a fully formatted keystone endpoint
+    """
+    return '{}://{}:{}/{}/'.format(schema, addr, port,
+                                   get_api_suffix(api_version))
+
+
+def get_keystone_manager(endpoint, api_version, **kwargs):
+    """Return a keystonemanager for the correct API version
+
+    @param endpoint: the keystone endpoint to point client at
+    @param api_version: version of the keystone api the client should use
+    @param kwargs: token or username/tenant/password information
+    @returns keystonemanager class used for interrogating keystone
+    """
+    if api_version == 2:
+        return KeystoneManager2(endpoint, **kwargs)
+    if api_version == 3:
+        return KeystoneManager3(endpoint, **kwargs)
+    raise ValueError('No manager found for api version {}'.format(api_version))
+
+
+def get_keystone_manager_from_identity_service_context():
+    """Return a keystonmanager generated from a
+    instance of charmhelpers.contrib.openstack.context.IdentityServiceContext
+    @returns keystonamenager instance
+   """
+    context = IdentityServiceContext()()
+    if not context:
+        msg = "Identity service context cannot be generated"
+        log(msg, level=ERROR)
+        raise ValueError(msg)
+
+    endpoint = format_endpoint(context['service_protocol'],
+                               context['service_host'],
+                               context['service_port'],
+                               context['api_version'])
+
+    if context['api_version'] in (2, "2.0"):
+        api_version = 2
+    else:
+        api_version = 3
+
+    return get_keystone_manager(endpoint, api_version,
+                                username=context['admin_user'],
+                                password=context['admin_password'],
+                                tenant_name=context['admin_tenant_name'])
+
+
+class KeystoneManager(object):
+
+    def resolve_service_id(self, service_name=None, service_type=None):
+        """Find the service_id of a given service"""
+        services = [s._info for s in self.api.services.list()]
+
+        service_name = service_name.lower()
+        for s in services:
+            name = s['name'].lower()
+            if service_type and service_name:
+                if (service_name == name and service_type == s['type']):
+                    return s['id']
+            elif service_name and service_name == name:
+                return s['id']
+            elif service_type and service_type == s['type']:
+                return s['id']
+        return None
+
+    def service_exists(self, service_name=None, service_type=None):
+        """Determine if the given service exists on the service list"""
+        return self.resolve_service_id(service_name, service_type) is not None
+
+
+class KeystoneManager2(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+
+        self.api_version = 2
+
+        token = kwargs.get("token", None)
+        if token:
+            api = client.Client(endpoint=endpoint, token=token)
+        else:
+            auth = v2.Password(username=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               tenant_name=kwargs.get("tenant_name"),
+                               auth_url=endpoint)
+            sess = session.Session(auth=auth)
+            api = client.Client(session=sess)
+
+        self.api = api
+
+
+class KeystoneManager3(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+
+        self.api_version = 3
+
+        token = kwargs.get("token", None)
+        if token:
+            auth = token_endpoint.Token(endpoint=endpoint,
+                                        token=token)
+            sess = session.Session(auth=auth)
+        else:
+            auth = v3.Password(auth_url=endpoint,
+                               user_id=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               project_id=kwargs.get("tenant_name"))
+            sess = session.Session(auth=auth)
+
+        self.api = client.Client(session=sess)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/neutron.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/neutron.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb5607f3e73159d90236b2d7a4051aa82119e889
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/neutron.py
@@ -0,0 +1,359 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Various utilies for dealing with Neutron and the renaming from Quantum.
+
+import six
+from subprocess import check_output
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    ERROR,
+)
+
+from charmhelpers.contrib.openstack.utils import (
+    os_release,
+    CompareOpenStackReleases,
+)
+
+
+def headers_package():
+    """Ensures correct linux-headers for running kernel are installed,
+    for building DKMS package"""
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    return 'linux-headers-%s' % kver
+
+
+QUANTUM_CONF_DIR = '/etc/quantum'
+
+
+def kernel_version():
+    """ Retrieve the current major kernel version as a tuple e.g. (3, 13) """
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    kver = kver.split('.')
+    return (int(kver[0]), int(kver[1]))
+
+
+def determine_dkms_package():
+    """ Determine which DKMS package should be used based on kernel version """
+    # NOTE: 3.13 kernels have support for GRE and VXLAN native
+    if kernel_version() >= (3, 13):
+        return []
+    else:
+        return [headers_package(), 'openvswitch-datapath-dkms']
+
+
+# legacy
+
+
+def quantum_plugins():
+    return {
+        'ovs': {
+            'config': '/etc/quantum/plugins/openvswitch/'
+                      'ovs_quantum_plugin.ini',
+            'driver': 'quantum.plugins.openvswitch.ovs_quantum_plugin.'
+                      'OVSQuantumPluginV2',
+            'contexts': [],
+            'services': ['quantum-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['quantum-plugin-openvswitch-agent']],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-openvswitch'],
+            'server_services': ['quantum-server']
+        },
+        'nvp': {
+            'config': '/etc/quantum/plugins/nicira/nvp.ini',
+            'driver': 'quantum.plugins.nicira.nicira_nvp_plugin.'
+                      'QuantumPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-nicira'],
+            'server_services': ['quantum-server']
+        }
+    }
+
+
+NEUTRON_CONF_DIR = '/etc/neutron'
+
+
+def neutron_plugins():
+    release = os_release('nova-common')
+    plugins = {
+        'ovs': {
+            'config': '/etc/neutron/plugins/openvswitch/'
+                      'ovs_neutron_plugin.ini',
+            'driver': 'neutron.plugins.openvswitch.ovs_neutron_plugin.'
+                      'OVSNeutronPluginV2',
+            'contexts': [],
+            'services': ['neutron-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-openvswitch-agent']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-openvswitch'],
+            'server_services': ['neutron-server']
+        },
+        'nvp': {
+            'config': '/etc/neutron/plugins/nicira/nvp.ini',
+            'driver': 'neutron.plugins.nicira.nicira_nvp_plugin.'
+                      'NeutronPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-nicira'],
+            'server_services': ['neutron-server']
+        },
+        'nsx': {
+            'config': '/etc/neutron/plugins/vmware/nsx.ini',
+            'driver': 'vmware',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-vmware'],
+            'server_services': ['neutron-server']
+        },
+        'n1kv': {
+            'config': '/etc/neutron/plugins/cisco/cisco_plugins.ini',
+            'driver': 'neutron.plugins.cisco.network_plugin.PluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-cisco']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-cisco'],
+            'server_services': ['neutron-server']
+        },
+        'Calico': {
+            'config': '/etc/neutron/plugins/ml2/ml2_conf.ini',
+            'driver': 'neutron.plugins.ml2.plugin.Ml2Plugin',
+            'contexts': [],
+            'services': ['calico-felix',
+                         'bird',
+                         'neutron-dhcp-agent',
+                         'nova-api-metadata',
+                         'etcd'],
+            'packages': [determine_dkms_package(),
+                         ['calico-compute',
+                          'bird',
+                          'neutron-dhcp-agent',
+                          'nova-api-metadata',
+                          'etcd']],
+            'server_packages': ['neutron-server', 'calico-control', 'etcd'],
+            'server_services': ['neutron-server', 'etcd']
+        },
+        'vsp': {
+            'config': '/etc/neutron/plugins/nuage/nuage_plugin.ini',
+            'driver': 'neutron.plugins.nuage.plugin.NuagePlugin',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server', 'neutron-plugin-nuage'],
+            'server_services': ['neutron-server']
+        },
+        'plumgrid': {
+            'config': '/etc/neutron/plugins/plumgrid/plumgrid.ini',
+            'driver': ('neutron.plugins.plumgrid.plumgrid_plugin'
+                       '.plumgrid_plugin.NeutronPluginPLUMgridV2'),
+            'contexts': [],
+            'services': [],
+            'packages': ['plumgrid-lxc',
+                         'iovisor-dkms'],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-plumgrid'],
+            'server_services': ['neutron-server']
+        },
+        'midonet': {
+            'config': '/etc/neutron/plugins/midonet/midonet.ini',
+            'driver': 'midonet.neutron.plugin.MidonetPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package()],
+            'server_packages': ['neutron-server',
+                                'python-neutron-plugin-midonet'],
+            'server_services': ['neutron-server']
+        }
+    }
+    if CompareOpenStackReleases(release) >= 'icehouse':
+        # NOTE: patch in ml2 plugin for icehouse onwards
+        plugins['ovs']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['ovs']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['ovs']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+        # NOTE: patch in vmware renames nvp->nsx for icehouse onwards
+        plugins['nvp'] = plugins['nsx']
+    if CompareOpenStackReleases(release) >= 'kilo':
+        plugins['midonet']['driver'] = (
+            'neutron.plugins.midonet.plugin.MidonetPluginV2')
+    if CompareOpenStackReleases(release) >= 'liberty':
+        plugins['midonet']['driver'] = (
+            'midonet.neutron.plugin_v1.MidonetPluginV2')
+        plugins['midonet']['server_packages'].remove(
+            'python-neutron-plugin-midonet')
+        plugins['midonet']['server_packages'].append(
+            'python-networking-midonet')
+        plugins['plumgrid']['driver'] = (
+            'networking_plumgrid.neutron.plugins'
+            '.plugin.NeutronPluginPLUMgridV2')
+        plugins['plumgrid']['server_packages'].remove(
+            'neutron-plugin-plumgrid')
+    if CompareOpenStackReleases(release) >= 'mitaka':
+        plugins['nsx']['server_packages'].remove('neutron-plugin-vmware')
+        plugins['nsx']['server_packages'].append('python-vmware-nsx')
+        plugins['nsx']['config'] = '/etc/neutron/nsx.ini'
+        plugins['vsp']['driver'] = (
+            'nuage_neutron.plugins.nuage.plugin.NuagePlugin')
+    if CompareOpenStackReleases(release) >= 'newton':
+        plugins['vsp']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['vsp']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['vsp']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+    return plugins
+
+
+def neutron_plugin_attribute(plugin, attr, net_manager=None):
+    manager = net_manager or network_manager()
+    if manager == 'quantum':
+        plugins = quantum_plugins()
+    elif manager == 'neutron':
+        plugins = neutron_plugins()
+    else:
+        log("Network manager '%s' does not support plugins." % (manager),
+            level=ERROR)
+        raise Exception
+
+    try:
+        _plugin = plugins[plugin]
+    except KeyError:
+        log('Unrecognised plugin for %s: %s' % (manager, plugin), level=ERROR)
+        raise Exception
+
+    try:
+        return _plugin[attr]
+    except KeyError:
+        return None
+
+
+def network_manager():
+    '''
+    Deals with the renaming of Quantum to Neutron in H and any situations
+    that require compatability (eg, deploying H with network-manager=quantum,
+    upgrading from G).
+    '''
+    release = os_release('nova-common')
+    manager = config('network-manager').lower()
+
+    if manager not in ['quantum', 'neutron']:
+        return manager
+
+    if release in ['essex']:
+        # E does not support neutron
+        log('Neutron networking not supported in Essex.', level=ERROR)
+        raise Exception
+    elif release in ['folsom', 'grizzly']:
+        # neutron is named quantum in F and G
+        return 'quantum'
+    else:
+        # ensure accurate naming for all releases post-H
+        return 'neutron'
+
+
+def parse_mappings(mappings, key_rvalue=False):
+    """By default mappings are lvalue keyed.
+
+    If key_rvalue is True, the mapping will be reversed to allow multiple
+    configs for the same lvalue.
+    """
+    parsed = {}
+    if mappings:
+        mappings = mappings.split()
+        for m in mappings:
+            p = m.partition(':')
+
+            if key_rvalue:
+                key_index = 2
+                val_index = 0
+                # if there is no rvalue skip to next
+                if not p[1]:
+                    continue
+            else:
+                key_index = 0
+                val_index = 2
+
+            key = p[key_index].strip()
+            parsed[key] = p[val_index].strip()
+
+    return parsed
+
+
+def parse_bridge_mappings(mappings):
+    """Parse bridge mappings.
+
+    Mappings must be a space-delimited list of provider:bridge mappings.
+
+    Returns dict of the form {provider:bridge}.
+    """
+    return parse_mappings(mappings)
+
+
+def parse_data_port_mappings(mappings, default_bridge='br-data'):
+    """Parse data port mappings.
+
+    Mappings must be a space-delimited list of bridge:port.
+
+    Returns dict of the form {port:bridge} where ports may be mac addresses or
+    interface names.
+    """
+
+    # NOTE(dosaboy): we use rvalue for key to allow multiple values to be
+    # proposed for <port> since it may be a mac address which will differ
+    # across units this allowing first-known-good to be chosen.
+    _mappings = parse_mappings(mappings, key_rvalue=True)
+    if not _mappings or list(_mappings.values()) == ['']:
+        if not mappings:
+            return {}
+
+        # For backwards-compatibility we need to support port-only provided in
+        # config.
+        _mappings = {mappings.split()[0]: default_bridge}
+
+    ports = _mappings.keys()
+    if len(set(ports)) != len(ports):
+        raise Exception("It is not allowed to have the same port configured "
+                        "on more than one bridge")
+
+    return _mappings
+
+
+def parse_vlan_range_mappings(mappings):
+    """Parse vlan range mappings.
+
+    Mappings must be a space-delimited list of provider:start:end mappings.
+
+    The start:end range is optional and may be omitted.
+
+    Returns dict of the form {provider: (start, end)}.
+    """
+    _mappings = parse_mappings(mappings)
+    if not _mappings:
+        return {}
+
+    mappings = {}
+    for p, r in six.iteritems(_mappings):
+        mappings[p] = tuple(r.split(':'))
+
+    return mappings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/policyd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/policyd.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2bb21e9db926bd2c4de8ab3e8d10d0837af563a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/policyd.py
@@ -0,0 +1,801 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import contextlib
+import os
+import six
+import shutil
+import yaml
+import zipfile
+
+import charmhelpers
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as ch_host
+
+# Features provided by this module:
+
+"""
+Policy.d helper functions
+=========================
+
+The functions in this module are designed, as a set, to provide an easy-to-use
+set of hooks for classic charms to add in /etc/<service-name>/policy.d/
+directory override YAML files.
+
+(For charms.openstack charms, a mixin class is provided for this
+functionality).
+
+In order to "hook" this functionality into a (classic) charm, two functions are
+provided:
+
+    maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=none,
+                               blacklist_keys=none,
+                               template_function=none,
+                               restart_handler=none)
+
+    maybe_do_policyd_overrides_on_config_changed(openstack_release,
+                                                 service,
+                                                 blacklist_paths=None,
+                                                 blacklist_keys=None,
+                                                 template_function=None,
+                                                 restart_handler=None
+
+(See the docstrings for details on the parameters)
+
+The functions should be called from the install and upgrade hooks in the charm.
+The `maybe_do_policyd_overrides_on_config_changed` function is designed to be
+called on the config-changed hook, in that it does an additional check to
+ensure that an already overriden policy.d in an upgrade or install hooks isn't
+repeated.
+
+In order the *enable* this functionality, the charm's install, config_changed,
+and upgrade_charm hooks need to be modified, and a new config option (see
+below) needs to be added.  The README for the charm should also be updated.
+
+Examples from the keystone charm are:
+
+@hooks.hook('install.real')
+@harden()
+def install():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+
+@hooks.hook('config-changed')
+@restart_on_change(restart_map(), restart_functions=restart_function_map())
+@harden()
+def config_changed():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides_on_config_changed(os_release('keystone'),
+                                                 'keystone')
+
+@hooks.hook('upgrade-charm')
+@restart_on_change(restart_map(), stopstart=True)
+@harden()
+def upgrade_charm():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+Status Line
+===========
+
+The workload status code in charm-helpers has been modified to detect if
+policy.d override code has been incorporated into the charm by checking for the
+new config variable (in the config.yaml).  If it has been, then the workload
+status line will automatically show "PO:" at the beginning of the workload
+status for that unit/service if the config option is set.  If the policy
+override is broken, the "PO (broken):" will be shown.  No changes to the charm
+(apart from those already mentioned) are needed to enable this functionality.
+(charms.openstack charms also get this functionality, but please see that
+library for further details).
+"""
+
+# The config.yaml for the charm should contain the following for the config
+# option:
+
+"""
+  use-policyd-override:
+    type: boolean
+    default: False
+    description: |
+      If True then use the resource file named 'policyd-override' to install
+      override YAML files in the service's policy.d directory.  The resource
+      file should be a ZIP file containing at least one yaml file with a .yaml
+      or .yml extension.  If False then remove the overrides.
+"""
+
+# The metadata.yaml for the charm should contain the following:
+"""
+resources:
+  policyd-override:
+    type: file
+    filename: policyd-override.zip
+    description: The policy.d overrides file
+"""
+
+# The README for the charm should contain the following:
+"""
+Policy Overrides
+----------------
+
+This feature allows for policy overrides using the `policy.d` directory.  This
+is an **advanced** feature and the policies that the OpenStack service supports
+should be clearly and unambiguously understood before trying to override, or
+add to, the default policies that the service uses.  The charm also has some
+policy defaults.  They should also be understood before being overridden.
+
+> **Caution**: It is possible to break the system (for tenants and other
+  services) if policies are incorrectly applied to the service.
+
+Policy overrides are YAML files that contain rules that will add to, or
+override, existing policy rules in the service.  The `policy.d` directory is
+a place to put the YAML override files.  This charm owns the
+`/etc/keystone/policy.d` directory, and as such, any manual changes to it will
+be overwritten on charm upgrades.
+
+Overrides are provided to the charm using a Juju resource called
+`policyd-override`.  The resource is a ZIP file.  This file, say
+`overrides.zip`, is attached to the charm by:
+
+
+    juju attach-resource <charm-name> policyd-override=overrides.zip
+
+The policy override is enabled in the charm using:
+
+    juju config <charm-name> use-policyd-override=true
+
+When `use-policyd-override` is `True` the status line of the charm will be
+prefixed with `PO:` indicating that policies have been overridden.  If the
+installation of the policy override YAML files failed for any reason then the
+status line will be prefixed with `PO (broken):`.  The log file for the charm
+will indicate the reason.  No policy override files are installed if the `PO
+(broken):` is shown.  The status line indicates that the overrides are broken,
+not that the policy for the service has failed. The policy will be the defaults
+for the charm and service.
+
+Policy overrides on one service may affect the functionality of another
+service. Therefore, it may be necessary to provide policy overrides for
+multiple service charms to achieve a consistent set of policies across the
+OpenStack system.  The charms for the other services that may need overrides
+should be checked to ensure that they support overrides before proceeding.
+"""
+
+POLICYD_VALID_EXTS = ['.yaml', '.yml', '.j2', '.tmpl', '.tpl']
+POLICYD_TEMPLATE_EXTS = ['.j2', '.tmpl', '.tpl']
+POLICYD_RESOURCE_NAME = "policyd-override"
+POLICYD_CONFIG_NAME = "use-policyd-override"
+POLICYD_SUCCESS_FILENAME = "policyd-override-success"
+POLICYD_LOG_LEVEL_DEFAULT = hookenv.INFO
+POLICYD_ALWAYS_BLACKLISTED_KEYS = ("admin_required", "cloud_admin")
+
+
+class BadPolicyZipFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+class BadPolicyYamlFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+if six.PY2:
+    BadZipFile = zipfile.BadZipfile
+else:
+    BadZipFile = zipfile.BadZipFile
+
+
+def is_policyd_override_valid_on_this_release(openstack_release):
+    """Check that the charm is running on at least Ubuntu Xenial, and at
+    least the queens release.
+
+    :param openstack_release: the release codename that is installed.
+    :type openstack_release: str
+    :returns: True if okay
+    :rtype: bool
+    """
+    # NOTE(ajkavanagh) circular import!  This is because the status message
+    # generation code in utils has to call into this module, but this function
+    # needs the CompareOpenStackReleases() function.  The only way to solve
+    # this is either to put ALL of this module into utils, or refactor one or
+    # other of the CompareOpenStackReleases or status message generation code
+    # into a 3rd module.
+    import charmhelpers.contrib.openstack.utils as ch_utils
+    return ch_utils.CompareOpenStackReleases(openstack_release) >= 'queens'
+
+
+def maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=None,
+                               blacklist_keys=None,
+                               template_function=None,
+                               restart_handler=None,
+                               user=None,
+                               group=None,
+                               config_changed=False):
+    """If the config option is set, get the resource file and process it to
+    enable the policy.d overrides for the service passed.
+
+    The param `openstack_release` is required as the policyd overrides feature
+    is only supported on openstack_release "queens" or later, and on ubuntu
+    "xenial" or later.  Prior to these versions, this feature is a NOP.
+
+    The optional template_function is a function that accepts a string and has
+    an opportunity to modify the loaded file prior to it being read by
+    yaml.safe_load().  This allows the charm to perform "templating" using
+    charm derived data.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The param restart_handler is an optional Callable that is called to perform
+    the service restart if the policy.d file is changed.  This should normally
+    be None as oslo.policy automatically picks up changes in the policy.d
+    directory.  However, for any services where this is buggy then a
+    restart_handler can be used to force the policy.d files to be read.
+
+    If the config_changed param is True, then the handling is slightly
+    different: It will only perform the policyd overrides if the config is True
+    and the success file doesn't exist.  Otherwise, it does nothing as the
+    resource file has already been processed.
+
+    :param openstack_release: The openstack release that is installed.
+    :type openstack_release: str
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the string
+                              prior to being processed as a Yaml document.
+    :type template_function: Union[None, Callable[[str], str]]
+    :param restart_handler: The function to call if the service should be
+                            restarted.
+    :type restart_handler: Union[None, Callable[]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :param config_changed: Set to True for config_changed hook.
+    :type config_changed: bool
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    if not is_policyd_override_valid_on_this_release(openstack_release):
+        return
+    hookenv.log("Running maybe_do_policyd_overrides",
+                level=POLICYD_LOG_LEVEL_DEFAULT)
+    config = hookenv.config()
+    try:
+        if not config.get(POLICYD_CONFIG_NAME, False):
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            if (os.path.isfile(_policy_success_file()) and
+                    restart_handler is not None and
+                    callable(restart_handler)):
+                restart_handler()
+            remove_policy_success_file()
+            return
+    except Exception as e:
+        hookenv.log("... ERROR: Exception is: {}".format(str(e)),
+                    level=POLICYD_CONFIG_NAME)
+        import traceback
+        hookenv.log(traceback.format_exc(), level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # if the policyd overrides have been performed when doing config_changed
+    # just return
+    if config_changed and is_policy_success_file_set():
+        hookenv.log("... already setup, so skipping.",
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # from now on it should succeed; if it doesn't then status line will show
+    # broken.
+    resource_filename = get_policy_resource_filename()
+    restart = process_policy_resource_file(
+        resource_filename, service, blacklist_paths, blacklist_keys,
+        template_function)
+    if restart and restart_handler is not None and callable(restart_handler):
+        restart_handler()
+
+
+@charmhelpers.deprecate("Use maybe_do_poliyd_overrrides instead")
+def maybe_do_policyd_overrides_on_config_changed(*args, **kwargs):
+    """This function is designed to be called from the config changed hook.
+
+    DEPRECATED: please use maybe_do_policyd_overrides() with the param
+    `config_changed` as `True`.
+
+    See maybe_do_policyd_overrides() for more details on the params.
+    """
+    if 'config_changed' not in kwargs.keys():
+        kwargs['config_changed'] = True
+    return maybe_do_policyd_overrides(*args, **kwargs)
+
+
+def get_policy_resource_filename():
+    """Function to extract the policy resource filename
+
+    :returns: The filename of the resource, if set, otherwise, if an error
+               occurs, then None is returned.
+    :rtype: Union[str, None]
+    """
+    try:
+        return hookenv.resource_get(POLICYD_RESOURCE_NAME)
+    except Exception:
+        return None
+
+
+@contextlib.contextmanager
+def open_and_filter_yaml_files(filepath, has_subdirs=False):
+    """Validate that the filepath provided is a zip file and contains at least
+    one (.yaml|.yml) file, and that the files are not duplicated when the zip
+    file is flattened.  Note that the yaml files are not checked.  This is the
+    first stage in validating the policy zipfile; individual yaml files are not
+    checked for validity or black listed keys.
+
+    If the has_subdirs param is True, then the files are flattened to the first
+    directory, and the files in the root are ignored.
+
+    An example of use is:
+
+        with open_and_filter_yaml_files(some_path) as zfp, g:
+            for zipinfo in g:
+                # do something with zipinfo ...
+
+    :param filepath: a filepath object that can be opened by zipfile
+    :type filepath: Union[AnyStr, os.PathLike[AntStr]]
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: (zfp handle,
+               a generator of the (name, filename, ZipInfo object) tuples) as a
+               tuple.
+    :rtype: ContextManager[(zipfile.ZipFile,
+                            Generator[(name, str, str, zipfile.ZipInfo)])]
+    :raises: zipfile.BadZipFile
+    :raises: BadPolicyZipFile if duplicated yaml or missing
+    :raises: IOError if the filepath is not found
+    """
+    with zipfile.ZipFile(filepath, 'r') as zfp:
+        # first pass through; check for duplicates and at least one yaml file.
+        names = collections.defaultdict(int)
+        yamlfiles = _yamlfiles(zfp, has_subdirs)
+        for name, _, _, _ in yamlfiles:
+            names[name] += 1
+        # There must be at least 1 yaml file.
+        if len(names.keys()) == 0:
+            raise BadPolicyZipFile("contains no yaml files with {} extensions."
+                                   .format(", ".join(POLICYD_VALID_EXTS)))
+        # There must be no duplicates
+        duplicates = [n for n, c in names.items() if c > 1]
+        if duplicates:
+            raise BadPolicyZipFile("{} have duplicates in the zip file."
+                                   .format(", ".join(duplicates)))
+        # Finally, let's yield the generator
+        yield (zfp, yamlfiles)
+
+
+def _yamlfiles(zipfile, has_subdirs=False):
+    """Helper to get a yaml file (according to POLICYD_VALID_EXTS extensions)
+    and the infolist item from a zipfile.
+
+    If the `has_subdirs` param is True, the the only yaml files that have a
+    directory component are read, and then first part of the directory
+    component is kept, along with the filename in the name.  e.g. an entry with
+    a filename of:
+
+        compute/someotherdir/override.yaml
+
+    is returned as:
+
+        compute/override, yaml, override.yaml, <ZipInfo object>
+
+    This is to help with the special, additional, processing that the dashboard
+    charm requires.
+
+    :param zipfile: the zipfile to read zipinfo items from
+    :type zipfile: zipfile.ZipFile
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: generator of (name, ext, filename, info item) for each
+              self-identified yaml file.
+    :rtype: List[(str, str, str, zipfile.ZipInfo)]
+    """
+    files = []
+    for infolist_item in zipfile.infolist():
+        try:
+            if infolist_item.is_dir():
+                continue
+        except AttributeError:
+            # fallback to "old" way to determine dir entry for pre-py36
+            if infolist_item.filename.endswith('/'):
+                continue
+        _dir, name_ext = os.path.split(infolist_item.filename)
+        name, ext = os.path.splitext(name_ext)
+        if has_subdirs and _dir != "":
+            name = os.path.join(_dir.split(os.path.sep)[0], name)
+        ext = ext.lower()
+        if ext and ext in POLICYD_VALID_EXTS:
+            files.append((name, ext, name_ext, infolist_item))
+    return files
+
+
+def read_and_validate_yaml(stream_or_doc, blacklist_keys=None):
+    """Read, validate and return the (first) yaml document from the stream.
+
+    The doc is read, and checked for a yaml file.  The the top-level keys are
+    checked against the blacklist_keys provided.  If there are problems then an
+    Exception is raised.  Otherwise the yaml document is returned as a Python
+    object that can be dumped back as a yaml file on the system.
+
+    The yaml file must only consist of a str:str mapping, and if not then the
+    yaml file is rejected.
+
+    :param stream_or_doc: the file object to read the yaml from
+    :type stream_or_doc: Union[AnyStr, IO[AnyStr]]
+    :param blacklist_keys: Any keys, which if in the yaml file, should cause
+        and error.
+    :type blacklisted_keys: Union[None, List[str]]
+    :returns: the yaml file as a python document
+    :rtype: Dict[str, str]
+    :raises: yaml.YAMLError if there is a problem with the document
+    :raises: BadPolicyYamlFile if file doesn't look right or there are
+             blacklisted keys in the file.
+    """
+    blacklist_keys = blacklist_keys or []
+    blacklist_keys.append(POLICYD_ALWAYS_BLACKLISTED_KEYS)
+    doc = yaml.safe_load(stream_or_doc)
+    if not isinstance(doc, dict):
+        raise BadPolicyYamlFile("doesn't look like a policy file?")
+    keys = set(doc.keys())
+    blacklisted_keys_present = keys.intersection(blacklist_keys)
+    if blacklisted_keys_present:
+        raise BadPolicyYamlFile("blacklisted keys {} present."
+                                .format(", ".join(blacklisted_keys_present)))
+    if not all(isinstance(k, six.string_types) for k in keys):
+        raise BadPolicyYamlFile("keys in yaml aren't all strings?")
+    # check that the dictionary looks like a mapping of str to str
+    if not all(isinstance(v, six.string_types) for v in doc.values()):
+        raise BadPolicyYamlFile("values in yaml aren't all strings?")
+    return doc
+
+
+def policyd_dir_for(service):
+    """Return the policy directory for the named service.
+
+    :param service: str
+    :returns: the policy.d override directory.
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join("/", "etc", service, "policy.d")
+
+
+def clean_policyd_dir_for(service, keep_paths=None, user=None, group=None):
+    """Clean out the policyd directory except for items that should be kept.
+
+    The keep_paths, if used, should be set to the full path of the files that
+    should be kept in the policyd directory for the service.  Note that the
+    service name is passed in, and then the policyd_dir_for() function is used.
+    This is so that a coding error doesn't result in a sudden deletion of the
+    charm (say).
+
+    :param service: the service name to use to construct the policy.d dir.
+    :type service: str
+    :param keep_paths: optional list of paths to not delete.
+    :type keep_paths: Union[None, List[str]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    keep_paths = keep_paths or []
+    path = policyd_dir_for(service)
+    hookenv.log("Cleaning path: {}".format(path), level=hookenv.DEBUG)
+    if not os.path.exists(path):
+        ch_host.mkdir(path, owner=_user, group=_group, perms=0o775)
+    _scanner = os.scandir if hasattr(os, 'scandir') else _fallback_scandir
+    for direntry in _scanner(path):
+        # see if the path should be kept.
+        if direntry.path in keep_paths:
+            continue
+        # we remove any directories; it's ours and there shouldn't be any
+        if direntry.is_dir():
+            shutil.rmtree(direntry.path)
+        else:
+            os.remove(direntry.path)
+
+
+def maybe_create_directory_for(path, user, group):
+    """For the filename 'path', ensure that the directory for that path exists.
+
+    Note that if the directory already exists then the permissions are NOT
+    changed.
+
+    :param path: the filename including the path to it.
+    :type path: str
+    :param user: the user to create the directory as
+    :param group: the group to create the directory as
+    """
+    _dir, _ = os.path.split(path)
+    if not os.path.exists(_dir):
+        ch_host.mkdir(_dir, owner=user, group=group, perms=0o775)
+
+
+@contextlib.contextmanager
+def _fallback_scandir(path):
+    """Fallback os.scandir implementation.
+
+    provide a fallback implementation of os.scandir if this module ever gets
+    used in a py2 or py34 charm. Uses os.listdir() to get the names in the path,
+    and then mocks the is_dir() function using os.path.isdir() to check for
+    directory.
+
+    :param path: the path to list the directories for
+    :type path: str
+    :returns: Generator that provides _FBDirectory objects
+    :rtype: ContextManager[_FBDirectory]
+    """
+    for f in os.listdir(path):
+        yield _FBDirectory(f)
+
+
+class _FBDirectory(object):
+    """Mock a scandir Directory object with enough to use in
+    clean_policyd_dir_for
+    """
+
+    def __init__(self, path):
+        self.path = path
+
+    def is_dir(self):
+        return os.path.isdir(self.path)
+
+
+def path_for_policy_file(service, name):
+    """Return the full path for a policy.d file that will be written to the
+    service's policy.d directory.
+
+    It is constructed using policyd_dir_for(), the name and the ".yaml"
+    extension.
+
+    For horizon, for example, it's a bit more complicated.  The name param is
+    actually "override_service_dir/a_name", where target_service needs to be
+    one the allowed horizon override services.  This translation and check is
+    done in the _yamlfiles() function.
+
+    :param service: the service name
+    :type service: str
+    :param name: the name for the policy override
+    :type name: str
+    :returns: the full path name for the file
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join(policyd_dir_for(service), name + ".yaml")
+
+
+def _policy_success_file():
+    """Return the file name for a successful drop of policy.d overrides
+
+    :returns: the path name for the file.
+    :rtype: str
+    """
+    return os.path.join(hookenv.charm_dir(), POLICYD_SUCCESS_FILENAME)
+
+
+def remove_policy_success_file():
+    """Remove the file that indicates successful policyd override."""
+    try:
+        os.remove(_policy_success_file())
+    except Exception:
+        pass
+
+
+def set_policy_success_file():
+    """Set the file that indicates successful policyd override."""
+    open(_policy_success_file(), "w").close()
+
+
+def is_policy_success_file_set():
+    """Returns True if the policy success file has been set.
+
+    This indicates that policies are overridden and working properly.
+
+    :returns: True if the policy file is set
+    :rtype: bool
+    """
+    return os.path.isfile(_policy_success_file())
+
+
+def policyd_status_message_prefix():
+    """Return the prefix str for the status line.
+
+    "PO:" indicating that the policy overrides are in place, or "PO (broken):"
+    if the policy is supposed to be working but there is no success file.
+
+    :returns: the prefix
+    :rtype: str
+    """
+    if is_policy_success_file_set():
+        return "PO:"
+    return "PO (broken):"
+
+
+def process_policy_resource_file(resource_file,
+                                 service,
+                                 blacklist_paths=None,
+                                 blacklist_keys=None,
+                                 template_function=None,
+                                 preserve_topdir=False,
+                                 preprocess_filename=None,
+                                 user=None,
+                                 group=None):
+    """Process the resource file (which should contain at least one yaml file)
+    and write those files to the service's policy.d directory.
+
+    The optional template_function is a function that accepts a python
+    string and has an opportunity to modify the document
+    prior to it being read by the yaml.safe_load() function and written to
+    disk. Note that this function does *not* say how the templating is done -
+    this is up to the charm to implement its chosen method.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The yaml filename can be modified in two ways.  If the `preserve_topdir`
+    param is True, then files will be flattened to the top dir.  This allows
+    for creating sets of files that can be grouped into a single level tree
+    structure.
+
+    Secondly, if the `preprocess_filename` param is not None and callable()
+    then the name is passed to that function for preprocessing before being
+    converted to the end location.  This is to allow munging of the filename
+    prior to being tested for a blacklist path.
+
+    If any error occurs, then the policy.d directory is cleared, the error is
+    written to the log, and the status line will eventually show as failed.
+
+    :param resource_file: The zipped file to open and extract yaml files form.
+    :type resource_file: Union[AnyStr, os.PathLike[AnyStr]]
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the yaml
+                              document.
+    :type template_function: Union[None, Callable[[AnyStr], AnyStr]]
+    :param preserve_topdir: Keep the toplevel subdir
+    :type preserve_topdir: bool
+    :param preprocess_filename: Optional function to use to process filenames
+                                extracted from the resource file.
+    :type preprocess_filename: Union[None, Callable[[AnyStr]. AnyStr]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :returns: True if the processing was successful, False if not.
+    :rtype: boolean
+    """
+    hookenv.log("Running process_policy_resource_file", level=hookenv.DEBUG)
+    blacklist_paths = blacklist_paths or []
+    completed = False
+    _preprocess = None
+    if preprocess_filename is not None and callable(preprocess_filename):
+        _preprocess = preprocess_filename
+    _user = service if user is None else user
+    _group = service if group is None else group
+    try:
+        with open_and_filter_yaml_files(
+                resource_file, preserve_topdir) as (zfp, gen):
+            # first clear out the policy.d directory and clear success
+            remove_policy_success_file()
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            for name, ext, filename, zipinfo in gen:
+                # See if the name should be preprocessed.
+                if _preprocess is not None:
+                    name = _preprocess(name)
+                # construct a name for the output file.
+                yaml_filename = path_for_policy_file(service, name)
+                if yaml_filename in blacklist_paths:
+                    raise BadPolicyZipFile("policy.d name {} is blacklisted"
+                                           .format(yaml_filename))
+                with zfp.open(zipinfo) as fp:
+                    doc = fp.read()
+                    # if template_function is not None, then offer the document
+                    # to the template function
+                    if ext in POLICYD_TEMPLATE_EXTS:
+                        if (template_function is None or not
+                                callable(template_function)):
+                            raise BadPolicyZipFile(
+                                "Template {} but no template_function is "
+                                "available".format(filename))
+                        doc = template_function(doc)
+                    yaml_doc = read_and_validate_yaml(doc, blacklist_keys)
+                # we may have to create the directory
+                maybe_create_directory_for(yaml_filename, _user, _group)
+                ch_host.write_file(yaml_filename,
+                                   yaml.dump(yaml_doc).encode('utf-8'),
+                                   _user,
+                                   _group)
+        # Every thing worked, so we mark up a success.
+        completed = True
+    except (BadZipFile, BadPolicyZipFile, BadPolicyYamlFile) as e:
+        hookenv.log("Processing {} failed: {}".format(resource_file, str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+    except IOError as e:
+        # technically this shouldn't happen; it would be a programming error as
+        # the filename comes from Juju and thus, should exist.
+        hookenv.log(
+            "File {} failed with IOError.  This really shouldn't happen"
+            " -- error: {}".format(resource_file, str(e)),
+            level=POLICYD_LOG_LEVEL_DEFAULT)
+    except Exception as e:
+        import traceback
+        hookenv.log("General Exception({}) during policyd processing"
+                    .format(str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        hookenv.log(traceback.format_exc())
+    finally:
+        if not completed:
+            hookenv.log("Processing {} failed: cleaning policy.d directory"
+                        .format(resource_file),
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+        else:
+            # touch the success filename
+            hookenv.log("policy.d overrides installed.",
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            set_policy_success_file()
+        return completed
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ssh_migrations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ssh_migrations.py
new file mode 100644
index 0000000000000000000000000000000000000000..96b9f71d42d1c81539f78b8e1c4761f81d84c304
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/ssh_migrations.py
@@ -0,0 +1,412 @@
+# Copyright 2018 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    ERROR,
+    log,
+    relation_get,
+)
+from charmhelpers.contrib.network.ip import (
+    is_ipv6,
+    ns_query,
+)
+from charmhelpers.contrib.openstack.utils import (
+    get_hostname,
+    get_host_ip,
+    is_ip,
+)
+
+NOVA_SSH_DIR = '/etc/nova/compute_ssh/'
+
+
+def ssh_directory_for_unit(application_name, user=None):
+    """Return the directory used to store ssh assets for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified directory path.
+    :rtype: str
+    """
+    if user:
+        application_name = "{}_{}".format(application_name, user)
+    _dir = os.path.join(NOVA_SSH_DIR, application_name)
+    for d in [NOVA_SSH_DIR, _dir]:
+        if not os.path.isdir(d):
+            os.mkdir(d)
+    for f in ['authorized_keys', 'known_hosts']:
+        f = os.path.join(_dir, f)
+        if not os.path.isfile(f):
+            open(f, 'w').close()
+    return _dir
+
+
+def known_hosts(application_name, user=None):
+    """Return the known hosts file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'known_hosts')
+
+
+def authorized_keys(application_name, user=None):
+    """Return the authorized keys file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'authorized_keys')
+
+
+def ssh_known_host_key(host, application_name, user=None):
+    """Return the first entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Host key
+    :rtype: str or None
+    """
+    cmd = [
+        'ssh-keygen',
+        '-f', known_hosts(application_name, user),
+        '-H',
+        '-F',
+        host]
+    try:
+        # The first line of output is like '# Host xx found: line 1 type RSA',
+        # which should be excluded.
+        output = subprocess.check_output(cmd)
+    except subprocess.CalledProcessError as e:
+        # RC of 1 seems to be legitimate for most ssh-keygen -F calls.
+        if e.returncode == 1:
+            output = e.output
+        else:
+            raise
+    output = output.strip()
+
+    if output:
+        # Bug #1500589 cmd has 0 rc on precise if entry not present
+        lines = output.split('\n')
+        if len(lines) >= 1:
+            return lines[0]
+
+    return None
+
+
+def remove_known_host(host, application_name, user=None):
+    """Remove the entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    log('Removing SSH known host entry for compute host at %s' % host)
+    cmd = ['ssh-keygen', '-f', known_hosts(application_name, user), '-R', host]
+    subprocess.check_call(cmd)
+
+
+def is_same_key(key_1, key_2):
+    """Extract the key from two host entries and compare them.
+
+    :param key_1: Host key
+    :type key_1: str
+    :param key_2: Host key
+    :type key_2: str
+    """
+    # The key format get will be like '|1|2rUumCavEXWVaVyB5uMl6m85pZo=|Cp'
+    # 'EL6l7VTY37T/fg/ihhNb/GPgs= ssh-rsa AAAAB', we only need to compare
+    # the part start with 'ssh-rsa' followed with '= ', because the hash
+    # value in the beginning will change each time.
+    k_1 = key_1.split('= ')[1]
+    k_2 = key_2.split('= ')[1]
+    return k_1 == k_2
+
+
+def add_known_host(host, application_name, user=None):
+    """Add the given host key to the known hosts file.
+
+    :param host: host name
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    cmd = ['ssh-keyscan', '-H', '-t', 'rsa', host]
+    try:
+        remote_key = subprocess.check_output(cmd).strip()
+    except Exception as e:
+        log('Could not obtain SSH host key from %s' % host, level=ERROR)
+        raise e
+
+    current_key = ssh_known_host_key(host, application_name, user)
+    if current_key and remote_key:
+        if is_same_key(remote_key, current_key):
+            log('Known host key for compute host %s up to date.' % host)
+            return
+        else:
+            remove_known_host(host, application_name, user)
+
+    log('Adding SSH host key to known hosts for compute node at %s.' % host)
+    with open(known_hosts(application_name, user), 'a') as out:
+        out.write("{}\n".format(remote_key))
+
+
+def ssh_authorized_key_exists(public_key, application_name, user=None):
+    """Check if given key is in the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Whether given key is in the authorized_key file.
+    :rtype: boolean
+    """
+    with open(authorized_keys(application_name, user)) as keys:
+        return ('%s' % public_key) in keys.read()
+
+
+def add_authorized_key(public_key, application_name, user=None):
+    """Add given key to the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    with open(authorized_keys(application_name, user), 'a') as keys:
+        keys.write("{}\n".format(public_key))
+
+
+def ssh_compute_add_host_and_key(public_key, hostname, private_address,
+                                 application_name, user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param hostname: Hostname to collect host keys from.
+    :type hostname: str
+    :param private_address:aCorresponding private address for hostname
+    :type private_address: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    # If remote compute node hands us a hostname, ensure we have a
+    # known hosts entry for its IP, hostname and FQDN.
+    hosts = [private_address]
+
+    if not is_ipv6(private_address):
+        if hostname:
+            hosts.append(hostname)
+
+        if is_ip(private_address):
+            hn = get_hostname(private_address)
+            if hn:
+                hosts.append(hn)
+                short = hn.split('.')[0]
+                if ns_query(short):
+                    hosts.append(short)
+        else:
+            hosts.append(get_host_ip(private_address))
+            short = private_address.split('.')[0]
+            if ns_query(short):
+                hosts.append(short)
+
+    for host in list(set(hosts)):
+        add_known_host(host, application_name, user)
+
+    if not ssh_authorized_key_exists(public_key, application_name, user):
+        log('Saving SSH authorized key for compute host at %s.' %
+            private_address)
+        add_authorized_key(public_key, application_name, user)
+
+
+def ssh_compute_add(public_key, application_name, rid=None, unit=None,
+                    user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param rid: Relation id of the relation between this charm and the app. If
+                none is supplied it is assumed its the relation relating to
+                the current hook context.
+    :type rid: str
+    :param unit: Unit to add ssh asserts for if none is supplied it is assumed
+                 its the unit relating to the current hook context.
+    :type unit: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    relation_data = relation_get(rid=rid, unit=unit)
+    ssh_compute_add_host_and_key(
+        public_key,
+        relation_data.get('hostname'),
+        relation_data.get('private-address'),
+        application_name,
+        user=user)
+
+
+def ssh_known_hosts_lines(application_name, user=None):
+    """Return contents of known_hosts file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    known_hosts_list = []
+    with open(known_hosts(application_name, user)) as hosts:
+        for hosts_line in hosts:
+            if hosts_line.rstrip():
+                known_hosts_list.append(hosts_line.rstrip())
+    return(known_hosts_list)
+
+
+def ssh_authorized_keys_lines(application_name, user=None):
+    """Return contents of authorized_keys file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    authorized_keys_list = []
+
+    with open(authorized_keys(application_name, user)) as keys:
+        for authkey_line in keys:
+            if authkey_line.rstrip():
+                authorized_keys_list.append(authkey_line.rstrip())
+    return(authorized_keys_list)
+
+
+def ssh_compute_remove(public_key, application_name, user=None):
+    """Remove given public key from authorized_keys file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    if not (os.path.isfile(authorized_keys(application_name, user)) or
+            os.path.isfile(known_hosts(application_name, user))):
+        return
+
+    keys = ssh_authorized_keys_lines(application_name, user=None)
+    keys = [k.strip() for k in keys]
+
+    if public_key not in keys:
+        return
+
+    [keys.remove(key) for key in keys if key == public_key]
+
+    with open(authorized_keys(application_name, user), 'w') as _keys:
+        keys = '\n'.join(keys)
+        if not keys.endswith('\n'):
+            keys += '\n'
+        _keys.write(keys)
+
+
+def get_ssh_settings(application_name, user=None):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for the
+    app + user combination.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = {}
+    keys = {}
+    prefix = ''
+    if user:
+        prefix = '{}_'.format(user)
+
+    for i, line in enumerate(ssh_known_hosts_lines(
+            application_name=application_name, user=user)):
+        settings['{}known_hosts_{}'.format(prefix, i)] = line
+    if settings:
+        settings['{}known_hosts_max_index'.format(prefix)] = len(
+            settings.keys())
+
+    for i, line in enumerate(ssh_authorized_keys_lines(
+            application_name=application_name, user=user)):
+        keys['{}authorized_keys_{}'.format(prefix, i)] = line
+    if keys:
+        keys['{}authorized_keys_max_index'.format(prefix)] = len(keys.keys())
+    settings.update(keys)
+    return settings
+
+
+def get_all_user_ssh_settings(application_name):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for root user
+    and nova user.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = get_ssh_settings(application_name)
+    settings.update(get_ssh_settings(application_name, user='nova'))
+    return settings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/ceph.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/ceph.conf
new file mode 100644
index 0000000000000000000000000000000000000000..a11ce8ab85654a4d838e448f36fe3698b59f9531
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/ceph.conf
@@ -0,0 +1,24 @@
+###############################################################################
+# [ WARNING ]
+# ceph configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+[global]
+{% if auth -%}
+auth_supported = {{ auth }}
+keyring = /etc/ceph/$cluster.$name.keyring
+mon host = {{ mon_hosts }}
+{% endif -%}
+log to syslog = {{ use_syslog }}
+err to syslog = {{ use_syslog }}
+clog to syslog = {{ use_syslog }}
+{% if rbd_features %}
+rbd default features = {{ rbd_features }}
+{% endif %}
+
+[client]
+{% if rbd_client_cache_settings -%}
+{% for key, value in rbd_client_cache_settings.items() -%}
+{{ key }} = {{ value }}
+{% endfor -%}
+{%- endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/git.upstart b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/git.upstart
new file mode 100644
index 0000000000000000000000000000000000000000..4bed404bc01087c4dec6a44a56d17ed122e1d1e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/git.upstart
@@ -0,0 +1,17 @@
+description "{{ service_description }}"
+author "Juju {{ service_name }} Charm <juju@localhost>"
+
+start on runlevel [2345]
+stop on runlevel [!2345]
+
+respawn
+
+exec start-stop-daemon --start --chuid {{ user_name }} \
+            --chdir {{ start_dir }} --name {{ process_name }} \
+            --exec {{ executable_name }} -- \
+            {% for config_file in config_files -%}
+            --config-file={{ config_file }} \
+            {% endfor -%}
+            {% if log_file -%}
+            --log-file={{ log_file }}
+            {% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..d36af2aa86f91b2ee1249594fffd106843dd0676
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/haproxy.cfg
@@ -0,0 +1,77 @@
+global
+    log /var/lib/haproxy/dev/log local0
+    log /var/lib/haproxy/dev/log local1 notice
+    maxconn 20000
+    user haproxy
+    group haproxy
+    spread-checks 0
+    stats socket /var/run/haproxy/admin.sock mode 600 level admin
+    stats timeout 2m
+
+defaults
+    log global
+    mode tcp
+    option tcplog
+    option dontlognull
+    retries 3
+{%- if haproxy_queue_timeout %}
+    timeout queue {{ haproxy_queue_timeout }}
+{%- else %}
+    timeout queue 9000
+{%- endif %}
+{%- if haproxy_connect_timeout %}
+    timeout connect {{ haproxy_connect_timeout }}
+{%- else %}
+    timeout connect 9000
+{%- endif %}
+{%- if haproxy_client_timeout %}
+    timeout client {{ haproxy_client_timeout }}
+{%- else %}
+    timeout client 90000
+{%- endif %}
+{%- if haproxy_server_timeout %}
+    timeout server {{ haproxy_server_timeout }}
+{%- else %}
+    timeout server 90000
+{%- endif %}
+
+listen stats
+    bind {{ local_host }}:{{ stat_port }}
+    mode http
+    stats enable
+    stats hide-version
+    stats realm Haproxy\ Statistics
+    stats uri /
+    stats auth admin:{{ stat_password }}
+
+{% if frontends -%}
+{% for service, ports in service_ports.items() -%}
+frontend tcp-in_{{ service }}
+    bind *:{{ ports[0] }}
+    {% if ipv6_enabled -%}
+    bind :::{{ ports[0] }}
+    {% endif -%}
+    {% for frontend in frontends -%}
+    acl net_{{ frontend }} dst {{ frontends[frontend]['network'] }}
+    use_backend {{ service }}_{{ frontend }} if net_{{ frontend }}
+    {% endfor -%}
+    default_backend {{ service }}_{{ default_backend }}
+
+{% for frontend in frontends -%}
+backend {{ service }}_{{ frontend }}
+    balance leastconn
+    {% if backend_options -%}
+    {% if backend_options[service] -%}
+    {% for option in backend_options[service] -%}
+    {% for key, value in option.items() -%}
+    {{ key }} {{ value }}
+    {% endfor -%}
+    {% endfor -%}
+    {% endif -%}
+    {% endif -%}
+    {% for unit, address in frontends[frontend]['backends'].items() -%}
+    server {{ unit }} {{ address }}:{{ ports[1] }} check
+    {% endfor %}
+{% endfor -%}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/logrotate b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/logrotate
new file mode 100644
index 0000000000000000000000000000000000000000..b2900d09a4ec2d04152ed7ce25bdc7346c349675
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/logrotate
@@ -0,0 +1,9 @@
+/var/log/{{ logrotate_logs_location }}/*.log {
+    {{ logrotate_interval }}
+    {{ logrotate_count }}
+    compress
+    delaycompress
+    missingok
+    notifempty
+    copytruncate
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/memcached.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/memcached.conf
new file mode 100644
index 0000000000000000000000000000000000000000..26cb037c72beccdb1a4f9269844abdbac2406369
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/memcached.conf
@@ -0,0 +1,53 @@
+###############################################################################
+# [ WARNING ]
+# memcached configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+
+# memcached default config file
+# 2003 - Jay Bonci <jaybonci@debian.org>
+# This configuration file is read by the start-memcached script provided as
+# part of the Debian GNU/Linux distribution.
+
+# Run memcached as a daemon. This command is implied, and is not needed for the
+# daemon to run. See the README.Debian that comes with this package for more
+# information.
+-d
+
+# Log memcached's output to /var/log/memcached
+logfile /var/log/memcached.log
+
+# Be verbose
+# -v
+
+# Be even more verbose (print client commands as well)
+# -vv
+
+# Start with a cap of 64 megs of memory. It's reasonable, and the daemon default
+# Note that the daemon will grow to this size, but does not start out holding this much
+# memory
+-m 64
+
+# Default connection port is 11211
+-p {{ memcache_port }}
+
+# Run the daemon as root. The start-memcached will default to running as root if no
+# -u command is present in this config file
+-u memcache
+
+# Specify which IP address to listen on. The default is to listen on all IP addresses
+# This parameter is one of the only security measures that memcached has, so make sure
+# it's listening on a firewalled interface.
+-l {{ memcache_server }}
+
+# Limit the number of simultaneous incoming connections. The daemon default is 1024
+# -c 1024
+
+# Lock down all paged memory. Consult with the README and homepage before you do this
+# -k
+
+# Return error when memory is exhausted (rather than removing items)
+# -M
+
+# Maximize core file limit
+# -r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
new file mode 100644
index 0000000000000000000000000000000000000000..5dcebe7c863728b040337616b492296f536b3ef3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
@@ -0,0 +1,12 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_plugin = password
+project_domain_id = default
+user_domain_id = default
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
new file mode 100644
index 0000000000000000000000000000000000000000..9356b2be4e7dabe089b4d7d39793146bb92f3f48
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
@@ -0,0 +1,10 @@
+{% if auth_host -%}
+[keystone_authtoken]
+# Juno specific config (Bug #1557223)
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/{{ service_admin_prefix }}
+identity_uri = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+admin_tenant_name = {{ admin_tenant_name }}
+admin_user = {{ admin_user }}
+admin_password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
new file mode 100644
index 0000000000000000000000000000000000000000..c281868b16a885cd01a234984974af0349a5d242
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
@@ -0,0 +1,22 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_type = password
+{% if api_version == "3" -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/v3
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}/v3
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
new file mode 100644
index 0000000000000000000000000000000000000000..d26a91fe1f00e2b12d094be727a53eddc87b829d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
@@ -0,0 +1,9 @@
+{% if auth_host -%}
+[keystone_authtoken]
+{% for option_name, option_value in keystone_authtoken.items() -%}
+{{ option_name }} = {{ option_value }}
+{% endfor -%}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache
new file mode 100644
index 0000000000000000000000000000000000000000..e056a32aafe32413cefb40b9414d064f2b0c8fd2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-cache
@@ -0,0 +1,6 @@
+[cache]
+{% if memcache_url %}
+enabled = true
+backend = oslo_cache.memcache_pool
+memcache_servers = {{ memcache_url }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
new file mode 100644
index 0000000000000000000000000000000000000000..bed2216aba7217022ded17dec4cdb0871f513b40
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
new file mode 100644
index 0000000000000000000000000000000000000000..365f43757719b2de3c601ea6a9752dac8a8b3545
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware
new file mode 100644
index 0000000000000000000000000000000000000000..dd73230a42aa037582989979c1bc8132d30b9b38
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-middleware
@@ -0,0 +1,5 @@
+[oslo_middleware]
+
+# Bug #1758675
+enable_proxy_headers_parsing = true
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications
new file mode 100644
index 0000000000000000000000000000000000000000..71c7eb068eace94e8986d7a868bded236f75128c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-oslo-notifications
@@ -0,0 +1,15 @@
+{% if transport_url -%}
+[oslo_messaging_notifications]
+driver = {{ oslo_messaging_driver }}
+transport_url = {{ transport_url }}
+{% if send_notifications_to_logs %}
+driver = log
+{% endif %}
+{% if notification_topics -%}
+topics = {{ notification_topics }}
+{% endif -%}
+{% if notification_format -%}
+[notifications]
+notification_format = {{ notification_format }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-placement b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-placement
new file mode 100644
index 0000000000000000000000000000000000000000..97724bdb5af6e0352d0b920600d7cbbc8318fa7c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-placement
@@ -0,0 +1,19 @@
+[placement]
+{% if auth_host -%}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_type = password
+{% if api_version == "3" -%}
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+{% endif -%}
+{% if region -%}
+os_region_name = {{ region }}
+{% endif -%}
+randomize_allocation_candidates = true
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
new file mode 100644
index 0000000000000000000000000000000000000000..b444c9c99bd179eaa0be31af462576e4ca9c45b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
@@ -0,0 +1,22 @@
+{% if rabbitmq_host or rabbitmq_hosts -%}
+[oslo_messaging_rabbit]
+rabbit_userid = {{ rabbitmq_user }}
+rabbit_virtual_host = {{ rabbitmq_virtual_host }}
+rabbit_password = {{ rabbitmq_password }}
+{% if rabbitmq_hosts -%}
+rabbit_hosts = {{ rabbitmq_hosts }}
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+rabbit_durable_queues = False
+{% endif -%}
+{% else -%}
+rabbit_host = {{ rabbitmq_host }}
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+rabbit_port = {{ rabbit_ssl_port }}
+{% if rabbit_ssl_ca -%}
+kombu_ssl_ca_certs = {{ rabbit_ssl_ca }}
+{% endif -%}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-zeromq b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-zeromq
new file mode 100644
index 0000000000000000000000000000000000000000..95f1a76ce87f9babdcba58da79c68d34c2776eea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/section-zeromq
@@ -0,0 +1,14 @@
+{% if zmq_host -%}
+# ZeroMQ configuration (restart-nonce: {{ zmq_nonce }})
+rpc_backend = zmq
+rpc_zmq_host = {{ zmq_host }}
+{% if zmq_redis_address -%}
+rpc_zmq_matchmaker = redis
+matchmaker_heartbeat_freq = 15
+matchmaker_heartbeat_ttl = 30
+[matchmaker_redis]
+host = {{ zmq_redis_address }}
+{% else -%}
+rpc_zmq_matchmaker = ring
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/vendor_data.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/vendor_data.json
new file mode 100644
index 0000000000000000000000000000000000000000..904f612a7f74490d4508920400d18d493d056477
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/vendor_data.json
@@ -0,0 +1 @@
+{{ vendor_data_json }}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..050f8af5c9135db4fafdbf5098edcd22c7157ff8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/templating.py
@@ -0,0 +1,379 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import six
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+    INFO,
+    TRACE
+)
+from charmhelpers.contrib.openstack.utils import OPENSTACK_CODENAMES
+
+try:
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+
+
+class OSConfigException(Exception):
+    pass
+
+
+def get_loader(templates_dir, os_release):
+    """
+    Create a jinja2.ChoiceLoader containing template dirs up to
+    and including os_release.  If directory template directory
+    is missing at templates_dir, it will be omitted from the loader.
+    templates_dir is added to the bottom of the search list as a base
+    loading dir.
+
+    A charm may also ship a templates dir with this module
+    and it will be appended to the bottom of the search list, eg::
+
+        hooks/charmhelpers/contrib/openstack/templates
+
+    :param templates_dir (str): Base template directory containing release
+        sub-directories.
+    :param os_release (str): OpenStack release codename to construct template
+        loader.
+    :returns: jinja2.ChoiceLoader constructed with a list of
+        jinja2.FilesystemLoaders, ordered in descending
+        order by OpenStack release.
+    """
+    tmpl_dirs = [(rel, os.path.join(templates_dir, rel))
+                 for rel in six.itervalues(OPENSTACK_CODENAMES)]
+
+    if not os.path.isdir(templates_dir):
+        log('Templates directory not found @ %s.' % templates_dir,
+            level=ERROR)
+        raise OSConfigException
+
+    # the bottom contains tempaltes_dir and possibly a common templates dir
+    # shipped with the helper.
+    loaders = [FileSystemLoader(templates_dir)]
+    helper_templates = os.path.join(os.path.dirname(__file__), 'templates')
+    if os.path.isdir(helper_templates):
+        loaders.append(FileSystemLoader(helper_templates))
+
+    for rel, tmpl_dir in tmpl_dirs:
+        if os.path.isdir(tmpl_dir):
+            loaders.insert(0, FileSystemLoader(tmpl_dir))
+        if rel == os_release:
+            break
+    # demote this log to the lowest level; we don't really need to see these
+    # lots in production even when debugging.
+    log('Creating choice loader with dirs: %s' %
+        [l.searchpath for l in loaders], level=TRACE)
+    return ChoiceLoader(loaders)
+
+
+class OSConfigTemplate(object):
+    """
+    Associates a config file template with a list of context generators.
+    Responsible for constructing a template context based on those generators.
+    """
+
+    def __init__(self, config_file, contexts, config_template=None):
+        self.config_file = config_file
+
+        if hasattr(contexts, '__call__'):
+            self.contexts = [contexts]
+        else:
+            self.contexts = contexts
+
+        self._complete_contexts = []
+
+        self.config_template = config_template
+
+    def context(self):
+        ctxt = {}
+        for context in self.contexts:
+            _ctxt = context()
+            if _ctxt:
+                ctxt.update(_ctxt)
+                # track interfaces for every complete context.
+                [self._complete_contexts.append(interface)
+                 for interface in context.interfaces
+                 if interface not in self._complete_contexts]
+        return ctxt
+
+    def complete_contexts(self):
+        '''
+        Return a list of interfaces that have satisfied contexts.
+        '''
+        if self._complete_contexts:
+            return self._complete_contexts
+        self.context()
+        return self._complete_contexts
+
+    @property
+    def is_string_template(self):
+        """:returns: Boolean if this instance is a template initialised with a string"""
+        return self.config_template is not None
+
+
+class OSConfigRenderer(object):
+    """
+    This class provides a common templating system to be used by OpenStack
+    charms.  It is intended to help charms share common code and templates,
+    and ease the burden of managing config templates across multiple OpenStack
+    releases.
+
+    Basic usage::
+
+        # import some common context generates from charmhelpers
+        from charmhelpers.contrib.openstack import context
+
+        # Create a renderer object for a specific OS release.
+        configs = OSConfigRenderer(templates_dir='/tmp/templates',
+                                   openstack_release='folsom')
+        # register some config files with context generators.
+        configs.register(config_file='/etc/nova/nova.conf',
+                         contexts=[context.SharedDBContext(),
+                                   context.AMQPContext()])
+        configs.register(config_file='/etc/nova/api-paste.ini',
+                         contexts=[context.IdentityServiceContext()])
+        configs.register(config_file='/etc/haproxy/haproxy.conf',
+                         contexts=[context.HAProxyContext()])
+        configs.register(config_file='/etc/keystone/policy.d/extra.cfg',
+                         contexts=[context.ExtraPolicyContext()
+                                   context.KeystoneContext()],
+                         config_template=hookenv.config('extra-policy'))
+        # write out a single config
+        configs.write('/etc/nova/nova.conf')
+        # write out all registered configs
+        configs.write_all()
+
+    **OpenStack Releases and template loading**
+
+    When the object is instantiated, it is associated with a specific OS
+    release.  This dictates how the template loader will be constructed.
+
+    The constructed loader attempts to load the template from several places
+    in the following order:
+    - from the most recent OS release-specific template dir (if one exists)
+    - the base templates_dir
+    - a template directory shipped in the charm with this helper file.
+
+    For the example above, '/tmp/templates' contains the following structure::
+
+        /tmp/templates/nova.conf
+        /tmp/templates/api-paste.ini
+        /tmp/templates/grizzly/api-paste.ini
+        /tmp/templates/havana/api-paste.ini
+
+    Since it was registered with the grizzly release, it first searches
+    the grizzly directory for nova.conf, then the templates dir.
+
+    When writing api-paste.ini, it will find the template in the grizzly
+    directory.
+
+    If the object were created with folsom, it would fall back to the
+    base templates dir for its api-paste.ini template.
+
+    This system should help manage changes in config files through
+    openstack releases, allowing charms to fall back to the most recently
+    updated config template for a given release
+
+    The haproxy.conf, since it is not shipped in the templates dir, will
+    be loaded from the module directory's template directory, eg
+    $CHARM/hooks/charmhelpers/contrib/openstack/templates.  This allows
+    us to ship common templates (haproxy, apache) with the helpers.
+
+    **Context generators**
+
+    Context generators are used to generate template contexts during hook
+    execution.  Doing so may require inspecting service relations, charm
+    config, etc.  When registered, a config file is associated with a list
+    of generators.  When a template is rendered and written, all context
+    generates are called in a chain to generate the context dictionary
+    passed to the jinja2 template. See context.py for more info.
+    """
+    def __init__(self, templates_dir, openstack_release):
+        if not os.path.isdir(templates_dir):
+            log('Could not locate templates dir %s' % templates_dir,
+                level=ERROR)
+            raise OSConfigException
+
+        self.templates_dir = templates_dir
+        self.openstack_release = openstack_release
+        self.templates = {}
+        self._tmpl_env = None
+
+        if None in [Environment, ChoiceLoader, FileSystemLoader]:
+            # if this code is running, the object is created pre-install hook.
+            # jinja2 shouldn't get touched until the module is reloaded on next
+            # hook execution, with proper jinja2 bits successfully imported.
+            if six.PY2:
+                apt_install('python-jinja2')
+            else:
+                apt_install('python3-jinja2')
+
+    def register(self, config_file, contexts, config_template=None):
+        """
+        Register a config file with a list of context generators to be called
+        during rendering.
+        config_template can be used to load a template from a string instead of
+        using template loaders and template files.
+        :param config_file (str): a path where a config file will be rendered
+        :param contexts (list): a list of context dictionaries with kv pairs
+        :param config_template (str): an optional template string to use
+        """
+        self.templates[config_file] = OSConfigTemplate(
+            config_file=config_file,
+            contexts=contexts,
+            config_template=config_template
+        )
+        log('Registered config file: {}'.format(config_file),
+            level=INFO)
+
+    def _get_tmpl_env(self):
+        if not self._tmpl_env:
+            loader = get_loader(self.templates_dir, self.openstack_release)
+            self._tmpl_env = Environment(loader=loader)
+
+    def _get_template(self, template):
+        self._get_tmpl_env()
+        template = self._tmpl_env.get_template(template)
+        log('Loaded template from {}'.format(template.filename),
+            level=INFO)
+        return template
+
+    def _get_template_from_string(self, ostmpl):
+        '''
+        Get a jinja2 template object from a string.
+        :param ostmpl: OSConfigTemplate to use as a data source.
+        '''
+        self._get_tmpl_env()
+        template = self._tmpl_env.from_string(ostmpl.config_template)
+        log('Loaded a template from a string for {}'.format(
+            ostmpl.config_file),
+            level=INFO)
+        return template
+
+    def render(self, config_file):
+        if config_file not in self.templates:
+            log('Config not registered: {}'.format(config_file), level=ERROR)
+            raise OSConfigException
+
+        ostmpl = self.templates[config_file]
+        ctxt = ostmpl.context()
+
+        if ostmpl.is_string_template:
+            template = self._get_template_from_string(ostmpl)
+            log('Rendering from a string template: '
+                '{}'.format(config_file),
+                level=INFO)
+        else:
+            _tmpl = os.path.basename(config_file)
+            try:
+                template = self._get_template(_tmpl)
+            except exceptions.TemplateNotFound:
+                # if no template is found with basename, try looking
+                # for it using a munged full path, eg:
+                # /etc/apache2/apache2.conf -> etc_apache2_apache2.conf
+                _tmpl = '_'.join(config_file.split('/')[1:])
+                try:
+                    template = self._get_template(_tmpl)
+                except exceptions.TemplateNotFound as e:
+                    log('Could not load template from {} by {} or {}.'
+                        ''.format(
+                            self.templates_dir,
+                            os.path.basename(config_file),
+                            _tmpl
+                        ),
+                        level=ERROR)
+                    raise e
+
+            log('Rendering from template: {}'.format(config_file),
+                level=INFO)
+        return template.render(ctxt)
+
+    def write(self, config_file):
+        """
+        Write a single config file, raises if config file is not registered.
+        """
+        if config_file not in self.templates:
+            log('Config not registered: %s' % config_file, level=ERROR)
+            raise OSConfigException
+
+        _out = self.render(config_file)
+        if six.PY3:
+            _out = _out.encode('UTF-8')
+
+        with open(config_file, 'wb') as out:
+            out.write(_out)
+
+        log('Wrote template %s.' % config_file, level=INFO)
+
+    def write_all(self):
+        """
+        Write out all registered config files.
+        """
+        [self.write(k) for k in six.iterkeys(self.templates)]
+
+    def set_release(self, openstack_release):
+        """
+        Resets the template environment and generates a new template loader
+        based on a the new openstack release.
+        """
+        self._tmpl_env = None
+        self.openstack_release = openstack_release
+        self._get_tmpl_env()
+
+    def complete_contexts(self):
+        '''
+        Returns a list of context interfaces that yield a complete context.
+        '''
+        interfaces = []
+        [interfaces.extend(i.complete_contexts())
+         for i in six.itervalues(self.templates)]
+        return interfaces
+
+    def get_incomplete_context_data(self, interfaces):
+        '''
+        Return dictionary of relation status of interfaces and any missing
+        required context data. Example:
+            {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+             'zeromq-configuration': {'related': False}}
+        '''
+        incomplete_context_data = {}
+
+        for i in six.itervalues(self.templates):
+            for context in i.contexts:
+                for interface in interfaces:
+                    related = False
+                    if interface in context.interfaces:
+                        related = context.get_related()
+                        missing_data = context.missing_data
+                        if missing_data:
+                            incomplete_context_data[interface] = {'missing_data': missing_data}
+                        if related:
+                            if incomplete_context_data.get(interface):
+                                incomplete_context_data[interface].update({'related': True})
+                            else:
+                                incomplete_context_data[interface] = {'related': True}
+                        else:
+                            incomplete_context_data[interface] = {'related': False}
+        return incomplete_context_data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbf0156108537f9caae35e193c346b0e4ee237b9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/utils.py
@@ -0,0 +1,2352 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charms.
+from collections import OrderedDict, namedtuple
+from functools import wraps
+
+import subprocess
+import json
+import os
+import sys
+import re
+import itertools
+import functools
+
+import six
+import traceback
+import uuid
+import yaml
+
+from charmhelpers import deprecate
+
+from charmhelpers.contrib.network import ip
+
+from charmhelpers.core import unitdata
+
+from charmhelpers.core.hookenv import (
+    WORKLOAD_STATES,
+    action_fail,
+    action_set,
+    config,
+    expected_peer_units,
+    expected_related_units,
+    log as juju_log,
+    charm_dir,
+    INFO,
+    ERROR,
+    metadata,
+    related_units,
+    relation_get,
+    relation_id,
+    relation_ids,
+    relation_set,
+    status_set,
+    hook_name,
+    application_version_set,
+    cached,
+    leader_set,
+    leader_get,
+    local_unit,
+)
+
+from charmhelpers.core.strutils import (
+    BasicStringComparator,
+    bool_from_string,
+)
+
+from charmhelpers.contrib.storage.linux.lvm import (
+    deactivate_lvm_volume_group,
+    is_lvm_physical_volume,
+    remove_lvm_physical_volume,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_ipv6_addr,
+    is_ipv6,
+    port_has_listener,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    mounts,
+    umount,
+    service_running,
+    service_pause,
+    service_resume,
+    service_stop,
+    service_start,
+    restart_on_change_helper,
+)
+from charmhelpers.fetch import (
+    apt_cache,
+    import_key as fetch_import_key,
+    add_source as fetch_add_source,
+    SourceConfigError,
+    GPGKeyError,
+    get_upstream_version,
+    filter_missing_packages,
+    ubuntu_apt_pkg as apt,
+)
+
+from charmhelpers.fetch.snap import (
+    snap_install,
+    snap_refresh,
+    valid_snap_channel,
+)
+
+from charmhelpers.contrib.storage.linux.utils import is_block_device, zap_disk
+from charmhelpers.contrib.storage.linux.loopback import ensure_loopback_device
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+from charmhelpers.contrib.openstack.policyd import (
+    policyd_status_message_prefix,
+    POLICYD_CONFIG_NAME,
+)
+
+from charmhelpers.contrib.openstack.ha.utils import (
+    expect_ha,
+)
+
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+
+DISTRO_PROPOSED = ('deb http://archive.ubuntu.com/ubuntu/ %s-proposed '
+                   'restricted main multiverse universe')
+
+OPENSTACK_RELEASES = (
+    'diablo',
+    'essex',
+    'folsom',
+    'grizzly',
+    'havana',
+    'icehouse',
+    'juno',
+    'kilo',
+    'liberty',
+    'mitaka',
+    'newton',
+    'ocata',
+    'pike',
+    'queens',
+    'rocky',
+    'stein',
+    'train',
+    'ussuri',
+)
+
+UBUNTU_OPENSTACK_RELEASE = OrderedDict([
+    ('oneiric', 'diablo'),
+    ('precise', 'essex'),
+    ('quantal', 'folsom'),
+    ('raring', 'grizzly'),
+    ('saucy', 'havana'),
+    ('trusty', 'icehouse'),
+    ('utopic', 'juno'),
+    ('vivid', 'kilo'),
+    ('wily', 'liberty'),
+    ('xenial', 'mitaka'),
+    ('yakkety', 'newton'),
+    ('zesty', 'ocata'),
+    ('artful', 'pike'),
+    ('bionic', 'queens'),
+    ('cosmic', 'rocky'),
+    ('disco', 'stein'),
+    ('eoan', 'train'),
+    ('focal', 'ussuri'),
+])
+
+
+OPENSTACK_CODENAMES = OrderedDict([
+    ('2011.2', 'diablo'),
+    ('2012.1', 'essex'),
+    ('2012.2', 'folsom'),
+    ('2013.1', 'grizzly'),
+    ('2013.2', 'havana'),
+    ('2014.1', 'icehouse'),
+    ('2014.2', 'juno'),
+    ('2015.1', 'kilo'),
+    ('2015.2', 'liberty'),
+    ('2016.1', 'mitaka'),
+    ('2016.2', 'newton'),
+    ('2017.1', 'ocata'),
+    ('2017.2', 'pike'),
+    ('2018.1', 'queens'),
+    ('2018.2', 'rocky'),
+    ('2019.1', 'stein'),
+    ('2019.2', 'train'),
+    ('2020.1', 'ussuri'),
+])
+
+# The ugly duckling - must list releases oldest to newest
+SWIFT_CODENAMES = OrderedDict([
+    ('diablo',
+        ['1.4.3']),
+    ('essex',
+        ['1.4.8']),
+    ('folsom',
+        ['1.7.4']),
+    ('grizzly',
+        ['1.7.6', '1.7.7', '1.8.0']),
+    ('havana',
+        ['1.9.0', '1.9.1', '1.10.0']),
+    ('icehouse',
+        ['1.11.0', '1.12.0', '1.13.0', '1.13.1']),
+    ('juno',
+        ['2.0.0', '2.1.0', '2.2.0']),
+    ('kilo',
+        ['2.2.1', '2.2.2']),
+    ('liberty',
+        ['2.3.0', '2.4.0', '2.5.0']),
+    ('mitaka',
+        ['2.5.0', '2.6.0', '2.7.0']),
+    ('newton',
+        ['2.8.0', '2.9.0', '2.10.0']),
+    ('ocata',
+        ['2.11.0', '2.12.0', '2.13.0']),
+    ('pike',
+        ['2.13.0', '2.15.0']),
+    ('queens',
+        ['2.16.0', '2.17.0']),
+    ('rocky',
+        ['2.18.0', '2.19.0']),
+    ('stein',
+        ['2.20.0', '2.21.0']),
+    ('train',
+        ['2.22.0', '2.23.0']),
+    ('ussuri',
+        ['2.24.0', '2.25.0']),
+])
+
+# >= Liberty version->codename mapping
+PACKAGE_CODENAMES = {
+    'nova-common': OrderedDict([
+        ('12', 'liberty'),
+        ('13', 'mitaka'),
+        ('14', 'newton'),
+        ('15', 'ocata'),
+        ('16', 'pike'),
+        ('17', 'queens'),
+        ('18', 'rocky'),
+        ('19', 'stein'),
+        ('20', 'train'),
+        ('21', 'ussuri'),
+    ]),
+    'neutron-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'cinder-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'keystone': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('17', 'ussuri'),
+    ]),
+    'horizon-common': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+    'ceilometer-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'heat-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'glance-common': OrderedDict([
+        ('11', 'liberty'),
+        ('12', 'mitaka'),
+        ('13', 'newton'),
+        ('14', 'ocata'),
+        ('15', 'pike'),
+        ('16', 'queens'),
+        ('17', 'rocky'),
+        ('18', 'stein'),
+        ('19', 'train'),
+        ('20', 'ussuri'),
+    ]),
+    'openstack-dashboard': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+}
+
+DEFAULT_LOOPBACK_SIZE = '5G'
+
+DB_SERIES_UPGRADING_KEY = 'cluster-series-upgrading'
+
+DB_MAINTENANCE_KEYS = [DB_SERIES_UPGRADING_KEY]
+
+
+class CompareOpenStackReleases(BasicStringComparator):
+    """Provide comparisons of OpenStack releases.
+
+    Use in the form of
+
+    if CompareOpenStackReleases(release) > 'mitaka':
+        # do something with mitaka
+    """
+    _list = OPENSTACK_RELEASES
+
+
+def error_out(msg):
+    juju_log("FATAL ERROR: %s" % msg, level='ERROR')
+    sys.exit(1)
+
+
+def get_installed_semantic_versioned_packages():
+    '''Get a list of installed packages which have OpenStack semantic versioning
+
+    :returns List of installed packages
+    :rtype: [pkg1, pkg2, ...]
+    '''
+    return filter_missing_packages(PACKAGE_CODENAMES.keys())
+
+
+def get_os_codename_install_source(src):
+    '''Derive OpenStack release codename from a given installation source.'''
+    ubuntu_rel = lsb_release()['DISTRIB_CODENAME']
+    rel = ''
+    if src is None:
+        return rel
+    if src in ['distro', 'distro-proposed', 'proposed']:
+        try:
+            rel = UBUNTU_OPENSTACK_RELEASE[ubuntu_rel]
+        except KeyError:
+            e = 'Could not derive openstack release for '\
+                'this Ubuntu release: %s' % ubuntu_rel
+            error_out(e)
+        return rel
+
+    if src.startswith('cloud:'):
+        ca_rel = src.split(':')[1]
+        ca_rel = ca_rel.split('-')[1].split('/')[0]
+        return ca_rel
+
+    # Best guess match based on deb string provided
+    if (src.startswith('deb') or
+            src.startswith('ppa') or
+            src.startswith('snap')):
+        for v in OPENSTACK_CODENAMES.values():
+            if v in src:
+                return v
+
+
+def get_os_version_install_source(src):
+    codename = get_os_codename_install_source(src)
+    return get_os_version_codename(codename)
+
+
+def get_os_codename_version(vers):
+    '''Determine OpenStack codename from version number.'''
+    try:
+        return OPENSTACK_CODENAMES[vers]
+    except KeyError:
+        e = 'Could not determine OpenStack codename for version %s' % vers
+        error_out(e)
+
+
+def get_os_version_codename(codename, version_map=OPENSTACK_CODENAMES):
+    '''Determine OpenStack version number from codename.'''
+    for k, v in six.iteritems(version_map):
+        if v == codename:
+            return k
+    e = 'Could not derive OpenStack version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_os_version_codename_swift(codename):
+    '''Determine OpenStack version number of swift from codename.'''
+    for k, v in six.iteritems(SWIFT_CODENAMES):
+        if k == codename:
+            return v[-1]
+    e = 'Could not derive swift version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_swift_codename(version):
+    '''Determine OpenStack codename that corresponds to swift version.'''
+    codenames = [k for k, v in six.iteritems(SWIFT_CODENAMES) if version in v]
+
+    if len(codenames) > 1:
+        # If more than one release codename contains this version we determine
+        # the actual codename based on the highest available install source.
+        for codename in reversed(codenames):
+            releases = UBUNTU_OPENSTACK_RELEASE
+            release = [k for k, v in six.iteritems(releases) if codename in v]
+            ret = subprocess.check_output(['apt-cache', 'policy', 'swift'])
+            if six.PY3:
+                ret = ret.decode('UTF-8')
+            if codename in ret or release[0] in ret:
+                return codename
+    elif len(codenames) == 1:
+        return codenames[0]
+
+    # NOTE: fallback - attempt to match with just major.minor version
+    match = re.match(r'^(\d+)\.(\d+)', version)
+    if match:
+        major_minor_version = match.group(0)
+        for codename, versions in six.iteritems(SWIFT_CODENAMES):
+            for release_version in versions:
+                if release_version.startswith(major_minor_version):
+                    return codename
+
+    return None
+
+
+def get_os_codename_package(package, fatal=True):
+    '''Derive OpenStack release codename from an installed package.'''
+
+    if snap_install_requested():
+        cmd = ['snap', 'list', package]
+        try:
+            out = subprocess.check_output(cmd)
+            if six.PY3:
+                out = out.decode('UTF-8')
+        except subprocess.CalledProcessError:
+            return None
+        lines = out.split('\n')
+        for line in lines:
+            if package in line:
+                # Second item in list is Version
+                return line.split()[1]
+
+    cache = apt_cache()
+
+    try:
+        pkg = cache[package]
+    except Exception:
+        if not fatal:
+            return None
+        # the package is unknown to the current apt cache.
+        e = 'Could not determine version of package with no installation '\
+            'candidate: %s' % package
+        error_out(e)
+
+    if not pkg.current_ver:
+        if not fatal:
+            return None
+        # package is known, but no version is currently installed.
+        e = 'Could not determine version of uninstalled package: %s' % package
+        error_out(e)
+
+    vers = apt.upstream_version(pkg.current_ver.ver_str)
+    if 'swift' in pkg.name:
+        # Fully x.y.z match for swift versions
+        match = re.match(r'^(\d+)\.(\d+)\.(\d+)', vers)
+    else:
+        # x.y match only for 20XX.X
+        # and ignore patch level for other packages
+        match = re.match(r'^(\d+)\.(\d+)', vers)
+
+    if match:
+        vers = match.group(0)
+
+    # Generate a major version number for newer semantic
+    # versions of openstack projects
+    major_vers = vers.split('.')[0]
+    # >= Liberty independent project versions
+    if (package in PACKAGE_CODENAMES and
+            major_vers in PACKAGE_CODENAMES[package]):
+        return PACKAGE_CODENAMES[package][major_vers]
+    else:
+        # < Liberty co-ordinated project versions
+        try:
+            if 'swift' in pkg.name:
+                return get_swift_codename(vers)
+            else:
+                return OPENSTACK_CODENAMES[vers]
+        except KeyError:
+            if not fatal:
+                return None
+            e = 'Could not determine OpenStack codename for version %s' % vers
+            error_out(e)
+
+
+def get_os_version_package(pkg, fatal=True):
+    '''Derive OpenStack version number from an installed package.'''
+    codename = get_os_codename_package(pkg, fatal=fatal)
+
+    if not codename:
+        return None
+
+    if 'swift' in pkg:
+        vers_map = SWIFT_CODENAMES
+        for cname, version in six.iteritems(vers_map):
+            if cname == codename:
+                return version[-1]
+    else:
+        vers_map = OPENSTACK_CODENAMES
+        for version, cname in six.iteritems(vers_map):
+            if cname == codename:
+                return version
+    # e = "Could not determine OpenStack version for package: %s" % pkg
+    # error_out(e)
+
+
+# Module local cache variable for the os_release.
+_os_rel = None
+
+
+def reset_os_release():
+    '''Unset the cached os_release version'''
+    global _os_rel
+    _os_rel = None
+
+
+def os_release(package, base=None, reset_cache=False, source_key=None):
+    """Returns OpenStack release codename from a cached global.
+
+    If reset_cache then unset the cached os_release version and return the
+    freshly determined version.
+
+    If the codename can not be determined from either an installed package or
+    the installation source, the earliest release supported by the charm should
+    be returned.
+
+    :param package: Name of package to determine release from
+    :type package: str
+    :param base: Fallback codename if endavours to determine from package fail
+    :type base: Optional[str]
+    :param reset_cache: Reset any cached codename value
+    :type reset_cache: bool
+    :param source_key: Name of source configuration option
+                       (default: 'openstack-origin')
+    :type source_key: Optional[str]
+    :returns: OpenStack release codename
+    :rtype: str
+    """
+    source_key = source_key or 'openstack-origin'
+    if not base:
+        base = UBUNTU_OPENSTACK_RELEASE[lsb_release()['DISTRIB_CODENAME']]
+    global _os_rel
+    if reset_cache:
+        reset_os_release()
+    if _os_rel:
+        return _os_rel
+    _os_rel = (
+        get_os_codename_package(package, fatal=False) or
+        get_os_codename_install_source(config(source_key)) or
+        base)
+    return _os_rel
+
+
+@deprecate("moved to charmhelpers.fetch.import_key()", "2017-07", log=juju_log)
+def import_key(keyid):
+    """Import a key, either ASCII armored, or a GPG key id.
+
+    @param keyid: the key in ASCII armor format, or a GPG key id.
+    @raises SystemExit() via sys.exit() on failure.
+    """
+    try:
+        return fetch_import_key(keyid)
+    except GPGKeyError as e:
+        error_out("Could not import key: {}".format(str(e)))
+
+
+def get_source_and_pgp_key(source_and_key):
+    """Look for a pgp key ID or ascii-armor key in the given input.
+
+    :param source_and_key: Sting, "source_spec|keyid" where '|keyid' is
+        optional.
+    :returns (source_spec, key_id OR None) as a tuple.  Returns None for key_id
+        if there was no '|' in the source_and_key string.
+    """
+    try:
+        source, key = source_and_key.split('|', 2)
+        return source, key or None
+    except ValueError:
+        return source_and_key, None
+
+
+@deprecate("use charmhelpers.fetch.add_source() instead.",
+           "2017-07", log=juju_log)
+def configure_installation_source(source_plus_key):
+    """Configure an installation source.
+
+    The functionality is provided by charmhelpers.fetch.add_source()
+    The difference between the two functions is that add_source() signature
+    requires the key to be passed directly, whereas this function passes an
+    optional key by appending '|<key>' to the end of the source specificiation
+    'source'.
+
+    Another difference from add_source() is that the function calls sys.exit(1)
+    if the configuration fails, whereas add_source() raises
+    SourceConfigurationError().  Another difference, is that add_source()
+    silently fails (with a juju_log command) if there is no matching source to
+    configure, whereas this function fails with a sys.exit(1)
+
+    :param source: String_plus_key -- see above for details.
+
+    Note that the behaviour on error is to log the error to the juju log and
+    then call sys.exit(1).
+    """
+    if source_plus_key.startswith('snap'):
+        # Do nothing for snap installs
+        return
+    # extract the key if there is one, denoted by a '|' in the rel
+    source, key = get_source_and_pgp_key(source_plus_key)
+
+    # handle the ordinary sources via add_source
+    try:
+        fetch_add_source(source, key, fail_invalid=True)
+    except SourceConfigError as se:
+        error_out(str(se))
+
+
+def config_value_changed(option):
+    """
+    Determine if config value changed since last call to this function.
+    """
+    hook_data = unitdata.HookData()
+    with hook_data():
+        db = unitdata.kv()
+        current = config(option)
+        saved = db.get(option)
+        db.set(option, current)
+        if saved is None:
+            return False
+        return current != saved
+
+
+def get_endpoint_key(service_name, relation_id, unit_name):
+    """Return the key used to refer to an ep changed notification from a unit.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param relation_id: The id of the relation the unit is on.
+    :type relation_id: str
+    :param unit_name: The name of the unit publishing the notification.
+    :type unit_name: str
+    :returns: The key used to refer to an ep changed notification from a unit
+    :rtype: str
+    """
+    return '{}-{}-{}'.format(
+        service_name,
+        relation_id.replace(':', '_'),
+        unit_name.replace('/', '_'))
+
+
+def get_endpoint_notifications(service_names, rel_name='identity-service'):
+    """Return all notifications for the given services.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: A dict containing the source of the notification and its nonce.
+    :rtype: Dict[str, str]
+    """
+    notifications = {}
+    for rid in relation_ids(rel_name):
+        for unit in related_units(relid=rid):
+            ep_changed_json = relation_get(
+                rid=rid,
+                unit=unit,
+                attribute='ep_changed')
+            if ep_changed_json:
+                ep_changed = json.loads(ep_changed_json)
+                for service in service_names:
+                    if ep_changed.get(service):
+                        key = get_endpoint_key(service, rid, unit)
+                        notifications[key] = ep_changed[service]
+    return notifications
+
+
+def endpoint_changed(service_name, rel_name='identity-service'):
+    """Whether a new notification has been recieved for an endpoint.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: Whether endpoint has changed
+    :rtype: bool
+    """
+    changed = False
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            [service_name],
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            if db.get(key) != nonce:
+                juju_log(('New endpoint change notification found: '
+                          '{}={}').format(key, nonce),
+                         'INFO')
+                changed = True
+                break
+    return changed
+
+
+def save_endpoint_changed_triggers(service_names, rel_name='identity-service'):
+    """Save the enpoint triggers in  db so it can be tracked if they changed.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    """
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            service_names,
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            db.set(key, nonce)
+
+
+def save_script_rc(script_path="scripts/scriptrc", **env_vars):
+    """
+    Write an rc file in the charm-delivered directory containing
+    exported environment variables provided by env_vars. Any charm scripts run
+    outside the juju hook environment can source this scriptrc to obtain
+    updated config information necessary to perform health checks or
+    service changes.
+    """
+    juju_rc_path = "%s/%s" % (charm_dir(), script_path)
+    if not os.path.exists(os.path.dirname(juju_rc_path)):
+        os.mkdir(os.path.dirname(juju_rc_path))
+    with open(juju_rc_path, 'wt') as rc_script:
+        rc_script.write(
+            "#!/bin/bash\n")
+        [rc_script.write('export %s=%s\n' % (u, p))
+         for u, p in six.iteritems(env_vars) if u != "script_path"]
+
+
+def openstack_upgrade_available(package):
+    """
+    Determines if an OpenStack upgrade is available from installation
+    source, based on version of installed package.
+
+    :param package: str: Name of installed package.
+
+    :returns: bool:    : Returns True if configured installation source offers
+                         a newer version of package.
+    """
+
+    src = config('openstack-origin')
+    cur_vers = get_os_version_package(package)
+    if not cur_vers:
+        # The package has not been installed yet do not attempt upgrade
+        return False
+    if "swift" in package:
+        codename = get_os_codename_install_source(src)
+        avail_vers = get_os_version_codename_swift(codename)
+    else:
+        try:
+            avail_vers = get_os_version_install_source(src)
+        except Exception:
+            avail_vers = cur_vers
+    apt.init()
+    return apt.version_compare(avail_vers, cur_vers) >= 1
+
+
+def ensure_block_device(block_device):
+    '''
+    Confirm block_device, create as loopback if necessary.
+
+    :param block_device: str: Full path of block device to ensure.
+
+    :returns: str: Full path of ensured block device.
+    '''
+    _none = ['None', 'none', None]
+    if (block_device in _none):
+        error_out('prepare_storage(): Missing required input: block_device=%s.'
+                  % block_device)
+
+    if block_device.startswith('/dev/'):
+        bdev = block_device
+    elif block_device.startswith('/'):
+        _bd = block_device.split('|')
+        if len(_bd) == 2:
+            bdev, size = _bd
+        else:
+            bdev = block_device
+            size = DEFAULT_LOOPBACK_SIZE
+        bdev = ensure_loopback_device(bdev, size)
+    else:
+        bdev = '/dev/%s' % block_device
+
+    if not is_block_device(bdev):
+        error_out('Failed to locate valid block device at %s' % bdev)
+
+    return bdev
+
+
+def clean_storage(block_device):
+    '''
+    Ensures a block device is clean.  That is:
+        - unmounted
+        - any lvm volume groups are deactivated
+        - any lvm physical device signatures removed
+        - partition table wiped
+
+    :param block_device: str: Full path to block device to clean.
+    '''
+    for mp, d in mounts():
+        if d == block_device:
+            juju_log('clean_storage(): %s is mounted @ %s, unmounting.' %
+                     (d, mp), level=INFO)
+            umount(mp, persist=True)
+
+    if is_lvm_physical_volume(block_device):
+        deactivate_lvm_volume_group(block_device)
+        remove_lvm_physical_volume(block_device)
+    else:
+        zap_disk(block_device)
+
+
+is_ip = ip.is_ip
+ns_query = ip.ns_query
+get_host_ip = ip.get_host_ip
+get_hostname = ip.get_hostname
+
+
+def get_matchmaker_map(mm_file='/etc/oslo/matchmaker_ring.json'):
+    mm_map = {}
+    if os.path.isfile(mm_file):
+        with open(mm_file, 'r') as f:
+            mm_map = json.load(f)
+    return mm_map
+
+
+def sync_db_with_multi_ipv6_addresses(database, database_user,
+                                      relation_prefix=None):
+    hosts = get_ipv6_addr(dynamic_only=False)
+
+    if config('vip'):
+        vips = config('vip').split()
+        for vip in vips:
+            if vip and is_ipv6(vip):
+                hosts.append(vip)
+
+    kwargs = {'database': database,
+              'username': database_user,
+              'hostname': json.dumps(hosts)}
+
+    if relation_prefix:
+        for key in list(kwargs.keys()):
+            kwargs["%s_%s" % (relation_prefix, key)] = kwargs[key]
+            del kwargs[key]
+
+    for rid in relation_ids('shared-db'):
+        relation_set(relation_id=rid, **kwargs)
+
+
+def os_requires_version(ostack_release, pkg):
+    """
+    Decorator for hook to specify minimum supported release
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args):
+            if os_release(pkg) < ostack_release:
+                raise Exception("This hook is not supported on releases"
+                                " before %s" % ostack_release)
+            f(*args)
+        return wrapped_f
+    return wrap
+
+
+def os_workload_status(configs, required_interfaces, charm_func=None):
+    """
+    Decorator to set workload status based on complete contexts
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args, **kwargs):
+            # Run the original function first
+            f(*args, **kwargs)
+            # Set workload status now that contexts have been
+            # acted on
+            set_os_workload_status(configs, required_interfaces, charm_func)
+        return wrapped_f
+    return wrap
+
+
+def set_os_workload_status(configs, required_interfaces, charm_func=None,
+                           services=None, ports=None):
+    """Set the state of the workload status for the charm.
+
+    This calls _determine_os_workload_status() to get the new state, message
+    and sets the status using status_set()
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _determine_os_workload_status(
+        configs, required_interfaces, charm_func, services, ports)
+    status_set(state, message)
+
+
+def _determine_os_workload_status(
+        configs, required_interfaces, charm_func=None,
+        services=None, ports=None):
+    """Determine the state of the workload status for the charm.
+
+    This function returns the new workload status for the charm based
+    on the state of the interfaces, the paused state and whether the
+    services are actually running and any specified ports are open.
+
+    This checks:
+
+     1. if the unit should be paused, that it is actually paused.  If so the
+        state is 'maintenance' + message, else 'broken'.
+     2. that the interfaces/relations are complete.  If they are not then
+        it sets the state to either 'broken' or 'waiting' and an appropriate
+        message.
+     3. If all the relation data is set, then it checks that the actual
+        services really are running.  If not it sets the state to 'broken'.
+
+    If everything is okay then the state returns 'active'.
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _ows_check_if_paused(services, ports)
+
+    if state is None:
+        state, message = _ows_check_generic_interfaces(
+            configs, required_interfaces)
+
+    if state != 'maintenance' and charm_func:
+        # _ows_check_charm_func() may modify the state, message
+        state, message = _ows_check_charm_func(
+            state, message, lambda: charm_func(configs))
+
+    if state is None:
+        state, message = _ows_check_services_running(services, ports)
+
+    if state is None:
+        state = 'active'
+        message = "Unit is ready"
+        juju_log(message, 'INFO')
+
+    try:
+        if config(POLICYD_CONFIG_NAME):
+            message = "{} {}".format(policyd_status_message_prefix(), message)
+    except Exception:
+        pass
+
+    return state, message
+
+
+def _ows_check_if_paused(services=None, ports=None):
+    """Check if the unit is supposed to be paused, and if so check that the
+    services/ports (if passed) are actually stopped/not being listened to.
+
+    If the unit isn't supposed to be paused, just return None, None
+
+    If the unit is performing a series upgrade, return a message indicating
+    this.
+
+    @param services: OPTIONAL services spec or list of service names.
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message or None, None
+    """
+    if is_unit_upgrading_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "blocked"
+            message = ("Ready for do-release-upgrade and reboot. "
+                       "Set complete when finished.")
+        return state, message
+
+    if is_unit_paused_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "maintenance"
+            message = "Paused. Use 'resume' action to resume normal service."
+        return state, message
+    return None, None
+
+
+def _ows_check_generic_interfaces(configs, required_interfaces):
+    """Check the complete contexts to determine the workload status.
+
+     - Checks for missing or incomplete contexts
+     - juju log details of missing required data.
+     - determines the correct workload status
+     - creates an appropriate message for status_set(...)
+
+    if there are no problems then the function returns None, None
+
+    @param configs: a templating.OSConfigRenderer() object
+    @params required_interfaces: {generic_interface: [specific_interface], }
+    @returns state, message or None, None
+    """
+    incomplete_rel_data = incomplete_relation_data(configs,
+                                                   required_interfaces)
+    state = None
+    message = None
+    missing_relations = set()
+    incomplete_relations = set()
+
+    for generic_interface, relations_states in incomplete_rel_data.items():
+        related_interface = None
+        missing_data = {}
+        # Related or not?
+        for interface, relation_state in relations_states.items():
+            if relation_state.get('related'):
+                related_interface = interface
+                missing_data = relation_state.get('missing_data')
+                break
+        # No relation ID for the generic_interface?
+        if not related_interface:
+            juju_log("{} relation is missing and must be related for "
+                     "functionality. ".format(generic_interface), 'WARN')
+            state = 'blocked'
+            missing_relations.add(generic_interface)
+        else:
+            # Relation ID eists but no related unit
+            if not missing_data:
+                # Edge case - relation ID exists but departings
+                _hook_name = hook_name()
+                if (('departed' in _hook_name or 'broken' in _hook_name) and
+                        related_interface in _hook_name):
+                    state = 'blocked'
+                    missing_relations.add(generic_interface)
+                    juju_log("{} relation's interface, {}, "
+                             "relationship is departed or broken "
+                             "and is required for functionality."
+                             "".format(generic_interface, related_interface),
+                             "WARN")
+                # Normal case relation ID exists but no related unit
+                # (joining)
+                else:
+                    juju_log("{} relations's interface, {}, is related but has"
+                             " no units in the relation."
+                             "".format(generic_interface, related_interface),
+                             "INFO")
+            # Related unit exists and data missing on the relation
+            else:
+                juju_log("{} relation's interface, {}, is related awaiting "
+                         "the following data from the relationship: {}. "
+                         "".format(generic_interface, related_interface,
+                                   ", ".join(missing_data)), "INFO")
+            if state != 'blocked':
+                state = 'waiting'
+            if generic_interface not in missing_relations:
+                incomplete_relations.add(generic_interface)
+
+    if missing_relations:
+        message = "Missing relations: {}".format(", ".join(missing_relations))
+        if incomplete_relations:
+            message += "; incomplete relations: {}" \
+                       "".format(", ".join(incomplete_relations))
+        state = 'blocked'
+    elif incomplete_relations:
+        message = "Incomplete relations: {}" \
+                  "".format(", ".join(incomplete_relations))
+        state = 'waiting'
+
+    return state, message
+
+
+def _ows_check_charm_func(state, message, charm_func_with_configs):
+    """Run a custom check function for the charm to see if it wants to
+    change the state.  This is only run if not in 'maintenance' and
+    tests to see if the new state is more important that the previous
+    one determined by the interfaces/relations check.
+
+    @param state: the previously determined state so far.
+    @param message: the user orientated message so far.
+    @param charm_func: a callable function that returns state, message
+    @returns state, message strings.
+    """
+    if charm_func_with_configs:
+        charm_state, charm_message = charm_func_with_configs()
+        if (charm_state != 'active' and
+                charm_state != 'unknown' and
+                charm_state is not None):
+            state = workload_state_compare(state, charm_state)
+            if message:
+                charm_message = charm_message.replace("Incomplete relations: ",
+                                                      "")
+                message = "{}, {}".format(message, charm_message)
+            else:
+                message = charm_message
+    return state, message
+
+
+def _ows_check_services_running(services, ports):
+    """Check that the services that should be running are actually running
+    and that any ports specified are being listened to.
+
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: list of ports
+    @returns state, message: strings or None, None
+    """
+    messages = []
+    state = None
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, running = _check_running_services(services)
+        if not all(running):
+            messages.append(
+                "Services not running that should be: {}"
+                .format(", ".join(_filter_tuples(services_running, False))))
+            state = 'blocked'
+        # also verify that the ports that should be open are open
+        # NB, that ServiceManager objects only OPTIONALLY have ports
+        map_not_open, ports_open = (
+            _check_listening_on_services_ports(services))
+        if not all(ports_open):
+            # find which service has missing ports. They are in service
+            # order which makes it a bit easier.
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in map_not_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "Services with ports not open that should be: {}"
+                .format(message))
+            state = 'blocked'
+
+    if ports is not None:
+        # and we can also check ports which we don't know the service for
+        ports_open, ports_open_bools = _check_listening_on_ports_list(ports)
+        if not all(ports_open_bools):
+            messages.append(
+                "Ports which should be open, but are not: {}"
+                .format(", ".join([str(p) for p, v in ports_open
+                                   if not v])))
+            state = 'blocked'
+
+    if state is not None:
+        message = "; ".join(messages)
+        return state, message
+
+    return None, None
+
+
+def _extract_services_list_helper(services):
+    """Extract a OrderedDict of {service: [ports]} of the supplied services
+    for use by the other functions.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param services: see above
+    @returns OrderedDict(service: [ports], ...)
+    """
+    if services is None:
+        return {}
+    if isinstance(services, dict):
+        services = services.values()
+    # either extract the list of services from the dictionary, or if
+    # it is a simple string, use that. i.e. works with mixed lists.
+    _s = OrderedDict()
+    for s in services:
+        if isinstance(s, dict) and 'service' in s:
+            _s[s['service']] = s.get('ports', [])
+        if isinstance(s, str):
+            _s[s] = []
+    return _s
+
+
+def _check_running_services(services):
+    """Check that the services dict provided is actually running and provide
+    a list of (service, boolean) tuples for each service.
+
+    Returns both a zipped list of (service, boolean) and a list of booleans
+    in the same order as the services.
+
+    @param services: OrderedDict of strings: [ports], one for each service to
+                     check.
+    @returns [(service, boolean), ...], : results for checks
+             [boolean]                  : just the result of the service checks
+    """
+    services_running = [service_running(s) for s in services]
+    return list(zip(services, services_running)), services_running
+
+
+def _check_listening_on_services_ports(services, test=False):
+    """Check that the unit is actually listening (has the port open) on the
+    ports that the service specifies are open. If test is True then the
+    function returns the services with ports that are open rather than
+    closed.
+
+    Returns an OrderedDict of service: ports and a list of booleans
+
+    @param services: OrderedDict(service: [port, ...], ...)
+    @param test: default=False, if False, test for closed, otherwise open.
+    @returns OrderedDict(service: [port-not-open, ...]...), [boolean]
+    """
+    test = not(not(test))  # ensure test is True or False
+    all_ports = list(itertools.chain(*services.values()))
+    ports_states = [port_has_listener('0.0.0.0', p) for p in all_ports]
+    map_ports = OrderedDict()
+    matched_ports = [p for p, opened in zip(all_ports, ports_states)
+                     if opened == test]  # essentially opened xor test
+    for service, ports in services.items():
+        set_ports = set(ports).intersection(matched_ports)
+        if set_ports:
+            map_ports[service] = set_ports
+    return map_ports, ports_states
+
+
+def _check_listening_on_ports_list(ports):
+    """Check that the ports list given are being listened to
+
+    Returns a list of ports being listened to and a list of the
+    booleans.
+
+    @param ports: LIST or port numbers.
+    @returns [(port_num, boolean), ...], [boolean]
+    """
+    ports_open = [port_has_listener('0.0.0.0', p) for p in ports]
+    return zip(ports, ports_open), ports_open
+
+
+def _filter_tuples(services_states, state):
+    """Return a simple list from a list of tuples according to the condition
+
+    @param services_states: LIST of (string, boolean): service and running
+           state.
+    @param state: Boolean to match the tuple against.
+    @returns [LIST of strings] that matched the tuple RHS.
+    """
+    return [s for s, b in services_states if b == state]
+
+
+def workload_state_compare(current_workload_state, workload_state):
+    """ Return highest priority of two states"""
+    hierarchy = {'unknown': -1,
+                 'active': 0,
+                 'maintenance': 1,
+                 'waiting': 2,
+                 'blocked': 3,
+                 }
+
+    if hierarchy.get(workload_state) is None:
+        workload_state = 'unknown'
+    if hierarchy.get(current_workload_state) is None:
+        current_workload_state = 'unknown'
+
+    # Set workload_state based on hierarchy of statuses
+    if hierarchy.get(current_workload_state) > hierarchy.get(workload_state):
+        return current_workload_state
+    else:
+        return workload_state
+
+
+def incomplete_relation_data(configs, required_interfaces):
+    """Check complete contexts against required_interfaces
+    Return dictionary of incomplete relation data.
+
+    configs is an OSConfigRenderer object with configs registered
+
+    required_interfaces is a dictionary of required general interfaces
+    with dictionary values of possible specific interfaces.
+    Example:
+    required_interfaces = {'database': ['shared-db', 'pgsql-db']}
+
+    The interface is said to be satisfied if anyone of the interfaces in the
+    list has a complete context.
+
+    Return dictionary of incomplete or missing required contexts with relation
+    status of interfaces and any missing data points. Example:
+        {'message':
+             {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+              'zeromq-configuration': {'related': False}},
+         'identity':
+             {'identity-service': {'related': False}},
+         'database':
+             {'pgsql-db': {'related': False},
+              'shared-db': {'related': True}}}
+    """
+    complete_ctxts = configs.complete_contexts()
+    incomplete_relations = [
+        svc_type
+        for svc_type, interfaces in required_interfaces.items()
+        if not set(interfaces).intersection(complete_ctxts)]
+    return {
+        i: configs.get_incomplete_context_data(required_interfaces[i])
+        for i in incomplete_relations}
+
+
+def do_action_openstack_upgrade(package, upgrade_callback, configs):
+    """Perform action-managed OpenStack upgrade.
+
+    Upgrades packages to the configured openstack-origin version and sets
+    the corresponding action status as a result.
+
+    If the charm was installed from source we cannot upgrade it.
+    For backwards compatibility a config flag (action-managed-upgrade) must
+    be set for this code to run, otherwise a full service level upgrade will
+    fire on config-changed.
+
+    @param package: package name for determining if upgrade available
+    @param upgrade_callback: function callback to charm's upgrade function
+    @param configs: templating object derived from OSConfigRenderer class
+
+    @return: True if upgrade successful; False if upgrade failed or skipped
+    """
+    ret = False
+
+    if openstack_upgrade_available(package):
+        if config('action-managed-upgrade'):
+            juju_log('Upgrading OpenStack release')
+
+            try:
+                upgrade_callback(configs=configs)
+                action_set({'outcome': 'success, upgrade completed.'})
+                ret = True
+            except Exception:
+                action_set({'outcome': 'upgrade failed, see traceback.'})
+                action_set({'traceback': traceback.format_exc()})
+                action_fail('do_openstack_upgrade resulted in an '
+                            'unexpected error')
+        else:
+            action_set({'outcome': 'action-managed-upgrade config is '
+                                   'False, skipped upgrade.'})
+    else:
+        action_set({'outcome': 'no upgrade available.'})
+
+    return ret
+
+
+def remote_restart(rel_name, remote_service=None):
+    trigger = {
+        'restart-trigger': str(uuid.uuid4()),
+    }
+    if remote_service:
+        trigger['remote-service'] = remote_service
+    for rid in relation_ids(rel_name):
+        # This subordinate can be related to two seperate services using
+        # different subordinate relations so only issue the restart if
+        # the principle is conencted down the relation we think it is
+        if related_units(relid=rid):
+            relation_set(relation_id=rid,
+                         relation_settings=trigger,
+                         )
+
+
+def check_actually_paused(services=None, ports=None):
+    """Check that services listed in the services object and ports
+    are actually closed (not listened to), to verify that the unit is
+    properly paused.
+
+    @param services: See _extract_services_list_helper
+    @returns status, : string for status (None if okay)
+             message : string for problem for status_set
+    """
+    state = None
+    message = None
+    messages = []
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, services_states = _check_running_services(services)
+        if any(services_states):
+            # there shouldn't be any running so this is a problem
+            messages.append("these services running: {}"
+                            .format(", ".join(
+                                _filter_tuples(services_running, True))))
+            state = "blocked"
+        ports_open, ports_open_bools = (
+            _check_listening_on_services_ports(services, True))
+        if any(ports_open_bools):
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in ports_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "these service:ports are open: {}".format(message))
+            state = 'blocked'
+    if ports is not None:
+        ports_open, bools = _check_listening_on_ports_list(ports)
+        if any(bools):
+            messages.append(
+                "these ports which should be closed, but are open: {}"
+                .format(", ".join([str(p) for p, v in ports_open if v])))
+            state = 'blocked'
+    if messages:
+        message = ("Services should be paused but {}"
+                   .format(", ".join(messages)))
+    return state, message
+
+
+def set_unit_paused():
+    """Set the unit to a paused state in the local kv() store.
+    This does NOT actually pause the unit
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', True)
+
+
+def clear_unit_paused():
+    """Clear the unit from a paused state in the local kv() store
+    This does NOT actually restart any services - it only clears the
+    local state.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', False)
+
+
+def is_unit_paused_set():
+    """Return the state of the kv().get('unit-paused').
+    This does NOT verify that the unit really is paused.
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-paused')))
+    except Exception:
+        return False
+
+
+def manage_payload_services(action, services=None, charm_func=None):
+    """Run an action against all services.
+
+    An optional charm_func() can be called. It should raise an Exception to
+    indicate that the function failed. If it was succesfull it should return
+    None or an optional message.
+
+    The signature for charm_func is:
+    charm_func() -> message: str
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    :param action: Action to run: pause, resume, start or stop.
+    :type action: str
+    :param services: See above
+    :type services: See above
+    :param charm_func: function to run for custom charm pausing.
+    :type charm_func: f()
+    :returns: Status boolean and list of messages
+    :rtype: (bool, [])
+    :raises: RuntimeError
+    """
+    actions = {
+        'pause': service_pause,
+        'resume': service_resume,
+        'start': service_start,
+        'stop': service_stop}
+    action = action.lower()
+    if action not in actions.keys():
+        raise RuntimeError(
+            "action: {} must be one of: {}".format(action,
+                                                   ', '.join(actions.keys())))
+    services = _extract_services_list_helper(services)
+    messages = []
+    success = True
+    if services:
+        for service in services.keys():
+            rc = actions[action](service)
+            if not rc:
+                success = False
+                messages.append("{} didn't {} cleanly.".format(service,
+                                                               action))
+    if charm_func:
+        try:
+            message = charm_func()
+            if message:
+                messages.append(message)
+        except Exception as e:
+            success = False
+            messages.append(str(e))
+    return success, messages
+
+
+def pause_unit(assess_status_func, services=None, ports=None,
+               charm_func=None):
+    """Pause a unit by stopping the services and setting 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have stopped and ports are no longer
+    being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None, None to indicate that the unit
+    didn't pause cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm pausing.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'pause',
+        services=services,
+        charm_func=charm_func)
+    set_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages and not is_unit_upgrading_set():
+        raise Exception("Couldn't pause: {}".format("; ".join(messages)))
+
+
+def resume_unit(assess_status_func, services=None, ports=None,
+                charm_func=None):
+    """Resume a unit by starting the services and clearning 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have started and ports are being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None to indicate that the unit
+    didn't resume cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are started, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm resuming.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'resume',
+        services=services,
+        charm_func=charm_func)
+    clear_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages:
+        raise Exception("Couldn't resume: {}".format("; ".join(messages)))
+
+
+def make_assess_status_func(*args, **kwargs):
+    """Creates an assess_status_func() suitable for handing to pause_unit()
+    and resume_unit().
+
+    This uses the _determine_os_workload_status(...) function to determine
+    what the workload_status should be for the unit.  If the unit is
+    not in maintenance or active states, then the message is returned to
+    the caller.  This is so an action that doesn't result in either a
+    complete pause or complete resume can signal failure with an action_fail()
+    """
+    def _assess_status_func():
+        state, message = _determine_os_workload_status(*args, **kwargs)
+        status_set(state, message)
+        if state not in ['maintenance', 'active']:
+            return message
+        return None
+
+    return _assess_status_func
+
+
+def pausable_restart_on_change(restart_map, stopstart=False,
+                               restart_functions=None):
+    """A restart_on_change decorator that checks to see if the unit is
+    paused. If it is paused then the decorated function doesn't fire.
+
+    This is provided as a helper, as the @restart_on_change(...) decorator
+    is in core.host, yet the openstack specific helpers are in this file
+    (contrib.openstack.utils).  Thus, this needs to be an optional feature
+    for openstack charms (or charms that wish to use the openstack
+    pause/resume type features).
+
+    It is used as follows:
+
+        from contrib.openstack.utils import (
+            pausable_restart_on_change as restart_on_change)
+
+        @restart_on_change(restart_map, stopstart=<boolean>)
+        def some_hook(...):
+            pass
+
+    see core.utils.restart_on_change() for more details.
+
+    Note restart_map can be a callable, in which case, restart_map is only
+    evaluated at runtime.  This means that it is lazy and the underlying
+    function won't be called if the decorated function is never called.  Note,
+    retains backwards compatibility for passing a non-callable dictionary.
+
+    @param f: the function to decorate
+    @param restart_map: (optionally callable, which then returns the
+        restart_map) the restart map {conf_file: [services]}
+    @param stopstart: DEFAULT false; whether to stop, start or just restart
+    @returns decorator to use a restart_on_change with pausability
+    """
+    def wrap(f):
+        # py27 compatible nonlocal variable.  When py3 only, replace with
+        # nonlocal keyword
+        __restart_map_cache = {'cache': None}
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            if is_unit_paused_set():
+                return f(*args, **kwargs)
+            if __restart_map_cache['cache'] is None:
+                __restart_map_cache['cache'] = restart_map() \
+                    if callable(restart_map) else restart_map
+            # otherwise, normal restart_on_change functionality
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), __restart_map_cache['cache'],
+                stopstart, restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def ordered(orderme):
+    """Converts the provided dictionary into a collections.OrderedDict.
+
+    The items in the returned OrderedDict will be inserted based on the
+    natural sort order of the keys. Nested dictionaries will also be sorted
+    in order to ensure fully predictable ordering.
+
+    :param orderme: the dict to order
+    :return: collections.OrderedDict
+    :raises: ValueError: if `orderme` isn't a dict instance.
+    """
+    if not isinstance(orderme, dict):
+        raise ValueError('argument must be a dict type')
+
+    result = OrderedDict()
+    for k, v in sorted(six.iteritems(orderme), key=lambda x: x[0]):
+        if isinstance(v, dict):
+            result[k] = ordered(v)
+        else:
+            result[k] = v
+
+    return result
+
+
+def config_flags_parser(config_flags):
+    """Parses config flags string into dict.
+
+    This parsing method supports a few different formats for the config
+    flag values to be parsed:
+
+      1. A string in the simple format of key=value pairs, with the possibility
+         of specifying multiple key value pairs within the same string. For
+         example, a string in the format of 'key1=value1, key2=value2' will
+         return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2'}.
+
+      2. A string in the above format, but supporting a comma-delimited list
+         of values for the same key. For example, a string in the format of
+         'key1=value1, key2=value3,value4,value5' will return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2,value3,value4'}
+
+      3. A string containing a colon character (:) prior to an equal
+         character (=) will be treated as yaml and parsed as such. This can be
+         used to specify more complex key value pairs. For example,
+         a string in the format of 'key1: subkey1=value1, subkey2=value2' will
+         return a dict of:
+
+             {'key1', 'subkey1=value1, subkey2=value2'}
+
+    The provided config_flags string may be a list of comma-separated values
+    which themselves may be comma-separated list of values.
+    """
+    # If we find a colon before an equals sign then treat it as yaml.
+    # Note: limit it to finding the colon first since this indicates assignment
+    # for inline yaml.
+    colon = config_flags.find(':')
+    equals = config_flags.find('=')
+    if colon > 0:
+        if colon < equals or equals < 0:
+            return ordered(yaml.safe_load(config_flags))
+
+    if config_flags.find('==') >= 0:
+        juju_log("config_flags is not in expected format (key=value)",
+                 level=ERROR)
+        raise OSContextError
+
+    # strip the following from each value.
+    post_strippers = ' ,'
+    # we strip any leading/trailing '=' or ' ' from the string then
+    # split on '='.
+    split = config_flags.strip(' =').split('=')
+    limit = len(split)
+    flags = OrderedDict()
+    for i in range(0, limit - 1):
+        current = split[i]
+        next = split[i + 1]
+        vindex = next.rfind(',')
+        if (i == limit - 2) or (vindex < 0):
+            value = next
+        else:
+            value = next[:vindex]
+
+        if i == 0:
+            key = current
+        else:
+            # if this not the first entry, expect an embedded key.
+            index = current.rfind(',')
+            if index < 0:
+                juju_log("Invalid config value(s) at index %s" % (i),
+                         level=ERROR)
+                raise OSContextError
+            key = current[index + 1:]
+
+        # Add to collection.
+        flags[key.strip(post_strippers)] = value.rstrip(post_strippers)
+
+    return flags
+
+
+def os_application_version_set(package):
+    '''Set version of application for Juju 2.0 and later'''
+    application_version = get_upstream_version(package)
+    # NOTE(jamespage) if not able to figure out package version, fallback to
+    #                 openstack codename version detection.
+    if not application_version:
+        application_version_set(os_release(package))
+    else:
+        application_version_set(application_version)
+
+
+def os_application_status_set(check_function):
+    """Run the supplied function and set the application status accordingly.
+
+    :param check_function: Function to run to get app states and messages.
+    :type check_function: function
+    """
+    state, message = check_function()
+    status_set(state, message, application=True)
+
+
+def enable_memcache(source=None, release=None, package=None):
+    """Determine if memcache should be enabled on the local unit
+
+    @param release: release of OpenStack currently deployed
+    @param package: package to derive OpenStack version deployed
+    @returns boolean Whether memcache should be enabled
+    """
+    _release = None
+    if release:
+        _release = release
+    else:
+        _release = os_release(package)
+    if not _release:
+        _release = get_os_codename_install_source(source)
+
+    return CompareOpenStackReleases(_release) >= 'mitaka'
+
+
+def token_cache_pkgs(source=None, release=None):
+    """Determine additional packages needed for token caching
+
+    @param source: source string for charm
+    @param release: release of OpenStack currently deployed
+    @returns List of package to enable token caching
+    """
+    packages = []
+    if enable_memcache(source=source, release=release):
+        packages.extend(['memcached', 'python-memcache'])
+    return packages
+
+
+def update_json_file(filename, items):
+    """Updates the json `filename` with a given dict.
+    :param filename: path to json file (e.g. /etc/glance/policy.json)
+    :param items: dict of items to update
+    """
+    if not items:
+        return
+
+    with open(filename) as fd:
+        policy = json.load(fd)
+
+    # Compare before and after and if nothing has changed don't write the file
+    # since that could cause unnecessary service restarts.
+    before = json.dumps(policy, indent=4, sort_keys=True)
+    policy.update(items)
+    after = json.dumps(policy, indent=4, sort_keys=True)
+    if before == after:
+        return
+
+    with open(filename, "w") as fd:
+        fd.write(after)
+
+
+@cached
+def snap_install_requested():
+    """ Determine if installing from snaps
+
+    If openstack-origin is of the form snap:track/channel[/branch]
+    and channel is in SNAPS_CHANNELS return True.
+    """
+    origin = config('openstack-origin') or ""
+    if not origin.startswith('snap:'):
+        return False
+
+    _src = origin[5:]
+    if '/' in _src:
+        channel = _src.split('/')[1]
+    else:
+        # Handle snap:track with no channel
+        channel = 'stable'
+    return valid_snap_channel(channel)
+
+
+def get_snaps_install_info_from_origin(snaps, src, mode='classic'):
+    """Generate a dictionary of snap install information from origin
+
+    @param snaps: List of snaps
+    @param src: String of openstack-origin or source of the form
+        snap:track/channel
+    @param mode: String classic, devmode or jailmode
+    @returns: Dictionary of snaps with channels and modes
+    """
+
+    if not src.startswith('snap:'):
+        juju_log("Snap source is not a snap origin", 'WARN')
+        return {}
+
+    _src = src[5:]
+    channel = '--channel={}'.format(_src)
+
+    return {snap: {'channel': channel, 'mode': mode}
+            for snap in snaps}
+
+
+def install_os_snaps(snaps, refresh=False):
+    """Install OpenStack snaps from channel and with mode
+
+    @param snaps: Dictionary of snaps with channels and modes of the form:
+        {'snap_name': {'channel': 'snap_channel',
+                       'mode': 'snap_mode'}}
+        Where channel is a snapstore channel and mode is --classic, --devmode
+        or --jailmode.
+    @param post_snap_install: Callback function to run after snaps have been
+    installed
+    """
+
+    def _ensure_flag(flag):
+        if flag.startswith('--'):
+            return flag
+        return '--{}'.format(flag)
+
+    if refresh:
+        for snap in snaps.keys():
+            snap_refresh(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+    else:
+        for snap in snaps.keys():
+            snap_install(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+
+
+def set_unit_upgrading():
+    """Set the unit to a upgrading state in the local kv() store.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', True)
+
+
+def clear_unit_upgrading():
+    """Clear the unit from a upgrading state in the local kv() store
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', False)
+
+
+def is_unit_upgrading_set():
+    """Return the state of the kv().get('unit-upgrading').
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-upgrading')))
+    except Exception:
+        return False
+
+
+def series_upgrade_prepare(pause_unit_helper=None, configs=None):
+    """ Run common series upgrade prepare tasks.
+
+    :param pause_unit_helper: function: Function to pause unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    set_unit_upgrading()
+    if pause_unit_helper and configs:
+        if not is_unit_paused_set():
+            pause_unit_helper(configs)
+
+
+def series_upgrade_complete(resume_unit_helper=None, configs=None):
+    """ Run common series upgrade complete tasks.
+
+    :param resume_unit_helper: function: Function to resume unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    clear_unit_paused()
+    clear_unit_upgrading()
+    if configs:
+        configs.write_all()
+        if resume_unit_helper:
+            resume_unit_helper(configs)
+
+
+def is_db_initialised():
+    """Check leader storage to see if database has been initialised.
+
+    :returns: Whether DB has been initialised
+    :rtype: bool
+    """
+    db_initialised = None
+    if leader_get('db-initialised') is None:
+        juju_log(
+            'db-initialised key missing, assuming db is not initialised',
+            'DEBUG')
+        db_initialised = False
+    else:
+        db_initialised = bool_from_string(leader_get('db-initialised'))
+    juju_log('Database initialised: {}'.format(db_initialised), 'DEBUG')
+    return db_initialised
+
+
+def set_db_initialised():
+    """Add flag to leader storage to indicate database has been initialised.
+    """
+    juju_log('Setting db-initialised to True', 'DEBUG')
+    leader_set({'db-initialised': True})
+
+
+def is_db_maintenance_mode(relid=None):
+    """Check relation data from notifications of db in maintenance mode.
+
+    :returns: Whether db has notified it is in maintenance mode.
+    :rtype: bool
+    """
+    juju_log('Checking for maintenance notifications', 'DEBUG')
+    if relid:
+        r_ids = [relid]
+    else:
+        r_ids = relation_ids('shared-db')
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    notifications = []
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        for key, value in settings.items():
+            if value and key in DB_MAINTENANCE_KEYS:
+                juju_log(
+                    'Unit: {}, Key: {}, Value: {}'.format(unit, key, value),
+                    'DEBUG')
+                try:
+                    notifications.append(bool_from_string(value))
+                except ValueError:
+                    juju_log(
+                        'Could not discern bool from {}'.format(value),
+                        'WARN')
+                    pass
+    return True in notifications
+
+
+@cached
+def container_scoped_relations():
+    """Get all the container scoped relations
+
+    :returns: List of relation names
+    :rtype: List
+    """
+    md = metadata()
+    relations = []
+    for relation_type in ('provides', 'requires', 'peers'):
+        for relation in md.get(relation_type, []):
+            if md[relation_type][relation].get('scope') == 'container':
+                relations.append(relation)
+    return relations
+
+
+def is_db_ready(use_current_context=False, rel_name=None):
+    """Check remote database is ready to be used.
+
+    Database relations are expected to provide a list of 'allowed' units to
+    confirm that the database is ready for use by those units.
+
+    If db relation has provided this information and local unit is a member,
+    returns True otherwise False.
+
+    :param use_current_context: Whether to limit checks to current hook
+                                context.
+    :type use_current_context: bool
+    :param rel_name: Name of relation to check
+    :type rel_name: string
+    :returns: Whether remote db is ready.
+    :rtype: bool
+    :raises: Exception
+    """
+    key = 'allowed_units'
+
+    rel_name = rel_name or 'shared-db'
+    this_unit = local_unit()
+
+    if use_current_context:
+        if relation_id() in relation_ids(rel_name):
+            rids_units = [(None, None)]
+        else:
+            raise Exception("use_current_context=True but not in {} "
+                            "rel hook contexts (currently in {})."
+                            .format(rel_name, relation_id()))
+    else:
+        rids_units = [(r_id, u)
+                      for r_id in relation_ids(rel_name)
+                      for u in related_units(r_id)]
+
+    for rid, unit in rids_units:
+        allowed_units = relation_get(rid=rid, unit=unit, attribute=key)
+        if allowed_units and this_unit in allowed_units.split():
+            juju_log("This unit ({}) is in allowed unit list from {}".format(
+                this_unit,
+                unit), 'DEBUG')
+            return True
+
+    juju_log("This unit was not found in any allowed unit list")
+    return False
+
+
+def is_expected_scale(peer_relation_name='cluster'):
+    """Query juju goal-state to determine whether our peer- and dependency-
+    relations are at the expected scale.
+
+    Useful for deferring per unit per relation housekeeping work until we are
+    ready to complete it successfully and without unnecessary repetiton.
+
+    Always returns True if version of juju used does not support goal-state.
+
+    :param peer_relation_name: Name of peer relation
+    :type rel_name: string
+    :returns: True or False
+    :rtype: bool
+    """
+    def _get_relation_id(rel_type):
+        return next((rid for rid in relation_ids(reltype=rel_type)), None)
+
+    Relation = namedtuple('Relation', 'rel_type rel_id')
+    peer_rid = _get_relation_id(peer_relation_name)
+    # Units with no peers should still have a peer relation.
+    if not peer_rid:
+        juju_log('Not at expected scale, no peer relation found', 'DEBUG')
+        return False
+    expected_relations = [
+        Relation(rel_type='shared-db', rel_id=_get_relation_id('shared-db'))]
+    if expect_ha():
+        expected_relations.append(
+            Relation(
+                rel_type='ha',
+                rel_id=_get_relation_id('ha')))
+    juju_log(
+        'Checking scale of {} relations'.format(
+            ','.join([r.rel_type for r in expected_relations])),
+        'DEBUG')
+    try:
+        if (len(related_units(relid=peer_rid)) <
+                len(list(expected_peer_units()))):
+            return False
+        for rel in expected_relations:
+            if not rel.rel_id:
+                juju_log(
+                    'Expected to find {} relation, but it is missing'.format(
+                        rel.rel_type),
+                    'DEBUG')
+                return False
+            # Goal state returns every unit even for container scoped
+            # relations but the charm only ever has a relation with
+            # the local unit.
+            if rel.rel_type in container_scoped_relations():
+                expected_count = 1
+            else:
+                expected_count = len(
+                    list(expected_related_units(reltype=rel.rel_type)))
+            if len(related_units(relid=rel.rel_id)) < expected_count:
+                juju_log(
+                    ('Not at expected scale, not enough units on {} '
+                     'relation'.format(rel.rel_type)),
+                    'DEBUG')
+                return False
+    except NotImplementedError:
+        return True
+    juju_log('All checks have passed, unit is at expected scale', 'DEBUG')
+    return True
+
+
+def get_peer_key(unit_name):
+    """Get the peer key for this unit.
+
+    The peer key is the key a unit uses to publish its status down the peer
+    relation
+
+    :param unit_name: Name of unit
+    :type unit_name: string
+    :returns: Peer key for given unit
+    :rtype: string
+    """
+    return 'unit-state-{}'.format(unit_name.replace('/', '-'))
+
+
+UNIT_READY = 'READY'
+UNIT_NOTREADY = 'NOTREADY'
+UNIT_UNKNOWN = 'UNKNOWN'
+UNIT_STATES = [UNIT_READY, UNIT_NOTREADY, UNIT_UNKNOWN]
+
+
+def inform_peers_unit_state(state, relation_name='cluster'):
+    """Inform peers of the state of this unit.
+
+    :param state: State of unit to publish
+    :type state: string
+    :param relation_name: Name of relation to publish state on
+    :type relation_name: string
+    """
+    if state not in UNIT_STATES:
+        raise ValueError(
+            "Setting invalid state {} for unit".format(state))
+    for r_id in relation_ids(relation_name):
+        relation_set(relation_id=r_id,
+                     relation_settings={
+                         get_peer_key(local_unit()): state})
+
+
+def get_peers_unit_state(relation_name='cluster'):
+    """Get the state of all peers.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Unit states keyed on unit name.
+    :rtype: dict
+    :raises: ValueError
+    """
+    r_ids = relation_ids(relation_name)
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    unit_states = {}
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        unit_states[unit] = settings.get(get_peer_key(unit), UNIT_UNKNOWN)
+        if unit_states[unit] not in UNIT_STATES:
+            raise ValueError(
+                "Unit in unknown state {}".format(unit_states[unit]))
+    return unit_states
+
+
+def are_peers_ready(relation_name='cluster'):
+    """Check if all peers are ready.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Whether all units are ready.
+    :rtype: bool
+    """
+    unit_states = get_peers_unit_state(relation_name)
+    return all(v == UNIT_READY for v in unit_states.values())
+
+
+def inform_peers_if_ready(check_unit_ready_func, relation_name='cluster'):
+    """Inform peers if this unit is ready.
+
+    The check function should return a tuple (state, message). A state
+    of 'READY' indicates the unit is READY.
+
+    :param check_unit_ready_func: Function to run to check readiness
+    :type check_unit_ready_func: function
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    """
+    unit_ready, msg = check_unit_ready_func()
+    if unit_ready:
+        state = UNIT_READY
+    else:
+        state = UNIT_NOTREADY
+    juju_log('Telling peers this unit is: {}'.format(state), 'DEBUG')
+    inform_peers_unit_state(state, relation_name)
+
+
+def check_api_unit_ready(check_db_ready=True):
+    """Check if this unit is ready.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Whether unit state is ready and status message
+    :rtype: (bool, str)
+    """
+    unit_state, msg = get_api_unit_status(check_db_ready=check_db_ready)
+    return unit_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_unit_status(check_db_ready=True):
+    """Return a workload status and message for this unit.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    unit_state = WORKLOAD_STATES.ACTIVE
+    msg = 'Unit is ready'
+    if is_db_maintenance_mode():
+        unit_state = WORKLOAD_STATES.MAINTENANCE
+        msg = 'Database in maintenance mode.'
+    elif is_unit_paused_set():
+        unit_state = WORKLOAD_STATES.BLOCKED
+        msg = 'Unit paused.'
+    elif check_db_ready and not is_db_ready():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Allowed_units list provided but this unit not present'
+    elif not is_db_initialised():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Database not initialised'
+    elif not is_expected_scale():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Charm and its dependencies not yet at expected scale'
+    juju_log(msg, 'DEBUG')
+    return unit_state, msg
+
+
+def check_api_application_ready():
+    """Check if this application is ready.
+
+    :returns: Whether application state is ready and status message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_application_status()
+    return app_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_application_status():
+    """Return a workload status and message for this application.
+
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_unit_status()
+    if app_state == WORKLOAD_STATES.ACTIVE:
+        if are_peers_ready():
+            return WORKLOAD_STATES.ACTIVE, 'Application Ready'
+        else:
+            return WORKLOAD_STATES.WAITING, 'Some units are not ready'
+    return app_state, msg
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/vaultlocker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/vaultlocker.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ee6c1dba910b824467c2c34e0a3d3d0f3fd906d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/openstack/vaultlocker.py
@@ -0,0 +1,179 @@
+# Copyright 2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+
+import charmhelpers.contrib.openstack.alternatives as alternatives
+import charmhelpers.contrib.openstack.context as context
+
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as host
+import charmhelpers.core.templating as templating
+import charmhelpers.core.unitdata as unitdata
+
+VAULTLOCKER_BACKEND = 'charm-vaultlocker'
+
+
+class VaultKVContext(context.OSContextGenerator):
+    """Vault KV context for interaction with vault-kv interfaces"""
+    interfaces = ['secrets-storage']
+
+    def __init__(self, secret_backend=None):
+        super(context.OSContextGenerator, self).__init__()
+        self.secret_backend = (
+            secret_backend or 'charm-{}'.format(hookenv.service_name())
+        )
+
+    def __call__(self):
+        try:
+            import hvac
+        except ImportError:
+            # BUG: #1862085 - if the relation is made to vault, but the
+            # 'encrypt' option is not made, then the charm errors with an
+            # import warning.  This catches that, logs a warning, and returns
+            # with an empty context.
+            hookenv.log("VaultKVContext: trying to use hvac pythong module "
+                        "but it's not available.  Is secrets-stroage relation "
+                        "made, but encrypt option not set?",
+                        level=hookenv.WARNING)
+            # return an emptry context on hvac import error
+            return {}
+        ctxt = {}
+        # NOTE(hopem): see https://bugs.launchpad.net/charm-helpers/+bug/1849323
+        db = unitdata.kv()
+        # currently known-good secret-id
+        secret_id = db.get('secret-id')
+
+        for relation_id in hookenv.relation_ids(self.interfaces[0]):
+            for unit in hookenv.related_units(relation_id):
+                data = hookenv.relation_get(unit=unit,
+                                            rid=relation_id)
+                vault_url = data.get('vault_url')
+                role_id = data.get('{}_role_id'.format(hookenv.local_unit()))
+                token = data.get('{}_token'.format(hookenv.local_unit()))
+
+                if all([vault_url, role_id, token]):
+                    token = json.loads(token)
+                    vault_url = json.loads(vault_url)
+
+                    # Tokens may change when secret_id's are being
+                    # reissued - if so use token to get new secret_id
+                    token_success = False
+                    try:
+                        secret_id = retrieve_secret_id(
+                            url=vault_url,
+                            token=token
+                        )
+                        token_success = True
+                    except hvac.exceptions.InvalidRequest:
+                        # Try next
+                        pass
+
+                    if token_success:
+                        db.set('secret-id', secret_id)
+                        db.flush()
+
+                        ctxt['vault_url'] = vault_url
+                        ctxt['role_id'] = json.loads(role_id)
+                        ctxt['secret_id'] = secret_id
+                        ctxt['secret_backend'] = self.secret_backend
+                        vault_ca = data.get('vault_ca')
+                        if vault_ca:
+                            ctxt['vault_ca'] = json.loads(vault_ca)
+
+                        self.complete = True
+                        break
+                    else:
+                        if secret_id:
+                            ctxt['vault_url'] = vault_url
+                            ctxt['role_id'] = json.loads(role_id)
+                            ctxt['secret_id'] = secret_id
+                            ctxt['secret_backend'] = self.secret_backend
+                            vault_ca = data.get('vault_ca')
+                            if vault_ca:
+                                ctxt['vault_ca'] = json.loads(vault_ca)
+
+            if self.complete:
+                break
+
+        if ctxt:
+            self.complete = True
+
+        return ctxt
+
+
+def write_vaultlocker_conf(context, priority=100):
+    """Write vaultlocker configuration to disk and install alternative
+
+    :param context: Dict of data from vault-kv relation
+    :ptype: context: dict
+    :param priority: Priority of alternative configuration
+    :ptype: priority: int"""
+    charm_vl_path = "/var/lib/charm/{}/vaultlocker.conf".format(
+        hookenv.service_name()
+    )
+    host.mkdir(os.path.dirname(charm_vl_path), perms=0o700)
+    templating.render(source='vaultlocker.conf.j2',
+                      target=charm_vl_path,
+                      context=context, perms=0o600),
+    alternatives.install_alternative('vaultlocker.conf',
+                                     '/etc/vaultlocker/vaultlocker.conf',
+                                     charm_vl_path, priority)
+
+
+def vault_relation_complete(backend=None):
+    """Determine whether vault relation is complete
+
+    :param backend: Name of secrets backend requested
+    :ptype backend: string
+    :returns: whether the relation to vault is complete
+    :rtype: bool"""
+    try:
+        import hvac
+    except ImportError:
+        return False
+    try:
+        vault_kv = VaultKVContext(secret_backend=backend or VAULTLOCKER_BACKEND)
+        vault_kv()
+        return vault_kv.complete
+    except hvac.exceptions.InvalidRequest:
+        return False
+
+
+# TODO: contrib a high level unwrap method to hvac that works
+def retrieve_secret_id(url, token):
+    """Retrieve a response-wrapped secret_id from Vault
+
+    :param url: URL to Vault Server
+    :ptype url: str
+    :param token: One shot Token to use
+    :ptype token: str
+    :returns: secret_id to use for Vault Access
+    :rtype: str"""
+    import hvac
+    try:
+        # hvac 0.10.1 changed default adapter to JSONAdapter
+        client = hvac.Client(url=url, token=token, adapter=hvac.adapters.Request)
+    except AttributeError:
+        # hvac < 0.6.2 doesn't have adapter but uses the same response interface
+        client = hvac.Client(url=url, token=token)
+    else:
+        # hvac < 0.9.2 assumes adapter is an instance, so doesn't instantiate
+        if not isinstance(client.adapter, hvac.adapters.Request):
+            client.adapter = hvac.adapters.Request(base_uri=url, token=token)
+    response = client._post('/v1/sys/wrapping/unwrap')
+    if response.status_code == 200:
+        data = response.json()
+        return data['data']['secret_id']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/peerstorage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/peerstorage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8fa60c2a3080d088b8e0abae370aa355c80ec56
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/peerstorage/__init__.py
@@ -0,0 +1,267 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import six
+
+from charmhelpers.core.hookenv import relation_id as current_relation_id
+from charmhelpers.core.hookenv import (
+    is_relation_made,
+    relation_ids,
+    relation_get as _relation_get,
+    local_unit,
+    relation_set as _relation_set,
+    leader_get as _leader_get,
+    leader_set,
+    is_leader,
+)
+
+
+"""
+This helper provides functions to support use of a peer relation
+for basic key/value storage, with the added benefit that all storage
+can be replicated across peer units.
+
+Requirement to use:
+
+To use this, the "peer_echo()" method has to be called form the peer
+relation's relation-changed hook:
+
+@hooks.hook("cluster-relation-changed") # Adapt the to your peer relation name
+def cluster_relation_changed():
+    peer_echo()
+
+Once this is done, you can use peer storage from anywhere:
+
+@hooks.hook("some-hook")
+def some_hook():
+    # You can store and retrieve key/values this way:
+    if is_relation_made("cluster"):  # from charmhelpers.core.hookenv
+        # There are peers available so we can work with peer storage
+        peer_store("mykey", "myvalue")
+        value = peer_retrieve("mykey")
+        print value
+    else:
+        print "No peers joind the relation, cannot share key/values :("
+"""
+
+
+def leader_get(attribute=None, rid=None):
+    """Wrapper to ensure that settings are migrated from the peer relation.
+
+    This is to support upgrading an environment that does not support
+    Juju leadership election to one that does.
+
+    If a setting is not extant in the leader-get but is on the relation-get
+    peer rel, it is migrated and marked as such so that it is not re-migrated.
+    """
+    migration_key = '__leader_get_migrated_settings__'
+    if not is_leader():
+        return _leader_get(attribute=attribute)
+
+    settings_migrated = False
+    leader_settings = _leader_get(attribute=attribute)
+    previously_migrated = _leader_get(attribute=migration_key)
+
+    if previously_migrated:
+        migrated = set(json.loads(previously_migrated))
+    else:
+        migrated = set([])
+
+    try:
+        if migration_key in leader_settings:
+            del leader_settings[migration_key]
+    except TypeError:
+        pass
+
+    if attribute:
+        if attribute in migrated:
+            return leader_settings
+
+        # If attribute not present in leader db, check if this unit has set
+        # the attribute in the peer relation
+        if not leader_settings:
+            peer_setting = _relation_get(attribute=attribute, unit=local_unit(),
+                                         rid=rid)
+            if peer_setting:
+                leader_set(settings={attribute: peer_setting})
+                leader_settings = peer_setting
+
+        if leader_settings:
+            settings_migrated = True
+            migrated.add(attribute)
+    else:
+        r_settings = _relation_get(unit=local_unit(), rid=rid)
+        if r_settings:
+            for key in set(r_settings.keys()).difference(migrated):
+                # Leader setting wins
+                if not leader_settings.get(key):
+                    leader_settings[key] = r_settings[key]
+
+                settings_migrated = True
+                migrated.add(key)
+
+            if settings_migrated:
+                leader_set(**leader_settings)
+
+    if migrated and settings_migrated:
+        migrated = json.dumps(list(migrated))
+        leader_set(settings={migration_key: migrated})
+
+    return leader_settings
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Attempt to use leader-set if supported in the current version of Juju,
+    otherwise falls back on relation-set.
+
+    Note that we only attempt to use leader-set if the provided relation_id is
+    a peer relation id or no relation id is provided (in which case we assume
+    we are within the peer relation context).
+    """
+    try:
+        if relation_id in relation_ids('cluster'):
+            return leader_set(settings=relation_settings, **kwargs)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_set(relation_id=relation_id,
+                             relation_settings=relation_settings, **kwargs)
+
+
+def relation_get(attribute=None, unit=None, rid=None):
+    """Attempt to use leader-get if supported in the current version of Juju,
+    otherwise falls back on relation-get.
+
+    Note that we only attempt to use leader-get if the provided rid is a peer
+    relation id or no relation id is provided (in which case we assume we are
+    within the peer relation context).
+    """
+    try:
+        if rid in relation_ids('cluster'):
+            return leader_get(attribute, rid)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_get(attribute=attribute, rid=rid, unit=unit)
+
+
+def peer_retrieve(key, relation_name='cluster'):
+    """Retrieve a named key from peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        return relation_get(attribute=key, rid=cluster_rid,
+                            unit=local_unit())
+    else:
+        raise ValueError('Unable to detect'
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_retrieve_by_prefix(prefix, relation_name='cluster', delimiter='_',
+                            inc_list=None, exc_list=None):
+    """ Retrieve k/v pairs given a prefix and filter using {inc,exc}_list """
+    inc_list = inc_list if inc_list else []
+    exc_list = exc_list if exc_list else []
+    peerdb_settings = peer_retrieve('-', relation_name=relation_name)
+    matched = {}
+    if peerdb_settings is None:
+        return matched
+    for k, v in peerdb_settings.items():
+        full_prefix = prefix + delimiter
+        if k.startswith(full_prefix):
+            new_key = k.replace(full_prefix, '')
+            if new_key in exc_list:
+                continue
+            if new_key in inc_list or len(inc_list) == 0:
+                matched[new_key] = v
+    return matched
+
+
+def peer_store(key, value, relation_name='cluster'):
+    """Store the key/value pair on the named peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        relation_set(relation_id=cluster_rid,
+                     relation_settings={key: value})
+    else:
+        raise ValueError('Unable to detect '
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_echo(includes=None, force=False):
+    """Echo filtered attributes back onto the same relation for storage.
+
+    This is a requirement to use the peerstorage module - it needs to be called
+    from the peer relation's changed hook.
+
+    If Juju leader support exists this will be a noop unless force is True.
+    """
+    try:
+        is_leader()
+    except NotImplementedError:
+        pass
+    else:
+        if not force:
+            return  # NOOP if leader-election is supported
+
+    # Use original non-leader calls
+    relation_get = _relation_get
+    relation_set = _relation_set
+
+    rdata = relation_get()
+    echo_data = {}
+    if includes is None:
+        echo_data = rdata.copy()
+        for ex in ['private-address', 'public-address']:
+            if ex in echo_data:
+                echo_data.pop(ex)
+    else:
+        for attribute, value in six.iteritems(rdata):
+            for include in includes:
+                if include in attribute:
+                    echo_data[attribute] = value
+    if len(echo_data) > 0:
+        relation_set(relation_settings=echo_data)
+
+
+def peer_store_and_set(relation_id=None, peer_relation_name='cluster',
+                       peer_store_fatal=False, relation_settings=None,
+                       delimiter='_', **kwargs):
+    """Store passed-in arguments both in argument relation and in peer storage.
+
+    It functions like doing relation_set() and peer_store() at the same time,
+    with the same data.
+
+    @param relation_id: the id of the relation to store the data on. Defaults
+                        to the current relation.
+    @param peer_store_fatal: Set to True, the function will raise an exception
+                             should the peer storage not be available."""
+
+    relation_settings = relation_settings if relation_settings else {}
+    relation_set(relation_id=relation_id,
+                 relation_settings=relation_settings,
+                 **kwargs)
+    if is_relation_made(peer_relation_name):
+        for key, value in six.iteritems(dict(list(kwargs.items()) +
+                                             list(relation_settings.items()))):
+            key_prefix = relation_id or current_relation_id()
+            peer_store(key_prefix + delimiter + key,
+                       value,
+                       relation_name=peer_relation_name)
+    else:
+        if peer_store_fatal:
+            raise ValueError('Unable to detect '
+                             'peer relation {}'.format(peer_relation_name))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/python.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..84cba8c4eba34fdd705f4ee39628ebd33b5175a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/python.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+# deprecated aliases for backwards compatibility
+from charmhelpers.fetch.python import debug  # noqa
+from charmhelpers.fetch.python import packages  # noqa
+from charmhelpers.fetch.python import rpdb  # noqa
+from charmhelpers.fetch.python import version  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/saltstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/saltstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d74f4039379b608b5c076fd96c906ff5237f1f83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/saltstack/__init__.py
@@ -0,0 +1,116 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Charm Helpers saltstack - declare the state of your machines.
+
+This helper enables you to declare your machine state, rather than
+program it procedurally (and have to test each change to your procedures).
+Your install hook can be as simple as::
+
+    {{{
+    from charmhelpers.contrib.saltstack import (
+        install_salt_support,
+        update_machine_state,
+    )
+
+
+    def install():
+        install_salt_support()
+        update_machine_state('machine_states/dependencies.yaml')
+        update_machine_state('machine_states/installed.yaml')
+    }}}
+
+and won't need to change (nor will its tests) when you change the machine
+state.
+
+It's using a python package called salt-minion which allows various formats for
+specifying resources, such as::
+
+    {{{
+    /srv/{{ basedir }}:
+        file.directory:
+            - group: ubunet
+            - user: ubunet
+            - require:
+                - user: ubunet
+            - recurse:
+                - user
+                - group
+
+    ubunet:
+        group.present:
+            - gid: 1500
+        user.present:
+            - uid: 1500
+            - gid: 1500
+            - createhome: False
+            - require:
+                - group: ubunet
+    }}}
+
+The docs for all the different state definitions are at:
+    http://docs.saltstack.com/ref/states/all/
+
+
+TODO:
+  * Add test helpers which will ensure that machine state definitions
+    are functionally (but not necessarily logically) correct (ie. getting
+    salt to parse all state defs.
+  * Add a link to a public bootstrap charm example / blogpost.
+  * Find a way to obviate the need to use the grains['charm_dir'] syntax
+    in templates.
+"""
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import subprocess
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+
+
+salt_grains_path = '/etc/salt/grains'
+
+
+def install_salt_support(from_ppa=True):
+    """Installs the salt-minion helper for machine state.
+
+    By default the salt-minion package is installed from
+    the saltstack PPA. If from_ppa is False you must ensure
+    that the salt-minion package is available in the apt cache.
+    """
+    if from_ppa:
+        subprocess.check_call([
+            '/usr/bin/add-apt-repository',
+            '--yes',
+            'ppa:saltstack/salt',
+        ])
+        subprocess.check_call(['/usr/bin/apt-get', 'update'])
+    # We install salt-common as salt-minion would run the salt-minion
+    # daemon.
+    charmhelpers.fetch.apt_install('salt-common')
+
+
+def update_machine_state(state_path):
+    """Update the machine state using the provided state declaration."""
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        salt_grains_path)
+    subprocess.check_call([
+        'salt-call',
+        '--local',
+        'state.template',
+        state_path,
+    ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d238b529e44ad2761d86e96b4845589f8e951c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/__init__.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def generate_selfsigned(keyfile, certfile, keysize="1024", config=None, subject=None, cn=None):
+    """Generate selfsigned SSL keypair
+
+    You must provide one of the 3 optional arguments:
+    config, subject or cn
+    If more than one is provided the leftmost will be used
+
+    Arguments:
+    keyfile -- (required) full path to the keyfile to be created
+    certfile -- (required) full path to the certfile to be created
+    keysize -- (optional) SSL key length
+    config -- (optional) openssl configuration file
+    subject -- (optional) dictionary with SSL subject variables
+    cn -- (optional) cerfificate common name
+
+    Required keys in subject dict:
+    cn -- Common name (eq. FQDN)
+
+    Optional keys in subject dict
+    country -- Country Name (2 letter code)
+    state -- State or Province Name (full name)
+    locality -- Locality Name (eg, city)
+    organization -- Organization Name (eg, company)
+    organizational_unit -- Organizational Unit Name (eg, section)
+    email -- Email Address
+    """
+
+    cmd = []
+    if config:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-config", config]
+    elif subject:
+        ssl_subject = ""
+        if "country" in subject:
+            ssl_subject = ssl_subject + "/C={}".format(subject["country"])
+        if "state" in subject:
+            ssl_subject = ssl_subject + "/ST={}".format(subject["state"])
+        if "locality" in subject:
+            ssl_subject = ssl_subject + "/L={}".format(subject["locality"])
+        if "organization" in subject:
+            ssl_subject = ssl_subject + "/O={}".format(subject["organization"])
+        if "organizational_unit" in subject:
+            ssl_subject = ssl_subject + "/OU={}".format(subject["organizational_unit"])
+        if "cn" in subject:
+            ssl_subject = ssl_subject + "/CN={}".format(subject["cn"])
+        else:
+            hookenv.log("When using \"subject\" argument you must "
+                        "provide \"cn\" field at very least")
+            return False
+        if "email" in subject:
+            ssl_subject = ssl_subject + "/emailAddress={}".format(subject["email"])
+
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", ssl_subject]
+    elif cn:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", "/CN={}".format(cn)]
+
+    if not cmd:
+        hookenv.log("No config, subject or cn provided,"
+                    "unable to generate self signed SSL certificates")
+        return False
+    try:
+        subprocess.check_call(cmd)
+        return True
+    except Exception as e:
+        print("Execution of openssl command failed:\n{}".format(e))
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/service.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..06b534ffa3b0de97a56bac4060c39a9a4485b0c2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/ssl/service.py
@@ -0,0 +1,277 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from os.path import join as path_join
+from os.path import exists
+import subprocess
+
+from charmhelpers.core.hookenv import log, DEBUG
+
+STD_CERT = "standard"
+
+# Mysql server is fairly picky about cert creation
+# and types, spec its creation separately for now.
+MYSQL_CERT = "mysql"
+
+
+class ServiceCA(object):
+
+    default_expiry = str(365 * 2)
+    default_ca_expiry = str(365 * 6)
+
+    def __init__(self, name, ca_dir, cert_type=STD_CERT):
+        self.name = name
+        self.ca_dir = ca_dir
+        self.cert_type = cert_type
+
+    ###############
+    # Hook Helper API
+    @staticmethod
+    def get_ca(type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca_path = os.path.join(os.environ['CHARM_DIR'], 'ca')
+        ca = ServiceCA(service_name, ca_path, type)
+        ca.init()
+        return ca
+
+    @classmethod
+    def get_service_cert(cls, type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca = cls.get_ca()
+        crt, key = ca.get_or_create_cert(service_name)
+        return crt, key, ca.get_ca_bundle()
+
+    ###############
+
+    def init(self):
+        log("initializing service ca", level=DEBUG)
+        if not exists(self.ca_dir):
+            self._init_ca_dir(self.ca_dir)
+            self._init_ca()
+
+    @property
+    def ca_key(self):
+        return path_join(self.ca_dir, 'private', 'cacert.key')
+
+    @property
+    def ca_cert(self):
+        return path_join(self.ca_dir, 'cacert.pem')
+
+    @property
+    def ca_conf(self):
+        return path_join(self.ca_dir, 'ca.cnf')
+
+    @property
+    def signing_conf(self):
+        return path_join(self.ca_dir, 'signing.cnf')
+
+    def _init_ca_dir(self, ca_dir):
+        os.mkdir(ca_dir)
+        for i in ['certs', 'crl', 'newcerts', 'private']:
+            sd = path_join(ca_dir, i)
+            if not exists(sd):
+                os.mkdir(sd)
+
+        if not exists(path_join(ca_dir, 'serial')):
+            with open(path_join(ca_dir, 'serial'), 'w') as fh:
+                fh.write('02\n')
+
+        if not exists(path_join(ca_dir, 'index.txt')):
+            with open(path_join(ca_dir, 'index.txt'), 'w') as fh:
+                fh.write('')
+
+    def _init_ca(self):
+        """Generate the root ca's cert and key.
+        """
+        if not exists(path_join(self.ca_dir, 'ca.cnf')):
+            with open(path_join(self.ca_dir, 'ca.cnf'), 'w') as fh:
+                fh.write(
+                    CA_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if not exists(path_join(self.ca_dir, 'signing.cnf')):
+            with open(path_join(self.ca_dir, 'signing.cnf'), 'w') as fh:
+                fh.write(
+                    SIGNING_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if exists(self.ca_cert) or exists(self.ca_key):
+            raise RuntimeError("Initialized called when CA already exists")
+        cmd = ['openssl', 'req', '-config', self.ca_conf,
+               '-x509', '-nodes', '-newkey', 'rsa',
+               '-days', self.default_ca_expiry,
+               '-keyout', self.ca_key, '-out', self.ca_cert,
+               '-outform', 'PEM']
+        output = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        log("CA Init:\n %s" % output, level=DEBUG)
+
+    def get_conf_variables(self):
+        return dict(
+            org_name="juju",
+            org_unit_name="%s service" % self.name,
+            common_name=self.name,
+            ca_dir=self.ca_dir)
+
+    def get_or_create_cert(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        return self.create_certificate(common_name)
+
+    def create_certificate(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        csr_p = path_join(self.ca_dir, "certs", "%s.csr" % common_name)
+        self._create_certificate(common_name, key_p, csr_p, crt_p)
+        return self.get_certificate(common_name)
+
+    def get_certificate(self, common_name):
+        if common_name not in self:
+            raise ValueError("No certificate for %s" % common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        with open(crt_p) as fh:
+            crt = fh.read()
+        with open(key_p) as fh:
+            key = fh.read()
+        return crt, key
+
+    def __contains__(self, common_name):
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        return exists(crt_p)
+
+    def _create_certificate(self, common_name, key_p, csr_p, crt_p):
+        template_vars = self.get_conf_variables()
+        template_vars['common_name'] = common_name
+        subj = '/O=%(org_name)s/OU=%(org_unit_name)s/CN=%(common_name)s' % (
+            template_vars)
+
+        log("CA Create Cert %s" % common_name, level=DEBUG)
+        cmd = ['openssl', 'req', '-sha1', '-newkey', 'rsa:2048',
+               '-nodes', '-days', self.default_expiry,
+               '-keyout', key_p, '-out', csr_p, '-subj', subj]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+        cmd = ['openssl', 'rsa', '-in', key_p, '-out', key_p]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+        log("CA Sign Cert %s" % common_name, level=DEBUG)
+        if self.cert_type == MYSQL_CERT:
+            cmd = ['openssl', 'x509', '-req',
+                   '-in', csr_p, '-days', self.default_expiry,
+                   '-CA', self.ca_cert, '-CAkey', self.ca_key,
+                   '-set_serial', '01', '-out', crt_p]
+        else:
+            cmd = ['openssl', 'ca', '-config', self.signing_conf,
+                   '-extensions', 'req_extensions',
+                   '-days', self.default_expiry, '-notext',
+                   '-in', csr_p, '-out', crt_p, '-subj', subj, '-batch']
+        log("running %s" % " ".join(cmd), level=DEBUG)
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+    def get_ca_bundle(self):
+        with open(self.ca_cert) as fh:
+            return fh.read()
+
+
+CA_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = ca_distinguished_name
+
+x509_extensions         = ca_extensions
+
+[ ca_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s Certificate Authority
+
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ ca_extensions ]
+basicConstraints        = critical,CA:true
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = cRLSign, keyCertSign
+"""
+
+
+SIGNING_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = req_distinguished_name
+
+x509_extensions         = req_extensions
+
+[ req_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s machine resources
+commonName              = %(common_name)s
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ req_extensions ]
+basicConstraints        = CA:false
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = digitalSignature, keyEncipherment, keyAgreement
+extendedKeyUsage        = serverAuth, clientAuth
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/bcache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/bcache.py
new file mode 100644
index 0000000000000000000000000000000000000000..605991e16a4238f4ed46fbf0791048187f375c5c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/bcache.py
@@ -0,0 +1,74 @@
+# Copyright 2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import json
+
+from charmhelpers.core.hookenv import log
+
+stats_intervals = ['stats_day', 'stats_five_minute',
+                   'stats_hour', 'stats_total']
+
+SYSFS = '/sys'
+
+
+class Bcache(object):
+    """Bcache behaviour
+    """
+
+    def __init__(self, cachepath):
+        self.cachepath = cachepath
+
+    @classmethod
+    def fromdevice(cls, devname):
+        return cls('{}/block/{}/bcache'.format(SYSFS, devname))
+
+    def __str__(self):
+        return self.cachepath
+
+    def get_stats(self, interval):
+        """Get cache stats
+        """
+        intervaldir = 'stats_{}'.format(interval)
+        path = "{}/{}".format(self.cachepath, intervaldir)
+        out = dict()
+        for elem in os.listdir(path):
+            out[elem] = open('{}/{}'.format(path, elem)).read().strip()
+        return out
+
+
+def get_bcache_fs():
+    """Return all cache sets
+    """
+    cachesetroot = "{}/fs/bcache".format(SYSFS)
+    try:
+        dirs = os.listdir(cachesetroot)
+    except OSError:
+        log("No bcache fs found")
+        return []
+    cacheset = set([Bcache('{}/{}'.format(cachesetroot, d)) for d in dirs if not d.startswith('register')])
+    return cacheset
+
+
+def get_stats_action(cachespec, interval):
+    """Action for getting bcache statistics for a given cachespec.
+    Cachespec can either be a device name, eg. 'sdb', which will retrieve
+    cache stats for the given device, or 'global', which will retrieve stats
+    for all cachesets
+    """
+    if cachespec == 'global':
+        caches = get_bcache_fs()
+    else:
+        caches = [Bcache.fromdevice(cachespec)]
+    res = dict((c.cachepath, c.get_stats(interval)) for c in caches)
+    return json.dumps(res, indent=4, separators=(',', ': '))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/ceph.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/ceph.py
new file mode 100644
index 0000000000000000000000000000000000000000..814d5c72bc246c9536d3bb5975ade1c7fbe989e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/ceph.py
@@ -0,0 +1,1810 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import collections
+import errno
+import hashlib
+import math
+import six
+
+import os
+import shutil
+import json
+import time
+import uuid
+
+from subprocess import (
+    check_call,
+    check_output,
+    CalledProcessError,
+)
+from charmhelpers.core.hookenv import (
+    config,
+    service_name,
+    local_unit,
+    relation_get,
+    relation_ids,
+    relation_set,
+    related_units,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core.host import (
+    mount,
+    mounts,
+    service_start,
+    service_stop,
+    service_running,
+    umount,
+    cmp_pkgrevno,
+)
+from charmhelpers.fetch import (
+    apt_install,
+)
+from charmhelpers.core.unitdata import kv
+
+from charmhelpers.core.kernel import modprobe
+from charmhelpers.contrib.openstack.utils import config_flags_parser
+
+KEYRING = '/etc/ceph/ceph.client.{}.keyring'
+KEYFILE = '/etc/ceph/ceph.client.{}.key'
+
+CEPH_CONF = """[global]
+auth supported = {auth}
+keyring = {keyring}
+mon host = {mon_hosts}
+log to syslog = {use_syslog}
+err to syslog = {use_syslog}
+clog to syslog = {use_syslog}
+"""
+
+# The number of placement groups per OSD to target for placement group
+# calculations. This number is chosen as 100 due to the ceph PG Calc
+# documentation recommending to choose 100 for clusters which are not
+# expected to increase in the foreseeable future. Since the majority of the
+# calculations are done on deployment, target the case of non-expanding
+# clusters as the default.
+DEFAULT_PGS_PER_OSD_TARGET = 100
+DEFAULT_POOL_WEIGHT = 10.0
+LEGACY_PG_COUNT = 200
+DEFAULT_MINIMUM_PGS = 2
+AUTOSCALER_DEFAULT_PGS = 32
+
+
+class OsdPostUpgradeError(Exception):
+    """Error class for OSD post-upgrade operations."""
+    pass
+
+
+class OSDSettingConflict(Exception):
+    """Error class for conflicting osd setting requests."""
+    pass
+
+
+class OSDSettingNotAllowed(Exception):
+    """Error class for a disallowed setting."""
+    pass
+
+
+OSD_SETTING_EXCEPTIONS = (OSDSettingConflict, OSDSettingNotAllowed)
+
+OSD_SETTING_WHITELIST = [
+    'osd heartbeat grace',
+    'osd heartbeat interval',
+]
+
+
+def _order_dict_by_key(rdict):
+    """Convert a dictionary into an OrderedDict sorted by key.
+
+    :param rdict: Dictionary to be ordered.
+    :type rdict: dict
+    :returns: Ordered Dictionary.
+    :rtype: collections.OrderedDict
+    """
+    return collections.OrderedDict(sorted(rdict.items(), key=lambda k: k[0]))
+
+
+def get_osd_settings(relation_name):
+    """Consolidate requested osd settings from all clients.
+
+    Consolidate requested osd settings from all clients. Check that the
+    requested setting is on the whitelist and it does not conflict with
+    any other requested settings.
+
+    :returns: Dictionary of settings
+    :rtype: dict
+
+    :raises: OSDSettingNotAllowed
+    :raises: OSDSettingConflict
+    """
+    rel_ids = relation_ids(relation_name)
+    osd_settings = {}
+    for relid in rel_ids:
+        for unit in related_units(relid):
+            unit_settings = relation_get('osd-settings', unit, relid) or '{}'
+            unit_settings = json.loads(unit_settings)
+            for key, value in unit_settings.items():
+                if key not in OSD_SETTING_WHITELIST:
+                    msg = 'Illegal settings "{}"'.format(key)
+                    raise OSDSettingNotAllowed(msg)
+                if key in osd_settings:
+                    if osd_settings[key] != unit_settings[key]:
+                        msg = 'Conflicting settings for "{}"'.format(key)
+                        raise OSDSettingConflict(msg)
+                else:
+                    osd_settings[key] = value
+    return _order_dict_by_key(osd_settings)
+
+
+def send_osd_settings():
+    """Pass on requested OSD settings to osd units."""
+    try:
+        settings = get_osd_settings('client')
+    except OSD_SETTING_EXCEPTIONS as e:
+        # There is a problem with the settings, not passing them on. Update
+        # status will notify the user.
+        log(e, level=ERROR)
+        return
+    data = {
+        'osd-settings': json.dumps(settings, sort_keys=True)}
+    for relid in relation_ids('osd'):
+        relation_set(relation_id=relid,
+                     relation_settings=data)
+
+
+def validator(value, valid_type, valid_range=None):
+    """
+    Used to validate these: http://docs.ceph.com/docs/master/rados/operations/pools/#set-pool-values
+    Example input:
+        validator(value=1,
+                  valid_type=int,
+                  valid_range=[0, 2])
+    This says I'm testing value=1.  It must be an int inclusive in [0,2]
+
+    :param value: The value to validate
+    :param valid_type: The type that value should be.
+    :param valid_range: A range of values that value can assume.
+    :return:
+    """
+    assert isinstance(value, valid_type), "{} is not a {}".format(
+        value,
+        valid_type)
+    if valid_range is not None:
+        assert isinstance(valid_range, list), \
+            "valid_range must be a list, was given {}".format(valid_range)
+        # If we're dealing with strings
+        if isinstance(value, six.string_types):
+            assert value in valid_range, \
+                "{} is not in the list {}".format(value, valid_range)
+        # Integer, float should have a min and max
+        else:
+            if len(valid_range) != 2:
+                raise ValueError(
+                    "Invalid valid_range list of {} for {}.  "
+                    "List must be [min,max]".format(valid_range, value))
+            assert value >= valid_range[0], \
+                "{} is less than minimum allowed value of {}".format(
+                    value, valid_range[0])
+            assert value <= valid_range[1], \
+                "{} is greater than maximum allowed value of {}".format(
+                    value, valid_range[1])
+
+
+class PoolCreationError(Exception):
+    """
+    A custom error to inform the caller that a pool creation failed.  Provides an error message
+    """
+
+    def __init__(self, message):
+        super(PoolCreationError, self).__init__(message)
+
+
+class Pool(object):
+    """
+    An object oriented approach to Ceph pool creation. This base class is inherited by ReplicatedPool and ErasurePool.
+    Do not call create() on this base class as it will not do anything.  Instantiate a child class and call create().
+    """
+
+    def __init__(self, service, name):
+        self.service = service
+        self.name = name
+
+    # Create the pool if it doesn't exist already
+    # To be implemented by subclasses
+    def create(self):
+        pass
+
+    def add_cache_tier(self, cache_pool, mode):
+        """
+        Adds a new cache tier to an existing pool.
+        :param cache_pool: six.string_types.  The cache tier pool name to add.
+        :param mode: six.string_types. The caching mode to use for this pool.  valid range = ["readonly", "writeback"]
+        :return: None
+        """
+        # Check the input types and values
+        validator(value=cache_pool, valid_type=six.string_types)
+        validator(value=mode, valid_type=six.string_types, valid_range=["readonly", "writeback"])
+
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'add', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, mode])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'set-overlay', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'pool', 'set', cache_pool, 'hit_set_type', 'bloom'])
+
+    def remove_cache_tier(self, cache_pool):
+        """
+        Removes a cache tier from Ceph.  Flushes all dirty objects from writeback pools and waits for that to complete.
+        :param cache_pool: six.string_types.  The cache tier pool name to remove.
+        :return: None
+        """
+        # read-only is easy, writeback is much harder
+        mode = get_cache_mode(self.service, cache_pool)
+        if mode == 'readonly':
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, 'none'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+        elif mode == 'writeback':
+            pool_forward_cmd = ['ceph', '--id', self.service, 'osd', 'tier',
+                                'cache-mode', cache_pool, 'forward']
+            if cmp_pkgrevno('ceph-common', '10.1') >= 0:
+                # Jewel added a mandatory flag
+                pool_forward_cmd.append('--yes-i-really-mean-it')
+
+            check_call(pool_forward_cmd)
+            # Flush the cache and wait for it to return
+            check_call(['rados', '--id', self.service, '-p', cache_pool, 'cache-flush-evict-all'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove-overlay', self.name])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+    def get_pgs(self, pool_size, percent_data=DEFAULT_POOL_WEIGHT,
+                device_class=None):
+        """Return the number of placement groups to use when creating the pool.
+
+        Returns the number of placement groups which should be specified when
+        creating the pool. This is based upon the calculation guidelines
+        provided by the Ceph Placement Group Calculator (located online at
+        http://ceph.com/pgcalc/).
+
+        The number of placement groups are calculated using the following:
+
+            (Target PGs per OSD) * (OSD #) * (%Data)
+            ----------------------------------------
+                         (Pool size)
+
+        Per the upstream guidelines, the OSD # should really be considered
+        based on the number of OSDs which are eligible to be selected by the
+        pool. Since the pool creation doesn't specify any of CRUSH set rules,
+        the default rule will be dependent upon the type of pool being
+        created (replicated or erasure).
+
+        This code makes no attempt to determine the number of OSDs which can be
+        selected for the specific rule, rather it is left to the user to tune
+        in the form of 'expected-osd-count' config option.
+
+        :param pool_size: int. pool_size is either the number of replicas for
+            replicated pools or the K+M sum for erasure coded pools
+        :param percent_data: float. the percentage of data that is expected to
+            be contained in the pool for the specific OSD set. Default value
+            is to assume 10% of the data is for this pool, which is a
+            relatively low % of the data but allows for the pg_num to be
+            increased. NOTE: the default is primarily to handle the scenario
+            where related charms requiring pools has not been upgraded to
+            include an update to indicate their relative usage of the pools.
+        :param device_class: str. class of storage to use for basis of pgs
+            calculation; ceph supports nvme, ssd and hdd by default based
+            on presence of devices of each type in the deployment.
+        :return: int.  The number of pgs to use.
+        """
+
+        # Note: This calculation follows the approach that is provided
+        # by the Ceph PG Calculator located at http://ceph.com/pgcalc/.
+        validator(value=pool_size, valid_type=int)
+
+        # Ensure that percent data is set to something - even with a default
+        # it can be set to None, which would wreak havoc below.
+        if percent_data is None:
+            percent_data = DEFAULT_POOL_WEIGHT
+
+        # If the expected-osd-count is specified, then use the max between
+        # the expected-osd-count and the actual osd_count
+        osd_list = get_osds(self.service, device_class)
+        expected = config('expected-osd-count') or 0
+
+        if osd_list:
+            if device_class:
+                osd_count = len(osd_list)
+            else:
+                osd_count = max(expected, len(osd_list))
+
+            # Log a message to provide some insight if the calculations claim
+            # to be off because someone is setting the expected count and
+            # there are more OSDs in reality. Try to make a proper guess
+            # based upon the cluster itself.
+            if not device_class and expected and osd_count != expected:
+                log("Found more OSDs than provided expected count. "
+                    "Using the actual count instead", INFO)
+        elif expected:
+            # Use the expected-osd-count in older ceph versions to allow for
+            # a more accurate pg calculations
+            osd_count = expected
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            return LEGACY_PG_COUNT
+
+        percent_data /= 100.0
+        target_pgs_per_osd = config('pgs-per-osd') or DEFAULT_PGS_PER_OSD_TARGET
+        num_pg = (target_pgs_per_osd * osd_count * percent_data) // pool_size
+
+        # NOTE: ensure a sane minimum number of PGS otherwise we don't get any
+        #       reasonable data distribution in minimal OSD configurations
+        if num_pg < DEFAULT_MINIMUM_PGS:
+            num_pg = DEFAULT_MINIMUM_PGS
+
+        # The CRUSH algorithm has a slight optimization for placement groups
+        # with powers of 2 so find the nearest power of 2. If the nearest
+        # power of 2 is more than 25% below the original value, the next
+        # highest value is used. To do this, find the nearest power of 2 such
+        # that 2^n <= num_pg, check to see if its within the 25% tolerance.
+        exponent = math.floor(math.log(num_pg, 2))
+        nearest = 2 ** exponent
+        if (num_pg - nearest) > (num_pg * 0.25):
+            # Choose the next highest power of 2 since the nearest is more
+            # than 25% below the original value.
+            return int(nearest * 2)
+        else:
+            return int(nearest)
+
+
+class ReplicatedPool(Pool):
+    def __init__(self, service, name, pg_num=None, replicas=2,
+                 percent_data=10.0, app_name=None):
+        super(ReplicatedPool, self).__init__(service=service, name=name)
+        self.replicas = replicas
+        self.percent_data = percent_data
+        if pg_num:
+            # Since the number of placement groups were specified, ensure
+            # that there aren't too many created.
+            max_pgs = self.get_pgs(self.replicas, 100.0)
+            self.pg_num = min(pg_num, max_pgs)
+        else:
+            self.pg_num = self.get_pgs(self.replicas, percent_data)
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, self.pg_num)
+                    ),
+                    self.name, str(self.pg_num)
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(self.pg_num)
+                ]
+
+            try:
+                check_call(cmd)
+                # Set the pool replica size
+                update_pool(client=self.service,
+                            pool=self.name,
+                            settings={'size': str(self.replicas)})
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+
+# Default jerasure erasure coded pool
+class ErasurePool(Pool):
+    def __init__(self, service, name, erasure_code_profile="default",
+                 percent_data=10.0, app_name=None):
+        super(ErasurePool, self).__init__(service=service, name=name)
+        self.erasure_code_profile = erasure_code_profile
+        self.percent_data = percent_data
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            # Try to find the erasure profile information in order to properly
+            # size the number of placement groups. The size of an erasure
+            # coded placement group is calculated as k+m.
+            erasure_profile = get_erasure_profile(self.service,
+                                                  self.erasure_code_profile)
+
+            # Check for errors
+            if erasure_profile is None:
+                msg = ("Failed to discover erasure profile named "
+                       "{}".format(self.erasure_code_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+            if 'k' not in erasure_profile or 'm' not in erasure_profile:
+                # Error
+                msg = ("Unable to find k (data chunks) or m (coding chunks) "
+                       "in erasure profile {}".format(erasure_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+
+            k = int(erasure_profile['k'])
+            m = int(erasure_profile['m'])
+            pgs = self.get_pgs(k + m, self.percent_data)
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, pgs)
+                    ),
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+
+            try:
+                check_call(cmd)
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+    """Get an existing erasure code profile if it already exists.
+       Returns json formatted output"""
+
+
+def enabled_manager_modules():
+    """Return a list of enabled manager modules.
+
+    :rtype: List[str]
+    """
+    cmd = ['ceph', 'mgr', 'module', 'ls']
+    try:
+        modules = check_output(cmd)
+        if six.PY3:
+            modules = modules.decode('UTF-8')
+    except CalledProcessError as e:
+        log("Failed to list ceph modules: {}".format(e), WARNING)
+        return []
+    modules = json.loads(modules)
+    return modules['enabled_modules']
+
+
+def enable_pg_autoscale(service, pool_name):
+    """
+    Enable Ceph's PG autoscaler for the specified pool.
+
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types. The name of the pool to enable sutoscaling on
+    :raise: CalledProcessError if the command fails
+    """
+    check_call(['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, 'pg_autoscale_mode', 'on'])
+
+
+def get_mon_map(service):
+    """
+    Returns the current monitor map.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :return: json string. :raise: ValueError if the monmap fails to parse.
+      Also raises CalledProcessError if our ceph command fails
+    """
+    try:
+        mon_status = check_output(['ceph', '--id', service,
+                                   'mon_status', '--format=json'])
+        if six.PY3:
+            mon_status = mon_status.decode('UTF-8')
+        try:
+            return json.loads(mon_status)
+        except ValueError as v:
+            log("Unable to parse mon_status json: {}. Error: {}"
+                .format(mon_status, str(v)))
+            raise
+    except CalledProcessError as e:
+        log("mon_status command failed with message: {}"
+            .format(str(e)))
+        raise
+
+
+def hash_monitor_names(service):
+    """
+    Uses the get_mon_map() function to get information about the monitor
+    cluster.
+    Hash the name of each monitor.  Return a sorted list of monitor hashes
+    in an ascending order.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :rtype : dict.   json dict of monitor name, ip address and rank
+    example: {
+        'name': 'ip-172-31-13-165',
+        'rank': 0,
+        'addr': '172.31.13.165:6789/0'}
+    """
+    try:
+        hash_list = []
+        monitor_list = get_mon_map(service=service)
+        if monitor_list['monmap']['mons']:
+            for mon in monitor_list['monmap']['mons']:
+                hash_list.append(
+                    hashlib.sha224(mon['name'].encode('utf-8')).hexdigest())
+            return sorted(hash_list)
+        else:
+            return None
+    except (ValueError, CalledProcessError):
+        raise
+
+
+def monitor_key_delete(service, key):
+    """
+    Delete a key and value pair from the monitor cluster
+    :param service: six.string_types. The Ceph user name to run the command under
+    Deletes a key value pair on the monitor cluster.
+    :param key: six.string_types.  The key to delete.
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'del', str(key)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_set(service, key, value):
+    """
+    Sets a key value pair on the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to set.
+    :param value: The value to set.  This will be converted to a string
+        before setting
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'put', str(key), str(value)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_get(service, key):
+    """
+    Gets the value of an existing key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for.
+    :return: Returns the value of that key or None if not found.
+    """
+    try:
+        output = check_output(
+            ['ceph', '--id', service,
+             'config-key', 'get', str(key)]).decode('UTF-8')
+        return output
+    except CalledProcessError as e:
+        log("Monitor config-key get failed with message: {}".format(
+            e.output))
+        return None
+
+
+def monitor_key_exists(service, key):
+    """
+    Searches for the existence of a key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for
+    :return: Returns True if the key exists, False if not and raises an
+     exception if an unknown error occurs. :raise: CalledProcessError if
+     an unknown error occurs
+    """
+    try:
+        check_call(
+            ['ceph', '--id', service,
+             'config-key', 'exists', str(key)])
+        # I can return true here regardless because Ceph returns
+        # ENOENT if the key wasn't found
+        return True
+    except CalledProcessError as e:
+        if e.returncode == errno.ENOENT:
+            return False
+        else:
+            log("Unknown error from ceph config-get exists: {} {}".format(
+                e.returncode, e.output))
+            raise
+
+
+def get_erasure_profile(service, name):
+    """
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name:
+    :return:
+    """
+    try:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'erasure-code-profile', 'get',
+                            name, '--format=json'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+        return json.loads(out)
+    except (CalledProcessError, OSError, ValueError):
+        return None
+
+
+def pool_set(service, pool_name, key, value):
+    """
+    Sets a value for a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param key: six.string_types
+    :param value:
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, key,
+           str(value).lower()]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def snapshot_pool(service, pool_name, snapshot_name):
+    """
+    Snapshots a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'mksnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_pool_snapshot(service, pool_name, snapshot_name):
+    """
+    Remove a snapshot from a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rmsnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def set_pool_quota(service, pool_name, max_bytes=None, max_objects=None):
+    """
+    :param service: The Ceph user name to run the command under
+    :type service: str
+    :param pool_name: Name of pool
+    :type pool_name: str
+    :param max_bytes: Maximum bytes quota to apply
+    :type max_bytes: int
+    :param max_objects: Maximum objects quota to apply
+    :type max_objects: int
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name]
+    if max_bytes:
+        cmd = cmd + ['max_bytes', str(max_bytes)]
+    if max_objects:
+        cmd = cmd + ['max_objects', str(max_objects)]
+    check_call(cmd)
+
+
+def remove_pool_quota(service, pool_name):
+    """
+    Set a byte quota on a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name, 'max_bytes', '0']
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_erasure_profile(service, profile_name):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'rm',
+           profile_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def create_erasure_profile(service, profile_name, erasure_plugin_name='jerasure',
+                           failure_domain='host',
+                           data_chunks=2, coding_chunks=1,
+                           locality=None, durability_estimator=None,
+                           device_class=None):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :param erasure_plugin_name: six.string_types
+    :param failure_domain: six.string_types.  One of ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region',
+        'room', 'root', 'row'])
+    :param data_chunks: int
+    :param coding_chunks: int
+    :param locality: int
+    :param durability_estimator: int
+    :param device_class: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    # Ensure this failure_domain is allowed by Ceph
+    validator(failure_domain, six.string_types,
+              ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region', 'room', 'root', 'row'])
+
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'set', profile_name,
+           'plugin=' + erasure_plugin_name, 'k=' + str(data_chunks), 'm=' + str(coding_chunks)
+           ]
+    if locality is not None and durability_estimator is not None:
+        raise ValueError("create_erasure_profile should be called with k, m and one of l or c but not both.")
+
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    # failure_domain changed in luminous
+    if luminous_or_later:
+        cmd.append('crush-failure-domain=' + failure_domain)
+    else:
+        cmd.append('ruleset-failure-domain=' + failure_domain)
+
+    # device class new in luminous
+    if luminous_or_later and device_class:
+        cmd.append('crush-device-class={}'.format(device_class))
+    else:
+        log('Skipping device class configuration (ceph < 12.0.0)',
+            level=DEBUG)
+
+    # Add plugin specific information
+    if locality is not None:
+        # For local erasure codes
+        cmd.append('l=' + str(locality))
+    if durability_estimator is not None:
+        # For Shec erasure codes
+        cmd.append('c=' + str(durability_estimator))
+
+    if erasure_profile_exists(service, profile_name):
+        cmd.append('--force')
+
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def rename_pool(service, old_name, new_name):
+    """
+    Rename a Ceph pool from old_name to new_name
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param old_name: six.string_types
+    :param new_name: six.string_types
+    :return: None
+    """
+    validator(value=old_name, valid_type=six.string_types)
+    validator(value=new_name, valid_type=six.string_types)
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rename', old_name, new_name]
+    check_call(cmd)
+
+
+def erasure_profile_exists(service, name):
+    """
+    Check to see if an Erasure code profile already exists.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name: six.string_types
+    :return: int or None
+    """
+    validator(value=name, valid_type=six.string_types)
+    try:
+        check_call(['ceph', '--id', service,
+                    'osd', 'erasure-code-profile', 'get',
+                    name])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def get_cache_mode(service, pool_name):
+    """
+    Find the current caching mode of the pool_name given.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: int or None
+    """
+    validator(value=service, valid_type=six.string_types)
+    validator(value=pool_name, valid_type=six.string_types)
+    out = check_output(['ceph', '--id', service,
+                        'osd', 'dump', '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    try:
+        osd_json = json.loads(out)
+        for pool in osd_json['pools']:
+            if pool['pool_name'] == pool_name:
+                return pool['cache_mode']
+        return None
+    except ValueError:
+        raise
+
+
+def pool_exists(service, name):
+    """Check to see if a RADOS pool already exists."""
+    try:
+        out = check_output(['rados', '--id', service, 'lspools'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out.split()
+
+
+def get_osds(service, device_class=None):
+    """Return a list of all Ceph Object Storage Daemons currently in the
+    cluster (optionally filtered by storage device class).
+
+    :param device_class: Class of storage device for OSD's
+    :type device_class: str
+    """
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    if luminous_or_later and device_class:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'crush', 'class',
+                            'ls-osd', device_class,
+                            '--format=json'])
+    else:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'ls',
+                            '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    return json.loads(out)
+
+
+def install():
+    """Basic Ceph client installation."""
+    ceph_dir = "/etc/ceph"
+    if not os.path.exists(ceph_dir):
+        os.mkdir(ceph_dir)
+
+    apt_install('ceph-common', fatal=True)
+
+
+def rbd_exists(service, pool, rbd_img):
+    """Check to see if a RADOS block device exists."""
+    try:
+        out = check_output(['rbd', 'list', '--id',
+                            service, '--pool', pool])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return rbd_img in out
+
+
+def create_rbd_image(service, pool, image, sizemb):
+    """Create a new RADOS block device."""
+    cmd = ['rbd', 'create', image, '--size', str(sizemb), '--id', service,
+           '--pool', pool]
+    check_call(cmd)
+
+
+def update_pool(client, pool, settings):
+    cmd = ['ceph', '--id', client, 'osd', 'pool', 'set', pool]
+    for k, v in six.iteritems(settings):
+        cmd.append(k)
+        cmd.append(v)
+
+    check_call(cmd)
+
+
+def set_app_name_for_pool(client, pool, name):
+    """
+    Calls `osd pool application enable` for the specified pool name
+
+    :param client: Name of the ceph client to use
+    :type client: str
+    :param pool: Pool to set app name for
+    :type pool: str
+    :param name: app name for the specified pool
+    :type name: str
+
+    :raises: CalledProcessError if ceph call fails
+    """
+    if cmp_pkgrevno('ceph-common', '12.0.0') >= 0:
+        cmd = ['ceph', '--id', client, 'osd', 'pool',
+               'application', 'enable', pool, name]
+        check_call(cmd)
+
+
+def create_pool(service, name, replicas=3, pg_num=None):
+    """Create a new RADOS pool."""
+    if pool_exists(service, name):
+        log("Ceph pool {} already exists, skipping creation".format(name),
+            level=WARNING)
+        return
+
+    if not pg_num:
+        # Calculate the number of placement groups based
+        # on upstream recommended best practices.
+        osds = get_osds(service)
+        if osds:
+            pg_num = (len(osds) * 100 // replicas)
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            pg_num = 200
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'create', name, str(pg_num)]
+    check_call(cmd)
+
+    update_pool(service, name, settings={'size': str(replicas)})
+
+
+def delete_pool(service, name):
+    """Delete a RADOS pool from ceph."""
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'delete', name,
+           '--yes-i-really-really-mean-it']
+    check_call(cmd)
+
+
+def _keyfile_path(service):
+    return KEYFILE.format(service)
+
+
+def _keyring_path(service):
+    return KEYRING.format(service)
+
+
+def add_key(service, key):
+    """
+    Add a key to a keyring.
+
+    Creates the keyring if it doesn't already exist.
+
+    Logs and returns if the key is already in the keyring.
+    """
+    keyring = _keyring_path(service)
+    if os.path.exists(keyring):
+        with open(keyring, 'r') as ring:
+            if key in ring.read():
+                log('Ceph keyring exists at %s and has not changed.' % keyring,
+                    level=DEBUG)
+                return
+            log('Updating existing keyring %s.' % keyring, level=DEBUG)
+
+    cmd = ['ceph-authtool', keyring, '--create-keyring',
+           '--name=client.{}'.format(service), '--add-key={}'.format(key)]
+    check_call(cmd)
+    log('Created new ceph keyring at %s.' % keyring, level=DEBUG)
+
+
+def create_keyring(service, key):
+    """Deprecated. Please use the more accurately named 'add_key'"""
+    return add_key(service, key)
+
+
+def delete_keyring(service):
+    """Delete an existing Ceph keyring."""
+    keyring = _keyring_path(service)
+    if not os.path.exists(keyring):
+        log('Keyring does not exist at %s' % keyring, level=WARNING)
+        return
+
+    os.remove(keyring)
+    log('Deleted ring at %s.' % keyring, level=INFO)
+
+
+def create_key_file(service, key):
+    """Create a file containing key."""
+    keyfile = _keyfile_path(service)
+    if os.path.exists(keyfile):
+        log('Keyfile exists at %s.' % keyfile, level=WARNING)
+        return
+
+    with open(keyfile, 'w') as fd:
+        fd.write(key)
+
+    log('Created new keyfile at %s.' % keyfile, level=INFO)
+
+
+def get_ceph_nodes(relation='ceph'):
+    """Query named relation to determine current nodes."""
+    hosts = []
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            hosts.append(relation_get('private-address', unit=unit, rid=r_id))
+
+    return hosts
+
+
+def configure(service, key, auth, use_syslog):
+    """Perform basic configuration of Ceph."""
+    add_key(service, key)
+    create_key_file(service, key)
+    hosts = get_ceph_nodes()
+    with open('/etc/ceph/ceph.conf', 'w') as ceph_conf:
+        ceph_conf.write(CEPH_CONF.format(auth=auth,
+                                         keyring=_keyring_path(service),
+                                         mon_hosts=",".join(map(str, hosts)),
+                                         use_syslog=use_syslog))
+    modprobe('rbd')
+
+
+def image_mapped(name):
+    """Determine whether a RADOS block device is mapped locally."""
+    try:
+        out = check_output(['rbd', 'showmapped'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out
+
+
+def map_block_storage(service, pool, image):
+    """Map a RADOS block device for local use."""
+    cmd = [
+        'rbd',
+        'map',
+        '{}/{}'.format(pool, image),
+        '--user',
+        service,
+        '--secret',
+        _keyfile_path(service),
+    ]
+    check_call(cmd)
+
+
+def filesystem_mounted(fs):
+    """Determine whether a filesytems is already mounted."""
+    return fs in [f for f, m in mounts()]
+
+
+def make_filesystem(blk_device, fstype='ext4', timeout=10):
+    """Make a new filesystem on the specified block device."""
+    count = 0
+    e_noent = errno.ENOENT
+    while not os.path.exists(blk_device):
+        if count >= timeout:
+            log('Gave up waiting on block device %s' % blk_device,
+                level=ERROR)
+            raise IOError(e_noent, os.strerror(e_noent), blk_device)
+
+        log('Waiting for block device %s to appear' % blk_device,
+            level=DEBUG)
+        count += 1
+        time.sleep(1)
+    else:
+        log('Formatting block device %s as filesystem %s.' %
+            (blk_device, fstype), level=INFO)
+        check_call(['mkfs', '-t', fstype, blk_device])
+
+
+def place_data_on_block_device(blk_device, data_src_dst):
+    """Migrate data in data_src_dst to blk_device and then remount."""
+    # mount block device into /mnt
+    mount(blk_device, '/mnt')
+    # copy data to /mnt
+    copy_files(data_src_dst, '/mnt')
+    # umount block device
+    umount('/mnt')
+    # Grab user/group ID's from original source
+    _dir = os.stat(data_src_dst)
+    uid = _dir.st_uid
+    gid = _dir.st_gid
+    # re-mount where the data should originally be
+    # TODO: persist is currently a NO-OP in core.host
+    mount(blk_device, data_src_dst, persist=True)
+    # ensure original ownership of new mount.
+    os.chown(data_src_dst, uid, gid)
+
+
+def copy_files(src, dst, symlinks=False, ignore=None):
+    """Copy files from src to dst."""
+    for item in os.listdir(src):
+        s = os.path.join(src, item)
+        d = os.path.join(dst, item)
+        if os.path.isdir(s):
+            shutil.copytree(s, d, symlinks, ignore)
+        else:
+            shutil.copy2(s, d)
+
+
+def ensure_ceph_storage(service, pool, rbd_img, sizemb, mount_point,
+                        blk_device, fstype, system_services=[],
+                        replicas=3):
+    """NOTE: This function must only be called from a single service unit for
+    the same rbd_img otherwise data loss will occur.
+
+    Ensures given pool and RBD image exists, is mapped to a block device,
+    and the device is formatted and mounted at the given mount_point.
+
+    If formatting a device for the first time, data existing at mount_point
+    will be migrated to the RBD device before being re-mounted.
+
+    All services listed in system_services will be stopped prior to data
+    migration and restarted when complete.
+    """
+    # Ensure pool, RBD image, RBD mappings are in place.
+    if not pool_exists(service, pool):
+        log('Creating new pool {}.'.format(pool), level=INFO)
+        create_pool(service, pool, replicas=replicas)
+
+    if not rbd_exists(service, pool, rbd_img):
+        log('Creating RBD image ({}).'.format(rbd_img), level=INFO)
+        create_rbd_image(service, pool, rbd_img, sizemb)
+
+    if not image_mapped(rbd_img):
+        log('Mapping RBD Image {} as a Block Device.'.format(rbd_img),
+            level=INFO)
+        map_block_storage(service, pool, rbd_img)
+
+    # make file system
+    # TODO: What happens if for whatever reason this is run again and
+    # the data is already in the rbd device and/or is mounted??
+    # When it is mounted already, it will fail to make the fs
+    # XXX: This is really sketchy!  Need to at least add an fstab entry
+    #      otherwise this hook will blow away existing data if its executed
+    #      after a reboot.
+    if not filesystem_mounted(mount_point):
+        make_filesystem(blk_device, fstype)
+
+        for svc in system_services:
+            if service_running(svc):
+                log('Stopping services {} prior to migrating data.'
+                    .format(svc), level=DEBUG)
+                service_stop(svc)
+
+        place_data_on_block_device(blk_device, mount_point)
+
+        for svc in system_services:
+            log('Starting service {} after migrating data.'
+                .format(svc), level=DEBUG)
+            service_start(svc)
+
+
+def ensure_ceph_keyring(service, user=None, group=None,
+                        relation='ceph', key=None):
+    """Ensures a ceph keyring is created for a named service and optionally
+    ensures user and group ownership.
+
+    @returns boolean: Flag to indicate whether a key was successfully written
+                      to disk based on either relation data or a supplied key
+    """
+    if not key:
+        for rid in relation_ids(relation):
+            for unit in related_units(rid):
+                key = relation_get('key', rid=rid, unit=unit)
+                if key:
+                    break
+
+    if not key:
+        return False
+
+    add_key(service=service, key=key)
+    keyring = _keyring_path(service)
+    if user and group:
+        check_call(['chown', '%s.%s' % (user, group), keyring])
+
+    return True
+
+
+class CephBrokerRq(object):
+    """Ceph broker request.
+
+    Multiple operations can be added to a request and sent to the Ceph broker
+    to be executed.
+
+    Request is json-encoded for sending over the wire.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, api_version=1, request_id=None):
+        self.api_version = api_version
+        if request_id:
+            self.request_id = request_id
+        else:
+            self.request_id = str(uuid.uuid1())
+        self.ops = []
+
+    def add_op(self, op):
+        """Add an op if it is not already in the list.
+
+        :param op: Operation to add.
+        :type op: dict
+        """
+        if op not in self.ops:
+            self.ops.append(op)
+
+    def add_op_request_access_to_group(self, name, namespace=None,
+                                       permission=None, key_name=None,
+                                       object_prefix_permissions=None):
+        """
+        Adds the requested permissions to the current service's Ceph key,
+        allowing the key to access only the specified pools or
+        object prefixes. object_prefix_permissions should be a dictionary
+        keyed on the permission with the corresponding value being a list
+        of prefixes to apply that permission to.
+            {
+                'rwx': ['prefix1', 'prefix2'],
+                'class-read': ['prefix3']}
+        """
+        self.add_op({
+            'op': 'add-permissions-to-key', 'group': name,
+            'namespace': namespace,
+            'name': key_name or service_name(),
+            'group-permission': permission,
+            'object-prefix-permissions': object_prefix_permissions})
+
+    def add_op_create_pool(self, name, replica_count=3, pg_num=None,
+                           weight=None, group=None, namespace=None,
+                           app_name=None, max_bytes=None, max_objects=None):
+        """DEPRECATED: Use ``add_op_create_replicated_pool()`` or
+                       ``add_op_create_erasure_pool()`` instead.
+        """
+        return self.add_op_create_replicated_pool(
+            name, replica_count=replica_count, pg_num=pg_num, weight=weight,
+            group=group, namespace=namespace, app_name=app_name,
+            max_bytes=max_bytes, max_objects=max_objects)
+
+    def add_op_create_replicated_pool(self, name, replica_count=3, pg_num=None,
+                                      weight=None, group=None, namespace=None,
+                                      app_name=None, max_bytes=None,
+                                      max_objects=None):
+        """Adds an operation to create a replicated pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param replica_count: Number of copies Ceph should keep of your data.
+        :type replica_count: int
+        :param pg_num: Request specific number of Placement Groups to create
+                       for pool.
+        :type pg_num: int
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+                       Used to calculate number of Placement Groups to create
+                       for pool.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param namespace: Group namespace
+        :type namespace: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        if pg_num and weight:
+            raise ValueError('pg_num and weight are mutually exclusive')
+
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'replicas': replica_count, 'pg_num': pg_num,
+                     'weight': weight, 'group': group,
+                     'group-namespace': namespace, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def add_op_create_erasure_pool(self, name, erasure_profile=None,
+                                   weight=None, group=None, app_name=None,
+                                   max_bytes=None, max_objects=None):
+        """Adds an operation to create a erasure coded pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param erasure_profile: Name of erasure code profile to use.  If not
+                                set the ceph-mon unit handling the broker
+                                request will set its default value.
+        :type erasure_profile: str
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'pool-type': 'erasure',
+                     'erasure-profile': erasure_profile,
+                     'weight': weight,
+                     'group': group, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def set_ops(self, ops):
+        """Set request ops to provided value.
+
+        Useful for injecting ops that come from a previous request
+        to allow comparisons to ensure validity.
+        """
+        self.ops = ops
+
+    @property
+    def request(self):
+        return json.dumps({'api-version': self.api_version, 'ops': self.ops,
+                           'request-id': self.request_id})
+
+    def _ops_equal(self, other):
+        if len(self.ops) == len(other.ops):
+            for req_no in range(0, len(self.ops)):
+                for key in [
+                        'replicas', 'name', 'op', 'pg_num', 'weight',
+                        'group', 'group-namespace', 'group-permission',
+                        'object-prefix-permissions']:
+                    if self.ops[req_no].get(key) != other.ops[req_no].get(key):
+                        return False
+        else:
+            return False
+        return True
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        if self.api_version == other.api_version and \
+                self._ops_equal(other):
+            return True
+        else:
+            return False
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+
+class CephBrokerRsp(object):
+    """Ceph broker response.
+
+    Response is json-decoded and contents provided as methods/properties.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, encoded_rsp):
+        self.api_version = None
+        self.rsp = json.loads(encoded_rsp)
+
+    @property
+    def request_id(self):
+        return self.rsp.get('request-id')
+
+    @property
+    def exit_code(self):
+        return self.rsp.get('exit-code')
+
+    @property
+    def exit_msg(self):
+        return self.rsp.get('stderr')
+
+
+# Ceph Broker Conversation:
+# If a charm needs an action to be taken by ceph it can create a CephBrokerRq
+# and send that request to ceph via the ceph relation. The CephBrokerRq has a
+# unique id so that the client can identity which CephBrokerRsp is associated
+# with the request. Ceph will also respond to each client unit individually
+# creating a response key per client unit eg glance/0 will get a CephBrokerRsp
+# via key broker-rsp-glance-0
+#
+# To use this the charm can just do something like:
+#
+# from charmhelpers.contrib.storage.linux.ceph import (
+#     send_request_if_needed,
+#     is_request_complete,
+#     CephBrokerRq,
+# )
+#
+# @hooks.hook('ceph-relation-changed')
+# def ceph_changed():
+#     rq = CephBrokerRq()
+#     rq.add_op_create_pool(name='poolname', replica_count=3)
+#
+#     if is_request_complete(rq):
+#         <Request complete actions>
+#     else:
+#         send_request_if_needed(get_ceph_request())
+#
+# CephBrokerRq and CephBrokerRsp are serialized into JSON. Below is an example
+# of glance having sent a request to ceph which ceph has successfully processed
+#  'ceph:8': {
+#      'ceph/0': {
+#          'auth': 'cephx',
+#          'broker-rsp-glance-0': '{"request-id": "0bc7dc54", "exit-code": 0}',
+#          'broker_rsp': '{"request-id": "0da543b8", "exit-code": 0}',
+#          'ceph-public-address': '10.5.44.103',
+#          'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+#          'private-address': '10.5.44.103',
+#      },
+#      'glance/0': {
+#          'broker_req': ('{"api-version": 1, "request-id": "0bc7dc54", '
+#                         '"ops": [{"replicas": 3, "name": "glance", '
+#                         '"op": "create-pool"}]}'),
+#          'private-address': '10.5.44.109',
+#      },
+#  }
+
+def get_previous_request(rid):
+    """Return the last ceph broker request sent on a given relation
+
+    @param rid: Relation id to query for request
+    """
+    request = None
+    broker_req = relation_get(attribute='broker_req', rid=rid,
+                              unit=local_unit())
+    if broker_req:
+        request_data = json.loads(broker_req)
+        request = CephBrokerRq(api_version=request_data['api-version'],
+                               request_id=request_data['request-id'])
+        request.set_ops(request_data['ops'])
+
+    return request
+
+
+def get_request_states(request, relation='ceph'):
+    """Return a dict of requests per relation id with their corresponding
+       completion state.
+
+    This allows a charm, which has a request for ceph, to see whether there is
+    an equivalent request already being processed and if so what state that
+    request is in.
+
+    @param request: A CephBrokerRq object
+    """
+    complete = []
+    requests = {}
+    for rid in relation_ids(relation):
+        complete = False
+        previous_request = get_previous_request(rid)
+        if request == previous_request:
+            sent = True
+            complete = is_request_complete_for_rid(previous_request, rid)
+        else:
+            sent = False
+            complete = False
+
+        requests[rid] = {
+            'sent': sent,
+            'complete': complete,
+        }
+
+    return requests
+
+
+def is_request_sent(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been sent
+
+    Returns True if a similair request has been sent
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['sent']:
+            return False
+
+    return True
+
+
+def is_request_complete(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been
+    completed
+
+    Returns True if a similair request has been completed
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['complete']:
+            return False
+
+    return True
+
+
+def is_request_complete_for_rid(request, rid):
+    """Check if a given request has been completed on the given relation
+
+    @param request: A CephBrokerRq object
+    @param rid: Relation ID
+    """
+    broker_key = get_broker_rsp_key()
+    for unit in related_units(rid):
+        rdata = relation_get(rid=rid, unit=unit)
+        if rdata.get(broker_key):
+            rsp = CephBrokerRsp(rdata.get(broker_key))
+            if rsp.request_id == request.request_id:
+                if not rsp.exit_code:
+                    return True
+        else:
+            # The remote unit sent no reply targeted at this unit so either the
+            # remote ceph cluster does not support unit targeted replies or it
+            # has not processed our request yet.
+            if rdata.get('broker_rsp'):
+                request_data = json.loads(rdata['broker_rsp'])
+                if request_data.get('request-id'):
+                    log('Ignoring legacy broker_rsp without unit key as remote '
+                        'service supports unit specific replies', level=DEBUG)
+                else:
+                    log('Using legacy broker_rsp as remote service does not '
+                        'supports unit specific replies', level=DEBUG)
+                    rsp = CephBrokerRsp(rdata['broker_rsp'])
+                    if not rsp.exit_code:
+                        return True
+
+    return False
+
+
+def get_broker_rsp_key():
+    """Return broker response key for this unit
+
+    This is the key that ceph is going to use to pass request status
+    information back to this unit
+    """
+    return 'broker-rsp-' + local_unit().replace('/', '-')
+
+
+def send_request_if_needed(request, relation='ceph'):
+    """Send broker request if an equivalent request has not already been sent
+
+    @param request: A CephBrokerRq object
+    """
+    if is_request_sent(request, relation=relation):
+        log('Request already sent but not complete, not sending new request',
+            level=DEBUG)
+    else:
+        for rid in relation_ids(relation):
+            log('Sending request {}'.format(request.request_id), level=DEBUG)
+            relation_set(relation_id=rid, broker_req=request.request)
+
+
+def has_broker_rsp(rid=None, unit=None):
+    """Return True if the broker_rsp key is 'truthy' (i.e. set to something) in the relation data.
+
+    :param rid: The relation to check (default of None means current relation)
+    :type rid: Union[str, None]
+    :param unit: The remote unit to check (default of None means current unit)
+    :type unit: Union[str, None]
+    :returns: True if broker key exists and is set to something 'truthy'
+    :rtype: bool
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    return True if broker_rsp else False
+
+
+def is_broker_action_done(action, rid=None, unit=None):
+    """Check whether broker action has completed yet.
+
+    @param action: name of action to be performed
+    @returns True if action complete otherwise False
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return False
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    val = kvstore.get(key=key)
+    if val and val == rsp.request_id:
+        return True
+
+    return False
+
+
+def mark_broker_action_done(action, rid=None, unit=None):
+    """Mark action as having been completed.
+
+    @param action: name of action to be performed
+    @returns None
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    kvstore.set(key=key, value=rsp.request_id)
+    kvstore.flush()
+
+
+class CephConfContext(object):
+    """Ceph config (ceph.conf) context.
+
+    Supports user-provided Ceph configuration settings. Use can provide a
+    dictionary as the value for the config-flags charm option containing
+    Ceph configuration settings keyede by their section in ceph.conf.
+    """
+    def __init__(self, permitted_sections=None):
+        self.permitted_sections = permitted_sections or []
+
+    def __call__(self):
+        conf = config('config-flags')
+        if not conf:
+            return {}
+
+        conf = config_flags_parser(conf)
+        if not isinstance(conf, dict):
+            log("Provided config-flags is not a dictionary - ignoring",
+                level=WARNING)
+            return {}
+
+        permitted = self.permitted_sections
+        if permitted:
+            diff = set(conf.keys()).difference(set(permitted))
+            if diff:
+                log("Config-flags contains invalid keys '%s' - they will be "
+                    "ignored" % (', '.join(diff)), level=WARNING)
+
+        ceph_conf = {}
+        for key in conf:
+            if permitted and key not in permitted:
+                log("Ignoring key '%s'" % key, level=WARNING)
+                continue
+
+            ceph_conf[key] = conf[key]
+        return ceph_conf
+
+
+class CephOSDConfContext(CephConfContext):
+    """Ceph config (ceph.conf) context.
+
+    Consolidates settings from config-flags via CephConfContext with
+    settings provided by the mons. The config-flag values are preserved in
+    conf['osd'], settings from the mons which do not clash with config-flag
+    settings are in conf['osd_from_client'] and finally settings which do
+    clash are in conf['osd_from_client_conflict']. Rather than silently drop
+    the conflicting settings they are provided in the context so they can be
+    rendered commented out to give some visability to the admin.
+    """
+
+    def __init__(self, permitted_sections=None):
+        super(CephOSDConfContext, self).__init__(
+            permitted_sections=permitted_sections)
+        try:
+            self.settings_from_mons = get_osd_settings('mon')
+        except OSDSettingConflict:
+            log(
+                "OSD settings from mons are inconsistent, ignoring them",
+                level=WARNING)
+            self.settings_from_mons = {}
+
+    def filter_osd_from_mon_settings(self):
+        """Filter settings from client relation against config-flags.
+
+        :returns: A tuple (
+            ,config-flag values,
+            ,client settings which do not conflict with config-flag values,
+            ,client settings which confilct with config-flag values)
+        :rtype: (OrderedDict, OrderedDict, OrderedDict)
+        """
+        ceph_conf = super(CephOSDConfContext, self).__call__()
+        conflicting_entries = {}
+        clear_entries = {}
+        for key, value in self.settings_from_mons.items():
+            if key in ceph_conf.get('osd', {}):
+                if ceph_conf['osd'][key] != value:
+                    conflicting_entries[key] = value
+            else:
+                clear_entries[key] = value
+        clear_entries = _order_dict_by_key(clear_entries)
+        conflicting_entries = _order_dict_by_key(conflicting_entries)
+        return ceph_conf, clear_entries, conflicting_entries
+
+    def __call__(self):
+        """Construct OSD config context.
+
+        Standard context with two additional special keys.
+            osd_from_client_conflict: client settings which confilct with
+                                      config-flag values
+            osd_from_client: settings which do not conflict with config-flag
+                             values
+
+        :returns: OSD config context dict.
+        :rtype: dict
+        """
+        conf, osd_clear, osd_conflict = self.filter_osd_from_mon_settings()
+        conf['osd_from_client_conflict'] = osd_conflict
+        conf['osd_from_client'] = osd_clear
+        return conf
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/loopback.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/loopback.py
new file mode 100644
index 0000000000000000000000000000000000000000..74bab40e43a978e3d9e1e2f9c8975368092145c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/loopback.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from subprocess import (
+    check_call,
+    check_output,
+)
+
+import six
+
+
+##################################################
+# loopback device helpers.
+##################################################
+def loopback_devices():
+    '''
+    Parse through 'losetup -a' output to determine currently mapped
+    loopback devices. Output is expected to look like:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img)
+
+    or:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img (deleted))
+
+    :returns: dict: a dict mapping {loopback_dev: backing_file}
+    '''
+    loopbacks = {}
+    cmd = ['losetup', '-a']
+    output = check_output(cmd)
+    if six.PY3:
+        output = output.decode('utf-8')
+    devs = [d.strip().split(' ', 2) for d in output.splitlines() if d != '']
+    for dev, _, f in devs:
+        loopbacks[dev.replace(':', '')] = re.search(r'\((.+)\)', f).groups()[0]
+    return loopbacks
+
+
+def create_loopback(file_path):
+    '''
+    Create a loopback device for a given backing file.
+
+    :returns: str: Full path to new loopback device (eg, /dev/loop0)
+    '''
+    file_path = os.path.abspath(file_path)
+    check_call(['losetup', '--find', file_path])
+    for d, f in six.iteritems(loopback_devices()):
+        if f == file_path:
+            return d
+
+
+def ensure_loopback_device(path, size):
+    '''
+    Ensure a loopback device exists for a given backing file path and size.
+    If it a loopback device is not mapped to file, a new one will be created.
+
+    TODO: Confirm size of found loopback device.
+
+    :returns: str: Full path to the ensured loopback device (eg, /dev/loop0)
+    '''
+    for d, f in six.iteritems(loopback_devices()):
+        if f == path:
+            return d
+
+    if not os.path.exists(path):
+        cmd = ['truncate', '--size', size, path]
+        check_call(cmd)
+
+    return create_loopback(path)
+
+
+def is_mapped_loopback_device(device):
+    """
+    Checks if a given device name is an existing/mapped loopback device.
+    :param device: str: Full path to the device (eg, /dev/loop1).
+    :returns: str: Path to the backing file if is a loopback device
+    empty string otherwise
+    """
+    return loopback_devices().get(device, "")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/lvm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/lvm.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8bde69263f0e917d32d0e5d70abba1409b26012
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/lvm.py
@@ -0,0 +1,182 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    Popen,
+    PIPE,
+)
+
+
+##################################################
+# LVM helpers.
+##################################################
+def deactivate_lvm_volume_group(block_device):
+    '''
+    Deactivate any volume gruop associated with an LVM physical volume.
+
+    :param block_device: str: Full path to LVM physical volume
+    '''
+    vg = list_lvm_volume_group(block_device)
+    if vg:
+        cmd = ['vgchange', '-an', vg]
+        check_call(cmd)
+
+
+def is_lvm_physical_volume(block_device):
+    '''
+    Determine whether a block device is initialized as an LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: boolean: True if block device is a PV, False if not.
+    '''
+    try:
+        check_output(['pvdisplay', block_device])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def remove_lvm_physical_volume(block_device):
+    '''
+    Remove LVM PV signatures from a given block device.
+
+    :param block_device: str: Full path of block device to scrub.
+    '''
+    p = Popen(['pvremove', '-ff', block_device],
+              stdin=PIPE)
+    p.communicate(input='y\n')
+
+
+def list_lvm_volume_group(block_device):
+    '''
+    List LVM volume group associated with a given block device.
+
+    Assumes block device is a valid LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: str: Name of volume group associated with block device or None
+    '''
+    vg = None
+    pvd = check_output(['pvdisplay', block_device]).splitlines()
+    for lvm in pvd:
+        lvm = lvm.decode('UTF-8')
+        if lvm.strip().startswith('VG Name'):
+            vg = ' '.join(lvm.strip().split()[2:])
+    return vg
+
+
+def create_lvm_physical_volume(block_device):
+    '''
+    Initialize a block device as an LVM physical volume.
+
+    :param block_device: str: Full path of block device to initialize.
+
+    '''
+    check_call(['pvcreate', block_device])
+
+
+def create_lvm_volume_group(volume_group, block_device):
+    '''
+    Create an LVM volume group backed by a given block device.
+
+    Assumes block device has already been initialized as an LVM PV.
+
+    :param volume_group: str: Name of volume group to create.
+    :block_device: str: Full path of PV-initialized block device.
+    '''
+    check_call(['vgcreate', volume_group, block_device])
+
+
+def list_logical_volumes(select_criteria=None, path_mode=False):
+    '''
+    List logical volumes
+
+    :param select_criteria: str: Limit list to those volumes matching this
+                                 criteria (see 'lvs -S help' for more details)
+    :param path_mode: bool: return logical volume name in 'vg/lv' format, this
+                            format is required for some commands like lvextend
+    :returns: [str]: List of logical volumes
+    '''
+    lv_diplay_attr = 'lv_name'
+    if path_mode:
+        # Parsing output logic relies on the column order
+        lv_diplay_attr = 'vg_name,' + lv_diplay_attr
+    cmd = ['lvs', '--options', lv_diplay_attr, '--noheadings']
+    if select_criteria:
+        cmd.extend(['--select', select_criteria])
+    lvs = []
+    for lv in check_output(cmd).decode('UTF-8').splitlines():
+        if not lv:
+            continue
+        if path_mode:
+            lvs.append('/'.join(lv.strip().split()))
+        else:
+            lvs.append(lv.strip())
+    return lvs
+
+
+list_thin_logical_volume_pools = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^t')
+
+list_thin_logical_volumes = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^V')
+
+
+def extend_logical_volume_by_device(lv_name, block_device):
+    '''
+    Extends the size of logical volume lv_name by the amount of free space on
+    physical volume block_device.
+
+    :param lv_name: str: name of logical volume to be extended (vg/lv format)
+    :param block_device: str: name of block_device to be allocated to lv_name
+    '''
+    cmd = ['lvextend', lv_name, block_device]
+    check_call(cmd)
+
+
+def create_logical_volume(lv_name, volume_group, size=None):
+    '''
+    Create a new logical volume in an existing volume group
+
+    :param lv_name: str: name of logical volume to be created.
+    :param volume_group: str: Name of volume group to use for the new volume.
+    :param size: str: Size of logical volume to create (100% if not supplied)
+    :raises subprocess.CalledProcessError: in the event that the lvcreate fails.
+    '''
+    if size:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-L',
+            '{}'.format(size),
+            '-n', lv_name, volume_group
+        ])
+    # create the lv with all the space available, this is needed because the
+    # system call is different for LVM
+    else:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-l',
+            '100%FREE',
+            '-n', lv_name, volume_group
+        ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a35617606cf52d7cffc04ac245811b770fd95e8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/storage/linux/utils.py
@@ -0,0 +1,128 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from stat import S_ISBLK
+
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    call
+)
+
+
+def _luks_uuid(dev):
+    """
+    Check to see if dev is a LUKS encrypted volume, returning the UUID
+    of volume if it is.
+
+    :param: dev: path to block device to check.
+    :returns: str. UUID of LUKS device or None if not a LUKS device
+    """
+    try:
+        cmd = ['cryptsetup', 'luksUUID', dev]
+        return check_output(cmd).decode('UTF-8').strip()
+    except CalledProcessError:
+        return None
+
+
+def is_luks_device(dev):
+    """
+    Determine if dev is a LUKS-formatted block device.
+
+    :param: dev: A full path to a block device to check for LUKS header
+    presence
+    :returns: boolean: indicates whether a device is used based on LUKS header.
+    """
+    return True if _luks_uuid(dev) else False
+
+
+def is_mapped_luks_device(dev):
+    """
+    Determine if dev is a mapped LUKS device
+    :param: dev: A full path to a block device to be checked
+    :returns: boolean: indicates whether a device is mapped
+    """
+    _, dirs, _ = next(os.walk(
+        '/sys/class/block/{}/holders/'
+        .format(os.path.basename(os.path.realpath(dev))))
+    )
+    is_held = len(dirs) > 0
+    return is_held and is_luks_device(dev)
+
+
+def is_block_device(path):
+    '''
+    Confirm device at path is a valid block device node.
+
+    :returns: boolean: True if path is a block device, False if not.
+    '''
+    if not os.path.exists(path):
+        return False
+    return S_ISBLK(os.stat(path).st_mode)
+
+
+def zap_disk(block_device):
+    '''
+    Clear a block device of partition table. Relies on sgdisk, which is
+    installed as pat of the 'gdisk' package in Ubuntu.
+
+    :param block_device: str: Full path of block device to clean.
+    '''
+    # https://github.com/ceph/ceph/commit/fdd7f8d83afa25c4e09aaedd90ab93f3b64a677b
+    # sometimes sgdisk exits non-zero; this is OK, dd will clean up
+    call(['sgdisk', '--zap-all', '--', block_device])
+    call(['sgdisk', '--clear', '--mbrtogpt', '--', block_device])
+    dev_end = check_output(['blockdev', '--getsz',
+                            block_device]).decode('UTF-8')
+    gpt_end = int(dev_end.split()[0]) - 100
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=1M', 'count=1'])
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=512', 'count=100', 'seek=%s' % (gpt_end)])
+
+
+def is_device_mounted(device):
+    '''Given a device path, return True if that device is mounted, and False
+    if it isn't.
+
+    :param device: str: Full path of the device to check.
+    :returns: boolean: True if the path represents a mounted device, False if
+        it doesn't.
+    '''
+    try:
+        out = check_output(['lsblk', '-P', device]).decode('UTF-8')
+    except Exception:
+        return False
+    return bool(re.search(r'MOUNTPOINT=".+"', out))
+
+
+def mkfs_xfs(device, force=False, inode_size=1024):
+    """Format device with XFS filesystem.
+
+    By default this should fail if the device already has a filesystem on it.
+    :param device: Full path to device to format
+    :ptype device: tr
+    :param force: Force operation
+    :ptype: force: boolean
+    :param inode_size: XFS inode size in bytes
+    :ptype inode_size: int"""
+    cmd = ['mkfs.xfs']
+    if force:
+        cmd.append("-f")
+
+    cmd += ['-i', "size={}".format(inode_size), device]
+    check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/contexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/contexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1adf94b133f41a168727a3cdd3a536633ff62b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/contexts.py
@@ -0,0 +1,137 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""A helper to create a yaml cache of config with namespaced relation data."""
+import os
+import yaml
+
+import six
+
+import charmhelpers.core.hookenv
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+
+
+def dict_keys_without_hyphens(a_dict):
+    """Return the a new dict with underscores instead of hyphens in keys."""
+    return dict(
+        (key.replace('-', '_'), val) for key, val in a_dict.items())
+
+
+def update_relations(context, namespace_separator=':'):
+    """Update the context with the relation data."""
+    # Add any relation data prefixed with the relation type.
+    relation_type = charmhelpers.core.hookenv.relation_type()
+    relations = []
+    context['current_relation'] = {}
+    if relation_type is not None:
+        relation_data = charmhelpers.core.hookenv.relation_get()
+        context['current_relation'] = relation_data
+        # Deprecated: the following use of relation data as keys
+        # directly in the context will be removed.
+        relation_data = dict(
+            ("{relation_type}{namespace_separator}{key}".format(
+                relation_type=relation_type,
+                key=key,
+                namespace_separator=namespace_separator), val)
+            for key, val in relation_data.items())
+        relation_data = dict_keys_without_hyphens(relation_data)
+        context.update(relation_data)
+        relations = charmhelpers.core.hookenv.relations_of_type(relation_type)
+        relations = [dict_keys_without_hyphens(rel) for rel in relations]
+
+    context['relations_full'] = charmhelpers.core.hookenv.relations()
+
+    # the hookenv.relations() data structure is effectively unusable in
+    # templates and other contexts when trying to access relation data other
+    # than the current relation. So provide a more useful structure that works
+    # with any hook.
+    local_unit = charmhelpers.core.hookenv.local_unit()
+    relations = {}
+    for rname, rids in context['relations_full'].items():
+        relations[rname] = []
+        for rid, rdata in rids.items():
+            data = rdata.copy()
+            if local_unit in rdata:
+                data.pop(local_unit)
+            for unit_name, rel_data in data.items():
+                new_data = {'__relid__': rid, '__unit__': unit_name}
+                new_data.update(rel_data)
+                relations[rname].append(new_data)
+    context['relations'] = relations
+
+
+def juju_state_to_yaml(yaml_path, namespace_separator=':',
+                       allow_hyphens_in_keys=True, mode=None):
+    """Update the juju config and state in a yaml file.
+
+    This includes any current relation-get data, and the charm
+    directory.
+
+    This function was created for the ansible and saltstack
+    support, as those libraries can use a yaml file to supply
+    context to templates, but it may be useful generally to
+    create and update an on-disk cache of all the config, including
+    previous relation data.
+
+    By default, hyphens are allowed in keys as this is supported
+    by yaml, but for tools like ansible, hyphens are not valid [1].
+
+    [1] http://www.ansibleworks.com/docs/playbooks_variables.html#what-makes-a-valid-variable-name
+    """
+    config = charmhelpers.core.hookenv.config()
+
+    # Add the charm_dir which we will need to refer to charm
+    # file resources etc.
+    config['charm_dir'] = charm_dir
+    config['local_unit'] = charmhelpers.core.hookenv.local_unit()
+    config['unit_private_address'] = charmhelpers.core.hookenv.unit_private_ip()
+    config['unit_public_address'] = charmhelpers.core.hookenv.unit_get(
+        'public-address'
+    )
+
+    # Don't use non-standard tags for unicode which will not
+    # work when salt uses yaml.load_safe.
+    yaml.add_representer(six.text_type,
+                         lambda dumper, value: dumper.represent_scalar(
+                             six.u('tag:yaml.org,2002:str'), value))
+
+    yaml_dir = os.path.dirname(yaml_path)
+    if not os.path.exists(yaml_dir):
+        os.makedirs(yaml_dir)
+
+    if os.path.exists(yaml_path):
+        with open(yaml_path, "r") as existing_vars_file:
+            existing_vars = yaml.load(existing_vars_file.read())
+    else:
+        with open(yaml_path, "w+"):
+            pass
+        existing_vars = {}
+
+    if mode is not None:
+        os.chmod(yaml_path, mode)
+
+    if not allow_hyphens_in_keys:
+        config = dict_keys_without_hyphens(config)
+    existing_vars.update(config)
+
+    update_relations(existing_vars, namespace_separator)
+
+    with open(yaml_path, "w+") as fp:
+        fp.write(yaml.dump(existing_vars, default_flow_style=False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/jinja.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/jinja.py
new file mode 100644
index 0000000000000000000000000000000000000000..38d4fba0e651399064a14112398a0ef43717f5cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/jinja.py
@@ -0,0 +1,38 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Templating using the python-jinja2 package.
+"""
+import six
+from charmhelpers.fetch import apt_install, apt_update
+try:
+    import jinja2
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY3:
+        apt_install(["python3-jinja2"], fatal=True)
+    else:
+        apt_install(["python-jinja2"], fatal=True)
+    import jinja2
+
+
+DEFAULT_TEMPLATES_DIR = 'templates'
+
+
+def render(template_name, context, template_dir=DEFAULT_TEMPLATES_DIR):
+    templates = jinja2.Environment(
+        loader=jinja2.FileSystemLoader(template_dir))
+    template = templates.get_template(template_name)
+    return template.render(context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/pyformat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/pyformat.py
new file mode 100644
index 0000000000000000000000000000000000000000..51a24dc42379fbee88d8952c578fc2498c852b0b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/templating/pyformat.py
@@ -0,0 +1,27 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Templating using standard Python str.format() method.
+'''
+
+from charmhelpers.core import hookenv
+
+
+def render(template, extra={}, **kwargs):
+    """Return the template rendered using Python's str.format()."""
+    context = hookenv.execution_environment()
+    context.update(extra)
+    context.update(kwargs)
+    return template.format(**context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/unison/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/unison/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61409b14c843766aa10cb957bb1c3d83ba87c6a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/contrib/unison/__init__.py
@@ -0,0 +1,314 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Easy file synchronization among peer units using ssh + unison.
+#
+# For the -joined, -changed, and -departed peer relations, add a call to
+# ssh_authorized_peers() describing the peer relation and the desired
+# user + group.  After all peer relations have settled, all hosts should
+# be able to connect to on another via key auth'd ssh as the specified user.
+#
+# Other hooks are then free to synchronize files and directories using
+# sync_to_peers().
+#
+# For a peer relation named 'cluster', for example:
+#
+# cluster-relation-joined:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-changed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-departed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# Hooks are now free to sync files as easily as:
+#
+# files = ['/etc/fstab', '/etc/apt.conf.d/']
+# sync_to_peers(peer_interface='cluster',
+#                user='juju_ssh, paths=[files])
+#
+# It is assumed the charm itself has setup permissions on each unit
+# such that 'juju_ssh' has read + write permissions.  Also assumed
+# that the calling charm takes care of leader delegation.
+#
+# Additionally files can be synchronized only to an specific unit:
+# sync_to_peer(slave_address, user='juju_ssh',
+#              paths=[files], verbose=False)
+
+import os
+import pwd
+
+from copy import copy
+from subprocess import check_call, check_output
+
+from charmhelpers.core.host import (
+    adduser,
+    add_user_to_group,
+    pwgen,
+    remove_password_expiry,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    hook_name,
+    relation_ids,
+    related_units,
+    relation_set,
+    relation_get,
+    unit_private_ip,
+    INFO,
+    ERROR,
+)
+
+BASE_CMD = ['unison', '-auto', '-batch=true', '-confirmbigdel=false',
+            '-fastcheck=true', '-group=false', '-owner=false',
+            '-prefer=newer', '-times=true']
+
+
+def get_homedir(user):
+    try:
+        user = pwd.getpwnam(user)
+        return user.pw_dir
+    except KeyError:
+        log('Could not get homedir for user %s: user exists?' % (user), ERROR)
+        raise Exception
+
+
+def create_private_key(user, priv_key_path, key_type='rsa'):
+    types_bits = {
+        'rsa': '2048',
+        'ecdsa': '521',
+    }
+    if key_type not in types_bits:
+        log('Unknown ssh key type {}, using rsa'.format(key_type), ERROR)
+        key_type = 'rsa'
+    if not os.path.isfile(priv_key_path):
+        log('Generating new SSH key for user %s.' % user)
+        cmd = ['ssh-keygen', '-q', '-N', '', '-t', key_type,
+               '-b', types_bits[key_type], '-f', priv_key_path]
+        check_call(cmd)
+    else:
+        log('SSH key already exists at %s.' % priv_key_path)
+    check_call(['chown', user, priv_key_path])
+    check_call(['chmod', '0600', priv_key_path])
+
+
+def create_public_key(user, priv_key_path, pub_key_path):
+    if not os.path.isfile(pub_key_path):
+        log('Generating missing ssh public key @ %s.' % pub_key_path)
+        cmd = ['ssh-keygen', '-y', '-f', priv_key_path]
+        p = check_output(cmd).strip()
+        with open(pub_key_path, 'wb') as out:
+            out.write(p)
+    check_call(['chown', user, pub_key_path])
+
+
+def get_keypair(user):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    priv_key = os.path.join(ssh_dir, 'id_rsa')
+    pub_key = '%s.pub' % priv_key
+
+    if not os.path.isdir(ssh_dir):
+        os.mkdir(ssh_dir)
+        check_call(['chown', '-R', user, ssh_dir])
+
+    create_private_key(user, priv_key)
+    create_public_key(user, priv_key, pub_key)
+
+    with open(priv_key, 'r') as p:
+        _priv = p.read().strip()
+
+    with open(pub_key, 'r') as p:
+        _pub = p.read().strip()
+
+    return (_priv, _pub)
+
+
+def write_authorized_keys(user, keys):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    auth_keys = os.path.join(ssh_dir, 'authorized_keys')
+    log('Syncing authorized_keys @ %s.' % auth_keys)
+    with open(auth_keys, 'w') as out:
+        for k in keys:
+            out.write('%s\n' % k)
+
+
+def write_known_hosts(user, hosts):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    known_hosts = os.path.join(ssh_dir, 'known_hosts')
+    khosts = []
+    for host in hosts:
+        cmd = ['ssh-keyscan', host]
+        remote_key = check_output(cmd, universal_newlines=True).strip()
+        khosts.append(remote_key)
+    log('Syncing known_hosts @ %s.' % known_hosts)
+    with open(known_hosts, 'w') as out:
+        for host in khosts:
+            out.write('%s\n' % host)
+
+
+def ensure_user(user, group=None):
+    adduser(user, pwgen())
+    if group:
+        add_user_to_group(user, group)
+    # Remove password expiry (Bug #1686085)
+    remove_password_expiry(user)
+
+
+def ssh_authorized_peers(peer_interface, user, group=None,
+                         ensure_local_user=False):
+    """
+    Main setup function, should be called from both peer -changed and -joined
+    hooks with the same parameters.
+    """
+    if ensure_local_user:
+        ensure_user(user, group)
+    priv_key, pub_key = get_keypair(user)
+    hook = hook_name()
+    if hook == '%s-relation-joined' % peer_interface:
+        relation_set(ssh_pub_key=pub_key)
+    elif hook == '%s-relation-changed' % peer_interface or \
+            hook == '%s-relation-departed' % peer_interface:
+        hosts = []
+        keys = []
+
+        for r_id in relation_ids(peer_interface):
+            for unit in related_units(r_id):
+                ssh_pub_key = relation_get('ssh_pub_key',
+                                           rid=r_id,
+                                           unit=unit)
+                priv_addr = relation_get('private-address',
+                                         rid=r_id,
+                                         unit=unit)
+                if ssh_pub_key:
+                    keys.append(ssh_pub_key)
+                    hosts.append(priv_addr)
+                else:
+                    log('ssh_authorized_peers(): ssh_pub_key '
+                        'missing for unit %s, skipping.' % unit)
+        write_authorized_keys(user, keys)
+        write_known_hosts(user, hosts)
+        authed_hosts = ':'.join(hosts)
+        relation_set(ssh_authorized_hosts=authed_hosts)
+
+
+def _run_as_user(user, gid=None):
+    try:
+        user = pwd.getpwnam(user)
+    except KeyError:
+        log('Invalid user: %s' % user)
+        raise Exception
+    uid = user.pw_uid
+    gid = gid or user.pw_gid
+    os.environ['HOME'] = user.pw_dir
+
+    def _inner():
+        os.setgid(gid)
+        os.setuid(uid)
+    return _inner
+
+
+def run_as_user(user, cmd, gid=None):
+    return check_output(cmd, preexec_fn=_run_as_user(user, gid), cwd='/')
+
+
+def collect_authed_hosts(peer_interface):
+    '''Iterate through the units on peer interface to find all that
+    have the calling host in its authorized hosts list'''
+    hosts = []
+    for r_id in (relation_ids(peer_interface) or []):
+        for unit in related_units(r_id):
+            private_addr = relation_get('private-address',
+                                        rid=r_id, unit=unit)
+            authed_hosts = relation_get('ssh_authorized_hosts',
+                                        rid=r_id, unit=unit)
+
+            if not authed_hosts:
+                log('Peer %s has not authorized *any* hosts yet, skipping.' %
+                    (unit), level=INFO)
+                continue
+
+            if unit_private_ip() in authed_hosts.split(':'):
+                hosts.append(private_addr)
+            else:
+                log('Peer %s has not authorized *this* host yet, skipping.' %
+                    (unit), level=INFO)
+    return hosts
+
+
+def sync_path_to_host(path, host, user, verbose=False, cmd=None, gid=None,
+                      fatal=False):
+    """Sync path to an specific peer host
+
+    Propagates exception if operation fails and fatal=True.
+    """
+    cmd = cmd or copy(BASE_CMD)
+    if not verbose:
+        cmd.append('-silent')
+
+    # removing trailing slash from directory paths, unison
+    # doesn't like these.
+    if path.endswith('/'):
+        path = path[:(len(path) - 1)]
+
+    cmd = cmd + [path, 'ssh://%s@%s/%s' % (user, host, path)]
+
+    try:
+        log('Syncing local path %s to %s@%s:%s' % (path, user, host, path))
+        run_as_user(user, cmd, gid)
+    except Exception:
+        log('Error syncing remote files')
+        if fatal:
+            raise
+
+
+def sync_to_peer(host, user, paths=None, verbose=False, cmd=None, gid=None,
+                 fatal=False):
+    """Sync paths to an specific peer host
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for p in paths:
+            sync_path_to_host(p, host, user, verbose, cmd, gid, fatal)
+
+
+def sync_to_peers(peer_interface, user, paths=None, verbose=False, cmd=None,
+                  gid=None, fatal=False):
+    """Sync all hosts to an specific path
+
+    The type of group is integer, it allows user has permissions to
+    operate a directory have a different group id with the user id.
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for host in collect_authed_hosts(peer_interface):
+            sync_to_peer(host, user, paths, verbose, cmd, gid, fatal)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/coordinator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/coordinator.py
new file mode 100644
index 0000000000000000000000000000000000000000..59bee3e5b320f6bffa0d89eef7a20888cddb0521
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/coordinator.py
@@ -0,0 +1,606 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+The coordinator module allows you to use Juju's leadership feature to
+coordinate operations between units of a service.
+
+Behavior is defined in subclasses of coordinator.BaseCoordinator.
+One implementation is provided (coordinator.Serial), which allows an
+operation to be run on a single unit at a time, on a first come, first
+served basis. You can trivially define more complex behavior by
+subclassing BaseCoordinator or Serial.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+
+
+Services Framework Usage
+========================
+
+Ensure a peers relation is defined in metadata.yaml. Instantiate a
+BaseCoordinator subclass before invoking ServiceManager.manage().
+Ensure that ServiceManager.manage() is wired up to the leader-elected,
+leader-settings-changed, peers relation-changed and peers
+relation-departed hooks in addition to any other hooks you need, or your
+service will deadlock.
+
+Ensure calls to acquire() are guarded, so that locks are only requested
+when they are really needed (and thus hooks only triggered when necessary).
+Failing to do this and calling acquire() unconditionally will put your unit
+into a hook loop. Calls to granted() do not need to be guarded.
+
+For example::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    def maybe_restart(servicename):
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart')
+        if serial.granted('restart'):
+            hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before manager.manage()
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+You can implement a similar pattern using a decorator. If the lock has
+not been granted, an attempt to acquire() it will be made if the guard
+function returns True. If the lock has been granted, the decorated function
+is run as normal::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    serial = coordinator.Serial()  # Global, instatiated on module import.
+
+    def needs_restart():
+        [ ... Introspect state. Return True if restart is needed ... ]
+
+    @serial.require('restart', needs_restart)
+    def maybe_restart(servicename):
+        hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+Traditional Usage
+=================
+
+Ensure a peers relation is defined in metadata.yaml.
+
+If you are using charmhelpers.core.hookenv.Hooks, ensure that a
+BaseCoordinator subclass is instantiated before calling Hooks.execute.
+
+If you are not using charmhelpers.core.hookenv.Hooks, ensure
+that a BaseCoordinator subclass is instantiated and its handle()
+method called at the start of all your hooks.
+
+For example::
+
+    import sys
+    from charmhelpers.core import hookenv
+    from charmhelpers import coordinator
+
+    hooks = hookenv.Hooks()
+
+    def maybe_restart():
+        serial = coordinator.Serial()
+        if serial.granted('restart'):
+            hookenv.service_restart('myservice')
+
+    @hooks.hook
+    def config_changed():
+        update_config()
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart'):
+            maybe_restart()
+
+    # Cluster hooks must be wired up.
+    @hooks.hook('cluster-relation-changed', 'cluster-relation-departed')
+    def cluster_relation_changed():
+        maybe_restart()
+
+    # Leader hooks must be wired up.
+    @hooks.hook('leader-elected', 'leader-settings-changed')
+    def leader_settings_changed():
+        maybe_restart()
+
+    [ ... repeat for *all* other hooks you are using ... ]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before execute()
+        hooks.execute(sys.argv)
+
+
+You can also use the require decorator. If the lock has not been granted,
+an attempt to acquire() it will be made if the guard function returns True.
+If the lock has been granted, the decorated function is run as normal::
+
+    from charmhelpers.core import hookenv
+
+    hooks = hookenv.Hooks()
+    serial = coordinator.Serial()  # Must instantiate before execute()
+
+    @require('restart', needs_restart)
+    def maybe_restart():
+        hookenv.service_restart('myservice')
+
+    @hooks.hook('install', 'config-changed', 'upgrade-charm',
+                # Peers and leader hooks must be wired up.
+                'cluster-relation-changed', 'cluster-relation-departed',
+                'leader-elected', 'leader-settings-changed')
+    def default_hook():
+        [...]
+        maybe_restart()
+
+    if __name__ == '__main__':
+        hooks.execute()
+
+
+Details
+=======
+
+A simple API is provided similar to traditional locking APIs. A lock
+may be requested using the acquire() method, and the granted() method
+may be used do to check if a lock previously requested by acquire() has
+been granted. It doesn't matter how many times acquire() is called in a
+hook.
+
+Locks are released at the end of the hook they are acquired in. This may
+be the current hook if the unit is leader and the lock is free. It is
+more likely a future hook (probably leader-settings-changed, possibly
+the peers relation-changed or departed hook, potentially any hook).
+
+Whenever a charm needs to perform a coordinated action it will acquire()
+the lock and perform the action immediately if acquisition is
+successful. It will also need to perform the same action in every other
+hook if the lock has been granted.
+
+
+Grubby Details
+--------------
+
+Why do you need to be able to perform the same action in every hook?
+If the unit is the leader, then it may be able to grant its own lock
+and perform the action immediately in the source hook. If the unit is
+the leader and cannot immediately grant the lock, then its only
+guaranteed chance of acquiring the lock is in the peers relation-joined,
+relation-changed or peers relation-departed hooks when another unit has
+released it (the only channel to communicate to the leader is the peers
+relation). If the unit is not the leader, then it is unlikely the lock
+is granted in the source hook (a previous hook must have also made the
+request for this to happen). A non-leader is notified about the lock via
+leader settings. These changes may be visible in any hook, even before
+the leader-settings-changed hook has been invoked. Or the requesting
+unit may be promoted to leader after making a request, in which case the
+lock may be granted in leader-elected or in a future peers
+relation-changed or relation-departed hook.
+
+This could be simpler if leader-settings-changed was invoked on the
+leader. We could then never grant locks except in
+leader-settings-changed hooks giving one place for the operation to be
+performed. Unfortunately this is not the case with Juju 1.23 leadership.
+
+But of course, this doesn't really matter to most people as most people
+seem to prefer the Services Framework or similar reset-the-world
+approaches, rather than the twisty maze of attempting to deduce what
+should be done based on what hook happens to be running (which always
+seems to evolve into reset-the-world anyway when the charm grows beyond
+the trivial).
+
+I chose not to implement a callback model, where a callback was passed
+to acquire to be executed when the lock is granted, because the callback
+may become invalid between making the request and the lock being granted
+due to an upgrade-charm being run in the interim. And it would create
+restrictions, such no lambdas, callback defined at the top level of a
+module, etc. Still, we could implement it on top of what is here, eg.
+by adding a defer decorator that stores a pickle of itself to disk and
+have BaseCoordinator unpickle and execute them when the locks are granted.
+'''
+from datetime import datetime
+from functools import wraps
+import json
+import os.path
+
+from six import with_metaclass
+
+from charmhelpers.core import hookenv
+
+
+# We make BaseCoordinator and subclasses singletons, so that if we
+# need to spill to local storage then only a single instance does so,
+# rather than having multiple instances stomp over each other.
+class Singleton(type):
+    _instances = {}
+
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super(Singleton, cls).__call__(*args,
+                                                                 **kwargs)
+        return cls._instances[cls]
+
+
+class BaseCoordinator(with_metaclass(Singleton, object)):
+    relid = None  # Peer relation-id, set by __init__
+    relname = None
+
+    grants = None  # self.grants[unit][lock] == timestamp
+    requests = None  # self.requests[unit][lock] == timestamp
+
+    def __init__(self, relation_key='coordinator', peer_relation_name=None):
+        '''Instatiate a Coordinator.
+
+        Data is stored on the peers relation and in leadership storage
+        under the provided relation_key.
+
+        The peers relation is identified by peer_relation_name, and defaults
+        to the first one found in metadata.yaml.
+        '''
+        # Most initialization is deferred, since invoking hook tools from
+        # the constructor makes testing hard.
+        self.key = relation_key
+        self.relname = peer_relation_name
+        hookenv.atstart(self.initialize)
+
+        # Ensure that handle() is called, without placing that burden on
+        # the charm author. They still need to do this manually if they
+        # are not using a hook framework.
+        hookenv.atstart(self.handle)
+
+    def initialize(self):
+        if self.requests is not None:
+            return  # Already initialized.
+
+        assert hookenv.has_juju_version('1.23'), 'Needs Juju 1.23+'
+
+        if self.relname is None:
+            self.relname = _implicit_peer_relation_name()
+
+        relids = hookenv.relation_ids(self.relname)
+        if relids:
+            self.relid = sorted(relids)[0]
+
+        # Load our state, from leadership, the peer relationship, and maybe
+        # local state as a fallback. Populates self.requests and self.grants.
+        self._load_state()
+        self._emit_state()
+
+        # Save our state if the hook completes successfully.
+        hookenv.atexit(self._save_state)
+
+        # Schedule release of granted locks for the end of the hook.
+        # This needs to be the last of our atexit callbacks to ensure
+        # it will be run first when the hook is complete, because there
+        # is no point mutating our state after it has been saved.
+        hookenv.atexit(self._release_granted)
+
+    def acquire(self, lock):
+        '''Acquire the named lock, non-blocking.
+
+        The lock may be granted immediately, or in a future hook.
+
+        Returns True if the lock has been granted. The lock will be
+        automatically released at the end of the hook in which it is
+        granted.
+
+        Do not mindlessly call this method, as it triggers a cascade of
+        hooks. For example, if you call acquire() every time in your
+        peers relation-changed hook you will end up with an infinite loop
+        of hooks. It should almost always be guarded by some condition.
+        '''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if not ts:
+            # If there is no outstanding request on the peers relation,
+            # create one.
+            self.requests.setdefault(lock, {})
+            self.requests[unit][lock] = _timestamp()
+            self.msg('Requested {}'.format(lock))
+
+        # If the leader has granted the lock, yay.
+        if self.granted(lock):
+            self.msg('Acquired {}'.format(lock))
+            return True
+
+        # If the unit making the request also happens to be the
+        # leader, it must handle the request now. Even though the
+        # request has been stored on the peers relation, the peers
+        # relation-changed hook will not be triggered.
+        if hookenv.is_leader():
+            return self.grant(lock, unit)
+
+        return False  # Can't acquire lock, yet. Maybe next hook.
+
+    def granted(self, lock):
+        '''Return True if a previously requested lock has been granted'''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if ts and self.grants.get(unit, {}).get(lock) == ts:
+            return True
+        return False
+
+    def requested(self, lock):
+        '''Return True if we are in the queue for the lock'''
+        return lock in self.requests[hookenv.local_unit()]
+
+    def request_timestamp(self, lock):
+        '''Return the timestamp of our outstanding request for lock, or None.
+
+        Returns a datetime.datetime() UTC timestamp, with no tzinfo attribute.
+        '''
+        ts = self.requests[hookenv.local_unit()].get(lock, None)
+        if ts is not None:
+            return datetime.strptime(ts, _timestamp_format)
+
+    def handle(self):
+        if not hookenv.is_leader():
+            return  # Only the leader can grant requests.
+
+        self.msg('Leader handling coordinator requests')
+
+        # Clear our grants that have been released.
+        for unit in self.grants.keys():
+            for lock, grant_ts in list(self.grants[unit].items()):
+                req_ts = self.requests.get(unit, {}).get(lock)
+                if req_ts != grant_ts:
+                    # The request timestamp does not match the granted
+                    # timestamp. Several hooks on 'unit' may have run
+                    # before the leader got a chance to make a decision,
+                    # and 'unit' may have released its lock and attempted
+                    # to reacquire it. This will change the timestamp,
+                    # and we correctly revoke the old grant putting it
+                    # to the end of the queue.
+                    ts = datetime.strptime(self.grants[unit][lock],
+                                           _timestamp_format)
+                    del self.grants[unit][lock]
+                    self.released(unit, lock, ts)
+
+        # Grant locks
+        for unit in self.requests.keys():
+            for lock in self.requests[unit]:
+                self.grant(lock, unit)
+
+    def grant(self, lock, unit):
+        '''Maybe grant the lock to a unit.
+
+        The decision to grant the lock or not is made for $lock
+        by a corresponding method grant_$lock, which you may define
+        in a subclass. If no such method is defined, the default_grant
+        method is used. See Serial.default_grant() for details.
+        '''
+        if not hookenv.is_leader():
+            return False  # Not the leader, so we cannot grant.
+
+        # Set of units already granted the lock.
+        granted = set()
+        for u in self.grants:
+            if lock in self.grants[u]:
+                granted.add(u)
+        if unit in granted:
+            return True  # Already granted.
+
+        # Ordered list of units waiting for the lock.
+        reqs = set()
+        for u in self.requests:
+            if u in granted:
+                continue  # In the granted set. Not wanted in the req list.
+            for _lock, ts in self.requests[u].items():
+                if _lock == lock:
+                    reqs.add((ts, u))
+        queue = [t[1] for t in sorted(reqs)]
+        if unit not in queue:
+            return False  # Unit has not requested the lock.
+
+        # Locate custom logic, or fallback to the default.
+        grant_func = getattr(self, 'grant_{}'.format(lock), self.default_grant)
+
+        if grant_func(lock, unit, granted, queue):
+            # Grant the lock.
+            self.msg('Leader grants {} to {}'.format(lock, unit))
+            self.grants.setdefault(unit, {})[lock] = self.requests[unit][lock]
+            return True
+
+        return False
+
+    def released(self, unit, lock, timestamp):
+        '''Called on the leader when it has released a lock.
+
+        By default, does nothing but log messages. Override if you
+        need to perform additional housekeeping when a lock is released,
+        for example recording timestamps.
+        '''
+        interval = _utcnow() - timestamp
+        self.msg('Leader released {} from {}, held {}'.format(lock, unit,
+                                                              interval))
+
+    def require(self, lock, guard_func, *guard_args, **guard_kw):
+        """Decorate a function to be run only when a lock is acquired.
+
+        The lock is requested if the guard function returns True.
+
+        The decorated function is called if the lock has been granted.
+        """
+        def decorator(f):
+            @wraps(f)
+            def wrapper(*args, **kw):
+                if self.granted(lock):
+                    self.msg('Granted {}'.format(lock))
+                    return f(*args, **kw)
+                if guard_func(*guard_args, **guard_kw) and self.acquire(lock):
+                    return f(*args, **kw)
+                return None
+            return wrapper
+        return decorator
+
+    def msg(self, msg):
+        '''Emit a message. Override to customize log spam.'''
+        hookenv.log('coordinator.{} {}'.format(self._name(), msg),
+                    level=hookenv.INFO)
+
+    def _name(self):
+        return self.__class__.__name__
+
+    def _load_state(self):
+        self.msg('Loading state')
+
+        # All responses must be stored in the leadership settings.
+        # The leader cannot use local state, as a different unit may
+        # be leader next time. Which is fine, as the leadership
+        # settings are always available.
+        self.grants = json.loads(hookenv.leader_get(self.key) or '{}')
+
+        local_unit = hookenv.local_unit()
+
+        # All requests must be stored on the peers relation. This is
+        # the only channel units have to communicate with the leader.
+        # Even the leader needs to store its requests here, as a
+        # different unit may be leader by the time the request can be
+        # granted.
+        if self.relid is None:
+            # The peers relation is not available. Maybe we are early in
+            # the units's lifecycle. Maybe this unit is standalone.
+            # Fallback to using local state.
+            self.msg('No peer relation. Loading local state')
+            self.requests = {local_unit: self._load_local_state()}
+        else:
+            self.requests = self._load_peer_state()
+            if local_unit not in self.requests:
+                # The peers relation has just been joined. Update any state
+                # loaded from our peers with our local state.
+                self.msg('New peer relation. Merging local state')
+                self.requests[local_unit] = self._load_local_state()
+
+    def _emit_state(self):
+        # Emit this units lock status.
+        for lock in sorted(self.requests[hookenv.local_unit()].keys()):
+            if self.granted(lock):
+                self.msg('Granted {}'.format(lock))
+            else:
+                self.msg('Waiting on {}'.format(lock))
+
+    def _save_state(self):
+        self.msg('Publishing state')
+        if hookenv.is_leader():
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.grants, sort_keys=True)
+            hookenv.leader_set({self.key: raw})
+
+        local_unit = hookenv.local_unit()
+
+        if self.relid is None:
+            # No peers relation yet. Fallback to local state.
+            self.msg('No peer relation. Saving local state')
+            self._save_local_state(self.requests[local_unit])
+        else:
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.requests[local_unit], sort_keys=True)
+            hookenv.relation_set(self.relid, relation_settings={self.key: raw})
+
+    def _load_peer_state(self):
+        requests = {}
+        units = set(hookenv.related_units(self.relid))
+        units.add(hookenv.local_unit())
+        for unit in units:
+            raw = hookenv.relation_get(self.key, unit, self.relid)
+            if raw:
+                requests[unit] = json.loads(raw)
+        return requests
+
+    def _local_state_filename(self):
+        # Include the class name. We allow multiple BaseCoordinator
+        # subclasses to be instantiated, and they are singletons, so
+        # this avoids conflicts (unless someone creates and uses two
+        # BaseCoordinator subclasses with the same class name, so don't
+        # do that).
+        return '.charmhelpers.coordinator.{}'.format(self._name())
+
+    def _load_local_state(self):
+        fn = self._local_state_filename()
+        if os.path.exists(fn):
+            with open(fn, 'r') as f:
+                return json.load(f)
+        return {}
+
+    def _save_local_state(self, state):
+        fn = self._local_state_filename()
+        with open(fn, 'w') as f:
+            json.dump(state, f)
+
+    def _release_granted(self):
+        # At the end of every hook, release all locks granted to
+        # this unit. If a hook neglects to make use of what it
+        # requested, it will just have to make the request again.
+        # Implicit release is the only way this will work, as
+        # if the unit is standalone there may be no future triggers
+        # called to do a manual release.
+        unit = hookenv.local_unit()
+        for lock in list(self.requests[unit].keys()):
+            if self.granted(lock):
+                self.msg('Released local {} lock'.format(lock))
+                del self.requests[unit][lock]
+
+
+class Serial(BaseCoordinator):
+    def default_grant(self, lock, unit, granted, queue):
+        '''Default logic to grant a lock to a unit. Unless overridden,
+        only one unit may hold the lock and it will be granted to the
+        earliest queued request.
+
+        To define custom logic for $lock, create a subclass and
+        define a grant_$lock method.
+
+        `unit` is the unit name making the request.
+
+        `granted` is the set of units already granted the lock. It will
+        never include `unit`. It may be empty.
+
+        `queue` is the list of units waiting for the lock, ordered by time
+        of request. It will always include `unit`, but `unit` is not
+        necessarily first.
+
+        Returns True if the lock should be granted to `unit`.
+        '''
+        return unit == queue[0] and not granted
+
+
+def _implicit_peer_relation_name():
+    md = hookenv.metadata()
+    assert 'peers' in md, 'No peer relations in metadata.yaml'
+    return sorted(md['peers'].keys())[0]
+
+
+# A human readable, sortable UTC timestamp format.
+_timestamp_format = '%Y-%m-%d %H:%M:%S.%fZ'
+
+
+def _utcnow():  # pragma: no cover
+    # This wrapper exists as mocking datetime methods is problematic.
+    return datetime.utcnow()
+
+
+def _timestamp():
+    return _utcnow().strftime(_timestamp_format)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/decorators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/decorators.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ad41ee4121f4c0816935f8b16cd84f972aff22b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/decorators.py
@@ -0,0 +1,55 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2014 Canonical Ltd.
+#
+# Authors:
+#  Edward Hope-Morley <opentastic@gmail.com>
+#
+
+import time
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+
+def retry_on_exception(num_retries, base_delay=0, exc_type=Exception):
+    """If the decorated function raises exception exc_type, allow num_retries
+    retry attempts before raise the exception.
+    """
+    def _retry_on_exception_inner_1(f):
+        def _retry_on_exception_inner_2(*args, **kwargs):
+            retries = num_retries
+            multiplier = 1
+            while True:
+                try:
+                    return f(*args, **kwargs)
+                except exc_type:
+                    if not retries:
+                        raise
+
+                delay = base_delay * multiplier
+                multiplier += 1
+                log("Retrying '%s' %d more times (delay=%s)" %
+                    (f.__name__, retries, delay), level=INFO)
+                retries -= 1
+                if delay:
+                    time.sleep(delay)
+
+        return _retry_on_exception_inner_2
+
+    return _retry_on_exception_inner_1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/files.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/files.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdd82b75709c13da0d534bf4962822984a3c1867
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/files.py
@@ -0,0 +1,43 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Jorge Niedbalski <niedbalski@ubuntu.com>'
+
+import os
+import subprocess
+
+
+def sed(filename, before, after, flags='g'):
+    """
+    Search and replaces the given pattern on filename.
+
+    :param filename: relative or absolute file path.
+    :param before: expression to be replaced (see 'man sed')
+    :param after: expression to replace with (see 'man sed')
+    :param flags: sed-compatible regex flags in example, to make
+    the  search and replace case insensitive, specify ``flags="i"``.
+    The ``g`` flag is always specified regardless, so you do not
+    need to remember to include it when overriding this parameter.
+    :returns: If the sed command exit code was zero then return,
+    otherwise raise CalledProcessError.
+    """
+    expression = r's/{0}/{1}/{2}'.format(before,
+                                         after, flags)
+
+    return subprocess.check_call(["sed", "-i", "-r", "-e",
+                                  expression,
+                                  os.path.expanduser(filename)])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/fstab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/fstab.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9fa9152c765c538adad3fd9bc45a46018c89b72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/fstab.py
@@ -0,0 +1,132 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+class Fstab(io.FileIO):
+    """This class extends file in order to implement a file reader/writer
+    for file `/etc/fstab`
+    """
+
+    class Entry(object):
+        """Entry class represents a non-comment line on the `/etc/fstab` file
+        """
+        def __init__(self, device, mountpoint, filesystem,
+                     options, d=0, p=0):
+            self.device = device
+            self.mountpoint = mountpoint
+            self.filesystem = filesystem
+
+            if not options:
+                options = "defaults"
+
+            self.options = options
+            self.d = int(d)
+            self.p = int(p)
+
+        def __eq__(self, o):
+            return str(self) == str(o)
+
+        def __str__(self):
+            return "{} {} {} {} {} {}".format(self.device,
+                                              self.mountpoint,
+                                              self.filesystem,
+                                              self.options,
+                                              self.d,
+                                              self.p)
+
+    DEFAULT_PATH = os.path.join(os.path.sep, 'etc', 'fstab')
+
+    def __init__(self, path=None):
+        if path:
+            self._path = path
+        else:
+            self._path = self.DEFAULT_PATH
+        super(Fstab, self).__init__(self._path, 'rb+')
+
+    def _hydrate_entry(self, line):
+        # NOTE: use split with no arguments to split on any
+        #       whitespace including tabs
+        return Fstab.Entry(*filter(
+            lambda x: x not in ('', None),
+            line.strip("\n").split()))
+
+    @property
+    def entries(self):
+        self.seek(0)
+        for line in self.readlines():
+            line = line.decode('us-ascii')
+            try:
+                if line.strip() and not line.strip().startswith("#"):
+                    yield self._hydrate_entry(line)
+            except ValueError:
+                pass
+
+    def get_entry_by_attr(self, attr, value):
+        for entry in self.entries:
+            e_attr = getattr(entry, attr)
+            if e_attr == value:
+                return entry
+        return None
+
+    def add_entry(self, entry):
+        if self.get_entry_by_attr('device', entry.device):
+            return False
+
+        self.write((str(entry) + '\n').encode('us-ascii'))
+        self.truncate()
+        return entry
+
+    def remove_entry(self, entry):
+        self.seek(0)
+
+        lines = [l.decode('us-ascii') for l in self.readlines()]
+
+        found = False
+        for index, line in enumerate(lines):
+            if line.strip() and not line.strip().startswith("#"):
+                if self._hydrate_entry(line) == entry:
+                    found = True
+                    break
+
+        if not found:
+            return False
+
+        lines.remove(line)
+
+        self.seek(0)
+        self.write(''.join(lines).encode('us-ascii'))
+        self.truncate()
+        return True
+
+    @classmethod
+    def remove_by_mountpoint(cls, mountpoint, path=None):
+        fstab = cls(path=path)
+        entry = fstab.get_entry_by_attr('mountpoint', mountpoint)
+        if entry:
+            return fstab.remove_entry(entry)
+        return False
+
+    @classmethod
+    def add(cls, device, mountpoint, filesystem, options=None, path=None):
+        return cls(path=path).add_entry(Fstab.Entry(device,
+                                                    mountpoint, filesystem,
+                                                    options=options))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..db7ce7282b4c96c8a33abf309a340377216922ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hookenv.py
@@ -0,0 +1,1613 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Interactions with the Juju environment"
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+
+from __future__ import print_function
+import copy
+from distutils.version import LooseVersion
+from enum import Enum
+from functools import wraps
+from collections import namedtuple
+import glob
+import os
+import json
+import yaml
+import re
+import subprocess
+import sys
+import errno
+import tempfile
+from subprocess import CalledProcessError
+
+from charmhelpers import deprecate
+
+import six
+if not six.PY3:
+    from UserDict import UserDict
+else:
+    from collections import UserDict
+
+
+CRITICAL = "CRITICAL"
+ERROR = "ERROR"
+WARNING = "WARNING"
+INFO = "INFO"
+DEBUG = "DEBUG"
+TRACE = "TRACE"
+MARKER = object()
+SH_MAX_ARG = 131071
+
+
+RANGE_WARNING = ('Passing NO_PROXY string that includes a cidr. '
+                 'This may not be compatible with software you are '
+                 'running in your shell.')
+
+
+class WORKLOAD_STATES(Enum):
+    ACTIVE = 'active'
+    BLOCKED = 'blocked'
+    MAINTENANCE = 'maintenance'
+    WAITING = 'waiting'
+
+
+cache = {}
+
+
+def cached(func):
+    """Cache return values for multiple executions of func + args
+
+    For example::
+
+        @cached
+        def unit_get(attribute):
+            pass
+
+        unit_get('test')
+
+    will cache the result of unit_get + 'test' for future calls.
+    """
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        global cache
+        key = json.dumps((func, args, kwargs), sort_keys=True, default=str)
+        try:
+            return cache[key]
+        except KeyError:
+            pass  # Drop out of the exception handler scope.
+        res = func(*args, **kwargs)
+        cache[key] = res
+        return res
+    wrapper._wrapped = func
+    return wrapper
+
+
+def flush(key):
+    """Flushes any entries from function cache where the
+    key is found in the function+args """
+    flush_list = []
+    for item in cache:
+        if key in item:
+            flush_list.append(item)
+    for item in flush_list:
+        del cache[item]
+
+
+def log(message, level=None):
+    """Write a message to the juju log"""
+    command = ['juju-log']
+    if level:
+        command += ['-l', level]
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing juju-log should not cause failures in unit tests
+    # Send log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            if level:
+                message = "{}: {}".format(level, message)
+            message = "juju-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+def function_log(message):
+    """Write a function progress message"""
+    command = ['function-log']
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing function-log should not cause failures in unit tests
+    # Send function_log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            message = "function-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+class Serializable(UserDict):
+    """Wrapper, an object that can be serialized to yaml or json"""
+
+    def __init__(self, obj):
+        # wrap the object
+        UserDict.__init__(self)
+        self.data = obj
+
+    def __getattr__(self, attr):
+        # See if this object has attribute.
+        if attr in ("json", "yaml", "data"):
+            return self.__dict__[attr]
+        # Check for attribute in wrapped object.
+        got = getattr(self.data, attr, MARKER)
+        if got is not MARKER:
+            return got
+        # Proxy to the wrapped object via dict interface.
+        try:
+            return self.data[attr]
+        except KeyError:
+            raise AttributeError(attr)
+
+    def __getstate__(self):
+        # Pickle as a standard dictionary.
+        return self.data
+
+    def __setstate__(self, state):
+        # Unpickle into our wrapper.
+        self.data = state
+
+    def json(self):
+        """Serialize the object to json"""
+        return json.dumps(self.data)
+
+    def yaml(self):
+        """Serialize the object to yaml"""
+        return yaml.dump(self.data)
+
+
+def execution_environment():
+    """A convenient bundling of the current execution context"""
+    context = {}
+    context['conf'] = config()
+    if relation_id():
+        context['reltype'] = relation_type()
+        context['relid'] = relation_id()
+        context['rel'] = relation_get()
+    context['unit'] = local_unit()
+    context['rels'] = relations()
+    context['env'] = os.environ
+    return context
+
+
+def in_relation_hook():
+    """Determine whether we're running in a relation hook"""
+    return 'JUJU_RELATION' in os.environ
+
+
+def relation_type():
+    """The scope for the current relation hook"""
+    return os.environ.get('JUJU_RELATION', None)
+
+
+@cached
+def relation_id(relation_name=None, service_or_unit=None):
+    """The relation ID for the current or a specified relation"""
+    if not relation_name and not service_or_unit:
+        return os.environ.get('JUJU_RELATION_ID', None)
+    elif relation_name and service_or_unit:
+        service_name = service_or_unit.split('/')[0]
+        for relid in relation_ids(relation_name):
+            remote_service = remote_service_name(relid)
+            if remote_service == service_name:
+                return relid
+    else:
+        raise ValueError('Must specify neither or both of relation_name and service_or_unit')
+
+
+def local_unit():
+    """Local unit ID"""
+    return os.environ['JUJU_UNIT_NAME']
+
+
+def remote_unit():
+    """The remote unit for the current relation hook"""
+    return os.environ.get('JUJU_REMOTE_UNIT', None)
+
+
+def application_name():
+    """
+    The name of the deployed application this unit belongs to.
+    """
+    return local_unit().split('/')[0]
+
+
+def service_name():
+    """
+    .. deprecated:: 0.19.1
+       Alias for :func:`application_name`.
+    """
+    return application_name()
+
+
+def model_name():
+    """
+    Name of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_NAME']
+
+
+def model_uuid():
+    """
+    UUID of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_UUID']
+
+
+def principal_unit():
+    """Returns the principal unit of this unit, otherwise None"""
+    # Juju 2.2 and above provides JUJU_PRINCIPAL_UNIT
+    principal_unit = os.environ.get('JUJU_PRINCIPAL_UNIT', None)
+    # If it's empty, then this unit is the principal
+    if principal_unit == '':
+        return os.environ['JUJU_UNIT_NAME']
+    elif principal_unit is not None:
+        return principal_unit
+    # For Juju 2.1 and below, let's try work out the principle unit by
+    # the various charms' metadata.yaml.
+    for reltype in relation_types():
+        for rid in relation_ids(reltype):
+            for unit in related_units(rid):
+                md = _metadata_unit(unit)
+                if not md:
+                    continue
+                subordinate = md.pop('subordinate', None)
+                if not subordinate:
+                    return unit
+    return None
+
+
+@cached
+def remote_service_name(relid=None):
+    """The remote service name for a given relation-id (or the current relation)"""
+    if relid is None:
+        unit = remote_unit()
+    else:
+        units = related_units(relid)
+        unit = units[0] if units else None
+    return unit.split('/')[0] if unit else None
+
+
+def hook_name():
+    """The name of the currently executing hook"""
+    return os.environ.get('JUJU_HOOK_NAME', os.path.basename(sys.argv[0]))
+
+
+class Config(dict):
+    """A dictionary representation of the charm's config.yaml, with some
+    extra features:
+
+    - See which values in the dictionary have changed since the previous hook.
+    - For values that have changed, see what the previous value was.
+    - Store arbitrary data for use in a later hook.
+
+    NOTE: Do not instantiate this object directly - instead call
+    ``hookenv.config()``, which will return an instance of :class:`Config`.
+
+    Example usage::
+
+        >>> # inside a hook
+        >>> from charmhelpers.core import hookenv
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'bar'
+        >>> # store a new key/value for later use
+        >>> config['mykey'] = 'myval'
+
+
+        >>> # user runs `juju set mycharm foo=baz`
+        >>> # now we're inside subsequent config-changed hook
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'baz'
+        >>> # test to see if this val has changed since last hook
+        >>> config.changed('foo')
+        True
+        >>> # what was the previous value?
+        >>> config.previous('foo')
+        'bar'
+        >>> # keys/values that we add are preserved across hooks
+        >>> config['mykey']
+        'myval'
+
+    """
+    CONFIG_FILE_NAME = '.juju-persistent-config'
+
+    def __init__(self, *args, **kw):
+        super(Config, self).__init__(*args, **kw)
+        self.implicit_save = True
+        self._prev_dict = None
+        self.path = os.path.join(charm_dir(), Config.CONFIG_FILE_NAME)
+        if os.path.exists(self.path) and os.stat(self.path).st_size:
+            self.load_previous()
+        atexit(self._implicit_save)
+
+    def load_previous(self, path=None):
+        """Load previous copy of config from disk.
+
+        In normal usage you don't need to call this method directly - it
+        is called automatically at object initialization.
+
+        :param path:
+
+            File path from which to load the previous config. If `None`,
+            config is loaded from the default location. If `path` is
+            specified, subsequent `save()` calls will write to the same
+            path.
+
+        """
+        self.path = path or self.path
+        with open(self.path) as f:
+            try:
+                self._prev_dict = json.load(f)
+            except ValueError as e:
+                log('Found but was unable to parse previous config data, '
+                    'ignoring which will report all values as changed - {}'
+                    .format(str(e)), level=ERROR)
+                return
+        for k, v in copy.deepcopy(self._prev_dict).items():
+            if k not in self:
+                self[k] = v
+
+    def changed(self, key):
+        """Return True if the current value for this key is different from
+        the previous value.
+
+        """
+        if self._prev_dict is None:
+            return True
+        return self.previous(key) != self.get(key)
+
+    def previous(self, key):
+        """Return previous value for this key, or None if there
+        is no previous value.
+
+        """
+        if self._prev_dict:
+            return self._prev_dict.get(key)
+        return None
+
+    def save(self):
+        """Save this config to disk.
+
+        If the charm is using the :mod:`Services Framework <services.base>`
+        or :meth:'@hook <Hooks.hook>' decorator, this
+        is called automatically at the end of successful hook execution.
+        Otherwise, it should be called directly by user code.
+
+        To disable automatic saves, set ``implicit_save=False`` on this
+        instance.
+
+        """
+        with open(self.path, 'w') as f:
+            os.fchmod(f.fileno(), 0o600)
+            json.dump(self, f)
+
+    def _implicit_save(self):
+        if self.implicit_save:
+            self.save()
+
+
+_cache_config = None
+
+
+def config(scope=None):
+    """
+    Get the juju charm configuration (scope==None) or individual key,
+    (scope=str).  The returned value is a Python data structure loaded as
+    JSON from the Juju config command.
+
+    :param scope: If set, return the value for the specified key.
+    :type scope: Optional[str]
+    :returns: Either the whole config as a Config, or a key from it.
+    :rtype: Any
+    """
+    global _cache_config
+    config_cmd_line = ['config-get', '--all', '--format=json']
+    try:
+        # JSON Decode Exception for Python3.5+
+        exc_json = json.decoder.JSONDecodeError
+    except AttributeError:
+        # JSON Decode Exception for Python2.7 through Python3.4
+        exc_json = ValueError
+    try:
+        if _cache_config is None:
+            config_data = json.loads(
+                subprocess.check_output(config_cmd_line).decode('UTF-8'))
+            _cache_config = Config(config_data)
+        if scope is not None:
+            return _cache_config.get(scope)
+        return _cache_config
+    except (exc_json, UnicodeDecodeError) as e:
+        log('Unable to parse output from config-get: config_cmd_line="{}" '
+            'message="{}"'
+            .format(config_cmd_line, str(e)), level=ERROR)
+        return None
+
+
+@cached
+def relation_get(attribute=None, unit=None, rid=None):
+    """Get relation information"""
+    _args = ['relation-get', '--format=json']
+    if rid:
+        _args.append('-r')
+        _args.append(rid)
+    _args.append(attribute or '-')
+    if unit:
+        _args.append(unit)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except CalledProcessError as e:
+        if e.returncode == 2:
+            return None
+        raise
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Set relation information for the current unit"""
+    relation_settings = relation_settings if relation_settings else {}
+    relation_cmd_line = ['relation-set']
+    accepts_file = "--file" in subprocess.check_output(
+        relation_cmd_line + ["--help"], universal_newlines=True)
+    if relation_id is not None:
+        relation_cmd_line.extend(('-r', relation_id))
+    settings = relation_settings.copy()
+    settings.update(kwargs)
+    for key, value in settings.items():
+        # Force value to be a string: it always should, but some call
+        # sites pass in things like dicts or numbers.
+        if value is not None:
+            settings[key] = "{}".format(value)
+    if accepts_file:
+        # --file was introduced in Juju 1.23.2. Use it by default if
+        # available, since otherwise we'll break if the relation data is
+        # too big. Ideally we should tell relation-set to read the data from
+        # stdin, but that feature is broken in 1.23.2: Bug #1454678.
+        with tempfile.NamedTemporaryFile(delete=False) as settings_file:
+            settings_file.write(yaml.safe_dump(settings).encode("utf-8"))
+        subprocess.check_call(
+            relation_cmd_line + ["--file", settings_file.name])
+        os.remove(settings_file.name)
+    else:
+        for key, value in settings.items():
+            if value is None:
+                relation_cmd_line.append('{}='.format(key))
+            else:
+                relation_cmd_line.append('{}={}'.format(key, value))
+        subprocess.check_call(relation_cmd_line)
+    # Flush cache of any relation-gets for local unit
+    flush(local_unit())
+
+
+def relation_clear(r_id=None):
+    ''' Clears any relation data already set on relation r_id '''
+    settings = relation_get(rid=r_id,
+                            unit=local_unit())
+    for setting in settings:
+        if setting not in ['public-address', 'private-address']:
+            settings[setting] = None
+    relation_set(relation_id=r_id,
+                 **settings)
+
+
+@cached
+def relation_ids(reltype=None):
+    """A list of relation_ids"""
+    reltype = reltype or relation_type()
+    relid_cmd_line = ['relation-ids', '--format=json']
+    if reltype is not None:
+        relid_cmd_line.append(reltype)
+        return json.loads(
+            subprocess.check_output(relid_cmd_line).decode('UTF-8')) or []
+    return []
+
+
+@cached
+def related_units(relid=None):
+    """A list of related units"""
+    relid = relid or relation_id()
+    units_cmd_line = ['relation-list', '--format=json']
+    if relid is not None:
+        units_cmd_line.extend(('-r', relid))
+    return json.loads(
+        subprocess.check_output(units_cmd_line).decode('UTF-8')) or []
+
+
+def expected_peer_units():
+    """Get a generator for units we expect to join peer relation based on
+    goal-state.
+
+    The local unit is excluded from the result to make it easy to gauge
+    completion of all peers joining the relation with existing hook tools.
+
+    Example usage:
+    log('peer {} of {} joined peer relation'
+        .format(len(related_units()),
+                len(list(expected_peer_units()))))
+
+    This function will raise NotImplementedError if used with juju versions
+    without goal-state support.
+
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: NotImplementedError
+    """
+    if not has_juju_version("2.4.0"):
+        # goal-state first appeared in 2.4.0.
+        raise NotImplementedError("goal-state")
+    _goal_state = goal_state()
+    return (key for key in _goal_state['units']
+            if '/' in key and key != local_unit())
+
+
+def expected_related_units(reltype=None):
+    """Get a generator for units we expect to join relation based on
+    goal-state.
+
+    Note that you can not use this function for the peer relation, take a look
+    at expected_peer_units() for that.
+
+    This function will raise KeyError if you request information for a
+    relation type for which juju goal-state does not have information.  It will
+    raise NotImplementedError if used with juju versions without goal-state
+    support.
+
+    Example usage:
+    log('participant {} of {} joined relation {}'
+        .format(len(related_units()),
+                len(list(expected_related_units())),
+                relation_type()))
+
+    :param reltype: Relation type to list data for, default is to list data for
+                    the realtion type we are currently executing a hook for.
+    :type reltype: str
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: KeyError, NotImplementedError
+    """
+    if not has_juju_version("2.4.4"):
+        # goal-state existed in 2.4.0, but did not list individual units to
+        # join a relation in 2.4.1 through 2.4.3. (LP: #1794739)
+        raise NotImplementedError("goal-state relation unit count")
+    reltype = reltype or relation_type()
+    _goal_state = goal_state()
+    return (key for key in _goal_state['relations'][reltype] if '/' in key)
+
+
+@cached
+def relation_for_unit(unit=None, rid=None):
+    """Get the json represenation of a unit's relation"""
+    unit = unit or remote_unit()
+    relation = relation_get(unit=unit, rid=rid)
+    for key in relation:
+        if key.endswith('-list'):
+            relation[key] = relation[key].split()
+    relation['__unit__'] = unit
+    return relation
+
+
+@cached
+def relations_for_id(relid=None):
+    """Get relations of a specific relation ID"""
+    relation_data = []
+    relid = relid or relation_ids()
+    for unit in related_units(relid):
+        unit_data = relation_for_unit(unit, relid)
+        unit_data['__relid__'] = relid
+        relation_data.append(unit_data)
+    return relation_data
+
+
+@cached
+def relations_of_type(reltype=None):
+    """Get relations of a specific type"""
+    relation_data = []
+    reltype = reltype or relation_type()
+    for relid in relation_ids(reltype):
+        for relation in relations_for_id(relid):
+            relation['__relid__'] = relid
+            relation_data.append(relation)
+    return relation_data
+
+
+@cached
+def metadata():
+    """Get the current charm metadata.yaml contents as a python object"""
+    with open(os.path.join(charm_dir(), 'metadata.yaml')) as md:
+        return yaml.safe_load(md)
+
+
+def _metadata_unit(unit):
+    """Given the name of a unit (e.g. apache2/0), get the unit charm's
+    metadata.yaml. Very similar to metadata() but allows us to inspect
+    other units. Unit needs to be co-located, such as a subordinate or
+    principal/primary.
+
+    :returns: metadata.yaml as a python object.
+
+    """
+    basedir = os.sep.join(charm_dir().split(os.sep)[:-2])
+    unitdir = 'unit-{}'.format(unit.replace(os.sep, '-'))
+    joineddir = os.path.join(basedir, unitdir, 'charm', 'metadata.yaml')
+    if not os.path.exists(joineddir):
+        return None
+    with open(joineddir) as md:
+        return yaml.safe_load(md)
+
+
+@cached
+def relation_types():
+    """Get a list of relation types supported by this charm"""
+    rel_types = []
+    md = metadata()
+    for key in ('provides', 'requires', 'peers'):
+        section = md.get(key)
+        if section:
+            rel_types.extend(section.keys())
+    return rel_types
+
+
+@cached
+def peer_relation_id():
+    '''Get the peers relation id if a peers relation has been joined, else None.'''
+    md = metadata()
+    section = md.get('peers')
+    if section:
+        for key in section:
+            relids = relation_ids(key)
+            if relids:
+                return relids[0]
+    return None
+
+
+@cached
+def relation_to_interface(relation_name):
+    """
+    Given the name of a relation, return the interface that relation uses.
+
+    :returns: The interface name, or ``None``.
+    """
+    return relation_to_role_and_interface(relation_name)[1]
+
+
+@cached
+def relation_to_role_and_interface(relation_name):
+    """
+    Given the name of a relation, return the role and the name of the interface
+    that relation uses (where role is one of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A tuple containing ``(role, interface)``, or ``(None, None)``.
+    """
+    _metadata = metadata()
+    for role in ('provides', 'requires', 'peers'):
+        interface = _metadata.get(role, {}).get(relation_name, {}).get('interface')
+        if interface:
+            return role, interface
+    return None, None
+
+
+@cached
+def role_and_interface_to_relations(role, interface_name):
+    """
+    Given a role and interface name, return a list of relation names for the
+    current charm that use that interface under that role (where role is one
+    of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A list of relation names.
+    """
+    _metadata = metadata()
+    results = []
+    for relation_name, relation in _metadata.get(role, {}).items():
+        if relation['interface'] == interface_name:
+            results.append(relation_name)
+    return results
+
+
+@cached
+def interface_to_relations(interface_name):
+    """
+    Given an interface, return a list of relation names for the current
+    charm that use that interface.
+
+    :returns: A list of relation names.
+    """
+    results = []
+    for role in ('provides', 'requires', 'peers'):
+        results.extend(role_and_interface_to_relations(role, interface_name))
+    return results
+
+
+@cached
+def charm_name():
+    """Get the name of the current charm as is specified on metadata.yaml"""
+    return metadata().get('name')
+
+
+@cached
+def relations():
+    """Get a nested dictionary of relation data for all related units"""
+    rels = {}
+    for reltype in relation_types():
+        relids = {}
+        for relid in relation_ids(reltype):
+            units = {local_unit(): relation_get(unit=local_unit(), rid=relid)}
+            for unit in related_units(relid):
+                reldata = relation_get(unit=unit, rid=relid)
+                units[unit] = reldata
+            relids[relid] = units
+        rels[reltype] = relids
+    return rels
+
+
+@cached
+def is_relation_made(relation, keys='private-address'):
+    '''
+    Determine whether a relation is established by checking for
+    presence of key(s).  If a list of keys is provided, they
+    must all be present for the relation to be identified as made
+    '''
+    if isinstance(keys, str):
+        keys = [keys]
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            context = {}
+            for k in keys:
+                context[k] = relation_get(k, rid=r_id,
+                                          unit=unit)
+            if None not in context.values():
+                return True
+    return False
+
+
+def _port_op(op_name, port, protocol="TCP"):
+    """Open or close a service network port"""
+    _args = [op_name]
+    icmp = protocol.upper() == "ICMP"
+    if icmp:
+        _args.append(protocol)
+    else:
+        _args.append('{}/{}'.format(port, protocol))
+    try:
+        subprocess.check_call(_args)
+    except subprocess.CalledProcessError:
+        # Older Juju pre 2.3 doesn't support ICMP
+        # so treat it as a no-op if it fails.
+        if not icmp:
+            raise
+
+
+def open_port(port, protocol="TCP"):
+    """Open a service network port"""
+    _port_op('open-port', port, protocol)
+
+
+def close_port(port, protocol="TCP"):
+    """Close a service network port"""
+    _port_op('close-port', port, protocol)
+
+
+def open_ports(start, end, protocol="TCP"):
+    """Opens a range of service network ports"""
+    _args = ['open-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def close_ports(start, end, protocol="TCP"):
+    """Close a range of service network ports"""
+    _args = ['close-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def opened_ports():
+    """Get the opened ports
+
+    *Note that this will only show ports opened in a previous hook*
+
+    :returns: Opened ports as a list of strings: ``['8080/tcp', '8081-8083/tcp']``
+    """
+    _args = ['opened-ports', '--format=json']
+    return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+
+
+@cached
+def unit_get(attribute):
+    """Get the unit ID for the remote unit"""
+    _args = ['unit-get', '--format=json', attribute]
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+def unit_public_ip():
+    """Get this unit's public IP address"""
+    return unit_get('public-address')
+
+
+def unit_private_ip():
+    """Get this unit's private IP address"""
+    return unit_get('private-address')
+
+
+@cached
+def storage_get(attribute=None, storage_id=None):
+    """Get storage attributes"""
+    _args = ['storage-get', '--format=json']
+    if storage_id:
+        _args.extend(('-s', storage_id))
+    if attribute:
+        _args.append(attribute)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+@cached
+def storage_list(storage_name=None):
+    """List the storage IDs for the unit"""
+    _args = ['storage-list', '--format=json']
+    if storage_name:
+        _args.append(storage_name)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except OSError as e:
+        import errno
+        if e.errno == errno.ENOENT:
+            # storage-list does not exist
+            return []
+        raise
+
+
+class UnregisteredHookError(Exception):
+    """Raised when an undefined hook is called"""
+    pass
+
+
+class Hooks(object):
+    """A convenient handler for hook functions.
+
+    Example::
+
+        hooks = Hooks()
+
+        # register a hook, taking its name from the function name
+        @hooks.hook()
+        def install():
+            pass  # your code here
+
+        # register a hook, providing a custom hook name
+        @hooks.hook("config-changed")
+        def config_changed():
+            pass  # your code here
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, config_save=None):
+        super(Hooks, self).__init__()
+        self._hooks = {}
+
+        # For unknown reasons, we allow the Hooks constructor to override
+        # config().implicit_save.
+        if config_save is not None:
+            config().implicit_save = config_save
+
+    def register(self, name, function):
+        """Register a hook"""
+        self._hooks[name] = function
+
+    def execute(self, args):
+        """Execute a registered hook based on args[0]"""
+        _run_atstart()
+        hook_name = os.path.basename(args[0])
+        if hook_name in self._hooks:
+            try:
+                self._hooks[hook_name]()
+            except SystemExit as x:
+                if x.code is None or x.code == 0:
+                    _run_atexit()
+                raise
+            _run_atexit()
+        else:
+            raise UnregisteredHookError(hook_name)
+
+    def hook(self, *hook_names):
+        """Decorator, registering them as hooks"""
+        def wrapper(decorated):
+            for hook_name in hook_names:
+                self.register(hook_name, decorated)
+            else:
+                self.register(decorated.__name__, decorated)
+                if '_' in decorated.__name__:
+                    self.register(
+                        decorated.__name__.replace('_', '-'), decorated)
+            return decorated
+        return wrapper
+
+
+class NoNetworkBinding(Exception):
+    pass
+
+
+def charm_dir():
+    """Return the root directory of the current charm"""
+    d = os.environ.get('JUJU_CHARM_DIR')
+    if d is not None:
+        return d
+    return os.environ.get('CHARM_DIR')
+
+
+def cmd_exists(cmd):
+    """Return True if the specified cmd exists in the path"""
+    return any(
+        os.access(os.path.join(path, cmd), os.X_OK)
+        for path in os.environ["PATH"].split(os.pathsep)
+    )
+
+
+@cached
+@deprecate("moved to function_get()", log=log)
+def action_get(key=None):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_get`.
+
+    Gets the value of an action parameter, or all key/value param pairs.
+    """
+    cmd = ['action-get']
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    action_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return action_data
+
+
+@cached
+def function_get(key=None):
+    """Gets the value of an action parameter, or all key/value param pairs"""
+    cmd = ['function-get']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-get']
+
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    function_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return function_data
+
+
+@deprecate("moved to function_set()", log=log)
+def action_set(values):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_set`.
+
+    Sets the values to be returned after the action finishes.
+    """
+    cmd = ['action-set']
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+def function_set(values):
+    """Sets the values to be returned after the function finishes"""
+    cmd = ['function-set']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-set']
+
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@deprecate("moved to function_fail()", log=log)
+def action_fail(message):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_fail`.
+
+    Sets the action status to failed and sets the error message.
+
+    The results set by action_set are preserved.
+    """
+    subprocess.check_call(['action-fail', message])
+
+
+def function_fail(message):
+    """Sets the function status to failed and sets the error message.
+
+    The results set by function_set are preserved."""
+    cmd = ['function-fail']
+    # Fallback for older charms.
+    if not cmd_exists('function-fail'):
+        cmd = ['action-fail']
+    cmd.append(message)
+
+    subprocess.check_call(cmd)
+
+
+def action_name():
+    """Get the name of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_NAME')
+
+
+def function_name():
+    """Get the name of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_NAME') or action_name()
+
+
+def action_uuid():
+    """Get the UUID of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_UUID')
+
+
+def function_id():
+    """Get the ID of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_ID') or action_uuid()
+
+
+def action_tag():
+    """Get the tag for the currently executing action."""
+    return os.environ.get('JUJU_ACTION_TAG')
+
+
+def function_tag():
+    """Get the tag for the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_TAG') or action_tag()
+
+
+def status_set(workload_state, message, application=False):
+    """Set the workload state with a message
+
+    Use status-set to set the workload state with a message which is visible
+    to the user via juju status. If the status-set command is not found then
+    assume this is juju < 1.23 and juju-log the message instead.
+
+    workload_state   -- valid juju workload state. str or WORKLOAD_STATES
+    message          -- status update message
+    application      -- Whether this is an application state set
+    """
+    bad_state_msg = '{!r} is not a valid workload state'
+
+    if isinstance(workload_state, str):
+        try:
+            # Convert string to enum.
+            workload_state = WORKLOAD_STATES[workload_state.upper()]
+        except KeyError:
+            raise ValueError(bad_state_msg.format(workload_state))
+
+    if workload_state not in WORKLOAD_STATES:
+        raise ValueError(bad_state_msg.format(workload_state))
+
+    cmd = ['status-set']
+    if application:
+        cmd.append('--application')
+    cmd.extend([workload_state.value, message])
+    try:
+        ret = subprocess.call(cmd)
+        if ret == 0:
+            return
+    except OSError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'status-set failed: {} {}'.format(workload_state.value,
+                                                    message)
+    log(log_message, level='INFO')
+
+
+def status_get():
+    """Retrieve the previously set juju workload state and message
+
+    If the status-get command is not found then assume this is juju < 1.23 and
+    return 'unknown', ""
+
+    """
+    cmd = ['status-get', "--format=json", "--include-data"]
+    try:
+        raw_status = subprocess.check_output(cmd)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            return ('unknown', "")
+        else:
+            raise
+    else:
+        status = json.loads(raw_status.decode("UTF-8"))
+        return (status["status"], status["message"])
+
+
+def translate_exc(from_exc, to_exc):
+    def inner_translate_exc1(f):
+        @wraps(f)
+        def inner_translate_exc2(*args, **kwargs):
+            try:
+                return f(*args, **kwargs)
+            except from_exc:
+                raise to_exc
+
+        return inner_translate_exc2
+
+    return inner_translate_exc1
+
+
+def application_version_set(version):
+    """Charm authors may trigger this command from any hook to output what
+    version of the application is running. This could be a package version,
+    for instance postgres version 9.5. It could also be a build number or
+    version control revision identifier, for instance git sha 6fb7ba68. """
+
+    cmd = ['application-version-set']
+    cmd.append(version)
+    try:
+        subprocess.check_call(cmd)
+    except OSError:
+        log("Application Version: {}".format(version))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+@cached
+def goal_state():
+    """Juju goal state values"""
+    cmd = ['goal-state', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def is_leader():
+    """Does the current unit hold the juju leadership
+
+    Uses juju to determine whether the current unit is the leader of its peers
+    """
+    cmd = ['is-leader', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_get(attribute=None):
+    """Juju leader get value(s)"""
+    cmd = ['leader-get', '--format=json'] + [attribute or '-']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_set(settings=None, **kwargs):
+    """Juju leader set value(s)"""
+    # Don't log secrets.
+    # log("Juju leader-set '%s'" % (settings), level=DEBUG)
+    cmd = ['leader-set']
+    settings = settings or {}
+    settings.update(kwargs)
+    for k, v in settings.items():
+        if v is None:
+            cmd.append('{}='.format(k))
+        else:
+            cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_register(ptype, klass, pid):
+    """ is used while a hook is running to let Juju know that a
+        payload has been started."""
+    cmd = ['payload-register']
+    for x in [ptype, klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_unregister(klass, pid):
+    """ is used while a hook is running to let Juju know
+    that a payload has been manually stopped. The <class> and <id> provided
+    must match a payload that has been previously registered with juju using
+    payload-register."""
+    cmd = ['payload-unregister']
+    for x in [klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_status_set(klass, pid, status):
+    """is used to update the current status of a registered payload.
+    The <class> and <id> provided must match a payload that has been previously
+    registered with juju using payload-register. The <status> must be one of the
+    follow: starting, started, stopping, stopped"""
+    cmd = ['payload-status-set']
+    for x in [klass, pid, status]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def resource_get(name):
+    """used to fetch the resource path of the given name.
+
+    <name> must match a name of defined resource in metadata.yaml
+
+    returns either a path or False if resource not available
+    """
+    if not name:
+        return False
+
+    cmd = ['resource-get', name]
+    try:
+        return subprocess.check_output(cmd).decode('UTF-8')
+    except subprocess.CalledProcessError:
+        return False
+
+
+@cached
+def juju_version():
+    """Full version string (eg. '1.23.3.1-trusty-amd64')"""
+    # Per https://bugs.launchpad.net/juju-core/+bug/1455368/comments/1
+    jujud = glob.glob('/var/lib/juju/tools/machine-*/jujud')[0]
+    return subprocess.check_output([jujud, 'version'],
+                                   universal_newlines=True).strip()
+
+
+def has_juju_version(minimum_version):
+    """Return True if the Juju version is at least the provided version"""
+    return LooseVersion(juju_version()) >= LooseVersion(minimum_version)
+
+
+_atexit = []
+_atstart = []
+
+
+def atstart(callback, *args, **kwargs):
+    '''Schedule a callback to run before the main hook.
+
+    Callbacks are run in the order they were added.
+
+    This is useful for modules and classes to perform initialization
+    and inject behavior. In particular:
+
+        - Run common code before all of your hooks, such as logging
+          the hook name or interesting relation data.
+        - Defer object or module initialization that requires a hook
+          context until we know there actually is a hook context,
+          making testing easier.
+        - Rather than requiring charm authors to include boilerplate to
+          invoke your helper's behavior, have it run automatically if
+          your object is instantiated or module imported.
+
+    This is not at all useful after your hook framework as been launched.
+    '''
+    global _atstart
+    _atstart.append((callback, args, kwargs))
+
+
+def atexit(callback, *args, **kwargs):
+    '''Schedule a callback to run on successful hook completion.
+
+    Callbacks are run in the reverse order that they were added.'''
+    _atexit.append((callback, args, kwargs))
+
+
+def _run_atstart():
+    '''Hook frameworks must invoke this before running the main hook body.'''
+    global _atstart
+    for callback, args, kwargs in _atstart:
+        callback(*args, **kwargs)
+    del _atstart[:]
+
+
+def _run_atexit():
+    '''Hook frameworks must invoke this after the main hook body has
+    successfully completed. Do not invoke it if the hook fails.'''
+    global _atexit
+    for callback, args, kwargs in reversed(_atexit):
+        callback(*args, **kwargs)
+    del _atexit[:]
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def network_get_primary_address(binding):
+    '''
+    Deprecated since Juju 2.3; use network_get()
+
+    Retrieve the primary network address for a named binding
+
+    :param binding: string. The name of a relation of extra-binding
+    :return: string. The primary IP address for the named binding
+    :raise: NotImplementedError if run on Juju < 2.0
+    '''
+    cmd = ['network-get', '--primary-address', binding]
+    try:
+        response = subprocess.check_output(
+            cmd,
+            stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    except CalledProcessError as e:
+        if 'no network config found for binding' in e.output.decode('UTF-8'):
+            raise NoNetworkBinding("No network binding for {}"
+                                   .format(binding))
+        else:
+            raise
+    return response
+
+
+def network_get(endpoint, relation_id=None):
+    """
+    Retrieve the network details for a relation endpoint
+
+    :param endpoint: string. The name of a relation endpoint
+    :param relation_id: int. The ID of the relation for the current context.
+    :return: dict. The loaded YAML output of the network-get query.
+    :raise: NotImplementedError if request not supported by the Juju version.
+    """
+    if not has_juju_version('2.2'):
+        raise NotImplementedError(juju_version())  # earlier versions require --primary-address
+    if relation_id and not has_juju_version('2.3'):
+        raise NotImplementedError  # 2.3 added the -r option
+
+    cmd = ['network-get', endpoint, '--format', 'yaml']
+    if relation_id:
+        cmd.append('-r')
+        cmd.append(relation_id)
+    response = subprocess.check_output(
+        cmd,
+        stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    return yaml.safe_load(response)
+
+
+def add_metric(*args, **kwargs):
+    """Add metric values. Values may be expressed with keyword arguments. For
+    metric names containing dashes, these may be expressed as one or more
+    'key=value' positional arguments. May only be called from the collect-metrics
+    hook."""
+    _args = ['add-metric']
+    _kvpairs = []
+    _kvpairs.extend(args)
+    _kvpairs.extend(['{}={}'.format(k, v) for k, v in kwargs.items()])
+    _args.extend(sorted(_kvpairs))
+    try:
+        subprocess.check_call(_args)
+        return
+    except EnvironmentError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'add-metric failed: {}'.format(' '.join(_kvpairs))
+    log(log_message, level='INFO')
+
+
+def meter_status():
+    """Get the meter status, if running in the meter-status-changed hook."""
+    return os.environ.get('JUJU_METER_STATUS')
+
+
+def meter_info():
+    """Get the meter status information, if running in the meter-status-changed
+    hook."""
+    return os.environ.get('JUJU_METER_INFO')
+
+
+def iter_units_for_relation_name(relation_name):
+    """Iterate through all units in a relation
+
+    Generator that iterates through all the units in a relation and yields
+    a named tuple with rid and unit field names.
+
+    Usage:
+    data = [(u.rid, u.unit)
+            for u in iter_units_for_relation_name(relation_name)]
+
+    :param relation_name: string relation name
+    :yield: Named Tuple with rid and unit field names
+    """
+    RelatedUnit = namedtuple('RelatedUnit', 'rid, unit')
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            yield RelatedUnit(rid, unit)
+
+
+def ingress_address(rid=None, unit=None):
+    """
+    Retrieve the ingress-address from a relation when available.
+    Otherwise, return the private-address.
+
+    When used on the consuming side of the relation (unit is a remote
+    unit), the ingress-address is the IP address that this unit needs
+    to use to reach the provided service on the remote unit.
+
+    When used on the providing side of the relation (unit == local_unit()),
+    the ingress-address is the IP address that is advertised to remote
+    units on this relation. Remote units need to use this address to
+    reach the local provided service on this unit.
+
+    Note that charms may document some other method to use in
+    preference to the ingress_address(), such as an address provided
+    on a different relation attribute or a service discovery mechanism.
+    This allows charms to redirect inbound connections to their peers
+    or different applications such as load balancers.
+
+    Usage:
+    addresses = [ingress_address(rid=u.rid, unit=u.unit)
+                 for u in iter_units_for_relation_name(relation_name)]
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: string IP address
+    """
+    settings = relation_get(rid=rid, unit=unit)
+    return (settings.get('ingress-address') or
+            settings.get('private-address'))
+
+
+def egress_subnets(rid=None, unit=None):
+    """
+    Retrieve the egress-subnets from a relation.
+
+    This function is to be used on the providing side of the
+    relation, and provides the ranges of addresses that client
+    connections may come from. The result is uninteresting on
+    the consuming side of a relation (unit == local_unit()).
+
+    Returns a stable list of subnets in CIDR format.
+    eg. ['192.168.1.0/24', '2001::F00F/128']
+
+    If egress-subnets is not available, falls back to using the published
+    ingress-address, or finally private-address.
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: list of subnets in CIDR format. eg. ['192.168.1.0/24', '2001::F00F/128']
+    """
+    def _to_range(addr):
+        if re.search(r'^(?:\d{1,3}\.){3}\d{1,3}$', addr) is not None:
+            addr += '/32'
+        elif ':' in addr and '/' not in addr:  # IPv6
+            addr += '/128'
+        return addr
+
+    settings = relation_get(rid=rid, unit=unit)
+    if 'egress-subnets' in settings:
+        return [n.strip() for n in settings['egress-subnets'].split(',') if n.strip()]
+    if 'ingress-address' in settings:
+        return [_to_range(settings['ingress-address'])]
+    if 'private-address' in settings:
+        return [_to_range(settings['private-address'])]
+    return []  # Should never happen
+
+
+def unit_doomed(unit=None):
+    """Determines if the unit is being removed from the model
+
+    Requires Juju 2.4.1.
+
+    :param unit: string unit name, defaults to local_unit
+    :side effect: calls goal_state
+    :side effect: calls local_unit
+    :side effect: calls has_juju_version
+    :return: True if the unit is being removed, already gone, or never existed
+    """
+    if not has_juju_version("2.4.1"):
+        # We cannot risk blindly returning False for 'we don't know',
+        # because that could cause data loss; if call sites don't
+        # need an accurate answer, they likely don't need this helper
+        # at all.
+        # goal-state existed in 2.4.0, but did not handle removals
+        # correctly until 2.4.1.
+        raise NotImplementedError("is_doomed")
+    if unit is None:
+        unit = local_unit()
+    gs = goal_state()
+    units = gs.get('units', {})
+    if unit not in units:
+        return True
+    # I don't think 'dead' units ever show up in the goal-state, but
+    # check anyway in addition to 'dying'.
+    return units[unit]['status'] in ('dying', 'dead')
+
+
+def env_proxy_settings(selected_settings=None):
+    """Get proxy settings from process environment variables.
+
+    Get charm proxy settings from environment variables that correspond to
+    juju-http-proxy, juju-https-proxy juju-no-proxy (available as of 2.4.2, see
+    lp:1782236) and juju-ftp-proxy in a format suitable for passing to an
+    application that reacts to proxy settings passed as environment variables.
+    Some applications support lowercase or uppercase notation (e.g. curl), some
+    support only lowercase (e.g. wget), there are also subjectively rare cases
+    of only uppercase notation support. no_proxy CIDR and wildcard support also
+    varies between runtimes and applications as there is no enforced standard.
+
+    Some applications may connect to multiple destinations and expose config
+    options that would affect only proxy settings for a specific destination
+    these should be handled in charms in an application-specific manner.
+
+    :param selected_settings: format only a subset of possible settings
+    :type selected_settings: list
+    :rtype: Option(None, dict[str, str])
+    """
+    SUPPORTED_SETTINGS = {
+        'http': 'HTTP_PROXY',
+        'https': 'HTTPS_PROXY',
+        'no_proxy': 'NO_PROXY',
+        'ftp': 'FTP_PROXY'
+    }
+    if selected_settings is None:
+        selected_settings = SUPPORTED_SETTINGS
+
+    selected_vars = [v for k, v in SUPPORTED_SETTINGS.items()
+                     if k in selected_settings]
+    proxy_settings = {}
+    for var in selected_vars:
+        var_val = os.getenv(var)
+        if var_val:
+            proxy_settings[var] = var_val
+            proxy_settings[var.lower()] = var_val
+        # Now handle juju-prefixed environment variables. The legacy vs new
+        # environment variable usage is mutually exclusive
+        charm_var_val = os.getenv('JUJU_CHARM_{}'.format(var))
+        if charm_var_val:
+            proxy_settings[var] = charm_var_val
+            proxy_settings[var.lower()] = charm_var_val
+    if 'no_proxy' in proxy_settings:
+        if _contains_range(proxy_settings['no_proxy']):
+            log(RANGE_WARNING, level=WARNING)
+    return proxy_settings if proxy_settings else None
+
+
+def _contains_range(addresses):
+    """Check for cidr or wildcard domain in a string.
+
+    Given a string comprising a comma seperated list of ip addresses
+    and domain names, determine whether the string contains IP ranges
+    or wildcard domains.
+
+    :param addresses: comma seperated list of domains and ip addresses.
+    :type addresses: str
+    """
+    return (
+        # Test for cidr (e.g. 10.20.20.0/24)
+        "/" in addresses or
+        # Test for wildcard domains (*.foo.com or .foo.com)
+        "*" in addresses or
+        addresses.startswith(".") or
+        ",." in addresses or
+        " ." in addresses)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..b33ac906d9eeb198210dceb069724ac9a35652ea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host.py
@@ -0,0 +1,1104 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tools for working with the host system"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Nick Moffitt <nick.moffitt@canonical.com>
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import os
+import re
+import pwd
+import glob
+import grp
+import random
+import string
+import subprocess
+import hashlib
+import functools
+import itertools
+import six
+
+from contextlib import contextmanager
+from collections import OrderedDict
+from .hookenv import log, INFO, DEBUG, local_unit, charm_name
+from .fstab import Fstab
+from charmhelpers.osplatform import get_platform
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.host_factory.ubuntu import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+        get_distrib_codename,
+        arch
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.host_factory.centos import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+    )  # flake8: noqa -- ignore F401 for this import
+
+UPDATEDB_PATH = '/etc/updatedb.conf'
+
+
+def service_start(service_name, **kwargs):
+    """Start a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('start', service_name, **kwargs)
+
+
+def service_stop(service_name, **kwargs):
+    """Stop a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('stop', service_name, **kwargs)
+
+
+def service_restart(service_name, **kwargs):
+    """Restart a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be restarted. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_restart('ceph-osd', id=4)
+
+    :param service_name: the name of the service to restart
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    return service('restart', service_name)
+
+
+def service_reload(service_name, restart_on_failure=False, **kwargs):
+    """Reload a system service, optionally falling back to restart if
+    reload fails.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_reload('ceph-osd', id=4)
+
+    :param service_name: the name of the service to reload
+    :param restart_on_failure: boolean indicating whether to fallback to a
+                               restart if the reload fails.
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    service_result = service('reload', service_name, **kwargs)
+    if not service_result and restart_on_failure:
+        service_result = service('restart', service_name, **kwargs)
+    return service_result
+
+
+def service_pause(service_name, init_dir="/etc/init", initd_dir="/etc/init.d",
+                  **kwargs):
+    """Pause a system service.
+
+    Stop it, and prevent it from starting again at boot.
+
+    :param service_name: the name of the service to pause
+    :param init_dir: path to the upstart init directory
+    :param initd_dir: path to the sysv init directory
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for init systems which do not support
+                     key=value arguments via the commandline.
+    """
+    stopped = True
+    if service_running(service_name, **kwargs):
+        stopped = service_stop(service_name, **kwargs)
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('disable', service_name)
+        service('mask', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        with open(override_path, 'w') as fh:
+            fh.write("manual\n")
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "disable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    return stopped
+
+
+def service_resume(service_name, init_dir="/etc/init",
+                   initd_dir="/etc/init.d", **kwargs):
+    """Resume a system service.
+
+    Reenable starting again at boot. Start the service.
+
+    :param service_name: the name of the service to resume
+    :param init_dir: the path to the init dir
+    :param initd dir: the path to the initd dir
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('unmask', service_name)
+        service('enable', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        if os.path.exists(override_path):
+            os.unlink(override_path)
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "enable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    started = service_running(service_name, **kwargs)
+
+    if not started:
+        started = service_start(service_name, **kwargs)
+    return started
+
+
+def service(action, service_name, **kwargs):
+    """Control a system service.
+
+    :param action: the action to take on the service
+    :param service_name: the name of the service to perform th action on
+    :param **kwargs: additional params to be passed to the service command in
+                    the form of key=value.
+    """
+    if init_is_systemd():
+        cmd = ['systemctl', action, service_name]
+    else:
+        cmd = ['service', service_name, action]
+        for key, value in six.iteritems(kwargs):
+            parameter = '%s=%s' % (key, value)
+            cmd.append(parameter)
+    return subprocess.call(cmd) == 0
+
+
+_UPSTART_CONF = "/etc/init/{}.conf"
+_INIT_D_CONF = "/etc/init.d/{}"
+
+
+def service_running(service_name, **kwargs):
+    """Determine whether a system service is running.
+
+    :param service_name: the name of the service
+    :param **kwargs: additional args to pass to the service command. This is
+                     used to pass additional key=value arguments to the
+                     service command line for managing specific instance
+                     units (e.g. service ceph-osd status id=2). The kwargs
+                     are ignored in systemd services.
+    """
+    if init_is_systemd():
+        return service('is-active', service_name)
+    else:
+        if os.path.exists(_UPSTART_CONF.format(service_name)):
+            try:
+                cmd = ['status', service_name]
+                for key, value in six.iteritems(kwargs):
+                    parameter = '%s=%s' % (key, value)
+                    cmd.append(parameter)
+                output = subprocess.check_output(
+                    cmd, stderr=subprocess.STDOUT).decode('UTF-8')
+            except subprocess.CalledProcessError:
+                return False
+            else:
+                # This works for upstart scripts where the 'service' command
+                # returns a consistent string to represent running
+                # 'start/running'
+                if ("start/running" in output or
+                        "is running" in output or
+                        "up and running" in output):
+                    return True
+        elif os.path.exists(_INIT_D_CONF.format(service_name)):
+            # Check System V scripts init script return codes
+            return service('status', service_name)
+        return False
+
+
+SYSTEMD_SYSTEM = '/run/systemd/system'
+
+
+def init_is_systemd():
+    """Return True if the host system uses systemd, False otherwise."""
+    if lsb_release()['DISTRIB_CODENAME'] == 'trusty':
+        return False
+    return os.path.isdir(SYSTEMD_SYSTEM)
+
+
+def adduser(username, password=None, shell='/bin/bash',
+            system_user=False, primary_group=None,
+            secondary_groups=None, uid=None, home_dir=None):
+    """Add a user to the system.
+
+    Will log but otherwise succeed if the user already exists.
+
+    :param str username: Username to create
+    :param str password: Password for user; if ``None``, create a system user
+    :param str shell: The default shell for the user
+    :param bool system_user: Whether to create a login or system user
+    :param str primary_group: Primary group for user; defaults to username
+    :param list secondary_groups: Optional list of additional groups
+    :param int uid: UID for user being created
+    :param str home_dir: Home directory for user
+
+    :returns: The password database entry struct, as returned by `pwd.getpwnam`
+    """
+    try:
+        user_info = pwd.getpwnam(username)
+        log('user {0} already exists!'.format(username))
+        if uid:
+            user_info = pwd.getpwuid(int(uid))
+            log('user with uid {0} already exists!'.format(uid))
+    except KeyError:
+        log('creating user {0}'.format(username))
+        cmd = ['useradd']
+        if uid:
+            cmd.extend(['--uid', str(uid)])
+        if home_dir:
+            cmd.extend(['--home', str(home_dir)])
+        if system_user or password is None:
+            cmd.append('--system')
+        else:
+            cmd.extend([
+                '--create-home',
+                '--shell', shell,
+                '--password', password,
+            ])
+        if not primary_group:
+            try:
+                grp.getgrnam(username)
+                primary_group = username  # avoid "group exists" error
+            except KeyError:
+                pass
+        if primary_group:
+            cmd.extend(['-g', primary_group])
+        if secondary_groups:
+            cmd.extend(['-G', ','.join(secondary_groups)])
+        cmd.append(username)
+        subprocess.check_call(cmd)
+        user_info = pwd.getpwnam(username)
+    return user_info
+
+
+def user_exists(username):
+    """Check if a user exists"""
+    try:
+        pwd.getpwnam(username)
+        user_exists = True
+    except KeyError:
+        user_exists = False
+    return user_exists
+
+
+def uid_exists(uid):
+    """Check if a uid exists"""
+    try:
+        pwd.getpwuid(uid)
+        uid_exists = True
+    except KeyError:
+        uid_exists = False
+    return uid_exists
+
+
+def group_exists(groupname):
+    """Check if a group exists"""
+    try:
+        grp.getgrnam(groupname)
+        group_exists = True
+    except KeyError:
+        group_exists = False
+    return group_exists
+
+
+def gid_exists(gid):
+    """Check if a gid exists"""
+    try:
+        grp.getgrgid(gid)
+        gid_exists = True
+    except KeyError:
+        gid_exists = False
+    return gid_exists
+
+
+def add_group(group_name, system_group=False, gid=None):
+    """Add a group to the system
+
+    Will log but otherwise succeed if the group already exists.
+
+    :param str group_name: group to create
+    :param bool system_group: Create system group
+    :param int gid: GID for user being created
+
+    :returns: The password database entry struct, as returned by `grp.getgrnam`
+    """
+    try:
+        group_info = grp.getgrnam(group_name)
+        log('group {0} already exists!'.format(group_name))
+        if gid:
+            group_info = grp.getgrgid(gid)
+            log('group with gid {0} already exists!'.format(gid))
+    except KeyError:
+        log('creating group {0}'.format(group_name))
+        add_new_group(group_name, system_group, gid)
+        group_info = grp.getgrnam(group_name)
+    return group_info
+
+
+def add_user_to_group(username, group):
+    """Add a user to a group"""
+    cmd = ['gpasswd', '-a', username, group]
+    log("Adding user {} to group {}".format(username, group))
+    subprocess.check_call(cmd)
+
+
+def chage(username, lastday=None, expiredate=None, inactive=None,
+          mindays=None, maxdays=None, root=None, warndays=None):
+    """Change user password expiry information
+
+    :param str username: User to update
+    :param str lastday: Set when password was changed in YYYY-MM-DD format
+    :param str expiredate: Set when user's account will no longer be
+                           accessible in YYYY-MM-DD format.
+                           -1 will remove an account expiration date.
+    :param str inactive: Set the number of days of inactivity after a password
+                         has expired before the account is locked.
+                         -1 will remove an account's inactivity.
+    :param str mindays: Set the minimum number of days between password
+                        changes to MIN_DAYS.
+                        0 indicates the password can be changed anytime.
+    :param str maxdays: Set the maximum number of days during which a
+                        password is valid.
+                        -1 as MAX_DAYS will remove checking maxdays
+    :param str root: Apply changes in the CHROOT_DIR directory
+    :param str warndays: Set the number of days of warning before a password
+                         change is required
+    :raises subprocess.CalledProcessError: if call to chage fails
+    """
+    cmd = ['chage']
+    if root:
+        cmd.extend(['--root', root])
+    if lastday:
+        cmd.extend(['--lastday', lastday])
+    if expiredate:
+        cmd.extend(['--expiredate', expiredate])
+    if inactive:
+        cmd.extend(['--inactive', inactive])
+    if mindays:
+        cmd.extend(['--mindays', mindays])
+    if maxdays:
+        cmd.extend(['--maxdays', maxdays])
+    if warndays:
+        cmd.extend(['--warndays', warndays])
+    cmd.append(username)
+    subprocess.check_call(cmd)
+
+
+remove_password_expiry = functools.partial(chage, expiredate='-1', inactive='-1', mindays='0', maxdays='-1')
+
+
+def rsync(from_path, to_path, flags='-r', options=None, timeout=None):
+    """Replicate the contents of a path"""
+    options = options or ['--delete', '--executability']
+    cmd = ['/usr/bin/rsync', flags]
+    if timeout:
+        cmd = ['timeout', str(timeout)] + cmd
+    cmd.extend(options)
+    cmd.append(from_path)
+    cmd.append(to_path)
+    log(" ".join(cmd))
+    return subprocess.check_output(cmd, stderr=subprocess.STDOUT).decode('UTF-8').strip()
+
+
+def symlink(source, destination):
+    """Create a symbolic link"""
+    log("Symlinking {} as {}".format(source, destination))
+    cmd = [
+        'ln',
+        '-sf',
+        source,
+        destination,
+    ]
+    subprocess.check_call(cmd)
+
+
+def mkdir(path, owner='root', group='root', perms=0o555, force=False):
+    """Create a directory"""
+    log("Making dir {} {}:{} {:o}".format(path, owner, group,
+                                          perms))
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    realpath = os.path.abspath(path)
+    path_exists = os.path.exists(realpath)
+    if path_exists and force:
+        if not os.path.isdir(realpath):
+            log("Removing non-directory file {} prior to mkdir()".format(path))
+            os.unlink(realpath)
+            os.makedirs(realpath, perms)
+    elif not path_exists:
+        os.makedirs(realpath, perms)
+    os.chown(realpath, uid, gid)
+    os.chmod(realpath, perms)
+
+
+def write_file(path, content, owner='root', group='root', perms=0o444):
+    """Create or overwrite a file with the contents of a byte string."""
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    # lets see if we can grab the file and compare the context, to avoid doing
+    # a write.
+    existing_content = None
+    existing_uid, existing_gid, existing_perms = None, None, None
+    try:
+        with open(path, 'rb') as target:
+            existing_content = target.read()
+        stat = os.stat(path)
+        existing_uid, existing_gid, existing_perms = (
+            stat.st_uid, stat.st_gid, stat.st_mode
+        )
+    except Exception:
+        pass
+    if content != existing_content:
+        log("Writing file {} {}:{} {:o}".format(path, owner, group, perms),
+            level=DEBUG)
+        with open(path, 'wb') as target:
+            os.fchown(target.fileno(), uid, gid)
+            os.fchmod(target.fileno(), perms)
+            if six.PY3 and isinstance(content, six.string_types):
+                content = content.encode('UTF-8')
+            target.write(content)
+        return
+    # the contents were the same, but we might still need to change the
+    # ownership or permissions.
+    if existing_uid != uid:
+        log("Changing uid on already existing content: {} -> {}"
+            .format(existing_uid, uid), level=DEBUG)
+        os.chown(path, uid, -1)
+    if existing_gid != gid:
+        log("Changing gid on already existing content: {} -> {}"
+            .format(existing_gid, gid), level=DEBUG)
+        os.chown(path, -1, gid)
+    if existing_perms != perms:
+        log("Changing permissions on existing content: {} -> {}"
+            .format(existing_perms, perms), level=DEBUG)
+        os.chmod(path, perms)
+
+
+def fstab_remove(mp):
+    """Remove the given mountpoint entry from /etc/fstab"""
+    return Fstab.remove_by_mountpoint(mp)
+
+
+def fstab_add(dev, mp, fs, options=None):
+    """Adds the given device entry to the /etc/fstab file"""
+    return Fstab.add(dev, mp, fs, options=options)
+
+
+def mount(device, mountpoint, options=None, persist=False, filesystem="ext3"):
+    """Mount a filesystem at a particular mountpoint"""
+    cmd_args = ['mount']
+    if options is not None:
+        cmd_args.extend(['-o', options])
+    cmd_args.extend([device, mountpoint])
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error mounting {} at {}\n{}'.format(device, mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_add(device, mountpoint, filesystem, options=options)
+    return True
+
+
+def umount(mountpoint, persist=False):
+    """Unmount a filesystem"""
+    cmd_args = ['umount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_remove(mountpoint)
+    return True
+
+
+def mounts():
+    """Get a list of all mounted volumes as [[mountpoint,device],[...]]"""
+    with open('/proc/mounts') as f:
+        # [['/mount/point','/dev/path'],[...]]
+        system_mounts = [m[1::-1] for m in [l.strip().split()
+                                            for l in f.readlines()]]
+    return system_mounts
+
+
+def fstab_mount(mountpoint):
+    """Mount filesystem using fstab"""
+    cmd_args = ['mount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+    return True
+
+
+def file_hash(path, hash_type='md5'):
+    """Generate a hash checksum of the contents of 'path' or None if not found.
+
+    :param str hash_type: Any hash alrgorithm supported by :mod:`hashlib`,
+                          such as md5, sha1, sha256, sha512, etc.
+    """
+    if os.path.exists(path):
+        h = getattr(hashlib, hash_type)()
+        with open(path, 'rb') as source:
+            h.update(source.read())
+        return h.hexdigest()
+    else:
+        return None
+
+
+def path_hash(path):
+    """Generate a hash checksum of all files matching 'path'. Standard
+    wildcards like '*' and '?' are supported, see documentation for the 'glob'
+    module for more information.
+
+    :return: dict: A { filename: hash } dictionary for all matched files.
+                   Empty if none found.
+    """
+    return {
+        filename: file_hash(filename)
+        for filename in glob.iglob(path)
+    }
+
+
+def check_hash(path, checksum, hash_type='md5'):
+    """Validate a file using a cryptographic checksum.
+
+    :param str checksum: Value of the checksum used to validate the file.
+    :param str hash_type: Hash algorithm used to generate `checksum`.
+        Can be any hash alrgorithm supported by :mod:`hashlib`,
+        such as md5, sha1, sha256, sha512, etc.
+    :raises ChecksumError: If the file fails the checksum
+
+    """
+    actual_checksum = file_hash(path, hash_type)
+    if checksum != actual_checksum:
+        raise ChecksumError("'%s' != '%s'" % (checksum, actual_checksum))
+
+
+class ChecksumError(ValueError):
+    """A class derived from Value error to indicate the checksum failed."""
+    pass
+
+
+def restart_on_change(restart_map, stopstart=False, restart_functions=None):
+    """Restart services based on configuration files changing
+
+    This function is used a decorator, for example::
+
+        @restart_on_change({
+            '/etc/ceph/ceph.conf': [ 'cinder-api', 'cinder-volume' ]
+            '/etc/apache/sites-enabled/*': [ 'apache2' ]
+            })
+        def config_changed():
+            pass  # your code here
+
+    In this example, the cinder-api and cinder-volume services
+    would be restarted if /etc/ceph/ceph.conf is changed by the
+    ceph_client_changed function. The apache2 service would be
+    restarted if any file matching the pattern got changed, created
+    or removed. Standard wildcards are supported, see documentation
+    for the 'glob' module for more information.
+
+    @param restart_map: {path_file_name: [service_name, ...]
+    @param stopstart: DEFAULT false; whether to stop, start OR restart
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result from decorated function
+    """
+    def wrap(f):
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), restart_map, stopstart,
+                restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def restart_on_change_helper(lambda_f, restart_map, stopstart=False,
+                             restart_functions=None):
+    """Helper function to perform the restart_on_change function.
+
+    This is provided for decorators to restart services if files described
+    in the restart_map have changed after an invocation of lambda_f().
+
+    @param lambda_f: function to call.
+    @param restart_map: {file: [service, ...]}
+    @param stopstart: whether to stop, start or restart a service
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result of lambda_f()
+    """
+    if restart_functions is None:
+        restart_functions = {}
+    checksums = {path: path_hash(path) for path in restart_map}
+    r = lambda_f()
+    # create a list of lists of the services to restart
+    restarts = [restart_map[path]
+                for path in restart_map
+                if path_hash(path) != checksums[path]]
+    # create a flat list of ordered services without duplicates from lists
+    services_list = list(OrderedDict.fromkeys(itertools.chain(*restarts)))
+    if services_list:
+        actions = ('stop', 'start') if stopstart else ('restart',)
+        for service_name in services_list:
+            if service_name in restart_functions:
+                restart_functions[service_name](service_name)
+            else:
+                for action in actions:
+                    service(action, service_name)
+    return r
+
+
+def pwgen(length=None):
+    """Generate a random pasword."""
+    if length is None:
+        # A random length is ok to use a weak PRNG
+        length = random.choice(range(35, 45))
+    alphanumeric_chars = [
+        l for l in (string.ascii_letters + string.digits)
+        if l not in 'l0QD1vAEIOUaeiou']
+    # Use a crypto-friendly PRNG (e.g. /dev/urandom) for making the
+    # actual password
+    random_generator = random.SystemRandom()
+    random_chars = [
+        random_generator.choice(alphanumeric_chars) for _ in range(length)]
+    return(''.join(random_chars))
+
+
+def is_phy_iface(interface):
+    """Returns True if interface is not virtual, otherwise False."""
+    if interface:
+        sys_net = '/sys/class/net'
+        if os.path.isdir(sys_net):
+            for iface in glob.glob(os.path.join(sys_net, '*')):
+                if '/virtual/' in os.path.realpath(iface):
+                    continue
+
+                if interface == os.path.basename(iface):
+                    return True
+
+    return False
+
+
+def get_bond_master(interface):
+    """Returns bond master if interface is bond slave otherwise None.
+
+    NOTE: the provided interface is expected to be physical
+    """
+    if interface:
+        iface_path = '/sys/class/net/%s' % (interface)
+        if os.path.exists(iface_path):
+            if '/virtual/' in os.path.realpath(iface_path):
+                return None
+
+            master = os.path.join(iface_path, 'master')
+            if os.path.exists(master):
+                master = os.path.realpath(master)
+                # make sure it is a bond master
+                if os.path.exists(os.path.join(master, 'bonding')):
+                    return os.path.basename(master)
+
+    return None
+
+
+def list_nics(nic_type=None):
+    """Return a list of nics of given type(s)"""
+    if isinstance(nic_type, six.string_types):
+        int_types = [nic_type]
+    else:
+        int_types = nic_type
+
+    interfaces = []
+    if nic_type:
+        for int_type in int_types:
+            cmd = ['ip', 'addr', 'show', 'label', int_type + '*']
+            ip_output = subprocess.check_output(cmd).decode('UTF-8')
+            ip_output = ip_output.split('\n')
+            ip_output = (line for line in ip_output if line)
+            for line in ip_output:
+                if line.split()[1].startswith(int_type):
+                    matched = re.search('.*: (' + int_type +
+                                        r'[0-9]+\.[0-9]+)@.*', line)
+                    if matched:
+                        iface = matched.groups()[0]
+                    else:
+                        iface = line.split()[1].replace(":", "")
+
+                    if iface not in interfaces:
+                        interfaces.append(iface)
+    else:
+        cmd = ['ip', 'a']
+        ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+        ip_output = (line.strip() for line in ip_output if line)
+
+        key = re.compile(r'^[0-9]+:\s+(.+):')
+        for line in ip_output:
+            matched = re.search(key, line)
+            if matched:
+                iface = matched.group(1)
+                iface = iface.partition("@")[0]
+                if iface not in interfaces:
+                    interfaces.append(iface)
+
+    return interfaces
+
+
+def set_nic_mtu(nic, mtu):
+    """Set the Maximum Transmission Unit (MTU) on a network interface."""
+    cmd = ['ip', 'link', 'set', nic, 'mtu', mtu]
+    subprocess.check_call(cmd)
+
+
+def get_nic_mtu(nic):
+    """Return the Maximum Transmission Unit (MTU) for a network interface."""
+    cmd = ['ip', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+    mtu = ""
+    for line in ip_output:
+        words = line.split()
+        if 'mtu' in words:
+            mtu = words[words.index("mtu") + 1]
+    return mtu
+
+
+def get_nic_hwaddr(nic):
+    """Return the Media Access Control (MAC) for a network interface."""
+    cmd = ['ip', '-o', '-0', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8')
+    hwaddr = ""
+    words = ip_output.split()
+    if 'link/ether' in words:
+        hwaddr = words[words.index('link/ether') + 1]
+    return hwaddr
+
+
+@contextmanager
+def chdir(directory):
+    """Change the current working directory to a different directory for a code
+    block and return the previous directory after the block exits. Useful to
+    run commands from a specificed directory.
+
+    :param str directory: The directory path to change to for this context.
+    """
+    cur = os.getcwd()
+    try:
+        yield os.chdir(directory)
+    finally:
+        os.chdir(cur)
+
+
+def chownr(path, owner, group, follow_links=True, chowntopdir=False):
+    """Recursively change user and group ownership of files and directories
+    in given path. Doesn't chown path itself by default, only its children.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    :param bool follow_links: Also follow and chown links if True
+    :param bool chowntopdir: Also chown path itself if True
+    """
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    if follow_links:
+        chown = os.chown
+    else:
+        chown = os.lchown
+
+    if chowntopdir:
+        broken_symlink = os.path.lexists(path) and not os.path.exists(path)
+        if not broken_symlink:
+            chown(path, uid, gid)
+    for root, dirs, files in os.walk(path, followlinks=follow_links):
+        for name in dirs + files:
+            full = os.path.join(root, name)
+            broken_symlink = os.path.lexists(full) and not os.path.exists(full)
+            if not broken_symlink:
+                chown(full, uid, gid)
+
+
+def lchownr(path, owner, group):
+    """Recursively change user and group ownership of files and directories
+    in a given path, not following symbolic links. See the documentation for
+    'os.lchown' for more information.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    """
+    chownr(path, owner, group, follow_links=False)
+
+
+def owner(path):
+    """Returns a tuple containing the username & groupname owning the path.
+
+    :param str path: the string path to retrieve the ownership
+    :return tuple(str, str): A (username, groupname) tuple containing the
+                             name of the user and group owning the path.
+    :raises OSError: if the specified path does not exist
+    """
+    stat = os.stat(path)
+    username = pwd.getpwuid(stat.st_uid)[0]
+    groupname = grp.getgrgid(stat.st_gid)[0]
+    return username, groupname
+
+
+def get_total_ram():
+    """The total amount of system RAM in bytes.
+
+    This is what is reported by the OS, and may be overcommitted when
+    there are multiple containers hosted on the same machine.
+    """
+    with open('/proc/meminfo', 'r') as f:
+        for line in f.readlines():
+            if line:
+                key, value, unit = line.split()
+                if key == 'MemTotal:':
+                    assert unit == 'kB', 'Unknown unit'
+                    return int(value) * 1024  # Classic, not KiB.
+        raise NotImplementedError()
+
+
+UPSTART_CONTAINER_TYPE = '/run/container_type'
+
+
+def is_container():
+    """Determine whether unit is running in a container
+
+    @return: boolean indicating if unit is in a container
+    """
+    if init_is_systemd():
+        # Detect using systemd-detect-virt
+        return subprocess.call(['systemd-detect-virt',
+                                '--container']) == 0
+    else:
+        # Detect using upstart container file marker
+        return os.path.exists(UPSTART_CONTAINER_TYPE)
+
+
+def add_to_updatedb_prunepath(path, updatedb_path=UPDATEDB_PATH):
+    """Adds the specified path to the mlocate's udpatedb.conf PRUNEPATH list.
+
+    This method has no effect if the path specified by updatedb_path does not
+    exist or is not a file.
+
+    @param path: string the path to add to the updatedb.conf PRUNEPATHS value
+    @param updatedb_path: the path the updatedb.conf file
+    """
+    if not os.path.exists(updatedb_path) or os.path.isdir(updatedb_path):
+        # If the updatedb.conf file doesn't exist then don't attempt to update
+        # the file as the package providing mlocate may not be installed on
+        # the local system
+        return
+
+    with open(updatedb_path, 'r+') as f_id:
+        updatedb_text = f_id.read()
+        output = updatedb(updatedb_text, path)
+        f_id.seek(0)
+        f_id.write(output)
+        f_id.truncate()
+
+
+def updatedb(updatedb_text, new_path):
+    lines = [line for line in updatedb_text.split("\n")]
+    for i, line in enumerate(lines):
+        if line.startswith("PRUNEPATHS="):
+            paths_line = line.split("=")[1].replace('"', '')
+            paths = paths_line.split(" ")
+            if new_path not in paths:
+                paths.append(new_path)
+                lines[i] = 'PRUNEPATHS="{}"'.format(' '.join(paths))
+    output = "\n".join(lines)
+    return output
+
+
+def modulo_distribution(modulo=3, wait=30, non_zero_wait=False):
+    """ Modulo distribution
+
+    This helper uses the unit number, a modulo value and a constant wait time
+    to produce a calculated wait time distribution. This is useful in large
+    scale deployments to distribute load during an expensive operation such as
+    service restarts.
+
+    If you have 1000 nodes that need to restart 100 at a time 1 minute at a
+    time:
+
+      time.wait(modulo_distribution(modulo=100, wait=60))
+      restart()
+
+    If you need restarts to happen serially set modulo to the exact number of
+    nodes and set a high constant wait time:
+
+      time.wait(modulo_distribution(modulo=10, wait=120))
+      restart()
+
+    @param modulo: int The modulo number creates the group distribution
+    @param wait: int The constant time wait value
+    @param non_zero_wait: boolean Override unit % modulo == 0,
+                          return modulo * wait. Used to avoid collisions with
+                          leader nodes which are often given priority.
+    @return: int Calculated time to wait for unit operation
+    """
+    unit_number = int(local_unit().split('/')[1])
+    calculated_wait_time = (unit_number % modulo) * wait
+    if non_zero_wait and calculated_wait_time == 0:
+        return modulo * wait
+    else:
+        return calculated_wait_time
+
+
+def install_ca_cert(ca_cert, name=None):
+    """
+    Install the given cert as a trusted CA.
+
+    The ``name`` is the stem of the filename where the cert is written, and if
+    not provided, it will default to ``juju-{charm_name}``.
+
+    If the cert is empty or None, or is unchanged, nothing is done.
+    """
+    if not ca_cert:
+        return
+    if not isinstance(ca_cert, bytes):
+        ca_cert = ca_cert.encode('utf8')
+    if not name:
+        name = 'juju-{}'.format(charm_name())
+    cert_file = '/usr/local/share/ca-certificates/{}.crt'.format(name)
+    new_hash = hashlib.md5(ca_cert).hexdigest()
+    if file_hash(cert_file) == new_hash:
+        return
+    log("Installing new CA cert at: {}".format(cert_file), level=INFO)
+    write_file(cert_file, ca_cert)
+    subprocess.check_call(['update-ca-certificates', '--fresh'])
+
+
+def get_system_env(key, default=None):
+    """Get data from system environment as represented in ``/etc/environment``.
+
+    :param key: Key to look up
+    :type key: str
+    :param default: Value to return if key is not found
+    :type default: any
+    :returns: Value for key if found or contents of default parameter
+    :rtype: any
+    :raises: subprocess.CalledProcessError
+    """
+    env_file = '/etc/environment'
+    # use the shell and env(1) to parse the global environments file.  This is
+    # done to get the correct result even if the user has shell variable
+    # substitutions or other shell logic in that file.
+    output = subprocess.check_output(
+        ['env', '-i', '/bin/bash', '-c',
+         'set -a && source {} && env'.format(env_file)],
+        universal_newlines=True)
+    for k, v in (line.split('=', 1)
+                 for line in output.splitlines() if '=' in line):
+        if k == key:
+            return v
+    else:
+        return default
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..7781a3961f23ce0b161ae08b11710466af8de814
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/centos.py
@@ -0,0 +1,72 @@
+import subprocess
+import yum
+import os
+
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Host releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+
+    def __init__(self, item):
+        raise NotImplementedError(
+            "CompareHostReleases() is not implemented for CentOS")
+
+
+def service_available(service_name):
+    # """Determine whether a system service is available."""
+    if os.path.isdir('/run/systemd/system'):
+        cmd = ['systemctl', 'is-enabled', service_name]
+    else:
+        cmd = ['service', service_name, 'is-enabled']
+    return subprocess.call(cmd) == 0
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['groupadd']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('-r')
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/os-release in a dict."""
+    d = {}
+    with open('/etc/os-release', 'r') as lsb:
+        for l in lsb:
+            s = l.split('=')
+            if len(s) != 2:
+                continue
+            d[s[0].strip()] = s[1].strip()
+    return d
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports YumBase function if the pkgcache argument
+    is None.
+    """
+    if not pkgcache:
+        y = yum.YumBase()
+        packages = y.doPackageLists()
+        pkgcache = {i.Name: i.version for i in packages['installed']}
+    pkg = pkgcache[package]
+    if pkg > revno:
+        return 1
+    if pkg < revno:
+        return -1
+    return 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3edc0687275b29762b45ebf3fe1b045bc9f568b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/host_factory/ubuntu.py
@@ -0,0 +1,116 @@
+import subprocess
+
+from charmhelpers.core.hookenv import cached
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+UBUNTU_RELEASES = (
+    'lucid',
+    'maverick',
+    'natty',
+    'oneiric',
+    'precise',
+    'quantal',
+    'raring',
+    'saucy',
+    'trusty',
+    'utopic',
+    'vivid',
+    'wily',
+    'xenial',
+    'yakkety',
+    'zesty',
+    'artful',
+    'bionic',
+    'cosmic',
+    'disco',
+    'eoan',
+    'focal'
+)
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Ubuntu releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+    _list = UBUNTU_RELEASES
+
+
+def service_available(service_name):
+    """Determine whether a system service is available"""
+    try:
+        subprocess.check_output(
+            ['service', service_name, 'status'],
+            stderr=subprocess.STDOUT).decode('UTF-8')
+    except subprocess.CalledProcessError as e:
+        return b'unrecognized service' not in e.output
+    else:
+        return True
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['addgroup']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('--system')
+    else:
+        cmd.extend([
+            '--group',
+        ])
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/lsb-release in a dict"""
+    d = {}
+    with open('/etc/lsb-release', 'r') as lsb:
+        for l in lsb:
+            k, v = l.split('=')
+            d[k.strip()] = v.strip()
+    return d
+
+
+def get_distrib_codename():
+    """Return the codename of the distribution
+    :returns: The codename
+    :rtype: str
+    """
+    return lsb_release()['DISTRIB_CODENAME'].lower()
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports apt_cache function from charmhelpers.fetch if
+    the pkgcache argument is None. Be sure to add charmhelpers.fetch if
+    you call this function, or pass an apt_pkg.Cache() instance.
+    """
+    from charmhelpers.fetch import apt_pkg
+    if not pkgcache:
+        from charmhelpers.fetch import apt_cache
+        pkgcache = apt_cache()
+    pkg = pkgcache[package]
+    return apt_pkg.version_compare(pkg.current_ver.ver_str, revno)
+
+
+@cached
+def arch():
+    """Return the package architecture as a string.
+
+    :returns: the architecture
+    :rtype: str
+    :raises: subprocess.CalledProcessError if dpkg command fails
+    """
+    return subprocess.check_output(
+        ['dpkg', '--print-architecture']
+    ).rstrip().decode('UTF-8')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hugepage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hugepage.py
new file mode 100644
index 0000000000000000000000000000000000000000..54b5b5e2fcf81eea5f2ebfbceb620ea68d725584
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/hugepage.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+from charmhelpers.core import fstab
+from charmhelpers.core import sysctl
+from charmhelpers.core.host import (
+    add_group,
+    add_user_to_group,
+    fstab_mount,
+    mkdir,
+)
+from charmhelpers.core.strutils import bytes_from_string
+from subprocess import check_output
+
+
+def hugepage_support(user, group='hugetlb', nr_hugepages=256,
+                     max_map_count=65536, mnt_point='/run/hugepages/kvm',
+                     pagesize='2MB', mount=True, set_shmmax=False):
+    """Enable hugepages on system.
+
+    Args:
+    user (str)  -- Username to allow access to hugepages to
+    group (str) -- Group name to own hugepages
+    nr_hugepages (int) -- Number of pages to reserve
+    max_map_count (int) -- Number of Virtual Memory Areas a process can own
+    mnt_point (str) -- Directory to mount hugepages on
+    pagesize (str) -- Size of hugepages
+    mount (bool) -- Whether to Mount hugepages
+    """
+    group_info = add_group(group)
+    gid = group_info.gr_gid
+    add_user_to_group(user, group)
+    if max_map_count < 2 * nr_hugepages:
+        max_map_count = 2 * nr_hugepages
+    sysctl_settings = {
+        'vm.nr_hugepages': nr_hugepages,
+        'vm.max_map_count': max_map_count,
+        'vm.hugetlb_shm_group': gid,
+    }
+    if set_shmmax:
+        shmmax_current = int(check_output(['sysctl', '-n', 'kernel.shmmax']))
+        shmmax_minsize = bytes_from_string(pagesize) * nr_hugepages
+        if shmmax_minsize > shmmax_current:
+            sysctl_settings['kernel.shmmax'] = shmmax_minsize
+    sysctl.create(yaml.dump(sysctl_settings), '/etc/sysctl.d/10-hugepage.conf')
+    mkdir(mnt_point, owner='root', group='root', perms=0o755, force=False)
+    lfstab = fstab.Fstab()
+    fstab_entry = lfstab.get_entry_by_attr('mountpoint', mnt_point)
+    if fstab_entry:
+        lfstab.remove_entry(fstab_entry)
+    entry = lfstab.Entry('nodev', mnt_point, 'hugetlbfs',
+                         'mode=1770,gid={},pagesize={}'.format(gid, pagesize), 0, 0)
+    lfstab.add_entry(entry)
+    if mount:
+        fstab_mount(mnt_point)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel.py
new file mode 100644
index 0000000000000000000000000000000000000000..e01f4f8ba73ee0d5ab7553740c2590a50e42f96d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel.py
@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+from charmhelpers.osplatform import get_platform
+from charmhelpers.core.hookenv import (
+    log,
+    INFO
+)
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.kernel_factory.ubuntu import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.kernel_factory.centos import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def modprobe(module, persist=True):
+    """Load a kernel module and configure for auto-load on reboot."""
+    cmd = ['modprobe', module]
+
+    log('Loading kernel module %s' % module, level=INFO)
+
+    subprocess.check_call(cmd)
+    if persist:
+        persistent_modprobe(module)
+
+
+def rmmod(module, force=False):
+    """Remove a module from the linux kernel"""
+    cmd = ['rmmod']
+    if force:
+        cmd.append('-f')
+    cmd.append(module)
+    log('Removing kernel module %s' % module, level=INFO)
+    return subprocess.check_call(cmd)
+
+
+def lsmod():
+    """Shows what kernel modules are currently loaded"""
+    return subprocess.check_output(['lsmod'],
+                                   universal_newlines=True)
+
+
+def is_module_loaded(module):
+    """Checks if a kernel module is already loaded"""
+    matches = re.findall('^%s[ ]+' % module, lsmod(), re.M)
+    return len(matches) > 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c402c1157900ff1ad5c6c296a409c9e8fb96d2b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/centos.py
@@ -0,0 +1,17 @@
+import subprocess
+import os
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    if not os.path.exists('/etc/rc.modules'):
+        open('/etc/rc.modules', 'a')
+        os.chmod('/etc/rc.modules', 111)
+    with open('/etc/rc.modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write('modprobe %s\n' % module)
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["dracut", "-f", version])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3de372fd3df38fe151cf79243f129cb504516f22
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/kernel_factory/ubuntu.py
@@ -0,0 +1,13 @@
+import subprocess
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    with open('/etc/modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write(module + "\n")
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["update-initramfs", "-k", version, "-u"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61fd074edc09de434859e48ae1b36baef0503708
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .base import *  # NOQA
+from .helpers import *  # NOQA
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..179ad4f0c367dd6b13c10b201c3752d1c8daf05e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/base.py
@@ -0,0 +1,362 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import json
+from inspect import getargspec
+from collections import Iterable, OrderedDict
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+__all__ = ['ServiceManager', 'ManagerCallback',
+           'PortManagerCallback', 'open_ports', 'close_ports', 'manage_ports',
+           'service_restart', 'service_stop']
+
+
+class ServiceManager(object):
+    def __init__(self, services=None):
+        """
+        Register a list of services, given their definitions.
+
+        Service definitions are dicts in the following formats (all keys except
+        'service' are optional)::
+
+            {
+                "service": <service name>,
+                "required_data": <list of required data contexts>,
+                "provided_data": <list of provided data contexts>,
+                "data_ready": <one or more callbacks>,
+                "data_lost": <one or more callbacks>,
+                "start": <one or more callbacks>,
+                "stop": <one or more callbacks>,
+                "ports": <list of ports to manage>,
+            }
+
+        The 'required_data' list should contain dicts of required data (or
+        dependency managers that act like dicts and know how to collect the data).
+        Only when all items in the 'required_data' list are populated are the list
+        of 'data_ready' and 'start' callbacks executed.  See `is_ready()` for more
+        information.
+
+        The 'provided_data' list should contain relation data providers, most likely
+        a subclass of :class:`charmhelpers.core.services.helpers.RelationContext`,
+        that will indicate a set of data to set on a given relation.
+
+        The 'data_ready' value should be either a single callback, or a list of
+        callbacks, to be called when all items in 'required_data' pass `is_ready()`.
+        Each callback will be called with the service name as the only parameter.
+        After all of the 'data_ready' callbacks are called, the 'start' callbacks
+        are fired.
+
+        The 'data_lost' value should be either a single callback, or a list of
+        callbacks, to be called when a 'required_data' item no longer passes
+        `is_ready()`.  Each callback will be called with the service name as the
+        only parameter.  After all of the 'data_lost' callbacks are called,
+        the 'stop' callbacks are fired.
+
+        The 'start' value should be either a single callback, or a list of
+        callbacks, to be called when starting the service, after the 'data_ready'
+        callbacks are complete.  Each callback will be called with the service
+        name as the only parameter.  This defaults to
+        `[host.service_start, services.open_ports]`.
+
+        The 'stop' value should be either a single callback, or a list of
+        callbacks, to be called when stopping the service.  If the service is
+        being stopped because it no longer has all of its 'required_data', this
+        will be called after all of the 'data_lost' callbacks are complete.
+        Each callback will be called with the service name as the only parameter.
+        This defaults to `[services.close_ports, host.service_stop]`.
+
+        The 'ports' value should be a list of ports to manage.  The default
+        'start' handler will open the ports after the service is started,
+        and the default 'stop' handler will close the ports prior to stopping
+        the service.
+
+
+        Examples:
+
+        The following registers an Upstart service called bingod that depends on
+        a mongodb relation and which runs a custom `db_migrate` function prior to
+        restarting the service, and a Runit service called spadesd::
+
+            manager = services.ServiceManager([
+                {
+                    'service': 'bingod',
+                    'ports': [80, 443],
+                    'required_data': [MongoRelation(), config(), {'my': 'data'}],
+                    'data_ready': [
+                        services.template(source='bingod.conf'),
+                        services.template(source='bingod.ini',
+                                          target='/etc/bingod.ini',
+                                          owner='bingo', perms=0400),
+                    ],
+                },
+                {
+                    'service': 'spadesd',
+                    'data_ready': services.template(source='spadesd_run.j2',
+                                                    target='/etc/sv/spadesd/run',
+                                                    perms=0555),
+                    'start': runit_start,
+                    'stop': runit_stop,
+                },
+            ])
+            manager.manage()
+        """
+        self._ready_file = os.path.join(hookenv.charm_dir(), 'READY-SERVICES.json')
+        self._ready = None
+        self.services = OrderedDict()
+        for service in services or []:
+            service_name = service['service']
+            self.services[service_name] = service
+
+    def manage(self):
+        """
+        Handle the current hook by doing The Right Thing with the registered services.
+        """
+        hookenv._run_atstart()
+        try:
+            hook_name = hookenv.hook_name()
+            if hook_name == 'stop':
+                self.stop_services()
+            else:
+                self.reconfigure_services()
+                self.provide_data()
+        except SystemExit as x:
+            if x.code is None or x.code == 0:
+                hookenv._run_atexit()
+        hookenv._run_atexit()
+
+    def provide_data(self):
+        """
+        Set the relation data for each provider in the ``provided_data`` list.
+
+        A provider must have a `name` attribute, which indicates which relation
+        to set data on, and a `provide_data()` method, which returns a dict of
+        data to set.
+
+        The `provide_data()` method can optionally accept two parameters:
+
+          * ``remote_service`` The name of the remote service that the data will
+            be provided to.  The `provide_data()` method will be called once
+            for each connected service (not unit).  This allows the method to
+            tailor its data to the given service.
+          * ``service_ready`` Whether or not the service definition had all of
+            its requirements met, and thus the ``data_ready`` callbacks run.
+
+        Note that the ``provided_data`` methods are now called **after** the
+        ``data_ready`` callbacks are run.  This gives the ``data_ready`` callbacks
+        a chance to generate any data necessary for the providing to the remote
+        services.
+        """
+        for service_name, service in self.services.items():
+            service_ready = self.is_ready(service_name)
+            for provider in service.get('provided_data', []):
+                for relid in hookenv.relation_ids(provider.name):
+                    units = hookenv.related_units(relid)
+                    if not units:
+                        continue
+                    remote_service = units[0].split('/')[0]
+                    argspec = getargspec(provider.provide_data)
+                    if len(argspec.args) > 1:
+                        data = provider.provide_data(remote_service, service_ready)
+                    else:
+                        data = provider.provide_data()
+                    if data:
+                        hookenv.relation_set(relid, data)
+
+    def reconfigure_services(self, *service_names):
+        """
+        Update all files for one or more registered services, and,
+        if ready, optionally restart them.
+
+        If no service names are given, reconfigures all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            if self.is_ready(service_name):
+                self.fire_event('data_ready', service_name)
+                self.fire_event('start', service_name, default=[
+                    service_restart,
+                    manage_ports])
+                self.save_ready(service_name)
+            else:
+                if self.was_ready(service_name):
+                    self.fire_event('data_lost', service_name)
+                self.fire_event('stop', service_name, default=[
+                    manage_ports,
+                    service_stop])
+                self.save_lost(service_name)
+
+    def stop_services(self, *service_names):
+        """
+        Stop one or more registered services, by name.
+
+        If no service names are given, stops all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            self.fire_event('stop', service_name, default=[
+                manage_ports,
+                service_stop])
+
+    def get_service(self, service_name):
+        """
+        Given the name of a registered service, return its service definition.
+        """
+        service = self.services.get(service_name)
+        if not service:
+            raise KeyError('Service not registered: %s' % service_name)
+        return service
+
+    def fire_event(self, event_name, service_name, default=None):
+        """
+        Fire a data_ready, data_lost, start, or stop event on a given service.
+        """
+        service = self.get_service(service_name)
+        callbacks = service.get(event_name, default)
+        if not callbacks:
+            return
+        if not isinstance(callbacks, Iterable):
+            callbacks = [callbacks]
+        for callback in callbacks:
+            if isinstance(callback, ManagerCallback):
+                callback(self, service_name, event_name)
+            else:
+                callback(service_name)
+
+    def is_ready(self, service_name):
+        """
+        Determine if a registered service is ready, by checking its 'required_data'.
+
+        A 'required_data' item can be any mapping type, and is considered ready
+        if `bool(item)` evaluates as True.
+        """
+        service = self.get_service(service_name)
+        reqs = service.get('required_data', [])
+        return all(bool(req) for req in reqs)
+
+    def _load_ready_file(self):
+        if self._ready is not None:
+            return
+        if os.path.exists(self._ready_file):
+            with open(self._ready_file) as fp:
+                self._ready = set(json.load(fp))
+        else:
+            self._ready = set()
+
+    def _save_ready_file(self):
+        if self._ready is None:
+            return
+        with open(self._ready_file, 'w') as fp:
+            json.dump(list(self._ready), fp)
+
+    def save_ready(self, service_name):
+        """
+        Save an indicator that the given service is now data_ready.
+        """
+        self._load_ready_file()
+        self._ready.add(service_name)
+        self._save_ready_file()
+
+    def save_lost(self, service_name):
+        """
+        Save an indicator that the given service is no longer data_ready.
+        """
+        self._load_ready_file()
+        self._ready.discard(service_name)
+        self._save_ready_file()
+
+    def was_ready(self, service_name):
+        """
+        Determine if the given service was previously data_ready.
+        """
+        self._load_ready_file()
+        return service_name in self._ready
+
+
+class ManagerCallback(object):
+    """
+    Special case of a callback that takes the `ServiceManager` instance
+    in addition to the service name.
+
+    Subclasses should implement `__call__` which should accept three parameters:
+
+        * `manager`       The `ServiceManager` instance
+        * `service_name`  The name of the service it's being triggered for
+        * `event_name`    The name of the event that this callback is handling
+    """
+    def __call__(self, manager, service_name, event_name):
+        raise NotImplementedError()
+
+
+class PortManagerCallback(ManagerCallback):
+    """
+    Callback class that will open or close ports, for use as either
+    a start or stop action.
+    """
+    def __call__(self, manager, service_name, event_name):
+        service = manager.get_service(service_name)
+        # turn this generator into a list,
+        # as we'll be going over it multiple times
+        new_ports = list(service.get('ports', []))
+        port_file = os.path.join(hookenv.charm_dir(), '.{}.ports'.format(service_name))
+        if os.path.exists(port_file):
+            with open(port_file) as fp:
+                old_ports = fp.read().split(',')
+            for old_port in old_ports:
+                if bool(old_port) and not self.ports_contains(old_port, new_ports):
+                    hookenv.close_port(old_port)
+        with open(port_file, 'w') as fp:
+            fp.write(','.join(str(port) for port in new_ports))
+        for port in new_ports:
+            # A port is either a number or 'ICMP'
+            protocol = 'TCP'
+            if str(port).upper() == 'ICMP':
+                protocol = 'ICMP'
+            if event_name == 'start':
+                hookenv.open_port(port, protocol)
+            elif event_name == 'stop':
+                hookenv.close_port(port, protocol)
+
+    def ports_contains(self, port, ports):
+        if not bool(port):
+            return False
+        if str(port).upper() != 'ICMP':
+            port = int(port)
+        return port in ports
+
+
+def service_stop(service_name):
+    """
+    Wrapper around host.service_stop to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_running(service_name):
+        host.service_stop(service_name)
+
+
+def service_restart(service_name):
+    """
+    Wrapper around host.service_restart to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_available(service_name):
+        if host.service_running(service_name):
+            host.service_restart(service_name)
+        else:
+            host.service_start(service_name)
+
+
+# Convenience aliases
+open_ports = close_ports = manage_ports = PortManagerCallback()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e6e30d2fe0d9c73ffdc42d70b77e864b6379c53
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/services/helpers.py
@@ -0,0 +1,290 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import yaml
+
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+from charmhelpers.core import templating
+
+from charmhelpers.core.services.base import ManagerCallback
+
+
+__all__ = ['RelationContext', 'TemplateCallback',
+           'render_template', 'template']
+
+
+class RelationContext(dict):
+    """
+    Base class for a context generator that gets relation data from juju.
+
+    Subclasses must provide the attributes `name`, which is the name of the
+    interface of interest, `interface`, which is the type of the interface of
+    interest, and `required_keys`, which is the set of keys required for the
+    relation to be considered complete.  The data for all interfaces matching
+    the `name` attribute that are complete will used to populate the dictionary
+    values (see `get_data`, below).
+
+    The generated context will be namespaced under the relation :attr:`name`,
+    to prevent potential naming conflicts.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = None
+    interface = None
+
+    def __init__(self, name=None, additional_required_keys=None):
+        if not hasattr(self, 'required_keys'):
+            self.required_keys = []
+
+        if name is not None:
+            self.name = name
+        if additional_required_keys:
+            self.required_keys.extend(additional_required_keys)
+        self.get_data()
+
+    def __bool__(self):
+        """
+        Returns True if all of the required_keys are available.
+        """
+        return self.is_ready()
+
+    __nonzero__ = __bool__
+
+    def __repr__(self):
+        return super(RelationContext, self).__repr__()
+
+    def is_ready(self):
+        """
+        Returns True if all of the `required_keys` are available from any units.
+        """
+        ready = len(self.get(self.name, [])) > 0
+        if not ready:
+            hookenv.log('Incomplete relation: {}'.format(self.__class__.__name__), hookenv.DEBUG)
+        return ready
+
+    def _is_ready(self, unit_data):
+        """
+        Helper method that tests a set of relation data and returns True if
+        all of the `required_keys` are present.
+        """
+        return set(unit_data.keys()).issuperset(set(self.required_keys))
+
+    def get_data(self):
+        """
+        Retrieve the relation data for each unit involved in a relation and,
+        if complete, store it in a list under `self[self.name]`.  This
+        is automatically called when the RelationContext is instantiated.
+
+        The units are sorted lexographically first by the service ID, then by
+        the unit ID.  Thus, if an interface has two other services, 'db:1'
+        and 'db:2', with 'db:1' having two units, 'wordpress/0' and 'wordpress/1',
+        and 'db:2' having one unit, 'mediawiki/0', all of which have a complete
+        set of data, the relation data for the units will be stored in the
+        order: 'wordpress/0', 'wordpress/1', 'mediawiki/0'.
+
+        If you only care about a single unit on the relation, you can just
+        access it as `{{ interface[0]['key'] }}`.  However, if you can at all
+        support multiple units on a relation, you should iterate over the list,
+        like::
+
+            {% for unit in interface -%}
+                {{ unit['key'] }}{% if not loop.last %},{% endif %}
+            {%- endfor %}
+
+        Note that since all sets of relation data from all related services and
+        units are in a single list, if you need to know which service or unit a
+        set of data came from, you'll need to extend this class to preserve
+        that information.
+        """
+        if not hookenv.relation_ids(self.name):
+            return
+
+        ns = self.setdefault(self.name, [])
+        for rid in sorted(hookenv.relation_ids(self.name)):
+            for unit in sorted(hookenv.related_units(rid)):
+                reldata = hookenv.relation_get(rid=rid, unit=unit)
+                if self._is_ready(reldata):
+                    ns.append(reldata)
+
+    def provide_data(self):
+        """
+        Return data to be relation_set for this interface.
+        """
+        return {}
+
+
+class MysqlRelation(RelationContext):
+    """
+    Relation context for the `mysql` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'db'
+    interface = 'mysql'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'user', 'password', 'database']
+        RelationContext.__init__(self, *args, **kwargs)
+
+
+class HttpRelation(RelationContext):
+    """
+    Relation context for the `http` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'website'
+    interface = 'http'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'port']
+        RelationContext.__init__(self, *args, **kwargs)
+
+    def provide_data(self):
+        return {
+            'host': hookenv.unit_get('private-address'),
+            'port': 80,
+        }
+
+
+class RequiredConfig(dict):
+    """
+    Data context that loads config options with one or more mandatory options.
+
+    Once the required options have been changed from their default values, all
+    config options will be available, namespaced under `config` to prevent
+    potential naming conflicts (for example, between a config option and a
+    relation property).
+
+    :param list *args: List of options that must be changed from their default values.
+    """
+
+    def __init__(self, *args):
+        self.required_options = args
+        self['config'] = hookenv.config()
+        with open(os.path.join(hookenv.charm_dir(), 'config.yaml')) as fp:
+            self.config = yaml.load(fp).get('options', {})
+
+    def __bool__(self):
+        for option in self.required_options:
+            if option not in self['config']:
+                return False
+            current_value = self['config'][option]
+            default_value = self.config[option].get('default')
+            if current_value == default_value:
+                return False
+            if current_value in (None, '') and default_value in (None, ''):
+                return False
+        return True
+
+    def __nonzero__(self):
+        return self.__bool__()
+
+
+class StoredContext(dict):
+    """
+    A data context that always returns the data that it was first created with.
+
+    This is useful to do a one-time generation of things like passwords, that
+    will thereafter use the same value that was originally generated, instead
+    of generating a new value each time it is run.
+    """
+    def __init__(self, file_name, config_data):
+        """
+        If the file exists, populate `self` with the data from the file.
+        Otherwise, populate with the given data and persist it to the file.
+        """
+        if os.path.exists(file_name):
+            self.update(self.read_context(file_name))
+        else:
+            self.store_context(file_name, config_data)
+            self.update(config_data)
+
+    def store_context(self, file_name, config_data):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'w') as file_stream:
+            os.fchmod(file_stream.fileno(), 0o600)
+            yaml.dump(config_data, file_stream)
+
+    def read_context(self, file_name):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'r') as file_stream:
+            data = yaml.load(file_stream)
+            if not data:
+                raise OSError("%s is empty" % file_name)
+            return data
+
+
+class TemplateCallback(ManagerCallback):
+    """
+    Callback class that will render a Jinja2 template, for use as a ready
+    action.
+
+    :param str source: The template source file, relative to
+        `$CHARM_DIR/templates`
+
+    :param str target: The target to write the rendered template to (or None)
+    :param str owner: The owner of the rendered file
+    :param str group: The group of the rendered file
+    :param int perms: The permissions of the rendered file
+    :param partial on_change_action: functools partial to be executed when
+                                     rendered file changes
+    :param jinja2 loader template_loader: A jinja2 template loader
+
+    :return str: The rendered template
+    """
+    def __init__(self, source, target,
+                 owner='root', group='root', perms=0o444,
+                 on_change_action=None, template_loader=None):
+        self.source = source
+        self.target = target
+        self.owner = owner
+        self.group = group
+        self.perms = perms
+        self.on_change_action = on_change_action
+        self.template_loader = template_loader
+
+    def __call__(self, manager, service_name, event_name):
+        pre_checksum = ''
+        if self.on_change_action and os.path.isfile(self.target):
+            pre_checksum = host.file_hash(self.target)
+        service = manager.get_service(service_name)
+        context = {'ctx': {}}
+        for ctx in service.get('required_data', []):
+            context.update(ctx)
+            context['ctx'].update(ctx)
+
+        result = templating.render(self.source, self.target, context,
+                                   self.owner, self.group, self.perms,
+                                   template_loader=self.template_loader)
+        if self.on_change_action:
+            if pre_checksum == host.file_hash(self.target):
+                hookenv.log(
+                    'No change detected: {}'.format(self.target),
+                    hookenv.DEBUG)
+            else:
+                self.on_change_action()
+
+        return result
+
+
+# Convenience aliases for templates
+render_template = template = TemplateCallback
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/strutils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/strutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8df0452f8203b53947eb137eed22d85ff62dff0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/strutils.py
@@ -0,0 +1,129 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import re
+
+
+def bool_from_string(value):
+    """Interpret string value as boolean.
+
+    Returns True if value translates to True otherwise False.
+    """
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as boolean" % (value)
+        raise ValueError(msg)
+
+    value = value.strip().lower()
+
+    if value in ['y', 'yes', 'true', 't', 'on']:
+        return True
+    elif value in ['n', 'no', 'false', 'f', 'off']:
+        return False
+
+    msg = "Unable to interpret string value '%s' as boolean" % (value)
+    raise ValueError(msg)
+
+
+def bytes_from_string(value):
+    """Interpret human readable string value as bytes.
+
+    Returns int
+    """
+    BYTE_POWER = {
+        'K': 1,
+        'KB': 1,
+        'M': 2,
+        'MB': 2,
+        'G': 3,
+        'GB': 3,
+        'T': 4,
+        'TB': 4,
+        'P': 5,
+        'PB': 5,
+    }
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as bytes" % (value)
+        raise ValueError(msg)
+    matches = re.match("([0-9]+)([a-zA-Z]+)", value)
+    if matches:
+        size = int(matches.group(1)) * (1024 ** BYTE_POWER[matches.group(2)])
+    else:
+        # Assume that value passed in is bytes
+        try:
+            size = int(value)
+        except ValueError:
+            msg = "Unable to interpret string value '%s' as bytes" % (value)
+            raise ValueError(msg)
+    return size
+
+
+class BasicStringComparator(object):
+    """Provides a class that will compare strings from an iterator type object.
+    Used to provide > and < comparisons on strings that may not necessarily be
+    alphanumerically ordered.  e.g. OpenStack or Ubuntu releases AFTER the
+    z-wrap.
+    """
+
+    _list = None
+
+    def __init__(self, item):
+        if self._list is None:
+            raise Exception("Must define the _list in the class definition!")
+        try:
+            self.index = self._list.index(item)
+        except Exception:
+            raise KeyError("Item '{}' is not in list '{}'"
+                           .format(item, self._list))
+
+    def __eq__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index == self._list.index(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index < self._list.index(other)
+
+    def __ge__(self, other):
+        return not self.__lt__(other)
+
+    def __gt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index > self._list.index(other)
+
+    def __le__(self, other):
+        return not self.__gt__(other)
+
+    def __str__(self):
+        """Always give back the item at the index so it can be used in
+        comparisons like:
+
+        s_mitaka = CompareOpenStack('mitaka')
+        s_newton = CompareOpenstack('newton')
+
+        assert s_newton > s_mitaka
+
+        @returns: <string>
+        """
+        return self._list[self.index]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..386428d619bc38edf02dc088bf7ec32767c0ab94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/sysctl.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+
+from subprocess import check_call, CalledProcessError
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+    WARNING,
+)
+
+from charmhelpers.core.host import is_container
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+def create(sysctl_dict, sysctl_file, ignore=False):
+    """Creates a sysctl.conf file from a YAML associative array
+
+    :param sysctl_dict: a dict or YAML-formatted string of sysctl
+                        options eg "{ 'kernel.max_pid': 1337 }"
+    :type sysctl_dict: str
+    :param sysctl_file: path to the sysctl file to be saved
+    :type sysctl_file: str or unicode
+    :param ignore: If True, ignore "unknown variable" errors.
+    :type ignore: bool
+    :returns: None
+    """
+    if type(sysctl_dict) is not dict:
+        try:
+            sysctl_dict_parsed = yaml.safe_load(sysctl_dict)
+        except yaml.YAMLError:
+            log("Error parsing YAML sysctl_dict: {}".format(sysctl_dict),
+                level=ERROR)
+            return
+    else:
+        sysctl_dict_parsed = sysctl_dict
+
+    with open(sysctl_file, "w") as fd:
+        for key, value in sysctl_dict_parsed.items():
+            fd.write("{}={}\n".format(key, value))
+
+    log("Updating sysctl_file: {} values: {}".format(sysctl_file,
+                                                     sysctl_dict_parsed),
+        level=DEBUG)
+
+    call = ["sysctl", "-p", sysctl_file]
+    if ignore:
+        call.append("-e")
+
+    try:
+        check_call(call)
+    except CalledProcessError as e:
+        if is_container():
+            log("Error setting some sysctl keys in this container: {}".format(e.output),
+                level=WARNING)
+        else:
+            raise e
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..9014015c14ee0b48c775562cd4f0d30884944439
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/templating.py
@@ -0,0 +1,93 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+def render(source, target, context, owner='root', group='root',
+           perms=0o444, templates_dir=None, encoding='UTF-8',
+           template_loader=None, config_template=None):
+    """
+    Render a template.
+
+    The `source` path, if not absolute, is relative to the `templates_dir`.
+
+    The `target` path should be absolute.  It can also be `None`, in which
+    case no file will be written.
+
+    The context should be a dict containing the values to be replaced in the
+    template.
+
+    config_template may be provided to render from a provided template instead
+    of loading from a file.
+
+    The `owner`, `group`, and `perms` options will be passed to `write_file`.
+
+    If omitted, `templates_dir` defaults to the `templates` folder in the charm.
+
+    The rendered template will be written to the file as well as being returned
+    as a string.
+
+    Note: Using this requires python-jinja2 or python3-jinja2; if it is not
+    installed, calling this will attempt to use charmhelpers.fetch.apt_install
+    to install it.
+    """
+    try:
+        from jinja2 import FileSystemLoader, Environment, exceptions
+    except ImportError:
+        try:
+            from charmhelpers.fetch import apt_install
+        except ImportError:
+            hookenv.log('Could not import jinja2, and could not import '
+                        'charmhelpers.fetch to install it',
+                        level=hookenv.ERROR)
+            raise
+        if sys.version_info.major == 2:
+            apt_install('python-jinja2', fatal=True)
+        else:
+            apt_install('python3-jinja2', fatal=True)
+        from jinja2 import FileSystemLoader, Environment, exceptions
+
+    if template_loader:
+        template_env = Environment(loader=template_loader)
+    else:
+        if templates_dir is None:
+            templates_dir = os.path.join(hookenv.charm_dir(), 'templates')
+        template_env = Environment(loader=FileSystemLoader(templates_dir))
+
+    # load from a string if provided explicitly
+    if config_template is not None:
+        template = template_env.from_string(config_template)
+    else:
+        try:
+            source = source
+            template = template_env.get_template(source)
+        except exceptions.TemplateNotFound as e:
+            hookenv.log('Could not load template %s from %s.' %
+                        (source, templates_dir),
+                        level=hookenv.ERROR)
+            raise e
+    content = template.render(context)
+    if target is not None:
+        target_dir = os.path.dirname(target)
+        if not os.path.exists(target_dir):
+            # This is a terrible default directory permission, as the file
+            # or its siblings will often contain secrets.
+            host.mkdir(os.path.dirname(target), owner, group, perms=0o755)
+        host.write_file(target, content.encode(encoding), owner, group, perms)
+    return content
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab554327b343f896880523fc627c1abea84be29a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/core/unitdata.py
@@ -0,0 +1,525 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Authors:
+#  Kapil Thangavelu <kapil.foss@gmail.com>
+#
+"""
+Intro
+-----
+
+A simple way to store state in units. This provides a key value
+storage with support for versioned, transactional operation,
+and can calculate deltas from previous values to simplify unit logic
+when processing changes.
+
+
+Hook Integration
+----------------
+
+There are several extant frameworks for hook execution, including
+
+ - charmhelpers.core.hookenv.Hooks
+ - charmhelpers.core.services.ServiceManager
+
+The storage classes are framework agnostic, one simple integration is
+via the HookData contextmanager. It will record the current hook
+execution environment (including relation data, config data, etc.),
+setup a transaction and allow easy access to the changes from
+previously seen values. One consequence of the integration is the
+reservation of particular keys ('rels', 'unit', 'env', 'config',
+'charm_revisions') for their respective values.
+
+Here's a fully worked integration example using hookenv.Hooks::
+
+       from charmhelper.core import hookenv, unitdata
+
+       hook_data = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # Print all changes to configuration from previously seen
+           # values.
+           for changed, (prev, cur) in hook_data.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+           # Directly access all charm config as a mapping.
+           conf = db.getrange('config', True)
+
+           # Directly access all relation data as a mapping
+           rels = db.getrange('rels', True)
+
+       if __name__ == '__main__':
+           with hook_data():
+               hook.execute()
+
+
+A more basic integration is via the hook_scope context manager which simply
+manages transaction scope (and records hook name, and timestamp)::
+
+  >>> from unitdata import kv
+  >>> db = kv()
+  >>> with db.hook_scope('install'):
+  ...    # do work, in transactional scope.
+  ...    db.set('x', 1)
+  >>> db.get('x')
+  1
+
+
+Usage
+-----
+
+Values are automatically json de/serialized to preserve basic typing
+and complex data struct capabilities (dicts, lists, ints, booleans, etc).
+
+Individual values can be manipulated via get/set::
+
+   >>> kv.set('y', True)
+   >>> kv.get('y')
+   True
+
+   # We can set complex values (dicts, lists) as a single key.
+   >>> kv.set('config', {'a': 1, 'b': True'})
+
+   # Also supports returning dictionaries as a record which
+   # provides attribute access.
+   >>> config = kv.get('config', record=True)
+   >>> config.b
+   True
+
+
+Groups of keys can be manipulated with update/getrange::
+
+   >>> kv.update({'z': 1, 'y': 2}, prefix="gui.")
+   >>> kv.getrange('gui.', strip=True)
+   {'z': 1, 'y': 2}
+
+When updating values, its very helpful to understand which values
+have actually changed and how have they changed. The storage
+provides a delta method to provide for this::
+
+   >>> data = {'debug': True, 'option': 2}
+   >>> delta = kv.delta(data, 'config.')
+   >>> delta.debug.previous
+   None
+   >>> delta.debug.current
+   True
+   >>> delta
+   {'debug': (None, True), 'option': (None, 2)}
+
+Note the delta method does not persist the actual change, it needs to
+be explicitly saved via 'update' method::
+
+   >>> kv.update(data, 'config.')
+
+Values modified in the context of a hook scope retain historical values
+associated to the hookname.
+
+   >>> with db.hook_scope('config-changed'):
+   ...      db.set('x', 42)
+   >>> db.gethistory('x')
+   [(1, u'x', 1, u'install', u'2015-01-21T16:49:30.038372'),
+    (2, u'x', 42, u'config-changed', u'2015-01-21T16:49:30.038786')]
+
+"""
+
+import collections
+import contextlib
+import datetime
+import itertools
+import json
+import os
+import pprint
+import sqlite3
+import sys
+
+__author__ = 'Kapil Thangavelu <kapil.foss@gmail.com>'
+
+
+class Storage(object):
+    """Simple key value database for local unit state within charms.
+
+    Modifications are not persisted unless :meth:`flush` is called.
+
+    To support dicts, lists, integer, floats, and booleans values
+    are automatically json encoded/decoded.
+
+    Note: to facilitate unit testing, ':memory:' can be passed as the
+    path parameter which causes sqlite3 to only build the db in memory.
+    This should only be used for testing purposes.
+    """
+    def __init__(self, path=None):
+        self.db_path = path
+        if path is None:
+            if 'UNIT_STATE_DB' in os.environ:
+                self.db_path = os.environ['UNIT_STATE_DB']
+            else:
+                self.db_path = os.path.join(
+                    os.environ.get('CHARM_DIR', ''), '.unit-state.db')
+        if self.db_path != ':memory:':
+            with open(self.db_path, 'a') as f:
+                os.fchmod(f.fileno(), 0o600)
+        self.conn = sqlite3.connect('%s' % self.db_path)
+        self.cursor = self.conn.cursor()
+        self.revision = None
+        self._closed = False
+        self._init()
+
+    def close(self):
+        if self._closed:
+            return
+        self.flush(False)
+        self.cursor.close()
+        self.conn.close()
+        self._closed = True
+
+    def get(self, key, default=None, record=False):
+        self.cursor.execute('select data from kv where key=?', [key])
+        result = self.cursor.fetchone()
+        if not result:
+            return default
+        if record:
+            return Record(json.loads(result[0]))
+        return json.loads(result[0])
+
+    def getrange(self, key_prefix, strip=False):
+        """
+        Get a range of keys starting with a common prefix as a mapping of
+        keys to values.
+
+        :param str key_prefix: Common prefix among all keys
+        :param bool strip: Optionally strip the common prefix from the key
+            names in the returned dict
+        :return dict: A (possibly empty) dict of key-value mappings
+        """
+        self.cursor.execute("select key, data from kv where key like ?",
+                            ['%s%%' % key_prefix])
+        result = self.cursor.fetchall()
+
+        if not result:
+            return {}
+        if not strip:
+            key_prefix = ''
+        return dict([
+            (k[len(key_prefix):], json.loads(v)) for k, v in result])
+
+    def update(self, mapping, prefix=""):
+        """
+        Set the values of multiple keys at once.
+
+        :param dict mapping: Mapping of keys to values
+        :param str prefix: Optional prefix to apply to all keys in `mapping`
+            before setting
+        """
+        for k, v in mapping.items():
+            self.set("%s%s" % (prefix, k), v)
+
+    def unset(self, key):
+        """
+        Remove a key from the database entirely.
+        """
+        self.cursor.execute('delete from kv where key=?', [key])
+        if self.revision and self.cursor.rowcount:
+            self.cursor.execute(
+                'insert into kv_revisions values (?, ?, ?)',
+                [key, self.revision, json.dumps('DELETED')])
+
+    def unsetrange(self, keys=None, prefix=""):
+        """
+        Remove a range of keys starting with a common prefix, from the database
+        entirely.
+
+        :param list keys: List of keys to remove.
+        :param str prefix: Optional prefix to apply to all keys in ``keys``
+            before removing.
+        """
+        if keys is not None:
+            keys = ['%s%s' % (prefix, key) for key in keys]
+            self.cursor.execute('delete from kv where key in (%s)' % ','.join(['?'] * len(keys)), keys)
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values %s' % ','.join(['(?, ?, ?)'] * len(keys)),
+                    list(itertools.chain.from_iterable((key, self.revision, json.dumps('DELETED')) for key in keys)))
+        else:
+            self.cursor.execute('delete from kv where key like ?',
+                                ['%s%%' % prefix])
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values (?, ?, ?)',
+                    ['%s%%' % prefix, self.revision, json.dumps('DELETED')])
+
+    def set(self, key, value):
+        """
+        Set a value in the database.
+
+        :param str key: Key to set the value for
+        :param value: Any JSON-serializable value to be set
+        """
+        serialized = json.dumps(value)
+
+        self.cursor.execute('select data from kv where key=?', [key])
+        exists = self.cursor.fetchone()
+
+        # Skip mutations to the same value
+        if exists:
+            if exists[0] == serialized:
+                return value
+
+        if not exists:
+            self.cursor.execute(
+                'insert into kv (key, data) values (?, ?)',
+                (key, serialized))
+        else:
+            self.cursor.execute('''
+            update kv
+            set data = ?
+            where key = ?''', [serialized, key])
+
+        # Save
+        if not self.revision:
+            return value
+
+        self.cursor.execute(
+            'select 1 from kv_revisions where key=? and revision=?',
+            [key, self.revision])
+        exists = self.cursor.fetchone()
+
+        if not exists:
+            self.cursor.execute(
+                '''insert into kv_revisions (
+                revision, key, data) values (?, ?, ?)''',
+                (self.revision, key, serialized))
+        else:
+            self.cursor.execute(
+                '''
+                update kv_revisions
+                set data = ?
+                where key = ?
+                and   revision = ?''',
+                [serialized, key, self.revision])
+
+        return value
+
+    def delta(self, mapping, prefix):
+        """
+        return a delta containing values that have changed.
+        """
+        previous = self.getrange(prefix, strip=True)
+        if not previous:
+            pk = set()
+        else:
+            pk = set(previous.keys())
+        ck = set(mapping.keys())
+        delta = DeltaSet()
+
+        # added
+        for k in ck.difference(pk):
+            delta[k] = Delta(None, mapping[k])
+
+        # removed
+        for k in pk.difference(ck):
+            delta[k] = Delta(previous[k], None)
+
+        # changed
+        for k in pk.intersection(ck):
+            c = mapping[k]
+            p = previous[k]
+            if c != p:
+                delta[k] = Delta(p, c)
+
+        return delta
+
+    @contextlib.contextmanager
+    def hook_scope(self, name=""):
+        """Scope all future interactions to the current hook execution
+        revision."""
+        assert not self.revision
+        self.cursor.execute(
+            'insert into hooks (hook, date) values (?, ?)',
+            (name or sys.argv[0],
+             datetime.datetime.utcnow().isoformat()))
+        self.revision = self.cursor.lastrowid
+        try:
+            yield self.revision
+            self.revision = None
+        except Exception:
+            self.flush(False)
+            self.revision = None
+            raise
+        else:
+            self.flush()
+
+    def flush(self, save=True):
+        if save:
+            self.conn.commit()
+        elif self._closed:
+            return
+        else:
+            self.conn.rollback()
+
+    def _init(self):
+        self.cursor.execute('''
+            create table if not exists kv (
+               key text,
+               data text,
+               primary key (key)
+               )''')
+        self.cursor.execute('''
+            create table if not exists kv_revisions (
+               key text,
+               revision integer,
+               data text,
+               primary key (key, revision)
+               )''')
+        self.cursor.execute('''
+            create table if not exists hooks (
+               version integer primary key autoincrement,
+               hook text,
+               date text
+               )''')
+        self.conn.commit()
+
+    def gethistory(self, key, deserialize=False):
+        self.cursor.execute(
+            '''
+            select kv.revision, kv.key, kv.data, h.hook, h.date
+            from kv_revisions kv,
+                 hooks h
+            where kv.key=?
+             and kv.revision = h.version
+            ''', [key])
+        if deserialize is False:
+            return self.cursor.fetchall()
+        return map(_parse_history, self.cursor.fetchall())
+
+    def debug(self, fh=sys.stderr):
+        self.cursor.execute('select * from kv')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+        self.cursor.execute('select * from kv_revisions')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+
+
+def _parse_history(d):
+    return (d[0], d[1], json.loads(d[2]), d[3],
+            datetime.datetime.strptime(d[-1], "%Y-%m-%dT%H:%M:%S.%f"))
+
+
+class HookData(object):
+    """Simple integration for existing hook exec frameworks.
+
+    Records all unit information, and stores deltas for processing
+    by the hook.
+
+    Sample::
+
+       from charmhelper.core import hookenv, unitdata
+
+       changes = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # View all changes to configuration
+           for changed, (prev, cur) in changes.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+       if __name__ == '__main__':
+           with changes():
+               hook.execute()
+
+    """
+    def __init__(self):
+        self.kv = kv()
+        self.conf = None
+        self.rels = None
+
+    @contextlib.contextmanager
+    def __call__(self):
+        from charmhelpers.core import hookenv
+        hook_name = hookenv.hook_name()
+
+        with self.kv.hook_scope(hook_name):
+            self._record_charm_version(hookenv.charm_dir())
+            delta_config, delta_relation = self._record_hook(hookenv)
+            yield self.kv, delta_config, delta_relation
+
+    def _record_charm_version(self, charm_dir):
+        # Record revisions.. charm revisions are meaningless
+        # to charm authors as they don't control the revision.
+        # so logic dependnent on revision is not particularly
+        # useful, however it is useful for debugging analysis.
+        charm_rev = open(
+            os.path.join(charm_dir, 'revision')).read().strip()
+        charm_rev = charm_rev or '0'
+        revs = self.kv.get('charm_revisions', [])
+        if charm_rev not in revs:
+            revs.append(charm_rev.strip() or '0')
+            self.kv.set('charm_revisions', revs)
+
+    def _record_hook(self, hookenv):
+        data = hookenv.execution_environment()
+        self.conf = conf_delta = self.kv.delta(data['conf'], 'config')
+        self.rels = rels_delta = self.kv.delta(data['rels'], 'rels')
+        self.kv.set('env', dict(data['env']))
+        self.kv.set('unit', data['unit'])
+        self.kv.set('relid', data.get('relid'))
+        return conf_delta, rels_delta
+
+
+class Record(dict):
+
+    __slots__ = ()
+
+    def __getattr__(self, k):
+        if k in self:
+            return self[k]
+        raise AttributeError(k)
+
+
+class DeltaSet(Record):
+
+    __slots__ = ()
+
+
+Delta = collections.namedtuple('Delta', ['previous', 'current'])
+
+
+_KV = None
+
+
+def kv():
+    global _KV
+    if _KV is None:
+        _KV = Storage()
+    return _KV
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cc7fc850a0632568ad78aae9716be718c9ff6b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/__init__.py
@@ -0,0 +1,209 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib
+from charmhelpers.osplatform import get_platform
+from yaml import safe_load
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+)
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse, urlunparse
+else:
+    from urlparse import urlparse, urlunparse
+
+
+# The order of this list is very important. Handlers should be listed in from
+# least- to most-specific URL matching.
+FETCH_HANDLERS = (
+    'charmhelpers.fetch.archiveurl.ArchiveUrlFetchHandler',
+    'charmhelpers.fetch.bzrurl.BzrUrlFetchHandler',
+    'charmhelpers.fetch.giturl.GitUrlFetchHandler',
+)
+
+
+class SourceConfigError(Exception):
+    pass
+
+
+class UnhandledSource(Exception):
+    pass
+
+
+class AptLockError(Exception):
+    pass
+
+
+class GPGKeyError(Exception):
+    """Exception occurs when a GPG key cannot be fetched or used.  The message
+    indicates what the problem is.
+    """
+    pass
+
+
+class BaseFetchHandler(object):
+
+    """Base class for FetchHandler implementations in fetch plugins"""
+
+    def can_handle(self, source):
+        """Returns True if the source can be handled. Otherwise returns
+        a string explaining why it cannot"""
+        return "Wrong source type"
+
+    def install(self, source):
+        """Try to download and unpack the source. Return the path to the
+        unpacked files or raise UnhandledSource."""
+        raise UnhandledSource("Wrong source type {}".format(source))
+
+    def parse_url(self, url):
+        return urlparse(url)
+
+    def base_url(self, url):
+        """Return url without querystring or fragment"""
+        parts = list(self.parse_url(url))
+        parts[4:] = ['' for i in parts[4:]]
+        return urlunparse(parts)
+
+
+__platform__ = get_platform()
+module = "charmhelpers.fetch.%s" % __platform__
+fetch = importlib.import_module(module)
+
+filter_installed_packages = fetch.filter_installed_packages
+filter_missing_packages = fetch.filter_missing_packages
+install = fetch.apt_install
+upgrade = fetch.apt_upgrade
+update = _fetch_update = fetch.apt_update
+purge = fetch.apt_purge
+add_source = fetch.add_source
+
+if __platform__ == "ubuntu":
+    apt_cache = fetch.apt_cache
+    apt_install = fetch.apt_install
+    apt_update = fetch.apt_update
+    apt_upgrade = fetch.apt_upgrade
+    apt_purge = fetch.apt_purge
+    apt_autoremove = fetch.apt_autoremove
+    apt_mark = fetch.apt_mark
+    apt_hold = fetch.apt_hold
+    apt_unhold = fetch.apt_unhold
+    import_key = fetch.import_key
+    get_upstream_version = fetch.get_upstream_version
+    apt_pkg = fetch.ubuntu_apt_pkg
+    get_apt_dpkg_env = fetch.get_apt_dpkg_env
+elif __platform__ == "centos":
+    yum_search = fetch.yum_search
+
+
+def configure_sources(update=False,
+                      sources_var='install_sources',
+                      keys_var='install_keys'):
+    """Configure multiple sources from charm configuration.
+
+    The lists are encoded as yaml fragments in the configuration.
+    The fragment needs to be included as a string. Sources and their
+    corresponding keys are of the types supported by add_source().
+
+    Example config:
+        install_sources: |
+          - "ppa:foo"
+          - "http://example.com/repo precise main"
+        install_keys: |
+          - null
+          - "a1b2c3d4"
+
+    Note that 'null' (a.k.a. None) should not be quoted.
+    """
+    sources = safe_load((config(sources_var) or '').strip()) or []
+    keys = safe_load((config(keys_var) or '').strip()) or None
+
+    if isinstance(sources, six.string_types):
+        sources = [sources]
+
+    if keys is None:
+        for source in sources:
+            add_source(source, None)
+    else:
+        if isinstance(keys, six.string_types):
+            keys = [keys]
+
+        if len(sources) != len(keys):
+            raise SourceConfigError(
+                'Install sources and keys lists are different lengths')
+        for source, key in zip(sources, keys):
+            add_source(source, key)
+    if update:
+        _fetch_update(fatal=True)
+
+
+def install_remote(source, *args, **kwargs):
+    """Install a file tree from a remote source.
+
+    The specified source should be a url of the form:
+        scheme://[host]/path[#[option=value][&...]]
+
+    Schemes supported are based on this modules submodules.
+    Options supported are submodule-specific.
+    Additional arguments are passed through to the submodule.
+
+    For example::
+
+        dest = install_remote('http://example.com/archive.tgz',
+                              checksum='deadbeef',
+                              hash_type='sha1')
+
+    This will download `archive.tgz`, validate it using SHA1 and, if
+    the file is ok, extract it and return the directory in which it
+    was extracted.  If the checksum fails, it will raise
+    :class:`charmhelpers.core.host.ChecksumError`.
+    """
+    # We ONLY check for True here because can_handle may return a string
+    # explaining why it can't handle a given source.
+    handlers = [h for h in plugins() if h.can_handle(source) is True]
+    for handler in handlers:
+        try:
+            return handler.install(source, *args, **kwargs)
+        except UnhandledSource as e:
+            log('Install source attempt unsuccessful: {}'.format(e),
+                level='WARNING')
+    raise UnhandledSource("No handler found for source {}".format(source))
+
+
+def install_from_config(config_var_name):
+    """Install a file from config."""
+    charm_config = config()
+    source = charm_config[config_var_name]
+    return install_remote(source)
+
+
+def plugins(fetch_handlers=None):
+    if not fetch_handlers:
+        fetch_handlers = FETCH_HANDLERS
+    plugin_list = []
+    for handler_name in fetch_handlers:
+        package, classname = handler_name.rsplit('.', 1)
+        try:
+            handler_class = getattr(
+                importlib.import_module(package),
+                classname)
+            plugin_list.append(handler_class())
+        except NotImplementedError:
+            # Skip missing plugins so that they can be ommitted from
+            # installation if desired
+            log("FetchHandler {} not found, skipping plugin".format(
+                handler_name))
+    return plugin_list
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/archiveurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/archiveurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..d25587adeff102c3fc9e402f98746fccbd8a3693
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/archiveurl.py
@@ -0,0 +1,165 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import hashlib
+import re
+
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource
+)
+from charmhelpers.payload.archive import (
+    get_archive_handler,
+    extract,
+)
+from charmhelpers.core.host import mkdir, check_hash
+
+import six
+if six.PY3:
+    from urllib.request import (
+        build_opener, install_opener, urlopen, urlretrieve,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+    )
+    from urllib.parse import urlparse, urlunparse, parse_qs
+    from urllib.error import URLError
+else:
+    from urllib import urlretrieve
+    from urllib2 import (
+        build_opener, install_opener, urlopen,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+        URLError
+    )
+    from urlparse import urlparse, urlunparse, parse_qs
+
+
+def splituser(host):
+    '''urllib.splituser(), but six's support of this seems broken'''
+    _userprog = re.compile('^(.*)@(.*)$')
+    match = _userprog.match(host)
+    if match:
+        return match.group(1, 2)
+    return None, host
+
+
+def splitpasswd(user):
+    '''urllib.splitpasswd(), but six's support of this is missing'''
+    _passwdprog = re.compile('^([^:]*):(.*)$', re.S)
+    match = _passwdprog.match(user)
+    if match:
+        return match.group(1, 2)
+    return user, None
+
+
+class ArchiveUrlFetchHandler(BaseFetchHandler):
+    """
+    Handler to download archive files from arbitrary URLs.
+
+    Can fetch from http, https, ftp, and file URLs.
+
+    Can install either tarballs (.tar, .tgz, .tbz2, etc) or zip files.
+
+    Installs the contents of the archive in $CHARM_DIR/fetched/.
+    """
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('http', 'https', 'ftp', 'file'):
+            # XXX: Why is this returning a boolean and a string? It's
+            # doomed to fail since "bool(can_handle('foo://'))"  will be True.
+            return "Wrong source type"
+        if get_archive_handler(self.base_url(source)):
+            return True
+        return False
+
+    def download(self, source, dest):
+        """
+        Download an archive file.
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local path location to download archive file to.
+        """
+        # propagate all exceptions
+        # URLError, OSError, etc
+        proto, netloc, path, params, query, fragment = urlparse(source)
+        if proto in ('http', 'https'):
+            auth, barehost = splituser(netloc)
+            if auth is not None:
+                source = urlunparse((proto, barehost, path, params, query, fragment))
+                username, password = splitpasswd(auth)
+                passman = HTTPPasswordMgrWithDefaultRealm()
+                # Realm is set to None in add_password to force the username and password
+                # to be used whatever the realm
+                passman.add_password(None, source, username, password)
+                authhandler = HTTPBasicAuthHandler(passman)
+                opener = build_opener(authhandler)
+                install_opener(opener)
+        response = urlopen(source)
+        try:
+            with open(dest, 'wb') as dest_file:
+                dest_file.write(response.read())
+        except Exception as e:
+            if os.path.isfile(dest):
+                os.unlink(dest)
+            raise e
+
+    # Mandatory file validation via Sha1 or MD5 hashing.
+    def download_and_validate(self, url, hashsum, validate="sha1"):
+        tempfile, headers = urlretrieve(url)
+        check_hash(tempfile, hashsum, validate)
+        return tempfile
+
+    def install(self, source, dest=None, checksum=None, hash_type='sha1'):
+        """
+        Download and install an archive file, with optional checksum validation.
+
+        The checksum can also be given on the `source` URL's fragment.
+        For example::
+
+            handler.install('http://example.com/file.tgz#sha1=deadbeef')
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local destination path to install to. If not given,
+            installs to `$CHARM_DIR/archives/archive_file_name`.
+        :param str checksum: If given, validate the archive file after download.
+        :param str hash_type: Algorithm used to generate `checksum`.
+            Can be any hash alrgorithm supported by :mod:`hashlib`,
+            such as md5, sha1, sha256, sha512, etc.
+
+        """
+        url_parts = self.parse_url(source)
+        dest_dir = os.path.join(os.environ.get('CHARM_DIR'), 'fetched')
+        if not os.path.exists(dest_dir):
+            mkdir(dest_dir, perms=0o755)
+        dld_file = os.path.join(dest_dir, os.path.basename(url_parts.path))
+        try:
+            self.download(source, dld_file)
+        except URLError as e:
+            raise UnhandledSource(e.reason)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        options = parse_qs(url_parts.fragment)
+        for key, value in options.items():
+            if not six.PY3:
+                algorithms = hashlib.algorithms
+            else:
+                algorithms = hashlib.algorithms_available
+            if key in algorithms:
+                if len(value) != 1:
+                    raise TypeError(
+                        "Expected 1 hash value, not %d" % len(value))
+                expected = value[0]
+                check_hash(dld_file, expected, key)
+        if checksum:
+            check_hash(dld_file, checksum, hash_type)
+        return extract(dld_file, dest)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/bzrurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/bzrurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4ab3ff1e6bc7dde24e8ed568a3dc0c6012ddea6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/bzrurl.py
@@ -0,0 +1,76 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import STDOUT, check_output
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+from charmhelpers.core.host import mkdir
+
+
+if filter_installed_packages(['bzr']) != []:
+    install(['bzr'])
+    if filter_installed_packages(['bzr']) != []:
+        raise NotImplementedError('Unable to install bzr')
+
+
+class BzrUrlFetchHandler(BaseFetchHandler):
+    """Handler for bazaar branches via generic and lp URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('bzr+ssh', 'lp', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.bzr'))
+        else:
+            return True
+
+    def branch(self, source, dest, revno=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+        cmd_opts = []
+        if revno:
+            cmd_opts += ['-r', str(revno)]
+        if os.path.exists(dest):
+            cmd = ['bzr', 'pull']
+            cmd += cmd_opts
+            cmd += ['--overwrite', '-d', dest, source]
+        else:
+            cmd = ['bzr', 'branch']
+            cmd += cmd_opts
+            cmd += [source, dest]
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, dest=None, revno=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+
+        if dest and not os.path.exists(dest):
+            mkdir(dest, perms=0o755)
+
+        try:
+            self.branch(source, dest_dir, revno)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..a91dcff0645ed541a79cd72af3112bdff393719a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/centos.py
@@ -0,0 +1,171 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import os
+import time
+import six
+import yum
+
+from tempfile import NamedTemporaryFile
+from charmhelpers.core.hookenv import log
+
+YUM_NO_LOCK = 1  # The return code for "couldn't acquire lock" in YUM.
+YUM_NO_LOCK_RETRY_DELAY = 10  # Wait 10 seconds between apt lock checks.
+YUM_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    yb = yum.YumBase()
+    package_list = yb.doPackageLists()
+    temp_cache = {p.base_package_name: 1 for p in package_list['installed']}
+
+    _pkgs = [p for p in packages if not temp_cache.get(p, False)]
+    return _pkgs
+
+
+def install(packages, options=None, fatal=False):
+    """Install one or more packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_yum_command(cmd, fatal)
+
+
+def upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_yum_command(cmd, fatal)
+
+
+def update(fatal=False):
+    """Update local yum cache."""
+    cmd = ['yum', '--assumeyes', 'update']
+    log("Update with fatal: {}".format(fatal))
+    _run_yum_command(cmd, fatal)
+
+
+def purge(packages, fatal=False):
+    """Purge one or more packages."""
+    cmd = ['yum', '--assumeyes', 'remove']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_yum_command(cmd, fatal)
+
+
+def yum_search(packages):
+    """Search for a package."""
+    output = {}
+    cmd = ['yum', 'search']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Searching for {}".format(packages))
+    result = subprocess.check_output(cmd)
+    for package in list(packages):
+        output[package] = package in result
+    return output
+
+
+def add_source(source, key=None):
+    """Add a package source to this system.
+
+    @param source: a URL with a rpm package
+
+    @param key: A key to be added to the system's keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk.
+    """
+    if source is None:
+        log('Source is not present. Skipping')
+        return
+
+    if source.startswith('http'):
+        directory = '/etc/yum.repos.d/'
+        for filename in os.listdir(directory):
+            with open(directory + filename, 'r') as rpm_file:
+                if source in rpm_file.read():
+                    break
+        else:
+            log("Add source: {!r}".format(source))
+            # write in the charms.repo
+            with open(directory + 'Charms.repo', 'a') as rpm_file:
+                rpm_file.write('[%s]\n' % source[7:].replace('/', '_'))
+                rpm_file.write('name=%s\n' % source[7:])
+                rpm_file.write('baseurl=%s\n\n' % source)
+    else:
+        log("Unknown source: {!r}".format(source))
+
+    if key:
+        if '-----BEGIN PGP PUBLIC KEY BLOCK-----' in key:
+            with NamedTemporaryFile('w+') as key_file:
+                key_file.write(key)
+                key_file.flush()
+                key_file.seek(0)
+                subprocess.check_call(['rpm', '--import', key_file.name])
+        else:
+            subprocess.check_call(['rpm', '--import', key])
+
+
+def _run_yum_command(cmd, fatal=False):
+    """Run an YUM command.
+
+    Checks the output and retry if the fatal flag is set to True.
+
+    :param: cmd: str: The yum command to run.
+    :param: fatal: bool: Whether the command's output should be checked and
+        retried.
+    """
+    env = os.environ.copy()
+
+    if fatal:
+        retry_count = 0
+        result = None
+
+        # If the command is considered "fatal", we need to retry if the yum
+        # lock was not acquired.
+
+        while result is None or result == YUM_NO_LOCK:
+            try:
+                result = subprocess.check_call(cmd, env=env)
+            except subprocess.CalledProcessError as e:
+                retry_count = retry_count + 1
+                if retry_count > YUM_NO_LOCK_RETRY_COUNT:
+                    raise
+                result = e.returncode
+                log("Couldn't acquire YUM lock. Will retry in {} seconds."
+                    "".format(YUM_NO_LOCK_RETRY_DELAY))
+                time.sleep(YUM_NO_LOCK_RETRY_DELAY)
+
+    else:
+        subprocess.call(cmd, env=env)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/giturl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/giturl.py
new file mode 100644
index 0000000000000000000000000000000000000000..070ca9bb5c1a2fdef39f88606ffcaf39bb049410
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/giturl.py
@@ -0,0 +1,69 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import check_output, CalledProcessError, STDOUT
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+
+if filter_installed_packages(['git']) != []:
+    install(['git'])
+    if filter_installed_packages(['git']) != []:
+        raise NotImplementedError('Unable to install git')
+
+
+class GitUrlFetchHandler(BaseFetchHandler):
+    """Handler for git branches via generic and github URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        # TODO (mattyw) no support for ssh git@ yet
+        if url_parts.scheme not in ('http', 'https', 'git', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.git'))
+        else:
+            return True
+
+    def clone(self, source, dest, branch="master", depth=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+
+        if os.path.exists(dest):
+            cmd = ['git', '-C', dest, 'pull', source, branch]
+        else:
+            cmd = ['git', 'clone', source, dest, '--branch', branch]
+            if depth:
+                cmd.extend(['--depth', depth])
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, branch="master", dest=None, depth=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+        try:
+            self.clone(source, dest_dir, branch, depth)
+        except CalledProcessError as e:
+            raise UnhandledSource(e)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bff99dc93c64f80716e2d5a2b6d0d4e8a2436955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..757135ee4cf3b5ff4c02305126f5ca3940892afc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/debug.py
@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import print_function
+
+import atexit
+import sys
+
+from charmhelpers.fetch.python.rpdb import Rpdb
+from charmhelpers.core.hookenv import (
+    open_port,
+    close_port,
+    ERROR,
+    log
+)
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+DEFAULT_ADDR = "0.0.0.0"
+DEFAULT_PORT = 4444
+
+
+def _error(message):
+    log(message, level=ERROR)
+
+
+def set_trace(addr=DEFAULT_ADDR, port=DEFAULT_PORT):
+    """
+    Set a trace point using the remote debugger
+    """
+    atexit.register(close_port, port)
+    try:
+        log("Starting a remote python debugger session on %s:%s" % (addr,
+                                                                    port))
+        open_port(port)
+        debugger = Rpdb(addr=addr, port=port)
+        debugger.set_trace(sys._getframe().f_back)
+    except Exception:
+        _error("Cannot start a remote debug session on %s:%s" % (addr,
+                                                                 port))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/packages.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/packages.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e95028bc540aace84a2ec6c1bcc4de2663e8a87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/packages.py
@@ -0,0 +1,154 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+import subprocess
+import sys
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import charm_dir, log
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def pip_execute(*args, **kwargs):
+    """Overriden pip_execute() to stop sys.path being changed.
+
+    The act of importing main from the pip module seems to cause add wheels
+    from the /usr/share/python-wheels which are installed by various tools.
+    This function ensures that sys.path remains the same after the call is
+    executed.
+    """
+    try:
+        _path = sys.path
+        try:
+            from pip import main as _pip_execute
+        except ImportError:
+            apt_update()
+            if six.PY2:
+                apt_install('python-pip')
+            else:
+                apt_install('python3-pip')
+            from pip import main as _pip_execute
+        _pip_execute(*args, **kwargs)
+    finally:
+        sys.path = _path
+
+
+def parse_options(given, available):
+    """Given a set of options, check if available"""
+    for key, value in sorted(given.items()):
+        if not value:
+            continue
+        if key in available:
+            yield "--{0}={1}".format(key, value)
+
+
+def pip_install_requirements(requirements, constraints=None, **options):
+    """Install a requirements file.
+
+    :param constraints: Path to pip constraints file.
+    http://pip.readthedocs.org/en/stable/user_guide/#constraints-files
+    """
+    command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    command.append("-r {0}".format(requirements))
+    if constraints:
+        command.append("-c {0}".format(constraints))
+        log("Installing from file: {} with constraints {} "
+            "and options: {}".format(requirements, constraints, command))
+    else:
+        log("Installing from file: {} with options: {}".format(requirements,
+                                                               command))
+    pip_execute(command)
+
+
+def pip_install(package, fatal=False, upgrade=False, venv=None,
+                constraints=None, **options):
+    """Install a python package"""
+    if venv:
+        venv_python = os.path.join(venv, 'bin/pip')
+        command = [venv_python, "install"]
+    else:
+        command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', 'index-url', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if upgrade:
+        command.append('--upgrade')
+
+    if constraints:
+        command.extend(['-c', constraints])
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Installing {} package with options: {}".format(package,
+                                                        command))
+    if venv:
+        subprocess.check_call(command)
+    else:
+        pip_execute(command)
+
+
+def pip_uninstall(package, **options):
+    """Uninstall a python package"""
+    command = ["uninstall", "-q", "-y"]
+
+    available_options = ('proxy', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Uninstalling {} package with options: {}".format(package,
+                                                          command))
+    pip_execute(command)
+
+
+def pip_list():
+    """Returns the list of current python installed packages
+    """
+    return pip_execute(["list"])
+
+
+def pip_create_virtualenv(path=None):
+    """Create an isolated Python environment."""
+    if six.PY2:
+        apt_install('python-virtualenv')
+    else:
+        apt_install('python3-virtualenv')
+
+    if path:
+        venv_path = path
+    else:
+        venv_path = os.path.join(charm_dir(), 'venv')
+
+    if not os.path.exists(venv_path):
+        subprocess.check_call(['virtualenv', venv_path])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/rpdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/rpdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b31610c22fc2d24fe5097016cf45728f87de4ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/rpdb.py
@@ -0,0 +1,56 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Remote Python Debugger (pdb wrapper)."""
+
+import pdb
+import socket
+import sys
+
+__author__ = "Bertrand Janin <b@janin.com>"
+__version__ = "0.1.3"
+
+
+class Rpdb(pdb.Pdb):
+
+    def __init__(self, addr="127.0.0.1", port=4444):
+        """Initialize the socket and initialize pdb."""
+
+        # Backup stdin and stdout before replacing them by the socket handle
+        self.old_stdout = sys.stdout
+        self.old_stdin = sys.stdin
+
+        # Open a 'reusable' socket to let the webapp reload on the same port
+        self.skt = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self.skt.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, True)
+        self.skt.bind((addr, port))
+        self.skt.listen(1)
+        (clientsocket, address) = self.skt.accept()
+        handle = clientsocket.makefile('rw')
+        pdb.Pdb.__init__(self, completekey='tab', stdin=handle, stdout=handle)
+        sys.stdout = sys.stdin = handle
+
+    def shutdown(self):
+        """Revert stdin and stdout, close the socket."""
+        sys.stdout = self.old_stdout
+        sys.stdin = self.old_stdin
+        self.skt.close()
+        self.set_continue()
+
+    def do_continue(self, arg):
+        """Stop all operation on ``continue``."""
+        self.shutdown()
+        return 1
+
+    do_EOF = do_quit = do_exit = do_c = do_cont = do_continue
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eb421036ff737f8ff1684e85ff87703e30fe543
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/python/version.py
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def current_version():
+    """Current system python version"""
+    return sys.version_info
+
+
+def current_version_string():
+    """Current system python version as string major.minor.micro"""
+    return "{0}.{1}.{2}".format(sys.version_info.major,
+                                sys.version_info.minor,
+                                sys.version_info.micro)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/snap.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/snap.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc70aa941bc4f0bb5ff126237db65705b9e4a10a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/snap.py
@@ -0,0 +1,150 @@
+# Copyright 2014-2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Charm helpers snap for classic charms.
+
+If writing reactive charms, use the snap layer:
+https://lists.ubuntu.com/archives/snapcraft/2016-September/001114.html
+"""
+import subprocess
+import os
+from time import sleep
+from charmhelpers.core.hookenv import log
+
+__author__ = 'Joseph Borg <joseph.borg@canonical.com>'
+
+# The return code for "couldn't acquire lock" in Snap
+# (hopefully this will be improved).
+SNAP_NO_LOCK = 1
+SNAP_NO_LOCK_RETRY_DELAY = 10  # Wait X seconds between Snap lock checks.
+SNAP_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+SNAP_CHANNELS = [
+    'edge',
+    'beta',
+    'candidate',
+    'stable',
+]
+
+
+class CouldNotAcquireLockException(Exception):
+    pass
+
+
+class InvalidSnapChannel(Exception):
+    pass
+
+
+def _snap_exec(commands):
+    """
+    Execute snap commands.
+
+    :param commands: List commands
+    :return: Integer exit code
+    """
+    assert type(commands) == list
+
+    retry_count = 0
+    return_code = None
+
+    while return_code is None or return_code == SNAP_NO_LOCK:
+        try:
+            return_code = subprocess.check_call(['snap'] + commands,
+                                                env=os.environ)
+        except subprocess.CalledProcessError as e:
+            retry_count += + 1
+            if retry_count > SNAP_NO_LOCK_RETRY_COUNT:
+                raise CouldNotAcquireLockException(
+                    'Could not aquire lock after {} attempts'
+                    .format(SNAP_NO_LOCK_RETRY_COUNT))
+            return_code = e.returncode
+            log('Snap failed to acquire lock, trying again in {} seconds.'
+                .format(SNAP_NO_LOCK_RETRY_DELAY), level='WARN')
+            sleep(SNAP_NO_LOCK_RETRY_DELAY)
+
+    return return_code
+
+
+def snap_install(packages, *flags):
+    """
+    Install a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to install command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Installing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with option(s) "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['install'] + flags + packages)
+
+
+def snap_remove(packages, *flags):
+    """
+    Remove a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to remove command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Removing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['remove'] + flags + packages)
+
+
+def snap_refresh(packages, *flags):
+    """
+    Refresh / Update snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to refresh command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Refreshing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['refresh'] + flags + packages)
+
+
+def valid_snap_channel(channel):
+    """ Validate snap channel exists
+
+    :raises InvalidSnapChannel: When channel does not exist
+    :return: Boolean
+    """
+    if channel.lower() in SNAP_CHANNELS:
+        return True
+    else:
+        raise InvalidSnapChannel("Invalid Snap Channel: {}".format(channel))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ddaf0dd47f23cef60d7b7e59a83c989999d9f3f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu.py
@@ -0,0 +1,805 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+import platform
+import re
+import six
+import subprocess
+import sys
+import time
+
+from charmhelpers.core.host import get_distrib_codename, get_system_env
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+    env_proxy_settings,
+)
+from charmhelpers.fetch import SourceConfigError, GPGKeyError
+from charmhelpers.fetch import ubuntu_apt_pkg
+
+PROPOSED_POCKET = (
+    "# Proposed\n"
+    "deb http://archive.ubuntu.com/ubuntu {}-proposed main universe "
+    "multiverse restricted\n")
+PROPOSED_PORTS_POCKET = (
+    "# Proposed\n"
+    "deb http://ports.ubuntu.com/ubuntu-ports {}-proposed main universe "
+    "multiverse restricted\n")
+# Only supports 64bit and ppc64 at the moment.
+ARCH_TO_PROPOSED_POCKET = {
+    'x86_64': PROPOSED_POCKET,
+    'ppc64le': PROPOSED_PORTS_POCKET,
+    'aarch64': PROPOSED_PORTS_POCKET,
+    's390x': PROPOSED_PORTS_POCKET,
+}
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+CLOUD_ARCHIVE = """# Ubuntu Cloud Archive
+deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+"""
+CLOUD_ARCHIVE_POCKETS = {
+    # Folsom
+    'folsom': 'precise-updates/folsom',
+    'folsom/updates': 'precise-updates/folsom',
+    'precise-folsom': 'precise-updates/folsom',
+    'precise-folsom/updates': 'precise-updates/folsom',
+    'precise-updates/folsom': 'precise-updates/folsom',
+    'folsom/proposed': 'precise-proposed/folsom',
+    'precise-folsom/proposed': 'precise-proposed/folsom',
+    'precise-proposed/folsom': 'precise-proposed/folsom',
+    # Grizzly
+    'grizzly': 'precise-updates/grizzly',
+    'grizzly/updates': 'precise-updates/grizzly',
+    'precise-grizzly': 'precise-updates/grizzly',
+    'precise-grizzly/updates': 'precise-updates/grizzly',
+    'precise-updates/grizzly': 'precise-updates/grizzly',
+    'grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-proposed/grizzly': 'precise-proposed/grizzly',
+    # Havana
+    'havana': 'precise-updates/havana',
+    'havana/updates': 'precise-updates/havana',
+    'precise-havana': 'precise-updates/havana',
+    'precise-havana/updates': 'precise-updates/havana',
+    'precise-updates/havana': 'precise-updates/havana',
+    'havana/proposed': 'precise-proposed/havana',
+    'precise-havana/proposed': 'precise-proposed/havana',
+    'precise-proposed/havana': 'precise-proposed/havana',
+    # Icehouse
+    'icehouse': 'precise-updates/icehouse',
+    'icehouse/updates': 'precise-updates/icehouse',
+    'precise-icehouse': 'precise-updates/icehouse',
+    'precise-icehouse/updates': 'precise-updates/icehouse',
+    'precise-updates/icehouse': 'precise-updates/icehouse',
+    'icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-proposed/icehouse': 'precise-proposed/icehouse',
+    # Juno
+    'juno': 'trusty-updates/juno',
+    'juno/updates': 'trusty-updates/juno',
+    'trusty-juno': 'trusty-updates/juno',
+    'trusty-juno/updates': 'trusty-updates/juno',
+    'trusty-updates/juno': 'trusty-updates/juno',
+    'juno/proposed': 'trusty-proposed/juno',
+    'trusty-juno/proposed': 'trusty-proposed/juno',
+    'trusty-proposed/juno': 'trusty-proposed/juno',
+    # Kilo
+    'kilo': 'trusty-updates/kilo',
+    'kilo/updates': 'trusty-updates/kilo',
+    'trusty-kilo': 'trusty-updates/kilo',
+    'trusty-kilo/updates': 'trusty-updates/kilo',
+    'trusty-updates/kilo': 'trusty-updates/kilo',
+    'kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-proposed/kilo': 'trusty-proposed/kilo',
+    # Liberty
+    'liberty': 'trusty-updates/liberty',
+    'liberty/updates': 'trusty-updates/liberty',
+    'trusty-liberty': 'trusty-updates/liberty',
+    'trusty-liberty/updates': 'trusty-updates/liberty',
+    'trusty-updates/liberty': 'trusty-updates/liberty',
+    'liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-proposed/liberty': 'trusty-proposed/liberty',
+    # Mitaka
+    'mitaka': 'trusty-updates/mitaka',
+    'mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-mitaka': 'trusty-updates/mitaka',
+    'trusty-mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-updates/mitaka': 'trusty-updates/mitaka',
+    'mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-proposed/mitaka': 'trusty-proposed/mitaka',
+    # Newton
+    'newton': 'xenial-updates/newton',
+    'newton/updates': 'xenial-updates/newton',
+    'xenial-newton': 'xenial-updates/newton',
+    'xenial-newton/updates': 'xenial-updates/newton',
+    'xenial-updates/newton': 'xenial-updates/newton',
+    'newton/proposed': 'xenial-proposed/newton',
+    'xenial-newton/proposed': 'xenial-proposed/newton',
+    'xenial-proposed/newton': 'xenial-proposed/newton',
+    # Ocata
+    'ocata': 'xenial-updates/ocata',
+    'ocata/updates': 'xenial-updates/ocata',
+    'xenial-ocata': 'xenial-updates/ocata',
+    'xenial-ocata/updates': 'xenial-updates/ocata',
+    'xenial-updates/ocata': 'xenial-updates/ocata',
+    'ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-proposed/ocata': 'xenial-proposed/ocata',
+    # Pike
+    'pike': 'xenial-updates/pike',
+    'xenial-pike': 'xenial-updates/pike',
+    'xenial-pike/updates': 'xenial-updates/pike',
+    'xenial-updates/pike': 'xenial-updates/pike',
+    'pike/proposed': 'xenial-proposed/pike',
+    'xenial-pike/proposed': 'xenial-proposed/pike',
+    'xenial-proposed/pike': 'xenial-proposed/pike',
+    # Queens
+    'queens': 'xenial-updates/queens',
+    'xenial-queens': 'xenial-updates/queens',
+    'xenial-queens/updates': 'xenial-updates/queens',
+    'xenial-updates/queens': 'xenial-updates/queens',
+    'queens/proposed': 'xenial-proposed/queens',
+    'xenial-queens/proposed': 'xenial-proposed/queens',
+    'xenial-proposed/queens': 'xenial-proposed/queens',
+    # Rocky
+    'rocky': 'bionic-updates/rocky',
+    'bionic-rocky': 'bionic-updates/rocky',
+    'bionic-rocky/updates': 'bionic-updates/rocky',
+    'bionic-updates/rocky': 'bionic-updates/rocky',
+    'rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-proposed/rocky': 'bionic-proposed/rocky',
+    # Stein
+    'stein': 'bionic-updates/stein',
+    'bionic-stein': 'bionic-updates/stein',
+    'bionic-stein/updates': 'bionic-updates/stein',
+    'bionic-updates/stein': 'bionic-updates/stein',
+    'stein/proposed': 'bionic-proposed/stein',
+    'bionic-stein/proposed': 'bionic-proposed/stein',
+    'bionic-proposed/stein': 'bionic-proposed/stein',
+    # Train
+    'train': 'bionic-updates/train',
+    'bionic-train': 'bionic-updates/train',
+    'bionic-train/updates': 'bionic-updates/train',
+    'bionic-updates/train': 'bionic-updates/train',
+    'train/proposed': 'bionic-proposed/train',
+    'bionic-train/proposed': 'bionic-proposed/train',
+    'bionic-proposed/train': 'bionic-proposed/train',
+    # Ussuri
+    'ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri/updates': 'bionic-updates/ussuri',
+    'bionic-updates/ussuri': 'bionic-updates/ussuri',
+    'ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-proposed/ussuri': 'bionic-proposed/ussuri',
+}
+
+
+APT_NO_LOCK = 100  # The return code for "couldn't acquire lock" in APT.
+CMD_RETRY_DELAY = 10  # Wait 10 seconds between command retries.
+CMD_RETRY_COUNT = 3  # Retry a failing fatal command X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    cache = apt_cache()
+    _pkgs = []
+    for package in packages:
+        try:
+            p = cache[package]
+            p.current_ver or _pkgs.append(package)
+        except KeyError:
+            log('Package {} has no installation candidate.'.format(package),
+                level='WARNING')
+            _pkgs.append(package)
+    return _pkgs
+
+
+def filter_missing_packages(packages):
+    """Return a list of packages that are installed.
+
+    :param packages: list of packages to evaluate.
+    :returns list: Packages that are installed.
+    """
+    return list(
+        set(packages) -
+        set(filter_installed_packages(packages))
+    )
+
+
+def apt_cache(*_, **__):
+    """Shim returning an object simulating the apt_pkg Cache.
+
+    :param _: Accept arguments for compability, not used.
+    :type _: any
+    :param __: Accept keyword arguments for compability, not used.
+    :type __: any
+    :returns:Object used to interrogate the system apt and dpkg databases.
+    :rtype:ubuntu_apt_pkg.Cache
+    """
+    if 'apt_pkg' in sys.modules:
+        # NOTE(fnordahl): When our consumer use the upstream ``apt_pkg`` module
+        # in conjunction with the apt_cache helper function, they may expect us
+        # to call ``apt_pkg.init()`` for them.
+        #
+        # Detect this situation, log a warning and make the call to
+        # ``apt_pkg.init()`` to avoid the consumer Python interpreter from
+        # crashing with a segmentation fault.
+        log('Support for use of upstream ``apt_pkg`` module in conjunction'
+            'with charm-helpers is deprecated since 2019-06-25', level=WARNING)
+        sys.modules['apt_pkg'].init()
+    return ubuntu_apt_pkg.Cache()
+
+
+def apt_install(packages, options=None, fatal=False):
+    """Install one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages.
+
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :param dist: Whether ``dist-upgrade`` should be used over ``upgrade``
+    :type dist: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    if dist:
+        cmd.append('dist-upgrade')
+    else:
+        cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_update(fatal=False):
+    """Update local apt cache."""
+    cmd = ['apt-get', 'update']
+    _run_apt_command(cmd, fatal)
+
+
+def apt_purge(packages, fatal=False):
+    """Purge one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'purge']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_autoremove(purge=True, fatal=False):
+    """Purge one or more packages.
+    :param purge: Whether the ``--purge`` option should be passed on or not.
+    :type purge: bool
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'autoremove']
+    if purge:
+        cmd.append('--purge')
+    _run_apt_command(cmd, fatal)
+
+
+def apt_mark(packages, mark, fatal=False):
+    """Flag one or more packages using apt-mark."""
+    log("Marking {} as {}".format(packages, mark))
+    cmd = ['apt-mark', mark]
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+
+    if fatal:
+        subprocess.check_call(cmd, universal_newlines=True)
+    else:
+        subprocess.call(cmd, universal_newlines=True)
+
+
+def apt_hold(packages, fatal=False):
+    return apt_mark(packages, 'hold', fatal=fatal)
+
+
+def apt_unhold(packages, fatal=False):
+    return apt_mark(packages, 'unhold', fatal=fatal)
+
+
+def import_key(key):
+    """Import an ASCII Armor key.
+
+    A Radix64 format keyid is also supported for backwards
+    compatibility. In this case Ubuntu keyserver will be
+    queried for a key via HTTPS by its keyid. This method
+    is less preferrable because https proxy servers may
+    require traffic decryption which is equivalent to a
+    man-in-the-middle attack (a proxy server impersonates
+    keyserver TLS certificates and has to be explicitly
+    trusted by the system).
+
+    :param key: A GPG key in ASCII armor format,
+                  including BEGIN and END markers or a keyid.
+    :type key: (bytes, str)
+    :raises: GPGKeyError if the key could not be imported
+    """
+    key = key.strip()
+    if '-' in key or '\n' in key:
+        # Send everything not obviously a keyid to GPG to import, as
+        # we trust its validation better than our own. eg. handling
+        # comments before the key.
+        log("PGP key found (looks like ASCII Armor format)", level=DEBUG)
+        if ('-----BEGIN PGP PUBLIC KEY BLOCK-----' in key and
+                '-----END PGP PUBLIC KEY BLOCK-----' in key):
+            log("Writing provided PGP key in the binary format", level=DEBUG)
+            if six.PY3:
+                key_bytes = key.encode('utf-8')
+            else:
+                key_bytes = key
+            key_name = _get_keyid_by_gpg_key(key_bytes)
+            key_gpg = _dearmor_gpg_key(key_bytes)
+            _write_apt_gpg_keyfile(key_name=key_name, key_material=key_gpg)
+        else:
+            raise GPGKeyError("ASCII armor markers missing from GPG key")
+    else:
+        log("PGP key found (looks like Radix64 format)", level=WARNING)
+        log("SECURELY importing PGP key from keyserver; "
+            "full key not provided.", level=WARNING)
+        # as of bionic add-apt-repository uses curl with an HTTPS keyserver URL
+        # to retrieve GPG keys. `apt-key adv` command is deprecated as is
+        # apt-key in general as noted in its manpage. See lp:1433761 for more
+        # history. Instead, /etc/apt/trusted.gpg.d is used directly to drop
+        # gpg
+        key_asc = _get_key_by_keyid(key)
+        # write the key in GPG format so that apt-key list shows it
+        key_gpg = _dearmor_gpg_key(key_asc)
+        _write_apt_gpg_keyfile(key_name=key, key_material=key_gpg)
+
+
+def _get_keyid_by_gpg_key(key_material):
+    """Get a GPG key fingerprint by GPG key material.
+    Gets a GPG key fingerprint (40-digit, 160-bit) by the ASCII armor-encoded
+    or binary GPG key material. Can be used, for example, to generate file
+    names for keys passed via charm options.
+
+    :param key_material: ASCII armor-encoded or binary GPG key material
+    :type key_material: bytes
+    :raises: GPGKeyError if invalid key material has been provided
+    :returns: A GPG key fingerprint
+    :rtype: str
+    """
+    # Use the same gpg command for both Xenial and Bionic
+    cmd = 'gpg --with-colons --with-fingerprint'
+    ps = subprocess.Popen(cmd.split(),
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_material)
+    if six.PY3:
+        out = out.decode('utf-8')
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material provided')
+    # from gnupg2 docs: fpr :: Fingerprint (fingerprint is in field 10)
+    return re.search(r"^fpr:{9}([0-9A-F]{40}):$", out, re.MULTILINE).group(1)
+
+
+def _get_key_by_keyid(keyid):
+    """Get a key via HTTPS from the Ubuntu keyserver.
+    Different key ID formats are supported by SKS keyservers (the longer ones
+    are more secure, see "dead beef attack" and https://evil32.com/). Since
+    HTTPS is used, if SSLBump-like HTTPS proxies are in place, they will
+    impersonate keyserver.ubuntu.com and generate a certificate with
+    keyserver.ubuntu.com in the CN field or in SubjAltName fields of a
+    certificate. If such proxy behavior is expected it is necessary to add the
+    CA certificate chain containing the intermediate CA of the SSLBump proxy to
+    every machine that this code runs on via ca-certs cloud-init directive (via
+    cloudinit-userdata model-config) or via other means (such as through a
+    custom charm option). Also note that DNS resolution for the hostname in a
+    URL is done at a proxy server - not at the client side.
+
+    8-digit (32 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x4652B4E6
+    16-digit (64 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x6E85A86E4652B4E6
+    40-digit key ID:
+    https://keyserver.ubuntu.com/pks/lookup?search=0x35F77D63B5CEC106C577ED856E85A86E4652B4E6
+
+    :param keyid: An 8, 16 or 40 hex digit keyid to find a key for
+    :type keyid: (bytes, str)
+    :returns: A key material for the specified GPG key id
+    :rtype: (str, bytes)
+    :raises: subprocess.CalledProcessError
+    """
+    # options=mr - machine-readable output (disables html wrappers)
+    keyserver_url = ('https://keyserver.ubuntu.com'
+                     '/pks/lookup?op=get&options=mr&exact=on&search=0x{}')
+    curl_cmd = ['curl', keyserver_url.format(keyid)]
+    # use proxy server settings in order to retrieve the key
+    return subprocess.check_output(curl_cmd,
+                                   env=env_proxy_settings(['https']))
+
+
+def _dearmor_gpg_key(key_asc):
+    """Converts a GPG key in the ASCII armor format to the binary format.
+
+    :param key_asc: A GPG key in ASCII armor format.
+    :type key_asc: (str, bytes)
+    :returns: A GPG key in binary format
+    :rtype: (str, bytes)
+    :raises: GPGKeyError
+    """
+    ps = subprocess.Popen(['gpg', '--dearmor'],
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_asc)
+    # no need to decode output as it is binary (invalid utf-8), only error
+    if six.PY3:
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material. Check your network setup'
+                          ' (MTU, routing, DNS) and/or proxy server settings'
+                          ' as well as destination keyserver status.')
+    else:
+        return out
+
+
+def _write_apt_gpg_keyfile(key_name, key_material):
+    """Writes GPG key material into a file at a provided path.
+
+    :param key_name: A key name to use for a key file (could be a fingerprint)
+    :type key_name: str
+    :param key_material: A GPG key material (binary)
+    :type key_material: (str, bytes)
+    """
+    with open('/etc/apt/trusted.gpg.d/{}.gpg'.format(key_name),
+              'wb') as keyf:
+        keyf.write(key_material)
+
+
+def add_source(source, key=None, fail_invalid=False):
+    """Add a package source to this system.
+
+    @param source: a URL or sources.list entry, as supported by
+    add-apt-repository(1). Examples::
+
+        ppa:charmers/example
+        deb https://stub:key@private.example.com/ubuntu trusty main
+
+    In addition:
+        'proposed:' may be used to enable the standard 'proposed'
+        pocket for the release.
+        'cloud:' may be used to activate official cloud archive pockets,
+        such as 'cloud:icehouse'
+        'distro' may be used as a noop
+
+    Full list of source specifications supported by the function are:
+
+    'distro': A NOP; i.e. it has no effect.
+    'proposed': the proposed deb spec [2] is wrtten to
+      /etc/apt/sources.list/proposed
+    'distro-proposed': adds <version>-proposed to the debs [2]
+    'ppa:<ppa-name>': add-apt-repository --yes <ppa_name>
+    'deb <deb-spec>': add-apt-repository --yes deb <deb-spec>
+    'http://....': add-apt-repository --yes http://...
+    'cloud-archive:<spec>': add-apt-repository -yes cloud-archive:<spec>
+    'cloud:<release>[-staging]': specify a Cloud Archive pocket <release> with
+      optional staging version.  If staging is used then the staging PPA [2]
+      with be used.  If staging is NOT used then the cloud archive [3] will be
+      added, and the 'ubuntu-cloud-keyring' package will be added for the
+      current distro.
+
+    Otherwise the source is not recognised and this is logged to the juju log.
+    However, no error is raised, unless sys_error_on_exit is True.
+
+    [1] deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+        where {} is replaced with the derived pocket name.
+    [2] deb http://archive.ubuntu.com/ubuntu {}-proposed \
+        main universe multiverse restricted
+        where {} is replaced with the lsb_release codename (e.g. xenial)
+    [3] deb http://ubuntu-cloud.archive.canonical.com/ubuntu <pocket>
+        to /etc/apt/sources.list.d/cloud-archive-list
+
+    @param key: A key to be added to the system's APT keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk. ppa and cloud archive keys
+    are securely added automtically, so sould not be provided.
+
+    @param fail_invalid: (boolean) if True, then the function raises a
+    SourceConfigError is there is no matching installation source.
+
+    @raises SourceConfigError() if for cloud:<pocket>, the <pocket> is not a
+    valid pocket in CLOUD_ARCHIVE_POCKETS
+    """
+    _mapping = OrderedDict([
+        (r"^distro$", lambda: None),  # This is a NOP
+        (r"^(?:proposed|distro-proposed)$", _add_proposed),
+        (r"^cloud-archive:(.*)$", _add_apt_repository),
+        (r"^((?:deb |http:|https:|ppa:).*)$", _add_apt_repository),
+        (r"^cloud:(.*)-(.*)\/staging$", _add_cloud_staging),
+        (r"^cloud:(.*)-(.*)$", _add_cloud_distro_check),
+        (r"^cloud:(.*)$", _add_cloud_pocket),
+        (r"^snap:.*-(.*)-(.*)$", _add_cloud_distro_check),
+    ])
+    if source is None:
+        source = ''
+    for r, fn in six.iteritems(_mapping):
+        m = re.match(r, source)
+        if m:
+            if key:
+                # Import key before adding the source which depends on it,
+                # as refreshing packages could fail otherwise.
+                try:
+                    import_key(key)
+                except GPGKeyError as e:
+                    raise SourceConfigError(str(e))
+            # call the associated function with the captured groups
+            # raises SourceConfigError on error.
+            fn(*m.groups())
+            break
+    else:
+        # nothing matched.  log an error and maybe sys.exit
+        err = "Unknown source: {!r}".format(source)
+        log(err)
+        if fail_invalid:
+            raise SourceConfigError(err)
+
+
+def _add_proposed():
+    """Add the PROPOSED_POCKET as /etc/apt/source.list.d/proposed.list
+
+    Uses get_distrib_codename to determine the correct stanza for
+    the deb line.
+
+    For intel architecutres PROPOSED_POCKET is used for the release, but for
+    other architectures PROPOSED_PORTS_POCKET is used for the release.
+    """
+    release = get_distrib_codename()
+    arch = platform.machine()
+    if arch not in six.iterkeys(ARCH_TO_PROPOSED_POCKET):
+        raise SourceConfigError("Arch {} not supported for (distro-)proposed"
+                                .format(arch))
+    with open('/etc/apt/sources.list.d/proposed.list', 'w') as apt:
+        apt.write(ARCH_TO_PROPOSED_POCKET[arch].format(release))
+
+
+def _add_apt_repository(spec):
+    """Add the spec using add_apt_repository
+
+    :param spec: the parameter to pass to add_apt_repository
+    :type spec: str
+    """
+    if '{series}' in spec:
+        series = get_distrib_codename()
+        spec = spec.replace('{series}', series)
+    # software-properties package for bionic properly reacts to proxy settings
+    # passed as environment variables (See lp:1433761). This is not the case
+    # LTS and non-LTS releases below bionic.
+    _run_with_retries(['add-apt-repository', '--yes', spec],
+                      cmd_env=env_proxy_settings(['https']))
+
+
+def _add_cloud_pocket(pocket):
+    """Add a cloud pocket as /etc/apt/sources.d/cloud-archive.list
+
+    Note that this overwrites the existing file if there is one.
+
+    This function also converts the simple pocket in to the actual pocket using
+    the CLOUD_ARCHIVE_POCKETS mapping.
+
+    :param pocket: string representing the pocket to add a deb spec for.
+    :raises: SourceConfigError if the cloud pocket doesn't exist or the
+        requested release doesn't match the current distro version.
+    """
+    apt_install(filter_installed_packages(['ubuntu-cloud-keyring']),
+                fatal=True)
+    if pocket not in CLOUD_ARCHIVE_POCKETS:
+        raise SourceConfigError(
+            'Unsupported cloud: source option %s' %
+            pocket)
+    actual_pocket = CLOUD_ARCHIVE_POCKETS[pocket]
+    with open('/etc/apt/sources.list.d/cloud-archive.list', 'w') as apt:
+        apt.write(CLOUD_ARCHIVE.format(actual_pocket))
+
+
+def _add_cloud_staging(cloud_archive_release, openstack_release):
+    """Add the cloud staging repository which is in
+    ppa:ubuntu-cloud-archive/<openstack_release>-staging
+
+    This function checks that the cloud_archive_release matches the current
+    codename for the distro that charm is being installed on.
+
+    :param cloud_archive_release: string, codename for the release.
+    :param openstack_release: String, codename for the openstack release.
+    :raises: SourceConfigError if the cloud_archive_release doesn't match the
+        current version of the os.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    ppa = 'ppa:ubuntu-cloud-archive/{}-staging'.format(openstack_release)
+    cmd = 'add-apt-repository -y {}'.format(ppa)
+    _run_with_retries(cmd.split(' '))
+
+
+def _add_cloud_distro_check(cloud_archive_release, openstack_release):
+    """Add the cloud pocket, but also check the cloud_archive_release against
+    the current distro, and use the openstack_release as the full lookup.
+
+    This just calls _add_cloud_pocket() with the openstack_release as pocket
+    to get the correct cloud-archive.list for dpkg to work with.
+
+    :param cloud_archive_release:String, codename for the distro release.
+    :param openstack_release: String, spec for the release to look up in the
+        CLOUD_ARCHIVE_POCKETS
+    :raises: SourceConfigError if this is the wrong distro, or the pocket spec
+        doesn't exist.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    _add_cloud_pocket("{}-{}".format(cloud_archive_release, openstack_release))
+
+
+def _verify_is_ubuntu_rel(release, os_release):
+    """Verify that the release is in the same as the current ubuntu release.
+
+    :param release: String, lowercase for the release.
+    :param os_release: String, the os_release being asked for
+    :raises: SourceConfigError if the release is not the same as the ubuntu
+        release.
+    """
+    ubuntu_rel = get_distrib_codename()
+    if release != ubuntu_rel:
+        raise SourceConfigError(
+            'Invalid Cloud Archive release specified: {}-{} on this Ubuntu'
+            'version ({})'.format(release, os_release, ubuntu_rel))
+
+
+def _run_with_retries(cmd, max_retries=CMD_RETRY_COUNT, retry_exitcodes=(1,),
+                      retry_message="", cmd_env=None):
+    """Run a command and retry until success or max_retries is reached.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param max_retries: The number of retries to attempt on a fatal
+                        command. Defaults to CMD_RETRY_COUNT.
+    :type max_retries: int
+    :param retry_exitcodes: Optional additional exit codes to retry.
+                            Defaults to retry on exit code 1.
+    :type retry_exitcodes: tuple
+    :param retry_message: Optional log prefix emitted during retries.
+    :type retry_message: str
+    :param: cmd_env: Environment variables to add to the command run.
+    :type cmd_env: Option[None, Dict[str, str]]
+    """
+    env = get_apt_dpkg_env()
+    if cmd_env:
+        env.update(cmd_env)
+
+    if not retry_message:
+        retry_message = "Failed executing '{}'".format(" ".join(cmd))
+    retry_message += ". Will retry in {} seconds".format(CMD_RETRY_DELAY)
+
+    retry_count = 0
+    result = None
+
+    retry_results = (None,) + retry_exitcodes
+    while result in retry_results:
+        try:
+            result = subprocess.check_call(cmd, env=env)
+        except subprocess.CalledProcessError as e:
+            retry_count = retry_count + 1
+            if retry_count > max_retries:
+                raise
+            result = e.returncode
+            log(retry_message)
+            time.sleep(CMD_RETRY_DELAY)
+
+
+def _run_apt_command(cmd, fatal=False):
+    """Run an apt command with optional retries.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    """
+    if fatal:
+        _run_with_retries(
+            cmd, retry_exitcodes=(1, APT_NO_LOCK,),
+            retry_message="Couldn't acquire DPKG lock")
+    else:
+        subprocess.call(cmd, env=get_apt_dpkg_env())
+
+
+def get_upstream_version(package):
+    """Determine upstream version based on installed package
+
+    @returns None (if not installed) or the upstream version
+    """
+    cache = apt_cache()
+    try:
+        pkg = cache[package]
+    except Exception:
+        # the package is unknown to the current apt cache.
+        return None
+
+    if not pkg.current_ver:
+        # package is known, but no version is currently installed.
+        return None
+
+    return ubuntu_apt_pkg.upstream_version(pkg.current_ver.ver_str)
+
+
+def get_apt_dpkg_env():
+    """Get environment suitable for execution of APT and DPKG tools.
+
+    We keep this in a helper function instead of in a global constant to
+    avoid execution on import of the library.
+    :returns: Environment suitable for execution of APT and DPKG tools.
+    :rtype: Dict[str, str]
+    """
+    # The fallback is used in the event of ``/etc/environment`` not containing
+    # avalid PATH variable.
+    return {'DEBIAN_FRONTEND': 'noninteractive',
+            'PATH': get_system_env('PATH', '/usr/sbin:/usr/bin:/sbin:/bin')}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu_apt_pkg.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu_apt_pkg.py
new file mode 100644
index 0000000000000000000000000000000000000000..929a75d7a775921c32368e8cc7950eaa97390047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/fetch/ubuntu_apt_pkg.py
@@ -0,0 +1,267 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Provide a subset of the ``python-apt`` module API.
+
+Data collection is done through subprocess calls to ``apt-cache`` and
+``dpkg-query`` commands.
+
+The main purpose for this module is to avoid dependency on the
+``python-apt`` python module.
+
+The indicated python module is a wrapper around the ``apt`` C++ library
+which is tightly connected to the version of the distribution it was
+shipped on.  It is not developed in a backward/forward compatible manner.
+
+This in turn makes it incredibly hard to distribute as a wheel for a piece
+of python software that supports a span of distro releases [0][1].
+
+Upstream feedback like [2] does not give confidence in this ever changing,
+so with this we get rid of the dependency.
+
+0: https://github.com/juju-solutions/layer-basic/pull/135
+1: https://bugs.launchpad.net/charm-octavia/+bug/1824112
+2: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845330#10
+"""
+
+import locale
+import os
+import subprocess
+import sys
+
+
+class _container(dict):
+    """Simple container for attributes."""
+    __getattr__ = dict.__getitem__
+    __setattr__ = dict.__setitem__
+
+
+class Package(_container):
+    """Simple container for package attributes."""
+
+
+class Version(_container):
+    """Simple container for version attributes."""
+
+
+class Cache(object):
+    """Simulation of ``apt_pkg`` Cache object."""
+    def __init__(self, progress=None):
+        pass
+
+    def __contains__(self, package):
+        try:
+            pkg = self.__getitem__(package)
+            return pkg is not None
+        except KeyError:
+            return False
+
+    def __getitem__(self, package):
+        """Get information about a package from apt and dpkg databases.
+
+        :param package: Name of package
+        :type package: str
+        :returns: Package object
+        :rtype: object
+        :raises: KeyError, subprocess.CalledProcessError
+        """
+        apt_result = self._apt_cache_show([package])[package]
+        apt_result['name'] = apt_result.pop('package')
+        pkg = Package(apt_result)
+        dpkg_result = self._dpkg_list([package]).get(package, {})
+        current_ver = None
+        installed_version = dpkg_result.get('version')
+        if installed_version:
+            current_ver = Version({'ver_str': installed_version})
+        pkg.current_ver = current_ver
+        pkg.architecture = dpkg_result.get('architecture')
+        return pkg
+
+    def _dpkg_list(self, packages):
+        """Get data from system dpkg database for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about installed packages, keys like
+                  ``dpkg-query --list``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['dpkg-query', '--list']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+        except subprocess.CalledProcessError as cp:
+            # ``dpkg-query`` may return error and at the same time have
+            # produced useful output, for example when asked for multiple
+            # packages where some are not installed
+            if cp.returncode != 1:
+                raise
+            output = cp.output
+        headings = []
+        for line in output.splitlines():
+            if line.startswith('||/'):
+                headings = line.split()
+                headings.pop(0)
+                continue
+            elif (line.startswith('|') or line.startswith('+') or
+                  line.startswith('dpkg-query:')):
+                continue
+            else:
+                data = line.split(None, 4)
+                status = data.pop(0)
+                if status != 'ii':
+                    continue
+                pkg = {}
+                pkg.update({k.lower(): v for k, v in zip(headings, data)})
+                if 'name' in pkg:
+                    pkgs.update({pkg['name']: pkg})
+        return pkgs
+
+    def _apt_cache_show(self, packages):
+        """Get data from system apt cache for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about package, keys like
+                  ``apt-cache show``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['apt-cache', 'show', '--no-all-versions']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+            previous = None
+            pkg = {}
+            for line in output.splitlines():
+                if not line:
+                    if 'package' in pkg:
+                        pkgs.update({pkg['package']: pkg})
+                        pkg = {}
+                    continue
+                if line.startswith(' '):
+                    if previous and previous in pkg:
+                        pkg[previous] += os.linesep + line.lstrip()
+                    continue
+                if ':' in line:
+                    kv = line.split(':', 1)
+                    key = kv[0].lower()
+                    if key == 'n':
+                        continue
+                    previous = key
+                    pkg.update({key: kv[1].lstrip()})
+        except subprocess.CalledProcessError as cp:
+            # ``apt-cache`` returns 100 if none of the packages asked for
+            # exist in the apt cache.
+            if cp.returncode != 100:
+                raise
+        return pkgs
+
+
+class Config(_container):
+    def __init__(self):
+        super(Config, self).__init__(self._populate())
+
+    def _populate(self):
+        cfgs = {}
+        cmd = ['apt-config', 'dump']
+        output = subprocess.check_output(cmd,
+                                         stderr=subprocess.STDOUT,
+                                         universal_newlines=True)
+        for line in output.splitlines():
+            if not line.startswith("CommandLine"):
+                k, v = line.split(" ", 1)
+                cfgs[k] = v.strip(";").strip("\"")
+
+        return cfgs
+
+
+# Backwards compatibility with old apt_pkg module
+sys.modules[__name__].config = Config()
+
+
+def init():
+    """Compability shim that does nothing."""
+    pass
+
+
+def upstream_version(version):
+    """Extracts upstream version from a version string.
+
+    Upstream reference: https://salsa.debian.org/apt-team/apt/blob/master/
+                                apt-pkg/deb/debversion.cc#L259
+
+    :param version: Version string
+    :type version: str
+    :returns: Upstream version
+    :rtype: str
+    """
+    if version:
+        version = version.split(':')[-1]
+        version = version.split('-')[0]
+    return version
+
+
+def version_compare(a, b):
+    """Compare the given versions.
+
+    Call out to ``dpkg`` to make sure the code doing the comparison is
+    compatible with what the ``apt`` library would do.  Mimic the return
+    values.
+
+    Upstream reference:
+    https://apt-team.pages.debian.net/python-apt/library/apt_pkg.html
+            ?highlight=version_compare#apt_pkg.version_compare
+
+    :param a: version string
+    :type a: str
+    :param b: version string
+    :type b: str
+    :returns: >0 if ``a`` is greater than ``b``, 0 if a equals b,
+              <0 if ``a`` is smaller than ``b``
+    :rtype: int
+    :raises: subprocess.CalledProcessError, RuntimeError
+    """
+    for op in ('gt', 1), ('eq', 0), ('lt', -1):
+        try:
+            subprocess.check_call(['dpkg', '--compare-versions',
+                                   a, op[0], b],
+                                  stderr=subprocess.STDOUT,
+                                  universal_newlines=True)
+            return op[1]
+        except subprocess.CalledProcessError as cp:
+            if cp.returncode == 1:
+                continue
+            raise
+    else:
+        raise RuntimeError('Unable to compare "{}" and "{}", according to '
+                           'our logic they are neither greater, equal nor '
+                           'less than each other.')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/osplatform.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/osplatform.py
new file mode 100644
index 0000000000000000000000000000000000000000..78c81af5955caee51271c830d58cacac2cab9bcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/osplatform.py
@@ -0,0 +1,46 @@
+import platform
+import os
+
+
+def get_platform():
+    """Return the current OS platform.
+
+    For example: if current os platform is Ubuntu then a string "ubuntu"
+    will be returned (which is the name of the module).
+    This string is used to decide which platform module should be imported.
+    """
+    # linux_distribution is deprecated and will be removed in Python 3.7
+    # Warnings *not* disabled, as we certainly need to fix this.
+    if hasattr(platform, 'linux_distribution'):
+        tuple_platform = platform.linux_distribution()
+        current_platform = tuple_platform[0]
+    else:
+        current_platform = _get_platform_from_fs()
+
+    if "Ubuntu" in current_platform:
+        return "ubuntu"
+    elif "CentOS" in current_platform:
+        return "centos"
+    elif "debian" in current_platform:
+        # Stock Python does not detect Ubuntu and instead returns debian.
+        # Or at least it does in some build environments like Travis CI
+        return "ubuntu"
+    elif "elementary" in current_platform:
+        # ElementaryOS fails to run tests locally without this.
+        return "ubuntu"
+    else:
+        raise RuntimeError("This module is not supported on {}."
+                           .format(current_platform))
+
+
+def _get_platform_from_fs():
+    """Get Platform from /etc/os-release."""
+    with open(os.path.join(os.sep, 'etc', 'os-release')) as fin:
+        content = dict(
+            line.split('=', 1)
+            for line in fin.read().splitlines()
+            if '=' in line
+        )
+    for k, v in content.items():
+        content[k] = v.strip('"')
+    return content["NAME"]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee55cb3d2baddb556df910f1d41638c3c7f39c59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/__init__.py
@@ -0,0 +1,15 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Tools for working with files injected into a charm just before deployment."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/archive.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/archive.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fc453f523cf49f0c123839a347c4452c6d465ca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/archive.py
@@ -0,0 +1,71 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import tarfile
+import zipfile
+from charmhelpers.core import (
+    host,
+    hookenv,
+)
+
+
+class ArchiveError(Exception):
+    pass
+
+
+def get_archive_handler(archive_name):
+    if os.path.isfile(archive_name):
+        if tarfile.is_tarfile(archive_name):
+            return extract_tarfile
+        elif zipfile.is_zipfile(archive_name):
+            return extract_zipfile
+    else:
+        # look at the file name
+        for ext in ('.tar', '.tar.gz', '.tgz', 'tar.bz2', '.tbz2', '.tbz'):
+            if archive_name.endswith(ext):
+                return extract_tarfile
+        for ext in ('.zip', '.jar'):
+            if archive_name.endswith(ext):
+                return extract_zipfile
+
+
+def archive_dest_default(archive_name):
+    archive_file = os.path.basename(archive_name)
+    return os.path.join(hookenv.charm_dir(), "archives", archive_file)
+
+
+def extract(archive_name, destpath=None):
+    handler = get_archive_handler(archive_name)
+    if handler:
+        if not destpath:
+            destpath = archive_dest_default(archive_name)
+        if not os.path.isdir(destpath):
+            host.mkdir(destpath)
+        handler(archive_name, destpath)
+        return destpath
+    else:
+        raise ArchiveError("No handler for archive")
+
+
+def extract_tarfile(archive_name, destpath):
+    "Unpack a tar archive, optionally compressed"
+    archive = tarfile.open(archive_name)
+    archive.extractall(destpath)
+
+
+def extract_zipfile(archive_name, destpath):
+    "Unpack a zip file"
+    archive = zipfile.ZipFile(archive_name)
+    archive.extractall(destpath)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/execd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/execd.py
new file mode 100644
index 0000000000000000000000000000000000000000..1502aa0b596f0b1a2017ccb4543a35999774431d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charmhelpers/payload/execd.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def default_execd_dir():
+    return os.path.join(os.environ['CHARM_DIR'], 'exec.d')
+
+
+def execd_module_paths(execd_dir=None):
+    """Generate a list of full paths to modules within execd_dir."""
+    if not execd_dir:
+        execd_dir = default_execd_dir()
+
+    if not os.path.exists(execd_dir):
+        return
+
+    for subpath in os.listdir(execd_dir):
+        module = os.path.join(execd_dir, subpath)
+        if os.path.isdir(module):
+            yield module
+
+
+def execd_submodule_paths(command, execd_dir=None):
+    """Generate a list of full paths to the specified command within exec_dir.
+    """
+    for module_path in execd_module_paths(execd_dir):
+        path = os.path.join(module_path, command)
+        if os.access(path, os.X_OK) and os.path.isfile(path):
+            yield path
+
+
+def execd_run(command, execd_dir=None, die_on_error=True, stderr=subprocess.STDOUT):
+    """Run command for each module within execd_dir which defines it."""
+    for submodule_path in execd_submodule_paths(command, execd_dir):
+        try:
+            subprocess.check_output(submodule_path, stderr=stderr,
+                                    universal_newlines=True)
+        except subprocess.CalledProcessError as e:
+            hookenv.log("Error ({}) running  {}. Output: {}".format(
+                e.returncode, e.cmd, e.output))
+            if die_on_error:
+                sys.exit(e.returncode)
+
+
+def execd_preinstall(execd_dir=None):
+    """Run charm-pre-install for each module within execd_dir."""
+    execd_run('charm-pre-install', execd_dir=execd_dir)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/libansible.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/libansible.py
new file mode 100644
index 0000000000000000000000000000000000000000..811ec4441fdde7f424a6e29800f265a528d27da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/libansible.py
@@ -0,0 +1,108 @@
+##
+# Copyright ETSI OSM
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import fnmatch
+import os
+import subprocess
+import sys
+import yaml
+
+import charmhelpers.fetch
+
+
+sys.path.append("lib")
+
+
+ansible_hosts_path = "/etc/ansible/hosts"
+
+
+def install_ansible_support(from_ppa=True, ppa_location="ppa:ansible/ansible"):
+    """Installs the ansible package.
+
+    By default it is installed from the `PPA`_ linked from
+    the ansible `website`_ or from a ppa specified by a charm config..
+
+    .. _PPA: https://launchpad.net/~rquillo/+archive/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If from_ppa is empty, you must ensure that the package is available
+    from a configured repository.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install("ansible")
+    with open(ansible_hosts_path, "w+") as hosts_file:
+        hosts_file.write("localhost ansible_connection=local")
+
+
+def create_hosts(hostname, username, password, hosts):
+    inventory_path = "/etc/ansible/hosts"
+    with open(inventory_path, 'w') as f:
+        f.write('[{}]\n'.format(hosts))
+        h1 = '{0} ansible_connection=network_cli ansible_network_os=vyos ' \
+             'ansible_ssh_user={1} ansible_ssh_pass={2} ' \
+             'ansible_python_interpreter=/usr/bin/python\n'.format(hostname, username, password)
+        f.write(h1)
+
+
+def create_ansible_cfg():
+    ansible_config_path = "/etc/ansible/ansible.cfg"
+    with open(ansible_config_path, 'w') as f:
+        f.write('[defaults]\n')
+        f.write('host_key_checking = False\n')
+        # logs playbook execution attempts to the specified path
+        f.write('log_path = /var/log/ansible.log\n')
+        f.write('[ssh_connection]\n')
+        f.write('control_path=%(directory)s/%%h-%%r\n')
+        f.write('control_path_dir=~/.ansible/cp\n')
+
+
+# Function to find the playbook path
+def find(pattern, path):
+    result = ""
+    for root, dirs, files in os.walk(path):
+        for name in files:
+            if fnmatch.fnmatch(name, pattern):
+                result = os.path.join(root, name)
+    return result
+
+
+def execute_playbook(playbook_file, hostname, user, password, vars_dict=None):
+    playbook_path = find(playbook_file, '/var/lib/juju/agents/')
+    print("Playbook " + playbook_file + " is " + playbook_path)
+    with open(playbook_path, 'r') as f:
+        playbook_data = yaml.load(f, Loader=yaml.SafeLoader)
+    hosts = 'all'
+    if 'hosts' in playbook_data[0].keys() and playbook_data[0]['hosts']:
+        hosts = playbook_data[0]['hosts']
+    create_ansible_cfg()
+    create_hosts(hostname, user, password, hosts)
+    call = 'ansible-playbook -vvvv %s ' % playbook_path
+    if vars_dict and isinstance(vars_dict, dict) and len(vars_dict) > 0:
+        call += '--extra-vars '
+        string_var = ''
+        for v in vars_dict.items():
+            string_var += '%s=%s ' % v
+        string_var = string_var.strip()
+        call += '"%s"' % string_var
+    call = call.strip()
+    print(call)
+    result = subprocess.check_output(call, shell=True)
+    lastline = result.decode('utf-8').splitlines()[-2]
+    print("Result is " + lastline)
+    return lastline
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/ns.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/ns.py
new file mode 100644
index 0000000000000000000000000000000000000000..25be4056282e48ce946632025be8b466557e3171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/ns.py
@@ -0,0 +1,301 @@
+# A prototype of a library to aid in the development and operation of
+# OSM Network Service charms
+
+import asyncio
+import logging
+import os
+import os.path
+import re
+import subprocess
+import sys
+import time
+import yaml
+
+try:
+    import juju
+except ImportError:
+    # Not all cloud images are created equal
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # Update the apt cache
+        subprocess.check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        subprocess.check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+
+    # Install the libjuju build dependencies
+    subprocess.check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    subprocess.check_call(
+        [sys.executable, "-m", "pip", "install", "juju"],
+    )
+
+from juju.controller import Controller
+
+# Quiet the debug logging
+logging.getLogger('websockets.protocol').setLevel(logging.INFO)
+logging.getLogger('juju.client.connection').setLevel(logging.WARN)
+logging.getLogger('juju.model').setLevel(logging.WARN)
+logging.getLogger('juju.machine').setLevel(logging.WARN)
+
+
+class NetworkService:
+    """A lightweight interface to the Juju controller.
+
+    This NetworkService client is specifically designed to allow a higher-level
+    "NS" charm to interoperate with "VNF" charms, allowing for the execution of
+    Primitives across other charms within the same model.
+    """
+    endpoint = None
+    user = 'admin'
+    secret = None
+    port = 17070
+    loop = None
+    client = None
+    model = None
+    cacert = None
+
+    def __init__(self, user, secret, endpoint=None):
+
+        self.user = user
+        self.secret = secret
+        if endpoint is None:
+            addresses = os.environ['JUJU_API_ADDRESSES']
+            for address in addresses.split(' '):
+                self.endpoint = address
+        else:
+            self.endpoint = endpoint
+
+        # Stash the name of the model
+        self.model = os.environ['JUJU_MODEL_NAME']
+
+        # Load the ca-cert from agent.conf
+        AGENT_PATH = os.path.dirname(os.environ['JUJU_CHARM_DIR'])
+        with open("{}/agent.conf".format(AGENT_PATH), "r") as f:
+            try:
+                y = yaml.safe_load(f)
+                self.cacert = y['cacert']
+            except yaml.YAMLError as exc:
+                print("Unable to find Juju ca-cert.")
+                raise exc
+
+        # Create our event loop
+        self.loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(self.loop)
+
+    async def connect(self):
+        """Connect to the Juju controller."""
+        controller = Controller()
+
+        print(
+            "Connecting to controller... ws://{}:{} as {}/{}".format(
+                self.endpoint,
+                self.port,
+                self.user,
+                self.secret[-4:].rjust(len(self.secret), "*"),
+            )
+        )
+        await controller.connect(
+            endpoint=self.endpoint,
+            username=self.user,
+            password=self.secret,
+            cacert=self.cacert,
+        )
+
+        return controller
+
+    def __del__(self):
+        self.logout()
+
+    async def disconnect(self):
+        """Disconnect from the Juju controller."""
+        if self.client:
+            print("Disconnecting Juju controller")
+            await self.client.disconnect()
+
+    def login(self):
+        """Login to the Juju controller."""
+        if not self.client:
+            # Connect to the Juju API server
+            self.client = self.loop.run_until_complete(self.connect())
+        return self.client
+
+    def logout(self):
+        """Logout of the Juju controller."""
+
+        if self.loop:
+            print("Disconnecting from API")
+            self.loop.run_until_complete(self.disconnect())
+
+    def FormatApplicationName(self, *args):
+        """
+        Generate a Juju-compatible Application name
+
+        :param args tuple: Positional arguments to be used to construct the
+        application name.
+
+        Limitations::
+        - Only accepts characters a-z and non-consequitive dashes (-)
+        - Application name should not exceed 50 characters
+
+        Examples::
+
+            FormatApplicationName("ping_pong_ns", "ping_vnf", "a")
+        """
+        appname = ""
+        for c in "-".join(list(args)):
+            if c.isdigit():
+                c = chr(97 + int(c))
+            elif not c.isalpha():
+                c = "-"
+            appname += c
+
+        return re.sub('-+', '-', appname.lower())
+
+    def GetApplicationName(self, nsr_name, vnf_name, vnf_member_index):
+        """Get the runtime application name of a VNF/VDU.
+
+        This will generate an application name matching the name of the deployed charm,
+        given the right parameters.
+
+        :param nsr_name str: The name of the running Network Service, as specified at instantiation.
+        :param vnf_name str: The name of the VNF or VDU
+        :param vnf_member_index: The vnf-member-index as specified in the descriptor
+        """
+
+        application_name = self.FormatApplicationName(nsr_name, vnf_member_index, vnf_name)
+
+        # This matches the logic used by the LCM
+        application_name = application_name[0:48]
+        vca_index = int(vnf_member_index) - 1
+        application_name += '-' + chr(97 + vca_index // 26) + chr(97 + vca_index % 26)
+
+        return application_name
+
+    def ExecutePrimitiveGetOutput(self, application, primitive, params={}, timeout=600):
+        """Execute a single primitive and return it's output.
+
+        This is a blocking method that will execute a single primitive and wait
+        for its completion before return it's output.
+
+        :param application str: The application name provided by `GetApplicationName`.
+        :param primitive str: The name of the primitive to execute.
+        :param params list: A list of parameters.
+        :param timeout int: A timeout, in seconds, to wait for the primitive to finish. Defaults to 600 seconds.
+        """
+        uuid = self.ExecutePrimitive(application, primitive, params)
+
+        status = None
+        output = None
+
+        starttime = time.time()
+        while(time.time() < starttime + timeout):
+            status = self.GetPrimitiveStatus(uuid)
+            if status in ['completed', 'failed']:
+                break
+            time.sleep(10)
+
+        # When the primitive is done, get the output
+        if status in ['completed', 'failed']:
+            output = self.GetPrimitiveOutput(uuid)
+
+        return output
+
+    def ExecutePrimitive(self, application, primitive, params={}):
+        """Execute a primitive.
+
+        This is a non-blocking method to execute a primitive. It will return
+        the UUID of the queued primitive execution, which you can use
+        for subsequent calls to `GetPrimitiveStatus` and `GetPrimitiveOutput`.
+
+        :param application string: The name of the application
+        :param primitive string: The name of the Primitive.
+        :param params list: A list of parameters.
+
+        :returns uuid string: The UUID of the executed Primitive
+        """
+        uuid = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        # Get the application
+        if application in model.applications:
+            app = model.applications[application]
+
+            # Execute the primitive
+            unit = app.units[0]
+            if unit:
+                action = self.loop.run_until_complete(
+                    unit.run_action(primitive, **params)
+                )
+                uuid = action.id
+                print("Executing action: {}".format(uuid))
+            self.loop.run_until_complete(
+                model.disconnect()
+            )
+        else:
+            # Invalid mapping: application not found. Raise exception
+            raise Exception("Application not found: {}".format(application))
+
+        return uuid
+
+    def GetPrimitiveStatus(self, uuid):
+        """Get the status of a Primitive execution.
+
+        This will return one of the following strings:
+        - pending
+        - running
+        - completed
+        - failed
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The status of the executed Primitive
+        """
+        status = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        status = self.loop.run_until_complete(
+            model.get_action_status(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return status[uuid]
+
+    def GetPrimitiveOutput(self, uuid):
+        """Get the output of a completed Primitive execution.
+
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The output of the execution, or None if it's still running.
+        """
+        result = None
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        result = self.loop.run_until_complete(
+            model.get_action_output(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/proxy_cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/proxy_cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..f323a3af88f3011ef9fde794cdfe343be8665abb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/proxy_cluster.py
@@ -0,0 +1,59 @@
+import socket
+
+from ops.framework import Object, StoredState
+
+
+class ProxyCluster(Object):
+
+    state = StoredState()
+
+    def __init__(self, charm, relation_name):
+        super().__init__(charm, relation_name)
+        self._relation_name = relation_name
+        self._relation = self.framework.model.get_relation(self._relation_name)
+
+        self.framework.observe(charm.on.ssh_keys_initialized, self.on_ssh_keys_initialized)
+
+        self.state.set_default(ssh_public_key=None)
+        self.state.set_default(ssh_private_key=None)
+
+    def on_ssh_keys_initialized(self, event):
+        if not self.framework.model.unit.is_leader():
+            raise RuntimeError("The initial unit of a cluster must also be a leader.")
+
+        self.state.ssh_public_key = event.ssh_public_key
+        self.state.ssh_private_key = event.ssh_private_key
+        if not self.is_joined:
+            event.defer()
+            return
+
+        self._relation.data[self.model.app][
+            "ssh_public_key"
+        ] = self.state.ssh_public_key
+        self._relation.data[self.model.app][
+            "ssh_private_key"
+        ] = self.state.ssh_private_key
+
+    @property
+    def is_joined(self):
+        return self._relation is not None
+
+    @property
+    def ssh_public_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_public_key")
+
+    @property
+    def ssh_private_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_private_key")
+
+    @property
+    def is_cluster_initialized(self):
+        return (
+            True
+            if self.is_joined
+            and self._relation.data[self.model.app].get("ssh_public_key")
+            and self._relation.data[self.model.app].get("ssh_private_key")
+            else False
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/sshproxy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2c311e5be8515a7fe19c05dfed9f042ded0576b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/charms/osm/sshproxy.py
@@ -0,0 +1,375 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# from charmhelpers.core import unitdata
+# from charmhelpers.core.hookenv import log
+
+import io
+import ipaddress
+import subprocess
+import os
+import socket
+import shlex
+import traceback
+import sys
+
+from subprocess import (
+    check_call,
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+import os
+import subprocess
+from .proxy_cluster import ProxyCluster
+
+import logging
+
+
+logger = logging.getLogger(__name__)
+
+class SSHKeysInitialized(EventBase):
+    def __init__(self, handle, ssh_public_key, ssh_private_key):
+        super().__init__(handle)
+        self.ssh_public_key = ssh_public_key
+        self.ssh_private_key = ssh_private_key
+
+    def snapshot(self):
+        return {
+            "ssh_public_key": self.ssh_public_key,
+            "ssh_private_key": self.ssh_private_key,
+        }
+
+    def restore(self, snapshot):
+        self.ssh_public_key = snapshot["ssh_public_key"]
+        self.ssh_private_key = snapshot["ssh_private_key"]
+
+
+class ProxyClusterEvents(CharmEvents):
+    ssh_keys_initialized = EventSource(SSHKeysInitialized)
+
+
+class SSHProxyCharm(CharmBase):
+
+    state = StoredState()
+    on = ProxyClusterEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        self.peers = ProxyCluster(self, "proxypeer")
+
+        # SSH Proxy actions (primitives)
+        self.framework.observe(self.on.generate_ssh_key_action, self.on_generate_ssh_key_action)
+        self.framework.observe(self.on.get_ssh_public_key_action, self.on_get_ssh_public_key_action)
+        self.framework.observe(self.on.run_action, self.on_run_action)
+        self.framework.observe(self.on.verify_ssh_credentials_action, self.on_verify_ssh_credentials_action)
+
+        self.framework.observe(self.on.proxypeer_relation_changed, self.on_proxypeer_relation_changed)
+
+    def get_ssh_proxy(self):
+        """Get the SSHProxy instance"""
+        proxy = SSHProxy(
+            hostname=self.model.config["ssh-hostname"],
+            username=self.model.config["ssh-username"],
+            password=self.model.config["ssh-password"],
+        )
+        return proxy
+
+    def on_proxypeer_relation_changed(self, event):
+        if self.peers.is_cluster_initialized and not SSHProxy.has_ssh_key():
+            pubkey = self.peers.ssh_public_key
+            privkey = self.peers.ssh_private_key
+            SSHProxy.write_ssh_keys(public=pubkey, private=privkey)
+            self.verify_credentials()
+        else:
+            event.defer()
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.verify_credentials()
+
+    def on_install(self, event):
+        SSHProxy.install()
+
+    def on_start(self, event):
+        """Called when the charm is being installed"""
+        if not self.peers.is_joined:
+            event.defer()
+            return
+
+        unit = self.model.unit
+
+        if not SSHProxy.has_ssh_key():
+            unit.status = MaintenanceStatus("Generating SSH keys...")
+            pubkey = None
+            privkey = None
+            if self.model.unit.is_leader():
+                if self.peers.is_cluster_initialized:
+                    SSHProxy.write_ssh_keys(
+                        public=self.peers.ssh_public_key,
+                        private=self.peers.ssh_private_key,
+                    )
+                else:
+                    SSHProxy.generate_ssh_key()
+                    self.on.ssh_keys_initialized.emit(
+                        SSHProxy.get_ssh_public_key(), SSHProxy.get_ssh_private_key()
+                    )
+        self.verify_credentials()
+
+    def verify_credentials(self):
+        unit = self.model.unit
+
+        # Unit should go into a waiting state until verify_ssh_credentials is successful
+        unit.status = WaitingStatus("Waiting for SSH credentials")
+        proxy = self.get_ssh_proxy()
+        verified, _ = proxy.verify_credentials()
+        if verified:
+            unit.status = ActiveStatus()
+        else:
+            unit.status = BlockedStatus("Invalid SSH credentials.")
+        return verified
+
+    #####################
+    # SSH Proxy methods #
+    #####################
+    def on_generate_ssh_key_action(self, event):
+        """Generate a new SSH keypair for this unit."""
+        if self.model.unit.is_leader():
+            if not SSHProxy.generate_ssh_key():
+                event.fail("Unable to generate ssh key")
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_get_ssh_public_key_action(self, event):
+        """Get the SSH public key for this unit."""
+        if self.model.unit.is_leader():
+            pubkey = SSHProxy.get_ssh_public_key()
+            event.set_results({"pubkey": SSHProxy.get_ssh_public_key()})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_run_action(self, event):
+        """Run an arbitrary command on the remote host."""
+        if self.model.unit.is_leader():
+            cmd = event.params["command"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(cmd)
+            event.set_results({"output": stdout})
+            if len(stderr):
+                event.fail(stderr)
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_verify_ssh_credentials_action(self, event):
+        """Verify the SSH credentials for this unit."""
+        unit = self.model.unit
+        if unit.is_leader():
+            proxy = self.get_ssh_proxy()
+            verified, stderr = proxy.verify_credentials()
+            if verified:
+                event.set_results({"verified": True})
+                unit.status = ActiveStatus()
+            else:
+                event.set_results({"verified": False, "stderr": stderr})
+                event.fail("Not verified")
+                unit.status = BlockedStatus("Invalid SSH credentials.")
+
+        else:
+            event.fail("Unit is not leader")
+            return
+
+
+class LeadershipError(ModelError):
+    def __init__(self):
+        super().__init__("not leader")
+
+class SSHProxy:
+    private_key_path = "/root/.ssh/id_sshproxy"
+    public_key_path = "/root/.ssh/id_sshproxy.pub"
+    key_type = "rsa"
+    key_bits = 4096
+
+    def __init__(self, hostname: str, username: str, password: str = ""):
+        self.hostname = hostname
+        self.username = username
+        self.password = password
+
+    @staticmethod
+    def install():
+        check_call("apt update && apt install -y openssh-client sshpass", shell=True)
+
+    @staticmethod
+    def generate_ssh_key():
+        """Generate a 4096-bit rsa keypair."""
+        if not os.path.exists(SSHProxy.private_key_path):
+            cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+                SSHProxy.key_type, SSHProxy.key_bits, SSHProxy.private_key_path,
+            )
+
+            try:
+                check_call(cmd, shell=True)
+            except CalledProcessError:
+                return False
+
+        return True
+
+    @staticmethod
+    def write_ssh_keys(public, private):
+        """Write a 4096-bit rsa keypair."""
+        with open(SSHProxy.public_key_path, "w") as f:
+            f.write(public)
+            f.close()
+        with open(SSHProxy.private_key_path, "w") as f:
+            f.write(private)
+            f.close()
+
+    @staticmethod
+    def get_ssh_public_key():
+        publickey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.public_key_path, "r") as f:
+                publickey = f.read()
+        return publickey
+
+    @staticmethod
+    def get_ssh_private_key():
+        privatekey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.private_key_path, "r") as f:
+                privatekey = f.read()
+        return privatekey
+
+    @staticmethod
+    def has_ssh_key():
+        return True if os.path.exists(SSHProxy.private_key_path) else False
+
+    def run(self, cmd: str) -> (str, str):
+        """Run a command remotely via SSH.
+
+        Note: The previous behavior was to run the command locally if SSH wasn't
+        configured, but that can lead to cases where execution succeeds when you'd
+        expect it not to.
+        """
+        if isinstance(cmd, str):
+            cmd = shlex.split(cmd)
+
+        host = self._get_hostname()
+        user = self.username
+        passwd = self.password
+        key = self.private_key_path
+
+        # Make sure we have everything we need to connect
+        if host and user:
+            return self.ssh(cmd)
+
+        raise Exception("Invalid SSH credentials.")
+
+    def scp(self, source_file, destination_file):
+        """Execute an scp command. Requires a fully qualified source and
+        destination.
+
+        :param str source_file: Path to the source file
+        :param str destination_file: Path to the destination file
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "scp",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            "-B",
+        ]
+        destination = "{}@{}:{}".format(self.username, self.hostname, destination_file)
+        cmd.extend([source_file, destination])
+        subprocess.run(cmd, check=True)
+
+    def ssh(self, command):
+        """Run a command remotely via SSH.
+
+        :param list(str) command: The command to execute
+        :return: tuple: The stdout and stderr of the command execution
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+
+        destination = "{}@{}".format(self.username, self.hostname)
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "ssh",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            destination,
+        ]
+        cmd.extend(command)
+        output = subprocess.run(cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return (output.stdout.decode("utf-8").strip(), output.stderr.decode("utf-8").strip())
+
+    def verify_credentials(self):
+        """Verify the SSH credentials.
+        
+        :return (bool, str): Verified, Stderr
+        """
+        verified = False
+        try:
+            (stdout, stderr) = self.run("hostname")
+            verified = True
+        except CalledProcessError as e:
+            stderr = "Command failed: {} ({})".format(" ".join(e.cmd), str(e.output))
+        except (TimeoutError, socket.timeout):
+            stderr = "Timeout attempting to reach {}".format(self._get_hostname())
+        except Exception as error:
+            tb = traceback.format_exc()
+            stderr = "Unhandled exception: {}".format(tb)
+        return verified, stderr
+
+    ###################
+    # Private methods #
+    ###################
+    def _get_hostname(self):
+        """Get the hostname for the ssh target.
+
+        HACK: This function was added to work around an issue where the
+        ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+        is the floating ip, and the second the non-floating ip, for an Openstack
+        instance.
+        """
+        return self.hostname.split(";")[0]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..d898de859fc444814bc19a7f8f0caaaec6f7e5f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/charm.py
@@ -0,0 +1,575 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """A base class for events that trigger because of a Juju hook firing."""
+
+
+class ActionEvent(EventBase):
+    """A base class for events that trigger when a user asks for an Action to be run.
+
+    To read the parameters for the action, see the instance variable `params`.
+    To respond with the result of the action, call `set_results`. To add progress
+    messages that are visible as the action is progressing use `log`.
+
+    :ivar params: The parameters passed to the action (read by action-get)
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the user is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by Charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Represents the `install` hook from Juju."""
+
+
+class StartEvent(HookEvent):
+    """Represents the `start` hook from Juju."""
+
+
+class StopEvent(HookEvent):
+    """Represents the `stop` hook from Juju."""
+
+
+class RemoveEvent(HookEvent):
+    """Represents the `remove` hook from Juju. """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Represents the `config-changed` hook from Juju."""
+
+
+class UpdateStatusEvent(HookEvent):
+    """Represents the `update-status` hook from Juju."""
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Represents the `upgrade-charm` hook from Juju.
+
+    This will be triggered when a user has run `juju upgrade-charm`. It is run after Juju
+    has unpacked the upgraded charm code, and so this event will be handled with new code.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Represents the `pre-series-upgrade` hook from Juju.
+
+    This happens when a user has run `juju upgrade-series MACHINE prepare` and
+    will fire for each unit that is running on the machine, telling them that
+    the user is preparing to upgrade the Machine's series (eg trusty->bionic).
+    The charm should take actions to prepare for the upgrade (a database charm
+    would want to write out a version-independent dump of the database, so that
+    when a new version of the database is available in a new series, it can be
+    used.)
+    Once all units on a machine have run `pre-series-upgrade`, the user will
+    initiate the steps to actually upgrade the machine (eg `do-release-upgrade`).
+    When the upgrade has been completed, the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Represents the `post-series-upgrade` hook from Juju.
+
+    This is run after the user has done a distribution upgrade (or rolled back
+    and kept the same series). It is called in response to
+    `juju upgrade-series MACHINE complete`. Charms are expected to do whatever
+    steps are necessary to reconfigure their applications for the new series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Represents the `leader-elected` hook from Juju.
+
+    Juju will trigger this when a new lead unit is chosen for a given application.
+    This represents the leader of the charm information (not necessarily the primary
+    of a running application). The main utility is that charm authors can know
+    that only one unit will be a leader at any given time, so they can do
+    configuration, etc, that would otherwise require coordination between units.
+    (eg, selecting a password for a new relation)
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Represents the `leader-settings-changed` hook from Juju.
+
+    Deprecated. This represents when a lead unit would call `leader-set` to inform
+    the other units of an application that they have new information to handle.
+    This has been deprecated in favor of using a Peer relation, and having the
+    leader set a value in the Application data bag for that peer relation.
+    (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Represents the `collect-metrics` hook from Juju.
+
+    Note that events firing during a CollectMetricsEvent are currently
+    sandboxed in how they can interact with Juju. To report metrics
+    use :meth:`.add_metrics`.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Charmers should not be creating RelationEvents directly. The events will be
+    generated by the framework from Juju related events. Users can observe them
+    from the various `CharmBase.on[relation_name].relation_*` events.
+
+    Attributes:
+        relation: The Relation involved in this event
+        app: The remote application that has triggered this event
+        unit: The remote unit that has triggered this event. This may be None
+              if the relation event was triggered as an Application level event
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by Charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by Charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Represents the `relation-created` hook from Juju.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Represents the `relation-joined` hook from Juju.
+
+    This is triggered whenever a new unit of a related application joins the relation.
+    (eg, a unit was added to an existing related app, or a new relation was established
+    with an application that already had units.)
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Represents the `relation-changed` hook from Juju.
+
+    This is triggered whenever there is a change to the data bucket for a related
+    application or unit. Look at `event.relation.data[event.unit/app]` to see the
+    new information.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Represents the `relation-departed` hook from Juju.
+
+    This is the inverse of the RelationJoinedEvent, representing when a unit
+    is leaving the relation (the unit is being removed, the app is being removed,
+    the relation is being removed). It is fired once for each unit that is
+    going away.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Represents the `relation-broken` hook from Juju.
+
+    If a relation is being removed (`juju remove-relation` or `juju remove-application`),
+    once all the units have been removed, RelationBrokenEvent will fire to signal
+    that the relationship has been fully terminated.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing Storage related events."""
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Represents the `storage-attached` hook from Juju.
+
+    Called when new storage is available for the charm to use.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Represents the `storage-detaching` hook from Juju.
+
+    Called when storage a charm has been using is going away.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """The events that are generated by Juju in response to the lifecycle of an application."""
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the Charm overall.
+
+    Usually this initialization is done by ops.main.main() rather than Charm authors
+    directly instantiating a Charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            Charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+    """
+
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """CharmMeta of this charm.
+        """
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the Charm as it is running.
+        """
+        return self.framework.charm_dir
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from metadata.yaml and/or actions.yaml. Generally charms will
+    define this information, rather than reading it at runtime. This class is
+    mostly for the framework to understand what the charm has defined.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by Charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/framework.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..b7c4749ff2b5bfb4f354bf1a8d4cd6ed64cf0da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/framework.py
@@ -0,0 +1,1067 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(ObjectEvents):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+        # breakpoint(); if Python < 3.7, this doesn't affect anything
+        sys.breakpointhook = self.breakpoint
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse once the env var, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/jujuversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..b2b8177dbe396f0d8c46b86e26af6b4e54ea046d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/jujuversion.py
@@ -0,0 +1,98 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if not v:
+            raise RuntimeError('environ has no JUJU_VERSION')
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edb9fcacea6f0173aed9f07ca8a683cfead989cc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/lib/__init__.py
@@ -0,0 +1,194 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import os
+import re
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except OSError:
+            continue
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except OSError:
+                continue
+            finder = get_importer(opslib)
+            if finder is None or not hasattr(finder, 'find_spec'):
+                continue
+            for lib_dir in lib_dirs:
+                spec = finder.find_spec(lib_dir)
+                if spec is None:
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    continue
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        return None
+
+    _expected = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_expected):
+                    break
+                if n > _MAX_LIB_LINES:
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _expected:
+                    value = literal_eval(value)
+                    if not isinstance(value, _expected[key]):
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_expected):
+                    return None
+    except Exception:
+        return None
+
+    return _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {0.name} by {0.author}, API {0.api}, patch {0.patch}>".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/log.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aac5543aec4d84dc393e79b772a30284712d6d4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/log.py
@@ -0,0 +1,51 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..6dc31c3575044796e8fe1f61b8415395689d6339
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/main.py
@@ -0,0 +1,348 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import logging
+import os
+import subprocess
+import sys
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows.
+        # For Windows it is always an absolute path (any symlinks are resolved)
+        # while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(sys.argv[0])
+
+        if 'JUJU_DISPATCH_PATH' in os.environ and (charm_dir / 'dispatch').exists():
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk"""
+
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = self._charm_dir / self._dispatch_path
+        if not dispatch_path.exists():
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == self._exec_path.resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning(
+                "Legacy %s exited with status %d.",
+                self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """"Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def main(charm_class, use_juju_for_storage=False):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96e89154ea9cec2b62a4fab4649412e115c304e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/model.py
@@ -0,0 +1,1237 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+
+    Attributes:
+        unit: A :class:`Unit` that represents the unit that is running this code (eg yourself)
+        app: A :class:`Application` that represents the application this unit is a part of.
+        relations: Mapping of endpoint to list of :class:`Relation` answering the question
+            "what am I currently related to". See also :meth:`.get_relation`
+        config: A dict of the config for the current application.
+        resources: Access to resources for this charm. Use ``model.resources.fetch(resource_name)``
+            to get the path on disk where the resource can be found.
+        storages: Mapping of storage_name to :class:`Storage` for the storage points defined in
+            metadata.yaml
+        pod: Used to get access to ``model.pod.set_spec`` to set the container specification
+            for Kubernetes charms.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(self._backend.unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworKInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info['bind-addresses']:
+            interface_name = interface_info['interface-name']
+            for address_info in interface_info['addresses']:
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info['ingress-addresses']:
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info['egress-subnets']:
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        return self.interfaces[0].address
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        return self.ingress_addresses[0]
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        self.address = ipaddress.ip_address(address_info['value'])
+        cidr = address_info['cidr']
+        if not cidr:
+            # The cidr field may be empty, see LP: #1864102.
+            # In this case, make it a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address_info['value'])
+        else:
+            self.subnet = ipaddress.ip_network(cidr)
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """"Represents a storage as defined in metadata.yaml
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            app: A boolean indicating whether the status should be set for a unit or an
+                application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/storage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/storage.py
new file mode 100755
index 0000000000000000000000000000000000000000..d4310ce1cfbb707c6278b70f84a9751da3ce07af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/storage.py
@@ -0,0 +1,318 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)"""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: typing.Optional[str]) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """"Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        return
+
+    def commit(self):
+        return
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str):
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    @staticmethod
+    def is_available() -> bool:
+        """Check if Juju state storage is available.
+
+        This checks if there is a 'state-get' executable in PATH.
+        """
+        p = shutil.which('state-get')
+        return p is not None
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf-8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        subprocess.run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = subprocess.run(
+            ["state-get", key],
+            stdout=subprocess.PIPE,
+            check=True,
+        )
+        if p.stdout == b'' or p.stdout == b'\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        subprocess.run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/testing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/testing.py
new file mode 100755
index 0000000000000000000000000000000000000000..b4b3fe071216238007c9f3847ca9556be626bf6b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/testing.py
@@ -0,0 +1,586 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pathlib
+from textwrap import dedent
+import tempfile
+import typing
+import yaml
+import weakref
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None):
+        # TODO: jam 2020-03-05 We probably want to take config as a parameter as well, since
+        #       it would define the default values of config that the charm would see.
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._lazy_resource_dir = None
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    @property
+    def _resource_dir(self) -> pathlib.Path:
+        if self._lazy_resource_dir is not None:
+            return self._lazy_resource_dir
+
+        self.__resource_dir = tempfile.TemporaryDirectory()
+        self._lazy_resource_dir = pathlib.Path(self.__resource_dir.name)
+        self._finalizer = weakref.finalize(self, self.__resource_dir.cleanup)
+        return self._lazy_resource_dir
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling begin(), there is no Charm instance, so changes to the Model won't emit
+        events. You must call begin before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+        resource_dir = self._resource_dir / resource_name
+        resource_dir.mkdir(exist_ok=True)
+        resource_file = resource_dir / "contents.yaml"
+        with resource_file.open('wt', encoding='utf8') as resource_yaml:
+            yaml.dump(contents, resource_yaml)
+        self._backend._resources_map[resource_name] = resource_file
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return rel_id
+        relation = self._model.get_relation(relation_name, rel_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+        return rel_id
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event and a `relation_changed` event.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        return self._resources_map[resource_name]
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..15e5478555ee0fa948bfb0ad57cc79ba7cef3721
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/lib/ops/version.py
@@ -0,0 +1,50 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from pathlib import Path
+
+__all__ = ('version',)
+
+_FALLBACK = '0.8'  # this gets bumped after release
+
+
+def _get_version():
+    version = _FALLBACK + ".dev0+unknown"
+
+    p = Path(__file__).parent
+    if (p.parent / '.git').exists():
+        try:
+            proc = subprocess.run(
+                ['git', 'describe', '--tags', '--dirty'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.DEVNULL,
+                cwd=p,
+                check=True)
+        except Exception:
+            pass
+        else:
+            version = proc.stdout.strip().decode('utf8')
+            if '-' in version:
+                # version will look like <tag>-<#commits>-g<hex>[-dirty]
+                # in terms of PEP 440, the tag we'll make sure is a 'public version identifier';
+                # everything after the first - needs to be a 'local version'
+                public, local = version.split('-', 1)
+                version = public + '+' + local.replace('-', '.')
+                # version now <tag>+<#commits>.g<hex>[.dirty]
+                # which is PEP440-compliant (as long as <tag> is :-)
+    return version
+
+
+version = _get_version()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/metadata.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c331b60d88dcfc3f1c675e24282dacdf8ec4ffdb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/metadata.yaml
@@ -0,0 +1,11 @@
+name: vyos-config
+summary: A proxy charm to configure VyOS Router
+maintainer: David García <david.garcia@canonical.com>
+description: |
+  Charm to configure VyOS PNF
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.bzrignore b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.bzrignore
new file mode 100644
index 0000000000000000000000000000000000000000..398f08fcbfae019fbf1fe40e9b1d49f8384393d9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.bzrignore
@@ -0,0 +1,17 @@
+*.pyc
+__pycache__/
+dist/
+build/
+MANIFEST
+charmhelpers.egg-info/
+charmhelpers/version.py
+.coverage
+.env/
+coverage.xml
+docs/_build
+.idea
+.project
+.pydevproject
+.settings
+.venv
+.venv3
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.gitignore b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..9b13d46d0a42cd97ff428ffa4f4ba0a9d9946806
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.gitignore
@@ -0,0 +1,125 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv*
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+*.pyc
+__pycache__/
+dist/
+build/
+MANIFEST
+charmhelpers.egg-info/
+charmhelpers/version.py
+.coverage
+.env/
+coverage.xml
+docs/_build
+.idea
+.project
+.pydevproject
+.settings
+.venv
+.venv3
+.bzr
+.unit-state.db
+
+AUTHORS
+ChangeLog
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.travis.yml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.travis.yml
new file mode 100644
index 0000000000000000000000000000000000000000..7e67f092d935333e2e9324bc612b069761322bd6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/.travis.yml
@@ -0,0 +1,32 @@
+dist: xenial
+sudo: required
+language: python
+addons:
+  snaps:
+  - name: juju
+    classic: true
+    channel: stable
+before_install:
+   - sudo apt -qq update
+   - sudo apt install -y libapt-pkg-dev  # For python-apt wheel build
+# NOTE(beisner): Avoid test pollution by not enabling system site packages.
+virtualenv:
+  system_site_packages: false
+install:
+  - pip install tox
+matrix:
+  include:
+    - python: 2.7
+      env: ENV=pep8,py2
+    - python: 3.4
+      env: ENV=pep8,py3
+    - python: 3.5
+      env: ENV=pep8,py3
+    - python: 3.6
+      env: ENV=pep8,py3
+    - python: 3.7
+      env: ENV=pep8,py3
+    - python: 3.8
+      env: ENV=pep8,py3
+script:
+  - tox -c tox.ini -e $ENV
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/HACKING.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/HACKING.md
new file mode 100644
index 0000000000000000000000000000000000000000..d9d5996d0fc12622e63039db3b038ddfb5272362
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/HACKING.md
@@ -0,0 +1,102 @@
+# Hacking on charmhelpers
+
+## Run testsuite (tox method)
+
+CAUTION:  the charm-helpers library has some unit tests which do unsavory things
+such as making real, unmocked calls out to sudo foo, juju binaries, and perhaps
+other things.  This is not ideal for a number of reasons.  One of those reasons
+is that it pollutes the test runner (your) system.
+
+The current recommendation for testing locally is to do so in a fresh Xenial
+(16.04) lxc container.  16.04 is selected for consistency with what is available
+in the Travis CI test gates.  As of this writing, 18.04 is not available there.
+
+The fresh Xenial lxc system container will need to have the following packages
+installed in order to satisfy test runner dependencies:
+
+    sudo apt install git bzr tox libapt-pkg-dev python-dev python3-dev build-essential juju -y
+
+The tests can be executed as follows:
+
+    tox -e pep8
+    tox -e py3
+    tox -e py2
+
+See also:  .travis.yaml for what is happening in the test gate.
+
+## Run testsuite (legacy Makefile method)
+
+    make test
+
+Run `make` without arguments for more options.
+
+## Test it in a charm
+
+Use following instructions to build a charm that uses your own development branch of
+charmhelpers.
+
+Step 1: Make sure your version of charmhelpers is recognised as the latest version by
+by appending `dev0` to the version number in the `VERSION` file.
+
+Step 2: Create an override file `override-wheelhouse.txt` that points to your own
+charmhelpers branch. *The format of this file is the same as pip's
+[`requirements.txt`](https://pip.pypa.io/en/stable/reference/pip_install/#requirements-file-format)
+file.
+
+    # Override charmhelpers by the version found in folder
+    -e /path/to/charmhelpers
+    # Or point it to a github repo with
+    -e git+https://github.com/<myuser>/charm-helpers#egg=charmhelpers
+
+Step 3: Build the charm specifying the override file. *You might need to install the
+candidate channel of the charm snap*
+
+    charm build <mycharm> -w wheelhouse-overrides.txt
+
+Now when you deploy your charm, it will use your own branch of charmhelpers.
+
+*Note: If you want to verify this or change the charmhelpers code on a built
+charm, get the path of the installed charmhelpers by running following command.*
+
+    python3 -c "import charmhelpers; print(charmhelpers.__file__)"
+
+
+# Hacking on Docs
+
+Install html doc dependencies:
+
+```bash
+sudo apt-get install python-flake8 python-shelltoolbox python-tempita \
+python-nose python-mock python-testtools python-jinja2 python-coverage \
+python-git python-netifaces python-netaddr python-pip zip
+```
+
+To build the html documentation:
+
+```bash
+make docs
+```
+
+To browse the html documentation locally:
+
+```bash
+make docs
+cd docs/_build/html
+python -m SimpleHTTPServer 8765
+# point web browser to http://localhost:8765
+```
+
+To build and upload package and doc updates to PyPI:
+
+```bash
+make release
+# note: if the package version already exists on PyPI
+# this command will upload doc updates only
+```
+
+# PyPI Package and Docs
+
+The published package and docs currently live at:
+
+    https://pypi.python.org/pypi/charmhelpers
+    http://pythonhosted.org/charmhelpers/
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/MANIFEST.in b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/MANIFEST.in
new file mode 100644
index 0000000000000000000000000000000000000000..72bbf0ab78b68d6d0ebb8d354dd993e751d4be89
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/MANIFEST.in
@@ -0,0 +1,7 @@
+include *.txt
+include Makefile
+include VERSION
+include MANIFEST.in
+include scripts/*
+include README.rst
+recursive-include debian *
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/Makefile b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/Makefile
new file mode 100644
index 0000000000000000000000000000000000000000..8771f31a57b1af939e73a1dfe8c7e56be195cc87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/Makefile
@@ -0,0 +1,89 @@
+PROJECT=charmhelpers
+PYTHON := /usr/bin/env python
+SUITE=unstable
+TESTS=tests/
+
+all:
+	@echo "make source - Create source package"
+	@echo "make sdeb - Create debian source package"
+	@echo "make deb - Create debian package"
+	@echo "make clean"
+	@echo "make userinstall - Install locally"
+	@echo "make docs - Build html documentation"
+	@echo "make release - Build and upload package and docs to PyPI"
+	@echo "make test"
+
+sdeb: source
+	scripts/build source
+
+deb: source
+	scripts/build
+
+source: setup.py
+	scripts/update-revno
+	python setup.py sdist
+
+clean:
+	-python setup.py clean
+	rm -rf build/ MANIFEST
+	find . -name '*.pyc' -delete
+	find . -name '__pycache__' -delete
+	rm -rf dist/*
+	rm -rf .venv
+	rm -rf .venv3
+	(which dh_clean && dh_clean) || true
+
+userinstall:
+	scripts/update-revno
+	python setup.py install --user
+
+
+.venv:
+	dpkg-query -W -f='$${status}' gcc python-dev python-virtualenv 2>/dev/null | grep --invert-match "not-installed" || sudo apt-get install -y python-dev python-virtualenv
+	virtualenv .venv --system-site-packages
+	.venv/bin/pip install -U pip
+	.venv/bin/pip install -I -r test-requirements.txt
+	.venv/bin/pip install bzr
+
+.venv3:
+	dpkg-query -W -f='$${status}' gcc python3-dev python-virtualenv python3-apt 2>/dev/null | grep --invert-match "not-installed" || sudo apt-get install -y python3-dev python-virtualenv python3-apt
+	virtualenv .venv3 --python=python3 --system-site-packages
+	.venv3/bin/pip install -U pip
+	.venv3/bin/pip install -I -r test-requirements.txt
+
+# Note we don't even attempt to run tests if lint isn't passing.
+test: lint test2 test3
+	@echo OK
+
+test2:
+	@echo Starting Py2 tests...
+	.venv/bin/nosetests -s --nologcapture tests/
+
+test3:
+	@echo Starting Py3 tests...
+	.venv3/bin/nosetests -s --nologcapture tests/
+
+ftest: lint
+	@echo Starting fast tests...
+	.venv/bin/nosetests --attr '!slow' --nologcapture tests/
+	.venv3/bin/nosetests --attr '!slow' --nologcapture tests/
+
+lint: .venv .venv3
+	@echo Checking for Python syntax...
+	@.venv/bin/flake8 --ignore=E402,E501,W504 $(PROJECT) $(TESTS) tools/ \
+	    && echo Py2 OK
+	@.venv3/bin/flake8 --ignore=E402,E501,W504 $(PROJECT) $(TESTS) tools/ \
+	    && echo Py3 OK
+
+docs:
+	- [ -z "`dpkg -l | grep python-sphinx`" ] && sudo apt-get install python-sphinx -y
+	- [ -z "`dpkg -l | grep python-pip`" ] && sudo apt-get install python-pip -y
+	- [ -z "`pip list | grep -i sphinx-pypi-upload`" ] && sudo pip install sphinx-pypi-upload
+	- [ -z "`pip list | grep -i sphinx_rtd_theme`" ] && sudo pip install sphinx_rtd_theme
+	cd docs && make html && cd -
+.PHONY: docs
+
+release: docs
+	$(PYTHON) setup.py sdist upload upload_sphinx
+
+build: test lint docs
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/README.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..b8fb15eaabf79cb949b703301d6b89bbb0cb6b5e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/README.rst
@@ -0,0 +1,52 @@
+CharmHelpers |badge|
+--------------------
+
+.. |badge| image:: https://travis-ci.org/juju/charm-helpers.svg?branch=master
+    :target: https://travis-ci.org/juju/charm-helpers
+
+Overview
+========
+
+CharmHelpers provides an opinionated set of tools for building Juju charms.
+
+The full documentation is available online at: https://charm-helpers.readthedocs.io/
+
+Common Usage Examples
+=====================
+
+* interaction with charm-specific Juju unit agents via hook tools;
+* processing of events and execution of decorated functions based on event names;
+* handling of persistent storage between independent charm invocations;
+* rendering of configuration file templates;
+* modification of system configuration files;
+* installation of packages;
+* retrieval of machine-specific details;
+* implementation of application-specific code reused in similar charms.
+
+Why Python?
+===========
+
+* Python is an extremely popular, easy to learn, and powerful language which is also common in automation tools;
+* An interpreted language helps with charm portability across different CPU architectures;
+* Doesn't require debugging symbols (just use pdb in-place);
+* An author or a user is able to make debugging changes without recompiling a charm.
+
+Dev/Test
+========
+
+See the HACKING.md file for information about testing and development.
+
+License
+=======
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/README b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/README
new file mode 100644
index 0000000000000000000000000000000000000000..df4a50484ea9dfca98c4dc63a94531e3449c98aa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/README
@@ -0,0 +1,4 @@
+This directory contains executables for accessing charmhelpers functionality
+
+
+Please see charmhelpers.cli for the recommended way to add scripts.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/chlp b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/chlp
new file mode 100755
index 0000000000000000000000000000000000000000..0c1c38dc15039191fd3ea04fc7ea740764ea974b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/chlp
@@ -0,0 +1,8 @@
+#!/usr/bin/env python
+
+from charmhelpers.cli import cmdline
+from charmhelpers.cli.commands import *
+
+
+if __name__ == '__main__':
+    cmdline.run()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/charmsupport/charmsupport b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/charmsupport/charmsupport
new file mode 100755
index 0000000000000000000000000000000000000000..7a28beb3867db4b517ca98bd048303aaa727105a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/charmsupport/charmsupport
@@ -0,0 +1,31 @@
+#!/usr/bin/env python
+
+import argparse
+from charmhelpers.contrib.charmsupport import execd
+
+
+def run_execd(args):
+    execd.execd_run(args.module, args.dir, die_on_error=True)
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(description='Perform common charm tasks')
+    subparsers = parser.add_subparsers(help='Commands')
+
+    execd_parser = subparsers.add_parser('execd',
+                                         help='Execute a directory of commands')
+    execd_parser.add_argument('--module', default='charm-pre-install',
+                              help='module to run (default: charm-pre-install)')
+    execd_parser.add_argument('--dir',
+                              help="Override the exec.d directory path")
+    execd_parser.set_defaults(func=run_execd)
+
+    return parser.parse_args()
+
+
+def main():
+    arguments = parse_args()
+    arguments.func(arguments)
+
+if __name__ == '__main__':
+    exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/saltstack/salt-call b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/saltstack/salt-call
new file mode 100755
index 0000000000000000000000000000000000000000..5b8a8f39355447bd23c569c32c2987a9c494fe73
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/bin/contrib/saltstack/salt-call
@@ -0,0 +1,11 @@
+#!/usr/bin/env python
+'''
+Directly call a salt command in the modules, does not require a running salt
+minion to run.
+'''
+
+from salt.scripts import salt_call
+
+
+if __name__ == '__main__':
+    salt_call()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61ef90719b5d5d759de1a6b80a1ea748d8bb0911
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/__init__.py
@@ -0,0 +1,97 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Bootstrap charm-helpers, installing its dependencies if necessary using
+# only standard libraries.
+from __future__ import print_function
+from __future__ import absolute_import
+
+import functools
+import inspect
+import subprocess
+import sys
+
+try:
+    import six  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-six'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-six'])
+    import six  # NOQA:F401
+
+try:
+    import yaml  # NOQA:F401
+except ImportError:
+    if sys.version_info.major == 2:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python-yaml'])
+    else:
+        subprocess.check_call(['apt-get', 'install', '-y', 'python3-yaml'])
+    import yaml  # NOQA:F401
+
+
+# Holds a list of mapping of mangled function names that have been deprecated
+# using the @deprecate decorator below.  This is so that the warning is only
+# printed once for each usage of the function.
+__deprecated_functions = {}
+
+
+def deprecate(warning, date=None, log=None):
+    """Add a deprecation warning the first time the function is used.
+    The date, which is a string in semi-ISO8660 format indicate the year-month
+    that the function is officially going to be removed.
+
+    usage:
+
+    @deprecate('use core/fetch/add_source() instead', '2017-04')
+    def contributed_add_source_thing(...):
+        ...
+
+    And it then prints to the log ONCE that the function is deprecated.
+    The reason for passing the logging function (log) is so that hookenv.log
+    can be used for a charm if needed.
+
+    :param warning:  String to indicat where it has moved ot.
+    :param date: optional sting, in YYYY-MM format to indicate when the
+                 function will definitely (probably) be removed.
+    :param log: The log function to call to log.  If not, logs to stdout
+    """
+    def wrap(f):
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            try:
+                module = inspect.getmodule(f)
+                file = inspect.getsourcefile(f)
+                lines = inspect.getsourcelines(f)
+                f_name = "{}-{}-{}..{}-{}".format(
+                    module.__name__, file, lines[0], lines[-1], f.__name__)
+            except (IOError, TypeError):
+                # assume it was local, so just use the name of the function
+                f_name = f.__name__
+            if f_name not in __deprecated_functions:
+                __deprecated_functions[f_name] = True
+                s = "DEPRECATION WARNING: Function {} is being removed".format(
+                    f.__name__)
+                if date:
+                    s = "{} on/around {}".format(s, date)
+                if warning:
+                    s = "{} : {}".format(s, warning)
+                if log:
+                    log(s)
+                else:
+                    print(s)
+            return f(*args, **kwargs)
+        return wrapped_f
+    return wrap
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/README.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/README.rst
new file mode 100644
index 0000000000000000000000000000000000000000..f7901c09c79c268d353825776a74072a7ee4dee7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/README.rst
@@ -0,0 +1,57 @@
+==========
+Commandant
+==========
+
+-----------------------------------------------------
+Automatic command-line interfaces to Python functions
+-----------------------------------------------------
+
+One of the benefits of ``libvirt`` is the uniformity of the interface: the C  API (as well as the bindings in other languages) is a set of functions that accept parameters that are nearly identical to the command-line arguments.  If you run ``virsh``, you get an interactive command prompt that supports all of the same commands that your shell scripts use as ``virsh`` subcommands.
+
+Command execution and stdio manipulation is the greatest common factor across all development systems in the POSIX environment.  By exposing your functions as commands that manipulate streams of text, you can make life easier for all the Ruby and Erlang and Go programmers in your life.
+
+Goals
+=====
+
+* Single decorator to expose a function as a command.
+  * now two decorators - one "automatic" and one that allows authors to manipulate the arguments for fine-grained control.(MW)
+* Automatic analysis of function signature through ``inspect.getargspec()``
+* Command argument parser built automatically with ``argparse``
+* Interactive interpreter loop object made with ``Cmd``
+* Options to output structured return value data via ``pprint``, ``yaml`` or ``json`` dumps.
+
+Other Important Features that need writing
+------------------------------------------
+
+* Help and Usage documentation can be automatically generated, but it will be important to let users override this behaviour
+* The decorator should allow specifying further parameters to the parser's add_argument() calls, to specify types or to make arguments behave as boolean flags, etc.
+    - Filename arguments are important, as good practice is for functions to accept file objects as parameters.
+    - choices arguments help to limit bad input before the function is called
+* Some automatic behaviour could make for better defaults, once the user can override them.
+    - We could automatically detect arguments that default to False or True, and automatically support --no-foo for foo=True.
+    - We could automatically support hyphens as alternates for underscores
+    - Arguments defaulting to sequence types could support the ``append`` action.
+
+
+-----------------------------------------------------
+Implementing subcommands
+-----------------------------------------------------
+
+(WIP)
+
+So as to avoid dependencies on the cli module, subcommands should be defined separately from their implementations. The recommmendation would be to place definitions into separate modules near the implementations which they expose.
+
+Some examples::
+
+    from charmhelpers.cli import CommandLine
+    from charmhelpers.payload import execd
+    from charmhelpers.foo import bar
+
+    cli = CommandLine()
+
+    cli.subcommand(execd.execd_run)
+
+    @cli.subcommand_builder("bar", help="Bar baz qux")
+    def barcmd_builder(subparser):
+        subparser.add_argument('argument1', help="yackety")
+        return bar
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..389b490f4eec27f18118ab6a5f3f529dbf2e9ecc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/__init__.py
@@ -0,0 +1,189 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import argparse
+import sys
+
+from six.moves import zip
+
+import charmhelpers.core.unitdata
+
+
+class OutputFormatter(object):
+    def __init__(self, outfile=sys.stdout):
+        self.formats = (
+            "raw",
+            "json",
+            "py",
+            "yaml",
+            "csv",
+            "tab",
+        )
+        self.outfile = outfile
+
+    def add_arguments(self, argument_parser):
+        formatgroup = argument_parser.add_mutually_exclusive_group()
+        choices = self.supported_formats
+        formatgroup.add_argument("--format", metavar='FMT',
+                                 help="Select output format for returned data, "
+                                      "where FMT is one of: {}".format(choices),
+                                 choices=choices, default='raw')
+        for fmt in self.formats:
+            fmtfunc = getattr(self, fmt)
+            formatgroup.add_argument("-{}".format(fmt[0]),
+                                     "--{}".format(fmt), action='store_const',
+                                     const=fmt, dest='format',
+                                     help=fmtfunc.__doc__)
+
+    @property
+    def supported_formats(self):
+        return self.formats
+
+    def raw(self, output):
+        """Output data as raw string (default)"""
+        if isinstance(output, (list, tuple)):
+            output = '\n'.join(map(str, output))
+        self.outfile.write(str(output))
+
+    def py(self, output):
+        """Output data as a nicely-formatted python data structure"""
+        import pprint
+        pprint.pprint(output, stream=self.outfile)
+
+    def json(self, output):
+        """Output data in JSON format"""
+        import json
+        json.dump(output, self.outfile)
+
+    def yaml(self, output):
+        """Output data in YAML format"""
+        import yaml
+        yaml.safe_dump(output, self.outfile)
+
+    def csv(self, output):
+        """Output data as excel-compatible CSV"""
+        import csv
+        csvwriter = csv.writer(self.outfile)
+        csvwriter.writerows(output)
+
+    def tab(self, output):
+        """Output data in excel-compatible tab-delimited format"""
+        import csv
+        csvwriter = csv.writer(self.outfile, dialect=csv.excel_tab)
+        csvwriter.writerows(output)
+
+    def format_output(self, output, fmt='raw'):
+        fmtfunc = getattr(self, fmt)
+        fmtfunc(output)
+
+
+class CommandLine(object):
+    argument_parser = None
+    subparsers = None
+    formatter = None
+    exit_code = 0
+
+    def __init__(self):
+        if not self.argument_parser:
+            self.argument_parser = argparse.ArgumentParser(description='Perform common charm tasks')
+        if not self.formatter:
+            self.formatter = OutputFormatter()
+            self.formatter.add_arguments(self.argument_parser)
+        if not self.subparsers:
+            self.subparsers = self.argument_parser.add_subparsers(help='Commands')
+
+    def subcommand(self, command_name=None):
+        """
+        Decorate a function as a subcommand. Use its arguments as the
+        command-line arguments"""
+        def wrapper(decorated):
+            cmd_name = command_name or decorated.__name__
+            subparser = self.subparsers.add_parser(cmd_name,
+                                                   description=decorated.__doc__)
+            for args, kwargs in describe_arguments(decorated):
+                subparser.add_argument(*args, **kwargs)
+            subparser.set_defaults(func=decorated)
+            return decorated
+        return wrapper
+
+    def test_command(self, decorated):
+        """
+        Subcommand is a boolean test function, so bool return values should be
+        converted to a 0/1 exit code.
+        """
+        decorated._cli_test_command = True
+        return decorated
+
+    def no_output(self, decorated):
+        """
+        Subcommand is not expected to return a value, so don't print a spurious None.
+        """
+        decorated._cli_no_output = True
+        return decorated
+
+    def subcommand_builder(self, command_name, description=None):
+        """
+        Decorate a function that builds a subcommand. Builders should accept a
+        single argument (the subparser instance) and return the function to be
+        run as the command."""
+        def wrapper(decorated):
+            subparser = self.subparsers.add_parser(command_name)
+            func = decorated(subparser)
+            subparser.set_defaults(func=func)
+            subparser.description = description or func.__doc__
+        return wrapper
+
+    def run(self):
+        "Run cli, processing arguments and executing subcommands."
+        arguments = self.argument_parser.parse_args()
+        argspec = inspect.getargspec(arguments.func)
+        vargs = []
+        for arg in argspec.args:
+            vargs.append(getattr(arguments, arg))
+        if argspec.varargs:
+            vargs.extend(getattr(arguments, argspec.varargs))
+        output = arguments.func(*vargs)
+        if getattr(arguments.func, '_cli_test_command', False):
+            self.exit_code = 0 if output else 1
+            output = ''
+        if getattr(arguments.func, '_cli_no_output', False):
+            output = ''
+        self.formatter.format_output(output, arguments.format)
+        if charmhelpers.core.unitdata._KV:
+            charmhelpers.core.unitdata._KV.flush()
+
+
+cmdline = CommandLine()
+
+
+def describe_arguments(func):
+    """
+    Analyze a function's signature and return a data structure suitable for
+    passing in as arguments to an argparse parser's add_argument() method."""
+
+    argspec = inspect.getargspec(func)
+    # we should probably raise an exception somewhere if func includes **kwargs
+    if argspec.defaults:
+        positional_args = argspec.args[:-len(argspec.defaults)]
+        keyword_names = argspec.args[-len(argspec.defaults):]
+        for arg, default in zip(keyword_names, argspec.defaults):
+            yield ('--{}'.format(arg),), {'default': default}
+    else:
+        positional_args = argspec.args
+
+    for arg in positional_args:
+        yield (arg,), {}
+    if argspec.varargs:
+        yield (argspec.varargs,), {'nargs': '*'}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/benchmark.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/benchmark.py
new file mode 100644
index 0000000000000000000000000000000000000000..303af14b607d31e338aefff0df593609b7b45feb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/benchmark.py
@@ -0,0 +1,34 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.contrib.benchmark import Benchmark
+
+
+@cmdline.subcommand(command_name='benchmark-start')
+def start():
+    Benchmark.start()
+
+
+@cmdline.subcommand(command_name='benchmark-finish')
+def finish():
+    Benchmark.finish()
+
+
+@cmdline.subcommand_builder('benchmark-composite', description="Set the benchmark composite score")
+def service(subparser):
+    subparser.add_argument("value", help="The composite score.")
+    subparser.add_argument("units", help="The units the composite score represents, i.e., 'reads/sec'.")
+    subparser.add_argument("direction", help="'asc' if a lower score is better, 'desc' if a higher score is better.")
+    return Benchmark.set_composite_score
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/commands.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/commands.py
new file mode 100644
index 0000000000000000000000000000000000000000..b93105650be8226aa390fda46aa08afb23ebc7bc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/commands.py
@@ -0,0 +1,30 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module loads sub-modules into the python runtime so they can be
+discovered via the inspect module. In order to prevent flake8 from (rightfully)
+telling us these are unused modules, throw a ' # noqa' at the end of each import
+so that the warning is suppressed.
+"""
+
+from . import CommandLine  # noqa
+
+"""
+Import the sub-modules which have decorated subcommands to register with chlp.
+"""
+from . import host  # noqa
+from . import benchmark  # noqa
+from . import unitdata  # noqa
+from . import hookenv  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd72f448bf0092251a454ff6dd3145f09048ae72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/hookenv.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import hookenv
+
+
+cmdline.subcommand('relation-id')(hookenv.relation_id._wrapped)
+cmdline.subcommand('service-name')(hookenv.service_name)
+cmdline.subcommand('remote-service-name')(hookenv.remote_service_name._wrapped)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..40396849907976fd077cc9c53a0852c4380c6266
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/host.py
@@ -0,0 +1,29 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import host
+
+
+@cmdline.subcommand()
+def mounts():
+    "List mounts"
+    return host.mounts()
+
+
+@cmdline.subcommand_builder('service', description="Control system services")
+def service(subparser):
+    subparser.add_argument("action", help="The action to perform (start, stop, etc...)")
+    subparser.add_argument("service_name", help="Name of the service to control")
+    return host.service
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..acce846f84ef32ed0b5829cf08e67ad33f0eb5d1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/cli/unitdata.py
@@ -0,0 +1,46 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from . import cmdline
+from charmhelpers.core import unitdata
+
+
+@cmdline.subcommand_builder('unitdata', description="Store and retrieve data")
+def unitdata_cmd(subparser):
+    nested = subparser.add_subparsers()
+
+    get_cmd = nested.add_parser('get', help='Retrieve data')
+    get_cmd.add_argument('key', help='Key to retrieve the value of')
+    get_cmd.set_defaults(action='get', value=None)
+
+    getrange_cmd = nested.add_parser('getrange', help='Retrieve multiple data')
+    getrange_cmd.add_argument('key', metavar='prefix',
+                              help='Prefix of the keys to retrieve')
+    getrange_cmd.set_defaults(action='getrange', value=None)
+
+    set_cmd = nested.add_parser('set', help='Store data')
+    set_cmd.add_argument('key', help='Key to set')
+    set_cmd.add_argument('value', help='Value to store')
+    set_cmd.set_defaults(action='set')
+
+    def _unitdata_cmd(action, key, value):
+        if action == 'get':
+            return unitdata.kv().get(key)
+        elif action == 'getrange':
+            return unitdata.kv().getrange(key)
+        elif action == 'set':
+            unitdata.kv().set(key, value)
+            unitdata.kv().flush()
+            return ''
+    return _unitdata_cmd
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..01864740e89633f6c65f43c32ed89ef9d5e857c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/context.py
@@ -0,0 +1,205 @@
+# Copyright 2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+A Pythonic API to interact with the charm hook environment.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+'''
+
+import six
+
+from charmhelpers.core import hookenv
+
+from collections import OrderedDict
+if six.PY3:
+    from collections import UserDict  # pragma: nocover
+else:
+    from UserDict import IterableUserDict as UserDict  # pragma: nocover
+
+
+class Relations(OrderedDict):
+    '''Mapping relation name -> relation id -> Relation.
+
+    >>> rels = Relations()
+    >>> rels['sprog']['sprog:12']['client/6']['widget']
+    'remote widget'
+    >>> rels['sprog']['sprog:12'].local['widget'] = 'local widget'
+    >>> rels['sprog']['sprog:12'].local['widget']
+    'local widget'
+    >>> rels.peer.local['widget']
+    'local widget on the peer relation'
+    '''
+    def __init__(self):
+        super(Relations, self).__init__()
+        for relname in sorted(hookenv.relation_types()):
+            self[relname] = OrderedDict()
+            relids = hookenv.relation_ids(relname)
+            relids.sort(key=lambda x: int(x.split(':', 1)[-1]))
+            for relid in relids:
+                self[relname][relid] = Relation(relid)
+
+    @property
+    def peer(self):
+        peer_relid = hookenv.peer_relation_id()
+        for rels in self.values():
+            if peer_relid in rels:
+                return rels[peer_relid]
+
+
+class Relation(OrderedDict):
+    '''Mapping of unit -> remote RelationInfo for a relation.
+
+    This is an OrderedDict mapping, ordered numerically by
+    by unit number.
+
+    Also provides access to the local RelationInfo, and peer RelationInfo
+    instances by the 'local' and 'peers' attributes.
+
+    >>> r = Relation('sprog:12')
+    >>> r.keys()
+    ['client/9', 'client/10']     # Ordered numerically
+    >>> r['client/10']['widget']  # A remote RelationInfo setting
+    'remote widget'
+    >>> r.local['widget']         # The local RelationInfo setting
+    'local widget'
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also known as relation type).
+    service = None  # The remote service name, if known.
+    local = None    # The local end's RelationInfo.
+    peers = None    # Map of peer -> RelationInfo. None if no peer relation.
+
+    def __init__(self, relid):
+        remote_units = hookenv.related_units(relid)
+        remote_units.sort(key=lambda u: int(u.split('/', 1)[-1]))
+        super(Relation, self).__init__((unit, RelationInfo(relid, unit))
+                                       for unit in remote_units)
+
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.local = RelationInfo(relid, hookenv.local_unit())
+
+        for relinfo in self.values():
+            self.service = relinfo.service
+            break
+
+        # If we have peers, and they have joined both the provided peer
+        # relation and this relation, we can peek at their data too.
+        # This is useful for creating consensus without leadership.
+        peer_relid = hookenv.peer_relation_id()
+        if peer_relid and peer_relid != relid:
+            peers = hookenv.related_units(peer_relid)
+            if peers:
+                peers.sort(key=lambda u: int(u.split('/', 1)[-1]))
+                self.peers = OrderedDict((peer, RelationInfo(relid, peer))
+                                         for peer in peers)
+            else:
+                self.peers = OrderedDict()
+        else:
+            self.peers = None
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.service)
+
+
+class RelationInfo(UserDict):
+    '''The bag of data at an end of a relation.
+
+    Every unit participating in a relation has a single bag of
+    data associated with that relation. This is that bag.
+
+    The bag of data for the local unit may be updated. Remote data
+    is immutable and will remain static for the duration of the hook.
+
+    Changes made to the local units relation data only become visible
+    to other units after the hook completes successfully. If the hook
+    does not complete successfully, the changes are rolled back.
+
+    Unlike standard Python mappings, setting an item to None is the
+    same as deleting it.
+
+    >>> relinfo = RelationInfo('db:12')  # Default is the local unit.
+    >>> relinfo['user'] = 'fred'
+    >>> relinfo['user']
+    'fred'
+    >>> relinfo['user'] = None
+    >>> 'fred' in relinfo
+    False
+
+    This class wraps hookenv.relation_get and hookenv.relation_set.
+    All caching is left up to these two methods to avoid synchronization
+    issues. Data is only loaded on demand.
+    '''
+    relid = None    # The relation id.
+    relname = None  # The relation name (also know as the relation type).
+    unit = None     # The unit id.
+    number = None   # The unit number (integer).
+    service = None  # The service name.
+
+    def __init__(self, relid, unit):
+        self.relname = relid.split(':', 1)[0]
+        self.relid = relid
+        self.unit = unit
+        self.service, num = self.unit.split('/', 1)
+        self.number = int(num)
+
+    def __str__(self):
+        return '{} ({})'.format(self.relid, self.unit)
+
+    @property
+    def data(self):
+        return hookenv.relation_get(rid=self.relid, unit=self.unit)
+
+    def __setitem__(self, key, value):
+        if self.unit != hookenv.local_unit():
+            raise TypeError('Attempting to set {} on remote unit {}'
+                            ''.format(key, self.unit))
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure relation-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.relation_set(self.relid, {key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju relations.
+        self[key] = None
+
+
+class Leader(UserDict):
+    def __init__(self):
+        pass  # Don't call superclass initializer, as it will nuke self.data
+
+    @property
+    def data(self):
+        return hookenv.leader_get()
+
+    def __setitem__(self, key, value):
+        if not hookenv.is_leader():
+            raise TypeError('Not the leader. Cannot change leader settings.')
+        if value is not None and not isinstance(value, six.string_types):
+            # We don't do implicit casting. This would cause simple
+            # types like integers to be read back as strings in subsequent
+            # hooks, and mutable types would require a lot of wrapping
+            # to ensure leader-set gets called when they are mutated.
+            raise ValueError('Only string values allowed')
+        hookenv.leader_set({key: value})
+
+    def __delitem__(self, key):
+        # Deleting a key and setting it to null is the same thing in
+        # Juju leadership settings.
+        self[key] = None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..d21d01d8ffe242d686283b0ed977b88be6bfc74e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/deployment.py
@@ -0,0 +1,99 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import os
+import six
+
+
+class AmuletDeployment(object):
+    """Amulet deployment.
+
+       This class provides generic Amulet deployment and test runner
+       methods.
+       """
+
+    def __init__(self, series=None):
+        """Initialize the deployment environment."""
+        self.series = None
+
+        if series:
+            self.series = series
+            self.d = amulet.Deployment(series=self.series)
+        else:
+            self.d = amulet.Deployment()
+
+    def _add_services(self, this_service, other_services):
+        """Add services.
+
+           Add services to the deployment where this_service is the local charm
+           that we're testing and other_services are the other services that
+           are being used in the local amulet tests.
+           """
+        if this_service['name'] != os.path.basename(os.getcwd()):
+            s = this_service['name']
+            msg = "The charm's root directory name needs to be {}".format(s)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        if 'units' not in this_service:
+            this_service['units'] = 1
+
+        self.d.add(this_service['name'], units=this_service['units'],
+                   constraints=this_service.get('constraints'),
+                   storage=this_service.get('storage'))
+
+        for svc in other_services:
+            if 'location' in svc:
+                branch_location = svc['location']
+            elif self.series:
+                branch_location = 'cs:{}/{}'.format(self.series, svc['name']),
+            else:
+                branch_location = None
+
+            if 'units' not in svc:
+                svc['units'] = 1
+
+            self.d.add(svc['name'], charm=branch_location, units=svc['units'],
+                       constraints=svc.get('constraints'),
+                       storage=svc.get('storage'))
+
+    def _add_relations(self, relations):
+        """Add all of the relations for the services."""
+        for k, v in six.iteritems(relations):
+            self.d.relate(k, v)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _deploy(self):
+        """Deploy environment and wait for all hooks to finish executing."""
+        timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 900))
+        try:
+            self.d.setup(timeout=timeout)
+            self.d.sentry.wait(timeout=timeout)
+        except amulet.helpers.TimeoutError:
+            amulet.raise_status(
+                amulet.FAIL,
+                msg="Deployment timed out ({}s)".format(timeout)
+            )
+        except Exception:
+            raise
+
+    def run_tests(self):
+        """Run all of the methods that are prefixed with 'test_'."""
+        for test in dir(self):
+            if test.startswith('test_'):
+                getattr(self, test)()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..54283088e1ddd53bc85008bc7446620e87b42278
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/amulet/utils.py
@@ -0,0 +1,820 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import json
+import logging
+import os
+import re
+import socket
+import subprocess
+import sys
+import time
+import uuid
+
+import amulet
+import distro_info
+import six
+from six.moves import configparser
+if six.PY3:
+    from urllib import parse as urlparse
+else:
+    import urlparse
+
+
+class AmuletUtils(object):
+    """Amulet utilities.
+
+       This class provides common utility functions that are used by Amulet
+       tests.
+       """
+
+    def __init__(self, log_level=logging.ERROR):
+        self.log = self.get_logger(level=log_level)
+        self.ubuntu_releases = self.get_ubuntu_releases()
+
+    def get_logger(self, name="amulet-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def valid_ip(self, ip):
+        if re.match(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$", ip):
+            return True
+        else:
+            return False
+
+    def valid_url(self, url):
+        p = re.compile(
+            r'^(?:http|ftp)s?://'
+            r'(?:(?:[A-Z0-9](?:[A-Z0-9-]{0,61}[A-Z0-9])?\.)+(?:[A-Z]{2,6}\.?|[A-Z0-9-]{2,}\.?)|'  # noqa
+            r'localhost|'
+            r'\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})'
+            r'(?::\d+)?'
+            r'(?:/?|[/?]\S+)$',
+            re.IGNORECASE)
+        if p.match(url):
+            return True
+        else:
+            return False
+
+    def get_ubuntu_release_from_sentry(self, sentry_unit):
+        """Get Ubuntu release codename from sentry unit.
+
+        :param sentry_unit: amulet sentry/service unit pointer
+        :returns: list of strings - release codename, failure message
+        """
+        msg = None
+        cmd = 'lsb_release -cs'
+        release, code = sentry_unit.ssh(cmd)
+        if code == 0:
+            self.log.debug('{} lsb_release: {}'.format(
+                sentry_unit.info['unit_name'], release))
+        else:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, release, code))
+        if release not in self.ubuntu_releases:
+            msg = ("Release ({}) not found in Ubuntu releases "
+                   "({})".format(release, self.ubuntu_releases))
+        return release, msg
+
+    def validate_services(self, commands):
+        """Validate that lists of commands succeed on service units.  Can be
+           used to verify system services are running on the corresponding
+           service units.
+
+        :param commands: dict with sentry keys and arbitrary command list vals
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # /!\ DEPRECATION WARNING (beisner):
+        # New and existing tests should be rewritten to use
+        # validate_services_by_name() as it is aware of init systems.
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_services_by_name instead of validate_services '
+                      'due to init system differences.')
+
+        for k, v in six.iteritems(commands):
+            for cmd in v:
+                output, code = k.run(cmd)
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(k.info['unit_name'],
+                                           cmd, code))
+                if code != 0:
+                    return "command `{}` returned {}".format(cmd, str(code))
+        return None
+
+    def validate_services_by_name(self, sentry_services):
+        """Validate system service status by service name, automatically
+           detecting init system based on Ubuntu release codename.
+
+        :param sentry_services: dict with sentry keys and svc list values
+        :returns: None if successful, Failure string message otherwise
+        """
+        self.log.debug('Checking status of system services...')
+
+        # Point at which systemd became a thing
+        systemd_switch = self.ubuntu_releases.index('vivid')
+
+        for sentry_unit, services_list in six.iteritems(sentry_services):
+            # Get lsb_release codename from unit
+            release, ret = self.get_ubuntu_release_from_sentry(sentry_unit)
+            if ret:
+                return ret
+
+            for service_name in services_list:
+                if (self.ubuntu_releases.index(release) >= systemd_switch or
+                        service_name in ['rabbitmq-server', 'apache2',
+                                         'memcached']):
+                    # init is systemd (or regular sysv)
+                    cmd = 'sudo service {} status'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0
+                elif self.ubuntu_releases.index(release) < systemd_switch:
+                    # init is upstart
+                    cmd = 'sudo status {}'.format(service_name)
+                    output, code = sentry_unit.run(cmd)
+                    service_running = code == 0 and "start/running" in output
+
+                self.log.debug('{} `{}` returned '
+                               '{}'.format(sentry_unit.info['unit_name'],
+                                           cmd, code))
+                if not service_running:
+                    return u"command `{}` returned {} {}".format(
+                        cmd, output, str(code))
+        return None
+
+    def _get_config(self, unit, filename):
+        """Get a ConfigParser object for parsing a unit's config file."""
+        file_contents = unit.file_contents(filename)
+
+        # NOTE(beisner):  by default, ConfigParser does not handle options
+        # with no value, such as the flags used in the mysql my.cnf file.
+        # https://bugs.python.org/issue7005
+        config = configparser.ConfigParser(allow_no_value=True)
+        config.readfp(io.StringIO(file_contents))
+        return config
+
+    def validate_config_data(self, sentry_unit, config_file, section,
+                             expected):
+        """Validate config file data.
+
+           Verify that the specified section of the config file contains
+           the expected option key:value pairs.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('Validating config file data ({} in {} on {})'
+                       '...'.format(section, config_file,
+                                    sentry_unit.info['unit_name']))
+        config = self._get_config(sentry_unit, config_file)
+
+        if section != 'DEFAULT' and not config.has_section(section):
+            return "section [{}] does not exist".format(section)
+
+        for k in expected.keys():
+            if not config.has_option(section, k):
+                return "section [{}] is missing option {}".format(section, k)
+
+            actual = config.get(section, k)
+            v = expected[k]
+            if (isinstance(v, six.string_types) or
+                    isinstance(v, bool) or
+                    isinstance(v, six.integer_types)):
+                # handle explicit values
+                if actual != v:
+                    return "section [{}] {}:{} != expected {}:{}".format(
+                           section, k, actual, k, expected[k])
+            # handle function pointers, such as not_null or valid_ip
+            elif not v(actual):
+                return "section [{}] {}:{} != expected {}:{}".format(
+                       section, k, actual, k, expected[k])
+        return None
+
+    def _validate_dict_data(self, expected, actual):
+        """Validate dictionary data.
+
+           Compare expected dictionary data vs actual dictionary data.
+           The values in the 'expected' dictionary can be strings, bools, ints,
+           longs, or can be a function that evaluates a variable and returns a
+           bool.
+           """
+        self.log.debug('actual: {}'.format(repr(actual)))
+        self.log.debug('expected: {}'.format(repr(expected)))
+
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                if (isinstance(v, six.string_types) or
+                        isinstance(v, bool) or
+                        isinstance(v, six.integer_types)):
+                    # handle explicit values
+                    if v != actual[k]:
+                        return "{}:{}".format(k, actual[k])
+                # handle function pointers, such as not_null or valid_ip
+                elif not v(actual[k]):
+                    return "{}:{}".format(k, actual[k])
+            else:
+                return "key '{}' does not exist".format(k)
+        return None
+
+    def validate_relation_data(self, sentry_unit, relation, expected):
+        """Validate actual relation data based on expected relation data."""
+        actual = sentry_unit.relation(relation[0], relation[1])
+        return self._validate_dict_data(expected, actual)
+
+    def _validate_list_data(self, expected, actual):
+        """Compare expected list vs actual list data."""
+        for e in expected:
+            if e not in actual:
+                return "expected item {} not found in actual list".format(e)
+        return None
+
+    def not_null(self, string):
+        if string is not None:
+            return True
+        else:
+            return False
+
+    def _get_file_mtime(self, sentry_unit, filename):
+        """Get last modification time of file."""
+        return sentry_unit.file_stat(filename)['mtime']
+
+    def _get_dir_mtime(self, sentry_unit, directory):
+        """Get last modification time of directory."""
+        return sentry_unit.directory_stat(directory)['mtime']
+
+    def _get_proc_start_time(self, sentry_unit, service, pgrep_full=None):
+        """Get start time of a process based on the last modification time
+           of the /proc/pid directory.
+
+        :sentry_unit:  The sentry unit to check for the service on
+        :service:  service name to look for in process table
+        :pgrep_full:  [Deprecated] Use full command line search mode with pgrep
+        :returns:  epoch time of service process start
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns:  None if successful; Failure message otherwise
+        """
+        pid_list = self.get_process_id_list(
+            sentry_unit, service, pgrep_full=pgrep_full)
+        pid = pid_list[0]
+        proc_dir = '/proc/{}'.format(pid)
+        self.log.debug('Pid for {} on {}: {}'.format(
+            service, sentry_unit.info['unit_name'], pid))
+
+        return self._get_dir_mtime(sentry_unit, proc_dir)
+
+    def service_restarted(self, sentry_unit, service, filename,
+                          pgrep_full=None, sleep_time=20):
+        """Check if service was restarted.
+
+           Compare a service's start time vs a file's last modification time
+           (such as a config file for that service) to determine if the service
+           has been restarted.
+           """
+        # /!\ DEPRECATION WARNING (beisner):
+        # This method is prone to races in that no before-time is known.
+        # Use validate_service_config_changed instead.
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+        self.log.warn('DEPRECATION WARNING:  use '
+                      'validate_service_config_changed instead of '
+                      'service_restarted due to known races.')
+
+        time.sleep(sleep_time)
+        if (self._get_proc_start_time(sentry_unit, service, pgrep_full) >=
+                self._get_file_mtime(sentry_unit, filename)):
+            return True
+        else:
+            return False
+
+    def service_restarted_since(self, sentry_unit, mtime, service,
+                                pgrep_full=None, sleep_time=20,
+                                retry_count=30, retry_sleep_time=10):
+        """Check if service was been started after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if service found and its start time it newer than mtime,
+                False if service is older than mtime or if service was
+                not found.
+        """
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s service restarted since %s on '
+                       '%s' % (service, mtime, unit_name))
+        time.sleep(sleep_time)
+        proc_start_time = None
+        tries = 0
+        while tries <= retry_count and not proc_start_time:
+            try:
+                proc_start_time = self._get_proc_start_time(sentry_unit,
+                                                            service,
+                                                            pgrep_full)
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'OK'.format(tries, service, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, proc may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} proc start time on {} '
+                               'failed\n{}'.format(tries, service,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not proc_start_time:
+            self.log.warn('No proc start time found, assuming service did '
+                          'not start')
+            return False
+        if proc_start_time >= mtime:
+            self.log.debug('Proc start time is newer than provided mtime'
+                           '(%s >= %s) on %s (OK)' % (proc_start_time,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('Proc start time (%s) is older than provided mtime '
+                          '(%s) on %s, service did not '
+                          'restart' % (proc_start_time, mtime, unit_name))
+            return False
+
+    def config_updated_since(self, sentry_unit, filename, mtime,
+                             sleep_time=20, retry_count=30,
+                             retry_sleep_time=10):
+        """Check if file was modified after a given time.
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check the file mtime on
+          filename (string): The file to check mtime of
+          mtime (float): The epoch time to check against
+          sleep_time (int): Initial sleep time (s) before looking for file
+          retry_sleep_time (int): Time (s) to sleep between retries
+          retry_count (int): If file is not found, how many times to retry
+
+        Returns:
+          bool: True if file was modified more recently than mtime, False if
+                file was modified before mtime, or if file not found.
+        """
+        unit_name = sentry_unit.info['unit_name']
+        self.log.debug('Checking that %s updated since %s on '
+                       '%s' % (filename, mtime, unit_name))
+        time.sleep(sleep_time)
+        file_mtime = None
+        tries = 0
+        while tries <= retry_count and not file_mtime:
+            try:
+                file_mtime = self._get_file_mtime(sentry_unit, filename)
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'OK'.format(tries, filename, unit_name))
+            except IOError as e:
+                # NOTE(beisner) - race avoidance, file may not exist yet.
+                # https://bugs.launchpad.net/charm-helpers/+bug/1474030
+                self.log.debug('Attempt {} to get {} file mtime on {} '
+                               'failed\n{}'.format(tries, filename,
+                                                   unit_name, e))
+                time.sleep(retry_sleep_time)
+                tries += 1
+
+        if not file_mtime:
+            self.log.warn('Could not determine file mtime, assuming '
+                          'file does not exist')
+            return False
+
+        if file_mtime >= mtime:
+            self.log.debug('File mtime is newer than provided mtime '
+                           '(%s >= %s) on %s (OK)' % (file_mtime,
+                                                      mtime, unit_name))
+            return True
+        else:
+            self.log.warn('File mtime is older than provided mtime'
+                          '(%s < on %s) on %s' % (file_mtime,
+                                                  mtime, unit_name))
+            return False
+
+    def validate_service_config_changed(self, sentry_unit, mtime, service,
+                                        filename, pgrep_full=None,
+                                        sleep_time=20, retry_count=30,
+                                        retry_sleep_time=10):
+        """Check service and file were updated after mtime
+
+        Args:
+          sentry_unit (sentry): The sentry unit to check for the service on
+          mtime (float): The epoch time to check against
+          service (string): service name to look for in process table
+          filename (string): The file to check mtime of
+          pgrep_full: [Deprecated] Use full command line search mode with pgrep
+          sleep_time (int): Initial sleep in seconds to pass to test helpers
+          retry_count (int): If service is not found, how many times to retry
+          retry_sleep_time (int): Time in seconds to wait between retries
+
+        Typical Usage:
+            u = OpenStackAmuletUtils(ERROR)
+            ...
+            mtime = u.get_sentry_time(self.cinder_sentry)
+            self.d.configure('cinder', {'verbose': 'True', 'debug': 'True'})
+            if not u.validate_service_config_changed(self.cinder_sentry,
+                                                     mtime,
+                                                     'cinder-api',
+                                                     '/etc/cinder/cinder.conf')
+                amulet.raise_status(amulet.FAIL, msg='update failed')
+        Returns:
+          bool: True if both service and file where updated/restarted after
+                mtime, False if service is older than mtime or if service was
+                not found or if filename was modified before mtime.
+        """
+
+        # NOTE(beisner) pgrep_full is no longer implemented, as pidof is now
+        # used instead of pgrep.  pgrep_full is still passed through to ensure
+        # deprecation WARNS.  lp1474030
+
+        service_restart = self.service_restarted_since(
+            sentry_unit, mtime,
+            service,
+            pgrep_full=pgrep_full,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        config_update = self.config_updated_since(
+            sentry_unit,
+            filename,
+            mtime,
+            sleep_time=sleep_time,
+            retry_count=retry_count,
+            retry_sleep_time=retry_sleep_time)
+
+        return service_restart and config_update
+
+    def get_sentry_time(self, sentry_unit):
+        """Return current epoch time on a sentry"""
+        cmd = "date +'%s'"
+        return float(sentry_unit.run(cmd)[0])
+
+    def relation_error(self, name, data):
+        return 'unexpected relation data in {} - {}'.format(name, data)
+
+    def endpoint_error(self, name, data):
+        return 'unexpected endpoint data in {} - {}'.format(name, data)
+
+    def get_ubuntu_releases(self):
+        """Return a list of all Ubuntu releases in order of release."""
+        _d = distro_info.UbuntuDistroInfo()
+        _release_list = _d.all
+        return _release_list
+
+    def file_to_url(self, file_rel_path):
+        """Convert a relative file path to a file URL."""
+        _abs_path = os.path.abspath(file_rel_path)
+        return urlparse.urlparse(_abs_path, scheme='file').geturl()
+
+    def check_commands_on_units(self, commands, sentry_units):
+        """Check that all commands in a list exit zero on all
+        sentry units in a list.
+
+        :param commands:  list of bash commands
+        :param sentry_units:  list of sentry unit pointers
+        :returns: None if successful; Failure message otherwise
+        """
+        self.log.debug('Checking exit codes for {} commands on {} '
+                       'sentry units...'.format(len(commands),
+                                                len(sentry_units)))
+        for sentry_unit in sentry_units:
+            for cmd in commands:
+                output, code = sentry_unit.run(cmd)
+                if code == 0:
+                    self.log.debug('{} `{}` returned {} '
+                                   '(OK)'.format(sentry_unit.info['unit_name'],
+                                                 cmd, code))
+                else:
+                    return ('{} `{}` returned {} '
+                            '{}'.format(sentry_unit.info['unit_name'],
+                                        cmd, code, output))
+        return None
+
+    def get_process_id_list(self, sentry_unit, process_name,
+                            expect_success=True, pgrep_full=False):
+        """Get a list of process ID(s) from a single sentry juju unit
+        for a single process name.
+
+        :param sentry_unit: Amulet sentry instance (juju unit)
+        :param process_name: Process name
+        :param expect_success: If False, expect the PID to be missing,
+            raise if it is present.
+        :returns: List of process IDs
+        """
+        if pgrep_full:
+            cmd = 'pgrep -f "{}"'.format(process_name)
+        else:
+            cmd = 'pidof -x "{}"'.format(process_name)
+        if not expect_success:
+            cmd += " || exit 0 && exit 1"
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output).split()
+
+    def get_unit_process_ids(
+            self, unit_processes, expect_success=True, pgrep_full=False):
+        """Construct a dict containing unit sentries, process names, and
+        process IDs.
+
+        :param unit_processes: A dictionary of Amulet sentry instance
+            to list of process names.
+        :param expect_success: if False expect the processes to not be
+            running, raise if they are.
+        :returns: Dictionary of Amulet sentry instance to dictionary
+            of process names to PIDs.
+        """
+        pid_dict = {}
+        for sentry_unit, process_list in six.iteritems(unit_processes):
+            pid_dict[sentry_unit] = {}
+            for process in process_list:
+                pids = self.get_process_id_list(
+                    sentry_unit, process, expect_success=expect_success,
+                    pgrep_full=pgrep_full)
+                pid_dict[sentry_unit].update({process: pids})
+        return pid_dict
+
+    def validate_unit_process_ids(self, expected, actual):
+        """Validate process id quantities for services on units."""
+        self.log.debug('Checking units for running processes...')
+        self.log.debug('Expected PIDs: {}'.format(expected))
+        self.log.debug('Actual PIDs: {}'.format(actual))
+
+        if len(actual) != len(expected):
+            return ('Unit count mismatch.  expected, actual: {}, '
+                    '{} '.format(len(expected), len(actual)))
+
+        for (e_sentry, e_proc_names) in six.iteritems(expected):
+            e_sentry_name = e_sentry.info['unit_name']
+            if e_sentry in actual.keys():
+                a_proc_names = actual[e_sentry]
+            else:
+                return ('Expected sentry ({}) not found in actual dict data.'
+                        '{}'.format(e_sentry_name, e_sentry))
+
+            if len(e_proc_names.keys()) != len(a_proc_names.keys()):
+                return ('Process name count mismatch.  expected, actual: {}, '
+                        '{}'.format(len(expected), len(actual)))
+
+            for (e_proc_name, e_pids), (a_proc_name, a_pids) in \
+                    zip(e_proc_names.items(), a_proc_names.items()):
+                if e_proc_name != a_proc_name:
+                    return ('Process name mismatch.  expected, actual: {}, '
+                            '{}'.format(e_proc_name, a_proc_name))
+
+                a_pids_length = len(a_pids)
+                fail_msg = ('PID count mismatch. {} ({}) expected, actual: '
+                            '{}, {} ({})'.format(e_sentry_name, e_proc_name,
+                                                 e_pids, a_pids_length,
+                                                 a_pids))
+
+                # If expected is a list, ensure at least one PID quantity match
+                if isinstance(e_pids, list) and \
+                        a_pids_length not in e_pids:
+                    return fail_msg
+                # If expected is not bool and not list,
+                # ensure PID quantities match
+                elif not isinstance(e_pids, bool) and \
+                        not isinstance(e_pids, list) and \
+                        a_pids_length != e_pids:
+                    return fail_msg
+                # If expected is bool True, ensure 1 or more PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is True and a_pids_length < 1:
+                    return fail_msg
+                # If expected is bool False, ensure 0 PIDs exist
+                elif isinstance(e_pids, bool) and \
+                        e_pids is False and a_pids_length != 0:
+                    return fail_msg
+                else:
+                    self.log.debug('PID check OK: {} {} {}: '
+                                   '{}'.format(e_sentry_name, e_proc_name,
+                                               e_pids, a_pids))
+        return None
+
+    def validate_list_of_identical_dicts(self, list_of_dicts):
+        """Check that all dicts within a list are identical."""
+        hashes = []
+        for _dict in list_of_dicts:
+            hashes.append(hash(frozenset(_dict.items())))
+
+        self.log.debug('Hashes: {}'.format(hashes))
+        if len(set(hashes)) == 1:
+            self.log.debug('Dicts within list are identical')
+        else:
+            return 'Dicts within list are not identical'
+
+        return None
+
+    def validate_sectionless_conf(self, file_contents, expected):
+        """A crude conf parser.  Useful to inspect configuration files which
+        do not have section headers (as would be necessary in order to use
+        the configparser).  Such as openstack-dashboard or rabbitmq confs."""
+        for line in file_contents.split('\n'):
+            if '=' in line:
+                args = line.split('=')
+                if len(args) <= 1:
+                    continue
+                key = args[0].strip()
+                value = args[1].strip()
+                if key in expected.keys():
+                    if expected[key] != value:
+                        msg = ('Config mismatch.  Expected, actual:  {}, '
+                               '{}'.format(expected[key], value))
+                        amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def get_unit_hostnames(self, units):
+        """Return a dict of juju unit names to hostnames."""
+        host_names = {}
+        for unit in units:
+            host_names[unit.info['unit_name']] = \
+                str(unit.file_contents('/etc/hostname').strip())
+        self.log.debug('Unit host names: {}'.format(host_names))
+        return host_names
+
+    def run_cmd_unit(self, sentry_unit, cmd):
+        """Run a command on a unit, return the output and exit code."""
+        output, code = sentry_unit.run(cmd)
+        if code == 0:
+            self.log.debug('{} `{}` command returned {} '
+                           '(OK)'.format(sentry_unit.info['unit_name'],
+                                         cmd, code))
+        else:
+            msg = ('{} `{}` command returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return str(output), code
+
+    def file_exists_on_unit(self, sentry_unit, file_name):
+        """Check if a file exists on a unit."""
+        try:
+            sentry_unit.file_stat(file_name)
+            return True
+        except IOError:
+            return False
+        except Exception as e:
+            msg = 'Error checking file {}: {}'.format(file_name, e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+    def file_contents_safe(self, sentry_unit, file_name,
+                           max_wait=60, fatal=False):
+        """Get file contents from a sentry unit.  Wrap amulet file_contents
+        with retry logic to address races where a file checks as existing,
+        but no longer exists by the time file_contents is called.
+        Return None if file not found. Optionally raise if fatal is True."""
+        unit_name = sentry_unit.info['unit_name']
+        file_contents = False
+        tries = 0
+        while not file_contents and tries < (max_wait / 4):
+            try:
+                file_contents = sentry_unit.file_contents(file_name)
+            except IOError:
+                self.log.debug('Attempt {} to open file {} from {} '
+                               'failed'.format(tries, file_name,
+                                               unit_name))
+                time.sleep(4)
+                tries += 1
+
+        if file_contents:
+            return file_contents
+        elif not fatal:
+            return None
+        elif fatal:
+            msg = 'Failed to get file contents from unit.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def port_knock_tcp(self, host="localhost", port=22, timeout=15):
+        """Open a TCP socket to check for a listening sevice on a host.
+
+        :param host: host name or IP address, default to localhost
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :returns: True if successful, False if connect failed
+        """
+
+        # Resolve host name if possible
+        try:
+            connect_host = socket.gethostbyname(host)
+            host_human = "{} ({})".format(connect_host, host)
+        except socket.error as e:
+            self.log.warn('Unable to resolve address: '
+                          '{} ({}) Trying anyway!'.format(host, e))
+            connect_host = host
+            host_human = connect_host
+
+        # Attempt socket connection
+        try:
+            knock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+            knock.settimeout(timeout)
+            knock.connect((connect_host, port))
+            knock.close()
+            self.log.debug('Socket connect OK for host '
+                           '{} on port {}.'.format(host_human, port))
+            return True
+        except socket.error as e:
+            self.log.debug('Socket connect FAIL for'
+                           ' {} port {} ({})'.format(host_human, port, e))
+            return False
+
+    def port_knock_units(self, sentry_units, port=22,
+                         timeout=15, expect_success=True):
+        """Open a TCP socket to check for a listening sevice on each
+        listed juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param port: TCP port number, default to 22
+        :param timeout: Connect timeout, default to 15 seconds
+        :expect_success: True by default, set False to invert logic
+        :returns: None if successful, Failure message otherwise
+        """
+        for unit in sentry_units:
+            host = unit.info['public-address']
+            connected = self.port_knock_tcp(host, port, timeout)
+            if not connected and expect_success:
+                return 'Socket connect failed.'
+            elif connected and not expect_success:
+                return 'Socket connected unexpectedly.'
+
+    def get_uuid_epoch_stamp(self):
+        """Returns a stamp string based on uuid4 and epoch time.  Useful in
+        generating test messages which need to be unique-ish."""
+        return '[{}-{}]'.format(uuid.uuid4(), time.time())
+
+    # amulet juju action helpers:
+    def run_action(self, unit_sentry, action,
+                   _check_output=subprocess.check_output,
+                   params=None):
+        """Translate to amulet's built in run_action(). Deprecated.
+
+        Run the named action on a given unit sentry.
+
+        params a dict of parameters to use
+        _check_output parameter is no longer used
+
+        @return action_id.
+        """
+        self.log.warn('charmhelpers.contrib.amulet.utils.run_action has been '
+                      'deprecated for amulet.run_action')
+        return unit_sentry.run_action(action, action_args=params)
+
+    def wait_on_action(self, action_id, _check_output=subprocess.check_output):
+        """Wait for a given action, returning if it completed or not.
+
+        action_id a string action uuid
+        _check_output parameter is no longer used
+        """
+        data = amulet.actions.get_action_output(action_id, full_output=True)
+        return data.get(u"status") == "completed"
+
+    def status_get(self, unit):
+        """Return the current service status of this unit."""
+        raw_status, return_code = unit.run(
+            "status-get --format=json --include-data")
+        if return_code != 0:
+            return ("unknown", "")
+        status = json.loads(raw_status)
+        return (status["status"], status["message"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ansible/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ansible/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..824780aca93c406f7331ec3f0da8f22bee1272ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ansible/__init__.py
@@ -0,0 +1,303 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""
+The ansible package enables you to easily use the configuration management
+tool `Ansible`_ to setup and configure your charm. All of your charm
+configuration options and relation-data are available as regular Ansible
+variables which can be used in your playbooks and templates.
+
+.. _Ansible: https://www.ansible.com/
+
+Usage
+=====
+
+Here is an example directory structure for a charm to get you started::
+
+    charm-ansible-example/
+    |-- ansible
+    |   |-- playbook.yaml
+    |   `-- templates
+    |       `-- example.j2
+    |-- config.yaml
+    |-- copyright
+    |-- icon.svg
+    |-- layer.yaml
+    |-- metadata.yaml
+    |-- reactive
+    |   `-- example.py
+    |-- README.md
+
+Running a playbook called ``playbook.yaml`` when the ``install`` hook is run
+can be as simple as::
+
+    from charmhelpers.contrib import ansible
+    from charms.reactive import hook
+
+    @hook('install')
+    def install():
+        ansible.install_ansible_support()
+        ansible.apply_playbook('ansible/playbook.yaml')
+
+Here is an example playbook that uses the ``template`` module to template the
+file ``example.j2`` to the charm host and then uses the ``debug`` module to
+print out all the host and Juju variables that you can use in your playbooks.
+Note that you must target ``localhost`` as the playbook is run locally on the
+charm host::
+
+    ---
+    - hosts: localhost
+      tasks:
+        - name: Template a file
+          template:
+            src: templates/example.j2
+            dest: /tmp/example.j2
+
+        - name: Print all variables available to Ansible
+          debug:
+            var: vars
+
+Read more online about `playbooks`_ and standard Ansible `modules`_.
+
+.. _playbooks: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html
+.. _modules: https://docs.ansible.com/ansible/latest/user_guide/modules.html
+
+A further feature of the Ansible hooks is to provide a light weight "action"
+scripting tool. This is a decorator that you apply to a function, and that
+function can now receive cli args, and can pass extra args to the playbook::
+
+    @hooks.action()
+    def some_action(amount, force="False"):
+        "Usage: some-action AMOUNT [force=True]"  # <-- shown on error
+        # process the arguments
+        # do some calls
+        # return extra-vars to be passed to ansible-playbook
+        return {
+            'amount': int(amount),
+            'type': force,
+        }
+
+You can now create a symlink to hooks.py that can be invoked like a hook, but
+with cli params::
+
+    # link actions/some-action to hooks/hooks.py
+
+    actions/some-action amount=10 force=true
+
+Install Ansible via pip
+=======================
+
+If you want to install a specific version of Ansible via pip instead of
+``install_ansible_support`` which uses APT, consider using the layer options
+of `layer-basic`_ to install Ansible in a virtualenv::
+
+    options:
+      basic:
+        python_packages: ['ansible==2.9.0']
+        include_system_packages: true
+        use_venv: true
+
+.. _layer-basic: https://charmsreactive.readthedocs.io/en/latest/layer-basic.html#layer-configuration
+
+"""
+import os
+import json
+import stat
+import subprocess
+import functools
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+import charmhelpers.fetch
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+ansible_hosts_path = '/etc/ansible/hosts'
+# Ansible will automatically include any vars in the following
+# file in its inventory when run locally.
+ansible_vars_path = '/etc/ansible/host_vars/localhost'
+
+
+def install_ansible_support(from_ppa=True, ppa_location='ppa:ansible/ansible'):
+    """Installs Ansible via APT.
+
+    By default this installs Ansible from the `PPA`_ linked from
+    the Ansible `website`_ or from a PPA set in ``ppa_location``.
+
+    .. _PPA: https://launchpad.net/~ansible/+archive/ubuntu/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If ``from_ppa`` is ``False``, then Ansible will be installed from
+    Ubuntu's Universe repositories.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install('ansible')
+    with open(ansible_hosts_path, 'w+') as hosts_file:
+        hosts_file.write('localhost ansible_connection=local ansible_remote_tmp=/root/.ansible/tmp')
+
+
+def apply_playbook(playbook, tags=None, extra_vars=None):
+    """Run a playbook.
+
+    This helper runs a playbook with juju state variables as context,
+    therefore variables set in application config can be used directly.
+    List of tags (--tags) and dictionary with extra_vars (--extra-vars)
+    can be passed as additional parameters.
+
+    Read more about playbook `_variables`_ online.
+
+    .. _variables: https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html
+
+    Example::
+
+        # Run ansible/playbook.yaml with tag install and pass extra
+        # variables var_a and var_b
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['install'],
+            extra_vars={'var_a': 'val_a', 'var_b': 'val_b'}
+        )
+
+        # Run ansible/playbook.yaml with tag config and extra variable nested,
+        # which is passed as json and can be used as dictionary in playbook
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            tags=['config'],
+            extra_vars={'nested': {'a': 'value1', 'b': 'value2'}}
+        )
+
+        # Custom config file can be passed within extra_vars
+        apply_playbook(
+            playbook='ansible/playbook.yaml',
+            extra_vars="@some_file.json"
+        )
+
+    """
+    tags = tags or []
+    tags = ",".join(tags)
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        ansible_vars_path, namespace_separator='__',
+        allow_hyphens_in_keys=False, mode=(stat.S_IRUSR | stat.S_IWUSR))
+
+    # we want ansible's log output to be unbuffered
+    env = os.environ.copy()
+    env['PYTHONUNBUFFERED'] = "1"
+    call = [
+        'ansible-playbook',
+        '-c',
+        'local',
+        playbook,
+    ]
+    if tags:
+        call.extend(['--tags', '{}'.format(tags)])
+    if extra_vars:
+        call.extend(['--extra-vars', json.dumps(extra_vars)])
+    subprocess.check_call(call, env=env)
+
+
+class AnsibleHooks(charmhelpers.core.hookenv.Hooks):
+    """Run a playbook with the hook-name as the tag.
+
+    This helper builds on the standard hookenv.Hooks helper,
+    but additionally runs the playbook with the hook-name specified
+    using --tags (ie. running all the tasks tagged with the hook-name).
+
+    Example::
+
+        hooks = AnsibleHooks(playbook_path='ansible/my_machine_state.yaml')
+
+        # All the tasks within my_machine_state.yaml tagged with 'install'
+        # will be run automatically after do_custom_work()
+        @hooks.hook()
+        def install():
+            do_custom_work()
+
+        # For most of your hooks, you won't need to do anything other
+        # than run the tagged tasks for the hook:
+        @hooks.hook('config-changed', 'start', 'stop')
+        def just_use_playbook():
+            pass
+
+        # As a convenience, you can avoid the above noop function by specifying
+        # the hooks which are handled by ansible-only and they'll be registered
+        # for you:
+        # hooks = AnsibleHooks(
+        #     'ansible/my_machine_state.yaml',
+        #     default_hooks=['config-changed', 'start', 'stop'])
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, playbook_path, default_hooks=None):
+        """Register any hooks handled by ansible."""
+        super(AnsibleHooks, self).__init__()
+
+        self._actions = {}
+        self.playbook_path = playbook_path
+
+        default_hooks = default_hooks or []
+
+        def noop(*args, **kwargs):
+            pass
+
+        for hook in default_hooks:
+            self.register(hook, noop)
+
+    def register_action(self, name, function):
+        """Register a hook"""
+        self._actions[name] = function
+
+    def execute(self, args):
+        """Execute the hook followed by the playbook using the hook as tag."""
+        hook_name = os.path.basename(args[0])
+        extra_vars = None
+        if hook_name in self._actions:
+            extra_vars = self._actions[hook_name](args[1:])
+        else:
+            super(AnsibleHooks, self).execute(args)
+
+        charmhelpers.contrib.ansible.apply_playbook(
+            self.playbook_path, tags=[hook_name], extra_vars=extra_vars)
+
+    def action(self, *action_names):
+        """Decorator, registering them as actions"""
+        def action_wrapper(decorated):
+
+            @functools.wraps(decorated)
+            def wrapper(argv):
+                kwargs = dict(arg.split('=') for arg in argv)
+                try:
+                    return decorated(**kwargs)
+                except TypeError as e:
+                    if decorated.__doc__:
+                        e.args += (decorated.__doc__,)
+                    raise
+
+            self.register_action(decorated.__name__, wrapper)
+            if '_' in decorated.__name__:
+                self.register_action(
+                    decorated.__name__.replace('_', '-'), wrapper)
+
+            return wrapper
+
+        return action_wrapper
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/benchmark/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/benchmark/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c35f7fe785a29519a257f1ed5aa33fdfa19129c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/benchmark/__init__.py
@@ -0,0 +1,124 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import time
+import os
+from distutils.spawn import find_executable
+
+from charmhelpers.core.hookenv import (
+    in_relation_hook,
+    relation_ids,
+    relation_set,
+    relation_get,
+)
+
+
+def action_set(key, val):
+    if find_executable('action-set'):
+        action_cmd = ['action-set']
+
+        if isinstance(val, dict):
+            for k, v in iter(val.items()):
+                action_set('%s.%s' % (key, k), v)
+            return True
+
+        action_cmd.append('%s=%s' % (key, val))
+        subprocess.check_call(action_cmd)
+        return True
+    return False
+
+
+class Benchmark():
+    """
+    Helper class for the `benchmark` interface.
+
+    :param list actions: Define the actions that are also benchmarks
+
+    From inside the benchmark-relation-changed hook, you would
+    Benchmark(['memory', 'cpu', 'disk', 'smoke', 'custom'])
+
+    Examples:
+
+        siege = Benchmark(['siege'])
+        siege.start()
+        [... run siege ...]
+        # The higher the score, the better the benchmark
+        siege.set_composite_score(16.70, 'trans/sec', 'desc')
+        siege.finish()
+
+
+    """
+
+    BENCHMARK_CONF = '/etc/benchmark.conf'  # Replaced in testing
+
+    required_keys = [
+        'hostname',
+        'port',
+        'graphite_port',
+        'graphite_endpoint',
+        'api_port'
+    ]
+
+    def __init__(self, benchmarks=None):
+        if in_relation_hook():
+            if benchmarks is not None:
+                for rid in sorted(relation_ids('benchmark')):
+                    relation_set(relation_id=rid, relation_settings={
+                        'benchmarks': ",".join(benchmarks)
+                    })
+
+            # Check the relation data
+            config = {}
+            for key in self.required_keys:
+                val = relation_get(key)
+                if val is not None:
+                    config[key] = val
+                else:
+                    # We don't have all of the required keys
+                    config = {}
+                    break
+
+            if len(config):
+                with open(self.BENCHMARK_CONF, 'w') as f:
+                    for key, val in iter(config.items()):
+                        f.write("%s=%s\n" % (key, val))
+
+    @staticmethod
+    def start():
+        action_set('meta.start', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+        """
+        If the collectd charm is also installed, tell it to send a snapshot
+        of the current profile data.
+        """
+        COLLECT_PROFILE_DATA = '/usr/local/bin/collect-profile-data'
+        if os.path.exists(COLLECT_PROFILE_DATA):
+            subprocess.check_output([COLLECT_PROFILE_DATA])
+
+    @staticmethod
+    def finish():
+        action_set('meta.stop', time.strftime('%Y-%m-%dT%H:%M:%SZ'))
+
+    @staticmethod
+    def set_composite_score(value, units, direction='asc'):
+        """
+        Set the composite score for a benchmark run. This is a single number
+        representative of the benchmark results. This could be the most
+        important metric, or an amalgamation of metric scores.
+        """
+        return action_set(
+            "meta.composite",
+            {'value': value, 'units': units, 'direction': direction}
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..d41cb041f45cb19b87aee7d3f5fd4d47a3d3fb2d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/IMPORT
@@ -0,0 +1,4 @@
+Source lp:charm-tools/trunk
+
+charm-tools/helpers/python/charmhelpers/__init__.py -> charmhelpers/charmhelpers/contrib/charmhelpers/__init__.py
+charm-tools/helpers/python/charmhelpers/tests/test_charmhelpers.py -> charmhelpers/tests/contrib/charmhelpers/test_charmhelpers.py
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed63e8121e23a8e01ccb8ddcbf9aea34543d3666
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmhelpers/__init__.py
@@ -0,0 +1,203 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import warnings
+warnings.warn("contrib.charmhelpers is deprecated", DeprecationWarning)  # noqa
+
+import operator
+import tempfile
+import time
+import yaml
+import subprocess
+
+import six
+if six.PY3:
+    from urllib.request import urlopen
+    from urllib.error import (HTTPError, URLError)
+else:
+    from urllib2 import (urlopen, HTTPError, URLError)
+
+"""Helper functions for writing Juju charms in Python."""
+
+__metaclass__ = type
+__all__ = [
+    # 'get_config',             # core.hookenv.config()
+    # 'log',                    # core.hookenv.log()
+    # 'log_entry',              # core.hookenv.log()
+    # 'log_exit',               # core.hookenv.log()
+    # 'relation_get',           # core.hookenv.relation_get()
+    # 'relation_set',           # core.hookenv.relation_set()
+    # 'relation_ids',           # core.hookenv.relation_ids()
+    # 'relation_list',          # core.hookenv.relation_units()
+    # 'config_get',             # core.hookenv.config()
+    # 'unit_get',               # core.hookenv.unit_get()
+    # 'open_port',              # core.hookenv.open_port()
+    # 'close_port',             # core.hookenv.close_port()
+    # 'service_control',        # core.host.service()
+    'unit_info',              # client-side, NOT IMPLEMENTED
+    'wait_for_machine',       # client-side, NOT IMPLEMENTED
+    'wait_for_page_contents',  # client-side, NOT IMPLEMENTED
+    'wait_for_relation',      # client-side, NOT IMPLEMENTED
+    'wait_for_unit',          # client-side, NOT IMPLEMENTED
+]
+
+
+SLEEP_AMOUNT = 0.1
+
+
+# We create a juju_status Command here because it makes testing much,
+# much easier.
+def juju_status():
+    subprocess.check_call(['juju', 'status'])
+
+# re-implemented as charmhelpers.fetch.configure_sources()
+# def configure_source(update=False):
+#    source = config_get('source')
+#    if ((source.startswith('ppa:') or
+#         source.startswith('cloud:') or
+#         source.startswith('http:'))):
+#        run('add-apt-repository', source)
+#    if source.startswith("http:"):
+#        run('apt-key', 'import', config_get('key'))
+#    if update:
+#        run('apt-get', 'update')
+
+
+# DEPRECATED: client-side only
+def make_charm_config_file(charm_config):
+    charm_config_file = tempfile.NamedTemporaryFile(mode='w+')
+    charm_config_file.write(yaml.dump(charm_config))
+    charm_config_file.flush()
+    # The NamedTemporaryFile instance is returned instead of just the name
+    # because we want to take advantage of garbage collection-triggered
+    # deletion of the temp file when it goes out of scope in the caller.
+    return charm_config_file
+
+
+# DEPRECATED: client-side only
+def unit_info(service_name, item_name, data=None, unit=None):
+    if data is None:
+        data = yaml.safe_load(juju_status())
+    service = data['services'].get(service_name)
+    if service is None:
+        # XXX 2012-02-08 gmb:
+        #     This allows us to cope with the race condition that we
+        #     have between deploying a service and having it come up in
+        #     `juju status`. We could probably do with cleaning it up so
+        #     that it fails a bit more noisily after a while.
+        return ''
+    units = service['units']
+    if unit is not None:
+        item = units[unit][item_name]
+    else:
+        # It might seem odd to sort the units here, but we do it to
+        # ensure that when no unit is specified, the first unit for the
+        # service (or at least the one with the lowest number) is the
+        # one whose data gets returned.
+        sorted_unit_names = sorted(units.keys())
+        item = units[sorted_unit_names[0]][item_name]
+    return item
+
+
+# DEPRECATED: client-side only
+def get_machine_data():
+    return yaml.safe_load(juju_status())['machines']
+
+
+# DEPRECATED: client-side only
+def wait_for_machine(num_machines=1, timeout=300):
+    """Wait `timeout` seconds for `num_machines` machines to come up.
+
+    This wait_for... function can be called by other wait_for functions
+    whose timeouts might be too short in situations where only a bare
+    Juju setup has been bootstrapped.
+
+    :return: A tuple of (num_machines, time_taken). This is used for
+             testing.
+    """
+    # You may think this is a hack, and you'd be right. The easiest way
+    # to tell what environment we're working in (LXC vs EC2) is to check
+    # the dns-name of the first machine. If it's localhost we're in LXC
+    # and we can just return here.
+    if get_machine_data()[0]['dns-name'] == 'localhost':
+        return 1, 0
+    start_time = time.time()
+    while True:
+        # Drop the first machine, since it's the Zookeeper and that's
+        # not a machine that we need to wait for. This will only work
+        # for EC2 environments, which is why we return early above if
+        # we're in LXC.
+        machine_data = get_machine_data()
+        non_zookeeper_machines = [
+            machine_data[key] for key in list(machine_data.keys())[1:]]
+        if len(non_zookeeper_machines) >= num_machines:
+            all_machines_running = True
+            for machine in non_zookeeper_machines:
+                if machine.get('instance-state') != 'running':
+                    all_machines_running = False
+                    break
+            if all_machines_running:
+                break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    return num_machines, time.time() - start_time
+
+
+# DEPRECATED: client-side only
+def wait_for_unit(service_name, timeout=480):
+    """Wait `timeout` seconds for a given service name to come up."""
+    wait_for_machine(num_machines=1)
+    start_time = time.time()
+    while True:
+        state = unit_info(service_name, 'agent-state')
+        if 'error' in state or state == 'started':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for service to start')
+        time.sleep(SLEEP_AMOUNT)
+    if state != 'started':
+        raise RuntimeError('unit did not start, agent-state: ' + state)
+
+
+# DEPRECATED: client-side only
+def wait_for_relation(service_name, relation_name, timeout=120):
+    """Wait `timeout` seconds for a given relation to come up."""
+    start_time = time.time()
+    while True:
+        relation = unit_info(service_name, 'relations').get(relation_name)
+        if relation is not None and relation['state'] == 'up':
+            break
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for relation to be up')
+        time.sleep(SLEEP_AMOUNT)
+
+
+# DEPRECATED: client-side only
+def wait_for_page_contents(url, contents, timeout=120, validate=None):
+    if validate is None:
+        validate = operator.contains
+    start_time = time.time()
+    while True:
+        try:
+            stream = urlopen(url)
+        except (HTTPError, URLError):
+            pass
+        else:
+            page = stream.read()
+            if validate(page, contents):
+                return page
+        if time.time() - start_time >= timeout:
+            raise RuntimeError('timeout waiting for contents of ' + url)
+        time.sleep(SLEEP_AMOUNT)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/IMPORT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/IMPORT
new file mode 100644
index 0000000000000000000000000000000000000000..554fddda9f48d6d17abaff942834493b2cca2dbe
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/IMPORT
@@ -0,0 +1,14 @@
+Source: lp:charmsupport/trunk
+
+charmsupport/charmsupport/execd.py -> charm-helpers/charmhelpers/contrib/charmsupport/execd.py
+charmsupport/charmsupport/hookenv.py -> charm-helpers/charmhelpers/contrib/charmsupport/hookenv.py
+charmsupport/charmsupport/host.py -> charm-helpers/charmhelpers/contrib/charmsupport/host.py
+charmsupport/charmsupport/nrpe.py -> charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py
+charmsupport/charmsupport/volumes.py -> charm-helpers/charmhelpers/contrib/charmsupport/volumes.py
+
+charmsupport/tests/test_execd.py -> charm-helpers/tests/contrib/charmsupport/test_execd.py
+charmsupport/tests/test_hookenv.py -> charm-helpers/tests/contrib/charmsupport/test_hookenv.py
+charmsupport/tests/test_host.py -> charm-helpers/tests/contrib/charmsupport/test_host.py
+charmsupport/tests/test_nrpe.py -> charm-helpers/tests/contrib/charmsupport/test_nrpe.py
+
+charmsupport/bin/charmsupport -> charm-helpers/bin/contrib/charmsupport/charmsupport
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py
new file mode 100644
index 0000000000000000000000000000000000000000..d775861b0868a174a3f0f4a8d4a42320272a4cb0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/nrpe.py
@@ -0,0 +1,500 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Compatibility with the nrpe-external-master charm"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import subprocess
+import pwd
+import grp
+import os
+import glob
+import shutil
+import re
+import shlex
+import yaml
+
+from charmhelpers.core.hookenv import (
+    config,
+    hook_name,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    relation_set,
+    relations_of_type,
+)
+
+from charmhelpers.core.host import service
+from charmhelpers.core import host
+
+# This module adds compatibility with the nrpe-external-master and plain nrpe
+# subordinate charms. To use it in your charm:
+#
+# 1. Update metadata.yaml
+#
+#   provides:
+#     (...)
+#     nrpe-external-master:
+#       interface: nrpe-external-master
+#       scope: container
+#
+#   and/or
+#
+#   provides:
+#     (...)
+#     local-monitors:
+#       interface: local-monitors
+#       scope: container
+
+#
+# 2. Add the following to config.yaml
+#
+#    nagios_context:
+#      default: "juju"
+#      type: string
+#      description: |
+#        Used by the nrpe subordinate charms.
+#        A string that will be prepended to instance name to set the host name
+#        in nagios. So for instance the hostname would be something like:
+#            juju-myservice-0
+#        If you're running multiple environments with the same services in them
+#        this allows you to differentiate between them.
+#    nagios_servicegroups:
+#      default: ""
+#      type: string
+#      description: |
+#        A comma-separated list of nagios servicegroups.
+#        If left empty, the nagios_context will be used as the servicegroup
+#
+# 3. Add custom checks (Nagios plugins) to files/nrpe-external-master
+#
+# 4. Update your hooks.py with something like this:
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE()
+#        nrpe_compat.add_check(
+#            shortname = "myservice",
+#            description = "Check MyService",
+#            check_cmd = "check_http -w 2 -c 10 http://localhost"
+#            )
+#        nrpe_compat.add_check(
+#            "myservice_other",
+#            "Check for widget failures",
+#            check_cmd = "/srv/myapp/scripts/widget_check"
+#            )
+#        nrpe_compat.write()
+#
+#    def config_changed():
+#        (...)
+#        update_nrpe_config()
+#
+#    def nrpe_external_master_relation_changed():
+#        update_nrpe_config()
+#
+#    def local_monitors_relation_changed():
+#        update_nrpe_config()
+#
+# 4.a If your charm is a subordinate charm set primary=False
+#
+#    from charmsupport.nrpe import NRPE
+#    (...)
+#    def update_nrpe_config():
+#        nrpe_compat = NRPE(primary=False)
+#
+# 5. ln -s hooks.py nrpe-external-master-relation-changed
+#    ln -s hooks.py local-monitors-relation-changed
+
+
+class CheckException(Exception):
+    pass
+
+
+class Check(object):
+    shortname_re = '[A-Za-z0-9-_.@]+$'
+    service_template = ("""
+#---------------------------------------------------
+# This file is Juju managed
+#---------------------------------------------------
+define service {{
+    use                             active-service
+    host_name                       {nagios_hostname}
+    service_description             {nagios_hostname}[{shortname}] """
+                        """{description}
+    check_command                   check_nrpe!{command}
+    servicegroups                   {nagios_servicegroup}
+}}
+""")
+
+    def __init__(self, shortname, description, check_cmd):
+        super(Check, self).__init__()
+        # XXX: could be better to calculate this from the service name
+        if not re.match(self.shortname_re, shortname):
+            raise CheckException("shortname must match {}".format(
+                Check.shortname_re))
+        self.shortname = shortname
+        self.command = "check_{}".format(shortname)
+        # Note: a set of invalid characters is defined by the
+        # Nagios server config
+        # The default is: illegal_object_name_chars=`~!$%^&*"|'<>?,()=
+        self.description = description
+        self.check_cmd = self._locate_cmd(check_cmd)
+
+    def _get_check_filename(self):
+        return os.path.join(NRPE.nrpe_confdir, '{}.cfg'.format(self.command))
+
+    def _get_service_filename(self, hostname):
+        return os.path.join(NRPE.nagios_exportdir,
+                            'service__{}_{}.cfg'.format(hostname, self.command))
+
+    def _locate_cmd(self, check_cmd):
+        search_path = (
+            '/usr/lib/nagios/plugins',
+            '/usr/local/lib/nagios/plugins',
+        )
+        parts = shlex.split(check_cmd)
+        for path in search_path:
+            if os.path.exists(os.path.join(path, parts[0])):
+                command = os.path.join(path, parts[0])
+                if len(parts) > 1:
+                    command += " " + " ".join(parts[1:])
+                return command
+        log('Check command not found: {}'.format(parts[0]))
+        return ''
+
+    def _remove_service_files(self):
+        if not os.path.exists(NRPE.nagios_exportdir):
+            return
+        for f in os.listdir(NRPE.nagios_exportdir):
+            if f.endswith('_{}.cfg'.format(self.command)):
+                os.remove(os.path.join(NRPE.nagios_exportdir, f))
+
+    def remove(self, hostname):
+        nrpe_check_file = self._get_check_filename()
+        if os.path.exists(nrpe_check_file):
+            os.remove(nrpe_check_file)
+        self._remove_service_files()
+
+    def write(self, nagios_context, hostname, nagios_servicegroups):
+        nrpe_check_file = self._get_check_filename()
+        with open(nrpe_check_file, 'w') as nrpe_check_config:
+            nrpe_check_config.write("# check {}\n".format(self.shortname))
+            if nagios_servicegroups:
+                nrpe_check_config.write(
+                    "# The following header was added automatically by juju\n")
+                nrpe_check_config.write(
+                    "# Modifying it will affect nagios monitoring and alerting\n")
+                nrpe_check_config.write(
+                    "# servicegroups: {}\n".format(nagios_servicegroups))
+            nrpe_check_config.write("command[{}]={}\n".format(
+                self.command, self.check_cmd))
+
+        if not os.path.exists(NRPE.nagios_exportdir):
+            log('Not writing service config as {} is not accessible'.format(
+                NRPE.nagios_exportdir))
+        else:
+            self.write_service_config(nagios_context, hostname,
+                                      nagios_servicegroups)
+
+    def write_service_config(self, nagios_context, hostname,
+                             nagios_servicegroups):
+        self._remove_service_files()
+
+        templ_vars = {
+            'nagios_hostname': hostname,
+            'nagios_servicegroup': nagios_servicegroups,
+            'description': self.description,
+            'shortname': self.shortname,
+            'command': self.command,
+        }
+        nrpe_service_text = Check.service_template.format(**templ_vars)
+        nrpe_service_file = self._get_service_filename(hostname)
+        with open(nrpe_service_file, 'w') as nrpe_service_config:
+            nrpe_service_config.write(str(nrpe_service_text))
+
+    def run(self):
+        subprocess.call(self.check_cmd)
+
+
+class NRPE(object):
+    nagios_logdir = '/var/log/nagios'
+    nagios_exportdir = '/var/lib/nagios/export'
+    nrpe_confdir = '/etc/nagios/nrpe.d'
+    homedir = '/var/lib/nagios'  # home dir provided by nagios-nrpe-server
+
+    def __init__(self, hostname=None, primary=True):
+        super(NRPE, self).__init__()
+        self.config = config()
+        self.primary = primary
+        self.nagios_context = self.config['nagios_context']
+        if 'nagios_servicegroups' in self.config and self.config['nagios_servicegroups']:
+            self.nagios_servicegroups = self.config['nagios_servicegroups']
+        else:
+            self.nagios_servicegroups = self.nagios_context
+        self.unit_name = local_unit().replace('/', '-')
+        if hostname:
+            self.hostname = hostname
+        else:
+            nagios_hostname = get_nagios_hostname()
+            if nagios_hostname:
+                self.hostname = nagios_hostname
+            else:
+                self.hostname = "{}-{}".format(self.nagios_context, self.unit_name)
+        self.checks = []
+        # Iff in an nrpe-external-master relation hook, set primary status
+        relation = relation_ids('nrpe-external-master')
+        if relation:
+            log("Setting charm primary status {}".format(primary))
+            for rid in relation:
+                relation_set(relation_id=rid, relation_settings={'primary': self.primary})
+        self.remove_check_queue = set()
+
+    def add_check(self, *args, **kwargs):
+        shortname = None
+        if kwargs.get('shortname') is None:
+            if len(args) > 0:
+                shortname = args[0]
+        else:
+            shortname = kwargs['shortname']
+
+        self.checks.append(Check(*args, **kwargs))
+        try:
+            self.remove_check_queue.remove(shortname)
+        except KeyError:
+            pass
+
+    def remove_check(self, *args, **kwargs):
+        if kwargs.get('shortname') is None:
+            raise ValueError('shortname of check must be specified')
+
+        # Use sensible defaults if they're not specified - these are not
+        # actually used during removal, but they're required for constructing
+        # the Check object; check_disk is chosen because it's part of the
+        # nagios-plugins-basic package.
+        if kwargs.get('check_cmd') is None:
+            kwargs['check_cmd'] = 'check_disk'
+        if kwargs.get('description') is None:
+            kwargs['description'] = ''
+
+        check = Check(*args, **kwargs)
+        check.remove(self.hostname)
+        self.remove_check_queue.add(kwargs['shortname'])
+
+    def write(self):
+        try:
+            nagios_uid = pwd.getpwnam('nagios').pw_uid
+            nagios_gid = grp.getgrnam('nagios').gr_gid
+        except Exception:
+            log("Nagios user not set up, nrpe checks not updated")
+            return
+
+        if not os.path.exists(NRPE.nagios_logdir):
+            os.mkdir(NRPE.nagios_logdir)
+            os.chown(NRPE.nagios_logdir, nagios_uid, nagios_gid)
+
+        nrpe_monitors = {}
+        monitors = {"monitors": {"remote": {"nrpe": nrpe_monitors}}}
+        for nrpecheck in self.checks:
+            nrpecheck.write(self.nagios_context, self.hostname,
+                            self.nagios_servicegroups)
+            nrpe_monitors[nrpecheck.shortname] = {
+                "command": nrpecheck.command,
+            }
+
+        # update-status hooks are configured to firing every 5 minutes by
+        # default. When nagios-nrpe-server is restarted, the nagios server
+        # reports checks failing causing unnecessary alerts. Let's not restart
+        # on update-status hooks.
+        if not hook_name() == 'update-status':
+            service('restart', 'nagios-nrpe-server')
+
+        monitor_ids = relation_ids("local-monitors") + \
+            relation_ids("nrpe-external-master")
+        for rid in monitor_ids:
+            reldata = relation_get(unit=local_unit(), rid=rid)
+            if 'monitors' in reldata:
+                # update the existing set of monitors with the new data
+                old_monitors = yaml.safe_load(reldata['monitors'])
+                old_nrpe_monitors = old_monitors['monitors']['remote']['nrpe']
+                # remove keys that are in the remove_check_queue
+                old_nrpe_monitors = {k: v for k, v in old_nrpe_monitors.items()
+                                     if k not in self.remove_check_queue}
+                # update/add nrpe_monitors
+                old_nrpe_monitors.update(nrpe_monitors)
+                old_monitors['monitors']['remote']['nrpe'] = old_nrpe_monitors
+                # write back to the relation
+                relation_set(relation_id=rid, monitors=yaml.dump(old_monitors))
+            else:
+                # write a brand new set of monitors, as no existing ones.
+                relation_set(relation_id=rid, monitors=yaml.dump(monitors))
+
+        self.remove_check_queue.clear()
+
+
+def get_nagios_hostcontext(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_host_context
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_host_context' in rel:
+            return rel['nagios_host_context']
+
+
+def get_nagios_hostname(relation_name='nrpe-external-master'):
+    """
+    Query relation with nrpe subordinate, return the nagios_hostname
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    for rel in relations_of_type(relation_name):
+        if 'nagios_hostname' in rel:
+            return rel['nagios_hostname']
+
+
+def get_nagios_unit_name(relation_name='nrpe-external-master'):
+    """
+    Return the nagios unit name prepended with host_context if needed
+
+    :param str relation_name: Name of relation nrpe sub joined to
+    """
+    host_context = get_nagios_hostcontext(relation_name)
+    if host_context:
+        unit = "%s:%s" % (host_context, local_unit())
+    else:
+        unit = local_unit()
+    return unit
+
+
+def add_init_service_checks(nrpe, services, unit_name, immediate_check=True):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param list services: List of services to check
+    :param str unit_name: Unit name to use in check description
+    :param bool immediate_check: For sysv init, run the service check immediately
+    """
+    for svc in services:
+        # Don't add a check for these services from neutron-gateway
+        if svc in ['ext-port', 'os-charm-phy-nic-mtu']:
+            next
+
+        upstart_init = '/etc/init/%s.conf' % svc
+        sysv_init = '/etc/init.d/%s' % svc
+
+        if host.init_is_systemd():
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_systemd.py %s' % svc
+            )
+        elif os.path.exists(upstart_init):
+            nrpe.add_check(
+                shortname=svc,
+                description='process check {%s}' % unit_name,
+                check_cmd='check_upstart_job %s' % svc
+            )
+        elif os.path.exists(sysv_init):
+            cronpath = '/etc/cron.d/nagios-service-check-%s' % svc
+            checkpath = '%s/service-check-%s.txt' % (nrpe.homedir, svc)
+            croncmd = (
+                '/usr/local/lib/nagios/plugins/check_exit_status.pl '
+                '-e -s /etc/init.d/%s status' % svc
+            )
+            cron_file = '*/5 * * * * root %s > %s\n' % (croncmd, checkpath)
+            f = open(cronpath, 'w')
+            f.write(cron_file)
+            f.close()
+            nrpe.add_check(
+                shortname=svc,
+                description='service check {%s}' % unit_name,
+                check_cmd='check_status_file.py -f %s' % checkpath,
+            )
+            # if /var/lib/nagios doesn't exist open(checkpath, 'w') will fail
+            # (LP: #1670223).
+            if immediate_check and os.path.isdir(nrpe.homedir):
+                f = open(checkpath, 'w')
+                subprocess.call(
+                    croncmd.split(),
+                    stdout=f,
+                    stderr=subprocess.STDOUT
+                )
+                f.close()
+                os.chmod(checkpath, 0o644)
+
+
+def copy_nrpe_checks(nrpe_files_dir=None):
+    """
+    Copy the nrpe checks into place
+
+    """
+    NAGIOS_PLUGINS = '/usr/local/lib/nagios/plugins'
+    if nrpe_files_dir is None:
+        # determine if "charmhelpers" is in CHARMDIR or CHARMDIR/hooks
+        for segment in ['.', 'hooks']:
+            nrpe_files_dir = os.path.abspath(os.path.join(
+                os.getenv('CHARM_DIR'),
+                segment,
+                'charmhelpers',
+                'contrib',
+                'openstack',
+                'files'))
+            if os.path.isdir(nrpe_files_dir):
+                break
+        else:
+            raise RuntimeError("Couldn't find charmhelpers directory")
+    if not os.path.exists(NAGIOS_PLUGINS):
+        os.makedirs(NAGIOS_PLUGINS)
+    for fname in glob.glob(os.path.join(nrpe_files_dir, "check_*")):
+        if os.path.isfile(fname):
+            shutil.copy2(fname,
+                         os.path.join(NAGIOS_PLUGINS, os.path.basename(fname)))
+
+
+def add_haproxy_checks(nrpe, unit_name):
+    """
+    Add checks for each service in list
+
+    :param NRPE nrpe: NRPE object to add check to
+    :param str unit_name: Unit name to use in check description
+    """
+    nrpe.add_check(
+        shortname='haproxy_servers',
+        description='Check HAProxy {%s}' % unit_name,
+        check_cmd='check_haproxy.sh')
+    nrpe.add_check(
+        shortname='haproxy_queue',
+        description='Check HAProxy queue depth {%s}' % unit_name,
+        check_cmd='check_haproxy_queue_depth.sh')
+
+
+def remove_deprecated_check(nrpe, deprecated_services):
+    """
+    Remove checks fro deprecated services in list
+
+    :param nrpe: NRPE object to remove check from
+    :type nrpe: NRPE
+    :param deprecated_services: List of deprecated services that are removed
+    :type deprecated_services: list
+    """
+    for dep_svc in deprecated_services:
+        log('Deprecated service: {}'.format(dep_svc))
+        nrpe.remove_check(shortname=dep_svc)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/volumes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/volumes.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ea43f0888cd92ac4344f908aa7c9d0afe7568ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/charmsupport/volumes.py
@@ -0,0 +1,173 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Functions for managing volumes in juju units. One volume is supported per unit.
+Subordinates may have their own storage, provided it is on its own partition.
+
+Configuration stanzas::
+
+  volume-ephemeral:
+    type: boolean
+    default: true
+    description: >
+      If false, a volume is mounted as sepecified in "volume-map"
+      If true, ephemeral storage will be used, meaning that log data
+         will only exist as long as the machine. YOU HAVE BEEN WARNED.
+  volume-map:
+    type: string
+    default: {}
+    description: >
+      YAML map of units to device names, e.g:
+        "{ rsyslog/0: /dev/vdb, rsyslog/1: /dev/vdb }"
+      Service units will raise a configure-error if volume-ephemeral
+      is 'true' and no volume-map value is set. Use 'juju set' to set a
+      value and 'juju resolved' to complete configuration.
+
+Usage::
+
+    from charmsupport.volumes import configure_volume, VolumeConfigurationError
+    from charmsupport.hookenv import log, ERROR
+    def post_mount_hook():
+        stop_service('myservice')
+    def post_mount_hook():
+        start_service('myservice')
+
+    if __name__ == '__main__':
+        try:
+            configure_volume(before_change=pre_mount_hook,
+                             after_change=post_mount_hook)
+        except VolumeConfigurationError:
+            log('Storage could not be configured', ERROR)
+
+'''
+
+# XXX: Known limitations
+# - fstab is neither consulted nor updated
+
+import os
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+import yaml
+
+
+MOUNT_BASE = '/srv/juju/volumes'
+
+
+class VolumeConfigurationError(Exception):
+    '''Volume configuration data is missing or invalid'''
+    pass
+
+
+def get_config():
+    '''Gather and sanity-check volume configuration data'''
+    volume_config = {}
+    config = hookenv.config()
+
+    errors = False
+
+    if config.get('volume-ephemeral') in (True, 'True', 'true', 'Yes', 'yes'):
+        volume_config['ephemeral'] = True
+    else:
+        volume_config['ephemeral'] = False
+
+    try:
+        volume_map = yaml.safe_load(config.get('volume-map', '{}'))
+    except yaml.YAMLError as e:
+        hookenv.log("Error parsing YAML volume-map: {}".format(e),
+                    hookenv.ERROR)
+        errors = True
+    if volume_map is None:
+        # probably an empty string
+        volume_map = {}
+    elif not isinstance(volume_map, dict):
+        hookenv.log("Volume-map should be a dictionary, not {}".format(
+            type(volume_map)))
+        errors = True
+
+    volume_config['device'] = volume_map.get(os.environ['JUJU_UNIT_NAME'])
+    if volume_config['device'] and volume_config['ephemeral']:
+        # asked for ephemeral storage but also defined a volume ID
+        hookenv.log('A volume is defined for this unit, but ephemeral '
+                    'storage was requested', hookenv.ERROR)
+        errors = True
+    elif not volume_config['device'] and not volume_config['ephemeral']:
+        # asked for permanent storage but did not define volume ID
+        hookenv.log('Ephemeral storage was requested, but there is no volume '
+                    'defined for this unit.', hookenv.ERROR)
+        errors = True
+
+    unit_mount_name = hookenv.local_unit().replace('/', '-')
+    volume_config['mountpoint'] = os.path.join(MOUNT_BASE, unit_mount_name)
+
+    if errors:
+        return None
+    return volume_config
+
+
+def mount_volume(config):
+    if os.path.exists(config['mountpoint']):
+        if not os.path.isdir(config['mountpoint']):
+            hookenv.log('Not a directory: {}'.format(config['mountpoint']))
+            raise VolumeConfigurationError()
+    else:
+        host.mkdir(config['mountpoint'])
+    if os.path.ismount(config['mountpoint']):
+        unmount_volume(config)
+    if not host.mount(config['device'], config['mountpoint'], persist=True):
+        raise VolumeConfigurationError()
+
+
+def unmount_volume(config):
+    if os.path.ismount(config['mountpoint']):
+        if not host.umount(config['mountpoint'], persist=True):
+            raise VolumeConfigurationError()
+
+
+def managed_mounts():
+    '''List of all mounted managed volumes'''
+    return filter(lambda mount: mount[0].startswith(MOUNT_BASE), host.mounts())
+
+
+def configure_volume(before_change=lambda: None, after_change=lambda: None):
+    '''Set up storage (or don't) according to the charm's volume configuration.
+       Returns the mount point or "ephemeral". before_change and after_change
+       are optional functions to be called if the volume configuration changes.
+    '''
+
+    config = get_config()
+    if not config:
+        hookenv.log('Failed to read volume configuration', hookenv.CRITICAL)
+        raise VolumeConfigurationError()
+
+    if config['ephemeral']:
+        if os.path.ismount(config['mountpoint']):
+            before_change()
+            unmount_volume(config)
+            after_change()
+        return 'ephemeral'
+    else:
+        # persistent storage
+        if os.path.ismount(config['mountpoint']):
+            mounts = dict(managed_mounts())
+            if mounts.get(config['mountpoint']) != config['device']:
+                before_change()
+                unmount_volume(config)
+                mount_volume(config)
+                after_change()
+        else:
+            before_change()
+            mount_volume(config)
+            after_change()
+        return config['mountpoint']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..64fac9def6101c1de83cd5dafe7fdb5213d6a955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/__init__.py
@@ -0,0 +1,11 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/mysql.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/mysql.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9ecce5f793eedeb963557d109deaf5e1271e65f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/database/mysql.py
@@ -0,0 +1,821 @@
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Helper for working with a MySQL database"""
+import collections
+import copy
+import json
+import re
+import sys
+import platform
+import os
+import glob
+import six
+
+# from string import upper
+
+from charmhelpers.core.host import (
+    CompareHostReleases,
+    lsb_release,
+    mkdir,
+    pwgen,
+    write_file
+)
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    related_units,
+    unit_get,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    leader_get,
+    leader_set,
+    is_leader,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+    filter_installed_packages,
+)
+from charmhelpers.contrib.network.ip import get_host_ip
+
+try:
+    import MySQLdb
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install(filter_installed_packages(['python-mysqldb']), fatal=True)
+    else:
+        apt_install(filter_installed_packages(['python3-mysqldb']), fatal=True)
+    import MySQLdb
+
+
+class MySQLSetPasswordError(Exception):
+    pass
+
+
+class MySQLHelper(object):
+
+    def __init__(self, rpasswdf_template, upasswdf_template, host='localhost',
+                 migrate_passwd_to_leader_storage=True,
+                 delete_ondisk_passwd_file=True, user="root", password=None, port=None):
+        self.user = user
+        self.host = host
+        self.password = password
+        self.port = port
+
+        # Password file path templates
+        self.root_passwd_file_template = rpasswdf_template
+        self.user_passwd_file_template = upasswdf_template
+
+        self.migrate_passwd_to_leader_storage = migrate_passwd_to_leader_storage
+        # If we migrate we have the option to delete local copy of root passwd
+        self.delete_ondisk_passwd_file = delete_ondisk_passwd_file
+        self.connection = None
+
+    def connect(self, user='root', password=None, host=None, port=None):
+        _connection_info = {
+            "user": user or self.user,
+            "passwd": password or self.password,
+            "host": host or self.host
+        }
+        # port cannot be None but we also do not want to specify it unless it
+        # has been explicit set.
+        port = port or self.port
+        if port is not None:
+            _connection_info["port"] = port
+
+        log("Opening db connection for %s@%s" % (user, host), level=DEBUG)
+        self.connection = MySQLdb.connect(**_connection_info)
+
+    def database_exists(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("SHOW DATABASES")
+            databases = [i[0] for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+
+        return db_name in databases
+
+    def create_database(self, db_name):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("CREATE DATABASE `{}` CHARACTER SET UTF8"
+                           .format(db_name))
+        finally:
+            cursor.close()
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = "GRANT ALL PRIVILEGES ON `{}`.* " \
+                      "TO '{}'@'{}'".format(db_name, db_user, remote_ip)
+        try:
+            cursor.execute("SHOW GRANTS for '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # TODO: review for different grants
+        return priv_string in grants
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            # TODO: review for different grants
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_name,
+                                                       db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def create_admin_grant(self, db_user, remote_ip, password):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON *.* TO '{}'@'{}' "
+                           "IDENTIFIED BY '{}'".format(db_user,
+                                                       remote_ip,
+                                                       password))
+        finally:
+            cursor.close()
+
+    def cleanup_grant(self, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("DROP FROM mysql.user WHERE user='{}' "
+                           "AND HOST='{}'".format(db_user,
+                                                  remote_ip))
+        finally:
+            cursor.close()
+
+    def flush_priviledges(self):
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("FLUSH PRIVILEGES")
+        finally:
+            cursor.close()
+
+    def execute(self, sql):
+        """Execute arbitary SQL against the database."""
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+        finally:
+            cursor.close()
+
+    def select(self, sql):
+        """
+        Execute arbitrary SQL select query against the database
+        and return the results.
+
+        :param sql: SQL select query to execute
+        :type sql: string
+        :returns: SQL select query result
+        :rtype: list of lists
+        :raises: MySQLdb.Error
+        """
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(sql)
+            results = [list(i) for i in cursor.fetchall()]
+        finally:
+            cursor.close()
+        return results
+
+    def migrate_passwords_to_leader_storage(self, excludes=None):
+        """Migrate any passwords storage on disk to leader storage."""
+        if not is_leader():
+            log("Skipping password migration as not the lead unit",
+                level=DEBUG)
+            return
+        dirname = os.path.dirname(self.root_passwd_file_template)
+        path = os.path.join(dirname, '*.passwd')
+        for f in glob.glob(path):
+            if excludes and f in excludes:
+                log("Excluding %s from leader storage migration" % (f),
+                    level=DEBUG)
+                continue
+
+            key = os.path.basename(f)
+            with open(f, 'r') as passwd:
+                _value = passwd.read().strip()
+
+            try:
+                leader_set(settings={key: _value})
+
+                if self.delete_ondisk_passwd_file:
+                    os.unlink(f)
+            except ValueError:
+                # NOTE cluster relation not yet ready - skip for now
+                pass
+
+    def get_mysql_password_on_disk(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username on disk."""
+        if username:
+            template = self.user_passwd_file_template
+            passwd_file = template.format(username)
+        else:
+            passwd_file = self.root_passwd_file_template
+
+        _password = None
+        if os.path.exists(passwd_file):
+            log("Using existing password file '%s'" % passwd_file, level=DEBUG)
+            with open(passwd_file, 'r') as passwd:
+                _password = passwd.read().strip()
+        else:
+            log("Generating new password file '%s'" % passwd_file, level=DEBUG)
+            if not os.path.isdir(os.path.dirname(passwd_file)):
+                # NOTE: need to ensure this is not mysql root dir (which needs
+                # to be mysql readable)
+                mkdir(os.path.dirname(passwd_file), owner='root', group='root',
+                      perms=0o770)
+                # Force permissions - for some reason the chmod in makedirs
+                # fails
+                os.chmod(os.path.dirname(passwd_file), 0o770)
+
+            _password = password or pwgen(length=32)
+            write_file(passwd_file, _password, owner='root', group='root',
+                       perms=0o660)
+
+        return _password
+
+    def passwd_keys(self, username):
+        """Generator to return keys used to store passwords in peer store.
+
+        NOTE: we support both legacy and new format to support mysql
+        charm prior to refactor. This is necessary to avoid LP 1451890.
+        """
+        keys = []
+        if username == 'mysql':
+            log("Bad username '%s'" % (username), level=WARNING)
+
+        if username:
+            # IMPORTANT: *newer* format must be returned first
+            keys.append('mysql-%s.passwd' % (username))
+            keys.append('%s.passwd' % (username))
+        else:
+            keys.append('mysql.passwd')
+
+        for key in keys:
+            yield key
+
+    def get_mysql_password(self, username=None, password=None):
+        """Retrieve, generate or store a mysql password for the provided
+        username using peer relation cluster."""
+        excludes = []
+
+        # First check peer relation.
+        try:
+            for key in self.passwd_keys(username):
+                _password = leader_get(key)
+                if _password:
+                    break
+
+            # If root password available don't update peer relation from local
+            if _password and not username:
+                excludes.append(self.root_passwd_file_template)
+
+        except ValueError:
+            # cluster relation is not yet started; use on-disk
+            _password = None
+
+        # If none available, generate new one
+        if not _password:
+            _password = self.get_mysql_password_on_disk(username, password)
+
+        # Put on wire if required
+        if self.migrate_passwd_to_leader_storage:
+            self.migrate_passwords_to_leader_storage(excludes=excludes)
+
+        return _password
+
+    def get_mysql_root_password(self, password=None):
+        """Retrieve or generate mysql root password for service units."""
+        return self.get_mysql_password(username=None, password=password)
+
+    def set_mysql_password(self, username, password, current_password=None):
+        """Update a mysql password for the provided username changing the
+        leader settings
+
+        To update root's password pass `None` in the username
+
+        :param username: Username to change password of
+        :type username: str
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+
+        if username is None:
+            username = 'root'
+
+        # get root password via leader-get, it may be that in the past (when
+        # changes to root-password were not supported) the user changed the
+        # password, so leader-get is more reliable source than
+        # config.previous('root-password').
+        rel_username = None if username == 'root' else username
+        if not current_password:
+            current_password = self.get_mysql_password(rel_username)
+
+        # password that needs to be set
+        new_passwd = password
+
+        # update password for all users (e.g. root@localhost, root@::1, etc)
+        try:
+            self.connect(user=username, password=current_password)
+            cursor = self.connection.cursor()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using password in '
+                                         'leader settings (%s)') % ex, ex)
+
+        try:
+            # NOTE(freyes): Due to skip-name-resolve root@$HOSTNAME account
+            # fails when using SET PASSWORD so using UPDATE against the
+            # mysql.user table is needed, but changes to this table are not
+            # replicated across the cluster, so this update needs to run in
+            # all the nodes. More info at
+            # http://galeracluster.com/documentation-webpages/userchanges.html
+            release = CompareHostReleases(lsb_release()['DISTRIB_CODENAME'])
+            if release < 'bionic':
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET password = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            else:
+                # PXC 5.7 (introduced in Bionic) uses authentication_string
+                SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET "
+                                     "authentication_string = "
+                                     "PASSWORD( %s ) WHERE user = %s;")
+            cursor.execute(SQL_UPDATE_PASSWD, (new_passwd, username))
+            cursor.execute('FLUSH PRIVILEGES;')
+            self.connection.commit()
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError('Cannot update password: %s' % str(ex),
+                                        ex)
+        finally:
+            cursor.close()
+
+        # check the password was changed
+        try:
+            self.connect(user=username, password=new_passwd)
+            self.execute('select 1;')
+        except MySQLdb.OperationalError as ex:
+            raise MySQLSetPasswordError(('Cannot connect using new password: '
+                                         '%s') % str(ex), ex)
+
+        if not is_leader():
+            log('Only the leader can set a new password in the relation',
+                level=DEBUG)
+            return
+
+        for key in self.passwd_keys(rel_username):
+            _password = leader_get(key)
+            if _password:
+                log('Updating password for %s (%s)' % (key, rel_username),
+                    level=DEBUG)
+                leader_set(settings={key: new_passwd})
+
+    def set_mysql_root_password(self, password, current_password=None):
+        """Update mysql root password changing the leader settings
+
+        :param password: New password for user.
+        :type password: str
+        :param current_password: Existing password for user.
+        :type current_password: str
+        """
+        self.set_mysql_password(
+            'root',
+            password,
+            current_password=current_password)
+
+    def normalize_address(self, hostname):
+        """Ensure that address returned is an IP address (i.e. not fqdn)"""
+        if config_get('prefer-ipv6'):
+            # TODO: add support for ipv6 dns
+            return hostname
+
+        if hostname != unit_get('private-address'):
+            return get_host_ip(hostname, fallback=hostname)
+
+        # Otherwise assume localhost
+        return '127.0.0.1'
+
+    def get_allowed_units(self, database, username, relation_id=None):
+        """Get list of units with access grants for database with username.
+
+        This is typically used to provide shared-db relations with a list of
+        which units have been granted access to the given database.
+        """
+        self.connect(password=self.get_mysql_root_password())
+        allowed_units = set()
+        for unit in related_units(relation_id):
+            settings = relation_get(rid=relation_id, unit=unit)
+            # First check for setting with prefix, then without
+            for attr in ["%s_hostname" % (database), 'hostname']:
+                hosts = settings.get(attr, None)
+                if hosts:
+                    break
+
+            if hosts:
+                # hostname can be json-encoded list of hostnames
+                try:
+                    hosts = json.loads(hosts)
+                except ValueError:
+                    hosts = [hosts]
+            else:
+                hosts = [settings['private-address']]
+
+            if hosts:
+                for host in hosts:
+                    host = self.normalize_address(host)
+                    if self.grant_exists(database, username, host):
+                        log("Grant exists for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+                        if unit not in allowed_units:
+                            allowed_units.add(unit)
+                    else:
+                        log("Grant does NOT exist for host '%s' on db '%s'" %
+                            (host, database), level=DEBUG)
+            else:
+                log("No hosts found for grant check", level=INFO)
+
+        return allowed_units
+
+    def configure_db(self, hostname, database, username, admin=False):
+        """Configure access to database for username from hostname."""
+        self.connect(password=self.get_mysql_root_password())
+        if not self.database_exists(database):
+            self.create_database(database)
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        if not self.grant_exists(database, username, remote_ip):
+            if not admin:
+                self.create_grant(database, username, remote_ip, password)
+            else:
+                self.create_admin_grant(username, remote_ip, password)
+            self.flush_priviledges()
+
+        return password
+
+
+# `_singleton_config_helper` stores the instance of the helper class that is
+# being used during a hook invocation.
+_singleton_config_helper = None
+
+
+def get_mysql_config_helper():
+    global _singleton_config_helper
+    if _singleton_config_helper is None:
+        _singleton_config_helper = MySQLConfigHelper()
+    return _singleton_config_helper
+
+
+class MySQLConfigHelper(object):
+    """Base configuration helper for MySQL."""
+
+    # Going for the biggest page size to avoid wasted bytes.
+    # InnoDB page size is 16MB
+
+    DEFAULT_PAGE_SIZE = 16 * 1024 * 1024
+    DEFAULT_INNODB_BUFFER_FACTOR = 0.50
+    DEFAULT_INNODB_BUFFER_SIZE_MAX = 512 * 1024 * 1024
+
+    # Validation and lookups for InnoDB configuration
+    INNODB_VALID_BUFFERING_VALUES = [
+        'none',
+        'inserts',
+        'deletes',
+        'changes',
+        'purges',
+        'all'
+    ]
+    INNODB_FLUSH_CONFIG_VALUES = {
+        'fast': 2,
+        'safest': 1,
+        'unsafe': 0,
+    }
+
+    def human_to_bytes(self, human):
+        """Convert human readable configuration options to bytes."""
+        num_re = re.compile('^[0-9]+$')
+        if num_re.match(human):
+            return human
+
+        factors = {
+            'K': 1024,
+            'M': 1048576,
+            'G': 1073741824,
+            'T': 1099511627776
+        }
+        modifier = human[-1]
+        if modifier in factors:
+            return int(human[:-1]) * factors[modifier]
+
+        if modifier == '%':
+            total_ram = self.human_to_bytes(self.get_mem_total())
+            if self.is_32bit_system() and total_ram > self.sys_mem_limit():
+                total_ram = self.sys_mem_limit()
+            factor = int(human[:-1]) * 0.01
+            pctram = total_ram * factor
+            return int(pctram - (pctram % self.DEFAULT_PAGE_SIZE))
+
+        raise ValueError("Can only convert K,M,G, or T")
+
+    def is_32bit_system(self):
+        """Determine whether system is 32 or 64 bit."""
+        try:
+            return sys.maxsize < 2 ** 32
+        except OverflowError:
+            return False
+
+    def sys_mem_limit(self):
+        """Determine the default memory limit for the current service unit."""
+        if platform.machine() in ['armv7l']:
+            _mem_limit = self.human_to_bytes('2700M')  # experimentally determined
+        else:
+            # Limit for x86 based 32bit systems
+            _mem_limit = self.human_to_bytes('4G')
+
+        return _mem_limit
+
+    def get_mem_total(self):
+        """Calculate the total memory in the current service unit."""
+        with open('/proc/meminfo') as meminfo_file:
+            for line in meminfo_file:
+                key, mem = line.split(':', 2)
+                if key == 'MemTotal':
+                    mtot, modifier = mem.strip().split(' ')
+                    return '%s%s' % (mtot, modifier[0].upper())
+
+    def get_innodb_flush_log_at_trx_commit(self):
+        """Get value for innodb_flush_log_at_trx_commit.
+
+        Use the innodb-flush-log-at-trx-commit or the tunning-level setting
+        translated by INNODB_FLUSH_CONFIG_VALUES to get the
+        innodb_flush_log_at_trx_commit value.
+
+        :returns: Numeric value for innodb_flush_log_at_trx_commit
+        :rtype: Union[None, int]
+        """
+        _iflatc = config_get('innodb-flush-log-at-trx-commit')
+        _tuning_level = config_get('tuning-level')
+        if _iflatc:
+            return _iflatc
+        elif _tuning_level:
+            return self.INNODB_FLUSH_CONFIG_VALUES.get(_tuning_level, 1)
+
+    def get_innodb_change_buffering(self):
+        """Get value for innodb_change_buffering.
+
+        Use the innodb-change-buffering validated against
+        INNODB_VALID_BUFFERING_VALUES to get the innodb_change_buffering value.
+
+        :returns: String value for innodb_change_buffering.
+        :rtype: Union[None, str]
+        """
+        _icb = config_get('innodb-change-buffering')
+        if _icb and _icb in self.INNODB_VALID_BUFFERING_VALUES:
+            return _icb
+
+    def get_innodb_buffer_pool_size(self):
+        """Get value for innodb_buffer_pool_size.
+
+        Return the number value of innodb-buffer-pool-size or dataset-size. If
+        neither is set, calculate a sane default based on total memory.
+
+        :returns: Numeric value for innodb_buffer_pool_size.
+        :rtype: int
+        """
+        total_memory = self.human_to_bytes(self.get_mem_total())
+
+        dataset_bytes = config_get('dataset-size')
+        innodb_buffer_pool_size = config_get('innodb-buffer-pool-size')
+
+        if innodb_buffer_pool_size:
+            innodb_buffer_pool_size = self.human_to_bytes(
+                innodb_buffer_pool_size)
+        elif dataset_bytes:
+            log("Option 'dataset-size' has been deprecated, please use"
+                "innodb_buffer_pool_size option instead", level="WARN")
+            innodb_buffer_pool_size = self.human_to_bytes(
+                dataset_bytes)
+        else:
+            # NOTE(jamespage): pick the smallest of 50% of RAM or 512MB
+            #                  to ensure that deployments in containers
+            #                  without constraints don't try to consume
+            #                  silly amounts of memory.
+            innodb_buffer_pool_size = min(
+                int(total_memory * self.DEFAULT_INNODB_BUFFER_FACTOR),
+                self.DEFAULT_INNODB_BUFFER_SIZE_MAX
+            )
+
+        if innodb_buffer_pool_size > total_memory:
+            log("innodb_buffer_pool_size; {} is greater than system available memory:{}".format(
+                innodb_buffer_pool_size,
+                total_memory), level='WARN')
+
+        return innodb_buffer_pool_size
+
+
+class PerconaClusterHelper(MySQLConfigHelper):
+    """Percona-cluster specific configuration helper."""
+
+    def parse_config(self):
+        """Parse charm configuration and calculate values for config files."""
+        config = config_get()
+        mysql_config = {}
+        if 'max-connections' in config:
+            mysql_config['max_connections'] = config['max-connections']
+
+        if 'wait-timeout' in config:
+            mysql_config['wait_timeout'] = config['wait-timeout']
+
+        if self.get_innodb_flush_log_at_trx_commit() is not None:
+            mysql_config['innodb_flush_log_at_trx_commit'] = \
+                self.get_innodb_flush_log_at_trx_commit()
+
+        if self.get_innodb_change_buffering() is not None:
+            mysql_config['innodb_change_buffering'] = config['innodb-change-buffering']
+
+        if 'innodb-io-capacity' in config:
+            mysql_config['innodb_io_capacity'] = config['innodb-io-capacity']
+
+        # Set a sane default key_buffer size
+        mysql_config['key_buffer'] = self.human_to_bytes('32M')
+        mysql_config['innodb_buffer_pool_size'] = self.get_innodb_buffer_pool_size()
+        return mysql_config
+
+
+class MySQL8Helper(MySQLHelper):
+
+    def grant_exists(self, db_name, db_user, remote_ip):
+        cursor = self.connection.cursor()
+        priv_string = ("GRANT ALL PRIVILEGES ON {}.* "
+                       "TO {}@{}".format(db_name, db_user, remote_ip))
+        try:
+            cursor.execute("SHOW GRANTS FOR '{}'@'{}'".format(db_user,
+                                                              remote_ip))
+            grants = [i[0] for i in cursor.fetchall()]
+        except MySQLdb.OperationalError:
+            return False
+        finally:
+            cursor.close()
+
+        # Different versions of MySQL use ' or `. Ignore these in the check.
+        return priv_string in [
+            i.replace("'", "").replace("`", "") for i in grants]
+
+    def create_grant(self, db_name, db_user, remote_ip, password):
+        if self.grant_exists(db_name, db_user, remote_ip):
+            return
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}'"
+                           .format(db_name, db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def create_user(self, db_user, remote_ip, password):
+
+        SQL_USER_CREATE = (
+            "CREATE USER '{db_user}'@'{remote_ip}' "
+            "IDENTIFIED BY '{password}'")
+
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute(SQL_USER_CREATE.format(
+                db_user=db_user,
+                remote_ip=remote_ip,
+                password=password)
+            )
+        except MySQLdb._exceptions.OperationalError:
+            log("DB user {} already exists.".format(db_user),
+                "WARNING")
+        finally:
+            cursor.close()
+
+    def create_router_grant(self, db_user, remote_ip, password):
+
+        # Make sure the user exists
+        # MySQL8 must create the user before the grant
+        self.create_user(db_user, remote_ip, password)
+
+        # Mysql-Router specific grants
+        cursor = self.connection.cursor()
+        try:
+            cursor.execute("GRANT CREATE USER ON *.* TO '{}'@'{}' WITH GRANT "
+                           "OPTION".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT, INSERT, UPDATE, DELETE, EXECUTE ON "
+                           "mysql_innodb_cluster_metadata.* TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON mysql.user TO '{}'@'{}'"
+                           .format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_members "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.replication_group_member_stats "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+            cursor.execute("GRANT SELECT ON "
+                           "performance_schema.global_variables "
+                           "TO '{}'@'{}'".format(db_user, remote_ip))
+        finally:
+            cursor.close()
+
+    def configure_router(self, hostname, username):
+
+        if self.connection is None:
+            self.connect(password=self.get_mysql_root_password())
+
+        remote_ip = self.normalize_address(hostname)
+        password = self.get_mysql_password(username)
+        self.create_user(username, remote_ip, password)
+        self.create_router_grant(username, remote_ip, password)
+
+        return password
+
+
+def get_prefix(requested, keys=None):
+    """Return existing prefix or None.
+
+    :param requested: Request string. i.e. novacell0_username
+    :type requested: str
+    :param keys: Keys to determine prefix. Defaults set in function.
+    :type keys: List of str keys
+    :returns: String prefix i.e. novacell0
+    :rtype: Union[None, str]
+    """
+    if keys is None:
+        # Shared-DB default keys
+        keys = ["_database", "_username", "_hostname"]
+    for key in keys:
+        if requested.endswith(key):
+            return requested[:-len(key)]
+
+
+def get_db_data(relation_data, unprefixed):
+    """Organize database requests into a collections.OrderedDict
+
+    :param relation_data: shared-db relation data
+    :type relation_data: dict
+    :param unprefixed: Prefix to use for requests without a prefix. This should
+                       be unique for each side of the relation to avoid
+                       conflicts.
+    :type unprefixed: str
+    :returns: Order dict of databases and users
+    :rtype: collections.OrderedDict
+    """
+    # Deep copy to avoid unintentionally changing relation data
+    settings = copy.deepcopy(relation_data)
+    databases = collections.OrderedDict()
+
+    # Clear non-db related elements
+    if "egress-subnets" in settings.keys():
+        settings.pop("egress-subnets")
+    if "ingress-address" in settings.keys():
+        settings.pop("ingress-address")
+    if "private-address" in settings.keys():
+        settings.pop("private-address")
+
+    singleset = {"database", "username", "hostname"}
+    if singleset.issubset(settings):
+        settings["{}_{}".format(unprefixed, "hostname")] = (
+            settings["hostname"])
+        settings.pop("hostname")
+        settings["{}_{}".format(unprefixed, "database")] = (
+            settings["database"])
+        settings.pop("database")
+        settings["{}_{}".format(unprefixed, "username")] = (
+            settings["username"])
+        settings.pop("username")
+
+    for k, v in settings.items():
+        db = k.split("_")[0]
+        x = "_".join(k.split("_")[1:])
+        if db not in databases:
+            databases[db] = collections.OrderedDict()
+        databases[db][x] = v
+
+    return databases
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..2c1e371e179bb6926f227331f86cb14a38c229a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/apache.py
@@ -0,0 +1,86 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import os
+
+from charmhelpers.core import host
+from charmhelpers.core.hookenv import (
+    config as config_get,
+    relation_get,
+    relation_ids,
+    related_units as relation_list,
+    log,
+    INFO,
+)
+
+
+def get_cert(cn=None):
+    # TODO: deal with multiple https endpoints via charm config
+    cert = config_get('ssl_cert')
+    key = config_get('ssl_key')
+    if not (cert and key):
+        log("Inspecting identity-service relations for SSL certificate.",
+            level=INFO)
+        cert = key = None
+        if cn:
+            ssl_cert_attr = 'ssl_cert_{}'.format(cn)
+            ssl_key_attr = 'ssl_key_{}'.format(cn)
+        else:
+            ssl_cert_attr = 'ssl_cert'
+            ssl_key_attr = 'ssl_key'
+        for r_id in relation_ids('identity-service'):
+            for unit in relation_list(r_id):
+                if not cert:
+                    cert = relation_get(ssl_cert_attr,
+                                        rid=r_id, unit=unit)
+                if not key:
+                    key = relation_get(ssl_key_attr,
+                                       rid=r_id, unit=unit)
+    return (cert, key)
+
+
+def get_ca_cert():
+    ca_cert = config_get('ssl_ca')
+    if ca_cert is None:
+        log("Inspecting identity-service relations for CA SSL certificate.",
+            level=INFO)
+        for r_id in (relation_ids('identity-service') +
+                     relation_ids('identity-credentials')):
+            for unit in relation_list(r_id):
+                if ca_cert is None:
+                    ca_cert = relation_get('ca_cert',
+                                           rid=r_id, unit=unit)
+    return ca_cert
+
+
+def retrieve_ca_cert(cert_file):
+    cert = None
+    if os.path.isfile(cert_file):
+        with open(cert_file, 'rb') as crt:
+            cert = crt.read()
+    return cert
+
+
+def install_ca_cert(ca_cert):
+    host.install_ca_cert(ca_cert, 'keystone_juju_ca_cert')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba34fba0cafa21d15a6a27946544b2c99fbd3663
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hahelpers/cluster.py
@@ -0,0 +1,451 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+"""
+Helpers for clustering and determining "cluster leadership" and other
+clustering-related helpers.
+"""
+
+import functools
+import subprocess
+import os
+import time
+
+from socket import gethostname as get_unit_hostname
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    relation_ids,
+    related_units as relation_list,
+    relation_get,
+    config as config_get,
+    INFO,
+    DEBUG,
+    WARNING,
+    unit_get,
+    is_leader as juju_is_leader,
+    status_set,
+)
+from charmhelpers.core.host import (
+    modulo_distribution,
+)
+from charmhelpers.core.decorators import (
+    retry_on_exception,
+)
+from charmhelpers.core.strutils import (
+    bool_from_string,
+)
+
+DC_RESOURCE_NAME = 'DC'
+
+
+class HAIncompleteConfig(Exception):
+    pass
+
+
+class HAIncorrectConfig(Exception):
+    pass
+
+
+class CRMResourceNotFound(Exception):
+    pass
+
+
+class CRMDCNotFound(Exception):
+    pass
+
+
+def is_elected_leader(resource):
+    """
+    Returns True if the charm executing this is the elected cluster leader.
+
+    It relies on two mechanisms to determine leadership:
+        1. If juju is sufficiently new and leadership election is supported,
+        the is_leader command will be used.
+        2. If the charm is part of a corosync cluster, call corosync to
+        determine leadership.
+        3. If the charm is not part of a corosync cluster, the leader is
+        determined as being "the alive unit with the lowest unit numer". In
+        other words, the oldest surviving unit.
+    """
+    try:
+        return juju_is_leader()
+    except NotImplementedError:
+        log('Juju leadership election feature not enabled'
+            ', using fallback support',
+            level=WARNING)
+
+    if is_clustered():
+        if not is_crm_leader(resource):
+            log('Deferring action to CRM leader.', level=INFO)
+            return False
+    else:
+        peers = peer_units()
+        if peers and not oldest_peer(peers):
+            log('Deferring action to oldest service unit.', level=INFO)
+            return False
+    return True
+
+
+def is_clustered():
+    for r_id in (relation_ids('ha') or []):
+        for unit in (relation_list(r_id) or []):
+            clustered = relation_get('clustered',
+                                     rid=r_id,
+                                     unit=unit)
+            if clustered:
+                return True
+    return False
+
+
+def is_crm_dc():
+    """
+    Determine leadership by querying the pacemaker Designated Controller
+    """
+    cmd = ['crm', 'status']
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError as ex:
+        raise CRMDCNotFound(str(ex))
+
+    current_dc = ''
+    for line in status.split('\n'):
+        if line.startswith('Current DC'):
+            # Current DC: juju-lytrusty-machine-2 (168108163) - partition with quorum
+            current_dc = line.split(':')[1].split()[0]
+    if current_dc == get_unit_hostname():
+        return True
+    elif current_dc == 'NONE':
+        raise CRMDCNotFound('Current DC: NONE')
+
+    return False
+
+
+@retry_on_exception(5, base_delay=2,
+                    exc_type=(CRMResourceNotFound, CRMDCNotFound))
+def is_crm_leader(resource, retry=False):
+    """
+    Returns True if the charm calling this is the elected corosync leader,
+    as returned by calling the external "crm" command.
+
+    We allow this operation to be retried to avoid the possibility of getting a
+    false negative. See LP #1396246 for more info.
+    """
+    if resource == DC_RESOURCE_NAME:
+        return is_crm_dc()
+    cmd = ['crm', 'resource', 'show', resource]
+    try:
+        status = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        if not isinstance(status, six.text_type):
+            status = six.text_type(status, "utf-8")
+    except subprocess.CalledProcessError:
+        status = None
+
+    if status and get_unit_hostname() in status:
+        return True
+
+    if status and "resource %s is NOT running" % (resource) in status:
+        raise CRMResourceNotFound("CRM resource %s not found" % (resource))
+
+    return False
+
+
+def is_leader(resource):
+    log("is_leader is deprecated. Please consider using is_crm_leader "
+        "instead.", level=WARNING)
+    return is_crm_leader(resource)
+
+
+def peer_units(peer_relation="cluster"):
+    peers = []
+    for r_id in (relation_ids(peer_relation) or []):
+        for unit in (relation_list(r_id) or []):
+            peers.append(unit)
+    return peers
+
+
+def peer_ips(peer_relation='cluster', addr_key='private-address'):
+    '''Return a dict of peers and their private-address'''
+    peers = {}
+    for r_id in relation_ids(peer_relation):
+        for unit in relation_list(r_id):
+            peers[unit] = relation_get(addr_key, rid=r_id, unit=unit)
+    return peers
+
+
+def oldest_peer(peers):
+    """Determines who the oldest peer is by comparing unit numbers."""
+    local_unit_no = int(os.getenv('JUJU_UNIT_NAME').split('/')[1])
+    for peer in peers:
+        remote_unit_no = int(peer.split('/')[1])
+        if remote_unit_no < local_unit_no:
+            return False
+    return True
+
+
+def eligible_leader(resource):
+    log("eligible_leader is deprecated. Please consider using "
+        "is_elected_leader instead.", level=WARNING)
+    return is_elected_leader(resource)
+
+
+def https():
+    '''
+    Determines whether enough data has been provided in configuration
+    or relation data to configure HTTPS
+    .
+    returns: boolean
+    '''
+    use_https = config_get('use-https')
+    if use_https and bool_from_string(use_https):
+        return True
+    if config_get('ssl_cert') and config_get('ssl_key'):
+        return True
+    for r_id in relation_ids('certificates'):
+        for unit in relation_list(r_id):
+            ca = relation_get('ca', rid=r_id, unit=unit)
+            if ca:
+                return True
+    for r_id in relation_ids('identity-service'):
+        for unit in relation_list(r_id):
+            # TODO - needs fixing for new helper as ssl_cert/key suffixes with CN
+            rel_state = [
+                relation_get('https_keystone', rid=r_id, unit=unit),
+                relation_get('ca_cert', rid=r_id, unit=unit),
+            ]
+            # NOTE: works around (LP: #1203241)
+            if (None not in rel_state) and ('' not in rel_state):
+                return True
+    return False
+
+
+def determine_api_port(public_port, singlenode_mode=False):
+    '''
+    Determine correct API server listening port based on
+    existence of HTTPS reverse proxy and/or haproxy.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the API service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    if https():
+        i += 1
+    return public_port - (i * 10)
+
+
+def determine_apache_port(public_port, singlenode_mode=False):
+    '''
+    Description: Determine correct apache listening port based on public IP +
+    state of the cluster.
+
+    public_port: int: standard public port for given service
+
+    singlenode_mode: boolean: Shuffle ports when only a single unit is present
+
+    returns: int: the correct listening port for the HAProxy service
+    '''
+    i = 0
+    if singlenode_mode:
+        i += 1
+    elif len(peer_units()) > 0 or is_clustered():
+        i += 1
+    return public_port - (i * 10)
+
+
+determine_apache_port_single = functools.partial(
+    determine_apache_port, singlenode_mode=True)
+
+
+def get_hacluster_config(exclude_keys=None):
+    '''
+    Obtains all relevant configuration from charm configuration required
+    for initiating a relation to hacluster:
+
+        ha-bindiface, ha-mcastport, vip, os-internal-hostname,
+        os-admin-hostname, os-public-hostname, os-access-hostname
+
+    param: exclude_keys: list of setting key(s) to be excluded.
+    returns: dict: A dict containing settings keyed by setting name.
+    raises: HAIncompleteConfig if settings are missing or incorrect.
+    '''
+    settings = ['ha-bindiface', 'ha-mcastport', 'vip', 'os-internal-hostname',
+                'os-admin-hostname', 'os-public-hostname', 'os-access-hostname']
+    conf = {}
+    for setting in settings:
+        if exclude_keys and setting in exclude_keys:
+            continue
+
+        conf[setting] = config_get(setting)
+
+    if not valid_hacluster_config():
+        raise HAIncorrectConfig('Insufficient or incorrect config data to '
+                                'configure hacluster.')
+    return conf
+
+
+def valid_hacluster_config():
+    '''
+    Check that either vip or dns-ha is set. If dns-ha then one of os-*-hostname
+    must be set.
+
+    Note: ha-bindiface and ha-macastport both have defaults and will always
+    be set. We only care that either vip or dns-ha is set.
+
+    :returns: boolean: valid config returns true.
+    raises: HAIncompatibileConfig if settings conflict.
+    raises: HAIncompleteConfig if settings are missing.
+    '''
+    vip = config_get('vip')
+    dns = config_get('dns-ha')
+    if not(bool(vip) ^ bool(dns)):
+        msg = ('HA: Either vip or dns-ha must be set but not both in order to '
+               'use high availability')
+        status_set('blocked', msg)
+        raise HAIncorrectConfig(msg)
+
+    # If dns-ha then one of os-*-hostname must be set
+    if dns:
+        dns_settings = ['os-internal-hostname', 'os-admin-hostname',
+                        'os-public-hostname', 'os-access-hostname']
+        # At this point it is unknown if one or all of the possible
+        # network spaces are in HA. Validate at least one is set which is
+        # the minimum required.
+        for setting in dns_settings:
+            if config_get(setting):
+                log('DNS HA: At least one hostname is set {}: {}'
+                    ''.format(setting, config_get(setting)),
+                    level=DEBUG)
+                return True
+
+        msg = ('DNS HA: At least one os-*-hostname(s) must be set to use '
+               'DNS HA')
+        status_set('blocked', msg)
+        raise HAIncompleteConfig(msg)
+
+    log('VIP HA: VIP is set {}'.format(vip), level=DEBUG)
+    return True
+
+
+def canonical_url(configs, vip_setting='vip'):
+    '''
+    Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration and hacluster.
+
+    :configs    : OSTemplateRenderer: A config tempating object to inspect for
+                                      a complete https context.
+
+    :vip_setting:                str: Setting in charm config that specifies
+                                      VIP address.
+    '''
+    scheme = 'http'
+    if 'https' in configs.complete_contexts():
+        scheme = 'https'
+    if is_clustered():
+        addr = config_get(vip_setting)
+    else:
+        addr = unit_get('private-address')
+    return '%s://%s' % (scheme, addr)
+
+
+def distributed_wait(modulo=None, wait=None, operation_name='operation'):
+    ''' Distribute operations by waiting based on modulo_distribution
+
+    If modulo and or wait are not set, check config_get for those values.
+    If config values are not set, default to modulo=3 and wait=30.
+
+    :param modulo: int The modulo number creates the group distribution
+    :param wait: int The constant time wait value
+    :param operation_name: string Operation name for status message
+                           i.e.  'restart'
+    :side effect: Calls config_get()
+    :side effect: Calls log()
+    :side effect: Calls status_set()
+    :side effect: Calls time.sleep()
+    '''
+    if modulo is None:
+        modulo = config_get('modulo-nodes') or 3
+    if wait is None:
+        wait = config_get('known-wait') or 30
+    if juju_is_leader():
+        # The leader should never wait
+        calculated_wait = 0
+    else:
+        # non_zero_wait=True guarantees the non-leader who gets modulo 0
+        # will still wait
+        calculated_wait = modulo_distribution(modulo=modulo, wait=wait,
+                                              non_zero_wait=True)
+    msg = "Waiting {} seconds for {} ...".format(calculated_wait,
+                                                 operation_name)
+    log(msg, DEBUG)
+    status_set('maintenance', msg)
+    time.sleep(calculated_wait)
+
+
+def get_managed_services_and_ports(services, external_ports,
+                                   external_services=None,
+                                   port_conv_f=determine_apache_port_single):
+    """Get the services and ports managed by this charm.
+
+    Return only the services and corresponding ports that are managed by this
+    charm. This excludes haproxy when there is a relation with hacluster. This
+    is because this charm passes responsability for stopping and starting
+    haproxy to hacluster.
+
+    Similarly, if a relation with hacluster exists then the ports returned by
+    this method correspond to those managed by the apache server rather than
+    haproxy.
+
+    :param services: List of services.
+    :type services: List[str]
+    :param external_ports: List of ports managed by external services.
+    :type external_ports: List[int]
+    :param external_services: List of services to be removed if ha relation is
+                              present.
+    :type external_services: List[str]
+    :param port_conv_f: Function to apply to ports to calculate the ports
+                        managed by services controlled by this charm.
+    :type port_convert_func: f()
+    :returns: A tuple containing a list of services first followed by a list of
+              ports.
+    :rtype: Tuple[List[str], List[int]]
+    """
+    if external_services is None:
+        external_services = ['haproxy']
+    if relation_ids('ha'):
+        for svc in external_services:
+            try:
+                services.remove(svc)
+            except ValueError:
+                pass
+        external_ports = [port_conv_f(p) for p in external_ports]
+    return services, external_ports
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/README.hardening.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/README.hardening.md
new file mode 100644
index 0000000000000000000000000000000000000000..91280c03e6d7b5d75b356cd94614fc821abc2644
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/README.hardening.md
@@ -0,0 +1,38 @@
+# Juju charm-helpers hardening library
+
+## Description
+
+This library provides multiple implementations of system and application
+hardening that conform to the standards of http://hardening.io/.
+
+Current implementations include:
+
+ * OS
+ * SSH
+ * MySQL
+ * Apache
+
+## Requirements
+
+* Juju Charms
+
+## Usage
+
+1. Synchronise this library into your charm and add the harden() decorator
+   (from contrib.hardening.harden) to any functions or methods you want to use
+   to trigger hardening of your application/system.
+
+2. Add a config option called 'harden' to your charm config.yaml and set it to
+   a space-delimited list of hardening modules you want to run e.g. "os ssh"
+
+3. Override any config defaults (contrib.hardening.defaults) by adding a file
+   called hardening.yaml to your charm root containing the name(s) of the
+   modules whose settings you want override at root level and then any settings
+   with overrides e.g.
+   
+   os:
+       general:
+            desktop_enable: True
+
+4. Now just run your charm as usual and hardening will be applied each time the
+   hook runs.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..30a3e94359e94011cd247de7ade76667346e7379
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3bc2ebd4760124e23c128868e098aceac610260f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.apache.checks import config
+
+
+def run_apache_checks():
+    log("Starting Apache hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("Apache hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..341da9eee10f73cbe3d7e7e5cf91b57b4d2a89b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/checks/config.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+import six
+import subprocess
+
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    NoReadWriteForOther,
+    TemplatedFile,
+    DeletedFile
+)
+from charmhelpers.contrib.hardening.audits.apache import DisabledModuleAudit
+from charmhelpers.contrib.hardening.apache import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get Apache hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'apache2'], stdout=subprocess.PIPE) != 0:
+        log("Apache server does not appear to be installed on this node - "
+            "skipping apache hardening", level=INFO)
+        return []
+
+    context = ApacheConfContext()
+    settings = utils.get_settings('apache')
+    audits = [
+        FilePermissionAudit(paths=os.path.join(
+                            settings['common']['apache_dir'], 'apache2.conf'),
+                            user='root', group='root', mode=0o0640),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'mods-available/alias.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        TemplatedFile(os.path.join(settings['common']['apache_dir'],
+                                   'conf-enabled/99-hardening.conf'),
+                      context,
+                      TEMPLATES_DIR,
+                      mode=0o0640,
+                      user='root',
+                      service_actions=[{'service': 'apache2',
+                                        'actions': ['restart']}]),
+
+        DirectoryPermissionAudit(settings['common']['apache_dir'],
+                                 user='root',
+                                 group='root',
+                                 mode=0o0750),
+
+        DisabledModuleAudit(settings['hardening']['modules_to_disable']),
+
+        NoReadWriteForOther(settings['common']['apache_dir']),
+
+        DeletedFile(['/var/www/html/index.html'])
+    ]
+
+    return audits
+
+
+class ApacheConfContext(object):
+    """Defines the set of key/value pairs to set in a apache config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/apache/conf-enabled/hardening.conf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('apache')
+        ctxt = settings['hardening']
+
+        out = subprocess.check_output(['apache2', '-v'])
+        if six.PY3:
+            out = out.decode('utf-8')
+        ctxt['apache_version'] = re.search(r'.+version: Apache/(.+?)\s.+',
+                                           out).group(1)
+        ctxt['apache_icondir'] = '/usr/share/apache2/icons/'
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..22b68041d50ff753284bbb4b41a21e8f2bd8c18a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/99-hardening.conf
@@ -0,0 +1,32 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+
+<Location / >
+  <LimitExcept {{ allowed_http_methods }} >
+    # http://httpd.apache.org/docs/2.4/upgrading.html
+    {% if apache_version > '2.2' -%}
+    Require all granted
+    {% else -%}
+    Order Allow,Deny
+    Deny from all
+    {% endif %}
+  </LimitExcept>
+</Location>
+
+<Directory />
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+<Directory /var/www/>
+    Options -Indexes -FollowSymLinks
+    AllowOverride None
+</Directory>
+
+TraceEnable {{ traceenable }}
+ServerTokens {{ servertokens }}
+
+SSLHonorCipherOrder {{ honor_cipher_order }}
+SSLCipherSuite {{ cipher_suite }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/alias.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/alias.conf
new file mode 100644
index 0000000000000000000000000000000000000000..e46a58a30dadbb6ccffa02d82593c63a9cbf52df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/apache/templates/alias.conf
@@ -0,0 +1,31 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+<IfModule alias_module>
+  #
+  # Aliases: Add here as many aliases as you need (with no limit). The format is
+  # Alias fakename realname
+  #
+  # Note that if you include a trailing / on fakename then the server will
+  # require it to be present in the URL.  So "/icons" isn't aliased in this
+  # example, only "/icons/".  If the fakename is slash-terminated, then the
+  # realname must also be slash terminated, and if the fakename omits the
+  # trailing slash, the realname must also omit it.
+  #
+  # We include the /icons/ alias for FancyIndexed directory listings.  If
+  # you do not use FancyIndexing, you may comment this out.
+  #
+  Alias /icons/ "{{ apache_icondir }}/"
+
+  <Directory "{{ apache_icondir }}">
+    Options -Indexes -MultiViews -FollowSymLinks
+    AllowOverride None
+{% if apache_version == '2.4' -%}
+    Require all granted
+{% else -%}
+    Order allow,deny
+    Allow from all
+{% endif %}
+  </Directory>
+</IfModule>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6dd5b05fec4ffcfcdb4378a06dfda4e8ac7e8371
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/__init__.py
@@ -0,0 +1,54 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class BaseAudit(object):  # NO-QA
+    """Base class for hardening checks.
+
+    The lifecycle of a hardening check is to first check to see if the system
+    is in compliance for the specified check. If it is not in compliance, the
+    check method will return a value which will be supplied to the.
+    """
+    def __init__(self, *args, **kwargs):
+        self.unless = kwargs.get('unless', None)
+        super(BaseAudit, self).__init__()
+
+    def ensure_compliance(self):
+        """Checks to see if the current hardening check is in compliance or
+        not.
+
+        If the check that is performed is not in compliance, then an exception
+        should be raised.
+        """
+        pass
+
+    def _take_action(self):
+        """Determines whether to perform the action or not.
+
+        Checks whether or not an action should be taken. This is determined by
+        the truthy value for the unless parameter. If unless is a callback
+        method, it will be invoked with no parameters in order to determine
+        whether or not the action should be taken. Otherwise, the truthy value
+        of the unless attribute will determine if the action should be
+        performed.
+        """
+        # Do the action if there isn't an unless override.
+        if self.unless is None:
+            return True
+
+        # Invoke the callback if there is one.
+        if hasattr(self.unless, '__call__'):
+            return not self.unless()
+
+        return not self.unless
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apache.py
new file mode 100644
index 0000000000000000000000000000000000000000..04825f5ada0c5b0bb9fc0955baa9a10fa199184d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apache.py
@@ -0,0 +1,100 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    ERROR,
+)
+
+from charmhelpers.contrib.hardening.audits import BaseAudit
+
+
+class DisabledModuleAudit(BaseAudit):
+    """Audits Apache2 modules.
+
+    Determines if the apache2 modules are enabled. If the modules are enabled
+    then they are removed in the ensure_compliance.
+    """
+    def __init__(self, modules):
+        if modules is None:
+            self.modules = []
+        elif isinstance(modules, six.string_types):
+            self.modules = [modules]
+        else:
+            self.modules = modules
+
+    def ensure_compliance(self):
+        """Ensures that the modules are not loaded."""
+        if not self.modules:
+            return
+
+        try:
+            loaded_modules = self._get_loaded_modules()
+            non_compliant_modules = []
+            for module in self.modules:
+                if module in loaded_modules:
+                    log("Module '%s' is enabled but should not be." %
+                        (module), level=INFO)
+                    non_compliant_modules.append(module)
+
+            if len(non_compliant_modules) == 0:
+                return
+
+            for module in non_compliant_modules:
+                self._disable_module(module)
+            self._restart_apache()
+        except subprocess.CalledProcessError as e:
+            log('Error occurred auditing apache module compliance. '
+                'This may have been already reported. '
+                'Output is: %s' % e.output, level=ERROR)
+
+    @staticmethod
+    def _get_loaded_modules():
+        """Returns the modules which are enabled in Apache."""
+        output = subprocess.check_output(['apache2ctl', '-M'])
+        if six.PY3:
+            output = output.decode('utf-8')
+        modules = []
+        for line in output.splitlines():
+            # Each line of the enabled module output looks like:
+            #  module_name (static|shared)
+            # Plus a header line at the top of the output which is stripped
+            # out by the regex.
+            matcher = re.search(r'^ (\S*)_module (\S*)', line)
+            if matcher:
+                modules.append(matcher.group(1))
+        return modules
+
+    @staticmethod
+    def _disable_module(module):
+        """Disables the specified module in Apache."""
+        try:
+            subprocess.check_call(['a2dismod', module])
+        except subprocess.CalledProcessError as e:
+            # Note: catch error here to allow the attempt of disabling
+            # multiple modules in one go rather than failing after the
+            # first module fails.
+            log('Error occurred disabling module %s. '
+                'Output is: %s' % (module, e.output), level=ERROR)
+
+    @staticmethod
+    def _restart_apache():
+        """Restarts the apache process"""
+        subprocess.check_output(['service', 'apache2', 'restart'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..cad7bf7376d6f22ce8feccd843b070c399887aa9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/apt.py
@@ -0,0 +1,104 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import  # required for external apt import
+from six import string_types
+
+from charmhelpers.fetch import (
+    apt_cache,
+    apt_purge
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.fetch import ubuntu_apt_pkg as apt_pkg
+
+
+class AptConfig(BaseAudit):
+
+    def __init__(self, config, **kwargs):
+        self.config = config
+
+    def verify_config(self):
+        apt_pkg.init()
+        for cfg in self.config:
+            value = apt_pkg.config.get(cfg['key'], cfg.get('default', ''))
+            if value and value != cfg['expected']:
+                log("APT config '%s' has unexpected value '%s' "
+                    "(expected='%s')" %
+                    (cfg['key'], value, cfg['expected']), level=WARNING)
+
+    def ensure_compliance(self):
+        self.verify_config()
+
+
+class RestrictedPackages(BaseAudit):
+    """Class used to audit restricted packages on the system."""
+
+    def __init__(self, pkgs, **kwargs):
+        super(RestrictedPackages, self).__init__(**kwargs)
+        if isinstance(pkgs, string_types) or not hasattr(pkgs, '__iter__'):
+            self.pkgs = pkgs.split()
+        else:
+            self.pkgs = pkgs
+
+    def ensure_compliance(self):
+        cache = apt_cache()
+
+        for p in self.pkgs:
+            if p not in cache:
+                continue
+
+            pkg = cache[p]
+            if not self.is_virtual_package(pkg):
+                if not pkg.current_ver:
+                    log("Package '%s' is not installed." % pkg.name,
+                        level=DEBUG)
+                    continue
+                else:
+                    log("Restricted package '%s' is installed" % pkg.name,
+                        level=WARNING)
+                    self.delete_package(cache, pkg)
+            else:
+                log("Checking restricted virtual package '%s' provides" %
+                    pkg.name, level=DEBUG)
+                self.delete_package(cache, pkg)
+
+    def delete_package(self, cache, pkg):
+        """Deletes the package from the system.
+
+        Deletes the package form the system, properly handling virtual
+        packages.
+
+        :param cache: the apt cache
+        :param pkg: the package to remove
+        """
+        if self.is_virtual_package(pkg):
+            log("Package '%s' appears to be virtual - purging provides" %
+                pkg.name, level=DEBUG)
+            for _p in pkg.provides_list:
+                self.delete_package(cache, _p[2].parent_pkg)
+        elif not pkg.current_ver:
+            log("Package '%s' not installed" % pkg.name, level=DEBUG)
+            return
+        else:
+            log("Purging package '%s'" % pkg.name, level=DEBUG)
+            apt_purge(pkg.name)
+
+    def is_virtual_package(self, pkg):
+        return (pkg.get('has_provides', False) and
+                not pkg.get('has_versions', False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/file.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/file.py
new file mode 100644
index 0000000000000000000000000000000000000000..257c6351a0b0d244273013faef913f52349f2486
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/audits/file.py
@@ -0,0 +1,550 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import grp
+import os
+import pwd
+import re
+
+from subprocess import (
+    CalledProcessError,
+    check_output,
+    check_call,
+)
+from traceback import format_exc
+from six import string_types
+from stat import (
+    S_ISGID,
+    S_ISUID
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core import unitdata
+from charmhelpers.core.host import file_hash
+from charmhelpers.contrib.hardening.audits import BaseAudit
+from charmhelpers.contrib.hardening.templating import (
+    get_template_path,
+    render_and_write,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+class BaseFileAudit(BaseAudit):
+    """Base class for file audits.
+
+    Provides api stubs for compliance check flow that must be used by any class
+    that implemented this one.
+    """
+
+    def __init__(self, paths, always_comply=False, *args, **kwargs):
+        """
+        :param paths: string path of list of paths of files we want to apply
+                      compliance checks are criteria to.
+        :param always_comply: if true compliance criteria is always applied
+                              else compliance is skipped for non-existent
+                              paths.
+        """
+        super(BaseFileAudit, self).__init__(*args, **kwargs)
+        self.always_comply = always_comply
+        if isinstance(paths, string_types) or not hasattr(paths, '__iter__'):
+            self.paths = [paths]
+        else:
+            self.paths = paths
+
+    def ensure_compliance(self):
+        """Ensure that the all registered files comply to registered criteria.
+        """
+        for p in self.paths:
+            if os.path.exists(p):
+                if self.is_compliant(p):
+                    continue
+
+                log('File %s is not in compliance.' % p, level=INFO)
+            else:
+                if not self.always_comply:
+                    log("Non-existent path '%s' - skipping compliance check"
+                        % (p), level=INFO)
+                    continue
+
+            if self._take_action():
+                log("Applying compliance criteria to '%s'" % (p), level=INFO)
+                self.comply(p)
+
+    def is_compliant(self, path):
+        """Audits the path to see if it is compliance.
+
+        :param path: the path to the file that should be checked.
+        """
+        raise NotImplementedError
+
+    def comply(self, path):
+        """Enforces the compliance of a path.
+
+        :param path: the path to the file that should be enforced.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def _get_stat(cls, path):
+        """Returns the Posix st_stat information for the specified file path.
+
+        :param path: the path to get the st_stat information for.
+        :returns: an st_stat object for the path or None if the path doesn't
+                  exist.
+        """
+        return os.stat(path)
+
+
+class FilePermissionAudit(BaseFileAudit):
+    """Implements an audit for file permissions and ownership for a user.
+
+    This class implements functionality that ensures that a specific user/group
+    will own the file(s) specified and that the permissions specified are
+    applied properly to the file.
+    """
+    def __init__(self, paths, user, group=None, mode=0o600, **kwargs):
+        self.user = user
+        self.group = group
+        self.mode = mode
+        super(FilePermissionAudit, self).__init__(paths, user, group, mode,
+                                                  **kwargs)
+
+    @property
+    def user(self):
+        return self._user
+
+    @user.setter
+    def user(self, name):
+        try:
+            user = pwd.getpwnam(name)
+        except KeyError:
+            log('Unknown user %s' % name, level=ERROR)
+            user = None
+        self._user = user
+
+    @property
+    def group(self):
+        return self._group
+
+    @group.setter
+    def group(self, name):
+        try:
+            group = None
+            if name:
+                group = grp.getgrnam(name)
+            else:
+                group = grp.getgrgid(self.user.pw_gid)
+        except KeyError:
+            log('Unknown group %s' % name, level=ERROR)
+        self._group = group
+
+    def is_compliant(self, path):
+        """Checks if the path is in compliance.
+
+        Used to determine if the path specified meets the necessary
+        requirements to be in compliance with the check itself.
+
+        :param path: the file path to check
+        :returns: True if the path is compliant, False otherwise.
+        """
+        stat = self._get_stat(path)
+        user = self.user
+        group = self.group
+
+        compliant = True
+        if stat.st_uid != user.pw_uid or stat.st_gid != group.gr_gid:
+            log('File %s is not owned by %s:%s.' % (path, user.pw_name,
+                                                    group.gr_name),
+                level=INFO)
+            compliant = False
+
+        # POSIX refers to the st_mode bits as corresponding to both the
+        # file type and file permission bits, where the least significant 12
+        # bits (o7777) are the suid (11), sgid (10), sticky bits (9), and the
+        # file permission bits (8-0)
+        perms = stat.st_mode & 0o7777
+        if perms != self.mode:
+            log('File %s has incorrect permissions, currently set to %s' %
+                (path, oct(stat.st_mode & 0o7777)), level=INFO)
+            compliant = False
+
+        return compliant
+
+    def comply(self, path):
+        """Issues a chown and chmod to the file paths specified."""
+        utils.ensure_permissions(path, self.user.pw_name, self.group.gr_name,
+                                 self.mode)
+
+
+class DirectoryPermissionAudit(FilePermissionAudit):
+    """Performs a permission check for the  specified directory path."""
+
+    def __init__(self, paths, user, group=None, mode=0o600,
+                 recursive=True, **kwargs):
+        super(DirectoryPermissionAudit, self).__init__(paths, user, group,
+                                                       mode, **kwargs)
+        self.recursive = recursive
+
+    def is_compliant(self, path):
+        """Checks if the directory is compliant.
+
+        Used to determine if the path specified and all of its children
+        directories are in compliance with the check itself.
+
+        :param path: the directory path to check
+        :returns: True if the directory tree is compliant, otherwise False.
+        """
+        if not os.path.isdir(path):
+            log('Path specified %s is not a directory.' % path, level=ERROR)
+            raise ValueError("%s is not a directory." % path)
+
+        if not self.recursive:
+            return super(DirectoryPermissionAudit, self).is_compliant(path)
+
+        compliant = True
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                continue
+
+            if not super(DirectoryPermissionAudit, self).is_compliant(root):
+                compliant = False
+                continue
+
+        return compliant
+
+    def comply(self, path):
+        for root, dirs, _ in os.walk(path):
+            if len(dirs) > 0:
+                super(DirectoryPermissionAudit, self).comply(root)
+
+
+class ReadOnly(BaseFileAudit):
+    """Audits that files and folders are read only."""
+    def __init__(self, paths, *args, **kwargs):
+        super(ReadOnly, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        try:
+            output = check_output(['find', path, '-perm', '-go+w',
+                                   '-type', 'f']).strip()
+
+            # The find above will find any files which have permission sets
+            # which allow too broad of write access. As such, the path is
+            # compliant if there is no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred checking finding writable files for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+            return False
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', 'go-w', '-R', path])
+        except CalledProcessError as e:
+            log('Error occurred removing writeable permissions for %s. '
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class NoReadWriteForOther(BaseFileAudit):
+    """Ensures that the files found under the base path are readable or
+    writable by anyone other than the owner or the group.
+    """
+    def __init__(self, paths):
+        super(NoReadWriteForOther, self).__init__(paths)
+
+    def is_compliant(self, path):
+        try:
+            cmd = ['find', path, '-perm', '-o+r', '-type', 'f', '-o',
+                   '-perm', '-o+w', '-type', 'f']
+            output = check_output(cmd).strip()
+
+            # The find above here will find any files which have read or
+            # write permissions for other, meaning there is too broad of access
+            # to read/write the file. As such, the path is compliant if there's
+            # no output.
+            if output:
+                return False
+
+            return True
+        except CalledProcessError as e:
+            log('Error occurred while finding files which are readable or '
+                'writable to the world in %s. '
+                'Command output is: %s.' % (path, e.output), level=ERROR)
+
+    def comply(self, path):
+        try:
+            check_output(['chmod', '-R', 'o-rw', path])
+        except CalledProcessError as e:
+            log('Error occurred attempting to change modes of files under '
+                'path %s. Output of command is: %s' % (path, e.output))
+
+
+class NoSUIDSGIDAudit(BaseFileAudit):
+    """Audits that specified files do not have SUID/SGID bits set."""
+    def __init__(self, paths, *args, **kwargs):
+        super(NoSUIDSGIDAudit, self).__init__(paths=paths, *args, **kwargs)
+
+    def is_compliant(self, path):
+        stat = self._get_stat(path)
+        if (stat.st_mode & (S_ISGID | S_ISUID)) != 0:
+            return False
+
+        return True
+
+    def comply(self, path):
+        try:
+            log('Removing suid/sgid from %s.' % path, level=DEBUG)
+            check_output(['chmod', '-s', path])
+        except CalledProcessError as e:
+            log('Error occurred removing suid/sgid from %s.'
+                'Error information is: command %s failed with returncode '
+                '%d and output %s.\n%s' % (path, e.cmd, e.returncode, e.output,
+                                           format_exc(e)), level=ERROR)
+
+
+class TemplatedFile(BaseFileAudit):
+    """The TemplatedFileAudit audits the contents of a templated file.
+
+    This audit renders a file from a template, sets the appropriate file
+    permissions, then generates a hashsum with which to check the content
+    changed.
+    """
+    def __init__(self, path, context, template_dir, mode, user='root',
+                 group='root', service_actions=None, **kwargs):
+        self.context = context
+        self.user = user
+        self.group = group
+        self.mode = mode
+        self.template_dir = template_dir
+        self.service_actions = service_actions
+        super(TemplatedFile, self).__init__(paths=path, always_comply=True,
+                                            **kwargs)
+
+    def is_compliant(self, path):
+        """Determines if the templated file is compliant.
+
+        A templated file is only compliant if it has not changed (as
+        determined by its sha256 hashsum) AND its file permissions are set
+        appropriately.
+
+        :param path: the path to check compliance.
+        """
+        same_templates = self.templates_match(path)
+        same_content = self.contents_match(path)
+        same_permissions = self.permissions_match(path)
+
+        if same_content and same_permissions and same_templates:
+            return True
+
+        return False
+
+    def run_service_actions(self):
+        """Run any actions on services requested."""
+        if not self.service_actions:
+            return
+
+        for svc_action in self.service_actions:
+            name = svc_action['service']
+            actions = svc_action['actions']
+            log("Running service '%s' actions '%s'" % (name, actions),
+                level=DEBUG)
+            for action in actions:
+                cmd = ['service', name, action]
+                try:
+                    check_call(cmd)
+                except CalledProcessError as exc:
+                    log("Service name='%s' action='%s' failed - %s" %
+                        (name, action, exc), level=WARNING)
+
+    def comply(self, path):
+        """Ensures the contents and the permissions of the file.
+
+        :param path: the path to correct
+        """
+        dirname = os.path.dirname(path)
+        if not os.path.exists(dirname):
+            os.makedirs(dirname)
+
+        self.pre_write()
+        render_and_write(self.template_dir, path, self.context())
+        utils.ensure_permissions(path, self.user, self.group, self.mode)
+        self.run_service_actions()
+        self.save_checksum(path)
+        self.post_write()
+
+    def pre_write(self):
+        """Invoked prior to writing the template."""
+        pass
+
+    def post_write(self):
+        """Invoked after writing the template."""
+        pass
+
+    def templates_match(self, path):
+        """Determines if the template files are the same.
+
+        The template file equality is determined by the hashsum of the
+        template files themselves. If there is no hashsum, then the content
+        cannot be sure to be the same so treat it as if they changed.
+        Otherwise, return whether or not the hashsums are the same.
+
+        :param path: the path to check
+        :returns: boolean
+        """
+        template_path = get_template_path(self.template_dir, path)
+        key = 'hardening:template:%s' % template_path
+        template_checksum = file_hash(template_path)
+        kv = unitdata.kv()
+        stored_tmplt_checksum = kv.get(key)
+        if not stored_tmplt_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Saved template checksum for %s.' % template_path,
+                level=DEBUG)
+            # Since we don't have a template checksum, then assume it doesn't
+            # match and return that the template is different.
+            return False
+        elif stored_tmplt_checksum != template_checksum:
+            kv.set(key, template_checksum)
+            kv.flush()
+            log('Updated template checksum for %s.' % template_path,
+                level=DEBUG)
+            return False
+
+        # Here the template hasn't changed based upon the calculated
+        # checksum of the template and what was previously stored.
+        return True
+
+    def contents_match(self, path):
+        """Determines if the file content is the same.
+
+        This is determined by comparing hashsum of the file contents and
+        the saved hashsum. If there is no hashsum, then the content cannot
+        be sure to be the same so treat them as if they are not the same.
+        Otherwise, return True if the hashsums are the same, False if they
+        are not the same.
+
+        :param path: the file to check.
+        """
+        checksum = file_hash(path)
+
+        kv = unitdata.kv()
+        stored_checksum = kv.get('hardening:%s' % path)
+        if not stored_checksum:
+            # If the checksum hasn't been generated, return False to ensure
+            # the file is written and the checksum stored.
+            log('Checksum for %s has not been calculated.' % path, level=DEBUG)
+            return False
+        elif stored_checksum != checksum:
+            log('Checksum mismatch for %s.' % path, level=DEBUG)
+            return False
+
+        return True
+
+    def permissions_match(self, path):
+        """Determines if the file owner and permissions match.
+
+        :param path: the path to check.
+        """
+        audit = FilePermissionAudit(path, self.user, self.group, self.mode)
+        return audit.is_compliant(path)
+
+    def save_checksum(self, path):
+        """Calculates and saves the checksum for the path specified.
+
+        :param path: the path of the file to save the checksum.
+        """
+        checksum = file_hash(path)
+        kv = unitdata.kv()
+        kv.set('hardening:%s' % path, checksum)
+        kv.flush()
+
+
+class DeletedFile(BaseFileAudit):
+    """Audit to ensure that a file is deleted."""
+    def __init__(self, paths):
+        super(DeletedFile, self).__init__(paths)
+
+    def is_compliant(self, path):
+        return not os.path.exists(path)
+
+    def comply(self, path):
+        os.remove(path)
+
+
+class FileContentAudit(BaseFileAudit):
+    """Audit the contents of a file."""
+    def __init__(self, paths, cases, **kwargs):
+        # Cases we expect to pass
+        self.pass_cases = cases.get('pass', [])
+        # Cases we expect to fail
+        self.fail_cases = cases.get('fail', [])
+        super(FileContentAudit, self).__init__(paths, **kwargs)
+
+    def is_compliant(self, path):
+        """
+        Given a set of content matching cases i.e. tuple(regex, bool) where
+        bool value denotes whether or not regex is expected to match, check that
+        all cases match as expected with the contents of the file. Cases can be
+        expected to pass of fail.
+
+        :param path: Path of file to check.
+        :returns: Boolean value representing whether or not all cases are
+                  found to be compliant.
+        """
+        log("Auditing contents of file '%s'" % (path), level=DEBUG)
+        with open(path, 'r') as fd:
+            contents = fd.read()
+
+        matches = 0
+        for pattern in self.pass_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to pass but instead it failed"
+                    % (pattern), level=WARNING)
+
+        for pattern in self.fail_cases:
+            key = re.compile(pattern, flags=re.MULTILINE)
+            results = re.search(key, contents)
+            if not results:
+                matches += 1
+            else:
+                log("Pattern '%s' was expected to fail but instead it passed"
+                    % (pattern), level=WARNING)
+
+        total = len(self.pass_cases) + len(self.fail_cases)
+        log("Checked %s cases and %s passed" % (total, matches), level=DEBUG)
+        return matches == total
+
+    def comply(self, *args, **kwargs):
+        """NOOP since we just issue warnings. This is to avoid the
+        NotImplememtedError.
+        """
+        log("Not applying any compliance criteria, only checks.", level=INFO)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0f940d4cfa85ca7051dd60a4805d84bb6aebed6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml
@@ -0,0 +1,16 @@
+# NOTE: this file contains the default configuration for the 'apache' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'apache' as the root key followed by any of the following with new
+#       values.
+
+common:
+    apache_dir: '/etc/apache2'
+
+hardening:
+    traceenable: 'off'
+    allowed_http_methods: "GET POST"
+    modules_to_disable: [ cgi, cgid ]
+    servertokens: 'Prod'
+    honor_cipher_order: 'on'
+    cipher_suite: 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..c112137cb45c4b63cb05384145b3edf8c443e2b8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/apache.yaml.schema
@@ -0,0 +1,12 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    apache_dir:
+    traceenable:
+
+hardening:
+    allowed_http_methods:
+    modules_to_disable:
+    servertokens:
+    honor_cipher_order:
+    cipher_suite:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..682d22bf3ded32eb1c8d6188486ec4468d9ec457
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml
@@ -0,0 +1,38 @@
+# NOTE: this file contains the default configuration for the 'mysql' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'mysql' as the root key followed by any of the following with new
+#       values.
+
+hardening:
+    mysql-conf: /etc/mysql/my.cnf
+    hardening-conf: /etc/mysql/conf.d/hardening.cnf
+
+security:
+    # @see http://www.symantec.com/connect/articles/securing-mysql-step-step
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_chroot
+    chroot: None
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_safe-user-create
+    safe-user-create: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-auth
+    secure-auth: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_symbolic-links
+    skip-symbolic-links: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_skip-show-database
+    skip-show-database: True
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_local_infile
+    local-infile: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_allow-suspicious-udfs
+    allow-suspicious-udfs: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_automatic_sp_privileges
+    automatic-sp-privileges: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-file-priv
+    secure-file-priv: /tmp
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..2edf325c311c6fbb062a072083b4d12cebc3d9c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/mysql.yaml.schema
@@ -0,0 +1,15 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+hardening:
+    mysql-conf:
+    hardening-conf:
+security:
+    chroot:
+    safe-user-create:
+    secure-auth:
+    skip-symbolic-links:
+    skip-show-database:
+    local-infile:
+    allow-suspicious-udfs:
+    automatic-sp-privileges:
+    secure-file-priv:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9a8627b5ed2803828e1e4d78260c6b5f90cae659
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml
@@ -0,0 +1,68 @@
+# NOTE: this file contains the default configuration for the 'os' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'os' as the root key followed by any of the following with new
+#       values.
+
+general:
+    desktop_enable: False  # (type:boolean)
+
+environment:
+    extra_user_paths: []
+    umask: 027
+    root_path: /
+
+auth:
+    pw_max_age: 60
+    # discourage password cycling
+    pw_min_age: 7
+    retries: 5
+    lockout_time: 600
+    timeout: 60
+    allow_homeless: False  # (type:boolean)
+    pam_passwdqc_enable: True  # (type:boolean)
+    pam_passwdqc_options: 'min=disabled,disabled,16,12,8'
+    root_ttys:
+        console
+        tty1
+        tty2
+        tty3
+        tty4
+        tty5
+        tty6
+    uid_min: 1000
+    gid_min: 1000
+    sys_uid_min: 100
+    sys_uid_max: 999
+    sys_gid_min: 100
+    sys_gid_max: 999
+    chfn_restrict:
+
+security:
+    users_allow: []
+    suid_sgid_enforce: True  # (type:boolean)
+    # user-defined blacklist and whitelist
+    suid_sgid_blacklist: []
+    suid_sgid_whitelist: []
+    # if this is True, remove any suid/sgid bits from files that were not in the whitelist
+    suid_sgid_dry_run_on_unknown: False  # (type:boolean)
+    suid_sgid_remove_from_unknown: False  # (type:boolean)
+    # remove packages with known issues
+    packages_clean: True  # (type:boolean)
+    packages_list:
+        xinetd
+        inetd
+        ypserv
+        telnet-server
+        rsh-server
+        rsync
+    kernel_enable_module_loading: True  # (type:boolean)
+    kernel_enable_core_dump: False  # (type:boolean)
+    ssh_tmout: 300
+
+sysctl:
+    kernel_secure_sysrq: 244  # 4 + 16 + 32 + 64 + 128
+    kernel_enable_sysrq: False  # (type:boolean)
+    forwarding: False  # (type:boolean)
+    ipv6_enable: False  # (type:boolean)
+    arp_restricted: True  # (type:boolean)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..cc3b9c206eae56cbe68826cb76748e2deb9483e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/os.yaml.schema
@@ -0,0 +1,43 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+general:
+    desktop_enable:
+environment:
+    extra_user_paths:
+    umask:
+    root_path:
+auth:
+    pw_max_age:
+    pw_min_age:
+    retries:
+    lockout_time:
+    timeout:
+    allow_homeless:
+    pam_passwdqc_enable:
+    pam_passwdqc_options:
+    root_ttys:
+    uid_min:
+    gid_min:
+    sys_uid_min:
+    sys_uid_max:
+    sys_gid_min:
+    sys_gid_max:
+    chfn_restrict:
+security:
+    users_allow:
+    suid_sgid_enforce:
+    suid_sgid_blacklist:
+    suid_sgid_whitelist:
+    suid_sgid_dry_run_on_unknown:
+    suid_sgid_remove_from_unknown:
+    packages_clean:
+    packages_list:
+    kernel_enable_module_loading:
+    kernel_enable_core_dump:
+    ssh_tmout:
+sysctl:
+    kernel_secure_sysrq:
+    kernel_enable_sysrq:
+    forwarding:
+    ipv6_enable:
+    arp_restricted:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cd529bcae1ec00fef2e969f43dc3cf530b46ef9a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml
@@ -0,0 +1,49 @@
+# NOTE: this file contains the default configuration for the 'ssh' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'ssh' as the root key followed by any of the following with new
+#       values.
+
+common:
+    service_name: 'ssh'
+    network_ipv6_enable: False  # (type:boolean)
+    ports: [22]
+    remote_hosts: []
+
+client:
+    package: 'openssh-client'
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    roaming: False
+    password_authentication: 'no'
+
+server:
+    host_key_files: ['/etc/ssh/ssh_host_rsa_key', '/etc/ssh/ssh_host_dsa_key',
+                     '/etc/ssh/ssh_host_ecdsa_key']
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    allow_root_with_key: False  # (type:boolean)
+    allow_tcp_forwarding: 'no'
+    allow_agent_forwarding: 'no'
+    allow_x11_forwarding: 'no'
+    use_privilege_separation: 'sandbox'
+    listen_to: ['0.0.0.0']
+    use_pam: 'no'
+    package: 'openssh-server'
+    password_authentication: 'no'
+    alive_interval: '600'
+    alive_count: '3'
+    sftp_enable: False  # (type:boolean)
+    sftp_group: 'sftponly'
+    sftp_chroot: '/home/%u'
+    deny_users: []
+    allow_users: []
+    deny_groups: []
+    allow_groups: []
+    print_motd: 'no'
+    print_last_log: 'no'
+    use_dns: 'no'
+    max_auth_tries: 2
+    max_sessions: 10
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..d05e054bc234015206bb1195152fa9ffd6a33151
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/defaults/ssh.yaml.schema
@@ -0,0 +1,42 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    service_name:
+    network_ipv6_enable:
+    ports:
+    remote_hosts:
+client:
+    package:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    roaming:
+    password_authentication:
+server:
+    host_key_files:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    allow_root_with_key:
+    allow_tcp_forwarding:
+    allow_agent_forwarding:
+    allow_x11_forwarding:
+    use_privilege_separation:
+    listen_to:
+    use_pam:
+    package:
+    password_authentication:
+    alive_interval:
+    alive_count:
+    sftp_enable:
+    sftp_group:
+    sftp_chroot:
+    deny_users:
+    allow_users:
+    deny_groups:
+    allow_groups:
+    print_motd:
+    print_last_log:
+    use_dns:
+    max_auth_tries:
+    max_sessions:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/harden.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/harden.py
new file mode 100644
index 0000000000000000000000000000000000000000..63f21b9c9855065da3be875c01a2c94db7df47b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/harden.py
@@ -0,0 +1,96 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+
+from collections import OrderedDict
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    DEBUG,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.host.checks import run_os_checks
+from charmhelpers.contrib.hardening.ssh.checks import run_ssh_checks
+from charmhelpers.contrib.hardening.mysql.checks import run_mysql_checks
+from charmhelpers.contrib.hardening.apache.checks import run_apache_checks
+
+_DISABLE_HARDENING_FOR_UNIT_TEST = False
+
+
+def harden(overrides=None):
+    """Hardening decorator.
+
+    This is the main entry point for running the hardening stack. In order to
+    run modules of the stack you must add this decorator to charm hook(s) and
+    ensure that your charm config.yaml contains the 'harden' option set to
+    one or more of the supported modules. Setting these will cause the
+    corresponding hardening code to be run when the hook fires.
+
+    This decorator can and should be applied to more than one hook or function
+    such that hardening modules are called multiple times. This is because
+    subsequent calls will perform auditing checks that will report any changes
+    to resources hardened by the first run (and possibly perform compliance
+    actions as a result of any detected infractions).
+
+    :param overrides: Optional list of stack modules used to override those
+                      provided with 'harden' config.
+    :returns: Returns value returned by decorated function once executed.
+    """
+    if overrides is None:
+        overrides = []
+
+    def _harden_inner1(f):
+        # As this has to be py2.7 compat, we can't use nonlocal.  Use a trick
+        # to capture the dictionary that can then be updated.
+        _logged = {'done': False}
+
+        def _harden_inner2(*args, **kwargs):
+            # knock out hardening via a config var; normally it won't get
+            # disabled.
+            if _DISABLE_HARDENING_FOR_UNIT_TEST:
+                return f(*args, **kwargs)
+            if not _logged['done']:
+                log("Hardening function '%s'" % (f.__name__), level=DEBUG)
+                _logged['done'] = True
+            RUN_CATALOG = OrderedDict([('os', run_os_checks),
+                                       ('ssh', run_ssh_checks),
+                                       ('mysql', run_mysql_checks),
+                                       ('apache', run_apache_checks)])
+
+            enabled = overrides[:] or (config("harden") or "").split()
+            if enabled:
+                modules_to_run = []
+                # modules will always be performed in the following order
+                for module, func in six.iteritems(RUN_CATALOG):
+                    if module in enabled:
+                        enabled.remove(module)
+                        modules_to_run.append(func)
+
+                if enabled:
+                    log("Unknown hardening modules '%s' - ignoring" %
+                        (', '.join(enabled)), level=WARNING)
+
+                for hardener in modules_to_run:
+                    log("Executing hardening module '%s'" %
+                        (hardener.__name__), level=DEBUG)
+                    hardener()
+            else:
+                log("No hardening applied to '%s'" % (f.__name__), level=DEBUG)
+
+            return f(*args, **kwargs)
+        return _harden_inner2
+
+    return _harden_inner1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e7e409f3c7e0406b40353f48acfc3479e4c1a24
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/__init__.py
@@ -0,0 +1,48 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.host.checks import (
+    apt,
+    limits,
+    login,
+    minimize_access,
+    pam,
+    profile,
+    securetty,
+    suid_sgid,
+    sysctl
+)
+
+
+def run_os_checks():
+    log("Starting OS hardening checks.", level=DEBUG)
+    checks = apt.get_audits()
+    checks.extend(limits.get_audits())
+    checks.extend(login.get_audits())
+    checks.extend(minimize_access.get_audits())
+    checks.extend(pam.get_audits())
+    checks.extend(profile.get_audits())
+    checks.extend(securetty.get_audits())
+    checks.extend(suid_sgid.get_audits())
+    checks.extend(sysctl.get_audits())
+
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("OS hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ce41b0043134e256d9c20ee729f1c4345faa3f9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/apt.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.utils import get_settings
+from charmhelpers.contrib.hardening.audits.apt import (
+    AptConfig,
+    RestrictedPackages,
+)
+
+
+def get_audits():
+    """Get OS hardening apt audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [AptConfig([{'key': 'APT::Get::AllowUnauthenticated',
+                          'expected': 'false'}])]
+
+    settings = get_settings('os')
+    clean_packages = settings['security']['packages_clean']
+    if clean_packages:
+        security_packages = settings['security']['packages_list']
+        if security_packages:
+            audits.append(RestrictedPackages(security_packages))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/limits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/limits.py
new file mode 100644
index 0000000000000000000000000000000000000000..e94f5ebef360c7c80c35eba8243d3e7f7dcbb14d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/limits.py
@@ -0,0 +1,53 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening security limits audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Ensure that the /etc/security/limits.d directory is only writable
+    # by the root user, but others can execute and read.
+    audits.append(DirectoryPermissionAudit('/etc/security/limits.d',
+                                           user='root', group='root',
+                                           mode=0o755))
+
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/security/limits.d/10.hardcore.conf',
+                                    SecurityLimitsContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    user='root', group='root', mode=0o0440))
+    return audits
+
+
+class SecurityLimitsContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'disable_core_dump':
+                not settings['security']['kernel_enable_core_dump']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/login.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/login.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe2bc6ef34a0dae612c2617dc1d13390f651e419
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/login.py
@@ -0,0 +1,65 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from six import string_types
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening login.defs audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [TemplatedFile('/etc/login.defs', LoginContext(),
+                            template_dir=TEMPLATES_DIR,
+                            user='root', group='root', mode=0o0444)]
+    return audits
+
+
+class LoginContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+
+        # Octal numbers in yaml end up being turned into decimal,
+        # so check if the umask is entered as a string (e.g. '027')
+        # or as an octal umask as we know it (e.g. 002). If its not
+        # a string assume it to be octal and turn it into an octal
+        # string.
+        umask = settings['environment']['umask']
+        if not isinstance(umask, string_types):
+            umask = '%s' % oct(umask)
+
+        ctxt = {
+            'additional_user_paths':
+            settings['environment']['extra_user_paths'],
+            'umask': umask,
+            'pwd_max_age': settings['auth']['pw_max_age'],
+            'pwd_min_age': settings['auth']['pw_min_age'],
+            'uid_min': settings['auth']['uid_min'],
+            'sys_uid_min': settings['auth']['sys_uid_min'],
+            'sys_uid_max': settings['auth']['sys_uid_max'],
+            'gid_min': settings['auth']['gid_min'],
+            'sys_gid_min': settings['auth']['sys_gid_min'],
+            'sys_gid_max': settings['auth']['sys_gid_max'],
+            'login_retries': settings['auth']['retries'],
+            'login_timeout': settings['auth']['timeout'],
+            'chfn_restrict': settings['auth']['chfn_restrict'],
+            'allow_login_without_home': settings['auth']['allow_homeless']
+        }
+
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/minimize_access.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/minimize_access.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e64be003be0b89d1416b22c35c43b6024979361
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/minimize_access.py
@@ -0,0 +1,50 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    ReadOnly,
+)
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening access audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Remove write permissions from $PATH folders for all regular users.
+    # This prevents changing system-wide commands from normal users.
+    path_folders = {'/usr/local/sbin',
+                    '/usr/local/bin',
+                    '/usr/sbin',
+                    '/usr/bin',
+                    '/bin'}
+    extra_user_paths = settings['environment']['extra_user_paths']
+    path_folders.update(extra_user_paths)
+    audits.append(ReadOnly(path_folders))
+
+    # Only allow the root user to have access to the shadow file.
+    audits.append(FilePermissionAudit('/etc/shadow', 'root', 'root', 0o0600))
+
+    if 'change_user' not in settings['security']['users_allow']:
+        # su should only be accessible to user and group root, unless it is
+        # expressly defined to allow users to change to root via the
+        # security_users_allow config option.
+        audits.append(FilePermissionAudit('/bin/su', 'root', 'root', 0o750))
+
+    return audits
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/pam.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/pam.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b38d5f0cf0b16282968825b79b44d80a1a7f577
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/pam.py
@@ -0,0 +1,132 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from subprocess import (
+    check_output,
+    CalledProcessError,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_purge,
+    apt_update,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    DeletedFile,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+def get_audits():
+    """Get OS hardening PAM authentication audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+
+    if settings['auth']['pam_passwdqc_enable']:
+        audits.append(PasswdqcPAM('/etc/passwdqc.conf'))
+
+    if settings['auth']['retries']:
+        audits.append(Tally2PAM('/usr/share/pam-configs/tally2'))
+    else:
+        audits.append(DeletedFile('/usr/share/pam-configs/tally2'))
+
+    return audits
+
+
+class PasswdqcPAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_pam_passwdqc_options'] = \
+            settings['auth']['pam_passwdqc_options']
+
+        return ctxt
+
+
+class PasswdqcPAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(PasswdqcPAM, self).__init__(path=path,
+                                          template_dir=TEMPLATES_DIR,
+                                          context=PasswdqcPAMContext(),
+                                          user='root',
+                                          group='root',
+                                          mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        for pkg in ['libpam-ccreds', 'libpam-cracklib']:
+            log("Purging package '%s'" % pkg, level=DEBUG),
+            apt_purge(pkg)
+
+        apt_update(fatal=True)
+        for pkg in ['libpam-passwdqc']:
+            log("Installing package '%s'" % pkg, level=DEBUG),
+            apt_install(pkg)
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
+
+
+class Tally2PAMContext(object):
+
+    def __call__(self):
+        ctxt = {}
+        settings = utils.get_settings('os')
+
+        ctxt['auth_lockout_time'] = settings['auth']['lockout_time']
+        ctxt['auth_retries'] = settings['auth']['retries']
+
+        return ctxt
+
+
+class Tally2PAM(TemplatedFile):
+    """The PAM Audit verifies the linux PAM settings."""
+    def __init__(self, path):
+        super(Tally2PAM, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=Tally2PAMContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0640)
+
+    def pre_write(self):
+        # Always remove?
+        apt_purge('libpam-ccreds')
+        apt_update(fatal=True)
+        apt_install('libpam-modules')
+
+    def post_write(self):
+        """Updates the PAM configuration after the file has been written"""
+        try:
+            check_output(['pam-auth-update', '--package'])
+        except CalledProcessError as e:
+            log('Error calling pam-auth-update: %s' % e, level=ERROR)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/profile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/profile.py
new file mode 100644
index 0000000000000000000000000000000000000000..2727428da9241ccf88a60843d05dffb26cebac96
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/profile.py
@@ -0,0 +1,49 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening profile audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+
+    settings = utils.get_settings('os')
+    # If core dumps are not enabled, then don't allow core dumps to be
+    # created as they may contain sensitive information.
+    if not settings['security']['kernel_enable_core_dump']:
+        audits.append(TemplatedFile('/etc/profile.d/pinerolo_profile.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0755, user='root', group='root'))
+    if settings['security']['ssh_tmout']:
+        audits.append(TemplatedFile('/etc/profile.d/99-hardening.sh',
+                                    ProfileContext(),
+                                    template_dir=TEMPLATES_DIR,
+                                    mode=0o0644, user='root', group='root'))
+    return audits
+
+
+class ProfileContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ssh_tmout':
+                settings['security']['ssh_tmout']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/securetty.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/securetty.py
new file mode 100644
index 0000000000000000000000000000000000000000..34cd02178c1fbf1c7d467af0814ad9fd4199dc3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/securetty.py
@@ -0,0 +1,37 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.contrib.hardening.audits.file import TemplatedFile
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get OS hardening Secure TTY audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    audits.append(TemplatedFile('/etc/securetty', SecureTTYContext(),
+                                template_dir=TEMPLATES_DIR,
+                                mode=0o0400, user='root', group='root'))
+    return audits
+
+
+class SecureTTYContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'ttys': settings['auth']['root_ttys']}
+        return ctxt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/suid_sgid.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcbe3fde07ea0716e2de6d1d4e103fcb19166c14
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/suid_sgid.py
@@ -0,0 +1,129 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+from charmhelpers.contrib.hardening.audits.file import NoSUIDSGIDAudit
+from charmhelpers.contrib.hardening import utils
+
+
+BLACKLIST = ['/usr/bin/rcp', '/usr/bin/rlogin', '/usr/bin/rsh',
+             '/usr/libexec/openssh/ssh-keysign',
+             '/usr/lib/openssh/ssh-keysign',
+             '/sbin/netreport',
+             '/usr/sbin/usernetctl',
+             '/usr/sbin/userisdnctl',
+             '/usr/sbin/pppd',
+             '/usr/bin/lockfile',
+             '/usr/bin/mail-lock',
+             '/usr/bin/mail-unlock',
+             '/usr/bin/mail-touchlock',
+             '/usr/bin/dotlockfile',
+             '/usr/bin/arping',
+             '/usr/sbin/uuidd',
+             '/usr/bin/mtr',
+             '/usr/lib/evolution/camel-lock-helper-1.2',
+             '/usr/lib/pt_chown',
+             '/usr/lib/eject/dmcrypt-get-device',
+             '/usr/lib/mc/cons.saver']
+
+WHITELIST = ['/bin/mount', '/bin/ping', '/bin/su', '/bin/umount',
+             '/sbin/pam_timestamp_check', '/sbin/unix_chkpwd', '/usr/bin/at',
+             '/usr/bin/gpasswd', '/usr/bin/locate', '/usr/bin/newgrp',
+             '/usr/bin/passwd', '/usr/bin/ssh-agent',
+             '/usr/libexec/utempter/utempter', '/usr/sbin/lockdev',
+             '/usr/sbin/sendmail.sendmail', '/usr/bin/expiry',
+             '/bin/ping6', '/usr/bin/traceroute6.iputils',
+             '/sbin/mount.nfs', '/sbin/umount.nfs',
+             '/sbin/mount.nfs4', '/sbin/umount.nfs4',
+             '/usr/bin/crontab',
+             '/usr/bin/wall', '/usr/bin/write',
+             '/usr/bin/screen',
+             '/usr/bin/mlocate',
+             '/usr/bin/chage', '/usr/bin/chfn', '/usr/bin/chsh',
+             '/bin/fusermount',
+             '/usr/bin/pkexec',
+             '/usr/bin/sudo', '/usr/bin/sudoedit',
+             '/usr/sbin/postdrop', '/usr/sbin/postqueue',
+             '/usr/sbin/suexec',
+             '/usr/lib/squid/ncsa_auth', '/usr/lib/squid/pam_auth',
+             '/usr/kerberos/bin/ksu',
+             '/usr/sbin/ccreds_validate',
+             '/usr/bin/Xorg',
+             '/usr/bin/X',
+             '/usr/lib/dbus-1.0/dbus-daemon-launch-helper',
+             '/usr/lib/vte/gnome-pty-helper',
+             '/usr/lib/libvte9/gnome-pty-helper',
+             '/usr/lib/libvte-2.90-9/gnome-pty-helper']
+
+
+def get_audits():
+    """Get OS hardening suid/sgid audits.
+
+    :returns:  dictionary of audits
+    """
+    checks = []
+    settings = utils.get_settings('os')
+    if not settings['security']['suid_sgid_enforce']:
+        log("Skipping suid/sgid hardening", level=INFO)
+        return checks
+
+    # Build the blacklist and whitelist of files for suid/sgid checks.
+    # There are a total of 4 lists:
+    #   1. the system blacklist
+    #   2. the system whitelist
+    #   3. the user blacklist
+    #   4. the user whitelist
+    #
+    # The blacklist is the set of paths which should NOT have the suid/sgid bit
+    # set and the whitelist is the set of paths which MAY have the suid/sgid
+    # bit setl. The user whitelist/blacklist effectively override the system
+    # whitelist/blacklist.
+    u_b = settings['security']['suid_sgid_blacklist']
+    u_w = settings['security']['suid_sgid_whitelist']
+
+    blacklist = set(BLACKLIST) - set(u_w + u_b)
+    whitelist = set(WHITELIST) - set(u_b + u_w)
+
+    checks.append(NoSUIDSGIDAudit(blacklist))
+
+    dry_run = settings['security']['suid_sgid_dry_run_on_unknown']
+
+    if settings['security']['suid_sgid_remove_from_unknown'] or dry_run:
+        # If the policy is a dry_run (e.g. complain only) or remove unknown
+        # suid/sgid bits then find all of the paths which have the suid/sgid
+        # bit set and then remove the whitelisted paths.
+        root_path = settings['environment']['root_path']
+        unknown_paths = find_paths_with_suid_sgid(root_path) - set(whitelist)
+        checks.append(NoSUIDSGIDAudit(unknown_paths, unless=dry_run))
+
+    return checks
+
+
+def find_paths_with_suid_sgid(root_path):
+    """Finds all paths/files which have an suid/sgid bit enabled.
+
+    Starting with the root_path, this will recursively find all paths which
+    have an suid or sgid bit set.
+    """
+    cmd = ['find', root_path, '-perm', '-4000', '-o', '-perm', '-2000',
+           '-type', 'f', '!', '-path', '/proc/*', '-print']
+
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    out, _ = p.communicate()
+    return set(out.split('\n'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1ea5813036b11893e8b9a986bf30a2f7a541b5d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/checks/sysctl.py
@@ -0,0 +1,209 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import platform
+import re
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+    WARNING,
+)
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.host import TEMPLATES_DIR
+
+
+SYSCTL_DEFAULTS = """net.ipv4.ip_forward=%(net_ipv4_ip_forward)s
+net.ipv6.conf.all.forwarding=%(net_ipv6_conf_all_forwarding)s
+net.ipv4.conf.all.rp_filter=1
+net.ipv4.conf.default.rp_filter=1
+net.ipv4.icmp_echo_ignore_broadcasts=1
+net.ipv4.icmp_ignore_bogus_error_responses=1
+net.ipv4.icmp_ratelimit=100
+net.ipv4.icmp_ratemask=88089
+net.ipv6.conf.all.disable_ipv6=%(net_ipv6_conf_all_disable_ipv6)s
+net.ipv4.tcp_timestamps=%(net_ipv4_tcp_timestamps)s
+net.ipv4.conf.all.arp_ignore=%(net_ipv4_conf_all_arp_ignore)s
+net.ipv4.conf.all.arp_announce=%(net_ipv4_conf_all_arp_announce)s
+net.ipv4.tcp_rfc1337=1
+net.ipv4.tcp_syncookies=1
+net.ipv4.conf.all.shared_media=1
+net.ipv4.conf.default.shared_media=1
+net.ipv4.conf.all.accept_source_route=0
+net.ipv4.conf.default.accept_source_route=0
+net.ipv4.conf.all.accept_redirects=0
+net.ipv4.conf.default.accept_redirects=0
+net.ipv6.conf.all.accept_redirects=0
+net.ipv6.conf.default.accept_redirects=0
+net.ipv4.conf.all.secure_redirects=0
+net.ipv4.conf.default.secure_redirects=0
+net.ipv4.conf.all.send_redirects=0
+net.ipv4.conf.default.send_redirects=0
+net.ipv4.conf.all.log_martians=0
+net.ipv6.conf.default.router_solicitations=0
+net.ipv6.conf.default.accept_ra_rtr_pref=0
+net.ipv6.conf.default.accept_ra_pinfo=0
+net.ipv6.conf.default.accept_ra_defrtr=0
+net.ipv6.conf.default.autoconf=0
+net.ipv6.conf.default.dad_transmits=0
+net.ipv6.conf.default.max_addresses=1
+net.ipv6.conf.all.accept_ra=0
+net.ipv6.conf.default.accept_ra=0
+kernel.modules_disabled=%(kernel_modules_disabled)s
+kernel.sysrq=%(kernel_sysrq)s
+fs.suid_dumpable=%(fs_suid_dumpable)s
+kernel.randomize_va_space=2
+"""
+
+
+def get_audits():
+    """Get OS hardening sysctl audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = []
+    settings = utils.get_settings('os')
+
+    # Apply the sysctl settings which are configured to be applied.
+    audits.append(SysctlConf())
+    # Make sure that only root has access to the sysctl.conf file, and
+    # that it is read-only.
+    audits.append(FilePermissionAudit('/etc/sysctl.conf',
+                                      user='root',
+                                      group='root', mode=0o0440))
+    # If module loading is not enabled, then ensure that the modules
+    # file has the appropriate permissions and rebuild the initramfs
+    if not settings['security']['kernel_enable_module_loading']:
+        audits.append(ModulesTemplate())
+
+    return audits
+
+
+class ModulesContext(object):
+
+    def __call__(self):
+        settings = utils.get_settings('os')
+        with open('/proc/cpuinfo', 'r') as fd:
+            cpuinfo = fd.readlines()
+
+        for line in cpuinfo:
+            match = re.search(r"^vendor_id\s+:\s+(.+)", line)
+            if match:
+                vendor = match.group(1)
+
+        if vendor == "GenuineIntel":
+            vendor = "intel"
+        elif vendor == "AuthenticAMD":
+            vendor = "amd"
+
+        ctxt = {'arch': platform.processor(),
+                'cpuVendor': vendor,
+                'desktop_enable': settings['general']['desktop_enable']}
+
+        return ctxt
+
+
+class ModulesTemplate(object):
+
+    def __init__(self):
+        super(ModulesTemplate, self).__init__('/etc/initramfs-tools/modules',
+                                              ModulesContext(),
+                                              templates_dir=TEMPLATES_DIR,
+                                              user='root', group='root',
+                                              mode=0o0440)
+
+    def post_write(self):
+        subprocess.check_call(['update-initramfs', '-u'])
+
+
+class SysCtlHardeningContext(object):
+    def __call__(self):
+        settings = utils.get_settings('os')
+        ctxt = {'sysctl': {}}
+
+        log("Applying sysctl settings", level=INFO)
+        extras = {'net_ipv4_ip_forward': 0,
+                  'net_ipv6_conf_all_forwarding': 0,
+                  'net_ipv6_conf_all_disable_ipv6': 1,
+                  'net_ipv4_tcp_timestamps': 0,
+                  'net_ipv4_conf_all_arp_ignore': 0,
+                  'net_ipv4_conf_all_arp_announce': 0,
+                  'kernel_sysrq': 0,
+                  'fs_suid_dumpable': 0,
+                  'kernel_modules_disabled': 1}
+
+        if settings['sysctl']['ipv6_enable']:
+            extras['net_ipv6_conf_all_disable_ipv6'] = 0
+
+        if settings['sysctl']['forwarding']:
+            extras['net_ipv4_ip_forward'] = 1
+            extras['net_ipv6_conf_all_forwarding'] = 1
+
+        if settings['sysctl']['arp_restricted']:
+            extras['net_ipv4_conf_all_arp_ignore'] = 1
+            extras['net_ipv4_conf_all_arp_announce'] = 2
+
+        if settings['security']['kernel_enable_module_loading']:
+            extras['kernel_modules_disabled'] = 0
+
+        if settings['sysctl']['kernel_enable_sysrq']:
+            sysrq_val = settings['sysctl']['kernel_secure_sysrq']
+            extras['kernel_sysrq'] = sysrq_val
+
+        if settings['security']['kernel_enable_core_dump']:
+            extras['fs_suid_dumpable'] = 1
+
+        settings.update(extras)
+        for d in (SYSCTL_DEFAULTS % settings).split():
+            d = d.strip().partition('=')
+            key = d[0].strip()
+            path = os.path.join('/proc/sys', key.replace('.', '/'))
+            if not os.path.exists(path):
+                log("Skipping '%s' since '%s' does not exist" % (key, path),
+                    level=WARNING)
+                continue
+
+            ctxt['sysctl'][key] = d[2] or None
+
+        # Translate for python3
+        return {'sysctl_settings':
+                [(k, v) for k, v in six.iteritems(ctxt['sysctl'])]}
+
+
+class SysctlConf(TemplatedFile):
+    """An audit check for sysctl settings."""
+    def __init__(self):
+        self.conffile = '/etc/sysctl.d/99-juju-hardening.conf'
+        super(SysctlConf, self).__init__(self.conffile,
+                                         SysCtlHardeningContext(),
+                                         template_dir=TEMPLATES_DIR,
+                                         user='root', group='root',
+                                         mode=0o0440)
+
+    def post_write(self):
+        try:
+            subprocess.check_call(['sysctl', '-p', self.conffile])
+        except subprocess.CalledProcessError as e:
+            # NOTE: on some systems if sysctl cannot apply all settings it
+            #       will return non-zero as well.
+            log("sysctl command returned an error (maybe some "
+                "keys could not be set) - %s" % (e),
+                level=WARNING)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
new file mode 100644
index 0000000000000000000000000000000000000000..0014191fc8152fd9147b3fb5446987e6e62f2d77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/10.hardcore.conf
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% if disable_core_dump -%}
+# Prevent core dumps for all users. These are usually only needed by developers and may contain sensitive information.
+* hard core 0
+{% endif %}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-hardening.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
new file mode 100644
index 0000000000000000000000000000000000000000..616cef46f492f682aca28c71a6e20176870a36f2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-hardening.sh
@@ -0,0 +1,5 @@
+TMOUT={{ tmout }}
+readonly TMOUT
+export TMOUT
+
+readonly HISTFILE
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
new file mode 100644
index 0000000000000000000000000000000000000000..101f1e1d709c268890553957f30c93259681ce59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/99-juju-hardening.conf
@@ -0,0 +1,7 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+{% for key, value in sysctl_settings -%}
+{{ key }}={{ value }}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/login.defs b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/login.defs
new file mode 100644
index 0000000000000000000000000000000000000000..db137d6dbb7a3a850294407199225392a880cfc2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/login.defs
@@ -0,0 +1,349 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+#
+# /etc/login.defs - Configuration control definitions for the login package.
+#
+# Three items must be defined:  MAIL_DIR, ENV_SUPATH, and ENV_PATH.
+# If unspecified, some arbitrary (and possibly incorrect) value will
+# be assumed.  All other items are optional - if not specified then
+# the described action or option will be inhibited.
+#
+# Comment lines (lines beginning with "#") and blank lines are ignored.
+#
+# Modified for Linux.  --marekm
+
+# REQUIRED for useradd/userdel/usermod
+#   Directory where mailboxes reside, _or_ name of file, relative to the
+#   home directory.  If you _do_ define MAIL_DIR and MAIL_FILE,
+#   MAIL_DIR takes precedence.
+#
+#   Essentially:
+#      - MAIL_DIR defines the location of users mail spool files
+#        (for mbox use) by appending the username to MAIL_DIR as defined
+#        below.
+#      - MAIL_FILE defines the location of the users mail spool files as the
+#        fully-qualified filename obtained by prepending the user home
+#        directory before $MAIL_FILE
+#
+# NOTE: This is no more used for setting up users MAIL environment variable
+#       which is, starting from shadow 4.0.12-1 in Debian, entirely the
+#       job of the pam_mail PAM modules
+#       See default PAM configuration files provided for
+#       login, su, etc.
+#
+# This is a temporary situation: setting these variables will soon
+# move to /etc/default/useradd and the variables will then be
+# no more supported
+MAIL_DIR        /var/mail
+#MAIL_FILE      .mail
+
+#
+# Enable logging and display of /var/log/faillog login failure info.
+# This option conflicts with the pam_tally PAM module.
+#
+FAILLOG_ENAB		yes
+
+#
+# Enable display of unknown usernames when login failures are recorded.
+#
+# WARNING: Unknown usernames may become world readable. 
+# See #290803 and #298773 for details about how this could become a security
+# concern
+LOG_UNKFAIL_ENAB	no
+
+#
+# Enable logging of successful logins
+#
+LOG_OK_LOGINS		yes
+
+#
+# Enable "syslog" logging of su activity - in addition to sulog file logging.
+# SYSLOG_SG_ENAB does the same for newgrp and sg.
+#
+SYSLOG_SU_ENAB		yes
+SYSLOG_SG_ENAB		yes
+
+#
+# If defined, all su activity is logged to this file.
+#
+#SULOG_FILE	/var/log/sulog
+
+#
+# If defined, file which maps tty line to TERM environment parameter.
+# Each line of the file is in a format something like "vt100  tty01".
+#
+#TTYTYPE_FILE	/etc/ttytype
+
+#
+# If defined, login failures will be logged here in a utmp format
+# last, when invoked as lastb, will read /var/log/btmp, so...
+#
+FTMP_FILE	/var/log/btmp
+
+#
+# If defined, the command name to display when running "su -".  For
+# example, if this is defined as "su" then a "ps" will display the
+# command is "-su".  If not defined, then "ps" would display the
+# name of the shell actually being run, e.g. something like "-sh".
+#
+SU_NAME		su
+
+#
+# If defined, file which inhibits all the usual chatter during the login
+# sequence.  If a full pathname, then hushed mode will be enabled if the
+# user's name or shell are found in the file.  If not a full pathname, then
+# hushed mode will be enabled if the file exists in the user's home directory.
+#
+HUSHLOGIN_FILE	.hushlogin
+#HUSHLOGIN_FILE	/etc/hushlogins
+
+#
+# *REQUIRED*  The default PATH settings, for superuser and normal users.
+#
+# (they are minimal, add the rest in the shell startup files)
+ENV_SUPATH	PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
+ENV_PATH	PATH=/usr/local/bin:/usr/bin:/bin{% if additional_user_paths %}{{ additional_user_paths }}{% endif %}
+
+#
+# Terminal permissions
+#
+#	TTYGROUP	Login tty will be assigned this group ownership.
+#	TTYPERM		Login tty will be set to this permission.
+#
+# If you have a "write" program which is "setgid" to a special group
+# which owns the terminals, define TTYGROUP to the group number and
+# TTYPERM to 0620.  Otherwise leave TTYGROUP commented out and assign
+# TTYPERM to either 622 or 600.
+#
+# In Debian /usr/bin/bsd-write or similar programs are setgid tty
+# However, the default and recommended value for TTYPERM is still 0600
+# to not allow anyone to write to anyone else console or terminal
+
+# Users can still allow other people to write them by issuing 
+# the "mesg y" command.
+
+TTYGROUP	tty
+TTYPERM		0600
+
+#
+# Login configuration initializations:
+#
+#	ERASECHAR	Terminal ERASE character ('\010' = backspace).
+#	KILLCHAR	Terminal KILL character ('\025' = CTRL/U).
+#	UMASK		Default "umask" value.
+#
+# The ERASECHAR and KILLCHAR are used only on System V machines.
+# 
+# UMASK is the default umask value for pam_umask and is used by
+# useradd and newusers to set the mode of the new home directories.
+# 022 is the "historical" value in Debian for UMASK
+# 027, or even 077, could be considered better for privacy
+# There is no One True Answer here : each sysadmin must make up his/her
+# mind.
+#
+# If USERGROUPS_ENAB is set to "yes", that will modify this UMASK default value
+# for private user groups, i. e. the uid is the same as gid, and username is
+# the same as the primary group name: for these, the user permissions will be
+# used as group permissions, e. g. 022 will become 002.
+#
+# Prefix these values with "0" to get octal, "0x" to get hexadecimal.
+#
+ERASECHAR	0177
+KILLCHAR	025
+UMASK		{{ umask }}
+
+# Enable setting of the umask group bits to be the same as owner bits (examples: `022` -> `002`, `077` -> `007`) for non-root users, if the uid is the same as gid, and username is the same as the primary group name.
+# If set to yes, userdel will remove the user´s group if it contains no more members, and useradd will create by default a group with the name of the user.
+USERGROUPS_ENAB yes
+
+#
+# Password aging controls:
+#
+#	PASS_MAX_DAYS	Maximum number of days a password may be used.
+#	PASS_MIN_DAYS	Minimum number of days allowed between password changes.
+#	PASS_WARN_AGE	Number of days warning given before a password expires.
+#
+PASS_MAX_DAYS	{{ pwd_max_age }}
+PASS_MIN_DAYS	{{ pwd_min_age }}
+PASS_WARN_AGE	7
+
+#
+# Min/max values for automatic uid selection in useradd
+#
+UID_MIN			 {{ uid_min }}
+UID_MAX			60000
+# System accounts
+SYS_UID_MIN		  {{ sys_uid_min }}
+SYS_UID_MAX		  {{ sys_uid_max }}
+
+# Min/max values for automatic gid selection in groupadd
+GID_MIN			 {{ gid_min }}
+GID_MAX			60000
+# System accounts
+SYS_GID_MIN		  {{ sys_gid_min }}
+SYS_GID_MAX		  {{ sys_gid_max }}
+
+#
+# Max number of login retries if password is bad. This will most likely be
+# overriden by PAM, since the default pam_unix module has it's own built
+# in of 3 retries. However, this is a safe fallback in case you are using
+# an authentication module that does not enforce PAM_MAXTRIES.
+#
+LOGIN_RETRIES		{{ login_retries }}
+
+#
+# Max time in seconds for login
+#
+LOGIN_TIMEOUT		{{ login_timeout }}
+
+#
+# Which fields may be changed by regular users using chfn - use
+# any combination of letters "frwh" (full name, room number, work
+# phone, home phone).  If not defined, no changes are allowed.
+# For backward compatibility, "yes" = "rwh" and "no" = "frwh".
+# 
+{% if chfn_restrict %}
+CHFN_RESTRICT		{{ chfn_restrict }}
+{% endif %}
+
+#
+# Should login be allowed if we can't cd to the home directory?
+# Default in no.
+#
+DEFAULT_HOME	{% if allow_login_without_home %} yes {% else %} no {% endif %}
+
+#
+# If defined, this command is run when removing a user.
+# It should remove any at/cron/print jobs etc. owned by
+# the user to be removed (passed as the first argument).
+#
+#USERDEL_CMD	/usr/sbin/userdel_local
+
+#
+# Enable setting of the umask group bits to be the same as owner bits
+# (examples: 022 -> 002, 077 -> 007) for non-root users, if the uid is
+# the same as gid, and username is the same as the primary group name.
+#
+# If set to yes, userdel will remove the user´s group if it contains no
+# more members, and useradd will create by default a group with the name
+# of the user.
+#
+USERGROUPS_ENAB yes
+
+#
+# Instead of the real user shell, the program specified by this parameter
+# will be launched, although its visible name (argv[0]) will be the shell's.
+# The program may do whatever it wants (logging, additional authentification,
+# banner, ...) before running the actual shell.
+#
+# FAKE_SHELL /bin/fakeshell
+
+#
+# If defined, either full pathname of a file containing device names or
+# a ":" delimited list of device names.  Root logins will be allowed only
+# upon these devices.
+#
+# This variable is used by login and su.
+#
+#CONSOLE	/etc/consoles
+#CONSOLE	console:tty01:tty02:tty03:tty04
+
+#
+# List of groups to add to the user's supplementary group set
+# when logging in on the console (as determined by the CONSOLE
+# setting).  Default is none.
+#
+# Use with caution - it is possible for users to gain permanent
+# access to these groups, even when not logged in on the console.
+# How to do it is left as an exercise for the reader...
+#
+# This variable is used by login and su.
+#
+#CONSOLE_GROUPS		floppy:audio:cdrom
+
+#
+# If set to "yes", new passwords will be encrypted using the MD5-based
+# algorithm compatible with the one used by recent releases of FreeBSD.
+# It supports passwords of unlimited length and longer salt strings.
+# Set to "no" if you need to copy encrypted passwords to other systems
+# which don't understand the new algorithm.  Default is "no".
+#
+# This variable is deprecated. You should use ENCRYPT_METHOD.
+#
+MD5_CRYPT_ENAB	no
+
+#
+# If set to MD5 , MD5-based algorithm will be used for encrypting password
+# If set to SHA256, SHA256-based algorithm will be used for encrypting password
+# If set to SHA512, SHA512-based algorithm will be used for encrypting password
+# If set to DES, DES-based algorithm will be used for encrypting password (default)
+# Overrides the MD5_CRYPT_ENAB option
+#
+# Note: It is recommended to use a value consistent with
+# the PAM modules configuration.
+#
+ENCRYPT_METHOD SHA512
+
+#
+# Only used if ENCRYPT_METHOD is set to SHA256 or SHA512.
+#
+# Define the number of SHA rounds.
+# With a lot of rounds, it is more difficult to brute forcing the password.
+# But note also that it more CPU resources will be needed to authenticate
+# users.
+#
+# If not specified, the libc will choose the default number of rounds (5000).
+# The values must be inside the 1000-999999999 range.
+# If only one of the MIN or MAX values is set, then this value will be used.
+# If MIN > MAX, the highest value will be used.
+#
+# SHA_CRYPT_MIN_ROUNDS 5000
+# SHA_CRYPT_MAX_ROUNDS 5000
+
+################# OBSOLETED BY PAM ##############
+#						#
+# These options are now handled by PAM. Please	#
+# edit the appropriate file in /etc/pam.d/ to	#
+# enable the equivelants of them.
+#
+###############
+
+#MOTD_FILE
+#DIALUPS_CHECK_ENAB
+#LASTLOG_ENAB
+#MAIL_CHECK_ENAB
+#OBSCURE_CHECKS_ENAB
+#PORTTIME_CHECKS_ENAB
+#SU_WHEEL_ONLY
+#CRACKLIB_DICTPATH
+#PASS_CHANGE_TRIES
+#PASS_ALWAYS_WARN
+#ENVIRON_FILE
+#NOLOGINS_FILE
+#ISSUE_FILE
+#PASS_MIN_LEN
+#PASS_MAX_LEN
+#ULIMIT
+#ENV_HZ
+#CHFN_AUTH
+#CHSH_AUTH
+#FAIL_DELAY
+
+################# OBSOLETED #######################
+#						  #
+# These options are no more handled by shadow.    #
+#                                                 #
+# Shadow utilities will display a warning if they #
+# still appear.                                   #
+#                                                 #
+###################################################
+
+# CLOSE_SESSIONS
+# LOGIN_STRING
+# NO_PASSWORD_CONSOLE
+# QMAIL_DIR
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/modules b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/modules
new file mode 100644
index 0000000000000000000000000000000000000000..ef0354ee35fa363b303bb22c6ed0d2d1196aed52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/modules
@@ -0,0 +1,117 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# /etc/modules: kernel modules to load at boot time.
+#
+# This file contains the names of kernel modules that should be loaded
+# at boot time, one per line. Lines beginning with "#" are ignored.
+# Parameters can be specified after the module name.
+
+# Arch
+# ----
+# 
+# Modules for certains builds, contains support modules and some CPU-specific optimizations.
+
+{% if arch == "x86_64" -%}
+# Optimize for x86_64 cryptographic features
+twofish-x86_64-3way
+twofish-x86_64
+aes-x86_64
+salsa20-x86_64
+blowfish-x86_64
+{% endif -%}
+
+{% if cpuVendor == "intel" -%}
+# Intel-specific optimizations
+ghash-clmulni-intel
+aesni-intel
+kvm-intel
+{% endif -%}
+
+{% if cpuVendor == "amd" -%}
+# AMD-specific optimizations
+kvm-amd
+{% endif -%}
+
+kvm
+
+
+# Crypto
+# ------
+
+# Some core modules which comprise strong cryptography.
+blowfish_common
+blowfish_generic
+ctr
+cts
+lrw
+lzo
+rmd160
+rmd256
+rmd320
+serpent
+sha512_generic
+twofish_common
+twofish_generic
+xts
+zlib
+
+
+# Drivers
+# -------
+
+# Basics
+lp
+rtc
+loop
+
+# Filesystems
+ext2
+btrfs
+
+{% if desktop_enable -%}
+# Desktop
+psmouse
+snd
+snd_ac97_codec
+snd_intel8x0
+snd_page_alloc
+snd_pcm
+snd_timer
+soundcore
+usbhid
+{% endif -%}
+
+# Lib
+# ---
+xz
+
+
+# Net
+# ---
+
+# All packets needed for netfilter rules (ie iptables, ebtables).
+ip_tables
+x_tables
+iptable_filter
+iptable_nat
+
+# Targets
+ipt_LOG
+ipt_REJECT
+
+# Modules
+xt_connlimit
+xt_tcpudp
+xt_recent
+xt_limit
+xt_conntrack
+nf_conntrack
+nf_conntrack_ipv4
+nf_defrag_ipv4
+xt_state
+nf_nat
+
+# Addons
+xt_pknock
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/passwdqc.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f98d14e57428c106692e0f57e8b381f2b0a12c44
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/passwdqc.conf
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: passwdqc password strength enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Password-Type: Primary
+Password:
+  requisite     pam_passwdqc.so {{ auth_pam_passwdqc_options }}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
new file mode 100644
index 0000000000000000000000000000000000000000..fd2de791b96fbb8889811daf7340d1f2ca2ab3a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/pinerolo_profile.sh
@@ -0,0 +1,8 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Disable core dumps via soft limits for all users. Compliance to this setting
+# is voluntary and can be modified by users up to a hard limit. This setting is
+# a sane default.
+ulimit -S -c 0 > /dev/null 2>&1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/securetty b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/securetty
new file mode 100644
index 0000000000000000000000000000000000000000..15b18d4e2f45747845d0b65c06997f154ef674a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/securetty
@@ -0,0 +1,11 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# A list of TTYs, from which root can log in
+# see `man securetty` for reference
+{% if ttys -%}
+{% for tty in ttys -%}
+{{ tty }}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/tally2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/tally2
new file mode 100644
index 0000000000000000000000000000000000000000..d9620299c55e51abbee1017a227c217cd4a9fd33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/host/templates/tally2
@@ -0,0 +1,14 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+Name: tally2 lockout after failed attempts enforcement
+Default: yes
+Priority: 1024
+Conflicts: cracklib
+Auth-Type: Primary
+Auth-Initial:
+  required      pam_tally2.so deny={{ auth_retries }} onerr=fail unlock_time={{ auth_lockout_time }}
+Account-Type: Primary
+Account-Initial:
+  required      pam_tally2.so
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1990d8513bbeef067a8d9a2168e1952efb2961dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.mysql.checks import config
+
+
+def run_mysql_checks():
+    log("Starting MySQL hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("MySQL hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..a79f33b74a5c2972a82f0b4d8de8d1073dc293ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/checks/config.py
@@ -0,0 +1,87 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    FilePermissionAudit,
+    DirectoryPermissionAudit,
+    TemplatedFile,
+)
+from charmhelpers.contrib.hardening.mysql import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get MySQL hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    if subprocess.call(['which', 'mysql'], stdout=subprocess.PIPE) != 0:
+        log("MySQL does not appear to be installed on this node - "
+            "skipping mysql hardening", level=WARNING)
+        return []
+
+    settings = utils.get_settings('mysql')
+    hardening_settings = settings['hardening']
+    my_cnf = hardening_settings['mysql-conf']
+
+    audits = [
+        FilePermissionAudit(paths=[my_cnf], user='root',
+                            group='root', mode=0o0600),
+
+        TemplatedFile(hardening_settings['hardening-conf'],
+                      MySQLConfContext(),
+                      TEMPLATES_DIR,
+                      mode=0o0750,
+                      user='mysql',
+                      group='root',
+                      service_actions=[{'service': 'mysql',
+                                        'actions': ['restart']}]),
+
+        # MySQL and Percona charms do not allow configuration of the
+        # data directory, so use the default.
+        DirectoryPermissionAudit('/var/lib/mysql',
+                                 user='mysql',
+                                 group='mysql',
+                                 recursive=False,
+                                 mode=0o755),
+
+        DirectoryPermissionAudit('/etc/mysql',
+                                 user='root',
+                                 group='root',
+                                 recursive=False,
+                                 mode=0o700),
+    ]
+
+    return audits
+
+
+class MySQLConfContext(object):
+    """Defines the set of key/value pairs to set in a mysql config file.
+
+    This context, when called, will return a dictionary containing the
+    key/value pairs of setting to specify in the
+    /etc/mysql/conf.d/hardening.cnf file.
+    """
+    def __call__(self):
+        settings = utils.get_settings('mysql')
+        # Translate for python3
+        return {'mysql_settings':
+                [(k, v) for k, v in six.iteritems(settings['security'])]}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
new file mode 100644
index 0000000000000000000000000000000000000000..8242586cd66360b7e6ae33f13018363b95cd4ea9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/mysql/templates/hardening.cnf
@@ -0,0 +1,12 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+[mysqld]
+{% for setting, value in mysql_settings -%}
+{% if value == 'True' -%}
+{{ setting }}
+{% elif value != 'None' and value != None -%}
+{{ setting }} = {{ value }}
+{% endif -%}
+{% endfor -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..58bebd846bd6fa648cfab6ab1056ad10d8415453
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from os import path
+
+TEMPLATES_DIR = path.join(path.dirname(__file__), 'templates')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edaf484b39f8c7353cebb2f4b68944c6493ba7b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/__init__.py
@@ -0,0 +1,29 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.contrib.hardening.ssh.checks import config
+
+
+def run_ssh_checks():
+    log("Starting SSH hardening checks.", level=DEBUG)
+    checks = config.get_audits()
+    for check in checks:
+        log("Running '%s' check" % (check.__class__.__name__), level=DEBUG)
+        check.ensure_compliance()
+
+    log("SSH hardening checks complete.", level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..41bed2d1e7b031182edcf62710876e4073dfbc6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/checks/config.py
@@ -0,0 +1,435 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_iface_addr,
+    is_ip,
+)
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+)
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    FileContentAudit,
+)
+from charmhelpers.contrib.hardening.ssh import TEMPLATES_DIR
+from charmhelpers.contrib.hardening import utils
+
+
+def get_audits():
+    """Get SSH hardening config audits.
+
+    :returns:  dictionary of audits
+    """
+    audits = [SSHConfig(), SSHDConfig(), SSHConfigFileContentAudit(),
+              SSHDConfigFileContentAudit()]
+    return audits
+
+
+class SSHConfigContext(object):
+
+    type = 'client'
+
+    def get_macs(self, allow_weak_mac):
+        if allow_weak_mac:
+            weak_macs = 'weak'
+        else:
+            weak_macs = 'default'
+
+        default = 'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160'
+        macs = {'default': default,
+                'weak': default + ',hmac-sha1'}
+
+        default = ('hmac-sha2-512-etm@openssh.com,'
+                   'hmac-sha2-256-etm@openssh.com,'
+                   'hmac-ripemd160-etm@openssh.com,umac-128-etm@openssh.com,'
+                   'hmac-sha2-512,hmac-sha2-256,hmac-ripemd160')
+        macs_66 = {'default': default,
+                   'weak': default + ',hmac-sha1'}
+
+        # Use newer ciphers on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log("Detected Ubuntu 14.04 or newer, using new macs", level=DEBUG)
+            macs = macs_66
+
+        return macs[weak_macs]
+
+    def get_kexs(self, allow_weak_kex):
+        if allow_weak_kex:
+            weak_kex = 'weak'
+        else:
+            weak_kex = 'default'
+
+        default = 'diffie-hellman-group-exchange-sha256'
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex = {'default': default,
+               'weak': weak}
+
+        default = ('curve25519-sha256@libssh.org,'
+                   'diffie-hellman-group-exchange-sha256')
+        weak = (default + ',diffie-hellman-group14-sha1,'
+                'diffie-hellman-group-exchange-sha1,'
+                'diffie-hellman-group1-sha1')
+        kex_66 = {'default': default,
+                  'weak': weak}
+
+        # Use newer kex on Ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new key exchange '
+                'algorithms', level=DEBUG)
+            kex = kex_66
+
+        return kex[weak_kex]
+
+    def get_ciphers(self, cbc_required):
+        if cbc_required:
+            weak_ciphers = 'weak'
+        else:
+            weak_ciphers = 'default'
+
+        default = 'aes256-ctr,aes192-ctr,aes128-ctr'
+        cipher = {'default': default,
+                  'weak': default + 'aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        default = ('chacha20-poly1305@openssh.com,aes256-gcm@openssh.com,'
+                   'aes128-gcm@openssh.com,aes256-ctr,aes192-ctr,aes128-ctr')
+        ciphers_66 = {'default': default,
+                      'weak': default + ',aes256-cbc,aes192-cbc,aes128-cbc'}
+
+        # Use newer ciphers on ubuntu Trusty and above
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            log('Detected Ubuntu 14.04 or newer, using new ciphers',
+                level=DEBUG)
+            cipher = ciphers_66
+
+        return cipher[weak_ciphers]
+
+    def get_listening(self, listen=['0.0.0.0']):
+        """Returns a list of addresses SSH can list on
+
+        Turns input into a sensible list of IPs SSH can listen on. Input
+        must be a python list of interface names, IPs and/or CIDRs.
+
+        :param listen: list of IPs, CIDRs, interface names
+
+        :returns: list of IPs available on the host
+        """
+        if listen == ['0.0.0.0']:
+            return listen
+
+        value = []
+        for network in listen:
+            try:
+                ip = get_address_in_network(network=network, fatal=True)
+            except ValueError:
+                if is_ip(network):
+                    ip = network
+                else:
+                    try:
+                        ip = get_iface_addr(iface=network, fatal=False)[0]
+                    except IndexError:
+                        continue
+            value.append(ip)
+        if value == []:
+            return ['0.0.0.0']
+        return value
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'addr_family': addr_family,
+            'remote_hosts': settings['common']['remote_hosts'],
+            'password_auth_allowed':
+            settings['client']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'ciphers': self.get_ciphers(settings['client']['cbc_required']),
+            'macs': self.get_macs(settings['client']['weak_hmac']),
+            'kexs': self.get_kexs(settings['client']['weak_kex']),
+            'roaming': settings['client']['roaming'],
+        }
+        return ctxt
+
+
+class SSHConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/ssh_config'
+        super(SSHConfig, self).__init__(path=path,
+                                        template_dir=TEMPLATES_DIR,
+                                        context=SSHConfigContext(),
+                                        user='root',
+                                        group='root',
+                                        mode=0o0644)
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['client']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHDConfigContext(SSHConfigContext):
+
+    type = 'server'
+
+    def __call__(self):
+        settings = utils.get_settings('ssh')
+        if settings['common']['network_ipv6_enable']:
+            addr_family = 'any'
+        else:
+            addr_family = 'inet'
+
+        ctxt = {
+            'ssh_ip': self.get_listening(settings['server']['listen_to']),
+            'password_auth_allowed':
+            settings['server']['password_authentication'],
+            'ports': settings['common']['ports'],
+            'addr_family': addr_family,
+            'ciphers': self.get_ciphers(settings['server']['cbc_required']),
+            'macs': self.get_macs(settings['server']['weak_hmac']),
+            'kexs': self.get_kexs(settings['server']['weak_kex']),
+            'host_key_files': settings['server']['host_key_files'],
+            'allow_root_with_key': settings['server']['allow_root_with_key'],
+            'password_authentication':
+            settings['server']['password_authentication'],
+            'use_priv_sep': settings['server']['use_privilege_separation'],
+            'use_pam': settings['server']['use_pam'],
+            'allow_x11_forwarding': settings['server']['allow_x11_forwarding'],
+            'print_motd': settings['server']['print_motd'],
+            'print_last_log': settings['server']['print_last_log'],
+            'client_alive_interval':
+            settings['server']['alive_interval'],
+            'client_alive_count': settings['server']['alive_count'],
+            'allow_tcp_forwarding': settings['server']['allow_tcp_forwarding'],
+            'allow_agent_forwarding':
+            settings['server']['allow_agent_forwarding'],
+            'deny_users': settings['server']['deny_users'],
+            'allow_users': settings['server']['allow_users'],
+            'deny_groups': settings['server']['deny_groups'],
+            'allow_groups': settings['server']['allow_groups'],
+            'use_dns': settings['server']['use_dns'],
+            'sftp_enable': settings['server']['sftp_enable'],
+            'sftp_group': settings['server']['sftp_group'],
+            'sftp_chroot': settings['server']['sftp_chroot'],
+            'max_auth_tries': settings['server']['max_auth_tries'],
+            'max_sessions': settings['server']['max_sessions'],
+        }
+        return ctxt
+
+
+class SSHDConfig(TemplatedFile):
+    def __init__(self):
+        path = '/etc/ssh/sshd_config'
+        super(SSHDConfig, self).__init__(path=path,
+                                         template_dir=TEMPLATES_DIR,
+                                         context=SSHDConfigContext(),
+                                         user='root',
+                                         group='root',
+                                         mode=0o0600,
+                                         service_actions=[{'service': 'ssh',
+                                                           'actions':
+                                                           ['restart']}])
+
+    def pre_write(self):
+        settings = utils.get_settings('ssh')
+        apt_update(fatal=True)
+        apt_install(settings['server']['package'])
+        if not os.path.exists('/etc/ssh'):
+            os.makedir('/etc/ssh')
+            # NOTE: don't recurse
+            utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                     maxdepth=0)
+
+    def post_write(self):
+        # NOTE: don't recurse
+        utils.ensure_permissions('/etc/ssh', 'root', 'root', 0o0755,
+                                 maxdepth=0)
+
+
+class SSHConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/ssh_config'
+        super(SSHConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['client']['weak_hmac']:
+                self.fail_cases.append(r'^MACs.+,hmac-sha1$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['client']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['client']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['client']['roaming']:
+            self.pass_cases.append(r'^UseRoaming yes$')
+        else:
+            self.fail_cases.append(r'^UseRoaming yes$')
+
+        return super(SSHConfigFileContentAudit, self).is_compliant(*args,
+                                                                   **kwargs)
+
+
+class SSHDConfigFileContentAudit(FileContentAudit):
+    def __init__(self):
+        self.path = '/etc/ssh/sshd_config'
+        super(SSHDConfigFileContentAudit, self).__init__(self.path, {})
+
+    def is_compliant(self, *args, **kwargs):
+        self.pass_cases = []
+        self.fail_cases = []
+        settings = utils.get_settings('ssh')
+
+        _release = lsb_release()['DISTRIB_CODENAME'].lower()
+        if CompareHostReleases(_release) >= 'trusty':
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms.+,diffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms.*diffie-hellman-group14-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\schacha20-poly1305@openssh.com,.+')  # noqa
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr$')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+        else:
+            if not settings['server']['weak_hmac']:
+                self.pass_cases.append(r'^MACs.+,hmac-ripemd160$')
+            else:
+                self.pass_cases.append(r'^MACs.+,hmac-sha1$')
+
+            if settings['server']['weak_kex']:
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+            else:
+                self.pass_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha256$')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group14-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group-exchange-sha1[,\s]?')  # noqa
+                self.fail_cases.append(r'^KexAlgorithms\sdiffie-hellman-group1-sha1[,\s]?')  # noqa
+
+            if settings['server']['cbc_required']:
+                self.pass_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.fail_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+            else:
+                self.fail_cases.append(r'^Ciphers\s.*-cbc[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes128-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes192-ctr[,\s]?')
+                self.pass_cases.append(r'^Ciphers\s.*aes256-ctr[,\s]?')
+
+        if settings['server']['sftp_enable']:
+            self.pass_cases.append(r'^Subsystem\ssftp')
+        else:
+            self.fail_cases.append(r'^Subsystem\ssftp')
+
+        return super(SSHDConfigFileContentAudit, self).is_compliant(*args,
+                                                                    **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/ssh_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/ssh_config
new file mode 100644
index 0000000000000000000000000000000000000000..9742d8e2a32cd5da01a9dcb691a5a1201ed93050
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/ssh_config
@@ -0,0 +1,70 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#       be overwritten.
+###############################################################################
+# This is the ssh client system-wide configuration file.  See
+# ssh_config(5) for more information.  This file provides defaults for
+# users, and the values can be changed in per-user configuration files
+# or on the command line.
+
+# Configuration data is parsed as follows:
+#  1. command line options
+#  2. user-specific file
+#  3. system-wide file
+# Any configuration value is only changed the first time it is set.
+# Thus, host-specific definitions should be at the beginning of the
+# configuration file, and defaults at the end.
+
+# Site-wide defaults for some commonly used options.  For a comprehensive
+# list of available options, their meanings and defaults, please see the
+# ssh_config(5) man page.
+
+# Restrict the following configuration to be limited to this Host.
+{% if remote_hosts -%}
+Host {{ ' '.join(remote_hosts) }}
+{% endif %}
+ForwardAgent no
+ForwardX11 no
+ForwardX11Trusted yes
+RhostsRSAAuthentication no
+RSAAuthentication yes
+PasswordAuthentication {{ password_auth_allowed }}
+HostbasedAuthentication no
+GSSAPIAuthentication no
+GSSAPIDelegateCredentials no
+GSSAPIKeyExchange no
+GSSAPITrustDNS no
+BatchMode no
+CheckHostIP yes
+AddressFamily {{ addr_family }}
+ConnectTimeout 0
+StrictHostKeyChecking ask
+IdentityFile ~/.ssh/identity
+IdentityFile ~/.ssh/id_rsa
+IdentityFile ~/.ssh/id_dsa
+# The port at the destination should be defined
+{% for port in ports -%}
+Port {{ port }}
+{% endfor %}
+Protocol 2
+Cipher 3des
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{%- endif %}
+{% if macs -%}
+MACs {{ macs }}
+{%- endif %}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{%- endif %}
+EscapeChar ~
+Tunnel no
+TunnelDevice any:any
+PermitLocalCommand no
+VisualHostKey no
+RekeyLimit 1G 1h
+SendEnv LANG LC_*
+HashKnownHosts yes
+{% if roaming -%}
+UseRoaming {{ roaming }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/sshd_config b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/sshd_config
new file mode 100644
index 0000000000000000000000000000000000000000..5f87298a8119bcab1d2578bcaefd068e5af167c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/ssh/templates/sshd_config
@@ -0,0 +1,159 @@
+###############################################################################
+# WARNING: This configuration file is maintained by Juju. Local changes may
+#          be overwritten.
+###############################################################################
+# Package generated configuration file
+# See the sshd_config(5) manpage for details
+
+# What ports, IPs and protocols we listen for
+{% for port in ports -%}
+Port {{ port }}
+{% endfor -%}
+AddressFamily {{ addr_family }}
+# Use these options to restrict which interfaces/protocols sshd will bind to
+{% if ssh_ip -%}
+{% for ip in ssh_ip -%}
+ListenAddress {{ ip }}
+{% endfor %}
+{%- else -%}
+ListenAddress ::
+ListenAddress 0.0.0.0
+{% endif -%}
+Protocol 2
+{% if ciphers -%}
+Ciphers {{ ciphers }}
+{% endif -%}
+{% if macs -%}
+MACs {{ macs }}
+{% endif -%}
+{% if kexs -%}
+KexAlgorithms {{ kexs }}
+{% endif -%}
+# HostKeys for protocol version 2
+{% for keyfile in host_key_files -%}
+HostKey {{ keyfile }}
+{% endfor -%}
+
+# Privilege Separation is turned on for security
+{% if use_priv_sep -%} 
+UsePrivilegeSeparation {{ use_priv_sep }}
+{% endif -%}
+
+# Lifetime and size of ephemeral version 1 server key
+KeyRegenerationInterval 3600
+ServerKeyBits 1024
+
+# Logging
+SyslogFacility AUTH
+LogLevel VERBOSE
+
+# Authentication:
+LoginGraceTime 30s
+{% if allow_root_with_key -%}
+PermitRootLogin without-password
+{% else -%}
+PermitRootLogin no
+{% endif %}
+PermitTunnel no
+PermitUserEnvironment no
+StrictModes yes
+
+RSAAuthentication yes
+PubkeyAuthentication yes
+AuthorizedKeysFile %h/.ssh/authorized_keys
+
+# Don't read the user's ~/.rhosts and ~/.shosts files
+IgnoreRhosts yes
+# For this to work you will also need host keys in /etc/ssh_known_hosts
+RhostsRSAAuthentication no
+# similar for protocol version 2
+HostbasedAuthentication no
+# Uncomment if you don't trust ~/.ssh/known_hosts for RhostsRSAAuthentication
+IgnoreUserKnownHosts yes
+
+# To enable empty passwords, change to yes (NOT RECOMMENDED)
+PermitEmptyPasswords no
+
+# Change to yes to enable challenge-response passwords (beware issues with
+# some PAM modules and threads)
+ChallengeResponseAuthentication no
+
+# Change to no to disable tunnelled clear text passwords
+PasswordAuthentication {{ password_authentication }}
+
+# Kerberos options
+KerberosAuthentication no
+KerberosGetAFSToken no
+KerberosOrLocalPasswd no
+KerberosTicketCleanup yes
+
+# GSSAPI options
+GSSAPIAuthentication no
+GSSAPICleanupCredentials yes
+
+X11Forwarding {{ allow_x11_forwarding }}
+X11DisplayOffset 10
+X11UseLocalhost yes
+GatewayPorts no
+PrintMotd {{ print_motd }}
+PrintLastLog {{ print_last_log }}
+TCPKeepAlive no
+UseLogin no
+
+ClientAliveInterval {{ client_alive_interval }}
+ClientAliveCountMax {{ client_alive_count }}
+AllowTcpForwarding {{ allow_tcp_forwarding }}
+AllowAgentForwarding {{ allow_agent_forwarding }}
+
+MaxStartups 10:30:100
+#Banner /etc/issue.net
+
+# Allow client to pass locale environment variables
+AcceptEnv LANG LC_*
+
+# Set this to 'yes' to enable PAM authentication, account processing,
+# and session processing. If this is enabled, PAM authentication will
+# be allowed through the ChallengeResponseAuthentication and
+# PasswordAuthentication.  Depending on your PAM configuration,
+# PAM authentication via ChallengeResponseAuthentication may bypass
+# the setting of "PermitRootLogin without-password".
+# If you just want the PAM account and session checks to run without
+# PAM authentication, then enable this but set PasswordAuthentication
+# and ChallengeResponseAuthentication to 'no'.
+UsePAM {{ use_pam }}
+
+{% if deny_users -%}
+DenyUsers {{ deny_users }}
+{% endif -%}
+{% if allow_users -%}
+AllowUsers {{ allow_users }}
+{% endif -%}
+{% if deny_groups -%}
+DenyGroups {{ deny_groups }}
+{% endif -%}
+{% if allow_groups -%}
+AllowGroups allow_groups
+{% endif -%}
+UseDNS {{ use_dns }}
+MaxAuthTries {{ max_auth_tries }}
+MaxSessions {{ max_sessions }}
+
+{% if sftp_enable -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+Subsystem sftp internal-sftp -l VERBOSE
+
+## These lines must appear at the *end* of sshd_config
+Match Group {{ sftp_group }}
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory {{ sftp_chroot }}
+{% else -%}
+# Configuration, in case SFTP is used
+## override default of no subsystems
+## Subsystem sftp /opt/app/openssh5/libexec/sftp-server
+## These lines must appear at the *end* of sshd_config
+Match Group sftponly
+ForceCommand internal-sftp -l VERBOSE
+ChrootDirectory /sftpchroot/home/%u
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b6765f7edeee4bed739fd354c6f7bdf0a8c952e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/templating.py
@@ -0,0 +1,73 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+)
+
+try:
+    from jinja2 import FileSystemLoader, Environment
+except ImportError:
+    from charmhelpers.fetch import apt_install
+    from charmhelpers.fetch import apt_update
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, Environment
+
+
+# NOTE: function separated from main rendering code to facilitate easier
+#       mocking in unit tests.
+def write(path, data):
+    with open(path, 'wb') as out:
+        out.write(data)
+
+
+def get_template_path(template_dir, path):
+    """Returns the template file which would be used to render the path.
+
+    The path to the template file is returned.
+    :param template_dir: the directory the templates are located in
+    :param path: the file path to be written to.
+    :returns: path to the template file
+    """
+    return os.path.join(template_dir, os.path.basename(path))
+
+
+def render_and_write(template_dir, path, context):
+    """Renders the specified template into the file.
+
+    :param template_dir: the directory to load the template from
+    :param path: the path to write the templated contents to
+    :param context: the parameters to pass to the rendering engine
+    """
+    env = Environment(loader=FileSystemLoader(template_dir))
+    template_file = os.path.basename(path)
+    template = env.get_template(template_file)
+    log('Rendering from template: %s' % template.name, level=DEBUG)
+    rendered_content = template.render(context)
+    if not rendered_content:
+        log("Render returned None - skipping '%s'" % path,
+            level=WARNING)
+        return
+
+    write(path, rendered_content.encode('utf-8').strip())
+    log('Wrote template %s' % path, level=DEBUG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff7485c28c8748ba366dba54f1e3b8f7e6a7c619
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/hardening/utils.py
@@ -0,0 +1,155 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import grp
+import os
+import pwd
+import six
+import yaml
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+
+
+# Global settings cache. Since each hook fire entails a fresh module import it
+# is safe to hold this in memory and not risk missing config changes (since
+# they will result in a new hook fire and thus re-import).
+__SETTINGS__ = {}
+
+
+def _get_defaults(modules):
+    """Load the default config for the provided modules.
+
+    :param modules: stack modules config defaults to lookup.
+    :returns: modules default config dictionary.
+    """
+    default = os.path.join(os.path.dirname(__file__),
+                           'defaults/%s.yaml' % (modules))
+    return yaml.safe_load(open(default))
+
+
+def _get_schema(modules):
+    """Load the config schema for the provided modules.
+
+    NOTE: this schema is intended to have 1-1 relationship with they keys in
+    the default config and is used a means to verify valid overrides provided
+    by the user.
+
+    :param modules: stack modules config schema to lookup.
+    :returns: modules default schema dictionary.
+    """
+    schema = os.path.join(os.path.dirname(__file__),
+                          'defaults/%s.yaml.schema' % (modules))
+    return yaml.safe_load(open(schema))
+
+
+def _get_user_provided_overrides(modules):
+    """Load user-provided config overrides.
+
+    :param modules: stack modules to lookup in user overrides yaml file.
+    :returns: overrides dictionary.
+    """
+    overrides = os.path.join(os.environ['JUJU_CHARM_DIR'],
+                             'hardening.yaml')
+    if os.path.exists(overrides):
+        log("Found user-provided config overrides file '%s'" %
+            (overrides), level=DEBUG)
+        settings = yaml.safe_load(open(overrides))
+        if settings and settings.get(modules):
+            log("Applying '%s' overrides" % (modules), level=DEBUG)
+            return settings.get(modules)
+
+        log("No overrides found for '%s'" % (modules), level=DEBUG)
+    else:
+        log("No hardening config overrides file '%s' found in charm "
+            "root dir" % (overrides), level=DEBUG)
+
+    return {}
+
+
+def _apply_overrides(settings, overrides, schema):
+    """Get overrides config overlayed onto modules defaults.
+
+    :param modules: require stack modules config.
+    :returns: dictionary of modules config with user overrides applied.
+    """
+    if overrides:
+        for k, v in six.iteritems(overrides):
+            if k in schema:
+                if schema[k] is None:
+                    settings[k] = v
+                elif type(schema[k]) is dict:
+                    settings[k] = _apply_overrides(settings[k], overrides[k],
+                                                   schema[k])
+                else:
+                    raise Exception("Unexpected type found in schema '%s'" %
+                                    type(schema[k]), level=ERROR)
+            else:
+                log("Unknown override key '%s' - ignoring" % (k), level=INFO)
+
+    return settings
+
+
+def get_settings(modules):
+    global __SETTINGS__
+    if modules in __SETTINGS__:
+        return __SETTINGS__[modules]
+
+    schema = _get_schema(modules)
+    settings = _get_defaults(modules)
+    overrides = _get_user_provided_overrides(modules)
+    __SETTINGS__[modules] = _apply_overrides(settings, overrides, schema)
+    return __SETTINGS__[modules]
+
+
+def ensure_permissions(path, user, group, permissions, maxdepth=-1):
+    """Ensure permissions for path.
+
+    If path is a file, apply to file and return. If path is a directory,
+    apply recursively (if required) to directory contents and return.
+
+    :param user: user name
+    :param group: group name
+    :param permissions: octal permissions
+    :param maxdepth: maximum recursion depth. A negative maxdepth allows
+                     infinite recursion and maxdepth=0 means no recursion.
+    :returns: None
+    """
+    if not os.path.exists(path):
+        log("File '%s' does not exist - cannot set permissions" % (path),
+            level=WARNING)
+        return
+
+    _user = pwd.getpwnam(user)
+    os.chown(path, _user.pw_uid, grp.getgrnam(group).gr_gid)
+    os.chmod(path, permissions)
+
+    if maxdepth == 0:
+        log("Max recursion depth reached - skipping further recursion",
+            level=DEBUG)
+        return
+    elif maxdepth > 0:
+        maxdepth -= 1
+
+    if os.path.isdir(path):
+        contents = glob.glob("%s/*" % (path))
+        for c in contents:
+            ensure_permissions(c, user=user, group=group,
+                               permissions=permissions, maxdepth=maxdepth)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/infiniband.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/infiniband.py
new file mode 100644
index 0000000000000000000000000000000000000000..0edb2314114738c79859f51e505de05e5c7c8fcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/mellanox/infiniband.py
@@ -0,0 +1,153 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+import six
+
+from charmhelpers.fetch import (
+    apt_install,
+    apt_update,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+try:
+    from netifaces import interfaces as network_interfaces
+except ImportError:
+    if six.PY2:
+        apt_install('python-netifaces')
+    else:
+        apt_install('python3-netifaces')
+    from netifaces import interfaces as network_interfaces
+
+import os
+import re
+import subprocess
+
+from charmhelpers.core.kernel import modprobe
+
+REQUIRED_MODULES = (
+    "mlx4_ib",
+    "mlx4_en",
+    "mlx4_core",
+    "ib_ipath",
+    "ib_mthca",
+    "ib_srpt",
+    "ib_srp",
+    "ib_ucm",
+    "ib_isert",
+    "ib_iser",
+    "ib_ipoib",
+    "ib_cm",
+    "ib_uverbs"
+    "ib_umad",
+    "ib_sa",
+    "ib_mad",
+    "ib_core",
+    "ib_addr",
+    "rdma_ucm",
+)
+
+REQUIRED_PACKAGES = (
+    "ibutils",
+    "infiniband-diags",
+    "ibverbs-utils",
+)
+
+IPOIB_DRIVERS = (
+    "ib_ipoib",
+)
+
+ABI_VERSION_FILE = "/sys/class/infiniband_mad/abi_version"
+
+
+class DeviceInfo(object):
+    pass
+
+
+def install_packages():
+    apt_update()
+    apt_install(REQUIRED_PACKAGES, fatal=True)
+
+
+def load_modules():
+    for module in REQUIRED_MODULES:
+        modprobe(module, persist=True)
+
+
+def is_enabled():
+    """Check if infiniband is loaded on the system"""
+    return os.path.exists(ABI_VERSION_FILE)
+
+
+def stat():
+    """Return full output of ibstat"""
+    return subprocess.check_output(["ibstat"])
+
+
+def devices():
+    """Returns a list of IB enabled devices"""
+    return subprocess.check_output(['ibstat', '-l']).splitlines()
+
+
+def device_info(device):
+    """Returns a DeviceInfo object with the current device settings"""
+
+    status = subprocess.check_output([
+        'ibstat', device, '-s']).splitlines()
+
+    regexes = {
+        "CA type: (.*)": "device_type",
+        "Number of ports: (.*)": "num_ports",
+        "Firmware version: (.*)": "fw_ver",
+        "Hardware version: (.*)": "hw_ver",
+        "Node GUID: (.*)": "node_guid",
+        "System image GUID: (.*)": "sys_guid",
+    }
+
+    device = DeviceInfo()
+
+    for line in status:
+        for expression, key in regexes.items():
+            matches = re.search(expression, line)
+            if matches:
+                setattr(device, key, matches.group(1))
+
+    return device
+
+
+def ipoib_interfaces():
+    """Return a list of IPOIB capable ethernet interfaces"""
+    interfaces = []
+
+    for interface in network_interfaces():
+        try:
+            driver = re.search('^driver: (.+)$', subprocess.check_output([
+                'ethtool', '-i',
+                interface]), re.M).group(1)
+
+            if driver in IPOIB_DRIVERS:
+                interfaces.append(interface)
+        except Exception:
+            log("Skipping interface %s" % interface, level=INFO)
+            continue
+
+    return interfaces
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..b13277bb57c9227b1d9dfecf4f6750740e5a262a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ip.py
@@ -0,0 +1,602 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import glob
+import re
+import subprocess
+import six
+import socket
+
+from functools import partial
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    network_get_primary_address,
+    unit_get,
+    WARNING,
+    NoNetworkBinding,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    CompareHostReleases,
+)
+
+try:
+    import netifaces
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netifaces', fatal=True)
+    else:
+        apt_install('python3-netifaces', fatal=True)
+    import netifaces
+
+try:
+    import netaddr
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-netaddr', fatal=True)
+    else:
+        apt_install('python3-netaddr', fatal=True)
+    import netaddr
+
+
+def _validate_cidr(network):
+    try:
+        netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+
+def no_ip_found_error_out(network):
+    errmsg = ("No IP address found in network(s): %s" % network)
+    raise ValueError(errmsg)
+
+
+def _get_ipv6_network_from_address(address):
+    """Get an netaddr.IPNetwork for the given IPv6 address
+    :param address: a dict as returned by netifaces.ifaddresses
+    :returns netaddr.IPNetwork: None if the address is a link local or loopback
+    address
+    """
+    if address['addr'].startswith('fe80') or address['addr'] == "::1":
+        return None
+
+    prefix = address['netmask'].split("/")
+    if len(prefix) > 1:
+        netmask = prefix[1]
+    else:
+        netmask = address['netmask']
+    return netaddr.IPNetwork("%s/%s" % (address['addr'],
+                                        netmask))
+
+
+def get_address_in_network(network, fallback=None, fatal=False):
+    """Get an IPv4 or IPv6 address within the network from the host.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'. Supports multiple networks as a space-delimited list.
+    :param fallback (str): If no address is found, return fallback.
+    :param fatal (boolean): If no address is found, fallback is not
+        set and fatal is True then exit(1).
+    """
+    if network is None:
+        if fallback is not None:
+            return fallback
+
+        if fatal:
+            no_ip_found_error_out(network)
+        else:
+            return None
+
+    networks = network.split() or [network]
+    for network in networks:
+        _validate_cidr(network)
+        network = netaddr.IPNetwork(network)
+        for iface in netifaces.interfaces():
+            try:
+                addresses = netifaces.ifaddresses(iface)
+            except ValueError:
+                # If an instance was deleted between
+                # netifaces.interfaces() run and now, its interfaces are gone
+                continue
+            if network.version == 4 and netifaces.AF_INET in addresses:
+                for addr in addresses[netifaces.AF_INET]:
+                    cidr = netaddr.IPNetwork("%s/%s" % (addr['addr'],
+                                                        addr['netmask']))
+                    if cidr in network:
+                        return str(cidr.ip)
+
+            if network.version == 6 and netifaces.AF_INET6 in addresses:
+                for addr in addresses[netifaces.AF_INET6]:
+                    cidr = _get_ipv6_network_from_address(addr)
+                    if cidr and cidr in network:
+                        return str(cidr.ip)
+
+    if fallback is not None:
+        return fallback
+
+    if fatal:
+        no_ip_found_error_out(network)
+
+    return None
+
+
+def is_ipv6(address):
+    """Determine whether provided address is IPv6 or not."""
+    try:
+        address = netaddr.IPAddress(address)
+    except netaddr.AddrFormatError:
+        # probably a hostname - so not an address at all!
+        return False
+
+    return address.version == 6
+
+
+def is_address_in_network(network, address):
+    """
+    Determine whether the provided address is within a network range.
+
+    :param network (str): CIDR presentation format. For example,
+        '192.168.1.0/24'.
+    :param address: An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :returns boolean: Flag indicating whether address is in network.
+    """
+    try:
+        network = netaddr.IPNetwork(network)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Network (%s) is not in CIDR presentation format" %
+                         network)
+
+    try:
+        address = netaddr.IPAddress(address)
+    except (netaddr.core.AddrFormatError, ValueError):
+        raise ValueError("Address (%s) is not in correct presentation format" %
+                         address)
+
+    if address in network:
+        return True
+    else:
+        return False
+
+
+def _get_for_address(address, key):
+    """Retrieve an attribute of or the physical interface that
+    the IP address provided could be bound to.
+
+    :param address (str): An individual IPv4 or IPv6 address without a net
+        mask or subnet prefix. For example, '192.168.1.1'.
+    :param key: 'iface' for the physical interface name or an attribute
+        of the configured interface, for example 'netmask'.
+    :returns str: Requested attribute or None if address is not bindable.
+    """
+    address = netaddr.IPAddress(address)
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        if address.version == 4 and netifaces.AF_INET in addresses:
+            addr = addresses[netifaces.AF_INET][0]['addr']
+            netmask = addresses[netifaces.AF_INET][0]['netmask']
+            network = netaddr.IPNetwork("%s/%s" % (addr, netmask))
+            cidr = network.cidr
+            if address in cidr:
+                if key == 'iface':
+                    return iface
+                else:
+                    return addresses[netifaces.AF_INET][0][key]
+
+        if address.version == 6 and netifaces.AF_INET6 in addresses:
+            for addr in addresses[netifaces.AF_INET6]:
+                network = _get_ipv6_network_from_address(addr)
+                if not network:
+                    continue
+
+                cidr = network.cidr
+                if address in cidr:
+                    if key == 'iface':
+                        return iface
+                    elif key == 'netmask' and cidr:
+                        return str(cidr).split('/')[1]
+                    else:
+                        return addr[key]
+    return None
+
+
+get_iface_for_address = partial(_get_for_address, key='iface')
+
+
+get_netmask_for_address = partial(_get_for_address, key='netmask')
+
+
+def resolve_network_cidr(ip_address):
+    '''
+    Resolves the full address cidr of an ip_address based on
+    configured network interfaces
+    '''
+    netmask = get_netmask_for_address(ip_address)
+    return str(netaddr.IPNetwork("%s/%s" % (ip_address, netmask)).cidr)
+
+
+def format_ipv6_addr(address):
+    """If address is IPv6, wrap it in '[]' otherwise return None.
+
+    This is required by most configuration files when specifying IPv6
+    addresses.
+    """
+    if is_ipv6(address):
+        return "[%s]" % address
+
+    return None
+
+
+def is_ipv6_disabled():
+    try:
+        result = subprocess.check_output(
+            ['sysctl', 'net.ipv6.conf.all.disable_ipv6'],
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+    except subprocess.CalledProcessError:
+        return True
+
+    return "net.ipv6.conf.all.disable_ipv6 = 1" in result
+
+
+def get_iface_addr(iface='eth0', inet_type='AF_INET', inc_aliases=False,
+                   fatal=True, exc_list=None):
+    """Return the assigned IP address for a given interface, if any.
+
+    :param iface: network interface on which address(es) are expected to
+                  be found.
+    :param inet_type: inet address family
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :return: list of ip addresses
+    """
+    # Extract nic if passed /dev/ethX
+    if '/' in iface:
+        iface = iface.split('/')[-1]
+
+    if not exc_list:
+        exc_list = []
+
+    try:
+        inet_num = getattr(netifaces, inet_type)
+    except AttributeError:
+        raise Exception("Unknown inet type '%s'" % str(inet_type))
+
+    interfaces = netifaces.interfaces()
+    if inc_aliases:
+        ifaces = []
+        for _iface in interfaces:
+            if iface == _iface or _iface.split(':')[0] == iface:
+                ifaces.append(_iface)
+
+        if fatal and not ifaces:
+            raise Exception("Invalid interface '%s'" % iface)
+
+        ifaces.sort()
+    else:
+        if iface not in interfaces:
+            if fatal:
+                raise Exception("Interface '%s' not found " % (iface))
+            else:
+                return []
+
+        else:
+            ifaces = [iface]
+
+    addresses = []
+    for netiface in ifaces:
+        net_info = netifaces.ifaddresses(netiface)
+        if inet_num in net_info:
+            for entry in net_info[inet_num]:
+                if 'addr' in entry and entry['addr'] not in exc_list:
+                    addresses.append(entry['addr'])
+
+    if fatal and not addresses:
+        raise Exception("Interface '%s' doesn't have any %s addresses." %
+                        (iface, inet_type))
+
+    return sorted(addresses)
+
+
+get_ipv4_addr = partial(get_iface_addr, inet_type='AF_INET')
+
+
+def get_iface_from_addr(addr):
+    """Work out on which interface the provided address is configured."""
+    for iface in netifaces.interfaces():
+        addresses = netifaces.ifaddresses(iface)
+        for inet_type in addresses:
+            for _addr in addresses[inet_type]:
+                _addr = _addr['addr']
+                # link local
+                ll_key = re.compile("(.+)%.*")
+                raw = re.match(ll_key, _addr)
+                if raw:
+                    _addr = raw.group(1)
+
+                if _addr == addr:
+                    log("Address '%s' is configured on iface '%s'" %
+                        (addr, iface))
+                    return iface
+
+    msg = "Unable to infer net iface on which '%s' is configured" % (addr)
+    raise Exception(msg)
+
+
+def sniff_iface(f):
+    """Ensure decorated function is called with a value for iface.
+
+    If no iface provided, inject net iface inferred from unit private address.
+    """
+    def iface_sniffer(*args, **kwargs):
+        if not kwargs.get('iface', None):
+            kwargs['iface'] = get_iface_from_addr(unit_get('private-address'))
+
+        return f(*args, **kwargs)
+
+    return iface_sniffer
+
+
+@sniff_iface
+def get_ipv6_addr(iface=None, inc_aliases=False, fatal=True, exc_list=None,
+                  dynamic_only=True):
+    """Get assigned IPv6 address for a given interface.
+
+    Returns list of addresses found. If no address found, returns empty list.
+
+    If iface is None, we infer the current primary interface by doing a reverse
+    lookup on the unit private-address.
+
+    We currently only support scope global IPv6 addresses i.e. non-temporary
+    addresses. If no global IPv6 address is found, return the first one found
+    in the ipv6 address list.
+
+    :param iface: network interface on which ipv6 address(es) are expected to
+                  be found.
+    :param inc_aliases: include alias interfaces in search
+    :param fatal: if True, raise exception if address not found
+    :param exc_list: list of addresses to ignore
+    :param dynamic_only: only recognise dynamic addresses
+    :return: list of ipv6 addresses
+    """
+    addresses = get_iface_addr(iface=iface, inet_type='AF_INET6',
+                               inc_aliases=inc_aliases, fatal=fatal,
+                               exc_list=exc_list)
+
+    if addresses:
+        global_addrs = []
+        for addr in addresses:
+            key_scope_link_local = re.compile("^fe80::..(.+)%(.+)")
+            m = re.match(key_scope_link_local, addr)
+            if m:
+                eui_64_mac = m.group(1)
+                iface = m.group(2)
+            else:
+                global_addrs.append(addr)
+
+        if global_addrs:
+            # Make sure any found global addresses are not temporary
+            cmd = ['ip', 'addr', 'show', iface]
+            out = subprocess.check_output(cmd).decode('UTF-8')
+            if dynamic_only:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.* dynamic.*")
+            else:
+                key = re.compile("inet6 (.+)/[0-9]+ scope global.*")
+
+            addrs = []
+            for line in out.split('\n'):
+                line = line.strip()
+                m = re.match(key, line)
+                if m and 'temporary' not in line:
+                    # Return the first valid address we find
+                    for addr in global_addrs:
+                        if m.group(1) == addr:
+                            if not dynamic_only or \
+                                    m.group(1).endswith(eui_64_mac):
+                                addrs.append(addr)
+
+            if addrs:
+                return addrs
+
+    if fatal:
+        raise Exception("Interface '%s' does not have a scope global "
+                        "non-temporary ipv6 address." % iface)
+
+    return []
+
+
+def get_bridges(vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of bridges on the system."""
+    b_regex = "%s/*/bridge" % vnic_dir
+    return [x.replace(vnic_dir, '').split('/')[1] for x in glob.glob(b_regex)]
+
+
+def get_bridge_nics(bridge, vnic_dir='/sys/devices/virtual/net'):
+    """Return a list of nics comprising a given bridge on the system."""
+    brif_regex = "%s/%s/brif/*" % (vnic_dir, bridge)
+    return [x.split('/')[-1] for x in glob.glob(brif_regex)]
+
+
+def is_bridge_member(nic):
+    """Check if a given nic is a member of a bridge."""
+    for bridge in get_bridges():
+        if nic in get_bridge_nics(bridge):
+            return True
+
+    return False
+
+
+def is_ip(address):
+    """
+    Returns True if address is a valid IP address.
+    """
+    try:
+        # Test to see if already an IPv4/IPv6 address
+        address = netaddr.IPAddress(address)
+        return True
+    except (netaddr.AddrFormatError, ValueError):
+        return False
+
+
+def ns_query(address):
+    try:
+        import dns.resolver
+    except ImportError:
+        if six.PY2:
+            apt_install('python-dnspython', fatal=True)
+        else:
+            apt_install('python3-dnspython', fatal=True)
+        import dns.resolver
+
+    if isinstance(address, dns.name.Name):
+        rtype = 'PTR'
+    elif isinstance(address, six.string_types):
+        rtype = 'A'
+    else:
+        return None
+
+    try:
+        answers = dns.resolver.query(address, rtype)
+    except dns.resolver.NXDOMAIN:
+        return None
+
+    if answers:
+        return str(answers[0])
+    return None
+
+
+def get_host_ip(hostname, fallback=None):
+    """
+    Resolves the IP for a given hostname, or returns
+    the input if it is already an IP.
+    """
+    if is_ip(hostname):
+        return hostname
+
+    ip_addr = ns_query(hostname)
+    if not ip_addr:
+        try:
+            ip_addr = socket.gethostbyname(hostname)
+        except Exception:
+            log("Failed to resolve hostname '%s'" % (hostname),
+                level=WARNING)
+            return fallback
+    return ip_addr
+
+
+def get_hostname(address, fqdn=True):
+    """
+    Resolves hostname for given IP, or returns the input
+    if it is already a hostname.
+    """
+    if is_ip(address):
+        try:
+            import dns.reversename
+        except ImportError:
+            if six.PY2:
+                apt_install("python-dnspython", fatal=True)
+            else:
+                apt_install("python3-dnspython", fatal=True)
+            import dns.reversename
+
+        rev = dns.reversename.from_address(address)
+        result = ns_query(rev)
+
+        if not result:
+            try:
+                result = socket.gethostbyaddr(address)[0]
+            except Exception:
+                return None
+    else:
+        result = address
+
+    if fqdn:
+        # strip trailing .
+        if result.endswith('.'):
+            return result[:-1]
+        else:
+            return result
+    else:
+        return result.split('.')[0]
+
+
+def port_has_listener(address, port):
+    """
+    Returns True if the address:port is open and being listened to,
+    else False.
+
+    @param address: an IP address or hostname
+    @param port: integer port
+
+    Note calls 'zc' via a subprocess shell
+    """
+    cmd = ['nc', '-z', address, str(port)]
+    result = subprocess.call(cmd)
+    return not(bool(result))
+
+
+def assert_charm_supports_ipv6():
+    """Check whether we are able to support charms ipv6."""
+    release = lsb_release()['DISTRIB_CODENAME'].lower()
+    if CompareHostReleases(release) < "trusty":
+        raise Exception("IPv6 is not supported in the charms for Ubuntu "
+                        "versions less than Trusty 14.04")
+
+
+def get_relation_ip(interface, cidr_network=None):
+    """Return this unit's IP for the given interface.
+
+    Allow for an arbitrary interface to use with network-get to select an IP.
+    Handle all address selection options including passed cidr network and
+    IPv6.
+
+    Usage: get_relation_ip('amqp', cidr_network='10.0.0.0/8')
+
+    @param interface: string name of the relation.
+    @param cidr_network: string CIDR Network to select an address from.
+    @raises Exception if prefer-ipv6 is configured but IPv6 unsupported.
+    @returns IPv6 or IPv4 address
+    """
+    # Select the interface address first
+    # For possible use as a fallback bellow with get_address_in_network
+    try:
+        # Get the interface specific IP
+        address = network_get_primary_address(interface)
+    except NotImplementedError:
+        # If network-get is not available
+        address = get_host_ip(unit_get('private-address'))
+    except NoNetworkBinding:
+        log("No network binding for {}".format(interface), WARNING)
+        address = get_host_ip(unit_get('private-address'))
+
+    if config('prefer-ipv6'):
+        # Currently IPv6 has priority, eventually we want IPv6 to just be
+        # another network space.
+        assert_charm_supports_ipv6()
+        return get_ipv6_addr()[0]
+    elif cidr_network:
+        # If a specific CIDR network is passed get the address from that
+        # network.
+        return get_address_in_network(cidr_network, address)
+
+    # Return the interface address
+    return address
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd001bc2eaa9b1b511bbd1816e1089521935a50a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/__init__.py
@@ -0,0 +1,541 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helpers for interacting with OpenvSwitch '''
+import hashlib
+import subprocess
+import os
+import six
+
+from charmhelpers.fetch import apt_install
+
+
+from charmhelpers.core.hookenv import (
+    log, WARNING, INFO, DEBUG
+)
+from charmhelpers.core.host import (
+    service
+)
+
+
+BRIDGE_TEMPLATE = """\
+# This veth pair is required when neutron data-port is mapped to an existing linux bridge. lp:1635067
+
+auto {linuxbridge_port}
+iface {linuxbridge_port} inet manual
+    pre-up ip link add name {linuxbridge_port} type veth peer name {ovsbridge_port}
+    pre-up ip link set {ovsbridge_port} master {bridge}
+    pre-up ip link set {ovsbridge_port} up
+    up ip link set {linuxbridge_port} up
+    down ip link del {linuxbridge_port}
+"""
+
+MAX_KERNEL_INTERFACE_NAME_LEN = 15
+
+
+def get_bridges():
+    """Return list of the bridges on the default openvswitch
+
+    :returns: List of bridge names
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if ovs-vsctl fails
+    """
+    cmd = ["ovs-vsctl", "list-br"]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_bridges = [l.strip() for l in lines]
+    return [b for b in maybe_bridges if b]
+
+
+def get_bridge_ports(name):
+    """Return a list the ports on a named bridge
+
+    :param name: the name of the bridge to list
+    :type name: str
+    :returns: List of ports on the named bridge
+    :rtype: List[str]
+    :raises: subprocess.CalledProcessError if the ovs-vsctl command fails. If
+        the named bridge doesn't exist, then the exception will be raised.
+    """
+    cmd = ["ovs-vsctl", "--", "list-ports", name]
+    lines = subprocess.check_output(cmd).decode('utf-8').split("\n")
+    maybe_ports = [l.strip() for l in lines]
+    return [p for p in maybe_ports if p]
+
+
+def get_bridges_and_ports_map():
+    """Return dictionary of bridge to ports for the default openvswitch
+
+    :returns: a mapping of bridge name to a list of ports.
+    :rtype: Dict[str, List[str]]
+    :raises: subprocess.CalledProcessError if any of the underlying ovs-vsctl
+        command fail.
+    """
+    return {b: get_bridge_ports(b) for b in get_bridges()}
+
+
+def _dict_to_vsctl_set(data, table, entity):
+    """Helper that takes dictionary and provides ``ovs-vsctl set`` commands
+
+    :param data: Additional data to attach to interface
+        The keys in the data dictionary map directly to column names in the
+        OpenvSwitch table specified as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type data: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param table: Name of table to operate on
+    :type table: str
+    :param entity: Name of entity to operate on
+    :type entity: str
+    :returns: '--' separated ``ovs-vsctl set`` commands
+    :rtype: Iterator[Tuple[str, str, str, str, str]]
+    """
+    for (k, v) in data.items():
+        if isinstance(v, dict):
+            entries = {
+                '{}:{}'.format(k, dk): dv for (dk, dv) in v.items()}
+        else:
+            entries = {k: v}
+        for (colk, colv) in entries.items():
+            yield ('--', 'set', table, entity, '{}={}'.format(colk, colv))
+
+
+def add_bridge(name, datapath_type=None, brdata=None, exclusive=False):
+    """Add the named bridge to openvswitch and set/update bridge data for it
+
+    :param name: Name of bridge to create
+    :type name: str
+    :param datapath_type: Add datapath_type to bridge (DEPRECATED, use brdata)
+    :type datapath_type: Optional[str]
+    :param brdata: Additional data to attach to bridge
+        The keys in the brdata dictionary map directly to column names in the
+        OpenvSwitch bridge table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type brdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if bridge exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    log('Creating bridge {}'.format(name))
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-br', name))
+    if brdata:
+        for setcmd in _dict_to_vsctl_set(brdata, 'bridge', name):
+            cmd.extend(setcmd)
+    if datapath_type is not None:
+        log('DEPRECATION WARNING: add_bridge called with datapath_type, '
+            'please use the brdata keyword argument instead.')
+        cmd += ['--', 'set', 'bridge', name,
+                'datapath_type={}'.format(datapath_type)]
+    subprocess.check_call(cmd)
+
+
+def del_bridge(name):
+    """Delete the named bridge from openvswitch
+
+    :param name: Name of bridge to remove
+    :type name: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting bridge {}'.format(name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-br", name])
+
+
+def add_bridge_port(name, port, promisc=False, ifdata=None, exclusive=False,
+                    linkup=True, portdata=None):
+    """Add port to bridge and optionally set/update interface data for it
+
+    :param name: Name of bridge to attach port to
+    :type name: str
+    :param port: Name of port as represented in netdev
+    :type port: str
+    :param promisc: Whether to set promiscuous mode on interface
+                    True=on, False=off, None leave untouched
+    :type promisc: Optional[bool]
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :param linkup: Bring link up
+    :type linkup: bool
+    :param portdata: Additional data to attach to port. Similar to ifdata.
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-port', name, port))
+    for ovs_table, data in (('Interface', ifdata), ('Port', portdata)):
+        if data:
+            for setcmd in _dict_to_vsctl_set(data, ovs_table, port):
+                cmd.extend(setcmd)
+
+    log('Adding port {} to bridge {}'.format(port, name))
+    subprocess.check_call(cmd)
+    if linkup:
+        # This is mostly a workaround for CI environments, in the real world
+        # the bare metal provider would most likely have configured and brought
+        # up the link for us.
+        subprocess.check_call(["ip", "link", "set", port, "up"])
+    if promisc:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "on"])
+    elif promisc is False:
+        subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def del_bridge_port(name, port):
+    """Delete a port from the named openvswitch bridge
+
+    :param name: Name of bridge to remove port from
+    :type name: str
+    :param port: Name of port to remove
+    :type port: str
+    :raises: subprocess.CalledProcessError
+    """
+    log('Deleting port {} from bridge {}'.format(port, name))
+    subprocess.check_call(["ovs-vsctl", "--", "--if-exists", "del-port",
+                           name, port])
+    subprocess.check_call(["ip", "link", "set", port, "down"])
+    subprocess.check_call(["ip", "link", "set", port, "promisc", "off"])
+
+
+def add_bridge_bond(bridge, port, interfaces, portdata=None, ifdatamap=None,
+                    exclusive=False):
+    """Add bonded port in bridge from interfaces.
+
+    :param bridge: Name of bridge to add bonded port to
+    :type bridge: str
+    :param port: Name of created port
+    :type port: str
+    :param interfaces: Underlying interfaces that make up the bonded port
+    :type interfaces: Iterator[str]
+    :param portdata: Additional data to attach to the created bond port
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'bond-mode': 'balance-tcp',
+            'lacp': 'active',
+            'other-config': {
+                'lacp-time': 'fast',
+            },
+        }
+    :type portdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    :param ifdatamap: Map of data to attach to created bond interfaces
+        See _dict_to_vsctl_set() for detailed description.
+        Example:
+        {
+            'eth0': {
+                'type': 'dpdk',
+                'mtu-request': '9000',
+                'options': {
+                    'dpdk-devargs': '0000:01:00.0',
+                },
+            },
+        }
+    :type ifdatamap: Optional[Dict[str,Dict[str,Union[str,Dict[str,str]]]]]
+    :param exclusive: If True, raise exception if port exists
+    :type exclusive: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-vsctl', '--']
+    if not exclusive:
+        cmd.append('--may-exist')
+    cmd.extend(('add-bond', bridge, port))
+    cmd.extend(interfaces)
+    if portdata:
+        for setcmd in _dict_to_vsctl_set(portdata, 'port', port):
+            cmd.extend(setcmd)
+    if ifdatamap:
+        for ifname, ifdata in ifdatamap.items():
+            for setcmd in _dict_to_vsctl_set(ifdata, 'Interface', ifname):
+                cmd.extend(setcmd)
+    subprocess.check_call(cmd)
+
+
+def add_ovsbridge_linuxbridge(name, bridge, ifdata=None):
+    """Add linux bridge to the named openvswitch bridge
+
+    :param name: Name of ovs bridge to be added to Linux bridge
+    :type name: str
+    :param bridge: Name of Linux bridge to be added to ovs bridge
+    :type name: str
+    :param ifdata: Additional data to attach to interface
+        The keys in the ifdata dictionary map directly to column names in the
+        OpenvSwitch Interface table as defined in DB-SCHEMA [0] referenced in
+        RFC 7047 [1]
+
+        There are some established conventions for keys in the external-ids
+        column of various tables, consult the OVS Integration Guide [2] for
+        more details.
+
+        NOTE(fnordahl): Technically the ``external-ids`` column is called
+        ``external_ids`` (with an underscore) and we rely on ``ovs-vsctl``'s
+        behaviour of transforming dashes to underscores for us [3] so we can
+        have a more pleasant data structure.
+
+        0: http://www.openvswitch.org/ovs-vswitchd.conf.db.5.pdf
+        1: https://tools.ietf.org/html/rfc7047
+        2: http://docs.openvswitch.org/en/latest/topics/integration/
+        3: https://github.com/openvswitch/ovs/blob/
+               20dac08fdcce4b7fda1d07add3b346aa9751cfbc/
+                   lib/db-ctl-base.c#L189-L215
+    :type ifdata: Optional[Dict[str,Union[str,Dict[str,str]]]]
+    """
+    try:
+        import netifaces
+    except ImportError:
+        if six.PY2:
+            apt_install('python-netifaces', fatal=True)
+        else:
+            apt_install('python3-netifaces', fatal=True)
+        import netifaces
+
+    # NOTE(jamespage):
+    # Older code supported addition of a linuxbridge directly
+    # to an OVS bridge; ensure we don't break uses on upgrade
+    existing_ovs_bridge = port_to_br(bridge)
+    if existing_ovs_bridge is not None:
+        log('Linuxbridge {} is already directly in use'
+            ' by OVS bridge {}'.format(bridge, existing_ovs_bridge),
+            level=INFO)
+        return
+
+    # NOTE(jamespage):
+    # preserve existing naming because interfaces may already exist.
+    ovsbridge_port = "veth-" + name
+    linuxbridge_port = "veth-" + bridge
+    if (len(ovsbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN or
+            len(linuxbridge_port) > MAX_KERNEL_INTERFACE_NAME_LEN):
+        # NOTE(jamespage):
+        # use parts of hashed bridgename (openstack style) when
+        # a bridge name exceeds 15 chars
+        hashed_bridge = hashlib.sha256(bridge.encode('UTF-8')).hexdigest()
+        base = '{}-{}'.format(hashed_bridge[:8], hashed_bridge[-2:])
+        ovsbridge_port = "cvo{}".format(base)
+        linuxbridge_port = "cvb{}".format(base)
+
+    interfaces = netifaces.interfaces()
+    for interface in interfaces:
+        if interface == ovsbridge_port or interface == linuxbridge_port:
+            log('Interface {} already exists'.format(interface), level=INFO)
+            return
+
+    log('Adding linuxbridge {} to ovsbridge {}'.format(bridge, name),
+        level=INFO)
+
+    check_for_eni_source()
+
+    with open('/etc/network/interfaces.d/{}.cfg'.format(
+            linuxbridge_port), 'w') as config:
+        config.write(BRIDGE_TEMPLATE.format(linuxbridge_port=linuxbridge_port,
+                                            ovsbridge_port=ovsbridge_port,
+                                            bridge=bridge))
+
+    subprocess.check_call(["ifup", linuxbridge_port])
+    add_bridge_port(name, linuxbridge_port, ifdata=ifdata)
+
+
+def is_linuxbridge_interface(port):
+    ''' Check if the interface is a linuxbridge bridge
+    :param port: Name of an interface to check whether it is a Linux bridge
+    :returns: True if port is a Linux bridge'''
+
+    if os.path.exists('/sys/class/net/' + port + '/bridge'):
+        log('Interface {} is a Linux bridge'.format(port), level=DEBUG)
+        return True
+    else:
+        log('Interface {} is not a Linux bridge'.format(port), level=DEBUG)
+        return False
+
+
+def set_manager(manager):
+    ''' Set the controller for the local openvswitch '''
+    log('Setting manager for local ovs to {}'.format(manager))
+    subprocess.check_call(['ovs-vsctl', 'set-manager',
+                           'ssl:{}'.format(manager)])
+
+
+def set_Open_vSwitch_column_value(column_value):
+    """
+    Calls ovs-vsctl and sets the 'column_value' in the Open_vSwitch table.
+
+    :param column_value:
+            See http://www.openvswitch.org//ovs-vswitchd.conf.db.5.pdf for
+            details of the relevant values.
+    :type str
+    :raises CalledProcessException: possibly ovsdb-server is not running
+    """
+    log('Setting {} in the Open_vSwitch table'.format(column_value))
+    subprocess.check_call(['ovs-vsctl', 'set', 'Open_vSwitch', '.', column_value])
+
+
+CERT_PATH = '/etc/openvswitch/ovsclient-cert.pem'
+
+
+def get_certificate():
+    ''' Read openvswitch certificate from disk '''
+    if os.path.exists(CERT_PATH):
+        log('Reading ovs certificate from {}'.format(CERT_PATH))
+        with open(CERT_PATH, 'r') as cert:
+            full_cert = cert.read()
+            begin_marker = "-----BEGIN CERTIFICATE-----"
+            end_marker = "-----END CERTIFICATE-----"
+            begin_index = full_cert.find(begin_marker)
+            end_index = full_cert.rfind(end_marker)
+            if end_index == -1 or begin_index == -1:
+                raise RuntimeError("Certificate does not contain valid begin"
+                                   " and end markers.")
+            full_cert = full_cert[begin_index:(end_index + len(end_marker))]
+            return full_cert
+    else:
+        log('Certificate not found', level=WARNING)
+        return None
+
+
+def check_for_eni_source():
+    ''' Juju removes the source line when setting up interfaces,
+    replace if missing '''
+
+    with open('/etc/network/interfaces', 'r') as eni:
+        for line in eni:
+            if line == 'source /etc/network/interfaces.d/*':
+                return
+    with open('/etc/network/interfaces', 'a') as eni:
+        eni.write('\nsource /etc/network/interfaces.d/*')
+
+
+def full_restart():
+    ''' Full restart and reload of openvswitch '''
+    if os.path.exists('/etc/init/openvswitch-force-reload-kmod.conf'):
+        service('start', 'openvswitch-force-reload-kmod')
+    else:
+        service('force-reload-kmod', 'openvswitch-switch')
+
+
+def enable_ipfix(bridge, target,
+                 cache_active_timeout=60,
+                 cache_max_flows=128,
+                 sampling=64):
+    '''Enable IPFIX on bridge to target.
+    :param bridge: Bridge to monitor
+    :param target: IPFIX remote endpoint
+    :param cache_active_timeout: The maximum period in seconds for
+                                 which an IPFIX flow record is cached
+                                 and aggregated before being sent
+    :param cache_max_flows: The maximum number of IPFIX flow records
+                            that can be cached at a time
+    :param sampling: The rate at which packets should be sampled and
+                     sent to each target collector
+    '''
+    cmd = [
+        'ovs-vsctl', 'set', 'Bridge', bridge, 'ipfix=@i', '--',
+        '--id=@i', 'create', 'IPFIX',
+        'targets="{}"'.format(target),
+        'sampling={}'.format(sampling),
+        'cache_active_timeout={}'.format(cache_active_timeout),
+        'cache_max_flows={}'.format(cache_max_flows),
+    ]
+    log('Enabling IPfix on {}.'.format(bridge))
+    subprocess.check_call(cmd)
+
+
+def disable_ipfix(bridge):
+    '''Diable IPFIX on target bridge.
+    :param bridge: Bridge to modify
+    '''
+    cmd = ['ovs-vsctl', 'clear', 'Bridge', bridge, 'ipfix']
+    subprocess.check_call(cmd)
+
+
+def port_to_br(port):
+    '''Determine the bridge that contains a port
+    :param port: Name of port to check for
+    :returns str: OVS bridge containing port or None if not found
+    '''
+    try:
+        return subprocess.check_output(
+            ['ovs-vsctl', 'port-to-br', port]
+        ).decode('UTF-8').strip()
+    except subprocess.CalledProcessError:
+        return None
+
+
+def ovs_appctl(target, args):
+    """Run `ovs-appctl` for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovs-appctl` looks for a pidfile and will build the path to
+                   a /var/run/openvswitch/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovs-appctl`
+    :type args: Tuple[str, ...]
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ovs-appctl', '-t', target]
+    cmd.extend(args)
+    return subprocess.check_output(cmd, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovn.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovn.py
new file mode 100644
index 0000000000000000000000000000000000000000..2075f11acfbeb3d0d614cf3db5a1b535bf128824
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovn.py
@@ -0,0 +1,233 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import subprocess
+import uuid
+
+from . import utils
+
+
+OVN_RUNDIR = '/var/run/ovn'
+OVN_SYSCONFDIR = '/etc/ovn'
+
+
+def ovn_appctl(target, args, rundir=None, use_ovs_appctl=False):
+    """Run ovn/ovs-appctl for target with args and return output.
+
+    :param target: Name of daemon to contact.  Unless target begins with '/',
+                   `ovn-appctl` looks for a pidfile and will build the path to
+                   a /var/run/ovn/target.pid.ctl for you.
+    :type target: str
+    :param args: Command and arguments to pass to `ovn-appctl`
+    :type args: Tuple[str, ...]
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :returns: Output from command
+    :rtype: str
+    :raises: subprocess.CalledProcessError
+    """
+    # NOTE(fnordahl): The ovsdb-server processes for the OVN databases use a
+    # non-standard naming scheme for their daemon control socket and we need
+    # to pass the full path to the socket.
+    if target in ('ovnnb_db', 'ovnsb_db',):
+        target = os.path.join(rundir or OVN_RUNDIR, target + '.ctl')
+
+    if use_ovs_appctl:
+        tool = 'ovs-appctl'
+    else:
+        tool = 'ovn-appctl'
+
+    return utils._run(tool, '-t', target, *args)
+
+
+class OVNClusterStatus(object):
+
+    def __init__(self, name, cluster_id, server_id, address, status, role,
+                 term, leader, vote, election_timer, log,
+                 entries_not_yet_committed, entries_not_yet_applied,
+                 connections, servers):
+        """Initialize and populate OVNClusterStatus object.
+
+        Use class initializer so we can define types in a compatible manner.
+
+        :param name: Name of schema used for database
+        :type name: str
+        :param cluster_id: UUID of cluster
+        :type cluster_id: uuid.UUID
+        :param server_id: UUID of server
+        :type server_id: uuid.UUID
+        :param address: OVSDB connection method
+        :type address: str
+        :param status: Status text
+        :type status: str
+        :param role: Role of server
+        :type role: str
+        :param term: Election term
+        :type term: int
+        :param leader: Short form UUID of leader
+        :type leader: str
+        :param vote: Vote
+        :type vote: str
+        :param election_timer: Current value of election timer
+        :type election_timer: int
+        :param log: Log
+        :type log: str
+        :param entries_not_yet_committed: Entries not yet committed
+        :type entries_not_yet_committed: int
+        :param entries_not_yet_applied: Entries not yet applied
+        :type entries_not_yet_applied: int
+        :param connections: Connections
+        :type connections: str
+        :param servers: Servers in the cluster
+            [('0ea6', 'ssl:192.0.2.42:6643')]
+        :type servers: List[Tuple[str,str]]
+        """
+        self.name = name
+        self.cluster_id = cluster_id
+        self.server_id = server_id
+        self.address = address
+        self.status = status
+        self.role = role
+        self.term = term
+        self.leader = leader
+        self.vote = vote
+        self.election_timer = election_timer
+        self.log = log
+        self.entries_not_yet_committed = entries_not_yet_committed
+        self.entries_not_yet_applied = entries_not_yet_applied
+        self.connections = connections
+        self.servers = servers
+
+    def __eq__(self, other):
+        return (
+            self.name == other.name and
+            self.cluster_id == other.cluster_id and
+            self.server_id == other.server_id and
+            self.address == other.address and
+            self.status == other.status and
+            self.role == other.role and
+            self.term == other.term and
+            self.leader == other.leader and
+            self.vote == other.vote and
+            self.election_timer == other.election_timer and
+            self.log == other.log and
+            self.entries_not_yet_committed == other.entries_not_yet_committed and
+            self.entries_not_yet_applied == other.entries_not_yet_applied and
+            self.connections == other.connections and
+            self.servers == other.servers)
+
+    @property
+    def is_cluster_leader(self):
+        """Retrieve status information from clustered OVSDB.
+
+        :returns: Whether target is cluster leader
+        :rtype: bool
+        """
+        return self.leader == 'self'
+
+
+def cluster_status(target, schema=None, use_ovs_appctl=False, rundir=None):
+    """Retrieve status information from clustered OVSDB.
+
+    :param target: Usually one of 'ovsdb-server', 'ovnnb_db', 'ovnsb_db', can
+                   also be full path to control socket.
+    :type target: str
+    :param schema: Database schema name, deduced from target if not provided
+    :type schema: Optional[str]
+    :param use_ovs_appctl: The ``ovn-appctl`` command appeared in OVN 20.03,
+                           set this to True to use ``ovs-appctl`` instead.
+    :type use_ovs_appctl: bool
+    :param rundir: Override path to sockets
+    :type rundir: Optional[str]
+    :returns: cluster status data object
+    :rtype: OVNClusterStatus
+    :raises: subprocess.CalledProcessError, KeyError, RuntimeError
+    """
+    schema_map = {
+        'ovnnb_db': 'OVN_Northbound',
+        'ovnsb_db': 'OVN_Southbound',
+    }
+    if schema and schema not in schema_map.keys():
+        raise RuntimeError('Unknown schema provided: "{}"'.format(schema))
+
+    status = {}
+    k = ''
+    for line in ovn_appctl(target,
+                           ('cluster/status', schema or schema_map[target]),
+                           rundir=rundir,
+                           use_ovs_appctl=use_ovs_appctl).splitlines():
+        if k and line.startswith(' '):
+            # there is no key which means this is a instance of a multi-line/
+            # multi-value item, populate the List which is already stored under
+            # the key.
+            if k == 'servers':
+                status[k].append(
+                    tuple(line.replace(')', '').lstrip().split()[0:4:3]))
+            else:
+                status[k].append(line.lstrip())
+        elif ':' in line:
+            # this is a line with a key
+            k, v = line.split(':', 1)
+            k = k.lower()
+            k = k.replace(' ', '_')
+            if v:
+                # this is a line with both key and value
+                if k in ('cluster_id', 'server_id',):
+                    v = v.replace('(', '')
+                    v = v.replace(')', '')
+                    status[k] = tuple(v.split())
+                else:
+                    status[k] = v.lstrip()
+            else:
+                # this is a line with only key which means a multi-line/
+                # multi-value item.  Store key as List which will be
+                # populated on subsequent iterations.
+                status[k] = []
+    return OVNClusterStatus(
+        status['name'],
+        uuid.UUID(status['cluster_id'][1]),
+        uuid.UUID(status['server_id'][1]),
+        status['address'],
+        status['status'],
+        status['role'],
+        int(status['term']),
+        status['leader'],
+        status['vote'],
+        int(status['election_timer']),
+        status['log'],
+        int(status['entries_not_yet_committed']),
+        int(status['entries_not_yet_applied']),
+        status['connections'],
+        status['servers'])
+
+
+def is_northd_active():
+    """Query `ovn-northd` for active status.
+
+    Note that the active status information for ovn-northd is available for
+    OVN 20.03 and onward.
+
+    :returns: True if local `ovn-northd` instance is active, False otherwise
+    :rtype: bool
+    """
+    try:
+        for line in ovn_appctl('ovn-northd', ('status',)).splitlines():
+            if line.startswith('Status:') and 'active' in line:
+                return True
+    except subprocess.CalledProcessError:
+        pass
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovsdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e50bc36333bde56674a82ad6c88e0d5de44ee07
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/ovsdb.py
@@ -0,0 +1,206 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import json
+import uuid
+
+from . import utils
+
+
+class SimpleOVSDB(object):
+    """Simple interface to OVSDB through the use of command line tools.
+
+    OVS and OVN is managed through a set of databases.  These databases have
+    similar command line tools to manage them.  We make use of the similarity
+    to provide a generic class that can be used to manage them.
+
+    The OpenvSwitch project does provide a Python API, but on the surface it
+    appears to be a bit too involved for our simple use case.
+
+    Examples:
+    sbdb = SimpleOVSDB('ovn-sbctl')
+    for chs in sbdb.chassis:
+        print(chs)
+
+    ovsdb = SimpleOVSDB('ovs-vsctl')
+    for br in ovsdb.bridge:
+        if br['name'] == 'br-test':
+            ovsdb.bridge.set(br['uuid'], 'external_ids:charm', 'managed')
+    """
+
+    # For validation we keep a complete map of currently known good tool and
+    # table combinations.  This requires maintenance down the line whenever
+    # upstream adds things that downstream wants, and the cost of maintaining
+    # that will most likely be lower then the cost of finding the needle in
+    # the haystack whenever downstream code misspells something.
+    _tool_table_map = {
+        'ovs-vsctl': (
+            'autoattach',
+            'bridge',
+            'ct_timeout_policy',
+            'ct_zone',
+            'controller',
+            'datapath',
+            'flow_sample_collector_set',
+            'flow_table',
+            'ipfix',
+            'interface',
+            'manager',
+            'mirror',
+            'netflow',
+            'open_vswitch',
+            'port',
+            'qos',
+            'queue',
+            'ssl',
+            'sflow',
+        ),
+        'ovn-nbctl': (
+            'acl',
+            'address_set',
+            'connection',
+            'dhcp_options',
+            'dns',
+            'forwarding_group',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'load_balancer',
+            'load_balancer_health_check',
+            'logical_router',
+            'logical_router_policy',
+            'logical_router_port',
+            'logical_router_static_route',
+            'logical_switch',
+            'logical_switch_port',
+            'meter',
+            'meter_band',
+            'nat',
+            'nb_global',
+            'port_group',
+            'qos',
+            'ssl',
+        ),
+        'ovn-sbctl': (
+            'address_set',
+            'chassis',
+            'connection',
+            'controller_event',
+            'dhcp_options',
+            'dhcpv6_options',
+            'dns',
+            'datapath_binding',
+            'encap',
+            'gateway_chassis',
+            'ha_chassis',
+            'ha_chassis_group',
+            'igmp_group',
+            'ip_multicast',
+            'logical_flow',
+            'mac_binding',
+            'meter',
+            'meter_band',
+            'multicast_group',
+            'port_binding',
+            'port_group',
+            'rbac_permission',
+            'rbac_role',
+            'sb_global',
+            'ssl',
+            'service_monitor',
+        ),
+    }
+
+    def __init__(self, tool):
+        """SimpleOVSDB constructor.
+
+        :param tool: Which tool with database commands to operate on.
+                     Usually one of `ovs-vsctl`, `ovn-nbctl`, `ovn-sbctl`
+        :type tool: str
+        """
+        if tool not in self._tool_table_map:
+            raise RuntimeError(
+                'tool must be one of "{}"'.format(self._tool_table_map.keys()))
+        self._tool = tool
+
+    def __getattr__(self, table):
+        if table not in self._tool_table_map[self._tool]:
+            raise AttributeError(
+                'table "{}" not known for use with "{}"'
+                .format(table, self._tool))
+        return self.Table(self._tool, table)
+
+    class Table(object):
+        """Methods to interact with contents of OVSDB tables.
+
+        NOTE: At the time of this writing ``find`` is the only command
+        line argument to OVSDB manipulating tools that actually supports
+        JSON output.
+        """
+
+        def __init__(self, tool, table):
+            """SimpleOVSDBTable constructor.
+
+            :param table: Which table to operate on
+            :type table: str
+            """
+            self._tool = tool
+            self._table = table
+
+        def _find_tbl(self, condition=None):
+            """Run and parse output of OVSDB `find` command.
+
+            :param condition: An optional RFC 7047 5.1 match condition
+            :type condition: Optional[str]
+            :returns: Dictionary with data
+            :rtype: Dict[str, any]
+            """
+            # When using json formatted output to OVS commands Internal OVSDB
+            # notation may occur that require further deserializing.
+            # Reference: https://tools.ietf.org/html/rfc7047#section-5.1
+            ovs_type_cb_map = {
+                'uuid': uuid.UUID,
+                # FIXME sets also appear to sometimes contain type/value tuples
+                'set': list,
+                'map': dict,
+            }
+            cmd = [self._tool, '-f', 'json', 'find', self._table]
+            if condition:
+                cmd.append(condition)
+            output = utils._run(*cmd)
+            data = json.loads(output)
+            for row in data['data']:
+                values = []
+                for col in row:
+                    if isinstance(col, list):
+                        f = ovs_type_cb_map.get(col[0], str)
+                        values.append(f(col[1]))
+                    else:
+                        values.append(col)
+                yield dict(zip(data['headings'], values))
+
+        def __iter__(self):
+            return self._find_tbl()
+
+        def clear(self, rec, col):
+            utils._run(self._tool, 'clear', self._table, rec, col)
+
+        def find(self, condition):
+            return self._find_tbl(condition=condition)
+
+        def remove(self, rec, col, value):
+            utils._run(self._tool, 'remove', self._table, rec, col, value)
+
+        def set(self, rec, col, value):
+            utils._run(self._tool, 'set', self._table, rec,
+                       '{}={}'.format(col, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..53c9b4ddab6d68d2478d4161e658c70e2caa6a74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ovs/utils.py
@@ -0,0 +1,26 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import subprocess
+
+
+def _run(*args):
+    """Run a process, check result, capture decoded output from STDOUT.
+
+    :param args: Command and arguments to run
+    :type args: Tuple[str, ...]
+    :returns: Information about the completed process
+    :rtype: str
+    :raises subprocess.CalledProcessError
+    """
+    return subprocess.check_output(args, universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ufw.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ufw.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9bf7c9df5576615e23225a7fdb6c11a28931ba4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/network/ufw.py
@@ -0,0 +1,386 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+This module contains helpers to add and remove ufw rules.
+
+Examples:
+
+- open SSH port for subnet 10.0.3.0/24:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.grant_access(src='10.0.3.0/24', dst='any', port='22', proto='tcp')
+
+- open service by name as defined in /etc/services:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('ssh', 'open')
+
+- close service by port number:
+
+  >>> from charmhelpers.contrib.network import ufw
+  >>> ufw.enable()
+  >>> ufw.service('4949', 'close')  # munin
+"""
+import os
+import re
+import subprocess
+
+from charmhelpers.core import hookenv
+from charmhelpers.core.kernel import modprobe, is_module_loaded
+
+__author__ = "Felipe Reyes <felipe.reyes@canonical.com>"
+
+
+class UFWError(Exception):
+    pass
+
+
+class UFWIPv6Error(UFWError):
+    pass
+
+
+def is_enabled():
+    """
+    Check if `ufw` is enabled
+
+    :returns: True if ufw is enabled
+    """
+    output = subprocess.check_output(['ufw', 'status'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Status: active\n', output, re.M)
+
+    return len(m) >= 1
+
+
+def is_ipv6_ok(soft_fail=False):
+    """
+    Check if IPv6 support is present and ip6tables functional
+
+    :param soft_fail: If set to True and IPv6 support is broken, then reports
+                      that the host doesn't have IPv6 support, otherwise a
+                      UFWIPv6Error exception is raised.
+    :returns: True if IPv6 is working, False otherwise
+    """
+
+    # do we have IPv6 in the machine?
+    if os.path.isdir('/proc/sys/net/ipv6'):
+        # is ip6tables kernel module loaded?
+        if not is_module_loaded('ip6_tables'):
+            # ip6tables support isn't complete, let's try to load it
+            try:
+                modprobe('ip6_tables')
+                # great, we can load the module
+                return True
+            except subprocess.CalledProcessError as ex:
+                hookenv.log("Couldn't load ip6_tables module: %s" % ex.output,
+                            level="WARN")
+                # we are in a world where ip6tables isn't working
+                if soft_fail:
+                    # so we inform that the machine doesn't have IPv6
+                    return False
+                else:
+                    raise UFWIPv6Error("IPv6 firewall support broken")
+        else:
+            # the module is present :)
+            return True
+
+    else:
+        # the system doesn't have IPv6
+        return False
+
+
+def disable_ipv6():
+    """
+    Disable ufw IPv6 support in /etc/default/ufw
+    """
+    exit_code = subprocess.call(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+    if exit_code == 0:
+        hookenv.log('IPv6 support in ufw disabled', level='INFO')
+    else:
+        hookenv.log("Couldn't disable IPv6 support in ufw", level="ERROR")
+        raise UFWError("Couldn't disable IPv6 support in ufw")
+
+
+def enable(soft_fail=False):
+    """
+    Enable ufw
+
+    :param soft_fail: If set to True silently disables IPv6 support in ufw,
+                      otherwise a UFWIPv6Error exception is raised when IP6
+                      support is broken.
+    :returns: True if ufw is successfully enabled
+    """
+    if is_enabled():
+        return True
+
+    if not is_ipv6_ok(soft_fail):
+        disable_ipv6()
+
+    output = subprocess.check_output(['ufw', 'enable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall is active and enabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be enabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw enabled", level='INFO')
+        return True
+
+
+def reload():
+    """
+    Reload ufw
+
+    :returns: True if ufw is successfully enabled
+    """
+    output = subprocess.check_output(['ufw', 'reload'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall('^Firewall reloaded\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be reloaded", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw reloaded", level='INFO')
+        return True
+
+
+def disable():
+    """
+    Disable ufw
+
+    :returns: True if ufw is successfully disabled
+    """
+    if not is_enabled():
+        return True
+
+    output = subprocess.check_output(['ufw', 'disable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+
+    m = re.findall(r'^Firewall stopped and disabled on system startup\n',
+                   output, re.M)
+    hookenv.log(output, level='DEBUG')
+
+    if len(m) == 0:
+        hookenv.log("ufw couldn't be disabled", level='WARN')
+        return False
+    else:
+        hookenv.log("ufw disabled", level='INFO')
+        return True
+
+
+def default_policy(policy='deny', direction='incoming'):
+    """
+    Changes the default policy for traffic `direction`
+
+    :param policy: allow, deny or reject
+    :param direction: traffic direction, possible values: incoming, outgoing,
+                      routed
+    """
+    if policy not in ['allow', 'deny', 'reject']:
+        raise UFWError(('Unknown policy %s, valid values: '
+                        'allow, deny, reject') % policy)
+
+    if direction not in ['incoming', 'outgoing', 'routed']:
+        raise UFWError(('Unknown direction %s, valid values: '
+                        'incoming, outgoing, routed') % direction)
+
+    output = subprocess.check_output(['ufw', 'default', policy, direction],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+    hookenv.log(output, level='DEBUG')
+
+    m = re.findall("^Default %s policy changed to '%s'\n" % (direction,
+                                                             policy),
+                   output, re.M)
+    if len(m) == 0:
+        hookenv.log("ufw couldn't change the default policy to %s for %s"
+                    % (policy, direction), level='WARN')
+        return False
+    else:
+        hookenv.log("ufw default policy for %s changed to %s"
+                    % (direction, policy), level='INFO')
+        return True
+
+
+def modify_access(src, dst='any', port=None, proto=None, action='allow',
+                  index=None, prepend=False, comment=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :type src: Optional[str]
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :type dst: Optional[str]
+    :param port: destiny port
+    :type port: Optional[int]
+    :param proto: protocol (tcp or udp)
+    :type proto: Optional[str]
+    :param action: `allow` or `delete`
+    :type action: str
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    :type index: Optional[int]
+    :param prepend: Whether to insert the rule before all other rules matching
+                    the rule's IP type.
+    :type prepend: bool
+    :param comment: Create the rule with a comment
+    :type comment: Optional[str]
+    """
+    if not is_enabled():
+        hookenv.log('ufw is disabled, skipping modify_access()', level='WARN')
+        return
+
+    if action == 'delete':
+        if index is not None:
+            cmd = ['ufw', '--force', 'delete', str(index)]
+        else:
+            cmd = ['ufw', 'delete', 'allow']
+    elif index is not None:
+        cmd = ['ufw', 'insert', str(index), action]
+    elif prepend:
+        cmd = ['ufw', 'prepend', action]
+    else:
+        cmd = ['ufw', action]
+
+    if src is not None:
+        cmd += ['from', src]
+
+    if dst is not None:
+        cmd += ['to', dst]
+
+    if port is not None:
+        cmd += ['port', str(port)]
+
+    if proto is not None:
+        cmd += ['proto', proto]
+
+    if comment:
+        cmd.extend(['comment', comment])
+
+    hookenv.log('ufw {}: {}'.format(action, ' '.join(cmd)), level='DEBUG')
+    p = subprocess.Popen(cmd, stdout=subprocess.PIPE)
+    (stdout, stderr) = p.communicate()
+
+    hookenv.log(stdout, level='INFO')
+
+    if p.returncode != 0:
+        hookenv.log(stderr, level='ERROR')
+        hookenv.log('Error running: {}, exit code: {}'.format(' '.join(cmd),
+                                                              p.returncode),
+                    level='ERROR')
+
+
+def grant_access(src, dst='any', port=None, proto=None, index=None):
+    """
+    Grant access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    :param index: if different from None the rule is inserted at the given
+                  `index`.
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='allow',
+                         index=index)
+
+
+def revoke_access(src, dst='any', port=None, proto=None):
+    """
+    Revoke access to an address or subnet
+
+    :param src: address (e.g. 192.168.1.234) or subnet
+                (e.g. 192.168.1.0/24).
+    :param dst: destiny of the connection, if the machine has multiple IPs and
+                connections to only one of those have to accepted this is the
+                field has to be set.
+    :param port: destiny port
+    :param proto: protocol (tcp or udp)
+    """
+    return modify_access(src, dst=dst, port=port, proto=proto, action='delete')
+
+
+def service(name, action):
+    """
+    Open/close access to a service
+
+    :param name: could be a service name defined in `/etc/services` or a port
+                 number.
+    :param action: `open` or `close`
+    """
+    if action == 'open':
+        subprocess.check_output(['ufw', 'allow', str(name)],
+                                universal_newlines=True)
+    elif action == 'close':
+        subprocess.check_output(['ufw', 'delete', 'allow', str(name)],
+                                universal_newlines=True)
+    else:
+        raise UFWError(("'{}' not supported, use 'allow' "
+                        "or 'delete'").format(action))
+
+
+def status():
+    """Retrieve firewall rules as represented by UFW.
+
+    :returns: Tuples with rule number and data
+        (1, {'to': '', 'action':, 'from':, '', ipv6: True, 'comment': ''})
+    :rtype: Iterator[Tuple[int, Dict[str, Union[bool, str]]]]
+    """
+    cp = subprocess.check_output(('ufw', 'status', 'numbered',),
+                                 stderr=subprocess.STDOUT,
+                                 universal_newlines=True)
+    for line in cp.splitlines():
+        if not line.startswith('['):
+            continue
+        ipv6 = True if '(v6)' in line else False
+        line = line.replace('(v6)', '')
+        line = line.replace('[', '')
+        line = line.replace(']', '')
+        line = line.replace('Anywhere', 'any')
+        row = line.split()
+        yield (int(row[0]), {
+            'to': row[1],
+            'action': ' '.join(row[2:4]).lower(),
+            'from': row[4],
+            'ipv6': ipv6,
+            'comment': row[6] if len(row) > 5 and row[5] == '#' else '',
+        })
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/alternatives.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/alternatives.py
new file mode 100644
index 0000000000000000000000000000000000000000..547de09c6d818772191b519618fa32b08b0e6eff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/alternatives.py
@@ -0,0 +1,44 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+''' Helper for managing alternatives for file conflict resolution '''
+
+import subprocess
+import shutil
+import os
+
+
+def install_alternative(name, target, source, priority=50):
+    ''' Install alternative configuration '''
+    if (os.path.exists(target) and not os.path.islink(target)):
+        # Move existing file/directory away before installing
+        shutil.move(target, '{}.bak'.format(target))
+    cmd = [
+        'update-alternatives', '--force', '--install',
+        target, name, source, str(priority)
+    ]
+    subprocess.check_call(cmd)
+
+
+def remove_alternative(name, source):
+    """Remove an installed alternative configuration file
+
+    :param name: string name of the alternative to remove
+    :param source: string full path to alternative to remove
+    """
+    cmd = [
+        'update-alternatives', '--remove',
+        name, source
+    ]
+    subprocess.check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/deployment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/deployment.py
new file mode 100644
index 0000000000000000000000000000000000000000..dd3aebe97dd04bf42a2c4ee7c7b7b83b1917a678
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/deployment.py
@@ -0,0 +1,384 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import logging
+import os
+import re
+import sys
+import six
+from collections import OrderedDict
+from charmhelpers.contrib.amulet.deployment import (
+    AmuletDeployment
+)
+from charmhelpers.contrib.openstack.amulet.utils import (
+    OPENSTACK_RELEASES_PAIRS
+)
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+
+class OpenStackAmuletDeployment(AmuletDeployment):
+    """OpenStack amulet deployment.
+
+       This class inherits from AmuletDeployment and has additional support
+       that is specifically for use by OpenStack charms.
+       """
+
+    def __init__(self, series=None, openstack=None, source=None,
+                 stable=True, log_level=DEBUG):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletDeployment, self).__init__(series)
+        self.log = self.get_logger(level=log_level)
+        self.log.info('OpenStackAmuletDeployment:  init')
+        self.openstack = openstack
+        self.source = source
+        self.stable = stable
+
+    def get_logger(self, name="deployment-logger", level=logging.DEBUG):
+        """Get a logger object that will log to stdout."""
+        log = logging
+        logger = log.getLogger(name)
+        fmt = log.Formatter("%(asctime)s %(funcName)s "
+                            "%(levelname)s: %(message)s")
+
+        handler = log.StreamHandler(stream=sys.stdout)
+        handler.setLevel(level)
+        handler.setFormatter(fmt)
+
+        logger.addHandler(handler)
+        logger.setLevel(level)
+
+        return logger
+
+    def _determine_branch_locations(self, other_services):
+        """Determine the branch locations for the other services.
+
+           Determine if the local branch being tested is derived from its
+           stable or next (dev) branch, and based on this, use the corresonding
+           stable or next branches for the other_services."""
+
+        self.log.info('OpenStackAmuletDeployment:  determine branch locations')
+
+        # Charms outside the ~openstack-charmers
+        base_charms = {
+            'mysql': ['trusty'],
+            'mongodb': ['trusty'],
+            'nrpe': ['trusty', 'xenial'],
+        }
+
+        for svc in other_services:
+            # If a location has been explicitly set, use it
+            if svc.get('location'):
+                continue
+            if svc['name'] in base_charms:
+                # NOTE: not all charms have support for all series we
+                #       want/need to test against, so fix to most recent
+                #       that each base charm supports
+                target_series = self.series
+                if self.series not in base_charms[svc['name']]:
+                    target_series = base_charms[svc['name']][-1]
+                svc['location'] = 'cs:{}/{}'.format(target_series,
+                                                    svc['name'])
+            elif self.stable:
+                svc['location'] = 'cs:{}/{}'.format(self.series,
+                                                    svc['name'])
+            else:
+                svc['location'] = 'cs:~openstack-charmers-next/{}/{}'.format(
+                    self.series,
+                    svc['name']
+                )
+
+        return other_services
+
+    def _add_services(self, this_service, other_services, use_source=None,
+                      no_origin=None):
+        """Add services to the deployment and optionally set
+        openstack-origin/source.
+
+        :param this_service dict: Service dictionary describing the service
+                                  whose amulet tests are being run
+        :param other_services dict: List of service dictionaries describing
+                                    the services needed to support the target
+                                    service
+        :param use_source list: List of services which use the 'source' config
+                                option rather than 'openstack-origin'
+        :param no_origin list: List of services which do not support setting
+                               the Cloud Archive.
+        Service Dict:
+            {
+                'name': str charm-name,
+                'units': int number of units,
+                'constraints': dict of juju constraints,
+                'location': str location of charm,
+            }
+        eg
+        this_service = {
+            'name': 'openvswitch-odl',
+            'constraints': {'mem': '8G'},
+        }
+        other_services = [
+            {
+                'name': 'nova-compute',
+                'units': 2,
+                'constraints': {'mem': '4G'},
+                'location': cs:~bob/xenial/nova-compute
+            },
+            {
+                'name': 'mysql',
+                'constraints': {'mem': '2G'},
+            },
+            {'neutron-api-odl'}]
+        use_source = ['mysql']
+        no_origin = ['neutron-api-odl']
+        """
+        self.log.info('OpenStackAmuletDeployment:  adding services')
+
+        other_services = self._determine_branch_locations(other_services)
+
+        super(OpenStackAmuletDeployment, self)._add_services(this_service,
+                                                             other_services)
+
+        services = other_services
+        services.append(this_service)
+
+        use_source = use_source or []
+        no_origin = no_origin or []
+
+        # Charms which should use the source config option
+        use_source = list(set(
+            use_source + ['mysql', 'mongodb', 'rabbitmq-server', 'ceph',
+                          'ceph-osd', 'ceph-radosgw', 'ceph-mon',
+                          'ceph-proxy', 'percona-cluster', 'lxd']))
+
+        # Charms which can not use openstack-origin, ie. many subordinates
+        no_origin = list(set(
+            no_origin + ['cinder-ceph', 'hacluster', 'neutron-openvswitch',
+                         'nrpe', 'openvswitch-odl', 'neutron-api-odl',
+                         'odl-controller', 'cinder-backup', 'nexentaedge-data',
+                         'nexentaedge-iscsi-gw', 'nexentaedge-swift-gw',
+                         'cinder-nexentaedge', 'nexentaedge-mgmt',
+                         'ceilometer-agent']))
+
+        if self.openstack:
+            for svc in services:
+                if svc['name'] not in use_source + no_origin:
+                    config = {'openstack-origin': self.openstack}
+                    self.d.configure(svc['name'], config)
+
+        if self.source:
+            for svc in services:
+                if svc['name'] in use_source and svc['name'] not in no_origin:
+                    config = {'source': self.source}
+                    self.d.configure(svc['name'], config)
+
+    def _configure_services(self, configs):
+        """Configure all of the services."""
+        self.log.info('OpenStackAmuletDeployment:  configure services')
+        for service, config in six.iteritems(configs):
+            self.d.configure(service, config)
+
+    def _auto_wait_for_status(self, message=None, exclude_services=None,
+                              include_only=None, timeout=None):
+        """Wait for all units to have a specific extended status, except
+        for any defined as excluded.  Unless specified via message, any
+        status containing any case of 'ready' will be considered a match.
+
+        Examples of message usage:
+
+          Wait for all unit status to CONTAIN any case of 'ready' or 'ok':
+              message = re.compile('.*ready.*|.*ok.*', re.IGNORECASE)
+
+          Wait for all units to reach this status (exact match):
+              message = re.compile('^Unit is ready and clustered$')
+
+          Wait for all units to reach any one of these (exact match):
+              message = re.compile('Unit is ready|OK|Ready')
+
+          Wait for at least one unit to reach this status (exact match):
+              message = {'ready'}
+
+        See Amulet's sentry.wait_for_messages() for message usage detail.
+        https://github.com/juju/amulet/blob/master/amulet/sentry.py
+
+        :param message: Expected status match
+        :param exclude_services: List of juju service names to ignore,
+            not to be used in conjuction with include_only.
+        :param include_only: List of juju service names to exclusively check,
+            not to be used in conjuction with exclude_services.
+        :param timeout: Maximum time in seconds to wait for status match
+        :returns: None.  Raises if timeout is hit.
+        """
+        if not timeout:
+            timeout = int(os.environ.get('AMULET_SETUP_TIMEOUT', 1800))
+        self.log.info('Waiting for extended status on units for {}s...'
+                      ''.format(timeout))
+
+        all_services = self.d.services.keys()
+
+        if exclude_services and include_only:
+            raise ValueError('exclude_services can not be used '
+                             'with include_only')
+
+        if message:
+            if isinstance(message, re._pattern_type):
+                match = message.pattern
+            else:
+                match = message
+
+            self.log.debug('Custom extended status wait match: '
+                           '{}'.format(match))
+        else:
+            self.log.debug('Default extended status wait match:  contains '
+                           'READY (case-insensitive)')
+            message = re.compile('.*ready.*', re.IGNORECASE)
+
+        if exclude_services:
+            self.log.debug('Excluding services from extended status match: '
+                           '{}'.format(exclude_services))
+        else:
+            exclude_services = []
+
+        if include_only:
+            services = include_only
+        else:
+            services = list(set(all_services) - set(exclude_services))
+
+        self.log.debug('Waiting up to {}s for extended status on services: '
+                       '{}'.format(timeout, services))
+        service_messages = {service: message for service in services}
+
+        # Check for idleness
+        self.d.sentry.wait(timeout=timeout)
+        # Check for error states and bail early
+        self.d.sentry.wait_for_status(self.d.juju_env, services, timeout=timeout)
+        # Check for ready messages
+        self.d.sentry.wait_for_messages(service_messages, timeout=timeout)
+
+        self.log.info('OK')
+
+    def _get_openstack_release(self):
+        """Get openstack release.
+
+           Return an integer representing the enum value of the openstack
+           release.
+           """
+        # Must be ordered by OpenStack release (not by Ubuntu release):
+        for i, os_pair in enumerate(OPENSTACK_RELEASES_PAIRS):
+            setattr(self, os_pair, i)
+
+        releases = {
+            ('trusty', None): self.trusty_icehouse,
+            ('trusty', 'cloud:trusty-kilo'): self.trusty_kilo,
+            ('trusty', 'cloud:trusty-liberty'): self.trusty_liberty,
+            ('trusty', 'cloud:trusty-mitaka'): self.trusty_mitaka,
+            ('xenial', None): self.xenial_mitaka,
+            ('xenial', 'cloud:xenial-newton'): self.xenial_newton,
+            ('xenial', 'cloud:xenial-ocata'): self.xenial_ocata,
+            ('xenial', 'cloud:xenial-pike'): self.xenial_pike,
+            ('xenial', 'cloud:xenial-queens'): self.xenial_queens,
+            ('yakkety', None): self.yakkety_newton,
+            ('zesty', None): self.zesty_ocata,
+            ('artful', None): self.artful_pike,
+            ('bionic', None): self.bionic_queens,
+            ('bionic', 'cloud:bionic-rocky'): self.bionic_rocky,
+            ('bionic', 'cloud:bionic-stein'): self.bionic_stein,
+            ('bionic', 'cloud:bionic-train'): self.bionic_train,
+            ('bionic', 'cloud:bionic-ussuri'): self.bionic_ussuri,
+            ('cosmic', None): self.cosmic_rocky,
+            ('disco', None): self.disco_stein,
+            ('eoan', None): self.eoan_train,
+            ('focal', None): self.focal_ussuri,
+        }
+        return releases[(self.series, self.openstack)]
+
+    def _get_openstack_release_string(self):
+        """Get openstack release string.
+
+           Return a string representing the openstack release.
+           """
+        releases = OrderedDict([
+            ('trusty', 'icehouse'),
+            ('xenial', 'mitaka'),
+            ('yakkety', 'newton'),
+            ('zesty', 'ocata'),
+            ('artful', 'pike'),
+            ('bionic', 'queens'),
+            ('cosmic', 'rocky'),
+            ('disco', 'stein'),
+            ('eoan', 'train'),
+            ('focal', 'ussuri'),
+        ])
+        if self.openstack:
+            os_origin = self.openstack.split(':')[1]
+            return os_origin.split('%s-' % self.series)[1].split('/')[0]
+        else:
+            return releases[self.series]
+
+    def get_percona_service_entry(self, memory_constraint=None):
+        """Return a amulet service entry for percona cluster.
+
+        :param memory_constraint: Override the default memory constraint
+                                  in the service entry.
+        :type memory_constraint: str
+        :returns: Amulet service entry.
+        :rtype: dict
+        """
+        memory_constraint = memory_constraint or '3072M'
+        svc_entry = {
+            'name': 'percona-cluster',
+            'constraints': {'mem': memory_constraint}}
+        if self._get_openstack_release() <= self.trusty_mitaka:
+            svc_entry['location'] = 'cs:trusty/percona-cluster'
+        return svc_entry
+
+    def get_ceph_expected_pools(self, radosgw=False):
+        """Return a list of expected ceph pools in a ceph + cinder + glance
+        test scenario, based on OpenStack release and whether ceph radosgw
+        is flagged as present or not."""
+
+        if self._get_openstack_release() == self.trusty_icehouse:
+            # Icehouse
+            pools = [
+                'data',
+                'metadata',
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        elif (self.trusty_kilo <= self._get_openstack_release() <=
+              self.zesty_ocata):
+            # Kilo through Ocata
+            pools = [
+                'rbd',
+                'cinder-ceph',
+                'glance'
+            ]
+        else:
+            # Pike and later
+            pools = [
+                'cinder-ceph',
+                'glance'
+            ]
+
+        if radosgw:
+            pools.extend([
+                '.rgw.root',
+                '.rgw.control',
+                '.rgw',
+                '.rgw.gc',
+                '.users.uid'
+            ])
+
+        return pools
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..14864198926b82afe382d07263034b020ad43c09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/amulet/utils.py
@@ -0,0 +1,1593 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import amulet
+import json
+import logging
+import os
+import re
+import six
+import time
+import urllib
+import urlparse
+
+import cinderclient.v1.client as cinder_client
+import cinderclient.v2.client as cinder_clientv2
+import glanceclient.v1 as glance_client
+import glanceclient.v2 as glance_clientv2
+import heatclient.v1.client as heat_client
+from keystoneclient.v2_0 import client as keystone_client
+from keystoneauth1.identity import (
+    v3,
+    v2,
+)
+from keystoneauth1 import session as keystone_session
+from keystoneclient.v3 import client as keystone_client_v3
+from novaclient import exceptions
+
+import novaclient.client as nova_client
+import novaclient
+import pika
+import swiftclient
+
+from charmhelpers.core.decorators import retry_on_exception
+from charmhelpers.contrib.amulet.utils import (
+    AmuletUtils
+)
+from charmhelpers.core.host import CompareHostReleases
+
+DEBUG = logging.DEBUG
+ERROR = logging.ERROR
+
+NOVA_CLIENT_VERSION = "2"
+
+OPENSTACK_RELEASES_PAIRS = [
+    'trusty_icehouse', 'trusty_kilo', 'trusty_liberty',
+    'trusty_mitaka', 'xenial_mitaka',
+    'xenial_newton', 'yakkety_newton',
+    'xenial_ocata', 'zesty_ocata',
+    'xenial_pike', 'artful_pike',
+    'xenial_queens', 'bionic_queens',
+    'bionic_rocky', 'cosmic_rocky',
+    'bionic_stein', 'disco_stein',
+    'bionic_train', 'eoan_train',
+    'bionic_ussuri', 'focal_ussuri',
+]
+
+
+class OpenStackAmuletUtils(AmuletUtils):
+    """OpenStack amulet utilities.
+
+       This class inherits from AmuletUtils and has additional support
+       that is specifically for use by OpenStack charm tests.
+       """
+
+    def __init__(self, log_level=ERROR):
+        """Initialize the deployment environment."""
+        super(OpenStackAmuletUtils, self).__init__(log_level)
+
+    def validate_endpoint_data(self, endpoints, admin_port, internal_port,
+                               public_port, expected, openstack_release=None):
+        """Validate endpoint data. Pick the correct validator based on
+           OpenStack release. Expected data should be in the v2 format:
+           {
+               'id': id,
+               'region': region,
+               'adminurl': adminurl,
+               'internalurl': internalurl,
+               'publicurl': publicurl,
+               'service_id': service_id}
+
+           """
+        validation_function = self.validate_v2_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_endpoint_data
+            expected = {
+                'id': expected['id'],
+                'region': expected['region'],
+                'region_id': 'RegionOne',
+                'url': self.valid_url,
+                'interface': self.not_null,
+                'service_id': expected['service_id']}
+        return validation_function(endpoints, admin_port, internal_port,
+                                   public_port, expected)
+
+    def validate_v2_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected):
+        """Validate endpoint data.
+
+           Validate actual endpoint data vs expected endpoint data. The ports
+           are used to find the matching endpoint.
+           """
+        self.log.debug('Validating endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = False
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if (admin_port in ep.adminurl and
+                    internal_port in ep.internalurl and
+                    public_port in ep.publicurl):
+                found = True
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'adminurl': ep.adminurl,
+                          'internalurl': ep.internalurl,
+                          'publicurl': ep.publicurl,
+                          'service_id': ep.service_id}
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if not found:
+            return 'endpoint not found'
+
+    def validate_v3_endpoint_data(self, endpoints, admin_port, internal_port,
+                                  public_port, expected, expected_num_eps=3):
+        """Validate keystone v3 endpoint data.
+
+        Validate the v3 endpoint data which has changed from v2.  The
+        ports are used to find the matching endpoint.
+
+        The new v3 endpoint data looks like:
+
+        [<Endpoint enabled=True,
+                   id=0432655fc2f74d1e9fa17bdaa6f6e60b,
+                   interface=admin,
+                   links={u'self': u'<RESTful URL of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=17f842a0dc084b928e476fafe67e4095,
+                   url=http://10.5.6.5:9312>,
+         <Endpoint enabled=True,
+                   id=6536cb6cb92f4f41bf22b079935c7707,
+                   interface=admin,
+                   links={u'self': u'<RESTful url of this endpoint>'},
+                   region=RegionOne,
+                   region_id=RegionOne,
+                   service_id=72fc8736fb41435e8b3584205bb2cfa3,
+                   url=http://10.5.6.6:35357/v3>,
+                   ... ]
+        """
+        self.log.debug('Validating v3 endpoint data...')
+        self.log.debug('actual: {}'.format(repr(endpoints)))
+        found = []
+        for ep in endpoints:
+            self.log.debug('endpoint: {}'.format(repr(ep)))
+            if ((admin_port in ep.url and ep.interface == 'admin') or
+                    (internal_port in ep.url and ep.interface == 'internal') or
+                    (public_port in ep.url and ep.interface == 'public')):
+                found.append(ep.interface)
+                # note we ignore the links member.
+                actual = {'id': ep.id,
+                          'region': ep.region,
+                          'region_id': ep.region_id,
+                          'interface': self.not_null,
+                          'url': ep.url,
+                          'service_id': ep.service_id, }
+                ret = self._validate_dict_data(expected, actual)
+                if ret:
+                    return 'unexpected endpoint data - {}'.format(ret)
+
+        if len(found) != expected_num_eps:
+            return 'Unexpected number of endpoints found'
+
+    def convert_svc_catalog_endpoint_data_to_v3(self, ep_data):
+        """Convert v2 endpoint data into v3.
+
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+          """
+        self.log.warn("Endpoint ID and Region ID validation is limited to not "
+                      "null checks after v2 to v3 conversion")
+        for svc in ep_data.keys():
+            assert len(ep_data[svc]) == 1, "Unknown data format"
+            svc_ep_data = ep_data[svc][0]
+            ep_data[svc] = [
+                {
+                    'url': svc_ep_data['adminURL'],
+                    'interface': 'admin',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['publicURL'],
+                    'interface': 'public',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null},
+                {
+                    'url': svc_ep_data['internalURL'],
+                    'interface': 'internal',
+                    'region': svc_ep_data['region'],
+                    'region_id': self.not_null,
+                    'id': self.not_null}]
+        return ep_data
+
+    def validate_svc_catalog_endpoint_data(self, expected, actual,
+                                           openstack_release=None):
+        """Validate service catalog endpoint data. Pick the correct validator
+           for the OpenStack version. Expected data should be in the v2 format:
+           {
+               'service_name1': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+               'service_name2': [
+                   {
+                       'adminURL': adminURL,
+                       'id': id,
+                       'region': region.
+                       'publicURL': publicURL,
+                       'internalURL': internalURL
+                   }],
+           }
+
+           """
+        validation_function = self.validate_v2_svc_catalog_endpoint_data
+        xenial_queens = OPENSTACK_RELEASES_PAIRS.index('xenial_queens')
+        if openstack_release and openstack_release >= xenial_queens:
+            validation_function = self.validate_v3_svc_catalog_endpoint_data
+            expected = self.convert_svc_catalog_endpoint_data_to_v3(expected)
+        return validation_function(expected, actual)
+
+    def validate_v2_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate service catalog endpoint data.
+
+           Validate a list of actual service catalog endpoints vs a list of
+           expected service catalog endpoints.
+           """
+        self.log.debug('Validating service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                ret = self._validate_dict_data(expected[k][0], actual[k][0])
+                if ret:
+                    return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_v3_svc_catalog_endpoint_data(self, expected, actual):
+        """Validate the keystone v3 catalog endpoint data.
+
+        Validate a list of dictinaries that make up the keystone v3 service
+        catalogue.
+
+        It is in the form of:
+
+
+        {u'identity': [{u'id': u'48346b01c6804b298cdd7349aadb732e',
+                        u'interface': u'admin',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:35357/v3'},
+                       {u'id': u'8414f7352a4b47a69fddd9dbd2aef5cf',
+                        u'interface': u'public',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'},
+                       {u'id': u'd5ca31440cc24ee1bf625e2996fb6a5b',
+                        u'interface': u'internal',
+                        u'region': u'RegionOne',
+                        u'region_id': u'RegionOne',
+                        u'url': u'http://10.5.5.224:5000/v3'}],
+         u'key-manager': [{u'id': u'68ebc17df0b045fcb8a8a433ebea9e62',
+                           u'interface': u'public',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'9cdfe2a893c34afd8f504eb218cd2f9d',
+                           u'interface': u'internal',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9311'},
+                          {u'id': u'f629388955bc407f8b11d8b7ca168086',
+                           u'interface': u'admin',
+                           u'region': u'RegionOne',
+                           u'region_id': u'RegionOne',
+                           u'url': u'http://10.5.5.223:9312'}]}
+
+        Note, that an added complication is that the order of admin, public,
+        internal against 'interface' in each region.
+
+        Thus, the function sorts the expected and actual lists using the
+        interface key as a sort key, prior to the comparison.
+        """
+        self.log.debug('Validating v3 service catalog endpoint data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for k, v in six.iteritems(expected):
+            if k in actual:
+                l_expected = sorted(v, key=lambda x: x['interface'])
+                l_actual = sorted(actual[k], key=lambda x: x['interface'])
+                if len(l_actual) != len(l_expected):
+                    return ("endpoint {} has differing number of interfaces "
+                            " - expected({}), actual({})"
+                            .format(k, len(l_expected), len(l_actual)))
+                for i_expected, i_actual in zip(l_expected, l_actual):
+                    self.log.debug("checking interface {}"
+                                   .format(i_expected['interface']))
+                    ret = self._validate_dict_data(i_expected, i_actual)
+                    if ret:
+                        return self.endpoint_error(k, ret)
+            else:
+                return "endpoint {} does not exist".format(k)
+        return ret
+
+    def validate_tenant_data(self, expected, actual):
+        """Validate tenant data.
+
+           Validate a list of actual tenant data vs list of expected tenant
+           data.
+           """
+        self.log.debug('Validating tenant data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'enabled': act.enabled, 'description': act.description,
+                     'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected tenant data - {}".format(ret)
+            if not found:
+                return "tenant {} does not exist".format(e['name'])
+        return ret
+
+    def validate_role_data(self, expected, actual):
+        """Validate role data.
+
+           Validate a list of actual role data vs a list of expected role
+           data.
+           """
+        self.log.debug('Validating role data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                a = {'name': act.name, 'id': act.id}
+                if e['name'] == a['name']:
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected role data - {}".format(ret)
+            if not found:
+                return "role {} does not exist".format(e['name'])
+        return ret
+
+    def validate_user_data(self, expected, actual, api_version=None):
+        """Validate user data.
+
+           Validate a list of actual user data vs a list of expected user
+           data.
+           """
+        self.log.debug('Validating user data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        for e in expected:
+            found = False
+            for act in actual:
+                if e['name'] == act.name:
+                    a = {'enabled': act.enabled, 'name': act.name,
+                         'email': act.email, 'id': act.id}
+                    if api_version == 3:
+                        a['default_project_id'] = getattr(act,
+                                                          'default_project_id',
+                                                          'none')
+                    else:
+                        a['tenantId'] = act.tenantId
+                    found = True
+                    ret = self._validate_dict_data(e, a)
+                    if ret:
+                        return "unexpected user data - {}".format(ret)
+            if not found:
+                return "user {} does not exist".format(e['name'])
+        return ret
+
+    def validate_flavor_data(self, expected, actual):
+        """Validate flavor data.
+
+           Validate a list of actual flavors vs a list of expected flavors.
+           """
+        self.log.debug('Validating flavor data...')
+        self.log.debug('actual: {}'.format(repr(actual)))
+        act = [a.name for a in actual]
+        return self._validate_list_data(expected, act)
+
+    def tenant_exists(self, keystone, tenant):
+        """Return True if tenant exists."""
+        self.log.debug('Checking if tenant exists ({})...'.format(tenant))
+        return tenant in [t.name for t in keystone.tenants.list()]
+
+    @retry_on_exception(num_retries=5, base_delay=1)
+    def keystone_wait_for_propagation(self, sentry_relation_pairs,
+                                      api_version):
+        """Iterate over list of sentry and relation tuples and verify that
+           api_version has the expected value.
+
+        :param sentry_relation_pairs: list of sentry, relation name tuples used
+                                      for monitoring propagation of relation
+                                      data
+        :param api_version: api_version to expect in relation data
+        :returns: None if successful.  Raise on error.
+        """
+        for (sentry, relation_name) in sentry_relation_pairs:
+            rel = sentry.relation('identity-service',
+                                  relation_name)
+            self.log.debug('keystone relation data: {}'.format(rel))
+            if rel.get('api_version') != str(api_version):
+                raise Exception("api_version not propagated through relation"
+                                " data yet ('{}' != '{}')."
+                                "".format(rel.get('api_version'), api_version))
+
+    def keystone_configure_api_version(self, sentry_relation_pairs, deployment,
+                                       api_version):
+        """Configure preferred-api-version of keystone in deployment and
+           monitor provided list of relation objects for propagation
+           before returning to caller.
+
+        :param sentry_relation_pairs: list of sentry, relation tuples used for
+                                      monitoring propagation of relation data
+        :param deployment: deployment to configure
+        :param api_version: value preferred-api-version will be set to
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug("Setting keystone preferred-api-version: '{}'"
+                       "".format(api_version))
+
+        config = {'preferred-api-version': api_version}
+        deployment.d.configure('keystone', config)
+        deployment._auto_wait_for_status()
+        self.keystone_wait_for_propagation(sentry_relation_pairs, api_version)
+
+    def authenticate_cinder_admin(self, keystone, api_version=2):
+        """Authenticates admin user with cinder."""
+        self.log.debug('Authenticating cinder admin...')
+        _clients = {
+            1: cinder_client.Client,
+            2: cinder_clientv2.Client}
+        return _clients[api_version](session=keystone.session)
+
+    def authenticate_keystone(self, keystone_ip, username, password,
+                              api_version=False, admin_port=False,
+                              user_domain_name=None, domain_name=None,
+                              project_domain_name=None, project_name=None):
+        """Authenticate with Keystone"""
+        self.log.debug('Authenticating with keystone...')
+        if not api_version:
+            api_version = 2
+        sess, auth = self.get_keystone_session(
+            keystone_ip=keystone_ip,
+            username=username,
+            password=password,
+            api_version=api_version,
+            admin_port=admin_port,
+            user_domain_name=user_domain_name,
+            domain_name=domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name
+        )
+        if api_version == 2:
+            client = keystone_client.Client(session=sess)
+        else:
+            client = keystone_client_v3.Client(session=sess)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(sess)
+        return client
+
+    def get_keystone_session(self, keystone_ip, username, password,
+                             api_version=False, admin_port=False,
+                             user_domain_name=None, domain_name=None,
+                             project_domain_name=None, project_name=None):
+        """Return a keystone session object"""
+        ep = self.get_keystone_endpoint(keystone_ip,
+                                        api_version=api_version,
+                                        admin_port=admin_port)
+        if api_version == 2:
+            auth = v2.Password(
+                username=username,
+                password=password,
+                tenant_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        else:
+            auth = v3.Password(
+                user_domain_name=user_domain_name,
+                username=username,
+                password=password,
+                domain_name=domain_name,
+                project_domain_name=project_domain_name,
+                project_name=project_name,
+                auth_url=ep
+            )
+            sess = keystone_session.Session(auth=auth)
+        return (sess, auth)
+
+    def get_keystone_endpoint(self, keystone_ip, api_version=None,
+                              admin_port=False):
+        """Return keystone endpoint"""
+        port = 5000
+        if admin_port:
+            port = 35357
+        base_ep = "http://{}:{}".format(keystone_ip.strip().decode('utf-8'),
+                                        port)
+        if api_version == 2:
+            ep = base_ep + "/v2.0"
+        else:
+            ep = base_ep + "/v3"
+        return ep
+
+    def get_default_keystone_session(self, keystone_sentry,
+                                     openstack_release=None, api_version=2):
+        """Return a keystone session object and client object assuming standard
+           default settings
+
+           Example call in amulet tests:
+               self.keystone_session, self.keystone = u.get_default_keystone_session(
+                   self.keystone_sentry,
+                   openstack_release=self._get_openstack_release())
+
+           The session can then be used to auth other clients:
+               neutronclient.Client(session=session)
+               aodh_client.Client(session=session)
+               eyc
+        """
+        self.log.debug('Authenticating keystone admin...')
+        # 11 => xenial_queens
+        if api_version == 3 or (openstack_release and openstack_release >= 11):
+            client_class = keystone_client_v3.Client
+            api_version = 3
+        else:
+            client_class = keystone_client.Client
+        keystone_ip = keystone_sentry.info['public-address']
+        session, auth = self.get_keystone_session(
+            keystone_ip,
+            api_version=api_version,
+            username='admin',
+            password='openstack',
+            project_name='admin',
+            user_domain_name='admin_domain',
+            project_domain_name='admin_domain')
+        client = client_class(session=session)
+        # This populates the client.service_catalog
+        client.auth_ref = auth.get_access(session)
+        return session, client
+
+    def authenticate_keystone_admin(self, keystone_sentry, user, password,
+                                    tenant=None, api_version=None,
+                                    keystone_ip=None, user_domain_name=None,
+                                    project_domain_name=None,
+                                    project_name=None):
+        """Authenticates admin user with the keystone admin endpoint."""
+        self.log.debug('Authenticating keystone admin...')
+        if not keystone_ip:
+            keystone_ip = keystone_sentry.info['public-address']
+
+        # To support backward compatibility usage of this function
+        if not project_name:
+            project_name = tenant
+        if api_version == 3 and not user_domain_name:
+            user_domain_name = 'admin_domain'
+        if api_version == 3 and not project_domain_name:
+            project_domain_name = 'admin_domain'
+        if api_version == 3 and not project_name:
+            project_name = 'admin'
+
+        return self.authenticate_keystone(
+            keystone_ip, user, password,
+            api_version=api_version,
+            user_domain_name=user_domain_name,
+            project_domain_name=project_domain_name,
+            project_name=project_name,
+            admin_port=True)
+
+    def authenticate_keystone_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with the keystone public endpoint."""
+        self.log.debug('Authenticating keystone user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        keystone_ip = urlparse.urlparse(ep).hostname
+
+        return self.authenticate_keystone(keystone_ip, user, password,
+                                          project_name=tenant)
+
+    def authenticate_glance_admin(self, keystone, force_v1_client=False):
+        """Authenticates admin user with glance."""
+        self.log.debug('Authenticating glance admin...')
+        ep = keystone.service_catalog.url_for(service_type='image',
+                                              interface='adminURL')
+        if not force_v1_client and keystone.session:
+            return glance_clientv2.Client("2", session=keystone.session)
+        else:
+            return glance_client.Client(ep, token=keystone.auth_token)
+
+    def authenticate_heat_admin(self, keystone):
+        """Authenticates the admin user with heat."""
+        self.log.debug('Authenticating heat admin...')
+        ep = keystone.service_catalog.url_for(service_type='orchestration',
+                                              interface='publicURL')
+        if keystone.session:
+            return heat_client.Client(endpoint=ep, session=keystone.session)
+        else:
+            return heat_client.Client(endpoint=ep, token=keystone.auth_token)
+
+    def authenticate_nova_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with nova-api."""
+        self.log.debug('Authenticating nova user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      session=keystone.session,
+                                      auth_url=ep)
+        elif novaclient.__version__[0] >= "7":
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, password=password,
+                                      project_name=tenant, auth_url=ep)
+        else:
+            return nova_client.Client(NOVA_CLIENT_VERSION,
+                                      username=user, api_key=password,
+                                      project_id=tenant, auth_url=ep)
+
+    def authenticate_swift_user(self, keystone, user, password, tenant):
+        """Authenticates a regular user with swift api."""
+        self.log.debug('Authenticating swift user ({})...'.format(user))
+        ep = keystone.service_catalog.url_for(service_type='identity',
+                                              interface='publicURL')
+        if keystone.session:
+            return swiftclient.Connection(session=keystone.session)
+        else:
+            return swiftclient.Connection(authurl=ep,
+                                          user=user,
+                                          key=password,
+                                          tenant_name=tenant,
+                                          auth_version='2.0')
+
+    def create_flavor(self, nova, name, ram, vcpus, disk, flavorid="auto",
+                      ephemeral=0, swap=0, rxtx_factor=1.0, is_public=True):
+        """Create the specified flavor."""
+        try:
+            nova.flavors.find(name=name)
+        except (exceptions.NotFound, exceptions.NoUniqueMatch):
+            self.log.debug('Creating flavor ({})'.format(name))
+            nova.flavors.create(name, ram, vcpus, disk, flavorid,
+                                ephemeral, swap, rxtx_factor, is_public)
+
+    def glance_create_image(self, glance, image_name, image_url,
+                            download_dir='tests',
+                            hypervisor_type=None,
+                            disk_format='qcow2',
+                            architecture='x86_64',
+                            container_format='bare'):
+        """Download an image and upload it to glance, validate its status
+        and return an image object pointer. KVM defaults, can override for
+        LXD.
+
+        :param glance: pointer to authenticated glance api connection
+        :param image_name: display name for new image
+        :param image_url: url to retrieve
+        :param download_dir: directory to store downloaded image file
+        :param hypervisor_type: glance image hypervisor property
+        :param disk_format: glance image disk format
+        :param architecture: glance image architecture property
+        :param container_format: glance image container format
+        :returns: glance image pointer
+        """
+        self.log.debug('Creating glance image ({}) from '
+                       '{}...'.format(image_name, image_url))
+
+        # Download image
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        abs_file_name = os.path.join(download_dir, image_name)
+        if not os.path.exists(abs_file_name):
+            opener.retrieve(image_url, abs_file_name)
+
+        # Create glance image
+        glance_properties = {
+            'architecture': architecture,
+        }
+        if hypervisor_type:
+            glance_properties['hypervisor_type'] = hypervisor_type
+        # Create glance image
+        if float(glance.version) < 2.0:
+            with open(abs_file_name) as f:
+                image = glance.images.create(
+                    name=image_name,
+                    is_public=True,
+                    disk_format=disk_format,
+                    container_format=container_format,
+                    properties=glance_properties,
+                    data=f)
+        else:
+            image = glance.images.create(
+                name=image_name,
+                visibility="public",
+                disk_format=disk_format,
+                container_format=container_format)
+            glance.images.upload(image.id, open(abs_file_name, 'rb'))
+            glance.images.update(image.id, **glance_properties)
+
+        # Wait for image to reach active status
+        img_id = image.id
+        ret = self.resource_reaches_status(glance.images, img_id,
+                                           expected_stat='active',
+                                           msg='Image status wait')
+        if not ret:
+            msg = 'Glance image failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new image
+        self.log.debug('Validating image attributes...')
+        val_img_name = glance.images.get(img_id).name
+        val_img_stat = glance.images.get(img_id).status
+        val_img_cfmt = glance.images.get(img_id).container_format
+        val_img_dfmt = glance.images.get(img_id).disk_format
+
+        if float(glance.version) < 2.0:
+            val_img_pub = glance.images.get(img_id).is_public
+        else:
+            val_img_pub = glance.images.get(img_id).visibility == "public"
+
+        msg_attr = ('Image attributes - name:{} public:{} id:{} stat:{} '
+                    'container fmt:{} disk fmt:{}'.format(
+                        val_img_name, val_img_pub, img_id,
+                        val_img_stat, val_img_cfmt, val_img_dfmt))
+
+        if val_img_name == image_name and val_img_stat == 'active' \
+                and val_img_pub is True and val_img_cfmt == container_format \
+                and val_img_dfmt == disk_format:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Image validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return image
+
+    def create_cirros_image(self, glance, image_name, hypervisor_type=None):
+        """Download the latest cirros image and upload it to glance,
+        validate and return a resource pointer.
+
+        :param glance: pointer to authenticated glance connection
+        :param image_name: display name for new image
+        :param hypervisor_type: glance image hypervisor property
+        :returns: glance image pointer
+        """
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'glance_create_image instead of '
+                      'create_cirros_image.')
+
+        self.log.debug('Creating glance cirros image '
+                       '({})...'.format(image_name))
+
+        # Get cirros image URL
+        http_proxy = os.getenv('OS_TEST_HTTP_PROXY')
+        self.log.debug('OS_TEST_HTTP_PROXY: {}'.format(http_proxy))
+        if http_proxy:
+            proxies = {'http': http_proxy}
+            opener = urllib.FancyURLopener(proxies)
+        else:
+            opener = urllib.FancyURLopener()
+
+        f = opener.open('http://download.cirros-cloud.net/version/released')
+        version = f.read().strip()
+        cirros_img = 'cirros-{}-x86_64-disk.img'.format(version)
+        cirros_url = 'http://{}/{}/{}'.format('download.cirros-cloud.net',
+                                              version, cirros_img)
+        f.close()
+
+        return self.glance_create_image(
+            glance,
+            image_name,
+            cirros_url,
+            hypervisor_type=hypervisor_type)
+
+    def delete_image(self, glance, image):
+        """Delete the specified image."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_image.')
+        self.log.debug('Deleting glance image ({})...'.format(image))
+        return self.delete_resource(glance.images, image, msg='glance image')
+
+    def create_instance(self, nova, image_name, instance_name, flavor):
+        """Create the specified instance."""
+        self.log.debug('Creating instance '
+                       '({}|{}|{})'.format(instance_name, image_name, flavor))
+        image = nova.glance.find_image(image_name)
+        flavor = nova.flavors.find(name=flavor)
+        instance = nova.servers.create(name=instance_name, image=image,
+                                       flavor=flavor)
+
+        count = 1
+        status = instance.status
+        while status != 'ACTIVE' and count < 60:
+            time.sleep(3)
+            instance = nova.servers.get(instance.id)
+            status = instance.status
+            self.log.debug('instance status: {}'.format(status))
+            count += 1
+
+        if status != 'ACTIVE':
+            self.log.error('instance creation timed out')
+            return None
+
+        return instance
+
+    def delete_instance(self, nova, instance):
+        """Delete the specified instance."""
+
+        # /!\ DEPRECATION WARNING
+        self.log.warn('/!\\ DEPRECATION WARNING:  use '
+                      'delete_resource instead of delete_instance.')
+        self.log.debug('Deleting instance ({})...'.format(instance))
+        return self.delete_resource(nova.servers, instance,
+                                    msg='nova instance')
+
+    def create_or_get_keypair(self, nova, keypair_name="testkey"):
+        """Create a new keypair, or return pointer if it already exists."""
+        try:
+            _keypair = nova.keypairs.get(keypair_name)
+            self.log.debug('Keypair ({}) already exists, '
+                           'using it.'.format(keypair_name))
+            return _keypair
+        except Exception:
+            self.log.debug('Keypair ({}) does not exist, '
+                           'creating it.'.format(keypair_name))
+
+        _keypair = nova.keypairs.create(name=keypair_name)
+        return _keypair
+
+    def _get_cinder_obj_name(self, cinder_object):
+        """Retrieve name of cinder object.
+
+        :param cinder_object: cinder snapshot or volume object
+        :returns: str cinder object name
+        """
+        # v1 objects store name in 'display_name' attr but v2+ use 'name'
+        try:
+            return cinder_object.display_name
+        except AttributeError:
+            return cinder_object.name
+
+    def create_cinder_volume(self, cinder, vol_name="demo-vol", vol_size=1,
+                             img_id=None, src_vol_id=None, snap_id=None):
+        """Create cinder volume, optionally from a glance image, OR
+        optionally as a clone of an existing volume, OR optionally
+        from a snapshot.  Wait for the new volume status to reach
+        the expected status, validate and return a resource pointer.
+
+        :param vol_name: cinder volume display name
+        :param vol_size: size in gigabytes
+        :param img_id: optional glance image id
+        :param src_vol_id: optional source volume id to clone
+        :param snap_id: optional snapshot id to use
+        :returns: cinder volume pointer
+        """
+        # Handle parameter input and avoid impossible combinations
+        if img_id and not src_vol_id and not snap_id:
+            # Create volume from image
+            self.log.debug('Creating cinder volume from glance image...')
+            bootable = 'true'
+        elif src_vol_id and not img_id and not snap_id:
+            # Clone an existing volume
+            self.log.debug('Cloning cinder volume...')
+            bootable = cinder.volumes.get(src_vol_id).bootable
+        elif snap_id and not src_vol_id and not img_id:
+            # Create volume from snapshot
+            self.log.debug('Creating cinder volume from snapshot...')
+            snap = cinder.volume_snapshots.find(id=snap_id)
+            vol_size = snap.size
+            snap_vol_id = cinder.volume_snapshots.get(snap_id).volume_id
+            bootable = cinder.volumes.get(snap_vol_id).bootable
+        elif not img_id and not src_vol_id and not snap_id:
+            # Create volume
+            self.log.debug('Creating cinder volume...')
+            bootable = 'false'
+        else:
+            # Impossible combination of parameters
+            msg = ('Invalid method use - name:{} size:{} img_id:{} '
+                   'src_vol_id:{} snap_id:{}'.format(vol_name, vol_size,
+                                                     img_id, src_vol_id,
+                                                     snap_id))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Create new volume
+        try:
+            vol_new = cinder.volumes.create(display_name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except TypeError:
+            vol_new = cinder.volumes.create(name=vol_name,
+                                            imageRef=img_id,
+                                            size=vol_size,
+                                            source_volid=src_vol_id,
+                                            snapshot_id=snap_id)
+            vol_id = vol_new.id
+        except Exception as e:
+            msg = 'Failed to create volume: {}'.format(e)
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Wait for volume to reach available status
+        ret = self.resource_reaches_status(cinder.volumes, vol_id,
+                                           expected_stat="available",
+                                           msg="Volume status wait")
+        if not ret:
+            msg = 'Cinder volume failed to reach expected state.'
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # Re-validate new volume
+        self.log.debug('Validating volume attributes...')
+        val_vol_name = self._get_cinder_obj_name(cinder.volumes.get(vol_id))
+        val_vol_boot = cinder.volumes.get(vol_id).bootable
+        val_vol_stat = cinder.volumes.get(vol_id).status
+        val_vol_size = cinder.volumes.get(vol_id).size
+        msg_attr = ('Volume attributes - name:{} id:{} stat:{} boot:'
+                    '{} size:{}'.format(val_vol_name, vol_id,
+                                        val_vol_stat, val_vol_boot,
+                                        val_vol_size))
+
+        if val_vol_boot == bootable and val_vol_stat == 'available' \
+                and val_vol_name == vol_name and val_vol_size == vol_size:
+            self.log.debug(msg_attr)
+        else:
+            msg = ('Volume validation failed, {}'.format(msg_attr))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        return vol_new
+
+    def delete_resource(self, resource, resource_id,
+                        msg="resource", max_wait=120):
+        """Delete one openstack resource, such as one instance, keypair,
+        image, volume, stack, etc., and confirm deletion within max wait time.
+
+        :param resource: pointer to os resource type, ex:glance_client.images
+        :param resource_id: unique name or id for the openstack resource
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, otherwise False
+        """
+        self.log.debug('Deleting OpenStack resource '
+                       '{} ({})'.format(resource_id, msg))
+        num_before = len(list(resource.list()))
+        resource.delete(resource_id)
+
+        tries = 0
+        num_after = len(list(resource.list()))
+        while num_after != (num_before - 1) and tries < (max_wait / 4):
+            self.log.debug('{} delete check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  num_before,
+                                                  num_after,
+                                                  resource_id))
+            time.sleep(4)
+            num_after = len(list(resource.list()))
+            tries += 1
+
+        self.log.debug('{}:  expected, actual count = {}, '
+                       '{}'.format(msg, num_before - 1, num_after))
+
+        if num_after == (num_before - 1):
+            return True
+        else:
+            self.log.error('{} delete timed out'.format(msg))
+            return False
+
+    def resource_reaches_status(self, resource, resource_id,
+                                expected_stat='available',
+                                msg='resource', max_wait=120):
+        """Wait for an openstack resources status to reach an
+           expected status within a specified time.  Useful to confirm that
+           nova instances, cinder vols, snapshots, glance images, heat stacks
+           and other resources eventually reach the expected status.
+
+        :param resource: pointer to os resource type, ex: heat_client.stacks
+        :param resource_id: unique id for the openstack resource
+        :param expected_stat: status to expect resource to reach
+        :param msg: text to identify purpose in logging
+        :param max_wait: maximum wait time in seconds
+        :returns: True if successful, False if status is not reached
+        """
+
+        tries = 0
+        resource_stat = resource.get(resource_id).status
+        while resource_stat != expected_stat and tries < (max_wait / 4):
+            self.log.debug('{} status check: '
+                           '{} [{}:{}] {}'.format(msg, tries,
+                                                  resource_stat,
+                                                  expected_stat,
+                                                  resource_id))
+            time.sleep(4)
+            resource_stat = resource.get(resource_id).status
+            tries += 1
+
+        self.log.debug('{}:  expected, actual status = {}, '
+                       '{}'.format(msg, resource_stat, expected_stat))
+
+        if resource_stat == expected_stat:
+            return True
+        else:
+            self.log.debug('{} never reached expected status: '
+                           '{}'.format(resource_id, expected_stat))
+            return False
+
+    def get_ceph_osd_id_cmd(self, index):
+        """Produce a shell command that will return a ceph-osd id."""
+        return ("`initctl list | grep 'ceph-osd ' | "
+                "awk 'NR=={} {{ print $2 }}' | "
+                "grep -o '[0-9]*'`".format(index + 1))
+
+    def get_ceph_pools(self, sentry_unit):
+        """Return a dict of ceph pools from a single ceph unit, with
+        pool name as keys, pool id as vals."""
+        pools = {}
+        cmd = 'sudo ceph osd lspools'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+
+        # For mimic ceph osd lspools output
+        output = output.replace("\n", ",")
+
+        # Example output: 0 data,1 metadata,2 rbd,3 cinder,4 glance,
+        for pool in str(output).split(','):
+            pool_id_name = pool.split(' ')
+            if len(pool_id_name) == 2:
+                pool_id = pool_id_name[0]
+                pool_name = pool_id_name[1]
+                pools[pool_name] = int(pool_id)
+
+        self.log.debug('Pools on {}: {}'.format(sentry_unit.info['unit_name'],
+                                                pools))
+        return pools
+
+    def get_ceph_df(self, sentry_unit):
+        """Return dict of ceph df json output, including ceph pool state.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :returns: Dict of ceph df output
+        """
+        cmd = 'sudo ceph df --format=json'
+        output, code = sentry_unit.run(cmd)
+        if code != 0:
+            msg = ('{} `{}` returned {} '
+                   '{}'.format(sentry_unit.info['unit_name'],
+                               cmd, code, output))
+            amulet.raise_status(amulet.FAIL, msg=msg)
+        return json.loads(output)
+
+    def get_ceph_pool_sample(self, sentry_unit, pool_id=0):
+        """Take a sample of attributes of a ceph pool, returning ceph
+        pool name, object count and disk space used for the specified
+        pool ID number.
+
+        :param sentry_unit: Pointer to amulet sentry instance (juju unit)
+        :param pool_id: Ceph pool ID
+        :returns: List of pool name, object count, kb disk space used
+        """
+        df = self.get_ceph_df(sentry_unit)
+        for pool in df['pools']:
+            if pool['id'] == pool_id:
+                pool_name = pool['name']
+                obj_count = pool['stats']['objects']
+                kb_used = pool['stats']['kb_used']
+
+        self.log.debug('Ceph {} pool (ID {}): {} objects, '
+                       '{} kb used'.format(pool_name, pool_id,
+                                           obj_count, kb_used))
+        return pool_name, obj_count, kb_used
+
+    def validate_ceph_pool_samples(self, samples, sample_type="resource pool"):
+        """Validate ceph pool samples taken over time, such as pool
+        object counts or pool kb used, before adding, after adding, and
+        after deleting items which affect those pool attributes.  The
+        2nd element is expected to be greater than the 1st; 3rd is expected
+        to be less than the 2nd.
+
+        :param samples: List containing 3 data samples
+        :param sample_type: String for logging and usage context
+        :returns: None if successful, Failure message otherwise
+        """
+        original, created, deleted = range(3)
+        if samples[created] <= samples[original] or \
+                samples[deleted] >= samples[created]:
+            return ('Ceph {} samples ({}) '
+                    'unexpected.'.format(sample_type, samples))
+        else:
+            self.log.debug('Ceph {} samples (OK): '
+                           '{}'.format(sample_type, samples))
+            return None
+
+    # rabbitmq/amqp specific helpers:
+
+    def rmq_wait_for_cluster(self, deployment, init_sleep=15, timeout=1200):
+        """Wait for rmq units extended status to show cluster readiness,
+        after an optional initial sleep period.  Initial sleep is likely
+        necessary to be effective following a config change, as status
+        message may not instantly update to non-ready."""
+
+        if init_sleep:
+            time.sleep(init_sleep)
+
+        message = re.compile('^Unit is ready and clustered$')
+        deployment._auto_wait_for_status(message=message,
+                                         timeout=timeout,
+                                         include_only=['rabbitmq-server'])
+
+    def add_rmq_test_user(self, sentry_units,
+                          username="testuser1", password="changeme"):
+        """Add a test user via the first rmq juju unit, check connection as
+        the new user against all sentry units.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Adding rmq user ({})...'.format(username))
+
+        # Check that user does not already exist
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+        if username in output:
+            self.log.warning('User ({}) already exists, returning '
+                             'gracefully.'.format(username))
+            return
+
+        perms = '".*" ".*" ".*"'
+        cmds = ['rabbitmqctl add_user {} {}'.format(username, password),
+                'rabbitmqctl set_permissions {} {}'.format(username, perms)]
+
+        # Add user via first unit
+        for cmd in cmds:
+            output, _ = self.run_cmd_unit(sentry_units[0], cmd)
+
+        # Check connection against the other sentry_units
+        self.log.debug('Checking user connect against units...')
+        for sentry_unit in sentry_units:
+            connection = self.connect_amqp_by_unit(sentry_unit, ssl=False,
+                                                   username=username,
+                                                   password=password)
+            connection.close()
+
+    def delete_rmq_test_user(self, sentry_units, username="testuser1"):
+        """Delete a rabbitmq user via the first rmq juju unit.
+
+        :param sentry_units: list of sentry unit pointers
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: None if successful or no such user.
+        """
+        self.log.debug('Deleting rmq user ({})...'.format(username))
+
+        # Check that the user exists
+        cmd_user_list = 'rabbitmqctl list_users'
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_list)
+
+        if username not in output:
+            self.log.warning('User ({}) does not exist, returning '
+                             'gracefully.'.format(username))
+            return
+
+        # Delete the user
+        cmd_user_del = 'rabbitmqctl delete_user {}'.format(username)
+        output, _ = self.run_cmd_unit(sentry_units[0], cmd_user_del)
+
+    def get_rmq_cluster_status(self, sentry_unit):
+        """Execute rabbitmq cluster status command on a unit and return
+        the full output.
+
+        :param unit: sentry unit
+        :returns: String containing console output of cluster status command
+        """
+        cmd = 'rabbitmqctl cluster_status'
+        output, _ = self.run_cmd_unit(sentry_unit, cmd)
+        self.log.debug('{} cluster_status:\n{}'.format(
+            sentry_unit.info['unit_name'], output))
+        return str(output)
+
+    def get_rmq_cluster_running_nodes(self, sentry_unit):
+        """Parse rabbitmqctl cluster_status output string, return list of
+        running rabbitmq cluster nodes.
+
+        :param unit: sentry unit
+        :returns: List containing node names of running nodes
+        """
+        # NOTE(beisner): rabbitmqctl cluster_status output is not
+        # json-parsable, do string chop foo, then json.loads that.
+        str_stat = self.get_rmq_cluster_status(sentry_unit)
+        if 'running_nodes' in str_stat:
+            pos_start = str_stat.find("{running_nodes,") + 15
+            pos_end = str_stat.find("]},", pos_start) + 1
+            str_run_nodes = str_stat[pos_start:pos_end].replace("'", '"')
+            run_nodes = json.loads(str_run_nodes)
+            return run_nodes
+        else:
+            return []
+
+    def validate_rmq_cluster_running_nodes(self, sentry_units):
+        """Check that all rmq unit hostnames are represented in the
+        cluster_status output of all units.
+
+        :param host_names: dict of juju unit names to host names
+        :param units: list of sentry unit pointers (all rmq units)
+        :returns: None if successful, otherwise return error message
+        """
+        host_names = self.get_unit_hostnames(sentry_units)
+        errors = []
+
+        # Query every unit for cluster_status running nodes
+        for query_unit in sentry_units:
+            query_unit_name = query_unit.info['unit_name']
+            running_nodes = self.get_rmq_cluster_running_nodes(query_unit)
+
+            # Confirm that every unit is represented in the queried unit's
+            # cluster_status running nodes output.
+            for validate_unit in sentry_units:
+                val_host_name = host_names[validate_unit.info['unit_name']]
+                val_node_name = 'rabbit@{}'.format(val_host_name)
+
+                if val_node_name not in running_nodes:
+                    errors.append('Cluster member check failed on {}: {} not '
+                                  'in {}\n'.format(query_unit_name,
+                                                   val_node_name,
+                                                   running_nodes))
+        if errors:
+            return ''.join(errors)
+
+    def rmq_ssl_is_enabled_on_unit(self, sentry_unit, port=None):
+        """Check a single juju rmq unit for ssl and port in the config file."""
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        conf_file = '/etc/rabbitmq/rabbitmq.config'
+        conf_contents = str(self.file_contents_safe(sentry_unit,
+                                                    conf_file, max_wait=16))
+        # Checks
+        conf_ssl = 'ssl' in conf_contents
+        conf_port = str(port) in conf_contents
+
+        # Port explicitly checked in config
+        if port and conf_port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif port and not conf_port and conf_ssl:
+            self.log.debug('SSL is enabled @{} but not on port {} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        # Port not checked (useful when checking that ssl is disabled)
+        elif not port and conf_ssl:
+            self.log.debug('SSL is enabled  @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return True
+        elif not conf_ssl:
+            self.log.debug('SSL not enabled @{}:{} '
+                           '({})'.format(host, port, unit_name))
+            return False
+        else:
+            msg = ('Unknown condition when checking SSL status @{}:{} '
+                   '({})'.format(host, port, unit_name))
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_rmq_ssl_enabled_units(self, sentry_units, port=None):
+        """Check that ssl is enabled on rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :param port: optional ssl port override to validate
+        :returns: None if successful, otherwise return error message
+        """
+        for sentry_unit in sentry_units:
+            if not self.rmq_ssl_is_enabled_on_unit(sentry_unit, port=port):
+                return ('Unexpected condition:  ssl is disabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def validate_rmq_ssl_disabled_units(self, sentry_units):
+        """Check that ssl is enabled on listed rmq juju sentry units.
+
+        :param sentry_units: list of all rmq sentry units
+        :returns: True if successful.  Raise on error.
+        """
+        for sentry_unit in sentry_units:
+            if self.rmq_ssl_is_enabled_on_unit(sentry_unit):
+                return ('Unexpected condition:  ssl is enabled on unit '
+                        '({})'.format(sentry_unit.info['unit_name']))
+        return None
+
+    def configure_rmq_ssl_on(self, sentry_units, deployment,
+                             port=None, max_wait=60):
+        """Turn ssl charm config option on, with optional non-default
+        ssl port specification.  Confirm that it is enabled on every
+        unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param port: amqp port, use defaults if None
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  on')
+
+        # Enable RMQ SSL
+        config = {'ssl': 'on'}
+        if port:
+            config['ssl_port'] = port
+
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_enabled_units(sentry_units, port=port)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def configure_rmq_ssl_off(self, sentry_units, deployment, max_wait=60):
+        """Turn ssl charm config option off, confirm that it is disabled
+        on every unit.
+
+        :param sentry_units: list of sentry units
+        :param deployment: amulet deployment object pointer
+        :param max_wait: maximum time to wait in seconds to confirm
+        :returns: None if successful.  Raise on error.
+        """
+        self.log.debug('Setting ssl charm config option:  off')
+
+        # Disable RMQ SSL
+        config = {'ssl': 'off'}
+        deployment.d.configure('rabbitmq-server', config)
+
+        # Wait for unit status
+        self.rmq_wait_for_cluster(deployment)
+
+        # Confirm
+        tries = 0
+        ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+        while ret and tries < (max_wait / 4):
+            time.sleep(4)
+            self.log.debug('Attempt {}: {}'.format(tries, ret))
+            ret = self.validate_rmq_ssl_disabled_units(sentry_units)
+            tries += 1
+
+        if ret:
+            amulet.raise_status(amulet.FAIL, ret)
+
+    def connect_amqp_by_unit(self, sentry_unit, ssl=False,
+                             port=None, fatal=True,
+                             username="testuser1", password="changeme"):
+        """Establish and return a pika amqp connection to the rabbitmq service
+        running on a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :param fatal: boolean, default to True (raises on connect error)
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :returns: pika amqp connection pointer or None if failed and non-fatal
+        """
+        host = sentry_unit.info['public-address']
+        unit_name = sentry_unit.info['unit_name']
+
+        # Default port logic if port is not specified
+        if ssl and not port:
+            port = 5671
+        elif not ssl and not port:
+            port = 5672
+
+        self.log.debug('Connecting to amqp on {}:{} ({}) as '
+                       '{}...'.format(host, port, unit_name, username))
+
+        try:
+            credentials = pika.PlainCredentials(username, password)
+            parameters = pika.ConnectionParameters(host=host, port=port,
+                                                   credentials=credentials,
+                                                   ssl=ssl,
+                                                   connection_attempts=3,
+                                                   retry_delay=5,
+                                                   socket_timeout=1)
+            connection = pika.BlockingConnection(parameters)
+            assert connection.is_open is True
+            assert connection.is_closing is False
+            self.log.debug('Connect OK')
+            return connection
+        except Exception as e:
+            msg = ('amqp connection failed to {}:{} as '
+                   '{} ({})'.format(host, port, username, str(e)))
+            if fatal:
+                amulet.raise_status(amulet.FAIL, msg)
+            else:
+                self.log.warn(msg)
+                return None
+
+    def publish_amqp_message_by_unit(self, sentry_unit, message,
+                                     queue="test", ssl=False,
+                                     username="testuser1",
+                                     password="changeme",
+                                     port=None):
+        """Publish an amqp message to a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param message: amqp message string
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: None.  Raises exception if publish failed.
+        """
+        self.log.debug('Publishing message to {} queue:\n{}'.format(queue,
+                                                                    message))
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+
+        # NOTE(beisner): extra debug here re: pika hang potential:
+        #   https://github.com/pika/pika/issues/297
+        #   https://groups.google.com/forum/#!topic/rabbitmq-users/Ja0iyfF0Szw
+        self.log.debug('Defining channel...')
+        channel = connection.channel()
+        self.log.debug('Declaring queue...')
+        channel.queue_declare(queue=queue, auto_delete=False, durable=True)
+        self.log.debug('Publishing message...')
+        channel.basic_publish(exchange='', routing_key=queue, body=message)
+        self.log.debug('Closing channel...')
+        channel.close()
+        self.log.debug('Closing connection...')
+        connection.close()
+
+    def get_amqp_message_by_unit(self, sentry_unit, queue="test",
+                                 username="testuser1",
+                                 password="changeme",
+                                 ssl=False, port=None):
+        """Get an amqp message from a rmq juju unit.
+
+        :param sentry_unit: sentry unit pointer
+        :param queue: message queue, default to test
+        :param username: amqp user name, default to testuser1
+        :param password: amqp user password
+        :param ssl: boolean, default to False
+        :param port: amqp port, use defaults if None
+        :returns: amqp message body as string.  Raise if get fails.
+        """
+        connection = self.connect_amqp_by_unit(sentry_unit, ssl=ssl,
+                                               port=port,
+                                               username=username,
+                                               password=password)
+        channel = connection.channel()
+        method_frame, _, body = channel.basic_get(queue)
+
+        if method_frame:
+            self.log.debug('Retreived message from {} queue:\n{}'.format(queue,
+                                                                         body))
+            channel.basic_ack(method_frame.delivery_tag)
+            channel.close()
+            connection.close()
+            return body
+        else:
+            msg = 'No message retrieved.'
+            amulet.raise_status(amulet.FAIL, msg)
+
+    def validate_memcache(self, sentry_unit, conf, os_release,
+                          earliest_release=5, section='keystone_authtoken',
+                          check_kvs=None):
+        """Check Memcache is running and is configured to be used
+
+        Example call from Amulet test:
+
+            def test_110_memcache(self):
+                u.validate_memcache(self.neutron_api_sentry,
+                                    '/etc/neutron/neutron.conf',
+                                    self._get_openstack_release())
+
+        :param sentry_unit: sentry unit
+        :param conf: OpenStack config file to check memcache settings
+        :param os_release: Current OpenStack release int code
+        :param earliest_release: Earliest Openstack release to check int code
+        :param section: OpenStack config file section to check
+        :param check_kvs: Dict of settings to check in config file
+        :returns: None
+        """
+        if os_release < earliest_release:
+            self.log.debug('Skipping memcache checks for deployment. {} <'
+                           'mitaka'.format(os_release))
+            return
+        _kvs = check_kvs or {'memcached_servers': 'inet6:[::1]:11211'}
+        self.log.debug('Checking memcached is running')
+        ret = self.validate_services_by_name({sentry_unit: ['memcached']})
+        if ret:
+            amulet.raise_status(amulet.FAIL, msg='Memcache running check'
+                                'failed {}'.format(ret))
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache url is configured in {}'.format(
+            conf))
+        if self.validate_config_data(sentry_unit, conf, section, _kvs):
+            message = "Memcache config error in: {}".format(conf)
+            amulet.raise_status(amulet.FAIL, msg=message)
+        else:
+            self.log.debug('OK')
+        self.log.debug('Checking memcache configuration in '
+                       '/etc/memcached.conf')
+        contents = self.file_contents_safe(sentry_unit, '/etc/memcached.conf',
+                                           fatal=True)
+        ubuntu_release, _ = self.run_cmd_unit(sentry_unit, 'lsb_release -cs')
+        if CompareHostReleases(ubuntu_release) <= 'trusty':
+            memcache_listen_addr = 'ip6-localhost'
+        else:
+            memcache_listen_addr = '::1'
+        expected = {
+            '-p': '11211',
+            '-l': memcache_listen_addr}
+        found = []
+        for key, value in expected.items():
+            for line in contents.split('\n'):
+                if line.startswith(key):
+                    self.log.debug('Checking {} is set to {}'.format(
+                        key,
+                        value))
+                    assert value == line.split()[-1]
+                    self.log.debug(line.split()[-1])
+                    found.append(key)
+        if sorted(found) == sorted(expected.keys()):
+            self.log.debug('OK')
+        else:
+            message = "Memcache config error in: /etc/memcached.conf"
+            amulet.raise_status(amulet.FAIL, msg=message)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f7e5f79a5d5fe3cb374814e32ea16f6060f4f27
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/__init__.py
@@ -0,0 +1,212 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""OpenStack Security Audit code"""
+
+import collections
+from enum import Enum
+import traceback
+
+from charmhelpers.core.host import cmp_pkgrevno
+import charmhelpers.contrib.openstack.utils as openstack_utils
+import charmhelpers.core.hookenv as hookenv
+
+
+class AuditType(Enum):
+    OpenStackSecurityGuide = 1
+
+
+_audits = {}
+
+Audit = collections.namedtuple('Audit', 'func filters')
+
+
+def audit(*args):
+    """Decorator to register an audit.
+
+    These are used to generate audits that can be run on a
+    deployed system that matches the given configuration
+
+    :param args: List of functions to filter tests against
+    :type args: List[Callable[Dict]]
+    """
+    def wrapper(f):
+        test_name = f.__name__
+        if _audits.get(test_name):
+            raise RuntimeError(
+                "Test name '{}' used more than once"
+                .format(test_name))
+        non_callables = [fn for fn in args if not callable(fn)]
+        if non_callables:
+            raise RuntimeError(
+                "Configuration includes non-callable filters: {}"
+                .format(non_callables))
+        _audits[test_name] = Audit(func=f, filters=args)
+        return f
+    return wrapper
+
+
+def is_audit_type(*args):
+    """This audit is included in the specified kinds of audits.
+
+    :param *args: List of AuditTypes to include this audit in
+    :type args: List[AuditType]
+    :rtype: Callable[Dict]
+    """
+    def _is_audit_type(audit_options):
+        if audit_options.get('audit_type') in args:
+            return True
+        else:
+            return False
+    return _is_audit_type
+
+
+def since_package(pkg, pkg_version):
+    """This audit should be run after the specified package version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_package(audit_options=None):
+        return cmp_pkgrevno(pkg, pkg_version) >= 0
+
+    return _since_package
+
+
+def before_package(pkg, pkg_version):
+    """This audit should be run before the specified package version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The package version
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_package(audit_options=None):
+        return not since_package(pkg, pkg_version)()
+
+    return _before_package
+
+
+def since_openstack_release(pkg, release):
+    """This audit should run after the specified OpenStack version (incl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _since_openstack_release(audit_options=None):
+        _release = openstack_utils.get_os_codename_package(pkg)
+        return openstack_utils.CompareOpenStackReleases(_release) >= release
+
+    return _since_openstack_release
+
+
+def before_openstack_release(pkg, release):
+    """This audit should run before the specified OpenStack version (excl).
+
+    :param pkg: Package name to compare
+    :type pkg: str
+    :param release: The OpenStack release codename
+    :type release: str
+    :rtype: Callable[Dict]
+    """
+    def _before_openstack_release(audit_options=None):
+        return not since_openstack_release(pkg, release)()
+
+    return _before_openstack_release
+
+
+def it_has_config(config_key):
+    """This audit should be run based on specified config keys.
+
+    :param config_key: Config key to look for
+    :type config_key: str
+    :rtype: Callable[Dict]
+    """
+    def _it_has_config(audit_options):
+        return audit_options.get(config_key) is not None
+
+    return _it_has_config
+
+
+def run(audit_options):
+    """Run the configured audits with the specified audit_options.
+
+    :param audit_options: Configuration for the audit
+    :type audit_options: Config
+
+    :rtype: Dict[str, str]
+    """
+    errors = {}
+    results = {}
+    for name, audit in sorted(_audits.items()):
+        result_name = name.replace('_', '-')
+        if result_name in audit_options.get('excludes', []):
+            print(
+                "Skipping {} because it is"
+                "excluded in audit config"
+                .format(result_name))
+            continue
+        if all(p(audit_options) for p in audit.filters):
+            try:
+                audit.func(audit_options)
+                print("{}: PASS".format(name))
+                results[result_name] = {
+                    'success': True,
+                }
+            except AssertionError as e:
+                print("{}: FAIL ({})".format(name, e))
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+            except Exception as e:
+                print("{}: ERROR ({})".format(name, e))
+                errors[name] = e
+                results[result_name] = {
+                    'success': False,
+                    'message': e,
+                }
+    for name, error in errors.items():
+        print("=" * 20)
+        print("Error in {}: ".format(name))
+        traceback.print_tb(error.__traceback__)
+        print()
+    return results
+
+
+def action_parse_results(result):
+    """Parse the result of `run` in the context of an action.
+
+    :param result: The result of running the security-checklist
+        action on a unit
+    :type result: Dict[str, Dict[str, str]]
+    :rtype: int
+    """
+    passed = True
+    for test, result in result.items():
+        if result['success']:
+            hookenv.action_set({test: 'PASS'})
+        else:
+            hookenv.action_set({test: 'FAIL - {}'.format(result['message'])})
+            passed = False
+    if not passed:
+        hookenv.action_fail("One or more tests failed")
+    return 0 if passed else 1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/openstack_security_guide.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
new file mode 100644
index 0000000000000000000000000000000000000000..79740ed0c103e841b6e280af920f8be65e3d1d0d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/audits/openstack_security_guide.py
@@ -0,0 +1,270 @@
+# Copyright 2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import configparser
+import glob
+import os.path
+import subprocess
+
+from charmhelpers.contrib.openstack.audits import (
+    audit,
+    AuditType,
+    # filters
+    is_audit_type,
+    it_has_config,
+)
+
+from charmhelpers.core.hookenv import (
+    cached,
+)
+
+"""
+The Security Guide suggests a specific list of files inside the
+config directory for the service having 640 specifically, but
+by ensuring the containing directory is 750, only the owner can
+write, and only the group can read files within the directory.
+
+By  restricting access to the containing directory, we can more
+effectively ensure that there is no accidental leakage if a new
+file is added to the service without being added to the security
+guide, and to this check.
+"""
+FILE_ASSERTIONS = {
+    'barbican': {
+        '/etc/barbican': {'group': 'barbican', 'mode': '750'},
+    },
+    'ceph-mon': {
+        '/var/lib/charm/ceph-mon/ceph.conf':
+            {'owner': 'root', 'group': 'root', 'mode': '644'},
+        '/etc/ceph/ceph.client.admin.keyring':
+            {'owner': 'ceph', 'group': 'ceph'},
+        '/etc/ceph/rbdmap': {'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'}
+    },
+    'ceph-osd': {
+        '/var/lib/charm/ceph-osd/ceph.conf':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '644'},
+        '/var/lib/ceph': {'owner': 'ceph', 'group': 'ceph', 'mode': '750'},
+        '/var/lib/ceph/*': {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+        '/var/lib/ceph/bootstrap-*/ceph.keyring':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '600'},
+        '/var/lib/ceph/radosgw':
+            {'owner': 'ceph', 'group': 'ceph', 'mode': '755'},
+    },
+    'cinder': {
+        '/etc/cinder': {'group': 'cinder', 'mode': '750'},
+    },
+    'glance': {
+        '/etc/glance': {'group': 'glance', 'mode': '750'},
+    },
+    'keystone': {
+        '/etc/keystone':
+            {'owner': 'keystone', 'group': 'keystone', 'mode': '750'},
+    },
+    'manilla': {
+        '/etc/manila': {'group': 'manilla', 'mode': '750'},
+    },
+    'neutron-gateway': {
+        '/etc/neutron': {'group': 'neutron', 'mode': '750'},
+    },
+    'neutron-api': {
+        '/etc/neutron/': {'group': 'neutron', 'mode': '750'},
+    },
+    'nova-cloud-controller': {
+        '/etc/nova': {'group': 'nova', 'mode': '750'},
+    },
+    'nova-compute': {
+        '/etc/nova/': {'group': 'nova', 'mode': '750'},
+    },
+    'openstack-dashboard': {
+        # From security guide
+        '/etc/openstack-dashboard/local_settings.py':
+            {'group': 'horizon', 'mode': '640'},
+    },
+}
+
+Ownership = collections.namedtuple('Ownership', 'owner group mode')
+
+
+@cached
+def _stat(file):
+    """
+    Get the Ownership information from a file.
+
+    :param file: The path to a file to stat
+    :type file: str
+    :returns: owner, group, and mode of the specified file
+    :rtype: Ownership
+    :raises subprocess.CalledProcessError: If the underlying stat fails
+    """
+    out = subprocess.check_output(
+        ['stat', '-c', '%U %G %a', file]).decode('utf-8')
+    return Ownership(*out.strip().split(' '))
+
+
+@cached
+def _config_ini(path):
+    """
+    Parse an ini file
+
+    :param path: The path to a file to parse
+    :type file: str
+    :returns: Configuration contained in path
+    :rtype: Dict
+    """
+    # When strict is enabled, duplicate options are not allowed in the
+    # parsed INI; however, Oslo allows duplicate values. This change
+    # causes us to ignore the duplicate values which is acceptable as
+    # long as we don't validate any multi-value options
+    conf = configparser.ConfigParser(strict=False)
+    conf.read(path)
+    return dict(conf)
+
+
+def _validate_file_ownership(owner, group, file_name, optional=False):
+    """
+    Validate that a specified file is owned by `owner:group`.
+
+    :param owner: Name of the owner
+    :type owner: str
+    :param group: Name of the group
+    :type group: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert owner == ownership.owner, \
+        "{} has an incorrect owner: {} should be {}".format(
+            file_name, ownership.owner, owner)
+    assert group == ownership.group, \
+        "{} has an incorrect group: {} should be {}".format(
+            file_name, ownership.group, group)
+    print("Validate ownership of {}: PASS".format(file_name))
+
+
+def _validate_file_mode(mode, file_name, optional=False):
+    """
+    Validate that a specified file has the specified permissions.
+
+    :param mode: file mode that is desires
+    :type owner: str
+    :param file_name: Path to the file to verify
+    :type file_name: str
+    :param optional: Is this file optional,
+                     ie: Should this test fail when it's missing
+    :type optional: bool
+    """
+    try:
+        ownership = _stat(file_name)
+    except subprocess.CalledProcessError as e:
+        print("Error reading file: {}".format(e))
+        if not optional:
+            assert False, "Specified file does not exist: {}".format(file_name)
+    assert mode == ownership.mode, \
+        "{} has an incorrect mode: {} should be {}".format(
+            file_name, ownership.mode, mode)
+    print("Validate mode of {}: PASS".format(file_name))
+
+
+@cached
+def _config_section(config, section):
+    """Read the configuration file and return a section."""
+    path = os.path.join(config.get('config_path'), config.get('config_file'))
+    conf = _config_ini(path)
+    return conf.get(section)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_ownership(config):
+    """Verify that configuration files are owned by the correct user/group."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        owner = options.get('owner', config.get('owner', 'root'))
+        group = options.get('group', config.get('group', 'root'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_ownership(owner, group, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_ownership(owner, group, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide),
+       it_has_config('files'))
+def validate_file_permissions(config):
+    """Verify that permissions on configuration files are secure enough."""
+    files = config.get('files', {})
+    for file_name, options in files.items():
+        for key in options.keys():
+            if key not in ["owner", "group", "mode"]:
+                raise RuntimeError(
+                    "Invalid ownership configuration: {}".format(key))
+        mode = options.get('mode', config.get('permissions', '600'))
+        optional = options.get('optional', config.get('optional', False))
+        if '*' in file_name:
+            for file in glob.glob(file_name):
+                if file not in files.keys():
+                    if os.path.isfile(file):
+                        _validate_file_mode(mode, file, optional)
+        else:
+            if os.path.isfile(file_name):
+                _validate_file_mode(mode, file_name, optional)
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_keystone(audit_options):
+    """Validate that the service uses Keystone for authentication."""
+    section = _config_section(audit_options, 'api') or _config_section(audit_options, 'DEFAULT')
+    assert section is not None, "Missing section 'api / DEFAULT'"
+    assert section.get('auth_strategy') == "keystone", \
+        "Application is not using Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_keystone(audit_options):
+    """Verify that TLS is used to communicate with Keystone."""
+    section = _config_section(audit_options, 'keystone_authtoken')
+    assert section is not None, "Missing section 'keystone_authtoken'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("auth_uri"), \
+        "TLS is not used for Keystone"
+
+
+@audit(is_audit_type(AuditType.OpenStackSecurityGuide))
+def validate_uses_tls_for_glance(audit_options):
+    """Verify that TLS is used to communicate with Glance."""
+    section = _config_section(audit_options, 'glance')
+    assert section is not None, "Missing section 'glance'"
+    assert not section.get('insecure') and \
+        "https://" in section.get("api_servers"), \
+        "TLS is not used for Glance"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/cert_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/cert_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b494af64aeae55db44b669990725de81705104b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/cert_utils.py
@@ -0,0 +1,289 @@
+# Copyright 2014-2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charm certificats.
+
+import os
+import json
+
+from charmhelpers.contrib.network.ip import (
+    get_hostname,
+    resolve_network_cidr,
+)
+from charmhelpers.core.hookenv import (
+    local_unit,
+    network_get_primary_address,
+    config,
+    related_units,
+    relation_get,
+    relation_ids,
+    unit_get,
+    NoNetworkBinding,
+    log,
+    WARNING,
+)
+from charmhelpers.contrib.openstack.ip import (
+    ADMIN,
+    resolve_address,
+    get_vip_in_network,
+    INTERNAL,
+    PUBLIC,
+    ADDRESS_MAP)
+
+from charmhelpers.core.host import (
+    mkdir,
+    write_file,
+)
+
+from charmhelpers.contrib.hahelpers.apache import (
+    install_ca_cert
+)
+
+
+class CertRequest(object):
+
+    """Create a request for certificates to be generated
+    """
+
+    def __init__(self, json_encode=True):
+        self.entries = []
+        self.hostname_entry = None
+        self.json_encode = json_encode
+
+    def add_entry(self, net_type, cn, addresses):
+        """Add a request to the batch
+
+        :param net_type: str netwrok space name request is for
+        :param cn: str Canonical Name for certificate
+        :param addresses: [] List of addresses to be used as SANs
+        """
+        self.entries.append({
+            'cn': cn,
+            'addresses': addresses})
+
+    def add_hostname_cn(self):
+        """Add a request for the hostname of the machine"""
+        ip = unit_get('private-address')
+        addresses = [ip]
+        # If a vip is being used without os-hostname config or
+        # network spaces then we need to ensure the local units
+        # cert has the approriate vip in the SAN list
+        vip = get_vip_in_network(resolve_network_cidr(ip))
+        if vip:
+            addresses.append(vip)
+        self.hostname_entry = {
+            'cn': get_hostname(ip),
+            'addresses': addresses}
+
+    def add_hostname_cn_ip(self, addresses):
+        """Add an address to the SAN list for the hostname request
+
+        :param addr: [] List of address to be added
+        """
+        for addr in addresses:
+            if addr not in self.hostname_entry['addresses']:
+                self.hostname_entry['addresses'].append(addr)
+
+    def get_request(self):
+        """Generate request from the batched up entries
+
+        """
+        if self.hostname_entry:
+            self.entries.append(self.hostname_entry)
+        request = {}
+        for entry in self.entries:
+            sans = sorted(list(set(entry['addresses'])))
+            request[entry['cn']] = {'sans': sans}
+        if self.json_encode:
+            req = {'cert_requests': json.dumps(request, sort_keys=True)}
+        else:
+            req = {'cert_requests': request}
+        req['unit_name'] = local_unit().replace('/', '_')
+        return req
+
+
+def get_certificate_request(json_encode=True):
+    """Generate a certificatee requests based on the network confioguration
+
+    """
+    req = CertRequest(json_encode=json_encode)
+    req.add_hostname_cn()
+    # Add os-hostname entries
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        net_config = config(ADDRESS_MAP[net_type]['override'])
+        try:
+            net_addr = resolve_address(endpoint_type=net_type)
+            ip = network_get_primary_address(
+                ADDRESS_MAP[net_type]['binding'])
+            addresses = [net_addr, ip]
+            vip = get_vip_in_network(resolve_network_cidr(ip))
+            if vip:
+                addresses.append(vip)
+            if net_config:
+                req.add_entry(
+                    net_type,
+                    net_config,
+                    addresses)
+            else:
+                # There is network address with no corresponding hostname.
+                # Add the ip to the hostname cert to allow for this.
+                req.add_hostname_cn_ip(addresses)
+        except NoNetworkBinding:
+            log("Skipping request for certificate for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    return req.get_request()
+
+
+def create_ip_cert_links(ssl_dir, custom_hostname_link=None):
+    """Create symlinks for SAN records
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param custom_hostname_link: str Additional link to be created
+    """
+    hostname = get_hostname(unit_get('private-address'))
+    hostname_cert = os.path.join(
+        ssl_dir,
+        'cert_{}'.format(hostname))
+    hostname_key = os.path.join(
+        ssl_dir,
+        'key_{}'.format(hostname))
+    # Add links to hostname cert, used if os-hostname vars not set
+    for net_type in [INTERNAL, ADMIN, PUBLIC]:
+        try:
+            addr = resolve_address(endpoint_type=net_type)
+            cert = os.path.join(ssl_dir, 'cert_{}'.format(addr))
+            key = os.path.join(ssl_dir, 'key_{}'.format(addr))
+            if os.path.isfile(hostname_cert) and not os.path.isfile(cert):
+                os.symlink(hostname_cert, cert)
+                os.symlink(hostname_key, key)
+        except NoNetworkBinding:
+            log("Skipping creating cert symlink for ip in {} space, no "
+                "local address found".format(net_type), WARNING)
+    if custom_hostname_link:
+        custom_cert = os.path.join(
+            ssl_dir,
+            'cert_{}'.format(custom_hostname_link))
+        custom_key = os.path.join(
+            ssl_dir,
+            'key_{}'.format(custom_hostname_link))
+        if os.path.isfile(hostname_cert) and not os.path.isfile(custom_cert):
+            os.symlink(hostname_cert, custom_cert)
+            os.symlink(hostname_key, custom_key)
+
+
+def install_certs(ssl_dir, certs, chain=None, user='root', group='root'):
+    """Install the certs passed into the ssl dir and append the chain if
+       provided.
+
+    :param ssl_dir: str Directory to create symlinks in
+    :param certs: {} {'cn': {'cert': 'CERT', 'key': 'KEY'}}
+    :param chain: str Chain to be appended to certs
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    """
+    for cn, bundle in certs.items():
+        cert_filename = 'cert_{}'.format(cn)
+        key_filename = 'key_{}'.format(cn)
+        cert_data = bundle['cert']
+        if chain:
+            # Append chain file so that clients that trust the root CA will
+            # trust certs signed by an intermediate in the chain
+            cert_data = cert_data + os.linesep + chain
+        write_file(
+            path=os.path.join(ssl_dir, cert_filename), owner=user, group=group,
+            content=cert_data, perms=0o640)
+        write_file(
+            path=os.path.join(ssl_dir, key_filename), owner=user, group=group,
+            content=bundle['key'], perms=0o640)
+
+
+def process_certificates(service_name, relation_id, unit,
+                         custom_hostname_link=None, user='root', group='root'):
+    """Process the certificates supplied down the relation
+
+    :param service_name: str Name of service the certifcates are for.
+    :param relation_id: str Relation id providing the certs
+    :param unit: str Unit providing the certs
+    :param custom_hostname_link: str Name of custom link to create
+    :param user: (Optional) Owner of certificate files. Defaults to 'root'
+    :type user: str
+    :param group: (Optional) Group of certificate files. Defaults to 'root'
+    :type group: str
+    :returns: True if certificates processed for local unit or False
+    :rtype: bool
+    """
+    data = relation_get(rid=relation_id, unit=unit)
+    ssl_dir = os.path.join('/etc/apache2/ssl/', service_name)
+    mkdir(path=ssl_dir)
+    name = local_unit().replace('/', '_')
+    certs = data.get('{}.processed_requests'.format(name))
+    chain = data.get('chain')
+    ca = data.get('ca')
+    if certs:
+        certs = json.loads(certs)
+        install_ca_cert(ca.encode())
+        install_certs(ssl_dir, certs, chain, user=user, group=group)
+        create_ip_cert_links(
+            ssl_dir,
+            custom_hostname_link=custom_hostname_link)
+        return True
+    return False
+
+
+def get_requests_for_local_unit(relation_name=None):
+    """Extract any certificates data targeted at this unit down relation_name.
+
+    :param relation_name: str Name of relation to check for data.
+    :returns: List of bundles of certificates.
+    :rtype: List of dicts
+    """
+    local_name = local_unit().replace('/', '_')
+    raw_certs_key = '{}.processed_requests'.format(local_name)
+    relation_name = relation_name or 'certificates'
+    bundles = []
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            data = relation_get(rid=rid, unit=unit)
+            if data.get(raw_certs_key):
+                bundles.append({
+                    'ca': data['ca'],
+                    'chain': data.get('chain'),
+                    'certs': json.loads(data[raw_certs_key])})
+    return bundles
+
+
+def get_bundle_for_cn(cn, relation_name=None):
+    """Extract certificates for the given cn.
+
+    :param cn: str Canonical Name on certificate.
+    :param relation_name: str Relation to check for certificates down.
+    :returns: Dictionary of certificate data,
+    :rtype: dict.
+    """
+    entries = get_requests_for_local_unit(relation_name)
+    cert_bundle = {}
+    for entry in entries:
+        for _cn, bundle in entry['certs'].items():
+            if _cn == cn:
+                cert_bundle = {
+                    'cert': bundle['cert'],
+                    'key': bundle['key'],
+                    'chain': entry['chain'],
+                    'ca': entry['ca']}
+                break
+        if cert_bundle:
+            break
+    return cert_bundle
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/context.py
new file mode 100644
index 0000000000000000000000000000000000000000..42abccf7cb9eabc063bc8d87f016e59f4dc8f898
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/context.py
@@ -0,0 +1,3177 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import copy
+import enum
+import glob
+import hashlib
+import json
+import math
+import os
+import re
+import socket
+import time
+
+from base64 import b64decode
+from subprocess import check_call, CalledProcessError
+
+import six
+
+from charmhelpers.contrib.openstack.audits.openstack_security_guide import (
+    _config_ini as config_ini
+)
+
+from charmhelpers.fetch import (
+    apt_install,
+    filter_installed_packages,
+)
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    is_relation_made,
+    local_unit,
+    log,
+    relation_get,
+    relation_ids,
+    related_units,
+    relation_set,
+    unit_get,
+    unit_private_ip,
+    charm_name,
+    DEBUG,
+    INFO,
+    ERROR,
+    status_set,
+    network_get_primary_address,
+    WARNING,
+)
+
+from charmhelpers.core.sysctl import create as sysctl_create
+from charmhelpers.core.strutils import bool_from_string
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+
+from charmhelpers.core.host import (
+    get_bond_master,
+    is_phy_iface,
+    list_nics,
+    get_nic_hwaddr,
+    mkdir,
+    write_file,
+    pwgen,
+    lsb_release,
+    CompareHostReleases,
+    is_container,
+)
+from charmhelpers.contrib.hahelpers.cluster import (
+    determine_apache_port,
+    determine_api_port,
+    https,
+    is_clustered,
+)
+from charmhelpers.contrib.hahelpers.apache import (
+    get_cert,
+    get_ca_cert,
+    install_ca_cert,
+)
+from charmhelpers.contrib.openstack.neutron import (
+    neutron_plugin_attribute,
+    parse_data_port_mappings,
+)
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    INTERNAL,
+    ADMIN,
+    PUBLIC,
+    ADDRESS_MAP,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    get_ipv4_addr,
+    get_ipv6_addr,
+    get_netmask_for_address,
+    format_ipv6_addr,
+    is_bridge_member,
+    is_ipv6_disabled,
+    get_relation_ip,
+)
+from charmhelpers.contrib.openstack.utils import (
+    config_flags_parser,
+    get_os_codename_install_source,
+    enable_memcache,
+    CompareOpenStackReleases,
+    os_release,
+)
+from charmhelpers.core.unitdata import kv
+
+try:
+    from sriov_netplan_shim import pci
+except ImportError:
+    # The use of the function and contexts that require the pci module is
+    # optional.
+    pass
+
+try:
+    import psutil
+except ImportError:
+    if six.PY2:
+        apt_install('python-psutil', fatal=True)
+    else:
+        apt_install('python3-psutil', fatal=True)
+    import psutil
+
+CA_CERT_PATH = '/usr/local/share/ca-certificates/keystone_juju_ca_cert.crt'
+ADDRESS_TYPES = ['admin', 'internal', 'public']
+HAPROXY_RUN_DIR = '/var/run/haproxy/'
+DEFAULT_OSLO_MESSAGING_DRIVER = "messagingv2"
+
+
+def ensure_packages(packages):
+    """Install but do not upgrade required plugin packages."""
+    required = filter_installed_packages(packages)
+    if required:
+        apt_install(required, fatal=True)
+
+
+def context_complete(ctxt):
+    _missing = []
+    for k, v in six.iteritems(ctxt):
+        if v is None or v == '':
+            _missing.append(k)
+
+    if _missing:
+        log('Missing required data: %s' % ' '.join(_missing), level=INFO)
+        return False
+
+    return True
+
+
+class OSContextGenerator(object):
+    """Base class for all context generators."""
+    interfaces = []
+    related = False
+    complete = False
+    missing_data = []
+
+    def __call__(self):
+        raise NotImplementedError
+
+    def context_complete(self, ctxt):
+        """Check for missing data for the required context data.
+        Set self.missing_data if it exists and return False.
+        Set self.complete if no missing data and return True.
+        """
+        # Fresh start
+        self.complete = False
+        self.missing_data = []
+        for k, v in six.iteritems(ctxt):
+            if v is None or v == '':
+                if k not in self.missing_data:
+                    self.missing_data.append(k)
+
+        if self.missing_data:
+            self.complete = False
+            log('Missing required data: %s' % ' '.join(self.missing_data),
+                level=INFO)
+        else:
+            self.complete = True
+        return self.complete
+
+    def get_related(self):
+        """Check if any of the context interfaces have relation ids.
+        Set self.related and return True if one of the interfaces
+        has relation ids.
+        """
+        # Fresh start
+        self.related = False
+        try:
+            for interface in self.interfaces:
+                if relation_ids(interface):
+                    self.related = True
+            return self.related
+        except AttributeError as e:
+            log("{} {}"
+                "".format(self, e), 'INFO')
+            return self.related
+
+
+class SharedDBContext(OSContextGenerator):
+    interfaces = ['shared-db']
+
+    def __init__(self, database=None, user=None, relation_prefix=None,
+                 ssl_dir=None, relation_id=None):
+        """Allows inspecting relation for settings prefixed with
+        relation_prefix. This is useful for parsing access for multiple
+        databases returned via the shared-db interface (eg, nova_password,
+        quantum_password)
+        """
+        self.relation_prefix = relation_prefix
+        self.database = database
+        self.user = user
+        self.ssl_dir = ssl_dir
+        self.rel_name = self.interfaces[0]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        self.user = self.user or config('database-user')
+        if None in [self.database, self.user]:
+            log("Could not generate shared_db context. Missing required charm "
+                "config options. (database name and user)", level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+
+        # NOTE(jamespage) if mysql charm provides a network upon which
+        # access to the database should be made, reconfigure relation
+        # with the service units local address and defer execution
+        access_network = relation_get('access-network')
+        if access_network is not None:
+            if self.relation_prefix is not None:
+                hostname_key = "{}_hostname".format(self.relation_prefix)
+            else:
+                hostname_key = "hostname"
+            access_hostname = get_address_in_network(
+                access_network,
+                unit_get('private-address'))
+            set_hostname = relation_get(attribute=hostname_key,
+                                        unit=local_unit())
+            if set_hostname != access_hostname:
+                relation_set(relation_settings={hostname_key: access_hostname})
+                return None  # Defer any further hook execution for now....
+
+        password_setting = 'password'
+        if self.relation_prefix:
+            password_setting = self.relation_prefix + '_password'
+
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.interfaces[0])
+
+        rel = (get_os_codename_install_source(config('openstack-origin')) or
+               'icehouse')
+        for rid in rids:
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                host = rdata.get('db_host')
+                host = format_ipv6_addr(host) or host
+                ctxt = {
+                    'database_host': host,
+                    'database': self.database,
+                    'database_user': self.user,
+                    'database_password': rdata.get(password_setting),
+                    'database_type': 'mysql+pymysql'
+                }
+                # Port is being introduced with LP Bug #1876188
+                # but it not currently required and may not be set in all
+                # cases, particularly in classic charms.
+                port = rdata.get('db_port')
+                if port:
+                    ctxt['database_port'] = port
+                if CompareOpenStackReleases(rel) < 'queens':
+                    ctxt['database_type'] = 'mysql'
+                if self.context_complete(ctxt):
+                    db_ssl(rdata, ctxt, self.ssl_dir)
+                    return ctxt
+        return {}
+
+
+class PostgresqlDBContext(OSContextGenerator):
+    interfaces = ['pgsql-db']
+
+    def __init__(self, database=None):
+        self.database = database
+
+    def __call__(self):
+        self.database = self.database or config('database')
+        if self.database is None:
+            log('Could not generate postgresql_db context. Missing required '
+                'charm config options. (database name)', level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        for rid in relation_ids(self.interfaces[0]):
+            self.related = True
+            for unit in related_units(rid):
+                rel_host = relation_get('host', rid=rid, unit=unit)
+                rel_user = relation_get('user', rid=rid, unit=unit)
+                rel_passwd = relation_get('password', rid=rid, unit=unit)
+                ctxt = {'database_host': rel_host,
+                        'database': self.database,
+                        'database_user': rel_user,
+                        'database_password': rel_passwd,
+                        'database_type': 'postgresql'}
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+def db_ssl(rdata, ctxt, ssl_dir):
+    if 'ssl_ca' in rdata and ssl_dir:
+        ca_path = os.path.join(ssl_dir, 'db-client.ca')
+        with open(ca_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_ca']))
+
+        ctxt['database_ssl_ca'] = ca_path
+    elif 'ssl_ca' in rdata:
+        log("Charm not setup for ssl support but ssl ca found", level=INFO)
+        return ctxt
+
+    if 'ssl_cert' in rdata:
+        cert_path = os.path.join(
+            ssl_dir, 'db-client.cert')
+        if not os.path.exists(cert_path):
+            log("Waiting 1m for ssl client cert validity", level=INFO)
+            time.sleep(60)
+
+        with open(cert_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_cert']))
+
+        ctxt['database_ssl_cert'] = cert_path
+        key_path = os.path.join(ssl_dir, 'db-client.key')
+        with open(key_path, 'wb') as fh:
+            fh.write(b64decode(rdata['ssl_key']))
+
+        ctxt['database_ssl_key'] = key_path
+
+    return ctxt
+
+
+class IdentityServiceContext(OSContextGenerator):
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-service'):
+        self.service = service
+        self.service_user = service_user
+        self.rel_name = rel_name
+        self.interfaces = [self.rel_name]
+
+    def _setup_pki_cache(self):
+        if self.service and self.service_user:
+            # This is required for pki token signing if we don't want /tmp to
+            # be used.
+            cachedir = '/var/cache/%s' % (self.service)
+            if not os.path.isdir(cachedir):
+                log("Creating service cache dir %s" % (cachedir), level=DEBUG)
+                mkdir(path=cachedir, owner=self.service_user,
+                      group=self.service_user, perms=0o700)
+
+            return cachedir
+        return None
+
+    def _get_pkg_name(self, python_name='keystonemiddleware'):
+        """Get corresponding distro installed package for python
+        package name.
+
+        :param python_name: nameof the python package
+        :type: string
+        """
+        pkg_names = map(lambda x: x + python_name, ('python3-', 'python-'))
+
+        for pkg in pkg_names:
+            if not filter_installed_packages((pkg,)):
+                return pkg
+
+        return None
+
+    def _get_keystone_authtoken_ctxt(self, ctxt, keystonemiddleware_os_rel):
+        """Build Jinja2 context for full rendering of [keystone_authtoken]
+        section with variable names included. Re-constructed from former
+        template 'section-keystone-auth-mitaka'.
+
+        :param ctxt: Jinja2 context returned from self.__call__()
+        :type: dict
+        :param keystonemiddleware_os_rel: OpenStack release name of
+            keystonemiddleware package installed
+        """
+        c = collections.OrderedDict((('auth_type', 'password'),))
+
+        # 'www_authenticate_uri' replaced 'auth_uri' since Stein,
+        # see keystonemiddleware upstream sources for more info
+        if CompareOpenStackReleases(keystonemiddleware_os_rel) >= 'stein':
+            c.update((
+                ('www_authenticate_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+        else:
+            c.update((
+                ('auth_uri', "{}://{}:{}/v3".format(
+                    ctxt.get('service_protocol', ''),
+                    ctxt.get('service_host', ''),
+                    ctxt.get('service_port', ''))),))
+
+        c.update((
+            ('auth_url', "{}://{}:{}/v3".format(
+                ctxt.get('auth_protocol', ''),
+                ctxt.get('auth_host', ''),
+                ctxt.get('auth_port', ''))),
+            ('project_domain_name', ctxt.get('admin_domain_name', '')),
+            ('user_domain_name', ctxt.get('admin_domain_name', '')),
+            ('project_name', ctxt.get('admin_tenant_name', '')),
+            ('username', ctxt.get('admin_user', '')),
+            ('password', ctxt.get('admin_password', '')),
+            ('signing_dir', ctxt.get('signing_dir', '')),))
+
+        return c
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        keystonemiddleware_os_release = None
+        if self._get_pkg_name():
+            keystonemiddleware_os_release = os_release(self._get_pkg_name())
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                serv_host = rdata.get('service_host')
+                serv_host = format_ipv6_addr(serv_host) or serv_host
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('service_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({'service_port': rdata.get('service_port'),
+                             'service_host': serv_host,
+                             'auth_host': auth_host,
+                             'auth_port': rdata.get('auth_port'),
+                             'admin_tenant_name': rdata.get('service_tenant'),
+                             'admin_user': rdata.get('service_username'),
+                             'admin_password': rdata.get('service_password'),
+                             'service_protocol': svc_protocol,
+                             'auth_protocol': auth_protocol,
+                             'api_version': api_version})
+
+                if float(api_version) > 2:
+                    ctxt.update({
+                        'admin_domain_name': rdata.get('service_domain'),
+                        'service_project_id': rdata.get('service_tenant_id'),
+                        'service_domain_id': rdata.get('service_domain_id')})
+
+                # we keep all veriables in ctxt for compatibility and
+                # add nested dictionary for keystone_authtoken generic
+                # templating
+                if keystonemiddleware_os_release:
+                    ctxt['keystone_authtoken'] = \
+                        self._get_keystone_authtoken_ctxt(
+                            ctxt, keystonemiddleware_os_release)
+
+                if self.context_complete(ctxt):
+                    # NOTE(jamespage) this is required for >= icehouse
+                    # so a missing value just indicates keystone needs
+                    # upgrading
+                    ctxt['admin_tenant_id'] = rdata.get('service_tenant_id')
+                    ctxt['admin_domain_id'] = rdata.get('service_domain_id')
+                    return ctxt
+
+        return {}
+
+
+class IdentityCredentialsContext(IdentityServiceContext):
+    '''Context for identity-credentials interface type'''
+
+    def __init__(self,
+                 service=None,
+                 service_user=None,
+                 rel_name='identity-credentials'):
+        super(IdentityCredentialsContext, self).__init__(service,
+                                                         service_user,
+                                                         rel_name)
+
+    def __call__(self):
+        log('Generating template context for ' + self.rel_name, level=DEBUG)
+        ctxt = {}
+
+        cachedir = self._setup_pki_cache()
+        if cachedir:
+            ctxt['signing_dir'] = cachedir
+
+        for rid in relation_ids(self.rel_name):
+            self.related = True
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                credentials_host = rdata.get('credentials_host')
+                credentials_host = (
+                    format_ipv6_addr(credentials_host) or credentials_host
+                )
+                auth_host = rdata.get('auth_host')
+                auth_host = format_ipv6_addr(auth_host) or auth_host
+                svc_protocol = rdata.get('credentials_protocol') or 'http'
+                auth_protocol = rdata.get('auth_protocol') or 'http'
+                api_version = rdata.get('api_version') or '2.0'
+                ctxt.update({
+                    'service_port': rdata.get('credentials_port'),
+                    'service_host': credentials_host,
+                    'auth_host': auth_host,
+                    'auth_port': rdata.get('auth_port'),
+                    'admin_tenant_name': rdata.get('credentials_project'),
+                    'admin_tenant_id': rdata.get('credentials_project_id'),
+                    'admin_user': rdata.get('credentials_username'),
+                    'admin_password': rdata.get('credentials_password'),
+                    'service_protocol': svc_protocol,
+                    'auth_protocol': auth_protocol,
+                    'api_version': api_version
+                })
+
+                if float(api_version) > 2:
+                    ctxt.update({'admin_domain_name':
+                                 rdata.get('domain')})
+
+                if self.context_complete(ctxt):
+                    return ctxt
+
+        return {}
+
+
+class NovaVendorMetadataContext(OSContextGenerator):
+    """Context used for configuring nova vendor metadata on nova.conf file."""
+
+    def __init__(self, os_release_pkg, interfaces=None):
+        """Initialize the NovaVendorMetadataContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        :param interfaces: list of string values to be used as the Context's
+            relation interfaces.
+        :type interfaces: List[str]
+        """
+        self.os_release_pkg = os_release_pkg
+        if interfaces is not None:
+            self.interfaces = interfaces
+
+    def __call__(self):
+        cmp_os_release = CompareOpenStackReleases(
+            os_release(self.os_release_pkg))
+        ctxt = {'vendor_data': False}
+
+        vdata_providers = []
+        vdata = config('vendor-data')
+        vdata_url = config('vendor-data-url')
+
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we do not set anything here
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data'] = True
+                # Mitaka does not support DynamicJSON
+                # so vendordata_providers is not needed
+                if cmp_os_release > 'mitaka':
+                    vdata_providers.append('StaticJSON')
+
+        if vdata_url:
+            if cmp_os_release > 'mitaka':
+                ctxt['vendor_data_url'] = vdata_url
+                vdata_providers.append('DynamicJSON')
+            else:
+                log('Dynamic vendor data unsupported'
+                    ' for {}.'.format(cmp_os_release), level=ERROR)
+        if vdata_providers:
+            ctxt['vendordata_providers'] = ','.join(vdata_providers)
+
+        return ctxt
+
+
+class NovaVendorMetadataJSONContext(OSContextGenerator):
+    """Context used for writing nova vendor metadata json file."""
+
+    def __init__(self, os_release_pkg):
+        """Initialize the NovaVendorMetadataJSONContext object.
+
+        :param os_release_pkg: the package name to extract the OpenStack
+            release codename from.
+        :type os_release_pkg: str
+        """
+        self.os_release_pkg = os_release_pkg
+
+    def __call__(self):
+        ctxt = {'vendor_data_json': '{}'}
+
+        vdata = config('vendor-data')
+        if vdata:
+            try:
+                # validate the JSON. If invalid, we return empty.
+                json.loads(vdata)
+            except (TypeError, ValueError) as e:
+                log('Error decoding vendor-data. {}'.format(e), level=ERROR)
+            else:
+                ctxt['vendor_data_json'] = vdata
+
+        return ctxt
+
+
+class AMQPContext(OSContextGenerator):
+
+    def __init__(self, ssl_dir=None, rel_name='amqp', relation_prefix=None,
+                 relation_id=None):
+        self.ssl_dir = ssl_dir
+        self.rel_name = rel_name
+        self.relation_prefix = relation_prefix
+        self.interfaces = [rel_name]
+        self.relation_id = relation_id
+
+    def __call__(self):
+        log('Generating template context for amqp', level=DEBUG)
+        conf = config()
+        if self.relation_prefix:
+            user_setting = '%s-rabbit-user' % (self.relation_prefix)
+            vhost_setting = '%s-rabbit-vhost' % (self.relation_prefix)
+        else:
+            user_setting = 'rabbit-user'
+            vhost_setting = 'rabbit-vhost'
+
+        try:
+            username = conf[user_setting]
+            vhost = conf[vhost_setting]
+        except KeyError as e:
+            log('Could not generate shared_db context. Missing required charm '
+                'config options: %s.' % e, level=ERROR)
+            raise OSContextError
+
+        ctxt = {}
+        if self.relation_id:
+            rids = [self.relation_id]
+        else:
+            rids = relation_ids(self.rel_name)
+        for rid in rids:
+            ha_vip_only = False
+            self.related = True
+            transport_hosts = None
+            rabbitmq_port = '5672'
+            for unit in related_units(rid):
+                if relation_get('clustered', rid=rid, unit=unit):
+                    ctxt['clustered'] = True
+                    vip = relation_get('vip', rid=rid, unit=unit)
+                    vip = format_ipv6_addr(vip) or vip
+                    ctxt['rabbitmq_host'] = vip
+                    transport_hosts = [vip]
+                else:
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    host = format_ipv6_addr(host) or host
+                    ctxt['rabbitmq_host'] = host
+                    transport_hosts = [host]
+
+                ctxt.update({
+                    'rabbitmq_user': username,
+                    'rabbitmq_password': relation_get('password', rid=rid,
+                                                      unit=unit),
+                    'rabbitmq_virtual_host': vhost,
+                })
+
+                ssl_port = relation_get('ssl_port', rid=rid, unit=unit)
+                if ssl_port:
+                    ctxt['rabbit_ssl_port'] = ssl_port
+                    rabbitmq_port = ssl_port
+
+                ssl_ca = relation_get('ssl_ca', rid=rid, unit=unit)
+                if ssl_ca:
+                    ctxt['rabbit_ssl_ca'] = ssl_ca
+
+                if relation_get('ha_queues', rid=rid, unit=unit) is not None:
+                    ctxt['rabbitmq_ha_queues'] = True
+
+                ha_vip_only = relation_get('ha-vip-only',
+                                           rid=rid, unit=unit) is not None
+
+                if self.context_complete(ctxt):
+                    if 'rabbit_ssl_ca' in ctxt:
+                        if not self.ssl_dir:
+                            log("Charm not setup for ssl support but ssl ca "
+                                "found", level=INFO)
+                            break
+
+                        ca_path = os.path.join(
+                            self.ssl_dir, 'rabbit-client-ca.pem')
+                        with open(ca_path, 'wb') as fh:
+                            fh.write(b64decode(ctxt['rabbit_ssl_ca']))
+                            ctxt['rabbit_ssl_ca'] = ca_path
+
+                    # Sufficient information found = break out!
+                    break
+
+            # Used for active/active rabbitmq >= grizzly
+            if (('clustered' not in ctxt or ha_vip_only) and
+                    len(related_units(rid)) > 1):
+                rabbitmq_hosts = []
+                for unit in related_units(rid):
+                    host = relation_get('private-address', rid=rid, unit=unit)
+                    if not relation_get('password', rid=rid, unit=unit):
+                        log(
+                            ("Skipping {} password not sent which indicates "
+                             "unit is not ready.".format(host)),
+                            level=DEBUG)
+                        continue
+                    host = format_ipv6_addr(host) or host
+                    rabbitmq_hosts.append(host)
+
+                rabbitmq_hosts = sorted(rabbitmq_hosts)
+                ctxt['rabbitmq_hosts'] = ','.join(rabbitmq_hosts)
+                transport_hosts = rabbitmq_hosts
+
+            if transport_hosts:
+                transport_url_hosts = ','.join([
+                    "{}:{}@{}:{}".format(ctxt['rabbitmq_user'],
+                                         ctxt['rabbitmq_password'],
+                                         host_,
+                                         rabbitmq_port)
+                    for host_ in transport_hosts])
+                ctxt['transport_url'] = "rabbit://{}/{}".format(
+                    transport_url_hosts, vhost)
+
+        oslo_messaging_flags = conf.get('oslo-messaging-flags', None)
+        if oslo_messaging_flags:
+            ctxt['oslo_messaging_flags'] = config_flags_parser(
+                oslo_messaging_flags)
+
+        oslo_messaging_driver = conf.get(
+            'oslo-messaging-driver', DEFAULT_OSLO_MESSAGING_DRIVER)
+        if oslo_messaging_driver:
+            ctxt['oslo_messaging_driver'] = oslo_messaging_driver
+
+        notification_format = conf.get('notification-format', None)
+        if notification_format:
+            ctxt['notification_format'] = notification_format
+
+        notification_topics = conf.get('notification-topics', None)
+        if notification_topics:
+            ctxt['notification_topics'] = notification_topics
+
+        send_notifications_to_logs = conf.get('send-notifications-to-logs', None)
+        if send_notifications_to_logs:
+            ctxt['send_notifications_to_logs'] = send_notifications_to_logs
+
+        if not self.complete:
+            return {}
+
+        return ctxt
+
+
+class CephContext(OSContextGenerator):
+    """Generates context for /etc/ceph/ceph.conf templates."""
+    interfaces = ['ceph']
+
+    def __call__(self):
+        if not relation_ids('ceph'):
+            return {}
+
+        log('Generating template context for ceph', level=DEBUG)
+        mon_hosts = []
+        ctxt = {
+            'use_syslog': str(config('use-syslog')).lower()
+        }
+        for rid in relation_ids('ceph'):
+            for unit in related_units(rid):
+                if not ctxt.get('auth'):
+                    ctxt['auth'] = relation_get('auth', rid=rid, unit=unit)
+                if not ctxt.get('key'):
+                    ctxt['key'] = relation_get('key', rid=rid, unit=unit)
+                if not ctxt.get('rbd_features'):
+                    default_features = relation_get('rbd-features', rid=rid, unit=unit)
+                    if default_features is not None:
+                        ctxt['rbd_features'] = default_features
+
+                ceph_addrs = relation_get('ceph-public-address', rid=rid,
+                                          unit=unit)
+                if ceph_addrs:
+                    for addr in ceph_addrs.split(' '):
+                        mon_hosts.append(format_ipv6_addr(addr) or addr)
+                else:
+                    priv_addr = relation_get('private-address', rid=rid,
+                                             unit=unit)
+                    mon_hosts.append(format_ipv6_addr(priv_addr) or priv_addr)
+
+        ctxt['mon_hosts'] = ' '.join(sorted(mon_hosts))
+
+        if not os.path.isdir('/etc/ceph'):
+            os.mkdir('/etc/ceph')
+
+        if not self.context_complete(ctxt):
+            return {}
+
+        ensure_packages(['ceph-common'])
+        return ctxt
+
+    def context_complete(self, ctxt):
+        """Overridden here to ensure the context is actually complete.
+
+        We set `key` and `auth` to None here, by default, to ensure
+        that the context will always evaluate to incomplete until the
+        Ceph relation has actually sent these details; otherwise,
+        there is a potential race condition between the relation
+        appearing and the first unit actually setting this data on the
+        relation.
+
+        :param ctxt: The current context members
+        :type ctxt: Dict[str, ANY]
+        :returns: True if the context is complete
+        :rtype: bool
+        """
+        if 'auth' not in ctxt or 'key' not in ctxt:
+            return False
+        return super(CephContext, self).context_complete(ctxt)
+
+
+class HAProxyContext(OSContextGenerator):
+    """Provides half a context for the haproxy template, which describes
+    all peers to be included in the cluster.  Each charm needs to include
+    its own context generator that describes the port mapping.
+
+    :side effect: mkdir is called on HAPROXY_RUN_DIR
+    """
+    interfaces = ['cluster']
+
+    def __init__(self, singlenode_mode=False,
+                 address_types=ADDRESS_TYPES):
+        self.address_types = address_types
+        self.singlenode_mode = singlenode_mode
+
+    def __call__(self):
+        if not os.path.isdir(HAPROXY_RUN_DIR):
+            mkdir(path=HAPROXY_RUN_DIR)
+        if not relation_ids('cluster') and not self.singlenode_mode:
+            return {}
+
+        l_unit = local_unit().replace('/', '-')
+        cluster_hosts = collections.OrderedDict()
+
+        # NOTE(jamespage): build out map of configured network endpoints
+        # and associated backends
+        for addr_type in self.address_types:
+            cfg_opt = 'os-{}-network'.format(addr_type)
+            # NOTE(thedac) For some reason the ADDRESS_MAP uses 'int' rather
+            # than 'internal'
+            if addr_type == 'internal':
+                _addr_map_type = INTERNAL
+            else:
+                _addr_map_type = addr_type
+            # Network spaces aware
+            laddr = get_relation_ip(ADDRESS_MAP[_addr_map_type]['binding'],
+                                    config(cfg_opt))
+            if laddr:
+                netmask = get_netmask_for_address(laddr)
+                cluster_hosts[laddr] = {
+                    'network': "{}/{}".format(laddr,
+                                              netmask),
+                    'backends': collections.OrderedDict([(l_unit,
+                                                          laddr)])
+                }
+                for rid in relation_ids('cluster'):
+                    for unit in sorted(related_units(rid)):
+                        # API Charms will need to set {addr_type}-address with
+                        # get_relation_ip(addr_type)
+                        _laddr = relation_get('{}-address'.format(addr_type),
+                                              rid=rid, unit=unit)
+                        if _laddr:
+                            _unit = unit.replace('/', '-')
+                            cluster_hosts[laddr]['backends'][_unit] = _laddr
+
+        # NOTE(jamespage) add backend based on get_relation_ip - this
+        # will either be the only backend or the fallback if no acls
+        # match in the frontend
+        # Network spaces aware
+        addr = get_relation_ip('cluster')
+        cluster_hosts[addr] = {}
+        netmask = get_netmask_for_address(addr)
+        cluster_hosts[addr] = {
+            'network': "{}/{}".format(addr, netmask),
+            'backends': collections.OrderedDict([(l_unit,
+                                                  addr)])
+        }
+        for rid in relation_ids('cluster'):
+            for unit in sorted(related_units(rid)):
+                # API Charms will need to set their private-address with
+                # get_relation_ip('cluster')
+                _laddr = relation_get('private-address',
+                                      rid=rid, unit=unit)
+                if _laddr:
+                    _unit = unit.replace('/', '-')
+                    cluster_hosts[addr]['backends'][_unit] = _laddr
+
+        ctxt = {
+            'frontends': cluster_hosts,
+            'default_backend': addr
+        }
+
+        if config('haproxy-server-timeout'):
+            ctxt['haproxy_server_timeout'] = config('haproxy-server-timeout')
+
+        if config('haproxy-client-timeout'):
+            ctxt['haproxy_client_timeout'] = config('haproxy-client-timeout')
+
+        if config('haproxy-queue-timeout'):
+            ctxt['haproxy_queue_timeout'] = config('haproxy-queue-timeout')
+
+        if config('haproxy-connect-timeout'):
+            ctxt['haproxy_connect_timeout'] = config('haproxy-connect-timeout')
+
+        if config('prefer-ipv6'):
+            ctxt['local_host'] = 'ip6-localhost'
+            ctxt['haproxy_host'] = '::'
+        else:
+            ctxt['local_host'] = '127.0.0.1'
+            ctxt['haproxy_host'] = '0.0.0.0'
+
+        ctxt['ipv6_enabled'] = not is_ipv6_disabled()
+
+        ctxt['stat_port'] = '8888'
+
+        db = kv()
+        ctxt['stat_password'] = db.get('stat-password')
+        if not ctxt['stat_password']:
+            ctxt['stat_password'] = db.set('stat-password',
+                                           pwgen(32))
+            db.flush()
+
+        for frontend in cluster_hosts:
+            if (len(cluster_hosts[frontend]['backends']) > 1 or
+                    self.singlenode_mode):
+                # Enable haproxy when we have enough peers.
+                log('Ensuring haproxy enabled in /etc/default/haproxy.',
+                    level=DEBUG)
+                with open('/etc/default/haproxy', 'w') as out:
+                    out.write('ENABLED=1\n')
+
+                return ctxt
+
+        log('HAProxy context is incomplete, this unit has no peers.',
+            level=INFO)
+        return {}
+
+
+class ImageServiceContext(OSContextGenerator):
+    interfaces = ['image-service']
+
+    def __call__(self):
+        """Obtains the glance API server from the image-service relation.
+        Useful in nova and cinder (currently).
+        """
+        log('Generating template context for image-service.', level=DEBUG)
+        rids = relation_ids('image-service')
+        if not rids:
+            return {}
+
+        for rid in rids:
+            for unit in related_units(rid):
+                api_server = relation_get('glance-api-server',
+                                          rid=rid, unit=unit)
+                if api_server:
+                    return {'glance_api_servers': api_server}
+
+        log("ImageService context is incomplete. Missing required relation "
+            "data.", level=INFO)
+        return {}
+
+
+class ApacheSSLContext(OSContextGenerator):
+    """Generates a context for an apache vhost configuration that configures
+    HTTPS reverse proxying for one or many endpoints.  Generated context
+    looks something like::
+
+        {
+            'namespace': 'cinder',
+            'private_address': 'iscsi.mycinderhost.com',
+            'endpoints': [(8776, 8766), (8777, 8767)]
+        }
+
+    The endpoints list consists of a tuples mapping external ports
+    to internal ports.
+    """
+    interfaces = ['https']
+
+    # charms should inherit this context and set external ports
+    # and service namespace accordingly.
+    external_ports = []
+    service_namespace = None
+    user = group = 'root'
+
+    def enable_modules(self):
+        cmd = ['a2enmod', 'ssl', 'proxy', 'proxy_http', 'headers']
+        check_call(cmd)
+
+    def configure_cert(self, cn=None):
+        ssl_dir = os.path.join('/etc/apache2/ssl/', self.service_namespace)
+        mkdir(path=ssl_dir)
+        cert, key = get_cert(cn)
+        if cert and key:
+            if cn:
+                cert_filename = 'cert_{}'.format(cn)
+                key_filename = 'key_{}'.format(cn)
+            else:
+                cert_filename = 'cert'
+                key_filename = 'key'
+
+            write_file(path=os.path.join(ssl_dir, cert_filename),
+                       content=b64decode(cert), owner=self.user,
+                       group=self.group, perms=0o640)
+            write_file(path=os.path.join(ssl_dir, key_filename),
+                       content=b64decode(key), owner=self.user,
+                       group=self.group, perms=0o640)
+
+    def configure_ca(self):
+        ca_cert = get_ca_cert()
+        if ca_cert:
+            install_ca_cert(b64decode(ca_cert))
+
+    def canonical_names(self):
+        """Figure out which canonical names clients will access this service.
+        """
+        cns = []
+        for r_id in relation_ids('identity-service'):
+            for unit in related_units(r_id):
+                rdata = relation_get(rid=r_id, unit=unit)
+                for k in rdata:
+                    if k.startswith('ssl_key_'):
+                        cns.append(k.lstrip('ssl_key_'))
+
+        return sorted(list(set(cns)))
+
+    def get_network_addresses(self):
+        """For each network configured, return corresponding address and
+           hostnamr or vip (if available).
+
+        Returns a list of tuples of the form:
+
+            [(address_in_net_a, hostname_in_net_a),
+             (address_in_net_b, hostname_in_net_b),
+             ...]
+
+            or, if no hostnames(s) available:
+
+            [(address_in_net_a, vip_in_net_a),
+             (address_in_net_b, vip_in_net_b),
+             ...]
+
+            or, if no vip(s) available:
+
+            [(address_in_net_a, address_in_net_a),
+             (address_in_net_b, address_in_net_b),
+             ...]
+        """
+        addresses = []
+        for net_type in [INTERNAL, ADMIN, PUBLIC]:
+            net_config = config(ADDRESS_MAP[net_type]['config'])
+            # NOTE(jamespage): Fallback must always be private address
+            #                  as this is used to bind services on the
+            #                  local unit.
+            fallback = unit_get("private-address")
+            if net_config:
+                addr = get_address_in_network(net_config,
+                                              fallback)
+            else:
+                try:
+                    addr = network_get_primary_address(
+                        ADDRESS_MAP[net_type]['binding']
+                    )
+                except (NotImplementedError, NoNetworkBinding):
+                    addr = fallback
+
+            endpoint = resolve_address(net_type)
+            addresses.append((addr, endpoint))
+
+        return sorted(set(addresses))
+
+    def __call__(self):
+        if isinstance(self.external_ports, six.string_types):
+            self.external_ports = [self.external_ports]
+
+        if not self.external_ports or not https():
+            return {}
+
+        use_keystone_ca = True
+        for rid in relation_ids('certificates'):
+            if related_units(rid):
+                use_keystone_ca = False
+
+        if use_keystone_ca:
+            self.configure_ca()
+
+        self.enable_modules()
+
+        ctxt = {'namespace': self.service_namespace,
+                'endpoints': [],
+                'ext_ports': []}
+
+        if use_keystone_ca:
+            cns = self.canonical_names()
+            if cns:
+                for cn in cns:
+                    self.configure_cert(cn)
+            else:
+                # Expect cert/key provided in config (currently assumed that ca
+                # uses ip for cn)
+                for net_type in (INTERNAL, ADMIN, PUBLIC):
+                    cn = resolve_address(endpoint_type=net_type)
+                    self.configure_cert(cn)
+
+        addresses = self.get_network_addresses()
+        for address, endpoint in addresses:
+            for api_port in self.external_ports:
+                ext_port = determine_apache_port(api_port,
+                                                 singlenode_mode=True)
+                int_port = determine_api_port(api_port, singlenode_mode=True)
+                portmap = (address, endpoint, int(ext_port), int(int_port))
+                ctxt['endpoints'].append(portmap)
+                ctxt['ext_ports'].append(int(ext_port))
+
+        ctxt['ext_ports'] = sorted(list(set(ctxt['ext_ports'])))
+        return ctxt
+
+
+class NeutronContext(OSContextGenerator):
+    interfaces = []
+
+    @property
+    def plugin(self):
+        return None
+
+    @property
+    def network_manager(self):
+        return None
+
+    @property
+    def packages(self):
+        return neutron_plugin_attribute(self.plugin, 'packages',
+                                        self.network_manager)
+
+    @property
+    def neutron_security_groups(self):
+        return None
+
+    def _ensure_packages(self):
+        for pkgs in self.packages:
+            ensure_packages(pkgs)
+
+    def ovs_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'ovs',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return ovs_ctxt
+
+    def nuage_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nuage_ctxt = {'core_plugin': driver,
+                      'neutron_plugin': 'vsp',
+                      'neutron_security_groups': self.neutron_security_groups,
+                      'local_ip': unit_private_ip(),
+                      'config': config}
+
+        return nuage_ctxt
+
+    def nvp_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        nvp_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'nvp',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+
+        return nvp_ctxt
+
+    def n1kv_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        n1kv_config = neutron_plugin_attribute(self.plugin, 'config',
+                                               self.network_manager)
+        n1kv_user_config_flags = config('n1kv-config-flags')
+        restrict_policy_profiles = config('n1kv-restrict-policy-profiles')
+        n1kv_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'n1kv',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': n1kv_config,
+                     'vsm_ip': config('n1kv-vsm-ip'),
+                     'vsm_username': config('n1kv-vsm-username'),
+                     'vsm_password': config('n1kv-vsm-password'),
+                     'restrict_policy_profiles': restrict_policy_profiles}
+
+        if n1kv_user_config_flags:
+            flags = config_flags_parser(n1kv_user_config_flags)
+            n1kv_ctxt['user_config_flags'] = flags
+
+        return n1kv_ctxt
+
+    def calico_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        calico_ctxt = {'core_plugin': driver,
+                       'neutron_plugin': 'Calico',
+                       'neutron_security_groups': self.neutron_security_groups,
+                       'local_ip': unit_private_ip(),
+                       'config': config}
+
+        return calico_ctxt
+
+    def neutron_ctxt(self):
+        if https():
+            proto = 'https'
+        else:
+            proto = 'http'
+
+        if is_clustered():
+            host = config('vip')
+        else:
+            host = unit_get('private-address')
+
+        ctxt = {'network_manager': self.network_manager,
+                'neutron_url': '%s://%s:%s' % (proto, host, '9696')}
+        return ctxt
+
+    def pg_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        config = neutron_plugin_attribute(self.plugin, 'config',
+                                          self.network_manager)
+        ovs_ctxt = {'core_plugin': driver,
+                    'neutron_plugin': 'plumgrid',
+                    'neutron_security_groups': self.neutron_security_groups,
+                    'local_ip': unit_private_ip(),
+                    'config': config}
+        return ovs_ctxt
+
+    def midonet_ctxt(self):
+        driver = neutron_plugin_attribute(self.plugin, 'driver',
+                                          self.network_manager)
+        midonet_config = neutron_plugin_attribute(self.plugin, 'config',
+                                                  self.network_manager)
+        mido_ctxt = {'core_plugin': driver,
+                     'neutron_plugin': 'midonet',
+                     'neutron_security_groups': self.neutron_security_groups,
+                     'local_ip': unit_private_ip(),
+                     'config': midonet_config}
+
+        return mido_ctxt
+
+    def __call__(self):
+        if self.network_manager not in ['quantum', 'neutron']:
+            return {}
+
+        if not self.plugin:
+            return {}
+
+        ctxt = self.neutron_ctxt()
+
+        if self.plugin == 'ovs':
+            ctxt.update(self.ovs_ctxt())
+        elif self.plugin in ['nvp', 'nsx']:
+            ctxt.update(self.nvp_ctxt())
+        elif self.plugin == 'n1kv':
+            ctxt.update(self.n1kv_ctxt())
+        elif self.plugin == 'Calico':
+            ctxt.update(self.calico_ctxt())
+        elif self.plugin == 'vsp':
+            ctxt.update(self.nuage_ctxt())
+        elif self.plugin == 'plumgrid':
+            ctxt.update(self.pg_ctxt())
+        elif self.plugin == 'midonet':
+            ctxt.update(self.midonet_ctxt())
+
+        alchemy_flags = config('neutron-alchemy-flags')
+        if alchemy_flags:
+            flags = config_flags_parser(alchemy_flags)
+            ctxt['neutron_alchemy_flags'] = flags
+
+        return ctxt
+
+
+class NeutronPortContext(OSContextGenerator):
+
+    def resolve_ports(self, ports):
+        """Resolve NICs not yet bound to bridge(s)
+
+        If hwaddress provided then returns resolved hwaddress otherwise NIC.
+        """
+        if not ports:
+            return None
+
+        hwaddr_to_nic = {}
+        hwaddr_to_ip = {}
+        extant_nics = list_nics()
+
+        for nic in extant_nics:
+            # Ignore virtual interfaces (bond masters will be identified from
+            # their slaves)
+            if not is_phy_iface(nic):
+                continue
+
+            _nic = get_bond_master(nic)
+            if _nic:
+                log("Replacing iface '%s' with bond master '%s'" % (nic, _nic),
+                    level=DEBUG)
+                nic = _nic
+
+            hwaddr = get_nic_hwaddr(nic)
+            hwaddr_to_nic[hwaddr] = nic
+            addresses = get_ipv4_addr(nic, fatal=False)
+            addresses += get_ipv6_addr(iface=nic, fatal=False)
+            hwaddr_to_ip[hwaddr] = addresses
+
+        resolved = []
+        mac_regex = re.compile(r'([0-9A-F]{2}[:-]){5}([0-9A-F]{2})', re.I)
+        for entry in ports:
+            if re.match(mac_regex, entry):
+                # NIC is in known NICs and does NOT hace an IP address
+                if entry in hwaddr_to_nic and not hwaddr_to_ip[entry]:
+                    # If the nic is part of a bridge then don't use it
+                    if is_bridge_member(hwaddr_to_nic[entry]):
+                        continue
+
+                    # Entry is a MAC address for a valid interface that doesn't
+                    # have an IP address assigned yet.
+                    resolved.append(hwaddr_to_nic[entry])
+            elif entry in extant_nics:
+                # If the passed entry is not a MAC address and the interface
+                # exists, assume it's a valid interface, and that the user put
+                # it there on purpose (we can trust it to be the real external
+                # network).
+                resolved.append(entry)
+
+        # Ensure no duplicates
+        return list(set(resolved))
+
+
+class OSConfigFlagContext(OSContextGenerator):
+    """Provides support for user-defined config flags.
+
+    Users can define a comma-seperated list of key=value pairs
+    in the charm configuration and apply them at any point in
+    any file by using a template flag.
+
+    Sometimes users might want config flags inserted within a
+    specific section so this class allows users to specify the
+    template flag name, allowing for multiple template flags
+    (sections) within the same context.
+
+    NOTE: the value of config-flags may be a comma-separated list of
+          key=value pairs and some Openstack config files support
+          comma-separated lists as values.
+    """
+
+    def __init__(self, charm_flag='config-flags',
+                 template_flag='user_config_flags'):
+        """
+        :param charm_flag: config flags in charm configuration.
+        :param template_flag: insert point for user-defined flags in template
+                              file.
+        """
+        super(OSConfigFlagContext, self).__init__()
+        self._charm_flag = charm_flag
+        self._template_flag = template_flag
+
+    def __call__(self):
+        config_flags = config(self._charm_flag)
+        if not config_flags:
+            return {}
+
+        return {self._template_flag:
+                config_flags_parser(config_flags)}
+
+
+class LibvirtConfigFlagsContext(OSContextGenerator):
+    """
+    This context provides support for extending
+    the libvirt section through user-defined flags.
+    """
+    def __call__(self):
+        ctxt = {}
+        libvirt_flags = config('libvirt-flags')
+        if libvirt_flags:
+            ctxt['libvirt_flags'] = config_flags_parser(
+                libvirt_flags)
+        return ctxt
+
+
+class SubordinateConfigContext(OSContextGenerator):
+
+    """
+    Responsible for inspecting relations to subordinates that
+    may be exporting required config via a json blob.
+
+    The subordinate interface allows subordinates to export their
+    configuration requirements to the principle for multiple config
+    files and multiple services.  Ie, a subordinate that has interfaces
+    to both glance and nova may export to following yaml blob as json::
+
+        glance:
+            /etc/glance/glance-api.conf:
+                sections:
+                    DEFAULT:
+                        - [key1, value1]
+            /etc/glance/glance-registry.conf:
+                    MYSECTION:
+                        - [key2, value2]
+        nova:
+            /etc/nova/nova.conf:
+                sections:
+                    DEFAULT:
+                        - [key3, value3]
+
+
+    It is then up to the principle charms to subscribe this context to
+    the service+config file it is interestd in.  Configuration data will
+    be available in the template context, in glance's case, as::
+
+        ctxt = {
+            ... other context ...
+            'subordinate_configuration': {
+                'DEFAULT': {
+                    'key1': 'value1',
+                },
+                'MYSECTION': {
+                    'key2': 'value2',
+                },
+            }
+        }
+    """
+
+    def __init__(self, service, config_file, interface):
+        """
+        :param service     : Service name key to query in any subordinate
+                             data found
+        :param config_file : Service's config file to query sections
+        :param interface   : Subordinate interface to inspect
+        """
+        self.config_file = config_file
+        if isinstance(service, list):
+            self.services = service
+        else:
+            self.services = [service]
+        if isinstance(interface, list):
+            self.interfaces = interface
+        else:
+            self.interfaces = [interface]
+
+    def __call__(self):
+        ctxt = {'sections': {}}
+        rids = []
+        for interface in self.interfaces:
+            rids.extend(relation_ids(interface))
+        for rid in rids:
+            for unit in related_units(rid):
+                sub_config = relation_get('subordinate_configuration',
+                                          rid=rid, unit=unit)
+                if sub_config and sub_config != '':
+                    try:
+                        sub_config = json.loads(sub_config)
+                    except Exception:
+                        log('Could not parse JSON from '
+                            'subordinate_configuration setting from %s'
+                            % rid, level=ERROR)
+                        continue
+
+                    for service in self.services:
+                        if service not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s service'
+                                % (rid, service), level=INFO)
+                            continue
+
+                        sub_config = sub_config[service]
+                        if self.config_file not in sub_config:
+                            log('Found subordinate_configuration on %s but it '
+                                'contained nothing for %s'
+                                % (rid, self.config_file), level=INFO)
+                            continue
+
+                        sub_config = sub_config[self.config_file]
+                        for k, v in six.iteritems(sub_config):
+                            if k == 'sections':
+                                for section, config_list in six.iteritems(v):
+                                    log("adding section '%s'" % (section),
+                                        level=DEBUG)
+                                    if ctxt[k].get(section):
+                                        ctxt[k][section].extend(config_list)
+                                    else:
+                                        ctxt[k][section] = config_list
+                            else:
+                                ctxt[k] = v
+        log("%d section(s) found" % (len(ctxt['sections'])), level=DEBUG)
+        return ctxt
+
+
+class LogLevelContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['debug'] = \
+            False if config('debug') is None else config('debug')
+        ctxt['verbose'] = \
+            False if config('verbose') is None else config('verbose')
+
+        return ctxt
+
+
+class SyslogContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {'use_syslog': config('use-syslog')}
+        return ctxt
+
+
+class BindHostContext(OSContextGenerator):
+
+    def __call__(self):
+        if config('prefer-ipv6'):
+            return {'bind_host': '::'}
+        else:
+            return {'bind_host': '0.0.0.0'}
+
+
+MAX_DEFAULT_WORKERS = 4
+DEFAULT_MULTIPLIER = 2
+
+
+def _calculate_workers():
+    '''
+    Determine the number of worker processes based on the CPU
+    count of the unit containing the application.
+
+    Workers will be limited to MAX_DEFAULT_WORKERS in
+    container environments where no worker-multipler configuration
+    option been set.
+
+    @returns int: number of worker processes to use
+    '''
+    multiplier = config('worker-multiplier') or DEFAULT_MULTIPLIER
+    count = int(_num_cpus() * multiplier)
+    if multiplier > 0 and count == 0:
+        count = 1
+
+    if config('worker-multiplier') is None and is_container():
+        # NOTE(jamespage): Limit unconfigured worker-multiplier
+        #                  to MAX_DEFAULT_WORKERS to avoid insane
+        #                  worker configuration in LXD containers
+        #                  on large servers
+        # Reference: https://pad.lv/1665270
+        count = min(count, MAX_DEFAULT_WORKERS)
+
+    return count
+
+
+def _num_cpus():
+    '''
+    Compatibility wrapper for calculating the number of CPU's
+    a unit has.
+
+    @returns: int: number of CPU cores detected
+    '''
+    try:
+        return psutil.cpu_count()
+    except AttributeError:
+        return psutil.NUM_CPUS
+
+
+class WorkerConfigContext(OSContextGenerator):
+
+    def __call__(self):
+        ctxt = {"workers": _calculate_workers()}
+        return ctxt
+
+
+class WSGIWorkerConfigContext(WorkerConfigContext):
+
+    def __init__(self, name=None, script=None, admin_script=None,
+                 public_script=None, user=None, group=None,
+                 process_weight=1.00,
+                 admin_process_weight=0.25, public_process_weight=0.75):
+        self.service_name = name
+        self.user = user or name
+        self.group = group or name
+        self.script = script
+        self.admin_script = admin_script
+        self.public_script = public_script
+        self.process_weight = process_weight
+        self.admin_process_weight = admin_process_weight
+        self.public_process_weight = public_process_weight
+
+    def __call__(self):
+        total_processes = _calculate_workers()
+        ctxt = {
+            "service_name": self.service_name,
+            "user": self.user,
+            "group": self.group,
+            "script": self.script,
+            "admin_script": self.admin_script,
+            "public_script": self.public_script,
+            "processes": int(math.ceil(self.process_weight * total_processes)),
+            "admin_processes": int(math.ceil(self.admin_process_weight *
+                                             total_processes)),
+            "public_processes": int(math.ceil(self.public_process_weight *
+                                              total_processes)),
+            "threads": 1,
+        }
+        return ctxt
+
+
+class ZeroMQContext(OSContextGenerator):
+    interfaces = ['zeromq-configuration']
+
+    def __call__(self):
+        ctxt = {}
+        if is_relation_made('zeromq-configuration', 'host'):
+            for rid in relation_ids('zeromq-configuration'):
+                for unit in related_units(rid):
+                    ctxt['zmq_nonce'] = relation_get('nonce', unit, rid)
+                    ctxt['zmq_host'] = relation_get('host', unit, rid)
+                    ctxt['zmq_redis_address'] = relation_get(
+                        'zmq_redis_address', unit, rid)
+
+        return ctxt
+
+
+class NotificationDriverContext(OSContextGenerator):
+
+    def __init__(self, zmq_relation='zeromq-configuration',
+                 amqp_relation='amqp'):
+        """
+        :param zmq_relation: Name of Zeromq relation to check
+        """
+        self.zmq_relation = zmq_relation
+        self.amqp_relation = amqp_relation
+
+    def __call__(self):
+        ctxt = {'notifications': 'False'}
+        if is_relation_made(self.amqp_relation):
+            ctxt['notifications'] = "True"
+
+        return ctxt
+
+
+class SysctlContext(OSContextGenerator):
+    """This context check if the 'sysctl' option exists on configuration
+    then creates a file with the loaded contents"""
+    def __call__(self):
+        sysctl_dict = config('sysctl')
+        if sysctl_dict:
+            sysctl_create(sysctl_dict,
+                          '/etc/sysctl.d/50-{0}.conf'.format(charm_name()))
+        return {'sysctl': sysctl_dict}
+
+
+class NeutronAPIContext(OSContextGenerator):
+    '''
+    Inspects current neutron-plugin-api relation for neutron settings. Return
+    defaults if it is not present.
+    '''
+    interfaces = ['neutron-plugin-api']
+
+    def __call__(self):
+        self.neutron_defaults = {
+            'l2_population': {
+                'rel_key': 'l2-population',
+                'default': False,
+            },
+            'overlay_network_type': {
+                'rel_key': 'overlay-network-type',
+                'default': 'gre',
+            },
+            'neutron_security_groups': {
+                'rel_key': 'neutron-security-groups',
+                'default': False,
+            },
+            'network_device_mtu': {
+                'rel_key': 'network-device-mtu',
+                'default': None,
+            },
+            'enable_dvr': {
+                'rel_key': 'enable-dvr',
+                'default': False,
+            },
+            'enable_l3ha': {
+                'rel_key': 'enable-l3ha',
+                'default': False,
+            },
+            'dns_domain': {
+                'rel_key': 'dns-domain',
+                'default': None,
+            },
+            'polling_interval': {
+                'rel_key': 'polling-interval',
+                'default': 2,
+            },
+            'rpc_response_timeout': {
+                'rel_key': 'rpc-response-timeout',
+                'default': 60,
+            },
+            'report_interval': {
+                'rel_key': 'report-interval',
+                'default': 30,
+            },
+            'enable_qos': {
+                'rel_key': 'enable-qos',
+                'default': False,
+            },
+            'enable_nsg_logging': {
+                'rel_key': 'enable-nsg-logging',
+                'default': False,
+            },
+            'enable_nfg_logging': {
+                'rel_key': 'enable-nfg-logging',
+                'default': False,
+            },
+            'enable_port_forwarding': {
+                'rel_key': 'enable-port-forwarding',
+                'default': False,
+            },
+            'global_physnet_mtu': {
+                'rel_key': 'global-physnet-mtu',
+                'default': 1500,
+            },
+            'physical_network_mtus': {
+                'rel_key': 'physical-network-mtus',
+                'default': None,
+            },
+        }
+        ctxt = self.get_neutron_options({})
+        for rid in relation_ids('neutron-plugin-api'):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                # The l2-population key is used by the context as a way of
+                # checking if the api service on the other end is sending data
+                # in a recent format.
+                if 'l2-population' in rdata:
+                    ctxt.update(self.get_neutron_options(rdata))
+
+        extension_drivers = []
+
+        if ctxt['enable_qos']:
+            extension_drivers.append('qos')
+
+        if ctxt['enable_nsg_logging']:
+            extension_drivers.append('log')
+
+        ctxt['extension_drivers'] = ','.join(extension_drivers)
+
+        l3_extension_plugins = []
+
+        if ctxt['enable_port_forwarding']:
+            l3_extension_plugins.append('port_forwarding')
+
+        ctxt['l3_extension_plugins'] = l3_extension_plugins
+
+        return ctxt
+
+    def get_neutron_options(self, rdata):
+        settings = {}
+        for nkey in self.neutron_defaults.keys():
+            defv = self.neutron_defaults[nkey]['default']
+            rkey = self.neutron_defaults[nkey]['rel_key']
+            if rkey in rdata.keys():
+                if type(defv) is bool:
+                    settings[nkey] = bool_from_string(rdata[rkey])
+                else:
+                    settings[nkey] = rdata[rkey]
+            else:
+                settings[nkey] = defv
+        return settings
+
+
+class ExternalPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        ports = config('ext-port')
+        if ports:
+            ports = [p.strip() for p in ports.split()]
+            ports = self.resolve_ports(ports)
+            if ports:
+                ctxt = {"ext_port": ports[0]}
+                napi_settings = NeutronAPIContext()()
+                mtu = napi_settings.get('network_device_mtu')
+                if mtu:
+                    ctxt['ext_port_mtu'] = mtu
+
+        return ctxt
+
+
+class DataPortContext(NeutronPortContext):
+
+    def __call__(self):
+        ports = config('data-port')
+        if ports:
+            # Map of {bridge:port/mac}
+            portmap = parse_data_port_mappings(ports)
+            ports = portmap.keys()
+            # Resolve provided ports or mac addresses and filter out those
+            # already attached to a bridge.
+            resolved = self.resolve_ports(ports)
+            # Rebuild port index using resolved and filtered ports.
+            normalized = {get_nic_hwaddr(port): port for port in resolved
+                          if port not in ports}
+            normalized.update({port: port for port in resolved
+                               if port in ports})
+            if resolved:
+                return {normalized[port]: bridge for port, bridge in
+                        six.iteritems(portmap) if port in normalized.keys()}
+
+        return None
+
+
+class PhyNICMTUContext(DataPortContext):
+
+    def __call__(self):
+        ctxt = {}
+        mappings = super(PhyNICMTUContext, self).__call__()
+        if mappings and mappings.keys():
+            ports = sorted(mappings.keys())
+            napi_settings = NeutronAPIContext()()
+            mtu = napi_settings.get('network_device_mtu')
+            all_ports = set()
+            # If any of ports is a vlan device, its underlying device must have
+            # mtu applied first.
+            for port in ports:
+                for lport in glob.glob("/sys/class/net/%s/lower_*" % port):
+                    lport = os.path.basename(lport)
+                    all_ports.add(lport.split('_')[1])
+
+            all_ports = list(all_ports)
+            all_ports.extend(ports)
+            if mtu:
+                ctxt["devs"] = '\\n'.join(all_ports)
+                ctxt['mtu'] = mtu
+
+        return ctxt
+
+
+class NetworkServiceContext(OSContextGenerator):
+
+    def __init__(self, rel_name='quantum-network-service'):
+        self.rel_name = rel_name
+        self.interfaces = [rel_name]
+
+    def __call__(self):
+        for rid in relation_ids(self.rel_name):
+            for unit in related_units(rid):
+                rdata = relation_get(rid=rid, unit=unit)
+                ctxt = {
+                    'keystone_host': rdata.get('keystone_host'),
+                    'service_port': rdata.get('service_port'),
+                    'auth_port': rdata.get('auth_port'),
+                    'service_tenant': rdata.get('service_tenant'),
+                    'service_username': rdata.get('service_username'),
+                    'service_password': rdata.get('service_password'),
+                    'quantum_host': rdata.get('quantum_host'),
+                    'quantum_port': rdata.get('quantum_port'),
+                    'quantum_url': rdata.get('quantum_url'),
+                    'region': rdata.get('region'),
+                    'service_protocol':
+                    rdata.get('service_protocol') or 'http',
+                    'auth_protocol':
+                    rdata.get('auth_protocol') or 'http',
+                    'api_version':
+                    rdata.get('api_version') or '2.0',
+                }
+                if self.context_complete(ctxt):
+                    return ctxt
+        return {}
+
+
+class InternalEndpointContext(OSContextGenerator):
+    """Internal endpoint context.
+
+    This context provides the endpoint type used for communication between
+    services e.g. between Nova and Cinder internally. Openstack uses Public
+    endpoints by default so this allows admins to optionally use internal
+    endpoints.
+    """
+    def __call__(self):
+        return {'use_internal_endpoints': config('use-internal-endpoints')}
+
+
+class VolumeAPIContext(InternalEndpointContext):
+    """Volume API context.
+
+    This context provides information regarding the volume endpoint to use
+    when communicating between services. It determines which version of the
+    API is appropriate for use.
+
+    This value will be determined in the resulting context dictionary
+    returned from calling the VolumeAPIContext object. Information provided
+    by this context is as follows:
+
+        volume_api_version: the volume api version to use, currently
+            'v2' or 'v3'
+        volume_catalog_info: the information to use for a cinder client
+            configuration that consumes API endpoints from the keystone
+            catalog. This is defined as the type:name:endpoint_type string.
+    """
+    # FIXME(wolsen) This implementation is based on the provider being able
+    # to specify the package version to check but does not guarantee that the
+    # volume service api version selected is available. In practice, it is
+    # quite likely the volume service *is* providing the v3 volume service.
+    # This should be resolved when the service-discovery spec is implemented.
+    def __init__(self, pkg):
+        """
+        Creates a new VolumeAPIContext for use in determining which version
+        of the Volume API should be used for communication. A package codename
+        should be supplied for determining the currently installed OpenStack
+        version.
+
+        :param pkg: the package codename to use in order to determine the
+            component version (e.g. nova-common). See
+            charmhelpers.contrib.openstack.utils.PACKAGE_CODENAMES for more.
+        """
+        super(VolumeAPIContext, self).__init__()
+        self._ctxt = None
+        if not pkg:
+            raise ValueError('package name must be provided in order to '
+                             'determine current OpenStack version.')
+        self.pkg = pkg
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """Determines the Volume API endpoint information.
+
+        Determines the appropriate version of the API that should be used
+        as well as the catalog_info string that would be supplied. Returns
+        a dict containing the volume_api_version and the volume_catalog_info.
+        """
+        rel = os_release(self.pkg)
+        version = '2'
+        if CompareOpenStackReleases(rel) >= 'pike':
+            version = '3'
+
+        service_type = 'volumev{version}'.format(version=version)
+        service_name = 'cinderv{version}'.format(version=version)
+        endpoint_type = 'publicURL'
+        if config('use-internal-endpoints'):
+            endpoint_type = 'internalURL'
+        catalog_info = '{type}:{name}:{endpoint}'.format(
+            type=service_type, name=service_name, endpoint=endpoint_type)
+
+        return {
+            'volume_api_version': version,
+            'volume_catalog_info': catalog_info,
+        }
+
+    def __call__(self):
+        return self.ctxt
+
+
+class AppArmorContext(OSContextGenerator):
+    """Base class for apparmor contexts."""
+
+    def __init__(self, profile_name=None):
+        self._ctxt = None
+        self.aa_profile = profile_name
+        self.aa_utils_packages = ['apparmor-utils']
+
+    @property
+    def ctxt(self):
+        if self._ctxt is not None:
+            return self._ctxt
+        self._ctxt = self._determine_ctxt()
+        return self._ctxt
+
+    def _determine_ctxt(self):
+        """
+        Validate aa-profile-mode settings is disable, enforce, or complain.
+
+        :return ctxt: Dictionary of the apparmor profile or None
+        """
+        if config('aa-profile-mode') in ['disable', 'enforce', 'complain']:
+            ctxt = {'aa_profile_mode': config('aa-profile-mode'),
+                    'ubuntu_release': lsb_release()['DISTRIB_RELEASE']}
+            if self.aa_profile:
+                ctxt['aa_profile'] = self.aa_profile
+        else:
+            ctxt = None
+        return ctxt
+
+    def __call__(self):
+        return self.ctxt
+
+    def install_aa_utils(self):
+        """
+        Install packages required for apparmor configuration.
+        """
+        log("Installing apparmor utils.")
+        ensure_packages(self.aa_utils_packages)
+
+    def manually_disable_aa_profile(self):
+        """
+        Manually disable an apparmor profile.
+
+        If aa-profile-mode is set to disabled (default) this is required as the
+        template has been written but apparmor is yet unaware of the profile
+        and aa-disable aa-profile fails. Without this the profile would kick
+        into enforce mode on the next service restart.
+
+        """
+        profile_path = '/etc/apparmor.d'
+        disable_path = '/etc/apparmor.d/disable'
+        if not os.path.lexists(os.path.join(disable_path, self.aa_profile)):
+            os.symlink(os.path.join(profile_path, self.aa_profile),
+                       os.path.join(disable_path, self.aa_profile))
+
+    def setup_aa_profile(self):
+        """
+        Setup an apparmor profile.
+        The ctxt dictionary will contain the apparmor profile mode and
+        the apparmor profile name.
+        Makes calls out to aa-disable, aa-complain, or aa-enforce to setup
+        the apparmor profile.
+        """
+        self()
+        if not self.ctxt:
+            log("Not enabling apparmor Profile")
+            return
+        self.install_aa_utils()
+        cmd = ['aa-{}'.format(self.ctxt['aa_profile_mode'])]
+        cmd.append(self.ctxt['aa_profile'])
+        log("Setting up the apparmor profile for {} in {} mode."
+            "".format(self.ctxt['aa_profile'], self.ctxt['aa_profile_mode']))
+        try:
+            check_call(cmd)
+        except CalledProcessError as e:
+            # If aa-profile-mode is set to disabled (default) manual
+            # disabling is required as the template has been written but
+            # apparmor is yet unaware of the profile and aa-disable aa-profile
+            # fails. If aa-disable learns to read profile files first this can
+            # be removed.
+            if self.ctxt['aa_profile_mode'] == 'disable':
+                log("Manually disabling the apparmor profile for {}."
+                    "".format(self.ctxt['aa_profile']))
+                self.manually_disable_aa_profile()
+                return
+            status_set('blocked', "Apparmor profile {} failed to be set to {}."
+                                  "".format(self.ctxt['aa_profile'],
+                                            self.ctxt['aa_profile_mode']))
+            raise e
+
+
+class MemcacheContext(OSContextGenerator):
+    """Memcache context
+
+    This context provides options for configuring a local memcache client and
+    server for both IPv4 and IPv6
+    """
+
+    def __init__(self, package=None):
+        """
+        @param package: Package to examine to extrapolate OpenStack release.
+                        Used when charms have no openstack-origin config
+                        option (ie subordinates)
+        """
+        self.package = package
+
+    def __call__(self):
+        ctxt = {}
+        ctxt['use_memcache'] = enable_memcache(package=self.package)
+        if ctxt['use_memcache']:
+            # Trusty version of memcached does not support ::1 as a listen
+            # address so use host file entry instead
+            release = lsb_release()['DISTRIB_CODENAME'].lower()
+            if is_ipv6_disabled():
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '127.0.0.1'
+                else:
+                    ctxt['memcache_server'] = 'localhost'
+                ctxt['memcache_server_formatted'] = '127.0.0.1'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = '{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+            else:
+                if CompareHostReleases(release) > 'trusty':
+                    ctxt['memcache_server'] = '::1'
+                else:
+                    ctxt['memcache_server'] = 'ip6-localhost'
+                ctxt['memcache_server_formatted'] = '[::1]'
+                ctxt['memcache_port'] = '11211'
+                ctxt['memcache_url'] = 'inet6:{}:{}'.format(
+                    ctxt['memcache_server_formatted'],
+                    ctxt['memcache_port'])
+        return ctxt
+
+
+class EnsureDirContext(OSContextGenerator):
+    '''
+    Serves as a generic context to create a directory as a side-effect.
+
+    Useful for software that supports drop-in files (.d) in conjunction
+    with config option-based templates. Examples include:
+        * OpenStack oslo.policy drop-in files;
+        * systemd drop-in config files;
+        * other software that supports overriding defaults with .d files
+
+    Another use-case is when a subordinate generates a configuration for
+    primary to render in a separate directory.
+
+    Some software requires a user to create a target directory to be
+    scanned for drop-in files with a specific format. This is why this
+    context is needed to do that before rendering a template.
+    '''
+
+    def __init__(self, dirname, **kwargs):
+        '''Used merely to ensure that a given directory exists.'''
+        self.dirname = dirname
+        self.kwargs = kwargs
+
+    def __call__(self):
+        mkdir(self.dirname, **self.kwargs)
+        return {}
+
+
+class VersionsContext(OSContextGenerator):
+    """Context to return the openstack and operating system versions.
+
+    """
+    def __init__(self, pkg='python-keystone'):
+        """Initialise context.
+
+        :param pkg: Package to extrapolate openstack version from.
+        :type pkg: str
+        """
+        self.pkg = pkg
+
+    def __call__(self):
+        ostack = os_release(self.pkg)
+        osystem = lsb_release()['DISTRIB_CODENAME'].lower()
+        return {
+            'openstack_release': ostack,
+            'operating_system_release': osystem}
+
+
+class LogrotateContext(OSContextGenerator):
+    """Common context generator for logrotate."""
+
+    def __init__(self, location, interval, count):
+        """
+        :param location: Absolute path for the logrotate config file
+        :type location: str
+        :param interval: The interval for the rotations. Valid values are
+                         'daily', 'weekly', 'monthly', 'yearly'
+        :type interval: str
+        :param count: The logrotate count option configures the 'count' times
+                      the log files are being rotated before being
+        :type count: int
+        """
+        self.location = location
+        self.interval = interval
+        self.count = 'rotate {}'.format(count)
+
+    def __call__(self):
+        ctxt = {
+            'logrotate_logs_location': self.location,
+            'logrotate_interval': self.interval,
+            'logrotate_count': self.count,
+        }
+        return ctxt
+
+
+class HostInfoContext(OSContextGenerator):
+    """Context to provide host information."""
+
+    def __init__(self, use_fqdn_hint_cb=None):
+        """Initialize HostInfoContext
+
+        :param use_fqdn_hint_cb: Callback whose return value used to populate
+                                 `use_fqdn_hint`
+        :type use_fqdn_hint_cb: Callable[[], bool]
+        """
+        # Store callback used to get hint for whether FQDN should be used
+
+        # Depending on the workload a charm manages, the use of FQDN vs.
+        # shortname may be a deploy-time decision, i.e. behaviour can not
+        # change on charm upgrade or post-deployment configuration change.
+
+        # The hint is passed on as a flag in the context to allow the decision
+        # to be made in the Jinja2 configuration template.
+        self.use_fqdn_hint_cb = use_fqdn_hint_cb
+
+    def _get_canonical_name(self, name=None):
+        """Get the official FQDN of the host
+
+        The implementation of ``socket.getfqdn()`` in the standard Python
+        library does not exhaust all methods of getting the official name
+        of a host ref Python issue https://bugs.python.org/issue5004
+
+        This function mimics the behaviour of a call to ``hostname -f`` to
+        get the official FQDN but returns an empty string if it is
+        unsuccessful.
+
+        :param name: Shortname to get FQDN on
+        :type name: Optional[str]
+        :returns: The official FQDN for host or empty string ('')
+        :rtype: str
+        """
+        name = name or socket.gethostname()
+        fqdn = ''
+
+        if six.PY2:
+            exc = socket.error
+        else:
+            exc = OSError
+
+        try:
+            addrs = socket.getaddrinfo(
+                name, None, 0, socket.SOCK_DGRAM, 0, socket.AI_CANONNAME)
+        except exc:
+            pass
+        else:
+            for addr in addrs:
+                if addr[3]:
+                    if '.' in addr[3]:
+                        fqdn = addr[3]
+                    break
+        return fqdn
+
+    def __call__(self):
+        name = socket.gethostname()
+        ctxt = {
+            'host_fqdn': self._get_canonical_name(name) or name,
+            'host': name,
+            'use_fqdn_hint': (
+                self.use_fqdn_hint_cb() if self.use_fqdn_hint_cb else False)
+        }
+        return ctxt
+
+
+def validate_ovs_use_veth(*args, **kwargs):
+    """Validate OVS use veth setting for dhcp agents
+
+    The ovs_use_veth setting is considered immutable as it will break existing
+    deployments. Historically, we set ovs_use_veth=True in dhcp_agent.ini. It
+    turns out this is no longer necessary. Ideally, all new deployments would
+    have this set to False.
+
+    This function validates that the config value does not conflict with
+    previously deployed settings in dhcp_agent.ini.
+
+    See LP Bug#1831935 for details.
+
+    :returns: Status state and message
+    :rtype: Union[(None, None), (string, string)]
+    """
+    existing_ovs_use_veth = (
+        DHCPAgentContext.get_existing_ovs_use_veth())
+    config_ovs_use_veth = DHCPAgentContext.parse_ovs_use_veth()
+
+    # Check settings are set and not None
+    if existing_ovs_use_veth is not None and config_ovs_use_veth is not None:
+        # Check for mismatch between existing config ini and juju config
+        if existing_ovs_use_veth != config_ovs_use_veth:
+            # Stop the line to avoid breakage
+            msg = (
+                "The existing setting for dhcp_agent.ini ovs_use_veth, {}, "
+                "does not match the juju config setting, {}. This may lead to "
+                "VMs being unable to receive a DHCP IP. Either change the "
+                "juju config setting or dhcp agents may need to be recreated."
+                .format(existing_ovs_use_veth, config_ovs_use_veth))
+            log(msg, ERROR)
+            return (
+                "blocked",
+                "Mismatched existing and configured ovs-use-veth. See log.")
+
+    # Everything is OK
+    return None, None
+
+
+class DHCPAgentContext(OSContextGenerator):
+
+    def __call__(self):
+        """Return the DHCPAGentContext.
+
+        Return all DHCP Agent INI related configuration.
+        ovs unit is attached to (as a subordinate) and the 'dns_domain' from
+        the neutron-plugin-api relations (if one is set).
+
+        :returns: Dictionary context
+        :rtype: Dict
+        """
+
+        ctxt = {}
+        dnsmasq_flags = config('dnsmasq-flags')
+        if dnsmasq_flags:
+            ctxt['dnsmasq_flags'] = config_flags_parser(dnsmasq_flags)
+        ctxt['dns_servers'] = config('dns-servers')
+
+        neutron_api_settings = NeutronAPIContext()()
+
+        ctxt['debug'] = config('debug')
+        ctxt['instance_mtu'] = config('instance-mtu')
+        ctxt['ovs_use_veth'] = self.get_ovs_use_veth()
+
+        ctxt['enable_metadata_network'] = config('enable-metadata-network')
+        ctxt['enable_isolated_metadata'] = config('enable-isolated-metadata')
+
+        if neutron_api_settings.get('dns_domain'):
+            ctxt['dns_domain'] = neutron_api_settings.get('dns_domain')
+
+        # Override user supplied config for these plugins as these settings are
+        # mandatory
+        if config('plugin') in ['nvp', 'nsx', 'n1kv']:
+            ctxt['enable_metadata_network'] = True
+            ctxt['enable_isolated_metadata'] = True
+
+        return ctxt
+
+    @staticmethod
+    def get_existing_ovs_use_veth():
+        """Return existing ovs_use_veth setting from dhcp_agent.ini.
+
+        :returns: Boolean value of existing ovs_use_veth setting or None
+        :rtype: Optional[Bool]
+        """
+        DHCP_AGENT_INI = "/etc/neutron/dhcp_agent.ini"
+        existing_ovs_use_veth = None
+        # If there is a dhcp_agent.ini file read the current setting
+        if os.path.isfile(DHCP_AGENT_INI):
+            # config_ini does the right thing and returns None if the setting is
+            # commented.
+            existing_ovs_use_veth = (
+                config_ini(DHCP_AGENT_INI)["DEFAULT"].get("ovs_use_veth"))
+        # Convert to Bool if necessary
+        if isinstance(existing_ovs_use_veth, six.string_types):
+            return bool_from_string(existing_ovs_use_veth)
+        return existing_ovs_use_veth
+
+    @staticmethod
+    def parse_ovs_use_veth():
+        """Parse the ovs-use-veth config setting.
+
+        Parse the string config setting for ovs-use-veth and return a boolean
+        or None.
+
+        bool_from_string will raise a ValueError if the string is not falsy or
+        truthy.
+
+        :raises: ValueError for invalid input
+        :returns: Boolean value of ovs-use-veth or None
+        :rtype: Optional[Bool]
+        """
+        _config = config("ovs-use-veth")
+        # An unset parameter returns None. Just in case we will also check for
+        # an empty string: "". Ironically, (the problem we are trying to avoid)
+        # "False" returns True and "" returns False.
+        if _config is None or not _config:
+            # Return None
+            return
+        # bool_from_string handles many variations of true and false strings
+        # as well as upper and lowercases including:
+        # ['y', 'yes', 'true', 't', 'on', 'n', 'no', 'false', 'f', 'off']
+        return bool_from_string(_config)
+
+    def get_ovs_use_veth(self):
+        """Return correct ovs_use_veth setting for use in dhcp_agent.ini.
+
+        Get the right value from config or existing dhcp_agent.ini file.
+        Existing has precedence. Attempt to default to "False" without
+        disrupting existing deployments. Handle existing deployments and
+        upgrades safely. See LP Bug#1831935
+
+        :returns: Value to use for ovs_use_veth setting
+        :rtype: Bool
+        """
+        _existing = self.get_existing_ovs_use_veth()
+        if _existing is not None:
+            return _existing
+
+        _config = self.parse_ovs_use_veth()
+        if _config is None:
+            # New better default
+            return False
+        else:
+            return _config
+
+
+EntityMac = collections.namedtuple('EntityMac', ['entity', 'mac'])
+
+
+def resolve_pci_from_mapping_config(config_key):
+    """Resolve local PCI devices from MAC addresses in mapping config.
+
+    Note that this function keeps record of mac->PCI address lookups
+    in the local unit db as the devices will disappaear from the system
+    once bound.
+
+    :param config_key: Configuration option key to parse data from
+    :type config_key: str
+    :returns: PCI device address to Tuple(entity, mac) map
+    :rtype: collections.OrderedDict[str,Tuple[str,str]]
+    """
+    devices = pci.PCINetDevices()
+    resolved_devices = collections.OrderedDict()
+    db = kv()
+    # Note that ``parse_data_port_mappings`` returns Dict regardless of input
+    for mac, entity in parse_data_port_mappings(config(config_key)).items():
+        pcidev = devices.get_device_from_mac(mac)
+        if pcidev:
+            # NOTE: store mac->pci allocation as post binding
+            #       it disappears from PCIDevices.
+            db.set(mac, pcidev.pci_address)
+            db.flush()
+
+        pci_address = db.get(mac)
+        if pci_address:
+            resolved_devices[pci_address] = EntityMac(entity, mac)
+
+    return resolved_devices
+
+
+class DPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, driver_key=None, bridges_key=None, bonds_key=None):
+        """Initialize DPDKDeviceContext.
+
+        :param driver_key: Key to use when retrieving driver config.
+        :type driver_key: str
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.driver_key = driver_key or 'dpdk-driver'
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[str,collections.OrderedDict[str,str]]]
+        """
+        driver = config(self.driver_key)
+        if driver is None:
+            return {}
+        # Resolve PCI devices for both directly used devices (_bridges)
+        # and devices for use in dpdk bonds (_bonds)
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return {'devices': pci_devices,
+                'driver': driver}
+
+
+class OVSDPDKDeviceContext(OSContextGenerator):
+
+    def __init__(self, bridges_key=None, bonds_key=None):
+        """Initialize OVSDPDKDeviceContext.
+
+        :param bridges_key: Key to use when retrieving bridge config.
+        :type bridges_key: str
+        :param bonds_key: Key to use when retrieving bonds config.
+        :type bonds_key: str
+        """
+        self.bridges_key = bridges_key or 'data-port'
+        self.bonds_key = bonds_key or 'dpdk-bond-mappings'
+
+    @staticmethod
+    def _parse_cpu_list(cpulist):
+        """Parses a linux cpulist for a numa node
+
+        :returns: list of cores
+        :rtype: List[int]
+        """
+        cores = []
+        ranges = cpulist.split(',')
+        for cpu_range in ranges:
+            if "-" in cpu_range:
+                cpu_min_max = cpu_range.split('-')
+                cores += range(int(cpu_min_max[0]),
+                               int(cpu_min_max[1]) + 1)
+            else:
+                cores.append(int(cpu_range))
+        return cores
+
+    def _numa_node_cores(self):
+        """Get map of numa node -> cpu core
+
+        :returns: map of numa node -> cpu core
+        :rtype: Dict[str,List[int]]
+        """
+        nodes = {}
+        node_regex = '/sys/devices/system/node/node*'
+        for node in glob.glob(node_regex):
+            index = node.lstrip('/sys/devices/system/node/node')
+            with open(os.path.join(node, 'cpulist')) as cpulist:
+                nodes[index] = self._parse_cpu_list(cpulist.read().strip())
+        return nodes
+
+    def cpu_mask(self):
+        """Get hex formatted CPU mask
+
+        The mask is based on using the first config:dpdk-socket-cores
+        cores of each NUMA node in the unit.
+        :returns: hex formatted CPU mask
+        :rtype: str
+        """
+        num_cores = config('dpdk-socket-cores')
+        mask = 0
+        for cores in self._numa_node_cores().values():
+            for core in cores[:num_cores]:
+                mask = mask | 1 << core
+        return format(mask, '#04x')
+
+    def socket_memory(self):
+        """Formatted list of socket memory configuration per NUMA node
+
+        :returns: socket memory configuration per NUMA node
+        :rtype: str
+        """
+        sm_size = config('dpdk-socket-memory')
+        node_regex = '/sys/devices/system/node/node*'
+        mem_list = [str(sm_size) for _ in glob.glob(node_regex)]
+        if mem_list:
+            return ','.join(mem_list)
+        else:
+            return str(sm_size)
+
+    def devices(self):
+        """List of PCI devices for use by DPDK
+
+        :returns: List of PCI devices for use by DPDK
+        :rtype: collections.OrderedDict[str,str]
+        """
+        pci_devices = resolve_pci_from_mapping_config(self.bridges_key)
+        pci_devices.update(resolve_pci_from_mapping_config(self.bonds_key))
+        return pci_devices
+
+    def _formatted_whitelist(self, flag):
+        """Flag formatted list of devices to whitelist
+
+        :param flag: flag format to use
+        :type flag: str
+        :rtype: str
+        """
+        whitelist = []
+        for device in self.devices():
+            whitelist.append(flag.format(device=device))
+        return ' '.join(whitelist)
+
+    def device_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the old style '-w' flag
+
+        :returns: devices to whitelist prefixed by '-w '
+        :rtype: str
+        """
+        return self._formatted_whitelist('-w {device}')
+
+    def pci_whitelist(self):
+        """Formatted list of devices to whitelist for dpdk
+
+        using the new style '--pci-whitelist' flag
+
+        :returns: devices to whitelist prefixed by '--pci-whitelist '
+        :rtype: str
+        """
+        return self._formatted_whitelist('--pci-whitelist {device}')
+
+    def __call__(self):
+        """Populate context.
+
+        :returns: context
+        :rtype: Dict[str,Union[bool,str]]
+        """
+        ctxt = {}
+        whitelist = self.device_whitelist()
+        if whitelist:
+            ctxt['dpdk_enabled'] = config('enable-dpdk')
+            ctxt['device_whitelist'] = self.device_whitelist()
+            ctxt['socket_memory'] = self.socket_memory()
+            ctxt['cpu_mask'] = self.cpu_mask()
+        return ctxt
+
+
+class BridgePortInterfaceMap(object):
+    """Build a map of bridge ports and interaces from charm configuration.
+
+    NOTE: the handling of this detail in the charm is pre-deprecated.
+
+    The long term goal is for network connectivity detail to be modelled in
+    the server provisioning layer (such as MAAS) which in turn will provide
+    a Netplan YAML description that will be used to drive Open vSwitch.
+
+    Until we get to that reality the charm will need to configure this
+    detail based on application level configuration options.
+
+    There is a established way of mapping interfaces to ports and bridges
+    in the ``neutron-openvswitch`` and ``neutron-gateway`` charms and we
+    will carry that forward.
+
+    The relationship between bridge, port and interface(s).
+             +--------+
+             | bridge |
+             +--------+
+                 |
+         +----------------+
+         | port aka. bond |
+         +----------------+
+               |   |
+              +-+ +-+
+              |i| |i|
+              |n| |n|
+              |t| |t|
+              |0| |N|
+              +-+ +-+
+    """
+    class interface_type(enum.Enum):
+        """Supported interface types.
+
+        Supported interface types can be found in the ``iface_types`` column
+        in the ``Open_vSwitch`` table on a running system.
+        """
+        dpdk = 'dpdk'
+        internal = 'internal'
+        system = 'system'
+
+        def __str__(self):
+            """Return string representation of value.
+
+            :returns: string representation of value.
+            :rtype: str
+            """
+            return self.value
+
+    def __init__(self, bridges_key=None, bonds_key=None, enable_dpdk_key=None,
+                 global_mtu=None):
+        """Initialize map.
+
+        :param bridges_key: Name of bridge:interface/port map config key
+                            (default: 'data-port')
+        :type bridges_key: Optional[str]
+        :param bonds_key: Name of port-name:interface map config key
+                          (default: 'dpdk-bond-mappings')
+        :type bonds_key: Optional[str]
+        :param enable_dpdk_key: Name of DPDK toggle config key
+                                (default: 'enable-dpdk')
+        :type enable_dpdk_key: Optional[str]
+        :param global_mtu: Set a MTU on all interfaces at map initialization.
+
+            The default is to have Open vSwitch get this from the underlying
+            interface as set up by bare metal provisioning.
+
+            Note that you can augment the MTU on an individual interface basis
+            like this:
+
+            ifdatamap = bpi.get_ifdatamap(bridge, port)
+            ifdatamap = {
+                port: {
+                    **ifdata,
+                    **{'mtu-request': my_individual_mtu_map[port]},
+                }
+                for port, ifdata in ifdatamap.items()
+            }
+        :type global_mtu: Optional[int]
+        """
+        bridges_key = bridges_key or 'data-port'
+        bonds_key = bonds_key or 'dpdk-bond-mappings'
+        enable_dpdk_key = enable_dpdk_key or 'enable-dpdk'
+        self._map = collections.defaultdict(
+            lambda: collections.defaultdict(dict))
+        self._ifname_mac_map = collections.defaultdict(list)
+        self._mac_ifname_map = {}
+        self._mac_pci_address_map = {}
+
+        # First we iterate over the list of physical interfaces visible to the
+        # system and update interface name to mac and mac to interface name map
+        for ifname in list_nics():
+            if not is_phy_iface(ifname):
+                continue
+            mac = get_nic_hwaddr(ifname)
+            self._ifname_mac_map[ifname] = [mac]
+            self._mac_ifname_map[mac] = ifname
+
+            # check if interface is part of a linux bond
+            _bond_name = get_bond_master(ifname)
+            if _bond_name and _bond_name != ifname:
+                log('Add linux bond "{}" to map for physical interface "{}" '
+                    'with mac "{}".'.format(_bond_name, ifname, mac),
+                    level=DEBUG)
+                # for bonds we want to be able to get a list of the mac
+                # addresses for the physical interfaces the bond is made up of.
+                if self._ifname_mac_map.get(_bond_name):
+                    self._ifname_mac_map[_bond_name].append(mac)
+                else:
+                    self._ifname_mac_map[_bond_name] = [mac]
+
+        # In light of the pre-deprecation notice in the docstring of this
+        # class we will expose the ability to configure OVS bonds as a
+        # DPDK-only feature, but generally use the data structures internally.
+        if config(enable_dpdk_key):
+            # resolve PCI address of interfaces listed in the bridges and bonds
+            # charm configuration options.  Note that for already bound
+            # interfaces the helper will retrieve MAC address from the unit
+            # KV store as the information is no longer available in sysfs.
+            _pci_bridge_mac = resolve_pci_from_mapping_config(
+                bridges_key)
+            _pci_bond_mac = resolve_pci_from_mapping_config(
+                bonds_key)
+
+            for pci_address, bridge_mac in _pci_bridge_mac.items():
+                if bridge_mac.mac in self._mac_ifname_map:
+                    # if we already have the interface name in our map it is
+                    # visible to the system and therefore not bound to DPDK
+                    continue
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[ifname] = [bridge_mac.mac]
+                self._mac_ifname_map[bridge_mac.mac] = ifname
+                self._mac_pci_address_map[bridge_mac.mac] = pci_address
+
+            for pci_address, bond_mac in _pci_bond_mac.items():
+                # for bonds we want to be able to get a list of macs from
+                # the bond name and also get at the interface name made up
+                # of the hash of the PCI address
+                ifname = 'dpdk-{}'.format(
+                    hashlib.sha1(
+                        pci_address.encode('UTF-8')).hexdigest()[:7])
+                self._ifname_mac_map[bond_mac.entity].append(bond_mac.mac)
+                self._mac_ifname_map[bond_mac.mac] = ifname
+                self._mac_pci_address_map[bond_mac.mac] = pci_address
+
+        config_bridges = config(bridges_key) or ''
+        for bridge, ifname_or_mac in (
+                pair.split(':', 1)
+                for pair in config_bridges.split()):
+            if ':' in ifname_or_mac:
+                try:
+                    ifname = self.ifname_from_mac(ifname_or_mac)
+                except KeyError:
+                    # The interface is destined for a different unit in the
+                    # deployment.
+                    continue
+                macs = [ifname_or_mac]
+            else:
+                ifname = ifname_or_mac
+                macs = self.macs_from_ifname(ifname_or_mac)
+
+            portname = ifname
+            for mac in macs:
+                try:
+                    pci_address = self.pci_address_from_mac(mac)
+                    iftype = self.interface_type.dpdk
+                    ifname = self.ifname_from_mac(mac)
+                except KeyError:
+                    pci_address = None
+                    iftype = self.interface_type.system
+
+                self.add_interface(
+                    bridge, portname, ifname, iftype, pci_address, global_mtu)
+
+            if not macs:
+                # We have not mapped the interface and it is probably some sort
+                # of virtual interface. Our user have put it in the config with
+                # a purpose so let's carry out their wish. LP: #1884743
+                log('Add unmapped interface from config: name "{}" bridge "{}"'
+                    .format(ifname, bridge),
+                    level=DEBUG)
+                self.add_interface(
+                    bridge, ifname, ifname, self.interface_type.system, None,
+                    global_mtu)
+
+    def __getitem__(self, key):
+        """Provide a Dict-like interface, get value of item.
+
+        :param key: Key to look up value from.
+        :type key: any
+        :returns: Value
+        :rtype: any
+        """
+        return self._map.__getitem__(key)
+
+    def __iter__(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.__iter__()
+
+    def __len__(self):
+        """Provide a Dict-like interface, measure the length of internal map.
+
+        :returns: Length
+        :rtype: int
+        """
+        return len(self._map)
+
+    def items(self):
+        """Provide a Dict-like interface, iterate over items.
+
+        :returns: Key Value pairs
+        :rtype: Iterator[any, any]
+        """
+        return self._map.items()
+
+    def keys(self):
+        """Provide a Dict-like interface, iterate over keys.
+
+        :returns: Iterator
+        :rtype: Iterator[any]
+        """
+        return self._map.keys()
+
+    def ifname_from_mac(self, mac):
+        """
+        :returns: Name of interface
+        :rtype: str
+        :raises: KeyError
+        """
+        return (get_bond_master(self._mac_ifname_map[mac]) or
+                self._mac_ifname_map[mac])
+
+    def macs_from_ifname(self, ifname):
+        """
+        :returns: List of hardware address (MAC) of interface
+        :rtype: List[str]
+        :raises: KeyError
+        """
+        return self._ifname_mac_map[ifname]
+
+    def pci_address_from_mac(self, mac):
+        """
+        :param mac: Hardware address (MAC) of interface
+        :type mac: str
+        :returns: PCI address of device associated with mac
+        :rtype: str
+        :raises: KeyError
+        """
+        return self._mac_pci_address_map[mac]
+
+    def add_interface(self, bridge, port, ifname, iftype,
+                      pci_address, mtu_request):
+        """Add an interface to the map.
+
+        :param bridge: Name of bridge on which the bond will be added
+        :type bridge: str
+        :param port: Name of port which will represent the bond on bridge
+        :type port: str
+        :param ifname: Name of interface that will make up the bonded port
+        :type ifname: str
+        :param iftype: Type of interface
+        :type iftype: BridgeBondMap.interface_type
+        :param pci_address: PCI address of interface
+        :type pci_address: Optional[str]
+        :param mtu_request: MTU to request for interface
+        :type mtu_request: Optional[int]
+        """
+        self._map[bridge][port][ifname] = {
+            'type': str(iftype),
+        }
+        if pci_address:
+            self._map[bridge][port][ifname].update({
+                'pci-address': pci_address,
+            })
+        if mtu_request is not None:
+            self._map[bridge][port][ifname].update({
+                'mtu-request': str(mtu_request)
+            })
+
+    def get_ifdatamap(self, bridge, port):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bridge: Name of bridge on which the port will be added
+        :type bridge: str
+        :param port: Name of port which will represent one or more interfaces
+        :type port: str
+        """
+        for _bridge, _ports in self.items():
+            for _port, _interfaces in _ports.items():
+                if _bridge == bridge and _port == port:
+                    ifdatamap = {}
+                    for name, data in _interfaces.items():
+                        ifdatamap.update({
+                            name: {
+                                'type': data['type'],
+                            },
+                        })
+                        if data.get('mtu-request') is not None:
+                            ifdatamap[name].update({
+                                'mtu_request': data['mtu-request'],
+                            })
+                        if data.get('pci-address'):
+                            ifdatamap[name].update({
+                                'options': {
+                                    'dpdk-devargs': data['pci-address'],
+                                },
+                            })
+                    return ifdatamap
+
+
+class BondConfig(object):
+    """Container and helpers for bond configuration options.
+
+    Data is put into a dictionary and a convenient config get interface is
+    provided.
+    """
+
+    DEFAULT_LACP_CONFIG = {
+        'mode': 'balance-tcp',
+        'lacp': 'active',
+        'lacp-time': 'fast'
+    }
+    ALL_BONDS = 'ALL_BONDS'
+
+    BOND_MODES = ['active-backup', 'balance-slb', 'balance-tcp']
+    BOND_LACP = ['active', 'passive', 'off']
+    BOND_LACP_TIME = ['fast', 'slow']
+
+    def __init__(self, config_key=None):
+        """Parse specified configuration option.
+
+        :param config_key: Configuration key to retrieve data from
+                           (default: ``dpdk-bond-config``)
+        :type config_key: Optional[str]
+        """
+        self.config_key = config_key or 'dpdk-bond-config'
+
+        self.lacp_config = {
+            self.ALL_BONDS: copy.deepcopy(self.DEFAULT_LACP_CONFIG)
+        }
+
+        lacp_config = config(self.config_key)
+        if lacp_config:
+            lacp_config_map = lacp_config.split()
+            for entry in lacp_config_map:
+                bond, entry = entry.partition(':')[0:3:2]
+                if not bond:
+                    bond = self.ALL_BONDS
+
+                mode, entry = entry.partition(':')[0:3:2]
+                if not mode:
+                    mode = self.DEFAULT_LACP_CONFIG['mode']
+                assert mode in self.BOND_MODES, \
+                    "Bond mode {} is invalid".format(mode)
+
+                lacp, entry = entry.partition(':')[0:3:2]
+                if not lacp:
+                    lacp = self.DEFAULT_LACP_CONFIG['lacp']
+                assert lacp in self.BOND_LACP, \
+                    "Bond lacp {} is invalid".format(lacp)
+
+                lacp_time, entry = entry.partition(':')[0:3:2]
+                if not lacp_time:
+                    lacp_time = self.DEFAULT_LACP_CONFIG['lacp-time']
+                assert lacp_time in self.BOND_LACP_TIME, \
+                    "Bond lacp-time {} is invalid".format(lacp_time)
+
+                self.lacp_config[bond] = {
+                    'mode': mode,
+                    'lacp': lacp,
+                    'lacp-time': lacp_time
+                }
+
+    def get_bond_config(self, bond):
+        """Get the LACP configuration for a bond
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Dict[str,str]]
+        """
+        return self.lacp_config.get(bond, self.lacp_config[self.ALL_BONDS])
+
+    def get_ovs_portdata(self, bond):
+        """Get structure suitable for charmhelpers.contrib.network.ovs helpers.
+
+        :param bond: the bond name
+        :return: a dictionary with the configuration of the bond
+        :rtype: Dict[str,Union[str,Dict[str,str]]]
+        """
+        bond_config = self.get_bond_config(bond)
+        return {
+            'bond_mode': bond_config['mode'],
+            'lacp': bond_config['lacp'],
+            'other_config': {
+                'lacp-time': bond_config['lacp-time'],
+            },
+        }
+
+
+class SRIOVContext(OSContextGenerator):
+    """Provide context for configuring SR-IOV devices."""
+
+    class sriov_config_mode(enum.Enum):
+        """Mode in which SR-IOV is configured.
+
+        The configuration option identified by the ``numvfs_key`` parameter
+        is overloaded and defines in which mode the charm should interpret
+        the other SR-IOV-related configuration options.
+        """
+        auto = 'auto'
+        blanket = 'blanket'
+        explicit = 'explicit'
+
+    def _determine_numvfs(self, device, sriov_numvfs):
+        """Determine number of Virtual Functions (VFs) configured for device.
+
+        :param device: Object describing a PCI Network interface card (NIC)/
+        :type device: sriov_netplan_shim.pci.PCINetDevice
+        :param sriov_numvfs: Number of VFs requested for blanket configuration.
+        :type sriov_numvfs: int
+        :returns: Number of VFs to configure for device
+        :rtype: Optional[int]
+        """
+
+        def _get_capped_numvfs(requested):
+            """Get a number of VFs that does not exceed individual card limits.
+
+            Depending and make and model of NIC the number of VFs supported
+            vary.  Requesting more VFs than a card support would be a fatal
+            error, cap the requested number at the total number of VFs each
+            individual card supports.
+
+            :param requested: Number of VFs requested
+            :type requested: int
+            :returns: Number of VFs allowed
+            :rtype: int
+            """
+            actual = min(int(requested), int(device.sriov_totalvfs))
+            if actual < int(requested):
+                log('Requested VFs ({}) too high for device {}. Falling back '
+                    'to value supprted by device: {}'
+                    .format(requested, device.interface_name,
+                            device.sriov_totalvfs),
+                    level=WARNING)
+            return actual
+
+        if self._sriov_config_mode == self.sriov_config_mode.auto:
+            # auto-mode
+            #
+            # If device mapping configuration is present, return information
+            # on cards with mapping.
+            #
+            # If no device mapping configuration is present, return information
+            # for all cards.
+            #
+            # The maximum number of VFs supported by card will be used.
+            if (self._sriov_mapped_devices and
+                    device.interface_name not in self._sriov_mapped_devices):
+                log('SR-IOV configured in auto mode: No device mapping for {}'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(device.sriov_totalvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.blanket:
+            # blanket-mode
+            #
+            # User has specified a number of VFs that should apply to all
+            # cards with support for VFs.
+            return _get_capped_numvfs(sriov_numvfs)
+        elif self._sriov_config_mode == self.sriov_config_mode.explicit:
+            # explicit-mode
+            #
+            # User has given a list of interface names and associated number of
+            # VFs
+            if device.interface_name not in self._sriov_config_devices:
+                log('SR-IOV configured in explicit mode: No device:numvfs '
+                    'pair for device {}, skipping.'
+                    .format(device.interface_name),
+                    level=DEBUG)
+                return
+            return _get_capped_numvfs(
+                self._sriov_config_devices[device.interface_name])
+        else:
+            raise RuntimeError('This should not be reached')
+
+    def __init__(self, numvfs_key=None, device_mappings_key=None):
+        """Initialize map from PCI devices and configuration options.
+
+        :param numvfs_key: Config key for numvfs (default: 'sriov-numvfs')
+        :type numvfs_key: Optional[str]
+        :param device_mappings_key: Config key for device mappings
+                                    (default: 'sriov-device-mappings')
+        :type device_mappings_key: Optional[str]
+        :raises: RuntimeError
+        """
+        numvfs_key = numvfs_key or 'sriov-numvfs'
+        device_mappings_key = device_mappings_key or 'sriov-device-mappings'
+
+        devices = pci.PCINetDevices()
+        charm_config = config()
+        sriov_numvfs = charm_config.get(numvfs_key) or ''
+        sriov_device_mappings = charm_config.get(device_mappings_key) or ''
+
+        # create list of devices from sriov_device_mappings config option
+        self._sriov_mapped_devices = [
+            pair.split(':', 1)[1]
+            for pair in sriov_device_mappings.split()
+        ]
+
+        # create map of device:numvfs from sriov_numvfs config option
+        self._sriov_config_devices = {
+            ifname: numvfs for ifname, numvfs in (
+                pair.split(':', 1) for pair in sriov_numvfs.split()
+                if ':' in sriov_numvfs)
+        }
+
+        # determine configuration mode from contents of sriov_numvfs
+        if sriov_numvfs == 'auto':
+            self._sriov_config_mode = self.sriov_config_mode.auto
+        elif sriov_numvfs.isdigit():
+            self._sriov_config_mode = self.sriov_config_mode.blanket
+        elif ':' in sriov_numvfs:
+            self._sriov_config_mode = self.sriov_config_mode.explicit
+        else:
+            raise RuntimeError('Unable to determine mode of SR-IOV '
+                               'configuration.')
+
+        self._map = {
+            device.interface_name: self._determine_numvfs(device, sriov_numvfs)
+            for device in devices.pci_devices
+            if device.sriov and
+            self._determine_numvfs(device, sriov_numvfs) is not None
+        }
+
+    def __call__(self):
+        """Provide SR-IOV context.
+
+        :returns: Map interface name: min(configured, max) virtual functions.
+        Example:
+           {
+               'eth0': 16,
+               'eth1': 32,
+               'eth2': 64,
+           }
+        :rtype: Dict[str,int]
+        """
+        return self._map
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..f85ae4f4cdbb6567cbdd896338bf88fbf3c9c0ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/exceptions.py
@@ -0,0 +1,21 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+class OSContextError(Exception):
+    """Raised when an error occurs during context generation.
+
+    This exception is principally used in contrib.openstack.context
+    """
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy.sh
new file mode 100755
index 0000000000000000000000000000000000000000..1df55db4816ec51d6732d68ea0a1e25e6f7b116e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy.sh
@@ -0,0 +1,34 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+CRITICAL=0
+NOTACTIVE=''
+LOGFILE=/var/log/nagios/check_haproxy.log
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+typeset -i N_INSTANCES=0
+for appserver in $(awk '/^\s+server/{print $2}' /etc/haproxy/haproxy.cfg)
+do
+    N_INSTANCES=N_INSTANCES+1
+    output=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' --regex=",${appserver},.*,UP.*" -e ' 200 OK')
+    if [ $? != 0 ]; then
+        date >> $LOGFILE
+        echo $output >> $LOGFILE
+        /usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v | grep ",${appserver}," >> $LOGFILE 2>&1
+        CRITICAL=1
+        NOTACTIVE="${NOTACTIVE} $appserver"
+    fi
+done
+
+if [ $CRITICAL = 1 ]; then
+    echo "CRITICAL:${NOTACTIVE}"
+    exit 2
+fi
+
+echo "OK: All haproxy instances ($N_INSTANCES) looking good"
+exit 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
new file mode 100755
index 0000000000000000000000000000000000000000..91ce0246e66115994c3f518b36448f70100ecfc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/files/check_haproxy_queue_depth.sh
@@ -0,0 +1,30 @@
+#!/bin/bash
+#--------------------------------------------
+# This file is managed by Juju
+#--------------------------------------------
+#                                       
+# Copyright 2009,2012 Canonical Ltd.
+# Author: Tom Haddon
+
+# These should be config options at some stage
+CURRQthrsh=0
+MAXQthrsh=100
+
+AUTH=$(grep -r "stats auth" /etc/haproxy/haproxy.cfg | awk 'NR=1{print $3}')
+
+HAPROXYSTATS=$(/usr/lib/nagios/plugins/check_http -a ${AUTH} -I 127.0.0.1 -p 8888 -u '/;csv' -v)
+
+for BACKEND in $(echo $HAPROXYSTATS| xargs -n1 | grep BACKEND | awk -F , '{print $1}')
+do
+    CURRQ=$(echo "$HAPROXYSTATS" | grep $BACKEND | grep BACKEND | cut -d , -f 3)
+    MAXQ=$(echo "$HAPROXYSTATS"  | grep $BACKEND | grep BACKEND | cut -d , -f 4)
+
+    if [[ $CURRQ -gt $CURRQthrsh || $MAXQ -gt $MAXQthrsh ]] ; then
+        echo "CRITICAL: queue depth for $BACKEND - CURRENT:$CURRQ MAX:$MAXQ"
+        exit 2
+    fi
+done
+
+echo "OK: All haproxy queue depths looking good"
+exit 0
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b088de84e4b288b551603816fc10eebfa7b1503
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5cbdf535d495a09a0b91f41fdda09862e34140d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ha/utils.py
@@ -0,0 +1,348 @@
+# Copyright 2014-2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2016 Canonical Ltd.
+#
+# Authors:
+#  Openstack Charmers <
+#
+
+"""
+Helpers for high availability.
+"""
+
+import hashlib
+import json
+
+import re
+
+from charmhelpers.core.hookenv import (
+    expected_related_units,
+    log,
+    relation_set,
+    charm_name,
+    config,
+    status_set,
+    DEBUG,
+)
+
+from charmhelpers.core.host import (
+    lsb_release
+)
+
+from charmhelpers.contrib.openstack.ip import (
+    resolve_address,
+    is_ipv6,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_iface_for_address,
+    get_netmask_for_address,
+)
+
+from charmhelpers.contrib.hahelpers.cluster import (
+    get_hacluster_config
+)
+
+JSON_ENCODE_OPTIONS = dict(
+    sort_keys=True,
+    allow_nan=False,
+    indent=None,
+    separators=(',', ':'),
+)
+
+VIP_GROUP_NAME = 'grp_{service}_vips'
+DNSHA_GROUP_NAME = 'grp_{service}_hostnames'
+
+
+class DNSHAException(Exception):
+    """Raised when an error occurs setting up DNS HA
+    """
+
+    pass
+
+
+def update_dns_ha_resource_params(resources, resource_params,
+                                  relation_id=None,
+                                  crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration and
+    update resource dictionaries for the HA relation.
+
+    @param resources: Pointer to dictionary of resources.
+                      Usually instantiated in ha_joined().
+    @param resource_params: Pointer to dictionary of resource parameters.
+                            Usually instantiated in ha_joined()
+    @param relation_id: Relation ID of the ha relation
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+    update_hacluster_dns_ha(charm_name(),
+                            _relation_data,
+                            crm_ocf)
+    resources.update(_relation_data['resources'])
+    resource_params.update(_relation_data['resource_params'])
+    relation_set(relation_id=relation_id, groups=_relation_data['groups'])
+
+
+def assert_charm_supports_dns_ha():
+    """Validate prerequisites for DNS HA
+    The MAAS client is only available on Xenial or greater
+
+    :raises DNSHAException: if release is < 16.04
+    """
+    if lsb_release().get('DISTRIB_RELEASE') < '16.04':
+        msg = ('DNS HA is only supported on 16.04 and greater '
+               'versions of Ubuntu.')
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+    return True
+
+
+def expect_ha():
+    """ Determine if the unit expects to be in HA
+
+    Check juju goal-state if ha relation is expected, check for VIP or dns-ha
+    settings which indicate the unit should expect to be related to hacluster.
+
+    @returns boolean
+    """
+    ha_related_units = []
+    try:
+        ha_related_units = list(expected_related_units(reltype='ha'))
+    except (NotImplementedError, KeyError):
+        pass
+    return len(ha_related_units) > 0 or config('vip') or config('dns-ha')
+
+
+def generate_ha_relation_data(service,
+                              extra_settings=None,
+                              haproxy_enabled=True):
+    """ Generate relation data for ha relation
+
+    Based on configuration options and unit interfaces, generate a json
+    encoded dict of relation data items for the hacluster relation,
+    providing configuration for DNS HA or VIP's + haproxy clone sets.
+
+    Example of supplying additional settings::
+
+        COLO_CONSOLEAUTH = 'inf: res_nova_consoleauth grp_nova_vips'
+        AGENT_CONSOLEAUTH = 'ocf:openstack:nova-consoleauth'
+        AGENT_CA_PARAMS = 'op monitor interval="5s"'
+
+        ha_console_settings = {
+            'colocations': {'vip_consoleauth': COLO_CONSOLEAUTH},
+            'init_services': {'res_nova_consoleauth': 'nova-consoleauth'},
+            'resources': {'res_nova_consoleauth': AGENT_CONSOLEAUTH},
+            'resource_params': {'res_nova_consoleauth': AGENT_CA_PARAMS})
+        generate_ha_relation_data('nova', extra_settings=ha_console_settings)
+
+
+    @param service: Name of the service being configured
+    @param extra_settings: Dict of additional resource data
+    @returns dict: json encoded data for use with relation_set
+    """
+    _relation_data = {'resources': {}, 'resource_params': {}}
+
+    if haproxy_enabled:
+        _meta = 'meta migration-threshold="INFINITY" failure-timeout="5s"'
+        _haproxy_res = 'res_{}_haproxy'.format(service)
+        _relation_data['resources'] = {_haproxy_res: 'lsb:haproxy'}
+        _relation_data['resource_params'] = {
+            _haproxy_res: '{} op monitor interval="5s"'.format(_meta)
+        }
+        _relation_data['init_services'] = {_haproxy_res: 'haproxy'}
+        _relation_data['clones'] = {
+            'cl_{}_haproxy'.format(service): _haproxy_res
+        }
+
+    if extra_settings:
+        for k, v in extra_settings.items():
+            if _relation_data.get(k):
+                _relation_data[k].update(v)
+            else:
+                _relation_data[k] = v
+
+    if config('dns-ha'):
+        update_hacluster_dns_ha(service, _relation_data)
+    else:
+        update_hacluster_vip(service, _relation_data)
+
+    return {
+        'json_{}'.format(k): json.dumps(v, **JSON_ENCODE_OPTIONS)
+        for k, v in _relation_data.items() if v
+    }
+
+
+def update_hacluster_dns_ha(service, relation_data,
+                            crm_ocf='ocf:maas:dns'):
+    """ Configure DNS-HA resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    @param crm_ocf: Corosync Open Cluster Framework resource agent to use for
+                    DNS HA
+    """
+    # Validate the charm environment for DNS HA
+    assert_charm_supports_dns_ha()
+
+    settings = ['os-admin-hostname', 'os-internal-hostname',
+                'os-public-hostname', 'os-access-hostname']
+
+    # Check which DNS settings are set and update dictionaries
+    hostname_group = []
+    for setting in settings:
+        hostname = config(setting)
+        if hostname is None:
+            log('DNS HA: Hostname setting {} is None. Ignoring.'
+                ''.format(setting),
+                DEBUG)
+            continue
+        m = re.search('os-(.+?)-hostname', setting)
+        if m:
+            endpoint_type = m.group(1)
+            # resolve_address's ADDRESS_MAP uses 'int' not 'internal'
+            if endpoint_type == 'internal':
+                endpoint_type = 'int'
+        else:
+            msg = ('Unexpected DNS hostname setting: {}. '
+                   'Cannot determine endpoint_type name'
+                   ''.format(setting))
+            status_set('blocked', msg)
+            raise DNSHAException(msg)
+
+        hostname_key = 'res_{}_{}_hostname'.format(service, endpoint_type)
+        if hostname_key in hostname_group:
+            log('DNS HA: Resource {}: {} already exists in '
+                'hostname group - skipping'.format(hostname_key, hostname),
+                DEBUG)
+            continue
+
+        hostname_group.append(hostname_key)
+        relation_data['resources'][hostname_key] = crm_ocf
+        relation_data['resource_params'][hostname_key] = (
+            'params fqdn="{}" ip_address="{}"'
+            .format(hostname, resolve_address(endpoint_type=endpoint_type,
+                                              override=False)))
+
+    if len(hostname_group) >= 1:
+        log('DNS HA: Hostname group is set with {} as members. '
+            'Informing the ha relation'.format(' '.join(hostname_group)),
+            DEBUG)
+        relation_data['groups'] = {
+            DNSHA_GROUP_NAME.format(service=service): ' '.join(hostname_group)
+        }
+    else:
+        msg = 'DNS HA: Hostname group has no members.'
+        status_set('blocked', msg)
+        raise DNSHAException(msg)
+
+
+def get_vip_settings(vip):
+    """Calculate which nic is on the correct network for the given vip.
+
+    If nic or netmask discovery fail then fallback to using charm supplied
+    config. If fallback is used this is indicated via the fallback variable.
+
+    @param vip: VIP to lookup nic and cidr for.
+    @returns (str, str, bool): eg (iface, netmask, fallback)
+    """
+    iface = get_iface_for_address(vip)
+    netmask = get_netmask_for_address(vip)
+    fallback = False
+    if iface is None:
+        iface = config('vip_iface')
+        fallback = True
+    if netmask is None:
+        netmask = config('vip_cidr')
+        fallback = True
+    return iface, netmask, fallback
+
+
+def update_hacluster_vip(service, relation_data):
+    """ Configure VIP resources based on provided configuration
+
+    @param service: Name of the service being configured
+    @param relation_data: Pointer to dictionary of relation data.
+    """
+    cluster_config = get_hacluster_config()
+    vip_group = []
+    vips_to_delete = []
+    for vip in cluster_config['vip'].split():
+        if is_ipv6(vip):
+            res_vip = 'ocf:heartbeat:IPv6addr'
+            vip_params = 'ipv6addr'
+        else:
+            res_vip = 'ocf:heartbeat:IPaddr2'
+            vip_params = 'ip'
+
+        iface, netmask, fallback = get_vip_settings(vip)
+
+        vip_monitoring = 'op monitor timeout="20s" interval="10s" depth="0"'
+        if iface is not None:
+            # NOTE(jamespage): Delete old VIP resources
+            # Old style naming encoding iface in name
+            # does not work well in environments where
+            # interface/subnet wiring is not consistent
+            vip_key = 'res_{}_{}_vip'.format(service, iface)
+            if vip_key in vips_to_delete:
+                vip_key = '{}_{}'.format(vip_key, vip_params)
+            vips_to_delete.append(vip_key)
+
+            vip_key = 'res_{}_{}_vip'.format(
+                service,
+                hashlib.sha1(vip.encode('UTF-8')).hexdigest()[:7])
+
+            relation_data['resources'][vip_key] = res_vip
+            # NOTE(jamespage):
+            # Use option provided vip params if these where used
+            # instead of auto-detected values
+            if fallback:
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" cidr_netmask="{netmask}" '
+                    'nic="{iface}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        iface=iface,
+                        netmask=netmask,
+                        vip_monitoring=vip_monitoring))
+            else:
+                # NOTE(jamespage):
+                # let heartbeat figure out which interface and
+                # netmask to configure, which works nicely
+                # when network interface naming is not
+                # consistent across units.
+                relation_data['resource_params'][vip_key] = (
+                    'params {ip}="{vip}" {vip_monitoring}'.format(
+                        ip=vip_params,
+                        vip=vip,
+                        vip_monitoring=vip_monitoring))
+
+            vip_group.append(vip_key)
+
+    if vips_to_delete:
+        try:
+            relation_data['delete_resources'].extend(vips_to_delete)
+        except KeyError:
+            relation_data['delete_resources'] = vips_to_delete
+
+    if len(vip_group) >= 1:
+        key = VIP_GROUP_NAME.format(service=service)
+        try:
+            relation_data['groups'][key] = ' '.join(vip_group)
+        except KeyError:
+            relation_data['groups'] = {
+                key: ' '.join(vip_group)
+            }
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..723aebc172e94a5b00c385d9861dd4d45c1bc753
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ip.py
@@ -0,0 +1,197 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from charmhelpers.core.hookenv import (
+    NoNetworkBinding,
+    config,
+    unit_get,
+    service_name,
+    network_get_primary_address,
+)
+from charmhelpers.contrib.network.ip import (
+    get_address_in_network,
+    is_address_in_network,
+    is_ipv6,
+    get_ipv6_addr,
+    resolve_network_cidr,
+)
+from charmhelpers.contrib.hahelpers.cluster import is_clustered
+
+PUBLIC = 'public'
+INTERNAL = 'int'
+ADMIN = 'admin'
+ACCESS = 'access'
+
+ADDRESS_MAP = {
+    PUBLIC: {
+        'binding': 'public',
+        'config': 'os-public-network',
+        'fallback': 'public-address',
+        'override': 'os-public-hostname',
+    },
+    INTERNAL: {
+        'binding': 'internal',
+        'config': 'os-internal-network',
+        'fallback': 'private-address',
+        'override': 'os-internal-hostname',
+    },
+    ADMIN: {
+        'binding': 'admin',
+        'config': 'os-admin-network',
+        'fallback': 'private-address',
+        'override': 'os-admin-hostname',
+    },
+    ACCESS: {
+        'binding': 'access',
+        'config': 'access-network',
+        'fallback': 'private-address',
+        'override': 'os-access-hostname',
+    },
+}
+
+
+def canonical_url(configs, endpoint_type=PUBLIC):
+    """Returns the correct HTTP URL to this host given the state of HTTPS
+    configuration, hacluster and charm configuration.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :param endpoint_type: str endpoint type to resolve.
+    :param returns: str base URL for services on the current service unit.
+    """
+    scheme = _get_scheme(configs)
+
+    address = resolve_address(endpoint_type)
+    if is_ipv6(address):
+        address = "[{}]".format(address)
+
+    return '%s://%s' % (scheme, address)
+
+
+def _get_scheme(configs):
+    """Returns the scheme to use for the url (either http or https)
+    depending upon whether https is in the configs value.
+
+    :param configs: OSTemplateRenderer config templating object to inspect
+                    for a complete https context.
+    :returns: either 'http' or 'https' depending on whether https is
+              configured within the configs context.
+    """
+    scheme = 'http'
+    if configs and 'https' in configs.complete_contexts():
+        scheme = 'https'
+    return scheme
+
+
+def _get_address_override(endpoint_type=PUBLIC):
+    """Returns any address overrides that the user has defined based on the
+    endpoint type.
+
+    Note: this function allows for the service name to be inserted into the
+    address if the user specifies {service_name}.somehost.org.
+
+    :param endpoint_type: the type of endpoint to retrieve the override
+                          value for.
+    :returns: any endpoint address or hostname that the user has overridden
+              or None if an override is not present.
+    """
+    override_key = ADDRESS_MAP[endpoint_type]['override']
+    addr_override = config(override_key)
+    if not addr_override:
+        return None
+    else:
+        return addr_override.format(service_name=service_name())
+
+
+def resolve_address(endpoint_type=PUBLIC, override=True):
+    """Return unit address depending on net config.
+
+    If unit is clustered with vip(s) and has net splits defined, return vip on
+    correct network. If clustered with no nets defined, return primary vip.
+
+    If not clustered, return unit address ensuring address is on configured net
+    split if one is configured, or a Juju 2.0 extra-binding has been used.
+
+    :param endpoint_type: Network endpoing type
+    :param override: Accept hostname overrides or not
+    """
+    resolved_address = None
+    if override:
+        resolved_address = _get_address_override(endpoint_type)
+        if resolved_address:
+            return resolved_address
+
+    vips = config('vip')
+    if vips:
+        vips = vips.split()
+
+    net_type = ADDRESS_MAP[endpoint_type]['config']
+    net_addr = config(net_type)
+    net_fallback = ADDRESS_MAP[endpoint_type]['fallback']
+    binding = ADDRESS_MAP[endpoint_type]['binding']
+    clustered = is_clustered()
+
+    if clustered and vips:
+        if net_addr:
+            for vip in vips:
+                if is_address_in_network(net_addr, vip):
+                    resolved_address = vip
+                    break
+        else:
+            # NOTE: endeavour to check vips against network space
+            #       bindings
+            try:
+                bound_cidr = resolve_network_cidr(
+                    network_get_primary_address(binding)
+                )
+                for vip in vips:
+                    if is_address_in_network(bound_cidr, vip):
+                        resolved_address = vip
+                        break
+            except (NotImplementedError, NoNetworkBinding):
+                # If no net-splits configured and no support for extra
+                # bindings/network spaces so we expect a single vip
+                resolved_address = vips[0]
+    else:
+        if config('prefer-ipv6'):
+            fallback_addr = get_ipv6_addr(exc_list=vips)[0]
+        else:
+            fallback_addr = unit_get(net_fallback)
+
+        if net_addr:
+            resolved_address = get_address_in_network(net_addr, fallback_addr)
+        else:
+            # NOTE: only try to use extra bindings if legacy network
+            #       configuration is not in use
+            try:
+                resolved_address = network_get_primary_address(binding)
+            except (NotImplementedError, NoNetworkBinding):
+                resolved_address = fallback_addr
+
+    if resolved_address is None:
+        raise ValueError("Unable to resolve a suitable IP address based on "
+                         "charm state and configuration. (net_type=%s, "
+                         "clustered=%s)" % (net_type, clustered))
+
+    return resolved_address
+
+
+def get_vip_in_network(network):
+    matching_vip = None
+    vips = config('vip')
+    if vips:
+        for vip in vips.split():
+            if is_address_in_network(network, vip):
+                matching_vip = vip
+    return matching_vip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/keystone.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/keystone.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7e02ccd90155710901e444482b589aa264158e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/keystone.py
@@ -0,0 +1,178 @@
+#!/usr/bin/python
+#
+# Copyright 2017 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+from charmhelpers.fetch import apt_install
+from charmhelpers.contrib.openstack.context import IdentityServiceContext
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+)
+
+
+def get_api_suffix(api_version):
+    """Return the formatted api suffix for the given version
+    @param api_version: version of the keystone endpoint
+    @returns the api suffix formatted according to the given api
+    version
+    """
+    return 'v2.0' if api_version in (2, "2", "2.0") else 'v3'
+
+
+def format_endpoint(schema, addr, port, api_version):
+    """Return a formatted keystone endpoint
+    @param schema: http or https
+    @param addr: ipv4/ipv6 host of the keystone service
+    @param port: port of the keystone service
+    @param api_version: 2 or 3
+    @returns a fully formatted keystone endpoint
+    """
+    return '{}://{}:{}/{}/'.format(schema, addr, port,
+                                   get_api_suffix(api_version))
+
+
+def get_keystone_manager(endpoint, api_version, **kwargs):
+    """Return a keystonemanager for the correct API version
+
+    @param endpoint: the keystone endpoint to point client at
+    @param api_version: version of the keystone api the client should use
+    @param kwargs: token or username/tenant/password information
+    @returns keystonemanager class used for interrogating keystone
+    """
+    if api_version == 2:
+        return KeystoneManager2(endpoint, **kwargs)
+    if api_version == 3:
+        return KeystoneManager3(endpoint, **kwargs)
+    raise ValueError('No manager found for api version {}'.format(api_version))
+
+
+def get_keystone_manager_from_identity_service_context():
+    """Return a keystonmanager generated from a
+    instance of charmhelpers.contrib.openstack.context.IdentityServiceContext
+    @returns keystonamenager instance
+   """
+    context = IdentityServiceContext()()
+    if not context:
+        msg = "Identity service context cannot be generated"
+        log(msg, level=ERROR)
+        raise ValueError(msg)
+
+    endpoint = format_endpoint(context['service_protocol'],
+                               context['service_host'],
+                               context['service_port'],
+                               context['api_version'])
+
+    if context['api_version'] in (2, "2.0"):
+        api_version = 2
+    else:
+        api_version = 3
+
+    return get_keystone_manager(endpoint, api_version,
+                                username=context['admin_user'],
+                                password=context['admin_password'],
+                                tenant_name=context['admin_tenant_name'])
+
+
+class KeystoneManager(object):
+
+    def resolve_service_id(self, service_name=None, service_type=None):
+        """Find the service_id of a given service"""
+        services = [s._info for s in self.api.services.list()]
+
+        service_name = service_name.lower()
+        for s in services:
+            name = s['name'].lower()
+            if service_type and service_name:
+                if (service_name == name and service_type == s['type']):
+                    return s['id']
+            elif service_name and service_name == name:
+                return s['id']
+            elif service_type and service_type == s['type']:
+                return s['id']
+        return None
+
+    def service_exists(self, service_name=None, service_type=None):
+        """Determine if the given service exists on the service list"""
+        return self.resolve_service_id(service_name, service_type) is not None
+
+
+class KeystoneManager2(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v2_0 import client
+            from keystoneclient.auth.identity import v2
+            from keystoneclient import session
+
+        self.api_version = 2
+
+        token = kwargs.get("token", None)
+        if token:
+            api = client.Client(endpoint=endpoint, token=token)
+        else:
+            auth = v2.Password(username=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               tenant_name=kwargs.get("tenant_name"),
+                               auth_url=endpoint)
+            sess = session.Session(auth=auth)
+            api = client.Client(session=sess)
+
+        self.api = api
+
+
+class KeystoneManager3(KeystoneManager):
+
+    def __init__(self, endpoint, **kwargs):
+        try:
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+        except ImportError:
+            if six.PY2:
+                apt_install(["python-keystoneclient"], fatal=True)
+            else:
+                apt_install(["python3-keystoneclient"], fatal=True)
+
+            from keystoneclient.v3 import client
+            from keystoneclient.auth import token_endpoint
+            from keystoneclient import session
+            from keystoneclient.auth.identity import v3
+
+        self.api_version = 3
+
+        token = kwargs.get("token", None)
+        if token:
+            auth = token_endpoint.Token(endpoint=endpoint,
+                                        token=token)
+            sess = session.Session(auth=auth)
+        else:
+            auth = v3.Password(auth_url=endpoint,
+                               user_id=kwargs.get("username"),
+                               password=kwargs.get("password"),
+                               project_id=kwargs.get("tenant_name"))
+            sess = session.Session(auth=auth)
+
+        self.api = client.Client(session=sess)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/neutron.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/neutron.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb5607f3e73159d90236b2d7a4051aa82119e889
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/neutron.py
@@ -0,0 +1,359 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Various utilies for dealing with Neutron and the renaming from Quantum.
+
+import six
+from subprocess import check_output
+
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+    ERROR,
+)
+
+from charmhelpers.contrib.openstack.utils import (
+    os_release,
+    CompareOpenStackReleases,
+)
+
+
+def headers_package():
+    """Ensures correct linux-headers for running kernel are installed,
+    for building DKMS package"""
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    return 'linux-headers-%s' % kver
+
+
+QUANTUM_CONF_DIR = '/etc/quantum'
+
+
+def kernel_version():
+    """ Retrieve the current major kernel version as a tuple e.g. (3, 13) """
+    kver = check_output(['uname', '-r']).decode('UTF-8').strip()
+    kver = kver.split('.')
+    return (int(kver[0]), int(kver[1]))
+
+
+def determine_dkms_package():
+    """ Determine which DKMS package should be used based on kernel version """
+    # NOTE: 3.13 kernels have support for GRE and VXLAN native
+    if kernel_version() >= (3, 13):
+        return []
+    else:
+        return [headers_package(), 'openvswitch-datapath-dkms']
+
+
+# legacy
+
+
+def quantum_plugins():
+    return {
+        'ovs': {
+            'config': '/etc/quantum/plugins/openvswitch/'
+                      'ovs_quantum_plugin.ini',
+            'driver': 'quantum.plugins.openvswitch.ovs_quantum_plugin.'
+                      'OVSQuantumPluginV2',
+            'contexts': [],
+            'services': ['quantum-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['quantum-plugin-openvswitch-agent']],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-openvswitch'],
+            'server_services': ['quantum-server']
+        },
+        'nvp': {
+            'config': '/etc/quantum/plugins/nicira/nvp.ini',
+            'driver': 'quantum.plugins.nicira.nicira_nvp_plugin.'
+                      'QuantumPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['quantum-server',
+                                'quantum-plugin-nicira'],
+            'server_services': ['quantum-server']
+        }
+    }
+
+
+NEUTRON_CONF_DIR = '/etc/neutron'
+
+
+def neutron_plugins():
+    release = os_release('nova-common')
+    plugins = {
+        'ovs': {
+            'config': '/etc/neutron/plugins/openvswitch/'
+                      'ovs_neutron_plugin.ini',
+            'driver': 'neutron.plugins.openvswitch.ovs_neutron_plugin.'
+                      'OVSNeutronPluginV2',
+            'contexts': [],
+            'services': ['neutron-plugin-openvswitch-agent'],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-openvswitch-agent']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-openvswitch'],
+            'server_services': ['neutron-server']
+        },
+        'nvp': {
+            'config': '/etc/neutron/plugins/nicira/nvp.ini',
+            'driver': 'neutron.plugins.nicira.nicira_nvp_plugin.'
+                      'NeutronPlugin.NvpPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-nicira'],
+            'server_services': ['neutron-server']
+        },
+        'nsx': {
+            'config': '/etc/neutron/plugins/vmware/nsx.ini',
+            'driver': 'vmware',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-vmware'],
+            'server_services': ['neutron-server']
+        },
+        'n1kv': {
+            'config': '/etc/neutron/plugins/cisco/cisco_plugins.ini',
+            'driver': 'neutron.plugins.cisco.network_plugin.PluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package(),
+                         ['neutron-plugin-cisco']],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-cisco'],
+            'server_services': ['neutron-server']
+        },
+        'Calico': {
+            'config': '/etc/neutron/plugins/ml2/ml2_conf.ini',
+            'driver': 'neutron.plugins.ml2.plugin.Ml2Plugin',
+            'contexts': [],
+            'services': ['calico-felix',
+                         'bird',
+                         'neutron-dhcp-agent',
+                         'nova-api-metadata',
+                         'etcd'],
+            'packages': [determine_dkms_package(),
+                         ['calico-compute',
+                          'bird',
+                          'neutron-dhcp-agent',
+                          'nova-api-metadata',
+                          'etcd']],
+            'server_packages': ['neutron-server', 'calico-control', 'etcd'],
+            'server_services': ['neutron-server', 'etcd']
+        },
+        'vsp': {
+            'config': '/etc/neutron/plugins/nuage/nuage_plugin.ini',
+            'driver': 'neutron.plugins.nuage.plugin.NuagePlugin',
+            'contexts': [],
+            'services': [],
+            'packages': [],
+            'server_packages': ['neutron-server', 'neutron-plugin-nuage'],
+            'server_services': ['neutron-server']
+        },
+        'plumgrid': {
+            'config': '/etc/neutron/plugins/plumgrid/plumgrid.ini',
+            'driver': ('neutron.plugins.plumgrid.plumgrid_plugin'
+                       '.plumgrid_plugin.NeutronPluginPLUMgridV2'),
+            'contexts': [],
+            'services': [],
+            'packages': ['plumgrid-lxc',
+                         'iovisor-dkms'],
+            'server_packages': ['neutron-server',
+                                'neutron-plugin-plumgrid'],
+            'server_services': ['neutron-server']
+        },
+        'midonet': {
+            'config': '/etc/neutron/plugins/midonet/midonet.ini',
+            'driver': 'midonet.neutron.plugin.MidonetPluginV2',
+            'contexts': [],
+            'services': [],
+            'packages': [determine_dkms_package()],
+            'server_packages': ['neutron-server',
+                                'python-neutron-plugin-midonet'],
+            'server_services': ['neutron-server']
+        }
+    }
+    if CompareOpenStackReleases(release) >= 'icehouse':
+        # NOTE: patch in ml2 plugin for icehouse onwards
+        plugins['ovs']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['ovs']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['ovs']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+        # NOTE: patch in vmware renames nvp->nsx for icehouse onwards
+        plugins['nvp'] = plugins['nsx']
+    if CompareOpenStackReleases(release) >= 'kilo':
+        plugins['midonet']['driver'] = (
+            'neutron.plugins.midonet.plugin.MidonetPluginV2')
+    if CompareOpenStackReleases(release) >= 'liberty':
+        plugins['midonet']['driver'] = (
+            'midonet.neutron.plugin_v1.MidonetPluginV2')
+        plugins['midonet']['server_packages'].remove(
+            'python-neutron-plugin-midonet')
+        plugins['midonet']['server_packages'].append(
+            'python-networking-midonet')
+        plugins['plumgrid']['driver'] = (
+            'networking_plumgrid.neutron.plugins'
+            '.plugin.NeutronPluginPLUMgridV2')
+        plugins['plumgrid']['server_packages'].remove(
+            'neutron-plugin-plumgrid')
+    if CompareOpenStackReleases(release) >= 'mitaka':
+        plugins['nsx']['server_packages'].remove('neutron-plugin-vmware')
+        plugins['nsx']['server_packages'].append('python-vmware-nsx')
+        plugins['nsx']['config'] = '/etc/neutron/nsx.ini'
+        plugins['vsp']['driver'] = (
+            'nuage_neutron.plugins.nuage.plugin.NuagePlugin')
+    if CompareOpenStackReleases(release) >= 'newton':
+        plugins['vsp']['config'] = '/etc/neutron/plugins/ml2/ml2_conf.ini'
+        plugins['vsp']['driver'] = 'neutron.plugins.ml2.plugin.Ml2Plugin'
+        plugins['vsp']['server_packages'] = ['neutron-server',
+                                             'neutron-plugin-ml2']
+    return plugins
+
+
+def neutron_plugin_attribute(plugin, attr, net_manager=None):
+    manager = net_manager or network_manager()
+    if manager == 'quantum':
+        plugins = quantum_plugins()
+    elif manager == 'neutron':
+        plugins = neutron_plugins()
+    else:
+        log("Network manager '%s' does not support plugins." % (manager),
+            level=ERROR)
+        raise Exception
+
+    try:
+        _plugin = plugins[plugin]
+    except KeyError:
+        log('Unrecognised plugin for %s: %s' % (manager, plugin), level=ERROR)
+        raise Exception
+
+    try:
+        return _plugin[attr]
+    except KeyError:
+        return None
+
+
+def network_manager():
+    '''
+    Deals with the renaming of Quantum to Neutron in H and any situations
+    that require compatability (eg, deploying H with network-manager=quantum,
+    upgrading from G).
+    '''
+    release = os_release('nova-common')
+    manager = config('network-manager').lower()
+
+    if manager not in ['quantum', 'neutron']:
+        return manager
+
+    if release in ['essex']:
+        # E does not support neutron
+        log('Neutron networking not supported in Essex.', level=ERROR)
+        raise Exception
+    elif release in ['folsom', 'grizzly']:
+        # neutron is named quantum in F and G
+        return 'quantum'
+    else:
+        # ensure accurate naming for all releases post-H
+        return 'neutron'
+
+
+def parse_mappings(mappings, key_rvalue=False):
+    """By default mappings are lvalue keyed.
+
+    If key_rvalue is True, the mapping will be reversed to allow multiple
+    configs for the same lvalue.
+    """
+    parsed = {}
+    if mappings:
+        mappings = mappings.split()
+        for m in mappings:
+            p = m.partition(':')
+
+            if key_rvalue:
+                key_index = 2
+                val_index = 0
+                # if there is no rvalue skip to next
+                if not p[1]:
+                    continue
+            else:
+                key_index = 0
+                val_index = 2
+
+            key = p[key_index].strip()
+            parsed[key] = p[val_index].strip()
+
+    return parsed
+
+
+def parse_bridge_mappings(mappings):
+    """Parse bridge mappings.
+
+    Mappings must be a space-delimited list of provider:bridge mappings.
+
+    Returns dict of the form {provider:bridge}.
+    """
+    return parse_mappings(mappings)
+
+
+def parse_data_port_mappings(mappings, default_bridge='br-data'):
+    """Parse data port mappings.
+
+    Mappings must be a space-delimited list of bridge:port.
+
+    Returns dict of the form {port:bridge} where ports may be mac addresses or
+    interface names.
+    """
+
+    # NOTE(dosaboy): we use rvalue for key to allow multiple values to be
+    # proposed for <port> since it may be a mac address which will differ
+    # across units this allowing first-known-good to be chosen.
+    _mappings = parse_mappings(mappings, key_rvalue=True)
+    if not _mappings or list(_mappings.values()) == ['']:
+        if not mappings:
+            return {}
+
+        # For backwards-compatibility we need to support port-only provided in
+        # config.
+        _mappings = {mappings.split()[0]: default_bridge}
+
+    ports = _mappings.keys()
+    if len(set(ports)) != len(ports):
+        raise Exception("It is not allowed to have the same port configured "
+                        "on more than one bridge")
+
+    return _mappings
+
+
+def parse_vlan_range_mappings(mappings):
+    """Parse vlan range mappings.
+
+    Mappings must be a space-delimited list of provider:start:end mappings.
+
+    The start:end range is optional and may be omitted.
+
+    Returns dict of the form {provider: (start, end)}.
+    """
+    _mappings = parse_mappings(mappings)
+    if not _mappings:
+        return {}
+
+    mappings = {}
+    for p, r in six.iteritems(_mappings):
+        mappings[p] = tuple(r.split(':'))
+
+    return mappings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/policyd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/policyd.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2bb21e9db926bd2c4de8ab3e8d10d0837af563a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/policyd.py
@@ -0,0 +1,801 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import contextlib
+import os
+import six
+import shutil
+import yaml
+import zipfile
+
+import charmhelpers
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as ch_host
+
+# Features provided by this module:
+
+"""
+Policy.d helper functions
+=========================
+
+The functions in this module are designed, as a set, to provide an easy-to-use
+set of hooks for classic charms to add in /etc/<service-name>/policy.d/
+directory override YAML files.
+
+(For charms.openstack charms, a mixin class is provided for this
+functionality).
+
+In order to "hook" this functionality into a (classic) charm, two functions are
+provided:
+
+    maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=none,
+                               blacklist_keys=none,
+                               template_function=none,
+                               restart_handler=none)
+
+    maybe_do_policyd_overrides_on_config_changed(openstack_release,
+                                                 service,
+                                                 blacklist_paths=None,
+                                                 blacklist_keys=None,
+                                                 template_function=None,
+                                                 restart_handler=None
+
+(See the docstrings for details on the parameters)
+
+The functions should be called from the install and upgrade hooks in the charm.
+The `maybe_do_policyd_overrides_on_config_changed` function is designed to be
+called on the config-changed hook, in that it does an additional check to
+ensure that an already overriden policy.d in an upgrade or install hooks isn't
+repeated.
+
+In order the *enable* this functionality, the charm's install, config_changed,
+and upgrade_charm hooks need to be modified, and a new config option (see
+below) needs to be added.  The README for the charm should also be updated.
+
+Examples from the keystone charm are:
+
+@hooks.hook('install.real')
+@harden()
+def install():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+
+@hooks.hook('config-changed')
+@restart_on_change(restart_map(), restart_functions=restart_function_map())
+@harden()
+def config_changed():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides_on_config_changed(os_release('keystone'),
+                                                 'keystone')
+
+@hooks.hook('upgrade-charm')
+@restart_on_change(restart_map(), stopstart=True)
+@harden()
+def upgrade_charm():
+    ...
+    # call the policy overrides handler which will install any policy overrides
+    maybe_do_policyd_overrides(os_release('keystone'), 'keystone')
+
+Status Line
+===========
+
+The workload status code in charm-helpers has been modified to detect if
+policy.d override code has been incorporated into the charm by checking for the
+new config variable (in the config.yaml).  If it has been, then the workload
+status line will automatically show "PO:" at the beginning of the workload
+status for that unit/service if the config option is set.  If the policy
+override is broken, the "PO (broken):" will be shown.  No changes to the charm
+(apart from those already mentioned) are needed to enable this functionality.
+(charms.openstack charms also get this functionality, but please see that
+library for further details).
+"""
+
+# The config.yaml for the charm should contain the following for the config
+# option:
+
+"""
+  use-policyd-override:
+    type: boolean
+    default: False
+    description: |
+      If True then use the resource file named 'policyd-override' to install
+      override YAML files in the service's policy.d directory.  The resource
+      file should be a ZIP file containing at least one yaml file with a .yaml
+      or .yml extension.  If False then remove the overrides.
+"""
+
+# The metadata.yaml for the charm should contain the following:
+"""
+resources:
+  policyd-override:
+    type: file
+    filename: policyd-override.zip
+    description: The policy.d overrides file
+"""
+
+# The README for the charm should contain the following:
+"""
+Policy Overrides
+----------------
+
+This feature allows for policy overrides using the `policy.d` directory.  This
+is an **advanced** feature and the policies that the OpenStack service supports
+should be clearly and unambiguously understood before trying to override, or
+add to, the default policies that the service uses.  The charm also has some
+policy defaults.  They should also be understood before being overridden.
+
+> **Caution**: It is possible to break the system (for tenants and other
+  services) if policies are incorrectly applied to the service.
+
+Policy overrides are YAML files that contain rules that will add to, or
+override, existing policy rules in the service.  The `policy.d` directory is
+a place to put the YAML override files.  This charm owns the
+`/etc/keystone/policy.d` directory, and as such, any manual changes to it will
+be overwritten on charm upgrades.
+
+Overrides are provided to the charm using a Juju resource called
+`policyd-override`.  The resource is a ZIP file.  This file, say
+`overrides.zip`, is attached to the charm by:
+
+
+    juju attach-resource <charm-name> policyd-override=overrides.zip
+
+The policy override is enabled in the charm using:
+
+    juju config <charm-name> use-policyd-override=true
+
+When `use-policyd-override` is `True` the status line of the charm will be
+prefixed with `PO:` indicating that policies have been overridden.  If the
+installation of the policy override YAML files failed for any reason then the
+status line will be prefixed with `PO (broken):`.  The log file for the charm
+will indicate the reason.  No policy override files are installed if the `PO
+(broken):` is shown.  The status line indicates that the overrides are broken,
+not that the policy for the service has failed. The policy will be the defaults
+for the charm and service.
+
+Policy overrides on one service may affect the functionality of another
+service. Therefore, it may be necessary to provide policy overrides for
+multiple service charms to achieve a consistent set of policies across the
+OpenStack system.  The charms for the other services that may need overrides
+should be checked to ensure that they support overrides before proceeding.
+"""
+
+POLICYD_VALID_EXTS = ['.yaml', '.yml', '.j2', '.tmpl', '.tpl']
+POLICYD_TEMPLATE_EXTS = ['.j2', '.tmpl', '.tpl']
+POLICYD_RESOURCE_NAME = "policyd-override"
+POLICYD_CONFIG_NAME = "use-policyd-override"
+POLICYD_SUCCESS_FILENAME = "policyd-override-success"
+POLICYD_LOG_LEVEL_DEFAULT = hookenv.INFO
+POLICYD_ALWAYS_BLACKLISTED_KEYS = ("admin_required", "cloud_admin")
+
+
+class BadPolicyZipFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+class BadPolicyYamlFile(Exception):
+
+    def __init__(self, log_message):
+        self.log_message = log_message
+
+    def __str__(self):
+        return self.log_message
+
+
+if six.PY2:
+    BadZipFile = zipfile.BadZipfile
+else:
+    BadZipFile = zipfile.BadZipFile
+
+
+def is_policyd_override_valid_on_this_release(openstack_release):
+    """Check that the charm is running on at least Ubuntu Xenial, and at
+    least the queens release.
+
+    :param openstack_release: the release codename that is installed.
+    :type openstack_release: str
+    :returns: True if okay
+    :rtype: bool
+    """
+    # NOTE(ajkavanagh) circular import!  This is because the status message
+    # generation code in utils has to call into this module, but this function
+    # needs the CompareOpenStackReleases() function.  The only way to solve
+    # this is either to put ALL of this module into utils, or refactor one or
+    # other of the CompareOpenStackReleases or status message generation code
+    # into a 3rd module.
+    import charmhelpers.contrib.openstack.utils as ch_utils
+    return ch_utils.CompareOpenStackReleases(openstack_release) >= 'queens'
+
+
+def maybe_do_policyd_overrides(openstack_release,
+                               service,
+                               blacklist_paths=None,
+                               blacklist_keys=None,
+                               template_function=None,
+                               restart_handler=None,
+                               user=None,
+                               group=None,
+                               config_changed=False):
+    """If the config option is set, get the resource file and process it to
+    enable the policy.d overrides for the service passed.
+
+    The param `openstack_release` is required as the policyd overrides feature
+    is only supported on openstack_release "queens" or later, and on ubuntu
+    "xenial" or later.  Prior to these versions, this feature is a NOP.
+
+    The optional template_function is a function that accepts a string and has
+    an opportunity to modify the loaded file prior to it being read by
+    yaml.safe_load().  This allows the charm to perform "templating" using
+    charm derived data.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The param restart_handler is an optional Callable that is called to perform
+    the service restart if the policy.d file is changed.  This should normally
+    be None as oslo.policy automatically picks up changes in the policy.d
+    directory.  However, for any services where this is buggy then a
+    restart_handler can be used to force the policy.d files to be read.
+
+    If the config_changed param is True, then the handling is slightly
+    different: It will only perform the policyd overrides if the config is True
+    and the success file doesn't exist.  Otherwise, it does nothing as the
+    resource file has already been processed.
+
+    :param openstack_release: The openstack release that is installed.
+    :type openstack_release: str
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the string
+                              prior to being processed as a Yaml document.
+    :type template_function: Union[None, Callable[[str], str]]
+    :param restart_handler: The function to call if the service should be
+                            restarted.
+    :type restart_handler: Union[None, Callable[]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :param config_changed: Set to True for config_changed hook.
+    :type config_changed: bool
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    if not is_policyd_override_valid_on_this_release(openstack_release):
+        return
+    hookenv.log("Running maybe_do_policyd_overrides",
+                level=POLICYD_LOG_LEVEL_DEFAULT)
+    config = hookenv.config()
+    try:
+        if not config.get(POLICYD_CONFIG_NAME, False):
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            if (os.path.isfile(_policy_success_file()) and
+                    restart_handler is not None and
+                    callable(restart_handler)):
+                restart_handler()
+            remove_policy_success_file()
+            return
+    except Exception as e:
+        hookenv.log("... ERROR: Exception is: {}".format(str(e)),
+                    level=POLICYD_CONFIG_NAME)
+        import traceback
+        hookenv.log(traceback.format_exc(), level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # if the policyd overrides have been performed when doing config_changed
+    # just return
+    if config_changed and is_policy_success_file_set():
+        hookenv.log("... already setup, so skipping.",
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        return
+    # from now on it should succeed; if it doesn't then status line will show
+    # broken.
+    resource_filename = get_policy_resource_filename()
+    restart = process_policy_resource_file(
+        resource_filename, service, blacklist_paths, blacklist_keys,
+        template_function)
+    if restart and restart_handler is not None and callable(restart_handler):
+        restart_handler()
+
+
+@charmhelpers.deprecate("Use maybe_do_poliyd_overrrides instead")
+def maybe_do_policyd_overrides_on_config_changed(*args, **kwargs):
+    """This function is designed to be called from the config changed hook.
+
+    DEPRECATED: please use maybe_do_policyd_overrides() with the param
+    `config_changed` as `True`.
+
+    See maybe_do_policyd_overrides() for more details on the params.
+    """
+    if 'config_changed' not in kwargs.keys():
+        kwargs['config_changed'] = True
+    return maybe_do_policyd_overrides(*args, **kwargs)
+
+
+def get_policy_resource_filename():
+    """Function to extract the policy resource filename
+
+    :returns: The filename of the resource, if set, otherwise, if an error
+               occurs, then None is returned.
+    :rtype: Union[str, None]
+    """
+    try:
+        return hookenv.resource_get(POLICYD_RESOURCE_NAME)
+    except Exception:
+        return None
+
+
+@contextlib.contextmanager
+def open_and_filter_yaml_files(filepath, has_subdirs=False):
+    """Validate that the filepath provided is a zip file and contains at least
+    one (.yaml|.yml) file, and that the files are not duplicated when the zip
+    file is flattened.  Note that the yaml files are not checked.  This is the
+    first stage in validating the policy zipfile; individual yaml files are not
+    checked for validity or black listed keys.
+
+    If the has_subdirs param is True, then the files are flattened to the first
+    directory, and the files in the root are ignored.
+
+    An example of use is:
+
+        with open_and_filter_yaml_files(some_path) as zfp, g:
+            for zipinfo in g:
+                # do something with zipinfo ...
+
+    :param filepath: a filepath object that can be opened by zipfile
+    :type filepath: Union[AnyStr, os.PathLike[AntStr]]
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: (zfp handle,
+               a generator of the (name, filename, ZipInfo object) tuples) as a
+               tuple.
+    :rtype: ContextManager[(zipfile.ZipFile,
+                            Generator[(name, str, str, zipfile.ZipInfo)])]
+    :raises: zipfile.BadZipFile
+    :raises: BadPolicyZipFile if duplicated yaml or missing
+    :raises: IOError if the filepath is not found
+    """
+    with zipfile.ZipFile(filepath, 'r') as zfp:
+        # first pass through; check for duplicates and at least one yaml file.
+        names = collections.defaultdict(int)
+        yamlfiles = _yamlfiles(zfp, has_subdirs)
+        for name, _, _, _ in yamlfiles:
+            names[name] += 1
+        # There must be at least 1 yaml file.
+        if len(names.keys()) == 0:
+            raise BadPolicyZipFile("contains no yaml files with {} extensions."
+                                   .format(", ".join(POLICYD_VALID_EXTS)))
+        # There must be no duplicates
+        duplicates = [n for n, c in names.items() if c > 1]
+        if duplicates:
+            raise BadPolicyZipFile("{} have duplicates in the zip file."
+                                   .format(", ".join(duplicates)))
+        # Finally, let's yield the generator
+        yield (zfp, yamlfiles)
+
+
+def _yamlfiles(zipfile, has_subdirs=False):
+    """Helper to get a yaml file (according to POLICYD_VALID_EXTS extensions)
+    and the infolist item from a zipfile.
+
+    If the `has_subdirs` param is True, the the only yaml files that have a
+    directory component are read, and then first part of the directory
+    component is kept, along with the filename in the name.  e.g. an entry with
+    a filename of:
+
+        compute/someotherdir/override.yaml
+
+    is returned as:
+
+        compute/override, yaml, override.yaml, <ZipInfo object>
+
+    This is to help with the special, additional, processing that the dashboard
+    charm requires.
+
+    :param zipfile: the zipfile to read zipinfo items from
+    :type zipfile: zipfile.ZipFile
+    :param has_subdirs: Keep first level of subdirectories in yaml file.
+    :type has_subdirs: bool
+    :returns: generator of (name, ext, filename, info item) for each
+              self-identified yaml file.
+    :rtype: List[(str, str, str, zipfile.ZipInfo)]
+    """
+    files = []
+    for infolist_item in zipfile.infolist():
+        try:
+            if infolist_item.is_dir():
+                continue
+        except AttributeError:
+            # fallback to "old" way to determine dir entry for pre-py36
+            if infolist_item.filename.endswith('/'):
+                continue
+        _dir, name_ext = os.path.split(infolist_item.filename)
+        name, ext = os.path.splitext(name_ext)
+        if has_subdirs and _dir != "":
+            name = os.path.join(_dir.split(os.path.sep)[0], name)
+        ext = ext.lower()
+        if ext and ext in POLICYD_VALID_EXTS:
+            files.append((name, ext, name_ext, infolist_item))
+    return files
+
+
+def read_and_validate_yaml(stream_or_doc, blacklist_keys=None):
+    """Read, validate and return the (first) yaml document from the stream.
+
+    The doc is read, and checked for a yaml file.  The the top-level keys are
+    checked against the blacklist_keys provided.  If there are problems then an
+    Exception is raised.  Otherwise the yaml document is returned as a Python
+    object that can be dumped back as a yaml file on the system.
+
+    The yaml file must only consist of a str:str mapping, and if not then the
+    yaml file is rejected.
+
+    :param stream_or_doc: the file object to read the yaml from
+    :type stream_or_doc: Union[AnyStr, IO[AnyStr]]
+    :param blacklist_keys: Any keys, which if in the yaml file, should cause
+        and error.
+    :type blacklisted_keys: Union[None, List[str]]
+    :returns: the yaml file as a python document
+    :rtype: Dict[str, str]
+    :raises: yaml.YAMLError if there is a problem with the document
+    :raises: BadPolicyYamlFile if file doesn't look right or there are
+             blacklisted keys in the file.
+    """
+    blacklist_keys = blacklist_keys or []
+    blacklist_keys.append(POLICYD_ALWAYS_BLACKLISTED_KEYS)
+    doc = yaml.safe_load(stream_or_doc)
+    if not isinstance(doc, dict):
+        raise BadPolicyYamlFile("doesn't look like a policy file?")
+    keys = set(doc.keys())
+    blacklisted_keys_present = keys.intersection(blacklist_keys)
+    if blacklisted_keys_present:
+        raise BadPolicyYamlFile("blacklisted keys {} present."
+                                .format(", ".join(blacklisted_keys_present)))
+    if not all(isinstance(k, six.string_types) for k in keys):
+        raise BadPolicyYamlFile("keys in yaml aren't all strings?")
+    # check that the dictionary looks like a mapping of str to str
+    if not all(isinstance(v, six.string_types) for v in doc.values()):
+        raise BadPolicyYamlFile("values in yaml aren't all strings?")
+    return doc
+
+
+def policyd_dir_for(service):
+    """Return the policy directory for the named service.
+
+    :param service: str
+    :returns: the policy.d override directory.
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join("/", "etc", service, "policy.d")
+
+
+def clean_policyd_dir_for(service, keep_paths=None, user=None, group=None):
+    """Clean out the policyd directory except for items that should be kept.
+
+    The keep_paths, if used, should be set to the full path of the files that
+    should be kept in the policyd directory for the service.  Note that the
+    service name is passed in, and then the policyd_dir_for() function is used.
+    This is so that a coding error doesn't result in a sudden deletion of the
+    charm (say).
+
+    :param service: the service name to use to construct the policy.d dir.
+    :type service: str
+    :param keep_paths: optional list of paths to not delete.
+    :type keep_paths: Union[None, List[str]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    """
+    _user = service if user is None else user
+    _group = service if group is None else group
+    keep_paths = keep_paths or []
+    path = policyd_dir_for(service)
+    hookenv.log("Cleaning path: {}".format(path), level=hookenv.DEBUG)
+    if not os.path.exists(path):
+        ch_host.mkdir(path, owner=_user, group=_group, perms=0o775)
+    _scanner = os.scandir if hasattr(os, 'scandir') else _fallback_scandir
+    for direntry in _scanner(path):
+        # see if the path should be kept.
+        if direntry.path in keep_paths:
+            continue
+        # we remove any directories; it's ours and there shouldn't be any
+        if direntry.is_dir():
+            shutil.rmtree(direntry.path)
+        else:
+            os.remove(direntry.path)
+
+
+def maybe_create_directory_for(path, user, group):
+    """For the filename 'path', ensure that the directory for that path exists.
+
+    Note that if the directory already exists then the permissions are NOT
+    changed.
+
+    :param path: the filename including the path to it.
+    :type path: str
+    :param user: the user to create the directory as
+    :param group: the group to create the directory as
+    """
+    _dir, _ = os.path.split(path)
+    if not os.path.exists(_dir):
+        ch_host.mkdir(_dir, owner=user, group=group, perms=0o775)
+
+
+@contextlib.contextmanager
+def _fallback_scandir(path):
+    """Fallback os.scandir implementation.
+
+    provide a fallback implementation of os.scandir if this module ever gets
+    used in a py2 or py34 charm. Uses os.listdir() to get the names in the path,
+    and then mocks the is_dir() function using os.path.isdir() to check for
+    directory.
+
+    :param path: the path to list the directories for
+    :type path: str
+    :returns: Generator that provides _FBDirectory objects
+    :rtype: ContextManager[_FBDirectory]
+    """
+    for f in os.listdir(path):
+        yield _FBDirectory(f)
+
+
+class _FBDirectory(object):
+    """Mock a scandir Directory object with enough to use in
+    clean_policyd_dir_for
+    """
+
+    def __init__(self, path):
+        self.path = path
+
+    def is_dir(self):
+        return os.path.isdir(self.path)
+
+
+def path_for_policy_file(service, name):
+    """Return the full path for a policy.d file that will be written to the
+    service's policy.d directory.
+
+    It is constructed using policyd_dir_for(), the name and the ".yaml"
+    extension.
+
+    For horizon, for example, it's a bit more complicated.  The name param is
+    actually "override_service_dir/a_name", where target_service needs to be
+    one the allowed horizon override services.  This translation and check is
+    done in the _yamlfiles() function.
+
+    :param service: the service name
+    :type service: str
+    :param name: the name for the policy override
+    :type name: str
+    :returns: the full path name for the file
+    :rtype: os.PathLike[str]
+    """
+    return os.path.join(policyd_dir_for(service), name + ".yaml")
+
+
+def _policy_success_file():
+    """Return the file name for a successful drop of policy.d overrides
+
+    :returns: the path name for the file.
+    :rtype: str
+    """
+    return os.path.join(hookenv.charm_dir(), POLICYD_SUCCESS_FILENAME)
+
+
+def remove_policy_success_file():
+    """Remove the file that indicates successful policyd override."""
+    try:
+        os.remove(_policy_success_file())
+    except Exception:
+        pass
+
+
+def set_policy_success_file():
+    """Set the file that indicates successful policyd override."""
+    open(_policy_success_file(), "w").close()
+
+
+def is_policy_success_file_set():
+    """Returns True if the policy success file has been set.
+
+    This indicates that policies are overridden and working properly.
+
+    :returns: True if the policy file is set
+    :rtype: bool
+    """
+    return os.path.isfile(_policy_success_file())
+
+
+def policyd_status_message_prefix():
+    """Return the prefix str for the status line.
+
+    "PO:" indicating that the policy overrides are in place, or "PO (broken):"
+    if the policy is supposed to be working but there is no success file.
+
+    :returns: the prefix
+    :rtype: str
+    """
+    if is_policy_success_file_set():
+        return "PO:"
+    return "PO (broken):"
+
+
+def process_policy_resource_file(resource_file,
+                                 service,
+                                 blacklist_paths=None,
+                                 blacklist_keys=None,
+                                 template_function=None,
+                                 preserve_topdir=False,
+                                 preprocess_filename=None,
+                                 user=None,
+                                 group=None):
+    """Process the resource file (which should contain at least one yaml file)
+    and write those files to the service's policy.d directory.
+
+    The optional template_function is a function that accepts a python
+    string and has an opportunity to modify the document
+    prior to it being read by the yaml.safe_load() function and written to
+    disk. Note that this function does *not* say how the templating is done -
+    this is up to the charm to implement its chosen method.
+
+    The param blacklist_paths are paths (that are in the service's policy.d
+    directory that should not be touched).
+
+    The param blacklist_keys are keys that must not appear in the yaml file.
+    If they do, then the whole policy.d file fails.
+
+    The yaml file extracted from the resource_file (which is a zipped file) has
+    its file path reconstructed.  This, also, must not match any path in the
+    black list.
+
+    The yaml filename can be modified in two ways.  If the `preserve_topdir`
+    param is True, then files will be flattened to the top dir.  This allows
+    for creating sets of files that can be grouped into a single level tree
+    structure.
+
+    Secondly, if the `preprocess_filename` param is not None and callable()
+    then the name is passed to that function for preprocessing before being
+    converted to the end location.  This is to allow munging of the filename
+    prior to being tested for a blacklist path.
+
+    If any error occurs, then the policy.d directory is cleared, the error is
+    written to the log, and the status line will eventually show as failed.
+
+    :param resource_file: The zipped file to open and extract yaml files form.
+    :type resource_file: Union[AnyStr, os.PathLike[AnyStr]]
+    :param service: the service name to construct the policy.d directory for.
+    :type service: str
+    :param blacklist_paths: optional list of paths to leave alone
+    :type blacklist_paths: Union[None, List[str]]
+    :param blacklist_keys: optional list of keys that mustn't appear in the
+                           yaml file's
+    :type blacklist_keys: Union[None, List[str]]
+    :param template_function: Optional function that can modify the yaml
+                              document.
+    :type template_function: Union[None, Callable[[AnyStr], AnyStr]]
+    :param preserve_topdir: Keep the toplevel subdir
+    :type preserve_topdir: bool
+    :param preprocess_filename: Optional function to use to process filenames
+                                extracted from the resource file.
+    :type preprocess_filename: Union[None, Callable[[AnyStr]. AnyStr]]
+    :param user: The user to create/write files/directories as
+    :type user: Union[None, str]
+    :param group: the group to create/write files/directories as
+    :type group: Union[None, str]
+    :returns: True if the processing was successful, False if not.
+    :rtype: boolean
+    """
+    hookenv.log("Running process_policy_resource_file", level=hookenv.DEBUG)
+    blacklist_paths = blacklist_paths or []
+    completed = False
+    _preprocess = None
+    if preprocess_filename is not None and callable(preprocess_filename):
+        _preprocess = preprocess_filename
+    _user = service if user is None else user
+    _group = service if group is None else group
+    try:
+        with open_and_filter_yaml_files(
+                resource_file, preserve_topdir) as (zfp, gen):
+            # first clear out the policy.d directory and clear success
+            remove_policy_success_file()
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+            for name, ext, filename, zipinfo in gen:
+                # See if the name should be preprocessed.
+                if _preprocess is not None:
+                    name = _preprocess(name)
+                # construct a name for the output file.
+                yaml_filename = path_for_policy_file(service, name)
+                if yaml_filename in blacklist_paths:
+                    raise BadPolicyZipFile("policy.d name {} is blacklisted"
+                                           .format(yaml_filename))
+                with zfp.open(zipinfo) as fp:
+                    doc = fp.read()
+                    # if template_function is not None, then offer the document
+                    # to the template function
+                    if ext in POLICYD_TEMPLATE_EXTS:
+                        if (template_function is None or not
+                                callable(template_function)):
+                            raise BadPolicyZipFile(
+                                "Template {} but no template_function is "
+                                "available".format(filename))
+                        doc = template_function(doc)
+                    yaml_doc = read_and_validate_yaml(doc, blacklist_keys)
+                # we may have to create the directory
+                maybe_create_directory_for(yaml_filename, _user, _group)
+                ch_host.write_file(yaml_filename,
+                                   yaml.dump(yaml_doc).encode('utf-8'),
+                                   _user,
+                                   _group)
+        # Every thing worked, so we mark up a success.
+        completed = True
+    except (BadZipFile, BadPolicyZipFile, BadPolicyYamlFile) as e:
+        hookenv.log("Processing {} failed: {}".format(resource_file, str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+    except IOError as e:
+        # technically this shouldn't happen; it would be a programming error as
+        # the filename comes from Juju and thus, should exist.
+        hookenv.log(
+            "File {} failed with IOError.  This really shouldn't happen"
+            " -- error: {}".format(resource_file, str(e)),
+            level=POLICYD_LOG_LEVEL_DEFAULT)
+    except Exception as e:
+        import traceback
+        hookenv.log("General Exception({}) during policyd processing"
+                    .format(str(e)),
+                    level=POLICYD_LOG_LEVEL_DEFAULT)
+        hookenv.log(traceback.format_exc())
+    finally:
+        if not completed:
+            hookenv.log("Processing {} failed: cleaning policy.d directory"
+                        .format(resource_file),
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            clean_policyd_dir_for(service,
+                                  blacklist_paths,
+                                  user=_user,
+                                  group=_group)
+        else:
+            # touch the success filename
+            hookenv.log("policy.d overrides installed.",
+                        level=POLICYD_LOG_LEVEL_DEFAULT)
+            set_policy_success_file()
+        return completed
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ssh_migrations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ssh_migrations.py
new file mode 100644
index 0000000000000000000000000000000000000000..96b9f71d42d1c81539f78b8e1c4761f81d84c304
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/ssh_migrations.py
@@ -0,0 +1,412 @@
+# Copyright 2018 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import subprocess
+
+from charmhelpers.core.hookenv import (
+    ERROR,
+    log,
+    relation_get,
+)
+from charmhelpers.contrib.network.ip import (
+    is_ipv6,
+    ns_query,
+)
+from charmhelpers.contrib.openstack.utils import (
+    get_hostname,
+    get_host_ip,
+    is_ip,
+)
+
+NOVA_SSH_DIR = '/etc/nova/compute_ssh/'
+
+
+def ssh_directory_for_unit(application_name, user=None):
+    """Return the directory used to store ssh assets for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified directory path.
+    :rtype: str
+    """
+    if user:
+        application_name = "{}_{}".format(application_name, user)
+    _dir = os.path.join(NOVA_SSH_DIR, application_name)
+    for d in [NOVA_SSH_DIR, _dir]:
+        if not os.path.isdir(d):
+            os.mkdir(d)
+    for f in ['authorized_keys', 'known_hosts']:
+        f = os.path.join(_dir, f)
+        if not os.path.isfile(f):
+            open(f, 'w').close()
+    return _dir
+
+
+def known_hosts(application_name, user=None):
+    """Return the known hosts file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'known_hosts')
+
+
+def authorized_keys(application_name, user=None):
+    """Return the authorized keys file for the application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Fully qualified path to file.
+    :rtype: str
+    """
+    return os.path.join(
+        ssh_directory_for_unit(application_name, user),
+        'authorized_keys')
+
+
+def ssh_known_host_key(host, application_name, user=None):
+    """Return the first entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Host key
+    :rtype: str or None
+    """
+    cmd = [
+        'ssh-keygen',
+        '-f', known_hosts(application_name, user),
+        '-H',
+        '-F',
+        host]
+    try:
+        # The first line of output is like '# Host xx found: line 1 type RSA',
+        # which should be excluded.
+        output = subprocess.check_output(cmd)
+    except subprocess.CalledProcessError as e:
+        # RC of 1 seems to be legitimate for most ssh-keygen -F calls.
+        if e.returncode == 1:
+            output = e.output
+        else:
+            raise
+    output = output.strip()
+
+    if output:
+        # Bug #1500589 cmd has 0 rc on precise if entry not present
+        lines = output.split('\n')
+        if len(lines) >= 1:
+            return lines[0]
+
+    return None
+
+
+def remove_known_host(host, application_name, user=None):
+    """Remove the entry in known_hosts for host.
+
+    :param host: hostname to lookup in file.
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    log('Removing SSH known host entry for compute host at %s' % host)
+    cmd = ['ssh-keygen', '-f', known_hosts(application_name, user), '-R', host]
+    subprocess.check_call(cmd)
+
+
+def is_same_key(key_1, key_2):
+    """Extract the key from two host entries and compare them.
+
+    :param key_1: Host key
+    :type key_1: str
+    :param key_2: Host key
+    :type key_2: str
+    """
+    # The key format get will be like '|1|2rUumCavEXWVaVyB5uMl6m85pZo=|Cp'
+    # 'EL6l7VTY37T/fg/ihhNb/GPgs= ssh-rsa AAAAB', we only need to compare
+    # the part start with 'ssh-rsa' followed with '= ', because the hash
+    # value in the beginning will change each time.
+    k_1 = key_1.split('= ')[1]
+    k_2 = key_2.split('= ')[1]
+    return k_1 == k_2
+
+
+def add_known_host(host, application_name, user=None):
+    """Add the given host key to the known hosts file.
+
+    :param host: host name
+    :type host: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    cmd = ['ssh-keyscan', '-H', '-t', 'rsa', host]
+    try:
+        remote_key = subprocess.check_output(cmd).strip()
+    except Exception as e:
+        log('Could not obtain SSH host key from %s' % host, level=ERROR)
+        raise e
+
+    current_key = ssh_known_host_key(host, application_name, user)
+    if current_key and remote_key:
+        if is_same_key(remote_key, current_key):
+            log('Known host key for compute host %s up to date.' % host)
+            return
+        else:
+            remove_known_host(host, application_name, user)
+
+    log('Adding SSH host key to known hosts for compute node at %s.' % host)
+    with open(known_hosts(application_name, user), 'a') as out:
+        out.write("{}\n".format(remote_key))
+
+
+def ssh_authorized_key_exists(public_key, application_name, user=None):
+    """Check if given key is in the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Whether given key is in the authorized_key file.
+    :rtype: boolean
+    """
+    with open(authorized_keys(application_name, user)) as keys:
+        return ('%s' % public_key) in keys.read()
+
+
+def add_authorized_key(public_key, application_name, user=None):
+    """Add given key to the authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    with open(authorized_keys(application_name, user), 'a') as keys:
+        keys.write("{}\n".format(public_key))
+
+
+def ssh_compute_add_host_and_key(public_key, hostname, private_address,
+                                 application_name, user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param hostname: Hostname to collect host keys from.
+    :type hostname: str
+    :param private_address:aCorresponding private address for hostname
+    :type private_address: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    # If remote compute node hands us a hostname, ensure we have a
+    # known hosts entry for its IP, hostname and FQDN.
+    hosts = [private_address]
+
+    if not is_ipv6(private_address):
+        if hostname:
+            hosts.append(hostname)
+
+        if is_ip(private_address):
+            hn = get_hostname(private_address)
+            if hn:
+                hosts.append(hn)
+                short = hn.split('.')[0]
+                if ns_query(short):
+                    hosts.append(short)
+        else:
+            hosts.append(get_host_ip(private_address))
+            short = private_address.split('.')[0]
+            if ns_query(short):
+                hosts.append(short)
+
+    for host in list(set(hosts)):
+        add_known_host(host, application_name, user)
+
+    if not ssh_authorized_key_exists(public_key, application_name, user):
+        log('Saving SSH authorized key for compute host at %s.' %
+            private_address)
+        add_authorized_key(public_key, application_name, user)
+
+
+def ssh_compute_add(public_key, application_name, rid=None, unit=None,
+                    user=None):
+    """Add a compute nodes ssh details to local cache.
+
+    Collect various hostname variations and add the corresponding host keys to
+    the local known hosts file. Finally, add the supplied public key to the
+    authorized_key file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param rid: Relation id of the relation between this charm and the app. If
+                none is supplied it is assumed its the relation relating to
+                the current hook context.
+    :type rid: str
+    :param unit: Unit to add ssh asserts for if none is supplied it is assumed
+                 its the unit relating to the current hook context.
+    :type unit: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    relation_data = relation_get(rid=rid, unit=unit)
+    ssh_compute_add_host_and_key(
+        public_key,
+        relation_data.get('hostname'),
+        relation_data.get('private-address'),
+        application_name,
+        user=user)
+
+
+def ssh_known_hosts_lines(application_name, user=None):
+    """Return contents of known_hosts file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    known_hosts_list = []
+    with open(known_hosts(application_name, user)) as hosts:
+        for hosts_line in hosts:
+            if hosts_line.rstrip():
+                known_hosts_list.append(hosts_line.rstrip())
+    return(known_hosts_list)
+
+
+def ssh_authorized_keys_lines(application_name, user=None):
+    """Return contents of authorized_keys file for given application.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    authorized_keys_list = []
+
+    with open(authorized_keys(application_name, user)) as keys:
+        for authkey_line in keys:
+            if authkey_line.rstrip():
+                authorized_keys_list.append(authkey_line.rstrip())
+    return(authorized_keys_list)
+
+
+def ssh_compute_remove(public_key, application_name, user=None):
+    """Remove given public key from authorized_keys file.
+
+    :param public_key: Public key.
+    :type public_key: str
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    """
+    if not (os.path.isfile(authorized_keys(application_name, user)) or
+            os.path.isfile(known_hosts(application_name, user))):
+        return
+
+    keys = ssh_authorized_keys_lines(application_name, user=None)
+    keys = [k.strip() for k in keys]
+
+    if public_key not in keys:
+        return
+
+    [keys.remove(key) for key in keys if key == public_key]
+
+    with open(authorized_keys(application_name, user), 'w') as _keys:
+        keys = '\n'.join(keys)
+        if not keys.endswith('\n'):
+            keys += '\n'
+        _keys.write(keys)
+
+
+def get_ssh_settings(application_name, user=None):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for the
+    app + user combination.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :param user: The user that the ssh asserts are for.
+    :type user: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = {}
+    keys = {}
+    prefix = ''
+    if user:
+        prefix = '{}_'.format(user)
+
+    for i, line in enumerate(ssh_known_hosts_lines(
+            application_name=application_name, user=user)):
+        settings['{}known_hosts_{}'.format(prefix, i)] = line
+    if settings:
+        settings['{}known_hosts_max_index'.format(prefix)] = len(
+            settings.keys())
+
+    for i, line in enumerate(ssh_authorized_keys_lines(
+            application_name=application_name, user=user)):
+        keys['{}authorized_keys_{}'.format(prefix, i)] = line
+    if keys:
+        keys['{}authorized_keys_max_index'.format(prefix)] = len(keys.keys())
+    settings.update(keys)
+    return settings
+
+
+def get_all_user_ssh_settings(application_name):
+    """Retrieve the known host entries and public keys for application
+
+    Retrieve the known host entries and public keys for application for all
+    units of the given application related to this application for root user
+    and nova user.
+
+    :param application_name: Name of application eg nova-compute-something
+    :type application_name: str
+    :returns: Public keys + host keys for all units for app + user combination.
+    :rtype: dict
+    """
+    settings = get_ssh_settings(application_name)
+    settings.update(get_ssh_settings(application_name, user='nova'))
+    return settings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9df5f746fbdf5491c640a77df907b71817cbc5af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# dummy __init__.py to fool syncer into thinking this is a syncable python
+# module
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/ceph.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/ceph.conf
new file mode 100644
index 0000000000000000000000000000000000000000..a11ce8ab85654a4d838e448f36fe3698b59f9531
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/ceph.conf
@@ -0,0 +1,24 @@
+###############################################################################
+# [ WARNING ]
+# ceph configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+[global]
+{% if auth -%}
+auth_supported = {{ auth }}
+keyring = /etc/ceph/$cluster.$name.keyring
+mon host = {{ mon_hosts }}
+{% endif -%}
+log to syslog = {{ use_syslog }}
+err to syslog = {{ use_syslog }}
+clog to syslog = {{ use_syslog }}
+{% if rbd_features %}
+rbd default features = {{ rbd_features }}
+{% endif %}
+
+[client]
+{% if rbd_client_cache_settings -%}
+{% for key, value in rbd_client_cache_settings.items() -%}
+{{ key }} = {{ value }}
+{% endfor -%}
+{%- endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/git.upstart b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/git.upstart
new file mode 100644
index 0000000000000000000000000000000000000000..4bed404bc01087c4dec6a44a56d17ed122e1d1e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/git.upstart
@@ -0,0 +1,17 @@
+description "{{ service_description }}"
+author "Juju {{ service_name }} Charm <juju@localhost>"
+
+start on runlevel [2345]
+stop on runlevel [!2345]
+
+respawn
+
+exec start-stop-daemon --start --chuid {{ user_name }} \
+            --chdir {{ start_dir }} --name {{ process_name }} \
+            --exec {{ executable_name }} -- \
+            {% for config_file in config_files -%}
+            --config-file={{ config_file }} \
+            {% endfor -%}
+            {% if log_file -%}
+            --log-file={{ log_file }}
+            {% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/haproxy.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/haproxy.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..d36af2aa86f91b2ee1249594fffd106843dd0676
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/haproxy.cfg
@@ -0,0 +1,77 @@
+global
+    log /var/lib/haproxy/dev/log local0
+    log /var/lib/haproxy/dev/log local1 notice
+    maxconn 20000
+    user haproxy
+    group haproxy
+    spread-checks 0
+    stats socket /var/run/haproxy/admin.sock mode 600 level admin
+    stats timeout 2m
+
+defaults
+    log global
+    mode tcp
+    option tcplog
+    option dontlognull
+    retries 3
+{%- if haproxy_queue_timeout %}
+    timeout queue {{ haproxy_queue_timeout }}
+{%- else %}
+    timeout queue 9000
+{%- endif %}
+{%- if haproxy_connect_timeout %}
+    timeout connect {{ haproxy_connect_timeout }}
+{%- else %}
+    timeout connect 9000
+{%- endif %}
+{%- if haproxy_client_timeout %}
+    timeout client {{ haproxy_client_timeout }}
+{%- else %}
+    timeout client 90000
+{%- endif %}
+{%- if haproxy_server_timeout %}
+    timeout server {{ haproxy_server_timeout }}
+{%- else %}
+    timeout server 90000
+{%- endif %}
+
+listen stats
+    bind {{ local_host }}:{{ stat_port }}
+    mode http
+    stats enable
+    stats hide-version
+    stats realm Haproxy\ Statistics
+    stats uri /
+    stats auth admin:{{ stat_password }}
+
+{% if frontends -%}
+{% for service, ports in service_ports.items() -%}
+frontend tcp-in_{{ service }}
+    bind *:{{ ports[0] }}
+    {% if ipv6_enabled -%}
+    bind :::{{ ports[0] }}
+    {% endif -%}
+    {% for frontend in frontends -%}
+    acl net_{{ frontend }} dst {{ frontends[frontend]['network'] }}
+    use_backend {{ service }}_{{ frontend }} if net_{{ frontend }}
+    {% endfor -%}
+    default_backend {{ service }}_{{ default_backend }}
+
+{% for frontend in frontends -%}
+backend {{ service }}_{{ frontend }}
+    balance leastconn
+    {% if backend_options -%}
+    {% if backend_options[service] -%}
+    {% for option in backend_options[service] -%}
+    {% for key, value in option.items() -%}
+    {{ key }} {{ value }}
+    {% endfor -%}
+    {% endfor -%}
+    {% endif -%}
+    {% endif -%}
+    {% for unit, address in frontends[frontend]['backends'].items() -%}
+    server {{ unit }} {{ address }}:{{ ports[1] }} check
+    {% endfor %}
+{% endfor -%}
+{% endfor -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/logrotate b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/logrotate
new file mode 100644
index 0000000000000000000000000000000000000000..b2900d09a4ec2d04152ed7ce25bdc7346c349675
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/logrotate
@@ -0,0 +1,9 @@
+/var/log/{{ logrotate_logs_location }}/*.log {
+    {{ logrotate_interval }}
+    {{ logrotate_count }}
+    compress
+    delaycompress
+    missingok
+    notifempty
+    copytruncate
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/memcached.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/memcached.conf
new file mode 100644
index 0000000000000000000000000000000000000000..26cb037c72beccdb1a4f9269844abdbac2406369
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/memcached.conf
@@ -0,0 +1,53 @@
+###############################################################################
+# [ WARNING ]
+# memcached configuration file maintained by Juju
+# local changes may be overwritten.
+###############################################################################
+
+# memcached default config file
+# 2003 - Jay Bonci <jaybonci@debian.org>
+# This configuration file is read by the start-memcached script provided as
+# part of the Debian GNU/Linux distribution.
+
+# Run memcached as a daemon. This command is implied, and is not needed for the
+# daemon to run. See the README.Debian that comes with this package for more
+# information.
+-d
+
+# Log memcached's output to /var/log/memcached
+logfile /var/log/memcached.log
+
+# Be verbose
+# -v
+
+# Be even more verbose (print client commands as well)
+# -vv
+
+# Start with a cap of 64 megs of memory. It's reasonable, and the daemon default
+# Note that the daemon will grow to this size, but does not start out holding this much
+# memory
+-m 64
+
+# Default connection port is 11211
+-p {{ memcache_port }}
+
+# Run the daemon as root. The start-memcached will default to running as root if no
+# -u command is present in this config file
+-u memcache
+
+# Specify which IP address to listen on. The default is to listen on all IP addresses
+# This parameter is one of the only security measures that memcached has, so make sure
+# it's listening on a firewalled interface.
+-l {{ memcache_server }}
+
+# Limit the number of simultaneous incoming connections. The daemon default is 1024
+# -c 1024
+
+# Lock down all paged memory. Consult with the README and homepage before you do this
+# -k
+
+# Return error when memory is exhausted (rather than removing items)
+# -M
+
+# Maximize core file limit
+# -r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
new file mode 100644
index 0000000000000000000000000000000000000000..f614b3fa71928b615a1f058c6928d3c98bed9575
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/openstack_https_frontend.conf
@@ -0,0 +1,29 @@
+{% if endpoints -%}
+{% for ext_port in ext_ports -%}
+Listen {{ ext_port }}
+{% endfor -%}
+{% for address, endpoint, ext, int in endpoints -%}
+<VirtualHost {{ address }}:{{ ext }}>
+    ServerName {{ endpoint }}
+    SSLEngine on
+    SSLProtocol +TLSv1 +TLSv1.1 +TLSv1.2
+    SSLCipherSuite HIGH:!RC4:!MD5:!aNULL:!eNULL:!EXP:!LOW:!MEDIUM
+    SSLCertificateFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    # See LP 1484489 - this is to support <= 2.4.7 and >= 2.4.8
+    SSLCertificateChainFile /etc/apache2/ssl/{{ namespace }}/cert_{{ endpoint }}
+    SSLCertificateKeyFile /etc/apache2/ssl/{{ namespace }}/key_{{ endpoint }}
+    ProxyPass / http://localhost:{{ int }}/
+    ProxyPassReverse / http://localhost:{{ int }}/
+    ProxyPreserveHost on
+    RequestHeader set X-Forwarded-Proto "https"
+</VirtualHost>
+{% endfor -%}
+<Proxy *>
+    Order deny,allow
+    Allow from all
+</Proxy>
+<Location />
+    Order allow,deny
+    Allow from all
+</Location>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
new file mode 100644
index 0000000000000000000000000000000000000000..5dcebe7c863728b040337616b492296f536b3ef3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken
@@ -0,0 +1,12 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_plugin = password
+project_domain_id = default
+user_domain_id = default
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
new file mode 100644
index 0000000000000000000000000000000000000000..9356b2be4e7dabe089b4d7d39793146bb92f3f48
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-legacy
@@ -0,0 +1,10 @@
+{% if auth_host -%}
+[keystone_authtoken]
+# Juno specific config (Bug #1557223)
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/{{ service_admin_prefix }}
+identity_uri = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+admin_tenant_name = {{ admin_tenant_name }}
+admin_user = {{ admin_user }}
+admin_password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
new file mode 100644
index 0000000000000000000000000000000000000000..c281868b16a885cd01a234984974af0349a5d242
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-mitaka
@@ -0,0 +1,22 @@
+{% if auth_host -%}
+[keystone_authtoken]
+auth_type = password
+{% if api_version == "3" -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}/v3
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}/v3
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+auth_uri = {{ service_protocol }}://{{ service_host }}:{{ service_port }}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+signing_dir = {{ signing_dir }}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
new file mode 100644
index 0000000000000000000000000000000000000000..d26a91fe1f00e2b12d094be727a53eddc87b829d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-keystone-authtoken-v3only
@@ -0,0 +1,9 @@
+{% if auth_host -%}
+[keystone_authtoken]
+{% for option_name, option_value in keystone_authtoken.items() -%}
+{{ option_name }} = {{ option_value }}
+{% endfor -%}
+{% if use_memcache == true %}
+memcached_servers = {{ memcache_url }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-cache b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-cache
new file mode 100644
index 0000000000000000000000000000000000000000..e056a32aafe32413cefb40b9414d064f2b0c8fd2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-cache
@@ -0,0 +1,6 @@
+[cache]
+{% if memcache_url %}
+enabled = true
+backend = oslo_cache.memcache_pool
+memcache_servers = {{ memcache_url }}
+{% endif %}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
new file mode 100644
index 0000000000000000000000000000000000000000..bed2216aba7217022ded17dec4cdb0871f513b40
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
new file mode 100644
index 0000000000000000000000000000000000000000..365f43757719b2de3c601ea6a9752dac8a8b3545
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-messaging-rabbit-ocata
@@ -0,0 +1,10 @@
+[oslo_messaging_rabbit]
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+{% endif -%}
+{% if rabbit_ssl_ca -%}
+ssl_ca_file = {{ rabbit_ssl_ca }}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-middleware b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-middleware
new file mode 100644
index 0000000000000000000000000000000000000000..dd73230a42aa037582989979c1bc8132d30b9b38
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-middleware
@@ -0,0 +1,5 @@
+[oslo_middleware]
+
+# Bug #1758675
+enable_proxy_headers_parsing = true
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-notifications b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-notifications
new file mode 100644
index 0000000000000000000000000000000000000000..71c7eb068eace94e8986d7a868bded236f75128c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-oslo-notifications
@@ -0,0 +1,15 @@
+{% if transport_url -%}
+[oslo_messaging_notifications]
+driver = {{ oslo_messaging_driver }}
+transport_url = {{ transport_url }}
+{% if send_notifications_to_logs %}
+driver = log
+{% endif %}
+{% if notification_topics -%}
+topics = {{ notification_topics }}
+{% endif -%}
+{% if notification_format -%}
+[notifications]
+notification_format = {{ notification_format }}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-placement b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-placement
new file mode 100644
index 0000000000000000000000000000000000000000..97724bdb5af6e0352d0b920600d7cbbc8318fa7c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-placement
@@ -0,0 +1,19 @@
+[placement]
+{% if auth_host -%}
+auth_url = {{ auth_protocol }}://{{ auth_host }}:{{ auth_port }}
+auth_type = password
+{% if api_version == "3" -%}
+project_domain_name = {{ admin_domain_name }}
+user_domain_name = {{ admin_domain_name }}
+{% else -%}
+project_domain_name = default
+user_domain_name = default
+{% endif -%}
+project_name = {{ admin_tenant_name }}
+username = {{ admin_user }}
+password = {{ admin_password }}
+{% endif -%}
+{% if region -%}
+os_region_name = {{ region }}
+{% endif -%}
+randomize_allocation_candidates = true
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
new file mode 100644
index 0000000000000000000000000000000000000000..b444c9c99bd179eaa0be31af462576e4ca9c45b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-rabbitmq-oslo
@@ -0,0 +1,22 @@
+{% if rabbitmq_host or rabbitmq_hosts -%}
+[oslo_messaging_rabbit]
+rabbit_userid = {{ rabbitmq_user }}
+rabbit_virtual_host = {{ rabbitmq_virtual_host }}
+rabbit_password = {{ rabbitmq_password }}
+{% if rabbitmq_hosts -%}
+rabbit_hosts = {{ rabbitmq_hosts }}
+{% if rabbitmq_ha_queues -%}
+rabbit_ha_queues = True
+rabbit_durable_queues = False
+{% endif -%}
+{% else -%}
+rabbit_host = {{ rabbitmq_host }}
+{% endif -%}
+{% if rabbit_ssl_port -%}
+rabbit_use_ssl = True
+rabbit_port = {{ rabbit_ssl_port }}
+{% if rabbit_ssl_ca -%}
+kombu_ssl_ca_certs = {{ rabbit_ssl_ca }}
+{% endif -%}
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-zeromq b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-zeromq
new file mode 100644
index 0000000000000000000000000000000000000000..95f1a76ce87f9babdcba58da79c68d34c2776eea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/section-zeromq
@@ -0,0 +1,14 @@
+{% if zmq_host -%}
+# ZeroMQ configuration (restart-nonce: {{ zmq_nonce }})
+rpc_backend = zmq
+rpc_zmq_host = {{ zmq_host }}
+{% if zmq_redis_address -%}
+rpc_zmq_matchmaker = redis
+matchmaker_heartbeat_freq = 15
+matchmaker_heartbeat_ttl = 30
+[matchmaker_redis]
+host = {{ zmq_redis_address }}
+{% else -%}
+rpc_zmq_matchmaker = ring
+{% endif -%}
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/vendor_data.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/vendor_data.json
new file mode 100644
index 0000000000000000000000000000000000000000..904f612a7f74490d4508920400d18d493d056477
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/vendor_data.json
@@ -0,0 +1 @@
+{{ vendor_data_json }}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-api.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
new file mode 100644
index 0000000000000000000000000000000000000000..23b62a385283e6b8f1a6af0fcebccac747031b26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templates/wsgi-openstack-metadata.conf
@@ -0,0 +1,91 @@
+# Configuration file maintained by Juju. Local changes may be overwritten.
+
+{% if port -%}
+Listen {{ port }}
+{% endif -%}
+
+{% if admin_port -%}
+Listen {{ admin_port }}
+{% endif -%}
+
+{% if public_port -%}
+Listen {{ public_port }}
+{% endif -%}
+
+{% if port -%}
+<VirtualHost *:{{ port }}>
+    WSGIDaemonProcess {{ service_name }} processes={{ processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}
+    WSGIScriptAlias / {{ script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if admin_port -%}
+<VirtualHost *:{{ admin_port }}>
+    WSGIDaemonProcess {{ service_name }}-admin processes={{ admin_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-admin
+    WSGIScriptAlias / {{ admin_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
+
+{% if public_port -%}
+<VirtualHost *:{{ public_port }}>
+    WSGIDaemonProcess {{ service_name }}-public processes={{ public_processes }} threads={{ threads }} user={{ user }} group={{ group }} \
+                      display-name=%{GROUP}
+    WSGIProcessGroup {{ service_name }}-public
+    WSGIScriptAlias / {{ public_script }}
+    WSGIApplicationGroup %{GLOBAL}
+    WSGIPassAuthorization On
+    <IfVersion >= 2.4>
+      ErrorLogFormat "%{cu}t %M"
+    </IfVersion>
+    ErrorLog /var/log/apache2/{{ service_name }}_error.log
+    CustomLog /var/log/apache2/{{ service_name }}_access.log combined
+
+    <Directory /usr/bin>
+        <IfVersion >= 2.4>
+            Require all granted
+        </IfVersion>
+        <IfVersion < 2.4>
+            Order allow,deny
+            Allow from all
+        </IfVersion>
+    </Directory>
+</VirtualHost>
+{% endif -%}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..050f8af5c9135db4fafdbf5098edcd22c7157ff8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/templating.py
@@ -0,0 +1,379 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import six
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import (
+    log,
+    ERROR,
+    INFO,
+    TRACE
+)
+from charmhelpers.contrib.openstack.utils import OPENSTACK_CODENAMES
+
+try:
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY2:
+        apt_install('python-jinja2', fatal=True)
+    else:
+        apt_install('python3-jinja2', fatal=True)
+    from jinja2 import FileSystemLoader, ChoiceLoader, Environment, exceptions
+
+
+class OSConfigException(Exception):
+    pass
+
+
+def get_loader(templates_dir, os_release):
+    """
+    Create a jinja2.ChoiceLoader containing template dirs up to
+    and including os_release.  If directory template directory
+    is missing at templates_dir, it will be omitted from the loader.
+    templates_dir is added to the bottom of the search list as a base
+    loading dir.
+
+    A charm may also ship a templates dir with this module
+    and it will be appended to the bottom of the search list, eg::
+
+        hooks/charmhelpers/contrib/openstack/templates
+
+    :param templates_dir (str): Base template directory containing release
+        sub-directories.
+    :param os_release (str): OpenStack release codename to construct template
+        loader.
+    :returns: jinja2.ChoiceLoader constructed with a list of
+        jinja2.FilesystemLoaders, ordered in descending
+        order by OpenStack release.
+    """
+    tmpl_dirs = [(rel, os.path.join(templates_dir, rel))
+                 for rel in six.itervalues(OPENSTACK_CODENAMES)]
+
+    if not os.path.isdir(templates_dir):
+        log('Templates directory not found @ %s.' % templates_dir,
+            level=ERROR)
+        raise OSConfigException
+
+    # the bottom contains tempaltes_dir and possibly a common templates dir
+    # shipped with the helper.
+    loaders = [FileSystemLoader(templates_dir)]
+    helper_templates = os.path.join(os.path.dirname(__file__), 'templates')
+    if os.path.isdir(helper_templates):
+        loaders.append(FileSystemLoader(helper_templates))
+
+    for rel, tmpl_dir in tmpl_dirs:
+        if os.path.isdir(tmpl_dir):
+            loaders.insert(0, FileSystemLoader(tmpl_dir))
+        if rel == os_release:
+            break
+    # demote this log to the lowest level; we don't really need to see these
+    # lots in production even when debugging.
+    log('Creating choice loader with dirs: %s' %
+        [l.searchpath for l in loaders], level=TRACE)
+    return ChoiceLoader(loaders)
+
+
+class OSConfigTemplate(object):
+    """
+    Associates a config file template with a list of context generators.
+    Responsible for constructing a template context based on those generators.
+    """
+
+    def __init__(self, config_file, contexts, config_template=None):
+        self.config_file = config_file
+
+        if hasattr(contexts, '__call__'):
+            self.contexts = [contexts]
+        else:
+            self.contexts = contexts
+
+        self._complete_contexts = []
+
+        self.config_template = config_template
+
+    def context(self):
+        ctxt = {}
+        for context in self.contexts:
+            _ctxt = context()
+            if _ctxt:
+                ctxt.update(_ctxt)
+                # track interfaces for every complete context.
+                [self._complete_contexts.append(interface)
+                 for interface in context.interfaces
+                 if interface not in self._complete_contexts]
+        return ctxt
+
+    def complete_contexts(self):
+        '''
+        Return a list of interfaces that have satisfied contexts.
+        '''
+        if self._complete_contexts:
+            return self._complete_contexts
+        self.context()
+        return self._complete_contexts
+
+    @property
+    def is_string_template(self):
+        """:returns: Boolean if this instance is a template initialised with a string"""
+        return self.config_template is not None
+
+
+class OSConfigRenderer(object):
+    """
+    This class provides a common templating system to be used by OpenStack
+    charms.  It is intended to help charms share common code and templates,
+    and ease the burden of managing config templates across multiple OpenStack
+    releases.
+
+    Basic usage::
+
+        # import some common context generates from charmhelpers
+        from charmhelpers.contrib.openstack import context
+
+        # Create a renderer object for a specific OS release.
+        configs = OSConfigRenderer(templates_dir='/tmp/templates',
+                                   openstack_release='folsom')
+        # register some config files with context generators.
+        configs.register(config_file='/etc/nova/nova.conf',
+                         contexts=[context.SharedDBContext(),
+                                   context.AMQPContext()])
+        configs.register(config_file='/etc/nova/api-paste.ini',
+                         contexts=[context.IdentityServiceContext()])
+        configs.register(config_file='/etc/haproxy/haproxy.conf',
+                         contexts=[context.HAProxyContext()])
+        configs.register(config_file='/etc/keystone/policy.d/extra.cfg',
+                         contexts=[context.ExtraPolicyContext()
+                                   context.KeystoneContext()],
+                         config_template=hookenv.config('extra-policy'))
+        # write out a single config
+        configs.write('/etc/nova/nova.conf')
+        # write out all registered configs
+        configs.write_all()
+
+    **OpenStack Releases and template loading**
+
+    When the object is instantiated, it is associated with a specific OS
+    release.  This dictates how the template loader will be constructed.
+
+    The constructed loader attempts to load the template from several places
+    in the following order:
+    - from the most recent OS release-specific template dir (if one exists)
+    - the base templates_dir
+    - a template directory shipped in the charm with this helper file.
+
+    For the example above, '/tmp/templates' contains the following structure::
+
+        /tmp/templates/nova.conf
+        /tmp/templates/api-paste.ini
+        /tmp/templates/grizzly/api-paste.ini
+        /tmp/templates/havana/api-paste.ini
+
+    Since it was registered with the grizzly release, it first searches
+    the grizzly directory for nova.conf, then the templates dir.
+
+    When writing api-paste.ini, it will find the template in the grizzly
+    directory.
+
+    If the object were created with folsom, it would fall back to the
+    base templates dir for its api-paste.ini template.
+
+    This system should help manage changes in config files through
+    openstack releases, allowing charms to fall back to the most recently
+    updated config template for a given release
+
+    The haproxy.conf, since it is not shipped in the templates dir, will
+    be loaded from the module directory's template directory, eg
+    $CHARM/hooks/charmhelpers/contrib/openstack/templates.  This allows
+    us to ship common templates (haproxy, apache) with the helpers.
+
+    **Context generators**
+
+    Context generators are used to generate template contexts during hook
+    execution.  Doing so may require inspecting service relations, charm
+    config, etc.  When registered, a config file is associated with a list
+    of generators.  When a template is rendered and written, all context
+    generates are called in a chain to generate the context dictionary
+    passed to the jinja2 template. See context.py for more info.
+    """
+    def __init__(self, templates_dir, openstack_release):
+        if not os.path.isdir(templates_dir):
+            log('Could not locate templates dir %s' % templates_dir,
+                level=ERROR)
+            raise OSConfigException
+
+        self.templates_dir = templates_dir
+        self.openstack_release = openstack_release
+        self.templates = {}
+        self._tmpl_env = None
+
+        if None in [Environment, ChoiceLoader, FileSystemLoader]:
+            # if this code is running, the object is created pre-install hook.
+            # jinja2 shouldn't get touched until the module is reloaded on next
+            # hook execution, with proper jinja2 bits successfully imported.
+            if six.PY2:
+                apt_install('python-jinja2')
+            else:
+                apt_install('python3-jinja2')
+
+    def register(self, config_file, contexts, config_template=None):
+        """
+        Register a config file with a list of context generators to be called
+        during rendering.
+        config_template can be used to load a template from a string instead of
+        using template loaders and template files.
+        :param config_file (str): a path where a config file will be rendered
+        :param contexts (list): a list of context dictionaries with kv pairs
+        :param config_template (str): an optional template string to use
+        """
+        self.templates[config_file] = OSConfigTemplate(
+            config_file=config_file,
+            contexts=contexts,
+            config_template=config_template
+        )
+        log('Registered config file: {}'.format(config_file),
+            level=INFO)
+
+    def _get_tmpl_env(self):
+        if not self._tmpl_env:
+            loader = get_loader(self.templates_dir, self.openstack_release)
+            self._tmpl_env = Environment(loader=loader)
+
+    def _get_template(self, template):
+        self._get_tmpl_env()
+        template = self._tmpl_env.get_template(template)
+        log('Loaded template from {}'.format(template.filename),
+            level=INFO)
+        return template
+
+    def _get_template_from_string(self, ostmpl):
+        '''
+        Get a jinja2 template object from a string.
+        :param ostmpl: OSConfigTemplate to use as a data source.
+        '''
+        self._get_tmpl_env()
+        template = self._tmpl_env.from_string(ostmpl.config_template)
+        log('Loaded a template from a string for {}'.format(
+            ostmpl.config_file),
+            level=INFO)
+        return template
+
+    def render(self, config_file):
+        if config_file not in self.templates:
+            log('Config not registered: {}'.format(config_file), level=ERROR)
+            raise OSConfigException
+
+        ostmpl = self.templates[config_file]
+        ctxt = ostmpl.context()
+
+        if ostmpl.is_string_template:
+            template = self._get_template_from_string(ostmpl)
+            log('Rendering from a string template: '
+                '{}'.format(config_file),
+                level=INFO)
+        else:
+            _tmpl = os.path.basename(config_file)
+            try:
+                template = self._get_template(_tmpl)
+            except exceptions.TemplateNotFound:
+                # if no template is found with basename, try looking
+                # for it using a munged full path, eg:
+                # /etc/apache2/apache2.conf -> etc_apache2_apache2.conf
+                _tmpl = '_'.join(config_file.split('/')[1:])
+                try:
+                    template = self._get_template(_tmpl)
+                except exceptions.TemplateNotFound as e:
+                    log('Could not load template from {} by {} or {}.'
+                        ''.format(
+                            self.templates_dir,
+                            os.path.basename(config_file),
+                            _tmpl
+                        ),
+                        level=ERROR)
+                    raise e
+
+            log('Rendering from template: {}'.format(config_file),
+                level=INFO)
+        return template.render(ctxt)
+
+    def write(self, config_file):
+        """
+        Write a single config file, raises if config file is not registered.
+        """
+        if config_file not in self.templates:
+            log('Config not registered: %s' % config_file, level=ERROR)
+            raise OSConfigException
+
+        _out = self.render(config_file)
+        if six.PY3:
+            _out = _out.encode('UTF-8')
+
+        with open(config_file, 'wb') as out:
+            out.write(_out)
+
+        log('Wrote template %s.' % config_file, level=INFO)
+
+    def write_all(self):
+        """
+        Write out all registered config files.
+        """
+        [self.write(k) for k in six.iterkeys(self.templates)]
+
+    def set_release(self, openstack_release):
+        """
+        Resets the template environment and generates a new template loader
+        based on a the new openstack release.
+        """
+        self._tmpl_env = None
+        self.openstack_release = openstack_release
+        self._get_tmpl_env()
+
+    def complete_contexts(self):
+        '''
+        Returns a list of context interfaces that yield a complete context.
+        '''
+        interfaces = []
+        [interfaces.extend(i.complete_contexts())
+         for i in six.itervalues(self.templates)]
+        return interfaces
+
+    def get_incomplete_context_data(self, interfaces):
+        '''
+        Return dictionary of relation status of interfaces and any missing
+        required context data. Example:
+            {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+             'zeromq-configuration': {'related': False}}
+        '''
+        incomplete_context_data = {}
+
+        for i in six.itervalues(self.templates):
+            for context in i.contexts:
+                for interface in interfaces:
+                    related = False
+                    if interface in context.interfaces:
+                        related = context.get_related()
+                        missing_data = context.missing_data
+                        if missing_data:
+                            incomplete_context_data[interface] = {'missing_data': missing_data}
+                        if related:
+                            if incomplete_context_data.get(interface):
+                                incomplete_context_data[interface].update({'related': True})
+                            else:
+                                incomplete_context_data[interface] = {'related': True}
+                        else:
+                            incomplete_context_data[interface] = {'related': False}
+        return incomplete_context_data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..fbf0156108537f9caae35e193c346b0e4ee237b9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/utils.py
@@ -0,0 +1,2352 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Common python helper functions used for OpenStack charms.
+from collections import OrderedDict, namedtuple
+from functools import wraps
+
+import subprocess
+import json
+import os
+import sys
+import re
+import itertools
+import functools
+
+import six
+import traceback
+import uuid
+import yaml
+
+from charmhelpers import deprecate
+
+from charmhelpers.contrib.network import ip
+
+from charmhelpers.core import unitdata
+
+from charmhelpers.core.hookenv import (
+    WORKLOAD_STATES,
+    action_fail,
+    action_set,
+    config,
+    expected_peer_units,
+    expected_related_units,
+    log as juju_log,
+    charm_dir,
+    INFO,
+    ERROR,
+    metadata,
+    related_units,
+    relation_get,
+    relation_id,
+    relation_ids,
+    relation_set,
+    status_set,
+    hook_name,
+    application_version_set,
+    cached,
+    leader_set,
+    leader_get,
+    local_unit,
+)
+
+from charmhelpers.core.strutils import (
+    BasicStringComparator,
+    bool_from_string,
+)
+
+from charmhelpers.contrib.storage.linux.lvm import (
+    deactivate_lvm_volume_group,
+    is_lvm_physical_volume,
+    remove_lvm_physical_volume,
+)
+
+from charmhelpers.contrib.network.ip import (
+    get_ipv6_addr,
+    is_ipv6,
+    port_has_listener,
+)
+
+from charmhelpers.core.host import (
+    lsb_release,
+    mounts,
+    umount,
+    service_running,
+    service_pause,
+    service_resume,
+    service_stop,
+    service_start,
+    restart_on_change_helper,
+)
+from charmhelpers.fetch import (
+    apt_cache,
+    import_key as fetch_import_key,
+    add_source as fetch_add_source,
+    SourceConfigError,
+    GPGKeyError,
+    get_upstream_version,
+    filter_missing_packages,
+    ubuntu_apt_pkg as apt,
+)
+
+from charmhelpers.fetch.snap import (
+    snap_install,
+    snap_refresh,
+    valid_snap_channel,
+)
+
+from charmhelpers.contrib.storage.linux.utils import is_block_device, zap_disk
+from charmhelpers.contrib.storage.linux.loopback import ensure_loopback_device
+from charmhelpers.contrib.openstack.exceptions import OSContextError
+from charmhelpers.contrib.openstack.policyd import (
+    policyd_status_message_prefix,
+    POLICYD_CONFIG_NAME,
+)
+
+from charmhelpers.contrib.openstack.ha.utils import (
+    expect_ha,
+)
+
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+
+DISTRO_PROPOSED = ('deb http://archive.ubuntu.com/ubuntu/ %s-proposed '
+                   'restricted main multiverse universe')
+
+OPENSTACK_RELEASES = (
+    'diablo',
+    'essex',
+    'folsom',
+    'grizzly',
+    'havana',
+    'icehouse',
+    'juno',
+    'kilo',
+    'liberty',
+    'mitaka',
+    'newton',
+    'ocata',
+    'pike',
+    'queens',
+    'rocky',
+    'stein',
+    'train',
+    'ussuri',
+)
+
+UBUNTU_OPENSTACK_RELEASE = OrderedDict([
+    ('oneiric', 'diablo'),
+    ('precise', 'essex'),
+    ('quantal', 'folsom'),
+    ('raring', 'grizzly'),
+    ('saucy', 'havana'),
+    ('trusty', 'icehouse'),
+    ('utopic', 'juno'),
+    ('vivid', 'kilo'),
+    ('wily', 'liberty'),
+    ('xenial', 'mitaka'),
+    ('yakkety', 'newton'),
+    ('zesty', 'ocata'),
+    ('artful', 'pike'),
+    ('bionic', 'queens'),
+    ('cosmic', 'rocky'),
+    ('disco', 'stein'),
+    ('eoan', 'train'),
+    ('focal', 'ussuri'),
+])
+
+
+OPENSTACK_CODENAMES = OrderedDict([
+    ('2011.2', 'diablo'),
+    ('2012.1', 'essex'),
+    ('2012.2', 'folsom'),
+    ('2013.1', 'grizzly'),
+    ('2013.2', 'havana'),
+    ('2014.1', 'icehouse'),
+    ('2014.2', 'juno'),
+    ('2015.1', 'kilo'),
+    ('2015.2', 'liberty'),
+    ('2016.1', 'mitaka'),
+    ('2016.2', 'newton'),
+    ('2017.1', 'ocata'),
+    ('2017.2', 'pike'),
+    ('2018.1', 'queens'),
+    ('2018.2', 'rocky'),
+    ('2019.1', 'stein'),
+    ('2019.2', 'train'),
+    ('2020.1', 'ussuri'),
+])
+
+# The ugly duckling - must list releases oldest to newest
+SWIFT_CODENAMES = OrderedDict([
+    ('diablo',
+        ['1.4.3']),
+    ('essex',
+        ['1.4.8']),
+    ('folsom',
+        ['1.7.4']),
+    ('grizzly',
+        ['1.7.6', '1.7.7', '1.8.0']),
+    ('havana',
+        ['1.9.0', '1.9.1', '1.10.0']),
+    ('icehouse',
+        ['1.11.0', '1.12.0', '1.13.0', '1.13.1']),
+    ('juno',
+        ['2.0.0', '2.1.0', '2.2.0']),
+    ('kilo',
+        ['2.2.1', '2.2.2']),
+    ('liberty',
+        ['2.3.0', '2.4.0', '2.5.0']),
+    ('mitaka',
+        ['2.5.0', '2.6.0', '2.7.0']),
+    ('newton',
+        ['2.8.0', '2.9.0', '2.10.0']),
+    ('ocata',
+        ['2.11.0', '2.12.0', '2.13.0']),
+    ('pike',
+        ['2.13.0', '2.15.0']),
+    ('queens',
+        ['2.16.0', '2.17.0']),
+    ('rocky',
+        ['2.18.0', '2.19.0']),
+    ('stein',
+        ['2.20.0', '2.21.0']),
+    ('train',
+        ['2.22.0', '2.23.0']),
+    ('ussuri',
+        ['2.24.0', '2.25.0']),
+])
+
+# >= Liberty version->codename mapping
+PACKAGE_CODENAMES = {
+    'nova-common': OrderedDict([
+        ('12', 'liberty'),
+        ('13', 'mitaka'),
+        ('14', 'newton'),
+        ('15', 'ocata'),
+        ('16', 'pike'),
+        ('17', 'queens'),
+        ('18', 'rocky'),
+        ('19', 'stein'),
+        ('20', 'train'),
+        ('21', 'ussuri'),
+    ]),
+    'neutron-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'cinder-common': OrderedDict([
+        ('7', 'liberty'),
+        ('8', 'mitaka'),
+        ('9', 'newton'),
+        ('10', 'ocata'),
+        ('11', 'pike'),
+        ('12', 'queens'),
+        ('13', 'rocky'),
+        ('14', 'stein'),
+        ('15', 'train'),
+        ('16', 'ussuri'),
+    ]),
+    'keystone': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('17', 'ussuri'),
+    ]),
+    'horizon-common': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+    'ceilometer-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'heat-common': OrderedDict([
+        ('5', 'liberty'),
+        ('6', 'mitaka'),
+        ('7', 'newton'),
+        ('8', 'ocata'),
+        ('9', 'pike'),
+        ('10', 'queens'),
+        ('11', 'rocky'),
+        ('12', 'stein'),
+        ('13', 'train'),
+        ('14', 'ussuri'),
+    ]),
+    'glance-common': OrderedDict([
+        ('11', 'liberty'),
+        ('12', 'mitaka'),
+        ('13', 'newton'),
+        ('14', 'ocata'),
+        ('15', 'pike'),
+        ('16', 'queens'),
+        ('17', 'rocky'),
+        ('18', 'stein'),
+        ('19', 'train'),
+        ('20', 'ussuri'),
+    ]),
+    'openstack-dashboard': OrderedDict([
+        ('8', 'liberty'),
+        ('9', 'mitaka'),
+        ('10', 'newton'),
+        ('11', 'ocata'),
+        ('12', 'pike'),
+        ('13', 'queens'),
+        ('14', 'rocky'),
+        ('15', 'stein'),
+        ('16', 'train'),
+        ('18', 'ussuri'),
+    ]),
+}
+
+DEFAULT_LOOPBACK_SIZE = '5G'
+
+DB_SERIES_UPGRADING_KEY = 'cluster-series-upgrading'
+
+DB_MAINTENANCE_KEYS = [DB_SERIES_UPGRADING_KEY]
+
+
+class CompareOpenStackReleases(BasicStringComparator):
+    """Provide comparisons of OpenStack releases.
+
+    Use in the form of
+
+    if CompareOpenStackReleases(release) > 'mitaka':
+        # do something with mitaka
+    """
+    _list = OPENSTACK_RELEASES
+
+
+def error_out(msg):
+    juju_log("FATAL ERROR: %s" % msg, level='ERROR')
+    sys.exit(1)
+
+
+def get_installed_semantic_versioned_packages():
+    '''Get a list of installed packages which have OpenStack semantic versioning
+
+    :returns List of installed packages
+    :rtype: [pkg1, pkg2, ...]
+    '''
+    return filter_missing_packages(PACKAGE_CODENAMES.keys())
+
+
+def get_os_codename_install_source(src):
+    '''Derive OpenStack release codename from a given installation source.'''
+    ubuntu_rel = lsb_release()['DISTRIB_CODENAME']
+    rel = ''
+    if src is None:
+        return rel
+    if src in ['distro', 'distro-proposed', 'proposed']:
+        try:
+            rel = UBUNTU_OPENSTACK_RELEASE[ubuntu_rel]
+        except KeyError:
+            e = 'Could not derive openstack release for '\
+                'this Ubuntu release: %s' % ubuntu_rel
+            error_out(e)
+        return rel
+
+    if src.startswith('cloud:'):
+        ca_rel = src.split(':')[1]
+        ca_rel = ca_rel.split('-')[1].split('/')[0]
+        return ca_rel
+
+    # Best guess match based on deb string provided
+    if (src.startswith('deb') or
+            src.startswith('ppa') or
+            src.startswith('snap')):
+        for v in OPENSTACK_CODENAMES.values():
+            if v in src:
+                return v
+
+
+def get_os_version_install_source(src):
+    codename = get_os_codename_install_source(src)
+    return get_os_version_codename(codename)
+
+
+def get_os_codename_version(vers):
+    '''Determine OpenStack codename from version number.'''
+    try:
+        return OPENSTACK_CODENAMES[vers]
+    except KeyError:
+        e = 'Could not determine OpenStack codename for version %s' % vers
+        error_out(e)
+
+
+def get_os_version_codename(codename, version_map=OPENSTACK_CODENAMES):
+    '''Determine OpenStack version number from codename.'''
+    for k, v in six.iteritems(version_map):
+        if v == codename:
+            return k
+    e = 'Could not derive OpenStack version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_os_version_codename_swift(codename):
+    '''Determine OpenStack version number of swift from codename.'''
+    for k, v in six.iteritems(SWIFT_CODENAMES):
+        if k == codename:
+            return v[-1]
+    e = 'Could not derive swift version for '\
+        'codename: %s' % codename
+    error_out(e)
+
+
+def get_swift_codename(version):
+    '''Determine OpenStack codename that corresponds to swift version.'''
+    codenames = [k for k, v in six.iteritems(SWIFT_CODENAMES) if version in v]
+
+    if len(codenames) > 1:
+        # If more than one release codename contains this version we determine
+        # the actual codename based on the highest available install source.
+        for codename in reversed(codenames):
+            releases = UBUNTU_OPENSTACK_RELEASE
+            release = [k for k, v in six.iteritems(releases) if codename in v]
+            ret = subprocess.check_output(['apt-cache', 'policy', 'swift'])
+            if six.PY3:
+                ret = ret.decode('UTF-8')
+            if codename in ret or release[0] in ret:
+                return codename
+    elif len(codenames) == 1:
+        return codenames[0]
+
+    # NOTE: fallback - attempt to match with just major.minor version
+    match = re.match(r'^(\d+)\.(\d+)', version)
+    if match:
+        major_minor_version = match.group(0)
+        for codename, versions in six.iteritems(SWIFT_CODENAMES):
+            for release_version in versions:
+                if release_version.startswith(major_minor_version):
+                    return codename
+
+    return None
+
+
+def get_os_codename_package(package, fatal=True):
+    '''Derive OpenStack release codename from an installed package.'''
+
+    if snap_install_requested():
+        cmd = ['snap', 'list', package]
+        try:
+            out = subprocess.check_output(cmd)
+            if six.PY3:
+                out = out.decode('UTF-8')
+        except subprocess.CalledProcessError:
+            return None
+        lines = out.split('\n')
+        for line in lines:
+            if package in line:
+                # Second item in list is Version
+                return line.split()[1]
+
+    cache = apt_cache()
+
+    try:
+        pkg = cache[package]
+    except Exception:
+        if not fatal:
+            return None
+        # the package is unknown to the current apt cache.
+        e = 'Could not determine version of package with no installation '\
+            'candidate: %s' % package
+        error_out(e)
+
+    if not pkg.current_ver:
+        if not fatal:
+            return None
+        # package is known, but no version is currently installed.
+        e = 'Could not determine version of uninstalled package: %s' % package
+        error_out(e)
+
+    vers = apt.upstream_version(pkg.current_ver.ver_str)
+    if 'swift' in pkg.name:
+        # Fully x.y.z match for swift versions
+        match = re.match(r'^(\d+)\.(\d+)\.(\d+)', vers)
+    else:
+        # x.y match only for 20XX.X
+        # and ignore patch level for other packages
+        match = re.match(r'^(\d+)\.(\d+)', vers)
+
+    if match:
+        vers = match.group(0)
+
+    # Generate a major version number for newer semantic
+    # versions of openstack projects
+    major_vers = vers.split('.')[0]
+    # >= Liberty independent project versions
+    if (package in PACKAGE_CODENAMES and
+            major_vers in PACKAGE_CODENAMES[package]):
+        return PACKAGE_CODENAMES[package][major_vers]
+    else:
+        # < Liberty co-ordinated project versions
+        try:
+            if 'swift' in pkg.name:
+                return get_swift_codename(vers)
+            else:
+                return OPENSTACK_CODENAMES[vers]
+        except KeyError:
+            if not fatal:
+                return None
+            e = 'Could not determine OpenStack codename for version %s' % vers
+            error_out(e)
+
+
+def get_os_version_package(pkg, fatal=True):
+    '''Derive OpenStack version number from an installed package.'''
+    codename = get_os_codename_package(pkg, fatal=fatal)
+
+    if not codename:
+        return None
+
+    if 'swift' in pkg:
+        vers_map = SWIFT_CODENAMES
+        for cname, version in six.iteritems(vers_map):
+            if cname == codename:
+                return version[-1]
+    else:
+        vers_map = OPENSTACK_CODENAMES
+        for version, cname in six.iteritems(vers_map):
+            if cname == codename:
+                return version
+    # e = "Could not determine OpenStack version for package: %s" % pkg
+    # error_out(e)
+
+
+# Module local cache variable for the os_release.
+_os_rel = None
+
+
+def reset_os_release():
+    '''Unset the cached os_release version'''
+    global _os_rel
+    _os_rel = None
+
+
+def os_release(package, base=None, reset_cache=False, source_key=None):
+    """Returns OpenStack release codename from a cached global.
+
+    If reset_cache then unset the cached os_release version and return the
+    freshly determined version.
+
+    If the codename can not be determined from either an installed package or
+    the installation source, the earliest release supported by the charm should
+    be returned.
+
+    :param package: Name of package to determine release from
+    :type package: str
+    :param base: Fallback codename if endavours to determine from package fail
+    :type base: Optional[str]
+    :param reset_cache: Reset any cached codename value
+    :type reset_cache: bool
+    :param source_key: Name of source configuration option
+                       (default: 'openstack-origin')
+    :type source_key: Optional[str]
+    :returns: OpenStack release codename
+    :rtype: str
+    """
+    source_key = source_key or 'openstack-origin'
+    if not base:
+        base = UBUNTU_OPENSTACK_RELEASE[lsb_release()['DISTRIB_CODENAME']]
+    global _os_rel
+    if reset_cache:
+        reset_os_release()
+    if _os_rel:
+        return _os_rel
+    _os_rel = (
+        get_os_codename_package(package, fatal=False) or
+        get_os_codename_install_source(config(source_key)) or
+        base)
+    return _os_rel
+
+
+@deprecate("moved to charmhelpers.fetch.import_key()", "2017-07", log=juju_log)
+def import_key(keyid):
+    """Import a key, either ASCII armored, or a GPG key id.
+
+    @param keyid: the key in ASCII armor format, or a GPG key id.
+    @raises SystemExit() via sys.exit() on failure.
+    """
+    try:
+        return fetch_import_key(keyid)
+    except GPGKeyError as e:
+        error_out("Could not import key: {}".format(str(e)))
+
+
+def get_source_and_pgp_key(source_and_key):
+    """Look for a pgp key ID or ascii-armor key in the given input.
+
+    :param source_and_key: Sting, "source_spec|keyid" where '|keyid' is
+        optional.
+    :returns (source_spec, key_id OR None) as a tuple.  Returns None for key_id
+        if there was no '|' in the source_and_key string.
+    """
+    try:
+        source, key = source_and_key.split('|', 2)
+        return source, key or None
+    except ValueError:
+        return source_and_key, None
+
+
+@deprecate("use charmhelpers.fetch.add_source() instead.",
+           "2017-07", log=juju_log)
+def configure_installation_source(source_plus_key):
+    """Configure an installation source.
+
+    The functionality is provided by charmhelpers.fetch.add_source()
+    The difference between the two functions is that add_source() signature
+    requires the key to be passed directly, whereas this function passes an
+    optional key by appending '|<key>' to the end of the source specificiation
+    'source'.
+
+    Another difference from add_source() is that the function calls sys.exit(1)
+    if the configuration fails, whereas add_source() raises
+    SourceConfigurationError().  Another difference, is that add_source()
+    silently fails (with a juju_log command) if there is no matching source to
+    configure, whereas this function fails with a sys.exit(1)
+
+    :param source: String_plus_key -- see above for details.
+
+    Note that the behaviour on error is to log the error to the juju log and
+    then call sys.exit(1).
+    """
+    if source_plus_key.startswith('snap'):
+        # Do nothing for snap installs
+        return
+    # extract the key if there is one, denoted by a '|' in the rel
+    source, key = get_source_and_pgp_key(source_plus_key)
+
+    # handle the ordinary sources via add_source
+    try:
+        fetch_add_source(source, key, fail_invalid=True)
+    except SourceConfigError as se:
+        error_out(str(se))
+
+
+def config_value_changed(option):
+    """
+    Determine if config value changed since last call to this function.
+    """
+    hook_data = unitdata.HookData()
+    with hook_data():
+        db = unitdata.kv()
+        current = config(option)
+        saved = db.get(option)
+        db.set(option, current)
+        if saved is None:
+            return False
+        return current != saved
+
+
+def get_endpoint_key(service_name, relation_id, unit_name):
+    """Return the key used to refer to an ep changed notification from a unit.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param relation_id: The id of the relation the unit is on.
+    :type relation_id: str
+    :param unit_name: The name of the unit publishing the notification.
+    :type unit_name: str
+    :returns: The key used to refer to an ep changed notification from a unit
+    :rtype: str
+    """
+    return '{}-{}-{}'.format(
+        service_name,
+        relation_id.replace(':', '_'),
+        unit_name.replace('/', '_'))
+
+
+def get_endpoint_notifications(service_names, rel_name='identity-service'):
+    """Return all notifications for the given services.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: A dict containing the source of the notification and its nonce.
+    :rtype: Dict[str, str]
+    """
+    notifications = {}
+    for rid in relation_ids(rel_name):
+        for unit in related_units(relid=rid):
+            ep_changed_json = relation_get(
+                rid=rid,
+                unit=unit,
+                attribute='ep_changed')
+            if ep_changed_json:
+                ep_changed = json.loads(ep_changed_json)
+                for service in service_names:
+                    if ep_changed.get(service):
+                        key = get_endpoint_key(service, rid, unit)
+                        notifications[key] = ep_changed[service]
+    return notifications
+
+
+def endpoint_changed(service_name, rel_name='identity-service'):
+    """Whether a new notification has been recieved for an endpoint.
+
+    :param service_name: Service name eg nova, neutron, placement etc
+    :type service_name: str
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    :returns: Whether endpoint has changed
+    :rtype: bool
+    """
+    changed = False
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            [service_name],
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            if db.get(key) != nonce:
+                juju_log(('New endpoint change notification found: '
+                          '{}={}').format(key, nonce),
+                         'INFO')
+                changed = True
+                break
+    return changed
+
+
+def save_endpoint_changed_triggers(service_names, rel_name='identity-service'):
+    """Save the enpoint triggers in  db so it can be tracked if they changed.
+
+    :param service_names: List of service name.
+    :type service_name: List
+    :param rel_name: Name of the relation to query
+    :type rel_name: str
+    """
+    with unitdata.HookData()() as t:
+        db = t[0]
+        notifications = get_endpoint_notifications(
+            service_names,
+            rel_name=rel_name)
+        for key, nonce in notifications.items():
+            db.set(key, nonce)
+
+
+def save_script_rc(script_path="scripts/scriptrc", **env_vars):
+    """
+    Write an rc file in the charm-delivered directory containing
+    exported environment variables provided by env_vars. Any charm scripts run
+    outside the juju hook environment can source this scriptrc to obtain
+    updated config information necessary to perform health checks or
+    service changes.
+    """
+    juju_rc_path = "%s/%s" % (charm_dir(), script_path)
+    if not os.path.exists(os.path.dirname(juju_rc_path)):
+        os.mkdir(os.path.dirname(juju_rc_path))
+    with open(juju_rc_path, 'wt') as rc_script:
+        rc_script.write(
+            "#!/bin/bash\n")
+        [rc_script.write('export %s=%s\n' % (u, p))
+         for u, p in six.iteritems(env_vars) if u != "script_path"]
+
+
+def openstack_upgrade_available(package):
+    """
+    Determines if an OpenStack upgrade is available from installation
+    source, based on version of installed package.
+
+    :param package: str: Name of installed package.
+
+    :returns: bool:    : Returns True if configured installation source offers
+                         a newer version of package.
+    """
+
+    src = config('openstack-origin')
+    cur_vers = get_os_version_package(package)
+    if not cur_vers:
+        # The package has not been installed yet do not attempt upgrade
+        return False
+    if "swift" in package:
+        codename = get_os_codename_install_source(src)
+        avail_vers = get_os_version_codename_swift(codename)
+    else:
+        try:
+            avail_vers = get_os_version_install_source(src)
+        except Exception:
+            avail_vers = cur_vers
+    apt.init()
+    return apt.version_compare(avail_vers, cur_vers) >= 1
+
+
+def ensure_block_device(block_device):
+    '''
+    Confirm block_device, create as loopback if necessary.
+
+    :param block_device: str: Full path of block device to ensure.
+
+    :returns: str: Full path of ensured block device.
+    '''
+    _none = ['None', 'none', None]
+    if (block_device in _none):
+        error_out('prepare_storage(): Missing required input: block_device=%s.'
+                  % block_device)
+
+    if block_device.startswith('/dev/'):
+        bdev = block_device
+    elif block_device.startswith('/'):
+        _bd = block_device.split('|')
+        if len(_bd) == 2:
+            bdev, size = _bd
+        else:
+            bdev = block_device
+            size = DEFAULT_LOOPBACK_SIZE
+        bdev = ensure_loopback_device(bdev, size)
+    else:
+        bdev = '/dev/%s' % block_device
+
+    if not is_block_device(bdev):
+        error_out('Failed to locate valid block device at %s' % bdev)
+
+    return bdev
+
+
+def clean_storage(block_device):
+    '''
+    Ensures a block device is clean.  That is:
+        - unmounted
+        - any lvm volume groups are deactivated
+        - any lvm physical device signatures removed
+        - partition table wiped
+
+    :param block_device: str: Full path to block device to clean.
+    '''
+    for mp, d in mounts():
+        if d == block_device:
+            juju_log('clean_storage(): %s is mounted @ %s, unmounting.' %
+                     (d, mp), level=INFO)
+            umount(mp, persist=True)
+
+    if is_lvm_physical_volume(block_device):
+        deactivate_lvm_volume_group(block_device)
+        remove_lvm_physical_volume(block_device)
+    else:
+        zap_disk(block_device)
+
+
+is_ip = ip.is_ip
+ns_query = ip.ns_query
+get_host_ip = ip.get_host_ip
+get_hostname = ip.get_hostname
+
+
+def get_matchmaker_map(mm_file='/etc/oslo/matchmaker_ring.json'):
+    mm_map = {}
+    if os.path.isfile(mm_file):
+        with open(mm_file, 'r') as f:
+            mm_map = json.load(f)
+    return mm_map
+
+
+def sync_db_with_multi_ipv6_addresses(database, database_user,
+                                      relation_prefix=None):
+    hosts = get_ipv6_addr(dynamic_only=False)
+
+    if config('vip'):
+        vips = config('vip').split()
+        for vip in vips:
+            if vip and is_ipv6(vip):
+                hosts.append(vip)
+
+    kwargs = {'database': database,
+              'username': database_user,
+              'hostname': json.dumps(hosts)}
+
+    if relation_prefix:
+        for key in list(kwargs.keys()):
+            kwargs["%s_%s" % (relation_prefix, key)] = kwargs[key]
+            del kwargs[key]
+
+    for rid in relation_ids('shared-db'):
+        relation_set(relation_id=rid, **kwargs)
+
+
+def os_requires_version(ostack_release, pkg):
+    """
+    Decorator for hook to specify minimum supported release
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args):
+            if os_release(pkg) < ostack_release:
+                raise Exception("This hook is not supported on releases"
+                                " before %s" % ostack_release)
+            f(*args)
+        return wrapped_f
+    return wrap
+
+
+def os_workload_status(configs, required_interfaces, charm_func=None):
+    """
+    Decorator to set workload status based on complete contexts
+    """
+    def wrap(f):
+        @wraps(f)
+        def wrapped_f(*args, **kwargs):
+            # Run the original function first
+            f(*args, **kwargs)
+            # Set workload status now that contexts have been
+            # acted on
+            set_os_workload_status(configs, required_interfaces, charm_func)
+        return wrapped_f
+    return wrap
+
+
+def set_os_workload_status(configs, required_interfaces, charm_func=None,
+                           services=None, ports=None):
+    """Set the state of the workload status for the charm.
+
+    This calls _determine_os_workload_status() to get the new state, message
+    and sets the status using status_set()
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _determine_os_workload_status(
+        configs, required_interfaces, charm_func, services, ports)
+    status_set(state, message)
+
+
+def _determine_os_workload_status(
+        configs, required_interfaces, charm_func=None,
+        services=None, ports=None):
+    """Determine the state of the workload status for the charm.
+
+    This function returns the new workload status for the charm based
+    on the state of the interfaces, the paused state and whether the
+    services are actually running and any specified ports are open.
+
+    This checks:
+
+     1. if the unit should be paused, that it is actually paused.  If so the
+        state is 'maintenance' + message, else 'broken'.
+     2. that the interfaces/relations are complete.  If they are not then
+        it sets the state to either 'broken' or 'waiting' and an appropriate
+        message.
+     3. If all the relation data is set, then it checks that the actual
+        services really are running.  If not it sets the state to 'broken'.
+
+    If everything is okay then the state returns 'active'.
+
+    @param configs: a templating.OSConfigRenderer() object
+    @param required_interfaces: {generic: [specific, specific2, ...]}
+    @param charm_func: a callable function that returns state, message. The
+                       signature is charm_func(configs) -> (state, message)
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message: the new workload status, user message
+    """
+    state, message = _ows_check_if_paused(services, ports)
+
+    if state is None:
+        state, message = _ows_check_generic_interfaces(
+            configs, required_interfaces)
+
+    if state != 'maintenance' and charm_func:
+        # _ows_check_charm_func() may modify the state, message
+        state, message = _ows_check_charm_func(
+            state, message, lambda: charm_func(configs))
+
+    if state is None:
+        state, message = _ows_check_services_running(services, ports)
+
+    if state is None:
+        state = 'active'
+        message = "Unit is ready"
+        juju_log(message, 'INFO')
+
+    try:
+        if config(POLICYD_CONFIG_NAME):
+            message = "{} {}".format(policyd_status_message_prefix(), message)
+    except Exception:
+        pass
+
+    return state, message
+
+
+def _ows_check_if_paused(services=None, ports=None):
+    """Check if the unit is supposed to be paused, and if so check that the
+    services/ports (if passed) are actually stopped/not being listened to.
+
+    If the unit isn't supposed to be paused, just return None, None
+
+    If the unit is performing a series upgrade, return a message indicating
+    this.
+
+    @param services: OPTIONAL services spec or list of service names.
+    @param ports: OPTIONAL list of port numbers.
+    @returns state, message or None, None
+    """
+    if is_unit_upgrading_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "blocked"
+            message = ("Ready for do-release-upgrade and reboot. "
+                       "Set complete when finished.")
+        return state, message
+
+    if is_unit_paused_set():
+        state, message = check_actually_paused(services=services,
+                                               ports=ports)
+        if state is None:
+            # we're paused okay, so set maintenance and return
+            state = "maintenance"
+            message = "Paused. Use 'resume' action to resume normal service."
+        return state, message
+    return None, None
+
+
+def _ows_check_generic_interfaces(configs, required_interfaces):
+    """Check the complete contexts to determine the workload status.
+
+     - Checks for missing or incomplete contexts
+     - juju log details of missing required data.
+     - determines the correct workload status
+     - creates an appropriate message for status_set(...)
+
+    if there are no problems then the function returns None, None
+
+    @param configs: a templating.OSConfigRenderer() object
+    @params required_interfaces: {generic_interface: [specific_interface], }
+    @returns state, message or None, None
+    """
+    incomplete_rel_data = incomplete_relation_data(configs,
+                                                   required_interfaces)
+    state = None
+    message = None
+    missing_relations = set()
+    incomplete_relations = set()
+
+    for generic_interface, relations_states in incomplete_rel_data.items():
+        related_interface = None
+        missing_data = {}
+        # Related or not?
+        for interface, relation_state in relations_states.items():
+            if relation_state.get('related'):
+                related_interface = interface
+                missing_data = relation_state.get('missing_data')
+                break
+        # No relation ID for the generic_interface?
+        if not related_interface:
+            juju_log("{} relation is missing and must be related for "
+                     "functionality. ".format(generic_interface), 'WARN')
+            state = 'blocked'
+            missing_relations.add(generic_interface)
+        else:
+            # Relation ID eists but no related unit
+            if not missing_data:
+                # Edge case - relation ID exists but departings
+                _hook_name = hook_name()
+                if (('departed' in _hook_name or 'broken' in _hook_name) and
+                        related_interface in _hook_name):
+                    state = 'blocked'
+                    missing_relations.add(generic_interface)
+                    juju_log("{} relation's interface, {}, "
+                             "relationship is departed or broken "
+                             "and is required for functionality."
+                             "".format(generic_interface, related_interface),
+                             "WARN")
+                # Normal case relation ID exists but no related unit
+                # (joining)
+                else:
+                    juju_log("{} relations's interface, {}, is related but has"
+                             " no units in the relation."
+                             "".format(generic_interface, related_interface),
+                             "INFO")
+            # Related unit exists and data missing on the relation
+            else:
+                juju_log("{} relation's interface, {}, is related awaiting "
+                         "the following data from the relationship: {}. "
+                         "".format(generic_interface, related_interface,
+                                   ", ".join(missing_data)), "INFO")
+            if state != 'blocked':
+                state = 'waiting'
+            if generic_interface not in missing_relations:
+                incomplete_relations.add(generic_interface)
+
+    if missing_relations:
+        message = "Missing relations: {}".format(", ".join(missing_relations))
+        if incomplete_relations:
+            message += "; incomplete relations: {}" \
+                       "".format(", ".join(incomplete_relations))
+        state = 'blocked'
+    elif incomplete_relations:
+        message = "Incomplete relations: {}" \
+                  "".format(", ".join(incomplete_relations))
+        state = 'waiting'
+
+    return state, message
+
+
+def _ows_check_charm_func(state, message, charm_func_with_configs):
+    """Run a custom check function for the charm to see if it wants to
+    change the state.  This is only run if not in 'maintenance' and
+    tests to see if the new state is more important that the previous
+    one determined by the interfaces/relations check.
+
+    @param state: the previously determined state so far.
+    @param message: the user orientated message so far.
+    @param charm_func: a callable function that returns state, message
+    @returns state, message strings.
+    """
+    if charm_func_with_configs:
+        charm_state, charm_message = charm_func_with_configs()
+        if (charm_state != 'active' and
+                charm_state != 'unknown' and
+                charm_state is not None):
+            state = workload_state_compare(state, charm_state)
+            if message:
+                charm_message = charm_message.replace("Incomplete relations: ",
+                                                      "")
+                message = "{}, {}".format(message, charm_message)
+            else:
+                message = charm_message
+    return state, message
+
+
+def _ows_check_services_running(services, ports):
+    """Check that the services that should be running are actually running
+    and that any ports specified are being listened to.
+
+    @param services: list of strings OR dictionary specifying services/ports
+    @param ports: list of ports
+    @returns state, message: strings or None, None
+    """
+    messages = []
+    state = None
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, running = _check_running_services(services)
+        if not all(running):
+            messages.append(
+                "Services not running that should be: {}"
+                .format(", ".join(_filter_tuples(services_running, False))))
+            state = 'blocked'
+        # also verify that the ports that should be open are open
+        # NB, that ServiceManager objects only OPTIONALLY have ports
+        map_not_open, ports_open = (
+            _check_listening_on_services_ports(services))
+        if not all(ports_open):
+            # find which service has missing ports. They are in service
+            # order which makes it a bit easier.
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in map_not_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "Services with ports not open that should be: {}"
+                .format(message))
+            state = 'blocked'
+
+    if ports is not None:
+        # and we can also check ports which we don't know the service for
+        ports_open, ports_open_bools = _check_listening_on_ports_list(ports)
+        if not all(ports_open_bools):
+            messages.append(
+                "Ports which should be open, but are not: {}"
+                .format(", ".join([str(p) for p, v in ports_open
+                                   if not v])))
+            state = 'blocked'
+
+    if state is not None:
+        message = "; ".join(messages)
+        return state, message
+
+    return None, None
+
+
+def _extract_services_list_helper(services):
+    """Extract a OrderedDict of {service: [ports]} of the supplied services
+    for use by the other functions.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param services: see above
+    @returns OrderedDict(service: [ports], ...)
+    """
+    if services is None:
+        return {}
+    if isinstance(services, dict):
+        services = services.values()
+    # either extract the list of services from the dictionary, or if
+    # it is a simple string, use that. i.e. works with mixed lists.
+    _s = OrderedDict()
+    for s in services:
+        if isinstance(s, dict) and 'service' in s:
+            _s[s['service']] = s.get('ports', [])
+        if isinstance(s, str):
+            _s[s] = []
+    return _s
+
+
+def _check_running_services(services):
+    """Check that the services dict provided is actually running and provide
+    a list of (service, boolean) tuples for each service.
+
+    Returns both a zipped list of (service, boolean) and a list of booleans
+    in the same order as the services.
+
+    @param services: OrderedDict of strings: [ports], one for each service to
+                     check.
+    @returns [(service, boolean), ...], : results for checks
+             [boolean]                  : just the result of the service checks
+    """
+    services_running = [service_running(s) for s in services]
+    return list(zip(services, services_running)), services_running
+
+
+def _check_listening_on_services_ports(services, test=False):
+    """Check that the unit is actually listening (has the port open) on the
+    ports that the service specifies are open. If test is True then the
+    function returns the services with ports that are open rather than
+    closed.
+
+    Returns an OrderedDict of service: ports and a list of booleans
+
+    @param services: OrderedDict(service: [port, ...], ...)
+    @param test: default=False, if False, test for closed, otherwise open.
+    @returns OrderedDict(service: [port-not-open, ...]...), [boolean]
+    """
+    test = not(not(test))  # ensure test is True or False
+    all_ports = list(itertools.chain(*services.values()))
+    ports_states = [port_has_listener('0.0.0.0', p) for p in all_ports]
+    map_ports = OrderedDict()
+    matched_ports = [p for p, opened in zip(all_ports, ports_states)
+                     if opened == test]  # essentially opened xor test
+    for service, ports in services.items():
+        set_ports = set(ports).intersection(matched_ports)
+        if set_ports:
+            map_ports[service] = set_ports
+    return map_ports, ports_states
+
+
+def _check_listening_on_ports_list(ports):
+    """Check that the ports list given are being listened to
+
+    Returns a list of ports being listened to and a list of the
+    booleans.
+
+    @param ports: LIST or port numbers.
+    @returns [(port_num, boolean), ...], [boolean]
+    """
+    ports_open = [port_has_listener('0.0.0.0', p) for p in ports]
+    return zip(ports, ports_open), ports_open
+
+
+def _filter_tuples(services_states, state):
+    """Return a simple list from a list of tuples according to the condition
+
+    @param services_states: LIST of (string, boolean): service and running
+           state.
+    @param state: Boolean to match the tuple against.
+    @returns [LIST of strings] that matched the tuple RHS.
+    """
+    return [s for s, b in services_states if b == state]
+
+
+def workload_state_compare(current_workload_state, workload_state):
+    """ Return highest priority of two states"""
+    hierarchy = {'unknown': -1,
+                 'active': 0,
+                 'maintenance': 1,
+                 'waiting': 2,
+                 'blocked': 3,
+                 }
+
+    if hierarchy.get(workload_state) is None:
+        workload_state = 'unknown'
+    if hierarchy.get(current_workload_state) is None:
+        current_workload_state = 'unknown'
+
+    # Set workload_state based on hierarchy of statuses
+    if hierarchy.get(current_workload_state) > hierarchy.get(workload_state):
+        return current_workload_state
+    else:
+        return workload_state
+
+
+def incomplete_relation_data(configs, required_interfaces):
+    """Check complete contexts against required_interfaces
+    Return dictionary of incomplete relation data.
+
+    configs is an OSConfigRenderer object with configs registered
+
+    required_interfaces is a dictionary of required general interfaces
+    with dictionary values of possible specific interfaces.
+    Example:
+    required_interfaces = {'database': ['shared-db', 'pgsql-db']}
+
+    The interface is said to be satisfied if anyone of the interfaces in the
+    list has a complete context.
+
+    Return dictionary of incomplete or missing required contexts with relation
+    status of interfaces and any missing data points. Example:
+        {'message':
+             {'amqp': {'missing_data': ['rabbitmq_password'], 'related': True},
+              'zeromq-configuration': {'related': False}},
+         'identity':
+             {'identity-service': {'related': False}},
+         'database':
+             {'pgsql-db': {'related': False},
+              'shared-db': {'related': True}}}
+    """
+    complete_ctxts = configs.complete_contexts()
+    incomplete_relations = [
+        svc_type
+        for svc_type, interfaces in required_interfaces.items()
+        if not set(interfaces).intersection(complete_ctxts)]
+    return {
+        i: configs.get_incomplete_context_data(required_interfaces[i])
+        for i in incomplete_relations}
+
+
+def do_action_openstack_upgrade(package, upgrade_callback, configs):
+    """Perform action-managed OpenStack upgrade.
+
+    Upgrades packages to the configured openstack-origin version and sets
+    the corresponding action status as a result.
+
+    If the charm was installed from source we cannot upgrade it.
+    For backwards compatibility a config flag (action-managed-upgrade) must
+    be set for this code to run, otherwise a full service level upgrade will
+    fire on config-changed.
+
+    @param package: package name for determining if upgrade available
+    @param upgrade_callback: function callback to charm's upgrade function
+    @param configs: templating object derived from OSConfigRenderer class
+
+    @return: True if upgrade successful; False if upgrade failed or skipped
+    """
+    ret = False
+
+    if openstack_upgrade_available(package):
+        if config('action-managed-upgrade'):
+            juju_log('Upgrading OpenStack release')
+
+            try:
+                upgrade_callback(configs=configs)
+                action_set({'outcome': 'success, upgrade completed.'})
+                ret = True
+            except Exception:
+                action_set({'outcome': 'upgrade failed, see traceback.'})
+                action_set({'traceback': traceback.format_exc()})
+                action_fail('do_openstack_upgrade resulted in an '
+                            'unexpected error')
+        else:
+            action_set({'outcome': 'action-managed-upgrade config is '
+                                   'False, skipped upgrade.'})
+    else:
+        action_set({'outcome': 'no upgrade available.'})
+
+    return ret
+
+
+def remote_restart(rel_name, remote_service=None):
+    trigger = {
+        'restart-trigger': str(uuid.uuid4()),
+    }
+    if remote_service:
+        trigger['remote-service'] = remote_service
+    for rid in relation_ids(rel_name):
+        # This subordinate can be related to two seperate services using
+        # different subordinate relations so only issue the restart if
+        # the principle is conencted down the relation we think it is
+        if related_units(relid=rid):
+            relation_set(relation_id=rid,
+                         relation_settings=trigger,
+                         )
+
+
+def check_actually_paused(services=None, ports=None):
+    """Check that services listed in the services object and ports
+    are actually closed (not listened to), to verify that the unit is
+    properly paused.
+
+    @param services: See _extract_services_list_helper
+    @returns status, : string for status (None if okay)
+             message : string for problem for status_set
+    """
+    state = None
+    message = None
+    messages = []
+    if services is not None:
+        services = _extract_services_list_helper(services)
+        services_running, services_states = _check_running_services(services)
+        if any(services_states):
+            # there shouldn't be any running so this is a problem
+            messages.append("these services running: {}"
+                            .format(", ".join(
+                                _filter_tuples(services_running, True))))
+            state = "blocked"
+        ports_open, ports_open_bools = (
+            _check_listening_on_services_ports(services, True))
+        if any(ports_open_bools):
+            message_parts = {service: ", ".join([str(v) for v in open_ports])
+                             for service, open_ports in ports_open.items()}
+            message = ", ".join(
+                ["{}: [{}]".format(s, sp) for s, sp in message_parts.items()])
+            messages.append(
+                "these service:ports are open: {}".format(message))
+            state = 'blocked'
+    if ports is not None:
+        ports_open, bools = _check_listening_on_ports_list(ports)
+        if any(bools):
+            messages.append(
+                "these ports which should be closed, but are open: {}"
+                .format(", ".join([str(p) for p, v in ports_open if v])))
+            state = 'blocked'
+    if messages:
+        message = ("Services should be paused but {}"
+                   .format(", ".join(messages)))
+    return state, message
+
+
+def set_unit_paused():
+    """Set the unit to a paused state in the local kv() store.
+    This does NOT actually pause the unit
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', True)
+
+
+def clear_unit_paused():
+    """Clear the unit from a paused state in the local kv() store
+    This does NOT actually restart any services - it only clears the
+    local state.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-paused', False)
+
+
+def is_unit_paused_set():
+    """Return the state of the kv().get('unit-paused').
+    This does NOT verify that the unit really is paused.
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-paused')))
+    except Exception:
+        return False
+
+
+def manage_payload_services(action, services=None, charm_func=None):
+    """Run an action against all services.
+
+    An optional charm_func() can be called. It should raise an Exception to
+    indicate that the function failed. If it was succesfull it should return
+    None or an optional message.
+
+    The signature for charm_func is:
+    charm_func() -> message: str
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    :param action: Action to run: pause, resume, start or stop.
+    :type action: str
+    :param services: See above
+    :type services: See above
+    :param charm_func: function to run for custom charm pausing.
+    :type charm_func: f()
+    :returns: Status boolean and list of messages
+    :rtype: (bool, [])
+    :raises: RuntimeError
+    """
+    actions = {
+        'pause': service_pause,
+        'resume': service_resume,
+        'start': service_start,
+        'stop': service_stop}
+    action = action.lower()
+    if action not in actions.keys():
+        raise RuntimeError(
+            "action: {} must be one of: {}".format(action,
+                                                   ', '.join(actions.keys())))
+    services = _extract_services_list_helper(services)
+    messages = []
+    success = True
+    if services:
+        for service in services.keys():
+            rc = actions[action](service)
+            if not rc:
+                success = False
+                messages.append("{} didn't {} cleanly.".format(service,
+                                                               action))
+    if charm_func:
+        try:
+            message = charm_func()
+            if message:
+                messages.append(message)
+        except Exception as e:
+            success = False
+            messages.append(str(e))
+    return success, messages
+
+
+def pause_unit(assess_status_func, services=None, ports=None,
+               charm_func=None):
+    """Pause a unit by stopping the services and setting 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have stopped and ports are no longer
+    being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None, None to indicate that the unit
+    didn't pause cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are stopped, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm pausing.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'pause',
+        services=services,
+        charm_func=charm_func)
+    set_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages and not is_unit_upgrading_set():
+        raise Exception("Couldn't pause: {}".format("; ".join(messages)))
+
+
+def resume_unit(assess_status_func, services=None, ports=None,
+                charm_func=None):
+    """Resume a unit by starting the services and clearning 'unit-paused'
+    in the local kv() store.
+
+    Also checks that the services have started and ports are being listened to.
+
+    An optional charm_func() can be called that can either raise an
+    Exception or return non None to indicate that the unit
+    didn't resume cleanly.
+
+    The signature for charm_func is:
+    charm_func() -> message: string
+
+    charm_func() is executed after any services are started, if supplied.
+
+    The services object can either be:
+      - None : no services were passed (an empty dict is returned)
+      - a list of strings
+      - A dictionary (optionally OrderedDict) {service_name: {'service': ..}}
+      - An array of [{'service': service_name, ...}, ...]
+
+    @param assess_status_func: (f() -> message: string | None) or None
+    @param services: OPTIONAL see above
+    @param ports: OPTIONAL list of port
+    @param charm_func: function to run for custom charm resuming.
+    @returns None
+    @raises Exception(message) on an error for action_fail().
+    """
+    _, messages = manage_payload_services(
+        'resume',
+        services=services,
+        charm_func=charm_func)
+    clear_unit_paused()
+    if assess_status_func:
+        message = assess_status_func()
+        if message:
+            messages.append(message)
+    if messages:
+        raise Exception("Couldn't resume: {}".format("; ".join(messages)))
+
+
+def make_assess_status_func(*args, **kwargs):
+    """Creates an assess_status_func() suitable for handing to pause_unit()
+    and resume_unit().
+
+    This uses the _determine_os_workload_status(...) function to determine
+    what the workload_status should be for the unit.  If the unit is
+    not in maintenance or active states, then the message is returned to
+    the caller.  This is so an action that doesn't result in either a
+    complete pause or complete resume can signal failure with an action_fail()
+    """
+    def _assess_status_func():
+        state, message = _determine_os_workload_status(*args, **kwargs)
+        status_set(state, message)
+        if state not in ['maintenance', 'active']:
+            return message
+        return None
+
+    return _assess_status_func
+
+
+def pausable_restart_on_change(restart_map, stopstart=False,
+                               restart_functions=None):
+    """A restart_on_change decorator that checks to see if the unit is
+    paused. If it is paused then the decorated function doesn't fire.
+
+    This is provided as a helper, as the @restart_on_change(...) decorator
+    is in core.host, yet the openstack specific helpers are in this file
+    (contrib.openstack.utils).  Thus, this needs to be an optional feature
+    for openstack charms (or charms that wish to use the openstack
+    pause/resume type features).
+
+    It is used as follows:
+
+        from contrib.openstack.utils import (
+            pausable_restart_on_change as restart_on_change)
+
+        @restart_on_change(restart_map, stopstart=<boolean>)
+        def some_hook(...):
+            pass
+
+    see core.utils.restart_on_change() for more details.
+
+    Note restart_map can be a callable, in which case, restart_map is only
+    evaluated at runtime.  This means that it is lazy and the underlying
+    function won't be called if the decorated function is never called.  Note,
+    retains backwards compatibility for passing a non-callable dictionary.
+
+    @param f: the function to decorate
+    @param restart_map: (optionally callable, which then returns the
+        restart_map) the restart map {conf_file: [services]}
+    @param stopstart: DEFAULT false; whether to stop, start or just restart
+    @returns decorator to use a restart_on_change with pausability
+    """
+    def wrap(f):
+        # py27 compatible nonlocal variable.  When py3 only, replace with
+        # nonlocal keyword
+        __restart_map_cache = {'cache': None}
+
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            if is_unit_paused_set():
+                return f(*args, **kwargs)
+            if __restart_map_cache['cache'] is None:
+                __restart_map_cache['cache'] = restart_map() \
+                    if callable(restart_map) else restart_map
+            # otherwise, normal restart_on_change functionality
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), __restart_map_cache['cache'],
+                stopstart, restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def ordered(orderme):
+    """Converts the provided dictionary into a collections.OrderedDict.
+
+    The items in the returned OrderedDict will be inserted based on the
+    natural sort order of the keys. Nested dictionaries will also be sorted
+    in order to ensure fully predictable ordering.
+
+    :param orderme: the dict to order
+    :return: collections.OrderedDict
+    :raises: ValueError: if `orderme` isn't a dict instance.
+    """
+    if not isinstance(orderme, dict):
+        raise ValueError('argument must be a dict type')
+
+    result = OrderedDict()
+    for k, v in sorted(six.iteritems(orderme), key=lambda x: x[0]):
+        if isinstance(v, dict):
+            result[k] = ordered(v)
+        else:
+            result[k] = v
+
+    return result
+
+
+def config_flags_parser(config_flags):
+    """Parses config flags string into dict.
+
+    This parsing method supports a few different formats for the config
+    flag values to be parsed:
+
+      1. A string in the simple format of key=value pairs, with the possibility
+         of specifying multiple key value pairs within the same string. For
+         example, a string in the format of 'key1=value1, key2=value2' will
+         return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2'}.
+
+      2. A string in the above format, but supporting a comma-delimited list
+         of values for the same key. For example, a string in the format of
+         'key1=value1, key2=value3,value4,value5' will return a dict of:
+
+             {'key1': 'value1', 'key2': 'value2,value3,value4'}
+
+      3. A string containing a colon character (:) prior to an equal
+         character (=) will be treated as yaml and parsed as such. This can be
+         used to specify more complex key value pairs. For example,
+         a string in the format of 'key1: subkey1=value1, subkey2=value2' will
+         return a dict of:
+
+             {'key1', 'subkey1=value1, subkey2=value2'}
+
+    The provided config_flags string may be a list of comma-separated values
+    which themselves may be comma-separated list of values.
+    """
+    # If we find a colon before an equals sign then treat it as yaml.
+    # Note: limit it to finding the colon first since this indicates assignment
+    # for inline yaml.
+    colon = config_flags.find(':')
+    equals = config_flags.find('=')
+    if colon > 0:
+        if colon < equals or equals < 0:
+            return ordered(yaml.safe_load(config_flags))
+
+    if config_flags.find('==') >= 0:
+        juju_log("config_flags is not in expected format (key=value)",
+                 level=ERROR)
+        raise OSContextError
+
+    # strip the following from each value.
+    post_strippers = ' ,'
+    # we strip any leading/trailing '=' or ' ' from the string then
+    # split on '='.
+    split = config_flags.strip(' =').split('=')
+    limit = len(split)
+    flags = OrderedDict()
+    for i in range(0, limit - 1):
+        current = split[i]
+        next = split[i + 1]
+        vindex = next.rfind(',')
+        if (i == limit - 2) or (vindex < 0):
+            value = next
+        else:
+            value = next[:vindex]
+
+        if i == 0:
+            key = current
+        else:
+            # if this not the first entry, expect an embedded key.
+            index = current.rfind(',')
+            if index < 0:
+                juju_log("Invalid config value(s) at index %s" % (i),
+                         level=ERROR)
+                raise OSContextError
+            key = current[index + 1:]
+
+        # Add to collection.
+        flags[key.strip(post_strippers)] = value.rstrip(post_strippers)
+
+    return flags
+
+
+def os_application_version_set(package):
+    '''Set version of application for Juju 2.0 and later'''
+    application_version = get_upstream_version(package)
+    # NOTE(jamespage) if not able to figure out package version, fallback to
+    #                 openstack codename version detection.
+    if not application_version:
+        application_version_set(os_release(package))
+    else:
+        application_version_set(application_version)
+
+
+def os_application_status_set(check_function):
+    """Run the supplied function and set the application status accordingly.
+
+    :param check_function: Function to run to get app states and messages.
+    :type check_function: function
+    """
+    state, message = check_function()
+    status_set(state, message, application=True)
+
+
+def enable_memcache(source=None, release=None, package=None):
+    """Determine if memcache should be enabled on the local unit
+
+    @param release: release of OpenStack currently deployed
+    @param package: package to derive OpenStack version deployed
+    @returns boolean Whether memcache should be enabled
+    """
+    _release = None
+    if release:
+        _release = release
+    else:
+        _release = os_release(package)
+    if not _release:
+        _release = get_os_codename_install_source(source)
+
+    return CompareOpenStackReleases(_release) >= 'mitaka'
+
+
+def token_cache_pkgs(source=None, release=None):
+    """Determine additional packages needed for token caching
+
+    @param source: source string for charm
+    @param release: release of OpenStack currently deployed
+    @returns List of package to enable token caching
+    """
+    packages = []
+    if enable_memcache(source=source, release=release):
+        packages.extend(['memcached', 'python-memcache'])
+    return packages
+
+
+def update_json_file(filename, items):
+    """Updates the json `filename` with a given dict.
+    :param filename: path to json file (e.g. /etc/glance/policy.json)
+    :param items: dict of items to update
+    """
+    if not items:
+        return
+
+    with open(filename) as fd:
+        policy = json.load(fd)
+
+    # Compare before and after and if nothing has changed don't write the file
+    # since that could cause unnecessary service restarts.
+    before = json.dumps(policy, indent=4, sort_keys=True)
+    policy.update(items)
+    after = json.dumps(policy, indent=4, sort_keys=True)
+    if before == after:
+        return
+
+    with open(filename, "w") as fd:
+        fd.write(after)
+
+
+@cached
+def snap_install_requested():
+    """ Determine if installing from snaps
+
+    If openstack-origin is of the form snap:track/channel[/branch]
+    and channel is in SNAPS_CHANNELS return True.
+    """
+    origin = config('openstack-origin') or ""
+    if not origin.startswith('snap:'):
+        return False
+
+    _src = origin[5:]
+    if '/' in _src:
+        channel = _src.split('/')[1]
+    else:
+        # Handle snap:track with no channel
+        channel = 'stable'
+    return valid_snap_channel(channel)
+
+
+def get_snaps_install_info_from_origin(snaps, src, mode='classic'):
+    """Generate a dictionary of snap install information from origin
+
+    @param snaps: List of snaps
+    @param src: String of openstack-origin or source of the form
+        snap:track/channel
+    @param mode: String classic, devmode or jailmode
+    @returns: Dictionary of snaps with channels and modes
+    """
+
+    if not src.startswith('snap:'):
+        juju_log("Snap source is not a snap origin", 'WARN')
+        return {}
+
+    _src = src[5:]
+    channel = '--channel={}'.format(_src)
+
+    return {snap: {'channel': channel, 'mode': mode}
+            for snap in snaps}
+
+
+def install_os_snaps(snaps, refresh=False):
+    """Install OpenStack snaps from channel and with mode
+
+    @param snaps: Dictionary of snaps with channels and modes of the form:
+        {'snap_name': {'channel': 'snap_channel',
+                       'mode': 'snap_mode'}}
+        Where channel is a snapstore channel and mode is --classic, --devmode
+        or --jailmode.
+    @param post_snap_install: Callback function to run after snaps have been
+    installed
+    """
+
+    def _ensure_flag(flag):
+        if flag.startswith('--'):
+            return flag
+        return '--{}'.format(flag)
+
+    if refresh:
+        for snap in snaps.keys():
+            snap_refresh(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+    else:
+        for snap in snaps.keys():
+            snap_install(snap,
+                         _ensure_flag(snaps[snap]['channel']),
+                         _ensure_flag(snaps[snap]['mode']))
+
+
+def set_unit_upgrading():
+    """Set the unit to a upgrading state in the local kv() store.
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', True)
+
+
+def clear_unit_upgrading():
+    """Clear the unit from a upgrading state in the local kv() store
+    """
+    with unitdata.HookData()() as t:
+        kv = t[0]
+        kv.set('unit-upgrading', False)
+
+
+def is_unit_upgrading_set():
+    """Return the state of the kv().get('unit-upgrading').
+
+    To help with units that don't have HookData() (testing)
+    if it excepts, return False
+    """
+    try:
+        with unitdata.HookData()() as t:
+            kv = t[0]
+            # transform something truth-y into a Boolean.
+            return not(not(kv.get('unit-upgrading')))
+    except Exception:
+        return False
+
+
+def series_upgrade_prepare(pause_unit_helper=None, configs=None):
+    """ Run common series upgrade prepare tasks.
+
+    :param pause_unit_helper: function: Function to pause unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    set_unit_upgrading()
+    if pause_unit_helper and configs:
+        if not is_unit_paused_set():
+            pause_unit_helper(configs)
+
+
+def series_upgrade_complete(resume_unit_helper=None, configs=None):
+    """ Run common series upgrade complete tasks.
+
+    :param resume_unit_helper: function: Function to resume unit
+    :param configs: OSConfigRenderer object: Configurations
+    :returns None:
+    """
+    clear_unit_paused()
+    clear_unit_upgrading()
+    if configs:
+        configs.write_all()
+        if resume_unit_helper:
+            resume_unit_helper(configs)
+
+
+def is_db_initialised():
+    """Check leader storage to see if database has been initialised.
+
+    :returns: Whether DB has been initialised
+    :rtype: bool
+    """
+    db_initialised = None
+    if leader_get('db-initialised') is None:
+        juju_log(
+            'db-initialised key missing, assuming db is not initialised',
+            'DEBUG')
+        db_initialised = False
+    else:
+        db_initialised = bool_from_string(leader_get('db-initialised'))
+    juju_log('Database initialised: {}'.format(db_initialised), 'DEBUG')
+    return db_initialised
+
+
+def set_db_initialised():
+    """Add flag to leader storage to indicate database has been initialised.
+    """
+    juju_log('Setting db-initialised to True', 'DEBUG')
+    leader_set({'db-initialised': True})
+
+
+def is_db_maintenance_mode(relid=None):
+    """Check relation data from notifications of db in maintenance mode.
+
+    :returns: Whether db has notified it is in maintenance mode.
+    :rtype: bool
+    """
+    juju_log('Checking for maintenance notifications', 'DEBUG')
+    if relid:
+        r_ids = [relid]
+    else:
+        r_ids = relation_ids('shared-db')
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    notifications = []
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        for key, value in settings.items():
+            if value and key in DB_MAINTENANCE_KEYS:
+                juju_log(
+                    'Unit: {}, Key: {}, Value: {}'.format(unit, key, value),
+                    'DEBUG')
+                try:
+                    notifications.append(bool_from_string(value))
+                except ValueError:
+                    juju_log(
+                        'Could not discern bool from {}'.format(value),
+                        'WARN')
+                    pass
+    return True in notifications
+
+
+@cached
+def container_scoped_relations():
+    """Get all the container scoped relations
+
+    :returns: List of relation names
+    :rtype: List
+    """
+    md = metadata()
+    relations = []
+    for relation_type in ('provides', 'requires', 'peers'):
+        for relation in md.get(relation_type, []):
+            if md[relation_type][relation].get('scope') == 'container':
+                relations.append(relation)
+    return relations
+
+
+def is_db_ready(use_current_context=False, rel_name=None):
+    """Check remote database is ready to be used.
+
+    Database relations are expected to provide a list of 'allowed' units to
+    confirm that the database is ready for use by those units.
+
+    If db relation has provided this information and local unit is a member,
+    returns True otherwise False.
+
+    :param use_current_context: Whether to limit checks to current hook
+                                context.
+    :type use_current_context: bool
+    :param rel_name: Name of relation to check
+    :type rel_name: string
+    :returns: Whether remote db is ready.
+    :rtype: bool
+    :raises: Exception
+    """
+    key = 'allowed_units'
+
+    rel_name = rel_name or 'shared-db'
+    this_unit = local_unit()
+
+    if use_current_context:
+        if relation_id() in relation_ids(rel_name):
+            rids_units = [(None, None)]
+        else:
+            raise Exception("use_current_context=True but not in {} "
+                            "rel hook contexts (currently in {})."
+                            .format(rel_name, relation_id()))
+    else:
+        rids_units = [(r_id, u)
+                      for r_id in relation_ids(rel_name)
+                      for u in related_units(r_id)]
+
+    for rid, unit in rids_units:
+        allowed_units = relation_get(rid=rid, unit=unit, attribute=key)
+        if allowed_units and this_unit in allowed_units.split():
+            juju_log("This unit ({}) is in allowed unit list from {}".format(
+                this_unit,
+                unit), 'DEBUG')
+            return True
+
+    juju_log("This unit was not found in any allowed unit list")
+    return False
+
+
+def is_expected_scale(peer_relation_name='cluster'):
+    """Query juju goal-state to determine whether our peer- and dependency-
+    relations are at the expected scale.
+
+    Useful for deferring per unit per relation housekeeping work until we are
+    ready to complete it successfully and without unnecessary repetiton.
+
+    Always returns True if version of juju used does not support goal-state.
+
+    :param peer_relation_name: Name of peer relation
+    :type rel_name: string
+    :returns: True or False
+    :rtype: bool
+    """
+    def _get_relation_id(rel_type):
+        return next((rid for rid in relation_ids(reltype=rel_type)), None)
+
+    Relation = namedtuple('Relation', 'rel_type rel_id')
+    peer_rid = _get_relation_id(peer_relation_name)
+    # Units with no peers should still have a peer relation.
+    if not peer_rid:
+        juju_log('Not at expected scale, no peer relation found', 'DEBUG')
+        return False
+    expected_relations = [
+        Relation(rel_type='shared-db', rel_id=_get_relation_id('shared-db'))]
+    if expect_ha():
+        expected_relations.append(
+            Relation(
+                rel_type='ha',
+                rel_id=_get_relation_id('ha')))
+    juju_log(
+        'Checking scale of {} relations'.format(
+            ','.join([r.rel_type for r in expected_relations])),
+        'DEBUG')
+    try:
+        if (len(related_units(relid=peer_rid)) <
+                len(list(expected_peer_units()))):
+            return False
+        for rel in expected_relations:
+            if not rel.rel_id:
+                juju_log(
+                    'Expected to find {} relation, but it is missing'.format(
+                        rel.rel_type),
+                    'DEBUG')
+                return False
+            # Goal state returns every unit even for container scoped
+            # relations but the charm only ever has a relation with
+            # the local unit.
+            if rel.rel_type in container_scoped_relations():
+                expected_count = 1
+            else:
+                expected_count = len(
+                    list(expected_related_units(reltype=rel.rel_type)))
+            if len(related_units(relid=rel.rel_id)) < expected_count:
+                juju_log(
+                    ('Not at expected scale, not enough units on {} '
+                     'relation'.format(rel.rel_type)),
+                    'DEBUG')
+                return False
+    except NotImplementedError:
+        return True
+    juju_log('All checks have passed, unit is at expected scale', 'DEBUG')
+    return True
+
+
+def get_peer_key(unit_name):
+    """Get the peer key for this unit.
+
+    The peer key is the key a unit uses to publish its status down the peer
+    relation
+
+    :param unit_name: Name of unit
+    :type unit_name: string
+    :returns: Peer key for given unit
+    :rtype: string
+    """
+    return 'unit-state-{}'.format(unit_name.replace('/', '-'))
+
+
+UNIT_READY = 'READY'
+UNIT_NOTREADY = 'NOTREADY'
+UNIT_UNKNOWN = 'UNKNOWN'
+UNIT_STATES = [UNIT_READY, UNIT_NOTREADY, UNIT_UNKNOWN]
+
+
+def inform_peers_unit_state(state, relation_name='cluster'):
+    """Inform peers of the state of this unit.
+
+    :param state: State of unit to publish
+    :type state: string
+    :param relation_name: Name of relation to publish state on
+    :type relation_name: string
+    """
+    if state not in UNIT_STATES:
+        raise ValueError(
+            "Setting invalid state {} for unit".format(state))
+    for r_id in relation_ids(relation_name):
+        relation_set(relation_id=r_id,
+                     relation_settings={
+                         get_peer_key(local_unit()): state})
+
+
+def get_peers_unit_state(relation_name='cluster'):
+    """Get the state of all peers.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Unit states keyed on unit name.
+    :rtype: dict
+    :raises: ValueError
+    """
+    r_ids = relation_ids(relation_name)
+    rids_units = [(r, u) for r in r_ids for u in related_units(r)]
+    unit_states = {}
+    for r_id, unit in rids_units:
+        settings = relation_get(unit=unit, rid=r_id)
+        unit_states[unit] = settings.get(get_peer_key(unit), UNIT_UNKNOWN)
+        if unit_states[unit] not in UNIT_STATES:
+            raise ValueError(
+                "Unit in unknown state {}".format(unit_states[unit]))
+    return unit_states
+
+
+def are_peers_ready(relation_name='cluster'):
+    """Check if all peers are ready.
+
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    :returns: Whether all units are ready.
+    :rtype: bool
+    """
+    unit_states = get_peers_unit_state(relation_name)
+    return all(v == UNIT_READY for v in unit_states.values())
+
+
+def inform_peers_if_ready(check_unit_ready_func, relation_name='cluster'):
+    """Inform peers if this unit is ready.
+
+    The check function should return a tuple (state, message). A state
+    of 'READY' indicates the unit is READY.
+
+    :param check_unit_ready_func: Function to run to check readiness
+    :type check_unit_ready_func: function
+    :param relation_name: Name of relation to check peers on.
+    :type relation_name: string
+    """
+    unit_ready, msg = check_unit_ready_func()
+    if unit_ready:
+        state = UNIT_READY
+    else:
+        state = UNIT_NOTREADY
+    juju_log('Telling peers this unit is: {}'.format(state), 'DEBUG')
+    inform_peers_unit_state(state, relation_name)
+
+
+def check_api_unit_ready(check_db_ready=True):
+    """Check if this unit is ready.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Whether unit state is ready and status message
+    :rtype: (bool, str)
+    """
+    unit_state, msg = get_api_unit_status(check_db_ready=check_db_ready)
+    return unit_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_unit_status(check_db_ready=True):
+    """Return a workload status and message for this unit.
+
+    :param check_db_ready: Include checks of database readiness.
+    :type check_db_ready: bool
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    unit_state = WORKLOAD_STATES.ACTIVE
+    msg = 'Unit is ready'
+    if is_db_maintenance_mode():
+        unit_state = WORKLOAD_STATES.MAINTENANCE
+        msg = 'Database in maintenance mode.'
+    elif is_unit_paused_set():
+        unit_state = WORKLOAD_STATES.BLOCKED
+        msg = 'Unit paused.'
+    elif check_db_ready and not is_db_ready():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Allowed_units list provided but this unit not present'
+    elif not is_db_initialised():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Database not initialised'
+    elif not is_expected_scale():
+        unit_state = WORKLOAD_STATES.WAITING
+        msg = 'Charm and its dependencies not yet at expected scale'
+    juju_log(msg, 'DEBUG')
+    return unit_state, msg
+
+
+def check_api_application_ready():
+    """Check if this application is ready.
+
+    :returns: Whether application state is ready and status message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_application_status()
+    return app_state == WORKLOAD_STATES.ACTIVE, msg
+
+
+def get_api_application_status():
+    """Return a workload status and message for this application.
+
+    :returns: Workload state and message
+    :rtype: (bool, str)
+    """
+    app_state, msg = get_api_unit_status()
+    if app_state == WORKLOAD_STATES.ACTIVE:
+        if are_peers_ready():
+            return WORKLOAD_STATES.ACTIVE, 'Application Ready'
+        else:
+            return WORKLOAD_STATES.WAITING, 'Some units are not ready'
+    return app_state, msg
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/vaultlocker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/vaultlocker.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ee6c1dba910b824467c2c34e0a3d3d0f3fd906d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/openstack/vaultlocker.py
@@ -0,0 +1,179 @@
+# Copyright 2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import os
+
+import charmhelpers.contrib.openstack.alternatives as alternatives
+import charmhelpers.contrib.openstack.context as context
+
+import charmhelpers.core.hookenv as hookenv
+import charmhelpers.core.host as host
+import charmhelpers.core.templating as templating
+import charmhelpers.core.unitdata as unitdata
+
+VAULTLOCKER_BACKEND = 'charm-vaultlocker'
+
+
+class VaultKVContext(context.OSContextGenerator):
+    """Vault KV context for interaction with vault-kv interfaces"""
+    interfaces = ['secrets-storage']
+
+    def __init__(self, secret_backend=None):
+        super(context.OSContextGenerator, self).__init__()
+        self.secret_backend = (
+            secret_backend or 'charm-{}'.format(hookenv.service_name())
+        )
+
+    def __call__(self):
+        try:
+            import hvac
+        except ImportError:
+            # BUG: #1862085 - if the relation is made to vault, but the
+            # 'encrypt' option is not made, then the charm errors with an
+            # import warning.  This catches that, logs a warning, and returns
+            # with an empty context.
+            hookenv.log("VaultKVContext: trying to use hvac pythong module "
+                        "but it's not available.  Is secrets-stroage relation "
+                        "made, but encrypt option not set?",
+                        level=hookenv.WARNING)
+            # return an emptry context on hvac import error
+            return {}
+        ctxt = {}
+        # NOTE(hopem): see https://bugs.launchpad.net/charm-helpers/+bug/1849323
+        db = unitdata.kv()
+        # currently known-good secret-id
+        secret_id = db.get('secret-id')
+
+        for relation_id in hookenv.relation_ids(self.interfaces[0]):
+            for unit in hookenv.related_units(relation_id):
+                data = hookenv.relation_get(unit=unit,
+                                            rid=relation_id)
+                vault_url = data.get('vault_url')
+                role_id = data.get('{}_role_id'.format(hookenv.local_unit()))
+                token = data.get('{}_token'.format(hookenv.local_unit()))
+
+                if all([vault_url, role_id, token]):
+                    token = json.loads(token)
+                    vault_url = json.loads(vault_url)
+
+                    # Tokens may change when secret_id's are being
+                    # reissued - if so use token to get new secret_id
+                    token_success = False
+                    try:
+                        secret_id = retrieve_secret_id(
+                            url=vault_url,
+                            token=token
+                        )
+                        token_success = True
+                    except hvac.exceptions.InvalidRequest:
+                        # Try next
+                        pass
+
+                    if token_success:
+                        db.set('secret-id', secret_id)
+                        db.flush()
+
+                        ctxt['vault_url'] = vault_url
+                        ctxt['role_id'] = json.loads(role_id)
+                        ctxt['secret_id'] = secret_id
+                        ctxt['secret_backend'] = self.secret_backend
+                        vault_ca = data.get('vault_ca')
+                        if vault_ca:
+                            ctxt['vault_ca'] = json.loads(vault_ca)
+
+                        self.complete = True
+                        break
+                    else:
+                        if secret_id:
+                            ctxt['vault_url'] = vault_url
+                            ctxt['role_id'] = json.loads(role_id)
+                            ctxt['secret_id'] = secret_id
+                            ctxt['secret_backend'] = self.secret_backend
+                            vault_ca = data.get('vault_ca')
+                            if vault_ca:
+                                ctxt['vault_ca'] = json.loads(vault_ca)
+
+            if self.complete:
+                break
+
+        if ctxt:
+            self.complete = True
+
+        return ctxt
+
+
+def write_vaultlocker_conf(context, priority=100):
+    """Write vaultlocker configuration to disk and install alternative
+
+    :param context: Dict of data from vault-kv relation
+    :ptype: context: dict
+    :param priority: Priority of alternative configuration
+    :ptype: priority: int"""
+    charm_vl_path = "/var/lib/charm/{}/vaultlocker.conf".format(
+        hookenv.service_name()
+    )
+    host.mkdir(os.path.dirname(charm_vl_path), perms=0o700)
+    templating.render(source='vaultlocker.conf.j2',
+                      target=charm_vl_path,
+                      context=context, perms=0o600),
+    alternatives.install_alternative('vaultlocker.conf',
+                                     '/etc/vaultlocker/vaultlocker.conf',
+                                     charm_vl_path, priority)
+
+
+def vault_relation_complete(backend=None):
+    """Determine whether vault relation is complete
+
+    :param backend: Name of secrets backend requested
+    :ptype backend: string
+    :returns: whether the relation to vault is complete
+    :rtype: bool"""
+    try:
+        import hvac
+    except ImportError:
+        return False
+    try:
+        vault_kv = VaultKVContext(secret_backend=backend or VAULTLOCKER_BACKEND)
+        vault_kv()
+        return vault_kv.complete
+    except hvac.exceptions.InvalidRequest:
+        return False
+
+
+# TODO: contrib a high level unwrap method to hvac that works
+def retrieve_secret_id(url, token):
+    """Retrieve a response-wrapped secret_id from Vault
+
+    :param url: URL to Vault Server
+    :ptype url: str
+    :param token: One shot Token to use
+    :ptype token: str
+    :returns: secret_id to use for Vault Access
+    :rtype: str"""
+    import hvac
+    try:
+        # hvac 0.10.1 changed default adapter to JSONAdapter
+        client = hvac.Client(url=url, token=token, adapter=hvac.adapters.Request)
+    except AttributeError:
+        # hvac < 0.6.2 doesn't have adapter but uses the same response interface
+        client = hvac.Client(url=url, token=token)
+    else:
+        # hvac < 0.9.2 assumes adapter is an instance, so doesn't instantiate
+        if not isinstance(client.adapter, hvac.adapters.Request):
+            client.adapter = hvac.adapters.Request(base_uri=url, token=token)
+    response = client._post('/v1/sys/wrapping/unwrap')
+    if response.status_code == 200:
+        data = response.json()
+        return data['data']['secret_id']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/peerstorage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/peerstorage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8fa60c2a3080d088b8e0abae370aa355c80ec56
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/peerstorage/__init__.py
@@ -0,0 +1,267 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import six
+
+from charmhelpers.core.hookenv import relation_id as current_relation_id
+from charmhelpers.core.hookenv import (
+    is_relation_made,
+    relation_ids,
+    relation_get as _relation_get,
+    local_unit,
+    relation_set as _relation_set,
+    leader_get as _leader_get,
+    leader_set,
+    is_leader,
+)
+
+
+"""
+This helper provides functions to support use of a peer relation
+for basic key/value storage, with the added benefit that all storage
+can be replicated across peer units.
+
+Requirement to use:
+
+To use this, the "peer_echo()" method has to be called form the peer
+relation's relation-changed hook:
+
+@hooks.hook("cluster-relation-changed") # Adapt the to your peer relation name
+def cluster_relation_changed():
+    peer_echo()
+
+Once this is done, you can use peer storage from anywhere:
+
+@hooks.hook("some-hook")
+def some_hook():
+    # You can store and retrieve key/values this way:
+    if is_relation_made("cluster"):  # from charmhelpers.core.hookenv
+        # There are peers available so we can work with peer storage
+        peer_store("mykey", "myvalue")
+        value = peer_retrieve("mykey")
+        print value
+    else:
+        print "No peers joind the relation, cannot share key/values :("
+"""
+
+
+def leader_get(attribute=None, rid=None):
+    """Wrapper to ensure that settings are migrated from the peer relation.
+
+    This is to support upgrading an environment that does not support
+    Juju leadership election to one that does.
+
+    If a setting is not extant in the leader-get but is on the relation-get
+    peer rel, it is migrated and marked as such so that it is not re-migrated.
+    """
+    migration_key = '__leader_get_migrated_settings__'
+    if not is_leader():
+        return _leader_get(attribute=attribute)
+
+    settings_migrated = False
+    leader_settings = _leader_get(attribute=attribute)
+    previously_migrated = _leader_get(attribute=migration_key)
+
+    if previously_migrated:
+        migrated = set(json.loads(previously_migrated))
+    else:
+        migrated = set([])
+
+    try:
+        if migration_key in leader_settings:
+            del leader_settings[migration_key]
+    except TypeError:
+        pass
+
+    if attribute:
+        if attribute in migrated:
+            return leader_settings
+
+        # If attribute not present in leader db, check if this unit has set
+        # the attribute in the peer relation
+        if not leader_settings:
+            peer_setting = _relation_get(attribute=attribute, unit=local_unit(),
+                                         rid=rid)
+            if peer_setting:
+                leader_set(settings={attribute: peer_setting})
+                leader_settings = peer_setting
+
+        if leader_settings:
+            settings_migrated = True
+            migrated.add(attribute)
+    else:
+        r_settings = _relation_get(unit=local_unit(), rid=rid)
+        if r_settings:
+            for key in set(r_settings.keys()).difference(migrated):
+                # Leader setting wins
+                if not leader_settings.get(key):
+                    leader_settings[key] = r_settings[key]
+
+                settings_migrated = True
+                migrated.add(key)
+
+            if settings_migrated:
+                leader_set(**leader_settings)
+
+    if migrated and settings_migrated:
+        migrated = json.dumps(list(migrated))
+        leader_set(settings={migration_key: migrated})
+
+    return leader_settings
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Attempt to use leader-set if supported in the current version of Juju,
+    otherwise falls back on relation-set.
+
+    Note that we only attempt to use leader-set if the provided relation_id is
+    a peer relation id or no relation id is provided (in which case we assume
+    we are within the peer relation context).
+    """
+    try:
+        if relation_id in relation_ids('cluster'):
+            return leader_set(settings=relation_settings, **kwargs)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_set(relation_id=relation_id,
+                             relation_settings=relation_settings, **kwargs)
+
+
+def relation_get(attribute=None, unit=None, rid=None):
+    """Attempt to use leader-get if supported in the current version of Juju,
+    otherwise falls back on relation-get.
+
+    Note that we only attempt to use leader-get if the provided rid is a peer
+    relation id or no relation id is provided (in which case we assume we are
+    within the peer relation context).
+    """
+    try:
+        if rid in relation_ids('cluster'):
+            return leader_get(attribute, rid)
+        else:
+            raise NotImplementedError
+    except NotImplementedError:
+        return _relation_get(attribute=attribute, rid=rid, unit=unit)
+
+
+def peer_retrieve(key, relation_name='cluster'):
+    """Retrieve a named key from peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        return relation_get(attribute=key, rid=cluster_rid,
+                            unit=local_unit())
+    else:
+        raise ValueError('Unable to detect'
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_retrieve_by_prefix(prefix, relation_name='cluster', delimiter='_',
+                            inc_list=None, exc_list=None):
+    """ Retrieve k/v pairs given a prefix and filter using {inc,exc}_list """
+    inc_list = inc_list if inc_list else []
+    exc_list = exc_list if exc_list else []
+    peerdb_settings = peer_retrieve('-', relation_name=relation_name)
+    matched = {}
+    if peerdb_settings is None:
+        return matched
+    for k, v in peerdb_settings.items():
+        full_prefix = prefix + delimiter
+        if k.startswith(full_prefix):
+            new_key = k.replace(full_prefix, '')
+            if new_key in exc_list:
+                continue
+            if new_key in inc_list or len(inc_list) == 0:
+                matched[new_key] = v
+    return matched
+
+
+def peer_store(key, value, relation_name='cluster'):
+    """Store the key/value pair on the named peer relation `relation_name`."""
+    cluster_rels = relation_ids(relation_name)
+    if len(cluster_rels) > 0:
+        cluster_rid = cluster_rels[0]
+        relation_set(relation_id=cluster_rid,
+                     relation_settings={key: value})
+    else:
+        raise ValueError('Unable to detect '
+                         'peer relation {}'.format(relation_name))
+
+
+def peer_echo(includes=None, force=False):
+    """Echo filtered attributes back onto the same relation for storage.
+
+    This is a requirement to use the peerstorage module - it needs to be called
+    from the peer relation's changed hook.
+
+    If Juju leader support exists this will be a noop unless force is True.
+    """
+    try:
+        is_leader()
+    except NotImplementedError:
+        pass
+    else:
+        if not force:
+            return  # NOOP if leader-election is supported
+
+    # Use original non-leader calls
+    relation_get = _relation_get
+    relation_set = _relation_set
+
+    rdata = relation_get()
+    echo_data = {}
+    if includes is None:
+        echo_data = rdata.copy()
+        for ex in ['private-address', 'public-address']:
+            if ex in echo_data:
+                echo_data.pop(ex)
+    else:
+        for attribute, value in six.iteritems(rdata):
+            for include in includes:
+                if include in attribute:
+                    echo_data[attribute] = value
+    if len(echo_data) > 0:
+        relation_set(relation_settings=echo_data)
+
+
+def peer_store_and_set(relation_id=None, peer_relation_name='cluster',
+                       peer_store_fatal=False, relation_settings=None,
+                       delimiter='_', **kwargs):
+    """Store passed-in arguments both in argument relation and in peer storage.
+
+    It functions like doing relation_set() and peer_store() at the same time,
+    with the same data.
+
+    @param relation_id: the id of the relation to store the data on. Defaults
+                        to the current relation.
+    @param peer_store_fatal: Set to True, the function will raise an exception
+                             should the peer storage not be available."""
+
+    relation_settings = relation_settings if relation_settings else {}
+    relation_set(relation_id=relation_id,
+                 relation_settings=relation_settings,
+                 **kwargs)
+    if is_relation_made(peer_relation_name):
+        for key, value in six.iteritems(dict(list(kwargs.items()) +
+                                             list(relation_settings.items()))):
+            key_prefix = relation_id or current_relation_id()
+            peer_store(key_prefix + delimiter + key,
+                       value,
+                       relation_name=peer_relation_name)
+    else:
+        if peer_store_fatal:
+            raise ValueError('Unable to detect '
+                             'peer relation {}'.format(peer_relation_name))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/python.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/python.py
new file mode 100644
index 0000000000000000000000000000000000000000..84cba8c4eba34fdd705f4ee39628ebd33b5175a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/python.py
@@ -0,0 +1,21 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+# deprecated aliases for backwards compatibility
+from charmhelpers.fetch.python import debug  # noqa
+from charmhelpers.fetch.python import packages  # noqa
+from charmhelpers.fetch.python import rpdb  # noqa
+from charmhelpers.fetch.python import version  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/saltstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/saltstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d74f4039379b608b5c076fd96c906ff5237f1f83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/saltstack/__init__.py
@@ -0,0 +1,116 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Charm Helpers saltstack - declare the state of your machines.
+
+This helper enables you to declare your machine state, rather than
+program it procedurally (and have to test each change to your procedures).
+Your install hook can be as simple as::
+
+    {{{
+    from charmhelpers.contrib.saltstack import (
+        install_salt_support,
+        update_machine_state,
+    )
+
+
+    def install():
+        install_salt_support()
+        update_machine_state('machine_states/dependencies.yaml')
+        update_machine_state('machine_states/installed.yaml')
+    }}}
+
+and won't need to change (nor will its tests) when you change the machine
+state.
+
+It's using a python package called salt-minion which allows various formats for
+specifying resources, such as::
+
+    {{{
+    /srv/{{ basedir }}:
+        file.directory:
+            - group: ubunet
+            - user: ubunet
+            - require:
+                - user: ubunet
+            - recurse:
+                - user
+                - group
+
+    ubunet:
+        group.present:
+            - gid: 1500
+        user.present:
+            - uid: 1500
+            - gid: 1500
+            - createhome: False
+            - require:
+                - group: ubunet
+    }}}
+
+The docs for all the different state definitions are at:
+    http://docs.saltstack.com/ref/states/all/
+
+
+TODO:
+  * Add test helpers which will ensure that machine state definitions
+    are functionally (but not necessarily logically) correct (ie. getting
+    salt to parse all state defs.
+  * Add a link to a public bootstrap charm example / blogpost.
+  * Find a way to obviate the need to use the grains['charm_dir'] syntax
+    in templates.
+"""
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import subprocess
+
+import charmhelpers.contrib.templating.contexts
+import charmhelpers.core.host
+import charmhelpers.core.hookenv
+
+
+salt_grains_path = '/etc/salt/grains'
+
+
+def install_salt_support(from_ppa=True):
+    """Installs the salt-minion helper for machine state.
+
+    By default the salt-minion package is installed from
+    the saltstack PPA. If from_ppa is False you must ensure
+    that the salt-minion package is available in the apt cache.
+    """
+    if from_ppa:
+        subprocess.check_call([
+            '/usr/bin/add-apt-repository',
+            '--yes',
+            'ppa:saltstack/salt',
+        ])
+        subprocess.check_call(['/usr/bin/apt-get', 'update'])
+    # We install salt-common as salt-minion would run the salt-minion
+    # daemon.
+    charmhelpers.fetch.apt_install('salt-common')
+
+
+def update_machine_state(state_path):
+    """Update the machine state using the provided state declaration."""
+    charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+        salt_grains_path)
+    subprocess.check_call([
+        'salt-call',
+        '--local',
+        'state.template',
+        state_path,
+    ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d238b529e44ad2761d86e96b4845589f8e951c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/__init__.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def generate_selfsigned(keyfile, certfile, keysize="1024", config=None, subject=None, cn=None):
+    """Generate selfsigned SSL keypair
+
+    You must provide one of the 3 optional arguments:
+    config, subject or cn
+    If more than one is provided the leftmost will be used
+
+    Arguments:
+    keyfile -- (required) full path to the keyfile to be created
+    certfile -- (required) full path to the certfile to be created
+    keysize -- (optional) SSL key length
+    config -- (optional) openssl configuration file
+    subject -- (optional) dictionary with SSL subject variables
+    cn -- (optional) cerfificate common name
+
+    Required keys in subject dict:
+    cn -- Common name (eq. FQDN)
+
+    Optional keys in subject dict
+    country -- Country Name (2 letter code)
+    state -- State or Province Name (full name)
+    locality -- Locality Name (eg, city)
+    organization -- Organization Name (eg, company)
+    organizational_unit -- Organizational Unit Name (eg, section)
+    email -- Email Address
+    """
+
+    cmd = []
+    if config:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-config", config]
+    elif subject:
+        ssl_subject = ""
+        if "country" in subject:
+            ssl_subject = ssl_subject + "/C={}".format(subject["country"])
+        if "state" in subject:
+            ssl_subject = ssl_subject + "/ST={}".format(subject["state"])
+        if "locality" in subject:
+            ssl_subject = ssl_subject + "/L={}".format(subject["locality"])
+        if "organization" in subject:
+            ssl_subject = ssl_subject + "/O={}".format(subject["organization"])
+        if "organizational_unit" in subject:
+            ssl_subject = ssl_subject + "/OU={}".format(subject["organizational_unit"])
+        if "cn" in subject:
+            ssl_subject = ssl_subject + "/CN={}".format(subject["cn"])
+        else:
+            hookenv.log("When using \"subject\" argument you must "
+                        "provide \"cn\" field at very least")
+            return False
+        if "email" in subject:
+            ssl_subject = ssl_subject + "/emailAddress={}".format(subject["email"])
+
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", ssl_subject]
+    elif cn:
+        cmd = ["/usr/bin/openssl", "req", "-new", "-newkey",
+               "rsa:{}".format(keysize), "-days", "365", "-nodes", "-x509",
+               "-keyout", keyfile,
+               "-out", certfile, "-subj", "/CN={}".format(cn)]
+
+    if not cmd:
+        hookenv.log("No config, subject or cn provided,"
+                    "unable to generate self signed SSL certificates")
+        return False
+    try:
+        subprocess.check_call(cmd)
+        return True
+    except Exception as e:
+        print("Execution of openssl command failed:\n{}".format(e))
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/service.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..06b534ffa3b0de97a56bac4060c39a9a4485b0c2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/ssl/service.py
@@ -0,0 +1,277 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from os.path import join as path_join
+from os.path import exists
+import subprocess
+
+from charmhelpers.core.hookenv import log, DEBUG
+
+STD_CERT = "standard"
+
+# Mysql server is fairly picky about cert creation
+# and types, spec its creation separately for now.
+MYSQL_CERT = "mysql"
+
+
+class ServiceCA(object):
+
+    default_expiry = str(365 * 2)
+    default_ca_expiry = str(365 * 6)
+
+    def __init__(self, name, ca_dir, cert_type=STD_CERT):
+        self.name = name
+        self.ca_dir = ca_dir
+        self.cert_type = cert_type
+
+    ###############
+    # Hook Helper API
+    @staticmethod
+    def get_ca(type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca_path = os.path.join(os.environ['CHARM_DIR'], 'ca')
+        ca = ServiceCA(service_name, ca_path, type)
+        ca.init()
+        return ca
+
+    @classmethod
+    def get_service_cert(cls, type=STD_CERT):
+        service_name = os.environ['JUJU_UNIT_NAME'].split('/')[0]
+        ca = cls.get_ca()
+        crt, key = ca.get_or_create_cert(service_name)
+        return crt, key, ca.get_ca_bundle()
+
+    ###############
+
+    def init(self):
+        log("initializing service ca", level=DEBUG)
+        if not exists(self.ca_dir):
+            self._init_ca_dir(self.ca_dir)
+            self._init_ca()
+
+    @property
+    def ca_key(self):
+        return path_join(self.ca_dir, 'private', 'cacert.key')
+
+    @property
+    def ca_cert(self):
+        return path_join(self.ca_dir, 'cacert.pem')
+
+    @property
+    def ca_conf(self):
+        return path_join(self.ca_dir, 'ca.cnf')
+
+    @property
+    def signing_conf(self):
+        return path_join(self.ca_dir, 'signing.cnf')
+
+    def _init_ca_dir(self, ca_dir):
+        os.mkdir(ca_dir)
+        for i in ['certs', 'crl', 'newcerts', 'private']:
+            sd = path_join(ca_dir, i)
+            if not exists(sd):
+                os.mkdir(sd)
+
+        if not exists(path_join(ca_dir, 'serial')):
+            with open(path_join(ca_dir, 'serial'), 'w') as fh:
+                fh.write('02\n')
+
+        if not exists(path_join(ca_dir, 'index.txt')):
+            with open(path_join(ca_dir, 'index.txt'), 'w') as fh:
+                fh.write('')
+
+    def _init_ca(self):
+        """Generate the root ca's cert and key.
+        """
+        if not exists(path_join(self.ca_dir, 'ca.cnf')):
+            with open(path_join(self.ca_dir, 'ca.cnf'), 'w') as fh:
+                fh.write(
+                    CA_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if not exists(path_join(self.ca_dir, 'signing.cnf')):
+            with open(path_join(self.ca_dir, 'signing.cnf'), 'w') as fh:
+                fh.write(
+                    SIGNING_CONF_TEMPLATE % (self.get_conf_variables()))
+
+        if exists(self.ca_cert) or exists(self.ca_key):
+            raise RuntimeError("Initialized called when CA already exists")
+        cmd = ['openssl', 'req', '-config', self.ca_conf,
+               '-x509', '-nodes', '-newkey', 'rsa',
+               '-days', self.default_ca_expiry,
+               '-keyout', self.ca_key, '-out', self.ca_cert,
+               '-outform', 'PEM']
+        output = subprocess.check_output(cmd, stderr=subprocess.STDOUT)
+        log("CA Init:\n %s" % output, level=DEBUG)
+
+    def get_conf_variables(self):
+        return dict(
+            org_name="juju",
+            org_unit_name="%s service" % self.name,
+            common_name=self.name,
+            ca_dir=self.ca_dir)
+
+    def get_or_create_cert(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        return self.create_certificate(common_name)
+
+    def create_certificate(self, common_name):
+        if common_name in self:
+            return self.get_certificate(common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        csr_p = path_join(self.ca_dir, "certs", "%s.csr" % common_name)
+        self._create_certificate(common_name, key_p, csr_p, crt_p)
+        return self.get_certificate(common_name)
+
+    def get_certificate(self, common_name):
+        if common_name not in self:
+            raise ValueError("No certificate for %s" % common_name)
+        key_p = path_join(self.ca_dir, "certs", "%s.key" % common_name)
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        with open(crt_p) as fh:
+            crt = fh.read()
+        with open(key_p) as fh:
+            key = fh.read()
+        return crt, key
+
+    def __contains__(self, common_name):
+        crt_p = path_join(self.ca_dir, "certs", "%s.crt" % common_name)
+        return exists(crt_p)
+
+    def _create_certificate(self, common_name, key_p, csr_p, crt_p):
+        template_vars = self.get_conf_variables()
+        template_vars['common_name'] = common_name
+        subj = '/O=%(org_name)s/OU=%(org_unit_name)s/CN=%(common_name)s' % (
+            template_vars)
+
+        log("CA Create Cert %s" % common_name, level=DEBUG)
+        cmd = ['openssl', 'req', '-sha1', '-newkey', 'rsa:2048',
+               '-nodes', '-days', self.default_expiry,
+               '-keyout', key_p, '-out', csr_p, '-subj', subj]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+        cmd = ['openssl', 'rsa', '-in', key_p, '-out', key_p]
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+        log("CA Sign Cert %s" % common_name, level=DEBUG)
+        if self.cert_type == MYSQL_CERT:
+            cmd = ['openssl', 'x509', '-req',
+                   '-in', csr_p, '-days', self.default_expiry,
+                   '-CA', self.ca_cert, '-CAkey', self.ca_key,
+                   '-set_serial', '01', '-out', crt_p]
+        else:
+            cmd = ['openssl', 'ca', '-config', self.signing_conf,
+                   '-extensions', 'req_extensions',
+                   '-days', self.default_expiry, '-notext',
+                   '-in', csr_p, '-out', crt_p, '-subj', subj, '-batch']
+        log("running %s" % " ".join(cmd), level=DEBUG)
+        subprocess.check_call(cmd, stderr=subprocess.PIPE)
+
+    def get_ca_bundle(self):
+        with open(self.ca_cert) as fh:
+            return fh.read()
+
+
+CA_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = ca_distinguished_name
+
+x509_extensions         = ca_extensions
+
+[ ca_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s Certificate Authority
+
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ ca_extensions ]
+basicConstraints        = critical,CA:true
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = cRLSign, keyCertSign
+"""
+
+
+SIGNING_CONF_TEMPLATE = """
+[ ca ]
+default_ca = CA_default
+
+[ CA_default ]
+dir                     = %(ca_dir)s
+policy                  = policy_match
+database                = $dir/index.txt
+serial                  = $dir/serial
+certs                   = $dir/certs
+crl_dir                 = $dir/crl
+new_certs_dir           = $dir/newcerts
+certificate             = $dir/cacert.pem
+private_key             = $dir/private/cacert.key
+RANDFILE                = $dir/private/.rand
+default_md              = default
+
+[ req ]
+default_bits            = 1024
+default_md              = sha1
+
+prompt                  = no
+distinguished_name      = req_distinguished_name
+
+x509_extensions         = req_extensions
+
+[ req_distinguished_name ]
+organizationName        = %(org_name)s
+organizationalUnitName  = %(org_unit_name)s machine resources
+commonName              = %(common_name)s
+
+[ policy_match ]
+countryName             = optional
+stateOrProvinceName     = optional
+organizationName        = match
+organizationalUnitName  = optional
+commonName              = supplied
+
+[ req_extensions ]
+basicConstraints        = CA:false
+subjectKeyIdentifier    = hash
+authorityKeyIdentifier  = keyid:always, issuer
+keyUsage                = digitalSignature, keyEncipherment, keyAgreement
+extendedKeyUsage        = serverAuth, clientAuth
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/bcache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/bcache.py
new file mode 100644
index 0000000000000000000000000000000000000000..605991e16a4238f4ed46fbf0791048187f375c5c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/bcache.py
@@ -0,0 +1,74 @@
+# Copyright 2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import os
+import json
+
+from charmhelpers.core.hookenv import log
+
+stats_intervals = ['stats_day', 'stats_five_minute',
+                   'stats_hour', 'stats_total']
+
+SYSFS = '/sys'
+
+
+class Bcache(object):
+    """Bcache behaviour
+    """
+
+    def __init__(self, cachepath):
+        self.cachepath = cachepath
+
+    @classmethod
+    def fromdevice(cls, devname):
+        return cls('{}/block/{}/bcache'.format(SYSFS, devname))
+
+    def __str__(self):
+        return self.cachepath
+
+    def get_stats(self, interval):
+        """Get cache stats
+        """
+        intervaldir = 'stats_{}'.format(interval)
+        path = "{}/{}".format(self.cachepath, intervaldir)
+        out = dict()
+        for elem in os.listdir(path):
+            out[elem] = open('{}/{}'.format(path, elem)).read().strip()
+        return out
+
+
+def get_bcache_fs():
+    """Return all cache sets
+    """
+    cachesetroot = "{}/fs/bcache".format(SYSFS)
+    try:
+        dirs = os.listdir(cachesetroot)
+    except OSError:
+        log("No bcache fs found")
+        return []
+    cacheset = set([Bcache('{}/{}'.format(cachesetroot, d)) for d in dirs if not d.startswith('register')])
+    return cacheset
+
+
+def get_stats_action(cachespec, interval):
+    """Action for getting bcache statistics for a given cachespec.
+    Cachespec can either be a device name, eg. 'sdb', which will retrieve
+    cache stats for the given device, or 'global', which will retrieve stats
+    for all cachesets
+    """
+    if cachespec == 'global':
+        caches = get_bcache_fs()
+    else:
+        caches = [Bcache.fromdevice(cachespec)]
+    res = dict((c.cachepath, c.get_stats(interval)) for c in caches)
+    return json.dumps(res, indent=4, separators=(',', ': '))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/ceph.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/ceph.py
new file mode 100644
index 0000000000000000000000000000000000000000..814d5c72bc246c9536d3bb5975ade1c7fbe989e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/ceph.py
@@ -0,0 +1,1810 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2012 Canonical Ltd.
+#
+# This file is sourced from lp:openstack-charm-helpers
+#
+# Authors:
+#  James Page <james.page@ubuntu.com>
+#  Adam Gandelman <adamg@ubuntu.com>
+#
+
+import collections
+import errno
+import hashlib
+import math
+import six
+
+import os
+import shutil
+import json
+import time
+import uuid
+
+from subprocess import (
+    check_call,
+    check_output,
+    CalledProcessError,
+)
+from charmhelpers.core.hookenv import (
+    config,
+    service_name,
+    local_unit,
+    relation_get,
+    relation_ids,
+    relation_set,
+    related_units,
+    log,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+)
+from charmhelpers.core.host import (
+    mount,
+    mounts,
+    service_start,
+    service_stop,
+    service_running,
+    umount,
+    cmp_pkgrevno,
+)
+from charmhelpers.fetch import (
+    apt_install,
+)
+from charmhelpers.core.unitdata import kv
+
+from charmhelpers.core.kernel import modprobe
+from charmhelpers.contrib.openstack.utils import config_flags_parser
+
+KEYRING = '/etc/ceph/ceph.client.{}.keyring'
+KEYFILE = '/etc/ceph/ceph.client.{}.key'
+
+CEPH_CONF = """[global]
+auth supported = {auth}
+keyring = {keyring}
+mon host = {mon_hosts}
+log to syslog = {use_syslog}
+err to syslog = {use_syslog}
+clog to syslog = {use_syslog}
+"""
+
+# The number of placement groups per OSD to target for placement group
+# calculations. This number is chosen as 100 due to the ceph PG Calc
+# documentation recommending to choose 100 for clusters which are not
+# expected to increase in the foreseeable future. Since the majority of the
+# calculations are done on deployment, target the case of non-expanding
+# clusters as the default.
+DEFAULT_PGS_PER_OSD_TARGET = 100
+DEFAULT_POOL_WEIGHT = 10.0
+LEGACY_PG_COUNT = 200
+DEFAULT_MINIMUM_PGS = 2
+AUTOSCALER_DEFAULT_PGS = 32
+
+
+class OsdPostUpgradeError(Exception):
+    """Error class for OSD post-upgrade operations."""
+    pass
+
+
+class OSDSettingConflict(Exception):
+    """Error class for conflicting osd setting requests."""
+    pass
+
+
+class OSDSettingNotAllowed(Exception):
+    """Error class for a disallowed setting."""
+    pass
+
+
+OSD_SETTING_EXCEPTIONS = (OSDSettingConflict, OSDSettingNotAllowed)
+
+OSD_SETTING_WHITELIST = [
+    'osd heartbeat grace',
+    'osd heartbeat interval',
+]
+
+
+def _order_dict_by_key(rdict):
+    """Convert a dictionary into an OrderedDict sorted by key.
+
+    :param rdict: Dictionary to be ordered.
+    :type rdict: dict
+    :returns: Ordered Dictionary.
+    :rtype: collections.OrderedDict
+    """
+    return collections.OrderedDict(sorted(rdict.items(), key=lambda k: k[0]))
+
+
+def get_osd_settings(relation_name):
+    """Consolidate requested osd settings from all clients.
+
+    Consolidate requested osd settings from all clients. Check that the
+    requested setting is on the whitelist and it does not conflict with
+    any other requested settings.
+
+    :returns: Dictionary of settings
+    :rtype: dict
+
+    :raises: OSDSettingNotAllowed
+    :raises: OSDSettingConflict
+    """
+    rel_ids = relation_ids(relation_name)
+    osd_settings = {}
+    for relid in rel_ids:
+        for unit in related_units(relid):
+            unit_settings = relation_get('osd-settings', unit, relid) or '{}'
+            unit_settings = json.loads(unit_settings)
+            for key, value in unit_settings.items():
+                if key not in OSD_SETTING_WHITELIST:
+                    msg = 'Illegal settings "{}"'.format(key)
+                    raise OSDSettingNotAllowed(msg)
+                if key in osd_settings:
+                    if osd_settings[key] != unit_settings[key]:
+                        msg = 'Conflicting settings for "{}"'.format(key)
+                        raise OSDSettingConflict(msg)
+                else:
+                    osd_settings[key] = value
+    return _order_dict_by_key(osd_settings)
+
+
+def send_osd_settings():
+    """Pass on requested OSD settings to osd units."""
+    try:
+        settings = get_osd_settings('client')
+    except OSD_SETTING_EXCEPTIONS as e:
+        # There is a problem with the settings, not passing them on. Update
+        # status will notify the user.
+        log(e, level=ERROR)
+        return
+    data = {
+        'osd-settings': json.dumps(settings, sort_keys=True)}
+    for relid in relation_ids('osd'):
+        relation_set(relation_id=relid,
+                     relation_settings=data)
+
+
+def validator(value, valid_type, valid_range=None):
+    """
+    Used to validate these: http://docs.ceph.com/docs/master/rados/operations/pools/#set-pool-values
+    Example input:
+        validator(value=1,
+                  valid_type=int,
+                  valid_range=[0, 2])
+    This says I'm testing value=1.  It must be an int inclusive in [0,2]
+
+    :param value: The value to validate
+    :param valid_type: The type that value should be.
+    :param valid_range: A range of values that value can assume.
+    :return:
+    """
+    assert isinstance(value, valid_type), "{} is not a {}".format(
+        value,
+        valid_type)
+    if valid_range is not None:
+        assert isinstance(valid_range, list), \
+            "valid_range must be a list, was given {}".format(valid_range)
+        # If we're dealing with strings
+        if isinstance(value, six.string_types):
+            assert value in valid_range, \
+                "{} is not in the list {}".format(value, valid_range)
+        # Integer, float should have a min and max
+        else:
+            if len(valid_range) != 2:
+                raise ValueError(
+                    "Invalid valid_range list of {} for {}.  "
+                    "List must be [min,max]".format(valid_range, value))
+            assert value >= valid_range[0], \
+                "{} is less than minimum allowed value of {}".format(
+                    value, valid_range[0])
+            assert value <= valid_range[1], \
+                "{} is greater than maximum allowed value of {}".format(
+                    value, valid_range[1])
+
+
+class PoolCreationError(Exception):
+    """
+    A custom error to inform the caller that a pool creation failed.  Provides an error message
+    """
+
+    def __init__(self, message):
+        super(PoolCreationError, self).__init__(message)
+
+
+class Pool(object):
+    """
+    An object oriented approach to Ceph pool creation. This base class is inherited by ReplicatedPool and ErasurePool.
+    Do not call create() on this base class as it will not do anything.  Instantiate a child class and call create().
+    """
+
+    def __init__(self, service, name):
+        self.service = service
+        self.name = name
+
+    # Create the pool if it doesn't exist already
+    # To be implemented by subclasses
+    def create(self):
+        pass
+
+    def add_cache_tier(self, cache_pool, mode):
+        """
+        Adds a new cache tier to an existing pool.
+        :param cache_pool: six.string_types.  The cache tier pool name to add.
+        :param mode: six.string_types. The caching mode to use for this pool.  valid range = ["readonly", "writeback"]
+        :return: None
+        """
+        # Check the input types and values
+        validator(value=cache_pool, valid_type=six.string_types)
+        validator(value=mode, valid_type=six.string_types, valid_range=["readonly", "writeback"])
+
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'add', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, mode])
+        check_call(['ceph', '--id', self.service, 'osd', 'tier', 'set-overlay', self.name, cache_pool])
+        check_call(['ceph', '--id', self.service, 'osd', 'pool', 'set', cache_pool, 'hit_set_type', 'bloom'])
+
+    def remove_cache_tier(self, cache_pool):
+        """
+        Removes a cache tier from Ceph.  Flushes all dirty objects from writeback pools and waits for that to complete.
+        :param cache_pool: six.string_types.  The cache tier pool name to remove.
+        :return: None
+        """
+        # read-only is easy, writeback is much harder
+        mode = get_cache_mode(self.service, cache_pool)
+        if mode == 'readonly':
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'cache-mode', cache_pool, 'none'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+        elif mode == 'writeback':
+            pool_forward_cmd = ['ceph', '--id', self.service, 'osd', 'tier',
+                                'cache-mode', cache_pool, 'forward']
+            if cmp_pkgrevno('ceph-common', '10.1') >= 0:
+                # Jewel added a mandatory flag
+                pool_forward_cmd.append('--yes-i-really-mean-it')
+
+            check_call(pool_forward_cmd)
+            # Flush the cache and wait for it to return
+            check_call(['rados', '--id', self.service, '-p', cache_pool, 'cache-flush-evict-all'])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove-overlay', self.name])
+            check_call(['ceph', '--id', self.service, 'osd', 'tier', 'remove', self.name, cache_pool])
+
+    def get_pgs(self, pool_size, percent_data=DEFAULT_POOL_WEIGHT,
+                device_class=None):
+        """Return the number of placement groups to use when creating the pool.
+
+        Returns the number of placement groups which should be specified when
+        creating the pool. This is based upon the calculation guidelines
+        provided by the Ceph Placement Group Calculator (located online at
+        http://ceph.com/pgcalc/).
+
+        The number of placement groups are calculated using the following:
+
+            (Target PGs per OSD) * (OSD #) * (%Data)
+            ----------------------------------------
+                         (Pool size)
+
+        Per the upstream guidelines, the OSD # should really be considered
+        based on the number of OSDs which are eligible to be selected by the
+        pool. Since the pool creation doesn't specify any of CRUSH set rules,
+        the default rule will be dependent upon the type of pool being
+        created (replicated or erasure).
+
+        This code makes no attempt to determine the number of OSDs which can be
+        selected for the specific rule, rather it is left to the user to tune
+        in the form of 'expected-osd-count' config option.
+
+        :param pool_size: int. pool_size is either the number of replicas for
+            replicated pools or the K+M sum for erasure coded pools
+        :param percent_data: float. the percentage of data that is expected to
+            be contained in the pool for the specific OSD set. Default value
+            is to assume 10% of the data is for this pool, which is a
+            relatively low % of the data but allows for the pg_num to be
+            increased. NOTE: the default is primarily to handle the scenario
+            where related charms requiring pools has not been upgraded to
+            include an update to indicate their relative usage of the pools.
+        :param device_class: str. class of storage to use for basis of pgs
+            calculation; ceph supports nvme, ssd and hdd by default based
+            on presence of devices of each type in the deployment.
+        :return: int.  The number of pgs to use.
+        """
+
+        # Note: This calculation follows the approach that is provided
+        # by the Ceph PG Calculator located at http://ceph.com/pgcalc/.
+        validator(value=pool_size, valid_type=int)
+
+        # Ensure that percent data is set to something - even with a default
+        # it can be set to None, which would wreak havoc below.
+        if percent_data is None:
+            percent_data = DEFAULT_POOL_WEIGHT
+
+        # If the expected-osd-count is specified, then use the max between
+        # the expected-osd-count and the actual osd_count
+        osd_list = get_osds(self.service, device_class)
+        expected = config('expected-osd-count') or 0
+
+        if osd_list:
+            if device_class:
+                osd_count = len(osd_list)
+            else:
+                osd_count = max(expected, len(osd_list))
+
+            # Log a message to provide some insight if the calculations claim
+            # to be off because someone is setting the expected count and
+            # there are more OSDs in reality. Try to make a proper guess
+            # based upon the cluster itself.
+            if not device_class and expected and osd_count != expected:
+                log("Found more OSDs than provided expected count. "
+                    "Using the actual count instead", INFO)
+        elif expected:
+            # Use the expected-osd-count in older ceph versions to allow for
+            # a more accurate pg calculations
+            osd_count = expected
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            return LEGACY_PG_COUNT
+
+        percent_data /= 100.0
+        target_pgs_per_osd = config('pgs-per-osd') or DEFAULT_PGS_PER_OSD_TARGET
+        num_pg = (target_pgs_per_osd * osd_count * percent_data) // pool_size
+
+        # NOTE: ensure a sane minimum number of PGS otherwise we don't get any
+        #       reasonable data distribution in minimal OSD configurations
+        if num_pg < DEFAULT_MINIMUM_PGS:
+            num_pg = DEFAULT_MINIMUM_PGS
+
+        # The CRUSH algorithm has a slight optimization for placement groups
+        # with powers of 2 so find the nearest power of 2. If the nearest
+        # power of 2 is more than 25% below the original value, the next
+        # highest value is used. To do this, find the nearest power of 2 such
+        # that 2^n <= num_pg, check to see if its within the 25% tolerance.
+        exponent = math.floor(math.log(num_pg, 2))
+        nearest = 2 ** exponent
+        if (num_pg - nearest) > (num_pg * 0.25):
+            # Choose the next highest power of 2 since the nearest is more
+            # than 25% below the original value.
+            return int(nearest * 2)
+        else:
+            return int(nearest)
+
+
+class ReplicatedPool(Pool):
+    def __init__(self, service, name, pg_num=None, replicas=2,
+                 percent_data=10.0, app_name=None):
+        super(ReplicatedPool, self).__init__(service=service, name=name)
+        self.replicas = replicas
+        self.percent_data = percent_data
+        if pg_num:
+            # Since the number of placement groups were specified, ensure
+            # that there aren't too many created.
+            max_pgs = self.get_pgs(self.replicas, 100.0)
+            self.pg_num = min(pg_num, max_pgs)
+        else:
+            self.pg_num = self.get_pgs(self.replicas, percent_data)
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, self.pg_num)
+                    ),
+                    self.name, str(self.pg_num)
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(self.pg_num)
+                ]
+
+            try:
+                check_call(cmd)
+                # Set the pool replica size
+                update_pool(client=self.service,
+                            pool=self.name,
+                            settings={'size': str(self.replicas)})
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+
+# Default jerasure erasure coded pool
+class ErasurePool(Pool):
+    def __init__(self, service, name, erasure_code_profile="default",
+                 percent_data=10.0, app_name=None):
+        super(ErasurePool, self).__init__(service=service, name=name)
+        self.erasure_code_profile = erasure_code_profile
+        self.percent_data = percent_data
+        if app_name:
+            self.app_name = app_name
+        else:
+            self.app_name = 'unknown'
+
+    def create(self):
+        if not pool_exists(self.service, self.name):
+            # Try to find the erasure profile information in order to properly
+            # size the number of placement groups. The size of an erasure
+            # coded placement group is calculated as k+m.
+            erasure_profile = get_erasure_profile(self.service,
+                                                  self.erasure_code_profile)
+
+            # Check for errors
+            if erasure_profile is None:
+                msg = ("Failed to discover erasure profile named "
+                       "{}".format(self.erasure_code_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+            if 'k' not in erasure_profile or 'm' not in erasure_profile:
+                # Error
+                msg = ("Unable to find k (data chunks) or m (coding chunks) "
+                       "in erasure profile {}".format(erasure_profile))
+                log(msg, level=ERROR)
+                raise PoolCreationError(msg)
+
+            k = int(erasure_profile['k'])
+            m = int(erasure_profile['m'])
+            pgs = self.get_pgs(k + m, self.percent_data)
+            nautilus_or_later = cmp_pkgrevno('ceph-common', '14.2.0') >= 0
+            # Create it
+            if nautilus_or_later:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    '--pg-num-min={}'.format(
+                        min(AUTOSCALER_DEFAULT_PGS, pgs)
+                    ),
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+            else:
+                cmd = [
+                    'ceph', '--id', self.service, 'osd', 'pool', 'create',
+                    self.name, str(pgs), str(pgs),
+                    'erasure', self.erasure_code_profile
+                ]
+
+            try:
+                check_call(cmd)
+                try:
+                    set_app_name_for_pool(client=self.service,
+                                          pool=self.name,
+                                          name=self.app_name)
+                except CalledProcessError:
+                    log('Could not set app name for pool {}'.format(self.name), level=WARNING)
+                if nautilus_or_later:
+                    # Ensure we set the expected pool ratio
+                    update_pool(client=self.service,
+                                pool=self.name,
+                                settings={'target_size_ratio': str(self.percent_data / 100.0)})
+                if 'pg_autoscaler' in enabled_manager_modules():
+                    try:
+                        enable_pg_autoscale(self.service, self.name)
+                    except CalledProcessError as e:
+                        log('Could not configure auto scaling for pool {}: {}'.format(
+                            self.name, e), level=WARNING)
+            except CalledProcessError:
+                raise
+
+    """Get an existing erasure code profile if it already exists.
+       Returns json formatted output"""
+
+
+def enabled_manager_modules():
+    """Return a list of enabled manager modules.
+
+    :rtype: List[str]
+    """
+    cmd = ['ceph', 'mgr', 'module', 'ls']
+    try:
+        modules = check_output(cmd)
+        if six.PY3:
+            modules = modules.decode('UTF-8')
+    except CalledProcessError as e:
+        log("Failed to list ceph modules: {}".format(e), WARNING)
+        return []
+    modules = json.loads(modules)
+    return modules['enabled_modules']
+
+
+def enable_pg_autoscale(service, pool_name):
+    """
+    Enable Ceph's PG autoscaler for the specified pool.
+
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types. The name of the pool to enable sutoscaling on
+    :raise: CalledProcessError if the command fails
+    """
+    check_call(['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, 'pg_autoscale_mode', 'on'])
+
+
+def get_mon_map(service):
+    """
+    Returns the current monitor map.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :return: json string. :raise: ValueError if the monmap fails to parse.
+      Also raises CalledProcessError if our ceph command fails
+    """
+    try:
+        mon_status = check_output(['ceph', '--id', service,
+                                   'mon_status', '--format=json'])
+        if six.PY3:
+            mon_status = mon_status.decode('UTF-8')
+        try:
+            return json.loads(mon_status)
+        except ValueError as v:
+            log("Unable to parse mon_status json: {}. Error: {}"
+                .format(mon_status, str(v)))
+            raise
+    except CalledProcessError as e:
+        log("mon_status command failed with message: {}"
+            .format(str(e)))
+        raise
+
+
+def hash_monitor_names(service):
+    """
+    Uses the get_mon_map() function to get information about the monitor
+    cluster.
+    Hash the name of each monitor.  Return a sorted list of monitor hashes
+    in an ascending order.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :rtype : dict.   json dict of monitor name, ip address and rank
+    example: {
+        'name': 'ip-172-31-13-165',
+        'rank': 0,
+        'addr': '172.31.13.165:6789/0'}
+    """
+    try:
+        hash_list = []
+        monitor_list = get_mon_map(service=service)
+        if monitor_list['monmap']['mons']:
+            for mon in monitor_list['monmap']['mons']:
+                hash_list.append(
+                    hashlib.sha224(mon['name'].encode('utf-8')).hexdigest())
+            return sorted(hash_list)
+        else:
+            return None
+    except (ValueError, CalledProcessError):
+        raise
+
+
+def monitor_key_delete(service, key):
+    """
+    Delete a key and value pair from the monitor cluster
+    :param service: six.string_types. The Ceph user name to run the command under
+    Deletes a key value pair on the monitor cluster.
+    :param key: six.string_types.  The key to delete.
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'del', str(key)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_set(service, key, value):
+    """
+    Sets a key value pair on the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to set.
+    :param value: The value to set.  This will be converted to a string
+        before setting
+    """
+    try:
+        check_output(
+            ['ceph', '--id', service,
+             'config-key', 'put', str(key), str(value)])
+    except CalledProcessError as e:
+        log("Monitor config-key put failed with message: {}".format(
+            e.output))
+        raise
+
+
+def monitor_key_get(service, key):
+    """
+    Gets the value of an existing key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for.
+    :return: Returns the value of that key or None if not found.
+    """
+    try:
+        output = check_output(
+            ['ceph', '--id', service,
+             'config-key', 'get', str(key)]).decode('UTF-8')
+        return output
+    except CalledProcessError as e:
+        log("Monitor config-key get failed with message: {}".format(
+            e.output))
+        return None
+
+
+def monitor_key_exists(service, key):
+    """
+    Searches for the existence of a key in the monitor cluster.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param key: six.string_types.  The key to search for
+    :return: Returns True if the key exists, False if not and raises an
+     exception if an unknown error occurs. :raise: CalledProcessError if
+     an unknown error occurs
+    """
+    try:
+        check_call(
+            ['ceph', '--id', service,
+             'config-key', 'exists', str(key)])
+        # I can return true here regardless because Ceph returns
+        # ENOENT if the key wasn't found
+        return True
+    except CalledProcessError as e:
+        if e.returncode == errno.ENOENT:
+            return False
+        else:
+            log("Unknown error from ceph config-get exists: {} {}".format(
+                e.returncode, e.output))
+            raise
+
+
+def get_erasure_profile(service, name):
+    """
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name:
+    :return:
+    """
+    try:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'erasure-code-profile', 'get',
+                            name, '--format=json'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+        return json.loads(out)
+    except (CalledProcessError, OSError, ValueError):
+        return None
+
+
+def pool_set(service, pool_name, key, value):
+    """
+    Sets a value for a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param key: six.string_types
+    :param value:
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set', pool_name, key,
+           str(value).lower()]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def snapshot_pool(service, pool_name, snapshot_name):
+    """
+    Snapshots a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'mksnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_pool_snapshot(service, pool_name, snapshot_name):
+    """
+    Remove a snapshot from a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :param snapshot_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rmsnap', pool_name, snapshot_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def set_pool_quota(service, pool_name, max_bytes=None, max_objects=None):
+    """
+    :param service: The Ceph user name to run the command under
+    :type service: str
+    :param pool_name: Name of pool
+    :type pool_name: str
+    :param max_bytes: Maximum bytes quota to apply
+    :type max_bytes: int
+    :param max_objects: Maximum objects quota to apply
+    :type max_objects: int
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name]
+    if max_bytes:
+        cmd = cmd + ['max_bytes', str(max_bytes)]
+    if max_objects:
+        cmd = cmd + ['max_objects', str(max_objects)]
+    check_call(cmd)
+
+
+def remove_pool_quota(service, pool_name):
+    """
+    Set a byte quota on a RADOS pool in ceph.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'set-quota', pool_name, 'max_bytes', '0']
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def remove_erasure_profile(service, profile_name):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'rm',
+           profile_name]
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def create_erasure_profile(service, profile_name, erasure_plugin_name='jerasure',
+                           failure_domain='host',
+                           data_chunks=2, coding_chunks=1,
+                           locality=None, durability_estimator=None,
+                           device_class=None):
+    """
+    Create a new erasure code profile if one does not already exist for it.  Updates
+    the profile if it exists. Please see http://docs.ceph.com/docs/master/rados/operations/erasure-code-profile/
+    for more details
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param profile_name: six.string_types
+    :param erasure_plugin_name: six.string_types
+    :param failure_domain: six.string_types.  One of ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region',
+        'room', 'root', 'row'])
+    :param data_chunks: int
+    :param coding_chunks: int
+    :param locality: int
+    :param durability_estimator: int
+    :param device_class: six.string_types
+    :return: None.  Can raise CalledProcessError
+    """
+    # Ensure this failure_domain is allowed by Ceph
+    validator(failure_domain, six.string_types,
+              ['chassis', 'datacenter', 'host', 'osd', 'pdu', 'pod', 'rack', 'region', 'room', 'root', 'row'])
+
+    cmd = ['ceph', '--id', service, 'osd', 'erasure-code-profile', 'set', profile_name,
+           'plugin=' + erasure_plugin_name, 'k=' + str(data_chunks), 'm=' + str(coding_chunks)
+           ]
+    if locality is not None and durability_estimator is not None:
+        raise ValueError("create_erasure_profile should be called with k, m and one of l or c but not both.")
+
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    # failure_domain changed in luminous
+    if luminous_or_later:
+        cmd.append('crush-failure-domain=' + failure_domain)
+    else:
+        cmd.append('ruleset-failure-domain=' + failure_domain)
+
+    # device class new in luminous
+    if luminous_or_later and device_class:
+        cmd.append('crush-device-class={}'.format(device_class))
+    else:
+        log('Skipping device class configuration (ceph < 12.0.0)',
+            level=DEBUG)
+
+    # Add plugin specific information
+    if locality is not None:
+        # For local erasure codes
+        cmd.append('l=' + str(locality))
+    if durability_estimator is not None:
+        # For Shec erasure codes
+        cmd.append('c=' + str(durability_estimator))
+
+    if erasure_profile_exists(service, profile_name):
+        cmd.append('--force')
+
+    try:
+        check_call(cmd)
+    except CalledProcessError:
+        raise
+
+
+def rename_pool(service, old_name, new_name):
+    """
+    Rename a Ceph pool from old_name to new_name
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param old_name: six.string_types
+    :param new_name: six.string_types
+    :return: None
+    """
+    validator(value=old_name, valid_type=six.string_types)
+    validator(value=new_name, valid_type=six.string_types)
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'rename', old_name, new_name]
+    check_call(cmd)
+
+
+def erasure_profile_exists(service, name):
+    """
+    Check to see if an Erasure code profile already exists.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param name: six.string_types
+    :return: int or None
+    """
+    validator(value=name, valid_type=six.string_types)
+    try:
+        check_call(['ceph', '--id', service,
+                    'osd', 'erasure-code-profile', 'get',
+                    name])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def get_cache_mode(service, pool_name):
+    """
+    Find the current caching mode of the pool_name given.
+    :param service: six.string_types. The Ceph user name to run the command under
+    :param pool_name: six.string_types
+    :return: int or None
+    """
+    validator(value=service, valid_type=six.string_types)
+    validator(value=pool_name, valid_type=six.string_types)
+    out = check_output(['ceph', '--id', service,
+                        'osd', 'dump', '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    try:
+        osd_json = json.loads(out)
+        for pool in osd_json['pools']:
+            if pool['pool_name'] == pool_name:
+                return pool['cache_mode']
+        return None
+    except ValueError:
+        raise
+
+
+def pool_exists(service, name):
+    """Check to see if a RADOS pool already exists."""
+    try:
+        out = check_output(['rados', '--id', service, 'lspools'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out.split()
+
+
+def get_osds(service, device_class=None):
+    """Return a list of all Ceph Object Storage Daemons currently in the
+    cluster (optionally filtered by storage device class).
+
+    :param device_class: Class of storage device for OSD's
+    :type device_class: str
+    """
+    luminous_or_later = cmp_pkgrevno('ceph-common', '12.0.0') >= 0
+    if luminous_or_later and device_class:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'crush', 'class',
+                            'ls-osd', device_class,
+                            '--format=json'])
+    else:
+        out = check_output(['ceph', '--id', service,
+                            'osd', 'ls',
+                            '--format=json'])
+    if six.PY3:
+        out = out.decode('UTF-8')
+    return json.loads(out)
+
+
+def install():
+    """Basic Ceph client installation."""
+    ceph_dir = "/etc/ceph"
+    if not os.path.exists(ceph_dir):
+        os.mkdir(ceph_dir)
+
+    apt_install('ceph-common', fatal=True)
+
+
+def rbd_exists(service, pool, rbd_img):
+    """Check to see if a RADOS block device exists."""
+    try:
+        out = check_output(['rbd', 'list', '--id',
+                            service, '--pool', pool])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return rbd_img in out
+
+
+def create_rbd_image(service, pool, image, sizemb):
+    """Create a new RADOS block device."""
+    cmd = ['rbd', 'create', image, '--size', str(sizemb), '--id', service,
+           '--pool', pool]
+    check_call(cmd)
+
+
+def update_pool(client, pool, settings):
+    cmd = ['ceph', '--id', client, 'osd', 'pool', 'set', pool]
+    for k, v in six.iteritems(settings):
+        cmd.append(k)
+        cmd.append(v)
+
+    check_call(cmd)
+
+
+def set_app_name_for_pool(client, pool, name):
+    """
+    Calls `osd pool application enable` for the specified pool name
+
+    :param client: Name of the ceph client to use
+    :type client: str
+    :param pool: Pool to set app name for
+    :type pool: str
+    :param name: app name for the specified pool
+    :type name: str
+
+    :raises: CalledProcessError if ceph call fails
+    """
+    if cmp_pkgrevno('ceph-common', '12.0.0') >= 0:
+        cmd = ['ceph', '--id', client, 'osd', 'pool',
+               'application', 'enable', pool, name]
+        check_call(cmd)
+
+
+def create_pool(service, name, replicas=3, pg_num=None):
+    """Create a new RADOS pool."""
+    if pool_exists(service, name):
+        log("Ceph pool {} already exists, skipping creation".format(name),
+            level=WARNING)
+        return
+
+    if not pg_num:
+        # Calculate the number of placement groups based
+        # on upstream recommended best practices.
+        osds = get_osds(service)
+        if osds:
+            pg_num = (len(osds) * 100 // replicas)
+        else:
+            # NOTE(james-page): Default to 200 for older ceph versions
+            # which don't support OSD query from cli
+            pg_num = 200
+
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'create', name, str(pg_num)]
+    check_call(cmd)
+
+    update_pool(service, name, settings={'size': str(replicas)})
+
+
+def delete_pool(service, name):
+    """Delete a RADOS pool from ceph."""
+    cmd = ['ceph', '--id', service, 'osd', 'pool', 'delete', name,
+           '--yes-i-really-really-mean-it']
+    check_call(cmd)
+
+
+def _keyfile_path(service):
+    return KEYFILE.format(service)
+
+
+def _keyring_path(service):
+    return KEYRING.format(service)
+
+
+def add_key(service, key):
+    """
+    Add a key to a keyring.
+
+    Creates the keyring if it doesn't already exist.
+
+    Logs and returns if the key is already in the keyring.
+    """
+    keyring = _keyring_path(service)
+    if os.path.exists(keyring):
+        with open(keyring, 'r') as ring:
+            if key in ring.read():
+                log('Ceph keyring exists at %s and has not changed.' % keyring,
+                    level=DEBUG)
+                return
+            log('Updating existing keyring %s.' % keyring, level=DEBUG)
+
+    cmd = ['ceph-authtool', keyring, '--create-keyring',
+           '--name=client.{}'.format(service), '--add-key={}'.format(key)]
+    check_call(cmd)
+    log('Created new ceph keyring at %s.' % keyring, level=DEBUG)
+
+
+def create_keyring(service, key):
+    """Deprecated. Please use the more accurately named 'add_key'"""
+    return add_key(service, key)
+
+
+def delete_keyring(service):
+    """Delete an existing Ceph keyring."""
+    keyring = _keyring_path(service)
+    if not os.path.exists(keyring):
+        log('Keyring does not exist at %s' % keyring, level=WARNING)
+        return
+
+    os.remove(keyring)
+    log('Deleted ring at %s.' % keyring, level=INFO)
+
+
+def create_key_file(service, key):
+    """Create a file containing key."""
+    keyfile = _keyfile_path(service)
+    if os.path.exists(keyfile):
+        log('Keyfile exists at %s.' % keyfile, level=WARNING)
+        return
+
+    with open(keyfile, 'w') as fd:
+        fd.write(key)
+
+    log('Created new keyfile at %s.' % keyfile, level=INFO)
+
+
+def get_ceph_nodes(relation='ceph'):
+    """Query named relation to determine current nodes."""
+    hosts = []
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            hosts.append(relation_get('private-address', unit=unit, rid=r_id))
+
+    return hosts
+
+
+def configure(service, key, auth, use_syslog):
+    """Perform basic configuration of Ceph."""
+    add_key(service, key)
+    create_key_file(service, key)
+    hosts = get_ceph_nodes()
+    with open('/etc/ceph/ceph.conf', 'w') as ceph_conf:
+        ceph_conf.write(CEPH_CONF.format(auth=auth,
+                                         keyring=_keyring_path(service),
+                                         mon_hosts=",".join(map(str, hosts)),
+                                         use_syslog=use_syslog))
+    modprobe('rbd')
+
+
+def image_mapped(name):
+    """Determine whether a RADOS block device is mapped locally."""
+    try:
+        out = check_output(['rbd', 'showmapped'])
+        if six.PY3:
+            out = out.decode('UTF-8')
+    except CalledProcessError:
+        return False
+
+    return name in out
+
+
+def map_block_storage(service, pool, image):
+    """Map a RADOS block device for local use."""
+    cmd = [
+        'rbd',
+        'map',
+        '{}/{}'.format(pool, image),
+        '--user',
+        service,
+        '--secret',
+        _keyfile_path(service),
+    ]
+    check_call(cmd)
+
+
+def filesystem_mounted(fs):
+    """Determine whether a filesytems is already mounted."""
+    return fs in [f for f, m in mounts()]
+
+
+def make_filesystem(blk_device, fstype='ext4', timeout=10):
+    """Make a new filesystem on the specified block device."""
+    count = 0
+    e_noent = errno.ENOENT
+    while not os.path.exists(blk_device):
+        if count >= timeout:
+            log('Gave up waiting on block device %s' % blk_device,
+                level=ERROR)
+            raise IOError(e_noent, os.strerror(e_noent), blk_device)
+
+        log('Waiting for block device %s to appear' % blk_device,
+            level=DEBUG)
+        count += 1
+        time.sleep(1)
+    else:
+        log('Formatting block device %s as filesystem %s.' %
+            (blk_device, fstype), level=INFO)
+        check_call(['mkfs', '-t', fstype, blk_device])
+
+
+def place_data_on_block_device(blk_device, data_src_dst):
+    """Migrate data in data_src_dst to blk_device and then remount."""
+    # mount block device into /mnt
+    mount(blk_device, '/mnt')
+    # copy data to /mnt
+    copy_files(data_src_dst, '/mnt')
+    # umount block device
+    umount('/mnt')
+    # Grab user/group ID's from original source
+    _dir = os.stat(data_src_dst)
+    uid = _dir.st_uid
+    gid = _dir.st_gid
+    # re-mount where the data should originally be
+    # TODO: persist is currently a NO-OP in core.host
+    mount(blk_device, data_src_dst, persist=True)
+    # ensure original ownership of new mount.
+    os.chown(data_src_dst, uid, gid)
+
+
+def copy_files(src, dst, symlinks=False, ignore=None):
+    """Copy files from src to dst."""
+    for item in os.listdir(src):
+        s = os.path.join(src, item)
+        d = os.path.join(dst, item)
+        if os.path.isdir(s):
+            shutil.copytree(s, d, symlinks, ignore)
+        else:
+            shutil.copy2(s, d)
+
+
+def ensure_ceph_storage(service, pool, rbd_img, sizemb, mount_point,
+                        blk_device, fstype, system_services=[],
+                        replicas=3):
+    """NOTE: This function must only be called from a single service unit for
+    the same rbd_img otherwise data loss will occur.
+
+    Ensures given pool and RBD image exists, is mapped to a block device,
+    and the device is formatted and mounted at the given mount_point.
+
+    If formatting a device for the first time, data existing at mount_point
+    will be migrated to the RBD device before being re-mounted.
+
+    All services listed in system_services will be stopped prior to data
+    migration and restarted when complete.
+    """
+    # Ensure pool, RBD image, RBD mappings are in place.
+    if not pool_exists(service, pool):
+        log('Creating new pool {}.'.format(pool), level=INFO)
+        create_pool(service, pool, replicas=replicas)
+
+    if not rbd_exists(service, pool, rbd_img):
+        log('Creating RBD image ({}).'.format(rbd_img), level=INFO)
+        create_rbd_image(service, pool, rbd_img, sizemb)
+
+    if not image_mapped(rbd_img):
+        log('Mapping RBD Image {} as a Block Device.'.format(rbd_img),
+            level=INFO)
+        map_block_storage(service, pool, rbd_img)
+
+    # make file system
+    # TODO: What happens if for whatever reason this is run again and
+    # the data is already in the rbd device and/or is mounted??
+    # When it is mounted already, it will fail to make the fs
+    # XXX: This is really sketchy!  Need to at least add an fstab entry
+    #      otherwise this hook will blow away existing data if its executed
+    #      after a reboot.
+    if not filesystem_mounted(mount_point):
+        make_filesystem(blk_device, fstype)
+
+        for svc in system_services:
+            if service_running(svc):
+                log('Stopping services {} prior to migrating data.'
+                    .format(svc), level=DEBUG)
+                service_stop(svc)
+
+        place_data_on_block_device(blk_device, mount_point)
+
+        for svc in system_services:
+            log('Starting service {} after migrating data.'
+                .format(svc), level=DEBUG)
+            service_start(svc)
+
+
+def ensure_ceph_keyring(service, user=None, group=None,
+                        relation='ceph', key=None):
+    """Ensures a ceph keyring is created for a named service and optionally
+    ensures user and group ownership.
+
+    @returns boolean: Flag to indicate whether a key was successfully written
+                      to disk based on either relation data or a supplied key
+    """
+    if not key:
+        for rid in relation_ids(relation):
+            for unit in related_units(rid):
+                key = relation_get('key', rid=rid, unit=unit)
+                if key:
+                    break
+
+    if not key:
+        return False
+
+    add_key(service=service, key=key)
+    keyring = _keyring_path(service)
+    if user and group:
+        check_call(['chown', '%s.%s' % (user, group), keyring])
+
+    return True
+
+
+class CephBrokerRq(object):
+    """Ceph broker request.
+
+    Multiple operations can be added to a request and sent to the Ceph broker
+    to be executed.
+
+    Request is json-encoded for sending over the wire.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, api_version=1, request_id=None):
+        self.api_version = api_version
+        if request_id:
+            self.request_id = request_id
+        else:
+            self.request_id = str(uuid.uuid1())
+        self.ops = []
+
+    def add_op(self, op):
+        """Add an op if it is not already in the list.
+
+        :param op: Operation to add.
+        :type op: dict
+        """
+        if op not in self.ops:
+            self.ops.append(op)
+
+    def add_op_request_access_to_group(self, name, namespace=None,
+                                       permission=None, key_name=None,
+                                       object_prefix_permissions=None):
+        """
+        Adds the requested permissions to the current service's Ceph key,
+        allowing the key to access only the specified pools or
+        object prefixes. object_prefix_permissions should be a dictionary
+        keyed on the permission with the corresponding value being a list
+        of prefixes to apply that permission to.
+            {
+                'rwx': ['prefix1', 'prefix2'],
+                'class-read': ['prefix3']}
+        """
+        self.add_op({
+            'op': 'add-permissions-to-key', 'group': name,
+            'namespace': namespace,
+            'name': key_name or service_name(),
+            'group-permission': permission,
+            'object-prefix-permissions': object_prefix_permissions})
+
+    def add_op_create_pool(self, name, replica_count=3, pg_num=None,
+                           weight=None, group=None, namespace=None,
+                           app_name=None, max_bytes=None, max_objects=None):
+        """DEPRECATED: Use ``add_op_create_replicated_pool()`` or
+                       ``add_op_create_erasure_pool()`` instead.
+        """
+        return self.add_op_create_replicated_pool(
+            name, replica_count=replica_count, pg_num=pg_num, weight=weight,
+            group=group, namespace=namespace, app_name=app_name,
+            max_bytes=max_bytes, max_objects=max_objects)
+
+    def add_op_create_replicated_pool(self, name, replica_count=3, pg_num=None,
+                                      weight=None, group=None, namespace=None,
+                                      app_name=None, max_bytes=None,
+                                      max_objects=None):
+        """Adds an operation to create a replicated pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param replica_count: Number of copies Ceph should keep of your data.
+        :type replica_count: int
+        :param pg_num: Request specific number of Placement Groups to create
+                       for pool.
+        :type pg_num: int
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+                       Used to calculate number of Placement Groups to create
+                       for pool.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param namespace: Group namespace
+        :type namespace: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        if pg_num and weight:
+            raise ValueError('pg_num and weight are mutually exclusive')
+
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'replicas': replica_count, 'pg_num': pg_num,
+                     'weight': weight, 'group': group,
+                     'group-namespace': namespace, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def add_op_create_erasure_pool(self, name, erasure_profile=None,
+                                   weight=None, group=None, app_name=None,
+                                   max_bytes=None, max_objects=None):
+        """Adds an operation to create a erasure coded pool.
+
+        :param name: Name of pool to create
+        :type name: str
+        :param erasure_profile: Name of erasure code profile to use.  If not
+                                set the ceph-mon unit handling the broker
+                                request will set its default value.
+        :type erasure_profile: str
+        :param weight: The percentage of data that is expected to be contained
+                       in the pool from the total available space on the OSDs.
+        :type weight: float
+        :param group: Group to add pool to
+        :type group: str
+        :param app_name: (Optional) Tag pool with application name.  Note that
+                         there is certain protocols emerging upstream with
+                         regard to meaningful application names to use.
+                         Examples are ``rbd`` and ``rgw``.
+        :type app_name: str
+        :param max_bytes: Maximum bytes quota to apply
+        :type max_bytes: int
+        :param max_objects: Maximum objects quota to apply
+        :type max_objects: int
+        """
+        self.add_op({'op': 'create-pool', 'name': name,
+                     'pool-type': 'erasure',
+                     'erasure-profile': erasure_profile,
+                     'weight': weight,
+                     'group': group, 'app-name': app_name,
+                     'max-bytes': max_bytes, 'max-objects': max_objects})
+
+    def set_ops(self, ops):
+        """Set request ops to provided value.
+
+        Useful for injecting ops that come from a previous request
+        to allow comparisons to ensure validity.
+        """
+        self.ops = ops
+
+    @property
+    def request(self):
+        return json.dumps({'api-version': self.api_version, 'ops': self.ops,
+                           'request-id': self.request_id})
+
+    def _ops_equal(self, other):
+        if len(self.ops) == len(other.ops):
+            for req_no in range(0, len(self.ops)):
+                for key in [
+                        'replicas', 'name', 'op', 'pg_num', 'weight',
+                        'group', 'group-namespace', 'group-permission',
+                        'object-prefix-permissions']:
+                    if self.ops[req_no].get(key) != other.ops[req_no].get(key):
+                        return False
+        else:
+            return False
+        return True
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        if self.api_version == other.api_version and \
+                self._ops_equal(other):
+            return True
+        else:
+            return False
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+
+class CephBrokerRsp(object):
+    """Ceph broker response.
+
+    Response is json-decoded and contents provided as methods/properties.
+
+    The API is versioned and defaults to version 1.
+    """
+
+    def __init__(self, encoded_rsp):
+        self.api_version = None
+        self.rsp = json.loads(encoded_rsp)
+
+    @property
+    def request_id(self):
+        return self.rsp.get('request-id')
+
+    @property
+    def exit_code(self):
+        return self.rsp.get('exit-code')
+
+    @property
+    def exit_msg(self):
+        return self.rsp.get('stderr')
+
+
+# Ceph Broker Conversation:
+# If a charm needs an action to be taken by ceph it can create a CephBrokerRq
+# and send that request to ceph via the ceph relation. The CephBrokerRq has a
+# unique id so that the client can identity which CephBrokerRsp is associated
+# with the request. Ceph will also respond to each client unit individually
+# creating a response key per client unit eg glance/0 will get a CephBrokerRsp
+# via key broker-rsp-glance-0
+#
+# To use this the charm can just do something like:
+#
+# from charmhelpers.contrib.storage.linux.ceph import (
+#     send_request_if_needed,
+#     is_request_complete,
+#     CephBrokerRq,
+# )
+#
+# @hooks.hook('ceph-relation-changed')
+# def ceph_changed():
+#     rq = CephBrokerRq()
+#     rq.add_op_create_pool(name='poolname', replica_count=3)
+#
+#     if is_request_complete(rq):
+#         <Request complete actions>
+#     else:
+#         send_request_if_needed(get_ceph_request())
+#
+# CephBrokerRq and CephBrokerRsp are serialized into JSON. Below is an example
+# of glance having sent a request to ceph which ceph has successfully processed
+#  'ceph:8': {
+#      'ceph/0': {
+#          'auth': 'cephx',
+#          'broker-rsp-glance-0': '{"request-id": "0bc7dc54", "exit-code": 0}',
+#          'broker_rsp': '{"request-id": "0da543b8", "exit-code": 0}',
+#          'ceph-public-address': '10.5.44.103',
+#          'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+#          'private-address': '10.5.44.103',
+#      },
+#      'glance/0': {
+#          'broker_req': ('{"api-version": 1, "request-id": "0bc7dc54", '
+#                         '"ops": [{"replicas": 3, "name": "glance", '
+#                         '"op": "create-pool"}]}'),
+#          'private-address': '10.5.44.109',
+#      },
+#  }
+
+def get_previous_request(rid):
+    """Return the last ceph broker request sent on a given relation
+
+    @param rid: Relation id to query for request
+    """
+    request = None
+    broker_req = relation_get(attribute='broker_req', rid=rid,
+                              unit=local_unit())
+    if broker_req:
+        request_data = json.loads(broker_req)
+        request = CephBrokerRq(api_version=request_data['api-version'],
+                               request_id=request_data['request-id'])
+        request.set_ops(request_data['ops'])
+
+    return request
+
+
+def get_request_states(request, relation='ceph'):
+    """Return a dict of requests per relation id with their corresponding
+       completion state.
+
+    This allows a charm, which has a request for ceph, to see whether there is
+    an equivalent request already being processed and if so what state that
+    request is in.
+
+    @param request: A CephBrokerRq object
+    """
+    complete = []
+    requests = {}
+    for rid in relation_ids(relation):
+        complete = False
+        previous_request = get_previous_request(rid)
+        if request == previous_request:
+            sent = True
+            complete = is_request_complete_for_rid(previous_request, rid)
+        else:
+            sent = False
+            complete = False
+
+        requests[rid] = {
+            'sent': sent,
+            'complete': complete,
+        }
+
+    return requests
+
+
+def is_request_sent(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been sent
+
+    Returns True if a similair request has been sent
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['sent']:
+            return False
+
+    return True
+
+
+def is_request_complete(request, relation='ceph'):
+    """Check to see if a functionally equivalent request has already been
+    completed
+
+    Returns True if a similair request has been completed
+
+    @param request: A CephBrokerRq object
+    """
+    states = get_request_states(request, relation=relation)
+    for rid in states.keys():
+        if not states[rid]['complete']:
+            return False
+
+    return True
+
+
+def is_request_complete_for_rid(request, rid):
+    """Check if a given request has been completed on the given relation
+
+    @param request: A CephBrokerRq object
+    @param rid: Relation ID
+    """
+    broker_key = get_broker_rsp_key()
+    for unit in related_units(rid):
+        rdata = relation_get(rid=rid, unit=unit)
+        if rdata.get(broker_key):
+            rsp = CephBrokerRsp(rdata.get(broker_key))
+            if rsp.request_id == request.request_id:
+                if not rsp.exit_code:
+                    return True
+        else:
+            # The remote unit sent no reply targeted at this unit so either the
+            # remote ceph cluster does not support unit targeted replies or it
+            # has not processed our request yet.
+            if rdata.get('broker_rsp'):
+                request_data = json.loads(rdata['broker_rsp'])
+                if request_data.get('request-id'):
+                    log('Ignoring legacy broker_rsp without unit key as remote '
+                        'service supports unit specific replies', level=DEBUG)
+                else:
+                    log('Using legacy broker_rsp as remote service does not '
+                        'supports unit specific replies', level=DEBUG)
+                    rsp = CephBrokerRsp(rdata['broker_rsp'])
+                    if not rsp.exit_code:
+                        return True
+
+    return False
+
+
+def get_broker_rsp_key():
+    """Return broker response key for this unit
+
+    This is the key that ceph is going to use to pass request status
+    information back to this unit
+    """
+    return 'broker-rsp-' + local_unit().replace('/', '-')
+
+
+def send_request_if_needed(request, relation='ceph'):
+    """Send broker request if an equivalent request has not already been sent
+
+    @param request: A CephBrokerRq object
+    """
+    if is_request_sent(request, relation=relation):
+        log('Request already sent but not complete, not sending new request',
+            level=DEBUG)
+    else:
+        for rid in relation_ids(relation):
+            log('Sending request {}'.format(request.request_id), level=DEBUG)
+            relation_set(relation_id=rid, broker_req=request.request)
+
+
+def has_broker_rsp(rid=None, unit=None):
+    """Return True if the broker_rsp key is 'truthy' (i.e. set to something) in the relation data.
+
+    :param rid: The relation to check (default of None means current relation)
+    :type rid: Union[str, None]
+    :param unit: The remote unit to check (default of None means current unit)
+    :type unit: Union[str, None]
+    :returns: True if broker key exists and is set to something 'truthy'
+    :rtype: bool
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    return True if broker_rsp else False
+
+
+def is_broker_action_done(action, rid=None, unit=None):
+    """Check whether broker action has completed yet.
+
+    @param action: name of action to be performed
+    @returns True if action complete otherwise False
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return False
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    val = kvstore.get(key=key)
+    if val and val == rsp.request_id:
+        return True
+
+    return False
+
+
+def mark_broker_action_done(action, rid=None, unit=None):
+    """Mark action as having been completed.
+
+    @param action: name of action to be performed
+    @returns None
+    """
+    rdata = relation_get(rid=rid, unit=unit) or {}
+    broker_rsp = rdata.get(get_broker_rsp_key())
+    if not broker_rsp:
+        return
+
+    rsp = CephBrokerRsp(broker_rsp)
+    unit_name = local_unit().partition('/')[2]
+    key = "unit_{}_ceph_broker_action.{}".format(unit_name, action)
+    kvstore = kv()
+    kvstore.set(key=key, value=rsp.request_id)
+    kvstore.flush()
+
+
+class CephConfContext(object):
+    """Ceph config (ceph.conf) context.
+
+    Supports user-provided Ceph configuration settings. Use can provide a
+    dictionary as the value for the config-flags charm option containing
+    Ceph configuration settings keyede by their section in ceph.conf.
+    """
+    def __init__(self, permitted_sections=None):
+        self.permitted_sections = permitted_sections or []
+
+    def __call__(self):
+        conf = config('config-flags')
+        if not conf:
+            return {}
+
+        conf = config_flags_parser(conf)
+        if not isinstance(conf, dict):
+            log("Provided config-flags is not a dictionary - ignoring",
+                level=WARNING)
+            return {}
+
+        permitted = self.permitted_sections
+        if permitted:
+            diff = set(conf.keys()).difference(set(permitted))
+            if diff:
+                log("Config-flags contains invalid keys '%s' - they will be "
+                    "ignored" % (', '.join(diff)), level=WARNING)
+
+        ceph_conf = {}
+        for key in conf:
+            if permitted and key not in permitted:
+                log("Ignoring key '%s'" % key, level=WARNING)
+                continue
+
+            ceph_conf[key] = conf[key]
+        return ceph_conf
+
+
+class CephOSDConfContext(CephConfContext):
+    """Ceph config (ceph.conf) context.
+
+    Consolidates settings from config-flags via CephConfContext with
+    settings provided by the mons. The config-flag values are preserved in
+    conf['osd'], settings from the mons which do not clash with config-flag
+    settings are in conf['osd_from_client'] and finally settings which do
+    clash are in conf['osd_from_client_conflict']. Rather than silently drop
+    the conflicting settings they are provided in the context so they can be
+    rendered commented out to give some visability to the admin.
+    """
+
+    def __init__(self, permitted_sections=None):
+        super(CephOSDConfContext, self).__init__(
+            permitted_sections=permitted_sections)
+        try:
+            self.settings_from_mons = get_osd_settings('mon')
+        except OSDSettingConflict:
+            log(
+                "OSD settings from mons are inconsistent, ignoring them",
+                level=WARNING)
+            self.settings_from_mons = {}
+
+    def filter_osd_from_mon_settings(self):
+        """Filter settings from client relation against config-flags.
+
+        :returns: A tuple (
+            ,config-flag values,
+            ,client settings which do not conflict with config-flag values,
+            ,client settings which confilct with config-flag values)
+        :rtype: (OrderedDict, OrderedDict, OrderedDict)
+        """
+        ceph_conf = super(CephOSDConfContext, self).__call__()
+        conflicting_entries = {}
+        clear_entries = {}
+        for key, value in self.settings_from_mons.items():
+            if key in ceph_conf.get('osd', {}):
+                if ceph_conf['osd'][key] != value:
+                    conflicting_entries[key] = value
+            else:
+                clear_entries[key] = value
+        clear_entries = _order_dict_by_key(clear_entries)
+        conflicting_entries = _order_dict_by_key(conflicting_entries)
+        return ceph_conf, clear_entries, conflicting_entries
+
+    def __call__(self):
+        """Construct OSD config context.
+
+        Standard context with two additional special keys.
+            osd_from_client_conflict: client settings which confilct with
+                                      config-flag values
+            osd_from_client: settings which do not conflict with config-flag
+                             values
+
+        :returns: OSD config context dict.
+        :rtype: dict
+        """
+        conf, osd_clear, osd_conflict = self.filter_osd_from_mon_settings()
+        conf['osd_from_client_conflict'] = osd_conflict
+        conf['osd_from_client'] = osd_clear
+        return conf
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/loopback.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/loopback.py
new file mode 100644
index 0000000000000000000000000000000000000000..74bab40e43a978e3d9e1e2f9c8975368092145c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/loopback.py
@@ -0,0 +1,92 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from subprocess import (
+    check_call,
+    check_output,
+)
+
+import six
+
+
+##################################################
+# loopback device helpers.
+##################################################
+def loopback_devices():
+    '''
+    Parse through 'losetup -a' output to determine currently mapped
+    loopback devices. Output is expected to look like:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img)
+
+    or:
+
+        /dev/loop0: [0807]:961814 (/tmp/my.img (deleted))
+
+    :returns: dict: a dict mapping {loopback_dev: backing_file}
+    '''
+    loopbacks = {}
+    cmd = ['losetup', '-a']
+    output = check_output(cmd)
+    if six.PY3:
+        output = output.decode('utf-8')
+    devs = [d.strip().split(' ', 2) for d in output.splitlines() if d != '']
+    for dev, _, f in devs:
+        loopbacks[dev.replace(':', '')] = re.search(r'\((.+)\)', f).groups()[0]
+    return loopbacks
+
+
+def create_loopback(file_path):
+    '''
+    Create a loopback device for a given backing file.
+
+    :returns: str: Full path to new loopback device (eg, /dev/loop0)
+    '''
+    file_path = os.path.abspath(file_path)
+    check_call(['losetup', '--find', file_path])
+    for d, f in six.iteritems(loopback_devices()):
+        if f == file_path:
+            return d
+
+
+def ensure_loopback_device(path, size):
+    '''
+    Ensure a loopback device exists for a given backing file path and size.
+    If it a loopback device is not mapped to file, a new one will be created.
+
+    TODO: Confirm size of found loopback device.
+
+    :returns: str: Full path to the ensured loopback device (eg, /dev/loop0)
+    '''
+    for d, f in six.iteritems(loopback_devices()):
+        if f == path:
+            return d
+
+    if not os.path.exists(path):
+        cmd = ['truncate', '--size', size, path]
+        check_call(cmd)
+
+    return create_loopback(path)
+
+
+def is_mapped_loopback_device(device):
+    """
+    Checks if a given device name is an existing/mapped loopback device.
+    :param device: str: Full path to the device (eg, /dev/loop1).
+    :returns: str: Path to the backing file if is a loopback device
+    empty string otherwise
+    """
+    return loopback_devices().get(device, "")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/lvm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/lvm.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8bde69263f0e917d32d0e5d70abba1409b26012
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/lvm.py
@@ -0,0 +1,182 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import functools
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    Popen,
+    PIPE,
+)
+
+
+##################################################
+# LVM helpers.
+##################################################
+def deactivate_lvm_volume_group(block_device):
+    '''
+    Deactivate any volume gruop associated with an LVM physical volume.
+
+    :param block_device: str: Full path to LVM physical volume
+    '''
+    vg = list_lvm_volume_group(block_device)
+    if vg:
+        cmd = ['vgchange', '-an', vg]
+        check_call(cmd)
+
+
+def is_lvm_physical_volume(block_device):
+    '''
+    Determine whether a block device is initialized as an LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: boolean: True if block device is a PV, False if not.
+    '''
+    try:
+        check_output(['pvdisplay', block_device])
+        return True
+    except CalledProcessError:
+        return False
+
+
+def remove_lvm_physical_volume(block_device):
+    '''
+    Remove LVM PV signatures from a given block device.
+
+    :param block_device: str: Full path of block device to scrub.
+    '''
+    p = Popen(['pvremove', '-ff', block_device],
+              stdin=PIPE)
+    p.communicate(input='y\n')
+
+
+def list_lvm_volume_group(block_device):
+    '''
+    List LVM volume group associated with a given block device.
+
+    Assumes block device is a valid LVM PV.
+
+    :param block_device: str: Full path of block device to inspect.
+
+    :returns: str: Name of volume group associated with block device or None
+    '''
+    vg = None
+    pvd = check_output(['pvdisplay', block_device]).splitlines()
+    for lvm in pvd:
+        lvm = lvm.decode('UTF-8')
+        if lvm.strip().startswith('VG Name'):
+            vg = ' '.join(lvm.strip().split()[2:])
+    return vg
+
+
+def create_lvm_physical_volume(block_device):
+    '''
+    Initialize a block device as an LVM physical volume.
+
+    :param block_device: str: Full path of block device to initialize.
+
+    '''
+    check_call(['pvcreate', block_device])
+
+
+def create_lvm_volume_group(volume_group, block_device):
+    '''
+    Create an LVM volume group backed by a given block device.
+
+    Assumes block device has already been initialized as an LVM PV.
+
+    :param volume_group: str: Name of volume group to create.
+    :block_device: str: Full path of PV-initialized block device.
+    '''
+    check_call(['vgcreate', volume_group, block_device])
+
+
+def list_logical_volumes(select_criteria=None, path_mode=False):
+    '''
+    List logical volumes
+
+    :param select_criteria: str: Limit list to those volumes matching this
+                                 criteria (see 'lvs -S help' for more details)
+    :param path_mode: bool: return logical volume name in 'vg/lv' format, this
+                            format is required for some commands like lvextend
+    :returns: [str]: List of logical volumes
+    '''
+    lv_diplay_attr = 'lv_name'
+    if path_mode:
+        # Parsing output logic relies on the column order
+        lv_diplay_attr = 'vg_name,' + lv_diplay_attr
+    cmd = ['lvs', '--options', lv_diplay_attr, '--noheadings']
+    if select_criteria:
+        cmd.extend(['--select', select_criteria])
+    lvs = []
+    for lv in check_output(cmd).decode('UTF-8').splitlines():
+        if not lv:
+            continue
+        if path_mode:
+            lvs.append('/'.join(lv.strip().split()))
+        else:
+            lvs.append(lv.strip())
+    return lvs
+
+
+list_thin_logical_volume_pools = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^t')
+
+list_thin_logical_volumes = functools.partial(
+    list_logical_volumes,
+    select_criteria='lv_attr =~ ^V')
+
+
+def extend_logical_volume_by_device(lv_name, block_device):
+    '''
+    Extends the size of logical volume lv_name by the amount of free space on
+    physical volume block_device.
+
+    :param lv_name: str: name of logical volume to be extended (vg/lv format)
+    :param block_device: str: name of block_device to be allocated to lv_name
+    '''
+    cmd = ['lvextend', lv_name, block_device]
+    check_call(cmd)
+
+
+def create_logical_volume(lv_name, volume_group, size=None):
+    '''
+    Create a new logical volume in an existing volume group
+
+    :param lv_name: str: name of logical volume to be created.
+    :param volume_group: str: Name of volume group to use for the new volume.
+    :param size: str: Size of logical volume to create (100% if not supplied)
+    :raises subprocess.CalledProcessError: in the event that the lvcreate fails.
+    '''
+    if size:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-L',
+            '{}'.format(size),
+            '-n', lv_name, volume_group
+        ])
+    # create the lv with all the space available, this is needed because the
+    # system call is different for LVM
+    else:
+        check_call([
+            'lvcreate',
+            '--yes',
+            '-l',
+            '100%FREE',
+            '-n', lv_name, volume_group
+        ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a35617606cf52d7cffc04ac245811b770fd95e8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/storage/linux/utils.py
@@ -0,0 +1,128 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from stat import S_ISBLK
+
+from subprocess import (
+    CalledProcessError,
+    check_call,
+    check_output,
+    call
+)
+
+
+def _luks_uuid(dev):
+    """
+    Check to see if dev is a LUKS encrypted volume, returning the UUID
+    of volume if it is.
+
+    :param: dev: path to block device to check.
+    :returns: str. UUID of LUKS device or None if not a LUKS device
+    """
+    try:
+        cmd = ['cryptsetup', 'luksUUID', dev]
+        return check_output(cmd).decode('UTF-8').strip()
+    except CalledProcessError:
+        return None
+
+
+def is_luks_device(dev):
+    """
+    Determine if dev is a LUKS-formatted block device.
+
+    :param: dev: A full path to a block device to check for LUKS header
+    presence
+    :returns: boolean: indicates whether a device is used based on LUKS header.
+    """
+    return True if _luks_uuid(dev) else False
+
+
+def is_mapped_luks_device(dev):
+    """
+    Determine if dev is a mapped LUKS device
+    :param: dev: A full path to a block device to be checked
+    :returns: boolean: indicates whether a device is mapped
+    """
+    _, dirs, _ = next(os.walk(
+        '/sys/class/block/{}/holders/'
+        .format(os.path.basename(os.path.realpath(dev))))
+    )
+    is_held = len(dirs) > 0
+    return is_held and is_luks_device(dev)
+
+
+def is_block_device(path):
+    '''
+    Confirm device at path is a valid block device node.
+
+    :returns: boolean: True if path is a block device, False if not.
+    '''
+    if not os.path.exists(path):
+        return False
+    return S_ISBLK(os.stat(path).st_mode)
+
+
+def zap_disk(block_device):
+    '''
+    Clear a block device of partition table. Relies on sgdisk, which is
+    installed as pat of the 'gdisk' package in Ubuntu.
+
+    :param block_device: str: Full path of block device to clean.
+    '''
+    # https://github.com/ceph/ceph/commit/fdd7f8d83afa25c4e09aaedd90ab93f3b64a677b
+    # sometimes sgdisk exits non-zero; this is OK, dd will clean up
+    call(['sgdisk', '--zap-all', '--', block_device])
+    call(['sgdisk', '--clear', '--mbrtogpt', '--', block_device])
+    dev_end = check_output(['blockdev', '--getsz',
+                            block_device]).decode('UTF-8')
+    gpt_end = int(dev_end.split()[0]) - 100
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=1M', 'count=1'])
+    check_call(['dd', 'if=/dev/zero', 'of=%s' % (block_device),
+                'bs=512', 'count=100', 'seek=%s' % (gpt_end)])
+
+
+def is_device_mounted(device):
+    '''Given a device path, return True if that device is mounted, and False
+    if it isn't.
+
+    :param device: str: Full path of the device to check.
+    :returns: boolean: True if the path represents a mounted device, False if
+        it doesn't.
+    '''
+    try:
+        out = check_output(['lsblk', '-P', device]).decode('UTF-8')
+    except Exception:
+        return False
+    return bool(re.search(r'MOUNTPOINT=".+"', out))
+
+
+def mkfs_xfs(device, force=False, inode_size=1024):
+    """Format device with XFS filesystem.
+
+    By default this should fail if the device already has a filesystem on it.
+    :param device: Full path to device to format
+    :ptype device: tr
+    :param force: Force operation
+    :ptype: force: boolean
+    :param inode_size: XFS inode size in bytes
+    :ptype inode_size: int"""
+    cmd = ['mkfs.xfs']
+    if force:
+        cmd.append("-f")
+
+    cmd += ['-i', "size={}".format(inode_size), device]
+    check_call(cmd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/contexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/contexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1adf94b133f41a168727a3cdd3a536633ff62b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/contexts.py
@@ -0,0 +1,137 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+"""A helper to create a yaml cache of config with namespaced relation data."""
+import os
+import yaml
+
+import six
+
+import charmhelpers.core.hookenv
+
+
+charm_dir = os.environ.get('CHARM_DIR', '')
+
+
+def dict_keys_without_hyphens(a_dict):
+    """Return the a new dict with underscores instead of hyphens in keys."""
+    return dict(
+        (key.replace('-', '_'), val) for key, val in a_dict.items())
+
+
+def update_relations(context, namespace_separator=':'):
+    """Update the context with the relation data."""
+    # Add any relation data prefixed with the relation type.
+    relation_type = charmhelpers.core.hookenv.relation_type()
+    relations = []
+    context['current_relation'] = {}
+    if relation_type is not None:
+        relation_data = charmhelpers.core.hookenv.relation_get()
+        context['current_relation'] = relation_data
+        # Deprecated: the following use of relation data as keys
+        # directly in the context will be removed.
+        relation_data = dict(
+            ("{relation_type}{namespace_separator}{key}".format(
+                relation_type=relation_type,
+                key=key,
+                namespace_separator=namespace_separator), val)
+            for key, val in relation_data.items())
+        relation_data = dict_keys_without_hyphens(relation_data)
+        context.update(relation_data)
+        relations = charmhelpers.core.hookenv.relations_of_type(relation_type)
+        relations = [dict_keys_without_hyphens(rel) for rel in relations]
+
+    context['relations_full'] = charmhelpers.core.hookenv.relations()
+
+    # the hookenv.relations() data structure is effectively unusable in
+    # templates and other contexts when trying to access relation data other
+    # than the current relation. So provide a more useful structure that works
+    # with any hook.
+    local_unit = charmhelpers.core.hookenv.local_unit()
+    relations = {}
+    for rname, rids in context['relations_full'].items():
+        relations[rname] = []
+        for rid, rdata in rids.items():
+            data = rdata.copy()
+            if local_unit in rdata:
+                data.pop(local_unit)
+            for unit_name, rel_data in data.items():
+                new_data = {'__relid__': rid, '__unit__': unit_name}
+                new_data.update(rel_data)
+                relations[rname].append(new_data)
+    context['relations'] = relations
+
+
+def juju_state_to_yaml(yaml_path, namespace_separator=':',
+                       allow_hyphens_in_keys=True, mode=None):
+    """Update the juju config and state in a yaml file.
+
+    This includes any current relation-get data, and the charm
+    directory.
+
+    This function was created for the ansible and saltstack
+    support, as those libraries can use a yaml file to supply
+    context to templates, but it may be useful generally to
+    create and update an on-disk cache of all the config, including
+    previous relation data.
+
+    By default, hyphens are allowed in keys as this is supported
+    by yaml, but for tools like ansible, hyphens are not valid [1].
+
+    [1] http://www.ansibleworks.com/docs/playbooks_variables.html#what-makes-a-valid-variable-name
+    """
+    config = charmhelpers.core.hookenv.config()
+
+    # Add the charm_dir which we will need to refer to charm
+    # file resources etc.
+    config['charm_dir'] = charm_dir
+    config['local_unit'] = charmhelpers.core.hookenv.local_unit()
+    config['unit_private_address'] = charmhelpers.core.hookenv.unit_private_ip()
+    config['unit_public_address'] = charmhelpers.core.hookenv.unit_get(
+        'public-address'
+    )
+
+    # Don't use non-standard tags for unicode which will not
+    # work when salt uses yaml.load_safe.
+    yaml.add_representer(six.text_type,
+                         lambda dumper, value: dumper.represent_scalar(
+                             six.u('tag:yaml.org,2002:str'), value))
+
+    yaml_dir = os.path.dirname(yaml_path)
+    if not os.path.exists(yaml_dir):
+        os.makedirs(yaml_dir)
+
+    if os.path.exists(yaml_path):
+        with open(yaml_path, "r") as existing_vars_file:
+            existing_vars = yaml.load(existing_vars_file.read())
+    else:
+        with open(yaml_path, "w+"):
+            pass
+        existing_vars = {}
+
+    if mode is not None:
+        os.chmod(yaml_path, mode)
+
+    if not allow_hyphens_in_keys:
+        config = dict_keys_without_hyphens(config)
+    existing_vars.update(config)
+
+    update_relations(existing_vars, namespace_separator)
+
+    with open(yaml_path, "w+") as fp:
+        fp.write(yaml.dump(existing_vars, default_flow_style=False))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/jinja.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/jinja.py
new file mode 100644
index 0000000000000000000000000000000000000000..38d4fba0e651399064a14112398a0ef43717f5cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/jinja.py
@@ -0,0 +1,38 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+Templating using the python-jinja2 package.
+"""
+import six
+from charmhelpers.fetch import apt_install, apt_update
+try:
+    import jinja2
+except ImportError:
+    apt_update(fatal=True)
+    if six.PY3:
+        apt_install(["python3-jinja2"], fatal=True)
+    else:
+        apt_install(["python-jinja2"], fatal=True)
+    import jinja2
+
+
+DEFAULT_TEMPLATES_DIR = 'templates'
+
+
+def render(template_name, context, template_dir=DEFAULT_TEMPLATES_DIR):
+    templates = jinja2.Environment(
+        loader=jinja2.FileSystemLoader(template_dir))
+    template = templates.get_template(template_name)
+    return template.render(context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/pyformat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/pyformat.py
new file mode 100644
index 0000000000000000000000000000000000000000..51a24dc42379fbee88d8952c578fc2498c852b0b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/templating/pyformat.py
@@ -0,0 +1,27 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+Templating using standard Python str.format() method.
+'''
+
+from charmhelpers.core import hookenv
+
+
+def render(template, extra={}, **kwargs):
+    """Return the template rendered using Python's str.format()."""
+    context = hookenv.execution_environment()
+    context.update(extra)
+    context.update(kwargs)
+    return template.format(**context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/unison/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/unison/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61409b14c843766aa10cb957bb1c3d83ba87c6a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/contrib/unison/__init__.py
@@ -0,0 +1,314 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Easy file synchronization among peer units using ssh + unison.
+#
+# For the -joined, -changed, and -departed peer relations, add a call to
+# ssh_authorized_peers() describing the peer relation and the desired
+# user + group.  After all peer relations have settled, all hosts should
+# be able to connect to on another via key auth'd ssh as the specified user.
+#
+# Other hooks are then free to synchronize files and directories using
+# sync_to_peers().
+#
+# For a peer relation named 'cluster', for example:
+#
+# cluster-relation-joined:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-changed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# cluster-relation-departed:
+# ...
+# ssh_authorized_peers(peer_interface='cluster',
+#                      user='juju_ssh', group='juju_ssh',
+#                      ensure_local_user=True)
+# ...
+#
+# Hooks are now free to sync files as easily as:
+#
+# files = ['/etc/fstab', '/etc/apt.conf.d/']
+# sync_to_peers(peer_interface='cluster',
+#                user='juju_ssh, paths=[files])
+#
+# It is assumed the charm itself has setup permissions on each unit
+# such that 'juju_ssh' has read + write permissions.  Also assumed
+# that the calling charm takes care of leader delegation.
+#
+# Additionally files can be synchronized only to an specific unit:
+# sync_to_peer(slave_address, user='juju_ssh',
+#              paths=[files], verbose=False)
+
+import os
+import pwd
+
+from copy import copy
+from subprocess import check_call, check_output
+
+from charmhelpers.core.host import (
+    adduser,
+    add_user_to_group,
+    pwgen,
+    remove_password_expiry,
+)
+
+from charmhelpers.core.hookenv import (
+    log,
+    hook_name,
+    relation_ids,
+    related_units,
+    relation_set,
+    relation_get,
+    unit_private_ip,
+    INFO,
+    ERROR,
+)
+
+BASE_CMD = ['unison', '-auto', '-batch=true', '-confirmbigdel=false',
+            '-fastcheck=true', '-group=false', '-owner=false',
+            '-prefer=newer', '-times=true']
+
+
+def get_homedir(user):
+    try:
+        user = pwd.getpwnam(user)
+        return user.pw_dir
+    except KeyError:
+        log('Could not get homedir for user %s: user exists?' % (user), ERROR)
+        raise Exception
+
+
+def create_private_key(user, priv_key_path, key_type='rsa'):
+    types_bits = {
+        'rsa': '2048',
+        'ecdsa': '521',
+    }
+    if key_type not in types_bits:
+        log('Unknown ssh key type {}, using rsa'.format(key_type), ERROR)
+        key_type = 'rsa'
+    if not os.path.isfile(priv_key_path):
+        log('Generating new SSH key for user %s.' % user)
+        cmd = ['ssh-keygen', '-q', '-N', '', '-t', key_type,
+               '-b', types_bits[key_type], '-f', priv_key_path]
+        check_call(cmd)
+    else:
+        log('SSH key already exists at %s.' % priv_key_path)
+    check_call(['chown', user, priv_key_path])
+    check_call(['chmod', '0600', priv_key_path])
+
+
+def create_public_key(user, priv_key_path, pub_key_path):
+    if not os.path.isfile(pub_key_path):
+        log('Generating missing ssh public key @ %s.' % pub_key_path)
+        cmd = ['ssh-keygen', '-y', '-f', priv_key_path]
+        p = check_output(cmd).strip()
+        with open(pub_key_path, 'wb') as out:
+            out.write(p)
+    check_call(['chown', user, pub_key_path])
+
+
+def get_keypair(user):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    priv_key = os.path.join(ssh_dir, 'id_rsa')
+    pub_key = '%s.pub' % priv_key
+
+    if not os.path.isdir(ssh_dir):
+        os.mkdir(ssh_dir)
+        check_call(['chown', '-R', user, ssh_dir])
+
+    create_private_key(user, priv_key)
+    create_public_key(user, priv_key, pub_key)
+
+    with open(priv_key, 'r') as p:
+        _priv = p.read().strip()
+
+    with open(pub_key, 'r') as p:
+        _pub = p.read().strip()
+
+    return (_priv, _pub)
+
+
+def write_authorized_keys(user, keys):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    auth_keys = os.path.join(ssh_dir, 'authorized_keys')
+    log('Syncing authorized_keys @ %s.' % auth_keys)
+    with open(auth_keys, 'w') as out:
+        for k in keys:
+            out.write('%s\n' % k)
+
+
+def write_known_hosts(user, hosts):
+    home_dir = get_homedir(user)
+    ssh_dir = os.path.join(home_dir, '.ssh')
+    known_hosts = os.path.join(ssh_dir, 'known_hosts')
+    khosts = []
+    for host in hosts:
+        cmd = ['ssh-keyscan', host]
+        remote_key = check_output(cmd, universal_newlines=True).strip()
+        khosts.append(remote_key)
+    log('Syncing known_hosts @ %s.' % known_hosts)
+    with open(known_hosts, 'w') as out:
+        for host in khosts:
+            out.write('%s\n' % host)
+
+
+def ensure_user(user, group=None):
+    adduser(user, pwgen())
+    if group:
+        add_user_to_group(user, group)
+    # Remove password expiry (Bug #1686085)
+    remove_password_expiry(user)
+
+
+def ssh_authorized_peers(peer_interface, user, group=None,
+                         ensure_local_user=False):
+    """
+    Main setup function, should be called from both peer -changed and -joined
+    hooks with the same parameters.
+    """
+    if ensure_local_user:
+        ensure_user(user, group)
+    priv_key, pub_key = get_keypair(user)
+    hook = hook_name()
+    if hook == '%s-relation-joined' % peer_interface:
+        relation_set(ssh_pub_key=pub_key)
+    elif hook == '%s-relation-changed' % peer_interface or \
+            hook == '%s-relation-departed' % peer_interface:
+        hosts = []
+        keys = []
+
+        for r_id in relation_ids(peer_interface):
+            for unit in related_units(r_id):
+                ssh_pub_key = relation_get('ssh_pub_key',
+                                           rid=r_id,
+                                           unit=unit)
+                priv_addr = relation_get('private-address',
+                                         rid=r_id,
+                                         unit=unit)
+                if ssh_pub_key:
+                    keys.append(ssh_pub_key)
+                    hosts.append(priv_addr)
+                else:
+                    log('ssh_authorized_peers(): ssh_pub_key '
+                        'missing for unit %s, skipping.' % unit)
+        write_authorized_keys(user, keys)
+        write_known_hosts(user, hosts)
+        authed_hosts = ':'.join(hosts)
+        relation_set(ssh_authorized_hosts=authed_hosts)
+
+
+def _run_as_user(user, gid=None):
+    try:
+        user = pwd.getpwnam(user)
+    except KeyError:
+        log('Invalid user: %s' % user)
+        raise Exception
+    uid = user.pw_uid
+    gid = gid or user.pw_gid
+    os.environ['HOME'] = user.pw_dir
+
+    def _inner():
+        os.setgid(gid)
+        os.setuid(uid)
+    return _inner
+
+
+def run_as_user(user, cmd, gid=None):
+    return check_output(cmd, preexec_fn=_run_as_user(user, gid), cwd='/')
+
+
+def collect_authed_hosts(peer_interface):
+    '''Iterate through the units on peer interface to find all that
+    have the calling host in its authorized hosts list'''
+    hosts = []
+    for r_id in (relation_ids(peer_interface) or []):
+        for unit in related_units(r_id):
+            private_addr = relation_get('private-address',
+                                        rid=r_id, unit=unit)
+            authed_hosts = relation_get('ssh_authorized_hosts',
+                                        rid=r_id, unit=unit)
+
+            if not authed_hosts:
+                log('Peer %s has not authorized *any* hosts yet, skipping.' %
+                    (unit), level=INFO)
+                continue
+
+            if unit_private_ip() in authed_hosts.split(':'):
+                hosts.append(private_addr)
+            else:
+                log('Peer %s has not authorized *this* host yet, skipping.' %
+                    (unit), level=INFO)
+    return hosts
+
+
+def sync_path_to_host(path, host, user, verbose=False, cmd=None, gid=None,
+                      fatal=False):
+    """Sync path to an specific peer host
+
+    Propagates exception if operation fails and fatal=True.
+    """
+    cmd = cmd or copy(BASE_CMD)
+    if not verbose:
+        cmd.append('-silent')
+
+    # removing trailing slash from directory paths, unison
+    # doesn't like these.
+    if path.endswith('/'):
+        path = path[:(len(path) - 1)]
+
+    cmd = cmd + [path, 'ssh://%s@%s/%s' % (user, host, path)]
+
+    try:
+        log('Syncing local path %s to %s@%s:%s' % (path, user, host, path))
+        run_as_user(user, cmd, gid)
+    except Exception:
+        log('Error syncing remote files')
+        if fatal:
+            raise
+
+
+def sync_to_peer(host, user, paths=None, verbose=False, cmd=None, gid=None,
+                 fatal=False):
+    """Sync paths to an specific peer host
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for p in paths:
+            sync_path_to_host(p, host, user, verbose, cmd, gid, fatal)
+
+
+def sync_to_peers(peer_interface, user, paths=None, verbose=False, cmd=None,
+                  gid=None, fatal=False):
+    """Sync all hosts to an specific path
+
+    The type of group is integer, it allows user has permissions to
+    operate a directory have a different group id with the user id.
+
+    Propagates exception if any operation fails and fatal=True.
+    """
+    if paths:
+        for host in collect_authed_hosts(peer_interface):
+            sync_to_peer(host, user, paths, verbose, cmd, gid, fatal)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/coordinator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/coordinator.py
new file mode 100644
index 0000000000000000000000000000000000000000..59bee3e5b320f6bffa0d89eef7a20888cddb0521
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/coordinator.py
@@ -0,0 +1,606 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+'''
+The coordinator module allows you to use Juju's leadership feature to
+coordinate operations between units of a service.
+
+Behavior is defined in subclasses of coordinator.BaseCoordinator.
+One implementation is provided (coordinator.Serial), which allows an
+operation to be run on a single unit at a time, on a first come, first
+served basis. You can trivially define more complex behavior by
+subclassing BaseCoordinator or Serial.
+
+:author: Stuart Bishop <stuart.bishop@canonical.com>
+
+
+Services Framework Usage
+========================
+
+Ensure a peers relation is defined in metadata.yaml. Instantiate a
+BaseCoordinator subclass before invoking ServiceManager.manage().
+Ensure that ServiceManager.manage() is wired up to the leader-elected,
+leader-settings-changed, peers relation-changed and peers
+relation-departed hooks in addition to any other hooks you need, or your
+service will deadlock.
+
+Ensure calls to acquire() are guarded, so that locks are only requested
+when they are really needed (and thus hooks only triggered when necessary).
+Failing to do this and calling acquire() unconditionally will put your unit
+into a hook loop. Calls to granted() do not need to be guarded.
+
+For example::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    def maybe_restart(servicename):
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart')
+        if serial.granted('restart'):
+            hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before manager.manage()
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+You can implement a similar pattern using a decorator. If the lock has
+not been granted, an attempt to acquire() it will be made if the guard
+function returns True. If the lock has been granted, the decorated function
+is run as normal::
+
+    from charmhelpers.core import hookenv, services
+    from charmhelpers import coordinator
+
+    serial = coordinator.Serial()  # Global, instatiated on module import.
+
+    def needs_restart():
+        [ ... Introspect state. Return True if restart is needed ... ]
+
+    @serial.require('restart', needs_restart)
+    def maybe_restart(servicename):
+        hookenv.service_restart(servicename)
+
+    services = [dict(service='servicename',
+                     data_ready=[maybe_restart])]
+
+    if __name__ == '__main__':
+        manager = services.ServiceManager(services)
+        manager.manage()
+
+
+Traditional Usage
+=================
+
+Ensure a peers relation is defined in metadata.yaml.
+
+If you are using charmhelpers.core.hookenv.Hooks, ensure that a
+BaseCoordinator subclass is instantiated before calling Hooks.execute.
+
+If you are not using charmhelpers.core.hookenv.Hooks, ensure
+that a BaseCoordinator subclass is instantiated and its handle()
+method called at the start of all your hooks.
+
+For example::
+
+    import sys
+    from charmhelpers.core import hookenv
+    from charmhelpers import coordinator
+
+    hooks = hookenv.Hooks()
+
+    def maybe_restart():
+        serial = coordinator.Serial()
+        if serial.granted('restart'):
+            hookenv.service_restart('myservice')
+
+    @hooks.hook
+    def config_changed():
+        update_config()
+        serial = coordinator.Serial()
+        if needs_restart():
+            serial.acquire('restart'):
+            maybe_restart()
+
+    # Cluster hooks must be wired up.
+    @hooks.hook('cluster-relation-changed', 'cluster-relation-departed')
+    def cluster_relation_changed():
+        maybe_restart()
+
+    # Leader hooks must be wired up.
+    @hooks.hook('leader-elected', 'leader-settings-changed')
+    def leader_settings_changed():
+        maybe_restart()
+
+    [ ... repeat for *all* other hooks you are using ... ]
+
+    if __name__ == '__main__':
+        _ = coordinator.Serial()  # Must instantiate before execute()
+        hooks.execute(sys.argv)
+
+
+You can also use the require decorator. If the lock has not been granted,
+an attempt to acquire() it will be made if the guard function returns True.
+If the lock has been granted, the decorated function is run as normal::
+
+    from charmhelpers.core import hookenv
+
+    hooks = hookenv.Hooks()
+    serial = coordinator.Serial()  # Must instantiate before execute()
+
+    @require('restart', needs_restart)
+    def maybe_restart():
+        hookenv.service_restart('myservice')
+
+    @hooks.hook('install', 'config-changed', 'upgrade-charm',
+                # Peers and leader hooks must be wired up.
+                'cluster-relation-changed', 'cluster-relation-departed',
+                'leader-elected', 'leader-settings-changed')
+    def default_hook():
+        [...]
+        maybe_restart()
+
+    if __name__ == '__main__':
+        hooks.execute()
+
+
+Details
+=======
+
+A simple API is provided similar to traditional locking APIs. A lock
+may be requested using the acquire() method, and the granted() method
+may be used do to check if a lock previously requested by acquire() has
+been granted. It doesn't matter how many times acquire() is called in a
+hook.
+
+Locks are released at the end of the hook they are acquired in. This may
+be the current hook if the unit is leader and the lock is free. It is
+more likely a future hook (probably leader-settings-changed, possibly
+the peers relation-changed or departed hook, potentially any hook).
+
+Whenever a charm needs to perform a coordinated action it will acquire()
+the lock and perform the action immediately if acquisition is
+successful. It will also need to perform the same action in every other
+hook if the lock has been granted.
+
+
+Grubby Details
+--------------
+
+Why do you need to be able to perform the same action in every hook?
+If the unit is the leader, then it may be able to grant its own lock
+and perform the action immediately in the source hook. If the unit is
+the leader and cannot immediately grant the lock, then its only
+guaranteed chance of acquiring the lock is in the peers relation-joined,
+relation-changed or peers relation-departed hooks when another unit has
+released it (the only channel to communicate to the leader is the peers
+relation). If the unit is not the leader, then it is unlikely the lock
+is granted in the source hook (a previous hook must have also made the
+request for this to happen). A non-leader is notified about the lock via
+leader settings. These changes may be visible in any hook, even before
+the leader-settings-changed hook has been invoked. Or the requesting
+unit may be promoted to leader after making a request, in which case the
+lock may be granted in leader-elected or in a future peers
+relation-changed or relation-departed hook.
+
+This could be simpler if leader-settings-changed was invoked on the
+leader. We could then never grant locks except in
+leader-settings-changed hooks giving one place for the operation to be
+performed. Unfortunately this is not the case with Juju 1.23 leadership.
+
+But of course, this doesn't really matter to most people as most people
+seem to prefer the Services Framework or similar reset-the-world
+approaches, rather than the twisty maze of attempting to deduce what
+should be done based on what hook happens to be running (which always
+seems to evolve into reset-the-world anyway when the charm grows beyond
+the trivial).
+
+I chose not to implement a callback model, where a callback was passed
+to acquire to be executed when the lock is granted, because the callback
+may become invalid between making the request and the lock being granted
+due to an upgrade-charm being run in the interim. And it would create
+restrictions, such no lambdas, callback defined at the top level of a
+module, etc. Still, we could implement it on top of what is here, eg.
+by adding a defer decorator that stores a pickle of itself to disk and
+have BaseCoordinator unpickle and execute them when the locks are granted.
+'''
+from datetime import datetime
+from functools import wraps
+import json
+import os.path
+
+from six import with_metaclass
+
+from charmhelpers.core import hookenv
+
+
+# We make BaseCoordinator and subclasses singletons, so that if we
+# need to spill to local storage then only a single instance does so,
+# rather than having multiple instances stomp over each other.
+class Singleton(type):
+    _instances = {}
+
+    def __call__(cls, *args, **kwargs):
+        if cls not in cls._instances:
+            cls._instances[cls] = super(Singleton, cls).__call__(*args,
+                                                                 **kwargs)
+        return cls._instances[cls]
+
+
+class BaseCoordinator(with_metaclass(Singleton, object)):
+    relid = None  # Peer relation-id, set by __init__
+    relname = None
+
+    grants = None  # self.grants[unit][lock] == timestamp
+    requests = None  # self.requests[unit][lock] == timestamp
+
+    def __init__(self, relation_key='coordinator', peer_relation_name=None):
+        '''Instatiate a Coordinator.
+
+        Data is stored on the peers relation and in leadership storage
+        under the provided relation_key.
+
+        The peers relation is identified by peer_relation_name, and defaults
+        to the first one found in metadata.yaml.
+        '''
+        # Most initialization is deferred, since invoking hook tools from
+        # the constructor makes testing hard.
+        self.key = relation_key
+        self.relname = peer_relation_name
+        hookenv.atstart(self.initialize)
+
+        # Ensure that handle() is called, without placing that burden on
+        # the charm author. They still need to do this manually if they
+        # are not using a hook framework.
+        hookenv.atstart(self.handle)
+
+    def initialize(self):
+        if self.requests is not None:
+            return  # Already initialized.
+
+        assert hookenv.has_juju_version('1.23'), 'Needs Juju 1.23+'
+
+        if self.relname is None:
+            self.relname = _implicit_peer_relation_name()
+
+        relids = hookenv.relation_ids(self.relname)
+        if relids:
+            self.relid = sorted(relids)[0]
+
+        # Load our state, from leadership, the peer relationship, and maybe
+        # local state as a fallback. Populates self.requests and self.grants.
+        self._load_state()
+        self._emit_state()
+
+        # Save our state if the hook completes successfully.
+        hookenv.atexit(self._save_state)
+
+        # Schedule release of granted locks for the end of the hook.
+        # This needs to be the last of our atexit callbacks to ensure
+        # it will be run first when the hook is complete, because there
+        # is no point mutating our state after it has been saved.
+        hookenv.atexit(self._release_granted)
+
+    def acquire(self, lock):
+        '''Acquire the named lock, non-blocking.
+
+        The lock may be granted immediately, or in a future hook.
+
+        Returns True if the lock has been granted. The lock will be
+        automatically released at the end of the hook in which it is
+        granted.
+
+        Do not mindlessly call this method, as it triggers a cascade of
+        hooks. For example, if you call acquire() every time in your
+        peers relation-changed hook you will end up with an infinite loop
+        of hooks. It should almost always be guarded by some condition.
+        '''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if not ts:
+            # If there is no outstanding request on the peers relation,
+            # create one.
+            self.requests.setdefault(lock, {})
+            self.requests[unit][lock] = _timestamp()
+            self.msg('Requested {}'.format(lock))
+
+        # If the leader has granted the lock, yay.
+        if self.granted(lock):
+            self.msg('Acquired {}'.format(lock))
+            return True
+
+        # If the unit making the request also happens to be the
+        # leader, it must handle the request now. Even though the
+        # request has been stored on the peers relation, the peers
+        # relation-changed hook will not be triggered.
+        if hookenv.is_leader():
+            return self.grant(lock, unit)
+
+        return False  # Can't acquire lock, yet. Maybe next hook.
+
+    def granted(self, lock):
+        '''Return True if a previously requested lock has been granted'''
+        unit = hookenv.local_unit()
+        ts = self.requests[unit].get(lock)
+        if ts and self.grants.get(unit, {}).get(lock) == ts:
+            return True
+        return False
+
+    def requested(self, lock):
+        '''Return True if we are in the queue for the lock'''
+        return lock in self.requests[hookenv.local_unit()]
+
+    def request_timestamp(self, lock):
+        '''Return the timestamp of our outstanding request for lock, or None.
+
+        Returns a datetime.datetime() UTC timestamp, with no tzinfo attribute.
+        '''
+        ts = self.requests[hookenv.local_unit()].get(lock, None)
+        if ts is not None:
+            return datetime.strptime(ts, _timestamp_format)
+
+    def handle(self):
+        if not hookenv.is_leader():
+            return  # Only the leader can grant requests.
+
+        self.msg('Leader handling coordinator requests')
+
+        # Clear our grants that have been released.
+        for unit in self.grants.keys():
+            for lock, grant_ts in list(self.grants[unit].items()):
+                req_ts = self.requests.get(unit, {}).get(lock)
+                if req_ts != grant_ts:
+                    # The request timestamp does not match the granted
+                    # timestamp. Several hooks on 'unit' may have run
+                    # before the leader got a chance to make a decision,
+                    # and 'unit' may have released its lock and attempted
+                    # to reacquire it. This will change the timestamp,
+                    # and we correctly revoke the old grant putting it
+                    # to the end of the queue.
+                    ts = datetime.strptime(self.grants[unit][lock],
+                                           _timestamp_format)
+                    del self.grants[unit][lock]
+                    self.released(unit, lock, ts)
+
+        # Grant locks
+        for unit in self.requests.keys():
+            for lock in self.requests[unit]:
+                self.grant(lock, unit)
+
+    def grant(self, lock, unit):
+        '''Maybe grant the lock to a unit.
+
+        The decision to grant the lock or not is made for $lock
+        by a corresponding method grant_$lock, which you may define
+        in a subclass. If no such method is defined, the default_grant
+        method is used. See Serial.default_grant() for details.
+        '''
+        if not hookenv.is_leader():
+            return False  # Not the leader, so we cannot grant.
+
+        # Set of units already granted the lock.
+        granted = set()
+        for u in self.grants:
+            if lock in self.grants[u]:
+                granted.add(u)
+        if unit in granted:
+            return True  # Already granted.
+
+        # Ordered list of units waiting for the lock.
+        reqs = set()
+        for u in self.requests:
+            if u in granted:
+                continue  # In the granted set. Not wanted in the req list.
+            for _lock, ts in self.requests[u].items():
+                if _lock == lock:
+                    reqs.add((ts, u))
+        queue = [t[1] for t in sorted(reqs)]
+        if unit not in queue:
+            return False  # Unit has not requested the lock.
+
+        # Locate custom logic, or fallback to the default.
+        grant_func = getattr(self, 'grant_{}'.format(lock), self.default_grant)
+
+        if grant_func(lock, unit, granted, queue):
+            # Grant the lock.
+            self.msg('Leader grants {} to {}'.format(lock, unit))
+            self.grants.setdefault(unit, {})[lock] = self.requests[unit][lock]
+            return True
+
+        return False
+
+    def released(self, unit, lock, timestamp):
+        '''Called on the leader when it has released a lock.
+
+        By default, does nothing but log messages. Override if you
+        need to perform additional housekeeping when a lock is released,
+        for example recording timestamps.
+        '''
+        interval = _utcnow() - timestamp
+        self.msg('Leader released {} from {}, held {}'.format(lock, unit,
+                                                              interval))
+
+    def require(self, lock, guard_func, *guard_args, **guard_kw):
+        """Decorate a function to be run only when a lock is acquired.
+
+        The lock is requested if the guard function returns True.
+
+        The decorated function is called if the lock has been granted.
+        """
+        def decorator(f):
+            @wraps(f)
+            def wrapper(*args, **kw):
+                if self.granted(lock):
+                    self.msg('Granted {}'.format(lock))
+                    return f(*args, **kw)
+                if guard_func(*guard_args, **guard_kw) and self.acquire(lock):
+                    return f(*args, **kw)
+                return None
+            return wrapper
+        return decorator
+
+    def msg(self, msg):
+        '''Emit a message. Override to customize log spam.'''
+        hookenv.log('coordinator.{} {}'.format(self._name(), msg),
+                    level=hookenv.INFO)
+
+    def _name(self):
+        return self.__class__.__name__
+
+    def _load_state(self):
+        self.msg('Loading state')
+
+        # All responses must be stored in the leadership settings.
+        # The leader cannot use local state, as a different unit may
+        # be leader next time. Which is fine, as the leadership
+        # settings are always available.
+        self.grants = json.loads(hookenv.leader_get(self.key) or '{}')
+
+        local_unit = hookenv.local_unit()
+
+        # All requests must be stored on the peers relation. This is
+        # the only channel units have to communicate with the leader.
+        # Even the leader needs to store its requests here, as a
+        # different unit may be leader by the time the request can be
+        # granted.
+        if self.relid is None:
+            # The peers relation is not available. Maybe we are early in
+            # the units's lifecycle. Maybe this unit is standalone.
+            # Fallback to using local state.
+            self.msg('No peer relation. Loading local state')
+            self.requests = {local_unit: self._load_local_state()}
+        else:
+            self.requests = self._load_peer_state()
+            if local_unit not in self.requests:
+                # The peers relation has just been joined. Update any state
+                # loaded from our peers with our local state.
+                self.msg('New peer relation. Merging local state')
+                self.requests[local_unit] = self._load_local_state()
+
+    def _emit_state(self):
+        # Emit this units lock status.
+        for lock in sorted(self.requests[hookenv.local_unit()].keys()):
+            if self.granted(lock):
+                self.msg('Granted {}'.format(lock))
+            else:
+                self.msg('Waiting on {}'.format(lock))
+
+    def _save_state(self):
+        self.msg('Publishing state')
+        if hookenv.is_leader():
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.grants, sort_keys=True)
+            hookenv.leader_set({self.key: raw})
+
+        local_unit = hookenv.local_unit()
+
+        if self.relid is None:
+            # No peers relation yet. Fallback to local state.
+            self.msg('No peer relation. Saving local state')
+            self._save_local_state(self.requests[local_unit])
+        else:
+            # sort_keys to ensure stability.
+            raw = json.dumps(self.requests[local_unit], sort_keys=True)
+            hookenv.relation_set(self.relid, relation_settings={self.key: raw})
+
+    def _load_peer_state(self):
+        requests = {}
+        units = set(hookenv.related_units(self.relid))
+        units.add(hookenv.local_unit())
+        for unit in units:
+            raw = hookenv.relation_get(self.key, unit, self.relid)
+            if raw:
+                requests[unit] = json.loads(raw)
+        return requests
+
+    def _local_state_filename(self):
+        # Include the class name. We allow multiple BaseCoordinator
+        # subclasses to be instantiated, and they are singletons, so
+        # this avoids conflicts (unless someone creates and uses two
+        # BaseCoordinator subclasses with the same class name, so don't
+        # do that).
+        return '.charmhelpers.coordinator.{}'.format(self._name())
+
+    def _load_local_state(self):
+        fn = self._local_state_filename()
+        if os.path.exists(fn):
+            with open(fn, 'r') as f:
+                return json.load(f)
+        return {}
+
+    def _save_local_state(self, state):
+        fn = self._local_state_filename()
+        with open(fn, 'w') as f:
+            json.dump(state, f)
+
+    def _release_granted(self):
+        # At the end of every hook, release all locks granted to
+        # this unit. If a hook neglects to make use of what it
+        # requested, it will just have to make the request again.
+        # Implicit release is the only way this will work, as
+        # if the unit is standalone there may be no future triggers
+        # called to do a manual release.
+        unit = hookenv.local_unit()
+        for lock in list(self.requests[unit].keys()):
+            if self.granted(lock):
+                self.msg('Released local {} lock'.format(lock))
+                del self.requests[unit][lock]
+
+
+class Serial(BaseCoordinator):
+    def default_grant(self, lock, unit, granted, queue):
+        '''Default logic to grant a lock to a unit. Unless overridden,
+        only one unit may hold the lock and it will be granted to the
+        earliest queued request.
+
+        To define custom logic for $lock, create a subclass and
+        define a grant_$lock method.
+
+        `unit` is the unit name making the request.
+
+        `granted` is the set of units already granted the lock. It will
+        never include `unit`. It may be empty.
+
+        `queue` is the list of units waiting for the lock, ordered by time
+        of request. It will always include `unit`, but `unit` is not
+        necessarily first.
+
+        Returns True if the lock should be granted to `unit`.
+        '''
+        return unit == queue[0] and not granted
+
+
+def _implicit_peer_relation_name():
+    md = hookenv.metadata()
+    assert 'peers' in md, 'No peer relations in metadata.yaml'
+    return sorted(md['peers'].keys())[0]
+
+
+# A human readable, sortable UTC timestamp format.
+_timestamp_format = '%Y-%m-%d %H:%M:%S.%fZ'
+
+
+def _utcnow():  # pragma: no cover
+    # This wrapper exists as mocking datetime methods is problematic.
+    return datetime.utcnow()
+
+
+def _timestamp():
+    return _utcnow().strftime(_timestamp_format)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/decorators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/decorators.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ad41ee4121f4c0816935f8b16cd84f972aff22b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/decorators.py
@@ -0,0 +1,55 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#
+# Copyright 2014 Canonical Ltd.
+#
+# Authors:
+#  Edward Hope-Morley <opentastic@gmail.com>
+#
+
+import time
+
+from charmhelpers.core.hookenv import (
+    log,
+    INFO,
+)
+
+
+def retry_on_exception(num_retries, base_delay=0, exc_type=Exception):
+    """If the decorated function raises exception exc_type, allow num_retries
+    retry attempts before raise the exception.
+    """
+    def _retry_on_exception_inner_1(f):
+        def _retry_on_exception_inner_2(*args, **kwargs):
+            retries = num_retries
+            multiplier = 1
+            while True:
+                try:
+                    return f(*args, **kwargs)
+                except exc_type:
+                    if not retries:
+                        raise
+
+                delay = base_delay * multiplier
+                multiplier += 1
+                log("Retrying '%s' %d more times (delay=%s)" %
+                    (f.__name__, retries, delay), level=INFO)
+                retries -= 1
+                if delay:
+                    time.sleep(delay)
+
+        return _retry_on_exception_inner_2
+
+    return _retry_on_exception_inner_1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/files.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/files.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdd82b75709c13da0d534bf4962822984a3c1867
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/files.py
@@ -0,0 +1,43 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Jorge Niedbalski <niedbalski@ubuntu.com>'
+
+import os
+import subprocess
+
+
+def sed(filename, before, after, flags='g'):
+    """
+    Search and replaces the given pattern on filename.
+
+    :param filename: relative or absolute file path.
+    :param before: expression to be replaced (see 'man sed')
+    :param after: expression to replace with (see 'man sed')
+    :param flags: sed-compatible regex flags in example, to make
+    the  search and replace case insensitive, specify ``flags="i"``.
+    The ``g`` flag is always specified regardless, so you do not
+    need to remember to include it when overriding this parameter.
+    :returns: If the sed command exit code was zero then return,
+    otherwise raise CalledProcessError.
+    """
+    expression = r's/{0}/{1}/{2}'.format(before,
+                                         after, flags)
+
+    return subprocess.check_call(["sed", "-i", "-r", "-e",
+                                  expression,
+                                  os.path.expanduser(filename)])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/fstab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/fstab.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9fa9152c765c538adad3fd9bc45a46018c89b72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/fstab.py
@@ -0,0 +1,132 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import os
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+class Fstab(io.FileIO):
+    """This class extends file in order to implement a file reader/writer
+    for file `/etc/fstab`
+    """
+
+    class Entry(object):
+        """Entry class represents a non-comment line on the `/etc/fstab` file
+        """
+        def __init__(self, device, mountpoint, filesystem,
+                     options, d=0, p=0):
+            self.device = device
+            self.mountpoint = mountpoint
+            self.filesystem = filesystem
+
+            if not options:
+                options = "defaults"
+
+            self.options = options
+            self.d = int(d)
+            self.p = int(p)
+
+        def __eq__(self, o):
+            return str(self) == str(o)
+
+        def __str__(self):
+            return "{} {} {} {} {} {}".format(self.device,
+                                              self.mountpoint,
+                                              self.filesystem,
+                                              self.options,
+                                              self.d,
+                                              self.p)
+
+    DEFAULT_PATH = os.path.join(os.path.sep, 'etc', 'fstab')
+
+    def __init__(self, path=None):
+        if path:
+            self._path = path
+        else:
+            self._path = self.DEFAULT_PATH
+        super(Fstab, self).__init__(self._path, 'rb+')
+
+    def _hydrate_entry(self, line):
+        # NOTE: use split with no arguments to split on any
+        #       whitespace including tabs
+        return Fstab.Entry(*filter(
+            lambda x: x not in ('', None),
+            line.strip("\n").split()))
+
+    @property
+    def entries(self):
+        self.seek(0)
+        for line in self.readlines():
+            line = line.decode('us-ascii')
+            try:
+                if line.strip() and not line.strip().startswith("#"):
+                    yield self._hydrate_entry(line)
+            except ValueError:
+                pass
+
+    def get_entry_by_attr(self, attr, value):
+        for entry in self.entries:
+            e_attr = getattr(entry, attr)
+            if e_attr == value:
+                return entry
+        return None
+
+    def add_entry(self, entry):
+        if self.get_entry_by_attr('device', entry.device):
+            return False
+
+        self.write((str(entry) + '\n').encode('us-ascii'))
+        self.truncate()
+        return entry
+
+    def remove_entry(self, entry):
+        self.seek(0)
+
+        lines = [l.decode('us-ascii') for l in self.readlines()]
+
+        found = False
+        for index, line in enumerate(lines):
+            if line.strip() and not line.strip().startswith("#"):
+                if self._hydrate_entry(line) == entry:
+                    found = True
+                    break
+
+        if not found:
+            return False
+
+        lines.remove(line)
+
+        self.seek(0)
+        self.write(''.join(lines).encode('us-ascii'))
+        self.truncate()
+        return True
+
+    @classmethod
+    def remove_by_mountpoint(cls, mountpoint, path=None):
+        fstab = cls(path=path)
+        entry = fstab.get_entry_by_attr('mountpoint', mountpoint)
+        if entry:
+            return fstab.remove_entry(entry)
+        return False
+
+    @classmethod
+    def add(cls, device, mountpoint, filesystem, options=None, path=None):
+        return cls(path=path).add_entry(Fstab.Entry(device,
+                                                    mountpoint, filesystem,
+                                                    options=options))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..db7ce7282b4c96c8a33abf309a340377216922ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hookenv.py
@@ -0,0 +1,1613 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Interactions with the Juju environment"
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+
+from __future__ import print_function
+import copy
+from distutils.version import LooseVersion
+from enum import Enum
+from functools import wraps
+from collections import namedtuple
+import glob
+import os
+import json
+import yaml
+import re
+import subprocess
+import sys
+import errno
+import tempfile
+from subprocess import CalledProcessError
+
+from charmhelpers import deprecate
+
+import six
+if not six.PY3:
+    from UserDict import UserDict
+else:
+    from collections import UserDict
+
+
+CRITICAL = "CRITICAL"
+ERROR = "ERROR"
+WARNING = "WARNING"
+INFO = "INFO"
+DEBUG = "DEBUG"
+TRACE = "TRACE"
+MARKER = object()
+SH_MAX_ARG = 131071
+
+
+RANGE_WARNING = ('Passing NO_PROXY string that includes a cidr. '
+                 'This may not be compatible with software you are '
+                 'running in your shell.')
+
+
+class WORKLOAD_STATES(Enum):
+    ACTIVE = 'active'
+    BLOCKED = 'blocked'
+    MAINTENANCE = 'maintenance'
+    WAITING = 'waiting'
+
+
+cache = {}
+
+
+def cached(func):
+    """Cache return values for multiple executions of func + args
+
+    For example::
+
+        @cached
+        def unit_get(attribute):
+            pass
+
+        unit_get('test')
+
+    will cache the result of unit_get + 'test' for future calls.
+    """
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        global cache
+        key = json.dumps((func, args, kwargs), sort_keys=True, default=str)
+        try:
+            return cache[key]
+        except KeyError:
+            pass  # Drop out of the exception handler scope.
+        res = func(*args, **kwargs)
+        cache[key] = res
+        return res
+    wrapper._wrapped = func
+    return wrapper
+
+
+def flush(key):
+    """Flushes any entries from function cache where the
+    key is found in the function+args """
+    flush_list = []
+    for item in cache:
+        if key in item:
+            flush_list.append(item)
+    for item in flush_list:
+        del cache[item]
+
+
+def log(message, level=None):
+    """Write a message to the juju log"""
+    command = ['juju-log']
+    if level:
+        command += ['-l', level]
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing juju-log should not cause failures in unit tests
+    # Send log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            if level:
+                message = "{}: {}".format(level, message)
+            message = "juju-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+def function_log(message):
+    """Write a function progress message"""
+    command = ['function-log']
+    if not isinstance(message, six.string_types):
+        message = repr(message)
+    command += [message[:SH_MAX_ARG]]
+    # Missing function-log should not cause failures in unit tests
+    # Send function_log output to stderr
+    try:
+        subprocess.call(command)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            message = "function-log: {}".format(message)
+            print(message, file=sys.stderr)
+        else:
+            raise
+
+
+class Serializable(UserDict):
+    """Wrapper, an object that can be serialized to yaml or json"""
+
+    def __init__(self, obj):
+        # wrap the object
+        UserDict.__init__(self)
+        self.data = obj
+
+    def __getattr__(self, attr):
+        # See if this object has attribute.
+        if attr in ("json", "yaml", "data"):
+            return self.__dict__[attr]
+        # Check for attribute in wrapped object.
+        got = getattr(self.data, attr, MARKER)
+        if got is not MARKER:
+            return got
+        # Proxy to the wrapped object via dict interface.
+        try:
+            return self.data[attr]
+        except KeyError:
+            raise AttributeError(attr)
+
+    def __getstate__(self):
+        # Pickle as a standard dictionary.
+        return self.data
+
+    def __setstate__(self, state):
+        # Unpickle into our wrapper.
+        self.data = state
+
+    def json(self):
+        """Serialize the object to json"""
+        return json.dumps(self.data)
+
+    def yaml(self):
+        """Serialize the object to yaml"""
+        return yaml.dump(self.data)
+
+
+def execution_environment():
+    """A convenient bundling of the current execution context"""
+    context = {}
+    context['conf'] = config()
+    if relation_id():
+        context['reltype'] = relation_type()
+        context['relid'] = relation_id()
+        context['rel'] = relation_get()
+    context['unit'] = local_unit()
+    context['rels'] = relations()
+    context['env'] = os.environ
+    return context
+
+
+def in_relation_hook():
+    """Determine whether we're running in a relation hook"""
+    return 'JUJU_RELATION' in os.environ
+
+
+def relation_type():
+    """The scope for the current relation hook"""
+    return os.environ.get('JUJU_RELATION', None)
+
+
+@cached
+def relation_id(relation_name=None, service_or_unit=None):
+    """The relation ID for the current or a specified relation"""
+    if not relation_name and not service_or_unit:
+        return os.environ.get('JUJU_RELATION_ID', None)
+    elif relation_name and service_or_unit:
+        service_name = service_or_unit.split('/')[0]
+        for relid in relation_ids(relation_name):
+            remote_service = remote_service_name(relid)
+            if remote_service == service_name:
+                return relid
+    else:
+        raise ValueError('Must specify neither or both of relation_name and service_or_unit')
+
+
+def local_unit():
+    """Local unit ID"""
+    return os.environ['JUJU_UNIT_NAME']
+
+
+def remote_unit():
+    """The remote unit for the current relation hook"""
+    return os.environ.get('JUJU_REMOTE_UNIT', None)
+
+
+def application_name():
+    """
+    The name of the deployed application this unit belongs to.
+    """
+    return local_unit().split('/')[0]
+
+
+def service_name():
+    """
+    .. deprecated:: 0.19.1
+       Alias for :func:`application_name`.
+    """
+    return application_name()
+
+
+def model_name():
+    """
+    Name of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_NAME']
+
+
+def model_uuid():
+    """
+    UUID of the model that this unit is deployed in.
+    """
+    return os.environ['JUJU_MODEL_UUID']
+
+
+def principal_unit():
+    """Returns the principal unit of this unit, otherwise None"""
+    # Juju 2.2 and above provides JUJU_PRINCIPAL_UNIT
+    principal_unit = os.environ.get('JUJU_PRINCIPAL_UNIT', None)
+    # If it's empty, then this unit is the principal
+    if principal_unit == '':
+        return os.environ['JUJU_UNIT_NAME']
+    elif principal_unit is not None:
+        return principal_unit
+    # For Juju 2.1 and below, let's try work out the principle unit by
+    # the various charms' metadata.yaml.
+    for reltype in relation_types():
+        for rid in relation_ids(reltype):
+            for unit in related_units(rid):
+                md = _metadata_unit(unit)
+                if not md:
+                    continue
+                subordinate = md.pop('subordinate', None)
+                if not subordinate:
+                    return unit
+    return None
+
+
+@cached
+def remote_service_name(relid=None):
+    """The remote service name for a given relation-id (or the current relation)"""
+    if relid is None:
+        unit = remote_unit()
+    else:
+        units = related_units(relid)
+        unit = units[0] if units else None
+    return unit.split('/')[0] if unit else None
+
+
+def hook_name():
+    """The name of the currently executing hook"""
+    return os.environ.get('JUJU_HOOK_NAME', os.path.basename(sys.argv[0]))
+
+
+class Config(dict):
+    """A dictionary representation of the charm's config.yaml, with some
+    extra features:
+
+    - See which values in the dictionary have changed since the previous hook.
+    - For values that have changed, see what the previous value was.
+    - Store arbitrary data for use in a later hook.
+
+    NOTE: Do not instantiate this object directly - instead call
+    ``hookenv.config()``, which will return an instance of :class:`Config`.
+
+    Example usage::
+
+        >>> # inside a hook
+        >>> from charmhelpers.core import hookenv
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'bar'
+        >>> # store a new key/value for later use
+        >>> config['mykey'] = 'myval'
+
+
+        >>> # user runs `juju set mycharm foo=baz`
+        >>> # now we're inside subsequent config-changed hook
+        >>> config = hookenv.config()
+        >>> config['foo']
+        'baz'
+        >>> # test to see if this val has changed since last hook
+        >>> config.changed('foo')
+        True
+        >>> # what was the previous value?
+        >>> config.previous('foo')
+        'bar'
+        >>> # keys/values that we add are preserved across hooks
+        >>> config['mykey']
+        'myval'
+
+    """
+    CONFIG_FILE_NAME = '.juju-persistent-config'
+
+    def __init__(self, *args, **kw):
+        super(Config, self).__init__(*args, **kw)
+        self.implicit_save = True
+        self._prev_dict = None
+        self.path = os.path.join(charm_dir(), Config.CONFIG_FILE_NAME)
+        if os.path.exists(self.path) and os.stat(self.path).st_size:
+            self.load_previous()
+        atexit(self._implicit_save)
+
+    def load_previous(self, path=None):
+        """Load previous copy of config from disk.
+
+        In normal usage you don't need to call this method directly - it
+        is called automatically at object initialization.
+
+        :param path:
+
+            File path from which to load the previous config. If `None`,
+            config is loaded from the default location. If `path` is
+            specified, subsequent `save()` calls will write to the same
+            path.
+
+        """
+        self.path = path or self.path
+        with open(self.path) as f:
+            try:
+                self._prev_dict = json.load(f)
+            except ValueError as e:
+                log('Found but was unable to parse previous config data, '
+                    'ignoring which will report all values as changed - {}'
+                    .format(str(e)), level=ERROR)
+                return
+        for k, v in copy.deepcopy(self._prev_dict).items():
+            if k not in self:
+                self[k] = v
+
+    def changed(self, key):
+        """Return True if the current value for this key is different from
+        the previous value.
+
+        """
+        if self._prev_dict is None:
+            return True
+        return self.previous(key) != self.get(key)
+
+    def previous(self, key):
+        """Return previous value for this key, or None if there
+        is no previous value.
+
+        """
+        if self._prev_dict:
+            return self._prev_dict.get(key)
+        return None
+
+    def save(self):
+        """Save this config to disk.
+
+        If the charm is using the :mod:`Services Framework <services.base>`
+        or :meth:'@hook <Hooks.hook>' decorator, this
+        is called automatically at the end of successful hook execution.
+        Otherwise, it should be called directly by user code.
+
+        To disable automatic saves, set ``implicit_save=False`` on this
+        instance.
+
+        """
+        with open(self.path, 'w') as f:
+            os.fchmod(f.fileno(), 0o600)
+            json.dump(self, f)
+
+    def _implicit_save(self):
+        if self.implicit_save:
+            self.save()
+
+
+_cache_config = None
+
+
+def config(scope=None):
+    """
+    Get the juju charm configuration (scope==None) or individual key,
+    (scope=str).  The returned value is a Python data structure loaded as
+    JSON from the Juju config command.
+
+    :param scope: If set, return the value for the specified key.
+    :type scope: Optional[str]
+    :returns: Either the whole config as a Config, or a key from it.
+    :rtype: Any
+    """
+    global _cache_config
+    config_cmd_line = ['config-get', '--all', '--format=json']
+    try:
+        # JSON Decode Exception for Python3.5+
+        exc_json = json.decoder.JSONDecodeError
+    except AttributeError:
+        # JSON Decode Exception for Python2.7 through Python3.4
+        exc_json = ValueError
+    try:
+        if _cache_config is None:
+            config_data = json.loads(
+                subprocess.check_output(config_cmd_line).decode('UTF-8'))
+            _cache_config = Config(config_data)
+        if scope is not None:
+            return _cache_config.get(scope)
+        return _cache_config
+    except (exc_json, UnicodeDecodeError) as e:
+        log('Unable to parse output from config-get: config_cmd_line="{}" '
+            'message="{}"'
+            .format(config_cmd_line, str(e)), level=ERROR)
+        return None
+
+
+@cached
+def relation_get(attribute=None, unit=None, rid=None):
+    """Get relation information"""
+    _args = ['relation-get', '--format=json']
+    if rid:
+        _args.append('-r')
+        _args.append(rid)
+    _args.append(attribute or '-')
+    if unit:
+        _args.append(unit)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except CalledProcessError as e:
+        if e.returncode == 2:
+            return None
+        raise
+
+
+def relation_set(relation_id=None, relation_settings=None, **kwargs):
+    """Set relation information for the current unit"""
+    relation_settings = relation_settings if relation_settings else {}
+    relation_cmd_line = ['relation-set']
+    accepts_file = "--file" in subprocess.check_output(
+        relation_cmd_line + ["--help"], universal_newlines=True)
+    if relation_id is not None:
+        relation_cmd_line.extend(('-r', relation_id))
+    settings = relation_settings.copy()
+    settings.update(kwargs)
+    for key, value in settings.items():
+        # Force value to be a string: it always should, but some call
+        # sites pass in things like dicts or numbers.
+        if value is not None:
+            settings[key] = "{}".format(value)
+    if accepts_file:
+        # --file was introduced in Juju 1.23.2. Use it by default if
+        # available, since otherwise we'll break if the relation data is
+        # too big. Ideally we should tell relation-set to read the data from
+        # stdin, but that feature is broken in 1.23.2: Bug #1454678.
+        with tempfile.NamedTemporaryFile(delete=False) as settings_file:
+            settings_file.write(yaml.safe_dump(settings).encode("utf-8"))
+        subprocess.check_call(
+            relation_cmd_line + ["--file", settings_file.name])
+        os.remove(settings_file.name)
+    else:
+        for key, value in settings.items():
+            if value is None:
+                relation_cmd_line.append('{}='.format(key))
+            else:
+                relation_cmd_line.append('{}={}'.format(key, value))
+        subprocess.check_call(relation_cmd_line)
+    # Flush cache of any relation-gets for local unit
+    flush(local_unit())
+
+
+def relation_clear(r_id=None):
+    ''' Clears any relation data already set on relation r_id '''
+    settings = relation_get(rid=r_id,
+                            unit=local_unit())
+    for setting in settings:
+        if setting not in ['public-address', 'private-address']:
+            settings[setting] = None
+    relation_set(relation_id=r_id,
+                 **settings)
+
+
+@cached
+def relation_ids(reltype=None):
+    """A list of relation_ids"""
+    reltype = reltype or relation_type()
+    relid_cmd_line = ['relation-ids', '--format=json']
+    if reltype is not None:
+        relid_cmd_line.append(reltype)
+        return json.loads(
+            subprocess.check_output(relid_cmd_line).decode('UTF-8')) or []
+    return []
+
+
+@cached
+def related_units(relid=None):
+    """A list of related units"""
+    relid = relid or relation_id()
+    units_cmd_line = ['relation-list', '--format=json']
+    if relid is not None:
+        units_cmd_line.extend(('-r', relid))
+    return json.loads(
+        subprocess.check_output(units_cmd_line).decode('UTF-8')) or []
+
+
+def expected_peer_units():
+    """Get a generator for units we expect to join peer relation based on
+    goal-state.
+
+    The local unit is excluded from the result to make it easy to gauge
+    completion of all peers joining the relation with existing hook tools.
+
+    Example usage:
+    log('peer {} of {} joined peer relation'
+        .format(len(related_units()),
+                len(list(expected_peer_units()))))
+
+    This function will raise NotImplementedError if used with juju versions
+    without goal-state support.
+
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: NotImplementedError
+    """
+    if not has_juju_version("2.4.0"):
+        # goal-state first appeared in 2.4.0.
+        raise NotImplementedError("goal-state")
+    _goal_state = goal_state()
+    return (key for key in _goal_state['units']
+            if '/' in key and key != local_unit())
+
+
+def expected_related_units(reltype=None):
+    """Get a generator for units we expect to join relation based on
+    goal-state.
+
+    Note that you can not use this function for the peer relation, take a look
+    at expected_peer_units() for that.
+
+    This function will raise KeyError if you request information for a
+    relation type for which juju goal-state does not have information.  It will
+    raise NotImplementedError if used with juju versions without goal-state
+    support.
+
+    Example usage:
+    log('participant {} of {} joined relation {}'
+        .format(len(related_units()),
+                len(list(expected_related_units())),
+                relation_type()))
+
+    :param reltype: Relation type to list data for, default is to list data for
+                    the realtion type we are currently executing a hook for.
+    :type reltype: str
+    :returns: iterator
+    :rtype: types.GeneratorType
+    :raises: KeyError, NotImplementedError
+    """
+    if not has_juju_version("2.4.4"):
+        # goal-state existed in 2.4.0, but did not list individual units to
+        # join a relation in 2.4.1 through 2.4.3. (LP: #1794739)
+        raise NotImplementedError("goal-state relation unit count")
+    reltype = reltype or relation_type()
+    _goal_state = goal_state()
+    return (key for key in _goal_state['relations'][reltype] if '/' in key)
+
+
+@cached
+def relation_for_unit(unit=None, rid=None):
+    """Get the json represenation of a unit's relation"""
+    unit = unit or remote_unit()
+    relation = relation_get(unit=unit, rid=rid)
+    for key in relation:
+        if key.endswith('-list'):
+            relation[key] = relation[key].split()
+    relation['__unit__'] = unit
+    return relation
+
+
+@cached
+def relations_for_id(relid=None):
+    """Get relations of a specific relation ID"""
+    relation_data = []
+    relid = relid or relation_ids()
+    for unit in related_units(relid):
+        unit_data = relation_for_unit(unit, relid)
+        unit_data['__relid__'] = relid
+        relation_data.append(unit_data)
+    return relation_data
+
+
+@cached
+def relations_of_type(reltype=None):
+    """Get relations of a specific type"""
+    relation_data = []
+    reltype = reltype or relation_type()
+    for relid in relation_ids(reltype):
+        for relation in relations_for_id(relid):
+            relation['__relid__'] = relid
+            relation_data.append(relation)
+    return relation_data
+
+
+@cached
+def metadata():
+    """Get the current charm metadata.yaml contents as a python object"""
+    with open(os.path.join(charm_dir(), 'metadata.yaml')) as md:
+        return yaml.safe_load(md)
+
+
+def _metadata_unit(unit):
+    """Given the name of a unit (e.g. apache2/0), get the unit charm's
+    metadata.yaml. Very similar to metadata() but allows us to inspect
+    other units. Unit needs to be co-located, such as a subordinate or
+    principal/primary.
+
+    :returns: metadata.yaml as a python object.
+
+    """
+    basedir = os.sep.join(charm_dir().split(os.sep)[:-2])
+    unitdir = 'unit-{}'.format(unit.replace(os.sep, '-'))
+    joineddir = os.path.join(basedir, unitdir, 'charm', 'metadata.yaml')
+    if not os.path.exists(joineddir):
+        return None
+    with open(joineddir) as md:
+        return yaml.safe_load(md)
+
+
+@cached
+def relation_types():
+    """Get a list of relation types supported by this charm"""
+    rel_types = []
+    md = metadata()
+    for key in ('provides', 'requires', 'peers'):
+        section = md.get(key)
+        if section:
+            rel_types.extend(section.keys())
+    return rel_types
+
+
+@cached
+def peer_relation_id():
+    '''Get the peers relation id if a peers relation has been joined, else None.'''
+    md = metadata()
+    section = md.get('peers')
+    if section:
+        for key in section:
+            relids = relation_ids(key)
+            if relids:
+                return relids[0]
+    return None
+
+
+@cached
+def relation_to_interface(relation_name):
+    """
+    Given the name of a relation, return the interface that relation uses.
+
+    :returns: The interface name, or ``None``.
+    """
+    return relation_to_role_and_interface(relation_name)[1]
+
+
+@cached
+def relation_to_role_and_interface(relation_name):
+    """
+    Given the name of a relation, return the role and the name of the interface
+    that relation uses (where role is one of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A tuple containing ``(role, interface)``, or ``(None, None)``.
+    """
+    _metadata = metadata()
+    for role in ('provides', 'requires', 'peers'):
+        interface = _metadata.get(role, {}).get(relation_name, {}).get('interface')
+        if interface:
+            return role, interface
+    return None, None
+
+
+@cached
+def role_and_interface_to_relations(role, interface_name):
+    """
+    Given a role and interface name, return a list of relation names for the
+    current charm that use that interface under that role (where role is one
+    of ``provides``, ``requires``, or ``peers``).
+
+    :returns: A list of relation names.
+    """
+    _metadata = metadata()
+    results = []
+    for relation_name, relation in _metadata.get(role, {}).items():
+        if relation['interface'] == interface_name:
+            results.append(relation_name)
+    return results
+
+
+@cached
+def interface_to_relations(interface_name):
+    """
+    Given an interface, return a list of relation names for the current
+    charm that use that interface.
+
+    :returns: A list of relation names.
+    """
+    results = []
+    for role in ('provides', 'requires', 'peers'):
+        results.extend(role_and_interface_to_relations(role, interface_name))
+    return results
+
+
+@cached
+def charm_name():
+    """Get the name of the current charm as is specified on metadata.yaml"""
+    return metadata().get('name')
+
+
+@cached
+def relations():
+    """Get a nested dictionary of relation data for all related units"""
+    rels = {}
+    for reltype in relation_types():
+        relids = {}
+        for relid in relation_ids(reltype):
+            units = {local_unit(): relation_get(unit=local_unit(), rid=relid)}
+            for unit in related_units(relid):
+                reldata = relation_get(unit=unit, rid=relid)
+                units[unit] = reldata
+            relids[relid] = units
+        rels[reltype] = relids
+    return rels
+
+
+@cached
+def is_relation_made(relation, keys='private-address'):
+    '''
+    Determine whether a relation is established by checking for
+    presence of key(s).  If a list of keys is provided, they
+    must all be present for the relation to be identified as made
+    '''
+    if isinstance(keys, str):
+        keys = [keys]
+    for r_id in relation_ids(relation):
+        for unit in related_units(r_id):
+            context = {}
+            for k in keys:
+                context[k] = relation_get(k, rid=r_id,
+                                          unit=unit)
+            if None not in context.values():
+                return True
+    return False
+
+
+def _port_op(op_name, port, protocol="TCP"):
+    """Open or close a service network port"""
+    _args = [op_name]
+    icmp = protocol.upper() == "ICMP"
+    if icmp:
+        _args.append(protocol)
+    else:
+        _args.append('{}/{}'.format(port, protocol))
+    try:
+        subprocess.check_call(_args)
+    except subprocess.CalledProcessError:
+        # Older Juju pre 2.3 doesn't support ICMP
+        # so treat it as a no-op if it fails.
+        if not icmp:
+            raise
+
+
+def open_port(port, protocol="TCP"):
+    """Open a service network port"""
+    _port_op('open-port', port, protocol)
+
+
+def close_port(port, protocol="TCP"):
+    """Close a service network port"""
+    _port_op('close-port', port, protocol)
+
+
+def open_ports(start, end, protocol="TCP"):
+    """Opens a range of service network ports"""
+    _args = ['open-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def close_ports(start, end, protocol="TCP"):
+    """Close a range of service network ports"""
+    _args = ['close-port']
+    _args.append('{}-{}/{}'.format(start, end, protocol))
+    subprocess.check_call(_args)
+
+
+def opened_ports():
+    """Get the opened ports
+
+    *Note that this will only show ports opened in a previous hook*
+
+    :returns: Opened ports as a list of strings: ``['8080/tcp', '8081-8083/tcp']``
+    """
+    _args = ['opened-ports', '--format=json']
+    return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+
+
+@cached
+def unit_get(attribute):
+    """Get the unit ID for the remote unit"""
+    _args = ['unit-get', '--format=json', attribute]
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+def unit_public_ip():
+    """Get this unit's public IP address"""
+    return unit_get('public-address')
+
+
+def unit_private_ip():
+    """Get this unit's private IP address"""
+    return unit_get('private-address')
+
+
+@cached
+def storage_get(attribute=None, storage_id=None):
+    """Get storage attributes"""
+    _args = ['storage-get', '--format=json']
+    if storage_id:
+        _args.extend(('-s', storage_id))
+    if attribute:
+        _args.append(attribute)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+
+
+@cached
+def storage_list(storage_name=None):
+    """List the storage IDs for the unit"""
+    _args = ['storage-list', '--format=json']
+    if storage_name:
+        _args.append(storage_name)
+    try:
+        return json.loads(subprocess.check_output(_args).decode('UTF-8'))
+    except ValueError:
+        return None
+    except OSError as e:
+        import errno
+        if e.errno == errno.ENOENT:
+            # storage-list does not exist
+            return []
+        raise
+
+
+class UnregisteredHookError(Exception):
+    """Raised when an undefined hook is called"""
+    pass
+
+
+class Hooks(object):
+    """A convenient handler for hook functions.
+
+    Example::
+
+        hooks = Hooks()
+
+        # register a hook, taking its name from the function name
+        @hooks.hook()
+        def install():
+            pass  # your code here
+
+        # register a hook, providing a custom hook name
+        @hooks.hook("config-changed")
+        def config_changed():
+            pass  # your code here
+
+        if __name__ == "__main__":
+            # execute a hook based on the name the program is called by
+            hooks.execute(sys.argv)
+    """
+
+    def __init__(self, config_save=None):
+        super(Hooks, self).__init__()
+        self._hooks = {}
+
+        # For unknown reasons, we allow the Hooks constructor to override
+        # config().implicit_save.
+        if config_save is not None:
+            config().implicit_save = config_save
+
+    def register(self, name, function):
+        """Register a hook"""
+        self._hooks[name] = function
+
+    def execute(self, args):
+        """Execute a registered hook based on args[0]"""
+        _run_atstart()
+        hook_name = os.path.basename(args[0])
+        if hook_name in self._hooks:
+            try:
+                self._hooks[hook_name]()
+            except SystemExit as x:
+                if x.code is None or x.code == 0:
+                    _run_atexit()
+                raise
+            _run_atexit()
+        else:
+            raise UnregisteredHookError(hook_name)
+
+    def hook(self, *hook_names):
+        """Decorator, registering them as hooks"""
+        def wrapper(decorated):
+            for hook_name in hook_names:
+                self.register(hook_name, decorated)
+            else:
+                self.register(decorated.__name__, decorated)
+                if '_' in decorated.__name__:
+                    self.register(
+                        decorated.__name__.replace('_', '-'), decorated)
+            return decorated
+        return wrapper
+
+
+class NoNetworkBinding(Exception):
+    pass
+
+
+def charm_dir():
+    """Return the root directory of the current charm"""
+    d = os.environ.get('JUJU_CHARM_DIR')
+    if d is not None:
+        return d
+    return os.environ.get('CHARM_DIR')
+
+
+def cmd_exists(cmd):
+    """Return True if the specified cmd exists in the path"""
+    return any(
+        os.access(os.path.join(path, cmd), os.X_OK)
+        for path in os.environ["PATH"].split(os.pathsep)
+    )
+
+
+@cached
+@deprecate("moved to function_get()", log=log)
+def action_get(key=None):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_get`.
+
+    Gets the value of an action parameter, or all key/value param pairs.
+    """
+    cmd = ['action-get']
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    action_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return action_data
+
+
+@cached
+def function_get(key=None):
+    """Gets the value of an action parameter, or all key/value param pairs"""
+    cmd = ['function-get']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-get']
+
+    if key is not None:
+        cmd.append(key)
+    cmd.append('--format=json')
+    function_data = json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+    return function_data
+
+
+@deprecate("moved to function_set()", log=log)
+def action_set(values):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_set`.
+
+    Sets the values to be returned after the action finishes.
+    """
+    cmd = ['action-set']
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+def function_set(values):
+    """Sets the values to be returned after the function finishes"""
+    cmd = ['function-set']
+    # Fallback for older charms.
+    if not cmd_exists('function-get'):
+        cmd = ['action-set']
+
+    for k, v in list(values.items()):
+        cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@deprecate("moved to function_fail()", log=log)
+def action_fail(message):
+    """
+    .. deprecated:: 0.20.7
+       Alias for :func:`function_fail`.
+
+    Sets the action status to failed and sets the error message.
+
+    The results set by action_set are preserved.
+    """
+    subprocess.check_call(['action-fail', message])
+
+
+def function_fail(message):
+    """Sets the function status to failed and sets the error message.
+
+    The results set by function_set are preserved."""
+    cmd = ['function-fail']
+    # Fallback for older charms.
+    if not cmd_exists('function-fail'):
+        cmd = ['action-fail']
+    cmd.append(message)
+
+    subprocess.check_call(cmd)
+
+
+def action_name():
+    """Get the name of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_NAME')
+
+
+def function_name():
+    """Get the name of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_NAME') or action_name()
+
+
+def action_uuid():
+    """Get the UUID of the currently executing action."""
+    return os.environ.get('JUJU_ACTION_UUID')
+
+
+def function_id():
+    """Get the ID of the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_ID') or action_uuid()
+
+
+def action_tag():
+    """Get the tag for the currently executing action."""
+    return os.environ.get('JUJU_ACTION_TAG')
+
+
+def function_tag():
+    """Get the tag for the currently executing function."""
+    return os.environ.get('JUJU_FUNCTION_TAG') or action_tag()
+
+
+def status_set(workload_state, message, application=False):
+    """Set the workload state with a message
+
+    Use status-set to set the workload state with a message which is visible
+    to the user via juju status. If the status-set command is not found then
+    assume this is juju < 1.23 and juju-log the message instead.
+
+    workload_state   -- valid juju workload state. str or WORKLOAD_STATES
+    message          -- status update message
+    application      -- Whether this is an application state set
+    """
+    bad_state_msg = '{!r} is not a valid workload state'
+
+    if isinstance(workload_state, str):
+        try:
+            # Convert string to enum.
+            workload_state = WORKLOAD_STATES[workload_state.upper()]
+        except KeyError:
+            raise ValueError(bad_state_msg.format(workload_state))
+
+    if workload_state not in WORKLOAD_STATES:
+        raise ValueError(bad_state_msg.format(workload_state))
+
+    cmd = ['status-set']
+    if application:
+        cmd.append('--application')
+    cmd.extend([workload_state.value, message])
+    try:
+        ret = subprocess.call(cmd)
+        if ret == 0:
+            return
+    except OSError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'status-set failed: {} {}'.format(workload_state.value,
+                                                    message)
+    log(log_message, level='INFO')
+
+
+def status_get():
+    """Retrieve the previously set juju workload state and message
+
+    If the status-get command is not found then assume this is juju < 1.23 and
+    return 'unknown', ""
+
+    """
+    cmd = ['status-get', "--format=json", "--include-data"]
+    try:
+        raw_status = subprocess.check_output(cmd)
+    except OSError as e:
+        if e.errno == errno.ENOENT:
+            return ('unknown', "")
+        else:
+            raise
+    else:
+        status = json.loads(raw_status.decode("UTF-8"))
+        return (status["status"], status["message"])
+
+
+def translate_exc(from_exc, to_exc):
+    def inner_translate_exc1(f):
+        @wraps(f)
+        def inner_translate_exc2(*args, **kwargs):
+            try:
+                return f(*args, **kwargs)
+            except from_exc:
+                raise to_exc
+
+        return inner_translate_exc2
+
+    return inner_translate_exc1
+
+
+def application_version_set(version):
+    """Charm authors may trigger this command from any hook to output what
+    version of the application is running. This could be a package version,
+    for instance postgres version 9.5. It could also be a build number or
+    version control revision identifier, for instance git sha 6fb7ba68. """
+
+    cmd = ['application-version-set']
+    cmd.append(version)
+    try:
+        subprocess.check_call(cmd)
+    except OSError:
+        log("Application Version: {}".format(version))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+@cached
+def goal_state():
+    """Juju goal state values"""
+    cmd = ['goal-state', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def is_leader():
+    """Does the current unit hold the juju leadership
+
+    Uses juju to determine whether the current unit is the leader of its peers
+    """
+    cmd = ['is-leader', '--format=json']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_get(attribute=None):
+    """Juju leader get value(s)"""
+    cmd = ['leader-get', '--format=json'] + [attribute or '-']
+    return json.loads(subprocess.check_output(cmd).decode('UTF-8'))
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def leader_set(settings=None, **kwargs):
+    """Juju leader set value(s)"""
+    # Don't log secrets.
+    # log("Juju leader-set '%s'" % (settings), level=DEBUG)
+    cmd = ['leader-set']
+    settings = settings or {}
+    settings.update(kwargs)
+    for k, v in settings.items():
+        if v is None:
+            cmd.append('{}='.format(k))
+        else:
+            cmd.append('{}={}'.format(k, v))
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_register(ptype, klass, pid):
+    """ is used while a hook is running to let Juju know that a
+        payload has been started."""
+    cmd = ['payload-register']
+    for x in [ptype, klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_unregister(klass, pid):
+    """ is used while a hook is running to let Juju know
+    that a payload has been manually stopped. The <class> and <id> provided
+    must match a payload that has been previously registered with juju using
+    payload-register."""
+    cmd = ['payload-unregister']
+    for x in [klass, pid]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def payload_status_set(klass, pid, status):
+    """is used to update the current status of a registered payload.
+    The <class> and <id> provided must match a payload that has been previously
+    registered with juju using payload-register. The <status> must be one of the
+    follow: starting, started, stopping, stopped"""
+    cmd = ['payload-status-set']
+    for x in [klass, pid, status]:
+        cmd.append(x)
+    subprocess.check_call(cmd)
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def resource_get(name):
+    """used to fetch the resource path of the given name.
+
+    <name> must match a name of defined resource in metadata.yaml
+
+    returns either a path or False if resource not available
+    """
+    if not name:
+        return False
+
+    cmd = ['resource-get', name]
+    try:
+        return subprocess.check_output(cmd).decode('UTF-8')
+    except subprocess.CalledProcessError:
+        return False
+
+
+@cached
+def juju_version():
+    """Full version string (eg. '1.23.3.1-trusty-amd64')"""
+    # Per https://bugs.launchpad.net/juju-core/+bug/1455368/comments/1
+    jujud = glob.glob('/var/lib/juju/tools/machine-*/jujud')[0]
+    return subprocess.check_output([jujud, 'version'],
+                                   universal_newlines=True).strip()
+
+
+def has_juju_version(minimum_version):
+    """Return True if the Juju version is at least the provided version"""
+    return LooseVersion(juju_version()) >= LooseVersion(minimum_version)
+
+
+_atexit = []
+_atstart = []
+
+
+def atstart(callback, *args, **kwargs):
+    '''Schedule a callback to run before the main hook.
+
+    Callbacks are run in the order they were added.
+
+    This is useful for modules and classes to perform initialization
+    and inject behavior. In particular:
+
+        - Run common code before all of your hooks, such as logging
+          the hook name or interesting relation data.
+        - Defer object or module initialization that requires a hook
+          context until we know there actually is a hook context,
+          making testing easier.
+        - Rather than requiring charm authors to include boilerplate to
+          invoke your helper's behavior, have it run automatically if
+          your object is instantiated or module imported.
+
+    This is not at all useful after your hook framework as been launched.
+    '''
+    global _atstart
+    _atstart.append((callback, args, kwargs))
+
+
+def atexit(callback, *args, **kwargs):
+    '''Schedule a callback to run on successful hook completion.
+
+    Callbacks are run in the reverse order that they were added.'''
+    _atexit.append((callback, args, kwargs))
+
+
+def _run_atstart():
+    '''Hook frameworks must invoke this before running the main hook body.'''
+    global _atstart
+    for callback, args, kwargs in _atstart:
+        callback(*args, **kwargs)
+    del _atstart[:]
+
+
+def _run_atexit():
+    '''Hook frameworks must invoke this after the main hook body has
+    successfully completed. Do not invoke it if the hook fails.'''
+    global _atexit
+    for callback, args, kwargs in reversed(_atexit):
+        callback(*args, **kwargs)
+    del _atexit[:]
+
+
+@translate_exc(from_exc=OSError, to_exc=NotImplementedError)
+def network_get_primary_address(binding):
+    '''
+    Deprecated since Juju 2.3; use network_get()
+
+    Retrieve the primary network address for a named binding
+
+    :param binding: string. The name of a relation of extra-binding
+    :return: string. The primary IP address for the named binding
+    :raise: NotImplementedError if run on Juju < 2.0
+    '''
+    cmd = ['network-get', '--primary-address', binding]
+    try:
+        response = subprocess.check_output(
+            cmd,
+            stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    except CalledProcessError as e:
+        if 'no network config found for binding' in e.output.decode('UTF-8'):
+            raise NoNetworkBinding("No network binding for {}"
+                                   .format(binding))
+        else:
+            raise
+    return response
+
+
+def network_get(endpoint, relation_id=None):
+    """
+    Retrieve the network details for a relation endpoint
+
+    :param endpoint: string. The name of a relation endpoint
+    :param relation_id: int. The ID of the relation for the current context.
+    :return: dict. The loaded YAML output of the network-get query.
+    :raise: NotImplementedError if request not supported by the Juju version.
+    """
+    if not has_juju_version('2.2'):
+        raise NotImplementedError(juju_version())  # earlier versions require --primary-address
+    if relation_id and not has_juju_version('2.3'):
+        raise NotImplementedError  # 2.3 added the -r option
+
+    cmd = ['network-get', endpoint, '--format', 'yaml']
+    if relation_id:
+        cmd.append('-r')
+        cmd.append(relation_id)
+    response = subprocess.check_output(
+        cmd,
+        stderr=subprocess.STDOUT).decode('UTF-8').strip()
+    return yaml.safe_load(response)
+
+
+def add_metric(*args, **kwargs):
+    """Add metric values. Values may be expressed with keyword arguments. For
+    metric names containing dashes, these may be expressed as one or more
+    'key=value' positional arguments. May only be called from the collect-metrics
+    hook."""
+    _args = ['add-metric']
+    _kvpairs = []
+    _kvpairs.extend(args)
+    _kvpairs.extend(['{}={}'.format(k, v) for k, v in kwargs.items()])
+    _args.extend(sorted(_kvpairs))
+    try:
+        subprocess.check_call(_args)
+        return
+    except EnvironmentError as e:
+        if e.errno != errno.ENOENT:
+            raise
+    log_message = 'add-metric failed: {}'.format(' '.join(_kvpairs))
+    log(log_message, level='INFO')
+
+
+def meter_status():
+    """Get the meter status, if running in the meter-status-changed hook."""
+    return os.environ.get('JUJU_METER_STATUS')
+
+
+def meter_info():
+    """Get the meter status information, if running in the meter-status-changed
+    hook."""
+    return os.environ.get('JUJU_METER_INFO')
+
+
+def iter_units_for_relation_name(relation_name):
+    """Iterate through all units in a relation
+
+    Generator that iterates through all the units in a relation and yields
+    a named tuple with rid and unit field names.
+
+    Usage:
+    data = [(u.rid, u.unit)
+            for u in iter_units_for_relation_name(relation_name)]
+
+    :param relation_name: string relation name
+    :yield: Named Tuple with rid and unit field names
+    """
+    RelatedUnit = namedtuple('RelatedUnit', 'rid, unit')
+    for rid in relation_ids(relation_name):
+        for unit in related_units(rid):
+            yield RelatedUnit(rid, unit)
+
+
+def ingress_address(rid=None, unit=None):
+    """
+    Retrieve the ingress-address from a relation when available.
+    Otherwise, return the private-address.
+
+    When used on the consuming side of the relation (unit is a remote
+    unit), the ingress-address is the IP address that this unit needs
+    to use to reach the provided service on the remote unit.
+
+    When used on the providing side of the relation (unit == local_unit()),
+    the ingress-address is the IP address that is advertised to remote
+    units on this relation. Remote units need to use this address to
+    reach the local provided service on this unit.
+
+    Note that charms may document some other method to use in
+    preference to the ingress_address(), such as an address provided
+    on a different relation attribute or a service discovery mechanism.
+    This allows charms to redirect inbound connections to their peers
+    or different applications such as load balancers.
+
+    Usage:
+    addresses = [ingress_address(rid=u.rid, unit=u.unit)
+                 for u in iter_units_for_relation_name(relation_name)]
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: string IP address
+    """
+    settings = relation_get(rid=rid, unit=unit)
+    return (settings.get('ingress-address') or
+            settings.get('private-address'))
+
+
+def egress_subnets(rid=None, unit=None):
+    """
+    Retrieve the egress-subnets from a relation.
+
+    This function is to be used on the providing side of the
+    relation, and provides the ranges of addresses that client
+    connections may come from. The result is uninteresting on
+    the consuming side of a relation (unit == local_unit()).
+
+    Returns a stable list of subnets in CIDR format.
+    eg. ['192.168.1.0/24', '2001::F00F/128']
+
+    If egress-subnets is not available, falls back to using the published
+    ingress-address, or finally private-address.
+
+    :param rid: string relation id
+    :param unit: string unit name
+    :side effect: calls relation_get
+    :return: list of subnets in CIDR format. eg. ['192.168.1.0/24', '2001::F00F/128']
+    """
+    def _to_range(addr):
+        if re.search(r'^(?:\d{1,3}\.){3}\d{1,3}$', addr) is not None:
+            addr += '/32'
+        elif ':' in addr and '/' not in addr:  # IPv6
+            addr += '/128'
+        return addr
+
+    settings = relation_get(rid=rid, unit=unit)
+    if 'egress-subnets' in settings:
+        return [n.strip() for n in settings['egress-subnets'].split(',') if n.strip()]
+    if 'ingress-address' in settings:
+        return [_to_range(settings['ingress-address'])]
+    if 'private-address' in settings:
+        return [_to_range(settings['private-address'])]
+    return []  # Should never happen
+
+
+def unit_doomed(unit=None):
+    """Determines if the unit is being removed from the model
+
+    Requires Juju 2.4.1.
+
+    :param unit: string unit name, defaults to local_unit
+    :side effect: calls goal_state
+    :side effect: calls local_unit
+    :side effect: calls has_juju_version
+    :return: True if the unit is being removed, already gone, or never existed
+    """
+    if not has_juju_version("2.4.1"):
+        # We cannot risk blindly returning False for 'we don't know',
+        # because that could cause data loss; if call sites don't
+        # need an accurate answer, they likely don't need this helper
+        # at all.
+        # goal-state existed in 2.4.0, but did not handle removals
+        # correctly until 2.4.1.
+        raise NotImplementedError("is_doomed")
+    if unit is None:
+        unit = local_unit()
+    gs = goal_state()
+    units = gs.get('units', {})
+    if unit not in units:
+        return True
+    # I don't think 'dead' units ever show up in the goal-state, but
+    # check anyway in addition to 'dying'.
+    return units[unit]['status'] in ('dying', 'dead')
+
+
+def env_proxy_settings(selected_settings=None):
+    """Get proxy settings from process environment variables.
+
+    Get charm proxy settings from environment variables that correspond to
+    juju-http-proxy, juju-https-proxy juju-no-proxy (available as of 2.4.2, see
+    lp:1782236) and juju-ftp-proxy in a format suitable for passing to an
+    application that reacts to proxy settings passed as environment variables.
+    Some applications support lowercase or uppercase notation (e.g. curl), some
+    support only lowercase (e.g. wget), there are also subjectively rare cases
+    of only uppercase notation support. no_proxy CIDR and wildcard support also
+    varies between runtimes and applications as there is no enforced standard.
+
+    Some applications may connect to multiple destinations and expose config
+    options that would affect only proxy settings for a specific destination
+    these should be handled in charms in an application-specific manner.
+
+    :param selected_settings: format only a subset of possible settings
+    :type selected_settings: list
+    :rtype: Option(None, dict[str, str])
+    """
+    SUPPORTED_SETTINGS = {
+        'http': 'HTTP_PROXY',
+        'https': 'HTTPS_PROXY',
+        'no_proxy': 'NO_PROXY',
+        'ftp': 'FTP_PROXY'
+    }
+    if selected_settings is None:
+        selected_settings = SUPPORTED_SETTINGS
+
+    selected_vars = [v for k, v in SUPPORTED_SETTINGS.items()
+                     if k in selected_settings]
+    proxy_settings = {}
+    for var in selected_vars:
+        var_val = os.getenv(var)
+        if var_val:
+            proxy_settings[var] = var_val
+            proxy_settings[var.lower()] = var_val
+        # Now handle juju-prefixed environment variables. The legacy vs new
+        # environment variable usage is mutually exclusive
+        charm_var_val = os.getenv('JUJU_CHARM_{}'.format(var))
+        if charm_var_val:
+            proxy_settings[var] = charm_var_val
+            proxy_settings[var.lower()] = charm_var_val
+    if 'no_proxy' in proxy_settings:
+        if _contains_range(proxy_settings['no_proxy']):
+            log(RANGE_WARNING, level=WARNING)
+    return proxy_settings if proxy_settings else None
+
+
+def _contains_range(addresses):
+    """Check for cidr or wildcard domain in a string.
+
+    Given a string comprising a comma seperated list of ip addresses
+    and domain names, determine whether the string contains IP ranges
+    or wildcard domains.
+
+    :param addresses: comma seperated list of domains and ip addresses.
+    :type addresses: str
+    """
+    return (
+        # Test for cidr (e.g. 10.20.20.0/24)
+        "/" in addresses or
+        # Test for wildcard domains (*.foo.com or .foo.com)
+        "*" in addresses or
+        addresses.startswith(".") or
+        ",." in addresses or
+        " ." in addresses)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host.py
new file mode 100644
index 0000000000000000000000000000000000000000..b33ac906d9eeb198210dceb069724ac9a35652ea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host.py
@@ -0,0 +1,1104 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tools for working with the host system"""
+# Copyright 2012 Canonical Ltd.
+#
+# Authors:
+#  Nick Moffitt <nick.moffitt@canonical.com>
+#  Matthew Wedgwood <matthew.wedgwood@canonical.com>
+
+import os
+import re
+import pwd
+import glob
+import grp
+import random
+import string
+import subprocess
+import hashlib
+import functools
+import itertools
+import six
+
+from contextlib import contextmanager
+from collections import OrderedDict
+from .hookenv import log, INFO, DEBUG, local_unit, charm_name
+from .fstab import Fstab
+from charmhelpers.osplatform import get_platform
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.host_factory.ubuntu import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+        get_distrib_codename,
+        arch
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.host_factory.centos import (  # NOQA:F401
+        service_available,
+        add_new_group,
+        lsb_release,
+        cmp_pkgrevno,
+        CompareHostReleases,
+    )  # flake8: noqa -- ignore F401 for this import
+
+UPDATEDB_PATH = '/etc/updatedb.conf'
+
+
+def service_start(service_name, **kwargs):
+    """Start a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('start', service_name, **kwargs)
+
+
+def service_stop(service_name, **kwargs):
+    """Stop a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example stops the ceph-osd service for instance id=4:
+
+    service_stop('ceph-osd', id=4)
+
+    :param service_name: the name of the service to stop
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    return service('stop', service_name, **kwargs)
+
+
+def service_restart(service_name, **kwargs):
+    """Restart a system service.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be restarted. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_restart('ceph-osd', id=4)
+
+    :param service_name: the name of the service to restart
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    return service('restart', service_name)
+
+
+def service_reload(service_name, restart_on_failure=False, **kwargs):
+    """Reload a system service, optionally falling back to restart if
+    reload fails.
+
+    The specified service name is managed via the system level init system.
+    Some init systems (e.g. upstart) require that additional arguments be
+    provided in order to directly control service instances whereas other init
+    systems allow for addressing instances of a service directly by name (e.g.
+    systemd).
+
+    The kwargs allow for the additional parameters to be passed to underlying
+    init systems for those systems which require/allow for them. For example,
+    the ceph-osd upstart script requires the id parameter to be passed along
+    in order to identify which running daemon should be reloaded. The follow-
+    ing example restarts the ceph-osd service for instance id=4:
+
+    service_reload('ceph-osd', id=4)
+
+    :param service_name: the name of the service to reload
+    :param restart_on_failure: boolean indicating whether to fallback to a
+                               restart if the reload fails.
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the  init system's commandline. kwargs
+                     are ignored for init systems not allowing additional
+                     parameters via the commandline (systemd).
+    """
+    service_result = service('reload', service_name, **kwargs)
+    if not service_result and restart_on_failure:
+        service_result = service('restart', service_name, **kwargs)
+    return service_result
+
+
+def service_pause(service_name, init_dir="/etc/init", initd_dir="/etc/init.d",
+                  **kwargs):
+    """Pause a system service.
+
+    Stop it, and prevent it from starting again at boot.
+
+    :param service_name: the name of the service to pause
+    :param init_dir: path to the upstart init directory
+    :param initd_dir: path to the sysv init directory
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for init systems which do not support
+                     key=value arguments via the commandline.
+    """
+    stopped = True
+    if service_running(service_name, **kwargs):
+        stopped = service_stop(service_name, **kwargs)
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('disable', service_name)
+        service('mask', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        with open(override_path, 'w') as fh:
+            fh.write("manual\n")
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "disable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    return stopped
+
+
+def service_resume(service_name, init_dir="/etc/init",
+                   initd_dir="/etc/init.d", **kwargs):
+    """Resume a system service.
+
+    Reenable starting again at boot. Start the service.
+
+    :param service_name: the name of the service to resume
+    :param init_dir: the path to the init dir
+    :param initd dir: the path to the initd dir
+    :param **kwargs: additional parameters to pass to the init system when
+                     managing services. These will be passed as key=value
+                     parameters to the init system's commandline. kwargs
+                     are ignored for systemd enabled systems.
+    """
+    upstart_file = os.path.join(init_dir, "{}.conf".format(service_name))
+    sysv_file = os.path.join(initd_dir, service_name)
+    if init_is_systemd():
+        service('unmask', service_name)
+        service('enable', service_name)
+    elif os.path.exists(upstart_file):
+        override_path = os.path.join(
+            init_dir, '{}.override'.format(service_name))
+        if os.path.exists(override_path):
+            os.unlink(override_path)
+    elif os.path.exists(sysv_file):
+        subprocess.check_call(["update-rc.d", service_name, "enable"])
+    else:
+        raise ValueError(
+            "Unable to detect {0} as SystemD, Upstart {1} or"
+            " SysV {2}".format(
+                service_name, upstart_file, sysv_file))
+    started = service_running(service_name, **kwargs)
+
+    if not started:
+        started = service_start(service_name, **kwargs)
+    return started
+
+
+def service(action, service_name, **kwargs):
+    """Control a system service.
+
+    :param action: the action to take on the service
+    :param service_name: the name of the service to perform th action on
+    :param **kwargs: additional params to be passed to the service command in
+                    the form of key=value.
+    """
+    if init_is_systemd():
+        cmd = ['systemctl', action, service_name]
+    else:
+        cmd = ['service', service_name, action]
+        for key, value in six.iteritems(kwargs):
+            parameter = '%s=%s' % (key, value)
+            cmd.append(parameter)
+    return subprocess.call(cmd) == 0
+
+
+_UPSTART_CONF = "/etc/init/{}.conf"
+_INIT_D_CONF = "/etc/init.d/{}"
+
+
+def service_running(service_name, **kwargs):
+    """Determine whether a system service is running.
+
+    :param service_name: the name of the service
+    :param **kwargs: additional args to pass to the service command. This is
+                     used to pass additional key=value arguments to the
+                     service command line for managing specific instance
+                     units (e.g. service ceph-osd status id=2). The kwargs
+                     are ignored in systemd services.
+    """
+    if init_is_systemd():
+        return service('is-active', service_name)
+    else:
+        if os.path.exists(_UPSTART_CONF.format(service_name)):
+            try:
+                cmd = ['status', service_name]
+                for key, value in six.iteritems(kwargs):
+                    parameter = '%s=%s' % (key, value)
+                    cmd.append(parameter)
+                output = subprocess.check_output(
+                    cmd, stderr=subprocess.STDOUT).decode('UTF-8')
+            except subprocess.CalledProcessError:
+                return False
+            else:
+                # This works for upstart scripts where the 'service' command
+                # returns a consistent string to represent running
+                # 'start/running'
+                if ("start/running" in output or
+                        "is running" in output or
+                        "up and running" in output):
+                    return True
+        elif os.path.exists(_INIT_D_CONF.format(service_name)):
+            # Check System V scripts init script return codes
+            return service('status', service_name)
+        return False
+
+
+SYSTEMD_SYSTEM = '/run/systemd/system'
+
+
+def init_is_systemd():
+    """Return True if the host system uses systemd, False otherwise."""
+    if lsb_release()['DISTRIB_CODENAME'] == 'trusty':
+        return False
+    return os.path.isdir(SYSTEMD_SYSTEM)
+
+
+def adduser(username, password=None, shell='/bin/bash',
+            system_user=False, primary_group=None,
+            secondary_groups=None, uid=None, home_dir=None):
+    """Add a user to the system.
+
+    Will log but otherwise succeed if the user already exists.
+
+    :param str username: Username to create
+    :param str password: Password for user; if ``None``, create a system user
+    :param str shell: The default shell for the user
+    :param bool system_user: Whether to create a login or system user
+    :param str primary_group: Primary group for user; defaults to username
+    :param list secondary_groups: Optional list of additional groups
+    :param int uid: UID for user being created
+    :param str home_dir: Home directory for user
+
+    :returns: The password database entry struct, as returned by `pwd.getpwnam`
+    """
+    try:
+        user_info = pwd.getpwnam(username)
+        log('user {0} already exists!'.format(username))
+        if uid:
+            user_info = pwd.getpwuid(int(uid))
+            log('user with uid {0} already exists!'.format(uid))
+    except KeyError:
+        log('creating user {0}'.format(username))
+        cmd = ['useradd']
+        if uid:
+            cmd.extend(['--uid', str(uid)])
+        if home_dir:
+            cmd.extend(['--home', str(home_dir)])
+        if system_user or password is None:
+            cmd.append('--system')
+        else:
+            cmd.extend([
+                '--create-home',
+                '--shell', shell,
+                '--password', password,
+            ])
+        if not primary_group:
+            try:
+                grp.getgrnam(username)
+                primary_group = username  # avoid "group exists" error
+            except KeyError:
+                pass
+        if primary_group:
+            cmd.extend(['-g', primary_group])
+        if secondary_groups:
+            cmd.extend(['-G', ','.join(secondary_groups)])
+        cmd.append(username)
+        subprocess.check_call(cmd)
+        user_info = pwd.getpwnam(username)
+    return user_info
+
+
+def user_exists(username):
+    """Check if a user exists"""
+    try:
+        pwd.getpwnam(username)
+        user_exists = True
+    except KeyError:
+        user_exists = False
+    return user_exists
+
+
+def uid_exists(uid):
+    """Check if a uid exists"""
+    try:
+        pwd.getpwuid(uid)
+        uid_exists = True
+    except KeyError:
+        uid_exists = False
+    return uid_exists
+
+
+def group_exists(groupname):
+    """Check if a group exists"""
+    try:
+        grp.getgrnam(groupname)
+        group_exists = True
+    except KeyError:
+        group_exists = False
+    return group_exists
+
+
+def gid_exists(gid):
+    """Check if a gid exists"""
+    try:
+        grp.getgrgid(gid)
+        gid_exists = True
+    except KeyError:
+        gid_exists = False
+    return gid_exists
+
+
+def add_group(group_name, system_group=False, gid=None):
+    """Add a group to the system
+
+    Will log but otherwise succeed if the group already exists.
+
+    :param str group_name: group to create
+    :param bool system_group: Create system group
+    :param int gid: GID for user being created
+
+    :returns: The password database entry struct, as returned by `grp.getgrnam`
+    """
+    try:
+        group_info = grp.getgrnam(group_name)
+        log('group {0} already exists!'.format(group_name))
+        if gid:
+            group_info = grp.getgrgid(gid)
+            log('group with gid {0} already exists!'.format(gid))
+    except KeyError:
+        log('creating group {0}'.format(group_name))
+        add_new_group(group_name, system_group, gid)
+        group_info = grp.getgrnam(group_name)
+    return group_info
+
+
+def add_user_to_group(username, group):
+    """Add a user to a group"""
+    cmd = ['gpasswd', '-a', username, group]
+    log("Adding user {} to group {}".format(username, group))
+    subprocess.check_call(cmd)
+
+
+def chage(username, lastday=None, expiredate=None, inactive=None,
+          mindays=None, maxdays=None, root=None, warndays=None):
+    """Change user password expiry information
+
+    :param str username: User to update
+    :param str lastday: Set when password was changed in YYYY-MM-DD format
+    :param str expiredate: Set when user's account will no longer be
+                           accessible in YYYY-MM-DD format.
+                           -1 will remove an account expiration date.
+    :param str inactive: Set the number of days of inactivity after a password
+                         has expired before the account is locked.
+                         -1 will remove an account's inactivity.
+    :param str mindays: Set the minimum number of days between password
+                        changes to MIN_DAYS.
+                        0 indicates the password can be changed anytime.
+    :param str maxdays: Set the maximum number of days during which a
+                        password is valid.
+                        -1 as MAX_DAYS will remove checking maxdays
+    :param str root: Apply changes in the CHROOT_DIR directory
+    :param str warndays: Set the number of days of warning before a password
+                         change is required
+    :raises subprocess.CalledProcessError: if call to chage fails
+    """
+    cmd = ['chage']
+    if root:
+        cmd.extend(['--root', root])
+    if lastday:
+        cmd.extend(['--lastday', lastday])
+    if expiredate:
+        cmd.extend(['--expiredate', expiredate])
+    if inactive:
+        cmd.extend(['--inactive', inactive])
+    if mindays:
+        cmd.extend(['--mindays', mindays])
+    if maxdays:
+        cmd.extend(['--maxdays', maxdays])
+    if warndays:
+        cmd.extend(['--warndays', warndays])
+    cmd.append(username)
+    subprocess.check_call(cmd)
+
+
+remove_password_expiry = functools.partial(chage, expiredate='-1', inactive='-1', mindays='0', maxdays='-1')
+
+
+def rsync(from_path, to_path, flags='-r', options=None, timeout=None):
+    """Replicate the contents of a path"""
+    options = options or ['--delete', '--executability']
+    cmd = ['/usr/bin/rsync', flags]
+    if timeout:
+        cmd = ['timeout', str(timeout)] + cmd
+    cmd.extend(options)
+    cmd.append(from_path)
+    cmd.append(to_path)
+    log(" ".join(cmd))
+    return subprocess.check_output(cmd, stderr=subprocess.STDOUT).decode('UTF-8').strip()
+
+
+def symlink(source, destination):
+    """Create a symbolic link"""
+    log("Symlinking {} as {}".format(source, destination))
+    cmd = [
+        'ln',
+        '-sf',
+        source,
+        destination,
+    ]
+    subprocess.check_call(cmd)
+
+
+def mkdir(path, owner='root', group='root', perms=0o555, force=False):
+    """Create a directory"""
+    log("Making dir {} {}:{} {:o}".format(path, owner, group,
+                                          perms))
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    realpath = os.path.abspath(path)
+    path_exists = os.path.exists(realpath)
+    if path_exists and force:
+        if not os.path.isdir(realpath):
+            log("Removing non-directory file {} prior to mkdir()".format(path))
+            os.unlink(realpath)
+            os.makedirs(realpath, perms)
+    elif not path_exists:
+        os.makedirs(realpath, perms)
+    os.chown(realpath, uid, gid)
+    os.chmod(realpath, perms)
+
+
+def write_file(path, content, owner='root', group='root', perms=0o444):
+    """Create or overwrite a file with the contents of a byte string."""
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    # lets see if we can grab the file and compare the context, to avoid doing
+    # a write.
+    existing_content = None
+    existing_uid, existing_gid, existing_perms = None, None, None
+    try:
+        with open(path, 'rb') as target:
+            existing_content = target.read()
+        stat = os.stat(path)
+        existing_uid, existing_gid, existing_perms = (
+            stat.st_uid, stat.st_gid, stat.st_mode
+        )
+    except Exception:
+        pass
+    if content != existing_content:
+        log("Writing file {} {}:{} {:o}".format(path, owner, group, perms),
+            level=DEBUG)
+        with open(path, 'wb') as target:
+            os.fchown(target.fileno(), uid, gid)
+            os.fchmod(target.fileno(), perms)
+            if six.PY3 and isinstance(content, six.string_types):
+                content = content.encode('UTF-8')
+            target.write(content)
+        return
+    # the contents were the same, but we might still need to change the
+    # ownership or permissions.
+    if existing_uid != uid:
+        log("Changing uid on already existing content: {} -> {}"
+            .format(existing_uid, uid), level=DEBUG)
+        os.chown(path, uid, -1)
+    if existing_gid != gid:
+        log("Changing gid on already existing content: {} -> {}"
+            .format(existing_gid, gid), level=DEBUG)
+        os.chown(path, -1, gid)
+    if existing_perms != perms:
+        log("Changing permissions on existing content: {} -> {}"
+            .format(existing_perms, perms), level=DEBUG)
+        os.chmod(path, perms)
+
+
+def fstab_remove(mp):
+    """Remove the given mountpoint entry from /etc/fstab"""
+    return Fstab.remove_by_mountpoint(mp)
+
+
+def fstab_add(dev, mp, fs, options=None):
+    """Adds the given device entry to the /etc/fstab file"""
+    return Fstab.add(dev, mp, fs, options=options)
+
+
+def mount(device, mountpoint, options=None, persist=False, filesystem="ext3"):
+    """Mount a filesystem at a particular mountpoint"""
+    cmd_args = ['mount']
+    if options is not None:
+        cmd_args.extend(['-o', options])
+    cmd_args.extend([device, mountpoint])
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error mounting {} at {}\n{}'.format(device, mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_add(device, mountpoint, filesystem, options=options)
+    return True
+
+
+def umount(mountpoint, persist=False):
+    """Unmount a filesystem"""
+    cmd_args = ['umount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+
+    if persist:
+        return fstab_remove(mountpoint)
+    return True
+
+
+def mounts():
+    """Get a list of all mounted volumes as [[mountpoint,device],[...]]"""
+    with open('/proc/mounts') as f:
+        # [['/mount/point','/dev/path'],[...]]
+        system_mounts = [m[1::-1] for m in [l.strip().split()
+                                            for l in f.readlines()]]
+    return system_mounts
+
+
+def fstab_mount(mountpoint):
+    """Mount filesystem using fstab"""
+    cmd_args = ['mount', mountpoint]
+    try:
+        subprocess.check_output(cmd_args)
+    except subprocess.CalledProcessError as e:
+        log('Error unmounting {}\n{}'.format(mountpoint, e.output))
+        return False
+    return True
+
+
+def file_hash(path, hash_type='md5'):
+    """Generate a hash checksum of the contents of 'path' or None if not found.
+
+    :param str hash_type: Any hash alrgorithm supported by :mod:`hashlib`,
+                          such as md5, sha1, sha256, sha512, etc.
+    """
+    if os.path.exists(path):
+        h = getattr(hashlib, hash_type)()
+        with open(path, 'rb') as source:
+            h.update(source.read())
+        return h.hexdigest()
+    else:
+        return None
+
+
+def path_hash(path):
+    """Generate a hash checksum of all files matching 'path'. Standard
+    wildcards like '*' and '?' are supported, see documentation for the 'glob'
+    module for more information.
+
+    :return: dict: A { filename: hash } dictionary for all matched files.
+                   Empty if none found.
+    """
+    return {
+        filename: file_hash(filename)
+        for filename in glob.iglob(path)
+    }
+
+
+def check_hash(path, checksum, hash_type='md5'):
+    """Validate a file using a cryptographic checksum.
+
+    :param str checksum: Value of the checksum used to validate the file.
+    :param str hash_type: Hash algorithm used to generate `checksum`.
+        Can be any hash alrgorithm supported by :mod:`hashlib`,
+        such as md5, sha1, sha256, sha512, etc.
+    :raises ChecksumError: If the file fails the checksum
+
+    """
+    actual_checksum = file_hash(path, hash_type)
+    if checksum != actual_checksum:
+        raise ChecksumError("'%s' != '%s'" % (checksum, actual_checksum))
+
+
+class ChecksumError(ValueError):
+    """A class derived from Value error to indicate the checksum failed."""
+    pass
+
+
+def restart_on_change(restart_map, stopstart=False, restart_functions=None):
+    """Restart services based on configuration files changing
+
+    This function is used a decorator, for example::
+
+        @restart_on_change({
+            '/etc/ceph/ceph.conf': [ 'cinder-api', 'cinder-volume' ]
+            '/etc/apache/sites-enabled/*': [ 'apache2' ]
+            })
+        def config_changed():
+            pass  # your code here
+
+    In this example, the cinder-api and cinder-volume services
+    would be restarted if /etc/ceph/ceph.conf is changed by the
+    ceph_client_changed function. The apache2 service would be
+    restarted if any file matching the pattern got changed, created
+    or removed. Standard wildcards are supported, see documentation
+    for the 'glob' module for more information.
+
+    @param restart_map: {path_file_name: [service_name, ...]
+    @param stopstart: DEFAULT false; whether to stop, start OR restart
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result from decorated function
+    """
+    def wrap(f):
+        @functools.wraps(f)
+        def wrapped_f(*args, **kwargs):
+            return restart_on_change_helper(
+                (lambda: f(*args, **kwargs)), restart_map, stopstart,
+                restart_functions)
+        return wrapped_f
+    return wrap
+
+
+def restart_on_change_helper(lambda_f, restart_map, stopstart=False,
+                             restart_functions=None):
+    """Helper function to perform the restart_on_change function.
+
+    This is provided for decorators to restart services if files described
+    in the restart_map have changed after an invocation of lambda_f().
+
+    @param lambda_f: function to call.
+    @param restart_map: {file: [service, ...]}
+    @param stopstart: whether to stop, start or restart a service
+    @param restart_functions: nonstandard functions to use to restart services
+                              {svc: func, ...}
+    @returns result of lambda_f()
+    """
+    if restart_functions is None:
+        restart_functions = {}
+    checksums = {path: path_hash(path) for path in restart_map}
+    r = lambda_f()
+    # create a list of lists of the services to restart
+    restarts = [restart_map[path]
+                for path in restart_map
+                if path_hash(path) != checksums[path]]
+    # create a flat list of ordered services without duplicates from lists
+    services_list = list(OrderedDict.fromkeys(itertools.chain(*restarts)))
+    if services_list:
+        actions = ('stop', 'start') if stopstart else ('restart',)
+        for service_name in services_list:
+            if service_name in restart_functions:
+                restart_functions[service_name](service_name)
+            else:
+                for action in actions:
+                    service(action, service_name)
+    return r
+
+
+def pwgen(length=None):
+    """Generate a random pasword."""
+    if length is None:
+        # A random length is ok to use a weak PRNG
+        length = random.choice(range(35, 45))
+    alphanumeric_chars = [
+        l for l in (string.ascii_letters + string.digits)
+        if l not in 'l0QD1vAEIOUaeiou']
+    # Use a crypto-friendly PRNG (e.g. /dev/urandom) for making the
+    # actual password
+    random_generator = random.SystemRandom()
+    random_chars = [
+        random_generator.choice(alphanumeric_chars) for _ in range(length)]
+    return(''.join(random_chars))
+
+
+def is_phy_iface(interface):
+    """Returns True if interface is not virtual, otherwise False."""
+    if interface:
+        sys_net = '/sys/class/net'
+        if os.path.isdir(sys_net):
+            for iface in glob.glob(os.path.join(sys_net, '*')):
+                if '/virtual/' in os.path.realpath(iface):
+                    continue
+
+                if interface == os.path.basename(iface):
+                    return True
+
+    return False
+
+
+def get_bond_master(interface):
+    """Returns bond master if interface is bond slave otherwise None.
+
+    NOTE: the provided interface is expected to be physical
+    """
+    if interface:
+        iface_path = '/sys/class/net/%s' % (interface)
+        if os.path.exists(iface_path):
+            if '/virtual/' in os.path.realpath(iface_path):
+                return None
+
+            master = os.path.join(iface_path, 'master')
+            if os.path.exists(master):
+                master = os.path.realpath(master)
+                # make sure it is a bond master
+                if os.path.exists(os.path.join(master, 'bonding')):
+                    return os.path.basename(master)
+
+    return None
+
+
+def list_nics(nic_type=None):
+    """Return a list of nics of given type(s)"""
+    if isinstance(nic_type, six.string_types):
+        int_types = [nic_type]
+    else:
+        int_types = nic_type
+
+    interfaces = []
+    if nic_type:
+        for int_type in int_types:
+            cmd = ['ip', 'addr', 'show', 'label', int_type + '*']
+            ip_output = subprocess.check_output(cmd).decode('UTF-8')
+            ip_output = ip_output.split('\n')
+            ip_output = (line for line in ip_output if line)
+            for line in ip_output:
+                if line.split()[1].startswith(int_type):
+                    matched = re.search('.*: (' + int_type +
+                                        r'[0-9]+\.[0-9]+)@.*', line)
+                    if matched:
+                        iface = matched.groups()[0]
+                    else:
+                        iface = line.split()[1].replace(":", "")
+
+                    if iface not in interfaces:
+                        interfaces.append(iface)
+    else:
+        cmd = ['ip', 'a']
+        ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+        ip_output = (line.strip() for line in ip_output if line)
+
+        key = re.compile(r'^[0-9]+:\s+(.+):')
+        for line in ip_output:
+            matched = re.search(key, line)
+            if matched:
+                iface = matched.group(1)
+                iface = iface.partition("@")[0]
+                if iface not in interfaces:
+                    interfaces.append(iface)
+
+    return interfaces
+
+
+def set_nic_mtu(nic, mtu):
+    """Set the Maximum Transmission Unit (MTU) on a network interface."""
+    cmd = ['ip', 'link', 'set', nic, 'mtu', mtu]
+    subprocess.check_call(cmd)
+
+
+def get_nic_mtu(nic):
+    """Return the Maximum Transmission Unit (MTU) for a network interface."""
+    cmd = ['ip', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8').split('\n')
+    mtu = ""
+    for line in ip_output:
+        words = line.split()
+        if 'mtu' in words:
+            mtu = words[words.index("mtu") + 1]
+    return mtu
+
+
+def get_nic_hwaddr(nic):
+    """Return the Media Access Control (MAC) for a network interface."""
+    cmd = ['ip', '-o', '-0', 'addr', 'show', nic]
+    ip_output = subprocess.check_output(cmd).decode('UTF-8')
+    hwaddr = ""
+    words = ip_output.split()
+    if 'link/ether' in words:
+        hwaddr = words[words.index('link/ether') + 1]
+    return hwaddr
+
+
+@contextmanager
+def chdir(directory):
+    """Change the current working directory to a different directory for a code
+    block and return the previous directory after the block exits. Useful to
+    run commands from a specificed directory.
+
+    :param str directory: The directory path to change to for this context.
+    """
+    cur = os.getcwd()
+    try:
+        yield os.chdir(directory)
+    finally:
+        os.chdir(cur)
+
+
+def chownr(path, owner, group, follow_links=True, chowntopdir=False):
+    """Recursively change user and group ownership of files and directories
+    in given path. Doesn't chown path itself by default, only its children.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    :param bool follow_links: Also follow and chown links if True
+    :param bool chowntopdir: Also chown path itself if True
+    """
+    uid = pwd.getpwnam(owner).pw_uid
+    gid = grp.getgrnam(group).gr_gid
+    if follow_links:
+        chown = os.chown
+    else:
+        chown = os.lchown
+
+    if chowntopdir:
+        broken_symlink = os.path.lexists(path) and not os.path.exists(path)
+        if not broken_symlink:
+            chown(path, uid, gid)
+    for root, dirs, files in os.walk(path, followlinks=follow_links):
+        for name in dirs + files:
+            full = os.path.join(root, name)
+            broken_symlink = os.path.lexists(full) and not os.path.exists(full)
+            if not broken_symlink:
+                chown(full, uid, gid)
+
+
+def lchownr(path, owner, group):
+    """Recursively change user and group ownership of files and directories
+    in a given path, not following symbolic links. See the documentation for
+    'os.lchown' for more information.
+
+    :param str path: The string path to start changing ownership.
+    :param str owner: The owner string to use when looking up the uid.
+    :param str group: The group string to use when looking up the gid.
+    """
+    chownr(path, owner, group, follow_links=False)
+
+
+def owner(path):
+    """Returns a tuple containing the username & groupname owning the path.
+
+    :param str path: the string path to retrieve the ownership
+    :return tuple(str, str): A (username, groupname) tuple containing the
+                             name of the user and group owning the path.
+    :raises OSError: if the specified path does not exist
+    """
+    stat = os.stat(path)
+    username = pwd.getpwuid(stat.st_uid)[0]
+    groupname = grp.getgrgid(stat.st_gid)[0]
+    return username, groupname
+
+
+def get_total_ram():
+    """The total amount of system RAM in bytes.
+
+    This is what is reported by the OS, and may be overcommitted when
+    there are multiple containers hosted on the same machine.
+    """
+    with open('/proc/meminfo', 'r') as f:
+        for line in f.readlines():
+            if line:
+                key, value, unit = line.split()
+                if key == 'MemTotal:':
+                    assert unit == 'kB', 'Unknown unit'
+                    return int(value) * 1024  # Classic, not KiB.
+        raise NotImplementedError()
+
+
+UPSTART_CONTAINER_TYPE = '/run/container_type'
+
+
+def is_container():
+    """Determine whether unit is running in a container
+
+    @return: boolean indicating if unit is in a container
+    """
+    if init_is_systemd():
+        # Detect using systemd-detect-virt
+        return subprocess.call(['systemd-detect-virt',
+                                '--container']) == 0
+    else:
+        # Detect using upstart container file marker
+        return os.path.exists(UPSTART_CONTAINER_TYPE)
+
+
+def add_to_updatedb_prunepath(path, updatedb_path=UPDATEDB_PATH):
+    """Adds the specified path to the mlocate's udpatedb.conf PRUNEPATH list.
+
+    This method has no effect if the path specified by updatedb_path does not
+    exist or is not a file.
+
+    @param path: string the path to add to the updatedb.conf PRUNEPATHS value
+    @param updatedb_path: the path the updatedb.conf file
+    """
+    if not os.path.exists(updatedb_path) or os.path.isdir(updatedb_path):
+        # If the updatedb.conf file doesn't exist then don't attempt to update
+        # the file as the package providing mlocate may not be installed on
+        # the local system
+        return
+
+    with open(updatedb_path, 'r+') as f_id:
+        updatedb_text = f_id.read()
+        output = updatedb(updatedb_text, path)
+        f_id.seek(0)
+        f_id.write(output)
+        f_id.truncate()
+
+
+def updatedb(updatedb_text, new_path):
+    lines = [line for line in updatedb_text.split("\n")]
+    for i, line in enumerate(lines):
+        if line.startswith("PRUNEPATHS="):
+            paths_line = line.split("=")[1].replace('"', '')
+            paths = paths_line.split(" ")
+            if new_path not in paths:
+                paths.append(new_path)
+                lines[i] = 'PRUNEPATHS="{}"'.format(' '.join(paths))
+    output = "\n".join(lines)
+    return output
+
+
+def modulo_distribution(modulo=3, wait=30, non_zero_wait=False):
+    """ Modulo distribution
+
+    This helper uses the unit number, a modulo value and a constant wait time
+    to produce a calculated wait time distribution. This is useful in large
+    scale deployments to distribute load during an expensive operation such as
+    service restarts.
+
+    If you have 1000 nodes that need to restart 100 at a time 1 minute at a
+    time:
+
+      time.wait(modulo_distribution(modulo=100, wait=60))
+      restart()
+
+    If you need restarts to happen serially set modulo to the exact number of
+    nodes and set a high constant wait time:
+
+      time.wait(modulo_distribution(modulo=10, wait=120))
+      restart()
+
+    @param modulo: int The modulo number creates the group distribution
+    @param wait: int The constant time wait value
+    @param non_zero_wait: boolean Override unit % modulo == 0,
+                          return modulo * wait. Used to avoid collisions with
+                          leader nodes which are often given priority.
+    @return: int Calculated time to wait for unit operation
+    """
+    unit_number = int(local_unit().split('/')[1])
+    calculated_wait_time = (unit_number % modulo) * wait
+    if non_zero_wait and calculated_wait_time == 0:
+        return modulo * wait
+    else:
+        return calculated_wait_time
+
+
+def install_ca_cert(ca_cert, name=None):
+    """
+    Install the given cert as a trusted CA.
+
+    The ``name`` is the stem of the filename where the cert is written, and if
+    not provided, it will default to ``juju-{charm_name}``.
+
+    If the cert is empty or None, or is unchanged, nothing is done.
+    """
+    if not ca_cert:
+        return
+    if not isinstance(ca_cert, bytes):
+        ca_cert = ca_cert.encode('utf8')
+    if not name:
+        name = 'juju-{}'.format(charm_name())
+    cert_file = '/usr/local/share/ca-certificates/{}.crt'.format(name)
+    new_hash = hashlib.md5(ca_cert).hexdigest()
+    if file_hash(cert_file) == new_hash:
+        return
+    log("Installing new CA cert at: {}".format(cert_file), level=INFO)
+    write_file(cert_file, ca_cert)
+    subprocess.check_call(['update-ca-certificates', '--fresh'])
+
+
+def get_system_env(key, default=None):
+    """Get data from system environment as represented in ``/etc/environment``.
+
+    :param key: Key to look up
+    :type key: str
+    :param default: Value to return if key is not found
+    :type default: any
+    :returns: Value for key if found or contents of default parameter
+    :rtype: any
+    :raises: subprocess.CalledProcessError
+    """
+    env_file = '/etc/environment'
+    # use the shell and env(1) to parse the global environments file.  This is
+    # done to get the correct result even if the user has shell variable
+    # substitutions or other shell logic in that file.
+    output = subprocess.check_output(
+        ['env', '-i', '/bin/bash', '-c',
+         'set -a && source {} && env'.format(env_file)],
+        universal_newlines=True)
+    for k, v in (line.split('=', 1)
+                 for line in output.splitlines() if '=' in line):
+        if k == key:
+            return v
+    else:
+        return default
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..7781a3961f23ce0b161ae08b11710466af8de814
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/centos.py
@@ -0,0 +1,72 @@
+import subprocess
+import yum
+import os
+
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Host releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+
+    def __init__(self, item):
+        raise NotImplementedError(
+            "CompareHostReleases() is not implemented for CentOS")
+
+
+def service_available(service_name):
+    # """Determine whether a system service is available."""
+    if os.path.isdir('/run/systemd/system'):
+        cmd = ['systemctl', 'is-enabled', service_name]
+    else:
+        cmd = ['service', service_name, 'is-enabled']
+    return subprocess.call(cmd) == 0
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['groupadd']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('-r')
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/os-release in a dict."""
+    d = {}
+    with open('/etc/os-release', 'r') as lsb:
+        for l in lsb:
+            s = l.split('=')
+            if len(s) != 2:
+                continue
+            d[s[0].strip()] = s[1].strip()
+    return d
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports YumBase function if the pkgcache argument
+    is None.
+    """
+    if not pkgcache:
+        y = yum.YumBase()
+        packages = y.doPackageLists()
+        pkgcache = {i.Name: i.version for i in packages['installed']}
+    pkg = pkgcache[package]
+    if pkg > revno:
+        return 1
+    if pkg < revno:
+        return -1
+    return 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3edc0687275b29762b45ebf3fe1b045bc9f568b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/host_factory/ubuntu.py
@@ -0,0 +1,116 @@
+import subprocess
+
+from charmhelpers.core.hookenv import cached
+from charmhelpers.core.strutils import BasicStringComparator
+
+
+UBUNTU_RELEASES = (
+    'lucid',
+    'maverick',
+    'natty',
+    'oneiric',
+    'precise',
+    'quantal',
+    'raring',
+    'saucy',
+    'trusty',
+    'utopic',
+    'vivid',
+    'wily',
+    'xenial',
+    'yakkety',
+    'zesty',
+    'artful',
+    'bionic',
+    'cosmic',
+    'disco',
+    'eoan',
+    'focal'
+)
+
+
+class CompareHostReleases(BasicStringComparator):
+    """Provide comparisons of Ubuntu releases.
+
+    Use in the form of
+
+    if CompareHostReleases(release) > 'trusty':
+        # do something with mitaka
+    """
+    _list = UBUNTU_RELEASES
+
+
+def service_available(service_name):
+    """Determine whether a system service is available"""
+    try:
+        subprocess.check_output(
+            ['service', service_name, 'status'],
+            stderr=subprocess.STDOUT).decode('UTF-8')
+    except subprocess.CalledProcessError as e:
+        return b'unrecognized service' not in e.output
+    else:
+        return True
+
+
+def add_new_group(group_name, system_group=False, gid=None):
+    cmd = ['addgroup']
+    if gid:
+        cmd.extend(['--gid', str(gid)])
+    if system_group:
+        cmd.append('--system')
+    else:
+        cmd.extend([
+            '--group',
+        ])
+    cmd.append(group_name)
+    subprocess.check_call(cmd)
+
+
+def lsb_release():
+    """Return /etc/lsb-release in a dict"""
+    d = {}
+    with open('/etc/lsb-release', 'r') as lsb:
+        for l in lsb:
+            k, v = l.split('=')
+            d[k.strip()] = v.strip()
+    return d
+
+
+def get_distrib_codename():
+    """Return the codename of the distribution
+    :returns: The codename
+    :rtype: str
+    """
+    return lsb_release()['DISTRIB_CODENAME'].lower()
+
+
+def cmp_pkgrevno(package, revno, pkgcache=None):
+    """Compare supplied revno with the revno of the installed package.
+
+    *  1 => Installed revno is greater than supplied arg
+    *  0 => Installed revno is the same as supplied arg
+    * -1 => Installed revno is less than supplied arg
+
+    This function imports apt_cache function from charmhelpers.fetch if
+    the pkgcache argument is None. Be sure to add charmhelpers.fetch if
+    you call this function, or pass an apt_pkg.Cache() instance.
+    """
+    from charmhelpers.fetch import apt_pkg
+    if not pkgcache:
+        from charmhelpers.fetch import apt_cache
+        pkgcache = apt_cache()
+    pkg = pkgcache[package]
+    return apt_pkg.version_compare(pkg.current_ver.ver_str, revno)
+
+
+@cached
+def arch():
+    """Return the package architecture as a string.
+
+    :returns: the architecture
+    :rtype: str
+    :raises: subprocess.CalledProcessError if dpkg command fails
+    """
+    return subprocess.check_output(
+        ['dpkg', '--print-architecture']
+    ).rstrip().decode('UTF-8')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hugepage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hugepage.py
new file mode 100644
index 0000000000000000000000000000000000000000..54b5b5e2fcf81eea5f2ebfbceb620ea68d725584
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/hugepage.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+from charmhelpers.core import fstab
+from charmhelpers.core import sysctl
+from charmhelpers.core.host import (
+    add_group,
+    add_user_to_group,
+    fstab_mount,
+    mkdir,
+)
+from charmhelpers.core.strutils import bytes_from_string
+from subprocess import check_output
+
+
+def hugepage_support(user, group='hugetlb', nr_hugepages=256,
+                     max_map_count=65536, mnt_point='/run/hugepages/kvm',
+                     pagesize='2MB', mount=True, set_shmmax=False):
+    """Enable hugepages on system.
+
+    Args:
+    user (str)  -- Username to allow access to hugepages to
+    group (str) -- Group name to own hugepages
+    nr_hugepages (int) -- Number of pages to reserve
+    max_map_count (int) -- Number of Virtual Memory Areas a process can own
+    mnt_point (str) -- Directory to mount hugepages on
+    pagesize (str) -- Size of hugepages
+    mount (bool) -- Whether to Mount hugepages
+    """
+    group_info = add_group(group)
+    gid = group_info.gr_gid
+    add_user_to_group(user, group)
+    if max_map_count < 2 * nr_hugepages:
+        max_map_count = 2 * nr_hugepages
+    sysctl_settings = {
+        'vm.nr_hugepages': nr_hugepages,
+        'vm.max_map_count': max_map_count,
+        'vm.hugetlb_shm_group': gid,
+    }
+    if set_shmmax:
+        shmmax_current = int(check_output(['sysctl', '-n', 'kernel.shmmax']))
+        shmmax_minsize = bytes_from_string(pagesize) * nr_hugepages
+        if shmmax_minsize > shmmax_current:
+            sysctl_settings['kernel.shmmax'] = shmmax_minsize
+    sysctl.create(yaml.dump(sysctl_settings), '/etc/sysctl.d/10-hugepage.conf')
+    mkdir(mnt_point, owner='root', group='root', perms=0o755, force=False)
+    lfstab = fstab.Fstab()
+    fstab_entry = lfstab.get_entry_by_attr('mountpoint', mnt_point)
+    if fstab_entry:
+        lfstab.remove_entry(fstab_entry)
+    entry = lfstab.Entry('nodev', mnt_point, 'hugetlbfs',
+                         'mode=1770,gid={},pagesize={}'.format(gid, pagesize), 0, 0)
+    lfstab.add_entry(entry)
+    if mount:
+        fstab_mount(mnt_point)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel.py
new file mode 100644
index 0000000000000000000000000000000000000000..e01f4f8ba73ee0d5ab7553740c2590a50e42f96d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel.py
@@ -0,0 +1,72 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+import subprocess
+
+from charmhelpers.osplatform import get_platform
+from charmhelpers.core.hookenv import (
+    log,
+    INFO
+)
+
+__platform__ = get_platform()
+if __platform__ == "ubuntu":
+    from charmhelpers.core.kernel_factory.ubuntu import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+elif __platform__ == "centos":
+    from charmhelpers.core.kernel_factory.centos import (  # NOQA:F401
+        persistent_modprobe,
+        update_initramfs,
+    )  # flake8: noqa -- ignore F401 for this import
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def modprobe(module, persist=True):
+    """Load a kernel module and configure for auto-load on reboot."""
+    cmd = ['modprobe', module]
+
+    log('Loading kernel module %s' % module, level=INFO)
+
+    subprocess.check_call(cmd)
+    if persist:
+        persistent_modprobe(module)
+
+
+def rmmod(module, force=False):
+    """Remove a module from the linux kernel"""
+    cmd = ['rmmod']
+    if force:
+        cmd.append('-f')
+    cmd.append(module)
+    log('Removing kernel module %s' % module, level=INFO)
+    return subprocess.check_call(cmd)
+
+
+def lsmod():
+    """Shows what kernel modules are currently loaded"""
+    return subprocess.check_output(['lsmod'],
+                                   universal_newlines=True)
+
+
+def is_module_loaded(module):
+    """Checks if a kernel module is already loaded"""
+    matches = re.findall('^%s[ ]+' % module, lsmod(), re.M)
+    return len(matches) > 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..1c402c1157900ff1ad5c6c296a409c9e8fb96d2b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/centos.py
@@ -0,0 +1,17 @@
+import subprocess
+import os
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    if not os.path.exists('/etc/rc.modules'):
+        open('/etc/rc.modules', 'a')
+        os.chmod('/etc/rc.modules', 111)
+    with open('/etc/rc.modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write('modprobe %s\n' % module)
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["dracut", "-f", version])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3de372fd3df38fe151cf79243f129cb504516f22
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/kernel_factory/ubuntu.py
@@ -0,0 +1,13 @@
+import subprocess
+
+
+def persistent_modprobe(module):
+    """Load a kernel module and configure for auto-load on reboot."""
+    with open('/etc/modules', 'r+') as modules:
+        if module not in modules.read():
+            modules.write(module + "\n")
+
+
+def update_initramfs(version='all'):
+    """Updates an initramfs image."""
+    return subprocess.check_call(["update-initramfs", "-k", version, "-u"])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..61fd074edc09de434859e48ae1b36baef0503708
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/__init__.py
@@ -0,0 +1,16 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .base import *  # NOQA
+from .helpers import *  # NOQA
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..179ad4f0c367dd6b13c10b201c3752d1c8daf05e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/base.py
@@ -0,0 +1,362 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import json
+from inspect import getargspec
+from collections import Iterable, OrderedDict
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+__all__ = ['ServiceManager', 'ManagerCallback',
+           'PortManagerCallback', 'open_ports', 'close_ports', 'manage_ports',
+           'service_restart', 'service_stop']
+
+
+class ServiceManager(object):
+    def __init__(self, services=None):
+        """
+        Register a list of services, given their definitions.
+
+        Service definitions are dicts in the following formats (all keys except
+        'service' are optional)::
+
+            {
+                "service": <service name>,
+                "required_data": <list of required data contexts>,
+                "provided_data": <list of provided data contexts>,
+                "data_ready": <one or more callbacks>,
+                "data_lost": <one or more callbacks>,
+                "start": <one or more callbacks>,
+                "stop": <one or more callbacks>,
+                "ports": <list of ports to manage>,
+            }
+
+        The 'required_data' list should contain dicts of required data (or
+        dependency managers that act like dicts and know how to collect the data).
+        Only when all items in the 'required_data' list are populated are the list
+        of 'data_ready' and 'start' callbacks executed.  See `is_ready()` for more
+        information.
+
+        The 'provided_data' list should contain relation data providers, most likely
+        a subclass of :class:`charmhelpers.core.services.helpers.RelationContext`,
+        that will indicate a set of data to set on a given relation.
+
+        The 'data_ready' value should be either a single callback, or a list of
+        callbacks, to be called when all items in 'required_data' pass `is_ready()`.
+        Each callback will be called with the service name as the only parameter.
+        After all of the 'data_ready' callbacks are called, the 'start' callbacks
+        are fired.
+
+        The 'data_lost' value should be either a single callback, or a list of
+        callbacks, to be called when a 'required_data' item no longer passes
+        `is_ready()`.  Each callback will be called with the service name as the
+        only parameter.  After all of the 'data_lost' callbacks are called,
+        the 'stop' callbacks are fired.
+
+        The 'start' value should be either a single callback, or a list of
+        callbacks, to be called when starting the service, after the 'data_ready'
+        callbacks are complete.  Each callback will be called with the service
+        name as the only parameter.  This defaults to
+        `[host.service_start, services.open_ports]`.
+
+        The 'stop' value should be either a single callback, or a list of
+        callbacks, to be called when stopping the service.  If the service is
+        being stopped because it no longer has all of its 'required_data', this
+        will be called after all of the 'data_lost' callbacks are complete.
+        Each callback will be called with the service name as the only parameter.
+        This defaults to `[services.close_ports, host.service_stop]`.
+
+        The 'ports' value should be a list of ports to manage.  The default
+        'start' handler will open the ports after the service is started,
+        and the default 'stop' handler will close the ports prior to stopping
+        the service.
+
+
+        Examples:
+
+        The following registers an Upstart service called bingod that depends on
+        a mongodb relation and which runs a custom `db_migrate` function prior to
+        restarting the service, and a Runit service called spadesd::
+
+            manager = services.ServiceManager([
+                {
+                    'service': 'bingod',
+                    'ports': [80, 443],
+                    'required_data': [MongoRelation(), config(), {'my': 'data'}],
+                    'data_ready': [
+                        services.template(source='bingod.conf'),
+                        services.template(source='bingod.ini',
+                                          target='/etc/bingod.ini',
+                                          owner='bingo', perms=0400),
+                    ],
+                },
+                {
+                    'service': 'spadesd',
+                    'data_ready': services.template(source='spadesd_run.j2',
+                                                    target='/etc/sv/spadesd/run',
+                                                    perms=0555),
+                    'start': runit_start,
+                    'stop': runit_stop,
+                },
+            ])
+            manager.manage()
+        """
+        self._ready_file = os.path.join(hookenv.charm_dir(), 'READY-SERVICES.json')
+        self._ready = None
+        self.services = OrderedDict()
+        for service in services or []:
+            service_name = service['service']
+            self.services[service_name] = service
+
+    def manage(self):
+        """
+        Handle the current hook by doing The Right Thing with the registered services.
+        """
+        hookenv._run_atstart()
+        try:
+            hook_name = hookenv.hook_name()
+            if hook_name == 'stop':
+                self.stop_services()
+            else:
+                self.reconfigure_services()
+                self.provide_data()
+        except SystemExit as x:
+            if x.code is None or x.code == 0:
+                hookenv._run_atexit()
+        hookenv._run_atexit()
+
+    def provide_data(self):
+        """
+        Set the relation data for each provider in the ``provided_data`` list.
+
+        A provider must have a `name` attribute, which indicates which relation
+        to set data on, and a `provide_data()` method, which returns a dict of
+        data to set.
+
+        The `provide_data()` method can optionally accept two parameters:
+
+          * ``remote_service`` The name of the remote service that the data will
+            be provided to.  The `provide_data()` method will be called once
+            for each connected service (not unit).  This allows the method to
+            tailor its data to the given service.
+          * ``service_ready`` Whether or not the service definition had all of
+            its requirements met, and thus the ``data_ready`` callbacks run.
+
+        Note that the ``provided_data`` methods are now called **after** the
+        ``data_ready`` callbacks are run.  This gives the ``data_ready`` callbacks
+        a chance to generate any data necessary for the providing to the remote
+        services.
+        """
+        for service_name, service in self.services.items():
+            service_ready = self.is_ready(service_name)
+            for provider in service.get('provided_data', []):
+                for relid in hookenv.relation_ids(provider.name):
+                    units = hookenv.related_units(relid)
+                    if not units:
+                        continue
+                    remote_service = units[0].split('/')[0]
+                    argspec = getargspec(provider.provide_data)
+                    if len(argspec.args) > 1:
+                        data = provider.provide_data(remote_service, service_ready)
+                    else:
+                        data = provider.provide_data()
+                    if data:
+                        hookenv.relation_set(relid, data)
+
+    def reconfigure_services(self, *service_names):
+        """
+        Update all files for one or more registered services, and,
+        if ready, optionally restart them.
+
+        If no service names are given, reconfigures all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            if self.is_ready(service_name):
+                self.fire_event('data_ready', service_name)
+                self.fire_event('start', service_name, default=[
+                    service_restart,
+                    manage_ports])
+                self.save_ready(service_name)
+            else:
+                if self.was_ready(service_name):
+                    self.fire_event('data_lost', service_name)
+                self.fire_event('stop', service_name, default=[
+                    manage_ports,
+                    service_stop])
+                self.save_lost(service_name)
+
+    def stop_services(self, *service_names):
+        """
+        Stop one or more registered services, by name.
+
+        If no service names are given, stops all registered services.
+        """
+        for service_name in service_names or self.services.keys():
+            self.fire_event('stop', service_name, default=[
+                manage_ports,
+                service_stop])
+
+    def get_service(self, service_name):
+        """
+        Given the name of a registered service, return its service definition.
+        """
+        service = self.services.get(service_name)
+        if not service:
+            raise KeyError('Service not registered: %s' % service_name)
+        return service
+
+    def fire_event(self, event_name, service_name, default=None):
+        """
+        Fire a data_ready, data_lost, start, or stop event on a given service.
+        """
+        service = self.get_service(service_name)
+        callbacks = service.get(event_name, default)
+        if not callbacks:
+            return
+        if not isinstance(callbacks, Iterable):
+            callbacks = [callbacks]
+        for callback in callbacks:
+            if isinstance(callback, ManagerCallback):
+                callback(self, service_name, event_name)
+            else:
+                callback(service_name)
+
+    def is_ready(self, service_name):
+        """
+        Determine if a registered service is ready, by checking its 'required_data'.
+
+        A 'required_data' item can be any mapping type, and is considered ready
+        if `bool(item)` evaluates as True.
+        """
+        service = self.get_service(service_name)
+        reqs = service.get('required_data', [])
+        return all(bool(req) for req in reqs)
+
+    def _load_ready_file(self):
+        if self._ready is not None:
+            return
+        if os.path.exists(self._ready_file):
+            with open(self._ready_file) as fp:
+                self._ready = set(json.load(fp))
+        else:
+            self._ready = set()
+
+    def _save_ready_file(self):
+        if self._ready is None:
+            return
+        with open(self._ready_file, 'w') as fp:
+            json.dump(list(self._ready), fp)
+
+    def save_ready(self, service_name):
+        """
+        Save an indicator that the given service is now data_ready.
+        """
+        self._load_ready_file()
+        self._ready.add(service_name)
+        self._save_ready_file()
+
+    def save_lost(self, service_name):
+        """
+        Save an indicator that the given service is no longer data_ready.
+        """
+        self._load_ready_file()
+        self._ready.discard(service_name)
+        self._save_ready_file()
+
+    def was_ready(self, service_name):
+        """
+        Determine if the given service was previously data_ready.
+        """
+        self._load_ready_file()
+        return service_name in self._ready
+
+
+class ManagerCallback(object):
+    """
+    Special case of a callback that takes the `ServiceManager` instance
+    in addition to the service name.
+
+    Subclasses should implement `__call__` which should accept three parameters:
+
+        * `manager`       The `ServiceManager` instance
+        * `service_name`  The name of the service it's being triggered for
+        * `event_name`    The name of the event that this callback is handling
+    """
+    def __call__(self, manager, service_name, event_name):
+        raise NotImplementedError()
+
+
+class PortManagerCallback(ManagerCallback):
+    """
+    Callback class that will open or close ports, for use as either
+    a start or stop action.
+    """
+    def __call__(self, manager, service_name, event_name):
+        service = manager.get_service(service_name)
+        # turn this generator into a list,
+        # as we'll be going over it multiple times
+        new_ports = list(service.get('ports', []))
+        port_file = os.path.join(hookenv.charm_dir(), '.{}.ports'.format(service_name))
+        if os.path.exists(port_file):
+            with open(port_file) as fp:
+                old_ports = fp.read().split(',')
+            for old_port in old_ports:
+                if bool(old_port) and not self.ports_contains(old_port, new_ports):
+                    hookenv.close_port(old_port)
+        with open(port_file, 'w') as fp:
+            fp.write(','.join(str(port) for port in new_ports))
+        for port in new_ports:
+            # A port is either a number or 'ICMP'
+            protocol = 'TCP'
+            if str(port).upper() == 'ICMP':
+                protocol = 'ICMP'
+            if event_name == 'start':
+                hookenv.open_port(port, protocol)
+            elif event_name == 'stop':
+                hookenv.close_port(port, protocol)
+
+    def ports_contains(self, port, ports):
+        if not bool(port):
+            return False
+        if str(port).upper() != 'ICMP':
+            port = int(port)
+        return port in ports
+
+
+def service_stop(service_name):
+    """
+    Wrapper around host.service_stop to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_running(service_name):
+        host.service_stop(service_name)
+
+
+def service_restart(service_name):
+    """
+    Wrapper around host.service_restart to prevent spurious "unknown service"
+    messages in the logs.
+    """
+    if host.service_available(service_name):
+        if host.service_running(service_name):
+            host.service_restart(service_name)
+        else:
+            host.service_start(service_name)
+
+
+# Convenience aliases
+open_ports = close_ports = manage_ports = PortManagerCallback()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e6e30d2fe0d9c73ffdc42d70b77e864b6379c53
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/services/helpers.py
@@ -0,0 +1,290 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import yaml
+
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+from charmhelpers.core import templating
+
+from charmhelpers.core.services.base import ManagerCallback
+
+
+__all__ = ['RelationContext', 'TemplateCallback',
+           'render_template', 'template']
+
+
+class RelationContext(dict):
+    """
+    Base class for a context generator that gets relation data from juju.
+
+    Subclasses must provide the attributes `name`, which is the name of the
+    interface of interest, `interface`, which is the type of the interface of
+    interest, and `required_keys`, which is the set of keys required for the
+    relation to be considered complete.  The data for all interfaces matching
+    the `name` attribute that are complete will used to populate the dictionary
+    values (see `get_data`, below).
+
+    The generated context will be namespaced under the relation :attr:`name`,
+    to prevent potential naming conflicts.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = None
+    interface = None
+
+    def __init__(self, name=None, additional_required_keys=None):
+        if not hasattr(self, 'required_keys'):
+            self.required_keys = []
+
+        if name is not None:
+            self.name = name
+        if additional_required_keys:
+            self.required_keys.extend(additional_required_keys)
+        self.get_data()
+
+    def __bool__(self):
+        """
+        Returns True if all of the required_keys are available.
+        """
+        return self.is_ready()
+
+    __nonzero__ = __bool__
+
+    def __repr__(self):
+        return super(RelationContext, self).__repr__()
+
+    def is_ready(self):
+        """
+        Returns True if all of the `required_keys` are available from any units.
+        """
+        ready = len(self.get(self.name, [])) > 0
+        if not ready:
+            hookenv.log('Incomplete relation: {}'.format(self.__class__.__name__), hookenv.DEBUG)
+        return ready
+
+    def _is_ready(self, unit_data):
+        """
+        Helper method that tests a set of relation data and returns True if
+        all of the `required_keys` are present.
+        """
+        return set(unit_data.keys()).issuperset(set(self.required_keys))
+
+    def get_data(self):
+        """
+        Retrieve the relation data for each unit involved in a relation and,
+        if complete, store it in a list under `self[self.name]`.  This
+        is automatically called when the RelationContext is instantiated.
+
+        The units are sorted lexographically first by the service ID, then by
+        the unit ID.  Thus, if an interface has two other services, 'db:1'
+        and 'db:2', with 'db:1' having two units, 'wordpress/0' and 'wordpress/1',
+        and 'db:2' having one unit, 'mediawiki/0', all of which have a complete
+        set of data, the relation data for the units will be stored in the
+        order: 'wordpress/0', 'wordpress/1', 'mediawiki/0'.
+
+        If you only care about a single unit on the relation, you can just
+        access it as `{{ interface[0]['key'] }}`.  However, if you can at all
+        support multiple units on a relation, you should iterate over the list,
+        like::
+
+            {% for unit in interface -%}
+                {{ unit['key'] }}{% if not loop.last %},{% endif %}
+            {%- endfor %}
+
+        Note that since all sets of relation data from all related services and
+        units are in a single list, if you need to know which service or unit a
+        set of data came from, you'll need to extend this class to preserve
+        that information.
+        """
+        if not hookenv.relation_ids(self.name):
+            return
+
+        ns = self.setdefault(self.name, [])
+        for rid in sorted(hookenv.relation_ids(self.name)):
+            for unit in sorted(hookenv.related_units(rid)):
+                reldata = hookenv.relation_get(rid=rid, unit=unit)
+                if self._is_ready(reldata):
+                    ns.append(reldata)
+
+    def provide_data(self):
+        """
+        Return data to be relation_set for this interface.
+        """
+        return {}
+
+
+class MysqlRelation(RelationContext):
+    """
+    Relation context for the `mysql` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'db'
+    interface = 'mysql'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'user', 'password', 'database']
+        RelationContext.__init__(self, *args, **kwargs)
+
+
+class HttpRelation(RelationContext):
+    """
+    Relation context for the `http` interface.
+
+    :param str name: Override the relation :attr:`name`, since it can vary from charm to charm
+    :param list additional_required_keys: Extend the list of :attr:`required_keys`
+    """
+    name = 'website'
+    interface = 'http'
+
+    def __init__(self, *args, **kwargs):
+        self.required_keys = ['host', 'port']
+        RelationContext.__init__(self, *args, **kwargs)
+
+    def provide_data(self):
+        return {
+            'host': hookenv.unit_get('private-address'),
+            'port': 80,
+        }
+
+
+class RequiredConfig(dict):
+    """
+    Data context that loads config options with one or more mandatory options.
+
+    Once the required options have been changed from their default values, all
+    config options will be available, namespaced under `config` to prevent
+    potential naming conflicts (for example, between a config option and a
+    relation property).
+
+    :param list *args: List of options that must be changed from their default values.
+    """
+
+    def __init__(self, *args):
+        self.required_options = args
+        self['config'] = hookenv.config()
+        with open(os.path.join(hookenv.charm_dir(), 'config.yaml')) as fp:
+            self.config = yaml.load(fp).get('options', {})
+
+    def __bool__(self):
+        for option in self.required_options:
+            if option not in self['config']:
+                return False
+            current_value = self['config'][option]
+            default_value = self.config[option].get('default')
+            if current_value == default_value:
+                return False
+            if current_value in (None, '') and default_value in (None, ''):
+                return False
+        return True
+
+    def __nonzero__(self):
+        return self.__bool__()
+
+
+class StoredContext(dict):
+    """
+    A data context that always returns the data that it was first created with.
+
+    This is useful to do a one-time generation of things like passwords, that
+    will thereafter use the same value that was originally generated, instead
+    of generating a new value each time it is run.
+    """
+    def __init__(self, file_name, config_data):
+        """
+        If the file exists, populate `self` with the data from the file.
+        Otherwise, populate with the given data and persist it to the file.
+        """
+        if os.path.exists(file_name):
+            self.update(self.read_context(file_name))
+        else:
+            self.store_context(file_name, config_data)
+            self.update(config_data)
+
+    def store_context(self, file_name, config_data):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'w') as file_stream:
+            os.fchmod(file_stream.fileno(), 0o600)
+            yaml.dump(config_data, file_stream)
+
+    def read_context(self, file_name):
+        if not os.path.isabs(file_name):
+            file_name = os.path.join(hookenv.charm_dir(), file_name)
+        with open(file_name, 'r') as file_stream:
+            data = yaml.load(file_stream)
+            if not data:
+                raise OSError("%s is empty" % file_name)
+            return data
+
+
+class TemplateCallback(ManagerCallback):
+    """
+    Callback class that will render a Jinja2 template, for use as a ready
+    action.
+
+    :param str source: The template source file, relative to
+        `$CHARM_DIR/templates`
+
+    :param str target: The target to write the rendered template to (or None)
+    :param str owner: The owner of the rendered file
+    :param str group: The group of the rendered file
+    :param int perms: The permissions of the rendered file
+    :param partial on_change_action: functools partial to be executed when
+                                     rendered file changes
+    :param jinja2 loader template_loader: A jinja2 template loader
+
+    :return str: The rendered template
+    """
+    def __init__(self, source, target,
+                 owner='root', group='root', perms=0o444,
+                 on_change_action=None, template_loader=None):
+        self.source = source
+        self.target = target
+        self.owner = owner
+        self.group = group
+        self.perms = perms
+        self.on_change_action = on_change_action
+        self.template_loader = template_loader
+
+    def __call__(self, manager, service_name, event_name):
+        pre_checksum = ''
+        if self.on_change_action and os.path.isfile(self.target):
+            pre_checksum = host.file_hash(self.target)
+        service = manager.get_service(service_name)
+        context = {'ctx': {}}
+        for ctx in service.get('required_data', []):
+            context.update(ctx)
+            context['ctx'].update(ctx)
+
+        result = templating.render(self.source, self.target, context,
+                                   self.owner, self.group, self.perms,
+                                   template_loader=self.template_loader)
+        if self.on_change_action:
+            if pre_checksum == host.file_hash(self.target):
+                hookenv.log(
+                    'No change detected: {}'.format(self.target),
+                    hookenv.DEBUG)
+            else:
+                self.on_change_action()
+
+        return result
+
+
+# Convenience aliases for templates
+render_template = template = TemplateCallback
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/strutils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/strutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8df0452f8203b53947eb137eed22d85ff62dff0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/strutils.py
@@ -0,0 +1,129 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import re
+
+
+def bool_from_string(value):
+    """Interpret string value as boolean.
+
+    Returns True if value translates to True otherwise False.
+    """
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as boolean" % (value)
+        raise ValueError(msg)
+
+    value = value.strip().lower()
+
+    if value in ['y', 'yes', 'true', 't', 'on']:
+        return True
+    elif value in ['n', 'no', 'false', 'f', 'off']:
+        return False
+
+    msg = "Unable to interpret string value '%s' as boolean" % (value)
+    raise ValueError(msg)
+
+
+def bytes_from_string(value):
+    """Interpret human readable string value as bytes.
+
+    Returns int
+    """
+    BYTE_POWER = {
+        'K': 1,
+        'KB': 1,
+        'M': 2,
+        'MB': 2,
+        'G': 3,
+        'GB': 3,
+        'T': 4,
+        'TB': 4,
+        'P': 5,
+        'PB': 5,
+    }
+    if isinstance(value, six.string_types):
+        value = six.text_type(value)
+    else:
+        msg = "Unable to interpret non-string value '%s' as bytes" % (value)
+        raise ValueError(msg)
+    matches = re.match("([0-9]+)([a-zA-Z]+)", value)
+    if matches:
+        size = int(matches.group(1)) * (1024 ** BYTE_POWER[matches.group(2)])
+    else:
+        # Assume that value passed in is bytes
+        try:
+            size = int(value)
+        except ValueError:
+            msg = "Unable to interpret string value '%s' as bytes" % (value)
+            raise ValueError(msg)
+    return size
+
+
+class BasicStringComparator(object):
+    """Provides a class that will compare strings from an iterator type object.
+    Used to provide > and < comparisons on strings that may not necessarily be
+    alphanumerically ordered.  e.g. OpenStack or Ubuntu releases AFTER the
+    z-wrap.
+    """
+
+    _list = None
+
+    def __init__(self, item):
+        if self._list is None:
+            raise Exception("Must define the _list in the class definition!")
+        try:
+            self.index = self._list.index(item)
+        except Exception:
+            raise KeyError("Item '{}' is not in list '{}'"
+                           .format(item, self._list))
+
+    def __eq__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index == self._list.index(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index < self._list.index(other)
+
+    def __ge__(self, other):
+        return not self.__lt__(other)
+
+    def __gt__(self, other):
+        assert isinstance(other, str) or isinstance(other, self.__class__)
+        return self.index > self._list.index(other)
+
+    def __le__(self, other):
+        return not self.__gt__(other)
+
+    def __str__(self):
+        """Always give back the item at the index so it can be used in
+        comparisons like:
+
+        s_mitaka = CompareOpenStack('mitaka')
+        s_newton = CompareOpenstack('newton')
+
+        assert s_newton > s_mitaka
+
+        @returns: <string>
+        """
+        return self._list[self.index]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..386428d619bc38edf02dc088bf7ec32767c0ab94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/sysctl.py
@@ -0,0 +1,75 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import yaml
+
+from subprocess import check_call, CalledProcessError
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    ERROR,
+    WARNING,
+)
+
+from charmhelpers.core.host import is_container
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+def create(sysctl_dict, sysctl_file, ignore=False):
+    """Creates a sysctl.conf file from a YAML associative array
+
+    :param sysctl_dict: a dict or YAML-formatted string of sysctl
+                        options eg "{ 'kernel.max_pid': 1337 }"
+    :type sysctl_dict: str
+    :param sysctl_file: path to the sysctl file to be saved
+    :type sysctl_file: str or unicode
+    :param ignore: If True, ignore "unknown variable" errors.
+    :type ignore: bool
+    :returns: None
+    """
+    if type(sysctl_dict) is not dict:
+        try:
+            sysctl_dict_parsed = yaml.safe_load(sysctl_dict)
+        except yaml.YAMLError:
+            log("Error parsing YAML sysctl_dict: {}".format(sysctl_dict),
+                level=ERROR)
+            return
+    else:
+        sysctl_dict_parsed = sysctl_dict
+
+    with open(sysctl_file, "w") as fd:
+        for key, value in sysctl_dict_parsed.items():
+            fd.write("{}={}\n".format(key, value))
+
+    log("Updating sysctl_file: {} values: {}".format(sysctl_file,
+                                                     sysctl_dict_parsed),
+        level=DEBUG)
+
+    call = ["sysctl", "-p", sysctl_file]
+    if ignore:
+        call.append("-e")
+
+    try:
+        check_call(call)
+    except CalledProcessError as e:
+        if is_container():
+            log("Error setting some sysctl keys in this container: {}".format(e.output),
+                level=WARNING)
+        else:
+            raise e
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..9014015c14ee0b48c775562cd4f0d30884944439
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/templating.py
@@ -0,0 +1,93 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+
+from charmhelpers.core import host
+from charmhelpers.core import hookenv
+
+
+def render(source, target, context, owner='root', group='root',
+           perms=0o444, templates_dir=None, encoding='UTF-8',
+           template_loader=None, config_template=None):
+    """
+    Render a template.
+
+    The `source` path, if not absolute, is relative to the `templates_dir`.
+
+    The `target` path should be absolute.  It can also be `None`, in which
+    case no file will be written.
+
+    The context should be a dict containing the values to be replaced in the
+    template.
+
+    config_template may be provided to render from a provided template instead
+    of loading from a file.
+
+    The `owner`, `group`, and `perms` options will be passed to `write_file`.
+
+    If omitted, `templates_dir` defaults to the `templates` folder in the charm.
+
+    The rendered template will be written to the file as well as being returned
+    as a string.
+
+    Note: Using this requires python-jinja2 or python3-jinja2; if it is not
+    installed, calling this will attempt to use charmhelpers.fetch.apt_install
+    to install it.
+    """
+    try:
+        from jinja2 import FileSystemLoader, Environment, exceptions
+    except ImportError:
+        try:
+            from charmhelpers.fetch import apt_install
+        except ImportError:
+            hookenv.log('Could not import jinja2, and could not import '
+                        'charmhelpers.fetch to install it',
+                        level=hookenv.ERROR)
+            raise
+        if sys.version_info.major == 2:
+            apt_install('python-jinja2', fatal=True)
+        else:
+            apt_install('python3-jinja2', fatal=True)
+        from jinja2 import FileSystemLoader, Environment, exceptions
+
+    if template_loader:
+        template_env = Environment(loader=template_loader)
+    else:
+        if templates_dir is None:
+            templates_dir = os.path.join(hookenv.charm_dir(), 'templates')
+        template_env = Environment(loader=FileSystemLoader(templates_dir))
+
+    # load from a string if provided explicitly
+    if config_template is not None:
+        template = template_env.from_string(config_template)
+    else:
+        try:
+            source = source
+            template = template_env.get_template(source)
+        except exceptions.TemplateNotFound as e:
+            hookenv.log('Could not load template %s from %s.' %
+                        (source, templates_dir),
+                        level=hookenv.ERROR)
+            raise e
+    content = template.render(context)
+    if target is not None:
+        target_dir = os.path.dirname(target)
+        if not os.path.exists(target_dir):
+            # This is a terrible default directory permission, as the file
+            # or its siblings will often contain secrets.
+            host.mkdir(os.path.dirname(target), owner, group, perms=0o755)
+        host.write_file(target, content.encode(encoding), owner, group, perms)
+    return content
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab554327b343f896880523fc627c1abea84be29a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/core/unitdata.py
@@ -0,0 +1,525 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Authors:
+#  Kapil Thangavelu <kapil.foss@gmail.com>
+#
+"""
+Intro
+-----
+
+A simple way to store state in units. This provides a key value
+storage with support for versioned, transactional operation,
+and can calculate deltas from previous values to simplify unit logic
+when processing changes.
+
+
+Hook Integration
+----------------
+
+There are several extant frameworks for hook execution, including
+
+ - charmhelpers.core.hookenv.Hooks
+ - charmhelpers.core.services.ServiceManager
+
+The storage classes are framework agnostic, one simple integration is
+via the HookData contextmanager. It will record the current hook
+execution environment (including relation data, config data, etc.),
+setup a transaction and allow easy access to the changes from
+previously seen values. One consequence of the integration is the
+reservation of particular keys ('rels', 'unit', 'env', 'config',
+'charm_revisions') for their respective values.
+
+Here's a fully worked integration example using hookenv.Hooks::
+
+       from charmhelper.core import hookenv, unitdata
+
+       hook_data = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # Print all changes to configuration from previously seen
+           # values.
+           for changed, (prev, cur) in hook_data.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+           # Directly access all charm config as a mapping.
+           conf = db.getrange('config', True)
+
+           # Directly access all relation data as a mapping
+           rels = db.getrange('rels', True)
+
+       if __name__ == '__main__':
+           with hook_data():
+               hook.execute()
+
+
+A more basic integration is via the hook_scope context manager which simply
+manages transaction scope (and records hook name, and timestamp)::
+
+  >>> from unitdata import kv
+  >>> db = kv()
+  >>> with db.hook_scope('install'):
+  ...    # do work, in transactional scope.
+  ...    db.set('x', 1)
+  >>> db.get('x')
+  1
+
+
+Usage
+-----
+
+Values are automatically json de/serialized to preserve basic typing
+and complex data struct capabilities (dicts, lists, ints, booleans, etc).
+
+Individual values can be manipulated via get/set::
+
+   >>> kv.set('y', True)
+   >>> kv.get('y')
+   True
+
+   # We can set complex values (dicts, lists) as a single key.
+   >>> kv.set('config', {'a': 1, 'b': True'})
+
+   # Also supports returning dictionaries as a record which
+   # provides attribute access.
+   >>> config = kv.get('config', record=True)
+   >>> config.b
+   True
+
+
+Groups of keys can be manipulated with update/getrange::
+
+   >>> kv.update({'z': 1, 'y': 2}, prefix="gui.")
+   >>> kv.getrange('gui.', strip=True)
+   {'z': 1, 'y': 2}
+
+When updating values, its very helpful to understand which values
+have actually changed and how have they changed. The storage
+provides a delta method to provide for this::
+
+   >>> data = {'debug': True, 'option': 2}
+   >>> delta = kv.delta(data, 'config.')
+   >>> delta.debug.previous
+   None
+   >>> delta.debug.current
+   True
+   >>> delta
+   {'debug': (None, True), 'option': (None, 2)}
+
+Note the delta method does not persist the actual change, it needs to
+be explicitly saved via 'update' method::
+
+   >>> kv.update(data, 'config.')
+
+Values modified in the context of a hook scope retain historical values
+associated to the hookname.
+
+   >>> with db.hook_scope('config-changed'):
+   ...      db.set('x', 42)
+   >>> db.gethistory('x')
+   [(1, u'x', 1, u'install', u'2015-01-21T16:49:30.038372'),
+    (2, u'x', 42, u'config-changed', u'2015-01-21T16:49:30.038786')]
+
+"""
+
+import collections
+import contextlib
+import datetime
+import itertools
+import json
+import os
+import pprint
+import sqlite3
+import sys
+
+__author__ = 'Kapil Thangavelu <kapil.foss@gmail.com>'
+
+
+class Storage(object):
+    """Simple key value database for local unit state within charms.
+
+    Modifications are not persisted unless :meth:`flush` is called.
+
+    To support dicts, lists, integer, floats, and booleans values
+    are automatically json encoded/decoded.
+
+    Note: to facilitate unit testing, ':memory:' can be passed as the
+    path parameter which causes sqlite3 to only build the db in memory.
+    This should only be used for testing purposes.
+    """
+    def __init__(self, path=None):
+        self.db_path = path
+        if path is None:
+            if 'UNIT_STATE_DB' in os.environ:
+                self.db_path = os.environ['UNIT_STATE_DB']
+            else:
+                self.db_path = os.path.join(
+                    os.environ.get('CHARM_DIR', ''), '.unit-state.db')
+        if self.db_path != ':memory:':
+            with open(self.db_path, 'a') as f:
+                os.fchmod(f.fileno(), 0o600)
+        self.conn = sqlite3.connect('%s' % self.db_path)
+        self.cursor = self.conn.cursor()
+        self.revision = None
+        self._closed = False
+        self._init()
+
+    def close(self):
+        if self._closed:
+            return
+        self.flush(False)
+        self.cursor.close()
+        self.conn.close()
+        self._closed = True
+
+    def get(self, key, default=None, record=False):
+        self.cursor.execute('select data from kv where key=?', [key])
+        result = self.cursor.fetchone()
+        if not result:
+            return default
+        if record:
+            return Record(json.loads(result[0]))
+        return json.loads(result[0])
+
+    def getrange(self, key_prefix, strip=False):
+        """
+        Get a range of keys starting with a common prefix as a mapping of
+        keys to values.
+
+        :param str key_prefix: Common prefix among all keys
+        :param bool strip: Optionally strip the common prefix from the key
+            names in the returned dict
+        :return dict: A (possibly empty) dict of key-value mappings
+        """
+        self.cursor.execute("select key, data from kv where key like ?",
+                            ['%s%%' % key_prefix])
+        result = self.cursor.fetchall()
+
+        if not result:
+            return {}
+        if not strip:
+            key_prefix = ''
+        return dict([
+            (k[len(key_prefix):], json.loads(v)) for k, v in result])
+
+    def update(self, mapping, prefix=""):
+        """
+        Set the values of multiple keys at once.
+
+        :param dict mapping: Mapping of keys to values
+        :param str prefix: Optional prefix to apply to all keys in `mapping`
+            before setting
+        """
+        for k, v in mapping.items():
+            self.set("%s%s" % (prefix, k), v)
+
+    def unset(self, key):
+        """
+        Remove a key from the database entirely.
+        """
+        self.cursor.execute('delete from kv where key=?', [key])
+        if self.revision and self.cursor.rowcount:
+            self.cursor.execute(
+                'insert into kv_revisions values (?, ?, ?)',
+                [key, self.revision, json.dumps('DELETED')])
+
+    def unsetrange(self, keys=None, prefix=""):
+        """
+        Remove a range of keys starting with a common prefix, from the database
+        entirely.
+
+        :param list keys: List of keys to remove.
+        :param str prefix: Optional prefix to apply to all keys in ``keys``
+            before removing.
+        """
+        if keys is not None:
+            keys = ['%s%s' % (prefix, key) for key in keys]
+            self.cursor.execute('delete from kv where key in (%s)' % ','.join(['?'] * len(keys)), keys)
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values %s' % ','.join(['(?, ?, ?)'] * len(keys)),
+                    list(itertools.chain.from_iterable((key, self.revision, json.dumps('DELETED')) for key in keys)))
+        else:
+            self.cursor.execute('delete from kv where key like ?',
+                                ['%s%%' % prefix])
+            if self.revision and self.cursor.rowcount:
+                self.cursor.execute(
+                    'insert into kv_revisions values (?, ?, ?)',
+                    ['%s%%' % prefix, self.revision, json.dumps('DELETED')])
+
+    def set(self, key, value):
+        """
+        Set a value in the database.
+
+        :param str key: Key to set the value for
+        :param value: Any JSON-serializable value to be set
+        """
+        serialized = json.dumps(value)
+
+        self.cursor.execute('select data from kv where key=?', [key])
+        exists = self.cursor.fetchone()
+
+        # Skip mutations to the same value
+        if exists:
+            if exists[0] == serialized:
+                return value
+
+        if not exists:
+            self.cursor.execute(
+                'insert into kv (key, data) values (?, ?)',
+                (key, serialized))
+        else:
+            self.cursor.execute('''
+            update kv
+            set data = ?
+            where key = ?''', [serialized, key])
+
+        # Save
+        if not self.revision:
+            return value
+
+        self.cursor.execute(
+            'select 1 from kv_revisions where key=? and revision=?',
+            [key, self.revision])
+        exists = self.cursor.fetchone()
+
+        if not exists:
+            self.cursor.execute(
+                '''insert into kv_revisions (
+                revision, key, data) values (?, ?, ?)''',
+                (self.revision, key, serialized))
+        else:
+            self.cursor.execute(
+                '''
+                update kv_revisions
+                set data = ?
+                where key = ?
+                and   revision = ?''',
+                [serialized, key, self.revision])
+
+        return value
+
+    def delta(self, mapping, prefix):
+        """
+        return a delta containing values that have changed.
+        """
+        previous = self.getrange(prefix, strip=True)
+        if not previous:
+            pk = set()
+        else:
+            pk = set(previous.keys())
+        ck = set(mapping.keys())
+        delta = DeltaSet()
+
+        # added
+        for k in ck.difference(pk):
+            delta[k] = Delta(None, mapping[k])
+
+        # removed
+        for k in pk.difference(ck):
+            delta[k] = Delta(previous[k], None)
+
+        # changed
+        for k in pk.intersection(ck):
+            c = mapping[k]
+            p = previous[k]
+            if c != p:
+                delta[k] = Delta(p, c)
+
+        return delta
+
+    @contextlib.contextmanager
+    def hook_scope(self, name=""):
+        """Scope all future interactions to the current hook execution
+        revision."""
+        assert not self.revision
+        self.cursor.execute(
+            'insert into hooks (hook, date) values (?, ?)',
+            (name or sys.argv[0],
+             datetime.datetime.utcnow().isoformat()))
+        self.revision = self.cursor.lastrowid
+        try:
+            yield self.revision
+            self.revision = None
+        except Exception:
+            self.flush(False)
+            self.revision = None
+            raise
+        else:
+            self.flush()
+
+    def flush(self, save=True):
+        if save:
+            self.conn.commit()
+        elif self._closed:
+            return
+        else:
+            self.conn.rollback()
+
+    def _init(self):
+        self.cursor.execute('''
+            create table if not exists kv (
+               key text,
+               data text,
+               primary key (key)
+               )''')
+        self.cursor.execute('''
+            create table if not exists kv_revisions (
+               key text,
+               revision integer,
+               data text,
+               primary key (key, revision)
+               )''')
+        self.cursor.execute('''
+            create table if not exists hooks (
+               version integer primary key autoincrement,
+               hook text,
+               date text
+               )''')
+        self.conn.commit()
+
+    def gethistory(self, key, deserialize=False):
+        self.cursor.execute(
+            '''
+            select kv.revision, kv.key, kv.data, h.hook, h.date
+            from kv_revisions kv,
+                 hooks h
+            where kv.key=?
+             and kv.revision = h.version
+            ''', [key])
+        if deserialize is False:
+            return self.cursor.fetchall()
+        return map(_parse_history, self.cursor.fetchall())
+
+    def debug(self, fh=sys.stderr):
+        self.cursor.execute('select * from kv')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+        self.cursor.execute('select * from kv_revisions')
+        pprint.pprint(self.cursor.fetchall(), stream=fh)
+
+
+def _parse_history(d):
+    return (d[0], d[1], json.loads(d[2]), d[3],
+            datetime.datetime.strptime(d[-1], "%Y-%m-%dT%H:%M:%S.%f"))
+
+
+class HookData(object):
+    """Simple integration for existing hook exec frameworks.
+
+    Records all unit information, and stores deltas for processing
+    by the hook.
+
+    Sample::
+
+       from charmhelper.core import hookenv, unitdata
+
+       changes = unitdata.HookData()
+       db = unitdata.kv()
+       hooks = hookenv.Hooks()
+
+       @hooks.hook
+       def config_changed():
+           # View all changes to configuration
+           for changed, (prev, cur) in changes.conf.items():
+               print('config changed', changed,
+                     'previous value', prev,
+                     'current value',  cur)
+
+           # Get some unit specific bookeeping
+           if not db.get('pkg_key'):
+               key = urllib.urlopen('https://example.com/pkg_key').read()
+               db.set('pkg_key', key)
+
+       if __name__ == '__main__':
+           with changes():
+               hook.execute()
+
+    """
+    def __init__(self):
+        self.kv = kv()
+        self.conf = None
+        self.rels = None
+
+    @contextlib.contextmanager
+    def __call__(self):
+        from charmhelpers.core import hookenv
+        hook_name = hookenv.hook_name()
+
+        with self.kv.hook_scope(hook_name):
+            self._record_charm_version(hookenv.charm_dir())
+            delta_config, delta_relation = self._record_hook(hookenv)
+            yield self.kv, delta_config, delta_relation
+
+    def _record_charm_version(self, charm_dir):
+        # Record revisions.. charm revisions are meaningless
+        # to charm authors as they don't control the revision.
+        # so logic dependnent on revision is not particularly
+        # useful, however it is useful for debugging analysis.
+        charm_rev = open(
+            os.path.join(charm_dir, 'revision')).read().strip()
+        charm_rev = charm_rev or '0'
+        revs = self.kv.get('charm_revisions', [])
+        if charm_rev not in revs:
+            revs.append(charm_rev.strip() or '0')
+            self.kv.set('charm_revisions', revs)
+
+    def _record_hook(self, hookenv):
+        data = hookenv.execution_environment()
+        self.conf = conf_delta = self.kv.delta(data['conf'], 'config')
+        self.rels = rels_delta = self.kv.delta(data['rels'], 'rels')
+        self.kv.set('env', dict(data['env']))
+        self.kv.set('unit', data['unit'])
+        self.kv.set('relid', data.get('relid'))
+        return conf_delta, rels_delta
+
+
+class Record(dict):
+
+    __slots__ = ()
+
+    def __getattr__(self, k):
+        if k in self:
+            return self[k]
+        raise AttributeError(k)
+
+
+class DeltaSet(Record):
+
+    __slots__ = ()
+
+
+Delta = collections.namedtuple('Delta', ['previous', 'current'])
+
+
+_KV = None
+
+
+def kv():
+    global _KV
+    if _KV is None:
+        _KV = Storage()
+    return _KV
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0cc7fc850a0632568ad78aae9716be718c9ff6b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/__init__.py
@@ -0,0 +1,209 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib
+from charmhelpers.osplatform import get_platform
+from yaml import safe_load
+from charmhelpers.core.hookenv import (
+    config,
+    log,
+)
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse, urlunparse
+else:
+    from urlparse import urlparse, urlunparse
+
+
+# The order of this list is very important. Handlers should be listed in from
+# least- to most-specific URL matching.
+FETCH_HANDLERS = (
+    'charmhelpers.fetch.archiveurl.ArchiveUrlFetchHandler',
+    'charmhelpers.fetch.bzrurl.BzrUrlFetchHandler',
+    'charmhelpers.fetch.giturl.GitUrlFetchHandler',
+)
+
+
+class SourceConfigError(Exception):
+    pass
+
+
+class UnhandledSource(Exception):
+    pass
+
+
+class AptLockError(Exception):
+    pass
+
+
+class GPGKeyError(Exception):
+    """Exception occurs when a GPG key cannot be fetched or used.  The message
+    indicates what the problem is.
+    """
+    pass
+
+
+class BaseFetchHandler(object):
+
+    """Base class for FetchHandler implementations in fetch plugins"""
+
+    def can_handle(self, source):
+        """Returns True if the source can be handled. Otherwise returns
+        a string explaining why it cannot"""
+        return "Wrong source type"
+
+    def install(self, source):
+        """Try to download and unpack the source. Return the path to the
+        unpacked files or raise UnhandledSource."""
+        raise UnhandledSource("Wrong source type {}".format(source))
+
+    def parse_url(self, url):
+        return urlparse(url)
+
+    def base_url(self, url):
+        """Return url without querystring or fragment"""
+        parts = list(self.parse_url(url))
+        parts[4:] = ['' for i in parts[4:]]
+        return urlunparse(parts)
+
+
+__platform__ = get_platform()
+module = "charmhelpers.fetch.%s" % __platform__
+fetch = importlib.import_module(module)
+
+filter_installed_packages = fetch.filter_installed_packages
+filter_missing_packages = fetch.filter_missing_packages
+install = fetch.apt_install
+upgrade = fetch.apt_upgrade
+update = _fetch_update = fetch.apt_update
+purge = fetch.apt_purge
+add_source = fetch.add_source
+
+if __platform__ == "ubuntu":
+    apt_cache = fetch.apt_cache
+    apt_install = fetch.apt_install
+    apt_update = fetch.apt_update
+    apt_upgrade = fetch.apt_upgrade
+    apt_purge = fetch.apt_purge
+    apt_autoremove = fetch.apt_autoremove
+    apt_mark = fetch.apt_mark
+    apt_hold = fetch.apt_hold
+    apt_unhold = fetch.apt_unhold
+    import_key = fetch.import_key
+    get_upstream_version = fetch.get_upstream_version
+    apt_pkg = fetch.ubuntu_apt_pkg
+    get_apt_dpkg_env = fetch.get_apt_dpkg_env
+elif __platform__ == "centos":
+    yum_search = fetch.yum_search
+
+
+def configure_sources(update=False,
+                      sources_var='install_sources',
+                      keys_var='install_keys'):
+    """Configure multiple sources from charm configuration.
+
+    The lists are encoded as yaml fragments in the configuration.
+    The fragment needs to be included as a string. Sources and their
+    corresponding keys are of the types supported by add_source().
+
+    Example config:
+        install_sources: |
+          - "ppa:foo"
+          - "http://example.com/repo precise main"
+        install_keys: |
+          - null
+          - "a1b2c3d4"
+
+    Note that 'null' (a.k.a. None) should not be quoted.
+    """
+    sources = safe_load((config(sources_var) or '').strip()) or []
+    keys = safe_load((config(keys_var) or '').strip()) or None
+
+    if isinstance(sources, six.string_types):
+        sources = [sources]
+
+    if keys is None:
+        for source in sources:
+            add_source(source, None)
+    else:
+        if isinstance(keys, six.string_types):
+            keys = [keys]
+
+        if len(sources) != len(keys):
+            raise SourceConfigError(
+                'Install sources and keys lists are different lengths')
+        for source, key in zip(sources, keys):
+            add_source(source, key)
+    if update:
+        _fetch_update(fatal=True)
+
+
+def install_remote(source, *args, **kwargs):
+    """Install a file tree from a remote source.
+
+    The specified source should be a url of the form:
+        scheme://[host]/path[#[option=value][&...]]
+
+    Schemes supported are based on this modules submodules.
+    Options supported are submodule-specific.
+    Additional arguments are passed through to the submodule.
+
+    For example::
+
+        dest = install_remote('http://example.com/archive.tgz',
+                              checksum='deadbeef',
+                              hash_type='sha1')
+
+    This will download `archive.tgz`, validate it using SHA1 and, if
+    the file is ok, extract it and return the directory in which it
+    was extracted.  If the checksum fails, it will raise
+    :class:`charmhelpers.core.host.ChecksumError`.
+    """
+    # We ONLY check for True here because can_handle may return a string
+    # explaining why it can't handle a given source.
+    handlers = [h for h in plugins() if h.can_handle(source) is True]
+    for handler in handlers:
+        try:
+            return handler.install(source, *args, **kwargs)
+        except UnhandledSource as e:
+            log('Install source attempt unsuccessful: {}'.format(e),
+                level='WARNING')
+    raise UnhandledSource("No handler found for source {}".format(source))
+
+
+def install_from_config(config_var_name):
+    """Install a file from config."""
+    charm_config = config()
+    source = charm_config[config_var_name]
+    return install_remote(source)
+
+
+def plugins(fetch_handlers=None):
+    if not fetch_handlers:
+        fetch_handlers = FETCH_HANDLERS
+    plugin_list = []
+    for handler_name in fetch_handlers:
+        package, classname = handler_name.rsplit('.', 1)
+        try:
+            handler_class = getattr(
+                importlib.import_module(package),
+                classname)
+            plugin_list.append(handler_class())
+        except NotImplementedError:
+            # Skip missing plugins so that they can be ommitted from
+            # installation if desired
+            log("FetchHandler {} not found, skipping plugin".format(
+                handler_name))
+    return plugin_list
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/archiveurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/archiveurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..d25587adeff102c3fc9e402f98746fccbd8a3693
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/archiveurl.py
@@ -0,0 +1,165 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import hashlib
+import re
+
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource
+)
+from charmhelpers.payload.archive import (
+    get_archive_handler,
+    extract,
+)
+from charmhelpers.core.host import mkdir, check_hash
+
+import six
+if six.PY3:
+    from urllib.request import (
+        build_opener, install_opener, urlopen, urlretrieve,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+    )
+    from urllib.parse import urlparse, urlunparse, parse_qs
+    from urllib.error import URLError
+else:
+    from urllib import urlretrieve
+    from urllib2 import (
+        build_opener, install_opener, urlopen,
+        HTTPPasswordMgrWithDefaultRealm, HTTPBasicAuthHandler,
+        URLError
+    )
+    from urlparse import urlparse, urlunparse, parse_qs
+
+
+def splituser(host):
+    '''urllib.splituser(), but six's support of this seems broken'''
+    _userprog = re.compile('^(.*)@(.*)$')
+    match = _userprog.match(host)
+    if match:
+        return match.group(1, 2)
+    return None, host
+
+
+def splitpasswd(user):
+    '''urllib.splitpasswd(), but six's support of this is missing'''
+    _passwdprog = re.compile('^([^:]*):(.*)$', re.S)
+    match = _passwdprog.match(user)
+    if match:
+        return match.group(1, 2)
+    return user, None
+
+
+class ArchiveUrlFetchHandler(BaseFetchHandler):
+    """
+    Handler to download archive files from arbitrary URLs.
+
+    Can fetch from http, https, ftp, and file URLs.
+
+    Can install either tarballs (.tar, .tgz, .tbz2, etc) or zip files.
+
+    Installs the contents of the archive in $CHARM_DIR/fetched/.
+    """
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('http', 'https', 'ftp', 'file'):
+            # XXX: Why is this returning a boolean and a string? It's
+            # doomed to fail since "bool(can_handle('foo://'))"  will be True.
+            return "Wrong source type"
+        if get_archive_handler(self.base_url(source)):
+            return True
+        return False
+
+    def download(self, source, dest):
+        """
+        Download an archive file.
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local path location to download archive file to.
+        """
+        # propagate all exceptions
+        # URLError, OSError, etc
+        proto, netloc, path, params, query, fragment = urlparse(source)
+        if proto in ('http', 'https'):
+            auth, barehost = splituser(netloc)
+            if auth is not None:
+                source = urlunparse((proto, barehost, path, params, query, fragment))
+                username, password = splitpasswd(auth)
+                passman = HTTPPasswordMgrWithDefaultRealm()
+                # Realm is set to None in add_password to force the username and password
+                # to be used whatever the realm
+                passman.add_password(None, source, username, password)
+                authhandler = HTTPBasicAuthHandler(passman)
+                opener = build_opener(authhandler)
+                install_opener(opener)
+        response = urlopen(source)
+        try:
+            with open(dest, 'wb') as dest_file:
+                dest_file.write(response.read())
+        except Exception as e:
+            if os.path.isfile(dest):
+                os.unlink(dest)
+            raise e
+
+    # Mandatory file validation via Sha1 or MD5 hashing.
+    def download_and_validate(self, url, hashsum, validate="sha1"):
+        tempfile, headers = urlretrieve(url)
+        check_hash(tempfile, hashsum, validate)
+        return tempfile
+
+    def install(self, source, dest=None, checksum=None, hash_type='sha1'):
+        """
+        Download and install an archive file, with optional checksum validation.
+
+        The checksum can also be given on the `source` URL's fragment.
+        For example::
+
+            handler.install('http://example.com/file.tgz#sha1=deadbeef')
+
+        :param str source: URL pointing to an archive file.
+        :param str dest: Local destination path to install to. If not given,
+            installs to `$CHARM_DIR/archives/archive_file_name`.
+        :param str checksum: If given, validate the archive file after download.
+        :param str hash_type: Algorithm used to generate `checksum`.
+            Can be any hash alrgorithm supported by :mod:`hashlib`,
+            such as md5, sha1, sha256, sha512, etc.
+
+        """
+        url_parts = self.parse_url(source)
+        dest_dir = os.path.join(os.environ.get('CHARM_DIR'), 'fetched')
+        if not os.path.exists(dest_dir):
+            mkdir(dest_dir, perms=0o755)
+        dld_file = os.path.join(dest_dir, os.path.basename(url_parts.path))
+        try:
+            self.download(source, dld_file)
+        except URLError as e:
+            raise UnhandledSource(e.reason)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        options = parse_qs(url_parts.fragment)
+        for key, value in options.items():
+            if not six.PY3:
+                algorithms = hashlib.algorithms
+            else:
+                algorithms = hashlib.algorithms_available
+            if key in algorithms:
+                if len(value) != 1:
+                    raise TypeError(
+                        "Expected 1 hash value, not %d" % len(value))
+                expected = value[0]
+                check_hash(dld_file, expected, key)
+        if checksum:
+            check_hash(dld_file, checksum, hash_type)
+        return extract(dld_file, dest)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/bzrurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/bzrurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4ab3ff1e6bc7dde24e8ed568a3dc0c6012ddea6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/bzrurl.py
@@ -0,0 +1,76 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import STDOUT, check_output
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+from charmhelpers.core.host import mkdir
+
+
+if filter_installed_packages(['bzr']) != []:
+    install(['bzr'])
+    if filter_installed_packages(['bzr']) != []:
+        raise NotImplementedError('Unable to install bzr')
+
+
+class BzrUrlFetchHandler(BaseFetchHandler):
+    """Handler for bazaar branches via generic and lp URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        if url_parts.scheme not in ('bzr+ssh', 'lp', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.bzr'))
+        else:
+            return True
+
+    def branch(self, source, dest, revno=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+        cmd_opts = []
+        if revno:
+            cmd_opts += ['-r', str(revno)]
+        if os.path.exists(dest):
+            cmd = ['bzr', 'pull']
+            cmd += cmd_opts
+            cmd += ['--overwrite', '-d', dest, source]
+        else:
+            cmd = ['bzr', 'branch']
+            cmd += cmd_opts
+            cmd += [source, dest]
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, dest=None, revno=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+
+        if dest and not os.path.exists(dest):
+            mkdir(dest, perms=0o755)
+
+        try:
+            self.branch(source, dest_dir, revno)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..a91dcff0645ed541a79cd72af3112bdff393719a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/centos.py
@@ -0,0 +1,171 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+import os
+import time
+import six
+import yum
+
+from tempfile import NamedTemporaryFile
+from charmhelpers.core.hookenv import log
+
+YUM_NO_LOCK = 1  # The return code for "couldn't acquire lock" in YUM.
+YUM_NO_LOCK_RETRY_DELAY = 10  # Wait 10 seconds between apt lock checks.
+YUM_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    yb = yum.YumBase()
+    package_list = yb.doPackageLists()
+    temp_cache = {p.base_package_name: 1 for p in package_list['installed']}
+
+    _pkgs = [p for p in packages if not temp_cache.get(p, False)]
+    return _pkgs
+
+
+def install(packages, options=None, fatal=False):
+    """Install one or more packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_yum_command(cmd, fatal)
+
+
+def upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages."""
+    cmd = ['yum', '--assumeyes']
+    if options is not None:
+        cmd.extend(options)
+    cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_yum_command(cmd, fatal)
+
+
+def update(fatal=False):
+    """Update local yum cache."""
+    cmd = ['yum', '--assumeyes', 'update']
+    log("Update with fatal: {}".format(fatal))
+    _run_yum_command(cmd, fatal)
+
+
+def purge(packages, fatal=False):
+    """Purge one or more packages."""
+    cmd = ['yum', '--assumeyes', 'remove']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_yum_command(cmd, fatal)
+
+
+def yum_search(packages):
+    """Search for a package."""
+    output = {}
+    cmd = ['yum', 'search']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Searching for {}".format(packages))
+    result = subprocess.check_output(cmd)
+    for package in list(packages):
+        output[package] = package in result
+    return output
+
+
+def add_source(source, key=None):
+    """Add a package source to this system.
+
+    @param source: a URL with a rpm package
+
+    @param key: A key to be added to the system's keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk.
+    """
+    if source is None:
+        log('Source is not present. Skipping')
+        return
+
+    if source.startswith('http'):
+        directory = '/etc/yum.repos.d/'
+        for filename in os.listdir(directory):
+            with open(directory + filename, 'r') as rpm_file:
+                if source in rpm_file.read():
+                    break
+        else:
+            log("Add source: {!r}".format(source))
+            # write in the charms.repo
+            with open(directory + 'Charms.repo', 'a') as rpm_file:
+                rpm_file.write('[%s]\n' % source[7:].replace('/', '_'))
+                rpm_file.write('name=%s\n' % source[7:])
+                rpm_file.write('baseurl=%s\n\n' % source)
+    else:
+        log("Unknown source: {!r}".format(source))
+
+    if key:
+        if '-----BEGIN PGP PUBLIC KEY BLOCK-----' in key:
+            with NamedTemporaryFile('w+') as key_file:
+                key_file.write(key)
+                key_file.flush()
+                key_file.seek(0)
+                subprocess.check_call(['rpm', '--import', key_file.name])
+        else:
+            subprocess.check_call(['rpm', '--import', key])
+
+
+def _run_yum_command(cmd, fatal=False):
+    """Run an YUM command.
+
+    Checks the output and retry if the fatal flag is set to True.
+
+    :param: cmd: str: The yum command to run.
+    :param: fatal: bool: Whether the command's output should be checked and
+        retried.
+    """
+    env = os.environ.copy()
+
+    if fatal:
+        retry_count = 0
+        result = None
+
+        # If the command is considered "fatal", we need to retry if the yum
+        # lock was not acquired.
+
+        while result is None or result == YUM_NO_LOCK:
+            try:
+                result = subprocess.check_call(cmd, env=env)
+            except subprocess.CalledProcessError as e:
+                retry_count = retry_count + 1
+                if retry_count > YUM_NO_LOCK_RETRY_COUNT:
+                    raise
+                result = e.returncode
+                log("Couldn't acquire YUM lock. Will retry in {} seconds."
+                    "".format(YUM_NO_LOCK_RETRY_DELAY))
+                time.sleep(YUM_NO_LOCK_RETRY_DELAY)
+
+    else:
+        subprocess.call(cmd, env=env)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/giturl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/giturl.py
new file mode 100644
index 0000000000000000000000000000000000000000..070ca9bb5c1a2fdef39f88606ffcaf39bb049410
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/giturl.py
@@ -0,0 +1,69 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+from subprocess import check_output, CalledProcessError, STDOUT
+from charmhelpers.fetch import (
+    BaseFetchHandler,
+    UnhandledSource,
+    filter_installed_packages,
+    install,
+)
+
+if filter_installed_packages(['git']) != []:
+    install(['git'])
+    if filter_installed_packages(['git']) != []:
+        raise NotImplementedError('Unable to install git')
+
+
+class GitUrlFetchHandler(BaseFetchHandler):
+    """Handler for git branches via generic and github URLs."""
+
+    def can_handle(self, source):
+        url_parts = self.parse_url(source)
+        # TODO (mattyw) no support for ssh git@ yet
+        if url_parts.scheme not in ('http', 'https', 'git', ''):
+            return False
+        elif not url_parts.scheme:
+            return os.path.exists(os.path.join(source, '.git'))
+        else:
+            return True
+
+    def clone(self, source, dest, branch="master", depth=None):
+        if not self.can_handle(source):
+            raise UnhandledSource("Cannot handle {}".format(source))
+
+        if os.path.exists(dest):
+            cmd = ['git', '-C', dest, 'pull', source, branch]
+        else:
+            cmd = ['git', 'clone', source, dest, '--branch', branch]
+            if depth:
+                cmd.extend(['--depth', depth])
+        check_output(cmd, stderr=STDOUT)
+
+    def install(self, source, branch="master", dest=None, depth=None):
+        url_parts = self.parse_url(source)
+        branch_name = url_parts.path.strip("/").split("/")[-1]
+        if dest:
+            dest_dir = os.path.join(dest, branch_name)
+        else:
+            dest_dir = os.path.join(os.environ.get('CHARM_DIR'), "fetched",
+                                    branch_name)
+        try:
+            self.clone(source, dest_dir, branch, depth)
+        except CalledProcessError as e:
+            raise UnhandledSource(e)
+        except OSError as e:
+            raise UnhandledSource(e.strerror)
+        return dest_dir
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bff99dc93c64f80716e2d5a2b6d0d4e8a2436955
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2019 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..757135ee4cf3b5ff4c02305126f5ca3940892afc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/debug.py
@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import print_function
+
+import atexit
+import sys
+
+from charmhelpers.fetch.python.rpdb import Rpdb
+from charmhelpers.core.hookenv import (
+    open_port,
+    close_port,
+    ERROR,
+    log
+)
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+DEFAULT_ADDR = "0.0.0.0"
+DEFAULT_PORT = 4444
+
+
+def _error(message):
+    log(message, level=ERROR)
+
+
+def set_trace(addr=DEFAULT_ADDR, port=DEFAULT_PORT):
+    """
+    Set a trace point using the remote debugger
+    """
+    atexit.register(close_port, port)
+    try:
+        log("Starting a remote python debugger session on %s:%s" % (addr,
+                                                                    port))
+        open_port(port)
+        debugger = Rpdb(addr=addr, port=port)
+        debugger.set_trace(sys._getframe().f_back)
+    except Exception:
+        _error("Cannot start a remote debug session on %s:%s" % (addr,
+                                                                 port))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/packages.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/packages.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e95028bc540aace84a2ec6c1bcc4de2663e8a87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/packages.py
@@ -0,0 +1,154 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import six
+import subprocess
+import sys
+
+from charmhelpers.fetch import apt_install, apt_update
+from charmhelpers.core.hookenv import charm_dir, log
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def pip_execute(*args, **kwargs):
+    """Overriden pip_execute() to stop sys.path being changed.
+
+    The act of importing main from the pip module seems to cause add wheels
+    from the /usr/share/python-wheels which are installed by various tools.
+    This function ensures that sys.path remains the same after the call is
+    executed.
+    """
+    try:
+        _path = sys.path
+        try:
+            from pip import main as _pip_execute
+        except ImportError:
+            apt_update()
+            if six.PY2:
+                apt_install('python-pip')
+            else:
+                apt_install('python3-pip')
+            from pip import main as _pip_execute
+        _pip_execute(*args, **kwargs)
+    finally:
+        sys.path = _path
+
+
+def parse_options(given, available):
+    """Given a set of options, check if available"""
+    for key, value in sorted(given.items()):
+        if not value:
+            continue
+        if key in available:
+            yield "--{0}={1}".format(key, value)
+
+
+def pip_install_requirements(requirements, constraints=None, **options):
+    """Install a requirements file.
+
+    :param constraints: Path to pip constraints file.
+    http://pip.readthedocs.org/en/stable/user_guide/#constraints-files
+    """
+    command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    command.append("-r {0}".format(requirements))
+    if constraints:
+        command.append("-c {0}".format(constraints))
+        log("Installing from file: {} with constraints {} "
+            "and options: {}".format(requirements, constraints, command))
+    else:
+        log("Installing from file: {} with options: {}".format(requirements,
+                                                               command))
+    pip_execute(command)
+
+
+def pip_install(package, fatal=False, upgrade=False, venv=None,
+                constraints=None, **options):
+    """Install a python package"""
+    if venv:
+        venv_python = os.path.join(venv, 'bin/pip')
+        command = [venv_python, "install"]
+    else:
+        command = ["install"]
+
+    available_options = ('proxy', 'src', 'log', 'index-url', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if upgrade:
+        command.append('--upgrade')
+
+    if constraints:
+        command.extend(['-c', constraints])
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Installing {} package with options: {}".format(package,
+                                                        command))
+    if venv:
+        subprocess.check_call(command)
+    else:
+        pip_execute(command)
+
+
+def pip_uninstall(package, **options):
+    """Uninstall a python package"""
+    command = ["uninstall", "-q", "-y"]
+
+    available_options = ('proxy', 'log', )
+    for option in parse_options(options, available_options):
+        command.append(option)
+
+    if isinstance(package, list):
+        command.extend(package)
+    else:
+        command.append(package)
+
+    log("Uninstalling {} package with options: {}".format(package,
+                                                          command))
+    pip_execute(command)
+
+
+def pip_list():
+    """Returns the list of current python installed packages
+    """
+    return pip_execute(["list"])
+
+
+def pip_create_virtualenv(path=None):
+    """Create an isolated Python environment."""
+    if six.PY2:
+        apt_install('python-virtualenv')
+    else:
+        apt_install('python3-virtualenv')
+
+    if path:
+        venv_path = path
+    else:
+        venv_path = os.path.join(charm_dir(), 'venv')
+
+    if not os.path.exists(venv_path):
+        subprocess.check_call(['virtualenv', venv_path])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/rpdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/rpdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b31610c22fc2d24fe5097016cf45728f87de4ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/rpdb.py
@@ -0,0 +1,56 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Remote Python Debugger (pdb wrapper)."""
+
+import pdb
+import socket
+import sys
+
+__author__ = "Bertrand Janin <b@janin.com>"
+__version__ = "0.1.3"
+
+
+class Rpdb(pdb.Pdb):
+
+    def __init__(self, addr="127.0.0.1", port=4444):
+        """Initialize the socket and initialize pdb."""
+
+        # Backup stdin and stdout before replacing them by the socket handle
+        self.old_stdout = sys.stdout
+        self.old_stdin = sys.stdin
+
+        # Open a 'reusable' socket to let the webapp reload on the same port
+        self.skt = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        self.skt.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, True)
+        self.skt.bind((addr, port))
+        self.skt.listen(1)
+        (clientsocket, address) = self.skt.accept()
+        handle = clientsocket.makefile('rw')
+        pdb.Pdb.__init__(self, completekey='tab', stdin=handle, stdout=handle)
+        sys.stdout = sys.stdin = handle
+
+    def shutdown(self):
+        """Revert stdin and stdout, close the socket."""
+        sys.stdout = self.old_stdout
+        sys.stdin = self.old_stdin
+        self.skt.close()
+        self.set_continue()
+
+    def do_continue(self, arg):
+        """Stop all operation on ``continue``."""
+        self.shutdown()
+        return 1
+
+    do_EOF = do_quit = do_exit = do_c = do_cont = do_continue
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eb421036ff737f8ff1684e85ff87703e30fe543
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/python/version.py
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+def current_version():
+    """Current system python version"""
+    return sys.version_info
+
+
+def current_version_string():
+    """Current system python version as string major.minor.micro"""
+    return "{0}.{1}.{2}".format(sys.version_info.major,
+                                sys.version_info.minor,
+                                sys.version_info.micro)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/snap.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/snap.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc70aa941bc4f0bb5ff126237db65705b9e4a10a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/snap.py
@@ -0,0 +1,150 @@
+# Copyright 2014-2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Charm helpers snap for classic charms.
+
+If writing reactive charms, use the snap layer:
+https://lists.ubuntu.com/archives/snapcraft/2016-September/001114.html
+"""
+import subprocess
+import os
+from time import sleep
+from charmhelpers.core.hookenv import log
+
+__author__ = 'Joseph Borg <joseph.borg@canonical.com>'
+
+# The return code for "couldn't acquire lock" in Snap
+# (hopefully this will be improved).
+SNAP_NO_LOCK = 1
+SNAP_NO_LOCK_RETRY_DELAY = 10  # Wait X seconds between Snap lock checks.
+SNAP_NO_LOCK_RETRY_COUNT = 30  # Retry to acquire the lock X times.
+SNAP_CHANNELS = [
+    'edge',
+    'beta',
+    'candidate',
+    'stable',
+]
+
+
+class CouldNotAcquireLockException(Exception):
+    pass
+
+
+class InvalidSnapChannel(Exception):
+    pass
+
+
+def _snap_exec(commands):
+    """
+    Execute snap commands.
+
+    :param commands: List commands
+    :return: Integer exit code
+    """
+    assert type(commands) == list
+
+    retry_count = 0
+    return_code = None
+
+    while return_code is None or return_code == SNAP_NO_LOCK:
+        try:
+            return_code = subprocess.check_call(['snap'] + commands,
+                                                env=os.environ)
+        except subprocess.CalledProcessError as e:
+            retry_count += + 1
+            if retry_count > SNAP_NO_LOCK_RETRY_COUNT:
+                raise CouldNotAcquireLockException(
+                    'Could not aquire lock after {} attempts'
+                    .format(SNAP_NO_LOCK_RETRY_COUNT))
+            return_code = e.returncode
+            log('Snap failed to acquire lock, trying again in {} seconds.'
+                .format(SNAP_NO_LOCK_RETRY_DELAY), level='WARN')
+            sleep(SNAP_NO_LOCK_RETRY_DELAY)
+
+    return return_code
+
+
+def snap_install(packages, *flags):
+    """
+    Install a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to install command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Installing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with option(s) "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['install'] + flags + packages)
+
+
+def snap_remove(packages, *flags):
+    """
+    Remove a snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to remove command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Removing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['remove'] + flags + packages)
+
+
+def snap_refresh(packages, *flags):
+    """
+    Refresh / Update snap package.
+
+    :param packages: String or List String package name
+    :param flags: List String flags to pass to refresh command
+    :return: Integer return code from snap
+    """
+    if type(packages) is not list:
+        packages = [packages]
+
+    flags = list(flags)
+
+    message = 'Refreshing snap(s) "%s"' % ', '.join(packages)
+    if flags:
+        message += ' with options "%s"' % ', '.join(flags)
+
+    log(message, level='INFO')
+    return _snap_exec(['refresh'] + flags + packages)
+
+
+def valid_snap_channel(channel):
+    """ Validate snap channel exists
+
+    :raises InvalidSnapChannel: When channel does not exist
+    :return: Boolean
+    """
+    if channel.lower() in SNAP_CHANNELS:
+        return True
+    else:
+        raise InvalidSnapChannel("Invalid Snap Channel: {}".format(channel))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ddaf0dd47f23cef60d7b7e59a83c989999d9f3f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu.py
@@ -0,0 +1,805 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+import platform
+import re
+import six
+import subprocess
+import sys
+import time
+
+from charmhelpers.core.host import get_distrib_codename, get_system_env
+
+from charmhelpers.core.hookenv import (
+    log,
+    DEBUG,
+    WARNING,
+    env_proxy_settings,
+)
+from charmhelpers.fetch import SourceConfigError, GPGKeyError
+from charmhelpers.fetch import ubuntu_apt_pkg
+
+PROPOSED_POCKET = (
+    "# Proposed\n"
+    "deb http://archive.ubuntu.com/ubuntu {}-proposed main universe "
+    "multiverse restricted\n")
+PROPOSED_PORTS_POCKET = (
+    "# Proposed\n"
+    "deb http://ports.ubuntu.com/ubuntu-ports {}-proposed main universe "
+    "multiverse restricted\n")
+# Only supports 64bit and ppc64 at the moment.
+ARCH_TO_PROPOSED_POCKET = {
+    'x86_64': PROPOSED_POCKET,
+    'ppc64le': PROPOSED_PORTS_POCKET,
+    'aarch64': PROPOSED_PORTS_POCKET,
+    's390x': PROPOSED_PORTS_POCKET,
+}
+CLOUD_ARCHIVE_URL = "http://ubuntu-cloud.archive.canonical.com/ubuntu"
+CLOUD_ARCHIVE_KEY_ID = '5EDB1B62EC4926EA'
+CLOUD_ARCHIVE = """# Ubuntu Cloud Archive
+deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+"""
+CLOUD_ARCHIVE_POCKETS = {
+    # Folsom
+    'folsom': 'precise-updates/folsom',
+    'folsom/updates': 'precise-updates/folsom',
+    'precise-folsom': 'precise-updates/folsom',
+    'precise-folsom/updates': 'precise-updates/folsom',
+    'precise-updates/folsom': 'precise-updates/folsom',
+    'folsom/proposed': 'precise-proposed/folsom',
+    'precise-folsom/proposed': 'precise-proposed/folsom',
+    'precise-proposed/folsom': 'precise-proposed/folsom',
+    # Grizzly
+    'grizzly': 'precise-updates/grizzly',
+    'grizzly/updates': 'precise-updates/grizzly',
+    'precise-grizzly': 'precise-updates/grizzly',
+    'precise-grizzly/updates': 'precise-updates/grizzly',
+    'precise-updates/grizzly': 'precise-updates/grizzly',
+    'grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-grizzly/proposed': 'precise-proposed/grizzly',
+    'precise-proposed/grizzly': 'precise-proposed/grizzly',
+    # Havana
+    'havana': 'precise-updates/havana',
+    'havana/updates': 'precise-updates/havana',
+    'precise-havana': 'precise-updates/havana',
+    'precise-havana/updates': 'precise-updates/havana',
+    'precise-updates/havana': 'precise-updates/havana',
+    'havana/proposed': 'precise-proposed/havana',
+    'precise-havana/proposed': 'precise-proposed/havana',
+    'precise-proposed/havana': 'precise-proposed/havana',
+    # Icehouse
+    'icehouse': 'precise-updates/icehouse',
+    'icehouse/updates': 'precise-updates/icehouse',
+    'precise-icehouse': 'precise-updates/icehouse',
+    'precise-icehouse/updates': 'precise-updates/icehouse',
+    'precise-updates/icehouse': 'precise-updates/icehouse',
+    'icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-icehouse/proposed': 'precise-proposed/icehouse',
+    'precise-proposed/icehouse': 'precise-proposed/icehouse',
+    # Juno
+    'juno': 'trusty-updates/juno',
+    'juno/updates': 'trusty-updates/juno',
+    'trusty-juno': 'trusty-updates/juno',
+    'trusty-juno/updates': 'trusty-updates/juno',
+    'trusty-updates/juno': 'trusty-updates/juno',
+    'juno/proposed': 'trusty-proposed/juno',
+    'trusty-juno/proposed': 'trusty-proposed/juno',
+    'trusty-proposed/juno': 'trusty-proposed/juno',
+    # Kilo
+    'kilo': 'trusty-updates/kilo',
+    'kilo/updates': 'trusty-updates/kilo',
+    'trusty-kilo': 'trusty-updates/kilo',
+    'trusty-kilo/updates': 'trusty-updates/kilo',
+    'trusty-updates/kilo': 'trusty-updates/kilo',
+    'kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-kilo/proposed': 'trusty-proposed/kilo',
+    'trusty-proposed/kilo': 'trusty-proposed/kilo',
+    # Liberty
+    'liberty': 'trusty-updates/liberty',
+    'liberty/updates': 'trusty-updates/liberty',
+    'trusty-liberty': 'trusty-updates/liberty',
+    'trusty-liberty/updates': 'trusty-updates/liberty',
+    'trusty-updates/liberty': 'trusty-updates/liberty',
+    'liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-liberty/proposed': 'trusty-proposed/liberty',
+    'trusty-proposed/liberty': 'trusty-proposed/liberty',
+    # Mitaka
+    'mitaka': 'trusty-updates/mitaka',
+    'mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-mitaka': 'trusty-updates/mitaka',
+    'trusty-mitaka/updates': 'trusty-updates/mitaka',
+    'trusty-updates/mitaka': 'trusty-updates/mitaka',
+    'mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-mitaka/proposed': 'trusty-proposed/mitaka',
+    'trusty-proposed/mitaka': 'trusty-proposed/mitaka',
+    # Newton
+    'newton': 'xenial-updates/newton',
+    'newton/updates': 'xenial-updates/newton',
+    'xenial-newton': 'xenial-updates/newton',
+    'xenial-newton/updates': 'xenial-updates/newton',
+    'xenial-updates/newton': 'xenial-updates/newton',
+    'newton/proposed': 'xenial-proposed/newton',
+    'xenial-newton/proposed': 'xenial-proposed/newton',
+    'xenial-proposed/newton': 'xenial-proposed/newton',
+    # Ocata
+    'ocata': 'xenial-updates/ocata',
+    'ocata/updates': 'xenial-updates/ocata',
+    'xenial-ocata': 'xenial-updates/ocata',
+    'xenial-ocata/updates': 'xenial-updates/ocata',
+    'xenial-updates/ocata': 'xenial-updates/ocata',
+    'ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-ocata/proposed': 'xenial-proposed/ocata',
+    'xenial-proposed/ocata': 'xenial-proposed/ocata',
+    # Pike
+    'pike': 'xenial-updates/pike',
+    'xenial-pike': 'xenial-updates/pike',
+    'xenial-pike/updates': 'xenial-updates/pike',
+    'xenial-updates/pike': 'xenial-updates/pike',
+    'pike/proposed': 'xenial-proposed/pike',
+    'xenial-pike/proposed': 'xenial-proposed/pike',
+    'xenial-proposed/pike': 'xenial-proposed/pike',
+    # Queens
+    'queens': 'xenial-updates/queens',
+    'xenial-queens': 'xenial-updates/queens',
+    'xenial-queens/updates': 'xenial-updates/queens',
+    'xenial-updates/queens': 'xenial-updates/queens',
+    'queens/proposed': 'xenial-proposed/queens',
+    'xenial-queens/proposed': 'xenial-proposed/queens',
+    'xenial-proposed/queens': 'xenial-proposed/queens',
+    # Rocky
+    'rocky': 'bionic-updates/rocky',
+    'bionic-rocky': 'bionic-updates/rocky',
+    'bionic-rocky/updates': 'bionic-updates/rocky',
+    'bionic-updates/rocky': 'bionic-updates/rocky',
+    'rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-rocky/proposed': 'bionic-proposed/rocky',
+    'bionic-proposed/rocky': 'bionic-proposed/rocky',
+    # Stein
+    'stein': 'bionic-updates/stein',
+    'bionic-stein': 'bionic-updates/stein',
+    'bionic-stein/updates': 'bionic-updates/stein',
+    'bionic-updates/stein': 'bionic-updates/stein',
+    'stein/proposed': 'bionic-proposed/stein',
+    'bionic-stein/proposed': 'bionic-proposed/stein',
+    'bionic-proposed/stein': 'bionic-proposed/stein',
+    # Train
+    'train': 'bionic-updates/train',
+    'bionic-train': 'bionic-updates/train',
+    'bionic-train/updates': 'bionic-updates/train',
+    'bionic-updates/train': 'bionic-updates/train',
+    'train/proposed': 'bionic-proposed/train',
+    'bionic-train/proposed': 'bionic-proposed/train',
+    'bionic-proposed/train': 'bionic-proposed/train',
+    # Ussuri
+    'ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri': 'bionic-updates/ussuri',
+    'bionic-ussuri/updates': 'bionic-updates/ussuri',
+    'bionic-updates/ussuri': 'bionic-updates/ussuri',
+    'ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-ussuri/proposed': 'bionic-proposed/ussuri',
+    'bionic-proposed/ussuri': 'bionic-proposed/ussuri',
+}
+
+
+APT_NO_LOCK = 100  # The return code for "couldn't acquire lock" in APT.
+CMD_RETRY_DELAY = 10  # Wait 10 seconds between command retries.
+CMD_RETRY_COUNT = 3  # Retry a failing fatal command X times.
+
+
+def filter_installed_packages(packages):
+    """Return a list of packages that require installation."""
+    cache = apt_cache()
+    _pkgs = []
+    for package in packages:
+        try:
+            p = cache[package]
+            p.current_ver or _pkgs.append(package)
+        except KeyError:
+            log('Package {} has no installation candidate.'.format(package),
+                level='WARNING')
+            _pkgs.append(package)
+    return _pkgs
+
+
+def filter_missing_packages(packages):
+    """Return a list of packages that are installed.
+
+    :param packages: list of packages to evaluate.
+    :returns list: Packages that are installed.
+    """
+    return list(
+        set(packages) -
+        set(filter_installed_packages(packages))
+    )
+
+
+def apt_cache(*_, **__):
+    """Shim returning an object simulating the apt_pkg Cache.
+
+    :param _: Accept arguments for compability, not used.
+    :type _: any
+    :param __: Accept keyword arguments for compability, not used.
+    :type __: any
+    :returns:Object used to interrogate the system apt and dpkg databases.
+    :rtype:ubuntu_apt_pkg.Cache
+    """
+    if 'apt_pkg' in sys.modules:
+        # NOTE(fnordahl): When our consumer use the upstream ``apt_pkg`` module
+        # in conjunction with the apt_cache helper function, they may expect us
+        # to call ``apt_pkg.init()`` for them.
+        #
+        # Detect this situation, log a warning and make the call to
+        # ``apt_pkg.init()`` to avoid the consumer Python interpreter from
+        # crashing with a segmentation fault.
+        log('Support for use of upstream ``apt_pkg`` module in conjunction'
+            'with charm-helpers is deprecated since 2019-06-25', level=WARNING)
+        sys.modules['apt_pkg'].init()
+    return ubuntu_apt_pkg.Cache()
+
+
+def apt_install(packages, options=None, fatal=False):
+    """Install one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    cmd.append('install')
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Installing {} with options: {}".format(packages,
+                                                options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_upgrade(options=None, fatal=False, dist=False):
+    """Upgrade all packages.
+
+    :param options: Options to pass on to apt-get
+    :type options: Option[None, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :param dist: Whether ``dist-upgrade`` should be used over ``upgrade``
+    :type dist: bool
+    :raises: subprocess.CalledProcessError
+    """
+    if options is None:
+        options = ['--option=Dpkg::Options::=--force-confold']
+
+    cmd = ['apt-get', '--assume-yes']
+    cmd.extend(options)
+    if dist:
+        cmd.append('dist-upgrade')
+    else:
+        cmd.append('upgrade')
+    log("Upgrading with options: {}".format(options))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_update(fatal=False):
+    """Update local apt cache."""
+    cmd = ['apt-get', 'update']
+    _run_apt_command(cmd, fatal)
+
+
+def apt_purge(packages, fatal=False):
+    """Purge one or more packages.
+
+    :param packages: Package(s) to install
+    :type packages: Option[str, List[str]]
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'purge']
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+    log("Purging {}".format(packages))
+    _run_apt_command(cmd, fatal)
+
+
+def apt_autoremove(purge=True, fatal=False):
+    """Purge one or more packages.
+    :param purge: Whether the ``--purge`` option should be passed on or not.
+    :type purge: bool
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    :raises: subprocess.CalledProcessError
+    """
+    cmd = ['apt-get', '--assume-yes', 'autoremove']
+    if purge:
+        cmd.append('--purge')
+    _run_apt_command(cmd, fatal)
+
+
+def apt_mark(packages, mark, fatal=False):
+    """Flag one or more packages using apt-mark."""
+    log("Marking {} as {}".format(packages, mark))
+    cmd = ['apt-mark', mark]
+    if isinstance(packages, six.string_types):
+        cmd.append(packages)
+    else:
+        cmd.extend(packages)
+
+    if fatal:
+        subprocess.check_call(cmd, universal_newlines=True)
+    else:
+        subprocess.call(cmd, universal_newlines=True)
+
+
+def apt_hold(packages, fatal=False):
+    return apt_mark(packages, 'hold', fatal=fatal)
+
+
+def apt_unhold(packages, fatal=False):
+    return apt_mark(packages, 'unhold', fatal=fatal)
+
+
+def import_key(key):
+    """Import an ASCII Armor key.
+
+    A Radix64 format keyid is also supported for backwards
+    compatibility. In this case Ubuntu keyserver will be
+    queried for a key via HTTPS by its keyid. This method
+    is less preferrable because https proxy servers may
+    require traffic decryption which is equivalent to a
+    man-in-the-middle attack (a proxy server impersonates
+    keyserver TLS certificates and has to be explicitly
+    trusted by the system).
+
+    :param key: A GPG key in ASCII armor format,
+                  including BEGIN and END markers or a keyid.
+    :type key: (bytes, str)
+    :raises: GPGKeyError if the key could not be imported
+    """
+    key = key.strip()
+    if '-' in key or '\n' in key:
+        # Send everything not obviously a keyid to GPG to import, as
+        # we trust its validation better than our own. eg. handling
+        # comments before the key.
+        log("PGP key found (looks like ASCII Armor format)", level=DEBUG)
+        if ('-----BEGIN PGP PUBLIC KEY BLOCK-----' in key and
+                '-----END PGP PUBLIC KEY BLOCK-----' in key):
+            log("Writing provided PGP key in the binary format", level=DEBUG)
+            if six.PY3:
+                key_bytes = key.encode('utf-8')
+            else:
+                key_bytes = key
+            key_name = _get_keyid_by_gpg_key(key_bytes)
+            key_gpg = _dearmor_gpg_key(key_bytes)
+            _write_apt_gpg_keyfile(key_name=key_name, key_material=key_gpg)
+        else:
+            raise GPGKeyError("ASCII armor markers missing from GPG key")
+    else:
+        log("PGP key found (looks like Radix64 format)", level=WARNING)
+        log("SECURELY importing PGP key from keyserver; "
+            "full key not provided.", level=WARNING)
+        # as of bionic add-apt-repository uses curl with an HTTPS keyserver URL
+        # to retrieve GPG keys. `apt-key adv` command is deprecated as is
+        # apt-key in general as noted in its manpage. See lp:1433761 for more
+        # history. Instead, /etc/apt/trusted.gpg.d is used directly to drop
+        # gpg
+        key_asc = _get_key_by_keyid(key)
+        # write the key in GPG format so that apt-key list shows it
+        key_gpg = _dearmor_gpg_key(key_asc)
+        _write_apt_gpg_keyfile(key_name=key, key_material=key_gpg)
+
+
+def _get_keyid_by_gpg_key(key_material):
+    """Get a GPG key fingerprint by GPG key material.
+    Gets a GPG key fingerprint (40-digit, 160-bit) by the ASCII armor-encoded
+    or binary GPG key material. Can be used, for example, to generate file
+    names for keys passed via charm options.
+
+    :param key_material: ASCII armor-encoded or binary GPG key material
+    :type key_material: bytes
+    :raises: GPGKeyError if invalid key material has been provided
+    :returns: A GPG key fingerprint
+    :rtype: str
+    """
+    # Use the same gpg command for both Xenial and Bionic
+    cmd = 'gpg --with-colons --with-fingerprint'
+    ps = subprocess.Popen(cmd.split(),
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_material)
+    if six.PY3:
+        out = out.decode('utf-8')
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material provided')
+    # from gnupg2 docs: fpr :: Fingerprint (fingerprint is in field 10)
+    return re.search(r"^fpr:{9}([0-9A-F]{40}):$", out, re.MULTILINE).group(1)
+
+
+def _get_key_by_keyid(keyid):
+    """Get a key via HTTPS from the Ubuntu keyserver.
+    Different key ID formats are supported by SKS keyservers (the longer ones
+    are more secure, see "dead beef attack" and https://evil32.com/). Since
+    HTTPS is used, if SSLBump-like HTTPS proxies are in place, they will
+    impersonate keyserver.ubuntu.com and generate a certificate with
+    keyserver.ubuntu.com in the CN field or in SubjAltName fields of a
+    certificate. If such proxy behavior is expected it is necessary to add the
+    CA certificate chain containing the intermediate CA of the SSLBump proxy to
+    every machine that this code runs on via ca-certs cloud-init directive (via
+    cloudinit-userdata model-config) or via other means (such as through a
+    custom charm option). Also note that DNS resolution for the hostname in a
+    URL is done at a proxy server - not at the client side.
+
+    8-digit (32 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x4652B4E6
+    16-digit (64 bit) key ID
+    https://keyserver.ubuntu.com/pks/lookup?search=0x6E85A86E4652B4E6
+    40-digit key ID:
+    https://keyserver.ubuntu.com/pks/lookup?search=0x35F77D63B5CEC106C577ED856E85A86E4652B4E6
+
+    :param keyid: An 8, 16 or 40 hex digit keyid to find a key for
+    :type keyid: (bytes, str)
+    :returns: A key material for the specified GPG key id
+    :rtype: (str, bytes)
+    :raises: subprocess.CalledProcessError
+    """
+    # options=mr - machine-readable output (disables html wrappers)
+    keyserver_url = ('https://keyserver.ubuntu.com'
+                     '/pks/lookup?op=get&options=mr&exact=on&search=0x{}')
+    curl_cmd = ['curl', keyserver_url.format(keyid)]
+    # use proxy server settings in order to retrieve the key
+    return subprocess.check_output(curl_cmd,
+                                   env=env_proxy_settings(['https']))
+
+
+def _dearmor_gpg_key(key_asc):
+    """Converts a GPG key in the ASCII armor format to the binary format.
+
+    :param key_asc: A GPG key in ASCII armor format.
+    :type key_asc: (str, bytes)
+    :returns: A GPG key in binary format
+    :rtype: (str, bytes)
+    :raises: GPGKeyError
+    """
+    ps = subprocess.Popen(['gpg', '--dearmor'],
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE)
+    out, err = ps.communicate(input=key_asc)
+    # no need to decode output as it is binary (invalid utf-8), only error
+    if six.PY3:
+        err = err.decode('utf-8')
+    if 'gpg: no valid OpenPGP data found.' in err:
+        raise GPGKeyError('Invalid GPG key material. Check your network setup'
+                          ' (MTU, routing, DNS) and/or proxy server settings'
+                          ' as well as destination keyserver status.')
+    else:
+        return out
+
+
+def _write_apt_gpg_keyfile(key_name, key_material):
+    """Writes GPG key material into a file at a provided path.
+
+    :param key_name: A key name to use for a key file (could be a fingerprint)
+    :type key_name: str
+    :param key_material: A GPG key material (binary)
+    :type key_material: (str, bytes)
+    """
+    with open('/etc/apt/trusted.gpg.d/{}.gpg'.format(key_name),
+              'wb') as keyf:
+        keyf.write(key_material)
+
+
+def add_source(source, key=None, fail_invalid=False):
+    """Add a package source to this system.
+
+    @param source: a URL or sources.list entry, as supported by
+    add-apt-repository(1). Examples::
+
+        ppa:charmers/example
+        deb https://stub:key@private.example.com/ubuntu trusty main
+
+    In addition:
+        'proposed:' may be used to enable the standard 'proposed'
+        pocket for the release.
+        'cloud:' may be used to activate official cloud archive pockets,
+        such as 'cloud:icehouse'
+        'distro' may be used as a noop
+
+    Full list of source specifications supported by the function are:
+
+    'distro': A NOP; i.e. it has no effect.
+    'proposed': the proposed deb spec [2] is wrtten to
+      /etc/apt/sources.list/proposed
+    'distro-proposed': adds <version>-proposed to the debs [2]
+    'ppa:<ppa-name>': add-apt-repository --yes <ppa_name>
+    'deb <deb-spec>': add-apt-repository --yes deb <deb-spec>
+    'http://....': add-apt-repository --yes http://...
+    'cloud-archive:<spec>': add-apt-repository -yes cloud-archive:<spec>
+    'cloud:<release>[-staging]': specify a Cloud Archive pocket <release> with
+      optional staging version.  If staging is used then the staging PPA [2]
+      with be used.  If staging is NOT used then the cloud archive [3] will be
+      added, and the 'ubuntu-cloud-keyring' package will be added for the
+      current distro.
+
+    Otherwise the source is not recognised and this is logged to the juju log.
+    However, no error is raised, unless sys_error_on_exit is True.
+
+    [1] deb http://ubuntu-cloud.archive.canonical.com/ubuntu {} main
+        where {} is replaced with the derived pocket name.
+    [2] deb http://archive.ubuntu.com/ubuntu {}-proposed \
+        main universe multiverse restricted
+        where {} is replaced with the lsb_release codename (e.g. xenial)
+    [3] deb http://ubuntu-cloud.archive.canonical.com/ubuntu <pocket>
+        to /etc/apt/sources.list.d/cloud-archive-list
+
+    @param key: A key to be added to the system's APT keyring and used
+    to verify the signatures on packages. Ideally, this should be an
+    ASCII format GPG public key including the block headers. A GPG key
+    id may also be used, but be aware that only insecure protocols are
+    available to retrieve the actual public key from a public keyserver
+    placing your Juju environment at risk. ppa and cloud archive keys
+    are securely added automtically, so sould not be provided.
+
+    @param fail_invalid: (boolean) if True, then the function raises a
+    SourceConfigError is there is no matching installation source.
+
+    @raises SourceConfigError() if for cloud:<pocket>, the <pocket> is not a
+    valid pocket in CLOUD_ARCHIVE_POCKETS
+    """
+    _mapping = OrderedDict([
+        (r"^distro$", lambda: None),  # This is a NOP
+        (r"^(?:proposed|distro-proposed)$", _add_proposed),
+        (r"^cloud-archive:(.*)$", _add_apt_repository),
+        (r"^((?:deb |http:|https:|ppa:).*)$", _add_apt_repository),
+        (r"^cloud:(.*)-(.*)\/staging$", _add_cloud_staging),
+        (r"^cloud:(.*)-(.*)$", _add_cloud_distro_check),
+        (r"^cloud:(.*)$", _add_cloud_pocket),
+        (r"^snap:.*-(.*)-(.*)$", _add_cloud_distro_check),
+    ])
+    if source is None:
+        source = ''
+    for r, fn in six.iteritems(_mapping):
+        m = re.match(r, source)
+        if m:
+            if key:
+                # Import key before adding the source which depends on it,
+                # as refreshing packages could fail otherwise.
+                try:
+                    import_key(key)
+                except GPGKeyError as e:
+                    raise SourceConfigError(str(e))
+            # call the associated function with the captured groups
+            # raises SourceConfigError on error.
+            fn(*m.groups())
+            break
+    else:
+        # nothing matched.  log an error and maybe sys.exit
+        err = "Unknown source: {!r}".format(source)
+        log(err)
+        if fail_invalid:
+            raise SourceConfigError(err)
+
+
+def _add_proposed():
+    """Add the PROPOSED_POCKET as /etc/apt/source.list.d/proposed.list
+
+    Uses get_distrib_codename to determine the correct stanza for
+    the deb line.
+
+    For intel architecutres PROPOSED_POCKET is used for the release, but for
+    other architectures PROPOSED_PORTS_POCKET is used for the release.
+    """
+    release = get_distrib_codename()
+    arch = platform.machine()
+    if arch not in six.iterkeys(ARCH_TO_PROPOSED_POCKET):
+        raise SourceConfigError("Arch {} not supported for (distro-)proposed"
+                                .format(arch))
+    with open('/etc/apt/sources.list.d/proposed.list', 'w') as apt:
+        apt.write(ARCH_TO_PROPOSED_POCKET[arch].format(release))
+
+
+def _add_apt_repository(spec):
+    """Add the spec using add_apt_repository
+
+    :param spec: the parameter to pass to add_apt_repository
+    :type spec: str
+    """
+    if '{series}' in spec:
+        series = get_distrib_codename()
+        spec = spec.replace('{series}', series)
+    # software-properties package for bionic properly reacts to proxy settings
+    # passed as environment variables (See lp:1433761). This is not the case
+    # LTS and non-LTS releases below bionic.
+    _run_with_retries(['add-apt-repository', '--yes', spec],
+                      cmd_env=env_proxy_settings(['https']))
+
+
+def _add_cloud_pocket(pocket):
+    """Add a cloud pocket as /etc/apt/sources.d/cloud-archive.list
+
+    Note that this overwrites the existing file if there is one.
+
+    This function also converts the simple pocket in to the actual pocket using
+    the CLOUD_ARCHIVE_POCKETS mapping.
+
+    :param pocket: string representing the pocket to add a deb spec for.
+    :raises: SourceConfigError if the cloud pocket doesn't exist or the
+        requested release doesn't match the current distro version.
+    """
+    apt_install(filter_installed_packages(['ubuntu-cloud-keyring']),
+                fatal=True)
+    if pocket not in CLOUD_ARCHIVE_POCKETS:
+        raise SourceConfigError(
+            'Unsupported cloud: source option %s' %
+            pocket)
+    actual_pocket = CLOUD_ARCHIVE_POCKETS[pocket]
+    with open('/etc/apt/sources.list.d/cloud-archive.list', 'w') as apt:
+        apt.write(CLOUD_ARCHIVE.format(actual_pocket))
+
+
+def _add_cloud_staging(cloud_archive_release, openstack_release):
+    """Add the cloud staging repository which is in
+    ppa:ubuntu-cloud-archive/<openstack_release>-staging
+
+    This function checks that the cloud_archive_release matches the current
+    codename for the distro that charm is being installed on.
+
+    :param cloud_archive_release: string, codename for the release.
+    :param openstack_release: String, codename for the openstack release.
+    :raises: SourceConfigError if the cloud_archive_release doesn't match the
+        current version of the os.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    ppa = 'ppa:ubuntu-cloud-archive/{}-staging'.format(openstack_release)
+    cmd = 'add-apt-repository -y {}'.format(ppa)
+    _run_with_retries(cmd.split(' '))
+
+
+def _add_cloud_distro_check(cloud_archive_release, openstack_release):
+    """Add the cloud pocket, but also check the cloud_archive_release against
+    the current distro, and use the openstack_release as the full lookup.
+
+    This just calls _add_cloud_pocket() with the openstack_release as pocket
+    to get the correct cloud-archive.list for dpkg to work with.
+
+    :param cloud_archive_release:String, codename for the distro release.
+    :param openstack_release: String, spec for the release to look up in the
+        CLOUD_ARCHIVE_POCKETS
+    :raises: SourceConfigError if this is the wrong distro, or the pocket spec
+        doesn't exist.
+    """
+    _verify_is_ubuntu_rel(cloud_archive_release, openstack_release)
+    _add_cloud_pocket("{}-{}".format(cloud_archive_release, openstack_release))
+
+
+def _verify_is_ubuntu_rel(release, os_release):
+    """Verify that the release is in the same as the current ubuntu release.
+
+    :param release: String, lowercase for the release.
+    :param os_release: String, the os_release being asked for
+    :raises: SourceConfigError if the release is not the same as the ubuntu
+        release.
+    """
+    ubuntu_rel = get_distrib_codename()
+    if release != ubuntu_rel:
+        raise SourceConfigError(
+            'Invalid Cloud Archive release specified: {}-{} on this Ubuntu'
+            'version ({})'.format(release, os_release, ubuntu_rel))
+
+
+def _run_with_retries(cmd, max_retries=CMD_RETRY_COUNT, retry_exitcodes=(1,),
+                      retry_message="", cmd_env=None):
+    """Run a command and retry until success or max_retries is reached.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param max_retries: The number of retries to attempt on a fatal
+                        command. Defaults to CMD_RETRY_COUNT.
+    :type max_retries: int
+    :param retry_exitcodes: Optional additional exit codes to retry.
+                            Defaults to retry on exit code 1.
+    :type retry_exitcodes: tuple
+    :param retry_message: Optional log prefix emitted during retries.
+    :type retry_message: str
+    :param: cmd_env: Environment variables to add to the command run.
+    :type cmd_env: Option[None, Dict[str, str]]
+    """
+    env = get_apt_dpkg_env()
+    if cmd_env:
+        env.update(cmd_env)
+
+    if not retry_message:
+        retry_message = "Failed executing '{}'".format(" ".join(cmd))
+    retry_message += ". Will retry in {} seconds".format(CMD_RETRY_DELAY)
+
+    retry_count = 0
+    result = None
+
+    retry_results = (None,) + retry_exitcodes
+    while result in retry_results:
+        try:
+            result = subprocess.check_call(cmd, env=env)
+        except subprocess.CalledProcessError as e:
+            retry_count = retry_count + 1
+            if retry_count > max_retries:
+                raise
+            result = e.returncode
+            log(retry_message)
+            time.sleep(CMD_RETRY_DELAY)
+
+
+def _run_apt_command(cmd, fatal=False):
+    """Run an apt command with optional retries.
+
+    :param cmd: The apt command to run.
+    :type cmd: str
+    :param fatal: Whether the command's output should be checked and
+                  retried.
+    :type fatal: bool
+    """
+    if fatal:
+        _run_with_retries(
+            cmd, retry_exitcodes=(1, APT_NO_LOCK,),
+            retry_message="Couldn't acquire DPKG lock")
+    else:
+        subprocess.call(cmd, env=get_apt_dpkg_env())
+
+
+def get_upstream_version(package):
+    """Determine upstream version based on installed package
+
+    @returns None (if not installed) or the upstream version
+    """
+    cache = apt_cache()
+    try:
+        pkg = cache[package]
+    except Exception:
+        # the package is unknown to the current apt cache.
+        return None
+
+    if not pkg.current_ver:
+        # package is known, but no version is currently installed.
+        return None
+
+    return ubuntu_apt_pkg.upstream_version(pkg.current_ver.ver_str)
+
+
+def get_apt_dpkg_env():
+    """Get environment suitable for execution of APT and DPKG tools.
+
+    We keep this in a helper function instead of in a global constant to
+    avoid execution on import of the library.
+    :returns: Environment suitable for execution of APT and DPKG tools.
+    :rtype: Dict[str, str]
+    """
+    # The fallback is used in the event of ``/etc/environment`` not containing
+    # avalid PATH variable.
+    return {'DEBIAN_FRONTEND': 'noninteractive',
+            'PATH': get_system_env('PATH', '/usr/sbin:/usr/bin:/sbin:/bin')}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu_apt_pkg.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu_apt_pkg.py
new file mode 100644
index 0000000000000000000000000000000000000000..929a75d7a775921c32368e8cc7950eaa97390047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/fetch/ubuntu_apt_pkg.py
@@ -0,0 +1,267 @@
+# Copyright 2019 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Provide a subset of the ``python-apt`` module API.
+
+Data collection is done through subprocess calls to ``apt-cache`` and
+``dpkg-query`` commands.
+
+The main purpose for this module is to avoid dependency on the
+``python-apt`` python module.
+
+The indicated python module is a wrapper around the ``apt`` C++ library
+which is tightly connected to the version of the distribution it was
+shipped on.  It is not developed in a backward/forward compatible manner.
+
+This in turn makes it incredibly hard to distribute as a wheel for a piece
+of python software that supports a span of distro releases [0][1].
+
+Upstream feedback like [2] does not give confidence in this ever changing,
+so with this we get rid of the dependency.
+
+0: https://github.com/juju-solutions/layer-basic/pull/135
+1: https://bugs.launchpad.net/charm-octavia/+bug/1824112
+2: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845330#10
+"""
+
+import locale
+import os
+import subprocess
+import sys
+
+
+class _container(dict):
+    """Simple container for attributes."""
+    __getattr__ = dict.__getitem__
+    __setattr__ = dict.__setitem__
+
+
+class Package(_container):
+    """Simple container for package attributes."""
+
+
+class Version(_container):
+    """Simple container for version attributes."""
+
+
+class Cache(object):
+    """Simulation of ``apt_pkg`` Cache object."""
+    def __init__(self, progress=None):
+        pass
+
+    def __contains__(self, package):
+        try:
+            pkg = self.__getitem__(package)
+            return pkg is not None
+        except KeyError:
+            return False
+
+    def __getitem__(self, package):
+        """Get information about a package from apt and dpkg databases.
+
+        :param package: Name of package
+        :type package: str
+        :returns: Package object
+        :rtype: object
+        :raises: KeyError, subprocess.CalledProcessError
+        """
+        apt_result = self._apt_cache_show([package])[package]
+        apt_result['name'] = apt_result.pop('package')
+        pkg = Package(apt_result)
+        dpkg_result = self._dpkg_list([package]).get(package, {})
+        current_ver = None
+        installed_version = dpkg_result.get('version')
+        if installed_version:
+            current_ver = Version({'ver_str': installed_version})
+        pkg.current_ver = current_ver
+        pkg.architecture = dpkg_result.get('architecture')
+        return pkg
+
+    def _dpkg_list(self, packages):
+        """Get data from system dpkg database for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about installed packages, keys like
+                  ``dpkg-query --list``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['dpkg-query', '--list']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+        except subprocess.CalledProcessError as cp:
+            # ``dpkg-query`` may return error and at the same time have
+            # produced useful output, for example when asked for multiple
+            # packages where some are not installed
+            if cp.returncode != 1:
+                raise
+            output = cp.output
+        headings = []
+        for line in output.splitlines():
+            if line.startswith('||/'):
+                headings = line.split()
+                headings.pop(0)
+                continue
+            elif (line.startswith('|') or line.startswith('+') or
+                  line.startswith('dpkg-query:')):
+                continue
+            else:
+                data = line.split(None, 4)
+                status = data.pop(0)
+                if status != 'ii':
+                    continue
+                pkg = {}
+                pkg.update({k.lower(): v for k, v in zip(headings, data)})
+                if 'name' in pkg:
+                    pkgs.update({pkg['name']: pkg})
+        return pkgs
+
+    def _apt_cache_show(self, packages):
+        """Get data from system apt cache for package.
+
+        :param packages: Packages to get data from
+        :type packages: List[str]
+        :returns: Structured data about package, keys like
+                  ``apt-cache show``
+        :rtype: dict
+        :raises: subprocess.CalledProcessError
+        """
+        pkgs = {}
+        cmd = ['apt-cache', 'show', '--no-all-versions']
+        cmd.extend(packages)
+        if locale.getlocale() == (None, None):
+            # subprocess calls out to locale.getpreferredencoding(False) to
+            # determine encoding.  Workaround for Trusty where the
+            # environment appears to not be set up correctly.
+            locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
+        try:
+            output = subprocess.check_output(cmd,
+                                             stderr=subprocess.STDOUT,
+                                             universal_newlines=True)
+            previous = None
+            pkg = {}
+            for line in output.splitlines():
+                if not line:
+                    if 'package' in pkg:
+                        pkgs.update({pkg['package']: pkg})
+                        pkg = {}
+                    continue
+                if line.startswith(' '):
+                    if previous and previous in pkg:
+                        pkg[previous] += os.linesep + line.lstrip()
+                    continue
+                if ':' in line:
+                    kv = line.split(':', 1)
+                    key = kv[0].lower()
+                    if key == 'n':
+                        continue
+                    previous = key
+                    pkg.update({key: kv[1].lstrip()})
+        except subprocess.CalledProcessError as cp:
+            # ``apt-cache`` returns 100 if none of the packages asked for
+            # exist in the apt cache.
+            if cp.returncode != 100:
+                raise
+        return pkgs
+
+
+class Config(_container):
+    def __init__(self):
+        super(Config, self).__init__(self._populate())
+
+    def _populate(self):
+        cfgs = {}
+        cmd = ['apt-config', 'dump']
+        output = subprocess.check_output(cmd,
+                                         stderr=subprocess.STDOUT,
+                                         universal_newlines=True)
+        for line in output.splitlines():
+            if not line.startswith("CommandLine"):
+                k, v = line.split(" ", 1)
+                cfgs[k] = v.strip(";").strip("\"")
+
+        return cfgs
+
+
+# Backwards compatibility with old apt_pkg module
+sys.modules[__name__].config = Config()
+
+
+def init():
+    """Compability shim that does nothing."""
+    pass
+
+
+def upstream_version(version):
+    """Extracts upstream version from a version string.
+
+    Upstream reference: https://salsa.debian.org/apt-team/apt/blob/master/
+                                apt-pkg/deb/debversion.cc#L259
+
+    :param version: Version string
+    :type version: str
+    :returns: Upstream version
+    :rtype: str
+    """
+    if version:
+        version = version.split(':')[-1]
+        version = version.split('-')[0]
+    return version
+
+
+def version_compare(a, b):
+    """Compare the given versions.
+
+    Call out to ``dpkg`` to make sure the code doing the comparison is
+    compatible with what the ``apt`` library would do.  Mimic the return
+    values.
+
+    Upstream reference:
+    https://apt-team.pages.debian.net/python-apt/library/apt_pkg.html
+            ?highlight=version_compare#apt_pkg.version_compare
+
+    :param a: version string
+    :type a: str
+    :param b: version string
+    :type b: str
+    :returns: >0 if ``a`` is greater than ``b``, 0 if a equals b,
+              <0 if ``a`` is smaller than ``b``
+    :rtype: int
+    :raises: subprocess.CalledProcessError, RuntimeError
+    """
+    for op in ('gt', 1), ('eq', 0), ('lt', -1):
+        try:
+            subprocess.check_call(['dpkg', '--compare-versions',
+                                   a, op[0], b],
+                                  stderr=subprocess.STDOUT,
+                                  universal_newlines=True)
+            return op[1]
+        except subprocess.CalledProcessError as cp:
+            if cp.returncode == 1:
+                continue
+            raise
+    else:
+        raise RuntimeError('Unable to compare "{}" and "{}", according to '
+                           'our logic they are neither greater, equal nor '
+                           'less than each other.')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/osplatform.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/osplatform.py
new file mode 100644
index 0000000000000000000000000000000000000000..78c81af5955caee51271c830d58cacac2cab9bcc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/osplatform.py
@@ -0,0 +1,46 @@
+import platform
+import os
+
+
+def get_platform():
+    """Return the current OS platform.
+
+    For example: if current os platform is Ubuntu then a string "ubuntu"
+    will be returned (which is the name of the module).
+    This string is used to decide which platform module should be imported.
+    """
+    # linux_distribution is deprecated and will be removed in Python 3.7
+    # Warnings *not* disabled, as we certainly need to fix this.
+    if hasattr(platform, 'linux_distribution'):
+        tuple_platform = platform.linux_distribution()
+        current_platform = tuple_platform[0]
+    else:
+        current_platform = _get_platform_from_fs()
+
+    if "Ubuntu" in current_platform:
+        return "ubuntu"
+    elif "CentOS" in current_platform:
+        return "centos"
+    elif "debian" in current_platform:
+        # Stock Python does not detect Ubuntu and instead returns debian.
+        # Or at least it does in some build environments like Travis CI
+        return "ubuntu"
+    elif "elementary" in current_platform:
+        # ElementaryOS fails to run tests locally without this.
+        return "ubuntu"
+    else:
+        raise RuntimeError("This module is not supported on {}."
+                           .format(current_platform))
+
+
+def _get_platform_from_fs():
+    """Get Platform from /etc/os-release."""
+    with open(os.path.join(os.sep, 'etc', 'os-release')) as fin:
+        content = dict(
+            line.split('=', 1)
+            for line in fin.read().splitlines()
+            if '=' in line
+        )
+    for k, v in content.items():
+        content[k] = v.strip('"')
+    return content["NAME"]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee55cb3d2baddb556df910f1d41638c3c7f39c59
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/__init__.py
@@ -0,0 +1,15 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"Tools for working with files injected into a charm just before deployment."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/archive.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/archive.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fc453f523cf49f0c123839a347c4452c6d465ca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/archive.py
@@ -0,0 +1,71 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import tarfile
+import zipfile
+from charmhelpers.core import (
+    host,
+    hookenv,
+)
+
+
+class ArchiveError(Exception):
+    pass
+
+
+def get_archive_handler(archive_name):
+    if os.path.isfile(archive_name):
+        if tarfile.is_tarfile(archive_name):
+            return extract_tarfile
+        elif zipfile.is_zipfile(archive_name):
+            return extract_zipfile
+    else:
+        # look at the file name
+        for ext in ('.tar', '.tar.gz', '.tgz', 'tar.bz2', '.tbz2', '.tbz'):
+            if archive_name.endswith(ext):
+                return extract_tarfile
+        for ext in ('.zip', '.jar'):
+            if archive_name.endswith(ext):
+                return extract_zipfile
+
+
+def archive_dest_default(archive_name):
+    archive_file = os.path.basename(archive_name)
+    return os.path.join(hookenv.charm_dir(), "archives", archive_file)
+
+
+def extract(archive_name, destpath=None):
+    handler = get_archive_handler(archive_name)
+    if handler:
+        if not destpath:
+            destpath = archive_dest_default(archive_name)
+        if not os.path.isdir(destpath):
+            host.mkdir(destpath)
+        handler(archive_name, destpath)
+        return destpath
+    else:
+        raise ArchiveError("No handler for archive")
+
+
+def extract_tarfile(archive_name, destpath):
+    "Unpack a tar archive, optionally compressed"
+    archive = tarfile.open(archive_name)
+    archive.extractall(destpath)
+
+
+def extract_zipfile(archive_name, destpath):
+    "Unpack a zip file"
+    archive = zipfile.ZipFile(archive_name)
+    archive.extractall(destpath)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/execd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/execd.py
new file mode 100644
index 0000000000000000000000000000000000000000..1502aa0b596f0b1a2017ccb4543a35999774431d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/charmhelpers/payload/execd.py
@@ -0,0 +1,65 @@
+#!/usr/bin/env python
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+import subprocess
+from charmhelpers.core import hookenv
+
+
+def default_execd_dir():
+    return os.path.join(os.environ['CHARM_DIR'], 'exec.d')
+
+
+def execd_module_paths(execd_dir=None):
+    """Generate a list of full paths to modules within execd_dir."""
+    if not execd_dir:
+        execd_dir = default_execd_dir()
+
+    if not os.path.exists(execd_dir):
+        return
+
+    for subpath in os.listdir(execd_dir):
+        module = os.path.join(execd_dir, subpath)
+        if os.path.isdir(module):
+            yield module
+
+
+def execd_submodule_paths(command, execd_dir=None):
+    """Generate a list of full paths to the specified command within exec_dir.
+    """
+    for module_path in execd_module_paths(execd_dir):
+        path = os.path.join(module_path, command)
+        if os.access(path, os.X_OK) and os.path.isfile(path):
+            yield path
+
+
+def execd_run(command, execd_dir=None, die_on_error=True, stderr=subprocess.STDOUT):
+    """Run command for each module within execd_dir which defines it."""
+    for submodule_path in execd_submodule_paths(command, execd_dir):
+        try:
+            subprocess.check_output(submodule_path, stderr=stderr,
+                                    universal_newlines=True)
+        except subprocess.CalledProcessError as e:
+            hookenv.log("Error ({}) running  {}. Output: {}".format(
+                e.returncode, e.cmd, e.output))
+            if die_on_error:
+                sys.exit(e.returncode)
+
+
+def execd_preinstall(execd_dir=None):
+    """Run charm-pre-install for each module within execd_dir."""
+    execd_run('charm-pre-install', execd_dir=execd_dir)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/compat b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/compat
new file mode 100644
index 0000000000000000000000000000000000000000..7f8f011eb73d6043d2e6db9d2c101195ae2801f2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/compat
@@ -0,0 +1 @@
+7
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/control b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/control
new file mode 100644
index 0000000000000000000000000000000000000000..c4992afd94fd22c6449365362dd96bc53ae6d404
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/control
@@ -0,0 +1,20 @@
+Source: charmhelpers
+Maintainer: Matthew Wedgwood <matthew.wedgwood@ubuntu.com>
+Section: python
+Priority: optional
+Build-Depends: python-all (>= 2.6.6-3), debhelper (>= 7)
+Standards-Version: 3.9.1
+
+Package: python-charmhelpers
+Architecture: all
+Depends: ${misc:Depends}, ${python:Depends}
+Description: UNKNOWN
+ ============
+ CharmHelpers
+ ============
+ .
+ CharmHelpers provides an opinionated set of tools for building Juju
+ charms that work together. In addition to basic tasks like interact-
+ ing with the charm environment and the machine it runs on, it also
+ helps keep you build hooks and establish relations effortlessly.
+ .
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/rules b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/rules
new file mode 100755
index 0000000000000000000000000000000000000000..7f2101b365a870adf54c565999245eedcc416810
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/rules
@@ -0,0 +1,9 @@
+#!/usr/bin/make -f
+
+# This file was automatically generated by stdeb 0.6.0+git at
+# Fri, 04 Jan 2013 15:14:11 -0600
+
+%:
+	dh $@ --with python2 --buildsystem=python_distutils
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/source/format b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/source/format
new file mode 100644
index 0000000000000000000000000000000000000000..163aaf8d82b6c54f23c45f32895dbdfdcc27b047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/debian/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/Makefile b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/Makefile
new file mode 100644
index 0000000000000000000000000000000000000000..17396a1fddc3e317e197d7b9d73a6eace214b065
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/Makefile
@@ -0,0 +1,177 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = _build
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/CharmHelpers.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/CharmHelpers.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/CharmHelpers"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/CharmHelpers"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/_extensions/automembersummary.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/_extensions/automembersummary.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a1e707ab4422d738ae006b2c9d34647148da4c5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/_extensions/automembersummary.py
@@ -0,0 +1,84 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import inspect
+
+from docutils.parsers.rst import directives
+from sphinx.ext.autosummary import Autosummary
+from sphinx.ext.autosummary import get_import_prefixes_from_env
+from sphinx.ext.autosummary import import_by_name
+
+
+class AutoMemberSummary(Autosummary):
+    required_arguments = 0
+    optional_arguments = 0
+    final_argument_whitespace = False
+    has_content = True
+    option_spec = {
+        'toctree': directives.unchanged,
+        'nosignatures': directives.flag,
+        'template': directives.unchanged,
+    }
+
+    def get_items(self, names):
+        env = self.state.document.settings.env
+        prefixes = get_import_prefixes_from_env(env)
+
+        items = []
+        prefix = ''
+        shorten = ''
+
+        def _get_items(name):
+            _items = super(AutoMemberSummary, self).get_items([shorten + name])
+            for dn, sig, summary, rn in _items:
+                items.append(('%s%s' % (prefix, dn), sig, summary, rn))
+
+        for name in names:
+            if '~' in name:
+                prefix, name = name.split('~')
+                shorten = '~'
+            else:
+                prefix = ''
+                shorten = ''
+
+            try:
+                real_name, obj, parent, _ = import_by_name(name, prefixes=prefixes)
+            except ImportError:
+                self.warn('failed to import %s' % name)
+                continue
+
+            if not inspect.ismodule(obj):
+                _get_items(name)
+                continue
+
+            for member in dir(obj):
+                if member.startswith('_'):
+                    continue
+                mobj = getattr(obj, member)
+                if hasattr(mobj, '__module__'):
+                    if not mobj.__module__.startswith(real_name):
+                        continue  # skip imported classes & functions
+                elif hasattr(mobj, '__name__'):
+                    if not mobj.__name__.startswith(real_name):
+                        continue  # skip imported modules
+                else:
+                    continue  # skip instances
+                _get_items('%s.%s' % (name, member))
+
+        return items
+
+
+def setup(app):
+    app.add_directive('automembersummary', AutoMemberSummary)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.cli.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.cli.rst
new file mode 100644
index 0000000000000000000000000000000000000000..749ad249f07b68ba5886cdbdc0c9e8b78d5d16b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.cli.rst
@@ -0,0 +1,24 @@
+charmhelpers.cli package
+========================
+
+charmhelpers.cli.commands module
+--------------------------------
+
+.. automodule:: charmhelpers.cli.commands
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.cli.host module
+----------------------------
+
+.. automodule:: charmhelpers.cli.host
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.cli
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ansible.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ansible.rst
new file mode 100644
index 0000000000000000000000000000000000000000..a6644937d0f7e2d508e500dd46f33ad6d47fb346
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ansible.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.ansible package
+====================================
+
+.. automodule:: charmhelpers.contrib.ansible
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmhelpers.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmhelpers.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5d5222db297171acf80bce09ec22b47a5611ac39
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmhelpers.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.charmhelpers package
+=========================================
+
+.. automodule:: charmhelpers.contrib.charmhelpers
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmsupport.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmsupport.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5f33aeb027320a708a2980f03cf1d7ae6bc6c893
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.charmsupport.rst
@@ -0,0 +1,24 @@
+charmhelpers.contrib.charmsupport package
+=========================================
+
+charmhelpers.contrib.charmsupport.nrpe module
+---------------------------------------------
+
+.. automodule:: charmhelpers.contrib.charmsupport.nrpe
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.charmsupport.volumes module
+------------------------------------------------
+
+.. automodule:: charmhelpers.contrib.charmsupport.volumes
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.charmsupport
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.hahelpers.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.hahelpers.rst
new file mode 100644
index 0000000000000000000000000000000000000000..129db24def3584ee42ae64de3e87123eed585ca1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.hahelpers.rst
@@ -0,0 +1,24 @@
+charmhelpers.contrib.hahelpers package
+======================================
+
+charmhelpers.contrib.hahelpers.apache module
+--------------------------------------------
+
+.. automodule:: charmhelpers.contrib.hahelpers.apache
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.hahelpers.cluster module
+---------------------------------------------
+
+.. automodule:: charmhelpers.contrib.hahelpers.cluster
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.hahelpers
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.ovs.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.ovs.rst
new file mode 100644
index 0000000000000000000000000000000000000000..98ab8cb1e2f42ff434da1b26d1519bf2d440c76f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.ovs.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.network.ovs package
+========================================
+
+.. automodule:: charmhelpers.contrib.network.ovs
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c7b89b252b100033a122a1717fd753c21893096f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.network.rst
@@ -0,0 +1,20 @@
+charmhelpers.contrib.network package
+====================================
+
+.. toctree::
+
+    charmhelpers.contrib.network.ovs
+
+charmhelpers.contrib.network.ip module
+--------------------------------------
+
+.. automodule:: charmhelpers.contrib.network.ip
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.network
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.rst
new file mode 100644
index 0000000000000000000000000000000000000000..d969ed62678e227a14640db45e9a851465341762
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.rst
@@ -0,0 +1,52 @@
+charmhelpers.contrib.openstack package
+======================================
+
+.. toctree::
+
+    charmhelpers.contrib.openstack.templates
+
+charmhelpers.contrib.openstack.alternatives module
+--------------------------------------------------
+
+.. automodule:: charmhelpers.contrib.openstack.alternatives
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.openstack.context module
+---------------------------------------------
+
+.. automodule:: charmhelpers.contrib.openstack.context
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.openstack.neutron module
+---------------------------------------------
+
+.. automodule:: charmhelpers.contrib.openstack.neutron
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.openstack.templating module
+------------------------------------------------
+
+.. automodule:: charmhelpers.contrib.openstack.templating
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.openstack.utils module
+-------------------------------------------
+
+.. automodule:: charmhelpers.contrib.openstack.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.openstack
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.templates.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.templates.rst
new file mode 100644
index 0000000000000000000000000000000000000000..f9eaa2f8581744fdc42b632f743636f715f149a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.openstack.templates.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.openstack.templates package
+================================================
+
+.. automodule:: charmhelpers.contrib.openstack.templates
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.peerstorage.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.peerstorage.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e33e82fc09d84a1c8f29202c913e21ac43d001ac
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.peerstorage.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.peerstorage package
+========================================
+
+.. automodule:: charmhelpers.contrib.peerstorage
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.python.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.python.rst
new file mode 100644
index 0000000000000000000000000000000000000000..98d6a62dc03df54fa70494f3301f4f793d5143f1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.python.rst
@@ -0,0 +1,40 @@
+charmhelpers.contrib.python package
+===================================
+
+charmhelpers.contrib.python.debug module
+----------------------------------------
+
+.. automodule:: charmhelpers.contrib.python.debug
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.python.packages module
+-------------------------------------------
+
+.. automodule:: charmhelpers.contrib.python.packages
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.python.rpdb module
+---------------------------------------
+
+.. automodule:: charmhelpers.contrib.python.rpdb
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.python.version module
+------------------------------------------
+
+.. automodule:: charmhelpers.contrib.python.version
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.python
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.rst
new file mode 100644
index 0000000000000000000000000000000000000000..d3655431936555d7e3f9b5a1c2ad6aacd299bfc5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.rst
@@ -0,0 +1,23 @@
+charmhelpers.contrib package
+============================
+
+.. toctree::
+
+    charmhelpers.contrib.ansible
+    charmhelpers.contrib.charmhelpers
+    charmhelpers.contrib.charmsupport
+    charmhelpers.contrib.hahelpers
+    charmhelpers.contrib.network
+    charmhelpers.contrib.openstack
+    charmhelpers.contrib.peerstorage
+    charmhelpers.contrib.python
+    charmhelpers.contrib.saltstack
+    charmhelpers.contrib.ssl
+    charmhelpers.contrib.storage
+    charmhelpers.contrib.templating
+    charmhelpers.contrib.unison
+
+.. automodule:: charmhelpers.contrib
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.saltstack.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.saltstack.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ca14b85d87263152b6f90d7009a8935ca5888002
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.saltstack.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.saltstack package
+======================================
+
+.. automodule:: charmhelpers.contrib.saltstack
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ssl.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ssl.rst
new file mode 100644
index 0000000000000000000000000000000000000000..8b7cde87776fb49c116ea4911dbc0ff5f000a19b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.ssl.rst
@@ -0,0 +1,16 @@
+charmhelpers.contrib.ssl package
+================================
+
+charmhelpers.contrib.ssl.service module
+---------------------------------------
+
+.. automodule:: charmhelpers.contrib.ssl.service
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.ssl
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.linux.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.linux.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5acb07394dab5b5cf7017d4d4f46f693d2023abf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.linux.rst
@@ -0,0 +1,40 @@
+charmhelpers.contrib.storage.linux package
+==========================================
+
+charmhelpers.contrib.storage.linux.ceph module
+----------------------------------------------
+
+.. automodule:: charmhelpers.contrib.storage.linux.ceph
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.storage.linux.loopback module
+--------------------------------------------------
+
+.. automodule:: charmhelpers.contrib.storage.linux.loopback
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.storage.linux.lvm module
+---------------------------------------------
+
+.. automodule:: charmhelpers.contrib.storage.linux.lvm
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.storage.linux.utils module
+-----------------------------------------------
+
+.. automodule:: charmhelpers.contrib.storage.linux.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.storage.linux
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.rst
new file mode 100644
index 0000000000000000000000000000000000000000..a3adfdfc3ebda31ff24001a2a243ce98249ba5c5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.storage.rst
@@ -0,0 +1,11 @@
+charmhelpers.contrib.storage package
+====================================
+
+.. toctree::
+
+    charmhelpers.contrib.storage.linux
+
+.. automodule:: charmhelpers.contrib.storage
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.templating.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.templating.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c3eb2a24312eda3c725949ad646977776ee76f0c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.templating.rst
@@ -0,0 +1,24 @@
+charmhelpers.contrib.templating package
+=======================================
+
+charmhelpers.contrib.templating.contexts module
+-----------------------------------------------
+
+.. automodule:: charmhelpers.contrib.templating.contexts
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.contrib.templating.pyformat module
+-----------------------------------------------
+
+.. automodule:: charmhelpers.contrib.templating.pyformat
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.contrib.templating
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.unison.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.unison.rst
new file mode 100644
index 0000000000000000000000000000000000000000..af3a5254608508cfa253f71e741f4423ffb77c39
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.contrib.unison.rst
@@ -0,0 +1,7 @@
+charmhelpers.contrib.unison package
+===================================
+
+.. automodule:: charmhelpers.contrib.unison
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.coordinator.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.coordinator.rst
new file mode 100644
index 0000000000000000000000000000000000000000..13eeb677d5383a681d43b385aee14691bfcccac2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.coordinator.rst
@@ -0,0 +1,10 @@
+charmhelpers.coordinator package
+================================
+
+charmhelpers.coordinator module
+-------------------------------
+
+.. automodule:: charmhelpers.coordinator
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.decorators.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.decorators.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5b4fb402a7d03916de39fe39a8ab418f027a1463
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.decorators.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.decorators
+============================
+
+.. automodule:: charmhelpers.core.decorators
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.fstab.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.fstab.rst
new file mode 100644
index 0000000000000000000000000000000000000000..a4c9f9488c91c062dac8bf482032fdd03d8a5aaa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.fstab.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.fstab
+=======================
+
+.. automodule:: charmhelpers.core.fstab
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.hookenv.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.hookenv.rst
new file mode 100644
index 0000000000000000000000000000000000000000..70a0df8891af1ceb085e4574abbea7409b6a35ca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.hookenv.rst
@@ -0,0 +1,12 @@
+charmhelpers.core.hookenv
+=========================
+
+.. automembersummary::
+    :nosignatures:
+
+    ~charmhelpers.core.hookenv
+
+.. automodule:: charmhelpers.core.hookenv
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.host.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.host.rst
new file mode 100644
index 0000000000000000000000000000000000000000..7b6b9f0cf835c61963ab5a190b47720bdef5030c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.host.rst
@@ -0,0 +1,12 @@
+charmhelpers.core.host
+======================
+
+.. automembersummary::
+    :nosignatures:
+
+    ~charmhelpers.core.host
+
+.. automodule:: charmhelpers.core.host
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.rst
new file mode 100644
index 0000000000000000000000000000000000000000..0aec7b766b12702c826fe21c41416700c4239945
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.rst
@@ -0,0 +1,19 @@
+charmhelpers.core package
+=========================
+
+.. toctree::
+
+    charmhelpers.core.decorators
+    charmhelpers.core.fstab
+    charmhelpers.core.hookenv
+    charmhelpers.core.host
+    charmhelpers.core.strutils
+    charmhelpers.core.sysctl
+    charmhelpers.core.templating
+    charmhelpers.core.unitdata
+    charmhelpers.core.services
+
+.. automodule:: charmhelpers.core
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.base.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.base.rst
new file mode 100644
index 0000000000000000000000000000000000000000..79ef6cb59c3722050b4ccfb744a5b5929589b1c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.base.rst
@@ -0,0 +1,12 @@
+charmhelpers.core.services.base
+===============================
+
+.. automembersummary::
+    :nosignatures:
+
+    ~charmhelpers.core.services.base
+
+.. automodule:: charmhelpers.core.services.base
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.helpers.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.helpers.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ccba56ce1434d86e35d21a3b452fdbe5eeaa8be1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.helpers.rst
@@ -0,0 +1,12 @@
+charmhelpers.core.services.helpers
+==================================
+
+.. automembersummary::
+    :nosignatures:
+
+    ~charmhelpers.core.services.helpers
+
+.. automodule:: charmhelpers.core.services.helpers
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.rst
new file mode 100644
index 0000000000000000000000000000000000000000..515103c4313ac0f069aea6847911693807f2b8da
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.services.rst
@@ -0,0 +1,12 @@
+charmhelpers.core.services
+==========================
+
+.. toctree::
+
+    charmhelpers.core.services.base
+    charmhelpers.core.services.helpers
+
+.. automodule:: charmhelpers.core.services
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.strutils.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.strutils.rst
new file mode 100644
index 0000000000000000000000000000000000000000..3b96809fb4540af6079a0400b835617c879cb991
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.strutils.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.strutils
+============================
+
+.. automodule:: charmhelpers.core.strutils
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.sysctl.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.sysctl.rst
new file mode 100644
index 0000000000000000000000000000000000000000..45b960fd94dac9c58efe0b7d9b525985e0d97391
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.sysctl.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.sysctl
+============================
+
+.. automodule:: charmhelpers.core.sysctl
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.templating.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.templating.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c131d97beafe3d4c0e6bbc0fd679f286ea21f27d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.templating.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.templating
+============================
+
+.. automodule:: charmhelpers.core.templating
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.unitdata.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.unitdata.rst
new file mode 100644
index 0000000000000000000000000000000000000000..2b50978de002ccc15fe049abd694615c465fd546
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.core.unitdata.rst
@@ -0,0 +1,7 @@
+charmhelpers.core.unitdata
+==========================
+
+.. automodule:: charmhelpers.core.unitdata
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.archiveurl.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.archiveurl.rst
new file mode 100644
index 0000000000000000000000000000000000000000..b9d09447755143364143e6bff8d52f53329a0f41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.archiveurl.rst
@@ -0,0 +1,7 @@
+charmhelpers.fetch.archiveurl module
+====================================
+
+.. automodule:: charmhelpers.fetch.archiveurl
+    :members:
+    :undoc-members:
+    :show-inheritance:
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.bzrurl.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.bzrurl.rst
new file mode 100644
index 0000000000000000000000000000000000000000..1be591097884beb4480db1054fb2cd3b01498637
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.bzrurl.rst
@@ -0,0 +1,7 @@
+charmhelpers.fetch.bzrurl module
+================================
+
+.. automodule:: charmhelpers.fetch.bzrurl
+    :members:
+    :undoc-members:
+    :show-inheritance:
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.python.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.python.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ed89d428c526fcee5d5f06d273194f4eb03c170c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.python.rst
@@ -0,0 +1,7 @@
+charmhelpers.fetch.python module
+====================================
+
+.. automodule:: charmhelpers.fetch.python
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.rst
new file mode 100644
index 0000000000000000000000000000000000000000..6fb42ef2d7e3df3d4643a9bc480734c1c56e6bc3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.rst
@@ -0,0 +1,37 @@
+charmhelpers.fetch package
+==========================
+
+.. automodule:: charmhelpers.fetch
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+charmhelpers.fetch.archiveurl module
+------------------------------------
+
+.. toctree::
+
+    charmhelpers.fetch.archiveurl
+
+charmhelpers.fetch.bzrurl module
+--------------------------------
+
+.. toctree::
+
+    charmhelpers.fetch.bzrurl
+
+charmhelpers.fetch.snap module
+------------------------------
+
+.. toctree::
+
+    charmhelpers.fetch.snap
+
+charmhelpers.fetch.python module
+------------------------------
+
+.. toctree::
+
+    charmhelpers.fetch.python
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.snap.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.snap.rst
new file mode 100644
index 0000000000000000000000000000000000000000..882a88e2dd9a9e844846f3fecda7d21e08f0803f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.fetch.snap.rst
@@ -0,0 +1,26 @@
+charmhelpers.fetch.snap package
+===============================
+
+.. automodule:: charmhelpers.fetch.snap
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+Examples
+--------
+
+.. code-block:: python
+
+    snap_install('hello-world', '--classic', '--stable')
+    snap_install(['hello-world', 'htop'])
+
+.. code-block:: python
+
+    snap_refresh('hello-world', '--classic', '--stable')
+    snap_refresh(['hello-world', 'htop'])
+
+.. code-block:: python
+
+    snap_remove('hello-world')
+    snap_remove(['hello-world', 'htop'])
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.payload.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.payload.rst
new file mode 100644
index 0000000000000000000000000000000000000000..b1d9607ad115e37806b36ab6d8d54bae665cf917
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.payload.rst
@@ -0,0 +1,24 @@
+charmhelpers.payload package
+============================
+
+charmhelpers.payload.archive module
+-----------------------------------
+
+.. automodule:: charmhelpers.payload.archive
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+charmhelpers.payload.execd module
+---------------------------------
+
+.. automodule:: charmhelpers.payload.execd
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+.. automodule:: charmhelpers.payload
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.rst
new file mode 100644
index 0000000000000000000000000000000000000000..14266fbe55f19887d4b454a13094852bdbb61b55
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/api/charmhelpers.rst
@@ -0,0 +1,17 @@
+API Documentation
+=================
+
+.. toctree::
+    :maxdepth: 3
+
+    charmhelpers.core
+    charmhelpers.contrib
+    charmhelpers.fetch
+    charmhelpers.payload
+    charmhelpers.cli
+    charmhelpers.coordinator
+
+.. automodule:: charmhelpers
+    :members:
+    :undoc-members:
+    :show-inheritance:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/conf.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/conf.py
new file mode 100644
index 0000000000000000000000000000000000000000..f495d5511209971c53b0098178438246a3fee94b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/conf.py
@@ -0,0 +1,266 @@
+# -*- coding: utf-8 -*-
+#
+# Charm Helpers documentation build configuration file, created by
+# sphinx-quickstart on Fri Jun  6 10:34:44 2014.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import sys
+import os
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath('../'))
+sys.path.append(os.path.abspath('_extensions/'))
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
+    'automembersummary',
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix of source filenames.
+source_suffix = '.rst'
+
+# The encoding of source files.
+#source_encoding = 'utf-8-sig'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = u'Charm Helpers'
+copyright = u'2014-2018, Canonical Ltd.'
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+version_file = os.path.abspath(
+    os.path.join(os.path.dirname(__file__), '../', 'VERSION'))
+VERSION = open(version_file).read().strip()
+# The short X.Y version.
+version = VERSION
+# The full version, including alpha/beta/rc tags.
+release = VERSION
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#language = None
+
+# There are two options for replacing |today|: either, you set today to some
+# non-false value, then it is used:
+#today = ''
+# Else, today_fmt is used as the format for a strftime call.
+#today_fmt = '%B %d, %Y'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+exclude_patterns = ['_build', '_extensions']
+
+# The reST default role (used for this markup: `text`) to use for all
+# documents.
+#default_role = None
+
+# If true, '()' will be appended to :func: etc. cross-reference text.
+#add_function_parentheses = True
+
+# If true, the current module name will be prepended to all description
+# unit titles (such as .. function::).
+#add_module_names = True
+
+# If true, sectionauthor and moduleauthor directives will be shown in the
+# output. They are ignored by default.
+#show_authors = False
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# A list of ignored prefixes for module index sorting.
+#modindex_common_prefix = []
+
+# If true, keep warnings as "system message" paragraphs in the built documents.
+#keep_warnings = False
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+html_theme = 'sphinx_rtd_theme'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#html_theme_options = {}
+
+# Add any paths that contain custom themes here, relative to this directory.
+html_theme_path = ['_themes']
+
+# The name for this set of Sphinx documents.  If None, it defaults to
+# "<project> v<release> documentation".
+#html_title = None
+
+# A shorter title for the navigation bar.  Default is the same as html_title.
+#html_short_title = None
+
+# The name of an image file (relative to this directory) to place at the top
+# of the sidebar.
+#html_logo = None
+
+# The name of an image file (within the static path) to use as favicon of the
+# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
+# pixels large.
+#html_favicon = None
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Add any extra paths that contain custom files (such as robots.txt or
+# .htaccess) here, relative to this directory. These files are copied
+# directly to the root of the documentation.
+#html_extra_path = []
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
+#html_last_updated_fmt = '%b %d, %Y'
+
+# If true, SmartyPants will be used to convert quotes and dashes to
+# typographically correct entities.
+#html_use_smartypants = True
+
+# Custom sidebar templates, maps document names to template names.
+#html_sidebars = {}
+
+# Additional templates that should be rendered to pages, maps page names to
+# template names.
+#html_additional_pages = {}
+
+# If false, no module index is generated.
+#html_domain_indices = True
+
+# If false, no index is generated.
+#html_use_index = True
+
+# If true, the index is split into individual pages for each letter.
+#html_split_index = False
+
+# If true, links to the reST sources are added to the pages.
+#html_show_sourcelink = True
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
+#html_show_sphinx = True
+
+# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
+#html_show_copyright = True
+
+# If true, an OpenSearch description file will be output, and all pages will
+# contain a <link> tag referring to it.  The value of this option must be the
+# base URL from which the finished HTML is served.
+#html_use_opensearch = ''
+
+# This is the file name suffix for HTML files (e.g. ".xhtml").
+#html_file_suffix = None
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'CharmHelpersdoc'
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+# The paper size ('letterpaper' or 'a4paper').
+#'papersize': 'letterpaper',
+
+# The font size ('10pt', '11pt' or '12pt').
+#'pointsize': '10pt',
+
+# Additional stuff for the LaTeX preamble.
+#'preamble': '',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+  ('index', 'CharmHelpers.tex', u'Charm Helpers Documentation',
+   u'Charm Helpers Developers', 'manual'),
+]
+
+# The name of an image file (relative to this directory) to place at the top of
+# the title page.
+#latex_logo = None
+
+# For "manual" documents, if this is true, then toplevel headings are parts,
+# not chapters.
+#latex_use_parts = False
+
+# If true, show page references after internal links.
+#latex_show_pagerefs = False
+
+# If true, show URL addresses after external links.
+#latex_show_urls = False
+
+# Documents to append as an appendix to all manuals.
+#latex_appendices = []
+
+# If false, no module index is generated.
+#latex_domain_indices = True
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    ('index', 'charmhelpers', u'Charm Helpers Documentation',
+     [u'Charm Helpers Developers'], 1)
+]
+
+# If true, show URL addresses after external links.
+#man_show_urls = False
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+  ('index', 'CharmHelpers', u'Charm Helpers Documentation',
+   u'Charm Helpers Developers', 'CharmHelpers', 'One line description of project.',
+   'Miscellaneous'),
+]
+
+# Documents to append as an appendix to all manuals.
+#texinfo_appendices = []
+
+# If false, no module index is generated.
+#texinfo_domain_indices = True
+
+# How to display URL addresses: 'footnote', 'no', or 'inline'.
+#texinfo_show_urls = 'footnote'
+
+# If true, do not generate a @detailmenu in the "Top" node's menu.
+#texinfo_no_detailmenu = False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/contributing.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/contributing.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ed4728b5950eb9128d6536ea34c2647968614389
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/contributing.rst
@@ -0,0 +1,49 @@
+Contributing
+============
+
+All contributions, both code and documentation, are welcome!
+
+Source
+------
+
+The source code is located at https://github.com/juju/charm-helpers. To
+submit contributions you'll need to create a GitHub account if you do not
+already have one.
+
+To get the code::
+
+  $ git clone https://github.com/juju/charm-helpers
+
+To build and run tests::
+
+  $ cd charm-helpers
+  $ make
+
+Submitting a Merge Proposal
+---------------------------
+
+Run ``make test`` and ensure all tests pass. Then commit your changes to a
+`fork <https://github.com/juju/charm-helpers/fork>`_ and create a
+`pull request <https://github.com/juju/charm-helpers/compare>`_.
+
+Open Bugs
+---------
+
+If you're looking for something to work on, the open bug/feature list can be
+found at https://bugs.launchpad.net/charm-helpers.
+
+Documentation
+-------------
+
+If you'd like to contribute to the documentation, please refer to the ``HACKING.md``
+document in the root of the source tree for instructions on building the documentation.
+
+Contributions to the :doc:`example-index` section of the documentation are
+especially welcome, and are easy to add. Simply add a new ``.rst`` file under
+``charmhelpers/docs/examples``.
+
+Getting Help
+------------
+
+If you need help you can find it in ``#juju`` on the Freenode IRC network. Come
+talk to us - we're a friendly bunch!
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/example-index.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/example-index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e0251c08a1c8e471081a5007c6faede6d92f2d52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/example-index.rst
@@ -0,0 +1,11 @@
+Examples
+========
+
+If you'd like to contribute an example (please do!), please refer to the
+:doc:`contributing` page for instructions on how to do so.
+
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   examples/*
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/config.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/config.rst
new file mode 100644
index 0000000000000000000000000000000000000000..d6d60895729bd038d161bb458773c0d410238b1b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/config.rst
@@ -0,0 +1,88 @@
+Interacting with Charm Configuration
+====================================
+
+The :func:`charmhelpers.core.hookenv.config`, when called with no arguments,
+returns a :class:`charmhelpers.core.hookenv.Config` instance - a dictionary
+representation of a charm's ``config.yaml`` file. This object can
+be used to:
+
+* get a charm's current config values
+* check if a config value has changed since the last hook invocation
+* view the previous value of a changed config item
+* save arbitrary key/value data for use in a later hook
+
+For the following examples we'll assume our charm has a config.yaml file that
+looks like this::
+
+  options:
+    app-name:
+      type: string
+      default: "My App"
+      description: "Name of your app."
+
+
+Getting charm config values
+---------------------------
+
+::
+
+  # hooks/hooks.py
+
+  from charmhelpers.core import hookenv
+
+  hooks = hookenv.Hooks()
+
+  @hooks.hook('install')
+  def install():
+      config = hookenv.config()
+
+      assert config['app-name'] == 'My App'
+
+Checking if a config value has changed
+--------------------------------------
+
+Let's say the user changes the ``app-name`` config value at runtime by
+executing the following juju command::
+
+  juju set mycharm app-name="My New App"
+
+which triggers a ``config-changed`` hook::
+
+  # hooks/hooks.py
+
+  from charmhelpers.core import hookenv
+
+  hooks = hookenv.Hooks()
+
+  @hooks.hook('config-changed')
+  def config_changed():
+      config = hookenv.config()
+
+      assert config.changed('app-name')
+      assert config['app-name'] == 'My New App'
+      assert config.previous('app-name') == 'My App'
+
+Saving arbitrary key/value data
+-------------------------------
+
+The :class:`Config <charmhelpers.core.hookenv.Config>` object maybe also be
+used to store arbitrary data that you want to persist across hook
+invocations::
+
+  # hooks/hooks.py
+
+  from charmhelpers.core import hookenv
+
+  hooks = hookenv.Hooks()
+
+  @hooks.hook('install')
+  def install():
+      config = hookenv.config()
+
+      config['mykey'] = 'myval'
+
+  @hooks.hook('config-changed')
+  def config_changed():
+      config = hookenv.config()
+
+      assert config['mykey'] == 'myval'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/services.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/services.rst
new file mode 100644
index 0000000000000000000000000000000000000000..96b2971e35913b0ee12505b3af80e250d7f4de61
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/examples/services.rst
@@ -0,0 +1,160 @@
+Managing Charms with the Services Framework
+===========================================
+
+Traditional charm authoring is focused on implementing hooks.  That is,
+the charm author is thinking in terms of "What hook am I handling; what
+does this hook need to do?"  However, in most cases, the real question
+should be "Do I have the information I need to configure and start this
+piece of software and, if so, what are the steps for doing so?"  The
+services framework tries to bring the focus to the data and the
+setup tasks, in the most declarative way possible.
+
+
+Hooks as Data Sources for Service Definitions
+---------------------------------------------
+
+While the ``install``, ``start``, and ``stop`` hooks clearly represent
+state transitions, all of the other hooks are really notifications of
+changes in data from external sources, such as config data values in
+the case of ``config-changed`` or relation data for any of the
+``*-relation-*`` hooks.  Moreover, many charms that rely on external
+data from config options or relations find themselves needing some
+piece of external data before they can even configure and start anything,
+and so the ``start`` hook loses its semantic usefulness.
+
+If data is required from multiple sources, it even becomes impossible to
+know which hook will be executing when all required data is available.
+(E.g., which relation will be the last to execute; will the required
+config option be set before or after all of the relations are available?)
+One common solution to this problem is to create "flag files" to track
+whether a given bit of data has been observed, but this can get cluttered
+quickly and is difficult to understand what conditions lead to which actions.
+
+When using the services framework, all hooks other than ``install``
+are handled by a single call to :meth:`manager.manage() <charmhelpers.core.services.base.ServiceManager.manage>`.
+This can be done with symlinks, or by having a ``definitions.py`` file
+containing the service defintions, and every hook can be reduced to::
+
+  #!/bin/env python
+  from charmhelpers.core.services import ServiceManager
+  from definitions import service_definitions
+  ServiceManager(service_definitions).manage()
+
+So, what magic goes into ``definitions.py``?
+
+
+Service Definitions Overview
+----------------------------
+
+The format of service definitions are fully documented in
+:class:`~charmhelpers.core.services.base.ServiceManager`, but most commonly
+will consist of one or more dictionaries containing four items: the name of
+a service being managed, the list of data contexts required before the service
+can be configured and started, the list of actions to take when the data
+requirements are satisfied, and list of ports to open.  The service name
+generally maps to an Upstart job, the required data contexts are ``dict``
+or ``dict``-like structures that contain the data once available (usually
+subclasses of :class:`~charmhelpers.core.services.helpers.RelationContext`
+or wrappers around :func:`charmhelpers.core.hookenv.config`), and the actions
+are just callbacks that are passed the service name for which they are executing
+(or a subclass of :class:`~charmhelpers.core.services.base.ManagerCallback`
+for more complex cases).
+
+An example service definition might be::
+
+  service_definitions = [
+      {
+          'service': 'wordpress',
+          'ports': [80],
+          'required_data': [config(), MySQLRelation()],
+          'data_ready': [
+              actions.install_frontend,
+              services.render_template(source='wp-config.php.j2',
+                                       target=os.path.join(WP_INSTALL_DIR, 'wp-config.php'))
+              services.render_template(source='wordpress.upstart.j2',
+                                       target='/etc/init/wordpress'),
+          ],
+      },
+  ]
+
+Each time a hook is fired, the conditions will be checked (in this case, just
+that MySQL is available) and, if met, the appropriate actions taken (correct
+front-end installed, config files written / updated, and the Upstart job
+(re)started, implicitly).
+
+
+Required Data Contexts
+----------------------
+
+Required data contexts are, at the most basic level, are just dictionaries,
+and if they evaluate as True (e.g., if the contain data), their condition is
+considered to be met.  A simple sentinal could just be a function that returns
+data if available or an empty ``dict`` otherwise.
+
+For the common case of gathering data from relations, the
+:class:`~charmhelpers.core.services.helpers.RelationContext` base class gathers
+data from a named relation and checks for a set of required keys to be present
+and set on the relation before considering that relation complete.  For example,
+a basic MySQL context might be::
+
+  class MySQLRelation(RelationContext):
+      name = 'db'
+      interface = 'mysql'
+      required_keys = ['host', 'user', 'password', 'database']
+
+Because there could potentially be multiple units on a given relation, and
+to prevent conflicts when the data contexts are merged to be sent to templates
+(see below), the data for a ``RelationContext`` is nested in the following way::
+
+  relation[relation.name][unit_number][relation_key]
+
+For example, to get the host of the first MySQL unit (``mysql/0``)::
+
+  mysql = MySQLRelation()
+  unit_0_host = mysql[mysql.name][0]['host']
+
+Note that only units that have set values for all of the required keys are
+included in the list, and if no units have set all of the required keys,
+instantiating the ``RelationContext`` will result in an empty list.
+
+
+Data-Ready Actions
+------------------
+
+When a hook is triggered and all of the ``required_data`` contexts are complete,
+the list of "data ready" actions are executed.  These callbacks are passed
+the service name from the ``service`` key of the service definition for which
+they are running, and are responsible for (re)configuring the service
+according to the required data.
+
+The most common action should be to render a config file from a template.
+The :class:`render_template <charmhelpers.core.services.helpers.TemplateCallback>`
+helper will merge all of the ``required_data`` contexts and render a
+`Jinja2 <http://jinja.pocoo.org/>`_ template with the combined data.  For
+example, to render a list of DSNs for units on the db relation, the
+template should include::
+
+  databases: [
+    {% for unit in db %}
+      "mysql://{{unit['user']}}:{{unit['password']}}@{{unit['host']}}/{{unit['database']}}",
+    {% endfor %}
+  ]
+
+Note that the actions need to be idempotent, since they will all be re-run
+if something about the charm changes (that is, if a hook is triggered).  That
+is why rendering a template is preferred to editing a file via regular expression
+substitutions.
+
+Also note that the actions are not responsible for starting the service; there
+are separate ``start`` and ``stop`` options that default to starting and stopping
+an Upstart service with the name given by the ``service`` value.
+
+
+Conclusion
+----------
+
+By using this framework, it is easy to see what the preconditions for the charm
+are, and there is never a concern about things being in a partially configured
+state.  As a charm author, you can focus on what is important to you: what
+data is mandatory, what is optional, and what actions should be taken once
+the requirements are met.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/getting-started.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/getting-started.rst
new file mode 100644
index 0000000000000000000000000000000000000000..785fc8693eb5f74ab1b72ffe1affb8804a182a5c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/getting-started.rst
@@ -0,0 +1,152 @@
+Getting Started
+===============
+
+For a video introduction to ``charmhelpers``, check out this
+`Charm School session <http://www.youtube.com/watch?v=6kWfLujVwNI>`_. To start
+using ``charmhelpers``, proceed with the instructions on the remainder of this
+page.
+
+Installing Charm Tools
+----------------------
+
+First, follow `these instructions <https://jujucharms.com/docs/stable/tools-charm-tools.html>`_
+to install the ``charm-tools`` package for your platform.
+
+Creating a New Charm
+--------------------
+
+::
+
+  $ cd ~
+  $ mkdirs -p charms/precise
+  $ cd charms/precise
+  $ charm create -t python mycharm
+  INFO: Generating template for mycharm in ./mycharm
+  INFO: No mycharm in apt cache; creating an empty charm instead.
+  Symlink all hooks to one python source file? [yN] y
+  INFO:root:Loading charm helper config from charm-helpers.yaml.
+  INFO:root:Checking out lp:charm-helpers to /tmp/tmpPAqUyN/charm-helpers.
+  Branched 160 revisions.
+  INFO:root:Syncing directory: /tmp/tmpPAqUyN/charm-helpers/charmhelpers/core -> lib/charmhelpers/core.
+  INFO:root:Adding missing __init__.py: lib/charmhelpers/__init__.py
+
+Let's see what our new charm looks like::
+
+  $ tree mycharm/
+  mycharm/
+  ├── charm-helpers.yaml
+  ├── config.yaml
+  ├── hooks
+  │   ├── config-changed -> hooks.py
+  │   ├── hooks.py
+  │   ├── install -> hooks.py
+  │   ├── start -> hooks.py
+  │   ├── stop -> hooks.py
+  │   └── upgrade-charm -> hooks.py
+  ├── icon.svg
+  ├── lib
+  │   └── charmhelpers
+  │       ├── core
+  │       │   ├── fstab.py
+  │       │   ├── hookenv.py
+  │       │   ├── host.py
+  │       │   └── __init__.py
+  │       └── __init__.py
+  ├── metadata.yaml
+  ├── README.ex
+  ├── revision
+  ├── scripts
+  │   └── charm_helpers_sync.py
+  └── tests
+      ├── 00-setup
+      └── 10-deploy
+
+  6 directories, 20 files
+
+The ``charmhelpers`` code is bundled in our charm in the ``lib/`` directory.
+All of our python code will go in ``hooks/hook.py``. A look at that file reveals
+that ``charmhelpers`` has been added to the python path and imported for us::
+
+  $ head mycharm/hooks/hooks.py -n11
+  #!/usr/bin/python
+
+  import os
+  import sys
+
+  sys.path.insert(0, os.path.join(os.environ['CHARM_DIR'], 'lib'))
+
+  from charmhelpers.core import (
+      hookenv,
+      host,
+  )
+
+Updating Charmhelpers Packages
+------------------------------
+
+By default, a new charm installs only the ``charmhelpers.core`` package, but
+other packages are available (for a complete list, see the :doc:`api/charmhelpers`).
+The installed packages are controlled by the ``charm-helpers.yaml`` file in our charm::
+
+  $ cd mycharm
+  $ cat charm-helpers.yaml
+  destination: lib/charmhelpers
+  branch: lp:charm-helpers
+  include:
+    - core
+
+Let's update this file to include some more packages::
+
+  $ vim charm-helpers.yaml
+  $ cat charm-helpers.yaml
+  destination: lib/charmhelpers
+  branch: lp:charm-helpers
+  include:
+    - core
+    - contrib.storage
+    - fetch
+
+Now we need to download the new packages into our charm::
+
+  $ ./scripts/charm_helpers_sync.py -c charm-helpers.yaml
+  INFO:root:Loading charm helper config from charm-helpers.yaml.
+  INFO:root:Checking out lp:charm-helpers to /tmp/tmpT38Y87/charm-helpers.
+  Branched 160 revisions.
+  INFO:root:Syncing directory: /tmp/tmpT38Y87/charm-helpers/charmhelpers/core -> lib/charmhelpers/core.
+  INFO:root:Syncing directory: /tmp/tmpT38Y87/charm-helpers/charmhelpers/contrib/storage -> lib/charmhelpers/contrib/storage.
+  INFO:root:Adding missing __init__.py: lib/charmhelpers/contrib/__init__.py
+  INFO:root:Syncing directory: /tmp/tmpT38Y87/charm-helpers/charmhelpers/fetch -> lib/charmhelpers/fetch.
+
+A look at our charmhelpers directory reveals that the new packages have indeed
+been added. We are now free to import and use them in our charm::
+
+  $ tree lib/charmhelpers/
+  lib/charmhelpers/
+  ├── contrib
+  │   ├── __init__.py
+  │   └── storage
+  │       ├── __init__.py
+  │       └── linux
+  │           ├── ceph.py
+  │           ├── __init__.py
+  │           ├── loopback.py
+  │           ├── lvm.py
+  │           └── utils.py
+  ├── core
+  │   ├── fstab.py
+  │   ├── hookenv.py
+  │   ├── host.py
+  │   └── __init__.py
+  ├── fetch
+  │   ├── archiveurl.py
+  │   ├── bzrurl.py
+  │   └── __init__.py
+  └── __init__.py
+
+  5 directories, 15 files
+
+Next Steps
+----------
+
+Now that you have access to ``charmhelpers`` in your charm, check out the
+:doc:`example-index` or :doc:`api/charmhelpers` to learn about all the great
+functionality that ``charmhelpers`` provides.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/index.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..7a75555cdc4afc43e53a4da3afd9b5751cb9f3ad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/docs/index.rst
@@ -0,0 +1,41 @@
+.. Charm Helpers documentation master file, created by
+   sphinx-quickstart on Fri Jun  6 10:34:44 2014.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Charm Helpers Documentation
+===========================
+
+The ``charmhelpers`` Python library is an extensive collection of functions and classes
+for simplifying the development of `Juju Charms`_. It includes utilities for:
+
+* Interacting with the host environment
+* Managing hook events
+* Reading and writing charm configuration
+* Installing dependencies
+* Much, much more!
+
+.. toctree::
+   :maxdepth: 2
+
+   getting-started
+   example-index
+   api/charmhelpers
+
+.. toctree::
+   :caption: Project
+   :glob:
+   :maxdepth: 3
+
+   contributing
+   changelog
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+
+
+.. _Juju Charms: https://juju.ubuntu.com/docs/
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..97dbebaed2bd8c992d55d7446095a2a02772687b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/requirements.txt
@@ -0,0 +1,16 @@
+# Runtime Dependencies
+
+# https://pyyaml.org/wiki/PyYAML#history
+# PyYAML==5.2 is last supported for py34
+PyYAML
+
+# https://jinja.palletsprojects.com/en/2.11.x/changelog/
+# Jinja2==2.10 is last supported for py34 (trusty)
+# Jinja2==2.11 is last supported for py27 & py35 (xenial)
+Jinja2
+
+six
+netaddr
+Tempita
+
+pbr!=2.1.0,>=2.0.0 # Apache-2.0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/README b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/README
new file mode 100644
index 0000000000000000000000000000000000000000..baaf91962d2a0ddc2fb6b5fb1824a2081df8839a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/README
@@ -0,0 +1 @@
+This directory contains scripts for managing the charmhelpers project
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/update-revno b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/update-revno
new file mode 100755
index 0000000000000000000000000000000000000000..48e6bba99da16156bba0ef75cf0008b0c35d8663
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/scripts/update-revno
@@ -0,0 +1,11 @@
+#!/bin/bash
+VERSION=$(cat VERSION)
+REVNO=$(bzr revno)
+bzr di &>/dev/null
+if [ $? ]; then
+    REVNO="${REVNO}+"
+fi
+cat << EOF > charmhelpers/version.py
+CHARMHELPERS_VERSION = '${VERSION}'
+CHARMHELPERS_BZRREVNO = '${REVNO}'
+EOF
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..af820fb78782d5051c8b18e1ed7c2e77c04310eb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.cfg
@@ -0,0 +1,36 @@
+[metadata]
+name = charmhelpers
+summary = Helpers for Juju Charm development
+description-file = 
+    README.rst
+author = Charmers
+author-email = juju@lists.ubuntu.com
+home-page = https://github.com/juju/charm-helpers
+classifier = 
+    Intended Audience :: Information Technology
+    Intended Audience :: System Administrators
+    License :: OSI Approved :: Apache Software License
+    Operating System :: POSIX :: Linux
+    Programming Language :: Python
+    Programming Language :: Python :: 2
+    Programming Language :: Python :: 2.7
+    Programming Language :: Python :: 3
+    Programming Language :: Python :: 3.6
+    Programming Language :: Python :: 3.7
+    Programming Language :: Python :: 3.8
+
+[files]
+packages = 
+    charmhelpers
+scripts =
+    bin/chlp
+    bin/contrib/charmsupport/charmsupport
+    bin/contrib/saltstack/salt-call
+
+[nosetests]
+with-coverage=1
+cover-erase=1
+cover-package=charmhelpers,tools
+
+[upload_sphinx]
+upload-dir = docs/_build/html
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d8594c18214533b15c511991656497131985c61
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/setup.py
@@ -0,0 +1,27 @@
+# Copyright 2016 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import setuptools
+
+# In python < 2.7.4, a lazy loading of package `pbr` will break
+# setuptools if some other modules registered functions in `atexit`.
+# solution from: http://bugs.python.org/issue15881#msg170215
+try:
+    import multiprocessing  # noqa
+except ImportError:
+    pass
+
+setuptools.setup(
+    setup_requires=['pbr>=2.0.0'],
+    pbr=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tarmac_tests.sh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tarmac_tests.sh
new file mode 100755
index 0000000000000000000000000000000000000000..28f7e5a4432b97d9a4b4b7f06f1bb0e3538fb560
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tarmac_tests.sh
@@ -0,0 +1,13 @@
+#!/bin/sh
+# How the tests are run in Jenkins by Tarmac
+
+set -e
+
+pkgs='python-flake8 python-shelltoolbox python-tempita python-nose python-mock python-testtools python-jinja2 python-coverage python-git python-netifaces python-netaddr python-pip zip'
+if ! dpkg -s $pkgs 2>/dev/null >/dev/null ; then
+    echo "Required packages are missing. Please ensure that the missing packages are installed."
+    echo "Run: sudo apt-get install $pkgs"
+    exit 1
+fi
+
+make build
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/test-requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/test-requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..733801e1ba5ff896eecb7d80ee742b8e4cc50e7d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/test-requirements.txt
@@ -0,0 +1,37 @@
+# Test-only dependencies are unpinned.
+#
+git+https://git.launchpad.net/ubuntu/+source/python-distutils-extra
+pip
+coverage>=3.6
+mock>=1.0.1,<1.1.0
+nose>=1.3.1
+flake8
+testtools==0.9.14  # Before dependent on modern 'six'
+amulet
+distro-info
+sphinx_rtd_theme
+ipaddress;python_version<'3.0'  # Py27 unit test requirement
+
+
+##########################################################
+# Specify versions of runtime dependencies where possible.
+# The requirements.txt file cannot be so specific
+
+# https://pyyaml.org/wiki/PyYAML#history
+# PyYAML==5.2 is last supported for py34
+PyYAML==5.2;python_version >= '3.0' and python_version <= '3.4' # py3 trusty
+PyYAML;     python_version == '2.7' or python_version >= '3.5'  # all else
+
+# https://jinja.palletsprojects.com/en/2.11.x/changelog/
+# Jinja2==2.10 is last supported for py34
+# Jinja2==2.11 is last supported for py27 & py35
+Jinja2==2.10;python_version >= '3.0' and python_version <= '3.4' # py3 trusty
+Jinja2==2.11;python_version == '2.7' or python_version == '3.5'  # py27, py35
+Jinja2;      python_version >= '3.6'                             # py36 and on
+
+##############################################################
+
+netifaces==0.10    # trusty is 0.8, but using py3 compatible version for tests.
+psutil==1.2.1      # trusty
+python-keystoneclient==2.3.2 # xenial
+dnspython==1.11.1  # trusty
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5707debfde11bad2916f95be62df9f24a0306efa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/__init__.py
@@ -0,0 +1,16 @@
+import sys
+import mock
+
+
+sys.modules['yum'] = mock.MagicMock()
+sys.modules['sriov_netplan_shim'] = mock.MagicMock()
+sys.modules['sriov_netplan_shim.pci'] = mock.MagicMock()
+with mock.patch('charmhelpers.deprecate') as ch_deprecate:
+    def mock_deprecate(warning, date=None, log=None):
+        def mock_wrap(f):
+            def wrapped_f(*args, **kwargs):
+                return f(*args, **kwargs)
+            return wrapped_f
+        return mock_wrap
+    ch_deprecate.side_effect = mock_deprecate
+    import charmhelpers.contrib.openstack.utils as openstack  # noqa: F401
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_cmdline.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_cmdline.py
new file mode 100644
index 0000000000000000000000000000000000000000..549e70c025836268d2f52c4a2653669cd2d81848
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_cmdline.py
@@ -0,0 +1,236 @@
+"""Tests for the commandant code that analyzes a function signature to
+determine the parameters to argparse."""
+
+from unittest import TestCase
+from mock import (
+    patch,
+    MagicMock,
+    ANY,
+)
+import json
+from pprint import pformat
+import yaml
+import csv
+
+from six import StringIO
+
+from charmhelpers import cli
+
+
+class SubCommandTest(TestCase):
+    """Test creation of subcommands"""
+
+    def setUp(self):
+        super(SubCommandTest, self).setUp()
+        self.cl = cli.CommandLine()
+
+    @patch('sys.exit')
+    def test_subcommand_wrapper(self, _sys_exit):
+        """Test function name detection"""
+        @self.cl.subcommand()
+        def payload():
+            "A function that does work."
+            pass
+        args = self.cl.argument_parser.parse_args(['payload'])
+        self.assertEqual(args.func, payload)
+        self.assertEqual(_sys_exit.mock_calls, [])
+
+    @patch('sys.exit')
+    def test_subcommand_wrapper_bogus_arguments(self, _sys_exit):
+        """Test function name detection"""
+        @self.cl.subcommand()
+        def payload():
+            "A function that does work."
+            pass
+        with self.assertRaises(TypeError):
+            with patch("sys.argv", "tests deliberately bad input".split()):
+                with patch("sys.stderr"):
+                    self.cl.argument_parser.parse_args()
+        _sys_exit.assert_called_once_with(2)
+
+    @patch('sys.exit')
+    def test_subcommand_wrapper_cmdline_options(self, _sys_exit):
+        """Test detection of positional arguments and optional parameters."""
+        @self.cl.subcommand()
+        def payload(x, y=None):
+            "A function that does work."
+            return x
+        args = self.cl.argument_parser.parse_args(['payload', 'positional', '--y=optional'])
+        self.assertEqual(args.func, payload)
+        self.assertEqual(args.x, 'positional')
+        self.assertEqual(args.y, 'optional')
+        self.assertEqual(_sys_exit.mock_calls, [])
+
+    @patch('sys.exit')
+    def test_subcommand_builder(self, _sys_exit):
+        def noop(z):
+            pass
+
+        @self.cl.subcommand_builder('payload', description="A subcommand")
+        def payload_command(subparser):
+            subparser.add_argument('-z', action='store_true')
+            return noop
+
+        args = self.cl.argument_parser.parse_args(['payload', '-z'])
+        self.assertEqual(args.func, noop)
+        self.assertTrue(args.z)
+        self.assertFalse(_sys_exit.called)
+
+    def test_subcommand_builder_bogus_wrapped_args(self):
+        with self.assertRaises(TypeError):
+            @self.cl.subcommand_builder('payload', description="A subcommand")
+            def payload_command(subparser, otherarg):
+                pass
+
+    def test_run(self):
+        self.bar_called = False
+
+        @self.cl.subcommand()
+        def bar(x, y=None, *vargs):
+            "A function that does work."
+            self.assertEqual(x, 'baz')
+            self.assertEqual(y, 'why')
+            self.assertEqual(vargs, ('mux', 'zob'))
+            self.bar_called = True
+            return "qux"
+
+        args = ['chlp', 'bar', '--y', 'why', 'baz', 'mux', 'zob']
+        self.cl.formatter = MagicMock()
+        with patch("sys.argv", args):
+            with patch("charmhelpers.core.unitdata._KV") as _KV:
+                self.cl.run()
+                assert _KV.flush.called
+        self.assertTrue(self.bar_called)
+        self.cl.formatter.format_output.assert_called_once_with('qux', ANY)
+
+    def test_no_output(self):
+        self.bar_called = False
+
+        @self.cl.subcommand()
+        @self.cl.no_output
+        def bar(x, y=None, *vargs):
+            "A function that does work."
+            self.bar_called = True
+            return "qux"
+
+        args = ['foo', 'bar', 'baz']
+        self.cl.formatter = MagicMock()
+        with patch("sys.argv", args):
+            self.cl.run()
+        self.assertTrue(self.bar_called)
+        self.cl.formatter.format_output.assert_called_once_with('', ANY)
+
+    def test_test_command(self):
+        self.bar_called = False
+        self.bar_result = True
+
+        @self.cl.subcommand()
+        @self.cl.test_command
+        def bar(x, y=None, *vargs):
+            "A function that does work."
+            self.bar_called = True
+            return self.bar_result
+
+        args = ['foo', 'bar', 'baz']
+        self.cl.formatter = MagicMock()
+        with patch("sys.argv", args):
+            self.cl.run()
+        self.assertTrue(self.bar_called)
+        self.assertEqual(self.cl.exit_code, 0)
+        self.cl.formatter.format_output.assert_called_once_with('', ANY)
+
+        self.bar_result = False
+        with patch("sys.argv", args):
+            self.cl.run()
+        self.assertEqual(self.cl.exit_code, 1)
+
+
+class OutputFormatterTest(TestCase):
+    def setUp(self):
+        super(OutputFormatterTest, self).setUp()
+        self.expected_formats = (
+            "raw",
+            "json",
+            "py",
+            "yaml",
+            "csv",
+            "tab",
+        )
+        self.outfile = StringIO()
+        self.of = cli.OutputFormatter(outfile=self.outfile)
+        self.output_data = {"this": "is", "some": 1, "data": dict()}
+
+    def test_supports_formats(self):
+        self.assertEqual(sorted(self.expected_formats),
+                         sorted(self.of.supported_formats))
+
+    def test_adds_arguments(self):
+        ap = MagicMock()
+        arg_group = MagicMock()
+        add_arg = MagicMock()
+        arg_group.add_argument = add_arg
+        ap.add_mutually_exclusive_group.return_value = arg_group
+        self.of.add_arguments(ap)
+
+        self.assertTrue(add_arg.called)
+
+        for call_args in add_arg.call_args_list:
+            if "--format" in call_args[0]:
+                self.assertEqual(sorted(call_args[1]['choices']),
+                                 sorted(self.expected_formats))
+                self.assertEqual(call_args[1]['default'], 'raw')
+                break
+        else:
+            print(arg_group.call_args_list)
+            self.fail("No --format argument was created")
+
+        all_args = [c[0][0] for c in add_arg.call_args_list]
+        all_args.extend([c[0][1] for c in add_arg.call_args_list if len(c[0]) > 1])
+        for fmt in self.expected_formats:
+            self.assertIn("-{}".format(fmt[0]), all_args)
+            self.assertIn("--{}".format(fmt), all_args)
+
+    def test_outputs_raw(self):
+        self.of.raw(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), str(self.output_data))
+
+    def test_outputs_json(self):
+        self.of.json(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), json.dumps(self.output_data))
+
+    def test_outputs_py(self):
+        self.of.py(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), pformat(self.output_data) + "\n")
+
+    def test_outputs_yaml(self):
+        self.of.yaml(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), yaml.dump(self.output_data))
+
+    def test_outputs_csv(self):
+        sample = StringIO()
+        writer = csv.writer(sample)
+        writer.writerows(self.output_data)
+        sample.seek(0)
+        self.of.csv(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), sample.read())
+
+    def test_outputs_tab(self):
+        sample = StringIO()
+        writer = csv.writer(sample, dialect=csv.excel_tab)
+        writer.writerows(self.output_data)
+        sample.seek(0)
+        self.of.tab(self.output_data)
+        self.outfile.seek(0)
+        self.assertEqual(self.outfile.read(), sample.read())
+
+    def test_formats_output(self):
+        for format in self.expected_formats:
+            mock_f = MagicMock()
+            setattr(self.of, format, mock_f)
+            self.of.format_output(self.output_data, format)
+            mock_f.assert_called_with(self.output_data)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_function_signature_analysis.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_function_signature_analysis.py
new file mode 100644
index 0000000000000000000000000000000000000000..515d9ceca36b9bbc1b97901231b1ba60b7a13774
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/cli/test_function_signature_analysis.py
@@ -0,0 +1,46 @@
+"""Tests for the commandant code that analyzes a function signature to
+determine the parameters to argparse."""
+
+from testtools import TestCase
+
+from charmhelpers import cli
+
+
+class FunctionSignatureTest(TestCase):
+    """Test a variety of function signatures."""
+
+    def test_positional_arguments(self):
+        """Finite number of order-dependent required arguments."""
+        argparams = tuple(cli.describe_arguments(lambda x, y, z: False))
+        self.assertEqual(3, len(argparams))
+        for argspec in ((('x',), {}), (('y',), {}), (('z',), {})):
+            self.assertIn(argspec, argparams)
+
+    def test_keyword_arguments(self):
+        """Function has optional parameters with default values."""
+        argparams = tuple(cli.describe_arguments(lambda x, y=3, z="bar": False))
+        self.assertEqual(3, len(argparams))
+        for argspec in ((('x',), {}),
+                        (('--y',), {"default": 3}),
+                        (('--z',), {"default": "bar"})):
+            self.assertIn(argspec, argparams)
+
+    def test_varargs(self):
+        """Function has a splat-operator parameter to catch an arbitrary number
+        of positional parameters."""
+        argparams = tuple(cli.describe_arguments(
+            lambda x, y=3, *z: False))
+        self.assertEqual(3, len(argparams))
+        for argspec in ((('x',), {}),
+                        (('--y',), {"default": 3}),
+                        (('z',), {"nargs": "*"})):
+            self.assertIn(argspec, argparams)
+
+    def test_keyword_splat_missing(self):
+        """Double-splat arguments can't be represented in the current version
+        of commandant."""
+        args = cli.describe_arguments(lambda x, y=3, *z, **missing: False)
+        for opts, _ in args:
+            # opts should be ('varname',) at this point
+            self.assertTrue(len(opts) == 1)
+            self.assertNotIn('missing', opts)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/context/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/context/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/context/test_context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/context/test_context.py
new file mode 100644
index 0000000000000000000000000000000000000000..35543015a2ed17024fb34c36ad128c2e11a4a5da
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/context/test_context.py
@@ -0,0 +1,199 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+import unittest
+from mock import patch, sentinel
+import six
+
+from charmhelpers import context
+from charmhelpers.core import hookenv
+
+
+class TestRelations(unittest.TestCase):
+    def setUp(self):
+        def install(*args, **kw):
+            p = patch.object(*args, **kw)
+            p.start()
+            self.addCleanup(p.stop)
+
+        install(hookenv, 'relation_types', return_value=['rel', 'pear'])
+        install(hookenv, 'peer_relation_id', return_value='pear:9')
+        install(hookenv, 'relation_ids',
+                side_effect=lambda x: ['{}:{}'.format(x, i)
+                                       for i in range(9, 11)])
+        install(hookenv, 'related_units',
+                side_effect=lambda x: ['svc_' + x.replace(':', '/')])
+        install(hookenv, 'local_unit', return_value='foo/1')
+        install(hookenv, 'relation_get')
+        install(hookenv, 'relation_set')
+        # install(hookenv, 'is_leader', return_value=False)
+
+    def test_relations(self):
+        rels = context.Relations()
+        self.assertListEqual(list(rels.keys()),
+                             ['pear', 'rel'])  # Ordered alphabetically
+        self.assertListEqual(list(rels['rel'].keys()),
+                             ['rel:9', 'rel:10'])  # Ordered numerically
+
+        # Relation data is loaded on demand, not on instantiation.
+        self.assertFalse(hookenv.relation_get.called)
+
+        # But we did have to retrieve some lists of units etc.
+        self.assertGreaterEqual(hookenv.relation_ids.call_count, 2)
+        self.assertGreaterEqual(hookenv.related_units.call_count, 2)
+
+    def test_relations_peer(self):
+        # The Relations instance has a short cut to the peer relation.
+        # If the charm has managed to get multiple peer relations,
+        # it returns the 'primary' one used here and returned by
+        # hookenv.peer_relation_id()
+        rels = context.Relations()
+        self.assertIs(rels.peer, rels['pear']['pear:9'])
+
+    def test_relation(self):
+        rel = context.Relations()['rel']['rel:9']
+        self.assertEqual(rel.relid, 'rel:9')
+        self.assertEqual(rel.relname, 'rel')
+        self.assertEqual(rel.service, 'svc_rel')
+        self.assertTrue(isinstance(rel.local, context.RelationInfo))
+        self.assertEqual(rel.local.unit, hookenv.local_unit())
+        self.assertTrue(isinstance(rel.peers, context.OrderedDict))
+        self.assertTrue(len(rel.peers), 2)
+        self.assertTrue(isinstance(rel.peers['svc_pear/9'],
+                                   context.RelationInfo))
+
+        # I use this in my log messages. Relation id for identity
+        # plus service name for ease of reference.
+        self.assertEqual(str(rel), 'rel:9 (svc_rel)')
+
+    def test_relation_no_peer_relation(self):
+        hookenv.peer_relation_id.return_value = None
+        rel = context.Relation('rel:10')
+        self.assertTrue(rel.peers is None)
+
+    def test_relation_no_peers(self):
+        hookenv.related_units.side_effect = None
+        hookenv.related_units.return_value = []
+        rel = context.Relation('rel:10')
+        self.assertDictEqual(rel.peers, {})
+
+    def test_peer_relation(self):
+        peer_rel = context.Relations().peer
+        # The peer relation does not have a 'peers' properly. We
+        # could give it one for symmetry, but it seems somewhat silly.
+        self.assertTrue(peer_rel.peers is None)
+
+    def test_relationinfo(self):
+        hookenv.relation_get.return_value = {sentinel.key: 'value'}
+        r = context.RelationInfo('rel:10', 'svc_rel/9')
+
+        self.assertEqual(r.relname, 'rel')
+        self.assertEqual(r.relid, 'rel:10')
+        self.assertEqual(r.unit, 'svc_rel/9')
+        self.assertEqual(r.service, 'svc_rel')
+        self.assertEqual(r.number, 9)
+
+        self.assertFalse(hookenv.relation_get.called)
+        self.assertEqual(r[sentinel.key], 'value')
+        hookenv.relation_get.assert_called_with(unit='svc_rel/9', rid='rel:10')
+
+        # Updates fail
+        with self.assertRaises(TypeError):
+            r['newkey'] = 'foo'
+
+        # Deletes fail
+        with self.assertRaises(TypeError):
+            del r[sentinel.key]
+
+        # I use this for logging.
+        self.assertEqual(str(r), 'rel:10 (svc_rel/9)')
+
+    def test_relationinfo_local(self):
+        r = context.RelationInfo('rel:10', hookenv.local_unit())
+
+        # Updates work, with standard strings.
+        r[sentinel.key] = 'value'
+        hookenv.relation_set.assert_called_once_with(
+            'rel:10', {sentinel.key: 'value'})
+
+        # Python 2 unicode strings work too.
+        hookenv.relation_set.reset_mock()
+        r[sentinel.key] = six.u('value')
+        hookenv.relation_set.assert_called_once_with(
+            'rel:10', {sentinel.key: six.u('value')})
+
+        # Byte strings fail under Python 3.
+        if six.PY3:
+            with self.assertRaises(ValueError):
+                r[sentinel.key] = six.b('value')
+
+        # Deletes work
+        del r[sentinel.key]
+        hookenv.relation_set.assert_called_with('rel:10', {sentinel.key: None})
+
+        # Attempting to write a non-string fails
+        with self.assertRaises(ValueError):
+            r[sentinel.key] = 42
+
+
+class TestLeader(unittest.TestCase):
+    @patch.object(hookenv, 'leader_get')
+    def test_get(self, leader_get):
+        leader_get.return_value = {'a_key': 'a_value'}
+
+        leader = context.Leader()
+        self.assertEqual(leader['a_key'], 'a_value')
+        leader_get.assert_called_with()
+
+        with self.assertRaises(KeyError):
+            leader['missing']
+
+    @patch.object(hookenv, 'leader_set')
+    @patch.object(hookenv, 'leader_get')
+    @patch.object(hookenv, 'is_leader')
+    def test_set(self, is_leader, leader_get, leader_set):
+        is_leader.return_value = True
+        leader = context.Leader()
+
+        # Updates work
+        leader[sentinel.key] = 'foo'
+        leader_set.assert_called_with({sentinel.key: 'foo'})
+        del leader[sentinel.key]
+        leader_set.assert_called_with({sentinel.key: None})
+
+        # Python 2 unicode string values work too
+        leader[sentinel.key] = six.u('bar')
+        leader_set.assert_called_with({sentinel.key: 'bar'})
+
+        # Byte strings fail under Python 3
+        if six.PY3:
+            with self.assertRaises(ValueError):
+                leader[sentinel.key] = six.b('baz')
+
+        # Non strings fail, as implicit casting causes more trouble
+        # than it solves. Simple types like integers would round trip
+        # back as strings.
+        with self.assertRaises(ValueError):
+            leader[sentinel.key] = 42
+
+    @patch.object(hookenv, 'leader_set')
+    @patch.object(hookenv, 'leader_get')
+    @patch.object(hookenv, 'is_leader')
+    def test_set_not_leader(self, is_leader, leader_get, leader_set):
+        is_leader.return_value = False
+        leader_get.return_value = {'a_key': 'a_value'}
+        leader = context.Leader()
+        with self.assertRaises(TypeError):
+            leader['a_key'] = 'foo'
+        with self.assertRaises(TypeError):
+            del leader['a_key']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/amulet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/amulet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/amulet/test_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/amulet/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..78d3ecd110bea991a18312aed9c6ad66db9733aa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/amulet/test_utils.py
@@ -0,0 +1,370 @@
+# Copyright 2015 Canonical Ltd.
+#
+# Authors:
+#  Adam Collard <adam.collard@canonical.com>
+
+from contextlib import contextmanager
+from mock import patch
+import sys
+import unittest
+
+import six
+
+from charmhelpers.contrib.amulet.utils import (
+    AmuletUtils,
+    amulet,
+)
+
+
+@contextmanager
+def captured_output():
+    """Simple context manager to capture stdout/stderr.
+
+    Source: http://stackoverflow.com/a/17981937/56219.
+    """
+    new_out, new_err = six.StringIO(), six.StringIO()
+    old_out, old_err = sys.stdout, sys.stderr
+    try:
+        sys.stdout, sys.stderr = new_out, new_err
+        yield sys.stdout, sys.stderr
+    finally:
+        sys.stdout, sys.stderr = old_out, old_err
+
+
+class FakeSentry(object):
+
+    def __init__(self, name="foo"):
+        self.commands = {}
+        self.info = {"unit_name": name}
+
+    def run(self, command):
+        return self.commands[command]
+
+    def ssh(self, command):
+        return self.commands[command]
+
+    def run_action(self, action, action_args=None):
+        return 'action-id'
+
+
+class ValidateServicesByNameTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_errors_for_unknown_upstart_service(self):
+        """
+        Returns a message if the Upstart service is unknown.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "trusty", 0
+        self.sentry_unit.commands["sudo status foo"] = (
+            "status: Unknown job: foo", 1)
+
+        result = self.utils.validate_services_by_name(
+            {self.sentry_unit: ["foo"]})
+        self.assertIsNotNone(result)
+
+    def test_none_for_started_upstart_service(self):
+        """
+        Returns None if the Upstart service is running.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "trusty", 0
+        self.sentry_unit.commands["sudo status foo"] = (
+            "foo start/running, process 42", 0)
+
+        result = self.utils.validate_services_by_name(
+            {self.sentry_unit: ["foo"]})
+        self.assertIsNone(result)
+
+    def test_errors_for_stopped_upstart_service(self):
+        """
+        Returns a message if the Upstart service is stopped.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "trusty", 0
+        self.sentry_unit.commands["sudo status foo"] = "foo stop/waiting", 0
+
+        result = self.utils.validate_services_by_name(
+            {self.sentry_unit: ["foo"]})
+        self.assertIsNotNone(result)
+
+    def test_errors_for_unknown_systemd_service(self):
+        """
+        Returns a message if a systemd service is unknown.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "vivid", 0
+        self.sentry_unit.commands["sudo service foo status"] = (u"""\
+\u25cf foo.service
+   Loaded: not-found (Reason: No such file or directory)
+   Active: inactive (dead)
+""", 3)
+
+        result = self.utils.validate_services_by_name({
+            self.sentry_unit: ["foo"]})
+        self.assertIsNotNone(result)
+
+    def test_none_for_started_systemd_service(self):
+        """
+        Returns None if a systemd service is running.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "vivid", 0
+        self.sentry_unit.commands["sudo service foo status"] = (u"""\
+\u25cf foo.service - Foo
+   Loaded: loaded (/lib/systemd/system/foo.service; enabled)
+   Active: active (exited) since Thu 1970-01-01 00:00:00 UTC; 42h 42min ago
+ Main PID: 3 (code=exited, status=0/SUCCESS)
+   CGroup: /system.slice/foo.service
+""", 0)
+        result = self.utils.validate_services_by_name(
+            {self.sentry_unit: ["foo"]})
+        self.assertIsNone(result)
+
+    def test_errors_for_stopped_systemd_service(self):
+        """
+        Returns a message if a systemd service is stopped.
+        """
+        self.sentry_unit.commands["lsb_release -cs"] = "vivid", 0
+        self.sentry_unit.commands["sudo service foo status"] = (u"""\
+\u25cf foo.service - Foo
+   Loaded: loaded (/lib/systemd/system/foo.service; disabled)
+   Active: inactive (dead)
+""", 3)
+        result = self.utils.validate_services_by_name(
+            {self.sentry_unit: ["foo"]})
+        self.assertIsNotNone(result)
+
+
+class RunActionTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_returns_action_id(self):
+        """Returns action_id."""
+
+        self.assertEqual("action-id", self.utils.run_action(
+            self.sentry_unit, "foo"))
+
+
+class WaitActionTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+
+    @patch.object(amulet.actions, "get_action_output")
+    def test_returns_true_if_completed(self, get_action_output):
+        """JSON output is parsed and returns True if the action completed."""
+
+        get_action_output.return_value = {"status": "completed"}
+
+        self.assertTrue(self.utils.wait_on_action("action-id"))
+        get_action_output.assert_called_with("action-id", full_output=True)
+
+    @patch.object(amulet.actions, "get_action_output")
+    def test_returns_false_if_still_running(self, get_action_output):
+        """
+        JSON output is parsed and returns False if the action is still running.
+        """
+        get_action_output.return_value = {"status": "running"}
+
+        self.assertFalse(self.utils.wait_on_action("action-id"))
+        get_action_output.assert_called_with("action-id", full_output=True)
+
+    @patch.object(amulet.actions, "get_action_output")
+    def test_returns_false_if_no_status(self, get_action_output):
+        """
+        JSON output is parsed and returns False if there is no action status.
+        """
+        get_action_output.return_value = {}
+
+        self.assertFalse(self.utils.wait_on_action("action-id"))
+        get_action_output.assert_called_with("action-id", full_output=True)
+
+
+class GetProcessIdListTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_returns_pids(self):
+        """
+        Normal execution returns a list of pids
+        """
+        self.sentry_unit.commands['pidof -x "foo"'] = ("123 124 125", 0)
+        result = self.utils.get_process_id_list(self.sentry_unit, "foo")
+        self.assertEqual(["123", "124", "125"], result)
+
+    def test_fails_if_no_process_found(self):
+        """
+        By default, the expectation is that a process is running. Failure
+        to find a given process results in an amulet.FAIL being
+        raised.
+        """
+        self.sentry_unit.commands['pidof -x "foo"'] = ("", 1)
+        with self.assertRaises(SystemExit) as cm, captured_output() as (
+                out, err):
+            self.utils.get_process_id_list(self.sentry_unit, "foo")
+        the_exception = cm.exception
+        self.assertEqual(1, the_exception.code)
+        self.assertEqual(
+            'foo `pidof -x "foo"` returned 1', out.getvalue().rstrip())
+
+    def test_looks_for_scripts(self):
+        """
+        pidof command uses -x to return a list of pids of scripts
+        """
+        self.sentry_unit.commands["pidof foo"] = ("", 1)
+        self.sentry_unit.commands['pidof -x "foo"'] = ("123 124 125", 0)
+        result = self.utils.get_process_id_list(self.sentry_unit, "foo")
+        self.assertEqual(["123", "124", "125"], result)
+
+    def test_expect_no_pid(self):
+        """
+        By setting expectation that there are no pids running the logic
+        about when to fail is reversed.
+        """
+        self.sentry_unit.commands[
+            'pidof -x "foo" || exit 0 && exit 1'] = ("", 0)
+        self.sentry_unit.commands[
+            'pidof -x "bar" || exit 0 && exit 1'] = ("", 1)
+        result = self.utils.get_process_id_list(
+            self.sentry_unit, "foo", expect_success=False)
+        self.assertEqual([], result)
+        with self.assertRaises(SystemExit) as cm, captured_output() as (
+                out, err):
+            self.utils.get_process_id_list(
+                self.sentry_unit, "bar", expect_success=False)
+        the_exception = cm.exception
+        self.assertEqual(1, the_exception.code)
+        self.assertEqual(
+            'foo `pidof -x "bar" || exit 0 && exit 1` returned 1',
+            out.getvalue().rstrip())
+
+
+class GetUnitProcessIdsTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_returns_map(self):
+        """
+        Normal execution returns a dictionary mapping process names to
+        PIDs for each unit.
+        """
+        second_sentry = FakeSentry(name="bar")
+        self.sentry_unit.commands['pidof -x "foo"'] = ("123 124", 0)
+        second_sentry.commands['pidof -x "bar"'] = ("456 457", 0)
+
+        result = self.utils.get_unit_process_ids({
+            self.sentry_unit: ["foo"], second_sentry: ["bar"]})
+        self.assertEqual({
+            self.sentry_unit: {"foo": ["123", "124"]},
+            second_sentry: {"bar": ["456", "457"]}}, result)
+
+    def test_expect_failure(self):
+        """
+        Expected failures return empty lists.
+        """
+        second_sentry = FakeSentry(name="bar")
+        self.sentry_unit.commands[
+            'pidof -x "foo" || exit 0 && exit 1'] = ("", 0)
+        second_sentry.commands['pidof -x "bar" || exit 0 && exit 1'] = ("", 0)
+
+        result = self.utils.get_unit_process_ids(
+            {self.sentry_unit: ["foo"], second_sentry: ["bar"]},
+            expect_success=False)
+        self.assertEqual({
+            self.sentry_unit: {"foo": []},
+            second_sentry: {"bar": []}}, result)
+
+
+class StatusGetTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_status_get(self):
+        """
+        We can get the status of a unit.
+        """
+        self.sentry_unit.commands[
+            "status-get --format=json --include-data"] = (
+                """{"status": "active", "message": "foo"}""", 0)
+        self.assertEqual(self.utils.status_get(self.sentry_unit),
+                         (u"active", u"foo"))
+
+    def test_status_get_missing_command(self):
+        """
+        Older releases of Juju have no status-get command.  In those
+        cases we should return the "unknown" status.
+        """
+        self.sentry_unit.commands[
+            "status-get --format=json --include-data"] = (
+                "status-get: command not found", 127)
+        self.assertEqual(self.utils.status_get(self.sentry_unit),
+                         (u"unknown", u""))
+
+
+class ValidateServicesByProcessIDTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self.utils = AmuletUtils()
+        self.sentry_unit = FakeSentry()
+
+    def test_accepts_list_wrong(self):
+        """
+        Validates that it can accept a list
+        """
+        expected = {self.sentry_unit: {"foo": [3, 4]}}
+        actual = {self.sentry_unit: {"foo": [12345, 67890]}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNotNone(result)
+
+    def test_accepts_list(self):
+        """
+        Validates that it can accept a list
+        """
+        expected = {self.sentry_unit: {"foo": [2, 3]}}
+        actual = {self.sentry_unit: {"foo": [12345, 67890]}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNone(result)
+
+    def test_accepts_string(self):
+        """
+        Validates that it can accept a string
+        """
+        expected = {self.sentry_unit: {"foo": 2}}
+        actual = {self.sentry_unit: {"foo": [12345, 67890]}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNone(result)
+
+    def test_accepts_string_wrong(self):
+        """
+        Validates that it can accept a string
+        """
+        expected = {self.sentry_unit: {"foo": 3}}
+        actual = {self.sentry_unit: {"foo": [12345, 67890]}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNotNone(result)
+
+    def test_accepts_bool(self):
+        """
+        Validates that it can accept a boolean
+        """
+        expected = {self.sentry_unit: {"foo": True}}
+        actual = {self.sentry_unit: {"foo": [12345, 67890]}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNone(result)
+
+    def test_accepts_bool_wrong(self):
+        """
+        Validates that it can accept a boolean
+        """
+        expected = {self.sentry_unit: {"foo": True}}
+        actual = {self.sentry_unit: {"foo": []}}
+        result = self.utils.validate_unit_process_ids(expected, actual)
+        self.assertIsNotNone(result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ansible/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ansible/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ansible/test_ansible.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ansible/test_ansible.py
new file mode 100644
index 0000000000000000000000000000000000000000..5261da25c767d07d557ecd587dd4402c63ed0b65
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ansible/test_ansible.py
@@ -0,0 +1,339 @@
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import mock
+import os
+import shutil
+import stat
+import tempfile
+import unittest
+import yaml
+
+
+import charmhelpers.contrib.ansible
+from charmhelpers.core import hookenv
+
+
+class InstallAnsibleSupportTestCase(unittest.TestCase):
+
+    def setUp(self):
+        super(InstallAnsibleSupportTestCase, self).setUp()
+
+        patcher = mock.patch('charmhelpers.fetch')
+        self.mock_fetch = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        patcher = mock.patch('charmhelpers.core')
+        self.mock_core = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        hosts_file = tempfile.NamedTemporaryFile()
+        self.ansible_hosts_path = hosts_file.name
+        self.addCleanup(hosts_file.close)
+        patcher = mock.patch.object(charmhelpers.contrib.ansible,
+                                    'ansible_hosts_path',
+                                    self.ansible_hosts_path)
+        patcher.start()
+        self.addCleanup(patcher.stop)
+
+    def test_adds_ppa_by_default(self):
+        charmhelpers.contrib.ansible.install_ansible_support()
+
+        self.mock_fetch.add_source.assert_called_once_with(
+            'ppa:ansible/ansible')
+        self.mock_fetch.apt_update.assert_called_once_with(fatal=True)
+        self.mock_fetch.apt_install.assert_called_once_with(
+            'ansible')
+
+    def test_no_ppa(self):
+        charmhelpers.contrib.ansible.install_ansible_support(
+            from_ppa=False)
+
+        self.assertEqual(self.mock_fetch.add_source.call_count, 0)
+        self.mock_fetch.apt_install.assert_called_once_with(
+            'ansible')
+
+    def test_writes_ansible_hosts(self):
+        with open(self.ansible_hosts_path) as hosts_file:
+            self.assertEqual(hosts_file.read(), '')
+
+        charmhelpers.contrib.ansible.install_ansible_support()
+
+        with open(self.ansible_hosts_path) as hosts_file:
+            self.assertEqual(hosts_file.read(),
+                             'localhost ansible_connection=local '
+                             'ansible_remote_tmp=/root/.ansible/tmp')
+
+
+class ApplyPlaybookTestCases(unittest.TestCase):
+
+    unit_data = {
+        'private-address': '10.0.3.2',
+        'public-address': '123.123.123.123',
+    }
+
+    def setUp(self):
+        super(ApplyPlaybookTestCases, self).setUp()
+
+        # Hookenv patches (a single patch to hookenv doesn't work):
+        patcher = mock.patch('charmhelpers.core.hookenv.config')
+        self.mock_config = patcher.start()
+        self.addCleanup(patcher.stop)
+        Serializable = charmhelpers.core.hookenv.Serializable
+        self.mock_config.return_value = Serializable({})
+        patcher = mock.patch('charmhelpers.core.hookenv.relation_get')
+        self.mock_relation_get = patcher.start()
+        self.mock_relation_get.return_value = {}
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relations')
+        self.mock_relations = patcher.start()
+        self.mock_relations.return_value = {
+            'wsgi-file': {},
+            'website': {},
+            'nrpe-external-master': {},
+        }
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relations_of_type')
+        self.mock_relations_of_type = patcher.start()
+        self.mock_relations_of_type.return_value = []
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relation_type')
+        self.mock_relation_type = patcher.start()
+        self.mock_relation_type.return_value = None
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.local_unit')
+        self.mock_local_unit = patcher.start()
+        self.addCleanup(patcher.stop)
+        self.mock_local_unit.return_value = {}
+
+        def unit_get_data(argument):
+            "dummy unit_get that accesses dummy unit data"
+            return self.unit_data[argument]
+
+        patcher = mock.patch(
+            'charmhelpers.core.hookenv.unit_get', unit_get_data)
+        self.mock_unit_get = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        patcher = mock.patch('charmhelpers.contrib.ansible.subprocess')
+        self.mock_subprocess = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        etc_dir = tempfile.mkdtemp()
+        self.addCleanup(shutil.rmtree, etc_dir)
+        self.vars_path = os.path.join(etc_dir, 'ansible', 'vars.yaml')
+        patcher = mock.patch.object(charmhelpers.contrib.ansible,
+                                    'ansible_vars_path', self.vars_path)
+        patcher.start()
+        self.addCleanup(patcher.stop)
+
+        patcher = mock.patch.object(charmhelpers.contrib.ansible.os,
+                                    'environ', {})
+        patcher.start()
+        self.addCleanup(patcher.stop)
+
+    def test_calls_ansible_playbook(self):
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/dependencies.yaml')
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'playbooks/dependencies.yaml'],
+            env={'PYTHONUNBUFFERED': '1'})
+
+    def test_writes_vars_file(self):
+        self.assertFalse(os.path.exists(self.vars_path))
+        self.mock_config.return_value = charmhelpers.core.hookenv.Serializable({
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+            'private-address': '10.10.10.10',
+        })
+        self.mock_relation_type.return_value = 'wsgi-file'
+        self.mock_relation_get.return_value = {
+            'relation_key1': 'relation_value1',
+            'relation-key2': 'relation_value2',
+        }
+
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/dependencies.yaml')
+
+        self.assertTrue(os.path.exists(self.vars_path))
+        stats = os.stat(self.vars_path)
+        self.assertEqual(
+            stats.st_mode & stat.S_IRWXU,
+            stat.S_IRUSR | stat.S_IWUSR)
+        self.assertEqual(stats.st_mode & stat.S_IRWXG, 0)
+        self.assertEqual(stats.st_mode & stat.S_IRWXO, 0)
+        with open(self.vars_path, 'r') as vars_file:
+            result = yaml.safe_load(vars_file.read())
+            self.assertEqual({
+                "group_code_owner": "webops_deploy",
+                "user_code_runner": "ubunet",
+                "private_address": "10.10.10.10",
+                "charm_dir": "",
+                "local_unit": {},
+                'current_relation': {
+                    'relation_key1': 'relation_value1',
+                    'relation-key2': 'relation_value2',
+                },
+                'relations_full': {
+                    'nrpe-external-master': {},
+                    'website': {},
+                    'wsgi-file': {},
+                },
+                'relations': {
+                    'nrpe-external-master': [],
+                    'website': [],
+                    'wsgi-file': [],
+                },
+                "wsgi_file__relation_key1": "relation_value1",
+                "wsgi_file__relation_key2": "relation_value2",
+                "unit_private_address": "10.0.3.2",
+                "unit_public_address": "123.123.123.123",
+            }, result)
+
+    def test_calls_with_tags(self):
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/complete-state.yaml', tags=['install', 'somethingelse'])
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'playbooks/complete-state.yaml',
+            '--tags', 'install,somethingelse'], env={'PYTHONUNBUFFERED': '1'})
+
+    @mock.patch.object(hookenv, 'config')
+    def test_calls_with_extra_vars(self, config):
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/complete-state.yaml', tags=['install', 'somethingelse'],
+            extra_vars={'a': 'b'})
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'playbooks/complete-state.yaml',
+            '--tags', 'install,somethingelse', '--extra-vars', '{"a": "b"}'],
+            env={'PYTHONUNBUFFERED': '1'})
+
+    @mock.patch.object(hookenv, 'config')
+    def test_calls_with_extra_vars_path(self, config):
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/complete-state.yaml', tags=['install', 'somethingelse'],
+            extra_vars='@myvars.json')
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'playbooks/complete-state.yaml',
+            '--tags', 'install,somethingelse', '--extra-vars', '"@myvars.json"'],
+            env={'PYTHONUNBUFFERED': '1'})
+
+    @mock.patch.object(hookenv, 'config')
+    def test_calls_with_extra_vars_dict(self, config):
+        charmhelpers.contrib.ansible.apply_playbook(
+            'playbooks/complete-state.yaml', tags=['install', 'somethingelse'],
+            extra_vars={'pkg': {'a': 'present', 'b': 'absent'}})
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'playbooks/complete-state.yaml',
+            '--tags', 'install,somethingelse', '--extra-vars',
+            '{"pkg": {"a": "present", "b": "absent"}}'],
+            env={'PYTHONUNBUFFERED': '1'})
+
+    @mock.patch.object(hookenv, 'config')
+    def test_hooks_executes_playbook_with_tag(self, config):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('my/playbook.yaml')
+        foo = mock.MagicMock()
+        hooks.register('foo', foo)
+
+        hooks.execute(['foo'])
+
+        self.assertEqual(foo.call_count, 1)
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'my/playbook.yaml',
+            '--tags', 'foo'], env={'PYTHONUNBUFFERED': '1'})
+
+    @mock.patch.object(hookenv, 'config')
+    def test_specifying_ansible_handled_hooks(self, config):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks(
+            'my/playbook.yaml', default_hooks=['start', 'stop'])
+
+        hooks.execute(['start'])
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'ansible-playbook', '-c', 'local', 'my/playbook.yaml',
+            '--tags', 'start'], env={'PYTHONUNBUFFERED': '1'})
+
+
+class TestActionDecorator(unittest.TestCase):
+
+    def setUp(self):
+        p = mock.patch('charmhelpers.contrib.ansible.apply_playbook')
+        self.apply_playbook = p.start()
+        self.addCleanup(p.stop)
+
+    def test_action_no_args(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test():
+            return {}
+
+        hooks.execute(['test'])
+        self.apply_playbook.assert_called_once_with(
+            'playbook.yaml', tags=['test'], extra_vars={})
+
+    def test_action_required_arg_keyword(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test(x):
+            return locals()
+
+        hooks.execute(['test', 'x=a'])
+        self.apply_playbook.assert_called_once_with(
+            'playbook.yaml', tags=['test'], extra_vars={'x': 'a'})
+
+    def test_action_required_arg_missing(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test(x):
+            """Requires x"""
+            return locals()
+
+        try:
+            hooks.execute(['test'])
+            self.fail("should have thrown TypeError")
+        except TypeError as e:
+            self.assertEqual(e.args[1], "Requires x")
+
+    def test_action_required_unknown_arg(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test(x='a'):
+            """Requires x"""
+            return locals()
+
+        try:
+            hooks.execute(['test', 'z=c'])
+            self.fail("should have thrown TypeError")
+        except TypeError as e:
+            self.assertEqual(e.args[1], "Requires x")
+
+    def test_action_default_arg(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test(x='b'):
+            return locals()
+
+        hooks.execute(['test'])
+        self.apply_playbook.assert_called_once_with(
+            'playbook.yaml', tags=['test'], extra_vars={'x': 'b'})
+
+    def test_action_mutliple(self):
+        hooks = charmhelpers.contrib.ansible.AnsibleHooks('playbook.yaml')
+
+        @hooks.action()
+        def test(x, y='b'):
+            return locals()
+
+        hooks.execute(['test', 'x=a', 'y=b'])
+        self.apply_playbook.assert_called_once_with(
+            'playbook.yaml', tags=['test'], extra_vars={'x': 'a', 'y': 'b'})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/benchmark/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/benchmark/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/benchmark/test_benchmark.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/benchmark/test_benchmark.py
new file mode 100644
index 0000000000000000000000000000000000000000..52ec086271f02e7538e69a9b272a35afe8e243c8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/benchmark/test_benchmark.py
@@ -0,0 +1,124 @@
+from functools import partial
+from os.path import join
+from tempfile import mkdtemp
+from shutil import rmtree
+
+import mock
+from testtools import TestCase
+# import unittest
+from charmhelpers.contrib.benchmark import Benchmark, action_set  # noqa
+from tests.helpers import patch_open, FakeRelation
+
+TO_PATCH = [
+    'in_relation_hook',
+    'relation_ids',
+    'relation_set',
+    'relation_get',
+]
+
+FAKE_RELATION = {
+    'benchmark:0': {
+        'benchmark/0': {
+            'hostname': '127.0.0.1',
+            'port': '1111',
+            'graphite_port': '2222',
+            'graphite_endpoint': 'http://localhost:3333',
+            'api_port': '4444'
+        }
+    }
+}
+
+
+class TestBenchmark(TestCase):
+
+    def setUp(self):
+        super(TestBenchmark, self).setUp()
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+        self.fake_relation = FakeRelation(FAKE_RELATION)
+        # self.hook_name.return_value = 'benchmark-relation-changed'
+
+        self.relation_get.side_effect = partial(
+            self.fake_relation.get, rid="benchmark:0", unit="benchmark/0")
+        self.relation_ids.side_effect = self.fake_relation.relation_ids
+
+    def _patch(self, method):
+        _m = mock.patch('charmhelpers.contrib.benchmark.' + method)
+        m = _m.start()
+        self.addCleanup(_m.stop)
+        return m
+
+    @mock.patch('os.path.exists')
+    @mock.patch('subprocess.check_output')
+    def test_benchmark_start(self, check_output, exists):
+
+        exists.return_value = True
+        check_output.return_value = "data"
+
+        with patch_open() as (_open, _file):
+            self.assertIsNone(Benchmark.start())
+            # _open.assert_called_with('/etc/benchmark.conf', 'w')
+
+        COLLECT_PROFILE_DATA = '/usr/local/bin/collect-profile-data'
+        exists.assert_any_call(COLLECT_PROFILE_DATA)
+        check_output.assert_any_call([COLLECT_PROFILE_DATA])
+
+    def test_benchmark_finish(self):
+        with patch_open() as (_open, _file):
+            self.assertIsNone(Benchmark.finish())
+            # _open.assert_called_with('/etc/benchmark.conf', 'w')
+
+    @mock.patch('charmhelpers.contrib.benchmark.action_set')
+    def test_benchmark_set_composite_score(self, action_set):
+        self.assertTrue(Benchmark.set_composite_score(15.7, 'hits/sec', 'desc'))
+        action_set.assert_called_once_with('meta.composite', {'value': 15.7, 'units': 'hits/sec', 'direction': 'desc'})
+
+    @mock.patch('charmhelpers.contrib.benchmark.find_executable')
+    @mock.patch('charmhelpers.contrib.benchmark.subprocess.check_call')
+    def test_benchmark_action_set(self, check_call, find_executable):
+        find_executable.return_value = "/usr/bin/action-set"
+        self.assertTrue(action_set('foo', 'bar'))
+
+        find_executable.assert_called_once_with('action-set')
+        check_call.assert_called_once_with(['action-set', 'foo=bar'])
+
+    @mock.patch('charmhelpers.contrib.benchmark.find_executable')
+    @mock.patch('charmhelpers.contrib.benchmark.subprocess.check_call')
+    def test_benchmark_action_set_dict(self, check_call, find_executable):
+        find_executable.return_value = "/usr/bin/action-set"
+        self.assertTrue(action_set('baz', {'foo': 1, 'bar': 2}))
+
+        find_executable.assert_called_with('action-set')
+
+        check_call.assert_any_call(['action-set', 'baz.foo=1'])
+        check_call.assert_any_call(['action-set', 'baz.bar=2'])
+
+    @mock.patch('charmhelpers.contrib.benchmark.relation_ids')
+    @mock.patch('charmhelpers.contrib.benchmark.in_relation_hook')
+    def test_benchmark_init(self, in_relation_hook, relation_ids):
+
+        in_relation_hook.return_value = True
+        relation_ids.return_value = ['benchmark:0']
+        actions = ['asdf', 'foobar']
+
+        tempdir = mkdtemp(prefix=self.__class__.__name__)
+        self.addCleanup(rmtree, tempdir)
+        conf_path = join(tempdir, "benchmark.conf")
+        with mock.patch.object(Benchmark, "BENCHMARK_CONF", conf_path):
+            b = Benchmark(actions)
+
+            self.assertIsInstance(b, Benchmark)
+
+            self.assertTrue(self.relation_get.called)
+            self.assertTrue(self.relation_set.called)
+
+            relation_ids.assert_called_once_with('benchmark')
+
+            self.relation_set.assert_called_once_with(
+                relation_id='benchmark:0',
+                relation_settings={'benchmarks': ",".join(actions)}
+            )
+
+            conf_contents = open(conf_path).readlines()
+            for key, val in iter(FAKE_RELATION['benchmark:0']['benchmark/0'].items()):
+                self.assertIn("%s=%s\n" % (key, val), conf_contents)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmhelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmhelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmhelpers/test_charmhelpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmhelpers/test_charmhelpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..2837d2b9a49730d509def4943874928b88bec74b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmhelpers/test_charmhelpers.py
@@ -0,0 +1,274 @@
+# Tests for Python charm helpers.
+
+import unittest
+import yaml
+from testtools import TestCase
+
+from six import StringIO
+
+import sys
+# Path hack to ensure we test the local code, not a version installed in
+# /usr/local/lib.  This is necessary since /usr/local/lib is prepended before
+# what is specified in PYTHONPATH.
+sys.path.insert(0, 'helpers/python')
+from charmhelpers.contrib import charmhelpers  # noqa
+
+
+class CharmHelpersTestCase(TestCase):
+    """A basic test case for Python charm helpers."""
+
+    def _patch_command(self, replacement_command):
+        """Monkeypatch charmhelpers.command for testing purposes.
+
+        :param replacement_command: The replacement Callable for
+                                    command().
+        """
+        self.patch(charmhelpers, 'command', lambda *args: replacement_command)
+
+    def _make_juju_status_dict(self, num_units=1,
+                               service_name='test-service',
+                               unit_state='pending',
+                               machine_state='not-started'):
+        """Generate valid juju status dict and return it."""
+        machine_data = {}
+        # The 0th machine is the Zookeeper.
+        machine_data[0] = {'dns-name': 'zookeeper.example.com',
+                           'instance-id': 'machine0',
+                           'state': 'not-started'}
+        service_data = {'charm': 'local:precise/{}-1'.format(service_name),
+                        'relations': {},
+                        'units': {}}
+        for i in range(num_units):
+            # The machine is always going to be i+1 because there
+            # will always be num_units+1 machines.
+            machine_number = i + 1
+            unit_machine_data = {
+                'dns-name': 'machine{}.example.com'.format(machine_number),
+                'instance-id': 'machine{}'.format(machine_number),
+                'state': machine_state,
+                'instance-state': machine_state}
+            machine_data[machine_number] = unit_machine_data
+            unit_data = {
+                'machine': machine_number,
+                'public-address':
+                '{}-{}.example.com'.format(service_name, i),
+                'relations': {'db': {'state': 'up'}},
+                'agent-state': unit_state}
+            service_data['units']['{}/{}'.format(service_name, i)] = (
+                unit_data)
+        juju_status_data = {'machines': machine_data,
+                            'services': {service_name: service_data}}
+        return juju_status_data
+
+    def _make_juju_status_yaml(self, num_units=1,
+                               service_name='test-service',
+                               unit_state='pending',
+                               machine_state='not-started'):
+        """Convert the dict returned by `_make_juju_status_dict` to YAML."""
+        return yaml.dump(
+            self._make_juju_status_dict(
+                num_units, service_name, unit_state, machine_state))
+
+    def test_make_charm_config_file(self):
+        # make_charm_config_file() writes the passed configuration to a
+        # temporary file as YAML.
+        charm_config = {'foo': 'bar',
+                        'spam': 'eggs',
+                        'ham': 'jam'}
+        # make_charm_config_file() returns the file object so that it
+        # can be garbage collected properly.
+        charm_config_file = charmhelpers.make_charm_config_file(charm_config)
+        with open(charm_config_file.name) as config_in:
+            written_config = config_in.read()
+        self.assertEqual(yaml.dump(charm_config), written_config)
+
+    def test_unit_info(self):
+        # unit_info returns requested data about a given service.
+        juju_yaml = self._make_juju_status_yaml()
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertEqual(
+            'pending',
+            charmhelpers.unit_info('test-service', 'agent-state'))
+
+    def test_unit_info_returns_empty_for_nonexistent_service(self):
+        # If the service passed to unit_info() has not yet started (or
+        # otherwise doesn't exist), unit_info() will return an empty
+        # string.
+        juju_yaml = "services: {}"
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertEqual(
+            '', charmhelpers.unit_info('test-service', 'state'))
+
+    def test_unit_info_accepts_data(self):
+        # It's possible to pass a `data` dict, containing the parsed
+        # result of juju status, to unit_info().
+        juju_status_data = yaml.safe_load(
+            self._make_juju_status_yaml())
+        self.patch(charmhelpers, 'juju_status', lambda: None)
+        service_data = juju_status_data['services']['test-service']
+        unit_info_dict = service_data['units']['test-service/0']
+        for key, value in unit_info_dict.items():
+            item_info = charmhelpers.unit_info(
+                'test-service', key, data=juju_status_data)
+            self.assertEqual(value, item_info)
+
+    def test_unit_info_returns_first_unit_by_default(self):
+        # By default, unit_info() just returns the value of the
+        # requested item for the first unit in a service.
+        juju_yaml = self._make_juju_status_yaml(num_units=2)
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        unit_address = charmhelpers.unit_info(
+            'test-service', 'public-address')
+        self.assertEqual('test-service-0.example.com', unit_address)
+
+    def test_unit_info_accepts_unit_name(self):
+        # By default, unit_info() just returns the value of the
+        # requested item for the first unit in a service. However, it's
+        # possible to pass a unit name to it, too.
+        juju_yaml = self._make_juju_status_yaml(num_units=2)
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        unit_address = charmhelpers.unit_info(
+            'test-service', 'public-address', unit='test-service/1')
+        self.assertEqual('test-service-1.example.com', unit_address)
+
+    def test_get_machine_data(self):
+        # get_machine_data() returns a dict containing the machine data
+        # parsed from juju status.
+        juju_yaml = self._make_juju_status_yaml()
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        machine_0_data = charmhelpers.get_machine_data()[0]
+        self.assertEqual('zookeeper.example.com', machine_0_data['dns-name'])
+
+    def test_wait_for_machine_returns_if_machine_up(self):
+        # If wait_for_machine() is called and the machine(s) it is
+        # waiting for are already up, it will return.
+        juju_yaml = self._make_juju_status_yaml(machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        machines, time_taken = charmhelpers.wait_for_machine(timeout=1)
+        self.assertEqual(1, machines)
+
+    def test_wait_for_machine_times_out(self):
+        # If the machine that wait_for_machine is waiting for isn't
+        # 'running' before the passed timeout is reached,
+        # wait_for_machine will raise an error.
+        juju_yaml = self._make_juju_status_yaml()
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertRaises(
+            RuntimeError, charmhelpers.wait_for_machine, timeout=0)
+
+    def test_wait_for_machine_always_returns_if_running_locally(self):
+        # If juju is actually running against a local LXC container,
+        # wait_for_machine will always return.
+        juju_status_dict = self._make_juju_status_dict()
+        # We'll update the 0th machine to make it look like it's an LXC
+        # container.
+        juju_status_dict['machines'][0]['dns-name'] = 'localhost'
+        juju_yaml = yaml.dump(juju_status_dict)
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        machines, time_taken = charmhelpers.wait_for_machine(timeout=1)
+        # wait_for_machine will always return 1 machine started here,
+        # since there's only one machine to start.
+        self.assertEqual(1, machines)
+        # time_taken will be 0, since no actual waiting happened.
+        self.assertEqual(0, time_taken)
+
+    def test_wait_for_machine_waits_for_multiple_machines(self):
+        # wait_for_machine can be told to wait for multiple machines.
+        juju_yaml = self._make_juju_status_yaml(
+            num_units=2, machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        machines, time_taken = charmhelpers.wait_for_machine(num_machines=2)
+        self.assertEqual(2, machines)
+
+    def test_wait_for_unit_returns_if_unit_started(self):
+        # wait_for_unit() will return if the service it's waiting for is
+        # already up.
+        juju_yaml = self._make_juju_status_yaml(
+            unit_state='started', machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        charmhelpers.wait_for_unit('test-service', timeout=0)
+
+    def test_wait_for_unit_raises_error_on_error_state(self):
+        # If the unit is in some kind of error state, wait_for_unit will
+        # raise a RuntimeError.
+        juju_yaml = self._make_juju_status_yaml(
+            unit_state='start-error', machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertRaises(RuntimeError, charmhelpers.wait_for_unit,
+                          'test-service', timeout=0)
+
+    def test_wait_for_unit_raises_error_on_timeout(self):
+        # If the unit does not start before the timeout is reached,
+        # wait_for_unit will raise a RuntimeError.
+        juju_yaml = self._make_juju_status_yaml(
+            unit_state='pending', machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertRaises(RuntimeError, charmhelpers.wait_for_unit,
+                          'test-service', timeout=0)
+
+    def test_wait_for_relation_returns_if_relation_up(self):
+        # wait_for_relation() waits for relations to come up. If a
+        # relation is already 'up', wait_for_relation() will return
+        # immediately.
+        juju_yaml = self._make_juju_status_yaml(
+            unit_state='started', machine_state='running')
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        charmhelpers.wait_for_relation('test-service', 'db', timeout=0)
+
+    def test_wait_for_relation_times_out_if_relation_not_present(self):
+        # If a relation does not exist at all before a timeout is
+        # reached, wait_for_relation() will raise a RuntimeError.
+        juju_dict = self._make_juju_status_dict(
+            unit_state='started', machine_state='running')
+        units = juju_dict['services']['test-service']['units']
+        # We'll remove all the relations for test-service for this test.
+        units['test-service/0']['relations'] = {}
+        juju_dict['services']['test-service']['units'] = units
+        juju_yaml = yaml.dump(juju_dict)
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertRaises(
+            RuntimeError, charmhelpers.wait_for_relation, 'test-service',
+            'db', timeout=0)
+
+    def test_wait_for_relation_times_out_if_relation_not_up(self):
+        # If a relation does not transition to an 'up' state, before a
+        # timeout is reached, wait_for_relation() will raise a
+        # RuntimeError.
+        juju_dict = self._make_juju_status_dict(
+            unit_state='started', machine_state='running')
+        units = juju_dict['services']['test-service']['units']
+        units['test-service/0']['relations']['db']['state'] = 'down'
+        juju_dict['services']['test-service']['units'] = units
+        juju_yaml = yaml.dump(juju_dict)
+        self.patch(charmhelpers, 'juju_status', lambda: juju_yaml)
+        self.assertRaises(
+            RuntimeError, charmhelpers.wait_for_relation, 'test-service',
+            'db', timeout=0)
+
+    def test_wait_for_page_contents_returns_if_contents_available(self):
+        # wait_for_page_contents() will wait until a given string is
+        # contained within the results of a given url and will return
+        # once it does.
+        # We need to patch the charmhelpers instance of urlopen so that
+        # it doesn't try to connect out.
+        test_content = "Hello, world."
+        self.patch(charmhelpers, 'urlopen',
+                   lambda *args: StringIO(test_content))
+        charmhelpers.wait_for_page_contents(
+            'http://example.com', test_content, timeout=0)
+
+    def test_wait_for_page_contents_times_out(self):
+        # If the desired contents do not appear within the page before
+        # the specified timeout, wait_for_page_contents() will raise a
+        # RuntimeError.
+        # We need to patch the charmhelpers instance of urlopen so that
+        # it doesn't try to connect out.
+        self.patch(charmhelpers, 'urlopen',
+                   lambda *args: StringIO("This won't work."))
+        self.assertRaises(
+            RuntimeError, charmhelpers.wait_for_page_contents,
+            'http://example.com', "This will error", timeout=0)
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmsupport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmsupport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmsupport/test_nrpe.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmsupport/test_nrpe.py
new file mode 100644
index 0000000000000000000000000000000000000000..454c62176f5fe0a772c0d73cc44061592aad56e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/charmsupport/test_nrpe.py
@@ -0,0 +1,419 @@
+import os
+import yaml
+import subprocess
+
+from testtools import TestCase
+from mock import patch, call, MagicMock
+
+from charmhelpers.contrib.charmsupport import nrpe
+from charmhelpers.core import host
+
+
+class NRPEBaseTestCase(TestCase):
+    patches = {
+        'config': {'object': nrpe},
+        'copy2': {'object': nrpe.shutil},
+        'log': {'object': nrpe},
+        'getpwnam': {'object': nrpe.pwd},
+        'getgrnam': {'object': nrpe.grp},
+        'glob': {'object': nrpe.glob},
+        'mkdir': {'object': os},
+        'chown': {'object': os},
+        'chmod': {'object': os},
+        'exists': {'object': os.path},
+        'listdir': {'object': os},
+        'remove': {'object': os},
+        'open': {'object': nrpe, 'create': True},
+        'isfile': {'object': os.path},
+        'isdir': {'object': os.path},
+        'call': {'object': subprocess},
+        'relation_get': {'object': nrpe},
+        'relation_ids': {'object': nrpe},
+        'relation_set': {'object': nrpe},
+        'relations_of_type': {'object': nrpe},
+        'service': {'object': nrpe},
+        'init_is_systemd': {'object': host},
+    }
+
+    def setUp(self):
+        super(NRPEBaseTestCase, self).setUp()
+        self.patched = {}
+        # Mock the universe.
+        for attr, data in self.patches.items():
+            create = data.get('create', False)
+            patcher = patch.object(data['object'], attr, create=create)
+            self.patched[attr] = patcher.start()
+            self.addCleanup(patcher.stop)
+        env_patcher = patch.dict('os.environ',
+                                 {'JUJU_UNIT_NAME': 'testunit',
+                                  'CHARM_DIR': '/usr/lib/test_charm_dir'})
+        env_patcher.start()
+        self.addCleanup(env_patcher.stop)
+
+    def check_call_counts(self, **kwargs):
+        for attr, expected in kwargs.items():
+            patcher = self.patched[attr]
+            self.assertEqual(expected, patcher.call_count, attr)
+
+
+class NRPETestCase(NRPEBaseTestCase):
+
+    def test_init_gets_config(self):
+        self.patched['config'].return_value = {'nagios_context': 'testctx',
+                                               'nagios_servicegroups': 'testsgrps'}
+
+        checker = nrpe.NRPE()
+
+        self.assertEqual('testctx', checker.nagios_context)
+        self.assertEqual('testsgrps', checker.nagios_servicegroups)
+        self.assertEqual('testunit', checker.unit_name)
+        self.assertEqual('testctx-testunit', checker.hostname)
+        self.check_call_counts(config=1)
+
+    def test_init_hostname(self):
+        """Test that the hostname parameter is correctly set"""
+        checker = nrpe.NRPE()
+        self.assertEqual(checker.hostname,
+                         "{}-{}".format(checker.nagios_context,
+                                        checker.unit_name))
+        hostname = "test.host"
+        checker = nrpe.NRPE(hostname=hostname)
+        self.assertEqual(checker.hostname, hostname)
+
+    def test_default_servicegroup(self):
+        """Test that nagios_servicegroups gets set to the default if omitted"""
+        self.patched['config'].return_value = {'nagios_context': 'testctx'}
+        checker = nrpe.NRPE()
+        self.assertEqual(checker.nagios_servicegroups, 'testctx')
+
+    def test_no_nagios_installed_bails(self):
+        self.patched['config'].return_value = {'nagios_context': 'test',
+                                               'nagios_servicegroups': ''}
+        self.patched['getgrnam'].side_effect = KeyError
+        checker = nrpe.NRPE()
+
+        self.assertEqual(None, checker.write())
+
+        expected = 'Nagios user not set up, nrpe checks not updated'
+        self.patched['log'].assert_called_with(expected)
+        self.check_call_counts(log=2, config=1, getpwnam=1, getgrnam=1)
+
+    def test_write_no_checker(self):
+        self.patched['config'].return_value = {'nagios_context': 'test',
+                                               'nagios_servicegroups': ''}
+        self.patched['exists'].return_value = True
+        checker = nrpe.NRPE()
+
+        self.assertEqual(None, checker.write())
+
+        self.check_call_counts(config=1, getpwnam=1, getgrnam=1, exists=1)
+
+    def test_write_restarts_service(self):
+        self.patched['config'].return_value = {'nagios_context': 'test',
+                                               'nagios_servicegroups': ''}
+        self.patched['exists'].return_value = True
+        checker = nrpe.NRPE()
+
+        self.assertEqual(None, checker.write())
+
+        self.patched['service'].assert_called_with('restart', 'nagios-nrpe-server')
+        self.check_call_counts(config=1, getpwnam=1, getgrnam=1,
+                               exists=1, service=1)
+
+    def test_update_nrpe(self):
+        self.patched['config'].return_value = {'nagios_context': 'a',
+                                               'nagios_servicegroups': ''}
+        self.patched['exists'].return_value = True
+        self.patched['relation_get'].return_value = {
+            'egress-subnets': '10.66.111.24/32',
+            'ingress-address': '10.66.111.24',
+            'private-address': '10.66.111.24'
+        }
+
+        def _rels(rname):
+            relations = {
+                'local-monitors': 'local-monitors:1',
+                'nrpe-external-master': 'nrpe-external-master:2',
+            }
+            return [relations[rname]]
+        self.patched['relation_ids'].side_effect = _rels
+
+        checker = nrpe.NRPE()
+        checker.add_check(shortname="myservice",
+                          description="Check MyService",
+                          check_cmd="check_http http://localhost")
+
+        self.assertEqual(None, checker.write())
+
+        self.assertEqual(2, self.patched['open'].call_count)
+        filename = 'check_myservice.cfg'
+        expected = [
+            ('/etc/nagios/nrpe.d/%s' % filename, 'w'),
+            ('/var/lib/nagios/export/service__a-testunit_%s' % filename, 'w'),
+        ]
+        actual = [x[0] for x in self.patched['open'].call_args_list]
+        self.assertEqual(expected, actual)
+        outfile = self.patched['open'].return_value.__enter__.return_value
+        service_file_contents = """
+#---------------------------------------------------
+# This file is Juju managed
+#---------------------------------------------------
+define service {
+    use                             active-service
+    host_name                       a-testunit
+    service_description             a-testunit[myservice] Check MyService
+    check_command                   check_nrpe!check_myservice
+    servicegroups                   a
+}
+"""
+        expected = [
+            '# check myservice\n',
+            '# The following header was added automatically by juju\n',
+            '# Modifying it will affect nagios monitoring and alerting\n',
+            '# servicegroups: a\n',
+            'command[check_myservice]=/usr/lib/nagios/plugins/check_http http://localhost\n',
+            service_file_contents,
+        ]
+        actual = [x[0][0] for x in outfile.write.call_args_list]
+        self.assertEqual(expected, actual)
+
+        nrpe_monitors = {'myservice':
+                         {'command': 'check_myservice'}}
+        monitors = yaml.dump(
+            {"monitors": {"remote": {"nrpe": nrpe_monitors}}})
+        relation_set_calls = [
+            call(monitors=monitors, relation_id="local-monitors:1"),
+            call(monitors=monitors, relation_id="nrpe-external-master:2"),
+        ]
+        self.patched['relation_set'].assert_has_calls(relation_set_calls, any_order=True)
+        self.check_call_counts(config=1, getpwnam=1, getgrnam=1,
+                               exists=4, open=2, listdir=1, relation_get=2,
+                               relation_ids=3, relation_set=3)
+
+
+class NRPECheckTestCase(NRPEBaseTestCase):
+
+    def test_invalid_shortname(self):
+        cases = [
+            'invalid:name',
+            '',
+        ]
+        for shortname in cases:
+            self.assertRaises(nrpe.CheckException, nrpe.Check, shortname,
+                              'description', '/some/command')
+
+    def test_valid_shortname(self):
+        cases = [
+            '1_number_is_fine',
+            'dots.are.good',
+            'dashes-ok',
+            'UPPER_case_allowed',
+            '5',
+            '@valid',
+        ]
+        for shortname in cases:
+            check = nrpe.Check(shortname, 'description', '/some/command')
+            self.assertEqual(shortname, check.shortname)
+
+    def test_write_removes_existing_config(self):
+        self.patched['listdir'].return_value = [
+            'foo', 'bar.cfg', '_check_shortname.cfg']
+        check = nrpe.Check('shortname', 'description', '/some/command')
+
+        self.assertEqual(None, check.write('testctx', 'hostname', 'testsgrp'))
+
+        expected = '/var/lib/nagios/export/_check_shortname.cfg'
+        self.patched['remove'].assert_called_once_with(expected)
+        self.check_call_counts(exists=3, remove=1, open=2, listdir=1)
+
+    def test_check_write_nrpe_exportdir_not_accessible(self):
+        self.patched['exists'].return_value = False
+        check = nrpe.Check('shortname', 'description', '/some/command')
+
+        self.assertEqual(None, check.write('testctx', 'hostname', 'testsgrps'))
+        expected = ('Not writing service config as '
+                    '/var/lib/nagios/export is not accessible')
+        self.patched['log'].assert_has_calls(
+            [call(expected)], any_order=True)
+        self.check_call_counts(log=2, open=1)
+
+    def test_locate_cmd_no_args(self):
+        self.patched['exists'].return_value = True
+
+        check = nrpe.Check('shortname', 'description', '/bin/ls')
+
+        self.assertEqual('/bin/ls', check.check_cmd)
+
+    def test_locate_cmd_not_found(self):
+        self.patched['exists'].return_value = False
+        check = nrpe.Check('shortname', 'description', 'check_http -x -y -z')
+
+        self.assertEqual('', check.check_cmd)
+        self.assertEqual(2, self.patched['exists'].call_count)
+        expected = [
+            '/usr/lib/nagios/plugins/check_http',
+            '/usr/local/lib/nagios/plugins/check_http',
+        ]
+        actual = [x[0][0] for x in self.patched['exists'].call_args_list]
+        self.assertEqual(expected, actual)
+        self.check_call_counts(exists=2, log=1)
+        expected = 'Check command not found: check_http'
+        self.assertEqual(expected, self.patched['log'].call_args[0][0])
+
+    def test_run(self):
+        self.patched['exists'].return_value = True
+        command = '/usr/bin/wget foo'
+        check = nrpe.Check('shortname', 'description', command)
+
+        self.assertEqual(None, check.run())
+
+        self.check_call_counts(exists=1, call=1)
+        self.assertEqual(command, self.patched['call'].call_args[0][0])
+
+
+class NRPEMiscTestCase(NRPEBaseTestCase):
+    def test_get_nagios_hostcontext(self):
+        rel_info = {
+            'nagios_hostname': 'bob-openstack-dashboard-0',
+            'private-address': '10.5.3.103',
+            '__unit__': u'dashboard-nrpe/1',
+            '__relid__': u'nrpe-external-master:2',
+            'nagios_host_context': u'bob',
+        }
+        self.patched['relations_of_type'].return_value = [rel_info]
+        self.assertEqual(nrpe.get_nagios_hostcontext(), 'bob')
+
+    def test_get_nagios_hostname(self):
+        rel_info = {
+            'nagios_hostname': 'bob-openstack-dashboard-0',
+            'private-address': '10.5.3.103',
+            '__unit__': u'dashboard-nrpe/1',
+            '__relid__': u'nrpe-external-master:2',
+            'nagios_host_context': u'bob',
+        }
+        self.patched['relations_of_type'].return_value = [rel_info]
+        self.assertEqual(nrpe.get_nagios_hostname(), 'bob-openstack-dashboard-0')
+
+    def test_get_nagios_unit_name(self):
+        rel_info = {
+            'nagios_hostname': 'bob-openstack-dashboard-0',
+            'private-address': '10.5.3.103',
+            '__unit__': u'dashboard-nrpe/1',
+            '__relid__': u'nrpe-external-master:2',
+            'nagios_host_context': u'bob',
+        }
+        self.patched['relations_of_type'].return_value = [rel_info]
+        self.assertEqual(nrpe.get_nagios_unit_name(), 'bob:testunit')
+
+    def test_get_nagios_unit_name_no_hc(self):
+        self.patched['relations_of_type'].return_value = []
+        self.assertEqual(nrpe.get_nagios_unit_name(), 'testunit')
+
+    @patch.object(os.path, 'isdir')
+    def test_add_init_service_checks(self, mock_isdir):
+        def _exists(init_file):
+            files = ['/etc/init/apache2.conf',
+                     '/usr/lib/nagios/plugins/check_upstart_job',
+                     '/etc/init.d/haproxy',
+                     '/usr/lib/nagios/plugins/check_status_file.py',
+                     '/etc/cron.d/nagios-service-check-haproxy',
+                     '/var/lib/nagios/service-check-haproxy.txt',
+                     '/usr/lib/nagios/plugins/check_systemd.py'
+                     ]
+            return init_file in files
+
+        self.patched['exists'].side_effect = _exists
+
+        # Test without systemd and /var/lib/nagios does not exist
+        self.patched['init_is_systemd'].return_value = False
+        mock_isdir.return_value = False
+        bill = nrpe.NRPE()
+        services = ['apache2', 'haproxy']
+        nrpe.add_init_service_checks(bill, services, 'testunit')
+        mock_isdir.assert_called_with('/var/lib/nagios')
+        self.patched['call'].assert_not_called()
+        expect_cmds = {
+            'apache2': '/usr/lib/nagios/plugins/check_upstart_job apache2',
+            'haproxy': '/usr/lib/nagios/plugins/check_status_file.py -f '
+                       '/var/lib/nagios/service-check-haproxy.txt',
+        }
+        self.assertEqual(bill.checks[0].shortname, 'apache2')
+        self.assertEqual(bill.checks[0].check_cmd, expect_cmds['apache2'])
+        self.assertEqual(bill.checks[1].shortname, 'haproxy')
+        self.assertEqual(bill.checks[1].check_cmd, expect_cmds['haproxy'])
+
+        # without systemd and /var/lib/nagios does exist
+        mock_isdir.return_value = True
+        f = MagicMock()
+        self.patched['open'].return_value = f
+        bill = nrpe.NRPE()
+        services = ['apache2', 'haproxy']
+        nrpe.add_init_service_checks(bill, services, 'testunit')
+        mock_isdir.assert_called_with('/var/lib/nagios')
+        self.patched['call'].assert_called_with(
+            ['/usr/local/lib/nagios/plugins/check_exit_status.pl', '-e', '-s',
+             '/etc/init.d/haproxy', 'status'], stdout=f,
+            stderr=subprocess.STDOUT)
+
+        # Test regular services and snap services with systemd
+        services = ['apache2', 'haproxy', 'snap.test.test',
+                    'ceph-radosgw@hostname']
+        self.patched['init_is_systemd'].return_value = True
+        nrpe.add_init_service_checks(bill, services, 'testunit')
+        expect_cmds = {
+            'apache2': '/usr/lib/nagios/plugins/check_systemd.py apache2',
+            'haproxy': '/usr/lib/nagios/plugins/check_systemd.py haproxy',
+            'snap.test.test': '/usr/lib/nagios/plugins/check_systemd.py snap.test.test',
+        }
+        self.assertEqual(bill.checks[2].shortname, 'apache2')
+        self.assertEqual(bill.checks[2].check_cmd, expect_cmds['apache2'])
+        self.assertEqual(bill.checks[3].shortname, 'haproxy')
+        self.assertEqual(bill.checks[3].check_cmd, expect_cmds['haproxy'])
+        self.assertEqual(bill.checks[4].shortname, 'snap.test.test')
+        self.assertEqual(bill.checks[4].check_cmd, expect_cmds['snap.test.test'])
+
+    def test_copy_nrpe_checks(self):
+        file_presence = {
+            'filea': True,
+            'fileb': False}
+        self.patched['exists'].return_value = True
+        self.patched['glob'].return_value = ['filea', 'fileb']
+        self.patched['isdir'].side_effect = [False, True]
+        self.patched['isfile'].side_effect = lambda x: file_presence[x]
+        nrpe.copy_nrpe_checks()
+        self.patched['glob'].assert_called_once_with(
+            ('/usr/lib/test_charm_dir/hooks/charmhelpers/contrib/openstack/'
+             'files/check_*'))
+        self.patched['copy2'].assert_called_once_with(
+            'filea',
+            '/usr/local/lib/nagios/plugins/filea')
+
+    def test_copy_nrpe_checks_other_root(self):
+        file_presence = {
+            'filea': True,
+            'fileb': False}
+        self.patched['exists'].return_value = True
+        self.patched['glob'].return_value = ['filea', 'fileb']
+        self.patched['isdir'].side_effect = [True, False]
+        self.patched['isfile'].side_effect = lambda x: file_presence[x]
+        nrpe.copy_nrpe_checks()
+        self.patched['glob'].assert_called_once_with(
+            ('/usr/lib/test_charm_dir/charmhelpers/contrib/openstack/'
+             'files/check_*'))
+        self.patched['copy2'].assert_called_once_with(
+            'filea',
+            '/usr/local/lib/nagios/plugins/filea')
+
+    def test_copy_nrpe_checks_nrpe_files_dir(self):
+        file_presence = {
+            'filea': True,
+            'fileb': False}
+        self.patched['exists'].return_value = True
+        self.patched['glob'].return_value = ['filea', 'fileb']
+        self.patched['isfile'].side_effect = lambda x: file_presence[x]
+        nrpe.copy_nrpe_checks(nrpe_files_dir='/other/dir')
+        self.patched['glob'].assert_called_once_with(
+            '/other/dir/check_*')
+        self.patched['copy2'].assert_called_once_with(
+            'filea',
+            '/usr/local/lib/nagios/plugins/filea')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/README b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/README
new file mode 100644
index 0000000000000000000000000000000000000000..c58240383d6d1cc6fc1c8388882e50d529804fc8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/README
@@ -0,0 +1,7 @@
+The Mysql test is not enabled. In order to enable it, touch __init__.py.
+
+As it currently stands, the test has poor coverage and fails under python3.
+These things should be addressed before re-enabling the test.
+
+Adam Israel <adam.israel@canonical.com>
+March 17, 2015
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/test_mysql.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/test_mysql.py
new file mode 100644
index 0000000000000000000000000000000000000000..c449fc481f1a76b5da9090288a64d1df8eb5b259
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/database/test_mysql.py
@@ -0,0 +1,909 @@
+import os
+import mock
+import json
+import unittest
+import sys
+import shutil
+import tempfile
+
+from collections import OrderedDict
+
+sys.modules['MySQLdb'] = mock.Mock()
+from charmhelpers.contrib.database import mysql  # noqa
+
+
+class MysqlTests(unittest.TestCase):
+    def setUp(self):
+        super(MysqlTests, self).setUp()
+
+    def test_connect_host_defined(self):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        with mock.patch.object(mysql, 'log'):
+            helper.connect(user='user', password='password', host='1.1.1.1')
+        mysql.MySQLdb.connect.assert_called_with(
+            passwd='password', host='1.1.1.1', user='user')
+
+    def test_connect_host_not_defined(self):
+        helper = mysql.MySQLHelper('foo', 'bar')
+        with mock.patch.object(mysql, 'log'):
+            helper.connect(user='user', password='password')
+        mysql.MySQLdb.connect.assert_called_with(
+            passwd='password', host='localhost', user='user')
+
+    def test_connect_port_defined(self):
+        helper = mysql.MySQLHelper('foo', 'bar')
+        with mock.patch.object(mysql, 'log'):
+            helper.connect(user='user', password='password', port=3316)
+        mysql.MySQLdb.connect.assert_called_with(
+            passwd='password', host='localhost', user='user', port=3316)
+
+    @mock.patch.object(mysql.MySQLHelper, 'normalize_address')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password')
+    @mock.patch.object(mysql.MySQLHelper, 'grant_exists')
+    @mock.patch.object(mysql, 'relation_get')
+    @mock.patch.object(mysql, 'related_units')
+    @mock.patch.object(mysql, 'log')
+    def test_get_allowed_units(self, mock_log, mock_related_units,
+                               mock_relation_get,
+                               mock_grant_exists,
+                               mock_get_password,
+                               mock_normalize_address):
+
+        # echo
+        mock_normalize_address.side_effect = lambda addr: addr
+
+        def mock_rel_get(unit, rid):
+            if unit == 'unit/0':
+                # Non-prefixed settings
+                d = {'private-address': '10.0.0.1',
+                     'hostname': 'hostA'}
+            elif unit == 'unit/1':
+                # Containing prefixed settings
+                d = {'private-address': '10.0.0.2',
+                     'dbA_hostname': json.dumps(['10.0.0.2', '2001:db8:1::2'])}
+            elif unit == 'unit/2':
+                # No hostname
+                d = {'private-address': '10.0.0.3'}
+
+            return d
+
+        mock_relation_get.side_effect = mock_rel_get
+        mock_related_units.return_value = ['unit/0', 'unit/1', 'unit/2']
+
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        units = helper.get_allowed_units('dbA', 'userA')
+
+        calls = [mock.call('dbA', 'userA', 'hostA'),
+                 mock.call('dbA', 'userA', '10.0.0.2'),
+                 mock.call('dbA', 'userA', '2001:db8:1::2'),
+                 mock.call('dbA', 'userA', '10.0.0.3')]
+
+        helper.grant_exists.assert_has_calls(calls, any_order=True)
+        self.assertEqual(units, set(['unit/0', 'unit/1', 'unit/2']))
+
+    @mock.patch('charmhelpers.contrib.network.ip.log',
+                lambda *args, **kwargs: None)
+    @mock.patch('charmhelpers.contrib.network.ip.ns_query')
+    @mock.patch('charmhelpers.contrib.network.ip.socket')
+    @mock.patch.object(mysql, 'unit_get')
+    @mock.patch.object(mysql, 'config_get')
+    @mock.patch.object(mysql, 'log')
+    def test_normalize_address(self, mock_log, mock_config_get, mock_unit_get,
+                               mock_socket, mock_ns_query):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        # prefer-ipv6
+        mock_config_get.return_value = False
+        # echo
+        mock_socket.gethostbyname.side_effect = lambda addr: addr
+
+        mock_unit_get.return_value = '10.0.0.1'
+        out = helper.normalize_address('10.0.0.1')
+        self.assertEqual('127.0.0.1', out)
+        mock_config_get.assert_called_with('prefer-ipv6')
+
+        mock_unit_get.return_value = '10.0.0.1'
+        out = helper.normalize_address('10.0.0.2')
+        self.assertEqual('10.0.0.2', out)
+        mock_config_get.assert_called_with('prefer-ipv6')
+
+        out = helper.normalize_address('2001:db8:1::1')
+        self.assertEqual('2001:db8:1::1', out)
+        mock_config_get.assert_called_with('prefer-ipv6')
+
+        mock_socket.gethostbyname.side_effect = Exception
+        mock_ns_query.return_value = None
+        out = helper.normalize_address('unresolvable')
+        self.assertEqual('unresolvable', out)
+        mock_config_get.assert_called_with('prefer-ipv6')
+
+        # prefer-ipv6
+        mock_config_get.return_value = True
+        mock_socket.gethostbyname.side_effect = 'other'
+        out = helper.normalize_address('unresolvable')
+        self.assertEqual('unresolvable', out)
+        mock_config_get.assert_called_with('prefer-ipv6')
+
+    def test_passwd_keys(self):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        self.assertEqual(list(helper.passwd_keys(None)), ['mysql.passwd'])
+        self.assertEqual(list(helper.passwd_keys('auser')),
+                         ['mysql-auser.passwd', 'auser.passwd'])
+
+    @mock.patch.object(mysql.MySQLHelper, 'migrate_passwords_to_leader_storage')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password_on_disk')
+    @mock.patch.object(mysql, 'leader_get')
+    def test_get_mysql_password_no_peer_passwd(self, mock_leader_get,
+                                               mock_get_disk_pw,
+                                               mock_migrate_pw):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        store = {}
+        mock_leader_get.side_effect = lambda key: store.get(key)
+        mock_get_disk_pw.return_value = "disk-passwd"
+        self.assertEqual(helper.get_mysql_password(), "disk-passwd")
+        self.assertTrue(mock_migrate_pw.called)
+
+    @mock.patch.object(mysql.MySQLHelper, 'migrate_passwords_to_leader_storage')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password_on_disk')
+    @mock.patch.object(mysql, 'leader_get')
+    def test_get_mysql_password_peer_passwd(self, mock_leader_get,
+                                            mock_get_disk_pw, mock_migrate_pw):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        store = {'mysql-userA.passwd': 'passwdA'}
+        mock_leader_get.side_effect = lambda key: store.get(key)
+        mock_get_disk_pw.return_value = "disk-passwd"
+        self.assertEqual(helper.get_mysql_password(username='userA'),
+                         "passwdA")
+        self.assertTrue(mock_migrate_pw.called)
+
+    @mock.patch.object(mysql.MySQLHelper, 'migrate_passwords_to_leader_storage')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password_on_disk')
+    @mock.patch.object(mysql, 'leader_get')
+    def test_get_mysql_password_peer_passwd_legacy(self, mock_leader_get,
+                                                   mock_get_disk_pw,
+                                                   mock_migrate_pw):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        store = {'userA.passwd': 'passwdA'}
+        mock_leader_get.side_effect = lambda key: store.get(key)
+        mock_get_disk_pw.return_value = "disk-passwd"
+        self.assertEqual(helper.get_mysql_password(username='userA'),
+                         "passwdA")
+        self.assertTrue(mock_migrate_pw.called)
+
+    @mock.patch.object(mysql.MySQLHelper, 'migrate_passwords_to_leader_storage')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password_on_disk')
+    @mock.patch.object(mysql, 'leader_get')
+    def test_get_mysql_password_peer_passwd_all(self, mock_leader_get,
+                                                mock_get_disk_pw,
+                                                mock_migrate_pw):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        # Add * so we can identify that the new format key takes precedence
+        # if found.
+        store = {'mysql-userA.passwd': 'passwdA',
+                 'userA.passwd': 'passwdA*'}
+        mock_leader_get.side_effect = lambda key: store.get(key)
+        mock_get_disk_pw.return_value = "disk-passwd"
+        self.assertEqual(helper.get_mysql_password(username='userA'),
+                         "passwdA")
+        self.assertTrue(mock_migrate_pw.called)
+
+    @mock.patch.object(mysql.MySQLHelper, 'set_mysql_password')
+    def test_set_mysql_root_password(self, mock_set_passwd):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        helper.set_mysql_root_password(password='1234')
+        mock_set_passwd.assert_called_with(
+            'root',
+            '1234',
+            current_password=None)
+
+    @mock.patch.object(mysql.MySQLHelper, 'set_mysql_password')
+    def test_set_mysql_root_password_cur_passwd(self, mock_set_passwd):
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        helper.set_mysql_root_password(password='1234', current_password='abc')
+        mock_set_passwd.assert_called_with(
+            'root',
+            '1234',
+            current_password='abc')
+
+    @mock.patch.object(mysql, 'log', lambda *args, **kwargs: None)
+    @mock.patch.object(mysql, 'is_leader')
+    @mock.patch.object(mysql, 'leader_get')
+    @mock.patch.object(mysql, 'leader_set')
+    @mock.patch.object(mysql, 'CompareHostReleases')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password')
+    @mock.patch.object(mysql.MySQLHelper, 'connect')
+    def test_set_mysql_password(self, mock_connect, mock_get_passwd,
+                                mock_compare_releases, mock_leader_set,
+                                mock_leader_get, mock_is_leader):
+        mock_connection = mock.MagicMock()
+        mock_cursor = mock.MagicMock()
+        mock_connection.cursor.return_value = mock_cursor
+        mock_get_passwd.return_value = 'asdf'
+        mock_is_leader.return_value = True
+        mock_leader_get.return_value = '1234'
+        mock_compare_releases.return_value = 'artful'
+
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        helper.connection = mock_connection
+
+        helper.set_mysql_password(username='root', password='1234')
+
+        mock_connect.assert_has_calls(
+            [mock.call(user='root', password='asdf'),  # original password
+             mock.call(user='root', password='1234')])  # new password
+        mock_leader_get.assert_has_calls([mock.call('mysql.passwd')])
+        mock_leader_set.assert_has_calls(
+            [mock.call(settings={'mysql.passwd': '1234'})]
+        )
+        SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET password = "
+                             "PASSWORD( %s ) WHERE user = %s;")
+        mock_cursor.assert_has_calls(
+            [mock.call.execute(SQL_UPDATE_PASSWD, ('1234', 'root')),
+             mock.call.execute('FLUSH PRIVILEGES;'),
+             mock.call.close(),
+             mock.call.execute('select 1;'),
+             mock.call.close()]
+        )
+        mock_get_passwd.assert_called_once_with(None)
+
+        # make sure for the non-leader leader-set is not called
+        mock_is_leader.return_value = False
+        mock_leader_set.reset_mock()
+        mock_get_passwd.reset_mock()
+        helper.set_mysql_password(username='root', password='1234')
+        mock_leader_set.assert_not_called()
+        mock_get_passwd.assert_called_once_with(None)
+
+        mock_get_passwd.reset_mock()
+        mock_compare_releases.return_value = 'bionic'
+        helper.set_mysql_password(username='root', password='1234')
+        SQL_UPDATE_PASSWD = ("UPDATE mysql.user SET "
+                             "authentication_string = "
+                             "PASSWORD( %s ) WHERE user = %s;")
+        mock_cursor.assert_has_calls(
+            [mock.call.execute(SQL_UPDATE_PASSWD, ('1234', 'root')),
+             mock.call.execute('FLUSH PRIVILEGES;'),
+             mock.call.close(),
+             mock.call.execute('select 1;'),
+             mock.call.close()]
+        )
+        mock_get_passwd.assert_called_once_with(None)
+
+        # Test supplying the current password
+        mock_is_leader.return_value = False
+        mock_connect.reset_mock()
+        mock_get_passwd.reset_mock()
+        helper.set_mysql_password(
+            username='root',
+            password='1234',
+            current_password='currpass')
+        self.assertFalse(mock_get_passwd.called)
+        mock_connect.assert_has_calls(
+            [mock.call(user='root', password='currpass'),  # original password
+             mock.call(user='root', password='1234')])  # new password
+
+    @mock.patch.object(mysql, 'leader_get')
+    @mock.patch.object(mysql, 'leader_set')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password')
+    @mock.patch.object(mysql.MySQLHelper, 'connect')
+    def test_set_mysql_password_fail_to_connect(self, mock_connect,
+                                                mock_get_passwd,
+                                                mock_leader_set,
+                                                mock_leader_get):
+
+        class FakeOperationalError(Exception):
+            pass
+
+        def fake_connect(*args, **kwargs):
+            raise FakeOperationalError('foobar')
+
+        mysql.MySQLdb.OperationalError = FakeOperationalError
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        mock_connect.side_effect = fake_connect
+        self.assertRaises(mysql.MySQLSetPasswordError,
+                          helper.set_mysql_password,
+                          username='root', password='1234')
+
+    @mock.patch.object(mysql, 'leader_get')
+    @mock.patch.object(mysql, 'leader_set')
+    @mock.patch.object(mysql.MySQLHelper, 'get_mysql_password')
+    @mock.patch.object(mysql.MySQLHelper, 'connect')
+    def test_set_mysql_password_fail_to_connect2(self, mock_connect,
+                                                 mock_get_passwd,
+                                                 mock_leader_set,
+                                                 mock_leader_get):
+
+        class FakeOperationalError(Exception):
+            def __str__(self):
+                return 'some-error'
+
+        operational_error = FakeOperationalError('foobar')
+
+        def fake_connect(user, password):
+            # fail for the new password
+            if user == 'root' and password == '1234':
+                raise operational_error
+            else:
+                return mock.MagicMock()
+
+        mysql.MySQLdb.OperationalError = FakeOperationalError
+        helper = mysql.MySQLHelper('foo', 'bar', host='hostA')
+        helper.connection = mock.MagicMock()
+        mock_connect.side_effect = fake_connect
+        with self.assertRaises(mysql.MySQLSetPasswordError) as cm:
+            helper.set_mysql_password(username='root', password='1234')
+
+        ex = cm.exception
+        self.assertEqual(ex.args[0], 'Cannot connect using new password: some-error')
+        self.assertEqual(ex.args[1], operational_error)
+
+    @mock.patch.object(mysql, 'is_leader')
+    @mock.patch.object(mysql, 'leader_set')
+    def test_migrate_passwords_to_leader_storage(self, mock_leader_set,
+                                                 mock_is_leader):
+        files = {'mysql.passwd': '1',
+                 'userA.passwd': '2',
+                 'mysql-userA.passwd': '3'}
+        store = {}
+
+        def _store(settings):
+            store.update(settings)
+
+        mock_is_leader.return_value = True
+
+        tmpdir = tempfile.mkdtemp('charm-helpers-unit-tests')
+        try:
+            root_tmplt = "%s/mysql.passwd" % (tmpdir)
+            helper = mysql.MySQLHelper(root_tmplt, None, host='hostA')
+            for f in files:
+                with open(os.path.join(tmpdir, f), 'w') as fd:
+                    fd.write(files[f])
+
+            mock_leader_set.side_effect = _store
+            helper.migrate_passwords_to_leader_storage()
+
+            calls = [mock.call(settings={'mysql.passwd': '1'}),
+                     mock.call(settings={'userA.passwd': '2'}),
+                     mock.call(settings={'mysql-userA.passwd': '3'})]
+
+            mock_leader_set.assert_has_calls(calls,
+                                             any_order=True)
+        finally:
+            shutil.rmtree(tmpdir)
+
+        # Note that legacy key/val is NOT overwritten
+        self.assertEqual(store, {'mysql.passwd': '1',
+                                 'userA.passwd': '2',
+                                 'mysql-userA.passwd': '3'})
+
+    @mock.patch.object(mysql, 'log', lambda *args, **kwargs: None)
+    @mock.patch.object(mysql, 'is_leader')
+    @mock.patch.object(mysql, 'leader_set')
+    def test_migrate_passwords_to_leader_storage_not_leader(self, mock_leader_set,
+                                                            mock_is_leader):
+        mock_is_leader.return_value = False
+        tmpdir = tempfile.mkdtemp('charm-helpers-unit-tests')
+        try:
+            root_tmplt = "%s/mysql.passwd" % (tmpdir)
+            helper = mysql.MySQLHelper(root_tmplt, None, host='hostA')
+            helper.migrate_passwords_to_leader_storage()
+        finally:
+            shutil.rmtree(tmpdir)
+        mock_leader_set.assert_not_called()
+
+
+class MySQLConfigHelperTests(unittest.TestCase):
+
+    def setUp(self):
+        super(MySQLConfigHelperTests, self).setUp()
+        self.config_data = {}
+        self.config = mock.MagicMock()
+        mysql.config_get = self.config
+        self.config.side_effect = self._fake_config
+
+    def _fake_config(self, key=None):
+        if key:
+            try:
+                return self.config_data[key]
+            except KeyError:
+                return None
+        else:
+            return self.config_data
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_pool_fixed(self, log, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': "50%",
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_buffer_pool_size(),
+            helper.human_to_bytes("50G"))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_pool_not_set(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': '',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_buffer_pool_size(),
+            helper.DEFAULT_INNODB_BUFFER_SIZE_MAX)
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_buffer_unset(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': None,
+            'dataset-size': None,
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_buffer_pool_size(),
+            helper.DEFAULT_INNODB_BUFFER_SIZE_MAX)
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_buffer_unset_small(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-buffer-pool-size': None,
+            'dataset-size': None,
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_buffer_pool_size(),
+            int(helper.human_to_bytes(mem.return_value) *
+                helper.DEFAULT_INNODB_BUFFER_FACTOR))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_dataset_size(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'dataset-size': "10G",
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_buffer_pool_size(),
+            int(helper.human_to_bytes("10G")))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_tuning_level(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'safest',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_flush_log_at_trx_commit(),
+            1
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_tuning_level_fast(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'fast',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_flush_log_at_trx_commit(),
+            2
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_tuning_level_unsafe(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'unsafe',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_flush_log_at_trx_commit(),
+            0
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_valid_values(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-change-buffering': 'all',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertEqual(
+            helper.get_innodb_change_buffering(),
+            'all'
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_get_innodb_invalid_values(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-change-buffering': 'invalid',
+        }
+
+        helper = mysql.MySQLConfigHelper()
+
+        self.assertTrue(helper.get_innodb_change_buffering() is None)
+
+
+class PerconaTests(unittest.TestCase):
+
+    def setUp(self):
+        super(PerconaTests, self).setUp()
+        self.config_data = {}
+        self.config = mock.MagicMock()
+        mysql.config_get = self.config
+        self.config.side_effect = self._fake_config
+
+    def _fake_config(self, key=None):
+        if key:
+            try:
+                return self.config_data[key]
+            except KeyError:
+                return None
+        else:
+            return self.config_data
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_pool_fixed(self, log, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': "50%",
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(mysql_config.get('innodb_buffer_pool_size'),
+                         helper.human_to_bytes("50G"))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_pool_not_set(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': '',
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_buffer_pool_size'),
+            helper.DEFAULT_INNODB_BUFFER_SIZE_MAX)
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_buffer_unset(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'innodb-buffer-pool-size': None,
+            'dataset-size': None,
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_buffer_pool_size'),
+            helper.DEFAULT_INNODB_BUFFER_SIZE_MAX)
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_buffer_unset_small(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-buffer-pool-size': None,
+            'dataset-size': None,
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_buffer_pool_size'),
+            int(helper.human_to_bytes(mem.return_value) *
+                helper.DEFAULT_INNODB_BUFFER_FACTOR))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_dataset_size(self, mog, mem):
+        mem.return_value = "100G"
+        self.config_data = {
+            'dataset-size': "10G",
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_buffer_pool_size'),
+            int(helper.human_to_bytes("10G")))
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_wait_timeout(self, mog, mem):
+        mem.return_value = "100G"
+
+        timeout = 314
+        self.config_data = {
+            'wait-timeout': timeout,
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('wait_timeout'),
+            timeout)
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_tuning_level(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'safest',
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_flush_log_at_trx_commit'),
+            1
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_tuning_level_fast(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'fast',
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_flush_log_at_trx_commit'),
+            2
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_tuning_level_unsafe(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'tuning-level': 'unsafe',
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_flush_log_at_trx_commit'),
+            0
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_valid_values(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-change-buffering': 'all',
+            'innodb-io-capacity': 100,
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertEqual(
+            mysql_config.get('innodb_change_buffering'),
+            'all'
+        )
+
+        self.assertEqual(
+            mysql_config.get('innodb_io_capacity'),
+            100
+        )
+
+    @mock.patch.object(mysql.MySQLConfigHelper, 'get_mem_total')
+    @mock.patch.object(mysql, 'log')
+    def test_parse_config_innodb_invalid_values(self, mog, mem):
+        mem.return_value = "512M"
+        self.config_data = {
+            'innodb-change-buffering': 'invalid',
+        }
+
+        helper = mysql.PerconaClusterHelper()
+        mysql_config = helper.parse_config()
+
+        self.assertTrue('innodb_change_buffering' not in mysql_config)
+        self.assertTrue('innodb_io_capacity' not in mysql_config)
+
+
+class Mysql8Tests(unittest.TestCase):
+
+    def setUp(self):
+        super(Mysql8Tests, self).setUp()
+        self.template = "/tmp/mysql-passwd.txt"
+        self.connection = mock.MagicMock()
+        self.cursor = mock.MagicMock()
+        self.connection.cursor.return_value = self.cursor
+        self.helper = mysql.MySQL8Helper(
+            rpasswdf_template=self.template,
+            upasswdf_template=self.template)
+        self.helper.connection = self.connection
+        self.user = "user"
+        self.host = "10.5.0.21"
+        self.password = "passwd"
+        self.db = "mydb"
+
+    def test_grant_exists(self):
+        # With backticks
+        self.cursor.fetchall.return_value = (
+            ("GRANT USAGE ON *.* TO `{}`@`{}`".format(self.user, self.host),),
+            ("GRANT ALL PRIVILEGES ON `{}`.* TO `{}`@`{}`"
+             .format(self.db, self.user, self.host),))
+        self.assertTrue(self.helper.grant_exists(self.db, self.user, self.host))
+
+        self.cursor.execute.assert_called_with(
+            "SHOW GRANTS FOR '{}'@'{}'".format(self.user, self.host))
+
+        # With single quotes
+        self.cursor.fetchall.return_value = (
+            ("GRANT USAGE ON *.* TO '{}'@'{}'".format(self.user, self.host),),
+            ("GRANT ALL PRIVILEGES ON '{}'.* TO '{}'@'{}'"
+             .format(self.db, self.user, self.host),))
+        self.assertTrue(self.helper.grant_exists(self.db, self.user, self.host))
+
+        # Grant not there
+        self.cursor.fetchall.return_value = (
+            ("GRANT USAGE ON *.* TO '{}'@'{}'".format("someuser", "notmyhost"),),
+            ("GRANT ALL PRIVILEGES ON '{}'.* TO '{}'@'{}'"
+             .format("somedb", "someuser", "notmyhost"),))
+        self.assertFalse(self.helper.grant_exists(self.db, self.user, self.host))
+
+    def test_create_grant(self):
+        self.helper.grant_exists = mock.MagicMock(return_value=False)
+        self.helper.create_user = mock.MagicMock()
+
+        self.helper.create_grant(self.db, self.user, self.host, self.password)
+        self.cursor.execute.assert_called_with(
+            "GRANT ALL PRIVILEGES ON `{}`.* TO '{}'@'{}'"
+            .format(self.db, self.user, self.host))
+        self.helper.create_user.assert_called_with(self.user, self.host, self.password)
+
+    def test_create_user(self):
+        self.helper.create_user(self.user, self.host, self.password)
+        self.cursor.execute.assert_called_with(
+            "CREATE USER '{}'@'{}' IDENTIFIED BY '{}'".
+            format(self.user, self.host, self.password))
+
+    def test_create_router_grant(self):
+        self.helper.create_user = mock.MagicMock()
+
+        self.helper.create_router_grant(self.user, self.host, self.password)
+        _calls = [
+            mock.call("GRANT CREATE USER ON *.* TO '{}'@'{}' WITH GRANT OPTION"
+                      .format(self.user, self.host)),
+            mock.call("GRANT SELECT, INSERT, UPDATE, DELETE, EXECUTE ON "
+                      "mysql_innodb_cluster_metadata.* TO '{}'@'{}'"
+                      .format(self.user, self.host)),
+            mock.call("GRANT SELECT ON mysql.user TO '{}'@'{}'"
+                      .format(self.user, self.host)),
+            mock.call("GRANT SELECT ON "
+                      "performance_schema.replication_group_members TO "
+                      "'{}'@'{}'".format(self.user, self.host)),
+            mock.call("GRANT SELECT ON "
+                      "performance_schema.replication_group_member_stats TO "
+                      "'{}'@'{}'".format(self.user, self.host)),
+            mock.call("GRANT SELECT ON "
+                      "performance_schema.global_variables TO "
+                      "'{}'@'{}'".format(self.user, self.host))]
+
+        self.cursor.execute.assert_has_calls(_calls)
+        self.helper.create_user.assert_called_with(self.user, self.host, self.password)
+
+    def test_configure_router(self):
+        self.helper.create_user = mock.MagicMock()
+        self.helper.create_router_grant = mock.MagicMock()
+        self.helper.normalize_address = mock.MagicMock(return_value=self.host)
+        self.helper.get_mysql_password = mock.MagicMock(return_value=self.password)
+
+        self.assertEqual(self.password, self.helper.configure_router(self.host, self.user))
+        self.helper.create_user.assert_called_with(self.user, self.host, self.password)
+        self.helper.create_router_grant.assert_called_with(self.user, self.host, self.password)
+
+
+class MysqlHelperTests(unittest.TestCase):
+
+    def setUp(self):
+        super(MysqlHelperTests, self).setUp()
+
+    def test_get_prefix(self):
+        _tests = {
+            "prefix1": "prefix1_username",
+            "prefix2": "prefix2_database",
+            "prefix3": "prefix3_hostname"}
+
+        for key in _tests.keys():
+            self.assertEqual(
+                key,
+                mysql.get_prefix(_tests[key]))
+
+    def test_get_db_data(self):
+        _unprefixed = "myprefix"
+        # Test relation data has every variation of shared-db/db-router data
+        _relation_data = {
+            "egress-subnets": "10.5.0.43/32",
+            "ingress-address": "10.5.0.43",
+            "nova_database": "nova",
+            "nova_hostname": "10.5.0.43",
+            "nova_username": "nova",
+            "novaapi_database": "nova_api",
+            "novaapi_hostname": "10.5.0.43",
+            "novaapi_username": "nova",
+            "novacell0_database": "nova_cell0",
+            "novacell0_hostname": "10.5.0.43",
+            "novacell0_username": "nova",
+            "private-address": "10.5.0.43",
+            "database": "keystone",
+            "username": "keystone",
+            "hostname": "10.5.0.43",
+            "mysqlrouter_username":
+            "mysqlrouteruser",
+            "mysqlrouter_hostname": "10.5.0.43"}
+
+        _expected_data = OrderedDict([
+            ('nova', OrderedDict([('database', 'nova'),
+                                  ('hostname', '10.5.0.43'),
+                                  ('username', 'nova')])),
+            ('novaapi', OrderedDict([('database', 'nova_api'),
+                                     ('hostname', '10.5.0.43'),
+                                     ('username', 'nova')])),
+            ('novacell0', OrderedDict([('database', 'nova_cell0'),
+                                       ('hostname', '10.5.0.43'),
+                                       ('username', 'nova')])),
+            ('mysqlrouter', OrderedDict([('username', 'mysqlrouteruser'),
+                                         ('hostname', '10.5.0.43')])),
+            ('myprefix', OrderedDict([('hostname', '10.5.0.43'),
+                                      ('database', 'keystone'),
+                                      ('username', 'keystone')]))])
+
+        _results = mysql.get_db_data(_relation_data, unprefixed=_unprefixed)
+
+        for prefix in _expected_data.keys():
+            for key in _expected_data[prefix].keys():
+                self.assertEqual(
+                    _results[prefix][key], _expected_data[prefix][key])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_apache_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_apache_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b755693b92dcbebc3928f2957bca960a301a927
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_apache_utils.py
@@ -0,0 +1,133 @@
+from mock import patch, call
+
+from testtools import TestCase
+from tests.helpers import patch_open, FakeRelation
+
+import charmhelpers.contrib.hahelpers.apache as apache_utils
+
+cert = '''
+        -----BEGIN CERTIFICATE-----
+MIIDXTCCAkWgAwIBAgIJAMO1fWOu8ntUMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV
+BAYTAkFVMRMwEQYDVQQIDApTb21lLVN0YXRlMSEwHwYDVQQKDBhJbnRlcm5ldCBX
+aWRnaXRzIFB0eSBMdGQwHhcNMTQwNDIyMTUzNDA0WhcNMjQwNDE5MTUzNDA0WjBF
+MQswCQYDVQQGEwJBVTETMBEGA1UECAwKU29tZS1TdGF0ZTEhMB8GA1UECgwYSW50
+ZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
+CgKCAQEAuk6dmZnMvVxykNidNjbIwXM3ShhMpwCvUmWwpybFAIqhtNTuGJF9Ikp5
+kzB+ThQV1onK8O8YarNGQx+MOISEnlJ5npj3Atp33pKGHRn69lHKGVfJvRbN4A90
+1hTueYsELzfPV2YWm4c6nQiXRT6Cy0yaw/DE8fBTHzAiE9+/XGPsjn5VPv8H6Wa1
+f/d5FblE+RtHP6YpRo9Jh3XAn3iC9fVr8rblS4rk7ev8LfH/yIG2wRVOEPC6lYfu
+MEIwPpxKV0c3Z6lqtMOgC5dgzWjrbItnQfB0JaIzSFMMxDhNCJocQRJDQ+0jmj+K
+rMGB1QRZlVLZxx0xnv38G0GyfFMv8QIDAQABo1AwTjAdBgNVHQ4EFgQUcxEj7X26
+poFDa0lw40aAKIqyNp0wHwYDVR0jBBgwFoAUcxEj7X26poFDa0lw40aAKIqyNp0w
+DAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEAQe6RUCqTYf0Ns8fKfAEb
+QSxZKqCst02oC0F3Gm0opWiUetxZqmAYTAjztmlRFIw7hgF/P95SY1ujGLZmiAlU
+poOTjQ/i7MvjkXPVCo92izwXi65qRmJGbjduIirOAYtBmBmm3qS9BmoDlLQMVNYn
+bwFImc9ar0h+o3/VH1hry+2vEVikXiKK5uKZI6B7ejNYfAWydq6ilzfKIh75W852
+OSbKt3NB/BTZZUdCvK6+B+MoeuzQHDO0/QKBEBfaKFeJki3mdyzFlNbYio1z00rM
+E2zl3kh9gkZnMuV1uzHdfKJbtTcNn4hCls5x7T21jn4joADHaVez8FloykBUABu3
+qw==
+-----END CERTIFICATE-----
+'''
+
+IDENTITY_NEW_STYLE_CERTS = {
+    'identity-service:0': {
+        'keystone/0': {
+            'ssl_cert_test-cn': 'keystone_provided_cert',
+            'ssl_key_test-cn': 'keystone_provided_key',
+        }
+    }
+}
+
+IDENTITY_OLD_STYLE_CERTS = {
+    'identity-service:0': {
+        'keystone/0': {
+            'ssl_cert': 'keystone_provided_cert',
+            'ssl_key': 'keystone_provided_key',
+        }
+    }
+}
+
+
+class ApacheUtilsTests(TestCase):
+    def setUp(self):
+        super(ApacheUtilsTests, self).setUp()
+        [self._patch(m) for m in [
+            'log',
+            'config_get',
+            'relation_get',
+            'relation_ids',
+            'relation_list',
+            'host',
+        ]]
+
+    def _patch(self, method):
+        _m = patch.object(apache_utils, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def test_get_cert_from_config(self):
+        '''Ensure cert and key from charm config override relation'''
+        self.config_get.side_effect = [
+            'some_ca_cert',  # config_get('ssl_cert')
+            'some_ca_key',  # config_Get('ssl_key')
+        ]
+        result = apache_utils.get_cert('test-cn')
+        self.assertEquals(('some_ca_cert', 'some_ca_key'), result)
+
+    def test_get_ca_cert_from_config(self):
+        self.config_get.return_value = "some_ca_cert"
+        self.assertEquals('some_ca_cert', apache_utils.get_ca_cert())
+
+    def test_get_cert_from_relation(self):
+        self.config_get.return_value = None
+        rel = FakeRelation(IDENTITY_NEW_STYLE_CERTS)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.relation_list.side_effect = rel.relation_units
+        self.relation_get.side_effect = rel.get
+        result = apache_utils.get_cert('test-cn')
+        self.assertEquals(('keystone_provided_cert', 'keystone_provided_key'),
+                          result)
+
+    def test_get_cert_from_relation_deprecated(self):
+        self.config_get.return_value = None
+        rel = FakeRelation(IDENTITY_OLD_STYLE_CERTS)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.relation_list.side_effect = rel.relation_units
+        self.relation_get.side_effect = rel.get
+        result = apache_utils.get_cert()
+        self.assertEquals(('keystone_provided_cert', 'keystone_provided_key'),
+                          result)
+
+    def test_get_ca_cert_from_relation(self):
+        self.config_get.return_value = None
+        self.relation_ids.side_effect = [['identity-service:0'],
+                                         ['identity-credentials:1']]
+        self.relation_list.return_value = 'keystone/0'
+        self.relation_get.side_effect = [
+            'keystone_provided_ca',
+        ]
+        result = apache_utils.get_ca_cert()
+        self.relation_ids.assert_has_calls([call('identity-service'),
+                                            call('identity-credentials')])
+        self.assertEquals('keystone_provided_ca',
+                          result)
+
+    @patch.object(apache_utils.os.path, 'isfile')
+    def test_retrieve_ca_cert(self, _isfile):
+        _isfile.return_value = True
+        with patch_open() as (_open, _file):
+            _file.read.return_value = cert
+            self.assertEqual(
+                apache_utils.retrieve_ca_cert('mycertfile'),
+                cert)
+            _open.assert_called_once_with('mycertfile', 'rb')
+
+    @patch.object(apache_utils.os.path, 'isfile')
+    def test_retrieve_ca_cert_no_file(self, _isfile):
+        _isfile.return_value = False
+        with patch_open() as (_open, _file):
+            self.assertEqual(
+                apache_utils.retrieve_ca_cert('mycertfile'),
+                None)
+            self.assertFalse(_open.called)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_cluster_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_cluster_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..990f1dcb0bfbde735b90b8b8418a82d47659cf25
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hahelpers/test_cluster_utils.py
@@ -0,0 +1,590 @@
+from mock import patch, MagicMock, call
+
+from subprocess import CalledProcessError
+from testtools import TestCase
+
+import charmhelpers.contrib.hahelpers.cluster as cluster_utils
+
+CRM_STATUS = b'''
+Last updated: Thu May 14 14:46:35 2015
+Last change: Thu May 14 14:43:51 2015 via crmd on juju-trusty-machine-1
+Stack: corosync
+Current DC: juju-trusty-machine-2 (168108171) - partition with quorum
+Version: 1.1.10-42f2063
+3 Nodes configured
+4 Resources configured
+
+
+Online: [ juju-trusty-machine-1 juju-trusty-machine-2 juju-trusty-machine-3 ]
+
+ Resource Group: grp_percona_cluster
+      res_mysql_vip      (ocf::heartbeat:IPaddr2):       Started juju-trusty-machine-1
+       Clone Set: cl_mysql_monitor [res_mysql_monitor]
+            Started: [ juju-trusty-machine-1 juju-trusty-machine-2 juju-trusty-machine-3 ]
+'''
+
+CRM_DC_NONE = b'''
+Last updated: Thu May 14 14:46:35 2015
+Last change: Thu May 14 14:43:51 2015 via crmd on juju-trusty-machine-1
+Stack: corosync
+Current DC: NONE
+1 Nodes configured, 2 expected votes
+0 Resources configured
+
+
+Node node1: UNCLEAN (offline)
+'''
+
+
+class ClusterUtilsTests(TestCase):
+    def setUp(self):
+        super(ClusterUtilsTests, self).setUp()
+        [self._patch(m) for m in [
+            'log',
+            'relation_ids',
+            'relation_list',
+            'relation_get',
+            'get_unit_hostname',
+            'config_get',
+            'unit_get',
+        ]]
+
+    def _patch(self, method):
+        _m = patch.object(cluster_utils, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def test_is_clustered(self):
+        '''It determines whether or not a unit is clustered'''
+        self.relation_ids.return_value = ['ha:0']
+        self.relation_list.return_value = ['ha/0']
+        self.relation_get.return_value = 'yes'
+        self.assertTrue(cluster_utils.is_clustered())
+
+    def test_is_not_clustered(self):
+        '''It determines whether or not a unit is clustered'''
+        self.relation_ids.return_value = ['ha:0']
+        self.relation_list.return_value = ['ha/0']
+        self.relation_get.return_value = None
+        self.assertFalse(cluster_utils.is_clustered())
+
+    @patch('subprocess.check_output')
+    def test_is_crm_dc(self, check_output):
+        '''It determines its unit is leader'''
+        self.get_unit_hostname.return_value = 'juju-trusty-machine-2'
+        check_output.return_value = CRM_STATUS
+        self.assertTrue(cluster_utils.is_crm_dc())
+
+    @patch('subprocess.check_output')
+    def test_is_crm_dc_no_cluster(self, check_output):
+        '''It is not leader if there is no cluster up'''
+        def r(*args, **kwargs):
+            raise CalledProcessError(1, 'crm')
+
+        check_output.side_effect = r
+        self.assertRaises(cluster_utils.CRMDCNotFound, cluster_utils.is_crm_dc)
+
+    @patch('subprocess.check_output')
+    def test_is_crm_dc_false(self, check_output):
+        '''It determines its unit is leader'''
+        self.get_unit_hostname.return_value = 'juju-trusty-machine-1'
+        check_output.return_value = CRM_STATUS
+        self.assertFalse(cluster_utils.is_crm_dc())
+
+    @patch('subprocess.check_output')
+    def test_is_crm_dc_current_none(self, check_output):
+        '''It determines its unit is leader'''
+        self.get_unit_hostname.return_value = 'juju-trusty-machine-1'
+        check_output.return_value = CRM_DC_NONE
+        self.assertRaises(cluster_utils.CRMDCNotFound, cluster_utils.is_crm_dc)
+
+    @patch('subprocess.check_output')
+    def test_is_crm_leader(self, check_output):
+        '''It determines its unit is leader'''
+        self.get_unit_hostname.return_value = 'node1'
+        crm = b'resource vip is running on: node1'
+        check_output.return_value = crm
+        self.assertTrue(cluster_utils.is_crm_leader('vip'))
+
+    @patch('charmhelpers.core.decorators.time')
+    @patch('subprocess.check_output')
+    def test_is_not_leader(self, check_output, mock_time):
+        '''It determines its unit is not leader'''
+        self.get_unit_hostname.return_value = 'node1'
+        crm = b'resource vip is running on: node2'
+        check_output.return_value = crm
+        self.assertFalse(cluster_utils.is_crm_leader('some_resource'))
+        self.assertFalse(mock_time.called)
+
+    @patch('charmhelpers.core.decorators.log')
+    @patch('charmhelpers.core.decorators.time')
+    @patch('subprocess.check_output')
+    def test_is_not_leader_resource_not_exists(self, check_output, mock_time,
+                                               mock_log):
+        '''It determines its unit is not leader'''
+        self.get_unit_hostname.return_value = 'node1'
+        check_output.return_value = "resource vip is NOT running"
+        self.assertRaises(cluster_utils.CRMResourceNotFound,
+                          cluster_utils.is_crm_leader, 'vip')
+        mock_time.assert_has_calls([call.sleep(2), call.sleep(4),
+                                    call.sleep(6)])
+
+    @patch('charmhelpers.core.decorators.time')
+    @patch('subprocess.check_output')
+    def test_is_crm_leader_no_cluster(self, check_output, mock_time):
+        '''It is not leader if there is no cluster up'''
+        check_output.side_effect = CalledProcessError(1, 'crm')
+        self.assertFalse(cluster_utils.is_crm_leader('vip'))
+        self.assertFalse(mock_time.called)
+
+    @patch.object(cluster_utils, 'is_crm_dc')
+    def test_is_crm_leader_dc_resource(self, _is_crm_dc):
+        '''Call out to is_crm_dc'''
+        cluster_utils.is_crm_leader(cluster_utils.DC_RESOURCE_NAME)
+        _is_crm_dc.assert_called_with()
+
+    def test_peer_units(self):
+        '''It lists all peer units for cluster relation'''
+        peers = ['peer_node/1', 'peer_node/2']
+        self.relation_ids.return_value = ['cluster:0']
+        self.relation_list.return_value = peers
+        self.assertEquals(peers, cluster_utils.peer_units())
+
+    def test_peer_ips(self):
+        '''Get a dict of peers and their ips'''
+        peers = {
+            'peer_node/1': '10.0.0.1',
+            'peer_node/2': '10.0.0.2',
+        }
+
+        def _relation_get(attr, rid, unit):
+            return peers[unit]
+        self.relation_ids.return_value = ['cluster:0']
+        self.relation_list.return_value = peers.keys()
+        self.relation_get.side_effect = _relation_get
+        self.assertEquals(peers, cluster_utils.peer_ips())
+
+    @patch('os.getenv')
+    def test_is_oldest_peer(self, getenv):
+        '''It detects local unit is the oldest of all peers'''
+        peers = ['peer_node/1', 'peer_node/2', 'peer_node/3']
+        getenv.return_value = 'peer_node/1'
+        self.assertTrue(cluster_utils.oldest_peer(peers))
+
+    @patch('os.getenv')
+    def test_is_not_oldest_peer(self, getenv):
+        '''It detects local unit is not the oldest of all peers'''
+        peers = ['peer_node/1', 'peer_node/2', 'peer_node/3']
+        getenv.return_value = 'peer_node/2'
+        self.assertFalse(cluster_utils.oldest_peer(peers))
+
+    @patch.object(cluster_utils, 'is_crm_leader')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_is_elected_leader_clustered(self, is_clustered, is_crm_leader):
+        '''It detects it is the eligible leader in a hacluster of units'''
+        is_clustered.return_value = True
+        is_crm_leader.return_value = True
+        self.assertTrue(cluster_utils.is_elected_leader('vip'))
+
+    @patch.object(cluster_utils, 'is_crm_leader')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_not_is_elected_leader_clustered(self, is_clustered, is_crm_leader):
+        '''It detects it is not the eligible leader in a hacluster of units'''
+        is_clustered.return_value = True
+        is_crm_leader.return_value = False
+        self.assertFalse(cluster_utils.is_elected_leader('vip'))
+
+    @patch.object(cluster_utils, 'oldest_peer')
+    @patch.object(cluster_utils, 'peer_units')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_is_is_elected_leader_unclustered(self, is_clustered,
+                                              peer_units, oldest_peer):
+        '''It detects it is the eligible leader in non-clustered peer group'''
+        is_clustered.return_value = False
+        oldest_peer.return_value = True
+        self.assertTrue(cluster_utils.is_elected_leader('vip'))
+
+    @patch.object(cluster_utils, 'oldest_peer')
+    @patch.object(cluster_utils, 'peer_units')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_not_is_elected_leader_unclustered(self, is_clustered,
+                                               peer_units, oldest_peer):
+        '''It detects it is not the eligible leader in non-clustered group'''
+        is_clustered.return_value = False
+        oldest_peer.return_value = False
+        self.assertFalse(cluster_utils.is_elected_leader('vip'))
+
+    def test_https_explict(self):
+        '''It determines https is available if configured explicitly'''
+        # config_get('use-https')
+        self.config_get.return_value = 'yes'
+        self.assertTrue(cluster_utils.https())
+
+    def test_https_cert_key_in_config(self):
+        '''It determines https is available if cert + key in charm config'''
+        # config_get('use-https')
+        self.config_get.side_effect = [
+            'no',  # config_get('use-https')
+            'cert',  # config_get('ssl_cert')
+            'key',  # config_get('ssl_key')
+        ]
+        self.assertTrue(cluster_utils.https())
+
+    def test_https_cert_key_in_identity_relation(self):
+        '''It determines https is available if cert in identity-service'''
+        self.config_get.return_value = False
+        self.relation_ids.return_value = 'identity-service:0'
+        self.relation_list.return_value = 'keystone/0'
+        self.relation_get.side_effect = [
+            'yes',  # relation_get('https_keystone')
+            'cert',  # relation_get('ssl_cert')
+            'key',  # relation_get('ssl_key')
+            'ca_cert',  # relation_get('ca_cert')
+        ]
+        self.assertTrue(cluster_utils.https())
+
+    def test_https_cert_key_incomplete_identity_relation(self):
+        '''It determines https unavailable if cert not in identity-service'''
+        self.config_get.return_value = False
+        self.relation_ids.return_value = 'identity-service:0'
+        self.relation_list.return_value = 'keystone/0'
+        self.relation_get.return_value = None
+        self.assertFalse(cluster_utils.https())
+
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'peer_units')
+    def test_determine_api_port_with_peers(self, peer_units, https):
+        '''It determines API port in presence of peers'''
+        peer_units.return_value = ['peer1']
+        https.return_value = False
+        self.assertEquals(9686, cluster_utils.determine_api_port(9696))
+
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'peer_units')
+    def test_determine_api_port_nopeers_singlemode(self, peer_units, https):
+        '''It determines API port with a single unit in singlemode'''
+        peer_units.return_value = []
+        https.return_value = False
+        port = cluster_utils.determine_api_port(9696, singlenode_mode=True)
+        self.assertEquals(9686, port)
+
+    @patch.object(cluster_utils, 'is_clustered')
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'peer_units')
+    def test_determine_api_port_clustered(self, peer_units, https,
+                                          is_clustered):
+        '''It determines API port in presence of an hacluster'''
+        peer_units.return_value = []
+        is_clustered.return_value = True
+        https.return_value = False
+        self.assertEquals(9686, cluster_utils.determine_api_port(9696))
+
+    @patch.object(cluster_utils, 'is_clustered')
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'peer_units')
+    def test_determine_api_port_clustered_https(self, peer_units, https,
+                                                is_clustered):
+        '''It determines API port in presence of hacluster + https'''
+        peer_units.return_value = []
+        is_clustered.return_value = True
+        https.return_value = True
+        self.assertEquals(9676, cluster_utils.determine_api_port(9696))
+
+    @patch.object(cluster_utils, 'https')
+    def test_determine_apache_port_https(self, https):
+        '''It determines haproxy port with https enabled'''
+        https.return_value = True
+        self.assertEquals(9696, cluster_utils.determine_apache_port(9696))
+
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_determine_apache_port_clustered(self, https, is_clustered):
+        '''It determines haproxy port with https disabled'''
+        https.return_value = True
+        is_clustered.return_value = True
+        self.assertEquals(9686, cluster_utils.determine_apache_port(9696))
+
+    @patch.object(cluster_utils, 'peer_units')
+    @patch.object(cluster_utils, 'https')
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_determine_apache_port_nopeers_singlemode(self, https,
+                                                      is_clustered,
+                                                      peer_units):
+        '''It determines haproxy port with a single unit in singlemode'''
+        peer_units.return_value = []
+        https.return_value = False
+        is_clustered.return_value = False
+        port = cluster_utils.determine_apache_port(9696, singlenode_mode=True)
+        self.assertEquals(9686, port)
+
+    @patch.object(cluster_utils, 'valid_hacluster_config')
+    def test_get_hacluster_config_complete(self, valid_hacluster_config):
+        '''It fetches all hacluster charm config'''
+        conf = {
+            'ha-bindiface': 'eth1',
+            'ha-mcastport': '3333',
+            'vip': '10.0.0.1',
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+        }
+
+        valid_hacluster_config.return_value = True
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertEquals(conf, cluster_utils.get_hacluster_config())
+
+    @patch.object(cluster_utils, 'valid_hacluster_config')
+    def test_get_hacluster_config_incomplete(self, valid_hacluster_config):
+        '''It raises exception if some hacluster charm config missing'''
+        conf = {
+            'ha-bindiface': 'eth1',
+            'ha-mcastport': '3333',
+            'vip': None,
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+        }
+
+        valid_hacluster_config.return_value = False
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertRaises(cluster_utils.HAIncorrectConfig,
+                          cluster_utils.get_hacluster_config)
+
+    @patch.object(cluster_utils, 'valid_hacluster_config')
+    def test_get_hacluster_config_with_excludes(self, valid_hacluster_config):
+        '''It fetches all hacluster charm config'''
+        conf = {
+            'ha-bindiface': 'eth1',
+            'ha-mcastport': '3333',
+        }
+        valid_hacluster_config.return_value = True
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        exclude_keys = ['vip', 'os-admin-hostname', 'os-internal-hostname',
+                        'os-public-hostname', 'os-access-hostname']
+        result = cluster_utils.get_hacluster_config(exclude_keys)
+        self.assertEquals(conf, result)
+
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_canonical_url_bare(self, is_clustered):
+        '''It constructs a URL to host with no https or cluster present'''
+        self.unit_get.return_value = 'foohost1'
+        is_clustered.return_value = False
+        configs = MagicMock()
+        configs.complete_contexts = MagicMock()
+        configs.complete_contexts.return_value = []
+        url = cluster_utils.canonical_url(configs)
+        self.assertEquals('http://foohost1', url)
+
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_canonical_url_https_no_cluster(self, is_clustered):
+        '''It constructs a URL to host with https and no cluster present'''
+        self.unit_get.return_value = 'foohost1'
+        is_clustered.return_value = False
+        configs = MagicMock()
+        configs.complete_contexts = MagicMock()
+        configs.complete_contexts.return_value = ['https']
+        url = cluster_utils.canonical_url(configs)
+        self.assertEquals('https://foohost1', url)
+
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_canonical_url_https_cluster(self, is_clustered):
+        '''It constructs a URL to host with https and cluster present'''
+        self.config_get.return_value = '10.0.0.1'
+        is_clustered.return_value = True
+        configs = MagicMock()
+        configs.complete_contexts = MagicMock()
+        configs.complete_contexts.return_value = ['https']
+        url = cluster_utils.canonical_url(configs)
+        self.assertEquals('https://10.0.0.1', url)
+
+    @patch.object(cluster_utils, 'is_clustered')
+    def test_canonical_url_cluster_no_https(self, is_clustered):
+        '''It constructs a URL to host with no https and cluster present'''
+        self.config_get.return_value = '10.0.0.1'
+        self.unit_get.return_value = 'foohost1'
+        is_clustered.return_value = True
+        configs = MagicMock()
+        configs.complete_contexts = MagicMock()
+        configs.complete_contexts.return_value = []
+        url = cluster_utils.canonical_url(configs)
+        self.assertEquals('http://10.0.0.1', url)
+
+    @patch.object(cluster_utils, 'status_set')
+    def test_valid_hacluster_config_incomplete(self, status_set):
+        '''Returns False with incomplete HA config'''
+        conf = {
+            'vip': None,
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+            'dns-ha': False,
+        }
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertRaises(cluster_utils.HAIncorrectConfig,
+                          cluster_utils.valid_hacluster_config)
+
+    @patch.object(cluster_utils, 'status_set')
+    def test_valid_hacluster_config_both(self, status_set):
+        '''Returns False when both VIP and DNS HA are set'''
+        conf = {
+            'vip': '10.0.0.1',
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+            'dns-ha': True,
+        }
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertRaises(cluster_utils.HAIncorrectConfig,
+                          cluster_utils.valid_hacluster_config)
+
+    @patch.object(cluster_utils, 'status_set')
+    def test_valid_hacluster_config_vip_ha(self, status_set):
+        '''Returns True with complete VIP HA config'''
+        conf = {
+            'vip': '10.0.0.1',
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+            'dns-ha': False,
+        }
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertTrue(cluster_utils.valid_hacluster_config())
+        self.assertFalse(status_set.called)
+
+    @patch.object(cluster_utils, 'status_set')
+    def test_valid_hacluster_config_dns_incomplete(self, status_set):
+        '''Returns False with incomplete DNS HA config'''
+        conf = {
+            'vip': None,
+            'os-admin-hostname': None,
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+            'dns-ha': True,
+        }
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertRaises(cluster_utils.HAIncompleteConfig,
+                          cluster_utils.valid_hacluster_config)
+
+    @patch.object(cluster_utils, 'status_set')
+    def test_valid_hacluster_config_dns_ha(self, status_set):
+        '''Returns True with complete DNS HA config'''
+        conf = {
+            'vip': None,
+            'os-admin-hostname': 'somehostname',
+            'os-public-hostname': None,
+            'os-internal-hostname': None,
+            'os-access-hostname': None,
+            'dns-ha': True,
+        }
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        self.config_get.side_effect = _fake_config_get
+        self.assertTrue(cluster_utils.valid_hacluster_config())
+        self.assertFalse(status_set.called)
+
+    @patch.object(cluster_utils, 'juju_is_leader')
+    @patch.object(cluster_utils, 'status_set')
+    @patch.object(cluster_utils.time, 'sleep')
+    @patch.object(cluster_utils, 'modulo_distribution')
+    @patch.object(cluster_utils, 'log')
+    def test_distributed_wait(self, log, modulo_distribution, sleep,
+                              status_set, is_leader):
+
+        # Leader regardless of modulo should not wait
+        is_leader.return_value = True
+        cluster_utils.distributed_wait(modulo=9, wait=23)
+        modulo_distribution.assert_not_called()
+        sleep.assert_called_with(0)
+
+        # The rest of the tests are non-leader units
+        is_leader.return_value = False
+
+        def _fake_config_get(setting):
+            return conf[setting]
+
+        # Uses fallback defaults
+        conf = {
+            'modulo-nodes': None,
+            'known-wait': None,
+        }
+        self.config_get.side_effect = _fake_config_get
+        cluster_utils.distributed_wait()
+        modulo_distribution.assert_called_with(modulo=3, wait=30,
+                                               non_zero_wait=True)
+
+        # Uses config values
+        conf = {
+            'modulo-nodes': 7,
+            'known-wait': 10,
+        }
+        self.config_get.side_effect = _fake_config_get
+        cluster_utils.distributed_wait()
+        modulo_distribution.assert_called_with(modulo=7, wait=10,
+                                               non_zero_wait=True)
+
+        # Uses passed values
+        cluster_utils.distributed_wait(modulo=5, wait=45)
+        modulo_distribution.assert_called_with(modulo=5, wait=45,
+                                               non_zero_wait=True)
+
+    @patch.object(cluster_utils, 'relation_ids')
+    def test_get_managed_services_and_ports(self, relation_ids):
+        relation_ids.return_value = ['rel:2']
+        self.assertEqual(
+            cluster_utils.get_managed_services_and_ports(
+                ['apache2', 'haproxy'],
+                [8067, 4545, 6732]),
+            (['apache2'], [8057, 4535, 6722]))
+        self.assertEqual(
+            cluster_utils.get_managed_services_and_ports(
+                ['apache2', 'haproxy'],
+                [8067, 4545, 6732],
+                external_services=['apache2']),
+            (['haproxy'], [8057, 4535, 6722]))
+
+        def add_ten(x):
+            return x + 10
+
+        self.assertEqual(
+            cluster_utils.get_managed_services_and_ports(
+                ['apache2', 'haproxy'],
+                [8067, 4545, 6732],
+                port_conv_f=add_ten),
+            (['apache2'], [8077, 4555, 6742]))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/checks/test_config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/checks/test_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..da080da395488bd9e91945f443bd302e9a0d26a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/apache/checks/test_config.py
@@ -0,0 +1,110 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import shutil
+import tempfile
+
+from unittest import TestCase
+from mock import patch
+
+from charmhelpers.contrib.hardening.apache.checks import config
+
+TEST_TMPDIR = None
+APACHE_VERSION_STR = b"""Server version: Apache/2.4.7 (Ubuntu)
+Server built:   Jan 14 2016 17:45:23
+"""
+
+
+class ApacheConfigTestCase(TestCase):
+
+    def setUp(self):
+        global TEST_TMPDIR
+        TEST_TMPDIR = tempfile.mkdtemp()
+
+    def tearDown(self):
+        shutil.rmtree(TEST_TMPDIR)
+
+    @patch.object(config.subprocess, 'call', lambda *args, **kwargs: 1)
+    def test_get_audits_apache_not_installed(self):
+        audits = config.get_audits()
+        self.assertEqual([], audits)
+
+    @patch.object(config.utils, 'get_settings', lambda x: {
+        'common': {'apache_dir': TEST_TMPDIR,
+                   'traceenable': 'Off'},
+        'hardening': {
+            'allowed_http_methods': {'GOGETEM'},
+            'modules_to_disable': {'modfoo'}
+        }
+    })
+    @patch.object(config.subprocess, 'call', lambda *args, **kwargs: 0)
+    def test_get_audits_apache_is_installed(self):
+        audits = config.get_audits()
+        self.assertEqual(7, len(audits))
+
+    @patch.object(config.utils, 'get_settings', lambda x: {
+        'common': {'apache_dir': TEST_TMPDIR},
+        'hardening': {
+            'allowed_http_methods': {'GOGETEM'},
+            'modules_to_disable': {'modfoo'},
+            'traceenable': 'off',
+            'servertokens': 'Prod',
+            'honor_cipher_order': 'on',
+            'cipher_suite': 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
+        }
+    })
+    @patch.object(config, 'subprocess')
+    def test_ApacheConfContext(self, mock_subprocess):
+        mock_subprocess.call.return_value = 0
+
+        with tempfile.NamedTemporaryFile() as ftmp:  # noqa
+            def fake_check_output(cmd, *args, **kwargs):
+                if cmd[0] == 'apache2':
+                    return APACHE_VERSION_STR
+
+            mock_subprocess.check_output.side_effect = fake_check_output
+            ctxt = config.ApacheConfContext()
+            self.assertEqual(ctxt(), {
+                'allowed_http_methods': set(['GOGETEM']),
+                'apache_icondir':
+                '/usr/share/apache2/icons/',
+                'apache_version': '2.4.7',
+                'modules_to_disable': set(['modfoo']),
+                'servertokens': 'Prod',
+                'traceenable': 'off',
+                'honor_cipher_order': 'on',
+                'cipher_suite': 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
+            })
+
+    @patch.object(config.utils, 'get_settings', lambda x: {
+        'common': {'apache_dir': TEST_TMPDIR},
+        'hardening': {
+            'allowed_http_methods': {'GOGETEM'},
+            'modules_to_disable': {'modfoo'},
+            'traceenable': 'off',
+            'servertokens': 'Prod',
+            'honor_cipher_order': 'on',
+            'cipher_suite': 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
+        }
+    })
+    @patch.object(config.subprocess, 'call', lambda *args, **kwargs: 0)
+    def test_file_permission_audit(self):
+        audits = config.get_audits()
+        settings = config.utils.get_settings('apache')
+        conf_file_name = 'apache2.conf'
+        conf_file_path = os.path.join(
+            settings['common']['apache_dir'], conf_file_name
+        )
+        self.assertEqual(audits[0].paths[0], conf_file_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..30a3e94359e94011cd247de7ade76667346e7379
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apache_audits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apache_audits.py
new file mode 100644
index 0000000000000000000000000000000000000000..69e7c081c6e7fcd0579f9417b025c66d5f39c976
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apache_audits.py
@@ -0,0 +1,86 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from mock import call
+from mock import patch
+
+from unittest import TestCase
+from charmhelpers.contrib.hardening.audits import apache
+from subprocess import CalledProcessError
+
+
+class DisabledModuleAuditsTest(TestCase):
+
+    def setup(self):
+        super(DisabledModuleAuditsTest, self).setUp()
+        self._patch_obj(apache, 'log')
+
+    def _patch_obj(self, obj, method):
+        _m = patch.object(obj, method)
+        mock = _m.start()
+        self.addCleanup(mock.stop)
+        setattr(self, method, mock)
+
+    def test_init_string(self):
+        audit = apache.DisabledModuleAudit('foo')
+        self.assertEqual(['foo'], audit.modules)
+
+    def test_init_list(self):
+        audit = apache.DisabledModuleAudit(['foo', 'bar'])
+        self.assertEqual(['foo', 'bar'], audit.modules)
+
+    @patch.object(apache.DisabledModuleAudit, '_get_loaded_modules')
+    def test_ensure_compliance_no_modules(self, mock_loaded_modules):
+        audit = apache.DisabledModuleAudit(None)
+        audit.ensure_compliance()
+        self.assertFalse(mock_loaded_modules.called)
+
+    @patch.object(apache.DisabledModuleAudit, '_get_loaded_modules')
+    @patch.object(apache, 'log', lambda *args, **kwargs: None)
+    def test_ensure_compliance_loaded_modules_raises_ex(self,
+                                                        mock_loaded_modules):
+        mock_loaded_modules.side_effect = CalledProcessError(1, 'test', 'err')
+        audit = apache.DisabledModuleAudit('foo')
+        audit.ensure_compliance()
+
+    @patch.object(apache.DisabledModuleAudit, '_get_loaded_modules')
+    @patch.object(apache.DisabledModuleAudit, '_disable_module')
+    @patch.object(apache, 'log', lambda *args, **kwargs: None)
+    def test_disabled_modules_not_loaded(self, mock_disable_module,
+                                         mock_loaded_modules):
+        mock_loaded_modules.return_value = ['foo']
+        audit = apache.DisabledModuleAudit('bar')
+        audit.ensure_compliance()
+        self.assertFalse(mock_disable_module.called)
+
+    @patch.object(apache.DisabledModuleAudit, '_get_loaded_modules')
+    @patch.object(apache.DisabledModuleAudit, '_disable_module')
+    @patch.object(apache.DisabledModuleAudit, '_restart_apache')
+    @patch.object(apache, 'log', lambda *args, **kwargs: None)
+    def test_disabled_modules_loaded(self, mock_restart_apache,
+                                     mock_disable_module, mock_loaded_modules):
+        mock_loaded_modules.return_value = ['foo', 'bar']
+        audit = apache.DisabledModuleAudit('bar')
+        audit.ensure_compliance()
+        mock_disable_module.assert_has_calls([call('bar')])
+        mock_restart_apache.assert_has_calls([call()])
+
+    @patch('subprocess.check_output')
+    def test_get_loaded_modules(self, mock_check_output):
+        mock_check_output.return_value = (b'Loaded Modules:\n'
+                                          b' foo_module (static)\n'
+                                          b' bar_module (shared)\n')
+        audit = apache.DisabledModuleAudit('bar')
+        result = audit._get_loaded_modules()
+        self.assertEqual(['foo', 'bar'], result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apt_audits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apt_audits.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc14b2a55a910fd743da21ad126826edc67d0076
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_apt_audits.py
@@ -0,0 +1,87 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import call
+from mock import MagicMock
+from mock import patch
+
+from charmhelpers.contrib.hardening.audits import apt
+from charmhelpers.fetch import ubuntu_apt_pkg as apt_pkg
+from charmhelpers.core import hookenv
+
+
+class RestrictedPackagesTestCase(TestCase):
+    def setUp(self):
+        super(RestrictedPackagesTestCase, self).setUp()
+
+    def create_package(self, name, virtual=False):
+        pkg = MagicMock()
+        pkg.name = name
+        pkg.current_ver = '2.0'
+        if virtual:
+            pkgver = MagicMock()
+            pkgver.parent_pkg = self.create_package('foo')
+            pkg.provides_list = [('virtualfoo', None, pkgver)]
+            resp = {
+                'has_provides': True,
+                'has_versions': False,
+            }
+            pkg.get.side_effect = resp.get
+
+        return pkg
+
+    @patch.object(apt, 'apt_cache')
+    @patch.object(apt, 'apt_purge')
+    @patch.object(apt, 'log', lambda *args, **kwargs: None)
+    def test_ensure_compliance(self, mock_purge, mock_apt_cache):
+        pkg = self.create_package('bar')
+        mock_apt_cache.return_value = {'bar': pkg}
+
+        audit = apt.RestrictedPackages(pkgs=['bar'])
+        audit.ensure_compliance()
+        mock_purge.assert_has_calls([call(pkg.name)])
+
+    @patch.object(apt, 'apt_purge')
+    @patch.object(apt, 'apt_cache')
+    @patch.object(apt, 'log', lambda *args, **kwargs: None)
+    def test_apt_harden_virtual_package(self, mock_apt_cache, mock_apt_purge):
+        vpkg = self.create_package('virtualfoo', virtual=True)
+        mock_apt_cache.return_value = {'foo': vpkg}
+        audit = apt.RestrictedPackages(pkgs=['foo'])
+        audit.ensure_compliance()
+        self.assertTrue(mock_apt_cache.called)
+        mock_apt_purge.assert_has_calls([call('foo')])
+
+
+class AptConfigTestCase(TestCase):
+
+    @patch.object(apt, 'apt_pkg')
+    def test_ensure_compliance(self, mock_apt_pkg):
+        mock_apt_pkg.init.return_value = None
+        mock_apt_pkg.config.side_effect = {}
+        mock_apt_pkg.config.get.return_value = None
+        audit = apt.AptConfig([{'key': 'APT::Get::AllowUnauthenticated',
+                                'expected': 'false'}])
+        audit.ensure_compliance()
+        self.assertTrue(mock_apt_pkg.config.get.called)
+
+    @patch.object(hookenv, 'log')
+    def test_verify_config(self, mock_log):
+        cfg = apt_pkg.config
+        key, value = list(cfg.items())[0]
+        audit = apt.AptConfig([{"key": key, "expected": value}])
+        audit.ensure_compliance()
+        self.assertFalse(mock_log.called)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_base_audits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_base_audits.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf9f2367304d30fca6f48f63b640e77cc51e3d97
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_base_audits.py
@@ -0,0 +1,52 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening.audits import BaseAudit
+
+
+class BaseAuditTestCase(TestCase):
+
+    def setUp(self):
+        super(BaseAuditTestCase, self).setUp()
+
+    def test_take_action_default(self):
+        check = BaseAudit()
+        take_action = check._take_action()
+        self.assertTrue(take_action)
+
+    def test_take_action_unless_true(self):
+        check = BaseAudit(unless=True)
+        take_action = check._take_action()
+        self.assertFalse(take_action)
+
+    def test_take_action_unless_false(self):
+        check = BaseAudit(unless=False)
+        take_action = check._take_action()
+        self.assertTrue(take_action)
+
+    def test_take_action_unless_callback_false(self):
+        def callback():
+            return False
+        check = BaseAudit(unless=callback)
+        take_action = check._take_action()
+        self.assertTrue(take_action)
+
+    def test_take_action_unless_callback_true(self):
+        def callback():
+            return True
+        check = BaseAudit(unless=callback)
+        take_action = check._take_action()
+        self.assertFalse(take_action)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_file_audits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_file_audits.py
new file mode 100644
index 0000000000000000000000000000000000000000..8718f6115dbaddeab44d8fe9fb9c9f6ffec17091
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/audits/test_file_audits.py
@@ -0,0 +1,334 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import shutil
+import tempfile
+
+from mock import call, patch
+
+from unittest import TestCase
+
+from charmhelpers.core import unitdata
+from charmhelpers.contrib.hardening.audits import file
+
+
+@patch('os.path.exists')
+class BaseFileAuditTestCase(TestCase):
+
+    def setUp(self):
+        super(BaseFileAuditTestCase, self).setUp()
+        self._patch_obj(file.BaseFileAudit, 'is_compliant')
+        self._patch_obj(file.BaseFileAudit, 'comply')
+        self._patch_obj(file, 'log')
+
+    def _patch_obj(self, obj, method):
+        _m = patch.object(obj, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def test_ensure_compliance(self, mock_exists):
+        mock_exists.return_value = False
+        check = file.BaseFileAudit(paths='/tmp/foo')
+        check.ensure_compliance()
+        self.assertFalse(self.comply.called)
+
+    def test_ensure_compliance_in_compliance(self, mock_exists):
+        mock_exists.return_value = True
+        self.is_compliant.return_value = True
+        check = file.BaseFileAudit(paths=['/tmp/foo'])
+        check.ensure_compliance()
+        mock_exists.assert_has_calls([call('/tmp/foo')])
+        self.is_compliant.assert_has_calls([call('/tmp/foo')])
+        self.assertFalse(self.log.called)
+        self.assertFalse(self.comply.called)
+
+    def test_ensure_compliance_out_of_compliance(self, mock_exists):
+        mock_exists.return_value = True
+        self.is_compliant.return_value = False
+        check = file.BaseFileAudit(paths=['/tmp/foo'])
+        check.ensure_compliance()
+        mock_exists.assert_has_calls([call('/tmp/foo')])
+        self.is_compliant.assert_has_calls([call('/tmp/foo')])
+        self.assertTrue(self.log.called)
+        self.comply.assert_has_calls([call('/tmp/foo')])
+
+
+class EasyMock(dict):
+    __getattr__ = dict.__getitem__
+    __setattr__ = dict.__setitem__
+
+
+class FilePermissionAuditTestCase(TestCase):
+    def setUp(self):
+        super(FilePermissionAuditTestCase, self).setUp()
+        self._patch_obj(file.grp, 'getgrnam')
+        self._patch_obj(file.pwd, 'getpwnam')
+        self._patch_obj(file.FilePermissionAudit, '_get_stat')
+        self.getpwnam.return_value = EasyMock({'pw_name': 'testuser',
+                                               'pw_uid': 1000})
+        self.getgrnam.return_value = EasyMock({'gr_name': 'testgroup',
+                                               'gr_gid': 1000})
+        self._get_stat.return_value = EasyMock({'st_mode': 0o644,
+                                                'st_uid': 1000,
+                                                'st_gid': 1000})
+
+    def _patch_obj(self, obj, method):
+        _m = patch.object(obj, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def test_is_compliant(self):
+        check = file.FilePermissionAudit(paths=['/foo/bar'],
+                                         user='testuser',
+                                         group='testgroup', mode=0o644)
+        compliant = check.is_compliant('/foo/bar')
+        self.assertTrue(compliant)
+
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_not_compliant_wrong_group(self):
+        self.getgrnam.return_value = EasyMock({'gr_name': 'testgroup',
+                                               'gr_gid': 222})
+        check = file.FilePermissionAudit(paths=['/foo/bar'], user='testuser',
+                                         group='testgroup', mode=0o644)
+        compliant = check.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_not_compliant_wrong_user(self):
+        self.getpwnam.return_value = EasyMock({'pw_name': 'fred',
+                                               'pw_uid': 123})
+        check = file.FilePermissionAudit(paths=['/foo/bar'], user='testuser',
+                                         group='testgroup', mode=0o644)
+        compliant = check.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_not_compliant_wrong_permissions(self):
+        self._get_stat.return_value = EasyMock({'st_mode': 0o777,
+                                                'st_uid': 1000,
+                                                'st_gid': 1000})
+        check = file.FilePermissionAudit(paths=['/foo/bar'], user='testuser',
+                                         group='testgroup', mode=0o644)
+        compliant = check.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch('charmhelpers.contrib.hardening.utils.ensure_permissions')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_comply(self, _ensure_permissions):
+        check = file.FilePermissionAudit(paths=['/foo/bar'], user='testuser',
+                                         group='testgroup', mode=0o644)
+        check.comply('/foo/bar')
+        c = call('/foo/bar', 'testuser', 'testgroup', 0o644)
+        _ensure_permissions.assert_has_calls([c])
+
+
+class DirectoryPermissionAuditTestCase(TestCase):
+    def setUp(self):
+        super(DirectoryPermissionAuditTestCase, self).setUp()
+
+    @patch('charmhelpers.contrib.hardening.audits.file.os.path.isdir')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_compliant_not_directory(self, mock_isdir):
+        mock_isdir.return_value = False
+        check = file.DirectoryPermissionAudit(paths=['/foo/bar'],
+                                              user='testuser',
+                                              group='testgroup', mode=0o0700)
+        self.assertRaises(ValueError, check.is_compliant, '/foo/bar')
+
+    @patch.object(file.FilePermissionAudit, 'is_compliant')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_compliant_file_not_compliant(self, mock_is_compliant):
+        mock_is_compliant.return_value = False
+        tmpdir = tempfile.mkdtemp()
+        try:
+            check = file.DirectoryPermissionAudit(paths=[tmpdir],
+                                                  user='testuser',
+                                                  group='testgroup',
+                                                  mode=0o0700)
+            compliant = check.is_compliant(tmpdir)
+            self.assertFalse(compliant)
+        finally:
+            shutil.rmtree(tmpdir)
+
+
+class NoSUIDGUIDAuditTestCase(TestCase):
+    def setUp(self):
+        super(NoSUIDGUIDAuditTestCase, self).setUp()
+
+    @patch.object(file.NoSUIDSGIDAudit, '_get_stat')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_compliant(self, mock_get_stat):
+        mock_get_stat.return_value = EasyMock({'st_mode': 0o0644,
+                                               'st_uid': 0,
+                                               'st_gid': 0})
+        audit = file.NoSUIDSGIDAudit('/foo/bar')
+        compliant = audit.is_compliant('/foo/bar')
+        self.assertTrue(compliant)
+
+    @patch.object(file.NoSUIDSGIDAudit, '_get_stat')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_noncompliant(self, mock_get_stat):
+        mock_get_stat.return_value = EasyMock({'st_mode': 0o6644,
+                                               'st_uid': 0,
+                                               'st_gid': 0})
+        audit = file.NoSUIDSGIDAudit('/foo/bar')
+        compliant = audit.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch.object(file, 'log')
+    @patch.object(file, 'check_output')
+    def test_comply(self, mock_check_output, mock_log):
+        audit = file.NoSUIDSGIDAudit('/foo/bar')
+        audit.comply('/foo/bar')
+        mock_check_output.assert_has_calls([call(['chmod', '-s', '/foo/bar'])])
+        self.assertTrue(mock_log.called)
+
+
+class TemplatedFileTestCase(TestCase):
+    def setUp(self):
+        super(TemplatedFileTestCase, self).setUp()
+        self.kv = patch.object(unitdata, 'kv')
+        self.kv.start()
+        self.addCleanup(self.kv.stop)
+
+    @patch.object(file.TemplatedFile, 'templates_match')
+    @patch.object(file.TemplatedFile, 'contents_match')
+    @patch.object(file.TemplatedFile, 'permissions_match')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_not_compliant(self, contents_match_, permissions_match_,
+                              templates_match_):
+        contents_match_.return_value = False
+        permissions_match_.return_value = False
+        templates_match_.return_value = False
+
+        f = file.TemplatedFile('/foo/bar', None, '/tmp', 0o0644)
+        compliant = f.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch.object(file.TemplatedFile, 'templates_match')
+    @patch.object(file.TemplatedFile, 'contents_match')
+    @patch.object(file.TemplatedFile, 'permissions_match')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_is_compliant(self, contents_match_, permissions_match_,
+                          templates_match_):
+        contents_match_.return_value = True
+        permissions_match_.return_value = True
+        templates_match_.return_value = True
+
+        f = file.TemplatedFile('/foo/bar', None, '/tmp', 0o0644)
+        compliant = f.is_compliant('/foo/bar')
+        self.assertTrue(compliant)
+
+    @patch.object(file.TemplatedFile, 'templates_match')
+    @patch.object(file.TemplatedFile, 'contents_match')
+    @patch.object(file.TemplatedFile, 'permissions_match')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_template_changes(self, contents_match_, permissions_match_,
+                              templates_match_):
+        contents_match_.return_value = True
+        permissions_match_.return_value = True
+        templates_match_.return_value = False
+
+        f = file.TemplatedFile('/foo/bar', None, '/tmp', 0o0644)
+        compliant = f.is_compliant('/foo/bar')
+        self.assertFalse(compliant)
+
+    @patch.object(file, 'render_and_write')
+    @patch.object(file.utils, 'ensure_permissions')
+    @patch.object(file, 'log', lambda *args, **kwargs: None)
+    def test_comply(self, mock_ensure_permissions, mock_render_and_write):
+        class Context(object):
+            def __call__(self):
+                return {}
+        with tempfile.NamedTemporaryFile() as ftmp:
+            f = file.TemplatedFile(ftmp.name, Context(),
+                                   os.path.dirname(ftmp.name), 0o0644)
+            f.comply(ftmp.name)
+            calls = [call(os.path.dirname(ftmp.name), ftmp.name, {})]
+            mock_render_and_write.assert_has_calls(calls)
+            mock_ensure_permissions.assert_has_calls([call(ftmp.name, 'root',
+                                                           'root', 0o0644)])
+
+
+CONTENTS_PASS = """Ciphers aes256-ctr,aes192-ctr,aes128-ctr
+MACs hmac-sha2-512,hmac-sha2-256,hmac-ripemd160
+KexAlgorithms diffie-hellman-group-exchange-sha256
+"""
+
+
+CONTENTS_FAIL = """Ciphers aes256-ctr,aes192-ctr,aes128-ctr
+MACs hmac-sha2-512,hmac-sha2-256,hmac-ripemd160
+KexAlgorithms diffie-hellman-group-exchange-sha256,diffie-hellman-group14-sha1,diffie-hellman-group-exchange-sha1,diffie-hellman-group1-sha1
+"""
+
+
+class FileContentAuditTestCase(TestCase):
+
+    @patch.object(file, 'log')
+    def test_audit_contents_pass(self, mock_log):
+        conditions = {'pass':
+                      [r'^KexAlgorithms\s+diffie-hellman-group-exchange-'
+                       'sha256$'],
+                      'fail': [r'^KexAlgorithms\s+diffie-hellman-group-'
+                               'exchange-sha256.+$']}
+        with tempfile.NamedTemporaryFile() as ftmp:
+            filename = ftmp.name
+            with open(filename, 'w') as fd:
+                fd.write(CONTENTS_FAIL)
+
+            audit = file.FileContentAudit(filename, conditions)
+            self.assertFalse(audit.is_compliant(filename))
+
+        calls = [call("Auditing contents of file '%s'" % filename,
+                      level='DEBUG'),
+                 call("Pattern '^KexAlgorithms\\s+diffie-hellman-group-"
+                      "exchange-sha256$' was expected to pass but instead it "
+                      "failed", level='WARNING'),
+                 call("Pattern '^KexAlgorithms\\s+diffie-hellman-group-"
+                      "exchange-sha256.+$' was expected to fail but instead "
+                      "it passed", level='WARNING'),
+                 call('Checked 2 cases and 0 passed', level='DEBUG')]
+        mock_log.assert_has_calls(calls)
+
+    @patch.object(file, 'log')
+    def test_audit_contents_fail(self, mock_log):
+        conditions = {'pass':
+                      [r'^KexAlgorithms\s+diffie-hellman-group-exchange-'
+                       'sha256$'],
+                      'fail':
+                      [r'^KexAlgorithms\s+diffie-hellman-group-exchange-'
+                       'sha256.+$']}
+        with tempfile.NamedTemporaryFile() as ftmp:
+            filename = ftmp.name
+            with open(filename, 'w') as fd:
+                fd.write(CONTENTS_FAIL)
+
+            audit = file.FileContentAudit(filename, conditions)
+            self.assertFalse(audit.is_compliant(filename))
+
+        calls = [call("Auditing contents of file '%s'" % filename,
+                      level='DEBUG'),
+                 call("Pattern '^KexAlgorithms\\s+diffie-hellman-group-"
+                      "exchange-sha256$' was expected to pass but instead "
+                      "it failed",
+                      level='WARNING'),
+                 call("Pattern '^KexAlgorithms\\s+diffie-hellman-group-"
+                      "exchange-sha256.+$' was expected to fail but instead "
+                      "it passed",
+                      level='WARNING'),
+                 call('Checked 2 cases and 0 passed', level='DEBUG')]
+        mock_log.assert_has_calls(calls)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0f940d4cfa85ca7051dd60a4805d84bb6aebed6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml
@@ -0,0 +1,16 @@
+# NOTE: this file contains the default configuration for the 'apache' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'apache' as the root key followed by any of the following with new
+#       values.
+
+common:
+    apache_dir: '/etc/apache2'
+
+hardening:
+    traceenable: 'off'
+    allowed_http_methods: "GET POST"
+    modules_to_disable: [ cgi, cgid ]
+    servertokens: 'Prod'
+    honor_cipher_order: 'on'
+    cipher_suite: 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..c112137cb45c4b63cb05384145b3edf8c443e2b8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/apache.yaml.schema
@@ -0,0 +1,12 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    apache_dir:
+    traceenable:
+
+hardening:
+    allowed_http_methods:
+    modules_to_disable:
+    servertokens:
+    honor_cipher_order:
+    cipher_suite:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..682d22bf3ded32eb1c8d6188486ec4468d9ec457
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml
@@ -0,0 +1,38 @@
+# NOTE: this file contains the default configuration for the 'mysql' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'mysql' as the root key followed by any of the following with new
+#       values.
+
+hardening:
+    mysql-conf: /etc/mysql/my.cnf
+    hardening-conf: /etc/mysql/conf.d/hardening.cnf
+
+security:
+    # @see http://www.symantec.com/connect/articles/securing-mysql-step-step
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_chroot
+    chroot: None
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_safe-user-create
+    safe-user-create: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-auth
+    secure-auth: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_symbolic-links
+    skip-symbolic-links: 1
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_skip-show-database
+    skip-show-database: True
+
+    # @see http://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_local_infile
+    local-infile: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_allow-suspicious-udfs
+    allow-suspicious-udfs: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_automatic_sp_privileges
+    automatic-sp-privileges: 0
+
+    # @see https://dev.mysql.com/doc/refman/5.7/en/server-options.html#option_mysqld_secure-file-priv
+    secure-file-priv: /tmp
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..2edf325c311c6fbb062a072083b4d12cebc3d9c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/mysql.yaml.schema
@@ -0,0 +1,15 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+hardening:
+    mysql-conf:
+    hardening-conf:
+security:
+    chroot:
+    safe-user-create:
+    secure-auth:
+    skip-symbolic-links:
+    skip-show-database:
+    local-infile:
+    allow-suspicious-udfs:
+    automatic-sp-privileges:
+    secure-file-priv:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9a8627b5ed2803828e1e4d78260c6b5f90cae659
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml
@@ -0,0 +1,68 @@
+# NOTE: this file contains the default configuration for the 'os' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'os' as the root key followed by any of the following with new
+#       values.
+
+general:
+    desktop_enable: False  # (type:boolean)
+
+environment:
+    extra_user_paths: []
+    umask: 027
+    root_path: /
+
+auth:
+    pw_max_age: 60
+    # discourage password cycling
+    pw_min_age: 7
+    retries: 5
+    lockout_time: 600
+    timeout: 60
+    allow_homeless: False  # (type:boolean)
+    pam_passwdqc_enable: True  # (type:boolean)
+    pam_passwdqc_options: 'min=disabled,disabled,16,12,8'
+    root_ttys:
+        console
+        tty1
+        tty2
+        tty3
+        tty4
+        tty5
+        tty6
+    uid_min: 1000
+    gid_min: 1000
+    sys_uid_min: 100
+    sys_uid_max: 999
+    sys_gid_min: 100
+    sys_gid_max: 999
+    chfn_restrict:
+
+security:
+    users_allow: []
+    suid_sgid_enforce: True  # (type:boolean)
+    # user-defined blacklist and whitelist
+    suid_sgid_blacklist: []
+    suid_sgid_whitelist: []
+    # if this is True, remove any suid/sgid bits from files that were not in the whitelist
+    suid_sgid_dry_run_on_unknown: False  # (type:boolean)
+    suid_sgid_remove_from_unknown: False  # (type:boolean)
+    # remove packages with known issues
+    packages_clean: True  # (type:boolean)
+    packages_list:
+        xinetd
+        inetd
+        ypserv
+        telnet-server
+        rsh-server
+        rsync
+    kernel_enable_module_loading: True  # (type:boolean)
+    kernel_enable_core_dump: False  # (type:boolean)
+    ssh_tmout: 300
+
+sysctl:
+    kernel_secure_sysrq: 244  # 4 + 16 + 32 + 64 + 128
+    kernel_enable_sysrq: False  # (type:boolean)
+    forwarding: False  # (type:boolean)
+    ipv6_enable: False  # (type:boolean)
+    arp_restricted: True  # (type:boolean)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..cc3b9c206eae56cbe68826cb76748e2deb9483e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/os.yaml.schema
@@ -0,0 +1,43 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+general:
+    desktop_enable:
+environment:
+    extra_user_paths:
+    umask:
+    root_path:
+auth:
+    pw_max_age:
+    pw_min_age:
+    retries:
+    lockout_time:
+    timeout:
+    allow_homeless:
+    pam_passwdqc_enable:
+    pam_passwdqc_options:
+    root_ttys:
+    uid_min:
+    gid_min:
+    sys_uid_min:
+    sys_uid_max:
+    sys_gid_min:
+    sys_gid_max:
+    chfn_restrict:
+security:
+    users_allow:
+    suid_sgid_enforce:
+    suid_sgid_blacklist:
+    suid_sgid_whitelist:
+    suid_sgid_dry_run_on_unknown:
+    suid_sgid_remove_from_unknown:
+    packages_clean:
+    packages_list:
+    kernel_enable_module_loading:
+    kernel_enable_core_dump:
+    ssh_tmout:
+sysctl:
+    kernel_secure_sysrq:
+    kernel_enable_sysrq:
+    forwarding:
+    ipv6_enable:
+    arp_restricted:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cd529bcae1ec00fef2e969f43dc3cf530b46ef9a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml
@@ -0,0 +1,49 @@
+# NOTE: this file contains the default configuration for the 'ssh' hardening
+#       code. If you want to override any settings you must add them to a file
+#       called hardening.yaml in the root directory of your charm using the
+#       name 'ssh' as the root key followed by any of the following with new
+#       values.
+
+common:
+    service_name: 'ssh'
+    network_ipv6_enable: False  # (type:boolean)
+    ports: [22]
+    remote_hosts: []
+
+client:
+    package: 'openssh-client'
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    roaming: False
+    password_authentication: 'no'
+
+server:
+    host_key_files: ['/etc/ssh/ssh_host_rsa_key', '/etc/ssh/ssh_host_dsa_key',
+                     '/etc/ssh/ssh_host_ecdsa_key']
+    cbc_required: False  # (type:boolean)
+    weak_hmac: False  # (type:boolean)
+    weak_kex: False  # (type:boolean)
+    allow_root_with_key: False  # (type:boolean)
+    allow_tcp_forwarding: 'no'
+    allow_agent_forwarding: 'no'
+    allow_x11_forwarding: 'no'
+    use_privilege_separation: 'sandbox'
+    listen_to: ['0.0.0.0']
+    use_pam: 'no'
+    package: 'openssh-server'
+    password_authentication: 'no'
+    alive_interval: '600'
+    alive_count: '3'
+    sftp_enable: False  # (type:boolean)
+    sftp_group: 'sftponly'
+    sftp_chroot: '/home/%u'
+    deny_users: []
+    allow_users: []
+    deny_groups: []
+    allow_groups: []
+    print_motd: 'no'
+    print_last_log: 'no'
+    use_dns: 'no'
+    max_auth_tries: 2
+    max_sessions: 10
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml.schema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml.schema
new file mode 100644
index 0000000000000000000000000000000000000000..d05e054bc234015206bb1195152fa9ffd6a33151
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/defaults/ssh.yaml.schema
@@ -0,0 +1,42 @@
+# NOTE: this schema must contain all valid keys from it's associated defaults
+#       file. It is used to validate user-provided overrides.
+common:
+    service_name:
+    network_ipv6_enable:
+    ports:
+    remote_hosts:
+client:
+    package:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    roaming:
+    password_authentication:
+server:
+    host_key_files:
+    cbc_required:
+    weak_hmac:
+    weak_kex:
+    allow_root_with_key:
+    allow_tcp_forwarding:
+    allow_agent_forwarding:
+    allow_x11_forwarding:
+    use_privilege_separation:
+    listen_to:
+    use_pam:
+    package:
+    password_authentication:
+    alive_interval:
+    alive_count:
+    sftp_enable:
+    sftp_group:
+    sftp_chroot:
+    deny_users:
+    allow_users:
+    deny_groups:
+    allow_groups:
+    print_motd:
+    print_last_log:
+    use_dns:
+    max_auth_tries:
+    max_sessions:
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_apt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_apt.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea7ed8ea729f0e4d6f5f2ddf8561b56f97c299ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_apt.py
@@ -0,0 +1,46 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import apt
+
+
+class AptHardeningTestCase(TestCase):
+
+    @patch.object(apt, 'get_settings', lambda x: {
+        'security': {'packages_clean': False}
+    })
+    def test_dont_clean_packages(self):
+        audits = apt.get_audits()
+        self.assertEqual(1, len(audits))
+
+    @patch.object(apt, 'get_settings', lambda x: {
+        'security': {'packages_clean': True,
+                     'packages_list': []}
+    })
+    def test_no_security_packages(self):
+        audits = apt.get_audits()
+        self.assertEqual(1, len(audits))
+
+    @patch.object(apt, 'get_settings', lambda x: {
+        'security': {'packages_clean': True,
+                     'packages_list': ['foo', 'bar']}
+    })
+    def test_restricted_packages(self):
+        audits = apt.get_audits()
+        self.assertEqual(2, len(audits))
+        self.assertTrue(isinstance(audits[1], apt.RestrictedPackages))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_limits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_limits.py
new file mode 100644
index 0000000000000000000000000000000000000000..0750fdef2b23ac343cd7ac05b08ab4dae784343e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_limits.py
@@ -0,0 +1,43 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import limits
+
+
+class LimitsTestCase(TestCase):
+
+    @patch.object(limits.utils, 'get_settings',
+                  lambda x: {'security': {'kernel_enable_core_dump': False}})
+    def test_core_dump_disabled(self):
+        audits = limits.get_audits()
+        self.assertEqual(2, len(audits))
+        audit = audits[0]
+        self.assertTrue(isinstance(audit, limits.DirectoryPermissionAudit))
+        self.assertEqual('/etc/security/limits.d', audit.paths[0])
+        audit = audits[1]
+        self.assertTrue(isinstance(audit, limits.TemplatedFile))
+        self.assertEqual('/etc/security/limits.d/10.hardcore.conf',
+                         audit.paths[0])
+
+    @patch.object(limits.utils, 'get_settings', lambda x: {
+        'security': {'kernel_enable_core_dump': True}
+    })
+    def test_core_dump_enabled(self):
+        audits = limits.get_audits()
+        self.assertEqual(1, len(audits))
+        self.assertTrue(isinstance(audits[0], limits.DirectoryPermissionAudit))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_login.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_login.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3c6fc85224356faa2b49c8121786d8754662c49
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_login.py
@@ -0,0 +1,27 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening.host.checks import login
+
+
+class LoginTestCase(TestCase):
+
+    def test_login(self):
+        audits = login.get_audits()
+        self.assertEqual(1, len(audits))
+        audit = audits[0]
+        self.assertTrue(isinstance(audit, login.TemplatedFile))
+        self.assertEqual('/etc/login.defs', audit.paths[0])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_minimize_access.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_minimize_access.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e3838778907289cbe83b0d7b53e525965ff3ec1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_minimize_access.py
@@ -0,0 +1,68 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import minimize_access
+
+
+class MinimizeAccessTestCase(TestCase):
+
+    @patch.object(minimize_access.utils, 'get_settings', lambda x:
+                  {'environment': {'extra_user_paths': []},
+                   'security': {'users_allow': []}})
+    def test_default_options(self):
+        audits = minimize_access.get_audits()
+        self.assertEqual(3, len(audits))
+
+        # First audit is to ensure that all folders in the $PATH variable
+        # are read-only.
+        self.assertTrue(isinstance(audits[0], minimize_access.ReadOnly))
+        self.assertEqual({'/usr/local/sbin', '/usr/local/bin',
+                          '/usr/sbin', '/usr/bin', '/bin'}, audits[0].paths)
+
+        # Second audit is to ensure that the /etc/shadow is only readable
+        # by the root user.
+        self.assertTrue(isinstance(audits[1],
+                                   minimize_access.FilePermissionAudit))
+        self.assertEqual(audits[1].paths[0], '/etc/shadow')
+        self.assertEqual(audits[1].mode, 0o0600)
+
+        # Last audit is to ensure that only root has access to the su
+        self.assertTrue(isinstance(audits[2],
+                                   minimize_access.FilePermissionAudit))
+        self.assertEqual(audits[2].paths[0], '/bin/su')
+        self.assertEqual(audits[2].mode, 0o0750)
+
+    @patch.object(minimize_access.utils, 'get_settings', lambda x:
+                  {'environment': {'extra_user_paths': []},
+                   'security': {'users_allow': ['change_user']}})
+    def test_allow_change_user(self):
+        audits = minimize_access.get_audits()
+        self.assertEqual(2, len(audits))
+
+        # First audit is to ensure that all folders in the $PATH variable
+        # are read-only.
+        self.assertTrue(isinstance(audits[0], minimize_access.ReadOnly))
+        self.assertEqual({'/usr/local/sbin', '/usr/local/bin',
+                          '/usr/sbin', '/usr/bin', '/bin'}, audits[0].paths)
+
+        # Second audit is to ensure that the /etc/shadow is only readable
+        # by the root user.
+        self.assertTrue(isinstance(audits[1],
+                                   minimize_access.FilePermissionAudit))
+        self.assertEqual(audits[1].paths[0], '/etc/shadow')
+        self.assertEqual(audits[1].mode, 0o0600)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_pam.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_pam.py
new file mode 100644
index 0000000000000000000000000000000000000000..2879bc87ec127e04222f4fc8e1a7568cf8985cc0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_pam.py
@@ -0,0 +1,53 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import pam
+
+
+class PAMTestCase(TestCase):
+
+    @patch.object(pam.utils, 'get_settings', lambda x: {
+        'auth': {'pam_passwdqc_enable': True,
+                 'retries': False}
+    })
+    def test_enable_passwdqc(self):
+        audits = pam.get_audits()
+        self.assertEqual(2, len(audits))
+        audit = audits[0]
+        self.assertTrue(isinstance(audit, pam.PasswdqcPAM))
+        audit = audits[1]
+        self.assertTrue(isinstance(audit, pam.DeletedFile))
+        self.assertEqual('/usr/share/pam-configs/tally2', audit.paths[0])
+
+    @patch.object(pam.utils, 'get_settings', lambda x: {
+        'auth': {'pam_passwdqc_enable': False,
+                 'retries': True}
+    })
+    def test_disable_passwdqc(self):
+        audits = pam.get_audits()
+        self.assertEqual(1, len(audits))
+        self.assertFalse(isinstance(audits[0], pam.PasswdqcPAM))
+
+    @patch.object(pam.utils, 'get_settings', lambda x: {
+        'auth': {'pam_passwdqc_enable': False,
+                 'retries': True}
+    })
+    def test_auth_retries(self):
+        audits = pam.get_audits()
+        self.assertEqual(1, len(audits))
+        self.assertTrue(isinstance(audits[0], pam.Tally2PAM))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_profile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_profile.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d7fc99bdb2ec86ecf02bb3b0a3d7b01c179730e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_profile.py
@@ -0,0 +1,65 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import profile
+
+
+class ProfileTestCase(TestCase):
+
+    def setUp(self):
+        super(ProfileTestCase, self).setUp()
+
+        os.environ['JUJU_CHARM_DIR'] = '/tmp'
+        self.addCleanup(lambda: os.environ.pop('JUJU_CHARM_DIR'))
+
+    @patch.object(profile.utils, 'get_settings', lambda x:
+                  {'security': {'kernel_enable_core_dump': False, 'ssh_tmout': False}})
+    def test_core_dump_disabled(self):
+        audits = profile.get_audits()
+        self.assertEqual(1, len(audits))
+        self.assertTrue(isinstance(audits[0], profile.TemplatedFile))
+
+    @patch.object(profile.utils, 'get_settings', lambda x: {
+        'security': {'kernel_enable_core_dump': True, 'ssh_tmout': False}
+    })
+    def test_core_dump_enabled(self):
+        audits = profile.get_audits()
+        self.assertEqual(0, len(audits))
+
+    @patch.object(profile.utils, 'get_settings', lambda x:
+                  {'security': {'kernel_enable_core_dump': True, 'ssh_tmout': False}})
+    def test_ssh_tmout_disabled(self):
+        audits = profile.get_audits()
+        self.assertEqual(0, len(audits))
+
+    @patch.object(profile.utils, 'get_settings', lambda x: {
+        'security': {'kernel_enable_core_dump': True, 'ssh_tmout': 300}
+    })
+    def test_ssh_tmout_enabled(self):
+        audits = profile.get_audits()
+        self.assertEqual(1, len(audits))
+        self.assertTrue(isinstance(audits[0], profile.TemplatedFile))
+
+    @patch.object(profile.utils, 'log', lambda *args, **kwargs: None)
+    def test_ProfileContext(self):
+        ctxt = profile.ProfileContext()
+        self.assertEqual(ctxt(), {
+            'ssh_tmout': 300
+        })
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_securetty.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_securetty.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c5d7acd94550bf1e8929e415b7ef05ff96378b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_securetty.py
@@ -0,0 +1,27 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening.host.checks import securetty
+
+
+class SecureTTYTestCase(TestCase):
+
+    def test_securetty(self):
+        audits = securetty.get_audits()
+        self.assertEqual(1, len(audits))
+        audit = audits[0]
+        self.assertTrue(isinstance(audit, securetty.TemplatedFile))
+        self.assertEqual('/etc/securetty', audit.paths[0])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_suid_guid.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_suid_guid.py
new file mode 100644
index 0000000000000000000000000000000000000000..96f78b28b35ee9a58d9117bb0b3552d6841a69b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/host/checks/test_suid_guid.py
@@ -0,0 +1,55 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import tempfile
+
+from unittest import TestCase
+
+from mock import call
+from mock import patch
+
+from charmhelpers.contrib.hardening.host.checks import suid_sgid
+
+
+@patch.object(suid_sgid, 'log', lambda *args, **kwargs: None)
+class SUIDSGIDTestCase(TestCase):
+
+    @patch.object(suid_sgid.utils, 'get_settings', lambda x: {
+        'security': {'suid_sgid_enforce': False}
+    })
+    def test_no_enforcement(self):
+        audits = suid_sgid.get_audits()
+        self.assertEqual(0, len(audits))
+
+    @patch.object(suid_sgid, 'subprocess')
+    @patch.object(suid_sgid.utils, 'get_settings', lambda x: {
+        'security': {'suid_sgid_enforce': True,
+                     'suid_sgid_remove_from_unknown': True,
+                     'suid_sgid_blacklist': [],
+                     'suid_sgid_whitelist': [],
+                     'suid_sgid_dry_run_on_unknown': True},
+        'environment': {'root_path': '/'}
+    })
+    def test_suid_guid_harden(self, mock_subprocess):
+        p = mock_subprocess.Popen.return_value
+        with tempfile.NamedTemporaryFile() as tmp:
+            p.communicate.return_value = (tmp.name, "stderr")
+
+        audits = suid_sgid.get_audits()
+        self.assertEqual(2, len(audits))
+        cmd = ['find', '/', '-perm', '-4000', '-o', '-perm', '-2000', '-type',
+               'f', '!', '-path', '/proc/*', '-print']
+        calls = [call(cmd, stderr=mock_subprocess.PIPE,
+                      stdout=mock_subprocess.PIPE)]
+        mock_subprocess.Popen.assert_has_calls(calls)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/checks/test_config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/checks/test_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..af015f6aaa1f902fcc97c1e95d31a623246a1fa4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/mysql/checks/test_config.py
@@ -0,0 +1,33 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from unittest import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.mysql.checks import config
+
+
+class MySQLConfigTestCase(TestCase):
+
+    @patch.object(config.subprocess, 'call', lambda *args, **kwargs: 0)
+    @patch.object(config.utils, 'get_settings', lambda x: {
+        'hardening': {
+            'mysql-conf': {},
+            'hardening-conf': {}
+        }
+    })
+    def test_get_audits(self):
+        audits = config.get_audits()
+        self.assertEqual(4, len(audits))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/checks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/checks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/checks/test_config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/checks/test_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..49cea4e3be6f6156d4549c265016fe68cd9c31ca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/ssh/checks/test_config.py
@@ -0,0 +1,27 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from testtools import TestCase
+
+from mock import patch
+
+from charmhelpers.contrib.hardening.ssh.checks import config
+
+
+class SSHConfigTestCase(TestCase):
+
+    @patch.object(config.utils, 'get_settings', lambda x: {})
+    def test_dont_clean_packages(self):
+        audits = config.get_audits()
+        self.assertEqual(4, len(audits))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_defaults.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..35baa2bedda1329d37b5a4c08446a6e93ecbfbd8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_defaults.py
@@ -0,0 +1,58 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import glob
+import yaml
+
+from unittest import TestCase
+
+TEMPLATES_DIR = os.path.join(os.path.dirname(__file__), 'defaults')
+
+
+class DefaultsTestCase(TestCase):
+
+    def setUp(self):
+        super(DefaultsTestCase, self).setUp()
+
+    def get_keys(self, dicto, keys=None):
+        if keys is None:
+            keys = []
+
+        if dicto:
+            if type(dicto) is not dict:
+                raise Exception("Unexpected entry: %s" % dicto)
+
+            for key in dicto.keys():
+                keys.append(key)
+                if type(dicto[key]) is dict:
+                    self.get_keys(dicto[key], keys)
+
+        return keys
+
+    def test_defaults(self):
+        defaults_paths = glob.glob('%s/*.yaml' % TEMPLATES_DIR)
+        for defaults in defaults_paths:
+            schema = "%s.schema" % defaults
+            self.assertTrue(os.path.exists(schema))
+            a = yaml.safe_load(open(schema))
+            b = yaml.safe_load(open(defaults))
+            if not a and not b:
+                continue
+
+            # Test that all keys in default are present in their associated
+            # schema.
+            skeys = self.get_keys(a)
+            dkeys = self.get_keys(b)
+            self.assertEqual(set(dkeys).symmetric_difference(skeys), set([]))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_harden.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_harden.py
new file mode 100644
index 0000000000000000000000000000000000000000..25364350ba9bca1546042c6246d21d4018de02e9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_harden.py
@@ -0,0 +1,81 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from mock import patch, call
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening import harden
+
+
+class HardenTestCase(TestCase):
+
+    def setUp(self):
+        super(HardenTestCase, self).setUp()
+
+    @patch.object(harden, 'log', lambda *args, **kwargs: None)
+    @patch.object(harden, 'run_apache_checks')
+    @patch.object(harden, 'run_mysql_checks')
+    @patch.object(harden, 'run_ssh_checks')
+    @patch.object(harden, 'run_os_checks')
+    def test_harden(self, mock_host, mock_ssh, mock_mysql, mock_apache):
+        mock_host.__name__ = 'host'
+        mock_ssh.__name__ = 'ssh'
+        mock_mysql.__name__ = 'mysql'
+        mock_apache.__name__ = 'apache'
+
+        @harden.harden(overrides=['ssh', 'mysql'])
+        def foo(arg1, kwarg1=None):
+            return "done."
+
+        self.assertEqual(foo('anarg', kwarg1='akwarg'), "done.")
+        self.assertTrue(mock_ssh.called)
+        self.assertTrue(mock_mysql.called)
+        self.assertFalse(mock_apache.called)
+        self.assertFalse(mock_host.called)
+
+    @patch.object(harden, 'log')
+    @patch.object(harden, 'run_apache_checks')
+    @patch.object(harden, 'run_mysql_checks')
+    @patch.object(harden, 'run_ssh_checks')
+    @patch.object(harden, 'run_os_checks')
+    def test_harden_logs_work(self, mock_host, mock_ssh, mock_mysql,
+                              mock_apache, mock_log):
+        mock_host.__name__ = 'host'
+        mock_ssh.__name__ = 'ssh'
+        mock_mysql.__name__ = 'mysql'
+        mock_apache.__name__ = 'apache'
+
+        @harden.harden(overrides=['ssh', 'mysql'])
+        def foo(arg1, kwarg1=None):
+            return arg1 + kwarg1
+
+        mock_log.assert_not_called()
+        self.assertEqual(foo('anarg', kwarg1='akwarg'), "anargakwarg")
+        mock_log.assert_any_call("Hardening function 'foo'", level="DEBUG")
+
+        @harden.harden(overrides=['ssh', 'mysql'])
+        def bar(arg1, kwarg1=None):
+            return arg1 + kwarg1
+
+        mock_log.reset_mock()
+        self.assertEqual(bar("a", kwarg1="b"), "ab")
+        mock_log.assert_any_call("Hardening function 'bar'", level="DEBUG")
+
+        # check it only logs the function name once
+        mock_log.reset_mock()
+        self.assertEqual(bar("a", kwarg1="b"), "ab")
+        self.assertEqual(
+            mock_log.call_args_list,
+            [call("Executing hardening module 'ssh'", level="DEBUG"),
+             call("Executing hardening module 'mysql'", level="DEBUG")])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a2f26d783fe712469e2d11f3f9afbf53b8d7bc0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_templating.py
@@ -0,0 +1,310 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import tempfile
+import os
+import six
+
+from mock import call, patch
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening import templating
+from charmhelpers.contrib.hardening import utils
+from charmhelpers.contrib.hardening.audits.file import (
+    TemplatedFile,
+    FileContentAudit,
+)
+from charmhelpers.contrib.hardening.ssh.checks import (
+    config as ssh_config_check
+)
+from charmhelpers.contrib.hardening.host.checks import (
+    sysctl,
+    securetty,
+)
+from charmhelpers.contrib.hardening.apache.checks import (
+    config as apache_config_check
+)
+from charmhelpers.contrib.hardening.mysql.checks import (
+    config as mysql_config_check
+)
+
+
+class TemplatingTestCase(TestCase):
+
+    def setUp(self):
+        super(TemplatingTestCase, self).setUp()
+
+        os.environ['JUJU_CHARM_DIR'] = '/tmp'
+        self.pathindex = {}
+        self.addCleanup(lambda: os.environ.pop('JUJU_CHARM_DIR'))
+
+    def get_renderers(self, audits):
+        renderers = []
+        for a in audits:
+            if issubclass(a.__class__, TemplatedFile):
+                renderers.append(a)
+
+        return renderers
+
+    def get_contentcheckers(self, audits):
+        contentcheckers = []
+        for a in audits:
+            if issubclass(a.__class__, FileContentAudit):
+                contentcheckers.append(a)
+
+        return contentcheckers
+
+    def render(self, renderers):
+        for template in renderers:
+            with patch.object(template, 'pre_write', lambda: None):
+                with patch.object(template, 'post_write', lambda: None):
+                    with patch.object(template, 'run_service_actions'):
+                        with patch.object(template, 'save_checksum'):
+                            for p in template.paths:
+                                template.comply(p)
+
+    def checkcontents(self, contentcheckers):
+        for check in contentcheckers:
+            if check.path not in self.pathindex:
+                continue
+
+            self.assertTrue(check.is_compliant(self.pathindex[check.path]))
+
+    @patch.object(ssh_config_check, 'lsb_release',
+                  lambda: {'DISTRIB_CODENAME': 'precise'})
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch('charmhelpers.contrib.hardening.audits.file.log')
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    @patch.object(ssh_config_check, 'log', lambda *args, **kwargs: None)
+    def test_ssh_config_render_and_check_lt_trusty(self, mock_log, mock_write,
+                                                   mock_ensure_permissions):
+        audits = ssh_config_check.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+        configs = {}
+
+        def write(path, data):
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                if os.path.basename(path) == "ssh_config":
+                    configs['ssh'] = ftmp.name
+                elif os.path.basename(path) == "sshd_config":
+                    configs['sshd'] = ftmp.name
+
+                if path in self.pathindex:
+                    raise Exception("File already rendered '%s'" % path)
+
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/etc/ssh/ssh_config', args_list[0][0][0])
+        self.assertEqual('/etc/ssh/sshd_config', args_list[1][0][0])
+        self.assertEqual(mock_write.call_count, 2)
+
+        calls = [call("Auditing contents of file '%s'" % configs['ssh'],
+                      level='DEBUG'),
+                 call('Checked 10 cases and 10 passed', level='DEBUG'),
+                 call("Auditing contents of file '%s'" % configs['sshd'],
+                      level='DEBUG'),
+                 call('Checked 10 cases and 10 passed', level='DEBUG')]
+        mock_log.assert_has_calls(calls)
+
+    @patch.object(ssh_config_check, 'lsb_release',
+                  lambda: {'DISTRIB_CODENAME': 'trusty'})
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch('charmhelpers.contrib.hardening.audits.file.log')
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    @patch.object(ssh_config_check, 'log', lambda *args, **kwargs: None)
+    def test_ssh_config_render_and_check_gte_trusty(self, mock_log, mock_write,
+                                                    mock_ensure_permissions):
+        audits = ssh_config_check.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+
+        def write(path, data):
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                if path in self.pathindex:
+                    raise Exception("File already rendered '%s'" % path)
+
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/etc/ssh/ssh_config', args_list[0][0][0])
+        self.assertEqual('/etc/ssh/sshd_config', args_list[1][0][0])
+        self.assertEqual(mock_write.call_count, 2)
+
+        mock_log.assert_has_calls([call('Checked 9 cases and 9 passed',
+                                        level='DEBUG')])
+
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch.object(sysctl, 'log', lambda *args, **kwargs: None)
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    def test_os_sysctl_and_check(self, mock_write, mock_ensure_permissions):
+        audits = sysctl.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+
+        def write(path, data):
+            if path in self.pathindex:
+                raise Exception("File already rendered '%s'" % path)
+
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/etc/sysctl.d/99-juju-hardening.conf',
+                         args_list[0][0][0])
+        self.assertEqual(mock_write.call_count, 1)
+
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch.object(sysctl, 'log', lambda *args, **kwargs: None)
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    def test_os_securetty_and_check(self, mock_write, mock_ensure_permissions):
+        audits = securetty.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+
+        def write(path, data):
+            if path in self.pathindex:
+                raise Exception("File already rendered '%s'" % path)
+
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/etc/securetty', args_list[0][0][0])
+        self.assertEqual(mock_write.call_count, 1)
+
+    @patch.object(apache_config_check.utils, 'get_settings', lambda x: {
+        'common': {'apache_dir': '/tmp/foo'},
+        'hardening': {
+            'allowed_http_methods': {'GOGETEM'},
+            'modules_to_disable': {'modfoo'},
+            'traceenable': 'off',
+            'servertokens': 'Prod',
+            'honor_cipher_order': 'on',
+            'cipher_suite': 'ALL:+MEDIUM:+HIGH:!LOW:!MD5:!RC4:!eNULL:!aNULL:!3DES'
+        }
+    })
+    @patch('charmhelpers.contrib.hardening.audits.file.os.path.exists',
+           lambda *a, **kwa: True)
+    @patch.object(apache_config_check, 'subprocess')
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    def test_apache_conf_and_check(self, mock_write, mock_ensure_permissions,
+                                   mock_subprocess):
+        mock_subprocess.call.return_value = 0
+        apache_version = b"""Server version: Apache/2.4.7 (Ubuntu)
+        Server built:   Jan 14 2016 17:45:23
+        """
+        mock_subprocess.check_output.return_value = apache_version
+        audits = apache_config_check.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+
+        def write(path, data):
+            if path in self.pathindex:
+                raise Exception("File already rendered '%s'" % path)
+
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/tmp/foo/mods-available/alias.conf',
+                         args_list[0][0][0])
+        self.assertEqual(mock_write.call_count, 2)
+
+    @patch.object(apache_config_check.utils, 'get_settings', lambda x: {
+        'security': {},
+        'hardening': {
+            'mysql-conf': '/tmp/foo/mysql.cnf',
+            'hardening-conf': '/tmp/foo/conf.d/hardening.cnf'
+        }
+    })
+    @patch('charmhelpers.contrib.hardening.audits.file.os.path.exists',
+           lambda *a, **kwa: True)
+    @patch.object(utils, 'ensure_permissions')
+    @patch.object(templating, 'write')
+    @patch.object(mysql_config_check.subprocess, 'call',
+                  lambda *args, **kwargs: 0)
+    @patch.object(templating, 'log', lambda *args, **kwargs: None)
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    def test_mysql_conf_and_check(self, mock_write, mock_ensure_permissions):
+        audits = mysql_config_check.get_audits()
+        contentcheckers = self.get_contentcheckers(audits)
+        renderers = self.get_renderers(audits)
+
+        def write(path, data):
+            if path in self.pathindex:
+                raise Exception("File already rendered '%s'" % path)
+
+            with tempfile.NamedTemporaryFile(delete=False) as ftmp:
+                self.pathindex[path] = ftmp.name
+                with open(ftmp.name, 'wb') as fd:
+                    fd.write(data)
+
+        mock_write.side_effect = write
+        self.render(renderers)
+        self.checkcontents(contentcheckers)
+        self.assertTrue(mock_write.called)
+        args_list = mock_write.call_args_list
+        self.assertEqual('/tmp/foo/conf.d/hardening.cnf',
+                         args_list[0][0][0])
+        self.assertEqual(mock_write.call_count, 1)
+
+    def tearDown(self):
+        # Cleanup
+        for path in six.itervalues(self.pathindex):
+            os.remove(path)
+
+        super(TemplatingTestCase, self).tearDown()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b83895d56e12fc91fec5d40254ce2289c8712ff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/hardening/test_utils.py
@@ -0,0 +1,63 @@
+# Copyright 2016 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import six
+import tempfile
+
+from mock import (
+    MagicMock,
+    call,
+    patch
+)
+from unittest import TestCase
+
+from charmhelpers.contrib.hardening import utils
+
+
+class UtilsTestCase(TestCase):
+
+    def setUp(self):
+        super(UtilsTestCase, self).setUp()
+        utils.__SETTINGS__ = {}
+
+    @patch.object(utils.grp, 'getgrnam')
+    @patch.object(utils.pwd, 'getpwnam')
+    @patch.object(utils, 'os')
+    @patch.object(utils, 'log', lambda *args, **kwargs: None)
+    def test_ensure_permissions(self, mock_os, mock_getpwnam, mock_getgrnam):
+        user = MagicMock()
+        user.pw_uid = '12'
+        mock_getpwnam.return_value = user
+        group = MagicMock()
+        group.gr_gid = '23'
+        mock_getgrnam.return_value = group
+
+        with tempfile.NamedTemporaryFile() as tmp:
+            utils.ensure_permissions(tmp.name, 'testuser', 'testgroup', 0o0440)
+
+        mock_getpwnam.assert_has_calls([call('testuser')])
+        mock_getgrnam.assert_has_calls([call('testgroup')])
+        mock_os.chown.assert_has_calls([call(tmp.name, '12', '23')])
+        mock_os.chmod.assert_has_calls([call(tmp.name, 0o0440)])
+
+    @patch.object(utils, '_get_user_provided_overrides')
+    def test_settings_cache(self, mock_get_user_provided_overrides):
+        mock_get_user_provided_overrides.return_value = {}
+        self.assertEqual(utils.__SETTINGS__, {})
+        self.assertTrue('sysctl' in utils.get_settings('os'))
+        self.assertEqual(sorted(list(six.iterkeys(utils.__SETTINGS__))),
+                         ['os'])
+        self.assertTrue('server' in utils.get_settings('ssh'))
+        self.assertEqual(sorted(list(six.iterkeys(utils.__SETTINGS__))),
+                         ['os', 'ssh'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/mellanox/test_infiniband.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/mellanox/test_infiniband.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc60be7a6306bd4d90b701a1ef9828751ae889a5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/mellanox/test_infiniband.py
@@ -0,0 +1,115 @@
+#!/usr/bin/env python
+
+from charmhelpers.contrib.mellanox import infiniband
+
+from mock import patch, call
+import unittest
+
+TO_PATCH = [
+    "log",
+    "INFO",
+    "apt_install",
+    "apt_update",
+    "modprobe",
+    "network_interfaces"
+]
+
+NETWORK_INTERFACES = [
+    'lo',
+    'eth0',
+    'eth1',
+    'eth2',
+    'eth3',
+    'eth4',
+    'juju-br0',
+    'ib0',
+    'virbr0',
+    'ovs-system',
+    'br-int',
+    'br-ex',
+    'br-data',
+    'phy-br-data',
+    'int-br-data',
+    'br-tun'
+]
+
+
+IBSTAT_OUTPUT = """
+CA 'mlx4_0'
+    CA type: MT4103
+    Number of ports: 2
+    Firmware version: 2.33.5000
+    Hardware version: 0
+    Node GUID: 0xe41d2d03000a1120
+    System image GUID: 0xe41d2d03000a1123
+"""
+
+
+class InfinibandTest(unittest.TestCase):
+
+    def setUp(self):
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.mellanox.infiniband.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_load_modules(self):
+        infiniband.load_modules()
+
+        self.modprobe.assert_has_calls(map(lambda x: call(x, persist=True),
+                                           infiniband.REQUIRED_MODULES))
+
+    def test_install_packages(self):
+        infiniband.install_packages()
+
+        self.apt_update.assert_is_called_once()
+        self.apt_install.assert_is_called_once()
+
+    @patch("os.path.exists")
+    def test_is_enabled(self, exists):
+        exists.return_value = True
+        self.assertTrue(infiniband.is_enabled())
+
+    @patch("subprocess.check_output")
+    def test_stat(self, check_output):
+        infiniband.stat()
+
+        check_output.assert_called_with(["ibstat"])
+
+    @patch("subprocess.check_output")
+    def test_devices(self, check_output):
+        infiniband.devices()
+
+        check_output.assert_called_with(["ibstat", "-l"])
+
+    @patch("subprocess.check_output")
+    def test_device_info(self, check_output):
+        check_output.return_value = IBSTAT_OUTPUT
+
+        info = infiniband.device_info("mlx4_0")
+
+        self.assertEquals(info.num_ports, "2")
+        self.assertEquals(info.device_type, "MT4103")
+        self.assertEquals(info.fw_ver, "2.33.5000")
+        self.assertEquals(info.hw_ver, "0")
+        self.assertEquals(info.node_guid, "0xe41d2d03000a1120")
+        self.assertEquals(info.sys_guid, "0xe41d2d03000a1123")
+
+    @patch("subprocess.check_output")
+    def test_ipoib_interfaces(self, check_output):
+        self.network_interfaces.return_value = NETWORK_INTERFACES
+
+        ipoib_nic = "ib0"
+
+        def c(*args, **kwargs):
+            if ipoib_nic in args[0]:
+                return "driver: ib_ipoib"
+            else:
+                return "driver: mock"
+
+        check_output.side_effect = c
+        self.assertEquals(infiniband.ipoib_interfaces(), [ipoib_nic])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovn.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovn.py
new file mode 100644
index 0000000000000000000000000000000000000000..c039693a4cb93806f4753f61c177cc4600ce2b91
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovn.py
@@ -0,0 +1,122 @@
+import textwrap
+import uuid
+
+import charmhelpers.contrib.network.ovs.ovn as ovn
+
+import tests.utils as test_utils
+
+
+CLUSTER_STATUS = textwrap.dedent("""
+    0ea6
+    Name: OVN_Northbound
+    Cluster ID: f6a3 (f6a36e77-97bf-4740-b46a-705cbe4fef45)
+    Server ID: 0ea6 (0ea6e785-c2bb-4640-b7a2-85104c11a2c1)
+    Address: ssl:10.219.3.174:6643
+    Status: cluster member
+    Role: follower
+    Term: 3
+    Leader: 22dd
+    Vote: unknown
+
+    Election timer: 1000
+    Log: [2, 10]
+    Entries not yet committed: 0
+    Entries not yet applied: 0
+    Connections: ->f6cf ->22dd <-22dd <-f6cf
+    Servers:
+        0ea6 (0ea6 at ssl:10.219.3.174:6643) (self)
+        f6cf (f6cf at ssl:10.219.3.64:6643)
+        22dd (22dd at ssl:10.219.3.137:6643)
+    """)
+
+NORTHD_STATUS_ACTIVE = textwrap.dedent("""
+    Status: active
+    """)
+
+NORTHD_STATUS_STANDBY = textwrap.dedent("""
+    Status: standby
+    """)
+
+
+class TestOVN(test_utils.BaseTestCase):
+
+    def test_ovn_appctl(self):
+        self.patch_object(ovn.utils, '_run')
+        ovn.ovn_appctl('ovn-northd', ('is-paused',))
+        self._run.assert_called_once_with('ovn-appctl', '-t', 'ovn-northd',
+                                          'is-paused')
+        self._run.reset_mock()
+        ovn.ovn_appctl('ovnnb_db', ('cluster/status',))
+        self._run.assert_called_once_with('ovn-appctl', '-t',
+                                          '/var/run/ovn/ovnnb_db.ctl',
+                                          'cluster/status')
+        self._run.reset_mock()
+        ovn.ovn_appctl('ovnnb_db', ('cluster/status',), use_ovs_appctl=True)
+        self._run.assert_called_once_with('ovs-appctl', '-t',
+                                          '/var/run/ovn/ovnnb_db.ctl',
+                                          'cluster/status')
+        self._run.reset_mock()
+        ovn.ovn_appctl('ovnsb_db', ('cluster/status',),
+                       rundir='/var/run/openvswitch')
+        self._run.assert_called_once_with('ovn-appctl', '-t',
+                                          '/var/run/openvswitch/ovnsb_db.ctl',
+                                          'cluster/status')
+
+    def test_cluster_status(self):
+        self.patch_object(ovn, 'ovn_appctl')
+        self.ovn_appctl.return_value = CLUSTER_STATUS
+        expect = ovn.OVNClusterStatus(
+            'OVN_Northbound',
+            uuid.UUID('f6a36e77-97bf-4740-b46a-705cbe4fef45'),
+            uuid.UUID('0ea6e785-c2bb-4640-b7a2-85104c11a2c1'),
+            'ssl:10.219.3.174:6643',
+            'cluster member',
+            'follower',
+            3,
+            '22dd',
+            'unknown',
+            1000,
+            '[2, 10]',
+            0,
+            0,
+            '->f6cf ->22dd <-22dd <-f6cf',
+            [
+                ('0ea6', 'ssl:10.219.3.174:6643'),
+                ('f6cf', 'ssl:10.219.3.64:6643'),
+                ('22dd', 'ssl:10.219.3.137:6643'),
+            ])
+        self.assertEquals(ovn.cluster_status('ovnnb_db'), expect)
+        self.ovn_appctl.assert_called_once_with('ovnnb_db', ('cluster/status',
+                                                'OVN_Northbound'),
+                                                rundir=None,
+                                                use_ovs_appctl=False)
+        self.assertFalse(expect.is_cluster_leader)
+        expect = ovn.OVNClusterStatus(
+            'OVN_Northbound',
+            uuid.UUID('f6a36e77-97bf-4740-b46a-705cbe4fef45'),
+            uuid.UUID('0ea6e785-c2bb-4640-b7a2-85104c11a2c1'),
+            'ssl:10.219.3.174:6643',
+            'cluster member',
+            'leader',
+            3,
+            'self',
+            'unknown',
+            1000,
+            '[2, 10]',
+            0,
+            0,
+            '->f6cf ->22dd <-22dd <-f6cf',
+            [
+                ('0ea6', 'ssl:10.219.3.174:6643'),
+                ('f6cf', 'ssl:10.219.3.64:6643'),
+                ('22dd', 'ssl:10.219.3.137:6643'),
+            ])
+        self.assertTrue(expect.is_cluster_leader)
+
+    def test_is_northd_active(self):
+        self.patch_object(ovn, 'ovn_appctl')
+        self.ovn_appctl.return_value = NORTHD_STATUS_ACTIVE
+        self.assertTrue(ovn.is_northd_active())
+        self.ovn_appctl.assert_called_once_with('ovn-northd', ('status',))
+        self.ovn_appctl.return_value = NORTHD_STATUS_STANDBY
+        self.assertFalse(ovn.is_northd_active())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovs.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f66cbb0262fc93f348f6f51b8b28f361f564926
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovs.py
@@ -0,0 +1,174 @@
+import mock
+
+import charmhelpers.contrib.network.ovs as ovs
+
+import tests.utils as test_utils
+
+
+# NOTE(fnordahl): some functions drectly under the ``contrib.network.ovs``
+# module have their unit tests in the ``test_ovs.py`` module in the
+# ``tests.contrib.network`` package.
+
+
+class TestOVS(test_utils.BaseTestCase):
+
+    def test__dict_to_vsctl_set(self):
+        indata = {
+            'key': 'value',
+            'otherkey': {
+                'nestedkey': 'nestedvalue',
+            },
+        }
+        # due to varying Dict ordering depending on Python version we need
+        # to be a bit elaborate rather than comparing result directly
+        result1 = ('--', 'set', 'aTable', 'anItem', 'key=value')
+        result2 = ('--', 'set', 'aTable', 'anItem',
+                   'otherkey:nestedkey=nestedvalue')
+        for setcmd in ovs._dict_to_vsctl_set(indata, 'aTable', 'anItem'):
+            self.assertTrue(setcmd == result1 or setcmd == result2)
+
+    def test_add_bridge(self):
+        self.patch_object(ovs.subprocess, 'check_call')
+        self.patch_object(ovs, 'log')
+        ovs.add_bridge('test')
+        self.check_call.assert_called_once_with([
+            "ovs-vsctl", "--", "--may-exist",
+            "add-br", 'test'])
+        self.assertTrue(self.log.call_count == 1)
+
+        self.check_call.reset_mock()
+        self.log.reset_mock()
+        ovs.add_bridge('test', datapath_type='netdev')
+        self.check_call.assert_called_with([
+            "ovs-vsctl", "--", "--may-exist",
+            "add-br", 'test', "--", "set",
+            "bridge", "test", "datapath_type=netdev",
+        ])
+        self.assertTrue(self.log.call_count == 2)
+
+        self.check_call.reset_mock()
+        ovs.add_bridge('test', exclusive=True)
+        self.check_call.assert_called_once_with([
+            "ovs-vsctl", "--", "add-br", 'test'])
+
+        self.check_call.reset_mock()
+        self.patch_object(ovs, '_dict_to_vsctl_set')
+        self._dict_to_vsctl_set.return_value = [['--', 'fakeextradata']]
+        ovs.add_bridge('test', brdata={'fakeinput': None})
+        self._dict_to_vsctl_set.assert_called_once_with(
+            {'fakeinput': None}, 'bridge', 'test')
+        self.check_call.assert_called_once_with([
+            'ovs-vsctl', '--', '--may-exist', 'add-br', 'test',
+            '--', 'fakeextradata'])
+
+    def test_add_bridge_port(self):
+        self.patch_object(ovs.subprocess, 'check_call')
+        self.patch_object(ovs, 'log')
+        ovs.add_bridge_port('test', 'eth1')
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', '--may-exist', 'add-port',
+                       'test', 'eth1']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'up']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'promisc', 'off'])
+        ])
+        self.assertTrue(self.log.call_count == 1)
+
+        self.check_call.reset_mock()
+        self.log.reset_mock()
+        ovs.add_bridge_port('test', 'eth1', promisc=True)
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', '--may-exist', 'add-port',
+                       'test', 'eth1']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'up']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'promisc', 'on'])
+        ])
+        self.assertTrue(self.log.call_count == 1)
+
+        self.check_call.reset_mock()
+        self.log.reset_mock()
+        ovs.add_bridge_port('test', 'eth1', promisc=None)
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', '--may-exist', 'add-port',
+                       'test', 'eth1']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'up']),
+        ])
+        self.assertTrue(self.log.call_count == 1)
+
+        self.check_call.reset_mock()
+        ovs.add_bridge_port('test', 'eth1', exclusive=True, linkup=False)
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', 'add-port', 'test', 'eth1']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'promisc', 'off'])
+        ])
+
+        self.check_call.reset_mock()
+        self.patch_object(ovs, '_dict_to_vsctl_set')
+        self._dict_to_vsctl_set.return_value = [['--', 'fakeextradata']]
+        ovs.add_bridge_port('test', 'eth1', ifdata={'fakeinput': None})
+        self._dict_to_vsctl_set.assert_called_once_with(
+            {'fakeinput': None}, 'Interface', 'eth1')
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', '--may-exist', 'add-port',
+                       'test', 'eth1', '--', 'fakeextradata']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'up']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'promisc', 'off'])
+        ])
+        self._dict_to_vsctl_set.reset_mock()
+        self.check_call.reset_mock()
+        ovs.add_bridge_port('test', 'eth1', portdata={'fakeportinput': None})
+        self._dict_to_vsctl_set.assert_called_once_with(
+            {'fakeportinput': None}, 'Port', 'eth1')
+        self.check_call.assert_has_calls([
+            mock.call(['ovs-vsctl', '--', '--may-exist', 'add-port',
+                       'test', 'eth1', '--', 'fakeextradata']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'up']),
+            mock.call(['ip', 'link', 'set', 'eth1', 'promisc', 'off'])
+        ])
+
+    def test_ovs_appctl(self):
+        self.patch_object(ovs.subprocess, 'check_output')
+        ovs.ovs_appctl('ovs-vswitchd', ('ofproto/list',))
+        self.check_output.assert_called_once_with(
+            ['ovs-appctl', '-t', 'ovs-vswitchd', 'ofproto/list'],
+            universal_newlines=True)
+
+    def test_add_bridge_bond(self):
+        self.patch_object(ovs.subprocess, 'check_call')
+        self.patch_object(ovs, '_dict_to_vsctl_set')
+        self._dict_to_vsctl_set.return_value = [['--', 'fakekey=fakevalue']]
+        portdata = {
+            'bond-mode': 'balance-tcp',
+            'lacp': 'active',
+            'other-config': {
+                'lacp-time': 'fast',
+            },
+        }
+        ifdatamap = {
+            'eth0': {
+                'type': 'dpdk',
+                'mtu-request': '9000',
+                'options': {
+                    'dpdk-devargs': '0000:01:00.0',
+                },
+            },
+            'eth1': {
+                'type': 'dpdk',
+                'mtu-request': '9000',
+                'options': {
+                    'dpdk-devargs': '0000:02:00.0',
+                },
+            },
+        }
+        ovs.add_bridge_bond('br-ex', 'bond42', ['eth0', 'eth1'],
+                            portdata, ifdatamap)
+        self._dict_to_vsctl_set.assert_has_calls([
+            mock.call(portdata, 'port', 'bond42'),
+            mock.call(ifdatamap['eth0'], 'Interface', 'eth0'),
+            mock.call(ifdatamap['eth1'], 'Interface', 'eth1'),
+        ], any_order=True)
+        self.check_call.assert_called_once_with([
+            'ovs-vsctl',
+            '--', '--may-exist', 'add-bond', 'br-ex', 'bond42', 'eth0', 'eth1',
+            '--', 'fakekey=fakevalue',
+            '--', 'fakekey=fakevalue',
+            '--', 'fakekey=fakevalue'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovsdb.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovsdb.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ecc7085ac47a4e6f8ede01e77f9cf91c53fa100
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_ovsdb.py
@@ -0,0 +1,123 @@
+import mock
+import textwrap
+import uuid
+
+import charmhelpers.contrib.network.ovs.ovsdb as ovsdb
+
+import tests.utils as test_utils
+
+
+VSCTL_BRIDGE_TBL = textwrap.dedent("""
+    {"data":[[["uuid","1e21ba48-61ff-4b32-b35e-cb80411da351"],
+    ["set",[]],["set",[]],"0000a0369fdd3890","","<unknown>",
+    ["map",[["charm-ovn-chassis","managed"],["other","value"]]],
+    ["set",[]],["set",[]],["map",[]],["set",[]],false,["set",[]],
+    "br-test",["set",[]],["map",[]],["set",
+    [["uuid","617f9359-77e2-41be-8af6-4c44e7a6bcc3"],
+    ["uuid","da840476-8809-4107-8733-591f4696f056"]]],
+    ["set",[]],false,["map",[]],["set",[]],["map",[]],false],
+    [["uuid","bb685b0f-a383-40a1-b7a5-b5c2066bfa42"],
+    ["set",[]],["set",[]],"00000e5b68bba140","","<unknown>",
+    ["map",[]],"secure",["set",[]],["map",[]],["set",[]],false,
+    ["set",[]],"br-int",["set",[]],["map",[["disable-in-band","true"]]],
+    ["set",[["uuid","07f4c231-9fd2-49b0-a558-5b69d657fdb0"],
+    ["uuid","8bbd2441-866f-4317-a284-09491702776c"],
+    ["uuid","d9e9c081-6482-4006-b7d6-239182b56c2e"]]],
+    ["set",[]],false,["map",[]],["set",[]],["map",[]],false]],
+    "headings":["_uuid","auto_attach","controller","datapath_id",
+    "datapath_type","datapath_version","external_ids","fail_mode",
+    "flood_vlans","flow_tables","ipfix","mcast_snooping_enable",
+    "mirrors","name","netflow","other_config","ports","protocols",
+    "rstp_enable","rstp_status","sflow","status","stp_enable"]}
+    """)
+
+
+class TestSimpleOVSDB(test_utils.BaseTestCase):
+
+    def patch_target(self, attr, return_value=None):
+        mocked = mock.patch.object(self.target, attr)
+        self._patches[attr] = mocked
+        started = mocked.start()
+        started.return_value = return_value
+        self._patches_start[attr] = started
+        setattr(self, attr, started)
+
+    def test___init__(self):
+        with self.assertRaises(RuntimeError):
+            self.target = ovsdb.SimpleOVSDB('atool')
+        with self.assertRaises(AttributeError):
+            self.target = ovsdb.SimpleOVSDB('ovs-vsctl')
+            self.target.unknown_table.find()
+
+    def test__find_tbl(self):
+        self.target = ovsdb.SimpleOVSDB('ovs-vsctl')
+        self.patch_object(ovsdb.utils, '_run')
+        self._run.return_value = VSCTL_BRIDGE_TBL
+        self.maxDiff = None
+        expect = {
+            '_uuid': uuid.UUID('1e21ba48-61ff-4b32-b35e-cb80411da351'),
+            'auto_attach': [],
+            'controller': [],
+            'datapath_id': '0000a0369fdd3890',
+            'datapath_type': '',
+            'datapath_version': '<unknown>',
+            'external_ids': {
+                'charm-ovn-chassis': 'managed',
+                'other': 'value',
+            },
+            'fail_mode': [],
+            'flood_vlans': [],
+            'flow_tables': {},
+            'ipfix': [],
+            'mcast_snooping_enable': False,
+            'mirrors': [],
+            'name': 'br-test',
+            'netflow': [],
+            'other_config': {},
+            'ports': [['uuid', '617f9359-77e2-41be-8af6-4c44e7a6bcc3'],
+                      ['uuid', 'da840476-8809-4107-8733-591f4696f056']],
+            'protocols': [],
+            'rstp_enable': False,
+            'rstp_status': {},
+            'sflow': [],
+            'status': {},
+            'stp_enable': False}
+        # this in effect also tests the __iter__ front end method
+        for el in self.target.bridge:
+            self.assertDictEqual(el, expect)
+            break
+        self._run.assert_called_once_with(
+            'ovs-vsctl', '-f', 'json', 'find', 'bridge')
+        self._run.reset_mock()
+        # this in effect also tests the find front end method
+        for el in self.target.bridge.find(condition='name=br-test'):
+            break
+        self._run.assert_called_once_with(
+            'ovs-vsctl', '-f', 'json', 'find', 'bridge', 'name=br-test')
+
+    def test_clear(self):
+        self.target = ovsdb.SimpleOVSDB('ovs-vsctl')
+        self.patch_object(ovsdb.utils, '_run')
+        self.target.interface.clear('1e21ba48-61ff-4b32-b35e-cb80411da351',
+                                    'external_ids')
+        self._run.assert_called_once_with(
+            'ovs-vsctl', 'clear', 'interface',
+            '1e21ba48-61ff-4b32-b35e-cb80411da351', 'external_ids')
+
+    def test_remove(self):
+        self.target = ovsdb.SimpleOVSDB('ovs-vsctl')
+        self.patch_object(ovsdb.utils, '_run')
+        self.target.interface.remove('1e21ba48-61ff-4b32-b35e-cb80411da351',
+                                     'external_ids', 'other')
+        self._run.assert_called_once_with(
+            'ovs-vsctl', 'remove', 'interface',
+            '1e21ba48-61ff-4b32-b35e-cb80411da351', 'external_ids', 'other')
+
+    def test_set(self):
+        self.target = ovsdb.SimpleOVSDB('ovs-vsctl')
+        self.patch_object(ovsdb.utils, '_run')
+        self.target.interface.set('1e21ba48-61ff-4b32-b35e-cb80411da351',
+                                  'external_ids:other', 'value')
+        self._run.assert_called_once_with(
+            'ovs-vsctl', 'set', 'interface',
+            '1e21ba48-61ff-4b32-b35e-cb80411da351', 'external_ids:other=value')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b7e4b1af51df750a0dfab73b88ec8902d113a8f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/ovs/test_utils.py
@@ -0,0 +1,13 @@
+import charmhelpers.contrib.network.ovs.utils as utils
+
+import tests.utils as test_utils
+
+
+class TestUtils(test_utils.BaseTestCase):
+
+    def test__run(self):
+        self.patch_object(utils.subprocess, 'check_output')
+        self.check_output.return_value = 'aReturn'
+        self.assertEquals(utils._run('aArg'), 'aReturn')
+        self.check_output.assert_called_once_with(
+            ('aArg',), universal_newlines=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..d638abc275440e48a8b5eaafdd323ff7d94d9f74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ip.py
@@ -0,0 +1,848 @@
+import subprocess
+import unittest
+
+import mock
+import netifaces
+
+import charmhelpers.contrib.network.ip as net_ip
+from mock import patch, MagicMock
+
+import nose.tools
+import six
+
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+    builtin_import = '__builtin__.__import__'
+else:
+    builtin_open = 'builtins.open'
+    builtin_import = 'builtins.__import__'
+
+DUMMY_ADDRESSES = {
+    'lo': {
+        17: [{'peer': '00:00:00:00:00:00',
+              'addr': '00:00:00:00:00:00'}],
+        2: [{'peer': '127.0.0.1', 'netmask':
+             '255.0.0.0', 'addr': '127.0.0.1'}],
+        10: [{'netmask': 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff',
+              'addr': '::1'}]
+    },
+    'eth0': {
+        2: [{'addr': '192.168.1.55',
+             'broadcast': '192.168.1.255',
+             'netmask': '255.255.255.0'}],
+        10: [{'addr': '2a01:348:2f4:0:685e:5748:ae62:209f',
+              'netmask': 'ffff:ffff:ffff:ffff::'},
+             {'addr': 'fe80::3e97:eff:fe8b:1cf7%eth0',
+              'netmask': 'ffff:ffff:ffff:ffff::'},
+             {'netmask': 'ffff:ffff:ffff:ffff::/64',
+              'addr': 'fd2d:dec4:cf59:3c16::1'},
+             {'addr': '2001:db8:1::',
+              'netmask': 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff'}],
+        17: [{'addr': '3c:97:0e:8b:1c:f7',
+              'broadcast': 'ff:ff:ff:ff:ff:ff'}]
+    },
+    'eth0:1': {
+        2: [{'addr': '192.168.1.56',
+             'broadcast': '192.168.1.255',
+             'netmask': '255.255.255.0'}],
+    },
+    'eth1': {
+        2: [{'addr': '10.5.0.1',
+             'broadcast': '10.5.255.255',
+             'netmask': '255.255.0.0'},
+            {'addr': '10.6.0.2',
+             'broadcast': '10.6.0.255',
+             'netmask': '255.255.255.0'}],
+        3: [{'addr': 'fe80::3e97:eff:fe8b:1cf7%eth1',
+             'netmask': 'ffff:ffff:ffff:ffff::'}],
+        17: [{'addr': '3c:97:0e:8b:1c:f7',
+              'broadcast': 'ff:ff:ff:ff:ff:ff'}]
+    },
+    'eth2': {
+        10: [{'addr': '3a01:348:2f4:0:685e:5748:ae62:209f',
+              'netmask': 'ffff:ffff:ffff:ffff::'},
+             {'addr': 'fe80::3e97:edd:fe8b:1cf7%eth0',
+              'netmask': 'ffff:ffff:ffff:ffff::'}],
+        17: [{'addr': '3c:97:0e:8b:1c:f7',
+              'broadcast': 'ff:ff:ff:ff:ff:ff'}]
+    },
+    'eth2:1': {
+        2: [{'addr': '192.168.10.58',
+             'broadcast': '192.168.1.255',
+             'netmask': '255.255.255.0'}],
+    },
+}
+
+IP_OUTPUT = b"""link/ether fa:16:3e:2a:cc:ce brd ff:ff:ff:ff:ff:ff
+    inet 10.5.16.93/16 brd 10.5.255.255 scope global eth0
+       valid_lft forever preferred_lft forever
+    inet6 2001:db8:1:0:d0cf:528c:23eb:6000/64 scope global
+       valid_lft forever preferred_lft forever
+    inet6 2001:db8:1:0:2918:3444:852:5b8a/64 scope global temporary dynamic
+       valid_lft 86400sec preferred_lft 14400sec
+    inet6 2001:db8:1:0:f816:3eff:fe2a:ccce/64 scope global dynamic
+       valid_lft 86400sec preferred_lft 14400sec
+    inet6 fe80::f816:3eff:fe2a:ccce/64 scope link
+       valid_lft forever preferred_lft forever
+"""
+
+IP2_OUTPUT = b"""link/ether fa:16:3e:2a:cc:ce brd ff:ff:ff:ff:ff:ff
+    inet 10.5.16.93/16 brd 10.5.255.255 scope global eth0
+       valid_lft forever preferred_lft forever
+    inet6 2001:db8:1:0:d0cf:528c:23eb:6000/64 scope global
+       valid_lft forever preferred_lft forever
+    inet6 2001:db8:1:0:2918:3444:852:5b8a/64 scope global temporary dynamic
+       valid_lft 86400sec preferred_lft 14400sec
+    inet6 2001:db8:1:0:f816:3eff:fe2a:ccce/64 scope global mngtmpaddr dynamic
+       valid_lft 86400sec preferred_lft 14400sec
+    inet6 fe80::f816:3eff:fe2a:ccce/64 scope link
+       valid_lft forever preferred_lft forever
+"""
+
+IP_OUTPUT_NO_VALID = b"""link/ether fa:16:3e:2a:cc:ce brd ff:ff:ff:ff:ff:ff
+    inet 10.5.16.93/16 brd 10.5.255.255 scope global eth0
+       valid_lft forever preferred_lft forever
+    inet6 2001:db8:1:0:2918:3444:852:5b8a/64 scope global temporary dynamic
+       valid_lft 86400sec preferred_lft 14400sec
+    inet6 fe80::f816:3eff:fe2a:ccce/64 scope link
+       valid_lft forever preferred_lft forever
+"""
+
+
+class FakeAnswer(object):
+    def __init__(self, ip):
+        self.ip = ip
+
+    def __str__(self):
+        return self.ip
+
+
+class FakeResolver(object):
+    def __init__(self, ip):
+        self.ip = ip
+
+    def query(self, hostname, query_type):
+        if self.ip == '':
+            return []
+        else:
+            return [FakeAnswer(self.ip)]
+
+
+class FakeReverse(object):
+    def from_address(self, address):
+        return '156.94.189.91.in-addr.arpa'
+
+
+class FakeDNSName(object):
+    def __init__(self, dnsname):
+        pass
+
+
+class FakeDNS(object):
+    def __init__(self, ip):
+        self.resolver = FakeResolver(ip)
+        self.reversename = FakeReverse()
+        self.name = MagicMock()
+        self.name.Name = FakeDNSName
+
+
+class IPTest(unittest.TestCase):
+
+    def mock_ifaddresses(self, iface):
+        return DUMMY_ADDRESSES[iface]
+
+    def test_get_address_in_network_with_invalid_net(self):
+        for net in ['192.168.300/22', '192.168.1.0/2a', '2.a']:
+            self.assertRaises(ValueError,
+                              net_ip.get_address_in_network,
+                              net)
+
+    def _test_get_address_in_network(self, expect_ip_addr,
+                                     network, fallback=None, fatal=False):
+
+        def side_effect(iface):
+            return DUMMY_ADDRESSES[iface]
+
+        with mock.patch.object(netifaces, 'interfaces') as interfaces:
+            interfaces.return_value = sorted(DUMMY_ADDRESSES.keys())
+            with mock.patch.object(netifaces, 'ifaddresses') as ifaddresses:
+                ifaddresses.side_effect = side_effect
+                if not fatal:
+                    self.assertEqual(expect_ip_addr,
+                                     net_ip.get_address_in_network(network,
+                                                                   fallback,
+                                                                   fatal))
+                else:
+                    net_ip.get_address_in_network(network, fallback, fatal)
+
+    @mock.patch.object(subprocess, 'call')
+    def test_get_address_in_network_with_none(self, popen):
+        fallback = '10.10.10.10'
+        self.assertEqual(fallback,
+                         net_ip.get_address_in_network(None, fallback))
+        self.assertEqual(None,
+                         net_ip.get_address_in_network(None))
+
+        self.assertRaises(ValueError, self._test_get_address_in_network,
+                          None, None, fatal=True)
+
+    def test_get_address_in_network_ipv4(self):
+        self._test_get_address_in_network('192.168.1.55', '192.168.1.0/24')
+
+    def test_get_address_in_network_ipv4_multi(self):
+        # Assumes that there is an address configured on both but the first
+        # one is picked#
+        self._test_get_address_in_network('192.168.1.55',
+                                          '192.168.1.0/24 192.168.10.0/24')
+
+    def test_get_address_in_network_ipv4_multi2(self):
+        # Assumes that there is nothing configured on 192.168.11.0/24
+        self._test_get_address_in_network('192.168.10.58',
+                                          '192.168.11.0/24 192.168.10.0/24')
+
+    def test_get_address_in_network_ipv4_secondary(self):
+        self._test_get_address_in_network('10.6.0.2',
+                                          '10.6.0.0/24')
+
+    def test_get_address_in_network_ipv6(self):
+        self._test_get_address_in_network('2a01:348:2f4:0:685e:5748:ae62:209f',
+                                          '2a01:348:2f4::/64')
+
+    def test_get_address_in_network_with_non_existent_net(self):
+        self._test_get_address_in_network(None, '172.16.0.0/16')
+
+    def test_get_address_in_network_fallback_works(self):
+        fallback = '10.10.0.0'
+        self._test_get_address_in_network(fallback, '172.16.0.0/16', fallback)
+
+    @mock.patch.object(subprocess, 'call')
+    def test_get_address_in_network_not_found_fatal(self, popen):
+        self.assertRaises(ValueError, self._test_get_address_in_network,
+                          None, '172.16.0.0/16', fatal=True)
+
+    def test_get_address_in_network_not_found_not_fatal(self):
+        self._test_get_address_in_network(None, '172.16.0.0/16', fatal=False)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_address_in_network_netmask(self, _interfaces, _ifaddresses):
+        """
+        Validates that get_address_in_network works with a netmask
+        that uses the format 'ffff:ffff:ffff::/prefixlen'
+        """
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        self._test_get_address_in_network('fd2d:dec4:cf59:3c16::1',
+                                          'fd2d:dec4:cf59:3c16::/64',
+                                          fatal=False)
+
+    def test_is_address_in_network(self):
+        self.assertTrue(
+            net_ip.is_address_in_network(
+                '192.168.1.0/24',
+                '192.168.1.1'))
+        self.assertFalse(
+            net_ip.is_address_in_network(
+                '192.168.1.0/24',
+                '10.5.1.1'))
+        self.assertRaises(ValueError, net_ip.is_address_in_network,
+                          'broken', '192.168.1.1')
+        self.assertRaises(ValueError, net_ip.is_address_in_network,
+                          '192.168.1.0/24', 'hostname')
+        self.assertTrue(
+            net_ip.is_address_in_network(
+                '2a01:348:2f4::/64',
+                '2a01:348:2f4:0:685e:5748:ae62:209f')
+        )
+        self.assertFalse(
+            net_ip.is_address_in_network(
+                '2a01:348:2f4::/64',
+                'fdfc:3bd5:210b:cc8d:8c80:9e10:3f07:371')
+        )
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_for_address(self, _interfaces, _ifaddresses):
+        def mock_ifaddresses(iface):
+            return DUMMY_ADDRESSES[iface]
+        _interfaces.return_value = ['eth0', 'eth1']
+        _ifaddresses.side_effect = mock_ifaddresses
+        self.assertEquals(
+            net_ip.get_iface_for_address('192.168.1.220'),
+            'eth0')
+        self.assertEquals(net_ip.get_iface_for_address('10.5.20.4'), 'eth1')
+        self.assertEquals(
+            net_ip.get_iface_for_address('2a01:348:2f4:0:685e:5748:ae62:210f'),
+            'eth0'
+        )
+        self.assertEquals(net_ip.get_iface_for_address('172.4.5.5'), None)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_netmask_for_address(self, _interfaces, _ifaddresses):
+        def mock_ifaddresses(iface):
+            return DUMMY_ADDRESSES[iface]
+        _interfaces.return_value = ['eth0', 'eth1']
+        _ifaddresses.side_effect = mock_ifaddresses
+        self.assertEquals(
+            net_ip.get_netmask_for_address('192.168.1.220'),
+            '255.255.255.0')
+        self.assertEquals(
+            net_ip.get_netmask_for_address('10.5.20.4'),
+            '255.255.0.0')
+        self.assertEquals(net_ip.get_netmask_for_address('172.4.5.5'), None)
+        self.assertEquals(
+            net_ip.get_netmask_for_address(
+                '2a01:348:2f4:0:685e:5748:ae62:210f'),
+            '64'
+        )
+        self.assertEquals(
+            net_ip.get_netmask_for_address('2001:db8:1::'),
+            '128'
+        )
+
+    def test_is_ipv6(self):
+        self.assertFalse(net_ip.is_ipv6('myhost'))
+        self.assertFalse(net_ip.is_ipv6('172.4.5.5'))
+        self.assertTrue(net_ip.is_ipv6('2a01:348:2f4:0:685e:5748:ae62:209f'))
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr_no_ipv6(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_ipv6_addr('eth0:1')
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr_no_global_ipv6(self, _interfaces,
+                                          _ifaddresses):
+        DUMMY_ADDRESSES = {
+            'eth0': {
+                10: [{'addr': 'fe80::3e97:eff:fe8b:1cf7%eth0',
+                      'netmask': 'ffff:ffff:ffff:ffff::'}],
+            }
+        }
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        self.assertRaises(Exception, net_ip.get_ipv6_addr)
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr_exc_list(self, _interfaces, _ifaddresses,
+                                    mock_get_iface_from_addr):
+        def mock_ifaddresses(iface):
+            return DUMMY_ADDRESSES[iface]
+
+        _interfaces.return_value = ['eth0', 'eth1']
+        _ifaddresses.side_effect = mock_ifaddresses
+
+        result = net_ip.get_ipv6_addr(
+            exc_list='2a01:348:2f4:0:685e:5748:ae62:209f',
+            inc_aliases=True,
+            fatal=False
+        )
+        self.assertEqual([], result)
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr(self, _interfaces, _ifaddresses, mock_check_out,
+                           mock_get_iface_from_addr):
+        mock_get_iface_from_addr.return_value = 'eth0'
+        mock_check_out.return_value = \
+            b"inet6 2a01:348:2f4:0:685e:5748:ae62:209f/64 scope global dynamic"
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_ipv6_addr(dynamic_only=False)
+        self.assertEqual(['2a01:348:2f4:0:685e:5748:ae62:209f'], result)
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr_global_dynamic(self, _interfaces, _ifaddresses,
+                                          mock_check_out,
+                                          mock_get_iface_from_addr):
+        mock_get_iface_from_addr.return_value = 'eth0'
+        mock_check_out.return_value = \
+            b"inet6 2a01:348:2f4:0:685e:5748:ae62:209f/64 scope global dynamic"
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_ipv6_addr(dynamic_only=False)
+        self.assertEqual(['2a01:348:2f4:0:685e:5748:ae62:209f'], result)
+
+    @patch.object(netifaces, 'interfaces')
+    def test_get_ipv6_addr_invalid_nic(self, _interfaces):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        self.assertRaises(Exception, net_ip.get_ipv6_addr, 'eth1')
+
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    def test_is_ipv6_disabled(self, mock_check_output):
+        # verify that the function does look for the right thing
+        mock_check_output.return_value = """
+        Some lines before
+        net.ipv6.conf.all.disable_ipv6 = 1
+        Some lines afterward
+        """
+        self.assertTrue(net_ip.is_ipv6_disabled())
+        mock_check_output.assert_called_once_with(
+            ['sysctl', 'net.ipv6.conf.all.disable_ipv6'],
+            stderr=subprocess.STDOUT, universal_newlines=True)
+        # if it isn't there, it must return false
+        mock_check_output.return_value = ""
+        self.assertFalse(net_ip.is_ipv6_disabled())
+        # If the syscall returns an error, then return True
+
+        def fake_check_call(*args, **kwargs):
+            raise subprocess.CalledProcessError(['called'], 1)
+        mock_check_output.side_effect = fake_check_call
+        self.assertTrue(net_ip.is_ipv6_disabled())
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("eth0")
+        self.assertEqual(["192.168.1.55"], result)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_excaliases(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("eth0")
+        self.assertEqual(['192.168.1.55'], result)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_incaliases(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("eth0", inc_aliases=True)
+        self.assertEqual(['192.168.1.55', '192.168.1.56'], result)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_exclist(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("eth0", inc_aliases=True,
+                                       exc_list=['192.168.1.55'])
+        self.assertEqual(['192.168.1.56'], result)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_mixedaddr(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("eth2", inc_aliases=True)
+        self.assertEqual(["192.168.10.58"], result)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_full_interface_path(self, _interfaces,
+                                                _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+        result = net_ip.get_iface_addr("/dev/eth0")
+        self.assertEqual(["192.168.1.55"], result)
+
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_invalid_type(self, _interfaces):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_iface_addr(iface='eth0', inet_type='AF_BOB')
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_invalid_interface(self, _interfaces, _ifaddresses):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        result = net_ip.get_ipv4_addr("eth3", fatal=False)
+        self.assertEqual([], result)
+
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_invalid_interface_fatal(self, _interfaces):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_ipv4_addr("eth3", fatal=True)
+
+    @patch.object(netifaces, 'interfaces')
+    def test_get_iface_addr_invalid_interface_fatal_incaliases(self,
+                                                               _interfaces):
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_ipv4_addr("eth3", fatal=True, inc_aliases=True)
+
+    @patch.object(netifaces, 'ifaddresses')
+    @patch.object(netifaces, 'interfaces')
+    def test_get_get_iface_addr_interface_has_no_ipv4(self, _interfaces,
+                                                      _ifaddresses):
+
+        # This will raise a KeyError since we are looking for "2"
+        # (actally, netiface.AF_INET).
+        DUMMY_ADDRESSES = {
+            'eth0': {
+                10: [{'addr': 'fe80::3e97:eff:fe8b:1cf7%eth0',
+                      'netmask': 'ffff:ffff:ffff:ffff::'}],
+            }
+        }
+
+        _interfaces.return_value = DUMMY_ADDRESSES.keys()
+        _ifaddresses.side_effect = DUMMY_ADDRESSES.__getitem__
+
+        result = net_ip.get_ipv4_addr("eth0", fatal=False)
+        self.assertEqual([], result)
+
+    @patch('glob.glob')
+    def test_get_bridges(self, _glob):
+        _glob.return_value = ['/sys/devices/virtual/net/br0/bridge']
+        self.assertEqual(['br0'], net_ip.get_bridges())
+
+    @patch.object(net_ip, 'get_bridges')
+    @patch('glob.glob')
+    def test_get_bridge_nics(self, _glob, _get_bridges):
+        _glob.return_value = ['/sys/devices/virtual/net/br0/brif/eth4',
+                              '/sys/devices/virtual/net/br0/brif/eth5']
+        self.assertEqual(['eth4', 'eth5'], net_ip.get_bridge_nics('br0'))
+
+    @patch.object(net_ip, 'get_bridges')
+    @patch('glob.glob')
+    def test_get_bridge_nics_invalid_br(self, _glob, _get_bridges):
+        _glob.return_value = []
+        self.assertEqual([], net_ip.get_bridge_nics('br1'))
+
+    @patch.object(net_ip, 'get_bridges')
+    @patch.object(net_ip, 'get_bridge_nics')
+    def test_is_bridge_member(self, _get_bridge_nics, _get_bridges):
+        _get_bridges.return_value = ['br0']
+        _get_bridge_nics.return_value = ['eth4', 'eth5']
+        self.assertTrue(net_ip.is_bridge_member('eth4'))
+        self.assertFalse(net_ip.is_bridge_member('eth6'))
+
+    def test_format_ipv6_addr(self):
+        DUMMY_ADDRESS = '2001:db8:1:0:f131:fc84:ea37:7d4'
+        self.assertEquals(net_ip.format_ipv6_addr(DUMMY_ADDRESS),
+                          '[2001:db8:1:0:f131:fc84:ea37:7d4]')
+
+    def test_format_invalid_ipv6_addr(self):
+        INVALID_IPV6_ADDR = 'myhost'
+        self.assertEquals(net_ip.format_ipv6_addr(INVALID_IPV6_ADDR),
+                          None)
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_global_address(self, mock_get_iface_addr, mock_check_out,
+                                     mock_get_iface_from_addr):
+        mock_get_iface_from_addr.return_value = 'eth0'
+        mock_check_out.return_value = IP_OUTPUT
+        scope_global_addr = '2001:db8:1:0:d0cf:528c:23eb:6000'
+        scope_global_dyn_addr = '2001:db8:1:0:f816:3eff:fe2a:ccce'
+        mock_get_iface_addr.return_value = [scope_global_addr,
+                                            scope_global_dyn_addr,
+                                            '2001:db8:1:0:2918:3444:852:5b8a',
+                                            'fe80::f816:3eff:fe2a:ccce%eth0']
+        self.assertEqual([scope_global_addr, scope_global_dyn_addr],
+                         net_ip.get_ipv6_addr(dynamic_only=False))
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_global_dynamic_address(self, mock_get_iface_addr,
+                                             mock_check_out,
+                                             mock_get_iface_from_addr):
+        mock_get_iface_from_addr.return_value = 'eth0'
+        mock_check_out.return_value = IP_OUTPUT
+        scope_global_addr = '2001:db8:1:0:d0cf:528c:23eb:6000'
+        scope_global_dyn_addr = '2001:db8:1:0:f816:3eff:fe2a:ccce'
+        mock_get_iface_addr.return_value = [scope_global_addr,
+                                            scope_global_dyn_addr,
+                                            '2001:db8:1:0:2918:3444:852:5b8a',
+                                            'fe80::f816:3eff:fe2a:ccce%eth0']
+        self.assertEqual([scope_global_dyn_addr], net_ip.get_ipv6_addr())
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_global_dynamic_address_ip2(self, mock_get_iface_addr,
+                                                 mock_check_out,
+                                                 mock_get_iface_from_addr):
+        mock_get_iface_from_addr.return_value = 'eth0'
+        mock_check_out.return_value = IP2_OUTPUT
+        scope_global_addr = '2001:db8:1:0:d0cf:528c:23eb:6000'
+        scope_global_dyn_addr = '2001:db8:1:0:f816:3eff:fe2a:ccce'
+        mock_get_iface_addr.return_value = [scope_global_addr,
+                                            scope_global_dyn_addr,
+                                            '2001:db8:1:0:2918:3444:852:5b8a',
+                                            'fe80::f816:3eff:fe2a:ccce%eth0']
+        self.assertEqual([scope_global_dyn_addr], net_ip.get_ipv6_addr())
+
+    @patch('charmhelpers.contrib.network.ip.subprocess.check_output')
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_global_dynamic_address_invalid_address(
+            self, mock_get_iface_addr, mock_check_out):
+        mock_get_iface_addr.return_value = []
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_ipv6_addr()
+
+        mock_get_iface_addr.return_value = ['2001:db8:1:0:2918:3444:852:5b8a']
+        mock_check_out.return_value = IP_OUTPUT_NO_VALID
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_ipv6_addr()
+
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_addr_w_iface(self, mock_get_iface_addr):
+        mock_get_iface_addr.return_value = []
+        net_ip.get_ipv6_addr(iface='testif', fatal=False)
+        mock_get_iface_addr.assert_called_once_with(iface='testif',
+                                                    inet_type='AF_INET6',
+                                                    inc_aliases=False,
+                                                    fatal=False, exc_list=None)
+
+    @patch('charmhelpers.contrib.network.ip.unit_get')
+    @patch('charmhelpers.contrib.network.ip.get_iface_from_addr')
+    @patch('charmhelpers.contrib.network.ip.get_iface_addr')
+    def test_get_ipv6_addr_no_iface(self, mock_get_iface_addr,
+                                    mock_get_iface_from_addr, mock_unit_get):
+        mock_unit_get.return_value = '1.2.3.4'
+        mock_get_iface_addr.return_value = []
+        mock_get_iface_from_addr.return_value = "testif"
+        net_ip.get_ipv6_addr(fatal=False)
+        mock_get_iface_from_addr.assert_called_once_with('1.2.3.4')
+        mock_get_iface_addr.assert_called_once_with(iface='testif',
+                                                    inet_type='AF_INET6',
+                                                    inc_aliases=False,
+                                                    fatal=False, exc_list=None)
+
+    @patch('netifaces.interfaces')
+    @patch('netifaces.ifaddresses')
+    @patch('charmhelpers.contrib.network.ip.log')
+    def test_get_iface_from_addr(self, mock_log, mock_ifaddresses,
+                                 mock_interfaces):
+        mock_ifaddresses.side_effect = lambda iface: DUMMY_ADDRESSES[iface]
+        mock_interfaces.return_value = sorted(DUMMY_ADDRESSES.keys())
+        addr = 'fe80::3e97:eff:fe8b:1cf7'
+        self.assertEqual(net_ip.get_iface_from_addr(addr), 'eth0')
+
+        with nose.tools.assert_raises(Exception):
+            net_ip.get_iface_from_addr('1.2.3.4')
+
+    def test_is_ip(self):
+        self.assertTrue(net_ip.is_ip('10.0.0.1'))
+        self.assertTrue(net_ip.is_ip('2001:db8:1:0:2918:3444:852:5b8a'))
+        self.assertFalse(net_ip.is_ip('www.ubuntu.com'))
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_host_ip_with_hostname(self, apt_install):
+        fake_dns = FakeDNS('10.0.0.1')
+        with patch(builtin_import, side_effect=[fake_dns]):
+            ip = net_ip.get_host_ip('www.ubuntu.com')
+        self.assertEquals(ip, '10.0.0.1')
+
+    @patch('charmhelpers.contrib.network.ip.ns_query')
+    @patch('charmhelpers.contrib.network.ip.socket.gethostbyname')
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_host_ip_with_hostname_no_dns(self, apt_install, socket,
+                                              ns_query):
+        ns_query.return_value = []
+        fake_dns = FakeDNS(None)
+        socket.return_value = '10.0.0.1'
+        with patch(builtin_import, side_effect=[fake_dns]):
+            ip = net_ip.get_host_ip('www.ubuntu.com')
+        self.assertEquals(ip, '10.0.0.1')
+
+    @patch('charmhelpers.contrib.network.ip.log')
+    @patch('charmhelpers.contrib.network.ip.ns_query')
+    @patch('charmhelpers.contrib.network.ip.socket.gethostbyname')
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_host_ip_with_hostname_fallback(self, apt_install, socket,
+                                                ns_query, *args):
+        ns_query.return_value = []
+        fake_dns = FakeDNS(None)
+
+        def r():
+            raise Exception()
+
+        socket.side_effect = r
+        with patch(builtin_import, side_effect=[fake_dns]):
+            ip = net_ip.get_host_ip('www.ubuntu.com', fallback='127.0.0.1')
+        self.assertEquals(ip, '127.0.0.1')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_host_ip_with_ip(self, apt_install):
+        fake_dns = FakeDNS('5.5.5.5')
+        with patch(builtin_import, side_effect=[fake_dns]):
+            ip = net_ip.get_host_ip('4.2.2.1')
+        self.assertEquals(ip, '4.2.2.1')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_ns_query_trigger_apt_install(self, apt_install):
+        fake_dns = FakeDNS('5.5.5.5')
+        with patch(builtin_import, side_effect=[ImportError, fake_dns]):
+            nsq = net_ip.ns_query('5.5.5.5')
+            if six.PY2:
+                apt_install.assert_called_with('python-dnspython', fatal=True)
+            else:
+                apt_install.assert_called_with('python3-dnspython', fatal=True)
+        self.assertEquals(nsq, '5.5.5.5')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_ns_query_ptr_record(self, apt_install):
+        fake_dns = FakeDNS('127.0.0.1')
+        with patch(builtin_import, side_effect=[fake_dns]):
+            nsq = net_ip.ns_query('127.0.0.1')
+        self.assertEquals(nsq, '127.0.0.1')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_ns_query_a_record(self, apt_install):
+        fake_dns = FakeDNS('127.0.0.1')
+        fake_dns_name = FakeDNSName('www.somedomain.tld')
+        with patch(builtin_import, side_effect=[fake_dns]):
+            nsq = net_ip.ns_query(fake_dns_name)
+        self.assertEquals(nsq, '127.0.0.1')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_ns_query_blank_record(self, apt_install):
+        fake_dns = FakeDNS(None)
+        with patch(builtin_import, side_effect=[fake_dns, fake_dns]):
+            nsq = net_ip.ns_query(None)
+        self.assertEquals(nsq, None)
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_ns_query_lookup_fail(self, apt_install):
+        fake_dns = FakeDNS('')
+        with patch(builtin_import, side_effect=[fake_dns, fake_dns]):
+            nsq = net_ip.ns_query('nonexistant')
+        self.assertEquals(nsq, None)
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_with_ip(self, apt_install):
+        fake_dns = FakeDNS('www.ubuntu.com')
+        with patch(builtin_import, side_effect=[fake_dns, fake_dns]):
+            hn = net_ip.get_hostname('4.2.2.1')
+        self.assertEquals(hn, 'www.ubuntu.com')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_with_ip_not_fqdn(self, apt_install):
+        fake_dns = FakeDNS('packages.ubuntu.com')
+        with patch(builtin_import, side_effect=[fake_dns, fake_dns]):
+            hn = net_ip.get_hostname('4.2.2.1', fqdn=False)
+        self.assertEquals(hn, 'packages')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_with_hostname(self, apt_install):
+        hn = net_ip.get_hostname('www.ubuntu.com')
+        self.assertEquals(hn, 'www.ubuntu.com')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_with_hostname_trailingdot(self, apt_install):
+        hn = net_ip.get_hostname('www.ubuntu.com.')
+        self.assertEquals(hn, 'www.ubuntu.com')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_with_hostname_not_fqdn(self, apt_install):
+        hn = net_ip.get_hostname('packages.ubuntu.com', fqdn=False)
+        self.assertEquals(hn, 'packages')
+
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_trigger_apt_install(self, apt_install):
+        fake_dns = FakeDNS('www.ubuntu.com')
+        with patch(builtin_import, side_effect=[ImportError, fake_dns,
+                                                fake_dns]):
+            hn = net_ip.get_hostname('4.2.2.1')
+            if six.PY2:
+                apt_install.assert_called_with('python-dnspython', fatal=True)
+            else:
+                apt_install.assert_called_with('python3-dnspython', fatal=True)
+
+        self.assertEquals(hn, 'www.ubuntu.com')
+
+    @patch('charmhelpers.contrib.network.ip.socket.gethostbyaddr')
+    @patch('charmhelpers.contrib.network.ip.ns_query')
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_lookup_fail(self, apt_install, ns_query, socket):
+        fake_dns = FakeDNS('www.ubuntu.com')
+        ns_query.return_value = []
+        socket.return_value = ()
+        with patch(builtin_import, side_effect=[fake_dns, fake_dns]):
+            hn = net_ip.get_hostname('4.2.2.1')
+        self.assertEquals(hn, None)
+
+    @patch('charmhelpers.contrib.network.ip.socket.gethostbyaddr')
+    @patch('charmhelpers.contrib.network.ip.ns_query')
+    @patch('charmhelpers.contrib.network.ip.apt_install')
+    def test_get_hostname_lookup_fail_gethostbyaddr_fallback(
+            self, apt_install, ns_query, socket):
+        fake_dns = FakeDNS('www.ubuntu.com')
+        ns_query.return_value = []
+        socket.return_value = ("www.ubuntu.com", "", "")
+        with patch(builtin_import, side_effect=[fake_dns]):
+            hn = net_ip.get_hostname('4.2.2.1')
+        self.assertEquals(hn, "www.ubuntu.com")
+
+    @patch('charmhelpers.contrib.network.ip.subprocess.call')
+    def test_port_has_listener(self, subprocess_call):
+        subprocess_call.return_value = 1
+        self.assertEqual(net_ip.port_has_listener('ip-address', 50), False)
+        subprocess_call.assert_called_with(['nc', '-z', 'ip-address', '50'])
+        subprocess_call.return_value = 0
+        self.assertEqual(net_ip.port_has_listener('ip-address', 70), True)
+        subprocess_call.assert_called_with(['nc', '-z', 'ip-address', '70'])
+
+    @patch.object(net_ip, 'log', lambda *args, **kwargs: None)
+    @patch.object(net_ip, 'config')
+    @patch.object(net_ip, 'network_get_primary_address')
+    @patch.object(net_ip, 'get_address_in_network')
+    @patch.object(net_ip, 'unit_get')
+    @patch.object(net_ip, 'get_ipv6_addr')
+    @patch.object(net_ip, 'assert_charm_supports_ipv6')
+    def test_get_relation_ip(self, assert_charm_supports_ipv6, get_ipv6_addr,
+                             unit_get, get_address_in_network,
+                             network_get_primary_address, config):
+        ACCESS_IP = '10.50.1.1'
+        ACCESS_NETWORK = '10.50.1.0/24'
+        AMQP_IP = '10.200.1.1'
+        IPV6_IP = '2001:DB8::1'
+        DEFAULT_IP = '172.16.1.1'
+        assert_charm_supports_ipv6.return_value = True
+        get_ipv6_addr.return_value = [IPV6_IP]
+        unit_get.return_value = DEFAULT_IP
+        get_address_in_network.return_value = DEFAULT_IP
+        network_get_primary_address.return_value = AMQP_IP
+
+        # Network-get calls
+        _config = {'prefer-ipv6': False}
+        config.side_effect = lambda key: _config.get(key)
+
+        network_get_primary_address.side_effect = NotImplementedError
+        self.assertEqual(DEFAULT_IP, net_ip.get_relation_ip('amqp'))
+
+        network_get_primary_address.side_effect = net_ip.NoNetworkBinding
+        self.assertEqual(DEFAULT_IP, net_ip.get_relation_ip('doesnotexist'))
+
+        network_get_primary_address.side_effect = None
+        self.assertEqual(AMQP_IP, net_ip.get_relation_ip('amqp'))
+
+        self.assertFalse(get_address_in_network.called)
+
+        # Specific CIDR network
+        get_address_in_network.return_value = ACCESS_IP
+        network_get_primary_address.return_value = DEFAULT_IP
+        self.assertEqual(
+            ACCESS_IP,
+            net_ip.get_relation_ip('shared-db',
+                                   cidr_network=ACCESS_NETWORK))
+        get_address_in_network.assert_called_with(ACCESS_NETWORK, DEFAULT_IP)
+
+        self.assertFalse(assert_charm_supports_ipv6.called)
+
+        # IPv6
+        _config = {'prefer-ipv6': True}
+        config.side_effect = lambda key: _config.get(key)
+        self.assertEqual(IPV6_IP, net_ip.get_relation_ip('amqp'))
+        assert_charm_supports_ipv6.assert_called_with()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ovs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ovs.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cf8e615123f78420c29e4a545d22805d2ae5f99
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ovs.py
@@ -0,0 +1,333 @@
+import subprocess
+import unittest
+
+from mock import patch, call, MagicMock
+
+import charmhelpers.contrib.network.ovs as ovs
+
+from tests.helpers import patch_open
+
+
+# NOTE(fnordahl): some functions drectly under the ``contrib.network.ovs``
+# module have their unit tests in the ``test_ovs.py`` module in the
+# ``tests.contrib.network.ovs`` package.
+
+
+GOOD_CERT = '''Certificate:
+    Data:
+        Version: 1 (0x0)
+        Serial Number: 13798680962510501282 (0xbf7ec33a136235a2)
+    Signature Algorithm: sha1WithRSAEncryption
+        Issuer: C=US, ST=CA, L=Palo Alto, O=Open vSwitch, OU=Open vSwitch
+        Validity
+            Not Before: Jun 28 17:02:19 2013 GMT
+            Not After : Jun 28 17:02:19 2019 GMT
+        Subject: C=US, ST=CA, L=Palo Alto, O=Open vSwitch, OU=Open vSwitch
+        Subject Public Key Info:
+            Public Key Algorithm: rsaEncryption
+                Public-Key: (2048 bit)
+                Modulus:
+                    00:e8:a7:db:0a:6d:c0:16:4a:14:96:1d:74:91:15:
+                    64:3f:ae:2a:54:be:2a:fe:10:14:9a:73:39:d8:58:
+                    74:7f:ab:d5:f2:39:aa:9a:27:7c:31:82:f8:74:42:
+                    46:8d:c5:3b:42:55:52:be:75:7f:a5:b1:ec:d5:29:
+                    9f:62:0e:de:31:27:2b:95:1f:24:0d:ca:8c:48:30:
+                    96:9f:ba:b7:9d:eb:c1:bd:93:05:e3:d8:ca:66:5a:
+                    e9:cb:a5:7a:3a:8d:27:e2:05:9d:88:fc:a9:ef:af:
+                    47:4c:66:ce:c6:43:73:1a:85:f4:5f:b9:53:5b:29:
+                    f3:c3:23:1f:0c:20:95:11:50:71:b2:f6:01:23:3f:
+                    66:0f:5c:43:c2:90:fb:e5:98:73:98:e9:38:bb:1f:
+                    1b:89:97:1e:dc:d7:98:07:68:32:ec:da:1d:69:0b:
+                    e2:df:40:fb:64:52:e5:e9:40:27:b0:ca:73:21:51:
+                    f6:8f:00:20:c0:2b:1a:d4:01:c2:32:38:9d:d1:8d:
+                    88:71:46:a9:42:0d:ee:3b:1c:88:db:27:69:49:f9:
+                    60:34:70:61:3d:60:df:7e:e4:e1:1d:c6:16:89:05:
+                    ba:31:06:eb:88:b5:78:94:5d:8c:9d:88:fe:f2:c2:
+                    80:a1:04:15:d3:84:85:d3:aa:5a:1d:53:5c:f8:57:
+                    ae:61
+                Exponent: 65537 (0x10001)
+    Signature Algorithm: sha1WithRSAEncryption
+         14:7e:ca:c3:fc:93:60:9f:80:e0:65:2e:ef:41:2d:f9:af:77:
+         da:6d:e2:e0:11:70:17:fb:e5:67:4c:f0:ad:39:ec:96:ef:fe:
+         d5:95:94:70:e5:52:31:68:63:8c:ea:b3:a1:8e:02:e2:91:4b:
+         a8:8c:07:86:fd:80:98:a2:b1:90:2b:9c:2e:ab:f4:73:9d:8f:
+         fd:31:b9:8f:fe:6c:af:d6:bf:72:44:89:08:93:19:ef:2b:c3:
+         7c:ab:ba:bc:57:ca:f1:17:e4:e8:81:40:ca:65:df:84:be:10:
+         2c:42:46:af:d2:e0:0d:df:5d:56:53:65:13:e0:20:55:b4:ee:
+         cd:5e:b5:c4:97:1d:3e:a6:c1:9c:7e:b8:87:ee:64:78:a5:59:
+         e5:b2:79:47:9a:8e:59:fa:c4:18:ea:27:fd:a2:d5:76:d0:ae:
+         d9:05:f6:0e:23:ca:7d:66:a1:ba:18:67:f5:6d:bb:51:5a:f5:
+         52:e9:17:bb:63:15:24:b4:61:25:9f:d9:9c:89:58:93:9a:c3:
+         74:55:72:3e:f9:ff:ef:54:7d:e8:28:78:ba:3c:c7:15:ba:b9:
+         c6:e3:8c:61:cb:a9:ed:8d:07:16:0d:8d:f6:1c:36:11:69:08:
+         b8:45:7d:fc:fd:d1:ab:2d:9b:4e:9c:dd:11:78:50:c7:87:9f:
+         4a:24:9c:a0
+-----BEGIN CERTIFICATE-----
+MIIDwjCCAqoCCQC/fsM6E2I1ojANBgkqhkiG9w0BAQUFADCBojELMAkGA1UEBhMC
+VVMxCzAJBgNVBAgTAkNBMRIwEAYDVQQHEwlQYWxvIEFsdG8xFTATBgNVBAoTDE9w
+ZW4gdlN3aXRjaDEfMB0GA1UECxMWT3BlbiB2U3dpdGNoIGNlcnRpZmllcjE6MDgG
+A1UEAxMxb3ZzY2xpZW50IGlkOjU4MTQ5N2E1LWJjMDAtNGVjYy1iNzkwLTU3NTZj
+ZWUxNmE0ODAeFw0xMzA2MjgxNzAyMTlaFw0xOTA2MjgxNzAyMTlaMIGiMQswCQYD
+VQQGEwJVUzELMAkGA1UECBMCQ0ExEjAQBgNVBAcTCVBhbG8gQWx0bzEVMBMGA1UE
+ChMMT3BlbiB2U3dpdGNoMR8wHQYDVQQLExZPcGVuIHZTd2l0Y2ggY2VydGlmaWVy
+MTowOAYDVQQDEzFvdnNjbGllbnQgaWQ6NTgxNDk3YTUtYmMwMC00ZWNjLWI3OTAt
+NTc1NmNlZTE2YTQ4MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6Kfb
+Cm3AFkoUlh10kRVkP64qVL4q/hAUmnM52Fh0f6vV8jmqmid8MYL4dEJGjcU7QlVS
+vnV/pbHs1SmfYg7eMScrlR8kDcqMSDCWn7q3nevBvZMF49jKZlrpy6V6Oo0n4gWd
+iPyp769HTGbOxkNzGoX0X7lTWynzwyMfDCCVEVBxsvYBIz9mD1xDwpD75ZhzmOk4
+ux8biZce3NeYB2gy7NodaQvi30D7ZFLl6UAnsMpzIVH2jwAgwCsa1AHCMjid0Y2I
+cUapQg3uOxyI2ydpSflgNHBhPWDffuThHcYWiQW6MQbriLV4lF2MnYj+8sKAoQQV
+04SF06paHVNc+FeuYQIDAQABMA0GCSqGSIb3DQEBBQUAA4IBAQAUfsrD/JNgn4Dg
+ZS7vQS35r3fabeLgEXAX++VnTPCtOeyW7/7VlZRw5VIxaGOM6rOhjgLikUuojAeG
+/YCYorGQK5wuq/RznY/9MbmP/myv1r9yRIkIkxnvK8N8q7q8V8rxF+TogUDKZd+E
+vhAsQkav0uAN311WU2UT4CBVtO7NXrXElx0+psGcfriH7mR4pVnlsnlHmo5Z+sQY
+6if9otV20K7ZBfYOI8p9ZqG6GGf1bbtRWvVS6Re7YxUktGEln9mciViTmsN0VXI+
++f/vVH3oKHi6PMcVurnG44xhy6ntjQcWDY32HDYRaQi4RX38/dGrLZtOnN0ReFDH
+h59KJJyg
+-----END CERTIFICATE-----
+'''
+
+PEM_ENCODED = '''-----BEGIN CERTIFICATE-----
+MIIDwjCCAqoCCQC/fsM6E2I1ojANBgkqhkiG9w0BAQUFADCBojELMAkGA1UEBhMC
+VVMxCzAJBgNVBAgTAkNBMRIwEAYDVQQHEwlQYWxvIEFsdG8xFTATBgNVBAoTDE9w
+ZW4gdlN3aXRjaDEfMB0GA1UECxMWT3BlbiB2U3dpdGNoIGNlcnRpZmllcjE6MDgG
+A1UEAxMxb3ZzY2xpZW50IGlkOjU4MTQ5N2E1LWJjMDAtNGVjYy1iNzkwLTU3NTZj
+ZWUxNmE0ODAeFw0xMzA2MjgxNzAyMTlaFw0xOTA2MjgxNzAyMTlaMIGiMQswCQYD
+VQQGEwJVUzELMAkGA1UECBMCQ0ExEjAQBgNVBAcTCVBhbG8gQWx0bzEVMBMGA1UE
+ChMMT3BlbiB2U3dpdGNoMR8wHQYDVQQLExZPcGVuIHZTd2l0Y2ggY2VydGlmaWVy
+MTowOAYDVQQDEzFvdnNjbGllbnQgaWQ6NTgxNDk3YTUtYmMwMC00ZWNjLWI3OTAt
+NTc1NmNlZTE2YTQ4MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6Kfb
+Cm3AFkoUlh10kRVkP64qVL4q/hAUmnM52Fh0f6vV8jmqmid8MYL4dEJGjcU7QlVS
+vnV/pbHs1SmfYg7eMScrlR8kDcqMSDCWn7q3nevBvZMF49jKZlrpy6V6Oo0n4gWd
+iPyp769HTGbOxkNzGoX0X7lTWynzwyMfDCCVEVBxsvYBIz9mD1xDwpD75ZhzmOk4
+ux8biZce3NeYB2gy7NodaQvi30D7ZFLl6UAnsMpzIVH2jwAgwCsa1AHCMjid0Y2I
+cUapQg3uOxyI2ydpSflgNHBhPWDffuThHcYWiQW6MQbriLV4lF2MnYj+8sKAoQQV
+04SF06paHVNc+FeuYQIDAQABMA0GCSqGSIb3DQEBBQUAA4IBAQAUfsrD/JNgn4Dg
+ZS7vQS35r3fabeLgEXAX++VnTPCtOeyW7/7VlZRw5VIxaGOM6rOhjgLikUuojAeG
+/YCYorGQK5wuq/RznY/9MbmP/myv1r9yRIkIkxnvK8N8q7q8V8rxF+TogUDKZd+E
+vhAsQkav0uAN311WU2UT4CBVtO7NXrXElx0+psGcfriH7mR4pVnlsnlHmo5Z+sQY
+6if9otV20K7ZBfYOI8p9ZqG6GGf1bbtRWvVS6Re7YxUktGEln9mciViTmsN0VXI+
++f/vVH3oKHi6PMcVurnG44xhy6ntjQcWDY32HDYRaQi4RX38/dGrLZtOnN0ReFDH
+h59KJJyg
+-----END CERTIFICATE-----'''
+
+BAD_CERT = ''' NO MARKERS '''
+TO_PATCH = [
+    "apt_install",
+    "log",
+    "hashlib",
+]
+
+
+class OVSHelpersTest(unittest.TestCase):
+
+    def setUp(self):
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.network.ovs.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    @patch('subprocess.check_output')
+    def test_get_bridges(self, check_output):
+        check_output.return_value = b"br1\n br2  "
+        self.assertEqual(ovs.get_bridges(), ['br1', 'br2'])
+        check_output.assert_called_once_with(['ovs-vsctl', 'list-br'])
+
+    @patch('subprocess.check_output')
+    def test_get_bridge_ports(self, check_output):
+        check_output.return_value = b"p1\n p2  \np3"
+        self.assertEqual(ovs.get_bridge_ports('br1'), ['p1', 'p2', 'p3'])
+        check_output.assert_called_once_with(
+            ['ovs-vsctl', '--', 'list-ports', 'br1'])
+
+    @patch.object(ovs, 'get_bridges')
+    @patch.object(ovs, 'get_bridge_ports')
+    def test_get_bridges_and_ports_map(self, get_bridge_ports, get_bridges):
+        get_bridges.return_value = ['br1', 'br2']
+        get_bridge_ports.side_effect = [
+            ['p1', 'p2'],
+            ['p3']]
+        self.assertEqual(ovs.get_bridges_and_ports_map(), {
+            'br1': ['p1', 'p2'],
+            'br2': ['p3'],
+        })
+
+    @patch('subprocess.check_call')
+    def test_del_bridge(self, check_call):
+        ovs.del_bridge('test')
+        check_call.assert_called_with(["ovs-vsctl", "--", "--if-exists",
+                                       "del-br", 'test'])
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('subprocess.check_call')
+    def test_del_bridge_port(self, check_call):
+        ovs.del_bridge_port('test', 'eth1')
+        check_call.assert_has_calls([
+            call(["ovs-vsctl", "--", "--if-exists", "del-port",
+                  'test', 'eth1']),
+            call(['ip', 'link', 'set', 'eth1', 'down']),
+            call(['ip', 'link', 'set', 'eth1', 'promisc', 'off'])
+        ])
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch.object(ovs, 'port_to_br')
+    @patch.object(ovs, 'add_bridge_port')
+    @patch('subprocess.check_call')
+    def test_add_ovsbridge_linuxbridge(self, check_call,
+                                       add_bridge_port,
+                                       port_to_br):
+        port_to_br.return_value = None
+        with patch_open() as (mock_open, mock_file):
+            ovs.add_ovsbridge_linuxbridge('br-ex', 'br-eno1', ifdata={
+                'external-ids': {'mycharm': 'br-ex'}
+            })
+
+        check_call.assert_called_with(['ifup', 'veth-br-eno1'])
+        add_bridge_port.assert_called_with(
+            'br-ex', 'veth-br-eno1', ifdata={
+                'external-ids': {'mycharm': 'br-ex'}
+            }
+        )
+
+    @patch.object(ovs, 'port_to_br')
+    @patch.object(ovs, 'add_bridge_port')
+    @patch('subprocess.check_call')
+    def test_add_ovsbridge_linuxbridge_already_direct_wired(self,
+                                                            check_call,
+                                                            add_bridge_port,
+                                                            port_to_br):
+        port_to_br.return_value = 'br-ex'
+        ovs.add_ovsbridge_linuxbridge('br-ex', 'br-eno1')
+        check_call.assert_not_called()
+        add_bridge_port.assert_not_called()
+
+    @patch.object(ovs, 'port_to_br')
+    @patch.object(ovs, 'add_bridge_port')
+    @patch('subprocess.check_call')
+    def test_add_ovsbridge_linuxbridge_longname(self, check_call,
+                                                add_bridge_port,
+                                                port_to_br):
+        port_to_br.return_value = None
+        mock_hasher = MagicMock()
+        mock_hasher.hexdigest.return_value = '12345678901234578910'
+        self.hashlib.sha256.return_value = mock_hasher
+        with patch_open() as (mock_open, mock_file):
+            ovs.add_ovsbridge_linuxbridge('br-ex', 'br-reallylongname')
+
+        check_call.assert_called_with(['ifup', 'cvb12345678-10'])
+        add_bridge_port.assert_called_with(
+            'br-ex', 'cvb12345678-10', ifdata=None
+        )
+
+    @patch('os.path.exists')
+    def test_is_linuxbridge_interface_false(self, exists):
+        exists.return_value = False
+        result = ovs.is_linuxbridge_interface('eno1')
+        self.assertFalse(result)
+
+    @patch('os.path.exists')
+    def test_is_linuxbridge_interface_true(self, exists):
+        exists.return_value = True
+        result = ovs.is_linuxbridge_interface('eno1')
+        self.assertTrue(result)
+
+    @patch('subprocess.check_call')
+    def test_set_manager(self, check_call):
+        ovs.set_manager('manager')
+        check_call.assert_called_with(['ovs-vsctl', 'set-manager',
+                                       'ssl:manager'])
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('subprocess.check_call')
+    def test_set_Open_vSwitch_column_value(self, check_call):
+        ovs.set_Open_vSwitch_column_value('other_config:foo=bar')
+        check_call.assert_called_with(['ovs-vsctl', 'set',
+                                       'Open_vSwitch', '.', 'other_config:foo=bar'])
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('os.path.exists')
+    def test_get_certificate_good_cert(self, exists):
+        exists.return_value = True
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.return_value = GOOD_CERT
+            self.assertEqual(ovs.get_certificate(), PEM_ENCODED)
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('os.path.exists')
+    def test_get_certificate_bad_cert(self, exists):
+        exists.return_value = True
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.return_value = BAD_CERT
+            self.assertRaises(RuntimeError, ovs.get_certificate)
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('os.path.exists')
+    def test_get_certificate_missing(self, exists):
+        exists.return_value = False
+        self.assertIsNone(ovs.get_certificate())
+        self.assertTrue(self.log.call_count == 1)
+
+    @patch('os.path.exists')
+    @patch.object(ovs, 'service')
+    def test_full_restart(self, service, exists):
+        exists.return_value = False
+        ovs.full_restart()
+        service.assert_called_with('force-reload-kmod', 'openvswitch-switch')
+
+    @patch('os.path.exists')
+    @patch.object(ovs, 'service')
+    def test_full_restart_upstart(self, service, exists):
+        exists.return_value = True
+        ovs.full_restart()
+        service.assert_called_with('start', 'openvswitch-force-reload-kmod')
+
+    @patch('subprocess.check_output')
+    def test_port_to_br(self, check_output):
+        check_output.return_value = b'br-ex'
+        self.assertEqual(ovs.port_to_br('br-lb'),
+                         'br-ex')
+
+    @patch('subprocess.check_output')
+    def test_port_to_br_not_found(self, check_output):
+        check_output.side_effect = subprocess.CalledProcessError(1, 'not found')
+        self.assertEqual(ovs.port_to_br('br-lb'), None)
+
+    @patch('subprocess.check_call')
+    def test_enable_ipfix_defaults(self, check_call):
+        ovs.enable_ipfix('br-int',
+                         '10.5.0.10:4739')
+        check_call.assert_called_once_with([
+            'ovs-vsctl', 'set', 'Bridge', 'br-int', 'ipfix=@i', '--',
+            '--id=@i', 'create', 'IPFIX',
+            'targets="10.5.0.10:4739"',
+            'sampling=64',
+            'cache_active_timeout=60',
+            'cache_max_flows=128',
+        ])
+
+    @patch('subprocess.check_call')
+    def test_enable_ipfix_values(self, check_call):
+        ovs.enable_ipfix('br-int',
+                         '10.5.0.10:4739',
+                         sampling=120,
+                         cache_max_flows=24,
+                         cache_active_timeout=120)
+        check_call.assert_called_once_with([
+            'ovs-vsctl', 'set', 'Bridge', 'br-int', 'ipfix=@i', '--',
+            '--id=@i', 'create', 'IPFIX',
+            'targets="10.5.0.10:4739"',
+            'sampling=120',
+            'cache_active_timeout=120',
+            'cache_max_flows=24',
+        ])
+
+    @patch('subprocess.check_call')
+    def test_disable_ipfix(self, check_call):
+        ovs.disable_ipfix('br-int')
+        check_call.assert_called_once_with(
+            ['ovs-vsctl', 'clear', 'Bridge', 'br-int', 'ipfix']
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ufw.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ufw.py
new file mode 100644
index 0000000000000000000000000000000000000000..6eddc021cf0208dd4775c4c27d0ef048295890b0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/network/test_ufw.py
@@ -0,0 +1,550 @@
+from __future__ import print_function
+
+import mock
+import os
+import subprocess
+import unittest
+
+from charmhelpers.contrib.network import ufw
+
+__author__ = 'Felipe Reyes <felipe.reyes@canonical.com>'
+
+
+LSMOD_NO_IP6 = """Module                  Size  Used by
+raid1                  39533  1
+psmouse               106548  0
+raid0                  17842  0
+ahci                   34062  5
+multipath              13145  0
+r8169                  71471  0
+libahci                32424  1 ahci
+mii                    13934  1 r8169
+linear                 12894  0
+"""
+LSMOD_IP6 = """Module                  Size  Used by
+xt_hl                  12521  0
+ip6_tables             27026  0
+ip6t_rt                13537  0
+nf_conntrack_ipv6      18894  0
+nf_defrag_ipv6         34769  1 nf_conntrack_ipv6
+xt_recent              18457  0
+xt_LOG                 17702  0
+xt_limit               12711  0
+"""
+DEFAULT_POLICY_OUTPUT = """Default incoming policy changed to 'deny'
+(be sure to update your rules accordingly)
+"""
+DEFAULT_POLICY_OUTPUT_OUTGOING = """Default outgoing policy changed to 'allow'
+(be sure to update your rules accordingly)
+"""
+
+UFW_STATUS_NUMBERED = """Status: active
+
+     To                         Action      From
+     --                         ------      ----
+[ 1] 6641/tcp                   ALLOW IN    10.219.3.86                # charm-ovn-central
+[12] 6641/tcp                   REJECT IN   Anywhere
+[19] 6644/tcp (v6)              REJECT IN   Anywhere (v6)              # charm-ovn-central
+
+"""
+
+
+class TestUFW(unittest.TestCase):
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_enable_ok(self, modprobe, check_output, log):
+        msg = 'Firewall is active and enabled on system startup\n'
+        check_output.return_value = msg
+        self.assertTrue(ufw.enable())
+
+        check_output.assert_any_call(['ufw', 'enable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call('ufw enabled', level='INFO')
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_enable_fail(self, modprobe, check_output, log):
+        msg = 'neneene\n'
+        check_output.return_value = msg
+        self.assertFalse(ufw.enable())
+
+        check_output.assert_any_call(['ufw', 'enable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call("ufw couldn't be enabled", level='WARN')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_disable_ok(self, check_output, log, is_enabled):
+        is_enabled.return_value = True
+        msg = 'Firewall stopped and disabled on system startup\n'
+        check_output.return_value = msg
+        self.assertTrue(ufw.disable())
+
+        check_output.assert_any_call(['ufw', 'disable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call('ufw disabled', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_disable_fail(self, check_output, log, is_enabled):
+        is_enabled.return_value = True
+        msg = 'neneene\n'
+        check_output.return_value = msg
+        self.assertFalse(ufw.disable())
+
+        check_output.assert_any_call(['ufw', 'disable'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call("ufw couldn't be disabled", level='WARN')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_modify_access_ufw_is_disabled(self, check_output, log,
+                                           is_enabled):
+        is_enabled.return_value = False
+        ufw.modify_access('127.0.0.1')
+        log.assert_any_call('ufw is disabled, skipping modify_access()',
+                            level='WARN')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_allow(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('127.0.0.1')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1', 'to',
+                               'any'], stdout=subprocess.PIPE)
+        log.assert_any_call('ufw allow: ufw allow from 127.0.0.1 to any',
+                            level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_allow_set_proto(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('127.0.0.1', proto='udp')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1', 'to',
+                               'any', 'proto', 'udp'], stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw allow from 127.0.0.1 '
+                             'to any proto udp'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_allow_set_port(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('127.0.0.1', port='80')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1', 'to',
+                               'any', 'port', '80'], stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw allow from 127.0.0.1 '
+                             'to any port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_allow_set_dst(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('127.0.0.1', dst='127.0.0.1', port='80')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1', 'to',
+                               '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_allow_ipv6(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('::1', dst='::1', port='80')
+        popen.assert_any_call(['ufw', 'allow', 'from', '::1', 'to',
+                               '::1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw allow from ::1 '
+                             'to ::1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_with_index(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.modify_access('127.0.0.1', dst='127.0.0.1', port='80', index=1)
+        popen.assert_any_call(['ufw', 'insert', '1', 'allow', 'from',
+                               '127.0.0.1', 'to', '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw insert 1 allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_prepend(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+        ufw.modify_access('127.0.0.1', dst='127.0.0.1', port='80',
+                          prepend=True)
+        popen.assert_any_call(['ufw', 'prepend', 'allow', 'from', '127.0.0.1',
+                               'to', '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw prepend allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_comment(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+        ufw.modify_access('127.0.0.1', dst='127.0.0.1', port='80',
+                          comment='No comment')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1',
+                               'to', '127.0.0.1', 'port', '80',
+                               'comment', 'No comment'],
+                              stdout=subprocess.PIPE)
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_modify_access_delete_index(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+        ufw.modify_access(None, dst=None, action='delete', index=42)
+        popen.assert_any_call(['ufw', '--force', 'delete', '42'],
+                              stdout=subprocess.PIPE)
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_grant_access(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.grant_access('127.0.0.1', dst='127.0.0.1', port='80')
+        popen.assert_any_call(['ufw', 'allow', 'from', '127.0.0.1', 'to',
+                               '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_grant_access_with_index(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.grant_access('127.0.0.1', dst='127.0.0.1', port='80', index=1)
+        popen.assert_any_call(['ufw', 'insert', '1', 'allow', 'from',
+                               '127.0.0.1', 'to', '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw allow: ufw insert 1 allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.Popen')
+    def test_revoke_access(self, popen, log, is_enabled):
+        is_enabled.return_value = True
+        p = mock.Mock()
+        p.configure_mock(**{'communicate.return_value': ('stdout', 'stderr'),
+                            'returncode': 0})
+        popen.return_value = p
+
+        ufw.revoke_access('127.0.0.1', dst='127.0.0.1', port='80')
+        popen.assert_any_call(['ufw', 'delete', 'allow', 'from', '127.0.0.1',
+                               'to', '127.0.0.1', 'port', '80'],
+                              stdout=subprocess.PIPE)
+        log.assert_any_call(('ufw delete: ufw delete allow from 127.0.0.1 '
+                             'to 127.0.0.1 port 80'), level='DEBUG')
+        log.assert_any_call('stdout', level='INFO')
+
+    @mock.patch('subprocess.check_output')
+    def test_service_open(self, check_output):
+        ufw.service('ssh', 'open')
+        check_output.assert_any_call(['ufw', 'allow', 'ssh'],
+                                     universal_newlines=True)
+
+    @mock.patch('subprocess.check_output')
+    def test_service_close(self, check_output):
+        ufw.service('ssh', 'close')
+        check_output.assert_any_call(['ufw', 'delete', 'allow', 'ssh'],
+                                     universal_newlines=True)
+
+    @mock.patch('subprocess.check_output')
+    def test_service_unsupport_action(self, check_output):
+        self.assertRaises(ufw.UFWError, ufw.service, 'ssh', 'nenene')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('os.path.isdir')
+    @mock.patch('subprocess.call')
+    @mock.patch('subprocess.check_output')
+    def test_no_ipv6(self, check_output, call, isdir, log, is_enabled):
+        check_output.return_value = ('Firewall is active and enabled '
+                                     'on system startup\n')
+        isdir.return_value = False
+        call.return_value = 0
+        is_enabled.return_value = False
+        ufw.enable()
+
+        call.assert_called_with(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+        log.assert_any_call('IPv6 support in ufw disabled', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('os.path.isdir')
+    @mock.patch('subprocess.call')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_no_ip6_tables(self, modprobe, check_output, call, isdir, log,
+                           is_enabled):
+        def c(*args, **kwargs):
+            if args[0] == ['lsmod']:
+                return LSMOD_NO_IP6
+            elif args[0] == ['modprobe', 'ip6_tables']:
+                return ""
+            else:
+                return 'Firewall is active and enabled on system startup\n'
+
+        check_output.side_effect = c
+        isdir.return_value = True
+        call.return_value = 0
+
+        is_enabled.return_value = False
+        self.assertTrue(ufw.enable())
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('os.path.isdir')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    @mock.patch('charmhelpers.contrib.network.ufw.is_module_loaded')
+    def test_no_ip6_tables_fail_to_load(self, is_module_loaded,
+                                        modprobe, isdir, log, is_enabled):
+        is_module_loaded.return_value = False
+
+        def c(m):
+            raise subprocess.CalledProcessError(1, ['modprobe',
+                                                    'ip6_tables'],
+                                                "fail to load ip6_tables")
+
+        modprobe.side_effect = c
+        isdir.return_value = True
+        is_enabled.return_value = False
+
+        self.assertRaises(ufw.UFWIPv6Error, ufw.enable)
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('os.path.isdir')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    @mock.patch('charmhelpers.contrib.network.ufw.is_module_loaded')
+    @mock.patch('subprocess.call')
+    @mock.patch('subprocess.check_output')
+    def test_no_ip6_tables_fail_to_load_soft_fail(self, check_output,
+                                                  call, is_module_loaded,
+                                                  modprobe,
+                                                  isdir, log, is_enabled):
+        is_module_loaded.return_value = False
+
+        def c(m):
+            raise subprocess.CalledProcessError(1, ['modprobe',
+                                                    'ip6_tables'],
+                                                "fail to load ip6_tables")
+
+        modprobe.side_effect = c
+        isdir.return_value = True
+        call.return_value = 0
+        check_output.return_value = ("Firewall is active and enabled on "
+                                     "system startup\n")
+        is_enabled.return_value = False
+        self.assertTrue(ufw.enable(soft_fail=True))
+        call.assert_called_with(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+        log.assert_any_call('IPv6 support in ufw disabled', level='INFO')
+
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('os.path.isdir')
+    @mock.patch('subprocess.call')
+    @mock.patch('subprocess.check_output')
+    def test_no_ipv6_failed_disabling_ufw(self, check_output, call, isdir,
+                                          log, is_enabled):
+        check_output.return_value = ('Firewall is active and enabled '
+                                     'on system startup\n')
+        isdir.return_value = False
+        call.return_value = 1
+        is_enabled.return_value = False
+        self.assertRaises(ufw.UFWError, ufw.enable)
+
+        call.assert_called_with(['sed', '-i', 's/IPV6=.*/IPV6=no/g',
+                                 '/etc/default/ufw'])
+        log.assert_any_call("Couldn't disable IPv6 support in ufw",
+                            level="ERROR")
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('charmhelpers.contrib.network.ufw.is_enabled')
+    @mock.patch('os.path.isdir')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_with_ipv6(self, modprobe, check_output, isdir, is_enabled, log):
+        def c(*args, **kwargs):
+            if args[0] == ['lsmod']:
+                return LSMOD_IP6
+            else:
+                return 'Firewall is active and enabled on system startup\n'
+
+        check_output.side_effect = c
+        is_enabled.return_value = False
+        isdir.return_value = True
+        ufw.enable()
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_change_default_policy(self, check_output, log):
+        check_output.return_value = DEFAULT_POLICY_OUTPUT
+        self.assertTrue(ufw.default_policy())
+        check_output.asser_any_call(['ufw', 'default', 'deny', 'incoming'])
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_change_default_policy_allow_outgoing(self, check_output, log):
+        check_output.return_value = DEFAULT_POLICY_OUTPUT_OUTGOING
+        self.assertTrue(ufw.default_policy('allow', 'outgoing'))
+        check_output.asser_any_call(['ufw', 'default', 'allow', 'outgoing'])
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_change_default_policy_unexpected_output(self, check_output, log):
+        check_output.return_value = "asdf"
+        self.assertFalse(ufw.default_policy())
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_change_default_policy_wrong_policy(self, check_output, log):
+        self.assertRaises(ufw.UFWError, ufw.default_policy, 'asdf')
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    def test_change_default_policy_wrong_direction(self, check_output, log):
+        self.assertRaises(ufw.UFWError, ufw.default_policy, 'allow', 'asdf')
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_reload_ok(self, modprobe, check_output, log):
+        msg = 'Firewall reloaded\n'
+        check_output.return_value = msg
+        self.assertTrue(ufw.reload())
+
+        check_output.assert_any_call(['ufw', 'reload'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call('ufw reloaded', level='INFO')
+
+    @mock.patch('charmhelpers.core.hookenv.log')
+    @mock.patch('subprocess.check_output')
+    @mock.patch('charmhelpers.contrib.network.ufw.modprobe')
+    def test_reload_fail(self, modprobe, check_output, log):
+        msg = 'This did not work\n'
+        check_output.return_value = msg
+        self.assertFalse(ufw.reload())
+
+        check_output.assert_any_call(['ufw', 'reload'],
+                                     universal_newlines=True,
+                                     env={'LANG': 'en_US',
+                                          'PATH': os.environ['PATH']})
+        log.assert_any_call(msg, level='DEBUG')
+        log.assert_any_call("ufw couldn't be reloaded", level='WARN')
+
+    def test_status(self):
+        with mock.patch('subprocess.check_output') as check_output:
+            check_output.return_value = UFW_STATUS_NUMBERED
+            expect = {
+                1: {'to': '6641/tcp', 'action': 'allow in',
+                    'from': '10.219.3.86', 'ipv6': False,
+                    'comment': 'charm-ovn-central'},
+                12: {'to': '6641/tcp', 'action': 'reject in',
+                     'from': 'any', 'ipv6': False,
+                     'comment': ''},
+                19: {'to': '6644/tcp', 'action': 'reject in',
+                     'from': 'any', 'ipv6': True,
+                     'comment': 'charm-ovn-central'},
+            }
+            n_rules = 0
+            for n, r in ufw.status():
+                self.assertDictEqual(r, expect[n])
+                n_rules += 1
+            self.assertEquals(n_rules, 3)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/ha/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/ha/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/ha/test_ha_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/ha/test_ha_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a83963211d1079e0237492a1fb162046fbf52b49
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/ha/test_ha_utils.py
@@ -0,0 +1,445 @@
+from mock import patch
+import unittest
+import json
+
+from charmhelpers.contrib.openstack.ha import utils as ha
+
+IFACE_LOOKUPS = {
+    '10.5.100.1': 'eth1',
+    'ffff::1': 'eth1',
+    'ffaa::1': 'eth2',
+}
+
+NETMASK_LOOKUPS = {
+    '10.5.100.1': '255.255.255.0',
+    'ffff::1': '64',
+    'ffaa::1': '32',
+}
+
+
+class HATests(unittest.TestCase):
+    def setUp(self):
+        super(HATests, self).setUp()
+        [self._patch(m) for m in [
+            'charm_name',
+            'config',
+            'relation_set',
+            'resolve_address',
+            'status_set',
+            'get_hacluster_config',
+            'get_iface_for_address',
+            'get_netmask_for_address',
+        ]]
+        self.resources = {'res_test_haproxy': 'lsb:haproxy'}
+        self.resource_params = {'res_test_haproxy': 'op monitor interval="5s"'}
+        self.conf = {}
+        self.config.side_effect = lambda key: self.conf.get(key)
+        self.maxDiff = None
+        self.get_iface_for_address.side_effect = \
+            lambda x: IFACE_LOOKUPS.get(x)
+        self.get_netmask_for_address.side_effect = \
+            lambda x: NETMASK_LOOKUPS.get(x)
+
+    def _patch(self, method):
+        _m = patch.object(ha, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    @patch.object(ha, 'log', lambda *args, **kwargs: None)
+    @patch.object(ha, 'assert_charm_supports_dns_ha')
+    def test_update_dns_ha_resource_params_none(self,
+                                                assert_charm_supports_dns_ha):
+        self.conf = {
+            'os-admin-hostname': None,
+            'os-internal-hostname': None,
+            'os-public-hostname': None,
+        }
+
+        with self.assertRaises(ha.DNSHAException):
+            ha.update_dns_ha_resource_params(
+                relation_id='ha:1',
+                resources=self.resources,
+                resource_params=self.resource_params)
+
+    @patch.object(ha, 'log', lambda *args, **kwargs: None)
+    @patch.object(ha, 'assert_charm_supports_dns_ha')
+    def test_update_dns_ha_resource_params_one(self,
+                                               assert_charm_supports_dns_ha):
+        EXPECTED_RESOURCES = {'res_test_public_hostname': 'ocf:maas:dns',
+                              'res_test_haproxy': 'lsb:haproxy'}
+        EXPECTED_RESOURCE_PARAMS = {
+            'res_test_public_hostname': ('params fqdn="test.maas" '
+                                         'ip_address="10.0.0.1"'),
+            'res_test_haproxy': 'op monitor interval="5s"'}
+
+        self.conf = {
+            'os-admin-hostname': None,
+            'os-internal-hostname': None,
+            'os-public-hostname': 'test.maas',
+        }
+
+        self.charm_name.return_value = 'test'
+        self.resolve_address.return_value = '10.0.0.1'
+        ha.update_dns_ha_resource_params(relation_id='ha:1',
+                                         resources=self.resources,
+                                         resource_params=self.resource_params)
+        self.assertEqual(self.resources, EXPECTED_RESOURCES)
+        self.assertEqual(self.resource_params, EXPECTED_RESOURCE_PARAMS)
+        self.relation_set.assert_called_with(
+            groups={'grp_test_hostnames': 'res_test_public_hostname'},
+            relation_id='ha:1')
+
+    @patch.object(ha, 'log', lambda *args, **kwargs: None)
+    @patch.object(ha, 'assert_charm_supports_dns_ha')
+    def test_update_dns_ha_resource_params_all(self,
+                                               assert_charm_supports_dns_ha):
+        EXPECTED_RESOURCES = {'res_test_admin_hostname': 'ocf:maas:dns',
+                              'res_test_int_hostname': 'ocf:maas:dns',
+                              'res_test_public_hostname': 'ocf:maas:dns',
+                              'res_test_haproxy': 'lsb:haproxy'}
+        EXPECTED_RESOURCE_PARAMS = {
+            'res_test_admin_hostname': ('params fqdn="test.admin.maas" '
+                                        'ip_address="10.0.0.1"'),
+            'res_test_int_hostname': ('params fqdn="test.internal.maas" '
+                                      'ip_address="10.0.0.1"'),
+            'res_test_public_hostname': ('params fqdn="test.public.maas" '
+                                         'ip_address="10.0.0.1"'),
+            'res_test_haproxy': 'op monitor interval="5s"'}
+
+        self.conf = {
+            'os-admin-hostname': 'test.admin.maas',
+            'os-internal-hostname': 'test.internal.maas',
+            'os-public-hostname': 'test.public.maas',
+        }
+
+        self.charm_name.return_value = 'test'
+        self.resolve_address.return_value = '10.0.0.1'
+        ha.update_dns_ha_resource_params(relation_id='ha:1',
+                                         resources=self.resources,
+                                         resource_params=self.resource_params)
+        self.assertEqual(self.resources, EXPECTED_RESOURCES)
+        self.assertEqual(self.resource_params, EXPECTED_RESOURCE_PARAMS)
+        self.relation_set.assert_called_with(
+            groups={'grp_test_hostnames':
+                    ('res_test_admin_hostname '
+                     'res_test_int_hostname '
+                     'res_test_public_hostname')},
+            relation_id='ha:1')
+
+    @patch.object(ha, 'lsb_release')
+    def test_assert_charm_supports_dns_ha(self, lsb_release):
+        lsb_release.return_value = {'DISTRIB_RELEASE': '16.04'}
+        self.assertTrue(ha.assert_charm_supports_dns_ha())
+
+    @patch.object(ha, 'lsb_release')
+    def test_assert_charm_supports_dns_ha_exception(self, lsb_release):
+        lsb_release.return_value = {'DISTRIB_RELEASE': '12.04'}
+        self.assertRaises(ha.DNSHAException,
+                          lambda: ha.assert_charm_supports_dns_ha())
+
+    @patch.object(ha, 'expected_related_units')
+    def tests_expect_ha(self, expected_related_units):
+        expected_related_units.return_value = (x for x in [])
+        self.conf = {'vip': None,
+                     'dns-ha': None}
+        self.assertFalse(ha.expect_ha())
+
+        expected_related_units.return_value = (x for x in ['hacluster-unit/0',
+                                                           'hacluster-unit/1',
+                                                           'hacluster-unit/2'])
+        self.conf = {'vip': None,
+                     'dns-ha': None}
+        self.assertTrue(ha.expect_ha())
+
+        expected_related_units.side_effect = NotImplementedError
+        self.conf = {'vip': '10.0.0.1',
+                     'dns-ha': None}
+        self.assertTrue(ha.expect_ha())
+
+        self.conf = {'vip': None,
+                     'dns-ha': True}
+        self.assertTrue(ha.expect_ha())
+
+    def test_get_vip_settings(self):
+        self.assertEqual(
+            ha.get_vip_settings('10.5.100.1'),
+            ('eth1', '255.255.255.0', False))
+
+    def test_get_vip_settings_fallback(self):
+        self.conf = {'vip_iface': 'eth3',
+                     'vip_cidr': '255.255.0.0'}
+        self.assertEqual(
+            ha.get_vip_settings('192.168.100.1'),
+            ('eth3', '255.255.0.0', True))
+
+    def test_update_hacluster_vip_single_vip(self):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1'
+        }
+        test_data = {'resources': {}, 'resource_params': {}}
+        expected = {
+            'delete_resources': ['res_testservice_eth1_vip'],
+            'groups': {
+                'grp_testservice_vips': 'res_testservice_242d562_vip'
+            },
+            'resource_params': {
+                'res_testservice_242d562_vip':
+                    ('params ip="10.5.100.1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"')
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2'
+            }
+        }
+        ha.update_hacluster_vip('testservice', test_data)
+        self.assertEqual(test_data, expected)
+
+    def test_update_hacluster_vip_single_vip_fallback(self):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1'
+        }
+        test_data = {'resources': {}, 'resource_params': {}}
+        expected = {
+            'delete_resources': ['res_testservice_eth1_vip'],
+            'groups': {
+                'grp_testservice_vips': 'res_testservice_242d562_vip'
+            },
+            'resource_params': {
+                'res_testservice_242d562_vip':
+                    ('params ip="10.5.100.1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"')
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2'
+            }
+        }
+        ha.update_hacluster_vip('testservice', test_data)
+        self.assertEqual(test_data, expected)
+
+    def test_update_hacluster_config_vip(self):
+        self.get_iface_for_address.side_effect = lambda x: None
+        self.get_netmask_for_address.side_effect = lambda x: None
+        self.conf = {'vip_iface': 'eth1',
+                     'vip_cidr': '255.255.255.0'}
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1'
+        }
+        test_data = {'resources': {}, 'resource_params': {}}
+        expected = {
+            'delete_resources': ['res_testservice_eth1_vip'],
+            'groups': {
+                'grp_testservice_vips': 'res_testservice_242d562_vip'
+            },
+            'resource_params': {
+                'res_testservice_242d562_vip': (
+                    'params ip="10.5.100.1" cidr_netmask="255.255.255.0" '
+                    'nic="eth1" op monitor timeout="20s" '
+                    'interval="10s" depth="0"')
+
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2'
+            }
+        }
+        ha.update_hacluster_vip('testservice', test_data)
+        self.assertEqual(test_data, expected)
+
+    def test_update_hacluster_vip_multiple_vip(self):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1 ffff::1 ffaa::1'
+        }
+        test_data = {'resources': {}, 'resource_params': {}}
+        expected = {
+            'groups': {
+                'grp_testservice_vips': ('res_testservice_242d562_vip '
+                                         'res_testservice_856d56f_vip '
+                                         'res_testservice_f563c5d_vip')
+            },
+            'delete_resources': ['res_testservice_eth1_vip',
+                                 'res_testservice_eth1_vip_ipv6addr',
+                                 'res_testservice_eth2_vip'],
+            'resource_params': {
+                'res_testservice_242d562_vip':
+                    ('params ip="10.5.100.1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_856d56f_vip':
+                    ('params ipv6addr="ffff::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_f563c5d_vip':
+                    ('params ipv6addr="ffaa::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2',
+                'res_testservice_856d56f_vip': 'ocf:heartbeat:IPv6addr',
+                'res_testservice_f563c5d_vip': 'ocf:heartbeat:IPv6addr',
+            }
+        }
+        ha.update_hacluster_vip('testservice', test_data)
+        self.assertEqual(test_data, expected)
+
+    def test_generate_ha_relation_data_haproxy_disabled(self):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1 ffff::1 ffaa::1'
+        }
+        extra_settings = {
+            'colocations': {'vip_cauth': 'inf: res_nova_cauth grp_nova_vips'},
+            'init_services': {'res_nova_cauth': 'nova-cauth'},
+            'delete_resources': ['res_ceilometer_polling'],
+            'groups': {'grp_testservice_wombles': 'res_testservice_orinoco'},
+        }
+        expected = {
+            'colocations': {'vip_cauth': 'inf: res_nova_cauth grp_nova_vips'},
+            'groups': {
+                'grp_testservice_vips': ('res_testservice_242d562_vip '
+                                         'res_testservice_856d56f_vip '
+                                         'res_testservice_f563c5d_vip'),
+                'grp_testservice_wombles': 'res_testservice_orinoco'
+            },
+            'resource_params': {
+                'res_testservice_242d562_vip':
+                    ('params ip="10.5.100.1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_856d56f_vip':
+                    ('params ipv6addr="ffff::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_f563c5d_vip':
+                    ('params ipv6addr="ffaa::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2',
+                'res_testservice_856d56f_vip': 'ocf:heartbeat:IPv6addr',
+                'res_testservice_f563c5d_vip': 'ocf:heartbeat:IPv6addr',
+            },
+            'clones': {},
+            'init_services': {
+                'res_nova_cauth': 'nova-cauth'
+            },
+            'delete_resources': ["res_ceilometer_polling",
+                                 "res_testservice_eth1_vip",
+                                 "res_testservice_eth1_vip_ipv6addr",
+                                 "res_testservice_eth2_vip"],
+        }
+        expected = {
+            'json_{}'.format(k): json.dumps(v, **ha.JSON_ENCODE_OPTIONS)
+            for k, v in expected.items() if v
+        }
+        self.assertEqual(
+            ha.generate_ha_relation_data('testservice',
+                                         haproxy_enabled=False,
+                                         extra_settings=extra_settings),
+            expected)
+
+    def test_generate_ha_relation_data(self):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1 ffff::1 ffaa::1'
+        }
+        extra_settings = {
+            'colocations': {'vip_cauth': 'inf: res_nova_cauth grp_nova_vips'},
+            'init_services': {'res_nova_cauth': 'nova-cauth'},
+            'delete_resources': ['res_ceilometer_polling'],
+            'groups': {'grp_testservice_wombles': 'res_testservice_orinoco'},
+        }
+        expected = {
+            'colocations': {'vip_cauth': 'inf: res_nova_cauth grp_nova_vips'},
+            'groups': {
+                'grp_testservice_vips': ('res_testservice_242d562_vip '
+                                         'res_testservice_856d56f_vip '
+                                         'res_testservice_f563c5d_vip'),
+                'grp_testservice_wombles': 'res_testservice_orinoco'
+            },
+            'resource_params': {
+                'res_testservice_242d562_vip':
+                    ('params ip="10.5.100.1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_856d56f_vip':
+                    ('params ipv6addr="ffff::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_f563c5d_vip':
+                    ('params ipv6addr="ffaa::1" op monitor '
+                     'timeout="20s" interval="10s" depth="0"'),
+                'res_testservice_haproxy':
+                    ('meta migration-threshold="INFINITY" failure-timeout="5s" '
+                     'op monitor interval="5s"'),
+            },
+            'resources': {
+                'res_testservice_242d562_vip': 'ocf:heartbeat:IPaddr2',
+                'res_testservice_856d56f_vip': 'ocf:heartbeat:IPv6addr',
+                'res_testservice_f563c5d_vip': 'ocf:heartbeat:IPv6addr',
+                'res_testservice_haproxy': 'lsb:haproxy',
+            },
+            'clones': {
+                'cl_testservice_haproxy': 'res_testservice_haproxy',
+            },
+            'init_services': {
+                'res_testservice_haproxy': 'haproxy',
+                'res_nova_cauth': 'nova-cauth'
+            },
+            'delete_resources': ["res_ceilometer_polling",
+                                 "res_testservice_eth1_vip",
+                                 "res_testservice_eth1_vip_ipv6addr",
+                                 "res_testservice_eth2_vip"],
+        }
+        expected = {
+            'json_{}'.format(k): json.dumps(v, **ha.JSON_ENCODE_OPTIONS)
+            for k, v in expected.items() if v
+        }
+        self.assertEqual(
+            ha.generate_ha_relation_data('testservice',
+                                         extra_settings=extra_settings),
+            expected)
+
+    @patch.object(ha, 'log')
+    @patch.object(ha, 'assert_charm_supports_dns_ha')
+    def test_generate_ha_relation_data_dns_ha(self,
+                                              assert_charm_supports_dns_ha,
+                                              log):
+        self.get_hacluster_config.return_value = {
+            'vip': '10.5.100.1 ffff::1 ffaa::1'
+        }
+        self.conf = {
+            'os-admin-hostname': 'test.admin.maas',
+            'os-internal-hostname': 'test.internal.maas',
+            'os-public-hostname': 'test.public.maas',
+            'dns-ha': True,
+        }
+        self.resolve_address.return_value = '10.0.0.1'
+        assert_charm_supports_dns_ha.return_value = True
+        expected = {
+            'groups': {
+                'grp_testservice_hostnames': ('res_testservice_admin_hostname'
+                                              ' res_testservice_int_hostname'
+                                              ' res_testservice_public_hostname')
+            },
+            'resource_params': {
+                'res_testservice_admin_hostname':
+                    'params fqdn="test.admin.maas" ip_address="10.0.0.1"',
+                'res_testservice_int_hostname':
+                    'params fqdn="test.internal.maas" ip_address="10.0.0.1"',
+                'res_testservice_public_hostname':
+                    'params fqdn="test.public.maas" ip_address="10.0.0.1"',
+                'res_testservice_haproxy':
+                    ('meta migration-threshold="INFINITY" failure-timeout="5s" '
+                     'op monitor interval="5s"'),
+            },
+            'resources': {
+                'res_testservice_admin_hostname': 'ocf:maas:dns',
+                'res_testservice_int_hostname': 'ocf:maas:dns',
+                'res_testservice_public_hostname': 'ocf:maas:dns',
+                'res_testservice_haproxy': 'lsb:haproxy',
+            },
+            'clones': {
+                'cl_testservice_haproxy': 'res_testservice_haproxy',
+            },
+            'init_services': {
+                'res_testservice_haproxy': 'haproxy'
+            },
+        }
+        expected = {
+            'json_{}'.format(k): json.dumps(v, **ha.JSON_ENCODE_OPTIONS)
+            for k, v in expected.items() if v
+        }
+        self.assertEqual(ha.generate_ha_relation_data('testservice'),
+                         expected)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_alternatives.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_alternatives.py
new file mode 100644
index 0000000000000000000000000000000000000000..402f0d42088c7e66afd043028216dd5b76186cdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_alternatives.py
@@ -0,0 +1,76 @@
+from testtools import TestCase
+from mock import patch
+
+import charmhelpers.contrib.openstack.alternatives as alternatives
+
+
+NAME = 'test'
+SOURCE = '/var/lib/charm/test/test.conf'
+TARGET = '/etc/test/test,conf'
+
+
+class AlternativesTestCase(TestCase):
+
+    @patch('subprocess.os.path')
+    @patch('subprocess.check_call')
+    def test_new_alternative(self, _check, _path):
+        _path.exists.return_value = False
+        alternatives.install_alternative(NAME,
+                                         TARGET,
+                                         SOURCE)
+        _check.assert_called_with(
+            ['update-alternatives', '--force', '--install',
+             TARGET, NAME, SOURCE, '50']
+        )
+
+    @patch('subprocess.os.path')
+    @patch('subprocess.check_call')
+    def test_priority(self, _check, _path):
+        _path.exists.return_value = False
+        alternatives.install_alternative(NAME,
+                                         TARGET,
+                                         SOURCE, 100)
+        _check.assert_called_with(
+            ['update-alternatives', '--force', '--install',
+             TARGET, NAME, SOURCE, '100']
+        )
+
+    @patch('shutil.move')
+    @patch('subprocess.os.path')
+    @patch('subprocess.check_call')
+    def test_new_alternative_existing_file(self, _check,
+                                           _path, _move):
+        _path.exists.return_value = True
+        _path.islink.return_value = False
+        alternatives.install_alternative(NAME,
+                                         TARGET,
+                                         SOURCE)
+        _check.assert_called_with(
+            ['update-alternatives', '--force', '--install',
+             TARGET, NAME, SOURCE, '50']
+        )
+        _move.assert_called_with(TARGET, '{}.bak'.format(TARGET))
+
+    @patch('shutil.move')
+    @patch('subprocess.os.path')
+    @patch('subprocess.check_call')
+    def test_new_alternative_existing_link(self, _check,
+                                           _path, _move):
+        _path.exists.return_value = True
+        _path.islink.return_value = True
+        alternatives.install_alternative(NAME,
+                                         TARGET,
+                                         SOURCE)
+        _check.assert_called_with(
+            ['update-alternatives', '--force', '--install',
+             TARGET, NAME, SOURCE, '50']
+        )
+        _move.assert_not_called()
+
+    @patch('subprocess.check_call')
+    def test_remove_alternative(self, _check):
+        alternatives.remove_alternative(NAME, SOURCE)
+        _check.assert_called_with(
+            ['update-alternatives', '--remove',
+             NAME, SOURCE]
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_audits.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_audits.py
new file mode 100644
index 0000000000000000000000000000000000000000..930292dc1bcc4a7973e49d6cedfce3aae3d0f5d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_audits.py
@@ -0,0 +1,329 @@
+from testtools import TestCase, skipIf
+from mock import patch, MagicMock, call
+import six
+
+import charmhelpers.contrib.openstack.audits as audits
+import charmhelpers.contrib.openstack.audits.openstack_security_guide as guide
+
+
+@skipIf(six.PY2, 'Audits only support Python3')
+class AuditTestCase(TestCase):
+
+    @patch('charmhelpers.contrib.openstack.audits._audits', {})
+    def test_wrapper(self):
+        variables = {
+            'guard_called': False,
+            'test_run': False,
+        }
+
+        def should_run(audit_options):
+            variables['guard_called'] = True
+            return True
+
+        @audits.audit(should_run)
+        def test(options):
+            variables['test_run'] = True
+
+        audits.run({})
+        self.assertTrue(variables['guard_called'])
+        self.assertTrue(variables['test_run'])
+        self.assertEqual(audits._audits['test'], audits.Audit(test, (should_run,)))
+
+    @patch('charmhelpers.contrib.openstack.audits._audits', {})
+    def test_wrapper_not_run(self):
+        variables = {
+            'guard_called': False,
+            'test_run': False,
+        }
+
+        def should_run(audit_options):
+            variables['guard_called'] = True
+            return False
+
+        @audits.audit(should_run)
+        def test(options):
+            variables['test_run'] = True
+
+        audits.run({})
+        self.assertTrue(variables['guard_called'])
+        self.assertFalse(variables['test_run'])
+        self.assertEqual(audits._audits['test'], audits.Audit(test, (should_run,)))
+
+    @patch('charmhelpers.contrib.openstack.audits._audits', {})
+    def test_duplicate_audit(self):
+        def should_run(audit_options):
+            return True
+
+        @audits.audit(should_run)
+        def test(options):
+            pass
+
+        try:
+            # Again!
+            #
+            # Both of the following '#noqa's are to prevent flake8 from
+            # noticing the duplicate function `test`  The intent in this test
+            # is for the audits.audit to pick up on the duplicate function.
+            @audits.audit(should_run)  # noqa
+            def test(options):         # noqa
+                pass
+        except RuntimeError as e:
+            self.assertEqual("Test name 'test' used more than once", e.args[0])
+            return
+        self.assertTrue(False, "Duplicate audit should raise an exception")
+
+    @patch('charmhelpers.contrib.openstack.audits._audits', {})
+    def test_non_callable_filter(self):
+        try:
+            # Again!
+            @audits.audit(3)
+            def test(options):
+                pass
+        except RuntimeError as e:
+            self.assertEqual("Configuration includes non-callable filters: [3]", e.args[0])
+            return
+        self.assertTrue(False, "Duplicate audit should raise an exception")
+
+    @patch('charmhelpers.contrib.openstack.audits._audits', {})
+    def test_exclude_config(self):
+        variables = {
+            'test_run': False,
+        }
+
+        @audits.audit()
+        def test(options):
+            variables['test_run'] = True
+
+        audits.run({'excludes': ['test']})
+        self.assertFalse(variables['test_run'])
+
+
+class AuditsTestCase(TestCase):
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_since_package_less(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = 1
+
+        verifier = audits.since_package('test', '12.0.0')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_since_package_greater(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = -1
+
+        verifier = audits.since_package('test', '14.0.0')
+        self.assertEqual(verifier(), False)
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_since_package_equal(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = 0
+
+        verifier = audits.since_package('test', '13.0.0')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_since_openstack_less(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "icehouse"
+
+        verifier = audits.since_openstack_release('test', 'mitaka')
+        self.assertEqual(verifier(), False)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_since_openstack_greater(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "rocky"
+
+        verifier = audits.since_openstack_release('test', 'queens')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_since_openstack_equal(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "mitaka"
+
+        verifier = audits.since_openstack_release('test', 'mitaka')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_before_openstack_less(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "icehouse"
+
+        verifier = audits.before_openstack_release('test', 'mitaka')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_before_openstack_greater(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "rocky"
+
+        verifier = audits.before_openstack_release('test', 'queens')
+        self.assertEqual(verifier(), False)
+
+    @patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    def test_before_openstack_equal(self, _get_os_codename_package):
+        _get_os_codename_package.return_value = "mitaka"
+
+        verifier = audits.before_openstack_release('test', 'mitaka')
+        self.assertEqual(verifier(), False)
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_before_package_less(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = 1
+
+        verifier = audits.before_package('test', '12.0.0')
+        self.assertEqual(verifier(), False)
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_before_package_greater(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = -1
+
+        verifier = audits.before_package('test', '14.0.0')
+        self.assertEqual(verifier(), True)
+
+    @patch('charmhelpers.contrib.openstack.audits.cmp_pkgrevno')
+    def test_before_package_equal(self, _cmp_pkgrevno):
+        _cmp_pkgrevno.return_value = 0
+
+        verifier = audits.before_package('test', '13.0.0')
+        self.assertEqual(verifier(), False)
+
+    def test_is_audit_type_empty(self):
+        verifier = audits.is_audit_type(audits.AuditType.OpenStackSecurityGuide)
+        self.assertEqual(verifier({}), False)
+
+    def test_is_audit_type(self):
+        verifier = audits.is_audit_type(audits.AuditType.OpenStackSecurityGuide)
+        self.assertEqual(verifier({'audit_type': audits.AuditType.OpenStackSecurityGuide}), True)
+
+
+@skipIf(six.PY2, 'Audits only support Python3')
+class OpenstackSecurityGuideTestCase(TestCase):
+
+    @patch('configparser.ConfigParser')
+    def test_internal_config_parser_is_not_strict(self, _config_parser):
+        parser = MagicMock()
+        _config_parser.return_value = parser
+        guide._config_ini('test')
+        _config_parser.assert_called_with(strict=False)
+        parser.read.assert_called_with('test')
+
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._stat')
+    def test_internal_validate_file_ownership(self, _stat):
+        _stat.return_value = guide.Ownership('test_user', 'test_group', '600')
+        guide._validate_file_ownership('test_user', 'test_group', 'test-file-name')
+        _stat.assert_called_with('test-file-name')
+        pass
+
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._stat')
+    def test_internal_validate_file_mode(self, _stat):
+        _stat.return_value = guide.Ownership('test_user', 'test_group', '600')
+        guide._validate_file_mode('600', 'test-file-name')
+        _stat.assert_called_with('test-file-name')
+        pass
+
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_mode')
+    def test_validate_file_permissions_defaults(self, _validate_mode, _is_file):
+        _is_file.return_value = True
+        config = {
+            'files': {
+                'test': {}
+            }
+        }
+        guide.validate_file_permissions(config)
+        _validate_mode.assert_called_once_with('600', 'test', False)
+
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_mode')
+    def test_validate_file_permissions(self, _validate_mode, _is_file):
+        _is_file.return_value = True
+        config = {
+            'files': {
+                'test': {
+                    'mode': '777'
+                }
+            }
+        }
+        guide.validate_file_permissions(config)
+        _validate_mode.assert_called_once_with('777', 'test', False)
+
+    @patch('glob.glob')
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_mode')
+    def test_validate_file_permissions_glob(self, _validate_mode, _is_file, _glob):
+        _glob.return_value = ['test']
+        _is_file.return_value = True
+        config = {
+            'files': {
+                '*': {
+                    'mode': '777'
+                }
+            }
+        }
+        guide.validate_file_permissions(config)
+        _validate_mode.assert_called_once_with('777', 'test', False)
+
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_ownership')
+    def test_validate_file_ownership_defaults(self, _validate_owner, _is_file):
+        _is_file.return_value = True
+        config = {
+            'files': {
+                'test': {}
+            }
+        }
+        guide.validate_file_ownership(config)
+        _validate_owner.assert_called_once_with('root', 'root', 'test', False)
+
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_ownership')
+    def test_validate_file_ownership(self, _validate_owner, _is_file):
+        _is_file.return_value = True
+        config = {
+            'files': {
+                'test': {
+                    'owner': 'test-user',
+                    'group': 'test-group',
+                }
+            }
+        }
+        guide.validate_file_ownership(config)
+        _validate_owner.assert_called_once_with('test-user', 'test-group', 'test', False)
+
+    @patch('glob.glob')
+    @patch('os.path.isfile')
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._validate_file_ownership')
+    def test_validate_file_ownership_glob(self, _validate_owner, _is_file, _glob):
+        _glob.return_value = ['test']
+        _is_file.return_value = True
+        config = {
+            'files': {
+                '*': {
+                    'owner': 'test-user',
+                    'group': 'test-group',
+                }
+            }
+        }
+        guide.validate_file_ownership(config)
+        _validate_owner.assert_called_once_with('test-user', 'test-group', 'test', False)
+
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._config_section')
+    def test_validate_uses_keystone(self, _config_section):
+        _config_section.side_effect = [None, {
+            'auth_strategy': 'keystone',
+        }]
+        guide.validate_uses_keystone({})
+        _config_section.assert_has_calls([call({}, 'api'), call({}, 'DEFAULT')])
+
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._config_section')
+    def test_validate_uses_tls_for_keystone(self, _config_section):
+        _config_section.return_value = {
+            'auth_uri': 'https://10.10.10.10',
+        }
+        guide.validate_uses_tls_for_keystone({})
+        _config_section.assert_called_with({}, 'keystone_authtoken')
+
+    @patch('charmhelpers.contrib.openstack.audits.openstack_security_guide._config_section')
+    def test_validate_uses_tls_for_glance(self, _config_section):
+        _config_section.return_value = {
+            'api_servers': 'https://10.10.10.10',
+        }
+        guide.validate_uses_tls_for_glance({})
+        _config_section.assert_called_with({}, 'glance')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_cert_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_cert_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce4117d3942253c9eb34eca69f8762c5aa768d33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_cert_utils.py
@@ -0,0 +1,308 @@
+import json
+import mock
+import unittest
+
+import charmhelpers.contrib.openstack.cert_utils as cert_utils
+
+
+class CertUtilsTests(unittest.TestCase):
+
+    def test_CertRequest(self):
+        cr = cert_utils.CertRequest()
+        self.assertEqual(cr.entries, [])
+        self.assertIsNone(cr.hostname_entry)
+
+    @mock.patch.object(cert_utils, 'local_unit', return_value='unit/2')
+    def test_CertRequest_add_entry(self, local_unit):
+        cr = cert_utils.CertRequest()
+        cr.add_entry('admin', 'admin.openstack.local', ['10.10.10.10'])
+        self.assertEqual(
+            cr.get_request(),
+            {'cert_requests':
+                '{"admin.openstack.local": {"sans": ["10.10.10.10"]}}',
+             'unit_name': 'unit_2'})
+
+    @mock.patch.object(cert_utils, 'local_unit', return_value='unit/2')
+    @mock.patch.object(cert_utils, 'resolve_network_cidr')
+    @mock.patch.object(cert_utils, 'get_vip_in_network')
+    @mock.patch.object(cert_utils, 'get_hostname')
+    @mock.patch.object(cert_utils, 'unit_get')
+    def test_CertRequest_add_hostname_cn(self, unit_get, get_hostname,
+                                         get_vip_in_network,
+                                         resolve_network_cidr, local_unit):
+        resolve_network_cidr.side_effect = lambda x: x
+        get_vip_in_network.return_value = '10.1.2.100'
+        unit_get.return_value = '10.1.2.3'
+        get_hostname.return_value = 'juju-unit-2'
+        cr = cert_utils.CertRequest()
+        cr.add_hostname_cn()
+        self.assertEqual(
+            cr.get_request(),
+            {'cert_requests':
+                '{"juju-unit-2": {"sans": ["10.1.2.100", "10.1.2.3"]}}',
+             'unit_name': 'unit_2'})
+
+    @mock.patch.object(cert_utils, 'local_unit', return_value='unit/2')
+    @mock.patch.object(cert_utils, 'resolve_network_cidr')
+    @mock.patch.object(cert_utils, 'get_vip_in_network')
+    @mock.patch.object(cert_utils, 'get_hostname')
+    @mock.patch.object(cert_utils, 'unit_get')
+    def test_CertRequest_add_hostname_cn_ip(self, unit_get, get_hostname,
+                                            get_vip_in_network,
+                                            resolve_network_cidr, local_unit):
+        resolve_network_cidr.side_effect = lambda x: x
+        get_vip_in_network.return_value = '10.1.2.100'
+        unit_get.return_value = '10.1.2.3'
+        get_hostname.return_value = 'juju-unit-2'
+        cr = cert_utils.CertRequest()
+        cr.add_hostname_cn()
+        cr.add_hostname_cn_ip(['10.1.2.4'])
+        self.assertEqual(
+            cr.get_request(),
+            {'cert_requests':
+                ('{"juju-unit-2": {"sans": ["10.1.2.100", "10.1.2.3", '
+                 '"10.1.2.4"]}}'),
+             'unit_name': 'unit_2'})
+
+    @mock.patch.object(cert_utils, 'local_unit', return_value='unit/2')
+    @mock.patch.object(cert_utils, 'resolve_network_cidr')
+    @mock.patch.object(cert_utils, 'get_vip_in_network')
+    @mock.patch.object(cert_utils, 'network_get_primary_address')
+    @mock.patch.object(cert_utils, 'resolve_address')
+    @mock.patch.object(cert_utils, 'config')
+    @mock.patch.object(cert_utils, 'get_hostname')
+    @mock.patch.object(cert_utils, 'unit_get')
+    def test_get_certificate_request(self, unit_get, get_hostname,
+                                     config, resolve_address,
+                                     network_get_primary_address,
+                                     get_vip_in_network, resolve_network_cidr,
+                                     local_unit):
+        unit_get.return_value = '10.1.2.3'
+        get_hostname.return_value = 'juju-unit-2'
+        _config = {
+            'os-internal-hostname': 'internal.openstack.local',
+            'os-admin-hostname': 'admin.openstack.local',
+            'os-public-hostname': 'public.openstack.local',
+        }
+        _resolve_address = {
+            'int': '10.0.0.2',
+            'admin': '10.10.0.2',
+            'public': '10.20.0.2',
+        }
+        _npa = {
+            'internal': '10.0.0.3',
+            'admin': '10.10.0.3',
+            'public': '10.20.0.3',
+        }
+        _vips = {
+            '10.0.0.0/16': '10.0.0.100',
+            '10.10.0.0/16': '10.10.0.100',
+            '10.20.0.0/16': '10.20.0.100',
+        }
+        _resolve_nets = {
+            '10.0.0.3': '10.0.0.0/16',
+            '10.10.0.3': '10.10.0.0/16',
+            '10.20.0.3': '10.20.0.0/16',
+        }
+        expect = {
+            'admin.openstack.local': {
+                'sans': ['10.10.0.100', '10.10.0.2', '10.10.0.3']},
+            'internal.openstack.local': {
+                'sans': ['10.0.0.100', '10.0.0.2', '10.0.0.3']},
+            'juju-unit-2': {'sans': ['10.1.2.3']},
+            'public.openstack.local': {
+                'sans': ['10.20.0.100', '10.20.0.2', '10.20.0.3']}}
+        self.maxDiff = None
+        config.side_effect = lambda x: _config.get(x)
+        get_vip_in_network.side_effect = lambda x: _vips.get(x)
+        resolve_network_cidr.side_effect = lambda x: _resolve_nets.get(x)
+        network_get_primary_address.side_effect = lambda x: _npa.get(x)
+        resolve_address.side_effect = \
+            lambda endpoint_type: _resolve_address[endpoint_type]
+        output = json.loads(
+            cert_utils.get_certificate_request()['cert_requests'])
+        self.assertEqual(
+            output,
+            expect)
+
+    @mock.patch.object(cert_utils, 'unit_get')
+    @mock.patch.object(cert_utils.os, 'symlink')
+    @mock.patch.object(cert_utils.os.path, 'isfile')
+    @mock.patch.object(cert_utils, 'resolve_address')
+    @mock.patch.object(cert_utils, 'get_hostname')
+    def test_create_ip_cert_links(self, get_hostname, resolve_address, isfile,
+                                  symlink, unit_get):
+        unit_get.return_value = '10.1.2.3'
+        get_hostname.return_value = 'juju-unit-2'
+        _resolve_address = {
+            'int': '10.0.0.2',
+            'admin': '10.10.0.2',
+            'public': '10.20.0.2',
+        }
+        resolve_address.side_effect = \
+            lambda endpoint_type: _resolve_address[endpoint_type]
+        _files = {
+            '/etc/ssl/cert_juju-unit-2': True,
+            '/etc/ssl/cert_10.0.0.2': False,
+            '/etc/ssl/cert_10.10.0.2': True,
+            '/etc/ssl/cert_10.20.0.2': False,
+            '/etc/ssl/cert_funky-name': False,
+        }
+        isfile.side_effect = lambda x: _files[x]
+        expected = [
+            mock.call('/etc/ssl/cert_juju-unit-2', '/etc/ssl/cert_10.0.0.2'),
+            mock.call('/etc/ssl/key_juju-unit-2', '/etc/ssl/key_10.0.0.2'),
+            mock.call('/etc/ssl/cert_juju-unit-2', '/etc/ssl/cert_10.20.0.2'),
+            mock.call('/etc/ssl/key_juju-unit-2', '/etc/ssl/key_10.20.0.2'),
+        ]
+        cert_utils.create_ip_cert_links('/etc/ssl')
+        symlink.assert_has_calls(expected)
+        symlink.reset_mock()
+        cert_utils.create_ip_cert_links(
+            '/etc/ssl',
+            custom_hostname_link='funky-name')
+        expected.extend([
+            mock.call('/etc/ssl/cert_juju-unit-2', '/etc/ssl/cert_funky-name'),
+            mock.call('/etc/ssl/key_juju-unit-2', '/etc/ssl/key_funky-name'),
+        ])
+        symlink.assert_has_calls(expected)
+
+    @mock.patch.object(cert_utils, 'write_file')
+    def test_install_certs(self, write_file):
+        certs = {
+            'admin.openstack.local': {
+                'cert': 'ADMINCERT',
+                'key': 'ADMINKEY'}}
+        cert_utils.install_certs('/etc/ssl', certs, chain='CHAIN')
+        expected = [
+            mock.call(
+                path='/etc/ssl/cert_admin.openstack.local',
+                content='ADMINCERT\nCHAIN',
+                owner='root', group='root',
+                perms=0o640),
+            mock.call(
+                path='/etc/ssl/key_admin.openstack.local',
+                content='ADMINKEY',
+                owner='root', group='root',
+                perms=0o640),
+        ]
+        write_file.assert_has_calls(expected)
+
+    @mock.patch.object(cert_utils, 'write_file')
+    def test_install_certs_ca(self, write_file):
+        certs = {
+            'admin.openstack.local': {
+                'cert': 'ADMINCERT',
+                'key': 'ADMINKEY'}}
+        ca = 'MYCA'
+        cert_utils.install_certs('/etc/ssl', certs, ca)
+        expected = [
+            mock.call(
+                path='/etc/ssl/cert_admin.openstack.local',
+                content='ADMINCERT\nMYCA',
+                owner='root', group='root',
+                perms=0o640),
+            mock.call(
+                path='/etc/ssl/key_admin.openstack.local',
+                content='ADMINKEY',
+                owner='root', group='root',
+                perms=0o640),
+        ]
+        write_file.assert_has_calls(expected)
+
+    @mock.patch.object(cert_utils, 'local_unit')
+    @mock.patch.object(cert_utils, 'create_ip_cert_links')
+    @mock.patch.object(cert_utils, 'install_certs')
+    @mock.patch.object(cert_utils, 'install_ca_cert')
+    @mock.patch.object(cert_utils, 'mkdir')
+    @mock.patch.object(cert_utils, 'relation_get')
+    def test_process_certificates(self, relation_get, mkdir, install_ca_cert,
+                                  install_certs, create_ip_cert_links,
+                                  local_unit):
+        local_unit.return_value = 'devnull/2'
+        certs = {
+            'admin.openstack.local': {
+                'cert': 'ADMINCERT',
+                'key': 'ADMINKEY'}}
+        _relation_info = {
+            'keystone_2.processed_requests': json.dumps(certs),
+            'chain': 'MYCHAIN',
+            'ca': 'ROOTCA',
+        }
+        relation_get.return_value = _relation_info
+        self.assertFalse(cert_utils.process_certificates(
+            'myservice',
+            'certificates:2',
+            'vault/0',
+            custom_hostname_link='funky-name'))
+        local_unit.return_value = 'keystone/2'
+        self.assertTrue(cert_utils.process_certificates(
+            'myservice',
+            'certificates:2',
+            'vault/0',
+            custom_hostname_link='funky-name'))
+        install_ca_cert.assert_called_once_with(b'ROOTCA')
+        install_certs.assert_called_once_with(
+            '/etc/apache2/ssl/myservice',
+            {'admin.openstack.local': {
+                'key': 'ADMINKEY', 'cert': 'ADMINCERT'}},
+            'MYCHAIN', user='root', group='root')
+        create_ip_cert_links.assert_called_once_with(
+            '/etc/apache2/ssl/myservice',
+            custom_hostname_link='funky-name')
+
+    @mock.patch.object(cert_utils, 'local_unit')
+    @mock.patch.object(cert_utils, 'related_units')
+    @mock.patch.object(cert_utils, 'relation_ids')
+    @mock.patch.object(cert_utils, 'relation_get')
+    def test_get_requests_for_local_unit(self, relation_get, relation_ids,
+                                         related_units, local_unit):
+        local_unit.return_value = 'rabbitmq-server/2'
+        relation_ids.return_value = ['certificates:12']
+        related_units.return_value = ['vault/0']
+        certs = {
+            'juju-cd4bb3-5.lxd': {
+                'cert': 'BASECERT',
+                'key': 'BASEKEY'},
+            'juju-cd4bb3-5.internal': {
+                'cert': 'INTERNALCERT',
+                'key': 'INTERNALKEY'}}
+        _relation_info = {
+            'rabbitmq-server_2.processed_requests': json.dumps(certs),
+            'chain': 'MYCHAIN',
+            'ca': 'ROOTCA',
+        }
+        relation_get.return_value = _relation_info
+        self.assertEqual(
+            cert_utils.get_requests_for_local_unit(),
+            [{
+                'ca': 'ROOTCA',
+                'certs': {
+                    'juju-cd4bb3-5.lxd': {
+                        'cert': 'BASECERT',
+                        'key': 'BASEKEY'},
+                    'juju-cd4bb3-5.internal': {
+                        'cert': 'INTERNALCERT',
+                        'key': 'INTERNALKEY'}},
+                'chain': 'MYCHAIN'}]
+        )
+
+    @mock.patch.object(cert_utils, 'get_requests_for_local_unit')
+    def test_get_bundle_for_cn(self, get_requests_for_local_unit):
+        get_requests_for_local_unit.return_value = [{
+            'ca': 'ROOTCA',
+            'certs': {
+                'juju-cd4bb3-5.lxd': {
+                    'cert': 'BASECERT',
+                    'key': 'BASEKEY'},
+                'juju-cd4bb3-5.internal': {
+                    'cert': 'INTERNALCERT',
+                    'key': 'INTERNALKEY'}},
+            'chain': 'MYCHAIN'}]
+        self.assertEqual(
+            cert_utils.get_bundle_for_cn('juju-cd4bb3-5.internal'),
+            {
+                'ca': 'ROOTCA',
+                'cert': 'INTERNALCERT',
+                'chain': 'MYCHAIN',
+                'key': 'INTERNALKEY'})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ip.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ip.py
new file mode 100644
index 0000000000000000000000000000000000000000..e062e7b89e9f4f7e9a1566886dbd5f794a4b5e90
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ip.py
@@ -0,0 +1,174 @@
+from testtools import TestCase
+from mock import patch, call, MagicMock
+
+import charmhelpers.core as ch_core
+import charmhelpers.contrib.openstack.ip as ip
+
+TO_PATCH = [
+    'config',
+    'unit_get',
+    'get_address_in_network',
+    'is_clustered',
+    'service_name',
+    'network_get_primary_address',
+    'resolve_network_cidr',
+]
+
+
+class TestConfig():
+
+    def __init__(self):
+        self.config = {}
+
+    def set(self, key, value):
+        self.config[key] = value
+
+    def get(self, key):
+        return self.config.get(key)
+
+
+class IPTestCase(TestCase):
+
+    def setUp(self):
+        super(IPTestCase, self).setUp()
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+        self.test_config = TestConfig()
+        self.config.side_effect = self.test_config.get
+        self.network_get_primary_address.side_effect = [
+            NotImplementedError,
+            ch_core.hookenv.NoNetworkBinding,
+        ]
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.openstack.ip.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_resolve_address_default(self):
+        self.is_clustered.return_value = False
+        self.unit_get.return_value = 'unit1'
+        self.get_address_in_network.return_value = 'unit1'
+        self.assertEquals(ip.resolve_address(), 'unit1')
+        self.unit_get.assert_called_with('public-address')
+        calls = [call('os-public-network'),
+                 call('prefer-ipv6')]
+        self.config.assert_has_calls(calls)
+
+    def test_resolve_address_default_internal(self):
+        self.is_clustered.return_value = False
+        self.unit_get.return_value = 'unit1'
+        self.get_address_in_network.return_value = 'unit1'
+        self.assertEquals(ip.resolve_address(ip.INTERNAL), 'unit1')
+        self.unit_get.assert_called_with('private-address')
+        calls = [call('os-internal-network'),
+                 call('prefer-ipv6')]
+        self.config.assert_has_calls(calls)
+
+    def test_resolve_address_public_not_clustered(self):
+        self.is_clustered.return_value = False
+        self.test_config.set('os-public-network', '192.168.20.0/24')
+        self.unit_get.return_value = 'unit1'
+        self.get_address_in_network.return_value = '192.168.20.1'
+        self.assertEquals(ip.resolve_address(), '192.168.20.1')
+        self.unit_get.assert_called_with('public-address')
+        calls = [call('os-public-network'),
+                 call('prefer-ipv6')]
+        self.config.assert_has_calls(calls)
+        self.get_address_in_network.assert_called_with(
+            '192.168.20.0/24',
+            'unit1')
+
+    def test_resolve_address_public_clustered(self):
+        self.is_clustered.return_value = True
+        self.test_config.set('os-public-network', '192.168.20.0/24')
+        self.test_config.set('vip', '192.168.20.100 10.5.3.1')
+        self.assertEquals(ip.resolve_address(), '192.168.20.100')
+
+    def test_resolve_address_default_clustered(self):
+        self.is_clustered.return_value = True
+        self.test_config.set('vip', '10.5.3.1')
+        self.assertEquals(ip.resolve_address(), '10.5.3.1')
+        self.config.assert_has_calls(
+            [call('vip'),
+             call('os-public-network')])
+
+    def test_resolve_address_public_clustered_inresolvable(self):
+        self.is_clustered.return_value = True
+        self.test_config.set('os-public-network', '192.168.20.0/24')
+        self.test_config.set('vip', '10.5.3.1')
+        self.assertRaises(ValueError, ip.resolve_address)
+
+    def test_resolve_address_override(self):
+        self.test_config.set('os-public-hostname', 'public.example.com')
+        addr = ip.resolve_address()
+        self.assertEqual('public.example.com', addr)
+
+    @patch.object(ip, '_get_address_override')
+    def test_resolve_address_no_override(self, _get_address_override):
+        self.test_config.set('os-public-hostname', 'public.example.com')
+        self.unit_get.return_value = '10.0.0.1'
+        addr = ip.resolve_address(override=False)
+        self.assertFalse(_get_address_override.called)
+        self.assertEqual('10.0.0.1', addr)
+
+    def test_resolve_address_override_template(self):
+        self.test_config.set('os-public-hostname',
+                             '{service_name}.example.com')
+        self.service_name.return_value = 'foo'
+        addr = ip.resolve_address()
+        self.assertEqual('foo.example.com', addr)
+
+    @patch.object(ip, 'get_ipv6_addr', lambda *args, **kwargs: ['::1'])
+    def test_resolve_address_ipv6_fallback(self):
+        self.test_config.set('prefer-ipv6', True)
+        self.is_clustered.return_value = False
+        self.assertEqual(ip.resolve_address(), '::1')
+
+    @patch.object(ip, 'resolve_address')
+    def test_canonical_url_http(self, resolve_address):
+        resolve_address.return_value = 'unit1'
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        self.assertTrue(ip.canonical_url(configs),
+                        'http://unit1')
+
+    @patch.object(ip, 'resolve_address')
+    def test_canonical_url_https(self, resolve_address):
+        resolve_address.return_value = 'unit1'
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['https']
+        self.assertTrue(ip.canonical_url(configs),
+                        'https://unit1')
+
+    @patch.object(ip, 'is_ipv6', lambda *args: True)
+    @patch.object(ip, 'resolve_address')
+    def test_canonical_url_ipv6(self, resolve_address):
+        resolve_address.return_value = 'unit1'
+        self.assertTrue(ip.canonical_url(None), 'http://[unit1]')
+
+    def test_resolve_address_network_get(self):
+        self.is_clustered.return_value = False
+        self.unit_get.return_value = 'unit1'
+        self.network_get_primary_address.side_effect = None
+        self.network_get_primary_address.return_value = '10.5.60.1'
+        self.assertEqual(ip.resolve_address(), '10.5.60.1')
+        self.unit_get.assert_called_with('public-address')
+        calls = [call('os-public-network'),
+                 call('prefer-ipv6')]
+        self.config.assert_has_calls(calls)
+        self.network_get_primary_address.assert_called_with('public')
+
+    def test_resolve_address_network_get_clustered(self):
+        self.is_clustered.return_value = True
+        self.test_config.set('vip', '10.5.60.20 192.168.1.20')
+        self.network_get_primary_address.side_effect = None
+        self.network_get_primary_address.return_value = '10.5.60.1'
+        self.resolve_network_cidr.return_value = '10.5.60.1/24'
+        self.assertEqual(ip.resolve_address(), '10.5.60.20')
+        calls = [call('os-public-hostname'),
+                 call('vip'),
+                 call('os-public-network')]
+        self.config.assert_has_calls(calls)
+        self.network_get_primary_address.assert_called_with('public')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_keystone_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_keystone_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7bba25d691b736a781d53c6269986435f114745
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_keystone_utils.py
@@ -0,0 +1,122 @@
+#!/usr/bin/env python
+
+import unittest
+
+from mock import patch, PropertyMock
+
+import charmhelpers.contrib.openstack.keystone as keystone
+
+TO_PATCH = [
+    'apt_install',
+    "log",
+    "ERROR",
+    "IdentityServiceContext",
+]
+
+
+class KeystoneTests(unittest.TestCase):
+    def setUp(self):
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.openstack.keystone.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_get_keystone_manager(self):
+        manager = keystone.get_keystone_manager(
+            'test-endpoint', 2, token="12345"
+        )
+        self.assertTrue(isinstance(manager, keystone.KeystoneManager2))
+
+        manager = keystone.get_keystone_manager(
+            'test-endpoint', 3, token="12345")
+
+        self.assertTrue(isinstance(manager, keystone.KeystoneManager3))
+        self.assertRaises(ValueError, keystone.get_keystone_manager,
+                          'test-endpoint', 4, token="12345")
+
+    def test_resolve_sevice_id_v2(self):
+        class ServiceList(list):
+            def __iter__(self):
+                class Service(object):
+                    _info = {
+                        'type': 'metering',
+                        'name': "ceilometer",
+                        'id': "uuid-uuid",
+                    }
+                yield Service()
+
+        manager = keystone.get_keystone_manager('test-endpoint', 2,
+                                                token="1234")
+        manager.api.services.list = PropertyMock(return_value=ServiceList())
+        self.assertTrue(manager.service_exists(service_name="ceilometer",
+                                               service_type="metering"))
+        self.assertFalse(manager.service_exists(service_name="barbican"))
+        self.assertFalse(manager.service_exists(service_name="barbican",
+                                                service_type="openstack"))
+
+    def test_resolve_sevice_id_v3(self):
+        class ServiceList(list):
+            def __iter__(self):
+                class Service(object):
+                    _info = {
+                        'type': 'metering',
+                        'name': "ceilometer",
+                        'id': "uuid-uuid",
+                    }
+                yield Service()
+
+        manager = keystone.get_keystone_manager('test-endpoint', 3,
+                                                token="12345")
+        manager.api.services.list = PropertyMock(return_value=ServiceList())
+        self.assertTrue(manager.service_exists(service_name="ceilometer",
+                                               service_type="metering"))
+        self.assertFalse(manager.service_exists(service_name="barbican"))
+        self.assertFalse(manager.service_exists(service_name="barbican",
+                                                service_type="openstack"))
+
+    def test_get_api_suffix(self):
+        self.assertEquals(keystone.get_api_suffix(2), "v2.0")
+        self.assertEquals(keystone.get_api_suffix(3), "v3")
+
+    def test_format_endpoint(self):
+        self.assertEquals(keystone.format_endpoint(
+            "http", "10.0.0.5", "5000", 2), "http://10.0.0.5:5000/v2.0/")
+
+    def test_get_keystone_manager_from_identity_service_context(self):
+        class FakeIdentityServiceV2(object):
+            def __call__(self, *args, **kwargs):
+                return {
+                    "service_protocol": "https",
+                    "service_host": "10.5.0.5",
+                    "service_port": "5000",
+                    "api_version": "2.0",
+                    "admin_user": "amdin",
+                    "admin_password": "admin",
+                    "admin_tenant_name": "admin_tenant"
+                }
+
+        self.IdentityServiceContext.return_value = FakeIdentityServiceV2()
+
+        manager = keystone.get_keystone_manager_from_identity_service_context()
+        self.assertIsInstance(manager, keystone.KeystoneManager2)
+
+        class FakeIdentityServiceV3(object):
+            def __call__(self, *args, **kwargs):
+                return {
+                    "service_protocol": "https",
+                    "service_host": "10.5.0.5",
+                    "service_port": "5000",
+                    "api_version": "3",
+                    "admin_user": "amdin",
+                    "admin_password": "admin",
+                    "admin_tenant_name": "admin_tenant"
+                }
+
+        self.IdentityServiceContext.return_value = FakeIdentityServiceV3()
+
+        manager = keystone.get_keystone_manager_from_identity_service_context()
+        self.assertIsInstance(manager, keystone.KeystoneManager3)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_neutron_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_neutron_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a571f171c5afcb3bbd6589e9c04c3d2a2db5af6c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_neutron_utils.py
@@ -0,0 +1,239 @@
+import unittest
+from mock import patch
+from nose.tools import raises
+import charmhelpers.contrib.openstack.neutron as neutron
+
+TO_PATCH = [
+    'log',
+    'config',
+    'os_release',
+    'check_output',
+]
+
+
+class NeutronTests(unittest.TestCase):
+    def setUp(self):
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.openstack.neutron.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_headers_package(self):
+        self.check_output.return_value = b'3.13.0-19-generic'
+        kname = neutron.headers_package()
+        self.assertEquals(kname, 'linux-headers-3.13.0-19-generic')
+
+    def test_kernel_version(self):
+        self.check_output.return_value = b'3.13.0-19-generic'
+        kver_maj, kver_min = neutron.kernel_version()
+        self.assertEquals((kver_maj, kver_min), (3, 13))
+
+    @patch.object(neutron, 'kernel_version')
+    def test_determine_dkms_package_old_kernel(self, _kernel_version):
+        self.check_output.return_value = b'3.4.0-19-generic'
+        _kernel_version.return_value = (3, 10)
+        dkms_package = neutron.determine_dkms_package()
+        self.assertEquals(dkms_package, ['linux-headers-3.4.0-19-generic',
+                                         'openvswitch-datapath-dkms'])
+
+    @patch.object(neutron, 'kernel_version')
+    def test_determine_dkms_package_new_kernel(self, _kernel_version):
+        _kernel_version.return_value = (3, 13)
+        dkms_package = neutron.determine_dkms_package()
+        self.assertEquals(dkms_package, [])
+
+    def test_quantum_plugins(self):
+        self.config.return_value = 'foo'
+        plugins = neutron.quantum_plugins()
+        self.assertEquals(plugins['ovs']['services'],
+                          ['quantum-plugin-openvswitch-agent'])
+        self.assertEquals(plugins['nvp']['services'], [])
+
+    def test_neutron_plugins_preicehouse(self):
+        self.config.return_value = 'foo'
+        self.os_release.return_value = 'havana'
+        plugins = neutron.neutron_plugins()
+        self.assertEquals(plugins['ovs']['config'],
+                          '/etc/neutron/plugins/openvswitch/ovs_neutron_plugin.ini')
+        self.assertEquals(plugins['nvp']['services'], [])
+
+    def test_neutron_plugins(self):
+        self.config.return_value = 'foo'
+        self.os_release.return_value = 'icehouse'
+        plugins = neutron.neutron_plugins()
+        self.assertEquals(plugins['ovs']['config'],
+                          '/etc/neutron/plugins/ml2/ml2_conf.ini')
+        self.assertEquals(plugins['nvp']['config'],
+                          '/etc/neutron/plugins/vmware/nsx.ini')
+        self.assertTrue('neutron-plugin-vmware' in
+                        plugins['nvp']['server_packages'])
+        self.assertEquals(plugins['n1kv']['config'],
+                          '/etc/neutron/plugins/cisco/cisco_plugins.ini')
+        self.assertEquals(plugins['Calico']['config'],
+                          '/etc/neutron/plugins/ml2/ml2_conf.ini')
+        self.assertEquals(plugins['plumgrid']['config'],
+                          '/etc/neutron/plugins/plumgrid/plumgrid.ini')
+        self.assertEquals(plugins['midonet']['config'],
+                          '/etc/neutron/plugins/midonet/midonet.ini')
+
+        self.assertEquals(plugins['nvp']['services'], [])
+        self.assertEquals(plugins['nsx'], plugins['nvp'])
+
+        self.os_release.return_value = 'kilo'
+        plugins = neutron.neutron_plugins()
+        self.assertEquals(plugins['midonet']['driver'],
+                          'neutron.plugins.midonet.plugin.MidonetPluginV2')
+        self.assertEquals(plugins['nsx']['config'],
+                          '/etc/neutron/plugins/vmware/nsx.ini')
+
+        self.os_release.return_value = 'liberty'
+        self.config.return_value = 'mem-1.9'
+        plugins = neutron.neutron_plugins()
+        self.assertEquals(plugins['midonet']['driver'],
+                          'midonet.neutron.plugin_v1.MidonetPluginV2')
+        self.assertTrue('python-networking-midonet' in
+                        plugins['midonet']['server_packages'])
+
+        self.os_release.return_value = 'mitaka'
+        self.config.return_value = 'mem-1.9'
+        plugins = neutron.neutron_plugins()
+        self.assertEquals(plugins['nsx']['config'],
+                          '/etc/neutron/nsx.ini')
+        self.assertTrue('python-vmware-nsx' in
+                        plugins['nsx']['server_packages'])
+
+    @patch.object(neutron, 'network_manager')
+    def test_neutron_plugin_attribute_quantum(self, _network_manager):
+        self.config.return_value = 'foo'
+        _network_manager.return_value = 'quantum'
+        plugins = neutron.neutron_plugin_attribute('ovs', 'services')
+        self.assertEquals(plugins, ['quantum-plugin-openvswitch-agent'])
+
+    @patch.object(neutron, 'network_manager')
+    def test_neutron_plugin_attribute_neutron(self, _network_manager):
+        self.config.return_value = 'foo'
+        self.os_release.return_value = 'icehouse'
+        _network_manager.return_value = 'neutron'
+        plugins = neutron.neutron_plugin_attribute('ovs', 'services')
+        self.assertEquals(plugins, ['neutron-plugin-openvswitch-agent'])
+
+    @raises(Exception)
+    @patch.object(neutron, 'network_manager')
+    def test_neutron_plugin_attribute_foo(self, _network_manager):
+        _network_manager.return_value = 'foo'
+        self.assertRaises(Exception, neutron.neutron_plugin_attribute('ovs', 'services'))
+
+    @raises(Exception)
+    @patch.object(neutron, 'network_manager')
+    def test_neutron_plugin_attribute_plugin_keyerror(self, _network_manager):
+        self.config.return_value = 'foo'
+        _network_manager.return_value = 'quantum'
+        self.assertRaises(Exception, neutron.neutron_plugin_attribute('foo', 'foo'))
+
+    @patch.object(neutron, 'network_manager')
+    def test_neutron_plugin_attribute_attr_keyerror(self, _network_manager):
+        self.config.return_value = 'foo'
+        _network_manager.return_value = 'quantum'
+        plugins = neutron.neutron_plugin_attribute('ovs', 'foo')
+        self.assertEquals(plugins, None)
+
+    @raises(Exception)
+    def test_network_manager_essex(self):
+        essex_cases = {
+            'quantum': 'quantum',
+            'neutron': 'quantum',
+            'newhotness': 'newhotness',
+        }
+        self.os_release.return_value = 'essex'
+        for nwmanager in essex_cases:
+            self.config.return_value = nwmanager
+            self.assertRaises(Exception, neutron.network_manager())
+
+    def test_network_manager_folsom(self):
+        folsom_cases = {
+            'quantum': 'quantum',
+            'neutron': 'quantum',
+            'newhotness': 'newhotness',
+        }
+        self.os_release.return_value = 'folsom'
+        for nwmanager in folsom_cases:
+            self.config.return_value = nwmanager
+            renamed_manager = neutron.network_manager()
+            self.assertEquals(renamed_manager, folsom_cases[nwmanager])
+
+    def test_network_manager_grizzly(self):
+        grizzly_cases = {
+            'quantum': 'quantum',
+            'neutron': 'quantum',
+            'newhotness': 'newhotness',
+        }
+        self.os_release.return_value = 'grizzly'
+        for nwmanager in grizzly_cases:
+            self.config.return_value = nwmanager
+            renamed_manager = neutron.network_manager()
+            self.assertEquals(renamed_manager, grizzly_cases[nwmanager])
+
+    def test_network_manager_havana(self):
+        havana_cases = {
+            'quantum': 'neutron',
+            'neutron': 'neutron',
+            'newhotness': 'newhotness',
+        }
+        self.os_release.return_value = 'havana'
+        for nwmanager in havana_cases:
+            self.config.return_value = nwmanager
+            renamed_manager = neutron.network_manager()
+            self.assertEquals(renamed_manager, havana_cases[nwmanager])
+
+    def test_network_manager_icehouse(self):
+        icehouse_cases = {
+            'quantum': 'neutron',
+            'neutron': 'neutron',
+            'newhotness': 'newhotness',
+        }
+        self.os_release.return_value = 'icehouse'
+        for nwmanager in icehouse_cases:
+            self.config.return_value = nwmanager
+            renamed_manager = neutron.network_manager()
+            self.assertEquals(renamed_manager, icehouse_cases[nwmanager])
+
+    def test_parse_bridge_mappings(self):
+        ret = neutron.parse_bridge_mappings(None)
+        self.assertEqual(ret, {})
+        ret = neutron.parse_bridge_mappings("physnet1:br0")
+        self.assertEqual(ret, {'physnet1': 'br0'})
+        ret = neutron.parse_bridge_mappings("physnet1:br0 physnet2:br1")
+        self.assertEqual(ret, {'physnet1': 'br0', 'physnet2': 'br1'})
+
+    def test_parse_data_port_mappings(self):
+        ret = neutron.parse_data_port_mappings(None)
+        self.assertEqual(ret, {})
+        ret = neutron.parse_data_port_mappings('br0:eth0')
+        self.assertEqual(ret, {'eth0': 'br0'})
+        # Back-compat test
+        ret = neutron.parse_data_port_mappings('eth0', default_bridge='br0')
+        self.assertEqual(ret, {'eth0': 'br0'})
+        # Multiple mappings
+        ret = neutron.parse_data_port_mappings('br0:eth0 br1:eth1')
+        self.assertEqual(ret, {'eth0': 'br0', 'eth1': 'br1'})
+        # MultMAC mappings
+        ret = neutron.parse_data_port_mappings('br0:cb:23:ae:72:f2:33 '
+                                               'br0:fa:16:3e:12:97:8e')
+        self.assertEqual(ret, {'cb:23:ae:72:f2:33': 'br0',
+                               'fa:16:3e:12:97:8e': 'br0'})
+
+    def test_parse_vlan_range_mappings(self):
+        ret = neutron.parse_vlan_range_mappings(None)
+        self.assertEqual(ret, {})
+        ret = neutron.parse_vlan_range_mappings('physnet1:1001:2000')
+        self.assertEqual(ret, {'physnet1': ('1001', '2000')})
+        ret = neutron.parse_vlan_range_mappings('physnet1:1001:2000 physnet2:2001:3000')
+        self.assertEqual(ret, {'physnet1': ('1001', '2000'),
+                               'physnet2': ('2001', '3000')})
+        ret = neutron.parse_vlan_range_mappings('physnet1 physnet2:2001:3000')
+        self.assertEqual(ret, {'physnet1': ('',),
+                               'physnet2': ('2001', '3000')})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_openstack_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_openstack_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..6358ac3ee653fe6a52c5ec890d0a6f7570df4b1e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_openstack_utils.py
@@ -0,0 +1,2340 @@
+import io
+import os
+import contextlib
+import unittest
+from copy import copy
+from tests.helpers import patch_open, FakeRelation
+
+from testtools import TestCase
+from mock import MagicMock, patch, call
+
+from charmhelpers.fetch import ubuntu as fetch
+from charmhelpers.core.hookenv import WORKLOAD_STATES, flush
+
+import charmhelpers.contrib.openstack.utils as openstack
+
+import six
+
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+    builtin_import = '__builtin__.__import__'
+else:
+    builtin_open = 'builtins.open'
+    builtin_import = 'builtins.__import__'
+
+FAKE_CODENAME = 'precise'
+# mocked return of openstack.lsb_release()
+FAKE_RELEASE = {
+    'DISTRIB_CODENAME': 'precise',
+    'DISTRIB_RELEASE': '12.04',
+    'DISTRIB_ID': 'Ubuntu',
+    'DISTRIB_DESCRIPTION': '"Ubuntu 12.04"'
+}
+
+FAKE_REPO = {
+    # liberty patch release
+    'neutron-common': {
+        'pkg_vers': '2:7.0.1-0ubuntu1',
+        'os_release': 'liberty',
+        'os_version': '2015.2'
+    },
+    # liberty release version
+    'nova-common': {
+        'pkg_vers': '2:12.0.0~b1-0ubuntu1',
+        'os_release': 'liberty',
+        'os_version': '2015.2'
+    },
+    'nova': {
+        'pkg_vers': '2012.2.3-0ubuntu2.1',
+        'os_release': 'folsom',
+        'os_version': '2012.2'
+    },
+    'glance-common': {
+        'pkg_vers': '2012.1.3+stable-20130423-74b067df-0ubuntu1',
+        'os_release': 'essex',
+        'os_version': '2012.1'
+    },
+    'keystone-common': {
+        'pkg_vers': '1:2013.1-0ubuntu1.1~cloud0',
+        'os_release': 'grizzly',
+        'os_version': '2013.1'
+    },
+    # Exercise swift version detection
+    'swift-storage': {
+        'pkg_vers': '1.8.0-0ubuntu1',
+        'os_release': 'grizzly',
+        'os_version': '1.8.0'
+    },
+    'swift-proxy': {
+        'pkg_vers': '1.13.1-0ubuntu1',
+        'os_release': 'icehouse',
+        'os_version': '1.13.1'
+    },
+    'swift-common': {
+        'pkg_vers': '1.10.0~rc1-0ubuntu1',
+        'os_release': 'havana',
+        'os_version': '1.10.0'
+    },
+    'swift-mitaka-dev': {
+        'pkg_vers': '2.7.1.dev8.201605111703.trusty-0ubuntu1',
+        'os_release': 'mitaka',
+        'os_version': '2.7.0'
+    },
+    # a package thats available in the cache but is not installed
+    'cinder-common': {
+        'os_release': 'havana',
+        'os_version': '2013.2'
+    },
+    # poorly formed openstack version
+    'bad-version': {
+        'pkg_vers': '1:2200.1-0ubuntu1.1~cloud0',
+        'os_release': None,
+        'os_version': None
+    }
+}
+
+MOUNTS = [
+    ['/mnt', '/dev/vdb']
+]
+
+url = 'deb ' + openstack.CLOUD_ARCHIVE_URL
+UCA_SOURCES = [
+    ('cloud:precise-folsom/proposed', url + ' precise-proposed/folsom main'),
+    ('cloud:precise-folsom', url + ' precise-updates/folsom main'),
+    ('cloud:precise-folsom/updates', url + ' precise-updates/folsom main'),
+    ('cloud:precise-grizzly/proposed', url + ' precise-proposed/grizzly main'),
+    ('cloud:precise-grizzly', url + ' precise-updates/grizzly main'),
+    ('cloud:precise-grizzly/updates', url + ' precise-updates/grizzly main'),
+    ('cloud:precise-havana/proposed', url + ' precise-proposed/havana main'),
+    ('cloud:precise-havana', url + ' precise-updates/havana main'),
+    ('cloud:precise-havana/updates', url + ' precise-updates/havana main'),
+    ('cloud:precise-icehouse/proposed',
+     url + ' precise-proposed/icehouse main'),
+    ('cloud:precise-icehouse', url + ' precise-updates/icehouse main'),
+    ('cloud:precise-icehouse/updates', url + ' precise-updates/icehouse main'),
+]
+
+# Mock python-dnspython resolver used by get_host_ip()
+
+
+class FakeAnswer(object):
+
+    def __init__(self, ip):
+        self.ip = ip
+
+    def __str__(self):
+        return self.ip
+
+
+class FakeResolver(object):
+
+    def __init__(self, ip):
+        self.ip = ip
+
+    def query(self, hostname, query_type):
+        if self.ip == '':
+            return []
+        else:
+            return [FakeAnswer(self.ip)]
+
+
+class FakeReverse(object):
+
+    def from_address(self, address):
+        return '156.94.189.91.in-addr.arpa'
+
+
+class FakeDNSName(object):
+
+    def __init__(self, dnsname):
+        pass
+
+
+class FakeDNS(object):
+
+    def __init__(self, ip):
+        self.resolver = FakeResolver(ip)
+        self.reversename = FakeReverse()
+        self.name = MagicMock()
+        self.name.Name = FakeDNSName
+
+
+class OpenStackHelpersTestCase(TestCase):
+
+    def setUp(self):
+        super(OpenStackHelpersTestCase, self).setUp()
+        self.patch(fetch, 'get_apt_dpkg_env', lambda: {})
+
+    def _apt_cache(self):
+        # mocks out the apt cache
+        def cache_get(package):
+            pkg = MagicMock()
+            if package in FAKE_REPO and 'pkg_vers' in FAKE_REPO[package]:
+                pkg.name = package
+                pkg.current_ver.ver_str = FAKE_REPO[package]['pkg_vers']
+            elif (package in FAKE_REPO and
+                  'pkg_vers' not in FAKE_REPO[package]):
+                pkg.name = package
+                pkg.current_ver = None
+            else:
+                raise KeyError
+            return pkg
+        cache = MagicMock()
+        cache.__getitem__.side_effect = cache_get
+        return cache
+
+    @patch.object(openstack, 'filter_missing_packages')
+    def test_get_installed_semantic_versioned_packages(self, mock_filter):
+        def _filter_missing_packages(pkgs):
+            return [x for x in pkgs if x in ['cinder-common']]
+        mock_filter.side_effect = _filter_missing_packages
+        self.assertEquals(
+            openstack.get_installed_semantic_versioned_packages(),
+            ['cinder-common'])
+
+    @patch('charmhelpers.contrib.openstack.utils.lsb_release')
+    def test_os_codename_from_install_source(self, mocked_lsb):
+        """Test mapping install source to OpenStack release name"""
+        mocked_lsb.return_value = FAKE_RELEASE
+
+        # the openstack release shipped with respective ubuntu/lsb release.
+        self.assertEquals(openstack.get_os_codename_install_source('distro'),
+                          'essex')
+        # proposed pocket
+        self.assertEquals(openstack.get_os_codename_install_source(
+            'distro-proposed'),
+            'essex')
+        self.assertEquals(openstack.get_os_codename_install_source(
+            'proposed'),
+            'essex')
+
+        # various cloud archive pockets
+        src = 'cloud:precise-grizzly'
+        self.assertEquals(openstack.get_os_codename_install_source(src),
+                          'grizzly')
+        src = 'cloud:precise-grizzly/proposed'
+        self.assertEquals(openstack.get_os_codename_install_source(src),
+                          'grizzly')
+
+        # ppas and full repo urls.
+        src = 'ppa:openstack-ubuntu-testing/havana-trunk-testing'
+        self.assertEquals(openstack.get_os_codename_install_source(src),
+                          'havana')
+        src = ('deb http://ubuntu-cloud.archive.canonical.com/ubuntu '
+               'precise-havana main')
+        self.assertEquals(openstack.get_os_codename_install_source(src),
+                          'havana')
+        self.assertEquals(openstack.get_os_codename_install_source(None),
+                          '')
+
+    @patch.object(openstack, 'get_os_version_codename')
+    @patch.object(openstack, 'get_os_codename_install_source')
+    def test_os_version_from_install_source(self, codename, version):
+        codename.return_value = 'grizzly'
+        openstack.get_os_version_install_source('cloud:precise-grizzly')
+        version.assert_called_with('grizzly')
+
+    @patch('charmhelpers.contrib.openstack.utils.lsb_release')
+    def test_os_codename_from_bad_install_source(self, mocked_lsb):
+        """Test mapping install source to OpenStack release name"""
+        _fake_release = copy(FAKE_RELEASE)
+        _fake_release['DISTRIB_CODENAME'] = 'natty'
+
+        mocked_lsb.return_value = _fake_release
+        _e = 'charmhelpers.contrib.openstack.utils.error_out'
+        with patch(_e) as mocked_err:
+            openstack.get_os_codename_install_source('distro')
+            _er = ('Could not derive openstack release for this Ubuntu '
+                   'release: natty')
+            mocked_err.assert_called_with(_er)
+
+    def test_os_codename_from_version(self):
+        """Test mapping OpenStack numerical versions to code name"""
+        self.assertEquals(openstack.get_os_codename_version('2013.1'),
+                          'grizzly')
+
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_codename_from_bad_version(self, mocked_error):
+        """Test mapping a bad OpenStack numerical versions to code name"""
+        openstack.get_os_codename_version('2014.5.5')
+        expected_err = ('Could not determine OpenStack codename for '
+                        'version 2014.5.5')
+        mocked_error.assert_called_with(expected_err)
+
+    def test_os_version_from_codename(self):
+        """Test mapping a OpenStack codename to numerical version"""
+        self.assertEquals(openstack.get_os_version_codename('folsom'),
+                          '2012.2')
+
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_version_from_bad_codename(self, mocked_error):
+        """Test mapping a bad OpenStack codename to numerical version"""
+        openstack.get_os_version_codename('foo')
+        expected_err = 'Could not derive OpenStack version for codename: foo'
+        mocked_error.assert_called_with(expected_err)
+
+    def test_os_version_swift_from_codename(self):
+        """Test mapping a swift codename to numerical version"""
+        self.assertEquals(openstack.get_os_version_codename_swift('liberty'),
+                          '2.5.0')
+
+    def test_get_swift_codename_single_version_kilo(self):
+        self.assertEquals(openstack.get_swift_codename('2.2.2'), 'kilo')
+
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_version_swift_from_bad_codename(self, mocked_error):
+        """Test mapping a bad swift codename to numerical version"""
+        openstack.get_os_version_codename_swift('foo')
+        expected_err = 'Could not derive swift version for codename: foo'
+        mocked_error.assert_called_with(expected_err)
+
+    def test_get_swift_codename_multiple_versions_liberty(self):
+        with patch('subprocess.check_output') as _subp:
+            _subp.return_value = b"... trusty-updates/liberty/main ..."
+            self.assertEquals(openstack.get_swift_codename('2.5.0'), 'liberty')
+
+    def test_get_swift_codename_multiple_versions_mitaka(self):
+        with patch('subprocess.check_output') as _subp:
+            _subp.return_value = b"... trusty-updates/mitaka/main ..."
+            self.assertEquals(openstack.get_swift_codename('2.5.0'), 'mitaka')
+
+    def test_get_swift_codename_none(self):
+        self.assertEquals(openstack.get_swift_codename('1.2.3'), None)
+
+    @patch.object(openstack, 'snap_install_requested')
+    def test_os_codename_from_package(self, mock_snap_install_requested):
+        """Test deriving OpenStack codename from an installed package"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            for pkg, vers in six.iteritems(FAKE_REPO):
+                # test fake repo for all "installed" packages
+                if pkg.startswith('bad-'):
+                    continue
+                if 'pkg_vers' not in vers:
+                    continue
+                self.assertEquals(openstack.get_os_codename_package(pkg),
+                                  vers['os_release'])
+
+    @patch.object(openstack, 'snap_install_requested')
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_codename_from_bad_package_version(self, mocked_error,
+                                                  mock_snap_install_requested):
+        """Test deriving OpenStack codename for a poorly versioned package"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            openstack.get_os_codename_package('bad-version')
+            _e = ('Could not determine OpenStack codename for version 2200.1')
+            mocked_error.assert_called_with(_e)
+
+    @patch.object(openstack, 'snap_install_requested')
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_codename_from_bad_package(self, mocked_error,
+                                          mock_snap_install_requested):
+        """Test deriving OpenStack codename from an unavailable package"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            try:
+                openstack.get_os_codename_package('foo')
+            except Exception:
+                # ignore exceptions that raise when error_out is mocked
+                # and doesn't sys.exit(1)
+                pass
+            e = 'Could not determine version of package with no installation '\
+                'candidate: foo'
+            mocked_error.assert_called_with(e)
+
+    @patch.object(openstack, 'snap_install_requested')
+    def test_os_codename_from_bad_package_nonfatal(
+            self, mock_snap_install_requested):
+        """Test OpenStack codename from an unavailable package is non-fatal"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            self.assertEquals(
+                None,
+                openstack.get_os_codename_package('foo', fatal=False)
+            )
+
+    @patch.object(openstack, 'snap_install_requested')
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_codename_from_uninstalled_package(self, mock_error,
+                                                  mock_snap_install_requested):
+        """Test OpenStack codename from an available but uninstalled pkg"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            try:
+                openstack.get_os_codename_package('cinder-common', fatal=True)
+            except Exception:
+                pass
+            e = ('Could not determine version of uninstalled package: '
+                 'cinder-common')
+            mock_error.assert_called_with(e)
+
+    @patch.object(openstack, 'snap_install_requested')
+    def test_os_codename_from_uninstalled_package_nonfatal(
+            self, mock_snap_install_requested):
+        """Test OpenStack codename from avail uninstalled pkg is non fatal"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            self.assertEquals(
+                None,
+                openstack.get_os_codename_package('cinder-common', fatal=False)
+            )
+
+    @patch.object(openstack, 'snap_install_requested')
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_version_from_package(self, mocked_error,
+                                     mock_snap_install_requested):
+        """Test deriving OpenStack version from an installed package"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            for pkg, vers in six.iteritems(FAKE_REPO):
+                if pkg.startswith('bad-'):
+                    continue
+                if 'pkg_vers' not in vers:
+                    continue
+                self.assertEquals(openstack.get_os_version_package(pkg),
+                                  vers['os_version'])
+
+    @patch.object(openstack, 'snap_install_requested')
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_os_version_from_bad_package(self, mocked_error,
+                                         mock_snap_install_requested):
+        """Test deriving OpenStack version from an uninstalled package"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            try:
+                openstack.get_os_version_package('foo')
+            except Exception:
+                # ignore exceptions that raise when error_out is mocked
+                # and doesn't sys.exit(1)
+                pass
+            e = 'Could not determine version of package with no installation '\
+                'candidate: foo'
+            mocked_error.assert_called_with(e)
+
+    @patch.object(openstack, 'snap_install_requested')
+    def test_os_version_from_bad_package_nonfatal(
+            self, mock_snap_install_requested):
+        """Test OpenStack version from an uninstalled package is non-fatal"""
+        mock_snap_install_requested.return_value = False
+        with patch.object(openstack, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            self.assertEquals(
+                None,
+                openstack.get_os_version_package('foo', fatal=False)
+            )
+
+    @patch.object(openstack, 'get_os_codename_package')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_os_release_uncached(self, config, get_cn):
+        openstack._os_rel = None
+        get_cn.return_value = 'folsom'
+        self.assertEquals('folsom', openstack.os_release('nova-common'))
+
+    def test_os_release_cached(self):
+        openstack._os_rel = 'foo'
+        self.assertEquals('foo', openstack.os_release('nova-common'))
+
+    @patch.object(openstack, 'juju_log')
+    @patch('sys.exit')
+    def test_error_out(self, mocked_exit, juju_log):
+        """Test erroring out"""
+        openstack.error_out('Everything broke.')
+        _log = 'FATAL ERROR: Everything broke.'
+        juju_log.assert_called_with(_log, level='ERROR')
+        mocked_exit.assert_called_with(1)
+
+    def test_get_source_and_pgp_key(self):
+        tests = {
+            "source|key": ('source', 'key'),
+            "source|": ('source', None),
+            "|key": ('', 'key'),
+            "source": ('source', None),
+        }
+        for k, v in six.iteritems(tests):
+            self.assertEqual(openstack.get_source_and_pgp_key(k), v)
+
+    # These should still work, even though the bulk of the functionality has
+    # moved to charmhelpers.fetch.add_source()
+    def test_configure_install_source_distro(self):
+        """Test configuring installation from distro"""
+        self.assertIsNone(openstack.configure_installation_source('distro'))
+
+    def test_configure_install_source_ppa(self):
+        """Test configuring installation source from PPA"""
+        with patch('subprocess.check_call') as mock:
+            src = 'ppa:gandelman-a/openstack'
+            openstack.configure_installation_source(src)
+            ex_cmd = [
+                'add-apt-repository', '--yes', 'ppa:gandelman-a/openstack']
+            mock.assert_called_with(ex_cmd, env={})
+
+    @patch('subprocess.check_call')
+    @patch.object(fetch, 'import_key')
+    def test_configure_install_source_deb_url(self, _import, _spcc):
+        """Test configuring installation source from deb repo url"""
+        src = ('deb http://ubuntu-cloud.archive.canonical.com/ubuntu '
+               'precise-havana main|KEYID')
+        openstack.configure_installation_source(src)
+        _import.assert_called_with('KEYID')
+        _spcc.assert_called_once_with(
+            ['add-apt-repository', '--yes',
+             'deb http://ubuntu-cloud.archive.canonical.com/ubuntu '
+             'precise-havana main'], env={})
+
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch(builtin_open)
+    @patch('subprocess.check_call')
+    def test_configure_install_source_distro_proposed(
+            self, _spcc, _open, _lsb):
+        """Test configuring installation source from deb repo url"""
+        _lsb.return_value = FAKE_CODENAME
+        _file = MagicMock(spec=io.FileIO)
+        _open.return_value = _file
+        openstack.configure_installation_source('distro-proposed')
+        _file.__enter__().write.assert_called_once_with(
+            '# Proposed\ndeb http://archive.ubuntu.com/ubuntu '
+            'precise-proposed main universe multiverse restricted\n')
+        src = ('deb http://archive.ubuntu.com/ubuntu/ precise-proposed '
+               'restricted main multiverse universe')
+        openstack.configure_installation_source(src)
+        _spcc.assert_called_once_with(
+            ['add-apt-repository', '--yes',
+             'deb http://archive.ubuntu.com/ubuntu/ precise-proposed '
+             'restricted main multiverse universe'], env={})
+
+    @patch('charmhelpers.fetch.filter_installed_packages')
+    @patch('charmhelpers.fetch.apt_install')
+    @patch.object(openstack, 'error_out')
+    @patch.object(openstack, 'juju_log')
+    def test_add_source_cloud_invalid_pocket(self, _log, _out,
+                                             apt_install, filter_pkg):
+        openstack.configure_installation_source("cloud:havana-updates")
+        _e = ('Invalid Cloud Archive release specified: '
+              'havana-updates on this Ubuntuversion')
+        _s = _out.call_args[0][0]
+        self.assertTrue(_s.startswith(_e))
+
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    @patch.object(fetch, 'get_distrib_codename')
+    def test_add_source_cloud_pocket_style(self, get_distrib_codename,
+                                           apt_install, filter_pkg):
+        source = "cloud:precise-updates/havana"
+        get_distrib_codename.return_value = 'precise'
+        result = (
+            "# Ubuntu Cloud Archive\n"
+            "deb http://ubuntu-cloud.archive.canonical.com/ubuntu "
+            "precise-updates/havana main\n")
+        with patch_open() as (mock_open, mock_file):
+            openstack.configure_installation_source(source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    @patch.object(fetch, 'get_distrib_codename')
+    def test_add_source_cloud_os_style(self, get_distrib_codename,
+                                       apt_install, filter_pkg):
+        source = "cloud:precise-havana"
+        get_distrib_codename.return_value = 'precise'
+        result = (
+            "# Ubuntu Cloud Archive\n"
+            "deb http://ubuntu-cloud.archive.canonical.com/ubuntu "
+            "precise-updates/havana main\n")
+        with patch_open() as (mock_open, mock_file):
+            openstack.configure_installation_source(source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    def test_add_source_cloud_distroless_style(self, apt_install, filter_pkg):
+        source = "cloud:havana"
+        result = (
+            "# Ubuntu Cloud Archive\n"
+            "deb http://ubuntu-cloud.archive.canonical.com/ubuntu "
+            "precise-updates/havana main\n")
+        with patch_open() as (mock_open, mock_file):
+            openstack.configure_installation_source(source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch('charmhelpers.fetch.ubuntu.log', lambda *args, **kwargs: None)
+    @patch('charmhelpers.contrib.openstack.utils.juju_log',
+           lambda *args, **kwargs: None)
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_configure_bad_install_source(self, _error):
+        openstack.configure_installation_source('foo')
+        _error.assert_called_with("Unknown source: 'foo'")
+
+    @patch.object(fetch, 'get_distrib_codename')
+    def test_configure_install_source_uca_staging(self, _lsb):
+        """Test configuring installation source from UCA staging sources"""
+        _lsb.return_value = FAKE_CODENAME
+        # staging pockets are configured as PPAs
+        with patch('subprocess.check_call') as _subp:
+            src = 'cloud:precise-folsom/staging'
+            openstack.configure_installation_source(src)
+            cmd = ['add-apt-repository', '-y',
+                   'ppa:ubuntu-cloud-archive/folsom-staging']
+            _subp.assert_called_with(cmd, env={})
+
+    @patch(builtin_open)
+    @patch.object(fetch, 'apt_install')
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch.object(fetch, 'filter_installed_packages')
+    def test_configure_install_source_uca_repos(
+            self, _fip, _lsb, _install, _open):
+        """Test configuring installation source from UCA sources"""
+        _lsb.return_value = FAKE_CODENAME
+        _file = MagicMock(spec=io.FileIO)
+        _open.return_value = _file
+        _fip.side_effect = lambda x: x
+        for src, url in UCA_SOURCES:
+            actual_url = "# Ubuntu Cloud Archive\n{}\n".format(url)
+            openstack.configure_installation_source(src)
+            _install.assert_called_with(['ubuntu-cloud-keyring'],
+                                        fatal=True)
+            _open.assert_called_with(
+                '/etc/apt/sources.list.d/cloud-archive.list',
+                'w'
+            )
+            _file.__enter__().write.assert_called_with(actual_url)
+
+    @patch('charmhelpers.contrib.openstack.utils.error_out')
+    def test_configure_install_source_bad_uca(self, mocked_error):
+        """Test configuring installation source from bad UCA source"""
+        try:
+            openstack.configure_installation_source('cloud:foo-bar')
+        except Exception:
+            # ignore exceptions that raise when error_out is mocked
+            # and doesn't sys.exit(1)
+            pass
+        _e = ('Invalid Cloud Archive release specified: foo-bar'
+              ' on this Ubuntuversion')
+        _s = mocked_error.call_args[0][0]
+        self.assertTrue(_s.startswith(_e))
+
+    @patch.object(openstack, 'fetch_import_key')
+    def test_import_key_calls_fetch_import_key(self, fetch_import_key):
+        openstack.import_key('random-string')
+        fetch_import_key.assert_called_once_with('random-string')
+
+    @patch.object(openstack, 'juju_log', lambda *args, **kwargs: None)
+    @patch.object(openstack, 'fetch_import_key')
+    @patch.object(openstack, 'sys')
+    def test_import_key_calls_sys_exit_on_error(self, mock_sys,
+                                                fetch_import_key):
+
+        def raiser(_):
+            raise openstack.GPGKeyError("an error occurred")
+        fetch_import_key.side_effect = raiser
+        openstack.import_key('random failure')
+        mock_sys.exit.assert_called_once_with(1)
+
+    @patch('os.mkdir')
+    @patch('os.path.exists')
+    @patch('charmhelpers.contrib.openstack.utils.charm_dir')
+    @patch(builtin_open)
+    def test_save_scriptrc(self, _open, _charm_dir, _exists, _mkdir):
+        """Test generation of scriptrc from environment"""
+        scriptrc = ['#!/bin/bash\n',
+                    'export setting1=foo\n',
+                    'export setting2=bar\n']
+        _file = MagicMock(spec=io.FileIO)
+        _open.return_value = _file
+        _charm_dir.return_value = '/var/lib/juju/units/testing-foo-0/charm'
+        _exists.return_value = False
+        os.environ['JUJU_UNIT_NAME'] = 'testing-foo/0'
+        openstack.save_script_rc(setting1='foo', setting2='bar')
+        rcdir = '/var/lib/juju/units/testing-foo-0/charm/scripts'
+        _mkdir.assert_called_with(rcdir)
+        expected_f = '/var/lib/juju/units/testing-foo-0/charm/scripts/scriptrc'
+        _open.assert_called_with(expected_f, 'wt')
+        _mkdir.assert_called_with(os.path.dirname(expected_f))
+        _file.__enter__().write.assert_has_calls(
+            list(call(line) for line in scriptrc), any_order=True)
+
+    @patch.object(openstack, 'lsb_release')
+    @patch.object(openstack, 'get_os_version_package')
+    @patch.object(openstack, 'get_os_version_codename_swift')
+    @patch.object(openstack, 'config')
+    def test_openstack_upgrade_detection_true(self, config, vers_swift,
+                                              vers_pkg, lsb):
+        """Test it detects when an openstack package has available upgrade"""
+        lsb.return_value = FAKE_RELEASE
+        config.return_value = 'cloud:precise-havana'
+        vers_pkg.return_value = '2013.1.1'
+        self.assertTrue(openstack.openstack_upgrade_available('nova-common'))
+        # milestone to major release detection
+        vers_pkg.return_value = '2013.2~b1'
+        self.assertTrue(openstack.openstack_upgrade_available('nova-common'))
+        vers_pkg.return_value = '1.9.0'
+        vers_swift.return_value = '2.5.0'
+        self.assertTrue(openstack.openstack_upgrade_available('swift-proxy'))
+        vers_pkg.return_value = '2.5.0'
+        vers_swift.return_value = '2.10.0'
+        self.assertTrue(openstack.openstack_upgrade_available('swift-proxy'))
+
+    @patch.object(openstack, 'lsb_release')
+    @patch.object(openstack, 'get_os_version_package')
+    @patch.object(openstack, 'config')
+    def test_openstack_upgrade_detection_false(self, config, vers_pkg, lsb):
+        """Test it detects when an openstack upgrade is not necessary"""
+        lsb.return_value = FAKE_RELEASE
+        config.return_value = 'cloud:precise-folsom'
+        vers_pkg.return_value = '2013.1.1'
+        self.assertFalse(openstack.openstack_upgrade_available('nova-common'))
+        # milestone to majro release detection
+        vers_pkg.return_value = '2013.1~b1'
+        self.assertFalse(openstack.openstack_upgrade_available('nova-common'))
+        # ugly duckling testing
+        config.return_value = 'cloud:precise-havana'
+        vers_pkg.return_value = '1.10.0'
+        self.assertFalse(openstack.openstack_upgrade_available('swift-proxy'))
+
+    @patch.object(openstack, 'is_block_device')
+    @patch.object(openstack, 'error_out')
+    def test_ensure_block_device_bad_config(self, err, is_bd):
+        """Test it doesn't prepare storage with bad config"""
+        openstack.ensure_block_device(block_device='none')
+        self.assertTrue(err.called)
+
+    @patch.object(openstack, 'is_block_device')
+    @patch.object(openstack, 'ensure_loopback_device')
+    def test_ensure_block_device_loopback(self, ensure_loopback, is_bd):
+        """Test it ensures loopback device when checking block device"""
+        defsize = openstack.DEFAULT_LOOPBACK_SIZE
+        is_bd.return_value = True
+
+        ensure_loopback.return_value = '/tmp/cinder.img'
+        result = openstack.ensure_block_device('/tmp/cinder.img')
+        ensure_loopback.assert_called_with('/tmp/cinder.img', defsize)
+        self.assertEquals(result, '/tmp/cinder.img')
+
+        ensure_loopback.return_value = '/tmp/cinder-2.img'
+        result = openstack.ensure_block_device('/tmp/cinder-2.img|15G')
+        ensure_loopback.assert_called_with('/tmp/cinder-2.img', '15G')
+        self.assertEquals(result, '/tmp/cinder-2.img')
+
+    @patch.object(openstack, 'is_block_device')
+    def test_ensure_standard_block_device(self, is_bd):
+        """Test it looks for storage at both relative and full device path"""
+        for dev in ['vdb', '/dev/vdb']:
+            openstack.ensure_block_device(dev)
+            is_bd.assert_called_with('/dev/vdb')
+
+    @patch.object(openstack, 'is_block_device')
+    @patch.object(openstack, 'error_out')
+    def test_ensure_nonexistent_block_device(self, error_out, is_bd):
+        """Test it will not ensure a non-existant block device"""
+        is_bd.return_value = False
+        openstack.ensure_block_device(block_device='foo')
+        self.assertTrue(error_out.called)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'umount')
+    @patch.object(openstack, 'mounts')
+    @patch.object(openstack, 'zap_disk')
+    @patch.object(openstack, 'is_lvm_physical_volume')
+    def test_clean_storage_unmount(self, is_pv, zap_disk, mounts, umount, log):
+        """Test it unmounts block device when cleaning storage"""
+        is_pv.return_value = False
+        zap_disk.return_value = True
+        mounts.return_value = MOUNTS
+        openstack.clean_storage('/dev/vdb')
+        umount.called_with('/dev/vdb', True)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'remove_lvm_physical_volume')
+    @patch.object(openstack, 'deactivate_lvm_volume_group')
+    @patch.object(openstack, 'mounts')
+    @patch.object(openstack, 'is_lvm_physical_volume')
+    def test_clean_storage_lvm_wipe(self, is_pv, mounts, rm_lv, rm_vg, log):
+        """Test it removes traces of LVM when cleaning storage"""
+        mounts.return_value = []
+        is_pv.return_value = True
+        openstack.clean_storage('/dev/vdb')
+        rm_lv.assert_called_with('/dev/vdb')
+        rm_vg .assert_called_with('/dev/vdb')
+
+    @patch.object(openstack, 'zap_disk')
+    @patch.object(openstack, 'is_lvm_physical_volume')
+    @patch.object(openstack, 'mounts')
+    def test_clean_storage_zap_disk(self, mounts, is_pv, zap_disk):
+        """It removes traces of LVM when cleaning storage"""
+        mounts.return_value = []
+        is_pv.return_value = False
+        openstack.clean_storage('/dev/vdb')
+        zap_disk.assert_called_with('/dev/vdb')
+
+    @patch('os.path.isfile')
+    @patch(builtin_open)
+    def test_get_matchmaker_map(self, _open, _isfile):
+        _isfile.return_value = True
+        mm_data = """
+        {
+           "cinder-scheduler": [
+             "juju-t-machine-4"
+            ]
+        }
+        """
+        fh = _open.return_value.__enter__.return_value
+        fh.read.return_value = mm_data
+        self.assertEqual(
+            openstack.get_matchmaker_map(),
+            {'cinder-scheduler': ['juju-t-machine-4']}
+        )
+
+    @patch('os.path.isfile')
+    @patch(builtin_open)
+    def test_get_matchmaker_map_nofile(self, _open, _isfile):
+        _isfile.return_value = False
+        self.assertEqual(
+            openstack.get_matchmaker_map(),
+            {}
+        )
+
+    def test_incomplete_relation_data(self):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['pgsql-db', 'amqp']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+        expected_result = 'identity'
+
+        result = openstack.incomplete_relation_data(
+            configs, required_interfaces)
+        self.assertTrue(expected_result in result.keys())
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete(
+            self, is_unit_paused_set, status_set, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['shared-db',
+                                                  'amqp',
+                                                  'identity-service']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+        status_set.assert_called_with('active', 'Unit is ready')
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.incomplete_relation_data',
+           return_value={'identity': {'identity-service': {'related': True}}})
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_related_incomplete(
+            self, is_unit_paused_set, status_set,
+            incomplete_relation_data, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['shared-db', 'amqp']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+        status_set.assert_called_with('waiting',
+                                      "Incomplete relations: identity")
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.incomplete_relation_data',
+           return_value={'identity': {'identity-service': {'related': False}}})
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_absent(
+            self, is_unit_paused_set, status_set,
+            incomplete_relation_data, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['shared-db', 'amqp']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+        status_set.assert_called_with('blocked',
+                                      'Missing relations: identity')
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.hook_name',
+           return_value='identity-service-relation-broken')
+    @patch('charmhelpers.contrib.openstack.utils.incomplete_relation_data',
+           return_value={'identity': {'identity-service': {'related': True}}})
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_related_broken(
+            self, is_unit_paused_set, status_set,
+            incomplete_relation_data, hook_name, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['shared-db', 'amqp']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+        status_set.assert_called_with('blocked',
+                                      "Missing relations: identity")
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.incomplete_relation_data',
+           return_value={'identity':
+                         {'identity-service': {'related': True}},
+
+                         'message':
+                         {'amqp': {'missing_data': ['rabbitmq-password'],
+                                   'related': True}},
+
+                         'database':
+                         {'shared-db': {'related': False}}
+                         })
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_mixed(
+            self, is_unit_paused_set, status_set,
+            incomplete_relation_data, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = ['shared-db', 'amqp']
+        required_interfaces = {
+            'database': ['shared-db', 'pgsql-db'],
+            'message': ['amqp', 'zeromq-configuration'],
+            'identity': ['identity-service']}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+
+        args = status_set.call_args
+        actual_parm1 = args[0][0]
+        actual_parm2 = args[0][1]
+        expected1 = ("Missing relations: database; incomplete relations: "
+                     "identity, message")
+        expected2 = ("Missing relations: database; incomplete relations: "
+                     "message, identity")
+        self.assertTrue(actual_parm1 == 'blocked')
+        self.assertTrue(actual_parm2 == expected1 or actual_parm2 == expected2)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_with_services_list(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = ['database', 'identity']
+        # Assume that the service and ports are open.
+        port_has_listener.return_value = True
+        service_running.return_value = True
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with('active', 'Unit is ready')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_services_list_not_running(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = ['database', 'identity']
+        port_has_listener.return_value = True
+        # Fail the identity service
+        service_running.side_effect = [True, False]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'blocked',
+            'Services not running that should be: identity')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_with_services(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        # Assume that the service and ports are open.
+        port_has_listener.return_value = True
+        service_running.return_value = True
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with('active', 'Unit is ready')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_service_not_running(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        port_has_listener.return_value = True
+        # Fail the identity service
+        service_running.side_effect = [True, False]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'blocked',
+            'Services not running that should be: identity')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_port_not_open(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        port_has_listener.side_effect = [True, False, True]
+        # Fail the identity service
+        service_running.return_value = True
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'blocked',
+            'Services with ports not open that should be:'
+            ' database: [20]')
+
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=False)
+    def test_set_os_workload_status_complete_ports_not_open(
+            self, is_unit_paused_set, status_set, log, port_has_listener):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        ports = [50, 60, 70]
+        port_has_listener.side_effect = [True, False, True]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, ports=ports)
+        status_set.assert_called_with(
+            'blocked',
+            'Ports which should be open, but are not: 60')
+
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_simple(
+            self, is_unit_paused_set, status_set, log):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        openstack.set_os_workload_status(configs, required_interfaces)
+        status_set.assert_called_with(
+            'maintenance',
+            "Paused. Use 'resume' action to resume normal service.")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_services_check(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        port_has_listener.return_value = False
+        service_running.side_effect = [False, False]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'maintenance',
+            "Paused. Use 'resume' action to resume normal service.")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_services_fail(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        port_has_listener.return_value = False
+        # Fail the identity service
+        service_running.side_effect = [False, True]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'blocked',
+            "Services should be paused but these services running: identity")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_services_ports_fail(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener, service_running):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        # make the service 20 port be still listening.
+        port_has_listener.side_effect = [False, True, False]
+        service_running.return_value = False
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, services=services)
+        status_set.assert_called_with(
+            'blocked',
+            "Services should be paused but these service:ports are open:"
+            " database: [20]")
+
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_ports_check(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        ports = [50, 60, 70]
+        port_has_listener.side_effect = [False, False, False]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, ports=ports)
+        status_set.assert_called_with(
+            'maintenance',
+            "Paused. Use 'resume' action to resume normal service.")
+
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    @patch.object(openstack, 'juju_log')
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.is_unit_paused_set',
+           return_value=True)
+    def test_set_os_workload_status_paused_ports_fail(
+            self, is_unit_paused_set, status_set, log,
+            port_has_listener):
+        configs = MagicMock()
+        configs.complete_contexts.return_value = []
+        required_interfaces = {}
+
+        # fail port 70 to make it seem to be running
+        ports = [50, 60, 70]
+        port_has_listener.side_effect = [False, False, True]
+
+        openstack.set_os_workload_status(
+            configs, required_interfaces, ports=ports)
+        status_set.assert_called_with(
+            'blocked',
+            "Services should be paused but "
+            "these ports which should be closed, but are open: 70")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_simple_services(
+            self, port_has_listener, service_running):
+        services = ['database', 'identity']
+        port_has_listener.return_value = False
+        service_running.return_value = False
+
+        state, message = openstack.check_actually_paused(
+            services)
+        self.assertEquals(state, None)
+        self.assertEquals(message, None)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_simple_services_fail(
+            self, port_has_listener, service_running):
+        services = ['database', 'identity']
+        port_has_listener.return_value = False
+        service_running.side_effect = [False, True]
+
+        state, message = openstack.check_actually_paused(
+            services)
+        self.assertEquals(state, 'blocked')
+        self.assertEquals(
+            message,
+            "Services should be paused but these services running: identity")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_services_dict(
+            self, port_has_listener, service_running):
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        # Assume that the service and ports are open.
+        port_has_listener.return_value = False
+        service_running.return_value = False
+
+        state, message = openstack.check_actually_paused(
+            services)
+        self.assertEquals(state, None)
+        self.assertEquals(message, None)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_services_dict_fail(
+            self, port_has_listener, service_running):
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        # Assume that the service and ports are open.
+        port_has_listener.return_value = False
+        service_running.side_effect = [False, True]
+
+        state, message = openstack.check_actually_paused(
+            services)
+        self.assertEquals(state, 'blocked')
+        self.assertEquals(
+            message,
+            "Services should be paused but these services running: identity")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_services_dict_ports_fail(
+            self, port_has_listener, service_running):
+        services = [
+            {'service': 'database', 'ports': [10, 20]},
+            {'service': 'identity', 'ports': [30]},
+        ]
+        # Assume that the service and ports are open.
+        port_has_listener.side_effect = [False, True, False]
+        service_running.return_value = False
+
+        state, message = openstack.check_actually_paused(
+            services)
+        self.assertEquals(state, 'blocked')
+        self.assertEquals(message,
+                          'Services should be paused but these service:ports'
+                          ' are open: database: [20]')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_ports_okay(
+            self, port_has_listener, service_running):
+        port_has_listener.side_effect = [False, False, False]
+        service_running.return_value = False
+        ports = [50, 60, 70]
+
+        state, message = openstack.check_actually_paused(
+            ports=ports)
+        self.assertEquals(state, None)
+        self.assertEquals(state, None)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_running')
+    @patch('charmhelpers.contrib.openstack.utils.port_has_listener')
+    def test_check_actually_paused_ports_fail(
+            self, port_has_listener, service_running):
+        port_has_listener.side_effect = [False, True, False]
+        service_running.return_value = False
+        ports = [50, 60, 70]
+
+        state, message = openstack.check_actually_paused(
+            ports=ports)
+        self.assertEquals(state, 'blocked')
+        self.assertEquals(message,
+                          'Services should be paused but these ports '
+                          'which should be closed, but are open: 60')
+
+    @staticmethod
+    def _unit_paused_helper(hook_data_mock):
+        # HookData()() returns a tuple (kv, delta_config, delta_relation)
+        # but we only want kv in the test.
+        kv = MagicMock()
+
+        @contextlib.contextmanager
+        def hook_data__call__():
+            yield (kv, True, False)
+
+        hook_data__call__.return_value = (kv, True, False)
+        hook_data_mock.return_value = hook_data__call__
+        return kv
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_set_unit_paused(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        openstack.set_unit_paused()
+        kv.set.assert_called_once_with('unit-paused', True)
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_set_unit_upgrading(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        openstack.set_unit_upgrading()
+        kv.set.assert_called_once_with('unit-upgrading', True)
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_clear_unit_paused(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        openstack.clear_unit_paused()
+        kv.set.assert_called_once_with('unit-paused', False)
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_clear_unit_upgrading(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        openstack.clear_unit_upgrading()
+        kv.set.assert_called_once_with('unit-upgrading', False)
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_is_unit_paused_set(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        kv.get.return_value = True
+        r = openstack.is_unit_paused_set()
+        kv.get.assert_called_once_with('unit-paused')
+        self.assertEquals(r, True)
+        kv.get.return_value = False
+        r = openstack.is_unit_paused_set()
+        self.assertEquals(r, False)
+
+    @patch('charmhelpers.contrib.openstack.utils.unitdata.HookData')
+    def test_is_unit_upgrading_set(self, hook_data):
+        kv = self._unit_paused_helper(hook_data)
+        kv.get.return_value = True
+        r = openstack.is_unit_upgrading_set()
+        kv.get.assert_called_once_with('unit-upgrading')
+        self.assertEquals(r, True)
+        kv.get.return_value = False
+        r = openstack.is_unit_upgrading_set()
+        self.assertEquals(r, False)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_stop')
+    def test_manage_payload_services_ok(self, service_stop):
+        services = ['service1', 'service2']
+        service_stop.side_effect = [True, True]
+        self.assertEqual(
+            openstack.manage_payload_services('stop', services=services),
+            (True, []))
+
+    @patch('charmhelpers.contrib.openstack.utils.service_stop')
+    def test_manage_payload_services_fails(self, service_stop):
+        services = ['service1', 'service2']
+        service_stop.side_effect = [True, False]
+        self.assertEqual(
+            openstack.manage_payload_services('stop', services=services),
+            (False, ["service2 didn't stop cleanly."]))
+
+    @patch('charmhelpers.contrib.openstack.utils.service_stop')
+    def test_manage_payload_services_charm_func(self, service_stop):
+        bespoke_func = MagicMock()
+        bespoke_func.return_value = None
+        services = ['service1', 'service2']
+        service_stop.side_effect = [True, True]
+        self.assertEqual(
+            openstack.manage_payload_services('stop', services=services,
+                                              charm_func=bespoke_func),
+            (True, []))
+        bespoke_func.assert_called_once_with()
+
+    @patch('charmhelpers.contrib.openstack.utils.service_stop')
+    def test_manage_payload_services_charm_func_msg(self, service_stop):
+        bespoke_func = MagicMock()
+        bespoke_func.return_value = 'it worked'
+        services = ['service1', 'service2']
+        service_stop.side_effect = [True, True]
+        self.assertEqual(
+            openstack.manage_payload_services('stop', services=services,
+                                              charm_func=bespoke_func),
+            (True, ['it worked']))
+        bespoke_func.assert_called_once_with()
+
+    @patch('charmhelpers.contrib.openstack.utils.service_stop')
+    def test_manage_payload_services_charm_func_fails(self, service_stop):
+        bespoke_func = MagicMock()
+        bespoke_func.side_effect = Exception('it failed')
+        services = ['service1', 'service2']
+        service_stop.side_effect = [True, True]
+        self.assertEqual(
+            openstack.manage_payload_services('stop', services=services,
+                                              charm_func=bespoke_func),
+            (False, ['it failed']))
+        bespoke_func.assert_called_once_with()
+
+    def test_manage_payload_services_wrong_action(self):
+        self.assertRaises(
+            RuntimeError,
+            openstack.manage_payload_services,
+            'mangle')
+
+    @patch('charmhelpers.contrib.openstack.utils.service_pause')
+    @patch('charmhelpers.contrib.openstack.utils.set_unit_paused')
+    def test_pause_unit_okay(self, set_unit_paused, service_pause):
+        services = ['service1', 'service2']
+        service_pause.side_effect = [True, True]
+        openstack.pause_unit(None, services=services)
+        set_unit_paused.assert_called_once_with()
+        self.assertEquals(service_pause.call_count, 2)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_pause')
+    @patch('charmhelpers.contrib.openstack.utils.set_unit_paused')
+    def test_pause_unit_service_fails(self, set_unit_paused, service_pause):
+        services = ['service1', 'service2']
+        service_pause.side_effect = [True, True]
+        openstack.pause_unit(None, services=services)
+        set_unit_paused.assert_called_once_with()
+        self.assertEquals(service_pause.call_count, 2)
+        # Fail the 2nd service
+        service_pause.side_effect = [True, False]
+        try:
+            openstack.pause_unit(None, services=services)
+            raise Exception("pause_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(e.args[0],
+                              "Couldn't pause: service2 didn't pause cleanly.")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_pause')
+    @patch('charmhelpers.contrib.openstack.utils.set_unit_paused')
+    def test_pause_unit_service_charm_func(
+            self, set_unit_paused, service_pause):
+        services = ['service1', 'service2']
+        service_pause.return_value = True
+        charm_func = MagicMock()
+        charm_func.return_value = None
+        openstack.pause_unit(None, services=services, charm_func=charm_func)
+        charm_func.assert_called_once_with()
+        # fail the charm_func
+        charm_func.return_value = "Custom charm failed"
+        try:
+            openstack.pause_unit(
+                None, services=services, charm_func=charm_func)
+            raise Exception("pause_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(e.args[0],
+                              "Couldn't pause: Custom charm failed")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_pause')
+    @patch('charmhelpers.contrib.openstack.utils.set_unit_paused')
+    def test_pause_unit_assess_status_func(
+            self, set_unit_paused, service_pause):
+        services = ['service1', 'service2']
+        service_pause.return_value = True
+        assess_status_func = MagicMock()
+        assess_status_func.return_value = None
+        openstack.pause_unit(assess_status_func, services=services)
+        assess_status_func.assert_called_once_with()
+        # fail the assess_status_func
+        assess_status_func.return_value = "assess_status_func failed"
+        try:
+            openstack.pause_unit(assess_status_func, services=services)
+            raise Exception("pause_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(e.args[0],
+                              "Couldn't pause: assess_status_func failed")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_resume')
+    @patch('charmhelpers.contrib.openstack.utils.clear_unit_paused')
+    def test_resume_unit_okay(self, clear_unit_paused, service_resume):
+        services = ['service1', 'service2']
+        service_resume.side_effect = [True, True]
+        openstack.resume_unit(None, services=services)
+        clear_unit_paused.assert_called_once_with()
+        self.assertEquals(service_resume.call_count, 2)
+
+    @patch('charmhelpers.contrib.openstack.utils.service_resume')
+    @patch('charmhelpers.contrib.openstack.utils.clear_unit_paused')
+    def test_resume_unit_service_fails(
+            self, clear_unit_paused, service_resume):
+        services = ['service1', 'service2']
+        service_resume.side_effect = [True, True]
+        openstack.resume_unit(None, services=services)
+        clear_unit_paused.assert_called_once_with()
+        self.assertEquals(service_resume.call_count, 2)
+        # Fail the 2nd service
+        service_resume.side_effect = [True, False]
+        try:
+            openstack.resume_unit(None, services=services)
+            raise Exception("resume_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(
+                e.args[0], "Couldn't resume: service2 didn't resume cleanly.")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_resume')
+    @patch('charmhelpers.contrib.openstack.utils.clear_unit_paused')
+    def test_resume_unit_service_charm_func(
+            self, clear_unit_paused, service_resume):
+        services = ['service1', 'service2']
+        service_resume.return_value = True
+        charm_func = MagicMock()
+        charm_func.return_value = None
+        openstack.resume_unit(None, services=services, charm_func=charm_func)
+        charm_func.assert_called_once_with()
+        # fail the charm_func
+        charm_func.return_value = "Custom charm failed"
+        try:
+            openstack.resume_unit(
+                None, services=services, charm_func=charm_func)
+            raise Exception("resume_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(e.args[0],
+                              "Couldn't resume: Custom charm failed")
+
+    @patch('charmhelpers.contrib.openstack.utils.service_resume')
+    @patch('charmhelpers.contrib.openstack.utils.clear_unit_paused')
+    def test_resume_unit_assess_status_func(
+            self, clear_unit_paused, service_resume):
+        services = ['service1', 'service2']
+        service_resume.return_value = True
+        assess_status_func = MagicMock()
+        assess_status_func.return_value = None
+        openstack.resume_unit(assess_status_func, services=services)
+        assess_status_func.assert_called_once_with()
+        # fail the assess_status_func
+        assess_status_func.return_value = "assess_status_func failed"
+        try:
+            openstack.resume_unit(assess_status_func, services=services)
+            raise Exception("resume_unit should have raised Exception")
+        except Exception as e:
+            self.assertEquals(e.args[0],
+                              "Couldn't resume: assess_status_func failed")
+
+    @patch('charmhelpers.contrib.openstack.utils.status_set')
+    @patch('charmhelpers.contrib.openstack.utils.'
+           '_determine_os_workload_status')
+    def test_make_assess_status_func(self, _determine_os_workload_status,
+                                     status_set):
+        _determine_os_workload_status.return_value = ('active', 'fine')
+        f = openstack.make_assess_status_func('one', 'two', three='three')
+        r = f()
+        self.assertEquals(r, None)
+        _determine_os_workload_status.assert_called_once_with(
+            'one', 'two', three='three')
+        status_set.assert_called_once_with('active', 'fine')
+        # return something other than 'active' or 'maintenance'
+        _determine_os_workload_status.return_value = ('broken', 'damaged')
+        r = f()
+        self.assertEquals(r, 'damaged')
+
+    # TODO(ajkavanagh) -- there should be a test for
+    # _determine_os_workload_status() as the policyd override code has changed
+    # it, but there wasn't a test previously.
+
+    @patch.object(openstack, 'restart_on_change_helper')
+    @patch.object(openstack, 'is_unit_paused_set')
+    def test_pausable_restart_on_change(
+            self, is_unit_paused_set, restart_on_change_helper):
+        @openstack.pausable_restart_on_change({})
+        def test_func():
+            pass
+
+        # test with pause: restart_on_change_helper should not be called.
+        is_unit_paused_set.return_value = True
+        test_func()
+        self.assertEquals(restart_on_change_helper.call_count, 0)
+
+        # test without pause: restart_on_change_helper should be called.
+        is_unit_paused_set.return_value = False
+        test_func()
+        self.assertEquals(restart_on_change_helper.call_count, 1)
+
+    @patch.object(openstack, 'restart_on_change_helper')
+    @patch.object(openstack, 'is_unit_paused_set')
+    def test_pausable_restart_on_change_with_callable(
+            self, is_unit_paused_set, restart_on_change_helper):
+        mock_test = MagicMock()
+        mock_test.called_set = False
+
+        def _restart_map():
+            mock_test.called_set = True
+            return {"a": "b"}
+
+        @openstack.pausable_restart_on_change(_restart_map)
+        def test_func():
+            pass
+
+        self.assertFalse(mock_test.called_set)
+        is_unit_paused_set.return_value = False
+        test_func()
+        self.assertEquals(restart_on_change_helper.call_count, 1)
+        self.assertTrue(mock_test.called_set)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'action_set')
+    @patch.object(openstack, 'action_fail')
+    @patch.object(openstack, 'openstack_upgrade_available')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_openstack_upgrade(self, config, openstack_upgrade_available,
+                               action_fail, action_set, log):
+        def do_openstack_upgrade(configs):
+            pass
+
+        openstack_upgrade_available.return_value = True
+
+        # action-managed-upgrade=True
+        config.side_effect = [True]
+
+        openstack.do_action_openstack_upgrade('package-xyz',
+                                              do_openstack_upgrade,
+                                              None)
+
+        self.assertTrue(openstack_upgrade_available.called)
+        msg = ('success, upgrade completed.')
+        action_set.assert_called_with({'outcome': msg})
+        self.assertFalse(action_fail.called)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'action_set')
+    @patch.object(openstack, 'action_fail')
+    @patch.object(openstack, 'openstack_upgrade_available')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_openstack_upgrade_not_avail(self, config,
+                                         openstack_upgrade_available,
+                                         action_fail, action_set, log):
+        def do_openstack_upgrade(configs):
+            pass
+
+        openstack_upgrade_available.return_value = False
+
+        openstack.do_action_openstack_upgrade('package-xyz',
+                                              do_openstack_upgrade,
+                                              None)
+
+        self.assertTrue(openstack_upgrade_available.called)
+        msg = ('no upgrade available.')
+        action_set.assert_called_with({'outcome': msg})
+        self.assertFalse(action_fail.called)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'action_set')
+    @patch.object(openstack, 'action_fail')
+    @patch.object(openstack, 'openstack_upgrade_available')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_openstack_upgrade_config_false(self, config,
+                                            openstack_upgrade_available,
+                                            action_fail, action_set, log):
+        def do_openstack_upgrade(configs):
+            pass
+
+        openstack_upgrade_available.return_value = True
+
+        # action-managed-upgrade=False
+        config.side_effect = [False]
+
+        openstack.do_action_openstack_upgrade('package-xyz',
+                                              do_openstack_upgrade,
+                                              None)
+
+        self.assertTrue(openstack_upgrade_available.called)
+        msg = ('action-managed-upgrade config is False, skipped upgrade.')
+        action_set.assert_called_with({'outcome': msg})
+        self.assertFalse(action_fail.called)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'action_set')
+    @patch.object(openstack, 'action_fail')
+    @patch.object(openstack, 'openstack_upgrade_available')
+    @patch('traceback.format_exc')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_openstack_upgrade_traceback(self, config, traceback,
+                                         openstack_upgrade_available,
+                                         action_fail, action_set, log):
+        def do_openstack_upgrade(configs):
+            oops()  # noqa
+
+        openstack_upgrade_available.return_value = True
+
+        # action-managed-upgrade=False
+        config.side_effect = [True]
+
+        openstack.do_action_openstack_upgrade('package-xyz',
+                                              do_openstack_upgrade,
+                                              None)
+
+        self.assertTrue(openstack_upgrade_available.called)
+        msg = 'do_openstack_upgrade resulted in an unexpected error'
+        action_fail.assert_called_with(msg)
+        self.assertTrue(action_set.called)
+        self.assertTrue(traceback.called)
+
+    @patch.object(openstack, 'os_release')
+    @patch.object(openstack, 'application_version_set')
+    def test_os_application_version_set(self,
+                                        mock_application_version_set,
+                                        mock_os_release):
+        with patch.object(fetch, 'apt_cache') as cache:
+            cache.return_value = self._apt_cache()
+            mock_os_release.return_value = 'mitaka'
+            openstack.os_application_version_set('neutron-common')
+            mock_application_version_set.assert_called_with('7.0.1')
+            openstack.os_application_version_set('cinder-common')
+            mock_application_version_set.assert_called_with('mitaka')
+
+    @patch.object(openstack, 'valid_snap_channel')
+    @patch('charmhelpers.contrib.openstack.utils.config')
+    def test_snap_install_requested(self, config, valid_snap_channel):
+        valid_snap_channel.return_value = True
+        # Expect True
+        flush('snap_install_requested')
+        config.return_value = 'snap:ocata/edge'
+        self.assertTrue(openstack.snap_install_requested())
+        valid_snap_channel.assert_called_with('edge')
+        flush('snap_install_requested')
+        config.return_value = 'snap:pike'
+        self.assertTrue(openstack.snap_install_requested())
+        valid_snap_channel.assert_called_with('stable')
+        flush('snap_install_requested')
+        config.return_value = 'snap:pike/stable/jamespage'
+        self.assertTrue(openstack.snap_install_requested())
+        valid_snap_channel.assert_called_with('stable')
+        # Expect False
+        flush('snap_install_requested')
+        config.return_value = 'cloud:xenial-ocata'
+        self.assertFalse(openstack.snap_install_requested())
+
+    def test_get_snaps_install_info_from_origin(self):
+        snaps = ['os_project']
+        mode = 'jailmode'
+
+        # snap:track/channel
+        src = 'snap:ocata/beta'
+        expected = {snaps[0]: {'mode': mode,
+                               'channel': '--channel=ocata/beta'}}
+        self.assertEqual(
+            expected,
+            openstack.get_snaps_install_info_from_origin(snaps, src,
+                                                         mode=mode))
+
+        # snap:track/channel/branch
+        src = 'snap:ocata/beta/jamespage'
+        expected = {snaps[0]: {'mode': mode,
+                               'channel': '--channel=ocata/beta/jamespage'}}
+        self.assertEqual(
+            expected,
+            openstack.get_snaps_install_info_from_origin(snaps, src,
+                                                         mode=mode))
+        # snap:track
+        src = 'snap:pike'
+        expected = {snaps[0]: {'mode': mode,
+                               'channel': '--channel=pike'}}
+        self.assertEqual(
+            expected,
+            openstack.get_snaps_install_info_from_origin(snaps, src,
+                                                         mode=mode))
+
+    @patch.object(openstack, 'snap_install')
+    def test_install_os_snaps(self, mock_snap_install):
+        snaps = ['os_project']
+        mode = 'jailmode'
+
+        # snap:track/channel
+        src = 'snap:ocata/beta'
+        openstack.install_os_snaps(
+            openstack.get_snaps_install_info_from_origin(
+                snaps, src, mode=mode))
+        mock_snap_install.assert_called_with(
+            'os_project', '--channel=ocata/beta', '--jailmode')
+
+        # snap:track
+        src = 'snap:pike'
+        openstack.install_os_snaps(
+            openstack.get_snaps_install_info_from_origin(
+                snaps, src, mode=mode))
+        mock_snap_install.assert_called_with(
+            'os_project', '--channel=pike', '--jailmode')
+
+    @patch.object(openstack, 'set_unit_upgrading')
+    @patch.object(openstack, 'is_unit_paused_set')
+    def test_series_upgrade_prepare(
+            self, is_unit_paused_set, set_unit_upgrading):
+        is_unit_paused_set.return_value = False
+        fake_pause_helper = MagicMock()
+        fake_configs = MagicMock()
+        openstack.series_upgrade_prepare(fake_pause_helper, fake_configs)
+        set_unit_upgrading.assert_called_once()
+        fake_pause_helper.assert_called_once_with(fake_configs)
+
+    @patch.object(openstack, 'set_unit_upgrading')
+    @patch.object(openstack, 'is_unit_paused_set')
+    def test_series_upgrade_prepare_no_pause(
+            self, is_unit_paused_set, set_unit_upgrading):
+        is_unit_paused_set.return_value = True
+        fake_pause_helper = MagicMock()
+        fake_configs = MagicMock()
+        openstack.series_upgrade_prepare(fake_pause_helper, fake_configs)
+        set_unit_upgrading.assert_called_once()
+        fake_pause_helper.assert_not_called()
+
+    @patch.object(openstack, 'clear_unit_upgrading')
+    @patch.object(openstack, 'clear_unit_paused')
+    def test_series_upgrade_complete(
+            self, clear_unit_paused, clear_unit_upgrading):
+        fake_resume_helper = MagicMock()
+        fake_configs = MagicMock()
+        openstack.series_upgrade_complete(fake_resume_helper, fake_configs)
+        clear_unit_upgrading.assert_called_once()
+        clear_unit_paused.assert_called_once()
+        fake_configs.write_all.assert_called_once()
+        fake_resume_helper.assert_called_once_with(fake_configs)
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'leader_get')
+    def test_is_db_initialised(self, leader_get, juju_log):
+        leader_get.return_value = 'True'
+        self.assertTrue(openstack.is_db_initialised())
+        leader_get.return_value = 'False'
+        self.assertFalse(openstack.is_db_initialised())
+        leader_get.return_value = None
+        self.assertFalse(openstack.is_db_initialised())
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'leader_set')
+    def test_set_db_initialised(self, leader_set, juju_log):
+        openstack.set_db_initialised()
+        leader_set.assert_called_once_with({'db-initialised': True})
+
+    @patch.object(openstack, 'juju_log')
+    @patch.object(openstack, 'relation_ids')
+    @patch.object(openstack, 'related_units')
+    @patch.object(openstack, 'relation_get')
+    def test_is_db_maintenance_mode(self, relation_get, related_units,
+                                    relation_ids, juju_log):
+        relation_ids.return_value = ['rid:1']
+        related_units.return_value = ['unit/0', 'unit/2']
+        rsettings = {
+            'rid:1': {
+                'unit/0': {
+                    'private-ip': '1.2.3.4',
+                    'cluster-series-upgrading': 'True'},
+                'unit/2': {
+                    'private-ip': '1.2.3.5'}}}
+        relation_get.side_effect = lambda unit, rid: rsettings[rid][unit]
+        self.assertTrue(openstack.is_db_maintenance_mode())
+        rsettings = {
+            'rid:1': {
+                'unit/0': {
+                    'private-ip': '1.2.3.4'},
+                'unit/2': {
+                    'private-ip': '1.2.3.5'}}}
+        self.assertFalse(openstack.is_db_maintenance_mode())
+        rsettings = {
+            'rid:1': {
+                'unit/0': {
+                    'private-ip': '1.2.3.4',
+                    'cluster-series-upgrading': 'False'},
+                'unit/2': {
+                    'private-ip': '1.2.3.5'}}}
+        self.assertFalse(openstack.is_db_maintenance_mode())
+        rsettings = {
+            'rid:1': {
+                'unit/0': {
+                    'private-ip': '1.2.3.4',
+                    'cluster-series-upgrading': 'lskjfsd'},
+                'unit/2': {
+                    'private-ip': '1.2.3.5'}}}
+        self.assertFalse(openstack.is_db_maintenance_mode())
+
+    def test_get_endpoint_key(self):
+        self.assertEqual(
+            openstack.get_endpoint_key('placement', 'is:2', 'keystone/0'),
+            'placement-is_2-keystone_0')
+
+    @patch.object(openstack, 'relation_get')
+    @patch.object(openstack, 'related_units')
+    @patch.object(openstack, 'relation_ids')
+    def test_get_endpoint_notifications(self, relation_ids, related_units,
+                                        relation_get):
+        id_svc_rel_units = {
+            'identity-service:3': ['keystone/0', 'keystone/1', 'keystone/2']
+        }
+
+        def _related_units(relid):
+            return id_svc_rel_units[relid]
+
+        id_svc_rel_data = {
+            'keystone/0': {
+                'ep_changed': '{"placement": "d5c3"}'},
+            'keystone/1': {
+                'ep_changed': '{"nova": "4d06", "neutron": "2aa6"}'},
+            'keystone/2': {}}
+
+        def _relation_get(unit, rid, attribute):
+            return id_svc_rel_data[unit].get(attribute)
+
+        relation_ids.return_value = id_svc_rel_units.keys()
+        related_units.side_effect = _related_units
+        relation_get.side_effect = _relation_get
+        self.assertEqual(
+            openstack.get_endpoint_notifications(['neutron']),
+            {
+                'neutron-identity-service_3-keystone_1': '2aa6'})
+        self.assertEqual(
+            openstack.get_endpoint_notifications(['placement', 'neutron']),
+            {
+                'neutron-identity-service_3-keystone_1': '2aa6',
+                'placement-identity-service_3-keystone_0': 'd5c3'})
+
+    @patch.object(openstack, 'get_endpoint_notifications')
+    @patch.object(openstack.unitdata, 'HookData')
+    def test_endpoint_changed(self, HookData, get_endpoint_notifications):
+        self.kv_data = {}
+
+        def _kv_get(key):
+            return self.kv_data.get(key)
+        kv = self._unit_paused_helper(HookData)
+        kv.get.side_effect = _kv_get
+        # Check endpoint_changed returns True when there are new notifications.
+        get_endpoint_notifications.return_value = {
+            'neutron-identity-service_3-keystone_1': '2aa6',
+            'placement-identity-service_3-keystone_0': 'd5c3'}
+        self.assertTrue(openstack.endpoint_changed('placement'))
+        # Check endpoint_changed returns False when there are new
+        # notifications but they are not the ones being looked for.
+        self.assertTrue(openstack.endpoint_changed('nova'))
+        # Check endpoint_changed returns False if the notification
+        # has alredy been seen
+        get_endpoint_notifications.return_value = {
+            'placement-identity-service_3-keystone_0': 'd5c3'}
+        self.kv_data = {
+            'placement-identity-service_3-keystone_0': 'd5c3'}
+        self.assertFalse(openstack.endpoint_changed('placement'))
+
+    @patch.object(openstack, 'get_endpoint_notifications')
+    @patch.object(openstack.unitdata, 'HookData')
+    def test_save_endpoint_changed_triggers(self, HookData,
+                                            get_endpoint_notifications):
+        kv = self._unit_paused_helper(HookData)
+        get_endpoint_notifications.return_value = {
+            'neutron-identity-service_3-keystone_1': '2aa6',
+            'placement-identity-service_3-keystone_0': 'd5c3'}
+        openstack.save_endpoint_changed_triggers(['neutron', 'placement'])
+        kv_set_calls = [
+            call('neutron-identity-service_3-keystone_1', '2aa6'),
+            call('placement-identity-service_3-keystone_0', 'd5c3')]
+        kv.set.assert_has_calls(kv_set_calls, any_order=True)
+
+
+class OpenStackUtilsAdditionalTests(TestCase):
+    SHARED_DB_RELATIONS = {
+        'shared-db:8': {
+            'mysql-svc1/0': {
+                'allowed_units': 'client/0',
+            },
+            'mysql-svc1/1': {},
+            'mysql-svc1/2': {
+                'allowed_units': 'client/0 client/1',
+            },
+        },
+        'shared-db:12': {
+            'mysql-svc2/0': {
+                'allowed_units': 'client/1',
+            },
+            'mysql-svc2/1': {
+                'allowed_units': 'client/3',
+            },
+            'mysql-svc2/2': {
+                'allowed_units': {},
+            },
+        }
+    }
+    SCALE_RELATIONS = {
+        'cluster:2': {
+            'keystone/1': {},
+            'keystone/2': {}},
+        'shared-db:12': {
+            'mysql-svc2/0': {
+                'allowed_units': 'client/1',
+            },
+            'mysql-svc2/1': {
+                'allowed_units': 'client/3',
+            },
+            'mysql-svc2/2': {
+                'allowed_units': {},
+            }},
+    }
+    SCALE_RELATIONS_HA = {
+        'cluster:2': {
+            'keystone/1': {'unit-state-keystone-1': 'READY'},
+            'keystone/2': {}},
+        'shared-db:12': {
+            'mysql-svc2/0': {
+                'allowed_units': 'client/1',
+            },
+            'mysql-svc2/1': {
+                'allowed_units': 'client/3',
+            },
+            'mysql-svc2/2': {
+                'allowed_units': {},
+            }},
+        'ha:32': {
+            'hacluster-keystone/1': {}}
+    }
+    All_PEERS_READY = {
+        'cluster:2': {
+            'keystone/1': {'unit-state-keystone-1': 'READY'},
+            'keystone/2': {'unit-state-keystone-2': 'READY'}}}
+    PEERS_NOT_READY = {
+        'cluster:2': {
+            'keystone/1': {'unit-state-keystone-1': 'READY'},
+            'keystone/2': {}}}
+
+    def setUp(self):
+        super(OpenStackUtilsAdditionalTests, self).setUp()
+        [self._patch(m) for m in [
+            'expect_ha',
+            'expected_peer_units',
+            'expected_related_units',
+            'juju_log',
+            'metadata',
+            'related_units',
+            'relation_get',
+            'relation_id',
+            'relation_ids',
+            'relation_set',
+            'local_unit',
+        ]]
+
+    def _patch(self, method):
+        _m = patch.object(openstack, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def setup_relation(self, relation_map):
+        relation = FakeRelation(relation_map)
+        self.relation_id.side_effect = relation.relation_id
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.related_units
+        return relation
+
+    def test_is_db_ready(self):
+        relation = self.setup_relation(self.SHARED_DB_RELATIONS)
+
+        # Check unit allowed in 1st relation
+        self.local_unit.return_value = 'client/0'
+        self.assertTrue(openstack.is_db_ready())
+
+        # Check unit allowed in 2nd relation
+        self.local_unit.return_value = 'client/3'
+        self.assertTrue(openstack.is_db_ready())
+
+        # Check unit not allowed in any list
+        self.local_unit.return_value = 'client/5'
+        self.assertFalse(openstack.is_db_ready())
+
+        # Check call with an invalid relation
+        self.local_unit.return_value = 'client/3'
+        # None returned if not in a relation context (eg update-status)
+        relation.clear_relation_context()
+        self.assertRaises(
+            Exception,
+            openstack.is_db_ready,
+            use_current_context=True)
+
+        # Check unit allowed using current relation context
+        relation.set_relation_context('mysql-svc2/0', 'shared-db:12')
+        self.local_unit.return_value = 'client/1'
+        self.assertTrue(openstack.is_db_ready(use_current_context=True))
+
+        # Check unit not allowed using current relation context
+        relation.set_relation_context('mysql-svc2/0', 'shared-db:12')
+        self.local_unit.return_value = 'client/0'
+        self.assertFalse(openstack.is_db_ready(use_current_context=True))
+
+    @patch.object(openstack, 'container_scoped_relations')
+    def test_is_expected_scale_noha(self, container_scoped_relations):
+        self.setup_relation(self.SCALE_RELATIONS)
+        self.expect_ha.return_value = False
+        eru = {
+            'shared-db': ['mysql/0', 'mysql/1', 'mysql/2']}
+
+        def _expected_related_units(reltype):
+            return eru[reltype]
+        self.expected_related_units.side_effect = _expected_related_units
+        container_scoped_relations.return_value = ['ha', 'domain-backend']
+
+        # All peer and db units are present
+        self.expected_peer_units.return_value = ['keystone/0', 'keystone/2']
+        self.assertTrue(openstack.is_expected_scale())
+
+        # db units are present but a peer is missing
+        self.expected_peer_units.return_value = ['keystone/0', 'keystone/2', 'keystone/3']
+        self.assertFalse(openstack.is_expected_scale())
+
+        # peer units are present but a db unit is missing
+        eru['shared-db'].append('mysql/3')
+        self.expected_peer_units.return_value = ['keystone/0', 'keystone/2']
+        self.assertFalse(openstack.is_expected_scale())
+        eru['shared-db'].remove('mysql/3')
+
+        # Expect ha but ha unit is missing
+        self.expect_ha.return_value = True
+        self.expected_peer_units.return_value = ['keystone/0', 'keystone/2']
+        self.assertFalse(openstack.is_expected_scale())
+
+    @patch.object(openstack, 'container_scoped_relations')
+    def test_is_expected_scale_ha(self, container_scoped_relations):
+        self.setup_relation(self.SCALE_RELATIONS_HA)
+        eru = {
+            'shared-db': ['mysql/0', 'mysql/1', 'mysql/2']}
+
+        def _expected_related_units(reltype):
+            return eru[reltype]
+        self.expected_related_units.side_effect = _expected_related_units
+        container_scoped_relations.return_value = ['ha', 'domain-backend']
+        self.expect_ha.return_value = True
+        self.expected_peer_units.return_value = ['keystone/0', 'keystone/2']
+        self.assertTrue(openstack.is_expected_scale())
+
+    def test_container_scoped_relations(self):
+        _metadata = {
+            'provides': {
+                'amqp': {'interface': 'rabbitmq'},
+                'identity-service': {'interface': 'keystone'},
+                'ha': {
+                    'interface': 'hacluster',
+                    'scope': 'container'}},
+            'peers': {
+                'cluster': {'interface': 'openstack-ha'}}}
+        self.metadata.return_value = _metadata
+        self.assertEqual(openstack.container_scoped_relations(), ['ha'])
+
+    def test_get_peer_key(self):
+        self.assertEqual(
+            openstack.get_peer_key('cinder/0'),
+            'unit-state-cinder-0')
+
+    def test_inform_peers_unit_state(self):
+        self.local_unit.return_value = 'client/0'
+        self.setup_relation(self.All_PEERS_READY)
+        openstack.inform_peers_unit_state('READY')
+        self.relation_set.assert_called_once_with(
+            relation_id='cluster:2',
+            relation_settings={'unit-state-client-0': 'READY'})
+
+    def test_get_peers_unit_state(self):
+        self.setup_relation(self.All_PEERS_READY)
+        self.assertEqual(
+            openstack.get_peers_unit_state(),
+            {'keystone/1': 'READY', 'keystone/2': 'READY'})
+        self.setup_relation(self.PEERS_NOT_READY)
+        self.assertEqual(
+            openstack.get_peers_unit_state(),
+            {'keystone/1': 'READY', 'keystone/2': 'UNKNOWN'})
+
+    def test_are_peers_ready(self):
+        self.setup_relation(self.All_PEERS_READY)
+        self.assertTrue(openstack.are_peers_ready())
+        self.setup_relation(self.PEERS_NOT_READY)
+        self.assertFalse(openstack.are_peers_ready())
+
+    @patch.object(openstack, 'inform_peers_unit_state')
+    def test_inform_peers_if_ready(self, inform_peers_unit_state):
+        self.setup_relation(self.All_PEERS_READY)
+
+        def _not_ready():
+            return False, "Its all gone wrong"
+
+        def _ready():
+            return True, "Hurray!"
+        openstack.inform_peers_if_ready(_not_ready)
+        inform_peers_unit_state.assert_called_once_with('NOTREADY', 'cluster')
+        inform_peers_unit_state.reset_mock()
+        openstack.inform_peers_if_ready(_ready)
+        inform_peers_unit_state.assert_called_once_with('READY', 'cluster')
+
+    @patch.object(openstack, 'is_expected_scale')
+    @patch.object(openstack, 'is_db_initialised')
+    @patch.object(openstack, 'is_db_ready')
+    @patch.object(openstack, 'is_unit_paused_set')
+    @patch.object(openstack, 'is_db_maintenance_mode')
+    def test_check_api_unit_ready(self, is_db_maintenance_mode,
+                                  is_unit_paused_set, is_db_ready,
+                                  is_db_initialised, is_expected_scale):
+        is_db_maintenance_mode.return_value = True
+        self.assertFalse(openstack.check_api_unit_ready()[0])
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = True
+        self.assertFalse(openstack.check_api_unit_ready()[0])
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = False
+        self.assertFalse(openstack.check_api_unit_ready()[0])
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = False
+        self.assertFalse(openstack.check_api_unit_ready()[0])
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = True
+        is_expected_scale.return_value = False
+        self.assertFalse(openstack.check_api_unit_ready()[0])
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = True
+        is_expected_scale.return_value = True
+        self.assertTrue(openstack.check_api_unit_ready()[0])
+
+    @patch.object(openstack, 'is_expected_scale')
+    @patch.object(openstack, 'is_db_initialised')
+    @patch.object(openstack, 'is_db_ready')
+    @patch.object(openstack, 'is_unit_paused_set')
+    @patch.object(openstack, 'is_db_maintenance_mode')
+    def test_get_api_unit_status(self, is_db_maintenance_mode,
+                                 is_unit_paused_set, is_db_ready,
+                                 is_db_initialised, is_expected_scale):
+        is_db_maintenance_mode.return_value = True
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'maintenance')
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = True
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'blocked')
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = False
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'waiting')
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = False
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'waiting')
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = True
+        is_expected_scale.return_value = False
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'waiting')
+
+        is_db_maintenance_mode.return_value = False
+        is_unit_paused_set.return_value = False
+        is_db_ready.return_value = True
+        is_db_initialised.return_value = True
+        is_expected_scale.return_value = True
+        self.assertEqual(
+            openstack.get_api_unit_status()[0].value,
+            'active')
+
+    @patch.object(openstack, 'get_api_unit_status')
+    def test_check_api_application_ready(self, get_api_unit_status):
+        get_api_unit_status.return_value = (WORKLOAD_STATES.ACTIVE, 'Hurray')
+        self.assertTrue(openstack.check_api_application_ready()[0])
+        get_api_unit_status.return_value = (WORKLOAD_STATES.BLOCKED, ':-(')
+        self.assertFalse(openstack.check_api_application_ready()[0])
+
+    @patch.object(openstack, 'get_api_unit_status')
+    def test_get_api_application_status(self, get_api_unit_status):
+        get_api_unit_status.return_value = (WORKLOAD_STATES.ACTIVE, 'Hurray')
+        self.assertEqual(
+            openstack.get_api_application_status()[0].value,
+            'active')
+        get_api_unit_status.return_value = (WORKLOAD_STATES.BLOCKED, ':-(')
+        self.assertEqual(
+            openstack.get_api_application_status()[0].value,
+            'blocked')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_contexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_contexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..6edd66a4061f5d6bb8cba47d3eb486870783135a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_contexts.py
@@ -0,0 +1,4842 @@
+import collections
+import copy
+import json
+import mock
+import six
+import unittest
+import yaml
+
+from mock import (
+    patch,
+    Mock,
+    MagicMock,
+    call
+)
+
+from tests.helpers import patch_open
+
+import tests.utils
+
+import charmhelpers.contrib.openstack.context as context
+
+
+if not six.PY3:
+    open_builtin = '__builtin__.open'
+else:
+    open_builtin = 'builtins.open'
+
+
+class FakeRelation(object):
+
+    '''
+    A fake relation class. Lets tests specify simple relation data
+    for a default relation + unit (foo:0, foo/0, set in setUp()), eg:
+
+        rel = {
+            'private-address': 'foo',
+            'password': 'passwd',
+        }
+        relation = FakeRelation(rel)
+        self.relation_get.side_effect = relation.get
+        passwd = self.relation_get('password')
+
+    or more complex relations meant to be addressed by explicit relation id
+    + unit id combos:
+
+        rel = {
+            'mysql:0': {
+                'mysql/0': {
+                    'private-address': 'foo',
+                    'password': 'passwd',
+                }
+            }
+        }
+        relation = FakeRelation(rel)
+        self.relation_get.side_affect = relation.get
+        passwd = self.relation_get('password', rid='mysql:0', unit='mysql/0')
+    '''
+
+    def __init__(self, relation_data):
+        self.relation_data = relation_data
+
+    def get(self, attribute=None, unit=None, rid=None):
+        if not rid or rid == 'foo:0':
+            if attribute is None:
+                return self.relation_data
+            elif attribute in self.relation_data:
+                return self.relation_data[attribute]
+            return None
+        else:
+            if rid not in self.relation_data:
+                return None
+            try:
+                relation = self.relation_data[rid][unit]
+            except KeyError:
+                return None
+            if attribute is None:
+                return relation
+            if attribute in relation:
+                return relation[attribute]
+            return None
+
+    def relation_ids(self, relation):
+        rids = []
+        for rid in sorted(self.relation_data.keys()):
+            if relation + ':' in rid:
+                rids.append(rid)
+        return rids
+
+    def relation_units(self, relation_id):
+        if relation_id not in self.relation_data:
+            return None
+        return sorted(self.relation_data[relation_id].keys())
+
+
+SHARED_DB_RELATION = {
+    'db_host': 'dbserver.local',
+    'password': 'foo'
+}
+
+SHARED_DB_RELATION_W_PORT = {
+    'db_host': 'dbserver.local',
+    'password': 'foo',
+    'db_port': 3306,
+}
+
+SHARED_DB_RELATION_ALT_RID = {
+    'mysql-alt:0': {
+        'mysql-alt/0': {
+            'db_host': 'dbserver-alt.local',
+            'password': 'flump'}}}
+
+SHARED_DB_RELATION_SSL = {
+    'db_host': 'dbserver.local',
+    'password': 'foo',
+    'ssl_ca': 'Zm9vCg==',
+    'ssl_cert': 'YmFyCg==',
+    'ssl_key': 'Zm9vYmFyCg==',
+}
+
+SHARED_DB_CONFIG = {
+    'database-user': 'adam',
+    'database': 'foodb',
+}
+
+SHARED_DB_RELATION_NAMESPACED = {
+    'db_host': 'bar',
+    'quantum_password': 'bar2'
+}
+
+SHARED_DB_RELATION_ACCESS_NETWORK = {
+    'db_host': 'dbserver.local',
+    'password': 'foo',
+    'access-network': '10.5.5.0/24',
+    'hostname': 'bar',
+}
+
+
+IDENTITY_SERVICE_RELATION_HTTP = {
+    'service_port': '5000',
+    'service_host': 'keystonehost.local',
+    'auth_host': 'keystone-host.local',
+    'auth_port': '35357',
+    'service_domain': 'admin_domain',
+    'service_tenant': 'admin',
+    'service_tenant_id': '123456',
+    'service_password': 'foo',
+    'service_username': 'adam',
+    'service_protocol': 'http',
+    'auth_protocol': 'http',
+}
+
+IDENTITY_SERVICE_RELATION_UNSET = {
+    'service_port': '5000',
+    'service_host': 'keystonehost.local',
+    'auth_host': 'keystone-host.local',
+    'auth_port': '35357',
+    'service_domain': 'admin_domain',
+    'service_tenant': 'admin',
+    'service_password': 'foo',
+    'service_username': 'adam',
+}
+
+IDENTITY_CREDENTIALS_RELATION_UNSET = {
+    'credentials_port': '5000',
+    'credentials_host': 'keystonehost.local',
+    'auth_host': 'keystone-host.local',
+    'auth_port': '35357',
+    'auth_protocol': 'https',
+    'domain': 'admin_domain',
+    'credentials_project': 'admin',
+    'credentials_project_id': '123456',
+    'credentials_password': 'foo',
+    'credentials_username': 'adam',
+    'credentials_protocol': 'https',
+}
+
+
+APIIDENTITY_SERVICE_RELATION_UNSET = {
+    'neutron-plugin-api:0': {
+        'neutron-api/0': {
+            'service_port': '5000',
+            'service_host': 'keystonehost.local',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'service_domain': 'admin_domain',
+            'service_tenant': 'admin',
+            'service_password': 'foo',
+            'service_username': 'adam',
+        }
+    }
+}
+
+IDENTITY_SERVICE_RELATION_HTTPS = {
+    'service_port': '5000',
+    'service_host': 'keystonehost.local',
+    'auth_host': 'keystone-host.local',
+    'auth_port': '35357',
+    'service_domain': 'admin_domain',
+    'service_tenant': 'admin',
+    'service_password': 'foo',
+    'service_username': 'adam',
+    'service_protocol': 'https',
+    'auth_protocol': 'https',
+}
+
+IDENTITY_SERVICE_RELATION_VERSIONED = {
+    'api_version': '3',
+    'service_tenant_id': 'svc-proj-id',
+    'service_domain_id': 'svc-dom-id',
+}
+IDENTITY_SERVICE_RELATION_VERSIONED.update(IDENTITY_SERVICE_RELATION_HTTPS)
+
+IDENTITY_CREDENTIALS_RELATION_VERSIONED = {
+    'api_version': '3',
+    'service_tenant_id': 'svc-proj-id',
+    'service_domain_id': 'svc-dom-id',
+}
+IDENTITY_CREDENTIALS_RELATION_VERSIONED.update(IDENTITY_CREDENTIALS_RELATION_UNSET)
+
+POSTGRESQL_DB_RELATION = {
+    'host': 'dbserver.local',
+    'user': 'adam',
+    'password': 'foo',
+}
+
+POSTGRESQL_DB_CONFIG = {
+    'database': 'foodb',
+}
+
+IDENTITY_SERVICE_RELATION = {
+    'service_port': '5000',
+    'service_host': 'keystonehost.local',
+    'auth_host': 'keystone-host.local',
+    'auth_port': '35357',
+    'service_domain': 'admin_domain',
+    'service_tenant': 'admin',
+    'service_password': 'foo',
+    'service_username': 'adam',
+}
+
+AMQP_RELATION = {
+    'private-address': 'rabbithost',
+    'password': 'foobar',
+    'vip': '10.0.0.1',
+}
+
+AMQP_RELATION_ALT_RID = {
+    'amqp-alt:0': {
+        'rabbitmq-alt/0': {
+            'private-address': 'rabbitalthost1',
+            'password': 'flump',
+        },
+    }
+}
+
+AMQP_RELATION_WITH_SSL = {
+    'private-address': 'rabbithost',
+    'password': 'foobar',
+    'vip': '10.0.0.1',
+    'ssl_port': 5671,
+    'ssl_ca': 'cert',
+    'ha_queues': 'queues',
+}
+
+AMQP_AA_RELATION = {
+    'amqp:0': {
+        'rabbitmq/0': {
+            'private-address': 'rabbithost1',
+            'password': 'foobar',
+        },
+        'rabbitmq/1': {
+            'private-address': 'rabbithost2',
+            'password': 'foobar',
+        },
+        'rabbitmq/2': {  # Should be ignored because password is missing.
+            'private-address': 'rabbithost3',
+        }
+    }
+}
+
+AMQP_CONFIG = {
+    'rabbit-user': 'adam',
+    'rabbit-vhost': 'foo',
+}
+
+AMQP_OSLO_CONFIG = {
+    'oslo-messaging-flags': ("rabbit_max_retries=1"
+                             ",rabbit_retry_backoff=1"
+                             ",rabbit_retry_interval=1"),
+    'oslo-messaging-driver': 'log'
+}
+
+AMQP_NOTIFICATION_FORMAT = {
+    'notification-format': 'both'
+}
+
+AMQP_NOTIFICATION_TOPICS = {
+    'notification-topics': 'foo,bar'
+}
+
+AMQP_NOTIFICATIONS_LOGS = {
+    'send-notifications-to-logs': True
+}
+
+AMQP_NOVA_CONFIG = {
+    'nova-rabbit-user': 'adam',
+    'nova-rabbit-vhost': 'foo',
+}
+
+HAPROXY_CONFIG = {
+    'haproxy-server-timeout': 50000,
+    'haproxy-client-timeout': 50000,
+}
+
+CEPH_RELATION = {
+    'ceph:0': {
+        'ceph/0': {
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true'
+        },
+        'ceph/1': {
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'false'
+        },
+    }
+}
+
+CEPH_RELATION_WITH_PUBLIC_ADDR = {
+    'ceph:0': {
+        'ceph/0': {
+            'ceph-public-address': '192.168.1.10',
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+        'ceph/1': {
+            'ceph-public-address': '192.168.1.11',
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+    }
+}
+
+CEPH_REL_WITH_PUBLIC_ADDR_PORT = {
+    'ceph:0': {
+        'ceph/0': {
+            'ceph-public-address': '192.168.1.10:1234',
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+        'ceph/1': {
+            'ceph-public-address': '192.168.1.11:4321',
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+    }
+}
+
+CEPH_REL_WITH_PUBLIC_IPv6_ADDR = {
+    'ceph:0': {
+        'ceph/0': {
+            'ceph-public-address': '2001:5c0:9168::1',
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+        'ceph/1': {
+            'ceph-public-address': '2001:5c0:9168::2',
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+    }
+}
+
+CEPH_REL_WITH_PUBLIC_IPv6_ADDR_PORT = {
+    'ceph:0': {
+        'ceph/0': {
+            'ceph-public-address': '[2001:5c0:9168::1]:1234',
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+        'ceph/1': {
+            'ceph-public-address': '[2001:5c0:9168::2]:4321',
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+    }
+}
+
+CEPH_REL_WITH_MULTI_PUBLIC_ADDR = {
+    'ceph:0': {
+        'ceph/0': {
+            'ceph-public-address': '192.168.1.10 192.168.1.20',
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+        'ceph/1': {
+            'ceph-public-address': '192.168.1.11 192.168.1.21',
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar'
+        },
+    }
+}
+
+CEPH_REL_WITH_DEFAULT_FEATURES = {
+    'ceph:0': {
+        'ceph/0': {
+            'private-address': 'ceph_node1',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+            'rbd-features': '1'
+        },
+        'ceph/1': {
+            'private-address': 'ceph_node2',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'false',
+            'rbd-features': '1'
+        },
+    }
+}
+
+
+IDENTITY_RELATION_NO_CERT = {
+    'identity-service:0': {
+        'keystone/0': {
+            'private-address': 'keystone1',
+        },
+    }
+}
+
+IDENTITY_RELATION_SINGLE_CERT = {
+    'identity-service:0': {
+        'keystone/0': {
+            'private-address': 'keystone1',
+            'ssl_cert_cinderhost1': 'certa',
+            'ssl_key_cinderhost1': 'keya',
+        },
+    }
+}
+
+IDENTITY_RELATION_MULTIPLE_CERT = {
+    'identity-service:0': {
+        'keystone/0': {
+            'private-address': 'keystone1',
+            'ssl_cert_cinderhost1-int-network': 'certa',
+            'ssl_key_cinderhost1-int-network': 'keya',
+            'ssl_cert_cinderhost1-pub-network': 'certa',
+            'ssl_key_cinderhost1-pub-network': 'keya',
+            'ssl_cert_cinderhost1-adm-network': 'certa',
+            'ssl_key_cinderhost1-adm-network': 'keya',
+        },
+    }
+}
+
+QUANTUM_NETWORK_SERVICE_RELATION = {
+    'quantum-network-service:0': {
+        'unit/0': {
+            'keystone_host': '10.5.0.1',
+            'service_port': '5000',
+            'auth_port': '20000',
+            'service_tenant': 'tenant',
+            'service_username': 'username',
+            'service_password': 'password',
+            'quantum_host': '10.5.0.2',
+            'quantum_port': '9696',
+            'quantum_url': 'http://10.5.0.2:9696/v2',
+            'region': 'aregion'
+        },
+    }
+}
+
+QUANTUM_NETWORK_SERVICE_RELATION_VERSIONED = {
+    'quantum-network-service:0': {
+        'unit/0': {
+            'keystone_host': '10.5.0.1',
+            'service_port': '5000',
+            'auth_port': '20000',
+            'service_tenant': 'tenant',
+            'service_username': 'username',
+            'service_password': 'password',
+            'quantum_host': '10.5.0.2',
+            'quantum_port': '9696',
+            'quantum_url': 'http://10.5.0.2:9696/v2',
+            'region': 'aregion',
+            'api_version': '3',
+        },
+    }
+}
+
+SUB_CONFIG = """
+nova:
+    /etc/nova/nova.conf:
+        sections:
+            DEFAULT:
+                - [nova-key1, value1]
+                - [nova-key2, value2]
+glance:
+    /etc/glance/glance.conf:
+        sections:
+            DEFAULT:
+                - [glance-key1, value1]
+                - [glance-key2, value2]
+"""
+
+NOVA_SUB_CONFIG1 = """
+nova:
+    /etc/nova/nova.conf:
+        sections:
+            DEFAULT:
+                - [nova-key1, value1]
+                - [nova-key2, value2]
+"""
+
+
+NOVA_SUB_CONFIG2 = """
+nova-compute:
+    /etc/nova/nova.conf:
+        sections:
+            DEFAULT:
+                - [nova-key3, value3]
+                - [nova-key4, value4]
+"""
+
+NOVA_SUB_CONFIG3 = """
+nova-compute:
+    /etc/nova/nova.conf:
+        sections:
+            DEFAULT:
+                - [nova-key5, value5]
+                - [nova-key6, value6]
+"""
+
+CINDER_SUB_CONFIG1 = """
+cinder:
+    /etc/cinder/cinder.conf:
+        sections:
+            cinder-1-section:
+                - [key1, value1]
+"""
+
+CINDER_SUB_CONFIG2 = """
+cinder:
+    /etc/cinder/cinder.conf:
+        sections:
+            cinder-2-section:
+                - [key2, value2]
+        not-a-section:
+            1234
+"""
+
+SUB_CONFIG_RELATION = {
+    'nova-subordinate:0': {
+        'nova-subordinate/0': {
+            'private-address': 'nova_node1',
+            'subordinate_configuration': json.dumps(yaml.safe_load(SUB_CONFIG)),
+        },
+    },
+    'glance-subordinate:0': {
+        'glance-subordinate/0': {
+            'private-address': 'glance_node1',
+            'subordinate_configuration': json.dumps(yaml.safe_load(SUB_CONFIG)),
+        },
+    },
+    'foo-subordinate:0': {
+        'foo-subordinate/0': {
+            'private-address': 'foo_node1',
+            'subordinate_configuration': 'ea8e09324jkadsfh',
+        },
+    },
+    'cinder-subordinate:0': {
+        'cinder-subordinate/0': {
+            'private-address': 'cinder_node1',
+            'subordinate_configuration': json.dumps(
+                yaml.safe_load(CINDER_SUB_CONFIG1)),
+        },
+    },
+    'cinder-subordinate:1': {
+        'cinder-subordinate/1': {
+            'private-address': 'cinder_node1',
+            'subordinate_configuration': json.dumps(
+                yaml.safe_load(CINDER_SUB_CONFIG2)),
+        },
+    },
+}
+
+SUB_CONFIG_RELATION2 = {
+    'nova-ceilometer:6': {
+        'ceilometer-agent/0': {
+            'private-address': 'nova_node1',
+            'subordinate_configuration': json.dumps(
+                yaml.safe_load(NOVA_SUB_CONFIG1)),
+        },
+    },
+    'neutron-plugin:3': {
+        'neutron-ovs-plugin/0': {
+            'private-address': 'nova_node1',
+            'subordinate_configuration': json.dumps(
+                yaml.safe_load(NOVA_SUB_CONFIG2)),
+        },
+    },
+    'neutron-plugin:4': {
+        'neutron-other-plugin/0': {
+            'private-address': 'nova_node1',
+            'subordinate_configuration': json.dumps(
+                yaml.safe_load(NOVA_SUB_CONFIG3)),
+        },
+    }
+}
+
+NONET_CONFIG = {
+    'vip': 'cinderhost1vip',
+    'os-internal-network': None,
+    'os-admin-network': None,
+    'os-public-network': None
+}
+
+FULLNET_CONFIG = {
+    'vip': '10.5.1.1 10.5.2.1 10.5.3.1',
+    'os-internal-network': "10.5.1.0/24",
+    'os-admin-network': "10.5.2.0/24",
+    'os-public-network': "10.5.3.0/24"
+}
+
+MACHINE_MACS = {
+    'eth0': 'fe:c5:ce:8e:2b:00',
+    'eth1': 'fe:c5:ce:8e:2b:01',
+    'eth2': 'fe:c5:ce:8e:2b:02',
+    'eth3': 'fe:c5:ce:8e:2b:03',
+}
+
+MACHINE_NICS = {
+    'eth0': ['192.168.0.1'],
+    'eth1': ['192.168.0.2'],
+    'eth2': [],
+    'eth3': [],
+}
+
+ABSENT_MACS = "aa:a5:ae:ae:ab:a4 "
+
+# Imported in contexts.py and needs patching in setUp()
+TO_PATCH = [
+    'b64decode',
+    'check_call',
+    'get_cert',
+    'get_ca_cert',
+    'install_ca_cert',
+    'log',
+    'config',
+    'relation_get',
+    'relation_ids',
+    'related_units',
+    'is_relation_made',
+    'relation_set',
+    'unit_get',
+    'https',
+    'determine_api_port',
+    'determine_apache_port',
+    'is_clustered',
+    'time',
+    'https',
+    'get_address_in_network',
+    'get_netmask_for_address',
+    'local_unit',
+    'get_ipv6_addr',
+    'mkdir',
+    'write_file',
+    'get_relation_ip',
+    'charm_name',
+    'sysctl_create',
+    'kv',
+    'pwgen',
+    'lsb_release',
+    'is_container',
+    'network_get_primary_address',
+    'resolve_address',
+    'is_ipv6_disabled',
+]
+
+
+class fake_config(object):
+
+    def __init__(self, data):
+        self.data = data
+
+    def __call__(self, attr):
+        if attr in self.data:
+            return self.data[attr]
+        return None
+
+
+class fake_is_relation_made():
+    def __init__(self, relations):
+        self.relations = relations
+
+    def rel_made(self, relation):
+        return self.relations[relation]
+
+
+class TestDB(object):
+    '''Test KV store for unitdata testing'''
+    def __init__(self):
+        self.data = {}
+        self.flushed = False
+
+    def get(self, key, default=None):
+        return self.data.get(key, default)
+
+    def set(self, key, value):
+        self.data[key] = value
+        return value
+
+    def flush(self):
+        self.flushed = True
+
+
+class ContextTests(unittest.TestCase):
+
+    def setUp(self):
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+        # mock at least a single relation + unit
+        self.relation_ids.return_value = ['foo:0']
+        self.related_units.return_value = ['foo/0']
+        self.local_unit.return_value = 'localunit'
+        self.kv.side_effect = TestDB
+        self.pwgen.return_value = 'testpassword'
+        self.lsb_release.return_value = {'DISTRIB_RELEASE': '16.04'}
+        self.is_container.return_value = False
+        self.network_get_primary_address.side_effect = NotImplementedError()
+        self.resolve_address.return_value = '10.5.1.50'
+        self.maxDiff = None
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.openstack.context.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_base_class_not_implemented(self):
+        base = context.OSContextGenerator()
+        self.assertRaises(NotImplementedError, base)
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_data(self, os_codename):
+        '''Test shared-db context with all required data'''
+        os_codename.return_value = 'queens'
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.get_address_in_network.return_value = ''
+        self.config.side_effect = fake_config(SHARED_DB_CONFIG)
+        shared_db = context.SharedDBContext()
+        result = shared_db()
+        expected = {
+            'database_host': 'dbserver.local',
+            'database': 'foodb',
+            'database_user': 'adam',
+            'database_password': 'foo',
+            'database_type': 'mysql+pymysql',
+        }
+        self.assertEquals(result, expected)
+
+    def test_shared_db_context_with_data_and_access_net_mismatch(self):
+        """Mismatch between hostname and hostname for access net - defers
+        execution"""
+        relation = FakeRelation(
+            relation_data=SHARED_DB_RELATION_ACCESS_NETWORK)
+        self.relation_get.side_effect = relation.get
+        self.get_address_in_network.return_value = '10.5.5.1'
+        self.config.side_effect = fake_config(SHARED_DB_CONFIG)
+        shared_db = context.SharedDBContext()
+        result = shared_db()
+        self.assertEquals(result, None)
+        self.relation_set.assert_called_with(
+            relation_settings={
+                'hostname': '10.5.5.1'})
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_data_and_access_net_match(self,
+                                                              os_codename):
+        """Correctly set hostname for access net returns complete context"""
+        os_codename.return_value = 'queens'
+        relation = FakeRelation(
+            relation_data=SHARED_DB_RELATION_ACCESS_NETWORK)
+        self.relation_get.side_effect = relation.get
+        self.get_address_in_network.return_value = 'bar'
+        self.config.side_effect = fake_config(SHARED_DB_CONFIG)
+        shared_db = context.SharedDBContext()
+        result = shared_db()
+        expected = {
+            'database_host': 'dbserver.local',
+            'database': 'foodb',
+            'database_user': 'adam',
+            'database_password': 'foo',
+            'database_type': 'mysql+pymysql',
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_explicit_relation_id(self, os_codename):
+        '''Test shared-db context setting the relation_id'''
+        os_codename.return_value = 'queens'
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION_ALT_RID)
+        self.related_units.return_value = ['mysql-alt/0']
+        self.relation_get.side_effect = relation.get
+        self.get_address_in_network.return_value = ''
+        self.config.side_effect = fake_config(SHARED_DB_CONFIG)
+        shared_db = context.SharedDBContext(relation_id='mysql-alt:0')
+        result = shared_db()
+        expected = {
+            'database_host': 'dbserver-alt.local',
+            'database': 'foodb',
+            'database_user': 'adam',
+            'database_password': 'flump',
+            'database_type': 'mysql+pymysql',
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_port(self, os_codename):
+        '''Test shared-db context with all required data'''
+        os_codename.return_value = 'queens'
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION_W_PORT)
+        self.relation_get.side_effect = relation.get
+        self.get_address_in_network.return_value = ''
+        self.config.side_effect = fake_config(SHARED_DB_CONFIG)
+        shared_db = context.SharedDBContext()
+        result = shared_db()
+        expected = {
+            'database_host': 'dbserver.local',
+            'database': 'foodb',
+            'database_user': 'adam',
+            'database_password': 'foo',
+            'database_type': 'mysql+pymysql',
+            'database_port': 3306,
+        }
+        self.assertEquals(result, expected)
+
+    @patch('os.path.exists')
+    @patch(open_builtin)
+    def test_db_ssl(self, _open, osexists):
+        osexists.return_value = False
+        ssl_dir = '/etc/dbssl'
+        db_ssl_ctxt = context.db_ssl(SHARED_DB_RELATION_SSL, {}, ssl_dir)
+        expected = {
+            'database_ssl_ca': ssl_dir + '/db-client.ca',
+            'database_ssl_cert': ssl_dir + '/db-client.cert',
+            'database_ssl_key': ssl_dir + '/db-client.key',
+        }
+        files = [
+            call(expected['database_ssl_ca'], 'wb'),
+            call(expected['database_ssl_cert'], 'wb'),
+            call(expected['database_ssl_key'], 'wb')
+        ]
+        for f in files:
+            self.assertIn(f, _open.call_args_list)
+        self.assertEquals(db_ssl_ctxt, expected)
+        decode = [
+            call(SHARED_DB_RELATION_SSL['ssl_ca']),
+            call(SHARED_DB_RELATION_SSL['ssl_cert']),
+            call(SHARED_DB_RELATION_SSL['ssl_key'])
+        ]
+        self.assertEquals(decode, self.b64decode.call_args_list)
+
+    def test_db_ssl_nossldir(self):
+        db_ssl_ctxt = context.db_ssl(SHARED_DB_RELATION_SSL, {}, None)
+        self.assertEquals(db_ssl_ctxt, {})
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_missing_relation(self, os_codename):
+        '''Test shared-db context missing relation data'''
+        os_codename.return_value = 'stein'
+        incomplete_relation = copy.copy(SHARED_DB_RELATION)
+        incomplete_relation['password'] = None
+        relation = FakeRelation(relation_data=incomplete_relation)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = SHARED_DB_CONFIG
+        shared_db = context.SharedDBContext()
+        result = shared_db()
+        self.assertEquals(result, {})
+
+    def test_shared_db_context_with_missing_config(self):
+        '''Test shared-db context missing relation data'''
+        incomplete_config = copy.copy(SHARED_DB_CONFIG)
+        del incomplete_config['database-user']
+        self.config.side_effect = fake_config(incomplete_config)
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = incomplete_config
+        shared_db = context.SharedDBContext()
+        self.assertRaises(context.OSContextError, shared_db)
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_params(self, os_codename):
+        '''Test shared-db context with object parameters'''
+        os_codename.return_value = 'stein'
+        shared_db = context.SharedDBContext(
+            database='quantum', user='quantum', relation_prefix='quantum')
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION_NAMESPACED)
+        self.relation_get.side_effect = relation.get
+        result = shared_db()
+        self.assertIn(
+            call(rid='foo:0', unit='foo/0'),
+            self.relation_get.call_args_list)
+        self.assertEquals(
+            result, {'database': 'quantum',
+                     'database_user': 'quantum',
+                     'database_password': 'bar2',
+                     'database_host': 'bar',
+                     'database_type': 'mysql+pymysql'})
+
+    @patch.object(context, 'get_os_codename_install_source')
+    def test_shared_db_context_with_params_pike(self, os_codename):
+        '''Test shared-db context with object parameters'''
+        os_codename.return_value = 'pike'
+        shared_db = context.SharedDBContext(
+            database='quantum', user='quantum', relation_prefix='quantum')
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION_NAMESPACED)
+        self.relation_get.side_effect = relation.get
+        result = shared_db()
+        self.assertIn(
+            call(rid='foo:0', unit='foo/0'),
+            self.relation_get.call_args_list)
+        self.assertEquals(
+            result, {'database': 'quantum',
+                     'database_user': 'quantum',
+                     'database_password': 'bar2',
+                     'database_host': 'bar',
+                     'database_type': 'mysql'})
+
+    @patch.object(context, 'get_os_codename_install_source')
+    @patch('charmhelpers.contrib.openstack.context.format_ipv6_addr')
+    def test_shared_db_context_with_ipv6(self, format_ipv6_addr, os_codename):
+        '''Test shared-db context with ipv6'''
+        shared_db = context.SharedDBContext(
+            database='quantum', user='quantum', relation_prefix='quantum')
+        os_codename.return_value = 'stein'
+        relation = FakeRelation(relation_data=SHARED_DB_RELATION_NAMESPACED)
+        self.relation_get.side_effect = relation.get
+        format_ipv6_addr.return_value = '[2001:db8:1::1]'
+        result = shared_db()
+        self.assertIn(
+            call(rid='foo:0', unit='foo/0'),
+            self.relation_get.call_args_list)
+        self.assertEquals(
+            result, {'database': 'quantum',
+                     'database_user': 'quantum',
+                     'database_password': 'bar2',
+                     'database_host': '[2001:db8:1::1]',
+                     'database_type': 'mysql+pymysql'})
+
+    def test_postgresql_db_context_with_data(self):
+        '''Test postgresql-db context with all required data'''
+        relation = FakeRelation(relation_data=POSTGRESQL_DB_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.side_effect = fake_config(POSTGRESQL_DB_CONFIG)
+        postgresql_db = context.PostgresqlDBContext()
+        result = postgresql_db()
+        expected = {
+            'database_host': 'dbserver.local',
+            'database': 'foodb',
+            'database_user': 'adam',
+            'database_password': 'foo',
+            'database_type': 'postgresql',
+        }
+        self.assertEquals(result, expected)
+
+    def test_postgresql_db_context_with_missing_relation(self):
+        '''Test postgresql-db context missing relation data'''
+        incomplete_relation = copy.copy(POSTGRESQL_DB_RELATION)
+        incomplete_relation['password'] = None
+        relation = FakeRelation(relation_data=incomplete_relation)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = POSTGRESQL_DB_CONFIG
+        postgresql_db = context.PostgresqlDBContext()
+        result = postgresql_db()
+        self.assertEquals(result, {})
+
+    def test_postgresql_db_context_with_missing_config(self):
+        '''Test postgresql-db context missing relation data'''
+        incomplete_config = copy.copy(POSTGRESQL_DB_CONFIG)
+        del incomplete_config['database']
+        self.config.side_effect = fake_config(incomplete_config)
+        relation = FakeRelation(relation_data=POSTGRESQL_DB_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = incomplete_config
+        postgresql_db = context.PostgresqlDBContext()
+        self.assertRaises(context.OSContextError, postgresql_db)
+
+    def test_postgresql_db_context_with_params(self):
+        '''Test postgresql-db context with object parameters'''
+        postgresql_db = context.PostgresqlDBContext(database='quantum')
+        result = postgresql_db()
+        self.assertEquals(result['database'], 'quantum')
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_data(self, *args):
+        '''Test shared-db context with all required data'''
+        relation = FakeRelation(relation_data=IDENTITY_SERVICE_RELATION_UNSET)
+        self.relation_get.side_effect = relation.get
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': None,
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'http',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'http',
+            'api_version': '2.0',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    def test_identity_credentials_context_with_data(self):
+        '''Test identity-credentials context with all required data'''
+        relation = FakeRelation(relation_data=IDENTITY_CREDENTIALS_RELATION_UNSET)
+        self.relation_get.side_effect = relation.get
+        identity_credentials = context.IdentityCredentialsContext()
+        result = identity_credentials()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': '123456',
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'https',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'https',
+            'api_version': '2.0',
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_altname(self, *args):
+        '''Test identity context when using an explicit relation name'''
+        relation = FakeRelation(
+            relation_data=APIIDENTITY_SERVICE_RELATION_UNSET
+        )
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.return_value = ['neutron-plugin-api:0']
+        self.related_units.return_value = ['neutron-api/0']
+        identity_service = context.IdentityServiceContext(
+            rel_name='neutron-plugin-api'
+        )
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': None,
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'http',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'http',
+            'api_version': '2.0',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_cache(self, *args):
+        '''Test shared-db context with signing cache info'''
+        relation = FakeRelation(relation_data=IDENTITY_SERVICE_RELATION_UNSET)
+        self.relation_get.side_effect = relation.get
+        svc = 'cinder'
+        identity_service = context.IdentityServiceContext(service=svc,
+                                                          service_user=svc)
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': None,
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'http',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'http',
+            'signing_dir': '/var/cache/cinder',
+            'api_version': '2.0',
+        }
+        self.assertTrue(self.mkdir.called)
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_data_http(self, *args):
+        '''Test shared-db context with all required data'''
+        relation = FakeRelation(relation_data=IDENTITY_SERVICE_RELATION_HTTP)
+        self.relation_get.side_effect = relation.get
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': '123456',
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'http',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'http',
+            'api_version': '2.0',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_data_https(self, *args):
+        '''Test shared-db context with all required data'''
+        relation = FakeRelation(relation_data=IDENTITY_SERVICE_RELATION_HTTPS)
+        self.relation_get.side_effect = relation.get
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': None,
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'https',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'https',
+            'api_version': '2.0',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_data_versioned(self, *args):
+        '''Test shared-db context with api version supplied from keystone'''
+        relation = FakeRelation(
+            relation_data=IDENTITY_SERVICE_RELATION_VERSIONED)
+        self.relation_get.side_effect = relation.get
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_domain_name': 'admin_domain',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': 'svc-proj-id',
+            'admin_domain_id': 'svc-dom-id',
+            'service_project_id': 'svc-proj-id',
+            'service_domain_id': 'svc-dom-id',
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'https',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'https',
+            'api_version': '3',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    def test_identity_credentials_context_with_data_versioned(self):
+        '''Test identity-credentials context with api version supplied from keystone'''
+        relation = FakeRelation(
+            relation_data=IDENTITY_CREDENTIALS_RELATION_VERSIONED)
+        self.relation_get.side_effect = relation.get
+        identity_credentials = context.IdentityCredentialsContext()
+        result = identity_credentials()
+        expected = {
+            'admin_password': 'foo',
+            'admin_domain_name': 'admin_domain',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': '123456',
+            'admin_user': 'adam',
+            'auth_host': 'keystone-host.local',
+            'auth_port': '35357',
+            'auth_protocol': 'https',
+            'service_host': 'keystonehost.local',
+            'service_port': '5000',
+            'service_protocol': 'https',
+            'api_version': '3',
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    @patch('charmhelpers.contrib.openstack.context.format_ipv6_addr')
+    def test_identity_service_context_with_ipv6(self, format_ipv6_addr, *args):
+        '''Test identity-service context with ipv6'''
+        relation = FakeRelation(relation_data=IDENTITY_SERVICE_RELATION_HTTP)
+        self.relation_get.side_effect = relation.get
+        format_ipv6_addr.return_value = '[2001:db8:1::1]'
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        expected = {
+            'admin_password': 'foo',
+            'admin_tenant_name': 'admin',
+            'admin_tenant_id': '123456',
+            'admin_domain_id': None,
+            'admin_user': 'adam',
+            'auth_host': '[2001:db8:1::1]',
+            'auth_port': '35357',
+            'auth_protocol': 'http',
+            'service_host': '[2001:db8:1::1]',
+            'service_port': '5000',
+            'service_protocol': 'http',
+            'api_version': '2.0',
+        }
+        result.pop('keystone_authtoken')
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'filter_installed_packages', return_value=[])
+    @patch.object(context, 'os_release', return_value='rocky')
+    def test_identity_service_context_with_missing_relation(self, *args):
+        '''Test shared-db context missing relation data'''
+        incomplete_relation = copy.copy(IDENTITY_SERVICE_RELATION_UNSET)
+        incomplete_relation['service_password'] = None
+        relation = FakeRelation(relation_data=incomplete_relation)
+        self.relation_get.side_effect = relation.get
+        identity_service = context.IdentityServiceContext()
+        result = identity_service()
+        self.assertEquals(result, {})
+
+    @patch.object(context, 'filter_installed_packages')
+    @patch.object(context, 'os_release')
+    def test_keystone_authtoken_www_authenticate_uri_stein_apiv3(self, mock_os_release, mock_filter_installed_packages):
+        relation_data = copy.deepcopy(IDENTITY_SERVICE_RELATION_VERSIONED)
+        relation = FakeRelation(relation_data=relation_data)
+        self.relation_get.side_effect = relation.get
+
+        mock_filter_installed_packages.return_value = []
+        mock_os_release.return_value = 'stein'
+
+        identity_service = context.IdentityServiceContext()
+
+        cfg_ctx = identity_service()
+
+        keystone_authtoken = cfg_ctx.get('keystone_authtoken', {})
+
+        expected = collections.OrderedDict((
+            ('auth_type', 'password'),
+            ('www_authenticate_uri', 'https://keystonehost.local:5000/v3'),
+            ('auth_url', 'https://keystone-host.local:35357/v3'),
+            ('project_domain_name', 'admin_domain'),
+            ('user_domain_name', 'admin_domain'),
+            ('project_name', 'admin'),
+            ('username', 'adam'),
+            ('password', 'foo'),
+            ('signing_dir', ''),
+        ))
+
+        self.assertEquals(keystone_authtoken, expected)
+
+    def test_amqp_context_with_data(self):
+        '''Test amqp context with all required data'''
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo'
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_explicit_relation_id(self):
+        '''Test amqp context setting the relation_id'''
+        relation = FakeRelation(relation_data=AMQP_RELATION_ALT_RID)
+        self.relation_get.side_effect = relation.get
+        self.related_units.return_value = ['rabbitmq-alt/0']
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext(relation_id='amqp-alt:0')
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbitalthost1',
+            'rabbitmq_password': 'flump',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'transport_url': 'rabbit://adam:flump@rabbitalthost1:5672/foo'
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_data_altname(self):
+        '''Test amqp context with alternative relation name'''
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_NOVA_CONFIG
+        amqp = context.AMQPContext(
+            rel_name='amqp-nova',
+            relation_prefix='nova')
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo'
+        }
+        self.assertEquals(result, expected)
+
+    @patch(open_builtin)
+    def test_amqp_context_with_data_ssl(self, _open):
+        '''Test amqp context with all required data and ssl'''
+        relation = FakeRelation(relation_data=AMQP_RELATION_WITH_SSL)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_CONFIG
+        ssl_dir = '/etc/sslamqp'
+        amqp = context.AMQPContext(ssl_dir=ssl_dir)
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbit_ssl_port': 5671,
+            'rabbitmq_virtual_host': 'foo',
+            'rabbit_ssl_ca': ssl_dir + '/rabbit-client-ca.pem',
+            'rabbitmq_ha_queues': True,
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5671/foo'
+        }
+        _open.assert_called_once_with(ssl_dir + '/rabbit-client-ca.pem', 'wb')
+        self.assertEquals(result, expected)
+        self.assertEquals([call(AMQP_RELATION_WITH_SSL['ssl_ca'])],
+                          self.b64decode.call_args_list)
+
+    def test_amqp_context_with_data_ssl_noca(self):
+        '''Test amqp context with all required data with ssl but missing ca'''
+        relation = FakeRelation(relation_data=AMQP_RELATION_WITH_SSL)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbit_ssl_port': 5671,
+            'rabbitmq_virtual_host': 'foo',
+            'rabbit_ssl_ca': 'cert',
+            'rabbitmq_ha_queues': True,
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5671/foo'
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_data_clustered(self):
+        '''Test amqp context with all required data with clustered rabbit'''
+        relation_data = copy.copy(AMQP_RELATION)
+        relation_data['clustered'] = 'yes'
+        relation = FakeRelation(relation_data=relation_data)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'clustered': True,
+            'rabbitmq_host': relation_data['vip'],
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'transport_url': 'rabbit://adam:foobar@10.0.0.1:5672/foo'
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_data_active_active(self):
+        '''Test amqp context with required data with active/active rabbit'''
+        relation_data = copy.copy(AMQP_AA_RELATION)
+        relation = FakeRelation(relation_data=relation_data)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost1',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'rabbitmq_hosts': 'rabbithost1,rabbithost2',
+            'transport_url': ('rabbit://adam:foobar@rabbithost1:5672'
+                              ',adam:foobar@rabbithost2:5672/foo')
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_missing_relation(self):
+        '''Test amqp context missing relation data'''
+        incomplete_relation = copy.copy(AMQP_RELATION)
+        incomplete_relation['password'] = ''
+        relation = FakeRelation(relation_data=incomplete_relation)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        self.assertEquals({}, result)
+
+    def test_amqp_context_with_missing_config(self):
+        '''Test amqp context missing relation data'''
+        incomplete_config = copy.copy(AMQP_CONFIG)
+        del incomplete_config['rabbit-user']
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.config.return_value = incomplete_config
+        amqp = context.AMQPContext()
+        self.assertRaises(context.OSContextError, amqp)
+
+    @patch('charmhelpers.contrib.openstack.context.format_ipv6_addr')
+    def test_amqp_context_with_ipv6(self, format_ipv6_addr):
+        '''Test amqp context with ipv6'''
+        relation_data = copy.copy(AMQP_AA_RELATION)
+        relation = FakeRelation(relation_data=relation_data)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        format_ipv6_addr.return_value = '[2001:db8:1::1]'
+        self.config.return_value = AMQP_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': '[2001:db8:1::1]',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'rabbitmq_hosts': '[2001:db8:1::1],[2001:db8:1::1]',
+            'transport_url': ('rabbit://adam:foobar@[2001:db8:1::1]:5672'
+                              ',adam:foobar@[2001:db8:1::1]:5672/foo')
+        }
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_oslo_messaging(self):
+        """Test amqp context with oslo-messaging-flags option"""
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        AMQP_OSLO_CONFIG.update(AMQP_CONFIG)
+        self.config.return_value = AMQP_OSLO_CONFIG
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'oslo_messaging_flags': {
+                'rabbit_max_retries': '1',
+                'rabbit_retry_backoff': '1',
+                'rabbit_retry_interval': '1'
+            },
+            'oslo_messaging_driver': 'log',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo'
+        }
+
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_notification_format(self):
+        """Test amqp context with notification_format option"""
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        AMQP_NOTIFICATION_FORMAT.update(AMQP_CONFIG)
+        self.config.return_value = AMQP_NOTIFICATION_FORMAT
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'notification_format': 'both',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo'
+        }
+
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_notification_topics(self):
+        """Test amqp context with notification_topics option"""
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        AMQP_NOTIFICATION_TOPICS.update(AMQP_CONFIG)
+        self.config.return_value = AMQP_NOTIFICATION_TOPICS
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'notification_topics': 'foo,bar',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo'
+        }
+
+        self.assertEquals(result, expected)
+
+    def test_amqp_context_with_notifications_to_logs(self):
+        """Test amqp context with send_notifications_to_logs"""
+        relation = FakeRelation(relation_data=AMQP_RELATION)
+        self.relation_get.side_effect = relation.get
+        AMQP_NOTIFICATIONS_LOGS.update(AMQP_CONFIG)
+        self.config.return_value = AMQP_NOTIFICATIONS_LOGS
+        amqp = context.AMQPContext()
+        result = amqp()
+        expected = {
+            'oslo_messaging_driver': 'messagingv2',
+            'rabbitmq_host': 'rabbithost',
+            'rabbitmq_password': 'foobar',
+            'rabbitmq_user': 'adam',
+            'rabbitmq_virtual_host': 'foo',
+            'transport_url': 'rabbit://adam:foobar@rabbithost:5672/foo',
+            'send_notifications_to_logs': True,
+        }
+
+        self.assertEquals(result, expected)
+
+    def test_libvirt_config_flags(self):
+        self.config.side_effect = fake_config({
+            'libvirt-flags': 'iscsi_use_multipath=True,chap_auth=False',
+        })
+
+        results = context.LibvirtConfigFlagsContext()()
+        self.assertEquals(results, {
+            'libvirt_flags': {
+                'chap_auth': 'False',
+                'iscsi_use_multipath': 'True'
+            }
+        })
+
+    def test_ceph_no_relids(self):
+        '''Test empty ceph realtion'''
+        relation = FakeRelation(relation_data={})
+        self.relation_ids.side_effect = relation.get
+        ceph = context.CephContext()
+        result = ceph()
+        self.assertEquals(result, {})
+
+    def test_ceph_rel_with_no_units(self):
+        '''Test ceph context with missing related units'''
+        relation = FakeRelation(relation_data={})
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = []
+        ceph = context.CephContext()
+        result = ceph()
+        self.assertEquals(result, {})
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_data(self, ensure_packages, mkdir, isdir,
+                                    mock_config):
+        '''Test ceph context with all relation data'''
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        isdir.return_value = False
+        relation = FakeRelation(relation_data=CEPH_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': 'ceph_node1 ceph_node2',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_missing_data(self, ensure_packages, mkdir):
+        '''Test ceph context with missing relation data'''
+        relation = copy.deepcopy(CEPH_RELATION)
+        for k, v in six.iteritems(relation):
+            for u in six.iterkeys(v):
+                del relation[k][u]['auth']
+        relation = FakeRelation(relation_data=relation)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        self.assertEquals(result, {})
+        self.assertFalse(ensure_packages.called)
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_partial_missing_data(self, ensure_packages, mkdir,
+                                               isdir, config):
+        '''Test ceph context last unit missing data
+
+           Tests a fix to a previously bug which meant only the config from
+           last unit was returned so if a valid value was supplied from an
+           earlier unit it would be ignored'''
+        config.side_effect = fake_config({'use-syslog': 'True'})
+        relation = copy.deepcopy(CEPH_RELATION)
+        for k, v in six.iteritems(relation):
+            last_unit = sorted(six.iterkeys(v))[-1]
+            unit_data = relation[k][last_unit]
+            del unit_data['auth']
+            relation[k][last_unit] = unit_data
+        relation = FakeRelation(relation_data=relation)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': 'ceph_node1 ceph_node2',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_public_addr(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_RELATION_WITH_PUBLIC_ADDR)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': '192.168.1.10 192.168.1.11',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_public_addr_and_port(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_REL_WITH_PUBLIC_ADDR_PORT)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': '192.168.1.10:1234 192.168.1.11:4321',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_public_ipv6_addr(self, ensure_packages, mkdir,
+                                                isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_REL_WITH_PUBLIC_IPv6_ADDR)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': '[2001:5c0:9168::1] [2001:5c0:9168::2]',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_public_ipv6_addr_port(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(
+            relation_data=CEPH_REL_WITH_PUBLIC_IPv6_ADDR_PORT)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': '[2001:5c0:9168::1]:1234 [2001:5c0:9168::2]:4321',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_multi_public_addr(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_REL_WITH_MULTI_PUBLIC_ADDR)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': '192.168.1.10 192.168.1.11 192.168.1.20 192.168.1.21',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_default_features(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with all
+        relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_REL_WITH_DEFAULT_FEATURES)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+        result = ceph()
+        expected = {
+            'mon_hosts': 'ceph_node1 ceph_node2',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+            'rbd_features': '1',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_with_rbd_cache(self, ensure_packages, mkdir, isdir,
+                                         mock_config):
+        isdir.return_value = False
+        config_dict = {'rbd-client-cache': 'enabled',
+                       'use-syslog': False}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = FakeRelation(relation_data=CEPH_RELATION_WITH_PUBLIC_ADDR)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+
+        class CephContextWithRBDCache(context.CephContext):
+            def __call__(self):
+                ctxt = super(CephContextWithRBDCache, self).__call__()
+
+                rbd_cache = fake_config('rbd-client-cache') or ""
+                if rbd_cache.lower() == "enabled":
+                    ctxt['rbd_client_cache_settings'] = \
+                        {'rbd cache': 'true',
+                         'rbd cache writethrough until flush': 'true'}
+                elif rbd_cache.lower() == "disabled":
+                    ctxt['rbd_client_cache_settings'] = \
+                        {'rbd cache': 'false'}
+
+                return ctxt
+
+        ceph = CephContextWithRBDCache()
+        result = ceph()
+        expected = {
+            'mon_hosts': '192.168.1.10 192.168.1.11',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'false',
+        }
+        expected['rbd_client_cache_settings'] = \
+            {'rbd cache': 'true',
+             'rbd cache writethrough until flush': 'true'}
+
+        self.assertDictEqual(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch.object(context, 'config')
+    def test_sysctl_context_with_config(self, config):
+        self.charm_name.return_value = 'test-charm'
+        config.return_value = '{ kernel.max_pid: "1337"}'
+        self.sysctl_create.return_value = True
+        ctxt = context.SysctlContext()
+        result = ctxt()
+        self.sysctl_create.assert_called_with(
+            config.return_value,
+            "/etc/sysctl.d/50-test-charm.conf")
+
+        self.assertTrue(result, {'sysctl': config.return_value})
+
+    @patch.object(context, 'config')
+    def test_sysctl_context_without_config(self, config):
+        self.charm_name.return_value = 'test-charm'
+        config.return_value = None
+        self.sysctl_create.return_value = True
+        ctxt = context.SysctlContext()
+        result = ctxt()
+        self.assertTrue(self.sysctl_create.called == 0)
+        self.assertTrue(result, {'sysctl': config.return_value})
+
+    @patch.object(context, 'config')
+    @patch('os.path.isdir')
+    @patch('os.mkdir')
+    @patch.object(context, 'ensure_packages')
+    def test_ceph_context_missing_public_addr(
+            self, ensure_packages, mkdir, isdir, mock_config):
+        '''Test ceph context in host with multiple networks with no
+        ceph-public-addr in relation data'''
+        isdir.return_value = False
+        config_dict = {'use-syslog': True}
+
+        def fake_config(key):
+            return config_dict.get(key)
+
+        mock_config.side_effect = fake_config
+        relation = copy.deepcopy(CEPH_RELATION_WITH_PUBLIC_ADDR)
+        del relation['ceph:0']['ceph/0']['ceph-public-address']
+        relation = FakeRelation(relation_data=relation)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        ceph = context.CephContext()
+
+        result = ceph()
+        expected = {
+            'mon_hosts': '192.168.1.11 ceph_node1',
+            'auth': 'foo',
+            'key': 'bar',
+            'use_syslog': 'true',
+        }
+        self.assertEquals(result, expected)
+        ensure_packages.assert_called_with(['ceph-common'])
+        mkdir.assert_called_with('/etc/ceph')
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_data(self, local_unit, unit_get):
+        '''Test haproxy context with all relation data'''
+        cluster_relation = {
+            'cluster:0': {
+                'peer/1': {
+                    'private-address': 'cluster-peer1.localnet',
+                },
+                'peer/2': {
+                    'private-address': 'cluster-peer2.localnet',
+                },
+            },
+        }
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None,
+                                            'cluster-peer0.localnet']
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.get_netmask_for_address.return_value = '255.255.0.0'
+        self.config.return_value = False
+        self.maxDiff = None
+        self.is_ipv6_disabled.return_value = True
+        haproxy = context.HAProxyContext()
+        with patch_open() as (_open, _file):
+            result = haproxy()
+        ex = {
+            'frontends': {
+                'cluster-peer0.localnet': {
+                    'network': 'cluster-peer0.localnet/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.localnet'),
+                        ('peer-1', 'cluster-peer1.localnet'),
+                        ('peer-2', 'cluster-peer2.localnet'),
+                    ]),
+                },
+            },
+            'default_backend': 'cluster-peer0.localnet',
+            'local_host': '127.0.0.1',
+            'haproxy_host': '0.0.0.0',
+            'ipv6_enabled': False,
+            'stat_password': 'testpassword',
+            'stat_port': '8888',
+        }
+        # the context gets generated.
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('admin', False),
+                                               call('internal', False),
+                                               call('public', False),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_data_timeout(self, local_unit, unit_get):
+        '''Test haproxy context with all relation data and timeout'''
+        cluster_relation = {
+            'cluster:0': {
+                'peer/1': {
+                    'private-address': 'cluster-peer1.localnet',
+                },
+                'peer/2': {
+                    'private-address': 'cluster-peer2.localnet',
+                },
+            },
+        }
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None,
+                                            'cluster-peer0.localnet']
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.get_netmask_for_address.return_value = '255.255.0.0'
+        self.config.return_value = False
+        self.maxDiff = None
+        c = fake_config(HAPROXY_CONFIG)
+        c.data['prefer-ipv6'] = False
+        self.config.side_effect = c
+        self.is_ipv6_disabled.return_value = True
+        haproxy = context.HAProxyContext()
+        with patch_open() as (_open, _file):
+            result = haproxy()
+        ex = {
+            'frontends': {
+                'cluster-peer0.localnet': {
+                    'network': 'cluster-peer0.localnet/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.localnet'),
+                        ('peer-1', 'cluster-peer1.localnet'),
+                        ('peer-2', 'cluster-peer2.localnet'),
+                    ]),
+                }
+            },
+            'default_backend': 'cluster-peer0.localnet',
+            'local_host': '127.0.0.1',
+            'haproxy_host': '0.0.0.0',
+            'ipv6_enabled': False,
+            'stat_password': 'testpassword',
+            'stat_port': '8888',
+            'haproxy_client_timeout': 50000,
+            'haproxy_server_timeout': 50000,
+        }
+        # the context gets generated.
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('admin', None),
+                                               call('internal', None),
+                                               call('public', None),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_data_multinet(self, local_unit, unit_get):
+        '''Test haproxy context with all relation data for network splits'''
+        cluster_relation = {
+            'cluster:0': {
+                'peer/1': {
+                    'private-address': 'cluster-peer1.localnet',
+                    'admin-address': 'cluster-peer1.admin',
+                    'internal-address': 'cluster-peer1.internal',
+                    'public-address': 'cluster-peer1.public',
+                },
+                'peer/2': {
+                    'private-address': 'cluster-peer2.localnet',
+                    'admin-address': 'cluster-peer2.admin',
+                    'internal-address': 'cluster-peer2.internal',
+                    'public-address': 'cluster-peer2.public',
+                },
+            },
+        }
+
+        local_unit.return_value = 'peer/0'
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = ['cluster-peer0.admin',
+                                            'cluster-peer0.internal',
+                                            'cluster-peer0.public',
+                                            'cluster-peer0.localnet']
+        self.get_netmask_for_address.return_value = '255.255.0.0'
+        self.config.return_value = False
+        self.maxDiff = None
+        self.is_ipv6_disabled.return_value = True
+        haproxy = context.HAProxyContext()
+        with patch_open() as (_open, _file):
+            result = haproxy()
+        ex = {
+            'frontends': {
+                'cluster-peer0.admin': {
+                    'network': 'cluster-peer0.admin/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.admin'),
+                        ('peer-1', 'cluster-peer1.admin'),
+                        ('peer-2', 'cluster-peer2.admin'),
+                    ]),
+                },
+                'cluster-peer0.internal': {
+                    'network': 'cluster-peer0.internal/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.internal'),
+                        ('peer-1', 'cluster-peer1.internal'),
+                        ('peer-2', 'cluster-peer2.internal'),
+                    ]),
+                },
+                'cluster-peer0.public': {
+                    'network': 'cluster-peer0.public/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.public'),
+                        ('peer-1', 'cluster-peer1.public'),
+                        ('peer-2', 'cluster-peer2.public'),
+                    ]),
+                },
+                'cluster-peer0.localnet': {
+                    'network': 'cluster-peer0.localnet/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.localnet'),
+                        ('peer-1', 'cluster-peer1.localnet'),
+                        ('peer-2', 'cluster-peer2.localnet'),
+                    ]),
+                }
+            },
+            'default_backend': 'cluster-peer0.localnet',
+            'local_host': '127.0.0.1',
+            'haproxy_host': '0.0.0.0',
+            'ipv6_enabled': False,
+            'stat_password': 'testpassword',
+            'stat_port': '8888',
+        }
+        # the context gets generated.
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('admin', False),
+                                               call('internal', False),
+                                               call('public', False),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_data_public_only(self, local_unit, unit_get):
+        '''Test haproxy context with with openstack-dashboard public only binding'''
+        cluster_relation = {
+            'cluster:0': {
+                'peer/1': {
+                    'private-address': 'cluster-peer1.localnet',
+                    'public-address': 'cluster-peer1.public',
+                },
+                'peer/2': {
+                    'private-address': 'cluster-peer2.localnet',
+                    'public-address': 'cluster-peer2.public',
+                },
+            },
+        }
+
+        local_unit.return_value = 'peer/0'
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        _network_get_map = {
+            'public': 'cluster-peer0.public',
+            'cluster': 'cluster-peer0.localnet',
+        }
+        self.get_relation_ip.side_effect = (
+            lambda binding, config_opt=None:
+                _network_get_map[binding]
+        )
+        self.get_netmask_for_address.return_value = '255.255.0.0'
+        self.config.return_value = None
+        self.maxDiff = None
+        self.is_ipv6_disabled.return_value = True
+        haproxy = context.HAProxyContext(address_types=['public'])
+        with patch_open() as (_open, _file):
+            result = haproxy()
+        ex = {
+            'frontends': {
+                'cluster-peer0.public': {
+                    'network': 'cluster-peer0.public/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.public'),
+                        ('peer-1', 'cluster-peer1.public'),
+                        ('peer-2', 'cluster-peer2.public'),
+                    ]),
+                },
+                'cluster-peer0.localnet': {
+                    'network': 'cluster-peer0.localnet/255.255.0.0',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.localnet'),
+                        ('peer-1', 'cluster-peer1.localnet'),
+                        ('peer-2', 'cluster-peer2.localnet'),
+                    ]),
+                }
+            },
+            'default_backend': 'cluster-peer0.localnet',
+            'local_host': '127.0.0.1',
+            'haproxy_host': '0.0.0.0',
+            'ipv6_enabled': False,
+            'stat_password': 'testpassword',
+            'stat_port': '8888',
+        }
+        # the context gets generated.
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('public', None),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_data_ipv6(self, local_unit, unit_get):
+        '''Test haproxy context with all relation data ipv6'''
+        cluster_relation = {
+            'cluster:0': {
+                'peer/1': {
+                    'private-address': 'cluster-peer1.localnet',
+                },
+                'peer/2': {
+                    'private-address': 'cluster-peer2.localnet',
+                },
+            },
+        }
+
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None,
+                                            'cluster-peer0.localnet']
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.get_address_in_network.return_value = None
+        self.get_netmask_for_address.return_value = \
+            'FFFF:FFFF:FFFF:FFFF:0000:0000:0000:0000'
+        self.get_ipv6_addr.return_value = ['cluster-peer0.localnet']
+        c = fake_config(HAPROXY_CONFIG)
+        c.data['prefer-ipv6'] = True
+        self.config.side_effect = c
+        self.maxDiff = None
+        self.is_ipv6_disabled.return_value = False
+        haproxy = context.HAProxyContext()
+        with patch_open() as (_open, _file):
+            result = haproxy()
+        ex = {
+            'frontends': {
+                'cluster-peer0.localnet': {
+                    'network': 'cluster-peer0.localnet/'
+                    'FFFF:FFFF:FFFF:FFFF:0000:0000:0000:0000',
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'cluster-peer0.localnet'),
+                        ('peer-1', 'cluster-peer1.localnet'),
+                        ('peer-2', 'cluster-peer2.localnet'),
+                    ]),
+                }
+            },
+            'default_backend': 'cluster-peer0.localnet',
+            'local_host': 'ip6-localhost',
+            'haproxy_server_timeout': 50000,
+            'haproxy_client_timeout': 50000,
+            'haproxy_host': '::',
+            'ipv6_enabled': True,
+            'stat_password': 'testpassword',
+            'stat_port': '8888',
+        }
+        # the context gets generated.
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('admin', None),
+                                               call('internal', None),
+                                               call('public', None),
+                                               call('cluster')])
+
+    def test_haproxy_context_with_missing_data(self):
+        '''Test haproxy context with missing relation data'''
+        self.relation_ids.return_value = []
+        haproxy = context.HAProxyContext()
+        self.assertEquals({}, haproxy())
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_no_peers(self, local_unit, unit_get):
+        '''Test haproxy context with single unit'''
+        # peer relations always show at least one peer relation, even
+        # if unit is alone. should be an incomplete context.
+        cluster_relation = {
+            'cluster:0': {
+                'peer/0': {
+                    'private-address': 'lonely.clusterpeer.howsad',
+                },
+            },
+        }
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None, None]
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.config.return_value = False
+        haproxy = context.HAProxyContext()
+        self.assertEquals({}, haproxy())
+        self.get_relation_ip.assert_has_calls([call('admin', False),
+                                               call('internal', False),
+                                               call('public', False),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_net_override(self, local_unit, unit_get):
+        '''Test haproxy context with single unit'''
+        # peer relations always show at least one peer relation, even
+        # if unit is alone. should be an incomplete context.
+        cluster_relation = {
+            'cluster:0': {
+                'peer/0': {
+                    'private-address': 'lonely.clusterpeer.howsad',
+                },
+            },
+        }
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None, None]
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.config.return_value = False
+        c = fake_config(HAPROXY_CONFIG)
+        c.data['os-admin-network'] = '192.168.10.0/24'
+        c.data['os-internal-network'] = '192.168.20.0/24'
+        c.data['os-public-network'] = '192.168.30.0/24'
+        self.config.side_effect = c
+        haproxy = context.HAProxyContext()
+        self.assertEquals({}, haproxy())
+        self.get_relation_ip.assert_has_calls([call('admin', '192.168.10.0/24'),
+                                               call('internal', '192.168.20.0/24'),
+                                               call('public', '192.168.30.0/24'),
+                                               call('cluster')])
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch('charmhelpers.contrib.openstack.context.local_unit')
+    def test_haproxy_context_with_no_peers_singlemode(self, local_unit, unit_get):
+        '''Test haproxy context with single unit'''
+        # peer relations always show at least one peer relation, even
+        # if unit is alone. should be an incomplete context.
+        cluster_relation = {
+            'cluster:0': {
+                'peer/0': {
+                    'private-address': 'lonely.clusterpeer.howsad',
+                },
+            },
+        }
+        local_unit.return_value = 'peer/0'
+        # We are only using get_relation_ip.
+        # Setup the values it returns on each subsequent call.
+        self.get_relation_ip.side_effect = [None, None, None,
+                                            'lonely.clusterpeer.howsad']
+        relation = FakeRelation(cluster_relation)
+        self.relation_ids.side_effect = relation.relation_ids
+        self.relation_get.side_effect = relation.get
+        self.related_units.side_effect = relation.relation_units
+        self.config.return_value = False
+        self.get_address_in_network.return_value = None
+        self.get_netmask_for_address.return_value = '255.255.0.0'
+        self.is_ipv6_disabled.return_value = True
+        with patch_open() as (_open, _file):
+            result = context.HAProxyContext(singlenode_mode=True)()
+        ex = {
+            'frontends': {
+                'lonely.clusterpeer.howsad': {
+                    'backends': collections.OrderedDict([
+                        ('peer-0', 'lonely.clusterpeer.howsad')]),
+                    'network': 'lonely.clusterpeer.howsad/255.255.0.0'
+                },
+            },
+            'default_backend': 'lonely.clusterpeer.howsad',
+            'haproxy_host': '0.0.0.0',
+            'local_host': '127.0.0.1',
+            'ipv6_enabled': False,
+            'stat_port': '8888',
+            'stat_password': 'testpassword',
+        }
+        self.assertEquals(ex, result)
+        # and /etc/default/haproxy is updated.
+        self.assertEquals(_file.write.call_args_list,
+                          [call('ENABLED=1\n')])
+        self.get_relation_ip.assert_has_calls([call('admin', False),
+                                               call('internal', False),
+                                               call('public', False),
+                                               call('cluster')])
+
+    def test_https_context_with_no_https(self):
+        '''Test apache2 https when no https data available'''
+        apache = context.ApacheSSLContext()
+        self.https.return_value = False
+        self.assertEquals({}, apache())
+
+    def _https_context_setup(self):
+        '''
+        Helper for test_https_context* tests.
+
+        '''
+        self.https.return_value = True
+        self.determine_api_port.return_value = 8756
+        self.determine_apache_port.return_value = 8766
+
+        apache = context.ApacheSSLContext()
+        apache.configure_cert = MagicMock()
+        apache.enable_modules = MagicMock()
+        apache.configure_ca = MagicMock()
+        apache.canonical_names = MagicMock()
+        apache.canonical_names.return_value = [
+            '10.5.1.1',
+            '10.5.2.1',
+            '10.5.3.1',
+        ]
+        apache.get_network_addresses = MagicMock()
+        apache.get_network_addresses.return_value = [
+            ('10.5.1.100', '10.5.1.1'),
+            ('10.5.2.100', '10.5.2.1'),
+            ('10.5.3.100', '10.5.3.1'),
+        ]
+        apache.external_ports = '8776'
+        apache.service_namespace = 'cinder'
+
+        ex = {
+            'namespace': 'cinder',
+            'endpoints': [('10.5.1.100', '10.5.1.1', 8766, 8756),
+                          ('10.5.2.100', '10.5.2.1', 8766, 8756),
+                          ('10.5.3.100', '10.5.3.1', 8766, 8756)],
+            'ext_ports': [8766]
+        }
+
+        return apache, ex
+
+    def test_https_context(self):
+        self.relation_ids.return_value = []
+
+        apache, ex = self._https_context_setup()
+
+        self.assertEquals(ex, apache())
+
+        apache.configure_cert.assert_has_calls([
+            call('10.5.1.1'),
+            call('10.5.2.1'),
+            call('10.5.3.1')
+        ])
+
+        self.assertTrue(apache.configure_ca.called)
+        self.assertTrue(apache.enable_modules.called)
+        self.assertTrue(apache.configure_cert.called)
+
+    def test_https_context_vault_relation(self):
+        self.relation_ids.return_value = ['certificates:2']
+        self.related_units.return_value = 'vault/0'
+
+        apache, ex = self._https_context_setup()
+
+        self.assertEquals(ex, apache())
+
+        self.assertFalse(apache.configure_cert.called)
+        self.assertFalse(apache.configure_ca.called)
+
+    def test_https_context_no_canonical_names(self):
+        self.relation_ids.return_value = []
+
+        apache, ex = self._https_context_setup()
+        apache.canonical_names.return_value = []
+
+        self.resolve_address.side_effect = (
+            '10.5.1.4', '10.5.2.5', '10.5.3.6')
+
+        self.assertEquals(ex, apache())
+
+        apache.configure_cert.assert_has_calls([
+            call('10.5.1.4'),
+            call('10.5.2.5'),
+            call('10.5.3.6')
+        ])
+
+        self.resolve_address.assert_has_calls([
+            call(endpoint_type=context.INTERNAL),
+            call(endpoint_type=context.ADMIN),
+            call(endpoint_type=context.PUBLIC),
+        ])
+
+        self.assertTrue(apache.configure_ca.called)
+        self.assertTrue(apache.enable_modules.called)
+        self.assertTrue(apache.configure_cert.called)
+
+    def test_https_context_loads_correct_apache_mods(self):
+        # Test apache2 context also loads required apache modules
+        apache = context.ApacheSSLContext()
+        apache.enable_modules()
+        ex_cmd = ['a2enmod', 'ssl', 'proxy', 'proxy_http', 'headers']
+        self.check_call.assert_called_with(ex_cmd)
+
+    def test_https_configure_cert(self):
+        # Test apache2 properly installs certs and keys to disk
+        self.get_cert.return_value = ('SSL_CERT', 'SSL_KEY')
+        self.b64decode.side_effect = [b'SSL_CERT', b'SSL_KEY']
+        apache = context.ApacheSSLContext()
+        apache.service_namespace = 'cinder'
+        apache.configure_cert('test-cn')
+        # appropriate directories are created.
+        self.mkdir.assert_called_with(path='/etc/apache2/ssl/cinder')
+        # appropriate files are written.
+        files = [call(path='/etc/apache2/ssl/cinder/cert_test-cn',
+                      content=b'SSL_CERT', owner='root', group='root',
+                      perms=0o640),
+                 call(path='/etc/apache2/ssl/cinder/key_test-cn',
+                      content=b'SSL_KEY', owner='root', group='root',
+                      perms=0o640)]
+        self.write_file.assert_has_calls(files)
+        # appropriate bits are b64decoded.
+        decode = [call('SSL_CERT'), call('SSL_KEY')]
+        self.assertEquals(decode, self.b64decode.call_args_list)
+
+    def test_https_configure_cert_deprecated(self):
+        # Test apache2 properly installs certs and keys to disk
+        self.get_cert.return_value = ('SSL_CERT', 'SSL_KEY')
+        self.b64decode.side_effect = ['SSL_CERT', 'SSL_KEY']
+        apache = context.ApacheSSLContext()
+        apache.service_namespace = 'cinder'
+        apache.configure_cert()
+        # appropriate directories are created.
+        self.mkdir.assert_called_with(path='/etc/apache2/ssl/cinder')
+        # appropriate files are written.
+        files = [call(path='/etc/apache2/ssl/cinder/cert',
+                      content='SSL_CERT', owner='root', group='root',
+                      perms=0o640),
+                 call(path='/etc/apache2/ssl/cinder/key',
+                      content='SSL_KEY', owner='root', group='root',
+                      perms=0o640)]
+        self.write_file.assert_has_calls(files)
+        # appropriate bits are b64decoded.
+        decode = [call('SSL_CERT'), call('SSL_KEY')]
+        self.assertEquals(decode, self.b64decode.call_args_list)
+
+    def test_https_canonical_names(self):
+        rel = FakeRelation(IDENTITY_RELATION_SINGLE_CERT)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.related_units.side_effect = rel.relation_units
+        self.relation_get.side_effect = rel.get
+        apache = context.ApacheSSLContext()
+        self.assertEquals(apache.canonical_names(), ['cinderhost1'])
+        rel.relation_data = IDENTITY_RELATION_MULTIPLE_CERT
+        self.assertEquals(apache.canonical_names(),
+                          sorted(['cinderhost1-adm-network',
+                                  'cinderhost1-int-network',
+                                  'cinderhost1-pub-network']))
+        rel.relation_data = IDENTITY_RELATION_NO_CERT
+        self.assertEquals(apache.canonical_names(), [])
+
+    def test_image_service_context_missing_data(self):
+        '''Test image-service with missing relation and missing data'''
+        image_service = context.ImageServiceContext()
+        self.relation_ids.return_value = []
+        self.assertEquals({}, image_service())
+        self.relation_ids.return_value = ['image-service:0']
+        self.related_units.return_value = ['glance/0']
+        self.relation_get.return_value = None
+        self.assertEquals({}, image_service())
+
+    def test_image_service_context_with_data(self):
+        '''Test image-service with required data'''
+        image_service = context.ImageServiceContext()
+        self.relation_ids.return_value = ['image-service:0']
+        self.related_units.return_value = ['glance/0']
+        self.relation_get.return_value = 'http://glancehost:9292'
+        self.assertEquals({'glance_api_servers': 'http://glancehost:9292'},
+                          image_service())
+
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_context_base_properties(self, attr):
+        '''Test neutron context base properties'''
+        neutron = context.NeutronContext()
+        attr.return_value = 'quantum-plugin-package'
+        self.assertEquals(None, neutron.plugin)
+        self.assertEquals(None, neutron.network_manager)
+        self.assertEquals(None, neutron.neutron_security_groups)
+        self.assertEquals('quantum-plugin-package', neutron.packages)
+
+    @patch.object(context, 'neutron_plugin_attribute')
+    @patch.object(context, 'apt_install')
+    @patch.object(context, 'filter_installed_packages')
+    def test_neutron_ensure_package(self, _filter, _install, _packages):
+        '''Test neutron context installed required packages'''
+        _filter.return_value = ['quantum-plugin-package']
+        _packages.return_value = [['quantum-plugin-package']]
+        neutron = context.NeutronContext()
+        neutron._ensure_packages()
+        _install.assert_called_with(['quantum-plugin-package'], fatal=True)
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_ovs_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'ovs',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.ovs_ctxt())
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_nvp_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'nvp',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.nvp_ctxt())
+
+    @patch.object(context, 'config')
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_n1kv_plugin_context(self, attr, ip, sec_groups, config):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        config.return_value = 'n1kv'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'n1kv',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1',
+            'config': 'some.quantum.driver.class',
+            'vsm_ip': 'n1kv',
+            'vsm_username': 'n1kv',
+            'vsm_password': 'n1kv',
+            'user_config_flags': {},
+            'restrict_policy_profiles': 'n1kv',
+        }, neutron.n1kv_ctxt())
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_calico_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'Calico',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.calico_ctxt())
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_plumgrid_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'plumgrid',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.pg_ctxt())
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_nuage_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'vsp',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.nuage_ctxt())
+
+    @patch.object(context.NeutronContext, 'neutron_security_groups')
+    @patch.object(context, 'unit_private_ip')
+    @patch.object(context, 'neutron_plugin_attribute')
+    def test_neutron_midonet_plugin_context(self, attr, ip, sec_groups):
+        ip.return_value = '10.0.0.1'
+        sec_groups.__get__ = MagicMock(return_value=True)
+        attr.return_value = 'some.quantum.driver.class'
+        neutron = context.NeutronContext()
+        self.assertEquals({
+            'config': 'some.quantum.driver.class',
+            'core_plugin': 'some.quantum.driver.class',
+            'neutron_plugin': 'midonet',
+            'neutron_security_groups': True,
+            'local_ip': '10.0.0.1'}, neutron.midonet_ctxt())
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch.object(context.NeutronContext, 'network_manager')
+    def test_neutron_neutron_ctxt(self, mock_network_manager,
+                                  mock_unit_get):
+        vip = '88.11.22.33'
+        priv_addr = '10.0.0.1'
+        mock_unit_get.return_value = priv_addr
+        neutron = context.NeutronContext()
+
+        config = {'vip': vip}
+        self.config.side_effect = lambda key: config[key]
+        mock_network_manager.__get__ = Mock(return_value='neutron')
+
+        self.is_clustered.return_value = False
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'neutron_url': 'https://%s:9696' % (priv_addr)},
+            neutron.neutron_ctxt()
+        )
+
+        self.is_clustered.return_value = True
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'neutron_url': 'https://%s:9696' % (vip)},
+            neutron.neutron_ctxt()
+        )
+
+    @patch('charmhelpers.contrib.openstack.context.unit_get')
+    @patch.object(context.NeutronContext, 'network_manager')
+    def test_neutron_neutron_ctxt_http(self, mock_network_manager,
+                                       mock_unit_get):
+        vip = '88.11.22.33'
+        priv_addr = '10.0.0.1'
+        mock_unit_get.return_value = priv_addr
+        neutron = context.NeutronContext()
+
+        config = {'vip': vip}
+        self.config.side_effect = lambda key: config[key]
+        self.https.return_value = False
+        mock_network_manager.__get__ = Mock(return_value='neutron')
+
+        self.is_clustered.return_value = False
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'neutron_url': 'http://%s:9696' % (priv_addr)},
+            neutron.neutron_ctxt()
+        )
+
+        self.is_clustered.return_value = True
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'neutron_url': 'http://%s:9696' % (vip)},
+            neutron.neutron_ctxt()
+        )
+
+    @patch.object(context.NeutronContext, 'neutron_ctxt')
+    @patch.object(context.NeutronContext, 'ovs_ctxt')
+    @patch.object(context.NeutronContext, 'plugin')
+    @patch.object(context.NeutronContext, '_ensure_packages')
+    @patch.object(context.NeutronContext, 'network_manager')
+    def test_neutron_main_context_generation(self, mock_network_manager,
+                                             mock_ensure_packages,
+                                             mock_plugin, mock_ovs_ctxt,
+                                             mock_neutron_ctxt):
+
+        mock_neutron_ctxt.return_value = {'network_manager': 'neutron',
+                                          'neutron_url': 'https://foo:9696'}
+        config = {'neutron-alchemy-flags': None}
+        self.config.side_effect = lambda key: config[key]
+        neutron = context.NeutronContext()
+
+        mock_network_manager.__get__ = Mock(return_value='flatdhcpmanager')
+        mock_plugin.__get__ = Mock()
+
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_network_manager.__get__.called)
+        self.assertFalse(mock_plugin.__get__.called)
+
+        mock_network_manager.__get__.return_value = 'neutron'
+        mock_plugin.__get__ = Mock(return_value=None)
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_plugin.__get__.called)
+
+        mock_ovs_ctxt.return_value = {'ovs': 'ovs_context'}
+        mock_plugin.__get__.return_value = 'ovs'
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'ovs': 'ovs_context',
+             'neutron_url': 'https://foo:9696'},
+            neutron()
+        )
+
+    @patch.object(context.NeutronContext, 'neutron_ctxt')
+    @patch.object(context.NeutronContext, 'nvp_ctxt')
+    @patch.object(context.NeutronContext, 'plugin')
+    @patch.object(context.NeutronContext, '_ensure_packages')
+    @patch.object(context.NeutronContext, 'network_manager')
+    def test_neutron_main_context_gen_nvp_and_alchemy(self,
+                                                      mock_network_manager,
+                                                      mock_ensure_packages,
+                                                      mock_plugin,
+                                                      mock_nvp_ctxt,
+                                                      mock_neutron_ctxt):
+
+        mock_neutron_ctxt.return_value = {'network_manager': 'neutron',
+                                          'neutron_url': 'https://foo:9696'}
+        config = {'neutron-alchemy-flags': 'pool_size=20'}
+        self.config.side_effect = lambda key: config[key]
+        neutron = context.NeutronContext()
+
+        mock_network_manager.__get__ = Mock(return_value='flatdhcpmanager')
+        mock_plugin.__get__ = Mock()
+
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_network_manager.__get__.called)
+        self.assertFalse(mock_plugin.__get__.called)
+
+        mock_network_manager.__get__.return_value = 'neutron'
+        mock_plugin.__get__ = Mock(return_value=None)
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_plugin.__get__.called)
+
+        mock_nvp_ctxt.return_value = {'nvp': 'nvp_context'}
+        mock_plugin.__get__.return_value = 'nvp'
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'nvp': 'nvp_context',
+             'neutron_alchemy_flags': {'pool_size': '20'},
+             'neutron_url': 'https://foo:9696'},
+            neutron()
+        )
+
+    @patch.object(context.NeutronContext, 'neutron_ctxt')
+    @patch.object(context.NeutronContext, 'calico_ctxt')
+    @patch.object(context.NeutronContext, 'plugin')
+    @patch.object(context.NeutronContext, '_ensure_packages')
+    @patch.object(context.NeutronContext, 'network_manager')
+    def test_neutron_main_context_gen_calico(self, mock_network_manager,
+                                             mock_ensure_packages,
+                                             mock_plugin, mock_ovs_ctxt,
+                                             mock_neutron_ctxt):
+
+        mock_neutron_ctxt.return_value = {'network_manager': 'neutron',
+                                          'neutron_url': 'https://foo:9696'}
+        config = {'neutron-alchemy-flags': None}
+        self.config.side_effect = lambda key: config[key]
+        neutron = context.NeutronContext()
+
+        mock_network_manager.__get__ = Mock(return_value='flatdhcpmanager')
+        mock_plugin.__get__ = Mock()
+
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_network_manager.__get__.called)
+        self.assertFalse(mock_plugin.__get__.called)
+
+        mock_network_manager.__get__.return_value = 'neutron'
+        mock_plugin.__get__ = Mock(return_value=None)
+        self.assertEquals({}, neutron())
+        self.assertTrue(mock_plugin.__get__.called)
+
+        mock_ovs_ctxt.return_value = {'Calico': 'calico_context'}
+        mock_plugin.__get__.return_value = 'Calico'
+        self.assertEquals(
+            {'network_manager': 'neutron',
+             'Calico': 'calico_context',
+             'neutron_url': 'https://foo:9696'},
+            neutron()
+        )
+
+    @patch('charmhelpers.contrib.openstack.utils.juju_log',
+           lambda *args, **kwargs: None)
+    @patch.object(context, 'config')
+    def test_os_configflag_context(self, config):
+        flags = context.OSConfigFlagContext()
+
+        # single
+        config.return_value = 'deadbeef=True'
+        self.assertEquals({
+            'user_config_flags': {
+                'deadbeef': 'True',
+            }
+        }, flags())
+
+        # multi
+        config.return_value = 'floating_ip=True,use_virtio=False,max=5'
+        self.assertEquals({
+            'user_config_flags': {
+                'floating_ip': 'True',
+                'use_virtio': 'False',
+                'max': '5',
+            }
+        }, flags())
+
+        for empty in [None, '']:
+            config.return_value = empty
+            self.assertEquals({}, flags())
+
+        # multi with commas
+        config.return_value = 'good_flag=woot,badflag,great_flag=w00t'
+        self.assertEquals({
+            'user_config_flags': {
+                'good_flag': 'woot,badflag',
+                'great_flag': 'w00t',
+            }
+        }, flags())
+
+        # missing key
+        config.return_value = 'good_flag=woot=toow'
+        self.assertRaises(context.OSContextError, flags)
+
+        # bad value
+        config.return_value = 'good_flag=woot=='
+        self.assertRaises(context.OSContextError, flags)
+
+    @patch.object(context, 'config')
+    def test_os_configflag_context_custom(self, config):
+        flags = context.OSConfigFlagContext(
+            charm_flag='api-config-flags',
+            template_flag='api_config_flags')
+
+        # single
+        config.return_value = 'deadbeef=True'
+        self.assertEquals({
+            'api_config_flags': {
+                'deadbeef': 'True',
+            }
+        }, flags())
+
+    def test_os_subordinate_config_context(self):
+        relation = FakeRelation(relation_data=SUB_CONFIG_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        nova_sub_ctxt = context.SubordinateConfigContext(
+            service='nova',
+            config_file='/etc/nova/nova.conf',
+            interface='nova-subordinate',
+        )
+        glance_sub_ctxt = context.SubordinateConfigContext(
+            service='glance',
+            config_file='/etc/glance/glance.conf',
+            interface='glance-subordinate',
+        )
+        cinder_sub_ctxt = context.SubordinateConfigContext(
+            service='cinder',
+            config_file='/etc/cinder/cinder.conf',
+            interface='cinder-subordinate',
+        )
+        foo_sub_ctxt = context.SubordinateConfigContext(
+            service='foo',
+            config_file='/etc/foo/foo.conf',
+            interface='foo-subordinate',
+        )
+        self.assertEquals(
+            nova_sub_ctxt(),
+            {'sections': {
+                'DEFAULT': [
+                    ['nova-key1', 'value1'],
+                    ['nova-key2', 'value2']]
+            }}
+        )
+        self.assertEquals(
+            glance_sub_ctxt(),
+            {'sections': {
+                'DEFAULT': [
+                    ['glance-key1', 'value1'],
+                    ['glance-key2', 'value2']]
+            }}
+        )
+        self.assertEquals(
+            cinder_sub_ctxt(),
+            {'sections': {
+                'cinder-1-section': [
+                    ['key1', 'value1']],
+                'cinder-2-section': [
+                    ['key2', 'value2']]
+
+            }, 'not-a-section': 1234}
+        )
+
+        # subrodinate supplies nothing for given config
+        glance_sub_ctxt.config_file = '/etc/glance/glance-api-paste.ini'
+        self.assertEquals(glance_sub_ctxt(), {'sections': {}})
+
+        # subordinate supplies bad input
+        self.assertEquals(foo_sub_ctxt(), {'sections': {}})
+
+    def test_os_subordinate_config_context_multiple(self):
+        relation = FakeRelation(relation_data=SUB_CONFIG_RELATION2)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.relation_units
+        nova_sub_ctxt = context.SubordinateConfigContext(
+            service=['nova', 'nova-compute'],
+            config_file='/etc/nova/nova.conf',
+            interface=['nova-ceilometer', 'neutron-plugin'],
+        )
+        self.assertEquals(
+            nova_sub_ctxt(),
+            {'sections': {
+                'DEFAULT': [
+                    ['nova-key1', 'value1'],
+                    ['nova-key2', 'value2'],
+                    ['nova-key3', 'value3'],
+                    ['nova-key4', 'value4'],
+                    ['nova-key5', 'value5'],
+                    ['nova-key6', 'value6']]
+            }}
+        )
+
+    def test_syslog_context(self):
+        self.config.side_effect = fake_config({'use-syslog': 'foo'})
+        syslog = context.SyslogContext()
+        result = syslog()
+        expected = {
+            'use_syslog': 'foo',
+        }
+        self.assertEquals(result, expected)
+
+    def test_loglevel_context_set(self):
+        self.config.side_effect = fake_config({
+            'debug': True,
+            'verbose': True,
+        })
+        syslog = context.LogLevelContext()
+        result = syslog()
+        expected = {
+            'debug': True,
+            'verbose': True,
+        }
+        self.assertEquals(result, expected)
+
+    def test_loglevel_context_unset(self):
+        self.config.side_effect = fake_config({
+            'debug': None,
+            'verbose': None,
+        })
+        syslog = context.LogLevelContext()
+        result = syslog()
+        expected = {
+            'debug': False,
+            'verbose': False,
+        }
+        self.assertEquals(result, expected)
+
+    @patch.object(context, '_calculate_workers')
+    def test_wsgi_worker_config_context(self,
+                                        _calculate_workers):
+        self.config.return_value = 2  # worker-multiplier=2
+        _calculate_workers.return_value = 8
+        service_name = 'service-name'
+        script = '/usr/bin/script'
+        ctxt = context.WSGIWorkerConfigContext(name=service_name,
+                                               script=script)
+        expect = {
+            "service_name": service_name,
+            "user": service_name,
+            "group": service_name,
+            "script": script,
+            "admin_script": None,
+            "public_script": None,
+            "processes": 8,
+            "admin_processes": 2,
+            "public_processes": 6,
+            "threads": 1,
+        }
+        self.assertEqual(expect, ctxt())
+
+    @patch.object(context, '_calculate_workers')
+    def test_wsgi_worker_config_context_user_and_group(self,
+                                                       _calculate_workers):
+        self.config.return_value = 1
+        _calculate_workers.return_value = 1
+        service_name = 'service-name'
+        script = '/usr/bin/script'
+        user = 'nova'
+        group = 'nobody'
+        ctxt = context.WSGIWorkerConfigContext(name=service_name,
+                                               user=user,
+                                               group=group,
+                                               script=script)
+        expect = {
+            "service_name": service_name,
+            "user": user,
+            "group": group,
+            "script": script,
+            "admin_script": None,
+            "public_script": None,
+            "processes": 1,
+            "admin_processes": 1,
+            "public_processes": 1,
+            "threads": 1,
+        }
+        self.assertEqual(expect, ctxt())
+
+    def test_zeromq_context_unrelated(self):
+        self.is_relation_made.return_value = False
+        self.assertEquals(context.ZeroMQContext()(), {})
+
+    def test_zeromq_context_related(self):
+        self.is_relation_made.return_value = True
+        self.relation_ids.return_value = ['zeromq-configuration:1']
+        self.related_units.return_value = ['openstack-zeromq/0']
+        self.relation_get.side_effect = ['nonce-data', 'hostname', 'redis']
+        self.assertEquals(context.ZeroMQContext()(),
+                          {'zmq_host': 'hostname',
+                           'zmq_nonce': 'nonce-data',
+                           'zmq_redis_address': 'redis'})
+
+    def test_notificationdriver_context_nomsg(self):
+        relations = {
+            'zeromq-configuration': False,
+            'amqp': False,
+        }
+        rels = fake_is_relation_made(relations=relations)
+        self.is_relation_made.side_effect = rels.rel_made
+        self.assertEquals(context.NotificationDriverContext()(),
+                          {'notifications': 'False'})
+
+    def test_notificationdriver_context_zmq_nometer(self):
+        relations = {
+            'zeromq-configuration': True,
+            'amqp': False,
+        }
+        rels = fake_is_relation_made(relations=relations)
+        self.is_relation_made.side_effect = rels.rel_made
+        self.assertEquals(context.NotificationDriverContext()(),
+                          {'notifications': 'False'})
+
+    def test_notificationdriver_context_zmq_meter(self):
+        relations = {
+            'zeromq-configuration': True,
+            'amqp': False,
+        }
+        rels = fake_is_relation_made(relations=relations)
+        self.is_relation_made.side_effect = rels.rel_made
+        self.assertEquals(context.NotificationDriverContext()(),
+                          {'notifications': 'False'})
+
+    def test_notificationdriver_context_amq(self):
+        relations = {
+            'zeromq-configuration': False,
+            'amqp': True,
+        }
+        rels = fake_is_relation_made(relations=relations)
+        self.is_relation_made.side_effect = rels.rel_made
+        self.assertEquals(context.NotificationDriverContext()(),
+                          {'notifications': 'True'})
+
+    @patch.object(context, 'psutil')
+    def test_num_cpus_xenial(self, _psutil):
+        _psutil.cpu_count.return_value = 4
+        self.assertTrue(context._num_cpus(), 4)
+
+    @patch.object(context, 'psutil')
+    def test_num_cpus_trusty(self, _psutil):
+        _psutil.NUM_CPUS = 4
+        self.assertTrue(context._num_cpus(), 4)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_float(self, _num_cpus):
+        self.config.side_effect = fake_config({
+            'worker-multiplier': 0.3
+        })
+        _num_cpus.return_value = 4
+        self.assertTrue(context._calculate_workers(), 4)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_not_quite_0(self, _num_cpus):
+        # Make sure that the multiplier evaluating to somewhere between
+        # 0 and 1 in the floating point range still has at least one
+        # worker.
+        self.config.side_effect = fake_config({
+            'worker-multiplier': 0.001
+        })
+        _num_cpus.return_value = 100
+        self.assertTrue(context._calculate_workers(), 1)
+
+    @patch.object(context, 'psutil')
+    def test_calculate_workers_0(self, _psutil):
+        self.config.side_effect = fake_config({
+            'worker-multiplier': 0
+        })
+        _psutil.cpu_count.return_value = 2
+        self.assertTrue(context._calculate_workers(), 0)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_noconfig(self, _num_cpus):
+        self.config.return_value = None
+        _num_cpus.return_value = 1
+        self.assertTrue(context._calculate_workers(), 2)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_noconfig_container(self, _num_cpus):
+        self.config.return_value = None
+        self.is_container.return_value = True
+        _num_cpus.return_value = 1
+        self.assertTrue(context._calculate_workers(), 2)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_noconfig_lotsa_cpus_container(self,
+                                                             _num_cpus):
+        self.config.return_value = None
+        self.is_container.return_value = True
+        _num_cpus.return_value = 32
+        self.assertTrue(context._calculate_workers(), 4)
+
+    @patch.object(context, '_num_cpus')
+    def test_calculate_workers_noconfig_lotsa_cpus_not_container(self,
+                                                                 _num_cpus):
+        self.config.return_value = None
+        _num_cpus.return_value = 32
+        self.assertTrue(context._calculate_workers(), 64)
+
+    @patch.object(context, '_calculate_workers', return_value=256)
+    def test_worker_context(self, calculate_workers):
+        self.assertEqual(context.WorkerConfigContext()(),
+                         {'workers': 256})
+
+    def test_apache_get_addresses_no_network_config(self):
+        self.config.side_effect = fake_config({
+            'os-internal-network': None,
+            'os-admin-network': None,
+            'os-public-network': None
+        })
+        self.resolve_address.return_value = '10.5.1.50'
+        self.unit_get.return_value = '10.5.1.50'
+
+        apache = context.ApacheSSLContext()
+        apache.external_ports = '8776'
+
+        addresses = apache.get_network_addresses()
+        expected = [('10.5.1.50', '10.5.1.50')]
+
+        self.assertEqual(addresses, expected)
+
+        self.get_address_in_network.assert_not_called()
+        self.resolve_address.assert_has_calls([
+            call(context.INTERNAL),
+            call(context.ADMIN),
+            call(context.PUBLIC)
+        ])
+
+    def test_apache_get_addresses_with_network_config(self):
+        self.config.side_effect = fake_config({
+            'os-internal-network': '10.5.1.0/24',
+            'os-admin-network': '10.5.2.0/24',
+            'os-public-network': '10.5.3.0/24',
+        })
+        _base_addresses = ['10.5.1.100',
+                           '10.5.2.100',
+                           '10.5.3.100']
+        self.get_address_in_network.side_effect = _base_addresses
+        self.resolve_address.side_effect = _base_addresses
+        self.unit_get.return_value = '10.5.1.50'
+
+        apache = context.ApacheSSLContext()
+
+        addresses = apache.get_network_addresses()
+        expected = [('10.5.1.100', '10.5.1.100'),
+                    ('10.5.2.100', '10.5.2.100'),
+                    ('10.5.3.100', '10.5.3.100')]
+        self.assertEqual(addresses, expected)
+
+        calls = [call('10.5.1.0/24', '10.5.1.50'),
+                 call('10.5.2.0/24', '10.5.1.50'),
+                 call('10.5.3.0/24', '10.5.1.50')]
+        self.get_address_in_network.assert_has_calls(calls)
+        self.resolve_address.assert_has_calls([
+            call(context.INTERNAL),
+            call(context.ADMIN),
+            call(context.PUBLIC)
+        ])
+
+    def test_apache_get_addresses_network_spaces(self):
+        self.config.side_effect = fake_config({
+            'os-internal-network': None,
+            'os-admin-network': None,
+            'os-public-network': None
+        })
+        self.network_get_primary_address.side_effect = None
+        self.network_get_primary_address.return_value = '10.5.2.50'
+        self.resolve_address.return_value = '10.5.2.100'
+        self.unit_get.return_value = '10.5.1.50'
+
+        apache = context.ApacheSSLContext()
+        apache.external_ports = '8776'
+
+        addresses = apache.get_network_addresses()
+        expected = [('10.5.2.50', '10.5.2.100')]
+
+        self.assertEqual(addresses, expected)
+
+        self.get_address_in_network.assert_not_called()
+        self.resolve_address.assert_has_calls([
+            call(context.INTERNAL),
+            call(context.ADMIN),
+            call(context.PUBLIC)
+        ])
+
+    def test_config_flag_parsing_simple(self):
+        # Standard key=value checks...
+        flags = context.config_flags_parser('key1=value1, key2=value2')
+        self.assertEqual(flags, {'key1': 'value1', 'key2': 'value2'})
+
+        # Check for multiple values to a single key
+        flags = context.config_flags_parser('key1=value1, '
+                                            'key2=value2,value3,value4')
+        self.assertEqual(flags, {'key1': 'value1',
+                                 'key2': 'value2,value3,value4'})
+
+        # Check for yaml formatted key value pairings for more complex
+        # assignment options.
+        flags = context.config_flags_parser('key1: subkey1=value1,'
+                                            'subkey2=value2')
+        self.assertEqual(flags, {'key1': 'subkey1=value1,subkey2=value2'})
+
+        # Check for good measure the ldap formats
+        test_string = ('user_tree_dn: ou=ABC General,'
+                       'ou=User Accounts,dc=example,dc=com')
+        flags = context.config_flags_parser(test_string)
+        self.assertEqual(flags, {'user_tree_dn': ('ou=ABC General,'
+                                                  'ou=User Accounts,'
+                                                  'dc=example,dc=com')})
+
+    def _fake_get_hwaddr(self, arg):
+        return MACHINE_MACS[arg]
+
+    def _fake_get_ipv4(self, arg, fatal=False):
+        return MACHINE_NICS[arg]
+
+    @patch('charmhelpers.contrib.openstack.context.config')
+    def test_no_ext_port(self, mock_config):
+        self.config.side_effect = config = fake_config({})
+        mock_config.side_effect = config
+        self.assertEquals(context.ExternalPortContext()(), {})
+
+    @patch('charmhelpers.contrib.openstack.context.list_nics')
+    @patch('charmhelpers.contrib.openstack.context.config')
+    def test_ext_port_eth(self, mock_config, mock_list_nics):
+        config = fake_config({'ext-port': 'eth1010'})
+        self.config.side_effect = config
+        mock_config.side_effect = config
+        mock_list_nics.return_value = ['eth1010']
+        self.assertEquals(context.ExternalPortContext()(),
+                          {'ext_port': 'eth1010'})
+
+    @patch('charmhelpers.contrib.openstack.context.list_nics')
+    @patch('charmhelpers.contrib.openstack.context.config')
+    def test_ext_port_eth_non_existent(self, mock_config, mock_list_nics):
+        config = fake_config({'ext-port': 'eth1010'})
+        self.config.side_effect = config
+        mock_config.side_effect = config
+        mock_list_nics.return_value = []
+        self.assertEquals(context.ExternalPortContext()(), {})
+
+    @patch('charmhelpers.contrib.openstack.context.is_phy_iface',
+           lambda arg: True)
+    @patch('charmhelpers.contrib.openstack.context.get_nic_hwaddr')
+    @patch('charmhelpers.contrib.openstack.context.list_nics')
+    @patch('charmhelpers.contrib.openstack.context.get_ipv6_addr')
+    @patch('charmhelpers.contrib.openstack.context.get_ipv4_addr')
+    @patch('charmhelpers.contrib.openstack.context.config')
+    def test_ext_port_mac(self, mock_config, mock_get_ipv4_addr,
+                          mock_get_ipv6_addr, mock_list_nics,
+                          mock_get_nic_hwaddr):
+        config_macs = ABSENT_MACS + " " + MACHINE_MACS['eth2']
+        config = fake_config({'ext-port': config_macs})
+        self.config.side_effect = config
+        mock_config.side_effect = config
+
+        mock_get_ipv4_addr.side_effect = self._fake_get_ipv4
+        mock_get_ipv6_addr.return_value = []
+        mock_list_nics.return_value = MACHINE_MACS.keys()
+        mock_get_nic_hwaddr.side_effect = self._fake_get_hwaddr
+
+        self.assertEquals(context.ExternalPortContext()(),
+                          {'ext_port': 'eth2'})
+
+        config = fake_config({'ext-port': ABSENT_MACS})
+        self.config.side_effect = config
+        mock_config.side_effect = config
+
+        self.assertEquals(context.ExternalPortContext()(), {})
+
+    @patch('charmhelpers.contrib.openstack.context.is_phy_iface',
+           lambda arg: True)
+    @patch('charmhelpers.contrib.openstack.context.get_nic_hwaddr')
+    @patch('charmhelpers.contrib.openstack.context.list_nics')
+    @patch('charmhelpers.contrib.openstack.context.get_ipv6_addr')
+    @patch('charmhelpers.contrib.openstack.context.get_ipv4_addr')
+    @patch('charmhelpers.contrib.openstack.context.config')
+    def test_ext_port_mac_one_used_nic(self, mock_config,
+                                       mock_get_ipv4_addr,
+                                       mock_get_ipv6_addr, mock_list_nics,
+                                       mock_get_nic_hwaddr):
+
+        self.relation_ids.return_value = ['neutron-plugin-api:1']
+        self.related_units.return_value = ['neutron-api/0']
+        self.relation_get.return_value = {'network-device-mtu': 1234,
+                                          'l2-population': 'False'}
+        config_macs = "%s %s" % (MACHINE_MACS['eth1'],
+                                 MACHINE_MACS['eth2'])
+
+        mock_get_ipv4_addr.side_effect = self._fake_get_ipv4
+        mock_get_ipv6_addr.return_value = []
+        mock_list_nics.return_value = MACHINE_MACS.keys()
+        mock_get_nic_hwaddr.side_effect = self._fake_get_hwaddr
+
+        config = fake_config({'ext-port': config_macs})
+        self.config.side_effect = config
+        mock_config.side_effect = config
+        self.assertEquals(context.ExternalPortContext()(),
+                          {'ext_port': 'eth2', 'ext_port_mtu': 1234})
+
+    @patch('charmhelpers.contrib.openstack.context.NeutronPortContext.'
+           'resolve_ports')
+    def test_data_port_eth(self, mock_resolve):
+        self.config.side_effect = fake_config({'data-port':
+                                               'phybr1:eth1010 '
+                                               'phybr1:eth1011'})
+        mock_resolve.side_effect = lambda ports: ['eth1010']
+        self.assertEquals(context.DataPortContext()(),
+                          {'eth1010': 'phybr1'})
+
+    @patch.object(context, 'get_nic_hwaddr')
+    @patch.object(context.NeutronPortContext, 'resolve_ports')
+    def test_data_port_mac(self, mock_resolve, mock_get_nic_hwaddr):
+        extant_mac = 'cb:23:ae:72:f2:33'
+        non_extant_mac = 'fa:16:3e:12:97:8e'
+        self.config.side_effect = fake_config({'data-port':
+                                               'phybr1:%s phybr1:%s' %
+                                               (non_extant_mac, extant_mac)})
+
+        def fake_resolve(ports):
+            resolved = []
+            for port in ports:
+                if port == extant_mac:
+                    resolved.append('eth1010')
+
+            return resolved
+
+        mock_get_nic_hwaddr.side_effect = lambda nic: extant_mac
+        mock_resolve.side_effect = fake_resolve
+
+        self.assertEquals(context.DataPortContext()(),
+                          {'eth1010': 'phybr1'})
+
+    @patch.object(context.NeutronAPIContext, '__call__', lambda *args:
+                  {'network_device_mtu': 5000})
+    @patch.object(context, 'get_nic_hwaddr', lambda inst, port: port)
+    @patch.object(context.NeutronPortContext, 'resolve_ports',
+                  lambda inst, ports: ports)
+    def test_phy_nic_mtu_context(self):
+        self.config.side_effect = fake_config({'data-port':
+                                               'phybr1:eth0'})
+        ctxt = context.PhyNICMTUContext()()
+        self.assertEqual(ctxt, {'devs': 'eth0', 'mtu': 5000})
+
+    @patch.object(context.glob, 'glob')
+    @patch.object(context.NeutronAPIContext, '__call__', lambda *args:
+                  {'network_device_mtu': 5000})
+    @patch.object(context, 'get_nic_hwaddr', lambda inst, port: port)
+    @patch.object(context.NeutronPortContext, 'resolve_ports',
+                  lambda inst, ports: ports)
+    def test_phy_nic_mtu_context_vlan(self, mock_glob):
+        self.config.side_effect = fake_config({'data-port':
+                                               'phybr1:eth0.100'})
+        mock_glob.return_value = ['/sys/class/net/eth0.100/lower_eth0']
+        ctxt = context.PhyNICMTUContext()()
+        self.assertEqual(ctxt, {'devs': 'eth0\\neth0.100', 'mtu': 5000})
+
+    @patch.object(context.glob, 'glob')
+    @patch.object(context.NeutronAPIContext, '__call__', lambda *args:
+                  {'network_device_mtu': 5000})
+    @patch.object(context, 'get_nic_hwaddr', lambda inst, port: port)
+    @patch.object(context.NeutronPortContext, 'resolve_ports',
+                  lambda inst, ports: ports)
+    def test_phy_nic_mtu_context_vlan_w_duplicate_raw(self, mock_glob):
+        self.config.side_effect = fake_config({'data-port':
+                                               'phybr1:eth0.100 '
+                                               'phybr1:eth0.200'})
+
+        def fake_glob(wcard):
+            if 'eth0.100' in wcard:
+                return ['/sys/class/net/eth0.100/lower_eth0']
+            elif 'eth0.200' in wcard:
+                return ['/sys/class/net/eth0.200/lower_eth0']
+
+            raise Exception("Unexpeced key '%s'" % (wcard))
+
+        mock_glob.side_effect = fake_glob
+        ctxt = context.PhyNICMTUContext()()
+        self.assertEqual(ctxt, {'devs': 'eth0\\neth0.100\\neth0.200',
+                                'mtu': 5000})
+
+    def test_neutronapicontext_defaults(self):
+        self.relation_ids.return_value = []
+        expected_keys = [
+            'l2_population', 'enable_dvr', 'enable_l3ha',
+            'overlay_network_type', 'network_device_mtu',
+            'enable_qos', 'enable_nsg_logging', 'global_physnet_mtu',
+            'physical_network_mtus'
+        ]
+        api_ctxt = context.NeutronAPIContext()()
+        for key in expected_keys:
+            self.assertTrue(key in api_ctxt)
+        self.assertEquals(api_ctxt['polling_interval'], 2)
+        self.assertEquals(api_ctxt['rpc_response_timeout'], 60)
+        self.assertEquals(api_ctxt['report_interval'], 30)
+        self.assertEquals(api_ctxt['enable_nsg_logging'], False)
+        self.assertEquals(api_ctxt['global_physnet_mtu'], 1500)
+        self.assertIsNone(api_ctxt['physical_network_mtus'])
+
+    def setup_neutron_api_context_relation(self, cfg):
+        self.relation_ids.return_value = ['neutron-plugin-api:1']
+        self.related_units.return_value = ['neutron-api/0']
+        # The l2-population key is used by the context as a way of checking if
+        # the api service on the other end is sending data in a recent format.
+        self.relation_get.return_value = cfg
+
+    def test_neutronapicontext_extension_drivers_qos_on(self):
+        self.setup_neutron_api_context_relation({
+            'enable-qos': 'True',
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertTrue(api_ctxt['enable_qos'])
+        self.assertEquals(api_ctxt['extension_drivers'], 'qos')
+
+    def test_neutronapicontext_extension_drivers_qos_off(self):
+        self.setup_neutron_api_context_relation({
+            'enable-qos': 'False',
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertFalse(api_ctxt['enable_qos'])
+        self.assertEquals(api_ctxt['extension_drivers'], '')
+
+    def test_neutronapicontext_extension_drivers_qos_absent(self):
+        self.setup_neutron_api_context_relation({
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertFalse(api_ctxt['enable_qos'])
+        self.assertEquals(api_ctxt['extension_drivers'], '')
+
+    def test_neutronapicontext_extension_drivers_log_off(self):
+        self.setup_neutron_api_context_relation({
+            'enable-nsg-logging': 'False',
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['extension_drivers'], '')
+
+    def test_neutronapicontext_extension_drivers_log_on(self):
+        self.setup_neutron_api_context_relation({
+            'enable-nsg-logging': 'True',
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['extension_drivers'], 'log')
+
+    def test_neutronapicontext_extension_drivers_log_qos_on(self):
+        self.setup_neutron_api_context_relation({
+            'enable-qos': 'True',
+            'enable-nsg-logging': 'True',
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['extension_drivers'], 'qos,log')
+
+    def test_neutronapicontext_firewall_group_logging_on(self):
+        self.setup_neutron_api_context_relation({
+            'enable-nfg-logging': 'True',
+            'l2-population': 'True'
+        })
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['enable_nfg_logging'], True)
+
+    def test_neutronapicontext_firewall_group_logging_off(self):
+        self.setup_neutron_api_context_relation({
+            'enable-nfg-logging': 'False',
+            'l2-population': 'True'
+        })
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['enable_nfg_logging'], False)
+
+    def test_neutronapicontext_port_forwarding_on(self):
+        self.setup_neutron_api_context_relation({
+            'enable-port-forwarding': 'True',
+            'l2-population': 'True'
+        })
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['enable_port_forwarding'], True)
+
+    def test_neutronapicontext_port_forwarding_off(self):
+        self.setup_neutron_api_context_relation({
+            'enable-port-forwarding': 'False',
+            'l2-population': 'True'
+        })
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['enable_port_forwarding'], False)
+
+    def test_neutronapicontext_string_converted(self):
+        self.setup_neutron_api_context_relation({
+            'l2-population': 'True'})
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['l2_population'], True)
+
+    def test_neutronapicontext_none(self):
+        self.relation_ids.return_value = ['neutron-plugin-api:1']
+        self.related_units.return_value = ['neutron-api/0']
+        self.relation_get.return_value = {'l2-population': 'True'}
+        api_ctxt = context.NeutronAPIContext()()
+        self.assertEquals(api_ctxt['network_device_mtu'], None)
+
+    def test_network_service_ctxt_no_units(self):
+        self.relation_ids.return_value = []
+        self.relation_ids.return_value = ['foo']
+        self.related_units.return_value = []
+        self.assertEquals(context.NetworkServiceContext()(), {})
+
+    @patch.object(context.OSContextGenerator, 'context_complete')
+    def test_network_service_ctxt_no_data(self, mock_context_complete):
+        rel = FakeRelation(QUANTUM_NETWORK_SERVICE_RELATION)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.related_units.side_effect = rel.relation_units
+        relation = FakeRelation(relation_data=QUANTUM_NETWORK_SERVICE_RELATION)
+        self.relation_get.side_effect = relation.get
+        mock_context_complete.return_value = False
+        self.assertEquals(context.NetworkServiceContext()(), {})
+
+    def test_network_service_ctxt_data(self):
+        data_result = {
+            'keystone_host': '10.5.0.1',
+            'service_port': '5000',
+            'auth_port': '20000',
+            'service_tenant': 'tenant',
+            'service_username': 'username',
+            'service_password': 'password',
+            'quantum_host': '10.5.0.2',
+            'quantum_port': '9696',
+            'quantum_url': 'http://10.5.0.2:9696/v2',
+            'region': 'aregion',
+            'service_protocol': 'http',
+            'auth_protocol': 'http',
+            'api_version': '2.0',
+        }
+        rel = FakeRelation(QUANTUM_NETWORK_SERVICE_RELATION)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.related_units.side_effect = rel.relation_units
+        relation = FakeRelation(relation_data=QUANTUM_NETWORK_SERVICE_RELATION)
+        self.relation_get.side_effect = relation.get
+        self.assertEquals(context.NetworkServiceContext()(), data_result)
+
+    def test_network_service_ctxt_data_api_version(self):
+        data_result = {
+            'keystone_host': '10.5.0.1',
+            'service_port': '5000',
+            'auth_port': '20000',
+            'service_tenant': 'tenant',
+            'service_username': 'username',
+            'service_password': 'password',
+            'quantum_host': '10.5.0.2',
+            'quantum_port': '9696',
+            'quantum_url': 'http://10.5.0.2:9696/v2',
+            'region': 'aregion',
+            'service_protocol': 'http',
+            'auth_protocol': 'http',
+            'api_version': '3',
+        }
+        rel = FakeRelation(QUANTUM_NETWORK_SERVICE_RELATION_VERSIONED)
+        self.relation_ids.side_effect = rel.relation_ids
+        self.related_units.side_effect = rel.relation_units
+        relation = FakeRelation(
+            relation_data=QUANTUM_NETWORK_SERVICE_RELATION_VERSIONED)
+        self.relation_get.side_effect = relation.get
+        self.assertEquals(context.NetworkServiceContext()(), data_result)
+
+    def test_internal_endpoint_context(self):
+        config = {'use-internal-endpoints': False}
+        self.config.side_effect = fake_config(config)
+        ctxt = context.InternalEndpointContext()
+        self.assertFalse(ctxt()['use_internal_endpoints'])
+        config = {'use-internal-endpoints': True}
+        self.config.side_effect = fake_config(config)
+        self.assertTrue(ctxt()['use_internal_endpoints'])
+
+    @patch.object(context, 'os_release')
+    def test_volume_api_context(self, mock_os_release):
+        mock_os_release.return_value = 'ocata'
+        config = {'use-internal-endpoints': False}
+        self.config.side_effect = fake_config(config)
+        ctxt = context.VolumeAPIContext('cinder-common')
+        c = ctxt()
+        self.assertEqual(c['volume_api_version'], '2')
+        self.assertEqual(c['volume_catalog_info'],
+                         'volumev2:cinderv2:publicURL')
+
+        mock_os_release.return_value = 'pike'
+        config['use-internal-endpoints'] = True
+        self.config.side_effect = fake_config(config)
+        ctxt = context.VolumeAPIContext('cinder-common')
+        c = ctxt()
+        self.assertEqual(c['volume_api_version'], '3')
+        self.assertEqual(c['volume_catalog_info'],
+                         'volumev3:cinderv3:internalURL')
+
+    def test_volume_api_context_no_pkg(self):
+        self.assertRaises(ValueError, context.VolumeAPIContext, "")
+        self.assertRaises(ValueError, context.VolumeAPIContext, None)
+
+    def test_apparmor_context_call_not_valid(self):
+        ''' Tests for the apparmor context'''
+        mock_aa_object = context.AppArmorContext()
+        # Test with invalid config
+        self.config.return_value = 'NOTVALID'
+        self.assertEquals(mock_aa_object.__call__(), None)
+
+    def test_apparmor_context_call_complain(self):
+        ''' Tests for the apparmor context'''
+        mock_aa_object = context.AppArmorContext()
+        # Test complain mode
+        self.config.return_value = 'complain'
+        self.assertEquals(mock_aa_object.__call__(),
+                          {'aa_profile_mode': 'complain',
+                           'ubuntu_release': '16.04'})
+
+    def test_apparmor_context_call_enforce(self):
+        ''' Tests for the apparmor context'''
+        mock_aa_object = context.AppArmorContext()
+        # Test enforce mode
+        self.config.return_value = 'enforce'
+        self.assertEquals(mock_aa_object.__call__(),
+                          {'aa_profile_mode': 'enforce',
+                           'ubuntu_release': '16.04'})
+
+    def test_apparmor_context_call_disable(self):
+        ''' Tests for the apparmor context'''
+        mock_aa_object = context.AppArmorContext()
+        # Test complain mode
+        self.config.return_value = 'disable'
+        self.assertEquals(mock_aa_object.__call__(),
+                          {'aa_profile_mode': 'disable',
+                           'ubuntu_release': '16.04'})
+
+    def test_apparmor_setup_complain(self):
+        ''' Tests for the apparmor setup'''
+        AA = context.AppArmorContext(profile_name='fake-aa-profile')
+        AA.install_aa_utils = MagicMock()
+        AA.manually_disable_aa_profile = MagicMock()
+        # Test complain mode
+        self.config.return_value = 'complain'
+        AA.setup_aa_profile()
+        AA.install_aa_utils.assert_called_with()
+        self.check_call.assert_called_with(['aa-complain', 'fake-aa-profile'])
+        self.assertFalse(AA.manually_disable_aa_profile.called)
+
+    def test_apparmor_setup_enforce(self):
+        ''' Tests for the apparmor setup'''
+        AA = context.AppArmorContext(profile_name='fake-aa-profile')
+        AA.install_aa_utils = MagicMock()
+        AA.manually_disable_aa_profile = MagicMock()
+        # Test enforce mode
+        self.config.return_value = 'enforce'
+        AA.setup_aa_profile()
+        self.check_call.assert_called_with(['aa-enforce', 'fake-aa-profile'])
+        self.assertFalse(AA.manually_disable_aa_profile.called)
+
+    def test_apparmor_setup_disable(self):
+        ''' Tests for the apparmor setup'''
+        AA = context.AppArmorContext(profile_name='fake-aa-profile')
+        AA.install_aa_utils = MagicMock()
+        AA.manually_disable_aa_profile = MagicMock()
+        # Test disable mode
+        self.config.return_value = 'disable'
+        AA.setup_aa_profile()
+        self.check_call.assert_called_with(['aa-disable', 'fake-aa-profile'])
+        self.assertFalse(AA.manually_disable_aa_profile.called)
+        # Test failed to disable
+        from subprocess import CalledProcessError
+        self.check_call.side_effect = CalledProcessError(0, 0, 0)
+        AA.setup_aa_profile()
+        self.check_call.assert_called_with(['aa-disable', 'fake-aa-profile'])
+        AA.manually_disable_aa_profile.assert_called_with()
+
+    @patch.object(context, 'enable_memcache')
+    @patch.object(context, 'is_ipv6_disabled')
+    def test_memcache_context_ipv6(self, _is_ipv6_disabled, _enable_memcache):
+        self.lsb_release.return_value = {'DISTRIB_CODENAME': 'xenial'}
+        _enable_memcache.return_value = True
+        _is_ipv6_disabled.return_value = False
+        config = {
+            'openstack-origin': 'distro',
+        }
+        self.config.side_effect = fake_config(config)
+        ctxt = context.MemcacheContext()
+        self.assertTrue(ctxt()['use_memcache'])
+        expect = {
+            'memcache_port': '11211',
+            'memcache_server': '::1',
+            'memcache_server_formatted': '[::1]',
+            'memcache_url': 'inet6:[::1]:11211',
+            'use_memcache': True}
+        self.assertEqual(ctxt(), expect)
+        self.lsb_release.return_value = {'DISTRIB_CODENAME': 'trusty'}
+        expect['memcache_server'] = 'ip6-localhost'
+        ctxt = context.MemcacheContext()
+        self.assertEqual(ctxt(), expect)
+
+    @patch.object(context, 'enable_memcache')
+    @patch.object(context, 'is_ipv6_disabled')
+    def test_memcache_context_ipv4(self, _is_ipv6_disabled, _enable_memcache):
+        self.lsb_release.return_value = {'DISTRIB_CODENAME': 'xenial'}
+        _enable_memcache.return_value = True
+        _is_ipv6_disabled.return_value = True
+        config = {
+            'openstack-origin': 'distro',
+        }
+        self.config.side_effect = fake_config(config)
+        ctxt = context.MemcacheContext()
+        self.assertTrue(ctxt()['use_memcache'])
+        expect = {
+            'memcache_port': '11211',
+            'memcache_server': '127.0.0.1',
+            'memcache_server_formatted': '127.0.0.1',
+            'memcache_url': '127.0.0.1:11211',
+            'use_memcache': True}
+        self.assertEqual(ctxt(), expect)
+        self.lsb_release.return_value = {'DISTRIB_CODENAME': 'trusty'}
+        expect['memcache_server'] = 'localhost'
+        ctxt = context.MemcacheContext()
+        self.assertEqual(ctxt(), expect)
+
+    @patch.object(context, 'enable_memcache')
+    def test_memcache_off_context(self, _enable_memcache):
+        _enable_memcache.return_value = False
+        config = {'openstack-origin': 'distro'}
+        self.config.side_effect = fake_config(config)
+        ctxt = context.MemcacheContext()
+        self.assertFalse(ctxt()['use_memcache'])
+        self.assertEqual(ctxt(), {'use_memcache': False})
+
+    @patch('charmhelpers.contrib.openstack.context.mkdir')
+    def test_ensure_dir_ctx(self, mkdir):
+        dirname = '/etc/keystone/policy.d'
+        owner = 'someuser'
+        group = 'somegroup'
+        perms = 0o555
+        force = False
+        ctxt = context.EnsureDirContext(dirname, owner=owner,
+                                        group=group, perms=perms,
+                                        force=force)
+        ctxt()
+        mkdir.assert_called_with(dirname, owner=owner, group=group,
+                                 perms=perms, force=force)
+
+    @patch.object(context, 'os_release')
+    def test_VersionsContext(self, os_release):
+        self.lsb_release.return_value = {'DISTRIB_CODENAME': 'xenial'}
+        os_release.return_value = 'essex'
+        self.assertEqual(
+            context.VersionsContext()(),
+            {
+                'openstack_release': 'essex',
+                'operating_system_release': 'xenial'})
+        os_release.assert_called_once_with('python-keystone')
+        self.lsb_release.assert_called_once_with()
+
+    def test_logrotate_context_unset(self):
+        logrotate = context.LogrotateContext(location='nova',
+                                             interval='weekly',
+                                             count=4)
+        ctxt = logrotate()
+        expected_ctxt = {
+            'logrotate_logs_location': 'nova',
+            'logrotate_interval': 'weekly',
+            'logrotate_count': 'rotate 4',
+        }
+        self.assertEquals(ctxt, expected_ctxt)
+
+    @patch.object(context, 'os_release')
+    def test_vendordata_static(self, os_release):
+        _vdata = '{"good": "json"}'
+        os_release.return_value = 'rocky'
+        self.config.side_effect = [_vdata, None]
+        ctxt = context.NovaVendorMetadataContext('nova-common')()
+
+        self.assertTrue(ctxt['vendor_data'])
+        self.assertEqual('StaticJSON', ctxt['vendordata_providers'])
+        self.assertNotIn('vendor_data_url', ctxt)
+
+    @patch.object(context, 'os_release')
+    def test_vendordata_dynamic(self, os_release):
+        _vdata_url = 'http://example.org/vdata'
+        os_release.return_value = 'rocky'
+
+        self.config.side_effect = [None, _vdata_url]
+        ctxt = context.NovaVendorMetadataContext('nova-common')()
+
+        self.assertEqual(_vdata_url, ctxt['vendor_data_url'])
+        self.assertEqual('DynamicJSON', ctxt['vendordata_providers'])
+        self.assertFalse(ctxt['vendor_data'])
+
+    @patch.object(context, 'os_release')
+    def test_vendordata_static_and_dynamic(self, os_release):
+        os_release.return_value = 'rocky'
+        _vdata = '{"good": "json"}'
+        _vdata_url = 'http://example.org/vdata'
+
+        self.config.side_effect = [_vdata, _vdata_url]
+        ctxt = context.NovaVendorMetadataContext('nova-common')()
+
+        self.assertTrue(ctxt['vendor_data'])
+        self.assertEqual(_vdata_url, ctxt['vendor_data_url'])
+        self.assertEqual('StaticJSON,DynamicJSON',
+                         ctxt['vendordata_providers'])
+
+    @patch.object(context, 'log')
+    @patch.object(context, 'os_release')
+    def test_vendordata_static_invalid_and_dynamic(self, os_release, log):
+        os_release.return_value = 'rocky'
+        _vdata = '{bad: json}'
+        _vdata_url = 'http://example.org/vdata'
+
+        self.config.side_effect = [_vdata, _vdata_url]
+        ctxt = context.NovaVendorMetadataContext('nova-common')()
+
+        self.assertFalse(ctxt['vendor_data'])
+        self.assertEqual(_vdata_url, ctxt['vendor_data_url'])
+        self.assertEqual('DynamicJSON', ctxt['vendordata_providers'])
+        self.assertTrue(log.called)
+
+    @patch('charmhelpers.contrib.openstack.context.log')
+    @patch.object(context, 'os_release')
+    def test_vendordata_static_and_dynamic_mitaka(self, os_release, log):
+        os_release.return_value = 'mitaka'
+        _vdata = '{"good": "json"}'
+        _vdata_url = 'http://example.org/vdata'
+
+        self.config.side_effect = [_vdata, _vdata_url]
+        ctxt = context.NovaVendorMetadataContext('nova-common')()
+
+        self.assertTrue(log.called)
+        self.assertTrue(ctxt['vendor_data'])
+        self.assertNotIn('vendor_data_url', ctxt)
+        self.assertNotIn('vendordata_providers', ctxt)
+
+    @patch.object(context, 'log')
+    def test_vendordata_json_valid(self, log):
+        _vdata = '{"good": "json"}'
+        self.config.side_effect = [_vdata]
+
+        ctxt = context.NovaVendorMetadataJSONContext('nova-common')()
+
+        self.assertEqual({'vendor_data_json': _vdata}, ctxt)
+        self.assertFalse(log.called)
+
+    @patch.object(context, 'log')
+    def test_vendordata_json_invalid(self, log):
+        _vdata = '{bad: json}'
+        self.config.side_effect = [_vdata]
+
+        ctxt = context.NovaVendorMetadataJSONContext('nova-common')()
+
+        self.assertEqual({'vendor_data_json': '{}'}, ctxt)
+        self.assertTrue(log.called)
+
+    @patch.object(context, 'log')
+    def test_vendordata_json_empty(self, log):
+        self.config.side_effect = [None]
+
+        ctxt = context.NovaVendorMetadataJSONContext('nova-common')()
+
+        self.assertEqual({'vendor_data_json': '{}'}, ctxt)
+        self.assertFalse(log.called)
+
+    @patch.object(context, 'socket')
+    def test_host_info_context(self, _socket):
+        _socket.getaddrinfo.return_value = [(None, None, None, 'myhost.mydomain', None)]
+        _socket.gethostname.return_value = 'myhost'
+        ctxt = context.HostInfoContext()()
+        self.assertEqual({
+            'host_fqdn': 'myhost.mydomain',
+            'host': 'myhost',
+            'use_fqdn_hint': False},
+            ctxt)
+        ctxt = context.HostInfoContext(use_fqdn_hint_cb=lambda: True)()
+        self.assertEqual({
+            'host_fqdn': 'myhost.mydomain',
+            'host': 'myhost',
+            'use_fqdn_hint': True},
+            ctxt)
+        # if getaddrinfo is unable to find the canonical name we should return
+        # the shortname to match the behaviour of the original implementation.
+        _socket.getaddrinfo.return_value = [(None, None, None, 'localhost', None)]
+        ctxt = context.HostInfoContext()()
+        self.assertEqual({
+            'host_fqdn': 'myhost',
+            'host': 'myhost',
+            'use_fqdn_hint': False},
+            ctxt)
+        if six.PY2:
+            _socket.error = Exception
+            _socket.getaddrinfo.side_effect = Exception
+        else:
+            _socket.getaddrinfo.side_effect = OSError
+        _socket.gethostname.return_value = 'myhost'
+        ctxt = context.HostInfoContext()()
+        self.assertEqual({
+            'host_fqdn': 'myhost',
+            'host': 'myhost',
+            'use_fqdn_hint': False},
+            ctxt)
+
+    @patch.object(context, "DHCPAgentContext")
+    def test_validate_ovs_use_veth(self, _context):
+        # No existing dhcp_agent.ini and no config
+        _context.get_existing_ovs_use_veth.return_value = None
+        _context.parse_ovs_use_veth.return_value = None
+        self.assertEqual((None, None), context.validate_ovs_use_veth())
+
+        # No existing dhcp_agent.ini and config set
+        _context.get_existing_ovs_use_veth.return_value = None
+        _context.parse_ovs_use_veth.return_value = True
+        self.assertEqual((None, None), context.validate_ovs_use_veth())
+
+        # Existing dhcp_agent.ini and no config
+        _context.get_existing_ovs_use_veth.return_value = True
+        _context.parse_ovs_use_veth.return_value = None
+        self.assertEqual((None, None), context.validate_ovs_use_veth())
+
+        # Check for agreement with existing dhcp_agent.ini
+        _context.get_existing_ovs_use_veth.return_value = False
+        _context.parse_ovs_use_veth.return_value = False
+        self.assertEqual((None, None), context.validate_ovs_use_veth())
+
+        # Check for disagreement with existing dhcp_agent.ini
+        _context.get_existing_ovs_use_veth.return_value = True
+        _context.parse_ovs_use_veth.return_value = False
+        self.assertEqual(
+            ("blocked",
+                "Mismatched existing and configured ovs-use-veth. See log."),
+            context.validate_ovs_use_veth())
+
+    def test_dhcp_agent_context(self):
+        # Defaults
+        _config = {
+            "debug": False,
+            "dns-servers": None,
+            "enable-isolated-metadata": None,
+            "enable-metadata-network": None,
+            "instance-mtu": None,
+            "ovs-use-veth": None}
+        _expect = {
+            "debug": False,
+            "dns_servers": None,
+            "enable_isolated_metadata": None,
+            "enable_metadata_network": None,
+            "instance_mtu": None,
+            "ovs_use_veth": False}
+        self.config.side_effect = fake_config(_config)
+        _get_ovs_use_veth = MagicMock()
+        _get_ovs_use_veth.return_value = False
+        ctx_object = context.DHCPAgentContext()
+        ctx_object.get_ovs_use_veth = _get_ovs_use_veth
+        ctxt = ctx_object()
+        self.assertEqual(_expect, ctxt)
+
+        # Non-defaults
+        _dns = "10.5.0.2"
+        _mtu = 8950
+        _config = {
+            "debug": True,
+            "dns-servers": _dns,
+            "enable-isolated-metadata": True,
+            "enable-metadata-network": True,
+            "instance-mtu": _mtu,
+            "ovs-use-veth": True}
+        _expect = {
+            "debug": True,
+            "dns_servers": _dns,
+            "enable_isolated_metadata": True,
+            "enable_metadata_network": True,
+            "instance_mtu": _mtu,
+            "ovs_use_veth": True}
+        self.config.side_effect = fake_config(_config)
+        _get_ovs_use_veth.return_value = True
+        ctxt = ctx_object()
+        self.assertEqual(_expect, ctxt)
+
+    def test_dhcp_agent_context_no_dns_domain(self):
+        _config = {"dns-servers": '8.8.8.8'}
+        self.config.side_effect = fake_config(_config)
+        self.relation_ids.return_value = ['rid1']
+        self.related_units.return_value = ['nova-compute/0']
+        self.relation_get.return_value = 'nova'
+        self.assertEqual(
+            context.DHCPAgentContext()(),
+            {'instance_mtu': None,
+             'dns_servers': '8.8.8.8',
+             'ovs_use_veth': False,
+             "enable_isolated_metadata": None,
+             "enable_metadata_network": None,
+             "debug": None}
+        )
+
+    def test_dhcp_agent_context_dnsmasq_flags(self):
+        _config = {'dnsmasq-flags': 'dhcp-userclass=set:ipxe,iPXE,'
+                                    'dhcp-match=set:ipxe,175,'
+                                    'server=1.2.3.4'}
+        self.config.side_effect = fake_config(_config)
+        self.assertEqual(
+            context.DHCPAgentContext()(),
+            {
+                'dnsmasq_flags': collections.OrderedDict(
+                    [('dhcp-userclass', 'set:ipxe,iPXE'),
+                     ('dhcp-match', 'set:ipxe,175'),
+                     ('server', '1.2.3.4')]),
+                'instance_mtu': None,
+                'dns_servers': None,
+                'ovs_use_veth': False,
+                "enable_isolated_metadata": None,
+                "enable_metadata_network": None,
+                "debug": None,
+            }
+        )
+
+    def test_get_ovs_use_veth(self):
+        _get_existing_ovs_use_veth = MagicMock()
+        _parse_ovs_use_veth = MagicMock()
+        ctx_object = context.DHCPAgentContext()
+        ctx_object.get_existing_ovs_use_veth = _get_existing_ovs_use_veth
+        ctx_object.parse_ovs_use_veth = _parse_ovs_use_veth
+
+        # Default
+        _get_existing_ovs_use_veth.return_value = None
+        _parse_ovs_use_veth.return_value = None
+        self.assertEqual(False, ctx_object.get_ovs_use_veth())
+
+        # Existing dhcp_agent.ini and no config
+        _get_existing_ovs_use_veth.return_value = True
+        _parse_ovs_use_veth.return_value = None
+        self.assertEqual(True, ctx_object.get_ovs_use_veth())
+
+        # No existing dhcp_agent.ini and config set
+        _get_existing_ovs_use_veth.return_value = None
+        _parse_ovs_use_veth.return_value = False
+        self.assertEqual(False, ctx_object.get_ovs_use_veth())
+
+        # Both set matching
+        _get_existing_ovs_use_veth.return_value = True
+        _parse_ovs_use_veth.return_value = True
+        self.assertEqual(True, ctx_object.get_ovs_use_veth())
+
+        # Both set mismatch: existing overrides
+        _get_existing_ovs_use_veth.return_value = False
+        _parse_ovs_use_veth.return_value = True
+        self.assertEqual(False, ctx_object.get_ovs_use_veth())
+
+        # Both set mismatch: existing overrides
+        _get_existing_ovs_use_veth.return_value = True
+        _parse_ovs_use_veth.return_value = False
+        self.assertEqual(True, ctx_object.get_ovs_use_veth())
+
+    @patch.object(context, 'config_ini')
+    @patch.object(context.os.path, 'isfile')
+    def test_get_existing_ovs_use_veth(self, _is_file, _config_ini):
+        _config = {"ovs-use-veth": None}
+        self.config.side_effect = fake_config(_config)
+
+        ctx_object = context.DHCPAgentContext()
+
+        # Default
+        _is_file.return_value = False
+        self.assertEqual(None, ctx_object.get_existing_ovs_use_veth())
+
+        # Existing
+        _is_file.return_value = True
+        _config_ini.return_value = {"DEFAULT": {"ovs_use_veth": True}}
+        self.assertEqual(True, ctx_object.get_existing_ovs_use_veth())
+
+        # Existing config_ini returns string
+        _is_file.return_value = True
+        _config_ini.return_value = {"DEFAULT": {"ovs_use_veth": "False"}}
+        self.assertEqual(False, ctx_object.get_existing_ovs_use_veth())
+
+    @patch.object(context, 'bool_from_string')
+    def test_parse_ovs_use_veth(self, _bool_from_string):
+        _config = {"ovs-use-veth": None}
+        self.config.side_effect = fake_config(_config)
+
+        ctx_object = context.DHCPAgentContext()
+
+        # Unset
+        self.assertEqual(None, ctx_object.parse_ovs_use_veth())
+        _bool_from_string.assert_not_called()
+
+        # Consider empty string unset
+        _config = {"ovs-use-veth": ""}
+        self.config.side_effect = fake_config(_config)
+        self.assertEqual(None, ctx_object.parse_ovs_use_veth())
+        _bool_from_string.assert_not_called()
+
+        # Lower true
+        _bool_from_string.return_value = True
+        _config = {"ovs-use-veth": "true"}
+        self.config.side_effect = fake_config(_config)
+        self.assertEqual(True, ctx_object.parse_ovs_use_veth())
+        _bool_from_string.assert_called_with("true")
+
+        # Lower false
+        _bool_from_string.return_value = False
+        _bool_from_string.reset_mock()
+        _config = {"ovs-use-veth": "false"}
+        self.config.side_effect = fake_config(_config)
+        self.assertEqual(False, ctx_object.parse_ovs_use_veth())
+        _bool_from_string.assert_called_with("false")
+
+        # Upper True
+        _bool_from_string.return_value = True
+        _bool_from_string.reset_mock()
+        _config = {"ovs-use-veth": "True"}
+        self.config.side_effect = fake_config(_config)
+        self.assertEqual(True, ctx_object.parse_ovs_use_veth())
+        _bool_from_string.assert_called_with("True")
+
+        # Invalid
+        _bool_from_string.reset_mock()
+        _config = {"ovs-use-veth": "Invalid"}
+        self.config.side_effect = fake_config(_config)
+        _bool_from_string.side_effect = ValueError
+        with self.assertRaises(ValueError):
+            ctx_object.parse_ovs_use_veth()
+            _bool_from_string.assert_called_with("Invalid")
+
+
+class MockPCIDevice(object):
+    """Simple wrapper to mock pci.PCINetDevice class"""
+    def __init__(self, address):
+        self.pci_address = address
+
+
+TEST_CPULIST_1 = "0-3"
+TEST_CPULIST_2 = "0-7,16-23"
+TEST_CPULIST_3 = "0,4,8,12,16,20,24"
+DPDK_DATA_PORTS = (
+    "br-phynet3:fe:16:41:df:23:fe "
+    "br-phynet1:fe:16:41:df:23:fd "
+    "br-phynet2:fe:f2:d0:45:dc:66"
+)
+BOND_MAPPINGS = (
+    "bond0:fe:16:41:df:23:fe "
+    "bond0:fe:16:41:df:23:fd "
+    "bond1:fe:f2:d0:45:dc:66"
+)
+PCI_DEVICE_MAP = {
+    'fe:16:41:df:23:fd': MockPCIDevice('0000:00:1c.0'),
+    'fe:16:41:df:23:fe': MockPCIDevice('0000:00:1d.0'),
+}
+
+
+class TestDPDKUtils(tests.utils.BaseTestCase):
+
+    def test_resolve_pci_from_mapping_config(self):
+        # FIXME: need to mock out the unit key value store
+        self.patch_object(context, 'config')
+        self.config.side_effect = lambda x: {
+            'data-port': DPDK_DATA_PORTS,
+            'dpdk-bond-mappings': BOND_MAPPINGS,
+        }.get(x)
+        _pci_devices = Mock()
+        _pci_devices.get_device_from_mac.side_effect = PCI_DEVICE_MAP.get
+        self.patch_object(context, 'pci')
+        self.pci.PCINetDevices.return_value = _pci_devices
+        self.assertDictEqual(
+            context.resolve_pci_from_mapping_config('data-port'),
+            {
+                '0000:00:1c.0': context.EntityMac(
+                    'br-phynet1', 'fe:16:41:df:23:fd'),
+                '0000:00:1d.0': context.EntityMac(
+                    'br-phynet3', 'fe:16:41:df:23:fe'),
+            })
+        self.config.assert_called_once_with('data-port')
+        self.config.reset_mock()
+        self.assertDictEqual(
+            context.resolve_pci_from_mapping_config('dpdk-bond-mappings'),
+            {
+                '0000:00:1c.0': context.EntityMac(
+                    'bond0', 'fe:16:41:df:23:fd'),
+                '0000:00:1d.0': context.EntityMac(
+                    'bond0', 'fe:16:41:df:23:fe'),
+            })
+        self.config.assert_called_once_with('dpdk-bond-mappings')
+
+
+DPDK_PATCH = [
+    'resolve_pci_from_mapping_config',
+    'glob',
+]
+
+NUMA_CORES_SINGLE = {
+    '0': [0, 1, 2, 3]
+}
+
+NUMA_CORES_MULTI = {
+    '0': [0, 1, 2, 3],
+    '1': [4, 5, 6, 7]
+}
+
+
+class TestOVSDPDKDeviceContext(tests.utils.BaseTestCase):
+
+    def setUp(self):
+        super(TestOVSDPDKDeviceContext, self).setUp()
+        self.patch_object(context, 'config')
+        self.config.side_effect = lambda x: {
+            'enable-dpdk': True,
+        }
+        self.target = context.OVSDPDKDeviceContext()
+
+    def patch_target(self, attr, return_value=None):
+        mocked = mock.patch.object(self.target, attr)
+        self._patches[attr] = mocked
+        started = mocked.start()
+        started.return_value = return_value
+        self._patches_start[attr] = started
+        setattr(self, attr, started)
+
+    def test__parse_cpu_list(self):
+        self.assertEqual(self.target._parse_cpu_list(TEST_CPULIST_1),
+                         [0, 1, 2, 3])
+        self.assertEqual(self.target._parse_cpu_list(TEST_CPULIST_2),
+                         [0, 1, 2, 3, 4, 5, 6, 7,
+                          16, 17, 18, 19, 20, 21, 22, 23])
+        self.assertEqual(self.target._parse_cpu_list(TEST_CPULIST_3),
+                         [0, 4, 8, 12, 16, 20, 24])
+
+    def test__numa_node_cores(self):
+        self.patch_target('_parse_cpu_list')
+        self._parse_cpu_list.return_value = [0, 1, 2, 3]
+        self.patch_object(context, 'glob')
+        self.glob.glob.return_value = [
+            '/sys/devices/system/node/node0'
+        ]
+        with patch_open() as (_, mock_file):
+            mock_file.read.return_value = TEST_CPULIST_1
+            self.target._numa_node_cores()
+            self.assertEqual(self.target._numa_node_cores(),
+                             {'0': [0, 1, 2, 3]})
+        self.glob.glob.assert_called_with('/sys/devices/system/node/node*')
+        self._parse_cpu_list.assert_called_with(TEST_CPULIST_1)
+
+    def test_device_whitelist(self):
+        """Test device whitelist generation"""
+        self.patch_object(
+            context, 'resolve_pci_from_mapping_config',
+            return_value=collections.OrderedDict(
+                sorted({
+                    '0000:00:1c.0': 'br-data',
+                    '0000:00:1d.0': 'br-data',
+                }.items())))
+        self.assertEqual(self.target.device_whitelist(),
+                         '-w 0000:00:1c.0 -w 0000:00:1d.0')
+        self.resolve_pci_from_mapping_config.assert_has_calls([
+            call('data-port'),
+            call('dpdk-bond-mappings'),
+        ])
+
+    def test_socket_memory(self):
+        """Test socket memory configuration"""
+        self.patch_object(context, 'glob')
+        self.patch_object(context, 'config')
+        self.config.side_effect = lambda x: {
+            'dpdk-socket-memory': 1024,
+        }.get(x)
+        self.glob.glob.return_value = ['a']
+        self.assertEqual(self.target.socket_memory(),
+                         '1024')
+
+        self.glob.glob.return_value = ['a', 'b']
+        self.assertEqual(self.target.socket_memory(),
+                         '1024,1024')
+
+        self.config.side_effect = lambda x: {
+            'dpdk-socket-memory': 2048,
+        }.get(x)
+        self.assertEqual(self.target.socket_memory(),
+                         '2048,2048')
+
+    def test_cpu_mask(self):
+        """Test generation of hex CPU masks"""
+        self.patch_target('_numa_node_cores')
+        self._numa_node_cores.return_value = NUMA_CORES_SINGLE
+        self.config.side_effect = lambda x: {
+            'dpdk-socket-cores': 1,
+        }.get(x)
+        self.assertEqual(self.target.cpu_mask(), '0x01')
+
+        self._numa_node_cores.return_value = NUMA_CORES_MULTI
+        self.assertEqual(self.target.cpu_mask(), '0x11')
+
+        self.config.side_effect = lambda x: {
+            'dpdk-socket-cores': 2,
+        }.get(x)
+        self.assertEqual(self.target.cpu_mask(), '0x33')
+
+    def test_context_no_devices(self):
+        """Ensure that DPDK is disable when no devices detected"""
+        self.patch_object(context, 'resolve_pci_from_mapping_config')
+        self.resolve_pci_from_mapping_config.return_value = {}
+        self.assertEqual(self.target(), {})
+        self.resolve_pci_from_mapping_config.assert_has_calls([
+            call('data-port'),
+            call('dpdk-bond-mappings'),
+        ])
+
+    def test_context_devices(self):
+        """Ensure DPDK is enabled when devices are detected"""
+        self.patch_target('_numa_node_cores')
+        self.patch_target('devices')
+        self.devices.return_value = collections.OrderedDict(sorted({
+            '0000:00:1c.0': 'br-data',
+            '0000:00:1d.0': 'br-data',
+        }.items()))
+        self._numa_node_cores.return_value = NUMA_CORES_SINGLE
+        self.patch_object(context, 'glob')
+        self.glob.glob.return_value = ['a']
+        self.config.side_effect = lambda x: {
+            'dpdk-socket-cores': 1,
+            'dpdk-socket-memory': 1024,
+            'enable-dpdk': True,
+        }.get(x)
+        self.assertEqual(self.target(), {
+            'cpu_mask': '0x01',
+            'device_whitelist': '-w 0000:00:1c.0 -w 0000:00:1d.0',
+            'dpdk_enabled': True,
+            'socket_memory': '1024'
+        })
+
+
+class TestDPDKDeviceContext(tests.utils.BaseTestCase):
+
+    _dpdk_bridges = {
+        '0000:00:1c.0': 'br-data',
+        '0000:00:1d.0': 'br-physnet1',
+    }
+    _dpdk_bonds = {
+        '0000:00:1c.1': 'dpdk-bond0',
+        '0000:00:1d.1': 'dpdk-bond0',
+    }
+
+    def setUp(self):
+        super(TestDPDKDeviceContext, self).setUp()
+        self.target = context.DPDKDeviceContext()
+        self.patch_object(context, 'resolve_pci_from_mapping_config')
+        self.resolve_pci_from_mapping_config.side_effect = [
+            self._dpdk_bridges,
+            self._dpdk_bonds,
+        ]
+
+    def test_context(self):
+        self.patch_object(context, 'config')
+        self.config.side_effect = lambda x: {
+            'dpdk-driver': 'uio_pci_generic',
+        }.get(x)
+        devices = copy.deepcopy(self._dpdk_bridges)
+        devices.update(self._dpdk_bonds)
+        self.assertEqual(self.target(), {
+            'devices': devices,
+            'driver': 'uio_pci_generic'
+        })
+        self.config.assert_called_with('dpdk-driver')
+
+    def test_context_none_driver(self):
+        self.patch_object(context, 'config')
+        self.config.return_value = None
+        self.assertEqual(self.target(), {})
+        self.config.assert_called_with('dpdk-driver')
+
+
+class TestBridgePortInterfaceMap(tests.utils.BaseTestCase):
+
+    def test__init__(self):
+        self.maxDiff = None
+        self.patch_object(context, 'config')
+        # system with three interfaces (eth0, eth1 and eth2) where
+        # eth0 and eth1 is part of linux bond bond0.
+        # Bridge mapping br-ex:eth2, br-provider1:bond0
+        self.config.side_effect = lambda x: {
+            'data-port': (
+                'br-ex:eth2 '
+                'br-provider1:00:00:5e:00:00:41 '
+                'br-provider1:00:00:5e:00:00:40'),
+            'dpdk-bond-mappings': '',
+        }.get(x)
+        self.patch_object(context, 'resolve_pci_from_mapping_config')
+        self.resolve_pci_from_mapping_config.side_effect = [
+            {
+                '0000:00:1c.0': context.EntityMac(
+                    'br-ex', '00:00:5e:00:00:42'),
+            },
+            {},
+        ]
+        self.patch_object(context, 'list_nics')
+        self.list_nics.return_value = ['bond0', 'eth0', 'eth1', 'eth2']
+        self.patch_object(context, 'is_phy_iface')
+        self.is_phy_iface.side_effect = lambda x: True if not x.startswith(
+            'bond') else False
+        self.patch_object(context, 'get_bond_master')
+        self.get_bond_master.side_effect = lambda x: 'bond0' if x in (
+            'eth0', 'eth1') else None
+        self.patch_object(context, 'get_nic_hwaddr')
+        self.get_nic_hwaddr.side_effect = lambda x: {
+            'bond0': '00:00:5e:00:00:24',
+            'eth0': '00:00:5e:00:00:40',
+            'eth1': '00:00:5e:00:00:41',
+            'eth2': '00:00:5e:00:00:42',
+        }.get(x)
+        bpi = context.BridgePortInterfaceMap()
+        self.maxDiff = None
+        expect = {
+            'br-provider1': {
+                'bond0': {
+                    'bond0': {
+                        'type': 'system',
+                    },
+                },
+            },
+            'br-ex': {
+                'eth2': {
+                    'eth2': {
+                        'type': 'system',
+                    },
+                },
+            },
+        }
+        self.assertDictEqual(bpi._map, expect)
+        # do it again but this time use the linux bond name instead of mac
+        # addresses.
+        self.config.side_effect = lambda x: {
+            'data-port': (
+                'br-ex:eth2 '
+                'br-provider1:bond0'),
+            'dpdk-bond-mappings': '',
+        }.get(x)
+        bpi = context.BridgePortInterfaceMap()
+        self.assertDictEqual(bpi._map, expect)
+        # and if a user asks for a purely virtual interface let's not stop them
+        expect = {
+            'br-provider1': {
+                'bond0.1234': {
+                    'bond0.1234': {
+                        'type': 'system',
+                    },
+                },
+            },
+            'br-ex': {
+                'eth2': {
+                    'eth2': {
+                        'type': 'system',
+                    },
+                },
+            },
+        }
+        self.config.side_effect = lambda x: {
+            'data-port': (
+                'br-ex:eth2 '
+                'br-provider1:bond0.1234'),
+            'dpdk-bond-mappings': '',
+        }.get(x)
+        bpi = context.BridgePortInterfaceMap()
+        self.assertDictEqual(bpi._map, expect)
+        # system with three interfaces (eth0, eth1 and eth2) where we should
+        # enable DPDK and create OVS bond of eth0 and eth1.
+        # Bridge mapping br-ex:eth2 br-provider1:dpdk-bond0
+        self.config.side_effect = lambda x: {
+            'enable-dpdk': True,
+            'data-port': (
+                'br-ex:00:00:5e:00:00:42 '
+                'br-provider1:dpdk-bond0'),
+            'dpdk-bond-mappings': (
+                'dpdk-bond0:00:00:5e:00:00:40 '
+                'dpdk-bond0:00:00:5e:00:00:41'),
+        }.get(x)
+        self.resolve_pci_from_mapping_config.side_effect = [
+            {
+                '0000:00:1c.0': context.EntityMac(
+                    'br-ex', '00:00:5e:00:00:42'),
+            },
+            {
+                '0000:00:1d.0': context.EntityMac(
+                    'dpdk-bond0', '00:00:5e:00:00:40'),
+                '0000:00:1e.0': context.EntityMac(
+                    'dpdk-bond0', '00:00:5e:00:00:41'),
+            },
+        ]
+        # once devices are bound to DPDK they disappear from the system list
+        # of interfaces
+        self.list_nics.return_value = []
+        bpi = context.BridgePortInterfaceMap(global_mtu=1500)
+        self.assertDictEqual(bpi._map, {
+            'br-provider1': {
+                'dpdk-bond0': {
+                    'dpdk-600a59e': {
+                        'pci-address': '0000:00:1d.0',
+                        'type': 'dpdk',
+                        'mtu-request': '1500',
+                    },
+                    'dpdk-5fc1d91': {
+                        'pci-address': '0000:00:1e.0',
+                        'type': 'dpdk',
+                        'mtu-request': '1500',
+                    },
+                },
+            },
+            'br-ex': {
+                'dpdk-6204d33': {
+                    'dpdk-6204d33': {
+                        'pci-address': '0000:00:1c.0',
+                        'type': 'dpdk',
+                        'mtu-request': '1500',
+                    },
+                },
+            },
+        })
+
+    def test_add_interface(self):
+        self.patch_object(context, 'config')
+        self.config.return_value = ''
+        ctx = context.BridgePortInterfaceMap()
+        ctx.add_interface("br1", "bond1", "port1", ctx.interface_type.dpdk,
+                          "00:00:00:00:00:01", 1500)
+        ctx.add_interface("br1", "bond1", "port2", ctx.interface_type.dpdk,
+                          "00:00:00:00:00:02", 1500)
+        ctx.add_interface("br1", "bond2", "port3", ctx.interface_type.dpdk,
+                          "00:00:00:00:00:03", 1500)
+        ctx.add_interface("br1", "bond2", "port4", ctx.interface_type.dpdk,
+                          "00:00:00:00:00:04", 1500)
+
+        expected = (
+            'br1', {
+                'bond1': {
+                    'port1': {
+                        'type': 'dpdk',
+                        'pci-address': '00:00:00:00:00:01',
+                        'mtu-request': '1500',
+                    },
+                    'port2': {
+                        'type': 'dpdk',
+                        'pci-address': '00:00:00:00:00:02',
+                        'mtu-request': '1500',
+                    },
+                },
+                'bond2': {
+                    'port3': {
+                        'type': 'dpdk',
+                        'pci-address': '00:00:00:00:00:03',
+                        'mtu-request': '1500',
+                    },
+                    'port4': {
+                        'type': 'dpdk',
+                        'pci-address': '00:00:00:00:00:04',
+                        'mtu-request': '1500',
+                    },
+                },
+            },
+        )
+        for br, bonds in ctx.items():
+            self.maxDiff = None
+            self.assertEqual(br, expected[0])
+            self.assertDictEqual(bonds, expected[1])
+
+
+class TestBondConfig(tests.utils.BaseTestCase):
+
+    def test_get_bond_config(self):
+        self.patch_object(context, 'config')
+        self.config.side_effect = lambda x: {
+            'dpdk-bond-config': ':active-backup bond1:balance-slb:off',
+        }.get(x)
+        bonds_config = context.BondConfig()
+
+        self.assertEqual(bonds_config.get_bond_config('bond0'),
+                         {'mode': 'active-backup',
+                          'lacp': 'active',
+                          'lacp-time': 'fast'
+                          })
+        self.assertEqual(bonds_config.get_bond_config('bond1'),
+                         {'mode': 'balance-slb',
+                          'lacp': 'off',
+                          'lacp-time': 'fast'
+                          })
+
+
+class TestSRIOVContext(tests.utils.BaseTestCase):
+
+    class ObjectView(object):
+
+        def __init__(self, _dict):
+            self.__dict__ = _dict
+
+    def test___init__(self):
+        self.patch_object(context.pci, 'PCINetDevices')
+        pci_devices = self.ObjectView({
+            'pci_devices': [
+                self.ObjectView({
+                    'sriov': True,
+                    'interface_name': 'eth0',
+                    'sriov_totalvfs': 16,
+                }),
+                self.ObjectView({
+                    'sriov': True,
+                    'interface_name': 'eth1',
+                    'sriov_totalvfs': 32,
+                }),
+                self.ObjectView({
+                    'sriov': False,
+                    'interface_name': 'eth2',
+                }),
+            ]
+        })
+        self.PCINetDevices.return_value = pci_devices
+        self.patch_object(context, 'config')
+        # auto sets up numvfs = totalvfs
+        self.config.return_value = {
+            'sriov-numvfs': 'auto',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth0': 16,
+            'eth1': 32,
+        })
+        # when sriov-device-mappings is used only listed devices are set up
+        self.config.return_value = {
+            'sriov-numvfs': 'auto',
+            'sriov-device-mappings': 'physnet1:eth0',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth0': 16,
+        })
+        self.config.return_value = {
+            'sriov-numvfs': 'eth0:8',
+            'sriov-device-mappings': 'physnet1:eth0',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth0': 8,
+        })
+        self.config.return_value = {
+            'sriov-numvfs': 'eth1:8',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth1': 8,
+        })
+        # setting a numvfs value higher than a nic supports will revert to
+        # the nics max value
+        self.config.return_value = {
+            'sriov-numvfs': 'eth1:64',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth1': 32,
+        })
+        # devices listed in sriov-numvfs have precedence over
+        # sriov-device-mappings and the limiter still works when both are used
+        self.config.return_value = {
+            'sriov-numvfs': 'eth1:64',
+            'sriov-device-mappings': 'physnet:eth0',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth1': 32,
+        })
+        # alternate config keys have effect
+        self.config.return_value = {
+            'my-own-sriov-numvfs': 'auto',
+            'my-own-sriov-device-mappings': 'physnet1:eth0',
+        }
+        self.assertDictEqual(
+            context.SRIOVContext(
+                numvfs_key='my-own-sriov-numvfs',
+                device_mappings_key='my-own-sriov-device-mappings')(),
+            {
+                'eth0': 16,
+            })
+        # blanket configuration works and respects limits
+        self.config.return_value = {
+            'sriov-numvfs': '24',
+        }
+        self.assertDictEqual(context.SRIOVContext()(), {
+            'eth0': 16,
+            'eth1': 24,
+        })
+
+    def test___call__(self):
+        self.patch_object(context.pci, 'PCINetDevices')
+        pci_devices = self.ObjectView({'pci_devices': []})
+        self.PCINetDevices.return_value = pci_devices
+        self.patch_object(context, 'config')
+        self.config.return_value = {'sriov-numvfs': 'auto'}
+        ctxt_obj = context.SRIOVContext()
+        ctxt_obj._map = {}
+        self.assertDictEqual(ctxt_obj(), {})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..b30dc31f69e12d8687974d8af6346fb745a04e9d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_templating.py
@@ -0,0 +1,374 @@
+
+import os
+import unittest
+
+from mock import patch, call, MagicMock
+
+import charmhelpers.contrib.openstack.templating as templating
+
+from jinja2.exceptions import TemplateNotFound
+
+import six
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+
+class FakeContextGenerator(object):
+    interfaces = None
+
+    def set(self, interfaces, context):
+        self.interfaces = interfaces
+        self.context = context
+
+    def __call__(self):
+        return self.context
+
+
+class FakeLoader(object):
+    def set(self, template):
+        self.template = template
+
+    def get(self, name):
+        return self.template
+
+
+class MockFSLoader(object):
+    def __init__(self, dirs):
+        self.searchpath = [dirs]
+
+
+class MockChoiceLoader(object):
+    def __init__(self, loaders):
+        self.loaders = loaders
+
+
+def MockTemplate():
+    templ = MagicMock()
+    templ.render = MagicMock()
+    return templ
+
+
+class TemplatingTests(unittest.TestCase):
+    def setUp(self):
+        path = os.path.dirname(__file__)
+        self.loader = FakeLoader()
+        self.context = FakeContextGenerator()
+
+        self.addCleanup(patch.object(templating, 'apt_install').start().stop())
+        self.addCleanup(patch.object(templating, 'log').start().stop())
+
+        templating.FileSystemLoader = MockFSLoader
+        templating.ChoiceLoader = MockChoiceLoader
+        templating.Environment = MagicMock
+
+        self.renderer = templating.OSConfigRenderer(templates_dir=path,
+                                                    openstack_release='folsom')
+
+    @patch.object(templating, 'apt_install')
+    def test_initializing_a_render_ensures_jinja2_present(self, apt):
+        '''Creatinga new renderer object installs jinja2 if needed'''
+        # temp. undo the patching from setUp
+        templating.FileSystemLoader = None
+        templating.ChoiceLoader = None
+        templating.Environment = None
+        templating.OSConfigRenderer(templates_dir='/tmp',
+                                    openstack_release='foo')
+        templating.FileSystemLoader = MockFSLoader
+        templating.ChoiceLoader = MockChoiceLoader
+        templating.Environment = MagicMock
+        if six.PY2:
+            apt.assert_called_with('python-jinja2')
+        else:
+            apt.assert_called_with('python3-jinja2')
+
+    def test_create_renderer_invalid_templates_dir(self):
+        '''Ensure OSConfigRenderer checks templates_dir'''
+        self.assertRaises(templating.OSConfigException,
+                          templating.OSConfigRenderer,
+                          templates_dir='/tmp/foooo0',
+                          openstack_release='grizzly')
+
+    def test_render_unregistered_config(self):
+        '''Ensure cannot render an unregistered config file'''
+        self.assertRaises(templating.OSConfigException,
+                          self.renderer.render,
+                          config_file='/tmp/foo')
+
+    def test_write_unregistered_config(self):
+        '''Ensure cannot write an unregistered config file'''
+        self.assertRaises(templating.OSConfigException,
+                          self.renderer.write,
+                          config_file='/tmp/foo')
+
+    def test_render_complete_context(self):
+        '''It renders a template when provided a complete context'''
+        self.loader.set('{{ foo }}')
+        self.context.set(interfaces=['fooservice'], context={'foo': 'bar'})
+        self.renderer.register('/tmp/foo', [self.context])
+        with patch.object(self.renderer, '_get_template') as _get_t:
+            fake_tmpl = MockTemplate()
+            _get_t.return_value = fake_tmpl
+            self.renderer.render('/tmp/foo')
+            fake_tmpl.render.assert_called_with(self.context())
+        self.assertIn('fooservice', self.renderer.complete_contexts())
+
+    def test_render_incomplete_context_with_template(self):
+        '''It renders a template when provided an incomplete context'''
+        self.context.set(interfaces=['fooservice'], context={})
+        self.renderer.register('/tmp/foo', [self.context])
+        with patch.object(self.renderer, '_get_template') as _get_t:
+            fake_tmpl = MockTemplate()
+            _get_t.return_value = fake_tmpl
+            self.renderer.render('/tmp/foo')
+            fake_tmpl.render.assert_called_with({})
+            self.assertNotIn('fooservice', self.renderer.complete_contexts())
+
+    def test_render_template_registered_but_not_found(self):
+        '''It loads a template by basename of config file first'''
+        path = os.path.dirname(__file__)
+        renderer = templating.OSConfigRenderer(templates_dir=path,
+                                               openstack_release='folsom')
+        e = TemplateNotFound('')
+        renderer._get_template = MagicMock()
+        renderer._get_template.side_effect = e
+        renderer.register('/etc/nova/nova.conf', contexts=[])
+        self.assertRaises(
+            TemplateNotFound, renderer.render, '/etc/nova/nova.conf')
+
+    def test_render_template_by_basename_first(self):
+        '''It loads a template by basename of config file first'''
+        path = os.path.dirname(__file__)
+        renderer = templating.OSConfigRenderer(templates_dir=path,
+                                               openstack_release='folsom')
+        renderer._get_template = MagicMock()
+        renderer.register('/etc/nova/nova.conf', contexts=[])
+        renderer.render('/etc/nova/nova.conf')
+        self.assertEquals(1, len(renderer._get_template.call_args_list))
+        self.assertEquals(
+            [call('nova.conf')], renderer._get_template.call_args_list)
+
+    def test_render_template_by_munged_full_path_last(self):
+        '''It loads a template by full path of config file second'''
+        path = os.path.dirname(__file__)
+        renderer = templating.OSConfigRenderer(templates_dir=path,
+                                               openstack_release='folsom')
+        tmp = MagicMock()
+        tmp.render = MagicMock()
+        e = TemplateNotFound('')
+        renderer._get_template = MagicMock()
+        renderer._get_template.side_effect = [e, tmp]
+        renderer.register('/etc/nova/nova.conf', contexts=[])
+        renderer.render('/etc/nova/nova.conf')
+        self.assertEquals(2, len(renderer._get_template.call_args_list))
+        self.assertEquals(
+            [call('nova.conf'), call('etc_nova_nova.conf')],
+            renderer._get_template.call_args_list)
+
+    def test_render_template_by_basename(self):
+        '''It renders template if it finds it by config file basename'''
+
+    @patch(builtin_open)
+    @patch.object(templating, 'get_loader')
+    def test_write_out_config(self, loader, _open):
+        '''It writes a templated config when provided a complete context'''
+        self.context.set(interfaces=['fooservice'], context={'foo': 'bar'})
+        self.renderer.register('/tmp/foo', [self.context])
+        with patch.object(self.renderer, '_get_template') as _get_t:
+            fake_tmpl = MockTemplate()
+            _get_t.return_value = fake_tmpl
+            self.renderer.write('/tmp/foo')
+            _open.assert_called_with('/tmp/foo', 'wb')
+
+    def test_write_all(self):
+        '''It writes out all configuration files at once'''
+        self.context.set(interfaces=['fooservice'], context={'foo': 'bar'})
+        self.renderer.register('/tmp/foo', [self.context])
+        self.renderer.register('/tmp/bar', [self.context])
+        ex_calls = [
+            call('/tmp/bar'),
+            call('/tmp/foo'),
+        ]
+        with patch.object(self.renderer, 'write') as _write:
+            self.renderer.write_all()
+            self.assertEquals(sorted(ex_calls), sorted(_write.call_args_list))
+            pass
+
+    @patch.object(templating, 'get_loader')
+    def test_reset_template_loader_for_new_os_release(self, loader):
+        self.loader.set('')
+        self.context.set(interfaces=['fooservice'], context={})
+        loader.return_value = MockFSLoader('/tmp/foo')
+        self.renderer.register('/tmp/foo', [self.context])
+        self.renderer.render('/tmp/foo')
+        loader.assert_called_with(os.path.dirname(__file__), 'folsom')
+        self.renderer.set_release(openstack_release='grizzly')
+        self.renderer.render('/tmp/foo')
+        loader.assert_called_with(os.path.dirname(__file__), 'grizzly')
+
+    @patch.object(templating, 'get_loader')
+    def test_incomplete_context_not_reported_complete(self, loader):
+        '''It does not recognize an incomplete context as a complete context'''
+        self.context.set(interfaces=['fooservice'], context={})
+        self.renderer.register('/tmp/foo', [self.context])
+        self.assertNotIn('fooservice', self.renderer.complete_contexts())
+
+    @patch.object(templating, 'get_loader')
+    def test_complete_context_reported_complete(self, loader):
+        '''It recognizes a complete context as a complete context'''
+        self.context.set(interfaces=['fooservice'], context={'foo': 'bar'})
+        self.renderer.register('/tmp/foo', [self.context])
+        self.assertIn('fooservice', self.renderer.complete_contexts())
+
+    @patch('os.path.isdir')
+    def test_get_loader_no_templates_dir(self, isdir):
+        '''Ensure getting loader fails with no template dir'''
+        isdir.return_value = False
+        self.assertRaises(templating.OSConfigException,
+                          templating.get_loader,
+                          templates_dir='/tmp/foo', os_release='foo')
+
+    @patch('os.path.isdir')
+    def test_get_loader_all_search_paths(self, isdir):
+        '''Ensure loader reverse searches of all release template dirs'''
+        isdir.return_value = True
+        choice_loader = templating.get_loader('/tmp/foo',
+                                              os_release='icehouse')
+        dirs = [l.searchpath for l in choice_loader.loaders]
+
+        common_tmplts = os.path.join(os.path.dirname(templating.__file__),
+                                     'templates')
+        expected = [['/tmp/foo/icehouse'],
+                    ['/tmp/foo/havana'],
+                    ['/tmp/foo/grizzly'],
+                    ['/tmp/foo/folsom'],
+                    ['/tmp/foo/essex'],
+                    ['/tmp/foo/diablo'],
+                    ['/tmp/foo'],
+                    [common_tmplts]]
+        self.assertEquals(dirs, expected)
+
+    @patch('os.path.isdir')
+    def test_get_loader_some_search_paths(self, isdir):
+        '''Ensure loader reverse searches of some release template dirs'''
+        isdir.return_value = True
+        choice_loader = templating.get_loader('/tmp/foo', os_release='grizzly')
+        dirs = [l.searchpath for l in choice_loader.loaders]
+
+        common_tmplts = os.path.join(os.path.dirname(templating.__file__),
+                                     'templates')
+
+        expected = [['/tmp/foo/grizzly'],
+                    ['/tmp/foo/folsom'],
+                    ['/tmp/foo/essex'],
+                    ['/tmp/foo/diablo'],
+                    ['/tmp/foo'],
+                    [common_tmplts]]
+        self.assertEquals(dirs, expected)
+
+    def test_register_template_with_list_of_contexts(self):
+        '''Ensure registering a template with a list of context generators'''
+        def _c1():
+            pass
+
+        def _c2():
+            pass
+        tmpl = templating.OSConfigTemplate(config_file='/tmp/foo',
+                                           contexts=[_c1, _c2])
+        self.assertEquals(tmpl.contexts, [_c1, _c2])
+
+    def test_register_template_with_single_context(self):
+        '''Ensure registering a template with a single non-list context'''
+        def _c1():
+            pass
+        tmpl = templating.OSConfigTemplate(config_file='/tmp/foo',
+                                           contexts=_c1)
+        self.assertEquals(tmpl.contexts, [_c1])
+
+
+class TemplatingStringTests(unittest.TestCase):
+    def setUp(self):
+        path = os.path.dirname(__file__)
+        self.loader = FakeLoader()
+        self.context = FakeContextGenerator()
+
+        self.addCleanup(patch.object(templating,
+                                     'apt_install').start().stop())
+        self.addCleanup(patch.object(templating, 'log').start().stop())
+
+        templating.FileSystemLoader = MockFSLoader
+        templating.ChoiceLoader = MockChoiceLoader
+
+        self.config_file = '/etc/confd/extensible.d/drop-in.conf'
+        self.config_template = 'use: {{ fake_key }}'
+        self.renderer = templating.OSConfigRenderer(templates_dir=path,
+                                                    openstack_release='folsom')
+
+    def test_render_template_from_string_full_context(self):
+        '''
+        Test rendering a specified config file with a string template
+        and a context.
+        '''
+
+        context = {'fake_key': 'fake_val'}
+        self.context.set(
+            interfaces=['fooservice'],
+            context=context
+        )
+
+        expected_output = 'use: {}'.format(context['fake_key'])
+
+        self.renderer.register(
+            config_file=self.config_file,
+            contexts=[self.context],
+            config_template=self.config_template
+        )
+
+        # should return a string given we render from an in-memory
+        # template source
+        output = self.renderer.render(self.config_file)
+
+        self.assertEquals(output, expected_output)
+
+    def test_render_template_from_string_incomplete_context(self):
+        '''
+        Test rendering a specified config file with a string template
+        and a context.
+        '''
+
+        self.context.set(
+            interfaces=['fooservice'],
+            context={}
+        )
+
+        expected_output = 'use: '
+
+        self.renderer.register(
+            config_file=self.config_file,
+            contexts=[self.context],
+            config_template=self.config_template
+        )
+
+        # should return a string given we render from an in-memory
+        # template source
+        output = self.renderer.render(self.config_file)
+
+        self.assertEquals(output, expected_output)
+
+    def test_register_string_template_with_single_context(self):
+        '''Template rendering from a provided string with a context'''
+        def _c1():
+            pass
+
+        config_file = '/etc/confdir/custom-drop-in.conf'
+        config_template = 'use: {{ key_available_in_c1 }}'
+        tmpl = templating.OSConfigTemplate(
+            config_file=config_file,
+            contexts=_c1,
+            config_template=config_template
+        )
+
+        self.assertEquals(tmpl.contexts, [_c1])
+        self.assertEquals(tmpl.config_file, config_file)
+        self.assertEquals(tmpl.config_template, config_template)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..99ed17d9f91d8123740b5ca7f2efd729901deb82
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_os_utils.py
@@ -0,0 +1,277 @@
+import collections
+import json
+import mock
+import six
+import unittest
+
+from charmhelpers.contrib.openstack import utils
+
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+
+class UtilsTests(unittest.TestCase):
+    def setUp(self):
+        super(UtilsTests, self).setUp()
+
+    def test_compare_openstack_comparator(self):
+        self.assertTrue(utils.CompareOpenStackReleases('mitaka') < 'newton')
+        self.assertTrue(utils.CompareOpenStackReleases('pike') > 'essex')
+
+    @mock.patch.object(utils, 'config')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_set')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_ids')
+    @mock.patch('charmhelpers.contrib.openstack.utils.get_ipv6_addr')
+    def test_sync_db_with_multi_ipv6_addresses(self, mock_get_ipv6_addr,
+                                               mock_relation_ids,
+                                               mock_relation_set,
+                                               mock_config):
+        mock_config.return_value = None
+        addr1 = '2001:db8:1:0:f816:3eff:fe45:7c/64'
+        addr2 = '2001:db8:1:0:d0cf:528c:23eb:5000/64'
+        mock_get_ipv6_addr.return_value = [addr1, addr2]
+        mock_relation_ids.return_value = ['shared-db']
+
+        utils.sync_db_with_multi_ipv6_addresses('testdb', 'testdbuser')
+        hosts = json.dumps([addr1, addr2])
+        mock_relation_set.assert_called_with(relation_id='shared-db',
+                                             database='testdb',
+                                             username='testdbuser',
+                                             hostname=hosts)
+
+    @mock.patch.object(utils, 'config')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_set')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_ids')
+    @mock.patch('charmhelpers.contrib.openstack.utils.get_ipv6_addr')
+    def test_sync_db_with_multi_ipv6_addresses_single(self, mock_get_ipv6_addr,
+                                                      mock_relation_ids,
+                                                      mock_relation_set,
+                                                      mock_config):
+        mock_config.return_value = None
+        addr1 = '2001:db8:1:0:f816:3eff:fe45:7c/64'
+        mock_get_ipv6_addr.return_value = [addr1]
+        mock_relation_ids.return_value = ['shared-db']
+
+        utils.sync_db_with_multi_ipv6_addresses('testdb', 'testdbuser')
+        hosts = json.dumps([addr1])
+        mock_relation_set.assert_called_with(relation_id='shared-db',
+                                             database='testdb',
+                                             username='testdbuser',
+                                             hostname=hosts)
+
+    @mock.patch.object(utils, 'config')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_set')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_ids')
+    @mock.patch('charmhelpers.contrib.openstack.utils.get_ipv6_addr')
+    def test_sync_db_with_multi_ipv6_addresses_w_prefix(self,
+                                                        mock_get_ipv6_addr,
+                                                        mock_relation_ids,
+                                                        mock_relation_set,
+                                                        mock_config):
+        mock_config.return_value = None
+        addr1 = '2001:db8:1:0:f816:3eff:fe45:7c/64'
+        mock_get_ipv6_addr.return_value = [addr1]
+        mock_relation_ids.return_value = ['shared-db']
+
+        utils.sync_db_with_multi_ipv6_addresses('testdb', 'testdbuser',
+                                                relation_prefix='bungabunga')
+        hosts = json.dumps([addr1])
+        mock_relation_set.assert_called_with(relation_id='shared-db',
+                                             bungabunga_database='testdb',
+                                             bungabunga_username='testdbuser',
+                                             bungabunga_hostname=hosts)
+
+    @mock.patch.object(utils, 'config')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_set')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_ids')
+    @mock.patch('charmhelpers.contrib.openstack.utils.get_ipv6_addr')
+    def test_sync_db_with_multi_ipv6_addresses_vips(self, mock_get_ipv6_addr,
+                                                    mock_relation_ids,
+                                                    mock_relation_set,
+                                                    mock_config):
+        addr1 = '2001:db8:1:0:f816:3eff:fe45:7c/64'
+        addr2 = '2001:db8:1:0:d0cf:528c:23eb:5000/64'
+        vip1 = '2001:db8:1:0:f816:3eff:32b3:7c'
+        vip2 = '2001:db8:1:0:f816:3eff:32b3:7d'
+        mock_config.return_value = '%s 10.0.0.1 %s' % (vip1, vip2)
+
+        mock_get_ipv6_addr.return_value = [addr1, addr2]
+        mock_relation_ids.return_value = ['shared-db']
+
+        utils.sync_db_with_multi_ipv6_addresses('testdb', 'testdbuser')
+        hosts = json.dumps([addr1, addr2, vip1, vip2])
+        mock_relation_set.assert_called_with(relation_id='shared-db',
+                                             database='testdb',
+                                             username='testdbuser',
+                                             hostname=hosts)
+
+    @mock.patch('uuid.uuid4')
+    @mock.patch('charmhelpers.contrib.openstack.utils.related_units')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_set')
+    @mock.patch('charmhelpers.contrib.openstack.utils.relation_ids')
+    def test_remote_restart(self, mock_relation_ids, mock_relation_set,
+                            mock_related_units, mock_uuid4):
+        mock_relation_ids.return_value = ['neutron-plugin-api-subordinate:8']
+        mock_related_units.return_value = ['neutron-api/0']
+        mock_uuid4.return_value = 'uuid4'
+        utils.remote_restart('neutron-plugin-api-subordinate')
+        mock_relation_set.assert_called_with(
+            relation_id='neutron-plugin-api-subordinate:8',
+            relation_settings={'restart-trigger': 'uuid4'}
+        )
+
+    @mock.patch.object(utils, 'lsb_release')
+    @mock.patch.object(utils, 'config')
+    @mock.patch('charmhelpers.contrib.openstack.utils.get_os_codename_package')
+    @mock.patch('charmhelpers.contrib.openstack.utils.'
+                'get_os_codename_install_source')
+    def test_os_release(self, mock_get_os_codename_install_source,
+                        mock_get_os_codename_package,
+                        mock_config, mock_lsb_release):
+        # Wipe the modules cached os_rel
+        utils._os_rel = None
+        mock_lsb_release.return_value = {"DISTRIB_CODENAME": "trusty"}
+        mock_get_os_codename_install_source.return_value = None
+        mock_get_os_codename_package.return_value = None
+        mock_config.return_value = 'cloud-pocket'
+        self.assertEqual(utils.os_release('my-pkg'), 'icehouse')
+        mock_get_os_codename_install_source.assert_called_once_with(
+            'cloud-pocket')
+        mock_get_os_codename_package.assert_called_once_with(
+            'my-pkg', fatal=False)
+        mock_config.assert_called_once_with('openstack-origin')
+        # Next call to os_release should pickup cached version
+        mock_get_os_codename_install_source.reset_mock()
+        mock_get_os_codename_package.reset_mock()
+        self.assertEqual(utils.os_release('my-pkg'), 'icehouse')
+        self.assertFalse(mock_get_os_codename_install_source.called)
+        self.assertFalse(mock_get_os_codename_package.called)
+        # Call os_release and bypass cache
+        mock_lsb_release.return_value = {"DISTRIB_CODENAME": "xenial"}
+        mock_get_os_codename_install_source.reset_mock()
+        mock_get_os_codename_package.reset_mock()
+        self.assertEqual(utils.os_release('my-pkg', reset_cache=True),
+                         'mitaka')
+        mock_get_os_codename_install_source.assert_called_once_with(
+            'cloud-pocket')
+        mock_get_os_codename_package.assert_called_once_with(
+            'my-pkg', fatal=False)
+        # Override base
+        mock_lsb_release.return_value = {"DISTRIB_CODENAME": "xenial"}
+        mock_get_os_codename_install_source.reset_mock()
+        mock_get_os_codename_package.reset_mock()
+        self.assertEqual(utils.os_release('my-pkg', reset_cache=True, base="ocata"),
+                         'ocata')
+        mock_get_os_codename_install_source.assert_called_once_with(
+            'cloud-pocket')
+        mock_get_os_codename_package.assert_called_once_with(
+            'my-pkg', fatal=False)
+        # Override source key
+        mock_config.reset_mock()
+        mock_get_os_codename_install_source.reset_mock()
+        mock_get_os_codename_package.reset_mock()
+        mock_get_os_codename_package.return_value = None
+        utils.os_release('my-pkg', reset_cache=True, source_key='source')
+        mock_config.assert_called_once_with('source')
+        mock_get_os_codename_install_source.assert_called_once_with(
+            'cloud-pocket')
+
+    @mock.patch.object(utils, 'os_release')
+    @mock.patch.object(utils, 'get_os_codename_install_source')
+    def test_enable_memcache(self, _get_os_codename_install_source,
+                             _os_release):
+        # Check call with 'release'
+        self.assertFalse(utils.enable_memcache(release='icehouse'))
+        self.assertTrue(utils.enable_memcache(release='ocata'))
+        # Check call with 'source'
+        _os_release.return_value = None
+        _get_os_codename_install_source.return_value = 'icehouse'
+        self.assertFalse(utils.enable_memcache(source='distro'))
+        _os_release.return_value = None
+        _get_os_codename_install_source.return_value = 'ocata'
+        self.assertTrue(utils.enable_memcache(source='distro'))
+        # Check call with 'package'
+        _os_release.return_value = 'icehouse'
+        _get_os_codename_install_source.return_value = None
+        self.assertFalse(utils.enable_memcache(package='pkg1'))
+        _os_release.return_value = 'ocata'
+        _get_os_codename_install_source.return_value = None
+        self.assertTrue(utils.enable_memcache(package='pkg1'))
+
+    @mock.patch.object(utils, 'enable_memcache')
+    def test_enable_token_cache_pkgs(self, _enable_memcache):
+        _enable_memcache.return_value = False
+        self.assertEqual(utils.token_cache_pkgs(source='distro'), [])
+        _enable_memcache.return_value = True
+        self.assertEqual(utils.token_cache_pkgs(source='distro'),
+                         ['memcached', 'python-memcache'])
+
+    def test_update_json_file(self):
+        TEST_POLICY = """{
+        "delete_image_location": "",
+        "get_image_location": "",
+        "set_image_location": "",
+        "extra_property": "False"
+        }"""
+
+        TEST_POLICY_FILE = "/etc/glance/policy.json"
+
+        items_to_update = {
+            "get_image_location": "role:admin",
+            "extra_policy": "extra",
+        }
+
+        mock_open = mock.mock_open(read_data=TEST_POLICY)
+        with mock.patch(builtin_open, mock_open) as mock_file:
+            utils.update_json_file(TEST_POLICY_FILE, {})
+            self.assertFalse(mock_file.called)
+
+            utils.update_json_file(TEST_POLICY_FILE, items_to_update)
+            mock_file.assert_has_calls([
+                mock.call(TEST_POLICY_FILE),
+                mock.call(TEST_POLICY_FILE, 'w'),
+            ], any_order=True)
+
+        modified_policy = json.loads(TEST_POLICY)
+        modified_policy.update(items_to_update)
+        mock_open().write.assert_called_with(
+            json.dumps(modified_policy, indent=4, sort_keys=True))
+
+        tmp = json.loads(TEST_POLICY)
+        tmp.update(items_to_update)
+        TEST_POLICY = json.dumps(tmp)
+        mock_open = mock.mock_open(read_data=TEST_POLICY)
+        with mock.patch(builtin_open, mock_open) as mock_file:
+            utils.update_json_file(TEST_POLICY_FILE, items_to_update)
+            mock_file.assert_has_calls([
+                mock.call(TEST_POLICY_FILE),
+            ], any_order=True)
+
+    def test_ordered(self):
+        data = {'one': 1, 'two': 2, 'three': 3}
+        expected = [('one', 1), ('three', 3), ('two', 2)]
+        self.assertSequenceEqual(expected,
+                                 [x for x in utils.ordered(data).items()])
+
+        data = {
+            'one': 1,
+            'two': 2,
+            'three': {
+                'uno': 1,
+                'dos': 2,
+                'tres': 3
+            }
+        }
+        expected = collections.OrderedDict()
+        expected['one'] = 1
+        nested = collections.OrderedDict()
+        nested['dos'] = 2
+        nested['tres'] = 3
+        nested['uno'] = 1
+        expected['three'] = nested
+        expected['two'] = 2
+        self.assertEqual(expected, utils.ordered(data))
+
+        self.assertRaises(ValueError, utils.ordered, "foo")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_policyd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_policyd.py
new file mode 100644
index 0000000000000000000000000000000000000000..378e58d4ab7ee037efbd9e12e94dcab8b9dbd4d8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_policyd.py
@@ -0,0 +1,467 @@
+import contextlib
+import copy
+import io
+import os
+import mock
+import six
+import unittest
+
+from charmhelpers.contrib.openstack import policyd
+
+
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+
+class PolicydTests(unittest.TestCase):
+    def setUp(self):
+        super(PolicydTests, self).setUp()
+
+    def test_is_policyd_override_valid_on_this_release(self):
+        self.assertTrue(
+            policyd.is_policyd_override_valid_on_this_release("queens"))
+        self.assertTrue(
+            policyd.is_policyd_override_valid_on_this_release("rocky"))
+        self.assertFalse(
+            policyd.is_policyd_override_valid_on_this_release("pike"))
+
+    @mock.patch.object(policyd, "clean_policyd_dir_for")
+    @mock.patch.object(policyd, "remove_policy_success_file")
+    @mock.patch.object(policyd, "process_policy_resource_file")
+    @mock.patch.object(policyd, "get_policy_resource_filename")
+    @mock.patch.object(policyd, "is_policyd_override_valid_on_this_release")
+    @mock.patch.object(policyd, "_policy_success_file")
+    @mock.patch("os.path.isfile")
+    @mock.patch.object(policyd.hookenv, "config")
+    @mock.patch("charmhelpers.core.hookenv.log")
+    def test_maybe_do_policyd_overrides(
+        self,
+        mock_log,
+        mock_config,
+        mock_isfile,
+        mock__policy_success_file,
+        mock_is_policyd_override_valid_on_this_release,
+        mock_get_policy_resource_filename,
+        mock_process_policy_resource_file,
+        mock_remove_policy_success_file,
+        mock_clean_policyd_dir_for,
+    ):
+        mock_isfile.return_value = False
+        mock__policy_success_file.return_value = "s-return"
+        # test success condition
+        mock_config.return_value = {policyd.POLICYD_CONFIG_NAME: True}
+        mock_is_policyd_override_valid_on_this_release.return_value = True
+        mock_get_policy_resource_filename.return_value = "resource.zip"
+        mock_process_policy_resource_file.return_value = True
+        mod_fn = mock.Mock()
+        restart_handler = mock.Mock()
+        policyd.maybe_do_policyd_overrides(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler)
+        mock_is_policyd_override_valid_on_this_release.assert_called_once_with(
+            "arelease")
+        mock_get_policy_resource_filename.assert_called_once_with()
+        mock_process_policy_resource_file.assert_called_once_with(
+            "resource.zip", "aservice", ["a"], ["b"], mod_fn)
+        restart_handler.assert_called_once_with()
+        # test process_policy_resource_file is not called if not valid on the
+        # release.
+        mock_process_policy_resource_file.reset_mock()
+        restart_handler.reset_mock()
+        mock_is_policyd_override_valid_on_this_release.return_value = False
+        policyd.maybe_do_policyd_overrides(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler)
+        mock_process_policy_resource_file.assert_not_called()
+        restart_handler.assert_not_called()
+        # test restart_handler is not called if not needed.
+        mock_is_policyd_override_valid_on_this_release.return_value = True
+        mock_process_policy_resource_file.return_value = False
+        policyd.maybe_do_policyd_overrides(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler)
+        mock_process_policy_resource_file.assert_called_once_with(
+            "resource.zip", "aservice", ["a"], ["b"], mod_fn)
+        restart_handler.assert_not_called()
+        # test that directory gets cleaned if the config is not set
+        mock_config.return_value = {policyd.POLICYD_CONFIG_NAME: False}
+        mock_process_policy_resource_file.reset_mock()
+        policyd.maybe_do_policyd_overrides(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler)
+        mock_process_policy_resource_file.assert_not_called()
+        mock_remove_policy_success_file.assert_called_once_with()
+        mock_clean_policyd_dir_for.assert_called_once_with(
+            "aservice", ["a"], user='aservice', group='aservice')
+
+    @mock.patch.object(policyd, "maybe_do_policyd_overrides")
+    def test_maybe_do_policyd_overrides_with_config_changed(
+        self,
+        mock_maybe_do_policyd_overrides,
+    ):
+        mod_fn = mock.Mock()
+        restart_handler = mock.Mock()
+        policyd.maybe_do_policyd_overrides_on_config_changed(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler)
+        mock_maybe_do_policyd_overrides.assert_called_once_with(
+            "arelease", "aservice", ["a"], ["b"], mod_fn, restart_handler,
+            config_changed=True)
+
+    @mock.patch("charmhelpers.core.hookenv.resource_get")
+    def test_get_policy_resource_filename(self, mock_resource_get):
+        mock_resource_get.return_value = "test-file"
+        self.assertEqual(policyd.get_policy_resource_filename(),
+                         "test-file")
+        mock_resource_get.assert_called_once_with(
+            policyd.POLICYD_RESOURCE_NAME)
+
+        # check that if an error is raised, that None is returned.
+        def go_bang(*args):
+            raise Exception("bang")
+
+        mock_resource_get.side_effect = go_bang
+        self.assertEqual(policyd.get_policy_resource_filename(), None)
+
+    @mock.patch.object(policyd, "_yamlfiles")
+    @mock.patch.object(policyd.zipfile, "ZipFile")
+    def test_open_and_filter_yaml_files(self, mock_ZipFile, mock__yamlfiles):
+        mock__yamlfiles.return_value = [
+            ("file1", ".yaml", "file1.yaml", None),
+            ("file2", ".yml", "file2.YML", None)]
+        mock_ZipFile.return_value.__enter__.return_value = "zfp"
+        # test a valid zip file
+        with policyd.open_and_filter_yaml_files("some-file") as (zfp, files):
+            self.assertEqual(zfp, "zfp")
+            mock_ZipFile.assert_called_once_with("some-file", "r")
+            self.assertEqual(files, [
+                ("file1", ".yaml", "file1.yaml", None),
+                ("file2", ".yml", "file2.YML", None)])
+        # ensure that there must be at least one file.
+        mock__yamlfiles.return_value = []
+        with self.assertRaises(policyd.BadPolicyZipFile):
+            with policyd.open_and_filter_yaml_files("some-file"):
+                pass
+        # ensure that it picks up duplicates
+        mock__yamlfiles.return_value = [
+            ("file1", ".yaml", "file1.yaml", None),
+            ("file2", ".yml", "file2.yml", None),
+            ("file1", ".yml", "file1.yml", None)]
+        with self.assertRaises(policyd.BadPolicyZipFile):
+            with policyd.open_and_filter_yaml_files("some-file"):
+                pass
+
+    def test__yamlfiles(self):
+        class MockZipFile(object):
+            def __init__(self, infolist):
+                self._infolist = infolist
+
+            def infolist(self):
+                return self._infolist
+
+        class MockInfoListItem(object):
+            def __init__(self, is_dir, filename):
+                self.filename = filename
+                self._is_dir = is_dir
+
+            def is_dir(self):
+                return self._is_dir
+
+            def __repr__(self):
+                return "MockInfoListItem({}, {})".format(self._is_dir,
+                                                         self.filename)
+
+        zipfile = MockZipFile([
+            MockInfoListItem(False, "file1.yaml"),
+            MockInfoListItem(False, "file2.md"),
+            MockInfoListItem(False, "file3.YML"),
+            MockInfoListItem(False, "file4.Yaml"),
+            MockInfoListItem(True, "file5"),
+            MockInfoListItem(True, "file6.yaml"),
+            MockInfoListItem(False, "file7"),
+            MockInfoListItem(False, "file8.j2")])
+
+        self.assertEqual(list(policyd._yamlfiles(zipfile)),
+                         [("file1", ".yaml", "file1.yaml", mock.ANY),
+                          ("file3", ".yml", "file3.YML", mock.ANY),
+                          ("file4", ".yaml", "file4.Yaml", mock.ANY),
+                          ("file8", ".j2", "file8.j2", mock.ANY)])
+
+    @mock.patch.object(policyd.yaml, "safe_load")
+    def test_read_and_validate_yaml(self, mock_safe_load):
+        # test a valid document
+        good_doc = {
+            "key1": "rule1",
+            "key2": "rule2",
+        }
+        mock_safe_load.return_value = copy.deepcopy(good_doc)
+        doc = policyd.read_and_validate_yaml("test-stream")
+        self.assertEqual(doc, good_doc)
+        mock_safe_load.assert_called_once_with("test-stream")
+        # test an invalid document - return a string
+        mock_safe_load.return_value = "wrong"
+        with self.assertRaises(policyd.BadPolicyYamlFile):
+            policyd.read_and_validate_yaml("test-stream")
+        # test for black-listed keys
+        with self.assertRaises(policyd.BadPolicyYamlFile):
+            mock_safe_load.return_value = copy.deepcopy(good_doc)
+            policyd.read_and_validate_yaml("test-stream", ["key1"])
+        # test for non string keys
+        bad_key_doc = {
+            (1,): "rule1",
+            "key2": "rule2",
+        }
+        with self.assertRaises(policyd.BadPolicyYamlFile):
+            mock_safe_load.return_value = copy.deepcopy(bad_key_doc)
+            policyd.read_and_validate_yaml("test-stream", ["key1"])
+        # test for non string values (i.e. no nested keys)
+        bad_key_doc2 = {
+            "key1": "rule1",
+            "key2": {"sub_key": "rule2"},
+        }
+        with self.assertRaises(policyd.BadPolicyYamlFile):
+            mock_safe_load.return_value = copy.deepcopy(bad_key_doc2)
+            policyd.read_and_validate_yaml("test-stream", ["key1"])
+
+    def test_policyd_dir_for(self):
+        self.assertEqual(policyd.policyd_dir_for('thing'),
+                         "/etc/thing/policy.d")
+
+    @mock.patch.object(policyd.hookenv, 'log')
+    @mock.patch("os.remove")
+    @mock.patch("shutil.rmtree")
+    @mock.patch("charmhelpers.core.host.mkdir")
+    @mock.patch("os.path.exists")
+    @mock.patch.object(policyd, "policyd_dir_for")
+    def test_clean_policyd_dir_for(self,
+                                   mock_policyd_dir_for,
+                                   mock_os_path_exists,
+                                   mock_mkdir,
+                                   mock_shutil_rmtree,
+                                   mock_os_remove,
+                                   mock_log):
+        if hasattr(os, 'scandir'):
+            mock_scan_dir_parts = (mock.patch, ["os.scandir"])
+        else:
+            mock_scan_dir_parts = (mock.patch.object,
+                                   [policyd, "_fallback_scandir"])
+
+        class MockDirEntry(object):
+            def __init__(self, path, is_dir):
+                self.path = path
+                self._is_dir = is_dir
+
+            def is_dir(self):
+                return self._is_dir
+
+        # list of scanned objects
+        directory_contents = [
+            MockDirEntry("one", False),
+            MockDirEntry("two", False),
+            MockDirEntry("three", True),
+            MockDirEntry("four", False)]
+
+        mock_policyd_dir_for.return_value = "the-path"
+
+        # Initial conditions
+        mock_os_path_exists.return_value = False
+
+        # call the function
+        with mock_scan_dir_parts[0](*mock_scan_dir_parts[1]) as \
+                mock_os_scandir:
+            mock_os_scandir.return_value = directory_contents
+            policyd.clean_policyd_dir_for("aservice")
+
+        # check it did the right thing
+        mock_policyd_dir_for.assert_called_once_with("aservice")
+        mock_os_path_exists.assert_called_once_with("the-path")
+        mock_mkdir.assert_called_once_with("the-path",
+                                           owner="aservice",
+                                           group="aservice",
+                                           perms=0o775)
+        mock_shutil_rmtree.assert_called_once_with("three")
+        mock_os_remove.assert_has_calls([
+            mock.call("one"), mock.call("two"), mock.call("four")])
+
+        # check also that we can omit paths ... reset everything
+        mock_os_remove.reset_mock()
+        mock_shutil_rmtree.reset_mock()
+        mock_os_path_exists.reset_mock()
+        mock_os_path_exists.return_value = True
+        mock_mkdir.reset_mock()
+
+        with mock_scan_dir_parts[0](*mock_scan_dir_parts[1]) as \
+                mock_os_scandir:
+            mock_os_scandir.return_value = directory_contents
+            policyd.clean_policyd_dir_for("aservice",
+                                          keep_paths=["one", "three"])
+
+        # verify all worked as we expected
+        mock_mkdir.assert_not_called()
+        mock_shutil_rmtree.assert_not_called()
+        mock_os_remove.assert_has_calls([mock.call("two"), mock.call("four")])
+
+    def test_path_for_policy_file(self):
+        self.assertEqual(policyd.path_for_policy_file('this', 'that'),
+                         "/etc/this/policy.d/that.yaml")
+
+    @mock.patch("charmhelpers.core.hookenv.charm_dir")
+    def test__policy_success_file(self, mock_charm_dir):
+        mock_charm_dir.return_value = "/this"
+        self.assertEqual(policyd._policy_success_file(),
+                         "/this/{}".format(policyd.POLICYD_SUCCESS_FILENAME))
+
+    @mock.patch("os.remove")
+    @mock.patch.object(policyd, "_policy_success_file")
+    def test_remove_policy_success_file(self, mock_file, mock_os_remove):
+        mock_file.return_value = "the-path"
+        policyd.remove_policy_success_file()
+        mock_os_remove.assert_called_once_with("the-path")
+
+        # now test that failure doesn't fail the function
+        def go_bang(*args):
+            raise Exception("bang")
+
+        mock_os_remove.side_effect = go_bang
+        policyd.remove_policy_success_file()
+
+    @mock.patch("os.path.isfile")
+    @mock.patch.object(policyd, "_policy_success_file")
+    def test_policyd_status_message_prefix(self, mock_file, mock_is_file):
+        mock_file.return_value = "the-path"
+        mock_is_file.return_value = True
+        self.assertEqual(policyd.policyd_status_message_prefix(), "PO:")
+        mock_is_file.return_value = False
+        self.assertEqual(
+            policyd.policyd_status_message_prefix(), "PO (broken):")
+
+    @mock.patch("yaml.dump")
+    @mock.patch.object(policyd, "_policy_success_file")
+    @mock.patch.object(policyd.hookenv, "log")
+    @mock.patch.object(policyd, "read_and_validate_yaml")
+    @mock.patch.object(policyd, "path_for_policy_file")
+    @mock.patch.object(policyd, "clean_policyd_dir_for")
+    @mock.patch.object(policyd, "remove_policy_success_file")
+    @mock.patch.object(policyd, "open_and_filter_yaml_files")
+    @mock.patch.object(policyd.ch_host, 'write_file')
+    @mock.patch.object(policyd, "maybe_create_directory_for")
+    def test_process_policy_resource_file(
+        self,
+        mock_maybe_create_directory_for,
+        mock_write_file,
+        mock_open_and_filter_yaml_files,
+        mock_remove_policy_success_file,
+        mock_clean_policyd_dir_for,
+        mock_path_for_policy_file,
+        mock_read_and_validate_yaml,
+        mock_log,
+        mock__policy_success_file,
+        mock_yaml_dump,
+    ):
+        mock_zfp = mock.MagicMock()
+        mod_fn = mock.Mock()
+        mock_path_for_policy_file.side_effect = lambda s, n: s + "/" + n
+        gen = [
+            ("file1", ".yaml", "file1.yaml", "file1-zipinfo"),
+            ("file2", ".yml", "file2.yml", "file2-zipinfo")]
+        mock_open_and_filter_yaml_files.return_value.__enter__.return_value = \
+            (mock_zfp, gen)
+        # first verify that we can blacklist a file
+        res = policyd.process_policy_resource_file(
+            "resource.zip", "aservice", ["aservice/file1"], [], mod_fn)
+        self.assertFalse(res)
+        mock_remove_policy_success_file.assert_called_once_with()
+        mock_clean_policyd_dir_for.assert_has_calls([
+            mock.call("aservice",
+                      ["aservice/file1"],
+                      user='aservice',
+                      group='aservice'),
+            mock.call("aservice",
+                      ["aservice/file1"],
+                      user='aservice',
+                      group='aservice')])
+        mock_zfp.open.assert_not_called()
+        mod_fn.assert_not_called()
+        mock_log.assert_any_call("Processing resource.zip failed: policy.d"
+                                 " name aservice/file1 is blacklisted",
+                                 level=policyd.POLICYD_LOG_LEVEL_DEFAULT)
+
+        # now test for success
+        @contextlib.contextmanager
+        def _patch_open():
+            '''Patch open() to allow mocking both open() itself and the file that is
+            yielded.
+
+            Yields the mock for "open" and "file", respectively.'''
+            mock_open = mock.MagicMock(spec=open)
+            mock_file = mock.MagicMock(spec=io.FileIO)
+
+            with mock.patch(builtin_open, mock_open):
+                yield mock_open, mock_file
+
+        mock_clean_policyd_dir_for.reset_mock()
+        mock_zfp.reset_mock()
+        mock_fp = mock.MagicMock()
+        mock_fp.read.return_value = '{"rule1": "value1"}'
+        mock_zfp.open.return_value.__enter__.return_value = mock_fp
+        gen = [("file1", ".j2", "file1.j2", "file1-zipinfo")]
+        mock_open_and_filter_yaml_files.return_value.__enter__.return_value = \
+            (mock_zfp, gen)
+        mock_read_and_validate_yaml.return_value = {"rule1": "modded_value1"}
+        mod_fn.return_value = '{"rule1": "modded_value1"}'
+        mock__policy_success_file.return_value = "policy-success-file"
+        mock_yaml_dump.return_value = "dumped-file"
+        with _patch_open() as (mock_open, mock_file):
+            res = policyd.process_policy_resource_file(
+                "resource.zip", "aservice", [], ["key"], mod_fn)
+            self.assertTrue(res)
+            # mock_open.assert_any_call("aservice/file1", "wt")
+            mock_write_file.assert_called_once_with(
+                "aservice/file1",
+                b'dumped-file',
+                "aservice",
+                "aservice")
+            mock_open.assert_any_call("policy-success-file", "w")
+            mock_yaml_dump.assert_called_once_with({"rule1": "modded_value1"})
+        mock_zfp.open.assert_called_once_with("file1-zipinfo")
+        mock_read_and_validate_yaml.assert_called_once_with(
+            '{"rule1": "modded_value1"}', ["key"])
+        mod_fn.assert_called_once_with('{"rule1": "value1"}')
+
+        # raise a BadPolicyZipFile if we have a template, but there is no
+        # template function
+        mock_log.reset_mock()
+        with _patch_open() as (mock_open, mock_file):
+            res = policyd.process_policy_resource_file(
+                "resource.zip", "aservice", [], ["key"],
+                template_function=None)
+            self.assertFalse(res)
+        mock_log.assert_any_call(
+            "Processing resource.zip failed: Template file1.j2 "
+            "but no template_function is available",
+            level=policyd.POLICYD_LOG_LEVEL_DEFAULT)
+
+        # raise the IOError to validate that code path
+        def raise_ioerror(*args):
+            raise IOError("bang")
+
+        mock_open_and_filter_yaml_files.side_effect = raise_ioerror
+        mock_log.reset_mock()
+        res = policyd.process_policy_resource_file(
+            "resource.zip", "aservice", [], ["key"], mod_fn)
+        self.assertFalse(res, False)
+        mock_log.assert_any_call(
+            "File resource.zip failed with IOError.  "
+            "This really shouldn't happen -- error: bang",
+            level=policyd.POLICYD_LOG_LEVEL_DEFAULT)
+        # raise a general exception, so that is caught and logged too.
+
+        def raise_exception(*args):
+            raise Exception("bang2")
+
+        mock_open_and_filter_yaml_files.reset_mock()
+        mock_open_and_filter_yaml_files.side_effect = raise_exception
+        mock_log.reset_mock()
+        res = policyd.process_policy_resource_file(
+            "resource.zip", "aservice", [], ["key"], mod_fn)
+        self.assertFalse(res, False)
+        mock_log.assert_any_call(
+            "General Exception(bang2) during policyd processing",
+            level=policyd.POLICYD_LOG_LEVEL_DEFAULT)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ssh_migrations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ssh_migrations.py
new file mode 100644
index 0000000000000000000000000000000000000000..5a3244228d96199f4d3661da18bec83777a32b52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_ssh_migrations.py
@@ -0,0 +1,582 @@
+import mock
+import six
+import subprocess
+import unittest
+
+from tests.helpers import patch_open, mock_open
+
+import charmhelpers.contrib.openstack.ssh_migrations as ssh_migrations
+
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+    builtin_import = '__builtin__.__import__'
+else:
+    builtin_open = 'builtins.open'
+    builtin_import = 'builtins.__import__'
+
+
+UNIT1_HOST_KEY_1 = """|1|EaIiWNsBsaSke5T5bdDlaV5xKPU=|WKMu3Va+oNwRjXmPGOZ+mrpWbM8= ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDZdZdR7I35ymFdspruN1CIez/0m62sJeld2nLuOGaNbdl/rk5bGrWUAZh6c9p9H53FAqGAXBD/1C8dZ5dgIAGdTs7PAZq7owXCpgUPQcGOYVAtBwv8qfnWyI1W+Vpi6vnb2sgYr6XGbB9b84i4vrd98IIpXIleC9qd0VUTSYgd7+NPaFNoK0HZmqcNEf5leaa8sgSf4t5F+BTWEXzU3ql/3isFT8lEpJ9N8wOvNzAoFEQcxqauvOJn72QQ6kUrQT3NdQFUMHquS/s+nBrQNPbUmzqrvSOed75Qk8359zqU1Rce7U39cqc0scYi1ak3oJdojwfLFKJw4TMPn/Pq7JnT"""
+UNIT1_HOST_KEY_2 = """|1|mCyYWqJl8loqV6LCY84lu2rpqLA=|51m+M+0ES3jYVzr3Kco3CDg8hEY= ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDZdZdR7I35ymFdspruN1CIez/0m62sJeld2nLuOGaNbdl/rk5bGrWUAZh6c9p9H53FAqGAXBD/1C8dZ5dgIAGdTs7PAZq7owXCpgUPQcGOYVAtBwv8qfnWyI1W+Vpi6vnb2sgYr6XGbB9b84i4vrd98IIpXIleC9qd0VUTSYgd7+NPaFNoK0HZmqcNEf5leaa8sgSf4t5F+BTWEXzU3ql/3isFT8lEpJ9N8wOvNzAoFEQcxqauvOJn72QQ6kUrQT3NdQFUMHquS/s+nBrQNPbUmzqrvSOed75Qk8359zqU1Rce7U39cqc0scYi1ak3oJdojwfLFKJw4TMPn/Pq7JnT"""
+UNIT2_HOST_KEY_1 = """|1|eWagMqrN7XmX7NdVpZbqMZ2cb4Q=|3jgGiFEU9SMhXwdX0w0kkG54CZc= ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC27Lv4wtAiPIOTsrUCFOU4qaNsov+LZSVHtxlu0aERuD+oU3ZILXOITXJlDohweXN6YuP4hFg49FF119gmMag+hDiA8/BztQmsplkwHrWEPuWKpReLRNLBU+Nt78jrJkjTK8Egwxbaxu8fAPZkCgGyeLkIH4ghrdWlOaWYXzwuxXkYWSpQOgF6E/T+19JKVKNpt2i6w7q9vVwZEjwVr30ubs1bNdPzE9ylNLQRrGa7c38SKsEos5RtZJjEuZGTC9KI0QdEgwnxxNMlT/CIgwWA1V38vLsosF2pHKxbmtCNvBuPNtrBDgXhukVqyEh825RhTAyQYGshMCbAbxl/M9c3"""
+UNIT2_HOST_KEY_2 = """|1|zRH8troNwhVzrkMx86E5Ibevw5s=|gESlgkwUumP8q0A6l+CoRlFRpTw= ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC27Lv4wtAiPIOTsrUCFOU4qaNsov+LZSVHtxlu0aERuD+oU3ZILXOITXJlDohweXN6YuP4hFg49FF119gmMag+hDiA8/BztQmsplkwHrWEPuWKpReLRNLBU+Nt78jrJkjTK8Egwxbaxu8fAPZkCgGyeLkIH4ghrdWlOaWYXzwuxXkYWSpQOgF6E/T+19JKVKNpt2i6w7q9vVwZEjwVr30ubs1bNdPzE9ylNLQRrGa7c38SKsEos5RtZJjEuZGTC9KI0QdEgwnxxNMlT/CIgwWA1V38vLsosF2pHKxbmtCNvBuPNtrBDgXhukVqyEh825RhTAyQYGshMCbAbxl/M9c3"""
+HOST_KEYS = [UNIT1_HOST_KEY_1, UNIT1_HOST_KEY_2,
+             UNIT2_HOST_KEY_1, UNIT2_HOST_KEY_2]
+UNIT1_PUBKEY_1 = """ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDqtnB3zh3sMufZd1khi44su0hTg/LqLb3ma2iyueTULZikDYa65UidVxzsa6r0Y9jkHwknGlh7fNnGdmc3S8EE+rVUNF4r3JF2Zd/pdfCBia/BmKJcO7+NyRWc8ihlrA3xYUSm+Yg8ZIpqoSb1LKjgAdYISh9HQQaXut2sXtHESdpilNpDf42AZfuQM+B0op0v7bq86ZXOM1rvdJriI6BduHaAOux+d9HDNvV5AxYTICrUkXqIvdHnoRyOFfhTcKun0EtuUxpDiAi0im9C+i+MPwMvA6AmRbot6Tqt2xZPRBYY8+WF7I5cBoovES/dWKP5TZwaGBr+WNv+z2JJhvlN root@juju-4665be-20180716142533-8"""
+UNIT2_PUBKEY_1 = """ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCkWfkVrG7wTnfifvL0GkmDj6L33PKrWjzN2hOwZb9EoxwNzFGTMTBIpepTAnO6hdFBwtus1Ej/L12K6L/0YRDZAKjE7yTWOsh1kUxPZ1INRCqLILiefE5A/LPNx8NDb+d/2ryc5QmOQXUALs6mC5VDNchImUp9L7l0RIzPOgPXZCqMC1nZLqqX+eI9EUaf29/+NztYw59rFAa3hWNe8RJCSFeU+iWirWP8rfX9jsLzD9hO3nuZjP23M6tv1jX9LQD+8qkx0WSMa2WrIjkMiclP6tkyCJOZogyoPzZm/+dUhLeY9bIizbZCQKH/b4gOl5m/PkWoqEFshfqGzUIPkAJp root@juju-4665be-20180716142533-9"""
+PUB_KEYS = [UNIT1_PUBKEY_1, UNIT2_PUBKEY_1]
+
+
+class SSHMigrationsTests(unittest.TestCase):
+
+    def setUp(self):
+        self._patches = {}
+        self._patches_start = {}
+
+    def tearDown(self):
+        """Run teardown of patches."""
+        for k, v in self._patches.items():
+            v.stop()
+            setattr(self, k, None)
+        self._patches = None
+        self._patches_start = None
+
+    def patch_object(self, obj, attr, return_value=None, name=None, new=None,
+                     **kwargs):
+        """Patch the given object."""
+        if name is None:
+            name = attr
+        if new is not None:
+            mocked = mock.patch.object(obj, attr, new=new, **kwargs)
+        else:
+            mocked = mock.patch.object(obj, attr, **kwargs)
+        self._patches[name] = mocked
+        started = mocked.start()
+        if new is None:
+            started.return_value = return_value
+        self._patches_start[name] = started
+        setattr(self, name, started)
+
+    def setup_mocks_ssh_directory_for_unit(self, app_name, ssh_dir_exists,
+                                           app_dir_exists, auth_keys_exists,
+                                           known_hosts_exists, user=None):
+        def _isdir(x):
+            return {
+                ssh_dir + '/': ssh_dir_exists,
+                app_dir: app_dir_exists}[x]
+
+        def _isfile(x):
+            return {
+                '{}/authorized_keys'.format(app_dir): auth_keys_exists,
+                '{}/known_hosts'.format(app_dir): known_hosts_exists}[x]
+
+        if user:
+            app_name = "{}_{}".format(app_name, user)
+        ssh_dir = '/etc/nova/compute_ssh'
+        app_dir = '{}/{}'.format(ssh_dir, app_name)
+
+        self.patch_object(ssh_migrations.os, 'mkdir')
+        self.patch_object(ssh_migrations.os.path, 'isdir', side_effect=_isdir)
+        self.patch_object(ssh_migrations.os.path, 'isfile',
+                          side_effect=_isfile)
+
+    def test_ssh_directory_for_unit(self):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=True,
+            app_dir_exists=True,
+            auth_keys_exists=True,
+            known_hosts_exists=True)
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit('nova-compute-lxd'),
+            '/etc/nova/compute_ssh/nova-compute-lxd')
+        self.assertFalse(self.mkdir.called)
+
+    def test_ssh_directory_for_unit_user(self):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=True,
+            app_dir_exists=True,
+            auth_keys_exists=True,
+            known_hosts_exists=True,
+            user='nova')
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit(
+                'nova-compute-lxd',
+                user='nova'),
+            '/etc/nova/compute_ssh/nova-compute-lxd_nova')
+        self.assertFalse(self.mkdir.called)
+
+    def test_ssh_directory_missing_dir(self):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=False,
+            app_dir_exists=True,
+            auth_keys_exists=True,
+            known_hosts_exists=True)
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit('nova-compute-lxd'),
+            '/etc/nova/compute_ssh/nova-compute-lxd')
+        self.mkdir.assert_called_once_with('/etc/nova/compute_ssh/')
+
+    def test_ssh_directory_missing_dirs(self):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=False,
+            app_dir_exists=False,
+            auth_keys_exists=True,
+            known_hosts_exists=True)
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit('nova-compute-lxd'),
+            '/etc/nova/compute_ssh/nova-compute-lxd')
+        mkdir_calls = [
+            mock.call('/etc/nova/compute_ssh/'),
+            mock.call('/etc/nova/compute_ssh/nova-compute-lxd')]
+        self.mkdir.assert_has_calls(mkdir_calls)
+
+    @mock.patch(builtin_open)
+    def test_ssh_directory_missing_file(self, _open):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=True,
+            app_dir_exists=True,
+            auth_keys_exists=False,
+            known_hosts_exists=True)
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit('nova-compute-lxd'),
+            '/etc/nova/compute_ssh/nova-compute-lxd')
+        _open.assert_called_once_with(
+            '/etc/nova/compute_ssh/nova-compute-lxd/authorized_keys',
+            'w')
+        self.assertFalse(self.mkdir.called)
+
+    @mock.patch(builtin_open)
+    def test_ssh_directory_missing_files(self, _open):
+        self.setup_mocks_ssh_directory_for_unit(
+            'nova-compute-lxd',
+            ssh_dir_exists=True,
+            app_dir_exists=True,
+            auth_keys_exists=False,
+            known_hosts_exists=False)
+        self.assertEqual(
+            ssh_migrations.ssh_directory_for_unit('nova-compute-lxd'),
+            '/etc/nova/compute_ssh/nova-compute-lxd')
+        open_calls = [
+            mock.call(
+                '/etc/nova/compute_ssh/nova-compute-lxd/authorized_keys',
+                'w'),
+            mock.call().close(),
+            mock.call(
+                '/etc/nova/compute_ssh/nova-compute-lxd/known_hosts',
+                'w'),
+            mock.call().close()]
+        _open.assert_has_calls(open_calls)
+        self.assertFalse(self.mkdir.called)
+
+    def setup_ssh_directory_for_unit_mocks(self):
+        self.patch_object(
+            ssh_migrations,
+            'ssh_directory_for_unit',
+            return_value='/somedir')
+
+    def test_known_hosts(self):
+        self.setup_ssh_directory_for_unit_mocks()
+        self.assertEqual(
+            ssh_migrations.known_hosts('nova-compute-lxd'),
+            '/somedir/known_hosts')
+
+    def test_authorized_keys(self):
+        self.setup_ssh_directory_for_unit_mocks()
+        self.assertEqual(
+            ssh_migrations.authorized_keys('nova-compute-lxd'),
+            '/somedir/authorized_keys')
+
+    @mock.patch('subprocess.check_output')
+    def test_ssh_known_host_key(self, _check_output):
+        self.setup_ssh_directory_for_unit_mocks()
+        _check_output.return_value = UNIT1_HOST_KEY_1
+        self.assertEqual(
+            ssh_migrations.ssh_known_host_key(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd'),
+            UNIT1_HOST_KEY_1)
+
+    @mock.patch('subprocess.check_output')
+    def test_ssh_known_host_key_multi_match(self, _check_output):
+        self.setup_ssh_directory_for_unit_mocks()
+        _check_output.return_value = '{}\n{}\n'.format(UNIT1_HOST_KEY_1,
+                                                       UNIT1_HOST_KEY_2)
+        self.assertEqual(
+            ssh_migrations.ssh_known_host_key(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd'),
+            UNIT1_HOST_KEY_1)
+
+    @mock.patch('subprocess.check_output')
+    def test_ssh_known_host_key_rc1(self, _check_output):
+        self.setup_ssh_directory_for_unit_mocks()
+        _check_output.side_effect = subprocess.CalledProcessError(
+            cmd=['anything'],
+            returncode=1,
+            output=UNIT1_HOST_KEY_1)
+        self.assertEqual(
+            ssh_migrations.ssh_known_host_key(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd'),
+            UNIT1_HOST_KEY_1)
+
+    @mock.patch('subprocess.check_output')
+    def test_ssh_known_host_key_rc2(self, _check_output):
+        self.setup_ssh_directory_for_unit_mocks()
+        _check_output.side_effect = subprocess.CalledProcessError(
+            cmd=['anything'],
+            returncode=2,
+            output='')
+        with self.assertRaises(subprocess.CalledProcessError):
+            ssh_migrations.ssh_known_host_key(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd')
+
+    @mock.patch('subprocess.check_output')
+    def test_ssh_known_host_key_no_match(self, _check_output):
+        self.setup_ssh_directory_for_unit_mocks()
+        _check_output.return_value = ''
+        self.assertIsNone(
+            ssh_migrations.ssh_known_host_key(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd'))
+
+    @mock.patch('subprocess.check_call')
+    def test_remove_known_host(self, _check_call):
+        self.patch_object(ssh_migrations, 'log')
+        self.setup_ssh_directory_for_unit_mocks()
+        ssh_migrations.remove_known_host(
+            'juju-4665be-20180716142533-8',
+            'nova-compute-lxd')
+        _check_call.assert_called_once_with([
+            'ssh-keygen',
+            '-f',
+            '/somedir/known_hosts',
+            '-R',
+            'juju-4665be-20180716142533-8'])
+
+    def test_is_same_key(self):
+        self.assertTrue(
+            ssh_migrations.is_same_key(UNIT1_HOST_KEY_1, UNIT1_HOST_KEY_2))
+
+    def test_is_same_key_false(self):
+        self.assertFalse(
+            ssh_migrations.is_same_key(UNIT1_HOST_KEY_1, UNIT2_HOST_KEY_1))
+
+    def setup_mocks_add_known_host(self):
+        self.setup_ssh_directory_for_unit_mocks()
+        self.patch_object(ssh_migrations.subprocess, 'check_output')
+        self.patch_object(ssh_migrations, 'log')
+        self.patch_object(ssh_migrations, 'ssh_known_host_key')
+        self.patch_object(ssh_migrations, 'remove_known_host')
+
+    def test_add_known_host(self):
+        self.setup_mocks_add_known_host()
+        self.check_output.return_value = UNIT1_HOST_KEY_1
+        self.ssh_known_host_key.return_value = ''
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.add_known_host(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd')
+            mock_file.write.assert_called_with(UNIT1_HOST_KEY_1 + '\n')
+            mock_open.assert_called_with('/somedir/known_hosts', 'a')
+        self.assertFalse(self.remove_known_host.called)
+
+    def test_add_known_host_existing_invalid_key(self):
+        self.setup_mocks_add_known_host()
+        self.check_output.return_value = UNIT1_HOST_KEY_1
+        self.ssh_known_host_key.return_value = UNIT2_HOST_KEY_1
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.add_known_host(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd')
+            mock_file.write.assert_called_with(UNIT1_HOST_KEY_1 + '\n')
+            mock_open.assert_called_with('/somedir/known_hosts', 'a')
+        self.remove_known_host.assert_called_once_wth(
+            'juju-4665be-20180716142533-8',
+            'nova-compute-lxd')
+
+    def test_add_known_host_existing_valid_key(self):
+        self.setup_mocks_add_known_host()
+        self.check_output.return_value = UNIT2_HOST_KEY_1
+        self.ssh_known_host_key.return_value = UNIT2_HOST_KEY_1
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.add_known_host(
+                'juju-4665be-20180716142533-8',
+                'nova-compute-lxd')
+            self.assertFalse(mock_open.called)
+        self.assertFalse(self.remove_known_host.called)
+
+    def test_ssh_authorized_key_exists(self):
+        self.setup_mocks_add_known_host()
+        contents = '{}\n{}\n'.format(UNIT1_PUBKEY_1, UNIT2_PUBKEY_1)
+        with mock_open('/somedir/authorized_keys', contents=contents):
+            self.assertTrue(
+                ssh_migrations.ssh_authorized_key_exists(
+                    UNIT1_PUBKEY_1,
+                    'nova-compute-lxd'))
+
+    def test_ssh_authorized_key_exists_false(self):
+        self.setup_mocks_add_known_host()
+        contents = '{}\n'.format(UNIT1_PUBKEY_1)
+        with mock_open('/somedir/authorized_keys', contents=contents):
+            self.assertFalse(
+                ssh_migrations.ssh_authorized_key_exists(
+                    UNIT2_PUBKEY_1,
+                    'nova-compute-lxd'))
+
+    def test_add_authorized_key(self):
+        self.setup_mocks_add_known_host()
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.add_authorized_key(
+                UNIT1_PUBKEY_1,
+                'nova-compute-lxd')
+            mock_file.write.assert_called_with(UNIT1_PUBKEY_1 + '\n')
+            mock_open.assert_called_with('/somedir/authorized_keys', 'a')
+
+    def setup_mocks_ssh_compute_add_host_and_key(self):
+        self.setup_ssh_directory_for_unit_mocks()
+        self.patch_object(ssh_migrations, 'log')
+        self.patch_object(ssh_migrations, 'get_hostname')
+        self.patch_object(ssh_migrations, 'get_host_ip')
+        self.patch_object(ssh_migrations, 'ns_query')
+        self.patch_object(ssh_migrations, 'add_known_host')
+        self.patch_object(ssh_migrations, 'ssh_authorized_key_exists')
+        self.patch_object(ssh_migrations, 'add_authorized_key')
+
+    def test_ssh_compute_add_host_and_key(self):
+        self.setup_mocks_ssh_compute_add_host_and_key()
+        self.get_hostname.return_value = 'alt-hostname.project.serverstack'
+        self.ns_query.return_value = '10.6.0.17'
+        ssh_migrations.ssh_compute_add_host_and_key(
+            UNIT1_PUBKEY_1,
+            'juju-4665be-20180716142533-8.project.serverstack',
+            '10.5.0.17',
+            'nova-compute-lxd')
+        expect_hosts = [
+            'juju-4665be-20180716142533-8.project.serverstack',
+            'alt-hostname.project.serverstack',
+            'alt-hostname']
+        add_known_host_calls = []
+        for host in expect_hosts:
+            add_known_host_calls.append(
+                mock.call(host, 'nova-compute-lxd', None))
+        self.add_known_host.assert_has_calls(
+            add_known_host_calls,
+            any_order=True)
+        self.add_authorized_key.assert_called_once_with(
+            UNIT1_PUBKEY_1,
+            'nova-compute-lxd',
+            None)
+
+    def test_ssh_compute_add_host_and_key_priv_addr_not_ip(self):
+        self.setup_mocks_ssh_compute_add_host_and_key()
+        self.get_hostname.return_value = 'alt-hostname.project.serverstack'
+        self.ns_query.return_value = '10.6.0.17'
+        self.get_host_ip.return_value = '10.6.0.17'
+        ssh_migrations.ssh_compute_add_host_and_key(
+            UNIT1_PUBKEY_1,
+            'juju-4665be-20180716142533-8.project.serverstack',
+            'bob.maas',
+            'nova-compute-lxd')
+        expect_hosts = [
+            'bob.maas',
+            'juju-4665be-20180716142533-8.project.serverstack',
+            '10.6.0.17',
+            'bob']
+        add_known_host_calls = []
+        for host in expect_hosts:
+            add_known_host_calls.append(
+                mock.call(host, 'nova-compute-lxd', None))
+        self.add_known_host.assert_has_calls(
+            add_known_host_calls,
+            any_order=True)
+        self.add_authorized_key.assert_called_once_with(
+            UNIT1_PUBKEY_1,
+            'nova-compute-lxd',
+            None)
+
+    def test_ssh_compute_add_host_and_key_ipv6(self):
+        self.setup_mocks_ssh_compute_add_host_and_key()
+        ssh_migrations.ssh_compute_add_host_and_key(
+            UNIT1_PUBKEY_1,
+            'juju-4665be-20180716142533-8.project.serverstack',
+            'fe80::8842:a9ff:fe53:72e4',
+            'nova-compute-lxd')
+        self.add_known_host.assert_called_once_with(
+            'fe80::8842:a9ff:fe53:72e4',
+            'nova-compute-lxd',
+            None)
+        self.add_authorized_key.assert_called_once_with(
+            UNIT1_PUBKEY_1,
+            'nova-compute-lxd',
+            None)
+
+    @mock.patch.object(ssh_migrations, 'ssh_compute_add_host_and_key')
+    @mock.patch.object(ssh_migrations, 'relation_get')
+    def test_ssh_compute_add(self, _relation_get,
+                             _ssh_compute_add_host_and_key):
+        _relation_get.return_value = {
+            'hostname': 'juju-4665be-20180716142533-8.project.serverstack',
+            'private-address': '10.5.0.17',
+        }
+        ssh_migrations.ssh_compute_add(
+            UNIT1_PUBKEY_1,
+            'nova-compute-lxd',
+            rid='cloud-compute:23',
+            unit='nova-compute-lxd/2')
+        _ssh_compute_add_host_and_key.assert_called_once_with(
+            UNIT1_PUBKEY_1,
+            'juju-4665be-20180716142533-8.project.serverstack',
+            '10.5.0.17',
+            'nova-compute-lxd',
+            user=None)
+
+    @mock.patch.object(ssh_migrations, 'known_hosts')
+    def test_ssh_known_hosts_lines(self, _known_hosts):
+        _known_hosts.return_value = '/somedir/known_hosts'
+        contents = '\n'.join(HOST_KEYS)
+        with mock_open('/somedir/known_hosts', contents=contents):
+            self.assertEqual(
+                ssh_migrations.ssh_known_hosts_lines('nova-compute-lxd'),
+                HOST_KEYS)
+
+    @mock.patch.object(ssh_migrations, 'authorized_keys')
+    def test_ssh_authorized_keys_lines(self, _authorized_keys):
+        _authorized_keys.return_value = '/somedir/authorized_keys'
+        contents = '\n'.join(PUB_KEYS)
+        with mock_open('/somedir/authorized_keys', contents=contents):
+            self.assertEqual(
+                ssh_migrations.ssh_authorized_keys_lines('nova-compute-lxd'),
+                PUB_KEYS)
+
+    def setup_mocks_ssh_compute_remove(self, isfile, authorized_keys_lines):
+        self.patch_object(
+            ssh_migrations,
+            'ssh_authorized_keys_lines',
+            return_value=authorized_keys_lines)
+        self.patch_object(ssh_migrations, 'known_hosts')
+        self.patch_object(
+            ssh_migrations,
+            'authorized_keys',
+            return_value='/somedir/authorized_keys')
+        self.patch_object(
+            ssh_migrations.os.path,
+            'isfile',
+            return_value=isfile)
+
+    def test_ssh_compute_remove(self):
+        self.setup_mocks_ssh_compute_remove(
+            isfile=True,
+            authorized_keys_lines=PUB_KEYS)
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.ssh_compute_remove(
+                UNIT1_PUBKEY_1,
+                'nova-compute-lxd')
+            mock_file.write.assert_called_with(UNIT2_PUBKEY_1 + '\n')
+            mock_open.assert_called_with('/somedir/authorized_keys', 'w')
+
+    def test_ssh_compute_remove_missing_file(self):
+        self.setup_mocks_ssh_compute_remove(
+            isfile=False,
+            authorized_keys_lines=PUB_KEYS)
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.ssh_compute_remove(
+                UNIT1_PUBKEY_1,
+                'nova-compute-lxd')
+            self.assertFalse(mock_file.write.called)
+
+    def test_ssh_compute_remove_missing_key(self):
+        self.setup_mocks_ssh_compute_remove(
+            isfile=False,
+            authorized_keys_lines=[UNIT2_PUBKEY_1])
+        with patch_open() as (mock_open, mock_file):
+            ssh_migrations.ssh_compute_remove(
+                UNIT1_PUBKEY_1,
+                'nova-compute-lxd')
+            self.assertFalse(mock_file.write.called)
+
+    @mock.patch.object(ssh_migrations, 'ssh_known_hosts_lines')
+    @mock.patch.object(ssh_migrations, 'ssh_authorized_keys_lines')
+    def test_get_ssh_settings(self, _ssh_authorized_keys_lines,
+                              _ssh_known_hosts_lines):
+        _ssh_authorized_keys_lines.return_value = PUB_KEYS
+        _ssh_known_hosts_lines.return_value = HOST_KEYS
+        expect = {
+            'known_hosts_0': UNIT1_HOST_KEY_1,
+            'known_hosts_1': UNIT1_HOST_KEY_2,
+            'known_hosts_2': UNIT2_HOST_KEY_1,
+            'known_hosts_3': UNIT2_HOST_KEY_2,
+            'known_hosts_max_index': 4,
+            'authorized_keys_0': UNIT1_PUBKEY_1,
+            'authorized_keys_1': UNIT2_PUBKEY_1,
+            'authorized_keys_max_index': 2,
+        }
+        self.assertEqual(
+            ssh_migrations.get_ssh_settings('nova-compute-lxd'),
+            expect)
+
+    @mock.patch.object(ssh_migrations, 'ssh_known_hosts_lines')
+    @mock.patch.object(ssh_migrations, 'ssh_authorized_keys_lines')
+    def test_get_ssh_settings_user(self, _ssh_authorized_keys_lines,
+                                   _ssh_known_hosts_lines):
+        _ssh_authorized_keys_lines.return_value = PUB_KEYS
+        _ssh_known_hosts_lines.return_value = HOST_KEYS
+        expect = {
+            'nova_known_hosts_0': UNIT1_HOST_KEY_1,
+            'nova_known_hosts_1': UNIT1_HOST_KEY_2,
+            'nova_known_hosts_2': UNIT2_HOST_KEY_1,
+            'nova_known_hosts_3': UNIT2_HOST_KEY_2,
+            'nova_known_hosts_max_index': 4,
+            'nova_authorized_keys_0': UNIT1_PUBKEY_1,
+            'nova_authorized_keys_1': UNIT2_PUBKEY_1,
+            'nova_authorized_keys_max_index': 2,
+        }
+        self.assertEqual(
+            ssh_migrations.get_ssh_settings('nova-compute-lxd', user='nova'),
+            expect)
+
+    @mock.patch.object(ssh_migrations, 'ssh_known_hosts_lines')
+    @mock.patch.object(ssh_migrations, 'ssh_authorized_keys_lines')
+    def test_get_ssh_settings_empty(self, _ssh_authorized_keys_lines,
+                                    _ssh_known_hosts_lines):
+        _ssh_authorized_keys_lines.return_value = []
+        _ssh_known_hosts_lines.return_value = []
+        self.assertEqual(
+            ssh_migrations.get_ssh_settings('nova-compute-lxd'),
+            {})
+
+    @mock.patch.object(ssh_migrations, 'get_ssh_settings')
+    def test_get_all_user_ssh_settings(self, _get_ssh_settings):
+        def ssh_setiings(application_name, user=None):
+            base_settings = {
+                'known_hosts_0': UNIT1_HOST_KEY_1,
+                'known_hosts_max_index': 1,
+                'authorized_keys_0': UNIT1_PUBKEY_1,
+                'authorized_keys_max_index': 1}
+            user_settings = {
+                'nova_known_hosts_0': UNIT1_HOST_KEY_1,
+                'nova_known_hosts_max_index': 1,
+                'nova_authorized_keys_0': UNIT1_PUBKEY_1,
+                'nova_authorized_keys_max_index': 1}
+            if user:
+                return user_settings
+            else:
+                return base_settings
+        _get_ssh_settings.side_effect = ssh_setiings
+        expect = {
+            'known_hosts_0': UNIT1_HOST_KEY_1,
+            'known_hosts_max_index': 1,
+            'authorized_keys_0': UNIT1_PUBKEY_1,
+            'authorized_keys_max_index': 1,
+            'nova_known_hosts_0': UNIT1_HOST_KEY_1,
+            'nova_known_hosts_max_index': 1,
+            'nova_authorized_keys_0': UNIT1_PUBKEY_1,
+            'nova_authorized_keys_max_index': 1}
+        self.assertEqual(
+            ssh_migrations.get_all_user_ssh_settings('nova-compute-lxd'),
+            expect)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_vaultlocker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_vaultlocker.py
new file mode 100644
index 0000000000000000000000000000000000000000..496fd56fdd1b6e1dab0d5abb5b08a82e40d94393
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/openstack/test_vaultlocker.py
@@ -0,0 +1,261 @@
+# Copyright 2018 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import mock
+import os
+import sys
+import unittest
+
+import charmhelpers.contrib.openstack.vaultlocker as vaultlocker
+
+from .test_os_contexts import TestDB
+
+
+INCOMPLETE_RELATION = {
+    'secrets-storage:1': {
+        'vault/0': {}
+    }
+}
+
+COMPLETE_RELATION = {
+    'secrets-storage:1': {
+        'vault/0': {
+            'vault_url': json.dumps('http://vault:8200'),
+            'test-service/0_role_id': json.dumps('test-role-from-vault'),
+            'test-service/0_token':
+                json.dumps('00c9a9ab-c523-459d-a250-2ce8f0877c03'),
+        }
+    }
+}
+
+DIRTY_RELATION = {
+    'secrets-storage:1': {
+        'vault/0': {
+            'vault_url': json.dumps('http://vault:8200'),
+            'test-service/0_role_id': json.dumps('test-role-from-vault'),
+            'test-service/0_token':
+                json.dumps('00c9a9ab-c523-459d-a250-2ce8f0877c03'),
+        },
+        'vault/1': {
+            'vault_url': json.dumps('http://vault:8200'),
+            'test-service/0_role_id': json.dumps('test-role-from-vault'),
+            'test-service/0_token':
+                json.dumps('67b36149-dc86-4b80-96c4-35b91847d16e'),
+        }
+    }
+}
+
+COMPLETE_WITH_CA_RELATION = {
+    'secrets-storage:1': {
+        'vault/0': {
+            'vault_url': json.dumps('http://vault:8200'),
+            'test-service/0_role_id': json.dumps('test-role-from-vault'),
+            'test-service/0_token':
+                json.dumps('00c9a9ab-c523-459d-a250-2ce8f0877c03'),
+            'vault_ca': json.dumps('test-ca-data'),
+        }
+    }
+}
+
+
+class VaultLockerTestCase(unittest.TestCase):
+
+    to_patch = [
+        'hookenv',
+        'templating',
+        'alternatives',
+        'host',
+        'unitdata',
+    ]
+
+    _target_path = '/var/lib/charm/test-service/vaultlocker.conf'
+
+    def setUp(self):
+        for m in self.to_patch:
+            setattr(self, m, self._patch(m))
+        self.hookenv.service_name.return_value = 'test-service'
+        self.hookenv.local_unit.return_value = 'test-service/0'
+        self.db = TestDB()
+        self.unitdata.kv.return_value = self.db
+        fake_exc = mock.MagicMock()
+        fake_exc.InvalidRequest = Exception
+        self.fake_hvac = mock.MagicMock()
+        self.fake_hvac.exceptions = fake_exc
+        sys.modules['hvac'] = self.fake_hvac
+
+    def fake_retrieve_secret_id(self, url=None, token=None):
+        if token == self.good_token:
+            return '31be8e65-20a3-45e0-a4a8-4d5a0554fb60'
+        else:
+            raise self.fake_hvac.exceptions.InvalidRequest
+
+    def _patch(self, target):
+        _m = mock.patch.object(vaultlocker, target)
+        _mock = _m.start()
+        self.addCleanup(_m.stop)
+        return _mock
+
+    def test_write_vl_config(self):
+        ctxt = {'test': 'data'}
+        vaultlocker.write_vaultlocker_conf(context=ctxt)
+        self.hookenv.service_name.assert_called_once_with()
+        self.host.mkdir.assert_called_once_with(
+            os.path.dirname(self._target_path),
+            perms=0o700
+        )
+        self.templating.render.assert_called_once_with(
+            source='vaultlocker.conf.j2',
+            target=self._target_path,
+            context=ctxt,
+            perms=0o600,
+        )
+        self.alternatives.install_alternative.assert_called_once_with(
+            'vaultlocker.conf',
+            '/etc/vaultlocker/vaultlocker.conf',
+            self._target_path,
+            100
+        )
+
+    def test_write_vl_config_priority(self):
+        ctxt = {'test': 'data'}
+        vaultlocker.write_vaultlocker_conf(context=ctxt, priority=200)
+        self.hookenv.service_name.assert_called_once_with()
+        self.host.mkdir.assert_called_once_with(
+            os.path.dirname(self._target_path),
+            perms=0o700
+        )
+        self.templating.render.assert_called_once_with(
+            source='vaultlocker.conf.j2',
+            target=self._target_path,
+            context=ctxt,
+            perms=0o600,
+        )
+        self.alternatives.install_alternative.assert_called_once_with(
+            'vaultlocker.conf',
+            '/etc/vaultlocker/vaultlocker.conf',
+            self._target_path,
+            200
+        )
+
+    def _setup_relation(self, relation):
+        self.hookenv.relation_ids.side_effect = (
+            lambda _: relation.keys()
+        )
+        self.hookenv.related_units.side_effect = (
+            lambda rid: relation[rid].keys()
+        )
+        self.hookenv.relation_get.side_effect = (
+            lambda unit, rid:
+                relation[rid][unit]
+        )
+
+    def test_context_incomplete(self):
+        self._setup_relation(INCOMPLETE_RELATION)
+        context = vaultlocker.VaultKVContext('charm-test')
+        self.assertEqual(context(), {})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertFalse(vaultlocker.vault_relation_complete())
+
+    @mock.patch.object(vaultlocker, 'retrieve_secret_id')
+    def test_context_complete(self, retrieve_secret_id):
+        self._setup_relation(COMPLETE_RELATION)
+        context = vaultlocker.VaultKVContext('charm-test')
+        retrieve_secret_id.return_value = 'a3551c8d-0147-4cb6-afc6-efb3db2fccb2'
+        self.assertEqual(context(),
+                         {'role_id': 'test-role-from-vault',
+                          'secret_backend': 'charm-test',
+                          'secret_id': 'a3551c8d-0147-4cb6-afc6-efb3db2fccb2',
+                          'vault_url': 'http://vault:8200'})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertTrue(vaultlocker.vault_relation_complete())
+        calls = [mock.call(url='http://vault:8200',
+                           token='00c9a9ab-c523-459d-a250-2ce8f0877c03')]
+        retrieve_secret_id.assert_has_calls(calls)
+
+    @mock.patch.object(vaultlocker, 'retrieve_secret_id')
+    def test_context_complete_cached_secret_id(self, retrieve_secret_id):
+        self._setup_relation(COMPLETE_RELATION)
+        context = vaultlocker.VaultKVContext('charm-test')
+        self.db.set('secret-id', '5502fd27-059b-4b0a-91b2-eaff40b6a112')
+        self.good_token = 'invalid-token'  # i.e. cause failure
+        retrieve_secret_id.side_effect = self.fake_retrieve_secret_id
+        self.assertEqual(context(),
+                         {'role_id': 'test-role-from-vault',
+                          'secret_backend': 'charm-test',
+                          'secret_id': '5502fd27-059b-4b0a-91b2-eaff40b6a112',
+                          'vault_url': 'http://vault:8200'})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertTrue(vaultlocker.vault_relation_complete())
+        calls = [mock.call(url='http://vault:8200',
+                           token='00c9a9ab-c523-459d-a250-2ce8f0877c03')]
+        retrieve_secret_id.assert_has_calls(calls)
+
+    @mock.patch.object(vaultlocker, 'retrieve_secret_id')
+    def test_purge_old_tokens(self, retrieve_secret_id):
+        self._setup_relation(DIRTY_RELATION)
+        context = vaultlocker.VaultKVContext('charm-test')
+        self.db.set('secret-id', '5502fd27-059b-4b0a-91b2-eaff40b6a112')
+        self.good_token = '67b36149-dc86-4b80-96c4-35b91847d16e'
+        retrieve_secret_id.side_effect = self.fake_retrieve_secret_id
+        self.assertEqual(context(),
+                         {'role_id': 'test-role-from-vault',
+                          'secret_backend': 'charm-test',
+                          'secret_id': '31be8e65-20a3-45e0-a4a8-4d5a0554fb60',
+                          'vault_url': 'http://vault:8200'})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertTrue(vaultlocker.vault_relation_complete())
+        self.assertEquals(self.db.get('secret-id'),
+                          '31be8e65-20a3-45e0-a4a8-4d5a0554fb60')
+        calls = [mock.call(url='http://vault:8200',
+                           token='67b36149-dc86-4b80-96c4-35b91847d16e')]
+        retrieve_secret_id.assert_has_calls(calls)
+
+    @mock.patch.object(vaultlocker, 'retrieve_secret_id')
+    def test_context_complete_cached_dirty_data(self, retrieve_secret_id):
+        self._setup_relation(DIRTY_RELATION)
+        context = vaultlocker.VaultKVContext('charm-test')
+        self.db.set('secret-id', '5502fd27-059b-4b0a-91b2-eaff40b6a112')
+        self.good_token = '67b36149-dc86-4b80-96c4-35b91847d16e'
+        retrieve_secret_id.side_effect = self.fake_retrieve_secret_id
+        self.assertEqual(context(),
+                         {'role_id': 'test-role-from-vault',
+                          'secret_backend': 'charm-test',
+                          'secret_id': '31be8e65-20a3-45e0-a4a8-4d5a0554fb60',
+                          'vault_url': 'http://vault:8200'})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertTrue(vaultlocker.vault_relation_complete())
+        self.assertEquals(self.db.get('secret-id'),
+                          '31be8e65-20a3-45e0-a4a8-4d5a0554fb60')
+        calls = [mock.call(url='http://vault:8200',
+                           token='67b36149-dc86-4b80-96c4-35b91847d16e')]
+        retrieve_secret_id.assert_has_calls(calls)
+
+    @mock.patch.object(vaultlocker, 'retrieve_secret_id')
+    def test_context_complete_with_ca(self, retrieve_secret_id):
+        self._setup_relation(COMPLETE_WITH_CA_RELATION)
+        retrieve_secret_id.return_value = 'token1234'
+        context = vaultlocker.VaultKVContext('charm-test')
+        retrieve_secret_id.return_value = 'a3551c8d-0147-4cb6-afc6-efb3db2fccb2'
+        self.assertEqual(context(),
+                         {'role_id': 'test-role-from-vault',
+                          'secret_backend': 'charm-test',
+                          'secret_id': 'a3551c8d-0147-4cb6-afc6-efb3db2fccb2',
+                          'vault_url': 'http://vault:8200',
+                          'vault_ca': 'test-ca-data'})
+        self.hookenv.relation_ids.assert_called_with('secrets-storage')
+        self.assertTrue(vaultlocker.vault_relation_complete())
+        calls = [mock.call(url='http://vault:8200',
+                           token='00c9a9ab-c523-459d-a250-2ce8f0877c03')]
+        retrieve_secret_id.assert_has_calls(calls)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/peerstorage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/peerstorage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/peerstorage/test_peerstorage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/peerstorage/test_peerstorage.py
new file mode 100644
index 0000000000000000000000000000000000000000..63b71366dd9e190e91ca2359210d63b45b4719a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/peerstorage/test_peerstorage.py
@@ -0,0 +1,337 @@
+import copy
+import json
+
+from tests.helpers import FakeRelation
+from testtools import TestCase
+from mock import patch, call
+from charmhelpers.contrib import peerstorage
+
+
+TO_PATCH = [
+    'current_relation_id',
+    'is_relation_made',
+    'local_unit',
+    'relation_get',
+    '_relation_get',
+    'relation_ids',
+    'relation_set',
+    '_relation_set',
+    '_leader_get',
+    'leader_set',
+    'is_leader',
+]
+FAKE_RELATION_NAME = 'cluster'
+FAKE_RELATION = {
+    'cluster:0': {
+        'cluster/0': {
+        },
+        'cluster/1': {
+        },
+        'cluster/2': {
+        },
+    },
+
+}
+FAKE_RELATION_IDS = ['cluster:0']
+FAKE_LOCAL_UNIT = 'test_host'
+
+
+class TestPeerStorage(TestCase):
+    def setUp(self):
+        super(TestPeerStorage, self).setUp()
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+        self.fake_relation_name = FAKE_RELATION_NAME
+        self.fake_relation = FakeRelation(FAKE_RELATION)
+        self.local_unit.return_value = FAKE_LOCAL_UNIT
+        self.relation_get.return_value = {'key1': 'value1',
+                                          'key2': 'value2',
+                                          'private-address': '127.0.0.1',
+                                          'public-address': '91.189.90.159'}
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.peerstorage.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_peer_retrieve_no_relation(self):
+        self.relation_ids.return_value = []
+        self.assertRaises(ValueError, peerstorage.peer_retrieve, 'key', relation_name=self.fake_relation_name)
+
+    def test_peer_retrieve_with_relation(self):
+        self.relation_ids.return_value = FAKE_RELATION_IDS
+        peerstorage.peer_retrieve('key', self.fake_relation_name)
+        self.relation_get.assert_called_with(attribute='key', rid=FAKE_RELATION_IDS[0], unit=FAKE_LOCAL_UNIT)
+
+    def test_peer_store_no_relation(self):
+        self.relation_ids.return_value = []
+        self.assertRaises(ValueError, peerstorage.peer_store, 'key', 'value', relation_name=self.fake_relation_name)
+
+    def test_peer_store_with_relation(self):
+        self.relation_ids.return_value = FAKE_RELATION_IDS
+        peerstorage.peer_store('key', 'value', self.fake_relation_name)
+        self.relation_set.assert_called_with(relation_id=FAKE_RELATION_IDS[0],
+                                             relation_settings={'key': 'value'})
+
+    def test_peer_echo_no_includes(self):
+        peerstorage.is_leader.side_effect = NotImplementedError
+        settings = {'key1': 'value1', 'key2': 'value2'}
+        self._relation_get.copy.return_value = settings
+        self._relation_get.return_value = settings
+        peerstorage.peer_echo()
+        self._relation_set.assert_called_with(relation_settings=settings)
+
+    def test_peer_echo_includes(self):
+        peerstorage.is_leader.side_effect = NotImplementedError
+        settings = {'key1': 'value1'}
+        self._relation_get.copy.return_value = settings
+        self._relation_get.return_value = settings
+        peerstorage.peer_echo(['key1'])
+        self._relation_set.assert_called_with(relation_settings=settings)
+
+    @patch.object(peerstorage, 'peer_store')
+    def test_peer_store_and_set_no_relation(self, peer_store):
+        self.is_relation_made.return_value = False
+        peerstorage.peer_store_and_set(relation_id='db', kwarg1='kwarg1_v')
+        self.relation_set.assert_called_with(relation_id='db',
+                                             relation_settings={},
+                                             kwarg1='kwarg1_v')
+        peer_store.assert_not_called()
+
+    @patch.object(peerstorage, 'peer_store')
+    def test_peer_store_and_set_no_relation_fatal(self, peer_store):
+        self.is_relation_made.return_value = False
+        self.assertRaises(ValueError,
+                          peerstorage.peer_store_and_set,
+                          relation_id='db',
+                          kwarg1='kwarg1_v',
+                          peer_store_fatal=True)
+
+    @patch.object(peerstorage, 'peer_store')
+    def test_peer_store_and_set_kwargs(self, peer_store):
+        self.is_relation_made.return_value = True
+        peerstorage.peer_store_and_set(relation_id='db', kwarg1='kwarg1_v')
+        self.relation_set.assert_called_with(relation_id='db',
+                                             relation_settings={},
+                                             kwarg1='kwarg1_v')
+        calls = [call('db_kwarg1', 'kwarg1_v', relation_name='cluster')]
+        peer_store.assert_has_calls(calls, any_order=True)
+
+    @patch.object(peerstorage, 'peer_store')
+    def test_peer_store_and_rel_settings(self, peer_store):
+        self.is_relation_made.return_value = True
+        rel_setting = {
+            'rel_set1': 'relset1_v'
+        }
+        peerstorage.peer_store_and_set(relation_id='db',
+                                       relation_settings=rel_setting)
+        self.relation_set.assert_called_with(relation_id='db',
+                                             relation_settings=rel_setting)
+        calls = [call('db_rel_set1', 'relset1_v', relation_name='cluster')]
+        peer_store.assert_has_calls(calls, any_order=True)
+
+    @patch.object(peerstorage, 'peer_store')
+    def test_peer_store_and_set(self, peer_store):
+        self.is_relation_made.return_value = True
+        rel_setting = {
+            'rel_set1': 'relset1_v'
+        }
+        peerstorage.peer_store_and_set(relation_id='db',
+                                       relation_settings=rel_setting,
+                                       kwarg1='kwarg1_v',
+                                       delimiter='+')
+        self.relation_set.assert_called_with(relation_id='db',
+                                             relation_settings=rel_setting,
+                                             kwarg1='kwarg1_v')
+        calls = [call('db+rel_set1', 'relset1_v', relation_name='cluster'),
+                 call('db+kwarg1', 'kwarg1_v', relation_name='cluster')]
+        peer_store.assert_has_calls(calls, any_order=True)
+
+    @patch.object(peerstorage, 'peer_retrieve')
+    def test_peer_retrieve_by_prefix(self, peer_retrieve):
+        rel_id = 'db:2'
+        settings = {
+            'user': 'bob',
+            'pass': 'reallyhardpassword',
+            'host': 'myhost',
+        }
+        peer_settings = {rel_id + '_' + k: v for k, v in settings.items()}
+        peer_retrieve.return_value = peer_settings
+        self.assertEquals(peerstorage.peer_retrieve_by_prefix(rel_id), settings)
+
+    @patch.object(peerstorage, 'peer_retrieve')
+    def test_peer_retrieve_by_prefix_empty_relation(self, peer_retrieve):
+        # If relation-get returns None, peer_retrieve_by_prefix returns
+        # an empty dictionary.
+        peer_retrieve.return_value = None
+        rel_id = 'db:2'
+        self.assertEquals(peerstorage.peer_retrieve_by_prefix(rel_id), {})
+
+    @patch.object(peerstorage, 'peer_retrieve')
+    def test_peer_retrieve_by_prefix_exc_list(self, peer_retrieve):
+        rel_id = 'db:2'
+        settings = {
+            'user': 'bob',
+            'pass': 'reallyhardpassword',
+            'host': 'myhost',
+        }
+        peer_settings = {rel_id + '_' + k: v for k, v in settings.items()}
+        del settings['host']
+        peer_retrieve.return_value = peer_settings
+        self.assertEquals(peerstorage.peer_retrieve_by_prefix(rel_id,
+                                                              exc_list=['host']),
+                          settings)
+
+    @patch.object(peerstorage, 'peer_retrieve')
+    def test_peer_retrieve_by_prefix_inc_list(self, peer_retrieve):
+        rel_id = 'db:2'
+        settings = {
+            'user': 'bob',
+            'pass': 'reallyhardpassword',
+            'host': 'myhost',
+        }
+        peer_settings = {rel_id + '_' + k: v for k, v in settings.items()}
+        peer_retrieve.return_value = peer_settings
+        self.assertEquals(peerstorage.peer_retrieve_by_prefix(rel_id,
+                                                              inc_list=['host']),
+                          {'host': 'myhost'})
+
+    def test_leader_get_migration_is_leader(self):
+        self.is_leader.return_value = True
+        l_settings = {'s3': 3}
+        r_settings = {'s1': 1, 's2': 2}
+
+        def mock_relation_get(attribute=None, unit=None, rid=None):
+            if attribute:
+                if attribute in r_settings:
+                    return r_settings.get(attribute)
+                else:
+                    return None
+
+            return copy.deepcopy(r_settings)
+
+        def mock_leader_get(attribute=None):
+            if attribute:
+                if attribute in l_settings:
+                    return l_settings.get(attribute)
+                else:
+                    return None
+
+            return copy.deepcopy(l_settings)
+
+        def mock_leader_set(settings=None, **kwargs):
+            if settings:
+                l_settings.update(settings)
+
+            l_settings.update(kwargs)
+
+        def check_leader_db(dicta, dictb):
+            _dicta = copy.deepcopy(dicta)
+            _dictb = copy.deepcopy(dictb)
+            miga = json.loads(_dicta[migration_key]).sort()
+            migb = json.loads(_dictb[migration_key]).sort()
+            self.assertEqual(miga, migb)
+            del _dicta[migration_key]
+            del _dictb[migration_key]
+            self.assertEqual(_dicta, _dictb)
+
+        migration_key = '__leader_get_migrated_settings__'
+        self._relation_get.side_effect = mock_relation_get
+        self._leader_get.side_effect = mock_leader_get
+        self.leader_set.side_effect = mock_leader_set
+
+        self.assertEqual({'s1': 1, 's2': 2}, peerstorage._relation_get())
+        self.assertEqual({'s3': 3}, peerstorage._leader_get())
+        self.assertEqual({'s1': 1, 's2': 2, 's3': 3}, peerstorage.leader_get())
+        check_leader_db({'s1': 1, 's2': 2, 's3': 3,
+                         migration_key: '["s2", "s1"]'}, l_settings)
+        self.assertTrue(peerstorage.leader_set.called)
+
+        peerstorage.leader_set.reset_mock()
+        self.assertEqual({'s1': 1, 's2': 2, 's3': 3}, peerstorage.leader_get())
+        check_leader_db({'s1': 1, 's2': 2, 's3': 3,
+                         migration_key: '["s2", "s1"]'}, l_settings)
+        self.assertFalse(peerstorage.leader_set.called)
+
+        l_settings = {'s3': 3}
+        peerstorage.leader_set.reset_mock()
+        self.assertEqual(1, peerstorage.leader_get('s1'))
+        check_leader_db({'s1': 1, 's3': 3,
+                         migration_key: '["s1"]'}, l_settings)
+        self.assertTrue(peerstorage.leader_set.called)
+
+        # Test that leader vals take precedence over non-leader vals
+        r_settings['s3'] = 2
+        r_settings['s4'] = 3
+        l_settings['s4'] = 4
+
+        peerstorage.leader_set.reset_mock()
+        self.assertEqual(4, peerstorage.leader_get('s4'))
+        check_leader_db({'s1': 1, 's3': 3, 's4': 4,
+                         migration_key: '["s1", "s4"]'}, l_settings)
+        self.assertTrue(peerstorage.leader_set.called)
+
+        peerstorage.leader_set.reset_mock()
+        self.assertEqual({'s1': 1, 's2': 2, 's3': 2, 's4': 3},
+                         peerstorage._relation_get())
+        check_leader_db({'s1': 1, 's3': 3, 's4': 4,
+                         migration_key: '["s1", "s4"]'},
+                        peerstorage._leader_get())
+        self.assertEqual({'s1': 1, 's2': 2, 's3': 3, 's4': 4},
+                         peerstorage.leader_get())
+        check_leader_db({'s1': 1, 's2': 2, 's3': 3, 's4': 4,
+                         migration_key: '["s3", "s2", "s1", "s4"]'},
+                        l_settings)
+        self.assertTrue(peerstorage.leader_set.called)
+
+    def test_leader_get_migration_is_not_leader(self):
+        self.is_leader.return_value = False
+        l_settings = {'s3': 3}
+        r_settings = {'s1': 1, 's2': 2}
+
+        def mock_relation_get(attribute=None, unit=None, rid=None):
+            if attribute:
+                if attribute in r_settings:
+                    return r_settings.get(attribute)
+                else:
+                    return None
+
+            return copy.deepcopy(r_settings)
+
+        def mock_leader_get(attribute=None):
+            if attribute:
+                if attribute in l_settings:
+                    return l_settings.get(attribute)
+                else:
+                    return None
+
+            return copy.deepcopy(l_settings)
+
+        def mock_leader_set(settings=None, **kwargs):
+            if settings:
+                l_settings.update(settings)
+
+            l_settings.update(kwargs)
+
+        self._relation_get.side_effect = mock_relation_get
+        self._leader_get.side_effect = mock_leader_get
+        self.leader_set.side_effect = mock_leader_set
+        self.assertEqual({'s1': 1, 's2': 2}, peerstorage._relation_get())
+        self.assertEqual({'s3': 3}, peerstorage._leader_get())
+        self.assertEqual({'s3': 3}, peerstorage.leader_get())
+        self.assertEqual({'s3': 3}, l_settings)
+        self.assertFalse(peerstorage.leader_set.called)
+
+        self.assertEqual({'s3': 3}, peerstorage.leader_get())
+        self.assertEqual({'s3': 3}, l_settings)
+        self.assertFalse(peerstorage.leader_set.called)
+
+        # Test that leader vals take precedence over non-leader vals
+        r_settings['s3'] = 2
+        r_settings['s4'] = 3
+        l_settings['s4'] = 4
+
+        self.assertEqual(4, peerstorage.leader_get('s4'))
+        self.assertEqual({'s3': 3, 's4': 4}, l_settings)
+        self.assertFalse(peerstorage.leader_set.called)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/python/test_python.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/python/test_python.py
new file mode 100644
index 0000000000000000000000000000000000000000..59c8b6ede89eda52c0fd4eda8e6275bce7aac68e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/python/test_python.py
@@ -0,0 +1,23 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+from __future__ import absolute_import
+
+from unittest import TestCase
+
+from charmhelpers.fetch.python import debug
+from charmhelpers.fetch.python import packages
+from charmhelpers.fetch.python import rpdb
+from charmhelpers.fetch.python import version
+from charmhelpers.contrib.python import debug as contrib_debug
+from charmhelpers.contrib.python import packages as contrib_packages
+from charmhelpers.contrib.python import rpdb as contrib_rpdb
+from charmhelpers.contrib.python import version as contrib_version
+
+
+class ContribDebugTestCase(TestCase):
+    def test_aliases(self):
+        assert contrib_debug is debug
+        assert contrib_packages is packages
+        assert contrib_rpdb is rpdb
+        assert contrib_version is version
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/saltstack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/saltstack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/saltstack/test_saltstates.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/saltstack/test_saltstates.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9ac35ea80c842cc3a2330066c7e7a3a05154d8b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/saltstack/test_saltstates.py
@@ -0,0 +1,75 @@
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import mock
+import unittest
+
+import charmhelpers.contrib.saltstack
+
+
+class InstallSaltSupportTestCase(unittest.TestCase):
+
+    def setUp(self):
+        super(InstallSaltSupportTestCase, self).setUp()
+
+        patcher = mock.patch('charmhelpers.contrib.saltstack.subprocess')
+        self.mock_subprocess = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        patcher = mock.patch('charmhelpers.fetch')
+        self.mock_charmhelpers_fetch = patcher.start()
+        self.addCleanup(patcher.stop)
+
+    def test_adds_ppa_by_default(self):
+        charmhelpers.contrib.saltstack.install_salt_support()
+
+        expected_calls = [((cmd,), {}) for cmd in [
+            ['/usr/bin/add-apt-repository', '--yes', 'ppa:saltstack/salt'],
+            ['/usr/bin/apt-get', 'update'],
+        ]]
+        self.assertEqual(self.mock_subprocess.check_call.call_count, 2)
+        self.assertEqual(
+            expected_calls, self.mock_subprocess.check_call.call_args_list)
+        self.mock_charmhelpers_fetch.apt_install.assert_called_once_with(
+            'salt-common')
+
+    def test_no_ppa(self):
+        charmhelpers.contrib.saltstack.install_salt_support(
+            from_ppa=False)
+
+        self.assertEqual(self.mock_subprocess.check_call.call_count, 0)
+        self.mock_charmhelpers_fetch.apt_install.assert_called_once_with(
+            'salt-common')
+
+
+class UpdateMachineStateTestCase(unittest.TestCase):
+
+    def setUp(self):
+        super(UpdateMachineStateTestCase, self).setUp()
+
+        patcher = mock.patch('charmhelpers.contrib.saltstack.subprocess')
+        self.mock_subprocess = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        patcher = mock.patch('charmhelpers.contrib.templating.contexts.'
+                             'juju_state_to_yaml')
+        self.mock_config_2_grains = patcher.start()
+        self.addCleanup(patcher.stop)
+
+    def test_calls_local_salt_template(self):
+        charmhelpers.contrib.saltstack.update_machine_state(
+            'states/install.yaml')
+
+        self.mock_subprocess.check_call.assert_called_once_with([
+            'salt-call',
+            '--local',
+            'state.template',
+            'states/install.yaml',
+        ])
+
+    def test_updates_grains(self):
+        charmhelpers.contrib.saltstack.update_machine_state(
+            'states/install.yaml')
+
+        self.mock_config_2_grains.assert_called_once_with('/etc/salt/grains')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_service.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_service.py
new file mode 100644
index 0000000000000000000000000000000000000000..389f6db2341afa44d9f26399e490e55e5de71a82
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_service.py
@@ -0,0 +1,78 @@
+from testtools import TestCase
+import tempfile
+import shutil
+import subprocess
+import six
+import mock
+
+from os.path import exists, join, isdir
+
+from charmhelpers.contrib.ssl import service
+
+
+class ServiceCATest(TestCase):
+
+    def setUp(self):
+        super(ServiceCATest, self).setUp()
+        self.temp_dir = tempfile.mkdtemp()
+
+    def tearDown(self):
+        super(ServiceCATest, self).tearDown()
+        shutil.rmtree(self.temp_dir, ignore_errors=True)
+
+    @mock.patch("charmhelpers.contrib.ssl.service.log")
+    def test_init(self, *args):
+        """
+        Tests that a ServiceCA is initialized with the correct directory
+        layout.
+        """
+        ca_root_dir = join(self.temp_dir, 'ca')
+        ca = service.ServiceCA('fake-name', ca_root_dir)
+        ca.init()
+
+        paths_to_verify = [
+            'certs/',
+            'crl/',
+            'newcerts/',
+            'private/',
+            'private/cacert.key',
+            'cacert.pem',
+            'serial',
+            'index.txt',
+            'ca.cnf',
+            'signing.cnf',
+        ]
+
+        for path in paths_to_verify:
+            full_path = join(ca_root_dir, path)
+            self.assertTrue(exists(full_path),
+                            'Path {} does not exist'.format(full_path))
+
+            if path.endswith('/'):
+                self.assertTrue(isdir(full_path),
+                                'Path {} is not a dir'.format(full_path))
+
+    @mock.patch("charmhelpers.contrib.ssl.service.log")
+    def test_create_cert(self, *args):
+        """
+        Tests that a generated certificate is valid against the ca.
+        """
+        ca_root_dir = join(self.temp_dir, 'ca')
+        ca = service.ServiceCA('fake-name', ca_root_dir)
+        ca.init()
+
+        ca.get_or_create_cert('fake-cert')
+
+        # Verify that the cert belongs to the ca
+        self.assertTrue('fake-cert' in ca)
+
+        full_cert_path = join(ca_root_dir, 'certs', 'fake-cert.crt')
+        cmd = ['openssl', 'verify', '-verbose',
+               '-CAfile', join(ca_root_dir, 'cacert.pem'), full_cert_path]
+
+        output = subprocess.check_output(cmd,
+                                         stderr=subprocess.STDOUT).strip()
+        expected = '{}: OK'.format(full_cert_path)
+        if six.PY3:
+            expected = bytes(expected, 'utf-8')
+        self.assertEqual(expected, output)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_ssl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_ssl.py
new file mode 100644
index 0000000000000000000000000000000000000000..b1fa461c5f2d24d2256427174657671f7a3f5162
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/ssl/test_ssl.py
@@ -0,0 +1,56 @@
+from mock import patch
+from testtools import TestCase
+
+from charmhelpers.contrib import ssl
+
+
+class HelpersTest(TestCase):
+    @patch('subprocess.check_call')
+    def test_generate_selfsigned_dict(self, mock_call):
+        subject = {"country": "UK",
+                   "locality": "my_locality",
+                   "state": "my_state",
+                   "organization": "my_organization",
+                   "organizational_unit": "my_unit",
+                   "cn": "mysite.example.com",
+                   "email": "me@example.com"
+                   }
+
+        ssl.generate_selfsigned("mykey.key", "mycert.crt", subject=subject)
+        mock_call.assert_called_with(['/usr/bin/openssl', 'req', '-new',
+                                      '-newkey', 'rsa:1024', '-days', '365',
+                                      '-nodes', '-x509', '-keyout',
+                                      'mykey.key', '-out', 'mycert.crt',
+                                      '-subj',
+                                      '/C=UK/ST=my_state/L=my_locality'
+                                      '/O=my_organization/OU=my_unit'
+                                      '/CN=mysite.example.com'
+                                      '/emailAddress=me@example.com']
+                                     )
+
+    @patch('charmhelpers.core.hookenv.log')
+    def test_generate_selfsigned_failure(self, mock_log):
+        # This is NOT enough, functino requires cn key
+        subject = {"country": "UK",
+                   "locality": "my_locality"}
+
+        result = ssl.generate_selfsigned("mykey.key", "mycert.crt", subject=subject)
+        self.assertFalse(result)
+
+    @patch('subprocess.check_call')
+    def test_generate_selfsigned_file(self, mock_call):
+        ssl.generate_selfsigned("mykey.key", "mycert.crt", config="test.cnf")
+        mock_call.assert_called_with(['/usr/bin/openssl', 'req', '-new',
+                                      '-newkey', 'rsa:1024', '-days', '365',
+                                      '-nodes', '-x509', '-keyout',
+                                      'mykey.key', '-out', 'mycert.crt',
+                                      '-config', 'test.cnf'])
+
+    @patch('subprocess.check_call')
+    def test_generate_selfsigned_cn_key(self, mock_call):
+        ssl.generate_selfsigned("mykey.key", "mycert.crt", keysize="2048", cn="mysite.example.com")
+        mock_call.assert_called_with(['/usr/bin/openssl', 'req', '-new',
+                                      '-newkey', 'rsa:2048', '-days', '365',
+                                      '-nodes', '-x509', '-keyout',
+                                      'mykey.key', '-out', 'mycert.crt',
+                                      '-subj', '/CN=mysite.example.com'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_bcache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_bcache.py
new file mode 100644
index 0000000000000000000000000000000000000000..847828d78bdc170c20fac5e23eb18d675aea492e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_bcache.py
@@ -0,0 +1,90 @@
+# Copyright 2017 Canonical Ltd
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import shutil
+import json
+from mock import patch
+from testtools import TestCase
+from tempfile import mkdtemp
+from charmhelpers.contrib.storage.linux import bcache
+
+test_stats = {
+    'bypassed': '128G\n',
+    'cache_bypass_hits': '1132623\n',
+    'cache_bypass_misses': '0\n',
+    'cache_hit_ratio': '64\n',
+    'cache_hits': '12177090\n',
+    'cache_miss_collisions': '7091\n',
+    'cache_misses': '6717011\n',
+    'cache_readaheads': '0\n',
+}
+
+tmpdir = 'bcache-stats-test.'
+cacheset = 'abcde'
+cachedev = 'sdfoo'
+
+
+class BcacheTestCase(TestCase):
+    def setUp(self):
+        super(BcacheTestCase, self).setUp()
+        self.sysfs = sysfs = mkdtemp(prefix=tmpdir)
+        self.addCleanup(shutil.rmtree, sysfs)
+        p = patch('charmhelpers.contrib.storage.linux.bcache.SYSFS', new=sysfs)
+        p.start()
+        self.addCleanup(p.stop)
+        self.cacheset = '{}/fs/bcache/{}'.format(sysfs, cacheset)
+        os.makedirs(self.cacheset)
+        self.devcache = '{}/block/{}/bcache'.format(sysfs, cachedev)
+        for n in ['register', 'register_quiet']:
+            with open('{}/fs/bcache/{}'.format(sysfs, n), 'w') as f:
+                f.write('foo')
+        for kind in self.cacheset, self.devcache:
+            for sub in bcache.stats_intervals:
+                intvaldir = '{}/{}'.format(kind, sub)
+                os.makedirs(intvaldir)
+                for fn, val in test_stats.items():
+                    with open(os.path.join(intvaldir, fn), 'w') as f:
+                        f.write(val)
+
+    def test_get_bcache_fs(self):
+        bcachedirs = bcache.get_bcache_fs()
+        assert len(bcachedirs) == 1
+        assert next(iter(bcachedirs)).cachepath.endswith('/fs/bcache/abcde')
+
+    @patch('charmhelpers.contrib.storage.linux.bcache.log', lambda *args, **kwargs: None)
+    @patch('charmhelpers.contrib.storage.linux.bcache.os.listdir')
+    def test_get_bcache_fs_nobcache(self, mock_listdir):
+        mock_listdir.side_effect = OSError(
+            '[Errno 2] No such file or directory:...')
+        bcachedirs = bcache.get_bcache_fs()
+        assert bcachedirs == []
+
+    def test_get_stats_global(self):
+        out = bcache.get_stats_action(
+            'global', 'hour')
+        out = json.loads(out)
+        assert len(out.keys()) == 1
+        k = next(iter(out.keys()))
+        assert k.endswith(cacheset)
+        assert out[k]['bypassed'] == '128G'
+
+    def test_get_stats_dev(self):
+        out = bcache.get_stats_action(
+            cachedev, 'hour')
+        out = json.loads(out)
+        assert len(out.keys()) == 1
+        k = next(iter(out.keys()))
+        assert k.endswith('sdfoo/bcache')
+        assert out[k]['cache_hit_ratio'] == '64'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_ceph.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_ceph.py
new file mode 100644
index 0000000000000000000000000000000000000000..53c63a18f9b86316ba1d86b2634eeb6dd645ea2a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_ceph.py
@@ -0,0 +1,1893 @@
+from mock import patch, call, mock_open
+
+import collections
+import six
+import errno
+from shutil import rmtree
+from tempfile import mkdtemp
+from threading import Timer
+from testtools import TestCase
+import json
+import copy
+import shutil
+
+import charmhelpers.contrib.storage.linux.ceph as ceph_utils
+
+from charmhelpers.core.unitdata import Storage
+from subprocess import CalledProcessError
+from tests.helpers import patch_open, FakeRelation
+import nose.plugins.attrib
+import os
+import time
+
+LS_POOLS = b"""
+.rgw.foo
+images
+volumes
+rbd
+"""
+
+LS_RBDS = b"""
+rbd1
+rbd2
+rbd3
+"""
+
+IMG_MAP = b"""
+bar
+baz
+"""
+# Vastly abbreviated output from ceph osd dump --format=json
+OSD_DUMP = b"""
+{
+    "pools": [
+        {
+            "pool": 2,
+            "pool_name": "rbd",
+            "flags": 1,
+            "flags_names": "hashpspool",
+            "type": 1,
+            "size": 3,
+            "min_size": 2,
+            "crush_ruleset": 0,
+            "object_hash": 2,
+            "pg_num": 64,
+            "pg_placement_num": 64,
+            "crash_replay_interval": 0,
+            "last_change": "1",
+            "last_force_op_resend": "0",
+            "auid": 0,
+            "snap_mode": "selfmanaged",
+            "snap_seq": 0,
+            "snap_epoch": 0,
+            "pool_snaps": [],
+            "removed_snaps": "[]",
+            "quota_max_bytes": 0,
+            "quota_max_objects": 0,
+            "tiers": [],
+            "tier_of": -1,
+            "read_tier": -1,
+            "write_tier": -1,
+            "cache_mode": "writeback",
+            "target_max_bytes": 0,
+            "target_max_objects": 0,
+            "cache_target_dirty_ratio_micro": 0,
+            "cache_target_full_ratio_micro": 0,
+            "cache_min_flush_age": 0,
+            "cache_min_evict_age": 0,
+            "erasure_code_profile": "",
+            "hit_set_params": {
+                "type": "none"
+            },
+            "hit_set_period": 0,
+            "hit_set_count": 0,
+            "stripe_width": 0
+        }
+    ]
+}
+"""
+
+MONMAP_DUMP = b"""{
+    "name": "ip-172-31-13-119", "rank": 0, "state": "leader",
+    "election_epoch": 18, "quorum": [0, 1, 2],
+    "outside_quorum": [],
+    "extra_probe_peers": [],
+    "sync_provider": [],
+    "monmap": {
+        "epoch": 1,
+        "fsid": "9fdc313c-db30-11e5-9805-0242fda74275",
+        "modified": "0.000000",
+        "created": "0.000000",
+        "mons": [
+            {
+                "rank": 0,
+                "name": "ip-172-31-13-119",
+                "addr": "172.31.13.119:6789\\/0"},
+            {
+                "rank": 1,
+                "name": "ip-172-31-24-50",
+                "addr": "172.31.24.50:6789\\/0"},
+            {
+                "rank": 2,
+                "name": "ip-172-31-33-107",
+                "addr": "172.31.33.107:6789\\/0"}
+        ]}}"""
+
+CEPH_CLIENT_RELATION = {
+    'ceph:8': {
+        'ceph/0': {
+            'auth': 'cephx',
+            'broker-rsp-glance-0': '{"request-id": "0bc7dc54", "exit-code": 0}',
+            'broker-rsp-glance-1': '{"request-id": "0880e22a", "exit-code": 0}',
+            'broker-rsp-glance-2': '{"request-id": "0da543b8", "exit-code": 0}',
+            'broker_rsp': '{"request-id": "0da543b8", "exit-code": 0}',
+            'ceph-public-address': '10.5.44.103',
+            'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+            'private-address': '10.5.44.103',
+        },
+        'ceph/1': {
+            'auth': 'cephx',
+            'ceph-public-address': '10.5.44.104',
+            'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+            'private-address': '10.5.44.104',
+        },
+        'ceph/2': {
+            'auth': 'cephx',
+            'ceph-public-address': '10.5.44.105',
+            'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+            'private-address': '10.5.44.105',
+        },
+        'glance/0': {
+            'broker_req': '{"api-version": 1, "request-id": "0bc7dc54", "ops": [{"replicas": 3, "name": "glance", "op": "create-pool"}]}',
+            'private-address': '10.5.44.109',
+        },
+    }
+}
+
+CEPH_CLIENT_RELATION_LEGACY = copy.deepcopy(CEPH_CLIENT_RELATION)
+CEPH_CLIENT_RELATION_LEGACY['ceph:8']['ceph/0'] = {
+    'auth': 'cephx',
+    'broker_rsp': '{"exit-code": 0}',
+    'ceph-public-address': '10.5.44.103',
+    'key': 'AQCLDttVuHXINhAAvI144CB09dYchhHyTUY9BQ==',
+    'private-address': '10.5.44.103',
+}
+
+
+class TestConfig():
+
+    def __init__(self):
+        self.config = {}
+
+    def set(self, key, value):
+        self.config[key] = value
+
+    def get(self, key):
+        return self.config.get(key)
+
+
+class CephBasicUtilsTests(TestCase):
+    def setUp(self):
+        super(CephBasicUtilsTests, self).setUp()
+        [self._patch(m) for m in [
+            'check_output',
+        ]]
+
+    def _patch(self, method):
+        _m = patch.object(ceph_utils, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def test_enabled_manager_modules(self):
+        self.check_output.return_value = b'{"enabled_modules": []}'
+        ceph_utils.enabled_manager_modules()
+        self.check_output.assert_called_once_with(['ceph', 'mgr', 'module', 'ls'])
+
+
+class CephUtilsTests(TestCase):
+    def setUp(self):
+        super(CephUtilsTests, self).setUp()
+        [self._patch(m) for m in [
+            'check_call',
+            'check_output',
+            'config',
+            'relation_get',
+            'related_units',
+            'relation_ids',
+            'relation_set',
+            'log',
+            'cmp_pkgrevno',
+            'enabled_manager_modules',
+        ]]
+        # Ensure the config is setup for mocking properly.
+        self.test_config = TestConfig()
+        self.config.side_effect = self.test_config.get
+        self.cmp_pkgrevno.return_value = 1
+        self.enabled_manager_modules.return_value = []
+
+    def _patch(self, method):
+        _m = patch.object(ceph_utils, method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        setattr(self, method, mock)
+
+    def _get_osd_settings_test_helper(self, settings, expected=None):
+        units = {
+            'client:1': ['ceph-iscsi/1', 'ceph-iscsi/2'],
+            'client:3': ['cinder-ceph/0', 'cinder-ceph/3']}
+        self.relation_ids.return_value = units.keys()
+        self.related_units.side_effect = lambda x: units[x]
+        self.relation_get.side_effect = lambda x, y, z: settings[y]
+        if expected:
+            self.assertEqual(
+                ceph_utils.get_osd_settings('client'),
+                expected)
+        else:
+            ceph_utils.get_osd_settings('client'),
+
+    def test_get_osd_settings_all_unset(self):
+        settings = {
+            'ceph-iscsi/1': None,
+            'ceph-iscsi/2': None,
+            'cinder-ceph/0': None,
+            'cinder-ceph/3': None}
+        self._get_osd_settings_test_helper(settings, {})
+
+    def test_get_osd_settings_one_group_set(self):
+        settings = {
+            'ceph-iscsi/1': '{"osd heartbeat grace": 5}',
+            'ceph-iscsi/2': '{"osd heartbeat grace": 5}',
+            'cinder-ceph/0': '{"osd heartbeat interval": 25}',
+            'cinder-ceph/3': '{"osd heartbeat interval": 25}'}
+        self._get_osd_settings_test_helper(
+            settings,
+            {'osd heartbeat interval': 25,
+             'osd heartbeat grace': 5})
+
+    def test_get_osd_settings_invalid_option(self):
+        settings = {
+            'ceph-iscsi/1': '{"osd foobar": 5}',
+            'ceph-iscsi/2': None,
+            'cinder-ceph/0': None,
+            'cinder-ceph/3': None}
+        self.assertRaises(
+            ceph_utils.OSDSettingNotAllowed,
+            self._get_osd_settings_test_helper,
+            settings)
+
+    def test_get_osd_settings_conflicting_options(self):
+        settings = {
+            'ceph-iscsi/1': '{"osd heartbeat grace": 5}',
+            'ceph-iscsi/2': None,
+            'cinder-ceph/0': '{"osd heartbeat grace": 6}',
+            'cinder-ceph/3': None}
+        self.assertRaises(
+            ceph_utils.OSDSettingConflict,
+            self._get_osd_settings_test_helper,
+            settings)
+
+    @patch.object(ceph_utils, 'get_osd_settings')
+    def test_send_osd_settings(self, _get_osd_settings):
+        self.relation_ids.return_value = ['client:1', 'client:3']
+        _get_osd_settings.return_value = {
+            'osd heartbeat grace': 5,
+            'osd heartbeat interval': 25}
+        ceph_utils.send_osd_settings()
+        expected_calls = [
+            call(
+                relation_id='client:1',
+                relation_settings={
+                    'osd-settings': ('{"osd heartbeat grace": 5, '
+                                     '"osd heartbeat interval": 25}')}),
+            call(
+                relation_id='client:3',
+                relation_settings={
+                    'osd-settings': ('{"osd heartbeat grace": 5, '
+                                     '"osd heartbeat interval": 25}')})]
+        self.relation_set.assert_has_calls(expected_calls, any_order=True)
+
+    @patch.object(ceph_utils, 'get_osd_settings')
+    def test_send_osd_settings_bad_settings(self, _get_osd_settings):
+        _get_osd_settings.side_effect = ceph_utils.OSDSettingConflict()
+        ceph_utils.send_osd_settings()
+        self.assertFalse(self.relation_set.called)
+
+    def test_validator_valid(self):
+        # 1 is an int
+        ceph_utils.validator(value=1,
+                             valid_type=int)
+
+    def test_validator_valid_range(self):
+        # 1 is an int between 0 and 2
+        ceph_utils.validator(value=1,
+                             valid_type=int,
+                             valid_range=[0, 2])
+
+    def test_validator_invalid_range(self):
+        # 1 is an int that isn't in the valid list of only 0
+        self.assertRaises(ValueError, ceph_utils.validator,
+                          value=1,
+                          valid_type=int,
+                          valid_range=[0])
+
+    def test_validator_invalid_string_list(self):
+        # foo is a six.string_types that isn't in the valid string list
+        self.assertRaises(AssertionError, ceph_utils.validator,
+                          value="foo",
+                          valid_type=six.string_types,
+                          valid_range=["valid", "list", "of", "strings"])
+
+    def test_validator_valid_string(self):
+        ceph_utils.validator(value="foo",
+                             valid_type=six.string_types,
+                             valid_range=["foo"])
+
+    def test_validator_valid_string_type(self):
+        ceph_utils.validator(value="foo",
+                             valid_type=str,
+                             valid_range=["foo"])
+
+    def test_pool_add_cache_tier(self):
+        p = ceph_utils.Pool(name='test', service='admin')
+        p.add_cache_tier('cacher', 'readonly')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'add', 'test', 'cacher']),
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'cache-mode', 'cacher', 'readonly']),
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'set-overlay', 'test', 'cacher']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'cacher', 'hit_set_type', 'bloom']),
+        ])
+
+    @patch.object(ceph_utils, 'get_cache_mode')
+    def test_pool_remove_readonly_cache_tier(self, cache_mode):
+        cache_mode.return_value = 'readonly'
+
+        p = ceph_utils.Pool(name='test', service='admin')
+        p.remove_cache_tier(cache_pool='cacher')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'cache-mode', 'cacher', 'none']),
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'remove', 'test', 'cacher']),
+        ])
+
+    @patch.object(ceph_utils, 'get_cache_mode')
+    def test_pool_remove_writeback_cache_tier(self, cache_mode):
+        cache_mode.return_value = 'writeback'
+        self.cmp_pkgrevno.return_value = 1
+
+        p = ceph_utils.Pool(name='test', service='admin')
+        p.remove_cache_tier(cache_pool='cacher')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'cache-mode', 'cacher', 'forward',
+                  '--yes-i-really-mean-it']),
+            call(['rados', '--id', 'admin', '-p', 'cacher', 'cache-flush-evict-all']),
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'remove-overlay', 'test']),
+            call(['ceph', '--id', 'admin', 'osd', 'tier', 'remove', 'test', 'cacher']),
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_get_pg_num_pg_calc_values(self, get_osds):
+        """Tests the calculated pg num in the normal case works"""
+        # Check the growth case ... e.g. 200 PGs per OSD if the cluster is
+        # expected to grown in the near future.
+        get_osds.return_value = range(1, 11)
+        self.test_config.set('pgs-per-osd', 200)
+        p = ceph_utils.Pool(name='test', service='admin')
+
+        # For Pool Size of 3, 200 PGs/OSD, and 40% of the overall data,
+        # the pg num should be 256
+        pg_num = p.get_pgs(pool_size=3, percent_data=40)
+        self.assertEqual(256, pg_num)
+
+        self.test_config.set('pgs-per-osd', 300)
+        pg_num = p.get_pgs(pool_size=3, percent_data=100)
+        self.assertEquals(1024, pg_num)
+
+        # Tests the case in which the expected OSD count is provided (and is
+        # greater than the found OSD count).
+        self.test_config.set('pgs-per-osd', 100)
+        self.test_config.set('expected-osd-count', 20)
+        pg_num = p.get_pgs(pool_size=3, percent_data=100)
+        self.assertEquals(512, pg_num)
+
+        # Test small % weight with minimal OSD count (3)
+        get_osds.return_value = range(1, 3)
+        self.test_config.set('expected-osd-count', None)
+        self.test_config.set('pgs-per-osd', None)
+        pg_num = p.get_pgs(pool_size=3, percent_data=0.1)
+        self.assertEquals(2, pg_num)
+
+        # Check device_class is passed to get_osds
+        p.get_pgs(pool_size=3, percent_data=90, device_class='nvme')
+        get_osds.assert_called_with('admin', 'nvme')
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_old_ceph(self, get_osds):
+        self.cmp_pkgrevno.return_value = -1
+        get_osds.return_value = None
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3)
+        p.create()
+
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create', 'test', str(200)]),
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'test', 'size', str(3)]),
+        ])
+        self.assertEqual(self.check_call.call_count, 2)
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_luminous_ceph(self, get_osds):
+        self.cmp_pkgrevno.side_effect = [-1, 1]
+        get_osds.return_value = None
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3)
+        p.create()
+
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd',
+                  'pool', 'create', 'test', str(200)]),
+            call(['ceph', '--id', 'admin', 'osd',
+                  'pool', 'set', 'test', 'size', str(3)]),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'application', 'enable', 'test', 'unknown'])
+        ])
+        self.assertEqual(self.check_call.call_count, 3)
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_small_osds(self, get_osds):
+        get_osds.return_value = range(1, 5)
+        self.cmp_pkgrevno.return_value = -1
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=10)
+        p.create()
+
+        # Using the PG Calc, for 4 OSDs with a size of 3 and 10% of the data
+        # at 100 PGs/OSD, the number of expected placement groups will be 16
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create', 'test',
+                  '16']),
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_medium_osds(self, get_osds):
+        self.cmp_pkgrevno.return_value = -1
+        get_osds.return_value = range(1, 9)
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=50)
+        p.create()
+
+        # Using the PG Calc, for 8 OSDs with a size of 3 and 50% of the data
+        # at 100 PGs/OSD, the number of expected placement groups will be 128
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create', 'test',
+                  '128']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'test', 'size', '3']),
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_autoscaler(self, get_osds):
+        self.enabled_manager_modules.return_value = ['pg_autoscaler']
+        self.cmp_pkgrevno.return_value = 1
+        get_osds.return_value = range(1, 9)
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=50)
+        p.create()
+        # Using the PG Calc, for 8 OSDs with a size of 3 and 50% of the data
+
+        # at 100 PGs/OSD, the number of expected placement groups will be 128
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'create', '--pg-num-min=32', 'test', '128']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'size', '3']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'target_size_ratio', '0.5']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'application', 'enable', 'test', 'unknown']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'pg_autoscale_mode', 'on'])
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_autoscaler_small(self, get_osds):
+        self.enabled_manager_modules.return_value = ['pg_autoscaler']
+        self.cmp_pkgrevno.return_value = 1
+        get_osds.return_value = range(1, 3)
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=1)
+        p.create()
+        # Using the PG Calc, for 8 OSDs with a size of 3 and 50% of the data
+
+        # at 100 PGs/OSD, the number of expected placement groups will be 128
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'create', '--pg-num-min=2', 'test', '2']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'size', '3']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'target_size_ratio', '0.01']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'application', 'enable', 'test', 'unknown']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'pg_autoscale_mode', 'on'])
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_large_osds(self, get_osds):
+        get_osds.return_value = range(1, 41)
+        self.cmp_pkgrevno.return_value = -1
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=100)
+        p.create()
+
+        # Using the PG Calc, for 40 OSDs with a size of 3 and 100% of the
+        # data at 100 PGs/OSD then the number of expected placement groups
+        # will be 1024.
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create', 'test',
+                  '1024']),
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_xlarge_osds(self, get_osds):
+        get_osds.return_value = range(1, 1001)
+        self.cmp_pkgrevno.return_value = -1
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3,
+                                      percent_data=100)
+        p.create()
+
+        # Using the PG Calc, for 1,000 OSDs with a size of 3 and 100% of the
+        # data at 100 PGs/OSD then the number of expected placement groups
+        # will be 32768
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create', 'test',
+                  '32768']),
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    def test_replicated_pool_create_failed(self, get_osds):
+        get_osds.return_value = range(1, 1001)
+        self.check_call.side_effect = CalledProcessError(returncode=1,
+                                                         cmd='mock',
+                                                         output=None)
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3)
+        self.assertRaises(CalledProcessError, p.create)
+
+    @patch.object(ceph_utils, 'get_osds')
+    @patch.object(ceph_utils, 'pool_exists')
+    def test_replicated_pool_skips_creation(self, pool_exists, get_osds):
+        get_osds.return_value = range(1, 1001)
+        pool_exists.return_value = True
+        p = ceph_utils.ReplicatedPool(name='test', service='admin', replicas=3)
+        p.create()
+        self.check_call.assert_has_calls([])
+
+    def test_erasure_pool_create_failed(self):
+        self.check_output.side_effect = CalledProcessError(returncode=1,
+                                                           cmd='ceph',
+                                                           output=None)
+        p = ceph_utils.ErasurePool('test', 'admin', 'foo')
+        self.assertRaises(ceph_utils.PoolCreationError, p.create)
+
+    @patch.object(ceph_utils, 'get_erasure_profile')
+    @patch.object(ceph_utils, 'get_osds')
+    def test_erasure_pool_create(self, get_osds, erasure_profile):
+        self.cmp_pkgrevno.return_value = 1
+        get_osds.return_value = range(1, 60)
+        erasure_profile.return_value = {
+            'directory': '/usr/lib/x86_64-linux-gnu/ceph/erasure-code',
+            'k': '2',
+            'technique': 'reed_sol_van',
+            'm': '1',
+            'plugin': 'jerasure'}
+        p = ceph_utils.ErasurePool(name='test', service='admin',
+                                   percent_data=100)
+        p.create()
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'create',
+                  '--pg-num-min=32', 'test',
+                  '2048', '2048', 'erasure', 'default']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'application', 'enable', 'test', 'unknown'])
+        ])
+
+    @patch.object(ceph_utils, 'get_erasure_profile')
+    @patch.object(ceph_utils, 'get_osds')
+    def test_erasure_pool_create_autoscaler(self,
+                                            get_osds,
+                                            erasure_profile):
+        self.enabled_manager_modules.return_value = ['pg_autoscaler']
+        self.cmp_pkgrevno.return_value = 1
+        get_osds.return_value = range(1, 60)
+        erasure_profile.return_value = {
+            'directory': '/usr/lib/x86_64-linux-gnu/ceph/erasure-code',
+            'k': '2',
+            'technique': 'reed_sol_van',
+            'm': '1',
+            'plugin': 'jerasure'}
+        p = ceph_utils.ErasurePool(name='test', service='admin',
+                                   percent_data=100)
+        p.create()
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'create', '--pg-num-min=32', 'test',
+                  '2048', '2048', 'erasure', 'default']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'application', 'enable', 'test', 'unknown']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'target_size_ratio', '1.0']),
+            call(['ceph', '--id', 'admin', 'osd', 'pool',
+                  'set', 'test', 'pg_autoscale_mode', 'on']),
+        ])
+
+    def test_get_erasure_profile_none(self):
+        self.check_output.side_effect = CalledProcessError(1, 'ceph')
+        return_value = ceph_utils.get_erasure_profile('admin', 'unknown')
+        self.assertEqual(None, return_value)
+
+    def test_pool_set_int(self):
+        self.check_call.return_value = 0
+        ceph_utils.pool_set(service='admin', pool_name='data', key='test', value=2)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'data', 'test', '2'])
+        ])
+
+    def test_pool_set_bool(self):
+        self.check_call.return_value = 0
+        ceph_utils.pool_set(service='admin', pool_name='data', key='test', value=True)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'data', 'test', 'true'])
+        ])
+
+    def test_pool_set_str(self):
+        self.check_call.return_value = 0
+        ceph_utils.pool_set(service='admin', pool_name='data', key='test', value='two')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set', 'data', 'test', 'two'])
+        ])
+
+    def test_pool_set_fails(self):
+        self.check_call.side_effect = CalledProcessError(returncode=1, cmd='mock',
+                                                         output=None)
+        self.assertRaises(CalledProcessError, ceph_utils.pool_set,
+                          service='admin', pool_name='data', key='test', value=2)
+
+    def test_snapshot_pool(self):
+        self.check_call.return_value = 0
+        ceph_utils.snapshot_pool(service='admin', pool_name='data', snapshot_name='test-snap-1')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'mksnap', 'data', 'test-snap-1'])
+        ])
+
+    def test_snapshot_pool_fails(self):
+        self.check_call.side_effect = CalledProcessError(returncode=1, cmd='mock',
+                                                         output=None)
+        self.assertRaises(CalledProcessError, ceph_utils.snapshot_pool,
+                          service='admin', pool_name='data', snapshot_name='test-snap-1')
+
+    def test_remove_pool_snapshot(self):
+        self.check_call.return_value = 0
+        ceph_utils.remove_pool_snapshot(service='admin', pool_name='data', snapshot_name='test-snap-1')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'rmsnap', 'data', 'test-snap-1'])
+        ])
+
+    def test_set_pool_quota(self):
+        self.check_call.return_value = 0
+        ceph_utils.set_pool_quota(service='admin', pool_name='data',
+                                  max_bytes=1024)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set-quota', 'data',
+                  'max_bytes', '1024'])
+        ])
+        ceph_utils.set_pool_quota(service='admin', pool_name='data',
+                                  max_objects=1024)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set-quota', 'data',
+                  'max_objects', '1024'])
+        ])
+        ceph_utils.set_pool_quota(service='admin', pool_name='data',
+                                  max_bytes=1024, max_objects=1024)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set-quota', 'data',
+                  'max_bytes', '1024', 'max_objects', '1024'])
+        ])
+
+    def test_remove_pool_quota(self):
+        self.check_call.return_value = 0
+        ceph_utils.remove_pool_quota(service='admin', pool_name='data')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'admin', 'osd', 'pool', 'set-quota', 'data', 'max_bytes', '0'])
+        ])
+
+    @patch.object(ceph_utils, 'erasure_profile_exists')
+    def test_create_erasure_profile(self, existing_profile):
+        existing_profile.return_value = True
+        self.cmp_pkgrevno.return_value = -1
+        ceph_utils.create_erasure_profile(service='admin', profile_name='super-profile', erasure_plugin_name='jerasure',
+                                          failure_domain='rack', data_chunks=10, coding_chunks=3)
+
+        cmd = ['ceph', '--id', 'admin', 'osd', 'erasure-code-profile', 'set', 'super-profile',
+               'plugin=' + 'jerasure', 'k=' + str(10), 'm=' + str(3),
+               'ruleset-failure-domain=' + 'rack', '--force']
+        self.check_call.assert_has_calls([call(cmd)])
+
+        self.cmp_pkgrevno.return_value = 1
+        ceph_utils.create_erasure_profile(service='admin', profile_name='super-profile', erasure_plugin_name='jerasure',
+                                          failure_domain='rack', data_chunks=10, coding_chunks=3)
+
+        cmd = ['ceph', '--id', 'admin', 'osd', 'erasure-code-profile', 'set', 'super-profile',
+               'plugin=' + 'jerasure', 'k=' + str(10), 'm=' + str(3),
+               'crush-failure-domain=' + 'rack', '--force']
+        self.check_call.assert_has_calls([call(cmd)])
+
+    @patch.object(ceph_utils, 'erasure_profile_exists')
+    def test_create_erasure_profile_local(self, existing_profile):
+        self.cmp_pkgrevno.return_value = -1
+        existing_profile.return_value = False
+        ceph_utils.create_erasure_profile(service='admin', profile_name='super-profile', erasure_plugin_name='local',
+                                          failure_domain='rack', data_chunks=10, coding_chunks=3, locality=1)
+
+        cmd = ['ceph', '--id', 'admin', 'osd', 'erasure-code-profile', 'set', 'super-profile',
+               'plugin=' + 'local', 'k=' + str(10), 'm=' + str(3),
+               'ruleset-failure-domain=' + 'rack', 'l=' + str(1)]
+        self.check_call.assert_has_calls([call(cmd)])
+
+    @patch.object(ceph_utils, 'erasure_profile_exists')
+    def test_create_erasure_profile_shec(self, existing_profile):
+        self.cmp_pkgrevno.return_value = -1
+        existing_profile.return_value = False
+        ceph_utils.create_erasure_profile(service='admin', profile_name='super-profile', erasure_plugin_name='shec',
+                                          failure_domain='rack', data_chunks=10, coding_chunks=3,
+                                          durability_estimator=1)
+
+        cmd = ['ceph', '--id', 'admin', 'osd', 'erasure-code-profile', 'set', 'super-profile',
+               'plugin=' + 'shec', 'k=' + str(10), 'm=' + str(3),
+               'ruleset-failure-domain=' + 'rack', 'c=' + str(1)]
+        self.check_call.assert_has_calls([call(cmd)])
+
+    def test_rename_pool(self):
+        ceph_utils.rename_pool(service='admin', old_name='old-pool', new_name='new-pool')
+        cmd = ['ceph', '--id', 'admin', 'osd', 'pool', 'rename', 'old-pool', 'new-pool']
+        self.check_call.assert_called_with(cmd)
+
+    def test_erasure_profile_exists(self):
+        self.check_call.return_value = 0
+        profile_exists = ceph_utils.erasure_profile_exists(service='admin', name='super-profile')
+        cmd = ['ceph', '--id', 'admin',
+               'osd', 'erasure-code-profile', 'get',
+               'super-profile']
+        self.check_call.assert_called_with(cmd)
+        self.assertEqual(True, profile_exists)
+
+    def test_set_monitor_key(self):
+        cmd = ['ceph', '--id', 'admin',
+               'config-key', 'put', 'foo', 'bar']
+        ceph_utils.monitor_key_set(service='admin', key='foo', value='bar')
+        self.check_output.assert_called_with(cmd)
+
+    def test_get_monitor_key(self):
+        cmd = ['ceph', '--id', 'admin',
+               'config-key', 'get', 'foo']
+        ceph_utils.monitor_key_get(service='admin', key='foo')
+        self.check_output.assert_called_with(cmd)
+
+    def test_get_monitor_key_failed(self):
+        self.check_output.side_effect = CalledProcessError(
+            returncode=2,
+            cmd='ceph',
+            output='key foo does not exist')
+        output = ceph_utils.monitor_key_get(service='admin', key='foo')
+        self.assertEqual(None, output)
+
+    def test_monitor_key_exists(self):
+        cmd = ['ceph', '--id', 'admin',
+               'config-key', 'exists', 'foo']
+        ceph_utils.monitor_key_exists(service='admin', key='foo')
+        self.check_call.assert_called_with(cmd)
+
+    def test_monitor_key_doesnt_exist(self):
+        self.check_call.side_effect = CalledProcessError(
+            returncode=2,
+            cmd='ceph',
+            output='key foo does not exist')
+        output = ceph_utils.monitor_key_exists(service='admin', key='foo')
+        self.assertEqual(False, output)
+
+    def test_delete_monitor_key(self):
+        ceph_utils.monitor_key_delete(service='admin', key='foo')
+        cmd = ['ceph', '--id', 'admin',
+               'config-key', 'del', 'foo']
+        self.check_output.assert_called_with(cmd)
+
+    def test_delete_monitor_key_failed(self):
+        self.check_output.side_effect = CalledProcessError(
+            returncode=2,
+            cmd='ceph',
+            output='deletion failed')
+        self.assertRaises(CalledProcessError, ceph_utils.monitor_key_delete,
+                          service='admin', key='foo')
+
+    def test_get_monmap(self):
+        self.check_output.return_value = MONMAP_DUMP
+        cmd = ['ceph', '--id', 'admin',
+               'mon_status', '--format=json']
+        ceph_utils.get_mon_map(service='admin')
+        self.check_output.assert_called_with(cmd)
+
+    @patch.object(ceph_utils, 'get_mon_map')
+    def test_hash_monitor_names(self, monmap):
+        expected_hash_list = [
+            '010d57d581604d411b315dd64112bff832ab92c7323fa06077134b50',
+            '8e0a9705c1aeafa1ce250cc9f1bb443fc6e5150e5edcbeb6eeb82e3c',
+            'c3f8d36ba098c23ee920cb08cfb9beda6b639f8433637c190bdd56ec']
+        _monmap_dump = MONMAP_DUMP
+        if six.PY3:
+            _monmap_dump = _monmap_dump.decode('UTF-8')
+        monmap.return_value = json.loads(_monmap_dump)
+        hashed_mon_list = ceph_utils.hash_monitor_names(service='admin')
+        self.assertEqual(expected=expected_hash_list, observed=hashed_mon_list)
+
+    def test_get_cache_mode(self):
+        self.check_output.return_value = OSD_DUMP
+        cache_mode = ceph_utils.get_cache_mode(service='admin', pool_name='rbd')
+        self.assertEqual("writeback", cache_mode)
+
+    @patch('os.path.exists')
+    def test_add_key(self, _exists):
+        """It creates a new ceph keyring"""
+        _exists.return_value = False
+        ceph_utils.add_key('cinder', 'cephkey')
+        _cmd = ['ceph-authtool', '/etc/ceph/ceph.client.cinder.keyring',
+                '--create-keyring', '--name=client.cinder',
+                '--add-key=cephkey']
+        self.check_call.assert_called_with(_cmd)
+
+    @patch('os.path.exists')
+    def test_add_key_already_exists(self, _exists):
+        """It should insert the key into the existing keyring"""
+        _exists.return_value = True
+        try:
+            with patch("__builtin__.open", mock_open(read_data="foo")):
+                ceph_utils.add_key('cinder', 'cephkey')
+        except ImportError:  # Python3
+            with patch("builtins.open", mock_open(read_data="foo")):
+                ceph_utils.add_key('cinder', 'cephkey')
+        self.assertTrue(self.log.called)
+        _cmd = ['ceph-authtool', '/etc/ceph/ceph.client.cinder.keyring',
+                '--create-keyring', '--name=client.cinder',
+                '--add-key=cephkey']
+        self.check_call.assert_called_with(_cmd)
+
+    @patch('os.path.exists')
+    def test_add_key_already_exists_and_key_exists(self, _exists):
+        """Nothing should happen, apart from a log message"""
+        _exists.return_value = True
+        try:
+            with patch("__builtin__.open", mock_open(read_data="cephkey")):
+                ceph_utils.add_key('cinder', 'cephkey')
+        except ImportError:  # Python3
+            with patch("builtins.open", mock_open(read_data="cephkey")):
+                ceph_utils.add_key('cinder', 'cephkey')
+        self.assertTrue(self.log.called)
+        self.check_call.assert_not_called()
+
+    @patch('os.remove')
+    @patch('os.path.exists')
+    def test_delete_keyring(self, _exists, _remove):
+        """It deletes a ceph keyring."""
+        _exists.return_value = True
+        ceph_utils.delete_keyring('cinder')
+        _remove.assert_called_with('/etc/ceph/ceph.client.cinder.keyring')
+        self.assertTrue(self.log.called)
+
+    @patch('os.remove')
+    @patch('os.path.exists')
+    def test_delete_keyring_not_exists(self, _exists, _remove):
+        """It creates a new ceph keyring."""
+        _exists.return_value = False
+        ceph_utils.delete_keyring('cinder')
+        self.assertTrue(self.log.called)
+        _remove.assert_not_called()
+
+    @patch('os.path.exists')
+    def test_create_keyfile(self, _exists):
+        """It creates a new ceph keyfile"""
+        _exists.return_value = False
+        with patch_open() as (_open, _file):
+            ceph_utils.create_key_file('cinder', 'cephkey')
+            _file.write.assert_called_with('cephkey')
+        self.assertTrue(self.log.called)
+
+    @patch('os.path.exists')
+    def test_create_key_file_already_exists(self, _exists):
+        """It creates a new ceph keyring"""
+        _exists.return_value = True
+        ceph_utils.create_key_file('cinder', 'cephkey')
+        self.assertTrue(self.log.called)
+
+    @patch('os.mkdir')
+    @patch.object(ceph_utils, 'apt_install')
+    @patch('os.path.exists')
+    def test_install(self, _exists, _install, _mkdir):
+        _exists.return_value = False
+        ceph_utils.install()
+        _mkdir.assert_called_with('/etc/ceph')
+        _install.assert_called_with('ceph-common', fatal=True)
+
+    def test_get_osds(self):
+        self.check_output.return_value = json.dumps([1, 2, 3]).encode('UTF-8')
+        self.assertEquals(ceph_utils.get_osds('test'), [1, 2, 3])
+
+    def test_get_osds_none(self):
+        self.check_output.return_value = json.dumps(None).encode('UTF-8')
+        self.assertEquals(ceph_utils.get_osds('test'), None)
+
+    def test_get_osds_device_class(self):
+        self.check_output.return_value = json.dumps([1, 2, 3]).encode('UTF-8')
+        self.assertEquals(ceph_utils.get_osds('test', 'nvme'), [1, 2, 3])
+        self.check_output.assert_called_once_with(
+            ['ceph', '--id', 'test',
+             'osd', 'crush', 'class',
+             'ls-osd', 'nvme', '--format=json']
+        )
+
+    def test_get_osds_device_class_older(self):
+        self.check_output.return_value = json.dumps([1, 2, 3]).encode('UTF-8')
+        self.cmp_pkgrevno.return_value = -1
+        self.assertEquals(ceph_utils.get_osds('test', 'nvme'), [1, 2, 3])
+        self.check_output.assert_called_once_with(
+            ['ceph', '--id', 'test', 'osd', 'ls', '--format=json']
+        )
+
+    @patch.object(ceph_utils, 'get_osds')
+    @patch.object(ceph_utils, 'pool_exists')
+    def test_create_pool(self, _exists, _get_osds):
+        """It creates rados pool correctly with default replicas """
+        _exists.return_value = False
+        _get_osds.return_value = [1, 2, 3]
+        ceph_utils.create_pool(service='cinder', name='foo')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'cinder', 'osd', 'pool',
+                  'create', 'foo', '100']),
+            call(['ceph', '--id', 'cinder', 'osd', 'pool', 'set',
+                  'foo', 'size', '3'])
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    @patch.object(ceph_utils, 'pool_exists')
+    def test_create_pool_2_replicas(self, _exists, _get_osds):
+        """It creates rados pool correctly with 3 replicas"""
+        _exists.return_value = False
+        _get_osds.return_value = [1, 2, 3]
+        ceph_utils.create_pool(service='cinder', name='foo', replicas=2)
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'cinder', 'osd', 'pool',
+                  'create', 'foo', '150']),
+            call(['ceph', '--id', 'cinder', 'osd', 'pool', 'set',
+                  'foo', 'size', '2'])
+        ])
+
+    @patch.object(ceph_utils, 'get_osds')
+    @patch.object(ceph_utils, 'pool_exists')
+    def test_create_pool_argonaut(self, _exists, _get_osds):
+        """It creates rados pool correctly with 3 replicas"""
+        _exists.return_value = False
+        _get_osds.return_value = None
+        ceph_utils.create_pool(service='cinder', name='foo')
+        self.check_call.assert_has_calls([
+            call(['ceph', '--id', 'cinder', 'osd', 'pool',
+                  'create', 'foo', '200']),
+            call(['ceph', '--id', 'cinder', 'osd', 'pool', 'set',
+                  'foo', 'size', '3'])
+        ])
+
+    def test_create_pool_already_exists(self):
+        self._patch('pool_exists')
+        self.pool_exists.return_value = True
+        ceph_utils.create_pool(service='cinder', name='foo')
+        self.assertTrue(self.log.called)
+        self.check_call.assert_not_called()
+
+    def test_keyring_path(self):
+        """It correctly dervies keyring path from service name"""
+        result = ceph_utils._keyring_path('cinder')
+        self.assertEquals('/etc/ceph/ceph.client.cinder.keyring', result)
+
+    def test_keyfile_path(self):
+        """It correctly dervies keyring path from service name"""
+        result = ceph_utils._keyfile_path('cinder')
+        self.assertEquals('/etc/ceph/ceph.client.cinder.key', result)
+
+    def test_pool_exists(self):
+        """It detects an rbd pool exists"""
+        self.check_output.return_value = LS_POOLS
+        self.assertTrue(ceph_utils.pool_exists('cinder', 'volumes'))
+        self.assertTrue(ceph_utils.pool_exists('rgw', '.rgw.foo'))
+
+    def test_pool_does_not_exist(self):
+        """It detects an rbd pool exists"""
+        self.check_output.return_value = LS_POOLS
+        self.assertFalse(ceph_utils.pool_exists('cinder', 'foo'))
+        self.assertFalse(ceph_utils.pool_exists('rgw', '.rgw'))
+
+    def test_pool_exists_error(self):
+        """ Ensure subprocess errors and sandboxed with False """
+        self.check_output.side_effect = CalledProcessError(1, 'rados')
+        self.assertFalse(ceph_utils.pool_exists('cinder', 'foo'))
+
+    def test_rbd_exists(self):
+        self.check_output.return_value = LS_RBDS
+        self.assertTrue(ceph_utils.rbd_exists('service', 'pool', 'rbd1'))
+        self.check_output.assert_called_with(
+            ['rbd', 'list', '--id', 'service', '--pool', 'pool']
+        )
+
+    def test_rbd_does_not_exist(self):
+        self.check_output.return_value = LS_RBDS
+        self.assertFalse(ceph_utils.rbd_exists('service', 'pool', 'rbd4'))
+        self.check_output.assert_called_with(
+            ['rbd', 'list', '--id', 'service', '--pool', 'pool']
+        )
+
+    def test_rbd_exists_error(self):
+        """ Ensure subprocess errors and sandboxed with False """
+        self.check_output.side_effect = CalledProcessError(1, 'rbd')
+        self.assertFalse(ceph_utils.rbd_exists('cinder', 'foo', 'rbd'))
+
+    def test_create_rbd_image(self):
+        ceph_utils.create_rbd_image('service', 'pool', 'image', 128)
+        _cmd = ['rbd', 'create', 'image',
+                '--size', '128',
+                '--id', 'service',
+                '--pool', 'pool']
+        self.check_call.assert_called_with(_cmd)
+
+    def test_delete_pool(self):
+        ceph_utils.delete_pool('cinder', 'pool')
+        _cmd = [
+            'ceph', '--id', 'cinder',
+            'osd', 'pool', 'delete',
+            'pool', '--yes-i-really-really-mean-it'
+        ]
+        self.check_call.assert_called_with(_cmd)
+
+    def test_get_ceph_nodes(self):
+        self._patch('relation_ids')
+        self._patch('related_units')
+        self._patch('relation_get')
+        units = ['ceph/1', 'ceph2', 'ceph/3']
+        self.relation_ids.return_value = ['ceph:0']
+        self.related_units.return_value = units
+        self.relation_get.return_value = '192.168.1.1'
+        self.assertEquals(len(ceph_utils.get_ceph_nodes()), 3)
+
+    def test_get_ceph_nodes_not_related(self):
+        self._patch('relation_ids')
+        self.relation_ids.return_value = []
+        self.assertEquals(ceph_utils.get_ceph_nodes(), [])
+
+    def test_configure(self):
+        self._patch('add_key')
+        self._patch('create_key_file')
+        self._patch('get_ceph_nodes')
+        self._patch('modprobe')
+        _hosts = ['192.168.1.1', '192.168.1.2']
+        self.get_ceph_nodes.return_value = _hosts
+        _conf = ceph_utils.CEPH_CONF.format(
+            auth='cephx',
+            keyring=ceph_utils._keyring_path('cinder'),
+            mon_hosts=",".join(map(str, _hosts)),
+            use_syslog='true'
+        )
+        with patch_open() as (_open, _file):
+            ceph_utils.configure('cinder', 'key', 'cephx', 'true')
+            _file.write.assert_called_with(_conf)
+            _open.assert_called_with('/etc/ceph/ceph.conf', 'w')
+        self.modprobe.assert_called_with('rbd')
+        self.add_key.assert_called_with('cinder', 'key')
+        self.create_key_file.assert_called_with('cinder', 'key')
+
+    def test_image_mapped(self):
+        self.check_output.return_value = IMG_MAP
+        self.assertTrue(ceph_utils.image_mapped('bar'))
+
+    def test_image_not_mapped(self):
+        self.check_output.return_value = IMG_MAP
+        self.assertFalse(ceph_utils.image_mapped('foo'))
+
+    def test_image_not_mapped_error(self):
+        self.check_output.side_effect = CalledProcessError(1, 'rbd')
+        self.assertFalse(ceph_utils.image_mapped('bar'))
+
+    def test_map_block_storage(self):
+        _service = 'cinder'
+        _pool = 'bar'
+        _img = 'foo'
+        _cmd = [
+            'rbd',
+            'map',
+            '{}/{}'.format(_pool, _img),
+            '--user',
+            _service,
+            '--secret',
+            ceph_utils._keyfile_path(_service),
+        ]
+        ceph_utils.map_block_storage(_service, _pool, _img)
+        self.check_call.assert_called_with(_cmd)
+
+    def test_filesystem_mounted(self):
+        self._patch('mounts')
+        self.mounts.return_value = [['/afs', '/dev/sdb'], ['/bfs', '/dev/sdd']]
+        self.assertTrue(ceph_utils.filesystem_mounted('/afs'))
+        self.assertFalse(ceph_utils.filesystem_mounted('/zfs'))
+
+    @patch('os.path.exists')
+    def test_make_filesystem(self, _exists):
+        _exists.return_value = True
+        ceph_utils.make_filesystem('/dev/sdd')
+        self.assertTrue(self.log.called)
+        self.check_call.assert_called_with(['mkfs', '-t', 'ext4', '/dev/sdd'])
+
+    @patch('os.path.exists')
+    def test_make_filesystem_xfs(self, _exists):
+        _exists.return_value = True
+        ceph_utils.make_filesystem('/dev/sdd', 'xfs')
+        self.assertTrue(self.log.called)
+        self.check_call.assert_called_with(['mkfs', '-t', 'xfs', '/dev/sdd'])
+
+    @patch('os.chown')
+    @patch('os.stat')
+    def test_place_data_on_block_device(self, _stat, _chown):
+        self._patch('mount')
+        self._patch('copy_files')
+        self._patch('umount')
+        _stat.return_value.st_uid = 100
+        _stat.return_value.st_gid = 100
+        ceph_utils.place_data_on_block_device('/dev/sdd', '/var/lib/mysql')
+        self.mount.assert_has_calls([
+            call('/dev/sdd', '/mnt'),
+            call('/dev/sdd', '/var/lib/mysql', persist=True)
+        ])
+        self.copy_files.assert_called_with('/var/lib/mysql', '/mnt')
+        self.umount.assert_called_with('/mnt')
+        _chown.assert_called_with('/var/lib/mysql', 100, 100)
+
+    @patch('shutil.copytree')
+    @patch('os.listdir')
+    @patch('os.path.isdir')
+    def test_copy_files_is_dir(self, _isdir, _listdir, _copytree):
+        _isdir.return_value = True
+        subdirs = ['a', 'b', 'c']
+        _listdir.return_value = subdirs
+        ceph_utils.copy_files('/source', '/dest')
+        for d in subdirs:
+            _copytree.assert_has_calls([
+                call('/source/{}'.format(d), '/dest/{}'.format(d),
+                     False, None)
+            ])
+
+    @patch('shutil.copytree')
+    @patch('os.listdir')
+    @patch('os.path.isdir')
+    def test_copy_files_include_symlinks(self, _isdir, _listdir, _copytree):
+        _isdir.return_value = True
+        subdirs = ['a', 'b', 'c']
+        _listdir.return_value = subdirs
+        ceph_utils.copy_files('/source', '/dest', True)
+        for d in subdirs:
+            _copytree.assert_has_calls([
+                call('/source/{}'.format(d), '/dest/{}'.format(d),
+                     True, None)
+            ])
+
+    @patch('shutil.copytree')
+    @patch('os.listdir')
+    @patch('os.path.isdir')
+    def test_copy_files_ignore(self, _isdir, _listdir, _copytree):
+        _isdir.return_value = True
+        subdirs = ['a', 'b', 'c']
+        _listdir.return_value = subdirs
+        ceph_utils.copy_files('/source', '/dest', True, False)
+        for d in subdirs:
+            _copytree.assert_has_calls([
+                call('/source/{}'.format(d), '/dest/{}'.format(d),
+                     True, False)
+            ])
+
+    @patch('shutil.copy2')
+    @patch('os.listdir')
+    @patch('os.path.isdir')
+    def test_copy_files_files(self, _isdir, _listdir, _copy2):
+        _isdir.return_value = False
+        files = ['a', 'b', 'c']
+        _listdir.return_value = files
+        ceph_utils.copy_files('/source', '/dest')
+        for f in files:
+            _copy2.assert_has_calls([
+                call('/source/{}'.format(f), '/dest/{}'.format(f))
+            ])
+
+    def test_ensure_ceph_storage(self):
+        self._patch('pool_exists')
+        self.pool_exists.return_value = False
+        self._patch('create_pool')
+        self._patch('rbd_exists')
+        self.rbd_exists.return_value = False
+        self._patch('create_rbd_image')
+        self._patch('image_mapped')
+        self.image_mapped.return_value = False
+        self._patch('map_block_storage')
+        self._patch('filesystem_mounted')
+        self.filesystem_mounted.return_value = False
+        self._patch('make_filesystem')
+        self._patch('service_stop')
+        self._patch('service_start')
+        self._patch('service_running')
+        self.service_running.return_value = True
+        self._patch('place_data_on_block_device')
+        _service = 'mysql'
+        _pool = 'bar'
+        _rbd_img = 'foo'
+        _mount = '/var/lib/mysql'
+        _services = ['mysql']
+        _blk_dev = '/dev/rbd1'
+        ceph_utils.ensure_ceph_storage(_service, _pool,
+                                       _rbd_img, 1024, _mount,
+                                       _blk_dev, 'ext4', _services, 3)
+        self.create_pool.assert_called_with(_service, _pool, replicas=3)
+        self.create_rbd_image.assert_called_with(_service, _pool,
+                                                 _rbd_img, 1024)
+        self.map_block_storage.assert_called_with(_service, _pool, _rbd_img)
+        self.make_filesystem.assert_called_with(_blk_dev, 'ext4')
+        self.service_stop.assert_called_with(_services[0])
+        self.place_data_on_block_device.assert_called_with(_blk_dev, _mount)
+        self.service_start.assert_called_with(_services[0])
+
+    def test_make_filesystem_default_filesystem(self):
+        """make_filesystem() uses ext4 as the default filesystem."""
+        device = '/dev/zero'
+        ceph_utils.make_filesystem(device)
+        self.check_call.assert_called_with(['mkfs', '-t', 'ext4', device])
+
+    def test_make_filesystem_no_device(self):
+        """make_filesystem() raises an IOError if the device does not exist."""
+        device = '/no/such/device'
+        e = self.assertRaises(IOError, ceph_utils.make_filesystem, device,
+                              timeout=0)
+        self.assertEquals(device, e.filename)
+        self.assertEquals(errno.ENOENT, e.errno)
+        self.assertEquals(os.strerror(errno.ENOENT), e.strerror)
+        self.log.assert_called_with(
+            'Gave up waiting on block device %s' % device, level='ERROR')
+
+    @nose.plugins.attrib.attr('slow')
+    def test_make_filesystem_timeout(self):
+        """
+        make_filesystem() allows to specify how long it should wait for the
+        device to appear before it fails.
+        """
+        device = '/no/such/device'
+        timeout = 2
+        before = time.time()
+        self.assertRaises(IOError, ceph_utils.make_filesystem, device,
+                          timeout=timeout)
+        after = time.time()
+        duration = after - before
+        self.assertTrue(timeout - duration < 0.1)
+        self.log.assert_called_with(
+            'Gave up waiting on block device %s' % device, level='ERROR')
+
+    @nose.plugins.attrib.attr('slow')
+    def test_device_is_formatted_if_it_appears(self):
+        """
+        The specified device is formatted if it appears before the timeout
+        is reached.
+        """
+
+        def create_my_device(filename):
+            with open(filename, "w") as device:
+                device.write("hello\n")
+
+        temp_dir = mkdtemp()
+        self.addCleanup(rmtree, temp_dir)
+        device = "%s/mydevice" % temp_dir
+        fstype = 'xfs'
+        timeout = 4
+        t = Timer(2, create_my_device, [device])
+        t.start()
+        ceph_utils.make_filesystem(device, fstype, timeout)
+        self.check_call.assert_called_with(['mkfs', '-t', fstype, device])
+
+    def test_existing_device_is_formatted(self):
+        """
+        make_filesystem() formats the given device if it exists with the
+        specified filesystem.
+        """
+        device = '/dev/zero'
+        fstype = 'xfs'
+        ceph_utils.make_filesystem(device, fstype)
+        self.check_call.assert_called_with(['mkfs', '-t', fstype, device])
+        self.log.assert_called_with(
+            'Formatting block device %s as '
+            'filesystem %s.' % (device, fstype), level='INFO'
+        )
+
+    @patch.object(ceph_utils, 'relation_ids')
+    @patch.object(ceph_utils, 'related_units')
+    @patch.object(ceph_utils, 'relation_get')
+    def test_ensure_ceph_keyring_no_relation_no_data(self, rget, runits, rids):
+        rids.return_value = []
+        self.assertEquals(False, ceph_utils.ensure_ceph_keyring(service='foo'))
+        rids.return_value = ['ceph:0']
+        runits.return_value = ['ceph/0']
+        rget.return_value = ''
+        self.assertEquals(False, ceph_utils.ensure_ceph_keyring(service='foo'))
+
+    @patch.object(ceph_utils, '_keyring_path')
+    @patch.object(ceph_utils, 'add_key')
+    @patch.object(ceph_utils, 'relation_ids')
+    def test_ensure_ceph_keyring_no_relation_but_key(self, rids,
+                                                     create, _path):
+        rids.return_value = []
+        self.assertTrue(ceph_utils.ensure_ceph_keyring(service='foo',
+                                                       key='testkey'))
+        create.assert_called_with(service='foo', key='testkey')
+        _path.assert_called_with('foo')
+
+    @patch.object(ceph_utils, '_keyring_path')
+    @patch.object(ceph_utils, 'add_key')
+    @patch.object(ceph_utils, 'relation_ids')
+    @patch.object(ceph_utils, 'related_units')
+    @patch.object(ceph_utils, 'relation_get')
+    def test_ensure_ceph_keyring_with_data(self, rget, runits,
+                                           rids, create, _path):
+        rids.return_value = ['ceph:0']
+        runits.return_value = ['ceph/0']
+        rget.return_value = 'fookey'
+        self.assertEquals(True,
+                          ceph_utils.ensure_ceph_keyring(service='foo'))
+        create.assert_called_with(service='foo', key='fookey')
+        _path.assert_called_with('foo')
+        self.assertFalse(self.check_call.called)
+
+        _path.return_value = '/etc/ceph/client.foo.keyring'
+        self.assertEquals(
+            True,
+            ceph_utils.ensure_ceph_keyring(
+                service='foo', user='adam', group='users'))
+        create.assert_called_with(service='foo', key='fookey')
+        _path.assert_called_with('foo')
+        self.check_call.assert_called_with([
+            'chown',
+            'adam.users',
+            '/etc/ceph/client.foo.keyring'
+        ])
+
+    @patch.object(ceph_utils, 'service_name')
+    @patch.object(ceph_utils, 'uuid')
+    def test_ceph_broker_rq_class(self, uuid, service_name):
+        service_name.return_value = 'service_test'
+        uuid.uuid1.return_value = 'uuid'
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool('pool1', replica_count=1)
+        rq.add_op_create_pool('pool1', replica_count=1)
+        rq.add_op_create_pool('pool2')
+        rq.add_op_create_pool('pool2')
+        rq.add_op_create_pool('pool3', group='test')
+        rq.add_op_request_access_to_group(name='test')
+        rq.add_op_request_access_to_group(name='test')
+        rq.add_op_request_access_to_group(name='objects',
+                                          key_name='test')
+        rq.add_op_request_access_to_group(
+            name='others',
+            object_prefix_permissions={'rwx': ['prefix1']})
+        expected = {
+            'api-version': 1,
+            'request-id': 'uuid',
+            'ops': [{'op': 'create-pool', 'name': 'pool1', 'replicas': 1},
+                    {'op': 'create-pool', 'name': 'pool2', 'replicas': 3},
+                    {'op': 'create-pool', 'name': 'pool3', 'replicas': 3, 'group': 'test'},
+                    {'op': 'add-permissions-to-key', 'group': 'test', 'name': 'service_test'},
+                    {'op': 'add-permissions-to-key', 'group': 'objects', 'name': 'test'},
+                    {
+                        'op': 'add-permissions-to-key',
+                        'group': 'others',
+                        'name': 'service_test',
+                        'object-prefix-permissions': {u'rwx': [u'prefix1']}}]
+        }
+        request_dict = json.loads(rq.request)
+        for key in ['api-version', 'request-id']:
+            self.assertEqual(request_dict[key], expected[key])
+        for (op_no, expected_op) in enumerate(expected['ops']):
+            for key in expected_op.keys():
+                self.assertEqual(
+                    request_dict['ops'][op_no][key],
+                    expected_op[key])
+
+    @patch.object(ceph_utils, 'service_name')
+    @patch.object(ceph_utils, 'uuid')
+    def test_ceph_broker_rq_class_test_not_equal(self, uuid, service_name):
+        service_name.return_value = 'service_test'
+        uuid.uuid1.return_value = 'uuid'
+        rq1 = ceph_utils.CephBrokerRq()
+        rq1.add_op_create_pool('pool1')
+        rq1.add_op_request_access_to_group(name='test')
+        rq1.add_op_request_access_to_group(name='objects',
+                                           permission='rwx')
+        rq2 = ceph_utils.CephBrokerRq()
+        rq2.add_op_create_pool('pool1')
+        rq2.add_op_request_access_to_group(name='test')
+        rq2.add_op_request_access_to_group(name='objects',
+                                           permission='r')
+        self.assertFalse(rq1 == rq2)
+
+    def test_ceph_broker_rsp_class(self):
+        rsp = ceph_utils.CephBrokerRsp(json.dumps({'exit-code': 0,
+                                                   'stderr': "Success"}))
+        self.assertEqual(rsp.exit_code, 0)
+        self.assertEqual(rsp.exit_msg, "Success")
+        self.assertEqual(rsp.request_id, None)
+
+    def test_ceph_broker_rsp_class_rqid(self):
+        rsp = ceph_utils.CephBrokerRsp(json.dumps({'exit-code': 0,
+                                                   'stderr': "Success",
+                                                   'request-id': 'reqid1'}))
+        self.assertEqual(rsp.exit_code, 0)
+        self.assertEqual(rsp.exit_msg, 'Success')
+        self.assertEqual(rsp.request_id, 'reqid1')
+
+    def setup_client_relation(self, relation):
+        relation = FakeRelation(relation)
+        self.relation_get.side_effect = relation.get
+        self.relation_ids.side_effect = relation.relation_ids
+        self.related_units.side_effect = relation.related_units
+
+    #    @patch.object(ceph_utils, 'uuid')
+    #    @patch.object(ceph_utils, 'local_unit')
+    #    def test_get_request_states(self, mlocal_unit, muuid):
+    #        muuid.uuid1.return_value = '0bc7dc54'
+    @patch.object(ceph_utils, 'local_unit')
+    def test_get_request_states(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        expect = {'ceph:8': {'complete': True, 'sent': True}}
+        self.assertEqual(ceph_utils.get_request_states(rq), expect)
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_get_request_states_newrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        expect = {'ceph:8': {'complete': False, 'sent': False}}
+        self.assertEqual(ceph_utils.get_request_states(rq), expect)
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_get_request_states_pendingrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        del rel['ceph:8']['ceph/0']['broker-rsp-glance-0']
+        self.setup_client_relation(rel)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        expect = {'ceph:8': {'complete': False, 'sent': True}}
+        self.assertEqual(ceph_utils.get_request_states(rq), expect)
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_get_request_states_failedrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        rel['ceph:8']['ceph/0']['broker-rsp-glance-0'] = '{"request-id": "0bc7dc54", "exit-code": 1}'
+        self.setup_client_relation(rel)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        expect = {'ceph:8': {'complete': False, 'sent': True}}
+        self.assertEqual(ceph_utils.get_request_states(rq), expect)
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent_newrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        self.assertFalse(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent_pending(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        del rel['ceph:8']['ceph/0']['broker-rsp-glance-0']
+        self.setup_client_relation(rel)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent_legacy(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION_LEGACY)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent_legacy_newrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION_LEGACY)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        self.assertFalse(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_sent_legacy_pending(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION_LEGACY)
+        del rel['ceph:8']['ceph/0']['broker_rsp']
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_sent(rq))
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = '0bc7dc54'
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_complete(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_newrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        self.assertFalse(ceph_utils.is_request_complete(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_pending(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        del rel['ceph:8']['ceph/0']['broker-rsp-glance-0']
+        self.setup_client_relation(rel)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertFalse(ceph_utils.is_request_complete(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_legacy(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION_LEGACY)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertTrue(ceph_utils.is_request_complete(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_legacy_newrq(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION_LEGACY)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        self.assertFalse(ceph_utils.is_request_complete(rq))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_legacy_pending(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION_LEGACY)
+        del rel['ceph:8']['ceph/0']['broker_rsp']
+        self.setup_client_relation(rel)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        self.assertFalse(ceph_utils.is_request_complete(rq))
+
+    def test_equivalent_broker_requests(self):
+        rq1 = ceph_utils.CephBrokerRq()
+        rq1.add_op_create_pool(name='glance', replica_count=4)
+        rq2 = ceph_utils.CephBrokerRq()
+        rq2.add_op_create_pool(name='glance', replica_count=4)
+        self.assertTrue(rq1 == rq2)
+
+    def test_equivalent_broker_requests_diff1(self):
+        rq1 = ceph_utils.CephBrokerRq()
+        rq1.add_op_create_pool(name='glance', replica_count=3)
+        rq2 = ceph_utils.CephBrokerRq()
+        rq2.add_op_create_pool(name='glance', replica_count=4)
+        self.assertFalse(rq1 == rq2)
+
+    def test_equivalent_broker_requests_diff2(self):
+        rq1 = ceph_utils.CephBrokerRq()
+        rq1.add_op_create_pool(name='glance', replica_count=3)
+        rq2 = ceph_utils.CephBrokerRq()
+        rq2.add_op_create_pool(name='cinder', replica_count=3)
+        self.assertFalse(rq1 == rq2)
+
+    def test_equivalent_broker_requests_diff3(self):
+        rq1 = ceph_utils.CephBrokerRq()
+        rq1.add_op_create_pool(name='glance', replica_count=3)
+        rq2 = ceph_utils.CephBrokerRq(api_version=2)
+        rq2.add_op_create_pool(name='glance', replica_count=3)
+        self.assertFalse(rq1 == rq2)
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_for_rid(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = '0bc7dc54'
+        req = ceph_utils.CephBrokerRq()
+        req.add_op_create_pool(name='glance', replica_count=3)
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        self.assertTrue(ceph_utils.is_request_complete_for_rid(req, 'ceph:8'))
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_for_rid_newrq(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = 'a44c0fa6'
+        req = ceph_utils.CephBrokerRq()
+        req.add_op_create_pool(name='glance', replica_count=4)
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        self.assertFalse(ceph_utils.is_request_complete_for_rid(req, 'ceph:8'))
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_for_rid_failed(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = '0bc7dc54'
+        req = ceph_utils.CephBrokerRq()
+        req.add_op_create_pool(name='glance', replica_count=4)
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        rel['ceph:8']['ceph/0']['broker-rsp-glance-0'] = '{"request-id": "0bc7dc54", "exit-code": 1}'
+        self.setup_client_relation(rel)
+        self.assertFalse(ceph_utils.is_request_complete_for_rid(req, 'ceph:8'))
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_for_rid_pending(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = '0bc7dc54'
+        req = ceph_utils.CephBrokerRq()
+        req.add_op_create_pool(name='glance', replica_count=4)
+        mlocal_unit.return_value = 'glance/0'
+        rel = copy.deepcopy(CEPH_CLIENT_RELATION)
+        del rel['ceph:8']['ceph/0']['broker-rsp-glance-0']
+        self.setup_client_relation(rel)
+        self.assertFalse(ceph_utils.is_request_complete_for_rid(req, 'ceph:8'))
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_is_request_complete_for_rid_legacy(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = '0bc7dc54'
+        req = ceph_utils.CephBrokerRq()
+        req.add_op_create_pool(name='glance', replica_count=3)
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION_LEGACY)
+        self.assertTrue(ceph_utils.is_request_complete_for_rid(req, 'ceph:8'))
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_get_broker_rsp_key(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.assertEqual(ceph_utils.get_broker_rsp_key(), 'broker-rsp-glance-0')
+
+    @patch.object(ceph_utils, 'local_unit')
+    def test_send_request_if_needed(self, mlocal_unit):
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=3)
+        ceph_utils.send_request_if_needed(rq)
+        self.relation_set.assert_has_calls([])
+
+    @patch.object(ceph_utils, 'uuid')
+    @patch.object(ceph_utils, 'local_unit')
+    def test_send_request_if_needed_newrq(self, mlocal_unit, muuid):
+        muuid.uuid1.return_value = 'de67511e'
+        mlocal_unit.return_value = 'glance/0'
+        self.setup_client_relation(CEPH_CLIENT_RELATION)
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool(name='glance', replica_count=4)
+        ceph_utils.send_request_if_needed(rq)
+        actual = json.loads(self.relation_set.call_args_list[0][1]['broker_req'])
+        self.assertEqual(actual['api-version'], 1)
+        self.assertEqual(actual['request-id'], 'de67511e')
+        self.assertEqual(actual['ops'][0]['replicas'], 4)
+        self.assertEqual(actual['ops'][0]['op'], 'create-pool')
+        self.assertEqual(actual['ops'][0]['name'], 'glance')
+
+    @patch.object(ceph_utils, 'config')
+    def test_ceph_conf_context(self, mock_config):
+        mock_config.return_value = "{'osd': {'foo': 1}}"
+        ctxt = ceph_utils.CephConfContext()()
+        self.assertEqual({'osd': {'foo': 1}}, ctxt)
+        ctxt = ceph_utils.CephConfContext(['osd', 'mon'])()
+        mock_config.return_value = ("{'osd': {'foo': 1},"
+                                    "'unknown': {'blah': 1}}")
+        self.assertEqual({'osd': {'foo': 1}}, ctxt)
+
+    @patch.object(ceph_utils, 'get_osd_settings')
+    @patch.object(ceph_utils, 'config')
+    def test_ceph_osd_conf_context_conflict(self, mock_config,
+                                            mock_get_osd_settings):
+        mock_config.return_value = "{'osd': {'osd heartbeat grace': 20}}"
+        mock_get_osd_settings.return_value = {
+            'osd heartbeat grace': 25,
+            'osd heartbeat interval': 5}
+        ctxt = ceph_utils.CephOSDConfContext()()
+        self.assertEqual(ctxt, {
+            'osd': collections.OrderedDict([('osd heartbeat grace', 20)]),
+            'osd_from_client': collections.OrderedDict(
+                [('osd heartbeat interval', 5)]),
+            'osd_from_client_conflict': collections.OrderedDict(
+                [('osd heartbeat grace', 25)])})
+
+    @patch.object(ceph_utils, 'local_unit', lambda: "nova-compute/0")
+    def test_is_broker_action_done(self):
+        tmpdir = mkdtemp()
+        try:
+            db_path = '{}/kv.db'.format(tmpdir)
+            with patch('charmhelpers.core.unitdata._KV', Storage(db_path)):
+                rq_id = "3d03e9f6-4c36-11e7-89ba-fa163e7c7ec6"
+                broker_key = ceph_utils.get_broker_rsp_key()
+                self.relation_get.return_value = {broker_key:
+                                                  json.dumps({"request-id":
+                                                              rq_id,
+                                                              "exit-code": 0})}
+                action = 'restart_nova_compute'
+                ret = ceph_utils.is_broker_action_done(action, rid="ceph:1",
+                                                       unit="ceph/0")
+                self.relation_get.assert_has_calls([call(rid='ceph:1', unit='ceph/0')])
+                self.assertFalse(ret)
+
+                ceph_utils.mark_broker_action_done(action)
+                self.assertTrue(os.path.exists(tmpdir))
+                ret = ceph_utils.is_broker_action_done(action, rid="ceph:1",
+                                                       unit="ceph/0")
+                self.assertTrue(ret)
+        finally:
+            if os.path.exists(tmpdir):
+                shutil.rmtree(tmpdir)
+
+    def test_has_broker_rsp(self):
+        rq_id = "3d03e9f6-4c36-11e7-89ba-fa163e7c7ec6"
+        broker_key = ceph_utils.get_broker_rsp_key()
+        self.relation_get.return_value = {broker_key:
+                                          json.dumps({"request-id":
+                                                      rq_id,
+                                                      "exit-code": 0})}
+        ret = ceph_utils.has_broker_rsp(rid="ceph:1", unit="ceph/0")
+        self.assertTrue(ret)
+        self.relation_get.assert_has_calls([call(rid='ceph:1', unit='ceph/0')])
+
+        self.relation_get.return_value = {'something_else':
+                                          json.dumps({"request-id":
+                                                      rq_id,
+                                                      "exit-code": 0})}
+        ret = ceph_utils.has_broker_rsp(rid="ceph:1", unit="ceph/0")
+        self.assertFalse(ret)
+
+        self.relation_get.return_value = None
+        ret = ceph_utils.has_broker_rsp(rid="ceph:1", unit="ceph/0")
+        self.assertFalse(ret)
+
+    @patch.object(ceph_utils, 'local_unit', lambda: "nova-compute/0")
+    def test_mark_broker_action_done(self):
+        tmpdir = mkdtemp()
+        try:
+            db_path = '{}/kv.db'.format(tmpdir)
+            with patch('charmhelpers.core.unitdata._KV', Storage(db_path)):
+                rq_id = "3d03e9f6-4c36-11e7-89ba-fa163e7c7ec6"
+                broker_key = ceph_utils.get_broker_rsp_key()
+                self.relation_get.return_value = {broker_key:
+                                                  json.dumps({"request-id":
+                                                              rq_id})}
+                action = 'restart_nova_compute'
+                ceph_utils.mark_broker_action_done(action, rid="ceph:1",
+                                                   unit="ceph/0")
+                key = 'unit_0_ceph_broker_action.{}'.format(action)
+                self.relation_get.assert_has_calls([call(rid='ceph:1', unit='ceph/0')])
+                kvstore = Storage(db_path)
+                self.assertEqual(kvstore.get(key=key), rq_id)
+        finally:
+            if os.path.exists(tmpdir):
+                shutil.rmtree(tmpdir)
+
+    def test_add_op_create_replicated_pool(self):
+        base_op = {'app-name': None,
+                   'group': None,
+                   'group-namespace': None,
+                   'max-bytes': None,
+                   'max-objects': None,
+                   'name': 'apool',
+                   'op': 'create-pool',
+                   'pg_num': None,
+                   'replicas': 3,
+                   'weight': None}
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool')
+        self.assertEqual(rq.ops, [base_op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_pool('apool', replica_count=42)
+        op = base_op.copy()
+        op['replicas'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', pg_num=42)
+        op = base_op.copy()
+        op['pg_num'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', weight=42)
+        op = base_op.copy()
+        op['weight'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', group=51)
+        op = base_op.copy()
+        op['group'] = 51
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', namespace='sol-iii')
+        op = base_op.copy()
+        op['group-namespace'] = 'sol-iii'
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', app_name='earth')
+        op = base_op.copy()
+        op['app-name'] = 'earth'
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', max_bytes=42)
+        op = base_op.copy()
+        op['max-bytes'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_replicated_pool('apool', max_objects=42)
+        op = base_op.copy()
+        op['max-objects'] = 42
+        self.assertEqual(rq.ops, [op])
+
+    def test_add_op_create_erasure_pool(self):
+        base_op = {'app-name': None,
+                   'erasure-profile': None,
+                   'group': None,
+                   'max-bytes': None,
+                   'max-objects': None,
+                   'name': 'apool',
+                   'op': 'create-pool',
+                   'pool-type': 'erasure',
+                   'weight': None}
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool')
+        self.assertEqual(rq.ops, [base_op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool', weight=42)
+        op = base_op.copy()
+        op['weight'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool', group=51)
+        op = base_op.copy()
+        op['group'] = 51
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool', app_name='earth')
+        op = base_op.copy()
+        op['app-name'] = 'earth'
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool', max_bytes=42)
+        op = base_op.copy()
+        op['max-bytes'] = 42
+        self.assertEqual(rq.ops, [op])
+        rq = ceph_utils.CephBrokerRq()
+        rq.add_op_create_erasure_pool('apool', max_objects=42)
+        op = base_op.copy()
+        op['max-objects'] = 42
+        self.assertEqual(rq.ops, [op])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_loopback.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_loopback.py
new file mode 100644
index 0000000000000000000000000000000000000000..85a130d4570518883b724f8d8856aed2b2d41bf9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_loopback.py
@@ -0,0 +1,82 @@
+import unittest
+
+from mock import patch
+
+import charmhelpers.contrib.storage.linux.loopback as loopback
+
+LOOPBACK_DEVICES = b"""
+/dev/loop0: [0805]:2244465 (/tmp/foo.img)
+/dev/loop1: [0805]:2244466 (/tmp/bar.img)
+/dev/loop2: [0805]:2244467 (/tmp/baz.img (deleted))
+"""
+
+# It's a mouthful.
+STORAGE_LINUX_LOOPBACK = 'charmhelpers.contrib.storage.linux.loopback'
+
+
+class LoopbackStorageUtilsTests(unittest.TestCase):
+    @patch(STORAGE_LINUX_LOOPBACK + '.check_output')
+    def test_loopback_devices(self, output):
+        """It translates current loopback mapping to a dict"""
+        output.return_value = LOOPBACK_DEVICES
+        ex = {
+            '/dev/loop1': '/tmp/bar.img',
+            '/dev/loop0': '/tmp/foo.img',
+            '/dev/loop2': '/tmp/baz.img (deleted)'
+        }
+        self.assertEquals(loopback.loopback_devices(), ex)
+
+    @patch(STORAGE_LINUX_LOOPBACK + '.create_loopback')
+    @patch('subprocess.check_call')
+    @patch(STORAGE_LINUX_LOOPBACK + '.loopback_devices')
+    def test_loopback_create_already_exists(self, loopbacks, check_call,
+                                            create):
+        """It finds existing loopback device for requested file"""
+        loopbacks.return_value = {'/dev/loop1': '/tmp/bar.img'}
+        res = loopback.ensure_loopback_device('/tmp/bar.img', '5G')
+        self.assertEquals(res, '/dev/loop1')
+        self.assertFalse(create.called)
+        self.assertFalse(check_call.called)
+
+    @patch(STORAGE_LINUX_LOOPBACK + '.loopback_devices')
+    @patch(STORAGE_LINUX_LOOPBACK + '.create_loopback')
+    @patch('os.path.exists')
+    def test_loop_creation_no_truncate(self, path_exists, create_loopback,
+                                       loopbacks):
+        """It does not create a new sparse image for loopback if one exists"""
+        loopbacks.return_value = {}
+        path_exists.return_value = True
+        with patch('subprocess.check_call') as check_call:
+            loopback.ensure_loopback_device('/tmp/foo.img', '15G')
+            self.assertFalse(check_call.called)
+
+    @patch(STORAGE_LINUX_LOOPBACK + '.loopback_devices')
+    @patch(STORAGE_LINUX_LOOPBACK + '.create_loopback')
+    @patch('os.path.exists')
+    def test_ensure_loopback_creation(self, path_exists, create_loopback,
+                                      loopbacks):
+        """It creates a new sparse image for loopback if one does not exists"""
+        loopbacks.return_value = {}
+        path_exists.return_value = False
+        create_loopback.return_value = '/dev/loop0'
+        with patch(STORAGE_LINUX_LOOPBACK + '.check_call') as check_call:
+            loopback.ensure_loopback_device('/tmp/foo.img', '15G')
+            check_call.assert_called_with(['truncate', '--size', '15G',
+                                           '/tmp/foo.img'])
+
+    @patch.object(loopback, 'loopback_devices')
+    def test_create_loopback(self, _devs):
+        """It correctly calls losetup to create a loopback device"""
+        _devs.return_value = {'/dev/loop0': '/tmp/foo'}
+        with patch(STORAGE_LINUX_LOOPBACK + '.check_call') as check_call:
+            check_call.return_value = ''
+            result = loopback.create_loopback('/tmp/foo')
+            check_call.assert_called_with(['losetup', '--find', '/tmp/foo'])
+            self.assertEquals(result, '/dev/loop0')
+
+    @patch.object(loopback, 'loopback_devices')
+    def test_create_is_mapped_loopback_device(self, devs):
+        devs.return_value = {'/dev/loop0': "/tmp/manco"}
+        self.assertEquals(loopback.is_mapped_loopback_device("/dev/loop0"),
+                          "/tmp/manco")
+        self.assertFalse(loopback.is_mapped_loopback_device("/dev/loop1"))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_lvm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_lvm.py
new file mode 100644
index 0000000000000000000000000000000000000000..015d451dd2aad0f1d466f946ab8234934313e7d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_lvm.py
@@ -0,0 +1,212 @@
+import unittest
+import subprocess
+
+from mock import patch
+
+import charmhelpers.contrib.storage.linux.lvm as lvm
+
+PVDISPLAY = b"""
+  --- Physical volume ---
+  PV Name               /dev/loop0
+  VG Name               foo
+  PV Size               10.00 MiB / not usable 2.00 MiB
+  Allocatable           yes
+  PE Size               4.00 MiB
+  Total PE              2
+  Free PE               2
+  Allocated PE          0
+  PV UUID               fyVqlr-pyrL-89On-f6MD-U91T-dEfc-SL0V2V
+
+"""
+
+EMPTY_VG_IN_PVDISPLAY = b"""
+  --- Physical volume ---
+  PV Name               /dev/loop0
+  VG Name
+  PV Size               10.00 MiB / not usable 2.00 MiB
+  Allocatable           yes
+  PE Size               4.00 MiB
+  Total PE              2
+  Free PE               2
+  Allocated PE          0
+  PV UUID               fyVqlr-pyrL-89On-f6MD-U91T-dEfc-SL0V2V
+
+"""
+LVS_DEFAULT = b"""
+  cinder-volumes-pool
+  testvol
+  volume-48be6ba0-84c3-4b8d-9be5-e68e47fc7682
+  volume-f8c1d2fd-1fa1-4d84-b4e0-431dba7d582e
+"""
+LVS_WITH_VG = b"""
+  cinder-volumes cinder-volumes-pool
+  cinder-volumes testvol
+  cinder-volumes volume-48be6ba0-84c3-4b8d-9be5-e68e47fc7682
+  cinder-volumes volume-f8c1d2fd-1fa1-4d84-b4e0-431dba7d582e
+"""
+LVS_THIN_POOLS = b"""
+  cinder-volumes-pool
+"""
+LVS_THIN_POOLS_WITH_VG = b"""
+  cinder-volumes cinder-volumes-pool
+"""
+
+# It's a mouthful.
+STORAGE_LINUX_LVM = 'charmhelpers.contrib.storage.linux.lvm'
+
+
+class LVMStorageUtilsTests(unittest.TestCase):
+    def test_find_volume_group_on_pv(self):
+        """It determines any volume group assigned to a LVM PV"""
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = PVDISPLAY
+            vg = lvm.list_lvm_volume_group('/dev/loop0')
+            self.assertEquals(vg, 'foo')
+
+    def test_find_empty_volume_group_on_pv(self):
+        """Return empty string when no volume group is assigned to the PV"""
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = EMPTY_VG_IN_PVDISPLAY
+            vg = lvm.list_lvm_volume_group('/dev/loop0')
+            self.assertEquals(vg, '')
+
+    @patch(STORAGE_LINUX_LVM + '.list_lvm_volume_group')
+    def test_deactivate_lvm_volume_groups(self, ls_vg):
+        """It deactivates active volume groups on LVM PV"""
+        ls_vg.return_value = 'foo-vg'
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.deactivate_lvm_volume_group('/dev/loop0')
+            check_call.assert_called_with(['vgchange', '-an', 'foo-vg'])
+
+    def test_remove_lvm_physical_volume(self):
+        """It removes LVM physical volume signatures from block device"""
+        with patch(STORAGE_LINUX_LVM + '.Popen') as popen:
+            lvm.remove_lvm_physical_volume('/dev/foo')
+            popen.assert_called_with(['pvremove', '-ff', '/dev/foo'], stdin=-1)
+
+    def test_is_physical_volume(self):
+        """It properly reports block dev is an LVM PV"""
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = PVDISPLAY
+            self.assertTrue(lvm.is_lvm_physical_volume('/dev/loop0'))
+
+    def test_is_not_physical_volume(self):
+        """It properly reports block dev is an LVM PV"""
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.side_effect = subprocess.CalledProcessError('cmd', 2)
+            self.assertFalse(lvm.is_lvm_physical_volume('/dev/loop0'))
+
+    def test_pvcreate(self):
+        """It correctly calls pvcreate for a given block dev"""
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.create_lvm_physical_volume('/dev/foo')
+            check_call.assert_called_with(['pvcreate', '/dev/foo'])
+
+    def test_vgcreate(self):
+        """It correctly calls vgcreate for given block dev and vol group"""
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.create_lvm_volume_group('foo-vg', '/dev/foo')
+            check_call.assert_called_with(['vgcreate', 'foo-vg', '/dev/foo'])
+
+    def test_list_logical_volumes(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = LVS_DEFAULT
+            self.assertEqual(lvm.list_logical_volumes(), [
+                'cinder-volumes-pool',
+                'testvol',
+                'volume-48be6ba0-84c3-4b8d-9be5-e68e47fc7682',
+                'volume-f8c1d2fd-1fa1-4d84-b4e0-431dba7d582e'])
+            check_output.assert_called_with([
+                'lvs',
+                '--options',
+                'lv_name',
+                '--noheadings'])
+
+    def test_list_logical_volumes_empty(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = b''
+            self.assertEqual(lvm.list_logical_volumes(), [])
+
+    def test_list_logical_volumes_path_mode(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = LVS_WITH_VG
+            self.assertEqual(lvm.list_logical_volumes(path_mode=True), [
+                'cinder-volumes/cinder-volumes-pool',
+                'cinder-volumes/testvol',
+                'cinder-volumes/volume-48be6ba0-84c3-4b8d-9be5-e68e47fc7682',
+                'cinder-volumes/volume-f8c1d2fd-1fa1-4d84-b4e0-431dba7d582e'])
+            check_output.assert_called_with([
+                'lvs',
+                '--options',
+                'vg_name,lv_name',
+                '--noheadings'])
+
+    def test_list_logical_volumes_select_criteria(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = LVS_THIN_POOLS
+            self.assertEqual(
+                lvm.list_logical_volumes(select_criteria='lv_attr =~ ^t'),
+                ['cinder-volumes-pool'])
+            check_output.assert_called_with([
+                'lvs',
+                '--options',
+                'lv_name',
+                '--noheadings',
+                '--select',
+                'lv_attr =~ ^t'])
+
+    def test_list_thin_logical_volume_pools(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = LVS_THIN_POOLS
+            self.assertEqual(
+                lvm.list_thin_logical_volume_pools(),
+                ['cinder-volumes-pool'])
+            check_output.assert_called_with([
+                'lvs',
+                '--options',
+                'lv_name',
+                '--noheadings',
+                '--select',
+                'lv_attr =~ ^t'])
+
+    def test_list_thin_logical_volume_pools_path_mode(self):
+        with patch(STORAGE_LINUX_LVM + '.check_output') as check_output:
+            check_output.return_value = LVS_THIN_POOLS_WITH_VG
+            self.assertEqual(
+                lvm.list_thin_logical_volume_pools(path_mode=True),
+                ['cinder-volumes/cinder-volumes-pool'])
+            check_output.assert_called_with([
+                'lvs',
+                '--options',
+                'vg_name,lv_name',
+                '--noheadings',
+                '--select',
+                'lv_attr =~ ^t'])
+
+    def test_extend_logical_volume_by_device(self):
+        """It correctly calls pvcreate for a given block dev"""
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.extend_logical_volume_by_device('mylv', '/dev/foo')
+            check_call.assert_called_with(['lvextend', 'mylv', '/dev/foo'])
+
+    def test_create_logical_volume_nosize(self):
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.create_logical_volume('testlv', 'testvg')
+            check_call.assert_called_with([
+                'lvcreate',
+                '--yes',
+                '-l',
+                '100%FREE',
+                '-n', 'testlv', 'testvg'
+            ])
+
+    def test_create_logical_volume_size(self):
+        with patch(STORAGE_LINUX_LVM + '.check_call') as check_call:
+            lvm.create_logical_volume('testlv', 'testvg', '10G')
+            check_call.assert_called_with([
+                'lvcreate',
+                '--yes',
+                '-L',
+                '10G',
+                '-n', 'testlv', 'testvg'
+            ])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf4da919807dba72eb4eeee00c07320b6359b1d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/storage/test_linux_storage_utils.py
@@ -0,0 +1,206 @@
+from mock import patch
+import unittest
+
+import charmhelpers.contrib.storage.linux.utils as storage_utils
+
+# It's a mouthful.
+STORAGE_LINUX_UTILS = 'charmhelpers.contrib.storage.linux.utils'
+
+
+class MiscStorageUtilsTests(unittest.TestCase):
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    @patch(STORAGE_LINUX_UTILS + '.call')
+    @patch(STORAGE_LINUX_UTILS + '.check_call')
+    def test_zap_disk(self, check_call, call, check_output):
+        """It calls sgdisk correctly to zap disk"""
+        check_output.return_value = b'200\n'
+        storage_utils.zap_disk('/dev/foo')
+        call.assert_any_call(['sgdisk', '--zap-all', '--', '/dev/foo'])
+        call.assert_any_call(['sgdisk', '--clear', '--mbrtogpt',
+                              '--', '/dev/foo'])
+        check_output.assert_any_call(['blockdev', '--getsz', '/dev/foo'])
+        check_call.assert_any_call(['dd', 'if=/dev/zero', 'of=/dev/foo',
+                                    'bs=1M', 'count=1'])
+        check_call.assert_any_call(['dd', 'if=/dev/zero', 'of=/dev/foo',
+                                    'bs=512', 'count=100', 'seek=100'])
+
+    @patch(STORAGE_LINUX_UTILS + '.S_ISBLK')
+    @patch('os.path.exists')
+    @patch('os.stat')
+    def test_is_block_device(self, S_ISBLK, exists, stat):
+        """It detects device node is block device"""
+        class fake_stat:
+            st_mode = True
+        S_ISBLK.return_value = fake_stat()
+        exists.return_value = True
+        self.assertTrue(storage_utils.is_block_device('/dev/foo'))
+
+    @patch(STORAGE_LINUX_UTILS + '.S_ISBLK')
+    @patch('os.path.exists')
+    @patch('os.stat')
+    def test_is_block_device_does_not_exist(self, S_ISBLK, exists, stat):
+        """It detects device node is block device"""
+        class fake_stat:
+            st_mode = True
+        S_ISBLK.return_value = fake_stat()
+        exists.return_value = False
+        self.assertFalse(storage_utils.is_block_device('/dev/foo'))
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted(self, check_output):
+        """It detects mounted devices as mounted."""
+        check_output.return_value = (
+            b'NAME="sda" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT="/tmp"\n')
+        result = storage_utils.is_device_mounted('/dev/sda')
+        self.assertTrue(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_partition(self, check_output):
+        """It detects mounted partitions as mounted."""
+        check_output.return_value = (
+            b'NAME="sda1" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT="/tmp"\n')
+        result = storage_utils.is_device_mounted('/dev/sda1')
+        self.assertTrue(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_partition_with_device(self, check_output):
+        """It detects mounted devices as mounted if "mount" shows only a
+        partition as mounted."""
+        check_output.return_value = (
+            b'NAME="sda1" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT="/tmp"\n')
+        result = storage_utils.is_device_mounted('/dev/sda')
+        self.assertTrue(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_not_mounted(self, check_output):
+        """It detects unmounted devices as not mounted."""
+        check_output.return_value = (
+            b'NAME="sda" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT=""\n')
+        result = storage_utils.is_device_mounted('/dev/sda')
+        self.assertFalse(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_not_mounted_partition(self, check_output):
+        """It detects unmounted partitions as not mounted."""
+        check_output.return_value = (
+            b'NAME="sda" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT=""\n')
+        result = storage_utils.is_device_mounted('/dev/sda1')
+        self.assertFalse(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_full_disks(self, check_output):
+        """It detects mounted full disks as mounted."""
+        check_output.return_value = (
+            b'NAME="sda" MAJ:MIN="8:16" RM="0" SIZE="238.5G" RO="0" TYPE="disk" MOUNTPOINT="/tmp"\n')
+        result = storage_utils.is_device_mounted('/dev/sda')
+        self.assertTrue(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_cciss(self, check_output):
+        """It detects mounted cciss partitions as mounted."""
+        check_output.return_value = (
+            b'NAME="cciss!c0d0" MAJ:MIN="104:0" RM="0" SIZE="273.3G" RO="0" TYPE="disk" MOUNTPOINT="/root"\n')
+        result = storage_utils.is_device_mounted('/dev/cciss/c0d0')
+        self.assertTrue(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_output')
+    def test_is_device_mounted_cciss_not_mounted(self, check_output):
+        """It detects unmounted cciss partitions as not mounted."""
+        check_output.return_value = (
+            b'NAME="cciss!c0d0" MAJ:MIN="104:0" RM="0" SIZE="273.3G" RO="0" TYPE="disk" MOUNTPOINT=""\n')
+        result = storage_utils.is_device_mounted('/dev/cciss/c0d0')
+        self.assertFalse(result)
+
+    @patch(STORAGE_LINUX_UTILS + '.check_call')
+    def test_mkfs_xfs(self, check_call):
+        storage_utils.mkfs_xfs('/dev/sdb')
+        check_call.assert_called_with(
+            ['mkfs.xfs', '-i', 'size=1024', '/dev/sdb']
+        )
+
+    @patch(STORAGE_LINUX_UTILS + '.check_call')
+    def test_mkfs_xfs_force(self, check_call):
+        storage_utils.mkfs_xfs('/dev/sdb', force=True)
+        check_call.assert_called_with(
+            ['mkfs.xfs', '-f', '-i', 'size=1024', '/dev/sdb']
+        )
+
+    @patch(STORAGE_LINUX_UTILS + '.check_call')
+    def test_mkfs_xfs_inode_size(self, check_call):
+        storage_utils.mkfs_xfs('/dev/sdb', inode_size=512)
+        check_call.assert_called_with(
+            ['mkfs.xfs', '-i', 'size=512', '/dev/sdb']
+        )
+
+
+class CephLUKSDeviceTestCase(unittest.TestCase):
+
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_no_luks_header(self, _luks_uuid):
+        _luks_uuid.return_value = None
+        self.assertEqual(storage_utils.is_luks_device('/dev/sdb'), False)
+
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_luks_header(self, _luks_uuid):
+        _luks_uuid.return_value = '5e1e4c89-4f68-4b9a-bd93-e25eec34e80f'
+        self.assertEqual(storage_utils.is_luks_device('/dev/sdb'), True)
+
+
+class CephMappedLUKSDeviceTestCase(unittest.TestCase):
+
+    @patch.object(storage_utils.os, 'walk')
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_no_luks_header_not_mapped(self, _luks_uuid, _walk):
+        _luks_uuid.return_value = None
+
+        def os_walk_side_effect(path):
+            return {
+                '/sys/class/block/sdb/holders/': iter([('', [], [])]),
+            }[path]
+        _walk.side_effect = os_walk_side_effect
+
+        self.assertEqual(storage_utils.is_mapped_luks_device('/dev/sdb'), False)
+
+    @patch.object(storage_utils.os, 'walk')
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_luks_header_mapped(self, _luks_uuid, _walk):
+        _luks_uuid.return_value = 'db76d142-4782-42f2-84c6-914f9db889a0'
+
+        def os_walk_side_effect(path):
+            return {
+                '/sys/class/block/sdb/holders/': iter([('', ['dm-0'], [])]),
+            }[path]
+        _walk.side_effect = os_walk_side_effect
+
+        self.assertEqual(storage_utils.is_mapped_luks_device('/dev/sdb'), True)
+
+    @patch.object(storage_utils.os, 'walk')
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_luks_header_not_mapped(self, _luks_uuid, _walk):
+        _luks_uuid.return_value = 'db76d142-4782-42f2-84c6-914f9db889a0'
+
+        def os_walk_side_effect(path):
+            return {
+                '/sys/class/block/sdb/holders/': iter([('', [], [])]),
+            }[path]
+        _walk.side_effect = os_walk_side_effect
+
+        self.assertEqual(storage_utils.is_mapped_luks_device('/dev/sdb'), False)
+
+    @patch.object(storage_utils.os, 'walk')
+    @patch.object(storage_utils, '_luks_uuid')
+    def test_no_luks_header_mapped(self, _luks_uuid, _walk):
+        """
+        This is an edge case where a device is mapped (i.e. used for something
+        else) but has no LUKS header. Should be handled by other checks.
+        """
+        _luks_uuid.return_value = None
+
+        def os_walk_side_effect(path):
+            return {
+                '/sys/class/block/sdb/holders/': iter([('', ['dm-0'], [])]),
+            }[path]
+        _walk.side_effect = os_walk_side_effect
+
+        self.assertEqual(storage_utils.is_mapped_luks_device('/dev/sdb'), False)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_contexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_contexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..1abc3d5786995dd7a7f791b5b466661663679d4e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_contexts.py
@@ -0,0 +1,252 @@
+# Copyright 2013 Canonical Ltd.
+#
+# Authors:
+#  Charm Helpers Developers <juju@lists.ubuntu.com>
+import mock
+import os
+import shutil
+import tempfile
+import unittest
+import yaml
+
+import six
+
+import charmhelpers.contrib.templating.contexts
+
+
+class JujuState2YamlTestCase(unittest.TestCase):
+    maxDiff = None
+
+    unit_data = {
+        'private-address': '10.0.3.2',
+        'public-address': '123.123.123.123',
+    }
+
+    def setUp(self):
+        super(JujuState2YamlTestCase, self).setUp()
+
+        # Hookenv patches (a single patch to hookenv doesn't work):
+        patcher = mock.patch('charmhelpers.core.hookenv.config')
+        self.mock_config = patcher.start()
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relation_get')
+        self.mock_relation_get = patcher.start()
+        self.mock_relation_get.return_value = {}
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relations')
+        self.mock_relations = patcher.start()
+        self.mock_relations.return_value = {
+            'wsgi-file': {},
+            'website': {},
+            'nrpe-external-master': {},
+        }
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relation_type')
+        self.mock_relation_type = patcher.start()
+        self.mock_relation_type.return_value = None
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.local_unit')
+        self.mock_local_unit = patcher.start()
+        self.addCleanup(patcher.stop)
+        patcher = mock.patch('charmhelpers.core.hookenv.relations_of_type')
+        self.mock_relations_of_type = patcher.start()
+        self.addCleanup(patcher.stop)
+        self.mock_relations_of_type.return_value = []
+
+        def unit_get_data(argument):
+            "dummy unit_get that accesses dummy unit data"
+            return self.unit_data[argument]
+
+        patcher = mock.patch(
+            'charmhelpers.core.hookenv.unit_get', unit_get_data)
+        self.mock_unit_get = patcher.start()
+        self.addCleanup(patcher.stop)
+
+        # patches specific to this test class.
+        etc_dir = tempfile.mkdtemp()
+        self.addCleanup(shutil.rmtree, etc_dir)
+        self.context_path = os.path.join(etc_dir, 'some', 'context')
+
+        patcher = mock.patch.object(charmhelpers.contrib.templating.contexts,
+                                    'charm_dir', '/tmp/charm_dir')
+        patcher.start()
+        self.addCleanup(patcher.stop)
+
+    def default_context(self):
+        return {
+            "charm_dir": "/tmp/charm_dir",
+            "group_code_owner": "webops_deploy",
+            "user_code_runner": "ubunet",
+            "current_relation": {},
+            "relations_full": {
+                'wsgi-file': {},
+                'website': {},
+                'nrpe-external-master': {},
+            },
+            "relations": {
+                'wsgi-file': [],
+                'website': [],
+                'nrpe-external-master': [],
+            },
+            "local_unit": "click-index/3",
+            "unit_private_address": "10.0.3.2",
+            "unit_public_address": "123.123.123.123",
+        }
+
+    def test_output_with_empty_relation(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path)
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            self.assertEqual(expected, result)
+
+    def test_output_with_no_relation(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+        self.mock_relation_get.return_value = None
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path)
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            self.assertEqual(expected, result)
+
+    def test_output_with_relation(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+        }
+        self.mock_relation_type.return_value = 'wsgi-file'
+        self.mock_relation_get.return_value = {
+            'relation_key1': 'relation_value1',
+            'relation_key2': 'relation_value2',
+        }
+        self.mock_relations.return_value = {
+            'wsgi-file': {
+                six.u('wsgi-file:0'): {
+                    six.u('gunicorn/1'): {
+                        six.u('private-address'): six.u('10.0.3.99'),
+                    },
+                    'click-index/3': {
+                        six.u('wsgi_group'): six.u('ubunet'),
+                    },
+                },
+            },
+            'website': {},
+            'nrpe-external-master': {},
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path)
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            expected['current_relation'] = {
+                "relation_key1": "relation_value1",
+                "relation_key2": "relation_value2",
+            }
+            expected["wsgi_file:relation_key1"] = "relation_value1"
+            expected["wsgi_file:relation_key2"] = "relation_value2"
+            expected["relations_full"]['wsgi-file'] = {
+                'wsgi-file:0': {
+                    'gunicorn/1': {
+                        six.u('private-address'): six.u('10.0.3.99')},
+                    'click-index/3': {six.u('wsgi_group'): six.u('ubunet')},
+                },
+            }
+            expected["relations"]["wsgi-file"] = [
+                {
+                    '__relid__': 'wsgi-file:0',
+                    '__unit__': 'gunicorn/1',
+                    'private-address': '10.0.3.99',
+                }
+            ]
+            self.assertEqual(expected, result)
+
+    def test_relation_with_separator(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+        }
+        self.mock_relation_type.return_value = 'wsgi-file'
+        self.mock_relation_get.return_value = {
+            'relation_key1': 'relation_value1',
+            'relation_key2': 'relation_value2',
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path, namespace_separator='__')
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            expected['current_relation'] = {
+                "relation_key1": "relation_value1",
+                "relation_key2": "relation_value2",
+            }
+            expected["wsgi_file__relation_key1"] = "relation_value1"
+            expected["wsgi_file__relation_key2"] = "relation_value2"
+            self.assertEqual(expected, result)
+
+    def test_keys_with_hyphens(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+            'private-address': '10.1.1.10',
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+        self.mock_relation_get.return_value = None
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path)
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            expected["private-address"] = "10.1.1.10"
+            self.assertEqual(expected, result)
+
+    def test_keys_with_hypens_not_allowed_in_keys(self):
+        self.mock_config.return_value = {
+            'group_code_owner': 'webops_deploy',
+            'user_code_runner': 'ubunet',
+            'private-address': '10.1.1.10',
+        }
+        self.mock_local_unit.return_value = "click-index/3"
+        self.mock_relation_type.return_value = 'wsgi-file'
+        self.mock_relation_get.return_value = {
+            'relation-key1': 'relation_value1',
+            'relation-key2': 'relation_value2',
+        }
+
+        charmhelpers.contrib.templating.contexts.juju_state_to_yaml(
+            self.context_path, allow_hyphens_in_keys=False,
+            namespace_separator='__')
+
+        with open(self.context_path, 'r') as context_file:
+            result = yaml.safe_load(context_file.read())
+            expected = self.default_context()
+            expected["private_address"] = "10.1.1.10"
+            expected["wsgi_file__relation_key1"] = "relation_value1"
+            expected["wsgi_file__relation_key2"] = "relation_value2"
+            expected['current_relation'] = {
+                "relation-key1": "relation_value1",
+                "relation-key2": "relation_value2",
+            }
+            self.assertEqual(expected, result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_jinja.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_jinja.py
new file mode 100644
index 0000000000000000000000000000000000000000..00b0d47f257feda8954ff24672dbcc763aa45f41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_jinja.py
@@ -0,0 +1,48 @@
+import tempfile
+import os
+
+from shutil import rmtree
+from testtools import TestCase
+
+from charmhelpers.contrib.templating.jinja import render
+
+
+SIMPLE_TEMPLATE = "{{ somevar }}"
+
+
+LOOP_TEMPLATE = "{% for i in somevar %}{{ i }}{% endfor %}"
+
+
+class Jinja2Test(TestCase):
+
+    def setUp(self):
+        super(Jinja2Test, self).setUp()
+        # Create a "templates directory" in temp
+        self.templates_dir = tempfile.mkdtemp()
+
+    def tearDown(self):
+        super(Jinja2Test, self).tearDown()
+        # Remove the temporary directory so as not to pollute /tmp
+        rmtree(self.templates_dir)
+
+    def _write_template_to_file(self, name, contents):
+        path = os.path.join(self.templates_dir, name)
+        with open(path, "w") as thefile:
+            thefile.write(contents)
+
+    def test_render_simple_template(self):
+        name = "simple"
+        self._write_template_to_file(name, SIMPLE_TEMPLATE)
+        expected = "hello"
+        result = render(
+            name, {"somevar": expected}, template_dir=self.templates_dir)
+        self.assertEqual(expected, result)
+
+    def test_render_loop_template(self):
+        name = "loop"
+        self._write_template_to_file(name, LOOP_TEMPLATE)
+        expected = "12345"
+        result = render(
+            name, {"somevar": ["1", "2", "3", "4", "5"]},
+            template_dir=self.templates_dir)
+        self.assertEqual(expected, result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_pyformat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_pyformat.py
new file mode 100644
index 0000000000000000000000000000000000000000..0873a4ae25672b19101872c2ba98ca9586e37ae2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/templating/test_pyformat.py
@@ -0,0 +1,36 @@
+from mock import patch
+from testtools import TestCase
+
+from charmhelpers.contrib.templating.pyformat import render
+from charmhelpers.core import hookenv
+
+
+class PyFormatTest(TestCase):
+    @patch.object(hookenv, 'execution_environment')
+    def test_renders_using_environment(self, execution_environment):
+        execution_environment.return_value = {
+            'foo': 'FOO',
+        }
+
+        self.assertEqual(render('foo is {foo}'), 'foo is FOO')
+
+    @patch.object(hookenv, 'execution_environment')
+    def test_extra_overrides(self, execution_environment):
+        execution_environment.return_value = {
+            'foo': 'FOO',
+        }
+
+        extra = {'foo': 'BAR'}
+
+        self.assertEqual(render('foo is {foo}', extra=extra), 'foo is BAR')
+
+    @patch.object(hookenv, 'execution_environment')
+    def test_kwargs_overrides(self, execution_environment):
+        execution_environment.return_value = {
+            'foo': 'FOO',
+        }
+
+        extra = {'foo': 'BAR'}
+
+        self.assertEqual(
+            render('foo is {foo}', extra=extra, foo='BAZ'), 'foo is BAZ')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/unison/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/unison/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/unison/test_unison.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/unison/test_unison.py
new file mode 100644
index 0000000000000000000000000000000000000000..a68114c5716be87cb1b1504e6b7850f12644f1f5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/contrib/unison/test_unison.py
@@ -0,0 +1,441 @@
+
+from mock import call, patch, MagicMock, sentinel
+from testtools import TestCase
+
+from tests.helpers import patch_open, FakeRelation
+from charmhelpers.contrib import unison
+
+
+FAKE_RELATION_ENV = {
+    'cluster:0': ['cluster/0', 'cluster/1']
+}
+
+
+TO_PATCH = [
+    'log', 'check_call', 'check_output', 'relation_ids',
+    'related_units', 'relation_get', 'relation_set',
+    'hook_name', 'unit_private_ip',
+]
+
+FAKE_LOCAL_UNIT = 'test_host'
+FAKE_RELATION = {
+    'cluster:0': {
+        'cluster/0': {
+            'private-address': 'cluster0.local',
+            'ssh_authorized_hosts': 'someotherhost:test_host'
+        },
+        'clsuter/1': {
+            'private-address': 'cluster1.local',
+            'ssh_authorized_hosts': 'someotherhost'
+        },
+        'clsuter/3': {
+            'private-address': 'cluster2.local',
+            'ssh_authorized_hosts': 'someotherthirdhost'
+        },
+
+    },
+
+}
+
+
+class UnisonHelperTests(TestCase):
+    def setUp(self):
+        super(UnisonHelperTests, self).setUp()
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+        self.fake_relation = FakeRelation(FAKE_RELATION)
+        self.unit_private_ip.return_value = FAKE_LOCAL_UNIT
+        self.relation_get.side_effect = self.fake_relation.get
+        self.relation_ids.side_effect = self.fake_relation.relation_ids
+        self.related_units.side_effect = self.fake_relation.related_units
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.contrib.unison.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    @patch('pwd.getpwnam')
+    def test_get_homedir(self, pwnam):
+        fake_user = MagicMock()
+        fake_user.pw_dir = '/home/foo'
+        pwnam.return_value = fake_user
+        self.assertEquals(unison.get_homedir('foo'),
+                          '/home/foo')
+
+    @patch('pwd.getpwnam')
+    def test_get_homedir_no_user(self, pwnam):
+        e = KeyError
+        pwnam.side_effect = e
+        self.assertRaises(Exception, unison.get_homedir, user='foo')
+
+    def _ensure_calls_in(self, calls):
+        for _call in calls:
+            self.assertIn(call(_call), self.check_call.call_args_list)
+
+    @patch('os.path.isfile')
+    def test_create_private_key_rsa(self, isfile):
+        create_cmd = [
+            'ssh-keygen', '-q', '-N', '', '-t', 'rsa', '-b', '2048',
+            '-f', '/home/foo/.ssh/id_rsa']
+
+        def _ensure_perms():
+            cmds = [
+                ['chown', 'foo', '/home/foo/.ssh/id_rsa'],
+                ['chmod', '0600', '/home/foo/.ssh/id_rsa'],
+            ]
+            self._ensure_calls_in(cmds)
+
+        isfile.return_value = False
+        unison.create_private_key(
+            user='foo', priv_key_path='/home/foo/.ssh/id_rsa')
+        self.assertIn(call(create_cmd), self.check_call.call_args_list)
+        _ensure_perms()
+        self.check_call.call_args_list = []
+
+        isfile.return_value = True
+        unison.create_private_key(
+            user='foo', priv_key_path='/home/foo/.ssh/id_rsa')
+        self.assertNotIn(call(create_cmd), self.check_call.call_args_list)
+        _ensure_perms()
+
+    @patch('os.path.isfile')
+    def test_create_private_key_ecdsa(self, isfile):
+        create_cmd = [
+            'ssh-keygen', '-q', '-N', '', '-t', 'ecdsa', '-b', '521',
+            '-f', '/home/foo/.ssh/id_ecdsa']
+
+        def _ensure_perms():
+            cmds = [
+                ['chown', 'foo', '/home/foo/.ssh/id_ecdsa'],
+                ['chmod', '0600', '/home/foo/.ssh/id_ecdsa'],
+            ]
+            self._ensure_calls_in(cmds)
+
+        isfile.return_value = False
+        unison.create_private_key(
+            user='foo',
+            priv_key_path='/home/foo/.ssh/id_ecdsa',
+            key_type='ecdsa')
+        self.assertIn(call(create_cmd), self.check_call.call_args_list)
+        _ensure_perms()
+        self.check_call.call_args_list = []
+
+        isfile.return_value = True
+        unison.create_private_key(
+            user='foo',
+            priv_key_path='/home/foo/.ssh/id_ecdsa',
+            key_type='ecdsa')
+        self.assertNotIn(call(create_cmd), self.check_call.call_args_list)
+        _ensure_perms()
+
+    @patch('os.path.isfile')
+    def test_create_public_key(self, isfile):
+        create_cmd = ['ssh-keygen', '-y', '-f', '/home/foo/.ssh/id_rsa']
+        isfile.return_value = True
+        unison.create_public_key(
+            user='foo', priv_key_path='/home/foo/.ssh/id_rsa',
+            pub_key_path='/home/foo/.ssh/id_rsa.pub')
+        self.assertNotIn(call(create_cmd), self.check_output.call_args_list)
+
+        isfile.return_value = False
+        with patch_open() as (_open, _file):
+            self.check_output.return_value = b'fookey'
+            unison.create_public_key(
+                user='foo', priv_key_path='/home/foo/.ssh/id_rsa',
+                pub_key_path='/home/foo/.ssh/id_rsa.pub')
+            self.assertIn(call(create_cmd), self.check_output.call_args_list)
+            _open.assert_called_with('/home/foo/.ssh/id_rsa.pub', 'wb')
+            _file.write.assert_called_with(b'fookey')
+
+    @patch('os.mkdir')
+    @patch('os.path.isdir')
+    @patch.object(unison, 'get_homedir')
+    @patch.multiple(unison, create_private_key=MagicMock(),
+                    create_public_key=MagicMock())
+    def test_get_keypair(self, get_homedir, isdir, mkdir):
+        get_homedir.return_value = '/home/foo'
+        isdir.return_value = False
+        with patch_open() as (_open, _file):
+            _file.read.side_effect = [
+                'foopriv', 'foopub'
+            ]
+            priv, pub = unison.get_keypair('adam')
+            for f in ['/home/foo/.ssh/id_rsa',
+                      '/home/foo/.ssh/id_rsa.pub']:
+                self.assertIn(call(f, 'r'), _open.call_args_list)
+        self.assertEquals(priv, 'foopriv')
+        self.assertEquals(pub, 'foopub')
+
+    @patch.object(unison, 'get_homedir')
+    def test_write_auth_keys(self, get_homedir):
+        get_homedir.return_value = '/home/foo'
+        keys = [
+            'ssh-rsa AAAB3Nz adam',
+            'ssh-rsa ALKJFz adam@whereschuck.org',
+        ]
+        with patch_open() as (_open, _file):
+            unison.write_authorized_keys('foo', keys)
+            _open.assert_called_with('/home/foo/.ssh/authorized_keys', 'w')
+            for k in keys:
+                self.assertIn(call('%s\n' % k), _file.write.call_args_list)
+
+    @patch.object(unison, 'get_homedir')
+    def test_write_known_hosts(self, get_homedir):
+        get_homedir.return_value = '/home/foo'
+        keys = [
+            '10.0.0.1 ssh-rsa KJDSJF=',
+            '10.0.0.2 ssh-rsa KJDSJF=',
+        ]
+        self.check_output.side_effect = keys
+        with patch_open() as (_open, _file):
+            unison.write_known_hosts('foo', ['10.0.0.1', '10.0.0.2'])
+            _open.assert_called_with('/home/foo/.ssh/known_hosts', 'w')
+            for k in keys:
+                self.assertIn(call('%s\n' % k), _file.write.call_args_list)
+
+    @patch.object(unison, 'remove_password_expiry')
+    @patch.object(unison, 'pwgen')
+    @patch.object(unison, 'add_user_to_group')
+    @patch.object(unison, 'adduser')
+    def test_ensure_user(self, adduser, to_group, pwgen,
+                         remove_password_expiry):
+        pwgen.return_value = sentinel.password
+        unison.ensure_user('foo', group='foobar')
+        adduser.assert_called_with('foo', sentinel.password)
+        to_group.assert_called_with('foo', 'foobar')
+        remove_password_expiry.assert_called_with('foo')
+
+    @patch.object(unison, '_run_as_user')
+    def test_run_as_user(self, _run):
+        with patch.object(unison, '_run_as_user') as _run:
+            fake_preexec = MagicMock()
+            _run.return_value = fake_preexec
+            unison.run_as_user('foo', ['echo', 'foo'])
+            self.check_output.assert_called_with(
+                ['echo', 'foo'], preexec_fn=fake_preexec, cwd='/')
+
+    @patch('pwd.getpwnam')
+    def test_run_user_not_found(self, getpwnam):
+        e = KeyError
+        getpwnam.side_effect = e
+        self.assertRaises(Exception, unison._run_as_user, 'nouser')
+
+    @patch('os.setuid')
+    @patch('os.setgid')
+    @patch('os.environ', spec=dict)
+    @patch('pwd.getpwnam')
+    def test_run_as_user_preexec(self, pwnam, environ, setgid, setuid):
+        fake_env = {'HOME': '/root'}
+        environ.__getitem__ = MagicMock()
+        environ.__setitem__ = MagicMock()
+        environ.__setitem__.side_effect = fake_env.__setitem__
+        environ.__getitem__.side_effect = fake_env.__getitem__
+
+        fake_user = MagicMock()
+        fake_user.pw_uid = 1010
+        fake_user.pw_gid = 1011
+        fake_user.pw_dir = '/home/foo'
+        pwnam.return_value = fake_user
+        inner = unison._run_as_user('foo')
+        self.assertEquals(fake_env['HOME'], '/home/foo')
+        inner()
+        setgid.assert_called_with(1011)
+        setuid.assert_called_with(1010)
+
+    @patch('os.setuid')
+    @patch('os.setgid')
+    @patch('os.environ', spec=dict)
+    @patch('pwd.getpwnam')
+    def test_run_as_user_preexec_with_group(self, pwnam, environ, setgid, setuid):
+        fake_env = {'HOME': '/root'}
+        environ.__getitem__ = MagicMock()
+        environ.__setitem__ = MagicMock()
+        environ.__setitem__.side_effect = fake_env.__setitem__
+        environ.__getitem__.side_effect = fake_env.__getitem__
+
+        fake_user = MagicMock()
+        fake_user.pw_uid = 1010
+        fake_user.pw_gid = 1011
+        fake_user.pw_dir = '/home/foo'
+        fake_group_id = 2000
+        pwnam.return_value = fake_user
+        inner = unison._run_as_user('foo', gid=fake_group_id)
+        self.assertEquals(fake_env['HOME'], '/home/foo')
+        inner()
+        setgid.assert_called_with(2000)
+        setuid.assert_called_with(1010)
+
+    @patch.object(unison, 'get_keypair')
+    @patch.object(unison, 'ensure_user')
+    def test_ssh_auth_peer_joined(self, ensure_user, get_keypair):
+        get_keypair.return_value = ('privkey', 'pubkey')
+        self.hook_name.return_value = 'cluster-relation-joined'
+        unison.ssh_authorized_peers(peer_interface='cluster',
+                                    user='foo', group='foo',
+                                    ensure_local_user=True)
+        self.relation_set.assert_called_with(ssh_pub_key='pubkey')
+        self.assertFalse(self.relation_get.called)
+        ensure_user.assert_called_with('foo', 'foo')
+        get_keypair.assert_called_with('foo')
+
+    @patch.object(unison, 'write_known_hosts')
+    @patch.object(unison, 'write_authorized_keys')
+    @patch.object(unison, 'get_keypair')
+    @patch.object(unison, 'ensure_user')
+    def test_ssh_auth_peer_changed(self, ensure_user, get_keypair,
+                                   write_keys, write_hosts):
+        get_keypair.return_value = ('privkey', 'pubkey')
+
+        self.hook_name.return_value = 'cluster-relation-changed'
+
+        self.relation_get.side_effect = [
+            'key1',
+            'host1',
+            'key2',
+            'host2',
+            '', ''
+        ]
+        unison.ssh_authorized_peers(peer_interface='cluster',
+                                    user='foo', group='foo',
+                                    ensure_local_user=True)
+
+        ensure_user.assert_called_with('foo', 'foo')
+        get_keypair.assert_called_with('foo')
+        write_keys.assert_called_with('foo', ['key1', 'key2'])
+        write_hosts.assert_called_with('foo', ['host1', 'host2'])
+        self.relation_set.assert_called_with(ssh_authorized_hosts='host1:host2')
+
+    @patch.object(unison, 'write_known_hosts')
+    @patch.object(unison, 'write_authorized_keys')
+    @patch.object(unison, 'get_keypair')
+    @patch.object(unison, 'ensure_user')
+    def test_ssh_auth_peer_departed(self, ensure_user, get_keypair,
+                                    write_keys, write_hosts):
+        get_keypair.return_value = ('privkey', 'pubkey')
+
+        self.hook_name.return_value = 'cluster-relation-departed'
+
+        self.relation_get.side_effect = [
+            'key1',
+            'host1',
+            'key2',
+            'host2',
+            '', ''
+        ]
+        unison.ssh_authorized_peers(peer_interface='cluster',
+                                    user='foo', group='foo',
+                                    ensure_local_user=True)
+
+        ensure_user.assert_called_with('foo', 'foo')
+        get_keypair.assert_called_with('foo')
+        write_keys.assert_called_with('foo', ['key1', 'key2'])
+        write_hosts.assert_called_with('foo', ['host1', 'host2'])
+        self.relation_set.assert_called_with(ssh_authorized_hosts='host1:host2')
+
+    def test_collect_authed_hosts(self):
+        # only one of the hosts in fake environment has auth'd
+        # the local peer
+        hosts = unison.collect_authed_hosts('cluster')
+        self.assertEquals(hosts, ['cluster0.local'])
+
+    def test_collect_authed_hosts_none_authed(self):
+        with patch.object(unison, 'relation_get') as relation_get:
+            relation_get.return_value = ''
+            hosts = unison.collect_authed_hosts('cluster')
+            self.assertEquals(hosts, [])
+
+    @patch.object(unison, 'run_as_user')
+    def test_sync_path_to_host(self, run_as_user, verbose=True, gid=None):
+        for path in ['/tmp/foo', '/tmp/foo/']:
+            unison.sync_path_to_host(path=path, host='clusterhost1',
+                                     user='foo', verbose=verbose, gid=gid)
+            ex_cmd = ['unison', '-auto', '-batch=true',
+                      '-confirmbigdel=false', '-fastcheck=true',
+                      '-group=false', '-owner=false',
+                      '-prefer=newer', '-times=true']
+            if not verbose:
+                ex_cmd.append('-silent')
+            ex_cmd += ['/tmp/foo', 'ssh://foo@clusterhost1//tmp/foo']
+            run_as_user.assert_called_with('foo', ex_cmd, gid)
+
+    @patch.object(unison, 'run_as_user')
+    def test_sync_path_to_host_error(self, run_as_user):
+        for i, path in enumerate(['/tmp/foo', '/tmp/foo/']):
+            run_as_user.side_effect = Exception
+            if i == 0:
+                unison.sync_path_to_host(path=path, host='clusterhost1',
+                                         user='foo', verbose=True, gid=None)
+            else:
+                self.assertRaises(Exception, unison.sync_path_to_host,
+                                  path=path, host='clusterhost1',
+                                  user='foo', verbose=True, gid=None,
+                                  fatal=True)
+
+            ex_cmd = ['unison', '-auto', '-batch=true',
+                      '-confirmbigdel=false', '-fastcheck=true',
+                      '-group=false', '-owner=false',
+                      '-prefer=newer', '-times=true',
+                      '/tmp/foo', 'ssh://foo@clusterhost1//tmp/foo']
+            run_as_user.assert_called_with('foo', ex_cmd, None)
+
+    def test_sync_path_to_host_non_verbose(self):
+        return self.test_sync_path_to_host(verbose=False)
+
+    def test_sync_path_to_host_with_gid(self):
+        return self.test_sync_path_to_host(gid=111)
+
+    @patch.object(unison, 'sync_path_to_host')
+    def test_sync_to_peer(self, sync_path_to_host):
+        paths = ['/tmp/foo1', '/tmp/foo2']
+        host = 'host1'
+        unison.sync_to_peer(host, 'foouser', paths, True)
+        calls = [call('/tmp/foo1', host, 'foouser', True, None, None, False),
+                 call('/tmp/foo2', host, 'foouser', True, None, None, False)]
+        sync_path_to_host.assert_has_calls(calls)
+
+    @patch.object(unison, 'sync_path_to_host')
+    def test_sync_to_peer_with_gid(self, sync_path_to_host):
+        paths = ['/tmp/foo1', '/tmp/foo2']
+        host = 'host1'
+        unison.sync_to_peer(host, 'foouser', paths, True, gid=111)
+        calls = [call('/tmp/foo1', host, 'foouser', True, None, 111, False),
+                 call('/tmp/foo2', host, 'foouser', True, None, 111, False)]
+        sync_path_to_host.assert_has_calls(calls)
+
+    @patch.object(unison, 'collect_authed_hosts')
+    @patch.object(unison, 'sync_to_peer')
+    def test_sync_to_peers(self, sync_to_peer, collect_hosts):
+        collect_hosts.return_value = ['host1', 'host2', 'host3']
+        paths = ['/tmp/foo']
+        unison.sync_to_peers(peer_interface='cluster', user='foouser',
+                             paths=paths, verbose=True)
+        calls = [call('host1', 'foouser', ['/tmp/foo'], True, None, None, False),
+                 call('host2', 'foouser', ['/tmp/foo'], True, None, None, False),
+                 call('host3', 'foouser', ['/tmp/foo'], True, None, None, False)]
+        sync_to_peer.assert_has_calls(calls)
+
+    @patch.object(unison, 'collect_authed_hosts')
+    @patch.object(unison, 'sync_to_peer')
+    def test_sync_to_peers_with_gid(self, sync_to_peer, collect_hosts):
+        collect_hosts.return_value = ['host1', 'host2', 'host3']
+        paths = ['/tmp/foo']
+        unison.sync_to_peers(peer_interface='cluster', user='foouser',
+                             paths=paths, verbose=True, gid=111)
+        calls = [call('host1', 'foouser', ['/tmp/foo'], True, None, 111, False),
+                 call('host2', 'foouser', ['/tmp/foo'], True, None, 111, False),
+                 call('host3', 'foouser', ['/tmp/foo'], True, None, 111, False)]
+        sync_to_peer.assert_has_calls(calls)
+
+    @patch.object(unison, 'collect_authed_hosts')
+    @patch.object(unison, 'sync_to_peer')
+    def test_sync_to_peers_with_cmd(self, sync_to_peer, collect_hosts):
+        collect_hosts.return_value = ['host1', 'host2', 'host3']
+        paths = ['/tmp/foo']
+        cmd = ['dummy_cmd']
+        unison.sync_to_peers(peer_interface='cluster', user='foouser',
+                             paths=paths, verbose=True, cmd=cmd, gid=111)
+        calls = [call('host1', 'foouser', ['/tmp/foo'], True, cmd, 111, False),
+                 call('host2', 'foouser', ['/tmp/foo'], True, cmd, 111, False),
+                 call('host3', 'foouser', ['/tmp/foo'], True, cmd, 111, False)]
+        sync_to_peer.assert_has_calls(calls)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/coordinator/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/coordinator/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/coordinator/test_coordinator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/coordinator/test_coordinator.py
new file mode 100644
index 0000000000000000000000000000000000000000..a57850a406c434eb9fb2a76336cfc9c9bc2c3eaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/coordinator/test_coordinator.py
@@ -0,0 +1,533 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from datetime import datetime, timedelta
+import json
+import tempfile
+import unittest
+from mock import call, MagicMock, patch, sentinel
+
+from charmhelpers import coordinator
+from charmhelpers.core import hookenv
+
+
+class TestCoordinator(unittest.TestCase):
+
+    def setUp(self):
+        del hookenv._atstart[:]
+        del hookenv._atexit[:]
+        hookenv.cache.clear()
+        coordinator.Singleton._instances.clear()
+
+        def install(patch):
+            patch.start()
+            self.addCleanup(patch.stop)
+
+        install(patch.object(hookenv, 'local_unit', return_value='foo/1'))
+        install(patch.object(hookenv, 'is_leader', return_value=False))
+        install(patch.object(hookenv, 'metadata',
+                             return_value={'peers': {'cluster': None}}))
+        install(patch.object(hookenv, 'log'))
+
+        # Ensure _timestamp always increases.
+        install(patch.object(coordinator, '_utcnow',
+                             side_effect=self._utcnow))
+
+    _last_utcnow = datetime(2015, 1, 1, 00, 00)
+
+    def _utcnow(self, ts=coordinator._timestamp):
+        self._last_utcnow += timedelta(minutes=1)
+        return self._last_utcnow
+
+    def test_is_singleton(self):
+        # BaseCoordinator and subclasses are singletons. Placing this
+        # burden on charm authors is impractical, particularly if
+        # libraries start wanting to use coordinator instances.
+        # With singletons, we don't need to worry about sharing state
+        # between instances or have them stomping on each other when they
+        # need to serialize their state.
+        self.assertTrue(coordinator.BaseCoordinator()
+                        is coordinator.BaseCoordinator())
+        self.assertTrue(coordinator.Serial() is coordinator.Serial())
+        self.assertFalse(coordinator.BaseCoordinator() is coordinator.Serial())
+
+    @patch.object(hookenv, 'atstart')
+    def test_implicit_initialize_and_handle(self, atstart):
+        # When you construct a BaseCoordinator(), its initialize() and
+        # handle() method are invoked automatically every hook. This
+        # is done using hookenv.atstart
+        c = coordinator.BaseCoordinator()
+        atstart.assert_has_calls([call(c.initialize), call(c.handle)])
+
+    @patch.object(hookenv, 'has_juju_version', return_value=False)
+    def test_initialize_enforces_juju_version(self, has_juju_version):
+        c = coordinator.BaseCoordinator()
+        with self.assertRaises(AssertionError):
+            c.initialize()
+        has_juju_version.assert_called_once_with('1.23')
+
+    @patch.object(hookenv, 'atexit')
+    @patch.object(hookenv, 'has_juju_version', return_value=True)
+    @patch.object(hookenv, 'relation_ids')
+    def test_initialize(self, relation_ids, ver, atexit):
+        # First initialization are done before there is a peer relation.
+        relation_ids.return_value = []
+        c = coordinator.BaseCoordinator()
+
+        with patch.object(c, '_load_state') as _load_state, \
+                patch.object(c, '_emit_state') as _emit_state:  # IGNORE: E127
+            c.initialize()
+            _load_state.assert_called_once_with()
+            _emit_state.assert_called_once_with()
+
+        self.assertEqual(c.relname, 'cluster')
+        self.assertIsNone(c.relid)
+        relation_ids.assert_called_once_with('cluster')
+
+        # Methods installed to save state and release locks if the
+        # hook is successful.
+        atexit.assert_has_calls([call(c._save_state),
+                                 call(c._release_granted)])
+
+        # If we have a peer relation, the id is stored.
+        relation_ids.return_value = ['cluster:1']
+        c = coordinator.BaseCoordinator()
+        with patch.object(c, '_load_state'), patch.object(c, '_emit_state'):
+            c.initialize()
+        self.assertEqual(c.relid, 'cluster:1')
+
+        # If we are already initialized, nothing happens.
+        c.grants = {}
+        c.requests = {}
+        c.initialize()
+
+    def test_acquire(self):
+        c = coordinator.BaseCoordinator()
+        lock = 'mylock'
+        c.grants = {}
+        c.requests = {hookenv.local_unit(): {}}
+
+        # We are not the leader, so first acquire will return False.
+        self.assertFalse(c.acquire(lock))
+
+        # But the request is in the queue.
+        self.assertTrue(c.requested(lock))
+        ts = c.request_timestamp(lock)
+
+        # A further attempts at acquiring the lock do nothing,
+        # and the timestamp of the request remains unchanged.
+        self.assertFalse(c.acquire(lock))
+        self.assertEqual(ts, c.request_timestamp(lock))
+
+        # Once the leader has granted the lock, acquire returns True.
+        with patch.object(c, 'granted') as granted:
+            granted.return_value = True
+            self.assertTrue(c.acquire(lock))
+            granted.assert_called_once_with(lock)
+
+    def test_acquire_leader(self):
+        # When acquire() is called by the leader, it needs
+        # to make a grant decision immediately. It can't defer
+        # making the decision until a future hook, as no future
+        # hooks will be triggered.
+        hookenv.is_leader.return_value = True
+        c = coordinator.Serial()  # Not Base. Test hooks into default_grant.
+        lock = 'mylock'
+        unit = hookenv.local_unit()
+        c.grants = {}
+        c.requests = {unit: {}}
+        with patch.object(c, 'default_grant') as default_grant:
+            default_grant.side_effect = iter([False, True])
+
+            self.assertFalse(c.acquire(lock))
+            ts = c.request_timestamp(lock)
+
+            self.assertTrue(c.acquire(lock))
+            self.assertEqual(ts, c.request_timestamp(lock))
+
+            # If it it granted, the leader doesn't make a decision again.
+            self.assertTrue(c.acquire(lock))
+            self.assertEqual(ts, c.request_timestamp(lock))
+
+            self.assertEqual(default_grant.call_count, 2)
+
+    def test_granted(self):
+        c = coordinator.BaseCoordinator()
+        unit = hookenv.local_unit()
+        lock = 'mylock'
+        ts = coordinator._timestamp()
+        c.grants = {}
+
+        # Unit makes a request, but it isn't granted
+        c.requests = {unit: {lock: ts}}
+        self.assertFalse(c.granted(lock))
+
+        # Once the leader has granted the request, all good.
+        # It does this by mirroring the request timestamp.
+        c.grants = {unit: {lock: ts}}
+        self.assertTrue(c.granted(lock))
+
+        # The unit releases the lock by removing the request.
+        c.requests = {unit: {}}
+        self.assertFalse(c.granted(lock))
+
+        # If the unit makes a new request before the leader
+        # has had a chance to do its housekeeping, the timestamps
+        # do not match and the lock not considered granted.
+        ts = coordinator._timestamp()
+        c.requests = {unit: {lock: ts}}
+        self.assertFalse(c.granted(lock))
+
+        # Until the leader gets around to its duties.
+        c.grants = {unit: {lock: ts}}
+        self.assertTrue(c.granted(lock))
+
+    def test_requested(self):
+        c = coordinator.BaseCoordinator()
+        lock = 'mylock'
+        c.requests = {hookenv.local_unit(): {}}
+        c.grants = {}
+
+        self.assertFalse(c.requested(lock))
+        c.acquire(lock)
+        self.assertTrue(c.requested(lock))
+
+    def test_request_timestamp(self):
+        c = coordinator.BaseCoordinator()
+        lock = 'mylock'
+        unit = hookenv.local_unit()
+
+        c.requests = {unit: {}}
+        c.grants = {}
+        self.assertIsNone(c.request_timestamp(lock))
+
+        now = datetime.utcnow()
+        fmt = coordinator._timestamp_format
+        c.requests = {hookenv.local_unit(): {lock: now.strftime(fmt)}}
+
+        self.assertEqual(c.request_timestamp(lock), now)
+
+    def test_handle_not_leader(self):
+        c = coordinator.BaseCoordinator()
+        # If we are not the leader, handle does nothing. We know this,
+        # because without mocks or initialization it would otherwise crash.
+        c.handle()
+
+    def test_handle(self):
+        hookenv.is_leader.return_value = True
+        lock = 'mylock'
+        c = coordinator.BaseCoordinator()
+        c.relid = 'cluster:1'
+
+        ts = coordinator._timestamp
+        ts1, ts2, ts3 = ts(), ts(), ts()
+
+        # Grant one of these requests.
+        requests = {'foo/1': {lock: ts1},
+                    'foo/2': {lock: ts2},
+                    'foo/3': {lock: ts3}}
+        c.requests = requests.copy()
+        # Because the existing grant should be released.
+        c.grants = {'foo/2': {lock: ts()}}  # No request, release.
+
+        with patch.object(c, 'grant') as grant:
+            c.handle()
+
+            # The requests are unchanged. This is normally state on the
+            # peer relation, and only the units themselves can change it.
+            self.assertDictEqual(requests, c.requests)
+
+            # The grant without a corresponding requests was released.
+            self.assertDictEqual({'foo/2': {}}, c.grants)
+
+            # A potential grant was made for each of the outstanding requests.
+            grant.assert_has_calls([call(lock, 'foo/1'),
+                                    call(lock, 'foo/2'),
+                                    call(lock, 'foo/3')], any_order=True)
+
+    def test_grant_not_leader(self):
+        c = coordinator.BaseCoordinator()
+        c.grant(sentinel.whatever, sentinel.whatever)  # Nothing happens.
+
+    def test_grant(self):
+        hookenv.is_leader.return_value = True
+        c = coordinator.BaseCoordinator()
+        c.default_grant = MagicMock()
+        c.grant_other = MagicMock()
+
+        ts = coordinator._timestamp
+        ts1, ts2 = ts(), ts()
+
+        c.requests = {'foo/1': {'mylock': ts1, 'other': ts()},
+                      'foo/2': {'mylock': ts2},
+                      'foo/3': {'mylock': ts()}}
+        grants = {'foo/1': {'mylock': ts1}}
+        c.grants = grants.copy()
+
+        # foo/1 already has a granted mylock, so returns True.
+        self.assertTrue(c.grant('mylock', 'foo/1'))
+
+        # foo/2 does not have a granted mylock. default_grant will
+        # be called to make a decision (no)
+        c.default_grant.return_value = False
+        self.assertFalse(c.grant('mylock', 'foo/2'))
+        self.assertDictEqual(grants, c.grants)
+        c.default_grant.assert_called_once_with('mylock', 'foo/2',
+                                                set(['foo/1']),
+                                                ['foo/2', 'foo/3'])
+        c.default_grant.reset_mock()
+
+        # Lets say yes.
+        c.default_grant.return_value = True
+        self.assertTrue(c.grant('mylock', 'foo/2'))
+        grants = {'foo/1': {'mylock': ts1}, 'foo/2': {'mylock': ts2}}
+        self.assertDictEqual(grants, c.grants)
+        c.default_grant.assert_called_once_with('mylock', 'foo/2',
+                                                set(['foo/1']),
+                                                ['foo/2', 'foo/3'])
+
+        # The other lock has custom logic, in the form of the overridden
+        # grant_other method.
+        c.grant_other.return_value = False
+        self.assertFalse(c.grant('other', 'foo/1'))
+        c.grant_other.assert_called_once_with('other', 'foo/1',
+                                              set(), ['foo/1'])
+
+        # If there is no request, grant returns False
+        c.grant_other.return_value = True
+        self.assertFalse(c.grant('other', 'foo/2'))
+
+    def test_released(self):
+        c = coordinator.BaseCoordinator()
+        with patch.object(c, 'msg') as msg:
+            c.released('foo/2', 'mylock', coordinator._utcnow())
+            expected = 'Leader released mylock from foo/2, held 0:01:00'
+            msg.assert_called_once_with(expected)
+
+    def test_require(self):
+        c = coordinator.BaseCoordinator()
+        c.acquire = MagicMock()
+        c.granted = MagicMock()
+        guard = MagicMock()
+
+        wrapped = MagicMock()
+
+        @c.require('mylock', guard)
+        def func(*args, **kw):
+            wrapped(*args, **kw)
+
+        # If the lock is granted, the wrapped function is called.
+        c.granted.return_value = True
+        func(arg=True)
+        wrapped.assert_called_once_with(arg=True)
+        wrapped.reset_mock()
+
+        # If the lock is not granted, and the guard returns False,
+        # the lock is not acquired.
+        c.acquire.return_value = False
+        c.granted.return_value = False
+        guard.return_value = False
+        func()
+        self.assertFalse(wrapped.called)
+        self.assertFalse(c.acquire.called)
+
+        # If the lock is not granted, and the guard returns True,
+        # the lock is acquired. But the function still isn't called if
+        # it cannot be acquired immediately.
+        guard.return_value = True
+        func()
+        self.assertFalse(wrapped.called)
+        c.acquire.assert_called_once_with('mylock')
+
+        # Finally, if the lock is not granted, and the guard returns True,
+        # and the lock acquired immediately, the function is called.
+        c.acquire.return_value = True
+        func(sentinel.arg)
+        wrapped.assert_called_once_with(sentinel.arg)
+
+    def test_msg(self):
+        c = coordinator.BaseCoordinator()
+        # Just a wrapper around hookenv.log
+        c.msg('hi')
+        hookenv.log.assert_called_once_with('coordinator.BaseCoordinator hi',
+                                            level=hookenv.INFO)
+
+    def test_name(self):
+        # We use the class name in a few places to avoid conflicts.
+        # We assume we won't be using multiple BaseCoordinator subclasses
+        # with the same name at the same time.
+        c = coordinator.BaseCoordinator()
+        self.assertEqual(c._name(), 'BaseCoordinator')
+        c = coordinator.Serial()
+        self.assertEqual(c._name(), 'Serial')
+
+    @patch.object(hookenv, 'leader_get')
+    def test_load_state(self, leader_get):
+        c = coordinator.BaseCoordinator()
+        unit = hookenv.local_unit()
+
+        # c.granted is just the leader_get decoded.
+        leader_get.return_value = '{"json": true}'
+        c._load_state()
+        self.assertDictEqual(c.grants, {'json': True})
+
+        # With no relid, there is no peer relation so request state
+        # is pulled from a local stash.
+        with patch.object(c, '_load_local_state') as loc_state:
+            loc_state.return_value = {'local': True}
+            c._load_state()
+            self.assertDictEqual(c.requests, {unit: {'local': True}})
+
+        # With a relid, request details are pulled from the peer relation.
+        # If there is no data in the peer relation from the local unit,
+        # we still pull it from the local stash as it means this is the
+        # first time we have joined.
+        c.relid = 'cluster:1'
+        with patch.object(c, '_load_local_state') as loc_state, \
+                patch.object(c, '_load_peer_state') as peer_state:
+            loc_state.return_value = {'local': True}
+            peer_state.return_value = {'foo/2': {'mylock': 'whatever'}}
+            c._load_state()
+            self.assertDictEqual(c.requests, {unit: {'local': True},
+                                              'foo/2': {'mylock': 'whatever'}})
+
+        # If there are local details in the peer relation, the local
+        # stash is ignored.
+        with patch.object(c, '_load_local_state') as loc_state, \
+                patch.object(c, '_load_peer_state') as peer_state:
+            loc_state.return_value = {'local': True}
+            peer_state.return_value = {unit: {},
+                                       'foo/2': {'mylock': 'whatever'}}
+            c._load_state()
+            self.assertDictEqual(c.requests, {unit: {},
+                                              'foo/2': {'mylock': 'whatever'}})
+
+    def test_emit_state(self):
+        c = coordinator.BaseCoordinator()
+        unit = hookenv.local_unit()
+        c.requests = {unit: {'lock_a': sentinel.ts,
+                             'lock_b': sentinel.ts,
+                             'lock_c': sentinel.ts}}
+        c.grants = {unit: {'lock_a': sentinel.ts,
+                           'lock_b': sentinel.ts2}}
+        with patch.object(c, 'msg') as msg:
+            c._emit_state()
+            msg.assert_has_calls([call('Granted lock_a'),
+                                  call('Waiting on lock_b'),
+                                  call('Waiting on lock_c')],
+                                 any_order=True)
+
+    @patch.object(hookenv, 'relation_set')
+    @patch.object(hookenv, 'leader_set')
+    def test_save_state(self, leader_set, relation_set):
+        c = coordinator.BaseCoordinator()
+        unit = hookenv.local_unit()
+        c.grants = {'directdump': True}
+        c.requests = {unit: 'data1', 'foo/2': 'data2'}
+
+        # grants is dumped to leadership settings, if the unit is leader.
+        with patch.object(c, '_save_local_state') as save_loc:
+            c._save_state()
+            self.assertFalse(leader_set.called)
+            hookenv.is_leader.return_value = True
+            c._save_state()
+            leader_set.assert_called_once_with({c.key: '{"directdump": true}'})
+
+        # If there is no relation id, the local units requests is dumped
+        # to a local stash.
+        with patch.object(c, '_save_local_state') as save_loc:
+            c._save_state()
+            save_loc.assert_called_once_with('data1')
+
+        # If there is a relation id, the local units requests is dumped
+        # to the peer relation.
+        with patch.object(c, '_save_local_state') as save_loc:
+            c.relid = 'cluster:1'
+            c._save_state()
+            self.assertFalse(save_loc.called)
+            relation_set.assert_called_once_with(
+                c.relid, relation_settings={c.key: '"data1"'})  # JSON encoded
+
+    @patch.object(hookenv, 'relation_get')
+    @patch.object(hookenv, 'related_units')
+    def test_load_peer_state(self, related_units, relation_get):
+        # Standard relation-get loops, decoding results from JSON.
+        c = coordinator.BaseCoordinator()
+        c.key = sentinel.key
+        c.relid = sentinel.relid
+        related_units.return_value = ['foo/2', 'foo/3']
+        d = {'foo/1': {'foo/1': True},
+             'foo/2': {'foo/2': True},
+             'foo/3': {'foo/3': True}}
+
+        def _get(key, unit, relid):
+            assert key == sentinel.key
+            assert relid == sentinel.relid
+            return json.dumps(d[unit])
+        relation_get.side_effect = _get
+
+        self.assertDictEqual(c._load_peer_state(), d)
+
+    def test_local_state_filename(self):
+        c = coordinator.BaseCoordinator()
+        self.assertEqual(c._local_state_filename(),
+                         '.charmhelpers.coordinator.BaseCoordinator')
+
+    def test_load_local_state(self):
+        c = coordinator.BaseCoordinator()
+        with tempfile.NamedTemporaryFile(mode='w') as f:
+            with patch.object(c, '_local_state_filename') as fn:
+                fn.return_value = f.name
+                d = 'some data'
+                json.dump(d, f)
+                f.flush()
+                d2 = c._load_local_state()
+                self.assertEqual(d, d2)
+
+    def test_save_local_state(self):
+        c = coordinator.BaseCoordinator()
+        with tempfile.NamedTemporaryFile(mode='r') as f:
+            with patch.object(c, '_local_state_filename') as fn:
+                fn.return_value = f.name
+                c._save_local_state('some data')
+                self.assertEqual(json.load(f), 'some data')
+
+    def test_release_granted(self):
+        c = coordinator.BaseCoordinator()
+        unit = hookenv.local_unit()
+        c.requests = {unit: {'lock1': sentinel.ts, 'lock2': sentinel.ts},
+                      'foo/2': {'lock1': sentinel.ts}}
+        c.grants = {unit: {'lock1': sentinel.ts},
+                    'foo/2': {'lock1': sentinel.ts}}
+        # The granted lock for the local unit is released.
+        c._release_granted()
+        self.assertDictEqual(c.requests, {unit: {'lock2': sentinel.ts},
+                                          'foo/2': {'lock1': sentinel.ts}})
+
+    def test_implicit_peer_relation_name(self):
+        self.assertEqual(coordinator._implicit_peer_relation_name(),
+                         'cluster')
+
+    def test_default_grant(self):
+        c = coordinator.Serial()
+        # Lock not granted. First in the queue.
+        self.assertTrue(c.default_grant(sentinel.lock, sentinel.u1,
+                                        set(), [sentinel.u1, sentinel.u2]))
+
+        # Lock not granted. Later in the queue.
+        self.assertFalse(c.default_grant(sentinel.lock, sentinel.u1,
+                                         set(), [sentinel.u2, sentinel.u1]))
+
+        # Lock already granted
+        self.assertFalse(c.default_grant(sentinel.lock, sentinel.u1,
+                                         set([sentinel.u2]), [sentinel.u1]))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/cloud_controller_ng.yml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/cloud_controller_ng.yml
new file mode 100644
index 0000000000000000000000000000000000000000..7f72f899dc890e3604e7bac51659ad09915c6c6c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/cloud_controller_ng.yml
@@ -0,0 +1,173 @@
+---
+# TODO cc_ip cc public ip 
+local_route: {{ domain }}
+port: {{ cc_port }}
+pid_filename: /var/vcap/sys/run/cloud_controller_ng/cloud_controller_ng.pid
+development_mode: false
+
+message_bus_servers:
+  - nats://{{ nats['user'] }}:{{ nats['password'] }}@{{ nats['address'] }}:{{ nats['port'] }}
+
+external_domain:
+  - api.{{ domain }}
+
+system_domain_organization: {{ default_organization }}
+system_domain: {{ domain }}
+app_domains: [ {{ domain }} ]
+srv_api_uri: http://api.{{ domain }}
+
+default_app_memory: 1024
+
+cc_partition: default
+
+bootstrap_admin_email: admin@{{ default_organization }}
+
+bulk_api:
+  auth_user: bulk_api
+  auth_password: "Password"
+
+nginx:
+  use_nginx: false
+  instance_socket: "/var/vcap/sys/run/cloud_controller_ng/cloud_controller.sock"
+
+index: 1
+name: cloud_controller_ng
+
+info:
+  name: vcap
+  build: "2222"
+  version: 2
+  support_address: http://support.cloudfoundry.com
+  description: Cloud Foundry sponsored by Pivotal
+  api_version: 2.0.0
+
+
+directories:
+ tmpdir: /var/vcap/data/cloud_controller_ng/tmp
+
+
+logging:
+  file: /var/vcap/sys/log/cloud_controller_ng/cloud_controller_ng.log
+
+  syslog: vcap.cloud_controller_ng
+
+  level: debug2
+  max_retries: 1
+
+
+
+
+
+db: &db
+  database: sqlite:///var/lib/cloudfoundry/cfcloudcontroller/db/cc.db
+  max_connections: 25
+  pool_timeout: 10
+  log_level: debug2
+
+
+login:
+  url: http://uaa.{{ domain }}
+
+uaa:
+  url: http://uaa.{{ domain }}
+  resource_id: cloud_controller
+  #symmetric_secret: cc-secret
+  verification_key: |
+    -----BEGIN PUBLIC KEY-----
+    MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDHFr+KICms+tuT1OXJwhCUmR2d
+    KVy7psa8xzElSyzqx7oJyfJ1JZyOzToj9T5SfTIq396agbHJWVfYphNahvZ/7uMX
+    qHxf+ZH9BL1gk9Y6kCnbM5R60gfwjyW1/dQPjOzn9N394zd2FJoFHwdq9Qs0wBug
+    spULZVNRxq7veq/fzwIDAQAB
+    -----END PUBLIC KEY-----
+
+# App staging parameters
+staging:
+  max_staging_runtime: 900
+  auth:
+    user:
+    password: "Password"
+
+maximum_health_check_timeout: 180
+
+runtimes_file: /var/lib/cloudfoundry/cfcloudcontroller/jobs/config/runtimes.yml
+stacks_file: /var/lib/cloudfoundry/cfcloudcontroller/jobs/config/stacks.yml
+
+quota_definitions:
+  free:
+    non_basic_services_allowed: false
+    total_services: 2
+    total_routes: 1000
+    memory_limit: 1024
+  paid:
+    non_basic_services_allowed: true
+    total_services: 32
+    total_routes: 1000
+    memory_limit: 204800
+  runaway:
+    non_basic_services_allowed: true
+    total_services: 500
+    total_routes: 1000
+    memory_limit: 204800
+  trial:
+    non_basic_services_allowed: false
+    total_services: 10
+    memory_limit: 2048
+    total_routes: 1000
+    trial_db_allowed: true
+
+default_quota_definition: free
+
+resource_pool:
+  minimum_size: 65536
+  maximum_size: 536870912
+  resource_directory_key: cc-resources
+
+  cdn:
+    uri:
+    key_pair_id:
+    private_key: ""
+
+  fog_connection: {"provider":"Local","local_root":"/var/vcap/nfs/store"}
+
+packages:
+  app_package_directory_key: cc-packages
+
+  cdn:
+    uri:
+    key_pair_id:
+    private_key: ""
+
+  fog_connection: {"provider":"Local","local_root":"/var/vcap/nfs/store"}
+
+droplets:
+  droplet_directory_key: cc-droplets
+
+  cdn:
+    uri:
+    key_pair_id:
+    private_key: ""
+
+  fog_connection: {"provider":"Local","local_root":"/var/vcap/nfs/store"}
+
+buildpacks:
+  buildpack_directory_key: cc-buildpacks
+
+  cdn:
+    uri:
+    key_pair_id:
+    private_key: ""
+
+  fog_connection: {"provider":"Local","local_root":"/var/vcap/nfs/store"}
+
+db_encryption_key: Password
+
+trial_db:
+  guid: "78ad16cf-3c22-4427-a982-b9d35d746914"
+
+tasks_disabled: false
+hm9000_noop: true
+flapping_crash_count_threshold: 3
+
+disable_custom_buildpacks: false
+
+broker_client_timeout_seconds: 60
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/fake_cc.yml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/fake_cc.yml
new file mode 100644
index 0000000000000000000000000000000000000000..5e3f8b6cd17d1c0426c8d3ae11265da881796104
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/fake_cc.yml
@@ -0,0 +1,3 @@
+host: {{nats['host']}}
+port: {{nats['port']}}
+domain: {{router['domain']}}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/nginx.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/nginx.conf
new file mode 100644
index 0000000000000000000000000000000000000000..95e02bf3c85564e768e810e86995deb1a3bc359a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/nginx.conf
@@ -0,0 +1,154 @@
+# deployment cloudcontroller nginx.conf
+#user  vcap vcap;
+
+error_log /var/vcap/sys/log/nginx_ccng/nginx.error.log;
+pid       /var/vcap/sys/run/nginx_ccng/nginx.pid;
+
+events {
+  worker_connections  8192;
+  use epoll;
+}
+
+http {
+  include       mime.types;
+  default_type  text/html;
+  server_tokens off;
+  variables_hash_max_size 1024;
+
+  log_format main  '$host - [$time_local] '
+                   '"$request" $status $bytes_sent '
+                   '"$http_referer" "$http_#user_agent" '
+                   '$proxy_add_x_forwarded_for response_time:$upstream_response_time';
+
+  access_log  /var/vcap/sys/log/nginx_ccng/nginx.access.log  main;
+
+  sendfile             on;  #enable use of sendfile()
+  tcp_nopush           on;
+  tcp_nodelay          on;  #disable nagel's algorithm
+
+  keepalive_timeout  75 20; #inherited from router
+
+  client_max_body_size 256M; #already enforced upstream/but doesn't hurt.
+
+  upstream cloud_controller {
+    server unix:/var/vcap/sys/run/cloud_controller_ng/cloud_controller.sock;
+  }
+
+  server {
+    listen    {{ nginx_port }};
+    server_name  _;
+    server_name_in_redirect off;
+    proxy_send_timeout          300;
+    proxy_read_timeout          300;
+
+    # proxy and log all CC traffic
+    location / {
+      access_log /var/vcap/sys/log/nginx_ccng/nginx.access.log  main;
+      proxy_buffering             off;
+      proxy_set_header            Host $host;
+      proxy_set_header            X-Real_IP $remote_addr;
+      proxy_set_header            X-Forwarded-For $proxy_add_x_forwarded_for;
+      proxy_redirect              off;
+      proxy_connect_timeout       10;
+      proxy_pass                 http://cloud_controller;
+    }
+
+
+    # used for x-accel-redirect uri://location/foo.txt
+    # nginx will serve the file root || location || foo.txt
+    location /droplets/ {
+      internal;
+      root   /var/vcap/nfs/store;
+    }
+
+
+
+    # used for x-accel-redirect uri://location/foo.txt
+    # nginx will serve the file root || location || foo.txt
+    location /cc-packages/ {
+      internal;
+      root   /var/vcap/nfs/store;
+    }
+
+
+    # used for x-accel-redirect uri://location/foo.txt
+    # nginx will serve the file root || location || foo.txt
+    location /cc-droplets/ {
+      internal;
+      root   /var/vcap/nfs/store;
+    }
+
+
+    location ~ (/apps/.*/application|/v2/apps/.*/bits|/services/v\d+/configurations/.*/serialized/data|/v2/buildpacks/.*/bits) {
+      # Pass altered request body to this location
+      upload_pass   @cc_uploads;
+      upload_pass_args on;
+
+      # Store files to this directory
+      upload_store /var/vcap/data/cloud_controller_ng/tmp/uploads;
+
+      # No limit for output body forwarded to CC
+      upload_max_output_body_len 0;
+
+      # Allow uploaded files to be read only by #user
+      #upload_store_access #user:r;
+
+      # Set specified fields in request body
+      upload_set_form_field "${upload_field_name}_name" $upload_file_name;
+      upload_set_form_field "${upload_field_name}_path" $upload_tmp_path;
+
+      #forward the following fields from existing body
+      upload_pass_form_field "^resources$";
+      upload_pass_form_field "^_method$";
+
+      #on any error, delete uploaded files.
+      upload_cleanup 400-505;
+    }
+
+    location ~ /staging/(buildpack_cache|droplets)/.*/upload {
+
+      # Allow download the droplets and buildpacks
+      if ($request_method = GET){
+        proxy_pass http://cloud_controller;
+      }
+
+      # Pass along auth header
+      set $auth_header $upstream_http_x_auth;
+      proxy_set_header Authorization $auth_header;
+
+      # Pass altered request body to this location
+      upload_pass   @cc_uploads;
+
+      # Store files to this directory
+      upload_store /var/vcap/data/cloud_controller_ng/tmp/staged_droplet_uploads;
+
+      # Allow uploaded files to be read only by #user
+      upload_store_access user:r;
+
+      # Set specified fields in request body
+      upload_set_form_field "droplet_path" $upload_tmp_path;
+
+      #on any error, delete uploaded files.
+      upload_cleanup 400-505;
+    }
+
+    # Pass altered request body to a backend
+    location @cc_uploads {
+      proxy_pass http://unix:/var/vcap/sys/run/cloud_controller_ng/cloud_controller.sock;
+    }
+
+    location ~ ^/internal_redirect/(.*){
+      # only allow internal redirects
+      internal;
+
+      set $download_url $1;
+
+      #have to manualy pass along auth header
+      set $auth_header $upstream_http_x_auth;
+      proxy_set_header Authorization $auth_header;
+
+      # Download the file and send it to client
+      proxy_pass $download_url;
+    }
+  }
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/test.conf b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/test.conf
new file mode 100644
index 0000000000000000000000000000000000000000..bb02adc4a09a2dc7810351bf90a84f6a01d2ee4b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/templates/test.conf
@@ -0,0 +1,3 @@
+something
+listen {{nginx_port}}
+something else
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_files.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_files.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b443a23d0bad1515f874e69734880932193778a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_files.py
@@ -0,0 +1,32 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from charmhelpers.core import files
+
+import mock
+import unittest
+import tempfile
+import os
+
+
+class FileTests(unittest.TestCase):
+
+    @mock.patch("subprocess.check_call")
+    def test_sed(self, check_call):
+        files.sed("/tmp/test-sed-file", "replace", "this")
+        check_call.assert_called_once_with(
+            ['sed', '-i', '-r', '-e', 's/replace/this/g',
+             '/tmp/test-sed-file']
+        )
+
+    def test_sed_file(self):
+        tmp = tempfile.NamedTemporaryFile(mode='w', delete=False)
+        tmp.write("IPV6=yes")
+        tmp.close()
+
+        files.sed(tmp.name, "IPV6=.*", "IPV6=no")
+
+        with open(tmp.name) as tmp:
+            self.assertEquals(tmp.read(), "IPV6=no")
+
+        os.unlink(tmp.name)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_fstab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_fstab.py
new file mode 100644
index 0000000000000000000000000000000000000000..c25844866926586e9caefcfb43b30e92ec9edf39
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_fstab.py
@@ -0,0 +1,93 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from charmhelpers.core.fstab import Fstab
+from nose.tools import (assert_is,
+                        assert_is_not,
+                        assert_equal)
+import unittest
+import tempfile
+import os
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+DEFAULT_FSTAB_FILE = """/dev/sda /mnt/sda ext3 defaults 0 0
+ # This is an indented comment, and the next line is entirely blank.
+
+/dev/sdb /mnt/sdb ext3 defaults 0 0
+/dev/sdc	/mnt/sdc	ext3	defaults	0	0
+UUID=3af44368-c50b-4768-8e58-aff003cef8be / ext4 errors=remount-ro 0 1
+"""
+
+GENERATED_FSTAB_FILE = '\n'.join(
+    # Helper will writeback with spaces instead of tabs
+    line.replace('\t', ' ') for line in DEFAULT_FSTAB_FILE.splitlines()
+    if line.strip() and not line.strip().startswith('#'))
+
+
+class FstabTest(unittest.TestCase):
+
+    def setUp(self):
+        self.tempfile = tempfile.NamedTemporaryFile('w+', delete=False)
+        self.tempfile.write(DEFAULT_FSTAB_FILE)
+        self.tempfile.close()
+        self.fstab = Fstab(path=self.tempfile.name)
+
+    def tearDown(self):
+        os.unlink(self.tempfile.name)
+
+    def test_entries(self):
+        """Test if entries are correctly readed from fstab file"""
+        assert_equal(sorted(GENERATED_FSTAB_FILE.splitlines()),
+                     sorted(str(entry) for entry in self.fstab.entries))
+
+    def test_get_entry_by_device_attr(self):
+        """Test if the get_entry_by_attr method works for device attr"""
+        for device in ('sda', 'sdb', 'sdc', ):
+            assert_is_not(self.fstab.get_entry_by_attr('device',
+                                                       '/dev/%s' % device),
+                          None)
+
+    def test_get_entry_by_mountpoint_attr(self):
+        """Test if the get_entry_by_attr method works for mountpoint attr"""
+        for mnt in ('sda', 'sdb', 'sdc', ):
+            assert_is_not(self.fstab.get_entry_by_attr('mountpoint',
+                                                       '/mnt/%s' % mnt), None)
+
+    def test_add_entry(self):
+        """Test if add_entry works for a new entry"""
+        for device in ('sdf', 'sdg', 'sdh'):
+            entry = Fstab.Entry('/dev/%s' % device, '/mnt/%s' % device, 'ext3',
+                                None)
+            assert_is_not(self.fstab.add_entry(entry), None)
+            assert_is_not(self.fstab.get_entry_by_attr(
+                'device', '/dev/%s' % device), None)
+
+        assert_is(self.fstab.add_entry(entry), False,
+                  "Check if adding an existing entry returns false")
+
+    def test_remove_entry(self):
+        """Test if remove entry works for already existing entries"""
+        for entry in self.fstab.entries:
+            assert_is(self.fstab.remove_entry(entry), True)
+
+        assert_equal(len([entry for entry in self.fstab.entries]), 0)
+        assert_equal(self.fstab.add_entry(entry), entry)
+        assert_equal(len([entry for entry in self.fstab.entries]), 1)
+
+    def test_assert_remove_add_all(self):
+        """Test if removing/adding all the entries works"""
+        for entry in self.fstab.entries:
+            assert_is(self.fstab.remove_entry(entry), True)
+
+        for device in ('sda', 'sdb', 'sdc', ):
+            self.fstab.add_entry(
+                Fstab.Entry('/dev/%s' % device, '/mnt/%s' % device, 'ext3',
+                            None))
+
+        self.fstab.add_entry(Fstab.Entry(
+            'UUID=3af44368-c50b-4768-8e58-aff003cef8be',
+            '/', 'ext4', 'errors=remount-ro', 0, 1))
+
+        assert_equal(sorted(GENERATED_FSTAB_FILE.splitlines()),
+                     sorted(str(entry) for entry in self.fstab.entries))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hookenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hookenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d83a7a946011584b373e7a0816dbbbe5434f5a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hookenv.py
@@ -0,0 +1,2378 @@
+import os
+import json
+from subprocess import CalledProcessError
+import shutil
+import tempfile
+import types
+from mock import call, MagicMock, mock_open, patch, sentinel
+from testtools import TestCase
+from enum import Enum
+import yaml
+
+import six
+import io
+
+from charmhelpers.core import hookenv
+
+if six.PY3:
+    import pickle
+else:
+    import cPickle as pickle
+
+
+CHARM_METADATA = b"""name: testmock
+summary: test mock summary
+description: test mock description
+requires:
+    testreqs:
+        interface: mock
+provides:
+    testprov:
+        interface: mock
+peers:
+    testpeer:
+        interface: mock
+"""
+
+
+def _clean_globals():
+    hookenv.cache.clear()
+    del hookenv._atstart[:]
+    del hookenv._atexit[:]
+
+
+class ConfigTest(TestCase):
+    def setUp(self):
+        super(ConfigTest, self).setUp()
+
+        _clean_globals()
+        self.addCleanup(_clean_globals)
+
+        self.charm_dir = tempfile.mkdtemp()
+        self.addCleanup(lambda: shutil.rmtree(self.charm_dir))
+
+        patcher = patch.object(hookenv, 'charm_dir', lambda: self.charm_dir)
+        self.addCleanup(patcher.stop)
+        patcher.start()
+
+    def test_init(self):
+        d = dict(foo='bar')
+        c = hookenv.Config(d)
+
+        self.assertEqual(c['foo'], 'bar')
+        self.assertEqual(c._prev_dict, None)
+
+    def test_init_empty_state_file(self):
+        d = dict(foo='bar')
+        c = hookenv.Config(d)
+
+        state_path = os.path.join(self.charm_dir, hookenv.Config.CONFIG_FILE_NAME)
+        with open(state_path, 'w') as f:
+            f.close()
+
+        self.assertEqual(c['foo'], 'bar')
+        self.assertEqual(c._prev_dict, None)
+        self.assertEqual(c.path, state_path)
+
+    def test_init_invalid_state_file(self):
+        d = dict(foo='bar')
+
+        state_path = os.path.join(self.charm_dir, hookenv.Config.CONFIG_FILE_NAME)
+        with open(state_path, 'w') as f:
+            f.write('blah')
+
+        c = hookenv.Config(d)
+
+        self.assertEqual(c['foo'], 'bar')
+        self.assertEqual(c._prev_dict, None)
+        self.assertEqual(c.path, state_path)
+
+    def test_load_previous(self):
+        d = dict(foo='bar')
+        c = hookenv.Config()
+
+        with open(c.path, 'w') as f:
+            json.dump(d, f)
+
+        c.load_previous()
+        self.assertEqual(c._prev_dict, d)
+
+    def test_load_previous_alternate_path(self):
+        d = dict(foo='bar')
+        c = hookenv.Config()
+
+        alt_path = os.path.join(self.charm_dir, '.alt-config')
+        with open(alt_path, 'w') as f:
+            json.dump(d, f)
+
+        c.load_previous(path=alt_path)
+        self.assertEqual(c._prev_dict, d)
+        self.assertEqual(c.path, alt_path)
+
+    def test_changed_without_prev_dict(self):
+        d = dict(foo='bar')
+        c = hookenv.Config(d)
+
+        self.assertTrue(c.changed('foo'))
+
+    def test_changed_with_prev_dict(self):
+        c = hookenv.Config(dict(foo='bar', a='b'))
+        c.save()
+        c = hookenv.Config(dict(foo='baz', a='b'))
+
+        self.assertTrue(c.changed('foo'))
+        self.assertFalse(c.changed('a'))
+
+    def test_previous_without_prev_dict(self):
+        c = hookenv.Config()
+
+        self.assertEqual(c.previous('foo'), None)
+
+    def test_previous_with_prev_dict(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c.save()
+        c = hookenv.Config(dict(foo='baz', a='b'))
+
+        self.assertEqual(c.previous('foo'), 'bar')
+        self.assertEqual(c.previous('a'), None)
+
+    def test_save_without_prev_dict(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c.save()
+
+        with open(c.path, 'r') as f:
+            self.assertEqual(c, json.load(f))
+            self.assertEqual(c, dict(foo='bar'))
+            self.assertEqual(os.stat(c.path).st_mode & 0o777, 0o600)
+
+    def test_save_with_prev_dict(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c.save()
+        c = hookenv.Config(dict(a='b'))
+        c.save()
+
+        with open(c.path, 'r') as f:
+            self.assertEqual(c, json.load(f))
+            self.assertEqual(c, dict(foo='bar', a='b'))
+            self.assertEqual(os.stat(c.path).st_mode & 0o777, 0o600)
+
+    def test_deep_change(self):
+        # After loading stored data into our previous dictionary,
+        # it gets copied into our current dictionary. If this is not
+        # a deep copy, then mappings and lists will be shared instances
+        # and changes will not be detected.
+        c = hookenv.Config(dict(ll=[]))
+        c.save()
+        c = hookenv.Config()
+        c['ll'].append(42)
+        self.assertTrue(c.changed('ll'), 'load_previous() did not deepcopy')
+
+    def test_getitem(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c.save()
+        c = hookenv.Config(dict(baz='bam'))
+
+        self.assertRaises(KeyError, lambda: c['missing'])
+        self.assertEqual(c['foo'], 'bar')
+        self.assertEqual(c['baz'], 'bam')
+
+    def test_get(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c.save()
+        c = hookenv.Config(dict(baz='bam'))
+
+        self.assertIsNone(c.get('missing'))
+        self.assertIs(c.get('missing', sentinel.missing), sentinel.missing)
+        self.assertEqual(c.get('foo'), 'bar')
+        self.assertEqual(c.get('baz'), 'bam')
+
+    def test_keys(self):
+        c = hookenv.Config(dict(foo='bar'))
+        c["baz"] = "bar"
+        self.assertEqual(sorted([six.u("foo"), "baz"]), sorted(c.keys()))
+
+    def test_in(self):
+        # Test behavior of the in operator.
+
+        prev_path = os.path.join(hookenv.charm_dir(),
+                                 hookenv.Config.CONFIG_FILE_NAME)
+        with open(prev_path, 'w') as f:
+            json.dump(dict(user='one'), f)
+        c = hookenv.Config(dict(charm='one'))
+
+        # Items that exist in the dict exist. Items that don't don't.
+        self.assertTrue('user' in c)
+        self.assertTrue('charm' in c)
+        self.assertFalse('bar' in c)
+
+        # Adding items works as expected.
+        c['user'] = 'two'
+        c['charm'] = 'two'
+        c['bar'] = 'two'
+        self.assertTrue('user' in c)
+        self.assertTrue('charm' in c)
+        self.assertTrue('bar' in c)
+        c.save()
+        self.assertTrue('user' in c)
+        self.assertTrue('charm' in c)
+        self.assertTrue('bar' in c)
+
+        # Removing items works as expected.
+        del c['user']
+        del c['charm']
+        self.assertTrue('user' not in c)
+        self.assertTrue('charm' not in c)
+        c.save()
+        self.assertTrue('user' not in c)
+        self.assertTrue('charm' not in c)
+
+
+class SerializableTest(TestCase):
+    def test_serializes_object_to_json(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+        self.assertEqual(wrapped.json(), json.dumps(foo))
+
+    def test_serializes_object_to_yaml(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+        self.assertEqual(wrapped.yaml(), yaml.dump(foo))
+
+    def test_gets_attribute_from_inner_object_as_dict(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+
+        self.assertEqual(wrapped.bar, 'baz')
+
+    def test_raises_error_from_inner_object_as_dict(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+
+        self.assertRaises(AttributeError, getattr, wrapped, 'baz')
+
+    def test_dict_methods_from_inner_object(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+        for meth in ('keys', 'values', 'items'):
+            self.assertEqual(sorted(list(getattr(wrapped, meth)())),
+                             sorted(list(getattr(foo, meth)())))
+
+        self.assertEqual(wrapped.get('bar'), foo.get('bar'))
+        self.assertEqual(wrapped.get('baz', 42), foo.get('baz', 42))
+        self.assertIn('bar', wrapped)
+
+    def test_get_gets_from_inner_object(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+
+        self.assertEqual(wrapped.get('foo'), None)
+        self.assertEqual(wrapped.get('bar'), 'baz')
+        self.assertEqual(wrapped.get('zoo', 'bla'), 'bla')
+
+    def test_gets_inner_object(self):
+        foo = {
+            'bar': 'baz',
+        }
+        wrapped = hookenv.Serializable(foo)
+
+        self.assertIs(wrapped.data, foo)
+
+    def test_pickle(self):
+        foo = {'bar': 'baz'}
+        wrapped = hookenv.Serializable(foo)
+        pickled = pickle.dumps(wrapped)
+        unpickled = pickle.loads(pickled)
+
+        self.assert_(isinstance(unpickled, hookenv.Serializable))
+        self.assertEqual(unpickled, foo)
+
+    def test_boolean(self):
+        true_dict = {'foo': 'bar'}
+        false_dict = {}
+
+        self.assertIs(bool(hookenv.Serializable(true_dict)), True)
+        self.assertIs(bool(hookenv.Serializable(false_dict)), False)
+
+    def test_equality(self):
+        foo = {'bar': 'baz'}
+        bar = {'baz': 'bar'}
+        wrapped_foo = hookenv.Serializable(foo)
+
+        self.assertEqual(wrapped_foo, foo)
+        self.assertEqual(wrapped_foo, wrapped_foo)
+        self.assertNotEqual(wrapped_foo, bar)
+
+
+class HelpersTest(TestCase):
+    def setUp(self):
+        super(HelpersTest, self).setUp()
+        _clean_globals()
+        self.addCleanup(_clean_globals)
+
+    @patch('subprocess.call')
+    def test_logs_messages_to_juju_with_default_level(self, mock_call):
+        hookenv.log('foo')
+
+        mock_call.assert_called_with(['juju-log', 'foo'])
+
+    @patch('subprocess.call')
+    def test_logs_messages_object(self, mock_call):
+        hookenv.log(object)
+        mock_call.assert_called_with(['juju-log', repr(object)])
+
+    @patch('subprocess.call')
+    def test_logs_messages_with_alternative_levels(self, mock_call):
+        alternative_levels = [
+            hookenv.CRITICAL,
+            hookenv.ERROR,
+            hookenv.WARNING,
+            hookenv.INFO,
+        ]
+
+        for level in alternative_levels:
+            hookenv.log('foo', level)
+            mock_call.assert_called_with(['juju-log', '-l', level, 'foo'])
+
+    @patch('subprocess.call')
+    def test_function_log_message(self, mock_call):
+        hookenv.function_log('foo')
+        mock_call.assert_called_with(['function-log', 'foo'])
+
+    @patch('subprocess.call')
+    def test_function_log_message_object(self, mock_call):
+        hookenv.function_log(object)
+        mock_call.assert_called_with(['function-log', repr(object)])
+
+    @patch('charmhelpers.core.hookenv._cache_config', None)
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_charm_config_with_scope(self, check_output, charm_dir):
+        check_output.return_value = json.dumps(dict(baz='bar')).encode('UTF-8')
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config(scope='baz')
+
+        self.assertEqual(result, 'bar')
+        check_output.assert_called_with(['config-get', '--all',
+                                         '--format=json'])
+
+        # The result can be used like a string
+        self.assertEqual(result[1], 'a')
+
+        # ... because the result is actually a string
+        self.assert_(isinstance(result, six.string_types))
+
+    @patch('charmhelpers.core.hookenv.log', lambda *args, **kwargs: None)
+    @patch('charmhelpers.core.hookenv._cache_config', None)
+    @patch('subprocess.check_output')
+    def test_gets_missing_charm_config_with_scope(self, check_output):
+        check_output.return_value = b''
+
+        result = hookenv.config(scope='baz')
+
+        self.assertEqual(result, None)
+        check_output.assert_called_with(['config-get', '--all',
+                                         '--format=json'])
+
+    @patch('charmhelpers.core.hookenv._cache_config', None)
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_config_without_scope(self, check_output, charm_dir):
+        check_output.return_value = json.dumps(dict(baz='bar')).encode('UTF-8')
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config()
+
+        self.assertIsInstance(result, hookenv.Config)
+        self.assertEqual(result['baz'], 'bar')
+        check_output.assert_called_with(['config-get', '--all',
+                                         '--format=json'])
+
+    @patch('charmhelpers.core.hookenv.log')
+    @patch('charmhelpers.core.hookenv._cache_config', None)
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_charm_config_invalid_json_with_scope(self,
+                                                       check_output,
+                                                       charm_dir,
+                                                       log):
+        check_output.return_value = '{"invalid: "json"}'.encode('UTF-8')
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config(scope='invalid')
+
+        self.assertEqual(result, None)
+        cmd_line = ['config-get', '--all', '--format=json']
+        check_output.assert_called_with(cmd_line)
+        log.assert_called_with(
+            'Unable to parse output from config-get: '
+            'config_cmd_line="{}" message="{}"'
+            .format(str(cmd_line),
+                    "Expecting ':' delimiter: line 1 column 13 (char 12)"),
+            level=hookenv.ERROR,
+        )
+
+    @patch('charmhelpers.core.hookenv.log')
+    @patch('charmhelpers.core.hookenv._cache_config', None)
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_charm_config_invalid_utf8_with_scope(self,
+                                                       check_output,
+                                                       charm_dir,
+                                                       log):
+        check_output.return_value = b'{"invalid: "json"}\x9D'
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config(scope='invalid')
+
+        self.assertEqual(result, None)
+        cmd_line = ['config-get', '--all', '--format=json']
+        check_output.assert_called_with(cmd_line)
+        try:
+            # Python3
+            log.assert_called_with(
+                'Unable to parse output from config-get: '
+                'config_cmd_line="{}" message="{}"'
+                .format(str(cmd_line),
+                        "'utf8' codec can't decode byte 0x9d in position "
+                        "18: invalid start byte"),
+                level=hookenv.ERROR,
+            )
+        except AssertionError:
+            # Python2.7
+            log.assert_called_with(
+                'Unable to parse output from config-get: '
+                'config_cmd_line="{}" message="{}"'
+                .format(str(cmd_line),
+                        "'utf-8' codec can't decode byte 0x9d in position "
+                        "18: invalid start byte"),
+                level=hookenv.ERROR,
+            )
+
+    @patch('charmhelpers.core.hookenv._cache_config', {'baz': 'bar'})
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_config_from_cache_without_scope(self,
+                                                  check_output,
+                                                  charm_dir):
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config()
+
+        self.assertEqual(result['baz'], 'bar')
+        self.assertFalse(check_output.called)
+
+    @patch('charmhelpers.core.hookenv._cache_config', {'baz': 'bar'})
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    @patch('subprocess.check_output')
+    def test_gets_config_from_cache_with_scope(self,
+                                               check_output,
+                                               charm_dir):
+        charm_dir.return_value = '/nonexistent'
+
+        result = hookenv.config('baz')
+
+        self.assertEqual(result, 'bar')
+
+        # The result can be used like a string
+        self.assertEqual(result[1], 'a')
+
+        # ... because the result is actually a string
+        self.assert_(isinstance(result, six.string_types))
+
+        self.assertFalse(check_output.called)
+
+    @patch('charmhelpers.core.hookenv._cache_config', {'foo': 'bar'})
+    @patch('subprocess.check_output')
+    def test_gets_missing_charm_config_from_cache_with_scope(self,
+                                                             check_output):
+
+        result = hookenv.config(scope='baz')
+
+        self.assertEqual(result, None)
+        self.assertFalse(check_output.called)
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_the_local_unit(self, os_):
+        os_.environ = {
+            'JUJU_UNIT_NAME': 'foo',
+        }
+
+        self.assertEqual(hookenv.local_unit(), 'foo')
+
+    @patch('charmhelpers.core.hookenv.unit_get')
+    def test_gets_unit_public_ip(self, _unitget):
+        _unitget.return_value = sentinel.public_ip
+        self.assertEqual(sentinel.public_ip, hookenv.unit_public_ip())
+        _unitget.assert_called_once_with('public-address')
+
+    @patch('charmhelpers.core.hookenv.unit_get')
+    def test_gets_unit_private_ip(self, _unitget):
+        _unitget.return_value = sentinel.private_ip
+        self.assertEqual(sentinel.private_ip, hookenv.unit_private_ip())
+        _unitget.assert_called_once_with('private-address')
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_checks_that_is_running_in_relation_hook(self, os_):
+        os_.environ = {
+            'JUJU_RELATION': 'foo',
+        }
+
+        self.assertTrue(hookenv.in_relation_hook())
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_checks_that_is_not_running_in_relation_hook(self, os_):
+        os_.environ = {
+            'bar': 'foo',
+        }
+
+        self.assertFalse(hookenv.in_relation_hook())
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_the_relation_type(self, os_):
+        os_.environ = {
+            'JUJU_RELATION': 'foo',
+        }
+
+        self.assertEqual(hookenv.relation_type(), 'foo')
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_relation_type_none_if_not_in_environment(self, os_):
+        os_.environ = {}
+        self.assertEqual(hookenv.relation_type(), None)
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    def test_gets_relation_ids(self, relation_type, check_output):
+        ids = [1, 2, 3]
+        check_output.return_value = json.dumps(ids).encode('UTF-8')
+        reltype = 'foo'
+        relation_type.return_value = reltype
+
+        result = hookenv.relation_ids()
+
+        self.assertEqual(result, ids)
+        check_output.assert_called_with(['relation-ids', '--format=json',
+                                         reltype])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    def test_gets_relation_ids_empty_array(self, relation_type, check_output):
+        ids = []
+        check_output.return_value = json.dumps(None).encode('UTF-8')
+        reltype = 'foo'
+        relation_type.return_value = reltype
+
+        result = hookenv.relation_ids()
+
+        self.assertEqual(result, ids)
+        check_output.assert_called_with(['relation-ids', '--format=json',
+                                         reltype])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    def test_relation_ids_no_relation_type(self, relation_type, check_output):
+        ids = [1, 2, 3]
+        check_output.return_value = json.dumps(ids).encode('UTF-8')
+        relation_type.return_value = None
+
+        result = hookenv.relation_ids()
+
+        self.assertEqual(result, [])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    def test_gets_relation_ids_for_type(self, relation_type, check_output):
+        ids = [1, 2, 3]
+        check_output.return_value = json.dumps(ids).encode('UTF-8')
+        reltype = 'foo'
+
+        result = hookenv.relation_ids(reltype)
+
+        self.assertEqual(result, ids)
+        check_output.assert_called_with(['relation-ids', '--format=json',
+                                         reltype])
+        self.assertFalse(relation_type.called)
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    def test_gets_related_units(self, relation_id, check_output):
+        relid = 123
+        units = ['foo', 'bar']
+        relation_id.return_value = relid
+        check_output.return_value = json.dumps(units).encode('UTF-8')
+
+        result = hookenv.related_units()
+
+        self.assertEqual(result, units)
+        check_output.assert_called_with(['relation-list', '--format=json',
+                                         '-r', relid])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    def test_gets_related_units_empty_array(self, relation_id, check_output):
+        relid = str(123)
+        units = []
+        relation_id.return_value = relid
+        check_output.return_value = json.dumps(None).encode('UTF-8')
+
+        result = hookenv.related_units()
+
+        self.assertEqual(result, units)
+        check_output.assert_called_with(['relation-list', '--format=json',
+                                         '-r', relid])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    def test_related_units_no_relation(self, relation_id, check_output):
+        units = ['foo', 'bar']
+        relation_id.return_value = None
+        check_output.return_value = json.dumps(units).encode('UTF-8')
+
+        result = hookenv.related_units()
+
+        self.assertEqual(result, units)
+        check_output.assert_called_with(['relation-list', '--format=json'])
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    def test_gets_related_units_for_id(self, relation_id, check_output):
+        relid = 123
+        units = ['foo', 'bar']
+        check_output.return_value = json.dumps(units).encode('UTF-8')
+
+        result = hookenv.related_units(relid)
+
+        self.assertEqual(result, units)
+        check_output.assert_called_with(['relation-list', '--format=json',
+                                         '-r', relid])
+        self.assertFalse(relation_id.called)
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('charmhelpers.core.hookenv.goal_state')
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_gets_expected_peer_units(self, has_juju_version, goal_state,
+                                      local_unit):
+        has_juju_version.return_value = True
+        goal_state.return_value = {
+            'units': {
+                'keystone/0': {
+                    'status': 'active',
+                    'since': '2018-09-27 11:38:28Z',
+                },
+                'keystone/1': {
+                    'status': 'active',
+                    'since': '2018-09-27 11:39:23Z',
+                },
+            },
+        }
+        local_unit.return_value = 'keystone/0'
+
+        result = hookenv.expected_peer_units()
+
+        self.assertIsInstance(result, types.GeneratorType)
+        self.assertEqual(sorted(result), ['keystone/1'])
+        has_juju_version.assertCalledOnceWith("2.4.0")
+        local_unit.assertCalledOnceWith()
+
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_gets_expected_peer_units_wrong_version(self, has_juju_version):
+        has_juju_version.return_value = False
+
+        def x():
+            # local helper function to make testtools.TestCase.assertRaises
+            # work with generator
+            list(hookenv.expected_peer_units())
+
+        self.assertRaises(NotImplementedError, x)
+        has_juju_version.assertCalledOnceWith("2.4.0")
+
+    @patch('charmhelpers.core.hookenv.goal_state')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_gets_expected_related_units(self, has_juju_version, relation_type,
+                                         goal_state):
+        has_juju_version.return_value = True
+        relation_type.return_value = 'identity-service'
+        goal_state.return_value = {
+            'relations': {
+                'identity-service': {
+                    'glance': {
+                        'status': 'joined',
+                        'since': '2018-09-27 11:37:16Z'
+                    },
+                    'glance/0': {
+                        'status': 'active',
+                        'since': '2018-09-27 11:27:19Z'
+                    },
+                    'glance/1': {
+                        'status': 'active',
+                        'since': '2018-09-27 11:27:34Z'
+                    },
+                },
+            },
+        }
+
+        result = hookenv.expected_related_units()
+
+        self.assertIsInstance(result, types.GeneratorType)
+        self.assertEqual(sorted(result), ['glance/0', 'glance/1'])
+
+    @patch('charmhelpers.core.hookenv.goal_state')
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_gets_expected_related_units_for_type(self, has_juju_version,
+                                                  goal_state):
+        has_juju_version.return_value = True
+        goal_state.return_value = {
+            'relations': {
+                'identity-service': {
+                    'glance': {
+                        'status': 'joined',
+                        'since': '2018-09-27 11:37:16Z'
+                    },
+                    'glance/0': {
+                        'status': 'active',
+                        'since': '2018-09-27 11:27:19Z'
+                    },
+                    'glance/1': {
+                        'status': 'active',
+                        'since': '2018-09-27 11:27:34Z'
+                    },
+                },
+            },
+        }
+
+        result = hookenv.expected_related_units('identity-service')
+
+        self.assertIsInstance(result, types.GeneratorType)
+        self.assertEqual(sorted(result), ['glance/0', 'glance/1'])
+
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_gets_expected_related_units_wrong_version(self, has_juju_version):
+        has_juju_version.return_value = False
+
+        def x():
+            # local helper function to make testtools.TestCase.assertRaises
+            # work with generator
+            list(hookenv.expected_related_units())
+
+        self.assertRaises(NotImplementedError, x)
+        has_juju_version.assertCalledOnceWith("2.4.4")
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_the_remote_unit(self, os_):
+        os_.environ = {
+            'JUJU_REMOTE_UNIT': 'foo',
+        }
+
+        self.assertEqual(hookenv.remote_unit(), 'foo')
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_no_remote_unit(self, os_):
+        os_.environ = {}
+        self.assertEqual(hookenv.remote_unit(), None)
+
+    @patch('charmhelpers.core.hookenv.remote_unit')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_gets_relation_for_unit(self, relation_get, remote_unit):
+        unit = 'foo-unit'
+        raw_relation = {
+            'foo': 'bar',
+        }
+        remote_unit.return_value = unit
+        relation_get.return_value = raw_relation
+
+        result = hookenv.relation_for_unit()
+
+        self.assertEqual(result['__unit__'], unit)
+        self.assertEqual(result['foo'], 'bar')
+        relation_get.assert_called_with(unit=unit, rid=None)
+
+    @patch('charmhelpers.core.hookenv.remote_unit')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_gets_relation_for_unit_with_list(self, relation_get, remote_unit):
+        unit = 'foo-unit'
+        raw_relation = {
+            'foo-list': 'one two three',
+        }
+        remote_unit.return_value = unit
+        relation_get.return_value = raw_relation
+
+        result = hookenv.relation_for_unit()
+
+        self.assertEqual(result['__unit__'], unit)
+        self.assertEqual(result['foo-list'], ['one', 'two', 'three'])
+        relation_get.assert_called_with(unit=unit, rid=None)
+
+    @patch('charmhelpers.core.hookenv.remote_unit')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_gets_relation_for_specific_unit(self, relation_get, remote_unit):
+        unit = 'foo-unit'
+        raw_relation = {
+            'foo': 'bar',
+        }
+        relation_get.return_value = raw_relation
+
+        result = hookenv.relation_for_unit(unit)
+
+        self.assertEqual(result['__unit__'], unit)
+        self.assertEqual(result['foo'], 'bar')
+        relation_get.assert_called_with(unit=unit, rid=None)
+        self.assertFalse(remote_unit.called)
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_for_unit')
+    def test_gets_relations_for_id(self, relation_for_unit, related_units,
+                                   relation_ids):
+        relid = 123
+        units = ['foo', 'bar']
+        unit_data = [
+            {'foo-item': 'bar-item'},
+            {'foo-item2': 'bar-item2'},
+        ]
+        relation_ids.return_value = relid
+        related_units.return_value = units
+        relation_for_unit.side_effect = unit_data
+
+        result = hookenv.relations_for_id()
+
+        self.assertEqual(result[0]['__relid__'], relid)
+        self.assertEqual(result[0]['foo-item'], 'bar-item')
+        self.assertEqual(result[1]['__relid__'], relid)
+        self.assertEqual(result[1]['foo-item2'], 'bar-item2')
+        related_units.assert_called_with(relid)
+        self.assertEqual(relation_for_unit.mock_calls, [
+            call('foo', relid),
+            call('bar', relid),
+        ])
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_for_unit')
+    def test_gets_relations_for_specific_id(self, relation_for_unit,
+                                            related_units, relation_ids):
+        relid = 123
+        units = ['foo', 'bar']
+        unit_data = [
+            {'foo-item': 'bar-item'},
+            {'foo-item2': 'bar-item2'},
+        ]
+        related_units.return_value = units
+        relation_for_unit.side_effect = unit_data
+
+        result = hookenv.relations_for_id(relid)
+
+        self.assertEqual(result[0]['__relid__'], relid)
+        self.assertEqual(result[0]['foo-item'], 'bar-item')
+        self.assertEqual(result[1]['__relid__'], relid)
+        self.assertEqual(result[1]['foo-item2'], 'bar-item2')
+        related_units.assert_called_with(relid)
+        self.assertEqual(relation_for_unit.mock_calls, [
+            call('foo', relid),
+            call('bar', relid),
+        ])
+        self.assertFalse(relation_ids.called)
+
+    @patch('charmhelpers.core.hookenv.in_relation_hook')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.relations_for_id')
+    def test_gets_relations_for_type(self, relations_for_id, relation_ids,
+                                     relation_type, in_relation_hook):
+        reltype = 'foo-type'
+        relids = [123, 234]
+        relations = [
+            [
+                {'foo': 'bar'},
+                {'foo2': 'bar2'},
+            ],
+            [
+                {'FOO': 'BAR'},
+                {'FOO2': 'BAR2'},
+            ],
+        ]
+        is_in_relation = True
+
+        relation_type.return_value = reltype
+        relation_ids.return_value = relids
+        relations_for_id.side_effect = relations
+        in_relation_hook.return_value = is_in_relation
+
+        result = hookenv.relations_of_type()
+
+        self.assertEqual(result[0]['__relid__'], 123)
+        self.assertEqual(result[0]['foo'], 'bar')
+        self.assertEqual(result[1]['__relid__'], 123)
+        self.assertEqual(result[1]['foo2'], 'bar2')
+        self.assertEqual(result[2]['__relid__'], 234)
+        self.assertEqual(result[2]['FOO'], 'BAR')
+        self.assertEqual(result[3]['__relid__'], 234)
+        self.assertEqual(result[3]['FOO2'], 'BAR2')
+        relation_ids.assert_called_with(reltype)
+        self.assertEqual(relations_for_id.mock_calls, [
+            call(123),
+            call(234),
+        ])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('charmhelpers.core.hookenv.relation_types')
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_gets_relations(self, relation_get, related_units,
+                            relation_ids, relation_types, local_unit):
+        local_unit.return_value = 'u0'
+        relation_types.return_value = ['t1', 't2']
+        relation_ids.return_value = ['i1']
+        related_units.return_value = ['u1', 'u2']
+        relation_get.return_value = {'key': 'val'}
+
+        result = hookenv.relations()
+
+        self.assertEqual(result, {
+            't1': {
+                'i1': {
+                    'u0': {'key': 'val'},
+                    'u1': {'key': 'val'},
+                    'u2': {'key': 'val'},
+                },
+            },
+            't2': {
+                'i1': {
+                    'u0': {'key': 'val'},
+                    'u1': {'key': 'val'},
+                    'u2': {'key': 'val'},
+                },
+            },
+        })
+
+    @patch('charmhelpers.core.hookenv.relation_set')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    @patch('charmhelpers.core.hookenv.local_unit')
+    def test_relation_clear(self, local_unit,
+                            relation_get,
+                            relation_set):
+        local_unit.return_value = 'local-unit'
+        relation_get.return_value = {
+            'private-address': '10.5.0.1',
+            'foo': 'bar',
+            'public-address': '146.192.45.6'
+        }
+        hookenv.relation_clear('relation:1')
+        relation_get.assert_called_with(rid='relation:1',
+                                        unit='local-unit')
+        relation_set.assert_called_with(
+            relation_id='relation:1',
+            **{'private-address': '10.5.0.1',
+               'foo': None,
+               'public-address': '146.192.45.6'})
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made(self, relation_get, related_units,
+                              relation_ids):
+        relation_get.return_value = 'hostname'
+        related_units.return_value = ['test/1']
+        relation_ids.return_value = ['test:0']
+        self.assertTrue(hookenv.is_relation_made('test'))
+        relation_get.assert_called_with('private-address',
+                                        rid='test:0', unit='test/1')
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made_multi_unit(self, relation_get, related_units,
+                                         relation_ids):
+        relation_get.side_effect = [None, 'hostname']
+        related_units.return_value = ['test/1', 'test/2']
+        relation_ids.return_value = ['test:0']
+        self.assertTrue(hookenv.is_relation_made('test'))
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made_different_key(self,
+                                            relation_get, related_units,
+                                            relation_ids):
+        relation_get.return_value = 'hostname'
+        related_units.return_value = ['test/1']
+        relation_ids.return_value = ['test:0']
+        self.assertTrue(hookenv.is_relation_made('test', keys='auth'))
+        relation_get.assert_called_with('auth',
+                                        rid='test:0', unit='test/1')
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made_multiple_keys(self,
+                                            relation_get, related_units,
+                                            relation_ids):
+        relation_get.side_effect = ['password', 'hostname']
+        related_units.return_value = ['test/1']
+        relation_ids.return_value = ['test:0']
+        self.assertTrue(hookenv.is_relation_made('test',
+                                                 keys=['auth', 'host']))
+        relation_get.assert_has_calls(
+            [call('auth', rid='test:0', unit='test/1'),
+             call('host', rid='test:0', unit='test/1')]
+        )
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made_not_made(self,
+                                       relation_get, related_units,
+                                       relation_ids):
+        relation_get.return_value = None
+        related_units.return_value = ['test/1']
+        relation_ids.return_value = ['test:0']
+        self.assertFalse(hookenv.is_relation_made('test'))
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    def test_is_relation_made_not_made_multiple_keys(self,
+                                                     relation_get,
+                                                     related_units,
+                                                     relation_ids):
+        relation_get.side_effect = ['password', None]
+        related_units.return_value = ['test/1']
+        relation_ids.return_value = ['test:0']
+        self.assertFalse(hookenv.is_relation_made('test',
+                                                  keys=['auth', 'host']))
+        relation_get.assert_has_calls(
+            [call('auth', rid='test:0', unit='test/1'),
+             call('host', rid='test:0', unit='test/1')]
+        )
+
+    @patch('charmhelpers.core.hookenv.config')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    @patch('charmhelpers.core.hookenv.relations')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_execution_environment(self, os_, relations_get,
+                                        relations, relation_id, local_unit,
+                                        relation_type, config):
+        config.return_value = 'some-config'
+        relation_type.return_value = 'some-type'
+        local_unit.return_value = 'some-unit'
+        relation_id.return_value = 'some-id'
+        relations.return_value = 'all-relations'
+        relations_get.return_value = 'some-relations'
+        os_.environ = 'some-environment'
+
+        result = hookenv.execution_environment()
+
+        self.assertEqual(result, {
+            'conf': 'some-config',
+            'reltype': 'some-type',
+            'unit': 'some-unit',
+            'relid': 'some-id',
+            'rel': 'some-relations',
+            'rels': 'all-relations',
+            'env': 'some-environment',
+        })
+
+    @patch('charmhelpers.core.hookenv.config')
+    @patch('charmhelpers.core.hookenv.relation_type')
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('charmhelpers.core.hookenv.relation_id')
+    @patch('charmhelpers.core.hookenv.relations')
+    @patch('charmhelpers.core.hookenv.relation_get')
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_execution_environment_no_relation(
+            self, os_, relations_get, relations, relation_id,
+            local_unit, relation_type, config):
+        config.return_value = 'some-config'
+        relation_type.return_value = 'some-type'
+        local_unit.return_value = 'some-unit'
+        relation_id.return_value = None
+        relations.return_value = 'all-relations'
+        relations_get.return_value = 'some-relations'
+        os_.environ = 'some-environment'
+
+        result = hookenv.execution_environment()
+
+        self.assertEqual(result, {
+            'conf': 'some-config',
+            'unit': 'some-unit',
+            'rels': 'all-relations',
+            'env': 'some-environment',
+        })
+
+    @patch('charmhelpers.core.hookenv.remote_service_name')
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.os')
+    def test_gets_the_relation_id(self, os_, relation_ids, remote_service_name):
+        os_.environ = {
+            'JUJU_RELATION_ID': 'foo',
+        }
+
+        self.assertEqual(hookenv.relation_id(), 'foo')
+
+        relation_ids.return_value = ['r:1', 'r:2']
+        remote_service_name.side_effect = ['other', 'service']
+        self.assertEqual(hookenv.relation_id('rel', 'service/0'), 'r:2')
+        relation_ids.assert_called_once_with('rel')
+        self.assertEqual(remote_service_name.call_args_list, [
+            call('r:1'),
+            call('r:2'),
+        ])
+        remote_service_name.side_effect = ['other', 'service']
+        self.assertEqual(hookenv.relation_id('rel', 'service'), 'r:2')
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_relation_id_none_if_no_env(self, os_):
+        os_.environ = {}
+        self.assertEqual(hookenv.relation_id(), None)
+
+    @patch('subprocess.check_output')
+    def test_gets_relation(self, check_output):
+        data = {"foo": "BAR"}
+        check_output.return_value = json.dumps(data).encode('UTF-8')
+        result = hookenv.relation_get()
+
+        self.assertEqual(result['foo'], 'BAR')
+        check_output.assert_called_with(['relation-get', '--format=json', '-'])
+
+    @patch('charmhelpers.core.hookenv.subprocess')
+    def test_relation_get_none(self, mock_subprocess):
+        mock_subprocess.check_output.return_value = b'null'
+
+        result = hookenv.relation_get()
+
+        self.assertIsNone(result)
+
+    @patch('charmhelpers.core.hookenv.subprocess')
+    def test_relation_get_calledprocesserror(self, mock_subprocess):
+        """relation-get called outside a relation will errors without id."""
+        mock_subprocess.check_output.side_effect = CalledProcessError(
+            2, '/foo/bin/relation-get'
+            'no relation id specified')
+
+        result = hookenv.relation_get()
+
+        self.assertIsNone(result)
+
+    @patch('charmhelpers.core.hookenv.subprocess')
+    def test_relation_get_calledprocesserror_other(self, mock_subprocess):
+        """relation-get can fail for other more serious errors."""
+        mock_subprocess.check_output.side_effect = CalledProcessError(
+            1, '/foo/bin/relation-get'
+            'connection refused')
+
+        self.assertRaises(CalledProcessError, hookenv.relation_get)
+
+    @patch('subprocess.check_output')
+    def test_gets_relation_with_scope(self, check_output):
+        check_output.return_value = json.dumps('bar').encode('UTF-8')
+
+        result = hookenv.relation_get(attribute='baz-scope')
+
+        self.assertEqual(result, 'bar')
+        check_output.assert_called_with(['relation-get', '--format=json',
+                                         'baz-scope'])
+
+    @patch('subprocess.check_output')
+    def test_gets_missing_relation_with_scope(self, check_output):
+        check_output.return_value = b""
+
+        result = hookenv.relation_get(attribute='baz-scope')
+
+        self.assertEqual(result, None)
+        check_output.assert_called_with(['relation-get', '--format=json',
+                                         'baz-scope'])
+
+    @patch('subprocess.check_output')
+    def test_gets_relation_with_unit_name(self, check_output):
+        check_output.return_value = json.dumps('BAR').encode('UTF-8')
+
+        result = hookenv.relation_get(attribute='baz-scope', unit='baz-unit')
+
+        self.assertEqual(result, 'BAR')
+        check_output.assert_called_with(['relation-get', '--format=json',
+                                         'baz-scope', 'baz-unit'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('subprocess.check_call')
+    @patch('subprocess.check_output')
+    def test_relation_set_flushes_local_unit_cache(self, check_output,
+                                                   check_call, local_unit):
+        check_output.return_value = json.dumps('BAR').encode('UTF-8')
+        local_unit.return_value = 'baz_unit'
+        hookenv.relation_get(attribute='baz_scope', unit='baz_unit')
+        hookenv.relation_get(attribute='bar_scope')
+        self.assertTrue(len(hookenv.cache) == 2)
+        check_output.return_value = ""
+        hookenv.relation_set(baz_scope='hello')
+        # relation_set should flush any entries for local_unit
+        self.assertTrue(len(hookenv.cache) == 1)
+
+    @patch('subprocess.check_output')
+    def test_gets_relation_with_relation_id(self, check_output):
+        check_output.return_value = json.dumps('BAR').encode('UTF-8')
+
+        result = hookenv.relation_get(attribute='baz-scope', unit='baz-unit',
+                                      rid=123)
+
+        self.assertEqual(result, 'BAR')
+        check_output.assert_called_with(['relation-get', '--format=json', '-r',
+                                         123, 'baz-scope', 'baz-unit'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_sets_relation_with_kwargs(self, check_call_, check_output,
+                                       local_unit):
+        hookenv.relation_set(foo="bar")
+        check_call_.assert_called_with(['relation-set', 'foo=bar'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_sets_relation_with_dict(self, check_call_, check_output,
+                                     local_unit):
+        hookenv.relation_set(relation_settings={"foo": "bar"})
+        check_call_.assert_called_with(['relation-set', 'foo=bar'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_sets_relation_with_relation_id(self, check_call_, check_output,
+                                            local_unit):
+        hookenv.relation_set(relation_id="foo", bar="baz")
+        check_call_.assert_called_with(['relation-set', '-r', 'foo',
+                                        'bar=baz'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_sets_relation_with_missing_value(self, check_call_, check_output,
+                                              local_unit):
+        hookenv.relation_set(foo=None)
+        check_call_.assert_called_with(['relation-set', 'foo='])
+
+    @patch('charmhelpers.core.hookenv.local_unit', MagicMock())
+    @patch('os.remove')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_relation_set_file(self, check_call, check_output, remove):
+        """If relation-set accepts a --file parameter, it's used.
+
+        Juju 1.23.2 introduced a --file parameter, which means you can
+        pass the data through a file. Not using --file would make
+        relation_set break if the relation data is too big.
+        """
+        # check_output(["relation-set", "--help"]) is used to determine
+        # whether we can pass --file to it.
+        check_output.return_value = "--file"
+        hookenv.relation_set(foo="bar")
+        check_output.assert_called_with(
+            ["relation-set", "--help"], universal_newlines=True)
+        # relation-set is called with relation-set --file <temp_file>
+        # with data as YAML and the temp_file is then removed.
+        self.assertEqual(1, len(check_call.call_args[0]))
+        command = check_call.call_args[0][0]
+        self.assertEqual(3, len(command))
+        self.assertEqual("relation-set", command[0])
+        self.assertEqual("--file", command[1])
+        temp_file = command[2]
+        with open(temp_file, "r") as f:
+            self.assertEqual("foo: bar", f.read().strip())
+        remove.assert_called_with(temp_file)
+
+    @patch('charmhelpers.core.hookenv.local_unit', MagicMock())
+    @patch('os.remove')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_relation_set_file_non_str(self, check_call, check_output, remove):
+        """If relation-set accepts a --file parameter, it's used.
+
+        Any value that is not a string is converted to a string before encoding
+        the settings to YAML.
+        """
+        # check_output(["relation-set", "--help"]) is used to determine
+        # whether we can pass --file to it.
+        check_output.return_value = "--file"
+        hookenv.relation_set(foo={"bar": 1})
+        check_output.assert_called_with(
+            ["relation-set", "--help"], universal_newlines=True)
+        # relation-set is called with relation-set --file <temp_file>
+        # with data as YAML and the temp_file is then removed.
+        self.assertEqual(1, len(check_call.call_args[0]))
+        command = check_call.call_args[0][0]
+        self.assertEqual(3, len(command))
+        self.assertEqual("relation-set", command[0])
+        self.assertEqual("--file", command[1])
+        temp_file = command[2]
+        with open(temp_file, "r") as f:
+            self.assertEqual("foo: '{''bar'': 1}'", f.read().strip())
+        remove.assert_called_with(temp_file)
+
+    def test_lists_relation_types(self):
+        open_ = mock_open()
+        open_.return_value = io.BytesIO(CHARM_METADATA)
+
+        with patch('charmhelpers.core.hookenv.open', open_, create=True):
+            with patch.dict('os.environ', {'CHARM_DIR': '/var/empty'}):
+                reltypes = set(hookenv.relation_types())
+        open_.assert_called_once_with('/var/empty/metadata.yaml')
+        self.assertEqual(set(('testreqs', 'testprov', 'testpeer')), reltypes)
+
+    def test_metadata(self):
+        open_ = mock_open()
+        open_.return_value = io.BytesIO(CHARM_METADATA)
+
+        with patch('charmhelpers.core.hookenv.open', open_, create=True):
+            with patch.dict('os.environ', {'CHARM_DIR': '/var/empty'}):
+                metadata = hookenv.metadata()
+        self.assertEqual(metadata, yaml.safe_load(CHARM_METADATA))
+
+    @patch('charmhelpers.core.hookenv.relation_ids')
+    @patch('charmhelpers.core.hookenv.metadata')
+    def test_peer_relation_id(self, metadata, relation_ids):
+        metadata.return_value = {'peers': {sentinel.peer_relname: {}}}
+        relation_ids.return_value = [sentinel.pid1, sentinel.pid2]
+        self.assertEqual(hookenv.peer_relation_id(), sentinel.pid1)
+        relation_ids.assert_called_once_with(sentinel.peer_relname)
+
+    def test_charm_name(self):
+        open_ = mock_open()
+        open_.return_value = io.BytesIO(CHARM_METADATA)
+
+        with patch('charmhelpers.core.hookenv.open', open_, create=True):
+            with patch.dict('os.environ', {'CHARM_DIR': '/var/empty'}):
+                charm_name = hookenv.charm_name()
+        self.assertEqual("testmock", charm_name)
+
+    @patch('subprocess.check_call')
+    def test_opens_port(self, check_call_):
+        hookenv.open_port(443, "TCP")
+        hookenv.open_port(80)
+        hookenv.open_port(100, "UDP")
+        hookenv.open_port(0, "ICMP")
+        calls = [
+            call(['open-port', '443/TCP']),
+            call(['open-port', '80/TCP']),
+            call(['open-port', '100/UDP']),
+            call(['open-port', 'ICMP']),
+        ]
+        check_call_.assert_has_calls(calls)
+
+    @patch('subprocess.check_call')
+    def test_closes_port(self, check_call_):
+        hookenv.close_port(443, "TCP")
+        hookenv.close_port(80)
+        hookenv.close_port(100, "UDP")
+        hookenv.close_port(0, "ICMP")
+        calls = [
+            call(['close-port', '443/TCP']),
+            call(['close-port', '80/TCP']),
+            call(['close-port', '100/UDP']),
+            call(['close-port', 'ICMP']),
+        ]
+        check_call_.assert_has_calls(calls)
+
+    @patch('subprocess.check_call')
+    def test_opens_ports(self, check_call_):
+        hookenv.open_ports(443, 447, "TCP")
+        hookenv.open_ports(80, 91)
+        hookenv.open_ports(100, 200, "UDP")
+        calls = [
+            call(['open-port', '443-447/TCP']),
+            call(['open-port', '80-91/TCP']),
+            call(['open-port', '100-200/UDP']),
+        ]
+        check_call_.assert_has_calls(calls)
+
+    @patch('subprocess.check_call')
+    def test_closes_ports(self, check_call_):
+        hookenv.close_ports(443, 447, "TCP")
+        hookenv.close_ports(80, 91)
+        hookenv.close_ports(100, 200, "UDP")
+        calls = [
+            call(['close-port', '443-447/TCP']),
+            call(['close-port', '80-91/TCP']),
+            call(['close-port', '100-200/UDP']),
+        ]
+        check_call_.assert_has_calls(calls)
+
+    @patch('subprocess.check_output')
+    def test_gets_opened_ports(self, check_output_):
+        prts = ['8080/tcp', '8081-8083/tcp']
+        check_output_.return_value = json.dumps(prts).encode('UTF-8')
+        self.assertEqual(hookenv.opened_ports(), prts)
+        check_output_.assert_called_with(['opened-ports', '--format=json'])
+
+    @patch('subprocess.check_output')
+    def test_gets_unit_attribute(self, check_output_):
+        check_output_.return_value = json.dumps('bar').encode('UTF-8')
+        self.assertEqual(hookenv.unit_get('foo'), 'bar')
+        check_output_.assert_called_with(['unit-get', '--format=json', 'foo'])
+
+    @patch('subprocess.check_output')
+    def test_gets_missing_unit_attribute(self, check_output_):
+        check_output_.return_value = b""
+        self.assertEqual(hookenv.unit_get('foo'), None)
+        check_output_.assert_called_with(['unit-get', '--format=json', 'foo'])
+
+    def test_cached_decorator(self):
+        class Unserializable(object):
+            def __str__(self):
+                return 'unserializable'
+
+        unserializable = Unserializable()
+        calls = []
+        values = {
+            'hello': 'world',
+            'foo': 'bar',
+            'baz': None,
+            unserializable: 'qux',
+        }
+
+        @hookenv.cached
+        def cache_function(attribute):
+            calls.append(attribute)
+            return values[attribute]
+
+        self.assertEquals(cache_function('hello'), 'world')
+        self.assertEquals(cache_function('hello'), 'world')
+        self.assertEquals(cache_function('foo'), 'bar')
+        self.assertEquals(cache_function('baz'), None)
+        self.assertEquals(cache_function('baz'), None)
+        self.assertEquals(cache_function(unserializable), 'qux')
+        self.assertEquals(calls, ['hello', 'foo', 'baz', unserializable])
+
+    def test_gets_charm_dir(self):
+        with patch.dict('os.environ', {}):
+            self.assertEqual(hookenv.charm_dir(), None)
+        with patch.dict('os.environ', {'CHARM_DIR': '/var/empty'}):
+            self.assertEqual(hookenv.charm_dir(), '/var/empty')
+        with patch.dict('os.environ', {'JUJU_CHARM_DIR': '/var/another'}):
+            self.assertEqual(hookenv.charm_dir(), '/var/another')
+
+    @patch('subprocess.check_output')
+    def test_resource_get_unsupported(self, check_output_):
+        check_output_.side_effect = OSError(2, 'resource-get')
+        self.assertRaises(NotImplementedError, hookenv.resource_get, 'foo')
+
+    @patch('subprocess.check_output')
+    def test_resource_get(self, check_output_):
+        check_output_.return_value = b'/tmp/file'
+        self.assertEqual(hookenv.resource_get('file'), '/tmp/file')
+        check_output_.side_effect = CalledProcessError(
+            1, '/foo/bin/resource-get',
+            'error: could not download resource: resource#foo/file not found')
+        self.assertFalse(hookenv.resource_get('no-file'))
+        self.assertFalse(hookenv.resource_get(None))
+
+    @patch('subprocess.check_output')
+    def test_goal_state_unsupported(self, check_output_):
+        check_output_.side_effect = OSError(2, 'goal-state')
+        self.assertRaises(NotImplementedError, hookenv.goal_state)
+
+    @patch('subprocess.check_output')
+    def test_goal_state(self, check_output_):
+        expect = {
+            'units': {},
+            'relations': {},
+        }
+        check_output_.return_value = json.dumps(expect).encode('UTF-8')
+        result = hookenv.goal_state()
+
+        self.assertEqual(result, expect)
+        check_output_.assert_called_with(['goal-state', '--format=json'])
+
+    @patch('subprocess.check_output')
+    def test_is_leader_unsupported(self, check_output_):
+        check_output_.side_effect = OSError(2, 'is-leader')
+        self.assertRaises(NotImplementedError, hookenv.is_leader)
+
+    @patch('subprocess.check_output')
+    def test_is_leader(self, check_output_):
+        check_output_.return_value = b'false'
+        self.assertFalse(hookenv.is_leader())
+        check_output_.return_value = b'true'
+        self.assertTrue(hookenv.is_leader())
+
+    @patch('subprocess.check_call')
+    def test_payload_register(self, check_call_):
+        hookenv.payload_register('monitoring', 'docker', 'abc123')
+        check_call_.assert_called_with(['payload-register', 'monitoring',
+                                        'docker', 'abc123'])
+
+    @patch('subprocess.check_call')
+    def test_payload_unregister(self, check_call_):
+        hookenv.payload_unregister('monitoring', 'abc123')
+        check_call_.assert_called_with(['payload-unregister', 'monitoring',
+                                        'abc123'])
+
+    @patch('subprocess.check_call')
+    def test_payload_status_set(self, check_call_):
+        hookenv.payload_status_set('monitoring', 'abc123', 'Running')
+        check_call_.assert_called_with(['payload-status-set', 'monitoring',
+                                        'abc123', 'Running'])
+
+    @patch('subprocess.check_call')
+    def test_application_version_set(self, check_call_):
+        hookenv.application_version_set('v1.2.3')
+        check_call_.assert_called_with(['application-version-set', 'v1.2.3'])
+
+    @patch.object(os, 'getenv')
+    @patch.object(hookenv, 'log')
+    def test_env_proxy_settings_juju_charm_all_selected(self, faux_log,
+                                                        get_env):
+        expected_settings = {
+            'HTTP_PROXY': 'http://squid.internal:3128',
+            'http_proxy': 'http://squid.internal:3128',
+            'HTTPS_PROXY': 'https://squid.internals:3128',
+            'https_proxy': 'https://squid.internals:3128',
+            'NO_PROXY': '192.0.2.0/24,198.51.100.0/24,.bar.com',
+            'no_proxy': '192.0.2.0/24,198.51.100.0/24,.bar.com',
+            'FTP_PROXY': 'ftp://ftp.internal:21',
+            'ftp_proxy': 'ftp://ftp.internal:21',
+        }
+
+        def get_env_side_effect(var):
+            return {
+                'HTTP_PROXY': None,
+                'HTTPS_PROXY': None,
+                'NO_PROXY': None,
+                'FTP_PROXY': None,
+                'JUJU_CHARM_HTTP_PROXY': 'http://squid.internal:3128',
+                'JUJU_CHARM_HTTPS_PROXY': 'https://squid.internals:3128',
+                'JUJU_CHARM_FTP_PROXY': 'ftp://ftp.internal:21',
+                'JUJU_CHARM_NO_PROXY': '192.0.2.0/24,198.51.100.0/24,.bar.com'
+            }[var]
+        get_env.side_effect = get_env_side_effect
+
+        proxy_settings = hookenv.env_proxy_settings()
+        get_env.assert_has_calls([call("HTTP_PROXY"),
+                                 call("HTTPS_PROXY"),
+                                 call("NO_PROXY"),
+                                 call("FTP_PROXY"),
+                                 call("JUJU_CHARM_HTTP_PROXY"),
+                                 call("JUJU_CHARM_HTTPS_PROXY"),
+                                 call("JUJU_CHARM_FTP_PROXY"),
+                                 call("JUJU_CHARM_NO_PROXY")],
+                                 any_order=True)
+        self.assertEqual(expected_settings, proxy_settings)
+        # Verify that we logged a warning about the cidr in NO_PROXY.
+        faux_log.assert_called_with(hookenv.RANGE_WARNING,
+                                    level=hookenv.WARNING)
+
+    @patch.object(os, 'getenv')
+    def test_env_proxy_settings_legacy_https(self, get_env):
+        expected_settings = {
+            'HTTPS_PROXY': 'http://squid.internal:3128',
+            'https_proxy': 'http://squid.internal:3128',
+        }
+
+        def get_env_side_effect(var):
+            return {
+                'HTTPS_PROXY': 'http://squid.internal:3128',
+                'JUJU_CHARM_HTTPS_PROXY': None,
+            }[var]
+        get_env.side_effect = get_env_side_effect
+
+        proxy_settings = hookenv.env_proxy_settings(['https'])
+        get_env.assert_has_calls([call("HTTPS_PROXY"),
+                                 call("JUJU_CHARM_HTTPS_PROXY")],
+                                 any_order=True)
+        self.assertEqual(expected_settings, proxy_settings)
+
+    @patch.object(os, 'getenv')
+    def test_env_proxy_settings_juju_charm_https(self, get_env):
+        expected_settings = {
+            'HTTPS_PROXY': 'http://squid.internal:3128',
+            'https_proxy': 'http://squid.internal:3128',
+        }
+
+        def get_env_side_effect(var):
+            return {
+                'HTTPS_PROXY': None,
+                'JUJU_CHARM_HTTPS_PROXY': 'http://squid.internal:3128',
+            }[var]
+        get_env.side_effect = get_env_side_effect
+
+        proxy_settings = hookenv.env_proxy_settings(['https'])
+        get_env.assert_has_calls([call("HTTPS_PROXY"),
+                                 call("JUJU_CHARM_HTTPS_PROXY")],
+                                 any_order=True)
+        self.assertEqual(expected_settings, proxy_settings)
+
+    @patch.object(os, 'getenv')
+    def test_env_proxy_settings_legacy_http(self, get_env):
+        expected_settings = {
+            'HTTP_PROXY': 'http://squid.internal:3128',
+            'http_proxy': 'http://squid.internal:3128',
+        }
+
+        def get_env_side_effect(var):
+            return {
+                'HTTP_PROXY': 'http://squid.internal:3128',
+                'JUJU_CHARM_HTTP_PROXY': None,
+            }[var]
+        get_env.side_effect = get_env_side_effect
+
+        proxy_settings = hookenv.env_proxy_settings(['http'])
+        get_env.assert_has_calls([call("HTTP_PROXY"),
+                                 call("JUJU_CHARM_HTTP_PROXY")],
+                                 any_order=True)
+        self.assertEqual(expected_settings, proxy_settings)
+
+    @patch.object(os, 'getenv')
+    def test_env_proxy_settings_juju_charm_http(self, get_env):
+        expected_settings = {
+            'HTTP_PROXY': 'http://squid.internal:3128',
+            'http_proxy': 'http://squid.internal:3128',
+        }
+
+        def get_env_side_effect(var):
+            return {
+                'HTTP_PROXY': None,
+                'JUJU_CHARM_HTTP_PROXY': 'http://squid.internal:3128',
+            }[var]
+        get_env.side_effect = get_env_side_effect
+
+        proxy_settings = hookenv.env_proxy_settings(['http'])
+        get_env.assert_has_calls([call("HTTP_PROXY"),
+                                 call("JUJU_CHARM_HTTP_PROXY")],
+                                 any_order=True)
+        self.assertEqual(expected_settings, proxy_settings)
+
+
+class HooksTest(TestCase):
+    def setUp(self):
+        super(HooksTest, self).setUp()
+
+        _clean_globals()
+        self.addCleanup(_clean_globals)
+
+        charm_dir = tempfile.mkdtemp()
+        self.addCleanup(lambda: shutil.rmtree(charm_dir))
+        patcher = patch.object(hookenv, 'charm_dir', lambda: charm_dir)
+        self.addCleanup(patcher.stop)
+        patcher.start()
+
+        config = hookenv.Config({})
+
+        def _mock_config(scope=None):
+            return config if scope is None else config[scope]
+        patcher = patch.object(hookenv, 'config', _mock_config)
+        self.addCleanup(patcher.stop)
+        patcher.start()
+
+    def test_config_saved_after_execute(self):
+        config = hookenv.config()
+        config.implicit_save = True
+
+        foo = MagicMock()
+        hooks = hookenv.Hooks()
+        hooks.register('foo', foo)
+        hooks.execute(['foo', 'some', 'other', 'args'])
+        self.assertTrue(os.path.exists(config.path))
+
+    def test_config_not_saved_after_execute(self):
+        config = hookenv.config()
+        config.implicit_save = False
+
+        foo = MagicMock()
+        hooks = hookenv.Hooks()
+        hooks.register('foo', foo)
+        hooks.execute(['foo', 'some', 'other', 'args'])
+        self.assertFalse(os.path.exists(config.path))
+
+    def test_config_save_disabled(self):
+        config = hookenv.config()
+        config.implicit_save = True
+
+        foo = MagicMock()
+        hooks = hookenv.Hooks(config_save=False)
+        hooks.register('foo', foo)
+        hooks.execute(['foo', 'some', 'other', 'args'])
+        self.assertFalse(os.path.exists(config.path))
+
+    def test_runs_a_registered_function(self):
+        foo = MagicMock()
+        hooks = hookenv.Hooks()
+        hooks.register('foo', foo)
+
+        hooks.execute(['foo', 'some', 'other', 'args'])
+
+        foo.assert_called_with()
+
+    def test_cannot_run_unregistered_function(self):
+        foo = MagicMock()
+        hooks = hookenv.Hooks()
+        hooks.register('foo', foo)
+
+        self.assertRaises(hookenv.UnregisteredHookError, hooks.execute,
+                          ['bar'])
+
+    def test_can_run_a_decorated_function_as_one_or_more_hooks(self):
+        execs = []
+        hooks = hookenv.Hooks()
+
+        @hooks.hook('bar', 'baz')
+        def func():
+            execs.append(True)
+
+        hooks.execute(['bar'])
+        hooks.execute(['baz'])
+        self.assertRaises(hookenv.UnregisteredHookError, hooks.execute,
+                          ['brew'])
+        self.assertEqual(execs, [True, True])
+
+    def test_can_run_a_decorated_function_as_itself(self):
+        execs = []
+        hooks = hookenv.Hooks()
+
+        @hooks.hook()
+        def func():
+            execs.append(True)
+
+        hooks.execute(['func'])
+        self.assertRaises(hookenv.UnregisteredHookError, hooks.execute,
+                          ['brew'])
+        self.assertEqual(execs, [True])
+
+    def test_magic_underscores(self):
+        # Juju hook names use hypens as separators. Python functions use
+        # underscores. If explicit names have not been provided, hooks
+        # are registered with both the function name and the function
+        # name with underscores replaced with hypens for convenience.
+        execs = []
+        hooks = hookenv.Hooks()
+
+        @hooks.hook()
+        def call_me_maybe():
+            execs.append(True)
+
+        hooks.execute(['call-me-maybe'])
+        hooks.execute(['call_me_maybe'])
+        self.assertEqual(execs, [True, True])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    def test_gets_service_name(self, _unit):
+        _unit.return_value = 'mysql/3'
+        self.assertEqual(hookenv.service_name(), 'mysql')
+
+    @patch('charmhelpers.core.hookenv.related_units')
+    @patch('charmhelpers.core.hookenv.remote_unit')
+    def test_gets_remote_service_name(self, remote_unit, related_units):
+        remote_unit.return_value = 'mysql/3'
+        related_units.return_value = ['pgsql/0', 'pgsql/1']
+        self.assertEqual(hookenv.remote_service_name(), 'mysql')
+        self.assertEqual(hookenv.remote_service_name('pgsql:1'), 'pgsql')
+
+    def test_gets_hook_name(self):
+        with patch.dict(os.environ, JUJU_HOOK_NAME='hook'):
+            self.assertEqual(hookenv.hook_name(), 'hook')
+        with patch('sys.argv', ['other-hook']):
+            self.assertEqual(hookenv.hook_name(), 'other-hook')
+
+    @patch('subprocess.check_output')
+    def test_action_get_with_key(self, check_output):
+        action_data = 'bar'
+        check_output.return_value = json.dumps(action_data).encode('UTF-8')
+
+        result = hookenv.action_get(key='foo')
+
+        self.assertEqual(result, 'bar')
+        check_output.assert_called_with(['action-get', 'foo', '--format=json'])
+
+    @patch('subprocess.check_output')
+    def test_action_get_without_key(self, check_output):
+        check_output.return_value = json.dumps(dict(foo='bar')).encode('UTF-8')
+
+        result = hookenv.action_get()
+
+        self.assertEqual(result['foo'], 'bar')
+        check_output.assert_called_with(['action-get', '--format=json'])
+
+    @patch('subprocess.check_call')
+    def test_action_set(self, check_call):
+        values = {'foo': 'bar', 'fooz': 'barz'}
+        hookenv.action_set(values)
+        # The order of the key/value pairs can change, so sort them before test
+        called_args = check_call.call_args_list[0][0][0]
+        called_args.pop(0)
+        called_args.sort()
+        self.assertEqual(called_args, ['foo=bar', 'fooz=barz'])
+
+    @patch('subprocess.check_call')
+    def test_action_fail(self, check_call):
+        message = "Ooops, the action failed"
+        hookenv.action_fail(message)
+        check_call.assert_called_with(['action-fail', message])
+
+    @patch('charmhelpers.core.hookenv.cmd_exists')
+    @patch('subprocess.check_output')
+    def test_function_get_with_key(self, check_output, cmd_exists):
+        function_data = 'bar'
+        check_output.return_value = json.dumps(function_data).encode('UTF-8')
+        cmd_exists.return_value = True
+
+        result = hookenv.function_get(key='foo')
+
+        self.assertEqual(result, 'bar')
+        check_output.assert_called_with(['function-get', 'foo', '--format=json'])
+
+    @patch('charmhelpers.core.hookenv.cmd_exists')
+    @patch('subprocess.check_output')
+    def test_function_get_without_key(self, check_output, cmd_exists):
+        check_output.return_value = json.dumps(dict(foo='bar')).encode('UTF-8')
+        cmd_exists.return_value = True
+
+        result = hookenv.function_get()
+
+        self.assertEqual(result['foo'], 'bar')
+        check_output.assert_called_with(['function-get', '--format=json'])
+
+    @patch('subprocess.check_call')
+    def test_function_set(self, check_call):
+        values = {'foo': 'bar', 'fooz': 'barz'}
+        hookenv.function_set(values)
+        # The order of the key/value pairs can change, so sort them before test
+        called_args = check_call.call_args_list[0][0][0]
+        called_args.pop(0)
+        called_args.sort()
+        self.assertEqual(called_args, ['foo=bar', 'fooz=barz'])
+
+    @patch('charmhelpers.core.hookenv.cmd_exists')
+    @patch('subprocess.check_call')
+    def test_function_fail(self, check_call, cmd_exists):
+        cmd_exists.return_value = True
+
+        message = "Ooops, the function failed"
+        hookenv.function_fail(message)
+        check_call.assert_called_with(['function-fail', message])
+
+    def test_status_set_invalid_state(self):
+        self.assertRaises(ValueError, hookenv.status_set, 'random', 'message')
+
+    def test_status_set_invalid_state_enum(self):
+
+        class RandomEnum(Enum):
+            FOO = 1
+        self.assertRaises(
+            ValueError,
+            hookenv.status_set,
+            RandomEnum.FOO,
+            'message')
+
+    @patch('subprocess.call')
+    def test_status(self, call):
+        call.return_value = 0
+        hookenv.status_set('active', 'Everything is Awesome!')
+        call.assert_called_with(['status-set', 'active', 'Everything is Awesome!'])
+
+    @patch('subprocess.call')
+    def test_status_enum(self, call):
+        call.return_value = 0
+        hookenv.status_set(
+            hookenv.WORKLOAD_STATES.ACTIVE,
+            'Everything is Awesome!')
+        call.assert_called_with(['status-set', 'active', 'Everything is Awesome!'])
+
+    @patch('subprocess.call')
+    def test_status_app(self, call):
+        call.return_value = 0
+        hookenv.status_set(
+            'active',
+            'Everything is Awesome!',
+            application=True)
+        call.assert_called_with([
+            'status-set',
+            '--application',
+            'active',
+            'Everything is Awesome!'])
+
+    @patch('subprocess.call')
+    @patch.object(hookenv, 'log')
+    def test_status_enoent(self, log, call):
+        call.side_effect = OSError(2, 'fail')
+        hookenv.status_set('active', 'Everything is Awesome!')
+        log.assert_called_with('status-set failed: active Everything is Awesome!', level='INFO')
+
+    @patch('subprocess.call')
+    @patch.object(hookenv, 'log')
+    def test_status_statuscmd_fail(self, log, call):
+        call.side_effect = OSError(3, 'fail')
+        self.assertRaises(OSError, hookenv.status_set, 'active', 'msg')
+        call.assert_called_with(['status-set', 'active', 'msg'])
+
+    @patch('subprocess.check_output')
+    def test_status_get(self, check_output):
+        check_output.return_value = json.dumps(
+            {"message": "foo",
+             "status": "active",
+             "status-data": {}}).encode("UTF-8")
+        result = hookenv.status_get()
+        self.assertEqual(result, ('active', 'foo'))
+        check_output.assert_called_with(
+            ['status-get', "--format=json", "--include-data"])
+
+    @patch('subprocess.check_output')
+    def test_status_get_nostatus(self, check_output):
+        check_output.side_effect = OSError(2, 'fail')
+        result = hookenv.status_get()
+        self.assertEqual(result, ('unknown', ''))
+
+    @patch('subprocess.check_output')
+    def test_status_get_status_error(self, check_output):
+        check_output.side_effect = OSError(3, 'fail')
+        self.assertRaises(OSError, hookenv.status_get)
+
+    @patch('subprocess.check_output')
+    @patch('glob.glob')
+    def test_juju_version(self, glob, check_output):
+        glob.return_value = [sentinel.jujud]
+        check_output.return_value = '1.23.3.1-trusty-amd64\n'
+        self.assertEqual(hookenv.juju_version(), '1.23.3.1-trusty-amd64')
+        # Per https://bugs.launchpad.net/juju-core/+bug/1455368/comments/1
+        glob.assert_called_once_with('/var/lib/juju/tools/machine-*/jujud')
+        check_output.assert_called_once_with([sentinel.jujud, 'version'],
+                                             universal_newlines=True)
+
+    @patch('charmhelpers.core.hookenv.juju_version')
+    def test_has_juju_version(self, juju_version):
+        juju_version.return_value = '1.23.1.2.3.4.5-with-a-cherry-on-top.amd64'
+        self.assertTrue(hookenv.has_juju_version('1.23'))
+        self.assertTrue(hookenv.has_juju_version('1.23.1'))
+        self.assertTrue(hookenv.has_juju_version('1.23.1.1'))
+        self.assertFalse(hookenv.has_juju_version('1.23.2.1'))
+        self.assertFalse(hookenv.has_juju_version('1.24'))
+
+        juju_version.return_value = '1.24-beta5.1-trusty-amd64'
+        self.assertTrue(hookenv.has_juju_version('1.23'))
+        self.assertTrue(hookenv.has_juju_version('1.24'))  # Better if this was false!
+        self.assertTrue(hookenv.has_juju_version('1.24-beta5'))
+        self.assertTrue(hookenv.has_juju_version('1.24-beta5.1'))
+        self.assertFalse(hookenv.has_juju_version('1.25'))
+        self.assertTrue(hookenv.has_juju_version('1.18-backport6'))
+
+    @patch.object(hookenv, 'relation_to_role_and_interface')
+    def test_relation_to_interface(self, rtri):
+        rtri.return_value = (None, 'foo')
+        self.assertEqual(hookenv.relation_to_interface('rel'), 'foo')
+
+    @patch.object(hookenv, 'metadata')
+    def test_relation_to_role_and_interface(self, metadata):
+        metadata.return_value = {
+            'provides': {
+                'pro-rel': {
+                    'interface': 'pro-int',
+                },
+                'pro-rel2': {
+                    'interface': 'pro-int',
+                },
+            },
+            'requires': {
+                'req-rel': {
+                    'interface': 'req-int',
+                },
+            },
+            'peers': {
+                'pee-rel': {
+                    'interface': 'pee-int',
+                },
+            },
+        }
+        rtri = hookenv.relation_to_role_and_interface
+        self.assertEqual(rtri('pro-rel'), ('provides', 'pro-int'))
+        self.assertEqual(rtri('req-rel'), ('requires', 'req-int'))
+        self.assertEqual(rtri('pee-rel'), ('peers', 'pee-int'))
+
+    @patch.object(hookenv, 'metadata')
+    def test_role_and_interface_to_relations(self, metadata):
+        metadata.return_value = {
+            'provides': {
+                'pro-rel': {
+                    'interface': 'pro-int',
+                },
+                'pro-rel2': {
+                    'interface': 'pro-int',
+                },
+            },
+            'requires': {
+                'req-rel': {
+                    'interface': 'int',
+                },
+            },
+            'peers': {
+                'pee-rel': {
+                    'interface': 'int',
+                },
+            },
+        }
+        ritr = hookenv.role_and_interface_to_relations
+        assertItemsEqual = getattr(self, 'assertItemsEqual', getattr(self, 'assertCountEqual', None))
+        assertItemsEqual(ritr('provides', 'pro-int'), ['pro-rel', 'pro-rel2'])
+        assertItemsEqual(ritr('requires', 'int'), ['req-rel'])
+        assertItemsEqual(ritr('peers', 'int'), ['pee-rel'])
+
+    @patch.object(hookenv, 'metadata')
+    def test_interface_to_relations(self, metadata):
+        metadata.return_value = {
+            'provides': {
+                'pro-rel': {
+                    'interface': 'pro-int',
+                },
+                'pro-rel2': {
+                    'interface': 'pro-int',
+                },
+            },
+            'requires': {
+                'req-rel': {
+                    'interface': 'req-int',
+                },
+            },
+            'peers': {
+                'pee-rel': {
+                    'interface': 'pee-int',
+                },
+            },
+        }
+        itr = hookenv.interface_to_relations
+        assertItemsEqual = getattr(self, 'assertItemsEqual', getattr(self, 'assertCountEqual', None))
+        assertItemsEqual(itr('pro-int'), ['pro-rel', 'pro-rel2'])
+        assertItemsEqual(itr('req-int'), ['req-rel'])
+        assertItemsEqual(itr('pee-int'), ['pee-rel'])
+
+    def test_action_name(self):
+        with patch.dict('os.environ', JUJU_ACTION_NAME='action-jack'):
+            self.assertEqual(hookenv.action_name(), 'action-jack')
+
+    def test_action_uuid(self):
+        with patch.dict('os.environ', JUJU_ACTION_UUID='action-jack'):
+            self.assertEqual(hookenv.action_uuid(), 'action-jack')
+
+    def test_action_tag(self):
+        with patch.dict('os.environ', JUJU_ACTION_TAG='action-jack'):
+            self.assertEqual(hookenv.action_tag(), 'action-jack')
+
+    @patch('subprocess.check_output')
+    def test_storage_list(self, check_output):
+        ids = ['data/0', 'data/1', 'data/2']
+        check_output.return_value = json.dumps(ids).encode('UTF-8')
+
+        storage_name = 'arbitrary'
+        result = hookenv.storage_list(storage_name)
+
+        self.assertEqual(result, ids)
+        check_output.assert_called_with(['storage-list', '--format=json',
+                                         storage_name])
+
+    @patch('subprocess.check_output')
+    def test_storage_list_notexist(self, check_output):
+        import errno
+        e = OSError()
+        e.errno = errno.ENOENT
+        check_output.side_effect = e
+
+        result = hookenv.storage_list()
+
+        self.assertEqual(result, [])
+        check_output.assert_called_with(['storage-list', '--format=json'])
+
+    @patch('subprocess.check_output')
+    def test_storage_get_notexist(self, check_output):
+        # storage_get does not catch ENOENT, because there's no reason why you
+        # should be calling storage_get except from a storage hook, or with
+        # the result of storage_list (which will return [] as shown above).
+
+        import errno
+        e = OSError()
+        e.errno = errno.ENOENT
+        check_output.side_effect = e
+        self.assertRaises(OSError, hookenv.storage_get)
+
+    @patch('subprocess.check_output')
+    def test_storage_get(self, check_output):
+        expect = {
+            'location': '/dev/sda',
+            'kind': 'block',
+        }
+        check_output.return_value = json.dumps(expect).encode('UTF-8')
+
+        result = hookenv.storage_get()
+
+        self.assertEqual(result, expect)
+        check_output.assert_called_with(['storage-get', '--format=json'])
+
+    @patch('subprocess.check_output')
+    def test_storage_get_attr(self, check_output):
+        expect = '/dev/sda'
+        check_output.return_value = json.dumps(expect).encode('UTF-8')
+
+        attribute = 'location'
+        result = hookenv.storage_get(attribute)
+
+        self.assertEqual(result, expect)
+        check_output.assert_called_with(['storage-get', '--format=json',
+                                         attribute])
+
+    @patch('subprocess.check_output')
+    def test_storage_get_with_id(self, check_output):
+        expect = {
+            'location': '/dev/sda',
+            'kind': 'block',
+        }
+        check_output.return_value = json.dumps(expect).encode('UTF-8')
+
+        storage_id = 'data/0'
+        result = hookenv.storage_get(storage_id=storage_id)
+
+        self.assertEqual(result, expect)
+        check_output.assert_called_with(['storage-get', '--format=json',
+                                         '-s', storage_id])
+
+    @patch('subprocess.check_output')
+    def test_network_get_primary(self, check_output):
+        """Ensure that network-get is called correctly and output is returned"""
+        check_output.return_value = b'192.168.22.1'
+        ip = hookenv.network_get_primary_address('mybinding')
+        check_output.assert_called_with(
+            ['network-get', '--primary-address', 'mybinding'], stderr=-2)
+        self.assertEqual(ip, '192.168.22.1')
+
+    @patch('subprocess.check_output')
+    def test_network_get_primary_unsupported(self, check_output):
+        """Ensure that NotImplementedError is thrown when run on Juju < 2.0"""
+        check_output.side_effect = OSError(2, 'network-get')
+        self.assertRaises(NotImplementedError, hookenv.network_get_primary_address,
+                          'mybinding')
+
+    @patch('subprocess.check_output')
+    def test_network_get_primary_no_binding_found(self, check_output):
+        """Ensure that NotImplementedError when no binding is found"""
+        check_output.side_effect = CalledProcessError(
+            1, 'network-get',
+            output='no network config found for binding'.encode('UTF-8'))
+        self.assertRaises(hookenv.NoNetworkBinding,
+                          hookenv.network_get_primary_address,
+                          'doesnotexist')
+        check_output.assert_called_with(
+            ['network-get', '--primary-address', 'doesnotexist'], stderr=-2)
+
+    @patch('subprocess.check_output')
+    def test_network_get_primary_other_exception(self, check_output):
+        """Ensure that CalledProcessError still thrown when not
+        a missing binding"""
+        check_output.side_effect = CalledProcessError(
+            1, 'network-get',
+            output='any other message'.encode('UTF-8'))
+        self.assertRaises(CalledProcessError,
+                          hookenv.network_get_primary_address,
+                          'mybinding')
+
+    @patch('charmhelpers.core.hookenv.juju_version')
+    @patch('subprocess.check_output')
+    def test_network_get(self, check_output, juju_version):
+        """Ensure that network-get is called correctly"""
+        juju_version.return_value = '2.2.0'
+        check_output.return_value = b'result'
+        hookenv.network_get('endpoint')
+        check_output.assert_called_with(
+            ['network-get', 'endpoint', '--format', 'yaml'], stderr=-2)
+
+    @patch('charmhelpers.core.hookenv.juju_version')
+    @patch('subprocess.check_output')
+    def test_network_get_primary_required(self, check_output, juju_version):
+        """Ensure that NotImplementedError is thrown with Juju < 2.2.0"""
+        check_output.return_value = b'result'
+
+        juju_version.return_value = '2.1.4'
+        self.assertRaises(NotImplementedError, hookenv.network_get, 'binding')
+        juju_version.return_value = '2.2.0'
+        self.assertEquals(hookenv.network_get('endpoint'), 'result')
+
+    @patch('charmhelpers.core.hookenv.juju_version')
+    @patch('subprocess.check_output')
+    def test_network_get_relation_bound(self, check_output, juju_version):
+        """Ensure that network-get supports relation context, requires Juju 2.3"""
+        juju_version.return_value = '2.3.0'
+        check_output.return_value = b'result'
+        hookenv.network_get('endpoint', 'db')
+        check_output.assert_called_with(
+            ['network-get', 'endpoint', '--format', 'yaml', '-r', 'db'],
+            stderr=-2)
+        juju_version.return_value = '2.2.8'
+        self.assertRaises(NotImplementedError, hookenv.network_get, 'endpoint', 'db')
+
+    @patch('charmhelpers.core.hookenv.juju_version')
+    @patch('subprocess.check_output')
+    def test_network_get_parses_yaml(self, check_output, juju_version):
+        """network-get returns loaded YAML output."""
+        juju_version.return_value = '2.3.0'
+        check_output.return_value = b"""
+bind-addresses:
+- macaddress: ""
+  interfacename: ""
+  addresses:
+    - address: 10.136.107.33
+      cidr: ""
+ingress-addresses:
+- 10.136.107.33
+        """
+        ip = hookenv.network_get('mybinding')
+        self.assertEqual(len(ip['bind-addresses']), 1)
+        self.assertEqual(ip['ingress-addresses'], ['10.136.107.33'])
+
+    @patch('subprocess.check_call')
+    def test_add_metric(self, check_call_):
+        hookenv.add_metric(flips='1.5', flops='2.1')
+        hookenv.add_metric('juju-units=6')
+        hookenv.add_metric('foo-bar=3.333', 'baz-quux=8', users='2')
+        calls = [
+            call(['add-metric', 'flips=1.5', 'flops=2.1']),
+            call(['add-metric', 'juju-units=6']),
+            call(['add-metric', 'baz-quux=8', 'foo-bar=3.333', 'users=2']),
+        ]
+        check_call_.assert_has_calls(calls)
+
+    @patch('subprocess.check_call')
+    @patch.object(hookenv, 'log')
+    def test_add_metric_enoent(self, log, _check_call):
+        _check_call.side_effect = OSError(2, 'fail')
+        hookenv.add_metric(flips='1')
+        log.assert_called_with('add-metric failed: flips=1', level='INFO')
+
+    @patch('charmhelpers.core.hookenv.os')
+    def test_meter_status(self, os_):
+        os_.environ = {
+            'JUJU_METER_STATUS': 'GREEN',
+            'JUJU_METER_INFO': 'all good',
+        }
+        self.assertEqual(hookenv.meter_status(), 'GREEN')
+        self.assertEqual(hookenv.meter_info(), 'all good')
+
+    @patch.object(hookenv, 'related_units')
+    @patch.object(hookenv, 'relation_ids')
+    def test_iter_units_for_relation_name(self, relation_ids, related_units):
+        relation_ids.return_value = ['rel:1']
+        related_units.return_value = ['unit/0', 'unit/1', 'unit/2']
+        expected = [('rel:1', 'unit/0'),
+                    ('rel:1', 'unit/1'),
+                    ('rel:1', 'unit/2')]
+        related_units_data = [
+            (u.rid, u.unit)
+            for u in hookenv.iter_units_for_relation_name('rel')]
+        self.assertEqual(expected, related_units_data)
+
+    @patch.object(hookenv, 'relation_get')
+    def test_ingress_address(self, relation_get):
+        """Ensure ingress_address returns the ingress-address when available
+        and returns the private-address when not.
+        """
+        _with_ingress = {'egress-subnets': '10.5.0.23/32',
+                         'ingress-address': '10.5.0.23',
+                         'private-address': '172.16.5.10'}
+
+        _without_ingress = {'private-address': '172.16.5.10'}
+
+        # Return the ingress-address
+        relation_get.return_value = _with_ingress
+        self.assertEqual(hookenv.ingress_address(rid='test:1', unit='unit/1'),
+                         '10.5.0.23')
+        relation_get.assert_called_with(rid='test:1', unit='unit/1')
+        # Return the private-address
+        relation_get.return_value = _without_ingress
+        self.assertEqual(hookenv.ingress_address(rid='test:1'),
+                         '172.16.5.10')
+
+    @patch.object(hookenv, 'relation_get')
+    def test_egress_subnets(self, relation_get):
+        """Ensure egress_subnets returns the decoded egress-subnets when available
+        and falls back correctly when not.
+        """
+        d = {'egress-subnets': '10.5.0.23/32,2001::F00F/64',
+             'ingress-address': '10.5.0.23',
+             'private-address': '2001::D0:F00D'}
+
+        # Return the egress-subnets
+        relation_get.return_value = d
+        self.assertEqual(hookenv.egress_subnets(rid='test:1', unit='unit/1'),
+                         ['10.5.0.23/32', '2001::F00F/64'])
+        relation_get.assert_called_with(rid='test:1', unit='unit/1')
+
+        # Return the ingress-address
+        del d['egress-subnets']
+        self.assertEqual(hookenv.egress_subnets(), ['10.5.0.23/32'])
+
+        # Return the private-address
+        del d['ingress-address']
+        self.assertEqual(hookenv.egress_subnets(), ['2001::D0:F00D/128'])
+
+    @patch('charmhelpers.core.hookenv.local_unit')
+    @patch('charmhelpers.core.hookenv.goal_state')
+    @patch('charmhelpers.core.hookenv.has_juju_version')
+    def test_unit_doomed(self, has_juju_version, goal_state, local_unit):
+        # We need to test for a minimum patch level, or we risk
+        # data loss by returning bogus results with Juju 2.4.0
+        has_juju_version.return_value = False
+        self.assertRaises(NotImplementedError, hookenv.unit_doomed)
+        has_juju_version.assertCalledOnceWith("2.4.1")
+        has_juju_version.return_value = True
+
+        goal_state.return_value = json.loads('''
+                                             {
+                                                "units": {
+                                                    "postgresql/0": {
+                                                        "status": "dying",
+                                                        "since": "2018-07-30 10:01:06Z"
+                                                    },
+                                                    "postgresql/1": {
+                                                        "status": "active",
+                                                        "since": "2018-07-30 10:22:39Z"
+                                                    }
+                                                },
+                                                "relations": {}
+                                             }
+                                             ''')
+        self.assertTrue(hookenv.unit_doomed('postgresql/0'))   # unit removed, status "dying"
+        self.assertFalse(hookenv.unit_doomed('postgresql/1'))  # unit exists, status "active", maybe other states
+        self.assertTrue(hookenv.unit_doomed('postgresql/2'))   # unit does not exist
+
+        local_unit.return_value = 'postgresql/0'
+        self.assertTrue(hookenv.unit_doomed())
+
+    def test_contains_addr_range(self):
+        # Contains cidr
+        self.assertTrue(hookenv._contains_range("192.168.1/20"))
+        self.assertTrue(hookenv._contains_range("192.168.0/24"))
+        self.assertTrue(
+            hookenv._contains_range("10.40.50.1,192.168.1/20,10.56.78.9"))
+        self.assertTrue(hookenv._contains_range("192.168.22/24"))
+        self.assertTrue(hookenv._contains_range("2001:db8::/32"))
+        self.assertTrue(hookenv._contains_range("*.foo.com"))
+        self.assertTrue(hookenv._contains_range(".foo.com"))
+        self.assertTrue(
+            hookenv._contains_range("192.168.1.20,.foo.com"))
+        self.assertTrue(
+            hookenv._contains_range("192.168.1.20,  .foo.com"))
+        self.assertTrue(
+            hookenv._contains_range("192.168.1.20,*.foo.com"))
+
+        # Doesn't contain cidr
+        self.assertFalse(hookenv._contains_range("192.168.1"))
+        self.assertFalse(hookenv._contains_range("192.168.145"))
+        self.assertFalse(hookenv._contains_range("192.16.14"))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_host.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_host.py
new file mode 100644
index 0000000000000000000000000000000000000000..19617e8fdebdbccf99a2be722c1dc41beb686030
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_host.py
@@ -0,0 +1,2008 @@
+import os.path
+from collections import OrderedDict
+import subprocess
+from tempfile import mkdtemp
+from shutil import rmtree
+from textwrap import dedent
+
+import imp
+
+from charmhelpers import osplatform
+from mock import patch, call, mock_open
+from testtools import TestCase
+from tests.helpers import patch_open
+from tests.helpers import mock_open as mocked_open
+import six
+
+from charmhelpers.core import host
+from charmhelpers.fetch import ubuntu_apt_pkg
+
+
+MOUNT_LINES = ("""
+rootfs / rootfs rw 0 0
+sysfs /sys sysfs rw,nosuid,nodev,noexec,relatime 0 0
+proc /proc proc rw,nosuid,nodev,noexec,relatime 0 0
+udev /dev devtmpfs rw,relatime,size=8196788k,nr_inodes=2049197,mode=755 0 0
+devpts /dev/pts devpts """
+               """rw,nosuid,noexec,relatime,gid=5,mode=620,ptmxmode=000 0 0
+""").strip().split('\n')
+
+LSB_RELEASE = '''DISTRIB_ID=Ubuntu
+DISTRIB_RELEASE=13.10
+DISTRIB_CODENAME=saucy
+DISTRIB_DESCRIPTION="Ubuntu Saucy Salamander (development branch)"
+'''
+
+OS_RELEASE = '''NAME="CentOS Linux"
+ANSI_COLOR="0;31"
+ID_LIKE="rhel fedora"
+VERSION_ID="7"
+BUG_REPORT_URL="https://bugs.centos.org/"
+CENTOS_MANTISBT_PROJECT="CentOS-7"
+PRETTY_NAME="CentOS Linux 7 (Core)"
+VERSION="7 (Core)"
+REDHAT_SUPPORT_PRODUCT_VERSION="7"
+CENTOS_MANTISBT_PROJECT_VERSION="7"
+REDHAT_SUPPORT_PRODUCT="centos"
+HOME_URL="https://www.centos.org/"
+CPE_NAME="cpe:/o:centos:centos:7"
+ID="centos"
+'''
+
+IP_LINE_ETH0 = b"""
+2: eth0: <BROADCAST,MULTICAST,SLAVE,UP,LOWER_UP> mtu 1500 qdisc mq master bond0 state UP qlen 1000
+    link/ether e4:11:5b:ab:a7:3c brd ff:ff:ff:ff:ff:ff
+"""
+
+IP_LINE_ETH100 = b"""
+2: eth100: <BROADCAST,MULTICAST,SLAVE,UP,LOWER_UP> mtu 1500 qdisc mq master bond0 state UP qlen 1000
+    link/ether e4:11:5b:ab:a7:3d brd ff:ff:ff:ff:ff:ff
+"""
+
+IP_LINE_ETH0_VLAN = b"""
+6: eth0.10@eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default
+    link/ether 08:00:27:16:b9:5f brd ff:ff:ff:ff:ff:ff
+"""
+
+IP_LINE_ETH1 = b"""
+3: eth1: <BROADCAST,MULTICAST> mtu 1546 qdisc noop state DOWN qlen 1000
+    link/ether e4:11:5b:ab:a7:3c brd ff:ff:ff:ff:ff:ff
+"""
+
+IP_LINE_HWADDR = b"""2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000\\    link/ether e4:11:5b:ab:a7:3c brd ff:ff:ff:ff:ff:ff"""
+
+IP_LINES = IP_LINE_ETH0 + IP_LINE_ETH1 + IP_LINE_ETH0_VLAN + IP_LINE_ETH100
+
+IP_LINE_BONDS = b"""
+6: bond0.10@bond0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default
+link/ether 08:00:27:16:b9:5f brd ff:ff:ff:ff:ff:ff
+"""
+
+
+class HelpersTest(TestCase):
+
+    @patch('charmhelpers.core.host.lsb_release')
+    @patch('os.path')
+    def test_init_is_systemd_upstart(self, path, lsb_release):
+        """Upstart based init is correctly detected"""
+        lsb_release.return_value = {'DISTRIB_CODENAME': 'whatever'}
+        path.isdir.return_value = False
+        self.assertFalse(host.init_is_systemd())
+        path.isdir.assert_called_with('/run/systemd/system')
+
+    @patch('charmhelpers.core.host.lsb_release')
+    @patch('os.path')
+    def test_init_is_systemd_system(self, path, lsb_release):
+        """Systemd based init is correctly detected"""
+        lsb_release.return_value = {'DISTRIB_CODENAME': 'whatever'}
+        path.isdir.return_value = True
+        self.assertTrue(host.init_is_systemd())
+        path.isdir.assert_called_with('/run/systemd/system')
+
+    @patch('charmhelpers.core.host.lsb_release')
+    @patch('os.path')
+    def test_init_is_systemd_trusty(self, path, lsb_release):
+        # Never returns true under trusty, even if the systemd
+        # packages have been installed. lp:1670944
+        lsb_release.return_value = {'DISTRIB_CODENAME': 'trusty'}
+        path.isdir.return_value = True
+        self.assertFalse(host.init_is_systemd())
+        self.assertFalse(path.isdir.called)
+
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_runs_service_action(self, mock_call, systemd):
+        systemd.return_value = False
+        mock_call.return_value = 0
+        action = 'some-action'
+        service_name = 'foo-service'
+
+        result = host.service(action, service_name)
+
+        self.assertTrue(result)
+        mock_call.assert_called_with(['service', service_name, action])
+
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_runs_systemctl_action(self, mock_call, systemd):
+        """Ensure that service calls under systemd call 'systemctl'."""
+        systemd.return_value = True
+        mock_call.return_value = 0
+        action = 'some-action'
+        service_name = 'foo-service'
+
+        result = host.service(action, service_name)
+
+        self.assertTrue(result)
+        mock_call.assert_called_with(['systemctl', action, service_name])
+
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_returns_false_when_service_fails(self, mock_call, systemd):
+        systemd.return_value = False
+        mock_call.return_value = 1
+        action = 'some-action'
+        service_name = 'foo-service'
+
+        result = host.service(action, service_name)
+
+        self.assertFalse(result)
+        mock_call.assert_called_with(['service', service_name, action])
+
+    @patch.object(host, 'service')
+    def test_starts_a_service(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        self.assertTrue(host.service_start(service_name))
+
+        service.assert_called_with('start', service_name)
+
+    @patch.object(host, 'service')
+    def test_starts_a_service_with_parms(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        self.assertTrue(host.service_start(service_name, id=4))
+
+        service.assert_called_with('start', service_name, id=4)
+
+    @patch.object(host, 'service')
+    def test_stops_a_service(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        self.assertTrue(host.service_stop(service_name))
+
+        service.assert_called_with('stop', service_name)
+
+    @patch.object(host, 'service')
+    def test_restarts_a_service(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        self.assertTrue(host.service_restart(service_name))
+
+        service.assert_called_with('restart', service_name)
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_pauses_a_running_systemd_unit(self, service, systemd,
+                                           service_running):
+        """Pause on a running systemd unit will be stopped and disabled."""
+        service_name = 'foo-service'
+        service_running.return_value = True
+        systemd.return_value = True
+        self.assertTrue(host.service_pause(service_name))
+        service.assert_has_calls([
+            call('stop', service_name),
+            call('disable', service_name),
+            call('mask', service_name)])
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_resumes_a_stopped_systemd_unit(self, service, systemd,
+                                            service_running):
+        """Resume on a stopped systemd unit will be started and enabled."""
+        service_name = 'foo-service'
+        service_running.return_value = False
+        systemd.return_value = True
+        self.assertTrue(host.service_resume(service_name))
+        service.assert_has_calls([
+            call('unmask', service_name),
+            # Ensures a package starts up if disabled but not masked,
+            # per lp:1692178
+            call('enable', service_name),
+            call('start', service_name)])
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_pauses_a_running_upstart_service(self, service, systemd,
+                                              service_running):
+        """Pause on a running service will call service stop."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = True
+        tempdir = mkdtemp(prefix="test_pauses_an_upstart_service")
+        conf_path = os.path.join(tempdir, "{}.conf".format(service_name))
+        # Just needs to exist
+        with open(conf_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_pause(service_name, init_dir=tempdir))
+
+        service.assert_called_with('stop', service_name)
+        override_path = os.path.join(
+            tempdir, "{}.override".format(service_name))
+        with open(override_path, "r") as fh:
+            override_contents = fh.read()
+        self.assertEqual("manual\n", override_contents)
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_pauses_a_stopped_upstart_service(self, service, systemd,
+                                              service_running):
+        """Pause on a stopped service will not call service stop."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = False
+        tempdir = mkdtemp(prefix="test_pauses_an_upstart_service")
+        conf_path = os.path.join(tempdir, "{}.conf".format(service_name))
+        # Just needs to exist
+        with open(conf_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_pause(service_name, init_dir=tempdir))
+
+        # Stop isn't called because service is already stopped
+        self.assertRaises(
+            AssertionError, service.assert_called_with, 'stop', service_name)
+        override_path = os.path.join(
+            tempdir, "{}.override".format(service_name))
+        with open(override_path, "r") as fh:
+            override_contents = fh.read()
+        self.assertEqual("manual\n", override_contents)
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'service')
+    def test_pauses_a_running_sysv_service(self, service, check_call,
+                                           systemd, service_running):
+        """Pause calls service stop on a running sysv service."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = True
+        tempdir = mkdtemp(prefix="test_pauses_a_sysv_service")
+        sysv_path = os.path.join(tempdir, service_name)
+        # Just needs to exist
+        with open(sysv_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_pause(
+            service_name, init_dir=tempdir, initd_dir=tempdir))
+
+        service.assert_called_with('stop', service_name)
+        check_call.assert_called_with(["update-rc.d", service_name, "disable"])
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'service')
+    def test_pauses_a_stopped_sysv_service(self, service, check_call,
+                                           systemd, service_running):
+        """Pause does not call service stop on a stopped sysv service."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = False
+        tempdir = mkdtemp(prefix="test_pauses_a_sysv_service")
+        sysv_path = os.path.join(tempdir, service_name)
+        # Just needs to exist
+        with open(sysv_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_pause(
+            service_name, init_dir=tempdir, initd_dir=tempdir))
+
+        # Stop isn't called because service is already stopped
+        self.assertRaises(
+            AssertionError, service.assert_called_with, 'stop', service_name)
+        check_call.assert_called_with(["update-rc.d", service_name, "disable"])
+
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_pause_with_unknown_service(self, service, systemd):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        tempdir = mkdtemp(prefix="test_pauses_with_unknown_service")
+        self.addCleanup(rmtree, tempdir)
+        exception = self.assertRaises(
+            ValueError, host.service_pause,
+            service_name, init_dir=tempdir, initd_dir=tempdir)
+        self.assertIn(
+            "Unable to detect {0}".format(service_name), str(exception))
+        self.assertIn(tempdir, str(exception))
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_output')
+    @patch.object(host, 'service')
+    def test_resumes_a_running_upstart_service(self, service, check_output,
+                                               systemd, service_running):
+        """When the service is already running, service start isn't called."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = True
+        tempdir = mkdtemp(prefix="test_resumes_an_upstart_service")
+        conf_path = os.path.join(tempdir, "{}.conf".format(service_name))
+        with open(conf_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_resume(service_name, init_dir=tempdir))
+
+        # Start isn't called because service is already running
+        self.assertFalse(service.called)
+        override_path = os.path.join(
+            tempdir, "{}.override".format(service_name))
+        self.assertFalse(os.path.exists(override_path))
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_output')
+    @patch.object(host, 'service')
+    def test_resumes_a_stopped_upstart_service(self, service, check_output,
+                                               systemd, service_running):
+        """When the service is stopped, service start is called."""
+        check_output.return_value = b'foo-service stop/waiting'
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = False
+        tempdir = mkdtemp(prefix="test_resumes_an_upstart_service")
+        conf_path = os.path.join(tempdir, "{}.conf".format(service_name))
+        with open(conf_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_resume(service_name, init_dir=tempdir))
+
+        service.assert_called_with('start', service_name)
+        override_path = os.path.join(
+            tempdir, "{}.override".format(service_name))
+        self.assertFalse(os.path.exists(override_path))
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'service')
+    def test_resumes_a_sysv_service(self, service, check_call, systemd,
+                                    service_running):
+        """When process is in a stop/waiting state, service start is called."""
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = False
+        tempdir = mkdtemp(prefix="test_resumes_a_sysv_service")
+        sysv_path = os.path.join(tempdir, service_name)
+        # Just needs to exist
+        with open(sysv_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_resume(
+            service_name, init_dir=tempdir, initd_dir=tempdir))
+
+        service.assert_called_with('start', service_name)
+        check_call.assert_called_with(["update-rc.d", service_name, "enable"])
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'service')
+    def test_resume_a_running_sysv_service(self, service, check_call,
+                                           systemd, service_running):
+        """When process is already running, service start isn't called."""
+        service_name = 'foo-service'
+        systemd.return_value = False
+        service_running.return_value = True
+        tempdir = mkdtemp(prefix="test_resumes_a_sysv_service")
+        sysv_path = os.path.join(tempdir, service_name)
+        # Just needs to exist
+        with open(sysv_path, "w") as fh:
+            fh.write("")
+        self.addCleanup(rmtree, tempdir)
+        self.assertTrue(host.service_resume(
+            service_name, init_dir=tempdir, initd_dir=tempdir))
+
+        # Start isn't called because service is already running
+        self.assertFalse(service.called)
+        check_call.assert_called_with(["update-rc.d", service_name, "enable"])
+
+    @patch.object(host, 'service_running')
+    @patch.object(host, 'init_is_systemd')
+    @patch.object(host, 'service')
+    def test_resume_with_unknown_service(self, service, systemd,
+                                         service_running):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        systemd.return_value = False
+        service_running.return_value = False
+        tempdir = mkdtemp(prefix="test_resumes_with_unknown_service")
+        self.addCleanup(rmtree, tempdir)
+        exception = self.assertRaises(
+            ValueError, host.service_resume,
+            service_name, init_dir=tempdir, initd_dir=tempdir)
+        self.assertIn(
+            "Unable to detect {0}".format(service_name), str(exception))
+        self.assertIn(tempdir, str(exception))
+
+    @patch.object(host, 'service')
+    def test_reloads_a_service(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [True]
+        self.assertTrue(host.service_reload(service_name))
+
+        service.assert_called_with('reload', service_name)
+
+    @patch.object(host, 'service')
+    def test_failed_reload_restarts_a_service(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False, True]
+        self.assertTrue(
+            host.service_reload(service_name, restart_on_failure=True))
+
+        service.assert_has_calls([
+            call('reload', service_name),
+            call('restart', service_name)
+        ])
+
+    @patch.object(host, 'service')
+    def test_failed_reload_without_restart(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False]
+        self.assertFalse(host.service_reload(service_name))
+
+        service.assert_called_with('reload', service_name)
+
+    @patch.object(host, 'service')
+    def test_start_a_service_fails(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False]
+        self.assertFalse(host.service_start(service_name))
+
+        service.assert_called_with('start', service_name)
+
+    @patch.object(host, 'service')
+    def test_stop_a_service_fails(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False]
+        self.assertFalse(host.service_stop(service_name))
+
+        service.assert_called_with('stop', service_name)
+
+    @patch.object(host, 'service')
+    def test_restart_a_service_fails(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False]
+        self.assertFalse(host.service_restart(service_name))
+
+        service.assert_called_with('restart', service_name)
+
+    @patch.object(host, 'service')
+    def test_reload_a_service_fails(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False]
+        self.assertFalse(host.service_reload(service_name))
+
+        service.assert_called_with('reload', service_name)
+
+    @patch.object(host, 'service')
+    def test_failed_reload_restarts_a_service_fails(self, service):
+        service_name = 'foo-service'
+        service.side_effect = [False, False]
+        self.assertFalse(
+            host.service_reload(service_name, restart_on_failure=True))
+
+        service.assert_has_calls([
+            call('reload', service_name),
+            call('restart', service_name)
+        ])
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_output')
+    def test_service_running_on_stopped_service(self, check_output, systemd,
+                                                os):
+        systemd.return_value = False
+        os.path.exists.return_value = True
+        check_output.return_value = b'foo stop/waiting'
+        self.assertFalse(host.service_running('foo'))
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_output')
+    def test_service_running_on_running_service(self, check_output, systemd,
+                                                os):
+        systemd.return_value = False
+        os.path.exists.return_value = True
+        check_output.return_value = b'foo start/running, process 23871'
+        self.assertTrue(host.service_running('foo'))
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.check_output')
+    def test_service_running_on_unknown_service(self, check_output, systemd,
+                                                os):
+        systemd.return_value = False
+        os.path.exists.return_value = True
+        exc = subprocess.CalledProcessError(1, ['status'])
+        check_output.side_effect = exc
+        self.assertFalse(host.service_running('foo'))
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'service')
+    @patch.object(host, 'init_is_systemd')
+    def test_service_systemv_running(self, systemd, service, os):
+        systemd.return_value = False
+        service.return_value = True
+        os.path.exists.side_effect = [False, True]
+        self.assertTrue(host.service_running('rabbitmq-server'))
+        service.assert_called_with('status', 'rabbitmq-server')
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'service')
+    @patch.object(host, 'init_is_systemd')
+    def test_service_systemv_not_running(self, systemd, service,
+                                         os):
+        systemd.return_value = False
+        service.return_value = False
+        os.path.exists.side_effect = [False, True]
+        self.assertFalse(host.service_running('keystone'))
+        service.assert_called_with('status', 'keystone')
+
+    @patch('subprocess.call')
+    @patch.object(host, 'init_is_systemd')
+    def test_service_start_with_params(self, systemd, call):
+        systemd.return_value = False
+        call.return_value = 0
+        self.assertTrue(host.service_start('ceph-osd', id=4))
+        call.assert_called_with(['service', 'ceph-osd', 'start', 'id=4'])
+
+    @patch('subprocess.call')
+    @patch.object(host, 'init_is_systemd')
+    def test_service_stop_with_params(self, systemd, call):
+        systemd.return_value = False
+        call.return_value = 0
+        self.assertTrue(host.service_stop('ceph-osd', id=4))
+        call.assert_called_with(['service', 'ceph-osd', 'stop', 'id=4'])
+
+    @patch('subprocess.call')
+    @patch.object(host, 'init_is_systemd')
+    def test_service_start_systemd_with_params(self, systemd, call):
+        systemd.return_value = True
+        call.return_value = 0
+        self.assertTrue(host.service_start('ceph-osd', id=4))
+        call.assert_called_with(['systemctl', 'start', 'ceph-osd'])
+
+    @patch('grp.getgrnam')
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adds_a_user_if_it_doesnt_exist(self, log, check_call,
+                                            getpwnam, getgrnam):
+        username = 'johndoe'
+        password = 'eodnhoj'
+        shell = '/bin/bash'
+        existing_user_pwnam = KeyError('user not found')
+        new_user_pwnam = 'some user pwnam'
+
+        getpwnam.side_effect = [existing_user_pwnam, new_user_pwnam]
+
+        result = host.adduser(username, password=password)
+
+        self.assertEqual(result, new_user_pwnam)
+        check_call.assert_called_with([
+            'useradd',
+            '--create-home',
+            '--shell', shell,
+            '--password', password,
+            '-g', username,
+            username
+        ])
+        getpwnam.assert_called_with(username)
+
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_doesnt_add_user_if_it_already_exists(self, log, check_call,
+                                                  getpwnam):
+        username = 'johndoe'
+        password = 'eodnhoj'
+        existing_user_pwnam = 'some user pwnam'
+
+        getpwnam.return_value = existing_user_pwnam
+
+        result = host.adduser(username, password=password)
+
+        self.assertEqual(result, existing_user_pwnam)
+        self.assertFalse(check_call.called)
+        getpwnam.assert_called_with(username)
+
+    @patch('grp.getgrnam')
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adds_a_user_with_different_shell(self, log, check_call, getpwnam,
+                                              getgrnam):
+        username = 'johndoe'
+        password = 'eodnhoj'
+        shell = '/bin/zsh'
+        existing_user_pwnam = KeyError('user not found')
+        new_user_pwnam = 'some user pwnam'
+
+        getpwnam.side_effect = [existing_user_pwnam, new_user_pwnam]
+        getgrnam.side_effect = KeyError('group not found')
+
+        result = host.adduser(username, password=password, shell=shell)
+
+        self.assertEqual(result, new_user_pwnam)
+        check_call.assert_called_with([
+            'useradd',
+            '--create-home',
+            '--shell', shell,
+            '--password', password,
+            username
+        ])
+        getpwnam.assert_called_with(username)
+
+    @patch('grp.getgrnam')
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adduser_with_groups(self, log, check_call, getpwnam, getgrnam):
+        username = 'johndoe'
+        password = 'eodnhoj'
+        shell = '/bin/bash'
+        existing_user_pwnam = KeyError('user not found')
+        new_user_pwnam = 'some user pwnam'
+
+        getpwnam.side_effect = [existing_user_pwnam, new_user_pwnam]
+
+        result = host.adduser(username, password=password,
+                              primary_group='foo', secondary_groups=[
+                                  'bar', 'qux',
+                              ])
+
+        self.assertEqual(result, new_user_pwnam)
+        check_call.assert_called_with([
+            'useradd',
+            '--create-home',
+            '--shell', shell,
+            '--password', password,
+            '-g', 'foo',
+            '-G', 'bar,qux',
+            username
+        ])
+        getpwnam.assert_called_with(username)
+        assert not getgrnam.called
+
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adds_a_systemuser(self, log, check_call, getpwnam):
+        username = 'johndoe'
+        existing_user_pwnam = KeyError('user not found')
+        new_user_pwnam = 'some user pwnam'
+
+        getpwnam.side_effect = [existing_user_pwnam, new_user_pwnam]
+
+        result = host.adduser(username, system_user=True)
+
+        self.assertEqual(result, new_user_pwnam)
+        check_call.assert_called_with([
+            'useradd',
+            '--system',
+            username
+        ])
+        getpwnam.assert_called_with(username)
+
+    @patch('pwd.getpwnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adds_a_systemuser_with_home_dir(self, log, check_call, getpwnam):
+        username = 'johndoe'
+        existing_user_pwnam = KeyError('user not found')
+        new_user_pwnam = 'some user pwnam'
+
+        getpwnam.side_effect = [existing_user_pwnam, new_user_pwnam]
+
+        result = host.adduser(username, system_user=True,
+                              home_dir='/var/lib/johndoe')
+
+        self.assertEqual(result, new_user_pwnam)
+        check_call.assert_called_with([
+            'useradd',
+            '--home',
+            '/var/lib/johndoe',
+            '--system',
+            username
+        ])
+        getpwnam.assert_called_with(username)
+
+    @patch('pwd.getpwnam')
+    @patch('pwd.getpwuid')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_add_user_uid(self, log, check_call, getgrnam, getpwuid, getpwnam):
+        user_name = 'james'
+        user_id = 1111
+        uid_key_error = KeyError('user not found')
+        getpwuid.side_effect = uid_key_error
+        host.adduser(user_name, uid=user_id)
+
+        check_call.assert_called_with([
+            'useradd',
+            '--uid',
+            str(user_id),
+            '--system',
+            '-g',
+            user_name,
+            user_name
+        ])
+        getpwnam.assert_called_with(user_name)
+        getpwuid.assert_called_with(user_id)
+
+    @patch('grp.getgrnam')
+    @patch('grp.getgrgid')
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_add_group_gid(self, log, check_call, getgrgid, getgrnam):
+        group_name = 'darkhorse'
+        group_id = 1005
+        existing_group_gid = KeyError('group not found')
+        new_group_gid = 1006
+        getgrgid.side_effect = [existing_group_gid, new_group_gid]
+
+        host.add_group(group_name, gid=group_id)
+        check_call.assert_called_with([
+            'addgroup',
+            '--gid',
+            str(group_id),
+            '--group',
+            group_name
+        ])
+        getgrgid.assert_called_with(group_id)
+        getgrnam.assert_called_with(group_name)
+
+    @patch('pwd.getpwnam')
+    def test_user_exists_true(self, getpwnam):
+        getpwnam.side_effect = 'pw info'
+        self.assertTrue(host.user_exists('bob'))
+
+    @patch('pwd.getpwnam')
+    def test_user_exists_false(self, getpwnam):
+        getpwnam.side_effect = KeyError('user not found')
+        self.assertFalse(host.user_exists('bob'))
+
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_adds_a_user_to_a_group(self, log, check_call):
+        username = 'foo'
+        group = 'bar'
+
+        host.add_user_to_group(username, group)
+
+        check_call.assert_called_with([
+            'gpasswd', '-a',
+            username,
+            group
+        ])
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_add_a_group_if_it_doesnt_exist_ubuntu(self, check_call,
+                                                   getgrnam, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = KeyError('group not found')
+        new_group_grnam = 'some group grnam'
+
+        getgrnam.side_effect = [existing_group_grnam, new_group_grnam]
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name)
+
+        self.assertEqual(result, new_group_grnam)
+        check_call.assert_called_with(['addgroup', '--group', group_name])
+        getgrnam.assert_called_with(group_name)
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_add_a_group_if_it_doesnt_exist_centos(self, check_call,
+                                                   getgrnam, platform):
+        platform.return_value = 'centos'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = KeyError('group not found')
+        new_group_grnam = 'some group grnam'
+
+        getgrnam.side_effect = [existing_group_grnam, new_group_grnam]
+
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name)
+
+        self.assertEqual(result, new_group_grnam)
+        check_call.assert_called_with(['groupadd', group_name])
+        getgrnam.assert_called_with(group_name)
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_doesnt_add_group_if_it_already_exists_ubuntu(self, check_call,
+                                                          getgrnam, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = 'some group grnam'
+
+        getgrnam.return_value = existing_group_grnam
+
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name)
+
+        self.assertEqual(result, existing_group_grnam)
+        self.assertFalse(check_call.called)
+        getgrnam.assert_called_with(group_name)
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_doesnt_add_group_if_it_already_exists_centos(self, check_call,
+                                                          getgrnam, platform):
+        platform.return_value = 'centos'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = 'some group grnam'
+
+        getgrnam.return_value = existing_group_grnam
+
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name)
+
+        self.assertEqual(result, existing_group_grnam)
+        self.assertFalse(check_call.called)
+        getgrnam.assert_called_with(group_name)
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_add_a_system_group_ubuntu(self, check_call, getgrnam, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = KeyError('group not found')
+        new_group_grnam = 'some group grnam'
+
+        getgrnam.side_effect = [existing_group_grnam, new_group_grnam]
+
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name, system_group=True)
+
+        self.assertEqual(result, new_group_grnam)
+        check_call.assert_called_with([
+            'addgroup',
+            '--system',
+            group_name
+        ])
+        getgrnam.assert_called_with(group_name)
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('grp.getgrnam')
+    @patch('subprocess.check_call')
+    def test_add_a_system_group_centos(self, check_call, getgrnam, platform):
+        platform.return_value = 'centos'
+        imp.reload(host)
+
+        group_name = 'testgroup'
+        existing_group_grnam = KeyError('group not found')
+        new_group_grnam = 'some group grnam'
+
+        getgrnam.side_effect = [existing_group_grnam, new_group_grnam]
+
+        with patch("charmhelpers.core.host.log"):
+            result = host.add_group(group_name, system_group=True)
+
+        self.assertEqual(result, new_group_grnam)
+        check_call.assert_called_with([
+            'groupadd',
+            '-r',
+            group_name
+        ])
+        getgrnam.assert_called_with(group_name)
+
+    @patch('subprocess.check_call')
+    def test_chage_no_chroot(self, check_call):
+        host.chage('usera', expiredate='2019-09-28', maxdays='11')
+        check_call.assert_called_with([
+            'chage',
+            '--expiredate', '2019-09-28',
+            '--maxdays', '11',
+            'usera'
+        ])
+
+    @patch('subprocess.check_call')
+    def test_chage_chroot(self, check_call):
+        host.chage('usera', expiredate='2019-09-28', maxdays='11',
+                   root='mychroot')
+        check_call.assert_called_with([
+            'chage',
+            '--root', 'mychroot',
+            '--expiredate', '2019-09-28',
+            '--maxdays', '11',
+            'usera'
+        ])
+
+    @patch('subprocess.check_call')
+    def test_remove_password_expiry(self, check_call):
+        host.remove_password_expiry('usera')
+        check_call.assert_called_with([
+            'chage',
+            '--expiredate', '-1',
+            '--inactive', '-1',
+            '--mindays', '0',
+            '--maxdays', '-1',
+            'usera'
+        ])
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_rsyncs_a_path(self, log, check_output):
+        from_path = '/from/this/path/foo'
+        to_path = '/to/this/path/bar'
+        check_output.return_value = b' some output '  # Spaces will be stripped
+
+        result = host.rsync(from_path, to_path)
+
+        self.assertEqual(result, 'some output')
+        check_output.assert_called_with(['/usr/bin/rsync', '-r', '--delete',
+                                         '--executability',
+                                         '/from/this/path/foo',
+                                         '/to/this/path/bar'], stderr=subprocess.STDOUT)
+
+    @patch('subprocess.check_call')
+    @patch.object(host, 'log')
+    def test_creates_a_symlink(self, log, check_call):
+        source = '/from/this/path/foo'
+        destination = '/to/this/path/bar'
+
+        host.symlink(source, destination)
+
+        check_call.assert_called_with(['ln', '-sf',
+                                       '/from/this/path/foo',
+                                       '/to/this/path/bar'])
+
+    @patch('pwd.getpwnam')
+    @patch('grp.getgrnam')
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_creates_a_directory_if_it_doesnt_exist(self, os_, log,
+                                                    getgrnam, getpwnam):
+        uid = 123
+        gid = 234
+        owner = 'some-user'
+        group = 'some-group'
+        path = '/some/other/path/from/link'
+        realpath = '/some/path'
+        path_exists = False
+        perms = 0o644
+
+        getpwnam.return_value.pw_uid = uid
+        getgrnam.return_value.gr_gid = gid
+        os_.path.abspath.return_value = realpath
+        os_.path.exists.return_value = path_exists
+
+        host.mkdir(path, owner=owner, group=group, perms=perms)
+
+        getpwnam.assert_called_with('some-user')
+        getgrnam.assert_called_with('some-group')
+        os_.path.abspath.assert_called_with(path)
+        os_.path.exists.assert_called_with(realpath)
+        os_.makedirs.assert_called_with(realpath, perms)
+        os_.chown.assert_called_with(realpath, uid, gid)
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_creates_a_directory_with_defaults(self, os_, log):
+        uid = 0
+        gid = 0
+        path = '/some/other/path/from/link'
+        realpath = '/some/path'
+        path_exists = False
+        perms = 0o555
+
+        os_.path.abspath.return_value = realpath
+        os_.path.exists.return_value = path_exists
+
+        host.mkdir(path)
+
+        os_.path.abspath.assert_called_with(path)
+        os_.path.exists.assert_called_with(realpath)
+        os_.makedirs.assert_called_with(realpath, perms)
+        os_.chown.assert_called_with(realpath, uid, gid)
+
+    @patch('pwd.getpwnam')
+    @patch('grp.getgrnam')
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_removes_file_with_same_path_before_mkdir(self, os_, log,
+                                                      getgrnam, getpwnam):
+        uid = 123
+        gid = 234
+        owner = 'some-user'
+        group = 'some-group'
+        path = '/some/other/path/from/link'
+        realpath = '/some/path'
+        path_exists = True
+        force = True
+        is_dir = False
+        perms = 0o644
+
+        getpwnam.return_value.pw_uid = uid
+        getgrnam.return_value.gr_gid = gid
+        os_.path.abspath.return_value = realpath
+        os_.path.exists.return_value = path_exists
+        os_.path.isdir.return_value = is_dir
+
+        host.mkdir(path, owner=owner, group=group, perms=perms, force=force)
+
+        getpwnam.assert_called_with('some-user')
+        getgrnam.assert_called_with('some-group')
+        os_.path.abspath.assert_called_with(path)
+        os_.path.exists.assert_called_with(realpath)
+        os_.unlink.assert_called_with(realpath)
+        os_.makedirs.assert_called_with(realpath, perms)
+        os_.chown.assert_called_with(realpath, uid, gid)
+
+    @patch('pwd.getpwnam')
+    @patch('grp.getgrnam')
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_writes_content_to_a_file(self, os_, log, getgrnam, getpwnam):
+        # Curly brackets here demonstrate that we are *not* rendering
+        # these strings with Python's string formatting. This is a
+        # change from the original behavior per Bug #1195634.
+        uid = 123
+        gid = 234
+        owner = 'some-user-{foo}'
+        group = 'some-group-{bar}'
+        path = '/some/path/{baz}'
+        contents = b'what is {juju}'
+        perms = 0o644
+        fileno = 'some-fileno'
+
+        getpwnam.return_value.pw_uid = uid
+        getgrnam.return_value.gr_gid = gid
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.fileno.return_value = fileno
+
+            host.write_file(path, contents, owner=owner, group=group,
+                            perms=perms)
+
+            getpwnam.assert_called_with('some-user-{foo}')
+            getgrnam.assert_called_with('some-group-{bar}')
+            mock_open.assert_called_with('/some/path/{baz}', 'wb')
+            os_.fchown.assert_called_with(fileno, uid, gid)
+            os_.fchmod.assert_called_with(fileno, perms)
+            mock_file.write.assert_called_with(b'what is {juju}')
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_writes_content_with_default(self, os_, log):
+        uid = 0
+        gid = 0
+        path = '/some/path/{baz}'
+        fmtstr = b'what is {juju}'
+        perms = 0o444
+        fileno = 'some-fileno'
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.fileno.return_value = fileno
+
+            host.write_file(path, fmtstr)
+
+            mock_open.assert_called_with('/some/path/{baz}', 'wb')
+            os_.fchown.assert_called_with(fileno, uid, gid)
+            os_.fchmod.assert_called_with(fileno, perms)
+            mock_file.write.assert_called_with(b'what is {juju}')
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_does_not_write_duplicate_content(self, os_, log):
+        uid = 0
+        gid = 0
+        path = '/some/path/{baz}'
+        fmtstr = b'what is {juju}'
+        perms = 0o444
+        fileno = 'some-fileno'
+
+        os_.stat.return_value.st_uid = 1
+        os_.stat.return_value.st_gid = 1
+        os_.stat.return_value.st_mode = 0o777
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.fileno.return_value = fileno
+            mock_file.read.return_value = fmtstr
+
+            host.write_file(path, fmtstr)
+
+            self.assertEqual(mock_open.call_count, 1)  # Called to read
+            os_.chown.assert_has_calls([
+                call(path, uid, -1),
+                call(path, -1, gid),
+            ])
+            os_.chmod.assert_called_with(path, perms)
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_only_changes_incorrect_ownership(self, os_, log):
+        uid = 0
+        gid = 0
+        path = '/some/path/{baz}'
+        fmtstr = b'what is {juju}'
+        perms = 0o444
+        fileno = 'some-fileno'
+
+        os_.stat.return_value.st_uid = uid
+        os_.stat.return_value.st_gid = gid
+        os_.stat.return_value.st_mode = perms
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.fileno.return_value = fileno
+            mock_file.read.return_value = fmtstr
+
+            host.write_file(path, fmtstr)
+
+            self.assertEqual(mock_open.call_count, 1)  # Called to read
+            self.assertEqual(os_.chown.call_count, 0)
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'os')
+    def test_writes_binary_contents(self, os_, log):
+        path = '/some/path/{baz}'
+        fmtstr = six.u('what is {juju}\N{TRADE MARK SIGN}').encode('UTF-8')
+        fileno = 'some-fileno'
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.fileno.return_value = fileno
+
+            host.write_file(path, fmtstr)
+
+            mock_open.assert_called_with('/some/path/{baz}', 'wb')
+            mock_file.write.assert_called_with(fmtstr)
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_mounts_a_device(self, log, check_output):
+        device = '/dev/guido'
+        mountpoint = '/mnt/guido'
+        options = 'foo,bar'
+
+        result = host.mount(device, mountpoint, options)
+
+        self.assertTrue(result)
+        check_output.assert_called_with(['mount', '-o', 'foo,bar',
+                                         '/dev/guido', '/mnt/guido'])
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_doesnt_mount_on_error(self, log, check_output):
+        device = '/dev/guido'
+        mountpoint = '/mnt/guido'
+        options = 'foo,bar'
+
+        error = subprocess.CalledProcessError(123, 'mount it', 'Oops...')
+        check_output.side_effect = error
+
+        result = host.mount(device, mountpoint, options)
+
+        self.assertFalse(result)
+        check_output.assert_called_with(['mount', '-o', 'foo,bar',
+                                         '/dev/guido', '/mnt/guido'])
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_mounts_a_device_without_options(self, log, check_output):
+        device = '/dev/guido'
+        mountpoint = '/mnt/guido'
+
+        result = host.mount(device, mountpoint)
+
+        self.assertTrue(result)
+        check_output.assert_called_with(['mount', '/dev/guido', '/mnt/guido'])
+
+    @patch.object(host, 'Fstab')
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_mounts_and_persist_a_device(self, log, check_output, fstab):
+        """Check if a mount works with the persist flag set to True
+        """
+        device = '/dev/guido'
+        mountpoint = '/mnt/guido'
+        options = 'foo,bar'
+
+        result = host.mount(device, mountpoint, options, persist=True)
+
+        self.assertTrue(result)
+        check_output.assert_called_with(['mount', '-o', 'foo,bar',
+                                         '/dev/guido', '/mnt/guido'])
+
+        fstab.add.assert_called_with('/dev/guido', '/mnt/guido', 'ext3',
+                                     options='foo,bar')
+
+        result = host.mount(device, mountpoint, options, persist=True,
+                            filesystem="xfs")
+
+        self.assertTrue(result)
+        fstab.add.assert_called_with('/dev/guido', '/mnt/guido', 'xfs',
+                                     options='foo,bar')
+
+    @patch.object(host, 'Fstab')
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_umounts_a_device(self, log, check_output, fstab):
+        mountpoint = '/mnt/guido'
+
+        result = host.umount(mountpoint, persist=True)
+
+        self.assertTrue(result)
+        check_output.assert_called_with(['umount', mountpoint])
+        fstab.remove_by_mountpoint_called_with(mountpoint)
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_umounts_and_persist_device(self, log, check_output):
+        mountpoint = '/mnt/guido'
+
+        result = host.umount(mountpoint)
+
+        self.assertTrue(result)
+        check_output.assert_called_with(['umount', '/mnt/guido'])
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_doesnt_umount_on_error(self, log, check_output):
+        mountpoint = '/mnt/guido'
+
+        error = subprocess.CalledProcessError(123, 'mount it', 'Oops...')
+        check_output.side_effect = error
+
+        result = host.umount(mountpoint)
+
+        self.assertFalse(result)
+        check_output.assert_called_with(['umount', '/mnt/guido'])
+
+    def test_lists_the_mount_points(self):
+        with patch_open() as (mock_open, mock_file):
+            mock_file.readlines.return_value = MOUNT_LINES
+            result = host.mounts()
+
+            self.assertEqual(result, [
+                ['/', 'rootfs'],
+                ['/sys', 'sysfs'],
+                ['/proc', 'proc'],
+                ['/dev', 'udev'],
+                ['/dev/pts', 'devpts']
+            ])
+            mock_open.assert_called_with('/proc/mounts')
+
+    _hash_files = {
+        '/etc/exists.conf': 'lots of nice ceph configuration',
+        '/etc/missing.conf': None
+    }
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_fstab_mount(self, log, check_output):
+        self.assertTrue(host.fstab_mount('/mnt/mymntpnt'))
+        check_output.assert_called_with(['mount', '/mnt/mymntpnt'])
+
+    @patch('subprocess.check_output')
+    @patch.object(host, 'log')
+    def test_fstab_mount_fail(self, log, check_output):
+        error = subprocess.CalledProcessError(123, 'mount it', 'Oops...')
+        check_output.side_effect = error
+        self.assertFalse(host.fstab_mount('/mnt/mymntpnt'))
+        check_output.assert_called_with(['mount', '/mnt/mymntpnt'])
+
+    @patch('hashlib.md5')
+    @patch('os.path.exists')
+    def test_file_hash_exists(self, exists, md5):
+        filename = '/etc/exists.conf'
+        exists.side_effect = [True]
+        m = md5()
+        m.hexdigest.return_value = self._hash_files[filename]
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.return_value = self._hash_files[filename]
+            result = host.file_hash(filename)
+            self.assertEqual(result, self._hash_files[filename])
+
+    @patch('os.path.exists')
+    def test_file_hash_missing(self, exists):
+        filename = '/etc/missing.conf'
+        exists.side_effect = [False]
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.return_value = self._hash_files[filename]
+            result = host.file_hash(filename)
+            self.assertEqual(result, None)
+
+    @patch('hashlib.sha1')
+    @patch('os.path.exists')
+    def test_file_hash_sha1(self, exists, sha1):
+        filename = '/etc/exists.conf'
+        exists.side_effect = [True]
+        m = sha1()
+        m.hexdigest.return_value = self._hash_files[filename]
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.return_value = self._hash_files[filename]
+            result = host.file_hash(filename, hash_type='sha1')
+            self.assertEqual(result, self._hash_files[filename])
+
+    @patch.object(host, 'file_hash')
+    def test_check_hash(self, file_hash):
+        file_hash.return_value = 'good-hash'
+        self.assertRaises(host.ChecksumError, host.check_hash,
+                          'file', 'bad-hash')
+        host.check_hash('file', 'good-hash', 'sha256')
+        self.assertEqual(file_hash.call_args_list, [
+            call('file', 'md5'),
+            call('file', 'sha256'),
+        ])
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_restart_no_changes(self, iglob, exists, service):
+        file_name = '/etc/missing.conf'
+        restart_map = {
+            file_name: ['test-service']
+        }
+        iglob.return_value = []
+
+        @host.restart_on_change(restart_map)
+        def make_no_changes():
+            pass
+
+        make_no_changes()
+
+        assert not service.called
+        assert not exists.called
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_restart_on_change(self, iglob, exists, service):
+        file_name = '/etc/missing.conf'
+        restart_map = {
+            file_name: ['test-service']
+        }
+        iglob.side_effect = [[], [file_name]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes(mock_file):
+            mock_file.read.return_value = b"newstuff"
+
+        with patch_open() as (mock_open, mock_file):
+            make_some_changes(mock_file)
+
+        for service_name in restart_map[file_name]:
+            service.assert_called_with('restart', service_name)
+
+        exists.assert_has_calls([
+            call(file_name),
+        ])
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_multiservice_restart_on_change(self, iglob, exists, service):
+        file_name_one = '/etc/missing.conf'
+        file_name_two = '/etc/exists.conf'
+        restart_map = {
+            file_name_one: ['test-service'],
+            file_name_two: ['test-service', 'test-service2']
+        }
+        iglob.side_effect = [[], [file_name_two],
+                             [file_name_one], [file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'exists', b'missing', b'exists2']
+            make_some_changes()
+
+        # Restart should only happen once per service
+        for svc in ['test-service2', 'test-service']:
+            c = call('restart', svc)
+            self.assertEquals(1, service.call_args_list.count(c))
+
+        exists.assert_has_calls([
+            call(file_name_one),
+            call(file_name_two)
+        ])
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_multiservice_restart_on_change_in_order(self, iglob, exists,
+                                                     service):
+        file_name_one = '/etc/cinder/cinder.conf'
+        file_name_two = '/etc/haproxy/haproxy.conf'
+        restart_map = OrderedDict([
+            (file_name_one, ['some-api']),
+            (file_name_two, ['haproxy'])
+        ])
+        iglob.side_effect = [[], [file_name_two],
+                             [file_name_one], [file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'exists', b'missing', b'exists2']
+            make_some_changes()
+
+        # Restarts should happen in the order they are described in the
+        # restart map.
+        expected = [
+            call('restart', 'some-api'),
+            call('restart', 'haproxy')
+        ]
+        self.assertEquals(expected, service.call_args_list)
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_glob_no_restart(self, iglob, exists, service):
+        glob_path = '/etc/service/*.conf'
+        file_name_one = '/etc/service/exists.conf'
+        file_name_two = '/etc/service/exists2.conf'
+        restart_map = {
+            glob_path: ['service']
+        }
+        iglob.side_effect = [[file_name_one, file_name_two],
+                             [file_name_one, file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'content', b'content2',
+                                          b'content', b'content2']
+            make_some_changes()
+
+        self.assertEquals([], service.call_args_list)
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_glob_restart_on_change(self, iglob, exists, service):
+        glob_path = '/etc/service/*.conf'
+        file_name_one = '/etc/service/exists.conf'
+        file_name_two = '/etc/service/exists2.conf'
+        restart_map = {
+            glob_path: ['service']
+        }
+        iglob.side_effect = [[file_name_one, file_name_two],
+                             [file_name_one, file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'content', b'content2',
+                                          b'changed', b'content2']
+            make_some_changes()
+
+        self.assertEquals([call('restart', 'service')], service.call_args_list)
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_glob_restart_on_create(self, iglob, exists, service):
+        glob_path = '/etc/service/*.conf'
+        file_name_one = '/etc/service/exists.conf'
+        file_name_two = '/etc/service/missing.conf'
+        restart_map = {
+            glob_path: ['service']
+        }
+        iglob.side_effect = [[file_name_one],
+                             [file_name_one, file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'exists',
+                                          b'exists', b'created']
+            make_some_changes()
+
+        self.assertEquals([call('restart', 'service')], service.call_args_list)
+
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_glob_restart_on_delete(self, iglob, exists, service):
+        glob_path = '/etc/service/*.conf'
+        file_name_one = '/etc/service/exists.conf'
+        file_name_two = '/etc/service/exists2.conf'
+        restart_map = {
+            glob_path: ['service']
+        }
+        iglob.side_effect = [[file_name_one, file_name_two],
+                             [file_name_two]]
+        exists.return_value = True
+
+        @host.restart_on_change(restart_map)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'exists', b'exists2',
+                                          b'exists2']
+            make_some_changes()
+
+        self.assertEquals([call('restart', 'service')], service.call_args_list)
+
+    @patch.object(host, 'service_reload')
+    @patch.object(host, 'service')
+    @patch('os.path.exists')
+    @patch('glob.iglob')
+    def test_restart_on_change_restart_functs(self, iglob, exists, service,
+                                              service_reload):
+        file_name_one = '/etc/cinder/cinder.conf'
+        file_name_two = '/etc/haproxy/haproxy.conf'
+        restart_map = OrderedDict([
+            (file_name_one, ['some-api']),
+            (file_name_two, ['haproxy'])
+        ])
+        iglob.side_effect = [[], [file_name_two],
+                             [file_name_one], [file_name_two]]
+        exists.return_value = True
+
+        restart_funcs = {
+            'some-api': service_reload,
+        }
+
+        @host.restart_on_change(restart_map, restart_functions=restart_funcs)
+        def make_some_changes():
+            pass
+
+        with patch_open() as (mock_open, mock_file):
+            mock_file.read.side_effect = [b'exists', b'missing', b'exists2']
+            make_some_changes()
+
+        self.assertEquals([call('restart', 'haproxy')], service.call_args_list)
+        self.assertEquals([call('some-api')], service_reload.call_args_list)
+
+    @patch.object(osplatform, 'get_platform')
+    def test_lsb_release_ubuntu(self, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(host)
+
+        result = {
+            "DISTRIB_ID": "Ubuntu",
+            "DISTRIB_RELEASE": "13.10",
+            "DISTRIB_CODENAME": "saucy",
+            "DISTRIB_DESCRIPTION": "\"Ubuntu Saucy Salamander "
+                                   "(development branch)\""
+        }
+        with mocked_open('/etc/lsb-release', LSB_RELEASE):
+            lsb_release = host.lsb_release()
+            for key in result:
+                self.assertEqual(result[key], lsb_release[key])
+
+    @patch.object(osplatform, 'get_platform')
+    def test_lsb_release_centos(self, platform):
+        platform.return_value = 'centos'
+        imp.reload(host)
+
+        result = {
+            'NAME': '"CentOS Linux"',
+            'ANSI_COLOR': '"0;31"',
+            'ID_LIKE': '"rhel fedora"',
+            'VERSION_ID': '"7"',
+            'BUG_REPORT_URL': '"https://bugs.centos.org/"',
+            'CENTOS_MANTISBT_PROJECT': '"CentOS-7"',
+            'PRETTY_NAME': '"CentOS Linux 7 (Core)"',
+            'VERSION': '"7 (Core)"',
+            'REDHAT_SUPPORT_PRODUCT_VERSION': '"7"',
+            'CENTOS_MANTISBT_PROJECT_VERSION': '"7"',
+            'REDHAT_SUPPORT_PRODUCT': '"centos"',
+            'HOME_URL': '"https://www.centos.org/"',
+            'CPE_NAME': '"cpe:/o:centos:centos:7"',
+            'ID': '"centos"'
+        }
+        with mocked_open('/etc/os-release', OS_RELEASE):
+            lsb_release = host.lsb_release()
+            for key in result:
+                self.assertEqual(result[key], lsb_release[key])
+
+    def test_pwgen(self):
+        pw = host.pwgen()
+        self.assert_(len(pw) >= 35, 'Password is too short')
+
+        pw = host.pwgen(10)
+        self.assertEqual(len(pw), 10, 'Password incorrect length')
+
+        pw2 = host.pwgen(10)
+        self.assertNotEqual(pw, pw2, 'Duplicated password')
+
+    @patch.object(host, 'glob')
+    @patch('os.path.realpath')
+    @patch('os.path.isdir')
+    def test_is_phy_iface(self, mock_isdir, mock_realpath, mock_glob):
+        mock_isdir.return_value = True
+        mock_glob.glob.return_value = ['/sys/class/net/eth0',
+                                       '/sys/class/net/veth0']
+
+        def fake_realpath(soft):
+            if soft.endswith('/eth0'):
+                hard = ('/sys/devices/pci0000:00/0000:00:1c.4'
+                        '/0000:02:00.1/net/eth0')
+            else:
+                hard = '/sys/devices/virtual/net/veth0'
+
+            return hard
+
+        mock_realpath.side_effect = fake_realpath
+        self.assertTrue(host.is_phy_iface('eth0'))
+        self.assertFalse(host.is_phy_iface('veth0'))
+
+    @patch('os.path.exists')
+    @patch('os.path.realpath')
+    @patch('os.path.isdir')
+    def test_get_bond_master(self, mock_isdir, mock_realpath, mock_exists):
+        mock_isdir.return_value = True
+
+        def fake_realpath(soft):
+            if soft.endswith('/eth0'):
+                return ('/sys/devices/pci0000:00/0000:00:1c.4'
+                        '/0000:02:00.1/net/eth0')
+            elif soft.endswith('/br0'):
+                return '/sys/devices/virtual/net/br0'
+            elif soft.endswith('/master'):
+                return '/sys/devices/virtual/net/bond0'
+
+            return None
+
+        def fake_exists(path):
+            return True
+
+        mock_exists.side_effect = fake_exists
+        mock_realpath.side_effect = fake_realpath
+        self.assertEqual(host.get_bond_master('eth0'), 'bond0')
+        self.assertIsNone(host.get_bond_master('br0'))
+
+    @patch('subprocess.check_output')
+    def test_list_nics(self, check_output):
+        check_output.return_value = IP_LINES
+        nics = host.list_nics()
+        self.assertEqual(nics, ['eth0', 'eth1', 'eth0.10', 'eth100'])
+        nics = host.list_nics('eth')
+        self.assertEqual(nics, ['eth0', 'eth1', 'eth0.10', 'eth100'])
+        nics = host.list_nics(['eth'])
+        self.assertEqual(nics, ['eth0', 'eth1', 'eth0.10', 'eth100'])
+
+    @patch('subprocess.check_output')
+    def test_list_nics_with_bonds(self, check_output):
+        check_output.return_value = IP_LINE_BONDS
+        nics = host.list_nics('bond')
+        self.assertEqual(nics, ['bond0.10', ])
+
+    @patch('subprocess.check_output')
+    def test_get_nic_mtu_with_bonds(self, check_output):
+        check_output.return_value = IP_LINE_BONDS
+        nic = "bond0.10"
+        mtu = host.get_nic_mtu(nic)
+        self.assertEqual(mtu, '1500')
+
+    @patch('subprocess.check_call')
+    def test_set_nic_mtu(self, mock_call):
+        mock_call.return_value = 0
+        nic = 'eth7'
+        mtu = '1546'
+        host.set_nic_mtu(nic, mtu)
+        mock_call.assert_called_with(['ip', 'link', 'set', nic, 'mtu', mtu])
+
+    @patch('subprocess.check_output')
+    def test_get_nic_mtu(self, check_output):
+        check_output.return_value = IP_LINE_ETH0
+        nic = "eth0"
+        mtu = host.get_nic_mtu(nic)
+        self.assertEqual(mtu, '1500')
+
+    @patch('subprocess.check_output')
+    def test_get_nic_mtu_vlan(self, check_output):
+        check_output.return_value = IP_LINE_ETH0_VLAN
+        nic = "eth0.10"
+        mtu = host.get_nic_mtu(nic)
+        self.assertEqual(mtu, '1500')
+
+    @patch('subprocess.check_output')
+    def test_get_nic_hwaddr(self, check_output):
+        check_output.return_value = IP_LINE_HWADDR
+        nic = "eth0"
+        hwaddr = host.get_nic_hwaddr(nic)
+        self.assertEqual(hwaddr, 'e4:11:5b:ab:a7:3c')
+
+    @patch('charmhelpers.core.host_factory.ubuntu.lsb_release')
+    def test_get_distrib_codename(self, lsb_release):
+        lsb_release.return_value = {'DISTRIB_CODENAME': 'bionic'}
+        self.assertEqual(host.get_distrib_codename(), 'bionic')
+
+    @patch.object(osplatform, 'get_platform')
+    @patch.object(ubuntu_apt_pkg, 'Cache')
+    def test_cmp_pkgrevno_revnos_ubuntu(self, pkg_cache, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(host)
+
+        class MockPackage:
+            class MockPackageRevno:
+                def __init__(self, ver_str):
+                    self.ver_str = ver_str
+
+            def __init__(self, current_ver):
+                self.current_ver = self.MockPackageRevno(current_ver)
+
+        pkg_dict = {
+            'python': MockPackage('2.4')
+        }
+        pkg_cache.return_value = pkg_dict
+        self.assertEqual(host.cmp_pkgrevno('python', '2.3'), 1)
+        self.assertEqual(host.cmp_pkgrevno('python', '2.4'), 0)
+        self.assertEqual(host.cmp_pkgrevno('python', '2.5'), -1)
+
+    @patch.object(osplatform, 'get_platform')
+    def test_cmp_pkgrevno_revnos_centos(self, platform):
+        platform.return_value = 'centos'
+        imp.reload(host)
+
+        class MockPackage:
+            def __init__(self, name, version):
+                self.Name = name
+                self.version = version
+
+        yum_dict = {
+            'installed': {
+                MockPackage('python', '2.4')
+            }
+        }
+
+        import yum
+        yum.YumBase.return_value.doPackageLists.return_value = (
+            yum_dict)
+
+        self.assertEqual(host.cmp_pkgrevno('python', '2.3'), 1)
+        self.assertEqual(host.cmp_pkgrevno('python', '2.4'), 0)
+        self.assertEqual(host.cmp_pkgrevno('python', '2.5'), -1)
+
+    @patch.object(host.os, 'stat')
+    @patch.object(host.pwd, 'getpwuid')
+    @patch.object(host.grp, 'getgrgid')
+    @patch('posix.stat_result')
+    def test_owner(self, stat_result_, getgrgid_, getpwuid_, stat_):
+        getgrgid_.return_value = ['testgrp']
+        getpwuid_.return_value = ['testuser']
+        stat_.return_value = stat_result_()
+
+        user, group = host.owner('/some/path')
+        stat_.assert_called_once_with('/some/path')
+        self.assertEqual('testuser', user)
+        self.assertEqual('testgrp', group)
+
+    def test_get_total_ram(self):
+        raw = dedent('''\
+                     MemFree:          183868 kB
+                     MemTotal:        7096108 kB
+                     MemAvailable:    5645240 kB
+                     ''').strip()
+        with patch_open() as (mock_open, mock_file):
+            mock_file.readlines.return_value = raw.splitlines()
+            self.assertEqual(host.get_total_ram(), 7266414592)  # 7GB
+            mock_open.assert_called_once_with('/proc/meminfo', 'r')
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_is_container_with_systemd_container(self,
+                                                 call,
+                                                 init_is_systemd,
+                                                 mock_os):
+        init_is_systemd.return_value = True
+        call.return_value = 0
+        self.assertTrue(host.is_container())
+        call.assert_called_with(['systemd-detect-virt', '--container'])
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_is_container_with_systemd_non_container(self,
+                                                     call,
+                                                     init_is_systemd,
+                                                     mock_os):
+        init_is_systemd.return_value = True
+        call.return_value = 1
+        self.assertFalse(host.is_container())
+        call.assert_called_with(['systemd-detect-virt', '--container'])
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_is_container_with_upstart_container(self,
+                                                 call,
+                                                 init_is_systemd,
+                                                 mock_os):
+        init_is_systemd.return_value = False
+        mock_os.path.exists.return_value = True
+        self.assertTrue(host.is_container())
+        mock_os.path.exists.assert_called_with('/run/container_type')
+
+    @patch.object(host, 'os')
+    @patch.object(host, 'init_is_systemd')
+    @patch('subprocess.call')
+    def test_is_container_with_upstart_not_container(self,
+                                                     call,
+                                                     init_is_systemd,
+                                                     mock_os):
+        init_is_systemd.return_value = False
+        mock_os.path.exists.return_value = False
+        self.assertFalse(host.is_container())
+        mock_os.path.exists.assert_called_with('/run/container_type')
+
+    def test_updatedb(self):
+        updatedb_text = 'PRUNEPATHS="/tmp"'
+        self.assertEqual(host.updatedb(updatedb_text, '/srv/node'),
+                         'PRUNEPATHS="/tmp /srv/node"')
+
+    def test_no_change_updatedb(self):
+        updatedb_text = 'PRUNEPATHS="/tmp /srv/node"'
+        self.assertEqual(host.updatedb(updatedb_text, '/srv/node'),
+                         updatedb_text)
+
+    def test_no_prunepaths(self):
+        updatedb_text = 'PRUNE_BIND_MOUNTS="yes"'
+        self.assertEqual(host.updatedb(updatedb_text, '/srv/node'),
+                         updatedb_text)
+
+    def test_write_updatedb(self):
+        _open = mock_open(read_data='PRUNEPATHS="/tmp /srv/node"')
+        with patch('charmhelpers.core.host.open', _open, create=True):
+            host.add_to_updatedb_prunepath("/tmp/test")
+        handle = _open()
+
+        self.assertTrue(handle.read.call_count == 1)
+        self.assertTrue(handle.seek.call_count == 1)
+        handle.write.assert_called_once_with(
+            'PRUNEPATHS="/tmp /srv/node /tmp/test"')
+
+    @patch.object(host, 'os')
+    def test_prunepaths_no_updatedb_conf_file(self, mock_os):
+        mock_os.path.exists.return_value = False
+        _open = mock_open(read_data='PRUNEPATHS="/tmp /srv/node"')
+        with patch('charmhelpers.core.host.open', _open, create=True):
+            host.add_to_updatedb_prunepath("/tmp/test")
+        handle = _open()
+
+        self.assertTrue(handle.call_count == 0)
+
+    @patch.object(host, 'os')
+    def test_prunepaths_updatedb_conf_file_isdir(self, mock_os):
+        mock_os.path.exists.return_value = True
+        mock_os.path.isdir.return_value = True
+        _open = mock_open(read_data='PRUNEPATHS="/tmp /srv/node"')
+        with patch('charmhelpers.core.host.open', _open, create=True):
+            host.add_to_updatedb_prunepath("/tmp/test")
+        handle = _open()
+
+        self.assertTrue(handle.call_count == 0)
+
+    @patch.object(host, 'local_unit')
+    def test_modulo_distribution(self, local_unit):
+        local_unit.return_value = 'test/7'
+
+        # unit % modulo * wait
+        self.assertEqual(host.modulo_distribution(modulo=6, wait=10), 10)
+
+        # Zero wait when unit % modulo == 0
+        self.assertEqual(host.modulo_distribution(modulo=7, wait=10), 0)
+
+        # modulo * wait when unit % modulo == 0 and non_zero_wait=True
+        self.assertEqual(host.modulo_distribution(modulo=7, wait=10,
+                                                  non_zero_wait=True),
+                         70)
+
+    @patch.object(host, 'log')
+    @patch.object(host, 'charm_name')
+    @patch.object(host, 'write_file')
+    @patch.object(subprocess, 'check_call')
+    @patch.object(host, 'file_hash')
+    @patch('hashlib.md5')
+    def test_install_ca_cert_new_cert(self, md5, file_hash, check_call,
+                                      write_file, charm_name, log):
+        file_hash.return_value = 'old_hash'
+        charm_name.return_value = 'charm-name'
+
+        md5().hexdigest.return_value = 'old_hash'
+        host.install_ca_cert('cert_data')
+        assert not check_call.called
+
+        md5().hexdigest.return_value = 'new_hash'
+        host.install_ca_cert(None)
+        assert not check_call.called
+        host.install_ca_cert('')
+        assert not check_call.called
+
+        host.install_ca_cert('cert_data', 'name')
+        write_file.assert_called_with(
+            '/usr/local/share/ca-certificates/name.crt',
+            b'cert_data')
+        check_call.assert_called_with(['update-ca-certificates', '--fresh'])
+
+        host.install_ca_cert('cert_data')
+        write_file.assert_called_with(
+            '/usr/local/share/ca-certificates/juju-charm-name.crt',
+            b'cert_data')
+        check_call.assert_called_with(['update-ca-certificates', '--fresh'])
+
+    @patch('subprocess.check_output')
+    def test_arch(self, check_output):
+        _ = host.arch()
+        check_output.assert_called_with(
+            ['dpkg', '--print-architecture']
+        )
+
+    @patch('subprocess.check_output')
+    def test_get_system_env(self, check_output):
+        check_output.return_value = ''
+        self.assertEquals(
+            host.get_system_env('aKey', 'aDefault'), 'aDefault')
+        self.assertEquals(host.get_system_env('aKey'), None)
+        check_output.return_value = 'aKey=aValue\n'
+        self.assertEquals(
+            host.get_system_env('aKey', 'aDefault'), 'aValue')
+        check_output.return_value = 'otherKey=shell=wicked\n'
+        self.assertEquals(
+            host.get_system_env('otherKey', 'aDefault'), 'shell=wicked')
+
+
+class TestHostCompator(TestCase):
+
+    def test_compare_ubuntu_releases(self):
+        from charmhelpers.osplatform import get_platform
+        if get_platform() == 'ubuntu':
+            self.assertTrue(host.CompareHostReleases('yakkety') < 'zesty')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hugepage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hugepage.py
new file mode 100644
index 0000000000000000000000000000000000000000..69ab9b285f97d4df24b6d4322672925ac79e46cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_hugepage.py
@@ -0,0 +1,118 @@
+from testtools import TestCase
+from mock import patch
+from charmhelpers.core import hugepage
+import yaml
+
+TO_PATCH = [
+    'fstab',
+    'add_group',
+    'add_user_to_group',
+    'sysctl',
+    'fstab_mount',
+    'mkdir',
+    'check_output',
+]
+
+
+class Group(object):
+    def __init__(self):
+        self.gr_gid = '1010'
+
+
+class HugepageTests(TestCase):
+
+    def setUp(self):
+        super(HugepageTests, self).setUp()
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.core.hugepage.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    def test_hugepage_support(self):
+        self.add_group.return_value = Group()
+        self.fstab.Fstab().get_entry_by_attr.return_value = 'old fstab entry'
+        self.fstab.Fstab().Entry.return_value = 'new fstab entry'
+        hugepage.hugepage_support('nova')
+        sysctl_expect = ("""
+vm.hugetlb_shm_group: '1010'
+vm.max_map_count: 65536
+vm.nr_hugepages: 256
+""".lstrip())
+        self.sysctl.create.assert_called_with(sysctl_expect,
+                                              '/etc/sysctl.d/10-hugepage.conf')
+        self.mkdir.assert_called_with('/run/hugepages/kvm', owner='root',
+                                      group='root', perms=0o755, force=False)
+        self.fstab.Fstab().remove_entry.assert_called_with('old fstab entry')
+        self.fstab.Fstab().Entry.assert_called_with(
+            'nodev', '/run/hugepages/kvm', 'hugetlbfs',
+            'mode=1770,gid=1010,pagesize=2MB', 0, 0)
+        self.fstab.Fstab().add_entry.assert_called_with('new fstab entry')
+        self.fstab_mount.assert_called_with('/run/hugepages/kvm')
+
+    def test_hugepage_support_new_mnt(self):
+        self.add_group.return_value = Group()
+        self.fstab.Fstab().get_entry_by_attr.return_value = None
+        self.fstab.Fstab().Entry.return_value = 'new fstab entry'
+        hugepage.hugepage_support('nova')
+        self.assertEqual(self.fstab.Fstab().remove_entry.call_args_list, [])
+
+    def test_hugepage_support_no_automount(self):
+        self.add_group.return_value = Group()
+        self.fstab.Fstab().get_entry_by_attr.return_value = None
+        self.fstab.Fstab().Entry.return_value = 'new fstab entry'
+        hugepage.hugepage_support('nova', mount=False)
+        self.assertEqual(self.fstab_mount.call_args_list, [])
+
+    def test_hugepage_support_nodefaults(self):
+        self.add_group.return_value = Group()
+        self.fstab.Fstab().get_entry_by_attr.return_value = 'old fstab entry'
+        self.fstab.Fstab().Entry.return_value = 'new fstab entry'
+        hugepage.hugepage_support(
+            'nova', group='neutron', nr_hugepages=512, max_map_count=70000,
+            mnt_point='/hugepages', pagesize='1G', mount=False)
+        sysctl_expect = {
+            'vm.hugetlb_shm_group': '1010',
+            'vm.max_map_count': 70000,
+            'vm.nr_hugepages': 512,
+        }
+        sysctl_setting_arg = self.sysctl.create.call_args_list[0][0][0]
+        self.assertEqual(yaml.safe_load(sysctl_setting_arg), sysctl_expect)
+        self.mkdir.assert_called_with('/hugepages', owner='root',
+                                      group='root', perms=0o755, force=False)
+        self.fstab.Fstab().remove_entry.assert_called_with('old fstab entry')
+        self.fstab.Fstab().Entry.assert_called_with(
+            'nodev', '/hugepages', 'hugetlbfs',
+            'mode=1770,gid=1010,pagesize=1G', 0, 0)
+        self.fstab.Fstab().add_entry.assert_called_with('new fstab entry')
+
+    def test_hugepage_support_set_shmmax(self):
+        self.add_group.return_value = Group()
+        self.fstab.Fstab().get_entry_by_attr.return_value = None
+        self.fstab.Fstab().Entry.return_value = 'new fstab entry'
+        self.check_output.return_value = 2000
+        hugepage.hugepage_support('nova', mount=False, set_shmmax=True)
+        sysctl_expect = {
+            'kernel.shmmax': 536870912,
+            'vm.hugetlb_shm_group': '1010',
+            'vm.max_map_count': 65536,
+            'vm.nr_hugepages': 256
+        }
+        sysctl_setting_arg = self.sysctl.create.call_args_list[0][0][0]
+        self.assertEqual(yaml.safe_load(sysctl_setting_arg), sysctl_expect)
+
+    def test_hugepage_support_auto_increase_max_map_count(self):
+        self.add_group.return_value = Group()
+        hugepage.hugepage_support(
+            'nova', group='neutron', nr_hugepages=512, max_map_count=200,
+            mnt_point='/hugepages', pagesize='1G', mount=False)
+        sysctl_expect = {
+            'vm.hugetlb_shm_group': '1010',
+            'vm.max_map_count': 1024,
+            'vm.nr_hugepages': 512,
+        }
+        sysctl_setting_arg = self.sysctl.create.call_args_list[0][0][0]
+        self.assertEqual(yaml.safe_load(sysctl_setting_arg), sysctl_expect)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_kernel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_kernel.py
new file mode 100644
index 0000000000000000000000000000000000000000..9da19988dc19fe8e86cd058070d4a38796a205f0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_kernel.py
@@ -0,0 +1,113 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+import unittest
+import imp
+
+from charmhelpers import osplatform
+from mock import patch
+from tests.helpers import patch_open
+from charmhelpers.core import kernel
+
+
+class TestKernel(unittest.TestCase):
+
+    @patch('subprocess.check_call')
+    @patch.object(osplatform, 'get_platform')
+    def test_modprobe_persistent_ubuntu(self, platform, check_call):
+        platform.return_value = 'ubuntu'
+        imp.reload(kernel)
+
+        with patch_open() as (_open, _file):
+            _file.read.return_value = 'anothermod\n'
+            with patch("charmhelpers.core.kernel.log"):
+                kernel.modprobe('mymod')
+            _open.assert_called_with('/etc/modules', 'r+')
+            _file.read.assert_called_with()
+            _file.write.assert_called_with('mymod\n')
+        check_call.assert_called_with(['modprobe', 'mymod'])
+
+    @patch('os.chmod')
+    @patch('subprocess.check_call')
+    @patch.object(osplatform, 'get_platform')
+    def test_modprobe_persistent_centos(self, platform, check_call, os):
+        platform.return_value = 'centos'
+        imp.reload(kernel)
+
+        with patch_open() as (_open, _file):
+            _file.read.return_value = 'anothermod\n'
+            with patch("charmhelpers.core.kernel.log"):
+                kernel.modprobe('mymod')
+            _open.assert_called_with('/etc/rc.modules', 'r+')
+            os.assert_called_with('/etc/rc.modules', 111)
+            _file.read.assert_called_with()
+            _file.write.assert_called_with('modprobe mymod\n')
+        check_call.assert_called_with(['modprobe', 'mymod'])
+
+    @patch('subprocess.check_call')
+    @patch.object(osplatform, 'get_platform')
+    def test_modprobe_not_persistent_ubuntu(self, platform, check_call):
+        platform.return_value = 'ubuntu'
+        imp.reload(kernel)
+
+        with patch_open() as (_open, _file):
+            _file.read.return_value = 'anothermod\n'
+            with patch("charmhelpers.core.kernel.log"):
+                kernel.modprobe('mymod', persist=False)
+            assert not _open.called
+        check_call.assert_called_with(['modprobe', 'mymod'])
+
+    @patch('subprocess.check_call')
+    @patch.object(osplatform, 'get_platform')
+    def test_modprobe_not_persistent_centos(self, platform, check_call):
+        platform.return_value = 'centos'
+        imp.reload(kernel)
+
+        with patch_open() as (_open, _file):
+            _file.read.return_value = 'anothermod\n'
+            with patch("charmhelpers.core.kernel.log"):
+                kernel.modprobe('mymod', persist=False)
+            assert not _open.called
+        check_call.assert_called_with(['modprobe', 'mymod'])
+
+    @patch.object(kernel, 'log')
+    @patch('subprocess.check_call')
+    def test_rmmod_not_forced(self, check_call, log):
+        kernel.rmmod('mymod')
+        check_call.assert_called_with(['rmmod', 'mymod'])
+
+    @patch.object(kernel, 'log')
+    @patch('subprocess.check_call')
+    def test_rmmod_forced(self, check_call, log):
+        kernel.rmmod('mymod', force=True)
+        check_call.assert_called_with(['rmmod', '-f', 'mymod'])
+
+    @patch.object(kernel, 'log')
+    @patch('subprocess.check_output')
+    def test_lsmod(self, check_output, log):
+        kernel.lsmod()
+        check_output.assert_called_with(['lsmod'],
+                                        universal_newlines=True)
+
+    @patch('charmhelpers.core.kernel.lsmod')
+    def test_is_module_loaded(self, lsmod):
+        lsmod.return_value = "ip6_tables 28672  1 ip6table_filter"
+        self.assertTrue(kernel.is_module_loaded("ip6_tables"))
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('subprocess.check_call')
+    def test_update_initramfs_ubuntu(self, check_call, platform):
+        platform.return_value = 'ubuntu'
+        imp.reload(kernel)
+
+        kernel.update_initramfs()
+        check_call.assert_called_with(["update-initramfs", "-k", "all", "-u"])
+
+    @patch.object(osplatform, 'get_platform')
+    @patch('subprocess.check_call')
+    def test_update_initramfs_centos(self, check_call, platform):
+        platform.return_value = 'centos'
+        imp.reload(kernel)
+
+        kernel.update_initramfs()
+        check_call.assert_called_with(['dracut', '-f', 'all'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_services.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_services.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f6935301182e9dbe1cddd17e270dd9cbc51bb8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_services.py
@@ -0,0 +1,868 @@
+import os
+import mock
+import unittest
+import uuid
+from charmhelpers.core import hookenv
+from charmhelpers.core import host
+from charmhelpers.core import services
+from functools import partial
+
+
+class TestServiceManager(unittest.TestCase):
+    def setUp(self):
+        self.pcharm_dir = mock.patch.object(hookenv, 'charm_dir')
+        self.mcharm_dir = self.pcharm_dir.start()
+        self.mcharm_dir.return_value = 'charm_dir'
+
+    def tearDown(self):
+        self.pcharm_dir.stop()
+
+    def test_register(self):
+        manager = services.ServiceManager([
+            {'service': 'service1',
+             'foo': 'bar'},
+            {'service': 'service2',
+             'qux': 'baz'},
+        ])
+        self.assertEqual(manager.services, {
+            'service1': {'service': 'service1',
+                         'foo': 'bar'},
+            'service2': {'service': 'service2',
+                         'qux': 'baz'},
+        })
+
+    def test_register_preserves_order(self):
+        service_list = [dict(service='a'), dict(service='b')]
+
+        # Test that the services list order is preserved by checking
+        # both forwards and backwards - only one of these will be
+        # dictionary order, and if both work we know order is being
+        # preserved.
+        manager = services.ServiceManager(service_list)
+        self.assertEqual(list(manager.services.keys()), ['a', 'b'])
+        manager = services.ServiceManager(reversed(service_list))
+        self.assertEqual(list(manager.services.keys()), ['b', 'a'])
+
+    @mock.patch.object(services.ServiceManager, 'reconfigure_services')
+    @mock.patch.object(services.ServiceManager, 'stop_services')
+    @mock.patch.object(hookenv, 'hook_name')
+    @mock.patch.object(hookenv, 'config')
+    def test_manage_stop(self, config, hook_name, stop_services, reconfigure_services):
+        manager = services.ServiceManager()
+        hook_name.return_value = 'stop'
+        manager.manage()
+        stop_services.assert_called_once_with()
+        assert not reconfigure_services.called
+
+    @mock.patch.object(services.ServiceManager, 'provide_data')
+    @mock.patch.object(services.ServiceManager, 'reconfigure_services')
+    @mock.patch.object(services.ServiceManager, 'stop_services')
+    @mock.patch.object(hookenv, 'hook_name')
+    @mock.patch.object(hookenv, 'config')
+    def test_manage_other(self, config, hook_name, stop_services, reconfigure_services, provide_data):
+        manager = services.ServiceManager()
+        hook_name.return_value = 'config-changed'
+        manager.manage()
+        assert not stop_services.called
+        reconfigure_services.assert_called_once_with()
+        provide_data.assert_called_once_with()
+
+    def test_manage_calls_atstart(self):
+        cb = mock.MagicMock()
+        hookenv.atstart(cb)
+        manager = services.ServiceManager()
+        manager.manage()
+        self.assertTrue(cb.called)
+
+    def test_manage_calls_atexit(self):
+        cb = mock.MagicMock()
+        hookenv.atexit(cb)
+        manager = services.ServiceManager()
+        manager.manage()
+        self.assertTrue(cb.called)
+
+    @mock.patch.object(hookenv, 'config')
+    def test_manage_config_not_saved(self, config):
+        config = config.return_value
+        config.implicit_save = False
+        manager = services.ServiceManager()
+        manager.manage()
+        self.assertFalse(config.save.called)
+
+    @mock.patch.object(services.ServiceManager, 'save_ready')
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    @mock.patch.object(services.ServiceManager, 'is_ready')
+    def test_reconfigure_ready(self, is_ready, fire_event, save_ready):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        is_ready.return_value = True
+        manager.reconfigure_services()
+        is_ready.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+        fire_event.assert_has_calls([
+            mock.call('data_ready', 'service1'),
+            mock.call('start', 'service1', default=[
+                services.service_restart,
+                services.manage_ports]),
+        ], any_order=False)
+        fire_event.assert_has_calls([
+            mock.call('data_ready', 'service2'),
+            mock.call('start', 'service2', default=[
+                services.service_restart,
+                services.manage_ports]),
+        ], any_order=False)
+        save_ready.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+
+    @mock.patch.object(services.ServiceManager, 'save_ready')
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    @mock.patch.object(services.ServiceManager, 'is_ready')
+    def test_reconfigure_ready_list(self, is_ready, fire_event, save_ready):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        is_ready.return_value = True
+        manager.reconfigure_services('service3', 'service4')
+        self.assertEqual(is_ready.call_args_list, [
+            mock.call('service3'),
+            mock.call('service4'),
+        ])
+        self.assertEqual(fire_event.call_args_list, [
+            mock.call('data_ready', 'service3'),
+            mock.call('start', 'service3', default=[
+                services.service_restart,
+                services.open_ports]),
+            mock.call('data_ready', 'service4'),
+            mock.call('start', 'service4', default=[
+                services.service_restart,
+                services.open_ports]),
+        ])
+        self.assertEqual(save_ready.call_args_list, [
+            mock.call('service3'),
+            mock.call('service4'),
+        ])
+
+    @mock.patch.object(services.ServiceManager, 'save_lost')
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    @mock.patch.object(services.ServiceManager, 'was_ready')
+    @mock.patch.object(services.ServiceManager, 'is_ready')
+    def test_reconfigure_not_ready(self, is_ready, was_ready, fire_event, save_lost):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        is_ready.return_value = False
+        was_ready.return_value = False
+        manager.reconfigure_services()
+        is_ready.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+        fire_event.assert_has_calls([
+            mock.call('stop', 'service1', default=[
+                services.close_ports,
+                services.service_stop]),
+            mock.call('stop', 'service2', default=[
+                services.close_ports,
+                services.service_stop]),
+        ], any_order=True)
+        save_lost.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+
+    @mock.patch.object(services.ServiceManager, 'save_lost')
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    @mock.patch.object(services.ServiceManager, 'was_ready')
+    @mock.patch.object(services.ServiceManager, 'is_ready')
+    def test_reconfigure_no_longer_ready(self, is_ready, was_ready, fire_event, save_lost):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        is_ready.return_value = False
+        was_ready.return_value = True
+        manager.reconfigure_services()
+        is_ready.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+        fire_event.assert_has_calls([
+            mock.call('data_lost', 'service1'),
+            mock.call('stop', 'service1', default=[
+                services.close_ports,
+                services.service_stop]),
+        ], any_order=False)
+        fire_event.assert_has_calls([
+            mock.call('data_lost', 'service2'),
+            mock.call('stop', 'service2', default=[
+                services.close_ports,
+                services.service_stop]),
+        ], any_order=False)
+        save_lost.assert_has_calls([
+            mock.call('service1'),
+            mock.call('service2'),
+        ], any_order=True)
+
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    def test_stop_services(self, fire_event):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        manager.stop_services()
+        fire_event.assert_has_calls([
+            mock.call('stop', 'service1', default=[
+                services.close_ports,
+                services.service_stop]),
+            mock.call('stop', 'service2', default=[
+                services.close_ports,
+                services.service_stop]),
+        ], any_order=True)
+
+    @mock.patch.object(services.ServiceManager, 'fire_event')
+    def test_stop_services_list(self, fire_event):
+        manager = services.ServiceManager([
+            {'service': 'service1'}, {'service': 'service2'}])
+        manager.stop_services('service3', 'service4')
+        self.assertEqual(fire_event.call_args_list, [
+            mock.call('stop', 'service3', default=[
+                services.close_ports,
+                services.service_stop]),
+            mock.call('stop', 'service4', default=[
+                services.close_ports,
+                services.service_stop]),
+        ])
+
+    def test_get_service(self):
+        service = {'service': 'test', 'test': 'test_service'}
+        manager = services.ServiceManager([service])
+        self.assertEqual(manager.get_service('test'), service)
+
+    def test_get_service_not_registered(self):
+        service = {'service': 'test', 'test': 'test_service'}
+        manager = services.ServiceManager([service])
+        self.assertRaises(KeyError, manager.get_service, 'foo')
+
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_default(self, get_service):
+        get_service.return_value = {}
+        cb = mock.Mock()
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', cb)
+        cb.assert_called_once_with('service')
+
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_default_list(self, get_service):
+        get_service.return_value = {}
+        cb = mock.Mock()
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', [cb])
+        cb.assert_called_once_with('service')
+
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_simple_callback(self, get_service):
+        cb = mock.Mock()
+        dcb = mock.Mock()
+        get_service.return_value = {'event': cb}
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', dcb)
+        assert not dcb.called
+        cb.assert_called_once_with('service')
+
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_simple_callback_list(self, get_service):
+        cb = mock.Mock()
+        dcb = mock.Mock()
+        get_service.return_value = {'event': [cb]}
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', dcb)
+        assert not dcb.called
+        cb.assert_called_once_with('service')
+
+    @mock.patch.object(services.ManagerCallback, '__call__')
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_manager_callback(self, get_service, mcall):
+        cb = services.ManagerCallback()
+        dcb = mock.Mock()
+        get_service.return_value = {'event': cb}
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', dcb)
+        assert not dcb.called
+        mcall.assert_called_once_with(manager, 'service', 'event')
+
+    @mock.patch.object(services.ManagerCallback, '__call__')
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_fire_event_manager_callback_list(self, get_service, mcall):
+        cb = services.ManagerCallback()
+        dcb = mock.Mock()
+        get_service.return_value = {'event': [cb]}
+        manager = services.ServiceManager()
+        manager.fire_event('event', 'service', dcb)
+        assert not dcb.called
+        mcall.assert_called_once_with(manager, 'service', 'event')
+
+    @mock.patch.object(services.ServiceManager, 'get_service')
+    def test_is_ready(self, get_service):
+        get_service.side_effect = [
+            {},
+            {'required_data': [True]},
+            {'required_data': [False]},
+            {'required_data': [True, False]},
+        ]
+        manager = services.ServiceManager()
+        assert manager.is_ready('foo')
+        assert manager.is_ready('bar')
+        assert not manager.is_ready('foo')
+        assert not manager.is_ready('foo')
+        get_service.assert_has_calls([mock.call('foo'), mock.call('bar')])
+
+    def test_load_ready_file_short_circuit(self):
+        manager = services.ServiceManager()
+        manager._ready = 'foo'
+        manager._load_ready_file()
+        self.assertEqual(manager._ready, 'foo')
+
+    @mock.patch('os.path.exists')
+    @mock.patch.object(services.base, 'open', create=True)
+    def test_load_ready_file_new(self, mopen, exists):
+        manager = services.ServiceManager()
+        exists.return_value = False
+        manager._load_ready_file()
+        self.assertEqual(manager._ready, set())
+        assert not mopen.called
+
+    @mock.patch('json.load')
+    @mock.patch('os.path.exists')
+    @mock.patch.object(services.base, 'open', create=True)
+    def test_load_ready_file(self, mopen, exists, jload):
+        manager = services.ServiceManager()
+        exists.return_value = True
+        jload.return_value = ['bar']
+        manager._load_ready_file()
+        self.assertEqual(manager._ready, set(['bar']))
+        exists.assert_called_once_with('charm_dir/READY-SERVICES.json')
+        mopen.assert_called_once_with('charm_dir/READY-SERVICES.json')
+
+    @mock.patch('json.dump')
+    @mock.patch.object(services.base, 'open', create=True)
+    def test_save_ready_file(self, mopen, jdump):
+        manager = services.ServiceManager()
+        manager._save_ready_file()
+        assert not mopen.called
+        manager._ready = set(['foo'])
+        manager._save_ready_file()
+        mopen.assert_called_once_with('charm_dir/READY-SERVICES.json', 'w')
+        jdump.assert_called_once_with(['foo'], mopen.return_value.__enter__())
+
+    @mock.patch.object(services.base.ServiceManager, '_save_ready_file')
+    @mock.patch.object(services.base.ServiceManager, '_load_ready_file')
+    def test_save_ready(self, _lrf, _srf):
+        manager = services.ServiceManager()
+        manager._ready = set(['foo'])
+        manager.save_ready('bar')
+        _lrf.assert_called_once_with()
+        self.assertEqual(manager._ready, set(['foo', 'bar']))
+        _srf.assert_called_once_with()
+
+    @mock.patch.object(services.base.ServiceManager, '_save_ready_file')
+    @mock.patch.object(services.base.ServiceManager, '_load_ready_file')
+    def test_save_lost(self, _lrf, _srf):
+        manager = services.ServiceManager()
+        manager._ready = set(['foo', 'bar'])
+        manager.save_lost('bar')
+        _lrf.assert_called_once_with()
+        self.assertEqual(manager._ready, set(['foo']))
+        _srf.assert_called_once_with()
+        manager.save_lost('bar')
+        self.assertEqual(manager._ready, set(['foo']))
+
+    @mock.patch.object(services.base.ServiceManager, '_save_ready_file')
+    @mock.patch.object(services.base.ServiceManager, '_load_ready_file')
+    def test_was_ready(self, _lrf, _srf):
+        manager = services.ServiceManager()
+        manager._ready = set()
+        manager.save_ready('foo')
+        manager.save_ready('bar')
+        assert manager.was_ready('foo')
+        assert manager.was_ready('bar')
+        manager.save_lost('bar')
+        assert manager.was_ready('foo')
+        assert not manager.was_ready('bar')
+
+    @mock.patch.object(services.base.hookenv, 'relation_set')
+    @mock.patch.object(services.base.hookenv, 'related_units')
+    @mock.patch.object(services.base.hookenv, 'relation_ids')
+    def test_provide_data_no_match(self, relation_ids, related_units, relation_set):
+        provider = mock.Mock()
+        provider.name = 'provided'
+        manager = services.ServiceManager([
+            {'service': 'service', 'provided_data': [provider]}
+        ])
+        relation_ids.return_value = []
+        manager.provide_data()
+        assert not provider.provide_data.called
+        relation_ids.assert_called_once_with('provided')
+
+    @mock.patch.object(services.base.hookenv, 'relation_set')
+    @mock.patch.object(services.base.hookenv, 'related_units')
+    @mock.patch.object(services.base.hookenv, 'relation_ids')
+    def test_provide_data_not_ready(self, relation_ids, related_units, relation_set):
+        provider = mock.Mock()
+        provider.name = 'provided'
+        pd = mock.Mock()
+        data = pd.return_value = {'data': True}
+        provider.provide_data = lambda remote_service, service_ready: pd(remote_service, service_ready)
+        manager = services.ServiceManager([
+            {'service': 'service', 'provided_data': [provider]}
+        ])
+        manager.is_ready = mock.Mock(return_value=False)
+        relation_ids.return_value = ['relid']
+        related_units.return_value = ['service/0']
+        manager.provide_data()
+        relation_set.assert_called_once_with('relid', data)
+        pd.assert_called_once_with('service', False)
+
+    @mock.patch.object(services.base.hookenv, 'relation_set')
+    @mock.patch.object(services.base.hookenv, 'related_units')
+    @mock.patch.object(services.base.hookenv, 'relation_ids')
+    def test_provide_data_ready(self, relation_ids, related_units, relation_set):
+        provider = mock.Mock()
+        provider.name = 'provided'
+        pd = mock.Mock()
+        data = pd.return_value = {'data': True}
+        provider.provide_data = lambda remote_service, service_ready: pd(remote_service, service_ready)
+        manager = services.ServiceManager([
+            {'service': 'service', 'provided_data': [provider]}
+        ])
+        manager.is_ready = mock.Mock(return_value=True)
+        relation_ids.return_value = ['relid']
+        related_units.return_value = ['service/0']
+        manager.provide_data()
+        relation_set.assert_called_once_with('relid', data)
+        pd.assert_called_once_with('service', True)
+
+
+class TestRelationContext(unittest.TestCase):
+    def setUp(self):
+        self.phookenv = mock.patch.object(services.helpers, 'hookenv')
+        self.mhookenv = self.phookenv.start()
+        self.mhookenv.relation_ids.return_value = []
+        self.context = services.RelationContext()
+        self.context.name = 'http'
+        self.context.interface = 'http'
+        self.context.required_keys = ['foo', 'bar']
+        self.mhookenv.reset_mock()
+
+    def tearDown(self):
+        self.phookenv.stop()
+
+    def test_no_relations(self):
+        self.context.get_data()
+        self.assertFalse(self.context.is_ready())
+        self.assertEqual(self.context, {})
+        self.mhookenv.relation_ids.assert_called_once_with('http')
+
+    def test_no_units(self):
+        self.mhookenv.relation_ids.return_value = ['nginx']
+        self.mhookenv.related_units.return_value = []
+        self.context.get_data()
+        self.assertFalse(self.context.is_ready())
+        self.assertEqual(self.context, {'http': []})
+
+    def test_incomplete(self):
+        self.mhookenv.relation_ids.return_value = ['nginx', 'apache']
+        self.mhookenv.related_units.side_effect = lambda i: [i + '/0']
+        self.mhookenv.relation_get.side_effect = [{}, {'foo': '1'}]
+        self.context.get_data()
+        self.assertFalse(bool(self.context))
+        self.assertEqual(self.mhookenv.relation_get.call_args_list, [
+            mock.call(rid='apache', unit='apache/0'),
+            mock.call(rid='nginx', unit='nginx/0'),
+        ])
+
+    def test_complete(self):
+        self.mhookenv.relation_ids.return_value = ['nginx', 'apache', 'tomcat']
+        self.mhookenv.related_units.side_effect = lambda i: [i + '/0']
+        self.mhookenv.relation_get.side_effect = [{'foo': '1'}, {'foo': '2', 'bar': '3'}, {}]
+        self.context.get_data()
+        self.assertTrue(self.context.is_ready())
+        self.assertEqual(self.context, {'http': [
+            {
+                'foo': '2',
+                'bar': '3',
+            },
+        ]})
+        self.mhookenv.relation_ids.assert_called_with('http')
+        self.assertEqual(self.mhookenv.relation_get.call_args_list, [
+            mock.call(rid='apache', unit='apache/0'),
+            mock.call(rid='nginx', unit='nginx/0'),
+            mock.call(rid='tomcat', unit='tomcat/0'),
+        ])
+
+    def test_provide(self):
+        self.assertEqual(self.context.provide_data(), {})
+
+
+class TestHttpRelation(unittest.TestCase):
+    def setUp(self):
+        self.phookenv = mock.patch.object(services.helpers, 'hookenv')
+        self.mhookenv = self.phookenv.start()
+
+        self.context = services.helpers.HttpRelation()
+
+    def tearDown(self):
+        self.phookenv.stop()
+
+    def test_provide_data(self):
+        self.mhookenv.unit_get.return_value = "127.0.0.1"
+        self.assertEqual(self.context.provide_data(), {
+            'host': "127.0.0.1",
+            'port': 80,
+        })
+
+    def test_complete(self):
+        self.mhookenv.relation_ids.return_value = ['website']
+        self.mhookenv.related_units.side_effect = lambda i: [i + '/0']
+        self.mhookenv.relation_get.side_effect = [{'host': '127.0.0.2',
+                                                   'port': 8080}]
+        self.context.get_data()
+        self.assertTrue(self.context.is_ready())
+        self.assertEqual(self.context, {'website': [
+            {
+                'host': '127.0.0.2',
+                'port': 8080,
+            },
+        ]})
+
+        self.mhookenv.relation_ids.assert_called_with('website')
+        self.assertEqual(self.mhookenv.relation_get.call_args_list, [
+            mock.call(rid='website', unit='website/0'),
+        ])
+
+
+class TestMysqlRelation(unittest.TestCase):
+
+    def setUp(self):
+        self.phookenv = mock.patch.object(services.helpers, 'hookenv')
+        self.mhookenv = self.phookenv.start()
+
+        self.context = services.helpers.MysqlRelation()
+
+    def tearDown(self):
+        self.phookenv.stop()
+
+    def test_complete(self):
+        self.mhookenv.relation_ids.return_value = ['db']
+        self.mhookenv.related_units.side_effect = lambda i: [i + '/0']
+        self.mhookenv.relation_get.side_effect = [{'host': '127.0.0.2',
+                                                   'user': 'mysql',
+                                                   'password': 'mysql',
+                                                   'database': 'mysql',
+                                                   }]
+        self.context.get_data()
+        self.assertTrue(self.context.is_ready())
+        self.assertEqual(self.context, {'db': [
+            {
+                'host': '127.0.0.2',
+                'user': 'mysql',
+                'password': 'mysql',
+                'database': 'mysql',
+            },
+        ]})
+
+        self.mhookenv.relation_ids.assert_called_with('db')
+        self.assertEqual(self.mhookenv.relation_get.call_args_list, [
+            mock.call(rid='db', unit='db/0'),
+        ])
+
+
+class TestRequiredConfig(unittest.TestCase):
+    def setUp(self):
+        self.options = {
+            'options': {
+                'option1': {
+                    'type': 'string',
+                    'description': 'First option',
+                },
+                'option2': {
+                    'type': 'int',
+                    'default': 0,
+                    'description': 'Second option',
+                },
+            },
+        }
+        self.config = {
+            'option1': None,
+            'option2': 0,
+        }
+        self._pyaml = mock.patch.object(services.helpers, 'yaml')
+        self.myaml = self._pyaml.start()
+        self.myaml.load.side_effect = lambda fp: self.options
+        self._pconfig = mock.patch.object(hookenv, 'config')
+        self.mconfig = self._pconfig.start()
+        self.mconfig.side_effect = lambda: self.config
+        self._pcharm_dir = mock.patch.object(hookenv, 'charm_dir')
+        self.mcharm_dir = self._pcharm_dir.start()
+        self.mcharm_dir.return_value = 'charm_dir'
+
+    def tearDown(self):
+        self._pyaml.stop()
+        self._pconfig.stop()
+        self._pcharm_dir.stop()
+
+    def test_none_changed(self):
+        with mock.patch.object(services.helpers, 'open', mock.mock_open(), create=True):
+            context = services.helpers.RequiredConfig('option1', 'option2')
+        self.assertFalse(bool(context))
+        self.assertEqual(context['config']['option1'], None)
+        self.assertEqual(context['config']['option2'], 0)
+
+    def test_partial(self):
+        self.config['option1'] = 'value'
+        with mock.patch.object(services.helpers, 'open', mock.mock_open(), create=True):
+            context = services.helpers.RequiredConfig('option1', 'option2')
+        self.assertFalse(bool(context))
+        self.assertEqual(context['config']['option1'], 'value')
+        self.assertEqual(context['config']['option2'], 0)
+
+    def test_ready(self):
+        self.config['option1'] = 'value'
+        self.config['option2'] = 1
+        with mock.patch.object(services.helpers, 'open', mock.mock_open(), create=True):
+            context = services.helpers.RequiredConfig('option1', 'option2')
+        self.assertTrue(bool(context))
+        self.assertEqual(context['config']['option1'], 'value')
+        self.assertEqual(context['config']['option2'], 1)
+
+    def test_none_empty(self):
+        self.config['option1'] = ''
+        self.config['option2'] = 1
+        with mock.patch.object(services.helpers, 'open', mock.mock_open(), create=True):
+            context = services.helpers.RequiredConfig('option1', 'option2')
+        self.assertFalse(bool(context))
+        self.assertEqual(context['config']['option1'], '')
+        self.assertEqual(context['config']['option2'], 1)
+
+
+class TestStoredContext(unittest.TestCase):
+    @mock.patch.object(services.helpers.StoredContext, 'read_context')
+    @mock.patch.object(services.helpers.StoredContext, 'store_context')
+    @mock.patch('os.path.exists')
+    def test_new(self, exists, store_context, read_context):
+        exists.return_value = False
+        context = services.helpers.StoredContext('foo.yaml', {'key': 'val'})
+        assert not read_context.called
+        store_context.assert_called_once_with('foo.yaml', {'key': 'val'})
+        self.assertEqual(context, {'key': 'val'})
+
+    @mock.patch.object(services.helpers.StoredContext, 'read_context')
+    @mock.patch.object(services.helpers.StoredContext, 'store_context')
+    @mock.patch('os.path.exists')
+    def test_existing(self, exists, store_context, read_context):
+        exists.return_value = True
+        read_context.return_value = {'key': 'other'}
+        context = services.helpers.StoredContext('foo.yaml', {'key': 'val'})
+        read_context.assert_called_once_with('foo.yaml')
+        assert not store_context.called
+        self.assertEqual(context, {'key': 'other'})
+
+    @mock.patch.object(hookenv, 'charm_dir', lambda: 'charm_dir')
+    @mock.patch.object(services.helpers.StoredContext, 'read_context')
+    @mock.patch.object(services.helpers, 'yaml')
+    @mock.patch('os.fchmod')
+    @mock.patch('os.path.exists')
+    def test_store_context(self, exists, fchmod, yaml, read_context):
+        exists.return_value = False
+        mopen = mock.mock_open()
+        with mock.patch.object(services.helpers, 'open', mopen, create=True):
+            services.helpers.StoredContext('foo.yaml', {'key': 'val'})
+        mopen.assert_called_once_with('charm_dir/foo.yaml', 'w')
+        fchmod.assert_called_once_with(mopen.return_value.fileno(), 0o600)
+        yaml.dump.assert_called_once_with({'key': 'val'}, mopen.return_value)
+
+    @mock.patch.object(hookenv, 'charm_dir', lambda: 'charm_dir')
+    @mock.patch.object(services.helpers.StoredContext, 'read_context')
+    @mock.patch.object(services.helpers, 'yaml')
+    @mock.patch('os.fchmod')
+    @mock.patch('os.path.exists')
+    def test_store_context_abs(self, exists, fchmod, yaml, read_context):
+        exists.return_value = False
+        mopen = mock.mock_open()
+        with mock.patch.object(services.helpers, 'open', mopen, create=True):
+            services.helpers.StoredContext('/foo.yaml', {'key': 'val'})
+        mopen.assert_called_once_with('/foo.yaml', 'w')
+
+    @mock.patch.object(hookenv, 'charm_dir', lambda: 'charm_dir')
+    @mock.patch.object(services.helpers, 'yaml')
+    @mock.patch('os.path.exists')
+    def test_read_context(self, exists, yaml):
+        exists.return_value = True
+        yaml.load.return_value = {'key': 'other'}
+        mopen = mock.mock_open()
+        with mock.patch.object(services.helpers, 'open', mopen, create=True):
+            context = services.helpers.StoredContext('foo.yaml', {'key': 'val'})
+        mopen.assert_called_once_with('charm_dir/foo.yaml', 'r')
+        yaml.load.assert_called_once_with(mopen.return_value)
+        self.assertEqual(context, {'key': 'other'})
+
+    @mock.patch.object(hookenv, 'charm_dir', lambda: 'charm_dir')
+    @mock.patch.object(services.helpers, 'yaml')
+    @mock.patch('os.path.exists')
+    def test_read_context_abs(self, exists, yaml):
+        exists.return_value = True
+        yaml.load.return_value = {'key': 'other'}
+        mopen = mock.mock_open()
+        with mock.patch.object(services.helpers, 'open', mopen, create=True):
+            context = services.helpers.StoredContext('/foo.yaml', {'key': 'val'})
+        mopen.assert_called_once_with('/foo.yaml', 'r')
+        yaml.load.assert_called_once_with(mopen.return_value)
+        self.assertEqual(context, {'key': 'other'})
+
+    @mock.patch.object(hookenv, 'charm_dir', lambda: 'charm_dir')
+    @mock.patch.object(services.helpers, 'yaml')
+    @mock.patch('os.path.exists')
+    def test_read_context_empty(self, exists, yaml):
+        exists.return_value = True
+        yaml.load.return_value = None
+        mopen = mock.mock_open()
+        with mock.patch.object(services.helpers, 'open', mopen, create=True):
+            self.assertRaises(OSError, services.helpers.StoredContext, '/foo.yaml', {})
+
+
+class TestTemplateCallback(unittest.TestCase):
+    @mock.patch.object(services.helpers, 'templating')
+    def test_template_defaults(self, mtemplating):
+        manager = mock.Mock(**{'get_service.return_value': {
+            'required_data': [{'foo': 'bar'}]}})
+        self.assertRaises(TypeError, services.template, source='foo.yml')
+        callback = services.template(source='foo.yml', target='bar.yml')
+        assert isinstance(callback, services.ManagerCallback)
+        assert not mtemplating.render.called
+        callback(manager, 'test', 'event')
+        mtemplating.render.assert_called_once_with(
+            'foo.yml', 'bar.yml', {'foo': 'bar', 'ctx': {'foo': 'bar'}},
+            'root', 'root', 0o444, template_loader=None)
+
+    @mock.patch.object(services.helpers, 'templating')
+    def test_template_explicit(self, mtemplating):
+        manager = mock.Mock(**{'get_service.return_value': {
+            'required_data': [{'foo': 'bar'}]}})
+        callback = services.template(
+            source='foo.yml', target='bar.yml',
+            owner='user', group='group', perms=0o555
+        )
+        assert isinstance(callback, services.ManagerCallback)
+        assert not mtemplating.render.called
+        callback(manager, 'test', 'event')
+        mtemplating.render.assert_called_once_with(
+            'foo.yml', 'bar.yml', {'foo': 'bar', 'ctx': {'foo': 'bar'}},
+            'user', 'group', 0o555, template_loader=None)
+
+    @mock.patch.object(services.helpers, 'templating')
+    def test_template_loader(self, mtemplating):
+        manager = mock.Mock(**{'get_service.return_value': {
+            'required_data': [{'foo': 'bar'}]}})
+        callback = services.template(
+            source='foo.yml', target='bar.yml',
+            owner='user', group='group', perms=0o555,
+            template_loader='myloader'
+        )
+        assert isinstance(callback, services.ManagerCallback)
+        assert not mtemplating.render.called
+        callback(manager, 'test', 'event')
+        mtemplating.render.assert_called_once_with(
+            'foo.yml', 'bar.yml', {'foo': 'bar', 'ctx': {'foo': 'bar'}},
+            'user', 'group', 0o555, template_loader='myloader')
+
+    @mock.patch.object(os.path, 'isfile')
+    @mock.patch.object(host, 'file_hash')
+    @mock.patch.object(host, 'service_restart')
+    @mock.patch.object(services.helpers, 'templating')
+    def test_template_onchange_restart(self, mtemplating, mrestart, mfile_hash, misfile):
+        def random_string(arg):
+            return uuid.uuid4()
+        mfile_hash.side_effect = random_string
+        misfile.return_value = True
+        manager = mock.Mock(**{'get_service.return_value': {
+            'required_data': [{'foo': 'bar'}]}})
+        callback = services.template(
+            source='foo.yml', target='bar.yml',
+            owner='user', group='group', perms=0o555,
+            on_change_action=(partial(mrestart, "mysuperservice")),
+        )
+        assert isinstance(callback, services.ManagerCallback)
+        assert not mtemplating.render.called
+        callback(manager, 'test', 'event')
+        mtemplating.render.assert_called_once_with(
+            'foo.yml', 'bar.yml', {'foo': 'bar', 'ctx': {'foo': 'bar'}},
+            'user', 'group', 0o555, template_loader=None)
+        mrestart.assert_called_with('mysuperservice')
+
+    @mock.patch.object(hookenv, 'log')
+    @mock.patch.object(os.path, 'isfile')
+    @mock.patch.object(host, 'file_hash')
+    @mock.patch.object(host, 'service_restart')
+    @mock.patch.object(services.helpers, 'templating')
+    def test_template_onchange_restart_nochange(self, mtemplating, mrestart,
+                                                mfile_hash, misfile, mlog):
+        mfile_hash.return_value = "myhash"
+        misfile.return_value = True
+        manager = mock.Mock(**{'get_service.return_value': {
+            'required_data': [{'foo': 'bar'}]}})
+        callback = services.template(
+            source='foo.yml', target='bar.yml',
+            owner='user', group='group', perms=0o555,
+            on_change_action=(partial(mrestart, "mysuperservice")),
+        )
+        assert isinstance(callback, services.ManagerCallback)
+        assert not mtemplating.render.called
+        callback(manager, 'test', 'event')
+        mtemplating.render.assert_called_once_with(
+            'foo.yml', 'bar.yml', {'foo': 'bar', 'ctx': {'foo': 'bar'}},
+            'user', 'group', 0o555, template_loader=None)
+        self.assertEqual(mrestart.call_args_list, [])
+
+
+class TestPortsCallback(unittest.TestCase):
+    def setUp(self):
+        self.phookenv = mock.patch.object(services.base, 'hookenv')
+        self.mhookenv = self.phookenv.start()
+        self.mhookenv.relation_ids.return_value = []
+        self.mhookenv.charm_dir.return_value = 'charm_dir'
+        self.popen = mock.patch.object(services.base, 'open', create=True)
+        self.mopen = self.popen.start()
+
+    def tearDown(self):
+        self.phookenv.stop()
+        self.popen.stop()
+
+    def test_no_ports(self):
+        manager = mock.Mock(**{'get_service.return_value': {}})
+        services.PortManagerCallback()(manager, 'service', 'event')
+        assert not self.mhookenv.open_port.called
+        assert not self.mhookenv.close_port.called
+
+    def test_open_ports(self):
+        manager = mock.Mock(**{'get_service.return_value': {'ports': [1, 2]}})
+        services.open_ports(manager, 'service', 'start')
+        self.mhookenv.open_port.has_calls([mock.call(1), mock.call(2)])
+        assert not self.mhookenv.close_port.called
+
+    def test_close_ports(self):
+        manager = mock.Mock(**{'get_service.return_value': {'ports': [1, 2]}})
+        services.close_ports(manager, 'service', 'stop')
+        assert not self.mhookenv.open_port.called
+        self.mhookenv.close_port.has_calls([mock.call(1), mock.call(2)])
+
+    def test_close_old_ports(self):
+        self.mopen.return_value.read.return_value = '10,20'
+        manager = mock.Mock(**{'get_service.return_value': {'ports': [1, 2]}})
+        services.close_ports(manager, 'service', 'stop')
+        assert not self.mhookenv.open_port.called
+        self.mhookenv.close_port.has_calls([
+            mock.call(10),
+            mock.call(20),
+            mock.call(1),
+            mock.call(2)])
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_strutils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_strutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..9110e563470fd35979edd10d7303f70d9495ac88
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_strutils.py
@@ -0,0 +1,108 @@
+import unittest
+
+import charmhelpers.core.strutils as strutils
+
+
+class TestStrUtils(unittest.TestCase):
+    def setUp(self):
+        super(TestStrUtils, self).setUp()
+
+    def tearDown(self):
+        super(TestStrUtils, self).tearDown()
+
+    def test_bool_from_string(self):
+        self.assertTrue(strutils.bool_from_string('true'))
+        self.assertTrue(strutils.bool_from_string('True'))
+        self.assertTrue(strutils.bool_from_string('yes'))
+        self.assertTrue(strutils.bool_from_string('Yes'))
+        self.assertTrue(strutils.bool_from_string('y'))
+        self.assertTrue(strutils.bool_from_string('Y'))
+        self.assertTrue(strutils.bool_from_string('on'))
+
+        # unicode should also work
+        self.assertTrue(strutils.bool_from_string(u'true'))
+
+        self.assertFalse(strutils.bool_from_string('False'))
+        self.assertFalse(strutils.bool_from_string('false'))
+        self.assertFalse(strutils.bool_from_string('no'))
+        self.assertFalse(strutils.bool_from_string('No'))
+        self.assertFalse(strutils.bool_from_string('n'))
+        self.assertFalse(strutils.bool_from_string('N'))
+        self.assertFalse(strutils.bool_from_string('off'))
+
+        self.assertRaises(ValueError, strutils.bool_from_string, None)
+        self.assertRaises(ValueError, strutils.bool_from_string, 'foo')
+
+    def test_bytes_from_string(self):
+        self.assertEqual(strutils.bytes_from_string('10'), 10)
+        self.assertEqual(strutils.bytes_from_string('3K'), 3072)
+        self.assertEqual(strutils.bytes_from_string('3KB'), 3072)
+        self.assertEqual(strutils.bytes_from_string('3M'), 3145728)
+        self.assertEqual(strutils.bytes_from_string('3MB'), 3145728)
+        self.assertEqual(strutils.bytes_from_string('3G'), 3221225472)
+        self.assertEqual(strutils.bytes_from_string('3GB'), 3221225472)
+        self.assertEqual(strutils.bytes_from_string('3T'), 3298534883328)
+        self.assertEqual(strutils.bytes_from_string('3TB'), 3298534883328)
+        self.assertEqual(strutils.bytes_from_string('3P'), 3377699720527872)
+        self.assertEqual(strutils.bytes_from_string('3PB'), 3377699720527872)
+
+        self.assertRaises(ValueError, strutils.bytes_from_string, None)
+        self.assertRaises(ValueError, strutils.bytes_from_string, 'foo')
+
+    def test_basic_string_comparator_class_fails_instantiation(self):
+        try:
+            strutils.BasicStringComparator('hello')
+            raise Exception("instantiating BasicStringComparator should fail")
+        except Exception as e:
+            assert (str(e) == "Must define the _list in the class definition!")
+
+    def test_basic_string_comparator_class(self):
+
+        class MyComparator(strutils.BasicStringComparator):
+
+            _list = ('zomg', 'bartlet', 'over', 'and')
+
+        x = MyComparator('zomg')
+        self.assertEquals(x.index, 0)
+        y = MyComparator('over')
+        self.assertEquals(y.index, 2)
+        self.assertTrue(x == 'zomg')
+        self.assertTrue(x != 'bartlet')
+        self.assertTrue(x == x)
+        self.assertTrue(x != y)
+        self.assertTrue(x < y)
+        self.assertTrue(y > x)
+        self.assertTrue(x < 'bartlet')
+        self.assertTrue(y > 'bartlet')
+        self.assertTrue(x >= 'zomg')
+        self.assertTrue(x <= 'zomg')
+        self.assertTrue(x >= x)
+        self.assertTrue(x <= x)
+        self.assertTrue(y >= 'zomg')
+        self.assertTrue(y <= 'over')
+        self.assertTrue(y >= x)
+        self.assertTrue(x <= y)
+        # ensure that something not in the list dies
+        try:
+            MyComparator('nope')
+            raise Exception("MyComparator('nope') should have failed")
+        except Exception as e:
+            self.assertTrue(isinstance(e, KeyError))
+
+    def test_basic_string_comparator_fails_different_comparators(self):
+
+        class MyComparator1(strutils.BasicStringComparator):
+
+            _list = ('the truth is out there'.split(' '))
+
+        class MyComparator2(strutils.BasicStringComparator):
+
+            _list = ('no one in space can hear you scream'.split(' '))
+
+        x = MyComparator1('is')
+        y = MyComparator2('you')
+        try:
+            x > y
+            raise Exception("Comparing different comparators should fail")
+        except Exception as e:
+            self.assertTrue(isinstance(e, AssertionError))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_sysctl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_sysctl.py
new file mode 100644
index 0000000000000000000000000000000000000000..58aec64dd16f380ad34b287c5bfb901d35f02f09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_sysctl.py
@@ -0,0 +1,134 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from charmhelpers.core.sysctl import create
+import io
+from mock import patch, MagicMock
+from subprocess import CalledProcessError
+import unittest
+import tempfile
+
+import six
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+__author__ = 'Jorge Niedbalski R. <jorge.niedbalski@canonical.com>'
+
+
+TO_PATCH = [
+    'log',
+    'check_call',
+    'is_container',
+]
+
+
+class SysctlTests(unittest.TestCase):
+    def setUp(self):
+        self.tempfile = tempfile.NamedTemporaryFile(delete=False)
+        for m in TO_PATCH:
+            setattr(self, m, self._patch(m))
+
+    def _patch(self, method):
+        _m = patch('charmhelpers.core.sysctl.' + method)
+        mock = _m.start()
+        self.addCleanup(_m.stop)
+        return mock
+
+    @patch(builtin_open)
+    def test_create(self, mock_open):
+        """Test create sysctl method"""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        create('{"kernel.max_pid": 1337}', "/etc/sysctl.d/test-sysctl.conf")
+
+        _file.__enter__().write.assert_called_with("kernel.max_pid=1337\n")
+
+        self.log.assert_called_with(
+            "Updating sysctl_file: /etc/sysctl.d/test-sysctl.conf"
+            " values: {'kernel.max_pid': 1337}",
+            level='DEBUG')
+
+        self.check_call.assert_called_with([
+            "sysctl", "-p",
+            "/etc/sysctl.d/test-sysctl.conf"])
+
+    @patch(builtin_open)
+    def test_create_with_ignore(self, mock_open):
+        """Test create sysctl method"""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        create('{"kernel.max_pid": 1337}',
+               "/etc/sysctl.d/test-sysctl.conf",
+               ignore=True)
+
+        _file.__enter__().write.assert_called_with("kernel.max_pid=1337\n")
+
+        self.log.assert_called_with(
+            "Updating sysctl_file: /etc/sysctl.d/test-sysctl.conf"
+            " values: {'kernel.max_pid': 1337}",
+            level='DEBUG')
+
+        self.check_call.assert_called_with([
+            "sysctl", "-p",
+            "/etc/sysctl.d/test-sysctl.conf", "-e"])
+
+    @patch(builtin_open)
+    def test_create_with_dict(self, mock_open):
+        """Test create sysctl method"""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        create({"kernel.max_pid": 1337}, "/etc/sysctl.d/test-sysctl.conf")
+
+        _file.__enter__().write.assert_called_with("kernel.max_pid=1337\n")
+
+        self.log.assert_called_with(
+            "Updating sysctl_file: /etc/sysctl.d/test-sysctl.conf"
+            " values: {'kernel.max_pid': 1337}",
+            level='DEBUG')
+
+        self.check_call.assert_called_with([
+            "sysctl", "-p",
+            "/etc/sysctl.d/test-sysctl.conf"])
+
+    @patch(builtin_open)
+    def test_create_invalid_argument(self, mock_open):
+        """Test create sysctl with an invalid argument"""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        create('{"kernel.max_pid": 1337 xxxx', "/etc/sysctl.d/test-sysctl.conf")
+
+        self.log.assert_called_with(
+            'Error parsing YAML sysctl_dict: {"kernel.max_pid": 1337 xxxx',
+            level='ERROR')
+
+    @patch(builtin_open)
+    def test_create_raises(self, mock_open):
+        """CalledProcessErrors are propagated for non-container machines."""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        self.is_container.return_value = False
+        self.check_call.side_effect = CalledProcessError(1, 'sysctl')
+
+        with self.assertRaises(CalledProcessError):
+            create('{"kernel.max_pid": 1337}', "/etc/sysctl.d/test-sysctl.conf")
+
+    @patch(builtin_open)
+    def test_create_raises_container(self, mock_open):
+        """CalledProcessErrors are logged for containers."""
+        _file = MagicMock(spec=io.FileIO)
+        mock_open.return_value = _file
+
+        self.is_container.return_value = True
+        self.check_call.side_effect = CalledProcessError(1, 'sysctl', 'foo')
+
+        create('{"kernel.max_pid": 1337}', "/etc/sysctl.d/test-sysctl.conf")
+        self.log.assert_called_with(
+            'Error setting some sysctl keys in this container: foo',
+            level='WARNING')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_templating.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_templating.py
new file mode 100644
index 0000000000000000000000000000000000000000..df4767734099b4d3a031b4b9c84ef1c49fef7c77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_templating.py
@@ -0,0 +1,166 @@
+import pkg_resources
+import shutil
+import tempfile
+import unittest
+import jinja2
+import os.path
+import pwd
+import grp
+
+import mock
+from charmhelpers.core import templating
+
+
+TEMPLATES_DIR = pkg_resources.resource_filename(__name__, 'templates')
+
+
+class TestTemplating(unittest.TestCase):
+    def setUp(self):
+        self.charm_dir = pkg_resources.resource_filename(__name__, '')
+        self._charm_dir_patch = mock.patch.object(templating.hookenv,
+                                                  'charm_dir')
+        self._charm_dir_mock = self._charm_dir_patch.start()
+        self._charm_dir_mock.side_effect = lambda: self.charm_dir
+
+    def tearDown(self):
+        self._charm_dir_patch.stop()
+
+    @mock.patch.object(templating.host.os, 'fchown')
+    @mock.patch.object(templating.host, 'mkdir')
+    @mock.patch.object(templating.host, 'log')
+    def test_render(self, log, mkdir, fchown):
+        with tempfile.NamedTemporaryFile() as fn1, \
+                tempfile.NamedTemporaryFile() as fn2:
+            context = {
+                'nats': {
+                    'port': '1234',
+                    'host': 'example.com',
+                },
+                'router': {
+                    'domain': 'api.foo.com'
+                },
+                'nginx_port': 80,
+            }
+            templating.render('fake_cc.yml', fn1.name,
+                              context, templates_dir=TEMPLATES_DIR)
+            contents = open(fn1.name).read()
+            self.assertRegexpMatches(contents, 'port: 1234')
+            self.assertRegexpMatches(contents, 'host: example.com')
+            self.assertRegexpMatches(contents, 'domain: api.foo.com')
+
+            templating.render('test.conf', fn2.name, context,
+                              templates_dir=TEMPLATES_DIR)
+            contents = open(fn2.name).read()
+            self.assertRegexpMatches(contents, 'listen 80')
+            self.assertEqual(fchown.call_count, 2)
+            # Not called, because the target directory exists. Calling
+            # it would make the target directory world readable and
+            # expose your secrets (!).
+            self.assertEqual(mkdir.call_count, 0)
+
+    @mock.patch.object(templating.host.os, 'fchown')
+    @mock.patch.object(templating.host, 'mkdir')
+    @mock.patch.object(templating.host, 'log')
+    def test_render_from_string(self, log, mkdir, fchown):
+        with tempfile.NamedTemporaryFile() as fn:
+            context = {
+                'foo': 'bar'
+            }
+
+            config_template = '{{ foo }}'
+            templating.render('somefile.txt', fn.name,
+                              context, templates_dir=TEMPLATES_DIR,
+                              config_template=config_template)
+            contents = open(fn.name).read()
+            self.assertRegexpMatches(contents, 'bar')
+
+            self.assertEqual(fchown.call_count, 1)
+            # Not called, because the target directory exists. Calling
+            # it would make the target directory world readable and
+            # expose your secrets (!).
+            self.assertEqual(mkdir.call_count, 0)
+
+    @mock.patch.object(templating.host.os, 'fchown')
+    @mock.patch.object(templating.host, 'mkdir')
+    @mock.patch.object(templating.host, 'log')
+    def test_render_loader(self, log, mkdir, fchown):
+        with tempfile.NamedTemporaryFile() as fn1:
+            context = {
+                'nats': {
+                    'port': '1234',
+                    'host': 'example.com',
+                },
+                'router': {
+                    'domain': 'api.foo.com'
+                },
+                'nginx_port': 80,
+            }
+            template_loader = jinja2.ChoiceLoader([jinja2.FileSystemLoader(TEMPLATES_DIR)])
+            templating.render('fake_cc.yml', fn1.name,
+                              context, template_loader=template_loader)
+            contents = open(fn1.name).read()
+            self.assertRegexpMatches(contents, 'port: 1234')
+            self.assertRegexpMatches(contents, 'host: example.com')
+            self.assertRegexpMatches(contents, 'domain: api.foo.com')
+
+    @mock.patch.object(templating.os.path, 'exists')
+    @mock.patch.object(templating.host.os, 'fchown')
+    @mock.patch.object(templating.host, 'mkdir')
+    @mock.patch.object(templating.host, 'log')
+    def test_render_no_dir(self, log, mkdir, fchown, exists):
+        exists.return_value = False
+        with tempfile.NamedTemporaryFile() as fn1, \
+                tempfile.NamedTemporaryFile() as fn2:
+            context = {
+                'nats': {
+                    'port': '1234',
+                    'host': 'example.com',
+                },
+                'router': {
+                    'domain': 'api.foo.com'
+                },
+                'nginx_port': 80,
+            }
+            templating.render('fake_cc.yml', fn1.name,
+                              context, templates_dir=TEMPLATES_DIR)
+            contents = open(fn1.name).read()
+            self.assertRegexpMatches(contents, 'port: 1234')
+            self.assertRegexpMatches(contents, 'host: example.com')
+            self.assertRegexpMatches(contents, 'domain: api.foo.com')
+
+            templating.render('test.conf', fn2.name, context,
+                              templates_dir=TEMPLATES_DIR)
+            contents = open(fn2.name).read()
+            self.assertRegexpMatches(contents, 'listen 80')
+            self.assertEqual(fchown.call_count, 2)
+            # Target directory was created, world readable (!).
+            self.assertEqual(mkdir.call_count, 2)
+
+    @mock.patch.object(templating.host.os, 'fchown')
+    @mock.patch.object(templating.host, 'log')
+    def test_render_2(self, log, fchown):
+        tmpdir = tempfile.mkdtemp()
+        fn1 = os.path.join(tmpdir, 'test.conf')
+        try:
+            context = {'nginx_port': 80}
+            templating.render('test.conf', fn1, context,
+                              owner=pwd.getpwuid(os.getuid()).pw_name,
+                              group=grp.getgrgid(os.getgid()).gr_name,
+                              templates_dir=TEMPLATES_DIR)
+            with open(fn1) as f:
+                contents = f.read()
+
+            self.assertRegexpMatches(contents, 'something')
+        finally:
+            shutil.rmtree(tmpdir, ignore_errors=True)
+
+    @mock.patch.object(templating, 'hookenv')
+    @mock.patch('jinja2.Environment')
+    def test_load_error(self, Env, hookenv):
+        Env().get_template.side_effect = jinja2.exceptions.TemplateNotFound(
+            'fake_cc.yml')
+        self.assertRaises(
+            jinja2.exceptions.TemplateNotFound, templating.render,
+            'fake.src', 'fake.tgt', {}, templates_dir='tmpl')
+        hookenv.log.assert_called_once_with(
+            'Could not load template fake.src from tmpl.', level=hookenv.ERROR)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_unitdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_unitdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..c6a85ecf5b9d736e1e493d9e38a46af607d60131
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/core/test_unitdata.py
@@ -0,0 +1,228 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright 2015 Canonical Ltd.
+#
+# Authors:
+#  Kapil Thangavelu <kapil.foss@gmail.com>
+#
+try:
+    from StringIO import StringIO
+except Exception:
+    from io import StringIO
+
+import os
+import shutil
+import tempfile
+import unittest
+
+from mock import patch
+
+from charmhelpers.core.unitdata import Storage, HookData, kv
+
+
+class HookDataTest(unittest.TestCase):
+
+    def setUp(self):
+        self.charm_dir = tempfile.mkdtemp()
+        self.addCleanup(lambda: shutil.rmtree(self.charm_dir))
+        self.change_environment(CHARM_DIR=self.charm_dir)
+
+    def change_environment(self, **kw):
+        original_env = dict(os.environ)
+
+        @self.addCleanup
+        def cleanup_env():
+            os.environ.clear()
+            os.environ.update(original_env)
+
+        os.environ.update(kw)
+
+    @patch('charmhelpers.core.hookenv.hook_name')
+    @patch('charmhelpers.core.hookenv.execution_environment')
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    def test_hook_data_records(self, cdir, ctx, name):
+        name.return_value = 'config-changed'
+        ctx.return_value = {
+            'rels': {}, 'conf': {'a': 1}, 'env': {}, 'unit': 'someunit'}
+        cdir.return_value = self.charm_dir
+        with open(os.path.join(self.charm_dir, 'revision'), 'w') as fh:
+            fh.write('1')
+        hook_data = HookData()
+
+        with hook_data():
+            self.assertEqual(kv(), hook_data.kv)
+            self.assertEqual(kv().get('charm_revisions'), ['1'])
+            self.assertEqual(kv().get('unit'), 'someunit')
+            self.assertEqual(list(hook_data.conf), ['a'])
+            self.assertEqual(tuple(hook_data.conf.a), (None, 1))
+
+
+class StorageTest(unittest.TestCase):
+
+    def test_init_kv_multiple(self):
+        with tempfile.NamedTemporaryFile() as fh:
+            kv = Storage(fh.name)
+            with kv.hook_scope('xyz'):
+                kv.set('x', 1)
+            kv.close()
+            self.assertEqual(os.stat(fh.name).st_mode & 0o777, 0o600)
+
+            kv = Storage(fh.name)
+            with kv.hook_scope('abc'):
+                self.assertEqual(kv.get('x'), 1)
+            kv.close()
+
+    def test_hook_scope(self):
+        kv = Storage(':memory:')
+        try:
+            with kv.hook_scope('install') as rev:
+                self.assertEqual(rev, 1)
+                kv.set('a', 1)
+                raise RuntimeError('x')
+        except RuntimeError:
+            self.assertEqual(kv.get('a'), None)
+
+        with kv.hook_scope('config-changed') as rev:
+            self.assertEqual(rev, 1)
+            kv.set('a', 1)
+        self.assertEqual(kv.get('a'), 1)
+
+        kv.revision = None
+
+        with kv.hook_scope('start') as rev:
+            self.assertEqual(rev, 2)
+            kv.set('a', False)
+            kv.set('a', True)
+        self.assertEqual(kv.get('a'), True)
+
+        # History doesn't decode values by default
+        history = [h[:-1] for h in kv.gethistory('a')]
+        self.assertEqual(
+            history,
+            [(1, 'a', '1', 'config-changed'),
+             (2, 'a', 'true', 'start')])
+
+        history = [h[:-1] for h in kv.gethistory('a', deserialize=True)]
+        self.assertEqual(
+            history,
+            [(1, 'a', 1, 'config-changed'),
+             (2, 'a', True, 'start')])
+
+    def test_delta_no_previous_and_history(self):
+        kv = Storage(':memory:')
+        with kv.hook_scope('install'):
+            data = {'a': 0, 'c': False}
+            delta = kv.delta(data, 'settings.')
+            self.assertEqual(delta, {
+                'a': (None, False), 'c': (None, False)})
+            kv.update(data, 'settings.')
+
+        with kv.hook_scope('config'):
+            data = {'a': 1, 'c': True}
+            delta = kv.delta(data, 'settings.')
+            self.assertEqual(delta, {
+                'a': (0, 1), 'c': (False, True)})
+            kv.update(data, 'settings.')
+        # strip the time
+        history = [h[:-1] for h in kv.gethistory('settings.a')]
+        self.assertEqual(
+            history,
+            [(1, 'settings.a', '0', 'install'),
+             (2, 'settings.a', '1', 'config')])
+
+    def test_unset(self):
+        kv = Storage(':memory:')
+        with kv.hook_scope('install'):
+            kv.set('a', True)
+        with kv.hook_scope('start'):
+            kv.set('a', False)
+        with kv.hook_scope('config-changed'):
+            kv.unset('a')
+        history = [h[:-1] for h in kv.gethistory('a')]
+
+        self.assertEqual(history, [
+            (1, 'a', 'true', 'install'),
+            (2, 'a', 'false', 'start'),
+            (3, 'a', '"DELETED"', "config-changed")])
+
+    def test_flush_and_close_on_closed(self):
+        kv = Storage(':memory:')
+        kv.close()
+        kv.flush(False)
+        kv.close()
+
+    def test_multi_value_set_skips(self):
+        # pure coverage test
+        kv = Storage(':memory:')
+        kv.set('x', 1)
+        self.assertEqual(kv.set('x', 1), 1)
+
+    def test_debug(self):
+        # pure coverage test...
+        io = StringIO()
+        kv = Storage(':memory:')
+        kv.debug(io)
+
+    def test_record(self):
+        kv = Storage(':memory:')
+        kv.set('config', {'x': 1, 'b': False})
+        config = kv.get('config', record=True)
+        self.assertEqual(config.b, False)
+        self.assertEqual(config.x, 1)
+        self.assertEqual(kv.set('config.x', 1), 1)
+        try:
+            config.z
+        except AttributeError:
+            pass
+        else:
+            self.fail('attribute error should fire on nonexistant')
+
+    def test_delta(self):
+        kv = Storage(':memory:')
+        kv.update({'a': 1, 'b': 2.2}, prefix="x")
+        delta = kv.delta({'a': 0, 'c': False}, prefix='x')
+        self.assertEqual(
+            delta,
+            {'a': (1, 0), 'b': (2.2, None), 'c': (None, False)})
+        self.assertEqual(delta.a.previous, 1)
+        self.assertEqual(delta.a.current, 0)
+        self.assertEqual(delta.c.previous, None)
+        self.assertEqual(delta.a.current, False)
+
+    def test_update(self):
+        kv = Storage(':memory:')
+        kv.update({'v_a': 1, 'v_b': 2.2})
+        self.assertEqual(kv.getrange('v_'), {'v_a': 1, 'v_b': 2.2})
+
+        kv.update({'a': False, 'b': True}, prefix='x_')
+        self.assertEqual(
+            kv.getrange('x_', True), {'a': False, 'b': True})
+
+    def test_keyrange(self):
+        kv = Storage(':memory:')
+        kv.set('docker.net_mtu', 1)
+        kv.set('docker.net_nack', True)
+        kv.set('docker.net_type', 'vxlan')
+        self.assertEqual(
+            kv.getrange('docker'),
+            {'docker.net_mtu': 1, 'docker.net_type': 'vxlan',
+             'docker.net_nack': True})
+        self.assertEqual(
+            kv.getrange('docker.', True),
+            {'net_mtu': 1, 'net_type': 'vxlan', 'net_nack': True})
+
+    def test_get_set_unset(self):
+        kv = Storage(':memory:')
+        kv.hook_scope('test')
+        kv.set('hello', 'saucy')
+        kv.set('hello', 'world')
+        self.assertEqual(kv.get('hello'), 'world')
+        kv.flush()
+        kv.unset('hello')
+        self.assertEqual(kv.get('hello'), None)
+        kv.flush(False)
+        self.assertEqual(kv.get('hello'), 'world')
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_debug.py
new file mode 100755
index 0000000000000000000000000000000000000000..76ee450628ef8b2deee7bcb4842289c8971c52ee
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_debug.py
@@ -0,0 +1,54 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+from unittest import TestCase
+
+from charmhelpers.fetch.python import debug
+
+import mock
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+TO_PATCH = [
+    "log",
+    "open_port",
+    "close_port",
+    "Rpdb",
+    "_error",
+]
+
+
+class DebugTestCase(TestCase):
+    """Test cases for charmhelpers.contrib.python.debug"""
+
+    def setUp(self):
+        TestCase.setUp(self)
+        self.patch_all()
+        self.log.return_value = True
+        self.close_port.return_value = True
+
+        self.wrapped_function = mock.Mock(return_value=True)
+        self.set_trace = debug.set_trace
+
+    def patch(self, method):
+        _m = mock.patch.object(debug, method)
+        _mock = _m.start()
+        self.addCleanup(_m.stop)
+        return _mock
+
+    def patch_all(self):
+        for method in TO_PATCH:
+            setattr(self, method, self.patch(method))
+
+    def test_debug_set_trace(self):
+        """Check if set_trace works
+        """
+        self.set_trace()
+        self.open_port.assert_called_with(4444)
+
+    def test_debug_set_trace_ex(self):
+        """Check if set_trace raises exception
+        """
+        self.set_trace()
+        self.Rpdb.set_trace.side_effect = Exception()
+        self.assertTrue(self._error.called)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_packages.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_packages.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4bd05c2cad7dda7d8cf1a7101358d6af4d2c825
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_packages.py
@@ -0,0 +1,177 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+import mock
+import six
+
+from unittest import TestCase
+from charmhelpers.fetch.python import packages
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+TO_PATCH = [
+    "apt_install",
+    "charm_dir",
+    "log",
+    "pip_execute",
+]
+
+
+class PipTestCase(TestCase):
+
+    def setUp(self):
+        TestCase.setUp(self)
+        self.patch_all()
+
+        self.log.return_value = True
+        self.apt_install.return_value = True
+
+    def patch(self, method):
+        _m = mock.patch.object(packages, method)
+        _mock = _m.start()
+        self.addCleanup(_m.stop)
+        return _mock
+
+    def patch_all(self):
+        for method in TO_PATCH:
+            setattr(self, method, self.patch(method))
+
+    def test_pip_install_requirements(self):
+        """
+        Check if pip_install_requirements works correctly
+        """
+        packages.pip_install_requirements("test_requirements.txt")
+        self.pip_execute.assert_called_with(["install",
+                                             "-r test_requirements.txt"])
+
+        packages.pip_install_requirements("test_requirements.txt",
+                                          "test_constraints.txt")
+        self.pip_execute.assert_called_with(["install",
+                                             "-r test_requirements.txt",
+                                             "-c test_constraints.txt"])
+
+        packages.pip_install_requirements("test_requirements.txt",
+                                          proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["install",
+                                             "--proxy=proxy_addr:8080",
+                                             "-r test_requirements.txt"])
+
+        packages.pip_install_requirements("test_requirements.txt",
+                                          log="output.log",
+                                          proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["install",
+                                             "--log=output.log",
+                                             "--proxy=proxy_addr:8080",
+                                             "-r test_requirements.txt"])
+
+    def test_pip_install(self):
+        """
+        Check if pip_install works correctly with a single package
+        """
+        packages.pip_install("mock")
+        self.pip_execute.assert_called_with(["install",
+                                             "mock"])
+        packages.pip_install("mock",
+                             proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["install",
+                                             "--proxy=proxy_addr:8080",
+                                             "mock"])
+        packages.pip_install("mock",
+                             log="output.log",
+                             proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["install",
+                                             "--log=output.log",
+                                             "--proxy=proxy_addr:8080",
+                                             "mock"])
+
+    def test_pip_install_upgrade(self):
+        """
+        Check if pip_install works correctly with a single package
+        """
+        packages.pip_install("mock", upgrade=True)
+        self.pip_execute.assert_called_with(["install",
+                                             "--upgrade",
+                                             "mock"])
+
+    def test_pip_install_multiple(self):
+        """
+        Check if pip_install works correctly with multiple packages
+        """
+        packages.pip_install(["mock", "nose"])
+        self.pip_execute.assert_called_with(["install",
+                                             "mock", "nose"])
+
+    @mock.patch('subprocess.check_call')
+    @mock.patch('os.path.join')
+    def test_pip_install_venv(self, join, check_call):
+        """
+        Check if pip_install works correctly with multiple packages
+        """
+        join.return_value = 'joined-path'
+        packages.pip_install(["mock", "nose"], venv=True)
+        check_call.assert_called_with(["joined-path", "install",
+                                       "mock", "nose"])
+
+    def test_pip_uninstall(self):
+        """
+        Check if pip_uninstall works correctly with a single package
+        """
+        packages.pip_uninstall("mock")
+        self.pip_execute.assert_called_with(["uninstall",
+                                             "-q",
+                                             "-y",
+                                             "mock"])
+        packages.pip_uninstall("mock",
+                               proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["uninstall",
+                                             "-q",
+                                             "-y",
+                                             "--proxy=proxy_addr:8080",
+                                             "mock"])
+        packages.pip_uninstall("mock",
+                               log="output.log",
+                               proxy="proxy_addr:8080")
+
+        self.pip_execute.assert_called_with(["uninstall",
+                                             "-q",
+                                             "-y",
+                                             "--log=output.log",
+                                             "--proxy=proxy_addr:8080",
+                                             "mock"])
+
+    def test_pip_uninstall_multiple(self):
+        """
+        Check if pip_uninstall works correctly with multiple packages
+        """
+        packages.pip_uninstall(["mock", "nose"])
+        self.pip_execute.assert_called_with(["uninstall",
+                                             "-q",
+                                             "-y",
+                                             "mock", "nose"])
+
+    def test_pip_list(self):
+        """
+        Checks if pip_list works correctly
+        """
+        packages.pip_list()
+        self.pip_execute.assert_called_with(["list"])
+
+    @mock.patch('os.path.join')
+    @mock.patch('subprocess.check_call')
+    @mock.patch.object(packages, 'pip_install')
+    def test_pip_create_virtualenv(self, pip_install, check_call, join):
+        """
+        Checks if pip_create_virtualenv works correctly
+        """
+        join.return_value = 'joined-path'
+        packages.pip_create_virtualenv()
+        if six.PY2:
+            self.apt_install.assert_called_with('python-virtualenv')
+        else:
+            self.apt_install.assert_called_with('python3-virtualenv')
+        check_call.assert_called_with(['virtualenv', 'joined-path'])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e32af3d5455f94573885e77330d7532f000e973
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/python/test_version.py
@@ -0,0 +1,27 @@
+#!/usr/bin/env python
+# coding: utf-8
+
+from unittest import TestCase
+from charmhelpers.fetch.python import version
+
+import sys
+
+__author__ = "Jorge Niedbalski <jorge.niedbalski@canonical.com>"
+
+
+class VersionTestCase(TestCase):
+
+    def setUp(self):
+        TestCase.setUp(self)
+
+    def test_current_version(self):
+        """
+        Check if version.current_version and version.current_version_string
+        works correctly
+        """
+        self.assertEquals(version.current_version(),
+                          sys.version_info)
+        self.assertEquals(version.current_version_string(),
+                          "{0}.{1}.{2}".format(sys.version_info.major,
+                                               sys.version_info.minor,
+                                               sys.version_info.micro))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_archiveurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_archiveurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3733b5ba58ad6f4542052ccb07da559cf93a207
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_archiveurl.py
@@ -0,0 +1,131 @@
+import os
+
+from unittest import TestCase
+from mock import (
+    MagicMock,
+    patch,
+    mock_open,
+    Mock,
+    ANY
+)
+from charmhelpers.fetch import (
+    archiveurl,
+    UnhandledSource,
+)
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse
+    from urllib.error import URLError
+else:
+    from urllib2 import URLError
+    from urlparse import urlparse
+
+
+class ArchiveUrlFetchHandlerTest(TestCase):
+
+    def setUp(self):
+        super(ArchiveUrlFetchHandlerTest, self).setUp()
+        self.valid_urls = (
+            "http://example.com/foo.tar.gz",
+            "http://example.com/foo.tgz",
+            "http://example.com/foo.tar.bz2",
+            "http://example.com/foo.tbz2",
+            "http://example.com/foo.zip",
+            "http://example.com/foo.zip?bar=baz&x=y#whee",
+            "ftp://example.com/foo.tar.gz",
+            "https://example.com/foo.tgz",
+            "file://example.com/foo.tar.bz2",
+        )
+        self.invalid_urls = (
+            "git://example.com/foo.tar.gz",
+            "http://example.com/foo",
+            "http://example.com/foobar=baz&x=y#tar.gz",
+            "http://example.com/foobar?h=baz.zip",
+            "bzr+ssh://example.com/foo.tar.gz",
+            "lp:example/foo.tgz",
+            "file//example.com/foo.tar.bz2",
+            "garbage",
+        )
+        self.fh = archiveurl.ArchiveUrlFetchHandler()
+
+    def test_handles_archive_urls(self):
+        for url in self.valid_urls:
+            result = self.fh.can_handle(url)
+            self.assertEqual(result, True, url)
+        for url in self.invalid_urls:
+            result = self.fh.can_handle(url)
+            self.assertNotEqual(result, True, url)
+
+    @patch('charmhelpers.fetch.archiveurl.urlopen')
+    def test_downloads(self, _urlopen):
+        for url in self.valid_urls:
+            response = MagicMock()
+            response.read.return_value = "bar"
+            _urlopen.return_value = response
+
+            _open = mock_open()
+            with patch('charmhelpers.fetch.archiveurl.open',
+                       _open, create=True):
+                self.fh.download(url, "foo")
+
+            response.read.assert_called_with()
+            _open.assert_called_once_with("foo", 'wb')
+            _open().write.assert_called_with("bar")
+
+    @patch('charmhelpers.fetch.archiveurl.check_hash')
+    @patch('charmhelpers.fetch.archiveurl.mkdir')
+    @patch('charmhelpers.fetch.archiveurl.extract')
+    def test_installs(self, _extract, _mkdir, _check_hash):
+        self.fh.download = MagicMock()
+
+        for url in self.valid_urls:
+            filename = urlparse(url).path
+            dest = os.path.join('foo', 'fetched', os.path.basename(filename))
+            _extract.return_value = dest
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                where = self.fh.install(url, checksum='deadbeef')
+            self.fh.download.assert_called_with(url, dest)
+            _extract.assert_called_with(dest, None)
+            _check_hash.assert_called_with(dest, 'deadbeef', 'sha1')
+            self.assertEqual(where, dest)
+            _check_hash.reset_mock()
+
+        url = "http://www.example.com/archive.tar.gz"
+
+        self.fh.download.side_effect = URLError('fail')
+        with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+            self.assertRaises(UnhandledSource, self.fh.install, url)
+
+        self.fh.download.side_effect = OSError('fail')
+        with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+            self.assertRaises(UnhandledSource, self.fh.install, url)
+
+    @patch('charmhelpers.fetch.archiveurl.check_hash')
+    @patch('charmhelpers.fetch.archiveurl.mkdir')
+    @patch('charmhelpers.fetch.archiveurl.extract')
+    def test_install_with_hash_in_url(self, _extract, _mkdir, _check_hash):
+        self.fh.download = MagicMock()
+        url = "file://example.com/foo.tar.bz2#sha512=beefdead"
+        with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+            self.fh.install(url)
+        _check_hash.assert_called_with(ANY, 'beefdead', 'sha512')
+
+    @patch('charmhelpers.fetch.archiveurl.mkdir')
+    @patch('charmhelpers.fetch.archiveurl.extract')
+    def test_install_with_duplicate_hash_in_url(self, _extract, _mkdir):
+        self.fh.download = MagicMock()
+        url = "file://example.com/foo.tar.bz2#sha512=a&sha512=b"
+        with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+            with self.assertRaisesRegexp(
+                    TypeError, "Expected 1 hash value, not 2"):
+                self.fh.install(url)
+
+    @patch('charmhelpers.fetch.archiveurl.urlretrieve')
+    @patch('charmhelpers.fetch.archiveurl.check_hash')
+    def test_download_and_validate(self, vfmock, urlmock):
+        urlmock.return_value = ('/tmp/tmpebM9Hv', Mock())
+        dlurl = 'http://example.com/foo.tgz'
+        dlhash = '988881adc9fc3655077dc2d4d757d480b5ea0e11'
+        self.fh.download_and_validate(dlurl, dlhash)
+        vfmock.assert_called_with('/tmp/tmpebM9Hv', dlhash, 'sha1')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_bzrurl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_bzrurl.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b71209b9998cb319daf3b9a2645c394e1883d8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_bzrurl.py
@@ -0,0 +1,136 @@
+import os
+import shutil
+import subprocess
+import tempfile
+from testtools import TestCase
+from mock import (
+    MagicMock,
+    patch,
+)
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse
+else:
+    from urlparse import urlparse
+
+try:
+    from charmhelpers.fetch import (
+        bzrurl,
+        UnhandledSource,
+    )
+except ImportError:
+    bzrurl = None
+    UnhandledSource = None
+
+
+class BzrUrlFetchHandlerTest(TestCase):
+
+    def setUp(self):
+        super(BzrUrlFetchHandlerTest, self).setUp()
+        self.valid_urls = (
+            "bzr+ssh://example.com/branch-name",
+            "bzr+ssh://example.com/branch-name/",
+            "lp:lp-branch-name",
+            "lp:example/lp-branch-name",
+        )
+        self.invalid_urls = (
+            "http://example.com/foo.tar.gz",
+            "http://example.com/foo.tgz",
+            "http://example.com/foo.tar.bz2",
+            "http://example.com/foo.tbz2",
+            "http://example.com/foo.zip",
+            "http://example.com/foo.zip?bar=baz&x=y#whee",
+            "ftp://example.com/foo.tar.gz",
+            "https://example.com/foo.tgz",
+            "file://example.com/foo.tar.bz2",
+            "git://example.com/foo.tar.gz",
+            "http://example.com/foo",
+            "http://example.com/foobar=baz&x=y#tar.gz",
+            "http://example.com/foobar?h=baz.zip",
+            "abc:example",
+            "file//example.com/foo.tar.bz2",
+            "garbage",
+        )
+        self.fh = bzrurl.BzrUrlFetchHandler()
+
+    def test_handles_bzr_urls(self):
+        for url in self.valid_urls:
+            result = self.fh.can_handle(url)
+            self.assertEqual(result, True, url)
+        for url in self.invalid_urls:
+            result = self.fh.can_handle(url)
+            self.assertNotEqual(result, True, url)
+
+    @patch('charmhelpers.fetch.bzrurl.check_output')
+    def test_branch(self, check_output):
+        dest_path = "/destination/path"
+        for url in self.valid_urls:
+            self.fh.remote_branch = MagicMock()
+            self.fh.load_plugins = MagicMock()
+            self.fh.branch(url, dest_path)
+
+            check_output.assert_called_with(['bzr', 'branch', url, dest_path], stderr=-2)
+
+        for url in self.invalid_urls:
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                self.assertRaises(UnhandledSource, self.fh.branch,
+                                  url, dest_path)
+
+    @patch('charmhelpers.fetch.bzrurl.check_output')
+    def test_branch_revno(self, check_output):
+        dest_path = "/destination/path"
+        for url in self.valid_urls:
+            self.fh.remote_branch = MagicMock()
+            self.fh.load_plugins = MagicMock()
+            self.fh.branch(url, dest_path, revno=42)
+
+            check_output.assert_called_with(['bzr', 'branch', '-r', '42',
+                                             url, dest_path], stderr=-2)
+
+        for url in self.invalid_urls:
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                self.assertRaises(UnhandledSource, self.fh.branch, url,
+                                  dest_path)
+
+    def test_branch_functional(self):
+        src = None
+        dst = None
+        try:
+            src = tempfile.mkdtemp()
+            subprocess.check_output(['bzr', 'init', src], stderr=subprocess.STDOUT)
+            dst = tempfile.mkdtemp()
+            os.rmdir(dst)
+            self.fh.branch(src, dst)
+            assert os.path.exists(os.path.join(dst, '.bzr'))
+            self.fh.branch(src, dst)  # idempotent
+            assert os.path.exists(os.path.join(dst, '.bzr'))
+        finally:
+            if src:
+                shutil.rmtree(src, ignore_errors=True)
+            if dst:
+                shutil.rmtree(dst, ignore_errors=True)
+
+    def test_installs(self):
+        self.fh.branch = MagicMock()
+
+        for url in self.valid_urls:
+            branch_name = urlparse(url).path.strip("/").split("/")[-1]
+            dest = os.path.join('foo', 'fetched')
+            dest_dir = os.path.join(dest, os.path.basename(branch_name))
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                where = self.fh.install(url)
+            self.assertEqual(where, dest_dir)
+
+    @patch('charmhelpers.fetch.bzrurl.mkdir')
+    def test_installs_dir(self, _mkdir):
+        self.fh.branch = MagicMock()
+
+        for url in self.valid_urls:
+            branch_name = urlparse(url).path.strip("/").split("/")[-1]
+            dest = os.path.join('opt', 'f')
+            dest_dir = os.path.join(dest, os.path.basename(branch_name))
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                where = self.fh.install(url, dest)
+            self.assertEqual(where, dest_dir)
+            _mkdir.assert_called_with(dest, perms=0o755)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch.py
new file mode 100644
index 0000000000000000000000000000000000000000..202467f99900a8c8598cc7e9526034ab4c364906
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch.py
@@ -0,0 +1,269 @@
+import six
+import os
+import yaml
+
+from testtools import TestCase
+from mock import (
+    patch,
+    MagicMock,
+    call,
+)
+
+from charmhelpers import fetch
+
+if six.PY3:
+    from urllib.parse import urlparse
+    builtin_open = 'builtins.open'
+else:
+    from urlparse import urlparse
+    builtin_open = '__builtin__.open'
+
+
+FAKE_APT_CACHE = {
+    # an installed package
+    'vim': {
+        'current_ver': '2:7.3.547-6ubuntu5'
+    },
+    # a uninstalled installation candidate
+    'emacs': {
+    }
+}
+
+
+def fake_apt_cache(in_memory=True, progress=None):
+    def _get(package):
+        pkg = MagicMock()
+        if package not in FAKE_APT_CACHE:
+            raise KeyError
+        pkg.name = package
+        if 'current_ver' in FAKE_APT_CACHE[package]:
+            pkg.current_ver.ver_str = FAKE_APT_CACHE[package]['current_ver']
+        else:
+            pkg.current_ver = None
+        return pkg
+    cache = MagicMock()
+    cache.__getitem__.side_effect = _get
+    return cache
+
+
+def getenv(update=None):
+    # return a copy of os.environ with update applied.
+    # this was necessary because some modules modify os.environment directly
+    copy = os.environ.copy()
+    if update is not None:
+        copy.update(update)
+    return copy
+
+
+class FetchTest(TestCase):
+
+    @patch('charmhelpers.fetch.log')
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_single_source(self, add_source, config, log):
+        config.side_effect = ['source', 'key']
+        fetch.configure_sources()
+        add_source.assert_called_with('source', 'key')
+
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_null_source(self, add_source, config):
+        config.side_effect = [None, None]
+        fetch.configure_sources()
+        self.assertEqual(add_source.call_count, 0)
+
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_empty_source(self, add_source, config):
+        config.side_effect = ['', '']
+        fetch.configure_sources()
+        self.assertEqual(add_source.call_count, 0)
+
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_single_source_no_key(self, add_source, config):
+        config.side_effect = ['source', None]
+        fetch.configure_sources()
+        add_source.assert_called_with('source', None)
+
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_multiple_sources(self, add_source, config):
+        sources = ["sourcea", "sourceb"]
+        keys = ["keya", None]
+        config.side_effect = [
+            yaml.dump(sources),
+            yaml.dump(keys)
+        ]
+        fetch.configure_sources()
+        add_source.assert_has_calls([
+            call('sourcea', 'keya'),
+            call('sourceb', None)
+        ])
+
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_missing_keys(self, add_source, config):
+        sources = ["sourcea", "sourceb"]
+        keys = ["keya"]  # Second key is missing
+        config.side_effect = [
+            yaml.dump(sources),
+            yaml.dump(keys)
+        ]
+        self.assertRaises(fetch.SourceConfigError, fetch.configure_sources)
+
+    @patch.object(fetch, '_fetch_update')
+    @patch.object(fetch, 'config')
+    @patch.object(fetch, 'add_source')
+    def test_configure_sources_update_called_ubuntu(self, add_source, config,
+                                                    update):
+        config.side_effect = ['source', 'key']
+        fetch.configure_sources(update=True)
+        add_source.assert_called_with('source', 'key')
+        self.assertTrue(update.called)
+
+
+class InstallTest(TestCase):
+
+    def setUp(self):
+        super(InstallTest, self).setUp()
+        self.valid_urls = (
+            "http://example.com/foo.tar.gz",
+            "http://example.com/foo.tgz",
+            "http://example.com/foo.tar.bz2",
+            "http://example.com/foo.tbz2",
+            "http://example.com/foo.zip",
+            "http://example.com/foo.zip?bar=baz&x=y#whee",
+            "ftp://example.com/foo.tar.gz",
+            "https://example.com/foo.tgz",
+            "file://example.com/foo.tar.bz2",
+            "bzr+ssh://example.com/branch-name",
+            "bzr+ssh://example.com/branch-name/",
+            "lp:branch-name",
+            "lp:example/branch-name",
+        )
+        self.invalid_urls = (
+            "git://example.com/foo.tar.gz",
+            "http://example.com/foo",
+            "http://example.com/foobar=baz&x=y#tar.gz",
+            "http://example.com/foobar?h=baz.zip",
+            "abc:example",
+            "file//example.com/foo.tar.bz2",
+            "garbage",
+        )
+
+    @patch('charmhelpers.fetch.log')
+    @patch('charmhelpers.fetch.plugins')
+    def test_installs_remote(self, _plugins, _log):
+        h1 = MagicMock(name="h1")
+        h1.can_handle.return_value = "Nope"
+
+        h2 = MagicMock(name="h2")
+        h2.can_handle.return_value = True
+        h2.install.side_effect = fetch.UnhandledSource()
+
+        h3 = MagicMock(name="h3")
+        h3.can_handle.return_value = True
+        h3.install.return_value = "foo"
+
+        _plugins.return_value = [h1, h2, h3]
+        for url in self.valid_urls:
+            result = fetch.install_remote(url)
+
+            h1.can_handle.assert_called_with(url)
+            h2.can_handle.assert_called_with(url)
+            h3.can_handle.assert_called_with(url)
+
+            h1.install.assert_not_called()
+            h2.install.assert_called_with(url)
+            h3.install.assert_called_with(url)
+
+            self.assertEqual(result, "foo")
+
+        fetch.install_remote('url', extra_arg=True)
+        h2.install.assert_called_with('url', extra_arg=True)
+
+    @patch('charmhelpers.fetch.install_remote')
+    @patch('charmhelpers.fetch.config')
+    def test_installs_from_config(self, _config, _instrem):
+        for url in self.valid_urls:
+            _config.return_value = {"foo": url}
+            fetch.install_from_config("foo")
+            _instrem.assert_called_with(url)
+
+
+class PluginTest(TestCase):
+
+    @patch('charmhelpers.fetch.importlib.import_module')
+    def test_imports_plugins(self, import_):
+        fetch_handlers = ['a.foo', 'b.foo', 'c.foo']
+        module = MagicMock()
+        import_.return_value = module
+        plugins = fetch.plugins(fetch_handlers)
+
+        self.assertEqual(len(fetch_handlers), len(plugins))
+        module.foo.assert_has_calls(([call()] * len(fetch_handlers)))
+
+    @patch('charmhelpers.fetch.importlib.import_module')
+    def test_imports_plugins_default(self, import_):
+        module = MagicMock()
+        import_.return_value = module
+        plugins = fetch.plugins()
+
+        self.assertEqual(len(fetch.FETCH_HANDLERS), len(plugins))
+        for handler in fetch.FETCH_HANDLERS:
+            classname = handler.rsplit('.', 1)[-1]
+            getattr(module, classname).assert_called_with()
+
+    @patch('charmhelpers.fetch.log')
+    @patch('charmhelpers.fetch.importlib.import_module')
+    def test_skips_and_logs_missing_plugins(self, import_, log_):
+        fetch_handlers = ['a.foo', 'b.foo', 'c.foo']
+        import_.side_effect = (NotImplementedError, NotImplementedError,
+                               MagicMock())
+        plugins = fetch.plugins(fetch_handlers)
+
+        self.assertEqual(1, len(plugins))
+        self.assertEqual(2, log_.call_count)
+
+    @patch('charmhelpers.fetch.log')
+    @patch.object(fetch.importlib, 'import_module')
+    def test_plugins_are_valid(self, import_module, log_):
+        plugins = fetch.plugins()
+        self.assertEqual(len(fetch.FETCH_HANDLERS), len(plugins))
+
+
+class BaseFetchHandlerTest(TestCase):
+
+    def setUp(self):
+        super(BaseFetchHandlerTest, self).setUp()
+        self.test_urls = (
+            "http://example.com/foo?bar=baz&x=y#blarg",
+            "https://example.com/foo",
+            "ftp://example.com/foo",
+            "file://example.com/foo",
+            "git://github.com/foo/bar",
+            "bzr+ssh://bazaar.launchpad.net/foo/bar",
+            "bzr+http://bazaar.launchpad.net/foo/bar",
+            "garbage",
+        )
+        self.fh = fetch.BaseFetchHandler()
+
+    def test_handles_nothing(self):
+        for url in self.test_urls:
+            self.assertNotEqual(self.fh.can_handle(url), True)
+
+    def test_install_throws_unhandled(self):
+        for url in self.test_urls:
+            self.assertRaises(fetch.UnhandledSource, self.fh.install, url)
+
+    def test_parses_urls(self):
+        sample_url = "http://example.com/foo?bar=baz&x=y#blarg"
+        p = self.fh.parse_url(sample_url)
+        self.assertEqual(p, urlparse(sample_url))
+
+    def test_returns_baseurl(self):
+        sample_url = "http://example.com/foo?bar=baz&x=y#blarg"
+        expected_url = "http://example.com/foo"
+        u = self.fh.base_url(sample_url)
+        self.assertEqual(u, expected_url)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_centos.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_centos.py
new file mode 100644
index 0000000000000000000000000000000000000000..43ca852d3abc658d52c40cbb96ca28a2c0908a47
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_centos.py
@@ -0,0 +1,315 @@
+import subprocess
+import os
+
+from tests.helpers import patch_open
+from testtools import TestCase
+from mock import (
+    patch,
+    MagicMock,
+    call,
+)
+from charmhelpers.fetch import centos as fetch
+
+
+def getenv(update=None):
+    # return a copy of os.environ with update applied.
+    # this was necessary because some modules modify os.environment directly
+    copy = os.environ.copy()
+    if update is not None:
+        copy.update(update)
+    return copy
+
+
+class FetchTest(TestCase):
+
+    @patch("charmhelpers.fetch.log")
+    @patch('yum.YumBase.doPackageLists')
+    def test_filter_packages_missing_centos(self, yumBase, log):
+
+        class MockPackage:
+            def __init__(self, name):
+                self.base_package_name = name
+
+        yum_dict = {
+            'installed': {
+                MockPackage('vim')
+            },
+            'available': {
+                MockPackage('vim')
+            }
+        }
+        import yum
+        yum.YumBase.return_value.doPackageLists.return_value = yum_dict
+        result = fetch.filter_installed_packages(['vim', 'emacs'])
+        self.assertEquals(result, ['emacs'])
+
+    @patch("charmhelpers.fetch.log")
+    def test_filter_packages_none_missing_centos(self, log):
+
+        class MockPackage:
+            def __init__(self, name):
+                self.base_package_name = name
+
+        yum_dict = {
+            'installed': {
+                MockPackage('vim')
+            },
+            'available': {
+                MockPackage('vim')
+            }
+        }
+        import yum
+        yum.yumBase.return_value.doPackageLists.return_value = yum_dict
+        result = fetch.filter_installed_packages(['vim'])
+        self.assertEquals(result, [])
+
+    @patch('charmhelpers.fetch.centos.log')
+    @patch('yum.YumBase.doPackageLists')
+    def test_filter_packages_not_available_centos(self, yumBase, log):
+
+        class MockPackage:
+            def __init__(self, name):
+                self.base_package_name = name
+
+        yum_dict = {
+            'installed': {
+                MockPackage('vim')
+            }
+        }
+        import yum
+        yum.YumBase.return_value.doPackageLists.return_value = yum_dict
+
+        result = fetch.filter_installed_packages(['vim', 'joe'])
+        self.assertEquals(result, ['joe'])
+
+    @patch('charmhelpers.fetch.centos.log')
+    def test_add_source_none_centos(self, log):
+        fetch.add_source(source=None)
+        self.assertTrue(log.called)
+
+    @patch('charmhelpers.fetch.centos.log')
+    @patch('os.listdir')
+    def test_add_source_http_centos(self, listdir, log):
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            listdir.assert_called_with('/etc/yum.repos.d/')
+            mock_file.write.assert_has_calls([
+                call("[archive.ubuntu.com_ubuntu raring-backports main]\n"),
+                call("name=archive.ubuntu.com/ubuntu raring-backports main\n"),
+                call("baseurl=http://archive.ubuntu.com/ubuntu raring"
+                     "-backports main\n\n")])
+
+    @patch('charmhelpers.fetch.centos.log')
+    @patch('os.listdir')
+    @patch('subprocess.check_call')
+    def test_add_source_http_and_key_id_centos(self, check_call,
+                                               listdir, log):
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        key_id = "akey"
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source, key=key_id)
+            listdir.assert_called_with('/etc/yum.repos.d/')
+            mock_file.write.assert_has_calls([
+                call("[archive.ubuntu.com_ubuntu raring-backports main]\n"),
+                call("name=archive.ubuntu.com/ubuntu raring-backports main\n"),
+                call("baseurl=http://archive.ubuntu.com/ubuntu raring"
+                     "-backports main\n\n")])
+        check_call.assert_called_with(['rpm', '--import', key_id])
+
+    @patch('charmhelpers.fetch.centos.log')
+    @patch('os.listdir')
+    @patch('subprocess.check_call')
+    def test_add_source_https_and_key_id_centos(self, check_call,
+                                                listdir, log):
+        source = "https://USER:PASS@private-ppa.launchpad.net/project/awesome"
+        key_id = "GPGPGP"
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source, key=key_id)
+            listdir.assert_called_with('/etc/yum.repos.d/')
+            mock_file.write.assert_has_calls([
+                call("[_USER:PASS@private-ppa.launchpad"
+                     ".net_project_awesome]\n"),
+                call("name=/USER:PASS@private-ppa.launchpad.net"
+                     "/project/awesome\n"),
+                call("baseurl=https://USER:PASS@private-ppa.launchpad.net"
+                     "/project/awesome\n\n")])
+        check_call.assert_called_with(['rpm', '--import', key_id])
+
+    @patch('charmhelpers.fetch.centos.log')
+    @patch.object(fetch, 'NamedTemporaryFile')
+    @patch('os.listdir')
+    @patch('subprocess.check_call')
+    def test_add_source_http_and_key_centos(self, check_call,
+                                            listdir, temp_file, log):
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        key = '''
+            -----BEGIN PGP PUBLIC KEY BLOCK-----
+            [...]
+            -----END PGP PUBLIC KEY BLOCK-----
+            '''
+        file_mock = MagicMock()
+        file_mock.name = 'temporary_file'
+        temp_file.return_value.__enter__.return_value = file_mock
+        listdir.return_value = []
+
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source, key=key)
+            listdir.assert_called_with('/etc/yum.repos.d/')
+            self.assertTrue(log.called)
+        check_call.assert_called_with(['rpm', '--import', file_mock.name])
+        file_mock.write.assert_called_once_with(key)
+        file_mock.flush.assert_called_once_with()
+        file_mock.seek.assert_called_once_with(0)
+
+
+class YumTests(TestCase):
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_yum_upgrade_non_fatal(self, log, mock_call):
+        options = ['--foo', '--bar']
+        fetch.upgrade(options)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      '--foo', '--bar', 'upgrade'],
+                                     env=getenv())
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_yum_upgrade_fatal(self, log, mock_call):
+        options = ['--foo', '--bar']
+        fetch.upgrade(options, fatal=True)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      '--foo', '--bar', 'upgrade'],
+                                     env=getenv())
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_installs_yum_packages(self, log, mock_call):
+        packages = ['foo', 'bar']
+        options = ['--foo', '--bar']
+
+        fetch.install(packages, options)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      '--foo', '--bar', 'install',
+                                      'foo', 'bar'],
+                                     env=getenv())
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_installs_yum_packages_without_options(self, log, mock_call):
+        packages = ['foo', 'bar']
+        fetch.install(packages)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      'install', 'foo', 'bar'],
+                                     env=getenv())
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_installs_yum_packages_as_string(self, log, mock_call):
+        packages = 'foo bar'
+        fetch.install(packages)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      'install', 'foo bar'],
+                                     env=getenv())
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_installs_yum_packages_with_possible_errors(self, log, mock_call):
+        packages = ['foo', 'bar']
+        options = ['--foo', '--bar']
+
+        fetch.install(packages, options, fatal=True)
+
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      '--foo', '--bar',
+                                      'install', 'foo', 'bar'],
+                                     env=getenv())
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_purges_yum_packages_as_string_fatal(self, log, mock_call):
+        packages = 'irrelevant names'
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.purge, packages, fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_purges_yum_packages_fatal(self, log, mock_call):
+        packages = ['irrelevant', 'names']
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.purge, packages, fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_purges_yum_packages_as_string_nofatal(self, log, mock_call):
+        packages = 'foo bar'
+        fetch.purge(packages)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      'remove', 'foo bar'],
+                                     env=getenv())
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_purges_yum_packages_nofatal(self, log, mock_call):
+        packages = ['foo', 'bar']
+        fetch.purge(packages)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(['yum', '--assumeyes',
+                                      'remove', 'foo', 'bar'],
+                                     env=getenv())
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_yum_update_fatal(self, log, check_call):
+        fetch.update(fatal=True)
+        check_call.assert_called_with(['yum', '--assumeyes', 'update'],
+                                      env=getenv())
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_output')
+    @patch('charmhelpers.fetch.centos.log')
+    def test_yum_search(self, log, check_output):
+        package = ['irrelevant']
+
+        from charmhelpers.fetch.centos import yum_search
+        yum_search(package)
+        check_output.assert_called_with(['yum', 'search', 'irrelevant'])
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_call')
+    @patch('time.sleep')
+    def test_run_yum_command_retries_if_fatal(self, check_call, sleep):
+        """The _run_yum_command function retries the command if it can't get
+        the YUM lock."""
+        self.called = False
+
+        def side_effect(*args, **kwargs):
+            """
+            First, raise an exception (can't acquire lock), then return 0
+            (the lock is grabbed).
+            """
+            if not self.called:
+                self.called = True
+                raise subprocess.CalledProcessError(
+                    returncode=1, cmd="some command")
+            else:
+                return 0
+
+        check_call.side_effect = side_effect
+        check_call.return_value = 0
+        from charmhelpers.fetch.centos import _run_yum_command
+        _run_yum_command(["some", "command"], fatal=True)
+        self.assertTrue(sleep.called)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu.py
new file mode 100644
index 0000000000000000000000000000000000000000..506746181990a861b254c774e03393e4a0dced16
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu.py
@@ -0,0 +1,1019 @@
+import six
+import subprocess
+import io
+import os
+
+from tests.helpers import patch_open
+from testtools import TestCase
+from mock import (
+    patch,
+    MagicMock,
+    call,
+    sentinel,
+)
+from charmhelpers.fetch import ubuntu as fetch
+
+if six.PY3:
+    builtin_open = 'builtins.open'
+else:
+    builtin_open = '__builtin__.open'
+
+# mocked return of openstack.get_distrib_codename()
+FAKE_CODENAME = 'precise'
+
+url = 'deb ' + fetch.CLOUD_ARCHIVE_URL
+UCA_SOURCES = [
+    ('cloud:precise-folsom/proposed', url + ' precise-proposed/folsom main'),
+    ('cloud:precise-folsom', url + ' precise-updates/folsom main'),
+    ('cloud:precise-folsom/updates', url + ' precise-updates/folsom main'),
+    ('cloud:precise-grizzly/proposed', url + ' precise-proposed/grizzly main'),
+    ('cloud:precise-grizzly', url + ' precise-updates/grizzly main'),
+    ('cloud:precise-grizzly/updates', url + ' precise-updates/grizzly main'),
+    ('cloud:precise-havana/proposed', url + ' precise-proposed/havana main'),
+    ('cloud:precise-havana', url + ' precise-updates/havana main'),
+    ('cloud:precise-havana/updates', url + ' precise-updates/havana main'),
+    ('cloud:precise-icehouse/proposed',
+     url + ' precise-proposed/icehouse main'),
+    ('cloud:precise-icehouse', url + ' precise-updates/icehouse main'),
+    ('cloud:precise-icehouse/updates', url + ' precise-updates/icehouse main'),
+]
+
+PGP_KEY_ASCII_ARMOR = """-----BEGIN PGP PUBLIC KEY BLOCK-----
+Version: SKS 1.1.5
+Comment: Hostname: keyserver.ubuntu.com
+
+mI0EUCEyTAEEAMuUxyfiegCCwn4J/c0nw5PUTSJdn5FqiUTq6iMfij65xf1vl0g/Mxqw0gfg
+AJIsCDvO9N9dloLAwF6FUBMg5My7WyhRPTAKF505TKJboyX3Pp4J1fU1LV8QFVOp87vUh1Rz
+B6GU7cSglhnbL85gmbJTllkzkb3h4Yw7W+edjcQ/ABEBAAG0K0xhdW5jaHBhZCBQUEEgZm9y
+IFVidW50dSBDbG91ZCBBcmNoaXZlIFRlYW2IuAQTAQIAIgUCUCEyTAIbAwYLCQgHAwIGFQgC
+CQoLBBYCAwECHgECF4AACgkQimhEop9oEE7kJAP/eTBgq3Mhbvo0d8elMOuqZx3nmU7gSyPh
+ep0zYIRZ5TJWl/7PRtvp0CJA6N6ZywYTQ/4ANHhpibcHZkh8K0AzUvsGXnJRSFoJeqyDbD91
+EhoO+4ZfHs2HvRBQEDZILMa2OyuB497E5Mmyua3HDEOrG2cVLllsUZzpTFCx8NgeMHk=
+=jLBm
+-----END PGP PUBLIC KEY BLOCK-----"""
+
+PGP_KEY_BIN_PGP = b'\x98\x8d\x04P!2L\x01\x04\x00\xcb\x94\xc7\'\xe2z\x00\x82\xc2~\t\xfd\xcd\'\xc3\x93\xd4M"]\x9f\x91j\x89D\xea\xea#\x1f\x8a>\xb9\xc5\xfdo\x97H?3\x1a\xb0\xd2\x07\xe0\x00\x92,\x08;\xce\xf4\xdf]\x96\x82\xc0\xc0^\x85P\x13 \xe4\xcc\xbb[(Q=0\n\x17\x9d9L\xa2[\xa3%\xf7>\x9e\t\xd5\xf55-_\x10\x15S\xa9\xf3\xbb\xd4\x87Ts\x07\xa1\x94\xed\xc4\xa0\x96\x19\xdb/\xce`\x99\xb2S\x96Y3\x91\xbd\xe1\xe1\x8c;[\xe7\x9d\x8d\xc4?\x00\x11\x01\x00\x01\xb4+Launchpad PPA for Ubuntu Cloud Archive Team\x88\xb8\x04\x13\x01\x02\x00"\x05\x02P!2L\x02\x1b\x03\x06\x0b\t\x08\x07\x03\x02\x06\x15\x08\x02\t\n\x0b\x04\x16\x02\x03\x01\x02\x1e\x01\x02\x17\x80\x00\n\t\x10\x8ahD\xa2\x9fh\x10N\xe4$\x03\xffy0`\xabs!n\xfa4w\xc7\xa50\xeb\xaag\x1d\xe7\x99N\xe0K#\xe1z\x9d3`\x84Y\xe52V\x97\xfe\xcfF\xdb\xe9\xd0"@\xe8\xde\x99\xcb\x06\x13C\xfe\x004xi\x89\xb7\x07fH|+@3R\xfb\x06^rQHZ\tz\xac\x83l?u\x12\x1a\x0e\xfb\x86_\x1e\xcd\x87\xbd\x10P\x106H,\xc6\xb6;+\x81\xe3\xde\xc4\xe4\xc9\xb2\xb9\xad\xc7\x0cC\xab\x1bg\x15.YlQ\x9c\xe9LP\xb1\xf0\xd8\x1e0y'  # noqa
+
+# a keyid can be retrieved by the ASCII armor-encoded key using this:
+# cat testkey.asc | gpg --with-colons --import-options import-show --dry-run
+# --import
+PGP_KEY_ID = '8a6844a29f68104e'
+
+FAKE_APT_CACHE = {
+    # an installed package
+    'vim': {
+        'current_ver': '2:7.3.547-6ubuntu5'
+    },
+    # a uninstalled installation candidate
+    'emacs': {
+    }
+}
+
+
+def fake_apt_cache(in_memory=True, progress=None):
+    def _get(package):
+        pkg = MagicMock()
+        if package not in FAKE_APT_CACHE:
+            raise KeyError
+        pkg.name = package
+        if 'current_ver' in FAKE_APT_CACHE[package]:
+            pkg.current_ver.ver_str = FAKE_APT_CACHE[package]['current_ver']
+        else:
+            pkg.current_ver = None
+        return pkg
+    cache = MagicMock()
+    cache.__getitem__.side_effect = _get
+    return cache
+
+
+class FetchTest(TestCase):
+
+    def setUp(self):
+        super(FetchTest, self).setUp()
+        self.patch(fetch, 'get_apt_dpkg_env', lambda: {})
+
+    @patch("charmhelpers.fetch.ubuntu.log")
+    @patch.object(fetch, 'apt_cache')
+    def test_filter_packages_missing_ubuntu(self, cache, log):
+        cache.side_effect = fake_apt_cache
+        result = fetch.filter_installed_packages(['vim', 'emacs'])
+        self.assertEquals(result, ['emacs'])
+
+    @patch("charmhelpers.fetch.ubuntu.log")
+    @patch.object(fetch, 'apt_cache')
+    def test_filter_packages_none_missing_ubuntu(self, cache, log):
+        cache.side_effect = fake_apt_cache
+        result = fetch.filter_installed_packages(['vim'])
+        self.assertEquals(result, [])
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'apt_cache')
+    def test_filter_packages_not_available_ubuntu(self, cache, log):
+        cache.side_effect = fake_apt_cache
+        result = fetch.filter_installed_packages(['vim', 'joe'])
+        self.assertEquals(result, ['joe'])
+        log.assert_called_with('Package joe has no installation candidate.',
+                               level='WARNING')
+
+    @patch('charmhelpers.fetch.ubuntu.filter_installed_packages')
+    def test_filter_missing_packages(self, filter_installed_packages):
+        filter_installed_packages.return_value = ['pkga']
+        self.assertEqual(['pkgb'],
+                         fetch.filter_missing_packages(['pkga', 'pkgb']))
+
+    @patch.object(fetch, 'log', lambda *args, **kwargs: None)
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    def test_import_apt_key_radix(self, dearmor_gpg_key,
+                                  w_keyfile):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        with patch('subprocess.check_output') as _subp_check_output:
+            curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                                 '/pks/lookup?op=get&options=mr'
+                                 '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+            def check_output_side_effect(command, env):
+                return {
+                    ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+                }[' '.join(command)]
+            _subp_check_output.side_effect = check_output_side_effect
+
+            fetch.import_key(PGP_KEY_ID)
+            _subp_check_output.assert_called_with(curl_cmd, env=None)
+        w_keyfile.assert_called_once_with(key_name=PGP_KEY_ID,
+                                          key_material=PGP_KEY_BIN_PGP)
+
+    @patch.object(fetch, 'log', lambda *args, **kwargs: None)
+    @patch.object(os, 'getenv')
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    def test_import_apt_key_radix_https_proxy(self, dearmor_gpg_key,
+                                              w_keyfile, getenv):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        def get_env_side_effect(var):
+            return {
+                'HTTPS_PROXY': 'http://squid.internal:3128',
+                'JUJU_CHARM_HTTPS_PROXY': None,
+            }[var]
+        getenv.side_effect = get_env_side_effect
+
+        with patch('subprocess.check_output') as _subp_check_output:
+            proxy_settings = {
+                'HTTPS_PROXY': 'http://squid.internal:3128',
+                'https_proxy': 'http://squid.internal:3128',
+            }
+            curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                                 '/pks/lookup?op=get&options=mr'
+                                 '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+            def check_output_side_effect(command, env):
+                return {
+                    ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+                }[' '.join(command)]
+            _subp_check_output.side_effect = check_output_side_effect
+
+            fetch.import_key(PGP_KEY_ID)
+            _subp_check_output.assert_called_with(curl_cmd, env=proxy_settings)
+        w_keyfile.assert_called_once_with(key_name=PGP_KEY_ID,
+                                          key_material=PGP_KEY_BIN_PGP)
+
+    @patch.object(fetch, 'log', lambda *args, **kwargs: None)
+    @patch.object(os, 'getenv')
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    def test_import_apt_key_radix_charm_https_proxy(self, dearmor_gpg_key,
+                                                    w_keyfile, getenv):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        def get_env_side_effect(var):
+            return {
+                'HTTPS_PROXY': None,
+                'JUJU_CHARM_HTTPS_PROXY': 'http://squid.internal:3128',
+            }[var]
+        getenv.side_effect = get_env_side_effect
+
+        with patch('subprocess.check_output') as _subp_check_output:
+            proxy_settings = {
+                'HTTPS_PROXY': 'http://squid.internal:3128',
+                'https_proxy': 'http://squid.internal:3128',
+            }
+            curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                                 '/pks/lookup?op=get&options=mr'
+                                 '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+            def check_output_side_effect(command, env):
+                return {
+                    ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+                }[' '.join(command)]
+            _subp_check_output.side_effect = check_output_side_effect
+
+            fetch.import_key(PGP_KEY_ID)
+            _subp_check_output.assert_called_with(curl_cmd, env=proxy_settings)
+        w_keyfile.assert_called_once_with(key_name=PGP_KEY_ID,
+                                          key_material=PGP_KEY_BIN_PGP)
+
+    @patch.object(fetch, 'log', lambda *args, **kwargs: None)
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('subprocess.check_output')
+    def test_import_bad_apt_key(self, check_output, dearmor_gpg_key):
+        """Ensure error when importing apt key fails"""
+        errmsg = ('Invalid GPG key material. Check your network setup'
+                  ' (MTU, routing, DNS) and/or proxy server settings'
+                  ' as well as destination keyserver status.')
+        bad_keyid = 'foo'
+
+        curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                             '/pks/lookup?op=get&options=mr'
+                             '&exact=on&search=0x{}').format(bad_keyid)]
+
+        def check_output_side_effect(command, env):
+            return {
+                ' '.join(curl_cmd): 'foobar',
+            }[' '.join(command)]
+        check_output.side_effect = check_output_side_effect
+
+        def dearmor_side_effect(key_asc):
+            raise fetch.GPGKeyError(errmsg)
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+        try:
+            fetch.import_key(bad_keyid)
+            assert False
+        except fetch.GPGKeyError as e:
+            self.assertEqual(str(e), errmsg)
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_add_source_none_ubuntu(self, log):
+        fetch.add_source(source=None)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_call')
+    def test_add_source_ppa(self, check_call):
+        source = "ppa:test-ppa"
+        fetch.add_source(source=source)
+        check_call.assert_called_with(
+            ['add-apt-repository', '--yes', source], env={})
+
+    @patch("charmhelpers.fetch.ubuntu.log")
+    @patch('subprocess.check_call')
+    @patch('time.sleep')
+    def test_add_source_ppa_retries_30_times(self, sleep, check_call, log):
+        self.call_count = 0
+
+        def side_effect(*args, **kwargs):
+            """Raise an 3 times, then return 0 """
+            self.call_count += 1
+            if self.call_count <= fetch.CMD_RETRY_COUNT:
+                raise subprocess.CalledProcessError(
+                    returncode=1, cmd="some add-apt-repository command")
+            else:
+                return 0
+        check_call.side_effect = side_effect
+
+        source = "ppa:test-ppa"
+        fetch.add_source(source=source)
+        check_call.assert_called_with(
+            ['add-apt-repository', '--yes', source], env={})
+        sleep.assert_called_with(10)
+        self.assertTrue(fetch.CMD_RETRY_COUNT, sleep.call_count)
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_call')
+    def test_add_source_http_ubuntu(self, check_call, log):
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        fetch.add_source(source=source)
+        check_call.assert_called_with(
+            ['add-apt-repository', '--yes', source], env={})
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_call')
+    def test_add_source_https(self, check_call, log):
+        source = "https://example.com"
+        fetch.add_source(source=source)
+        check_call.assert_called_with(
+            ['add-apt-repository', '--yes', source], env={})
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_call')
+    def test_add_source_deb(self, check_call, log):
+        """add-apt-repository behaves differently when using the deb prefix.
+
+        $ add-apt-repository --yes \
+            "http://special.example.com/ubuntu precise-special main"
+        $ grep special /etc/apt/sources.list
+        deb http://special.example.com/ubuntu precise precise-special main
+        deb-src http://special.example.com/ubuntu precise precise-special main
+
+        $ add-apt-repository --yes \
+            "deb http://special.example.com/ubuntu precise-special main"
+        $ grep special /etc/apt/sources.list
+        deb http://special.example.com/ubuntu precise precise-special main
+        deb-src http://special.example.com/ubuntu precise precise-special main
+        deb http://special.example.com/ubuntu precise-special main
+        deb-src http://special.example.com/ubuntu precise-special main
+        """
+        source = "deb http://archive.ubuntu.com/ubuntu raring-backports main"
+        fetch.add_source(source=source)
+        check_call.assert_called_with(
+            ['add-apt-repository', '--yes', source], env={})
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_add_source_http_and_key_id(self, check_call, check_output, log,
+                                        dearmor_gpg_key,
+                                        w_keyfile):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                             '/pks/lookup?op=get&options=mr'
+                             '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+        def check_output_side_effect(command, env):
+            return {
+                ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+            }[' '.join(command)]
+        check_output.side_effect = check_output_side_effect
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        check_call.return_value = 0  # Successful exit code
+        fetch.add_source(source=source, key=PGP_KEY_ID)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+        check_output.assert_has_calls([
+            call(['curl', ('https://keyserver.ubuntu.com'
+                           '/pks/lookup?op=get&options=mr'
+                           '&exact=on&search=0x{}').format(PGP_KEY_ID)],
+                 env=None),
+        ])
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_add_source_https_and_key_id(self, check_call, check_output, log,
+                                         dearmor_gpg_key,
+                                         w_keyfile):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                             '/pks/lookup?op=get&options=mr'
+                             '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+        def check_output_side_effect(command, env):
+            return {
+                ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+            }[' '.join(command)]
+        check_output.side_effect = check_output_side_effect
+
+        check_call.return_value = 0
+
+        source = "https://USER:PASS@private-ppa.launchpad.net/project/awesome"
+        fetch.add_source(source=source, key=PGP_KEY_ID)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+        check_output.assert_has_calls([
+            call(['curl', ('https://keyserver.ubuntu.com'
+                           '/pks/lookup?op=get&options=mr'
+                           '&exact=on&search=0x{}').format(PGP_KEY_ID)],
+                 env=None),
+        ])
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch('subprocess.check_call')
+    @patch('subprocess.Popen')
+    def test_add_source_http_and_key_gpg1(self, popen, check_call,
+                                          get_distrib_codename, log,
+                                          dearmor_gpg_key,
+                                          w_keyfile):
+
+        def check_call_side_effect(*args, **kwargs):
+            # Make sure the gpg key has already been added before the
+            # add-apt-repository call, as the update could fail otherwise.
+            popen.assert_called_with(
+                ['gpg', '--with-colons', '--with-fingerprint'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                stdin=subprocess.PIPE)
+            return 0
+
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        key = PGP_KEY_ASCII_ARMOR
+        key_bytes = PGP_KEY_ASCII_ARMOR.encode('utf-8')
+        get_distrib_codename.return_value = 'trusty'
+        check_call.side_effect = check_call_side_effect
+
+        expected_key = '35F77D63B5CEC106C577ED856E85A86E4652B4E6'
+        if six.PY3:
+            popen.return_value.communicate.return_value = [b"""
+pub:-:1024:1:6E85A86E4652B4E6:2009-01-18:::-:Launchpad PPA for Landscape:
+fpr:::::::::35F77D63B5CEC106C577ED856E85A86E4652B4E6:
+            """, b'']
+        else:
+            popen.return_value.communicate.return_value = ["""
+pub:-:1024:1:6E85A86E4652B4E6:2009-01-18:::-:Launchpad PPA for Landscape:
+fpr:::::::::35F77D63B5CEC106C577ED856E85A86E4652B4E6:
+            """, '']
+
+        dearmor_gpg_key.return_value = PGP_KEY_BIN_PGP
+
+        fetch.add_source(source=source, key=key)
+        popen.assert_called_with(
+            ['gpg', '--with-colons', '--with-fingerprint'],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            stdin=subprocess.PIPE)
+        dearmor_gpg_key.assert_called_with(key_bytes)
+        w_keyfile.assert_called_with(key_name=expected_key,
+                                     key_material=PGP_KEY_BIN_PGP)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch('subprocess.check_call')
+    @patch('subprocess.Popen')
+    def test_add_source_http_and_key_gpg2(self, popen, check_call,
+                                          get_distrib_codename, log,
+                                          dearmor_gpg_key,
+                                          w_keyfile):
+
+        def check_call_side_effect(*args, **kwargs):
+            # Make sure the gpg key has already been added before the
+            # add-apt-repository call, as the update could fail otherwise.
+            popen.assert_called_with(
+                ['gpg', '--with-colons', '--with-fingerprint'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                stdin=subprocess.PIPE)
+            return 0
+
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        key = PGP_KEY_ASCII_ARMOR
+        key_bytes = PGP_KEY_ASCII_ARMOR.encode('utf-8')
+        get_distrib_codename.return_value = 'bionic'
+        check_call.side_effect = check_call_side_effect
+
+        expected_key = '35F77D63B5CEC106C577ED856E85A86E4652B4E6'
+
+        if six.PY3:
+            popen.return_value.communicate.return_value = [b"""
+fpr:::::::::35F77D63B5CEC106C577ED856E85A86E4652B4E6:
+uid:-::::1232306042::52FE92E6867B4C099AA1A1877A804A965F41A98C::ppa::::::::::0:
+            """, b'']
+        else:
+            # python2 on a distro with gpg2 (unlikely, but possible)
+            popen.return_value.communicate.return_value = ["""
+fpr:::::::::35F77D63B5CEC106C577ED856E85A86E4652B4E6:
+uid:-::::1232306042::52FE92E6867B4C099AA1A1877A804A965F41A98C::ppa::::::::::0:
+            """, '']
+
+        dearmor_gpg_key.return_value = PGP_KEY_BIN_PGP
+
+        fetch.add_source(source=source, key=key)
+        popen.assert_called_with(
+            ['gpg', '--with-colons', '--with-fingerprint'],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            stdin=subprocess.PIPE)
+        dearmor_gpg_key.assert_called_with(key_bytes)
+        w_keyfile.assert_called_with(key_name=expected_key,
+                                     key_material=PGP_KEY_BIN_PGP)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+
+    def test_add_source_cloud_invalid_pocket(self):
+        source = "cloud:havana-updates"
+        self.assertRaises(fetch.SourceConfigError,
+                          fetch.add_source, source)
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    @patch.object(fetch, 'get_distrib_codename')
+    def test_add_source_cloud_pocket_style(self, get_distrib_codename,
+                                           apt_install,
+                                           filter_pkg, log):
+        source = "cloud:precise-updates/havana"
+        get_distrib_codename.return_value = 'precise'
+        result = ('# Ubuntu Cloud Archive\n'
+                  'deb http://ubuntu-cloud.archive.canonical.com/ubuntu'
+                  ' precise-updates/havana main\n')
+
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    @patch.object(fetch, 'get_distrib_codename')
+    def test_add_source_cloud_os_style(self, get_distrib_codename, apt_install,
+                                       filter_pkg, log):
+        source = "cloud:precise-havana"
+        get_distrib_codename.return_value = 'precise'
+        result = ('# Ubuntu Cloud Archive\n'
+                  'deb http://ubuntu-cloud.archive.canonical.com/ubuntu'
+                  ' precise-updates/havana main\n')
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'filter_installed_packages')
+    @patch.object(fetch, 'apt_install')
+    def test_add_source_cloud_distroless_style(self, apt_install,
+                                               filter_pkg, log):
+        source = "cloud:havana"
+        result = ('# Ubuntu Cloud Archive\n'
+                  'deb http://ubuntu-cloud.archive.canonical.com/ubuntu'
+                  ' precise-updates/havana main\n')
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            mock_file.write.assert_called_with(result)
+        filter_pkg.assert_called_with(['ubuntu-cloud-keyring'])
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch('platform.machine')
+    def test_add_source_proposed_x86_64(self, _machine,
+                                        get_distrib_codename, log):
+        source = "proposed"
+        result = ('# Proposed\n'
+                  'deb http://archive.ubuntu.com/ubuntu precise-proposed'
+                  ' main universe multiverse restricted\n')
+        get_distrib_codename.return_value = 'precise'
+        _machine.return_value = 'x86_64'
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            mock_file.write.assert_called_with(result)
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch.object(fetch, 'get_distrib_codename')
+    @patch('platform.machine')
+    def test_add_source_proposed_ppc64le(self, _machine,
+                                         get_distrib_codename, log):
+        source = "proposed"
+        result = (
+            "# Proposed\n"
+            "deb http://ports.ubuntu.com/ubuntu-ports precise-proposed main "
+            "universe multiverse restricted\n")
+        get_distrib_codename.return_value = 'precise'
+        _machine.return_value = 'ppc64le'
+        with patch_open() as (mock_open, mock_file):
+            fetch.add_source(source=source)
+            mock_file.write.assert_called_with(result)
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_add_source_http_and_key_id_ubuntu(self, check_call, check_output,
+                                               log, dearmor_gpg_key,
+                                               w_keyfile):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                             '/pks/lookup?op=get&options=mr'
+                             '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+        def check_output_side_effect(command, env):
+            return {
+                ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+            }[' '.join(command)]
+        check_output.side_effect = check_output_side_effect
+        check_call.return_value = 0
+        source = "http://archive.ubuntu.com/ubuntu raring-backports main"
+        key_id = PGP_KEY_ID
+        fetch.add_source(source=source, key=key_id)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+        check_output.assert_has_calls([
+            call(['curl', ('https://keyserver.ubuntu.com'
+                           '/pks/lookup?op=get&options=mr'
+                           '&exact=on&search=0x{}').format(PGP_KEY_ID)],
+                 env=None),
+        ])
+
+    @patch.object(fetch, '_write_apt_gpg_keyfile')
+    @patch.object(fetch, '_dearmor_gpg_key')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    @patch('subprocess.check_output')
+    @patch('subprocess.check_call')
+    def test_add_source_https_and_key_id_ubuntu(self, check_call, check_output,
+                                                log, dearmor_gpg_key,
+                                                w_keyfile):
+        def dearmor_side_effect(key_asc):
+            return {
+                PGP_KEY_ASCII_ARMOR: PGP_KEY_BIN_PGP,
+            }[key_asc]
+        dearmor_gpg_key.side_effect = dearmor_side_effect
+
+        curl_cmd = ['curl', ('https://keyserver.ubuntu.com'
+                             '/pks/lookup?op=get&options=mr'
+                             '&exact=on&search=0x{}').format(PGP_KEY_ID)]
+
+        def check_output_side_effect(command, env):
+            return {
+                ' '.join(curl_cmd): PGP_KEY_ASCII_ARMOR,
+            }[' '.join(command)]
+        check_output.side_effect = check_output_side_effect
+        check_call.return_value = 0
+
+        source = "https://USER:PASS@private-ppa.launchpad.net/project/awesome"
+        fetch.add_source(source=source, key=PGP_KEY_ID)
+        check_call.assert_any_call(
+            ['add-apt-repository', '--yes', source], env={}),
+        check_output.assert_has_calls([
+            call(['curl', ('https://keyserver.ubuntu.com'
+                           '/pks/lookup?op=get&options=mr'
+                           '&exact=on&search=0x{}').format(PGP_KEY_ID)],
+                 env=None),
+        ])
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_configure_bad_install_source(self, log):
+        try:
+            fetch.add_source('foo', fail_invalid=True)
+            self.fail("Calling add_source('foo') should fail")
+        except fetch.SourceConfigError as e:
+            self.assertEqual(str(e), "Unknown source: 'foo'")
+
+    @patch('charmhelpers.fetch.ubuntu.get_distrib_codename')
+    def test_configure_install_source_uca_staging(self, _lsb):
+        """Test configuring installation source from UCA staging sources"""
+        _lsb.return_value = FAKE_CODENAME
+        # staging pockets are configured as PPAs
+        with patch('subprocess.check_call') as _subp:
+            src = 'cloud:precise-folsom/staging'
+            fetch.add_source(src)
+            cmd = ['add-apt-repository', '-y',
+                   'ppa:ubuntu-cloud-archive/folsom-staging']
+            _subp.assert_called_with(cmd, env={})
+
+    @patch(builtin_open)
+    @patch('charmhelpers.fetch.ubuntu.apt_install')
+    @patch('charmhelpers.fetch.ubuntu.get_distrib_codename')
+    @patch('charmhelpers.fetch.ubuntu.filter_installed_packages')
+    def test_configure_install_source_uca_repos(
+            self, _fip, _lsb, _install, _open):
+        """Test configuring installation source from UCA sources"""
+        _lsb.return_value = FAKE_CODENAME
+        _file = MagicMock(spec=io.FileIO)
+        _open.return_value = _file
+        _fip.side_effect = lambda x: x
+        for src, url in UCA_SOURCES:
+            actual_url = "# Ubuntu Cloud Archive\n{}\n".format(url)
+            fetch.add_source(src)
+            _install.assert_called_with(['ubuntu-cloud-keyring'],
+                                        fatal=True)
+            _open.assert_called_with(
+                '/etc/apt/sources.list.d/cloud-archive.list',
+                'w'
+            )
+            _file.__enter__().write.assert_called_with(actual_url)
+
+    def test_configure_install_source_bad_uca(self):
+        """Test configuring installation source from bad UCA source"""
+        try:
+            fetch.add_source('cloud:foo-bar', fail_invalid=True)
+            self.fail("add_source('cloud:foo-bar') should fail")
+        except fetch.SourceConfigError as e:
+            _e = ('Invalid Cloud Archive release specified: foo-bar'
+                  ' on this Ubuntuversion')
+            self.assertTrue(str(e).startswith(_e))
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_add_unparsable_source(self, log_):
+        source = "propsed"  # Minor typo
+        fetch.add_source(source=source)
+        self.assertEqual(1, log_.call_count)
+
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_add_distro_source(self, log):
+        source = "distro"
+        # distro is a noop but test validate no exception is thrown
+        fetch.add_source(source=source)
+
+
+class AptTests(TestCase):
+
+    def setUp(self):
+        super(AptTests, self).setUp()
+        self.patch(fetch, 'get_apt_dpkg_env', lambda: {})
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_apt_upgrade_non_fatal(self, log, mock_call):
+        options = ['--foo', '--bar']
+        fetch.apt_upgrade(options)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'upgrade'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_apt_upgrade_fatal(self, log, mock_call):
+        options = ['--foo', '--bar']
+        fetch.apt_upgrade(options, fatal=True)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'upgrade'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_apt_dist_upgrade_fatal(self, log, mock_call):
+        options = ['--foo', '--bar']
+        fetch.apt_upgrade(options, fatal=True, dist=True)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'dist-upgrade'],
+            env={})
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_installs_apt_packages(self, log, mock_call):
+        packages = ['foo', 'bar']
+        options = ['--foo', '--bar']
+
+        fetch.apt_install(packages, options)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'install', 'foo', 'bar'],
+            env={})
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_installs_apt_packages_without_options(self, log, mock_call):
+        packages = ['foo', 'bar']
+
+        fetch.apt_install(packages)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--option=Dpkg::Options::=--force-confold',
+             'install', 'foo', 'bar'],
+            env={})
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_installs_apt_packages_as_string(self, log, mock_call):
+        packages = 'foo bar'
+        options = ['--foo', '--bar']
+
+        fetch.apt_install(packages, options)
+
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'install', 'foo bar'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_installs_apt_packages_with_possible_errors(self, log,
+                                                        check_call):
+        packages = ['foo', 'bar']
+        options = ['--foo', '--bar']
+
+        fetch.apt_install(packages, options, fatal=True)
+
+        check_call.assert_called_with(
+            ['apt-get', '--assume-yes',
+             '--foo', '--bar', 'install', 'foo', 'bar'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_purges_apt_packages_as_string_fatal(self, log, mock_call):
+        packages = 'irrelevant names'
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.apt_purge, packages, fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_purges_apt_packages_fatal(self, log, mock_call):
+        packages = ['irrelevant', 'names']
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.apt_purge, packages, fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_purges_apt_packages_as_string_nofatal(self, log, mock_call):
+        packages = 'foo bar'
+
+        fetch.apt_purge(packages)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes', 'purge', 'foo bar'],
+            env={})
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_purges_apt_packages_nofatal(self, log, mock_call):
+        packages = ['foo', 'bar']
+
+        fetch.apt_purge(packages)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(
+            ['apt-get', '--assume-yes', 'purge', 'foo', 'bar'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_mark_apt_packages_as_string_fatal(self, log, mock_call):
+        packages = 'irrelevant names'
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.apt_mark, packages, sentinel.mark,
+                          fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_mark_apt_packages_fatal(self, log, mock_call):
+        packages = ['irrelevant', 'names']
+        mock_call.side_effect = OSError('fail')
+
+        self.assertRaises(OSError, fetch.apt_mark, packages, sentinel.mark,
+                          fatal=True)
+        self.assertTrue(log.called)
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_mark_apt_packages_as_string_nofatal(self, log, mock_call):
+        packages = 'foo bar'
+
+        fetch.apt_mark(packages, sentinel.mark)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(
+            ['apt-mark', sentinel.mark, 'foo bar'],
+            universal_newlines=True)
+
+    @patch('subprocess.call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_mark_apt_packages_nofatal(self, log, mock_call):
+        packages = ['foo', 'bar']
+
+        fetch.apt_mark(packages, sentinel.mark)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(
+            ['apt-mark', sentinel.mark, 'foo', 'bar'],
+            universal_newlines=True)
+
+    @patch('subprocess.check_call')
+    @patch('charmhelpers.fetch.ubuntu.log')
+    def test_mark_apt_packages_nofatal_abortonfatal(self, log, mock_call):
+        packages = ['foo', 'bar']
+
+        fetch.apt_mark(packages, sentinel.mark, fatal=True)
+
+        self.assertTrue(log.called)
+        mock_call.assert_called_with(
+            ['apt-mark', sentinel.mark, 'foo', 'bar'],
+            universal_newlines=True)
+
+    @patch('charmhelpers.fetch.ubuntu.apt_mark')
+    def test_apt_hold(self, apt_mark):
+        fetch.apt_hold(sentinel.packages)
+        apt_mark.assert_called_once_with(sentinel.packages, 'hold',
+                                         fatal=False)
+
+    @patch('charmhelpers.fetch.ubuntu.apt_mark')
+    def test_apt_hold_fatal(self, apt_mark):
+        fetch.apt_hold(sentinel.packages, fatal=sentinel.fatal)
+        apt_mark.assert_called_once_with(sentinel.packages, 'hold',
+                                         fatal=sentinel.fatal)
+
+    @patch('charmhelpers.fetch.ubuntu.apt_mark')
+    def test_apt_unhold(self, apt_mark):
+        fetch.apt_unhold(sentinel.packages)
+        apt_mark.assert_called_once_with(sentinel.packages, 'unhold',
+                                         fatal=False)
+
+    @patch('charmhelpers.fetch.ubuntu.apt_mark')
+    def test_apt_unhold_fatal(self, apt_mark):
+        fetch.apt_unhold(sentinel.packages, fatal=sentinel.fatal)
+        apt_mark.assert_called_once_with(sentinel.packages, 'unhold',
+                                         fatal=sentinel.fatal)
+
+    @patch('subprocess.check_call')
+    def test_apt_update_fatal(self, check_call):
+        fetch.apt_update(fatal=True)
+        check_call.assert_called_with(
+            ['apt-get', 'update'],
+            env={})
+
+    @patch('subprocess.call')
+    def test_apt_update_nonfatal(self, call):
+        fetch.apt_update()
+        call.assert_called_with(
+            ['apt-get', 'update'],
+            env={})
+
+    @patch('subprocess.check_call')
+    @patch('time.sleep')
+    def test_run_apt_command_retries_if_fatal(self, check_call, sleep):
+        """The _run_apt_command function retries the command if it can't get
+        the APT lock."""
+        self.called = False
+
+        def side_effect(*args, **kwargs):
+            """
+            First, raise an exception (can't acquire lock), then return 0
+            (the lock is grabbed).
+            """
+            if not self.called:
+                self.called = True
+                raise subprocess.CalledProcessError(
+                    returncode=100, cmd="some command")
+            else:
+                return 0
+
+        check_call.side_effect = side_effect
+        check_call.return_value = 0
+
+        from charmhelpers.fetch.ubuntu import _run_apt_command
+        _run_apt_command(["some", "command"], fatal=True)
+        self.assertTrue(sleep.called)
+
+    @patch.object(fetch, 'apt_cache')
+    def test_get_upstream_version(self, cache):
+        cache.side_effect = fake_apt_cache
+        self.assertEqual(fetch.get_upstream_version('vim'), '7.3.547')
+        self.assertEqual(fetch.get_upstream_version('emacs'), None)
+        self.assertEqual(fetch.get_upstream_version('unknown'), None)
+
+    @patch('charmhelpers.fetch.ubuntu._run_apt_command')
+    def test_apt_autoremove_fatal(self, run_apt_command):
+        fetch.apt_autoremove(purge=True, fatal=True)
+        run_apt_command.assert_called_with(
+            ['apt-get', '--assume-yes', 'autoremove', '--purge'],
+            True
+        )
+
+    @patch('charmhelpers.fetch.ubuntu._run_apt_command')
+    def test_apt_autoremove_nonfatal(self, run_apt_command):
+        fetch.apt_autoremove(purge=False, fatal=False)
+        run_apt_command.assert_called_with(
+            ['apt-get', '--assume-yes', 'autoremove'],
+            False
+        )
+
+
+class TestAptDpkgEnv(TestCase):
+
+    @patch.object(fetch, 'get_system_env')
+    def test_get_apt_dpkg_env(self, mock_get_system_env):
+        mock_get_system_env.return_value = '/a/path'
+        self.assertEquals(
+            fetch.get_apt_dpkg_env(),
+            {'DEBIAN_FRONTEND': 'noninteractive', 'PATH': '/a/path'})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu_apt_pkg.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu_apt_pkg.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0affc324568fc1290147b8b298af7a2b152a1df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_fetch_ubuntu_apt_pkg.py
@@ -0,0 +1,216 @@
+import mock
+import subprocess
+import unittest
+
+from charmhelpers.fetch import ubuntu_apt_pkg as apt_pkg
+
+
+class Test_apt_pkg_Cache(unittest.TestCase):
+    """Borrow PatchHelper methods from ``charms.openstack``."""
+    def setUp(self):
+        self._patches = {}
+        self._patches_start = {}
+
+    def tearDown(self):
+        for k, v in self._patches.items():
+            v.stop()
+            setattr(self, k, None)
+        self._patches = None
+        self._patches_start = None
+
+    def patch(self, patchee, name=None, **kwargs):
+        """Patch a patchable thing.  Uses mock.patch() to do the work.
+        Automatically unpatches at the end of the test.
+
+        The mock gets added to the test object (self) using 'name' or the last
+        part of the patchee string, after the final dot.
+
+        :param patchee: <string> representing module.object that is to be
+            patched.
+        :param name: optional <string> name to call the mock.
+        :param **kwargs: any other args to pass to mock.patch()
+        """
+        mocked = mock.patch(patchee, **kwargs)
+        if name is None:
+            name = patchee.split('.')[-1]
+        started = mocked.start()
+        self._patches[name] = mocked
+        self._patches_start[name] = started
+        setattr(self, name, started)
+
+    def patch_object(self, obj, attr, name=None, **kwargs):
+        """Patch a patchable thing.  Uses mock.patch.object() to do the work.
+        Automatically unpatches at the end of the test.
+
+        The mock gets added to the test object (self) using 'name' or the attr
+        passed in the arguments.
+
+        :param obj: an object that needs to have an attribute patched.
+        :param attr: <string> that represents the attribute being patched.
+        :param name: optional <string> name to call the mock.
+        :param **kwargs: any other args to pass to mock.patch()
+        """
+        mocked = mock.patch.object(obj, attr, **kwargs)
+        if name is None:
+            name = attr
+        started = mocked.start()
+        self._patches[name] = mocked
+        self._patches_start[name] = started
+        setattr(self, name, started)
+
+    def test_apt_cache_show(self):
+        self.patch_object(apt_pkg.subprocess, 'check_output')
+        apt_cache = apt_pkg.Cache()
+        self.check_output.return_value = (
+            'Package: dpkg\n'
+            'Version: 1.19.0.5ubuntu2.1\n'
+            'Bugs: https://bugs.launchpad.net/ubuntu/+filebug\n'
+            'Description-en: Debian package management system\n'
+            ' Multiline description\n'
+            '\n'
+            'Package: lsof\n'
+            'Architecture: amd64\n'
+            'Version: 4.91+dfsg-1ubuntu1\n'
+            '\n'
+            'N: There is 1 additional record.\n')
+        self.assertEquals(
+            apt_cache._apt_cache_show(['package']),
+            {'dpkg': {
+                'package': 'dpkg', 'version': '1.19.0.5ubuntu2.1',
+                'bugs': 'https://bugs.launchpad.net/ubuntu/+filebug',
+                'description-en': 'Debian package management system\n'
+                                  'Multiline description'},
+             'lsof': {
+                 'package': 'lsof', 'architecture': 'amd64',
+                 'version': '4.91+dfsg-1ubuntu1'},
+             })
+        self.check_output.assert_called_once_with(
+            ['apt-cache', 'show', '--no-all-versions', 'package'],
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+
+    def test_dpkg_list(self):
+        self.patch_object(apt_pkg.subprocess, 'check_output')
+        apt_cache = apt_pkg.Cache()
+        self.check_output.return_value = (
+            'Desired=Unknown/Install/Remove/Purge/Hold\n'
+            '| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/'
+            'trig-aWait/Trig-pend\n'
+            '|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)\n'
+            '||/ Name           Version            Architecture Description\n'
+            '+++-=============================-==================-===========-'
+            '=================================\n'
+            'ii  dpkg                          1.19.0.5ubuntu2.1  amd64       '
+            'Debian package management system\n'
+            'rc  linux-image-4.15.0-42-generic 4.15.0-42.45       amd64       '
+            'Signed kernel image generic\n'
+            'ii  lsof                          4.91+dfsg-1ubuntu1 amd64       '
+            'utility to list open files\n')
+        expect = {
+            'dpkg': {
+                'name': 'dpkg',
+                'version': '1.19.0.5ubuntu2.1',
+                'architecture': 'amd64',
+                'description': 'Debian package management system'
+            },
+            'lsof': {
+                'name': 'lsof',
+                'version': '4.91+dfsg-1ubuntu1',
+                'architecture': 'amd64',
+                'description': 'utility to list open files'
+            },
+        }
+        self.assertEquals(
+            apt_cache._dpkg_list(['package']), expect)
+        self.check_output.side_effect = subprocess.CalledProcessError(
+            1, '', output=self.check_output.return_value)
+        self.assertEquals(apt_cache._dpkg_list(['package']), expect)
+        self.check_output.side_effect = subprocess.CalledProcessError(2, '')
+        with self.assertRaises(subprocess.CalledProcessError):
+            _ = apt_cache._dpkg_list(['package'])
+
+    def test_version_compare(self):
+        self.patch_object(apt_pkg.subprocess, 'check_call')
+        self.assertEquals(apt_pkg.version_compare('2', '1'), 1)
+        self.check_call.assert_called_once_with(
+            ['dpkg', '--compare-versions', '2', 'gt', '1'],
+            stderr=subprocess.STDOUT,
+            universal_newlines=True)
+        self.check_call.side_effect = [
+            subprocess.CalledProcessError(1, '', ''),
+            None,
+            None,
+        ]
+        self.assertEquals(apt_pkg.version_compare('2', '2'), 0)
+        self.check_call.side_effect = [
+            subprocess.CalledProcessError(1, '', ''),
+            subprocess.CalledProcessError(1, '', ''),
+            None,
+        ]
+        self.assertEquals(apt_pkg.version_compare('1', '2'), -1)
+        self.check_call.side_effect = subprocess.CalledProcessError(2, '', '')
+        self.assertRaises(subprocess.CalledProcessError,
+                          apt_pkg.version_compare, '2', '2')
+
+    def test_apt_cache(self):
+        self.patch_object(apt_pkg.subprocess, 'check_output')
+        apt_cache = apt_pkg.Cache()
+        self.check_output.side_effect = [
+            ('Package: dpkg\n'
+             'Version: 1.19.0.6ubuntu0\n'
+             'Bugs: https://bugs.launchpad.net/ubuntu/+filebug\n'
+             'Description-en: Debian package management system\n'
+             ' Multiline description\n'
+             '\n'
+             'Package: lsof\n'
+             'Architecture: amd64\n'
+             'Version: 4.91+dfsg-1ubuntu1\n'
+             '\n'
+             'N: There is 1 additional record.\n'),
+            ('Desired=Unknown/Install/Remove/Purge/Hold\n'
+             '| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/'
+             'trig-aWait/Trig-pend\n'
+             '|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)\n'
+             '||/ Name           Version            Architecture Description\n'
+             '+++-=============================-==================-===========-'
+             '=================================\n'
+             'ii  dpkg                          1.19.0.5ubuntu2.1  amd64       '
+             'Debian package management system\n'
+             'rc  linux-image-4.15.0-42-generic 4.15.0-42.45       amd64       '
+             'Signed kernel image generic\n'
+             'ii  lsof                          4.91+dfsg-1ubuntu1 amd64       '
+             'utility to list open files\n'),
+        ]
+        pkg = apt_cache['dpkg']
+        self.assertEquals(pkg.name, 'dpkg')
+        self.assertEquals(pkg.current_ver.ver_str, '1.19.0.5ubuntu2.1')
+        self.assertEquals(pkg.architecture, 'amd64')
+        self.check_output.side_effect = [
+            subprocess.CalledProcessError(100, ''),
+            subprocess.CalledProcessError(1, ''),
+        ]
+        with self.assertRaises(KeyError):
+            pkg = apt_cache['nonexistent']
+        self.check_output.side_effect = [
+            ('Package: dpkg\n'
+             'Version: 1.19.0.6ubuntu0\n'
+             'Bugs: https://bugs.launchpad.net/ubuntu/+filebug\n'
+             'Description-en: Debian package management system\n'
+             ' Multiline description\n'
+             '\n'
+             'Package: lsof\n'
+             'Architecture: amd64\n'
+             'Version: 4.91+dfsg-1ubuntu1\n'
+             '\n'
+             'N: There is 1 additional record.\n'),
+            subprocess.CalledProcessError(42, ''),
+        ]
+        with self.assertRaises(subprocess.CalledProcessError):
+            # System error occurs while making dpkg inquiry
+            pkg = apt_cache['dpkg']
+        self.check_output.side_effect = [
+            subprocess.CalledProcessError(42, ''),
+            subprocess.CalledProcessError(1, ''),
+        ]
+        with self.assertRaises(subprocess.CalledProcessError):
+            pkg = apt_cache['system-error-occurs-while-making-apt-inquiry']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_giturl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_giturl.py
new file mode 100644
index 0000000000000000000000000000000000000000..e657027fab59ed7054275c7910686db7c0d6e671
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_giturl.py
@@ -0,0 +1,115 @@
+import os
+import shutil
+import subprocess
+import tempfile
+from testtools import TestCase
+from mock import (
+    MagicMock,
+    patch,
+)
+from charmhelpers.core.host import chdir
+
+import six
+if six.PY3:
+    from urllib.parse import urlparse
+else:
+    from urlparse import urlparse
+
+
+try:
+    from charmhelpers.fetch import (
+        giturl,
+        UnhandledSource,
+    )
+except ImportError:
+    giturl = None
+    UnhandledSource = None
+
+
+class GitUrlFetchHandlerTest(TestCase):
+    def setUp(self):
+        super(GitUrlFetchHandlerTest, self).setUp()
+        self.valid_urls = (
+            "http://example.com/git-branch",
+            "https://example.com/git-branch",
+            "git://example.com/git-branch",
+        )
+        self.invalid_urls = (
+            "file://example.com/foo.tar.bz2",
+            "abc:example",
+            "garbage",
+        )
+        self.fh = giturl.GitUrlFetchHandler()
+
+    def test_handles_git_urls(self):
+        for url in self.valid_urls:
+            result = self.fh.can_handle(url)
+            self.assertEqual(result, True, url)
+        for url in self.invalid_urls:
+            result = self.fh.can_handle(url)
+            self.assertNotEqual(result, True, url)
+
+    @patch.object(giturl, 'check_output')
+    def test_clone(self, check_output):
+        dest_path = "/destination/path"
+        branch = "master"
+        for url in self.valid_urls:
+            self.fh.remote_branch = MagicMock()
+            self.fh.load_plugins = MagicMock()
+            self.fh.clone(url, dest_path, branch, None)
+
+            check_output.assert_called_with(
+                ['git', 'clone', url, dest_path, '--branch', branch], stderr=-2)
+
+        for url in self.invalid_urls:
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                self.assertRaises(UnhandledSource, self.fh.clone, url,
+                                  dest_path, None,
+                                  branch)
+
+    def test_clone_functional(self):
+        src = None
+        dst = None
+        try:
+            src = tempfile.mkdtemp()
+            with chdir(src):
+                subprocess.check_output(['git', 'init'])
+                subprocess.check_output(['git', 'config', 'user.name', 'Joe'])
+                subprocess.check_output(
+                    ['git', 'config', 'user.email', 'joe@test.com'])
+                subprocess.check_output(['touch', 'foo'])
+                subprocess.check_output(['git', 'add', 'foo'])
+                subprocess.check_output(['git', 'commit', '-m', 'test'])
+            dst = tempfile.mkdtemp()
+            os.rmdir(dst)
+            self.fh.clone(src, dst)
+            assert os.path.exists(os.path.join(dst, '.git'))
+            self.fh.clone(src, dst)  # idempotent
+            assert os.path.exists(os.path.join(dst, '.git'))
+        finally:
+            if src:
+                shutil.rmtree(src, ignore_errors=True)
+            if dst:
+                shutil.rmtree(dst, ignore_errors=True)
+
+    def test_installs(self):
+        self.fh.clone = MagicMock()
+
+        for url in self.valid_urls:
+            branch_name = urlparse(url).path.strip("/").split("/")[-1]
+            dest = os.path.join('foo', 'fetched',
+                                os.path.basename(branch_name))
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                where = self.fh.install(url)
+            self.assertEqual(where, dest)
+
+    def test_installs_specified_dest(self):
+        self.fh.clone = MagicMock()
+
+        for url in self.valid_urls:
+            branch_name = urlparse(url).path.strip("/").split("/")[-1]
+            dest_repo = os.path.join('/tmp/git/',
+                                     os.path.basename(branch_name))
+            with patch.dict('os.environ', {'CHARM_DIR': 'foo'}):
+                where = self.fh.install(url, dest="/tmp/git")
+            self.assertEqual(where, dest_repo)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_snap.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_snap.py
new file mode 100644
index 0000000000000000000000000000000000000000..02e6a70c0b2a31ac48bbd81f43d708dd0ec5d466
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/fetch/test_snap.py
@@ -0,0 +1,79 @@
+# Copyright 2014-2017 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from mock import patch
+from unittest import TestCase
+import charmhelpers.fetch.snap as fetch_snap
+
+__author__ = 'Joseph Borg <joseph.borg@canonical.com>'
+
+TEST_ENV = {'foo': 'bar'}
+
+
+class SnapTest(TestCase):
+    """
+    Test and install and removal of a snap.
+    """
+    @patch.object(fetch_snap, 'log', lambda *args, **kwargs: None)
+    @patch('subprocess.check_call')
+    @patch('os.environ', TEST_ENV)
+    def testSnapInstall(self, check_call):
+        """
+        Test snap install.
+
+        :param check_call: Mock object
+        :return: None
+        """
+        check_call.return_value = 0
+        fetch_snap.snap_install(['hello-world', 'htop'], '--classic', '--stable')
+        check_call.assert_called_with(['snap', 'install', '--classic', '--stable', 'hello-world', 'htop'], env=TEST_ENV)
+
+    @patch.object(fetch_snap, 'log', lambda *args, **kwargs: None)
+    @patch('subprocess.check_call')
+    @patch('os.environ', TEST_ENV)
+    def testSnapRefresh(self, check_call):
+        """
+        Test snap refresh.
+
+        :param check_call: Mock object
+        :return: None
+        """
+        check_call.return_value = 0
+        fetch_snap.snap_refresh(['hello-world', 'htop'], '--classic', '--stable')
+        check_call.assert_called_with(['snap', 'refresh', '--classic', '--stable', 'hello-world', 'htop'], env=TEST_ENV)
+
+    @patch.object(fetch_snap, 'log', lambda *args, **kwargs: None)
+    @patch('subprocess.check_call')
+    @patch('os.environ', TEST_ENV)
+    def testSnapRemove(self, check_call):
+        """
+        Test snap remove.
+
+        :param check_call: Mock object
+        :return: None
+        """
+        check_call.return_value = 0
+        fetch_snap.snap_remove(['hello-world', 'htop'])
+        check_call.assert_called_with(['snap', 'remove', 'hello-world', 'htop'], env=TEST_ENV)
+
+    def test_valid_snap_channel(self):
+        """ Test valid snap channel
+
+        :return: None
+        """
+        # Valid
+        self.assertTrue(fetch_snap.valid_snap_channel('edge'))
+
+        # Invalid
+        with self.assertRaises(fetch_snap.InvalidSnapChannel):
+            fetch_snap.valid_snap_channel('DOESNOTEXIST')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..10581268bfd7d956644fe0df1669f974c4f59c11
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/helpers.py
@@ -0,0 +1,144 @@
+''' General helper functions for tests '''
+from contextlib import contextmanager
+from mock import patch, MagicMock
+import io
+
+import six
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+
+@contextmanager
+def patch_open():
+    '''Patch open() to allow mocking both open() itself and the file that is
+    yielded.
+
+    Yields the mock for "open" and "file", respectively.'''
+    mock_open = MagicMock(spec=open)
+    mock_file = MagicMock(spec=io.FileIO)
+
+    @contextmanager
+    def stub_open(*args, **kwargs):
+        mock_open(*args, **kwargs)
+        yield mock_file
+
+    with patch(builtin_open, stub_open):
+        yield mock_open, mock_file
+
+
+@contextmanager
+def mock_open(filename, contents=None):
+    ''' Slightly simpler mock of open to return contents for filename '''
+    def mock_file(name, mode='r', buffering=-1):  # Python 2 signature.
+        if name == filename:
+            if (not six.PY3) or 'b' in mode:
+                return io.BytesIO(contents)
+            return io.StringIO(contents)
+        else:
+            return open(name, mode, buffering)
+
+    with patch(builtin_open, mock_file):
+        yield
+
+
+class FakeRelation(object):
+    '''
+    A fake relation class. Lets tests specify simple relation data
+    for a default relation + unit (foo:0, foo/0, set in setUp()), eg:
+
+        rel = {
+            'private-address': 'foo',
+            'password': 'passwd',
+        }
+        relation = FakeRelation(rel)
+        self.relation_get.side_effect = relation.get
+        passwd = self.relation_get('password')
+
+    or more complex relations meant to be addressed by explicit relation id
+    + unit id combos:
+
+        rel = {
+            'mysql:0': {
+                'mysql/0': {
+                    'private-address': 'foo',
+                    'password': 'passwd',
+                }
+            }
+        }
+        relation = FakeRelation(rel)
+        self.relation_get.side_affect = relation.get
+        passwd = self.relation_get('password', rid='mysql:0', unit='mysql/0')
+
+    set_relation_context can be used to simulate being in a relation hook
+    context. This allows omitting a relation id or unit when calling relation
+    helpers as the related unit is present.
+
+    To set the context:
+
+        relation = FakeRelation(rel)
+        relation.set_relation_context('mysql-svc2/0', 'shared-db:12')
+
+    To clear it:
+
+        relation.clear_relation_context()
+    '''
+    def __init__(self, relation_data):
+        self.relation_data = relation_data
+        self.remote_unit = None
+        self.current_relation_id = None
+
+    def set_relation_context(self, remote_unit, relation_id):
+        self.remote_unit = remote_unit
+        self.current_relation_id = relation_id
+
+    def clear_relation_context(self):
+        self.remote_unit = None
+        self.current_relation_id = None
+
+    def get(self, attribute=None, unit=None, rid=None):
+        if not rid or rid == 'foo:0':
+            if self.current_relation_id:
+                if not unit:
+                    unit = self.remote_unit
+                udata = self.relation_data[self.current_relation_id][unit]
+                if attribute:
+                    return udata[attribute]
+                else:
+                    return udata[unit]
+            if attribute is None:
+                return self.relation_data
+            elif attribute in self.relation_data:
+                return self.relation_data[attribute]
+            return None
+        else:
+            if rid not in self.relation_data:
+                return None
+            try:
+                relation = self.relation_data[rid][unit]
+            except KeyError:
+                return None
+            if attribute and attribute in relation:
+                return relation[attribute]
+            return relation
+
+    def relation_id(self):
+        return self.current_relation_id
+
+    def relation_ids(self, reltype=None):
+        rids = self.relation_data.keys()
+        if reltype:
+            return [r for r in rids if r.split(':')[0] == reltype]
+        return rids
+
+    def related_units(self, relid=None):
+        try:
+            return self.relation_data[relid].keys()
+        except KeyError:
+            return []
+
+    def relation_units(self, relation_id):
+        if relation_id not in self.relation_data:
+            return None
+        return self.relation_data[relation_id].keys()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_archive.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_archive.py
new file mode 100644
index 0000000000000000000000000000000000000000..f636917c9d15e3529962af5f02863618bc0b6b9c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_archive.py
@@ -0,0 +1,137 @@
+import os
+from testtools import TestCase
+from mock import (
+    patch,
+    MagicMock,
+)
+from charmhelpers.payload import archive
+from tempfile import mkdtemp
+from shutil import rmtree
+import subprocess
+
+
+class ArchiveTestCase(TestCase):
+
+    def create_archive(self, format):
+        workdir = mkdtemp()
+        if format == "tar":
+            workfile = "{}/foo.tar.gz".format(workdir)
+            cmd = "tar czf {} hosts".format(workfile)
+        elif format == "zip":
+            workfile = "{}/foo.zip".format(workdir)
+            cmd = "zip {} hosts".format(workfile)
+        curdir = os.getcwd()
+        os.chdir("/etc")
+        subprocess.check_output(cmd, shell=True)
+        os.chdir(curdir)
+        self.addCleanup(rmtree, workdir)
+        return (workfile, ["hosts"])
+
+    @patch('os.path.isfile')
+    def test_gets_archive_handler_by_ext(self, _isfile):
+        tar_archive_handler = archive.extract_tarfile
+        zip_archive_handler = archive.extract_zipfile
+        _isfile.return_value = False
+
+        for ext in ('tar', 'tar.gz', 'tgz', 'tar.bz2', 'tbz2', 'tbz'):
+            handler = archive.get_archive_handler("somefile.{}".format(ext))
+            msg = "handler for extension: {}".format(ext)
+            self.assertEqual(handler, tar_archive_handler, msg)
+
+        for ext in ('zip', 'jar'):
+            handler = archive.get_archive_handler("somefile.{}".format(ext))
+            msg = "handler for extension {}".format(ext)
+            self.assertEqual(handler, zip_archive_handler, msg)
+
+    @patch('zipfile.is_zipfile')
+    @patch('tarfile.is_tarfile')
+    @patch('os.path.isfile')
+    def test_gets_archive_hander_by_filetype(self, _isfile, _istarfile,
+                                             _iszipfile):
+        tar_archive_handler = archive.extract_tarfile
+        zip_archive_handler = archive.extract_zipfile
+        _isfile.return_value = True
+
+        _istarfile.return_value = True
+        _iszipfile.return_value = False
+        handler = archive.get_archive_handler("foo")
+        self.assertEqual(handler, tar_archive_handler)
+
+        _istarfile.return_value = False
+        _iszipfile.return_value = True
+        handler = archive.get_archive_handler("foo")
+        self.assertEqual(handler, zip_archive_handler)
+
+    @patch('charmhelpers.core.hookenv.charm_dir')
+    def test_gets_archive_dest_default(self, _charmdir):
+        _charmdir.return_value = "foo"
+        thedir = archive.archive_dest_default("baz")
+        self.assertEqual(thedir, os.path.join("foo", "archives", "baz"))
+
+        thedir = archive.archive_dest_default("baz/qux")
+        self.assertEqual(thedir, os.path.join("foo", "archives", "qux"))
+
+    def test_extracts_tarfile(self):
+        destdir = mkdtemp()
+        self.addCleanup(rmtree, destdir)
+        tar_file, contents = self.create_archive("tar")
+        archive.extract_tarfile(tar_file, destdir)
+        for path in [os.path.join(destdir, item) for item in contents]:
+            self.assertTrue(os.path.exists(path))
+
+    def test_extracts_zipfile(self):
+        destdir = mkdtemp()
+        self.addCleanup(rmtree, destdir)
+        try:
+            zip_file, contents = self.create_archive("zip")
+        except subprocess.CalledProcessError as e:
+            if e.returncode == 127:
+                self.skip("Skipping - zip is not installed")
+            else:
+                raise
+        archive.extract_zipfile(zip_file, destdir)
+        for path in [os.path.join(destdir, item) for item in contents]:
+            self.assertTrue(os.path.exists(path))
+
+    @patch('charmhelpers.core.host.mkdir')
+    @patch('charmhelpers.payload.archive.get_archive_handler')
+    @patch('charmhelpers.payload.archive.archive_dest_default')
+    def test_extracts(self, _defdest, _gethandler, _mkdir):
+        archive_name = "foo"
+        archive_handler = MagicMock()
+        _gethandler.return_value = archive_handler
+
+        dest = archive.extract(archive_name, "bar")
+
+        _gethandler.assert_called_with(archive_name)
+        archive_handler.assert_called_with(archive_name, "bar")
+        _defdest.assert_not_called()
+        _mkdir.assert_called_with("bar")
+        self.assertEqual(dest, "bar")
+
+    @patch('charmhelpers.core.host.mkdir')
+    @patch('charmhelpers.payload.archive.get_archive_handler')
+    def test_unhandled_extract_raises_exc(self, _gethandler, _mkdir):
+        archive_name = "foo"
+        _gethandler.return_value = None
+
+        self.assertRaises(archive.ArchiveError, archive.extract,
+                          archive_name)
+
+        _gethandler.assert_called_with(archive_name)
+        _mkdir.assert_not_called()
+
+    @patch('charmhelpers.core.host.mkdir')
+    @patch('charmhelpers.payload.archive.get_archive_handler')
+    @patch('charmhelpers.payload.archive.archive_dest_default')
+    def test_extracts_default_dest(self, _defdest, _gethandler, _mkdir):
+        expected_dest = "bar"
+        archive_name = "foo"
+        _defdest.return_value = expected_dest
+        handler = MagicMock()
+        handler.return_value = expected_dest
+        _gethandler.return_value = handler
+
+        dest = archive.extract(archive_name)
+        self.assertEqual(expected_dest, dest)
+        handler.assert_called_with(archive_name, expected_dest)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_execd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_execd.py
new file mode 100644
index 0000000000000000000000000000000000000000..20d83c5891376ff2547ab828f2757f585be25aca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/payload/test_execd.py
@@ -0,0 +1,153 @@
+from testtools import TestCase
+from mock import patch
+import os
+import shutil
+import stat
+
+from tempfile import mkdtemp
+
+from charmhelpers.payload import execd
+
+
+class ExecDTestCase(TestCase):
+
+    def setUp(self):
+        super(ExecDTestCase, self).setUp()
+        charm_dir = mkdtemp()
+        self.addCleanup(shutil.rmtree, charm_dir)
+        self.test_charm_dir = charm_dir
+
+        env_patcher = patch.dict('os.environ',
+                                 {'CHARM_DIR': self.test_charm_dir})
+        env_patcher.start()
+        self.addCleanup(env_patcher.stop)
+
+    def test_default_execd_dir(self):
+        expected = os.path.join(self.test_charm_dir, 'exec.d')
+        default_dir = execd.default_execd_dir()
+
+        self.assertEqual(expected, default_dir)
+
+    def make_preinstall_executable(self, module_dir, execd_dir='exec.d',
+                                   error_on_preinstall=False):
+        """Add a charm-pre-install to module dir.
+
+        When executed, the charm-pre-install will create a second
+        file in the same directory, charm-pre-install-success.
+        """
+        module_path = os.path.join(self.test_charm_dir, execd_dir, module_dir)
+        os.makedirs(module_path)
+
+        charm_pre_install_path = os.path.join(module_path,
+                                              'charm-pre-install')
+        pre_install_success_path = os.path.join(module_path,
+                                                'charm-pre-install-success')
+        with open(charm_pre_install_path, 'w+') as f:
+            if not error_on_preinstall:
+                f.write("#!/bin/bash\n"
+                        "/usr/bin/touch {}".format(pre_install_success_path))
+            else:
+                f.write("#!/bin/bash\n"
+                        "echo stdout_from_pre_install\n"
+                        "echo stderr_from_pre_install >&2\n"
+                        "exit 1")
+
+        # ensure it is executable.
+        perms = stat.S_IRUSR + stat.S_IXUSR
+        os.chmod(charm_pre_install_path, perms)
+
+    def assert_preinstall_called_for_mod(self, module_dir,
+                                         execd_dir='exec.d'):
+        """Asserts that the charm-pre-install-success file exists."""
+        expected_file = os.path.join(self.test_charm_dir, execd_dir,
+                                     module_dir, 'charm-pre-install-success')
+        files = os.listdir(os.path.dirname(expected_file))
+        self.assertTrue(os.path.exists(expected_file), "files were: %s. charmdir is: %s" % (files, self.test_charm_dir))
+
+    def test_execd_preinstall(self):
+        """All charm-pre-install hooks are executed."""
+        self.make_preinstall_executable(module_dir='basenode')
+        self.make_preinstall_executable(module_dir='mod2')
+
+        execd.execd_preinstall()
+
+        self.assert_preinstall_called_for_mod('basenode')
+        self.assert_preinstall_called_for_mod('mod2')
+
+    def test_execd_module_list_from_env(self):
+        modules = ['basenode', 'mod2', 'c']
+        for module in modules:
+            self.make_preinstall_executable(module_dir=module)
+
+        actual_mod_paths = list(execd.execd_module_paths())
+
+        expected_mod_paths = [
+            os.path.join(self.test_charm_dir, 'exec.d', module)
+            for module in modules]
+        self.assertSetEqual(set(actual_mod_paths), set(expected_mod_paths))
+
+    def test_execd_module_list_with_dir(self):
+        modules = ['basenode', 'mod2', 'c']
+        for module in modules:
+            self.make_preinstall_executable(module_dir=module,
+                                            execd_dir='foo')
+
+        actual_mod_paths = list(execd.execd_module_paths(
+            execd_dir=os.path.join(self.test_charm_dir, 'foo')))
+
+        expected_mod_paths = [
+            os.path.join(self.test_charm_dir, 'foo', module)
+            for module in modules]
+        self.assertSetEqual(set(actual_mod_paths), set(expected_mod_paths))
+
+    def test_execd_module_paths_no_execd_dir(self):
+        """Empty list is returned when the exec.d doesn't exist."""
+        actual_mod_paths = list(execd.execd_module_paths())
+
+        self.assertEqual(actual_mod_paths, [])
+
+    def test_execd_submodule_list(self):
+        modules = ['basenode', 'mod2', 'c']
+        for module in modules:
+            self.make_preinstall_executable(module_dir=module)
+
+        submodules = list(execd.execd_submodule_paths('charm-pre-install'))
+
+        expected = [os.path.join(self.test_charm_dir, 'exec.d', mod,
+                                 'charm-pre-install') for mod in modules]
+        self.assertEqual(sorted(submodules), sorted(expected))
+
+    def test_execd_run(self):
+        modules = ['basenode', 'mod2', 'c']
+        for module in modules:
+            self.make_preinstall_executable(module_dir=module)
+
+        execd.execd_run('charm-pre-install')
+
+        self.assert_preinstall_called_for_mod('basenode')
+        self.assert_preinstall_called_for_mod('mod2')
+        self.assert_preinstall_called_for_mod('c')
+
+    @patch('charmhelpers.core.hookenv.log')
+    def test_execd_run_logs_exception(self, log_):
+        self.make_preinstall_executable(module_dir='basenode',
+                                        error_on_preinstall=True)
+
+        execd.execd_run('charm-pre-install', die_on_error=False)
+
+        expected_log = ('Error (1) running  {}/exec.d/basenode/'
+                        'charm-pre-install. Output: '
+                        'stdout_from_pre_install\n'
+                        'stderr_from_pre_install\n'.format(self.test_charm_dir))
+        log_.assert_called_with(expected_log)
+
+    @patch('charmhelpers.core.hookenv.log')
+    @patch('sys.exit')
+    def test_execd_run_dies_with_return_code(self, exit_, log):
+        self.make_preinstall_executable(module_dir='basenode',
+                                        error_on_preinstall=True)
+
+        with open(os.devnull, 'wb') as devnull:
+            execd.execd_run('charm-pre-install', stderr=devnull)
+
+        exit_.assert_called_with(1)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/tools/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/tools/test_charm_helper_sync.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/tools/test_charm_helper_sync.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c66b9ba80700c1b042948cdfd12b2982ccbe9dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/tools/test_charm_helper_sync.py
@@ -0,0 +1,304 @@
+import unittest
+from mock import call, patch
+import yaml
+
+import tools.charm_helpers_sync.charm_helpers_sync as sync
+
+import six
+if not six.PY3:
+    builtin_open = '__builtin__.open'
+else:
+    builtin_open = 'builtins.open'
+
+
+INCLUDE = """
+include:
+    - core
+    - contrib.openstack
+    - contrib.storage
+    - contrib.hahelpers:
+        - utils
+        - ceph_utils
+        - cluster_utils
+        - haproxy_utils
+"""
+
+
+class HelperSyncTests(unittest.TestCase):
+    def test_clone_helpers(self):
+        '''It properly branches the correct helpers branch'''
+        with patch('subprocess.check_call') as check_call:
+            sync.clone_helpers(work_dir='/tmp/foo', repo='git:charm-helpers')
+            check_call.assert_called_with(['git',
+                                           'clone', '--depth=1',
+                                           'git:charm-helpers',
+                                           '/tmp/foo/charm-helpers'])
+
+    def test_module_path(self):
+        '''It converts a python module path to a filesystem path'''
+        self.assertEquals(sync._module_path('some.test.module'),
+                          'some/test/module')
+
+    def test_src_path(self):
+        '''It renders the correct path to module within charm-helpers tree'''
+        path = sync._src_path(src='/tmp/charm-helpers',
+                              module='contrib.openstack')
+        self.assertEquals('/tmp/charm-helpers/charmhelpers/contrib/openstack',
+                          path)
+
+    def test_dest_path(self):
+        '''It correctly finds the correct install path within a charm'''
+        path = sync._dest_path(dest='/tmp/mycharm/hooks/charmhelpers',
+                               module='contrib.openstack')
+        self.assertEquals('/tmp/mycharm/hooks/charmhelpers/contrib/openstack',
+                          path)
+
+    @patch(builtin_open)
+    @patch('os.path.exists')
+    @patch('os.walk')
+    def test_ensure_init(self, walk, exists, _open):
+        '''It ensures all subdirectories of a parent are python importable'''
+        # os walk
+        # os.path.join
+        # os.path.exists
+        # open
+        def _walk(path):
+            yield ('/tmp/hooks/', ['helpers'], [])
+            yield ('/tmp/hooks/helpers', ['foo'], [])
+            yield ('/tmp/hooks/helpers/foo', [], [])
+        walk.side_effect = _walk
+        exists.return_value = False
+        sync.ensure_init('hooks/helpers/foo/')
+        ex = [call('/tmp/hooks/__init__.py', 'wb'),
+              call('/tmp/hooks/helpers/__init__.py', 'wb'),
+              call('/tmp/hooks/helpers/foo/__init__.py', 'wb')]
+        for c in ex:
+            self.assertIn(c, _open.call_args_list)
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.ensure_init')
+    @patch('os.path.isfile')
+    @patch('shutil.copy')
+    @patch('os.makedirs')
+    @patch('os.path.exists')
+    def test_sync_pyfile(self, exists, mkdirs, copy, isfile, ensure_init):
+        '''It correctly syncs a py src file from src to dest'''
+        exists.return_value = False
+        isfile.return_value = True
+        sync.sync_pyfile('/tmp/charm-helpers/core/host',
+                         'hooks/charmhelpers/core')
+        mkdirs.assert_called_with('hooks/charmhelpers/core')
+        copy_f = call('/tmp/charm-helpers/core/host.py',
+                      'hooks/charmhelpers/core')
+        copy_i = call('/tmp/charm-helpers/core/__init__.py',
+                      'hooks/charmhelpers/core')
+        self.assertIn(copy_f, copy.call_args_list)
+        self.assertIn(copy_i, copy.call_args_list)
+        ensure_init.assert_called_with('hooks/charmhelpers/core')
+
+    def _test_filter_dir(self, opts, isfile, isdir):
+        '''It filters non-python files and non-module dirs from source'''
+        files = {
+            'bad_file.bin': 'f',
+            'some_dir': 'd',
+            'good_helper.py': 'f',
+            'good_helper2.py': 'f',
+            'good_helper3.py': 'f',
+            'bad_file.img': 'f',
+        }
+
+        def _isfile(f):
+            try:
+                return files[f.split('/').pop()] == 'f'
+            except KeyError:
+                return False
+
+        def _isdir(f):
+            try:
+                return files[f.split('/').pop()] == 'd'
+            except KeyError:
+                return False
+
+        isfile.side_effect = _isfile
+        isdir.side_effect = _isdir
+        result = sync.get_filter(opts)(dir='/tmp/charm-helpers/core',
+                                       ls=six.iterkeys(files))
+        return result
+
+    @patch('os.path.isdir')
+    @patch('os.path.isfile')
+    def test_filter_dir_no_opts(self, isfile, isdir):
+        '''It filters out all non-py files by default'''
+        result = self._test_filter_dir(opts=None, isfile=isfile, isdir=isdir)
+        ex = ['bad_file.bin', 'bad_file.img', 'some_dir']
+        self.assertEquals(sorted(ex), sorted(result))
+
+    @patch('os.path.isdir')
+    @patch('os.path.isfile')
+    def test_filter_dir_with_include(self, isfile, isdir):
+        '''It includes non-py files if specified as an include opt'''
+        result = sorted(self._test_filter_dir(opts=['inc=*.img'],
+                                              isfile=isfile, isdir=isdir))
+        ex = sorted(['bad_file.bin', 'some_dir'])
+        self.assertEquals(ex, result)
+
+    @patch('os.path.isdir')
+    @patch('os.path.isfile')
+    def test_filter_dir_include_all(self, isfile, isdir):
+        '''It does not filter anything if option specified to include all'''
+        self.assertEquals(sync.get_filter(opts=['inc=*']), None)
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.get_filter')
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.ensure_init')
+    @patch('shutil.copytree')
+    @patch('shutil.rmtree')
+    @patch('os.path.exists')
+    def test_sync_directory(self, exists, rmtree, copytree, ensure_init,
+                            _filter):
+        '''It correctly syncs src directory to dest directory'''
+        _filter.return_value = None
+        sync.sync_directory('/tmp/charm-helpers/charmhelpers/core',
+                            'hooks/charmhelpers/core')
+        exists.return_value = True
+        rmtree.assert_called_with('hooks/charmhelpers/core')
+        copytree.assert_called_with('/tmp/charm-helpers/charmhelpers/core',
+                                    'hooks/charmhelpers/core', ignore=None)
+        ensure_init.assert_called_with('hooks/charmhelpers/core')
+
+    @patch('os.path.isfile')
+    def test_is_pyfile(self, isfile):
+        '''It correctly identifies incomplete path to a py src file as such'''
+        sync._is_pyfile('/tmp/charm-helpers/charmhelpers/core/host')
+        isfile.assert_called_with(
+            '/tmp/charm-helpers/charmhelpers/core/host.py'
+        )
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.sync_pyfile')
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.sync_directory')
+    @patch('os.path.isdir')
+    def test_syncs_directory(self, is_dir, sync_dir, sync_pyfile):
+        '''It correctly syncs a module directory'''
+        is_dir.return_value = True
+        sync.sync(src='/tmp/charm-helpers',
+                  dest='hooks/charmhelpers',
+                  module='contrib.openstack')
+
+        sync_dir.assert_called_with(
+            '/tmp/charm-helpers/charmhelpers/contrib/openstack',
+            'hooks/charmhelpers/contrib/openstack', None)
+
+        # __init__.py files leading to the directory were also synced.
+        sync_pyfile.assert_has_calls([
+            call('/tmp/charm-helpers/charmhelpers/__init__',
+                 'hooks/charmhelpers'),
+            call('/tmp/charm-helpers/charmhelpers/contrib/__init__',
+                 'hooks/charmhelpers/contrib')])
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.sync_pyfile')
+    @patch('tools.charm_helpers_sync.charm_helpers_sync._is_pyfile')
+    @patch('os.path.isdir')
+    def test_syncs_file(self, is_dir, is_pyfile, sync_pyfile):
+        '''It correctly syncs a module file'''
+        is_dir.return_value = False
+        is_pyfile.return_value = True
+        sync.sync(src='/tmp/charm-helpers',
+                  dest='hooks/charmhelpers',
+                  module='contrib.openstack.utils')
+        sync_pyfile.assert_has_calls([
+            call('/tmp/charm-helpers/charmhelpers/__init__',
+                 'hooks/charmhelpers'),
+            call('/tmp/charm-helpers/charmhelpers/contrib/__init__',
+                 'hooks/charmhelpers/contrib'),
+            call('/tmp/charm-helpers/charmhelpers/contrib/openstack/__init__',
+                 'hooks/charmhelpers/contrib/openstack'),
+            call('/tmp/charm-helpers/charmhelpers/contrib/openstack/utils',
+                 'hooks/charmhelpers/contrib/openstack')])
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.sync')
+    @patch('os.path.isdir')
+    @patch('os.path.exists')
+    def test_sync_helpers_from_config(self, exists, isdir, _sync):
+        '''It correctly syncs a list of included helpers'''
+        include = yaml.safe_load(INCLUDE)['include']
+        isdir.return_value = True
+        exists.return_value = False
+        sync.sync_helpers(include=include,
+                          src='/tmp/charm-helpers',
+
+                          dest='hooks/charmhelpers')
+        mods = [
+            'core',
+            'contrib.openstack',
+            'contrib.storage',
+            'contrib.hahelpers.utils',
+            'contrib.hahelpers.ceph_utils',
+            'contrib.hahelpers.cluster_utils',
+            'contrib.hahelpers.haproxy_utils'
+        ]
+
+        ex_calls = []
+        [ex_calls.append(
+            call('/tmp/charm-helpers', 'hooks/charmhelpers', c, [])
+        ) for c in mods]
+        self.assertEquals(ex_calls, _sync.call_args_list)
+
+    @patch('tools.charm_helpers_sync.charm_helpers_sync.sync')
+    @patch('os.path.isdir')
+    @patch('os.path.exists')
+    @patch('shutil.rmtree')
+    def test_sync_helpers_from_config_cleanup(self, _rmtree, _exists,
+                                              isdir, _sync):
+        '''It correctly syncs a list of included helpers'''
+        include = yaml.safe_load(INCLUDE)['include']
+        isdir.return_value = True
+        _exists.return_value = True
+
+        sync.sync_helpers(include=include,
+                          src='/tmp/charm-helpers',
+
+                          dest='hooks/charmhelpers')
+        _rmtree.assert_called_with('hooks/charmhelpers')
+        mods = [
+            'core',
+            'contrib.openstack',
+            'contrib.storage',
+            'contrib.hahelpers.utils',
+            'contrib.hahelpers.ceph_utils',
+            'contrib.hahelpers.cluster_utils',
+            'contrib.hahelpers.haproxy_utils'
+        ]
+
+        ex_calls = []
+        [ex_calls.append(
+            call('/tmp/charm-helpers', 'hooks/charmhelpers', c, [])
+        ) for c in mods]
+        self.assertEquals(ex_calls, _sync.call_args_list)
+
+    def test_extract_option_no_globals(self):
+        '''It extracts option from an included item with no global options'''
+        inc = 'contrib.openstack.templates|inc=*.template'
+        result = sync.extract_options(inc)
+        ex = ('contrib.openstack.templates', ['inc=*.template'])
+        self.assertEquals(ex, result)
+
+    def test_extract_option_with_global_as_string(self):
+        '''It extracts option for include with global options as str'''
+        inc = 'contrib.openstack.templates|inc=*.template'
+        result = sync.extract_options(inc, global_options='inc=foo.*')
+        ex = ('contrib.openstack.templates',
+              ['inc=*.template', 'inc=foo.*'])
+        self.assertEquals(ex, result)
+
+    def test_extract_option_with_globals(self):
+        '''It extracts option from an included item with global options'''
+        inc = 'contrib.openstack.templates|inc=*.template'
+        result = sync.extract_options(inc, global_options=['inc=*.cfg'])
+        ex = ('contrib.openstack.templates', ['inc=*.template', 'inc=*.cfg'])
+        self.assertEquals(ex, result)
+
+    def test_extract_multiple_options_with_globals(self):
+        '''It extracts multiple options from an included item'''
+        inc = 'contrib.openstack.templates|inc=*.template,inc=foo.*'
+        result = sync.extract_options(inc, global_options=['inc=*.cfg'])
+        ex = ('contrib.openstack.templates',
+              ['inc=*.template', 'inc=foo.*', 'inc=*.cfg'])
+        self.assertEquals(ex, result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ac46994dde1311502b93df965aea4b5038f868a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tests/utils.py
@@ -0,0 +1,79 @@
+# Copyright 2016 Canonical Ltd
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Unit test helpers from https://github.com/openstack/charms.openstack/"""
+
+import contextlib
+import io
+import mock
+import unittest
+
+
+@contextlib.contextmanager
+def patch_open():
+    '''Patch open() to allow mocking both open() itself and the file that is
+    yielded.
+
+    Yields the mock for "open" and "file", respectively.'''
+    mock_open = mock.MagicMock(spec=open)
+    mock_file = mock.MagicMock(spec=io.FileIO)
+
+    @contextlib.contextmanager
+    def stub_open(*args, **kwargs):
+        mock_open(*args, **kwargs)
+        yield mock_file
+
+    with mock.patch('builtins.open', stub_open):
+        yield mock_open, mock_file
+
+
+class BaseTestCase(unittest.TestCase):
+
+    def setUp(self):
+        self._patches = {}
+        self._patches_start = {}
+
+    def tearDown(self):
+        for k, v in self._patches.items():
+            v.stop()
+            setattr(self, k, None)
+        self._patches = None
+        self._patches_start = None
+
+    def patch_object(self, obj, attr, return_value=None, name=None, new=None,
+                     **kwargs):
+        if name is None:
+            name = attr
+        if new is not None:
+            mocked = mock.patch.object(obj, attr, new=new, **kwargs)
+        else:
+            mocked = mock.patch.object(obj, attr, **kwargs)
+        self._patches[name] = mocked
+        started = mocked.start()
+        if new is None:
+            started.return_value = return_value
+        self._patches_start[name] = started
+        setattr(self, name, started)
+
+    def patch(self, item, return_value=None, name=None, new=None, **kwargs):
+        if name is None:
+            raise RuntimeError("Must pass 'name' to .patch()")
+        if new is not None:
+            mocked = mock.patch(item, new=new, **kwargs)
+        else:
+            mocked = mock.patch(item, **kwargs)
+        self._patches[name] = mocked
+        started = mocked.start()
+        if new is None:
+            started.return_value = return_value
+        self._patches_start[name] = started
+        setattr(self, name, started)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/README.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..e22a77231bf068e0b5c208dc956c7dd47fdd7102
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/README.md
@@ -0,0 +1,160 @@
+Script for synchronizing charm-helpers into a charm branch.
+
+This script is intended to be used by charm authors during the development
+of their charm.  It allows authors to pull in bits of a charm-helpers source
+tree and embed directly into their charm, to be deployed with the rest of
+their hooks and charm payload.  This script is not intended to be called
+by the hooks themselves, but instead by the charm author while they are
+hacking on a charm offline.  Consider it a method of compiling specific
+revision of a charm-helpers branch into a given charm source tree.
+
+Some goals and benefits to using a sync tool to manage this process:
+
+    - Reduces the burden of manually copying in upstream charm helpers code
+      into a charm and helps ensure we can easily keep a specific charm's
+      helper code up to date.
+
+    - Allows authors to hack on their own working branch of charm-helpers,
+      easily sync into their WIP charm.  Any changes they've made to charm
+      helpers can be upstreamed via a merge of their charm-helpers branch
+      into lp:charm-helpers, ideally at the same time they are upstreaming
+      the charm itself into the charm store.  Separating charm helper
+      development from charm development can help reduce cases where charms
+      are shipping locally modified helpers.
+
+    - Avoids the need to ship the *entire* charm-helpers source tree with
+      a charm.  Authors can selectively pick and choose what subset of helpers
+      to include to satisfy the goals of their charm.
+
+Allows specifying a list of dependencies to sync in from a charm-helpers
+branch.  Ideally, each charm should describe its requirements in a yaml
+config included in the charm, eg `charm-helpers.yaml` (NOTE: Example module
+layout as of 12/18/2019):
+
+    $ cd my-charm
+    $ cat >charm-helpers.yaml <<END
+    repo: https://github.com/juju/charm-helpers
+    destination: hooks/helpers
+    include:
+        - core
+        - contrib.openstack
+        - contrib.hahelpers:
+            - apache
+    END
+
+includes may be defined as entire module sub-directories, or as invidual
+.py files with in a module sub-directory.
+
+Charm author can then sync in and update helpers as needed.  The following
+imports all of `charmhelpers.core` + `charmhelpers.contrib.openstack`, and only
+`apache.py` from charmhelpers.contrib.hahelpers:
+
+    $ charm-helpers-sync.py -c charm-helpers.yaml
+    $ find hooks/helpers/
+    hooks/helpers/
+    hooks/helpers/contrib
+    hooks/helpers/contrib/hahelpers
+    hooks/helpers/contrib/hahelpers/apache.py
+    hooks/helpers/contrib/hahelpers/__init__.py
+    hooks/helpers/contrib/__init__.py
+    hooks/helpers/contrib/openstack
+    hooks/helpers/contrib/openstack/templates
+    hooks/helpers/contrib/openstack/templates/__init__.py
+    hooks/helpers/contrib/openstack/templating.py
+    hooks/helpers/contrib/openstack/neutron.py
+    hooks/helpers/contrib/openstack/alternatives.py
+    hooks/helpers/contrib/openstack/ssh_migrations.py
+    hooks/helpers/contrib/openstack/amulet
+    hooks/helpers/contrib/openstack/amulet/utils.py
+    hooks/helpers/contrib/openstack/amulet/__init__.py
+    hooks/helpers/contrib/openstack/amulet/deployment.py
+    hooks/helpers/contrib/openstack/utils.py
+    hooks/helpers/contrib/openstack/files
+    hooks/helpers/contrib/openstack/files/__init__.py
+    hooks/helpers/contrib/openstack/__init__.py
+    hooks/helpers/contrib/openstack/audits
+    hooks/helpers/contrib/openstack/audits/__init__.py
+    hooks/helpers/contrib/openstack/audits/openstack_security_guide.py
+    hooks/helpers/contrib/openstack/context.py
+    hooks/helpers/contrib/openstack/keystone.py
+    hooks/helpers/contrib/openstack/policyd.py
+    hooks/helpers/contrib/openstack/ip.py
+    hooks/helpers/contrib/openstack/exceptions.py
+    hooks/helpers/contrib/openstack/vaultlocker.py
+    hooks/helpers/contrib/openstack/ha
+    hooks/helpers/contrib/openstack/ha/utils.py
+    hooks/helpers/contrib/openstack/ha/__init__.py
+    hooks/helpers/contrib/openstack/cert_utils.py
+    hooks/helpers/__init__.py
+    hooks/helpers/core
+    hooks/helpers/core/templating.py
+    hooks/helpers/core/kernel_factory
+    hooks/helpers/core/kernel_factory/__init__.py
+    hooks/helpers/core/kernel_factory/ubuntu.py
+    hooks/helpers/core/kernel_factory/centos.py
+    hooks/helpers/core/files.py
+    hooks/helpers/core/hugepage.py
+    hooks/helpers/core/__init__.py
+    hooks/helpers/core/fstab.py
+    hooks/helpers/core/host.py
+    hooks/helpers/core/services
+    hooks/helpers/core/services/base.py
+    hooks/helpers/core/services/__init__.py
+    hooks/helpers/core/services/helpers.py
+    hooks/helpers/core/hookenv.py
+    hooks/helpers/core/host_factory
+    hooks/helpers/core/host_factory/__init__.py
+    hooks/helpers/core/host_factory/ubuntu.py
+    hooks/helpers/core/host_factory/centos.py
+    hooks/helpers/core/strutils.py
+    hooks/helpers/core/decorators.py
+    hooks/helpers/core/sysctl.py
+    hooks/helpers/core/unitdata.py
+    hooks/helpers/core/kernel.py
+
+
+Script will create missing `__init__.py`'s to ensure each subdirectory is
+importable, assuming the script is run from the charm's top-level directory.
+
+By default, only directories that look like python modules and associated
+.py source files will be synced.  If you need to include other files in
+the sync (for example, template files), you can add include hints to
+your config.  This can be done either on a per-module basis using standard
+UNIX filename patterns, eg:
+
+    repo: https://github.com/juju/charm-helpers
+    destination: hooks/helpers
+    include:
+        - core|inc=* # include all extra files from this module.
+        - contrib.openstack|inc=*.template # include only .template's
+        - contrib.hahelpers:
+            - apache|inc=*.cfg # include .cfg files
+
+Or globally for all included assets:
+
+    repo: https://github.com/juju/charm-helpers
+    destination: hooks/helpers
+    options: inc=*.template,inc=*.cfg # include .templates and .cfgs globally
+    include:
+        - core
+        - contrib.openstack
+        - contrib.hahelpers:
+            - apache
+
+You may also override configured destination directory:
+
+    $ charm-helpers-sync.py -d hooks/helpers-test \
+            -c charm-helpers.yaml
+
+Or not use a config file at all:
+
+    $ charm-helpers-sync.py -r https://github.com/<someone>/charm-helpers \
+            -d hooks/helpers core contrib.openstack contrib.hahelpers
+
+or use a specific branch using the @ notation
+
+    $ charm-helpers-sync.py -r https://github.com/<someone>/charm-helpers@branch_name \
+            -d hooks/helpers core contrib.openstack contrib.hahelpers
+
+Script will create missing `__init__.py`'s to ensure each subdirectory is
+importable, assuming the script is run from the charm's top-level directory.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d7567b863e3a5ad2b7a7f44958b4166e0c3d346b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/__init__.py
@@ -0,0 +1,13 @@
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/charm_helpers_sync.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/charm_helpers_sync.py
new file mode 100755
index 0000000000000000000000000000000000000000..7c0c1945dd32d3c29683a4fc3567b527750b5cd4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/charm_helpers_sync.py
@@ -0,0 +1,261 @@
+#!/usr/bin/python
+
+# Copyright 2014-2015 Canonical Limited.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#  http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Authors:
+#   Adam Gandelman <adamg@ubuntu.com>
+
+import logging
+import optparse
+import os
+import subprocess
+import shutil
+import sys
+import tempfile
+import yaml
+from fnmatch import fnmatch
+
+import six
+
+CHARM_HELPERS_REPO = 'https://github.com/juju/charm-helpers'
+
+
+def parse_config(conf_file):
+    if not os.path.isfile(conf_file):
+        logging.error('Invalid config file: %s.' % conf_file)
+        return False
+    return yaml.load(open(conf_file).read())
+
+
+def clone_helpers(work_dir, repo):
+    dest = os.path.join(work_dir, 'charm-helpers')
+    logging.info('Cloning out %s to %s.' % (repo, dest))
+    branch = None
+    if '@' in repo:
+        repo, branch = repo.split('@', 1)
+    cmd = ['git', 'clone', '--depth=1']
+    if branch is not None:
+        cmd += ['--branch', branch]
+    cmd += [repo, dest]
+    subprocess.check_call(cmd)
+    return dest
+
+
+def _module_path(module):
+    return os.path.join(*module.split('.'))
+
+
+def _src_path(src, module):
+    return os.path.join(src, 'charmhelpers', _module_path(module))
+
+
+def _dest_path(dest, module):
+    return os.path.join(dest, _module_path(module))
+
+
+def _is_pyfile(path):
+    return os.path.isfile(path + '.py')
+
+
+def ensure_init(path):
+    '''
+    ensure directories leading up to path are importable, omitting
+    parent directory, eg path='/hooks/helpers/foo'/:
+        hooks/
+        hooks/helpers/__init__.py
+        hooks/helpers/foo/__init__.py
+    '''
+    for d, dirs, files in os.walk(os.path.join(*path.split('/')[:2])):
+        _i = os.path.join(d, '__init__.py')
+        if not os.path.exists(_i):
+            logging.info('Adding missing __init__.py: %s' % _i)
+            open(_i, 'wb').close()
+
+
+def sync_pyfile(src, dest):
+    src = src + '.py'
+    src_dir = os.path.dirname(src)
+    logging.info('Syncing pyfile: %s -> %s.' % (src, dest))
+    if not os.path.exists(dest):
+        os.makedirs(dest)
+    shutil.copy(src, dest)
+    if os.path.isfile(os.path.join(src_dir, '__init__.py')):
+        shutil.copy(os.path.join(src_dir, '__init__.py'),
+                    dest)
+    ensure_init(dest)
+
+
+def get_filter(opts=None):
+    opts = opts or []
+    if 'inc=*' in opts:
+        # do not filter any files, include everything
+        return None
+
+    def _filter(dir, ls):
+        incs = [opt.split('=').pop() for opt in opts if 'inc=' in opt]
+        _filter = []
+        for f in ls:
+            _f = os.path.join(dir, f)
+
+            if not os.path.isdir(_f) and not _f.endswith('.py') and incs:
+                if True not in [fnmatch(_f, inc) for inc in incs]:
+                    logging.debug('Not syncing %s, does not match include '
+                                  'filters (%s)' % (_f, incs))
+                    _filter.append(f)
+                else:
+                    logging.debug('Including file, which matches include '
+                                  'filters (%s): %s' % (incs, _f))
+            elif (os.path.isfile(_f) and not _f.endswith('.py')):
+                logging.debug('Not syncing file: %s' % f)
+                _filter.append(f)
+            elif (os.path.isdir(_f) and not
+                  os.path.isfile(os.path.join(_f, '__init__.py'))):
+                logging.debug('Not syncing directory: %s' % f)
+                _filter.append(f)
+        return _filter
+    return _filter
+
+
+def sync_directory(src, dest, opts=None):
+    if os.path.exists(dest):
+        logging.debug('Removing existing directory: %s' % dest)
+        shutil.rmtree(dest)
+    logging.info('Syncing directory: %s -> %s.' % (src, dest))
+
+    shutil.copytree(src, dest, ignore=get_filter(opts))
+    ensure_init(dest)
+
+
+def sync(src, dest, module, opts=None):
+
+    # Sync charmhelpers/__init__.py for bootstrap code.
+    sync_pyfile(_src_path(src, '__init__'), dest)
+
+    # Sync other __init__.py files in the path leading to module.
+    m = []
+    steps = module.split('.')[:-1]
+    while steps:
+        m.append(steps.pop(0))
+        init = '.'.join(m + ['__init__'])
+        sync_pyfile(_src_path(src, init),
+                    os.path.dirname(_dest_path(dest, init)))
+
+    # Sync the module, or maybe a .py file.
+    if os.path.isdir(_src_path(src, module)):
+        sync_directory(_src_path(src, module), _dest_path(dest, module), opts)
+    elif _is_pyfile(_src_path(src, module)):
+        sync_pyfile(_src_path(src, module),
+                    os.path.dirname(_dest_path(dest, module)))
+    else:
+        logging.warn('Could not sync: %s. Neither a pyfile or directory, '
+                     'does it even exist?' % module)
+
+
+def parse_sync_options(options):
+    if not options:
+        return []
+    return options.split(',')
+
+
+def extract_options(inc, global_options=None):
+    global_options = global_options or []
+    if global_options and isinstance(global_options, six.string_types):
+        global_options = [global_options]
+    if '|' not in inc:
+        return (inc, global_options)
+    inc, opts = inc.split('|')
+    return (inc, parse_sync_options(opts) + global_options)
+
+
+def sync_helpers(include, src, dest, options=None):
+    if os.path.exists(dest):
+        logging.debug('Removing existing directory: %s' % dest)
+        shutil.rmtree(dest)
+    if not os.path.isdir(dest):
+        os.makedirs(dest)
+
+    global_options = parse_sync_options(options)
+
+    for inc in include:
+        if isinstance(inc, str):
+            inc, opts = extract_options(inc, global_options)
+            sync(src, dest, inc, opts)
+        elif isinstance(inc, dict):
+            # could also do nested dicts here.
+            for k, v in six.iteritems(inc):
+                if isinstance(v, list):
+                    for m in v:
+                        inc, opts = extract_options(m, global_options)
+                        sync(src, dest, '%s.%s' % (k, inc), opts)
+
+
+if __name__ == '__main__':
+    parser = optparse.OptionParser()
+    parser.add_option('-c', '--config', action='store', dest='config',
+                      default=None, help='helper config file')
+    parser.add_option('-D', '--debug', action='store_true', dest='debug',
+                      default=False, help='debug')
+    parser.add_option('-r', '--repository', action='store', dest='repo',
+                      help='charm-helpers git repository (overrides config)')
+    parser.add_option('-d', '--destination', action='store', dest='dest_dir',
+                      help='sync destination dir (overrides config)')
+    (opts, args) = parser.parse_args()
+
+    if opts.debug:
+        logging.basicConfig(level=logging.DEBUG)
+    else:
+        logging.basicConfig(level=logging.INFO)
+
+    if opts.config:
+        logging.info('Loading charm helper config from %s.' % opts.config)
+        config = parse_config(opts.config)
+        if not config:
+            logging.error('Could not parse config from %s.' % opts.config)
+            sys.exit(1)
+    else:
+        config = {}
+
+    if 'repo' not in config:
+        config['repo'] = CHARM_HELPERS_REPO
+    if opts.repo:
+        config['repo'] = opts.repo
+    if opts.dest_dir:
+        config['destination'] = opts.dest_dir
+
+    if 'destination' not in config:
+        logging.error('No destination dir. specified as option or config.')
+        sys.exit(1)
+
+    if 'include' not in config:
+        if not args:
+            logging.error('No modules to sync specified as option or config.')
+            sys.exit(1)
+        config['include'] = []
+        [config['include'].append(a) for a in args]
+
+    sync_options = None
+    if 'options' in config:
+        sync_options = config['options']
+    tmpd = tempfile.mkdtemp()
+    try:
+        checkout = clone_helpers(tmpd, config['repo'])
+        sync_helpers(config['include'], checkout, config['destination'],
+                     options=sync_options)
+    except Exception as e:
+        logging.error("Could not sync: %s" % e)
+        raise e
+    finally:
+        logging.debug('Cleaning up %s' % tmpd)
+        shutil.rmtree(tmpd)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/example-config.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/example-config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8563ec01b656a6f6990378dcc137cd89f25dd540
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tools/charm_helpers_sync/example-config.yaml
@@ -0,0 +1,14 @@
+# Import from remote git repository.
+repo: https://github.com/juju/charm-helpers
+# install helpers to ./hooks/charmhelpers
+destination: hooks/charmhelpers
+include:
+    # include all of charmhelpers.core
+    - core
+    # all of charmhelpers.payload
+    - payload
+    # and a subset of charmhelpers.contrib.hahelpers
+    - contrib.hahelpers:
+        - openstack_common
+        - ceph_utils
+        - utils
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tox.ini b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tox.ini
new file mode 100644
index 0000000000000000000000000000000000000000..c4c5ed54d732a0806b8fb1de66a69306ec837c94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charm-helpers/tox.ini
@@ -0,0 +1,53 @@
+[tox]
+envlist = pep8,py2,py3
+skipsdist = true
+sitepackages = false
+# NOTE(beisner): Avoid false positives by not skipping missing interpreters.
+# NOTE(beisner): Avoid pollution by not enabling sitepackages.
+# NOTE(beisner): the 'py3' env is useful to "just give me whatever py3 is here."
+# NOTE(beisner): the 'py3x' envs are useful to use a distinct interpreter version (will fail if not found)
+ignore_basepython_conflict = true
+
+[testenv]
+setenv = VIRTUAL_ENV={envdir}
+         PYTHONHASHSEED=0
+install_command = pip install {opts} {packages}
+passenv = HOME TERM 
+commands = nosetests -s --nologcapture {posargs} --with-coverage --cover-package=charmhelpers tests/
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py2]
+basepython = python
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py3]
+basepython = python3
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py34]
+basepython = python3.4
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py35]
+basepython = python3.5
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py36]
+basepython = python3.6
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py37]
+basepython = python3.7
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:py38]
+basepython = python3.8
+deps = -r{toxinidir}/test-requirements.txt
+
+[testenv:pep8]
+basepython = python3
+deps = -r{toxinidir}/test-requirements.txt
+commands = flake8 -v {posargs} charmhelpers tests tools
+
+[flake8]
+ignore = E402,E501,E741,E722,W504
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/README.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..a98a55253f32b50a17989c1fcd7df6e5f82454af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/README.md
@@ -0,0 +1,201 @@
+# charms.osm
+
+A Python library to aid the development of charms for Open Source Mano (OSM)
+
+## How to install
+
+```bash
+git submodule add https://github.com/canonical/operator mod/operator
+git submodule add https://github.com/charmed-osm/charms.osm mod/charms.osm
+git submodule add https://github.com/juju/charm-helpers.git mod/charm-helpers  # Only for libansible
+```
+
+## SSHProxyCharm
+
+In this section, we show the class you should inherit from in order to develop your SSH Proxy charms.
+
+Example:
+
+```python
+from charms.osm.sshproxy import SSHProxyCharm
+
+class MySSHProxyCharm(SSHProxyCharm):
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Listen to the touch action event
+        self.framework.observe(self.on.touch_action, self.on_touch_action)
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+
+        if self.model.unit.is_leader():
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        else:
+            event.fail("Unit is not leader")
+            return
+```
+
+### Attributes and methods available
+
+- Atttributes:
+  - state: StoredState object. It can be used to store state data to be shared within a charm across different hooks
+- SSH related methods:
+  - get_ssh_proxy(): Return an SSHProxy object with which you can then execute scp and ssh commands in the remote machine.
+  - verify_credentials(): Return True if it has the right credentials to SSH the remote machine. It also updates the status of the unit.
+- Charm related methods: Methods that should be run in specific hooks/events.
+  - on_install(): Install dependencies for enabling SSH functionality
+  - on_start(): Generate needed SSH keys
+  - on_config_changed(): Check if the SSH
+
+### config.yaml
+
+You need to add this in your config.yaml in your charm.
+
+```yaml
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
+
+```
+
+### metadata.yaml
+
+You need to add this in your metadata.yaml in your charm.
+
+```yaml
+peers:
+  proxypeer:
+    interface: proxypeer
+```
+
+### actions.yaml
+
+You need to add this in your actions.yaml in your charm.
+
+```yaml
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
+```
+
+## SSHProxy
+
+Example:
+
+```python
+from charms.osm.sshproxy import SSHProxy
+
+# Check if SSH Proxy has key
+if not SSHProxy.has_ssh_key():
+    # Generate SSH Key
+    SSHProxy.generate_ssh_key()
+
+# Get generated public and private keys
+SSHProxy.get_ssh_public_key()
+SSHProxy.get_ssh_private_key()
+
+# Get Proxy
+proxy = SSHProxy(
+    hostname=config["ssh-hostname"],
+    username=config["ssh-username"],
+    password=config["ssh-password"],
+)
+
+# Verify credentials
+verified = proxy.verify_credentials()
+
+if verified:
+    # Run commands in remote machine
+    proxy.run("touch /home/ubuntu/touch")
+```
+
+## Libansible
+
+```python
+from charms.osm import libansible
+
+# Install ansible packages in the charm
+libansible.install_ansible_support()
+
+result = libansible.execute_playbook(
+    "configure-remote.yaml",  # Name of the playbook <-- Put the playbook in playbooks/ folder
+    config["ssh-hostname"],
+    config["ssh-username"],
+    config["ssh-password"],
+    dict_vars,  # Dictionary with variables to populate in the playbook
+)
+```
+
+## Usage
+
+Import submodules:
+
+```bash
+git submodule add https://github.com/charmed-osm/charms.osm mod/charms.osm
+git submodule add https://github.com/juju/charm-helpers.git mod/charm-helpers  # Only for libansible
+```
+
+Add symlinks:
+
+```bash
+mkdir -p lib/charms
+ln -s ../mod/charms.osm/charms/osm lib/charms/osm
+ln -s ../mod/charm-helpers/charmhelpers lib/charmhelpers  # Only for libansible
+```
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/libansible.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/libansible.py
new file mode 100644
index 0000000000000000000000000000000000000000..32fd26ae7d63d42edef33982d5438669b191a361
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/libansible.py
@@ -0,0 +1,108 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import fnmatch
+import os
+import yaml
+import subprocess
+import sys
+
+sys.path.append("lib")
+import charmhelpers.fetch
+
+
+ansible_hosts_path = "/etc/ansible/hosts"
+
+
+def install_ansible_support(from_ppa=True, ppa_location="ppa:ansible/ansible"):
+    """Installs the ansible package.
+
+    By default it is installed from the `PPA`_ linked from
+    the ansible `website`_ or from a ppa specified by a charm config..
+
+    .. _PPA: https://launchpad.net/~rquillo/+archive/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If from_ppa is empty, you must ensure that the package is available
+    from a configured repository.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install("ansible")
+    with open(ansible_hosts_path, "w+") as hosts_file:
+        hosts_file.write("localhost ansible_connection=local")
+
+
+def create_hosts(hostname, username, password, hosts):
+    inventory_path = "/etc/ansible/hosts"
+
+    with open(inventory_path, "w") as f:
+        f.write("[{}]\n".format(hosts))
+        h1 = "host ansible_host={0} ansible_user={1} ansible_password={2}\n".format(
+            hostname, username, password
+        )
+        f.write(h1)
+
+
+def create_ansible_cfg():
+    ansible_config_path = "/etc/ansible/ansible.cfg"
+
+    with open(ansible_config_path, "w") as f:
+        f.write("[defaults]\n")
+        f.write("host_key_checking = False\n")
+
+
+# Function to find the playbook path
+def find(pattern, path):
+    result = ""
+    for root, dirs, files in os.walk(path):
+        for name in files:
+            if fnmatch.fnmatch(name, pattern):
+                result = os.path.join(root, name)
+    return result
+
+
+def execute_playbook(playbook_file, hostname, user, password, vars_dict=None):
+    playbook_path = find(playbook_file, "/var/lib/juju/agents/")
+
+    with open(playbook_path, "r") as f:
+        playbook_data = yaml.load(f)
+
+    hosts = "all"
+    if "hosts" in playbook_data[0].keys() and playbook_data[0]["hosts"]:
+        hosts = playbook_data[0]["hosts"]
+
+    create_ansible_cfg()
+    create_hosts(hostname, user, password, hosts)
+
+    call = "ansible-playbook {} ".format(playbook_path)
+
+    if vars_dict and isinstance(vars_dict, dict) and len(vars_dict) > 0:
+        call += "--extra-vars "
+
+        string_var = ""
+        for k,v in vars_dict.items():
+            string_var += "{}={} ".format(k, v)
+
+        string_var = string_var.strip()
+        call += '"{}"'.format(string_var)
+
+    call = call.strip()
+    result = subprocess.check_output(call, shell=True)
+
+    return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/ns.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/ns.py
new file mode 100644
index 0000000000000000000000000000000000000000..25be4056282e48ce946632025be8b466557e3171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/ns.py
@@ -0,0 +1,301 @@
+# A prototype of a library to aid in the development and operation of
+# OSM Network Service charms
+
+import asyncio
+import logging
+import os
+import os.path
+import re
+import subprocess
+import sys
+import time
+import yaml
+
+try:
+    import juju
+except ImportError:
+    # Not all cloud images are created equal
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # Update the apt cache
+        subprocess.check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        subprocess.check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+
+    # Install the libjuju build dependencies
+    subprocess.check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    subprocess.check_call(
+        [sys.executable, "-m", "pip", "install", "juju"],
+    )
+
+from juju.controller import Controller
+
+# Quiet the debug logging
+logging.getLogger('websockets.protocol').setLevel(logging.INFO)
+logging.getLogger('juju.client.connection').setLevel(logging.WARN)
+logging.getLogger('juju.model').setLevel(logging.WARN)
+logging.getLogger('juju.machine').setLevel(logging.WARN)
+
+
+class NetworkService:
+    """A lightweight interface to the Juju controller.
+
+    This NetworkService client is specifically designed to allow a higher-level
+    "NS" charm to interoperate with "VNF" charms, allowing for the execution of
+    Primitives across other charms within the same model.
+    """
+    endpoint = None
+    user = 'admin'
+    secret = None
+    port = 17070
+    loop = None
+    client = None
+    model = None
+    cacert = None
+
+    def __init__(self, user, secret, endpoint=None):
+
+        self.user = user
+        self.secret = secret
+        if endpoint is None:
+            addresses = os.environ['JUJU_API_ADDRESSES']
+            for address in addresses.split(' '):
+                self.endpoint = address
+        else:
+            self.endpoint = endpoint
+
+        # Stash the name of the model
+        self.model = os.environ['JUJU_MODEL_NAME']
+
+        # Load the ca-cert from agent.conf
+        AGENT_PATH = os.path.dirname(os.environ['JUJU_CHARM_DIR'])
+        with open("{}/agent.conf".format(AGENT_PATH), "r") as f:
+            try:
+                y = yaml.safe_load(f)
+                self.cacert = y['cacert']
+            except yaml.YAMLError as exc:
+                print("Unable to find Juju ca-cert.")
+                raise exc
+
+        # Create our event loop
+        self.loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(self.loop)
+
+    async def connect(self):
+        """Connect to the Juju controller."""
+        controller = Controller()
+
+        print(
+            "Connecting to controller... ws://{}:{} as {}/{}".format(
+                self.endpoint,
+                self.port,
+                self.user,
+                self.secret[-4:].rjust(len(self.secret), "*"),
+            )
+        )
+        await controller.connect(
+            endpoint=self.endpoint,
+            username=self.user,
+            password=self.secret,
+            cacert=self.cacert,
+        )
+
+        return controller
+
+    def __del__(self):
+        self.logout()
+
+    async def disconnect(self):
+        """Disconnect from the Juju controller."""
+        if self.client:
+            print("Disconnecting Juju controller")
+            await self.client.disconnect()
+
+    def login(self):
+        """Login to the Juju controller."""
+        if not self.client:
+            # Connect to the Juju API server
+            self.client = self.loop.run_until_complete(self.connect())
+        return self.client
+
+    def logout(self):
+        """Logout of the Juju controller."""
+
+        if self.loop:
+            print("Disconnecting from API")
+            self.loop.run_until_complete(self.disconnect())
+
+    def FormatApplicationName(self, *args):
+        """
+        Generate a Juju-compatible Application name
+
+        :param args tuple: Positional arguments to be used to construct the
+        application name.
+
+        Limitations::
+        - Only accepts characters a-z and non-consequitive dashes (-)
+        - Application name should not exceed 50 characters
+
+        Examples::
+
+            FormatApplicationName("ping_pong_ns", "ping_vnf", "a")
+        """
+        appname = ""
+        for c in "-".join(list(args)):
+            if c.isdigit():
+                c = chr(97 + int(c))
+            elif not c.isalpha():
+                c = "-"
+            appname += c
+
+        return re.sub('-+', '-', appname.lower())
+
+    def GetApplicationName(self, nsr_name, vnf_name, vnf_member_index):
+        """Get the runtime application name of a VNF/VDU.
+
+        This will generate an application name matching the name of the deployed charm,
+        given the right parameters.
+
+        :param nsr_name str: The name of the running Network Service, as specified at instantiation.
+        :param vnf_name str: The name of the VNF or VDU
+        :param vnf_member_index: The vnf-member-index as specified in the descriptor
+        """
+
+        application_name = self.FormatApplicationName(nsr_name, vnf_member_index, vnf_name)
+
+        # This matches the logic used by the LCM
+        application_name = application_name[0:48]
+        vca_index = int(vnf_member_index) - 1
+        application_name += '-' + chr(97 + vca_index // 26) + chr(97 + vca_index % 26)
+
+        return application_name
+
+    def ExecutePrimitiveGetOutput(self, application, primitive, params={}, timeout=600):
+        """Execute a single primitive and return it's output.
+
+        This is a blocking method that will execute a single primitive and wait
+        for its completion before return it's output.
+
+        :param application str: The application name provided by `GetApplicationName`.
+        :param primitive str: The name of the primitive to execute.
+        :param params list: A list of parameters.
+        :param timeout int: A timeout, in seconds, to wait for the primitive to finish. Defaults to 600 seconds.
+        """
+        uuid = self.ExecutePrimitive(application, primitive, params)
+
+        status = None
+        output = None
+
+        starttime = time.time()
+        while(time.time() < starttime + timeout):
+            status = self.GetPrimitiveStatus(uuid)
+            if status in ['completed', 'failed']:
+                break
+            time.sleep(10)
+
+        # When the primitive is done, get the output
+        if status in ['completed', 'failed']:
+            output = self.GetPrimitiveOutput(uuid)
+
+        return output
+
+    def ExecutePrimitive(self, application, primitive, params={}):
+        """Execute a primitive.
+
+        This is a non-blocking method to execute a primitive. It will return
+        the UUID of the queued primitive execution, which you can use
+        for subsequent calls to `GetPrimitiveStatus` and `GetPrimitiveOutput`.
+
+        :param application string: The name of the application
+        :param primitive string: The name of the Primitive.
+        :param params list: A list of parameters.
+
+        :returns uuid string: The UUID of the executed Primitive
+        """
+        uuid = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        # Get the application
+        if application in model.applications:
+            app = model.applications[application]
+
+            # Execute the primitive
+            unit = app.units[0]
+            if unit:
+                action = self.loop.run_until_complete(
+                    unit.run_action(primitive, **params)
+                )
+                uuid = action.id
+                print("Executing action: {}".format(uuid))
+            self.loop.run_until_complete(
+                model.disconnect()
+            )
+        else:
+            # Invalid mapping: application not found. Raise exception
+            raise Exception("Application not found: {}".format(application))
+
+        return uuid
+
+    def GetPrimitiveStatus(self, uuid):
+        """Get the status of a Primitive execution.
+
+        This will return one of the following strings:
+        - pending
+        - running
+        - completed
+        - failed
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The status of the executed Primitive
+        """
+        status = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        status = self.loop.run_until_complete(
+            model.get_action_status(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return status[uuid]
+
+    def GetPrimitiveOutput(self, uuid):
+        """Get the output of a completed Primitive execution.
+
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The output of the execution, or None if it's still running.
+        """
+        result = None
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        result = self.loop.run_until_complete(
+            model.get_action_output(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/proxy_cluster.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/proxy_cluster.py
new file mode 100644
index 0000000000000000000000000000000000000000..f323a3af88f3011ef9fde794cdfe343be8665abb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/proxy_cluster.py
@@ -0,0 +1,59 @@
+import socket
+
+from ops.framework import Object, StoredState
+
+
+class ProxyCluster(Object):
+
+    state = StoredState()
+
+    def __init__(self, charm, relation_name):
+        super().__init__(charm, relation_name)
+        self._relation_name = relation_name
+        self._relation = self.framework.model.get_relation(self._relation_name)
+
+        self.framework.observe(charm.on.ssh_keys_initialized, self.on_ssh_keys_initialized)
+
+        self.state.set_default(ssh_public_key=None)
+        self.state.set_default(ssh_private_key=None)
+
+    def on_ssh_keys_initialized(self, event):
+        if not self.framework.model.unit.is_leader():
+            raise RuntimeError("The initial unit of a cluster must also be a leader.")
+
+        self.state.ssh_public_key = event.ssh_public_key
+        self.state.ssh_private_key = event.ssh_private_key
+        if not self.is_joined:
+            event.defer()
+            return
+
+        self._relation.data[self.model.app][
+            "ssh_public_key"
+        ] = self.state.ssh_public_key
+        self._relation.data[self.model.app][
+            "ssh_private_key"
+        ] = self.state.ssh_private_key
+
+    @property
+    def is_joined(self):
+        return self._relation is not None
+
+    @property
+    def ssh_public_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_public_key")
+
+    @property
+    def ssh_private_key(self):
+        if self.is_joined:
+            return self._relation.data[self.model.app].get("ssh_private_key")
+
+    @property
+    def is_cluster_initialized(self):
+        return (
+            True
+            if self.is_joined
+            and self._relation.data[self.model.app].get("ssh_public_key")
+            and self._relation.data[self.model.app].get("ssh_private_key")
+            else False
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/sshproxy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2c311e5be8515a7fe19c05dfed9f042ded0576b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/charms.osm/charms/osm/sshproxy.py
@@ -0,0 +1,375 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# from charmhelpers.core import unitdata
+# from charmhelpers.core.hookenv import log
+
+import io
+import ipaddress
+import subprocess
+import os
+import socket
+import shlex
+import traceback
+import sys
+
+from subprocess import (
+    check_call,
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+import os
+import subprocess
+from .proxy_cluster import ProxyCluster
+
+import logging
+
+
+logger = logging.getLogger(__name__)
+
+class SSHKeysInitialized(EventBase):
+    def __init__(self, handle, ssh_public_key, ssh_private_key):
+        super().__init__(handle)
+        self.ssh_public_key = ssh_public_key
+        self.ssh_private_key = ssh_private_key
+
+    def snapshot(self):
+        return {
+            "ssh_public_key": self.ssh_public_key,
+            "ssh_private_key": self.ssh_private_key,
+        }
+
+    def restore(self, snapshot):
+        self.ssh_public_key = snapshot["ssh_public_key"]
+        self.ssh_private_key = snapshot["ssh_private_key"]
+
+
+class ProxyClusterEvents(CharmEvents):
+    ssh_keys_initialized = EventSource(SSHKeysInitialized)
+
+
+class SSHProxyCharm(CharmBase):
+
+    state = StoredState()
+    on = ProxyClusterEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        self.peers = ProxyCluster(self, "proxypeer")
+
+        # SSH Proxy actions (primitives)
+        self.framework.observe(self.on.generate_ssh_key_action, self.on_generate_ssh_key_action)
+        self.framework.observe(self.on.get_ssh_public_key_action, self.on_get_ssh_public_key_action)
+        self.framework.observe(self.on.run_action, self.on_run_action)
+        self.framework.observe(self.on.verify_ssh_credentials_action, self.on_verify_ssh_credentials_action)
+
+        self.framework.observe(self.on.proxypeer_relation_changed, self.on_proxypeer_relation_changed)
+
+    def get_ssh_proxy(self):
+        """Get the SSHProxy instance"""
+        proxy = SSHProxy(
+            hostname=self.model.config["ssh-hostname"],
+            username=self.model.config["ssh-username"],
+            password=self.model.config["ssh-password"],
+        )
+        return proxy
+
+    def on_proxypeer_relation_changed(self, event):
+        if self.peers.is_cluster_initialized and not SSHProxy.has_ssh_key():
+            pubkey = self.peers.ssh_public_key
+            privkey = self.peers.ssh_private_key
+            SSHProxy.write_ssh_keys(public=pubkey, private=privkey)
+            self.verify_credentials()
+        else:
+            event.defer()
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        self.verify_credentials()
+
+    def on_install(self, event):
+        SSHProxy.install()
+
+    def on_start(self, event):
+        """Called when the charm is being installed"""
+        if not self.peers.is_joined:
+            event.defer()
+            return
+
+        unit = self.model.unit
+
+        if not SSHProxy.has_ssh_key():
+            unit.status = MaintenanceStatus("Generating SSH keys...")
+            pubkey = None
+            privkey = None
+            if self.model.unit.is_leader():
+                if self.peers.is_cluster_initialized:
+                    SSHProxy.write_ssh_keys(
+                        public=self.peers.ssh_public_key,
+                        private=self.peers.ssh_private_key,
+                    )
+                else:
+                    SSHProxy.generate_ssh_key()
+                    self.on.ssh_keys_initialized.emit(
+                        SSHProxy.get_ssh_public_key(), SSHProxy.get_ssh_private_key()
+                    )
+        self.verify_credentials()
+
+    def verify_credentials(self):
+        unit = self.model.unit
+
+        # Unit should go into a waiting state until verify_ssh_credentials is successful
+        unit.status = WaitingStatus("Waiting for SSH credentials")
+        proxy = self.get_ssh_proxy()
+        verified, _ = proxy.verify_credentials()
+        if verified:
+            unit.status = ActiveStatus()
+        else:
+            unit.status = BlockedStatus("Invalid SSH credentials.")
+        return verified
+
+    #####################
+    # SSH Proxy methods #
+    #####################
+    def on_generate_ssh_key_action(self, event):
+        """Generate a new SSH keypair for this unit."""
+        if self.model.unit.is_leader():
+            if not SSHProxy.generate_ssh_key():
+                event.fail("Unable to generate ssh key")
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_get_ssh_public_key_action(self, event):
+        """Get the SSH public key for this unit."""
+        if self.model.unit.is_leader():
+            pubkey = SSHProxy.get_ssh_public_key()
+            event.set_results({"pubkey": SSHProxy.get_ssh_public_key()})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_run_action(self, event):
+        """Run an arbitrary command on the remote host."""
+        if self.model.unit.is_leader():
+            cmd = event.params["command"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(cmd)
+            event.set_results({"output": stdout})
+            if len(stderr):
+                event.fail(stderr)
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_verify_ssh_credentials_action(self, event):
+        """Verify the SSH credentials for this unit."""
+        unit = self.model.unit
+        if unit.is_leader():
+            proxy = self.get_ssh_proxy()
+            verified, stderr = proxy.verify_credentials()
+            if verified:
+                event.set_results({"verified": True})
+                unit.status = ActiveStatus()
+            else:
+                event.set_results({"verified": False, "stderr": stderr})
+                event.fail("Not verified")
+                unit.status = BlockedStatus("Invalid SSH credentials.")
+
+        else:
+            event.fail("Unit is not leader")
+            return
+
+
+class LeadershipError(ModelError):
+    def __init__(self):
+        super().__init__("not leader")
+
+class SSHProxy:
+    private_key_path = "/root/.ssh/id_sshproxy"
+    public_key_path = "/root/.ssh/id_sshproxy.pub"
+    key_type = "rsa"
+    key_bits = 4096
+
+    def __init__(self, hostname: str, username: str, password: str = ""):
+        self.hostname = hostname
+        self.username = username
+        self.password = password
+
+    @staticmethod
+    def install():
+        check_call("apt update && apt install -y openssh-client sshpass", shell=True)
+
+    @staticmethod
+    def generate_ssh_key():
+        """Generate a 4096-bit rsa keypair."""
+        if not os.path.exists(SSHProxy.private_key_path):
+            cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+                SSHProxy.key_type, SSHProxy.key_bits, SSHProxy.private_key_path,
+            )
+
+            try:
+                check_call(cmd, shell=True)
+            except CalledProcessError:
+                return False
+
+        return True
+
+    @staticmethod
+    def write_ssh_keys(public, private):
+        """Write a 4096-bit rsa keypair."""
+        with open(SSHProxy.public_key_path, "w") as f:
+            f.write(public)
+            f.close()
+        with open(SSHProxy.private_key_path, "w") as f:
+            f.write(private)
+            f.close()
+
+    @staticmethod
+    def get_ssh_public_key():
+        publickey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.public_key_path, "r") as f:
+                publickey = f.read()
+        return publickey
+
+    @staticmethod
+    def get_ssh_private_key():
+        privatekey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.private_key_path, "r") as f:
+                privatekey = f.read()
+        return privatekey
+
+    @staticmethod
+    def has_ssh_key():
+        return True if os.path.exists(SSHProxy.private_key_path) else False
+
+    def run(self, cmd: str) -> (str, str):
+        """Run a command remotely via SSH.
+
+        Note: The previous behavior was to run the command locally if SSH wasn't
+        configured, but that can lead to cases where execution succeeds when you'd
+        expect it not to.
+        """
+        if isinstance(cmd, str):
+            cmd = shlex.split(cmd)
+
+        host = self._get_hostname()
+        user = self.username
+        passwd = self.password
+        key = self.private_key_path
+
+        # Make sure we have everything we need to connect
+        if host and user:
+            return self.ssh(cmd)
+
+        raise Exception("Invalid SSH credentials.")
+
+    def scp(self, source_file, destination_file):
+        """Execute an scp command. Requires a fully qualified source and
+        destination.
+
+        :param str source_file: Path to the source file
+        :param str destination_file: Path to the destination file
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "scp",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            "-B",
+        ]
+        destination = "{}@{}:{}".format(self.username, self.hostname, destination_file)
+        cmd.extend([source_file, destination])
+        subprocess.run(cmd, check=True)
+
+    def ssh(self, command):
+        """Run a command remotely via SSH.
+
+        :param list(str) command: The command to execute
+        :return: tuple: The stdout and stderr of the command execution
+        :raises: :class:`CalledProcessError` if the command fails
+        """
+
+        destination = "{}@{}".format(self.username, self.hostname)
+        cmd = [
+            "sshpass",
+            "-p",
+            self.password,
+            "ssh",
+            "-i",
+            os.path.expanduser(self.private_key_path),
+            "-o",
+            "StrictHostKeyChecking=no",
+            "-q",
+            destination,
+        ]
+        cmd.extend(command)
+        output = subprocess.run(cmd, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        return (output.stdout.decode("utf-8").strip(), output.stderr.decode("utf-8").strip())
+
+    def verify_credentials(self):
+        """Verify the SSH credentials.
+        
+        :return (bool, str): Verified, Stderr
+        """
+        verified = False
+        try:
+            (stdout, stderr) = self.run("hostname")
+            verified = True
+        except CalledProcessError as e:
+            stderr = "Command failed: {} ({})".format(" ".join(e.cmd), str(e.output))
+        except (TimeoutError, socket.timeout):
+            stderr = "Timeout attempting to reach {}".format(self._get_hostname())
+        except Exception as error:
+            tb = traceback.format_exc()
+            stderr = "Unhandled exception: {}".format(tb)
+        return verified, stderr
+
+    ###################
+    # Private methods #
+    ###################
+    def _get_hostname(self):
+        """Get the hostname for the ssh target.
+
+        HACK: This function was added to work around an issue where the
+        ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+        is the floating ip, and the second the non-floating ip, for an Openstack
+        instance.
+        """
+        return self.hostname.split(";")[0]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.flake8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.flake8
new file mode 100644
index 0000000000000000000000000000000000000000..61d908155588a7968dd25c90cff349377305a789
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.flake8
@@ -0,0 +1,2 @@
+[flake8]
+max-line-length = 99
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.gitignore b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..5596c502618d6428de0199c4cec069c151c0edd3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.gitignore
@@ -0,0 +1,4 @@
+__pycache__
+/sandbox
+.idea
+docs/_build
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.readthedocs.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.readthedocs.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b6989fdb6a173e6f75343fd5d2953acb9c24b0a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.readthedocs.yaml
@@ -0,0 +1,6 @@
+version: 2                      # required
+formats: []                     # i.e. no extra formats (for now)
+python:
+  version: "3.5"
+  install:
+    - requirements: docs/requirements.txt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.travis.yml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.travis.yml
new file mode 100644
index 0000000000000000000000000000000000000000..5aa83238027ae5dccb4a797e6c7ed456f1cfe5de
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/.travis.yml
@@ -0,0 +1,24 @@
+dist: bionic
+
+language: python
+
+arch:
+    - amd64
+    - arm64
+
+python:
+    - "3.5"
+    - "3.6"
+    - "3.7"
+    - "3.8"
+
+matrix:
+    include:
+        - os: osx
+          language: generic
+
+install:
+    - pip3 install -r requirements-dev.txt
+
+script:
+    - ./run_tests
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/CODE_OF_CONDUCT.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000000000000000000000000000000000000..b5bc1b1f8f266e3c7e15e8b8db490f688a1e5230
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/CODE_OF_CONDUCT.md
@@ -0,0 +1,78 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+ advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior
+may be reported by contacting the project team at
+charmcrafters@lists.launchpad.net. All complaints will be reviewed and
+investigated and will result in a response that is deemed necessary
+and appropriate to the circumstances. The project team is obligated to
+maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted
+separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/README.md b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..3b4e63f67906e9b9cbaf4fe2055e35005b1380a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/README.md
@@ -0,0 +1,138 @@
+# The Operator Framework
+
+The Operator Framework provides a simple, lightweight, and powerful way of
+writing Juju charms, the best way to encapsulate operational experience in code.
+
+The framework will help you to:
+
+* model the integration of your services
+* manage the lifecycle of your application
+* create reusable and scalable components
+* keep your code simple and readable
+
+## Getting Started
+
+Charms written using the operator framework are just Python code. The intention
+is for it to feel very natural for somebody used to coding in Python, and
+reasonably easy to pick up for somebody who might be a domain expert but not
+necessarily a pythonista themselves.
+
+The dependencies of the operator framework are kept as minimal as possible;
+currently that's Python 3.5 or greater, and `PyYAML` (both are included by
+default in Ubuntu's cloud images from 16.04 on).
+
+<!--
+If you're new to the world of Juju and charms, you should probably dive into our
+[tutorial](/TBD).
+
+If you know about Juju, and have written charms that didn't use the operator
+framework (be it with reactive or without), we have an [introduction to the
+operator framework](/TBD) just for you.
+
+If you've gone through the above already and just want a refresher, or are
+really impatient and need to dive in, feel free to carry on down.
+-->
+## A Quick Introduction
+
+Operator framework charms are just Python code. The entry point to your charm is
+a particular Python file. It could be anything that makes sense to your project,
+but let's assume this is `src/charm.py`. This file must be executable (and it
+must have the appropriate shebang line).
+
+You need the usual `metadata.yaml` and (probably) `config.yaml` files, and a
+`requirements.txt` for any Python dependencies.  In other words, your project
+might look like this:
+
+```
+my-charm
+├── config.yaml
+├── metadata.yaml
+├── requirements.txt
+└── src/
+    └── charm.py
+```
+
+`src/charm.py` here is the entry point to your charm code. At a minimum, it
+needs to define a subclass of `CharmBase` and pass that into the framework's
+`main` function:
+
+```python
+from ops.charm import CharmBase
+from ops.main import main
+
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.start, self.on_start)
+
+    def on_start(self, event):
+        # Handle the start event here.
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+That should be enough for you to be able to run
+
+```
+$ charmcraft build
+Done, charm left in 'my-charm.charm'
+$ juju deploy my-charm.charm
+```
+
+> 🛈 More information on [`charmcraft`](https://pypi.org/project/charmcraft/) can
+> also be found on its [github page](https://github.com/canonical/charmcraft).
+
+Happy charming!
+
+## Testing your charms
+
+The operator framework provides a testing harness, so that you can test that
+your charm does the right thing when presented with different scenarios, without
+having to have a full deployment to do so. `pydoc3 ops.testing` has the details
+for that, including this example:
+
+```python
+harness = Harness(MyCharm)
+# Do initial setup here
+relation_id = harness.add_relation('db', 'postgresql')
+# Now instantiate the charm to see events as the model changes
+harness.begin()
+harness.add_relation_unit(relation_id, 'postgresql/0')
+harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+# Check that charm has properly handled the relation_joined event for postgresql/0
+self.assertEqual(harness.charm. ...)
+```
+
+## Talk to us
+
+If you need help, have ideas, or would just like to chat with us, reach out on
+IRC: we're in [#smooth-operator] on freenode (or try the [webchat]).
+
+We also pay attention to Juju's [discourse], but currently we don't actively
+post there outside of our little corner of the [docs]; most discussion at this
+stage is on IRC.
+
+[webchat]: https://webchat.freenode.net/#smooth-operator
+[#smooth-operator]: irc://chat.freenode.net/%23smooth-operator
+[discourse]: https://discourse.juju.is/c/charming
+[docs]: https://discourse.juju.is/c/docs/operator-framework
+
+## Operator Framework development
+
+If you want to work in the framework *itself* you will need Python >= 3.5 and
+the dependencies declared in `requirements-dev.txt` installed in your system.
+Or you can use a virtualenv:
+
+    virtualenv --python=python3 env
+    source env/bin/activate
+    pip install -r requirements-dev.txt
+
+Then you can try `./run_tests`, it should all go green.
+
+If you want to build the documentation you'll need the requirements from
+`docs/requirements.txt`, or in your virtualenv
+
+    pip install -r docs/requirements.txt
+
+and then you can run `./build_docs`.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/build_docs b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/build_docs
new file mode 100755
index 0000000000000000000000000000000000000000..af8b892f7568bdda5ac892beaeafad5696e607d3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/build_docs
@@ -0,0 +1,18 @@
+#!/bin/sh
+
+set -e
+
+flavour=html
+
+if [ "$1" ]; then
+    if [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
+        flavour=help
+    else
+        flavour="$1"
+    fi
+    shift
+fi
+
+cd docs
+
+sphinx-build -M "$flavour" . _build "$@"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/conf.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/conf.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8d3e3d57b11cbd9ae6bb144336728e433ae1d28
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/conf.py
@@ -0,0 +1,97 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For a full list of options see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+
+# -- Path setup --------------------------------------------------------------
+
+from pathlib import Path
+import sys
+sys.path.insert(0, str(Path(__file__).parent.parent))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'The Operator Framework'
+copyright = '2019-2020, Canonical Ltd.'
+author = 'Canonical Ltd'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.todo',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.intersphinx',
+]
+
+# The document name of the “master” document, that is, the document
+# that contains the root toctree directive.
+master_doc = 'index'
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'sphinx_rtd_theme'  # 'alabaster'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+
+# -- Options for sphinx.ext.todo ---------------------------------------------
+
+#  If this is True, todo and todolist produce output, else they
+#  produce nothing. The default is False.
+todo_include_todos = False
+
+
+# -- Options for sphinx.ext.autodoc ------------------------------------------
+
+# This value controls how to represents typehints. The setting takes the
+# following values:
+#     'signature' – Show typehints as its signature (default)
+#     'description' – Show typehints as content of function or method
+#     'none' – Do not show typehints
+autodoc_typehints = 'description'
+
+# This value selects what content will be inserted into the main body of an
+# autoclass directive. The possible values are:
+#     'class' - Only the class’ docstring is inserted. This is the
+#               default. You can still document __init__ as a separate method
+#               using automethod or the members option to autoclass.
+#     'both' - Both the class’ and the __init__ method’s docstring are
+#              concatenated and inserted.
+#     'init' - Only the __init__ method’s docstring is inserted.
+autoclass_content = 'both'
+
+autodoc_default_options = {
+    'members': None,            # None here means "yes"
+    'undoc-members': None,
+    'show-inheritance': None,
+}
+
+
+# -- Options for sphinx.ext.intersphinx --------------------------------------
+
+# This config value contains the locations and names of other projects
+# that should be linked to in this documentation.
+intersphinx_mapping = {'python': ('https://docs.python.org/3', None)}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/index.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..424d78d423e1e7dd5d4049c9f88ffaec994c1714
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/index.rst
@@ -0,0 +1,58 @@
+
+Welcome to The Operator Framework's documentation!
+==================================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+ops package
+===========
+
+.. automodule:: ops
+
+Submodules
+----------
+
+ops.charm module
+----------------
+
+.. automodule:: ops.charm
+
+ops.framework module
+--------------------
+
+.. automodule:: ops.framework
+
+ops.jujuversion module
+----------------------
+
+.. automodule:: ops.jujuversion
+
+ops.log module
+--------------
+
+.. automodule:: ops.log
+
+ops.main module
+---------------
+
+.. automodule:: ops.main
+
+ops.model module
+----------------
+
+.. automodule:: ops.model
+
+ops.testing module
+------------------
+
+.. automodule:: ops.testing
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..217e49dd6e684b07eaac18aec4c2f717e5f9f5f0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/docs/requirements.txt
@@ -0,0 +1,5 @@
+-r ../requirements.txt
+
+sphinx==3.*
+sphinx_rtd_theme
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..d898de859fc444814bc19a7f8f0caaaec6f7e5f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/charm.py
@@ -0,0 +1,575 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """A base class for events that trigger because of a Juju hook firing."""
+
+
+class ActionEvent(EventBase):
+    """A base class for events that trigger when a user asks for an Action to be run.
+
+    To read the parameters for the action, see the instance variable `params`.
+    To respond with the result of the action, call `set_results`. To add progress
+    messages that are visible as the action is progressing use `log`.
+
+    :ivar params: The parameters passed to the action (read by action-get)
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the user is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by Charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Represents the `install` hook from Juju."""
+
+
+class StartEvent(HookEvent):
+    """Represents the `start` hook from Juju."""
+
+
+class StopEvent(HookEvent):
+    """Represents the `stop` hook from Juju."""
+
+
+class RemoveEvent(HookEvent):
+    """Represents the `remove` hook from Juju. """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Represents the `config-changed` hook from Juju."""
+
+
+class UpdateStatusEvent(HookEvent):
+    """Represents the `update-status` hook from Juju."""
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Represents the `upgrade-charm` hook from Juju.
+
+    This will be triggered when a user has run `juju upgrade-charm`. It is run after Juju
+    has unpacked the upgraded charm code, and so this event will be handled with new code.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Represents the `pre-series-upgrade` hook from Juju.
+
+    This happens when a user has run `juju upgrade-series MACHINE prepare` and
+    will fire for each unit that is running on the machine, telling them that
+    the user is preparing to upgrade the Machine's series (eg trusty->bionic).
+    The charm should take actions to prepare for the upgrade (a database charm
+    would want to write out a version-independent dump of the database, so that
+    when a new version of the database is available in a new series, it can be
+    used.)
+    Once all units on a machine have run `pre-series-upgrade`, the user will
+    initiate the steps to actually upgrade the machine (eg `do-release-upgrade`).
+    When the upgrade has been completed, the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Represents the `post-series-upgrade` hook from Juju.
+
+    This is run after the user has done a distribution upgrade (or rolled back
+    and kept the same series). It is called in response to
+    `juju upgrade-series MACHINE complete`. Charms are expected to do whatever
+    steps are necessary to reconfigure their applications for the new series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Represents the `leader-elected` hook from Juju.
+
+    Juju will trigger this when a new lead unit is chosen for a given application.
+    This represents the leader of the charm information (not necessarily the primary
+    of a running application). The main utility is that charm authors can know
+    that only one unit will be a leader at any given time, so they can do
+    configuration, etc, that would otherwise require coordination between units.
+    (eg, selecting a password for a new relation)
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Represents the `leader-settings-changed` hook from Juju.
+
+    Deprecated. This represents when a lead unit would call `leader-set` to inform
+    the other units of an application that they have new information to handle.
+    This has been deprecated in favor of using a Peer relation, and having the
+    leader set a value in the Application data bag for that peer relation.
+    (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Represents the `collect-metrics` hook from Juju.
+
+    Note that events firing during a CollectMetricsEvent are currently
+    sandboxed in how they can interact with Juju. To report metrics
+    use :meth:`.add_metrics`.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Charmers should not be creating RelationEvents directly. The events will be
+    generated by the framework from Juju related events. Users can observe them
+    from the various `CharmBase.on[relation_name].relation_*` events.
+
+    Attributes:
+        relation: The Relation involved in this event
+        app: The remote application that has triggered this event
+        unit: The remote unit that has triggered this event. This may be None
+              if the relation event was triggered as an Application level event
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by Charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by Charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Represents the `relation-created` hook from Juju.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Represents the `relation-joined` hook from Juju.
+
+    This is triggered whenever a new unit of a related application joins the relation.
+    (eg, a unit was added to an existing related app, or a new relation was established
+    with an application that already had units.)
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Represents the `relation-changed` hook from Juju.
+
+    This is triggered whenever there is a change to the data bucket for a related
+    application or unit. Look at `event.relation.data[event.unit/app]` to see the
+    new information.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Represents the `relation-departed` hook from Juju.
+
+    This is the inverse of the RelationJoinedEvent, representing when a unit
+    is leaving the relation (the unit is being removed, the app is being removed,
+    the relation is being removed). It is fired once for each unit that is
+    going away.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Represents the `relation-broken` hook from Juju.
+
+    If a relation is being removed (`juju remove-relation` or `juju remove-application`),
+    once all the units have been removed, RelationBrokenEvent will fire to signal
+    that the relationship has been fully terminated.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing Storage related events."""
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Represents the `storage-attached` hook from Juju.
+
+    Called when new storage is available for the charm to use.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Represents the `storage-detaching` hook from Juju.
+
+    Called when storage a charm has been using is going away.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """The events that are generated by Juju in response to the lifecycle of an application."""
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the Charm overall.
+
+    Usually this initialization is done by ops.main.main() rather than Charm authors
+    directly instantiating a Charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            Charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+    """
+
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """CharmMeta of this charm.
+        """
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the Charm as it is running.
+        """
+        return self.framework.charm_dir
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from metadata.yaml and/or actions.yaml. Generally charms will
+    define this information, rather than reading it at runtime. This class is
+    mostly for the framework to understand what the charm has defined.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by Charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/framework.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..b7c4749ff2b5bfb4f354bf1a8d4cd6ed64cf0da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/framework.py
@@ -0,0 +1,1067 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(ObjectEvents):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+        # breakpoint(); if Python < 3.7, this doesn't affect anything
+        sys.breakpointhook = self.breakpoint
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse once the env var, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/jujuversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..b2b8177dbe396f0d8c46b86e26af6b4e54ea046d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/jujuversion.py
@@ -0,0 +1,98 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if not v:
+            raise RuntimeError('environ has no JUJU_VERSION')
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edb9fcacea6f0173aed9f07ca8a683cfead989cc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/lib/__init__.py
@@ -0,0 +1,194 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import os
+import re
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except OSError:
+            continue
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except OSError:
+                continue
+            finder = get_importer(opslib)
+            if finder is None or not hasattr(finder, 'find_spec'):
+                continue
+            for lib_dir in lib_dirs:
+                spec = finder.find_spec(lib_dir)
+                if spec is None:
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    continue
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        return None
+
+    _expected = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_expected):
+                    break
+                if n > _MAX_LIB_LINES:
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _expected:
+                    value = literal_eval(value)
+                    if not isinstance(value, _expected[key]):
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_expected):
+                    return None
+    except Exception:
+        return None
+
+    return _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {0.name} by {0.author}, API {0.api}, patch {0.patch}>".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/log.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aac5543aec4d84dc393e79b772a30284712d6d4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/log.py
@@ -0,0 +1,51 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..6dc31c3575044796e8fe1f61b8415395689d6339
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/main.py
@@ -0,0 +1,348 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import logging
+import os
+import subprocess
+import sys
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows.
+        # For Windows it is always an absolute path (any symlinks are resolved)
+        # while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(sys.argv[0])
+
+        if 'JUJU_DISPATCH_PATH' in os.environ and (charm_dir / 'dispatch').exists():
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk"""
+
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = self._charm_dir / self._dispatch_path
+        if not dispatch_path.exists():
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == self._exec_path.resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning(
+                "Legacy %s exited with status %d.",
+                self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """"Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def main(charm_class, use_juju_for_storage=False):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96e89154ea9cec2b62a4fab4649412e115c304e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/model.py
@@ -0,0 +1,1237 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+
+    Attributes:
+        unit: A :class:`Unit` that represents the unit that is running this code (eg yourself)
+        app: A :class:`Application` that represents the application this unit is a part of.
+        relations: Mapping of endpoint to list of :class:`Relation` answering the question
+            "what am I currently related to". See also :meth:`.get_relation`
+        config: A dict of the config for the current application.
+        resources: Access to resources for this charm. Use ``model.resources.fetch(resource_name)``
+            to get the path on disk where the resource can be found.
+        storages: Mapping of storage_name to :class:`Storage` for the storage points defined in
+            metadata.yaml
+        pod: Used to get access to ``model.pod.set_spec`` to set the container specification
+            for Kubernetes charms.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(self._backend.unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworKInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info['bind-addresses']:
+            interface_name = interface_info['interface-name']
+            for address_info in interface_info['addresses']:
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info['ingress-addresses']:
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info['egress-subnets']:
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        return self.interfaces[0].address
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        return self.ingress_addresses[0]
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        self.address = ipaddress.ip_address(address_info['value'])
+        cidr = address_info['cidr']
+        if not cidr:
+            # The cidr field may be empty, see LP: #1864102.
+            # In this case, make it a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address_info['value'])
+        else:
+            self.subnet = ipaddress.ip_network(cidr)
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """"Represents a storage as defined in metadata.yaml
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            app: A boolean indicating whether the status should be set for a unit or an
+                application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/storage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/storage.py
new file mode 100755
index 0000000000000000000000000000000000000000..d4310ce1cfbb707c6278b70f84a9751da3ce07af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/storage.py
@@ -0,0 +1,318 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)"""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: typing.Optional[str]) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """"Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        return
+
+    def commit(self):
+        return
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str):
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    @staticmethod
+    def is_available() -> bool:
+        """Check if Juju state storage is available.
+
+        This checks if there is a 'state-get' executable in PATH.
+        """
+        p = shutil.which('state-get')
+        return p is not None
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf-8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        subprocess.run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = subprocess.run(
+            ["state-get", key],
+            stdout=subprocess.PIPE,
+            check=True,
+        )
+        if p.stdout == b'' or p.stdout == b'\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        subprocess.run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/testing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/testing.py
new file mode 100755
index 0000000000000000000000000000000000000000..b4b3fe071216238007c9f3847ca9556be626bf6b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/testing.py
@@ -0,0 +1,586 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pathlib
+from textwrap import dedent
+import tempfile
+import typing
+import yaml
+import weakref
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None):
+        # TODO: jam 2020-03-05 We probably want to take config as a parameter as well, since
+        #       it would define the default values of config that the charm would see.
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._lazy_resource_dir = None
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    @property
+    def _resource_dir(self) -> pathlib.Path:
+        if self._lazy_resource_dir is not None:
+            return self._lazy_resource_dir
+
+        self.__resource_dir = tempfile.TemporaryDirectory()
+        self._lazy_resource_dir = pathlib.Path(self.__resource_dir.name)
+        self._finalizer = weakref.finalize(self, self.__resource_dir.cleanup)
+        return self._lazy_resource_dir
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling begin(), there is no Charm instance, so changes to the Model won't emit
+        events. You must call begin before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+        resource_dir = self._resource_dir / resource_name
+        resource_dir.mkdir(exist_ok=True)
+        resource_file = resource_dir / "contents.yaml"
+        with resource_file.open('wt', encoding='utf8') as resource_yaml:
+            yaml.dump(contents, resource_yaml)
+        self._backend._resources_map[resource_name] = resource_file
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return rel_id
+        relation = self._model.get_relation(relation_name, rel_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+        return rel_id
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event and a `relation_changed` event.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        return self._resources_map[resource_name]
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..15e5478555ee0fa948bfb0ad57cc79ba7cef3721
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/ops/version.py
@@ -0,0 +1,50 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from pathlib import Path
+
+__all__ = ('version',)
+
+_FALLBACK = '0.8'  # this gets bumped after release
+
+
+def _get_version():
+    version = _FALLBACK + ".dev0+unknown"
+
+    p = Path(__file__).parent
+    if (p.parent / '.git').exists():
+        try:
+            proc = subprocess.run(
+                ['git', 'describe', '--tags', '--dirty'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.DEVNULL,
+                cwd=p,
+                check=True)
+        except Exception:
+            pass
+        else:
+            version = proc.stdout.strip().decode('utf8')
+            if '-' in version:
+                # version will look like <tag>-<#commits>-g<hex>[-dirty]
+                # in terms of PEP 440, the tag we'll make sure is a 'public version identifier';
+                # everything after the first - needs to be a 'local version'
+                public, local = version.split('-', 1)
+                version = public + '+' + local.replace('-', '.')
+                # version now <tag>+<#commits>.g<hex>[.dirty]
+                # which is PEP440-compliant (as long as <tag> is :-)
+    return version
+
+
+version = _get_version()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements-dev.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements-dev.txt
new file mode 100644
index 0000000000000000000000000000000000000000..61bd425a6748e8b316bf81948e809b1eba148f16
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements-dev.txt
@@ -0,0 +1,5 @@
+-r requirements.txt
+
+autopep8
+flake8
+logassert
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..5500f007d0bf6c6098afc0f2c6d00915e345a569
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/requirements.txt
@@ -0,0 +1 @@
+PyYAML
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/run_tests b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/run_tests
new file mode 100755
index 0000000000000000000000000000000000000000..56411030fdcd8629ffbfbbebb8a8a0650203a934
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/run_tests
@@ -0,0 +1,3 @@
+#!/bin/bash
+
+python3 -m unittest "$@"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/setup.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/setup.py
new file mode 100644
index 0000000000000000000000000000000000000000..ceb866815ae1227338a1e2dc67a217a338ae7bbc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/setup.py
@@ -0,0 +1,75 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from importlib.util import spec_from_file_location, module_from_spec
+from pathlib import Path
+from setuptools import setup, find_packages
+
+
+def _read_me() -> str:
+    with open("README.md", "rt", encoding="utf8") as fh:
+        readme = fh.read()
+    return readme
+
+
+def _get_version() -> str:
+    """Get the version via ops/version.py, without loading ops/__init__.py"""
+    spec = spec_from_file_location('ops.version', 'ops/version.py')
+    module = module_from_spec(spec)
+    spec.loader.exec_module(module)
+
+    return module.version
+
+
+version = _get_version()
+version_path = Path("ops/version.py")
+version_backup = Path("ops/version.py~")
+version_path.rename(version_backup)
+try:
+    with version_path.open("wt", encoding="utf8") as fh:
+        fh.write('''\
+# this is a generated file
+
+version = {!r}
+'''.format(version))
+
+    setup(
+        name="ops",
+        version=version,
+        description="The Python library behind great charms",
+        long_description=_read_me(),
+        long_description_content_type="text/markdown",
+        license="Apache-2.0",
+        url="https://github.com/canonical/operator",
+        author="The Charmcraft team at Canonical Ltd.",
+        author_email="charmcraft@lists.launchpad.net",
+        packages=find_packages(include=('ops', 'ops.*')),
+        classifiers=[
+            "Programming Language :: Python :: 3",
+            "License :: OSI Approved :: Apache Software License",
+            "Development Status :: 4 - Beta",
+
+            "Intended Audience :: Developers",
+            "Intended Audience :: System Administrators",
+            "Operating System :: MacOS :: MacOS X",
+            "Operating System :: POSIX :: Linux",
+            # include Windows once we're running tests there also
+            # "Operating System :: Microsoft :: Windows",
+        ],
+        python_requires='>=3.5',
+        install_requires=["PyYAML"],
+    )
+
+finally:
+    version_backup.rename(version_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-ids b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-ids
new file mode 100755
index 0000000000000000000000000000000000000000..a7e0ead2d3182713bd826696fc403b5a8c54faa6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-ids
@@ -0,0 +1,11 @@
+#!/bin/bash
+
+case $1 in
+    db) echo '["db:1"]' ;;
+    mon) echo '["mon:2"]' ;;
+    ha) echo '[]' ;;
+    db0) echo '[]' ;;
+    db1) echo '["db1:4"]' ;;
+    db2) echo '["db2:5", "db2:6"]' ;;
+    *) echo '[]' ;;
+esac
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-list b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-list
new file mode 100755
index 0000000000000000000000000000000000000000..88490159775624108766a17a35a77599ddea8f03
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/bin/relation-list
@@ -0,0 +1,16 @@
+#!/bin/bash
+
+fail_not_found() {
+    1>&2 echo "ERROR invalid value \"$1\" for option -r: relation not found"
+    exit 2
+}
+
+case $2 in
+    1) echo '["remote/0"]' ;;
+    2) echo '["remote/0"]' ;;
+    3) fail_not_found $2 ;;
+    4) echo '["remoteapp1/0"]' ;;
+    5) echo '["remoteapp1/0"]' ;;
+    6) echo '["remoteapp2/0"]' ;;
+    *) fail_not_found $2 ;;
+esac
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/actions.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d16c94204f2cc0064965553e9b911d3d6075ba17
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/actions.yaml
@@ -0,0 +1,29 @@
+foo-bar:
+  description: Foos the bar.
+  title: foo-bar
+  params:
+    foo-name:
+      type: string
+      description: A foo name to bar.
+    silent:
+      type: boolean
+      description: ""
+      default: false
+  required:
+    - foo-name
+start:
+  description: Start the unit.
+get-model-name:
+  description: Return the name of the model
+get-status:
+  description: Return the Status of the unit
+log-critical:
+  description: log a message at Critical level
+log-error:
+  description: log a message at Error level
+log-warning:
+  description: log a message at Warning level
+log-info:
+  description: log a message at Info level
+log-debug:
+  description: log a message at Debug level
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/config.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ffc0186002391ca52273d39bebcc9c4261c47535
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/config.yaml
@@ -0,0 +1 @@
+"options": {}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/__init__.py
new file mode 100755
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..d898de859fc444814bc19a7f8f0caaaec6f7e5f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/charm.py
@@ -0,0 +1,575 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """A base class for events that trigger because of a Juju hook firing."""
+
+
+class ActionEvent(EventBase):
+    """A base class for events that trigger when a user asks for an Action to be run.
+
+    To read the parameters for the action, see the instance variable `params`.
+    To respond with the result of the action, call `set_results`. To add progress
+    messages that are visible as the action is progressing use `log`.
+
+    :ivar params: The parameters passed to the action (read by action-get)
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the user is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by Charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Represents the `install` hook from Juju."""
+
+
+class StartEvent(HookEvent):
+    """Represents the `start` hook from Juju."""
+
+
+class StopEvent(HookEvent):
+    """Represents the `stop` hook from Juju."""
+
+
+class RemoveEvent(HookEvent):
+    """Represents the `remove` hook from Juju. """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Represents the `config-changed` hook from Juju."""
+
+
+class UpdateStatusEvent(HookEvent):
+    """Represents the `update-status` hook from Juju."""
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Represents the `upgrade-charm` hook from Juju.
+
+    This will be triggered when a user has run `juju upgrade-charm`. It is run after Juju
+    has unpacked the upgraded charm code, and so this event will be handled with new code.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Represents the `pre-series-upgrade` hook from Juju.
+
+    This happens when a user has run `juju upgrade-series MACHINE prepare` and
+    will fire for each unit that is running on the machine, telling them that
+    the user is preparing to upgrade the Machine's series (eg trusty->bionic).
+    The charm should take actions to prepare for the upgrade (a database charm
+    would want to write out a version-independent dump of the database, so that
+    when a new version of the database is available in a new series, it can be
+    used.)
+    Once all units on a machine have run `pre-series-upgrade`, the user will
+    initiate the steps to actually upgrade the machine (eg `do-release-upgrade`).
+    When the upgrade has been completed, the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Represents the `post-series-upgrade` hook from Juju.
+
+    This is run after the user has done a distribution upgrade (or rolled back
+    and kept the same series). It is called in response to
+    `juju upgrade-series MACHINE complete`. Charms are expected to do whatever
+    steps are necessary to reconfigure their applications for the new series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Represents the `leader-elected` hook from Juju.
+
+    Juju will trigger this when a new lead unit is chosen for a given application.
+    This represents the leader of the charm information (not necessarily the primary
+    of a running application). The main utility is that charm authors can know
+    that only one unit will be a leader at any given time, so they can do
+    configuration, etc, that would otherwise require coordination between units.
+    (eg, selecting a password for a new relation)
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Represents the `leader-settings-changed` hook from Juju.
+
+    Deprecated. This represents when a lead unit would call `leader-set` to inform
+    the other units of an application that they have new information to handle.
+    This has been deprecated in favor of using a Peer relation, and having the
+    leader set a value in the Application data bag for that peer relation.
+    (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Represents the `collect-metrics` hook from Juju.
+
+    Note that events firing during a CollectMetricsEvent are currently
+    sandboxed in how they can interact with Juju. To report metrics
+    use :meth:`.add_metrics`.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Charmers should not be creating RelationEvents directly. The events will be
+    generated by the framework from Juju related events. Users can observe them
+    from the various `CharmBase.on[relation_name].relation_*` events.
+
+    Attributes:
+        relation: The Relation involved in this event
+        app: The remote application that has triggered this event
+        unit: The remote unit that has triggered this event. This may be None
+              if the relation event was triggered as an Application level event
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by Charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by Charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Represents the `relation-created` hook from Juju.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Represents the `relation-joined` hook from Juju.
+
+    This is triggered whenever a new unit of a related application joins the relation.
+    (eg, a unit was added to an existing related app, or a new relation was established
+    with an application that already had units.)
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Represents the `relation-changed` hook from Juju.
+
+    This is triggered whenever there is a change to the data bucket for a related
+    application or unit. Look at `event.relation.data[event.unit/app]` to see the
+    new information.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Represents the `relation-departed` hook from Juju.
+
+    This is the inverse of the RelationJoinedEvent, representing when a unit
+    is leaving the relation (the unit is being removed, the app is being removed,
+    the relation is being removed). It is fired once for each unit that is
+    going away.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Represents the `relation-broken` hook from Juju.
+
+    If a relation is being removed (`juju remove-relation` or `juju remove-application`),
+    once all the units have been removed, RelationBrokenEvent will fire to signal
+    that the relationship has been fully terminated.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing Storage related events."""
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Represents the `storage-attached` hook from Juju.
+
+    Called when new storage is available for the charm to use.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Represents the `storage-detaching` hook from Juju.
+
+    Called when storage a charm has been using is going away.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """The events that are generated by Juju in response to the lifecycle of an application."""
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the Charm overall.
+
+    Usually this initialization is done by ops.main.main() rather than Charm authors
+    directly instantiating a Charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            Charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+    """
+
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """CharmMeta of this charm.
+        """
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the Charm as it is running.
+        """
+        return self.framework.charm_dir
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from metadata.yaml and/or actions.yaml. Generally charms will
+    define this information, rather than reading it at runtime. This class is
+    mostly for the framework to understand what the charm has defined.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by Charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/framework.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..b7c4749ff2b5bfb4f354bf1a8d4cd6ed64cf0da5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/framework.py
@@ -0,0 +1,1067 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(ObjectEvents):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+        # breakpoint(); if Python < 3.7, this doesn't affect anything
+        sys.breakpointhook = self.breakpoint
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse once the env var, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/jujuversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..b2b8177dbe396f0d8c46b86e26af6b4e54ea046d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/jujuversion.py
@@ -0,0 +1,98 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if not v:
+            raise RuntimeError('environ has no JUJU_VERSION')
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..edb9fcacea6f0173aed9f07ca8a683cfead989cc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/lib/__init__.py
@@ -0,0 +1,194 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import os
+import re
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except OSError:
+            continue
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except OSError:
+                continue
+            finder = get_importer(opslib)
+            if finder is None or not hasattr(finder, 'find_spec'):
+                continue
+            for lib_dir in lib_dirs:
+                spec = finder.find_spec(lib_dir)
+                if spec is None:
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    continue
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        return None
+
+    _expected = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_expected):
+                    break
+                if n > _MAX_LIB_LINES:
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _expected:
+                    value = literal_eval(value)
+                    if not isinstance(value, _expected[key]):
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_expected):
+                    return None
+    except Exception:
+        return None
+
+    return _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {0.name} by {0.author}, API {0.api}, patch {0.patch}>".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/log.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..4aac5543aec4d84dc393e79b772a30284712d6d4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/log.py
@@ -0,0 +1,51 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..6dc31c3575044796e8fe1f61b8415395689d6339
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/main.py
@@ -0,0 +1,348 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import logging
+import os
+import subprocess
+import sys
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows.
+        # For Windows it is always an absolute path (any symlinks are resolved)
+        # while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(sys.argv[0])
+
+        if 'JUJU_DISPATCH_PATH' in os.environ and (charm_dir / 'dispatch').exists():
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk"""
+
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = self._charm_dir / self._dispatch_path
+        if not dispatch_path.exists():
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == self._exec_path.resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning(
+                "Legacy %s exited with status %d.",
+                self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """"Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def main(charm_class, use_juju_for_storage=False):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..b96e89154ea9cec2b62a4fab4649412e115c304e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/model.py
@@ -0,0 +1,1237 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+
+    Attributes:
+        unit: A :class:`Unit` that represents the unit that is running this code (eg yourself)
+        app: A :class:`Application` that represents the application this unit is a part of.
+        relations: Mapping of endpoint to list of :class:`Relation` answering the question
+            "what am I currently related to". See also :meth:`.get_relation`
+        config: A dict of the config for the current application.
+        resources: Access to resources for this charm. Use ``model.resources.fetch(resource_name)``
+            to get the path on disk where the resource can be found.
+        storages: Mapping of storage_name to :class:`Storage` for the storage points defined in
+            metadata.yaml
+        pod: Used to get access to ``model.pod.set_spec`` to set the container specification
+            for Kubernetes charms.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(self._backend.unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworKInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info['bind-addresses']:
+            interface_name = interface_info['interface-name']
+            for address_info in interface_info['addresses']:
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info['ingress-addresses']:
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info['egress-subnets']:
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        return self.interfaces[0].address
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        return self.ingress_addresses[0]
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        self.address = ipaddress.ip_address(address_info['value'])
+        cidr = address_info['cidr']
+        if not cidr:
+            # The cidr field may be empty, see LP: #1864102.
+            # In this case, make it a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address_info['value'])
+        else:
+            self.subnet = ipaddress.ip_network(cidr)
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """"Represents a storage as defined in metadata.yaml
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            app: A boolean indicating whether the status should be set for a unit or an
+                application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/storage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/storage.py
new file mode 100755
index 0000000000000000000000000000000000000000..d4310ce1cfbb707c6278b70f84a9751da3ce07af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/storage.py
@@ -0,0 +1,318 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)"""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: typing.Optional[str]) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """"Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        return
+
+    def commit(self):
+        return
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str):
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    @staticmethod
+    def is_available() -> bool:
+        """Check if Juju state storage is available.
+
+        This checks if there is a 'state-get' executable in PATH.
+        """
+        p = shutil.which('state-get')
+        return p is not None
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf-8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        subprocess.run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = subprocess.run(
+            ["state-get", key],
+            stdout=subprocess.PIPE,
+            check=True,
+        )
+        if p.stdout == b'' or p.stdout == b'\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        subprocess.run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/testing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/testing.py
new file mode 100755
index 0000000000000000000000000000000000000000..b4b3fe071216238007c9f3847ca9556be626bf6b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/testing.py
@@ -0,0 +1,586 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pathlib
+from textwrap import dedent
+import tempfile
+import typing
+import yaml
+import weakref
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None):
+        # TODO: jam 2020-03-05 We probably want to take config as a parameter as well, since
+        #       it would define the default values of config that the charm would see.
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._lazy_resource_dir = None
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    @property
+    def _resource_dir(self) -> pathlib.Path:
+        if self._lazy_resource_dir is not None:
+            return self._lazy_resource_dir
+
+        self.__resource_dir = tempfile.TemporaryDirectory()
+        self._lazy_resource_dir = pathlib.Path(self.__resource_dir.name)
+        self._finalizer = weakref.finalize(self, self.__resource_dir.cleanup)
+        return self._lazy_resource_dir
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling begin(), there is no Charm instance, so changes to the Model won't emit
+        events. You must call begin before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+        resource_dir = self._resource_dir / resource_name
+        resource_dir.mkdir(exist_ok=True)
+        resource_file = resource_dir / "contents.yaml"
+        with resource_file.open('wt', encoding='utf8') as resource_yaml:
+            yaml.dump(contents, resource_yaml)
+        self._backend._resources_map[resource_name] = resource_file
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return rel_id
+        relation = self._model.get_relation(relation_name, rel_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+        return rel_id
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event and a `relation_changed` event.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        return self._resources_map[resource_name]
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..15e5478555ee0fa948bfb0ad57cc79ba7cef3721
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/lib/ops/version.py
@@ -0,0 +1,50 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import subprocess
+from pathlib import Path
+
+__all__ = ('version',)
+
+_FALLBACK = '0.8'  # this gets bumped after release
+
+
+def _get_version():
+    version = _FALLBACK + ".dev0+unknown"
+
+    p = Path(__file__).parent
+    if (p.parent / '.git').exists():
+        try:
+            proc = subprocess.run(
+                ['git', 'describe', '--tags', '--dirty'],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.DEVNULL,
+                cwd=p,
+                check=True)
+        except Exception:
+            pass
+        else:
+            version = proc.stdout.strip().decode('utf8')
+            if '-' in version:
+                # version will look like <tag>-<#commits>-g<hex>[-dirty]
+                # in terms of PEP 440, the tag we'll make sure is a 'public version identifier';
+                # everything after the first - needs to be a 'local version'
+                public, local = version.split('-', 1)
+                version = public + '+' + local.replace('-', '.')
+                # version now <tag>+<#commits>.g<hex>[.dirty]
+                # which is PEP440-compliant (as long as <tag> is :-)
+    return version
+
+
+version = _get_version()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/metadata.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3b3aed87e96121224c63916b04009daf40fcab35
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/metadata.yaml
@@ -0,0 +1,26 @@
+name: main
+summary: A charm used for testing the basic operation of the entrypoint code.
+maintainer: Dmitrii Shcherbakov <dmitrii.shcherbakov@canonical.com>
+description: A charm used for testing the basic operation of the entrypoint code.
+tags:
+    - misc
+series:
+    - bionic
+    - cosmic
+    - disco
+min-juju-version: 2.7.1
+provides:
+    db:
+        interface: db
+requires:
+    mon:
+        interface: monitoring
+peers:
+    ha:
+        interface: cluster
+subordinate: false
+storage:
+    disks:
+        type: block
+        multiple:
+            range: 0-
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/src/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..154b2376b6ce466a94c0d6745b8b48e48dea00dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/charms/test_main/src/charm.py
@@ -0,0 +1,223 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import base64
+import pickle
+import sys
+import logging
+
+sys.path.append('lib')
+
+from ops.charm import CharmBase  # noqa: E402 (module-level import after non-import code)
+from ops.main import main        # noqa: E402 (ditto)
+
+logger = logging.getLogger()
+
+
+class Charm(CharmBase):
+
+    def __init__(self, *args):
+        super().__init__(*args)
+
+        # This environment variable controls the test charm behavior.
+        charm_config = os.environ.get('CHARM_CONFIG')
+        if charm_config is not None:
+            self._charm_config = pickle.loads(base64.b64decode(charm_config))
+        else:
+            self._charm_config = {}
+
+        # TODO: refactor to use StoredState
+        # (this implies refactoring most of test_main.py)
+        self._state_file = self._charm_config.get('STATE_FILE')
+        try:
+            with open(str(self._state_file), 'rb') as f:
+                self._state = pickle.load(f)
+        except (FileNotFoundError, EOFError):
+            self._state = {
+                'on_install': [],
+                'on_start': [],
+                'on_config_changed': [],
+                'on_update_status': [],
+                'on_leader_settings_changed': [],
+                'on_db_relation_joined': [],
+                'on_mon_relation_changed': [],
+                'on_mon_relation_departed': [],
+                'on_ha_relation_broken': [],
+                'on_foo_bar_action': [],
+                'on_start_action': [],
+                '_on_get_model_name_action': [],
+                'on_collect_metrics': [],
+
+                'on_log_critical_action': [],
+                'on_log_error_action': [],
+                'on_log_warning_action': [],
+                'on_log_info_action': [],
+                'on_log_debug_action': [],
+
+                # Observed event types per invocation. A list is used to preserve the
+                # order in which charm handlers have observed the events.
+                'observed_event_types': [],
+            }
+
+        self.framework.observe(self.on.install, self._on_install)
+        self.framework.observe(self.on.start, self._on_start)
+        self.framework.observe(self.on.config_changed, self._on_config_changed)
+        self.framework.observe(self.on.update_status, self._on_update_status)
+        self.framework.observe(self.on.leader_settings_changed, self._on_leader_settings_changed)
+        # Test relation events with endpoints from different
+        # sections (provides, requires, peers) as well.
+        self.framework.observe(self.on.db_relation_joined, self._on_db_relation_joined)
+        self.framework.observe(self.on.mon_relation_changed, self._on_mon_relation_changed)
+        self.framework.observe(self.on.mon_relation_departed, self._on_mon_relation_departed)
+        self.framework.observe(self.on.ha_relation_broken, self._on_ha_relation_broken)
+
+        if self._charm_config.get('USE_ACTIONS'):
+            self.framework.observe(self.on.start_action, self._on_start_action)
+            self.framework.observe(self.on.foo_bar_action, self._on_foo_bar_action)
+            self.framework.observe(self.on.get_model_name_action, self._on_get_model_name_action)
+            self.framework.observe(self.on.get_status_action, self._on_get_status_action)
+
+        self.framework.observe(self.on.collect_metrics, self._on_collect_metrics)
+
+        if self._charm_config.get('USE_LOG_ACTIONS'):
+            self.framework.observe(self.on.log_critical_action, self._on_log_critical_action)
+            self.framework.observe(self.on.log_error_action, self._on_log_error_action)
+            self.framework.observe(self.on.log_warning_action, self._on_log_warning_action)
+            self.framework.observe(self.on.log_info_action, self._on_log_info_action)
+            self.framework.observe(self.on.log_debug_action, self._on_log_debug_action)
+
+        if self._charm_config.get('TRY_EXCEPTHOOK'):
+            raise RuntimeError("failing as requested")
+
+    def _write_state(self):
+        """Write state variables so that the parent process can read them.
+
+        Each invocation will override the previous state which is intentional.
+        """
+        if self._state_file is not None:
+            with self._state_file.open('wb') as f:
+                pickle.dump(self._state, f)
+
+    def _on_install(self, event):
+        self._state['on_install'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_start(self, event):
+        self._state['on_start'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_config_changed(self, event):
+        self._state['on_config_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        event.defer()
+        self._write_state()
+
+    def _on_update_status(self, event):
+        self._state['on_update_status'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_leader_settings_changed(self, event):
+        self._state['on_leader_settings_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_db_relation_joined(self, event):
+        assert event.app is not None, 'application name cannot be None for a relation-joined event'
+        self._state['on_db_relation_joined'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['db_relation_joined_data'] = event.snapshot()
+        self._write_state()
+
+    def _on_mon_relation_changed(self, event):
+        assert event.app is not None, (
+            'application name cannot be None for a relation-changed event')
+        if os.environ.get('JUJU_REMOTE_UNIT'):
+            assert event.unit is not None, (
+                'a unit name cannot be None for a relation-changed event'
+                ' associated with a remote unit')
+        self._state['on_mon_relation_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['mon_relation_changed_data'] = event.snapshot()
+        self._write_state()
+
+    def _on_mon_relation_departed(self, event):
+        assert event.app is not None, (
+            'application name cannot be None for a relation-departed event')
+        self._state['on_mon_relation_departed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['mon_relation_departed_data'] = event.snapshot()
+        self._write_state()
+
+    def _on_ha_relation_broken(self, event):
+        assert event.app is None, (
+            'relation-broken events cannot have a reference to a remote application')
+        assert event.unit is None, (
+            'relation broken events cannot have a reference to a remote unit')
+        self._state['on_ha_relation_broken'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['ha_relation_broken_data'] = event.snapshot()
+        self._write_state()
+
+    def _on_start_action(self, event):
+        assert event.handle.kind == 'start_action', (
+            'event action name cannot be different from the one being handled')
+        self._state['on_start_action'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_foo_bar_action(self, event):
+        assert event.handle.kind == 'foo_bar_action', (
+            'event action name cannot be different from the one being handled')
+        self._state['on_foo_bar_action'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def _on_get_status_action(self, event):
+        self._state['status_name'] = self.unit.status.name
+        self._state['status_message'] = self.unit.status.message
+        self._write_state()
+
+    def _on_collect_metrics(self, event):
+        self._state['on_collect_metrics'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        event.add_metrics({'foo': 42}, {'bar': 4.2})
+        self._write_state()
+
+    def _on_log_critical_action(self, event):
+        logger.critical('super critical')
+
+    def _on_log_error_action(self, event):
+        logger.error('grave error')
+
+    def _on_log_warning_action(self, event):
+        logger.warning('wise warning')
+
+    def _on_log_info_action(self, event):
+        logger.info('useful info')
+
+    def _on_log_debug_action(self, event):
+        logger.debug('insightful debug')
+
+    def _on_get_model_name_action(self, event):
+        self._state['_on_get_model_name_action'].append(self.model.name)
+        self._write_state()
+
+
+if __name__ == '__main__':
+    main(Charm)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..f698aec3b71a837134ecd6d2d83164763e9a1957
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_charm.py
@@ -0,0 +1,322 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import unittest
+import tempfile
+import shutil
+
+from pathlib import Path
+
+from ops.charm import (
+    CharmBase,
+    CharmMeta,
+    CharmEvents,
+)
+from ops.framework import Framework, EventSource, EventBase
+from ops.model import Model, _ModelBackend
+from ops.storage import SQLiteStorage
+
+from .test_helpers import fake_script, fake_script_calls
+
+
+class TestCharm(unittest.TestCase):
+
+    def setUp(self):
+        def restore_env(env):
+            os.environ.clear()
+            os.environ.update(env)
+        self.addCleanup(restore_env, os.environ.copy())
+
+        os.environ['PATH'] = "{}:{}".format(Path(__file__).parent / 'bin', os.environ['PATH'])
+        os.environ['JUJU_UNIT_NAME'] = 'local/0'
+
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, str(self.tmpdir))
+        self.meta = CharmMeta()
+
+        class CustomEvent(EventBase):
+            pass
+
+        class TestCharmEvents(CharmEvents):
+            custom = EventSource(CustomEvent)
+
+        # Relations events are defined dynamically and modify the class attributes.
+        # We use a subclass temporarily to prevent these side effects from leaking.
+        CharmBase.on = TestCharmEvents()
+
+        def cleanup():
+            CharmBase.on = CharmEvents()
+        self.addCleanup(cleanup)
+
+    def create_framework(self):
+        model = Model(self.meta, _ModelBackend('local/0'))
+        framework = Framework(SQLiteStorage(':memory:'), self.tmpdir, self.meta, model)
+        self.addCleanup(framework.close)
+        return framework
+
+    def test_basic(self):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+
+                self.started = False
+                framework.observe(self.on.start, self._on_start)
+
+            def _on_start(self, event):
+                self.started = True
+
+        events = list(MyCharm.on.events())
+        self.assertIn('install', events)
+        self.assertIn('custom', events)
+
+        framework = self.create_framework()
+        charm = MyCharm(framework)
+        charm.on.start.emit()
+
+        self.assertEqual(charm.started, True)
+
+        with self.assertRaisesRegex(TypeError, "observer methods must now be explicitly provided"):
+            framework.observe(charm.on.start, charm)
+
+    def test_helper_properties(self):
+        framework = self.create_framework()
+
+        class MyCharm(CharmBase):
+            pass
+
+        charm = MyCharm(framework)
+        self.assertEqual(charm.app, framework.model.app)
+        self.assertEqual(charm.unit, framework.model.unit)
+        self.assertEqual(charm.meta, framework.meta)
+        self.assertEqual(charm.charm_dir, framework.charm_dir)
+
+    def test_relation_events(self):
+
+        class MyCharm(CharmBase):
+            def __init__(self, *args):
+                super().__init__(*args)
+                self.seen = []
+                for rel in ('req1', 'req-2', 'pro1', 'pro-2', 'peer1', 'peer-2'):
+                    # Hook up relation events to generic handler.
+                    self.framework.observe(self.on[rel].relation_joined, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_changed, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_departed, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_broken, self.on_any_relation)
+
+            def on_any_relation(self, event):
+                assert event.relation.name == 'req1'
+                assert event.relation.app.name == 'remote'
+                self.seen.append(type(event).__name__)
+
+        # language=YAML
+        self.meta = CharmMeta.from_yaml(metadata='''
+name: my-charm
+requires:
+ req1:
+   interface: req1
+ req-2:
+   interface: req2
+provides:
+ pro1:
+   interface: pro1
+ pro-2:
+   interface: pro2
+peers:
+ peer1:
+   interface: peer1
+ peer-2:
+   interface: peer2
+''')
+
+        charm = MyCharm(self.create_framework())
+
+        rel = charm.framework.model.get_relation('req1', 1)
+        unit = charm.framework.model.get_unit('remote/0')
+        charm.on['req1'].relation_joined.emit(rel, unit)
+        charm.on['req1'].relation_changed.emit(rel, unit)
+        charm.on['req-2'].relation_changed.emit(rel, unit)
+        charm.on['pro1'].relation_departed.emit(rel, unit)
+        charm.on['pro-2'].relation_departed.emit(rel, unit)
+        charm.on['peer1'].relation_broken.emit(rel)
+        charm.on['peer-2'].relation_broken.emit(rel)
+
+        self.assertEqual(charm.seen, [
+            'RelationJoinedEvent',
+            'RelationChangedEvent',
+            'RelationChangedEvent',
+            'RelationDepartedEvent',
+            'RelationDepartedEvent',
+            'RelationBrokenEvent',
+            'RelationBrokenEvent',
+        ])
+
+    def test_storage_events(self):
+
+        class MyCharm(CharmBase):
+            def __init__(self, *args):
+                super().__init__(*args)
+                self.seen = []
+                self.framework.observe(self.on['stor1'].storage_attached, self._on_stor1_attach)
+                self.framework.observe(self.on['stor2'].storage_detaching, self._on_stor2_detach)
+                self.framework.observe(self.on['stor3'].storage_attached, self._on_stor3_attach)
+                self.framework.observe(self.on['stor-4'].storage_attached, self._on_stor4_attach)
+
+            def _on_stor1_attach(self, event):
+                self.seen.append(type(event).__name__)
+
+            def _on_stor2_detach(self, event):
+                self.seen.append(type(event).__name__)
+
+            def _on_stor3_attach(self, event):
+                self.seen.append(type(event).__name__)
+
+            def _on_stor4_attach(self, event):
+                self.seen.append(type(event).__name__)
+
+        # language=YAML
+        self.meta = CharmMeta.from_yaml('''
+name: my-charm
+storage:
+  stor-4:
+    multiple:
+      range: 2-4
+    type: filesystem
+  stor1:
+    type: filesystem
+  stor2:
+    multiple:
+      range: "2"
+    type: filesystem
+  stor3:
+    multiple:
+      range: 2-
+    type: filesystem
+''')
+
+        self.assertIsNone(self.meta.storages['stor1'].multiple_range)
+        self.assertEqual(self.meta.storages['stor2'].multiple_range, (2, 2))
+        self.assertEqual(self.meta.storages['stor3'].multiple_range, (2, None))
+        self.assertEqual(self.meta.storages['stor-4'].multiple_range, (2, 4))
+
+        charm = MyCharm(self.create_framework())
+
+        charm.on['stor1'].storage_attached.emit()
+        charm.on['stor2'].storage_detaching.emit()
+        charm.on['stor3'].storage_attached.emit()
+        charm.on['stor-4'].storage_attached.emit()
+
+        self.assertEqual(charm.seen, [
+            'StorageAttachedEvent',
+            'StorageDetachingEvent',
+            'StorageAttachedEvent',
+            'StorageAttachedEvent',
+        ])
+
+    @classmethod
+    def _get_action_test_meta(cls):
+        # language=YAML
+        return CharmMeta.from_yaml(metadata='''
+name: my-charm
+''', actions='''
+foo-bar:
+  description: "Foos the bar."
+  params:
+    foo-name:
+      description: "A foo name to bar"
+      type: string
+    silent:
+      default: false
+      description: ""
+      type: boolean
+  required: foo-bar
+  title: foo-bar
+start:
+  description: "Start the unit."
+''')
+
+    def _test_action_events(self, cmd_type):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+                framework.observe(self.on.foo_bar_action, self._on_foo_bar_action)
+                framework.observe(self.on.start_action, self._on_start_action)
+
+            def _on_foo_bar_action(self, event):
+                self.seen_action_params = event.params
+                event.log('test-log')
+                event.set_results({'res': 'val with spaces'})
+                event.fail('test-fail')
+
+            def _on_start_action(self, event):
+                pass
+
+        fake_script(self, cmd_type + '-get', """echo '{"foo-name": "name", "silent": true}'""")
+        fake_script(self, cmd_type + '-set', "")
+        fake_script(self, cmd_type + '-log', "")
+        fake_script(self, cmd_type + '-fail', "")
+        self.meta = self._get_action_test_meta()
+
+        os.environ['JUJU_{}_NAME'.format(cmd_type.upper())] = 'foo-bar'
+        framework = self.create_framework()
+        charm = MyCharm(framework)
+
+        events = list(MyCharm.on.events())
+        self.assertIn('foo_bar_action', events)
+        self.assertIn('start_action', events)
+
+        charm.on.foo_bar_action.emit()
+        self.assertEqual(charm.seen_action_params, {"foo-name": "name", "silent": True})
+        self.assertEqual(fake_script_calls(self), [
+            [cmd_type + '-get', '--format=json'],
+            [cmd_type + '-log', "test-log"],
+            [cmd_type + '-set', "res=val with spaces"],
+            [cmd_type + '-fail', "test-fail"],
+        ])
+
+        # Make sure that action events that do not match the current context are
+        # not possible to emit by hand.
+        with self.assertRaises(RuntimeError):
+            charm.on.start_action.emit()
+
+    def test_action_events(self):
+        self._test_action_events('action')
+
+    def _test_action_event_defer_fails(self, cmd_type):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+                framework.observe(self.on.start_action, self._on_start_action)
+
+            def _on_start_action(self, event):
+                event.defer()
+
+        fake_script(self, cmd_type + '-get', """echo '{"foo-name": "name", "silent": true}'""")
+        self.meta = self._get_action_test_meta()
+
+        os.environ['JUJU_{}_NAME'.format(cmd_type.upper())] = 'start'
+        framework = self.create_framework()
+        charm = MyCharm(framework)
+
+        with self.assertRaises(RuntimeError):
+            charm.on.start_action.emit()
+
+    def test_action_event_defer_fails(self):
+        self._test_action_event_defer_fails('action')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_framework.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..2c4a7bf0de34396572d73918518f9617b4f7dc55
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_framework.py
@@ -0,0 +1,1798 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import datetime
+import gc
+import inspect
+import io
+import os
+import re
+import shutil
+import sys
+import tempfile
+from unittest.mock import patch
+from pathlib import Path
+
+import logassert
+
+from ops import charm
+from ops.framework import (
+    _BREAKPOINT_WELCOME_MESSAGE,
+    BoundStoredState,
+    CommitEvent,
+    EventBase,
+    _event_regex,
+    ObjectEvents,
+    EventSource,
+    Framework,
+    Handle,
+    Object,
+    PreCommitEvent,
+    StoredList,
+    StoredState,
+    StoredStateData,
+)
+from ops.storage import NoSnapshotError, SQLiteStorage
+from test.test_helpers import fake_script, BaseTestCase
+
+
+class TestFramework(BaseTestCase):
+
+    def setUp(self):
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, str(self.tmpdir))
+
+        patcher = patch('ops.storage.SQLiteStorage.DB_LOCK_TIMEOUT', datetime.timedelta(0))
+        patcher.start()
+        self.addCleanup(patcher.stop)
+        logassert.setup(self, 'ops')
+
+    def test_deprecated_init(self):
+        # For 0.7, this still works, but it is deprecated.
+        framework = Framework(':memory:', None, None, None)
+        self.assertLoggedWarning(
+            "deprecated: Framework now takes a Storage not a path")
+        self.assertIsInstance(framework._storage, SQLiteStorage)
+
+    def test_handle_path(self):
+        cases = [
+            (Handle(None, "root", None), "root"),
+            (Handle(None, "root", "1"), "root[1]"),
+            (Handle(Handle(None, "root", None), "child", None), "root/child"),
+            (Handle(Handle(None, "root", "1"), "child", "2"), "root[1]/child[2]"),
+        ]
+        for handle, path in cases:
+            self.assertEqual(str(handle), path)
+            self.assertEqual(Handle.from_path(path), handle)
+
+    def test_handle_attrs_readonly(self):
+        handle = Handle(None, 'kind', 'key')
+        with self.assertRaises(AttributeError):
+            handle.parent = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.kind = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.key = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.path = 'foo'
+
+    def test_restore_unknown(self):
+        framework = self.create_framework()
+
+        class Foo(Object):
+            pass
+
+        handle = Handle(None, "a_foo", "some_key")
+
+        framework.register_type(Foo, None, handle.kind)
+
+        try:
+            framework.load_snapshot(handle)
+        except NoSnapshotError as e:
+            self.assertEqual(e.handle_path, str(handle))
+            self.assertEqual(str(e), "no snapshot data found for a_foo[some_key] object")
+        else:
+            self.fail("exception NoSnapshotError not raised")
+
+    def test_snapshot_roundtrip(self):
+        class Foo:
+            def __init__(self, handle, n):
+                self.handle = handle
+                self.my_n = n
+
+            def snapshot(self):
+                return {"My N!": self.my_n}
+
+            def restore(self, snapshot):
+                self.my_n = snapshot["My N!"] + 1
+
+        handle = Handle(None, "a_foo", "some_key")
+        event = Foo(handle, 1)
+
+        framework1 = self.create_framework(tmpdir=self.tmpdir)
+        framework1.register_type(Foo, None, handle.kind)
+        framework1.save_snapshot(event)
+        framework1.commit()
+        framework1.close()
+
+        framework2 = self.create_framework(tmpdir=self.tmpdir)
+        framework2.register_type(Foo, None, handle.kind)
+        event2 = framework2.load_snapshot(handle)
+        self.assertEqual(event2.my_n, 2)
+
+        framework2.save_snapshot(event2)
+        del event2
+        gc.collect()
+        event3 = framework2.load_snapshot(handle)
+        self.assertEqual(event3.my_n, 3)
+
+        framework2.drop_snapshot(event.handle)
+        framework2.commit()
+        framework2.close()
+
+        framework3 = self.create_framework(tmpdir=self.tmpdir)
+        framework3.register_type(Foo, None, handle.kind)
+
+        self.assertRaises(NoSnapshotError, framework3.load_snapshot, handle)
+
+    def test_simple_event_observer(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+            baz = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_any(self, event):
+                self.seen.append("on_any:" + event.handle.kind)
+
+            def on_foo(self, event):
+                self.seen.append("on_foo:" + event.handle.kind)
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs.on_any)
+        framework.observe(pub.bar, obs.on_any)
+
+        with self.assertRaisesRegex(RuntimeError, "^Framework.observe requires a method"):
+            framework.observe(pub.baz, obs)
+
+        pub.foo.emit()
+        pub.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_any:foo", "on_any:bar"])
+
+    def test_bad_sig_observer(self):
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+            baz = EventSource(MyEvent)
+            qux = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def _on_foo(self):
+                assert False, 'should not be reached'
+
+            def _on_bar(self, event, extra):
+                assert False, 'should not be reached'
+
+            def _on_baz(self, event, extra=None, *, k):
+                assert False, 'should not be reached'
+
+            def _on_qux(self, event, extra=None):
+                assert False, 'should not be reached'
+
+        framework = self.create_framework()
+        pub = MyNotifier(framework, "pub")
+        obs = MyObserver(framework, "obs")
+
+        with self.assertRaisesRegex(TypeError, "must accept event parameter"):
+            framework.observe(pub.foo, obs._on_foo)
+        with self.assertRaisesRegex(TypeError, "has extra required parameter"):
+            framework.observe(pub.bar, obs._on_bar)
+        with self.assertRaisesRegex(TypeError, "has extra required parameter"):
+            framework.observe(pub.baz, obs._on_baz)
+        framework.observe(pub.qux, obs._on_qux)
+
+    def test_on_pre_commit_emitted(self):
+        framework = self.create_framework(tmpdir=self.tmpdir)
+
+        class PreCommitObserver(Object):
+
+            _stored = StoredState()
+
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+                self._stored.myinitdata = 40
+
+            def on_pre_commit(self, event):
+                self._stored.myinitdata = 41
+                self._stored.mydata = 42
+                self.seen.append(type(event))
+
+            def on_commit(self, event):
+                # Modifications made here will not be persisted.
+                self._stored.myinitdata = 42
+                self._stored.mydata = 43
+                self._stored.myotherdata = 43
+                self.seen.append(type(event))
+
+        obs = PreCommitObserver(framework, None)
+
+        framework.observe(framework.on.pre_commit, obs.on_pre_commit)
+
+        framework.commit()
+
+        self.assertEqual(obs._stored.myinitdata, 41)
+        self.assertEqual(obs._stored.mydata, 42)
+        self.assertTrue(obs.seen, [PreCommitEvent, CommitEvent])
+        framework.close()
+
+        other_framework = self.create_framework(tmpdir=self.tmpdir)
+
+        new_obs = PreCommitObserver(other_framework, None)
+
+        self.assertEqual(obs._stored.myinitdata, 41)
+        self.assertEqual(new_obs._stored.mydata, 42)
+
+        with self.assertRaises(AttributeError):
+            new_obs._stored.myotherdata
+
+    def test_defer_and_reemit(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier1(Object):
+            a = EventSource(MyEvent)
+            b = EventSource(MyEvent)
+
+        class MyNotifier2(Object):
+            c = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+                self.done = {}
+
+            def on_any(self, event):
+                self.seen.append(event.handle.kind)
+                if not self.done.get(event.handle.kind):
+                    event.defer()
+
+        pub1 = MyNotifier1(framework, "1")
+        pub2 = MyNotifier2(framework, "1")
+        obs1 = MyObserver(framework, "1")
+        obs2 = MyObserver(framework, "2")
+
+        framework.observe(pub1.a, obs1.on_any)
+        framework.observe(pub1.b, obs1.on_any)
+        framework.observe(pub1.a, obs2.on_any)
+        framework.observe(pub1.b, obs2.on_any)
+        framework.observe(pub2.c, obs2.on_any)
+
+        pub1.a.emit()
+        pub1.b.emit()
+        pub2.c.emit()
+
+        # Events remain stored because they were deferred.
+        ev_a_handle = Handle(pub1, "a", "1")
+        framework.load_snapshot(ev_a_handle)
+        ev_b_handle = Handle(pub1, "b", "2")
+        framework.load_snapshot(ev_b_handle)
+        ev_c_handle = Handle(pub2, "c", "3")
+        framework.load_snapshot(ev_c_handle)
+        # make sure the objects are gone before we reemit them
+        gc.collect()
+
+        framework.reemit()
+        obs1.done["a"] = True
+        obs2.done["b"] = True
+        framework.reemit()
+        framework.reemit()
+        obs1.done["b"] = True
+        obs2.done["a"] = True
+        framework.reemit()
+        obs2.done["c"] = True
+        framework.reemit()
+        framework.reemit()
+        framework.reemit()
+
+        self.assertEqual(" ".join(obs1.seen), "a b a b a b b b")
+        self.assertEqual(" ".join(obs2.seen), "a b c a b c a b c a c a c c")
+
+        # Now the event objects must all be gone from storage.
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_a_handle)
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_b_handle)
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_c_handle)
+
+    def test_custom_event_data(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            def __init__(self, handle, n):
+                super().__init__(handle)
+                self.my_n = n
+
+            def snapshot(self):
+                return {"My N!": self.my_n}
+
+            def restore(self, snapshot):
+                super().restore(snapshot)
+                self.my_n = snapshot["My N!"] + 1
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append("on_foo:{}={}".format(event.handle.kind, event.my_n))
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs._on_foo)
+
+        pub.foo.emit(1)
+
+        framework.reemit()
+
+        # Two things being checked here:
+        #
+        # 1. There's a restore roundtrip before the event is first observed.
+        #    That means the data is safe before it's ever seen, and the
+        #    roundtrip logic is tested under normal circumstances.
+        #
+        # 2. The renotification restores from the pristine event, not
+        #    from the one modified during the first restore (otherwise
+        #    we'd get a foo=3).
+        #
+        self.assertEqual(obs.seen, ["on_foo:foo=2", "on_foo:foo=2"])
+
+    def test_weak_observer(self):
+        framework = self.create_framework()
+
+        observed_events = []
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyEvents(ObjectEvents):
+            foo = EventSource(MyEvent)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+
+        class MyObserver(Object):
+            def _on_foo(self, event):
+                observed_events.append("foo")
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "2")
+
+        framework.observe(pub.on.foo, obs._on_foo)
+        pub.on.foo.emit()
+        self.assertEqual(observed_events, ["foo"])
+        # Now delete the observer, and note that when we emit the event, it
+        # doesn't update the local slice again
+        del obs
+        gc.collect()
+        pub.on.foo.emit()
+        self.assertEqual(observed_events, ["foo"])
+
+    def test_forget_and_multiple_objects(self):
+        framework = self.create_framework()
+
+        class MyObject(Object):
+            pass
+
+        o1 = MyObject(framework, "path")
+        # Creating a second object at the same path should fail with RuntimeError
+        with self.assertRaises(RuntimeError):
+            o2 = MyObject(framework, "path")
+        # Unless we _forget the object first
+        framework._forget(o1)
+        o2 = MyObject(framework, "path")
+        self.assertEqual(o1.handle.path, o2.handle.path)
+        # Deleting the tracked object should also work
+        del o2
+        gc.collect()
+        o3 = MyObject(framework, "path")
+        self.assertEqual(o1.handle.path, o3.handle.path)
+        framework.close()
+        # Or using a second framework
+        framework_copy = self.create_framework()
+        o_copy = MyObject(framework_copy, "path")
+        self.assertEqual(o1.handle.path, o_copy.handle.path)
+
+    def test_forget_and_multiple_objects_with_load_snapshot(self):
+        framework = self.create_framework(tmpdir=self.tmpdir)
+
+        class MyObject(Object):
+            def __init__(self, parent, name):
+                super().__init__(parent, name)
+                self.value = name
+
+            def snapshot(self):
+                return self.value
+
+            def restore(self, value):
+                self.value = value
+
+        framework.register_type(MyObject, None, MyObject.handle_kind)
+        o1 = MyObject(framework, "path")
+        framework.save_snapshot(o1)
+        framework.commit()
+        o_handle = o1.handle
+        del o1
+        gc.collect()
+        o2 = framework.load_snapshot(o_handle)
+        # Trying to load_snapshot a second object at the same path should fail with RuntimeError
+        with self.assertRaises(RuntimeError):
+            framework.load_snapshot(o_handle)
+        # Unless we _forget the object first
+        framework._forget(o2)
+        o3 = framework.load_snapshot(o_handle)
+        self.assertEqual(o2.value, o3.value)
+        # A loaded object also prevents direct creation of an object
+        with self.assertRaises(RuntimeError):
+            MyObject(framework, "path")
+        framework.close()
+        # But we can create an object, or load a snapshot in a copy of the framework
+        framework_copy1 = self.create_framework(tmpdir=self.tmpdir)
+        o_copy1 = MyObject(framework_copy1, "path")
+        self.assertEqual(o_copy1.value, "path")
+        framework_copy1.close()
+        framework_copy2 = self.create_framework(tmpdir=self.tmpdir)
+        framework_copy2.register_type(MyObject, None, MyObject.handle_kind)
+        o_copy2 = framework_copy2.load_snapshot(o_handle)
+        self.assertEqual(o_copy2.value, "path")
+
+    def test_events_base(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyEvents(ObjectEvents):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append("on_foo:{}".format(event.handle.kind))
+                event.defer()
+
+            def _on_bar(self, event):
+                self.seen.append("on_bar:{}".format(event.handle.kind))
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        # Confirm that temporary persistence of BoundEvents doesn't cause errors,
+        # and that events can be observed.
+        for bound_event, handler in [(pub.on.foo, obs._on_foo), (pub.on.bar, obs._on_bar)]:
+            framework.observe(bound_event, handler)
+
+        # Confirm that events can be emitted and seen.
+        pub.on.foo.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:foo"])
+
+    def test_conflicting_event_attributes(self):
+        class MyEvent(EventBase):
+            pass
+
+        event = EventSource(MyEvent)
+
+        class MyEvents(ObjectEvents):
+            foo = event
+
+        with self.assertRaises(RuntimeError) as cm:
+            class OtherEvents(ObjectEvents):
+                foo = event
+        self.assertEqual(
+            str(cm.exception),
+            "EventSource(MyEvent) reused as MyEvents.foo and OtherEvents.foo")
+
+        with self.assertRaises(RuntimeError) as cm:
+            class MyNotifier(Object):
+                on = MyEvents()
+                bar = event
+        self.assertEqual(
+            str(cm.exception),
+            "EventSource(MyEvent) reused as MyEvents.foo and MyNotifier.bar")
+
+    def test_reemit_ignores_unknown_event_type(self):
+        # The event type may have been gone for good, and nobody cares,
+        # so this shouldn't be an error scenario.
+
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append(event.handle)
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs._on_foo)
+        pub.foo.emit()
+
+        event_handle = obs.seen[0]
+        self.assertEqual(event_handle.kind, "foo")
+
+        framework.commit()
+        framework.close()
+
+        framework_copy = self.create_framework()
+
+        # No errors on missing event types here.
+        framework_copy.reemit()
+
+        # Register the type and check that the event is gone from storage.
+        framework_copy.register_type(MyEvent, event_handle.parent, event_handle.kind)
+        self.assertRaises(NoSnapshotError, framework_copy.load_snapshot, event_handle)
+
+    def test_auto_register_event_types(self):
+        framework = self.create_framework()
+
+        class MyFoo(EventBase):
+            pass
+
+        class MyBar(EventBase):
+            pass
+
+        class MyEvents(ObjectEvents):
+            foo = EventSource(MyFoo)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+            bar = EventSource(MyBar)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append("on_foo:{}:{}".format(type(event).__name__, event.handle.kind))
+                event.defer()
+
+            def _on_bar(self, event):
+                self.seen.append("on_bar:{}:{}".format(type(event).__name__, event.handle.kind))
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        pub.on.foo.emit()
+        pub.bar.emit()
+
+        framework.observe(pub.on.foo, obs._on_foo)
+        framework.observe(pub.bar, obs._on_bar)
+
+        pub.on.foo.emit()
+        pub.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:MyFoo:foo", "on_bar:MyBar:bar"])
+
+    def test_dynamic_event_types(self):
+        framework = self.create_framework()
+
+        class MyEventsA(ObjectEvents):
+            handle_kind = 'on_a'
+
+        class MyEventsB(ObjectEvents):
+            handle_kind = 'on_b'
+
+        class MyNotifier(Object):
+            on_a = MyEventsA()
+            on_b = MyEventsB()
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append("on_foo:{}:{}".format(type(event).__name__, event.handle.kind))
+                event.defer()
+
+            def _on_bar(self, event):
+                self.seen.append("on_bar:{}:{}".format(type(event).__name__, event.handle.kind))
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        class MyFoo(EventBase):
+            pass
+
+        class MyBar(EventBase):
+            pass
+
+        class DeadBeefEvent(EventBase):
+            pass
+
+        class NoneEvent(EventBase):
+            pass
+
+        pub.on_a.define_event("foo", MyFoo)
+        pub.on_b.define_event("bar", MyBar)
+
+        framework.observe(pub.on_a.foo, obs._on_foo)
+        framework.observe(pub.on_b.bar, obs._on_bar)
+
+        pub.on_a.foo.emit()
+        pub.on_b.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:MyFoo:foo", "on_bar:MyBar:bar"])
+
+        # Definitions remained local to the specific type.
+        self.assertRaises(AttributeError, lambda: pub.on_a.bar)
+        self.assertRaises(AttributeError, lambda: pub.on_b.foo)
+
+        # Try to use an event name which is not a valid python identifier.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("dead-beef", DeadBeefEvent)
+
+        # Try to use a python keyword for an event name.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("None", NoneEvent)
+
+        # Try to override an existing attribute.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("foo", MyFoo)
+
+    def test_event_key_roundtrip(self):
+        class MyEvent(EventBase):
+            def __init__(self, handle, value):
+                super().__init__(handle)
+                self.value = value
+
+            def snapshot(self):
+                return self.value
+
+            def restore(self, value):
+                self.value = value
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            has_deferred = False
+
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def _on_foo(self, event):
+                self.seen.append((event.handle.key, event.value))
+                # Only defer the first event and once.
+                if not MyObserver.has_deferred:
+                    event.defer()
+                    MyObserver.has_deferred = True
+
+        framework1 = self.create_framework(tmpdir=self.tmpdir)
+        pub1 = MyNotifier(framework1, "pub")
+        obs1 = MyObserver(framework1, "obs")
+        framework1.observe(pub1.foo, obs1._on_foo)
+        pub1.foo.emit('first')
+        self.assertEqual(obs1.seen, [('1', 'first')])
+
+        framework1.commit()
+        framework1.close()
+        del framework1
+
+        framework2 = self.create_framework(tmpdir=self.tmpdir)
+        pub2 = MyNotifier(framework2, "pub")
+        obs2 = MyObserver(framework2, "obs")
+        framework2.observe(pub2.foo, obs2._on_foo)
+        pub2.foo.emit('second')
+        framework2.reemit()
+
+        # First observer didn't get updated, since framework it was bound to is gone.
+        self.assertEqual(obs1.seen, [('1', 'first')])
+        # Second observer saw the new event plus the reemit of the first event.
+        # (The event key goes up by 2 due to the pre-commit and commit events.)
+        self.assertEqual(obs2.seen, [('4', 'second'), ('1', 'first')])
+
+    def test_helper_properties(self):
+        framework = self.create_framework()
+        framework.model = 'test-model'
+        framework.meta = 'test-meta'
+
+        my_obj = Object(framework, 'my_obj')
+        self.assertEqual(my_obj.model, framework.model)
+
+    def test_ban_concurrent_frameworks(self):
+        f = self.create_framework(tmpdir=self.tmpdir)
+        with self.assertRaises(Exception) as cm:
+            self.create_framework(tmpdir=self.tmpdir)
+        self.assertIn('database is locked', str(cm.exception))
+        f.close()
+
+    def test_snapshot_saving_restricted_to_simple_types(self):
+        # this can not be saved, as it has not simple types!
+        to_be_saved = {"bar": TestFramework}
+
+        class FooEvent(EventBase):
+            def snapshot(self):
+                return to_be_saved
+
+        handle = Handle(None, "a_foo", "some_key")
+        event = FooEvent(handle)
+
+        framework = self.create_framework()
+        framework.register_type(FooEvent, None, handle.kind)
+        with self.assertRaises(ValueError) as cm:
+            framework.save_snapshot(event)
+        expected = (
+            "unable to save the data for FooEvent, it must contain only simple types: "
+            "{'bar': <class 'test.test_framework.TestFramework'>}")
+        self.assertEqual(str(cm.exception), expected)
+
+    def test_unobserved_events_dont_leave_cruft(self):
+        class FooEvent(EventBase):
+            def snapshot(self):
+                return {'content': 1}
+
+        class Events(ObjectEvents):
+            foo = EventSource(FooEvent)
+
+        class Emitter(Object):
+            on = Events()
+
+        framework = self.create_framework()
+        e = Emitter(framework, 'key')
+        e.on.foo.emit()
+        ev_1_handle = Handle(e.on, "foo", "1")
+        with self.assertRaises(NoSnapshotError):
+            framework.load_snapshot(ev_1_handle)
+        # Committing will save the framework's state, but no other snapshots should be saved
+        framework.commit()
+        events = framework._storage.list_snapshots()
+        self.assertEqual(list(events), [framework._stored.handle.path])
+
+    def test_event_regex(self):
+        examples = [
+            'Ubuntu/on/config_changed[7]',
+            'on/commit[9]',
+            'on/pre_commit[8]',
+        ]
+        non_examples = [
+            'StoredStateData[_stored]',
+            'ObjectWithSTorage[obj]StoredStateData[_stored]',
+        ]
+        regex = re.compile(_event_regex)
+        for e in examples:
+            self.assertIsNotNone(regex.match(e))
+        for e in non_examples:
+            self.assertIsNone(regex.match(e))
+
+    def test_remove_unreferenced_events(self):
+        framework = self.create_framework()
+
+        class Evt(EventBase):
+            pass
+
+        class Events(ObjectEvents):
+            event = EventSource(Evt)
+
+        class ObjectWithStorage(Object):
+            _stored = StoredState()
+            on = Events()
+
+            def __init__(self, framework, key):
+                super().__init__(framework, key)
+                self._stored.set_default(foo=2)
+                self.framework.observe(self.on.event, self._on_event)
+
+            def _on_event(self, event):
+                event.defer()
+
+        # This is an event that 'happened in the past' that doesn't have an associated notice.
+        o = ObjectWithStorage(framework, 'obj')
+        handle = Handle(o.on, 'event', '100')
+        event = Evt(handle)
+        framework.save_snapshot(event)
+        self.assertEqual(list(framework._storage.list_snapshots()), [handle.path])
+        o.on.event.emit()
+        self.assertEqual(
+            list(framework._storage.notices('')),
+            [('ObjectWithStorage[obj]/on/event[1]', 'ObjectWithStorage[obj]', '_on_event')])
+        framework.commit()
+        self.assertEqual(
+            sorted(framework._storage.list_snapshots()),
+            sorted(['ObjectWithStorage[obj]/on/event[100]',
+                    'StoredStateData[_stored]',
+                    'ObjectWithStorage[obj]/StoredStateData[_stored]',
+                    'ObjectWithStorage[obj]/on/event[1]']))
+        framework.remove_unreferenced_events()
+        self.assertEqual(
+            sorted(framework._storage.list_snapshots()),
+            sorted([
+                'StoredStateData[_stored]',
+                'ObjectWithStorage[obj]/StoredStateData[_stored]',
+                'ObjectWithStorage[obj]/on/event[1]']))
+
+
+class TestStoredState(BaseTestCase):
+
+    def setUp(self):
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, str(self.tmpdir))
+
+    def test_basic_state_storage(self):
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        self._stored_state_tests(SomeObject)
+
+    def test_straight_subclass(self):
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        class Sub(SomeObject):
+            pass
+
+        self._stored_state_tests(Sub)
+
+    def test_straight_sub_subclass(self):
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        class Sub(SomeObject):
+            pass
+
+        class SubSub(SomeObject):
+            pass
+
+        self._stored_state_tests(SubSub)
+
+    def test_two_subclasses(self):
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        class SubA(SomeObject):
+            pass
+
+        class SubB(SomeObject):
+            pass
+
+        self._stored_state_tests(SubA)
+        self._stored_state_tests(SubB)
+
+    def test_the_crazy_thing(self):
+        class NoState(Object):
+            pass
+
+        class StatedObject(NoState):
+            _stored = StoredState()
+
+        class Sibling(NoState):
+            pass
+
+        class FinalChild(StatedObject, Sibling):
+            pass
+
+        self._stored_state_tests(FinalChild)
+
+    def _stored_state_tests(self, cls):
+        framework = self.create_framework(tmpdir=self.tmpdir)
+        obj = cls(framework, "1")
+
+        try:
+            obj._stored.foo
+        except AttributeError as e:
+            self.assertEqual(str(e), "attribute 'foo' is not stored")
+        else:
+            self.fail("AttributeError not raised")
+
+        try:
+            obj._stored.on = "nonono"
+        except AttributeError as e:
+            self.assertEqual(str(e), "attribute 'on' is reserved and cannot be set")
+        else:
+            self.fail("AttributeError not raised")
+
+        obj._stored.foo = 41
+        obj._stored.foo = 42
+        obj._stored.bar = "s"
+        obj._stored.baz = 4.2
+        obj._stored.bing = True
+
+        self.assertEqual(obj._stored.foo, 42)
+
+        framework.commit()
+
+        # This won't be committed, and should not be seen.
+        obj._stored.foo = 43
+
+        framework.close()
+
+        # Since this has the same absolute object handle, it will get its state back.
+        framework_copy = self.create_framework(tmpdir=self.tmpdir)
+        obj_copy = cls(framework_copy, "1")
+        self.assertEqual(obj_copy._stored.foo, 42)
+        self.assertEqual(obj_copy._stored.bar, "s")
+        self.assertEqual(obj_copy._stored.baz, 4.2)
+        self.assertEqual(obj_copy._stored.bing, True)
+
+        framework_copy.close()
+
+    def test_two_subclasses_no_conflicts(self):
+        class Base(Object):
+            _stored = StoredState()
+
+        class SubA(Base):
+            pass
+
+        class SubB(Base):
+            pass
+
+        framework = self.create_framework(tmpdir=self.tmpdir)
+        a = SubA(framework, None)
+        b = SubB(framework, None)
+        z = Base(framework, None)
+
+        a._stored.foo = 42
+        b._stored.foo = "hello"
+        z._stored.foo = {1}
+
+        framework.commit()
+        framework.close()
+
+        framework2 = self.create_framework(tmpdir=self.tmpdir)
+        a2 = SubA(framework2, None)
+        b2 = SubB(framework2, None)
+        z2 = Base(framework2, None)
+
+        self.assertEqual(a2._stored.foo, 42)
+        self.assertEqual(b2._stored.foo, "hello")
+        self.assertEqual(z2._stored.foo, {1})
+
+    def test_two_names_one_state(self):
+        class Mine(Object):
+            _stored = StoredState()
+            _stored2 = _stored
+
+        framework = self.create_framework()
+        obj = Mine(framework, None)
+
+        with self.assertRaises(RuntimeError):
+            obj._stored.foo = 42
+
+        with self.assertRaises(RuntimeError):
+            obj._stored2.foo = 42
+
+        framework.close()
+
+        # make sure we're not changing the object on failure
+        self.assertNotIn("_stored", obj.__dict__)
+        self.assertNotIn("_stored2", obj.__dict__)
+
+    def test_same_name_two_classes(self):
+        class Base(Object):
+            pass
+
+        class A(Base):
+            _stored = StoredState()
+
+        class B(Base):
+            _stored = A._stored
+
+        framework = self.create_framework()
+        a = A(framework, None)
+        b = B(framework, None)
+
+        # NOTE it's the second one that actually triggers the
+        # exception, but that's an implementation detail
+        a._stored.foo = 42
+
+        with self.assertRaises(RuntimeError):
+            b._stored.foo = "xyzzy"
+
+        framework.close()
+
+        # make sure we're not changing the object on failure
+        self.assertNotIn("_stored", b.__dict__)
+
+    def test_mutable_types_invalid(self):
+        framework = self.create_framework()
+
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        obj = SomeObject(framework, '1')
+        try:
+            class CustomObject:
+                pass
+            obj._stored.foo = CustomObject()
+        except AttributeError as e:
+            self.assertEqual(
+                str(e),
+                "attribute 'foo' cannot be a CustomObject: must be int/float/dict/list/etc")
+        else:
+            self.fail('AttributeError not raised')
+
+        framework.commit()
+
+    def test_mutable_types(self):
+        # Test and validation functions in a list of 2-tuples.
+        # Assignment and keywords like del are not supported in lambdas
+        #  so functions are used instead.
+        test_operations = [(
+            lambda: {},         # Operand A.
+            None,               # Operand B.
+            {},                 # Expected result.
+            lambda a, b: None,  # Operation to perform.
+            lambda res, expected_res: self.assertEqual(res, expected_res)  # Validation to perform.
+        ), (
+            lambda: {},
+            {'a': {}},
+            {'a': {}},
+            lambda a, b: a.update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {}},
+            {'b': 'c'},
+            {'a': {'b': 'c'}},
+            lambda a, b: a['a'].update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {'b': 'c'}},
+            {'d': 'e'},
+            {'a': {'b': 'c', 'd': 'e'}},
+            lambda a, b: a['a'].update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {'b': 'c', 'd': 'e'}},
+            'd',
+            {'a': {'b': 'c'}},
+            lambda a, b: a['a'].pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'s': set()},
+            'a',
+            {'s': {'a'}},
+            lambda a, b: a['s'].add(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'s': {'a'}},
+            'a',
+            {'s': set()},
+            lambda a, b: a['s'].discard(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [],
+            None,
+            [],
+            lambda a, b: None,
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [],
+            'a',
+            ['a'],
+            lambda a, b: a.append(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a'],
+            ['c'],
+            ['a', ['c']],
+            lambda a, b: a.append(b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList),
+            )
+        ), (
+            lambda: ['a', ['c']],
+            'b',
+            ['b', 'a', ['c']],
+            lambda a, b: a.insert(0, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['b', 'a', ['c']],
+            ['d'],
+            ['b', ['d'], 'a', ['c']],
+            lambda a, b: a.insert(1, b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList)
+            ),
+        ), (
+            lambda: ['b', 'a', ['c']],
+            ['d'],
+            ['b', ['d'], ['c']],
+            # a[1] = b
+            lambda a, b: a.__setitem__(1, b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList)
+            ),
+        ), (
+            lambda: ['b', ['d'], 'a', ['c']],
+            0,
+            [['d'], 'a', ['c']],
+            lambda a, b: a.pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [['d'], 'a', ['c']],
+            ['d'],
+            ['a', ['c']],
+            lambda a, b: a.remove(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c']],
+            'd',
+            ['a', ['c', 'd']],
+            lambda a, b: a[1].append(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c', 'd']],
+            1,
+            ['a', ['c']],
+            lambda a, b: a[1].pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c']],
+            'd',
+            ['a', ['c', 'd']],
+            lambda a, b: a[1].insert(1, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c', 'd']],
+            'd',
+            ['a', ['c']],
+            lambda a, b: a[1].remove(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            None,
+            set(),
+            lambda a, b: None,
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            'a',
+            set(['a']),
+            lambda a, b: a.add(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(['a']),
+            'a',
+            set(),
+            lambda a, b: a.discard(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            {'a'},
+            set(),
+            # Nested sets are not allowed as sets themselves are not hashable.
+            lambda a, b: self.assertRaises(TypeError, a.add, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        )]
+
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        class WrappedFramework(Framework):
+            def __init__(self, store, charm_dir, meta, model):
+                super().__init__(store, charm_dir, meta, model)
+                self.snapshots = []
+
+            def save_snapshot(self, value):
+                if value.handle.path == 'SomeObject[1]/StoredStateData[_stored]':
+                    self.snapshots.append((type(value), value.snapshot()))
+                return super().save_snapshot(value)
+
+        # Validate correctness of modification operations.
+        for get_a, b, expected_res, op, validate_op in test_operations:
+            storage = SQLiteStorage(self.tmpdir / "framework.data")
+            framework = WrappedFramework(storage, self.tmpdir, None, None)
+            obj = SomeObject(framework, '1')
+
+            obj._stored.a = get_a()
+            self.assertTrue(isinstance(obj._stored, BoundStoredState))
+
+            op(obj._stored.a, b)
+            validate_op(obj._stored.a, expected_res)
+
+            obj._stored.a = get_a()
+            framework.commit()
+            # We should see an update for initializing a
+            self.assertEqual(framework.snapshots, [
+                (StoredStateData, {'a': get_a()}),
+            ])
+            del obj
+            gc.collect()
+            obj_copy1 = SomeObject(framework, '1')
+            self.assertEqual(obj_copy1._stored.a, get_a())
+
+            op(obj_copy1._stored.a, b)
+            validate_op(obj_copy1._stored.a, expected_res)
+            framework.commit()
+            framework.close()
+
+            storage_copy = SQLiteStorage(self.tmpdir / "framework.data")
+            framework_copy = WrappedFramework(storage_copy, self.tmpdir, None, None)
+
+            obj_copy2 = SomeObject(framework_copy, '1')
+
+            validate_op(obj_copy2._stored.a, expected_res)
+
+            # Commit saves the pre-commit and commit events, and the framework
+            # event counter, but shouldn't update the stored state of my object
+            framework.snapshots.clear()
+            framework_copy.commit()
+            self.assertEqual(framework_copy.snapshots, [])
+            framework_copy.close()
+
+    def test_comparison_operations(self):
+        test_operations = [(
+            {"1"},               # Operand A.
+            {"1", "2"},          # Operand B.
+            lambda a, b: a < b,  # Operation to test.
+            True,                # Result of op(A, B).
+            False,               # Result of op(B, A).
+        ), (
+            {"1"},
+            {"1", "2"},
+            lambda a, b: a > b,
+            False,
+            True
+        ), (
+            # Empty set comparison.
+            set(),
+            set(),
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"a", "c"},
+            {"c", "a"},
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            dict(),
+            dict(),
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"1": "2"},
+            {"1": "2"},
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"1": "2"},
+            {"1": "3"},
+            lambda a, b: a == b,
+            False,
+            False
+        ), (
+            [],
+            [],
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            [1, 2],
+            [1, 2],
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            [1, 2, 5, 6],
+            [1, 2, 5, 8, 10],
+            lambda a, b: a <= b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 6],
+            [1, 2, 5, 8, 10],
+            lambda a, b: a < b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 8],
+            [1, 2, 5, 6, 10],
+            lambda a, b: a > b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 8],
+            [1, 2, 5, 6, 10],
+            lambda a, b: a >= b,
+            True,
+            False
+        )]
+
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        framework = self.create_framework()
+
+        for i, (a, b, op, op_ab, op_ba) in enumerate(test_operations):
+            obj = SomeObject(framework, str(i))
+            obj._stored.a = a
+            self.assertEqual(op(obj._stored.a, b), op_ab)
+            self.assertEqual(op(b, obj._stored.a), op_ba)
+
+    def test_set_operations(self):
+        test_operations = [(
+            {"1"},  # A set to test an operation against (other_set).
+            lambda a, b: a | b,  # An operation to test.
+            {"1", "a", "b"},  # The expected result of operation(obj._stored.set, other_set).
+            {"1", "a", "b"}  # The expected result of operation(other_set, obj._stored.set).
+        ), (
+            {"a", "c"},
+            lambda a, b: a - b,
+            {"b"},
+            {"c"}
+        ), (
+            {"a", "c"},
+            lambda a, b: a & b,
+            {"a"},
+            {"a"}
+        ), (
+            {"a", "c", "d"},
+            lambda a, b: a ^ b,
+            {"b", "c", "d"},
+            {"b", "c", "d"}
+        ), (
+            set(),
+            lambda a, b: set(a),
+            {"a", "b"},
+            set()
+        )]
+
+        class SomeObject(Object):
+            _stored = StoredState()
+
+        framework = self.create_framework()
+
+        # Validate that operations between StoredSet and built-in sets
+        # only result in built-in sets being returned.
+        # Make sure that commutativity is preserved and that the
+        # original sets are not changed or used as a result.
+        for i, (variable_operand, operation, ab_res, ba_res) in enumerate(test_operations):
+            obj = SomeObject(framework, str(i))
+            obj._stored.set = {"a", "b"}
+
+            for a, b, expected in [
+                    (obj._stored.set, variable_operand, ab_res),
+                    (variable_operand, obj._stored.set, ba_res)]:
+                old_a = set(a)
+                old_b = set(b)
+
+                result = operation(a, b)
+                self.assertEqual(result, expected)
+
+                # Common sanity checks
+                self.assertIsNot(obj._stored.set._under, result)
+                self.assertIsNot(result, a)
+                self.assertIsNot(result, b)
+                self.assertEqual(a, old_a)
+                self.assertEqual(b, old_b)
+
+    def test_set_default(self):
+        framework = self.create_framework()
+
+        class StatefulObject(Object):
+            _stored = StoredState()
+        parent = StatefulObject(framework, 'key')
+        parent._stored.set_default(foo=1)
+        self.assertEqual(parent._stored.foo, 1)
+        parent._stored.set_default(foo=2)
+        # foo was already set, so it doesn't get replaced
+        self.assertEqual(parent._stored.foo, 1)
+        parent._stored.set_default(foo=3, bar=4)
+        self.assertEqual(parent._stored.foo, 1)
+        self.assertEqual(parent._stored.bar, 4)
+        # reloading the state still leaves things at the default values
+        framework.commit()
+        del parent
+        parent = StatefulObject(framework, 'key')
+        parent._stored.set_default(foo=5, bar=6)
+        self.assertEqual(parent._stored.foo, 1)
+        self.assertEqual(parent._stored.bar, 4)
+        # TODO: jam 2020-01-30 is there a clean way to tell that
+        #       parent._stored._data.dirty is False?
+
+
+class GenericObserver(Object):
+    """Generic observer for the tests."""
+
+    def __init__(self, parent, key):
+        super().__init__(parent, key)
+        self.called = False
+
+    def callback_method(self, event):
+        """Set the instance .called to True."""
+        self.called = True
+
+
+@patch('sys.stderr', new_callable=io.StringIO)
+class BreakpointTests(BaseTestCase):
+
+    def setUp(self):
+        super().setUp()
+        logassert.setup(self, 'ops')
+
+    def test_ignored(self, fake_stderr):
+        # It doesn't do anything really unless proper environment is there.
+        with patch.dict(os.environ):
+            os.environ.pop('JUJU_DEBUG_AT', None)
+            framework = self.create_framework()
+
+        with patch('pdb.Pdb.set_trace') as mock:
+            framework.breakpoint()
+        self.assertEqual(mock.call_count, 0)
+        self.assertEqual(fake_stderr.getvalue(), "")
+        self.assertNotLoggedWarning("Breakpoint", "skipped")
+
+    def test_pdb_properly_called(self, fake_stderr):
+        # The debugger needs to leave the user in the frame where the breakpoint is executed,
+        # which for the test is the frame we're calling it here in the test :).
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'all'}):
+            framework = self.create_framework()
+
+        with patch('pdb.Pdb.set_trace') as mock:
+            this_frame = inspect.currentframe()
+            framework.breakpoint()
+
+        self.assertEqual(mock.call_count, 1)
+        self.assertEqual(mock.call_args, ((this_frame,), {}))
+
+    def test_welcome_message(self, fake_stderr):
+        # Check that an initial message is shown to the user when code is interrupted.
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'all'}):
+            framework = self.create_framework()
+        with patch('pdb.Pdb.set_trace'):
+            framework.breakpoint()
+        self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+
+    def test_welcome_message_not_multiple(self, fake_stderr):
+        # Check that an initial message is NOT shown twice if the breakpoint is exercised
+        # twice in the same run.
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'all'}):
+            framework = self.create_framework()
+        with patch('pdb.Pdb.set_trace'):
+            framework.breakpoint()
+            self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+            framework.breakpoint()
+            self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+
+    def test_builtin_breakpoint_hooked(self, fake_stderr):
+        # Verify that the proper hook is set.
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'all'}):
+            self.create_framework()  # creating the framework setups the hook
+        with patch('pdb.Pdb.set_trace') as mock:
+            # Calling through sys, not breakpoint() directly, so we can run the
+            # tests with Py < 3.7.
+            sys.breakpointhook()
+        self.assertEqual(mock.call_count, 1)
+
+    def test_breakpoint_names(self, fake_stderr):
+        framework = self.create_framework()
+
+        # Name rules:
+        # - must start and end with lowercase alphanumeric characters
+        # - only contain lowercase alphanumeric characters, or the hyphen "-"
+        good_names = [
+            'foobar',
+            'foo-bar-baz',
+            'foo-------bar',
+            'foo123',
+            '778',
+            '77-xx',
+            'a-b',
+            'ab',
+            'x',
+        ]
+        for name in good_names:
+            with self.subTest(name=name):
+                framework.breakpoint(name)
+
+        bad_names = [
+            '',
+            '.',
+            '-',
+            '...foo',
+            'foo.bar',
+            'bar--'
+            'FOO',
+            'FooBar',
+            'foo bar',
+            'foo_bar',
+            '/foobar',
+            'break-here-☚',
+        ]
+        msg = 'breakpoint names must look like "foo" or "foo-bar"'
+        for name in bad_names:
+            with self.subTest(name=name):
+                with self.assertRaises(ValueError) as cm:
+                    framework.breakpoint(name)
+                self.assertEqual(str(cm.exception), msg)
+
+        reserved_names = [
+            'all',
+            'hook',
+        ]
+        msg = 'breakpoint names "all" and "hook" are reserved'
+        for name in reserved_names:
+            with self.subTest(name=name):
+                with self.assertRaises(ValueError) as cm:
+                    framework.breakpoint(name)
+                self.assertEqual(str(cm.exception), msg)
+
+        not_really_names = [
+            123,
+            1.1,
+            False,
+        ]
+        for name in not_really_names:
+            with self.subTest(name=name):
+                with self.assertRaises(TypeError) as cm:
+                    framework.breakpoint(name)
+                self.assertEqual(str(cm.exception), 'breakpoint names must be strings')
+
+    def check_trace_set(self, envvar_value, breakpoint_name, call_count):
+        """Helper to check the diverse combinations of situations."""
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': envvar_value}):
+            framework = self.create_framework()
+        with patch('pdb.Pdb.set_trace') as mock:
+            framework.breakpoint(breakpoint_name)
+        self.assertEqual(mock.call_count, call_count)
+
+    def test_unnamed_indicated_all(self, fake_stderr):
+        # If 'all' is indicated, unnamed breakpoints will always activate.
+        self.check_trace_set('all', None, 1)
+
+    def test_unnamed_indicated_hook(self, fake_stderr):
+        # Special value 'hook' was indicated, nothing to do with any call.
+        self.check_trace_set('hook', None, 0)
+
+    def test_named_indicated_specifically(self, fake_stderr):
+        # Some breakpoint was indicated, and the framework call used exactly that name.
+        self.check_trace_set('mybreak', 'mybreak', 1)
+
+    def test_named_indicated_unnamed(self, fake_stderr):
+        # Some breakpoint was indicated, but the framework call was unnamed
+        self.check_trace_set('some-breakpoint', None, 0)
+        self.assertLoggedWarning(
+            "Breakpoint None skipped",
+            "not found in the requested breakpoints: ['some-breakpoint']")
+
+    def test_named_indicated_somethingelse(self, fake_stderr):
+        # Some breakpoint was indicated, but the framework call was with a different name
+        self.check_trace_set('some-breakpoint', 'other-name', 0)
+        self.assertLoggedWarning(
+            "Breakpoint 'other-name' skipped",
+            "not found in the requested breakpoints: ['some-breakpoint']")
+
+    def test_named_indicated_ingroup(self, fake_stderr):
+        # A multiple breakpoint was indicated, and the framework call used a name among those.
+        self.check_trace_set('some,mybreak,foobar', 'mybreak', 1)
+
+    def test_named_indicated_all(self, fake_stderr):
+        # The framework indicated 'all', which includes any named breakpoint set.
+        self.check_trace_set('all', 'mybreak', 1)
+
+    def test_named_indicated_hook(self, fake_stderr):
+        # The framework indicated the special value 'hook', nothing to do with any named call.
+        self.check_trace_set('hook', 'mybreak', 0)
+
+
+class DebugHookTests(BaseTestCase):
+
+    def test_envvar_parsing_missing(self):
+        with patch.dict(os.environ):
+            os.environ.pop('JUJU_DEBUG_AT', None)
+            framework = self.create_framework()
+        self.assertEqual(framework._juju_debug_at, ())
+
+    def test_envvar_parsing_empty(self):
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': ''}):
+            framework = self.create_framework()
+        self.assertEqual(framework._juju_debug_at, ())
+
+    def test_envvar_parsing_simple(self):
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'hook'}):
+            framework = self.create_framework()
+        self.assertEqual(framework._juju_debug_at, ['hook'])
+
+    def test_envvar_parsing_multiple(self):
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'foo,bar,all'}):
+            framework = self.create_framework()
+        self.assertEqual(framework._juju_debug_at, ['foo', 'bar', 'all'])
+
+    def test_basic_interruption_enabled(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ['hook']
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.install, observer.callback_method)
+
+        with patch('sys.stderr', new_callable=io.StringIO) as fake_stderr:
+            with patch('pdb.runcall') as mock:
+                publisher.install.emit()
+
+        # Check that the pdb module was used correctly and that the callback method was NOT
+        # called (as we intercepted the normal pdb behaviour! this is to check that the
+        # framework didn't call the callback directly)
+        self.assertEqual(mock.call_count, 1)
+        expected_callback, expected_event = mock.call_args[0]
+        self.assertEqual(expected_callback, observer.callback_method)
+        self.assertIsInstance(expected_event, EventBase)
+        self.assertFalse(observer.called)
+
+        # Verify proper message was given to the user.
+        self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+
+    def test_actions_are_interrupted(self):
+        test_model = self.create_model()
+        framework = self.create_framework(model=test_model)
+        framework._juju_debug_at = ['hook']
+
+        class CustomEvents(ObjectEvents):
+            foobar_action = EventSource(charm.ActionEvent)
+
+        publisher = CustomEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.foobar_action, observer.callback_method)
+        fake_script(self, 'action-get', "echo {}")
+
+        with patch('sys.stderr', new_callable=io.StringIO):
+            with patch('pdb.runcall') as mock:
+                with patch.dict(os.environ, {'JUJU_ACTION_NAME': 'foobar'}):
+                    publisher.foobar_action.emit()
+
+        self.assertEqual(mock.call_count, 1)
+        self.assertFalse(observer.called)
+
+    def test_internal_events_not_interrupted(self):
+        class MyNotifier(Object):
+            """Generic notifier for the tests."""
+            bar = EventSource(EventBase)
+
+        framework = self.create_framework()
+        framework._juju_debug_at = ['hook']
+
+        publisher = MyNotifier(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.bar, observer.callback_method)
+
+        with patch('pdb.runcall') as mock:
+            publisher.bar.emit()
+
+        self.assertEqual(mock.call_count, 0)
+        self.assertTrue(observer.called)
+
+    def test_envvar_mixed(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ['foo', 'hook', 'all', 'whatever']
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.install, observer.callback_method)
+
+        with patch('sys.stderr', new_callable=io.StringIO):
+            with patch('pdb.runcall') as mock:
+                publisher.install.emit()
+
+        self.assertEqual(mock.call_count, 1)
+        self.assertFalse(observer.called)
+
+    def test_no_registered_method(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ['hook']
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+
+        with patch('pdb.runcall') as mock:
+            publisher.install.emit()
+
+        self.assertEqual(mock.call_count, 0)
+        self.assertFalse(observer.called)
+
+    def test_envvar_nohook(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ['something-else']
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.install, observer.callback_method)
+
+        with patch.dict(os.environ, {'JUJU_DEBUG_AT': 'something-else'}):
+            with patch('pdb.runcall') as mock:
+                publisher.install.emit()
+
+        self.assertEqual(mock.call_count, 0)
+        self.assertTrue(observer.called)
+
+    def test_envvar_missing(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ()
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.install, observer.callback_method)
+
+        with patch('pdb.runcall') as mock:
+            publisher.install.emit()
+
+        self.assertEqual(mock.call_count, 0)
+        self.assertTrue(observer.called)
+
+    def test_welcome_message_not_multiple(self):
+        framework = self.create_framework()
+        framework._juju_debug_at = ['hook']
+
+        publisher = charm.CharmEvents(framework, "1")
+        observer = GenericObserver(framework, "1")
+        framework.observe(publisher.install, observer.callback_method)
+
+        with patch('sys.stderr', new_callable=io.StringIO) as fake_stderr:
+            with patch('pdb.runcall') as mock:
+                publisher.install.emit()
+                self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+                publisher.install.emit()
+                self.assertEqual(fake_stderr.getvalue(), _BREAKPOINT_WELCOME_MESSAGE)
+        self.assertEqual(mock.call_count, 2)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_helpers.py
new file mode 100755
index 0000000000000000000000000000000000000000..f7c6fc29a60362940d4e0259351d1d53eb9dbe93
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_helpers.py
@@ -0,0 +1,121 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import pathlib
+import subprocess
+import shutil
+import tempfile
+import unittest
+
+from ops.framework import Framework
+from ops.model import Model, _ModelBackend
+from ops.charm import CharmMeta
+from ops.storage import SQLiteStorage
+
+
+def fake_script(test_case, name, content):
+    if not hasattr(test_case, 'fake_script_path'):
+        fake_script_path = tempfile.mkdtemp('-fake_script')
+        os.environ['PATH'] = '{}:{}'.format(fake_script_path, os.environ["PATH"])
+
+        def cleanup():
+            shutil.rmtree(fake_script_path)
+            os.environ['PATH'] = os.environ['PATH'].replace(fake_script_path + ':', '')
+
+        test_case.addCleanup(cleanup)
+        test_case.fake_script_path = pathlib.Path(fake_script_path)
+
+    template_args = {
+        'name': name,
+        'path': test_case.fake_script_path,
+        'content': content,
+    }
+
+    with (test_case.fake_script_path / name).open('wt') as f:
+        # Before executing the provided script, dump the provided arguments in calls.txt.
+        # ASCII 1E is RS 'record separator', and 1C is FS 'file separator', which seem appropriate.
+        f.write('''#!/bin/sh
+{{ printf {name}; printf "\\036%s" "$@"; printf "\\034"; }} >> {path}/calls.txt
+{content}'''.format_map(template_args))
+    os.chmod(str(test_case.fake_script_path / name), 0o755)
+
+
+def fake_script_calls(test_case, clear=False):
+    try:
+        with (test_case.fake_script_path / 'calls.txt').open('r+t') as f:
+            calls = [line.split('\x1e') for line in f.read().split('\x1c')[:-1]]
+            if clear:
+                f.truncate(0)
+            return calls
+    except FileNotFoundError:
+        return []
+
+
+class FakeScriptTest(unittest.TestCase):
+
+    def test_fake_script_works(self):
+        fake_script(self, 'foo', 'echo foo runs')
+        fake_script(self, 'bar', 'echo bar runs')
+        output = subprocess.getoutput('foo a "b c "; bar "d e" f')
+        self.assertEqual(output, 'foo runs\nbar runs')
+        self.assertEqual(fake_script_calls(self), [
+            ['foo', 'a', 'b c '],
+            ['bar', 'd e', 'f'],
+        ])
+
+    def test_fake_script_clear(self):
+        fake_script(self, 'foo', 'echo foo runs')
+
+        output = subprocess.getoutput('foo a "b c"')
+        self.assertEqual(output, 'foo runs')
+
+        self.assertEqual(fake_script_calls(self, clear=True), [['foo', 'a', 'b c']])
+
+        fake_script(self, 'bar', 'echo bar runs')
+
+        output = subprocess.getoutput('bar "d e" f')
+        self.assertEqual(output, 'bar runs')
+
+        self.assertEqual(fake_script_calls(self, clear=True), [['bar', 'd e', 'f']])
+
+        self.assertEqual(fake_script_calls(self, clear=True), [])
+
+
+class BaseTestCase(unittest.TestCase):
+
+    def create_framework(self, *, model=None, tmpdir=None):
+        """Create a Framework object.
+
+        By default operate in-memory; pass a temporary directory via the 'tmpdir'
+        parameter if you whish to instantiate several frameworks sharing the
+        same dir (e.g. for storing state).
+        """
+        if tmpdir is None:
+            data_fpath = ":memory:"
+            charm_dir = 'non-existant'
+        else:
+            data_fpath = tmpdir / "framework.data"
+            charm_dir = tmpdir
+
+        framework = Framework(SQLiteStorage(data_fpath), charm_dir, meta=None, model=model)
+        self.addCleanup(framework.close)
+        return framework
+
+    def create_model(self):
+        """Create a Model object."""
+        backend = _ModelBackend(unit_name='myapp/0')
+        meta = CharmMeta()
+        model = Model(meta, backend)
+        return model
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_infra.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_infra.py
new file mode 100644
index 0000000000000000000000000000000000000000..5133b35d11be89a702558d6f961facb8884553ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_infra.py
@@ -0,0 +1,155 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import itertools
+import os
+import re
+import subprocess
+import sys
+import tempfile
+import unittest
+from unittest.mock import patch
+
+import autopep8
+from flake8.api.legacy import get_style_guide
+
+import ops
+
+
+def get_python_filepaths():
+    """Helper to retrieve paths of Python files."""
+    python_paths = ['setup.py']
+    for root in ['ops', 'test']:
+        for dirpath, dirnames, filenames in os.walk(root):
+            for filename in filenames:
+                if filename.endswith(".py"):
+                    python_paths.append(os.path.join(dirpath, filename))
+    return python_paths
+
+
+class InfrastructureTests(unittest.TestCase):
+
+    def test_pep8(self):
+        # verify all files are nicely styled
+        python_filepaths = get_python_filepaths()
+        style_guide = get_style_guide()
+        fake_stdout = io.StringIO()
+        with patch('sys.stdout', fake_stdout):
+            report = style_guide.check_files(python_filepaths)
+
+        # if flake8 didnt' report anything, we're done
+        if report.total_errors == 0:
+            return
+
+        # grab on which files we have issues
+        flake8_issues = fake_stdout.getvalue().split('\n')
+        broken_filepaths = {item.split(':')[0] for item in flake8_issues if item}
+
+        # give hints to the developer on how files' style could be improved
+        options = autopep8.parse_args([''])
+        options.aggressive = 1
+        options.diff = True
+        options.max_line_length = 99
+
+        issues = []
+        for filepath in broken_filepaths:
+            diff = autopep8.fix_file(filepath, options=options)
+            if diff:
+                issues.append(diff)
+
+        report = ["Please fix files as suggested by autopep8:"] + issues
+        report += ["\n-- Original flake8 reports:"] + flake8_issues
+        self.fail("\n".join(report))
+
+    def test_quote_backslashes(self):
+        # ensure we're not using unneeded backslash to escape strings
+        issues = []
+        for filepath in get_python_filepaths():
+            with open(filepath, "rt", encoding="utf8") as fh:
+                for idx, line in enumerate(fh, 1):
+                    if (r'\"' in line or r"\'" in line) and "NOQA" not in line:
+                        issues.append((filepath, idx, line.rstrip()))
+        if issues:
+            msgs = ["{}:{:d}:{}".format(*issue) for issue in issues]
+            self.fail("Spurious backslashes found, please fix these quotings:\n" + "\n".join(msgs))
+
+    def test_ensure_copyright(self):
+        # all non-empty Python files must have a proper copyright somewhere in the first 5 lines
+        issues = []
+        regex = re.compile(r"# Copyright \d\d\d\d(-\d\d\d\d)? Canonical Ltd.\n")
+        for filepath in get_python_filepaths():
+            if os.stat(filepath).st_size == 0:
+                continue
+
+            with open(filepath, "rt", encoding="utf8") as fh:
+                for line in itertools.islice(fh, 5):
+                    if regex.match(line):
+                        break
+                else:
+                    issues.append(filepath)
+        if issues:
+            self.fail("Please add copyright headers to the following files:\n" + "\n".join(issues))
+
+    def _run_setup(self, *args):
+        proc = subprocess.run(
+            (sys.executable, 'setup.py') + args,
+            stdout=subprocess.PIPE,
+            check=True)
+        return proc.stdout.strip().decode("utf8")
+
+    def test_setup_version(self):
+        setup_version = self._run_setup('--version')
+
+        self.assertEqual(setup_version, ops.__version__)
+
+    def test_setup_description(self):
+        with open("README.md", "rt", encoding="utf8") as fh:
+            disk_readme = fh.read().strip()
+
+        setup_readme = self._run_setup('--long-description')
+
+        self.assertEqual(setup_readme, disk_readme)
+
+    def test_check(self):
+        self._run_setup('check', '--strict')
+
+
+class ImportersTestCase(unittest.TestCase):
+
+    template = "from ops import {module_name}"
+
+    def test_imports(self):
+        mod_names = [
+            'charm',
+            'framework',
+            'main',
+            'model',
+            'testing',
+        ]
+
+        for name in mod_names:
+            with self.subTest(name=name):
+                self.check(name)
+
+    def check(self, name):
+        """Helper function to run the test."""
+        _, testfile = tempfile.mkstemp()
+        self.addCleanup(os.unlink, testfile)
+
+        with open(testfile, 'wt', encoding='utf8') as fh:
+            fh.write(self.template.format(module_name=name))
+
+        proc = subprocess.run([sys.executable, testfile], env={'PYTHONPATH': os.getcwd()})
+        self.assertEqual(proc.returncode, 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_jujuversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..1e3821017c22b1fb07c74a089b8f678d3b055fe6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_jujuversion.py
@@ -0,0 +1,145 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import unittest
+import unittest.mock  # in this file, importing just 'patch' would be confusing
+
+from ops.jujuversion import JujuVersion
+
+
+class TestJujuVersion(unittest.TestCase):
+
+    def test_parsing(self):
+        test_cases = [
+            ("0.0.0", 0, 0, '', 0, 0),
+            ("0.0.2", 0, 0, '', 2, 0),
+            ("0.1.0", 0, 1, '', 0, 0),
+            ("0.2.3", 0, 2, '', 3, 0),
+            ("10.234.3456", 10, 234, '', 3456, 0),
+            ("10.234.3456.1", 10, 234, '', 3456, 1),
+            ("1.21-alpha12", 1, 21, 'alpha', 12, 0),
+            ("1.21-alpha1.34", 1, 21, 'alpha', 1, 34),
+            ("2.7", 2, 7, '', 0, 0)
+        ]
+
+        for vs, major, minor, tag, patch, build in test_cases:
+            v = JujuVersion(vs)
+            self.assertEqual(v.major, major)
+            self.assertEqual(v.minor, minor)
+            self.assertEqual(v.tag, tag)
+            self.assertEqual(v.patch, patch)
+            self.assertEqual(v.build, build)
+
+    @unittest.mock.patch('os.environ', new={})
+    def test_from_environ(self):
+        with self.assertRaisesRegex(RuntimeError, 'environ has no JUJU_VERSION'):
+            JujuVersion.from_environ()
+
+        os.environ['JUJU_VERSION'] = 'no'
+        with self.assertRaisesRegex(RuntimeError, 'not a valid Juju version'):
+            JujuVersion.from_environ()
+
+        os.environ['JUJU_VERSION'] = '2.8.0'
+        v = JujuVersion.from_environ()
+        self.assertEqual(v, JujuVersion('2.8.0'))
+
+    def test_has_app_data(self):
+        self.assertTrue(JujuVersion('2.8.0').has_app_data())
+        self.assertTrue(JujuVersion('2.7.0').has_app_data())
+        self.assertFalse(JujuVersion('2.6.9').has_app_data())
+
+    def test_parsing_errors(self):
+        invalid_versions = [
+            "xyz",
+            "foo.bar",
+            "foo.bar.baz",
+            "dead.beef.ca.fe",
+            "1234567890.2.1",     # The major version is too long.
+            "0.2..1",             # Two periods next to each other.
+            "1.21.alpha1",        # Tag comes after period.
+            "1.21-alpha",         # No patch number but a tag is present.
+            "1.21-alpha1beta",    # Non-numeric string after the patch number.
+            "1.21-alpha-dev",     # Tag duplication.
+            "1.21-alpha_dev3",    # Underscore in a tag.
+            "1.21-alpha123dev3",  # Non-numeric string after the patch number.
+        ]
+        for v in invalid_versions:
+            with self.assertRaises(RuntimeError):
+                JujuVersion(v)
+
+    def test_equality(self):
+        test_cases = [
+            ("1.0.0", "1.0.0", True),
+            ("01.0.0", "1.0.0", True),
+            ("10.0.0", "9.0.0", False),
+            ("1.0.0", "1.0.1", False),
+            ("1.0.1", "1.0.0", False),
+            ("1.0.0", "1.1.0", False),
+            ("1.1.0", "1.0.0", False),
+            ("1.0.0", "2.0.0", False),
+            ("1.2-alpha1", "1.2.0", False),
+            ("1.2-alpha2", "1.2-alpha1", False),
+            ("1.2-alpha2.1", "1.2-alpha2", False),
+            ("1.2-alpha2.2", "1.2-alpha2.1", False),
+            ("1.2-beta1", "1.2-alpha1", False),
+            ("1.2-beta1", "1.2-alpha2.1", False),
+            ("1.2-beta1", "1.2.0", False),
+            ("1.2.1", "1.2.0", False),
+            ("2.0.0", "1.0.0", False),
+            ("2.0.0.0", "2.0.0", True),
+            ("2.0.0.0", "2.0.0.0", True),
+            ("2.0.0.1", "2.0.0.0", False),
+            ("2.0.1.10", "2.0.0.0", False),
+        ]
+
+        for a, b, expected in test_cases:
+            self.assertEqual(JujuVersion(a) == JujuVersion(b), expected)
+            self.assertEqual(JujuVersion(a) == b, expected)
+
+    def test_comparison(self):
+        test_cases = [
+            ("1.0.0", "1.0.0", False, True),
+            ("01.0.0", "1.0.0", False, True),
+            ("10.0.0", "9.0.0", False, False),
+            ("1.0.0", "1.0.1", True, True),
+            ("1.0.1", "1.0.0", False, False),
+            ("1.0.0", "1.1.0", True, True),
+            ("1.1.0", "1.0.0", False, False),
+            ("1.0.0", "2.0.0", True, True),
+            ("1.2-alpha1", "1.2.0", True, True),
+            ("1.2-alpha2", "1.2-alpha1", False, False),
+            ("1.2-alpha2.1", "1.2-alpha2", False, False),
+            ("1.2-alpha2.2", "1.2-alpha2.1", False, False),
+            ("1.2-beta1", "1.2-alpha1", False, False),
+            ("1.2-beta1", "1.2-alpha2.1", False, False),
+            ("1.2-beta1", "1.2.0", True, True),
+            ("1.2.1", "1.2.0", False, False),
+            ("2.0.0", "1.0.0", False, False),
+            ("2.0.0.0", "2.0.0", False, True),
+            ("2.0.0.0", "2.0.0.0", False, True),
+            ("2.0.0.1", "2.0.0.0", False, False),
+            ("2.0.1.10", "2.0.0.0", False, False),
+        ]
+
+        for a, b, expected_strict, expected_weak in test_cases:
+            self.assertEqual(JujuVersion(a) < JujuVersion(b), expected_strict)
+            self.assertEqual(JujuVersion(a) <= JujuVersion(b), expected_weak)
+            self.assertEqual(JujuVersion(b) > JujuVersion(a), expected_strict)
+            self.assertEqual(JujuVersion(b) >= JujuVersion(a), expected_weak)
+            # Implicit conversion.
+            self.assertEqual(JujuVersion(a) < b, expected_strict)
+            self.assertEqual(JujuVersion(a) <= b, expected_weak)
+            self.assertEqual(b > JujuVersion(a), expected_strict)
+            self.assertEqual(b >= JujuVersion(a), expected_weak)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_lib.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_lib.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e9af8565449b2ff1ef13c905d8e2e201a7cefad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_lib.py
@@ -0,0 +1,545 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+
+from importlib.machinery import ModuleSpec
+from pathlib import Path
+from tempfile import mkdtemp, mkstemp
+from unittest import TestCase
+from unittest.mock import patch
+from random import shuffle
+from shutil import rmtree
+from textwrap import dedent
+
+import ops.lib
+
+
+def _mklib(topdir: str, pkgname: str, libname: str) -> Path:
+    """Make a for-testing library.
+
+    Args:
+        topdir: the toplevel directory in which the package will be created.
+             This directory must already exist.
+        pkgname: the name of the package to create in the toplevel directory.
+             this package will have an empty __init__.py.
+        libname: the name of the library directory to create under the package.
+
+    Returns:
+        a :class:`Path` to the ``__init__.py`` of the created library.
+        This file will not have been created yet.
+    """
+    pkg = Path(topdir) / pkgname
+    try:
+        pkg.mkdir()
+    except FileExistsError:
+        pass
+    else:
+        (pkg / '__init__.py').write_text('')
+
+    lib = pkg / 'opslib' / libname
+    lib.mkdir(parents=True)
+
+    return lib / '__init__.py'
+
+
+def _flatten(specgen):
+    return sorted([os.path.dirname(spec.origin) for spec in specgen])
+
+
+class TestLibFinder(TestCase):
+    def _mkdtemp(self) -> str:
+        tmpdir = mkdtemp()
+        self.addCleanup(rmtree, tmpdir)
+        return tmpdir
+
+    def test_single(self):
+        tmpdir = self._mkdtemp()
+
+        self.assertEqual(list(ops.lib._find_all_specs([tmpdir])), [])
+
+        _mklib(tmpdir, "foo", "bar").write_text("")
+
+        self.assertEqual(
+            _flatten(ops.lib._find_all_specs([tmpdir])),
+            [tmpdir + '/foo/opslib/bar'])
+
+    def test_multi(self):
+        tmpdirA = self._mkdtemp()
+        tmpdirB = self._mkdtemp()
+
+        if tmpdirA > tmpdirB:
+            # keep sorting happy
+            tmpdirA, tmpdirB = tmpdirB, tmpdirA
+
+        dirs = [tmpdirA, tmpdirB]
+
+        for top in [tmpdirA, tmpdirB]:
+            for pkg in ["bar", "baz"]:
+                for lib in ["meep", "quux"]:
+                    _mklib(top, pkg, lib).write_text("")
+
+        expected = [
+            os.path.join(tmpdirA, "bar", "opslib", "meep"),
+            os.path.join(tmpdirA, "bar", "opslib", "quux"),
+            os.path.join(tmpdirA, "baz", "opslib", "meep"),
+            os.path.join(tmpdirA, "baz", "opslib", "quux"),
+            os.path.join(tmpdirB, "bar", "opslib", "meep"),
+            os.path.join(tmpdirB, "bar", "opslib", "quux"),
+            os.path.join(tmpdirB, "baz", "opslib", "meep"),
+            os.path.join(tmpdirB, "baz", "opslib", "quux"),
+        ]
+
+        self.assertEqual(_flatten(ops.lib._find_all_specs(dirs)), expected)
+
+    def test_cwd(self):
+        tmpcwd = self._mkdtemp()
+        cwd = os.getcwd()
+        os.chdir(tmpcwd)
+        self.addCleanup(os.chdir, cwd)
+
+        dirs = [""]
+
+        self.assertEqual(list(ops.lib._find_all_specs(dirs)), [])
+
+        _mklib(tmpcwd, "foo", "bar").write_text("")
+
+        self.assertEqual(
+            _flatten(ops.lib._find_all_specs(dirs)),
+            ['./foo/opslib/bar'])
+
+    def test_bogus_topdir(self):
+        """Check that having one bogus dir in sys.path doesn't cause the finder to abort."""
+        tmpdir = self._mkdtemp()
+
+        dirs = [tmpdir, "/bogus"]
+
+        self.assertEqual(list(ops.lib._find_all_specs(dirs)), [])
+
+        _mklib(tmpdir, "foo", "bar").write_text("")
+
+        self.assertEqual(
+            _flatten(ops.lib._find_all_specs(dirs)),
+            [tmpdir + '/foo/opslib/bar'])
+
+    def test_bogus_opsdir(self):
+        """Check that having one bogus opslib doesn't cause the finder to abort."""
+
+        tmpdir = self._mkdtemp()
+
+        self.assertEqual(list(ops.lib._find_all_specs([tmpdir])), [])
+
+        _mklib(tmpdir, "foo", "bar").write_text('')
+
+        path = Path(tmpdir) / 'baz'
+        path.mkdir()
+        (path / 'opslib').write_text('')
+
+        self.assertEqual(
+            _flatten(ops.lib._find_all_specs([tmpdir])),
+            [tmpdir + '/foo/opslib/bar'])
+
+    def test_namespace(self):
+        """Check that namespace packages are ignored."""
+        tmpdir = self._mkdtemp()
+
+        self.assertEqual(list(ops.lib._find_all_specs([tmpdir])), [])
+
+        _mklib(tmpdir, "foo", "bar")  # no __init__.py  =>  a namespace package
+
+        self.assertEqual(list(ops.lib._find_all_specs([tmpdir])), [])
+
+
+class TestLibParser(TestCase):
+    def _mkmod(self, name: str, content: str = None) -> ModuleSpec:
+        fd, fname = mkstemp(text=True)
+        self.addCleanup(os.unlink, fname)
+        if content is not None:
+            with os.fdopen(fd, mode='wt', closefd=False) as f:
+                f.write(dedent(content))
+        os.close(fd)
+        return ModuleSpec(name=name, loader=None, origin=fname)
+
+    def test_simple(self):
+        """Check that we can load a reasonably straightforward lib"""
+        m = self._mkmod('foo', '''
+        LIBNAME = "foo"
+        LIBEACH = float('-inf')
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        LIBANANA = True
+        ''')
+        lib = ops.lib._parse_lib(m)
+        self.assertEqual(lib, ops.lib._Lib(None, "foo", "alice@example.com", 2, 42))
+        # also check the repr while we're at it
+        self.assertEqual(repr(lib), '<_Lib foo by alice@example.com, API 2, patch 42>')
+
+    def test_libauthor_has_dashes(self):
+        m = self._mkmod('foo', '''
+        LIBNAME = "foo"
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice-someone@example.com"
+        LIBANANA = True
+        ''')
+        lib = ops.lib._parse_lib(m)
+        self.assertEqual(lib, ops.lib._Lib(None, "foo", "alice-someone@example.com", 2, 42))
+        # also check the repr while we're at it
+        self.assertEqual(repr(lib), '<_Lib foo by alice-someone@example.com, API 2, patch 42>')
+
+    def test_lib_definitions_without_spaces(self):
+        m = self._mkmod('foo', '''
+        LIBNAME="foo"
+        LIBAPI=2
+        LIBPATCH=42
+        LIBAUTHOR="alice@example.com"
+        LIBANANA=True
+        ''')
+        lib = ops.lib._parse_lib(m)
+        self.assertEqual(lib, ops.lib._Lib(None, "foo", "alice@example.com", 2, 42))
+        # also check the repr while we're at it
+        self.assertEqual(repr(lib), '<_Lib foo by alice@example.com, API 2, patch 42>')
+
+    def test_lib_definitions_trailing_comments(self):
+        m = self._mkmod('foo', '''
+        LIBNAME = "foo" # comment style 1
+        LIBAPI = 2 = comment style 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"anything after the quote is a comment
+        LIBANANA = True
+        ''')
+        lib = ops.lib._parse_lib(m)
+        self.assertEqual(lib, ops.lib._Lib(None, "foo", "alice@example.com", 2, 42))
+        # also check the repr while we're at it
+        self.assertEqual(repr(lib), '<_Lib foo by alice@example.com, API 2, patch 42>')
+
+    def test_incomplete(self):
+        """Check that if anything is missing, nothing is returned"""
+        m = self._mkmod('foo', '''
+        LIBNAME = "foo"
+        LIBAPI = 2
+        LIBPATCH = 42
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_too_long(self):
+        """Check that if the file is too long, nothing is returned"""
+        m = self._mkmod('foo', '\n' * ops.lib._MAX_LIB_LINES + '''
+        LIBNAME = "foo"
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_no_origin(self):
+        """Check that _parse_lib doesn't choke when given a spec with no origin"""
+        # 'just don't crash'
+        lib = ops.lib._parse_lib(ModuleSpec(name='hi', loader=None, origin=None))
+        self.assertIsNone(lib)
+
+    def test_bogus_origin(self):
+        """Check that if the origin is messed up, we don't crash"""
+        # 'just don't crash'
+        lib = ops.lib._parse_lib(ModuleSpec(name='hi', loader=None, origin='/'))
+        self.assertIsNone(lib)
+
+    def test_bogus_lib(self):
+        """Check our behaviour when the lib is messed up"""
+        # note the syntax error (that is carefully chosen to pass the initial regexp)
+        m = self._mkmod('foo', '''
+        LIBNAME = "1'
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_name_is_number(self):
+        """Check our behaviour when the name in the lib is a number"""
+        m = self._mkmod('foo', '''
+        LIBNAME = 1
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_api_is_string(self):
+        """Check our behaviour when the api in the lib is a string"""
+        m = self._mkmod('foo', '''
+        LIBNAME = 'foo'
+        LIBAPI = '2'
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_patch_is_string(self):
+        """Check our behaviour when the patch in the lib is a string"""
+        m = self._mkmod('foo', '''
+        LIBNAME = 'foo'
+        LIBAPI = 2
+        LIBPATCH = '42'
+        LIBAUTHOR = "alice@example.com"
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_author_is_number(self):
+        """Check our behaviour when the author in the lib is a number"""
+        m = self._mkmod('foo', '''
+        LIBNAME = 'foo'
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = 43
+        ''')
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+    def test_other_encoding(self):
+        """Check that we don't crash when a library is not UTF-8"""
+        m = self._mkmod('foo')
+        with open(m.origin, 'wt', encoding='latin-1') as f:
+            f.write(dedent('''
+            LIBNAME = "foo"
+            LIBAPI = 2
+            LIBPATCH = 42
+            LIBAUTHOR = "alice@example.com"
+            LIBANANA = "Ñoño"
+            '''))
+        self.assertIsNone(ops.lib._parse_lib(m))
+
+
+class TestLib(TestCase):
+
+    def test_lib_comparison(self):
+        self.assertNotEqual(
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 0),
+            ops.lib._Lib(None, "bar", "bob@example.com", 0, 1))
+        self.assertEqual(
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1),
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1))
+
+        self.assertLess(
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 0),
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1))
+        self.assertLess(
+            ops.lib._Lib(None, "foo", "alice@example.com", 0, 1),
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1))
+        self.assertLess(
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1),
+            ops.lib._Lib(None, "foo", "bob@example.com", 1, 1))
+        self.assertLess(
+            ops.lib._Lib(None, "bar", "alice@example.com", 1, 1),
+            ops.lib._Lib(None, "foo", "alice@example.com", 1, 1))
+
+        with self.assertRaises(TypeError):
+            42 < ops.lib._Lib(None, "bar", "alice@example.com", 1, 1)
+        with self.assertRaises(TypeError):
+            ops.lib._Lib(None, "bar", "alice@example.com", 1, 1) < 42
+
+        # these two might be surprising in that they don't raise an exception,
+        # but they are correct: our __eq__ bailing means Python falls back to
+        # its default of checking object identity.
+        self.assertNotEqual(ops.lib._Lib(None, "bar", "alice@example.com", 1, 1), 42)
+        self.assertNotEqual(42, ops.lib._Lib(None, "bar", "alice@example.com", 1, 1))
+
+    def test_lib_order(self):
+        a = ops.lib._Lib(None, "bar", "alice@example.com", 1, 0)
+        b = ops.lib._Lib(None, "bar", "alice@example.com", 1, 1)
+        c = ops.lib._Lib(None, "foo", "alice@example.com", 1, 0)
+        d = ops.lib._Lib(None, "foo", "alice@example.com", 1, 1)
+        e = ops.lib._Lib(None, "foo", "bob@example.com", 1, 1)
+
+        for i in range(20):
+            with self.subTest(i):
+                libs = [a, b, c, d, e]
+                shuffle(libs)
+                self.assertEqual(sorted(libs), [a, b, c, d, e])
+
+    def test_use_bad_args_types(self):
+        with self.assertRaises(TypeError):
+            ops.lib.use(1, 2, 'bob@example.com')
+        with self.assertRaises(TypeError):
+            ops.lib.use('foo', '2', 'bob@example.com')
+        with self.assertRaises(TypeError):
+            ops.lib.use('foo', 2, ops.lib.use)
+
+    def test_use_bad_args_values(self):
+        with self.assertRaises(ValueError):
+            ops.lib.use('--help', 2, 'alice@example.com')
+        with self.assertRaises(ValueError):
+            ops.lib.use('foo', -2, 'alice@example.com')
+        with self.assertRaises(ValueError):
+            ops.lib.use('foo', 1, 'example.com')
+
+
+@patch('sys.path', new=())
+class TestLibFunctional(TestCase):
+
+    def _mkdtemp(self) -> str:
+        tmpdir = mkdtemp()
+        self.addCleanup(rmtree, tmpdir)
+        return tmpdir
+
+    def test_use_finds_subs(self):
+        """Test that ops.lib.use("baz") works when baz is inside a package in the python path."""
+        tmpdir = self._mkdtemp()
+        sys.path = [tmpdir]
+
+        _mklib(tmpdir, "foo", "bar").write_text(dedent("""
+        LIBNAME = "baz"
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        """))
+
+        # autoimport to reset things
+        ops.lib.autoimport()
+
+        # ops.lib.use done by charm author
+        baz = ops.lib.use('baz', 2, 'alice@example.com')
+        self.assertEqual(baz.LIBNAME, 'baz')
+        self.assertEqual(baz.LIBAPI, 2)
+        self.assertEqual(baz.LIBPATCH, 42)
+        self.assertEqual(baz.LIBAUTHOR, 'alice@example.com')
+
+    def test_use_finds_best_same_toplevel(self):
+        """Test that ops.lib.use("baz") works when there are two baz in the same toplevel."""
+
+        pkg_b = "foo"
+        lib_b = "bar"
+        patch_b = 40
+        for pkg_a in ["foo", "fooA"]:
+            for lib_a in ["bar", "barA"]:
+                if (pkg_a, lib_a) == (pkg_b, lib_b):
+                    # everything-is-the-same :-)
+                    continue
+                for patch_a in [38, 42]:
+                    desc = "A: {}/{}/{}; B: {}/{}/{}".format(
+                        pkg_a, lib_a, patch_a, pkg_b, lib_b, patch_b)
+                    with self.subTest(desc):
+                        tmpdir = self._mkdtemp()
+                        sys.path = [tmpdir]
+
+                        _mklib(tmpdir, pkg_a, lib_a).write_text(dedent("""
+                        LIBNAME = "baz"
+                        LIBAPI = 2
+                        LIBPATCH = {}
+                        LIBAUTHOR = "alice@example.com"
+                        """).format(patch_a))
+
+                        _mklib(tmpdir, pkg_b, lib_b).write_text(dedent("""
+                        LIBNAME = "baz"
+                        LIBAPI = 2
+                        LIBPATCH = {}
+                        LIBAUTHOR = "alice@example.com"
+                        """).format(patch_b))
+
+                        # autoimport to reset things
+                        ops.lib.autoimport()
+
+                        # ops.lib.use done by charm author
+                        baz = ops.lib.use('baz', 2, 'alice@example.com')
+                        self.assertEqual(baz.LIBNAME, 'baz')
+                        self.assertEqual(baz.LIBAPI, 2)
+                        self.assertEqual(baz.LIBPATCH, max(patch_a, patch_b))
+                        self.assertEqual(baz.LIBAUTHOR, 'alice@example.com')
+
+    def test_use_finds_best_diff_toplevel(self):
+        """Test that ops.lib.use("baz") works when there are two baz in the different toplevels."""
+
+        pkg_b = "foo"
+        lib_b = "bar"
+        patch_b = 40
+        for pkg_a in ["foo", "fooA"]:
+            for lib_a in ["bar", "barA"]:
+                for patch_a in [38, 42]:
+                    desc = "A: {}/{}/{}; B: {}/{}/{}".format(
+                        pkg_a, lib_a, patch_a, pkg_b, lib_b, patch_b)
+                    with self.subTest(desc):
+                        tmpdirA = self._mkdtemp()
+                        tmpdirB = self._mkdtemp()
+                        sys.path = [tmpdirA, tmpdirB]
+
+                        _mklib(tmpdirA, pkg_a, lib_a).write_text(dedent("""
+                        LIBNAME = "baz"
+                        LIBAPI = 2
+                        LIBPATCH = {}
+                        LIBAUTHOR = "alice@example.com"
+                        """).format(patch_a))
+
+                        _mklib(tmpdirB, pkg_b, lib_b).write_text(dedent("""
+                        LIBNAME = "baz"
+                        LIBAPI = 2
+                        LIBPATCH = {}
+                        LIBAUTHOR = "alice@example.com"
+                        """).format(patch_b))
+
+                        # autoimport to reset things
+                        ops.lib.autoimport()
+
+                        # ops.lib.use done by charm author
+                        baz = ops.lib.use('baz', 2, 'alice@example.com')
+                        self.assertEqual(baz.LIBNAME, 'baz')
+                        self.assertEqual(baz.LIBAPI, 2)
+                        self.assertEqual(baz.LIBPATCH, max(patch_a, patch_b))
+                        self.assertEqual(baz.LIBAUTHOR, 'alice@example.com')
+
+    def test_none_found(self):
+        with self.assertRaises(ImportError):
+            ops.lib.use('foo', 1, 'alice@example.com')
+
+    def test_from_scratch(self):
+        tmpdir = self._mkdtemp()
+        sys.path = [tmpdir]
+
+        _mklib(tmpdir, "foo", "bar").write_text(dedent("""
+        LIBNAME = "baz"
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        """))
+
+        # hard reset
+        ops.lib._libraries = None
+
+        # sanity check that ops.lib.use works
+        baz = ops.lib.use('baz', 2, 'alice@example.com')
+        self.assertEqual(baz.LIBAPI, 2)
+
+    def test_others_found(self):
+        tmpdir = self._mkdtemp()
+        sys.path = [tmpdir]
+
+        _mklib(tmpdir, "foo", "bar").write_text(dedent("""
+        LIBNAME = "baz"
+        LIBAPI = 2
+        LIBPATCH = 42
+        LIBAUTHOR = "alice@example.com"
+        """))
+
+        # reload
+        ops.lib.autoimport()
+
+        # sanity check that ops.lib.use works
+        baz = ops.lib.use('baz', 2, 'alice@example.com')
+        self.assertEqual(baz.LIBAPI, 2)
+
+        with self.assertRaises(ImportError):
+            ops.lib.use('baz', 1, 'alice@example.com')
+
+        with self.assertRaises(ImportError):
+            ops.lib.use('baz', 2, 'bob@example.com')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_log.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_log.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7f74d5c901ffb7833c1e5523f9f69a1959999e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_log.py
@@ -0,0 +1,140 @@
+#!/usr/bin/python3
+
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import io
+import unittest
+from unittest.mock import patch
+import importlib
+
+import logging
+import ops.log
+
+
+class FakeModelBackend:
+
+    def __init__(self):
+        self._calls = []
+
+    def calls(self, clear=False):
+        calls = self._calls
+        if clear:
+            self._calls = []
+        return calls
+
+    def juju_log(self, message, level):
+        self._calls.append((message, level))
+
+
+def reset_logging():
+    logging.shutdown()
+    importlib.reload(logging)
+
+
+class TestLogging(unittest.TestCase):
+
+    def setUp(self):
+        self.backend = FakeModelBackend()
+
+        reset_logging()
+        self.addCleanup(reset_logging)
+
+    def test_default_logging(self):
+        ops.log.setup_root_logging(self.backend)
+
+        logger = logging.getLogger()
+        self.assertEqual(logger.level, logging.DEBUG)
+        self.assertIsInstance(logger.handlers[0], ops.log.JujuLogHandler)
+
+        test_cases = [(
+            lambda: logger.critical('critical'), [('CRITICAL', 'critical')]
+        ), (
+            lambda: logger.error('error'), [('ERROR', 'error')]
+        ), (
+            lambda: logger.warning('warning'), [('WARNING', 'warning')]
+        ), (
+            lambda: logger.info('info'), [('INFO', 'info')]
+        ), (
+            lambda: logger.debug('debug'), [('DEBUG', 'debug')]
+        )]
+
+        for do, res in test_cases:
+            do()
+            calls = self.backend.calls(clear=True)
+            self.assertEqual(calls, res)
+
+    def test_handler_filtering(self):
+        logger = logging.getLogger()
+        logger.setLevel(logging.INFO)
+        logger.addHandler(ops.log.JujuLogHandler(self.backend, logging.WARNING))
+        logger.info('foo')
+        self.assertEqual(self.backend.calls(), [])
+        logger.warning('bar')
+        self.assertEqual(self.backend.calls(), [('WARNING', 'bar')])
+
+    def test_no_stderr_without_debug(self):
+        buffer = io.StringIO()
+        with patch('sys.stderr', buffer):
+            ops.log.setup_root_logging(self.backend, debug=False)
+            logger = logging.getLogger()
+            logger.debug('debug message')
+            logger.info('info message')
+            logger.warning('warning message')
+            logger.critical('critical message')
+        self.assertEqual(
+            self.backend.calls(),
+            [('DEBUG', 'debug message'),
+             ('INFO', 'info message'),
+                ('WARNING', 'warning message'),
+                ('CRITICAL', 'critical message'),
+             ])
+        self.assertEqual(buffer.getvalue(), "")
+
+    def test_debug_logging(self):
+        buffer = io.StringIO()
+        with patch('sys.stderr', buffer):
+            ops.log.setup_root_logging(self.backend, debug=True)
+            logger = logging.getLogger()
+            logger.debug('debug message')
+            logger.info('info message')
+            logger.warning('warning message')
+            logger.critical('critical message')
+        self.assertEqual(
+            self.backend.calls(),
+            [('DEBUG', 'debug message'),
+             ('INFO', 'info message'),
+             ('WARNING', 'warning message'),
+             ('CRITICAL', 'critical message'),
+             ])
+        self.assertRegex(
+            buffer.getvalue(),
+            r"\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d,\d\d\d DEBUG    debug message\n"
+            r"\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d,\d\d\d INFO     info message\n"
+            r"\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d,\d\d\d WARNING  warning message\n"
+            r"\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d,\d\d\d CRITICAL critical message\n"
+        )
+
+    def test_reduced_logging(self):
+        ops.log.setup_root_logging(self.backend)
+        logger = logging.getLogger()
+        logger.setLevel(logging.WARNING)
+        logger.debug('debug')
+        logger.info('info')
+        logger.warning('warning')
+        self.assertEqual(self.backend.calls(), [('WARNING', 'warning')])
+
+
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_main.py
new file mode 100755
index 0000000000000000000000000000000000000000..f62c859332d672fb4140488f2c9f1ad3841b30eb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_main.py
@@ -0,0 +1,878 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import abc
+import base64
+import logging
+import os
+import pickle
+import shutil
+import subprocess
+import sys
+import tempfile
+import unittest
+import importlib.util
+import warnings
+from pathlib import Path
+from unittest.mock import patch
+
+from ops.charm import (
+    CharmBase,
+    CharmEvents,
+    HookEvent,
+    InstallEvent,
+    StartEvent,
+    ConfigChangedEvent,
+    UpgradeCharmEvent,
+    UpdateStatusEvent,
+    LeaderSettingsChangedEvent,
+    RelationJoinedEvent,
+    RelationChangedEvent,
+    RelationDepartedEvent,
+    RelationBrokenEvent,
+    RelationEvent,
+    StorageAttachedEvent,
+    ActionEvent,
+    CollectMetricsEvent,
+)
+from ops.main import main
+from ops.version import version
+
+from .test_helpers import fake_script, fake_script_calls
+
+# This relies on the expected repository structure to find a path to
+# source of the charm under test.
+TEST_CHARM_DIR = Path(__file__ + '/../charms/test_main').resolve()
+
+VERSION_LOGLINE = [
+    'juju-log', '--log-level', 'DEBUG',
+    'Operator Framework {} up and running.'.format(version),
+]
+logger = logging.getLogger(__name__)
+
+
+class SymlinkTargetError(Exception):
+    pass
+
+
+class EventSpec:
+    def __init__(self, event_type, event_name, env_var=None,
+                 relation_id=None, remote_app=None, remote_unit=None,
+                 charm_config=None, model_name=None):
+        self.event_type = event_type
+        self.event_name = event_name
+        self.env_var = env_var
+        self.relation_id = relation_id
+        self.remote_app = remote_app
+        self.remote_unit = remote_unit
+        self.charm_config = charm_config
+        self.model_name = model_name
+
+
+class CharmInitTestCase(unittest.TestCase):
+
+    def _check(self, charm_class):
+        """Helper for below tests."""
+        fake_environ = {
+            'JUJU_UNIT_NAME': 'test_main/0',
+            'JUJU_MODEL_NAME': 'mymodel',
+        }
+        with patch.dict(os.environ, fake_environ):
+            with patch('ops.main._emit_charm_event'):
+                with patch('ops.main._get_charm_dir') as mock_charmdir:
+                    with tempfile.TemporaryDirectory() as tmpdirname:
+                        tmpdirname = Path(tmpdirname)
+                        fake_metadata = tmpdirname / 'metadata.yaml'
+                        with fake_metadata.open('wb') as fh:
+                            fh.write(b'name: test')
+                        mock_charmdir.return_value = tmpdirname
+
+                        with warnings.catch_warnings(record=True) as warnings_cm:
+                            main(charm_class)
+
+        return warnings_cm
+
+    def test_init_signature_passthrough(self):
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+
+        warn_cm = self._check(MyCharm)
+        self.assertFalse(warn_cm)
+
+    def test_init_signature_both_arguments(self):
+        class MyCharm(CharmBase):
+
+            def __init__(self, framework, somekey):
+                super().__init__(framework, somekey)
+
+        warn_cm = self._check(MyCharm)
+        self.assertEqual(len(warn_cm), 1)
+        (warn,) = warn_cm
+        self.assertTrue(issubclass(warn.category, DeprecationWarning))
+        self.assertEqual(str(warn.message), (
+            "the second argument, 'key', has been deprecated and will be removed "
+            "after the 0.7 release"))
+
+    def test_init_signature_only_framework(self):
+        class MyCharm(CharmBase):
+
+            def __init__(self, framework):
+                super().__init__(framework)
+
+        warn_cm = self._check(MyCharm)
+        self.assertFalse(warn_cm)
+
+
+class _TestMain(abc.ABC):
+
+    @abc.abstractmethod
+    def _setup_entry_point(self, directory, entry_point):
+        """Set up the given entry point in the given directory.
+
+        If not using dispatch, that would be a symlink <dir>/<entry_point>
+        pointing at src/charm.py; if using dispatch that would be the dispatch
+        symlink. It could also not be a symlink...
+        """
+        return NotImplemented
+
+    @abc.abstractmethod
+    def _call_event(self, rel_path, env):
+        """Set up the environment and call (i.e. run) the given event."""
+        return NotImplemented
+
+    @abc.abstractmethod
+    def test_setup_event_links(self):
+        """Test auto-creation of symlinks caused by initial events.
+
+        Depending on the combination of dispatch and non-dispatch, this should
+        be checking for the creation or the _lack_ of creation, as appropriate.
+        """
+        return NotImplemented
+
+    def setUp(self):
+        self._setup_charm_dir()
+
+        _, tmp_file = tempfile.mkstemp(dir=str(self._tmpdir))
+        self._state_file = Path(tmp_file)
+
+        # Relations events are defined dynamically and modify the class attributes.
+        # We use a subclass temporarily to prevent these side effects from leaking.
+        class TestCharmEvents(CharmEvents):
+            pass
+        CharmBase.on = TestCharmEvents()
+
+        def cleanup():
+            CharmBase.on = CharmEvents()
+        self.addCleanup(cleanup)
+
+        fake_script(self, 'juju-log', "exit 0")
+
+        # set to something other than None for tests that care
+        self.stdout = None
+        self.stderr = None
+
+    def _setup_charm_dir(self):
+        self._tmpdir = Path(tempfile.mkdtemp(prefix='tmp-ops-test-'))
+        self.addCleanup(shutil.rmtree, str(self._tmpdir))
+        self.JUJU_CHARM_DIR = self._tmpdir / 'test_main'
+        self.hooks_dir = self.JUJU_CHARM_DIR / 'hooks'
+        charm_path = str(self.JUJU_CHARM_DIR / 'src/charm.py')
+        self.charm_exec_path = os.path.relpath(charm_path,
+                                               str(self.hooks_dir))
+        shutil.copytree(str(TEST_CHARM_DIR), str(self.JUJU_CHARM_DIR))
+
+        charm_spec = importlib.util.spec_from_file_location("charm", charm_path)
+        self.charm_module = importlib.util.module_from_spec(charm_spec)
+        charm_spec.loader.exec_module(self.charm_module)
+
+        self._prepare_initial_hooks()
+
+    def _prepare_initial_hooks(self):
+        initial_hooks = ('install', 'start', 'upgrade-charm', 'disks-storage-attached')
+        self.hooks_dir.mkdir()
+        for hook in initial_hooks:
+            self._setup_entry_point(self.hooks_dir, hook)
+
+    def _prepare_actions(self):
+        # TODO: jam 2020-06-16 this same work could be done just triggering the 'install' event
+        #  of the charm, it might be cleaner to not set up entry points directly here.
+        actions_dir_name = 'actions'
+        actions_dir = self.JUJU_CHARM_DIR / actions_dir_name
+        actions_dir.mkdir()
+        for action_name in ('start', 'foo-bar', 'get-model-name', 'get-status'):
+            self._setup_entry_point(actions_dir, action_name)
+
+    def _read_and_clear_state(self):
+        state = None
+        if self._state_file.stat().st_size:
+            with self._state_file.open('r+b') as state_file:
+                state = pickle.load(state_file)
+                state_file.truncate(0)
+        return state
+
+    def _simulate_event(self, event_spec):
+        ppath = Path(__file__).parent
+        pypath = str(ppath.parent)
+        if 'PYTHONPATH' in os.environ:
+            pypath += ':' + os.environ['PYTHONPATH']
+        env = {
+            'PATH': "{}:{}".format(ppath / 'bin', os.environ['PATH']),
+            'PYTHONPATH': pypath,
+            'JUJU_CHARM_DIR': str(self.JUJU_CHARM_DIR),
+            'JUJU_UNIT_NAME': 'test_main/0',
+            'CHARM_CONFIG': event_spec.charm_config,
+        }
+        if issubclass(event_spec.event_type, RelationEvent):
+            rel_name = event_spec.event_name.split('_')[0]
+            env.update({
+                'JUJU_RELATION': rel_name,
+                'JUJU_RELATION_ID': str(event_spec.relation_id),
+            })
+            remote_app = event_spec.remote_app
+            # For juju < 2.7 app name is extracted from JUJU_REMOTE_UNIT.
+            if remote_app is not None:
+                env['JUJU_REMOTE_APP'] = remote_app
+
+            remote_unit = event_spec.remote_unit
+            if remote_unit is None:
+                remote_unit = ''
+
+            env['JUJU_REMOTE_UNIT'] = remote_unit
+        else:
+            env.update({
+                'JUJU_REMOTE_UNIT': '',
+                'JUJU_REMOTE_APP': '',
+            })
+        if issubclass(event_spec.event_type, ActionEvent):
+            event_filename = event_spec.event_name[:-len('_action')].replace('_', '-')
+            env.update({
+                event_spec.env_var: event_filename,
+            })
+            if event_spec.env_var == 'JUJU_ACTION_NAME':
+                event_dir = 'actions'
+            else:
+                raise RuntimeError('invalid envar name specified for a action event')
+        else:
+            event_filename = event_spec.event_name.replace('_', '-')
+            event_dir = 'hooks'
+        if event_spec.model_name is not None:
+            env['JUJU_MODEL_NAME'] = event_spec.model_name
+
+        self._call_event(Path(event_dir, event_filename), env)
+        return self._read_and_clear_state()
+
+    def test_event_reemitted(self):
+        # base64 encoding is used to avoid null bytes.
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        # First run "install" to make sure all hooks are set up.
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+        state = self._simulate_event(EventSpec(ConfigChangedEvent, 'config-changed',
+                                               charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [ConfigChangedEvent])
+
+        # Re-emit should pick the deferred config-changed.
+        state = self._simulate_event(EventSpec(UpdateStatusEvent, 'update-status',
+                                               charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [ConfigChangedEvent, UpdateStatusEvent])
+
+    def test_no_reemission_on_collect_metrics(self):
+        # base64 encoding is used to avoid null bytes.
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        fake_script(self, 'add-metric', 'exit 0')
+
+        # First run "install" to make sure all hooks are set up.
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+        state = self._simulate_event(EventSpec(ConfigChangedEvent, 'config-changed',
+                                               charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [ConfigChangedEvent])
+
+        # Re-emit should not pick the deferred config-changed because
+        # collect-metrics runs in a restricted context.
+        state = self._simulate_event(EventSpec(CollectMetricsEvent, 'collect-metrics',
+                                               charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [CollectMetricsEvent])
+
+    def test_multiple_events_handled(self):
+        self._prepare_actions()
+
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        actions_charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'USE_ACTIONS': True,
+        }))
+
+        fake_script(self, 'action-get', "echo '{}'")
+
+        # Sample events with a different amount of dashes used
+        # and with endpoints from different sections of metadata.yaml
+        events_under_test = [(
+            EventSpec(InstallEvent, 'install',
+                      charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(StartEvent, 'start',
+                      charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(UpdateStatusEvent, 'update_status',
+                      charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(LeaderSettingsChangedEvent, 'leader_settings_changed',
+                      charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(RelationJoinedEvent, 'db_relation_joined',
+                      relation_id=1,
+                      remote_app='remote', remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'db',
+             'relation_id': 1,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed',
+                      relation_id=2,
+                      remote_app='remote', remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'mon',
+             'relation_id': 2,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed',
+                      relation_id=2,
+                      remote_app='remote', remote_unit=None,
+                      charm_config=charm_config),
+            {'relation_name': 'mon',
+             'relation_id': 2,
+             'app_name': 'remote',
+             'unit_name': None},
+        ), (
+            EventSpec(RelationDepartedEvent, 'mon_relation_departed',
+                      relation_id=2,
+                      remote_app='remote', remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'mon',
+             'relation_id': 2,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationBrokenEvent, 'ha_relation_broken',
+                      relation_id=3,
+                      charm_config=charm_config),
+            {'relation_name': 'ha',
+             'relation_id': 3},
+        ), (
+            # Events without a remote app specified (for Juju < 2.7).
+            EventSpec(RelationJoinedEvent, 'db_relation_joined',
+                      relation_id=1,
+                      remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'db',
+             'relation_id': 1,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed',
+                      relation_id=2,
+                      remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'mon',
+             'relation_id': 2,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationDepartedEvent, 'mon_relation_departed',
+                      relation_id=2,
+                      remote_unit='remote/0',
+                      charm_config=charm_config),
+            {'relation_name': 'mon',
+             'relation_id': 2,
+             'app_name': 'remote',
+             'unit_name': 'remote/0'},
+        ), (
+            EventSpec(ActionEvent, 'start_action',
+                      env_var='JUJU_ACTION_NAME',
+                      charm_config=actions_charm_config),
+            {},
+        ), (
+            EventSpec(ActionEvent, 'foo_bar_action',
+                      env_var='JUJU_ACTION_NAME',
+                      charm_config=actions_charm_config),
+            {},
+        )]
+
+        logger.debug('Expected events %s', events_under_test)
+
+        # First run "install" to make sure all hooks are set up.
+        self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+
+        # Simulate hook executions for every event.
+        for event_spec, expected_event_data in events_under_test:
+            state = self._simulate_event(event_spec)
+
+            state_key = 'on_' + event_spec.event_name
+            handled_events = state.get(state_key, [])
+
+            # Make sure that a handler for that event was called once.
+            self.assertEqual(len(handled_events), 1)
+            # Make sure the event handled by the Charm has the right type.
+            handled_event_type = handled_events[0]
+            self.assertEqual(handled_event_type, event_spec.event_type)
+
+            self.assertEqual(state['observed_event_types'], [event_spec.event_type])
+
+            if event_spec.event_name in expected_event_data:
+                self.assertEqual(state[event_spec.event_name + '_data'],
+                                 expected_event_data[event_spec.event_name])
+
+    def test_event_not_implemented(self):
+        """Make sure events without implementation do not cause non-zero exit.
+        """
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        # Simulate a scenario where there is a symlink for an event that
+        # a charm does not know how to handle.
+        hook_path = self.JUJU_CHARM_DIR / 'hooks/not-implemented-event'
+        # This will be cleared up in tearDown.
+        hook_path.symlink_to('install')
+
+        try:
+            self._simulate_event(EventSpec(HookEvent, 'not-implemented-event',
+                                           charm_config=charm_config))
+        except subprocess.CalledProcessError:
+            self.fail('Event simulation for an unsupported event'
+                      ' results in a non-zero exit code returned')
+
+    def test_collect_metrics(self):
+        indicator_file = self.JUJU_CHARM_DIR / 'indicator'
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'INDICATOR_FILE': indicator_file
+        }))
+        fake_script(self, 'add-metric', 'exit 0')
+        fake_script(self, 'juju-log', 'exit 0')
+        self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        # Clear the calls during 'install'
+        fake_script_calls(self, clear=True)
+        self._simulate_event(EventSpec(CollectMetricsEvent, 'collect_metrics',
+                                       charm_config=charm_config))
+
+        expected = [
+            VERSION_LOGLINE,
+            ['juju-log', '--log-level', 'DEBUG', 'Emitting Juju event collect_metrics.'],
+            ['add-metric', '--labels', 'bar=4.2', 'foo=42'],
+        ]
+        calls = fake_script_calls(self)
+
+        if self.has_dispatch:
+            expected.insert(1, [
+                'juju-log', '--log-level', 'DEBUG',
+                'Legacy hooks/collect-metrics does not exist.'])
+
+        self.assertEqual(calls, expected)
+
+    def test_logger(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'USE_LOG_ACTIONS': True,
+        }))
+        fake_script(self, 'action-get', "echo '{}'")
+
+        test_cases = [(
+            EventSpec(ActionEvent, 'log_critical_action', env_var='JUJU_ACTION_NAME',
+                      charm_config=charm_config),
+            ['juju-log', '--log-level', 'CRITICAL', 'super critical'],
+        ), (
+            EventSpec(ActionEvent, 'log_error_action',
+                      env_var='JUJU_ACTION_NAME',
+                      charm_config=charm_config),
+            ['juju-log', '--log-level', 'ERROR', 'grave error'],
+        ), (
+            EventSpec(ActionEvent, 'log_warning_action',
+                      env_var='JUJU_ACTION_NAME',
+                      charm_config=charm_config),
+            ['juju-log', '--log-level', 'WARNING', 'wise warning'],
+        ), (
+            EventSpec(ActionEvent, 'log_info_action',
+                      env_var='JUJU_ACTION_NAME',
+                      charm_config=charm_config),
+            ['juju-log', '--log-level', 'INFO', 'useful info'],
+        )]
+
+        # Set up action symlinks.
+        self._simulate_event(EventSpec(InstallEvent, 'install',
+                                       charm_config=charm_config))
+
+        for event_spec, calls in test_cases:
+            self._simulate_event(event_spec)
+            self.assertIn(calls, fake_script_calls(self, clear=True))
+
+    def test_excepthook(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'TRY_EXCEPTHOOK': True,
+        }))
+        with self.assertRaises(subprocess.CalledProcessError):
+            self._simulate_event(EventSpec(InstallEvent, 'install',
+                                           charm_config=charm_config))
+
+        calls = [' '.join(i) for i in fake_script_calls(self)]
+
+        self.assertEqual(calls.pop(0), ' '.join(VERSION_LOGLINE))
+
+        if self.has_dispatch:
+            self.assertEqual(
+                calls.pop(0),
+                'juju-log --log-level DEBUG Legacy hooks/install does not exist.')
+
+        self.maxDiff = None
+        self.assertRegex(
+            calls[0],
+            '(?ms)juju-log --log-level ERROR Uncaught exception while in charm code:\n'
+            'Traceback .most recent call last.:\n'
+            '  .*'
+            '    raise RuntimeError."failing as requested".\n'
+            'RuntimeError: failing as requested'
+        )
+        self.assertEqual(len(calls), 1, "expected 1 call, but got extra: {}".format(calls[1:]))
+
+    def test_sets_model_name(self):
+        self._prepare_actions()
+
+        actions_charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'USE_ACTIONS': True,
+        }))
+
+        fake_script(self, 'action-get', "echo '{}'")
+        state = self._simulate_event(EventSpec(
+            ActionEvent, 'get_model_name_action',
+            env_var='JUJU_ACTION_NAME',
+            model_name='test-model-name',
+            charm_config=actions_charm_config))
+        self.assertIsNotNone(state)
+        self.assertEqual(state['_on_get_model_name_action'], ['test-model-name'])
+
+    def test_has_valid_status(self):
+        self._prepare_actions()
+
+        actions_charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'USE_ACTIONS': True,
+        }))
+
+        fake_script(self, 'action-get', "echo '{}'")
+        fake_script(self, 'status-get', """echo '{"status": "unknown", "message": ""}'""")
+        state = self._simulate_event(EventSpec(
+            ActionEvent, 'get_status_action',
+            env_var='JUJU_ACTION_NAME',
+            charm_config=actions_charm_config))
+        self.assertIsNotNone(state)
+        self.assertEqual(state['status_name'], 'unknown')
+        self.assertEqual(state['status_message'], '')
+        fake_script(
+            self, 'status-get', """echo '{"status": "blocked", "message": "help meeee"}'""")
+        state = self._simulate_event(EventSpec(
+            ActionEvent, 'get_status_action',
+            env_var='JUJU_ACTION_NAME',
+            charm_config=actions_charm_config))
+        self.assertIsNotNone(state)
+        self.assertEqual(state['status_name'], 'blocked')
+        self.assertEqual(state['status_message'], 'help meeee')
+
+    def test_foo(self):
+        # base64 encoding is used to avoid null bytes.
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        # First run "install" to make sure all hooks are set up.
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+
+class TestMainWithNoDispatch(_TestMain, unittest.TestCase):
+    has_dispatch = False
+    hooks_are_symlinks = True
+
+    def _setup_entry_point(self, directory, entry_point):
+        path = directory / entry_point
+        path.symlink_to(self.charm_exec_path)
+
+    def _call_event(self, rel_path, env):
+        event_file = self.JUJU_CHARM_DIR / rel_path
+        # Note that sys.executable is used to make sure we are using the same
+        # interpreter for the child process to support virtual environments.
+        subprocess.run(
+            [sys.executable, str(event_file)],
+            check=True, env=env, cwd=str(self.JUJU_CHARM_DIR))
+
+    def test_setup_event_links(self):
+        """Test auto-creation of symlinks caused by initial events.
+        """
+        all_event_hooks = ['hooks/' + e.replace("_", "-")
+                           for e in self.charm_module.Charm.on.events().keys()]
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        initial_events = {
+            EventSpec(InstallEvent, 'install', charm_config=charm_config),
+            EventSpec(StorageAttachedEvent, 'disks-storage-attached', charm_config=charm_config),
+            EventSpec(StartEvent, 'start', charm_config=charm_config),
+            EventSpec(UpgradeCharmEvent, 'upgrade-charm', charm_config=charm_config),
+        }
+
+        def _assess_event_links(event_spec):
+            self.assertTrue(self.hooks_dir / event_spec.event_name in self.hooks_dir.iterdir())
+            for event_hook in all_event_hooks:
+                hook_path = self.JUJU_CHARM_DIR / event_hook
+                self.assertTrue(hook_path.exists(), 'Missing hook: ' + event_hook)
+                if self.hooks_are_symlinks:
+                    self.assertEqual(os.readlink(str(hook_path)), self.charm_exec_path)
+
+        for initial_event in initial_events:
+            self._setup_charm_dir()
+
+            self._simulate_event(initial_event)
+            _assess_event_links(initial_event)
+            # Make sure it is idempotent.
+            self._simulate_event(initial_event)
+            _assess_event_links(initial_event)
+
+    def test_setup_action_links(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        # foo-bar is one of the actions defined in actions.yaml
+        action_hook = self.JUJU_CHARM_DIR / 'actions' / 'foo-bar'
+        self.assertTrue(action_hook.exists())
+
+
+class TestMainWithNoDispatchButJujuIsDispatchAware(TestMainWithNoDispatch):
+    def _call_event(self, rel_path, env):
+        env["JUJU_DISPATCH_PATH"] = str(rel_path)
+        super()._call_event(rel_path, env)
+
+
+class TestMainWithNoDispatchButScriptsAreCopies(TestMainWithNoDispatch):
+    hooks_are_symlinks = False
+
+    def _setup_entry_point(self, directory, entry_point):
+        charm_path = str(self.JUJU_CHARM_DIR / 'src/charm.py')
+        path = directory / entry_point
+        shutil.copy(charm_path, str(path))
+
+
+class TestMainWithDispatch(_TestMain, unittest.TestCase):
+    has_dispatch = True
+
+    def _setup_entry_point(self, directory, entry_point):
+        path = self.JUJU_CHARM_DIR / 'dispatch'
+        if not path.exists():
+            path.symlink_to('src/charm.py')
+
+    def _call_event(self, rel_path, env):
+        env["JUJU_DISPATCH_PATH"] = str(rel_path)
+        dispatch = self.JUJU_CHARM_DIR / 'dispatch'
+        subprocess.run(
+            [sys.executable, str(dispatch)],
+            stdout=self.stdout,
+            stderr=self.stderr,
+            check=True, env=env, cwd=str(self.JUJU_CHARM_DIR))
+
+    def test_setup_event_links(self):
+        """Test auto-creation of symlinks caused by initial events does _not_ happen when using dispatch.
+        """
+        all_event_hooks = ['hooks/' + e.replace("_", "-")
+                           for e in self.charm_module.Charm.on.events().keys()]
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        initial_events = {
+            EventSpec(InstallEvent, 'install', charm_config=charm_config),
+            EventSpec(StorageAttachedEvent, 'disks-storage-attached', charm_config=charm_config),
+            EventSpec(StartEvent, 'start', charm_config=charm_config),
+            EventSpec(UpgradeCharmEvent, 'upgrade-charm', charm_config=charm_config),
+        }
+
+        def _assess_event_links(event_spec):
+            self.assertNotIn(self.hooks_dir / event_spec.event_name, self.hooks_dir.iterdir())
+            for event_hook in all_event_hooks:
+                self.assertFalse((self.JUJU_CHARM_DIR / event_hook).exists(),
+                                 'Spurious hook: ' + event_hook)
+
+        for initial_event in initial_events:
+            self._setup_charm_dir()
+
+            self._simulate_event(initial_event)
+            _assess_event_links(initial_event)
+
+    def test_hook_and_dispatch(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        old_path = self.fake_script_path
+        self.fake_script_path = self.hooks_dir
+        fake_script(self, 'install', 'exit 0')
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+
+        # the script was called, *and*, the .on. was called
+        self.assertEqual(fake_script_calls(self), [['install', '']])
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+        self.fake_script_path = old_path
+        self.assertEqual(fake_script_calls(self), [
+            VERSION_LOGLINE,
+            ['juju-log', '--log-level', 'INFO', 'Running legacy hooks/install.'],
+            ['juju-log', '--log-level', 'DEBUG', 'Legacy hooks/install exited with status 0.'],
+            ['juju-log', '--log-level', 'DEBUG', 'Emitting Juju event install.'],
+        ])
+
+    def test_non_executable_hook_and_dispatch(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        (self.hooks_dir / "install").write_text("")
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+        self.assertEqual(fake_script_calls(self), [
+            VERSION_LOGLINE,
+            ['juju-log', '--log-level', 'WARNING',
+             'Legacy hooks/install exists but is not executable.'],
+            ['juju-log', '--log-level', 'DEBUG', 'Emitting Juju event install.'],
+        ])
+
+    def test_hook_and_dispatch_with_failing_hook(self):
+        self.stdout = self.stderr = tempfile.TemporaryFile()
+        self.addCleanup(self.stdout.close)
+
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        old_path = self.fake_script_path
+        self.fake_script_path = self.hooks_dir
+        fake_script(self, 'install', 'exit 42')
+        event = EventSpec(InstallEvent, 'install', charm_config=charm_config)
+        with self.assertRaises(subprocess.CalledProcessError):
+            self._simulate_event(event)
+        self.fake_script_path = old_path
+
+        self.stdout.seek(0)
+        self.assertEqual(self.stdout.read(), b'')
+        calls = fake_script_calls(self)
+        expected = [
+            VERSION_LOGLINE,
+            ['juju-log', '--log-level', 'INFO', 'Running legacy hooks/install.'],
+            ['juju-log', '--log-level', 'WARNING', 'Legacy hooks/install exited with status 42.'],
+        ]
+        self.assertEqual(calls, expected)
+
+    def test_hook_and_dispatch_but_hook_is_dispatch(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        event = EventSpec(InstallEvent, 'install', charm_config=charm_config)
+        hook_path = self.hooks_dir / 'install'
+        for ((rel, ind), path) in {
+                # relative and indirect
+                (True, True): Path('../dispatch'),
+                # relative and direct
+                (True, False): Path(self.charm_exec_path),
+                # absolute and direct
+                (False, False): (self.hooks_dir / self.charm_exec_path).resolve(),
+                # absolute and indirect
+                (False, True): self.JUJU_CHARM_DIR / 'dispatch',
+        }.items():
+            with self.subTest(path=path, rel=rel, ind=ind):
+                # sanity check
+                self.assertEqual(path.is_absolute(), not rel)
+                self.assertEqual(path.name == 'dispatch', ind)
+                try:
+                    hook_path.symlink_to(path)
+
+                    state = self._simulate_event(event)
+
+                    # the .on. was only called once
+                    self.assertEqual(state['observed_event_types'], [InstallEvent])
+                    self.assertEqual(state['on_install'], [InstallEvent])
+                finally:
+                    hook_path.unlink()
+
+    def test_hook_and_dispatch_but_hook_is_dispatch_copy(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        hook_path = self.hooks_dir / 'install'
+        path = (self.hooks_dir / self.charm_exec_path).resolve()
+        shutil.copy(str(path), str(hook_path))
+        fake_script(self, 'juju-log', 'exit 0')
+
+        event = EventSpec(InstallEvent, 'install', charm_config=charm_config)
+        state = self._simulate_event(event)
+
+        # the .on. was only called once
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+        self.assertEqual(state['on_install'], [InstallEvent])
+        self.assertEqual(fake_script_calls(self), [
+            VERSION_LOGLINE,
+            ['juju-log', '--log-level', 'INFO', 'Running legacy hooks/install.'],
+            VERSION_LOGLINE,    # because it called itself
+            ['juju-log', '--log-level', 'DEBUG', 'Charm called itself via hooks/install.'],
+            ['juju-log', '--log-level', 'DEBUG', 'Legacy hooks/install exited with status 0.'],
+            ['juju-log', '--log-level', 'DEBUG', 'Emitting Juju event install.'],
+        ])
+
+
+class TestMainWithDispatchAsScript(TestMainWithDispatch):
+    """Here dispatch is a script that execs the charm.py instead of a symlink.
+    """
+
+    has_dispatch = True
+
+    def _setup_entry_point(self, directory, entry_point):
+        path = self.JUJU_CHARM_DIR / 'dispatch'
+        if not path.exists():
+            path.write_text('#!/bin/sh\nexec "{}" "{}"\n'.format(
+                sys.executable,
+                self.JUJU_CHARM_DIR / 'src/charm.py'))
+            path.chmod(0o755)
+
+    def _call_event(self, rel_path, env):
+        env["JUJU_DISPATCH_PATH"] = str(rel_path)
+        dispatch = self.JUJU_CHARM_DIR / 'dispatch'
+        subprocess.check_call([str(dispatch)],
+                              env=env, cwd=str(self.JUJU_CHARM_DIR))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_model.py
new file mode 100755
index 0000000000000000000000000000000000000000..8415efa76a3b85a1bfe3ef20497ca00987c1d6a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_model.py
@@ -0,0 +1,1329 @@
+#!/usr/bin/python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from collections import OrderedDict
+import json
+import ipaddress
+import os
+import pathlib
+from textwrap import dedent
+import unittest
+
+import ops.model
+import ops.charm
+import ops.testing
+from ops.charm import RelationMeta, RelationRole
+
+from test.test_helpers import fake_script, fake_script_calls
+
+
+class TestModel(unittest.TestCase):
+
+    def setUp(self):
+        self.harness = ops.testing.Harness(ops.charm.CharmBase, meta='''
+            name: myapp
+            provides:
+              db0:
+                interface: db0
+            requires:
+              db1:
+                interface: db1
+            peers:
+              db2:
+                interface: db2
+        ''')
+        self.relation_id_db0 = self.harness.add_relation('db0', 'db')
+        self.model = self.harness.model
+
+    def test_model_attributes(self):
+        self.assertIs(self.model.app, self.model.unit.app)
+        self.assertIsNone(self.model.name)
+
+    def test_model_name_from_backend(self):
+        self.harness.set_model_name('default')
+        m = ops.model.Model(ops.charm.CharmMeta(), self.harness._backend)
+        self.assertEqual(m.name, 'default')
+        with self.assertRaises(AttributeError):
+            m.name = "changes-disallowed"
+
+    def test_relations_keys(self):
+        rel_app1 = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(rel_app1, 'remoteapp1/0')
+        self.harness.add_relation_unit(rel_app1, 'remoteapp1/1')
+        rel_app2 = self.harness.add_relation('db1', 'remoteapp2')
+        self.harness.add_relation_unit(rel_app2, 'remoteapp2/0')
+
+        # We invalidate db1 so that it causes us to reload it
+        self.model.relations._invalidate('db1')
+        self.resetBackendCalls()
+        for relation in self.model.relations['db1']:
+            self.assertIn(self.model.unit, relation.data)
+            unit_from_rel = next(filter(lambda u: u.name == 'myapp/0', relation.data.keys()))
+            self.assertIs(self.model.unit, unit_from_rel)
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', rel_app1),
+            ('relation_list', rel_app2),
+        ])
+
+    def test_get_relation(self):
+        # one relation on db1
+        # two relations on db0
+        # no relations on db2
+        relation_id_db1 = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id_db1, 'remoteapp1/0')
+        relation_id_db0_b = self.harness.add_relation('db0', 'another')
+        self.resetBackendCalls()
+
+        with self.assertRaises(ops.model.ModelError):
+            # You have to specify it by just the integer ID
+            self.model.get_relation('db1', 'db1:{}'.format(relation_id_db1))
+        rel_db1 = self.model.get_relation('db1', relation_id_db1)
+        self.assertIsInstance(rel_db1, ops.model.Relation)
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id_db1),
+        ])
+        dead_rel = self.model.get_relation('db1', 7)
+        self.assertIsInstance(dead_rel, ops.model.Relation)
+        self.assertEqual(set(dead_rel.data.keys()), {self.model.unit, self.model.unit.app})
+        self.assertEqual(dead_rel.data[self.model.unit], {})
+        self.assertBackendCalls([
+            ('relation_list', 7),
+            ('relation_get', 7, 'myapp/0', False),
+        ])
+
+        self.assertIsNone(self.model.get_relation('db2'))
+        self.assertBackendCalls([
+            ('relation_ids', 'db2'),
+        ])
+        self.assertIs(self.model.get_relation('db1'), rel_db1)
+        with self.assertRaises(ops.model.TooManyRelatedAppsError):
+            self.model.get_relation('db0')
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db0'),
+            ('relation_list', self.relation_id_db0),
+            ('relation_list', relation_id_db0_b),
+        ])
+
+    def test_peer_relation_app(self):
+        self.harness.add_relation('db2', 'myapp')
+        rel_dbpeer = self.model.get_relation('db2')
+        self.assertIs(rel_dbpeer.app, self.model.app)
+
+    def test_remote_units_is_our(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/1')
+        self.resetBackendCalls()
+
+        for u in self.model.get_relation('db1').units:
+            self.assertFalse(u._is_our_unit)
+            self.assertFalse(u.app._is_our_app)
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id)
+        ])
+
+    def test_our_unit_is_our(self):
+        self.assertTrue(self.model.unit._is_our_unit)
+        self.assertTrue(self.model.unit.app._is_our_app)
+
+    def test_unit_relation_data(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.update_relation_data(
+            relation_id,
+            'remoteapp1/0',
+            {'host': 'remoteapp1-0'})
+        self.model.relations._invalidate('db1')
+        self.resetBackendCalls()
+
+        random_unit = self.model.get_unit('randomunit/0')
+        with self.assertRaises(KeyError):
+            self.model.get_relation('db1').data[random_unit]
+        remoteapp1_0 = next(filter(lambda u: u.name == 'remoteapp1/0',
+                                   self.model.get_relation('db1').units))
+        self.assertEqual(self.model.get_relation('db1').data[remoteapp1_0],
+                         {'host': 'remoteapp1-0'})
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'remoteapp1/0', False),
+        ])
+
+    def test_remote_app_relation_data(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'remoteapp1', {'secret': 'cafedeadbeef'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/1')
+        self.resetBackendCalls()
+
+        rel_db1 = self.model.get_relation('db1')
+        # Try to get relation data for an invalid remote application.
+        random_app = self.model._cache.get(ops.model.Application, 'randomapp')
+        with self.assertRaises(KeyError):
+            rel_db1.data[random_app]
+
+        remoteapp1 = rel_db1.app
+        self.assertEqual(remoteapp1.name, 'remoteapp1')
+        self.assertEqual(rel_db1.data[remoteapp1],
+                         {'secret': 'cafedeadbeef'})
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'remoteapp1', True),
+        ])
+
+    def test_relation_data_modify_remote(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'remoteapp1', {'secret': 'cafedeadbeef'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.update_relation_data(relation_id, 'remoteapp1/0', {'host': 'remoteapp1/0'})
+        self.model.relations._invalidate('db1')
+        self.resetBackendCalls()
+
+        rel_db1 = self.model.get_relation('db1')
+        remoteapp1_0 = next(filter(lambda u: u.name == 'remoteapp1/0',
+                                   self.model.get_relation('db1').units))
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[remoteapp1_0])
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[remoteapp1_0]['foo'] = 'bar'
+        self.assertNotIn('foo', rel_db1.data[remoteapp1_0])
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'remoteapp1/0', False),
+        ])
+
+    def test_relation_data_modify_our(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp/0', {'host': 'nothing'})
+        self.resetBackendCalls()
+
+        rel_db1 = self.model.get_relation('db1')
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[self.model.unit])
+        rel_db1.data[self.model.unit]['host'] = 'bar'
+        self.assertEqual(rel_db1.data[self.model.unit]['host'], 'bar')
+
+        self.assertBackendCalls([
+            ('relation_get', relation_id, 'myapp/0', False),
+            ('relation_set', relation_id, 'host', 'bar', False),
+        ])
+
+    def test_app_relation_data_modify_local_as_leader(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp', {'password': 'deadbeefcafe'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.set_leader(True)
+        self.resetBackendCalls()
+
+        local_app = self.model.unit.app
+
+        rel_db1 = self.model.get_relation('db1')
+        self.assertEqual(rel_db1.data[local_app], {'password': 'deadbeefcafe'})
+
+        rel_db1.data[local_app]['password'] = 'foo'
+
+        self.assertEqual(rel_db1.data[local_app]['password'], 'foo')
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'myapp', True),
+            ('is_leader',),
+            ('relation_set', relation_id, 'password', 'foo', True),
+        ])
+
+    def test_app_relation_data_modify_local_as_minion(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp', {'password': 'deadbeefcafe'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.set_leader(False)
+        self.resetBackendCalls()
+
+        local_app = self.model.unit.app
+
+        rel_db1 = self.model.get_relation('db1')
+        self.assertEqual(rel_db1.data[local_app], {'password': 'deadbeefcafe'})
+
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[local_app]['password'] = 'foobar'
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'myapp', True),
+            ('is_leader',),
+        ])
+
+    def test_relation_data_del_key(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp/0', {'host': 'bar'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.resetBackendCalls()
+
+        rel_db1 = self.model.get_relation('db1')
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[self.model.unit])
+        del rel_db1.data[self.model.unit]['host']
+        self.assertNotIn('host', rel_db1.data[self.model.unit])
+        self.assertEqual({}, self.harness.get_relation_data(relation_id, 'myapp/0'))
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'myapp/0', False),
+            ('relation_set', relation_id, 'host', '', False),
+        ])
+
+    def test_relation_set_fail(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp/0', {'host': 'myapp-0'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.resetBackendCalls()
+
+        backend = self.harness._backend
+        # TODO: jam 2020-03-06 This is way too much information about relation_set
+        #       The original test forced 'relation-set' to return exit code 2,
+        #       but there was nothing illegal about the data that was being set,
+        #       for us to properly test the side effects of relation-set failing.
+
+        def broken_relation_set(relation_id, key, value, is_app):
+            backend._calls.append(('relation_set', relation_id, key, value, is_app))
+            raise ops.model.ModelError()
+        backend.relation_set = broken_relation_set
+
+        rel_db1 = self.model.get_relation('db1')
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[self.model.unit])
+        with self.assertRaises(ops.model.ModelError):
+            rel_db1.data[self.model.unit]['host'] = 'bar'
+        self.assertEqual(rel_db1.data[self.model.unit]['host'], 'myapp-0')
+        with self.assertRaises(ops.model.ModelError):
+            del rel_db1.data[self.model.unit]['host']
+        self.assertIn('host', rel_db1.data[self.model.unit])
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'myapp/0', False),
+            ('relation_set', relation_id, 'host', 'bar', False),
+            ('relation_set', relation_id, 'host', '', False),
+        ])
+
+    def test_relation_data_type_check(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.update_relation_data(relation_id, 'myapp/0', {'host': 'myapp-0'})
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.resetBackendCalls()
+
+        rel_db1 = self.model.get_relation('db1')
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = 1
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = {'foo': 'bar'}
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = None
+        # No data has actually been changed
+        self.assertEqual(dict(rel_db1.data[self.model.unit]), {'host': 'myapp-0'})
+
+        self.assertBackendCalls([
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('relation_get', relation_id, 'myapp/0', False),
+        ])
+
+    def test_config(self):
+        self.harness.update_config({'foo': 'foo', 'bar': 1, 'qux': True})
+        self.assertEqual(self.model.config, {
+            'foo': 'foo',
+            'bar': 1,
+            'qux': True,
+        })
+        with self.assertRaises(TypeError):
+            # Confirm that we cannot modify config values.
+            self.model.config['foo'] = 'bar'
+
+        self.assertBackendCalls([('config_get',)])
+
+    def test_is_leader(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.set_leader(True)
+        self.resetBackendCalls()
+
+        def check_remote_units():
+            # Cannot determine leadership for remote units.
+            for u in self.model.get_relation('db1').units:
+                with self.assertRaises(RuntimeError):
+                    u.is_leader()
+
+        self.assertTrue(self.model.unit.is_leader())
+
+        check_remote_units()
+
+        # Create a new model and backend to drop a cached is-leader output.
+        self.harness.set_leader(False)
+        self.assertFalse(self.model.unit.is_leader())
+
+        check_remote_units()
+
+        self.assertBackendCalls([
+            ('is_leader',),
+            ('relation_ids', 'db1'),
+            ('relation_list', relation_id),
+            ('is_leader',),
+        ])
+
+    def test_workload_version(self):
+        self.model.unit.set_workload_version('1.2.3')
+        self.assertBackendCalls([
+            ('application_version_set', '1.2.3'),
+        ])
+
+    def test_workload_version_invalid(self):
+        with self.assertRaises(TypeError) as cm:
+            self.model.unit.set_workload_version(5)
+        self.assertEqual(str(cm.exception), "workload version must be a str, not int: 5")
+        self.assertBackendCalls([])
+
+    def test_resources(self):
+        # TODO: (jam) 2020-05-07 Harness doesn't yet support resource-get issue #262
+        meta = ops.charm.CharmMeta()
+        meta.resources = {'foo': None, 'bar': None}
+        model = ops.model.Model(meta, ops.model._ModelBackend('myapp/0'))
+
+        with self.assertRaises(RuntimeError):
+            model.resources.fetch('qux')
+
+        fake_script(self, 'resource-get', 'exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            model.resources.fetch('foo')
+
+        fake_script(self, 'resource-get',
+                    'echo /var/lib/juju/agents/unit-test-0/resources/$1/$1.tgz')
+        self.assertEqual(model.resources.fetch('foo').name, 'foo.tgz')
+        self.assertEqual(model.resources.fetch('bar').name, 'bar.tgz')
+
+    def test_pod_spec(self):
+        # TODO: (jam) 2020-05-07 Harness doesn't yet expose pod-spec-set issue #261
+        meta = ops.charm.CharmMeta.from_yaml('''
+            name: myapp
+        ''')
+        model = ops.model.Model(meta, ops.model._ModelBackend('myapp/0'))
+        fake_script(self, 'pod-spec-set', """
+                    cat $2 > $(dirname $0)/spec.json
+                    [ -n "$4" ] && cat "$4" > $(dirname $0)/k8s_res.json || true
+                    """)
+        fake_script(self, 'is-leader', 'echo true')
+        spec_path = self.fake_script_path / 'spec.json'
+        k8s_res_path = self.fake_script_path / 'k8s_res.json'
+
+        def check_calls(calls):
+            # There may 1 or 2 calls because of is-leader.
+            self.assertLessEqual(len(fake_calls), 2)
+            pod_spec_call = next(filter(lambda c: c[0] == 'pod-spec-set', calls))
+            self.assertEqual(pod_spec_call[:2], ['pod-spec-set', '--file'])
+
+            # 8 bytes are used as of python 3.4.0, see Python bug #12015.
+            # Other characters are from POSIX 3.282 (Portable Filename
+            # Character Set) a subset of which Python's mkdtemp uses.
+            self.assertRegex(pod_spec_call[2], '.*/tmp[A-Za-z0-9._-]{8}-pod-spec-set')
+
+        model.pod.set_spec({'foo': 'bar'})
+        self.assertEqual(spec_path.read_text(), '{"foo": "bar"}')
+        self.assertFalse(k8s_res_path.exists())
+
+        fake_calls = fake_script_calls(self, clear=True)
+        check_calls(fake_calls)
+
+        model.pod.set_spec({'bar': 'foo'}, {'qux': 'baz'})
+        self.assertEqual(spec_path.read_text(), '{"bar": "foo"}')
+        self.assertEqual(k8s_res_path.read_text(), '{"qux": "baz"}')
+
+        fake_calls = fake_script_calls(self, clear=True)
+        check_calls(fake_calls)
+
+        # Create a new model to drop is-leader caching result.
+        self.backend = ops.model._ModelBackend('myapp/0')
+        meta = ops.charm.CharmMeta()
+        model = ops.model.Model(meta, self.backend)
+        fake_script(self, 'is-leader', 'echo false')
+        with self.assertRaises(ops.model.ModelError):
+            model.pod.set_spec({'foo': 'bar'})
+
+    def test_base_status_instance_raises(self):
+        with self.assertRaises(TypeError):
+            ops.model.StatusBase('test')
+
+        class NoNameStatus(ops.model.StatusBase):
+            pass
+
+        with self.assertRaises(AttributeError):
+            ops.model.StatusBase.register_status(NoNameStatus)
+
+    def test_status_repr(self):
+        test_cases = {
+            "ActiveStatus('Seashell')": ops.model.ActiveStatus('Seashell'),
+            "MaintenanceStatus('Red')": ops.model.MaintenanceStatus('Red'),
+            "BlockedStatus('Magenta')": ops.model.BlockedStatus('Magenta'),
+            "WaitingStatus('Thistle')": ops.model.WaitingStatus('Thistle'),
+            'UnknownStatus()': ops.model.UnknownStatus(),
+        }
+        for expected, status in test_cases.items():
+            self.assertEqual(repr(status), expected)
+
+    def test_status_eq(self):
+        status_types = [
+            ops.model.ActiveStatus,
+            ops.model.MaintenanceStatus,
+            ops.model.BlockedStatus,
+            ops.model.WaitingStatus,
+        ]
+
+        self.assertEqual(ops.model.UnknownStatus(), ops.model.UnknownStatus())
+        for (i, t1) in enumerate(status_types):
+            self.assertNotEqual(t1(''), ops.model.UnknownStatus())
+            for (j, t2) in enumerate(status_types):
+                self.assertNotEqual(t1('one'), t2('two'))
+                if i == j:
+                    self.assertEqual(t1('one'), t2('one'))
+                else:
+                    self.assertNotEqual(t1('one'), t2('one'))
+
+    def test_active_message_default(self):
+        self.assertEqual(ops.model.ActiveStatus().message, '')
+
+    def test_local_set_valid_unit_status(self):
+        test_cases = [(
+            'active',
+            ops.model.ActiveStatus('Green'),
+            ('status_set', 'active', 'Green', {'is_app': False}),
+        ), (
+            'maintenance',
+            ops.model.MaintenanceStatus('Yellow'),
+            ('status_set', 'maintenance', 'Yellow', {'is_app': False}),
+        ), (
+            'blocked',
+            ops.model.BlockedStatus('Red'),
+            ('status_set', 'blocked', 'Red', {'is_app': False}),
+        ), (
+            'waiting',
+            ops.model.WaitingStatus('White'),
+            ('status_set', 'waiting', 'White', {'is_app': False}),
+        )]
+
+        for test_case, target_status, backend_call in test_cases:
+            with self.subTest(test_case):
+                self.model.unit.status = target_status
+                self.assertEqual(self.model.unit.status, target_status)
+                self.model.unit._invalidate()
+                self.assertEqual(self.model.unit.status, target_status)
+                self.assertBackendCalls([backend_call, ('status_get', {'is_app': False})])
+
+    def test_local_set_valid_app_status(self):
+        self.harness.set_leader(True)
+        test_cases = [(
+            'active',
+            ops.model.ActiveStatus('Green'),
+            ('status_set', 'active', 'Green', {'is_app': True}),
+        ), (
+            'maintenance',
+            ops.model.MaintenanceStatus('Yellow'),
+            ('status_set', 'maintenance', 'Yellow', {'is_app': True}),
+        ), (
+            'blocked',
+            ops.model.BlockedStatus('Red'),
+            ('status_set', 'blocked', 'Red', {'is_app': True}),
+        ), (
+            'waiting',
+            ops.model.WaitingStatus('White'),
+            ('status_set', 'waiting', 'White', {'is_app': True}),
+        )]
+
+        for test_case, target_status, backend_call in test_cases:
+            with self.subTest(test_case):
+                self.model.app.status = target_status
+                self.assertEqual(self.model.app.status, target_status)
+                self.model.app._invalidate()
+                self.assertEqual(self.model.app.status, target_status)
+                # There is a backend call to check if we can set the value,
+                # and then another check each time we assert the status above
+                expected_calls = [
+                    ('is_leader',), backend_call,
+                    ('is_leader',),
+                    ('is_leader',), ('status_get', {'is_app': True}),
+                ]
+                self.assertBackendCalls(expected_calls)
+
+    def test_set_app_status_non_leader_raises(self):
+        self.harness.set_leader(False)
+        with self.assertRaises(RuntimeError):
+            self.model.app.status
+
+        with self.assertRaises(RuntimeError):
+            self.model.app.status = ops.model.ActiveStatus()
+
+    def test_set_unit_status_invalid(self):
+        with self.assertRaises(ops.model.InvalidStatusError):
+            self.model.unit.status = 'blocked'
+
+    def test_set_app_status_invalid(self):
+        with self.assertRaises(ops.model.InvalidStatusError):
+            self.model.app.status = 'blocked'
+
+    def test_remote_unit_status(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/1')
+        remote_unit = next(filter(lambda u: u.name == 'remoteapp1/0',
+                                  self.model.get_relation('db1').units))
+        self.resetBackendCalls()
+
+        # Remote unit status is always unknown.
+        self.assertEqual(remote_unit.status, ops.model.UnknownStatus())
+
+        test_statuses = (
+            ops.model.UnknownStatus(),
+            ops.model.ActiveStatus('Green'),
+            ops.model.MaintenanceStatus('Yellow'),
+            ops.model.BlockedStatus('Red'),
+            ops.model.WaitingStatus('White'),
+        )
+
+        for target_status in test_statuses:
+            with self.subTest(target_status.name):
+                with self.assertRaises(RuntimeError):
+                    remote_unit.status = target_status
+        self.assertBackendCalls([])
+
+    def test_remote_app_status(self):
+        relation_id = self.harness.add_relation('db1', 'remoteapp1')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/0')
+        self.harness.add_relation_unit(relation_id, 'remoteapp1/1')
+        remoteapp1 = self.model.get_relation('db1').app
+        self.resetBackendCalls()
+
+        # Remote application status is always unknown.
+        self.assertIsInstance(remoteapp1.status, ops.model.UnknownStatus)
+
+        test_statuses = (
+            ops.model.UnknownStatus(),
+            ops.model.ActiveStatus(),
+            ops.model.MaintenanceStatus('Upgrading software'),
+            ops.model.BlockedStatus('Awaiting manual resolution'),
+            ops.model.WaitingStatus('Awaiting related app updates'),
+        )
+        for target_status in test_statuses:
+            with self.subTest(target_status.name):
+                with self.assertRaises(RuntimeError):
+                    remoteapp1.status = target_status
+        self.assertBackendCalls([])
+
+    def test_storage(self):
+        # TODO: (jam) 2020-05-07 Harness doesn't yet expose storage-get issue #263
+        meta = ops.charm.CharmMeta()
+        meta.storages = {'disks': None, 'data': None}
+        model = ops.model.Model(meta, ops.model._ModelBackend('myapp/0'))
+
+        fake_script(self, 'storage-list', '''
+            if [ "$1" = disks ]; then
+                echo '["disks/0", "disks/1"]'
+            else
+                echo '[]'
+            fi
+        ''')
+        fake_script(self, 'storage-get', '''
+            if [ "$2" = disks/0 ]; then
+                echo '"/var/srv/disks/0"'
+            elif [ "$2" = disks/1 ]; then
+                echo '"/var/srv/disks/1"'
+            else
+                exit 2
+            fi
+        ''')
+        fake_script(self, 'storage-add', '')
+
+        self.assertEqual(len(model.storages), 2)
+        self.assertEqual(model.storages.keys(), meta.storages.keys())
+        self.assertIn('disks', model.storages)
+        test_cases = {
+            0: {'name': 'disks', 'location': pathlib.Path('/var/srv/disks/0')},
+            1: {'name': 'disks', 'location': pathlib.Path('/var/srv/disks/1')},
+        }
+        for storage in model.storages['disks']:
+            self.assertEqual(storage.name, 'disks')
+            self.assertIn(storage.id, test_cases)
+            self.assertEqual(storage.name, test_cases[storage.id]['name'])
+            self.assertEqual(storage.location, test_cases[storage.id]['location'])
+
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['storage-list', 'disks', '--format=json'],
+            ['storage-get', '-s', 'disks/0', 'location', '--format=json'],
+            ['storage-get', '-s', 'disks/1', 'location', '--format=json'],
+        ])
+
+        self.assertSequenceEqual(model.storages['data'], [])
+        model.storages.request('data', count=3)
+        self.assertEqual(fake_script_calls(self), [
+            ['storage-list', 'data', '--format=json'],
+            ['storage-add', 'data=3'],
+        ])
+
+        # Try to add storage not present in charm metadata.
+        with self.assertRaises(ops.model.ModelError):
+            model.storages.request('deadbeef')
+
+        # Invalid count parameter types.
+        for count_v in [None, False, 2.0, 'a', b'beef', object]:
+            with self.assertRaises(TypeError):
+                model.storages.request('data', count_v)
+
+    def resetBackendCalls(self):
+        self.harness._get_backend_calls(reset=True)
+
+    def assertBackendCalls(self, expected, *, reset=True):
+        self.assertEqual(expected, self.harness._get_backend_calls(reset=reset))
+
+
+class TestModelBindings(unittest.TestCase):
+
+    def setUp(self):
+        meta = ops.charm.CharmMeta()
+        meta.relations = {
+            'db0': RelationMeta(
+                RelationRole.provides, 'db0', {'interface': 'db0', 'scope': 'global'}),
+            'db1': RelationMeta(
+                RelationRole.requires, 'db1', {'interface': 'db1', 'scope': 'global'}),
+            'db2': RelationMeta(
+                RelationRole.peer, 'db2', {'interface': 'db2', 'scope': 'global'}),
+        }
+        self.backend = ops.model._ModelBackend('myapp/0')
+        self.model = ops.model.Model(meta, self.backend)
+
+        fake_script(self, 'relation-ids',
+                    """([ "$1" = db0 ] && echo '["db0:4"]') || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        self.network_get_out = '''{
+  "bind-addresses": [
+    {
+      "mac-address": "de:ad:be:ef:ca:fe",
+      "interface-name": "lo",
+      "addresses": [
+        {
+          "hostname": "",
+          "value": "192.0.2.2",
+          "cidr": "192.0.2.0/24"
+        },
+        {
+          "hostname": "deadbeef.example",
+          "value": "dead:beef::1",
+          "cidr": "dead:beef::/64"
+        }
+      ]
+    },
+    {
+      "mac-address": "",
+      "interface-name": "tun",
+      "addresses": [
+        {
+          "hostname": "",
+          "value": "192.0.3.3",
+          "cidr": ""
+        },
+        {
+          "hostname": "",
+          "value": "2001:db8::3",
+          "cidr": ""
+        },
+        {
+          "hostname": "deadbeef.local",
+          "value": "fe80::1:1",
+          "cidr": "fe80::/64"
+        }
+      ]
+    }
+  ],
+  "egress-subnets": [
+    "192.0.2.2/32",
+    "192.0.3.0/24",
+    "dead:beef::/64",
+    "2001:db8::3/128"
+  ],
+  "ingress-addresses": [
+    "192.0.2.2",
+    "192.0.3.3",
+    "dead:beef::1",
+    "2001:db8::3"
+  ]
+}'''
+
+    def _check_binding_data(self, binding_name, binding):
+        self.assertEqual(binding.name, binding_name)
+        self.assertEqual(binding.network.bind_address, ipaddress.ip_address('192.0.2.2'))
+        self.assertEqual(binding.network.ingress_address, ipaddress.ip_address('192.0.2.2'))
+        # /32 and /128 CIDRs are valid one-address networks for IPv{4,6}Network types respectively.
+        self.assertEqual(binding.network.egress_subnets, [ipaddress.ip_network('192.0.2.2/32'),
+                                                          ipaddress.ip_network('192.0.3.0/24'),
+                                                          ipaddress.ip_network('dead:beef::/64'),
+                                                          ipaddress.ip_network('2001:db8::3/128')])
+
+        for (i, (name, address, subnet)) in enumerate([
+                ('lo', '192.0.2.2', '192.0.2.0/24'),
+                ('lo', 'dead:beef::1', 'dead:beef::/64'),
+                ('tun', '192.0.3.3', '192.0.3.3/32'),
+                ('tun', '2001:db8::3', '2001:db8::3/128'),
+                ('tun', 'fe80::1:1', 'fe80::/64')]):
+            self.assertEqual(binding.network.interfaces[i].name, name)
+            self.assertEqual(binding.network.interfaces[i].address, ipaddress.ip_address(address))
+            self.assertEqual(binding.network.interfaces[i].subnet, ipaddress.ip_network(subnet))
+
+    def test_invalid_keys(self):
+        # Basic validation for passing invalid keys.
+        for name in (object, 0):
+            with self.assertRaises(ops.model.ModelError):
+                self.model.get_binding(name)
+
+    def test_dead_relations(self):
+        fake_script(
+            self,
+            'network-get',
+            '''
+                if [ "$1" = db0 ] && [ "$2" = --format=json ]; then
+                    echo '{}'
+                else
+                    echo ERROR invalid value "$2" for option -r: relation not found >&2
+                    exit 2
+                fi
+            '''.format(self.network_get_out))
+        # Validate the behavior for dead relations.
+        binding = ops.model.Binding('db0', 42, self.model._backend)
+        self.assertEqual(binding.network.bind_address, ipaddress.ip_address('192.0.2.2'))
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['network-get', 'db0', '-r', '42', '--format=json'],
+            ['network-get', 'db0', '--format=json'],
+        ])
+
+    def test_binding_by_relation_name(self):
+        fake_script(self, 'network-get',
+                    '''[ "$1" = db0 ] && echo '{}' || exit 1'''.format(self.network_get_out))
+        binding_name = 'db0'
+        expected_calls = [['network-get', 'db0', '--format=json']]
+
+        binding = self.model.get_binding(binding_name)
+        self._check_binding_data(binding_name, binding)
+        self.assertEqual(fake_script_calls(self, clear=True), expected_calls)
+
+    def test_binding_by_relation(self):
+        fake_script(self, 'network-get',
+                    '''[ "$1" = db0 ] && echo '{}' || exit 1'''.format(self.network_get_out))
+        binding_name = 'db0'
+        expected_calls = [
+            ['relation-ids', 'db0', '--format=json'],
+            # The two invocations below are due to the get_relation call.
+            ['relation-list', '-r', '4', '--format=json'],
+            ['network-get', 'db0', '-r', '4', '--format=json'],
+        ]
+        binding = self.model.get_binding(self.model.get_relation(binding_name))
+        self._check_binding_data(binding_name, binding)
+        self.assertEqual(fake_script_calls(self, clear=True), expected_calls)
+
+
+class TestModelBackend(unittest.TestCase):
+
+    def setUp(self):
+        self._backend = None
+
+    @property
+    def backend(self):
+        if self._backend is None:
+            self._backend = ops.model._ModelBackend('myapp/0')
+        return self._backend
+
+    def test_relation_get_set_is_app_arg(self):
+        # No is_app provided.
+        with self.assertRaises(TypeError):
+            self.backend.relation_set(1, 'fookey', 'barval')
+
+        with self.assertRaises(TypeError):
+            self.backend.relation_get(1, 'fooentity')
+
+        # Invalid types for is_app.
+        for is_app_v in [None, 1, 2.0, 'a', b'beef']:
+            with self.assertRaises(TypeError):
+                self.backend.relation_set(1, 'fookey', 'barval', is_app=is_app_v)
+
+            with self.assertRaises(TypeError):
+                self.backend.relation_get(1, 'fooentity', is_app=is_app_v)
+
+    def test_is_leader_refresh(self):
+        meta = ops.charm.CharmMeta.from_yaml('''
+            name: myapp
+        ''')
+        model = ops.model.Model(meta, self.backend)
+        fake_script(self, 'is-leader', 'echo false')
+        self.assertFalse(model.unit.is_leader())
+
+        # Change the leadership status
+        fake_script(self, 'is-leader', 'echo true')
+        # If you don't force it, we don't check, so we won't see the change
+        self.assertFalse(model.unit.is_leader())
+        # If we force a recheck, then we notice
+        self.backend._leader_check_time = None
+        self.assertTrue(model.unit.is_leader())
+
+        # Force a recheck without changing the leadership status.
+        fake_script(self, 'is-leader', 'echo true')
+        self.backend._leader_check_time = None
+        self.assertTrue(model.unit.is_leader())
+
+    def test_relation_tool_errors(self):
+        self.addCleanup(os.environ.pop, 'JUJU_VERSION', None)
+        os.environ['JUJU_VERSION'] = '2.8.0'
+        err_msg = 'ERROR invalid value "$2" for option -r: relation not found'
+
+        test_cases = [(
+            lambda: fake_script(self, 'relation-list', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_list(3),
+            ops.model.ModelError,
+            [['relation-list', '-r', '3', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-list', 'echo {} >&2 ; exit 2'.format(err_msg)),
+            lambda: self.backend.relation_list(3),
+            ops.model.RelationNotFoundError,
+            [['relation-list', '-r', '3', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-set', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_set(3, 'foo', 'bar', is_app=False),
+            ops.model.ModelError,
+            [['relation-set', '-r', '3', 'foo=bar']],
+        ), (
+            lambda: fake_script(self, 'relation-set', 'echo {} >&2 ; exit 2'.format(err_msg)),
+            lambda: self.backend.relation_set(3, 'foo', 'bar', is_app=False),
+            ops.model.RelationNotFoundError,
+            [['relation-set', '-r', '3', 'foo=bar']],
+        ), (
+            lambda: None,
+            lambda: self.backend.relation_set(3, 'foo', 'bar', is_app=True),
+            ops.model.RelationNotFoundError,
+            [['relation-set', '-r', '3', 'foo=bar', '--app']],
+        ), (
+            lambda: fake_script(self, 'relation-get', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_get(3, 'remote/0', is_app=False),
+            ops.model.ModelError,
+            [['relation-get', '-r', '3', '-', 'remote/0', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-get', 'echo {} >&2 ; exit 2'.format(err_msg)),
+            lambda: self.backend.relation_get(3, 'remote/0', is_app=False),
+            ops.model.RelationNotFoundError,
+            [['relation-get', '-r', '3', '-', 'remote/0', '--format=json']],
+        ), (
+            lambda: None,
+            lambda: self.backend.relation_get(3, 'remote/0', is_app=True),
+            ops.model.RelationNotFoundError,
+            [['relation-get', '-r', '3', '-', 'remote/0', '--app', '--format=json']],
+        )]
+
+        for i, (do_fake, run, exception, calls) in enumerate(test_cases):
+            with self.subTest(i):
+                do_fake()
+                with self.assertRaises(exception):
+                    run()
+                self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_relation_get_juju_version_quirks(self):
+        self.addCleanup(os.environ.pop, 'JUJU_VERSION', None)
+
+        fake_script(self, 'relation-get', '''echo '{"foo": "bar"}' ''')
+
+        # on 2.7.0+, things proceed as expected
+        for v in ['2.8.0', '2.7.0']:
+            with self.subTest(v):
+                os.environ['JUJU_VERSION'] = v
+                rel_data = self.backend.relation_get(1, 'foo/0', is_app=True)
+                self.assertEqual(rel_data, {"foo": "bar"})
+                calls = [' '.join(i) for i in fake_script_calls(self, clear=True)]
+                self.assertEqual(calls, ['relation-get -r 1 - foo/0 --app --format=json'])
+
+        # before 2.7.0, it just fails (no --app support)
+        os.environ['JUJU_VERSION'] = '2.6.9'
+        with self.assertRaisesRegex(RuntimeError, 'not supported on Juju version 2.6.9'):
+            self.backend.relation_get(1, 'foo/0', is_app=True)
+        self.assertEqual(fake_script_calls(self), [])
+
+    def test_relation_set_juju_version_quirks(self):
+        self.addCleanup(os.environ.pop, 'JUJU_VERSION', None)
+
+        fake_script(self, 'relation-set', 'exit 0')
+
+        # on 2.7.0+, things proceed as expected
+        for v in ['2.8.0', '2.7.0']:
+            with self.subTest(v):
+                os.environ['JUJU_VERSION'] = v
+                self.backend.relation_set(1, 'foo', 'bar', is_app=True)
+                calls = [' '.join(i) for i in fake_script_calls(self, clear=True)]
+                self.assertEqual(calls, ['relation-set -r 1 foo=bar --app'])
+
+        # before 2.7.0, it just fails always (no --app support)
+        os.environ['JUJU_VERSION'] = '2.6.9'
+        with self.assertRaisesRegex(RuntimeError, 'not supported on Juju version 2.6.9'):
+            self.backend.relation_set(1, 'foo', 'bar', is_app=True)
+        self.assertEqual(fake_script_calls(self), [])
+
+    def test_status_get(self):
+        # taken from actual Juju output
+        content = '{"message": "", "status": "unknown", "status-data": {}}'
+        fake_script(self, 'status-get', "echo '{}'".format(content))
+        s = self.backend.status_get(is_app=False)
+        self.assertEqual(s['status'], "unknown")
+        self.assertEqual(s['message'], "")
+        # taken from actual Juju output
+        content = dedent("""
+            {
+                "application-status": {
+                    "message": "installing",
+                    "status": "maintenance",
+                    "status-data": {},
+                    "units": {
+                        "uo/0": {
+                            "message": "",
+                            "status": "active",
+                            "status-data": {}
+                        }
+                    }
+                }
+            }
+            """)
+        fake_script(self, 'status-get', "echo '{}'".format(content))
+        s = self.backend.status_get(is_app=True)
+        self.assertEqual(s['status'], "maintenance")
+        self.assertEqual(s['message'], "installing")
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['status-get', '--include-data', '--application=False', '--format=json'],
+            ['status-get', '--include-data', '--application=True', '--format=json'],
+        ])
+
+    def test_status_is_app_forced_kwargs(self):
+        fake_script(self, 'status-get', 'exit 1')
+        fake_script(self, 'status-set', 'exit 1')
+
+        test_cases = (
+            lambda: self.backend.status_get(False),
+            lambda: self.backend.status_get(True),
+            lambda: self.backend.status_set('active', '', False),
+            lambda: self.backend.status_set('active', '', True),
+        )
+
+        for case in test_cases:
+            with self.assertRaises(TypeError):
+                case()
+
+    def test_local_set_invalid_status(self):
+        # juju return exit code 1 if you ask to set status to 'unknown'
+        meta = ops.charm.CharmMeta.from_yaml('''
+            name: myapp
+        ''')
+        model = ops.model.Model(meta, self.backend)
+        fake_script(self, 'status-set', 'exit 1')
+        fake_script(self, 'is-leader', 'echo true')
+
+        with self.assertRaises(ops.model.ModelError):
+            model.unit.status = ops.model.UnknownStatus()
+
+        self.assertEqual(fake_script_calls(self, True), [
+            ['status-set', '--application=False', 'unknown', ''],
+        ])
+
+        with self.assertRaises(ops.model.ModelError):
+            model.app.status = ops.model.UnknownStatus()
+
+        # A leadership check is needed for application status.
+        self.assertEqual(fake_script_calls(self, True), [
+            ['is-leader', '--format=json'],
+            ['status-set', '--application=True', 'unknown', ''],
+        ])
+
+    def test_status_set_is_app_not_bool_raises(self):
+        for is_app_v in [None, 1, 2.0, 'a', b'beef', object]:
+            with self.assertRaises(TypeError):
+                self.backend.status_set(ops.model.ActiveStatus, is_app=is_app_v)
+
+    def test_storage_tool_errors(self):
+        test_cases = [(
+            lambda: fake_script(self, 'storage-list', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_list('foobar'),
+            ops.model.ModelError,
+            [['storage-list', 'foobar', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'storage-get', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_get('foobar', 'someattr'),
+            ops.model.ModelError,
+            [['storage-get', '-s', 'foobar', 'someattr', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'storage-add', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=2),
+            ops.model.ModelError,
+            [['storage-add', 'foobar=2']],
+        ), (
+            lambda: fake_script(self, 'storage-add', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=object),
+            TypeError,
+            [],
+        ), (
+            lambda: fake_script(self, 'storage-add', 'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=True),
+            TypeError,
+            [],
+        )]
+        for do_fake, run, exception, calls in test_cases:
+            do_fake()
+            with self.assertRaises(exception):
+                run()
+            self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_network_get(self):
+        network_get_out = '''{
+  "bind-addresses": [
+    {
+      "mac-address": "",
+      "interface-name": "",
+      "addresses": [
+        {
+          "hostname": "",
+          "value": "192.0.2.2",
+          "cidr": ""
+        }
+      ]
+    }
+  ],
+  "egress-subnets": [
+    "192.0.2.2/32"
+  ],
+  "ingress-addresses": [
+    "192.0.2.2"
+  ]
+}'''
+        fake_script(self, 'network-get',
+                    '''[ "$1" = deadbeef ] && echo '{}' || exit 1'''.format(network_get_out))
+        network_info = self.backend.network_get('deadbeef')
+        self.assertEqual(network_info, json.loads(network_get_out))
+        self.assertEqual(fake_script_calls(self, clear=True),
+                         [['network-get', 'deadbeef', '--format=json']])
+
+        network_info = self.backend.network_get('deadbeef', 1)
+        self.assertEqual(network_info, json.loads(network_get_out))
+        self.assertEqual(fake_script_calls(self, clear=True),
+                         [['network-get', 'deadbeef', '-r', '1', '--format=json']])
+
+    def test_network_get_errors(self):
+        err_no_endpoint = 'ERROR no network config found for binding "$2"'
+        err_no_rel = 'ERROR invalid value "$3" for option -r: relation not found'
+
+        test_cases = [(
+            lambda: fake_script(self, 'network-get',
+                                'echo {} >&2 ; exit 1'.format(err_no_endpoint)),
+            lambda: self.backend.network_get("deadbeef"),
+            ops.model.ModelError,
+            [['network-get', 'deadbeef', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'network-get', 'echo {} >&2 ; exit 2'.format(err_no_rel)),
+            lambda: self.backend.network_get("deadbeef", 3),
+            ops.model.RelationNotFoundError,
+            [['network-get', 'deadbeef', '-r', '3', '--format=json']],
+        )]
+        for do_fake, run, exception, calls in test_cases:
+            do_fake()
+            with self.assertRaises(exception):
+                run()
+            self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_get_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-get', 'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_get()
+        calls = [['action-get', '--format=json']]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_set_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-set', 'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_set(OrderedDict([('foo', 'bar'), ('dead', 'beef cafe')]))
+        calls = [["action-set", "foo=bar", "dead=beef cafe"]]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_log_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-log', 'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_log('log-message')
+        calls = [["action-log", "log-message"]]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_get(self):
+        fake_script(self, 'action-get', """echo '{"foo-name": "bar", "silent": false}'""")
+        params = self.backend.action_get()
+        self.assertEqual(params['foo-name'], 'bar')
+        self.assertEqual(params['silent'], False)
+        self.assertEqual(fake_script_calls(self), [['action-get', '--format=json']])
+
+    def test_action_set(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-set', 'exit 0')
+        self.backend.action_set(OrderedDict([('x', 'dead beef'), ('y', 1)]))
+        self.assertEqual(fake_script_calls(self), [['action-set', 'x=dead beef', 'y=1']])
+
+    def test_action_fail(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-fail', 'exit 0')
+        self.backend.action_fail('error 42')
+        self.assertEqual(fake_script_calls(self), [['action-fail', 'error 42']])
+
+    def test_action_log(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-log', 'exit 0')
+        self.backend.action_log('progress: 42%')
+        self.assertEqual(fake_script_calls(self), [['action-log', 'progress: 42%']])
+
+    def test_application_version_set(self):
+        fake_script(self, 'application-version-set', 'exit 0')
+        self.backend.application_version_set('1.2b3')
+        self.assertEqual(fake_script_calls(self), [['application-version-set', '--', '1.2b3']])
+
+    def test_application_version_set_invalid(self):
+        fake_script(self, 'application-version-set', 'exit 0')
+        with self.assertRaises(TypeError):
+            self.backend.application_version_set(2)
+        with self.assertRaises(TypeError):
+            self.backend.application_version_set()
+        self.assertEqual(fake_script_calls(self), [])
+
+    def test_juju_log(self):
+        fake_script(self, 'juju-log', 'exit 0')
+        self.backend.juju_log('WARNING', 'foo')
+        self.assertEqual(fake_script_calls(self, clear=True),
+                         [['juju-log', '--log-level', 'WARNING', 'foo']])
+
+        with self.assertRaises(TypeError):
+            self.backend.juju_log('DEBUG')
+        self.assertEqual(fake_script_calls(self, clear=True), [])
+
+        fake_script(self, 'juju-log', 'exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.juju_log('BAR', 'foo')
+        self.assertEqual(fake_script_calls(self, clear=True),
+                         [['juju-log', '--log-level', 'BAR', 'foo']])
+
+    def test_valid_metrics(self):
+        fake_script(self, 'add-metric', 'exit 0')
+        test_cases = [(
+            OrderedDict([('foo', 42), ('b-ar', 4.5), ('ba_-z', 4.5), ('a', 1)]),
+            OrderedDict([('de', 'ad'), ('be', 'ef_ -')]),
+            [['add-metric', '--labels', 'de=ad,be=ef_ -',
+              'foo=42', 'b-ar=4.5', 'ba_-z=4.5', 'a=1']]
+        ), (
+            OrderedDict([('foo1', 0), ('b2r', 4.5)]),
+            OrderedDict([('d3', 'aд'), ('b33f', '3_ -')]),
+            [['add-metric', '--labels', 'd3=aд,b33f=3_ -', 'foo1=0', 'b2r=4.5']],
+        )]
+        for metrics, labels, expected_calls in test_cases:
+            self.backend.add_metrics(metrics, labels)
+            self.assertEqual(fake_script_calls(self, clear=True), expected_calls)
+
+    def test_invalid_metric_names(self):
+        invalid_inputs = [
+            ({'': 4.2}, {}),
+            ({'1': 4.2}, {}),
+            ({'1': -4.2}, {}),
+            ({'123': 4.2}, {}),
+            ({'1foo': 4.2}, {}),
+            ({'-foo': 4.2}, {}),
+            ({'_foo': 4.2}, {}),
+            ({'foo-': 4.2}, {}),
+            ({'foo_': 4.2}, {}),
+            ({'a-': 4.2}, {}),
+            ({'a_': 4.2}, {}),
+            ({'BAЯ': 4.2}, {}),
+        ]
+        for metrics, labels in invalid_inputs:
+            with self.assertRaises(ops.model.ModelError):
+                self.backend.add_metrics(metrics, labels)
+
+    def test_invalid_metric_values(self):
+        invalid_inputs = [
+            ({'a': float('+inf')}, {}),
+            ({'a': float('-inf')}, {}),
+            ({'a': float('nan')}, {}),
+            ({'foo': 'bar'}, {}),
+            ({'foo': '1O'}, {}),
+        ]
+        for metrics, labels in invalid_inputs:
+            with self.assertRaises(ops.model.ModelError):
+                self.backend.add_metrics(metrics, labels)
+
+    def test_invalid_metric_labels(self):
+        invalid_inputs = [
+            ({'foo': 4.2}, {'': 'baz'}),
+            ({'foo': 4.2}, {',bar': 'baz'}),
+            ({'foo': 4.2}, {'b=a=r': 'baz'}),
+            ({'foo': 4.2}, {'BAЯ': 'baz'}),
+        ]
+        for metrics, labels in invalid_inputs:
+            with self.assertRaises(ops.model.ModelError):
+                self.backend.add_metrics(metrics, labels)
+
+    def test_invalid_metric_label_values(self):
+        invalid_inputs = [
+            ({'foo': 4.2}, {'bar': ''}),
+            ({'foo': 4.2}, {'bar': 'b,az'}),
+            ({'foo': 4.2}, {'bar': 'b=az'}),
+        ]
+        for metrics, labels in invalid_inputs:
+            with self.assertRaises(ops.model.ModelError):
+                self.backend.add_metrics(metrics, labels)
+
+
+class TestLazyMapping(unittest.TestCase):
+
+    def test_invalidate(self):
+        loaded = []
+
+        class MyLazyMap(ops.model.LazyMapping):
+            def _load(self):
+                loaded.append(1)
+                return {'foo': 'bar'}
+
+        map = MyLazyMap()
+        self.assertEqual(map['foo'], 'bar')
+        self.assertEqual(loaded, [1])
+        self.assertEqual(map['foo'], 'bar')
+        self.assertEqual(loaded, [1])
+        map._invalidate()
+        self.assertEqual(map['foo'], 'bar')
+        self.assertEqual(loaded, [1, 1])
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_storage.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_storage.py
new file mode 100755
index 0000000000000000000000000000000000000000..3410999bd5f045cd3d65396cc5be546a3c4a94e0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_storage.py
@@ -0,0 +1,412 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import abc
+import gc
+import io
+import os
+import pathlib
+import sys
+import tempfile
+from textwrap import dedent
+
+import yaml
+
+from ops import (
+    framework,
+    storage,
+)
+from test.test_helpers import (
+    BaseTestCase,
+    fake_script,
+    fake_script_calls,
+)
+
+
+class StoragePermutations(abc.ABC):
+
+    def create_framework(self) -> framework.Framework:
+        """Create a Framework that we can use to test the backend storage.
+        """
+        return framework.Framework(self.create_storage(), None, None, None)
+
+    @abc.abstractmethod
+    def create_storage(self) -> storage.SQLiteStorage:
+        """Create a Storage backend that we can interact with"""
+        return NotImplemented
+
+    def test_save_and_load_snapshot(self):
+        f = self.create_framework()
+
+        class Sample(framework.Object):
+
+            def __init__(self, parent, key, content):
+                super().__init__(parent, key)
+                self.content = content
+
+            def snapshot(self):
+                return {'content': self.content}
+
+            def restore(self, snapshot):
+                self.__dict__.update(snapshot)
+
+        f.register_type(Sample, None, Sample.handle_kind)
+        data = {
+            'str': 'string',
+            'bytes': b'bytes',
+            'int': 1,
+            'float': 3.0,
+            'dict': {'a': 'b'},
+            'set': {'a', 'b'},
+            'list': [1, 2],
+        }
+        s = Sample(f, 'test', data)
+        handle = s.handle
+        f.save_snapshot(s)
+        del s
+        gc.collect()
+        res = f.load_snapshot(handle)
+        self.assertEqual(data, res.content)
+
+    def test_emit_event(self):
+        f = self.create_framework()
+
+        class Evt(framework.EventBase):
+            def __init__(self, handle, content):
+                super().__init__(handle)
+                self.content = content
+
+            def snapshot(self):
+                return self.content
+
+            def restore(self, content):
+                self.content = content
+
+        class Events(framework.ObjectEvents):
+            event = framework.EventSource(Evt)
+
+        class Sample(framework.Object):
+
+            on = Events()
+
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.observed_content = None
+                self.framework.observe(self.on.event, self._on_event)
+
+            def _on_event(self, event: Evt):
+                self.observed_content = event.content
+
+        s = Sample(f, 'key')
+        f.register_type(Sample, None, Sample.handle_kind)
+        s.on.event.emit('foo')
+        self.assertEqual('foo', s.observed_content)
+        s.on.event.emit(1)
+        self.assertEqual(1, s.observed_content)
+        s.on.event.emit(None)
+        self.assertEqual(None, s.observed_content)
+
+    def test_save_and_overwrite_snapshot(self):
+        store = self.create_storage()
+        store.save_snapshot('foo', {1: 2})
+        self.assertEqual({1: 2}, store.load_snapshot('foo'))
+        store.save_snapshot('foo', {'three': 4})
+        self.assertEqual({'three': 4}, store.load_snapshot('foo'))
+
+    def test_drop_snapshot(self):
+        store = self.create_storage()
+        store.save_snapshot('foo', {1: 2})
+        self.assertEqual({1: 2}, store.load_snapshot('foo'))
+        store.drop_snapshot('foo')
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('foo')
+
+    def test_save_snapshot_empty_string(self):
+        store = self.create_storage()
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('foo')
+        store.save_snapshot('foo', '')
+        self.assertEqual('', store.load_snapshot('foo'))
+        store.drop_snapshot('foo')
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('foo')
+
+    def test_save_snapshot_none(self):
+        store = self.create_storage()
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('bar')
+        store.save_snapshot('bar', None)
+        self.assertEqual(None, store.load_snapshot('bar'))
+        store.drop_snapshot('bar')
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('bar')
+
+    def test_save_snapshot_zero(self):
+        store = self.create_storage()
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('zero')
+        store.save_snapshot('zero', 0)
+        self.assertEqual(0, store.load_snapshot('zero'))
+        store.drop_snapshot('zero')
+        with self.assertRaises(storage.NoSnapshotError):
+            store.load_snapshot('zero')
+
+    def test_save_notice(self):
+        store = self.create_storage()
+        store.save_notice('event', 'observer', 'method')
+        self.assertEqual(
+            list(store.notices('event')),
+            [('event', 'observer', 'method')])
+
+    def test_load_notices(self):
+        store = self.create_storage()
+        self.assertEqual(list(store.notices('path')), [])
+
+    def test_save_one_load_another_notice(self):
+        store = self.create_storage()
+        store.save_notice('event', 'observer', 'method')
+        self.assertEqual(list(store.notices('other')), [])
+
+    def test_save_load_drop_load_notices(self):
+        store = self.create_storage()
+        store.save_notice('event', 'observer', 'method')
+        store.save_notice('event', 'observer', 'method2')
+        self.assertEqual(
+            list(store.notices('event')),
+            [('event', 'observer', 'method'),
+             ('event', 'observer', 'method2'),
+             ])
+
+
+class TestSQLiteStorage(StoragePermutations, BaseTestCase):
+
+    def create_storage(self):
+        return storage.SQLiteStorage(':memory:')
+
+
+def setup_juju_backend(test_case, state_file):
+    """Create fake scripts for pretending to be state-set and state-get"""
+    template_args = {
+        'executable': sys.executable,
+        'pthpth': os.path.dirname(pathlib.__file__),
+        'state_file': str(state_file),
+    }
+
+    fake_script(test_case, 'state-set', dedent('''\
+        {executable} -c '
+        import sys
+        if "{pthpth}" not in sys.path:
+            sys.path.append("{pthpth}")
+        import sys, yaml, pathlib, pickle
+        assert sys.argv[1:] == ["--file", "-"]
+        request = yaml.load(sys.stdin, Loader=getattr(yaml, "CSafeLoader", yaml.SafeLoader))
+        state_file = pathlib.Path("{state_file}")
+        if state_file.exists() and state_file.stat().st_size > 0:
+            with state_file.open("rb") as f:
+                state = pickle.load(f)
+        else:
+            state = {{}}
+        for k, v in request.items():
+            state[k] = v
+        with state_file.open("wb") as f:
+            pickle.dump(state, f)
+        ' "$@"
+        ''').format(**template_args))
+
+    fake_script(test_case, 'state-get', dedent('''\
+        {executable} -Sc '
+        import sys
+        if "{pthpth}" not in sys.path:
+            sys.path.append("{pthpth}")
+        import sys, pathlib, pickle
+        assert len(sys.argv) == 2
+        state_file = pathlib.Path("{state_file}")
+        if state_file.exists() and state_file.stat().st_size > 0:
+            with state_file.open("rb") as f:
+                state = pickle.load(f)
+        else:
+            state = {{}}
+        result = state.get(sys.argv[1], "\\n")
+        sys.stdout.write(result)
+        ' "$@"
+        ''').format(**template_args))
+
+    fake_script(test_case, 'state-delete', dedent('''\
+        {executable} -Sc '
+        import sys
+        if "{pthpth}" not in sys.path:
+            sys.path.append("{pthpth}")
+        import sys, pathlib, pickle
+        assert len(sys.argv) == 2
+        state_file = pathlib.Path("{state_file}")
+        if state_file.exists() and state_file.stat().st_size > 0:
+            with state_file.open("rb") as f:
+                state = pickle.load(f)
+        else:
+            state = {{}}
+        state.pop(sys.argv[1], None)
+        with state_file.open("wb") as f:
+            pickle.dump(state, f)
+        ' "$@"
+        ''').format(**template_args))
+
+
+class TestJujuStorage(StoragePermutations, BaseTestCase):
+
+    def create_storage(self):
+        state_file = pathlib.Path(tempfile.mkstemp(prefix='tmp-ops-test-state-')[1])
+        self.addCleanup(state_file.unlink)
+        setup_juju_backend(self, state_file)
+        return storage.JujuStorage()
+
+
+class TestSimpleLoader(BaseTestCase):
+
+    def test_is_c_loader(self):
+        loader = storage._SimpleLoader(io.StringIO(''))
+        if getattr(yaml, 'CSafeLoader', None) is not None:
+            self.assertIsInstance(loader, yaml.CSafeLoader)
+        else:
+            self.assertIsInstance(loader, yaml.SafeLoader)
+
+    def test_is_c_dumper(self):
+        dumper = storage._SimpleDumper(io.StringIO(''))
+        if getattr(yaml, 'CSafeDumper', None) is not None:
+            self.assertIsInstance(dumper, yaml.CSafeDumper)
+        else:
+            self.assertIsInstance(dumper, yaml.SafeDumper)
+
+    def test_handles_tuples(self):
+        raw = yaml.dump((1, 'tuple'), Dumper=storage._SimpleDumper)
+        parsed = yaml.load(raw, Loader=storage._SimpleLoader)
+        self.assertEqual(parsed, (1, 'tuple'))
+
+    def assertRefused(self, obj):
+        # We shouldn't allow them to be written
+        with self.assertRaises(yaml.representer.RepresenterError):
+            yaml.dump(obj, Dumper=storage._SimpleDumper)
+        # If they did somehow end up written, we shouldn't be able to load them
+        raw = yaml.dump(obj, Dumper=yaml.Dumper)
+        with self.assertRaises(yaml.constructor.ConstructorError):
+            yaml.load(raw, Loader=storage._SimpleLoader)
+
+    def test_forbids_some_types(self):
+        self.assertRefused(1 + 2j)
+        self.assertRefused({'foo': 1 + 2j})
+        self.assertRefused(frozenset(['foo', 'bar']))
+        self.assertRefused(bytearray(b'foo'))
+        self.assertRefused(object())
+
+        class Foo:
+            pass
+        f = Foo()
+        self.assertRefused(f)
+
+
+class TestJujuStateBackend(BaseTestCase):
+
+    def test_is_not_available(self):
+        self.assertFalse(storage._JujuStorageBackend.is_available())
+
+    def test_is_available(self):
+        fake_script(self, 'state-get', 'echo ""')
+        self.assertTrue(storage._JujuStorageBackend.is_available())
+        self.assertEqual(fake_script_calls(self, clear=True), [])
+
+    def test_set_encodes_args(self):
+        t = tempfile.NamedTemporaryFile()
+        fake_script(self, 'state-set', dedent("""
+            cat >> {}
+            """).format(t.name))
+        backend = storage._JujuStorageBackend()
+        backend.set('key', {'foo': 2})
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['state-set', '--file', '-'],
+        ])
+        t.seek(0)
+        content = t.read()
+        self.assertEqual(content.decode('utf-8'), dedent("""\
+            "key": |
+              {foo: 2}
+            """))
+
+    def test_get(self):
+        fake_script(self, 'state-get', dedent("""
+            echo 'foo: "bar"'
+            """))
+        backend = storage._JujuStorageBackend()
+        value = backend.get('key')
+        self.assertEqual(value, {'foo': 'bar'})
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['state-get', 'key'],
+        ])
+
+    def test_set_and_get_complex_value(self):
+        t = tempfile.NamedTemporaryFile()
+        fake_script(self, 'state-set', dedent("""
+            cat >> {}
+            """).format(t.name))
+        backend = storage._JujuStorageBackend()
+        complex_val = {
+            'foo': 2,
+            3: [1, 2, '3'],
+            'four': {2, 3},
+            'five': {'a': 2, 'b': 3.0},
+            'six': ('a', 'b'),
+            'seven': b'1234',
+        }
+        backend.set('Class[foo]/_stored', complex_val)
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['state-set', '--file', '-'],
+        ])
+        t.seek(0)
+        content = t.read()
+        outer = yaml.safe_load(content)
+        key = 'Class[foo]/_stored'
+        self.assertEqual(list(outer.keys()), [key])
+        inner = yaml.load(outer[key], Loader=storage._SimpleLoader)
+        self.assertEqual(complex_val, inner)
+        if sys.version_info >= (3, 6):
+            # In Python 3.5 dicts are not ordered by default, and PyYAML only
+            # iterates the dict. So we read and assert the content is valid,
+            # but we don't assert the serialized form.
+            self.assertEqual(content.decode('utf-8'), dedent("""\
+                "Class[foo]/_stored": |
+                  foo: 2
+                  3: [1, 2, '3']
+                  four: !!set {2: null, 3: null}
+                  five: {a: 2, b: 3.0}
+                  six: !!python/tuple [a, b]
+                  seven: !!binary |
+                    MTIzNA==
+                """))
+        # Note that the content is yaml in a string, embedded inside YAML to declare the Key:
+        # Value of where to store the entry.
+        fake_script(self, 'state-get', dedent("""
+            echo "foo: 2
+            3: [1, 2, '3']
+            four: !!set {2: null, 3: null}
+            five: {a: 2, b: 3.0}
+            six: !!python/tuple [a, b]
+            seven: !!binary |
+              MTIzNA==
+            "
+        """))
+        out = backend.get('Class[foo]/_stored')
+        self.assertEqual(out, complex_val)
+
+    # TODO: Add tests for things we don't want to support. eg, YAML that has custom types should
+    #  be properly forbidden.
+    # TODO: Tests for state-set/get/delete and how they handle if you ask to delete something
+    #  that doesn't exist, or get something that doesn't exist, etc.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_testing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f9e4eb17f7a1f746834357987976343e216ee2d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/mod/operator/test/test_testing.py
@@ -0,0 +1,931 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import importlib
+import pathlib
+import shutil
+import sys
+import tempfile
+import textwrap
+import unittest
+import yaml
+
+from ops.charm import (
+    CharmBase,
+    RelationEvent,
+)
+from ops.framework import (
+    Object,
+)
+from ops.model import (
+    ActiveStatus,
+    MaintenanceStatus,
+    UnknownStatus,
+    ModelError,
+    RelationNotFoundError,
+)
+from ops.testing import Harness
+
+
+class TestHarness(unittest.TestCase):
+
+    def test_add_relation(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        rel_id = harness.add_relation('db', 'postgresql')
+        self.assertIsInstance(rel_id, int)
+        backend = harness._backend
+        self.assertEqual(backend.relation_ids('db'), [rel_id])
+        self.assertEqual(backend.relation_list(rel_id), [])
+        # Make sure the initial data bags for our app and unit are empty.
+        self.assertEqual(backend.relation_get(rel_id, 'test-app', is_app=True), {})
+        self.assertEqual(backend.relation_get(rel_id, 'test-app/0', is_app=False), {})
+
+    def test_add_relation_and_unit(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        rel_id = harness.add_relation('db', 'postgresql')
+        self.assertIsInstance(rel_id, int)
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        harness.update_relation_data(rel_id, 'postgresql/0', {'foo': 'bar'})
+        backend = harness._backend
+        self.assertEqual(backend.relation_ids('db'), [rel_id])
+        self.assertEqual(backend.relation_list(rel_id), ['postgresql/0'])
+        self.assertEqual(
+            backend.relation_get(rel_id, 'postgresql/0', is_app=False),
+            {'foo': 'bar'})
+
+    def test_add_relation_with_remote_app_data(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        remote_app = 'postgresql'
+        rel_id = harness.add_relation('db', remote_app)
+        harness.update_relation_data(rel_id, 'postgresql', {'app': 'data'})
+        self.assertIsInstance(rel_id, int)
+        backend = harness._backend
+        self.assertEqual([rel_id], backend.relation_ids('db'))
+        self.assertEqual({'app': 'data'}, backend.relation_get(rel_id, remote_app, is_app=True))
+
+    def test_add_relation_with_our_initial_data(self):
+
+        class InitialDataTester(CharmBase):
+            """Record the relation-changed events."""
+
+            def __init__(self, framework):
+                super().__init__(framework)
+                self.observed_events = []
+                self.framework.observe(self.on.db_relation_changed, self._on_db_relation_changed)
+
+            def _on_db_relation_changed(self, event):
+                self.observed_events.append(event)
+
+        # language=YAML
+        harness = Harness(InitialDataTester, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v1'})
+        harness.update_relation_data(rel_id, 'test-app/0', {'ingress-address': '192.0.2.1'})
+        backend = harness._backend
+        self.assertEqual({'k': 'v1'}, backend.relation_get(rel_id, 'test-app', is_app=True))
+        self.assertEqual({'ingress-address': '192.0.2.1'},
+                         backend.relation_get(rel_id, 'test-app/0', is_app=False))
+
+        harness.begin()
+        self.assertEqual({'k': 'v1'}, backend.relation_get(rel_id, 'test-app', is_app=True))
+        self.assertEqual({'ingress-address': '192.0.2.1'},
+                         backend.relation_get(rel_id, 'test-app/0', is_app=False))
+        # Make sure no relation-changed events are emitted for our own data bags.
+        self.assertEqual([], harness.charm.observed_events)
+
+        # A remote unit can still update our app relation data bag since our unit is not a leader.
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v2'})
+        # And we get an event
+        self.assertEqual([], harness.charm.observed_events)
+        # We can also update our own relation data, even if it is a bit 'cheaty'
+        harness.update_relation_data(rel_id, 'test-app/0', {'ingress-address': '192.0.2.2'})
+        # But no event happens
+
+        # Updating our data app relation data bag and our unit data bag does not generate events.
+        harness.set_leader(True)
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v3'})
+        harness.update_relation_data(rel_id, 'test-app/0', {'ingress-address': '192.0.2.2'})
+        self.assertEqual([], harness.charm.observed_events)
+
+    def test_add_peer_relation_with_initial_data_leader(self):
+
+        class InitialDataTester(CharmBase):
+            """Record the relation-changed events."""
+
+            def __init__(self, framework):
+                super().__init__(framework)
+                self.observed_events = []
+                self.framework.observe(self.on.cluster_relation_changed,
+                                       self._on_cluster_relation_changed)
+
+            def _on_cluster_relation_changed(self, event):
+                self.observed_events.append(event)
+
+        # language=YAML
+        harness = Harness(InitialDataTester, meta='''
+            name: test-app
+            peers:
+                cluster:
+                    interface: cluster
+            ''')
+        # TODO: dmitriis 2020-04-07 test a minion unit and initial peer relation app data
+        # events when the harness begins to emit events for initial data.
+        harness.set_leader(is_leader=True)
+        rel_id = harness.add_relation('cluster', 'test-app')
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v'})
+        harness.update_relation_data(rel_id, 'test-app/0', {'ingress-address': '192.0.2.1'})
+        backend = harness._backend
+        self.assertEqual({'k': 'v'}, backend.relation_get(rel_id, 'test-app', is_app=True))
+        self.assertEqual({'ingress-address': '192.0.2.1'},
+                         backend.relation_get(rel_id, 'test-app/0', is_app=False))
+
+        harness.begin()
+        self.assertEqual({'k': 'v'}, backend.relation_get(rel_id, 'test-app', is_app=True))
+        self.assertEqual({'ingress-address': '192.0.2.1'},
+                         backend.relation_get(rel_id, 'test-app/0', is_app=False))
+        # Make sure no relation-changed events are emitted for our own data bags.
+        self.assertEqual([], harness.charm.observed_events)
+
+        # Updating our app relation data bag and our unit data bag does not trigger events
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v2'})
+        harness.update_relation_data(rel_id, 'test-app/0', {'ingress-address': '192.0.2.2'})
+        self.assertEqual([], harness.charm.observed_events)
+
+        # If our unit becomes a minion, updating app relation data indirectly becomes possible
+        # and our charm gets notifications.
+        harness.set_leader(False)
+        harness.update_relation_data(rel_id, 'test-app', {'k': 'v3'})
+        self.assertEqual({'k': 'v3'}, backend.relation_get(rel_id, 'test-app', is_app=True))
+        self.assertTrue(len(harness.charm.observed_events), 1)
+        self.assertIsInstance(harness.charm.observed_events[0], RelationEvent)
+
+    def test_relation_events(self):
+        harness = Harness(RelationEventCharm, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+        ''')
+        harness.begin()
+        harness.charm.observe_relation_events('db')
+        self.assertEqual(harness.charm.get_changes(), [])
+        rel_id = harness.add_relation('db', 'postgresql')
+        self.assertEqual(
+            harness.charm.get_changes(),
+            [{'name': 'relation-created',
+              'data': {
+                  'app': 'postgresql',
+                  'unit': None,
+                  'relation_id': rel_id,
+              }}])
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        self.assertEqual(
+            harness.charm.get_changes(),
+            [{'name': 'relation-joined',
+              'data': {
+                  'app': 'postgresql',
+                  'unit': 'postgresql/0',
+                  'relation_id': rel_id,
+              }}])
+        harness.update_relation_data(rel_id, 'postgresql', {'foo': 'bar'})
+        self.assertEqual(
+            harness.charm.get_changes(),
+            [{'name': 'relation-changed',
+              'data': {
+                  'app': 'postgresql',
+                  'unit': None,
+                  'relation_id': rel_id,
+              }}])
+        harness.update_relation_data(rel_id, 'postgresql/0', {'baz': 'bing'})
+        self.assertEqual(
+            harness.charm.get_changes(),
+            [{'name': 'relation-changed',
+              'data': {
+                  'app': 'postgresql',
+                  'unit': 'postgresql/0',
+                  'relation_id': rel_id,
+              }}])
+
+    def test_get_relation_data(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.update_relation_data(rel_id, 'postgresql', {'remote': 'data'})
+        self.assertEqual(harness.get_relation_data(rel_id, 'test-app'), {})
+        self.assertEqual(harness.get_relation_data(rel_id, 'test-app/0'), {})
+        self.assertEqual(harness.get_relation_data(rel_id, 'test-app/1'), None)
+        self.assertEqual(harness.get_relation_data(rel_id, 'postgresql'), {'remote': 'data'})
+        with self.assertRaises(KeyError):
+            # unknown relation id
+            harness.get_relation_data(99, 'postgresql')
+
+    def test_create_harness_twice(self):
+        metadata = '''
+            name: my-charm
+            requires:
+              db:
+                interface: pgsql
+            '''
+        harness1 = Harness(CharmBase, meta=metadata)
+        harness2 = Harness(CharmBase, meta=metadata)
+        harness1.begin()
+        harness2.begin()
+        helper1 = DBRelationChangedHelper(harness1.charm, "helper1")
+        helper2 = DBRelationChangedHelper(harness2.charm, "helper2")
+        rel_id = harness2.add_relation('db', 'postgresql')
+        harness2.update_relation_data(rel_id, 'postgresql', {'key': 'value'})
+        # Helper2 should see the event triggered by harness2, but helper1 should see no events.
+        self.assertEqual(helper1.changes, [])
+        self.assertEqual(helper2.changes, [(rel_id, 'postgresql')])
+
+    def test_begin_twice(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        harness.begin()
+        with self.assertRaises(RuntimeError):
+            harness.begin()
+
+    def test_update_relation_exposes_new_data(self):
+        harness = Harness(CharmBase, meta='''
+            name: my-charm
+            requires:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        viewer = RelationChangedViewer(harness.charm, 'db')
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        harness.update_relation_data(rel_id, 'postgresql/0', {'initial': 'data'})
+        self.assertEqual(viewer.changes, [{'initial': 'data'}])
+        harness.update_relation_data(rel_id, 'postgresql/0', {'new': 'value'})
+        self.assertEqual(viewer.changes, [{'initial': 'data'},
+                                          {'initial': 'data', 'new': 'value'}])
+
+    def test_update_relation_no_local_unit_change_event(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: my-charm
+            requires:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        helper = DBRelationChangedHelper(harness.charm, "helper")
+        rel_id = harness.add_relation('db', 'postgresql')
+        rel = harness.charm.model.get_relation('db')
+        rel.data[harness.charm.model.unit]['key'] = 'value'
+        # there should be no event for updating our own data
+        harness.update_relation_data(rel_id, 'my-charm/0', {'new': 'other'})
+        # but the data will be updated.
+        self.assertEqual({'key': 'value', 'new': 'other'}, rel.data[harness.charm.model.unit])
+
+        rel.data[harness.charm.model.unit]['new'] = 'value'
+        # Our unit data bag got updated.
+        self.assertEqual(rel.data[harness.charm.model.unit]['new'], 'value')
+        # But there were no changed events registered by our unit.
+        self.assertEqual([], helper.changes)
+
+    def test_update_peer_relation_no_local_unit_change_event(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: postgresql
+            peers:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        helper = DBRelationChangedHelper(harness.charm, "helper")
+        rel_id = harness.add_relation('db', 'postgresql')
+
+        rel = harness.charm.model.get_relation('db')
+        rel.data[harness.charm.model.unit]['key'] = 'value'
+        rel = harness.charm.model.get_relation('db')
+        harness.update_relation_data(rel_id, 'postgresql/0', {'key': 'v1'})
+        self.assertEqual({'key': 'v1'}, rel.data[harness.charm.model.unit])
+        # Make sure there was no event
+        self.assertEqual([], helper.changes)
+
+        rel.data[harness.charm.model.unit]['key'] = 'v2'
+        # Our unit data bag got updated.
+        self.assertEqual({'key': 'v2'}, dict(rel.data[harness.charm.model.unit]))
+        # But there were no changed events registered by our unit.
+        self.assertEqual([], helper.changes)
+
+        # Same for when our unit is a leader.
+        harness.set_leader(is_leader=True)
+        harness.update_relation_data(rel_id, 'postgresql/0', {'key': 'v3'})
+        self.assertEqual({'key': 'v3'}, dict(rel.data[harness.charm.model.unit]))
+        self.assertEqual([], helper.changes)
+
+        rel.data[harness.charm.model.unit]['key'] = 'v4'
+        self.assertEqual(rel.data[harness.charm.model.unit]['key'], 'v4')
+        self.assertEqual([], helper.changes)
+
+    def test_update_peer_relation_app_data(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: postgresql
+            peers:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        harness.set_leader(is_leader=True)
+        helper = DBRelationChangedHelper(harness.charm, "helper")
+        rel_id = harness.add_relation('db', 'postgresql')
+        rel = harness.charm.model.get_relation('db')
+        rel.data[harness.charm.app]['key'] = 'value'
+        harness.update_relation_data(rel_id, 'postgresql', {'key': 'v1'})
+        self.assertEqual({'key': 'v1'}, rel.data[harness.charm.app])
+        self.assertEqual([], helper.changes)
+
+        rel.data[harness.charm.app]['key'] = 'v2'
+        # Our unit data bag got updated.
+        self.assertEqual(rel.data[harness.charm.model.app]['key'], 'v2')
+        # But there were no changed events registered by our unit.
+        self.assertEqual([], helper.changes)
+
+        # If our unit is not a leader unit we get an update about peer app relation data changes.
+        harness.set_leader(is_leader=False)
+        harness.update_relation_data(rel_id, 'postgresql', {'k2': 'v2'})
+        self.assertEqual(rel.data[harness.charm.model.app]['k2'], 'v2')
+        self.assertEqual(helper.changes, [(0, 'postgresql')])
+
+    def test_update_relation_no_local_app_change_event(self):
+        # language=YAML
+        harness = Harness(CharmBase, meta='''
+            name: my-charm
+            requires:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        harness.set_leader(False)
+        helper = DBRelationChangedHelper(harness.charm, "helper")
+        rel_id = harness.add_relation('db', 'postgresql')
+        # TODO: remove this as soon as https://github.com/canonical/operator/issues/175 is fixed.
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        self.assertEqual(helper.changes, [])
+
+        harness.update_relation_data(rel_id, 'my-charm', {'new': 'value'})
+        rel = harness.charm.model.get_relation('db')
+        self.assertEqual(rel.data[harness.charm.app]['new'], 'value')
+
+        # Our app data bag got updated.
+        self.assertEqual(rel.data[harness.charm.model.app]['new'], 'value')
+        # But there were no changed events registered by our unit.
+        self.assertEqual(helper.changes, [])
+
+    def test_update_relation_remove_data(self):
+        harness = Harness(CharmBase, meta='''
+            name: my-charm
+            requires:
+              db:
+                interface: pgsql
+            ''')
+        harness.begin()
+        viewer = RelationChangedViewer(harness.charm, 'db')
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        harness.update_relation_data(rel_id, 'postgresql/0', {'initial': 'data'})
+        harness.update_relation_data(rel_id, 'postgresql/0', {'initial': ''})
+        self.assertEqual(viewer.changes, [{'initial': 'data'}, {}])
+
+    def test_update_config(self):
+        harness = Harness(RecordingCharm)
+        harness.begin()
+        harness.update_config(key_values={'a': 'foo', 'b': 2})
+        self.assertEqual(
+            harness.charm.changes,
+            [{'name': 'config', 'data': {'a': 'foo', 'b': 2}}])
+        harness.update_config(key_values={'b': 3})
+        self.assertEqual(
+            harness.charm.changes,
+            [{'name': 'config', 'data': {'a': 'foo', 'b': 2}},
+             {'name': 'config', 'data': {'a': 'foo', 'b': 3}}])
+        # you can set config values to the empty string, you can use unset to actually remove items
+        harness.update_config(key_values={'a': ''}, unset=set('b'))
+        self.assertEqual(
+            harness.charm.changes,
+            [{'name': 'config', 'data': {'a': 'foo', 'b': 2}},
+             {'name': 'config', 'data': {'a': 'foo', 'b': 3}},
+             {'name': 'config', 'data': {'a': ''}},
+             ])
+
+    def test_set_leader(self):
+        harness = Harness(RecordingCharm)
+        # No event happens here
+        harness.set_leader(False)
+        harness.begin()
+        self.assertFalse(harness.charm.model.unit.is_leader())
+        harness.set_leader(True)
+        self.assertEqual(harness.charm.get_changes(reset=True), [{'name': 'leader-elected'}])
+        self.assertTrue(harness.charm.model.unit.is_leader())
+        harness.set_leader(False)
+        self.assertFalse(harness.charm.model.unit.is_leader())
+        # No hook event when you lose leadership.
+        # TODO: verify if Juju always triggers `leader-settings-changed` if you
+        #   lose leadership.
+        self.assertEqual(harness.charm.get_changes(reset=True), [])
+        harness.disable_hooks()
+        harness.set_leader(True)
+        # No hook event if you have disabled them
+        self.assertEqual(harness.charm.get_changes(reset=True), [])
+
+    def test_relation_set_app_not_leader(self):
+        harness = Harness(RecordingCharm, meta='''
+            name: test-charm
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        harness.begin()
+        harness.set_leader(False)
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        rel = harness.charm.model.get_relation('db')
+        with self.assertRaises(ModelError):
+            rel.data[harness.charm.app]['foo'] = 'bar'
+        # The data has not actually been changed
+        self.assertEqual(harness.get_relation_data(rel_id, 'test-charm'), {})
+        harness.set_leader(True)
+        rel.data[harness.charm.app]['foo'] = 'bar'
+        self.assertEqual(harness.get_relation_data(rel_id, 'test-charm'), {'foo': 'bar'})
+
+    def test_hooks_enabled_and_disabled(self):
+        harness = Harness(RecordingCharm, meta='''
+            name: test-charm
+        ''')
+        # Before begin() there are no events.
+        harness.update_config({'value': 'first'})
+        # By default, after begin the charm is set up to receive events.
+        harness.begin()
+        harness.update_config({'value': 'second'})
+        self.assertEqual(
+            harness.charm.get_changes(reset=True),
+            [{'name': 'config', 'data': {'value': 'second'}}])
+        # Once disabled, we won't see config-changed when we make an update
+        harness.disable_hooks()
+        harness.update_config({'third': '3'})
+        self.assertEqual(harness.charm.get_changes(reset=True), [])
+        harness.enable_hooks()
+        harness.update_config({'value': 'fourth'})
+        self.assertEqual(
+            harness.charm.get_changes(reset=True),
+            [{'name': 'config', 'data': {'value': 'fourth', 'third': '3'}}])
+
+    def test_metadata_from_directory(self):
+        tmp = pathlib.Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, str(tmp))
+        metadata_filename = tmp / 'metadata.yaml'
+        with metadata_filename.open('wt') as metadata:
+            metadata.write(textwrap.dedent('''
+            name: my-charm
+            requires:
+                db:
+                    interface: pgsql
+            '''))
+        harness = self._get_dummy_charm_harness(tmp)
+        harness.begin()
+        self.assertEqual(list(harness.model.relations), ['db'])
+        # The charm_dir also gets set
+        self.assertEqual(harness.framework.charm_dir, tmp)
+
+    def test_set_model_name(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+        ''')
+        harness.set_model_name('foo')
+        self.assertEqual('foo', harness.model.name)
+
+    def test_set_model_name_after_begin(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+        ''')
+        harness.set_model_name('bar')
+        harness.begin()
+        with self.assertRaises(RuntimeError):
+            harness.set_model_name('foo')
+        self.assertEqual(harness.model.name, 'bar')
+
+    def test_actions_from_directory(self):
+        tmp = pathlib.Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, str(tmp))
+        actions_filename = tmp / 'actions.yaml'
+        with actions_filename.open('wt') as actions:
+            actions.write(textwrap.dedent('''
+            test:
+                description: a dummy action
+            '''))
+        harness = self._get_dummy_charm_harness(tmp)
+        harness.begin()
+        self.assertEqual(list(harness.framework.meta.actions), ['test'])
+        # The charm_dir also gets set
+        self.assertEqual(harness.framework.charm_dir, tmp)
+
+    def _get_dummy_charm_harness(self, tmp):
+        self._write_dummy_charm(tmp)
+        charm_mod = importlib.import_module('charm')
+        harness = Harness(charm_mod.MyTestingCharm)
+        return harness
+
+    def _write_dummy_charm(self, tmp):
+        srcdir = tmp / 'src'
+        srcdir.mkdir(0o755)
+        charm_filename = srcdir / 'charm.py'
+        with charm_filename.open('wt') as charmpy:
+            # language=Python
+            charmpy.write(textwrap.dedent('''
+                from ops.charm import CharmBase
+                class MyTestingCharm(CharmBase):
+                    pass
+                '''))
+        orig = sys.path[:]
+        sys.path.append(str(srcdir))
+
+        def cleanup():
+            sys.path = orig
+            sys.modules.pop('charm')
+
+        self.addCleanup(cleanup)
+
+    def test_actions_passed_in(self):
+        harness = Harness(
+            CharmBase,
+            meta='''
+                name: test-app
+            ''',
+            actions='''
+                test-action:
+                    description: a dummy test action
+            ''')
+        self.assertEqual(list(harness.framework.meta.actions), ['test-action'])
+
+    def test_relation_set_deletes(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        harness.begin()
+        harness.set_leader(False)
+        rel_id = harness.add_relation('db', 'postgresql')
+        harness.update_relation_data(rel_id, 'test-charm/0', {'foo': 'bar'})
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        rel = harness.charm.model.get_relation('db', rel_id)
+        del rel.data[harness.charm.model.unit]['foo']
+        self.assertEqual({}, harness.get_relation_data(rel_id, 'test-charm/0'))
+
+    def test_set_workload_version(self):
+        harness = Harness(CharmBase, meta='''
+            name: app
+            ''')
+        harness.begin()
+        self.assertIsNone(harness.get_workload_version())
+        harness.charm.model.unit.set_workload_version('1.2.3')
+        self.assertEqual(harness.get_workload_version(), '1.2.3')
+
+    def test_get_backend_calls(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        harness.begin()
+        # No calls to the backend yet
+        self.assertEqual(harness._get_backend_calls(), [])
+        rel_id = harness.add_relation('db', 'postgresql')
+        # update_relation_data ensures the cached data for the relation is wiped
+        harness.update_relation_data(rel_id, 'test-charm/0', {'foo': 'bar'})
+        self.assertEqual(
+            harness._get_backend_calls(reset=True), [
+                ('relation_ids', 'db'),
+                ('relation_list', rel_id),
+            ])
+        # add_relation_unit resets the relation_list, but doesn't trigger backend calls
+        harness.add_relation_unit(rel_id, 'postgresql/0')
+        self.assertEqual([], harness._get_backend_calls(reset=False))
+        # however, update_relation_data does, because we are preparing relation-changed
+        harness.update_relation_data(rel_id, 'postgresql/0', {'foo': 'bar'})
+        self.assertEqual(
+            harness._get_backend_calls(reset=False), [
+                ('relation_ids', 'db'),
+                ('relation_list', rel_id),
+            ])
+        # If we check again, they are still there, but now we reset it
+        self.assertEqual(
+            harness._get_backend_calls(reset=True), [
+                ('relation_ids', 'db'),
+                ('relation_list', rel_id),
+            ])
+        # And the calls are gone
+        self.assertEqual(harness._get_backend_calls(), [])
+
+    def test_get_backend_calls_with_kwargs(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            requires:
+                db:
+                    interface: pgsql
+            ''')
+        harness.begin()
+        unit = harness.charm.model.unit
+        # Reset the list, because we don't care what it took to get here
+        harness._get_backend_calls(reset=True)
+        unit.status = ActiveStatus()
+        self.assertEqual(
+            [('status_set', 'active', '', {'is_app': False})], harness._get_backend_calls())
+        harness.set_leader(True)
+        app = harness.charm.model.app
+        harness._get_backend_calls(reset=True)
+        app.status = ActiveStatus('message')
+        self.assertEqual(
+            [('is_leader',),
+             ('status_set', 'active', 'message', {'is_app': True})],
+            harness._get_backend_calls())
+
+    def test_unit_status(self):
+        harness = Harness(CharmBase, meta='name: test-app')
+        harness.set_leader(True)
+        harness.begin()
+        # default status
+        self.assertEqual(harness.model.unit.status, MaintenanceStatus(''))
+        status = ActiveStatus('message')
+        harness.model.unit.status = status
+        self.assertEqual(harness.model.unit.status, status)
+
+    def test_app_status(self):
+        harness = Harness(CharmBase, meta='name: test-app')
+        harness.set_leader(True)
+        harness.begin()
+        # default status
+        self.assertEqual(harness.model.app.status, UnknownStatus())
+        status = ActiveStatus('message')
+        harness.model.app.status = status
+        self.assertEqual(harness.model.app.status, status)
+
+
+class DBRelationChangedHelper(Object):
+    def __init__(self, parent, key):
+        super().__init__(parent, key)
+        self.changes = []
+        parent.framework.observe(parent.on.db_relation_changed, self.on_relation_changed)
+
+    def on_relation_changed(self, event):
+        if event.unit is not None:
+            self.changes.append((event.relation.id, event.unit.name))
+        else:
+            self.changes.append((event.relation.id, event.app.name))
+
+
+class RelationChangedViewer(Object):
+    """Track relation_changed events and saves the data seen in the relation bucket."""
+
+    def __init__(self, charm, relation_name):
+        super().__init__(charm, relation_name)
+        self.changes = []
+        charm.framework.observe(charm.on[relation_name].relation_changed, self.on_relation_changed)
+
+    def on_relation_changed(self, event):
+        if event.unit is not None:
+            data = event.relation.data[event.unit]
+        else:
+            data = event.relation.data[event.app]
+        self.changes.append(dict(data))
+
+
+class RecordingCharm(CharmBase):
+    """Record the events that we see, and any associated data."""
+
+    def __init__(self, framework):
+        super().__init__(framework)
+        self.changes = []
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.leader_elected, self.on_leader_elected)
+
+    def get_changes(self, reset=True):
+        changes = self.changes
+        if reset:
+            self.changes = []
+        return changes
+
+    def on_config_changed(self, _):
+        self.changes.append(dict(name='config', data=dict(self.framework.model.config)))
+
+    def on_leader_elected(self, _):
+        self.changes.append(dict(name='leader-elected'))
+
+
+class RelationEventCharm(RecordingCharm):
+    """Record events related to relation lifecycles."""
+
+    def __init__(self, framework):
+        super().__init__(framework)
+
+    def observe_relation_events(self, relation_name):
+        self.framework.observe(self.on[relation_name].relation_created, self._on_relation_created)
+        self.framework.observe(self.on[relation_name].relation_joined, self._on_relation_joined)
+        self.framework.observe(self.on[relation_name].relation_changed, self._on_relation_changed)
+        self.framework.observe(self.on[relation_name].relation_departed,
+                               self._on_relation_departed)
+        self.framework.observe(self.on[relation_name].relation_broken, self._on_relation_broken)
+
+    def _on_relation_created(self, event):
+        self._observe_relation_event('relation-created', event)
+
+    def _on_relation_joined(self, event):
+        self._observe_relation_event('relation-joined', event)
+
+    def _on_relation_changed(self, event):
+        self._observe_relation_event('relation-changed', event)
+
+    def _on_relation_departed(self, event):
+        self._observe_relation_event('relation-departed', event)
+
+    def _on_relation_broken(self, event):
+        self._observe_relation_event('relation-broken', event)
+
+    def _observe_relation_event(self, event_name, event):
+        unit_name = None
+        if event.unit is not None:
+            unit_name = event.unit.name
+        app_name = None
+        if event.app is not None:
+            app_name = event.app.name
+        self.changes.append(
+            dict(name=event_name,
+                 data=dict(app=app_name, unit=unit_name, relation_id=event.relation.id)))
+
+
+class TestTestingModelBackend(unittest.TestCase):
+
+    def test_status_set_get_unit(self):
+        harness = Harness(CharmBase, meta='''
+            name: app
+            ''')
+        backend = harness._backend
+        backend.status_set('blocked', 'message', is_app=False)
+        self.assertEqual(
+            backend.status_get(is_app=False),
+            {'status': 'blocked', 'message': 'message'})
+        self.assertEqual(
+            backend.status_get(is_app=True),
+            {'status': 'unknown', 'message': ''})
+
+    def test_status_set_get_app(self):
+        harness = Harness(CharmBase, meta='''
+            name: app
+            ''')
+        backend = harness._backend
+        backend.status_set('blocked', 'message', is_app=True)
+        self.assertEqual(
+            backend.status_get(is_app=True),
+            {'status': 'blocked', 'message': 'message'})
+        self.assertEqual(
+            backend.status_get(is_app=False),
+            {'status': 'maintenance', 'message': ''})
+
+    def test_relation_ids_unknown_relation(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            provides:
+              db:
+                interface: mydb
+            ''')
+        backend = harness._backend
+        # With no relations added, we just get an empty list for the interface
+        self.assertEqual(backend.relation_ids('db'), [])
+        # But an unknown interface raises a ModelError
+        with self.assertRaises(ModelError):
+            backend.relation_ids('unknown')
+
+    def test_relation_get_unknown_relation_id(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            ''')
+        backend = harness._backend
+        with self.assertRaises(RelationNotFoundError):
+            backend.relation_get(1234, 'unit/0', False)
+
+    def test_relation_list_unknown_relation_id(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-charm
+            ''')
+        backend = harness._backend
+        with self.assertRaises(RelationNotFoundError):
+            backend.relation_list(1234)
+
+    def test_populate_oci_resources(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            resources:
+              image:
+                type: oci-image
+                description: "Image to deploy."
+              image2:
+                type: oci-image
+                description: "Another image."
+            ''')
+        harness.populate_oci_resources()
+        resource = harness._resource_dir / "image" / "contents.yaml"
+        with resource.open('r') as resource_file:
+            contents = yaml.safe_load(resource_file.read())
+        self.assertEqual(contents['registrypath'], 'registrypath')
+        self.assertEqual(contents['username'], 'username')
+        self.assertEqual(contents['password'], 'password')
+        self.assertEqual(len(harness._backend._resources_map), 2)
+
+    def test_resource_folder_cleanup(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            resources:
+              image:
+                type: oci-image
+                description: "Image to deploy."
+            ''')
+        harness.populate_oci_resources()
+        resource = harness._resource_dir / "image" / "contents.yaml"
+        del harness
+        with self.assertRaises(FileNotFoundError):
+            with resource.open('r') as resource_file:
+                print("This shouldn't be here: {}".format(resource_file))
+
+    def test_add_oci_resource_custom(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            resources:
+              image:
+                type: oci-image
+                description: "Image to deploy."
+            ''')
+        custom = {
+            "registrypath": "custompath",
+            "username": "custom_username",
+            "password": "custom_password",
+        }
+        harness.add_oci_resource('image', custom)
+        resource = harness._resource_dir / "image" / "contents.yaml"
+        with resource.open('r') as resource_file:
+            contents = yaml.safe_load(resource_file.read())
+        self.assertEqual(contents['registrypath'], 'custompath')
+        self.assertEqual(contents['username'], 'custom_username')
+        self.assertEqual(contents['password'], 'custom_password')
+        self.assertEqual(len(harness._backend._resources_map), 1)
+
+    def test_add_oci_resource_no_image(self):
+        harness = Harness(CharmBase, meta='''
+            name: test-app
+            resources:
+              image:
+                type: file
+                description: "Image to deploy."
+            ''')
+        with self.assertRaises(RuntimeError):
+            harness.add_oci_resource("image")
+        with self.assertRaises(RuntimeError):
+            harness.add_oci_resource("missing-resource")
+        self.assertEqual(len(harness._backend._resources_map), 0)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/add-port-forward.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/add-port-forward.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5d48d75870345d86b3aaa2ae06204bffe2dfe00e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/add-port-forward.yaml
@@ -0,0 +1,13 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_config:
+        lines:
+          - nat destination rule {{ ruleNumber }} destination port "{{ sourcePort }}"
+          - nat destination rule {{ ruleNumber }} inbound-interface "eth0"
+          - nat destination rule {{ ruleNumber }} protocol "tcp"
+          - nat destination rule {{ ruleNumber }} translation port    "{{ destinationPort }}"
+          - nat destination rule {{ ruleNumber }} translation address "{{ destinationAddress }}"
+        save: yes
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/backup.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/backup.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c83de0831c8271bdd5477e6fd3c012d204df7ac1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/backup.yaml
@@ -0,0 +1,9 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_config:
+        backup: yes
+        backup_options:
+          filename: "{{ backupFile }}"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/configure-remote.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/configure-remote.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cc0232fae05dca7c81301a771a07b133f006a75c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/configure-remote.yaml
@@ -0,0 +1,8 @@
+- hosts: vyos-routers
+  connection: local
+  tasks:
+  - name: add a host to the list of allowed in the firewall group
+    vyos_config:
+      lines:
+        - set firewall group network-group MAGMA_AGW network "{{ MAGMA_AGW_IP }}/32"
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/remove-port-forward.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/remove-port-forward.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..61c12f955f95d172f2da52a7049329470071bf3c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/remove-port-forward.yaml
@@ -0,0 +1,11 @@
+- hosts: vyos-routers
+  gather_facts: false
+  connection: local
+  tasks:
+    - name: backup switch (vyos)
+      vyos_command:
+        commands:
+          - config
+          - delete nat destination rule {{ ruleNumber }}
+          - commit
+          - save
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/restore.yaml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/restore.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..20051c42fa13639fc25ca99e5751022e0fbe0249
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/playbooks/restore.yaml
@@ -0,0 +1,7 @@
+- hosts: vyos-routers
+  connection: local
+  tasks:
+  - name: Performs a restore a previously created backup
+    vyos_config:
+      lines:
+        - load "/home/osm/{{ backupFile }}"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/requirements.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/src/charm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..6f97799ce1827c2da22ea51cd6453564bf83321c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/src/charm.py
@@ -0,0 +1,112 @@
+#!/usr/bin/env python3
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+import os
+import subprocess
+import sys
+import traceback
+
+from charms.osm import libansible
+from charms.osm.sshproxy import SSHProxyCharm
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+
+
+sys.path.append("lib")
+
+
+class VyosCharm(SSHProxyCharm):
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Register all of the events we want to observe
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+        self.framework.observe(self.on.upgrade_charm, self.on_upgrade_charm)
+        # Charm actions (primitives)
+        self.framework.observe(
+            self.on.add_port_forward_action, self.on_add_port_forward_action
+        )
+        self.framework.observe(
+            self.on.remove_port_forward_action, self.on_remove_port_forward_action
+        )
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+        self.unit.status = MaintenanceStatus("Installing Ansible")
+        libansible.install_ansible_support()
+        self.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_add_port_forward_action(self, event):
+        """Adds a port forward rule."""
+        self._run_playbook(
+            event,
+            "add-port-forward.yaml",
+            {
+                "sourcePort": event.params["sourcePort"],
+                "destinationPort": event.params["destinationPort"],
+                "destinationAddress": event.params["destinationAddress"],
+                "ruleNumber": event.params["ruleNumber"],
+            })
+
+    def on_remove_port_forward_action(self, event):
+        """Remove a port forward rule."""
+        self._run_playbook(
+            event,
+            "remove-port-forward.yaml",
+            {
+                "ruleNumber": event.params["ruleNumber"],
+            })
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+
+    def _run_playbook(self, event, playbook, variables):
+        try:
+            config = self.model.config
+            result = libansible.execute_playbook(
+                playbook,
+                config["ssh-hostname"],
+                config["ssh-username"],
+                config["ssh-password"],
+                variables,
+            )
+            event.set_results({"output": result})
+        except:
+            exc_type, exc_value, exc_traceback = sys.exc_info()
+            err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+            event.fail(message="Playbook " + playbook + " failed: " + str(err))
+
+
+if __name__ == "__main__":
+    main(VyosCharm)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate
new file mode 100644
index 0000000000000000000000000000000000000000..3b8d0b2918a4bb421dc5d6b7cfc6e55c7f4ea480
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate
@@ -0,0 +1,84 @@
+# This file must be used with "source bin/activate" *from bash*
+# you cannot run it directly
+
+
+if [ "${BASH_SOURCE-}" = "$0" ]; then
+    echo "You must source this script: \$ source $0" >&2
+    exit 33
+fi
+
+deactivate () {
+    unset -f pydoc >/dev/null 2>&1
+
+    # reset old environment variables
+    # ! [ -z ${VAR+_} ] returns true if VAR is declared at all
+    if ! [ -z "${_OLD_VIRTUAL_PATH:+_}" ] ; then
+        PATH="$_OLD_VIRTUAL_PATH"
+        export PATH
+        unset _OLD_VIRTUAL_PATH
+    fi
+    if ! [ -z "${_OLD_VIRTUAL_PYTHONHOME+_}" ] ; then
+        PYTHONHOME="$_OLD_VIRTUAL_PYTHONHOME"
+        export PYTHONHOME
+        unset _OLD_VIRTUAL_PYTHONHOME
+    fi
+
+    # This should detect bash and zsh, which have a hash command that must
+    # be called to get it to forget past commands.  Without forgetting
+    # past commands the $PATH changes we made may not be respected
+    if [ -n "${BASH-}" ] || [ -n "${ZSH_VERSION-}" ] ; then
+        hash -r 2>/dev/null
+    fi
+
+    if ! [ -z "${_OLD_VIRTUAL_PS1+_}" ] ; then
+        PS1="$_OLD_VIRTUAL_PS1"
+        export PS1
+        unset _OLD_VIRTUAL_PS1
+    fi
+
+    unset VIRTUAL_ENV
+    if [ ! "${1-}" = "nondestructive" ] ; then
+    # Self destruct!
+        unset -f deactivate
+    fi
+}
+
+# unset irrelevant variables
+deactivate nondestructive
+
+VIRTUAL_ENV='/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv'
+export VIRTUAL_ENV
+
+_OLD_VIRTUAL_PATH="$PATH"
+PATH="$VIRTUAL_ENV/bin:$PATH"
+export PATH
+
+# unset PYTHONHOME if set
+if ! [ -z "${PYTHONHOME+_}" ] ; then
+    _OLD_VIRTUAL_PYTHONHOME="$PYTHONHOME"
+    unset PYTHONHOME
+fi
+
+if [ -z "${VIRTUAL_ENV_DISABLE_PROMPT-}" ] ; then
+    _OLD_VIRTUAL_PS1="${PS1-}"
+    if [ "x" != x ] ; then
+        PS1="${PS1-}"
+    else
+        PS1="(`basename \"$VIRTUAL_ENV\"`) ${PS1-}"
+    fi
+    export PS1
+fi
+
+# Make sure to unalias pydoc if it's already there
+alias pydoc 2>/dev/null >/dev/null && unalias pydoc || true
+
+pydoc () {
+    python -m pydoc "$@"
+}
+
+# This should detect bash and zsh, which have a hash command that must
+# be called to get it to forget past commands.  Without forgetting
+# past commands the $PATH changes we made may not be respected
+if [ -n "${BASH-}" ] || [ -n "${ZSH_VERSION-}" ] ; then
+    hash -r 2>/dev/null
+fi
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.csh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.csh
new file mode 100644
index 0000000000000000000000000000000000000000..823028c01c915886e29683e8d0caf32255f363ed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.csh
@@ -0,0 +1,55 @@
+# This file must be used with "source bin/activate.csh" *from csh*.
+# You cannot run it directly.
+# Created by Davide Di Blasi <davidedb@gmail.com>.
+
+set newline='\
+'
+
+alias deactivate 'test $?_OLD_VIRTUAL_PATH != 0 && setenv PATH "$_OLD_VIRTUAL_PATH:q" && unset _OLD_VIRTUAL_PATH; rehash; test $?_OLD_VIRTUAL_PROMPT != 0 && set prompt="$_OLD_VIRTUAL_PROMPT:q" && unset _OLD_VIRTUAL_PROMPT; unsetenv VIRTUAL_ENV; test "\!:*" != "nondestructive" && unalias deactivate && unalias pydoc'
+
+# Unset irrelevant variables.
+deactivate nondestructive
+
+setenv VIRTUAL_ENV '/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv'
+
+set _OLD_VIRTUAL_PATH="$PATH:q"
+setenv PATH "$VIRTUAL_ENV:q/bin:$PATH:q"
+
+
+
+if ('' != "") then
+    set env_name = ''
+else
+    set env_name = '('"$VIRTUAL_ENV:t:q"') '
+endif
+
+if ( $?VIRTUAL_ENV_DISABLE_PROMPT ) then
+    if ( $VIRTUAL_ENV_DISABLE_PROMPT == "" ) then
+        set do_prompt = "1"
+    else
+        set do_prompt = "0"
+    endif
+else
+    set do_prompt = "1"
+endif
+
+if ( $do_prompt == "1" ) then
+    # Could be in a non-interactive environment,
+    # in which case, $prompt is undefined and we wouldn't
+    # care about the prompt anyway.
+    if ( $?prompt ) then
+        set _OLD_VIRTUAL_PROMPT="$prompt:q"
+        if ( "$prompt:q" =~ *"$newline:q"* ) then
+            :
+        else
+            set prompt = "$env_name:q$prompt:q"
+        endif
+    endif
+endif
+
+unset env_name
+unset do_prompt
+
+alias pydoc python -m pydoc
+
+rehash
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.fish b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.fish
new file mode 100644
index 0000000000000000000000000000000000000000..5c50244a11153a5c9791366f4362b157594338b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.fish
@@ -0,0 +1,100 @@
+# This file must be used using `source bin/activate.fish` *within a running fish ( http://fishshell.com ) session*.
+# Do not run it directly.
+
+function _bashify_path -d "Converts a fish path to something bash can recognize"
+    set fishy_path $argv
+    set bashy_path $fishy_path[1]
+    for path_part in $fishy_path[2..-1]
+        set bashy_path "$bashy_path:$path_part"
+    end
+    echo $bashy_path
+end
+
+function _fishify_path -d "Converts a bash path to something fish can recognize"
+    echo $argv | tr ':' '\n'
+end
+
+function deactivate -d 'Exit virtualenv mode and return to the normal environment.'
+    # reset old environment variables
+    if test -n "$_OLD_VIRTUAL_PATH"
+        # https://github.com/fish-shell/fish-shell/issues/436 altered PATH handling
+        if test (echo $FISH_VERSION | head -c 1) -lt 3
+            set -gx PATH (_fishify_path "$_OLD_VIRTUAL_PATH")
+        else
+            set -gx PATH "$_OLD_VIRTUAL_PATH"
+        end
+        set -e _OLD_VIRTUAL_PATH
+    end
+
+    if test -n "$_OLD_VIRTUAL_PYTHONHOME"
+        set -gx PYTHONHOME "$_OLD_VIRTUAL_PYTHONHOME"
+        set -e _OLD_VIRTUAL_PYTHONHOME
+    end
+
+    if test -n "$_OLD_FISH_PROMPT_OVERRIDE"
+       and functions -q _old_fish_prompt
+        # Set an empty local `$fish_function_path` to allow the removal of `fish_prompt` using `functions -e`.
+        set -l fish_function_path
+
+        # Erase virtualenv's `fish_prompt` and restore the original.
+        functions -e fish_prompt
+        functions -c _old_fish_prompt fish_prompt
+        functions -e _old_fish_prompt
+        set -e _OLD_FISH_PROMPT_OVERRIDE
+    end
+
+    set -e VIRTUAL_ENV
+
+    if test "$argv[1]" != 'nondestructive'
+        # Self-destruct!
+        functions -e pydoc
+        functions -e deactivate
+        functions -e _bashify_path
+        functions -e _fishify_path
+    end
+end
+
+# Unset irrelevant variables.
+deactivate nondestructive
+
+set -gx VIRTUAL_ENV '/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv'
+
+# https://github.com/fish-shell/fish-shell/issues/436 altered PATH handling
+if test (echo $FISH_VERSION | head -c 1) -lt 3
+   set -gx _OLD_VIRTUAL_PATH (_bashify_path $PATH)
+else
+    set -gx _OLD_VIRTUAL_PATH "$PATH"
+end
+set -gx PATH "$VIRTUAL_ENV"'/bin' $PATH
+
+# Unset `$PYTHONHOME` if set.
+if set -q PYTHONHOME
+    set -gx _OLD_VIRTUAL_PYTHONHOME $PYTHONHOME
+    set -e PYTHONHOME
+end
+
+function pydoc
+    python -m pydoc $argv
+end
+
+if test -z "$VIRTUAL_ENV_DISABLE_PROMPT"
+    # Copy the current `fish_prompt` function as `_old_fish_prompt`.
+    functions -c fish_prompt _old_fish_prompt
+
+    function fish_prompt
+        # Run the user's prompt first; it might depend on (pipe)status.
+        set -l prompt (_old_fish_prompt)
+
+        # Prompt override provided?
+        # If not, just prepend the environment name.
+        if test -n ''
+            printf '%s%s' '' (set_color normal)
+        else
+            printf '%s(%s) ' (set_color normal) (basename "$VIRTUAL_ENV")
+        end
+
+        string join -- \n $prompt # handle multi-line prompts
+    end
+
+    set -gx _OLD_FISH_PROMPT_OVERRIDE "$VIRTUAL_ENV"
+end
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.ps1 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.ps1
new file mode 100644
index 0000000000000000000000000000000000000000..95504d3956b326b1ae2ece60f5db082db8d8bf99
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.ps1
@@ -0,0 +1,60 @@
+$script:THIS_PATH = $myinvocation.mycommand.path
+$script:BASE_DIR = Split-Path (Resolve-Path "$THIS_PATH/..") -Parent
+
+function global:deactivate([switch] $NonDestructive) {
+    if (Test-Path variable:_OLD_VIRTUAL_PATH) {
+        $env:PATH = $variable:_OLD_VIRTUAL_PATH
+        Remove-Variable "_OLD_VIRTUAL_PATH" -Scope global
+    }
+
+    if (Test-Path function:_old_virtual_prompt) {
+        $function:prompt = $function:_old_virtual_prompt
+        Remove-Item function:\_old_virtual_prompt
+    }
+
+    if ($env:VIRTUAL_ENV) {
+        Remove-Item env:VIRTUAL_ENV -ErrorAction SilentlyContinue
+    }
+
+    if (!$NonDestructive) {
+        # Self destruct!
+        Remove-Item function:deactivate
+        Remove-Item function:pydoc
+    }
+}
+
+function global:pydoc {
+    python -m pydoc $args
+}
+
+# unset irrelevant variables
+deactivate -nondestructive
+
+$VIRTUAL_ENV = $BASE_DIR
+$env:VIRTUAL_ENV = $VIRTUAL_ENV
+
+New-Variable -Scope global -Name _OLD_VIRTUAL_PATH -Value $env:PATH
+
+$env:PATH = "$env:VIRTUAL_ENV/bin:" + $env:PATH
+if (!$env:VIRTUAL_ENV_DISABLE_PROMPT) {
+    function global:_old_virtual_prompt {
+        ""
+    }
+    $function:_old_virtual_prompt = $function:prompt
+
+    if ("" -ne "") {
+        function global:prompt {
+            # Add the custom prefix to the existing prompt
+            $previous_prompt_value = & $function:_old_virtual_prompt
+            ("" + $previous_prompt_value)
+        }
+    }
+    else {
+        function global:prompt {
+            # Add a prefix to the current prompt, but don't discard it.
+            $previous_prompt_value = & $function:_old_virtual_prompt
+            $new_prompt_value = "($( Split-Path $env:VIRTUAL_ENV -Leaf )) "
+            ($new_prompt_value + $previous_prompt_value)
+        }
+    }
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.xsh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.xsh
new file mode 100644
index 0000000000000000000000000000000000000000..9f6d410511a2994332207d34697c7e8612aa1ae6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate.xsh
@@ -0,0 +1,46 @@
+"""Xonsh activate script for virtualenv"""
+from xonsh.tools import get_sep as _get_sep
+
+def _deactivate(args):
+    if "pydoc" in aliases:
+        del aliases["pydoc"]
+
+    if ${...}.get("_OLD_VIRTUAL_PATH", ""):
+        $PATH = $_OLD_VIRTUAL_PATH
+        del $_OLD_VIRTUAL_PATH
+
+    if ${...}.get("_OLD_VIRTUAL_PYTHONHOME", ""):
+        $PYTHONHOME = $_OLD_VIRTUAL_PYTHONHOME
+        del $_OLD_VIRTUAL_PYTHONHOME
+
+    if "VIRTUAL_ENV" in ${...}:
+        del $VIRTUAL_ENV
+
+    if "VIRTUAL_ENV_PROMPT" in ${...}:
+        del $VIRTUAL_ENV_PROMPT
+
+    if "nondestructive" not in args:
+        # Self destruct!
+        del aliases["deactivate"]
+
+
+# unset irrelevant variables
+_deactivate(["nondestructive"])
+aliases["deactivate"] = _deactivate
+
+$VIRTUAL_ENV = r"/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv"
+
+$_OLD_VIRTUAL_PATH = $PATH
+$PATH = $PATH[:]
+$PATH.add($VIRTUAL_ENV + _get_sep() + "bin", front=True, replace=True)
+
+if ${...}.get("PYTHONHOME", ""):
+    # unset PYTHONHOME if set
+    $_OLD_VIRTUAL_PYTHONHOME = $PYTHONHOME
+    del $PYTHONHOME
+
+$VIRTUAL_ENV_PROMPT = ""
+if not $VIRTUAL_ENV_PROMPT:
+    del $VIRTUAL_ENV_PROMPT
+
+aliases["pydoc"] = ["python", "-m", "pydoc"]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate_this.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate_this.py
new file mode 100644
index 0000000000000000000000000000000000000000..44799869857f0fc68aef1c85a38fdbf236f3b017
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/activate_this.py
@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+"""Activate virtualenv for current interpreter:
+
+Use exec(open(this_file).read(), {'__file__': this_file}).
+
+This can be used when you must use an existing Python interpreter, not the virtualenv bin/python.
+"""
+import os
+import site
+import sys
+
+try:
+    abs_file = os.path.abspath(__file__)
+except NameError:
+    raise AssertionError("You must use exec(open(this_file).read(), {'__file__': this_file}))")
+
+bin_dir = os.path.dirname(abs_file)
+base = bin_dir[: -len("bin") - 1]  # strip away the bin part from the __file__, plus the path separator
+
+# prepend bin to PATH (this file is inside the bin directory)
+os.environ["PATH"] = os.pathsep.join([bin_dir] + os.environ.get("PATH", "").split(os.pathsep))
+os.environ["VIRTUAL_ENV"] = base  # virtual env is right above bin directory
+
+# add the virtual environments libraries to the host python import mechanism
+prev_length = len(sys.path)
+for lib in "../lib/python3.8/site-packages".split(os.pathsep):
+    path = os.path.realpath(os.path.join(bin_dir, lib))
+    site.addsitedir(path.decode("utf-8") if "" else path)
+sys.path[:] = sys.path[prev_length:] + sys.path[0:prev_length]
+
+sys.real_prefix = sys.prefix
+sys.prefix = base
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect
new file mode 100755
index 0000000000000000000000000000000000000000..ddb8412a6c612081c4f90f784d43906b019ae280
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from chardet.cli.chardetect import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect-3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect-3.8
new file mode 100755
index 0000000000000000000000000000000000000000..ddb8412a6c612081c4f90f784d43906b019ae280
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect-3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from chardet.cli.chardetect import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect3
new file mode 100755
index 0000000000000000000000000000000000000000..ddb8412a6c612081c4f90f784d43906b019ae280
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/chardetect3
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from chardet.cli.chardetect import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/charmcraft b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/charmcraft
new file mode 100755
index 0000000000000000000000000000000000000000..ee6460bcbc19a4c5a5db69e999e8bbd2297d7a4f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/charmcraft
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from charmcraft.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro
new file mode 100755
index 0000000000000000000000000000000000000000..06e85815f80a423d4033004a5e5cc23d3ef47171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from distro import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro-3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro-3.8
new file mode 100755
index 0000000000000000000000000000000000000000..06e85815f80a423d4033004a5e5cc23d3ef47171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro-3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from distro import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro3
new file mode 100755
index 0000000000000000000000000000000000000000..06e85815f80a423d4033004a5e5cc23d3ef47171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/distro3
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from distro import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install
new file mode 100755
index 0000000000000000000000000000000000000000..5dd7f111061d3c9bf682e3e6114c70cf601c91be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from setuptools.command.easy_install import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install-3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install-3.8
new file mode 100755
index 0000000000000000000000000000000000000000..5dd7f111061d3c9bf682e3e6114c70cf601c91be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install-3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from setuptools.command.easy_install import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install3
new file mode 100755
index 0000000000000000000000000000000000000000..5dd7f111061d3c9bf682e3e6114c70cf601c91be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/easy_install3
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from setuptools.command.easy_install import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/jsonschema b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/jsonschema
new file mode 100755
index 0000000000000000000000000000000000000000..5de42465e06538adb47fd019048dde5071b19fd3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/jsonschema
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from jsonschema.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip
new file mode 100755
index 0000000000000000000000000000000000000000..24b601867cc4d186e8e2dcd588e35a8103111312
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip-3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip-3.8
new file mode 100755
index 0000000000000000000000000000000000000000..24b601867cc4d186e8e2dcd588e35a8103111312
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip-3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3
new file mode 100755
index 0000000000000000000000000000000000000000..24b601867cc4d186e8e2dcd588e35a8103111312
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3.8
new file mode 100755
index 0000000000000000000000000000000000000000..24b601867cc4d186e8e2dcd588e35a8103111312
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/pip3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from pip._internal.cli.main import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/tabulate b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/tabulate
new file mode 100755
index 0000000000000000000000000000000000000000..5316dda6a280ac09b06abd2512093a04439f9b49
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/tabulate
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from tabulate import _main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(_main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel
new file mode 100755
index 0000000000000000000000000000000000000000..06e0d0325d52ae311688581b20c60e3b65fc7f41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from wheel.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel-3.8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel-3.8
new file mode 100755
index 0000000000000000000000000000000000000000..06e0d0325d52ae311688581b20c60e3b65fc7f41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel-3.8
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from wheel.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel3
new file mode 100755
index 0000000000000000000000000000000000000000..06e0d0325d52ae311688581b20c60e3b65fc7f41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/bin/wheel3
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitLab/osm-packages/hackfest_firewall_pnf/charms/vyos-config-src/venv/bin/python
+# -*- coding: utf-8 -*-
+import re
+import sys
+from wheel.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..3119fa91afb9c067f0d78f959ca038b7c0f86a2c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/METADATA
@@ -0,0 +1,71 @@
+Metadata-Version: 2.1
+Name: CacheControl
+Version: 0.12.6
+Summary: httplib2 caching for requests
+Home-page: https://github.com/ionrock/cachecontrol
+Author: Eric Larson
+Author-email: eric@ionrock.org
+License: UNKNOWN
+Keywords: requests http caching web
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Provides-Extra: filecache
+Requires-Dist: lockfile (>=0.9) ; extra == 'filecache'
+Provides-Extra: redis
+Requires-Dist: redis (>=2.10.5) ; extra == 'redis'
+
+==============
+ CacheControl
+==============
+
+.. image:: https://img.shields.io/pypi/v/cachecontrol.svg
+    :target: https://pypi.python.org/pypi/cachecontrol
+    :alt: Latest Version
+
+.. image:: https://travis-ci.org/ionrock/cachecontrol.png?branch=master
+  :target: https://travis-ci.org/ionrock/cachecontrol
+
+CacheControl is a port of the caching algorithms in httplib2_ for use with
+requests_ session object.
+
+It was written because httplib2's better support for caching is often
+mitigated by its lack of thread safety. The same is true of requests in
+terms of caching.
+
+
+Quickstart
+==========
+
+.. code-block:: python
+
+  import requests
+
+  from cachecontrol import CacheControl
+
+
+  sess = requests.session()
+  cached_sess = CacheControl(sess)
+
+  response = cached_sess.get('http://google.com')
+
+If the URL contains any caching based headers, it will cache the
+result in a simple dictionary.
+
+For more info, check out the docs_
+
+.. _docs: http://cachecontrol.readthedocs.org/en/latest/
+.. _httplib2: https://github.com/jcgregorio/httplib2
+.. _requests: http://docs.python-requests.org/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..80e6a585e4689710ba51c8c404aa2610601cca53
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/RECORD
@@ -0,0 +1,37 @@
+cachecontrol/__init__.py,sha256=pJtAaUxOsMPnytI1A3juAJkXYDr8krdSnsg4Yg3OBEg,302
+cachecontrol/_cmd.py,sha256=88j4P3JlJGqg6xAXR4btN9fYruXUH4CE-M93Sie5IB8,1242
+cachecontrol/adapter.py,sha256=ctnbSXDOj0V0NaxJP2jFauOYRDHaNYMP9QCE8kB4kfk,4870
+cachecontrol/cache.py,sha256=1fc4wJP8HYt1ycnJXeEw5pCpeBL2Cqxx6g9Fb0AYDWQ,805
+cachecontrol/compat.py,sha256=Fn_aYzqNbN0bK9gUn8SQUzMLxQ_ruGnsEMvryYDFh3o,647
+cachecontrol/controller.py,sha256=fpLmIvxce2mKVFmtDFiiyydqU_pPbCucYLC9qP-LqvY,14137
+cachecontrol/filewrapper.py,sha256=vACKO8Llzu_ZWyjV1Fxn1MA4TGU60N5N3GSrAFdAY2Q,2533
+cachecontrol/heuristics.py,sha256=BFGHJ3yQcxvZizfo90LLZ04T_Z5XSCXvFotrp7Us0sc,4070
+cachecontrol/serialize.py,sha256=Jms7OS4GB2JFUzuMPlmQtuCDzcjjE-2ijrHpUXC2BV0,7062
+cachecontrol/wrapper.py,sha256=5LX0uJwkNQUtYSEw3aGmGu9WY8wGipd81mJ8lG0d0M4,690
+cachecontrol/caches/__init__.py,sha256=-gHNKYvaeD0kOk5M74eOrsSgIKUtC6i6GfbmugGweEo,86
+cachecontrol/caches/file_cache.py,sha256=nYVKsJtXh6gJXvdn1iWyrhxvkwpQrK-eKoMRzuiwkKk,4153
+cachecontrol/caches/redis_cache.py,sha256=yZP1PoUgAvxEZZrCVwImZ-5pFKU41v5HYJf1rfbXYmM,844
+CacheControl-0.12.6.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+CacheControl-0.12.6.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+CacheControl-0.12.6.dist-info/METADATA,sha256=DzDqga-Bw7B7ylVrJanU_-imHV1od8Ok64qr5ugT-5A,2107
+CacheControl-0.12.6.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+CacheControl-0.12.6.dist-info/top_level.txt,sha256=vGYWzpbe3h6gkakV4f7iCK2x3KyK3oMkV5pe5v25-d4,13
+CacheControl-0.12.6.dist-info/RECORD,,
+cachecontrol/compat.cpython-38.pyc,,
+CacheControl-0.12.6.dist-info/__pycache__,,
+CacheControl-0.12.6.virtualenv,,
+cachecontrol/caches/file_cache.cpython-38.pyc,,
+cachecontrol/caches/__init__.cpython-38.pyc,,
+cachecontrol/__init__.cpython-38.pyc,,
+cachecontrol/controller.cpython-38.pyc,,
+cachecontrol/serialize.cpython-38.pyc,,
+cachecontrol/caches/__pycache__,,
+cachecontrol/caches/redis_cache.cpython-38.pyc,,
+CacheControl-0.12.6.dist-info/INSTALLER,,
+cachecontrol/wrapper.cpython-38.pyc,,
+cachecontrol/adapter.cpython-38.pyc,,
+cachecontrol/heuristics.cpython-38.pyc,,
+cachecontrol/filewrapper.cpython-38.pyc,,
+cachecontrol/__pycache__,,
+cachecontrol/cache.cpython-38.pyc,,
+cachecontrol/_cmd.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..af37ac627514445bfc761e8867d8c178ea766e4b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.dist-info/top_level.txt
@@ -0,0 +1 @@
+cachecontrol
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/CacheControl-0.12.6.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/LICENSE.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c37cae49ec77ad6ebb25568c1605f1fee5313cfb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2007 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..55c0f82692c5a56768a741095b7d4fb3872b4df5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/METADATA
@@ -0,0 +1,106 @@
+Metadata-Version: 2.1
+Name: Jinja2
+Version: 2.11.2
+Summary: A very fast and expressive template engine.
+Home-page: https://palletsprojects.com/p/jinja/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: Pallets
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://jinja.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/jinja
+Project-URL: Issue tracker, https://github.com/pallets/jinja/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Description-Content-Type: text/x-rst
+Requires-Dist: MarkupSafe (>=0.23)
+Provides-Extra: i18n
+Requires-Dist: Babel (>=0.8) ; extra == 'i18n'
+
+Jinja
+=====
+
+Jinja is a fast, expressive, extensible templating engine. Special
+placeholders in the template allow writing code similar to Python
+syntax. Then the template is passed data to render the final document.
+
+It includes:
+
+-   Template inheritance and inclusion.
+-   Define and import macros within templates.
+-   HTML templates can use autoescaping to prevent XSS from untrusted
+    user input.
+-   A sandboxed environment can safely render untrusted templates.
+-   AsyncIO support for generating templates and calling async
+    functions.
+-   I18N support with Babel.
+-   Templates are compiled to optimized Python code just-in-time and
+    cached, or can be compiled ahead-of-time.
+-   Exceptions point to the correct line in templates to make debugging
+    easier.
+-   Extensible filters, tests, functions, and even syntax.
+
+Jinja's philosophy is that while application logic belongs in Python if
+possible, it shouldn't make the template designer's job difficult by
+restricting functionality too much.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    $ pip install -U Jinja2
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+In A Nutshell
+-------------
+
+.. code-block:: jinja
+
+    {% extends "base.html" %}
+    {% block title %}Members{% endblock %}
+    {% block content %}
+      <ul>
+      {% for user in users %}
+        <li><a href="{{ user.url }}">{{ user.username }}</a></li>
+      {% endfor %}
+      </ul>
+    {% endblock %}
+
+
+Links
+-----
+
+-   Website: https://palletsprojects.com/p/jinja/
+-   Documentation: https://jinja.palletsprojects.com/
+-   Releases: https://pypi.org/project/Jinja2/
+-   Code: https://github.com/pallets/jinja
+-   Issue tracker: https://github.com/pallets/jinja/issues
+-   Test status: https://dev.azure.com/pallets/jinja/_build
+-   Official chat: https://discord.gg/t6rrQZH
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..413fef4bfdf0330f017450293400e102cab65113
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/RECORD
@@ -0,0 +1,61 @@
+Jinja2-2.11.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+Jinja2-2.11.2.dist-info/LICENSE.rst,sha256=O0nc7kEF6ze6wQ-vG-JgQI_oXSUrjp3y4JefweCUQ3s,1475
+Jinja2-2.11.2.dist-info/METADATA,sha256=5ZHRZoIRAMHsJPnqhlJ622_dRPsYePYJ-9EH4-Ry7yI,3535
+Jinja2-2.11.2.dist-info/RECORD,,
+Jinja2-2.11.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+Jinja2-2.11.2.dist-info/entry_points.txt,sha256=Qy_DkVo6Xj_zzOtmErrATe8lHZhOqdjpt3e4JJAGyi8,61
+Jinja2-2.11.2.dist-info/top_level.txt,sha256=PkeVWtLb3-CqjWi1fO29OCbj55EhX_chhKrCdrVe_zs,7
+jinja2/__init__.py,sha256=0QCM_jKKDM10yzSdHRVV4mQbCbDqf0GN0GirAqibn9Y,1549
+jinja2/__pycache__/__init__.cpython-38.pyc,,
+jinja2/__pycache__/_compat.cpython-38.pyc,,
+jinja2/__pycache__/_identifier.cpython-38.pyc,,
+jinja2/__pycache__/asyncfilters.cpython-38.pyc,,
+jinja2/__pycache__/asyncsupport.cpython-38.pyc,,
+jinja2/__pycache__/bccache.cpython-38.pyc,,
+jinja2/__pycache__/compiler.cpython-38.pyc,,
+jinja2/__pycache__/constants.cpython-38.pyc,,
+jinja2/__pycache__/debug.cpython-38.pyc,,
+jinja2/__pycache__/defaults.cpython-38.pyc,,
+jinja2/__pycache__/environment.cpython-38.pyc,,
+jinja2/__pycache__/exceptions.cpython-38.pyc,,
+jinja2/__pycache__/ext.cpython-38.pyc,,
+jinja2/__pycache__/filters.cpython-38.pyc,,
+jinja2/__pycache__/idtracking.cpython-38.pyc,,
+jinja2/__pycache__/lexer.cpython-38.pyc,,
+jinja2/__pycache__/loaders.cpython-38.pyc,,
+jinja2/__pycache__/meta.cpython-38.pyc,,
+jinja2/__pycache__/nativetypes.cpython-38.pyc,,
+jinja2/__pycache__/nodes.cpython-38.pyc,,
+jinja2/__pycache__/optimizer.cpython-38.pyc,,
+jinja2/__pycache__/parser.cpython-38.pyc,,
+jinja2/__pycache__/runtime.cpython-38.pyc,,
+jinja2/__pycache__/sandbox.cpython-38.pyc,,
+jinja2/__pycache__/tests.cpython-38.pyc,,
+jinja2/__pycache__/utils.cpython-38.pyc,,
+jinja2/__pycache__/visitor.cpython-38.pyc,,
+jinja2/_compat.py,sha256=B6Se8HjnXVpzz9-vfHejn-DV2NjaVK-Iewupc5kKlu8,3191
+jinja2/_identifier.py,sha256=EdgGJKi7O1yvr4yFlvqPNEqV6M1qHyQr8Gt8GmVTKVM,1775
+jinja2/asyncfilters.py,sha256=XJtYXTxFvcJ5xwk6SaDL4S0oNnT0wPYvXBCSzc482fI,4250
+jinja2/asyncsupport.py,sha256=ZBFsDLuq3Gtji3Ia87lcyuDbqaHZJRdtShZcqwpFnSQ,7209
+jinja2/bccache.py,sha256=3Pmp4jo65M9FQuIxdxoDBbEDFwe4acDMQf77nEJfrHA,12139
+jinja2/compiler.py,sha256=Ta9W1Lit542wItAHXlDcg0sEOsFDMirCdlFPHAurg4o,66284
+jinja2/constants.py,sha256=RR1sTzNzUmKco6aZicw4JpQpJGCuPuqm1h1YmCNUEFY,1458
+jinja2/debug.py,sha256=neR7GIGGjZH3_ILJGVUYy3eLQCCaWJMXOb7o0kGInWc,8529
+jinja2/defaults.py,sha256=85B6YUUCyWPSdrSeVhcqFVuu_bHUAQXeey--FIwSeVQ,1126
+jinja2/environment.py,sha256=XDSLKc4SqNLMOwTSq3TbWEyA5WyXfuLuVD0wAVjEFwM,50629
+jinja2/exceptions.py,sha256=VjNLawcmf2ODffqVMCQK1cRmvFaUfQWF4u8ouP3QPcE,5425
+jinja2/ext.py,sha256=AtwL5O5enT_L3HR9-oBvhGyUTdGoyaqG_ICtnR_EVd4,26441
+jinja2/filters.py,sha256=_RpPgAlgIj7ExvyDzcHAC3B36cocfWK-1TEketbNeM0,41415
+jinja2/idtracking.py,sha256=J3O4VHsrbf3wzwiBc7Cro26kHb6_5kbULeIOzocchIU,9211
+jinja2/lexer.py,sha256=nUFLRKhhKmmEWkLI65nQePgcQs7qsRdjVYZETMt_v0g,30331
+jinja2/loaders.py,sha256=C-fST_dmFjgWkp0ZuCkrgICAoOsoSIF28wfAFink0oU,17666
+jinja2/meta.py,sha256=QjyYhfNRD3QCXjBJpiPl9KgkEkGXJbAkCUq4-Ur10EQ,4131
+jinja2/nativetypes.py,sha256=Ul__gtVw4xH-0qvUvnCNHedQeNDwmEuyLJztzzSPeRg,2753
+jinja2/nodes.py,sha256=Mk1oJPVgIjnQw9WOqILvcu3rLepcFZ0ahxQm2mbwDwc,31095
+jinja2/optimizer.py,sha256=gQLlMYzvQhluhzmAIFA1tXS0cwgWYOjprN-gTRcHVsc,1457
+jinja2/parser.py,sha256=fcfdqePNTNyvosIvczbytVA332qpsURvYnCGcjDHSkA,35660
+jinja2/runtime.py,sha256=0y-BRyIEZ9ltByL2Id6GpHe1oDRQAwNeQvI0SKobNMw,30618
+jinja2/sandbox.py,sha256=knayyUvXsZ-F0mk15mO2-ehK9gsw04UhB8td-iUOtLc,17127
+jinja2/tests.py,sha256=iO_Y-9Vo60zrVe1lMpSl5sKHqAxe2leZHC08OoZ8K24,4799
+jinja2/utils.py,sha256=OoVMlQe9S2-lWT6jJbTu9tDuDvGNyWUhHDcE51i5_Do,22522
+jinja2/visitor.py,sha256=DUHupl0a4PGp7nxRtZFttUzAi1ccxzqc2hzetPYUz8U,3240
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3619483fd4fca7407f3bd462aefcd70d1de69737
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[babel.extractors]
+jinja2 = jinja2.ext:babel_extract [i18n]
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7f7afbf3bf54b346092be6a72070fcbd305ead1e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/Jinja2-2.11.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+jinja2
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/LICENSE.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..9d227a0cc43c3268d15722b763bd94ad298645a1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2010 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..e4a7b90f51d7d6457663b1935f2665dd44f8e352
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/METADATA
@@ -0,0 +1,94 @@
+Metadata-Version: 2.1
+Name: MarkupSafe
+Version: 1.1.1
+Summary: Safely add untrusted strings to HTML/XML markup.
+Home-page: https://palletsprojects.com/p/markupsafe/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: The Pallets Team
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://markupsafe.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/markupsafe
+Project-URL: Issue tracker, https://github.com/pallets/markupsafe/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
+Description-Content-Type: text/x-rst
+
+MarkupSafe
+==========
+
+MarkupSafe implements a text object that escapes characters so it is
+safe to use in HTML and XML. Characters that have special meanings are
+replaced so that they display as the actual characters. This mitigates
+injection attacks, meaning untrusted user input can safely be displayed
+on a page.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    pip install -U MarkupSafe
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+Examples
+--------
+
+.. code-block:: pycon
+
+    >>> from markupsafe import Markup, escape
+    >>> # escape replaces special characters and wraps in Markup
+    >>> escape('<script>alert(document.cookie);</script>')
+    Markup(u'&lt;script&gt;alert(document.cookie);&lt;/script&gt;')
+    >>> # wrap in Markup to mark text "safe" and prevent escaping
+    >>> Markup('<strong>Hello</strong>')
+    Markup('<strong>hello</strong>')
+    >>> escape(Markup('<strong>Hello</strong>'))
+    Markup('<strong>hello</strong>')
+    >>> # Markup is a text subclass (str on Python 3, unicode on Python 2)
+    >>> # methods and operators escape their arguments
+    >>> template = Markup("Hello <em>%s</em>")
+    >>> template % '"World"'
+    Markup('Hello <em>&#34;World&#34;</em>')
+
+
+Donate
+------
+
+The Pallets organization develops and supports MarkupSafe and other
+libraries that use it. In order to grow the community of contributors
+and users, and allow the maintainers to devote more time to the
+projects, `please donate today`_.
+
+.. _please donate today: https://palletsprojects.com/donate
+
+
+Links
+-----
+
+*   Website: https://palletsprojects.com/p/markupsafe/
+*   Documentation: https://markupsafe.palletsprojects.com/
+*   Releases: https://pypi.org/project/MarkupSafe/
+*   Code: https://github.com/pallets/markupsafe
+*   Issue tracker: https://github.com/pallets/markupsafe/issues
+*   Test status: https://dev.azure.com/pallets/markupsafe/_build
+*   Official chat: https://discord.gg/t6rrQZH
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6d95824014c4aeaac8dab2207394c7d655aa7cbd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/RECORD
@@ -0,0 +1,16 @@
+MarkupSafe-1.1.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+MarkupSafe-1.1.1.dist-info/LICENSE.rst,sha256=SJqOEQhQntmKN7uYPhHg9-HTHwvY-Zp5yESOf_N9B-o,1475
+MarkupSafe-1.1.1.dist-info/METADATA,sha256=-XXnVvCxQP2QbHutIQq_7Pk9OATy-x0NC7gN_3_SCRE,3167
+MarkupSafe-1.1.1.dist-info/RECORD,,
+MarkupSafe-1.1.1.dist-info/WHEEL,sha256=RIeRBYNNiNK3sXfnenIjXDrR2Tzyz05xCMpKF2hJ1iA,111
+MarkupSafe-1.1.1.dist-info/top_level.txt,sha256=qy0Plje5IJuvsCBjejJyhDCjEAdcDLK_2agVcex8Z6U,11
+markupsafe/__init__.py,sha256=oTblO5f9KFM-pvnq9bB0HgElnqkJyqHnFN1Nx2NIvnY,10126
+markupsafe/__pycache__/__init__.cpython-38.pyc,,
+markupsafe/__pycache__/_compat.cpython-38.pyc,,
+markupsafe/__pycache__/_constants.cpython-38.pyc,,
+markupsafe/__pycache__/_native.cpython-38.pyc,,
+markupsafe/_compat.py,sha256=uEW1ybxEjfxIiuTbRRaJpHsPFf4yQUMMKaPgYEC5XbU,558
+markupsafe/_constants.py,sha256=zo2ajfScG-l1Sb_52EP3MlDCqO7Y1BVHUXXKRsVDRNk,4690
+markupsafe/_native.py,sha256=d-8S_zzYt2y512xYcuSxq0NeG2DUUvG80wVdTn-4KI8,1873
+markupsafe/_speedups.c,sha256=k0fzEIK3CP6MmMqeY0ob43TP90mVN0DTyn7BAl3RqSg,9884
+markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so,sha256=t037yzhfsUaStpvo6eqDVYeK-dHfWmgB4cVL9nkY2-k,48016
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b1fcc33cbc2a978759a99244f6338ec10ee908a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-manylinux2010_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..75bf729258f9daef77370b6df1a57940f90fc23f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/MarkupSafe-1.1.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+markupsafe
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..91e18a62b67551a4d427e2eaee0d33dcab94e141
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/LICENSE
@@ -0,0 +1,174 @@
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..0ef3ef0da38c2be04887e5293845fb3b4f0e0509
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/METADATA
@@ -0,0 +1,227 @@
+Metadata-Version: 2.1
+Name: PyNaCl
+Version: 1.4.0
+Summary: Python binding to the Networking and Cryptography (NaCl) library
+Home-page: https://github.com/pyca/pynacl/
+Author: The PyNaCl developers
+Author-email: cryptography-dev@python.org
+License: Apache License 2.0
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Requires-Dist: six
+Requires-Dist: cffi (>=1.4.1)
+Provides-Extra: docs
+Requires-Dist: sphinx (>=1.6.5) ; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
+Provides-Extra: tests
+Requires-Dist: pytest (!=3.3.0,>=3.2.1) ; extra == 'tests'
+Requires-Dist: hypothesis (>=3.27.0) ; extra == 'tests'
+
+===============================================
+PyNaCl: Python binding to the libsodium library
+===============================================
+
+.. image:: https://img.shields.io/pypi/v/pynacl.svg
+    :target: https://pypi.org/project/PyNaCl/
+    :alt: Latest Version
+
+.. image:: https://travis-ci.org/pyca/pynacl.svg?branch=master
+    :target: https://travis-ci.org/pyca/pynacl
+
+.. image:: https://codecov.io/github/pyca/pynacl/coverage.svg?branch=master
+    :target: https://codecov.io/github/pyca/pynacl?branch=master
+
+.. image:: https://img.shields.io/pypi/pyversions/pynacl.svg
+    :target: https://pypi.org/project/PyNaCl/
+    :alt: Compatible Python Versions
+
+PyNaCl is a Python binding to `libsodium`_, which is a fork of the
+`Networking and Cryptography library`_. These libraries have a stated goal of
+improving usability, security and speed. It supports Python 2.7 and 3.5+ as
+well as PyPy 2.6+.
+
+.. _libsodium: https://github.com/jedisct1/libsodium
+.. _Networking and Cryptography library: https://nacl.cr.yp.to/
+
+Features
+--------
+
+* Digital signatures
+* Secret-key encryption
+* Public-key encryption
+* Hashing and message authentication
+* Password based key derivation and password hashing
+
+`Changelog`_
+------------
+
+.. _Changelog: https://pynacl.readthedocs.io/en/stable/changelog/
+
+Installation
+============
+
+Binary wheel install
+--------------------
+
+PyNaCl ships as a binary wheel on macOS, Windows and Linux ``manylinux1`` [#many]_ ,
+so all dependencies are included. Make sure you have an up-to-date pip
+and run:
+
+.. code-block:: console
+
+    $ pip install pynacl
+
+Linux source build
+------------------
+
+PyNaCl relies on `libsodium`_, a portable C library. A copy is bundled
+with PyNaCl so to install you can run:
+
+.. code-block:: console
+
+    $ pip install pynacl
+
+If you'd prefer to use the version of ``libsodium`` provided by your
+distribution, you can disable the bundled copy during install by running:
+
+.. code-block:: console
+
+    $ SODIUM_INSTALL=system pip install pynacl
+
+.. warning:: Usage of the legacy ``easy_install`` command provided by setuptools
+   is generally discouraged, and is completely unsupported in PyNaCl's case.
+
+.. _libsodium: https://github.com/jedisct1/libsodium
+
+.. [#many] `manylinux1 wheels <https://www.python.org/dev/peps/pep-0513/>`_
+    are built on a baseline linux environment based on Centos 5.11
+    and should work on most x86 and x86_64 glibc based linux environments.
+
+Changelog
+=========
+
+1.4.0 (2020-05-25)
+------------------
+
+* Update ``libsodium`` to 1.0.18.
+* **BACKWARDS INCOMPATIBLE:** We no longer distribute 32-bit ``manylinux1``
+  wheels. Continuing to produce them was a maintenance burden.
+* Added support for Python 3.8, and removed support for Python 3.4.
+* Add low level bindings for extracting the seed and the public key
+  from crypto_sign_ed25519 secret key
+* Add low level bindings for deterministic random generation.
+* Add ``wheel`` and ``setuptools`` setup_requirements in ``setup.py`` (#485)
+* Fix checks on very slow builders (#481, #495)
+* Add low-level bindings to ed25519 arithmetic functions
+* Update low-level blake2b state implementation
+* Fix wrong short-input behavior of SealedBox.decrypt() (#517)
+* Raise CryptPrefixError exception instead of InvalidkeyError when trying
+  to check a password against a verifier stored in a unknown format (#519)
+* Add support for minimal builds of libsodium. Trying to call functions
+  not available in a minimal build will raise an UnavailableError
+  exception. To compile a minimal build of the bundled libsodium, set
+  the SODIUM_INSTALL_MINIMAL environment variable to any non-empty
+  string (e.g. ``SODIUM_INSTALL_MINIMAL=1``) for setup.
+
+1.3.0 2018-09-26
+----------------
+
+* Added support for Python 3.7.
+* Update ``libsodium`` to 1.0.16.
+* Run and test all code examples in PyNaCl docs through sphinx's
+  doctest builder.
+* Add low-level bindings for chacha20-poly1305 AEAD constructions.
+* Add low-level bindings for the chacha20-poly1305 secretstream constructions.
+* Add low-level bindings for ed25519ph pre-hashed signing construction.
+* Add low-level bindings for constant-time increment and addition
+  on fixed-precision big integers represented as little-endian
+  byte sequences.
+* Add low-level bindings for the ISO/IEC 7816-4 compatible padding API.
+* Add low-level bindings for libsodium's crypto_kx... key exchange
+  construction.
+* Set hypothesis deadline to None in tests/test_pwhash.py to avoid
+  incorrect test failures on slower processor architectures.  GitHub
+  issue #370
+
+1.2.1 - 2017-12-04
+------------------
+
+* Update hypothesis minimum allowed version.
+* Infrastructure: add proper configuration for readthedocs builder
+  runtime environment.
+
+1.2.0 - 2017-11-01
+------------------
+
+* Update ``libsodium`` to 1.0.15.
+* Infrastructure: add jenkins support for automatic build of
+  ``manylinux1`` binary wheels
+* Added support for ``SealedBox`` construction.
+* Added support for ``argon2i`` and ``argon2id`` password hashing constructs
+  and restructured high-level password hashing implementation to expose
+  the same interface for all hashers.
+* Added support for 128 bit ``siphashx24`` variant of ``siphash24``.
+* Added support for ``from_seed`` APIs for X25519 keypair generation.
+* Dropped support for Python 3.3.
+
+1.1.2 - 2017-03-31
+------------------
+
+* reorder link time library search path when using bundled
+  libsodium
+
+1.1.1 - 2017-03-15
+------------------
+
+* Fixed a circular import bug in ``nacl.utils``.
+
+1.1.0 - 2017-03-14
+------------------
+
+* Dropped support for Python 2.6.
+* Added ``shared_key()`` method on ``Box``.
+* You can now pass ``None`` to ``nonce`` when encrypting with ``Box`` or
+  ``SecretBox`` and it will automatically generate a random nonce.
+* Added support for ``siphash24``.
+* Added support for ``blake2b``.
+* Added support for ``scrypt``.
+* Update ``libsodium`` to 1.0.11.
+* Default to the bundled ``libsodium`` when compiling.
+* All raised exceptions are defined mixing-in
+  ``nacl.exceptions.CryptoError``
+
+1.0.1 - 2016-01-24
+------------------
+
+* Fix an issue with absolute paths that prevented the creation of wheels.
+
+1.0 - 2016-01-23
+----------------
+
+* PyNaCl has been ported to use the new APIs available in cffi 1.0+.
+  Due to this change we no longer support PyPy releases older than 2.6.
+* Python 3.2 support has been dropped.
+* Functions to convert between Ed25519 and Curve25519 keys have been added.
+
+0.3.0 - 2015-03-04
+------------------
+
+* The low-level API (`nacl.c.*`) has been changed to match the
+  upstream NaCl C/C++ conventions (as well as those of other NaCl bindings).
+  The order of arguments and return values has changed significantly. To
+  avoid silent failures, `nacl.c` has been removed, and replaced with
+  `nacl.bindings` (with the new argument ordering). If you have code which
+  calls these functions (e.g. `nacl.c.crypto_box_keypair()`), you must review
+  the new docstrings and update your code/imports to match the new
+  conventions.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..cb46b478318074ba4d1dbad340f18091c7fffa7f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/RECORD
@@ -0,0 +1,67 @@
+PyNaCl-1.4.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+PyNaCl-1.4.0.dist-info/LICENSE,sha256=0xdK1j5yHUydzLitQyCEiZLTFDabxGMZcgtYAskVP-k,9694
+PyNaCl-1.4.0.dist-info/METADATA,sha256=VXYKfhj8GTj_EfH7PT_oGHgxCAF7YonQtvn0ApWLbmY,8114
+PyNaCl-1.4.0.dist-info/RECORD,,
+PyNaCl-1.4.0.dist-info/WHEEL,sha256=HAbUOEaMuGu1vSI8bKL7nQShDuU2XC9f79bOtOydX1A,108
+PyNaCl-1.4.0.dist-info/top_level.txt,sha256=wfdEOI_G2RIzmzsMyhpqP17HUh6Jcqi99to9aHLEslo,13
+nacl/__init__.py,sha256=F4fZFkZq5_reCDDlQb3NVH_Lc1-K3JmsAQaOnJZPzXc,1170
+nacl/__pycache__/__init__.cpython-38.pyc,,
+nacl/__pycache__/encoding.cpython-38.pyc,,
+nacl/__pycache__/exceptions.cpython-38.pyc,,
+nacl/__pycache__/hash.cpython-38.pyc,,
+nacl/__pycache__/hashlib.cpython-38.pyc,,
+nacl/__pycache__/public.cpython-38.pyc,,
+nacl/__pycache__/secret.cpython-38.pyc,,
+nacl/__pycache__/signing.cpython-38.pyc,,
+nacl/__pycache__/utils.cpython-38.pyc,,
+nacl/_sodium.abi3.so,sha256=yoqlIcLJfPPPBpIaFDUQ_kricoapUJ1dzMU-00JRB1A,3270761
+nacl/bindings/__init__.py,sha256=c8Wn3gTCAZSdLMGxVnOuRChvh-8L7DrgBieAUFRqQ8Q,16883
+nacl/bindings/__pycache__/__init__.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_aead.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_box.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_core.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_generichash.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_hash.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_kx.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_pwhash.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_scalarmult.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_secretbox.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_secretstream.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_shorthash.cpython-38.pyc,,
+nacl/bindings/__pycache__/crypto_sign.cpython-38.pyc,,
+nacl/bindings/__pycache__/randombytes.cpython-38.pyc,,
+nacl/bindings/__pycache__/sodium_core.cpython-38.pyc,,
+nacl/bindings/__pycache__/utils.cpython-38.pyc,,
+nacl/bindings/crypto_aead.py,sha256=DE5zdi09GeHZxvmrhHtxVuTqF61y1cs8trTGh_6uP8Q,17335
+nacl/bindings/crypto_box.py,sha256=VVBRvAACrEARLEZDHOFEp4g0meQWwWXTiCW0npPt0HU,9958
+nacl/bindings/crypto_core.py,sha256=7zOeRHS2oBWwI_KB1E4-sRq_ITZGWSUqxI0aT-evPGw,13433
+nacl/bindings/crypto_generichash.py,sha256=a0h-yxZR8fD7AkzaTcXj48pgFrCKVa7Mmer1wj8Az2A,8949
+nacl/bindings/crypto_hash.py,sha256=7Xp4mpXr4cpn-hAOU66KlYVUCVHP6deT0v_eW4UZZXo,2243
+nacl/bindings/crypto_kx.py,sha256=2Gjxu5c7IKAwW2MOJa9zEn1EgpIVQ0tbZQs33REZb38,6937
+nacl/bindings/crypto_pwhash.py,sha256=TH-oXgrzwnNnBCNR_iPw7TtakVBzmW1kIkJciF8MVdM,18696
+nacl/bindings/crypto_scalarmult.py,sha256=8w9CIMSar2eGR2nwmqQlQdN3z_o7L-P4unGnm9gwkVU,8208
+nacl/bindings/crypto_secretbox.py,sha256=luvzB3lwBwXxKm63e9nA2neGtOXeeG8R9SyWEckIqdI,2864
+nacl/bindings/crypto_secretstream.py,sha256=FLICuAI6kRM5qNIZbDetZVzLV-7y2dv5Vd1LTpUEhmo,10475
+nacl/bindings/crypto_shorthash.py,sha256=PK_h7X2WH_QRKJoSHbsQdhc19TIpFFqXy_wkzRPvpnY,2587
+nacl/bindings/crypto_sign.py,sha256=bQc_2VQ4CGttdi9s1hvD5PcqPXFo4ca44dRG-W2kRkc,10617
+nacl/bindings/randombytes.py,sha256=r93-dAfODRnXAUacx9MXsop-WVZ5xMJJB3xyPkHjQr4,1597
+nacl/bindings/sodium_core.py,sha256=52z0K7y6Ge6IlXcysWDVN7UdYcTOij6v0Cb0OLo8_Qc,1079
+nacl/bindings/utils.py,sha256=jOKsDbsjxN9v_HI8DOib72chyU3byqbynXxbiV909-g,4420
+nacl/encoding.py,sha256=tOiyIQVVpGU6A4Lzr0tMuqomhc_Aj0V_c1t56a-ZtPw,1928
+nacl/exceptions.py,sha256=6-hSnpjbUREnrmI1tZT2XqOBterZ0qoBsMvhCm1W5KQ,2128
+nacl/hash.py,sha256=83tVxKjG_DAZUsHKaKl-_kli7K0wNrV20cZxm4vY620,6164
+nacl/hashlib.py,sha256=R2uAL8lfdm_wGwEUcNI92YLyUcFKz9568xZFus7Msps,4197
+nacl/public.py,sha256=-nwQof5ov-wSSdvvoXh-FavTtjfpRnYykZkatNKyLd0,13442
+nacl/pwhash/__init__.py,sha256=_GxfRAjUCQlztdDHOUBbDINC3aJPIha8I-j3HIZE7eU,2720
+nacl/pwhash/__pycache__/__init__.cpython-38.pyc,,
+nacl/pwhash/__pycache__/_argon2.cpython-38.pyc,,
+nacl/pwhash/__pycache__/argon2i.cpython-38.pyc,,
+nacl/pwhash/__pycache__/argon2id.cpython-38.pyc,,
+nacl/pwhash/__pycache__/scrypt.cpython-38.pyc,,
+nacl/pwhash/_argon2.py,sha256=Eu3-juLws3_v1gNy5aeSVPEwuRVFdGOrfeF0wPH9VHA,1878
+nacl/pwhash/argon2i.py,sha256=EpheK0UHJvZYca_EMhhOcX5GXaOr0xCjFDTIgmSCSDo,4598
+nacl/pwhash/argon2id.py,sha256=IqNm5RQNEd1Z9F-bEWT-_Y9noU26QoTR5YdWONg1uuI,4610
+nacl/pwhash/scrypt.py,sha256=mpx0A2ocNkUiHVMy1qiW4UfSyI3RKxLraqkMXjbg6NI,6731
+nacl/secret.py,sha256=jf4WuUjnnXTekZ2elGgQozZl6zGzxGY_0Nw0fwehUlg,5430
+nacl/signing.py,sha256=jtPBhqfiY6JOZ-HlllRjIQ-8w3a0PFe1AyKVRBLlesg,7339
+nacl/utils.py,sha256=2rL0bIijNgEe7DOMk1-ClaZfoJCQ1NqkksrXP7bDWYU,2166
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b3b8cbbbf48d403d4151148e39bdbf3d25d2f0c2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: false
+Tag: cp35-abi3-manylinux1_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f52507f09b95c1d37c005528f28b345a8af187a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyNaCl-1.4.0.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_sodium
+nacl
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..3d82c281ee8ceb45368153139f5935bd8d39c816
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2017-2020 Ingy döt Net
+Copyright (c) 2006-2016 Kirill Simonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a70dd202d485af74ab22294dfbc7710364d0b127
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/METADATA
@@ -0,0 +1,41 @@
+Metadata-Version: 2.1
+Name: PyYAML
+Version: 5.3.1
+Summary: YAML parser and emitter for Python
+Home-page: https://github.com/yaml/pyyaml
+Author: Kirill Simonov
+Author-email: xi@resolvent.net
+License: MIT
+Download-URL: https://pypi.org/project/PyYAML/
+Platform: Any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+
+YAML is a data serialization format designed for human readability
+and interaction with scripting languages.  PyYAML is a YAML parser
+and emitter for Python.
+
+PyYAML features a complete YAML 1.1 parser, Unicode support, pickle
+support, capable extension API, and sensible error messages.  PyYAML
+supports standard YAML tags and provides Python-specific tags that
+allow to represent an arbitrary Python object.
+
+PyYAML is applicable for a broad range of tasks from complex
+configuration files to object serialization and persistence.
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..cae61d9785c50e2d66319fde9ccc891f7f960354
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/RECORD
@@ -0,0 +1,40 @@
+PyYAML-5.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+PyYAML-5.3.1.dist-info/LICENSE,sha256=xAESRJ8lS5dTBFklJIMT6ScO-jbSJrItgtTMbEPFfyk,1101
+PyYAML-5.3.1.dist-info/METADATA,sha256=xTsZFjd8T4M-5rC2M3BHgx_KTTpEPy5vFDIXrbzRXPQ,1758
+PyYAML-5.3.1.dist-info/RECORD,,
+PyYAML-5.3.1.dist-info/WHEEL,sha256=TpFVeXF_cAlV118WSIPWtjqW7nPvzoOw-49FmS3fDKQ,103
+PyYAML-5.3.1.dist-info/top_level.txt,sha256=rpj0IVMTisAjh_1vG3Ccf9v5jpCQwAz6cD1IVU5ZdhQ,11
+yaml/__init__.py,sha256=XFUNbKTg4afAd0BETjGQ1mKQ97_g5jbE1C0WoKc74dc,13170
+yaml/__pycache__/__init__.cpython-38.pyc,,
+yaml/__pycache__/composer.cpython-38.pyc,,
+yaml/__pycache__/constructor.cpython-38.pyc,,
+yaml/__pycache__/cyaml.cpython-38.pyc,,
+yaml/__pycache__/dumper.cpython-38.pyc,,
+yaml/__pycache__/emitter.cpython-38.pyc,,
+yaml/__pycache__/error.cpython-38.pyc,,
+yaml/__pycache__/events.cpython-38.pyc,,
+yaml/__pycache__/loader.cpython-38.pyc,,
+yaml/__pycache__/nodes.cpython-38.pyc,,
+yaml/__pycache__/parser.cpython-38.pyc,,
+yaml/__pycache__/reader.cpython-38.pyc,,
+yaml/__pycache__/representer.cpython-38.pyc,,
+yaml/__pycache__/resolver.cpython-38.pyc,,
+yaml/__pycache__/scanner.cpython-38.pyc,,
+yaml/__pycache__/serializer.cpython-38.pyc,,
+yaml/__pycache__/tokens.cpython-38.pyc,,
+yaml/composer.py,sha256=_Ko30Wr6eDWUeUpauUGT3Lcg9QPBnOPVlTnIMRGJ9FM,4883
+yaml/constructor.py,sha256=O3Uaf0_J_5GQBoeI9ZNhpJAhtdagr_X2HzDgGbZOMnw,28627
+yaml/cyaml.py,sha256=LiMkvchNonfoy1F6ec9L2BiUz3r0bwF4hympASJX1Ic,3846
+yaml/dumper.py,sha256=PLctZlYwZLp7XmeUdwRuv4nYOZ2UBnDIUy8-lKfLF-o,2837
+yaml/emitter.py,sha256=jghtaU7eFwg31bG0B7RZea_29Adi9CKmXq_QjgQpCkQ,43006
+yaml/error.py,sha256=Ah9z-toHJUbE9j-M8YpxgSRM5CgLCcwVzJgLLRF2Fxo,2533
+yaml/events.py,sha256=50_TksgQiE4up-lKo_V-nBy-tAIxkIPQxY5qDhKCeHw,2445
+yaml/loader.py,sha256=UVa-zIqmkFSCIYq_PgSGm4NSJttHY2Rf_zQ4_b1fHN0,2061
+yaml/nodes.py,sha256=gPKNj8pKCdh2d4gr3gIYINnPOaOxGhJAUiYhGRnPE84,1440
+yaml/parser.py,sha256=ilWp5vvgoHFGzvOZDItFoGjD6D42nhlZrZyjAwa0oJo,25495
+yaml/reader.py,sha256=0dmzirOiDG4Xo41RnuQS7K9rkY3xjHiVasfDMNTqCNw,6794
+yaml/representer.py,sha256=82UM3ZxUQKqsKAF4ltWOxCS6jGPIFtXpGs7mvqyv4Xs,14184
+yaml/resolver.py,sha256=DJCjpQr8YQCEYYjKEYqTl0GrsZil2H4aFOI9b0Oe-U4,8970
+yaml/scanner.py,sha256=KeQIKGNlSyPE8QDwionHxy9CgbqE5teJEz05FR9-nAg,51277
+yaml/serializer.py,sha256=ChuFgmhU01hj4xgI8GaKv6vfM2Bujwa9i7d2FAHj7cA,4165
+yaml/tokens.py,sha256=lTQIzSVw8Mg9wv459-TjiOQe6wVziqaRlqX2_89rp54,2573
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d193dea988d97c2f7f7bf3c4fc196496d361cd4d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-linux_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e6475e911f628412049bc4090d86f23ac403adde
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/PyYAML-5.3.1.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_yaml
+yaml
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_cffi_backend.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_cffi_backend.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..297c22e69ccbaa0d47386c02711d4ce45df5959f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_cffi_backend.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_pyrsistent_version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_pyrsistent_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..e0cd4e2283d025bf91267601a1bf8d5503198464
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_pyrsistent_version.py
@@ -0,0 +1 @@
+__version__ = '0.17.3'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.pth b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.pth
new file mode 100644
index 0000000000000000000000000000000000000000..1c3ff99867d8110052195fed7650ec50c1f3adfe
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.pth
@@ -0,0 +1 @@
+import _virtualenv
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..b399da4cc2c6254fecb330943e0e6834a19c27c8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/_virtualenv.py
@@ -0,0 +1,115 @@
+"""Patches that are applied at runtime to the virtual environment"""
+# -*- coding: utf-8 -*-
+
+import os
+import sys
+
+VIRTUALENV_PATCH_FILE = os.path.join(__file__)
+
+
+def patch_dist(dist):
+    """
+    Distutils allows user to configure some arguments via a configuration file:
+    https://docs.python.org/3/install/index.html#distutils-configuration-files
+
+    Some of this arguments though don't make sense in context of the virtual environment files, let's fix them up.
+    """
+    # we cannot allow some install config as that would get packages installed outside of the virtual environment
+    old_parse_config_files = dist.Distribution.parse_config_files
+
+    def parse_config_files(self, *args, **kwargs):
+        result = old_parse_config_files(self, *args, **kwargs)
+        install = self.get_option_dict("install")
+
+        if "prefix" in install:  # the prefix governs where to install the libraries
+            install["prefix"] = VIRTUALENV_PATCH_FILE, os.path.abspath(sys.prefix)
+        for base in ("purelib", "platlib", "headers", "scripts", "data"):
+            key = "install_{}".format(base)
+            if key in install:  # do not allow global configs to hijack venv paths
+                install.pop(key, None)
+        return result
+
+    dist.Distribution.parse_config_files = parse_config_files
+
+
+# Import hook that patches some modules to ignore configuration values that break package installation in case
+# of virtual environments.
+_DISTUTILS_PATCH = "distutils.dist", "setuptools.dist"
+if sys.version_info > (3, 4):
+    # https://docs.python.org/3/library/importlib.html#setting-up-an-importer
+    from importlib.abc import MetaPathFinder
+    from importlib.util import find_spec
+    from threading import Lock
+    from functools import partial
+
+    class _Finder(MetaPathFinder):
+        """A meta path finder that allows patching the imported distutils modules"""
+
+        fullname = None
+        lock = Lock()
+
+        def find_spec(self, fullname, path, target=None):
+            if fullname in _DISTUTILS_PATCH and self.fullname is None:
+                with self.lock:
+                    self.fullname = fullname
+                    try:
+                        spec = find_spec(fullname, path)
+                        if spec is not None:
+                            # https://www.python.org/dev/peps/pep-0451/#how-loading-will-work
+                            is_new_api = hasattr(spec.loader, "exec_module")
+                            func_name = "exec_module" if is_new_api else "load_module"
+                            old = getattr(spec.loader, func_name)
+                            func = self.exec_module if is_new_api else self.load_module
+                            if old is not func:
+                                try:
+                                    setattr(spec.loader, func_name, partial(func, old))
+                                except AttributeError:
+                                    pass  # C-Extension loaders are r/o such as zipimporter with <python 3.7
+                            return spec
+                    finally:
+                        self.fullname = None
+
+        @staticmethod
+        def exec_module(old, module):
+            old(module)
+            if module.__name__ in _DISTUTILS_PATCH:
+                patch_dist(module)
+
+        @staticmethod
+        def load_module(old, name):
+            module = old(name)
+            if module.__name__ in _DISTUTILS_PATCH:
+                patch_dist(module)
+            return module
+
+    sys.meta_path.insert(0, _Finder())
+else:
+    # https://www.python.org/dev/peps/pep-0302/
+    from imp import find_module
+    from pkgutil import ImpImporter, ImpLoader
+
+    class _VirtualenvImporter(object, ImpImporter):
+        def __init__(self, path=None):
+            object.__init__(self)
+            ImpImporter.__init__(self, path)
+
+        def find_module(self, fullname, path=None):
+            if fullname in _DISTUTILS_PATCH:
+                try:
+                    return _VirtualenvLoader(fullname, *find_module(fullname.split(".")[-1], path))
+                except ImportError:
+                    pass
+            return None
+
+    class _VirtualenvLoader(object, ImpLoader):
+        def __init__(self, fullname, file, filename, etc):
+            object.__init__(self)
+            ImpLoader.__init__(self, fullname, file, filename, etc)
+
+        def load_module(self, fullname):
+            module = super(_VirtualenvLoader, self).load_module(fullname)
+            patch_dist(module)
+            module.__loader__ = None  # distlib fallback
+            return module
+
+    sys.meta_path.append(_VirtualenvImporter())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..56a3d6ea2099dfccf5396bd3f4ebb2531f1da2a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/METADATA
@@ -0,0 +1,256 @@
+Metadata-Version: 2.1
+Name: appdirs
+Version: 1.4.3
+Summary: A small Python module for determining appropriate platform-specific dirs, e.g. a "user data dir".
+Home-page: http://github.com/ActiveState/appdirs
+Author: Trent Mick
+Author-email: trentm@gmail.com
+Maintainer: Trent Mick; Sridhar Ratnakumar; Jeff Rouse
+Maintainer-email: trentm@gmail.com; github@srid.name; jr@its.to
+License: MIT
+Keywords: application directory log cache user
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+
+
+.. image:: https://secure.travis-ci.org/ActiveState/appdirs.png
+    :target: http://travis-ci.org/ActiveState/appdirs
+
+the problem
+===========
+
+What directory should your app use for storing user data? If running on Mac OS X, you
+should use::
+
+    ~/Library/Application Support/<AppName>
+
+If on Windows (at least English Win XP) that should be::
+
+    C:\Documents and Settings\<User>\Application Data\Local Settings\<AppAuthor>\<AppName>
+
+or possibly::
+
+    C:\Documents and Settings\<User>\Application Data\<AppAuthor>\<AppName>
+
+for `roaming profiles <http://bit.ly/9yl3b6>`_ but that is another story.
+
+On Linux (and other Unices) the dir, according to the `XDG
+spec <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_, is::
+
+    ~/.local/share/<AppName>
+
+
+``appdirs`` to the rescue
+=========================
+
+This kind of thing is what the ``appdirs`` module is for. ``appdirs`` will
+help you choose an appropriate:
+
+- user data dir (``user_data_dir``)
+- user config dir (``user_config_dir``)
+- user cache dir (``user_cache_dir``)
+- site data dir (``site_data_dir``)
+- site config dir (``site_config_dir``)
+- user log dir (``user_log_dir``)
+
+and also:
+
+- is a single module so other Python packages can include their own private copy
+- is slightly opinionated on the directory names used. Look for "OPINION" in
+  documentation and code for when an opinion is being applied.
+
+
+some example output
+===================
+
+On Mac OS X::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    '/Users/trentm/Library/Application Support/SuperApp'
+    >>> site_data_dir(appname, appauthor)
+    '/Library/Application Support/SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    '/Users/trentm/Library/Caches/SuperApp'
+    >>> user_log_dir(appname, appauthor)
+    '/Users/trentm/Library/Logs/SuperApp'
+
+On Windows 7::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
+    >>> user_data_dir(appname, appauthor, roaming=True)
+    'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache'
+    >>> user_log_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs'
+
+On Linux::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    '/home/trentm/.local/share/SuperApp
+    >>> site_data_dir(appname, appauthor)
+    '/usr/local/share/SuperApp'
+    >>> site_data_dir(appname, appauthor, multipath=True)
+    '/usr/local/share/SuperApp:/usr/share/SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    '/home/trentm/.cache/SuperApp'
+    >>> user_log_dir(appname, appauthor)
+    '/home/trentm/.cache/SuperApp/log'
+    >>> user_config_dir(appname)
+    '/home/trentm/.config/SuperApp'
+    >>> site_config_dir(appname)
+    '/etc/xdg/SuperApp'
+    >>> os.environ['XDG_CONFIG_DIRS'] = '/etc:/usr/local/etc'
+    >>> site_config_dir(appname, multipath=True)
+    '/etc/SuperApp:/usr/local/etc/SuperApp'
+
+
+``AppDirs`` for convenience
+===========================
+
+::
+
+    >>> from appdirs import AppDirs
+    >>> dirs = AppDirs("SuperApp", "Acme")
+    >>> dirs.user_data_dir
+    '/Users/trentm/Library/Application Support/SuperApp'
+    >>> dirs.site_data_dir
+    '/Library/Application Support/SuperApp'
+    >>> dirs.user_cache_dir
+    '/Users/trentm/Library/Caches/SuperApp'
+    >>> dirs.user_log_dir
+    '/Users/trentm/Library/Logs/SuperApp'
+
+
+
+Per-version isolation
+=====================
+
+If you have multiple versions of your app in use that you want to be
+able to run side-by-side, then you may want version-isolation for these
+dirs::
+
+    >>> from appdirs import AppDirs
+    >>> dirs = AppDirs("SuperApp", "Acme", version="1.0")
+    >>> dirs.user_data_dir
+    '/Users/trentm/Library/Application Support/SuperApp/1.0'
+    >>> dirs.site_data_dir
+    '/Library/Application Support/SuperApp/1.0'
+    >>> dirs.user_cache_dir
+    '/Users/trentm/Library/Caches/SuperApp/1.0'
+    >>> dirs.user_log_dir
+    '/Users/trentm/Library/Logs/SuperApp/1.0'
+
+
+
+appdirs Changelog
+=================
+
+appdirs 1.4.3
+-------------
+- [PR #76] Python 3.6 invalid escape sequence deprecation fixes
+- Fix for Python 3.6 support
+
+appdirs 1.4.2
+-------------
+- [PR #84] Allow installing without setuptools
+- [PR #86] Fix string delimiters in setup.py description
+- Add Python 3.6 support
+
+appdirs 1.4.1
+-------------
+- [issue #38] Fix _winreg import on Windows Py3
+- [issue #55] Make appname optional
+
+appdirs 1.4.0
+-------------
+- [PR #42] AppAuthor is now optional on Windows
+- [issue 41] Support Jython on Windows, Mac, and Unix-like platforms. Windows
+  support requires `JNA <https://github.com/twall/jna>`_.
+- [PR #44] Fix incorrect behaviour of the site_config_dir method
+
+appdirs 1.3.0
+-------------
+- [Unix, issue 16] Conform to XDG standard, instead of breaking it for
+  everybody
+- [Unix] Removes gratuitous case mangling of the case, since \*nix-es are
+  usually case sensitive, so mangling is not wise
+- [Unix] Fixes the utterly wrong behaviour in ``site_data_dir``, return result
+  based on XDG_DATA_DIRS and make room for respecting the standard which
+  specifies XDG_DATA_DIRS is a multiple-value variable
+- [Issue 6] Add ``*_config_dir`` which are distinct on nix-es, according to
+  XDG specs; on Windows and Mac return the corresponding ``*_data_dir``
+
+appdirs 1.2.0
+-------------
+
+- [Unix] Put ``user_log_dir`` under the *cache* dir on Unix. Seems to be more
+  typical.
+- [issue 9] Make ``unicode`` work on py3k.
+
+appdirs 1.1.0
+-------------
+
+- [issue 4] Add ``AppDirs.user_log_dir``.
+- [Unix, issue 2, issue 7] appdirs now conforms to `XDG base directory spec
+  <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_.
+- [Mac, issue 5] Fix ``site_data_dir()`` on Mac.
+- [Mac] Drop use of 'Carbon' module in favour of hardcoded paths; supports
+  Python3 now.
+- [Windows] Append "Cache" to ``user_cache_dir`` on Windows by default. Use
+  ``opinion=False`` option to disable this.
+- Add ``appdirs.AppDirs`` convenience class. Usage:
+
+        >>> dirs = AppDirs("SuperApp", "Acme", version="1.0")
+        >>> dirs.user_data_dir
+        '/Users/trentm/Library/Application Support/SuperApp/1.0'
+
+- [Windows] Cherry-pick Komodo's change to downgrade paths to the Windows short
+  paths if there are high bit chars.
+- [Linux] Change default ``user_cache_dir()`` on Linux to be singular, e.g.
+  "~/.superapp/cache".
+- [Windows] Add ``roaming`` option to ``user_data_dir()`` (for use on Windows only)
+  and change the default ``user_data_dir`` behaviour to use a *non*-roaming
+  profile dir (``CSIDL_LOCAL_APPDATA`` instead of ``CSIDL_APPDATA``). Why? Because
+  a large roaming profile can cause login speed issues. The "only syncs on
+  logout" behaviour can cause surprises in appdata info.
+
+
+appdirs 1.0.1 (never released)
+------------------------------
+
+Started this changelog 27 July 2010. Before that this module originated in the
+`Komodo <http://www.activestate.com/komodo>`_ product as ``applib.py`` and then
+as `applib/location.py
+<http://github.com/ActiveState/applib/blob/master/applib/location.py>`_ (used by
+`PyPM <http://code.activestate.com/pypm/>`_ in `ActivePython
+<http://www.activestate.com/activepython>`_). This is basically a fork of
+applib.py 1.0.1 and applib/location.py 1.0.1.
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..2a398ff7c671d56f484f9f24393fc393b16dca95
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/RECORD
@@ -0,0 +1,11 @@
+appdirs.py,sha256=MievUEuv3l_mQISH5SF0shDk_BNhHHzYiAPrT3ITN4I,24701
+appdirs-1.4.3.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+appdirs-1.4.3.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+appdirs-1.4.3.dist-info/METADATA,sha256=CYv_MUT9ndNhXtkeyXnWjTM6jW_z6fsu8wqD6Yxfn0k,8831
+appdirs-1.4.3.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+appdirs-1.4.3.dist-info/top_level.txt,sha256=nKncE8CUqZERJ6VuQWL4_bkunSPDNfn7KZqb4Tr5YEM,8
+appdirs-1.4.3.dist-info/RECORD,,
+appdirs.cpython-38.pyc,,
+appdirs-1.4.3.dist-info/__pycache__,,
+appdirs-1.4.3.virtualenv,,
+appdirs-1.4.3.dist-info/INSTALLER,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d64bc321a11c17064f6e048ffcee9044688aa819
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+appdirs
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.3.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..107c61405e3b4a3266a83064073910b6c8d4a42a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/LICENSE.txt
@@ -0,0 +1,23 @@
+# This is the MIT license
+
+Copyright (c) 2010 ActiveState Software Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f95073104453fbfb5c3d7ef1dd065544bc63ff2a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/METADATA
@@ -0,0 +1,264 @@
+Metadata-Version: 2.1
+Name: appdirs
+Version: 1.4.4
+Summary: A small Python module for determining appropriate platform-specific dirs, e.g. a "user data dir".
+Home-page: http://github.com/ActiveState/appdirs
+Author: Trent Mick
+Author-email: trentm@gmail.com
+Maintainer: Jeff Rouse
+Maintainer-email: jr@its.to
+License: MIT
+Keywords: application directory log cache user
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+
+
+.. image:: https://secure.travis-ci.org/ActiveState/appdirs.png
+    :target: http://travis-ci.org/ActiveState/appdirs
+
+the problem
+===========
+
+What directory should your app use for storing user data? If running on Mac OS X, you
+should use::
+
+    ~/Library/Application Support/<AppName>
+
+If on Windows (at least English Win XP) that should be::
+
+    C:\Documents and Settings\<User>\Application Data\Local Settings\<AppAuthor>\<AppName>
+
+or possibly::
+
+    C:\Documents and Settings\<User>\Application Data\<AppAuthor>\<AppName>
+
+for `roaming profiles <http://bit.ly/9yl3b6>`_ but that is another story.
+
+On Linux (and other Unices) the dir, according to the `XDG
+spec <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_, is::
+
+    ~/.local/share/<AppName>
+
+
+``appdirs`` to the rescue
+=========================
+
+This kind of thing is what the ``appdirs`` module is for. ``appdirs`` will
+help you choose an appropriate:
+
+- user data dir (``user_data_dir``)
+- user config dir (``user_config_dir``)
+- user cache dir (``user_cache_dir``)
+- site data dir (``site_data_dir``)
+- site config dir (``site_config_dir``)
+- user log dir (``user_log_dir``)
+
+and also:
+
+- is a single module so other Python packages can include their own private copy
+- is slightly opinionated on the directory names used. Look for "OPINION" in
+  documentation and code for when an opinion is being applied.
+
+
+some example output
+===================
+
+On Mac OS X::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    '/Users/trentm/Library/Application Support/SuperApp'
+    >>> site_data_dir(appname, appauthor)
+    '/Library/Application Support/SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    '/Users/trentm/Library/Caches/SuperApp'
+    >>> user_log_dir(appname, appauthor)
+    '/Users/trentm/Library/Logs/SuperApp'
+
+On Windows 7::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
+    >>> user_data_dir(appname, appauthor, roaming=True)
+    'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache'
+    >>> user_log_dir(appname, appauthor)
+    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs'
+
+On Linux::
+
+    >>> from appdirs import *
+    >>> appname = "SuperApp"
+    >>> appauthor = "Acme"
+    >>> user_data_dir(appname, appauthor)
+    '/home/trentm/.local/share/SuperApp
+    >>> site_data_dir(appname, appauthor)
+    '/usr/local/share/SuperApp'
+    >>> site_data_dir(appname, appauthor, multipath=True)
+    '/usr/local/share/SuperApp:/usr/share/SuperApp'
+    >>> user_cache_dir(appname, appauthor)
+    '/home/trentm/.cache/SuperApp'
+    >>> user_log_dir(appname, appauthor)
+    '/home/trentm/.cache/SuperApp/log'
+    >>> user_config_dir(appname)
+    '/home/trentm/.config/SuperApp'
+    >>> site_config_dir(appname)
+    '/etc/xdg/SuperApp'
+    >>> os.environ['XDG_CONFIG_DIRS'] = '/etc:/usr/local/etc'
+    >>> site_config_dir(appname, multipath=True)
+    '/etc/SuperApp:/usr/local/etc/SuperApp'
+
+
+``AppDirs`` for convenience
+===========================
+
+::
+
+    >>> from appdirs import AppDirs
+    >>> dirs = AppDirs("SuperApp", "Acme")
+    >>> dirs.user_data_dir
+    '/Users/trentm/Library/Application Support/SuperApp'
+    >>> dirs.site_data_dir
+    '/Library/Application Support/SuperApp'
+    >>> dirs.user_cache_dir
+    '/Users/trentm/Library/Caches/SuperApp'
+    >>> dirs.user_log_dir
+    '/Users/trentm/Library/Logs/SuperApp'
+
+
+
+Per-version isolation
+=====================
+
+If you have multiple versions of your app in use that you want to be
+able to run side-by-side, then you may want version-isolation for these
+dirs::
+
+    >>> from appdirs import AppDirs
+    >>> dirs = AppDirs("SuperApp", "Acme", version="1.0")
+    >>> dirs.user_data_dir
+    '/Users/trentm/Library/Application Support/SuperApp/1.0'
+    >>> dirs.site_data_dir
+    '/Library/Application Support/SuperApp/1.0'
+    >>> dirs.user_cache_dir
+    '/Users/trentm/Library/Caches/SuperApp/1.0'
+    >>> dirs.user_log_dir
+    '/Users/trentm/Library/Logs/SuperApp/1.0'
+
+
+
+appdirs Changelog
+=================
+
+appdirs 1.4.4
+-------------
+- [PR #92] Don't import appdirs from setup.py
+
+Project officially classified as Stable which is important
+for inclusion in other distros such as ActivePython.
+
+First of several incremental releases to catch up on maintenance.
+
+appdirs 1.4.3
+-------------
+- [PR #76] Python 3.6 invalid escape sequence deprecation fixes
+- Fix for Python 3.6 support
+
+appdirs 1.4.2
+-------------
+- [PR #84] Allow installing without setuptools
+- [PR #86] Fix string delimiters in setup.py description
+- Add Python 3.6 support
+
+appdirs 1.4.1
+-------------
+- [issue #38] Fix _winreg import on Windows Py3
+- [issue #55] Make appname optional
+
+appdirs 1.4.0
+-------------
+- [PR #42] AppAuthor is now optional on Windows
+- [issue 41] Support Jython on Windows, Mac, and Unix-like platforms. Windows
+  support requires `JNA <https://github.com/twall/jna>`_.
+- [PR #44] Fix incorrect behaviour of the site_config_dir method
+
+appdirs 1.3.0
+-------------
+- [Unix, issue 16] Conform to XDG standard, instead of breaking it for
+  everybody
+- [Unix] Removes gratuitous case mangling of the case, since \*nix-es are
+  usually case sensitive, so mangling is not wise
+- [Unix] Fixes the utterly wrong behaviour in ``site_data_dir``, return result
+  based on XDG_DATA_DIRS and make room for respecting the standard which
+  specifies XDG_DATA_DIRS is a multiple-value variable
+- [Issue 6] Add ``*_config_dir`` which are distinct on nix-es, according to
+  XDG specs; on Windows and Mac return the corresponding ``*_data_dir``
+
+appdirs 1.2.0
+-------------
+
+- [Unix] Put ``user_log_dir`` under the *cache* dir on Unix. Seems to be more
+  typical.
+- [issue 9] Make ``unicode`` work on py3k.
+
+appdirs 1.1.0
+-------------
+
+- [issue 4] Add ``AppDirs.user_log_dir``.
+- [Unix, issue 2, issue 7] appdirs now conforms to `XDG base directory spec
+  <http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html>`_.
+- [Mac, issue 5] Fix ``site_data_dir()`` on Mac.
+- [Mac] Drop use of 'Carbon' module in favour of hardcoded paths; supports
+  Python3 now.
+- [Windows] Append "Cache" to ``user_cache_dir`` on Windows by default. Use
+  ``opinion=False`` option to disable this.
+- Add ``appdirs.AppDirs`` convenience class. Usage:
+
+        >>> dirs = AppDirs("SuperApp", "Acme", version="1.0")
+        >>> dirs.user_data_dir
+        '/Users/trentm/Library/Application Support/SuperApp/1.0'
+
+- [Windows] Cherry-pick Komodo's change to downgrade paths to the Windows short
+  paths if there are high bit chars.
+- [Linux] Change default ``user_cache_dir()`` on Linux to be singular, e.g.
+  "~/.superapp/cache".
+- [Windows] Add ``roaming`` option to ``user_data_dir()`` (for use on Windows only)
+  and change the default ``user_data_dir`` behaviour to use a *non*-roaming
+  profile dir (``CSIDL_LOCAL_APPDATA`` instead of ``CSIDL_APPDATA``). Why? Because
+  a large roaming profile can cause login speed issues. The "only syncs on
+  logout" behaviour can cause surprises in appdata info.
+
+
+appdirs 1.0.1 (never released)
+------------------------------
+
+Started this changelog 27 July 2010. Before that this module originated in the
+`Komodo <http://www.activestate.com/komodo>`_ product as ``applib.py`` and then
+as `applib/location.py
+<http://github.com/ActiveState/applib/blob/master/applib/location.py>`_ (used by
+`PyPM <http://code.activestate.com/pypm/>`_ in `ActivePython
+<http://www.activestate.com/activepython>`_). This is basically a fork of
+applib.py 1.0.1 and applib/location.py 1.0.1.
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..56589537071d76decc66a51c8e3592b8c3895a35
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/RECORD
@@ -0,0 +1,8 @@
+__pycache__/appdirs.cpython-38.pyc,,
+appdirs-1.4.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+appdirs-1.4.4.dist-info/LICENSE.txt,sha256=Nt200KdFqTqyAyA9cZCBSxuJcn0lTK_0jHp6-71HAAs,1097
+appdirs-1.4.4.dist-info/METADATA,sha256=k5TVfXMNKGHTfp2wm6EJKTuGwGNuoQR5TqQgH8iwG8M,8981
+appdirs-1.4.4.dist-info/RECORD,,
+appdirs-1.4.4.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+appdirs-1.4.4.dist-info/top_level.txt,sha256=nKncE8CUqZERJ6VuQWL4_bkunSPDNfn7KZqb4Tr5YEM,8
+appdirs.py,sha256=g99s2sXhnvTEm79oj4bWI0Toapc-_SmKKNXvOXHkVic,24720
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d64bc321a11c17064f6e048ffcee9044688aa819
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs-1.4.4.dist-info/top_level.txt
@@ -0,0 +1 @@
+appdirs
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae67001af8b661373edeee2eb327b9f63e630d62
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/appdirs.py
@@ -0,0 +1,608 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+# Copyright (c) 2005-2010 ActiveState Software Inc.
+# Copyright (c) 2013 Eddy Petrișor
+
+"""Utilities for determining application-specific dirs.
+
+See <http://github.com/ActiveState/appdirs> for details and usage.
+"""
+# Dev Notes:
+# - MSDN on where to store app data files:
+#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
+# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
+# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
+
+__version_info__ = (1, 4, 3)
+__version__ = '.'.join(map(str, __version_info__))
+
+
+import sys
+import os
+
+PY3 = sys.version_info[0] == 3
+
+if PY3:
+    unicode = str
+
+if sys.platform.startswith('java'):
+    import platform
+    os_name = platform.java_ver()[3][0]
+    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
+        system = 'win32'
+    elif os_name.startswith('Mac'): # "Mac OS X", etc.
+        system = 'darwin'
+    else: # "Linux", "SunOS", "FreeBSD", etc.
+        # Setting this to "linux2" is not ideal, but only Windows or Mac
+        # are actually checked for and the rest of the module expects
+        # *sys.platform* style strings.
+        system = 'linux2'
+else:
+    system = sys.platform
+
+
+
+def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user data directories are:
+        Mac OS X:               ~/Library/Application Support/<AppName>
+        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
+        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
+        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
+        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
+        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>
+
+    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
+    That means, by default "~/.local/share/<AppName>".
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
+        path = os.path.normpath(_get_win_folder(const))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+    elif system == 'darwin':
+        path = os.path.expanduser('~/Library/Application Support/')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
+    r"""Return full path to the user-shared data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "multipath" is an optional parameter only applicable to *nix
+            which indicates that the entire list of data dirs should be
+            returned. By default, the first item from XDG_DATA_DIRS is
+            returned, or '/usr/local/share/<AppName>',
+            if XDG_DATA_DIRS is not set
+
+    Typical site data directories are:
+        Mac OS X:   /Library/Application Support/<AppName>
+        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
+        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
+        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
+        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.
+
+    For Unix, this is using the $XDG_DATA_DIRS[0] default.
+
+    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+    elif system == 'darwin':
+        path = os.path.expanduser('/Library/Application Support')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        # XDG default for $XDG_DATA_DIRS
+        # only first, if multipath is False
+        path = os.getenv('XDG_DATA_DIRS',
+                         os.pathsep.join(['/usr/local/share', '/usr/share']))
+        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
+        if appname:
+            if version:
+                appname = os.path.join(appname, version)
+            pathlist = [os.sep.join([x, appname]) for x in pathlist]
+
+        if multipath:
+            path = os.pathsep.join(pathlist)
+        else:
+            path = pathlist[0]
+        return path
+
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific config dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user config directories are:
+        Mac OS X:               same as user_data_dir
+        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
+        Win *:                  same as user_data_dir
+
+    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
+    That means, by default "~/.config/<AppName>".
+    """
+    if system in ["win32", "darwin"]:
+        path = user_data_dir(appname, appauthor, None, roaming)
+    else:
+        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
+    r"""Return full path to the user-shared data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "multipath" is an optional parameter only applicable to *nix
+            which indicates that the entire list of config dirs should be
+            returned. By default, the first item from XDG_CONFIG_DIRS is
+            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set
+
+    Typical site config directories are:
+        Mac OS X:   same as site_data_dir
+        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
+                    $XDG_CONFIG_DIRS
+        Win *:      same as site_data_dir
+        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
+
+    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False
+
+    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
+    """
+    if system in ["win32", "darwin"]:
+        path = site_data_dir(appname, appauthor)
+        if appname and version:
+            path = os.path.join(path, version)
+    else:
+        # XDG default for $XDG_CONFIG_DIRS
+        # only first, if multipath is False
+        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
+        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
+        if appname:
+            if version:
+                appname = os.path.join(appname, version)
+            pathlist = [os.sep.join([x, appname]) for x in pathlist]
+
+        if multipath:
+            path = os.pathsep.join(pathlist)
+        else:
+            path = pathlist[0]
+    return path
+
+
+def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
+    r"""Return full path to the user-specific cache dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "opinion" (boolean) can be False to disable the appending of
+            "Cache" to the base app data dir for Windows. See
+            discussion below.
+
+    Typical user cache directories are:
+        Mac OS X:   ~/Library/Caches/<AppName>
+        Unix:       ~/.cache/<AppName> (XDG default)
+        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
+        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache
+
+    On Windows the only suggestion in the MSDN docs is that local settings go in
+    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
+    app data dir (the default returned by `user_data_dir` above). Apps typically
+    put cache data somewhere *under* the given dir here. Some examples:
+        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
+        ...\Acme\SuperApp\Cache\1.0
+    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
+    This can be disabled with the `opinion=False` option.
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+            if opinion:
+                path = os.path.join(path, "Cache")
+    elif system == 'darwin':
+        path = os.path.expanduser('~/Library/Caches')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific state dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user state directories are:
+        Mac OS X:  same as user_data_dir
+        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
+        Win *:     same as user_data_dir
+
+    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
+    to extend the XDG spec and support $XDG_STATE_HOME.
+
+    That means, by default "~/.local/state/<AppName>".
+    """
+    if system in ["win32", "darwin"]:
+        path = user_data_dir(appname, appauthor, None, roaming)
+    else:
+        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
+    r"""Return full path to the user-specific log dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "opinion" (boolean) can be False to disable the appending of
+            "Logs" to the base app data dir for Windows, and "log" to the
+            base cache dir for Unix. See discussion below.
+
+    Typical user log directories are:
+        Mac OS X:   ~/Library/Logs/<AppName>
+        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
+        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
+        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs
+
+    On Windows the only suggestion in the MSDN docs is that local settings
+    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
+    examples of what some windows apps use for a logs dir.)
+
+    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
+    value for Windows and appends "log" to the user cache dir for Unix.
+    This can be disabled with the `opinion=False` option.
+    """
+    if system == "darwin":
+        path = os.path.join(
+            os.path.expanduser('~/Library/Logs'),
+            appname)
+    elif system == "win32":
+        path = user_data_dir(appname, appauthor, version)
+        version = False
+        if opinion:
+            path = os.path.join(path, "Logs")
+    else:
+        path = user_cache_dir(appname, appauthor, version)
+        version = False
+        if opinion:
+            path = os.path.join(path, "log")
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+class AppDirs(object):
+    """Convenience wrapper for getting application dirs."""
+    def __init__(self, appname=None, appauthor=None, version=None,
+            roaming=False, multipath=False):
+        self.appname = appname
+        self.appauthor = appauthor
+        self.version = version
+        self.roaming = roaming
+        self.multipath = multipath
+
+    @property
+    def user_data_dir(self):
+        return user_data_dir(self.appname, self.appauthor,
+                             version=self.version, roaming=self.roaming)
+
+    @property
+    def site_data_dir(self):
+        return site_data_dir(self.appname, self.appauthor,
+                             version=self.version, multipath=self.multipath)
+
+    @property
+    def user_config_dir(self):
+        return user_config_dir(self.appname, self.appauthor,
+                               version=self.version, roaming=self.roaming)
+
+    @property
+    def site_config_dir(self):
+        return site_config_dir(self.appname, self.appauthor,
+                             version=self.version, multipath=self.multipath)
+
+    @property
+    def user_cache_dir(self):
+        return user_cache_dir(self.appname, self.appauthor,
+                              version=self.version)
+
+    @property
+    def user_state_dir(self):
+        return user_state_dir(self.appname, self.appauthor,
+                              version=self.version)
+
+    @property
+    def user_log_dir(self):
+        return user_log_dir(self.appname, self.appauthor,
+                            version=self.version)
+
+
+#---- internal support stuff
+
+def _get_win_folder_from_registry(csidl_name):
+    """This is a fallback technique at best. I'm not sure if using the
+    registry for this guarantees us the correct answer for all CSIDL_*
+    names.
+    """
+    if PY3:
+      import winreg as _winreg
+    else:
+      import _winreg
+
+    shell_folder_name = {
+        "CSIDL_APPDATA": "AppData",
+        "CSIDL_COMMON_APPDATA": "Common AppData",
+        "CSIDL_LOCAL_APPDATA": "Local AppData",
+    }[csidl_name]
+
+    key = _winreg.OpenKey(
+        _winreg.HKEY_CURRENT_USER,
+        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
+    )
+    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
+    return dir
+
+
+def _get_win_folder_with_pywin32(csidl_name):
+    from win32com.shell import shellcon, shell
+    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
+    # Try to make this a unicode path because SHGetFolderPath does
+    # not return unicode strings when there is unicode data in the
+    # path.
+    try:
+        dir = unicode(dir)
+
+        # Downgrade to short path name if have highbit chars. See
+        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+        has_high_char = False
+        for c in dir:
+            if ord(c) > 255:
+                has_high_char = True
+                break
+        if has_high_char:
+            try:
+                import win32api
+                dir = win32api.GetShortPathName(dir)
+            except ImportError:
+                pass
+    except UnicodeError:
+        pass
+    return dir
+
+
+def _get_win_folder_with_ctypes(csidl_name):
+    import ctypes
+
+    csidl_const = {
+        "CSIDL_APPDATA": 26,
+        "CSIDL_COMMON_APPDATA": 35,
+        "CSIDL_LOCAL_APPDATA": 28,
+    }[csidl_name]
+
+    buf = ctypes.create_unicode_buffer(1024)
+    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
+
+    # Downgrade to short path name if have highbit chars. See
+    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+    has_high_char = False
+    for c in buf:
+        if ord(c) > 255:
+            has_high_char = True
+            break
+    if has_high_char:
+        buf2 = ctypes.create_unicode_buffer(1024)
+        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
+            buf = buf2
+
+    return buf.value
+
+def _get_win_folder_with_jna(csidl_name):
+    import array
+    from com.sun import jna
+    from com.sun.jna.platform import win32
+
+    buf_size = win32.WinDef.MAX_PATH * 2
+    buf = array.zeros('c', buf_size)
+    shell = win32.Shell32.INSTANCE
+    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
+    dir = jna.Native.toString(buf.tostring()).rstrip("\0")
+
+    # Downgrade to short path name if have highbit chars. See
+    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+    has_high_char = False
+    for c in dir:
+        if ord(c) > 255:
+            has_high_char = True
+            break
+    if has_high_char:
+        buf = array.zeros('c', buf_size)
+        kernel = win32.Kernel32.INSTANCE
+        if kernel.GetShortPathName(dir, buf, buf_size):
+            dir = jna.Native.toString(buf.tostring()).rstrip("\0")
+
+    return dir
+
+if system == "win32":
+    try:
+        import win32com.shell
+        _get_win_folder = _get_win_folder_with_pywin32
+    except ImportError:
+        try:
+            from ctypes import windll
+            _get_win_folder = _get_win_folder_with_ctypes
+        except ImportError:
+            try:
+                import com.sun.jna
+                _get_win_folder = _get_win_folder_with_jna
+            except ImportError:
+                _get_win_folder = _get_win_folder_from_registry
+
+
+#---- self test code
+
+if __name__ == "__main__":
+    appname = "MyApp"
+    appauthor = "MyCompany"
+
+    props = ("user_data_dir",
+             "user_config_dir",
+             "user_cache_dir",
+             "user_state_dir",
+             "user_log_dir",
+             "site_data_dir",
+             "site_config_dir")
+
+    print("-- app dirs %s --" % __version__)
+
+    print("-- app dirs (with optional 'version')")
+    dirs = AppDirs(appname, appauthor, version="1.0")
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (without optional 'version')")
+    dirs = AppDirs(appname, appauthor)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (without optional 'appauthor')")
+    dirs = AppDirs(appname)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (with disabled 'appauthor')")
+    dirs = AppDirs(appname, appauthor=False)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf329cad5c88580c3e1e89ed9196dd58bdf7fe3b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.py
@@ -0,0 +1,76 @@
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+from functools import partial
+
+from . import converters, exceptions, filters, setters, validators
+from ._config import get_run_validators, set_run_validators
+from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types
+from ._make import (
+    NOTHING,
+    Attribute,
+    Factory,
+    attrib,
+    attrs,
+    fields,
+    fields_dict,
+    make_class,
+    validate,
+)
+from ._version_info import VersionInfo
+
+
+__version__ = "20.3.0"
+__version_info__ = VersionInfo._from_version_string(__version__)
+
+__title__ = "attrs"
+__description__ = "Classes Without Boilerplate"
+__url__ = "https://www.attrs.org/"
+__uri__ = __url__
+__doc__ = __description__ + " <" + __uri__ + ">"
+
+__author__ = "Hynek Schlawack"
+__email__ = "hs@ox.cx"
+
+__license__ = "MIT"
+__copyright__ = "Copyright (c) 2015 Hynek Schlawack"
+
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = partial(attrs, auto_attribs=True)  # happy Easter ;)
+
+__all__ = [
+    "Attribute",
+    "Factory",
+    "NOTHING",
+    "asdict",
+    "assoc",
+    "astuple",
+    "attr",
+    "attrib",
+    "attributes",
+    "attrs",
+    "converters",
+    "evolve",
+    "exceptions",
+    "fields",
+    "fields_dict",
+    "filters",
+    "get_run_validators",
+    "has",
+    "ib",
+    "make_class",
+    "resolve_types",
+    "s",
+    "set_run_validators",
+    "setters",
+    "validate",
+    "validators",
+]
+
+if sys.version_info[:2] >= (3, 6):
+    from ._next_gen import define, field, frozen, mutable
+
+    __all__.extend((define, field, frozen, mutable))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..442d6e77fb840c8bbe5a95339d43ada698cd4eea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/__init__.pyi
@@ -0,0 +1,433 @@
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    List,
+    Optional,
+    Sequence,
+    Mapping,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+# `import X as X` is required to make these public
+from . import exceptions as exceptions
+from . import filters as filters
+from . import converters as converters
+from . import setters as setters
+from . import validators as validators
+
+from ._version_info import VersionInfo
+
+__version__: str
+__version_info__: VersionInfo
+__title__: str
+__description__: str
+__url__: str
+__uri__: str
+__author__: str
+__email__: str
+__license__: str
+__copyright__: str
+
+_T = TypeVar("_T")
+_C = TypeVar("_C", bound=type)
+
+_ValidatorType = Callable[[Any, Attribute[_T], _T], Any]
+_ConverterType = Callable[[Any], Any]
+_FilterType = Callable[[Attribute[_T], _T], bool]
+_ReprType = Callable[[Any], str]
+_ReprArgType = Union[bool, _ReprType]
+_OnSetAttrType = Callable[[Any, Attribute[Any], Any], Any]
+_OnSetAttrArgType = Union[
+    _OnSetAttrType, List[_OnSetAttrType], setters._NoOpType
+]
+_FieldTransformer = Callable[[type, List[Attribute]], List[Attribute]]
+# FIXME: in reality, if multiple validators are passed they must be in a list
+# or tuple, but those are invariant and so would prevent subtypes of
+# _ValidatorType from working when passed in a list or tuple.
+_ValidatorArgType = Union[_ValidatorType[_T], Sequence[_ValidatorType[_T]]]
+
+# _make --
+
+NOTHING: object
+
+# NOTE: Factory lies about its return type to make this possible:
+# `x: List[int] # = Factory(list)`
+# Work around mypy issue #4554 in the common case by using an overload.
+@overload
+def Factory(factory: Callable[[], _T]) -> _T: ...
+@overload
+def Factory(
+    factory: Union[Callable[[Any], _T], Callable[[], _T]],
+    takes_self: bool = ...,
+) -> _T: ...
+
+class Attribute(Generic[_T]):
+    name: str
+    default: Optional[_T]
+    validator: Optional[_ValidatorType[_T]]
+    repr: _ReprArgType
+    cmp: bool
+    eq: bool
+    order: bool
+    hash: Optional[bool]
+    init: bool
+    converter: Optional[_ConverterType]
+    metadata: Dict[Any, Any]
+    type: Optional[Type[_T]]
+    kw_only: bool
+    on_setattr: _OnSetAttrType
+
+# NOTE: We had several choices for the annotation to use for type arg:
+# 1) Type[_T]
+#   - Pros: Handles simple cases correctly
+#   - Cons: Might produce less informative errors in the case of conflicting
+#     TypeVars e.g. `attr.ib(default='bad', type=int)`
+# 2) Callable[..., _T]
+#   - Pros: Better error messages than #1 for conflicting TypeVars
+#   - Cons: Terrible error messages for validator checks.
+#   e.g. attr.ib(type=int, validator=validate_str)
+#        -> error: Cannot infer function type argument
+# 3) type (and do all of the work in the mypy plugin)
+#   - Pros: Simple here, and we could customize the plugin with our own errors.
+#   - Cons: Would need to write mypy plugin code to handle all the cases.
+# We chose option #1.
+
+# `attr` lies about its return type to make the following possible:
+#     attr()    -> Any
+#     attr(8)   -> int
+#     attr(validator=<some callable>)  -> Whatever the callable expects.
+# This makes this type of assignments possible:
+#     x: int = attr(8)
+#
+# This form catches explicit None or no default but with no other arguments
+# returns Any.
+@overload
+def attrib(
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: None = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def attrib(
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def attrib(
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def attrib(
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: object = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def field(
+    *,
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def field(
+    *,
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+@overload
+def attrs(
+    maybe_cls: _C,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> _C: ...
+@overload
+def attrs(
+    maybe_cls: None = ...,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> Callable[[_C], _C]: ...
+@overload
+def define(
+    maybe_cls: _C,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> _C: ...
+@overload
+def define(
+    maybe_cls: None = ...,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> Callable[[_C], _C]: ...
+
+mutable = define
+frozen = define  # they differ only in their defaults
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+class _Fields(Tuple[Attribute[Any], ...]):
+    def __getattr__(self, name: str) -> Attribute[Any]: ...
+
+def fields(cls: type) -> _Fields: ...
+def fields_dict(cls: type) -> Dict[str, Attribute[Any]]: ...
+def validate(inst: Any) -> None: ...
+def resolve_types(
+    cls: _C,
+    globalns: Optional[Dict[str, Any]] = ...,
+    localns: Optional[Dict[str, Any]] = ...,
+) -> _C: ...
+
+# TODO: add support for returning a proper attrs class from the mypy plugin
+# we use Any instead of _CountingAttr so that e.g. `make_class('Foo',
+# [attr.ib()])` is valid
+def make_class(
+    name: str,
+    attrs: Union[List[str], Tuple[str, ...], Dict[str, Any]],
+    bases: Tuple[type, ...] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[bool] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    collect_by_mro: bool = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> type: ...
+
+# _funcs --
+
+# TODO: add support for returning TypedDict from the mypy plugin
+# FIXME: asdict/astuple do not honor their factory args. Waiting on one of
+# these:
+# https://github.com/python/mypy/issues/4236
+# https://github.com/python/typing/issues/253
+def asdict(
+    inst: Any,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    dict_factory: Type[Mapping[Any, Any]] = ...,
+    retain_collection_types: bool = ...,
+    value_serializer: Optional[Callable[[type, Attribute, Any], Any]] = ...,
+) -> Dict[str, Any]: ...
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+def astuple(
+    inst: Any,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    tuple_factory: Type[Sequence[Any]] = ...,
+    retain_collection_types: bool = ...,
+) -> Tuple[Any, ...]: ...
+def has(cls: type) -> bool: ...
+def assoc(inst: _T, **changes: Any) -> _T: ...
+def evolve(inst: _T, **changes: Any) -> _T: ...
+
+# _config --
+
+def set_run_validators(run: bool) -> None: ...
+def get_run_validators() -> bool: ...
+
+# aliases --
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = attrs  # Technically, partial(attrs, auto_attribs=True) ;)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0ead6e1c8d269f3af46910a1f9671d0f7f5b98a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_compat.py
@@ -0,0 +1,231 @@
+from __future__ import absolute_import, division, print_function
+
+import platform
+import sys
+import types
+import warnings
+
+
+PY2 = sys.version_info[0] == 2
+PYPY = platform.python_implementation() == "PyPy"
+
+
+if PYPY or sys.version_info[:2] >= (3, 6):
+    ordered_dict = dict
+else:
+    from collections import OrderedDict
+
+    ordered_dict = OrderedDict
+
+
+if PY2:
+    from collections import Mapping, Sequence
+
+    from UserDict import IterableUserDict
+
+    # We 'bundle' isclass instead of using inspect as importing inspect is
+    # fairly expensive (order of 10-15 ms for a modern machine in 2016)
+    def isclass(klass):
+        return isinstance(klass, (type, types.ClassType))
+
+    # TYPE is used in exceptions, repr(int) is different on Python 2 and 3.
+    TYPE = "type"
+
+    def iteritems(d):
+        return d.iteritems()
+
+    # Python 2 is bereft of a read-only dict proxy, so we make one!
+    class ReadOnlyDict(IterableUserDict):
+        """
+        Best-effort read-only dict wrapper.
+        """
+
+        def __setitem__(self, key, val):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise TypeError(
+                "'mappingproxy' object does not support item assignment"
+            )
+
+        def update(self, _):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'update'"
+            )
+
+        def __delitem__(self, _):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise TypeError(
+                "'mappingproxy' object does not support item deletion"
+            )
+
+        def clear(self):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'clear'"
+            )
+
+        def pop(self, key, default=None):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'pop'"
+            )
+
+        def popitem(self):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'popitem'"
+            )
+
+        def setdefault(self, key, default=None):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'setdefault'"
+            )
+
+        def __repr__(self):
+            # Override to be identical to the Python 3 version.
+            return "mappingproxy(" + repr(self.data) + ")"
+
+    def metadata_proxy(d):
+        res = ReadOnlyDict()
+        res.data.update(d)  # We blocked update, so we have to do it like this.
+        return res
+
+    def just_warn(*args, **kw):  # pragma: no cover
+        """
+        We only warn on Python 3 because we are not aware of any concrete
+        consequences of not setting the cell on Python 2.
+        """
+
+
+else:  # Python 3 and later.
+    from collections.abc import Mapping, Sequence  # noqa
+
+    def just_warn(*args, **kw):
+        """
+        We only warn on Python 3 because we are not aware of any concrete
+        consequences of not setting the cell on Python 2.
+        """
+        warnings.warn(
+            "Running interpreter doesn't sufficiently support code object "
+            "introspection.  Some features like bare super() or accessing "
+            "__class__ will not work with slotted classes.",
+            RuntimeWarning,
+            stacklevel=2,
+        )
+
+    def isclass(klass):
+        return isinstance(klass, type)
+
+    TYPE = "class"
+
+    def iteritems(d):
+        return d.items()
+
+    def metadata_proxy(d):
+        return types.MappingProxyType(dict(d))
+
+
+def make_set_closure_cell():
+    """Return a function of two arguments (cell, value) which sets
+    the value stored in the closure cell `cell` to `value`.
+    """
+    # pypy makes this easy. (It also supports the logic below, but
+    # why not do the easy/fast thing?)
+    if PYPY:
+
+        def set_closure_cell(cell, value):
+            cell.__setstate__((value,))
+
+        return set_closure_cell
+
+    # Otherwise gotta do it the hard way.
+
+    # Create a function that will set its first cellvar to `value`.
+    def set_first_cellvar_to(value):
+        x = value
+        return
+
+        # This function will be eliminated as dead code, but
+        # not before its reference to `x` forces `x` to be
+        # represented as a closure cell rather than a local.
+        def force_x_to_be_a_cell():  # pragma: no cover
+            return x
+
+    try:
+        # Extract the code object and make sure our assumptions about
+        # the closure behavior are correct.
+        if PY2:
+            co = set_first_cellvar_to.func_code
+        else:
+            co = set_first_cellvar_to.__code__
+        if co.co_cellvars != ("x",) or co.co_freevars != ():
+            raise AssertionError  # pragma: no cover
+
+        # Convert this code object to a code object that sets the
+        # function's first _freevar_ (not cellvar) to the argument.
+        if sys.version_info >= (3, 8):
+            # CPython 3.8+ has an incompatible CodeType signature
+            # (added a posonlyargcount argument) but also added
+            # CodeType.replace() to do this without counting parameters.
+            set_first_freevar_code = co.replace(
+                co_cellvars=co.co_freevars, co_freevars=co.co_cellvars
+            )
+        else:
+            args = [co.co_argcount]
+            if not PY2:
+                args.append(co.co_kwonlyargcount)
+            args.extend(
+                [
+                    co.co_nlocals,
+                    co.co_stacksize,
+                    co.co_flags,
+                    co.co_code,
+                    co.co_consts,
+                    co.co_names,
+                    co.co_varnames,
+                    co.co_filename,
+                    co.co_name,
+                    co.co_firstlineno,
+                    co.co_lnotab,
+                    # These two arguments are reversed:
+                    co.co_cellvars,
+                    co.co_freevars,
+                ]
+            )
+            set_first_freevar_code = types.CodeType(*args)
+
+        def set_closure_cell(cell, value):
+            # Create a function using the set_first_freevar_code,
+            # whose first closure cell is `cell`. Calling it will
+            # change the value of that cell.
+            setter = types.FunctionType(
+                set_first_freevar_code, {}, "setter", (), (cell,)
+            )
+            # And call it to set the cell.
+            setter(value)
+
+        # Make sure it works on this interpreter:
+        def make_func_with_cell():
+            x = None
+
+            def func():
+                return x  # pragma: no cover
+
+            return func
+
+        if PY2:
+            cell = make_func_with_cell().func_closure[0]
+        else:
+            cell = make_func_with_cell().__closure__[0]
+        set_closure_cell(cell, 100)
+        if cell.cell_contents != 100:
+            raise AssertionError  # pragma: no cover
+
+    except Exception:
+        return just_warn
+    else:
+        return set_closure_cell
+
+
+set_closure_cell = make_set_closure_cell()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_config.py
new file mode 100644
index 0000000000000000000000000000000000000000..8ec920962d1b401335927db837cc13cca1e99ae8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_config.py
@@ -0,0 +1,23 @@
+from __future__ import absolute_import, division, print_function
+
+
+__all__ = ["set_run_validators", "get_run_validators"]
+
+_run_validators = True
+
+
+def set_run_validators(run):
+    """
+    Set whether or not validators are run.  By default, they are run.
+    """
+    if not isinstance(run, bool):
+        raise TypeError("'run' must be bool.")
+    global _run_validators
+    _run_validators = run
+
+
+def get_run_validators():
+    """
+    Return whether or not validators are run.
+    """
+    return _run_validators
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_funcs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_funcs.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6c930cbd1711caa63014eae133439ad25f32272
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_funcs.py
@@ -0,0 +1,390 @@
+from __future__ import absolute_import, division, print_function
+
+import copy
+
+from ._compat import iteritems
+from ._make import NOTHING, _obj_setattr, fields
+from .exceptions import AttrsAttributeNotFoundError
+
+
+def asdict(
+    inst,
+    recurse=True,
+    filter=None,
+    dict_factory=dict,
+    retain_collection_types=False,
+    value_serializer=None,
+):
+    """
+    Return the ``attrs`` attribute values of *inst* as a dict.
+
+    Optionally recurse into other ``attrs``-decorated classes.
+
+    :param inst: Instance of an ``attrs``-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        ``attrs``-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attr.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable dict_factory: A callable to produce dictionaries from.  For
+        example, to produce ordered dictionaries instead of normal Python
+        dictionaries, pass in ``collections.OrderedDict``.
+    :param bool retain_collection_types: Do not convert to ``list`` when
+        encountering an attribute whose type is ``tuple`` or ``set``.  Only
+        meaningful if ``recurse`` is ``True``.
+    :param Optional[callable] value_serializer: A hook that is called for every
+        attribute or dict key/value.  It receives the current instance, field
+        and value and must return the (updated) value.  The hook is run *after*
+        the optional *filter* has been applied.
+
+    :rtype: return type of *dict_factory*
+
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 16.0.0 *dict_factory*
+    ..  versionadded:: 16.1.0 *retain_collection_types*
+    ..  versionadded:: 20.3.0 *value_serializer*
+    """
+    attrs = fields(inst.__class__)
+    rv = dict_factory()
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+
+        if value_serializer is not None:
+            v = value_serializer(inst, a, v)
+
+        if recurse is True:
+            if has(v.__class__):
+                rv[a.name] = asdict(
+                    v,
+                    True,
+                    filter,
+                    dict_factory,
+                    retain_collection_types,
+                    value_serializer,
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain_collection_types is True else list
+                rv[a.name] = cf(
+                    [
+                        _asdict_anything(
+                            i,
+                            filter,
+                            dict_factory,
+                            retain_collection_types,
+                            value_serializer,
+                        )
+                        for i in v
+                    ]
+                )
+            elif isinstance(v, dict):
+                df = dict_factory
+                rv[a.name] = df(
+                    (
+                        _asdict_anything(
+                            kk,
+                            filter,
+                            df,
+                            retain_collection_types,
+                            value_serializer,
+                        ),
+                        _asdict_anything(
+                            vv,
+                            filter,
+                            df,
+                            retain_collection_types,
+                            value_serializer,
+                        ),
+                    )
+                    for kk, vv in iteritems(v)
+                )
+            else:
+                rv[a.name] = v
+        else:
+            rv[a.name] = v
+    return rv
+
+
+def _asdict_anything(
+    val,
+    filter,
+    dict_factory,
+    retain_collection_types,
+    value_serializer,
+):
+    """
+    ``asdict`` only works on attrs instances, this works on anything.
+    """
+    if getattr(val.__class__, "__attrs_attrs__", None) is not None:
+        # Attrs class.
+        rv = asdict(
+            val,
+            True,
+            filter,
+            dict_factory,
+            retain_collection_types,
+            value_serializer,
+        )
+    elif isinstance(val, (tuple, list, set, frozenset)):
+        cf = val.__class__ if retain_collection_types is True else list
+        rv = cf(
+            [
+                _asdict_anything(
+                    i,
+                    filter,
+                    dict_factory,
+                    retain_collection_types,
+                    value_serializer,
+                )
+                for i in val
+            ]
+        )
+    elif isinstance(val, dict):
+        df = dict_factory
+        rv = df(
+            (
+                _asdict_anything(
+                    kk, filter, df, retain_collection_types, value_serializer
+                ),
+                _asdict_anything(
+                    vv, filter, df, retain_collection_types, value_serializer
+                ),
+            )
+            for kk, vv in iteritems(val)
+        )
+    else:
+        rv = val
+        if value_serializer is not None:
+            rv = value_serializer(None, None, rv)
+
+    return rv
+
+
+def astuple(
+    inst,
+    recurse=True,
+    filter=None,
+    tuple_factory=tuple,
+    retain_collection_types=False,
+):
+    """
+    Return the ``attrs`` attribute values of *inst* as a tuple.
+
+    Optionally recurse into other ``attrs``-decorated classes.
+
+    :param inst: Instance of an ``attrs``-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        ``attrs``-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attr.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable tuple_factory: A callable to produce tuples from.  For
+        example, to produce lists instead of tuples.
+    :param bool retain_collection_types: Do not convert to ``list``
+        or ``dict`` when encountering an attribute which type is
+        ``tuple``, ``dict`` or ``set``.  Only meaningful if ``recurse`` is
+        ``True``.
+
+    :rtype: return type of *tuple_factory*
+
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 16.2.0
+    """
+    attrs = fields(inst.__class__)
+    rv = []
+    retain = retain_collection_types  # Very long. :/
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+        if recurse is True:
+            if has(v.__class__):
+                rv.append(
+                    astuple(
+                        v,
+                        recurse=True,
+                        filter=filter,
+                        tuple_factory=tuple_factory,
+                        retain_collection_types=retain,
+                    )
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain is True else list
+                rv.append(
+                    cf(
+                        [
+                            astuple(
+                                j,
+                                recurse=True,
+                                filter=filter,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(j.__class__)
+                            else j
+                            for j in v
+                        ]
+                    )
+                )
+            elif isinstance(v, dict):
+                df = v.__class__ if retain is True else dict
+                rv.append(
+                    df(
+                        (
+                            astuple(
+                                kk,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(kk.__class__)
+                            else kk,
+                            astuple(
+                                vv,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(vv.__class__)
+                            else vv,
+                        )
+                        for kk, vv in iteritems(v)
+                    )
+                )
+            else:
+                rv.append(v)
+        else:
+            rv.append(v)
+
+    return rv if tuple_factory is list else tuple_factory(rv)
+
+
+def has(cls):
+    """
+    Check whether *cls* is a class with ``attrs`` attributes.
+
+    :param type cls: Class to introspect.
+    :raise TypeError: If *cls* is not a class.
+
+    :rtype: bool
+    """
+    return getattr(cls, "__attrs_attrs__", None) is not None
+
+
+def assoc(inst, **changes):
+    """
+    Copy *inst* and apply *changes*.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise attr.exceptions.AttrsAttributeNotFoundError: If *attr_name* couldn't
+        be found on *cls*.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  deprecated:: 17.1.0
+        Use `evolve` instead.
+    """
+    import warnings
+
+    warnings.warn(
+        "assoc is deprecated and will be removed after 2018/01.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    new = copy.copy(inst)
+    attrs = fields(inst.__class__)
+    for k, v in iteritems(changes):
+        a = getattr(attrs, k, NOTHING)
+        if a is NOTHING:
+            raise AttrsAttributeNotFoundError(
+                "{k} is not an attrs attribute on {cl}.".format(
+                    k=k, cl=new.__class__
+                )
+            )
+        _obj_setattr(new, k, v)
+    return new
+
+
+def evolve(inst, **changes):
+    """
+    Create a new instance, based on *inst* with *changes* applied.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise TypeError: If *attr_name* couldn't be found in the class
+        ``__init__``.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 17.1.0
+    """
+    cls = inst.__class__
+    attrs = fields(cls)
+    for a in attrs:
+        if not a.init:
+            continue
+        attr_name = a.name  # To deal with private attributes.
+        init_name = attr_name if attr_name[0] != "_" else attr_name[1:]
+        if init_name not in changes:
+            changes[init_name] = getattr(inst, attr_name)
+
+    return cls(**changes)
+
+
+def resolve_types(cls, globalns=None, localns=None):
+    """
+    Resolve any strings and forward annotations in type annotations.
+
+    This is only required if you need concrete types in `Attribute`'s *type*
+    field. In other words, you don't need to resolve your types if you only
+    use them for static type checking.
+
+    With no arguments, names will be looked up in the module in which the class
+    was created. If this is not what you want, e.g. if the name only exists
+    inside a method, you may pass *globalns* or *localns* to specify other
+    dictionaries in which to look up these names. See the docs of
+    `typing.get_type_hints` for more details.
+
+    :param type cls: Class to resolve.
+    :param Optional[dict] globalns: Dictionary containing global variables.
+    :param Optional[dict] localns: Dictionary containing local variables.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+    :raise NameError: If types cannot be resolved because of missing variables.
+
+    :returns: *cls* so you can use this function also as a class decorator.
+        Please note that you have to apply it **after** `attr.s`. That means
+        the decorator has to come in the line **before** `attr.s`.
+
+    ..  versionadded:: 20.1.0
+    """
+    try:
+        # Since calling get_type_hints is expensive we cache whether we've
+        # done it already.
+        cls.__attrs_types_resolved__
+    except AttributeError:
+        import typing
+
+        hints = typing.get_type_hints(cls, globalns=globalns, localns=localns)
+        for field in fields(cls):
+            if field.name in hints:
+                # Since fields have been frozen we must work around it.
+                _obj_setattr(field, "type", hints[field.name])
+        cls.__attrs_types_resolved__ = True
+
+    # Return the class so you can use it as a decorator too.
+    return cls
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_make.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_make.py
new file mode 100644
index 0000000000000000000000000000000000000000..49484f935f6929e2d070cc1149ecdd70c4f6a83e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_make.py
@@ -0,0 +1,2765 @@
+from __future__ import absolute_import, division, print_function
+
+import copy
+import linecache
+import sys
+import threading
+import uuid
+import warnings
+
+from operator import itemgetter
+
+from . import _config, setters
+from ._compat import (
+    PY2,
+    PYPY,
+    isclass,
+    iteritems,
+    metadata_proxy,
+    ordered_dict,
+    set_closure_cell,
+)
+from .exceptions import (
+    DefaultAlreadySetError,
+    FrozenInstanceError,
+    NotAnAttrsClassError,
+    PythonTooOldError,
+    UnannotatedAttributeError,
+)
+
+
+# This is used at least twice, so cache it here.
+_obj_setattr = object.__setattr__
+_init_converter_pat = "__attr_converter_%s"
+_init_factory_pat = "__attr_factory_{}"
+_tuple_property_pat = (
+    "    {attr_name} = _attrs_property(_attrs_itemgetter({index}))"
+)
+_classvar_prefixes = ("typing.ClassVar", "t.ClassVar", "ClassVar")
+# we don't use a double-underscore prefix because that triggers
+# name mangling when trying to create a slot for the field
+# (when slots=True)
+_hash_cache_field = "_attrs_cached_hash"
+
+_empty_metadata_singleton = metadata_proxy({})
+
+# Unique object for unequivocal getattr() defaults.
+_sentinel = object()
+
+
+class _Nothing(object):
+    """
+    Sentinel class to indicate the lack of a value when ``None`` is ambiguous.
+
+    ``_Nothing`` is a singleton. There is only ever one of it.
+    """
+
+    _singleton = None
+
+    def __new__(cls):
+        if _Nothing._singleton is None:
+            _Nothing._singleton = super(_Nothing, cls).__new__(cls)
+        return _Nothing._singleton
+
+    def __repr__(self):
+        return "NOTHING"
+
+
+NOTHING = _Nothing()
+"""
+Sentinel to indicate the lack of a value when ``None`` is ambiguous.
+"""
+
+
+class _CacheHashWrapper(int):
+    """
+    An integer subclass that pickles / copies as None
+
+    This is used for non-slots classes with ``cache_hash=True``, to avoid
+    serializing a potentially (even likely) invalid hash value. Since ``None``
+    is the default value for uncalculated hashes, whenever this is copied,
+    the copy's value for the hash should automatically reset.
+
+    See GH #613 for more details.
+    """
+
+    if PY2:
+        # For some reason `type(None)` isn't callable in Python 2, but we don't
+        # actually need a constructor for None objects, we just need any
+        # available function that returns None.
+        def __reduce__(self, _none_constructor=getattr, _args=(0, "", None)):
+            return _none_constructor, _args
+
+    else:
+
+        def __reduce__(self, _none_constructor=type(None), _args=()):
+            return _none_constructor, _args
+
+
+def attrib(
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    cmp=None,
+    hash=None,
+    init=True,
+    metadata=None,
+    type=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+):
+    """
+    Create a new attribute on a class.
+
+    ..  warning::
+
+        Does *not* do anything unless the class is also decorated with
+        `attr.s`!
+
+    :param default: A value that is used if an ``attrs``-generated ``__init__``
+        is used and no value is passed while instantiating or the attribute is
+        excluded using ``init=False``.
+
+        If the value is an instance of `Factory`, its callable will be
+        used to construct a new value (useful for mutable data types like lists
+        or dicts).
+
+        If a default is not set (or set manually to `attr.NOTHING`), a value
+        *must* be supplied when instantiating; otherwise a `TypeError`
+        will be raised.
+
+        The default can also be set using decorator notation as shown below.
+
+    :type default: Any value
+
+    :param callable factory: Syntactic sugar for
+        ``default=attr.Factory(factory)``.
+
+    :param validator: `callable` that is called by ``attrs``-generated
+        ``__init__`` methods after the instance has been initialized.  They
+        receive the initialized instance, the `Attribute`, and the
+        passed value.
+
+        The return value is *not* inspected so the validator has to throw an
+        exception itself.
+
+        If a `list` is passed, its items are treated as validators and must
+        all pass.
+
+        Validators can be globally disabled and re-enabled using
+        `get_run_validators`.
+
+        The validator can also be set using decorator notation as shown below.
+
+    :type validator: `callable` or a `list` of `callable`\\ s.
+
+    :param repr: Include this attribute in the generated ``__repr__``
+        method. If ``True``, include the attribute; if ``False``, omit it. By
+        default, the built-in ``repr()`` function is used. To override how the
+        attribute value is formatted, pass a ``callable`` that takes a single
+        value and returns a string. Note that the resulting string is used
+        as-is, i.e. it will be used directly *instead* of calling ``repr()``
+        (the default).
+    :type repr: a `bool` or a `callable` to use a custom function.
+    :param bool eq: If ``True`` (default), include this attribute in the
+        generated ``__eq__`` and ``__ne__`` methods that check two instances
+        for equality.
+    :param bool order: If ``True`` (default), include this attributes in the
+        generated ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods.
+    :param bool cmp: Setting to ``True`` is equivalent to setting ``eq=True,
+        order=True``. Deprecated in favor of *eq* and *order*.
+    :param Optional[bool] hash: Include this attribute in the generated
+        ``__hash__`` method.  If ``None`` (default), mirror *eq*'s value.  This
+        is the correct behavior according the Python spec.  Setting this value
+        to anything else than ``None`` is *discouraged*.
+    :param bool init: Include this attribute in the generated ``__init__``
+        method.  It is possible to set this to ``False`` and set a default
+        value.  In that case this attributed is unconditionally initialized
+        with the specified default value or factory.
+    :param callable converter: `callable` that is called by
+        ``attrs``-generated ``__init__`` methods to convert attribute's value
+        to the desired format.  It is given the passed-in value, and the
+        returned value will be used as the new value of the attribute.  The
+        value is converted before being passed to the validator, if any.
+    :param metadata: An arbitrary mapping, to be used by third-party
+        components.  See `extending_metadata`.
+    :param type: The type of the attribute.  In Python 3.6 or greater, the
+        preferred method to specify the type is using a variable annotation
+        (see `PEP 526 <https://www.python.org/dev/peps/pep-0526/>`_).
+        This argument is provided for backward compatibility.
+        Regardless of the approach used, the type will be stored on
+        ``Attribute.type``.
+
+        Please note that ``attrs`` doesn't do anything with this metadata by
+        itself. You can use it as part of your own code or for
+        `static type checking <types>`.
+    :param kw_only: Make this attribute keyword-only (Python 3+)
+        in the generated ``__init__`` (if ``init`` is ``False``, this
+        parameter is ignored).
+    :param on_setattr: Allows to overwrite the *on_setattr* setting from
+        `attr.s`. If left `None`, the *on_setattr* value from `attr.s` is used.
+        Set to `attr.setters.NO_OP` to run **no** `setattr` hooks for this
+        attribute -- regardless of the setting in `attr.s`.
+    :type on_setattr: `callable`, or a list of callables, or `None`, or
+        `attr.setters.NO_OP`
+
+    .. versionadded:: 15.2.0 *convert*
+    .. versionadded:: 16.3.0 *metadata*
+    .. versionchanged:: 17.1.0 *validator* can be a ``list`` now.
+    .. versionchanged:: 17.1.0
+       *hash* is ``None`` and therefore mirrors *eq* by default.
+    .. versionadded:: 17.3.0 *type*
+    .. deprecated:: 17.4.0 *convert*
+    .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated
+       *convert* to achieve consistency with other noun-based arguments.
+    .. versionadded:: 18.1.0
+       ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionchanged:: 19.2.0 *convert* keyword argument removed
+    .. versionchanged:: 19.2.0 *repr* also accepts a custom callable.
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.3.0 *kw_only* backported to Python 2
+    """
+    eq, order = _determine_eq_order(cmp, eq, order, True)
+
+    if hash is not None and hash is not True and hash is not False:
+        raise TypeError(
+            "Invalid value for hash.  Must be True, False, or None."
+        )
+
+    if factory is not None:
+        if default is not NOTHING:
+            raise ValueError(
+                "The `default` and `factory` arguments are mutually "
+                "exclusive."
+            )
+        if not callable(factory):
+            raise ValueError("The `factory` argument must be a callable.")
+        default = Factory(factory)
+
+    if metadata is None:
+        metadata = {}
+
+    # Apply syntactic sugar by auto-wrapping.
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    if validator and isinstance(validator, (list, tuple)):
+        validator = and_(*validator)
+
+    if converter and isinstance(converter, (list, tuple)):
+        converter = pipe(*converter)
+
+    return _CountingAttr(
+        default=default,
+        validator=validator,
+        repr=repr,
+        cmp=None,
+        hash=hash,
+        init=init,
+        converter=converter,
+        metadata=metadata,
+        type=type,
+        kw_only=kw_only,
+        eq=eq,
+        order=order,
+        on_setattr=on_setattr,
+    )
+
+
+def _make_attr_tuple_class(cls_name, attr_names):
+    """
+    Create a tuple subclass to hold `Attribute`s for an `attrs` class.
+
+    The subclass is a bare tuple with properties for names.
+
+    class MyClassAttributes(tuple):
+        __slots__ = ()
+        x = property(itemgetter(0))
+    """
+    attr_class_name = "{}Attributes".format(cls_name)
+    attr_class_template = [
+        "class {}(tuple):".format(attr_class_name),
+        "    __slots__ = ()",
+    ]
+    if attr_names:
+        for i, attr_name in enumerate(attr_names):
+            attr_class_template.append(
+                _tuple_property_pat.format(index=i, attr_name=attr_name)
+            )
+    else:
+        attr_class_template.append("    pass")
+    globs = {"_attrs_itemgetter": itemgetter, "_attrs_property": property}
+    eval(compile("\n".join(attr_class_template), "", "exec"), globs)
+
+    return globs[attr_class_name]
+
+
+# Tuple class for extracted attributes from a class definition.
+# `base_attrs` is a subset of `attrs`.
+_Attributes = _make_attr_tuple_class(
+    "_Attributes",
+    [
+        # all attributes to build dunder methods for
+        "attrs",
+        # attributes that have been inherited
+        "base_attrs",
+        # map inherited attributes to their originating classes
+        "base_attrs_map",
+    ],
+)
+
+
+def _is_class_var(annot):
+    """
+    Check whether *annot* is a typing.ClassVar.
+
+    The string comparison hack is used to avoid evaluating all string
+    annotations which would put attrs-based classes at a performance
+    disadvantage compared to plain old classes.
+    """
+    return str(annot).startswith(_classvar_prefixes)
+
+
+def _has_own_attribute(cls, attrib_name):
+    """
+    Check whether *cls* defines *attrib_name* (and doesn't just inherit it).
+
+    Requires Python 3.
+    """
+    attr = getattr(cls, attrib_name, _sentinel)
+    if attr is _sentinel:
+        return False
+
+    for base_cls in cls.__mro__[1:]:
+        a = getattr(base_cls, attrib_name, None)
+        if attr is a:
+            return False
+
+    return True
+
+
+def _get_annotations(cls):
+    """
+    Get annotations for *cls*.
+    """
+    if _has_own_attribute(cls, "__annotations__"):
+        return cls.__annotations__
+
+    return {}
+
+
+def _counter_getter(e):
+    """
+    Key function for sorting to avoid re-creating a lambda for every class.
+    """
+    return e[1].counter
+
+
+def _collect_base_attrs(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in reversed(cls.__mro__[1:-1]):
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.inherited or a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    # For each name, only keep the freshest definition i.e. the furthest at the
+    # back.  base_attr_map is fine because it gets overwritten with every new
+    # instance.
+    filtered = []
+    seen = set()
+    for a in reversed(base_attrs):
+        if a.name in seen:
+            continue
+        filtered.insert(0, a)
+        seen.add(a.name)
+
+    return filtered, base_attr_map
+
+
+def _collect_base_attrs_broken(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+
+    N.B. *taken_attr_names* will be mutated.
+
+    Adhere to the old incorrect behavior.
+
+    Notably it collects from the front and considers inherited attributes which
+    leads to the buggy behavior reported in #428.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in cls.__mro__[1:-1]:
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)
+            taken_attr_names.add(a.name)
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    return base_attrs, base_attr_map
+
+
+def _transform_attrs(
+    cls, these, auto_attribs, kw_only, collect_by_mro, field_transformer
+):
+    """
+    Transform all `_CountingAttr`s on a class into `Attribute`s.
+
+    If *these* is passed, use that and don't look for them on the class.
+
+    *collect_by_mro* is True, collect them in the correct MRO order, otherwise
+    use the old -- incorrect -- order.  See #428.
+
+    Return an `_Attributes`.
+    """
+    cd = cls.__dict__
+    anns = _get_annotations(cls)
+
+    if these is not None:
+        ca_list = [(name, ca) for name, ca in iteritems(these)]
+
+        if not isinstance(these, ordered_dict):
+            ca_list.sort(key=_counter_getter)
+    elif auto_attribs is True:
+        ca_names = {
+            name
+            for name, attr in cd.items()
+            if isinstance(attr, _CountingAttr)
+        }
+        ca_list = []
+        annot_names = set()
+        for attr_name, type in anns.items():
+            if _is_class_var(type):
+                continue
+            annot_names.add(attr_name)
+            a = cd.get(attr_name, NOTHING)
+
+            if not isinstance(a, _CountingAttr):
+                if a is NOTHING:
+                    a = attrib()
+                else:
+                    a = attrib(default=a)
+            ca_list.append((attr_name, a))
+
+        unannotated = ca_names - annot_names
+        if len(unannotated) > 0:
+            raise UnannotatedAttributeError(
+                "The following `attr.ib`s lack a type annotation: "
+                + ", ".join(
+                    sorted(unannotated, key=lambda n: cd.get(n).counter)
+                )
+                + "."
+            )
+    else:
+        ca_list = sorted(
+            (
+                (name, attr)
+                for name, attr in cd.items()
+                if isinstance(attr, _CountingAttr)
+            ),
+            key=lambda e: e[1].counter,
+        )
+
+    own_attrs = [
+        Attribute.from_counting_attr(
+            name=attr_name, ca=ca, type=anns.get(attr_name)
+        )
+        for attr_name, ca in ca_list
+    ]
+
+    if collect_by_mro:
+        base_attrs, base_attr_map = _collect_base_attrs(
+            cls, {a.name for a in own_attrs}
+        )
+    else:
+        base_attrs, base_attr_map = _collect_base_attrs_broken(
+            cls, {a.name for a in own_attrs}
+        )
+
+    attr_names = [a.name for a in base_attrs + own_attrs]
+
+    AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names)
+
+    if kw_only:
+        own_attrs = [a.evolve(kw_only=True) for a in own_attrs]
+        base_attrs = [a.evolve(kw_only=True) for a in base_attrs]
+
+    attrs = AttrsClass(base_attrs + own_attrs)
+
+    # Mandatory vs non-mandatory attr order only matters when they are part of
+    # the __init__ signature and when they aren't kw_only (which are moved to
+    # the end and can be mandatory or non-mandatory in any order, as they will
+    # be specified as keyword args anyway). Check the order of those attrs:
+    had_default = False
+    for a in (a for a in attrs if a.init is not False and a.kw_only is False):
+        if had_default is True and a.default is NOTHING:
+            raise ValueError(
+                "No mandatory attributes allowed after an attribute with a "
+                "default value or factory.  Attribute in question: %r" % (a,)
+            )
+
+        if had_default is False and a.default is not NOTHING:
+            had_default = True
+
+    if field_transformer is not None:
+        attrs = field_transformer(cls, attrs)
+    return _Attributes((attrs, base_attrs, base_attr_map))
+
+
+if PYPY:
+
+    def _frozen_setattrs(self, name, value):
+        """
+        Attached to frozen classes as __setattr__.
+        """
+        if isinstance(self, BaseException) and name in (
+            "__cause__",
+            "__context__",
+        ):
+            BaseException.__setattr__(self, name, value)
+            return
+
+        raise FrozenInstanceError()
+
+
+else:
+
+    def _frozen_setattrs(self, name, value):
+        """
+        Attached to frozen classes as __setattr__.
+        """
+        raise FrozenInstanceError()
+
+
+def _frozen_delattrs(self, name):
+    """
+    Attached to frozen classes as __delattr__.
+    """
+    raise FrozenInstanceError()
+
+
+class _ClassBuilder(object):
+    """
+    Iteratively build *one* class.
+    """
+
+    __slots__ = (
+        "_attr_names",
+        "_attrs",
+        "_base_attr_map",
+        "_base_names",
+        "_cache_hash",
+        "_cls",
+        "_cls_dict",
+        "_delete_attribs",
+        "_frozen",
+        "_has_post_init",
+        "_is_exc",
+        "_on_setattr",
+        "_slots",
+        "_weakref_slot",
+        "_has_own_setattr",
+        "_has_custom_setattr",
+    )
+
+    def __init__(
+        self,
+        cls,
+        these,
+        slots,
+        frozen,
+        weakref_slot,
+        getstate_setstate,
+        auto_attribs,
+        kw_only,
+        cache_hash,
+        is_exc,
+        collect_by_mro,
+        on_setattr,
+        has_custom_setattr,
+        field_transformer,
+    ):
+        attrs, base_attrs, base_map = _transform_attrs(
+            cls,
+            these,
+            auto_attribs,
+            kw_only,
+            collect_by_mro,
+            field_transformer,
+        )
+
+        self._cls = cls
+        self._cls_dict = dict(cls.__dict__) if slots else {}
+        self._attrs = attrs
+        self._base_names = set(a.name for a in base_attrs)
+        self._base_attr_map = base_map
+        self._attr_names = tuple(a.name for a in attrs)
+        self._slots = slots
+        self._frozen = frozen
+        self._weakref_slot = weakref_slot
+        self._cache_hash = cache_hash
+        self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False))
+        self._delete_attribs = not bool(these)
+        self._is_exc = is_exc
+        self._on_setattr = on_setattr
+
+        self._has_custom_setattr = has_custom_setattr
+        self._has_own_setattr = False
+
+        self._cls_dict["__attrs_attrs__"] = self._attrs
+
+        if frozen:
+            self._cls_dict["__setattr__"] = _frozen_setattrs
+            self._cls_dict["__delattr__"] = _frozen_delattrs
+
+            self._has_own_setattr = True
+
+        if getstate_setstate:
+            (
+                self._cls_dict["__getstate__"],
+                self._cls_dict["__setstate__"],
+            ) = self._make_getstate_setstate()
+
+    def __repr__(self):
+        return "<_ClassBuilder(cls={cls})>".format(cls=self._cls.__name__)
+
+    def build_class(self):
+        """
+        Finalize class based on the accumulated configuration.
+
+        Builder cannot be used after calling this method.
+        """
+        if self._slots is True:
+            return self._create_slots_class()
+        else:
+            return self._patch_original_class()
+
+    def _patch_original_class(self):
+        """
+        Apply accumulated methods and return the class.
+        """
+        cls = self._cls
+        base_names = self._base_names
+
+        # Clean class of attribute definitions (`attr.ib()`s).
+        if self._delete_attribs:
+            for name in self._attr_names:
+                if (
+                    name not in base_names
+                    and getattr(cls, name, _sentinel) is not _sentinel
+                ):
+                    try:
+                        delattr(cls, name)
+                    except AttributeError:
+                        # This can happen if a base class defines a class
+                        # variable and we want to set an attribute with the
+                        # same name by using only a type annotation.
+                        pass
+
+        # Attach our dunder methods.
+        for name, value in self._cls_dict.items():
+            setattr(cls, name, value)
+
+        # If we've inherited an attrs __setattr__ and don't write our own,
+        # reset it to object's.
+        if not self._has_own_setattr and getattr(
+            cls, "__attrs_own_setattr__", False
+        ):
+            cls.__attrs_own_setattr__ = False
+
+            if not self._has_custom_setattr:
+                cls.__setattr__ = object.__setattr__
+
+        return cls
+
+    def _create_slots_class(self):
+        """
+        Build and return a new class with a `__slots__` attribute.
+        """
+        base_names = self._base_names
+        cd = {
+            k: v
+            for k, v in iteritems(self._cls_dict)
+            if k not in tuple(self._attr_names) + ("__dict__", "__weakref__")
+        }
+
+        # If our class doesn't have its own implementation of __setattr__
+        # (either from the user or by us), check the bases, if one of them has
+        # an attrs-made __setattr__, that needs to be reset. We don't walk the
+        # MRO because we only care about our immediate base classes.
+        # XXX: This can be confused by subclassing a slotted attrs class with
+        # XXX: a non-attrs class and subclass the resulting class with an attrs
+        # XXX: class.  See `test_slotted_confused` for details.  For now that's
+        # XXX: OK with us.
+        if not self._has_own_setattr:
+            cd["__attrs_own_setattr__"] = False
+
+            if not self._has_custom_setattr:
+                for base_cls in self._cls.__bases__:
+                    if base_cls.__dict__.get("__attrs_own_setattr__", False):
+                        cd["__setattr__"] = object.__setattr__
+                        break
+
+        # Traverse the MRO to check for an existing __weakref__.
+        weakref_inherited = False
+        for base_cls in self._cls.__mro__[1:-1]:
+            if base_cls.__dict__.get("__weakref__", None) is not None:
+                weakref_inherited = True
+                break
+
+        names = self._attr_names
+        if (
+            self._weakref_slot
+            and "__weakref__" not in getattr(self._cls, "__slots__", ())
+            and "__weakref__" not in names
+            and not weakref_inherited
+        ):
+            names += ("__weakref__",)
+
+        # We only add the names of attributes that aren't inherited.
+        # Setting __slots__ to inherited attributes wastes memory.
+        slot_names = [name for name in names if name not in base_names]
+        if self._cache_hash:
+            slot_names.append(_hash_cache_field)
+        cd["__slots__"] = tuple(slot_names)
+
+        qualname = getattr(self._cls, "__qualname__", None)
+        if qualname is not None:
+            cd["__qualname__"] = qualname
+
+        # Create new class based on old class and our methods.
+        cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd)
+
+        # The following is a fix for
+        # https://github.com/python-attrs/attrs/issues/102.  On Python 3,
+        # if a method mentions `__class__` or uses the no-arg super(), the
+        # compiler will bake a reference to the class in the method itself
+        # as `method.__closure__`.  Since we replace the class with a
+        # clone, we rewrite these references so it keeps working.
+        for item in cls.__dict__.values():
+            if isinstance(item, (classmethod, staticmethod)):
+                # Class- and staticmethods hide their functions inside.
+                # These might need to be rewritten as well.
+                closure_cells = getattr(item.__func__, "__closure__", None)
+            else:
+                closure_cells = getattr(item, "__closure__", None)
+
+            if not closure_cells:  # Catch None or the empty list.
+                continue
+            for cell in closure_cells:
+                try:
+                    match = cell.cell_contents is self._cls
+                except ValueError:  # ValueError: Cell is empty
+                    pass
+                else:
+                    if match:
+                        set_closure_cell(cell, cls)
+
+        return cls
+
+    def add_repr(self, ns):
+        self._cls_dict["__repr__"] = self._add_method_dunders(
+            _make_repr(self._attrs, ns=ns)
+        )
+        return self
+
+    def add_str(self):
+        repr = self._cls_dict.get("__repr__")
+        if repr is None:
+            raise ValueError(
+                "__str__ can only be generated if a __repr__ exists."
+            )
+
+        def __str__(self):
+            return self.__repr__()
+
+        self._cls_dict["__str__"] = self._add_method_dunders(__str__)
+        return self
+
+    def _make_getstate_setstate(self):
+        """
+        Create custom __setstate__ and __getstate__ methods.
+        """
+        # __weakref__ is not writable.
+        state_attr_names = tuple(
+            an for an in self._attr_names if an != "__weakref__"
+        )
+
+        def slots_getstate(self):
+            """
+            Automatically created by attrs.
+            """
+            return tuple(getattr(self, name) for name in state_attr_names)
+
+        hash_caching_enabled = self._cache_hash
+
+        def slots_setstate(self, state):
+            """
+            Automatically created by attrs.
+            """
+            __bound_setattr = _obj_setattr.__get__(self, Attribute)
+            for name, value in zip(state_attr_names, state):
+                __bound_setattr(name, value)
+
+            # The hash code cache is not included when the object is
+            # serialized, but it still needs to be initialized to None to
+            # indicate that the first call to __hash__ should be a cache
+            # miss.
+            if hash_caching_enabled:
+                __bound_setattr(_hash_cache_field, None)
+
+        return slots_getstate, slots_setstate
+
+    def make_unhashable(self):
+        self._cls_dict["__hash__"] = None
+        return self
+
+    def add_hash(self):
+        self._cls_dict["__hash__"] = self._add_method_dunders(
+            _make_hash(
+                self._cls,
+                self._attrs,
+                frozen=self._frozen,
+                cache_hash=self._cache_hash,
+            )
+        )
+
+        return self
+
+    def add_init(self):
+        self._cls_dict["__init__"] = self._add_method_dunders(
+            _make_init(
+                self._cls,
+                self._attrs,
+                self._has_post_init,
+                self._frozen,
+                self._slots,
+                self._cache_hash,
+                self._base_attr_map,
+                self._is_exc,
+                self._on_setattr is not None
+                and self._on_setattr is not setters.NO_OP,
+            )
+        )
+
+        return self
+
+    def add_eq(self):
+        cd = self._cls_dict
+
+        cd["__eq__"] = self._add_method_dunders(
+            _make_eq(self._cls, self._attrs)
+        )
+        cd["__ne__"] = self._add_method_dunders(_make_ne())
+
+        return self
+
+    def add_order(self):
+        cd = self._cls_dict
+
+        cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = (
+            self._add_method_dunders(meth)
+            for meth in _make_order(self._cls, self._attrs)
+        )
+
+        return self
+
+    def add_setattr(self):
+        if self._frozen:
+            return self
+
+        sa_attrs = {}
+        for a in self._attrs:
+            on_setattr = a.on_setattr or self._on_setattr
+            if on_setattr and on_setattr is not setters.NO_OP:
+                sa_attrs[a.name] = a, on_setattr
+
+        if not sa_attrs:
+            return self
+
+        if self._has_custom_setattr:
+            # We need to write a __setattr__ but there already is one!
+            raise ValueError(
+                "Can't combine custom __setattr__ with on_setattr hooks."
+            )
+
+        # docstring comes from _add_method_dunders
+        def __setattr__(self, name, val):
+            try:
+                a, hook = sa_attrs[name]
+            except KeyError:
+                nval = val
+            else:
+                nval = hook(self, a, val)
+
+            _obj_setattr(self, name, nval)
+
+        self._cls_dict["__attrs_own_setattr__"] = True
+        self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__)
+        self._has_own_setattr = True
+
+        return self
+
+    def _add_method_dunders(self, method):
+        """
+        Add __module__ and __qualname__ to a *method* if possible.
+        """
+        try:
+            method.__module__ = self._cls.__module__
+        except AttributeError:
+            pass
+
+        try:
+            method.__qualname__ = ".".join(
+                (self._cls.__qualname__, method.__name__)
+            )
+        except AttributeError:
+            pass
+
+        try:
+            method.__doc__ = "Method generated by attrs for class %s." % (
+                self._cls.__qualname__,
+            )
+        except AttributeError:
+            pass
+
+        return method
+
+
+_CMP_DEPRECATION = (
+    "The usage of `cmp` is deprecated and will be removed on or after "
+    "2021-06-01.  Please use `eq` and `order` instead."
+)
+
+
+def _determine_eq_order(cmp, eq, order, default_eq):
+    """
+    Validate the combination of *cmp*, *eq*, and *order*. Derive the effective
+    values of eq and order.  If *eq* is None, set it to *default_eq*.
+    """
+    if cmp is not None and any((eq is not None, order is not None)):
+        raise ValueError("Don't mix `cmp` with `eq' and `order`.")
+
+    # cmp takes precedence due to bw-compatibility.
+    if cmp is not None:
+        warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=3)
+
+        return cmp, cmp
+
+    # If left None, equality is set to the specified default and ordering
+    # mirrors equality.
+    if eq is None:
+        eq = default_eq
+
+    if order is None:
+        order = eq
+
+    if eq is False and order is True:
+        raise ValueError("`order` can only be True if `eq` is True too.")
+
+    return eq, order
+
+
+def _determine_whether_to_implement(
+    cls, flag, auto_detect, dunders, default=True
+):
+    """
+    Check whether we should implement a set of methods for *cls*.
+
+    *flag* is the argument passed into @attr.s like 'init', *auto_detect* the
+    same as passed into @attr.s and *dunders* is a tuple of attribute names
+    whose presence signal that the user has implemented it themselves.
+
+    Return *default* if no reason for either for or against is found.
+
+    auto_detect must be False on Python 2.
+    """
+    if flag is True or flag is False:
+        return flag
+
+    if flag is None and auto_detect is False:
+        return default
+
+    # Logically, flag is None and auto_detect is True here.
+    for dunder in dunders:
+        if _has_own_attribute(cls, dunder):
+            return False
+
+    return default
+
+
+def attrs(
+    maybe_cls=None,
+    these=None,
+    repr_ns=None,
+    repr=None,
+    cmp=None,
+    hash=None,
+    init=None,
+    slots=False,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=False,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=False,
+    eq=None,
+    order=None,
+    auto_detect=False,
+    collect_by_mro=False,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+):
+    r"""
+    A class decorator that adds `dunder
+    <https://wiki.python.org/moin/DunderAlias>`_\ -methods according to the
+    specified attributes using `attr.ib` or the *these* argument.
+
+    :param these: A dictionary of name to `attr.ib` mappings.  This is
+        useful to avoid the definition of your attributes within the class body
+        because you can't (e.g. if you want to add ``__repr__`` methods to
+        Django models) or don't want to.
+
+        If *these* is not ``None``, ``attrs`` will *not* search the class body
+        for attributes and will *not* remove any attributes from it.
+
+        If *these* is an ordered dict (`dict` on Python 3.6+,
+        `collections.OrderedDict` otherwise), the order is deduced from
+        the order of the attributes inside *these*.  Otherwise the order
+        of the definition of the attributes is used.
+
+    :type these: `dict` of `str` to `attr.ib`
+
+    :param str repr_ns: When using nested classes, there's no way in Python 2
+        to automatically detect that.  Therefore it's possible to set the
+        namespace explicitly for a more meaningful ``repr`` output.
+    :param bool auto_detect: Instead of setting the *init*, *repr*, *eq*,
+        *order*, and *hash* arguments explicitly, assume they are set to
+        ``True`` **unless any** of the involved methods for one of the
+        arguments is implemented in the *current* class (i.e. it is *not*
+        inherited from some base class).
+
+        So for example by implementing ``__eq__`` on a class yourself,
+        ``attrs`` will deduce ``eq=False`` and won't create *neither*
+        ``__eq__`` *nor* ``__ne__`` (but Python classes come with a sensible
+        ``__ne__`` by default, so it *should* be enough to only implement
+        ``__eq__`` in most cases).
+
+        .. warning::
+
+           If you prevent ``attrs`` from creating the ordering methods for you
+           (``order=False``, e.g. by implementing ``__le__``), it becomes
+           *your* responsibility to make sure its ordering is sound. The best
+           way is to use the `functools.total_ordering` decorator.
+
+
+        Passing ``True`` or ``False`` to *init*, *repr*, *eq*, *order*,
+        *cmp*, or *hash* overrides whatever *auto_detect* would determine.
+
+        *auto_detect* requires Python 3. Setting it ``True`` on Python 2 raises
+        a `PythonTooOldError`.
+
+    :param bool repr: Create a ``__repr__`` method with a human readable
+        representation of ``attrs`` attributes..
+    :param bool str: Create a ``__str__`` method that is identical to
+        ``__repr__``.  This is usually not necessary except for
+        `Exception`\ s.
+    :param Optional[bool] eq: If ``True`` or ``None`` (default), add ``__eq__``
+        and ``__ne__`` methods that check two instances for equality.
+
+        They compare the instances as if they were tuples of their ``attrs``
+        attributes if and only if the types of both classes are *identical*!
+    :param Optional[bool] order: If ``True``, add ``__lt__``, ``__le__``,
+        ``__gt__``, and ``__ge__`` methods that behave like *eq* above and
+        allow instances to be ordered. If ``None`` (default) mirror value of
+        *eq*.
+    :param Optional[bool] cmp: Setting to ``True`` is equivalent to setting
+        ``eq=True, order=True``. Deprecated in favor of *eq* and *order*, has
+        precedence over them for backward-compatibility though. Must not be
+        mixed with *eq* or *order*.
+    :param Optional[bool] hash: If ``None`` (default), the ``__hash__`` method
+        is generated according how *eq* and *frozen* are set.
+
+        1. If *both* are True, ``attrs`` will generate a ``__hash__`` for you.
+        2. If *eq* is True and *frozen* is False, ``__hash__`` will be set to
+           None, marking it unhashable (which it is).
+        3. If *eq* is False, ``__hash__`` will be left untouched meaning the
+           ``__hash__`` method of the base class will be used (if base class is
+           ``object``, this means it will fall back to id-based hashing.).
+
+        Although not recommended, you can decide for yourself and force
+        ``attrs`` to create one (e.g. if the class is immutable even though you
+        didn't freeze it programmatically) by passing ``True`` or not.  Both of
+        these cases are rather special and should be used carefully.
+
+        See our documentation on `hashing`, Python's documentation on
+        `object.__hash__`, and the `GitHub issue that led to the default \
+        behavior <https://github.com/python-attrs/attrs/issues/136>`_ for more
+        details.
+    :param bool init: Create a ``__init__`` method that initializes the
+        ``attrs`` attributes.  Leading underscores are stripped for the
+        argument name.  If a ``__attrs_post_init__`` method exists on the
+        class, it will be called after the class is fully initialized.
+    :param bool slots: Create a `slotted class <slotted classes>` that's more
+        memory-efficient. Slotted classes are generally superior to the default
+        dict classes, but have some gotchas you should know about, so we
+        encourage you to read the `glossary entry <slotted classes>`.
+    :param bool frozen: Make instances immutable after initialization.  If
+        someone attempts to modify a frozen instance,
+        `attr.exceptions.FrozenInstanceError` is raised.
+
+        .. note::
+
+            1. This is achieved by installing a custom ``__setattr__`` method
+               on your class, so you can't implement your own.
+
+            2. True immutability is impossible in Python.
+
+            3. This *does* have a minor a runtime performance `impact
+               <how-frozen>` when initializing new instances.  In other words:
+               ``__init__`` is slightly slower with ``frozen=True``.
+
+            4. If a class is frozen, you cannot modify ``self`` in
+               ``__attrs_post_init__`` or a self-written ``__init__``. You can
+               circumvent that limitation by using
+               ``object.__setattr__(self, "attribute_name", value)``.
+
+            5. Subclasses of a frozen class are frozen too.
+
+    :param bool weakref_slot: Make instances weak-referenceable.  This has no
+        effect unless ``slots`` is also enabled.
+    :param bool auto_attribs: If ``True``, collect `PEP 526`_-annotated
+        attributes (Python 3.6 and later only) from the class body.
+
+        In this case, you **must** annotate every field.  If ``attrs``
+        encounters a field that is set to an `attr.ib` but lacks a type
+        annotation, an `attr.exceptions.UnannotatedAttributeError` is
+        raised.  Use ``field_name: typing.Any = attr.ib(...)`` if you don't
+        want to set a type.
+
+        If you assign a value to those attributes (e.g. ``x: int = 42``), that
+        value becomes the default value like if it were passed using
+        ``attr.ib(default=42)``.  Passing an instance of `Factory` also
+        works as expected.
+
+        Attributes annotated as `typing.ClassVar`, and attributes that are
+        neither annotated nor set to an `attr.ib` are **ignored**.
+
+        .. _`PEP 526`: https://www.python.org/dev/peps/pep-0526/
+    :param bool kw_only: Make all attributes keyword-only (Python 3+)
+        in the generated ``__init__`` (if ``init`` is ``False``, this
+        parameter is ignored).
+    :param bool cache_hash: Ensure that the object's hash code is computed
+        only once and stored on the object.  If this is set to ``True``,
+        hashing must be either explicitly or implicitly enabled for this
+        class.  If the hash code is cached, avoid any reassignments of
+        fields involved in hash code computation or mutations of the objects
+        those fields point to after object creation.  If such changes occur,
+        the behavior of the object's hash code is undefined.
+    :param bool auto_exc: If the class subclasses `BaseException`
+        (which implicitly includes any subclass of any exception), the
+        following happens to behave like a well-behaved Python exceptions
+        class:
+
+        - the values for *eq*, *order*, and *hash* are ignored and the
+          instances compare and hash by the instance's ids (N.B. ``attrs`` will
+          *not* remove existing implementations of ``__hash__`` or the equality
+          methods. It just won't add own ones.),
+        - all attributes that are either passed into ``__init__`` or have a
+          default value are additionally available as a tuple in the ``args``
+          attribute,
+        - the value of *str* is ignored leaving ``__str__`` to base classes.
+    :param bool collect_by_mro: Setting this to `True` fixes the way ``attrs``
+       collects attributes from base classes.  The default behavior is
+       incorrect in certain cases of multiple inheritance.  It should be on by
+       default but is kept off for backward-compatability.
+
+       See issue `#428 <https://github.com/python-attrs/attrs/issues/428>`_ for
+       more details.
+
+    :param Optional[bool] getstate_setstate:
+       .. note::
+          This is usually only interesting for slotted classes and you should
+          probably just set *auto_detect* to `True`.
+
+       If `True`, ``__getstate__`` and
+       ``__setstate__`` are generated and attached to the class. This is
+       necessary for slotted classes to be pickleable. If left `None`, it's
+       `True` by default for slotted classes and ``False`` for dict classes.
+
+       If *auto_detect* is `True`, and *getstate_setstate* is left `None`,
+       and **either** ``__getstate__`` or ``__setstate__`` is detected directly
+       on the class (i.e. not inherited), it is set to `False` (this is usually
+       what you want).
+
+    :param on_setattr: A callable that is run whenever the user attempts to set
+        an attribute (either by assignment like ``i.x = 42`` or by using
+        `setattr` like ``setattr(i, "x", 42)``). It receives the same arguments
+        as validators: the instance, the attribute that is being modified, and
+        the new value.
+
+        If no exception is raised, the attribute is set to the return value of
+        the callable.
+
+        If a list of callables is passed, they're automatically wrapped in an
+        `attr.setters.pipe`.
+
+    :param Optional[callable] field_transformer:
+        A function that is called with the original class object and all
+        fields right before ``attrs`` finalizes the class.  You can use
+        this, e.g., to automatically add converters or validators to
+        fields based on their types.  See `transform-fields` for more details.
+
+    .. versionadded:: 16.0.0 *slots*
+    .. versionadded:: 16.1.0 *frozen*
+    .. versionadded:: 16.3.0 *str*
+    .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``.
+    .. versionchanged:: 17.1.0
+       *hash* supports ``None`` as value which is also the default now.
+    .. versionadded:: 17.3.0 *auto_attribs*
+    .. versionchanged:: 18.1.0
+       If *these* is passed, no attributes are deleted from the class body.
+    .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained.
+    .. versionadded:: 18.2.0 *weakref_slot*
+    .. deprecated:: 18.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a
+       `DeprecationWarning` if the classes compared are subclasses of
+       each other. ``__eq`` and ``__ne__`` never tried to compared subclasses
+       to each other.
+    .. versionchanged:: 19.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider
+       subclasses comparable anymore.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionadded:: 18.2.0 *cache_hash*
+    .. versionadded:: 19.1.0 *auto_exc*
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *auto_detect*
+    .. versionadded:: 20.1.0 *collect_by_mro*
+    .. versionadded:: 20.1.0 *getstate_setstate*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionadded:: 20.3.0 *field_transformer*
+    """
+    if auto_detect and PY2:
+        raise PythonTooOldError(
+            "auto_detect only works on Python 3 and later."
+        )
+
+    eq_, order_ = _determine_eq_order(cmp, eq, order, None)
+    hash_ = hash  # work around the lack of nonlocal
+
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    def wrap(cls):
+
+        if getattr(cls, "__class__", None) is None:
+            raise TypeError("attrs only works with new-style classes.")
+
+        is_frozen = frozen or _has_frozen_base_class(cls)
+        is_exc = auto_exc is True and issubclass(cls, BaseException)
+        has_own_setattr = auto_detect and _has_own_attribute(
+            cls, "__setattr__"
+        )
+
+        if has_own_setattr and is_frozen:
+            raise ValueError("Can't freeze a class with a custom __setattr__.")
+
+        builder = _ClassBuilder(
+            cls,
+            these,
+            slots,
+            is_frozen,
+            weakref_slot,
+            _determine_whether_to_implement(
+                cls,
+                getstate_setstate,
+                auto_detect,
+                ("__getstate__", "__setstate__"),
+                default=slots,
+            ),
+            auto_attribs,
+            kw_only,
+            cache_hash,
+            is_exc,
+            collect_by_mro,
+            on_setattr,
+            has_own_setattr,
+            field_transformer,
+        )
+        if _determine_whether_to_implement(
+            cls, repr, auto_detect, ("__repr__",)
+        ):
+            builder.add_repr(repr_ns)
+        if str is True:
+            builder.add_str()
+
+        eq = _determine_whether_to_implement(
+            cls, eq_, auto_detect, ("__eq__", "__ne__")
+        )
+        if not is_exc and eq is True:
+            builder.add_eq()
+        if not is_exc and _determine_whether_to_implement(
+            cls, order_, auto_detect, ("__lt__", "__le__", "__gt__", "__ge__")
+        ):
+            builder.add_order()
+
+        builder.add_setattr()
+
+        if (
+            hash_ is None
+            and auto_detect is True
+            and _has_own_attribute(cls, "__hash__")
+        ):
+            hash = False
+        else:
+            hash = hash_
+        if hash is not True and hash is not False and hash is not None:
+            # Can't use `hash in` because 1 == True for example.
+            raise TypeError(
+                "Invalid value for hash.  Must be True, False, or None."
+            )
+        elif hash is False or (hash is None and eq is False) or is_exc:
+            # Don't do anything. Should fall back to __object__'s __hash__
+            # which is by id.
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " hashing must be either explicitly or implicitly "
+                    "enabled."
+                )
+        elif hash is True or (
+            hash is None and eq is True and is_frozen is True
+        ):
+            # Build a __hash__ if told so, or if it's safe.
+            builder.add_hash()
+        else:
+            # Raise TypeError on attempts to hash.
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " hashing must be either explicitly or implicitly "
+                    "enabled."
+                )
+            builder.make_unhashable()
+
+        if _determine_whether_to_implement(
+            cls, init, auto_detect, ("__init__",)
+        ):
+            builder.add_init()
+        else:
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " init must be True."
+                )
+
+        return builder.build_class()
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+    else:
+        return wrap(maybe_cls)
+
+
+_attrs = attrs
+"""
+Internal alias so we can use it in functions that take an argument called
+*attrs*.
+"""
+
+
+if PY2:
+
+    def _has_frozen_base_class(cls):
+        """
+        Check whether *cls* has a frozen ancestor by looking at its
+        __setattr__.
+        """
+        return (
+            getattr(cls.__setattr__, "__module__", None)
+            == _frozen_setattrs.__module__
+            and cls.__setattr__.__name__ == _frozen_setattrs.__name__
+        )
+
+
+else:
+
+    def _has_frozen_base_class(cls):
+        """
+        Check whether *cls* has a frozen ancestor by looking at its
+        __setattr__.
+        """
+        return cls.__setattr__ == _frozen_setattrs
+
+
+def _attrs_to_tuple(obj, attrs):
+    """
+    Create a tuple of all values of *obj*'s *attrs*.
+    """
+    return tuple(getattr(obj, a.name) for a in attrs)
+
+
+def _generate_unique_filename(cls, func_name):
+    """
+    Create a "filename" suitable for a function being generated.
+    """
+    unique_id = uuid.uuid4()
+    extra = ""
+    count = 1
+
+    while True:
+        unique_filename = "<attrs generated {0} {1}.{2}{3}>".format(
+            func_name,
+            cls.__module__,
+            getattr(cls, "__qualname__", cls.__name__),
+            extra,
+        )
+        # To handle concurrency we essentially "reserve" our spot in
+        # the linecache with a dummy line.  The caller can then
+        # set this value correctly.
+        cache_line = (1, None, (str(unique_id),), unique_filename)
+        if (
+            linecache.cache.setdefault(unique_filename, cache_line)
+            == cache_line
+        ):
+            return unique_filename
+
+        # Looks like this spot is taken. Try again.
+        count += 1
+        extra = "-{0}".format(count)
+
+
+def _make_hash(cls, attrs, frozen, cache_hash):
+    attrs = tuple(
+        a for a in attrs if a.hash is True or (a.hash is None and a.eq is True)
+    )
+
+    tab = "        "
+
+    unique_filename = _generate_unique_filename(cls, "hash")
+    type_hash = hash(unique_filename)
+
+    hash_def = "def __hash__(self"
+    hash_func = "hash(("
+    closing_braces = "))"
+    if not cache_hash:
+        hash_def += "):"
+    else:
+        if not PY2:
+            hash_def += ", *"
+
+        hash_def += (
+            ", _cache_wrapper="
+            + "__import__('attr._make')._make._CacheHashWrapper):"
+        )
+        hash_func = "_cache_wrapper(" + hash_func
+        closing_braces += ")"
+
+    method_lines = [hash_def]
+
+    def append_hash_computation_lines(prefix, indent):
+        """
+        Generate the code for actually computing the hash code.
+        Below this will either be returned directly or used to compute
+        a value which is then cached, depending on the value of cache_hash
+        """
+
+        method_lines.extend(
+            [
+                indent + prefix + hash_func,
+                indent + "        %d," % (type_hash,),
+            ]
+        )
+
+        for a in attrs:
+            method_lines.append(indent + "        self.%s," % a.name)
+
+        method_lines.append(indent + "    " + closing_braces)
+
+    if cache_hash:
+        method_lines.append(tab + "if self.%s is None:" % _hash_cache_field)
+        if frozen:
+            append_hash_computation_lines(
+                "object.__setattr__(self, '%s', " % _hash_cache_field, tab * 2
+            )
+            method_lines.append(tab * 2 + ")")  # close __setattr__
+        else:
+            append_hash_computation_lines(
+                "self.%s = " % _hash_cache_field, tab * 2
+            )
+        method_lines.append(tab + "return self.%s" % _hash_cache_field)
+    else:
+        append_hash_computation_lines("return ", tab)
+
+    script = "\n".join(method_lines)
+    globs = {}
+    locs = {}
+    bytecode = compile(script, unique_filename, "exec")
+    eval(bytecode, globs, locs)
+
+    # In order of debuggers like PDB being able to step through the code,
+    # we add a fake linecache entry.
+    linecache.cache[unique_filename] = (
+        len(script),
+        None,
+        script.splitlines(True),
+        unique_filename,
+    )
+
+    return locs["__hash__"]
+
+
+def _add_hash(cls, attrs):
+    """
+    Add a hash method to *cls*.
+    """
+    cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False)
+    return cls
+
+
+def _make_ne():
+    """
+    Create __ne__ method.
+    """
+
+    def __ne__(self, other):
+        """
+        Check equality and either forward a NotImplemented or
+        return the result negated.
+        """
+        result = self.__eq__(other)
+        if result is NotImplemented:
+            return NotImplemented
+
+        return not result
+
+    return __ne__
+
+
+def _make_eq(cls, attrs):
+    """
+    Create __eq__ method for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.eq]
+
+    unique_filename = _generate_unique_filename(cls, "eq")
+    lines = [
+        "def __eq__(self, other):",
+        "    if other.__class__ is not self.__class__:",
+        "        return NotImplemented",
+    ]
+    # We can't just do a big self.x = other.x and... clause due to
+    # irregularities like nan == nan is false but (nan,) == (nan,) is true.
+    if attrs:
+        lines.append("    return  (")
+        others = ["    ) == ("]
+        for a in attrs:
+            lines.append("        self.%s," % (a.name,))
+            others.append("        other.%s," % (a.name,))
+
+        lines += others + ["    )"]
+    else:
+        lines.append("    return True")
+
+    script = "\n".join(lines)
+    globs = {}
+    locs = {}
+    bytecode = compile(script, unique_filename, "exec")
+    eval(bytecode, globs, locs)
+
+    # In order of debuggers like PDB being able to step through the code,
+    # we add a fake linecache entry.
+    linecache.cache[unique_filename] = (
+        len(script),
+        None,
+        script.splitlines(True),
+        unique_filename,
+    )
+    return locs["__eq__"]
+
+
+def _make_order(cls, attrs):
+    """
+    Create ordering methods for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.order]
+
+    def attrs_to_tuple(obj):
+        """
+        Save us some typing.
+        """
+        return _attrs_to_tuple(obj, attrs)
+
+    def __lt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) < attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __le__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) <= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __gt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) > attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __ge__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) >= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    return __lt__, __le__, __gt__, __ge__
+
+
+def _add_eq(cls, attrs=None):
+    """
+    Add equality methods to *cls* with *attrs*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__eq__ = _make_eq(cls, attrs)
+    cls.__ne__ = _make_ne()
+
+    return cls
+
+
+_already_repring = threading.local()
+
+
+def _make_repr(attrs, ns):
+    """
+    Make a repr method that includes relevant *attrs*, adding *ns* to the full
+    name.
+    """
+
+    # Figure out which attributes to include, and which function to use to
+    # format them. The a.repr value can be either bool or a custom callable.
+    attr_names_with_reprs = tuple(
+        (a.name, repr if a.repr is True else a.repr)
+        for a in attrs
+        if a.repr is not False
+    )
+
+    def __repr__(self):
+        """
+        Automatically created by attrs.
+        """
+        try:
+            working_set = _already_repring.working_set
+        except AttributeError:
+            working_set = set()
+            _already_repring.working_set = working_set
+
+        if id(self) in working_set:
+            return "..."
+        real_cls = self.__class__
+        if ns is None:
+            qualname = getattr(real_cls, "__qualname__", None)
+            if qualname is not None:
+                class_name = qualname.rsplit(">.", 1)[-1]
+            else:
+                class_name = real_cls.__name__
+        else:
+            class_name = ns + "." + real_cls.__name__
+
+        # Since 'self' remains on the stack (i.e.: strongly referenced) for the
+        # duration of this call, it's safe to depend on id(...) stability, and
+        # not need to track the instance and therefore worry about properties
+        # like weakref- or hash-ability.
+        working_set.add(id(self))
+        try:
+            result = [class_name, "("]
+            first = True
+            for name, attr_repr in attr_names_with_reprs:
+                if first:
+                    first = False
+                else:
+                    result.append(", ")
+                result.extend(
+                    (name, "=", attr_repr(getattr(self, name, NOTHING)))
+                )
+            return "".join(result) + ")"
+        finally:
+            working_set.remove(id(self))
+
+    return __repr__
+
+
+def _add_repr(cls, ns=None, attrs=None):
+    """
+    Add a repr method to *cls*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__repr__ = _make_repr(attrs, ns)
+    return cls
+
+
+def fields(cls):
+    """
+    Return the tuple of ``attrs`` attributes for a class.
+
+    The tuple also allows accessing the fields by their names (see below for
+    examples).
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    :rtype: tuple (with name accessors) of `attr.Attribute`
+
+    ..  versionchanged:: 16.2.0 Returned tuple allows accessing the fields
+        by name.
+    """
+    if not isclass(cls):
+        raise TypeError("Passed object must be a class.")
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is None:
+        raise NotAnAttrsClassError(
+            "{cls!r} is not an attrs-decorated class.".format(cls=cls)
+        )
+    return attrs
+
+
+def fields_dict(cls):
+    """
+    Return an ordered dictionary of ``attrs`` attributes for a class, whose
+    keys are the attribute names.
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    :rtype: an ordered dict where keys are attribute names and values are
+        `attr.Attribute`\\ s. This will be a `dict` if it's
+        naturally ordered like on Python 3.6+ or an
+        :class:`~collections.OrderedDict` otherwise.
+
+    .. versionadded:: 18.1.0
+    """
+    if not isclass(cls):
+        raise TypeError("Passed object must be a class.")
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is None:
+        raise NotAnAttrsClassError(
+            "{cls!r} is not an attrs-decorated class.".format(cls=cls)
+        )
+    return ordered_dict(((a.name, a) for a in attrs))
+
+
+def validate(inst):
+    """
+    Validate all attributes on *inst* that have a validator.
+
+    Leaves all exceptions through.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    """
+    if _config._run_validators is False:
+        return
+
+    for a in fields(inst.__class__):
+        v = a.validator
+        if v is not None:
+            v(inst, a, getattr(inst, a.name))
+
+
+def _is_slot_cls(cls):
+    return "__slots__" in cls.__dict__
+
+
+def _is_slot_attr(a_name, base_attr_map):
+    """
+    Check if the attribute name comes from a slot class.
+    """
+    return a_name in base_attr_map and _is_slot_cls(base_attr_map[a_name])
+
+
+def _make_init(
+    cls,
+    attrs,
+    post_init,
+    frozen,
+    slots,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    has_global_on_setattr,
+):
+    if frozen and has_global_on_setattr:
+        raise ValueError("Frozen classes can't use on_setattr.")
+
+    needs_cached_setattr = cache_hash or frozen
+    filtered_attrs = []
+    attr_dict = {}
+    for a in attrs:
+        if not a.init and a.default is NOTHING:
+            continue
+
+        filtered_attrs.append(a)
+        attr_dict[a.name] = a
+
+        if a.on_setattr is not None:
+            if frozen is True:
+                raise ValueError("Frozen classes can't use on_setattr.")
+
+            needs_cached_setattr = True
+        elif (
+            has_global_on_setattr and a.on_setattr is not setters.NO_OP
+        ) or _is_slot_attr(a.name, base_attr_map):
+            needs_cached_setattr = True
+
+    unique_filename = _generate_unique_filename(cls, "init")
+
+    script, globs, annotations = _attrs_to_init_script(
+        filtered_attrs,
+        frozen,
+        slots,
+        post_init,
+        cache_hash,
+        base_attr_map,
+        is_exc,
+        needs_cached_setattr,
+        has_global_on_setattr,
+    )
+    locs = {}
+    bytecode = compile(script, unique_filename, "exec")
+    globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict})
+
+    if needs_cached_setattr:
+        # Save the lookup overhead in __init__ if we need to circumvent
+        # setattr hooks.
+        globs["_cached_setattr"] = _obj_setattr
+
+    eval(bytecode, globs, locs)
+
+    # In order of debuggers like PDB being able to step through the code,
+    # we add a fake linecache entry.
+    linecache.cache[unique_filename] = (
+        len(script),
+        None,
+        script.splitlines(True),
+        unique_filename,
+    )
+
+    __init__ = locs["__init__"]
+    __init__.__annotations__ = annotations
+
+    return __init__
+
+
+def _setattr(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*.
+    """
+    return "_setattr('%s', %s)" % (attr_name, value_var)
+
+
+def _setattr_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*, but run
+    its converter first.
+    """
+    return "_setattr('%s', %s(%s))" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+def _assign(attr_name, value, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise
+    relegate to _setattr.
+    """
+    if has_on_setattr:
+        return _setattr(attr_name, value, True)
+
+    return "self.%s = %s" % (attr_name, value)
+
+
+def _assign_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment after
+    conversion. Otherwise relegate to _setattr_with_converter.
+    """
+    if has_on_setattr:
+        return _setattr_with_converter(attr_name, value_var, True)
+
+    return "self.%s = %s(%s)" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+if PY2:
+
+    def _unpack_kw_only_py2(attr_name, default=None):
+        """
+        Unpack *attr_name* from _kw_only dict.
+        """
+        if default is not None:
+            arg_default = ", %s" % default
+        else:
+            arg_default = ""
+        return "%s = _kw_only.pop('%s'%s)" % (
+            attr_name,
+            attr_name,
+            arg_default,
+        )
+
+    def _unpack_kw_only_lines_py2(kw_only_args):
+        """
+        Unpack all *kw_only_args* from _kw_only dict and handle errors.
+
+        Given a list of strings "{attr_name}" and "{attr_name}={default}"
+        generates list of lines of code that pop attrs from _kw_only dict and
+        raise TypeError similar to builtin if required attr is missing or
+        extra key is passed.
+
+        >>> print("\n".join(_unpack_kw_only_lines_py2(["a", "b=42"])))
+        try:
+            a = _kw_only.pop('a')
+            b = _kw_only.pop('b', 42)
+        except KeyError as _key_error:
+            raise TypeError(
+                ...
+        if _kw_only:
+            raise TypeError(
+                ...
+        """
+        lines = ["try:"]
+        lines.extend(
+            "    " + _unpack_kw_only_py2(*arg.split("="))
+            for arg in kw_only_args
+        )
+        lines += """\
+except KeyError as _key_error:
+    raise TypeError(
+        '__init__() missing required keyword-only argument: %s' % _key_error
+    )
+if _kw_only:
+    raise TypeError(
+        '__init__() got an unexpected keyword argument %r'
+        % next(iter(_kw_only))
+    )
+""".split(
+            "\n"
+        )
+        return lines
+
+
+def _attrs_to_init_script(
+    attrs,
+    frozen,
+    slots,
+    post_init,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    needs_cached_setattr,
+    has_global_on_setattr,
+):
+    """
+    Return a script of an initializer for *attrs* and a dict of globals.
+
+    The globals are expected by the generated script.
+
+    If *frozen* is True, we cannot set the attributes directly so we use
+    a cached ``object.__setattr__``.
+    """
+    lines = []
+    if needs_cached_setattr:
+        lines.append(
+            # Circumvent the __setattr__ descriptor to save one lookup per
+            # assignment.
+            # Note _setattr will be used again below if cache_hash is True
+            "_setattr = _cached_setattr.__get__(self, self.__class__)"
+        )
+
+    if frozen is True:
+        if slots is True:
+            fmt_setter = _setattr
+            fmt_setter_with_converter = _setattr_with_converter
+        else:
+            # Dict frozen classes assign directly to __dict__.
+            # But only if the attribute doesn't come from an ancestor slot
+            # class.
+            # Note _inst_dict will be used again below if cache_hash is True
+            lines.append("_inst_dict = self.__dict__")
+
+            def fmt_setter(attr_name, value_var, has_on_setattr):
+                if _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr(attr_name, value_var, has_on_setattr)
+
+                return "_inst_dict['%s'] = %s" % (attr_name, value_var)
+
+            def fmt_setter_with_converter(
+                attr_name, value_var, has_on_setattr
+            ):
+                if has_on_setattr or _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr_with_converter(
+                        attr_name, value_var, has_on_setattr
+                    )
+
+                return "_inst_dict['%s'] = %s(%s)" % (
+                    attr_name,
+                    _init_converter_pat % (attr_name,),
+                    value_var,
+                )
+
+    else:
+        # Not frozen.
+        fmt_setter = _assign
+        fmt_setter_with_converter = _assign_with_converter
+
+    args = []
+    kw_only_args = []
+    attrs_to_validate = []
+
+    # This is a dictionary of names to validator and converter callables.
+    # Injecting this into __init__ globals lets us avoid lookups.
+    names_for_globals = {}
+    annotations = {"return": None}
+
+    for a in attrs:
+        if a.validator:
+            attrs_to_validate.append(a)
+
+        attr_name = a.name
+        has_on_setattr = a.on_setattr is not None or (
+            a.on_setattr is not setters.NO_OP and has_global_on_setattr
+        )
+        arg_name = a.name.lstrip("_")
+
+        has_factory = isinstance(a.default, Factory)
+        if has_factory and a.default.takes_self:
+            maybe_self = "self"
+        else:
+            maybe_self = ""
+
+        if a.init is False:
+            if has_factory:
+                init_factory_name = _init_factory_pat.format(a.name)
+                if a.converter is not None:
+                    lines.append(
+                        fmt_setter_with_converter(
+                            attr_name,
+                            init_factory_name + "(%s)" % (maybe_self,),
+                            has_on_setattr,
+                        )
+                    )
+                    conv_name = _init_converter_pat % (a.name,)
+                    names_for_globals[conv_name] = a.converter
+                else:
+                    lines.append(
+                        fmt_setter(
+                            attr_name,
+                            init_factory_name + "(%s)" % (maybe_self,),
+                            has_on_setattr,
+                        )
+                    )
+                names_for_globals[init_factory_name] = a.default.factory
+            else:
+                if a.converter is not None:
+                    lines.append(
+                        fmt_setter_with_converter(
+                            attr_name,
+                            "attr_dict['%s'].default" % (attr_name,),
+                            has_on_setattr,
+                        )
+                    )
+                    conv_name = _init_converter_pat % (a.name,)
+                    names_for_globals[conv_name] = a.converter
+                else:
+                    lines.append(
+                        fmt_setter(
+                            attr_name,
+                            "attr_dict['%s'].default" % (attr_name,),
+                            has_on_setattr,
+                        )
+                    )
+        elif a.default is not NOTHING and not has_factory:
+            arg = "%s=attr_dict['%s'].default" % (arg_name, attr_name)
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        elif has_factory:
+            arg = "%s=NOTHING" % (arg_name,)
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+            lines.append("if %s is not NOTHING:" % (arg_name,))
+
+            init_factory_name = _init_factory_pat.format(a.name)
+            if a.converter is not None:
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(
+                    "    " + fmt_setter(attr_name, arg_name, has_on_setattr)
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+            names_for_globals[init_factory_name] = a.default.factory
+        else:
+            if a.kw_only:
+                kw_only_args.append(arg_name)
+            else:
+                args.append(arg_name)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        if a.init is True and a.converter is None and a.type is not None:
+            annotations[arg_name] = a.type
+
+    if attrs_to_validate:  # we can skip this if there are no validators.
+        names_for_globals["_config"] = _config
+        lines.append("if _config._run_validators is True:")
+        for a in attrs_to_validate:
+            val_name = "__attr_validator_" + a.name
+            attr_name = "__attr_" + a.name
+            lines.append(
+                "    %s(self, %s, self.%s)" % (val_name, attr_name, a.name)
+            )
+            names_for_globals[val_name] = a.validator
+            names_for_globals[attr_name] = a
+
+    if post_init:
+        lines.append("self.__attrs_post_init__()")
+
+    # because this is set only after __attrs_post_init is called, a crash
+    # will result if post-init tries to access the hash code.  This seemed
+    # preferable to setting this beforehand, in which case alteration to
+    # field values during post-init combined with post-init accessing the
+    # hash code would result in silent bugs.
+    if cache_hash:
+        if frozen:
+            if slots:
+                # if frozen and slots, then _setattr defined above
+                init_hash_cache = "_setattr('%s', %s)"
+            else:
+                # if frozen and not slots, then _inst_dict defined above
+                init_hash_cache = "_inst_dict['%s'] = %s"
+        else:
+            init_hash_cache = "self.%s = %s"
+        lines.append(init_hash_cache % (_hash_cache_field, "None"))
+
+    # For exceptions we rely on BaseException.__init__ for proper
+    # initialization.
+    if is_exc:
+        vals = ",".join("self." + a.name for a in attrs if a.init)
+
+        lines.append("BaseException.__init__(self, %s)" % (vals,))
+
+    args = ", ".join(args)
+    if kw_only_args:
+        if PY2:
+            lines = _unpack_kw_only_lines_py2(kw_only_args) + lines
+
+            args += "%s**_kw_only" % (", " if args else "",)  # leading comma
+        else:
+            args += "%s*, %s" % (
+                ", " if args else "",  # leading comma
+                ", ".join(kw_only_args),  # kw_only args
+            )
+    return (
+        """\
+def __init__(self, {args}):
+    {lines}
+""".format(
+            args=args, lines="\n    ".join(lines) if lines else "pass"
+        ),
+        names_for_globals,
+        annotations,
+    )
+
+
+class Attribute(object):
+    """
+    *Read-only* representation of an attribute.
+
+    Instances of this class are frequently used for introspection purposes
+    like:
+
+    - `fields` returns a tuple of them.
+    - Validators get them passed as the first argument.
+    - The *field transformer* hook receives a list of them.
+
+    :attribute name: The name of the attribute.
+    :attribute inherited: Whether or not that attribute has been inherited from
+        a base class.
+
+    Plus *all* arguments of `attr.ib` (except for ``factory``
+    which is only syntactic sugar for ``default=Factory(...)``.
+
+    .. versionadded:: 20.1.0 *inherited*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.2.0 *inherited* is not taken into account for
+        equality checks and hashing anymore.
+
+    For the full version history of the fields, see `attr.ib`.
+    """
+
+    __slots__ = (
+        "name",
+        "default",
+        "validator",
+        "repr",
+        "eq",
+        "order",
+        "hash",
+        "init",
+        "metadata",
+        "type",
+        "converter",
+        "kw_only",
+        "inherited",
+        "on_setattr",
+    )
+
+    def __init__(
+        self,
+        name,
+        default,
+        validator,
+        repr,
+        cmp,  # XXX: unused, remove along with other cmp code.
+        hash,
+        init,
+        inherited,
+        metadata=None,
+        type=None,
+        converter=None,
+        kw_only=False,
+        eq=None,
+        order=None,
+        on_setattr=None,
+    ):
+        eq, order = _determine_eq_order(cmp, eq, order, True)
+
+        # Cache this descriptor here to speed things up later.
+        bound_setattr = _obj_setattr.__get__(self, Attribute)
+
+        # Despite the big red warning, people *do* instantiate `Attribute`
+        # themselves.
+        bound_setattr("name", name)
+        bound_setattr("default", default)
+        bound_setattr("validator", validator)
+        bound_setattr("repr", repr)
+        bound_setattr("eq", eq)
+        bound_setattr("order", order)
+        bound_setattr("hash", hash)
+        bound_setattr("init", init)
+        bound_setattr("converter", converter)
+        bound_setattr(
+            "metadata",
+            (
+                metadata_proxy(metadata)
+                if metadata
+                else _empty_metadata_singleton
+            ),
+        )
+        bound_setattr("type", type)
+        bound_setattr("kw_only", kw_only)
+        bound_setattr("inherited", inherited)
+        bound_setattr("on_setattr", on_setattr)
+
+    def __setattr__(self, name, value):
+        raise FrozenInstanceError()
+
+    @classmethod
+    def from_counting_attr(cls, name, ca, type=None):
+        # type holds the annotated value. deal with conflicts:
+        if type is None:
+            type = ca.type
+        elif ca.type is not None:
+            raise ValueError(
+                "Type annotation and type argument cannot both be present"
+            )
+        inst_dict = {
+            k: getattr(ca, k)
+            for k in Attribute.__slots__
+            if k
+            not in (
+                "name",
+                "validator",
+                "default",
+                "type",
+                "inherited",
+            )  # exclude methods and deprecated alias
+        }
+        return cls(
+            name=name,
+            validator=ca._validator,
+            default=ca._default,
+            type=type,
+            cmp=None,
+            inherited=False,
+            **inst_dict
+        )
+
+    @property
+    def cmp(self):
+        """
+        Simulate the presence of a cmp attribute and warn.
+        """
+        warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=2)
+
+        return self.eq and self.order
+
+    # Don't use attr.evolve since fields(Attribute) doesn't work
+    def evolve(self, **changes):
+        """
+        Copy *self* and apply *changes*.
+
+        This works similarly to `attr.evolve` but that function does not work
+        with ``Attribute``.
+
+        It is mainly meant to be used for `transform-fields`.
+
+        .. versionadded:: 20.3.0
+        """
+        new = copy.copy(self)
+
+        new._setattrs(changes.items())
+
+        return new
+
+    # Don't use _add_pickle since fields(Attribute) doesn't work
+    def __getstate__(self):
+        """
+        Play nice with pickle.
+        """
+        return tuple(
+            getattr(self, name) if name != "metadata" else dict(self.metadata)
+            for name in self.__slots__
+        )
+
+    def __setstate__(self, state):
+        """
+        Play nice with pickle.
+        """
+        self._setattrs(zip(self.__slots__, state))
+
+    def _setattrs(self, name_values_pairs):
+        bound_setattr = _obj_setattr.__get__(self, Attribute)
+        for name, value in name_values_pairs:
+            if name != "metadata":
+                bound_setattr(name, value)
+            else:
+                bound_setattr(
+                    name,
+                    metadata_proxy(value)
+                    if value
+                    else _empty_metadata_singleton,
+                )
+
+
+_a = [
+    Attribute(
+        name=name,
+        default=NOTHING,
+        validator=None,
+        repr=True,
+        cmp=None,
+        eq=True,
+        order=False,
+        hash=(name != "metadata"),
+        init=True,
+        inherited=False,
+    )
+    for name in Attribute.__slots__
+]
+
+Attribute = _add_hash(
+    _add_eq(
+        _add_repr(Attribute, attrs=_a),
+        attrs=[a for a in _a if a.name != "inherited"],
+    ),
+    attrs=[a for a in _a if a.hash and a.name != "inherited"],
+)
+
+
+class _CountingAttr(object):
+    """
+    Intermediate representation of attributes that uses a counter to preserve
+    the order in which the attributes have been defined.
+
+    *Internal* data structure of the attrs library.  Running into is most
+    likely the result of a bug like a forgotten `@attr.s` decorator.
+    """
+
+    __slots__ = (
+        "counter",
+        "_default",
+        "repr",
+        "eq",
+        "order",
+        "hash",
+        "init",
+        "metadata",
+        "_validator",
+        "converter",
+        "type",
+        "kw_only",
+        "on_setattr",
+    )
+    __attrs_attrs__ = tuple(
+        Attribute(
+            name=name,
+            default=NOTHING,
+            validator=None,
+            repr=True,
+            cmp=None,
+            hash=True,
+            init=True,
+            kw_only=False,
+            eq=True,
+            order=False,
+            inherited=False,
+            on_setattr=None,
+        )
+        for name in (
+            "counter",
+            "_default",
+            "repr",
+            "eq",
+            "order",
+            "hash",
+            "init",
+            "on_setattr",
+        )
+    ) + (
+        Attribute(
+            name="metadata",
+            default=None,
+            validator=None,
+            repr=True,
+            cmp=None,
+            hash=False,
+            init=True,
+            kw_only=False,
+            eq=True,
+            order=False,
+            inherited=False,
+            on_setattr=None,
+        ),
+    )
+    cls_counter = 0
+
+    def __init__(
+        self,
+        default,
+        validator,
+        repr,
+        cmp,  # XXX: unused, remove along with cmp
+        hash,
+        init,
+        converter,
+        metadata,
+        type,
+        kw_only,
+        eq,
+        order,
+        on_setattr,
+    ):
+        _CountingAttr.cls_counter += 1
+        self.counter = _CountingAttr.cls_counter
+        self._default = default
+        self._validator = validator
+        self.converter = converter
+        self.repr = repr
+        self.eq = eq
+        self.order = order
+        self.hash = hash
+        self.init = init
+        self.metadata = metadata
+        self.type = type
+        self.kw_only = kw_only
+        self.on_setattr = on_setattr
+
+    def validator(self, meth):
+        """
+        Decorator that adds *meth* to the list of validators.
+
+        Returns *meth* unchanged.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._validator is None:
+            self._validator = meth
+        else:
+            self._validator = and_(self._validator, meth)
+        return meth
+
+    def default(self, meth):
+        """
+        Decorator that allows to set the default for an attribute.
+
+        Returns *meth* unchanged.
+
+        :raises DefaultAlreadySetError: If default has been set before.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._default is not NOTHING:
+            raise DefaultAlreadySetError()
+
+        self._default = Factory(meth, takes_self=True)
+
+        return meth
+
+
+_CountingAttr = _add_eq(_add_repr(_CountingAttr))
+
+
+@attrs(slots=True, init=False, hash=True)
+class Factory(object):
+    """
+    Stores a factory callable.
+
+    If passed as the default value to `attr.ib`, the factory is used to
+    generate a new value.
+
+    :param callable factory: A callable that takes either none or exactly one
+        mandatory positional argument depending on *takes_self*.
+    :param bool takes_self: Pass the partially initialized instance that is
+        being initialized as a positional argument.
+
+    .. versionadded:: 17.1.0  *takes_self*
+    """
+
+    factory = attrib()
+    takes_self = attrib()
+
+    def __init__(self, factory, takes_self=False):
+        """
+        `Factory` is part of the default machinery so if we want a default
+        value here, we have to implement it ourselves.
+        """
+        self.factory = factory
+        self.takes_self = takes_self
+
+
+def make_class(name, attrs, bases=(object,), **attributes_arguments):
+    """
+    A quick way to create a new class called *name* with *attrs*.
+
+    :param str name: The name for the new class.
+
+    :param attrs: A list of names or a dictionary of mappings of names to
+        attributes.
+
+        If *attrs* is a list or an ordered dict (`dict` on Python 3.6+,
+        `collections.OrderedDict` otherwise), the order is deduced from
+        the order of the names or attributes inside *attrs*.  Otherwise the
+        order of the definition of the attributes is used.
+    :type attrs: `list` or `dict`
+
+    :param tuple bases: Classes that the new class will subclass.
+
+    :param attributes_arguments: Passed unmodified to `attr.s`.
+
+    :return: A new class with *attrs*.
+    :rtype: type
+
+    .. versionadded:: 17.1.0 *bases*
+    .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained.
+    """
+    if isinstance(attrs, dict):
+        cls_dict = attrs
+    elif isinstance(attrs, (list, tuple)):
+        cls_dict = dict((a, attrib()) for a in attrs)
+    else:
+        raise TypeError("attrs argument must be a dict or a list.")
+
+    post_init = cls_dict.pop("__attrs_post_init__", None)
+    type_ = type(
+        name,
+        bases,
+        {} if post_init is None else {"__attrs_post_init__": post_init},
+    )
+    # For pickling to work, the __module__ variable needs to be set to the
+    # frame where the class is created.  Bypass this step in environments where
+    # sys._getframe is not defined (Jython for example) or sys._getframe is not
+    # defined for arguments greater than 0 (IronPython).
+    try:
+        type_.__module__ = sys._getframe(1).f_globals.get(
+            "__name__", "__main__"
+        )
+    except (AttributeError, ValueError):
+        pass
+
+    # We do it here for proper warnings with meaningful stacklevel.
+    cmp = attributes_arguments.pop("cmp", None)
+    (
+        attributes_arguments["eq"],
+        attributes_arguments["order"],
+    ) = _determine_eq_order(
+        cmp,
+        attributes_arguments.get("eq"),
+        attributes_arguments.get("order"),
+        True,
+    )
+
+    return _attrs(these=cls_dict, **attributes_arguments)(type_)
+
+
+# These are required by within this module so we define them here and merely
+# import into .validators / .converters.
+
+
+@attrs(slots=True, hash=True)
+class _AndValidator(object):
+    """
+    Compose many validators to a single one.
+    """
+
+    _validators = attrib()
+
+    def __call__(self, inst, attr, value):
+        for v in self._validators:
+            v(inst, attr, value)
+
+
+def and_(*validators):
+    """
+    A validator that composes multiple validators into one.
+
+    When called on a value, it runs all wrapped validators.
+
+    :param callables validators: Arbitrary number of validators.
+
+    .. versionadded:: 17.1.0
+    """
+    vals = []
+    for validator in validators:
+        vals.extend(
+            validator._validators
+            if isinstance(validator, _AndValidator)
+            else [validator]
+        )
+
+    return _AndValidator(tuple(vals))
+
+
+def pipe(*converters):
+    """
+    A converter that composes multiple converters into one.
+
+    When called on a value, it runs all wrapped converters, returning the
+    *last* value.
+
+    :param callables converters: Arbitrary number of converters.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def pipe_converter(val):
+        for converter in converters:
+            val = converter(val)
+
+        return val
+
+    return pipe_converter
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_next_gen.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_next_gen.py
new file mode 100644
index 0000000000000000000000000000000000000000..2b5565c569e5e1985187db8720d98c28bd3bfaa3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_next_gen.py
@@ -0,0 +1,160 @@
+"""
+This is a Python 3.6 and later-only, keyword-only, and **provisional** API that
+calls `attr.s` with different default values.
+
+Provisional APIs that shall become "import attrs" one glorious day.
+"""
+
+from functools import partial
+
+from attr.exceptions import UnannotatedAttributeError
+
+from . import setters
+from ._make import NOTHING, _frozen_setattrs, attrib, attrs
+
+
+def define(
+    maybe_cls=None,
+    *,
+    these=None,
+    repr=None,
+    hash=None,
+    init=None,
+    slots=True,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=None,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=True,
+    eq=None,
+    order=False,
+    auto_detect=True,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+):
+    r"""
+    The only behavioral differences are the handling of the *auto_attribs*
+    option:
+
+    :param Optional[bool] auto_attribs: If set to `True` or `False`, it behaves
+       exactly like `attr.s`. If left `None`, `attr.s` will try to guess:
+
+       1. If all attributes are annotated and no `attr.ib` is found, it assumes
+          *auto_attribs=True*.
+       2. Otherwise it assumes *auto_attribs=False* and tries to collect
+          `attr.ib`\ s.
+
+    and that mutable classes (``frozen=False``) validate on ``__setattr__``.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def do_it(cls, auto_attribs):
+        return attrs(
+            maybe_cls=cls,
+            these=these,
+            repr=repr,
+            hash=hash,
+            init=init,
+            slots=slots,
+            frozen=frozen,
+            weakref_slot=weakref_slot,
+            str=str,
+            auto_attribs=auto_attribs,
+            kw_only=kw_only,
+            cache_hash=cache_hash,
+            auto_exc=auto_exc,
+            eq=eq,
+            order=order,
+            auto_detect=auto_detect,
+            collect_by_mro=True,
+            getstate_setstate=getstate_setstate,
+            on_setattr=on_setattr,
+            field_transformer=field_transformer,
+        )
+
+    def wrap(cls):
+        """
+        Making this a wrapper ensures this code runs during class creation.
+
+        We also ensure that frozen-ness of classes is inherited.
+        """
+        nonlocal frozen, on_setattr
+
+        had_on_setattr = on_setattr not in (None, setters.NO_OP)
+
+        # By default, mutable classes validate on setattr.
+        if frozen is False and on_setattr is None:
+            on_setattr = setters.validate
+
+        # However, if we subclass a frozen class, we inherit the immutability
+        # and disable on_setattr.
+        for base_cls in cls.__bases__:
+            if base_cls.__setattr__ is _frozen_setattrs:
+                if had_on_setattr:
+                    raise ValueError(
+                        "Frozen classes can't use on_setattr "
+                        "(frozen-ness was inherited)."
+                    )
+
+                on_setattr = setters.NO_OP
+                break
+
+        if auto_attribs is not None:
+            return do_it(cls, auto_attribs)
+
+        try:
+            return do_it(cls, True)
+        except UnannotatedAttributeError:
+            return do_it(cls, False)
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+    else:
+        return wrap(maybe_cls)
+
+
+mutable = define
+frozen = partial(define, frozen=True, on_setattr=None)
+
+
+def field(
+    *,
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    hash=None,
+    init=True,
+    metadata=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+):
+    """
+    Identical to `attr.ib`, except keyword-only and with some arguments
+    removed.
+
+    .. versionadded:: 20.1.0
+    """
+    return attrib(
+        default=default,
+        validator=validator,
+        repr=repr,
+        hash=hash,
+        init=init,
+        metadata=metadata,
+        converter=converter,
+        factory=factory,
+        kw_only=kw_only,
+        eq=eq,
+        order=order,
+        on_setattr=on_setattr,
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..014e78a1b43851a2795d5b0e45cfde708e577460
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.py
@@ -0,0 +1,85 @@
+from __future__ import absolute_import, division, print_function
+
+from functools import total_ordering
+
+from ._funcs import astuple
+from ._make import attrib, attrs
+
+
+@total_ordering
+@attrs(eq=False, order=False, slots=True, frozen=True)
+class VersionInfo(object):
+    """
+    A version object that can be compared to tuple of length 1--4:
+
+    >>> attr.VersionInfo(19, 1, 0, "final")  <= (19, 2)
+    True
+    >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1)
+    True
+    >>> vi = attr.VersionInfo(19, 2, 0, "final")
+    >>> vi < (19, 1, 1)
+    False
+    >>> vi < (19,)
+    False
+    >>> vi == (19, 2,)
+    True
+    >>> vi == (19, 2, 1)
+    False
+
+    .. versionadded:: 19.2
+    """
+
+    year = attrib(type=int)
+    minor = attrib(type=int)
+    micro = attrib(type=int)
+    releaselevel = attrib(type=str)
+
+    @classmethod
+    def _from_version_string(cls, s):
+        """
+        Parse *s* and return a _VersionInfo.
+        """
+        v = s.split(".")
+        if len(v) == 3:
+            v.append("final")
+
+        return cls(
+            year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3]
+        )
+
+    def _ensure_tuple(self, other):
+        """
+        Ensure *other* is a tuple of a valid length.
+
+        Returns a possibly transformed *other* and ourselves as a tuple of
+        the same length as *other*.
+        """
+
+        if self.__class__ is other.__class__:
+            other = astuple(other)
+
+        if not isinstance(other, tuple):
+            raise NotImplementedError
+
+        if not (1 <= len(other) <= 4):
+            raise NotImplementedError
+
+        return astuple(self)[: len(other)], other
+
+    def __eq__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        return us == them
+
+    def __lt__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't
+        # have to do anything special with releaselevel for now.
+        return us < them
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..45ced086337783c4b73b26cd17d2c1c260e24029
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/_version_info.pyi
@@ -0,0 +1,9 @@
+class VersionInfo:
+    @property
+    def year(self) -> int: ...
+    @property
+    def minor(self) -> int: ...
+    @property
+    def micro(self) -> int: ...
+    @property
+    def releaselevel(self) -> str: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.py
new file mode 100644
index 0000000000000000000000000000000000000000..715ce17859f456e7197d8d3b09ec4ecea8b004d1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.py
@@ -0,0 +1,85 @@
+"""
+Commonly useful converters.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from ._make import NOTHING, Factory, pipe
+
+
+__all__ = [
+    "pipe",
+    "optional",
+    "default_if_none",
+]
+
+
+def optional(converter):
+    """
+    A converter that allows an attribute to be optional. An optional attribute
+    is one which can be set to ``None``.
+
+    :param callable converter: the converter that is used for non-``None``
+        values.
+
+    .. versionadded:: 17.1.0
+    """
+
+    def optional_converter(val):
+        if val is None:
+            return None
+        return converter(val)
+
+    return optional_converter
+
+
+def default_if_none(default=NOTHING, factory=None):
+    """
+    A converter that allows to replace ``None`` values by *default* or the
+    result of *factory*.
+
+    :param default: Value to be used if ``None`` is passed. Passing an instance
+       of `attr.Factory` is supported, however the ``takes_self`` option
+       is *not*.
+    :param callable factory: A callable that takes not parameters whose result
+       is used if ``None`` is passed.
+
+    :raises TypeError: If **neither** *default* or *factory* is passed.
+    :raises TypeError: If **both** *default* and *factory* are passed.
+    :raises ValueError: If an instance of `attr.Factory` is passed with
+       ``takes_self=True``.
+
+    .. versionadded:: 18.2.0
+    """
+    if default is NOTHING and factory is None:
+        raise TypeError("Must pass either `default` or `factory`.")
+
+    if default is not NOTHING and factory is not None:
+        raise TypeError(
+            "Must pass either `default` or `factory` but not both."
+        )
+
+    if factory is not None:
+        default = Factory(factory)
+
+    if isinstance(default, Factory):
+        if default.takes_self:
+            raise ValueError(
+                "`takes_self` is not supported by default_if_none."
+            )
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default.factory()
+
+    else:
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default
+
+    return default_if_none_converter
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..7b0caa14f0c1d2224744a6a5c3650004082fadcf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/converters.pyi
@@ -0,0 +1,11 @@
+from typing import TypeVar, Optional, Callable, overload
+from . import _ConverterType
+
+_T = TypeVar("_T")
+
+def pipe(*validators: _ConverterType) -> _ConverterType: ...
+def optional(converter: _ConverterType) -> _ConverterType: ...
+@overload
+def default_if_none(default: _T) -> _ConverterType: ...
+@overload
+def default_if_none(*, factory: Callable[[], _T]) -> _ConverterType: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcd89106f16fed3fbb84fc2f45b5327ecd5848cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.py
@@ -0,0 +1,92 @@
+from __future__ import absolute_import, division, print_function
+
+
+class FrozenError(AttributeError):
+    """
+    A frozen/immutable instance or attribute haave been attempted to be
+    modified.
+
+    It mirrors the behavior of ``namedtuples`` by using the same error message
+    and subclassing `AttributeError`.
+
+    .. versionadded:: 20.1.0
+    """
+
+    msg = "can't set attribute"
+    args = [msg]
+
+
+class FrozenInstanceError(FrozenError):
+    """
+    A frozen instance has been attempted to be modified.
+
+    .. versionadded:: 16.1.0
+    """
+
+
+class FrozenAttributeError(FrozenError):
+    """
+    A frozen attribute has been attempted to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+
+
+class AttrsAttributeNotFoundError(ValueError):
+    """
+    An ``attrs`` function couldn't find an attribute that the user asked for.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class NotAnAttrsClassError(ValueError):
+    """
+    A non-``attrs`` class has been passed into an ``attrs`` function.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class DefaultAlreadySetError(RuntimeError):
+    """
+    A default has been set using ``attr.ib()`` and is attempted to be reset
+    using the decorator.
+
+    .. versionadded:: 17.1.0
+    """
+
+
+class UnannotatedAttributeError(RuntimeError):
+    """
+    A class with ``auto_attribs=True`` has an ``attr.ib()`` without a type
+    annotation.
+
+    .. versionadded:: 17.3.0
+    """
+
+
+class PythonTooOldError(RuntimeError):
+    """
+    It was attempted to use an ``attrs`` feature that requires a newer Python
+    version.
+
+    .. versionadded:: 18.2.0
+    """
+
+
+class NotCallableError(TypeError):
+    """
+    A ``attr.ib()`` requiring a callable has been set with a value
+    that is not callable.
+
+    .. versionadded:: 19.2.0
+    """
+
+    def __init__(self, msg, value):
+        super(TypeError, self).__init__(msg, value)
+        self.msg = msg
+        self.value = value
+
+    def __str__(self):
+        return str(self.msg)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..f2680118b404db8f5227d04d27e8439331341c4d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/exceptions.pyi
@@ -0,0 +1,17 @@
+from typing import Any
+
+class FrozenError(AttributeError):
+    msg: str = ...
+
+class FrozenInstanceError(FrozenError): ...
+class FrozenAttributeError(FrozenError): ...
+class AttrsAttributeNotFoundError(ValueError): ...
+class NotAnAttrsClassError(ValueError): ...
+class DefaultAlreadySetError(RuntimeError): ...
+class UnannotatedAttributeError(RuntimeError): ...
+class PythonTooOldError(RuntimeError): ...
+
+class NotCallableError(TypeError):
+    msg: str = ...
+    value: Any = ...
+    def __init__(self, msg: str, value: Any) -> None: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc47e8fa38ce6af08ae29125dc97ee2b19e948d2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.py
@@ -0,0 +1,52 @@
+"""
+Commonly useful filters for `attr.asdict`.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from ._compat import isclass
+from ._make import Attribute
+
+
+def _split_what(what):
+    """
+    Returns a tuple of `frozenset`s of classes and attributes.
+    """
+    return (
+        frozenset(cls for cls in what if isclass(cls)),
+        frozenset(cls for cls in what if isinstance(cls, Attribute)),
+    )
+
+
+def include(*what):
+    """
+    Whitelist *what*.
+
+    :param what: What to whitelist.
+    :type what: `list` of `type` or `attr.Attribute`\\ s
+
+    :rtype: `callable`
+    """
+    cls, attrs = _split_what(what)
+
+    def include_(attribute, value):
+        return value.__class__ in cls or attribute in attrs
+
+    return include_
+
+
+def exclude(*what):
+    """
+    Blacklist *what*.
+
+    :param what: What to blacklist.
+    :type what: `list` of classes or `attr.Attribute`\\ s.
+
+    :rtype: `callable`
+    """
+    cls, attrs = _split_what(what)
+
+    def exclude_(attribute, value):
+        return value.__class__ not in cls and attribute not in attrs
+
+    return exclude_
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..68368fe2b92d8f61ef4ca176d007975af08c3cca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/filters.pyi
@@ -0,0 +1,5 @@
+from typing import Union, Any
+from . import Attribute, _FilterType
+
+def include(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...
+def exclude(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/py.typed b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.py
new file mode 100644
index 0000000000000000000000000000000000000000..240014b3c1e4eb2f264ca6cabe0a426da2eb7aac
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.py
@@ -0,0 +1,77 @@
+"""
+Commonly used hooks for on_setattr.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from . import _config
+from .exceptions import FrozenAttributeError
+
+
+def pipe(*setters):
+    """
+    Run all *setters* and return the return value of the last one.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def wrapped_pipe(instance, attrib, new_value):
+        rv = new_value
+
+        for setter in setters:
+            rv = setter(instance, attrib, rv)
+
+        return rv
+
+    return wrapped_pipe
+
+
+def frozen(_, __, ___):
+    """
+    Prevent an attribute to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+    raise FrozenAttributeError()
+
+
+def validate(instance, attrib, new_value):
+    """
+    Run *attrib*'s validator on *new_value* if it has one.
+
+    .. versionadded:: 20.1.0
+    """
+    if _config._run_validators is False:
+        return new_value
+
+    v = attrib.validator
+    if not v:
+        return new_value
+
+    v(instance, attrib, new_value)
+
+    return new_value
+
+
+def convert(instance, attrib, new_value):
+    """
+    Run *attrib*'s converter -- if it has one --  on *new_value* and return the
+    result.
+
+    .. versionadded:: 20.1.0
+    """
+    c = attrib.converter
+    if c:
+        return c(new_value)
+
+    return new_value
+
+
+NO_OP = object()
+"""
+Sentinel for disabling class-wide *on_setattr* hooks for certain attributes.
+
+Does not work in `pipe` or within lists.
+
+.. versionadded:: 20.1.0
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..19bc33fd1e27057f80f89125607719a296158f24
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/setters.pyi
@@ -0,0 +1,18 @@
+from . import _OnSetAttrType, Attribute
+from typing import TypeVar, Any, NewType, NoReturn, cast
+
+_T = TypeVar("_T")
+
+def frozen(
+    instance: Any, attribute: Attribute, new_value: Any
+) -> NoReturn: ...
+def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ...
+def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ...
+
+# convert is allowed to return Any, because they can be chained using pipe.
+def convert(
+    instance: Any, attribute: Attribute[Any], new_value: Any
+) -> Any: ...
+
+_NoOpType = NewType("_NoOpType", object)
+NO_OP: _NoOpType
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9a73054e9c302fc28d455b95368abf539a3196a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.py
@@ -0,0 +1,379 @@
+"""
+Commonly useful validators.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+import re
+
+from ._make import _AndValidator, and_, attrib, attrs
+from .exceptions import NotCallableError
+
+
+__all__ = [
+    "and_",
+    "deep_iterable",
+    "deep_mapping",
+    "in_",
+    "instance_of",
+    "is_callable",
+    "matches_re",
+    "optional",
+    "provides",
+]
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InstanceOfValidator(object):
+    type = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not isinstance(value, self.type):
+            raise TypeError(
+                "'{name}' must be {type!r} (got {value!r} that is a "
+                "{actual!r}).".format(
+                    name=attr.name,
+                    type=self.type,
+                    actual=value.__class__,
+                    value=value,
+                ),
+                attr,
+                self.type,
+                value,
+            )
+
+    def __repr__(self):
+        return "<instance_of validator for type {type!r}>".format(
+            type=self.type
+        )
+
+
+def instance_of(type):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with a wrong type for this particular attribute (checks are performed using
+    `isinstance` therefore it's also valid to pass a tuple of types).
+
+    :param type: The type to check for.
+    :type type: type or tuple of types
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attr.Attribute`), the expected type, and the value it
+        got.
+    """
+    return _InstanceOfValidator(type)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _MatchesReValidator(object):
+    regex = attrib()
+    flags = attrib()
+    match_func = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.match_func(value):
+            raise ValueError(
+                "'{name}' must match regex {regex!r}"
+                " ({value!r} doesn't)".format(
+                    name=attr.name, regex=self.regex.pattern, value=value
+                ),
+                attr,
+                self.regex,
+                value,
+            )
+
+    def __repr__(self):
+        return "<matches_re validator for pattern {regex!r}>".format(
+            regex=self.regex
+        )
+
+
+def matches_re(regex, flags=0, func=None):
+    r"""
+    A validator that raises `ValueError` if the initializer is called
+    with a string that doesn't match *regex*.
+
+    :param str regex: a regex string to match against
+    :param int flags: flags that will be passed to the underlying re function
+        (default 0)
+    :param callable func: which underlying `re` function to call (options
+        are `re.fullmatch`, `re.search`, `re.match`, default
+        is ``None`` which means either `re.fullmatch` or an emulation of
+        it on Python 2). For performance reasons, they won't be used directly
+        but on a pre-`re.compile`\ ed pattern.
+
+    .. versionadded:: 19.2.0
+    """
+    fullmatch = getattr(re, "fullmatch", None)
+    valid_funcs = (fullmatch, None, re.search, re.match)
+    if func not in valid_funcs:
+        raise ValueError(
+            "'func' must be one of %s."
+            % (
+                ", ".join(
+                    sorted(
+                        e and e.__name__ or "None" for e in set(valid_funcs)
+                    )
+                ),
+            )
+        )
+
+    pattern = re.compile(regex, flags)
+    if func is re.match:
+        match_func = pattern.match
+    elif func is re.search:
+        match_func = pattern.search
+    else:
+        if fullmatch:
+            match_func = pattern.fullmatch
+        else:
+            pattern = re.compile(r"(?:{})\Z".format(regex), flags)
+            match_func = pattern.match
+
+    return _MatchesReValidator(pattern, flags, match_func)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _ProvidesValidator(object):
+    interface = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.interface.providedBy(value):
+            raise TypeError(
+                "'{name}' must provide {interface!r} which {value!r} "
+                "doesn't.".format(
+                    name=attr.name, interface=self.interface, value=value
+                ),
+                attr,
+                self.interface,
+                value,
+            )
+
+    def __repr__(self):
+        return "<provides validator for interface {interface!r}>".format(
+            interface=self.interface
+        )
+
+
+def provides(interface):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with an object that does not provide the requested *interface* (checks are
+    performed using ``interface.providedBy(value)`` (see `zope.interface
+    <https://zopeinterface.readthedocs.io/en/latest/>`_).
+
+    :param interface: The interface to check for.
+    :type interface: ``zope.interface.Interface``
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attr.Attribute`), the expected interface, and the
+        value it got.
+    """
+    return _ProvidesValidator(interface)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _OptionalValidator(object):
+    validator = attrib()
+
+    def __call__(self, inst, attr, value):
+        if value is None:
+            return
+
+        self.validator(inst, attr, value)
+
+    def __repr__(self):
+        return "<optional validator for {what} or None>".format(
+            what=repr(self.validator)
+        )
+
+
+def optional(validator):
+    """
+    A validator that makes an attribute optional.  An optional attribute is one
+    which can be set to ``None`` in addition to satisfying the requirements of
+    the sub-validator.
+
+    :param validator: A validator (or a list of validators) that is used for
+        non-``None`` values.
+    :type validator: callable or `list` of callables.
+
+    .. versionadded:: 15.1.0
+    .. versionchanged:: 17.1.0 *validator* can be a list of validators.
+    """
+    if isinstance(validator, list):
+        return _OptionalValidator(_AndValidator(validator))
+    return _OptionalValidator(validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InValidator(object):
+    options = attrib()
+
+    def __call__(self, inst, attr, value):
+        try:
+            in_options = value in self.options
+        except TypeError:  # e.g. `1 in "abc"`
+            in_options = False
+
+        if not in_options:
+            raise ValueError(
+                "'{name}' must be in {options!r} (got {value!r})".format(
+                    name=attr.name, options=self.options, value=value
+                )
+            )
+
+    def __repr__(self):
+        return "<in_ validator with options {options!r}>".format(
+            options=self.options
+        )
+
+
+def in_(options):
+    """
+    A validator that raises a `ValueError` if the initializer is called
+    with a value that does not belong in the options provided.  The check is
+    performed using ``value in options``.
+
+    :param options: Allowed options.
+    :type options: list, tuple, `enum.Enum`, ...
+
+    :raises ValueError: With a human readable error message, the attribute (of
+       type `attr.Attribute`), the expected options, and the value it
+       got.
+
+    .. versionadded:: 17.1.0
+    """
+    return _InValidator(options)
+
+
+@attrs(repr=False, slots=False, hash=True)
+class _IsCallableValidator(object):
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not callable(value):
+            message = (
+                "'{name}' must be callable "
+                "(got {value!r} that is a {actual!r})."
+            )
+            raise NotCallableError(
+                msg=message.format(
+                    name=attr.name, value=value, actual=value.__class__
+                ),
+                value=value,
+            )
+
+    def __repr__(self):
+        return "<is_callable validator>"
+
+
+def is_callable():
+    """
+    A validator that raises a `attr.exceptions.NotCallableError` if the
+    initializer is called with a value for this particular attribute
+    that is not callable.
+
+    .. versionadded:: 19.1.0
+
+    :raises `attr.exceptions.NotCallableError`: With a human readable error
+        message containing the attribute (`attr.Attribute`) name,
+        and the value it got.
+    """
+    return _IsCallableValidator()
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepIterable(object):
+    member_validator = attrib(validator=is_callable())
+    iterable_validator = attrib(
+        default=None, validator=optional(is_callable())
+    )
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.iterable_validator is not None:
+            self.iterable_validator(inst, attr, value)
+
+        for member in value:
+            self.member_validator(inst, attr, member)
+
+    def __repr__(self):
+        iterable_identifier = (
+            ""
+            if self.iterable_validator is None
+            else " {iterable!r}".format(iterable=self.iterable_validator)
+        )
+        return (
+            "<deep_iterable validator for{iterable_identifier}"
+            " iterables of {member!r}>"
+        ).format(
+            iterable_identifier=iterable_identifier,
+            member=self.member_validator,
+        )
+
+
+def deep_iterable(member_validator, iterable_validator=None):
+    """
+    A validator that performs deep validation of an iterable.
+
+    :param member_validator: Validator to apply to iterable members
+    :param iterable_validator: Validator to apply to iterable itself
+        (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    return _DeepIterable(member_validator, iterable_validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepMapping(object):
+    key_validator = attrib(validator=is_callable())
+    value_validator = attrib(validator=is_callable())
+    mapping_validator = attrib(default=None, validator=optional(is_callable()))
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.mapping_validator is not None:
+            self.mapping_validator(inst, attr, value)
+
+        for key in value:
+            self.key_validator(inst, attr, key)
+            self.value_validator(inst, attr, value[key])
+
+    def __repr__(self):
+        return (
+            "<deep_mapping validator for objects mapping {key!r} to {value!r}>"
+        ).format(key=self.key_validator, value=self.value_validator)
+
+
+def deep_mapping(key_validator, value_validator, mapping_validator=None):
+    """
+    A validator that performs deep validation of a dictionary.
+
+    :param key_validator: Validator to apply to dictionary keys
+    :param value_validator: Validator to apply to dictionary values
+    :param mapping_validator: Validator to apply to top-level mapping
+        attribute (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    return _DeepMapping(key_validator, value_validator, mapping_validator)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..9a22abb197d7b2da7402d8f05cebee4186f9e15f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attr/validators.pyi
@@ -0,0 +1,66 @@
+from typing import (
+    Container,
+    List,
+    Union,
+    TypeVar,
+    Type,
+    Any,
+    Optional,
+    Tuple,
+    Iterable,
+    Mapping,
+    Callable,
+    Match,
+    AnyStr,
+    overload,
+)
+from . import _ValidatorType
+
+_T = TypeVar("_T")
+_T1 = TypeVar("_T1")
+_T2 = TypeVar("_T2")
+_T3 = TypeVar("_T3")
+_I = TypeVar("_I", bound=Iterable)
+_K = TypeVar("_K")
+_V = TypeVar("_V")
+_M = TypeVar("_M", bound=Mapping)
+
+# To be more precise on instance_of use some overloads.
+# If there are more than 3 items in the tuple then we fall back to Any
+@overload
+def instance_of(type: Type[_T]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(type: Tuple[Type[_T]]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2]]
+) -> _ValidatorType[Union[_T1, _T2]]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2], Type[_T3]]
+) -> _ValidatorType[Union[_T1, _T2, _T3]]: ...
+@overload
+def instance_of(type: Tuple[type, ...]) -> _ValidatorType[Any]: ...
+def provides(interface: Any) -> _ValidatorType[Any]: ...
+def optional(
+    validator: Union[_ValidatorType[_T], List[_ValidatorType[_T]]]
+) -> _ValidatorType[Optional[_T]]: ...
+def in_(options: Container[_T]) -> _ValidatorType[_T]: ...
+def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ...
+def matches_re(
+    regex: AnyStr,
+    flags: int = ...,
+    func: Optional[
+        Callable[[AnyStr, AnyStr, int], Optional[Match[AnyStr]]]
+    ] = ...,
+) -> _ValidatorType[AnyStr]: ...
+def deep_iterable(
+    member_validator: _ValidatorType[_T],
+    iterable_validator: Optional[_ValidatorType[_I]] = ...,
+) -> _ValidatorType[_I]: ...
+def deep_mapping(
+    key_validator: _ValidatorType[_K],
+    value_validator: _ValidatorType[_V],
+    mapping_validator: Optional[_ValidatorType[_M]] = ...,
+) -> _ValidatorType[_M]: ...
+def is_callable() -> _ValidatorType[_T]: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/AUTHORS.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/AUTHORS.rst
new file mode 100644
index 0000000000000000000000000000000000000000..f14ef6c60749458fcb60bfdee27efe4d957b4aeb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/AUTHORS.rst
@@ -0,0 +1,11 @@
+Credits
+=======
+
+``attrs`` is written and maintained by `Hynek Schlawack <https://hynek.me/>`_.
+
+The development is kindly supported by `Variomedia AG <https://www.variomedia.de/>`_.
+
+A full list of contributors can be found in `GitHub's overview <https://github.com/python-attrs/attrs/graphs/contributors>`_.
+
+It’s the spiritual successor of `characteristic <https://characteristic.readthedocs.io/>`_ and aspires to fix some of it clunkiness and unfortunate decisions.
+Both were inspired by Twisted’s `FancyEqMixin <https://twistedmatrix.com/documents/current/api/twisted.python.util.FancyEqMixin.html>`_ but both are implemented using class decorators because `subclassing is bad for you <https://www.youtube.com/watch?v=3MNVP9-hglc>`_, m’kay?
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..7ae3df930976bd01d34041b1c7ceeb4b32aace8c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Hynek Schlawack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a92cacb0072abd9fb4d805967ef1fb7e1b14ba01
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/METADATA
@@ -0,0 +1,241 @@
+Metadata-Version: 2.1
+Name: attrs
+Version: 20.3.0
+Summary: Classes Without Boilerplate
+Home-page: https://www.attrs.org/
+Author: Hynek Schlawack
+Author-email: hs@ox.cx
+Maintainer: Hynek Schlawack
+Maintainer-email: hs@ox.cx
+License: MIT
+Project-URL: Documentation, https://www.attrs.org/
+Project-URL: Bug Tracker, https://github.com/python-attrs/attrs/issues
+Project-URL: Source Code, https://github.com/python-attrs/attrs
+Project-URL: Funding, https://github.com/sponsors/hynek
+Project-URL: Tidelift, https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=pypi
+Keywords: class,attribute,boilerplate
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Description-Content-Type: text/x-rst
+Provides-Extra: dev
+Requires-Dist: coverage[toml] (>=5.0.2) ; extra == 'dev'
+Requires-Dist: hypothesis ; extra == 'dev'
+Requires-Dist: pympler ; extra == 'dev'
+Requires-Dist: pytest (>=4.3.0) ; extra == 'dev'
+Requires-Dist: six ; extra == 'dev'
+Requires-Dist: zope.interface ; extra == 'dev'
+Requires-Dist: furo ; extra == 'dev'
+Requires-Dist: sphinx ; extra == 'dev'
+Requires-Dist: pre-commit ; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo ; extra == 'docs'
+Requires-Dist: sphinx ; extra == 'docs'
+Requires-Dist: zope.interface ; extra == 'docs'
+Provides-Extra: tests
+Requires-Dist: coverage[toml] (>=5.0.2) ; extra == 'tests'
+Requires-Dist: hypothesis ; extra == 'tests'
+Requires-Dist: pympler ; extra == 'tests'
+Requires-Dist: pytest (>=4.3.0) ; extra == 'tests'
+Requires-Dist: six ; extra == 'tests'
+Requires-Dist: zope.interface ; extra == 'tests'
+Provides-Extra: tests_no_zope
+Requires-Dist: coverage[toml] (>=5.0.2) ; extra == 'tests_no_zope'
+Requires-Dist: hypothesis ; extra == 'tests_no_zope'
+Requires-Dist: pympler ; extra == 'tests_no_zope'
+Requires-Dist: pytest (>=4.3.0) ; extra == 'tests_no_zope'
+Requires-Dist: six ; extra == 'tests_no_zope'
+
+.. image:: https://www.attrs.org/en/latest/_static/attrs_logo.png
+   :alt: attrs Logo
+
+======================================
+``attrs``: Classes Without Boilerplate
+======================================
+
+.. image:: https://readthedocs.org/projects/attrs/badge/?version=stable
+   :target: https://www.attrs.org/en/stable/?badge=stable
+   :alt: Documentation Status
+
+.. image:: https://github.com/python-attrs/attrs/workflows/CI/badge.svg?branch=master
+   :target: https://github.com/python-attrs/attrs/actions?workflow=CI
+   :alt: CI Status
+
+.. image:: https://codecov.io/github/python-attrs/attrs/branch/master/graph/badge.svg
+   :target: https://codecov.io/github/python-attrs/attrs
+   :alt: Test Coverage
+
+.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+   :target: https://github.com/psf/black
+   :alt: Code style: black
+
+.. teaser-begin
+
+``attrs`` is the Python package that will bring back the **joy** of **writing classes** by relieving you from the drudgery of implementing object protocols (aka `dunder <https://nedbatchelder.com/blog/200605/dunder.html>`_ methods).
+
+Its main goal is to help you to write **concise** and **correct** software without slowing down your code.
+
+.. teaser-end
+
+For that, it gives you a class decorator and a way to declaratively define the attributes on that class:
+
+.. -code-begin-
+
+.. code-block:: pycon
+
+   >>> import attr
+
+   >>> @attr.s
+   ... class SomeClass(object):
+   ...     a_number = attr.ib(default=42)
+   ...     list_of_numbers = attr.ib(factory=list)
+   ...
+   ...     def hard_math(self, another_number):
+   ...         return self.a_number + sum(self.list_of_numbers) * another_number
+
+
+   >>> sc = SomeClass(1, [1, 2, 3])
+   >>> sc
+   SomeClass(a_number=1, list_of_numbers=[1, 2, 3])
+
+   >>> sc.hard_math(3)
+   19
+   >>> sc == SomeClass(1, [1, 2, 3])
+   True
+   >>> sc != SomeClass(2, [3, 2, 1])
+   True
+
+   >>> attr.asdict(sc)
+   {'a_number': 1, 'list_of_numbers': [1, 2, 3]}
+
+   >>> SomeClass()
+   SomeClass(a_number=42, list_of_numbers=[])
+
+   >>> C = attr.make_class("C", ["a", "b"])
+   >>> C("foo", "bar")
+   C(a='foo', b='bar')
+
+
+After *declaring* your attributes ``attrs`` gives you:
+
+- a concise and explicit overview of the class's attributes,
+- a nice human-readable ``__repr__``,
+- a complete set of comparison methods (equality and ordering),
+- an initializer,
+- and much more,
+
+*without* writing dull boilerplate code again and again and *without* runtime performance penalties.
+
+On Python 3.6 and later, you can often even drop the calls to ``attr.ib()`` by using `type annotations <https://www.attrs.org/en/latest/types.html>`_.
+
+This gives you the power to use actual classes with actual types in your code instead of confusing ``tuple``\ s or `confusingly behaving <https://www.attrs.org/en/stable/why.html#namedtuples>`_ ``namedtuple``\ s.
+Which in turn encourages you to write *small classes* that do `one thing well <https://www.destroyallsoftware.com/talks/boundaries>`_.
+Never again violate the `single responsibility principle <https://en.wikipedia.org/wiki/Single_responsibility_principle>`_ just because implementing ``__init__`` et al is a painful drag.
+
+
+.. -getting-help-
+
+Getting Help
+============
+
+Please use the ``python-attrs`` tag on `StackOverflow <https://stackoverflow.com/questions/tagged/python-attrs>`_ to get help.
+
+Answering questions of your fellow developers is also a great way to help the project!
+
+
+.. -project-information-
+
+Project Information
+===================
+
+``attrs`` is released under the `MIT <https://choosealicense.com/licenses/mit/>`_ license,
+its documentation lives at `Read the Docs <https://www.attrs.org/>`_,
+the code on `GitHub <https://github.com/python-attrs/attrs>`_,
+and the latest release on `PyPI <https://pypi.org/project/attrs/>`_.
+It’s rigorously tested on Python 2.7, 3.5+, and PyPy.
+
+We collect information on **third-party extensions** in our `wiki <https://github.com/python-attrs/attrs/wiki/Extensions-to-attrs>`_.
+Feel free to browse and add your own!
+
+If you'd like to contribute to ``attrs`` you're most welcome and we've written `a little guide <https://www.attrs.org/en/latest/contributing.html>`_ to get you started!
+
+
+``attrs`` for Enterprise
+------------------------
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of ``attrs`` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications.
+Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
+`Learn more. <https://tidelift.com/subscription/pkg/pypi-attrs?utm_source=pypi-attrs&utm_medium=referral&utm_campaign=enterprise&utm_term=repo>`_
+
+
+Release Information
+===================
+
+20.3.0 (2020-11-05)
+-------------------
+
+Backward-incompatible Changes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+- ``attr.define()``, ``attr.frozen()``, ``attr.mutable()``, and ``attr.field()`` remain **provisional**.
+
+  This release does **not** change change anything about them and they are already used widely in production though.
+
+  If you wish to use them together with mypy, you can simply drop `this plugin <https://gist.github.com/hynek/1e3844d0c99e479e716169034b5fa963#file-attrs_ng_plugin-py>`_ into your project.
+
+  Feel free to provide feedback to them in the linked issue #668.
+
+  We will release the ``attrs`` namespace once we have the feeling that the APIs have properly settled.
+  `#668 <https://github.com/python-attrs/attrs/issues/668>`_
+
+
+Changes
+^^^^^^^
+
+- ``attr.s()`` now has a *field_transformer* hook that is called for all ``Attribute``\ s and returns a (modified or updated) list of ``Attribute`` instances.
+  ``attr.asdict()`` has a *value_serializer* hook that can change the way values are converted.
+  Both hooks are meant to help with data (de-)serialization workflows.
+  `#653 <https://github.com/python-attrs/attrs/issues/653>`_
+- ``kw_only=True`` now works on Python 2.
+  `#700 <https://github.com/python-attrs/attrs/issues/700>`_
+- ``raise from`` now works on frozen classes on PyPy.
+  `#703 <https://github.com/python-attrs/attrs/issues/703>`_,
+  `#712 <https://github.com/python-attrs/attrs/issues/712>`_
+- ``attr.asdict()`` and ``attr.astuple()`` now treat ``frozenset``\ s like ``set``\ s with regards to the *retain_collection_types* argument.
+  `#704 <https://github.com/python-attrs/attrs/issues/704>`_
+- The type stubs for ``attr.s()`` and ``attr.make_class()`` are not missing the *collect_by_mro* argument anymore.
+  `#711 <https://github.com/python-attrs/attrs/issues/711>`_
+
+`Full changelog <https://www.attrs.org/en/stable/changelog.html>`_.
+
+Credits
+=======
+
+``attrs`` is written and maintained by `Hynek Schlawack <https://hynek.me/>`_.
+
+The development is kindly supported by `Variomedia AG <https://www.variomedia.de/>`_.
+
+A full list of contributors can be found in `GitHub's overview <https://github.com/python-attrs/attrs/graphs/contributors>`_.
+
+It’s the spiritual successor of `characteristic <https://characteristic.readthedocs.io/>`_ and aspires to fix some of it clunkiness and unfortunate decisions.
+Both were inspired by Twisted’s `FancyEqMixin <https://twistedmatrix.com/documents/current/api/twisted.python.util.FancyEqMixin.html>`_ but both are implemented using class decorators because `subclassing is bad for you <https://www.youtube.com/watch?v=3MNVP9-hglc>`_, m’kay?
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..2a564f9774da22e0015a8329ceb875fa359311eb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/RECORD
@@ -0,0 +1,39 @@
+attr/__init__.py,sha256=70KmZOgz2sUvtRTC_IuXEeN2ttOyBWHn4XA59aqGXPs,1568
+attr/__init__.pyi,sha256=ca_4sg7z0e_EL7ehy-flXVGAju5PBX2hVo51dUmPMi0,12986
+attr/__pycache__/__init__.cpython-38.pyc,,
+attr/__pycache__/_compat.cpython-38.pyc,,
+attr/__pycache__/_config.cpython-38.pyc,,
+attr/__pycache__/_funcs.cpython-38.pyc,,
+attr/__pycache__/_make.cpython-38.pyc,,
+attr/__pycache__/_next_gen.cpython-38.pyc,,
+attr/__pycache__/_version_info.cpython-38.pyc,,
+attr/__pycache__/converters.cpython-38.pyc,,
+attr/__pycache__/exceptions.cpython-38.pyc,,
+attr/__pycache__/filters.cpython-38.pyc,,
+attr/__pycache__/setters.cpython-38.pyc,,
+attr/__pycache__/validators.cpython-38.pyc,,
+attr/_compat.py,sha256=rZhpP09xbyWSzMv796XQbryIr21oReJFvA70G3lrHxg,7308
+attr/_config.py,sha256=_KvW0mQdH2PYjHc0YfIUaV_o2pVfM7ziMEYTxwmEhOA,514
+attr/_funcs.py,sha256=PvFQlflEswO_qIR2sUr4a4x8ggQpEoDKe3YKM2rLJu4,13081
+attr/_make.py,sha256=61XB4-SHQpFbWbStGWotTTbzVT2m49DUovRgnxpMqmU,88313
+attr/_next_gen.py,sha256=x6TU2rVOXmFmrNNvkfshJsxyRbAAK0wDI4SJV2OI97c,4138
+attr/_version_info.py,sha256=azMi1lNelb3cJvvYUMXsXVbUANkRzbD5IEiaXVpeVr4,2162
+attr/_version_info.pyi,sha256=x_M3L3WuB7r_ULXAWjx959udKQ4HLB8l-hsc1FDGNvk,209
+attr/converters.py,sha256=CaK6iLtEMmemrqU8LQ1D2nWtbo9dGPAv4UaZ0rFzhOA,2214
+attr/converters.pyi,sha256=fVGSfawF3NMy2EBApkC7dAwMuujWCHnGEnnAgsbkVpg,380
+attr/exceptions.py,sha256=gmlET97ikqdQVvy7Ff9p7zVvqc2SsNtTd-r30pva1GE,1950
+attr/exceptions.pyi,sha256=zZq8bCUnKAy9mDtBEw42ZhPhAUIHoTKedDQInJD883M,539
+attr/filters.py,sha256=weDxwATsa69T_0bPVjiM1fGsciAMQmwhY5G8Jm5BxuI,1098
+attr/filters.pyi,sha256=xDpmKQlFdssgxGa5tsl1ADh_3zwAwAT4vUhd8h-8-Tk,214
+attr/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+attr/setters.py,sha256=0ElzHwdVK3dsYcQi2CXkFvhx8fNxUI5OVhw8SWeaKmA,1434
+attr/setters.pyi,sha256=SYr6adhx4f0dSkmmBICg6eK8WMev5jT-KJQJTdul078,567
+attr/validators.py,sha256=6DBx1jt4oZxx1ppvx6JWqm9-UAsYpXC4HTwxJilCeRg,11497
+attr/validators.pyi,sha256=vZgsJqUwrJevh4v_Hd7_RSXqDrBctE6-3AEZ7uYKodo,1868
+attrs-20.3.0.dist-info/AUTHORS.rst,sha256=wsqCNbGz_mklcJrt54APIZHZpoTIJLkXqEhhn4Nd8hc,752
+attrs-20.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+attrs-20.3.0.dist-info/LICENSE,sha256=v2WaKLSSQGAvVrvfSQy-LsUJsVuY-Z17GaUsdA4yeGM,1082
+attrs-20.3.0.dist-info/METADATA,sha256=2XTmALrRRbIZj9J8pJgpKYnyATu_NAL8vfUnqRFpE5w,10220
+attrs-20.3.0.dist-info/RECORD,,
+attrs-20.3.0.dist-info/WHEEL,sha256=ADKeyaGyKF5DwBNE0sRE5pvW-bSkFMJfBuhzZ3rceP4,110
+attrs-20.3.0.dist-info/top_level.txt,sha256=tlRYMddkRlKPqJ96wP2_j9uEsmcNHgD2SbuWd4CzGVU,5
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..6d38aa0601b31c7f4c47ff3016173426df4e1d53
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..66a062d889dea72f909b74ddc9e576cc68393fd6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/attrs-20.3.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+attr
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1bbbbe3bff592b2bc761772dc6974af4afb7035
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/__init__.py
@@ -0,0 +1,11 @@
+"""CacheControl import Interface.
+
+Make it easy to import from cachecontrol without long namespaces.
+"""
+__author__ = "Eric Larson"
+__email__ = "eric@ionrock.org"
+__version__ = "0.12.6"
+
+from .wrapper import CacheControl
+from .adapter import CacheControlAdapter
+from .controller import CacheController
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/_cmd.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/_cmd.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee8d60d101c6357c44c97421389d8d7b2ba63c09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/_cmd.py
@@ -0,0 +1,57 @@
+import logging
+
+import requests
+
+from cachecontrol.adapter import CacheControlAdapter
+from cachecontrol.cache import DictCache
+from cachecontrol.controller import logger
+
+from argparse import ArgumentParser
+
+
+def setup_logging():
+    logger.setLevel(logging.DEBUG)
+    handler = logging.StreamHandler()
+    logger.addHandler(handler)
+
+
+def get_session():
+    adapter = CacheControlAdapter(
+        DictCache(), cache_etags=True, serializer=None, heuristic=None
+    )
+    sess = requests.Session()
+    sess.mount("http://", adapter)
+    sess.mount("https://", adapter)
+
+    sess.cache_controller = adapter.controller
+    return sess
+
+
+def get_args():
+    parser = ArgumentParser()
+    parser.add_argument("url", help="The URL to try and cache")
+    return parser.parse_args()
+
+
+def main(args=None):
+    args = get_args()
+    sess = get_session()
+
+    # Make a request to get a response
+    resp = sess.get(args.url)
+
+    # Turn on logging
+    setup_logging()
+
+    # try setting the cache
+    sess.cache_controller.cache_response(resp.request, resp.raw)
+
+    # Now try to get it
+    if sess.cache_controller.cached_request(resp.request):
+        print("Cached!")
+    else:
+        print("Not cached :(")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/adapter.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/adapter.py
new file mode 100644
index 0000000000000000000000000000000000000000..de50006af4b9533d16dcae5a18d39a336019286f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/adapter.py
@@ -0,0 +1,133 @@
+import types
+import functools
+import zlib
+
+from requests.adapters import HTTPAdapter
+
+from .controller import CacheController
+from .cache import DictCache
+from .filewrapper import CallbackFileWrapper
+
+
+class CacheControlAdapter(HTTPAdapter):
+    invalidating_methods = {"PUT", "DELETE"}
+
+    def __init__(
+        self,
+        cache=None,
+        cache_etags=True,
+        controller_class=None,
+        serializer=None,
+        heuristic=None,
+        cacheable_methods=None,
+        *args,
+        **kw
+    ):
+        super(CacheControlAdapter, self).__init__(*args, **kw)
+        self.cache = DictCache() if cache is None else cache
+        self.heuristic = heuristic
+        self.cacheable_methods = cacheable_methods or ("GET",)
+
+        controller_factory = controller_class or CacheController
+        self.controller = controller_factory(
+            self.cache, cache_etags=cache_etags, serializer=serializer
+        )
+
+    def send(self, request, cacheable_methods=None, **kw):
+        """
+        Send a request. Use the request information to see if it
+        exists in the cache and cache the response if we need to and can.
+        """
+        cacheable = cacheable_methods or self.cacheable_methods
+        if request.method in cacheable:
+            try:
+                cached_response = self.controller.cached_request(request)
+            except zlib.error:
+                cached_response = None
+            if cached_response:
+                return self.build_response(request, cached_response, from_cache=True)
+
+            # check for etags and add headers if appropriate
+            request.headers.update(self.controller.conditional_headers(request))
+
+        resp = super(CacheControlAdapter, self).send(request, **kw)
+
+        return resp
+
+    def build_response(
+        self, request, response, from_cache=False, cacheable_methods=None
+    ):
+        """
+        Build a response by making a request or using the cache.
+
+        This will end up calling send and returning a potentially
+        cached response
+        """
+        cacheable = cacheable_methods or self.cacheable_methods
+        if not from_cache and request.method in cacheable:
+            # Check for any heuristics that might update headers
+            # before trying to cache.
+            if self.heuristic:
+                response = self.heuristic.apply(response)
+
+            # apply any expiration heuristics
+            if response.status == 304:
+                # We must have sent an ETag request. This could mean
+                # that we've been expired already or that we simply
+                # have an etag. In either case, we want to try and
+                # update the cache if that is the case.
+                cached_response = self.controller.update_cached_response(
+                    request, response
+                )
+
+                if cached_response is not response:
+                    from_cache = True
+
+                # We are done with the server response, read a
+                # possible response body (compliant servers will
+                # not return one, but we cannot be 100% sure) and
+                # release the connection back to the pool.
+                response.read(decode_content=False)
+                response.release_conn()
+
+                response = cached_response
+
+            # We always cache the 301 responses
+            elif response.status == 301:
+                self.controller.cache_response(request, response)
+            else:
+                # Wrap the response file with a wrapper that will cache the
+                #   response when the stream has been consumed.
+                response._fp = CallbackFileWrapper(
+                    response._fp,
+                    functools.partial(
+                        self.controller.cache_response, request, response
+                    ),
+                )
+                if response.chunked:
+                    super_update_chunk_length = response._update_chunk_length
+
+                    def _update_chunk_length(self):
+                        super_update_chunk_length()
+                        if self.chunk_left == 0:
+                            self._fp._close()
+
+                    response._update_chunk_length = types.MethodType(
+                        _update_chunk_length, response
+                    )
+
+        resp = super(CacheControlAdapter, self).build_response(request, response)
+
+        # See if we should invalidate the cache.
+        if request.method in self.invalidating_methods and resp.ok:
+            cache_url = self.controller.cache_url(request.url)
+            self.cache.delete(cache_url)
+
+        # Give the request a from_cache attr to let people use it
+        resp.from_cache = from_cache
+
+        return resp
+
+    def close(self):
+        self.cache.close()
+        super(CacheControlAdapter, self).close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/cache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..94e07732d91fdf38f4559da04db4221d26553d40
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/cache.py
@@ -0,0 +1,39 @@
+"""
+The cache object API for implementing caches. The default is a thread
+safe in-memory dictionary.
+"""
+from threading import Lock
+
+
+class BaseCache(object):
+
+    def get(self, key):
+        raise NotImplementedError()
+
+    def set(self, key, value):
+        raise NotImplementedError()
+
+    def delete(self, key):
+        raise NotImplementedError()
+
+    def close(self):
+        pass
+
+
+class DictCache(BaseCache):
+
+    def __init__(self, init_dict=None):
+        self.lock = Lock()
+        self.data = init_dict or {}
+
+    def get(self, key):
+        return self.data.get(key, None)
+
+    def set(self, key, value):
+        with self.lock:
+            self.data.update({key: value})
+
+    def delete(self, key):
+        with self.lock:
+            if key in self.data:
+                self.data.pop(key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e1658fa5e5e498bcfa84702ed1a53dfcec071ff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/__init__.py
@@ -0,0 +1,2 @@
+from .file_cache import FileCache  # noqa
+from .redis_cache import RedisCache  # noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/file_cache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/file_cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..607b9452428f4343a1a017dfd230b12456060543
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/file_cache.py
@@ -0,0 +1,146 @@
+import hashlib
+import os
+from textwrap import dedent
+
+from ..cache import BaseCache
+from ..controller import CacheController
+
+try:
+    FileNotFoundError
+except NameError:
+    # py2.X
+    FileNotFoundError = (IOError, OSError)
+
+
+def _secure_open_write(filename, fmode):
+    # We only want to write to this file, so open it in write only mode
+    flags = os.O_WRONLY
+
+    # os.O_CREAT | os.O_EXCL will fail if the file already exists, so we only
+    #  will open *new* files.
+    # We specify this because we want to ensure that the mode we pass is the
+    # mode of the file.
+    flags |= os.O_CREAT | os.O_EXCL
+
+    # Do not follow symlinks to prevent someone from making a symlink that
+    # we follow and insecurely open a cache file.
+    if hasattr(os, "O_NOFOLLOW"):
+        flags |= os.O_NOFOLLOW
+
+    # On Windows we'll mark this file as binary
+    if hasattr(os, "O_BINARY"):
+        flags |= os.O_BINARY
+
+    # Before we open our file, we want to delete any existing file that is
+    # there
+    try:
+        os.remove(filename)
+    except (IOError, OSError):
+        # The file must not exist already, so we can just skip ahead to opening
+        pass
+
+    # Open our file, the use of os.O_CREAT | os.O_EXCL will ensure that if a
+    # race condition happens between the os.remove and this line, that an
+    # error will be raised. Because we utilize a lockfile this should only
+    # happen if someone is attempting to attack us.
+    fd = os.open(filename, flags, fmode)
+    try:
+        return os.fdopen(fd, "wb")
+
+    except:
+        # An error occurred wrapping our FD in a file object
+        os.close(fd)
+        raise
+
+
+class FileCache(BaseCache):
+
+    def __init__(
+        self,
+        directory,
+        forever=False,
+        filemode=0o0600,
+        dirmode=0o0700,
+        use_dir_lock=None,
+        lock_class=None,
+    ):
+
+        if use_dir_lock is not None and lock_class is not None:
+            raise ValueError("Cannot use use_dir_lock and lock_class together")
+
+        try:
+            from lockfile import LockFile
+            from lockfile.mkdirlockfile import MkdirLockFile
+        except ImportError:
+            notice = dedent(
+                """
+            NOTE: In order to use the FileCache you must have
+            lockfile installed. You can install it via pip:
+              pip install lockfile
+            """
+            )
+            raise ImportError(notice)
+
+        else:
+            if use_dir_lock:
+                lock_class = MkdirLockFile
+
+            elif lock_class is None:
+                lock_class = LockFile
+
+        self.directory = directory
+        self.forever = forever
+        self.filemode = filemode
+        self.dirmode = dirmode
+        self.lock_class = lock_class
+
+    @staticmethod
+    def encode(x):
+        return hashlib.sha224(x.encode()).hexdigest()
+
+    def _fn(self, name):
+        # NOTE: This method should not change as some may depend on it.
+        #       See: https://github.com/ionrock/cachecontrol/issues/63
+        hashed = self.encode(name)
+        parts = list(hashed[:5]) + [hashed]
+        return os.path.join(self.directory, *parts)
+
+    def get(self, key):
+        name = self._fn(key)
+        try:
+            with open(name, "rb") as fh:
+                return fh.read()
+
+        except FileNotFoundError:
+            return None
+
+    def set(self, key, value):
+        name = self._fn(key)
+
+        # Make sure the directory exists
+        try:
+            os.makedirs(os.path.dirname(name), self.dirmode)
+        except (IOError, OSError):
+            pass
+
+        with self.lock_class(name) as lock:
+            # Write our actual file
+            with _secure_open_write(lock.path, self.filemode) as fh:
+                fh.write(value)
+
+    def delete(self, key):
+        name = self._fn(key)
+        if not self.forever:
+            try:
+                os.remove(name)
+            except FileNotFoundError:
+                pass
+
+
+def url_to_file_path(url, filecache):
+    """Return the file cache path based on the URL.
+
+    This does not ensure the file exists!
+    """
+    key = CacheController.cache_url(url)
+    return filecache._fn(key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/redis_cache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/redis_cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..16da0aed96893309a3b5b05725e2ac155db7a67e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/caches/redis_cache.py
@@ -0,0 +1,33 @@
+from __future__ import division
+
+from datetime import datetime
+from cachecontrol.cache import BaseCache
+
+
+class RedisCache(BaseCache):
+
+    def __init__(self, conn):
+        self.conn = conn
+
+    def get(self, key):
+        return self.conn.get(key)
+
+    def set(self, key, value, expires=None):
+        if not expires:
+            self.conn.set(key, value)
+        else:
+            expires = expires - datetime.utcnow()
+            self.conn.setex(key, int(expires.total_seconds()), value)
+
+    def delete(self, key):
+        self.conn.delete(key)
+
+    def clear(self):
+        """Helper for clearing all the keys in a database. Use with
+        caution!"""
+        for key in self.conn.keys():
+            self.conn.delete(key)
+
+    def close(self):
+        """Redis uses connection pooling, no need to close the connection."""
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..143c8ab08409f02d38b85a7fc3e8b4d0c7c5b448
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/compat.py
@@ -0,0 +1,29 @@
+try:
+    from urllib.parse import urljoin
+except ImportError:
+    from urlparse import urljoin
+
+
+try:
+    import cPickle as pickle
+except ImportError:
+    import pickle
+
+
+# Handle the case where the requests module has been patched to not have
+# urllib3 bundled as part of its source.
+try:
+    from requests.packages.urllib3.response import HTTPResponse
+except ImportError:
+    from urllib3.response import HTTPResponse
+
+try:
+    from requests.packages.urllib3.util import is_fp_closed
+except ImportError:
+    from urllib3.util import is_fp_closed
+
+# Replicate some six behaviour
+try:
+    text_type = unicode
+except NameError:
+    text_type = str
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/controller.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/controller.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5c4a50808baeded95191faa42c67722731aa06c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/controller.py
@@ -0,0 +1,376 @@
+"""
+The httplib2 algorithms ported for use with requests.
+"""
+import logging
+import re
+import calendar
+import time
+from email.utils import parsedate_tz
+
+from requests.structures import CaseInsensitiveDict
+
+from .cache import DictCache
+from .serialize import Serializer
+
+
+logger = logging.getLogger(__name__)
+
+URI = re.compile(r"^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?")
+
+
+def parse_uri(uri):
+    """Parses a URI using the regex given in Appendix B of RFC 3986.
+
+        (scheme, authority, path, query, fragment) = parse_uri(uri)
+    """
+    groups = URI.match(uri).groups()
+    return (groups[1], groups[3], groups[4], groups[6], groups[8])
+
+
+class CacheController(object):
+    """An interface to see if request should cached or not.
+    """
+
+    def __init__(
+        self, cache=None, cache_etags=True, serializer=None, status_codes=None
+    ):
+        self.cache = DictCache() if cache is None else cache
+        self.cache_etags = cache_etags
+        self.serializer = serializer or Serializer()
+        self.cacheable_status_codes = status_codes or (200, 203, 300, 301)
+
+    @classmethod
+    def _urlnorm(cls, uri):
+        """Normalize the URL to create a safe key for the cache"""
+        (scheme, authority, path, query, fragment) = parse_uri(uri)
+        if not scheme or not authority:
+            raise Exception("Only absolute URIs are allowed. uri = %s" % uri)
+
+        scheme = scheme.lower()
+        authority = authority.lower()
+
+        if not path:
+            path = "/"
+
+        # Could do syntax based normalization of the URI before
+        # computing the digest. See Section 6.2.2 of Std 66.
+        request_uri = query and "?".join([path, query]) or path
+        defrag_uri = scheme + "://" + authority + request_uri
+
+        return defrag_uri
+
+    @classmethod
+    def cache_url(cls, uri):
+        return cls._urlnorm(uri)
+
+    def parse_cache_control(self, headers):
+        known_directives = {
+            # https://tools.ietf.org/html/rfc7234#section-5.2
+            "max-age": (int, True),
+            "max-stale": (int, False),
+            "min-fresh": (int, True),
+            "no-cache": (None, False),
+            "no-store": (None, False),
+            "no-transform": (None, False),
+            "only-if-cached": (None, False),
+            "must-revalidate": (None, False),
+            "public": (None, False),
+            "private": (None, False),
+            "proxy-revalidate": (None, False),
+            "s-maxage": (int, True),
+        }
+
+        cc_headers = headers.get("cache-control", headers.get("Cache-Control", ""))
+
+        retval = {}
+
+        for cc_directive in cc_headers.split(","):
+            if not cc_directive.strip():
+                continue
+
+            parts = cc_directive.split("=", 1)
+            directive = parts[0].strip()
+
+            try:
+                typ, required = known_directives[directive]
+            except KeyError:
+                logger.debug("Ignoring unknown cache-control directive: %s", directive)
+                continue
+
+            if not typ or not required:
+                retval[directive] = None
+            if typ:
+                try:
+                    retval[directive] = typ(parts[1].strip())
+                except IndexError:
+                    if required:
+                        logger.debug(
+                            "Missing value for cache-control " "directive: %s",
+                            directive,
+                        )
+                except ValueError:
+                    logger.debug(
+                        "Invalid value for cache-control directive " "%s, must be %s",
+                        directive,
+                        typ.__name__,
+                    )
+
+        return retval
+
+    def cached_request(self, request):
+        """
+        Return a cached response if it exists in the cache, otherwise
+        return False.
+        """
+        cache_url = self.cache_url(request.url)
+        logger.debug('Looking up "%s" in the cache', cache_url)
+        cc = self.parse_cache_control(request.headers)
+
+        # Bail out if the request insists on fresh data
+        if "no-cache" in cc:
+            logger.debug('Request header has "no-cache", cache bypassed')
+            return False
+
+        if "max-age" in cc and cc["max-age"] == 0:
+            logger.debug('Request header has "max_age" as 0, cache bypassed')
+            return False
+
+        # Request allows serving from the cache, let's see if we find something
+        cache_data = self.cache.get(cache_url)
+        if cache_data is None:
+            logger.debug("No cache entry available")
+            return False
+
+        # Check whether it can be deserialized
+        resp = self.serializer.loads(request, cache_data)
+        if not resp:
+            logger.warning("Cache entry deserialization failed, entry ignored")
+            return False
+
+        # If we have a cached 301, return it immediately. We don't
+        # need to test our response for other headers b/c it is
+        # intrinsically "cacheable" as it is Permanent.
+        # See:
+        #   https://tools.ietf.org/html/rfc7231#section-6.4.2
+        #
+        # Client can try to refresh the value by repeating the request
+        # with cache busting headers as usual (ie no-cache).
+        if resp.status == 301:
+            msg = (
+                'Returning cached "301 Moved Permanently" response '
+                "(ignoring date and etag information)"
+            )
+            logger.debug(msg)
+            return resp
+
+        headers = CaseInsensitiveDict(resp.headers)
+        if not headers or "date" not in headers:
+            if "etag" not in headers:
+                # Without date or etag, the cached response can never be used
+                # and should be deleted.
+                logger.debug("Purging cached response: no date or etag")
+                self.cache.delete(cache_url)
+            logger.debug("Ignoring cached response: no date")
+            return False
+
+        now = time.time()
+        date = calendar.timegm(parsedate_tz(headers["date"]))
+        current_age = max(0, now - date)
+        logger.debug("Current age based on date: %i", current_age)
+
+        # TODO: There is an assumption that the result will be a
+        #       urllib3 response object. This may not be best since we
+        #       could probably avoid instantiating or constructing the
+        #       response until we know we need it.
+        resp_cc = self.parse_cache_control(headers)
+
+        # determine freshness
+        freshness_lifetime = 0
+
+        # Check the max-age pragma in the cache control header
+        if "max-age" in resp_cc:
+            freshness_lifetime = resp_cc["max-age"]
+            logger.debug("Freshness lifetime from max-age: %i", freshness_lifetime)
+
+        # If there isn't a max-age, check for an expires header
+        elif "expires" in headers:
+            expires = parsedate_tz(headers["expires"])
+            if expires is not None:
+                expire_time = calendar.timegm(expires) - date
+                freshness_lifetime = max(0, expire_time)
+                logger.debug("Freshness lifetime from expires: %i", freshness_lifetime)
+
+        # Determine if we are setting freshness limit in the
+        # request. Note, this overrides what was in the response.
+        if "max-age" in cc:
+            freshness_lifetime = cc["max-age"]
+            logger.debug(
+                "Freshness lifetime from request max-age: %i", freshness_lifetime
+            )
+
+        if "min-fresh" in cc:
+            min_fresh = cc["min-fresh"]
+            # adjust our current age by our min fresh
+            current_age += min_fresh
+            logger.debug("Adjusted current age from min-fresh: %i", current_age)
+
+        # Return entry if it is fresh enough
+        if freshness_lifetime > current_age:
+            logger.debug('The response is "fresh", returning cached response')
+            logger.debug("%i > %i", freshness_lifetime, current_age)
+            return resp
+
+        # we're not fresh. If we don't have an Etag, clear it out
+        if "etag" not in headers:
+            logger.debug('The cached response is "stale" with no etag, purging')
+            self.cache.delete(cache_url)
+
+        # return the original handler
+        return False
+
+    def conditional_headers(self, request):
+        cache_url = self.cache_url(request.url)
+        resp = self.serializer.loads(request, self.cache.get(cache_url))
+        new_headers = {}
+
+        if resp:
+            headers = CaseInsensitiveDict(resp.headers)
+
+            if "etag" in headers:
+                new_headers["If-None-Match"] = headers["ETag"]
+
+            if "last-modified" in headers:
+                new_headers["If-Modified-Since"] = headers["Last-Modified"]
+
+        return new_headers
+
+    def cache_response(self, request, response, body=None, status_codes=None):
+        """
+        Algorithm for caching requests.
+
+        This assumes a requests Response object.
+        """
+        # From httplib2: Don't cache 206's since we aren't going to
+        #                handle byte range requests
+        cacheable_status_codes = status_codes or self.cacheable_status_codes
+        if response.status not in cacheable_status_codes:
+            logger.debug(
+                "Status code %s not in %s", response.status, cacheable_status_codes
+            )
+            return
+
+        response_headers = CaseInsensitiveDict(response.headers)
+
+        # If we've been given a body, our response has a Content-Length, that
+        # Content-Length is valid then we can check to see if the body we've
+        # been given matches the expected size, and if it doesn't we'll just
+        # skip trying to cache it.
+        if (
+            body is not None
+            and "content-length" in response_headers
+            and response_headers["content-length"].isdigit()
+            and int(response_headers["content-length"]) != len(body)
+        ):
+            return
+
+        cc_req = self.parse_cache_control(request.headers)
+        cc = self.parse_cache_control(response_headers)
+
+        cache_url = self.cache_url(request.url)
+        logger.debug('Updating cache with response from "%s"', cache_url)
+
+        # Delete it from the cache if we happen to have it stored there
+        no_store = False
+        if "no-store" in cc:
+            no_store = True
+            logger.debug('Response header has "no-store"')
+        if "no-store" in cc_req:
+            no_store = True
+            logger.debug('Request header has "no-store"')
+        if no_store and self.cache.get(cache_url):
+            logger.debug('Purging existing cache entry to honor "no-store"')
+            self.cache.delete(cache_url)
+        if no_store:
+            return
+
+        # https://tools.ietf.org/html/rfc7234#section-4.1:
+        # A Vary header field-value of "*" always fails to match.
+        # Storing such a response leads to a deserialization warning
+        # during cache lookup and is not allowed to ever be served,
+        # so storing it can be avoided.
+        if "*" in response_headers.get("vary", ""):
+            logger.debug('Response header has "Vary: *"')
+            return
+
+        # If we've been given an etag, then keep the response
+        if self.cache_etags and "etag" in response_headers:
+            logger.debug("Caching due to etag")
+            self.cache.set(
+                cache_url, self.serializer.dumps(request, response, body=body)
+            )
+
+        # Add to the cache any 301s. We do this before looking that
+        # the Date headers.
+        elif response.status == 301:
+            logger.debug("Caching permanant redirect")
+            self.cache.set(cache_url, self.serializer.dumps(request, response))
+
+        # Add to the cache if the response headers demand it. If there
+        # is no date header then we can't do anything about expiring
+        # the cache.
+        elif "date" in response_headers:
+            # cache when there is a max-age > 0
+            if "max-age" in cc and cc["max-age"] > 0:
+                logger.debug("Caching b/c date exists and max-age > 0")
+                self.cache.set(
+                    cache_url, self.serializer.dumps(request, response, body=body)
+                )
+
+            # If the request can expire, it means we should cache it
+            # in the meantime.
+            elif "expires" in response_headers:
+                if response_headers["expires"]:
+                    logger.debug("Caching b/c of expires header")
+                    self.cache.set(
+                        cache_url, self.serializer.dumps(request, response, body=body)
+                    )
+
+    def update_cached_response(self, request, response):
+        """On a 304 we will get a new set of headers that we want to
+        update our cached value with, assuming we have one.
+
+        This should only ever be called when we've sent an ETag and
+        gotten a 304 as the response.
+        """
+        cache_url = self.cache_url(request.url)
+
+        cached_response = self.serializer.loads(request, self.cache.get(cache_url))
+
+        if not cached_response:
+            # we didn't have a cached response
+            return response
+
+        # Lets update our headers with the headers from the new request:
+        # http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-26#section-4.1
+        #
+        # The server isn't supposed to send headers that would make
+        # the cached body invalid. But... just in case, we'll be sure
+        # to strip out ones we know that might be problmatic due to
+        # typical assumptions.
+        excluded_headers = ["content-length"]
+
+        cached_response.headers.update(
+            dict(
+                (k, v)
+                for k, v in response.headers.items()
+                if k.lower() not in excluded_headers
+            )
+        )
+
+        # we want a 200 b/c we have content via the cache
+        cached_response.status = 200
+
+        # update our cache
+        self.cache.set(cache_url, self.serializer.dumps(request, cached_response))
+
+        return cached_response
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/filewrapper.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/filewrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..30ed4c5a62a99906ab662a8acfba2ab75e82af2e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/filewrapper.py
@@ -0,0 +1,80 @@
+from io import BytesIO
+
+
+class CallbackFileWrapper(object):
+    """
+    Small wrapper around a fp object which will tee everything read into a
+    buffer, and when that file is closed it will execute a callback with the
+    contents of that buffer.
+
+    All attributes are proxied to the underlying file object.
+
+    This class uses members with a double underscore (__) leading prefix so as
+    not to accidentally shadow an attribute.
+    """
+
+    def __init__(self, fp, callback):
+        self.__buf = BytesIO()
+        self.__fp = fp
+        self.__callback = callback
+
+    def __getattr__(self, name):
+        # The vaguaries of garbage collection means that self.__fp is
+        # not always set.  By using __getattribute__ and the private
+        # name[0] allows looking up the attribute value and raising an
+        # AttributeError when it doesn't exist. This stop thigns from
+        # infinitely recursing calls to getattr in the case where
+        # self.__fp hasn't been set.
+        #
+        # [0] https://docs.python.org/2/reference/expressions.html#atom-identifiers
+        fp = self.__getattribute__("_CallbackFileWrapper__fp")
+        return getattr(fp, name)
+
+    def __is_fp_closed(self):
+        try:
+            return self.__fp.fp is None
+
+        except AttributeError:
+            pass
+
+        try:
+            return self.__fp.closed
+
+        except AttributeError:
+            pass
+
+        # We just don't cache it then.
+        # TODO: Add some logging here...
+        return False
+
+    def _close(self):
+        if self.__callback:
+            self.__callback(self.__buf.getvalue())
+
+        # We assign this to None here, because otherwise we can get into
+        # really tricky problems where the CPython interpreter dead locks
+        # because the callback is holding a reference to something which
+        # has a __del__ method. Setting this to None breaks the cycle
+        # and allows the garbage collector to do it's thing normally.
+        self.__callback = None
+
+    def read(self, amt=None):
+        data = self.__fp.read(amt)
+        self.__buf.write(data)
+        if self.__is_fp_closed():
+            self._close()
+
+        return data
+
+    def _safe_read(self, amt):
+        data = self.__fp._safe_read(amt)
+        if amt == 2 and data == b"\r\n":
+            # urllib executes this read to toss the CRLF at the end
+            # of the chunk.
+            return data
+
+        self.__buf.write(data)
+        if self.__is_fp_closed():
+            self._close()
+
+        return data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/heuristics.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/heuristics.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c0e9790d5d0764f2ca005ae955d644bc2098d75
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/heuristics.py
@@ -0,0 +1,135 @@
+import calendar
+import time
+
+from email.utils import formatdate, parsedate, parsedate_tz
+
+from datetime import datetime, timedelta
+
+TIME_FMT = "%a, %d %b %Y %H:%M:%S GMT"
+
+
+def expire_after(delta, date=None):
+    date = date or datetime.utcnow()
+    return date + delta
+
+
+def datetime_to_header(dt):
+    return formatdate(calendar.timegm(dt.timetuple()))
+
+
+class BaseHeuristic(object):
+
+    def warning(self, response):
+        """
+        Return a valid 1xx warning header value describing the cache
+        adjustments.
+
+        The response is provided too allow warnings like 113
+        http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need
+        to explicitly say response is over 24 hours old.
+        """
+        return '110 - "Response is Stale"'
+
+    def update_headers(self, response):
+        """Update the response headers with any new headers.
+
+        NOTE: This SHOULD always include some Warning header to
+              signify that the response was cached by the client, not
+              by way of the provided headers.
+        """
+        return {}
+
+    def apply(self, response):
+        updated_headers = self.update_headers(response)
+
+        if updated_headers:
+            response.headers.update(updated_headers)
+            warning_header_value = self.warning(response)
+            if warning_header_value is not None:
+                response.headers.update({"Warning": warning_header_value})
+
+        return response
+
+
+class OneDayCache(BaseHeuristic):
+    """
+    Cache the response by providing an expires 1 day in the
+    future.
+    """
+
+    def update_headers(self, response):
+        headers = {}
+
+        if "expires" not in response.headers:
+            date = parsedate(response.headers["date"])
+            expires = expire_after(timedelta(days=1), date=datetime(*date[:6]))
+            headers["expires"] = datetime_to_header(expires)
+            headers["cache-control"] = "public"
+        return headers
+
+
+class ExpiresAfter(BaseHeuristic):
+    """
+    Cache **all** requests for a defined time period.
+    """
+
+    def __init__(self, **kw):
+        self.delta = timedelta(**kw)
+
+    def update_headers(self, response):
+        expires = expire_after(self.delta)
+        return {"expires": datetime_to_header(expires), "cache-control": "public"}
+
+    def warning(self, response):
+        tmpl = "110 - Automatically cached for %s. Response might be stale"
+        return tmpl % self.delta
+
+
+class LastModified(BaseHeuristic):
+    """
+    If there is no Expires header already, fall back on Last-Modified
+    using the heuristic from
+    http://tools.ietf.org/html/rfc7234#section-4.2.2
+    to calculate a reasonable value.
+
+    Firefox also does something like this per
+    https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ
+    http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397
+    Unlike mozilla we limit this to 24-hr.
+    """
+    cacheable_by_default_statuses = {
+        200, 203, 204, 206, 300, 301, 404, 405, 410, 414, 501
+    }
+
+    def update_headers(self, resp):
+        headers = resp.headers
+
+        if "expires" in headers:
+            return {}
+
+        if "cache-control" in headers and headers["cache-control"] != "public":
+            return {}
+
+        if resp.status not in self.cacheable_by_default_statuses:
+            return {}
+
+        if "date" not in headers or "last-modified" not in headers:
+            return {}
+
+        date = calendar.timegm(parsedate_tz(headers["date"]))
+        last_modified = parsedate(headers["last-modified"])
+        if date is None or last_modified is None:
+            return {}
+
+        now = time.time()
+        current_age = max(0, now - date)
+        delta = date - calendar.timegm(last_modified)
+        freshness_lifetime = max(0, min(delta / 10, 24 * 3600))
+        if freshness_lifetime <= current_age:
+            return {}
+
+        expires = date + freshness_lifetime
+        return {"expires": time.strftime(TIME_FMT, time.gmtime(expires))}
+
+    def warning(self, resp):
+        return None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/serialize.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/serialize.py
new file mode 100644
index 0000000000000000000000000000000000000000..572cf0e6c871c83bbc03124505c53e4af9ee60c5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/serialize.py
@@ -0,0 +1,188 @@
+import base64
+import io
+import json
+import zlib
+
+import msgpack
+from requests.structures import CaseInsensitiveDict
+
+from .compat import HTTPResponse, pickle, text_type
+
+
+def _b64_decode_bytes(b):
+    return base64.b64decode(b.encode("ascii"))
+
+
+def _b64_decode_str(s):
+    return _b64_decode_bytes(s).decode("utf8")
+
+
+class Serializer(object):
+
+    def dumps(self, request, response, body=None):
+        response_headers = CaseInsensitiveDict(response.headers)
+
+        if body is None:
+            body = response.read(decode_content=False)
+
+            # NOTE: 99% sure this is dead code. I'm only leaving it
+            #       here b/c I don't have a test yet to prove
+            #       it. Basically, before using
+            #       `cachecontrol.filewrapper.CallbackFileWrapper`,
+            #       this made an effort to reset the file handle. The
+            #       `CallbackFileWrapper` short circuits this code by
+            #       setting the body as the content is consumed, the
+            #       result being a `body` argument is *always* passed
+            #       into cache_response, and in turn,
+            #       `Serializer.dump`.
+            response._fp = io.BytesIO(body)
+
+        # NOTE: This is all a bit weird, but it's really important that on
+        #       Python 2.x these objects are unicode and not str, even when
+        #       they contain only ascii. The problem here is that msgpack
+        #       understands the difference between unicode and bytes and we
+        #       have it set to differentiate between them, however Python 2
+        #       doesn't know the difference. Forcing these to unicode will be
+        #       enough to have msgpack know the difference.
+        data = {
+            u"response": {
+                u"body": body,
+                u"headers": dict(
+                    (text_type(k), text_type(v)) for k, v in response.headers.items()
+                ),
+                u"status": response.status,
+                u"version": response.version,
+                u"reason": text_type(response.reason),
+                u"strict": response.strict,
+                u"decode_content": response.decode_content,
+            }
+        }
+
+        # Construct our vary headers
+        data[u"vary"] = {}
+        if u"vary" in response_headers:
+            varied_headers = response_headers[u"vary"].split(",")
+            for header in varied_headers:
+                header = text_type(header).strip()
+                header_value = request.headers.get(header, None)
+                if header_value is not None:
+                    header_value = text_type(header_value)
+                data[u"vary"][header] = header_value
+
+        return b",".join([b"cc=4", msgpack.dumps(data, use_bin_type=True)])
+
+    def loads(self, request, data):
+        # Short circuit if we've been given an empty set of data
+        if not data:
+            return
+
+        # Determine what version of the serializer the data was serialized
+        # with
+        try:
+            ver, data = data.split(b",", 1)
+        except ValueError:
+            ver = b"cc=0"
+
+        # Make sure that our "ver" is actually a version and isn't a false
+        # positive from a , being in the data stream.
+        if ver[:3] != b"cc=":
+            data = ver + data
+            ver = b"cc=0"
+
+        # Get the version number out of the cc=N
+        ver = ver.split(b"=", 1)[-1].decode("ascii")
+
+        # Dispatch to the actual load method for the given version
+        try:
+            return getattr(self, "_loads_v{}".format(ver))(request, data)
+
+        except AttributeError:
+            # This is a version we don't have a loads function for, so we'll
+            # just treat it as a miss and return None
+            return
+
+    def prepare_response(self, request, cached):
+        """Verify our vary headers match and construct a real urllib3
+        HTTPResponse object.
+        """
+        # Special case the '*' Vary value as it means we cannot actually
+        # determine if the cached response is suitable for this request.
+        # This case is also handled in the controller code when creating
+        # a cache entry, but is left here for backwards compatibility.
+        if "*" in cached.get("vary", {}):
+            return
+
+        # Ensure that the Vary headers for the cached response match our
+        # request
+        for header, value in cached.get("vary", {}).items():
+            if request.headers.get(header, None) != value:
+                return
+
+        body_raw = cached["response"].pop("body")
+
+        headers = CaseInsensitiveDict(data=cached["response"]["headers"])
+        if headers.get("transfer-encoding", "") == "chunked":
+            headers.pop("transfer-encoding")
+
+        cached["response"]["headers"] = headers
+
+        try:
+            body = io.BytesIO(body_raw)
+        except TypeError:
+            # This can happen if cachecontrol serialized to v1 format (pickle)
+            # using Python 2. A Python 2 str(byte string) will be unpickled as
+            # a Python 3 str (unicode string), which will cause the above to
+            # fail with:
+            #
+            #     TypeError: 'str' does not support the buffer interface
+            body = io.BytesIO(body_raw.encode("utf8"))
+
+        return HTTPResponse(body=body, preload_content=False, **cached["response"])
+
+    def _loads_v0(self, request, data):
+        # The original legacy cache data. This doesn't contain enough
+        # information to construct everything we need, so we'll treat this as
+        # a miss.
+        return
+
+    def _loads_v1(self, request, data):
+        try:
+            cached = pickle.loads(data)
+        except ValueError:
+            return
+
+        return self.prepare_response(request, cached)
+
+    def _loads_v2(self, request, data):
+        try:
+            cached = json.loads(zlib.decompress(data).decode("utf8"))
+        except (ValueError, zlib.error):
+            return
+
+        # We need to decode the items that we've base64 encoded
+        cached["response"]["body"] = _b64_decode_bytes(cached["response"]["body"])
+        cached["response"]["headers"] = dict(
+            (_b64_decode_str(k), _b64_decode_str(v))
+            for k, v in cached["response"]["headers"].items()
+        )
+        cached["response"]["reason"] = _b64_decode_str(cached["response"]["reason"])
+        cached["vary"] = dict(
+            (_b64_decode_str(k), _b64_decode_str(v) if v is not None else v)
+            for k, v in cached["vary"].items()
+        )
+
+        return self.prepare_response(request, cached)
+
+    def _loads_v3(self, request, data):
+        # Due to Python 2 encoding issues, it's impossible to know for sure
+        # exactly how to load v3 entries, thus we'll treat these as a miss so
+        # that they get rewritten out as v4 entries.
+        return
+
+    def _loads_v4(self, request, data):
+        try:
+            cached = msgpack.loads(data, raw=False)
+        except ValueError:
+            return
+
+        return self.prepare_response(request, cached)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/wrapper.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..d8e6fc6a9e3bbe8b9b3c032298deb08e764d32f8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cachecontrol/wrapper.py
@@ -0,0 +1,29 @@
+from .adapter import CacheControlAdapter
+from .cache import DictCache
+
+
+def CacheControl(
+    sess,
+    cache=None,
+    cache_etags=True,
+    serializer=None,
+    heuristic=None,
+    controller_class=None,
+    adapter_class=None,
+    cacheable_methods=None,
+):
+
+    cache = DictCache() if cache is None else cache
+    adapter_class = adapter_class or CacheControlAdapter
+    adapter = adapter_class(
+        cache,
+        cache_etags=cache_etags,
+        serializer=serializer,
+        heuristic=heuristic,
+        controller_class=controller_class,
+        cacheable_methods=cacheable_methods,
+    )
+    sess.mount("http://", adapter)
+    sess.mount("https://", adapter)
+
+    return sess
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..e897b3d8335b63a805b5bc59da1446fca1a95730
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/METADATA
@@ -0,0 +1,74 @@
+Metadata-Version: 2.1
+Name: certifi
+Version: 2019.11.28
+Summary: Python package for providing Mozilla's CA Bundle.
+Home-page: https://certifi.io/
+Author: Kenneth Reitz
+Author-email: me@kennethreitz.com
+License: MPL-2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+
+Certifi: Python SSL Certificates
+================================
+
+`Certifi`_ is a carefully curated collection of Root Certificates for
+validating the trustworthiness of SSL certificates while verifying the identity
+of TLS hosts. It has been extracted from the `Requests`_ project.
+
+Installation
+------------
+
+``certifi`` is available on PyPI. Simply install it with ``pip``::
+
+    $ pip install certifi
+
+Usage
+-----
+
+To reference the installed certificate authority (CA) bundle, you can use the
+built-in function::
+
+    >>> import certifi
+
+    >>> certifi.where()
+    '/usr/local/lib/python2.7/site-packages/certifi/cacert.pem'
+
+Or from the command line::
+
+    $ python -m certifi
+    /usr/local/lib/python2.7/site-packages/certifi/cacert.pem
+
+Enjoy!
+
+1024-bit Root Certificates
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Browsers and certificate authorities have concluded that 1024-bit keys are
+unacceptably weak for certificates, particularly root certificates. For this
+reason, Mozilla has removed any weak (i.e. 1024-bit key) certificate from its
+bundle, replacing it with an equivalent strong (i.e. 2048-bit or greater key)
+certificate from the same CA. Because Mozilla removed these certificates from
+its bundle, ``certifi`` removed them as well.
+
+In previous versions, ``certifi`` provided the ``certifi.old_where()`` function
+to intentionally re-add the 1024-bit roots back into your bundle. This was not
+recommended in production and therefore was removed at the end of 2018.
+
+.. _`Certifi`: https://certifi.io/en/latest/
+.. _`Requests`: http://docs.python-requests.org/en/latest/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..1d4830a1cc31e9092b9f8abd4f5b3f73de935bfa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/RECORD
@@ -0,0 +1,17 @@
+certifi/__init__.py,sha256=JVwzDhkMttyVVtfNDrU_i0v2a-WmtEBXq0Z8oz4Ghzk,52
+certifi/__main__.py,sha256=FiOYt1Fltst7wk9DRa6GCoBr8qBUxlNQu_MKJf04E6s,41
+certifi/cacert.pem,sha256=cyvv5Jx1gHACNEj2GaOrsIj0Tk8FmSvHR42uhzvlatg,281457
+certifi/core.py,sha256=u_450edAVoiZrgqi6k3Sekcvs-B1zD_hTeE6UJ2OcQ4,225
+certifi-2019.11.28.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+certifi-2019.11.28.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+certifi-2019.11.28.dist-info/METADATA,sha256=K6ioZZT9N0bRETHmncjK-UJKAFIVF26h1F31dfDaV5k,2523
+certifi-2019.11.28.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+certifi-2019.11.28.dist-info/top_level.txt,sha256=KMu4vUCfsjLrkPbSNdgdekS-pVJzBAJFO__nI8NF6-U,8
+certifi-2019.11.28.dist-info/RECORD,,
+certifi-2019.11.28.dist-info/__pycache__,,
+certifi-2019.11.28.virtualenv,,
+certifi/__init__.cpython-38.pyc,,
+certifi/core.cpython-38.pyc,,
+certifi-2019.11.28.dist-info/INSTALLER,,
+certifi/__main__.cpython-38.pyc,,
+certifi/__pycache__,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..963eac530b9bc28d704d1bc410299c68e3216d4d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.dist-info/top_level.txt
@@ -0,0 +1 @@
+certifi
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi-2019.11.28.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d59a05630e7ff963947b2596194d12248a41863
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__init__.py
@@ -0,0 +1,3 @@
+from .core import where
+
+__version__ = "2019.11.28"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__main__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f1da0dd0c201e8aedc1552ef82a1780eb37276d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/__main__.py
@@ -0,0 +1,2 @@
+from certifi import where
+print(where())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/cacert.pem b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/cacert.pem
new file mode 100644
index 0000000000000000000000000000000000000000..a4758ef3afb0b0299485e759d9a8c5e4747fc96d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/cacert.pem
@@ -0,0 +1,4602 @@
+
+# Issuer: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Subject: CN=GlobalSign Root CA O=GlobalSign nv-sa OU=Root CA
+# Label: "GlobalSign Root CA"
+# Serial: 4835703278459707669005204
+# MD5 Fingerprint: 3e:45:52:15:09:51:92:e1:b7:5d:37:9f:b1:87:29:8a
+# SHA1 Fingerprint: b1:bc:96:8b:d4:f4:9d:62:2a:a8:9a:81:f2:15:01:52:a4:1d:82:9c
+# SHA256 Fingerprint: eb:d4:10:40:e4:bb:3e:c7:42:c9:e3:81:d3:1e:f2:a4:1a:48:b6:68:5c:96:e7:ce:f3:c1:df:6c:d4:33:1c:99
+-----BEGIN CERTIFICATE-----
+MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
+A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
+b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
+MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
+YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
+aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
+jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
+xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
+1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
+snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
+U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
+9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
+BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
+AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
+yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
+38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
+AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
+DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
+HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R2
+# Label: "GlobalSign Root CA - R2"
+# Serial: 4835703278459682885658125
+# MD5 Fingerprint: 94:14:77:7e:3e:5e:fd:8f:30:bd:41:b0:cf:e7:d0:30
+# SHA1 Fingerprint: 75:e0:ab:b6:13:85:12:27:1c:04:f8:5f:dd:de:38:e4:b7:24:2e:fe
+# SHA256 Fingerprint: ca:42:dd:41:74:5f:d0:b8:1e:b9:02:36:2c:f9:d8:bf:71:9d:a1:bd:1b:1e:fc:94:6f:5b:4c:99:f4:2c:1b:9e
+-----BEGIN CERTIFICATE-----
+MIIDujCCAqKgAwIBAgILBAAAAAABD4Ym5g0wDQYJKoZIhvcNAQEFBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjIxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDYxMjE1MDgwMDAwWhcNMjExMjE1
+MDgwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMjETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAKbPJA6+Lm8omUVCxKs+IVSbC9N/hHD6ErPL
+v4dfxn+G07IwXNb9rfF73OX4YJYJkhD10FPe+3t+c4isUoh7SqbKSaZeqKeMWhG8
+eoLrvozps6yWJQeXSpkqBy+0Hne/ig+1AnwblrjFuTosvNYSuetZfeLQBoZfXklq
+tTleiDTsvHgMCJiEbKjNS7SgfQx5TfC4LcshytVsW33hoCmEofnTlEnLJGKRILzd
+C9XZzPnqJworc5HGnRusyMvo4KD0L5CLTfuwNhv2GXqF4G3yYROIXJ/gkwpRl4pa
+zq+r1feqCapgvdzZX99yqWATXgAByUr6P6TqBwMhAo6CygPCm48CAwEAAaOBnDCB
+mTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUm+IH
+V2ccHsBqBt5ZtJot39wZhi4wNgYDVR0fBC8wLTAroCmgJ4YlaHR0cDovL2NybC5n
+bG9iYWxzaWduLm5ldC9yb290LXIyLmNybDAfBgNVHSMEGDAWgBSb4gdXZxwewGoG
+3lm0mi3f3BmGLjANBgkqhkiG9w0BAQUFAAOCAQEAmYFThxxol4aR7OBKuEQLq4Gs
+J0/WwbgcQ3izDJr86iw8bmEbTUsp9Z8FHSbBuOmDAGJFtqkIk7mpM0sYmsL4h4hO
+291xNBrBVNpGP+DTKqttVCL1OmLNIG+6KYnX3ZHu01yiPqFbQfXf5WRDLenVOavS
+ot+3i9DAgBkcRcAtjOj4LaR0VknFBbVPFd5uRHg5h6h+u/N5GJG79G+dwfCMNYxd
+AfvDbbnvRG15RjF+Cv6pgsH/76tuIMRQyV+dTZsXjAzlAcmgQWpzU/qlULRuJQ/7
+TBj0/VLZjmmx6BEP3ojY+x1J96relc8geMJgEtslQIxq/H5COEBkEveegeGTLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G3 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 1999 VeriSign, Inc. - For authorized use only
+# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G3 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 1999 VeriSign, Inc. - For authorized use only
+# Label: "Verisign Class 3 Public Primary Certification Authority - G3"
+# Serial: 206684696279472310254277870180966723415
+# MD5 Fingerprint: cd:68:b6:a7:c7:c4:ce:75:e0:1d:4f:57:44:61:92:09
+# SHA1 Fingerprint: 13:2d:0d:45:53:4b:69:97:cd:b2:d5:c3:39:e2:55:76:60:9b:5c:c6
+# SHA256 Fingerprint: eb:04:cf:5e:b1:f3:9a:fa:76:2f:2b:b1:20:f2:96:cb:a5:20:c1:b9:7d:b1:58:95:65:b8:1c:b9:a1:7b:72:44
+-----BEGIN CERTIFICATE-----
+MIIEGjCCAwICEQCbfgZJoz5iudXukEhxKe9XMA0GCSqGSIb3DQEBBQUAMIHKMQsw
+CQYDVQQGEwJVUzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZl
+cmlTaWduIFRydXN0IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAxOTk5IFZlcmlTaWdu
+LCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxRTBDBgNVBAMTPFZlcmlT
+aWduIENsYXNzIDMgUHVibGljIFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3Jp
+dHkgLSBHMzAeFw05OTEwMDEwMDAwMDBaFw0zNjA3MTYyMzU5NTlaMIHKMQswCQYD
+VQQGEwJVUzEXMBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZlcmlT
+aWduIFRydXN0IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAxOTk5IFZlcmlTaWduLCBJ
+bmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxRTBDBgNVBAMTPFZlcmlTaWdu
+IENsYXNzIDMgUHVibGljIFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkg
+LSBHMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMu6nFL8eB8aHm8b
+N3O9+MlrlBIwT/A2R/XQkQr1F8ilYcEWQE37imGQ5XYgwREGfassbqb1EUGO+i2t
+KmFZpGcmTNDovFJbcCAEWNF6yaRpvIMXZK0Fi7zQWM6NjPXr8EJJC52XJ2cybuGu
+kxUccLwgTS8Y3pKI6GyFVxEa6X7jJhFUokWWVYPKMIno3Nij7SqAP395ZVc+FSBm
+CC+Vk7+qRy+oRpfwEuL+wgorUeZ25rdGt+INpsyow0xZVYnm6FNcHOqd8GIWC6fJ
+Xwzw3sJ2zq/3avL6QaaiMxTJ5Xpj055iN9WFZZ4O5lMkdBteHRJTW8cs54NJOxWu
+imi5V5cCAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAERSWwauSCPc/L8my/uRan2Te
+2yFPhpk0djZX3dAVL8WtfxUfN2JzPtTnX84XA9s1+ivbrmAJXx5fj267Cz3qWhMe
+DGBvtcC1IyIuBwvLqXTLR7sdwdela8wv0kL9Sd2nic9TutoAWii/gt/4uhMdUIaC
+/Y4wjylGsB49Ndo4YhYYSq3mtlFs3q9i6wHQHiT+eo8SGhJouPtmmRQURVyu565p
+F4ErWjfJXir0xuKhXFSbplQAz/DxwceYMBo7Nhbbo27q/a2ywtrvAkcTisDxszGt
+TxzhT5yvDwyd93gN2PQ1VoDat20Xj50egWTh/sVFuq1ruQp6Tk9LhO5L8X3dEQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Subject: CN=Entrust.net Certification Authority (2048) O=Entrust.net OU=www.entrust.net/CPS_2048 incorp. by ref. (limits liab.)/(c) 1999 Entrust.net Limited
+# Label: "Entrust.net Premium 2048 Secure Server CA"
+# Serial: 946069240
+# MD5 Fingerprint: ee:29:31:bc:32:7e:9a:e6:e8:b5:f7:51:b4:34:71:90
+# SHA1 Fingerprint: 50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31
+# SHA256 Fingerprint: 6d:c4:71:72:e0:1c:bc:b0:bf:62:58:0d:89:5f:e2:b8:ac:9a:d4:f8:73:80:1e:0c:10:b9:c8:37:d2:1e:b1:77
+-----BEGIN CERTIFICATE-----
+MIIEKjCCAxKgAwIBAgIEOGPe+DANBgkqhkiG9w0BAQUFADCBtDEUMBIGA1UEChML
+RW50cnVzdC5uZXQxQDA+BgNVBAsUN3d3dy5lbnRydXN0Lm5ldC9DUFNfMjA0OCBp
+bmNvcnAuIGJ5IHJlZi4gKGxpbWl0cyBsaWFiLikxJTAjBgNVBAsTHChjKSAxOTk5
+IEVudHJ1c3QubmV0IExpbWl0ZWQxMzAxBgNVBAMTKkVudHJ1c3QubmV0IENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5ICgyMDQ4KTAeFw05OTEyMjQxNzUwNTFaFw0yOTA3
+MjQxNDE1MTJaMIG0MRQwEgYDVQQKEwtFbnRydXN0Lm5ldDFAMD4GA1UECxQ3d3d3
+LmVudHJ1c3QubmV0L0NQU18yMDQ4IGluY29ycC4gYnkgcmVmLiAobGltaXRzIGxp
+YWIuKTElMCMGA1UECxMcKGMpIDE5OTkgRW50cnVzdC5uZXQgTGltaXRlZDEzMDEG
+A1UEAxMqRW50cnVzdC5uZXQgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgKDIwNDgp
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArU1LqRKGsuqjIAcVFmQq
+K0vRvwtKTY7tgHalZ7d4QMBzQshowNtTK91euHaYNZOLGp18EzoOH1u3Hs/lJBQe
+sYGpjX24zGtLA/ECDNyrpUAkAH90lKGdCCmziAv1h3edVc3kw37XamSrhRSGlVuX
+MlBvPci6Zgzj/L24ScF2iUkZ/cCovYmjZy/Gn7xxGWC4LeksyZB2ZnuU4q941mVT
+XTzWnLLPKQP5L6RQstRIzgUyVYr9smRMDuSYB3Xbf9+5CFVghTAp+XtIpGmG4zU/
+HoZdenoVve8AjhUiVBcAkCaTvA5JaJG/+EfTnZVCwQ5N328mz8MYIWJmQ3DW1cAH
+4QIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUVeSB0RGAvtiJuQijMfmhJAkWuXAwDQYJKoZIhvcNAQEFBQADggEBADub
+j1abMOdTmXx6eadNl9cZlZD7Bh/KM3xGY4+WZiT6QBshJ8rmcnPyT/4xmf3IDExo
+U8aAghOY+rat2l098c5u9hURlIIM7j+VrxGrD9cv3h8Dj1csHsm7mhpElesYT6Yf
+zX1XEC+bBAlahLVu2B064dae0Wx5XnkcFMXj0EyTO2U87d89vqbllRrDtRnDvV5b
+u/8j72gZyxKTJ1wDLW8w0B62GqzeWvfRqqgnpv55gcR5mTNXuhKwqeBCbJPKVt7+
+bYQLCIt+jerXmCHG8+c8eS9enNFMFY3h7CI3zJpDC5fcgJCNs2ebb0gIFVbPv/Er
+fF6adulZkMV8gzURZVE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Subject: CN=Baltimore CyberTrust Root O=Baltimore OU=CyberTrust
+# Label: "Baltimore CyberTrust Root"
+# Serial: 33554617
+# MD5 Fingerprint: ac:b6:94:a5:9c:17:e0:d7:91:52:9b:b1:97:06:a6:e4
+# SHA1 Fingerprint: d4:de:20:d0:5e:66:fc:53:fe:1a:50:88:2c:78:db:28:52:ca:e4:74
+# SHA256 Fingerprint: 16:af:57:a9:f6:76:b0:ab:12:60:95:aa:5e:ba:de:f2:2a:b3:11:19:d6:44:ac:95:cd:4b:93:db:f3:f2:6a:eb
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIEAgAAuTANBgkqhkiG9w0BAQUFADBaMQswCQYDVQQGEwJJ
+RTESMBAGA1UEChMJQmFsdGltb3JlMRMwEQYDVQQLEwpDeWJlclRydXN0MSIwIAYD
+VQQDExlCYWx0aW1vcmUgQ3liZXJUcnVzdCBSb290MB4XDTAwMDUxMjE4NDYwMFoX
+DTI1MDUxMjIzNTkwMFowWjELMAkGA1UEBhMCSUUxEjAQBgNVBAoTCUJhbHRpbW9y
+ZTETMBEGA1UECxMKQ3liZXJUcnVzdDEiMCAGA1UEAxMZQmFsdGltb3JlIEN5YmVy
+VHJ1c3QgUm9vdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKMEuyKr
+mD1X6CZymrV51Cni4eiVgLGw41uOKymaZN+hXe2wCQVt2yguzmKiYv60iNoS6zjr
+IZ3AQSsBUnuId9Mcj8e6uYi1agnnc+gRQKfRzMpijS3ljwumUNKoUMMo6vWrJYeK
+mpYcqWe4PwzV9/lSEy/CG9VwcPCPwBLKBsua4dnKM3p31vjsufFoREJIE9LAwqSu
+XmD+tqYF/LTdB1kC1FkYmGP1pWPgkAx9XbIGevOF6uvUA65ehD5f/xXtabz5OTZy
+dc93Uk3zyZAsuT3lySNTPx8kmCFcB5kpvcY67Oduhjprl3RjM71oGDHweI12v/ye
+jl0qhqdNkNwnGjkCAwEAAaNFMEMwHQYDVR0OBBYEFOWdWTCCR1jMrPoIVDaGezq1
+BE3wMBIGA1UdEwEB/wQIMAYBAf8CAQMwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3
+DQEBBQUAA4IBAQCFDF2O5G9RaEIFoN27TyclhAO992T9Ldcw46QQF+vaKSm2eT92
+9hkTI7gQCvlYpNRhcL0EYWoSihfVCr3FvDB81ukMJY2GQE/szKN+OMY3EU/t3Wgx
+jkzSswF07r51XgdIGn9w/xZchMB5hbgF/X++ZRGjD8ACtPhSNzkE1akxehi/oCr0
+Epn3o0WC4zxe9Z2etciefC7IpJ5OCBRLbf1wbWsaY71k5h+3zvDyny67G7fyUIhz
+ksLi4xaNmjICq44Y3ekQEe5+NauQrz4wlHrQMz2nZQ/1/I6eYs9HRCwBXbsdtTLS
+R9I4LtD+gdwyah617jzV/OeBHRnDJELqYzmp
+-----END CERTIFICATE-----
+
+# Issuer: CN=AddTrust External CA Root O=AddTrust AB OU=AddTrust External TTP Network
+# Subject: CN=AddTrust External CA Root O=AddTrust AB OU=AddTrust External TTP Network
+# Label: "AddTrust External Root"
+# Serial: 1
+# MD5 Fingerprint: 1d:35:54:04:85:78:b0:3f:42:42:4d:bf:20:73:0a:3f
+# SHA1 Fingerprint: 02:fa:f3:e2:91:43:54:68:60:78:57:69:4d:f5:e4:5b:68:85:18:68
+# SHA256 Fingerprint: 68:7f:a4:51:38:22:78:ff:f0:c8:b1:1f:8d:43:d5:76:67:1c:6e:b2:bc:ea:b4:13:fb:83:d9:65:d0:6d:2f:f2
+-----BEGIN CERTIFICATE-----
+MIIENjCCAx6gAwIBAgIBATANBgkqhkiG9w0BAQUFADBvMQswCQYDVQQGEwJTRTEU
+MBIGA1UEChMLQWRkVHJ1c3QgQUIxJjAkBgNVBAsTHUFkZFRydXN0IEV4dGVybmFs
+IFRUUCBOZXR3b3JrMSIwIAYDVQQDExlBZGRUcnVzdCBFeHRlcm5hbCBDQSBSb290
+MB4XDTAwMDUzMDEwNDgzOFoXDTIwMDUzMDEwNDgzOFowbzELMAkGA1UEBhMCU0Ux
+FDASBgNVBAoTC0FkZFRydXN0IEFCMSYwJAYDVQQLEx1BZGRUcnVzdCBFeHRlcm5h
+bCBUVFAgTmV0d29yazEiMCAGA1UEAxMZQWRkVHJ1c3QgRXh0ZXJuYWwgQ0EgUm9v
+dDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALf3GjPm8gAELTngTlvt
+H7xsD821+iO2zt6bETOXpClMfZOfvUq8k+0DGuOPz+VtUFrWlymUWoCwSXrbLpX9
+uMq/NzgtHj6RQa1wVsfwTz/oMp50ysiQVOnGXw94nZpAPA6sYapeFI+eh6FqUNzX
+mk6vBbOmcZSccbNQYArHE504B4YCqOmoaSYYkKtMsE8jqzpPhNjfzp/haW+710LX
+a0Tkx63ubUFfclpxCDezeWWkWaCUN/cALw3CknLa0Dhy2xSoRcRdKn23tNbE7qzN
+E0S3ySvdQwAl+mG5aWpYIxG3pzOPVnVZ9c0p10a3CitlttNCbxWyuHv77+ldU9U0
+WicCAwEAAaOB3DCB2TAdBgNVHQ4EFgQUrb2YejS0Jvf6xCZU7wO94CTLVBowCwYD
+VR0PBAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wgZkGA1UdIwSBkTCBjoAUrb2YejS0
+Jvf6xCZU7wO94CTLVBqhc6RxMG8xCzAJBgNVBAYTAlNFMRQwEgYDVQQKEwtBZGRU
+cnVzdCBBQjEmMCQGA1UECxMdQWRkVHJ1c3QgRXh0ZXJuYWwgVFRQIE5ldHdvcmsx
+IjAgBgNVBAMTGUFkZFRydXN0IEV4dGVybmFsIENBIFJvb3SCAQEwDQYJKoZIhvcN
+AQEFBQADggEBALCb4IUlwtYj4g+WBpKdQZic2YR5gdkeWxQHIzZlj7DYd7usQWxH
+YINRsPkyPef89iYTx4AWpb9a/IfPeHmJIZriTAcKhjW88t5RxNKWt9x+Tu5w/Rw5
+6wwCURQtjr0W4MHfRnXnJK3s9EK0hZNwEGe6nQY1ShjTK3rMUUKhemPR5ruhxSvC
+Nr4TDea9Y355e6cJDUCrat2PisP29owaQgVR1EX1n6diIWgVIEM8med8vSTYqZEX
+c4g/VhsxOBi0cQ+azcgOno4uG+GMmIPLHzHxREzGBHNJdmAPx/i9F4BrLunMTA5a
+mnkPIAou1Z5jJh5VkpTYghdae9C8x49OhgQ=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Subject: CN=Entrust Root Certification Authority O=Entrust, Inc. OU=www.entrust.net/CPS is incorporated by reference/(c) 2006 Entrust, Inc.
+# Label: "Entrust Root Certification Authority"
+# Serial: 1164660820
+# MD5 Fingerprint: d6:a5:c3:ed:5d:dd:3e:00:c1:3d:87:92:1f:1d:3f:e4
+# SHA1 Fingerprint: b3:1e:b1:b7:40:e3:6c:84:02:da:dc:37:d4:4d:f5:d4:67:49:52:f9
+# SHA256 Fingerprint: 73:c1:76:43:4f:1b:c6:d5:ad:f4:5b:0e:76:e7:27:28:7c:8d:e5:76:16:c1:e6:e6:14:1a:2b:2c:bc:7d:8e:4c
+-----BEGIN CERTIFICATE-----
+MIIEkTCCA3mgAwIBAgIERWtQVDANBgkqhkiG9w0BAQUFADCBsDELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xOTA3BgNVBAsTMHd3dy5lbnRydXN0
+Lm5ldC9DUFMgaXMgaW5jb3Jwb3JhdGVkIGJ5IHJlZmVyZW5jZTEfMB0GA1UECxMW
+KGMpIDIwMDYgRW50cnVzdCwgSW5jLjEtMCsGA1UEAxMkRW50cnVzdCBSb290IENl
+cnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA2MTEyNzIwMjM0MloXDTI2MTEyNzIw
+NTM0MlowgbAxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMTkw
+NwYDVQQLEzB3d3cuZW50cnVzdC5uZXQvQ1BTIGlzIGluY29ycG9yYXRlZCBieSBy
+ZWZlcmVuY2UxHzAdBgNVBAsTFihjKSAyMDA2IEVudHJ1c3QsIEluYy4xLTArBgNV
+BAMTJEVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASIwDQYJ
+KoZIhvcNAQEBBQADggEPADCCAQoCggEBALaVtkNC+sZtKm9I35RMOVcF7sN5EUFo
+Nu3s/poBj6E4KPz3EEZmLk0eGrEaTsbRwJWIsMn/MYszA9u3g3s+IIRe7bJWKKf4
+4LlAcTfFy0cOlypowCKVYhXbR9n10Cv/gkvJrT7eTNuQgFA/CYqEAOwwCj0Yzfv9
+KlmaI5UXLEWeH25DeW0MXJj+SKfFI0dcXv1u5x609mhF0YaDW6KKjbHjKYD+JXGI
+rb68j6xSlkuqUY3kEzEZ6E5Nn9uss2rVvDlUccp6en+Q3X0dgNmBu1kmwhH+5pPi
+94DkZfs0Nw4pgHBNrziGLp5/V6+eF67rHMsoIV+2HNjnogQi+dPa2MsCAwEAAaOB
+sDCBrTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zArBgNVHRAEJDAi
+gA8yMDA2MTEyNzIwMjM0MlqBDzIwMjYxMTI3MjA1MzQyWjAfBgNVHSMEGDAWgBRo
+kORnpKZTgMeGZqTx90tD+4S9bTAdBgNVHQ4EFgQUaJDkZ6SmU4DHhmak8fdLQ/uE
+vW0wHQYJKoZIhvZ9B0EABBAwDhsIVjcuMTo0LjADAgSQMA0GCSqGSIb3DQEBBQUA
+A4IBAQCT1DCw1wMgKtD5Y+iRDAUgqV8ZyntyTtSx29CW+1RaGSwMCPeyvIWonX9t
+O1KzKtvn1ISMY/YPyyYBkVBs9F8U4pN0wBOeMDpQ47RgxRzwIkSNcUesyBrJ6Zua
+AGAT/3B+XxFNSRuzFVJ7yVTav52Vr2ua2J7p8eRDjeIRRDq/r72DQnNSi6q7pynP
+9WQcCk3RvKqsnyrQ/39/2n3qse0wJcGE2jTSW3iDVuycNsMm4hH2Z0kdkquM++v/
+eu6FSqdQgPCnXEqULl8FmTxSQeDNtGPPAUO6nIPcj2A781q0tHuu2guQOHXvgR1m
+0vdXcDazv/wor3ElhVsT/h5/WrQ8
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Global CA O=GeoTrust Inc.
+# Subject: CN=GeoTrust Global CA O=GeoTrust Inc.
+# Label: "GeoTrust Global CA"
+# Serial: 144470
+# MD5 Fingerprint: f7:75:ab:29:fb:51:4e:b7:77:5e:ff:05:3c:99:8e:f5
+# SHA1 Fingerprint: de:28:f4:a4:ff:e5:b9:2f:a3:c5:03:d1:a3:49:a7:f9:96:2a:82:12
+# SHA256 Fingerprint: ff:85:6a:2d:25:1d:cd:88:d3:66:56:f4:50:12:67:98:cf:ab:aa:de:40:79:9c:72:2d:e4:d2:b5:db:36:a7:3a
+-----BEGIN CERTIFICATE-----
+MIIDVDCCAjygAwIBAgIDAjRWMA0GCSqGSIb3DQEBBQUAMEIxCzAJBgNVBAYTAlVT
+MRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMRswGQYDVQQDExJHZW9UcnVzdCBHbG9i
+YWwgQ0EwHhcNMDIwNTIxMDQwMDAwWhcNMjIwNTIxMDQwMDAwWjBCMQswCQYDVQQG
+EwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEbMBkGA1UEAxMSR2VvVHJ1c3Qg
+R2xvYmFsIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2swYYzD9
+9BcjGlZ+W988bDjkcbd4kdS8odhM+KhDtgPpTSEHCIjaWC9mOSm9BXiLnTjoBbdq
+fnGk5sRgprDvgOSJKA+eJdbtg/OtppHHmMlCGDUUna2YRpIuT8rxh0PBFpVXLVDv
+iS2Aelet8u5fa9IAjbkU+BQVNdnARqN7csiRv8lVK83Qlz6cJmTM386DGXHKTubU
+1XupGc1V3sjs0l44U+VcT4wt/lAjNvxm5suOpDkZALeVAjmRCw7+OC7RHQWa9k0+
+bw8HHa8sHo9gOeL6NlMTOdReJivbPagUvTLrGAMoUgRx5aszPeE4uwc2hGKceeoW
+MPRfwCvocWvk+QIDAQABo1MwUTAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTA
+ephojYn7qwVkDBF9qn1luMrMTjAfBgNVHSMEGDAWgBTAephojYn7qwVkDBF9qn1l
+uMrMTjANBgkqhkiG9w0BAQUFAAOCAQEANeMpauUvXVSOKVCUn5kaFOSPeCpilKIn
+Z57QzxpeR+nBsqTP3UEaBU6bS+5Kb1VSsyShNwrrZHYqLizz/Tt1kL/6cdjHPTfS
+tQWVYrmm3ok9Nns4d0iXrKYgjy6myQzCsplFAMfOEVEiIuCl6rYVSAlk6l5PdPcF
+PseKUgzbFbS9bZvlxrFUaKnjaZC2mqUPuLk/IH2uSrW4nOQdtqvmlKXBx4Ot2/Un
+hw4EbNX/3aBd7YdStysVAq45pmp06drE57xNNB6pXE0zX5IJL4hmXXeXxx12E6nV
+5fEWCRE11azbJHFwLJhWC9kXtNHjUStedejV0NxPNO3CBWaAocvmMw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Universal CA O=GeoTrust Inc.
+# Subject: CN=GeoTrust Universal CA O=GeoTrust Inc.
+# Label: "GeoTrust Universal CA"
+# Serial: 1
+# MD5 Fingerprint: 92:65:58:8b:a2:1a:31:72:73:68:5c:b4:a5:7a:07:48
+# SHA1 Fingerprint: e6:21:f3:35:43:79:05:9a:4b:68:30:9d:8a:2f:74:22:15:87:ec:79
+# SHA256 Fingerprint: a0:45:9b:9f:63:b2:25:59:f5:fa:5d:4c:6d:b3:f9:f7:2f:f1:93:42:03:35:78:f0:73:bf:1d:1b:46:cb:b9:12
+-----BEGIN CERTIFICATE-----
+MIIFaDCCA1CgAwIBAgIBATANBgkqhkiG9w0BAQUFADBFMQswCQYDVQQGEwJVUzEW
+MBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEeMBwGA1UEAxMVR2VvVHJ1c3QgVW5pdmVy
+c2FsIENBMB4XDTA0MDMwNDA1MDAwMFoXDTI5MDMwNDA1MDAwMFowRTELMAkGA1UE
+BhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xHjAcBgNVBAMTFUdlb1RydXN0
+IFVuaXZlcnNhbCBDQTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKYV
+VaCjxuAfjJ0hUNfBvitbtaSeodlyWL0AG0y/YckUHUWCq8YdgNY96xCcOq9tJPi8
+cQGeBvV8Xx7BDlXKg5pZMK4ZyzBIle0iN430SppyZj6tlcDgFgDgEB8rMQ7XlFTT
+QjOgNB0eRXbdT8oYN+yFFXoZCPzVx5zw8qkuEKmS5j1YPakWaDwvdSEYfyh3peFh
+F7em6fgemdtzbvQKoiFs7tqqhZJmr/Z6a4LauiIINQ/PQvE1+mrufislzDoR5G2v
+c7J2Ha3QsnhnGqQ5HFELZ1aD/ThdDc7d8Lsrlh/eezJS/R27tQahsiFepdaVaH/w
+mZ7cRQg+59IJDTWU3YBOU5fXtQlEIGQWFwMCTFMNaN7VqnJNk22CDtucvc+081xd
+VHppCZbW2xHBjXWotM85yM48vCR85mLK4b19p71XZQvk/iXttmkQ3CgaRr0BHdCX
+teGYO8A3ZNY9lO4L4fUorgtWv3GLIylBjobFS1J72HGrH4oVpjuDWtdYAVHGTEHZ
+f9hBZ3KiKN9gg6meyHv8U3NyWfWTehd2Ds735VzZC1U0oqpbtWpU5xPKV+yXbfRe
+Bi9Fi1jUIxaS5BZuKGNZMN9QAZxjiRqf2xeUgnA3wySemkfWWspOqGmJch+RbNt+
+nhutxx9z3SxPGWX9f5NAEC7S8O08ni4oPmkmM8V7AgMBAAGjYzBhMA8GA1UdEwEB
+/wQFMAMBAf8wHQYDVR0OBBYEFNq7LqqwDLiIJlF0XG0D08DYj3rWMB8GA1UdIwQY
+MBaAFNq7LqqwDLiIJlF0XG0D08DYj3rWMA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG
+9w0BAQUFAAOCAgEAMXjmx7XfuJRAyXHEqDXsRh3ChfMoWIawC/yOsjmPRFWrZIRc
+aanQmjg8+uUfNeVE44B5lGiku8SfPeE0zTBGi1QrlaXv9z+ZhP015s8xxtxqv6fX
+IwjhmF7DWgh2qaavdy+3YL1ERmrvl/9zlcGO6JP7/TG37FcREUWbMPEaiDnBTzyn
+ANXH/KttgCJwpQzgXQQpAvvLoJHRfNbDflDVnVi+QTjruXU8FdmbyUqDWcDaU/0z
+uzYYm4UPFd3uLax2k7nZAY1IEKj79TiG8dsKxr2EoyNB3tZ3b4XUhRxQ4K5RirqN
+Pnbiucon8l+f725ZDQbYKxek0nxru18UGkiPGkzns0ccjkxFKyDuSN/n3QmOGKja
+QI2SJhFTYXNd673nxE0pN2HrrDktZy4W1vUAg4WhzH92xH3kt0tm7wNFYGm2DFKW
+koRepqO1pD4r2czYG0eq8kTaT/kD6PAUyz/zg97QwVTjt+gKN02LIFkDMBmhLMi9
+ER/frslKxfMnZmaGrGiR/9nmUxwPi1xpZQomyB40w11Re9epnAahNt3ViZS82eQt
+DF4JbAiXfKM9fJP/P6EUp8+1Xevb2xzEdt+Iub1FBZUbrvxGakyvSOPOrg/Sfuvm
+bJxPgWp6ZKy7PtXny3YuxadIwVyQD8vIP/rmMuGNG2+k5o7Y+SlIis5z/iw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Universal CA 2 O=GeoTrust Inc.
+# Subject: CN=GeoTrust Universal CA 2 O=GeoTrust Inc.
+# Label: "GeoTrust Universal CA 2"
+# Serial: 1
+# MD5 Fingerprint: 34:fc:b8:d0:36:db:9e:14:b3:c2:f2:db:8f:e4:94:c7
+# SHA1 Fingerprint: 37:9a:19:7b:41:85:45:35:0c:a6:03:69:f3:3c:2e:af:47:4f:20:79
+# SHA256 Fingerprint: a0:23:4f:3b:c8:52:7c:a5:62:8e:ec:81:ad:5d:69:89:5d:a5:68:0d:c9:1d:1c:b8:47:7f:33:f8:78:b9:5b:0b
+-----BEGIN CERTIFICATE-----
+MIIFbDCCA1SgAwIBAgIBATANBgkqhkiG9w0BAQUFADBHMQswCQYDVQQGEwJVUzEW
+MBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEgMB4GA1UEAxMXR2VvVHJ1c3QgVW5pdmVy
+c2FsIENBIDIwHhcNMDQwMzA0MDUwMDAwWhcNMjkwMzA0MDUwMDAwWjBHMQswCQYD
+VQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjEgMB4GA1UEAxMXR2VvVHJ1
+c3QgVW5pdmVyc2FsIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC
+AQCzVFLByT7y2dyxUxpZKeexw0Uo5dfR7cXFS6GqdHtXr0om/Nj1XqduGdt0DE81
+WzILAePb63p3NeqqWuDW6KFXlPCQo3RWlEQwAx5cTiuFJnSCegx2oG9NzkEtoBUG
+FF+3Qs17j1hhNNwqCPkuwwGmIkQcTAeC5lvO0Ep8BNMZcyfwqph/Lq9O64ceJHdq
+XbboW0W63MOhBW9Wjo8QJqVJwy7XQYci4E+GymC16qFjwAGXEHm9ADwSbSsVsaxL
+se4YuU6W3Nx2/zu+z18DwPw76L5GG//aQMJS9/7jOvdqdzXQ2o3rXhhqMcceujwb
+KNZrVMaqW9eiLBsZzKIC9ptZvTdrhrVtgrrY6slWvKk2WP0+GfPtDCapkzj4T8Fd
+IgbQl+rhrcZV4IErKIM6+vR7IVEAvlI4zs1meaj0gVbi0IMJR1FbUGrP20gaXT73
+y/Zl92zxlfgCOzJWgjl6W70viRu/obTo/3+NjN8D8WBOWBFM66M/ECuDmgFz2ZRt
+hAAnZqzwcEAJQpKtT5MNYQlRJNiS1QuUYbKHsu3/mjX/hVTK7URDrBs8FmtISgoc
+QIgfksILAAX/8sgCSqSqqcyZlpwvWOB94b67B9xfBHJcMTTD7F8t4D1kkCLm0ey4
+Lt1ZrtmhN79UNdxzMk+MBB4zsslG8dhcyFVQyWi9qLo2CQIDAQABo2MwYTAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR281Xh+qQ2+/CfXGJx7Tz0RzgQKzAfBgNV
+HSMEGDAWgBR281Xh+qQ2+/CfXGJx7Tz0RzgQKzAOBgNVHQ8BAf8EBAMCAYYwDQYJ
+KoZIhvcNAQEFBQADggIBAGbBxiPz2eAubl/oz66wsCVNK/g7WJtAJDday6sWSf+z
+dXkzoS9tcBc0kf5nfo/sm+VegqlVHy/c1FEHEv6sFj4sNcZj/NwQ6w2jqtB8zNHQ
+L1EuxBRa3ugZ4T7GzKQp5y6EqgYweHZUcyiYWTjgAA1i00J9IZ+uPTqM1fp3DRgr
+Fg5fNuH8KrUwJM/gYwx7WBr+mbpCErGR9Hxo4sjoryzqyX6uuyo9DRXcNJW2GHSo
+ag/HtPQTxORb7QrSpJdMKu0vbBKJPfEncKpqA1Ihn0CoZ1Dy81of398j9tx4TuaY
+T1U6U+Pv8vSfx3zYWK8pIpe44L2RLrB27FcRz+8pRPPphXpgY+RdM4kX2TGq2tbz
+GDVyz4crL2MjhF2EjD9XoIj8mZEoJmmZ1I+XRL6O1UixpCgp8RW04eWe3fiPpm8m
+1wk8OhwRDqZsN/etRIcsKMfYdIKz0G9KV7s1KSegi+ghp4dkNl3M2Basx7InQJJV
+OCiNUW7dFGdTbHFcJoRNdVq2fmBWqU2t+5sel/MN2dKXVHfaPRK34B7vCAas+YWH
+6aLcr34YEoP9VhdBLtUpgn2Z9DH2canPLAEnpQW5qrJITirvn5NSUZU8UnOOVkwX
+QMAJKOSLakhT2+zNVVXxxvjpoixMptEmX36vWkzaH6byHCx+rgIW0lbQL1dTR+iS
+-----END CERTIFICATE-----
+
+# Issuer: CN=AAA Certificate Services O=Comodo CA Limited
+# Subject: CN=AAA Certificate Services O=Comodo CA Limited
+# Label: "Comodo AAA Services root"
+# Serial: 1
+# MD5 Fingerprint: 49:79:04:b0:eb:87:19:ac:47:b0:bc:11:51:9b:74:d0
+# SHA1 Fingerprint: d1:eb:23:a4:6d:17:d6:8f:d9:25:64:c2:f1:f1:60:17:64:d8:e3:49
+# SHA256 Fingerprint: d7:a7:a0:fb:5d:7e:27:31:d7:71:e9:48:4e:bc:de:f7:1d:5f:0c:3e:0a:29:48:78:2b:c8:3e:e0:ea:69:9e:f4
+-----BEGIN CERTIFICATE-----
+MIIEMjCCAxqgAwIBAgIBATANBgkqhkiG9w0BAQUFADB7MQswCQYDVQQGEwJHQjEb
+MBkGA1UECAwSR3JlYXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHDAdTYWxmb3JkMRow
+GAYDVQQKDBFDb21vZG8gQ0EgTGltaXRlZDEhMB8GA1UEAwwYQUFBIENlcnRpZmlj
+YXRlIFNlcnZpY2VzMB4XDTA0MDEwMTAwMDAwMFoXDTI4MTIzMTIzNTk1OVowezEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgMEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BwwHU2FsZm9yZDEaMBgGA1UECgwRQ29tb2RvIENBIExpbWl0ZWQxITAfBgNVBAMM
+GEFBQSBDZXJ0aWZpY2F0ZSBTZXJ2aWNlczCCASIwDQYJKoZIhvcNAQEBBQADggEP
+ADCCAQoCggEBAL5AnfRu4ep2hxxNRUSOvkbIgwadwSr+GB+O5AL686tdUIoWMQua
+BtDFcCLNSS1UY8y2bmhGC1Pqy0wkwLxyTurxFa70VJoSCsN6sjNg4tqJVfMiWPPe
+3M/vg4aijJRPn2jymJBGhCfHdr/jzDUsi14HZGWCwEiwqJH5YZ92IFCokcdmtet4
+YgNW8IoaE+oxox6gmf049vYnMlhvB/VruPsUK6+3qszWY19zjNoFmag4qMsXeDZR
+rOme9Hg6jc8P2ULimAyrL58OAd7vn5lJ8S3frHRNG5i1R8XlKdH5kBjHYpy+g8cm
+ez6KJcfA3Z3mNWgQIJ2P2N7Sw4ScDV7oL8kCAwEAAaOBwDCBvTAdBgNVHQ4EFgQU
+oBEKIz6W8Qfs4q8p74Klf9AwpLQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQF
+MAMBAf8wewYDVR0fBHQwcjA4oDagNIYyaHR0cDovL2NybC5jb21vZG9jYS5jb20v
+QUFBQ2VydGlmaWNhdGVTZXJ2aWNlcy5jcmwwNqA0oDKGMGh0dHA6Ly9jcmwuY29t
+b2RvLm5ldC9BQUFDZXJ0aWZpY2F0ZVNlcnZpY2VzLmNybDANBgkqhkiG9w0BAQUF
+AAOCAQEACFb8AvCb6P+k+tZ7xkSAzk/ExfYAWMymtrwUSWgEdujm7l3sAg9g1o1Q
+GE8mTgHj5rCl7r+8dFRBv/38ErjHT1r0iWAFf2C3BUrz9vHCv8S5dIa2LX1rzNLz
+Rt0vxuBqw8M0Ayx9lt1awg6nCpnBBYurDC/zXDrPbDdVCYfeU0BsWO/8tqtlbgT2
+G9w84FoVxp7Z8VlIMCFlA2zs6SFz7JsDoeA3raAVGI/6ugLOpyypEBMs1OUIJqsi
+l2D4kF501KKaU73yqWjgom7C12yxow+ev+to51byrvLjKzg6CYG1a4XXvi3tPxq3
+smPi9WIsgtRqAEFQ8TmDn5XpNpaYbg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root Certification Authority O=QuoVadis Limited OU=Root Certification Authority
+# Subject: CN=QuoVadis Root Certification Authority O=QuoVadis Limited OU=Root Certification Authority
+# Label: "QuoVadis Root CA"
+# Serial: 985026699
+# MD5 Fingerprint: 27:de:36:fe:72:b7:00:03:00:9d:f4:f0:1e:6c:04:24
+# SHA1 Fingerprint: de:3f:40:bd:50:93:d3:9b:6c:60:f6:da:bc:07:62:01:00:89:76:c9
+# SHA256 Fingerprint: a4:5e:de:3b:bb:f0:9c:8a:e1:5c:72:ef:c0:72:68:d6:93:a2:1c:99:6f:d5:1e:67:ca:07:94:60:fd:6d:88:73
+-----BEGIN CERTIFICATE-----
+MIIF0DCCBLigAwIBAgIEOrZQizANBgkqhkiG9w0BAQUFADB/MQswCQYDVQQGEwJC
+TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDElMCMGA1UECxMcUm9vdCBDZXJ0
+aWZpY2F0aW9uIEF1dGhvcml0eTEuMCwGA1UEAxMlUXVvVmFkaXMgUm9vdCBDZXJ0
+aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wMTAzMTkxODMzMzNaFw0yMTAzMTcxODMz
+MzNaMH8xCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMSUw
+IwYDVQQLExxSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MS4wLAYDVQQDEyVR
+dW9WYWRpcyBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEAv2G1lVO6V/z68mcLOhrfEYBklbTRvM16z/Yp
+li4kVEAkOPcahdxYTMukJ0KX0J+DisPkBgNbAKVRHnAEdOLB1Dqr1607BxgFjv2D
+rOpm2RgbaIr1VxqYuvXtdj182d6UajtLF8HVj71lODqV0D1VNk7feVcxKh7YWWVJ
+WCCYfqtffp/p1k3sg3Spx2zY7ilKhSoGFPlU5tPaZQeLYzcS19Dsw3sgQUSj7cug
+F+FxZc4dZjH3dgEZyH0DWLaVSR2mEiboxgx24ONmy+pdpibu5cxfvWenAScOospU
+xbF6lR1xHkopigPcakXBpBlebzbNw6Kwt/5cOOJSvPhEQ+aQuwIDAQABo4ICUjCC
+Ak4wPQYIKwYBBQUHAQEEMTAvMC0GCCsGAQUFBzABhiFodHRwczovL29jc3AucXVv
+dmFkaXNvZmZzaG9yZS5jb20wDwYDVR0TAQH/BAUwAwEB/zCCARoGA1UdIASCAREw
+ggENMIIBCQYJKwYBBAG+WAABMIH7MIHUBggrBgEFBQcCAjCBxxqBxFJlbGlhbmNl
+IG9uIHRoZSBRdW9WYWRpcyBSb290IENlcnRpZmljYXRlIGJ5IGFueSBwYXJ0eSBh
+c3N1bWVzIGFjY2VwdGFuY2Ugb2YgdGhlIHRoZW4gYXBwbGljYWJsZSBzdGFuZGFy
+ZCB0ZXJtcyBhbmQgY29uZGl0aW9ucyBvZiB1c2UsIGNlcnRpZmljYXRpb24gcHJh
+Y3RpY2VzLCBhbmQgdGhlIFF1b1ZhZGlzIENlcnRpZmljYXRlIFBvbGljeS4wIgYI
+KwYBBQUHAgEWFmh0dHA6Ly93d3cucXVvdmFkaXMuYm0wHQYDVR0OBBYEFItLbe3T
+KbkGGew5Oanwl4Rqy+/fMIGuBgNVHSMEgaYwgaOAFItLbe3TKbkGGew5Oanwl4Rq
+y+/foYGEpIGBMH8xCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1p
+dGVkMSUwIwYDVQQLExxSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MS4wLAYD
+VQQDEyVRdW9WYWRpcyBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggQ6tlCL
+MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQUFAAOCAQEAitQUtf70mpKnGdSk
+fnIYj9lofFIk3WdvOXrEql494liwTXCYhGHoG+NpGA7O+0dQoE7/8CQfvbLO9Sf8
+7C9TqnN7Az10buYWnuulLsS/VidQK2K6vkscPFVcQR0kvoIgR13VRH56FmjffU1R
+cHhXHTMe/QKZnAzNCgVPx7uOpHX6Sm2xgI4JVrmcGmD+XcHXetwReNDWXcG31a0y
+mQM6isxUJTkxgXsTIlG6Rmyhu576BGxJJnSP0nPrzDCi5upZIof4l/UO/erMkqQW
+xFIY6iHOsfHmhIHluqmGKPJDWl0Snawe2ajlCmqnf6CHKc/yiU3U7MXi5nrQNiOK
+SnQ2+Q==
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2"
+# Serial: 1289
+# MD5 Fingerprint: 5e:39:7b:dd:f8:ba:ec:82:e9:ac:62:ba:0c:54:00:2b
+# SHA1 Fingerprint: ca:3a:fb:cf:12:40:36:4b:44:b2:16:20:88:80:48:39:19:93:7c:f7
+# SHA256 Fingerprint: 85:a0:dd:7d:d7:20:ad:b7:ff:05:f8:3d:54:2b:20:9d:c7:ff:45:28:f7:d6:77:b1:83:89:fe:a5:e5:c4:9e:86
+-----BEGIN CERTIFICATE-----
+MIIFtzCCA5+gAwIBAgICBQkwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMjAeFw0wNjExMjQxODI3MDBaFw0zMTExMjQxODIzMzNaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCa
+GMpLlA0ALa8DKYrwD4HIrkwZhR0In6spRIXzL4GtMh6QRr+jhiYaHv5+HBg6XJxg
+Fyo6dIMzMH1hVBHL7avg5tKifvVrbxi3Cgst/ek+7wrGsxDp3MJGF/hd/aTa/55J
+WpzmM+Yklvc/ulsrHHo1wtZn/qtmUIttKGAr79dgw8eTvI02kfN/+NsRE8Scd3bB
+rrcCaoF6qUWD4gXmuVbBlDePSHFjIuwXZQeVikvfj8ZaCuWw419eaxGrDPmF60Tp
++ARz8un+XJiM9XOva7R+zdRcAitMOeGylZUtQofX1bOQQ7dsE/He3fbE+Ik/0XX1
+ksOR1YqI0JDs3G3eicJlcZaLDQP9nL9bFqyS2+r+eXyt66/3FsvbzSUr5R/7mp/i
+Ucw6UwxI5g69ybR2BlLmEROFcmMDBOAENisgGQLodKcftslWZvB1JdxnwQ5hYIiz
+PtGo/KPaHbDRsSNU30R2be1B2MGyIrZTHN81Hdyhdyox5C315eXbyOD/5YDXC2Og
+/zOhD7osFRXql7PSorW+8oyWHhqPHWykYTe5hnMz15eWniN9gqRMgeKh0bpnX5UH
+oycR7hYQe7xFSkyyBNKr79X9DFHOUGoIMfmR2gyPZFwDwzqLID9ujWc9Otb+fVuI
+yV77zGHcizN300QyNQliBJIWENieJ0f7OyHj+OsdWwIDAQABo4GwMIGtMA8GA1Ud
+EwEB/wQFMAMBAf8wCwYDVR0PBAQDAgEGMB0GA1UdDgQWBBQahGK8SEwzJQTU7tD2
+A8QZRtGUazBuBgNVHSMEZzBlgBQahGK8SEwzJQTU7tD2A8QZRtGUa6FJpEcwRTEL
+MAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMT
+ElF1b1ZhZGlzIFJvb3QgQ0EgMoICBQkwDQYJKoZIhvcNAQEFBQADggIBAD4KFk2f
+BluornFdLwUvZ+YTRYPENvbzwCYMDbVHZF34tHLJRqUDGCdViXh9duqWNIAXINzn
+g/iN/Ae42l9NLmeyhP3ZRPx3UIHmfLTJDQtyU/h2BwdBR5YM++CCJpNVjP4iH2Bl
+fF/nJrP3MpCYUNQ3cVX2kiF495V5+vgtJodmVjB3pjd4M1IQWK4/YY7yarHvGH5K
+WWPKjaJW1acvvFYfzznB4vsKqBUsfU16Y8Zsl0Q80m/DShcK+JDSV6IZUaUtl0Ha
+B0+pUNqQjZRG4T7wlP0QADj1O+hA4bRuVhogzG9Yje0uRY/W6ZM/57Es3zrWIozc
+hLsib9D45MY56QSIPMO661V6bYCZJPVsAfv4l7CUW+v90m/xd2gNNWQjrLhVoQPR
+TUIZ3Ph1WVaj+ahJefivDrkRoHy3au000LYmYjgahwz46P0u05B/B5EqHdZ+XIWD
+mbA4CD/pXvk1B+TJYm5Xf6dQlfe6yJvmjqIBxdZmv3lh8zwc4bmCXF2gw+nYSL0Z
+ohEUGW6yhhtoPkg3Goi3XZZenMfvJ2II4pEZXNLxId26F0KCl3GBUzGpn/Z9Yr9y
+4aOTHcyKJloJONDO1w2AFrR4pTqHTI2KpdVGl/IsELm8VCLAAVBpQ570su9t+Oza
+8eOx79+Rj1QqCyXBJhnEUhAFZdWCEOrCMc0u
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3"
+# Serial: 1478
+# MD5 Fingerprint: 31:85:3c:62:94:97:63:b9:aa:fd:89:4e:af:6f:e0:cf
+# SHA1 Fingerprint: 1f:49:14:f7:d8:74:95:1d:dd:ae:02:c0:be:fd:3a:2d:82:75:51:85
+# SHA256 Fingerprint: 18:f1:fc:7f:20:5d:f8:ad:dd:eb:7f:e0:07:dd:57:e3:af:37:5a:9c:4d:8d:73:54:6b:f4:f1:fe:d1:e1:8d:35
+-----BEGIN CERTIFICATE-----
+MIIGnTCCBIWgAwIBAgICBcYwDQYJKoZIhvcNAQEFBQAwRTELMAkGA1UEBhMCQk0x
+GTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxGzAZBgNVBAMTElF1b1ZhZGlzIFJv
+b3QgQ0EgMzAeFw0wNjExMjQxOTExMjNaFw0zMTExMjQxOTA2NDRaMEUxCzAJBgNV
+BAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBMaW1pdGVkMRswGQYDVQQDExJRdW9W
+YWRpcyBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDM
+V0IWVJzmmNPTTe7+7cefQzlKZbPoFog02w1ZkXTPkrgEQK0CSzGrvI2RaNggDhoB
+4hp7Thdd4oq3P5kazethq8Jlph+3t723j/z9cI8LoGe+AaJZz3HmDyl2/7FWeUUr
+H556VOijKTVopAFPD6QuN+8bv+OPEKhyq1hX51SGyMnzW9os2l2ObjyjPtr7guXd
+8lyyBTNvijbO0BNO/79KDDRMpsMhvVAEVeuxu537RR5kFd5VAYwCdrXLoT9Cabwv
+vWhDFlaJKjdhkf2mrk7AyxRllDdLkgbvBNDInIjbC3uBr7E9KsRlOni27tyAsdLT
+mZw67mtaa7ONt9XOnMK+pUsvFrGeaDsGb659n/je7Mwpp5ijJUMv7/FfJuGITfhe
+btfZFG4ZM2mnO4SJk8RTVROhUXhA+LjJou57ulJCg54U7QVSWllWp5f8nT8KKdjc
+T5EOE7zelaTfi5m+rJsziO+1ga8bxiJTyPbH7pcUsMV8eFLI8M5ud2CEpukqdiDt
+WAEXMJPpGovgc2PZapKUSU60rUqFxKMiMPwJ7Wgic6aIDFUhWMXhOp8q3crhkODZ
+c6tsgLjoC2SToJyMGf+z0gzskSaHirOi4XCPLArlzW1oUevaPwV/izLmE1xr/l9A
+4iLItLRkT9a6fUg+qGkM17uGcclzuD87nSVL2v9A6wIDAQABo4IBlTCCAZEwDwYD
+VR0TAQH/BAUwAwEB/zCB4QYDVR0gBIHZMIHWMIHTBgkrBgEEAb5YAAMwgcUwgZMG
+CCsGAQUFBwICMIGGGoGDQW55IHVzZSBvZiB0aGlzIENlcnRpZmljYXRlIGNvbnN0
+aXR1dGVzIGFjY2VwdGFuY2Ugb2YgdGhlIFF1b1ZhZGlzIFJvb3QgQ0EgMyBDZXJ0
+aWZpY2F0ZSBQb2xpY3kgLyBDZXJ0aWZpY2F0aW9uIFByYWN0aWNlIFN0YXRlbWVu
+dC4wLQYIKwYBBQUHAgEWIWh0dHA6Ly93d3cucXVvdmFkaXNnbG9iYWwuY29tL2Nw
+czALBgNVHQ8EBAMCAQYwHQYDVR0OBBYEFPLAE+CCQz777i9nMpY1XNu4ywLQMG4G
+A1UdIwRnMGWAFPLAE+CCQz777i9nMpY1XNu4ywLQoUmkRzBFMQswCQYDVQQGEwJC
+TTEZMBcGA1UEChMQUXVvVmFkaXMgTGltaXRlZDEbMBkGA1UEAxMSUXVvVmFkaXMg
+Um9vdCBDQSAzggIFxjANBgkqhkiG9w0BAQUFAAOCAgEAT62gLEz6wPJv92ZVqyM0
+7ucp2sNbtrCD2dDQ4iH782CnO11gUyeim/YIIirnv6By5ZwkajGxkHon24QRiSem
+d1o417+shvzuXYO8BsbRd2sPbSQvS3pspweWyuOEn62Iix2rFo1bZhfZFvSLgNLd
++LJ2w/w4E6oM3kJpK27zPOuAJ9v1pkQNn1pVWQvVDVJIxa6f8i+AxeoyUDUSly7B
+4f/xI4hROJ/yZlZ25w9Rl6VSDE1JUZU2Pb+iSwwQHYaZTKrzchGT5Or2m9qoXadN
+t54CrnMAyNojA+j56hl0YgCUyyIgvpSnWbWCar6ZeXqp8kokUvd0/bpO5qgdAm6x
+DYBEwa7TIzdfu4V8K5Iu6H6li92Z4b8nby1dqnuH/grdS/yO9SbkbnBCbjPsMZ57
+k8HkyWkaPcBrTiJt7qtYTcbQQcEr6k8Sh17rRdhs9ZgC06DYVYoGmRmioHfRMJ6s
+zHXug/WwYjnPbFfiTNKRCw51KBuav/0aQ/HKd/s7j2G4aSgWQgRecCocIdiP4b0j
+Wy10QJLZYxkNc91pvGJHvOB0K7Lrfb5BG7XARsWhIstfTsEokt4YutUqKLsRixeT
+mJlglFwjz1onl14LBQaTNx47aTbrqZ5hHY8y2o4M1nQ+ewkk2gF3R8Q7zTSMmfXK
+4SVhM7JZG+Ju1zdXtg2pEto=
+-----END CERTIFICATE-----
+
+# Issuer: O=SECOM Trust.net OU=Security Communication RootCA1
+# Subject: O=SECOM Trust.net OU=Security Communication RootCA1
+# Label: "Security Communication Root CA"
+# Serial: 0
+# MD5 Fingerprint: f1:bc:63:6a:54:e0:b5:27:f5:cd:e7:1a:e3:4d:6e:4a
+# SHA1 Fingerprint: 36:b1:2b:49:f9:81:9e:d7:4c:9e:bc:38:0f:c6:56:8f:5d:ac:b2:f7
+# SHA256 Fingerprint: e7:5e:72:ed:9f:56:0e:ec:6e:b4:80:00:73:a4:3f:c3:ad:19:19:5a:39:22:82:01:78:95:97:4a:99:02:6b:6c
+-----BEGIN CERTIFICATE-----
+MIIDWjCCAkKgAwIBAgIBADANBgkqhkiG9w0BAQUFADBQMQswCQYDVQQGEwJKUDEY
+MBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYDVQQLEx5TZWN1cml0eSBDb21t
+dW5pY2F0aW9uIFJvb3RDQTEwHhcNMDMwOTMwMDQyMDQ5WhcNMjMwOTMwMDQyMDQ5
+WjBQMQswCQYDVQQGEwJKUDEYMBYGA1UEChMPU0VDT00gVHJ1c3QubmV0MScwJQYD
+VQQLEx5TZWN1cml0eSBDb21tdW5pY2F0aW9uIFJvb3RDQTEwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQCzs/5/022x7xZ8V6UMbXaKL0u/ZPtM7orw8yl8
+9f/uKuDp6bpbZCKamm8sOiZpUQWZJtzVHGpxxpp9Hp3dfGzGjGdnSj74cbAZJ6kJ
+DKaVv0uMDPpVmDvY6CKhS3E4eayXkmmziX7qIWgGmBSWh9JhNrxtJ1aeV+7AwFb9
+Ms+k2Y7CI9eNqPPYJayX5HA49LY6tJ07lyZDo6G8SVlyTCMwhwFY9k6+HGhWZq/N
+QV3Is00qVUarH9oe4kA92819uZKAnDfdDJZkndwi92SL32HeFZRSFaB9UslLqCHJ
+xrHty8OVYNEP8Ktw+N/LTX7s1vqr2b1/VPKl6Xn62dZ2JChzAgMBAAGjPzA9MB0G
+A1UdDgQWBBSgc0mZaNyFW2XjmygvV5+9M7wHSDALBgNVHQ8EBAMCAQYwDwYDVR0T
+AQH/BAUwAwEB/zANBgkqhkiG9w0BAQUFAAOCAQEAaECpqLvkT115swW1F7NgE+vG
+kl3g0dNq/vu+m22/xwVtWSDEHPC32oRYAmP6SBbvT6UL90qY8j+eG61Ha2POCEfr
+Uj94nK9NrvjVT8+amCoQQTlSxN3Zmw7vkwGusi7KaEIkQmywszo+zenaSMQVy+n5
+Bw+SUEmK3TGXX8npN6o7WWWXlDLJs58+OmJYxUmtYg5xpTKqL8aJdkNAExNnPaJU
+JRDL8Try2frbSVa7pv6nQTXD4IhhyYjH3zYQIphZ6rBK+1YWc26sTfcioU+tHXot
+RSflMMFe8toTyyVCUZVHA4xsIcx0Qu1T/zOLjw9XARYvz6buyXAiFL39vmwLAw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Sonera Class2 CA O=Sonera
+# Subject: CN=Sonera Class2 CA O=Sonera
+# Label: "Sonera Class 2 Root CA"
+# Serial: 29
+# MD5 Fingerprint: a3:ec:75:0f:2e:88:df:fa:48:01:4e:0b:5c:48:6f:fb
+# SHA1 Fingerprint: 37:f7:6d:e6:07:7c:90:c5:b1:3e:93:1a:b7:41:10:b4:f2:e4:9a:27
+# SHA256 Fingerprint: 79:08:b4:03:14:c1:38:10:0b:51:8d:07:35:80:7f:fb:fc:f8:51:8a:00:95:33:71:05:ba:38:6b:15:3d:d9:27
+-----BEGIN CERTIFICATE-----
+MIIDIDCCAgigAwIBAgIBHTANBgkqhkiG9w0BAQUFADA5MQswCQYDVQQGEwJGSTEP
+MA0GA1UEChMGU29uZXJhMRkwFwYDVQQDExBTb25lcmEgQ2xhc3MyIENBMB4XDTAx
+MDQwNjA3Mjk0MFoXDTIxMDQwNjA3Mjk0MFowOTELMAkGA1UEBhMCRkkxDzANBgNV
+BAoTBlNvbmVyYTEZMBcGA1UEAxMQU29uZXJhIENsYXNzMiBDQTCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAJAXSjWdyvANlsdE+hY3/Ei9vX+ALTU74W+o
+Z6m/AxxNjG8yR9VBaKQTBME1DJqEQ/xcHf+Js+gXGM2RX/uJ4+q/Tl18GybTdXnt
+5oTjV+WtKcT0OijnpXuENmmz/V52vaMtmdOQTiMofRhj8VQ7Jp12W5dCsv+u8E7s
+3TmVToMGf+dJQMjFAbJUWmYdPfz56TwKnoG4cPABi+QjVHzIrviQHgCWctRUz2Ej
+vOr7nQKV0ba5cTppCD8PtOFCx4j1P5iop7oc4HFx71hXgVB6XGt0Rg6DA5jDjqhu
+8nYybieDwnPz3BjotJPqdURrBGAgcVeHnfO+oJAjPYok4doh28MCAwEAAaMzMDEw
+DwYDVR0TAQH/BAUwAwEB/zARBgNVHQ4ECgQISqCqWITTXjwwCwYDVR0PBAQDAgEG
+MA0GCSqGSIb3DQEBBQUAA4IBAQBazof5FnIVV0sd2ZvnoiYw7JNn39Yt0jSv9zil
+zqsWuasvfDXLrNAPtEwr/IDva4yRXzZ299uzGxnq9LIR/WFxRL8oszodv7ND6J+/
+3DEIcbCdjdY0RzKQxmUk96BKfARzjzlvF4xytb1LyHr4e4PDKE6cCepnP7JnBBvD
+FNr450kkkdAdavphOe9r5yF1BgfYErQhIHBCcYHaPJo2vqZbDWpsmh+Re/n570K6
+Tk6ezAyNlNzZRZxe7EJQY670XcSxEtzKO6gunRRaBXW37Ndj4ro1tgQIkejanZz2
+ZrUYrAqmVCY0M9IbwdR/GjqOC6oybtv8TyWf2TLHllpwrN9M
+-----END CERTIFICATE-----
+
+# Issuer: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Subject: CN=XRamp Global Certification Authority O=XRamp Security Services Inc OU=www.xrampsecurity.com
+# Label: "XRamp Global CA Root"
+# Serial: 107108908803651509692980124233745014957
+# MD5 Fingerprint: a1:0b:44:b3:ca:10:d8:00:6e:9d:0f:d8:0f:92:0a:d1
+# SHA1 Fingerprint: b8:01:86:d1:eb:9c:86:a5:41:04:cf:30:54:f3:4c:52:b7:e5:58:c6
+# SHA256 Fingerprint: ce:cd:dc:90:50:99:d8:da:df:c5:b1:d2:09:b7:37:cb:e2:c1:8c:fb:2c:10:c0:ff:0b:cf:0d:32:86:fc:1a:a2
+-----BEGIN CERTIFICATE-----
+MIIEMDCCAxigAwIBAgIQUJRs7Bjq1ZxN1ZfvdY+grTANBgkqhkiG9w0BAQUFADCB
+gjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3dy54cmFtcHNlY3VyaXR5LmNvbTEk
+MCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2VydmljZXMgSW5jMS0wKwYDVQQDEyRY
+UmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQxMTAxMTcx
+NDA0WhcNMzUwMTAxMDUzNzE5WjCBgjELMAkGA1UEBhMCVVMxHjAcBgNVBAsTFXd3
+dy54cmFtcHNlY3VyaXR5LmNvbTEkMCIGA1UEChMbWFJhbXAgU2VjdXJpdHkgU2Vy
+dmljZXMgSW5jMS0wKwYDVQQDEyRYUmFtcCBHbG9iYWwgQ2VydGlmaWNhdGlvbiBB
+dXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCYJB69FbS6
+38eMpSe2OAtp87ZOqCwuIR1cRN8hXX4jdP5efrRKt6atH67gBhbim1vZZ3RrXYCP
+KZ2GG9mcDZhtdhAoWORlsH9KmHmf4MMxfoArtYzAQDsRhtDLooY2YKTVMIJt2W7Q
+DxIEM5dfT2Fa8OT5kavnHTu86M/0ay00fOJIYRyO82FEzG+gSqmUsE3a56k0enI4
+qEHMPJQRfevIpoy3hsvKMzvZPTeL+3o+hiznc9cKV6xkmxnr9A8ECIqsAxcZZPRa
+JSKNNCyy9mgdEm3Tih4U2sSPpuIjhdV6Db1q4Ons7Be7QhtnqiXtRYMh/MHJfNVi
+PvryxS3T/dRlAgMBAAGjgZ8wgZwwEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0P
+BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMZPoj0GY4QJnM5i5ASs
+jVy16bYbMDYGA1UdHwQvMC0wK6ApoCeGJWh0dHA6Ly9jcmwueHJhbXBzZWN1cml0
+eS5jb20vWEdDQS5jcmwwEAYJKwYBBAGCNxUBBAMCAQEwDQYJKoZIhvcNAQEFBQAD
+ggEBAJEVOQMBG2f7Shz5CmBbodpNl2L5JFMn14JkTpAuw0kbK5rc/Kh4ZzXxHfAR
+vbdI4xD2Dd8/0sm2qlWkSLoC295ZLhVbO50WfUfXN+pfTXYSNrsf16GBBEYgoyxt
+qZ4Bfj8pzgCT3/3JknOJiWSe5yvkHJEs0rnOfc5vMZnT5r7SHpDwCRR5XCOrTdLa
+IR9NmXmd4c8nnxCbHIgNsIpkQTG4DmyQJKSbXHGPurt+HBvbaoAPIbzp26a3QPSy
+i6mx5O+aGtA9aZnuqCij4Tyz8LIRnM98QObd50N9otg6tamN8jSZxNQQ4Qb9CYQQ
+O+7ETPTsJ3xCwnR8gooJybQDJbw=
+-----END CERTIFICATE-----
+
+# Issuer: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Subject: O=The Go Daddy Group, Inc. OU=Go Daddy Class 2 Certification Authority
+# Label: "Go Daddy Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 91:de:06:25:ab:da:fd:32:17:0c:bb:25:17:2a:84:67
+# SHA1 Fingerprint: 27:96:ba:e6:3f:18:01:e2:77:26:1b:a0:d7:77:70:02:8f:20:ee:e4
+# SHA256 Fingerprint: c3:84:6b:f2:4b:9e:93:ca:64:27:4c:0e:c6:7c:1e:cc:5e:02:4f:fc:ac:d2:d7:40:19:35:0e:81:fe:54:6a:e4
+-----BEGIN CERTIFICATE-----
+MIIEADCCAuigAwIBAgIBADANBgkqhkiG9w0BAQUFADBjMQswCQYDVQQGEwJVUzEh
+MB8GA1UEChMYVGhlIEdvIERhZGR5IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBE
+YWRkeSBDbGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTA0MDYyOTE3
+MDYyMFoXDTM0MDYyOTE3MDYyMFowYzELMAkGA1UEBhMCVVMxITAfBgNVBAoTGFRo
+ZSBHbyBEYWRkeSBHcm91cCwgSW5jLjExMC8GA1UECxMoR28gRGFkZHkgQ2xhc3Mg
+MiBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTCCASAwDQYJKoZIhvcNAQEBBQADggEN
+ADCCAQgCggEBAN6d1+pXGEmhW+vXX0iG6r7d/+TvZxz0ZWizV3GgXne77ZtJ6XCA
+PVYYYwhv2vLM0D9/AlQiVBDYsoHUwHU9S3/Hd8M+eKsaA7Ugay9qK7HFiH7Eux6w
+wdhFJ2+qN1j3hybX2C32qRe3H3I2TqYXP2WYktsqbl2i/ojgC95/5Y0V4evLOtXi
+EqITLdiOr18SPaAIBQi2XKVlOARFmR6jYGB0xUGlcmIbYsUfb18aQr4CUWWoriMY
+avx4A6lNf4DD+qta/KFApMoZFv6yyO9ecw3ud72a9nmYvLEHZ6IVDd2gWMZEewo+
+YihfukEHU1jPEX44dMX4/7VpkI+EdOqXG68CAQOjgcAwgb0wHQYDVR0OBBYEFNLE
+sNKR1EwRcbNhyz2h/t2oatTjMIGNBgNVHSMEgYUwgYKAFNLEsNKR1EwRcbNhyz2h
+/t2oatTjoWekZTBjMQswCQYDVQQGEwJVUzEhMB8GA1UEChMYVGhlIEdvIERhZGR5
+IEdyb3VwLCBJbmMuMTEwLwYDVQQLEyhHbyBEYWRkeSBDbGFzcyAyIENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQAD
+ggEBADJL87LKPpH8EsahB4yOd6AzBhRckB4Y9wimPQoZ+YeAEW5p5JYXMP80kWNy
+OO7MHAGjHZQopDH2esRU1/blMVgDoszOYtuURXO1v0XJJLXVggKtI3lpjbi2Tc7P
+TMozI+gciKqdi0FuFskg5YmezTvacPd+mSYgFFQlq25zheabIZ0KbIIOqPjCDPoQ
+HmyW74cNxA9hi63ugyuV+I6ShHI56yDqg+2DzZduCLzrTia2cyvk0/ZM/iZx4mER
+dEr/VxqHD3VILs9RaRegAhJhldXRQLIQTO7ErBBDpqWeCtWVYpoNz4iCxTIM5Cuf
+ReYNnyicsbkqWletNw+vHX/bvZ8=
+-----END CERTIFICATE-----
+
+# Issuer: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Subject: O=Starfield Technologies, Inc. OU=Starfield Class 2 Certification Authority
+# Label: "Starfield Class 2 CA"
+# Serial: 0
+# MD5 Fingerprint: 32:4a:4b:bb:c8:63:69:9b:be:74:9a:c6:dd:1d:46:24
+# SHA1 Fingerprint: ad:7e:1c:28:b0:64:ef:8f:60:03:40:20:14:c3:d0:e3:37:0e:b5:8a
+# SHA256 Fingerprint: 14:65:fa:20:53:97:b8:76:fa:a6:f0:a9:95:8e:55:90:e4:0f:cc:7f:aa:4f:b7:c2:c8:67:75:21:fb:5f:b6:58
+-----BEGIN CERTIFICATE-----
+MIIEDzCCAvegAwIBAgIBADANBgkqhkiG9w0BAQUFADBoMQswCQYDVQQGEwJVUzEl
+MCMGA1UEChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMp
+U3RhcmZpZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDQw
+NjI5MTczOTE2WhcNMzQwNjI5MTczOTE2WjBoMQswCQYDVQQGEwJVUzElMCMGA1UE
+ChMcU3RhcmZpZWxkIFRlY2hub2xvZ2llcywgSW5jLjEyMDAGA1UECxMpU3RhcmZp
+ZWxkIENsYXNzIDIgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwggEgMA0GCSqGSIb3
+DQEBAQUAA4IBDQAwggEIAoIBAQC3Msj+6XGmBIWtDBFk385N78gDGIc/oav7PKaf
+8MOh2tTYbitTkPskpD6E8J7oX+zlJ0T1KKY/e97gKvDIr1MvnsoFAZMej2YcOadN
++lq2cwQlZut3f+dZxkqZJRRU6ybH838Z1TBwj6+wRir/resp7defqgSHo9T5iaU0
+X9tDkYI22WY8sbi5gv2cOj4QyDvvBmVmepsZGD3/cVE8MC5fvj13c7JdBmzDI1aa
+K4UmkhynArPkPw2vCHmCuDY96pzTNbO8acr1zJ3o/WSNF4Azbl5KXZnJHoe0nRrA
+1W4TNSNe35tfPe/W93bC6j67eA0cQmdrBNj41tpvi/JEoAGrAgEDo4HFMIHCMB0G
+A1UdDgQWBBS/X7fRzt0fhvRbVazc1xDCDqmI5zCBkgYDVR0jBIGKMIGHgBS/X7fR
+zt0fhvRbVazc1xDCDqmI56FspGowaDELMAkGA1UEBhMCVVMxJTAjBgNVBAoTHFN0
+YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAsTKVN0YXJmaWVsZCBD
+bGFzcyAyIENlcnRpZmljYXRpb24gQXV0aG9yaXR5ggEAMAwGA1UdEwQFMAMBAf8w
+DQYJKoZIhvcNAQEFBQADggEBAAWdP4id0ckaVaGsafPzWdqbAYcaT1epoXkJKtv3
+L7IezMdeatiDh6GX70k1PncGQVhiv45YuApnP+yz3SFmH8lU+nLMPUxA2IGvd56D
+eruix/U0F47ZEUD0/CwqTRV/p2JdLiXTAAsgGh1o+Re49L2L7ShZ3U0WixeDyLJl
+xy16paq8U4Zt3VekyvggQQto8PT7dL5WXXp59fkdheMtlb71cZBDzI0fmgAKhynp
+VSJYACPq4xJDKVtHCN2MQWplBqjlIapBtJUhlbl90TSrE9atvNziPTnNvT51cKEY
+WQPJIrSPnNVeKtelttQKbfi3QBFGmh95DmK/D5fs4C8fF5Q=
+-----END CERTIFICATE-----
+
+# Issuer: O=Government Root Certification Authority
+# Subject: O=Government Root Certification Authority
+# Label: "Taiwan GRCA"
+# Serial: 42023070807708724159991140556527066870
+# MD5 Fingerprint: 37:85:44:53:32:45:1f:20:f0:f3:95:e1:25:c4:43:4e
+# SHA1 Fingerprint: f4:8b:11:bf:de:ab:be:94:54:20:71:e6:41:de:6b:be:88:2b:40:b9
+# SHA256 Fingerprint: 76:00:29:5e:ef:e8:5b:9e:1f:d6:24:db:76:06:2a:aa:ae:59:81:8a:54:d2:77:4c:d4:c0:b2:c0:11:31:e1:b3
+-----BEGIN CERTIFICATE-----
+MIIFcjCCA1qgAwIBAgIQH51ZWtcvwgZEpYAIaeNe9jANBgkqhkiG9w0BAQUFADA/
+MQswCQYDVQQGEwJUVzEwMC4GA1UECgwnR292ZXJubWVudCBSb290IENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5MB4XDTAyMTIwNTEzMjMzM1oXDTMyMTIwNTEzMjMzM1ow
+PzELMAkGA1UEBhMCVFcxMDAuBgNVBAoMJ0dvdmVybm1lbnQgUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB
+AJoluOzMonWoe/fOW1mKydGGEghU7Jzy50b2iPN86aXfTEc2pBsBHH8eV4qNw8XR
+IePaJD9IK/ufLqGU5ywck9G/GwGHU5nOp/UKIXZ3/6m3xnOUT0b3EEk3+qhZSV1q
+gQdW8or5BtD3cCJNtLdBuTK4sfCxw5w/cP1T3YGq2GN49thTbqGsaoQkclSGxtKy
+yhwOeYHWtXBiCAEuTk8O1RGvqa/lmr/czIdtJuTJV6L7lvnM4T9TjGxMfptTCAts
+F/tnyMKtsc2AtJfcdgEWFelq16TheEfOhtX7MfP6Mb40qij7cEwdScevLJ1tZqa2
+jWR+tSBqnTuBto9AAGdLiYa4zGX+FVPpBMHWXx1E1wovJ5pGfaENda1UhhXcSTvx
+ls4Pm6Dso3pdvtUqdULle96ltqqvKKyskKw4t9VoNSZ63Pc78/1Fm9G7Q3hub/FC
+VGqY8A2tl+lSXunVanLeavcbYBT0peS2cWeqH+riTcFCQP5nRhc4L0c/cZyu5SHK
+YS1tB6iEfC3uUSXxY5Ce/eFXiGvviiNtsea9P63RPZYLhY3Naye7twWb7LuRqQoH
+EgKXTiCQ8P8NHuJBO9NAOueNXdpm5AKwB1KYXA6OM5zCppX7VRluTI6uSw+9wThN
+Xo+EHWbNxWCWtFJaBYmOlXqYwZE8lSOyDvR5tMl8wUohAgMBAAGjajBoMB0GA1Ud
+DgQWBBTMzO/MKWCkO7GStjz6MmKPrCUVOzAMBgNVHRMEBTADAQH/MDkGBGcqBwAE
+MTAvMC0CAQAwCQYFKw4DAhoFADAHBgVnKgMAAAQUA5vwIhP/lSg209yewDL7MTqK
+UWUwDQYJKoZIhvcNAQEFBQADggIBAECASvomyc5eMN1PhnR2WPWus4MzeKR6dBcZ
+TulStbngCnRiqmjKeKBMmo4sIy7VahIkv9Ro04rQ2JyftB8M3jh+Vzj8jeJPXgyf
+qzvS/3WXy6TjZwj/5cAWtUgBfen5Cv8b5Wppv3ghqMKnI6mGq3ZW6A4M9hPdKmaK
+ZEk9GhiHkASfQlK3T8v+R0F2Ne//AHY2RTKbxkaFXeIksB7jSJaYV0eUVXoPQbFE
+JPPB/hprv4j9wabak2BegUqZIJxIZhm1AHlUD7gsL0u8qV1bYH+Mh6XgUmMqvtg7
+hUAV/h62ZT/FS9p+tXo1KaMuephgIqP0fSdOLeq0dDzpD6QzDxARvBMB1uUO07+1
+EqLhRSPAzAhuYbeJq4PjJB7mXQfnHyA+z2fI56wwbSdLaG5LKlwCCDTb+HbkZ6Mm
+nD+iMsJKxYEYMRBWqoTvLQr/uB930r+lWKBi5NdLkXWNiYCYfm3LU05er/ayl4WX
+udpVBrkk7tfGOB5jGxI7leFYrPLfhNVfmS8NVVvmONsuP3LpSIXLuykTjx44Vbnz
+ssQwmSNOXfJIoRIM3BKQCZBUkQM8R+XVyWXgt0t97EfTsws+rZ7QdAAO671RrcDe
+LMDDav7v3Aun+kbfYNucpllQdSNpc5Oy+fwC00fmcc4QAu4njIT/rEUNE1yDMuAl
+pYYsfPQS
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root CA"
+# Serial: 17154717934120587862167794914071425081
+# MD5 Fingerprint: 87:ce:0b:7b:2a:0e:49:00:e1:58:71:9b:37:a8:93:72
+# SHA1 Fingerprint: 05:63:b8:63:0d:62:d7:5a:bb:c8:ab:1e:4b:df:b5:a8:99:b2:4d:43
+# SHA256 Fingerprint: 3e:90:99:b5:01:5e:8f:48:6c:00:bc:ea:9d:11:1e:e7:21:fa:ba:35:5a:89:bc:f1:df:69:56:1e:3d:c6:32:5c
+-----BEGIN CERTIFICATE-----
+MIIDtzCCAp+gAwIBAgIQDOfg5RfYRv6P5WD8G/AwOTANBgkqhkiG9w0BAQUFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgQ0EwHhcNMDYxMTEwMDAwMDAwWhcNMzExMTEwMDAwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCtDhXO5EOAXLGH87dg+XESpa7c
+JpSIqvTO9SA5KFhgDPiA2qkVlTJhPLWxKISKityfCgyDF3qPkKyK53lTXDGEKvYP
+mDI2dsze3Tyoou9q+yHyUmHfnyDXH+Kx2f4YZNISW1/5WBg1vEfNoTb5a3/UsDg+
+wRvDjDPZ2C8Y/igPs6eD1sNuRMBhNZYW/lmci3Zt1/GiSw0r/wty2p5g0I6QNcZ4
+VYcgoc/lbQrISXwxmDNsIumH0DJaoroTghHtORedmTpyoeb6pNnVFzF1roV9Iq4/
+AUaG9ih5yLHa5FcXxH4cDrC0kqZWs72yl+2qp/C3xag/lRbQ/6GW6whfGHdPAgMB
+AAGjYzBhMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQW
+BBRF66Kv9JLLgjEtUYunpyGd823IDzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYun
+pyGd823IDzANBgkqhkiG9w0BAQUFAAOCAQEAog683+Lt8ONyc3pklL/3cmbYMuRC
+dWKuh+vy1dneVrOfzM4UKLkNl2BcEkxY5NM9g0lFWJc1aRqoR+pWxnmrEthngYTf
+fwk8lOa4JiwgvT2zKIn3X/8i4peEH+ll74fg38FnSbNd67IJKusm7Xi+fT8r87cm
+NW1fiQG2SVufAQWbqz0lwcy2f8Lxb4bG+mRo64EtlOtCt/qMHt1i8b5QZ7dsvfPx
+H2sMNgcWfzd8qVttevESRmCD1ycEvkvOl77DZypoEd+A5wwzZr8TDRRu838fYxAe
++o0bJW1sj6W3YQGx0qMmoRBxna3iw/nDmVG3KwcIzi7mULKn+gpFL6Lw8g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root CA"
+# Serial: 10944719598952040374951832963794454346
+# MD5 Fingerprint: 79:e4:a9:84:0d:7d:3a:96:d7:c0:4f:e2:43:4c:89:2e
+# SHA1 Fingerprint: a8:98:5d:3a:65:e5:e5:c4:b2:d7:d6:6d:40:c6:dd:2f:b1:9c:54:36
+# SHA256 Fingerprint: 43:48:a0:e9:44:4c:78:cb:26:5e:05:8d:5e:89:44:b4:d8:4f:96:62:bd:26:db:25:7f:89:34:a4:43:c7:01:61
+-----BEGIN CERTIFICATE-----
+MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
+QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
+CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
+nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
+43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
+T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
+gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
+BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
+TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
+DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
+hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
+06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
+PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
+YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
+CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert High Assurance EV Root CA O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert High Assurance EV Root CA"
+# Serial: 3553400076410547919724730734378100087
+# MD5 Fingerprint: d4:74:de:57:5c:39:b2:d3:9c:85:83:c5:c0:65:49:8a
+# SHA1 Fingerprint: 5f:b7:ee:06:33:e2:59:db:ad:0c:4c:9a:e6:d3:8f:1a:61:c7:dc:25
+# SHA256 Fingerprint: 74:31:e5:f4:c3:c1:ce:46:90:77:4f:0b:61:e0:54:40:88:3b:a9:a0:1e:d0:0b:a6:ab:d7:80:6e:d3:b1:18:cf
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIQAqxcJmoLQJuPC3nyrkYldzANBgkqhkiG9w0BAQUFADBs
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSswKQYDVQQDEyJEaWdpQ2VydCBIaWdoIEFzc3VyYW5j
+ZSBFViBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTMxMTExMDAwMDAwMFowbDEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3
+LmRpZ2ljZXJ0LmNvbTErMCkGA1UEAxMiRGlnaUNlcnQgSGlnaCBBc3N1cmFuY2Ug
+RVYgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMbM5XPm
++9S75S0tMqbf5YE/yc0lSbZxKsPVlDRnogocsF9ppkCxxLeyj9CYpKlBWTrT3JTW
+PNt0OKRKzE0lgvdKpVMSOO7zSW1xkX5jtqumX8OkhPhPYlG++MXs2ziS4wblCJEM
+xChBVfvLWokVfnHoNb9Ncgk9vjo4UFt3MRuNs8ckRZqnrG0AFFoEt7oT61EKmEFB
+Ik5lYYeBQVCmeVyJ3hlKV9Uu5l0cUyx+mM0aBhakaHPQNAQTXKFx01p8VdteZOE3
+hzBWBOURtCmAEvF5OYiiAhF8J2a3iLd48soKqDirCmTCv2ZdlYTBoSUeh10aUAsg
+EsxBu24LUTi4S8sCAwEAAaNjMGEwDgYDVR0PAQH/BAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFLE+w2kD+L9HAdSYJhoIAu9jZCvDMB8GA1UdIwQYMBaA
+FLE+w2kD+L9HAdSYJhoIAu9jZCvDMA0GCSqGSIb3DQEBBQUAA4IBAQAcGgaX3Nec
+nzyIZgYIVyHbIUf4KmeqvxgydkAQV8GK83rZEWWONfqe/EW1ntlMMUu4kehDLI6z
+eM7b41N5cdblIZQB2lWHmiRk9opmzN6cN82oNLFpmyPInngiK3BD41VHMWEZ71jF
+hS9OMPagMRYjyOfiZRYzy78aG6A9+MpeizGLYAiJLQwGXFK3xPkKmNEVX58Svnw2
+Yzi9RKR/5CYrCsSXaQ3pjOLAEFe4yHYSkVXySGnYvCoCWw9E1CAx2/S6cCZdkGCe
+vEsXCS+0yx5DaMkHJ8HSXPfqIbloEpw8nL+e/IBcm2PN7EeqJSdnoDfzAIJ9VNep
++OkuE6N36B9K
+-----END CERTIFICATE-----
+
+# Issuer: CN=DST Root CA X3 O=Digital Signature Trust Co.
+# Subject: CN=DST Root CA X3 O=Digital Signature Trust Co.
+# Label: "DST Root CA X3"
+# Serial: 91299735575339953335919266965803778155
+# MD5 Fingerprint: 41:03:52:dc:0f:f7:50:1b:16:f0:02:8e:ba:6f:45:c5
+# SHA1 Fingerprint: da:c9:02:4f:54:d8:f6:df:94:93:5f:b1:73:26:38:ca:6a:d7:7c:13
+# SHA256 Fingerprint: 06:87:26:03:31:a7:24:03:d9:09:f1:05:e6:9b:cf:0d:32:e1:bd:24:93:ff:c6:d9:20:6d:11:bc:d6:77:07:39
+-----BEGIN CERTIFICATE-----
+MIIDSjCCAjKgAwIBAgIQRK+wgNajJ7qJMDmGLvhAazANBgkqhkiG9w0BAQUFADA/
+MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT
+DkRTVCBSb290IENBIFgzMB4XDTAwMDkzMDIxMTIxOVoXDTIxMDkzMDE0MDExNVow
+PzEkMCIGA1UEChMbRGlnaXRhbCBTaWduYXR1cmUgVHJ1c3QgQ28uMRcwFQYDVQQD
+Ew5EU1QgUm9vdCBDQSBYMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB
+AN+v6ZdQCINXtMxiZfaQguzH0yxrMMpb7NnDfcdAwRgUi+DoM3ZJKuM/IUmTrE4O
+rz5Iy2Xu/NMhD2XSKtkyj4zl93ewEnu1lcCJo6m67XMuegwGMoOifooUMM0RoOEq
+OLl5CjH9UL2AZd+3UWODyOKIYepLYYHsUmu5ouJLGiifSKOeDNoJjj4XLh7dIN9b
+xiqKqy69cK3FCxolkHRyxXtqqzTWMIn/5WgTe1QLyNau7Fqckh49ZLOMxt+/yUFw
+7BZy1SbsOFU5Q9D8/RhcQPGX69Wam40dutolucbY38EVAjqr2m7xPi71XAicPNaD
+aeQQmxkqtilX4+U9m5/wAl0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNV
+HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFMSnsaR7LHH62+FLkHX/xBVghYkQMA0GCSqG
+SIb3DQEBBQUAA4IBAQCjGiybFwBcqR7uKGY3Or+Dxz9LwwmglSBd49lZRNI+DT69
+ikugdB/OEIKcdBodfpga3csTS7MgROSR6cz8faXbauX+5v3gTt23ADq1cEmv8uXr
+AvHRAosZy5Q6XkjEGB5YGV8eAlrwDPGxrancWYaLbumR9YbK+rlmM6pZW87ipxZz
+R8srzJmwN0jP41ZL9c8PDHIyh8bwRLtTcm1D9SZImlJnt1ir/md2cXjbDaJWFBM5
+JDGFoqgCWjBH4d1QB7wCCZAA62RjYJsWvIjJEubSfZGL+T0yjWW06XyxV3bqxbYo
+Ob8VZRzI9neWagqNdwvYkQsEjgfbKbYK7p2CNTUQ
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Gold CA - G2 O=SwissSign AG
+# Label: "SwissSign Gold CA - G2"
+# Serial: 13492815561806991280
+# MD5 Fingerprint: 24:77:d9:a8:91:d1:3b:fa:88:2d:c2:ff:f8:cd:33:93
+# SHA1 Fingerprint: d8:c5:38:8a:b7:30:1b:1b:6e:d4:7a:e6:45:25:3a:6f:9f:1a:27:61
+# SHA256 Fingerprint: 62:dd:0b:e9:b9:f5:0a:16:3e:a0:f8:e7:5c:05:3b:1e:ca:57:ea:55:c8:68:8f:64:7c:68:81:f2:c8:35:7b:95
+-----BEGIN CERTIFICATE-----
+MIIFujCCA6KgAwIBAgIJALtAHEP1Xk+wMA0GCSqGSIb3DQEBBQUAMEUxCzAJBgNV
+BAYTAkNIMRUwEwYDVQQKEwxTd2lzc1NpZ24gQUcxHzAdBgNVBAMTFlN3aXNzU2ln
+biBHb2xkIENBIC0gRzIwHhcNMDYxMDI1MDgzMDM1WhcNMzYxMDI1MDgzMDM1WjBF
+MQswCQYDVQQGEwJDSDEVMBMGA1UEChMMU3dpc3NTaWduIEFHMR8wHQYDVQQDExZT
+d2lzc1NpZ24gR29sZCBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
+CgKCAgEAr+TufoskDhJuqVAtFkQ7kpJcyrhdhJJCEyq8ZVeCQD5XJM1QiyUqt2/8
+76LQwB8CJEoTlo8jE+YoWACjR8cGp4QjK7u9lit/VcyLwVcfDmJlD909Vopz2q5+
+bbqBHH5CjCA12UNNhPqE21Is8w4ndwtrvxEvcnifLtg+5hg3Wipy+dpikJKVyh+c
+6bM8K8vzARO/Ws/BtQpgvd21mWRTuKCWs2/iJneRjOBiEAKfNA+k1ZIzUd6+jbqE
+emA8atufK+ze3gE/bk3lUIbLtK/tREDFylqM2tIrfKjuvqblCqoOpd8FUrdVxyJd
+MmqXl2MT28nbeTZ7hTpKxVKJ+STnnXepgv9VHKVxaSvRAiTysybUa9oEVeXBCsdt
+MDeQKuSeFDNeFhdVxVu1yzSJkvGdJo+hB9TGsnhQ2wwMC3wLjEHXuendjIj3o02y
+MszYF9rNt85mndT9Xv+9lz4pded+p2JYryU0pUHHPbwNUMoDAw8IWh+Vc3hiv69y
+FGkOpeUDDniOJihC8AcLYiAQZzlG+qkDzAQ4embvIIO1jEpWjpEA/I5cgt6IoMPi
+aG59je883WX0XaxR7ySArqpWl2/5rX3aYT+YdzylkbYcjCbaZaIJbcHiVOO5ykxM
+gI93e2CaHt+28kgeDrpOVG2Y4OGiGqJ3UM/EY5LsRxmd6+ZrzsECAwEAAaOBrDCB
+qTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUWyV7
+lqRlUX64OfPAeGZe6Drn8O4wHwYDVR0jBBgwFoAUWyV7lqRlUX64OfPAeGZe6Drn
+8O4wRgYDVR0gBD8wPTA7BglghXQBWQECAQEwLjAsBggrBgEFBQcCARYgaHR0cDov
+L3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIBACe6
+45R88a7A3hfm5djV9VSwg/S7zV4Fe0+fdWavPOhWfvxyeDgD2StiGwC5+OlgzczO
+UYrHUDFu4Up+GC9pWbY9ZIEr44OE5iKHjn3g7gKZYbge9LgriBIWhMIxkziWMaa5
+O1M/wySTVltpkuzFwbs4AOPsF6m43Md8AYOfMke6UiI0HTJ6CVanfCU2qT1L2sCC
+bwq7EsiHSycR+R4tx5M/nttfJmtS2S6K8RTGRI0Vqbe/vd6mGu6uLftIdxf+u+yv
+GPUqUfA5hJeVbG4bwyvEdGB5JbAKJ9/fXtI5z0V9QkvfsywexcZdylU6oJxpmo/a
+77KwPJ+HbBIrZXAVUjEaJM9vMSNQH4xPjyPDdEFjHFWoFN0+4FFQz/EbMFYOkrCC
+hdiDyyJkvC24JdVUorgG6q2SpCSgwYa1ShNqR88uC1aVVMvOmttqtKay20EIhid3
+92qgQmwLOM7XdVAyksLfKzAiSNDVQTglXaTpXZ/GlHXQRf0wl0OPkKsKx4ZzYEpp
+Ld6leNcG2mqeSz53OiATIgHQv2ieY2BrNU0LbbqhPcCT4H8js1WtciVORvnSFu+w
+ZMEBnunKoGqYDs/YYPIvSbjkQuE4NRb0yG5P94FW6LqjviOvrv1vA+ACOzB2+htt
+Qc8Bsem4yWb02ybzOqR08kkkW8mw0FfB+j564ZfJ
+-----END CERTIFICATE-----
+
+# Issuer: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Subject: CN=SwissSign Silver CA - G2 O=SwissSign AG
+# Label: "SwissSign Silver CA - G2"
+# Serial: 5700383053117599563
+# MD5 Fingerprint: e0:06:a1:c9:7d:cf:c9:fc:0d:c0:56:75:96:d8:62:13
+# SHA1 Fingerprint: 9b:aa:e5:9f:56:ee:21:cb:43:5a:be:25:93:df:a7:f0:40:d1:1d:cb
+# SHA256 Fingerprint: be:6c:4d:a2:bb:b9:ba:59:b6:f3:93:97:68:37:42:46:c3:c0:05:99:3f:a9:8f:02:0d:1d:ed:be:d4:8a:81:d5
+-----BEGIN CERTIFICATE-----
+MIIFvTCCA6WgAwIBAgIITxvUL1S7L0swDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UE
+BhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMYU3dpc3NTaWdu
+IFNpbHZlciBDQSAtIEcyMB4XDTA2MTAyNTA4MzI0NloXDTM2MTAyNTA4MzI0Nlow
+RzELMAkGA1UEBhMCQ0gxFTATBgNVBAoTDFN3aXNzU2lnbiBBRzEhMB8GA1UEAxMY
+U3dpc3NTaWduIFNpbHZlciBDQSAtIEcyMIICIjANBgkqhkiG9w0BAQEFAAOCAg8A
+MIICCgKCAgEAxPGHf9N4Mfc4yfjDmUO8x/e8N+dOcbpLj6VzHVxumK4DV644N0Mv
+Fz0fyM5oEMF4rhkDKxD6LHmD9ui5aLlV8gREpzn5/ASLHvGiTSf5YXu6t+WiE7br
+YT7QbNHm+/pe7R20nqA1W6GSy/BJkv6FCgU+5tkL4k+73JU3/JHpMjUi0R86TieF
+nbAVlDLaYQ1HTWBCrpJH6INaUFjpiou5XaHc3ZlKHzZnu0jkg7Y360g6rw9njxcH
+6ATK72oxh9TAtvmUcXtnZLi2kUpCe2UuMGoM9ZDulebyzYLs2aFK7PayS+VFheZt
+eJMELpyCbTapxDFkH4aDCyr0NQp4yVXPQbBH6TCfmb5hqAaEuSh6XzjZG6k4sIN/
+c8HDO0gqgg8hm7jMqDXDhBuDsz6+pJVpATqJAHgE2cn0mRmrVn5bi4Y5FZGkECwJ
+MoBgs5PAKrYYC51+jUnyEEp/+dVGLxmSo5mnJqy7jDzmDrxHB9xzUfFwZC8I+bRH
+HTBsROopN4WSaGa8gzj+ezku01DwH/teYLappvonQfGbGHLy9YR0SslnxFSuSGTf
+jNFusB3hB48IHpmccelM2KX3RxIfdNFRnobzwqIjQAtz20um53MGjMGg6cFZrEb6
+5i/4z3GcRm25xBWNOHkDRUjvxF3XCO6HOSKGsg0PWEP3calILv3q1h8CAwEAAaOB
+rDCBqTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
+F6DNweRBtjpbO8tFnb0cwpj6hlgwHwYDVR0jBBgwFoAUF6DNweRBtjpbO8tFnb0c
+wpj6hlgwRgYDVR0gBD8wPTA7BglghXQBWQEDAQEwLjAsBggrBgEFBQcCARYgaHR0
+cDovL3JlcG9zaXRvcnkuc3dpc3NzaWduLmNvbS8wDQYJKoZIhvcNAQEFBQADggIB
+AHPGgeAn0i0P4JUw4ppBf1AsX19iYamGamkYDHRJ1l2E6kFSGG9YrVBWIGrGvShp
+WJHckRE1qTodvBqlYJ7YH39FkWnZfrt4csEGDyrOj4VwYaygzQu4OSlWhDJOhrs9
+xCrZ1x9y7v5RoSJBsXECYxqCsGKrXlcSH9/L3XWgwF15kIwb4FDm3jH+mHtwX6WQ
+2K34ArZv02DdQEsixT2tOnqfGhpHkXkzuoLcMmkDlm4fS/Bx/uNncqCxv1yL5PqZ
+IseEuRuNI5c/7SXgz2W79WEE790eslpBIlqhn10s6FvJbakMDHiqYMZWjwFaDGi8
+aRl5xB9+lwW/xekkUV7U1UtT7dkjWjYDZaPBA61BMPNGG4WQr2W11bHkFlt4dR2X
+em1ZqSqPe97Dh4kQmUlzeMg9vVE1dCrV8X5pGyq7O70luJpaPXJhkGaH7gzWTdQR
+dAtq/gsD/KNVV4n+SsuuWxcFyPKNIzFTONItaj+CuY0IavdeQXRuwxF+B6wpYJE/
+OMpXEA29MC/HpeZBoNquBYeaoKRlbEwJDIm6uNO5wJOKMPqN5ZprFQFOZ6raYlY+
+hAhm0sQ2fac+EPyI4NSA5QC9qvNOBqN6avlicuMJT+ubDgEj8Z+7fNzcbBGXJbLy
+tGMU0gYqZ4yD9c7qB9iaah7s5Aq7KkzrCWA5zspi2C5u
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Primary Certification Authority O=GeoTrust Inc.
+# Subject: CN=GeoTrust Primary Certification Authority O=GeoTrust Inc.
+# Label: "GeoTrust Primary Certification Authority"
+# Serial: 32798226551256963324313806436981982369
+# MD5 Fingerprint: 02:26:c3:01:5e:08:30:37:43:a9:d0:7d:cf:37:e6:bf
+# SHA1 Fingerprint: 32:3c:11:8e:1b:f7:b8:b6:52:54:e2:e2:10:0d:d6:02:90:37:f0:96
+# SHA256 Fingerprint: 37:d5:10:06:c5:12:ea:ab:62:64:21:f1:ec:8c:92:01:3f:c5:f8:2a:e9:8e:e5:33:eb:46:19:b8:de:b4:d0:6c
+-----BEGIN CERTIFICATE-----
+MIIDfDCCAmSgAwIBAgIQGKy1av1pthU6Y2yv2vrEoTANBgkqhkiG9w0BAQUFADBY
+MQswCQYDVQQGEwJVUzEWMBQGA1UEChMNR2VvVHJ1c3QgSW5jLjExMC8GA1UEAxMo
+R2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEx
+MjcwMDAwMDBaFw0zNjA3MTYyMzU5NTlaMFgxCzAJBgNVBAYTAlVTMRYwFAYDVQQK
+Ew1HZW9UcnVzdCBJbmMuMTEwLwYDVQQDEyhHZW9UcnVzdCBQcmltYXJ5IENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEAvrgVe//UfH1nrYNke8hCUy3f9oQIIGHWAVlqnEQRr+92/ZV+zmEwu3qDXwK9
+AWbK7hWNb6EwnL2hhZ6UOvNWiAAxz9juapYC2e0DjPt1befquFUWBRaa9OBesYjA
+ZIVcFU2Ix7e64HXprQU9nceJSOC7KMgD4TCTZF5SwFlwIjVXiIrxlQqD17wxcwE0
+7e9GceBrAqg1cmuXm2bgyxx5X9gaBGgeRwLmnWDiNpcB3841kt++Z8dtd1k7j53W
+kBWUvEI0EME5+bEnPn7WinXFsq+W06Lem+SYvn3h6YGttm/81w7a4DSwDRp35+MI
+mO9Y+pyEtzavwt+s0vQQBnBxNQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQULNVQQZcVi/CPNmFbSvtr2ZnJM5IwDQYJ
+KoZIhvcNAQEFBQADggEBAFpwfyzdtzRP9YZRqSa+S7iq8XEN3GHHoOo0Hnp3DwQ1
+6CePbJC/kRYkRj5KTs4rFtULUh38H2eiAkUxT87z+gOneZ1TatnaYzr4gNfTmeGl
+4b7UVXGYNTq+k+qurUKykG/g/CFNNWMziUnWm07Kx+dOCQD32sfvmWKZd7aVIl6K
+oKv0uHiYyjgZmclynnjNS6yvGaBzEi38wkG6gZHaFloxt/m0cYASSJlyc1pZU8Fj
+UjPtp8nSOQJw+uCxQmYpqptR7TBUIhRf2asdweSU8Pj1K/fqynhG1riR/aYNKxoU
+AT6A8EKglQdebc3MS6RFjasS6LPeWuWgfOgPIh1a6Vk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=thawte Primary Root CA O=thawte, Inc. OU=Certification Services Division/(c) 2006 thawte, Inc. - For authorized use only
+# Subject: CN=thawte Primary Root CA O=thawte, Inc. OU=Certification Services Division/(c) 2006 thawte, Inc. - For authorized use only
+# Label: "thawte Primary Root CA"
+# Serial: 69529181992039203566298953787712940909
+# MD5 Fingerprint: 8c:ca:dc:0b:22:ce:f5:be:72:ac:41:1a:11:a8:d8:12
+# SHA1 Fingerprint: 91:c6:d6:ee:3e:8a:c8:63:84:e5:48:c2:99:29:5c:75:6c:81:7b:81
+# SHA256 Fingerprint: 8d:72:2f:81:a9:c1:13:c0:79:1d:f1:36:a2:96:6d:b2:6c:95:0a:97:1d:b4:6b:41:99:f4:ea:54:b7:8b:fb:9f
+-----BEGIN CERTIFICATE-----
+MIIEIDCCAwigAwIBAgIQNE7VVyDV7exJ9C/ON9srbTANBgkqhkiG9w0BAQUFADCB
+qTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYGA1UECxMf
+Q2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMvKGMpIDIw
+MDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxHzAdBgNV
+BAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwHhcNMDYxMTE3MDAwMDAwWhcNMzYw
+NzE2MjM1OTU5WjCBqTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5j
+LjEoMCYGA1UECxMfQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYG
+A1UECxMvKGMpIDIwMDYgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNl
+IG9ubHkxHzAdBgNVBAMTFnRoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCsoPD7gFnUnMekz52hWXMJEEUMDSxuaPFs
+W0hoSVk3/AszGcJ3f8wQLZU0HObrTQmnHNK4yZc2AreJ1CRfBsDMRJSUjQJib+ta
+3RGNKJpchJAQeg29dGYvajig4tVUROsdB58Hum/u6f1OCyn1PoSgAfGcq/gcfomk
+6KHYcWUNo1F77rzSImANuVud37r8UVsLr5iy6S7pBOhih94ryNdOwUxkHt3Ph1i6
+Sk/KaAcdHJ1KxtUvkcx8cXIcxcBn6zL9yZJclNqFwJu/U30rCfSMnZEfl2pSy94J
+NqR32HuHUETVPm4pafs5SSYeCaWAe0At6+gnhcn+Yf1+5nyXHdWdAgMBAAGjQjBA
+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBR7W0XP
+r87Lev0xkhpqtvNG61dIUDANBgkqhkiG9w0BAQUFAAOCAQEAeRHAS7ORtvzw6WfU
+DW5FvlXok9LOAz/t2iWwHVfLHjp2oEzsUHboZHIMpKnxuIvW1oeEuzLlQRHAd9mz
+YJ3rG9XRbkREqaYB7FViHXe4XI5ISXycO1cRrK1zN44veFyQaEfZYGDm/Ac9IiAX
+xPcW6cTYcvnIc3zfFi8VqT79aie2oetaupgf1eNNZAqdE8hhuvU5HIe6uL17In/2
+/qxAeeWsEG89jxt5dovEN7MhGITlNgDrYyCZuen+MwS7QcjBAvlEYyCegc5C09Y/
+LHbTY5xZ3Y+m4Q6gLkH3LpVHz7z9M/P2C2F+fpErgUfCJzDupxBdN49cOSvkBPB7
+jVaMaA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G5 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2006 VeriSign, Inc. - For authorized use only
+# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G5 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2006 VeriSign, Inc. - For authorized use only
+# Label: "VeriSign Class 3 Public Primary Certification Authority - G5"
+# Serial: 33037644167568058970164719475676101450
+# MD5 Fingerprint: cb:17:e4:31:67:3e:e2:09:fe:45:57:93:f3:0a:fa:1c
+# SHA1 Fingerprint: 4e:b6:d5:78:49:9b:1c:cf:5f:58:1e:ad:56:be:3d:9b:67:44:a5:e5
+# SHA256 Fingerprint: 9a:cf:ab:7e:43:c8:d8:80:d0:6b:26:2a:94:de:ee:e4:b4:65:99:89:c3:d0:ca:f1:9b:af:64:05:e4:1a:b7:df
+-----BEGIN CERTIFICATE-----
+MIIE0zCCA7ugAwIBAgIQGNrRniZ96LtKIVjNzGs7SjANBgkqhkiG9w0BAQUFADCB
+yjELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQL
+ExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNiBWZXJp
+U2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxW
+ZXJpU2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0
+aG9yaXR5IC0gRzUwHhcNMDYxMTA4MDAwMDAwWhcNMzYwNzE2MjM1OTU5WjCByjEL
+MAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZW
+ZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNiBWZXJpU2ln
+biwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJp
+U2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9y
+aXR5IC0gRzUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvJAgIKXo1
+nmAMqudLO07cfLw8RRy7K+D+KQL5VwijZIUVJ/XxrcgxiV0i6CqqpkKzj/i5Vbex
+t0uz/o9+B1fs70PbZmIVYc9gDaTY3vjgw2IIPVQT60nKWVSFJuUrjxuf6/WhkcIz
+SdhDY2pSS9KP6HBRTdGJaXvHcPaz3BJ023tdS1bTlr8Vd6Gw9KIl8q8ckmcY5fQG
+BO+QueQA5N06tRn/Arr0PO7gi+s3i+z016zy9vA9r911kTMZHRxAy3QkGSGT2RT+
+rCpSx4/VBEnkjWNHiDxpg8v+R70rfk/Fla4OndTRQ8Bnc+MUCH7lP59zuDMKz10/
+NIeWiu5T6CUVAgMBAAGjgbIwga8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8E
+BAMCAQYwbQYIKwYBBQUHAQwEYTBfoV2gWzBZMFcwVRYJaW1hZ2UvZ2lmMCEwHzAH
+BgUrDgMCGgQUj+XTGoasjY5rw8+AatRIGCx7GS4wJRYjaHR0cDovL2xvZ28udmVy
+aXNpZ24uY29tL3ZzbG9nby5naWYwHQYDVR0OBBYEFH/TZafC3ey78DAJ80M5+gKv
+MzEzMA0GCSqGSIb3DQEBBQUAA4IBAQCTJEowX2LP2BqYLz3q3JktvXf2pXkiOOzE
+p6B4Eq1iDkVwZMXnl2YtmAl+X6/WzChl8gGqCBpH3vn5fJJaCGkgDdk+bW48DW7Y
+5gaRQBi5+MHt39tBquCWIMnNZBU4gcmU7qKEKQsTb47bDN0lAtukixlE0kF6BWlK
+WE9gyn6CagsCqiUXObXbf+eEZSqVir2G3l6BFoMtEMze/aiCKm0oHw0LxOXnGiYZ
+4fQRbxC1lfznQgUy286dUV4otp6F01vvpX1FQHKOtw5rDgb7MzVIcbidJ4vEZV8N
+hnacRHr2lVz2XTIIM6RUthg/aFzyQkqFOFSDX9HoLPKsEdao7WNq
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureTrust CA O=SecureTrust Corporation
+# Subject: CN=SecureTrust CA O=SecureTrust Corporation
+# Label: "SecureTrust CA"
+# Serial: 17199774589125277788362757014266862032
+# MD5 Fingerprint: dc:32:c3:a7:6d:25:57:c7:68:09:9d:ea:2d:a9:a2:d1
+# SHA1 Fingerprint: 87:82:c6:c3:04:35:3b:cf:d2:96:92:d2:59:3e:7d:44:d9:34:ff:11
+# SHA256 Fingerprint: f1:c1:b5:0a:e5:a2:0d:d8:03:0e:c9:f6:bc:24:82:3d:d3:67:b5:25:57:59:b4:e7:1b:61:fc:e9:f7:37:5d:73
+-----BEGIN CERTIFICATE-----
+MIIDuDCCAqCgAwIBAgIQDPCOXAgWpa1Cf/DrJxhZ0DANBgkqhkiG9w0BAQUFADBI
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+FzAVBgNVBAMTDlNlY3VyZVRydXN0IENBMB4XDTA2MTEwNzE5MzExOFoXDTI5MTIz
+MTE5NDA1NVowSDELMAkGA1UEBhMCVVMxIDAeBgNVBAoTF1NlY3VyZVRydXN0IENv
+cnBvcmF0aW9uMRcwFQYDVQQDEw5TZWN1cmVUcnVzdCBDQTCCASIwDQYJKoZIhvcN
+AQEBBQADggEPADCCAQoCggEBAKukgeWVzfX2FI7CT8rU4niVWJxB4Q2ZQCQXOZEz
+Zum+4YOvYlyJ0fwkW2Gz4BERQRwdbvC4u/jep4G6pkjGnx29vo6pQT64lO0pGtSO
+0gMdA+9tDWccV9cGrcrI9f4Or2YlSASWC12juhbDCE/RRvgUXPLIXgGZbf2IzIao
+wW8xQmxSPmjL8xk037uHGFaAJsTQ3MBv396gwpEWoGQRS0S8Hvbn+mPeZqx2pHGj
+7DaUaHp3pLHnDi+BeuK1cobvomuL8A/b01k/unK8RCSc43Oz969XL0Imnal0ugBS
+8kvNU3xHCzaFDmapCJcWNFfBZveA4+1wVMeT4C4oFVmHursCAwEAAaOBnTCBmjAT
+BgkrBgEEAYI3FAIEBh4EAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQUQjK2FvoE/f5dS3rD/fdMQB1aQ68wNAYDVR0fBC0wKzApoCeg
+JYYjaHR0cDovL2NybC5zZWN1cmV0cnVzdC5jb20vU1RDQS5jcmwwEAYJKwYBBAGC
+NxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBADDtT0rhWDpSclu1pqNlGKa7UTt3
+6Z3q059c4EVlew3KW+JwULKUBRSuSceNQQcSc5R+DCMh/bwQf2AQWnL1mA6s7Ll/
+3XpvXdMc9P+IBWlCqQVxyLesJugutIxq/3HcuLHfmbx8IVQr5Fiiu1cprp6poxkm
+D5kuCLDv/WnPmRoJjeOnnyvJNjR7JLN4TJUXpAYmHrZkUjZfYGfZnMUFdAvnZyPS
+CPyI6a6Lf+Ew9Dd+/cYy2i2eRDAwbO4H3tI0/NL/QPZL9GZGBlSm8jIKYyYwa5vR
+3ItHuuG51WLQoqD0ZwV4KWMabwTW+MZMo5qxN7SN5ShLHZ4swrhovO0C7jE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Secure Global CA O=SecureTrust Corporation
+# Subject: CN=Secure Global CA O=SecureTrust Corporation
+# Label: "Secure Global CA"
+# Serial: 9751836167731051554232119481456978597
+# MD5 Fingerprint: cf:f4:27:0d:d4:ed:dc:65:16:49:6d:3d:da:bf:6e:de
+# SHA1 Fingerprint: 3a:44:73:5a:e5:81:90:1f:24:86:61:46:1e:3b:9c:c4:5f:f5:3a:1b
+# SHA256 Fingerprint: 42:00:f5:04:3a:c8:59:0e:bb:52:7d:20:9e:d1:50:30:29:fb:cb:d4:1c:a1:b5:06:ec:27:f1:5a:de:7d:ac:69
+-----BEGIN CERTIFICATE-----
+MIIDvDCCAqSgAwIBAgIQB1YipOjUiolN9BPI8PjqpTANBgkqhkiG9w0BAQUFADBK
+MQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3QgQ29ycG9yYXRpb24x
+GTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwHhcNMDYxMTA3MTk0MjI4WhcNMjkx
+MjMxMTk1MjA2WjBKMQswCQYDVQQGEwJVUzEgMB4GA1UEChMXU2VjdXJlVHJ1c3Qg
+Q29ycG9yYXRpb24xGTAXBgNVBAMTEFNlY3VyZSBHbG9iYWwgQ0EwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQCvNS7YrGxVaQZx5RNoJLNP2MwhR/jxYDiJ
+iQPpvepeRlMJ3Fz1Wuj3RSoC6zFh1ykzTM7HfAo3fg+6MpjhHZevj8fcyTiW89sa
+/FHtaMbQbqR8JNGuQsiWUGMu4P51/pinX0kuleM5M2SOHqRfkNJnPLLZ/kG5VacJ
+jnIFHovdRIWCQtBJwB1g8NEXLJXr9qXBkqPFwqcIYA1gBBCWeZ4WNOaptvolRTnI
+HmX5k/Wq8VLcmZg9pYYaDDUz+kulBAYVHDGA76oYa8J719rO+TMg1fW9ajMtgQT7
+sFzUnKPiXB3jqUJ1XnvUd+85VLrJChgbEplJL4hL/VBi0XPnj3pDAgMBAAGjgZ0w
+gZowEwYJKwYBBAGCNxQCBAYeBABDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQF
+MAMBAf8wHQYDVR0OBBYEFK9EBMJBfkiD2045AuzshHrmzsmkMDQGA1UdHwQtMCsw
+KaAnoCWGI2h0dHA6Ly9jcmwuc2VjdXJldHJ1c3QuY29tL1NHQ0EuY3JsMBAGCSsG
+AQQBgjcVAQQDAgEAMA0GCSqGSIb3DQEBBQUAA4IBAQBjGghAfaReUw132HquHw0L
+URYD7xh8yOOvaliTFGCRsoTciE6+OYo68+aCiV0BN7OrJKQVDpI1WkpEXk5X+nXO
+H0jOZvQ8QCaSmGwb7iRGDBezUqXbpZGRzzfTb+cnCDpOGR86p1hcF895P4vkp9Mm
+I50mD1hp/Ed+stCNi5O/KU9DaXR2Z0vPB4zmAve14bRDtUstFJ/53CYNv6ZHdAbY
+iNE6KTCEztI5gGIbqMdXSbxqVVFnFUq+NQfk1XWYN3kwFNspnWzFacxHVaIw98xc
+f8LDmBxrThaA63p4ZUWiABqvDA1VZDRIuJK58bRQKfJPIx/abKwfROHdI3hRW8cW
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO Certification Authority O=COMODO CA Limited
+# Label: "COMODO Certification Authority"
+# Serial: 104350513648249232941998508985834464573
+# MD5 Fingerprint: 5c:48:dc:f7:42:72:ec:56:94:6d:1c:cc:71:35:80:75
+# SHA1 Fingerprint: 66:31:bf:9e:f7:4f:9e:b6:c9:d5:a6:0c:ba:6a:be:d1:f7:bd:ef:7b
+# SHA256 Fingerprint: 0c:2c:d6:3d:f7:80:6f:a3:99:ed:e8:09:11:6b:57:5b:f8:79:89:f0:65:18:f9:80:8c:86:05:03:17:8b:af:66
+-----BEGIN CERTIFICATE-----
+MIIEHTCCAwWgAwIBAgIQToEtioJl4AsC7j41AkblPTANBgkqhkiG9w0BAQUFADCB
+gTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxJzAlBgNV
+BAMTHkNPTU9ETyBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAeFw0wNjEyMDEwMDAw
+MDBaFw0yOTEyMzEyMzU5NTlaMIGBMQswCQYDVQQGEwJHQjEbMBkGA1UECBMSR3Jl
+YXRlciBNYW5jaGVzdGVyMRAwDgYDVQQHEwdTYWxmb3JkMRowGAYDVQQKExFDT01P
+RE8gQ0EgTGltaXRlZDEnMCUGA1UEAxMeQ09NT0RPIENlcnRpZmljYXRpb24gQXV0
+aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA0ECLi3LjkRv3
+UcEbVASY06m/weaKXTuH+7uIzg3jLz8GlvCiKVCZrts7oVewdFFxze1CkU1B/qnI
+2GqGd0S7WWaXUF601CxwRM/aN5VCaTwwxHGzUvAhTaHYujl8HJ6jJJ3ygxaYqhZ8
+Q5sVW7euNJH+1GImGEaaP+vB+fGQV+useg2L23IwambV4EajcNxo2f8ESIl33rXp
++2dtQem8Ob0y2WIC8bGoPW43nOIv4tOiJovGuFVDiOEjPqXSJDlqR6sA1KGzqSX+
+DT+nHbrTUcELpNqsOO9VUCQFZUaTNE8tja3G1CEZ0o7KBWFxB3NH5YoZEr0ETc5O
+nKVIrLsm9wIDAQABo4GOMIGLMB0GA1UdDgQWBBQLWOWLxkwVN6RAqTCpIb5HNlpW
+/zAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zBJBgNVHR8EQjBAMD6g
+PKA6hjhodHRwOi8vY3JsLmNvbW9kb2NhLmNvbS9DT01PRE9DZXJ0aWZpY2F0aW9u
+QXV0aG9yaXR5LmNybDANBgkqhkiG9w0BAQUFAAOCAQEAPpiem/Yb6dc5t3iuHXIY
+SdOH5EOC6z/JqvWote9VfCFSZfnVDeFs9D6Mk3ORLgLETgdxb8CPOGEIqB6BCsAv
+IC9Bi5HcSEW88cbeunZrM8gALTFGTO3nnc+IlP8zwFboJIYmuNg4ON8qa90SzMc/
+RxdMosIGlgnW2/4/PEZB31jiVg88O8EckzXZOFKs7sjsLjBOlDW0JB9LeGna8gI4
+zJVSk/BwJVmcIGfE7vmLV2H0knZ9P4SNVbfo5azV8fUZVqZa+5Acr5Pr5RzUZ5dd
+BA6+C4OmF4O5MBKgxTMVBbkN+8cFduPYSo38NBejxiEovjBFMR7HeL5YYTisO+IB
+ZQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
+# Subject: CN=Network Solutions Certificate Authority O=Network Solutions L.L.C.
+# Label: "Network Solutions Certificate Authority"
+# Serial: 116697915152937497490437556386812487904
+# MD5 Fingerprint: d3:f3:a6:16:c0:fa:6b:1d:59:b1:2d:96:4d:0e:11:2e
+# SHA1 Fingerprint: 74:f8:a3:c3:ef:e7:b3:90:06:4b:83:90:3c:21:64:60:20:e5:df:ce
+# SHA256 Fingerprint: 15:f0:ba:00:a3:ac:7a:f3:ac:88:4c:07:2b:10:11:a0:77:bd:77:c0:97:f4:01:64:b2:f8:59:8a:bd:83:86:0c
+-----BEGIN CERTIFICATE-----
+MIID5jCCAs6gAwIBAgIQV8szb8JcFuZHFhfjkDFo4DANBgkqhkiG9w0BAQUFADBi
+MQswCQYDVQQGEwJVUzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMu
+MTAwLgYDVQQDEydOZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3Jp
+dHkwHhcNMDYxMjAxMDAwMDAwWhcNMjkxMjMxMjM1OTU5WjBiMQswCQYDVQQGEwJV
+UzEhMB8GA1UEChMYTmV0d29yayBTb2x1dGlvbnMgTC5MLkMuMTAwLgYDVQQDEydO
+ZXR3b3JrIFNvbHV0aW9ucyBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkwggEiMA0GCSqG
+SIb3DQEBAQUAA4IBDwAwggEKAoIBAQDkvH6SMG3G2I4rC7xGzuAnlt7e+foS0zwz
+c7MEL7xxjOWftiJgPl9dzgn/ggwbmlFQGiaJ3dVhXRncEg8tCqJDXRfQNJIg6nPP
+OCwGJgl6cvf6UDL4wpPTaaIjzkGxzOTVHzbRijr4jGPiFFlp7Q3Tf2vouAPlT2rl
+mGNpSAW+Lv8ztumXWWn4Zxmuk2GWRBXTcrA/vGp97Eh/jcOrqnErU2lBUzS1sLnF
+BgrEsEX1QV1uiUV7PTsmjHTC5dLRfbIR1PtYMiKagMnc/Qzpf14Dl847ABSHJ3A4
+qY5usyd2mFHgBeMhqxrVhSI8KbWaFsWAqPS7azCPL0YCorEMIuDTAgMBAAGjgZcw
+gZQwHQYDVR0OBBYEFCEwyfsA106Y2oeqKtCnLrFAMadMMA4GA1UdDwEB/wQEAwIB
+BjAPBgNVHRMBAf8EBTADAQH/MFIGA1UdHwRLMEkwR6BFoEOGQWh0dHA6Ly9jcmwu
+bmV0c29sc3NsLmNvbS9OZXR3b3JrU29sdXRpb25zQ2VydGlmaWNhdGVBdXRob3Jp
+dHkuY3JsMA0GCSqGSIb3DQEBBQUAA4IBAQC7rkvnt1frf6ott3NHhWrB5KUd5Oc8
+6fRZZXe1eltajSU24HqXLjjAV2CDmAaDn7l2em5Q4LqILPxFzBiwmZVRDuwduIj/
+h1AcgsLj4DKAv6ALR8jDMe+ZZzKATxcheQxpXN5eNK4CtSbqUN9/GGUsyfJj4akH
+/nxxH2szJGoeBfcFaMBqEssuXmHLrijTfsK0ZpEmXzwuJF/LWA/rKOyvEZbz3Htv
+wKeI8lN3s2Berq4o2jUsbzRF0ybh3uxbTydrFny9RAQYgrOJeRcQcT16ohZO9QHN
+pGxlaKFJdlxDydi8NmdspZS11My5vWo1ViHe2MPr+8ukYEywVaCge1ey
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO ECC Certification Authority O=COMODO CA Limited
+# Label: "COMODO ECC Certification Authority"
+# Serial: 41578283867086692638256921589707938090
+# MD5 Fingerprint: 7c:62:ff:74:9d:31:53:5e:68:4a:d5:78:aa:1e:bf:23
+# SHA1 Fingerprint: 9f:74:4e:9f:2b:4d:ba:ec:0f:31:2c:50:b6:56:3b:8e:2d:93:c3:11
+# SHA256 Fingerprint: 17:93:92:7a:06:14:54:97:89:ad:ce:2f:8f:34:f7:f0:b6:6d:0f:3a:e3:a3:b8:4d:21:ec:15:db:ba:4f:ad:c7
+-----BEGIN CERTIFICATE-----
+MIICiTCCAg+gAwIBAgIQH0evqmIAcFBUTAGem2OZKjAKBggqhkjOPQQDAzCBhTEL
+MAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UE
+BxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMT
+IkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwMzA2MDAw
+MDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdy
+ZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09N
+T0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBFQ0MgQ2VydGlmaWNhdGlv
+biBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQDR3svdcmCFYX7deSR
+FtSrYpn1PlILBs5BAH+X4QokPB0BBO490o0JlwzgdeT6+3eKKvUDYEs2ixYjFq0J
+cfRK9ChQtP6IHG4/bC8vCVlbpVsLM5niwz2J+Wos77LTBumjQjBAMB0GA1UdDgQW
+BBR1cacZSBm8nZ3qQUfflMRId5nTeTAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjEA7wNbeqy3eApyt4jf/7VGFAkK+qDm
+fQjGGoe9GKhzvSbKYAydzpmfz1wPMOG+FDHqAjAU9JM8SaczepBGR7NjfRObTrdv
+GDeAU/7dIOA1mjbRxwG55tzd8/8dLDoWV9mSOdY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GA CA O=WISeKey OU=Copyright (c) 2005/OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GA CA O=WISeKey OU=Copyright (c) 2005/OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GA CA"
+# Serial: 86718877871133159090080555911823548314
+# MD5 Fingerprint: bc:6c:51:33:a7:e9:d3:66:63:54:15:72:1b:21:92:93
+# SHA1 Fingerprint: 59:22:a1:e1:5a:ea:16:35:21:f8:98:39:6a:46:46:b0:44:1b:0f:a9
+# SHA256 Fingerprint: 41:c9:23:86:6a:b4:ca:d6:b7:ad:57:80:81:58:2e:02:07:97:a6:cb:df:4f:ff:78:ce:83:96:b3:89:37:d7:f5
+-----BEGIN CERTIFICATE-----
+MIID8TCCAtmgAwIBAgIQQT1yx/RrH4FDffHSKFTfmjANBgkqhkiG9w0BAQUFADCB
+ijELMAkGA1UEBhMCQ0gxEDAOBgNVBAoTB1dJU2VLZXkxGzAZBgNVBAsTEkNvcHly
+aWdodCAoYykgMjAwNTEiMCAGA1UECxMZT0lTVEUgRm91bmRhdGlvbiBFbmRvcnNl
+ZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwgUm9vdCBHQSBDQTAeFw0w
+NTEyMTExNjAzNDRaFw0zNzEyMTExNjA5NTFaMIGKMQswCQYDVQQGEwJDSDEQMA4G
+A1UEChMHV0lTZUtleTEbMBkGA1UECxMSQ29weXJpZ2h0IChjKSAyMDA1MSIwIAYD
+VQQLExlPSVNURSBGb3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBX
+SVNlS2V5IEdsb2JhbCBSb290IEdBIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
+MIIBCgKCAQEAy0+zAJs9Nt350UlqaxBJH+zYK7LG+DKBKUOVTJoZIyEVRd7jyBxR
+VVuuk+g3/ytr6dTqvirdqFEr12bDYVxgAsj1znJ7O7jyTmUIms2kahnBAbtzptf2
+w93NvKSLtZlhuAGio9RN1AU9ka34tAhxZK9w8RxrfvbDd50kc3vkDIzh2TbhmYsF
+mQvtRTEJysIA2/dyoJaqlYfQjse2YXMNdmaM3Bu0Y6Kff5MTMPGhJ9vZ/yxViJGg
+4E8HsChWjBgbl0SOid3gF27nKu+POQoxhILYQBRJLnpB5Kf+42TMwVlxSywhp1t9
+4B3RLoGbw9ho972WG6xwsRYUC9tguSYBBQIDAQABo1EwTzALBgNVHQ8EBAMCAYYw
+DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUswN+rja8sHnR3JQmthG+IbJphpQw
+EAYJKwYBBAGCNxUBBAMCAQAwDQYJKoZIhvcNAQEFBQADggEBAEuh/wuHbrP5wUOx
+SPMowB0uyQlB+pQAHKSkq0lPjz0e701vvbyk9vImMMkQyh2I+3QZH4VFvbBsUfk2
+ftv1TDI6QU9bR8/oCy22xBmddMVHxjtqD6wU2zz0c5ypBd8A3HR4+vg1YFkCExh8
+vPtNsCBtQ7tgMHpnM1zFmdH4LTlSc/uMqpclXHLZCB6rTjzjgTGfA6b7wP4piFXa
+hNVQA7bihKOmNqoROgHhGEvWRGizPflTdISzRpFGlgC3gCy24eMQ4tui5yiPAZZi
+Fj4A4xylNoEYokxSdsARo27mHbrjWr42U8U+dY+GaSlYU7Wcu2+fXMUY7N0v4ZjJ
+/L7fCg0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna O=Dhimyotis
+# Subject: CN=Certigna O=Dhimyotis
+# Label: "Certigna"
+# Serial: 18364802974209362175
+# MD5 Fingerprint: ab:57:a6:5b:7d:42:82:19:b5:d8:58:26:28:5e:fd:ff
+# SHA1 Fingerprint: b1:2e:13:63:45:86:a4:6f:1a:b2:60:68:37:58:2d:c4:ac:fd:94:97
+# SHA256 Fingerprint: e3:b6:a2:db:2e:d7:ce:48:84:2f:7a:c5:32:41:c7:b7:1d:54:14:4b:fb:40:c1:1f:3f:1d:0b:42:f5:ee:a1:2d
+-----BEGIN CERTIFICATE-----
+MIIDqDCCApCgAwIBAgIJAP7c4wEPyUj/MA0GCSqGSIb3DQEBBQUAMDQxCzAJBgNV
+BAYTAkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hMB4X
+DTA3MDYyOTE1MTMwNVoXDTI3MDYyOTE1MTMwNVowNDELMAkGA1UEBhMCRlIxEjAQ
+BgNVBAoMCURoaW15b3RpczERMA8GA1UEAwwIQ2VydGlnbmEwggEiMA0GCSqGSIb3
+DQEBAQUAA4IBDwAwggEKAoIBAQDIaPHJ1tazNHUmgh7stL7qXOEm7RFHYeGifBZ4
+QCHkYJ5ayGPhxLGWkv8YbWkj4Sti993iNi+RB7lIzw7sebYs5zRLcAglozyHGxny
+gQcPOJAZ0xH+hrTy0V4eHpbNgGzOOzGTtvKg0KmVEn2lmsxryIRWijOp5yIVUxbw
+zBfsV1/pogqYCd7jX5xv3EjjhQsVWqa6n6xI4wmy9/Qy3l40vhx4XUJbzg4ij02Q
+130yGLMLLGq/jj8UEYkgDncUtT2UCIf3JR7VsmAA7G8qKCVuKj4YYxclPz5EIBb2
+JsglrgVKtOdjLPOMFlN+XPsRGgjBRmKfIrjxwo1p3Po6WAbfAgMBAAGjgbwwgbkw
+DwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUGu3+QTmQtCRZvgHyUtVF9lo53BEw
+ZAYDVR0jBF0wW4AUGu3+QTmQtCRZvgHyUtVF9lo53BGhOKQ2MDQxCzAJBgNVBAYT
+AkZSMRIwEAYDVQQKDAlEaGlteW90aXMxETAPBgNVBAMMCENlcnRpZ25hggkA/tzj
+AQ/JSP8wDgYDVR0PAQH/BAQDAgEGMBEGCWCGSAGG+EIBAQQEAwIABzANBgkqhkiG
+9w0BAQUFAAOCAQEAhQMeknH2Qq/ho2Ge6/PAD/Kl1NqV5ta+aDY9fm4fTIrv0Q8h
+bV6lUmPOEvjvKtpv6zf+EwLHyzs+ImvaYS5/1HI93TDhHkxAGYwP15zRgzB7mFnc
+fca5DClMoTOi62c6ZYTTluLtdkVwj7Ur3vkj1kluPBS1xp81HlDQwY9qcEQCYsuu
+HWhBp6pX6FOqB9IG9tUUBguRA3UsbHK1YZWaDYu5Def131TN3ubY1gkIl2PlwS6w
+t0QmwCbAr1UwnjvVNioZBPRcHv/PLLf/0P2HQBHVESO7SMAhqaQoLf0V+LBOK/Qw
+WyH8EZE0vkHve52Xdf+XlcCWWC/qu0bXu+TZLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Cybertrust Global Root O=Cybertrust, Inc
+# Subject: CN=Cybertrust Global Root O=Cybertrust, Inc
+# Label: "Cybertrust Global Root"
+# Serial: 4835703278459682877484360
+# MD5 Fingerprint: 72:e4:4a:87:e3:69:40:80:77:ea:bc:e3:f4:ff:f0:e1
+# SHA1 Fingerprint: 5f:43:e5:b1:bf:f8:78:8c:ac:1c:c7:ca:4a:9a:c6:22:2b:cc:34:c6
+# SHA256 Fingerprint: 96:0a:df:00:63:e9:63:56:75:0c:29:65:dd:0a:08:67:da:0b:9c:bd:6e:77:71:4a:ea:fb:23:49:ab:39:3d:a3
+-----BEGIN CERTIFICATE-----
+MIIDoTCCAomgAwIBAgILBAAAAAABD4WqLUgwDQYJKoZIhvcNAQEFBQAwOzEYMBYG
+A1UEChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2Jh
+bCBSb290MB4XDTA2MTIxNTA4MDAwMFoXDTIxMTIxNTA4MDAwMFowOzEYMBYGA1UE
+ChMPQ3liZXJ0cnVzdCwgSW5jMR8wHQYDVQQDExZDeWJlcnRydXN0IEdsb2JhbCBS
+b290MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA+Mi8vRRQZhP/8NN5
+7CPytxrHjoXxEnOmGaoQ25yiZXRadz5RfVb23CO21O1fWLE3TdVJDm71aofW0ozS
+J8bi/zafmGWgE07GKmSb1ZASzxQG9Dvj1Ci+6A74q05IlG2OlTEQXO2iLb3VOm2y
+HLtgwEZLAfVJrn5GitB0jaEMAs7u/OePuGtm839EAL9mJRQr3RAwHQeWP032a7iP
+t3sMpTjr3kfb1V05/Iin89cqdPHoWqI7n1C6poxFNcJQZZXcY4Lv3b93TZxiyWNz
+FtApD0mpSPCzqrdsxacwOUBdrsTiXSZT8M4cIwhhqJQZugRiQOwfOHB3EgZxpzAY
+XSUnpQIDAQABo4GlMIGiMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/
+MB0GA1UdDgQWBBS2CHsNesysIEyGVjJez6tuhS1wVzA/BgNVHR8EODA2MDSgMqAw
+hi5odHRwOi8vd3d3Mi5wdWJsaWMtdHJ1c3QuY29tL2NybC9jdC9jdHJvb3QuY3Js
+MB8GA1UdIwQYMBaAFLYIew16zKwgTIZWMl7Pq26FLXBXMA0GCSqGSIb3DQEBBQUA
+A4IBAQBW7wojoFROlZfJ+InaRcHUowAl9B8Tq7ejhVhpwjCt2BWKLePJzYFa+HMj
+Wqd8BfP9IjsO0QbE2zZMcwSO5bAi5MXzLqXZI+O4Tkogp24CJJ8iYGd7ix1yCcUx
+XOl5n4BHPa2hCwcUPUf/A2kaDAtE52Mlp3+yybh2hO0j9n0Hq0V+09+zv+mKts2o
+omcrUtW3ZfA5TGOgkXmTUg9U3YO7n9GPp1Nzw8v/MOx8BLjYRB+TX3EJIrduPuoc
+A06dGiBh+4E37F78CkWr1+cXVdCg6mCbpvbjjFspwgZgFJ0tl0ypkxWdYcQBX0jW
+WL1WMRJOEcgh4LMRkWXbtKaIOM5V
+-----END CERTIFICATE-----
+
+# Issuer: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Subject: O=Chunghwa Telecom Co., Ltd. OU=ePKI Root Certification Authority
+# Label: "ePKI Root Certification Authority"
+# Serial: 28956088682735189655030529057352760477
+# MD5 Fingerprint: 1b:2e:00:ca:26:06:90:3d:ad:fe:6f:15:68:d3:6b:b3
+# SHA1 Fingerprint: 67:65:0d:f1:7e:8e:7e:5b:82:40:a4:f4:56:4b:cf:e2:3d:69:c6:f0
+# SHA256 Fingerprint: c0:a6:f4:dc:63:a2:4b:fd:cf:54:ef:2a:6a:08:2a:0a:72:de:35:80:3e:2f:f5:ff:52:7a:e5:d8:72:06:df:d5
+-----BEGIN CERTIFICATE-----
+MIIFsDCCA5igAwIBAgIQFci9ZUdcr7iXAF7kBtK8nTANBgkqhkiG9w0BAQUFADBe
+MQswCQYDVQQGEwJUVzEjMCEGA1UECgwaQ2h1bmdod2EgVGVsZWNvbSBDby4sIEx0
+ZC4xKjAoBgNVBAsMIWVQS0kgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe
+Fw0wNDEyMjAwMjMxMjdaFw0zNDEyMjAwMjMxMjdaMF4xCzAJBgNVBAYTAlRXMSMw
+IQYDVQQKDBpDaHVuZ2h3YSBUZWxlY29tIENvLiwgTHRkLjEqMCgGA1UECwwhZVBL
+SSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA4SUP7o3biDN1Z82tH306Tm2d0y8U82N0ywEhajfqhFAH
+SyZbCUNsIZ5qyNUD9WBpj8zwIuQf5/dqIjG3LBXy4P4AakP/h2XGtRrBp0xtInAh
+ijHyl3SJCRImHJ7K2RKilTza6We/CKBk49ZCt0Xvl/T29de1ShUCWH2YWEtgvM3X
+DZoTM1PRYfl61dd4s5oz9wCGzh1NlDivqOx4UXCKXBCDUSH3ET00hl7lSM2XgYI1
+TBnsZfZrxQWh7kcT1rMhJ5QQCtkkO7q+RBNGMD+XPNjX12ruOzjjK9SXDrkb5wdJ
+fzcq+Xd4z1TtW0ado4AOkUPB1ltfFLqfpo0kR0BZv3I4sjZsN/+Z0V0OWQqraffA
+sgRFelQArr5T9rXn4fg8ozHSqf4hUmTFpmfwdQcGlBSBVcYn5AGPF8Fqcde+S/uU
+WH1+ETOxQvdibBjWzwloPn9s9h6PYq2lY9sJpx8iQkEeb5mKPtf5P0B6ebClAZLS
+nT0IFaUQAS2zMnaolQ2zepr7BxB4EW/hj8e6DyUadCrlHJhBmd8hh+iVBmoKs2pH
+dmX2Os+PYhcZewoozRrSgx4hxyy/vv9haLdnG7t4TY3OZ+XkwY63I2binZB1NJip
+NiuKmpS5nezMirH4JYlcWrYvjB9teSSnUmjDhDXiZo1jDiVN1Rmy5nk3pyKdVDEC
+AwEAAaNqMGgwHQYDVR0OBBYEFB4M97Zn8uGSJglFwFU5Lnc/QkqiMAwGA1UdEwQF
+MAMBAf8wOQYEZyoHAAQxMC8wLQIBADAJBgUrDgMCGgUAMAcGBWcqAwAABBRFsMLH
+ClZ87lt4DJX5GFPBphzYEDANBgkqhkiG9w0BAQUFAAOCAgEACbODU1kBPpVJufGB
+uvl2ICO1J2B01GqZNF5sAFPZn/KmsSQHRGoqxqWOeBLoR9lYGxMqXnmbnwoqZ6Yl
+PwZpVnPDimZI+ymBV3QGypzqKOg4ZyYr8dW1P2WT+DZdjo2NQCCHGervJ8A9tDkP
+JXtoUHRVnAxZfVo9QZQlUgjgRywVMRnVvwdVxrsStZf0X4OFunHB2WyBEXYKCrC/
+gpf36j36+uwtqSiUO1bd0lEursC9CBWMd1I0ltabrNMdjmEPNXubrjlpC2JgQCA2
+j6/7Nu4tCEoduL+bXPjqpRugc6bY+G7gMwRfaKonh+3ZwZCc7b3jajWvY9+rGNm6
+5ulK6lCKD2GTHuItGeIwlDWSXQ62B68ZgI9HkFFLLk3dheLSClIKF5r8GrBQAuUB
+o2M3IUxExJtRmREOc5wGj1QupyheRDmHVi03vYVElOEMSyycw5KFNGHLD7ibSkNS
+/jQ6fbjpKdx2qcgw+BRxgMYeNkh0IkFch4LoGHGLQYlE535YW6i4jRPpp2zDR+2z
+Gp1iro2C6pSe3VkQw63d4k3jMdXH7OjysP6SHhYKGvzZ8/gntsm+HbRsZJB/9OTE
+W9c3rkIO3aQab3yIVMUWbuF6aC74Or8NpDyJO3inTmODBCEIZ43ygknQW/2xzQ+D
+hNQ+IIX3Sj0rnP0qCglN6oH4EZw=
+-----END CERTIFICATE-----
+
+# Issuer: O=certSIGN OU=certSIGN ROOT CA
+# Subject: O=certSIGN OU=certSIGN ROOT CA
+# Label: "certSIGN ROOT CA"
+# Serial: 35210227249154
+# MD5 Fingerprint: 18:98:c0:d6:e9:3a:fc:f9:b0:f5:0c:f7:4b:01:44:17
+# SHA1 Fingerprint: fa:b7:ee:36:97:26:62:fb:2d:b0:2a:f6:bf:03:fd:e8:7c:4b:2f:9b
+# SHA256 Fingerprint: ea:a9:62:c4:fa:4a:6b:af:eb:e4:15:19:6d:35:1c:cd:88:8d:4f:53:f3:fa:8a:e6:d7:c4:66:a9:4e:60:42:bb
+-----BEGIN CERTIFICATE-----
+MIIDODCCAiCgAwIBAgIGIAYFFnACMA0GCSqGSIb3DQEBBQUAMDsxCzAJBgNVBAYT
+AlJPMREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBD
+QTAeFw0wNjA3MDQxNzIwMDRaFw0zMTA3MDQxNzIwMDRaMDsxCzAJBgNVBAYTAlJP
+MREwDwYDVQQKEwhjZXJ0U0lHTjEZMBcGA1UECxMQY2VydFNJR04gUk9PVCBDQTCC
+ASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALczuX7IJUqOtdu0KBuqV5Do
+0SLTZLrTk+jUrIZhQGpgV2hUhE28alQCBf/fm5oqrl0Hj0rDKH/v+yv6efHHrfAQ
+UySQi2bJqIirr1qjAOm+ukbuW3N7LBeCgV5iLKECZbO9xSsAfsT8AzNXDe3i+s5d
+RdY4zTW2ssHQnIFKquSyAVwdj1+ZxLGt24gh65AIgoDzMKND5pCCrlUoSe1b16kQ
+OA7+j0xbm0bqQfWwCHTD0IgztnzXdN/chNFDDnU5oSVAKOp4yw4sLjmdjItuFhwv
+JoIQ4uNllAoEwF73XVv4EOLQunpL+943AAAaWyjj0pxzPjKHmKHJUS/X3qwzs08C
+AwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAcYwHQYDVR0O
+BBYEFOCMm9slSbPxfIbWskKHC9BroNnkMA0GCSqGSIb3DQEBBQUAA4IBAQA+0hyJ
+LjX8+HXd5n9liPRyTMks1zJO890ZeUe9jjtbkw9QSSQTaxQGcu8J06Gh40CEyecY
+MnQ8SG4Pn0vU9x7Tk4ZkVJdjclDVVc/6IJMCopvDI5NOFlV2oHB5bc0hH88vLbwZ
+44gx+FkagQnIl6Z0x2DEW8xXjrJ1/RsCCdtZb3KTafcxQdaIOL+Hsr0Wefmq5L6I
+Jd1hJyMctTEHBDa0GpC9oHRxUIltvBTjD4au8as+x6AJzKNI0eDbZOeStc+vckNw
+i/nDhDwTqn6Sm1dTk/pwwpEOMfmbZ13pljheX7NzTogVZ96edhBiIL5VaZVDADlN
+9u6wWk5JRFRYX0KD
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Primary Certification Authority - G3 O=GeoTrust Inc. OU=(c) 2008 GeoTrust Inc. - For authorized use only
+# Subject: CN=GeoTrust Primary Certification Authority - G3 O=GeoTrust Inc. OU=(c) 2008 GeoTrust Inc. - For authorized use only
+# Label: "GeoTrust Primary Certification Authority - G3"
+# Serial: 28809105769928564313984085209975885599
+# MD5 Fingerprint: b5:e8:34:36:c9:10:44:58:48:70:6d:2e:83:d4:b8:05
+# SHA1 Fingerprint: 03:9e:ed:b8:0b:e7:a0:3c:69:53:89:3b:20:d2:d9:32:3a:4c:2a:fd
+# SHA256 Fingerprint: b4:78:b8:12:25:0d:f8:78:63:5c:2a:a7:ec:7d:15:5e:aa:62:5e:e8:29:16:e2:cd:29:43:61:88:6c:d1:fb:d4
+-----BEGIN CERTIFICATE-----
+MIID/jCCAuagAwIBAgIQFaxulBmyeUtB9iepwxgPHzANBgkqhkiG9w0BAQsFADCB
+mDELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xOTA3BgNVBAsT
+MChjKSAyMDA4IEdlb1RydXN0IEluYy4gLSBGb3IgYXV0aG9yaXplZCB1c2Ugb25s
+eTE2MDQGA1UEAxMtR2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhv
+cml0eSAtIEczMB4XDTA4MDQwMjAwMDAwMFoXDTM3MTIwMTIzNTk1OVowgZgxCzAJ
+BgNVBAYTAlVTMRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMTkwNwYDVQQLEzAoYykg
+MjAwOCBHZW9UcnVzdCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxNjA0
+BgNVBAMTLUdlb1RydXN0IFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkg
+LSBHMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANziXmJYHTNXOTIz
++uvLh4yn1ErdBojqZI4xmKU4kB6Yzy5jK/BGvESyiaHAKAxJcCGVn2TAppMSAmUm
+hsalifD614SgcK9PGpc/BkTVyetyEH3kMSj7HGHmKAdEc5IiaacDiGydY8hS2pgn
+5whMcD60yRLBxWeDXTPzAxHsatBT4tG6NmCUgLthY2xbF37fQJQeqw3CIShwiP/W
+JmxsYAQlTlV+fe+/lEjetx3dcI0FX4ilm/LC7urRQEFtYjgdVgbFA0dRIBn8exAL
+DmKudlW/X3e+PkkBUz2YJQN2JFodtNuJ6nnltrM7P7pMKEF/BqxqjsHQ9gUdfeZC
+huOl1UcCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYw
+HQYDVR0OBBYEFMR5yo6hTgMdHNxr2zFblD4/MH8tMA0GCSqGSIb3DQEBCwUAA4IB
+AQAtxRPPVoB7eni9n64smefv2t+UXglpp+duaIy9cr5HqQ6XErhK8WTTOd8lNNTB
+zU6B8A8ExCSzNJbGpqow32hhc9f5joWJ7w5elShKKiePEI4ufIbEAp7aDHdlDkQN
+kv39sxY2+hENHYwOB4lqKVb3cvTdFZx3NWZXqxNT2I7BQMXXExZacse3aQHEerGD
+AWh9jUGhlBjBJVz88P6DAod8DQ3PLghcSkANPuyBYeYk28rgDi0Hsj5W3I31QYUH
+SJsMC8tJP33st/3LjWeJGqvtux6jAAgIFyqCXDFdRootD4abdNlF+9RAsXqqaC2G
+spki4cErx5z481+oghLrGREt
+-----END CERTIFICATE-----
+
+# Issuer: CN=thawte Primary Root CA - G2 O=thawte, Inc. OU=(c) 2007 thawte, Inc. - For authorized use only
+# Subject: CN=thawte Primary Root CA - G2 O=thawte, Inc. OU=(c) 2007 thawte, Inc. - For authorized use only
+# Label: "thawte Primary Root CA - G2"
+# Serial: 71758320672825410020661621085256472406
+# MD5 Fingerprint: 74:9d:ea:60:24:c4:fd:22:53:3e:cc:3a:72:d9:29:4f
+# SHA1 Fingerprint: aa:db:bc:22:23:8f:c4:01:a1:27:bb:38:dd:f4:1d:db:08:9e:f0:12
+# SHA256 Fingerprint: a4:31:0d:50:af:18:a6:44:71:90:37:2a:86:af:af:8b:95:1f:fb:43:1d:83:7f:1e:56:88:b4:59:71:ed:15:57
+-----BEGIN CERTIFICATE-----
+MIICiDCCAg2gAwIBAgIQNfwmXNmET8k9Jj1Xm67XVjAKBggqhkjOPQQDAzCBhDEL
+MAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjE4MDYGA1UECxMvKGMp
+IDIwMDcgdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxJDAi
+BgNVBAMTG3RoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EgLSBHMjAeFw0wNzExMDUwMDAw
+MDBaFw0zODAxMTgyMzU5NTlaMIGEMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMdGhh
+d3RlLCBJbmMuMTgwNgYDVQQLEy8oYykgMjAwNyB0aGF3dGUsIEluYy4gLSBGb3Ig
+YXV0aG9yaXplZCB1c2Ugb25seTEkMCIGA1UEAxMbdGhhd3RlIFByaW1hcnkgUm9v
+dCBDQSAtIEcyMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEotWcgnuVnfFSeIf+iha/
+BebfowJPDQfGAFG6DAJSLSKkQjnE/o/qycG+1E3/n3qe4rF8mq2nhglzh9HnmuN6
+papu+7qzcMBniKI11KOasf2twu8x+qi58/sIxpHR+ymVo0IwQDAPBgNVHRMBAf8E
+BTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUmtgAMADna3+FGO6Lts6K
+DPgR4bswCgYIKoZIzj0EAwMDaQAwZgIxAN344FdHW6fmCsO99YCKlzUNG4k8VIZ3
+KMqh9HneteY4sPBlcIx/AlTCv//YoT7ZzwIxAMSNlPzcU9LcnXgWHxUzI1NS41ox
+XZ3Krr0TKUQNJ1uo52icEvdYPy5yAlejj6EULg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=thawte Primary Root CA - G3 O=thawte, Inc. OU=Certification Services Division/(c) 2008 thawte, Inc. - For authorized use only
+# Subject: CN=thawte Primary Root CA - G3 O=thawte, Inc. OU=Certification Services Division/(c) 2008 thawte, Inc. - For authorized use only
+# Label: "thawte Primary Root CA - G3"
+# Serial: 127614157056681299805556476275995414779
+# MD5 Fingerprint: fb:1b:5d:43:8a:94:cd:44:c6:76:f2:43:4b:47:e7:31
+# SHA1 Fingerprint: f1:8b:53:8d:1b:e9:03:b6:a6:f0:56:43:5b:17:15:89:ca:f3:6b:f2
+# SHA256 Fingerprint: 4b:03:f4:58:07:ad:70:f2:1b:fc:2c:ae:71:c9:fd:e4:60:4c:06:4c:f5:ff:b6:86:ba:e5:db:aa:d7:fd:d3:4c
+-----BEGIN CERTIFICATE-----
+MIIEKjCCAxKgAwIBAgIQYAGXt0an6rS0mtZLL/eQ+zANBgkqhkiG9w0BAQsFADCB
+rjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDHRoYXd0ZSwgSW5jLjEoMCYGA1UECxMf
+Q2VydGlmaWNhdGlvbiBTZXJ2aWNlcyBEaXZpc2lvbjE4MDYGA1UECxMvKGMpIDIw
+MDggdGhhd3RlLCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxJDAiBgNV
+BAMTG3RoYXd0ZSBQcmltYXJ5IFJvb3QgQ0EgLSBHMzAeFw0wODA0MDIwMDAwMDBa
+Fw0zNzEyMDEyMzU5NTlaMIGuMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMdGhhd3Rl
+LCBJbmMuMSgwJgYDVQQLEx9DZXJ0aWZpY2F0aW9uIFNlcnZpY2VzIERpdmlzaW9u
+MTgwNgYDVQQLEy8oYykgMjAwOCB0aGF3dGUsIEluYy4gLSBGb3IgYXV0aG9yaXpl
+ZCB1c2Ugb25seTEkMCIGA1UEAxMbdGhhd3RlIFByaW1hcnkgUm9vdCBDQSAtIEcz
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsr8nLPvb2FvdeHsbnndm
+gcs+vHyu86YnmjSjaDFxODNi5PNxZnmxqWWjpYvVj2AtP0LMqmsywCPLLEHd5N/8
+YZzic7IilRFDGF/Eth9XbAoFWCLINkw6fKXRz4aviKdEAhN0cXMKQlkC+BsUa0Lf
+b1+6a4KinVvnSr0eAXLbS3ToO39/fR8EtCab4LRarEc9VbjXsCZSKAExQGbY2SS9
+9irY7CFJXJv2eul/VTV+lmuNk5Mny5K76qxAwJ/C+IDPXfRa3M50hqY+bAtTyr2S
+zhkGcuYMXDhpxwTWvGzOW/b3aJzcJRVIiKHpqfiYnODz1TEoYRFsZ5aNOZnLwkUk
+OQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNV
+HQ4EFgQUrWyqlGCc7eT/+j4KdCtjA/e2Wb8wDQYJKoZIhvcNAQELBQADggEBABpA
+2JVlrAmSicY59BDlqQ5mU1143vokkbvnRFHfxhY0Cu9qRFHqKweKA3rD6z8KLFIW
+oCtDuSWQP3CpMyVtRRooOyfPqsMpQhvfO0zAMzRbQYi/aytlryjvsvXDqmbOe1bu
+t8jLZ8HJnBoYuMTDSQPxYA5QzUbF83d597YV4Djbxy8ooAw/dyZ02SUS2jHaGh7c
+KUGRIjxpp7sC8rZcJwOJ9Abqm+RyguOhCcHpABnTPtRwa7pxpqpYrvS76Wy274fM
+m7v/OeZWYdMKp8RcTGB7BXcmer/YB1IsYvdwY9k5vG8cwnncdimvzsUsZAReiDZu
+MdRAGmI0Nj81Aa6sY6A=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GeoTrust Primary Certification Authority - G2 O=GeoTrust Inc. OU=(c) 2007 GeoTrust Inc. - For authorized use only
+# Subject: CN=GeoTrust Primary Certification Authority - G2 O=GeoTrust Inc. OU=(c) 2007 GeoTrust Inc. - For authorized use only
+# Label: "GeoTrust Primary Certification Authority - G2"
+# Serial: 80682863203381065782177908751794619243
+# MD5 Fingerprint: 01:5e:d8:6b:bd:6f:3d:8e:a1:31:f8:12:e0:98:73:6a
+# SHA1 Fingerprint: 8d:17:84:d5:37:f3:03:7d:ec:70:fe:57:8b:51:9a:99:e6:10:d7:b0
+# SHA256 Fingerprint: 5e:db:7a:c4:3b:82:a0:6a:87:61:e8:d7:be:49:79:eb:f2:61:1f:7d:d7:9b:f9:1c:1c:6b:56:6a:21:9e:d7:66
+-----BEGIN CERTIFICATE-----
+MIICrjCCAjWgAwIBAgIQPLL0SAoA4v7rJDteYD7DazAKBggqhkjOPQQDAzCBmDEL
+MAkGA1UEBhMCVVMxFjAUBgNVBAoTDUdlb1RydXN0IEluYy4xOTA3BgNVBAsTMChj
+KSAyMDA3IEdlb1RydXN0IEluYy4gLSBGb3IgYXV0aG9yaXplZCB1c2Ugb25seTE2
+MDQGA1UEAxMtR2VvVHJ1c3QgUHJpbWFyeSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0
+eSAtIEcyMB4XDTA3MTEwNTAwMDAwMFoXDTM4MDExODIzNTk1OVowgZgxCzAJBgNV
+BAYTAlVTMRYwFAYDVQQKEw1HZW9UcnVzdCBJbmMuMTkwNwYDVQQLEzAoYykgMjAw
+NyBHZW9UcnVzdCBJbmMuIC0gRm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxNjA0BgNV
+BAMTLUdlb1RydXN0IFByaW1hcnkgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgLSBH
+MjB2MBAGByqGSM49AgEGBSuBBAAiA2IABBWx6P0DFUPlrOuHNxFi79KDNlJ9RVcL
+So17VDs6bl8VAsBQps8lL33KSLjHUGMcKiEIfJo22Av+0SbFWDEwKCXzXV2juLal
+tJLtbCyf691DiaI8S0iRHVDsJt/WYC69IaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO
+BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFBVfNVdRVfslsq0DafwBo/q+EVXVMAoG
+CCqGSM49BAMDA2cAMGQCMGSWWaboCd6LuvpaiIjwH5HTRqjySkwCY/tsXzjbLkGT
+qQ7mndwxHLKgpxgceeHHNgIwOlavmnRs9vuD4DPTCF+hnMJbn0bWtsuRBmOiBucz
+rD6ogRLQy7rQkgu2npaqBA+K
+-----END CERTIFICATE-----
+
+# Issuer: CN=VeriSign Universal Root Certification Authority O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2008 VeriSign, Inc. - For authorized use only
+# Subject: CN=VeriSign Universal Root Certification Authority O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2008 VeriSign, Inc. - For authorized use only
+# Label: "VeriSign Universal Root Certification Authority"
+# Serial: 85209574734084581917763752644031726877
+# MD5 Fingerprint: 8e:ad:b5:01:aa:4d:81:e4:8c:1d:d1:e1:14:00:95:19
+# SHA1 Fingerprint: 36:79:ca:35:66:87:72:30:4d:30:a5:fb:87:3b:0f:a7:7b:b7:0d:54
+# SHA256 Fingerprint: 23:99:56:11:27:a5:71:25:de:8c:ef:ea:61:0d:df:2f:a0:78:b5:c8:06:7f:4e:82:82:90:bf:b8:60:e8:4b:3c
+-----BEGIN CERTIFICATE-----
+MIIEuTCCA6GgAwIBAgIQQBrEZCGzEyEDDrvkEhrFHTANBgkqhkiG9w0BAQsFADCB
+vTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQL
+ExZWZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwOCBWZXJp
+U2lnbiwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MTgwNgYDVQQDEy9W
+ZXJpU2lnbiBVbml2ZXJzYWwgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTAe
+Fw0wODA0MDIwMDAwMDBaFw0zNzEyMDEyMzU5NTlaMIG9MQswCQYDVQQGEwJVUzEX
+MBUGA1UEChMOVmVyaVNpZ24sIEluYy4xHzAdBgNVBAsTFlZlcmlTaWduIFRydXN0
+IE5ldHdvcmsxOjA4BgNVBAsTMShjKSAyMDA4IFZlcmlTaWduLCBJbmMuIC0gRm9y
+IGF1dGhvcml6ZWQgdXNlIG9ubHkxODA2BgNVBAMTL1ZlcmlTaWduIFVuaXZlcnNh
+bCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5MIIBIjANBgkqhkiG9w0BAQEF
+AAOCAQ8AMIIBCgKCAQEAx2E3XrEBNNti1xWb/1hajCMj1mCOkdeQmIN65lgZOIzF
+9uVkhbSicfvtvbnazU0AtMgtc6XHaXGVHzk8skQHnOgO+k1KxCHfKWGPMiJhgsWH
+H26MfF8WIFFE0XBPV+rjHOPMee5Y2A7Cs0WTwCznmhcrewA3ekEzeOEz4vMQGn+H
+LL729fdC4uW/h2KJXwBL38Xd5HVEMkE6HnFuacsLdUYI0crSK5XQz/u5QGtkjFdN
+/BMReYTtXlT2NJ8IAfMQJQYXStrxHXpma5hgZqTZ79IugvHw7wnqRMkVauIDbjPT
+rJ9VAMf2CGqUuV/c4DPxhGD5WycRtPwW8rtWaoAljQIDAQABo4GyMIGvMA8GA1Ud
+EwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMG0GCCsGAQUFBwEMBGEwX6FdoFsw
+WTBXMFUWCWltYWdlL2dpZjAhMB8wBwYFKw4DAhoEFI/l0xqGrI2Oa8PPgGrUSBgs
+exkuMCUWI2h0dHA6Ly9sb2dvLnZlcmlzaWduLmNvbS92c2xvZ28uZ2lmMB0GA1Ud
+DgQWBBS2d/ppSEefUxLVwuoHMnYH0ZcHGTANBgkqhkiG9w0BAQsFAAOCAQEASvj4
+sAPmLGd75JR3Y8xuTPl9Dg3cyLk1uXBPY/ok+myDjEedO2Pzmvl2MpWRsXe8rJq+
+seQxIcaBlVZaDrHC1LGmWazxY8u4TB1ZkErvkBYoH1quEPuBUDgMbMzxPcP1Y+Oz
+4yHJJDnp/RVmRvQbEdBNc6N9Rvk97ahfYtTxP/jgdFcrGJ2BtMQo2pSXpXDrrB2+
+BxHw1dvd5Yzw1TKwg+ZX4o+/vqGqvz0dtdQ46tewXDpPaj+PwGZsY6rp2aQW9IHR
+lRQOfc2VNNnSj3BzgXucfr2YYdhFh5iQxeuGMMY1v/D/w1WIg0vvBZIGcfK4mJO3
+7M2CYfE45k+XmCpajQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=VeriSign Class 3 Public Primary Certification Authority - G4 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2007 VeriSign, Inc. - For authorized use only
+# Subject: CN=VeriSign Class 3 Public Primary Certification Authority - G4 O=VeriSign, Inc. OU=VeriSign Trust Network/(c) 2007 VeriSign, Inc. - For authorized use only
+# Label: "VeriSign Class 3 Public Primary Certification Authority - G4"
+# Serial: 63143484348153506665311985501458640051
+# MD5 Fingerprint: 3a:52:e1:e7:fd:6f:3a:e3:6f:f3:6f:99:1b:f9:22:41
+# SHA1 Fingerprint: 22:d5:d8:df:8f:02:31:d1:8d:f7:9d:b7:cf:8a:2d:64:c9:3f:6c:3a
+# SHA256 Fingerprint: 69:dd:d7:ea:90:bb:57:c9:3e:13:5d:c8:5e:a6:fc:d5:48:0b:60:32:39:bd:c4:54:fc:75:8b:2a:26:cf:7f:79
+-----BEGIN CERTIFICATE-----
+MIIDhDCCAwqgAwIBAgIQL4D+I4wOIg9IZxIokYesszAKBggqhkjOPQQDAzCByjEL
+MAkGA1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZW
+ZXJpU2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNyBWZXJpU2ln
+biwgSW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJp
+U2lnbiBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9y
+aXR5IC0gRzQwHhcNMDcxMTA1MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCByjELMAkG
+A1UEBhMCVVMxFzAVBgNVBAoTDlZlcmlTaWduLCBJbmMuMR8wHQYDVQQLExZWZXJp
+U2lnbiBUcnVzdCBOZXR3b3JrMTowOAYDVQQLEzEoYykgMjAwNyBWZXJpU2lnbiwg
+SW5jLiAtIEZvciBhdXRob3JpemVkIHVzZSBvbmx5MUUwQwYDVQQDEzxWZXJpU2ln
+biBDbGFzcyAzIFB1YmxpYyBQcmltYXJ5IENlcnRpZmljYXRpb24gQXV0aG9yaXR5
+IC0gRzQwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAASnVnp8Utpkmw4tXNherJI9/gHm
+GUo9FANL+mAnINmDiWn6VMaaGF5VKmTeBvaNSjutEDxlPZCIBIngMGGzrl0Bp3ve
+fLK+ymVhAIau2o970ImtTR1ZmkGxvEeA3J5iw/mjgbIwga8wDwYDVR0TAQH/BAUw
+AwEB/zAOBgNVHQ8BAf8EBAMCAQYwbQYIKwYBBQUHAQwEYTBfoV2gWzBZMFcwVRYJ
+aW1hZ2UvZ2lmMCEwHzAHBgUrDgMCGgQUj+XTGoasjY5rw8+AatRIGCx7GS4wJRYj
+aHR0cDovL2xvZ28udmVyaXNpZ24uY29tL3ZzbG9nby5naWYwHQYDVR0OBBYEFLMW
+kf3upm7ktS5Jj4d4gYDs5bG1MAoGCCqGSM49BAMDA2gAMGUCMGYhDBgmYFo4e1ZC
+4Kf8NoRRkSAsdk1DPcQdhCPQrNZ8NQbOzWm9kA3bbEhCHQ6qQgIxAJw9SDkjOVga
+FRJZap7v1VmyHVIsmXHNxynfGyphe3HR3vPA5Q06Sqotp9iGKt0uEA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Subject: CN=NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny O=NetLock Kft. OU=Tan\xfas\xedtv\xe1nykiad\xf3k (Certification Services)
+# Label: "NetLock Arany (Class Gold) F\u0151tan\xfas\xedtv\xe1ny"
+# Serial: 80544274841616
+# MD5 Fingerprint: c5:a1:b7:ff:73:dd:d6:d7:34:32:18:df:fc:3c:ad:88
+# SHA1 Fingerprint: 06:08:3f:59:3f:15:a1:04:a0:69:a4:6b:a9:03:d0:06:b7:97:09:91
+# SHA256 Fingerprint: 6c:61:da:c3:a2:de:f0:31:50:6b:e0:36:d2:a6:fe:40:19:94:fb:d1:3d:f9:c8:d4:66:59:92:74:c4:46:ec:98
+-----BEGIN CERTIFICATE-----
+MIIEFTCCAv2gAwIBAgIGSUEs5AAQMA0GCSqGSIb3DQEBCwUAMIGnMQswCQYDVQQG
+EwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFTATBgNVBAoMDE5ldExvY2sgS2Z0LjE3
+MDUGA1UECwwuVGFuw7pzw610dsOhbnlraWFkw7NrIChDZXJ0aWZpY2F0aW9uIFNl
+cnZpY2VzKTE1MDMGA1UEAwwsTmV0TG9jayBBcmFueSAoQ2xhc3MgR29sZCkgRsWR
+dGFuw7pzw610dsOhbnkwHhcNMDgxMjExMTUwODIxWhcNMjgxMjA2MTUwODIxWjCB
+pzELMAkGA1UEBhMCSFUxETAPBgNVBAcMCEJ1ZGFwZXN0MRUwEwYDVQQKDAxOZXRM
+b2NrIEtmdC4xNzA1BgNVBAsMLlRhbsO6c8OtdHbDoW55a2lhZMOzayAoQ2VydGlm
+aWNhdGlvbiBTZXJ2aWNlcykxNTAzBgNVBAMMLE5ldExvY2sgQXJhbnkgKENsYXNz
+IEdvbGQpIEbFkXRhbsO6c8OtdHbDoW55MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
+MIIBCgKCAQEAxCRec75LbRTDofTjl5Bu0jBFHjzuZ9lk4BqKf8owyoPjIMHj9DrT
+lF8afFttvzBPhCf2nx9JvMaZCpDyD/V/Q4Q3Y1GLeqVw/HpYzY6b7cNGbIRwXdrz
+AZAj/E4wqX7hJ2Pn7WQ8oLjJM2P+FpD/sLj916jAwJRDC7bVWaaeVtAkH3B5r9s5
+VA1lddkVQZQBr17s9o3x/61k/iCa11zr/qYfCGSji3ZVrR47KGAuhyXoqq8fxmRG
+ILdwfzzeSNuWU7c5d+Qa4scWhHaXWy+7GRWF+GmF9ZmnqfI0p6m2pgP8b4Y9VHx2
+BJtr+UBdADTHLpl1neWIA6pN+APSQnbAGwIDAKiLo0UwQzASBgNVHRMBAf8ECDAG
+AQH/AgEEMA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUzPpnk/C2uNClwB7zU/2M
+U9+D15YwDQYJKoZIhvcNAQELBQADggEBAKt/7hwWqZw8UQCgwBEIBaeZ5m8BiFRh
+bvG5GK1Krf6BQCOUL/t1fC8oS2IkgYIL9WHxHG64YTjrgfpioTtaYtOUZcTh5m2C
++C8lcLIhJsFyUR+MLMOEkMNaj7rP9KdlpeuY0fsFskZ1FSNqb4VjMIDw1Z4fKRzC
+bLBQWV2QWzuoDTDPv31/zvGdg73JRm4gpvlhUbohL3u+pRVjodSVh/GeufOJ8z2F
+uLjbvrW5KfnaNwUASZQDhETnv0Mxz3WLJdH0pmT1kvarBes96aULNmLazAZfNou2
+XjG4Kvte9nHfRCaexOYNkbQudZWAUWpLMKawYqGT8ZvYzsRjdT9ZR7E=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Staat der Nederlanden Root CA - G2 O=Staat der Nederlanden
+# Subject: CN=Staat der Nederlanden Root CA - G2 O=Staat der Nederlanden
+# Label: "Staat der Nederlanden Root CA - G2"
+# Serial: 10000012
+# MD5 Fingerprint: 7c:a5:0f:f8:5b:9a:7d:6d:30:ae:54:5a:e3:42:a2:8a
+# SHA1 Fingerprint: 59:af:82:79:91:86:c7:b4:75:07:cb:cf:03:57:46:eb:04:dd:b7:16
+# SHA256 Fingerprint: 66:8c:83:94:7d:a6:3b:72:4b:ec:e1:74:3c:31:a0:e6:ae:d0:db:8e:c5:b3:1b:e3:77:bb:78:4f:91:b6:71:6f
+-----BEGIN CERTIFICATE-----
+MIIFyjCCA7KgAwIBAgIEAJiWjDANBgkqhkiG9w0BAQsFADBaMQswCQYDVQQGEwJO
+TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSswKQYDVQQDDCJTdGFh
+dCBkZXIgTmVkZXJsYW5kZW4gUm9vdCBDQSAtIEcyMB4XDTA4MDMyNjExMTgxN1oX
+DTIwMDMyNTExMDMxMFowWjELMAkGA1UEBhMCTkwxHjAcBgNVBAoMFVN0YWF0IGRl
+ciBOZWRlcmxhbmRlbjErMCkGA1UEAwwiU3RhYXQgZGVyIE5lZGVybGFuZGVuIFJv
+b3QgQ0EgLSBHMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMVZ5291
+qj5LnLW4rJ4L5PnZyqtdj7U5EILXr1HgO+EASGrP2uEGQxGZqhQlEq0i6ABtQ8Sp
+uOUfiUtnvWFI7/3S4GCI5bkYYCjDdyutsDeqN95kWSpGV+RLufg3fNU254DBtvPU
+Z5uW6M7XxgpT0GtJlvOjCwV3SPcl5XCsMBQgJeN/dVrlSPhOewMHBPqCYYdu8DvE
+pMfQ9XQ+pV0aCPKbJdL2rAQmPlU6Yiile7Iwr/g3wtG61jj99O9JMDeZJiFIhQGp
+5Rbn3JBV3w/oOM2ZNyFPXfUib2rFEhZgF1XyZWampzCROME4HYYEhLoaJXhena/M
+UGDWE4dS7WMfbWV9whUYdMrhfmQpjHLYFhN9C0lK8SgbIHRrxT3dsKpICT0ugpTN
+GmXZK4iambwYfp/ufWZ8Pr2UuIHOzZgweMFvZ9C+X+Bo7d7iscksWXiSqt8rYGPy
+5V6548r6f1CGPqI0GAwJaCgRHOThuVw+R7oyPxjMW4T182t0xHJ04eOLoEq9jWYv
+6q012iDTiIJh8BIitrzQ1aTsr1SIJSQ8p22xcik/Plemf1WvbibG/ufMQFxRRIEK
+eN5KzlW/HdXZt1bv8Hb/C3m1r737qWmRRpdogBQ2HbN/uymYNqUg+oJgYjOk7Na6
+B6duxc8UpufWkjTYgfX8HV2qXB72o007uPc5AgMBAAGjgZcwgZQwDwYDVR0TAQH/
+BAUwAwEB/zBSBgNVHSAESzBJMEcGBFUdIAAwPzA9BggrBgEFBQcCARYxaHR0cDov
+L3d3dy5wa2lvdmVyaGVpZC5ubC9wb2xpY2llcy9yb290LXBvbGljeS1HMjAOBgNV
+HQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJFoMocVHYnitfGsNig0jQt8YojrMA0GCSqG
+SIb3DQEBCwUAA4ICAQCoQUpnKpKBglBu4dfYszk78wIVCVBR7y29JHuIhjv5tLyS
+CZa59sCrI2AGeYwRTlHSeYAz+51IvuxBQ4EffkdAHOV6CMqqi3WtFMTC6GY8ggen
+5ieCWxjmD27ZUD6KQhgpxrRW/FYQoAUXvQwjf/ST7ZwaUb7dRUG/kSS0H4zpX897
+IZmflZ85OkYcbPnNe5yQzSipx6lVu6xiNGI1E0sUOlWDuYaNkqbG9AclVMwWVxJK
+gnjIFNkXgiYtXSAfea7+1HAWFpWD2DU5/1JddRwWxRNVz0fMdWVSSt7wsKfkCpYL
++63C4iWEst3kvX5ZbJvw8NjnyvLplzh+ib7M+zkXYT9y2zqR2GUBGR2tUKRXCnxL
+vJxxcypFURmFzI79R6d0lR2o0a9OF7FpJsKqeFdbxU2n5Z4FF5TKsl+gSRiNNOkm
+bEgeqmiSBeGCc1qb3AdbCG19ndeNIdn8FCCqwkXfP+cAslHkwvgFuXkajDTznlvk
+N1trSt8sV4pAWja63XVECDdCcAz+3F4hoKOKwJCcaNpQ5kUQR3i2TtJlycM33+FC
+Y7BXN0Ute4qcvwXqZVUz9zkQxSgqIXobisQk+T8VyJoVIPVVYpbtbZNQvOSqeK3Z
+ywplh6ZmwcSBo3c6WB4L7oOLnR7SUqTMHW+wmG2UMbX4cQrcufx9MmDm66+KAQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hongkong Post Root CA 1 O=Hongkong Post
+# Subject: CN=Hongkong Post Root CA 1 O=Hongkong Post
+# Label: "Hongkong Post Root CA 1"
+# Serial: 1000
+# MD5 Fingerprint: a8:0d:6f:39:78:b9:43:6d:77:42:6d:98:5a:cc:23:ca
+# SHA1 Fingerprint: d6:da:a8:20:8d:09:d2:15:4d:24:b5:2f:cb:34:6e:b2:58:b2:8a:58
+# SHA256 Fingerprint: f9:e6:7d:33:6c:51:00:2a:c0:54:c6:32:02:2d:66:dd:a2:e7:e3:ff:f1:0a:d0:61:ed:31:d8:bb:b4:10:cf:b2
+-----BEGIN CERTIFICATE-----
+MIIDMDCCAhigAwIBAgICA+gwDQYJKoZIhvcNAQEFBQAwRzELMAkGA1UEBhMCSEsx
+FjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdrb25nIFBvc3Qg
+Um9vdCBDQSAxMB4XDTAzMDUxNTA1MTMxNFoXDTIzMDUxNTA0NTIyOVowRzELMAkG
+A1UEBhMCSEsxFjAUBgNVBAoTDUhvbmdrb25nIFBvc3QxIDAeBgNVBAMTF0hvbmdr
+b25nIFBvc3QgUm9vdCBDQSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEArP84tulmAknjorThkPlAj3n54r15/gK97iSSHSL22oVyaf7XPwnU3ZG1ApzQ
+jVrhVcNQhrkpJsLj2aDxaQMoIIBFIi1WpztUlVYiWR8o3x8gPW2iNr4joLFutbEn
+PzlTCeqrauh0ssJlXI6/fMN4hM2eFvz1Lk8gKgifd/PFHsSaUmYeSF7jEAaPIpjh
+ZY4bXSNmO7ilMlHIhqqhqZ5/dpTCpmy3QfDVyAY45tQM4vM7TG1QjMSDJ8EThFk9
+nnV0ttgCXjqQesBCNnLsak3c78QA3xMYV18meMjWCnl3v/evt3a5pQuEF10Q6m/h
+q5URX208o1xNg1vysxmKgIsLhwIDAQABoyYwJDASBgNVHRMBAf8ECDAGAQH/AgED
+MA4GA1UdDwEB/wQEAwIBxjANBgkqhkiG9w0BAQUFAAOCAQEADkbVPK7ih9legYsC
+mEEIjEy82tvuJxuC52pF7BaLT4Wg87JwvVqWuspube5Gi27nKi6Wsxkz67SfqLI3
+7piol7Yutmcn1KZJ/RyTZXaeQi/cImyaT/JaFTmxcdcrUehtHJjA2Sr0oYJ71clB
+oiMBdDhViw+5LmeiIAQ32pwL0xch4I+XeTRvhEgCIDMb5jREn5Fw9IBehEPCKdJs
+EhTkYY2sEJCehFC78JZvRZ+K88psT/oROhUVRsPNH4NbLUES7VBnQRM9IauUiqpO
+fMGx+6fWtScvl6tu4B3i0RwsH0Ti/L6RoZz71ilTc4afU9hDDl3WY4JxHYB0yvbi
+AmvZWg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Subject: CN=SecureSign RootCA11 O=Japan Certification Services, Inc.
+# Label: "SecureSign RootCA11"
+# Serial: 1
+# MD5 Fingerprint: b7:52:74:e2:92:b4:80:93:f2:75:e4:cc:d7:f2:ea:26
+# SHA1 Fingerprint: 3b:c4:9f:48:f8:f3:73:a0:9c:1e:bd:f8:5b:b1:c3:65:c7:d8:11:b3
+# SHA256 Fingerprint: bf:0f:ee:fb:9e:3a:58:1a:d5:f9:e9:db:75:89:98:57:43:d2:61:08:5c:4d:31:4f:6f:5d:72:59:aa:42:16:12
+-----BEGIN CERTIFICATE-----
+MIIDbTCCAlWgAwIBAgIBATANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJKUDEr
+MCkGA1UEChMiSmFwYW4gQ2VydGlmaWNhdGlvbiBTZXJ2aWNlcywgSW5jLjEcMBoG
+A1UEAxMTU2VjdXJlU2lnbiBSb290Q0ExMTAeFw0wOTA0MDgwNDU2NDdaFw0yOTA0
+MDgwNDU2NDdaMFgxCzAJBgNVBAYTAkpQMSswKQYDVQQKEyJKYXBhbiBDZXJ0aWZp
+Y2F0aW9uIFNlcnZpY2VzLCBJbmMuMRwwGgYDVQQDExNTZWN1cmVTaWduIFJvb3RD
+QTExMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA/XeqpRyQBTvLTJsz
+i1oURaTnkBbR31fSIRCkF/3frNYfp+TbfPfs37gD2pRY/V1yfIw/XwFndBWW4wI8
+h9uuywGOwvNmxoVF9ALGOrVisq/6nL+k5tSAMJjzDbaTj6nU2DbysPyKyiyhFTOV
+MdrAG/LuYpmGYz+/3ZMqg6h2uRMft85OQoWPIucuGvKVCbIFtUROd6EgvanyTgp9
+UK31BQ1FT0Zx/Sg+U/sE2C3XZR1KG/rPO7AxmjVuyIsG0wCR8pQIZUyxNAYAeoni
+8McDWc/V1uinMrPmmECGxc0nEovMe863ETxiYAcjPitAbpSACW22s293bzUIUPsC
+h8U+iQIDAQABo0IwQDAdBgNVHQ4EFgQUW/hNT7KlhtQ60vFjmqC+CfZXt94wDgYD
+VR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEFBQADggEB
+AKChOBZmLqdWHyGcBvod7bkixTgm2E5P7KN/ed5GIaGHd48HCJqypMWvDzKYC3xm
+KbabfSVSSUOrTC4rbnpwrxYO4wJs+0LmGJ1F2FXI6Dvd5+H0LgscNFxsWEr7jIhQ
+X5Ucv+2rIrVls4W6ng+4reV6G4pQOh29Dbx7VFALuUKvVaAYga1lme++5Jy/xIWr
+QbJUb9wlze144o4MjQlJ3WN7WmmWAiGovVJZ6X01y8hSyn+B/tlr0/cR7SXf+Of5
+pPpyl4RTDaXQMhhRdlkUbA/r7F+AjHVDg8OFmP9Mni0N5HeDk061lgeLKBObjBmN
+QSdJQO7e5iNEOdyhIta6A/I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Subject: CN=Microsec e-Szigno Root CA 2009 O=Microsec Ltd.
+# Label: "Microsec e-Szigno Root CA 2009"
+# Serial: 14014712776195784473
+# MD5 Fingerprint: f8:49:f4:03:bc:44:2d:83:be:48:69:7d:29:64:fc:b1
+# SHA1 Fingerprint: 89:df:74:fe:5c:f4:0f:4a:80:f9:e3:37:7d:54:da:91:e1:01:31:8e
+# SHA256 Fingerprint: 3c:5f:81:fe:a5:fa:b8:2c:64:bf:a2:ea:ec:af:cd:e8:e0:77:fc:86:20:a7:ca:e5:37:16:3d:f3:6e:db:f3:78
+-----BEGIN CERTIFICATE-----
+MIIECjCCAvKgAwIBAgIJAMJ+QwRORz8ZMA0GCSqGSIb3DQEBCwUAMIGCMQswCQYD
+VQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3QxFjAUBgNVBAoMDU1pY3Jvc2VjIEx0
+ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3ppZ25vIFJvb3QgQ0EgMjAwOTEfMB0G
+CSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5odTAeFw0wOTA2MTYxMTMwMThaFw0y
+OTEyMzAxMTMwMThaMIGCMQswCQYDVQQGEwJIVTERMA8GA1UEBwwIQnVkYXBlc3Qx
+FjAUBgNVBAoMDU1pY3Jvc2VjIEx0ZC4xJzAlBgNVBAMMHk1pY3Jvc2VjIGUtU3pp
+Z25vIFJvb3QgQ0EgMjAwOTEfMB0GCSqGSIb3DQEJARYQaW5mb0BlLXN6aWduby5o
+dTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOn4j/NjrdqG2KfgQvvP
+kd6mJviZpWNwrZuuyjNAfW2WbqEORO7hE52UQlKavXWFdCyoDh2Tthi3jCyoz/tc
+cbna7P7ofo/kLx2yqHWH2Leh5TvPmUpG0IMZfcChEhyVbUr02MelTTMuhTlAdX4U
+fIASmFDHQWe4oIBhVKZsTh/gnQ4H6cm6M+f+wFUoLAKApxn1ntxVUwOXewdI/5n7
+N4okxFnMUBBjjqqpGrCEGob5X7uxUG6k0QrM1XF+H6cbfPVTbiJfyyvm1HxdrtbC
+xkzlBQHZ7Vf8wSN5/PrIJIOV87VqUQHQd9bpEqH5GoP7ghu5sJf0dgYzQ0mg/wu1
++rUCAwEAAaOBgDB+MA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0G
+A1UdDgQWBBTLD8bfQkPMPcu1SCOhGnqmKrs0aDAfBgNVHSMEGDAWgBTLD8bfQkPM
+Pcu1SCOhGnqmKrs0aDAbBgNVHREEFDASgRBpbmZvQGUtc3ppZ25vLmh1MA0GCSqG
+SIb3DQEBCwUAA4IBAQDJ0Q5eLtXMs3w+y/w9/w0olZMEyL/azXm4Q5DwpL7v8u8h
+mLzU1F0G9u5C7DBsoKqpyvGvivo/C3NqPuouQH4frlRheesuCDfXI/OMn74dseGk
+ddug4lQUsbocKaQY9hK6ohQU4zE1yED/t+AFdlfBHFny+L/k7SViXITwfn4fs775
+tyERzAMBVnCnEJIeGzSBHq2cGsMEPO0CYdYeBvNfOofyK/FFh+U9rNHHV4S9a67c
+2Pm2G2JwCz02yULyMtd6YebS2z3PyKnJm9zbWETXbzivf3jTo60adbocwTZ8jx5t
+HMN1Rq41Bab2XD0h7lbwyYIiLXpUq3DDfSJlgnCW
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R3
+# Label: "GlobalSign Root CA - R3"
+# Serial: 4835703278459759426209954
+# MD5 Fingerprint: c5:df:b8:49:ca:05:13:55:ee:2d:ba:1a:c3:3e:b0:28
+# SHA1 Fingerprint: d6:9b:56:11:48:f0:1c:77:c5:45:78:c1:09:26:df:5b:85:69:76:ad
+# SHA256 Fingerprint: cb:b5:22:d7:b7:f1:27:ad:6a:01:13:86:5b:df:1c:d4:10:2e:7d:07:59:af:63:5a:7c:f4:72:0d:c9:63:c5:3b
+-----BEGIN CERTIFICATE-----
+MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
+MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
+RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
+gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
+KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
+QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
+XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
+LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
+RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
+jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
+6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
+mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
+Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
+WD9f
+-----END CERTIFICATE-----
+
+# Issuer: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Subject: CN=Autoridad de Certificacion Firmaprofesional CIF A62634068
+# Label: "Autoridad de Certificacion Firmaprofesional CIF A62634068"
+# Serial: 6047274297262753887
+# MD5 Fingerprint: 73:3a:74:7a:ec:bb:a3:96:a6:c2:e4:e2:c8:9b:c0:c3
+# SHA1 Fingerprint: ae:c5:fb:3f:c8:e1:bf:c4:e5:4f:03:07:5a:9a:e8:00:b7:f7:b6:fa
+# SHA256 Fingerprint: 04:04:80:28:bf:1f:28:64:d4:8f:9a:d4:d8:32:94:36:6a:82:88:56:55:3f:3b:14:30:3f:90:14:7f:5d:40:ef
+-----BEGIN CERTIFICATE-----
+MIIGFDCCA/ygAwIBAgIIU+w77vuySF8wDQYJKoZIhvcNAQEFBQAwUTELMAkGA1UE
+BhMCRVMxQjBABgNVBAMMOUF1dG9yaWRhZCBkZSBDZXJ0aWZpY2FjaW9uIEZpcm1h
+cHJvZmVzaW9uYWwgQ0lGIEE2MjYzNDA2ODAeFw0wOTA1MjAwODM4MTVaFw0zMDEy
+MzEwODM4MTVaMFExCzAJBgNVBAYTAkVTMUIwQAYDVQQDDDlBdXRvcmlkYWQgZGUg
+Q2VydGlmaWNhY2lvbiBGaXJtYXByb2Zlc2lvbmFsIENJRiBBNjI2MzQwNjgwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDKlmuO6vj78aI14H9M2uDDUtd9
+thDIAl6zQyrET2qyyhxdKJp4ERppWVevtSBC5IsP5t9bpgOSL/UR5GLXMnE42QQM
+cas9UX4PB99jBVzpv5RvwSmCwLTaUbDBPLutN0pcyvFLNg4kq7/DhHf9qFD0sefG
+L9ItWY16Ck6WaVICqjaY7Pz6FIMMNx/Jkjd/14Et5cS54D40/mf0PmbR0/RAz15i
+NA9wBj4gGFrO93IbJWyTdBSTo3OxDqqHECNZXyAFGUftaI6SEspd/NYrspI8IM/h
+X68gvqB2f3bl7BqGYTM+53u0P6APjqK5am+5hyZvQWyIplD9amML9ZMWGxmPsu2b
+m8mQ9QEM3xk9Dz44I8kvjwzRAv4bVdZO0I08r0+k8/6vKtMFnXkIoctXMbScyJCy
+Z/QYFpM6/EfY0XiWMR+6KwxfXZmtY4laJCB22N/9q06mIqqdXuYnin1oKaPnirja
+EbsXLZmdEyRG98Xi2J+Of8ePdG1asuhy9azuJBCtLxTa/y2aRnFHvkLfuwHb9H/T
+KI8xWVvTyQKmtFLKbpf7Q8UIJm+K9Lv9nyiqDdVF8xM6HdjAeI9BZzwelGSuewvF
+6NkBiDkal4ZkQdU7hwxu+g/GvUgUvzlN1J5Bto+WHWOWk9mVBngxaJ43BjuAiUVh
+OSPHG0SjFeUc+JIwuwIDAQABo4HvMIHsMBIGA1UdEwEB/wQIMAYBAf8CAQEwDgYD
+VR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRlzeurNR4APn7VdMActHNHDhpkLzCBpgYD
+VR0gBIGeMIGbMIGYBgRVHSAAMIGPMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmZp
+cm1hcHJvZmVzaW9uYWwuY29tL2NwczBcBggrBgEFBQcCAjBQHk4AUABhAHMAZQBv
+ACAAZABlACAAbABhACAAQgBvAG4AYQBuAG8AdgBhACAANAA3ACAAQgBhAHIAYwBl
+AGwAbwBuAGEAIAAwADgAMAAxADcwDQYJKoZIhvcNAQEFBQADggIBABd9oPm03cXF
+661LJLWhAqvdpYhKsg9VSytXjDvlMd3+xDLx51tkljYyGOylMnfX40S2wBEqgLk9
+am58m9Ot/MPWo+ZkKXzR4Tgegiv/J2Wv+xYVxC5xhOW1//qkR71kMrv2JYSiJ0L1
+ILDCExARzRAVukKQKtJE4ZYm6zFIEv0q2skGz3QeqUvVhyj5eTSSPi5E6PaPT481
+PyWzOdxjKpBrIF/EUhJOlywqrJ2X3kjyo2bbwtKDlaZmp54lD+kLM5FlClrD2VQS
+3a/DTg4fJl4N3LON7NWBcN7STyQF82xO9UxJZo3R/9ILJUFI/lGExkKvgATP0H5k
+SeTy36LssUzAKh3ntLFlosS88Zj0qnAHY7S42jtM+kAiMFsRpvAFDsYCA0irhpuF
+3dvd6qJ2gHN99ZwExEWN57kci57q13XRcrHedUTnQn3iV2t93Jm8PYMo6oCTjcVM
+ZcFwgbg4/EMxsvYDNEeyrPsiBsse3RdHHF9mudMaotoRsaS8I8nkvof/uZS2+F0g
+StRf571oe2XyFR7SOqkt6dhrJKyXWERHrVkY8SFlcN7ONGCoQPHzPKTDKCOM/icz
+Q0CgFzzr6juwcqajuUpLXhZI9LK8yIySxZ2frHI2vDSANGupi5LAuBft7HZT9SQB
+jLMi6Et8Vcad+qMUu2WFbm5PEn4KPJ2V
+-----END CERTIFICATE-----
+
+# Issuer: CN=Izenpe.com O=IZENPE S.A.
+# Subject: CN=Izenpe.com O=IZENPE S.A.
+# Label: "Izenpe.com"
+# Serial: 917563065490389241595536686991402621
+# MD5 Fingerprint: a6:b0:cd:85:80:da:5c:50:34:a3:39:90:2f:55:67:73
+# SHA1 Fingerprint: 2f:78:3d:25:52:18:a7:4a:65:39:71:b5:2c:a2:9c:45:15:6f:e9:19
+# SHA256 Fingerprint: 25:30:cc:8e:98:32:15:02:ba:d9:6f:9b:1f:ba:1b:09:9e:2d:29:9e:0f:45:48:bb:91:4f:36:3b:c0:d4:53:1f
+-----BEGIN CERTIFICATE-----
+MIIF8TCCA9mgAwIBAgIQALC3WhZIX7/hy/WL1xnmfTANBgkqhkiG9w0BAQsFADA4
+MQswCQYDVQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6
+ZW5wZS5jb20wHhcNMDcxMjEzMTMwODI4WhcNMzcxMjEzMDgyNzI1WjA4MQswCQYD
+VQQGEwJFUzEUMBIGA1UECgwLSVpFTlBFIFMuQS4xEzARBgNVBAMMCkl6ZW5wZS5j
+b20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDJ03rKDx6sp4boFmVq
+scIbRTJxldn+EFvMr+eleQGPicPK8lVx93e+d5TzcqQsRNiekpsUOqHnJJAKClaO
+xdgmlOHZSOEtPtoKct2jmRXagaKH9HtuJneJWK3W6wyyQXpzbm3benhB6QiIEn6H
+LmYRY2xU+zydcsC8Lv/Ct90NduM61/e0aL6i9eOBbsFGb12N4E3GVFWJGjMxCrFX
+uaOKmMPsOzTFlUFpfnXCPCDFYbpRR6AgkJOhkEvzTnyFRVSa0QUmQbC1TR0zvsQD
+yCV8wXDbO/QJLVQnSKwv4cSsPsjLkkxTOTcj7NMB+eAJRE1NZMDhDVqHIrytG6P+
+JrUV86f8hBnp7KGItERphIPzidF0BqnMC9bC3ieFUCbKF7jJeodWLBoBHmy+E60Q
+rLUk9TiRodZL2vG70t5HtfG8gfZZa88ZU+mNFctKy6lvROUbQc/hhqfK0GqfvEyN
+BjNaooXlkDWgYlwWTvDjovoDGrQscbNYLN57C9saD+veIR8GdwYDsMnvmfzAuU8L
+hij+0rnq49qlw0dpEuDb8PYZi+17cNcC1u2HGCgsBCRMd+RIihrGO5rUD8r6ddIB
+QFqNeb+Lz0vPqhbBleStTIo+F5HUsWLlguWABKQDfo2/2n+iD5dPDNMN+9fR5XJ+
+HMh3/1uaD7euBUbl8agW7EekFwIDAQABo4H2MIHzMIGwBgNVHREEgagwgaWBD2lu
+Zm9AaXplbnBlLmNvbaSBkTCBjjFHMEUGA1UECgw+SVpFTlBFIFMuQS4gLSBDSUYg
+QTAxMzM3MjYwLVJNZXJjLlZpdG9yaWEtR2FzdGVpeiBUMTA1NSBGNjIgUzgxQzBB
+BgNVBAkMOkF2ZGEgZGVsIE1lZGl0ZXJyYW5lbyBFdG9yYmlkZWEgMTQgLSAwMTAx
+MCBWaXRvcmlhLUdhc3RlaXowDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AQYwHQYDVR0OBBYEFB0cZQ6o8iV7tJHP5LGx5r1VdGwFMA0GCSqGSIb3DQEBCwUA
+A4ICAQB4pgwWSp9MiDrAyw6lFn2fuUhfGI8NYjb2zRlrrKvV9pF9rnHzP7MOeIWb
+laQnIUdCSnxIOvVFfLMMjlF4rJUT3sb9fbgakEyrkgPH7UIBzg/YsfqikuFgba56
+awmqxinuaElnMIAkejEWOVt+8Rwu3WwJrfIxwYJOubv5vr8qhT/AQKM6WfxZSzwo
+JNu0FXWuDYi6LnPAvViH5ULy617uHjAimcs30cQhbIHsvm0m5hzkQiCeR7Csg1lw
+LDXWrzY0tM07+DKo7+N4ifuNRSzanLh+QBxh5z6ikixL8s36mLYp//Pye6kfLqCT
+VyvehQP5aTfLnnhqBbTFMXiJ7HqnheG5ezzevh55hM6fcA5ZwjUukCox2eRFekGk
+LhObNA5me0mrZJfQRsN5nXJQY6aYWwa9SG3YOYNw6DXwBdGqvOPbyALqfP2C2sJb
+UjWumDqtujWTI6cfSN01RpiyEGjkpTHCClguGYEQyVB1/OpaFs4R1+7vUIgtYf8/
+QnMFlEPVjjxOAToZpR9GTnfQXeWBIiGH/pR9hNiTrdZoQ0iy2+tzJOeRf1SktoA+
+naM8THLCV8Sg1Mw4J87VBp6iSNnpn86CcDaTmjvfliHjWbcM2pE38P1ZWrOZyGls
+QyYBNWNgVYkDOnXYukrZVP/u3oDYLdE41V4tC5h9Pmzb/CaIxw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Chambers of Commerce Root - 2008 O=AC Camerfirma S.A.
+# Subject: CN=Chambers of Commerce Root - 2008 O=AC Camerfirma S.A.
+# Label: "Chambers of Commerce Root - 2008"
+# Serial: 11806822484801597146
+# MD5 Fingerprint: 5e:80:9e:84:5a:0e:65:0b:17:02:f3:55:18:2a:3e:d7
+# SHA1 Fingerprint: 78:6a:74:ac:76:ab:14:7f:9c:6a:30:50:ba:9e:a8:7e:fe:9a:ce:3c
+# SHA256 Fingerprint: 06:3e:4a:fa:c4:91:df:d3:32:f3:08:9b:85:42:e9:46:17:d8:93:d7:fe:94:4e:10:a7:93:7e:e2:9d:96:93:c0
+-----BEGIN CERTIFICATE-----
+MIIHTzCCBTegAwIBAgIJAKPaQn6ksa7aMA0GCSqGSIb3DQEBBQUAMIGuMQswCQYD
+VQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3VycmVudCBhZGRyZXNzIGF0
+IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAGA1UEBRMJQTgyNzQzMjg3
+MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xKTAnBgNVBAMTIENoYW1iZXJz
+IG9mIENvbW1lcmNlIFJvb3QgLSAyMDA4MB4XDTA4MDgwMTEyMjk1MFoXDTM4MDcz
+MTEyMjk1MFowga4xCzAJBgNVBAYTAkVVMUMwQQYDVQQHEzpNYWRyaWQgKHNlZSBj
+dXJyZW50IGFkZHJlc3MgYXQgd3d3LmNhbWVyZmlybWEuY29tL2FkZHJlc3MpMRIw
+EAYDVQQFEwlBODI3NDMyODcxGzAZBgNVBAoTEkFDIENhbWVyZmlybWEgUy5BLjEp
+MCcGA1UEAxMgQ2hhbWJlcnMgb2YgQ29tbWVyY2UgUm9vdCAtIDIwMDgwggIiMA0G
+CSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCvAMtwNyuAWko6bHiUfaN/Gh/2NdW9
+28sNRHI+JrKQUrpjOyhYb6WzbZSm891kDFX29ufyIiKAXuFixrYp4YFs8r/lfTJq
+VKAyGVn+H4vXPWCGhSRv4xGzdz4gljUha7MI2XAuZPeEklPWDrCQiorjh40G072Q
+DuKZoRuGDtqaCrsLYVAGUvGef3bsyw/QHg3PmTA9HMRFEFis1tPo1+XqxQEHd9ZR
+5gN/ikilTWh1uem8nk4ZcfUyS5xtYBkL+8ydddy/Js2Pk3g5eXNeJQ7KXOt3EgfL
+ZEFHcpOrUMPrCXZkNNI5t3YRCQ12RcSprj1qr7V9ZS+UWBDsXHyvfuK2GNnQm05a
+Sd+pZgvMPMZ4fKecHePOjlO+Bd5gD2vlGts/4+EhySnB8esHnFIbAURRPHsl18Tl
+UlRdJQfKFiC4reRB7noI/plvg6aRArBsNlVq5331lubKgdaX8ZSD6e2wsWsSaR6s
++12pxZjptFtYer49okQ6Y1nUCyXeG0+95QGezdIp1Z8XGQpvvwyQ0wlf2eOKNcx5
+Wk0ZN5K3xMGtr/R5JJqyAQuxr1yW84Ay+1w9mPGgP0revq+ULtlVmhduYJ1jbLhj
+ya6BXBg14JC7vjxPNyK5fuvPnnchpj04gftI2jE9K+OJ9dC1vX7gUMQSibMjmhAx
+hduub+84Mxh2EQIDAQABo4IBbDCCAWgwEgYDVR0TAQH/BAgwBgEB/wIBDDAdBgNV
+HQ4EFgQU+SSsD7K1+HnA+mCIG8TZTQKeFxkwgeMGA1UdIwSB2zCB2IAU+SSsD7K1
++HnA+mCIG8TZTQKeFxmhgbSkgbEwga4xCzAJBgNVBAYTAkVVMUMwQQYDVQQHEzpN
+YWRyaWQgKHNlZSBjdXJyZW50IGFkZHJlc3MgYXQgd3d3LmNhbWVyZmlybWEuY29t
+L2FkZHJlc3MpMRIwEAYDVQQFEwlBODI3NDMyODcxGzAZBgNVBAoTEkFDIENhbWVy
+ZmlybWEgUy5BLjEpMCcGA1UEAxMgQ2hhbWJlcnMgb2YgQ29tbWVyY2UgUm9vdCAt
+IDIwMDiCCQCj2kJ+pLGu2jAOBgNVHQ8BAf8EBAMCAQYwPQYDVR0gBDYwNDAyBgRV
+HSAAMCowKAYIKwYBBQUHAgEWHGh0dHA6Ly9wb2xpY3kuY2FtZXJmaXJtYS5jb20w
+DQYJKoZIhvcNAQEFBQADggIBAJASryI1wqM58C7e6bXpeHxIvj99RZJe6dqxGfwW
+PJ+0W2aeaufDuV2I6A+tzyMP3iU6XsxPpcG1Lawk0lgH3qLPaYRgM+gQDROpI9CF
+5Y57pp49chNyM/WqfcZjHwj0/gF/JM8rLFQJ3uIrbZLGOU8W6jx+ekbURWpGqOt1
+glanq6B8aBMz9p0w8G8nOSQjKpD9kCk18pPfNKXG9/jvjA9iSnyu0/VU+I22mlaH
+FoI6M6taIgj3grrqLuBHmrS1RaMFO9ncLkVAO+rcf+g769HsJtg1pDDFOqxXnrN2
+pSB7+R5KBWIBpih1YJeSDW4+TTdDDZIVnBgizVGZoCkaPF+KMjNbMMeJL0eYD6MD
+xvbxrN8y8NmBGuScvfaAFPDRLLmF9dijscilIeUcE5fuDr3fKanvNFNb0+RqE4QG
+tjICxFKuItLcsiFCGtpA8CnJ7AoMXOLQusxI0zcKzBIKinmwPQN/aUv0NCB9szTq
+jktk9T79syNnFQ0EuPAtwQlRPLJsFfClI9eDdOTlLsn+mCdCxqvGnrDQWzilm1De
+fhiYtUU79nm06PcaewaD+9CL2rvHvRirCG88gGtAPxkZumWK5r7VXNM21+9AUiRg
+OGcEMeyP84LG3rlV8zsxkVrctQgVrXYlCg17LofiDKYGvCYQbTed7N14jHyAxfDZ
+d0jQ
+-----END CERTIFICATE-----
+
+# Issuer: CN=Global Chambersign Root - 2008 O=AC Camerfirma S.A.
+# Subject: CN=Global Chambersign Root - 2008 O=AC Camerfirma S.A.
+# Label: "Global Chambersign Root - 2008"
+# Serial: 14541511773111788494
+# MD5 Fingerprint: 9e:80:ff:78:01:0c:2e:c1:36:bd:fe:96:90:6e:08:f3
+# SHA1 Fingerprint: 4a:bd:ee:ec:95:0d:35:9c:89:ae:c7:52:a1:2c:5b:29:f6:d6:aa:0c
+# SHA256 Fingerprint: 13:63:35:43:93:34:a7:69:80:16:a0:d3:24:de:72:28:4e:07:9d:7b:52:20:bb:8f:bd:74:78:16:ee:be:ba:ca
+-----BEGIN CERTIFICATE-----
+MIIHSTCCBTGgAwIBAgIJAMnN0+nVfSPOMA0GCSqGSIb3DQEBBQUAMIGsMQswCQYD
+VQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3VycmVudCBhZGRyZXNzIGF0
+IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAGA1UEBRMJQTgyNzQzMjg3
+MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xJzAlBgNVBAMTHkdsb2JhbCBD
+aGFtYmVyc2lnbiBSb290IC0gMjAwODAeFw0wODA4MDExMjMxNDBaFw0zODA3MzEx
+MjMxNDBaMIGsMQswCQYDVQQGEwJFVTFDMEEGA1UEBxM6TWFkcmlkIChzZWUgY3Vy
+cmVudCBhZGRyZXNzIGF0IHd3dy5jYW1lcmZpcm1hLmNvbS9hZGRyZXNzKTESMBAG
+A1UEBRMJQTgyNzQzMjg3MRswGQYDVQQKExJBQyBDYW1lcmZpcm1hIFMuQS4xJzAl
+BgNVBAMTHkdsb2JhbCBDaGFtYmVyc2lnbiBSb290IC0gMjAwODCCAiIwDQYJKoZI
+hvcNAQEBBQADggIPADCCAgoCggIBAMDfVtPkOpt2RbQT2//BthmLN0EYlVJH6xed
+KYiONWwGMi5HYvNJBL99RDaxccy9Wglz1dmFRP+RVyXfXjaOcNFccUMd2drvXNL7
+G706tcuto8xEpw2uIRU/uXpbknXYpBI4iRmKt4DS4jJvVpyR1ogQC7N0ZJJ0YPP2
+zxhPYLIj0Mc7zmFLmY/CDNBAspjcDahOo7kKrmCgrUVSY7pmvWjg+b4aqIG7HkF4
+ddPB/gBVsIdU6CeQNR1MM62X/JcumIS/LMmjv9GYERTtY/jKmIhYF5ntRQOXfjyG
+HoiMvvKRhI9lNNgATH23MRdaKXoKGCQwoze1eqkBfSbW+Q6OWfH9GzO1KTsXO0G2
+Id3UwD2ln58fQ1DJu7xsepeY7s2MH/ucUa6LcL0nn3HAa6x9kGbo1106DbDVwo3V
+yJ2dwW3Q0L9R5OP4wzg2rtandeavhENdk5IMagfeOx2YItaswTXbo6Al/3K1dh3e
+beksZixShNBFks4c5eUzHdwHU1SjqoI7mjcv3N2gZOnm3b2u/GSFHTynyQbehP9r
+6GsaPMWis0L7iwk+XwhSx2LE1AVxv8Rk5Pihg+g+EpuoHtQ2TS9x9o0o9oOpE9Jh
+wZG7SMA0j0GMS0zbaRL/UJScIINZc+18ofLx/d33SdNDWKBWY8o9PeU1VlnpDsog
+zCtLkykPAgMBAAGjggFqMIIBZjASBgNVHRMBAf8ECDAGAQH/AgEMMB0GA1UdDgQW
+BBS5CcqcHtvTbDprru1U8VuTBjUuXjCB4QYDVR0jBIHZMIHWgBS5CcqcHtvTbDpr
+ru1U8VuTBjUuXqGBsqSBrzCBrDELMAkGA1UEBhMCRVUxQzBBBgNVBAcTOk1hZHJp
+ZCAoc2VlIGN1cnJlbnQgYWRkcmVzcyBhdCB3d3cuY2FtZXJmaXJtYS5jb20vYWRk
+cmVzcykxEjAQBgNVBAUTCUE4Mjc0MzI4NzEbMBkGA1UEChMSQUMgQ2FtZXJmaXJt
+YSBTLkEuMScwJQYDVQQDEx5HbG9iYWwgQ2hhbWJlcnNpZ24gUm9vdCAtIDIwMDiC
+CQDJzdPp1X0jzjAOBgNVHQ8BAf8EBAMCAQYwPQYDVR0gBDYwNDAyBgRVHSAAMCow
+KAYIKwYBBQUHAgEWHGh0dHA6Ly9wb2xpY3kuY2FtZXJmaXJtYS5jb20wDQYJKoZI
+hvcNAQEFBQADggIBAICIf3DekijZBZRG/5BXqfEv3xoNa/p8DhxJJHkn2EaqbylZ
+UohwEurdPfWbU1Rv4WCiqAm57OtZfMY18dwY6fFn5a+6ReAJ3spED8IXDneRRXoz
+X1+WLGiLwUePmJs9wOzL9dWCkoQ10b42OFZyMVtHLaoXpGNR6woBrX/sdZ7LoR/x
+fxKxueRkf2fWIyr0uDldmOghp+G9PUIadJpwr2hsUF1Jz//7Dl3mLEfXgTpZALVz
+a2Mg9jFFCDkO9HB+QHBaP9BrQql0PSgvAm11cpUJjUhjxsYjV5KTXjXBjfkK9yyd
+Yhz2rXzdpjEetrHHfoUm+qRqtdpjMNHvkzeyZi99Bffnt0uYlDXA2TopwZ2yUDMd
+SqlapskD7+3056huirRXhOukP9DuqqqHW2Pok+JrqNS4cnhrG+055F3Lm6qH1U9O
+AP7Zap88MQ8oAgF9mOinsKJknnn4SPIVqczmyETrP3iZ8ntxPjzxmKfFGBI/5rso
+M0LpRQp8bfKGeS/Fghl9CYl8slR2iK7ewfPM4W7bMdaTrpmg7yVqc5iJWzouE4ge
+v8CSlDQb4ye3ix5vQv/n6TebUB0tovkC7stYWDpxvGjjqsGvHCgfotwjZT+B6q6Z
+09gwzxMNTxXJhLynSC34MCN32EZLeW32jO06f2ARePTpm67VVMB0gNELQp/B
+-----END CERTIFICATE-----
+
+# Issuer: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Subject: CN=Go Daddy Root Certificate Authority - G2 O=GoDaddy.com, Inc.
+# Label: "Go Daddy Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 80:3a:bc:22:c1:e6:fb:8d:9b:3b:27:4a:32:1b:9a:01
+# SHA1 Fingerprint: 47:be:ab:c9:22:ea:e8:0e:78:78:34:62:a7:9f:45:c2:54:fd:e6:8b
+# SHA256 Fingerprint: 45:14:0b:32:47:eb:9c:c8:c5:b4:f0:d7:b5:30:91:f7:32:92:08:9e:6e:5a:63:e2:74:9d:d3:ac:a9:19:8e:da
+-----BEGIN CERTIFICATE-----
+MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
+EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
+ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz
+NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
+EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE
+AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw
+DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD
+E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH
+/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy
+DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh
+GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR
+tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA
+AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX
+WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu
+9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr
+gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo
+2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
+LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI
+4uJEvlz36hz1
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: d6:39:81:c6:52:7e:96:69:fc:fc:ca:66:ed:05:f2:96
+# SHA1 Fingerprint: b5:1c:06:7c:ee:2b:0c:3d:f8:55:ab:2d:92:f4:fe:39:d4:e7:0f:0e
+# SHA256 Fingerprint: 2c:e1:cb:0b:f9:d2:f9:e1:02:99:3f:be:21:51:52:c3:b2:dd:0c:ab:de:1c:68:e5:31:9b:83:91:54:db:b7:f5
+-----BEGIN CERTIFICATE-----
+MIID3TCCAsWgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBjzELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xMjAwBgNVBAMTKVN0YXJmaWVs
+ZCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAw
+MFoXDTM3MTIzMTIzNTk1OVowgY8xCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6
+b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFyZmllbGQgVGVj
+aG5vbG9naWVzLCBJbmMuMTIwMAYDVQQDEylTdGFyZmllbGQgUm9vdCBDZXJ0aWZp
+Y2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
+ggEBAL3twQP89o/8ArFvW59I2Z154qK3A2FWGMNHttfKPTUuiUP3oWmb3ooa/RMg
+nLRJdzIpVv257IzdIvpy3Cdhl+72WoTsbhm5iSzchFvVdPtrX8WJpRBSiUZV9Lh1
+HOZ/5FSuS/hVclcCGfgXcVnrHigHdMWdSL5stPSksPNkN3mSwOxGXn/hbVNMYq/N
+Hwtjuzqd+/x5AJhhdM8mgkBj87JyahkNmcrUDnXMN/uLicFZ8WJ/X7NfZTD4p7dN
+dloedl40wOiWVpmKs/B/pM293DIxfJHP4F8R+GuqSVzRmZTRouNjWwl2tVZi4Ut0
+HZbUJtQIBFnQmA4O5t78w+wfkPECAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAO
+BgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFHwMMh+n2TB/xH1oo2Kooc6rB1snMA0G
+CSqGSIb3DQEBCwUAA4IBAQARWfolTwNvlJk7mh+ChTnUdgWUXuEok21iXQnCoKjU
+sHU48TRqneSfioYmUeYs0cYtbpUgSpIB7LiKZ3sx4mcujJUDJi5DnUox9g61DLu3
+4jd/IroAow57UvtruzvE03lRTs2Q9GcHGcg8RnoNAX3FWOdt5oUwF5okxBDgBPfg
+8n/Uqgr/Qh037ZTlZFkSIHc40zI+OIF1lnP6aI+xy84fxez6nH7PfrHxBy22/L/K
+pL/QlwVKvOoYKAKQvVR4CSFx09F9HdkWsKlhPdAKACL8x3vLCWRFCztAgfd9fDL1
+mMpYjn0q7pBZc2T5NnReJaH1ZgUufzkVqSr7UIuOhWn0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Subject: CN=Starfield Services Root Certificate Authority - G2 O=Starfield Technologies, Inc.
+# Label: "Starfield Services Root Certificate Authority - G2"
+# Serial: 0
+# MD5 Fingerprint: 17:35:74:af:7b:61:1c:eb:f4:f9:3c:e2:ee:40:f9:a2
+# SHA1 Fingerprint: 92:5a:8f:8d:2c:6d:04:e0:66:5f:59:6a:ff:22:d8:63:e8:25:6f:3f
+# SHA256 Fingerprint: 56:8d:69:05:a2:c8:87:08:a4:b3:02:51:90:ed:cf:ed:b1:97:4a:60:6a:13:c6:e5:29:0f:cb:2a:e6:3e:da:b5
+-----BEGIN CERTIFICATE-----
+MIID7zCCAtegAwIBAgIBADANBgkqhkiG9w0BAQsFADCBmDELMAkGA1UEBhMCVVMx
+EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxJTAjBgNVBAoT
+HFN0YXJmaWVsZCBUZWNobm9sb2dpZXMsIEluYy4xOzA5BgNVBAMTMlN0YXJmaWVs
+ZCBTZXJ2aWNlcyBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5
+MDkwMTAwMDAwMFoXDTM3MTIzMTIzNTk1OVowgZgxCzAJBgNVBAYTAlVTMRAwDgYD
+VQQIEwdBcml6b25hMRMwEQYDVQQHEwpTY290dHNkYWxlMSUwIwYDVQQKExxTdGFy
+ZmllbGQgVGVjaG5vbG9naWVzLCBJbmMuMTswOQYDVQQDEzJTdGFyZmllbGQgU2Vy
+dmljZXMgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBANUMOsQq+U7i9b4Zl1+OiFOxHz/Lz58gE20p
+OsgPfTz3a3Y4Y9k2YKibXlwAgLIvWX/2h/klQ4bnaRtSmpDhcePYLQ1Ob/bISdm2
+8xpWriu2dBTrz/sm4xq6HZYuajtYlIlHVv8loJNwU4PahHQUw2eeBGg6345AWh1K
+Ts9DkTvnVtYAcMtS7nt9rjrnvDH5RfbCYM8TWQIrgMw0R9+53pBlbQLPLJGmpufe
+hRhJfGZOozptqbXuNC66DQO4M99H67FrjSXZm86B0UVGMpZwh94CDklDhbZsc7tk
+6mFBrMnUVN+HL8cisibMn1lUaJ/8viovxFUcdUBgF4UCVTmLfwUCAwEAAaNCMEAw
+DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFJxfAN+q
+AdcwKziIorhtSpzyEZGDMA0GCSqGSIb3DQEBCwUAA4IBAQBLNqaEd2ndOxmfZyMI
+bw5hyf2E3F/YNoHN2BtBLZ9g3ccaaNnRbobhiCPPE95Dz+I0swSdHynVv/heyNXB
+ve6SbzJ08pGCL72CQnqtKrcgfU28elUSwhXqvfdqlS5sdJ/PHLTyxQGjhdByPq1z
+qwubdQxtRbeOlKyWN7Wg0I8VRw7j6IPdj/3vQQF3zCepYoUz8jcI73HPdwbeyBkd
+iEDPfUYd/x7H4c7/I9vG+o1VTqkC50cRRj70/b17KSa7qWFiNyi2LSr2EIZkyXCn
+0q23KXB56jzaYyWf/Wi3MOxw+3WKt21gZ7IeyLnp2KhvAotnDU0mV3HaIPzBSlCN
+sSi6
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Commercial O=AffirmTrust
+# Subject: CN=AffirmTrust Commercial O=AffirmTrust
+# Label: "AffirmTrust Commercial"
+# Serial: 8608355977964138876
+# MD5 Fingerprint: 82:92:ba:5b:ef:cd:8a:6f:a6:3d:55:f9:84:f6:d6:b7
+# SHA1 Fingerprint: f9:b5:b6:32:45:5f:9c:be:ec:57:5f:80:dc:e9:6e:2c:c7:b2:78:b7
+# SHA256 Fingerprint: 03:76:ab:1d:54:c5:f9:80:3c:e4:b2:e2:01:a0:ee:7e:ef:7b:57:b6:36:e8:a9:3c:9b:8d:48:60:c9:6f:5f:a7
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIId3cGJyapsXwwDQYJKoZIhvcNAQELBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBDb21tZXJjaWFsMB4XDTEwMDEyOTE0MDYwNloXDTMwMTIzMTE0MDYwNlowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBDb21tZXJjaWFsMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEA9htPZwcroRX1BiLLHwGy43NFBkRJLLtJJRTWzsO3qyxPxkEylFf6EqdbDuKP
+Hx6GGaeqtS25Xw2Kwq+FNXkyLbscYjfysVtKPcrNcV/pQr6U6Mje+SJIZMblq8Yr
+ba0F8PrVC8+a5fBQpIs7R6UjW3p6+DM/uO+Zl+MgwdYoic+U+7lF7eNAFxHUdPAL
+MeIrJmqbTFeurCA+ukV6BfO9m2kVrn1OIGPENXY6BwLJN/3HR+7o8XYdcxXyl6S1
+yHp52UKqK39c/s4mT6NmgTWvRLpUHhwwMmWd5jyTXlBOeuM61G7MGvv50jeuJCqr
+VwMiKA1JdX+3KNp1v47j3A55MQIDAQABo0IwQDAdBgNVHQ4EFgQUnZPGU4teyq8/
+nx4P5ZmVvCT2lI8wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQELBQADggEBAFis9AQOzcAN/wr91LoWXym9e2iZWEnStB03TX8nfUYG
+XUPGhi4+c7ImfU+TqbbEKpqrIZcUsd6M06uJFdhrJNTxFq7YpFzUf1GO7RgBsZNj
+vbz4YYCanrHOQnDiqX0GJX0nof5v7LMeJNrjS1UaADs1tDvZ110w/YETifLCBivt
+Z8SOyUOyXGsViQK8YvxO8rUzqrJv0wqiUOP2O+guRMLbZjipM1ZI8W0bM40NjD9g
+N53Tym1+NH4Nn3J2ixufcv1SNUFFApYvHLKac0khsUlHRUe072o0EclNmsxZt9YC
+nlpOZbWUrhvfKbAW8b8Angc6F2S1BLUjIZkKlTuXfO8=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Networking O=AffirmTrust
+# Subject: CN=AffirmTrust Networking O=AffirmTrust
+# Label: "AffirmTrust Networking"
+# Serial: 8957382827206547757
+# MD5 Fingerprint: 42:65:ca:be:01:9a:9a:4c:a9:8c:41:49:cd:c0:d5:7f
+# SHA1 Fingerprint: 29:36:21:02:8b:20:ed:02:f5:66:c5:32:d1:d6:ed:90:9f:45:00:2f
+# SHA256 Fingerprint: 0a:81:ec:5a:92:97:77:f1:45:90:4a:f3:8d:5d:50:9f:66:b5:e2:c5:8f:cd:b5:31:05:8b:0e:17:f3:f0:b4:1b
+-----BEGIN CERTIFICATE-----
+MIIDTDCCAjSgAwIBAgIIfE8EORzUmS0wDQYJKoZIhvcNAQEFBQAwRDELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZpcm1UcnVz
+dCBOZXR3b3JraW5nMB4XDTEwMDEyOTE0MDgyNFoXDTMwMTIzMTE0MDgyNFowRDEL
+MAkGA1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MR8wHQYDVQQDDBZBZmZp
+cm1UcnVzdCBOZXR3b3JraW5nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
+AQEAtITMMxcua5Rsa2FSoOujz3mUTOWUgJnLVWREZY9nZOIG41w3SfYvm4SEHi3y
+YJ0wTsyEheIszx6e/jarM3c1RNg1lho9Nuh6DtjVR6FqaYvZ/Ls6rnla1fTWcbua
+kCNrmreIdIcMHl+5ni36q1Mr3Lt2PpNMCAiMHqIjHNRqrSK6mQEubWXLviRmVSRL
+QESxG9fhwoXA3hA/Pe24/PHxI1Pcv2WXb9n5QHGNfb2V1M6+oF4nI979ptAmDgAp
+6zxG8D1gvz9Q0twmQVGeFDdCBKNwV6gbh+0t+nvujArjqWaJGctB+d1ENmHP4ndG
+yH329JKBNv3bNPFyfvMMFr20FQIDAQABo0IwQDAdBgNVHQ4EFgQUBx/S55zawm6i
+QLSwelAQUHTEyL0wDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwDQYJ
+KoZIhvcNAQEFBQADggEBAIlXshZ6qML91tmbmzTCnLQyFE2npN/svqe++EPbkTfO
+tDIuUFUaNU52Q3Eg75N3ThVwLofDwR1t3Mu1J9QsVtFSUzpE0nPIxBsFZVpikpzu
+QY0x2+c06lkh1QF612S4ZDnNye2v7UsDSKegmQGA3GWjNq5lWUhPgkvIZfFXHeVZ
+Lgo/bNjR9eUJtGxUAArgFU2HdW23WJZa3W3SAKD0m0i+wzekujbgfIeFlxoVot4u
+olu9rxj5kFDNcFn4J2dHy8egBzp90SxdbBk6ZrV9/ZFvgrG+CJPbFEfxojfHRZ48
+x3evZKiT3/Zpg4Jg8klCNO1aAFSFHBY2kgxc+qatv9s=
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium O=AffirmTrust
+# Subject: CN=AffirmTrust Premium O=AffirmTrust
+# Label: "AffirmTrust Premium"
+# Serial: 7893706540734352110
+# MD5 Fingerprint: c4:5d:0e:48:b6:ac:28:30:4e:0a:bc:f9:38:16:87:57
+# SHA1 Fingerprint: d8:a6:33:2c:e0:03:6f:b1:85:f6:63:4f:7d:6a:06:65:26:32:28:27
+# SHA256 Fingerprint: 70:a7:3f:7f:37:6b:60:07:42:48:90:45:34:b1:14:82:d5:bf:0e:69:8e:cc:49:8d:f5:25:77:eb:f2:e9:3b:9a
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIIbYwURrGmCu4wDQYJKoZIhvcNAQEMBQAwQTELMAkGA1UE
+BhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1UcnVz
+dCBQcmVtaXVtMB4XDTEwMDEyOTE0MTAzNloXDTQwMTIzMTE0MTAzNlowQTELMAkG
+A1UEBhMCVVMxFDASBgNVBAoMC0FmZmlybVRydXN0MRwwGgYDVQQDDBNBZmZpcm1U
+cnVzdCBQcmVtaXVtMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxBLf
+qV/+Qd3d9Z+K4/as4Tx4mrzY8H96oDMq3I0gW64tb+eT2TZwamjPjlGjhVtnBKAQ
+JG9dKILBl1fYSCkTtuG+kU3fhQxTGJoeJKJPj/CihQvL9Cl/0qRY7iZNyaqoe5rZ
++jjeRFcV5fiMyNlI4g0WJx0eyIOFJbe6qlVBzAMiSy2RjYvmia9mx+n/K+k8rNrS
+s8PhaJyJ+HoAVt70VZVs+7pk3WKL3wt3MutizCaam7uqYoNMtAZ6MMgpv+0GTZe5
+HMQxK9VfvFMSF5yZVylmd2EhMQcuJUmdGPLu8ytxjLW6OQdJd/zvLpKQBY0tL3d7
+70O/Nbua2Plzpyzy0FfuKE4mX4+QaAkvuPjcBukumj5Rp9EixAqnOEhss/n/fauG
+V+O61oV4d7pD6kh/9ti+I20ev9E2bFhc8e6kGVQa9QPSdubhjL08s9NIS+LI+H+S
+qHZGnEJlPqQewQcDWkYtuJfzt9WyVSHvutxMAJf7FJUnM7/oQ0dG0giZFmA7mn7S
+5u046uwBHjxIVkkJx0w3AJ6IDsBz4W9m6XJHMD4Q5QsDyZpCAGzFlH5hxIrff4Ia
+C1nEWTJ3s7xgaVY5/bQGeyzWZDbZvUjthB9+pSKPKrhC9IK31FOQeE4tGv2Bb0TX
+OwF0lkLgAOIua+rF7nKsu7/+6qqo+Nz2snmKtmcCAwEAAaNCMEAwHQYDVR0OBBYE
+FJ3AZ6YMItkm9UWrpmVSESfYRaxjMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgEGMA0GCSqGSIb3DQEBDAUAA4ICAQCzV00QYk465KzquByvMiPIs0laUZx2
+KI15qldGF9X1Uva3ROgIRL8YhNILgM3FEv0AVQVhh0HctSSePMTYyPtwni94loMg
+Nt58D2kTiKV1NpgIpsbfrM7jWNa3Pt668+s0QNiigfV4Py/VpfzZotReBA4Xrf5B
+8OWycvpEgjNC6C1Y91aMYj+6QrCcDFx+LmUmXFNPALJ4fqENmS2NuB2OosSw/WDQ
+MKSOyARiqcTtNd56l+0OOF6SL5Nwpamcb6d9Ex1+xghIsV5n61EIJenmJWtSKZGc
+0jlzCFfemQa0W50QBuHCAKi4HEoCChTQwUHK+4w1IX2COPKpVJEZNZOUbWo6xbLQ
+u4mGk+ibyQ86p3q4ofB4Rvr8Ny/lioTz3/4E2aFooC8k4gmVBtWVyuEklut89pMF
+u+1z6S3RdTnX5yTb2E5fQ4+e0BQ5v1VwSJlXMbSc7kqYA5YwH2AG7hsj/oFgIxpH
+YoWlzBk0gG+zrBrjn/B7SK3VAdlntqlyk+otZrWyuOQ9PLLvTIzq6we/qzWaVYa8
+GKa1qF60g2xraUDTn9zxw2lrueFtCfTxqlB2Cnp9ehehVZZCmTEJ3WARjQUwfuaO
+RtGdFNrHF+QFlozEJLUbzxQHskD4o55BhrwE0GuWyCqANP2/7waj3VjFhT0+j/6e
+KeC2uAloGRwYQw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Subject: CN=AffirmTrust Premium ECC O=AffirmTrust
+# Label: "AffirmTrust Premium ECC"
+# Serial: 8401224907861490260
+# MD5 Fingerprint: 64:b0:09:55:cf:b1:d5:99:e2:be:13:ab:a6:5d:ea:4d
+# SHA1 Fingerprint: b8:23:6b:00:2f:1d:16:86:53:01:55:6c:11:a4:37:ca:eb:ff:c3:bb
+# SHA256 Fingerprint: bd:71:fd:f6:da:97:e4:cf:62:d1:64:7a:dd:25:81:b0:7d:79:ad:f8:39:7e:b4:ec:ba:9c:5e:84:88:82:14:23
+-----BEGIN CERTIFICATE-----
+MIIB/jCCAYWgAwIBAgIIdJclisc/elQwCgYIKoZIzj0EAwMwRTELMAkGA1UEBhMC
+VVMxFDASBgNVBAoMC0FmZmlybVRydXN0MSAwHgYDVQQDDBdBZmZpcm1UcnVzdCBQ
+cmVtaXVtIEVDQzAeFw0xMDAxMjkxNDIwMjRaFw00MDEyMzExNDIwMjRaMEUxCzAJ
+BgNVBAYTAlVTMRQwEgYDVQQKDAtBZmZpcm1UcnVzdDEgMB4GA1UEAwwXQWZmaXJt
+VHJ1c3QgUHJlbWl1bSBFQ0MwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNMF4bFZ0D
+0KF5Nbc6PJJ6yhUczWLznCZcBz3lVPqj1swS6vQUX+iOGasvLkjmrBhDeKzQN8O9
+ss0s5kfiGuZjuD0uL3jET9v0D6RoTFVya5UdThhClXjMNzyR4ptlKymjQjBAMB0G
+A1UdDgQWBBSaryl6wBE1NSZRMADDav5A1a7WPDAPBgNVHRMBAf8EBTADAQH/MA4G
+A1UdDwEB/wQEAwIBBjAKBggqhkjOPQQDAwNnADBkAjAXCfOHiFBar8jAQr9HX/Vs
+aobgxCd05DhT1wV/GzTjxi+zygk8N53X57hG8f2h4nECMEJZh0PUUd+60wkyWs6I
+flc9nF9Ca/UHLbXwgpP5WW+uZPpY5Yse42O+tYHNbwKMeQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA"
+# Serial: 279744
+# MD5 Fingerprint: d5:e9:81:40:c5:18:69:fc:46:2c:89:75:62:0f:aa:78
+# SHA1 Fingerprint: 07:e0:32:e0:20:b7:2c:3f:19:2f:06:28:a2:59:3a:19:a7:0f:06:9e
+# SHA256 Fingerprint: 5c:58:46:8d:55:f5:8e:49:7e:74:39:82:d2:b5:00:10:b6:d1:65:37:4a:cf:83:a7:d4:a3:2d:b7:68:c4:40:8e
+-----BEGIN CERTIFICATE-----
+MIIDuzCCAqOgAwIBAgIDBETAMA0GCSqGSIb3DQEBBQUAMH4xCzAJBgNVBAYTAlBM
+MSIwIAYDVQQKExlVbml6ZXRvIFRlY2hub2xvZ2llcyBTLkEuMScwJQYDVQQLEx5D
+ZXJ0dW0gQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkxIjAgBgNVBAMTGUNlcnR1bSBU
+cnVzdGVkIE5ldHdvcmsgQ0EwHhcNMDgxMDIyMTIwNzM3WhcNMjkxMjMxMTIwNzM3
+WjB+MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMg
+Uy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MSIw
+IAYDVQQDExlDZXJ0dW0gVHJ1c3RlZCBOZXR3b3JrIENBMIIBIjANBgkqhkiG9w0B
+AQEFAAOCAQ8AMIIBCgKCAQEA4/t9o3K6wvDJFIf1awFO4W5AB7ptJ11/91sts1rH
+UV+rpDKmYYe2bg+G0jACl/jXaVehGDldamR5xgFZrDwxSjh80gTSSyjoIF87B6LM
+TXPb865Px1bVWqeWifrzq2jUI4ZZJ88JJ7ysbnKDHDBy3+Ci6dLhdHUZvSqeexVU
+BBvXQzmtVSjF4hq79MDkrjhJM8x2hZ85RdKknvISjFH4fOQtf/WsX+sWn7Et0brM
+kUJ3TCXJkDhv2/DM+44el1k+1WBO5gUo7Ul5E0u6SNsv+XLTOcr+H9g0cvW0QM8x
+AcPs3hEtF10fuFDRXhmnad4HMyjKUJX5p1TLVIZQRan5SQIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBQIds3LB/8k9sXN7buQvOKEN0Z19zAOBgNV
+HQ8BAf8EBAMCAQYwDQYJKoZIhvcNAQEFBQADggEBAKaorSLOAT2mo/9i0Eidi15y
+sHhE49wcrwn9I0j6vSrEuVUEtRCjjSfeC4Jj0O7eDDd5QVsisrCaQVymcODU0HfL
+I9MA4GxWL+FpDQ3Zqr8hgVDZBqWo/5U30Kr+4rP1mS1FhIrlQgnXdAIv94nYmem8
+J9RHjboNRhx3zxSkHLmkMcScKHQDNP8zGSal6Q10tz6XxnboJ5ajZt3hrvJBW8qY
+VoNzcOSGGtIxQbovvi0TWnZvTuhOgQ4/WwMioBK+ZlgRSssDxLQqKi2WF+A5VLxI
+03YnnZotBqbJ7DnSq9ufmgsnAjUpsUCV5/nonFWIGUbWtzT1fs45mtk48VH3Tyw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Root Certification Authority O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Root Certification Authority"
+# Serial: 1
+# MD5 Fingerprint: aa:08:8f:f6:f9:7b:b7:f2:b1:a7:1e:9b:ea:ea:bd:79
+# SHA1 Fingerprint: cf:9e:87:6d:d3:eb:fc:42:26:97:a3:b5:a3:7a:a0:76:a9:06:23:48
+# SHA256 Fingerprint: bf:d8:8f:e1:10:1c:41:ae:3e:80:1b:f8:be:56:35:0e:e9:ba:d1:a6:b9:bd:51:5e:dc:5c:6d:5b:87:11:ac:44
+-----BEGIN CERTIFICATE-----
+MIIDezCCAmOgAwIBAgIBATANBgkqhkiG9w0BAQUFADBfMQswCQYDVQQGEwJUVzES
+MBAGA1UECgwJVEFJV0FOLUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFU
+V0NBIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMDgwODI4MDcyNDMz
+WhcNMzAxMjMxMTU1OTU5WjBfMQswCQYDVQQGEwJUVzESMBAGA1UECgwJVEFJV0FO
+LUNBMRAwDgYDVQQLDAdSb290IENBMSowKAYDVQQDDCFUV0NBIFJvb3QgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
+AQCwfnK4pAOU5qfeCTiRShFAh6d8WWQUe7UREN3+v9XAu1bihSX0NXIP+FPQQeFE
+AcK0HMMxQhZHhTMidrIKbw/lJVBPhYa+v5guEGcevhEFhgWQxFnQfHgQsIBct+HH
+K3XLfJ+utdGdIzdjp9xCoi2SBBtQwXu4PhvJVgSLL1KbralW6cH/ralYhzC2gfeX
+RfwZVzsrb+RH9JlF/h3x+JejiB03HFyP4HYlmlD4oFT/RJB2I9IyxsOrBr/8+7/z
+rX2SYgJbKdM1o5OaQ2RgXbL6Mv87BK9NQGr5x+PvI/1ry+UPizgN7gr8/g+YnzAx
+3WxSZfmLgb4i4RxYA7qRG4kHAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqOFsmjd6LWvJPelSDGRjjCDWmujANBgkq
+hkiG9w0BAQUFAAOCAQEAPNV3PdrfibqHDAhUaiBQkr6wQT25JmSDCi/oQMCXKCeC
+MErJk/9q56YAf4lCmtYR5VPOL8zy2gXE/uJQxDqGfczafhAJO5I1KlOy/usrBdls
+XebQ79NqZp4VKIV66IIArB6nCWlWQtNoURi+VJq/REG6Sb4gumlc7rh3zc5sH62D
+lhh9DrUUOYTxKOkto557HnpyWoOzeW/vtPzQCqVYT0bf+215WfKEIlKuD8z7fDvn
+aspHYcN6+NOSBB+4IIThNlQWx0DeO4pz3N/GCUzf7Nr/1FNCocnyYh0igzyXxfkZ
+YiesZSLX0zzG5Y6yU8xJzrww/nsOM5D77dIUkR8Hrw==
+-----END CERTIFICATE-----
+
+# Issuer: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Subject: O=SECOM Trust Systems CO.,LTD. OU=Security Communication RootCA2
+# Label: "Security Communication RootCA2"
+# Serial: 0
+# MD5 Fingerprint: 6c:39:7d:a4:0e:55:59:b2:3f:d6:41:b1:12:50:de:43
+# SHA1 Fingerprint: 5f:3b:8c:f2:f8:10:b3:7d:78:b4:ce:ec:19:19:c3:73:34:b9:c7:74
+# SHA256 Fingerprint: 51:3b:2c:ec:b8:10:d4:cd:e5:dd:85:39:1a:df:c6:c2:dd:60:d8:7b:b7:36:d2:b5:21:48:4a:a4:7a:0e:be:f6
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIBADANBgkqhkiG9w0BAQsFADBdMQswCQYDVQQGEwJKUDEl
+MCMGA1UEChMcU0VDT00gVHJ1c3QgU3lzdGVtcyBDTy4sTFRELjEnMCUGA1UECxMe
+U2VjdXJpdHkgQ29tbXVuaWNhdGlvbiBSb290Q0EyMB4XDTA5MDUyOTA1MDAzOVoX
+DTI5MDUyOTA1MDAzOVowXTELMAkGA1UEBhMCSlAxJTAjBgNVBAoTHFNFQ09NIFRy
+dXN0IFN5c3RlbXMgQ08uLExURC4xJzAlBgNVBAsTHlNlY3VyaXR5IENvbW11bmlj
+YXRpb24gUm9vdENBMjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBANAV
+OVKxUrO6xVmCxF1SrjpDZYBLx/KWvNs2l9amZIyoXvDjChz335c9S672XewhtUGr
+zbl+dp+++T42NKA7wfYxEUV0kz1XgMX5iZnK5atq1LXaQZAQwdbWQonCv/Q4EpVM
+VAX3NuRFg3sUZdbcDE3R3n4MqzvEFb46VqZab3ZpUql6ucjrappdUtAtCms1FgkQ
+hNBqyjoGADdH5H5XTz+L62e4iKrFvlNVspHEfbmwhRkGeC7bYRr6hfVKkaHnFtWO
+ojnflLhwHyg/i/xAXmODPIMqGplrz95Zajv8bxbXH/1KEOtOghY6rCcMU/Gt1SSw
+awNQwS08Ft1ENCcadfsCAwEAAaNCMEAwHQYDVR0OBBYEFAqFqXdlBZh8QIH4D5cs
+OPEK7DzPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MA0GCSqGSIb3
+DQEBCwUAA4IBAQBMOqNErLlFsceTfsgLCkLfZOoc7llsCLqJX2rKSpWeeo8HxdpF
+coJxDjrSzG+ntKEju/Ykn8sX/oymzsLS28yN/HH8AynBbF0zX2S2ZTuJbxh2ePXc
+okgfGT+Ok+vx+hfuzU7jBBJV1uXk3fs+BXziHV7Gp7yXT2g69ekuCkO2r1dcYmh8
+t/2jioSgrGK+KwmHNPBqAbubKVY8/gA3zyNs8U6qtnRGEmyR7jTV7JqR50S+kDFy
+1UkC9gLl9B/rfNmWVan/7Ir5mUf/NVoCqgTLiluHcSmRvaS0eg29mvVXIwAHIRc/
+SjnRBUkLp7Y3gaVdjKozXoEofKd9J+sAro03
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions RootCA 2011 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions RootCA 2011"
+# Serial: 0
+# MD5 Fingerprint: 73:9f:4c:4b:73:5b:79:e9:fa:ba:1c:ef:6e:cb:d5:c9
+# SHA1 Fingerprint: fe:45:65:9b:79:03:5b:98:a1:61:b5:51:2e:ac:da:58:09:48:22:4d
+# SHA256 Fingerprint: bc:10:4f:15:a4:8b:e7:09:dc:a5:42:a7:e1:d4:b9:df:6f:05:45:27:e8:02:ea:a9:2d:59:54:44:25:8a:fe:71
+-----BEGIN CERTIFICATE-----
+MIIEMTCCAxmgAwIBAgIBADANBgkqhkiG9w0BAQUFADCBlTELMAkGA1UEBhMCR1Ix
+RDBCBgNVBAoTO0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
+dGlvbnMgQ2VydC4gQXV0aG9yaXR5MUAwPgYDVQQDEzdIZWxsZW5pYyBBY2FkZW1p
+YyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIFJvb3RDQSAyMDExMB4XDTExMTIw
+NjEzNDk1MloXDTMxMTIwMTEzNDk1MlowgZUxCzAJBgNVBAYTAkdSMUQwQgYDVQQK
+EztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0dXRpb25zIENl
+cnQuIEF1dGhvcml0eTFAMD4GA1UEAxM3SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBSb290Q0EgMjAxMTCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBAKlTAOMupvaO+mDYLZU++CwqVE7NuYRhlFhPjz2L5EPz
+dYmNUeTDN9KKiE15HrcS3UN4SoqS5tdI1Q+kOilENbgH9mgdVc04UfCMJDGFr4PJ
+fel3r+0ae50X+bOdOFAPplp5kYCvN66m0zH7tSYJnTxa71HFK9+WXesyHgLacEns
+bgzImjeN9/E2YEsmLIKe0HjzDQ9jpFEw4fkrJxIH2Oq9GGKYsFk3fb7u8yBRQlqD
+75O6aRXxYp2fmTmCobd0LovUxQt7L/DICto9eQqakxylKHJzkUOap9FNhYS5qXSP
+FEDH3N6sQWRstBmbAmNtJGSPRLIl6s5ddAxjMlyNh+UCAwEAAaOBiTCBhjAPBgNV
+HRMBAf8EBTADAQH/MAsGA1UdDwQEAwIBBjAdBgNVHQ4EFgQUppFC/RNhSiOeCKQp
+5dgTBCPuQSUwRwYDVR0eBEAwPqA8MAWCAy5ncjAFggMuZXUwBoIELmVkdTAGggQu
+b3JnMAWBAy5ncjAFgQMuZXUwBoEELmVkdTAGgQQub3JnMA0GCSqGSIb3DQEBBQUA
+A4IBAQAf73lB4XtuP7KMhjdCSk4cNx6NZrokgclPEg8hwAOXhiVtXdMiKahsog2p
+6z0GW5k6x8zDmjR/qw7IThzh+uTczQ2+vyT+bOdrwg3IBp5OjWEopmr95fZi6hg8
+TqBTnbI6nOulnJEWtk2C4AwFSKls9cz4y51JtPACpf1wA+2KIaWuE4ZJwzNzvoc7
+dIsXRSZMFpGD/md9zU1jZ/rzAxKWeAaNsWftjj++n08C9bMJL/NMh98qy5V8Acys
+Nnq/onN694/BtZqhFLKPM58N7yLcZnuEvUUXBj08yrl3NI/K6s8/MT7jiOOASSXI
+l7WdmplNsDz4SgCbZN2fOUvRJ9e4
+-----END CERTIFICATE-----
+
+# Issuer: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Subject: CN=Actalis Authentication Root CA O=Actalis S.p.A./03358520967
+# Label: "Actalis Authentication Root CA"
+# Serial: 6271844772424770508
+# MD5 Fingerprint: 69:c1:0d:4f:07:a3:1b:c3:fe:56:3d:04:bc:11:f6:a6
+# SHA1 Fingerprint: f3:73:b3:87:06:5a:28:84:8a:f2:f3:4a:ce:19:2b:dd:c7:8e:9c:ac
+# SHA256 Fingerprint: 55:92:60:84:ec:96:3a:64:b9:6e:2a:be:01:ce:0b:a8:6a:64:fb:fe:bc:c7:aa:b5:af:c1:55:b3:7f:d7:60:66
+-----BEGIN CERTIFICATE-----
+MIIFuzCCA6OgAwIBAgIIVwoRl0LE48wwDQYJKoZIhvcNAQELBQAwazELMAkGA1UE
+BhMCSVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8w
+MzM1ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290
+IENBMB4XDTExMDkyMjExMjIwMloXDTMwMDkyMjExMjIwMlowazELMAkGA1UEBhMC
+SVQxDjAMBgNVBAcMBU1pbGFuMSMwIQYDVQQKDBpBY3RhbGlzIFMucC5BLi8wMzM1
+ODUyMDk2NzEnMCUGA1UEAwweQWN0YWxpcyBBdXRoZW50aWNhdGlvbiBSb290IENB
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAp8bEpSmkLO/lGMWwUKNv
+UTufClrJwkg4CsIcoBh/kbWHuUA/3R1oHwiD1S0eiKD4j1aPbZkCkpAW1V8IbInX
+4ay8IMKx4INRimlNAJZaby/ARH6jDuSRzVju3PvHHkVH3Se5CAGfpiEd9UEtL0z9
+KK3giq0itFZljoZUj5NDKd45RnijMCO6zfB9E1fAXdKDa0hMxKufgFpbOr3JpyI/
+gCczWw63igxdBzcIy2zSekciRDXFzMwujt0q7bd9Zg1fYVEiVRvjRuPjPdA1Yprb
+rxTIW6HMiRvhMCb8oJsfgadHHwTrozmSBp+Z07/T6k9QnBn+locePGX2oxgkg4YQ
+51Q+qDp2JE+BIcXjDwL4k5RHILv+1A7TaLndxHqEguNTVHnd25zS8gebLra8Pu2F
+be8lEfKXGkJh90qX6IuxEAf6ZYGyojnP9zz/GPvG8VqLWeICrHuS0E4UT1lF9gxe
+KF+w6D9Fz8+vm2/7hNN3WpVvrJSEnu68wEqPSpP4RCHiMUVhUE4Q2OM1fEwZtN4F
+v6MGn8i1zeQf1xcGDXqVdFUNaBr8EBtiZJ1t4JWgw5QHVw0U5r0F+7if5t+L4sbn
+fpb2U8WANFAoWPASUHEXMLrmeGO89LKtmyuy/uE5jF66CyCU3nuDuP/jVo23Eek7
+jPKxwV2dpAtMK9myGPW1n0sCAwEAAaNjMGEwHQYDVR0OBBYEFFLYiDrIn3hm7Ynz
+ezhwlMkCAjbQMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUUtiIOsifeGbt
+ifN7OHCUyQICNtAwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAL
+e3KHwGCmSUyIWOYdiPcUZEim2FgKDk8TNd81HdTtBjHIgT5q1d07GjLukD0R0i70
+jsNjLiNmsGe+b7bAEzlgqqI0JZN1Ut6nna0Oh4lScWoWPBkdg/iaKWW+9D+a2fDz
+WochcYBNy+A4mz+7+uAwTc+G02UQGRjRlwKxK3JCaKygvU5a2hi/a5iB0P2avl4V
+SM0RFbnAKVy06Ij3Pjaut2L9HmLecHgQHEhb2rykOLpn7VU+Xlff1ANATIGk0k9j
+pwlCCRT8AKnCgHNPLsBA2RF7SOp6AsDT6ygBJlh0wcBzIm2Tlf05fbsq4/aC4yyX
+X04fkZT6/iyj2HYauE2yOE+b+h1IYHkm4vP9qdCa6HCPSXrW5b0KDtst842/6+Ok
+fcvHlXHo2qN8xcL4dJIEG4aspCJTQLas/kx2z/uUMsA1n3Y/buWQbqCmJqK4LL7R
+K4X9p2jIugErsWx0Hbhzlefut8cl8ABMALJ+tguLHPPAUJ4lueAI3jZm/zel0btU
+ZCzJJ7VLkn5l/9Mt4blOvH+kQSGQQXemOR/qnuOf0GZvBeyqdn6/axag67XH/JJU
+LysRJyU3eExRarDzzFhdFPFqSBX/wge2sY0PjlxQRrM9vwGYT7JZVEc+NHt4bVaT
+LnPqZih4zR0Uv6CPLy64Lo7yFIrM6bV8+2ydDKXhlg==
+-----END CERTIFICATE-----
+
+# Issuer: O=Trustis Limited OU=Trustis FPS Root CA
+# Subject: O=Trustis Limited OU=Trustis FPS Root CA
+# Label: "Trustis FPS Root CA"
+# Serial: 36053640375399034304724988975563710553
+# MD5 Fingerprint: 30:c9:e7:1e:6b:e6:14:eb:65:b2:16:69:20:31:67:4d
+# SHA1 Fingerprint: 3b:c0:38:0b:33:c3:f6:a6:0c:86:15:22:93:d9:df:f5:4b:81:c0:04
+# SHA256 Fingerprint: c1:b4:82:99:ab:a5:20:8f:e9:63:0a:ce:55:ca:68:a0:3e:da:5a:51:9c:88:02:a0:d3:a6:73:be:8f:8e:55:7d
+-----BEGIN CERTIFICATE-----
+MIIDZzCCAk+gAwIBAgIQGx+ttiD5JNM2a/fH8YygWTANBgkqhkiG9w0BAQUFADBF
+MQswCQYDVQQGEwJHQjEYMBYGA1UEChMPVHJ1c3RpcyBMaW1pdGVkMRwwGgYDVQQL
+ExNUcnVzdGlzIEZQUyBSb290IENBMB4XDTAzMTIyMzEyMTQwNloXDTI0MDEyMTEx
+MzY1NFowRTELMAkGA1UEBhMCR0IxGDAWBgNVBAoTD1RydXN0aXMgTGltaXRlZDEc
+MBoGA1UECxMTVHJ1c3RpcyBGUFMgUm9vdCBDQTCCASIwDQYJKoZIhvcNAQEBBQAD
+ggEPADCCAQoCggEBAMVQe547NdDfxIzNjpvto8A2mfRC6qc+gIMPpqdZh8mQRUN+
+AOqGeSoDvT03mYlmt+WKVoaTnGhLaASMk5MCPjDSNzoiYYkchU59j9WvezX2fihH
+iTHcDnlkH5nSW7r+f2C/revnPDgpai/lkQtV/+xvWNUtyd5MZnGPDNcE2gfmHhjj
+vSkCqPoc4Vu5g6hBSLwacY3nYuUtsuvffM/bq1rKMfFMIvMFE/eC+XN5DL7XSxzA
+0RU8k0Fk0ea+IxciAIleH2ulrG6nS4zto3Lmr2NNL4XSFDWaLk6M6jKYKIahkQlB
+OrTh4/L68MkKokHdqeMDx4gVOxzUGpTXn2RZEm0CAwEAAaNTMFEwDwYDVR0TAQH/
+BAUwAwEB/zAfBgNVHSMEGDAWgBS6+nEleYtXQSUhhgtx67JkDoshZzAdBgNVHQ4E
+FgQUuvpxJXmLV0ElIYYLceuyZA6LIWcwDQYJKoZIhvcNAQEFBQADggEBAH5Y//01
+GX2cGE+esCu8jowU/yyg2kdbw++BLa8F6nRIW/M+TgfHbcWzk88iNVy2P3UnXwmW
+zaD+vkAMXBJV+JOCyinpXj9WV4s4NvdFGkwozZ5BuO1WTISkQMi4sKUraXAEasP4
+1BIy+Q7DsdwyhEQsb8tGD+pmQQ9P8Vilpg0ND2HepZ5dfWWhPBfnqFVO76DH7cZE
+f1T1o+CP8HxVIo8ptoGj4W1OLBuAZ+ytIJ8MYmHVl/9D7S3B2l0pKoU/rGXuhg8F
+jZBf3+6f9L/uHfuY5H+QK4R4EA5sSVPvFVtlRkpdr7r7OnIdzfYliB6XzCGcKQEN
+ZetX2fNXlrtIzYE=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 2 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 2 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 46:a7:d2:fe:45:fb:64:5a:a8:59:90:9b:78:44:9b:29
+# SHA1 Fingerprint: 49:0a:75:74:de:87:0a:47:fe:58:ee:f6:c7:6b:eb:c6:0b:12:40:99
+# SHA256 Fingerprint: 9a:11:40:25:19:7c:5b:b9:5d:94:e6:3d:55:cd:43:79:08:47:b6:46:b2:3c:df:11:ad:a4:a0:0e:ff:15:fb:48
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMiBSb290IENBMB4XDTEwMTAyNjA4MzgwM1oXDTQwMTAyNjA4MzgwM1ow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDIgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBANfHXvfBB9R3+0Mh9PT1aeTuMgHbo4Yf5FkNuud1g1Lr
+6hxhFUi7HQfKjK6w3Jad6sNgkoaCKHOcVgb/S2TwDCo3SbXlzwx87vFKu3MwZfPV
+L4O2fuPn9Z6rYPnT8Z2SdIrkHJasW4DptfQxh6NR/Md+oW+OU3fUl8FVM5I+GC91
+1K2GScuVr1QGbNgGE41b/+EmGVnAJLqBcXmQRFBoJJRfuLMR8SlBYaNByyM21cHx
+MlAQTn/0hpPshNOOvEu/XAFOBz3cFIqUCqTqc/sLUegTBxj6DvEr0VQVfTzh97QZ
+QmdiXnfgolXsttlpF9U6r0TtSsWe5HonfOV116rLJeffawrbD02TTqigzXsu8lkB
+arcNuAeBfos4GzjmCleZPe4h6KP1DBbdi+w0jpwqHAAVF41og9JwnxgIzRFo1clr
+Us3ERo/ctfPYV3Me6ZQ5BL/T3jjetFPsaRyifsSP5BtwrfKi+fv3FmRmaZ9JUaLi
+FRhnBkp/1Wy1TbMz4GHrXb7pmA8y1x1LPC5aAVKRCfLf6o3YBkBjqhHk/sM3nhRS
+P/TizPJhk9H9Z2vXUq6/aKtAQ6BXNVN48FP4YUIHZMbXb5tMOA1jrGKvNouicwoN
+9SG9dKpN6nIDSdvHXx1iY8f93ZHsM+71bbRuMGjeyNYmsHVee7QHIJihdjK4TWxP
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFMmAd+BikoL1Rpzz
+uvdMw964o605MA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAU18h
+9bqwOlI5LJKwbADJ784g7wbylp7ppHR/ehb8t/W2+xUbP6umwHJdELFx7rxP462s
+A20ucS6vxOOto70MEae0/0qyexAQH6dXQbLArvQsWdZHEIjzIVEpMMpghq9Gqx3t
+OluwlN5E40EIosHsHdb9T7bWR9AUC8rmyrV7d35BH16Dx7aMOZawP5aBQW9gkOLo
++fsicdl9sz1Gv7SEr5AcD48Saq/v7h56rgJKihcrdv6sVIkkLE8/trKnToyokZf7
+KcZ7XC25y2a2t6hbElGFtQl+Ynhw/qlqYLYdDnkM/crqJIByw5c/8nerQyIKx+u2
+DISCLIBrQYoIwOula9+ZEsuK1V6ADJHgJgg2SMX6OBE1/yWDLfJ6v9r9jv6ly0Us
+H8SIU653DtmadsWOLB2jutXsMq7Aqqz30XpN69QH4kj3Io6wpJ9qzo6ysmD0oyLQ
+I+uUWnpp3Q+/QFesa1lQ2aOZ4W7+jQF5JyMV3pKdewlNWudLSDBaGOYKbeaP4NK7
+5t98biGCwWg5TbSYWGZizEqQXsP6JwSxeRV0mcy+rSDeJmAc61ZRpqPq5KM/p/9h
+3PFaTWwyI0PurKju7koSCTxdccK+efrCh2gdC/1cacwG0Jp9VJkqyTkaGa9LKkPz
+Y11aWOIv4x3kqdbQCtCev9eBCfHJxyYNrJgWVqA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Subject: CN=Buypass Class 3 Root CA O=Buypass AS-983163327
+# Label: "Buypass Class 3 Root CA"
+# Serial: 2
+# MD5 Fingerprint: 3d:3b:18:9e:2c:64:5a:e8:d5:88:ce:0e:f9:37:c2:ec
+# SHA1 Fingerprint: da:fa:f7:fa:66:84:ec:06:8f:14:50:bd:c7:c2:81:a5:bc:a9:64:57
+# SHA256 Fingerprint: ed:f7:eb:bc:a2:7a:2a:38:4d:38:7b:7d:40:10:c6:66:e2:ed:b4:84:3e:4c:29:b4:ae:1d:5b:93:32:e6:b2:4d
+-----BEGIN CERTIFICATE-----
+MIIFWTCCA0GgAwIBAgIBAjANBgkqhkiG9w0BAQsFADBOMQswCQYDVQQGEwJOTzEd
+MBsGA1UECgwUQnV5cGFzcyBBUy05ODMxNjMzMjcxIDAeBgNVBAMMF0J1eXBhc3Mg
+Q2xhc3MgMyBSb290IENBMB4XDTEwMTAyNjA4Mjg1OFoXDTQwMTAyNjA4Mjg1OFow
+TjELMAkGA1UEBhMCTk8xHTAbBgNVBAoMFEJ1eXBhc3MgQVMtOTgzMTYzMzI3MSAw
+HgYDVQQDDBdCdXlwYXNzIENsYXNzIDMgUm9vdCBDQTCCAiIwDQYJKoZIhvcNAQEB
+BQADggIPADCCAgoCggIBAKXaCpUWUOOV8l6ddjEGMnqb8RB2uACatVI2zSRHsJ8Y
+ZLya9vrVediQYkwiL944PdbgqOkcLNt4EemOaFEVcsfzM4fkoF0LXOBXByow9c3E
+N3coTRiR5r/VUv1xLXA+58bEiuPwKAv0dpihi4dVsjoT/Lc+JzeOIuOoTyrvYLs9
+tznDDgFHmV0ST9tD+leh7fmdvhFHJlsTmKtdFoqwNxxXnUX/iJY2v7vKB3tvh2PX
+0DJq1l1sDPGzbjniazEuOQAnFN44wOwZZoYS6J1yFhNkUsepNxz9gjDthBgd9K5c
+/3ATAOux9TN6S9ZV+AWNS2mw9bMoNlwUxFFzTWsL8TQH2xc519woe2v1n/MuwU8X
+KhDzzMro6/1rqy6any2CbgTUUgGTLT2G/H783+9CHaZr77kgxve9oKeV/afmiSTY
+zIw0bOIjL9kSGiG5VZFvC5F5GQytQIgLcOJ60g7YaEi7ghM5EFjp2CoHxhLbWNvS
+O1UQRwUVZ2J+GGOmRj8JDlQyXr8NYnon74Do29lLBlo3WiXQCBJ31G8JUJc9yB3D
+34xFMFbG02SrZvPAXpacw8Tvw3xrizp5f7NJzz3iiZ+gMEuFuZyUJHmPfWupRWgP
+K9Dx2hzLabjKSWJtyNBjYt1gD1iqj6G8BaVmos8bdrKEZLFMOVLAMLrwjEsCsLa3
+AgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFEe4zf/lb+74suwv
+Tg75JbCOPGvDMA4GA1UdDwEB/wQEAwIBBjANBgkqhkiG9w0BAQsFAAOCAgEAACAj
+QTUEkMJAYmDv4jVM1z+s4jSQuKFvdvoWFqRINyzpkMLyPPgKn9iB5btb2iUspKdV
+cSQy9sgL8rxq+JOssgfCX5/bzMiKqr5qb+FJEMwx14C7u8jYog5kV+qi9cKpMRXS
+IGrs/CIBKM+GuIAeqcwRpTzyFrNHnfzSgCHEy9BHcEGhyoMZCCxt8l13nIoUE9Q2
+HJLw5QY33KbmkJs4j1xrG0aGQ0JfPgEHU1RdZX33inOhmlRaHylDFCfChQ+1iHsa
+O5S3HWCntZznKWlXWpuTekMwGwPXYshApqr8ZORK15FTAaggiG6cX0S5y2CBNOxv
+033aSF/rtJC8LakcC6wc1aJoIIAE1vyxjy+7SjENSoYc6+I2KSb12tjE8nVhz36u
+dmNKekBlk4f4HoCMhuWG1o8O/FMsYOgWYRqiPkN7zTlgVGr18okmAWiDSKIz6MkE
+kbIRNBE+6tBDGR8Dk5AM/1E9V/RBbuHLoL7ryWPNbczk+DaqaJ3tvV2XcEQNtg41
+3OEMXbugUZTLfhbrES+jkkXITHHZvMmZUldGL1DPvTVp9D0VzgalLA8+9oG6lLvD
+u79leNKGef9JOxqDDPDeeOzI8k1MGt6CKfjBWtrt7uYnXuhF0J0cUahoq0Tj0Itq
+4/g7u9xN12TyUb7mqqta6THuBrxzvxNiCp/HuZc=
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 3 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 3"
+# Serial: 1
+# MD5 Fingerprint: ca:fb:40:a8:4e:39:92:8a:1d:fe:8e:2f:c4:27:ea:ef
+# SHA1 Fingerprint: 55:a6:72:3e:cb:f2:ec:cd:c3:23:74:70:19:9d:2a:be:11:e3:81:d1
+# SHA256 Fingerprint: fd:73:da:d3:1c:64:4f:f1:b4:3b:ef:0c:cd:da:96:71:0b:9c:d9:87:5e:ca:7e:31:70:7a:f3:e9:6d:52:2b:bd
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDMwHhcNMDgxMDAxMTAyOTU2WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDMwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC9dZPwYiJvJK7genasfb3ZJNW4t/zN
+8ELg63iIVl6bmlQdTQyK9tPPcPRStdiTBONGhnFBSivwKixVA9ZIw+A5OO3yXDw/
+RLyTPWGrTs0NvvAgJ1gORH8EGoel15YUNpDQSXuhdfsaa3Ox+M6pCSzyU9XDFES4
+hqX2iys52qMzVNn6chr3IhUciJFrf2blw2qAsCTz34ZFiP0Zf3WHHx+xGwpzJFu5
+ZeAsVMhg02YXP+HMVDNzkQI6pn97djmiH5a2OK61yJN0HZ65tOVgnS9W0eDrXltM
+EnAMbEQgqxHY9Bn20pxSN+f6tsIxO0rUFJmtxxr1XV/6B7h8DR/Wgx6zAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS1
+A/d2O2GCahKqGFPrAyGUv/7OyjANBgkqhkiG9w0BAQsFAAOCAQEAVj3vlNW92nOy
+WL6ukK2YJ5f+AbGwUgC4TeQbIXQbfsDuXmkqJa9c1h3a0nnJ85cp4IaH3gRZD/FZ
+1GSFS5mvJQQeyUapl96Cshtwn5z2r3Ex3XsFpSzTucpH9sry9uetuUg/vBa3wW30
+6gmv7PO15wWeph6KU1HWk4HMdJP2udqmJQV0eVp+QD6CSyYRMG7hP0HHRwA11fXT
+91Q+gT3aSWqas+8QPebrb9HIIkfLzM8BMZLZGOMivgkeGj5asuRrDFR6fUNOuIml
+e9eiPZaGzPImNC1qkp2aGtAw4l1OBLBfiyB+d8E9lYLRRpo7PHi4b6HQDWSieB4p
+TpPDpFQUWw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=EE Certification Centre Root CA O=AS Sertifitseerimiskeskus
+# Subject: CN=EE Certification Centre Root CA O=AS Sertifitseerimiskeskus
+# Label: "EE Certification Centre Root CA"
+# Serial: 112324828676200291871926431888494945866
+# MD5 Fingerprint: 43:5e:88:d4:7d:1a:4a:7e:fd:84:2e:52:eb:01:d4:6f
+# SHA1 Fingerprint: c9:a8:b9:e7:55:80:5e:58:e3:53:77:a7:25:eb:af:c3:7b:27:cc:d7
+# SHA256 Fingerprint: 3e:84:ba:43:42:90:85:16:e7:75:73:c0:99:2f:09:79:ca:08:4e:46:85:68:1f:f1:95:cc:ba:8a:22:9b:8a:76
+-----BEGIN CERTIFICATE-----
+MIIEAzCCAuugAwIBAgIQVID5oHPtPwBMyonY43HmSjANBgkqhkiG9w0BAQUFADB1
+MQswCQYDVQQGEwJFRTEiMCAGA1UECgwZQVMgU2VydGlmaXRzZWVyaW1pc2tlc2t1
+czEoMCYGA1UEAwwfRUUgQ2VydGlmaWNhdGlvbiBDZW50cmUgUm9vdCBDQTEYMBYG
+CSqGSIb3DQEJARYJcGtpQHNrLmVlMCIYDzIwMTAxMDMwMTAxMDMwWhgPMjAzMDEy
+MTcyMzU5NTlaMHUxCzAJBgNVBAYTAkVFMSIwIAYDVQQKDBlBUyBTZXJ0aWZpdHNl
+ZXJpbWlza2Vza3VzMSgwJgYDVQQDDB9FRSBDZXJ0aWZpY2F0aW9uIENlbnRyZSBS
+b290IENBMRgwFgYJKoZIhvcNAQkBFglwa2lAc2suZWUwggEiMA0GCSqGSIb3DQEB
+AQUAA4IBDwAwggEKAoIBAQDIIMDs4MVLqwd4lfNE7vsLDP90jmG7sWLqI9iroWUy
+euuOF0+W2Ap7kaJjbMeMTC55v6kF/GlclY1i+blw7cNRfdCT5mzrMEvhvH2/UpvO
+bntl8jixwKIy72KyaOBhU8E2lf/slLo2rpwcpzIP5Xy0xm90/XsY6KxX7QYgSzIw
+WFv9zajmofxwvI6Sc9uXp3whrj3B9UiHbCe9nyV0gVWw93X2PaRka9ZP585ArQ/d
+MtO8ihJTmMmJ+xAdTX7Nfh9WDSFwhfYggx/2uh8Ej+p3iDXE/+pOoYtNP2MbRMNE
+1CV2yreN1x5KZmTNXMWcg+HCCIia7E6j8T4cLNlsHaFLAgMBAAGjgYowgYcwDwYD
+VR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFBLyWj7qVhy/
+zQas8fElyalL1BSZMEUGA1UdJQQ+MDwGCCsGAQUFBwMCBggrBgEFBQcDAQYIKwYB
+BQUHAwMGCCsGAQUFBwMEBggrBgEFBQcDCAYIKwYBBQUHAwkwDQYJKoZIhvcNAQEF
+BQADggEBAHv25MANqhlHt01Xo/6tu7Fq1Q+e2+RjxY6hUFaTlrg4wCQiZrxTFGGV
+v9DHKpY5P30osxBAIWrEr7BSdxjhlthWXePdNl4dp1BUoMUq5KqMlIpPnTX/dqQG
+E5Gion0ARD9V04I8GtVbvFZMIi5GQ4okQC3zErg7cBqklrkar4dBGmoYDQZPxz5u
+uSlNDUmJEYcyW+ZLBMjkXOZ0c5RdFpgTlf7727FE5TpwrDdr5rMzcijJs1eg9gIW
+iAYLtqZLICjU3j2LrTcFU3T+bsy8QxdxXvnFzBqpYe73dgzzcvRyrc9yAjYHR8/v
+GVCJYMzpJJUPwssd8m92kMfMdcGWxZ0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 2009"
+# Serial: 623603
+# MD5 Fingerprint: cd:e0:25:69:8d:47:ac:9c:89:35:90:f7:fd:51:3d:2f
+# SHA1 Fingerprint: 58:e8:ab:b0:36:15:33:fb:80:f7:9b:1b:6d:29:d3:ff:8d:5f:00:f0
+# SHA256 Fingerprint: 49:e7:a4:42:ac:f0:ea:62:87:05:00:54:b5:25:64:b6:50:e4:f4:9e:42:e3:48:d6:aa:38:e0:39:e9:57:b1:c1
+-----BEGIN CERTIFICATE-----
+MIIEMzCCAxugAwIBAgIDCYPzMA0GCSqGSIb3DQEBCwUAME0xCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMMHkQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgMjAwOTAeFw0wOTExMDUwODM1NThaFw0yOTExMDUwODM1NTha
+ME0xCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxJzAlBgNVBAMM
+HkQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgMjAwOTCCASIwDQYJKoZIhvcNAQEB
+BQADggEPADCCAQoCggEBANOySs96R+91myP6Oi/WUEWJNTrGa9v+2wBoqOADER03
+UAifTUpolDWzU9GUY6cgVq/eUXjsKj3zSEhQPgrfRlWLJ23DEE0NkVJD2IfgXU42
+tSHKXzlABF9bfsyjxiupQB7ZNoTWSPOSHjRGICTBpFGOShrvUD9pXRl/RcPHAY9R
+ySPocq60vFYJfxLLHLGvKZAKyVXMD9O0Gu1HNVpK7ZxzBCHQqr0ME7UAyiZsxGsM
+lFqVlNpQmvH/pStmMaTJOKDfHR+4CS7zp+hnUquVH+BGPtikw8paxTGA6Eian5Rp
+/hnd2HN8gcqW3o7tszIFZYQ05ub9VxC1X3a/L7AQDcUCAwEAAaOCARowggEWMA8G
+A1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFP3aFMSfMN4hvR5COfyrYyNJ4PGEMA4G
+A1UdDwEB/wQEAwIBBjCB0wYDVR0fBIHLMIHIMIGAoH6gfIZ6bGRhcDovL2RpcmVj
+dG9yeS5kLXRydXN0Lm5ldC9DTj1ELVRSVVNUJTIwUm9vdCUyMENsYXNzJTIwMyUy
+MENBJTIwMiUyMDIwMDksTz1ELVRydXN0JTIwR21iSCxDPURFP2NlcnRpZmljYXRl
+cmV2b2NhdGlvbmxpc3QwQ6BBoD+GPWh0dHA6Ly93d3cuZC10cnVzdC5uZXQvY3Js
+L2QtdHJ1c3Rfcm9vdF9jbGFzc18zX2NhXzJfMjAwOS5jcmwwDQYJKoZIhvcNAQEL
+BQADggEBAH+X2zDI36ScfSF6gHDOFBJpiBSVYEQBrLLpME+bUMJm2H6NMLVwMeni
+acfzcNsgFYbQDfC+rAF1hM5+n02/t2A7nPPKHeJeaNijnZflQGDSNiH+0LS4F9p0
+o3/U37CYAqxva2ssJSRyoWXuJVrl5jLn8t+rSfrzkGkj2wTZ51xY/GXUl77M/C4K
+zCUqNQT4YJEVdT1B/yMfGchs64JTBKbkTCJNjYy6zltz7GRUUG3RnFX7acM2w4y8
+PIWmawomDeCTmGCufsYkl4phX5GOZpIJhzbNi5stPvZR1FDUWSi9g/LMKHtThm3Y
+Johw1+qRzT65ysCQblrGXnRl11z+o+I=
+-----END CERTIFICATE-----
+
+# Issuer: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Subject: CN=D-TRUST Root Class 3 CA 2 EV 2009 O=D-Trust GmbH
+# Label: "D-TRUST Root Class 3 CA 2 EV 2009"
+# Serial: 623604
+# MD5 Fingerprint: aa:c6:43:2c:5e:2d:cd:c4:34:c0:50:4f:11:02:4f:b6
+# SHA1 Fingerprint: 96:c9:1b:0b:95:b4:10:98:42:fa:d0:d8:22:79:fe:60:fa:b9:16:83
+# SHA256 Fingerprint: ee:c5:49:6b:98:8c:e9:86:25:b9:34:09:2e:ec:29:08:be:d0:b0:f3:16:c2:d4:73:0c:84:ea:f1:f3:d3:48:81
+-----BEGIN CERTIFICATE-----
+MIIEQzCCAyugAwIBAgIDCYP0MA0GCSqGSIb3DQEBCwUAMFAxCzAJBgNVBAYTAkRF
+MRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNVBAMMIUQtVFJVU1QgUm9vdCBD
+bGFzcyAzIENBIDIgRVYgMjAwOTAeFw0wOTExMDUwODUwNDZaFw0yOTExMDUwODUw
+NDZaMFAxCzAJBgNVBAYTAkRFMRUwEwYDVQQKDAxELVRydXN0IEdtYkgxKjAoBgNV
+BAMMIUQtVFJVU1QgUm9vdCBDbGFzcyAzIENBIDIgRVYgMjAwOTCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAJnxhDRwui+3MKCOvXwEz75ivJn9gpfSegpn
+ljgJ9hBOlSJzmY3aFS3nBfwZcyK3jpgAvDw9rKFs+9Z5JUut8Mxk2og+KbgPCdM0
+3TP1YtHhzRnp7hhPTFiu4h7WDFsVWtg6uMQYZB7jM7K1iXdODL/ZlGsTl28So/6Z
+qQTMFexgaDbtCHu39b+T7WYxg4zGcTSHThfqr4uRjRxWQa4iN1438h3Z0S0NL2lR
+p75mpoo6Kr3HGrHhFPC+Oh25z1uxav60sUYgovseO3Dvk5h9jHOW8sXvhXCtKSb8
+HgQ+HKDYD8tSg2J87otTlZCpV6LqYQXY+U3EJ/pure3511H3a6UCAwEAAaOCASQw
+ggEgMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFNOUikxiEyoZLsyvcop9Ntea
+HNxnMA4GA1UdDwEB/wQEAwIBBjCB3QYDVR0fBIHVMIHSMIGHoIGEoIGBhn9sZGFw
+Oi8vZGlyZWN0b3J5LmQtdHJ1c3QubmV0L0NOPUQtVFJVU1QlMjBSb290JTIwQ2xh
+c3MlMjAzJTIwQ0ElMjAyJTIwRVYlMjAyMDA5LE89RC1UcnVzdCUyMEdtYkgsQz1E
+RT9jZXJ0aWZpY2F0ZXJldm9jYXRpb25saXN0MEagRKBChkBodHRwOi8vd3d3LmQt
+dHJ1c3QubmV0L2NybC9kLXRydXN0X3Jvb3RfY2xhc3NfM19jYV8yX2V2XzIwMDku
+Y3JsMA0GCSqGSIb3DQEBCwUAA4IBAQA07XtaPKSUiO8aEXUHL7P+PPoeUSbrh/Yp
+3uDx1MYkCenBz1UbtDDZzhr+BlGmFaQt77JLvyAoJUnRpjZ3NOhk31KxEcdzes05
+nsKtjHEh8lprr988TlWvsoRlFIm5d8sqMb7Po23Pb0iUMkZv53GMoKaEGTcH8gNF
+CSuGdXzfX2lXANtu2KZyIktQ1HWYVt+3GP9DQ1CuekR78HlR10M9p9OB0/DJT7na
+xpeG0ILD5EJt/rDiZE4OJudANCa1CInXCGNjOCd1HjPqbqjdn5lPdE2BiYBL3ZqX
+KVwvvoFBuYz/6n1gBp7N1z3TLqMVvKjmJuVvw9y4AyHqnxbxLFS1
+-----END CERTIFICATE-----
+
+# Issuer: CN=CA Disig Root R2 O=Disig a.s.
+# Subject: CN=CA Disig Root R2 O=Disig a.s.
+# Label: "CA Disig Root R2"
+# Serial: 10572350602393338211
+# MD5 Fingerprint: 26:01:fb:d8:27:a7:17:9a:45:54:38:1a:43:01:3b:03
+# SHA1 Fingerprint: b5:61:eb:ea:a4:de:e4:25:4b:69:1a:98:a5:57:47:c2:34:c7:d9:71
+# SHA256 Fingerprint: e2:3d:4a:03:6d:7b:70:e9:f5:95:b1:42:20:79:d2:b9:1e:df:bb:1f:b6:51:a0:63:3e:aa:8a:9d:c5:f8:07:03
+-----BEGIN CERTIFICATE-----
+MIIFaTCCA1GgAwIBAgIJAJK4iNuwisFjMA0GCSqGSIb3DQEBCwUAMFIxCzAJBgNV
+BAYTAlNLMRMwEQYDVQQHEwpCcmF0aXNsYXZhMRMwEQYDVQQKEwpEaXNpZyBhLnMu
+MRkwFwYDVQQDExBDQSBEaXNpZyBSb290IFIyMB4XDTEyMDcxOTA5MTUzMFoXDTQy
+MDcxOTA5MTUzMFowUjELMAkGA1UEBhMCU0sxEzARBgNVBAcTCkJyYXRpc2xhdmEx
+EzARBgNVBAoTCkRpc2lnIGEucy4xGTAXBgNVBAMTEENBIERpc2lnIFJvb3QgUjIw
+ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCio8QACdaFXS1tFPbCw3Oe
+NcJxVX6B+6tGUODBfEl45qt5WDza/3wcn9iXAng+a0EE6UG9vgMsRfYvZNSrXaNH
+PWSb6WiaxswbP7q+sos0Ai6YVRn8jG+qX9pMzk0DIaPY0jSTVpbLTAwAFjxfGs3I
+x2ymrdMxp7zo5eFm1tL7A7RBZckQrg4FY8aAamkw/dLukO8NJ9+flXP04SXabBbe
+QTg06ov80egEFGEtQX6sx3dOy1FU+16SGBsEWmjGycT6txOgmLcRK7fWV8x8nhfR
+yyX+hk4kLlYMeE2eARKmK6cBZW58Yh2EhN/qwGu1pSqVg8NTEQxzHQuyRpDRQjrO
+QG6Vrf/GlK1ul4SOfW+eioANSW1z4nuSHsPzwfPrLgVv2RvPN3YEyLRa5Beny912
+H9AZdugsBbPWnDTYltxhh5EF5EQIM8HauQhl1K6yNg3ruji6DOWbnuuNZt2Zz9aJ
+QfYEkoopKW1rOhzndX0CcQ7zwOe9yxndnWCywmZgtrEE7snmhrmaZkCo5xHtgUUD
+i/ZnWejBBhG93c+AAk9lQHhcR1DIm+YfgXvkRKhbhZri3lrVx/k6RGZL5DJUfORs
+nLMOPReisjQS1n6yqEm70XooQL6iFh/f5DcfEXP7kAplQ6INfPgGAVUzfbANuPT1
+rqVCV3w2EYx7XsQDnYx5nQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1Ud
+DwEB/wQEAwIBBjAdBgNVHQ4EFgQUtZn4r7CU9eMg1gqtzk5WpC5uQu0wDQYJKoZI
+hvcNAQELBQADggIBACYGXnDnZTPIgm7ZnBc6G3pmsgH2eDtpXi/q/075KMOYKmFM
+tCQSin1tERT3nLXK5ryeJ45MGcipvXrA1zYObYVybqjGom32+nNjf7xueQgcnYqf
+GopTpti72TVVsRHFqQOzVju5hJMiXn7B9hJSi+osZ7z+Nkz1uM/Rs0mSO9MpDpkb
+lvdhuDvEK7Z4bLQjb/D907JedR+Zlais9trhxTF7+9FGs9K8Z7RiVLoJ92Owk6Ka
++elSLotgEqv89WBW7xBci8QaQtyDW2QOy7W81k/BfDxujRNt+3vrMNDcTa/F1bal
+TFtxyegxvug4BkihGuLq0t4SOVga/4AOgnXmt8kHbA7v/zjxmHHEt38OFdAlab0i
+nSvtBfZGR6ztwPDUO+Ls7pZbkBNOHlY667DvlruWIxG68kOGdGSVyCh13x01utI3
+gzhTODY7z2zp+WsO0PsE6E9312UBeIYMej4hYvF/Y3EMyZ9E26gnonW+boE+18Dr
+G5gPcFw0sorMwIUY6256s/daoQe/qUKS82Ail+QUoQebTnbAjn39pCXHR+3/H3Os
+zMOl6W8KjptlwlCFtaOgUxLMVYdh84GuEEZhvUQhuMI9dM9+JDX6HAcOmz0iyu8x
+L4ysEr3vQCj8KWefshNPZiTEUxnpHikV7+ZtsH8tZ/3zbBt1RqPlShfppNcL
+-----END CERTIFICATE-----
+
+# Issuer: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Subject: CN=ACCVRAIZ1 O=ACCV OU=PKIACCV
+# Label: "ACCVRAIZ1"
+# Serial: 6828503384748696800
+# MD5 Fingerprint: d0:a0:5a:ee:05:b6:09:94:21:a1:7d:f1:b2:29:82:02
+# SHA1 Fingerprint: 93:05:7a:88:15:c6:4f:ce:88:2f:fa:91:16:52:28:78:bc:53:64:17
+# SHA256 Fingerprint: 9a:6e:c0:12:e1:a7:da:9d:be:34:19:4d:47:8a:d7:c0:db:18:22:fb:07:1d:f1:29:81:49:6e:d1:04:38:41:13
+-----BEGIN CERTIFICATE-----
+MIIH0zCCBbugAwIBAgIIXsO3pkN/pOAwDQYJKoZIhvcNAQEFBQAwQjESMBAGA1UE
+AwwJQUNDVlJBSVoxMRAwDgYDVQQLDAdQS0lBQ0NWMQ0wCwYDVQQKDARBQ0NWMQsw
+CQYDVQQGEwJFUzAeFw0xMTA1MDUwOTM3MzdaFw0zMDEyMzEwOTM3MzdaMEIxEjAQ
+BgNVBAMMCUFDQ1ZSQUlaMTEQMA4GA1UECwwHUEtJQUNDVjENMAsGA1UECgwEQUND
+VjELMAkGA1UEBhMCRVMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCb
+qau/YUqXry+XZpp0X9DZlv3P4uRm7x8fRzPCRKPfmt4ftVTdFXxpNRFvu8gMjmoY
+HtiP2Ra8EEg2XPBjs5BaXCQ316PWywlxufEBcoSwfdtNgM3802/J+Nq2DoLSRYWo
+G2ioPej0RGy9ocLLA76MPhMAhN9KSMDjIgro6TenGEyxCQ0jVn8ETdkXhBilyNpA
+lHPrzg5XPAOBOp0KoVdDaaxXbXmQeOW1tDvYvEyNKKGno6e6Ak4l0Squ7a4DIrhr
+IA8wKFSVf+DuzgpmndFALW4ir50awQUZ0m/A8p/4e7MCQvtQqR0tkw8jq8bBD5L/
+0KIV9VMJcRz/RROE5iZe+OCIHAr8Fraocwa48GOEAqDGWuzndN9wrqODJerWx5eH
+k6fGioozl2A3ED6XPm4pFdahD9GILBKfb6qkxkLrQaLjlUPTAYVtjrs78yM2x/47
+4KElB0iryYl0/wiPgL/AlmXz7uxLaL2diMMxs0Dx6M/2OLuc5NF/1OVYm3z61PMO
+m3WR5LpSLhl+0fXNWhn8ugb2+1KoS5kE3fj5tItQo05iifCHJPqDQsGH+tUtKSpa
+cXpkatcnYGMN285J9Y0fkIkyF/hzQ7jSWpOGYdbhdQrqeWZ2iE9x6wQl1gpaepPl
+uUsXQA+xtrn13k/c4LOsOxFwYIRKQ26ZIMApcQrAZQIDAQABo4ICyzCCAscwfQYI
+KwYBBQUHAQEEcTBvMEwGCCsGAQUFBzAChkBodHRwOi8vd3d3LmFjY3YuZXMvZmls
+ZWFkbWluL0FyY2hpdm9zL2NlcnRpZmljYWRvcy9yYWl6YWNjdjEuY3J0MB8GCCsG
+AQUFBzABhhNodHRwOi8vb2NzcC5hY2N2LmVzMB0GA1UdDgQWBBTSh7Tj3zcnk1X2
+VuqB5TbMjB4/vTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNKHtOPfNyeT
+VfZW6oHlNsyMHj+9MIIBcwYDVR0gBIIBajCCAWYwggFiBgRVHSAAMIIBWDCCASIG
+CCsGAQUFBwICMIIBFB6CARAAQQB1AHQAbwByAGkAZABhAGQAIABkAGUAIABDAGUA
+cgB0AGkAZgBpAGMAYQBjAGkA8wBuACAAUgBhAO0AegAgAGQAZQAgAGwAYQAgAEEA
+QwBDAFYAIAAoAEEAZwBlAG4AYwBpAGEAIABkAGUAIABUAGUAYwBuAG8AbABvAGcA
+7QBhACAAeQAgAEMAZQByAHQAaQBmAGkAYwBhAGMAaQDzAG4AIABFAGwAZQBjAHQA
+cgDzAG4AaQBjAGEALAAgAEMASQBGACAAUQA0ADYAMAAxADEANQA2AEUAKQAuACAA
+QwBQAFMAIABlAG4AIABoAHQAdABwADoALwAvAHcAdwB3AC4AYQBjAGMAdgAuAGUA
+czAwBggrBgEFBQcCARYkaHR0cDovL3d3dy5hY2N2LmVzL2xlZ2lzbGFjaW9uX2Mu
+aHRtMFUGA1UdHwROMEwwSqBIoEaGRGh0dHA6Ly93d3cuYWNjdi5lcy9maWxlYWRt
+aW4vQXJjaGl2b3MvY2VydGlmaWNhZG9zL3JhaXphY2N2MV9kZXIuY3JsMA4GA1Ud
+DwEB/wQEAwIBBjAXBgNVHREEEDAOgQxhY2N2QGFjY3YuZXMwDQYJKoZIhvcNAQEF
+BQADggIBAJcxAp/n/UNnSEQU5CmH7UwoZtCPNdpNYbdKl02125DgBS4OxnnQ8pdp
+D70ER9m+27Up2pvZrqmZ1dM8MJP1jaGo/AaNRPTKFpV8M9xii6g3+CfYCS0b78gU
+JyCpZET/LtZ1qmxNYEAZSUNUY9rizLpm5U9EelvZaoErQNV/+QEnWCzI7UiRfD+m
+AM/EKXMRNt6GGT6d7hmKG9Ww7Y49nCrADdg9ZuM8Db3VlFzi4qc1GwQA9j9ajepD
+vV+JHanBsMyZ4k0ACtrJJ1vnE5Bc5PUzolVt3OAJTS+xJlsndQAJxGJ3KQhfnlms
+tn6tn1QwIgPBHnFk/vk4CpYY3QIUrCPLBhwepH2NDd4nQeit2hW3sCPdK6jT2iWH
+7ehVRE2I9DZ+hJp4rPcOVkkO1jMl1oRQQmwgEh0q1b688nCBpHBgvgW1m54ERL5h
+I6zppSSMEYCUWqKiuUnSwdzRp+0xESyeGabu4VXhwOrPDYTkF7eifKXeVSUG7szA
+h1xA2syVP1XgNce4hL60Xc16gwFy7ofmXx2utYXGJt/mwZrpHgJHnyqobalbz+xF
+d3+YJ5oyXSrjhO7FmGYvliAd3djDJ9ew+f7Zfc3Qn48LFFhRny+Lwzgt3uiP1o2H
+pPVWQxaZLPSkVrQ0uGE3ycJYgBugl6H8WY3pEfbRD0tVNEYqi4Y7
+-----END CERTIFICATE-----
+
+# Issuer: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Subject: CN=TWCA Global Root CA O=TAIWAN-CA OU=Root CA
+# Label: "TWCA Global Root CA"
+# Serial: 3262
+# MD5 Fingerprint: f9:03:7e:cf:e6:9e:3c:73:7a:2a:90:07:69:ff:2b:96
+# SHA1 Fingerprint: 9c:bb:48:53:f6:a4:f6:d3:52:a4:e8:32:52:55:60:13:f5:ad:af:65
+# SHA256 Fingerprint: 59:76:90:07:f7:68:5d:0f:cd:50:87:2f:9f:95:d5:75:5a:5b:2b:45:7d:81:f3:69:2b:61:0a:98:67:2f:0e:1b
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgICDL4wDQYJKoZIhvcNAQELBQAwUTELMAkGA1UEBhMCVFcx
+EjAQBgNVBAoTCVRBSVdBTi1DQTEQMA4GA1UECxMHUm9vdCBDQTEcMBoGA1UEAxMT
+VFdDQSBHbG9iYWwgUm9vdCBDQTAeFw0xMjA2MjcwNjI4MzNaFw0zMDEyMzExNTU5
+NTlaMFExCzAJBgNVBAYTAlRXMRIwEAYDVQQKEwlUQUlXQU4tQ0ExEDAOBgNVBAsT
+B1Jvb3QgQ0ExHDAaBgNVBAMTE1RXQ0EgR2xvYmFsIFJvb3QgQ0EwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCwBdvI64zEbooh745NnHEKH1Jw7W2CnJfF
+10xORUnLQEK1EjRsGcJ0pDFfhQKX7EMzClPSnIyOt7h52yvVavKOZsTuKwEHktSz
+0ALfUPZVr2YOy+BHYC8rMjk1Ujoog/h7FsYYuGLWRyWRzvAZEk2tY/XTP3VfKfCh
+MBwqoJimFb3u/Rk28OKRQ4/6ytYQJ0lM793B8YVwm8rqqFpD/G2Gb3PpN0Wp8DbH
+zIh1HrtsBv+baz4X7GGqcXzGHaL3SekVtTzWoWH1EfcFbx39Eb7QMAfCKbAJTibc
+46KokWofwpFFiFzlmLhxpRUZyXx1EcxwdE8tmx2RRP1WKKD+u4ZqyPpcC1jcxkt2
+yKsi2XMPpfRaAok/T54igu6idFMqPVMnaR1sjjIsZAAmY2E2TqNGtz99sy2sbZCi
+laLOz9qC5wc0GZbpuCGqKX6mOL6OKUohZnkfs8O1CWfe1tQHRvMq2uYiN2DLgbYP
+oA/pyJV/v1WRBXrPPRXAb94JlAGD1zQbzECl8LibZ9WYkTunhHiVJqRaCPgrdLQA
+BDzfuBSO6N+pjWxnkjMdwLfS7JLIvgm/LCkFbwJrnu+8vyq8W8BQj0FwcYeyTbcE
+qYSjMq+u7msXi7Kx/mzhkIyIqJdIzshNy/MGz19qCkKxHh53L46g5pIOBvwFItIm
+4TFRfTLcDwIDAQABoyMwITAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zANBgkqhkiG9w0BAQsFAAOCAgEAXzSBdu+WHdXltdkCY4QWwa6gcFGn90xHNcgL
+1yg9iXHZqjNB6hQbbCEAwGxCGX6faVsgQt+i0trEfJdLjbDorMjupWkEmQqSpqsn
+LhpNgb+E1HAerUf+/UqdM+DyucRFCCEK2mlpc3INvjT+lIutwx4116KD7+U4x6WF
+H6vPNOw/KP4M8VeGTslV9xzU2KV9Bnpv1d8Q34FOIWWxtuEXeZVFBs5fzNxGiWNo
+RI2T9GRwoD2dKAXDOXC4Ynsg/eTb6QihuJ49CcdP+yz4k3ZB3lLg4VfSnQO8d57+
+nile98FRYB/e2guyLXW3Q0iT5/Z5xoRdgFlglPx4mI88k1HtQJAH32RjJMtOcQWh
+15QaiDLxInQirqWm2BJpTGCjAu4r7NRjkgtevi92a6O2JryPA9gK8kxkRr05YuWW
+6zRjESjMlfGt7+/cgFhI6Uu46mWs6fyAtbXIRfmswZ/ZuepiiI7E8UuDEq3mi4TW
+nsLrgxifarsbJGAzcMzs9zLzXNl5fe+epP7JI8Mk7hWSsT2RTyaGvWZzJBPqpK5j
+wa19hAM8EHiGG3njxPPyBJUgriOCxLM6AGK/5jYk4Ve6xx6QddVfP5VhK8E7zeWz
+aGHQRiapIVJpLesux+t3zqY6tQMzT3bR51xUAV3LePTJDL/PEo4XLSNolOer/qmy
+KwbQBM0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Subject: CN=TeliaSonera Root CA v1 O=TeliaSonera
+# Label: "TeliaSonera Root CA v1"
+# Serial: 199041966741090107964904287217786801558
+# MD5 Fingerprint: 37:41:49:1b:18:56:9a:26:f5:ad:c2:66:fb:40:a5:4c
+# SHA1 Fingerprint: 43:13:bb:96:f1:d5:86:9b:c1:4e:6a:92:f6:cf:f6:34:69:87:82:37
+# SHA256 Fingerprint: dd:69:36:fe:21:f8:f0:77:c1:23:a1:a5:21:c1:22:24:f7:22:55:b7:3e:03:a7:26:06:93:e8:a2:4b:0f:a3:89
+-----BEGIN CERTIFICATE-----
+MIIFODCCAyCgAwIBAgIRAJW+FqD3LkbxezmCcvqLzZYwDQYJKoZIhvcNAQEFBQAw
+NzEUMBIGA1UECgwLVGVsaWFTb25lcmExHzAdBgNVBAMMFlRlbGlhU29uZXJhIFJv
+b3QgQ0EgdjEwHhcNMDcxMDE4MTIwMDUwWhcNMzIxMDE4MTIwMDUwWjA3MRQwEgYD
+VQQKDAtUZWxpYVNvbmVyYTEfMB0GA1UEAwwWVGVsaWFTb25lcmEgUm9vdCBDQSB2
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMK+6yfwIaPzaSZVfp3F
+VRaRXP3vIb9TgHot0pGMYzHw7CTww6XScnwQbfQ3t+XmfHnqjLWCi65ItqwA3GV1
+7CpNX8GH9SBlK4GoRz6JI5UwFpB/6FcHSOcZrr9FZ7E3GwYq/t75rH2D+1665I+X
+Z75Ljo1kB1c4VWk0Nj0TSO9P4tNmHqTPGrdeNjPUtAa9GAH9d4RQAEX1jF3oI7x+
+/jXh7VB7qTCNGdMJjmhnXb88lxhTuylixcpecsHHltTbLaC0H2kD7OriUPEMPPCs
+81Mt8Bz17Ww5OXOAFshSsCPN4D7c3TxHoLs1iuKYaIu+5b9y7tL6pe0S7fyYGKkm
+dtwoSxAgHNN/Fnct7W+A90m7UwW7XWjH1Mh1Fj+JWov3F0fUTPHSiXk+TT2YqGHe
+Oh7S+F4D4MHJHIzTjU3TlTazN19jY5szFPAtJmtTfImMMsJu7D0hADnJoWjiUIMu
+sDor8zagrC/kb2HCUQk5PotTubtn2txTuXZZNp1D5SDgPTJghSJRt8czu90VL6R4
+pgd7gUY2BIbdeTXHlSw7sKMXNeVzH7RcWe/a6hBle3rQf5+ztCo3O3CLm1u5K7fs
+slESl1MpWtTwEhDcTwK7EpIvYtQ/aUN8Ddb8WHUBiJ1YFkveupD/RwGJBmr2X7KQ
+arMCpgKIv7NHfirZ1fpoeDVNAgMBAAGjPzA9MA8GA1UdEwEB/wQFMAMBAf8wCwYD
+VR0PBAQDAgEGMB0GA1UdDgQWBBTwj1k4ALP1j5qWDNXr+nuqF+gTEjANBgkqhkiG
+9w0BAQUFAAOCAgEAvuRcYk4k9AwI//DTDGjkk0kiP0Qnb7tt3oNmzqjMDfz1mgbl
+dxSR651Be5kqhOX//CHBXfDkH1e3damhXwIm/9fH907eT/j3HEbAek9ALCI18Bmx
+0GtnLLCo4MBANzX2hFxc469CeP6nyQ1Q6g2EdvZR74NTxnr/DlZJLo961gzmJ1Tj
+TQpgcmLNkQfWpb/ImWvtxBnmq0wROMVvMeJuScg/doAmAyYp4Db29iBT4xdwNBed
+Y2gea+zDTYa4EzAvXUYNR0PVG6pZDrlcjQZIrXSHX8f8MVRBE+LHIQ6e4B4N4cB7
+Q4WQxYpYxmUKeFfyxiMPAdkgS94P+5KFdSpcc41teyWRyu5FrgZLAMzTsVlQ2jqI
+OylDRl6XK1TOU2+NSueW+r9xDkKLfP0ooNBIytrEgUy7onOTJsjrDNYmiLbAJM+7
+vVvrdX3pCI6GMyx5dwlppYn8s3CQh3aP0yK7Qs69cwsgJirQmz1wHiRszYd2qReW
+t88NkvuOGKmYSdGe/mBEciG5Ge3C9THxOUiIkCR1VBatzvT4aRRkOfujuLpwQMcn
+HL/EVlP6Y2XQ8xwOFvVrhlhNGNTkDY6lnVuR3HYkUD/GKvvZt5y11ubQ2egZixVx
+SK236thZiNSQvxaz2emsWWFUyBy6ysHK4bkgTI86k4mloMy/0/Z1pHWWbVY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
+# Subject: CN=E-Tugra Certification Authority O=E-Tu\u011fra EBG Bili\u015fim Teknolojileri ve Hizmetleri A.\u015e. OU=E-Tugra Sertifikasyon Merkezi
+# Label: "E-Tugra Certification Authority"
+# Serial: 7667447206703254355
+# MD5 Fingerprint: b8:a1:03:63:b0:bd:21:71:70:8a:6f:13:3a:bb:79:49
+# SHA1 Fingerprint: 51:c6:e7:08:49:06:6e:f3:92:d4:5c:a0:0d:6d:a3:62:8f:c3:52:39
+# SHA256 Fingerprint: b0:bf:d5:2b:b0:d7:d9:bd:92:bf:5d:4d:c1:3d:a2:55:c0:2c:54:2f:37:83:65:ea:89:39:11:f5:5e:55:f2:3c
+-----BEGIN CERTIFICATE-----
+MIIGSzCCBDOgAwIBAgIIamg+nFGby1MwDQYJKoZIhvcNAQELBQAwgbIxCzAJBgNV
+BAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+BgNVBAoMN0UtVHXEn3JhIEVCRyBC
+aWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhpem1ldGxlcmkgQS7Fni4xJjAkBgNV
+BAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBNZXJrZXppMSgwJgYDVQQDDB9FLVR1
+Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MB4XDTEzMDMwNTEyMDk0OFoXDTIz
+MDMwMzEyMDk0OFowgbIxCzAJBgNVBAYTAlRSMQ8wDQYDVQQHDAZBbmthcmExQDA+
+BgNVBAoMN0UtVHXEn3JhIEVCRyBCaWxpxZ9pbSBUZWtub2xvamlsZXJpIHZlIEhp
+em1ldGxlcmkgQS7Fni4xJjAkBgNVBAsMHUUtVHVncmEgU2VydGlmaWthc3lvbiBN
+ZXJrZXppMSgwJgYDVQQDDB9FLVR1Z3JhIENlcnRpZmljYXRpb24gQXV0aG9yaXR5
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA4vU/kwVRHoViVF56C/UY
+B4Oufq9899SKa6VjQzm5S/fDxmSJPZQuVIBSOTkHS0vdhQd2h8y/L5VMzH2nPbxH
+D5hw+IyFHnSOkm0bQNGZDbt1bsipa5rAhDGvykPL6ys06I+XawGb1Q5KCKpbknSF
+Q9OArqGIW66z6l7LFpp3RMih9lRozt6Plyu6W0ACDGQXwLWTzeHxE2bODHnv0ZEo
+q1+gElIwcxmOj+GMB6LDu0rw6h8VqO4lzKRG+Bsi77MOQ7osJLjFLFzUHPhdZL3D
+k14opz8n8Y4e0ypQBaNV2cvnOVPAmJ6MVGKLJrD3fY185MaeZkJVgkfnsliNZvcH
+fC425lAcP9tDJMW/hkd5s3kc91r0E+xs+D/iWR+V7kI+ua2oMoVJl0b+SzGPWsut
+dEcf6ZG33ygEIqDUD13ieU/qbIWGvaimzuT6w+Gzrt48Ue7LE3wBf4QOXVGUnhMM
+ti6lTPk5cDZvlsouDERVxcr6XQKj39ZkjFqzAQqptQpHF//vkUAqjqFGOjGY5RH8
+zLtJVor8udBhmm9lbObDyz51Sf6Pp+KJxWfXnUYTTjF2OySznhFlhqt/7x3U+Lzn
+rFpct1pHXFXOVbQicVtbC/DP3KBhZOqp12gKY6fgDT+gr9Oq0n7vUaDmUStVkhUX
+U8u3Zg5mTPj5dUyQ5xJwx0UCAwEAAaNjMGEwHQYDVR0OBBYEFC7j27JJ0JxUeVz6
+Jyr+zE7S6E5UMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAULuPbsknQnFR5
+XPonKv7MTtLoTlQwDgYDVR0PAQH/BAQDAgEGMA0GCSqGSIb3DQEBCwUAA4ICAQAF
+Nzr0TbdF4kV1JI+2d1LoHNgQk2Xz8lkGpD4eKexd0dCrfOAKkEh47U6YA5n+KGCR
+HTAduGN8qOY1tfrTYXbm1gdLymmasoR6d5NFFxWfJNCYExL/u6Au/U5Mh/jOXKqY
+GwXgAEZKgoClM4so3O0409/lPun++1ndYYRP0lSWE2ETPo+Aab6TR7U1Q9Jauz1c
+77NCR807VRMGsAnb/WP2OogKmW9+4c4bU2pEZiNRCHu8W1Ki/QY3OEBhj0qWuJA3
++GbHeJAAFS6LrVE1Uweoa2iu+U48BybNCAVwzDk/dr2l02cmAYamU9JgO3xDf1WK
+vJUawSg5TB9D0pH0clmKuVb8P7Sd2nCcdlqMQ1DujjByTd//SffGqWfZbawCEeI6
+FiWnWAjLb1NBnEg4R2gz0dfHj9R0IdTDBZB6/86WiLEVKV0jq9BgoRJP3vQXzTLl
+yb/IQ639Lo7xr+L0mPoSHyDYwKcMhcWQ9DstliaxLL5Mq+ux0orJ23gTDx4JnW2P
+AJ8C2sH6H3p6CcRK5ogql5+Ji/03X186zjhZhkuvcQu02PJwT58yE+Owp1fl2tpD
+y4Q08ijE6m30Ku/Ba3ba+367hTzSU8JNvnHhRdH9I2cNE3X7z2VnIp2usAnRCf8d
+NL/+I5c30jn6PQ0GC7TbO6Orb1wdtn7os4I07QZcJA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Subject: CN=T-TeleSec GlobalRoot Class 2 O=T-Systems Enterprise Services GmbH OU=T-Systems Trust Center
+# Label: "T-TeleSec GlobalRoot Class 2"
+# Serial: 1
+# MD5 Fingerprint: 2b:9b:9e:e4:7b:6c:1f:00:72:1a:cc:c1:77:79:df:6a
+# SHA1 Fingerprint: 59:0d:2d:7d:88:4f:40:2e:61:7e:a5:62:32:17:65:cf:17:d8:94:e9
+# SHA256 Fingerprint: 91:e2:f5:78:8d:58:10:eb:a7:ba:58:73:7d:e1:54:8a:8e:ca:cd:01:45:98:bc:0b:14:3e:04:1b:17:05:25:52
+-----BEGIN CERTIFICATE-----
+MIIDwzCCAqugAwIBAgIBATANBgkqhkiG9w0BAQsFADCBgjELMAkGA1UEBhMCREUx
+KzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnByaXNlIFNlcnZpY2VzIEdtYkgxHzAd
+BgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50ZXIxJTAjBgNVBAMMHFQtVGVsZVNl
+YyBHbG9iYWxSb290IENsYXNzIDIwHhcNMDgxMDAxMTA0MDE0WhcNMzMxMDAxMjM1
+OTU5WjCBgjELMAkGA1UEBhMCREUxKzApBgNVBAoMIlQtU3lzdGVtcyBFbnRlcnBy
+aXNlIFNlcnZpY2VzIEdtYkgxHzAdBgNVBAsMFlQtU3lzdGVtcyBUcnVzdCBDZW50
+ZXIxJTAjBgNVBAMMHFQtVGVsZVNlYyBHbG9iYWxSb290IENsYXNzIDIwggEiMA0G
+CSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCqX9obX+hzkeXaXPSi5kfl82hVYAUd
+AqSzm1nzHoqvNK38DcLZSBnuaY/JIPwhqgcZ7bBcrGXHX+0CfHt8LRvWurmAwhiC
+FoT6ZrAIxlQjgeTNuUk/9k9uN0goOA/FvudocP05l03Sx5iRUKrERLMjfTlH6VJi
+1hKTXrcxlkIF+3anHqP1wvzpesVsqXFP6st4vGCvx9702cu+fjOlbpSD8DT6Iavq
+jnKgP6TeMFvvhk1qlVtDRKgQFRzlAVfFmPHmBiiRqiDFt1MmUUOyCxGVWOHAD3bZ
+wI18gfNycJ5v/hqO2V81xrJvNHy+SE/iWjnX2J14np+GPgNeGYtEotXHAgMBAAGj
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBS/
+WSA2AHmgoCJrjNXyYdK4LMuCSjANBgkqhkiG9w0BAQsFAAOCAQEAMQOiYQsfdOhy
+NsZt+U2e+iKo4YFWz827n+qrkRk4r6p8FU3ztqONpfSO9kSpp+ghla0+AGIWiPAC
+uvxhI+YzmzB6azZie60EI4RYZeLbK4rnJVM3YlNfvNoBYimipidx5joifsFvHZVw
+IEoHNN/q/xWA5brXethbdXwFeilHfkCoMRN3zUA7tFFHei4R40cR3p1m0IvVVGb6
+g1XqfMIpiRvpb7PO4gWEyS8+eIVibslfwXhjdFjASBgMmTnrpMwatXlajRWc2BQN
+9noHV8cigwUtPJslJj0Ys6lDfMjIq2SPDqO/nBudMNva0Bkuqjzx+zOAduTNrRlP
+BSeOE6Fuwg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Atos TrustedRoot 2011 O=Atos
+# Subject: CN=Atos TrustedRoot 2011 O=Atos
+# Label: "Atos TrustedRoot 2011"
+# Serial: 6643877497813316402
+# MD5 Fingerprint: ae:b9:c4:32:4b:ac:7f:5d:66:cc:77:94:bb:2a:77:56
+# SHA1 Fingerprint: 2b:b1:f5:3e:55:0c:1d:c5:f1:d4:e6:b7:6a:46:4b:55:06:02:ac:21
+# SHA256 Fingerprint: f3:56:be:a2:44:b7:a9:1e:b3:5d:53:ca:9a:d7:86:4a:ce:01:8e:2d:35:d5:f8:f9:6d:df:68:a6:f4:1a:a4:74
+-----BEGIN CERTIFICATE-----
+MIIDdzCCAl+gAwIBAgIIXDPLYixfszIwDQYJKoZIhvcNAQELBQAwPDEeMBwGA1UE
+AwwVQXRvcyBUcnVzdGVkUm9vdCAyMDExMQ0wCwYDVQQKDARBdG9zMQswCQYDVQQG
+EwJERTAeFw0xMTA3MDcxNDU4MzBaFw0zMDEyMzEyMzU5NTlaMDwxHjAcBgNVBAMM
+FUF0b3MgVHJ1c3RlZFJvb3QgMjAxMTENMAsGA1UECgwEQXRvczELMAkGA1UEBhMC
+REUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQCVhTuXbyo7LjvPpvMp
+Nb7PGKw+qtn4TaA+Gke5vJrf8v7MPkfoepbCJI419KkM/IL9bcFyYie96mvr54rM
+VD6QUM+A1JX76LWC1BTFtqlVJVfbsVD2sGBkWXppzwO3bw2+yj5vdHLqqjAqc2K+
+SZFhyBH+DgMq92og3AIVDV4VavzjgsG1xZ1kCWyjWZgHJ8cblithdHFsQ/H3NYkQ
+4J7sVaE3IqKHBAUsR320HLliKWYoyrfhk/WklAOZuXCFteZI6o1Q/NnezG8HDt0L
+cp2AMBYHlT8oDv3FdU9T1nSatCQujgKRz3bFmx5VdJx4IbHwLfELn8LVlhgf8FQi
+eowHAgMBAAGjfTB7MB0GA1UdDgQWBBSnpQaxLKYJYO7Rl+lwrrw7GWzbITAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFKelBrEspglg7tGX6XCuvDsZbNshMBgG
+A1UdIAQRMA8wDQYLKwYBBAGwLQMEAQEwDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3
+DQEBCwUAA4IBAQAmdzTblEiGKkGdLD4GkGDEjKwLVLgfuXvTBznk+j57sj1O7Z8j
+vZfza1zv7v1Apt+hk6EKhqzvINB5Ab149xnYJDE0BAGmuhWawyfc2E8PzBhj/5kP
+DpFrdRbhIfzYJsdHt6bPWHJxfrrhTZVHO8mvbaG0weyJ9rQPOLXiZNwlz6bb65pc
+maHFCN795trV1lpFDMS3wrUU77QR/w4VtfX128a961qn8FYiqTxlVMYVqL2Gns2D
+lmh6cYGJ4Qvh6hEbaAjMaZ7snkGeRDImeuKHCnE96+RapNLbxc3G3mB/ufNPRJLv
+KrcYPqcZ2Qt9sTdBQrC6YB3y/gkRsPCHe6ed
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 1 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 1 G3"
+# Serial: 687049649626669250736271037606554624078720034195
+# MD5 Fingerprint: a4:bc:5b:3f:fe:37:9a:fa:64:f0:e2:fa:05:3d:0b:ab
+# SHA1 Fingerprint: 1b:8e:ea:57:96:29:1a:c9:39:ea:b8:0a:81:1a:73:73:c0:93:79:67
+# SHA256 Fingerprint: 8a:86:6f:d1:b2:76:b5:7e:57:8e:92:1c:65:82:8a:2b:ed:58:e9:f2:f2:88:05:41:34:b7:f1:f4:bf:c9:cc:74
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIUeFhfLq0sGUvjNwc1NBMotZbUZZMwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMSBHMzAeFw0xMjAxMTIxNzI3NDRaFw00
+MjAxMTIxNzI3NDRaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDEgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCgvlAQjunybEC0BJyFuTHK3C3kEakEPBtV
+wedYMB0ktMPvhd6MLOHBPd+C5k+tR4ds7FtJwUrVu4/sh6x/gpqG7D0DmVIB0jWe
+rNrwU8lmPNSsAgHaJNM7qAJGr6Qc4/hzWHa39g6QDbXwz8z6+cZM5cOGMAqNF341
+68Xfuw6cwI2H44g4hWf6Pser4BOcBRiYz5P1sZK0/CPTz9XEJ0ngnjybCKOLXSoh
+4Pw5qlPafX7PGglTvF0FBM+hSo+LdoINofjSxxR3W5A2B4GbPgb6Ul5jxaYA/qXp
+UhtStZI5cgMJYr2wYBZupt0lwgNm3fME0UDiTouG9G/lg6AnhF4EwfWQvTA9xO+o
+abw4m6SkltFi2mnAAZauy8RRNOoMqv8hjlmPSlzkYZqn0ukqeI1RPToV7qJZjqlc
+3sX5kCLliEVx3ZGZbHqfPT2YfF72vhZooF6uCyP8Wg+qInYtyaEQHeTTRCOQiJ/G
+KubX9ZqzWB4vMIkIG1SitZgj7Ah3HJVdYdHLiZxfokqRmu8hqkkWCKi9YSgxyXSt
+hfbZxbGL0eUQMk1fiyA6PEkfM4VZDdvLCXVDaXP7a3F98N/ETH3Goy7IlXnLc6KO
+Tk0k+17kBL5yG6YnLUlamXrXXAkgt3+UuU/xDRxeiEIbEbfnkduebPRq34wGmAOt
+zCjvpUfzUwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUo5fW816iEOGrRZ88F2Q87gFwnMwwDQYJKoZIhvcNAQELBQAD
+ggIBABj6W3X8PnrHX3fHyt/PX8MSxEBd1DKquGrX1RUVRpgjpeaQWxiZTOOtQqOC
+MTaIzen7xASWSIsBx40Bz1szBpZGZnQdT+3Btrm0DWHMY37XLneMlhwqI2hrhVd2
+cDMT/uFPpiN3GPoajOi9ZcnPP/TJF9zrx7zABC4tRi9pZsMbj/7sPtPKlL92CiUN
+qXsCHKnQO18LwIE6PWThv6ctTr1NxNgpxiIY0MWscgKCP6o6ojoilzHdCGPDdRS5
+YCgtW2jgFqlmgiNR9etT2DGbe+m3nUvriBbP+V04ikkwj+3x6xn0dxoxGE1nVGwv
+b2X52z3sIexe9PSLymBlVNFxZPT5pqOBMzYzcfCkeF9OrYMh3jRJjehZrJ3ydlo2
+8hP0r+AJx2EqbPfgna67hkooby7utHnNkDPDs3b69fBsnQGQ+p6Q9pxyz0fawx/k
+NSBT8lTR32GDpgLiJTjehTItXnOQUl1CxM49S+H5GYQd1aJQzEH7QRTDvdbJWqNj
+ZgKAvQU6O0ec7AAmTPWIUb+oI38YB7AL7YsmoWTTYUrrXJ/es69nA7Mf3W1daWhp
+q1467HxpvMc7hU6eFbm0FU/DlXpY18ls6Wy58yljXrQs8C097Vpl4KlbQMJImYFt
+nh8GKjwStIsPm6Ik8KaN1nrgS7ZklmOVhMJKzRwuJIczYOXD
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 2 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 2 G3"
+# Serial: 390156079458959257446133169266079962026824725800
+# MD5 Fingerprint: af:0c:86:6e:bf:40:2d:7f:0b:3e:12:50:ba:12:3d:06
+# SHA1 Fingerprint: 09:3c:61:f3:8b:8b:dc:7d:55:df:75:38:02:05:00:e1:25:f5:c8:36
+# SHA256 Fingerprint: 8f:e4:fb:0a:f9:3a:4d:0d:67:db:0b:eb:b2:3e:37:c7:1b:f3:25:dc:bc:dd:24:0e:a0:4d:af:58:b4:7e:18:40
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIURFc0JFuBiZs18s64KztbpybwdSgwDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMiBHMzAeFw0xMjAxMTIxODU5MzJaFw00
+MjAxMTIxODU5MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDIgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQChriWyARjcV4g/Ruv5r+LrI3HimtFhZiFf
+qq8nUeVuGxbULX1QsFN3vXg6YOJkApt8hpvWGo6t/x8Vf9WVHhLL5hSEBMHfNrMW
+n4rjyduYNM7YMxcoRvynyfDStNVNCXJJ+fKH46nafaF9a7I6JaltUkSs+L5u+9ym
+c5GQYaYDFCDy54ejiK2toIz/pgslUiXnFgHVy7g1gQyjO/Dh4fxaXc6AcW34Sas+
+O7q414AB+6XrW7PFXmAqMaCvN+ggOp+oMiwMzAkd056OXbxMmO7FGmh77FOm6RQ1
+o9/NgJ8MSPsc9PG/Srj61YxxSscfrf5BmrODXfKEVu+lV0POKa2Mq1W/xPtbAd0j
+IaFYAI7D0GoT7RPjEiuA3GfmlbLNHiJuKvhB1PLKFAeNilUSxmn1uIZoL1NesNKq
+IcGY5jDjZ1XHm26sGahVpkUG0CM62+tlXSoREfA7T8pt9DTEceT/AFr2XK4jYIVz
+8eQQsSWu1ZK7E8EM4DnatDlXtas1qnIhO4M15zHfeiFuuDIIfR0ykRVKYnLP43eh
+vNURG3YBZwjgQQvD6xVu+KQZ2aKrr+InUlYrAoosFCT5v0ICvybIxo/gbjh9Uy3l
+7ZizlWNof/k19N+IxWA1ksB8aRxhlRbQ694Lrz4EEEVlWFA4r0jyWbYW8jwNkALG
+cC4BrTwV1wIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQU7edvdlq/YOxJW8ald7tyFnGbxD0wDQYJKoZIhvcNAQELBQAD
+ggIBAJHfgD9DCX5xwvfrs4iP4VGyvD11+ShdyLyZm3tdquXK4Qr36LLTn91nMX66
+AarHakE7kNQIXLJgapDwyM4DYvmL7ftuKtwGTTwpD4kWilhMSA/ohGHqPHKmd+RC
+roijQ1h5fq7KpVMNqT1wvSAZYaRsOPxDMuHBR//47PERIjKWnML2W2mWeyAMQ0Ga
+W/ZZGYjeVYg3UQt4XAoeo0L9x52ID8DyeAIkVJOviYeIyUqAHerQbj5hLja7NQ4n
+lv1mNDthcnPxFlxHBlRJAHpYErAK74X9sbgzdWqTHBLmYF5vHX/JHyPLhGGfHoJE
++V+tYlUkmlKY7VHnoX6XOuYvHxHaU4AshZ6rNRDbIl9qxV6XU/IyAgkwo1jwDQHV
+csaxfGl7w/U2Rcxhbl5MlMVerugOXou/983g7aEOGzPuVBj+D77vfoRrQ+NwmNtd
+dbINWQeFFSM51vHfqSYP1kjHs6Yi9TM3WpVHn3u6GBVv/9YUZINJ0gpnIdsPNWNg
+KCLjsZWDzYWm3S8P52dSbrsvhXz1SnPnxT7AvSESBT/8twNJAlvIJebiVDj1eYeM
+HVOyToV7BjjHLPj4sHKNJeV3UvQDHEimUF+IIDBu8oJDqz2XhOdT+yHBTw8imoa4
+WSr2Rz0ZiC3oheGe7IUIarFsNMkd7EgrO3jtZsSOeWmD3n+M
+-----END CERTIFICATE-----
+
+# Issuer: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Subject: CN=QuoVadis Root CA 3 G3 O=QuoVadis Limited
+# Label: "QuoVadis Root CA 3 G3"
+# Serial: 268090761170461462463995952157327242137089239581
+# MD5 Fingerprint: df:7d:b9:ad:54:6f:68:a1:df:89:57:03:97:43:b0:d7
+# SHA1 Fingerprint: 48:12:bd:92:3c:a8:c4:39:06:e7:30:6d:27:96:e6:a4:cf:22:2e:7d
+# SHA256 Fingerprint: 88:ef:81:de:20:2e:b0:18:45:2e:43:f8:64:72:5c:ea:5f:bd:1f:c2:d9:d2:05:73:07:09:c5:d8:b8:69:0f:46
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIULvWbAiin23r/1aOp7r0DoM8Sah0wDQYJKoZIhvcNAQEL
+BQAwSDELMAkGA1UEBhMCQk0xGTAXBgNVBAoTEFF1b1ZhZGlzIExpbWl0ZWQxHjAc
+BgNVBAMTFVF1b1ZhZGlzIFJvb3QgQ0EgMyBHMzAeFw0xMjAxMTIyMDI2MzJaFw00
+MjAxMTIyMDI2MzJaMEgxCzAJBgNVBAYTAkJNMRkwFwYDVQQKExBRdW9WYWRpcyBM
+aW1pdGVkMR4wHAYDVQQDExVRdW9WYWRpcyBSb290IENBIDMgRzMwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCzyw4QZ47qFJenMioKVjZ/aEzHs286IxSR
+/xl/pcqs7rN2nXrpixurazHb+gtTTK/FpRp5PIpM/6zfJd5O2YIyC0TeytuMrKNu
+FoM7pmRLMon7FhY4futD4tN0SsJiCnMK3UmzV9KwCoWdcTzeo8vAMvMBOSBDGzXR
+U7Ox7sWTaYI+FrUoRqHe6okJ7UO4BUaKhvVZR74bbwEhELn9qdIoyhA5CcoTNs+c
+ra1AdHkrAj80//ogaX3T7mH1urPnMNA3I4ZyYUUpSFlob3emLoG+B01vr87ERROR
+FHAGjx+f+IdpsQ7vw4kZ6+ocYfx6bIrc1gMLnia6Et3UVDmrJqMz6nWB2i3ND0/k
+A9HvFZcba5DFApCTZgIhsUfei5pKgLlVj7WiL8DWM2fafsSntARE60f75li59wzw
+eyuxwHApw0BiLTtIadwjPEjrewl5qW3aqDCYz4ByA4imW0aucnl8CAMhZa634Ryl
+sSqiMd5mBPfAdOhx3v89WcyWJhKLhZVXGqtrdQtEPREoPHtht+KPZ0/l7DxMYIBp
+VzgeAVuNVejH38DMdyM0SXV89pgR6y3e7UEuFAUCf+D+IOs15xGsIs5XPd7JMG0Q
+A4XN8f+MFrXBsj6IbGB/kE+V9/YtrQE5BwT6dYB9v0lQ7e/JxHwc64B+27bQ3RP+
+ydOc17KXqQIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+BjAdBgNVHQ4EFgQUxhfQvKjqAkPyGwaZXSuQILnXnOQwDQYJKoZIhvcNAQELBQAD
+ggIBADRh2Va1EodVTd2jNTFGu6QHcrxfYWLopfsLN7E8trP6KZ1/AvWkyaiTt3px
+KGmPc+FSkNrVvjrlt3ZqVoAh313m6Tqe5T72omnHKgqwGEfcIHB9UqM+WXzBusnI
+FUBhynLWcKzSt/Ac5IYp8M7vaGPQtSCKFWGafoaYtMnCdvvMujAWzKNhxnQT5Wvv
+oxXqA/4Ti2Tk08HS6IT7SdEQTXlm66r99I0xHnAUrdzeZxNMgRVhvLfZkXdxGYFg
+u/BYpbWcC/ePIlUnwEsBbTuZDdQdm2NnL9DuDcpmvJRPpq3t/O5jrFc/ZSXPsoaP
+0Aj/uHYUbt7lJ+yreLVTubY/6CD50qi+YUbKh4yE8/nxoGibIh6BJpsQBJFxwAYf
+3KDTuVan45gtf4Od34wrnDKOMpTwATwiKp9Dwi7DmDkHOHv8XgBCH/MyJnmDhPbl
+8MFREsALHgQjDFSlTC9JxUrRtm5gDWv8a4uFJGS3iQ6rJUdbPM9+Sb3H6QrG2vd+
+DhcI00iX0HGS8A85PjRqHH3Y8iKuu2n0M7SmSFXRDw4m6Oy2Cy2nhTXN/VnIn9HN
+PlopNLk9hM6xZdRZkZFWdSHBd575euFgndOtBBj0fOtek49TSiIp+EgrPk2GrFt/
+ywaZWWDYWGWVjUTR939+J399roD1B0y2PpxxVJkES/1Y+Zj0
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G2"
+# Serial: 15385348160840213938643033620894905419
+# MD5 Fingerprint: 92:38:b9:f8:63:24:82:65:2c:57:33:e6:fe:81:8f:9d
+# SHA1 Fingerprint: a1:4b:48:d9:43:ee:0a:0e:40:90:4f:3c:e0:a4:c0:91:93:51:5d:3f
+# SHA256 Fingerprint: 7d:05:eb:b6:82:33:9f:8c:94:51:ee:09:4e:eb:fe:fa:79:53:a1:14:ed:b2:f4:49:49:45:2f:ab:7d:2f:c1:85
+-----BEGIN CERTIFICATE-----
+MIIDljCCAn6gAwIBAgIQC5McOtY5Z+pnI7/Dr5r0SzANBgkqhkiG9w0BAQsFADBl
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJv
+b3QgRzIwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQG
+EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl
+cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzIwggEi
+MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDZ5ygvUj82ckmIkzTz+GoeMVSA
+n61UQbVH35ao1K+ALbkKz3X9iaV9JPrjIgwrvJUXCzO/GU1BBpAAvQxNEP4Htecc
+biJVMWWXvdMX0h5i89vqbFCMP4QMls+3ywPgym2hFEwbid3tALBSfK+RbLE4E9Hp
+EgjAALAcKxHad3A2m67OeYfcgnDmCXRwVWmvo2ifv922ebPynXApVfSr/5Vh88lA
+bx3RvpO704gqu52/clpWcTs/1PPRCv4o76Pu2ZmvA9OPYLfykqGxvYmJHzDNw6Yu
+YjOuFgJ3RFrngQo8p0Quebg/BLxcoIfhG69Rjs3sLPr4/m3wOnyqi+RnlTGNAgMB
+AAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQW
+BBTOw0q5mVXyuNtgv6l+vVa1lzan1jANBgkqhkiG9w0BAQsFAAOCAQEAyqVVjOPI
+QW5pJ6d1Ee88hjZv0p3GeDgdaZaikmkuOGybfQTUiaWxMTeKySHMq2zNixya1r9I
+0jJmwYrA8y8678Dj1JGG0VDjA9tzd29KOVPt3ibHtX2vK0LRdWLjSisCx1BL4Gni
+lmwORGYQRI+tBev4eaymG+g3NJ1TyWGqolKvSnAWhsI6yLETcDbYz+70CjTVW0z9
+B5yiutkBclzzTcHdDrEcDcRjvq30FPuJ7KJBDkzMyFdA0G4Dqs0MjomZmWzwPDCv
+ON9vvKO+KSAnq3T/EyJ43pdSVR6DtVQgA+6uwE9W3jfMw3+qBCe703e4YtsXfJwo
+IhNzbM8m9Yop5w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Assured ID Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Assured ID Root G3"
+# Serial: 15459312981008553731928384953135426796
+# MD5 Fingerprint: 7c:7f:65:31:0c:81:df:8d:ba:3e:99:e2:5c:ad:6e:fb
+# SHA1 Fingerprint: f5:17:a2:4f:9a:48:c6:c9:f8:a2:00:26:9f:dc:0f:48:2c:ab:30:89
+# SHA256 Fingerprint: 7e:37:cb:8b:4c:47:09:0c:ab:36:55:1b:a6:f4:5d:b8:40:68:0f:ba:16:6a:95:2d:b1:00:71:7f:43:05:3f:c2
+-----BEGIN CERTIFICATE-----
+MIICRjCCAc2gAwIBAgIQC6Fa+h3foLVJRK/NJKBs7DAKBggqhkjOPQQDAzBlMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3Qg
+RzMwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBlMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgRzMwdjAQBgcq
+hkjOPQIBBgUrgQQAIgNiAAQZ57ysRGXtzbg/WPuNsVepRC0FFfLvC/8QdJ+1YlJf
+Zn4f5dwbRXkLzMZTCp2NXQLZqVneAlr2lSoOjThKiknGvMYDOAdfVdp+CW7if17Q
+RSAPWXYQ1qAk8C3eNvJsKTmjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/
+BAQDAgGGMB0GA1UdDgQWBBTL0L2p4ZgFUaFNN6KDec6NHSrkhDAKBggqhkjOPQQD
+AwNnADBkAjAlpIFFAmsSS3V0T8gj43DydXLefInwz5FyYZ5eEJJZVrmDxxDnOOlY
+JjZ91eQ0hjkCMHw2U/Aw5WJjOpnitqM7mzT6HtoQknFekROn3aRukswy1vUhZscv
+6pZjamVFkpUBtA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G2 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G2"
+# Serial: 4293743540046975378534879503202253541
+# MD5 Fingerprint: e4:a6:8a:c8:54:ac:52:42:46:0a:fd:72:48:1b:2a:44
+# SHA1 Fingerprint: df:3c:24:f9:bf:d6:66:76:1b:26:80:73:fe:06:d1:cc:8d:4f:82:a4
+# SHA256 Fingerprint: cb:3c:cb:b7:60:31:e5:e0:13:8f:8d:d3:9a:23:f9:de:47:ff:c3:5e:43:c1:14:4c:ea:27:d4:6a:5a:b1:cb:5f
+-----BEGIN CERTIFICATE-----
+MIIDjjCCAnagAwIBAgIQAzrx5qcRqaC7KGSxHQn65TANBgkqhkiG9w0BAQsFADBh
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBH
+MjAeFw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVT
+MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
+b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEcyMIIBIjANBgkqhkiG
+9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuzfNNNx7a8myaJCtSnX/RrohCgiN9RlUyfuI
+2/Ou8jqJkTx65qsGGmvPrC3oXgkkRLpimn7Wo6h+4FR1IAWsULecYxpsMNzaHxmx
+1x7e/dfgy5SDN67sH0NO3Xss0r0upS/kqbitOtSZpLYl6ZtrAGCSYP9PIUkY92eQ
+q2EGnI/yuum06ZIya7XzV+hdG82MHauVBJVJ8zUtluNJbd134/tJS7SsVQepj5Wz
+tCO7TG1F8PapspUwtP1MVYwnSlcUfIKdzXOS0xZKBgyMUNGPHgm+F6HmIcr9g+UQ
+vIOlCsRnKPZzFBQ9RnbDhxSJITRNrw9FDKZJobq7nMWxM4MphQIDAQABo0IwQDAP
+BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQUTiJUIBiV
+5uNu5g/6+rkS7QYXjzkwDQYJKoZIhvcNAQELBQADggEBAGBnKJRvDkhj6zHd6mcY
+1Yl9PMWLSn/pvtsrF9+wX3N3KjITOYFnQoQj8kVnNeyIv/iPsGEMNKSuIEyExtv4
+NeF22d+mQrvHRAiGfzZ0JFrabA0UWTW98kndth/Jsw1HKj2ZL7tcu7XUIOGZX1NG
+Fdtom/DzMNU+MeKNhJ7jitralj41E6Vf8PlwUHBHQRFXGU7Aj64GxJUTFy8bJZ91
+8rGOmaFvE7FBcf6IKshPECBV1/MUReXgRPTqh5Uykw7+U0b6LJ3/iyK5S9kJRaTe
+pLiaWN0bfVKfjllDiIGknibVb63dDcY3fe0Dkhvld1927jyNxF1WW6LZZm6zNTfl
+MrY=
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Global Root G3 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Global Root G3"
+# Serial: 7089244469030293291760083333884364146
+# MD5 Fingerprint: f5:5d:a4:50:a5:fb:28:7e:1e:0f:0d:cc:96:57:56:ca
+# SHA1 Fingerprint: 7e:04:de:89:6a:3e:66:6d:00:e6:87:d3:3f:fa:d9:3b:e8:3d:34:9e
+# SHA256 Fingerprint: 31:ad:66:48:f8:10:41:38:c7:38:f3:9e:a4:32:01:33:39:3e:3a:18:cc:02:29:6e:f9:7c:2a:c9:ef:67:31:d0
+-----BEGIN CERTIFICATE-----
+MIICPzCCAcWgAwIBAgIQBVVWvPJepDU1w6QP1atFcjAKBggqhkjOPQQDAzBhMQsw
+CQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cu
+ZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBHMzAe
+Fw0xMzA4MDExMjAwMDBaFw0zODAxMTUxMjAwMDBaMGExCzAJBgNVBAYTAlVTMRUw
+EwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20x
+IDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IEczMHYwEAYHKoZIzj0CAQYF
+K4EEACIDYgAE3afZu4q4C/sLfyHS8L6+c/MzXRq8NOrexpu80JX28MzQC7phW1FG
+fp4tn+6OYwwX7Adw9c+ELkCDnOg/QW07rdOkFFk2eJ0DQ+4QE2xy3q6Ip6FrtUPO
+Z9wj/wMco+I+o0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAd
+BgNVHQ4EFgQUs9tIpPmhxdiuNkHMEWNpYim8S8YwCgYIKoZIzj0EAwMDaAAwZQIx
+AK288mw/EkrRLTnDCgmXc/SINoyIJ7vmiI1Qhadj+Z4y3maTD/HMsQmP3Wyr+mt/
+oAIwOWZbwmSNuJ5Q3KjVSaLtx9zRSX8XAbjIho9OjIgrqJqpisXRAL34VOKa5Vt8
+sycX
+-----END CERTIFICATE-----
+
+# Issuer: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Subject: CN=DigiCert Trusted Root G4 O=DigiCert Inc OU=www.digicert.com
+# Label: "DigiCert Trusted Root G4"
+# Serial: 7451500558977370777930084869016614236
+# MD5 Fingerprint: 78:f2:fc:aa:60:1f:2f:b4:eb:c9:37:ba:53:2e:75:49
+# SHA1 Fingerprint: dd:fb:16:cd:49:31:c9:73:a2:03:7d:3f:c8:3a:4d:7d:77:5d:05:e4
+# SHA256 Fingerprint: 55:2f:7b:dc:f1:a7:af:9e:6c:e6:72:01:7f:4f:12:ab:f7:72:40:c7:8e:76:1a:c2:03:d1:d9:d2:0a:c8:99:88
+-----BEGIN CERTIFICATE-----
+MIIFkDCCA3igAwIBAgIQBZsbV56OITLiOQe9p3d1XDANBgkqhkiG9w0BAQwFADBi
+MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
+d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg
+RzQwHhcNMTMwODAxMTIwMDAwWhcNMzgwMTE1MTIwMDAwWjBiMQswCQYDVQQGEwJV
+UzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQu
+Y29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3y
+ithZwuEppz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1If
+xp4VpX6+n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDV
+ySAdYyktzuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiO
+DCu3T6cw2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQ
+jdjUN6QuBX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/
+CNdaSaTC5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCi
+EhtmmnTK3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADM
+fRyVw4/3IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QY
+uKZ3AeEPlAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXK
+chYiCd98THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t
+9dmpsh3lGwIDAQABo0IwQDAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIB
+hjAdBgNVHQ4EFgQU7NfjgtJxXWRM3y5nP+e6mK4cD08wDQYJKoZIhvcNAQEMBQAD
+ggIBALth2X2pbL4XxJEbw6GiAI3jZGgPVs93rnD5/ZpKmbnJeFwMDF/k5hQpVgs2
+SV1EY+CtnJYYZhsjDT156W1r1lT40jzBQ0CuHVD1UvyQO7uYmWlrx8GnqGikJ9yd
++SeuMIW59mdNOj6PWTkiU0TryF0Dyu1Qen1iIQqAyHNm0aAFYF/opbSnr6j3bTWc
+fFqK1qI4mfN4i/RN0iAL3gTujJtHgXINwBQy7zBZLq7gcfJW5GqXb5JQbZaNaHqa
+sjYUegbyJLkJEVDXCLG4iXqEI2FCKeWjzaIgQdfRnGTZ6iahixTXTBmyUEFxPT9N
+cCOGDErcgdLMMpSEDQgJlxxPwO5rIHQw0uA5NBCFIRUBCOhVMt5xSdkoF1BN5r5N
+0XWs0Mr7QbhDparTwwVETyw2m+L64kW4I1NsBm9nVX9GtUw/bihaeSbSpKhil9Ie
+4u1Ki7wb/UdKDd9nZn6yW0HQO+T0O/QEY+nvwlQAUaCKKsnOeMzV6ocEGLPOr0mI
+r/OSmbaz5mEP0oUA51Aa5BuVnRmhuZyxm7EAHu/QD09CbMkKvO5D+jpxpchNJqU1
+/YldvIViHTLSoCtU7ZpXwdv6EM8Zt4tKG48BtieVU+i2iW1bvGjUI+iLUaJW+fCm
+gKDWHrO8Dw9TdSmq6hN35N6MgSGtBxBHEa2HPQfRdbzP82Z+
+-----END CERTIFICATE-----
+
+# Issuer: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Subject: CN=COMODO RSA Certification Authority O=COMODO CA Limited
+# Label: "COMODO RSA Certification Authority"
+# Serial: 101909084537582093308941363524873193117
+# MD5 Fingerprint: 1b:31:b0:71:40:36:cc:14:36:91:ad:c4:3e:fd:ec:18
+# SHA1 Fingerprint: af:e5:d2:44:a8:d1:19:42:30:ff:47:9f:e2:f8:97:bb:cd:7a:8c:b4
+# SHA256 Fingerprint: 52:f0:e1:c4:e5:8e:c6:29:29:1b:60:31:7f:07:46:71:b8:5d:7e:a8:0d:5b:07:27:34:63:53:4b:32:b4:02:34
+-----BEGIN CERTIFICATE-----
+MIIF2DCCA8CgAwIBAgIQTKr5yttjb+Af907YWwOGnTANBgkqhkiG9w0BAQwFADCB
+hTELMAkGA1UEBhMCR0IxGzAZBgNVBAgTEkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4G
+A1UEBxMHU2FsZm9yZDEaMBgGA1UEChMRQ09NT0RPIENBIExpbWl0ZWQxKzApBgNV
+BAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMTE5
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBhTELMAkGA1UEBhMCR0IxGzAZBgNVBAgT
+EkdyZWF0ZXIgTWFuY2hlc3RlcjEQMA4GA1UEBxMHU2FsZm9yZDEaMBgGA1UEChMR
+Q09NT0RPIENBIExpbWl0ZWQxKzApBgNVBAMTIkNPTU9ETyBSU0EgQ2VydGlmaWNh
+dGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCR
+6FSS0gpWsawNJN3Fz0RndJkrN6N9I3AAcbxT38T6KhKPS38QVr2fcHK3YX/JSw8X
+pz3jsARh7v8Rl8f0hj4K+j5c+ZPmNHrZFGvnnLOFoIJ6dq9xkNfs/Q36nGz637CC
+9BR++b7Epi9Pf5l/tfxnQ3K9DADWietrLNPtj5gcFKt+5eNu/Nio5JIk2kNrYrhV
+/erBvGy2i/MOjZrkm2xpmfh4SDBF1a3hDTxFYPwyllEnvGfDyi62a+pGx8cgoLEf
+Zd5ICLqkTqnyg0Y3hOvozIFIQ2dOciqbXL1MGyiKXCJ7tKuY2e7gUYPDCUZObT6Z
++pUX2nwzV0E8jVHtC7ZcryxjGt9XyD+86V3Em69FmeKjWiS0uqlWPc9vqv9JWL7w
+qP/0uK3pN/u6uPQLOvnoQ0IeidiEyxPx2bvhiWC4jChWrBQdnArncevPDt09qZah
+SL0896+1DSJMwBGB7FY79tOi4lu3sgQiUpWAk2nojkxl8ZEDLXB0AuqLZxUpaVIC
+u9ffUGpVRr+goyhhf3DQw6KqLCGqR84onAZFdr+CGCe01a60y1Dma/RMhnEw6abf
+Fobg2P9A3fvQQoh/ozM6LlweQRGBY84YcWsr7KaKtzFcOmpH4MN5WdYgGq/yapiq
+crxXStJLnbsQ/LBMQeXtHT1eKJ2czL+zUdqnR+WEUwIDAQABo0IwQDAdBgNVHQ4E
+FgQUu69+Aj36pvE8hI6t7jiY7NkyMtQwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB
+/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAArx1UaEt65Ru2yyTUEUAJNMnMvl
+wFTPoCWOAvn9sKIN9SCYPBMtrFaisNZ+EZLpLrqeLppysb0ZRGxhNaKatBYSaVqM
+4dc+pBroLwP0rmEdEBsqpIt6xf4FpuHA1sj+nq6PK7o9mfjYcwlYRm6mnPTXJ9OV
+2jeDchzTc+CiR5kDOF3VSXkAKRzH7JsgHAckaVd4sjn8OoSgtZx8jb8uk2Intzna
+FxiuvTwJaP+EmzzV1gsD41eeFPfR60/IvYcjt7ZJQ3mFXLrrkguhxuhoqEwWsRqZ
+CuhTLJK7oQkYdQxlqHvLI7cawiiFwxv/0Cti76R7CZGYZ4wUAc1oBmpjIXUDgIiK
+boHGhfKppC3n9KUkEEeDys30jXlYsQab5xoq2Z0B15R97QNKyvDb6KkBPvVWmcke
+jkk9u+UJueBPSZI9FoJAzMxZxuY67RIuaTxslbH9qh17f4a+Hg4yRvv7E491f0yL
+S0Zj/gA0QHDBw7mh3aZw4gSzQbzpgJHqZJx64SIDqZxubw5lT2yHh17zbqD5daWb
+QOhTsiedSrnAdyGN/4fy3ryM7xfft0kL0fJuMAsaDk527RH89elWsn2/x20Kk4yl
+0MC2Hb46TpSi125sC8KKfPog88Tk5c0NqMuRkrF8hey1FGlmDoLnzc7ILaZRfyHB
+NVOFBkpdn627G190
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust RSA Certification Authority O=The USERTRUST Network
+# Label: "USERTrust RSA Certification Authority"
+# Serial: 2645093764781058787591871645665788717
+# MD5 Fingerprint: 1b:fe:69:d1:91:b7:19:33:a3:72:a8:0f:e1:55:e5:b5
+# SHA1 Fingerprint: 2b:8f:1b:57:33:0d:bb:a2:d0:7a:6c:51:f7:0e:e9:0d:da:b9:ad:8e
+# SHA256 Fingerprint: e7:93:c9:b0:2f:d8:aa:13:e2:1c:31:22:8a:cc:b0:81:19:64:3b:74:9c:89:89:64:b1:74:6d:46:c3:d4:cb:d2
+-----BEGIN CERTIFICATE-----
+MIIF3jCCA8agAwIBAgIQAf1tMPyjylGoG7xkDjUDLTANBgkqhkiG9w0BAQwFADCB
+iDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0pl
+cnNleSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNV
+BAMTJVVTRVJUcnVzdCBSU0EgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAw
+MjAxMDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNV
+BAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVU
+aGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBSU0EgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCAEmUXNg7D2wiz0KxXDXbtzSfTTK1Qg2HiqiBNCS1kCdzOiZ/MPans9s/B
+3PHTsdZ7NygRK0faOca8Ohm0X6a9fZ2jY0K2dvKpOyuR+OJv0OwWIJAJPuLodMkY
+tJHUYmTbf6MG8YgYapAiPLz+E/CHFHv25B+O1ORRxhFnRghRy4YUVD+8M/5+bJz/
+Fp0YvVGONaanZshyZ9shZrHUm3gDwFA66Mzw3LyeTP6vBZY1H1dat//O+T23LLb2
+VN3I5xI6Ta5MirdcmrS3ID3KfyI0rn47aGYBROcBTkZTmzNg95S+UzeQc0PzMsNT
+79uq/nROacdrjGCT3sTHDN/hMq7MkztReJVni+49Vv4M0GkPGw/zJSZrM233bkf6
+c0Plfg6lZrEpfDKEY1WJxA3Bk1QwGROs0303p+tdOmw1XNtB1xLaqUkL39iAigmT
+Yo61Zs8liM2EuLE/pDkP2QKe6xJMlXzzawWpXhaDzLhn4ugTncxbgtNMs+1b/97l
+c6wjOy0AvzVVdAlJ2ElYGn+SNuZRkg7zJn0cTRe8yexDJtC/QV9AqURE9JnnV4ee
+UB9XVKg+/XRjL7FQZQnmWEIuQxpMtPAlR1n6BB6T1CZGSlCBst6+eLf8ZxXhyVeE
+Hg9j1uliutZfVS7qXMYoCAQlObgOK6nyTJccBz8NUvXt7y+CDwIDAQABo0IwQDAd
+BgNVHQ4EFgQUU3m/WqorSs9UgOHYm8Cd8rIDZsswDgYDVR0PAQH/BAQDAgEGMA8G
+A1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEMBQADggIBAFzUfA3P9wF9QZllDHPF
+Up/L+M+ZBn8b2kMVn54CVVeWFPFSPCeHlCjtHzoBN6J2/FNQwISbxmtOuowhT6KO
+VWKR82kV2LyI48SqC/3vqOlLVSoGIG1VeCkZ7l8wXEskEVX/JJpuXior7gtNn3/3
+ATiUFJVDBwn7YKnuHKsSjKCaXqeYalltiz8I+8jRRa8YFWSQEg9zKC7F4iRO/Fjs
+8PRF/iKz6y+O0tlFYQXBl2+odnKPi4w2r78NBc5xjeambx9spnFixdjQg3IM8WcR
+iQycE0xyNN+81XHfqnHd4blsjDwSXWXavVcStkNr/+XeTWYRUc+ZruwXtuhxkYze
+Sf7dNXGiFSeUHM9h4ya7b6NnJSFd5t0dCy5oGzuCr+yDZ4XUmFF0sbmZgIn/f3gZ
+XHlKYC6SQK5MNyosycdiyA5d9zZbyuAlJQG03RoHnHcAP9Dc1ew91Pq7P8yF1m9/
+qS3fuQL39ZeatTXaw2ewh0qpKJ4jjv9cJ2vhsE/zB+4ALtRZh8tSQZXq9EfX7mRB
+VXyNWQKV3WKdwrnuWih0hKWbt5DHDAff9Yk2dDLWKMGwsAvgnEzDHNb842m1R0aB
+L6KCq9NjRHDEjf8tM7qtj3u1cIiuPhnPQCjY/MiQu12ZIvVS5ljFH4gxQ+6IHdfG
+jjxDah2nGN59PRbxYvnKkKj9
+-----END CERTIFICATE-----
+
+# Issuer: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Subject: CN=USERTrust ECC Certification Authority O=The USERTRUST Network
+# Label: "USERTrust ECC Certification Authority"
+# Serial: 123013823720199481456569720443997572134
+# MD5 Fingerprint: fa:68:bc:d9:b5:7f:ad:fd:c9:1d:06:83:28:cc:24:c1
+# SHA1 Fingerprint: d1:cb:ca:5d:b2:d5:2a:7f:69:3b:67:4d:e5:f0:5a:1d:0c:95:7d:f0
+# SHA256 Fingerprint: 4f:f4:60:d5:4b:9c:86:da:bf:bc:fc:57:12:e0:40:0d:2b:ed:3f:bc:4d:4f:bd:aa:86:e0:6a:dc:d2:a9:ad:7a
+-----BEGIN CERTIFICATE-----
+MIICjzCCAhWgAwIBAgIQXIuZxVqUxdJxVt7NiYDMJjAKBggqhkjOPQQDAzCBiDEL
+MAkGA1UEBhMCVVMxEzARBgNVBAgTCk5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNl
+eSBDaXR5MR4wHAYDVQQKExVUaGUgVVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMT
+JVVTRVJUcnVzdCBFQ0MgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkwHhcNMTAwMjAx
+MDAwMDAwWhcNMzgwMTE4MjM1OTU5WjCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
+Ck5ldyBKZXJzZXkxFDASBgNVBAcTC0plcnNleSBDaXR5MR4wHAYDVQQKExVUaGUg
+VVNFUlRSVVNUIE5ldHdvcmsxLjAsBgNVBAMTJVVTRVJUcnVzdCBFQ0MgQ2VydGlm
+aWNhdGlvbiBBdXRob3JpdHkwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQarFRaqflo
+I+d61SRvU8Za2EurxtW20eZzca7dnNYMYf3boIkDuAUU7FfO7l0/4iGzzvfUinng
+o4N+LZfQYcTxmdwlkWOrfzCjtHDix6EznPO/LlxTsV+zfTJ/ijTjeXmjQjBAMB0G
+A1UdDgQWBBQ64QmG1M8ZwpZ2dEl23OA1xmNjmjAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAKBggqhkjOPQQDAwNoADBlAjA2Z6EWCNzklwBBHU6+4WMB
+zzuqQhFkoJ2UOQIReVx7Hfpkue4WQrO/isIJxOzksU0CMQDpKmFHjFJKS04YcPbW
+RNZu9YO6bVi9JNlWSOrvxKJGgYhqOkbRqZtNyWHa0V1Xahg=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R4
+# Label: "GlobalSign ECC Root CA - R4"
+# Serial: 14367148294922964480859022125800977897474
+# MD5 Fingerprint: 20:f0:27:68:d1:7e:a0:9d:0e:e6:2a:ca:df:5c:89:8e
+# SHA1 Fingerprint: 69:69:56:2e:40:80:f4:24:a1:e7:19:9f:14:ba:f3:ee:58:ab:6a:bb
+# SHA256 Fingerprint: be:c9:49:11:c2:95:56:76:db:6c:0a:55:09:86:d7:6e:3b:a0:05:66:7c:44:2c:97:62:b4:fb:b7:73:de:22:8c
+-----BEGIN CERTIFICATE-----
+MIIB4TCCAYegAwIBAgIRKjikHJYKBN5CsiilC+g0mAIwCgYIKoZIzj0EAwIwUDEk
+MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI0MRMwEQYDVQQKEwpH
+bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
+DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
+QSAtIFI0MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
+MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEuMZ5049sJQ6fLjkZHAOkrprlOQcJ
+FspjsbmG+IpXwVfOQvpzofdlQv8ewQCybnMO/8ch5RikqtlxP6jUuc6MHaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFFSwe61F
+uOJAf/sKbvu+M8k8o4TVMAoGCCqGSM49BAMCA0gAMEUCIQDckqGgE6bPA7DmxCGX
+kPoUVy0D7O48027KqGx2vKLeuwIgJ6iFJzWbVsaj8kfSt24bAgAXqmemFZHe+pTs
+ewv4n4Q=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign ECC Root CA - R5
+# Label: "GlobalSign ECC Root CA - R5"
+# Serial: 32785792099990507226680698011560947931244
+# MD5 Fingerprint: 9f:ad:3b:1c:02:1e:8a:ba:17:74:38:81:0c:a2:bc:08
+# SHA1 Fingerprint: 1f:24:c6:30:cd:a4:18:ef:20:69:ff:ad:4f:dd:5f:46:3a:1b:69:aa
+# SHA256 Fingerprint: 17:9f:bc:14:8a:3d:d0:0f:d2:4e:a1:34:58:cc:43:bf:a7:f5:9c:81:82:d7:83:a5:13:f6:eb:ec:10:0c:89:24
+-----BEGIN CERTIFICATE-----
+MIICHjCCAaSgAwIBAgIRYFlJ4CYuu1X5CneKcflK2GwwCgYIKoZIzj0EAwMwUDEk
+MCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBDQSAtIFI1MRMwEQYDVQQKEwpH
+bG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWduMB4XDTEyMTExMzAwMDAwMFoX
+DTM4MDExOTAzMTQwN1owUDEkMCIGA1UECxMbR2xvYmFsU2lnbiBFQ0MgUm9vdCBD
+QSAtIFI1MRMwEQYDVQQKEwpHbG9iYWxTaWduMRMwEQYDVQQDEwpHbG9iYWxTaWdu
+MHYwEAYHKoZIzj0CAQYFK4EEACIDYgAER0UOlvt9Xb/pOdEh+J8LttV7HpI6SFkc
+8GIxLcB6KP4ap1yztsyX50XUWPrRd21DosCHZTQKH3rd6zwzocWdTaRvQZU4f8ke
+hOvRnkmSh5SHDDqFSmafnVmTTZdhBoZKo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYD
+VR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUPeYpSJvqB8ohREom3m7e0oPQn1kwCgYI
+KoZIzj0EAwMDaAAwZQIxAOVpEslu28YxuglB4Zf4+/2a4n0Sye18ZNPLBSWLVtmg
+515dTguDnFt2KaAJJiFqYgIwcdK1j1zqO+F4CYWodZI7yFz9SO8NdCKoCOJuxUnO
+xwy8p2Fp8fc74SrL+SvzZpA3
+-----END CERTIFICATE-----
+
+# Issuer: CN=Staat der Nederlanden Root CA - G3 O=Staat der Nederlanden
+# Subject: CN=Staat der Nederlanden Root CA - G3 O=Staat der Nederlanden
+# Label: "Staat der Nederlanden Root CA - G3"
+# Serial: 10003001
+# MD5 Fingerprint: 0b:46:67:07:db:10:2f:19:8c:35:50:60:d1:0b:f4:37
+# SHA1 Fingerprint: d8:eb:6b:41:51:92:59:e0:f3:e7:85:00:c0:3d:b6:88:97:c9:ee:fc
+# SHA256 Fingerprint: 3c:4f:b0:b9:5a:b8:b3:00:32:f4:32:b8:6f:53:5f:e1:72:c1:85:d0:fd:39:86:58:37:cf:36:18:7f:a6:f4:28
+-----BEGIN CERTIFICATE-----
+MIIFdDCCA1ygAwIBAgIEAJiiOTANBgkqhkiG9w0BAQsFADBaMQswCQYDVQQGEwJO
+TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSswKQYDVQQDDCJTdGFh
+dCBkZXIgTmVkZXJsYW5kZW4gUm9vdCBDQSAtIEczMB4XDTEzMTExNDExMjg0MloX
+DTI4MTExMzIzMDAwMFowWjELMAkGA1UEBhMCTkwxHjAcBgNVBAoMFVN0YWF0IGRl
+ciBOZWRlcmxhbmRlbjErMCkGA1UEAwwiU3RhYXQgZGVyIE5lZGVybGFuZGVuIFJv
+b3QgQ0EgLSBHMzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAL4yolQP
+cPssXFnrbMSkUeiFKrPMSjTysF/zDsccPVMeiAho2G89rcKezIJnByeHaHE6n3WW
+IkYFsO2tx1ueKt6c/DrGlaf1F2cY5y9JCAxcz+bMNO14+1Cx3Gsy8KL+tjzk7FqX
+xz8ecAgwoNzFs21v0IJyEavSgWhZghe3eJJg+szeP4TrjTgzkApyI/o1zCZxMdFy
+KJLZWyNtZrVtB0LrpjPOktvA9mxjeM3KTj215VKb8b475lRgsGYeCasH/lSJEULR
+9yS6YHgamPfJEf0WwTUaVHXvQ9Plrk7O53vDxk5hUUurmkVLoR9BvUhTFXFkC4az
+5S6+zqQbwSmEorXLCCN2QyIkHxcE1G6cxvx/K2Ya7Irl1s9N9WMJtxU51nus6+N8
+6U78dULI7ViVDAZCopz35HCz33JvWjdAidiFpNfxC95DGdRKWCyMijmev4SH8RY7
+Ngzp07TKbBlBUgmhHbBqv4LvcFEhMtwFdozL92TkA1CvjJFnq8Xy7ljY3r735zHP
+bMk7ccHViLVlvMDoFxcHErVc0qsgk7TmgoNwNsXNo42ti+yjwUOH5kPiNL6VizXt
+BznaqB16nzaeErAMZRKQFWDZJkBE41ZgpRDUajz9QdwOWke275dhdU/Z/seyHdTt
+XUmzqWrLZoQT1Vyg3N9udwbRcXXIV2+vD3dbAgMBAAGjQjBAMA8GA1UdEwEB/wQF
+MAMBAf8wDgYDVR0PAQH/BAQDAgEGMB0GA1UdDgQWBBRUrfrHkleuyjWcLhL75Lpd
+INyUVzANBgkqhkiG9w0BAQsFAAOCAgEAMJmdBTLIXg47mAE6iqTnB/d6+Oea31BD
+U5cqPco8R5gu4RV78ZLzYdqQJRZlwJ9UXQ4DO1t3ApyEtg2YXzTdO2PCwyiBwpwp
+LiniyMMB8jPqKqrMCQj3ZWfGzd/TtiunvczRDnBfuCPRy5FOCvTIeuXZYzbB1N/8
+Ipf3YF3qKS9Ysr1YvY2WTxB1v0h7PVGHoTx0IsL8B3+A3MSs/mrBcDCw6Y5p4ixp
+gZQJut3+TcCDjJRYwEYgr5wfAvg1VUkvRtTA8KCWAg8zxXHzniN9lLf9OtMJgwYh
+/WA9rjLA0u6NpvDntIJ8CsxwyXmA+P5M9zWEGYox+wrZ13+b8KKaa8MFSu1BYBQw
+0aoRQm7TIwIEC8Zl3d1Sd9qBa7Ko+gE4uZbqKmxnl4mUnrzhVNXkanjvSr0rmj1A
+fsbAddJu+2gw7OyLnflJNZoaLNmzlTnVHpL3prllL+U9bTpITAjc5CgSKL59NVzq
+4BZ+Extq1z7XnvwtdbLBFNUjA9tbbws+eC8N3jONFrdI54OagQ97wUNNVQQXOEpR
+1VmiiXTTn74eS9fGbbeIJG9gkaSChVtWQbzQRKtqE77RLFi3EjNYsjdj3BP1lB0/
+QFH1T/U67cjF68IeHRaVesd+QnGTbksVtzDfqu1XhUisHWrdOWnk4Xl4vs4Fv6EM
+94B7IWcnMFk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
+# Subject: CN=Staat der Nederlanden EV Root CA O=Staat der Nederlanden
+# Label: "Staat der Nederlanden EV Root CA"
+# Serial: 10000013
+# MD5 Fingerprint: fc:06:af:7b:e8:1a:f1:9a:b4:e8:d2:70:1f:c0:f5:ba
+# SHA1 Fingerprint: 76:e2:7e:c1:4f:db:82:c1:c0:a6:75:b5:05:be:3d:29:b4:ed:db:bb
+# SHA256 Fingerprint: 4d:24:91:41:4c:fe:95:67:46:ec:4c:ef:a6:cf:6f:72:e2:8a:13:29:43:2f:9d:8a:90:7a:c4:cb:5d:ad:c1:5a
+-----BEGIN CERTIFICATE-----
+MIIFcDCCA1igAwIBAgIEAJiWjTANBgkqhkiG9w0BAQsFADBYMQswCQYDVQQGEwJO
+TDEeMBwGA1UECgwVU3RhYXQgZGVyIE5lZGVybGFuZGVuMSkwJwYDVQQDDCBTdGFh
+dCBkZXIgTmVkZXJsYW5kZW4gRVYgUm9vdCBDQTAeFw0xMDEyMDgxMTE5MjlaFw0y
+MjEyMDgxMTEwMjhaMFgxCzAJBgNVBAYTAk5MMR4wHAYDVQQKDBVTdGFhdCBkZXIg
+TmVkZXJsYW5kZW4xKTAnBgNVBAMMIFN0YWF0IGRlciBOZWRlcmxhbmRlbiBFViBS
+b290IENBMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA48d+ifkkSzrS
+M4M1LGns3Amk41GoJSt5uAg94JG6hIXGhaTK5skuU6TJJB79VWZxXSzFYGgEt9nC
+UiY4iKTWO0Cmws0/zZiTs1QUWJZV1VD+hq2kY39ch/aO5ieSZxeSAgMs3NZmdO3d
+Z//BYY1jTw+bbRcwJu+r0h8QoPnFfxZpgQNH7R5ojXKhTbImxrpsX23Wr9GxE46p
+rfNeaXUmGD5BKyF/7otdBwadQ8QpCiv8Kj6GyzyDOvnJDdrFmeK8eEEzduG/L13l
+pJhQDBXd4Pqcfzho0LKmeqfRMb1+ilgnQ7O6M5HTp5gVXJrm0w912fxBmJc+qiXb
+j5IusHsMX/FjqTf5m3VpTCgmJdrV8hJwRVXj33NeN/UhbJCONVrJ0yPr08C+eKxC
+KFhmpUZtcALXEPlLVPxdhkqHz3/KRawRWrUgUY0viEeXOcDPusBCAUCZSCELa6fS
+/ZbV0b5GnUngC6agIk440ME8MLxwjyx1zNDFjFE7PZQIZCZhfbnDZY8UnCHQqv0X
+cgOPvZuM5l5Tnrmd74K74bzickFbIZTTRTeU0d8JOV3nI6qaHcptqAqGhYqCvkIH
+1vI4gnPah1vlPNOePqc7nvQDs/nxfRN0Av+7oeX6AHkcpmZBiFxgV6YuCcS6/ZrP
+px9Aw7vMWgpVSzs4dlG4Y4uElBbmVvMCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB
+/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFP6rAJCYniT8qcwaivsnuL8wbqg7
+MA0GCSqGSIb3DQEBCwUAA4ICAQDPdyxuVr5Os7aEAJSrR8kN0nbHhp8dB9O2tLsI
+eK9p0gtJ3jPFrK3CiAJ9Brc1AsFgyb/E6JTe1NOpEyVa/m6irn0F3H3zbPB+po3u
+2dfOWBfoqSmuc0iH55vKbimhZF8ZE/euBhD/UcabTVUlT5OZEAFTdfETzsemQUHS
+v4ilf0X8rLiltTMMgsT7B/Zq5SWEXwbKwYY5EdtYzXc7LMJMD16a4/CrPmEbUCTC
+wPTxGfARKbalGAKb12NMcIxHowNDXLldRqANb/9Zjr7dn3LDWyvfjFvO5QxGbJKy
+CqNMVEIYFRIYvdr8unRu/8G2oGTYqV9Vrp9canaW2HNnh/tNf1zuacpzEPuKqf2e
+vTY4SUmH9A4U8OmHuD+nT3pajnnUk+S7aFKErGzp85hwVXIy+TSrK0m1zSBi5Dp6
+Z2Orltxtrpfs/J92VoguZs9btsmksNcFuuEnL5O7Jiqik7Ab846+HUCjuTaPPoIa
+Gl6I6lD4WeKDRikL40Rc4ZW2aZCaFG+XroHPaO+Zmr615+F/+PoTRxZMzG0IQOeL
+eG9QgkRQP2YGiqtDhFZKDyAthg710tvSeopLzaXoTvFeJiUBWSOgftL2fiFX1ye8
+FVdMpEbB4IMeDExNH08GGeL5qPQ6gqGyeUN51q1veieQA6TqJIc/2b3Z6fJfUEkc
+7uzXLg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Commercial Root CA 1 O=IdenTrust
+# Label: "IdenTrust Commercial Root CA 1"
+# Serial: 13298821034946342390520003877796839426
+# MD5 Fingerprint: b3:3e:77:73:75:ee:a0:d3:e3:7e:49:63:49:59:bb:c7
+# SHA1 Fingerprint: df:71:7e:aa:4a:d9:4e:c9:55:84:99:60:2d:48:de:5f:bc:f0:3a:25
+# SHA256 Fingerprint: 5d:56:49:9b:e4:d2:e0:8b:cf:ca:d0:8a:3e:38:72:3d:50:50:3b:de:70:69:48:e4:2f:55:60:30:19:e5:28:ae
+-----BEGIN CERTIFICATE-----
+MIIFYDCCA0igAwIBAgIQCgFCgAAAAUUjyES1AAAAAjANBgkqhkiG9w0BAQsFADBK
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScwJQYDVQQDEx5JZGVu
+VHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwHhcNMTQwMTE2MTgxMjIzWhcNMzQw
+MTE2MTgxMjIzWjBKMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MScw
+JQYDVQQDEx5JZGVuVHJ1c3QgQ29tbWVyY2lhbCBSb290IENBIDEwggIiMA0GCSqG
+SIb3DQEBAQUAA4ICDwAwggIKAoICAQCnUBneP5k91DNG8W9RYYKyqU+PZ4ldhNlT
+3Qwo2dfw/66VQ3KZ+bVdfIrBQuExUHTRgQ18zZshq0PirK1ehm7zCYofWjK9ouuU
++ehcCuz/mNKvcbO0U59Oh++SvL3sTzIwiEsXXlfEU8L2ApeN2WIrvyQfYo3fw7gp
+S0l4PJNgiCL8mdo2yMKi1CxUAGc1bnO/AljwpN3lsKImesrgNqUZFvX9t++uP0D1
+bVoE/c40yiTcdCMbXTMTEl3EASX2MN0CXZ/g1Ue9tOsbobtJSdifWwLziuQkkORi
+T0/Br4sOdBeo0XKIanoBScy0RnnGF7HamB4HWfp1IYVl3ZBWzvurpWCdxJ35UrCL
+vYf5jysjCiN2O/cz4ckA82n5S6LgTrx+kzmEB/dEcH7+B1rlsazRGMzyNeVJSQjK
+Vsk9+w8YfYs7wRPCTY/JTw436R+hDmrfYi7LNQZReSzIJTj0+kuniVyc0uMNOYZK
+dHzVWYfCP04MXFL0PfdSgvHqo6z9STQaKPNBiDoT7uje/5kdX7rL6B7yuVBgwDHT
+c+XvvqDtMwt0viAgxGds8AgDelWAf0ZOlqf0Hj7h9tgJ4TNkK2PXMl6f+cB7D3hv
+l7yTmvmcEpB4eoCHFddydJxVdHixuuFucAS6T6C6aMN7/zHwcz09lCqxC0EOoP5N
+iGVreTO01wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB
+/zAdBgNVHQ4EFgQU7UQZwNPwBovupHu+QucmVMiONnYwDQYJKoZIhvcNAQELBQAD
+ggIBAA2ukDL2pkt8RHYZYR4nKM1eVO8lvOMIkPkp165oCOGUAFjvLi5+U1KMtlwH
+6oi6mYtQlNeCgN9hCQCTrQ0U5s7B8jeUeLBfnLOic7iPBZM4zY0+sLj7wM+x8uwt
+LRvM7Kqas6pgghstO8OEPVeKlh6cdbjTMM1gCIOQ045U8U1mwF10A0Cj7oV+wh93
+nAbowacYXVKV7cndJZ5t+qntozo00Fl72u1Q8zW/7esUTTHHYPTa8Yec4kjixsU3
++wYQ+nVZZjFHKdp2mhzpgq7vmrlR94gjmmmVYjzlVYA211QC//G5Xc7UI2/YRYRK
+W2XviQzdFKcgyxilJbQN+QHwotL0AMh0jqEqSI5l2xPE4iUXfeu+h1sXIFRRk0pT
+AwvsXcoz7WL9RccvW9xYoIA55vrX/hMUpu09lEpCdNTDd1lzzY9GvlU47/rokTLq
+l1gEIt44w8y8bckzOmoKaT+gyOpyj4xjhiO9bTyWnpXgSUyqorkqG5w2gXjtw+hG
+4iZZRHUe2XWJUc0QhJ1hYMtd+ZciTY6Y5uN/9lu7rs3KSoFrXgvzUeF0K+l+J6fZ
+mUlO+KWA2yUPHGNiiskzZ2s8EIPGrd6ozRaOjfAHN3Gf8qv8QfXBi+wAN10J5U6A
+7/qxXDgGpRtK4dw4LTzcqx+QGtVKnO7RcGzM7vRX+Bi6hG6H
+-----END CERTIFICATE-----
+
+# Issuer: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Subject: CN=IdenTrust Public Sector Root CA 1 O=IdenTrust
+# Label: "IdenTrust Public Sector Root CA 1"
+# Serial: 13298821034946342390521976156843933698
+# MD5 Fingerprint: 37:06:a5:b0:fc:89:9d:ba:f4:6b:8c:1a:64:cd:d5:ba
+# SHA1 Fingerprint: ba:29:41:60:77:98:3f:f4:f3:ef:f2:31:05:3b:2e:ea:6d:4d:45:fd
+# SHA256 Fingerprint: 30:d0:89:5a:9a:44:8a:26:20:91:63:55:22:d1:f5:20:10:b5:86:7a:ca:e1:2c:78:ef:95:8f:d4:f4:38:9f:2f
+-----BEGIN CERTIFICATE-----
+MIIFZjCCA06gAwIBAgIQCgFCgAAAAUUjz0Z8AAAAAjANBgkqhkiG9w0BAQsFADBN
+MQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0MSowKAYDVQQDEyFJZGVu
+VHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwHhcNMTQwMTE2MTc1MzMyWhcN
+MzQwMTE2MTc1MzMyWjBNMQswCQYDVQQGEwJVUzESMBAGA1UEChMJSWRlblRydXN0
+MSowKAYDVQQDEyFJZGVuVHJ1c3QgUHVibGljIFNlY3RvciBSb290IENBIDEwggIi
+MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC2IpT8pEiv6EdrCvsnduTyP4o7
+ekosMSqMjbCpwzFrqHd2hCa2rIFCDQjrVVi7evi8ZX3yoG2LqEfpYnYeEe4IFNGy
+RBb06tD6Hi9e28tzQa68ALBKK0CyrOE7S8ItneShm+waOh7wCLPQ5CQ1B5+ctMlS
+bdsHyo+1W/CD80/HLaXIrcuVIKQxKFdYWuSNG5qrng0M8gozOSI5Cpcu81N3uURF
+/YTLNiCBWS2ab21ISGHKTN9T0a9SvESfqy9rg3LvdYDaBjMbXcjaY8ZNzaxmMc3R
+3j6HEDbhuaR672BQssvKplbgN6+rNBM5Jeg5ZuSYeqoSmJxZZoY+rfGwyj4GD3vw
+EUs3oERte8uojHH01bWRNszwFcYr3lEXsZdMUD2xlVl8BX0tIdUAvwFnol57plzy
+9yLxkA2T26pEUWbMfXYD62qoKjgZl3YNa4ph+bz27nb9cCvdKTz4Ch5bQhyLVi9V
+GxyhLrXHFub4qjySjmm2AcG1hp2JDws4lFTo6tyePSW8Uybt1as5qsVATFSrsrTZ
+2fjXctscvG29ZV/viDUqZi/u9rNl8DONfJhBaUYPQxxp+pu10GFqzcpL2UyQRqsV
+WaFHVCkugyhfHMKiq3IXAAaOReyL4jM9f9oZRORicsPfIsbyVtTdX5Vy7W1f90gD
+W/3FKqD2cyOEEBsB5wIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/
+BAUwAwEB/zAdBgNVHQ4EFgQU43HgntinQtnbcZFrlJPrw6PRFKMwDQYJKoZIhvcN
+AQELBQADggIBAEf63QqwEZE4rU1d9+UOl1QZgkiHVIyqZJnYWv6IAcVYpZmxI1Qj
+t2odIFflAWJBF9MJ23XLblSQdf4an4EKwt3X9wnQW3IV5B4Jaj0z8yGa5hV+rVHV
+DRDtfULAj+7AmgjVQdZcDiFpboBhDhXAuM/FSRJSzL46zNQuOAXeNf0fb7iAaJg9
+TaDKQGXSc3z1i9kKlT/YPyNtGtEqJBnZhbMX73huqVjRI9PHE+1yJX9dsXNw0H8G
+lwmEKYBhHfpe/3OsoOOJuBxxFcbeMX8S3OFtm6/n6J91eEyrRjuazr8FGF1NFTwW
+mhlQBJqymm9li1JfPFgEKCXAZmExfrngdbkaqIHWchezxQMxNRF4eKLg6TCMf4Df
+WN88uieW4oA0beOY02QnrEh+KHdcxiVhJfiFDGX6xDIvpZgF5PgLZxYWxoK4Mhn5
++bl53B/N66+rDt0b20XkeucC4pVd/GnwU2lhlXV5C15V5jgclKlZM57IcXR5f1GJ
+tshquDDIajjDbp7hNxbqBWJMWxJH7ae0s1hWx0nzfxJoCTFx8G34Tkf71oXuxVhA
+GaQdp/lLQzfcaFpPz+vCZHTetBXZ9FRUGi8c15dxVJCO2SCdUyt/q4/i6jC8UDfv
+8Ue1fXwsBOxonbRJRBD0ckscZOf85muQ3Wl9af0AVqW3rLatt8o+Ae+c
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G2 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2009 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G2"
+# Serial: 1246989352
+# MD5 Fingerprint: 4b:e2:c9:91:96:65:0c:f4:0e:5a:93:92:a0:0a:fe:b2
+# SHA1 Fingerprint: 8c:f4:27:fd:79:0c:3a:d1:66:06:8d:e8:1e:57:ef:bb:93:22:72:d4
+# SHA256 Fingerprint: 43:df:57:74:b0:3e:7f:ef:5f:e4:0d:93:1a:7b:ed:f1:bb:2e:6b:42:73:8c:4e:6d:38:41:10:3d:3a:a7:f3:39
+-----BEGIN CERTIFICATE-----
+MIIEPjCCAyagAwIBAgIESlOMKDANBgkqhkiG9w0BAQsFADCBvjELMAkGA1UEBhMC
+VVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50
+cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3Qs
+IEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVz
+dCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRzIwHhcNMDkwNzA3MTcy
+NTU0WhcNMzAxMjA3MTc1NTU0WjCBvjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUVu
+dHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3d3cuZW50cnVzdC5uZXQvbGVnYWwt
+dGVybXMxOTA3BgNVBAsTMChjKSAyMDA5IEVudHJ1c3QsIEluYy4gLSBmb3IgYXV0
+aG9yaXplZCB1c2Ugb25seTEyMDAGA1UEAxMpRW50cnVzdCBSb290IENlcnRpZmlj
+YXRpb24gQXV0aG9yaXR5IC0gRzIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEK
+AoIBAQC6hLZy254Ma+KZ6TABp3bqMriVQRrJ2mFOWHLP/vaCeb9zYQYKpSfYs1/T
+RU4cctZOMvJyig/3gxnQaoCAAEUesMfnmr8SVycco2gvCoe9amsOXmXzHHfV1IWN
+cCG0szLni6LVhjkCsbjSR87kyUnEO6fe+1R9V77w6G7CebI6C1XiUJgWMhNcL3hW
+wcKUs/Ja5CeanyTXxuzQmyWC48zCxEXFjJd6BmsqEZ+pCm5IO2/b1BEZQvePB7/1
+U1+cPvQXLOZprE4yTGJ36rfo5bs0vBmLrpxR57d+tVOxMyLlbc9wPBr64ptntoP0
+jaWvYkxN4FisZDQSA/i2jZRjJKRxAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAP
+BgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRqciZ60B7vfec7aVHUbI2fkBJmqzAN
+BgkqhkiG9w0BAQsFAAOCAQEAeZ8dlsa2eT8ijYfThwMEYGprmi5ZiXMRrEPR9RP/
+jTkrwPK9T3CMqS/qF8QLVJ7UG5aYMzyorWKiAHarWWluBh1+xLlEjZivEtRh2woZ
+Rkfz6/djwUAFQKXSt/S1mja/qYh2iARVBCuch38aNzx+LaUa2NSJXsq9rD1s2G2v
+1fN2D807iDginWyTmsQ9v4IbZT+mD12q/OWyFcq1rca8PdCE6OoGcrBNOTJ4vz4R
+nAuknZoh8/CbCzB428Hch0P+vGOaysXCHMnHjf87ElgI5rY97HosTvuDls4MPGmH
+VHOkc8KT/1EQrBVUAdj8BbGJoX90g5pJ19xOe4pIb4tF9g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - EC1 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2012 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - EC1"
+# Serial: 51543124481930649114116133369
+# MD5 Fingerprint: b6:7e:1d:f0:58:c5:49:6c:24:3b:3d:ed:98:18:ed:bc
+# SHA1 Fingerprint: 20:d8:06:40:df:9b:25:f5:12:25:3a:11:ea:f7:59:8a:eb:14:b5:47
+# SHA256 Fingerprint: 02:ed:0e:b2:8c:14:da:45:16:5c:56:67:91:70:0d:64:51:d7:fb:56:f0:b2:ab:1d:3b:8e:b0:70:e5:6e:df:f5
+-----BEGIN CERTIFICATE-----
+MIIC+TCCAoCgAwIBAgINAKaLeSkAAAAAUNCR+TAKBggqhkjOPQQDAzCBvzELMAkG
+A1UEBhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xKDAmBgNVBAsTH1NlZSB3
+d3cuZW50cnVzdC5uZXQvbGVnYWwtdGVybXMxOTA3BgNVBAsTMChjKSAyMDEyIEVu
+dHJ1c3QsIEluYy4gLSBmb3IgYXV0aG9yaXplZCB1c2Ugb25seTEzMDEGA1UEAxMq
+RW50cnVzdCBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0gRUMxMB4XDTEy
+MTIxODE1MjUzNloXDTM3MTIxODE1NTUzNlowgb8xCzAJBgNVBAYTAlVTMRYwFAYD
+VQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1c3QubmV0
+L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxMiBFbnRydXN0LCBJbmMuIC0g
+Zm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMzAxBgNVBAMTKkVudHJ1c3QgUm9vdCBD
+ZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEVDMTB2MBAGByqGSM49AgEGBSuBBAAi
+A2IABIQTydC6bUF74mzQ61VfZgIaJPRbiWlH47jCffHyAsWfoPZb1YsGGYZPUxBt
+ByQnoaD41UcZYUx9ypMn6nQM72+WCf5j7HBdNq1nd67JnXxVRDqiY1Ef9eNi1KlH
+Bz7MIKNCMEAwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0O
+BBYEFLdj5xrdjekIplWDpOBqUEFlEUJJMAoGCCqGSM49BAMDA2cAMGQCMGF52OVC
+R98crlOZF7ZvHH3hvxGU0QOIdeSNiaSKd0bebWHvAvX7td/M/k7//qnmpwIwW5nX
+hTcGtXsI/esni0qU+eH6p44mCOh8kmhtc9hvJqwhAriZtyZBWyVgrtBIGu4G
+-----END CERTIFICATE-----
+
+# Issuer: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Subject: CN=CFCA EV ROOT O=China Financial Certification Authority
+# Label: "CFCA EV ROOT"
+# Serial: 407555286
+# MD5 Fingerprint: 74:e1:b6:ed:26:7a:7a:44:30:33:94:ab:7b:27:81:30
+# SHA1 Fingerprint: e2:b8:29:4b:55:84:ab:6b:58:c2:90:46:6c:ac:3f:b8:39:8f:84:83
+# SHA256 Fingerprint: 5c:c3:d7:8e:4e:1d:5e:45:54:7a:04:e6:87:3e:64:f9:0c:f9:53:6d:1c:cc:2e:f8:00:f3:55:c4:c5:fd:70:fd
+-----BEGIN CERTIFICATE-----
+MIIFjTCCA3WgAwIBAgIEGErM1jANBgkqhkiG9w0BAQsFADBWMQswCQYDVQQGEwJD
+TjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9y
+aXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJPT1QwHhcNMTIwODA4MDMwNzAxWhcNMjkx
+MjMxMDMwNzAxWjBWMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5j
+aWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRUwEwYDVQQDDAxDRkNBIEVWIFJP
+T1QwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDXXWvNED8fBVnVBU03
+sQ7smCuOFR36k0sXgiFxEFLXUWRwFsJVaU2OFW2fvwwbwuCjZ9YMrM8irq93VCpL
+TIpTUnrD7i7es3ElweldPe6hL6P3KjzJIx1qqx2hp/Hz7KDVRM8Vz3IvHWOX6Jn5
+/ZOkVIBMUtRSqy5J35DNuF++P96hyk0g1CXohClTt7GIH//62pCfCqktQT+x8Rgp
+7hZZLDRJGqgG16iI0gNyejLi6mhNbiyWZXvKWfry4t3uMCz7zEasxGPrb382KzRz
+EpR/38wmnvFyXVBlWY9ps4deMm/DGIq1lY+wejfeWkU7xzbh72fROdOXW3NiGUgt
+hxwG+3SYIElz8AXSG7Ggo7cbcNOIabla1jj0Ytwli3i/+Oh+uFzJlU9fpy25IGvP
+a931DfSCt/SyZi4QKPaXWnuWFo8BGS1sbn85WAZkgwGDg8NNkt0yxoekN+kWzqot
+aK8KgWU6cMGbrU1tVMoqLUuFG7OA5nBFDWteNfB/O7ic5ARwiRIlk9oKmSJgamNg
+TnYGmE69g60dWIolhdLHZR4tjsbftsbhf4oEIRUpdPA+nJCdDC7xij5aqgwJHsfV
+PKPtl8MeNPo4+QgO48BdK4PRVmrJtqhUUy54Mmc9gn900PvhtgVguXDbjgv5E1hv
+cWAQUhC5wUEJ73IfZzF4/5YFjQIDAQABo2MwYTAfBgNVHSMEGDAWgBTj/i39KNAL
+tbq2osS/BqoFjJP7LzAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAd
+BgNVHQ4EFgQU4/4t/SjQC7W6tqLEvwaqBYyT+y8wDQYJKoZIhvcNAQELBQADggIB
+ACXGumvrh8vegjmWPfBEp2uEcwPenStPuiB/vHiyz5ewG5zz13ku9Ui20vsXiObT
+ej/tUxPQ4i9qecsAIyjmHjdXNYmEwnZPNDatZ8POQQaIxffu2Bq41gt/UP+TqhdL
+jOztUmCypAbqTuv0axn96/Ua4CUqmtzHQTb3yHQFhDmVOdYLO6Qn+gjYXB74BGBS
+ESgoA//vU2YApUo0FmZ8/Qmkrp5nGm9BC2sGE5uPhnEFtC+NiWYzKXZUmhH4J/qy
+P5Hgzg0b8zAarb8iXRvTvyUFTeGSGn+ZnzxEk8rUQElsgIfXBDrDMlI1Dlb4pd19
+xIsNER9Tyx6yF7Zod1rg1MvIB671Oi6ON7fQAUtDKXeMOZePglr4UeWJoBjnaH9d
+Ci77o0cOPaYjesYBx4/IXr9tgFa+iiS6M+qf4TIRnvHST4D2G0CvOJ4RUHlzEhLN
+5mydLIhyPDCBBpEi6lmt2hkuIsKNuYyH4Ga8cyNfIWRjgEj1oDwYPZTISEEdQLpe
+/v5WOaHIz16eGWRGENoXkbcFgKyLmZJ956LYBws2J+dIeWCKw9cTXPhyQN9Ky8+Z
+AAoACxGV2lZFA4gKn2fQ1XmxqI1AbQ3CekD6819kR5LLU7m7Wc5P/dAVUwHY3+vZ
+5nbv0CO7O6l5s9UCKc2Jo5YPSjXnTkLAdc0Hz+Ys63su
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GB CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GB CA"
+# Serial: 157768595616588414422159278966750757568
+# MD5 Fingerprint: a4:eb:b9:61:28:2e:b7:2f:98:b0:35:26:90:99:51:1d
+# SHA1 Fingerprint: 0f:f9:40:76:18:d3:d7:6a:4b:98:f0:a8:35:9e:0c:fd:27:ac:cc:ed
+# SHA256 Fingerprint: 6b:9c:08:e8:6e:b0:f7:67:cf:ad:65:cd:98:b6:21:49:e5:49:4a:67:f5:84:5e:7b:d1:ed:01:9f:27:b8:6b:d6
+-----BEGIN CERTIFICATE-----
+MIIDtTCCAp2gAwIBAgIQdrEgUnTwhYdGs/gjGvbCwDANBgkqhkiG9w0BAQsFADBt
+MQswCQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUg
+Rm91bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9i
+YWwgUm9vdCBHQiBDQTAeFw0xNDEyMDExNTAwMzJaFw0zOTEyMDExNTEwMzFaMG0x
+CzAJBgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBG
+b3VuZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2Jh
+bCBSb290IEdCIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2Be3
+HEokKtaXscriHvt9OO+Y9bI5mE4nuBFde9IllIiCFSZqGzG7qFshISvYD06fWvGx
+WuR51jIjK+FTzJlFXHtPrby/h0oLS5daqPZI7H17Dc0hBt+eFf1Biki3IPShehtX
+1F1Q/7pn2COZH8g/497/b1t3sWtuuMlk9+HKQUYOKXHQuSP8yYFfTvdv37+ErXNk
+u7dCjmn21HYdfp2nuFeKUWdy19SouJVUQHMD9ur06/4oQnc/nSMbsrY9gBQHTC5P
+99UKFg29ZkM3fiNDecNAhvVMKdqOmq0NpQSHiB6F4+lT1ZvIiwNjeOvgGUpuuy9r
+M2RYk61pv48b74JIxwIDAQABo1EwTzALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw
+AwEB/zAdBgNVHQ4EFgQUNQ/INmNe4qPs+TtmFc5RUuORmj0wEAYJKwYBBAGCNxUB
+BAMCAQAwDQYJKoZIhvcNAQELBQADggEBAEBM+4eymYGQfp3FsLAmzYh7KzKNbrgh
+cViXfa43FK8+5/ea4n32cZiZBKpDdHij40lhPnOMTZTg+XHEthYOU3gf1qKHLwI5
+gSk8rxWYITD+KJAAjNHhy/peyP34EEY7onhCkRd0VQreUGdNZtGn//3ZwLWoo4rO
+ZvUPQ82nK1d7Y0Zqqi5S2PTt4W2tKZB4SLrhI6qjiey1q5bAtEuiHZeeevJuQHHf
+aPFlTc58Bd9TZaml8LGXBHAVRgOY1NK/VLSgWH1Sb9pWJmLU2NuJMW8c8CLC02Ic
+Nc1MaRVUGpCY3useX8p3x8uOPUNpnJpY0CQ73xtAln41rYHHTnG6iBM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Subject: CN=SZAFIR ROOT CA2 O=Krajowa Izba Rozliczeniowa S.A.
+# Label: "SZAFIR ROOT CA2"
+# Serial: 357043034767186914217277344587386743377558296292
+# MD5 Fingerprint: 11:64:c1:89:b0:24:b1:8c:b1:07:7e:89:9e:51:9e:99
+# SHA1 Fingerprint: e2:52:fa:95:3f:ed:db:24:60:bd:6e:28:f3:9c:cc:cf:5e:b3:3f:de
+# SHA256 Fingerprint: a1:33:9d:33:28:1a:0b:56:e5:57:d3:d3:2b:1c:e7:f9:36:7e:b0:94:bd:5f:a7:2a:7e:50:04:c8:de:d7:ca:fe
+-----BEGIN CERTIFICATE-----
+MIIDcjCCAlqgAwIBAgIUPopdB+xV0jLVt+O2XwHrLdzk1uQwDQYJKoZIhvcNAQEL
+BQAwUTELMAkGA1UEBhMCUEwxKDAmBgNVBAoMH0tyYWpvd2EgSXpiYSBSb3psaWN6
+ZW5pb3dhIFMuQS4xGDAWBgNVBAMMD1NaQUZJUiBST09UIENBMjAeFw0xNTEwMTkw
+NzQzMzBaFw0zNTEwMTkwNzQzMzBaMFExCzAJBgNVBAYTAlBMMSgwJgYDVQQKDB9L
+cmFqb3dhIEl6YmEgUm96bGljemVuaW93YSBTLkEuMRgwFgYDVQQDDA9TWkFGSVIg
+Uk9PVCBDQTIwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3vD5QqEvN
+QLXOYeeWyrSh2gwisPq1e3YAd4wLz32ohswmUeQgPYUM1ljj5/QqGJ3a0a4m7utT
+3PSQ1hNKDJA8w/Ta0o4NkjrcsbH/ON7Dui1fgLkCvUqdGw+0w8LBZwPd3BucPbOw
+3gAeqDRHu5rr/gsUvTaE2g0gv/pby6kWIK05YO4vdbbnl5z5Pv1+TW9NL++IDWr6
+3fE9biCloBK0TXC5ztdyO4mTp4CEHCdJckm1/zuVnsHMyAHs6A6KCpbns6aH5db5
+BSsNl0BwPLqsdVqc1U2dAgrSS5tmS0YHF2Wtn2yIANwiieDhZNRnvDF5YTy7ykHN
+XGoAyDw4jlivAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQD
+AgEGMB0GA1UdDgQWBBQuFqlKGLXLzPVvUPMjX/hd56zwyDANBgkqhkiG9w0BAQsF
+AAOCAQEAtXP4A9xZWx126aMqe5Aosk3AM0+qmrHUuOQn/6mWmc5G4G18TKI4pAZw
+8PRBEew/R40/cof5O/2kbytTAOD/OblqBw7rHRz2onKQy4I9EYKL0rufKq8h5mOG
+nXkZ7/e7DDWQw4rtTw/1zBLZpD67oPwglV9PJi8RI4NOdQcPv5vRtB3pEAT+ymCP
+oky4rc/hkA/NrgrHXXu3UNLUYfrVFdvXn4dRVOul4+vJhaAlIDf7js4MNIThPIGy
+d05DpYhfhmehPea0XGG2Ptv+tyjFogeutcrKjSoS75ftwjCkySp6+/NNIxuZMzSg
+LvWpCz/UXeHPhJ/iGcJfitYgHuNztw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Subject: CN=Certum Trusted Network CA 2 O=Unizeto Technologies S.A. OU=Certum Certification Authority
+# Label: "Certum Trusted Network CA 2"
+# Serial: 44979900017204383099463764357512596969
+# MD5 Fingerprint: 6d:46:9e:d9:25:6d:08:23:5b:5e:74:7d:1e:27:db:f2
+# SHA1 Fingerprint: d3:dd:48:3e:2b:bf:4c:05:e8:af:10:f5:fa:76:26:cf:d3:dc:30:92
+# SHA256 Fingerprint: b6:76:f2:ed:da:e8:77:5c:d3:6c:b0:f6:3c:d1:d4:60:39:61:f4:9e:62:65:ba:01:3a:2f:03:07:b6:d0:b8:04
+-----BEGIN CERTIFICATE-----
+MIIF0jCCA7qgAwIBAgIQIdbQSk8lD8kyN/yqXhKN6TANBgkqhkiG9w0BAQ0FADCB
+gDELMAkGA1UEBhMCUEwxIjAgBgNVBAoTGVVuaXpldG8gVGVjaG5vbG9naWVzIFMu
+QS4xJzAlBgNVBAsTHkNlcnR1bSBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEkMCIG
+A1UEAxMbQ2VydHVtIFRydXN0ZWQgTmV0d29yayBDQSAyMCIYDzIwMTExMDA2MDgz
+OTU2WhgPMjA0NjEwMDYwODM5NTZaMIGAMQswCQYDVQQGEwJQTDEiMCAGA1UEChMZ
+VW5pemV0byBUZWNobm9sb2dpZXMgUy5BLjEnMCUGA1UECxMeQ2VydHVtIENlcnRp
+ZmljYXRpb24gQXV0aG9yaXR5MSQwIgYDVQQDExtDZXJ0dW0gVHJ1c3RlZCBOZXR3
+b3JrIENBIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9+Xj45tWA
+DGSdhhuWZGc/IjoedQF97/tcZ4zJzFxrqZHmuULlIEub2pt7uZld2ZuAS9eEQCsn
+0+i6MLs+CRqnSZXvK0AkwpfHp+6bJe+oCgCXhVqqndwpyeI1B+twTUrWwbNWuKFB
+OJvR+zF/j+Bf4bE/D44WSWDXBo0Y+aomEKsq09DRZ40bRr5HMNUuctHFY9rnY3lE
+fktjJImGLjQ/KUxSiyqnwOKRKIm5wFv5HdnnJ63/mgKXwcZQkpsCLL2puTRZCr+E
+Sv/f/rOf69me4Jgj7KZrdxYq28ytOxykh9xGc14ZYmhFV+SQgkK7QtbwYeDBoz1m
+o130GO6IyY0XRSmZMnUCMe4pJshrAua1YkV/NxVaI2iJ1D7eTiew8EAMvE0Xy02i
+sx7QBlrd9pPPV3WZ9fqGGmd4s7+W/jTcvedSVuWz5XV710GRBdxdaeOVDUO5/IOW
+OZV7bIBaTxNyxtd9KXpEulKkKtVBRgkg/iKgtlswjbyJDNXXcPiHUv3a76xRLgez
+Tv7QCdpw75j6VuZt27VXS9zlLCUVyJ4ueE742pyehizKV/Ma5ciSixqClnrDvFAS
+adgOWkaLOusm+iPJtrCBvkIApPjW/jAux9JG9uWOdf3yzLnQh1vMBhBgu4M1t15n
+3kfsmUjxpKEV/q2MYo45VU85FrmxY53/twIDAQABo0IwQDAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBS2oVQ5AsOgP46KvPrU+Bym0ToO/TAOBgNVHQ8BAf8EBAMC
+AQYwDQYJKoZIhvcNAQENBQADggIBAHGlDs7k6b8/ONWJWsQCYftMxRQXLYtPU2sQ
+F/xlhMcQSZDe28cmk4gmb3DWAl45oPePq5a1pRNcgRRtDoGCERuKTsZPpd1iHkTf
+CVn0W3cLN+mLIMb4Ck4uWBzrM9DPhmDJ2vuAL55MYIR4PSFk1vtBHxgP58l1cb29
+XN40hz5BsA72udY/CROWFC/emh1auVbONTqwX3BNXuMp8SMoclm2q8KMZiYcdywm
+djWLKKdpoPk79SPdhRB0yZADVpHnr7pH1BKXESLjokmUbOe3lEu6LaTaM4tMpkT/
+WjzGHWTYtTHkpjx6qFcL2+1hGsvxznN3Y6SHb0xRONbkX8eftoEq5IVIeVheO/jb
+AoJnwTnbw3RLPTYe+SmTiGhbqEQZIfCn6IENLOiTNrQ3ssqwGyZ6miUfmpqAnksq
+P/ujmv5zMnHCnsZy4YpoJ/HkD7TETKVhk/iXEAcqMCWpuchxuO9ozC1+9eB+D4Ko
+b7a6bINDd82Kkhehnlt4Fj1F4jNy3eFmypnTycUm/Q1oBEauttmbjL4ZvrHG8hnj
+XALKLNhvSgfZyTXaQHXyxKcZb55CEJh15pWLYLztxRLXis7VmFxWlgPF7ncGNf/P
+5O4/E2Hu29othfDNrp2yGAlFw5Khchf8R7agCyzxxN5DaAhqXzvwdmP7zAYspsbi
+DrW5viSP
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: ca:ff:e2:db:03:d9:cb:4b:e9:0f:ad:84:fd:7b:18:ce
+# SHA1 Fingerprint: 01:0c:06:95:a6:98:19:14:ff:bf:5f:c6:b0:b6:95:ea:29:e9:12:a6
+# SHA256 Fingerprint: a0:40:92:9a:02:ce:53:b4:ac:f4:f2:ff:c6:98:1c:e4:49:6f:75:5e:6d:45:fe:0b:2a:69:2b:cd:52:52:3f:36
+-----BEGIN CERTIFICATE-----
+MIIGCzCCA/OgAwIBAgIBADANBgkqhkiG9w0BAQsFADCBpjELMAkGA1UEBhMCR1Ix
+DzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5k
+IFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxQDA+BgNVBAMT
+N0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgUm9v
+dENBIDIwMTUwHhcNMTUwNzA3MTAxMTIxWhcNNDAwNjMwMTAxMTIxWjCBpjELMAkG
+A1UEBhMCR1IxDzANBgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNh
+ZGVtaWMgYW5kIFJlc2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkx
+QDA+BgNVBAMTN0hlbGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1
+dGlvbnMgUm9vdENBIDIwMTUwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC
+AQDC+Kk/G4n8PDwEXT2QNrCROnk8ZlrvbTkBSRq0t89/TSNTt5AA4xMqKKYx8ZEA
+4yjsriFBzh/a/X0SWwGDD7mwX5nh8hKDgE0GPt+sr+ehiGsxr/CL0BgzuNtFajT0
+AoAkKAoCFZVedioNmToUW/bLy1O8E00BiDeUJRtCvCLYjqOWXjrZMts+6PAQZe10
+4S+nfK8nNLspfZu2zwnI5dMK/IhlZXQK3HMcXM1AsRzUtoSMTFDPaI6oWa7CJ06C
+ojXdFPQf/7J31Ycvqm59JCfnxssm5uX+Zwdj2EUN3TpZZTlYepKZcj2chF6IIbjV
+9Cz82XBST3i4vTwri5WY9bPRaM8gFH5MXF/ni+X1NYEZN9cRCLdmvtNKzoNXADrD
+gfgXy5I2XdGj2HUb4Ysn6npIQf1FGQatJ5lOwXBH3bWfgVMS5bGMSF0xQxfjjMZ6
+Y5ZLKTBOhE5iGV48zpeQpX8B653g+IuJ3SWYPZK2fu/Z8VFRfS0myGlZYeCsargq
+NhEEelC9MoS+L9xy1dcdFkfkR2YgP/SWxa+OAXqlD3pk9Q0Yh9muiNX6hME6wGko
+LfINaFGq46V3xqSQDqE3izEjR8EJCOtu93ib14L8hCCZSRm2Ekax+0VVFqmjZayc
+Bw/qa9wfLgZy7IaIEuQt218FL+TwA9MmM+eAws1CoRc0CwIDAQABo0IwQDAPBgNV
+HRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNVHQ4EFgQUcRVnyMjJvXVd
+ctA4GGqd83EkVAswDQYJKoZIhvcNAQELBQADggIBAHW7bVRLqhBYRjTyYtcWNl0I
+XtVsyIe9tC5G8jH4fOpCtZMWVdyhDBKg2mF+D1hYc2Ryx+hFjtyp8iY/xnmMsVMI
+M4GwVhO+5lFc2JsKT0ucVlMC6U/2DWDqTUJV6HwbISHTGzrMd/K4kPFox/la/vot
+9L/J9UUbzjgQKjeKeaO04wlshYaT/4mWJ3iBj2fjRnRUjtkNaeJK9E10A/+yd+2V
+Z5fkscWrv2oj6NSU4kQoYsRL4vDY4ilrGnB+JGGTe08DMiUNRSQrlrRGar9KC/ea
+j8GsGsVn82800vpzY4zvFrCopEYq+OsS7HK07/grfoxSwIuEVPkvPuNVqNxmsdnh
+X9izjFk0WaSrT2y7HxjbdavYy5LNlDhhDgcGH0tGEPEVvo2FXDtKK4F5D7Rpn0lQ
+l033DlZdwJVqwjbDG2jJ9SrcR5q+ss7FJej6A7na+RZukYT1HCjI/CbM1xyQVqdf
+bzoEvM14iQuODy+jqk+iGxI9FghAD/FGTNeqewjBCvVtJ94Cj8rDtSvK6evIIVM4
+pcw72Hc3MKJP2W/R8kCtQXoXxdZKNYm3QdV8hn9VTYNKpXMgwDqvkPGaJI7ZjnHK
+e7iG2rKPmT4dEw0SEe7Uq/DpFXYC5ODfqiAeW2GFZECpkJcNrVPSWh2HagCXZWK0
+vm9qp/UsQu0yrbYhnr68
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Subject: CN=Hellenic Academic and Research Institutions ECC RootCA 2015 O=Hellenic Academic and Research Institutions Cert. Authority
+# Label: "Hellenic Academic and Research Institutions ECC RootCA 2015"
+# Serial: 0
+# MD5 Fingerprint: 81:e5:b4:17:eb:c2:f5:e1:4b:0d:41:7b:49:92:fe:ef
+# SHA1 Fingerprint: 9f:f1:71:8d:92:d5:9a:f3:7d:74:97:b4:bc:6f:84:68:0b:ba:b6:66
+# SHA256 Fingerprint: 44:b5:45:aa:8a:25:e6:5a:73:ca:15:dc:27:fc:36:d2:4c:1c:b9:95:3a:06:65:39:b1:15:82:dc:48:7b:48:33
+-----BEGIN CERTIFICATE-----
+MIICwzCCAkqgAwIBAgIBADAKBggqhkjOPQQDAjCBqjELMAkGA1UEBhMCR1IxDzAN
+BgNVBAcTBkF0aGVuczFEMEIGA1UEChM7SGVsbGVuaWMgQWNhZGVtaWMgYW5kIFJl
+c2VhcmNoIEluc3RpdHV0aW9ucyBDZXJ0LiBBdXRob3JpdHkxRDBCBgNVBAMTO0hl
+bGxlbmljIEFjYWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgRUNDIFJv
+b3RDQSAyMDE1MB4XDTE1MDcwNzEwMzcxMloXDTQwMDYzMDEwMzcxMlowgaoxCzAJ
+BgNVBAYTAkdSMQ8wDQYDVQQHEwZBdGhlbnMxRDBCBgNVBAoTO0hlbGxlbmljIEFj
+YWRlbWljIGFuZCBSZXNlYXJjaCBJbnN0aXR1dGlvbnMgQ2VydC4gQXV0aG9yaXR5
+MUQwQgYDVQQDEztIZWxsZW5pYyBBY2FkZW1pYyBhbmQgUmVzZWFyY2ggSW5zdGl0
+dXRpb25zIEVDQyBSb290Q0EgMjAxNTB2MBAGByqGSM49AgEGBSuBBAAiA2IABJKg
+QehLgoRc4vgxEZmGZE4JJS+dQS8KrjVPdJWyUWRrjWvmP3CV8AVER6ZyOFB2lQJa
+jq4onvktTpnvLEhvTCUp6NFxW98dwXU3tNf6e3pCnGoKVlp8aQuqgAkkbH7BRqNC
+MEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFLQi
+C4KZJAEOnLvkDv2/+5cgk5kqMAoGCCqGSM49BAMCA2cAMGQCMGfOFmI4oqxiRaep
+lSTAGiecMjvAwNW6qef4BENThe5SId6d9SWDPp5YSy/XZxMOIQIwBeF1Ad5o7Sof
+TUwJCA3sS61kFyjndc5FZXIhF8siQQ6ME5g4mlRtm8rifOoCWCKR
+-----END CERTIFICATE-----
+
+# Issuer: CN=ISRG Root X1 O=Internet Security Research Group
+# Subject: CN=ISRG Root X1 O=Internet Security Research Group
+# Label: "ISRG Root X1"
+# Serial: 172886928669790476064670243504169061120
+# MD5 Fingerprint: 0c:d2:f9:e0:da:17:73:e9:ed:86:4d:a5:e3:70:e7:4e
+# SHA1 Fingerprint: ca:bd:2a:79:a1:07:6a:31:f2:1d:25:36:35:cb:03:9d:43:29:a5:e8
+# SHA256 Fingerprint: 96:bc:ec:06:26:49:76:f3:74:60:77:9a:cf:28:c5:a7:cf:e8:a3:c0:aa:e1:1a:8f:fc:ee:05:c0:bd:df:08:c6
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----
+
+# Issuer: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Subject: O=FNMT-RCM OU=AC RAIZ FNMT-RCM
+# Label: "AC RAIZ FNMT-RCM"
+# Serial: 485876308206448804701554682760554759
+# MD5 Fingerprint: e2:09:04:b4:d3:bd:d1:a0:14:fd:1a:d2:47:c4:57:1d
+# SHA1 Fingerprint: ec:50:35:07:b2:15:c4:95:62:19:e2:a8:9a:5b:42:99:2c:4c:2c:20
+# SHA256 Fingerprint: eb:c5:57:0c:29:01:8c:4d:67:b1:aa:12:7b:af:12:f7:03:b4:61:1e:bc:17:b7:da:b5:57:38:94:17:9b:93:fa
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIPXZONMGc2yAYdGsdUhGkHMA0GCSqGSIb3DQEBCwUAMDsx
+CzAJBgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJ
+WiBGTk1ULVJDTTAeFw0wODEwMjkxNTU5NTZaFw0zMDAxMDEwMDAwMDBaMDsxCzAJ
+BgNVBAYTAkVTMREwDwYDVQQKDAhGTk1ULVJDTTEZMBcGA1UECwwQQUMgUkFJWiBG
+Tk1ULVJDTTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALpxgHpMhm5/
+yBNtwMZ9HACXjywMI7sQmkCpGreHiPibVmr75nuOi5KOpyVdWRHbNi63URcfqQgf
+BBckWKo3Shjf5TnUV/3XwSyRAZHiItQDwFj8d0fsjz50Q7qsNI1NOHZnjrDIbzAz
+WHFctPVrbtQBULgTfmxKo0nRIBnuvMApGGWn3v7v3QqQIecaZ5JCEJhfTzC8PhxF
+tBDXaEAUwED653cXeuYLj2VbPNmaUtu1vZ5Gzz3rkQUCwJaydkxNEJY7kvqcfw+Z
+374jNUUeAlz+taibmSXaXvMiwzn15Cou08YfxGyqxRxqAQVKL9LFwag0Jl1mpdIC
+IfkYtwb1TplvqKtMUejPUBjFd8g5CSxJkjKZqLsXF3mwWsXmo8RZZUc1g16p6DUL
+mbvkzSDGm0oGObVo/CK67lWMK07q87Hj/LaZmtVC+nFNCM+HHmpxffnTtOmlcYF7
+wk5HlqX2doWjKI/pgG6BU6VtX7hI+cL5NqYuSf+4lsKMB7ObiFj86xsc3i1w4peS
+MKGJ47xVqCfWS+2QrYv6YyVZLag13cqXM7zlzced0ezvXg5KkAYmY6252TUtB7p2
+ZSysV4999AeU14ECll2jB0nVetBX+RvnU0Z1qrB5QstocQjpYL05ac70r8NWQMet
+UqIJ5G+GR4of6ygnXYMgrwTJbFaai0b1AgMBAAGjgYMwgYAwDwYDVR0TAQH/BAUw
+AwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYEFPd9xf3E6Jobd2Sn9R2gzL+H
+YJptMD4GA1UdIAQ3MDUwMwYEVR0gADArMCkGCCsGAQUFBwIBFh1odHRwOi8vd3d3
+LmNlcnQuZm5tdC5lcy9kcGNzLzANBgkqhkiG9w0BAQsFAAOCAgEAB5BK3/MjTvDD
+nFFlm5wioooMhfNzKWtN/gHiqQxjAb8EZ6WdmF/9ARP67Jpi6Yb+tmLSbkyU+8B1
+RXxlDPiyN8+sD8+Nb/kZ94/sHvJwnvDKuO+3/3Y3dlv2bojzr2IyIpMNOmqOFGYM
+LVN0V2Ue1bLdI4E7pWYjJ2cJj+F3qkPNZVEI7VFY/uY5+ctHhKQV8Xa7pO6kO8Rf
+77IzlhEYt8llvhjho6Tc+hj507wTmzl6NLrTQfv6MooqtyuGC2mDOL7Nii4LcK2N
+JpLuHvUBKwrZ1pebbuCoGRw6IYsMHkCtA+fdZn71uSANA+iW+YJF1DngoABd15jm
+fZ5nc8OaKveri6E6FO80vFIOiZiaBECEHX5FaZNXzuvO+FB8TxxuBEOb+dY7Ixjp
+6o7RTUaN8Tvkasq6+yO3m/qZASlaWFot4/nUbQ4mrcFuNLwy+AwF+mWj2zs3gyLp
+1txyM/1d8iC9djwj2ij3+RvrWWTV3F9yfiD8zYm1kGdNYno/Tq0dwzn+evQoFt9B
+9kiABdcPUXmsEKvU7ANm5mqwujGSQkBqvjrTcuFqN1W8rB2Vt2lh8kORdOag0wok
+RqEIr9baRRmW1FMdW4R58MD3R++Lj8UGrp1MYp3/RgT408m2ECVAdf4WqslKYIYv
+uu8wd+RU4riEmViAqhOLUTpPSPaLtrM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 1 O=Amazon
+# Subject: CN=Amazon Root CA 1 O=Amazon
+# Label: "Amazon Root CA 1"
+# Serial: 143266978916655856878034712317230054538369994
+# MD5 Fingerprint: 43:c6:bf:ae:ec:fe:ad:2f:18:c6:88:68:30:fc:c8:e6
+# SHA1 Fingerprint: 8d:a7:f9:65:ec:5e:fc:37:91:0f:1c:6e:59:fd:c1:cc:6a:6e:de:16
+# SHA256 Fingerprint: 8e:cd:e6:88:4f:3d:87:b1:12:5b:a3:1a:c3:fc:b1:3d:70:16:de:7f:57:cc:90:4f:e1:cb:97:c6:ae:98:19:6e
+-----BEGIN CERTIFICATE-----
+MIIDQTCCAimgAwIBAgITBmyfz5m/jAo54vB4ikPmljZbyjANBgkqhkiG9w0BAQsF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAxMB4XDTE1MDUyNjAwMDAwMFoXDTM4MDExNzAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALJ4gHHKeNXj
+ca9HgFB0fW7Y14h29Jlo91ghYPl0hAEvrAIthtOgQ3pOsqTQNroBvo3bSMgHFzZM
+9O6II8c+6zf1tRn4SWiw3te5djgdYZ6k/oI2peVKVuRF4fn9tBb6dNqcmzU5L/qw
+IFAGbHrQgLKm+a/sRxmPUDgH3KKHOVj4utWp+UhnMJbulHheb4mjUcAwhmahRWa6
+VOujw5H5SNz/0egwLX0tdHA114gk957EWW67c4cX8jJGKLhD+rcdqsq08p8kDi1L
+93FcXmn/6pUCyziKrlA4b9v7LWIbxcceVOF34GfID5yHI9Y/QCB/IIDEgEw+OyQm
+jgSubJrIqg0CAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMC
+AYYwHQYDVR0OBBYEFIQYzIU07LwMlJQuCFmcx7IQTgoIMA0GCSqGSIb3DQEBCwUA
+A4IBAQCY8jdaQZChGsV2USggNiMOruYou6r4lK5IpDB/G/wkjUu0yKGX9rbxenDI
+U5PMCCjjmCXPI6T53iHTfIUJrU6adTrCC2qJeHZERxhlbI1Bjjt/msv0tadQ1wUs
+N+gDS63pYaACbvXy8MWy7Vu33PqUXHeeE6V/Uq2V8viTO96LXFvKWlJbYK8U90vv
+o/ufQJVtMVT8QtPHRh8jrdkPSHCa2XV4cdFyQzR1bldZwgJcJmApzyMZFo6IQ6XU
+5MsI+yMRQ+hDKXJioaldXgjUkK642M4UwtBV8ob2xJNDd2ZhwLnoQdeXeGADbkpy
+rqXRfboQnoZsG4q5WTP468SQvvG5
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 2 O=Amazon
+# Subject: CN=Amazon Root CA 2 O=Amazon
+# Label: "Amazon Root CA 2"
+# Serial: 143266982885963551818349160658925006970653239
+# MD5 Fingerprint: c8:e5:8d:ce:a8:42:e2:7a:c0:2a:5c:7c:9e:26:bf:66
+# SHA1 Fingerprint: 5a:8c:ef:45:d7:a6:98:59:76:7a:8c:8b:44:96:b5:78:cf:47:4b:1a
+# SHA256 Fingerprint: 1b:a5:b2:aa:8c:65:40:1a:82:96:01:18:f8:0b:ec:4f:62:30:4d:83:ce:c4:71:3a:19:c3:9c:01:1e:a4:6d:b4
+-----BEGIN CERTIFICATE-----
+MIIFQTCCAymgAwIBAgITBmyf0pY1hp8KD+WGePhbJruKNzANBgkqhkiG9w0BAQwF
+ADA5MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6
+b24gUm9vdCBDQSAyMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTEL
+MAkGA1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJv
+b3QgQ0EgMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK2Wny2cSkxK
+gXlRmeyKy2tgURO8TW0G/LAIjd0ZEGrHJgw12MBvIITplLGbhQPDW9tK6Mj4kHbZ
+W0/jTOgGNk3Mmqw9DJArktQGGWCsN0R5hYGCrVo34A3MnaZMUnbqQ523BNFQ9lXg
+1dKmSYXpN+nKfq5clU1Imj+uIFptiJXZNLhSGkOQsL9sBbm2eLfq0OQ6PBJTYv9K
+8nu+NQWpEjTj82R0Yiw9AElaKP4yRLuH3WUnAnE72kr3H9rN9yFVkE8P7K6C4Z9r
+2UXTu/Bfh+08LDmG2j/e7HJV63mjrdvdfLC6HM783k81ds8P+HgfajZRRidhW+me
+z/CiVX18JYpvL7TFz4QuK/0NURBs+18bvBt+xa47mAExkv8LV/SasrlX6avvDXbR
+8O70zoan4G7ptGmh32n2M8ZpLpcTnqWHsFcQgTfJU7O7f/aS0ZzQGPSSbtqDT6Zj
+mUyl+17vIWR6IF9sZIUVyzfpYgwLKhbcAS4y2j5L9Z469hdAlO+ekQiG+r5jqFoz
+7Mt0Q5X5bGlSNscpb/xVA1wf+5+9R+vnSUeVC06JIglJ4PVhHvG/LopyboBZ/1c6
++XUyo05f7O0oYtlNc/LMgRdg7c3r3NunysV+Ar3yVAhU/bQtCSwXVEqY0VThUWcI
+0u1ufm8/0i2BWSlmy5A5lREedCf+3euvAgMBAAGjQjBAMA8GA1UdEwEB/wQFMAMB
+Af8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSwDPBMMPQFWAJI/TPlUq9LhONm
+UjANBgkqhkiG9w0BAQwFAAOCAgEAqqiAjw54o+Ci1M3m9Zh6O+oAA7CXDpO8Wqj2
+LIxyh6mx/H9z/WNxeKWHWc8w4Q0QshNabYL1auaAn6AFC2jkR2vHat+2/XcycuUY
++gn0oJMsXdKMdYV2ZZAMA3m3MSNjrXiDCYZohMr/+c8mmpJ5581LxedhpxfL86kS
+k5Nrp+gvU5LEYFiwzAJRGFuFjWJZY7attN6a+yb3ACfAXVU3dJnJUH/jWS5E4ywl
+7uxMMne0nxrpS10gxdr9HIcWxkPo1LsmmkVwXqkLN1PiRnsn/eBG8om3zEK2yygm
+btmlyTrIQRNg91CMFa6ybRoVGld45pIq2WWQgj9sAq+uEjonljYE1x2igGOpm/Hl
+urR8FLBOybEfdF849lHqm/osohHUqS0nGkWxr7JOcQ3AWEbWaQbLU8uz/mtBzUF+
+fUwPfHJ5elnNXkoOrJupmHN5fLT0zLm4BwyydFy4x2+IoZCn9Kr5v2c69BoVYh63
+n749sSmvZ6ES8lgQGVMDMBu4Gon2nL2XA46jCfMdiyHxtN/kHNGfZQIG6lzWE7OE
+76KlXIx3KadowGuuQNKotOrN8I1LOJwZmhsoVLiJkO/KdYE+HvJkJMcYr07/R54H
+9jVlpNMKVv/1F2Rs76giJUmTtt8AF9pYfl3uxRuw0dFfIRDH+fO6AgonB8Xx1sfT
+4PsJYGw=
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 3 O=Amazon
+# Subject: CN=Amazon Root CA 3 O=Amazon
+# Label: "Amazon Root CA 3"
+# Serial: 143266986699090766294700635381230934788665930
+# MD5 Fingerprint: a0:d4:ef:0b:f7:b5:d8:49:95:2a:ec:f5:c4:fc:81:87
+# SHA1 Fingerprint: 0d:44:dd:8c:3c:8c:1a:1a:58:75:64:81:e9:0f:2e:2a:ff:b3:d2:6e
+# SHA256 Fingerprint: 18:ce:6c:fe:7b:f1:4e:60:b2:e3:47:b8:df:e8:68:cb:31:d0:2e:bb:3a:da:27:15:69:f5:03:43:b4:6d:b3:a4
+-----BEGIN CERTIFICATE-----
+MIIBtjCCAVugAwIBAgITBmyf1XSXNmY/Owua2eiedgPySjAKBggqhkjOPQQDAjA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSAzMB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgMzBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABCmXp8ZBf8ANm+gBG1bG8lKl
+ui2yEujSLtf6ycXYqm0fc4E7O5hrOXwzpcVOho6AF2hiRVd9RFgdszflZwjrZt6j
+QjBAMA8GA1UdEwEB/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMB0GA1UdDgQWBBSr
+ttvXBp43rDCGB5Fwx5zEGbF4wDAKBggqhkjOPQQDAgNJADBGAiEA4IWSoxe3jfkr
+BqWTrBqYaGFy+uGh0PsceGCmQ5nFuMQCIQCcAu/xlJyzlvnrxir4tiz+OpAUFteM
+YyRIHN8wfdVoOw==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Amazon Root CA 4 O=Amazon
+# Subject: CN=Amazon Root CA 4 O=Amazon
+# Label: "Amazon Root CA 4"
+# Serial: 143266989758080763974105200630763877849284878
+# MD5 Fingerprint: 89:bc:27:d5:eb:17:8d:06:6a:69:d5:fd:89:47:b4:cd
+# SHA1 Fingerprint: f6:10:84:07:d6:f8:bb:67:98:0c:c2:e2:44:c2:eb:ae:1c:ef:63:be
+# SHA256 Fingerprint: e3:5d:28:41:9e:d0:20:25:cf:a6:90:38:cd:62:39:62:45:8d:a5:c6:95:fb:de:a3:c2:2b:0b:fb:25:89:70:92
+-----BEGIN CERTIFICATE-----
+MIIB8jCCAXigAwIBAgITBmyf18G7EEwpQ+Vxe3ssyBrBDjAKBggqhkjOPQQDAzA5
+MQswCQYDVQQGEwJVUzEPMA0GA1UEChMGQW1hem9uMRkwFwYDVQQDExBBbWF6b24g
+Um9vdCBDQSA0MB4XDTE1MDUyNjAwMDAwMFoXDTQwMDUyNjAwMDAwMFowOTELMAkG
+A1UEBhMCVVMxDzANBgNVBAoTBkFtYXpvbjEZMBcGA1UEAxMQQW1hem9uIFJvb3Qg
+Q0EgNDB2MBAGByqGSM49AgEGBSuBBAAiA2IABNKrijdPo1MN/sGKe0uoe0ZLY7Bi
+9i0b2whxIdIA6GO9mif78DluXeo9pcmBqqNbIJhFXRbb/egQbeOc4OO9X4Ri83Bk
+M6DLJC9wuoihKqB1+IGuYgbEgds5bimwHvouXKNCMEAwDwYDVR0TAQH/BAUwAwEB
+/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0OBBYEFNPsxzplbszh2naaVvuc84ZtV+WB
+MAoGCCqGSM49BAMDA2gAMGUCMDqLIfG9fhGt0O9Yli/W651+kI0rz2ZVwyzjKKlw
+CkcO8DdZEv8tmZQoTipPNU0zWgIxAOp1AE47xDqUEpHJWEadIRNyp4iciuRMStuW
+1KyLa2tJElMzrdfkviT8tQp21KW8EA==
+-----END CERTIFICATE-----
+
+# Issuer: CN=LuxTrust Global Root 2 O=LuxTrust S.A.
+# Subject: CN=LuxTrust Global Root 2 O=LuxTrust S.A.
+# Label: "LuxTrust Global Root 2"
+# Serial: 59914338225734147123941058376788110305822489521
+# MD5 Fingerprint: b2:e1:09:00:61:af:f7:f1:91:6f:c4:ad:8d:5e:3b:7c
+# SHA1 Fingerprint: 1e:0e:56:19:0a:d1:8b:25:98:b2:04:44:ff:66:8a:04:17:99:5f:3f
+# SHA256 Fingerprint: 54:45:5f:71:29:c2:0b:14:47:c4:18:f9:97:16:8f:24:c5:8f:c5:02:3b:f5:da:5b:e2:eb:6e:1d:d8:90:2e:d5
+-----BEGIN CERTIFICATE-----
+MIIFwzCCA6ugAwIBAgIUCn6m30tEntpqJIWe5rgV0xZ/u7EwDQYJKoZIhvcNAQEL
+BQAwRjELMAkGA1UEBhMCTFUxFjAUBgNVBAoMDUx1eFRydXN0IFMuQS4xHzAdBgNV
+BAMMFkx1eFRydXN0IEdsb2JhbCBSb290IDIwHhcNMTUwMzA1MTMyMTU3WhcNMzUw
+MzA1MTMyMTU3WjBGMQswCQYDVQQGEwJMVTEWMBQGA1UECgwNTHV4VHJ1c3QgUy5B
+LjEfMB0GA1UEAwwWTHV4VHJ1c3QgR2xvYmFsIFJvb3QgMjCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBANeFl78RmOnwYoNMPIf5U2o3C/IPPIfOb9wmKb3F
+ibrJgz337spbxm1Jc7TJRqMbNBM/wYlFV/TZsfs2ZUv7COJIcRHIbjuend+JZTem
+hfY7RBi2xjcwYkSSl2l9QjAk5A0MiWtj3sXh306pFGxT4GHO9hcvHTy95iJMHZP1
+EMShduxq3sVs35a0VkBCwGKSMKEtFZSg0iAGCW5qbeXrt77U8PEVfIvmTroTzEsn
+Xpk8F12PgX8zPU/TPxvsXD/wPEx1bvKm1Z3aLQdjAsZy6ZS8TEmVT4hSyNvoaYL4
+zDRbIvCGp4m9SAptZoFtyMhk+wHh9OHe2Z7d21vUKpkmFRseTJIpgp7VkoGSQXAZ
+96Tlk0u8d2cx3Rz9MXANF5kM+Qw5GSoXtTBxVdUPrljhPS80m8+f9niFwpN6cj5m
+j5wWEWCPnolvZ77gR1o7DJpni89Gxq44o/KnvObWhWszJHAiS8sIm7vI+AIpHb4g
+DEa/a4ebsypmQjVGbKq6rfmYe+lQVRQxv7HaLe2ArWgk+2mr2HETMOZns4dA/Yl+
+8kPREd8vZS9kzl8UubG/Mb2HeFpZZYiq/FkySIbWTLkpS5XTdvN3JW1CHDiDTf2j
+X5t/Lax5Gw5CMZdjpPuKadUiDTSQMC6otOBttpSsvItO13D8xTiOZCXhTTmQzsmH
+hFhxAgMBAAGjgagwgaUwDwYDVR0TAQH/BAUwAwEB/zBCBgNVHSAEOzA5MDcGByuB
+KwEBAQowLDAqBggrBgEFBQcCARYeaHR0cHM6Ly9yZXBvc2l0b3J5Lmx1eHRydXN0
+Lmx1MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBT/GCh2+UgFLKGu8SsbK7JT
++Et8szAdBgNVHQ4EFgQU/xgodvlIBSyhrvErGyuyU/hLfLMwDQYJKoZIhvcNAQEL
+BQADggIBAGoZFO1uecEsh9QNcH7X9njJCwROxLHOk3D+sFTAMs2ZMGQXvw/l4jP9
+BzZAcg4atmpZ1gDlaCDdLnINH2pkMSCEfUmmWjfrRcmF9dTHF5kH5ptV5AzoqbTO
+jFu1EVzPig4N1qx3gf4ynCSecs5U89BvolbW7MM3LGVYvlcAGvI1+ut7MV3CwRI9
+loGIlonBWVx65n9wNOeD4rHh4bhY79SV5GCc8JaXcozrhAIuZY+kt9J/Z93I055c
+qqmkoCUUBpvsT34tC38ddfEz2O3OuHVtPlu5mB0xDVbYQw8wkbIEa91WvpWAVWe+
+2M2D2RjuLg+GLZKecBPs3lHJQ3gCpU3I+V/EkVhGFndadKpAvAefMLmx9xIX3eP/
+JEAdemrRTxgKqpAd60Ae36EeRJIQmvKN4dFLRp7oRUKX6kWZ8+xm1QL68qZKJKre
+zrnK+T+Tb/mjuuqlPpmt/f97mfVl7vBZKGfXkJWkE4SphMHozs51k2MavDzq1WQf
+LSoSOcbDWjLtR5EWDrw4wVDej8oqkDQc7kGUnF4ZLvhFSZl0kbAEb+MEWrGrKqv+
+x9CWttrhSmQGbmBNvUJO/3jaJMobtNeWOWyu8Q6qp31IiyBMz2TWuJdGsE7RKlY6
+oJO9r4Ak4Ap+58rVyuiFVdw2KuGUaJPHZnJED4AhMmwlxyOAgwrr
+-----END CERTIFICATE-----
+
+# Issuer: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Subject: CN=TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1 O=Turkiye Bilimsel ve Teknolojik Arastirma Kurumu - TUBITAK OU=Kamu Sertifikasyon Merkezi - Kamu SM
+# Label: "TUBITAK Kamu SM SSL Kok Sertifikasi - Surum 1"
+# Serial: 1
+# MD5 Fingerprint: dc:00:81:dc:69:2f:3e:2f:b0:3b:f6:3d:5a:91:8e:49
+# SHA1 Fingerprint: 31:43:64:9b:ec:ce:27:ec:ed:3a:3f:0b:8f:0d:e4:e8:91:dd:ee:ca
+# SHA256 Fingerprint: 46:ed:c3:68:90:46:d5:3a:45:3f:b3:10:4a:b8:0d:ca:ec:65:8b:26:60:ea:16:29:dd:7e:86:79:90:64:87:16
+-----BEGIN CERTIFICATE-----
+MIIEYzCCA0ugAwIBAgIBATANBgkqhkiG9w0BAQsFADCB0jELMAkGA1UEBhMCVFIx
+GDAWBgNVBAcTD0dlYnplIC0gS29jYWVsaTFCMEAGA1UEChM5VHVya2l5ZSBCaWxp
+bXNlbCB2ZSBUZWtub2xvamlrIEFyYXN0aXJtYSBLdXJ1bXUgLSBUVUJJVEFLMS0w
+KwYDVQQLEyRLYW11IFNlcnRpZmlrYXN5b24gTWVya2V6aSAtIEthbXUgU00xNjA0
+BgNVBAMTLVRVQklUQUsgS2FtdSBTTSBTU0wgS29rIFNlcnRpZmlrYXNpIC0gU3Vy
+dW0gMTAeFw0xMzExMjUwODI1NTVaFw00MzEwMjUwODI1NTVaMIHSMQswCQYDVQQG
+EwJUUjEYMBYGA1UEBxMPR2ViemUgLSBLb2NhZWxpMUIwQAYDVQQKEzlUdXJraXll
+IEJpbGltc2VsIHZlIFRla25vbG9qaWsgQXJhc3Rpcm1hIEt1cnVtdSAtIFRVQklU
+QUsxLTArBgNVBAsTJEthbXUgU2VydGlmaWthc3lvbiBNZXJrZXppIC0gS2FtdSBT
+TTE2MDQGA1UEAxMtVFVCSVRBSyBLYW11IFNNIFNTTCBLb2sgU2VydGlmaWthc2kg
+LSBTdXJ1bSAxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAr3UwM6q7
+a9OZLBI3hNmNe5eA027n/5tQlT6QlVZC1xl8JoSNkvoBHToP4mQ4t4y86Ij5iySr
+LqP1N+RAjhgleYN1Hzv/bKjFxlb4tO2KRKOrbEz8HdDc72i9z+SqzvBV96I01INr
+N3wcwv61A+xXzry0tcXtAA9TNypN9E8Mg/uGz8v+jE69h/mniyFXnHrfA2eJLJ2X
+YacQuFWQfw4tJzh03+f92k4S400VIgLI4OD8D62K18lUUMw7D8oWgITQUVbDjlZ/
+iSIzL+aFCr2lqBs23tPcLG07xxO9WSMs5uWk99gL7eqQQESolbuT1dCANLZGeA4f
+AJNG4e7p+exPFwIDAQABo0IwQDAdBgNVHQ4EFgQUZT/HiobGPN08VFw1+DrtUgxH
+V8gwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBACo/4fEyjq7hmFxLXs9rHmoJ0iKpEsdeV31zVmSAhHqT5Am5EM2fKifh
+AHe+SMg1qIGf5LgsyX8OsNJLN13qudULXjS99HMpw+0mFZx+CFOKWI3QSyjfwbPf
+IPP54+M638yclNhOT8NrF7f3cuitZjO1JVOr4PhMqZ398g26rrnZqsZr+ZO7rqu4
+lzwDGrpDxpa5RXI4s6ehlj2Re37AIVNMh+3yC1SVUZPVIqUNivGTDj5UDrDYyU7c
+8jEyVupk+eq1nRZmQnLzf9OxMUP8pI4X8W0jq5Rm+K37DwhuJi1/FwcJsoz7UMCf
+lo3Ptv0AnVoUmr8CRPXBwp8iXqIPoeM=
+-----END CERTIFICATE-----
+
+# Issuer: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Subject: CN=GDCA TrustAUTH R5 ROOT O=GUANG DONG CERTIFICATE AUTHORITY CO.,LTD.
+# Label: "GDCA TrustAUTH R5 ROOT"
+# Serial: 9009899650740120186
+# MD5 Fingerprint: 63:cc:d9:3d:34:35:5c:6f:53:a3:e2:08:70:48:1f:b4
+# SHA1 Fingerprint: 0f:36:38:5b:81:1a:25:c3:9b:31:4e:83:ca:e9:34:66:70:cc:74:b4
+# SHA256 Fingerprint: bf:ff:8f:d0:44:33:48:7d:6a:8a:a6:0c:1a:29:76:7a:9f:c2:bb:b0:5e:42:0f:71:3a:13:b9:92:89:1d:38:93
+-----BEGIN CERTIFICATE-----
+MIIFiDCCA3CgAwIBAgIIfQmX/vBH6nowDQYJKoZIhvcNAQELBQAwYjELMAkGA1UE
+BhMCQ04xMjAwBgNVBAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZ
+IENPLixMVEQuMR8wHQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMB4XDTE0
+MTEyNjA1MTMxNVoXDTQwMTIzMTE1NTk1OVowYjELMAkGA1UEBhMCQ04xMjAwBgNV
+BAoMKUdVQU5HIERPTkcgQ0VSVElGSUNBVEUgQVVUSE9SSVRZIENPLixMVEQuMR8w
+HQYDVQQDDBZHRENBIFRydXN0QVVUSCBSNSBST09UMIICIjANBgkqhkiG9w0BAQEF
+AAOCAg8AMIICCgKCAgEA2aMW8Mh0dHeb7zMNOwZ+Vfy1YI92hhJCfVZmPoiC7XJj
+Dp6L3TQsAlFRwxn9WVSEyfFrs0yw6ehGXTjGoqcuEVe6ghWinI9tsJlKCvLriXBj
+TnnEt1u9ol2x8kECK62pOqPseQrsXzrj/e+APK00mxqriCZ7VqKChh/rNYmDf1+u
+KU49tm7srsHwJ5uu4/Ts765/94Y9cnrrpftZTqfrlYwiOXnhLQiPzLyRuEH3FMEj
+qcOtmkVEs7LXLM3GKeJQEK5cy4KOFxg2fZfmiJqwTTQJ9Cy5WmYqsBebnh52nUpm
+MUHfP/vFBu8btn4aRjb3ZGM74zkYI+dndRTVdVeSN72+ahsmUPI2JgaQxXABZG12
+ZuGR224HwGGALrIuL4xwp9E7PLOR5G62xDtw8mySlwnNR30YwPO7ng/Wi64HtloP
+zgsMR6flPri9fcebNaBhlzpBdRfMK5Z3KpIhHtmVdiBnaM8Nvd/WHwlqmuLMc3Gk
+L30SgLdTMEZeS1SZD2fJpcjyIMGC7J0R38IC+xo70e0gmu9lZJIQDSri3nDxGGeC
+jGHeuLzRL5z7D9Ar7Rt2ueQ5Vfj4oR24qoAATILnsn8JuLwwoC8N9VKejveSswoA
+HQBUlwbgsQfZxw9cZX08bVlX5O2ljelAU58VS6Bx9hoh49pwBiFYFIeFd3mqgnkC
+AwEAAaNCMEAwHQYDVR0OBBYEFOLJQJ9NzuiaoXzPDj9lxSmIahlRMA8GA1UdEwEB
+/wQFMAMBAf8wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQDRSVfg
+p8xoWLoBDysZzY2wYUWsEe1jUGn4H3++Fo/9nesLqjJHdtJnJO29fDMylyrHBYZm
+DRd9FBUb1Ov9H5r2XpdptxolpAqzkT9fNqyL7FeoPueBihhXOYV0GkLH6VsTX4/5
+COmSdI31R9KrO9b7eGZONn356ZLpBN79SWP8bfsUcZNnL0dKt7n/HipzcEYwv1ry
+L3ml4Y0M2fmyYzeMN2WFcGpcWwlyua1jPLHd+PwyvzeG5LuOmCd+uh8W4XAR8gPf
+JWIyJyYYMoSf/wA6E7qaTfRPuBRwIrHKK5DOKcFw9C+df/KQHtZa37dG/OaG+svg
+IHZ6uqbL9XzeYqWxi+7egmaKTjowHz+Ay60nugxe19CxVsp3cbK1daFQqUBDF8Io
+2c9Si1vIY9RCPqAzekYu9wogRlR+ak8x8YF+QnQ4ZXMn7sZ8uI7XpTrXmKGcjBBV
+09tL7ECQ8s1uV9JiDnxXk7Gnbc2dg7sq5+W2O3FYrf3RRbxake5TFW/TRQl1brqQ
+XR4EzzffHqhmsYzmIGrv/EhOdJhCrylvLmrH+33RZjEizIYAfmaDDEL0vTSSwxrq
+T8p+ck0LcIymSLumoRT2+1hEmRSuqguTaaApJUqlyyvdimYHFngVV3Eb7PVHhPOe
+MTd61X8kreS8/f3MboPoDKi3QWwH3b08hpcv0g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor RootCert CA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor RootCert CA-1"
+# Serial: 15752444095811006489
+# MD5 Fingerprint: 6e:85:f1:dc:1a:00:d3:22:d5:b2:b2:ac:6b:37:05:45
+# SHA1 Fingerprint: ff:bd:cd:e7:82:c8:43:5e:3c:6f:26:86:5c:ca:a8:3a:45:5b:c3:0a
+# SHA256 Fingerprint: d4:0e:9c:86:cd:8f:e4:68:c1:77:69:59:f4:9e:a7:74:fa:54:86:84:b6:c4:06:f3:90:92:61:f4:dc:e2:57:5c
+-----BEGIN CERTIFICATE-----
+MIIEMDCCAxigAwIBAgIJANqb7HHzA7AZMA0GCSqGSIb3DQEBCwUAMIGkMQswCQYD
+VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
+MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
+cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRydXN0Q29y
+IFJvb3RDZXJ0IENBLTEwHhcNMTYwMjA0MTIzMjE2WhcNMjkxMjMxMTcyMzE2WjCB
+pDELMAkGA1UEBhMCUEExDzANBgNVBAgMBlBhbmFtYTEUMBIGA1UEBwwLUGFuYW1h
+IENpdHkxJDAiBgNVBAoMG1RydXN0Q29yIFN5c3RlbXMgUy4gZGUgUi5MLjEnMCUG
+A1UECwweVHJ1c3RDb3IgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MR8wHQYDVQQDDBZU
+cnVzdENvciBSb290Q2VydCBDQS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB
+CgKCAQEAv463leLCJhJrMxnHQFgKq1mqjQCj/IDHUHuO1CAmujIS2CNUSSUQIpid
+RtLByZ5OGy4sDjjzGiVoHKZaBeYei0i/mJZ0PmnK6bV4pQa81QBeCQryJ3pS/C3V
+seq0iWEk8xoT26nPUu0MJLq5nux+AHT6k61sKZKuUbS701e/s/OojZz0JEsq1pme
+9J7+wH5COucLlVPat2gOkEz7cD+PSiyU8ybdY2mplNgQTsVHCJCZGxdNuWxu72CV
+EY4hgLW9oHPY0LJ3xEXqWib7ZnZ2+AYfYW0PVcWDtxBWcgYHpfOxGgMFZA6dWorW
+hnAbJN7+KIor0Gqw/Hqi3LJ5DotlDwIDAQABo2MwYTAdBgNVHQ4EFgQU7mtJPHo/
+DeOxCbeKyKsZn3MzUOcwHwYDVR0jBBgwFoAU7mtJPHo/DeOxCbeKyKsZn3MzUOcw
+DwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQAD
+ggEBACUY1JGPE+6PHh0RU9otRCkZoB5rMZ5NDp6tPVxBb5UrJKF5mDo4Nvu7Zp5I
+/5CQ7z3UuJu0h3U/IJvOcs+hVcFNZKIZBqEHMwwLKeXx6quj7LUKdJDHfXLy11yf
+ke+Ri7fc7Waiz45mO7yfOgLgJ90WmMCV1Aqk5IGadZQ1nJBfiDcGrVmVCrDRZ9MZ
+yonnMlo2HD6CqFqTvsbQZJG2z9m2GM/bftJlo6bEjhcxwft+dtvTheNYsnd6djts
+L1Ac59v2Z3kf9YKVmgenFK+P3CghZwnS1k1aHBkcjndcw5QkPTJrS37UeJSDvjdN
+zl/HHk484IkzlQsPpTLWPFp5LBk=
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor RootCert CA-2 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor RootCert CA-2"
+# Serial: 2711694510199101698
+# MD5 Fingerprint: a2:e1:f8:18:0b:ba:45:d5:c7:41:2a:bb:37:52:45:64
+# SHA1 Fingerprint: b8:be:6d:cb:56:f1:55:b9:63:d4:12:ca:4e:06:34:c7:94:b2:1c:c0
+# SHA256 Fingerprint: 07:53:e9:40:37:8c:1b:d5:e3:83:6e:39:5d:ae:a5:cb:83:9e:50:46:f1:bd:0e:ae:19:51:cf:10:fe:c7:c9:65
+-----BEGIN CERTIFICATE-----
+MIIGLzCCBBegAwIBAgIIJaHfyjPLWQIwDQYJKoZIhvcNAQELBQAwgaQxCzAJBgNV
+BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
+IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
+dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEfMB0GA1UEAwwWVHJ1c3RDb3Ig
+Um9vdENlcnQgQ0EtMjAeFw0xNjAyMDQxMjMyMjNaFw0zNDEyMzExNzI2MzlaMIGk
+MQswCQYDVQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEg
+Q2l0eTEkMCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYD
+VQQLDB5UcnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxHzAdBgNVBAMMFlRy
+dXN0Q29yIFJvb3RDZXJ0IENBLTIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCnIG7CKqJiJJWQdsg4foDSq8GbZQWU9MEKENUCrO2fk8eHyLAnK0IMPQo+
+QVqedd2NyuCb7GgypGmSaIwLgQ5WoD4a3SwlFIIvl9NkRvRUqdw6VC0xK5mC8tkq
+1+9xALgxpL56JAfDQiDyitSSBBtlVkxs1Pu2YVpHI7TYabS3OtB0PAx1oYxOdqHp
+2yqlO/rOsP9+aij9JxzIsekp8VduZLTQwRVtDr4uDkbIXvRR/u8OYzo7cbrPb1nK
+DOObXUm4TOJXsZiKQlecdu/vvdFoqNL0Cbt3Nb4lggjEFixEIFapRBF37120Hape
+az6LMvYHL1cEksr1/p3C6eizjkxLAjHZ5DxIgif3GIJ2SDpxsROhOdUuxTTCHWKF
+3wP+TfSvPd9cW436cOGlfifHhi5qjxLGhF5DUVCcGZt45vz27Ud+ez1m7xMTiF88
+oWP7+ayHNZ/zgp6kPwqcMWmLmaSISo5uZk3vFsQPeSghYA2FFn3XVDjxklb9tTNM
+g9zXEJ9L/cb4Qr26fHMC4P99zVvh1Kxhe1fVSntb1IVYJ12/+CtgrKAmrhQhJ8Z3
+mjOAPF5GP/fDsaOGM8boXg25NSyqRsGFAnWAoOsk+xWq5Gd/bnc/9ASKL3x74xdh
+8N0JqSDIvgmk0H5Ew7IwSjiqqewYmgeCK9u4nBit2uBGF6zPXQIDAQABo2MwYTAd
+BgNVHQ4EFgQU2f4hQG6UnrybPZx9mCAZ5YwwYrIwHwYDVR0jBBgwFoAU2f4hQG6U
+nrybPZx9mCAZ5YwwYrIwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYw
+DQYJKoZIhvcNAQELBQADggIBAJ5Fngw7tu/hOsh80QA9z+LqBrWyOrsGS2h60COX
+dKcs8AjYeVrXWoSK2BKaG9l9XE1wxaX5q+WjiYndAfrs3fnpkpfbsEZC89NiqpX+
+MWcUaViQCqoL7jcjx1BRtPV+nuN79+TMQjItSQzL/0kMmx40/W5ulop5A7Zv2wnL
+/V9lFDfhOPXzYRZY5LVtDQsEGz9QLX+zx3oaFoBg+Iof6Rsqxvm6ARppv9JYx1RX
+CI/hOWB3S6xZhBqI8d3LT3jX5+EzLfzuQfogsL7L9ziUwOHQhQ+77Sxzq+3+knYa
+ZH9bDTMJBzN7Bj8RpFxwPIXAz+OQqIN3+tvmxYxoZxBnpVIt8MSZj3+/0WvitUfW
+2dCFmU2Umw9Lje4AWkcdEQOsQRivh7dvDDqPys/cA8GiCcjl/YBeyGBCARsaU1q7
+N6a3vLqE6R5sGtRk2tRD/pOLS/IseRYQ1JMLiI+h2IYURpFHmygk71dSTlxCnKr3
+Sewn6EAes6aJInKc9Q0ztFijMDvd1GpUk74aTfOTlPf8hAs/hCBcNANExdqtvArB
+As8e5ZTZ845b2EzwnexhF7sUMlQMAimTHpKG9n/v55IFDlndmQguLvqcAFLTxWYp
+5KeXRKQOKIETNcX2b2TmQcTVL8w0RSXPQQCWPUouwpaYT05KnJe32x+SMsj/D1Fu
+1uwJ
+-----END CERTIFICATE-----
+
+# Issuer: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Subject: CN=TrustCor ECA-1 O=TrustCor Systems S. de R.L. OU=TrustCor Certificate Authority
+# Label: "TrustCor ECA-1"
+# Serial: 9548242946988625984
+# MD5 Fingerprint: 27:92:23:1d:0a:f5:40:7c:e9:e6:6b:9d:d8:f5:e7:6c
+# SHA1 Fingerprint: 58:d1:df:95:95:67:6b:63:c0:f0:5b:1c:17:4d:8b:84:0b:c8:78:bd
+# SHA256 Fingerprint: 5a:88:5d:b1:9c:01:d9:12:c5:75:93:88:93:8c:af:bb:df:03:1a:b2:d4:8e:91:ee:15:58:9b:42:97:1d:03:9c
+-----BEGIN CERTIFICATE-----
+MIIEIDCCAwigAwIBAgIJAISCLF8cYtBAMA0GCSqGSIb3DQEBCwUAMIGcMQswCQYD
+VQQGEwJQQTEPMA0GA1UECAwGUGFuYW1hMRQwEgYDVQQHDAtQYW5hbWEgQ2l0eTEk
+MCIGA1UECgwbVHJ1c3RDb3IgU3lzdGVtcyBTLiBkZSBSLkwuMScwJQYDVQQLDB5U
+cnVzdENvciBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkxFzAVBgNVBAMMDlRydXN0Q29y
+IEVDQS0xMB4XDTE2MDIwNDEyMzIzM1oXDTI5MTIzMTE3MjgwN1owgZwxCzAJBgNV
+BAYTAlBBMQ8wDQYDVQQIDAZQYW5hbWExFDASBgNVBAcMC1BhbmFtYSBDaXR5MSQw
+IgYDVQQKDBtUcnVzdENvciBTeXN0ZW1zIFMuIGRlIFIuTC4xJzAlBgNVBAsMHlRy
+dXN0Q29yIENlcnRpZmljYXRlIEF1dGhvcml0eTEXMBUGA1UEAwwOVHJ1c3RDb3Ig
+RUNBLTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDPj+ARtZ+odnbb
+3w9U73NjKYKtR8aja+3+XzP4Q1HpGjORMRegdMTUpwHmspI+ap3tDvl0mEDTPwOA
+BoJA6LHip1GnHYMma6ve+heRK9jGrB6xnhkB1Zem6g23xFUfJ3zSCNV2HykVh0A5
+3ThFEXXQmqc04L/NyFIduUd+Dbi7xgz2c1cWWn5DkR9VOsZtRASqnKmcp0yJF4Ou
+owReUoCLHhIlERnXDH19MURB6tuvsBzvgdAsxZohmz3tQjtQJvLsznFhBmIhVE5/
+wZ0+fyCMgMsq2JdiyIMzkX2woloPV+g7zPIlstR8L+xNxqE6FXrntl019fZISjZF
+ZtS6mFjBAgMBAAGjYzBhMB0GA1UdDgQWBBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAf
+BgNVHSMEGDAWgBREnkj1zG1I1KBLf/5ZJC+Dl5mahjAPBgNVHRMBAf8EBTADAQH/
+MA4GA1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAQEABT41XBVwm8nHc2Fv
+civUwo/yQ10CzsSUuZQRg2dd4mdsdXa/uwyqNsatR5Nj3B5+1t4u/ukZMjgDfxT2
+AHMsWbEhBuH7rBiVDKP/mZb3Kyeb1STMHd3BOuCYRLDE5D53sXOpZCz2HAF8P11F
+hcCF5yWPldwX8zyfGm6wyuMdKulMY/okYWLW2n62HGz1Ah3UKt1VkOsqEUc8Ll50
+soIipX1TH0XsJ5F95yIW6MBoNtjG8U+ARDL54dHRHareqKucBK+tIA5kmE2la8BI
+WJZpTdwHjFGTot+fDz2LYLSCjaoITmJF4PkL0uDgPFveXHEnJcLmA4GLEFPjx1Wi
+tJ/X5g==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority RSA O=SSL Corporation
+# Label: "SSL.com Root Certification Authority RSA"
+# Serial: 8875640296558310041
+# MD5 Fingerprint: 86:69:12:c0:70:f1:ec:ac:ac:c2:d5:bc:a5:5b:a1:29
+# SHA1 Fingerprint: b7:ab:33:08:d1:ea:44:77:ba:14:80:12:5a:6f:bd:a9:36:49:0c:bb
+# SHA256 Fingerprint: 85:66:6a:56:2e:e0:be:5c:e9:25:c1:d8:89:0a:6f:76:a8:7e:c1:6d:4d:7d:5f:29:ea:74:19:cf:20:12:3b:69
+-----BEGIN CERTIFICATE-----
+MIIF3TCCA8WgAwIBAgIIeyyb0xaAMpkwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UE
+BhMCVVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQK
+DA9TU0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBSU0EwHhcNMTYwMjEyMTczOTM5WhcNNDEwMjEyMTcz
+OTM5WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNv
+bSBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IFJTQTCCAiIwDQYJKoZIhvcN
+AQEBBQADggIPADCCAgoCggIBAPkP3aMrfcvQKv7sZ4Wm5y4bunfh4/WvpOz6Sl2R
+xFdHaxh3a3by/ZPkPQ/CFp4LZsNWlJ4Xg4XOVu/yFv0AYvUiCVToZRdOQbngT0aX
+qhvIuG5iXmmxX9sqAn78bMrzQdjt0Oj8P2FI7bADFB0QDksZ4LtO7IZl/zbzXmcC
+C52GVWH9ejjt/uIZALdvoVBidXQ8oPrIJZK0bnoix/geoeOy3ZExqysdBP+lSgQ3
+6YWkMyv94tZVNHwZpEpox7Ko07fKoZOI68GXvIz5HdkihCR0xwQ9aqkpk8zruFvh
+/l8lqjRYyMEjVJ0bmBHDOJx+PYZspQ9AhnwC9FwCTyjLrnGfDzrIM/4RJTXq/LrF
+YD3ZfBjVsqnTdXgDciLKOsMf7yzlLqn6niy2UUb9rwPW6mBo6oUWNmuF6R7As93E
+JNyAKoFBbZQ+yODJgUEAnl6/f8UImKIYLEJAs/lvOCdLToD0PYFH4Ih86hzOtXVc
+US4cK38acijnALXRdMbX5J+tB5O2UzU1/Dfkw/ZdFr4hc96SCvigY2q8lpJqPvi8
+ZVWb3vUNiSYE/CUapiVpy8JtynziWV+XrOvvLsi81xtZPCvM8hnIk2snYxnP/Okm
++Mpxm3+T/jRnhE6Z6/yzeAkzcLpmpnbtG3PrGqUNxCITIJRWCk4sbE6x/c+cCbqi
+M+2HAgMBAAGjYzBhMB0GA1UdDgQWBBTdBAkHovV6fVJTEpKV7jiAJQ2mWTAPBgNV
+HRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFN0ECQei9Xp9UlMSkpXuOIAlDaZZMA4G
+A1UdDwEB/wQEAwIBhjANBgkqhkiG9w0BAQsFAAOCAgEAIBgRlCn7Jp0cHh5wYfGV
+cpNxJK1ok1iOMq8bs3AD/CUrdIWQPXhq9LmLpZc7tRiRux6n+UBbkflVma8eEdBc
+Hadm47GUBwwyOabqG7B52B2ccETjit3E+ZUfijhDPwGFpUenPUayvOUiaPd7nNgs
+PgohyC0zrL/FgZkxdMF1ccW+sfAjRfSda/wZY52jvATGGAslu1OJD7OAUN5F7kR/
+q5R4ZJjT9ijdh9hwZXT7DrkT66cPYakylszeu+1jTBi7qUD3oFRuIIhxdRjqerQ0
+cuAjJ3dctpDqhiVAq+8zD8ufgr6iIPv2tS0a5sKFsXQP+8hlAqRSAUfdSSLBv9jr
+a6x+3uxjMxW3IwiPxg+NQVrdjsW5j+VFP3jbutIbQLH+cU0/4IGiul607BXgk90I
+H37hVZkLId6Tngr75qNJvTYw/ud3sqB1l7UtgYgXZSD32pAAn8lSzDLKNXz1PQ/Y
+K9f1JmzJBjSWFupwWRoyeXkLtoh/D1JIPb9s2KJELtFOt3JY04kTlf5Eq/jXixtu
+nLwsoFvVagCvXzfh1foQC5ichucmj87w7G6KVwuA406ywKBjYZC6VWg3dGq2ktuf
+oYYitmUnDuy2n0Jg5GfCtdpBC8TTi2EbvPofkSvXRAdeuims2cXp71NIWuuA8ShY
+Ic2wBlX7Jz9TkHCpBB5XJ7k=
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com Root Certification Authority ECC"
+# Serial: 8495723813297216424
+# MD5 Fingerprint: 2e:da:e4:39:7f:9c:8f:37:d1:70:9f:26:17:51:3a:8e
+# SHA1 Fingerprint: c3:19:7c:39:24:e6:54:af:1b:c4:ab:20:95:7a:e2:c3:0e:13:02:6a
+# SHA256 Fingerprint: 34:17:bb:06:cc:60:07:da:1b:96:1c:92:0b:8a:b4:ce:3f:ad:82:0e:4a:a3:0b:9a:cb:c4:a7:4e:bd:ce:bc:65
+-----BEGIN CERTIFICATE-----
+MIICjTCCAhSgAwIBAgIIdebfy8FoW6gwCgYIKoZIzj0EAwIwfDELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xMTAvBgNVBAMMKFNTTC5jb20gUm9vdCBDZXJ0aWZpY2F0
+aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNDAzWhcNNDEwMjEyMTgxNDAz
+WjB8MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hvdXN0
+b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjExMC8GA1UEAwwoU1NMLmNvbSBS
+b290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49AgEGBSuB
+BAAiA2IABEVuqVDEpiM2nl8ojRfLliJkP9x6jh3MCLOicSS6jkm5BBtHllirLZXI
+7Z4INcgn64mMU1jrYor+8FsPazFSY0E7ic3s7LaNGdM0B9y7xgZ/wkWV7Mt/qCPg
+CemB+vNH06NjMGEwHQYDVR0OBBYEFILRhXMw5zUE044CkvvlpNHEIejNMA8GA1Ud
+EwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUgtGFczDnNQTTjgKS++Wk0cQh6M0wDgYD
+VR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2cAMGQCMG/n61kRpGDPYbCWe+0F+S8T
+kdzt5fxQaxFGRrMcIQBiu77D5+jNB5n5DQtdcj7EqgIwH7y6C+IwJPt8bYBVCpk+
+gA0z5Wajs6O7pdWLjwkspl1+4vAHCGht0nxpbl/f5Wpl
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority RSA R2 O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority RSA R2"
+# Serial: 6248227494352943350
+# MD5 Fingerprint: e1:1e:31:58:1a:ae:54:53:02:f6:17:6a:11:7b:4d:95
+# SHA1 Fingerprint: 74:3a:f0:52:9b:d0:32:a0:f4:4a:83:cd:d4:ba:a9:7b:7c:2e:c4:9a
+# SHA256 Fingerprint: 2e:7b:f1:6c:c2:24:85:a7:bb:e2:aa:86:96:75:07:61:b0:ae:39:be:3b:2f:e9:d0:cc:6d:4e:f7:34:91:42:5c
+-----BEGIN CERTIFICATE-----
+MIIF6zCCA9OgAwIBAgIIVrYpzTS8ePYwDQYJKoZIhvcNAQELBQAwgYIxCzAJBgNV
+BAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4GA1UEBwwHSG91c3RvbjEYMBYGA1UE
+CgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQDDC5TU0wuY29tIEVWIFJvb3QgQ2Vy
+dGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIyMB4XDTE3MDUzMTE4MTQzN1oXDTQy
+MDUzMDE4MTQzN1owgYIxCzAJBgNVBAYTAlVTMQ4wDAYDVQQIDAVUZXhhczEQMA4G
+A1UEBwwHSG91c3RvbjEYMBYGA1UECgwPU1NMIENvcnBvcmF0aW9uMTcwNQYDVQQD
+DC5TU0wuY29tIEVWIFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRob3JpdHkgUlNBIFIy
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAjzZlQOHWTcDXtOlG2mvq
+M0fNTPl9fb69LT3w23jhhqXZuglXaO1XPqDQCEGD5yhBJB/jchXQARr7XnAjssuf
+OePPxU7Gkm0mxnu7s9onnQqG6YE3Bf7wcXHswxzpY6IXFJ3vG2fThVUCAtZJycxa
+4bH3bzKfydQ7iEGonL3Lq9ttewkfokxykNorCPzPPFTOZw+oz12WGQvE43LrrdF9
+HSfvkusQv1vrO6/PgN3B0pYEW3p+pKk8OHakYo6gOV7qd89dAFmPZiw+B6KjBSYR
+aZfqhbcPlgtLyEDhULouisv3D5oi53+aNxPN8k0TayHRwMwi8qFG9kRpnMphNQcA
+b9ZhCBHqurj26bNg5U257J8UZslXWNvNh2n4ioYSA0e/ZhN2rHd9NCSFg83XqpyQ
+Gp8hLH94t2S42Oim9HizVcuE0jLEeK6jj2HdzghTreyI/BXkmg3mnxp3zkyPuBQV
+PWKchjgGAGYS5Fl2WlPAApiiECtoRHuOec4zSnaqW4EWG7WK2NAAe15itAnWhmMO
+pgWVSbooi4iTsjQc2KRVbrcc0N6ZVTsj9CLg+SlmJuwgUHfbSguPvuUCYHBBXtSu
+UDkiFCbLsjtzdFVHB3mBOagwE0TlBIqulhMlQg+5U8Sb/M3kHN48+qvWBkofZ6aY
+MBzdLNvcGJVXZsb/XItW9XcCAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAfBgNV
+HSMEGDAWgBT5YLvU49U09rj1BoAlp3PbRmmonjAdBgNVHQ4EFgQU+WC71OPVNPa4
+9QaAJadz20ZpqJ4wDgYDVR0PAQH/BAQDAgGGMA0GCSqGSIb3DQEBCwUAA4ICAQBW
+s47LCp1Jjr+kxJG7ZhcFUZh1++VQLHqe8RT6q9OKPv+RKY9ji9i0qVQBDb6Thi/5
+Sm3HXvVX+cpVHBK+Rw82xd9qt9t1wkclf7nxY/hoLVUE0fKNsKTPvDxeH3jnpaAg
+cLAExbf3cqfeIg29MyVGjGSSJuM+LmOW2puMPfgYCdcDzH2GguDKBAdRUNf/ktUM
+79qGn5nX67evaOI5JpS6aLe/g9Pqemc9YmeuJeVy6OLk7K4S9ksrPJ/psEDzOFSz
+/bdoyNrGj1E8svuR3Bznm53htw1yj+KkxKl4+esUrMZDBcJlOSgYAsOCsp0FvmXt
+ll9ldDz7CTUue5wT/RsPXcdtgTpWD8w74a8CLyKsRspGPKAcTNZEtF4uXBVmCeEm
+Kf7GUmG6sXP/wwyc5WxqlD8UykAWlYTzWamsX0xhk23RO8yilQwipmdnRC652dKK
+QbNmC1r7fSOl8hqw/96bg5Qu0T/fkreRrwU7ZcegbLHNYhLDkBvjJc40vG93drEQ
+w/cFGsDWr3RiSBd3kmmQYRzelYB0VI8YHMPzA9C/pEN1hlMYegouCRw2n5H9gooi
+S9EOUCXdywMMF8mDAAhONU2Ki+3wApRmLER/y5UnlhetCTCstnEXbosX9hwJ1C07
+mKVx01QT2WDz9UtmT/rx7iASjbSsV7FFY6GsdqnC+w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Subject: CN=SSL.com EV Root Certification Authority ECC O=SSL Corporation
+# Label: "SSL.com EV Root Certification Authority ECC"
+# Serial: 3182246526754555285
+# MD5 Fingerprint: 59:53:22:65:83:42:01:54:c0:ce:42:b9:5a:7c:f2:90
+# SHA1 Fingerprint: 4c:dd:51:a3:d1:f5:20:32:14:b0:c6:c5:32:23:03:91:c7:46:42:6d
+# SHA256 Fingerprint: 22:a2:c1:f7:bd:ed:70:4c:c1:e7:01:b5:f4:08:c3:10:88:0f:e9:56:b5:de:2a:4a:44:f9:9c:87:3a:25:a7:c8
+-----BEGIN CERTIFICATE-----
+MIIClDCCAhqgAwIBAgIILCmcWxbtBZUwCgYIKoZIzj0EAwIwfzELMAkGA1UEBhMC
+VVMxDjAMBgNVBAgMBVRleGFzMRAwDgYDVQQHDAdIb3VzdG9uMRgwFgYDVQQKDA9T
+U0wgQ29ycG9yYXRpb24xNDAyBgNVBAMMK1NTTC5jb20gRVYgUm9vdCBDZXJ0aWZp
+Y2F0aW9uIEF1dGhvcml0eSBFQ0MwHhcNMTYwMjEyMTgxNTIzWhcNNDEwMjEyMTgx
+NTIzWjB/MQswCQYDVQQGEwJVUzEOMAwGA1UECAwFVGV4YXMxEDAOBgNVBAcMB0hv
+dXN0b24xGDAWBgNVBAoMD1NTTCBDb3Jwb3JhdGlvbjE0MDIGA1UEAwwrU1NMLmNv
+bSBFViBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IEVDQzB2MBAGByqGSM49
+AgEGBSuBBAAiA2IABKoSR5CYG/vvw0AHgyBO8TCCogbR8pKGYfL2IWjKAMTH6kMA
+VIbc/R/fALhBYlzccBYy3h+Z1MzFB8gIH2EWB1E9fVwHU+M1OIzfzZ/ZLg1Kthku
+WnBaBu2+8KGwytAJKaNjMGEwHQYDVR0OBBYEFFvKXuXe0oGqzagtZFG22XKbl+ZP
+MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUW8pe5d7SgarNqC1kUbbZcpuX
+5k8wDgYDVR0PAQH/BAQDAgGGMAoGCCqGSM49BAMCA2gAMGUCMQCK5kCJN+vp1RPZ
+ytRrJPOwPYdGWBrssd9v+1a6cGvHOMzosYxPD/fxZ3YOg9AeUY8CMD32IygmTMZg
+h5Mmm7I1HrrW9zzRHM76JTymGoEVW/MSD2zuZYrJh6j5B+BimoxcSg==
+-----END CERTIFICATE-----
+
+# Issuer: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Subject: CN=GlobalSign O=GlobalSign OU=GlobalSign Root CA - R6
+# Label: "GlobalSign Root CA - R6"
+# Serial: 1417766617973444989252670301619537
+# MD5 Fingerprint: 4f:dd:07:e4:d4:22:64:39:1e:0c:37:42:ea:d1:c6:ae
+# SHA1 Fingerprint: 80:94:64:0e:b5:a7:a1:ca:11:9c:1f:dd:d5:9f:81:02:63:a7:fb:d1
+# SHA256 Fingerprint: 2c:ab:ea:fe:37:d0:6c:a2:2a:ba:73:91:c0:03:3d:25:98:29:52:c4:53:64:73:49:76:3a:3a:b5:ad:6c:cf:69
+-----BEGIN CERTIFICATE-----
+MIIFgzCCA2ugAwIBAgIORea7A4Mzw4VlSOb/RVEwDQYJKoZIhvcNAQEMBQAwTDEg
+MB4GA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjYxEzARBgNVBAoTCkdsb2Jh
+bFNpZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMTQxMjEwMDAwMDAwWhcNMzQx
+MjEwMDAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSNjET
+MBEGA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCAiIwDQYJ
+KoZIhvcNAQEBBQADggIPADCCAgoCggIBAJUH6HPKZvnsFMp7PPcNCPG0RQssgrRI
+xutbPK6DuEGSMxSkb3/pKszGsIhrxbaJ0cay/xTOURQh7ErdG1rG1ofuTToVBu1k
+ZguSgMpE3nOUTvOniX9PeGMIyBJQbUJmL025eShNUhqKGoC3GYEOfsSKvGRMIRxD
+aNc9PIrFsmbVkJq3MQbFvuJtMgamHvm566qjuL++gmNQ0PAYid/kD3n16qIfKtJw
+LnvnvJO7bVPiSHyMEAc4/2ayd2F+4OqMPKq0pPbzlUoSB239jLKJz9CgYXfIWHSw
+1CM69106yqLbnQneXUQtkPGBzVeS+n68UARjNN9rkxi+azayOeSsJDa38O+2HBNX
+k7besvjihbdzorg1qkXy4J02oW9UivFyVm4uiMVRQkQVlO6jxTiWm05OWgtH8wY2
+SXcwvHE35absIQh1/OZhFj931dmRl4QKbNQCTXTAFO39OfuD8l4UoQSwC+n+7o/h
+bguyCLNhZglqsQY6ZZZZwPA1/cnaKI0aEYdwgQqomnUdnjqGBQCe24DWJfncBZ4n
+WUx2OVvq+aWh2IMP0f/fMBH5hc8zSPXKbWQULHpYT9NLCEnFlWQaYw55PfWzjMpY
+rZxCRXluDocZXFSxZba/jJvcE+kNb7gu3GduyYsRtYQUigAZcIN5kZeR1Bonvzce
+MgfYFGM8KEyvAgMBAAGjYzBhMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTAD
+AQH/MB0GA1UdDgQWBBSubAWjkxPioufi1xzWx/B/yGdToDAfBgNVHSMEGDAWgBSu
+bAWjkxPioufi1xzWx/B/yGdToDANBgkqhkiG9w0BAQwFAAOCAgEAgyXt6NH9lVLN
+nsAEoJFp5lzQhN7craJP6Ed41mWYqVuoPId8AorRbrcWc+ZfwFSY1XS+wc3iEZGt
+Ixg93eFyRJa0lV7Ae46ZeBZDE1ZXs6KzO7V33EByrKPrmzU+sQghoefEQzd5Mr61
+55wsTLxDKZmOMNOsIeDjHfrYBzN2VAAiKrlNIC5waNrlU/yDXNOd8v9EDERm8tLj
+vUYAGm0CuiVdjaExUd1URhxN25mW7xocBFymFe944Hn+Xds+qkxV/ZoVqW/hpvvf
+cDDpw+5CRu3CkwWJ+n1jez/QcYF8AOiYrg54NMMl+68KnyBr3TsTjxKM4kEaSHpz
+oHdpx7Zcf4LIHv5YGygrqGytXm3ABdJ7t+uA/iU3/gKbaKxCXcPu9czc8FB10jZp
+nOZ7BN9uBmm23goJSFmH63sUYHpkqmlD75HHTOwY3WzvUy2MmeFe8nI+z1TIvWfs
+pA9MRf/TuTAjB0yPEL+GltmZWrSZVxykzLsViVO6LAUP5MSeGbEYNNVMnbrt9x+v
+JJUEeKgDu+6B5dpffItKoZB0JaezPkvILFa9x8jvOOJckvB595yEunQtYQEgfn7R
+8k8HWV+LLUNS60YMlOH1Zkd5d9VUWx+tJDfLRVpOoERIyNiwmcUVhAn21klJwGW4
+5hpxbqCo8YLoRT5s1gLXCmeDBVrJpBA=
+-----END CERTIFICATE-----
+
+# Issuer: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Subject: CN=OISTE WISeKey Global Root GC CA O=WISeKey OU=OISTE Foundation Endorsed
+# Label: "OISTE WISeKey Global Root GC CA"
+# Serial: 44084345621038548146064804565436152554
+# MD5 Fingerprint: a9:d6:b9:2d:2f:93:64:f8:a5:69:ca:91:e9:68:07:23
+# SHA1 Fingerprint: e0:11:84:5e:34:de:be:88:81:b9:9c:f6:16:26:d1:96:1f:c3:b9:31
+# SHA256 Fingerprint: 85:60:f9:1c:36:24:da:ba:95:70:b5:fe:a0:db:e3:6f:f1:1a:83:23:be:94:86:85:4f:b3:f3:4a:55:71:19:8d
+-----BEGIN CERTIFICATE-----
+MIICaTCCAe+gAwIBAgIQISpWDK7aDKtARb8roi066jAKBggqhkjOPQQDAzBtMQsw
+CQYDVQQGEwJDSDEQMA4GA1UEChMHV0lTZUtleTEiMCAGA1UECxMZT0lTVEUgRm91
+bmRhdGlvbiBFbmRvcnNlZDEoMCYGA1UEAxMfT0lTVEUgV0lTZUtleSBHbG9iYWwg
+Um9vdCBHQyBDQTAeFw0xNzA1MDkwOTQ4MzRaFw00MjA1MDkwOTU4MzNaMG0xCzAJ
+BgNVBAYTAkNIMRAwDgYDVQQKEwdXSVNlS2V5MSIwIAYDVQQLExlPSVNURSBGb3Vu
+ZGF0aW9uIEVuZG9yc2VkMSgwJgYDVQQDEx9PSVNURSBXSVNlS2V5IEdsb2JhbCBS
+b290IEdDIENBMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAETOlQwMYPchi82PG6s4ni
+eUqjFqdrVCTbUf/q9Akkwwsin8tqJ4KBDdLArzHkdIJuyiXZjHWd8dvQmqJLIX4W
+p2OQ0jnUsYd4XxiWD1AbNTcPasbc2RNNpI6QN+a9WzGRo1QwUjAOBgNVHQ8BAf8E
+BAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUSIcUrOPDnpBgOtfKie7T
+rYy0UGYwEAYJKwYBBAGCNxUBBAMCAQAwCgYIKoZIzj0EAwMDaAAwZQIwJsdpW9zV
+57LnyAyMjMPdeYwbY9XJUpROTYJKcx6ygISpJcBMWm1JKWB4E+J+SOtkAjEA2zQg
+Mgj/mkkCtojeFK9dbJlxjRo/i9fgojaGHAeCOnZT/cKi7e97sIBPWA9LUzm9
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R1 O=Google Trust Services LLC
+# Subject: CN=GTS Root R1 O=Google Trust Services LLC
+# Label: "GTS Root R1"
+# Serial: 146587175971765017618439757810265552097
+# MD5 Fingerprint: 82:1a:ef:d4:d2:4a:f2:9f:e2:3d:97:06:14:70:72:85
+# SHA1 Fingerprint: e1:c9:50:e6:ef:22:f8:4c:56:45:72:8b:92:20:60:d7:d5:a7:a3:e8
+# SHA256 Fingerprint: 2a:57:54:71:e3:13:40:bc:21:58:1c:bd:2c:f1:3e:15:84:63:20:3e:ce:94:bc:f9:d3:cc:19:6b:f0:9a:54:72
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQbkepxUtHDA3sM9CJuRz04TANBgkqhkiG9w0BAQwFADBH
+MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
+QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
+MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
+cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjEwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQC2EQKLHuOhd5s73L+UPreVp0A8of2C+X0yBoJx9vaM
+f/vo27xqLpeXo4xL+Sv2sfnOhB2x+cWX3u+58qPpvBKJXqeqUqv4IyfLpLGcY9vX
+mX7wCl7raKb0xlpHDU0QM+NOsROjyBhsS+z8CZDfnWQpJSMHobTSPS5g4M/SCYe7
+zUjwTcLCeoiKu7rPWRnWr4+wB7CeMfGCwcDfLqZtbBkOtdh+JhpFAz2weaSUKK0P
+fyblqAj+lug8aJRT7oM6iCsVlgmy4HqMLnXWnOunVmSPlk9orj2XwoSPwLxAwAtc
+vfaHszVsrBhQf4TgTM2S0yDpM7xSma8ytSmzJSq0SPly4cpk9+aCEI3oncKKiPo4
+Zor8Y/kB+Xj9e1x3+naH+uzfsQ55lVe0vSbv1gHR6xYKu44LtcXFilWr06zqkUsp
+zBmkMiVOKvFlRNACzqrOSbTqn3yDsEB750Orp2yjj32JgfpMpf/VjsPOS+C12LOO
+Rc92wO1AK/1TD7Cn1TsNsYqiA94xrcx36m97PtbfkSIS5r762DL8EGMUUXLeXdYW
+k70paDPvOmbsB4om3xPXV2V4J95eSRQAogB/mqghtqmxlbCluQ0WEdrHbEg8QOB+
+DVrNVjzRlwW5y0vtOUucxD/SVRNuJLDWcfr0wbrM7Rv1/oFB2ACYPTrIrnqYNxgF
+lQIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQU5K8rJnEaK0gnhS9SZizv8IkTcT4wDQYJKoZIhvcNAQEMBQADggIBADiW
+Cu49tJYeX++dnAsznyvgyv3SjgofQXSlfKqE1OXyHuY3UjKcC9FhHb8owbZEKTV1
+d5iyfNm9dKyKaOOpMQkpAWBz40d8U6iQSifvS9efk+eCNs6aaAyC58/UEBZvXw6Z
+XPYfcX3v73svfuo21pdwCxXu11xWajOl40k4DLh9+42FpLFZXvRq4d2h9mREruZR
+gyFmxhE+885H7pwoHyXa/6xmld01D1zvICxi/ZG6qcz8WpyTgYMpl0p8WnK0OdC3
+d8t5/Wk6kjftbjhlRn7pYL15iJdfOBL07q9bgsiG1eGZbYwE8na6SfZu6W0eX6Dv
+J4J2QPim01hcDyxC2kLGe4g0x8HYRZvBPsVhHdljUEn2NIVq4BjFbkerQUIpm/Zg
+DdIx02OYI5NaAIFItO/Nis3Jz5nu2Z6qNuFoS3FJFDYoOj0dzpqPJeaAcWErtXvM
++SUWgeExX6GjfhaknBZqlxi9dnKlC54dNuYvoS++cJEPqOba+MSSQGwlfnuzCdyy
+F62ARPBopY+Udf90WuioAnwMCeKpSwughQtiue+hMZL77/ZRBIls6Kl0obsXs7X9
+SQ98POyDGCBDTtWTurQ0sR8WNh8M5mQ5Fkzc4P4dyKliPUDqysU0ArSuiYgzNdws
+E3PYJ/HQcu51OyLemGhmW/HGY0dVHLqlCFF1pkgl
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R2 O=Google Trust Services LLC
+# Subject: CN=GTS Root R2 O=Google Trust Services LLC
+# Label: "GTS Root R2"
+# Serial: 146587176055767053814479386953112547951
+# MD5 Fingerprint: 44:ed:9a:0e:a4:09:3b:00:f2:ae:4c:a3:c6:61:b0:8b
+# SHA1 Fingerprint: d2:73:96:2a:2a:5e:39:9f:73:3f:e1:c7:1e:64:3f:03:38:34:fc:4d
+# SHA256 Fingerprint: c4:5d:7b:b0:8e:6d:67:e6:2e:42:35:11:0b:56:4e:5f:78:fd:92:ef:05:8c:84:0a:ea:4e:64:55:d7:58:5c:60
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQbkepxlqz5yDFMJo/aFLybzANBgkqhkiG9w0BAQwFADBH
+MQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExM
+QzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIy
+MDAwMDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNl
+cnZpY2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjIwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQDO3v2m++zsFDQ8BwZabFn3GTXd98GdVarTzTukk3Lv
+CvptnfbwhYBboUhSnznFt+4orO/LdmgUud+tAWyZH8QiHZ/+cnfgLFuv5AS/T3Kg
+GjSY6Dlo7JUle3ah5mm5hRm9iYz+re026nO8/4Piy33B0s5Ks40FnotJk9/BW9Bu
+XvAuMC6C/Pq8tBcKSOWIm8Wba96wyrQD8Nr0kLhlZPdcTK3ofmZemde4wj7I0BOd
+re7kRXuJVfeKH2JShBKzwkCX44ofR5GmdFrS+LFjKBC4swm4VndAoiaYecb+3yXu
+PuWgf9RhD1FLPD+M2uFwdNjCaKH5wQzpoeJ/u1U8dgbuak7MkogwTZq9TwtImoS1
+mKPV+3PBV2HdKFZ1E66HjucMUQkQdYhMvI35ezzUIkgfKtzra7tEscszcTJGr61K
+8YzodDqs5xoic4DSMPclQsciOzsSrZYuxsN2B6ogtzVJV+mSSeh2FnIxZyuWfoqj
+x5RWIr9qS34BIbIjMt/kmkRtWVtd9QCgHJvGeJeNkP+byKq0rxFROV7Z+2et1VsR
+nTKaG73VululycslaVNVJ1zgyjbLiGH7HrfQy+4W+9OmTN6SpdTi3/UGVN4unUu0
+kzCqgc7dGtxRcw1PcOnlthYhGXmy5okLdWTK1au8CcEYof/UVKGFPP0UJAOyh9Ok
+twIDAQABo0IwQDAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAdBgNV
+HQ4EFgQUu//KjiOfT5nK2+JopqUVJxce2Q4wDQYJKoZIhvcNAQEMBQADggIBALZp
+8KZ3/p7uC4Gt4cCpx/k1HUCCq+YEtN/L9x0Pg/B+E02NjO7jMyLDOfxA325BS0JT
+vhaI8dI4XsRomRyYUpOM52jtG2pzegVATX9lO9ZY8c6DR2Dj/5epnGB3GFW1fgiT
+z9D2PGcDFWEJ+YF59exTpJ/JjwGLc8R3dtyDovUMSRqodt6Sm2T4syzFJ9MHwAiA
+pJiS4wGWAqoC7o87xdFtCjMwc3i5T1QWvwsHoaRc5svJXISPD+AVdyx+Jn7axEvb
+pxZ3B7DNdehyQtaVhJ2Gg/LkkM0JR9SLA3DaWsYDQvTtN6LwG1BUSw7YhN4ZKJmB
+R64JGz9I0cNv4rBgF/XuIwKl2gBbbZCr7qLpGzvpx0QnRY5rn/WkhLx3+WuXrD5R
+RaIRpsyF7gpo8j5QOHokYh4XIDdtak23CZvJ/KRY9bb7nE4Yu5UC56GtmwfuNmsk
+0jmGwZODUNKBRqhfYlcsu2xkiAhu7xNUX90txGdj08+JN7+dIPT7eoOboB6BAFDC
+5AwiWVIQ7UNWhwD4FFKnHYuTjKJNRn8nxnGbJN7k2oaLDX5rIMHAnuFl2GqjpuiF
+izoHCBy69Y9Vmhh1fuXsgWbRIXOhNUQLgD1bnF5vKheW0YMjiGZt5obicDIvUiLn
+yOd/xCxgXS/Dr55FBcOEArf9LAhST4Ldo/DUhgkC
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R3 O=Google Trust Services LLC
+# Subject: CN=GTS Root R3 O=Google Trust Services LLC
+# Label: "GTS Root R3"
+# Serial: 146587176140553309517047991083707763997
+# MD5 Fingerprint: 1a:79:5b:6b:04:52:9c:5d:c7:74:33:1b:25:9a:f9:25
+# SHA1 Fingerprint: 30:d4:24:6f:07:ff:db:91:89:8a:0b:e9:49:66:11:eb:8c:5e:46:e5
+# SHA256 Fingerprint: 15:d5:b8:77:46:19:ea:7d:54:ce:1c:a6:d0:b0:c4:03:e0:37:a9:17:f1:31:e8:a0:4e:1e:6b:7a:71:ba:bc:e5
+-----BEGIN CERTIFICATE-----
+MIICDDCCAZGgAwIBAgIQbkepx2ypcyRAiQ8DVd2NHTAKBggqhkjOPQQDAzBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjMwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjMwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAAQfTzOHMymKoYTey8chWEGJ6ladK0uFxh1MJ7x/JlFyb+Kf1qPKzEUURout
+736GjOyxfi//qXGdGIRFBEFVbivqJn+7kAHjSxm65FSWRQmx1WyRRK2EE46ajA2A
+DDL24CejQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBTB8Sa6oC2uhYHP0/EqEr24Cmf9vDAKBggqhkjOPQQDAwNpADBmAjEAgFuk
+fCPAlaUs3L6JbyO5o91lAFJekazInXJ0glMLfalAvWhgxeG4VDvBNhcl2MG9AjEA
+njWSdIUlUfUk7GRSJFClH9voy8l27OyCbvWFGFPouOOaKaqW04MjyaR7YbPMAuhd
+-----END CERTIFICATE-----
+
+# Issuer: CN=GTS Root R4 O=Google Trust Services LLC
+# Subject: CN=GTS Root R4 O=Google Trust Services LLC
+# Label: "GTS Root R4"
+# Serial: 146587176229350439916519468929765261721
+# MD5 Fingerprint: 5d:b6:6a:c4:60:17:24:6a:1a:99:a8:4b:ee:5e:b4:26
+# SHA1 Fingerprint: 2a:1d:60:27:d9:4a:b1:0a:1c:4d:91:5c:cd:33:a0:cb:3e:2d:54:cb
+# SHA256 Fingerprint: 71:cc:a5:39:1f:9e:79:4b:04:80:25:30:b3:63:e1:21:da:8a:30:43:bb:26:66:2f:ea:4d:ca:7f:c9:51:a4:bd
+-----BEGIN CERTIFICATE-----
+MIICCjCCAZGgAwIBAgIQbkepyIuUtui7OyrYorLBmTAKBggqhkjOPQQDAzBHMQsw
+CQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZpY2VzIExMQzEU
+MBIGA1UEAxMLR1RTIFJvb3QgUjQwHhcNMTYwNjIyMDAwMDAwWhcNMzYwNjIyMDAw
+MDAwWjBHMQswCQYDVQQGEwJVUzEiMCAGA1UEChMZR29vZ2xlIFRydXN0IFNlcnZp
+Y2VzIExMQzEUMBIGA1UEAxMLR1RTIFJvb3QgUjQwdjAQBgcqhkjOPQIBBgUrgQQA
+IgNiAATzdHOnaItgrkO4NcWBMHtLSZ37wWHO5t5GvWvVYRg1rkDdc/eJkTBa6zzu
+hXyiQHY7qca4R9gq55KRanPpsXI5nymfopjTX15YhmUPoYRlBtHci8nHc8iMai/l
+xKvRHYqjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8EBTADAQH/MB0GA1Ud
+DgQWBBSATNbrdP9JNqPV2Py1PsVq8JQdjDAKBggqhkjOPQQDAwNnADBkAjBqUFJ0
+CMRw3J5QdCHojXohw0+WbhXRIjVhLfoIN+4Zba3bssx9BzT1YBkstTTZbyACMANx
+sbqjYAuG7ZoIapVon+Kz4ZNkfF6Tpt95LY2F45TPI11xzPKwTdb+mciUqXWi4w==
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Global G2 Root O=UniTrust
+# Subject: CN=UCA Global G2 Root O=UniTrust
+# Label: "UCA Global G2 Root"
+# Serial: 124779693093741543919145257850076631279
+# MD5 Fingerprint: 80:fe:f0:c4:4a:f0:5c:62:32:9f:1c:ba:78:a9:50:f8
+# SHA1 Fingerprint: 28:f9:78:16:19:7a:ff:18:25:18:aa:44:fe:c1:a0:ce:5c:b6:4c:8a
+# SHA256 Fingerprint: 9b:ea:11:c9:76:fe:01:47:64:c1:be:56:a6:f9:14:b5:a5:60:31:7a:bd:99:88:39:33:82:e5:16:1a:a0:49:3c
+-----BEGIN CERTIFICATE-----
+MIIFRjCCAy6gAwIBAgIQXd+x2lqj7V2+WmUgZQOQ7zANBgkqhkiG9w0BAQsFADA9
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxGzAZBgNVBAMMElVDQSBH
+bG9iYWwgRzIgUm9vdDAeFw0xNjAzMTEwMDAwMDBaFw00MDEyMzEwMDAwMDBaMD0x
+CzAJBgNVBAYTAkNOMREwDwYDVQQKDAhVbmlUcnVzdDEbMBkGA1UEAwwSVUNBIEds
+b2JhbCBHMiBSb290MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxeYr
+b3zvJgUno4Ek2m/LAfmZmqkywiKHYUGRO8vDaBsGxUypK8FnFyIdK+35KYmToni9
+kmugow2ifsqTs6bRjDXVdfkX9s9FxeV67HeToI8jrg4aA3++1NDtLnurRiNb/yzm
+VHqUwCoV8MmNsHo7JOHXaOIxPAYzRrZUEaalLyJUKlgNAQLx+hVRZ2zA+te2G3/R
+VogvGjqNO7uCEeBHANBSh6v7hn4PJGtAnTRnvI3HLYZveT6OqTwXS3+wmeOwcWDc
+C/Vkw85DvG1xudLeJ1uK6NjGruFZfc8oLTW4lVYa8bJYS7cSN8h8s+1LgOGN+jIj
+tm+3SJUIsUROhYw6AlQgL9+/V087OpAh18EmNVQg7Mc/R+zvWr9LesGtOxdQXGLY
+D0tK3Cv6brxzks3sx1DoQZbXqX5t2Okdj4q1uViSukqSKwxW/YDrCPBeKW4bHAyv
+j5OJrdu9o54hyokZ7N+1wxrrFv54NkzWbtA+FxyQF2smuvt6L78RHBgOLXMDj6Dl
+NaBa4kx1HXHhOThTeEDMg5PXCp6dW4+K5OXgSORIskfNTip1KnvyIvbJvgmRlld6
+iIis7nCs+dwp4wwcOxJORNanTrAmyPPZGpeRaOrvjUYG0lZFWJo8DA+DuAUlwznP
+O6Q0ibd5Ei9Hxeepl2n8pndntd978XplFeRhVmUCAwEAAaNCMEAwDgYDVR0PAQH/
+BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFIHEjMz15DD/pQwIX4wV
+ZyF0Ad/fMA0GCSqGSIb3DQEBCwUAA4ICAQATZSL1jiutROTL/7lo5sOASD0Ee/oj
+L3rtNtqyzm325p7lX1iPyzcyochltq44PTUbPrw7tgTQvPlJ9Zv3hcU2tsu8+Mg5
+1eRfB70VVJd0ysrtT7q6ZHafgbiERUlMjW+i67HM0cOU2kTC5uLqGOiiHycFutfl
+1qnN3e92mI0ADs0b+gO3joBYDic/UvuUospeZcnWhNq5NXHzJsBPd+aBJ9J3O5oU
+b3n09tDh05S60FdRvScFDcH9yBIw7m+NESsIndTUv4BFFJqIRNow6rSn4+7vW4LV
+PtateJLbXDzz2K36uGt/xDYotgIVilQsnLAXc47QN6MUPJiVAAwpBVueSUmxX8fj
+y88nZY41F7dXyDDZQVu5FLbowg+UMaeUmMxq67XhJ/UQqAHojhJi6IjMtX9Gl8Cb
+EGY4GjZGXyJoPd/JxhMnq1MGrKI8hgZlb7F+sSlEmqO6SWkoaY/X5V+tBIZkbxqg
+DMUIYs6Ao9Dz7GjevjPHF1t/gMRMTLGmhIrDO7gJzRSBuhjjVFc2/tsvfEehOjPI
++Vg7RE+xygKJBJYoaMVLuCaJu9YzL1DV/pqJuhgyklTGW+Cd+V7lDSKb9triyCGy
+YiGqhkCyLmTTX8jjfhFnRR8F/uOi77Oos/N9j/gMHyIfLXC0uAE0djAA5SN4p1bX
+UB+K+wb1whnw0A==
+-----END CERTIFICATE-----
+
+# Issuer: CN=UCA Extended Validation Root O=UniTrust
+# Subject: CN=UCA Extended Validation Root O=UniTrust
+# Label: "UCA Extended Validation Root"
+# Serial: 106100277556486529736699587978573607008
+# MD5 Fingerprint: a1:f3:5f:43:c6:34:9b:da:bf:8c:7e:05:53:ad:96:e2
+# SHA1 Fingerprint: a3:a1:b0:6f:24:61:23:4a:e3:36:a5:c2:37:fc:a6:ff:dd:f0:d7:3a
+# SHA256 Fingerprint: d4:3a:f9:b3:54:73:75:5c:96:84:fc:06:d7:d8:cb:70:ee:5c:28:e7:73:fb:29:4e:b4:1e:e7:17:22:92:4d:24
+-----BEGIN CERTIFICATE-----
+MIIFWjCCA0KgAwIBAgIQT9Irj/VkyDOeTzRYZiNwYDANBgkqhkiG9w0BAQsFADBH
+MQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNVBAMMHFVDQSBF
+eHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwHhcNMTUwMzEzMDAwMDAwWhcNMzgxMjMx
+MDAwMDAwWjBHMQswCQYDVQQGEwJDTjERMA8GA1UECgwIVW5pVHJ1c3QxJTAjBgNV
+BAMMHFVDQSBFeHRlbmRlZCBWYWxpZGF0aW9uIFJvb3QwggIiMA0GCSqGSIb3DQEB
+AQUAA4ICDwAwggIKAoICAQCpCQcoEwKwmeBkqh5DFnpzsZGgdT6o+uM4AHrsiWog
+D4vFsJszA1qGxliG1cGFu0/GnEBNyr7uaZa4rYEwmnySBesFK5pI0Lh2PpbIILvS
+sPGP2KxFRv+qZ2C0d35qHzwaUnoEPQc8hQ2E0B92CvdqFN9y4zR8V05WAT558aop
+O2z6+I9tTcg1367r3CTueUWnhbYFiN6IXSV8l2RnCdm/WhUFhvMJHuxYMjMR83dk
+sHYf5BA1FxvyDrFspCqjc/wJHx4yGVMR59mzLC52LqGj3n5qiAno8geK+LLNEOfi
+c0CTuwjRP+H8C5SzJe98ptfRr5//lpr1kXuYC3fUfugH0mK1lTnj8/FtDw5lhIpj
+VMWAtuCeS31HJqcBCF3RiJ7XwzJE+oJKCmhUfzhTA8ykADNkUVkLo4KRel7sFsLz
+KuZi2irbWWIQJUoqgQtHB0MGcIfS+pMRKXpITeuUx3BNr2fVUbGAIAEBtHoIppB/
+TuDvB0GHr2qlXov7z1CymlSvw4m6WC31MJixNnI5fkkE/SmnTHnkBVfblLkWU41G
+sx2VYVdWf6/wFlthWG82UBEL2KwrlRYaDh8IzTY0ZRBiZtWAXxQgXy0MoHgKaNYs
+1+lvK9JKBZP8nm9rZ/+I8U6laUpSNwXqxhaN0sSZ0YIrO7o1dfdRUVjzyAfd5LQD
+fwIDAQABo0IwQDAdBgNVHQ4EFgQU2XQ65DA9DfcS3H5aBZ8eNJr34RQwDwYDVR0T
+AQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwDQYJKoZIhvcNAQELBQADggIBADaN
+l8xCFWQpN5smLNb7rhVpLGsaGvdftvkHTFnq88nIua7Mui563MD1sC3AO6+fcAUR
+ap8lTwEpcOPlDOHqWnzcSbvBHiqB9RZLcpHIojG5qtr8nR/zXUACE/xOHAbKsxSQ
+VBcZEhrxH9cMaVr2cXj0lH2RC47skFSOvG+hTKv8dGT9cZr4QQehzZHkPJrgmzI5
+c6sq1WnIeJEmMX3ixzDx/BR4dxIOE/TdFpS/S2d7cFOFyrC78zhNLJA5wA3CXWvp
+4uXViI3WLL+rG761KIcSF3Ru/H38j9CHJrAb+7lsq+KePRXBOy5nAliRn+/4Qh8s
+t2j1da3Ptfb/EX3C8CSlrdP6oDyp+l3cpaDvRKS+1ujl5BOWF3sGPjLtx7dCvHaj
+2GU4Kzg1USEODm8uNBNA4StnDG1KQTAYI1oyVZnJF+A83vbsea0rWBmirSwiGpWO
+vpaQXUJXxPkUAzUrHC1RVwinOt4/5Mi0A3PCwSaAuwtCH60NryZy2sy+s6ODWA2C
+xR9GUeOcGMyNm43sSet1UNWMKFnKdDTajAshqx7qG+XH/RU+wBeq+yNuJkbL+vmx
+cmtpzyKEC2IPrNkZAJSidjzULZrtBJ4tBmIQN1IchXIbJ+XMxjHsN+xjWZsLHXbM
+fjKaiJUINlK73nZfdklJrX+9ZSCyycErdhh2n1ax
+-----END CERTIFICATE-----
+
+# Issuer: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Subject: CN=Certigna Root CA O=Dhimyotis OU=0002 48146308100036
+# Label: "Certigna Root CA"
+# Serial: 269714418870597844693661054334862075617
+# MD5 Fingerprint: 0e:5c:30:62:27:eb:5b:bc:d7:ae:62:ba:e9:d5:df:77
+# SHA1 Fingerprint: 2d:0d:52:14:ff:9e:ad:99:24:01:74:20:47:6e:6c:85:27:27:f5:43
+# SHA256 Fingerprint: d4:8d:3d:23:ee:db:50:a4:59:e5:51:97:60:1c:27:77:4b:9d:7b:18:c9:4d:5a:05:95:11:a1:02:50:b9:31:68
+-----BEGIN CERTIFICATE-----
+MIIGWzCCBEOgAwIBAgIRAMrpG4nxVQMNo+ZBbcTjpuEwDQYJKoZIhvcNAQELBQAw
+WjELMAkGA1UEBhMCRlIxEjAQBgNVBAoMCURoaW15b3RpczEcMBoGA1UECwwTMDAw
+MiA0ODE0NjMwODEwMDAzNjEZMBcGA1UEAwwQQ2VydGlnbmEgUm9vdCBDQTAeFw0x
+MzEwMDEwODMyMjdaFw0zMzEwMDEwODMyMjdaMFoxCzAJBgNVBAYTAkZSMRIwEAYD
+VQQKDAlEaGlteW90aXMxHDAaBgNVBAsMEzAwMDIgNDgxNDYzMDgxMDAwMzYxGTAX
+BgNVBAMMEENlcnRpZ25hIFJvb3QgQ0EwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAw
+ggIKAoICAQDNGDllGlmx6mQWDoyUJJV8g9PFOSbcDO8WV43X2KyjQn+Cyu3NW9sO
+ty3tRQgXstmzy9YXUnIo245Onoq2C/mehJpNdt4iKVzSs9IGPjA5qXSjklYcoW9M
+CiBtnyN6tMbaLOQdLNyzKNAT8kxOAkmhVECe5uUFoC2EyP+YbNDrihqECB63aCPu
+I9Vwzm1RaRDuoXrC0SIxwoKF0vJVdlB8JXrJhFwLrN1CTivngqIkicuQstDuI7pm
+TLtipPlTWmR7fJj6o0ieD5Wupxj0auwuA0Wv8HT4Ks16XdG+RCYyKfHx9WzMfgIh
+C59vpD++nVPiz32pLHxYGpfhPTc3GGYo0kDFUYqMwy3OU4gkWGQwFsWq4NYKpkDf
+ePb1BHxpE4S80dGnBs8B92jAqFe7OmGtBIyT46388NtEbVncSVmurJqZNjBBe3Yz
+IoejwpKGbvlw7q6Hh5UbxHq9MfPU0uWZ/75I7HX1eBYdpnDBfzwboZL7z8g81sWT
+Co/1VTp2lc5ZmIoJlXcymoO6LAQ6l73UL77XbJuiyn1tJslV1c/DeVIICZkHJC1k
+JWumIWmbat10TWuXekG9qxf5kBdIjzb5LdXF2+6qhUVB+s06RbFo5jZMm5BX7CO5
+hwjCxAnxl4YqKE3idMDaxIzb3+KhF1nOJFl0Mdp//TBt2dzhauH8XwIDAQABo4IB
+GjCCARYwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
+FBiHVuBud+4kNTxOc5of1uHieX4rMB8GA1UdIwQYMBaAFBiHVuBud+4kNTxOc5of
+1uHieX4rMEQGA1UdIAQ9MDswOQYEVR0gADAxMC8GCCsGAQUFBwIBFiNodHRwczov
+L3d3d3cuY2VydGlnbmEuZnIvYXV0b3JpdGVzLzBtBgNVHR8EZjBkMC+gLaArhilo
+dHRwOi8vY3JsLmNlcnRpZ25hLmZyL2NlcnRpZ25hcm9vdGNhLmNybDAxoC+gLYYr
+aHR0cDovL2NybC5kaGlteW90aXMuY29tL2NlcnRpZ25hcm9vdGNhLmNybDANBgkq
+hkiG9w0BAQsFAAOCAgEAlLieT/DjlQgi581oQfccVdV8AOItOoldaDgvUSILSo3L
+6btdPrtcPbEo/uRTVRPPoZAbAh1fZkYJMyjhDSSXcNMQH+pkV5a7XdrnxIxPTGRG
+HVyH41neQtGbqH6mid2PHMkwgu07nM3A6RngatgCdTer9zQoKJHyBApPNeNgJgH6
+0BGM+RFq7q89w1DTj18zeTyGqHNFkIwgtnJzFyO+B2XleJINugHA64wcZr+shncB
+lA2c5uk5jR+mUYyZDDl34bSb+hxnV29qao6pK0xXeXpXIs/NX2NGjVxZOob4Mkdi
+o2cNGJHc+6Zr9UhhcyNZjgKnvETq9Emd8VRY+WCv2hikLyhF3HqgiIZd8zvn/yk1
+gPxkQ5Tm4xxvvq0OKmOZK8l+hfZx6AYDlf7ej0gcWtSS6Cvu5zHbugRqh5jnxV/v
+faci9wHYTfmJ0A6aBVmknpjZbyvKcL5kwlWj9Omvw5Ip3IgWJJk8jSaYtlu3zM63
+Nwf9JtmYhST/WSMDmu2dnajkXjjO11INb9I/bbEFa0nOipFGc/T2L/Coc3cOZayh
+jWZSaX5LaAzHHjcng6WMxwLkFM1JAbBzs/3GkDpv0mztO+7skb6iQ12LAEpmJURw
+3kAP+HwV96LOPNdeE4yBFxgX0b3xdxA61GU5wSesVywlVP+i2k+KYTlerj1KjL0=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign Root CA - G1 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign Root CA - G1"
+# Serial: 235931866688319308814040
+# MD5 Fingerprint: 9c:42:84:57:dd:cb:0b:a7:2e:95:ad:b6:f3:da:bc:ac
+# SHA1 Fingerprint: 8a:c7:ad:8f:73:ac:4e:c1:b5:75:4d:a5:40:f4:fc:cf:7c:b5:8e:8c
+# SHA256 Fingerprint: 40:f6:af:03:46:a9:9a:a1:cd:1d:55:5a:4e:9c:ce:62:c7:f9:63:46:03:ee:40:66:15:83:3d:c8:c8:d0:03:67
+-----BEGIN CERTIFICATE-----
+MIIDlDCCAnygAwIBAgIKMfXkYgxsWO3W2DANBgkqhkiG9w0BAQsFADBnMQswCQYD
+VQQGEwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBU
+ZWNobm9sb2dpZXMgTGltaXRlZDEcMBoGA1UEAxMTZW1TaWduIFJvb3QgQ0EgLSBH
+MTAeFw0xODAyMTgxODMwMDBaFw00MzAyMTgxODMwMDBaMGcxCzAJBgNVBAYTAklO
+MRMwEQYDVQQLEwplbVNpZ24gUEtJMSUwIwYDVQQKExxlTXVkaHJhIFRlY2hub2xv
+Z2llcyBMaW1pdGVkMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEcxMIIBIjAN
+BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAk0u76WaK7p1b1TST0Bsew+eeuGQz
+f2N4aLTNLnF115sgxk0pvLZoYIr3IZpWNVrzdr3YzZr/k1ZLpVkGoZM0Kd0WNHVO
+8oG0x5ZOrRkVUkr+PHB1cM2vK6sVmjM8qrOLqs1D/fXqcP/tzxE7lM5OMhbTI0Aq
+d7OvPAEsbO2ZLIvZTmmYsvePQbAyeGHWDV/D+qJAkh1cF+ZwPjXnorfCYuKrpDhM
+tTk1b+oDafo6VGiFbdbyL0NVHpENDtjVaqSW0RM8LHhQ6DqS0hdW5TUaQBw+jSzt
+Od9C4INBdN+jzcKGYEho42kLVACL5HZpIQ15TjQIXhTCzLG3rdd8cIrHhQIDAQAB
+o0IwQDAdBgNVHQ4EFgQU++8Nhp6w492pufEhF38+/PB3KxowDgYDVR0PAQH/BAQD
+AgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAFn/8oz1h31x
+PaOfG1vR2vjTnGs2vZupYeveFix0PZ7mddrXuqe8QhfnPZHr5X3dPpzxz5KsbEjM
+wiI/aTvFthUvozXGaCocV685743QNcMYDHsAVhzNixl03r4PEuDQqqE/AjSxcM6d
+GNYIAwlG7mDgfrbESQRRfXBgvKqy/3lyeqYdPV8q+Mri/Tm3R7nrft8EI6/6nAYH
+6ftjk4BAtcZsCjEozgyfz7MjNYBBjWzEN3uBL4ChQEKF6dk4jeihU80Bv2noWgby
+RQuQ+q7hv53yrlc8pa6yVvSLZUDp/TGBLPQ5Cdjua6e0ph0VpZj3AYHYhX3zUVxx
+iN66zB+Afko=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - G3 O=eMudhra Technologies Limited OU=emSign PKI
+# Label: "emSign ECC Root CA - G3"
+# Serial: 287880440101571086945156
+# MD5 Fingerprint: ce:0b:72:d1:9f:88:8e:d0:50:03:e8:e3:b8:8b:67:40
+# SHA1 Fingerprint: 30:43:fa:4f:f2:57:dc:a0:c3:80:ee:2e:58:ea:78:b2:3f:e6:bb:c1
+# SHA256 Fingerprint: 86:a1:ec:ba:08:9c:4a:8d:3b:be:27:34:c6:12:ba:34:1d:81:3e:04:3c:f9:e8:a8:62:cd:5c:57:a3:6b:be:6b
+-----BEGIN CERTIFICATE-----
+MIICTjCCAdOgAwIBAgIKPPYHqWhwDtqLhDAKBggqhkjOPQQDAzBrMQswCQYDVQQG
+EwJJTjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNo
+bm9sb2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0g
+RzMwHhcNMTgwMjE4MTgzMDAwWhcNNDMwMjE4MTgzMDAwWjBrMQswCQYDVQQGEwJJ
+TjETMBEGA1UECxMKZW1TaWduIFBLSTElMCMGA1UEChMcZU11ZGhyYSBUZWNobm9s
+b2dpZXMgTGltaXRlZDEgMB4GA1UEAxMXZW1TaWduIEVDQyBSb290IENBIC0gRzMw
+djAQBgcqhkjOPQIBBgUrgQQAIgNiAAQjpQy4LRL1KPOxst3iAhKAnjlfSU2fySU0
+WXTsuwYc58Byr+iuL+FBVIcUqEqy6HyC5ltqtdyzdc6LBtCGI79G1Y4PPwT01xyS
+fvalY8L1X44uT6EYGQIrMgqCZH0Wk9GjQjBAMB0GA1UdDgQWBBR8XQKEE9TMipuB
+zhccLikenEhjQjAOBgNVHQ8BAf8EBAMCAQYwDwYDVR0TAQH/BAUwAwEB/zAKBggq
+hkjOPQQDAwNpADBmAjEAvvNhzwIQHWSVB7gYboiFBS+DCBeQyh+KTOgNG3qxrdWB
+CUfvO6wIBHxcmbHtRwfSAjEAnbpV/KlK6O3t5nYBQnvI+GDZjVGLVTv7jHvrZQnD
++JbNR6iC8hZVdyR+EhCVBCyj
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign Root CA - C1 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign Root CA - C1"
+# Serial: 825510296613316004955058
+# MD5 Fingerprint: d8:e3:5d:01:21:fa:78:5a:b0:df:ba:d2:ee:2a:5f:68
+# SHA1 Fingerprint: e7:2e:f1:df:fc:b2:09:28:cf:5d:d4:d5:67:37:b1:51:cb:86:4f:01
+# SHA256 Fingerprint: 12:56:09:aa:30:1d:a0:a2:49:b9:7a:82:39:cb:6a:34:21:6f:44:dc:ac:9f:39:54:b1:42:92:f2:e8:c8:60:8f
+-----BEGIN CERTIFICATE-----
+MIIDczCCAlugAwIBAgILAK7PALrEzzL4Q7IwDQYJKoZIhvcNAQELBQAwVjELMAkG
+A1UEBhMCVVMxEzARBgNVBAsTCmVtU2lnbiBQS0kxFDASBgNVBAoTC2VNdWRocmEg
+SW5jMRwwGgYDVQQDExNlbVNpZ24gUm9vdCBDQSAtIEMxMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowVjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMRwwGgYDVQQDExNlbVNpZ24gUm9v
+dCBDQSAtIEMxMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAz+upufGZ
+BczYKCFK83M0UYRWEPWgTywS4/oTmifQz/l5GnRfHXk5/Fv4cI7gklL35CX5VIPZ
+HdPIWoU/Xse2B+4+wM6ar6xWQio5JXDWv7V7Nq2s9nPczdcdioOl+yuQFTdrHCZH
+3DspVpNqs8FqOp099cGXOFgFixwR4+S0uF2FHYP+eF8LRWgYSKVGczQ7/g/IdrvH
+GPMF0Ybzhe3nudkyrVWIzqa2kbBPrH4VI5b2P/AgNBbeCsbEBEV5f6f9vtKppa+c
+xSMq9zwhbL2vj07FOrLzNBL834AaSaTUqZX3noleoomslMuoaJuvimUnzYnu3Yy1
+aylwQ6BpC+S5DwIDAQABo0IwQDAdBgNVHQ4EFgQU/qHgcB4qAzlSWkK+XJGFehiq
+TbUwDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wDQYJKoZIhvcNAQEL
+BQADggEBAMJKVvoVIXsoounlHfv4LcQ5lkFMOycsxGwYFYDGrK9HWS8mC+M2sO87
+/kOXSTKZEhVb3xEp/6tT+LvBeA+snFOvV71ojD1pM/CjoCNjO2RnIkSt1XHLVip4
+kqNPEjE2NuLe/gDEo2APJ62gsIq1NnpSob0n9CAnYuhNlCQT5AoE6TyrLshDCUrG
+YQTlSTR+08TI9Q/Aqum6VF7zYytPT1DU/rl7mYw9wC68AivTxEDkigcxHpvOJpkT
++xHqmiIMERnHXhuBUDDIlhJu58tBf5E7oke3VIAb3ADMmpDqw8NQBmIMMMAVSKeo
+WXzhriKi4gp6D/piq1JM4fHfyr6DDUI=
+-----END CERTIFICATE-----
+
+# Issuer: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Subject: CN=emSign ECC Root CA - C3 O=eMudhra Inc OU=emSign PKI
+# Label: "emSign ECC Root CA - C3"
+# Serial: 582948710642506000014504
+# MD5 Fingerprint: 3e:53:b3:a3:81:ee:d7:10:f8:d3:b0:1d:17:92:f5:d5
+# SHA1 Fingerprint: b6:af:43:c2:9b:81:53:7d:f6:ef:6b:c3:1f:1f:60:15:0c:ee:48:66
+# SHA256 Fingerprint: bc:4d:80:9b:15:18:9d:78:db:3e:1d:8c:f4:f9:72:6a:79:5d:a1:64:3c:a5:f1:35:8e:1d:db:0e:dc:0d:7e:b3
+-----BEGIN CERTIFICATE-----
+MIICKzCCAbGgAwIBAgIKe3G2gla4EnycqDAKBggqhkjOPQQDAzBaMQswCQYDVQQG
+EwJVUzETMBEGA1UECxMKZW1TaWduIFBLSTEUMBIGA1UEChMLZU11ZGhyYSBJbmMx
+IDAeBgNVBAMTF2VtU2lnbiBFQ0MgUm9vdCBDQSAtIEMzMB4XDTE4MDIxODE4MzAw
+MFoXDTQzMDIxODE4MzAwMFowWjELMAkGA1UEBhMCVVMxEzARBgNVBAsTCmVtU2ln
+biBQS0kxFDASBgNVBAoTC2VNdWRocmEgSW5jMSAwHgYDVQQDExdlbVNpZ24gRUND
+IFJvb3QgQ0EgLSBDMzB2MBAGByqGSM49AgEGBSuBBAAiA2IABP2lYa57JhAd6bci
+MK4G9IGzsUJxlTm801Ljr6/58pc1kjZGDoeVjbk5Wum739D+yAdBPLtVb4Ojavti
+sIGJAnB9SMVK4+kiVCJNk7tCDK93nCOmfddhEc5lx/h//vXyqaNCMEAwHQYDVR0O
+BBYEFPtaSNCAIEDyqOkAB2kZd6fmw/TPMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMB
+Af8EBTADAQH/MAoGCCqGSM49BAMDA2gAMGUCMQC02C8Cif22TGK6Q04ThHK1rt0c
+3ta13FaPWEBaLd4gTCKDypOofu4SQMfWh0/434UCMBwUZOR8loMRnLDRWmFLpg9J
+0wD8ofzkpf9/rdcw0Md3f76BB1UwUCAU9Vc4CqgxUQ==
+-----END CERTIFICATE-----
+
+# Issuer: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Subject: CN=Hongkong Post Root CA 3 O=Hongkong Post
+# Label: "Hongkong Post Root CA 3"
+# Serial: 46170865288971385588281144162979347873371282084
+# MD5 Fingerprint: 11:fc:9f:bd:73:30:02:8a:fd:3f:f3:58:b9:cb:20:f0
+# SHA1 Fingerprint: 58:a2:d0:ec:20:52:81:5b:c1:f3:f8:64:02:24:4e:c2:8e:02:4b:02
+# SHA256 Fingerprint: 5a:2f:c0:3f:0c:83:b0:90:bb:fa:40:60:4b:09:88:44:6c:76:36:18:3d:f9:84:6e:17:10:1a:44:7f:b8:ef:d6
+-----BEGIN CERTIFICATE-----
+MIIFzzCCA7egAwIBAgIUCBZfikyl7ADJk0DfxMauI7gcWqQwDQYJKoZIhvcNAQEL
+BQAwbzELMAkGA1UEBhMCSEsxEjAQBgNVBAgTCUhvbmcgS29uZzESMBAGA1UEBxMJ
+SG9uZyBLb25nMRYwFAYDVQQKEw1Ib25na29uZyBQb3N0MSAwHgYDVQQDExdIb25n
+a29uZyBQb3N0IFJvb3QgQ0EgMzAeFw0xNzA2MDMwMjI5NDZaFw00MjA2MDMwMjI5
+NDZaMG8xCzAJBgNVBAYTAkhLMRIwEAYDVQQIEwlIb25nIEtvbmcxEjAQBgNVBAcT
+CUhvbmcgS29uZzEWMBQGA1UEChMNSG9uZ2tvbmcgUG9zdDEgMB4GA1UEAxMXSG9u
+Z2tvbmcgUG9zdCBSb290IENBIDMwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIK
+AoICAQCziNfqzg8gTr7m1gNt7ln8wlffKWihgw4+aMdoWJwcYEuJQwy51BWy7sFO
+dem1p+/l6TWZ5Mwc50tfjTMwIDNT2aa71T4Tjukfh0mtUC1Qyhi+AViiE3CWu4mI
+VoBc+L0sPOFMV4i707mV78vH9toxdCim5lSJ9UExyuUmGs2C4HDaOym71QP1mbpV
+9WTRYA6ziUm4ii8F0oRFKHyPaFASePwLtVPLwpgchKOesL4jpNrcyCse2m5FHomY
+2vkALgbpDDtw1VAliJnLzXNg99X/NWfFobxeq81KuEXryGgeDQ0URhLj0mRiikKY
+vLTGCAj4/ahMZJx2Ab0vqWwzD9g/KLg8aQFChn5pwckGyuV6RmXpwtZQQS4/t+Tt
+bNe/JgERohYpSms0BpDsE9K2+2p20jzt8NYt3eEV7KObLyzJPivkaTv/ciWxNoZb
+x39ri1UbSsUgYT2uy1DhCDq+sI9jQVMwCFk8mB13umOResoQUGC/8Ne8lYePl8X+
+l2oBlKN8W4UdKjk60FSh0Tlxnf0h+bV78OLgAo9uliQlLKAeLKjEiafv7ZkGL7YK
+TE/bosw3Gq9HhS2KX8Q0NEwA/RiTZxPRN+ZItIsGxVd7GYYKecsAyVKvQv83j+Gj
+Hno9UKtjBucVtT+2RTeUN7F+8kjDf8V1/peNRY8apxpyKBpADwIDAQABo2MwYTAP
+BgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAfBgNVHSMEGDAWgBQXnc0e
+i9Y5K3DTXNSguB+wAPzFYTAdBgNVHQ4EFgQUF53NHovWOStw01zUoLgfsAD8xWEw
+DQYJKoZIhvcNAQELBQADggIBAFbVe27mIgHSQpsY1Q7XZiNc4/6gx5LS6ZStS6LG
+7BJ8dNVI0lkUmcDrudHr9EgwW62nV3OZqdPlt9EuWSRY3GguLmLYauRwCy0gUCCk
+MpXRAJi70/33MvJJrsZ64Ee+bs7Lo3I6LWldy8joRTnU+kLBEUx3XZL7av9YROXr
+gZ6voJmtvqkBZss4HTzfQx/0TW60uhdG/H39h4F5ag0zD/ov+BS5gLNdTaqX4fnk
+GMX41TiMJjz98iji7lpJiCzfeT2OnpA8vUFKOt1b9pq0zj8lMH8yfaIDlNDceqFS
+3m6TjRgm/VWsvY+b0s+v54Ysyx8Jb6NvqYTUc79NoXQbTiNg8swOqn+knEwlqLJm
+Ozj/2ZQw9nKEvmhVEA/GcywWaZMH/rFF7buiVWqw2rVKAiUnhde3t4ZEFolsgCs+
+l6mc1X5VTMbeRRAc6uk7nwNT7u56AQIWeNTowr5GdogTPyK7SBIdUgC0An4hGh6c
+JfTzPV4e0hz5sy229zdcxsshTrD3mUcYhcErulWuBurQB7Lcq9CClnXO0lD+mefP
+L5/ndtFhKvshuzHQqp9HpLIiyhY6UFfEW0NnxWViA0kB60PZ2Pierc+xYw5F9KBa
+LJstxabArahH9CdMOA0uG0k7UvToiIMrVCjU8jVStDKDYmlkDJGcn5fqdBb9HxEG
+mpv0
+-----END CERTIFICATE-----
+
+# Issuer: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Subject: CN=Entrust Root Certification Authority - G4 O=Entrust, Inc. OU=See www.entrust.net/legal-terms/(c) 2015 Entrust, Inc. - for authorized use only
+# Label: "Entrust Root Certification Authority - G4"
+# Serial: 289383649854506086828220374796556676440
+# MD5 Fingerprint: 89:53:f1:83:23:b7:7c:8e:05:f1:8c:71:38:4e:1f:88
+# SHA1 Fingerprint: 14:88:4e:86:26:37:b0:26:af:59:62:5c:40:77:ec:35:29:ba:96:01
+# SHA256 Fingerprint: db:35:17:d1:f6:73:2a:2d:5a:b9:7c:53:3e:c7:07:79:ee:32:70:a6:2f:b4:ac:42:38:37:24:60:e6:f0:1e:88
+-----BEGIN CERTIFICATE-----
+MIIGSzCCBDOgAwIBAgIRANm1Q3+vqTkPAAAAAFVlrVgwDQYJKoZIhvcNAQELBQAw
+gb4xCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQL
+Ex9TZWUgd3d3LmVudHJ1c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykg
+MjAxNSBFbnRydXN0LCBJbmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAw
+BgNVBAMTKUVudHJ1c3QgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0
+MB4XDTE1MDUyNzExMTExNloXDTM3MTIyNzExNDExNlowgb4xCzAJBgNVBAYTAlVT
+MRYwFAYDVQQKEw1FbnRydXN0LCBJbmMuMSgwJgYDVQQLEx9TZWUgd3d3LmVudHJ1
+c3QubmV0L2xlZ2FsLXRlcm1zMTkwNwYDVQQLEzAoYykgMjAxNSBFbnRydXN0LCBJ
+bmMuIC0gZm9yIGF1dGhvcml6ZWQgdXNlIG9ubHkxMjAwBgNVBAMTKUVudHJ1c3Qg
+Um9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIEc0MIICIjANBgkqhkiG9w0B
+AQEFAAOCAg8AMIICCgKCAgEAsewsQu7i0TD/pZJH4i3DumSXbcr3DbVZwbPLqGgZ
+2K+EbTBwXX7zLtJTmeH+H17ZSK9dE43b/2MzTdMAArzE+NEGCJR5WIoV3imz/f3E
+T+iq4qA7ec2/a0My3dl0ELn39GjUu9CH1apLiipvKgS1sqbHoHrmSKvS0VnM1n4j
+5pds8ELl3FFLFUHtSUrJ3hCX1nbB76W1NhSXNdh4IjVS70O92yfbYVaCNNzLiGAM
+C1rlLAHGVK/XqsEQe9IFWrhAnoanw5CGAlZSCXqc0ieCU0plUmr1POeo8pyvi73T
+DtTUXm6Hnmo9RR3RXRv06QqsYJn7ibT/mCzPfB3pAqoEmh643IhuJbNsZvc8kPNX
+wbMv9W3y+8qh+CmdRouzavbmZwe+LGcKKh9asj5XxNMhIWNlUpEbsZmOeX7m640A
+2Vqq6nPopIICR5b+W45UYaPrL0swsIsjdXJ8ITzI9vF01Bx7owVV7rtNOzK+mndm
+nqxpkCIHH2E6lr7lmk/MBTwoWdPBDFSoWWG9yHJM6Nyfh3+9nEg2XpWjDrk4JFX8
+dWbrAuMINClKxuMrLzOg2qOGpRKX/YAr2hRC45K9PvJdXmd0LhyIRyk0X+IyqJwl
+N4y6mACXi0mWHv0liqzc2thddG5msP9E36EYxr5ILzeUePiVSj9/E15dWf10hkNj
+c0kCAwEAAaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYD
+VR0OBBYEFJ84xFYjwznooHFs6FRM5Og6sb9nMA0GCSqGSIb3DQEBCwUAA4ICAQAS
+5UKme4sPDORGpbZgQIeMJX6tuGguW8ZAdjwD+MlZ9POrYs4QjbRaZIxowLByQzTS
+Gwv2LFPSypBLhmb8qoMi9IsabyZIrHZ3CL/FmFz0Jomee8O5ZDIBf9PD3Vht7LGr
+hFV0d4QEJ1JrhkzO3bll/9bGXp+aEJlLdWr+aumXIOTkdnrG0CSqkM0gkLpHZPt/
+B7NTeLUKYvJzQ85BK4FqLoUWlFPUa19yIqtRLULVAJyZv967lDtX/Zr1hstWO1uI
+AeV8KEsD+UmDfLJ/fOPtjqF/YFOOVZ1QNBIPt5d7bIdKROf1beyAN/BYGW5KaHbw
+H5Lk6rWS02FREAutp9lfx1/cH6NcjKF+m7ee01ZvZl4HliDtC3T7Zk6LERXpgUl+
+b7DUUH8i119lAg2m9IUe2K4GS0qn0jFmwvjO5QimpAKWRGhXxNUzzxkvFMSUHHuk
+2fCfDrGA4tGeEWSpiBE6doLlYsKA2KSD7ZPvfC+QsDJMlhVoSFLUmQjAJOgc47Ol
+IQ6SwJAfzyBfyjs4x7dtOvPmRLgOMWuIjnDrnBdSqEGULoe256YSxXXfW8AKbnuk
+5F6G+TaU33fD6Q3AOfF5u0aOq0NZJ7cguyPpVkAh7DE9ZapD8j3fcEThuk0mEDuY
+n/PIjhs4ViFqUZPTkcpG2om3PVODLAgfi49T3f+sHw==
+-----END CERTIFICATE-----
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/core.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..53404e133ff5a22e80bb3d87e37cac0d172c498e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/certifi/core.py
@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+
+"""
+certifi.py
+~~~~~~~~~~
+
+This module returns the installation location of cacert.pem.
+"""
+import os
+
+
+def where():
+    f = os.path.dirname(__file__)
+
+    return '/etc/ssl/certs/ca-certificates.crt'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..29225eee9edcd72c6a354550a5a3bedf1932b2ef
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/LICENSE
@@ -0,0 +1,26 @@
+
+Except when otherwise stated (look for LICENSE files in directories or
+information at the beginning of each file) all software and
+documentation is licensed as follows: 
+
+    The MIT License
+
+    Permission is hereby granted, free of charge, to any person 
+    obtaining a copy of this software and associated documentation 
+    files (the "Software"), to deal in the Software without 
+    restriction, including without limitation the rights to use, 
+    copy, modify, merge, publish, distribute, sublicense, and/or 
+    sell copies of the Software, and to permit persons to whom the 
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included 
+    in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
+    OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+    THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+    DEALINGS IN THE SOFTWARE.
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..417da722da6484391c30736a4379b56e3b26f4d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/METADATA
@@ -0,0 +1,37 @@
+Metadata-Version: 2.1
+Name: cffi
+Version: 1.14.5
+Summary: Foreign Function Interface for Python calling C code.
+Home-page: http://cffi.readthedocs.org
+Author: Armin Rigo, Maciej Fijalkowski
+Author-email: python-cffi@googlegroups.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: pycparser
+
+
+CFFI
+====
+
+Foreign Function Interface for Python calling C code.
+Please see the `Documentation <http://cffi.readthedocs.org/>`_.
+
+Contact
+-------
+
+`Mailing list <https://groups.google.com/forum/#!forum/python-cffi>`_
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..187f18b00e33dff80278024c8e7d01f09f85dc65
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/RECORD
@@ -0,0 +1,45 @@
+_cffi_backend.cpython-38-x86_64-linux-gnu.so,sha256=xaT4emFoLaKFKgxsPR-DzE_RnqPMEWbaY2DtdmdQrmQ,893296
+cffi-1.14.5.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+cffi-1.14.5.dist-info/LICENSE,sha256=BLgPWwd7vtaICM_rreteNSPyqMmpZJXFh72W3x6sKjM,1294
+cffi-1.14.5.dist-info/METADATA,sha256=9cQJcfX8MjM9nlAXlHcCe-YmRy7Ez9IsA3eSoOdYYWY,1191
+cffi-1.14.5.dist-info/RECORD,,
+cffi-1.14.5.dist-info/WHEEL,sha256=Dh4w5P6PPWbqyqoE6MHlzbFQwZXlM-voWJDf2WUsS2g,108
+cffi-1.14.5.dist-info/entry_points.txt,sha256=Q9f5C9IpjYxo0d2PK9eUcnkgxHc9pHWwjEMaANPKNCI,76
+cffi-1.14.5.dist-info/top_level.txt,sha256=rE7WR3rZfNKxWI9-jn6hsHCAl7MDkB-FmuQbxWjFehQ,19
+cffi.libs/libffi-806b1a9d.so.6.0.4,sha256=0MxSFdTpPwKsulw1XmWPRPVreyFK3AIBBg7i6a3-rWY,46632
+cffi/__init__.py,sha256=xTe6YZU3-T1_hzu4x7LMs6afwrbhtwYaQ4oYCYTfy3M,513
+cffi/__pycache__/__init__.cpython-38.pyc,,
+cffi/__pycache__/api.cpython-38.pyc,,
+cffi/__pycache__/backend_ctypes.cpython-38.pyc,,
+cffi/__pycache__/cffi_opcode.cpython-38.pyc,,
+cffi/__pycache__/commontypes.cpython-38.pyc,,
+cffi/__pycache__/cparser.cpython-38.pyc,,
+cffi/__pycache__/error.cpython-38.pyc,,
+cffi/__pycache__/ffiplatform.cpython-38.pyc,,
+cffi/__pycache__/lock.cpython-38.pyc,,
+cffi/__pycache__/model.cpython-38.pyc,,
+cffi/__pycache__/pkgconfig.cpython-38.pyc,,
+cffi/__pycache__/recompiler.cpython-38.pyc,,
+cffi/__pycache__/setuptools_ext.cpython-38.pyc,,
+cffi/__pycache__/vengine_cpy.cpython-38.pyc,,
+cffi/__pycache__/vengine_gen.cpython-38.pyc,,
+cffi/__pycache__/verifier.cpython-38.pyc,,
+cffi/_cffi_errors.h,sha256=6nFQ-4dRQI1bXRoSeqdvyKU33TmutQJB_2fAhWSzdl8,3856
+cffi/_cffi_include.h,sha256=tKnA1rdSoPHp23FnDL1mDGwFo-Uj6fXfA6vA6kcoEUc,14800
+cffi/_embedding.h,sha256=vXP95nMKN_jwCGWenL3XugNPwa2Ko-yqqp0lA-Nh5-I,17581
+cffi/api.py,sha256=yxJalIePbr1mz_WxAHokSwyP5CVYde44m-nolHnbJNo,42064
+cffi/backend_ctypes.py,sha256=h5ZIzLc6BFVXnGyc9xPqZWUS7qGy7yFSDqXe68Sa8z4,42454
+cffi/cffi_opcode.py,sha256=v9RdD_ovA8rCtqsC95Ivki5V667rAOhGgs3fb2q9xpM,5724
+cffi/commontypes.py,sha256=QS4uxCDI7JhtTyjh1hlnCA-gynmaszWxJaRRLGkJa1A,2689
+cffi/cparser.py,sha256=rO_1pELRw1gI1DE1m4gi2ik5JMfpxouAACLXpRPlVEA,44231
+cffi/error.py,sha256=v6xTiS4U0kvDcy4h_BDRo5v39ZQuj-IMRYLv5ETddZs,877
+cffi/ffiplatform.py,sha256=HMXqR8ks2wtdsNxGaWpQ_PyqIvtiuos_vf1qKCy-cwg,4046
+cffi/lock.py,sha256=l9TTdwMIMpi6jDkJGnQgE9cvTIR7CAntIJr8EGHt3pY,747
+cffi/model.py,sha256=_GH_UF1Rn9vC4AvmgJm6qj7RUXXG3eqKPc8bPxxyBKE,21768
+cffi/parse_c_type.h,sha256=OdwQfwM9ktq6vlCB43exFQmxDBtj2MBNdK8LYl15tjw,5976
+cffi/pkgconfig.py,sha256=LP1w7vmWvmKwyqLaU1Z243FOWGNQMrgMUZrvgFuOlco,4374
+cffi/recompiler.py,sha256=7OBdKr0dAzRnEbgQvjCAikoFAygjTvitaJHdRGc1k24,64568
+cffi/setuptools_ext.py,sha256=RUR17N5f8gpiQBBlXL34P9FtOu1mhHIaAf3WJlg5S4I,8931
+cffi/vengine_cpy.py,sha256=YglN8YS-UaHEv2k2cxgotNWE87dHX20-68EyKoiKUYA,43320
+cffi/vengine_gen.py,sha256=5dX7s1DU6pTBOMI6oTVn_8Bnmru_lj932B6b4v29Hlg,26684
+cffi/verifier.py,sha256=J9Enz2rbJb9CHPqWlWQ5uQESoyr0uc7MNWugchjXBv4,11207
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..69d594f055a5127401ebe017f8837cef4c76c020
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-manylinux1_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..eee7e0fb1f493ea015a66ea46ae9c05c51ec5e18
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[distutils.setup_keywords]
+cffi_modules = cffi.setuptools_ext:cffi_modules
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f64577957eb0d893196994ae517759f3fa8e48dd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi-1.14.5.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_cffi_backend
+cffi
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi.libs/libffi-806b1a9d.so.6.0.4 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi.libs/libffi-806b1a9d.so.6.0.4
new file mode 100755
index 0000000000000000000000000000000000000000..7e0b3012805ee9dd64076988820be79345407832
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi.libs/libffi-806b1a9d.so.6.0.4 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b79c21f91d3cad22e1a07caad0960a2d0cfab388
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/__init__.py
@@ -0,0 +1,14 @@
+__all__ = ['FFI', 'VerificationError', 'VerificationMissing', 'CDefError',
+           'FFIError']
+
+from .api import FFI
+from .error import CDefError, FFIError, VerificationError, VerificationMissing
+from .error import PkgConfigError
+
+__version__ = "1.14.5"
+__version_info__ = (1, 14, 5)
+
+# The verifier module file names are based on the CRC32 of a string that
+# contains the following version number.  It may be older than __version__
+# if nothing is clearly incompatible.
+__version_verifier_modules__ = "0.8.6"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_errors.h b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_errors.h
new file mode 100644
index 0000000000000000000000000000000000000000..83cdad068d071fc4b0205051aae3c5b34416b29d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_errors.h
@@ -0,0 +1,147 @@
+#ifndef CFFI_MESSAGEBOX
+# ifdef _MSC_VER
+#  define CFFI_MESSAGEBOX  1
+# else
+#  define CFFI_MESSAGEBOX  0
+# endif
+#endif
+
+
+#if CFFI_MESSAGEBOX
+/* Windows only: logic to take the Python-CFFI embedding logic
+   initialization errors and display them in a background thread
+   with MessageBox.  The idea is that if the whole program closes
+   as a result of this problem, then likely it is already a console
+   program and you can read the stderr output in the console too.
+   If it is not a console program, then it will likely show its own
+   dialog to complain, or generally not abruptly close, and for this
+   case the background thread should stay alive.
+*/
+static void *volatile _cffi_bootstrap_text;
+
+static PyObject *_cffi_start_error_capture(void)
+{
+    PyObject *result = NULL;
+    PyObject *x, *m, *bi;
+
+    if (InterlockedCompareExchangePointer(&_cffi_bootstrap_text,
+            (void *)1, NULL) != NULL)
+        return (PyObject *)1;
+
+    m = PyImport_AddModule("_cffi_error_capture");
+    if (m == NULL)
+        goto error;
+
+    result = PyModule_GetDict(m);
+    if (result == NULL)
+        goto error;
+
+#if PY_MAJOR_VERSION >= 3
+    bi = PyImport_ImportModule("builtins");
+#else
+    bi = PyImport_ImportModule("__builtin__");
+#endif
+    if (bi == NULL)
+        goto error;
+    PyDict_SetItemString(result, "__builtins__", bi);
+    Py_DECREF(bi);
+
+    x = PyRun_String(
+        "import sys\n"
+        "class FileLike:\n"
+        "  def write(self, x):\n"
+        "    try:\n"
+        "      of.write(x)\n"
+        "    except: pass\n"
+        "    self.buf += x\n"
+        "fl = FileLike()\n"
+        "fl.buf = ''\n"
+        "of = sys.stderr\n"
+        "sys.stderr = fl\n"
+        "def done():\n"
+        "  sys.stderr = of\n"
+        "  return fl.buf\n",   /* make sure the returned value stays alive */
+        Py_file_input,
+        result, result);
+    Py_XDECREF(x);
+
+ error:
+    if (PyErr_Occurred())
+    {
+        PyErr_WriteUnraisable(Py_None);
+        PyErr_Clear();
+    }
+    return result;
+}
+
+#pragma comment(lib, "user32.lib")
+
+static DWORD WINAPI _cffi_bootstrap_dialog(LPVOID ignored)
+{
+    Sleep(666);    /* may be interrupted if the whole process is closing */
+#if PY_MAJOR_VERSION >= 3
+    MessageBoxW(NULL, (wchar_t *)_cffi_bootstrap_text,
+                L"Python-CFFI error",
+                MB_OK | MB_ICONERROR);
+#else
+    MessageBoxA(NULL, (char *)_cffi_bootstrap_text,
+                "Python-CFFI error",
+                MB_OK | MB_ICONERROR);
+#endif
+    _cffi_bootstrap_text = NULL;
+    return 0;
+}
+
+static void _cffi_stop_error_capture(PyObject *ecap)
+{
+    PyObject *s;
+    void *text;
+
+    if (ecap == (PyObject *)1)
+        return;
+
+    if (ecap == NULL)
+        goto error;
+
+    s = PyRun_String("done()", Py_eval_input, ecap, ecap);
+    if (s == NULL)
+        goto error;
+
+    /* Show a dialog box, but in a background thread, and
+       never show multiple dialog boxes at once. */
+#if PY_MAJOR_VERSION >= 3
+    text = PyUnicode_AsWideCharString(s, NULL);
+#else
+    text = PyString_AsString(s);
+#endif
+
+    _cffi_bootstrap_text = text;
+
+    if (text != NULL)
+    {
+        HANDLE h;
+        h = CreateThread(NULL, 0, _cffi_bootstrap_dialog,
+                         NULL, 0, NULL);
+        if (h != NULL)
+            CloseHandle(h);
+    }
+    /* decref the string, but it should stay alive as 'fl.buf'
+       in the small module above.  It will really be freed only if
+       we later get another similar error.  So it's a leak of at
+       most one copy of the small module.  That's fine for this
+       situation which is usually a "fatal error" anyway. */
+    Py_DECREF(s);
+    PyErr_Clear();
+    return;
+
+  error:
+    _cffi_bootstrap_text = NULL;
+    PyErr_Clear();
+}
+
+#else
+
+static PyObject *_cffi_start_error_capture(void) { return NULL; }
+static void _cffi_stop_error_capture(PyObject *ecap) { }
+
+#endif
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_include.h b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_include.h
new file mode 100644
index 0000000000000000000000000000000000000000..e4c0a672405298ddb3dcb2e2ca6da9eea3d2e162
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_cffi_include.h
@@ -0,0 +1,385 @@
+#define _CFFI_
+
+/* We try to define Py_LIMITED_API before including Python.h.
+
+   Mess: we can only define it if Py_DEBUG, Py_TRACE_REFS and
+   Py_REF_DEBUG are not defined.  This is a best-effort approximation:
+   we can learn about Py_DEBUG from pyconfig.h, but it is unclear if
+   the same works for the other two macros.  Py_DEBUG implies them,
+   but not the other way around.
+
+   The implementation is messy (issue #350): on Windows, with _MSC_VER,
+   we have to define Py_LIMITED_API even before including pyconfig.h.
+   In that case, we guess what pyconfig.h will do to the macros above,
+   and check our guess after the #include.
+
+   Note that on Windows, with CPython 3.x, you need >= 3.5 and virtualenv
+   version >= 16.0.0.  With older versions of either, you don't get a
+   copy of PYTHON3.DLL in the virtualenv.  We can't check the version of
+   CPython *before* we even include pyconfig.h.  ffi.set_source() puts
+   a ``#define _CFFI_NO_LIMITED_API'' at the start of this file if it is
+   running on Windows < 3.5, as an attempt at fixing it, but that's
+   arguably wrong because it may not be the target version of Python.
+   Still better than nothing I guess.  As another workaround, you can
+   remove the definition of Py_LIMITED_API here.
+
+   See also 'py_limited_api' in cffi/setuptools_ext.py.
+*/
+#if !defined(_CFFI_USE_EMBEDDING) && !defined(Py_LIMITED_API)
+#  ifdef _MSC_VER
+#    if !defined(_DEBUG) && !defined(Py_DEBUG) && !defined(Py_TRACE_REFS) && !defined(Py_REF_DEBUG) && !defined(_CFFI_NO_LIMITED_API)
+#      define Py_LIMITED_API
+#    endif
+#    include <pyconfig.h>
+     /* sanity-check: Py_LIMITED_API will cause crashes if any of these
+        are also defined.  Normally, the Python file PC/pyconfig.h does not
+        cause any of these to be defined, with the exception that _DEBUG
+        causes Py_DEBUG.  Double-check that. */
+#    ifdef Py_LIMITED_API
+#      if defined(Py_DEBUG)
+#        error "pyconfig.h unexpectedly defines Py_DEBUG, but Py_LIMITED_API is set"
+#      endif
+#      if defined(Py_TRACE_REFS)
+#        error "pyconfig.h unexpectedly defines Py_TRACE_REFS, but Py_LIMITED_API is set"
+#      endif
+#      if defined(Py_REF_DEBUG)
+#        error "pyconfig.h unexpectedly defines Py_REF_DEBUG, but Py_LIMITED_API is set"
+#      endif
+#    endif
+#  else
+#    include <pyconfig.h>
+#    if !defined(Py_DEBUG) && !defined(Py_TRACE_REFS) && !defined(Py_REF_DEBUG) && !defined(_CFFI_NO_LIMITED_API)
+#      define Py_LIMITED_API
+#    endif
+#  endif
+#endif
+
+#include <Python.h>
+#ifdef __cplusplus
+extern "C" {
+#endif
+#include <stddef.h>
+#include "parse_c_type.h"
+
+/* this block of #ifs should be kept exactly identical between
+   c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py
+   and cffi/_cffi_include.h */
+#if defined(_MSC_VER)
+# include <malloc.h>   /* for alloca() */
+# if _MSC_VER < 1600   /* MSVC < 2010 */
+   typedef __int8 int8_t;
+   typedef __int16 int16_t;
+   typedef __int32 int32_t;
+   typedef __int64 int64_t;
+   typedef unsigned __int8 uint8_t;
+   typedef unsigned __int16 uint16_t;
+   typedef unsigned __int32 uint32_t;
+   typedef unsigned __int64 uint64_t;
+   typedef __int8 int_least8_t;
+   typedef __int16 int_least16_t;
+   typedef __int32 int_least32_t;
+   typedef __int64 int_least64_t;
+   typedef unsigned __int8 uint_least8_t;
+   typedef unsigned __int16 uint_least16_t;
+   typedef unsigned __int32 uint_least32_t;
+   typedef unsigned __int64 uint_least64_t;
+   typedef __int8 int_fast8_t;
+   typedef __int16 int_fast16_t;
+   typedef __int32 int_fast32_t;
+   typedef __int64 int_fast64_t;
+   typedef unsigned __int8 uint_fast8_t;
+   typedef unsigned __int16 uint_fast16_t;
+   typedef unsigned __int32 uint_fast32_t;
+   typedef unsigned __int64 uint_fast64_t;
+   typedef __int64 intmax_t;
+   typedef unsigned __int64 uintmax_t;
+# else
+#  include <stdint.h>
+# endif
+# if _MSC_VER < 1800   /* MSVC < 2013 */
+#  ifndef __cplusplus
+    typedef unsigned char _Bool;
+#  endif
+# endif
+#else
+# include <stdint.h>
+# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)
+#  include <alloca.h>
+# endif
+#endif
+
+#ifdef __GNUC__
+# define _CFFI_UNUSED_FN  __attribute__((unused))
+#else
+# define _CFFI_UNUSED_FN  /* nothing */
+#endif
+
+#ifdef __cplusplus
+# ifndef _Bool
+   typedef bool _Bool;   /* semi-hackish: C++ has no _Bool; bool is builtin */
+# endif
+#endif
+
+/**********  CPython-specific section  **********/
+#ifndef PYPY_VERSION
+
+
+#if PY_MAJOR_VERSION >= 3
+# define PyInt_FromLong PyLong_FromLong
+#endif
+
+#define _cffi_from_c_double PyFloat_FromDouble
+#define _cffi_from_c_float PyFloat_FromDouble
+#define _cffi_from_c_long PyInt_FromLong
+#define _cffi_from_c_ulong PyLong_FromUnsignedLong
+#define _cffi_from_c_longlong PyLong_FromLongLong
+#define _cffi_from_c_ulonglong PyLong_FromUnsignedLongLong
+#define _cffi_from_c__Bool PyBool_FromLong
+
+#define _cffi_to_c_double PyFloat_AsDouble
+#define _cffi_to_c_float PyFloat_AsDouble
+
+#define _cffi_from_c_int(x, type)                                        \
+    (((type)-1) > 0 ? /* unsigned */                                     \
+        (sizeof(type) < sizeof(long) ?                                   \
+            PyInt_FromLong((long)x) :                                    \
+         sizeof(type) == sizeof(long) ?                                  \
+            PyLong_FromUnsignedLong((unsigned long)x) :                  \
+            PyLong_FromUnsignedLongLong((unsigned long long)x)) :        \
+        (sizeof(type) <= sizeof(long) ?                                  \
+            PyInt_FromLong((long)x) :                                    \
+            PyLong_FromLongLong((long long)x)))
+
+#define _cffi_to_c_int(o, type)                                          \
+    ((type)(                                                             \
+     sizeof(type) == 1 ? (((type)-1) > 0 ? (type)_cffi_to_c_u8(o)        \
+                                         : (type)_cffi_to_c_i8(o)) :     \
+     sizeof(type) == 2 ? (((type)-1) > 0 ? (type)_cffi_to_c_u16(o)       \
+                                         : (type)_cffi_to_c_i16(o)) :    \
+     sizeof(type) == 4 ? (((type)-1) > 0 ? (type)_cffi_to_c_u32(o)       \
+                                         : (type)_cffi_to_c_i32(o)) :    \
+     sizeof(type) == 8 ? (((type)-1) > 0 ? (type)_cffi_to_c_u64(o)       \
+                                         : (type)_cffi_to_c_i64(o)) :    \
+     (Py_FatalError("unsupported size for type " #type), (type)0)))
+
+#define _cffi_to_c_i8                                                    \
+                 ((int(*)(PyObject *))_cffi_exports[1])
+#define _cffi_to_c_u8                                                    \
+                 ((int(*)(PyObject *))_cffi_exports[2])
+#define _cffi_to_c_i16                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[3])
+#define _cffi_to_c_u16                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[4])
+#define _cffi_to_c_i32                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[5])
+#define _cffi_to_c_u32                                                   \
+                 ((unsigned int(*)(PyObject *))_cffi_exports[6])
+#define _cffi_to_c_i64                                                   \
+                 ((long long(*)(PyObject *))_cffi_exports[7])
+#define _cffi_to_c_u64                                                   \
+                 ((unsigned long long(*)(PyObject *))_cffi_exports[8])
+#define _cffi_to_c_char                                                  \
+                 ((int(*)(PyObject *))_cffi_exports[9])
+#define _cffi_from_c_pointer                                             \
+    ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[10])
+#define _cffi_to_c_pointer                                               \
+    ((char *(*)(PyObject *, struct _cffi_ctypedescr *))_cffi_exports[11])
+#define _cffi_get_struct_layout                                          \
+    not used any more
+#define _cffi_restore_errno                                              \
+    ((void(*)(void))_cffi_exports[13])
+#define _cffi_save_errno                                                 \
+    ((void(*)(void))_cffi_exports[14])
+#define _cffi_from_c_char                                                \
+    ((PyObject *(*)(char))_cffi_exports[15])
+#define _cffi_from_c_deref                                               \
+    ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[16])
+#define _cffi_to_c                                                       \
+    ((int(*)(char *, struct _cffi_ctypedescr *, PyObject *))_cffi_exports[17])
+#define _cffi_from_c_struct                                              \
+    ((PyObject *(*)(char *, struct _cffi_ctypedescr *))_cffi_exports[18])
+#define _cffi_to_c_wchar_t                                               \
+    ((_cffi_wchar_t(*)(PyObject *))_cffi_exports[19])
+#define _cffi_from_c_wchar_t                                             \
+    ((PyObject *(*)(_cffi_wchar_t))_cffi_exports[20])
+#define _cffi_to_c_long_double                                           \
+    ((long double(*)(PyObject *))_cffi_exports[21])
+#define _cffi_to_c__Bool                                                 \
+    ((_Bool(*)(PyObject *))_cffi_exports[22])
+#define _cffi_prepare_pointer_call_argument                              \
+    ((Py_ssize_t(*)(struct _cffi_ctypedescr *,                           \
+                    PyObject *, char **))_cffi_exports[23])
+#define _cffi_convert_array_from_object                                  \
+    ((int(*)(char *, struct _cffi_ctypedescr *, PyObject *))_cffi_exports[24])
+#define _CFFI_CPIDX  25
+#define _cffi_call_python                                                \
+    ((void(*)(struct _cffi_externpy_s *, char *))_cffi_exports[_CFFI_CPIDX])
+#define _cffi_to_c_wchar3216_t                                           \
+    ((int(*)(PyObject *))_cffi_exports[26])
+#define _cffi_from_c_wchar3216_t                                         \
+    ((PyObject *(*)(int))_cffi_exports[27])
+#define _CFFI_NUM_EXPORTS 28
+
+struct _cffi_ctypedescr;
+
+static void *_cffi_exports[_CFFI_NUM_EXPORTS];
+
+#define _cffi_type(index)   (                           \
+    assert((((uintptr_t)_cffi_types[index]) & 1) == 0), \
+    (struct _cffi_ctypedescr *)_cffi_types[index])
+
+static PyObject *_cffi_init(const char *module_name, Py_ssize_t version,
+                            const struct _cffi_type_context_s *ctx)
+{
+    PyObject *module, *o_arg, *new_module;
+    void *raw[] = {
+        (void *)module_name,
+        (void *)version,
+        (void *)_cffi_exports,
+        (void *)ctx,
+    };
+
+    module = PyImport_ImportModule("_cffi_backend");
+    if (module == NULL)
+        goto failure;
+
+    o_arg = PyLong_FromVoidPtr((void *)raw);
+    if (o_arg == NULL)
+        goto failure;
+
+    new_module = PyObject_CallMethod(
+        module, (char *)"_init_cffi_1_0_external_module", (char *)"O", o_arg);
+
+    Py_DECREF(o_arg);
+    Py_DECREF(module);
+    return new_module;
+
+  failure:
+    Py_XDECREF(module);
+    return NULL;
+}
+
+
+#ifdef HAVE_WCHAR_H
+typedef wchar_t _cffi_wchar_t;
+#else
+typedef uint16_t _cffi_wchar_t;   /* same random pick as _cffi_backend.c */
+#endif
+
+_CFFI_UNUSED_FN static uint16_t _cffi_to_c_char16_t(PyObject *o)
+{
+    if (sizeof(_cffi_wchar_t) == 2)
+        return (uint16_t)_cffi_to_c_wchar_t(o);
+    else
+        return (uint16_t)_cffi_to_c_wchar3216_t(o);
+}
+
+_CFFI_UNUSED_FN static PyObject *_cffi_from_c_char16_t(uint16_t x)
+{
+    if (sizeof(_cffi_wchar_t) == 2)
+        return _cffi_from_c_wchar_t((_cffi_wchar_t)x);
+    else
+        return _cffi_from_c_wchar3216_t((int)x);
+}
+
+_CFFI_UNUSED_FN static int _cffi_to_c_char32_t(PyObject *o)
+{
+    if (sizeof(_cffi_wchar_t) == 4)
+        return (int)_cffi_to_c_wchar_t(o);
+    else
+        return (int)_cffi_to_c_wchar3216_t(o);
+}
+
+_CFFI_UNUSED_FN static PyObject *_cffi_from_c_char32_t(unsigned int x)
+{
+    if (sizeof(_cffi_wchar_t) == 4)
+        return _cffi_from_c_wchar_t((_cffi_wchar_t)x);
+    else
+        return _cffi_from_c_wchar3216_t((int)x);
+}
+
+union _cffi_union_alignment_u {
+    unsigned char m_char;
+    unsigned short m_short;
+    unsigned int m_int;
+    unsigned long m_long;
+    unsigned long long m_longlong;
+    float m_float;
+    double m_double;
+    long double m_longdouble;
+};
+
+struct _cffi_freeme_s {
+    struct _cffi_freeme_s *next;
+    union _cffi_union_alignment_u alignment;
+};
+
+_CFFI_UNUSED_FN static int
+_cffi_convert_array_argument(struct _cffi_ctypedescr *ctptr, PyObject *arg,
+                             char **output_data, Py_ssize_t datasize,
+                             struct _cffi_freeme_s **freeme)
+{
+    char *p;
+    if (datasize < 0)
+        return -1;
+
+    p = *output_data;
+    if (p == NULL) {
+        struct _cffi_freeme_s *fp = (struct _cffi_freeme_s *)PyObject_Malloc(
+            offsetof(struct _cffi_freeme_s, alignment) + (size_t)datasize);
+        if (fp == NULL)
+            return -1;
+        fp->next = *freeme;
+        *freeme = fp;
+        p = *output_data = (char *)&fp->alignment;
+    }
+    memset((void *)p, 0, (size_t)datasize);
+    return _cffi_convert_array_from_object(p, ctptr, arg);
+}
+
+_CFFI_UNUSED_FN static void
+_cffi_free_array_arguments(struct _cffi_freeme_s *freeme)
+{
+    do {
+        void *p = (void *)freeme;
+        freeme = freeme->next;
+        PyObject_Free(p);
+    } while (freeme != NULL);
+}
+
+/**********  end CPython-specific section  **********/
+#else
+_CFFI_UNUSED_FN
+static void (*_cffi_call_python_org)(struct _cffi_externpy_s *, char *);
+# define _cffi_call_python  _cffi_call_python_org
+#endif
+
+
+#define _cffi_array_len(array)   (sizeof(array) / sizeof((array)[0]))
+
+#define _cffi_prim_int(size, sign)                                      \
+    ((size) == 1 ? ((sign) ? _CFFI_PRIM_INT8  : _CFFI_PRIM_UINT8)  :    \
+     (size) == 2 ? ((sign) ? _CFFI_PRIM_INT16 : _CFFI_PRIM_UINT16) :    \
+     (size) == 4 ? ((sign) ? _CFFI_PRIM_INT32 : _CFFI_PRIM_UINT32) :    \
+     (size) == 8 ? ((sign) ? _CFFI_PRIM_INT64 : _CFFI_PRIM_UINT64) :    \
+     _CFFI__UNKNOWN_PRIM)
+
+#define _cffi_prim_float(size)                                          \
+    ((size) == sizeof(float) ? _CFFI_PRIM_FLOAT :                       \
+     (size) == sizeof(double) ? _CFFI_PRIM_DOUBLE :                     \
+     (size) == sizeof(long double) ? _CFFI__UNKNOWN_LONG_DOUBLE :       \
+     _CFFI__UNKNOWN_FLOAT_PRIM)
+
+#define _cffi_check_int(got, got_nonpos, expected)      \
+    ((got_nonpos) == (expected <= 0) &&                 \
+     (got) == (unsigned long long)expected)
+
+#ifdef MS_WIN32
+# define _cffi_stdcall  __stdcall
+#else
+# define _cffi_stdcall  /* nothing */
+#endif
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_embedding.h b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_embedding.h
new file mode 100644
index 0000000000000000000000000000000000000000..c36d79342d4b5a048fcd1e8deaa918fcd3b938a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/_embedding.h
@@ -0,0 +1,527 @@
+
+/***** Support code for embedding *****/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#if defined(_WIN32)
+#  define CFFI_DLLEXPORT  __declspec(dllexport)
+#elif defined(__GNUC__)
+#  define CFFI_DLLEXPORT  __attribute__((visibility("default")))
+#else
+#  define CFFI_DLLEXPORT  /* nothing */
+#endif
+
+
+/* There are two global variables of type _cffi_call_python_fnptr:
+
+   * _cffi_call_python, which we declare just below, is the one called
+     by ``extern "Python"`` implementations.
+
+   * _cffi_call_python_org, which on CPython is actually part of the
+     _cffi_exports[] array, is the function pointer copied from
+     _cffi_backend.
+
+   After initialization is complete, both are equal.  However, the
+   first one remains equal to &_cffi_start_and_call_python until the
+   very end of initialization, when we are (or should be) sure that
+   concurrent threads also see a completely initialized world, and
+   only then is it changed.
+*/
+#undef _cffi_call_python
+typedef void (*_cffi_call_python_fnptr)(struct _cffi_externpy_s *, char *);
+static void _cffi_start_and_call_python(struct _cffi_externpy_s *, char *);
+static _cffi_call_python_fnptr _cffi_call_python = &_cffi_start_and_call_python;
+
+
+#ifndef _MSC_VER
+   /* --- Assuming a GCC not infinitely old --- */
+# define cffi_compare_and_swap(l,o,n)  __sync_bool_compare_and_swap(l,o,n)
+# define cffi_write_barrier()          __sync_synchronize()
+# if !defined(__amd64__) && !defined(__x86_64__) &&   \
+     !defined(__i386__) && !defined(__i386)
+#   define cffi_read_barrier()         __sync_synchronize()
+# else
+#   define cffi_read_barrier()         (void)0
+# endif
+#else
+   /* --- Windows threads version --- */
+# include <Windows.h>
+# define cffi_compare_and_swap(l,o,n) \
+                               (InterlockedCompareExchangePointer(l,n,o) == (o))
+# define cffi_write_barrier()       InterlockedCompareExchange(&_cffi_dummy,0,0)
+# define cffi_read_barrier()           (void)0
+static volatile LONG _cffi_dummy;
+#endif
+
+#ifdef WITH_THREAD
+# ifndef _MSC_VER
+#  include <pthread.h>
+   static pthread_mutex_t _cffi_embed_startup_lock;
+# else
+   static CRITICAL_SECTION _cffi_embed_startup_lock;
+# endif
+  static char _cffi_embed_startup_lock_ready = 0;
+#endif
+
+static void _cffi_acquire_reentrant_mutex(void)
+{
+    static void *volatile lock = NULL;
+
+    while (!cffi_compare_and_swap(&lock, NULL, (void *)1)) {
+        /* should ideally do a spin loop instruction here, but
+           hard to do it portably and doesn't really matter I
+           think: pthread_mutex_init() should be very fast, and
+           this is only run at start-up anyway. */
+    }
+
+#ifdef WITH_THREAD
+    if (!_cffi_embed_startup_lock_ready) {
+# ifndef _MSC_VER
+        pthread_mutexattr_t attr;
+        pthread_mutexattr_init(&attr);
+        pthread_mutexattr_settype(&attr, PTHREAD_MUTEX_RECURSIVE);
+        pthread_mutex_init(&_cffi_embed_startup_lock, &attr);
+# else
+        InitializeCriticalSection(&_cffi_embed_startup_lock);
+# endif
+        _cffi_embed_startup_lock_ready = 1;
+    }
+#endif
+
+    while (!cffi_compare_and_swap(&lock, (void *)1, NULL))
+        ;
+
+#ifndef _MSC_VER
+    pthread_mutex_lock(&_cffi_embed_startup_lock);
+#else
+    EnterCriticalSection(&_cffi_embed_startup_lock);
+#endif
+}
+
+static void _cffi_release_reentrant_mutex(void)
+{
+#ifndef _MSC_VER
+    pthread_mutex_unlock(&_cffi_embed_startup_lock);
+#else
+    LeaveCriticalSection(&_cffi_embed_startup_lock);
+#endif
+}
+
+
+/**********  CPython-specific section  **********/
+#ifndef PYPY_VERSION
+
+#include "_cffi_errors.h"
+
+
+#define _cffi_call_python_org  _cffi_exports[_CFFI_CPIDX]
+
+PyMODINIT_FUNC _CFFI_PYTHON_STARTUP_FUNC(void);   /* forward */
+
+static void _cffi_py_initialize(void)
+{
+    /* XXX use initsigs=0, which "skips initialization registration of
+       signal handlers, which might be useful when Python is
+       embedded" according to the Python docs.  But review and think
+       if it should be a user-controllable setting.
+
+       XXX we should also give a way to write errors to a buffer
+       instead of to stderr.
+
+       XXX if importing 'site' fails, CPython (any version) calls
+       exit().  Should we try to work around this behavior here?
+    */
+    Py_InitializeEx(0);
+}
+
+static int _cffi_initialize_python(void)
+{
+    /* This initializes Python, imports _cffi_backend, and then the
+       present .dll/.so is set up as a CPython C extension module.
+    */
+    int result;
+    PyGILState_STATE state;
+    PyObject *pycode=NULL, *global_dict=NULL, *x;
+    PyObject *builtins;
+
+    state = PyGILState_Ensure();
+
+    /* Call the initxxx() function from the present module.  It will
+       create and initialize us as a CPython extension module, instead
+       of letting the startup Python code do it---it might reimport
+       the same .dll/.so and get maybe confused on some platforms.
+       It might also have troubles locating the .dll/.so again for all
+       I know.
+    */
+    (void)_CFFI_PYTHON_STARTUP_FUNC();
+    if (PyErr_Occurred())
+        goto error;
+
+    /* Now run the Python code provided to ffi.embedding_init_code().
+     */
+    pycode = Py_CompileString(_CFFI_PYTHON_STARTUP_CODE,
+                              "<init code for '" _CFFI_MODULE_NAME "'>",
+                              Py_file_input);
+    if (pycode == NULL)
+        goto error;
+    global_dict = PyDict_New();
+    if (global_dict == NULL)
+        goto error;
+    builtins = PyEval_GetBuiltins();
+    if (builtins == NULL)
+        goto error;
+    if (PyDict_SetItemString(global_dict, "__builtins__", builtins) < 0)
+        goto error;
+    x = PyEval_EvalCode(
+#if PY_MAJOR_VERSION < 3
+                        (PyCodeObject *)
+#endif
+                        pycode, global_dict, global_dict);
+    if (x == NULL)
+        goto error;
+    Py_DECREF(x);
+
+    /* Done!  Now if we've been called from
+       _cffi_start_and_call_python() in an ``extern "Python"``, we can
+       only hope that the Python code did correctly set up the
+       corresponding @ffi.def_extern() function.  Otherwise, the
+       general logic of ``extern "Python"`` functions (inside the
+       _cffi_backend module) will find that the reference is still
+       missing and print an error.
+     */
+    result = 0;
+ done:
+    Py_XDECREF(pycode);
+    Py_XDECREF(global_dict);
+    PyGILState_Release(state);
+    return result;
+
+ error:;
+    {
+        /* Print as much information as potentially useful.
+           Debugging load-time failures with embedding is not fun
+        */
+        PyObject *ecap;
+        PyObject *exception, *v, *tb, *f, *modules, *mod;
+        PyErr_Fetch(&exception, &v, &tb);
+        ecap = _cffi_start_error_capture();
+        f = PySys_GetObject((char *)"stderr");
+        if (f != NULL && f != Py_None) {
+            PyFile_WriteString(
+                "Failed to initialize the Python-CFFI embedding logic:\n\n", f);
+        }
+
+        if (exception != NULL) {
+            PyErr_NormalizeException(&exception, &v, &tb);
+            PyErr_Display(exception, v, tb);
+        }
+        Py_XDECREF(exception);
+        Py_XDECREF(v);
+        Py_XDECREF(tb);
+
+        if (f != NULL && f != Py_None) {
+            PyFile_WriteString("\nFrom: " _CFFI_MODULE_NAME
+                               "\ncompiled with cffi version: 1.14.5"
+                               "\n_cffi_backend module: ", f);
+            modules = PyImport_GetModuleDict();
+            mod = PyDict_GetItemString(modules, "_cffi_backend");
+            if (mod == NULL) {
+                PyFile_WriteString("not loaded", f);
+            }
+            else {
+                v = PyObject_GetAttrString(mod, "__file__");
+                PyFile_WriteObject(v, f, 0);
+                Py_XDECREF(v);
+            }
+            PyFile_WriteString("\nsys.path: ", f);
+            PyFile_WriteObject(PySys_GetObject((char *)"path"), f, 0);
+            PyFile_WriteString("\n\n", f);
+        }
+        _cffi_stop_error_capture(ecap);
+    }
+    result = -1;
+    goto done;
+}
+
+#if PY_VERSION_HEX < 0x03080000
+PyAPI_DATA(char *) _PyParser_TokenNames[];  /* from CPython */
+#endif
+
+static int _cffi_carefully_make_gil(void)
+{
+    /* This does the basic initialization of Python.  It can be called
+       completely concurrently from unrelated threads.  It assumes
+       that we don't hold the GIL before (if it exists), and we don't
+       hold it afterwards.
+
+       (What it really does used to be completely different in Python 2
+       and Python 3, with the Python 2 solution avoiding the spin-lock
+       around the Py_InitializeEx() call.  However, after recent changes
+       to CPython 2.7 (issue #358) it no longer works.  So we use the
+       Python 3 solution everywhere.)
+
+       This initializes Python by calling Py_InitializeEx().
+       Important: this must not be called concurrently at all.
+       So we use a global variable as a simple spin lock.  This global
+       variable must be from 'libpythonX.Y.so', not from this
+       cffi-based extension module, because it must be shared from
+       different cffi-based extension modules.
+
+       In Python < 3.8, we choose
+       _PyParser_TokenNames[0] as a completely arbitrary pointer value
+       that is never written to.  The default is to point to the
+       string "ENDMARKER".  We change it temporarily to point to the
+       next character in that string.  (Yes, I know it's REALLY
+       obscure.)
+
+       In Python >= 3.8, this string array is no longer writable, so
+       instead we pick PyCapsuleType.tp_version_tag.  We can't change
+       Python < 3.8 because someone might use a mixture of cffi
+       embedded modules, some of which were compiled before this file
+       changed.
+    */
+
+#ifdef WITH_THREAD
+# if PY_VERSION_HEX < 0x03080000
+    char *volatile *lock = (char *volatile *)_PyParser_TokenNames;
+    char *old_value, *locked_value;
+
+    while (1) {    /* spin loop */
+        old_value = *lock;
+        locked_value = old_value + 1;
+        if (old_value[0] == 'E') {
+            assert(old_value[1] == 'N');
+            if (cffi_compare_and_swap(lock, old_value, locked_value))
+                break;
+        }
+        else {
+            assert(old_value[0] == 'N');
+            /* should ideally do a spin loop instruction here, but
+               hard to do it portably and doesn't really matter I
+               think: PyEval_InitThreads() should be very fast, and
+               this is only run at start-up anyway. */
+        }
+    }
+# else
+    int volatile *lock = (int volatile *)&PyCapsule_Type.tp_version_tag;
+    int old_value, locked_value;
+    assert(!(PyCapsule_Type.tp_flags & Py_TPFLAGS_HAVE_VERSION_TAG));
+
+    while (1) {    /* spin loop */
+        old_value = *lock;
+        locked_value = -42;
+        if (old_value == 0) {
+            if (cffi_compare_and_swap(lock, old_value, locked_value))
+                break;
+        }
+        else {
+            assert(old_value == locked_value);
+            /* should ideally do a spin loop instruction here, but
+               hard to do it portably and doesn't really matter I
+               think: PyEval_InitThreads() should be very fast, and
+               this is only run at start-up anyway. */
+        }
+    }
+# endif
+#endif
+
+    /* call Py_InitializeEx() */
+    if (!Py_IsInitialized()) {
+        _cffi_py_initialize();
+#if PY_VERSION_HEX < 0x03070000
+        PyEval_InitThreads();
+#endif
+        PyEval_SaveThread();  /* release the GIL */
+        /* the returned tstate must be the one that has been stored into the
+           autoTLSkey by _PyGILState_Init() called from Py_Initialize(). */
+    }
+    else {
+#if PY_VERSION_HEX < 0x03070000
+        /* PyEval_InitThreads() is always a no-op from CPython 3.7 */
+        PyGILState_STATE state = PyGILState_Ensure();
+        PyEval_InitThreads();
+        PyGILState_Release(state);
+#endif
+    }
+
+#ifdef WITH_THREAD
+    /* release the lock */
+    while (!cffi_compare_and_swap(lock, locked_value, old_value))
+        ;
+#endif
+
+    return 0;
+}
+
+/**********  end CPython-specific section  **********/
+
+
+#else
+
+
+/**********  PyPy-specific section  **********/
+
+PyMODINIT_FUNC _CFFI_PYTHON_STARTUP_FUNC(const void *[]);   /* forward */
+
+static struct _cffi_pypy_init_s {
+    const char *name;
+    void *func;    /* function pointer */
+    const char *code;
+} _cffi_pypy_init = {
+    _CFFI_MODULE_NAME,
+    _CFFI_PYTHON_STARTUP_FUNC,
+    _CFFI_PYTHON_STARTUP_CODE,
+};
+
+extern int pypy_carefully_make_gil(const char *);
+extern int pypy_init_embedded_cffi_module(int, struct _cffi_pypy_init_s *);
+
+static int _cffi_carefully_make_gil(void)
+{
+    return pypy_carefully_make_gil(_CFFI_MODULE_NAME);
+}
+
+static int _cffi_initialize_python(void)
+{
+    return pypy_init_embedded_cffi_module(0xB011, &_cffi_pypy_init);
+}
+
+/**********  end PyPy-specific section  **********/
+
+
+#endif
+
+
+#ifdef __GNUC__
+__attribute__((noinline))
+#endif
+static _cffi_call_python_fnptr _cffi_start_python(void)
+{
+    /* Delicate logic to initialize Python.  This function can be
+       called multiple times concurrently, e.g. when the process calls
+       its first ``extern "Python"`` functions in multiple threads at
+       once.  It can also be called recursively, in which case we must
+       ignore it.  We also have to consider what occurs if several
+       different cffi-based extensions reach this code in parallel
+       threads---it is a different copy of the code, then, and we
+       can't have any shared global variable unless it comes from
+       'libpythonX.Y.so'.
+
+       Idea:
+
+       * _cffi_carefully_make_gil(): "carefully" call
+         PyEval_InitThreads() (possibly with Py_InitializeEx() first).
+
+       * then we use a (local) custom lock to make sure that a call to this
+         cffi-based extension will wait if another call to the *same*
+         extension is running the initialization in another thread.
+         It is reentrant, so that a recursive call will not block, but
+         only one from a different thread.
+
+       * then we grab the GIL and (Python 2) we call Py_InitializeEx().
+         At this point, concurrent calls to Py_InitializeEx() are not
+         possible: we have the GIL.
+
+       * do the rest of the specific initialization, which may
+         temporarily release the GIL but not the custom lock.
+         Only release the custom lock when we are done.
+    */
+    static char called = 0;
+
+    if (_cffi_carefully_make_gil() != 0)
+        return NULL;
+
+    _cffi_acquire_reentrant_mutex();
+
+    /* Here the GIL exists, but we don't have it.  We're only protected
+       from concurrency by the reentrant mutex. */
+
+    /* This file only initializes the embedded module once, the first
+       time this is called, even if there are subinterpreters. */
+    if (!called) {
+        called = 1;  /* invoke _cffi_initialize_python() only once,
+                        but don't set '_cffi_call_python' right now,
+                        otherwise concurrent threads won't call
+                        this function at all (we need them to wait) */
+        if (_cffi_initialize_python() == 0) {
+            /* now initialization is finished.  Switch to the fast-path. */
+
+            /* We would like nobody to see the new value of
+               '_cffi_call_python' without also seeing the rest of the
+               data initialized.  However, this is not possible.  But
+               the new value of '_cffi_call_python' is the function
+               'cffi_call_python()' from _cffi_backend.  So:  */
+            cffi_write_barrier();
+            /* ^^^ we put a write barrier here, and a corresponding
+               read barrier at the start of cffi_call_python().  This
+               ensures that after that read barrier, we see everything
+               done here before the write barrier.
+            */
+
+            assert(_cffi_call_python_org != NULL);
+            _cffi_call_python = (_cffi_call_python_fnptr)_cffi_call_python_org;
+        }
+        else {
+            /* initialization failed.  Reset this to NULL, even if it was
+               already set to some other value.  Future calls to
+               _cffi_start_python() are still forced to occur, and will
+               always return NULL from now on. */
+            _cffi_call_python_org = NULL;
+        }
+    }
+
+    _cffi_release_reentrant_mutex();
+
+    return (_cffi_call_python_fnptr)_cffi_call_python_org;
+}
+
+static
+void _cffi_start_and_call_python(struct _cffi_externpy_s *externpy, char *args)
+{
+    _cffi_call_python_fnptr fnptr;
+    int current_err = errno;
+#ifdef _MSC_VER
+    int current_lasterr = GetLastError();
+#endif
+    fnptr = _cffi_start_python();
+    if (fnptr == NULL) {
+        fprintf(stderr, "function %s() called, but initialization code "
+                        "failed.  Returning 0.\n", externpy->name);
+        memset(args, 0, externpy->size_of_result);
+    }
+#ifdef _MSC_VER
+    SetLastError(current_lasterr);
+#endif
+    errno = current_err;
+
+    if (fnptr != NULL)
+        fnptr(externpy, args);
+}
+
+
+/* The cffi_start_python() function makes sure Python is initialized
+   and our cffi module is set up.  It can be called manually from the
+   user C code.  The same effect is obtained automatically from any
+   dll-exported ``extern "Python"`` function.  This function returns
+   -1 if initialization failed, 0 if all is OK.  */
+_CFFI_UNUSED_FN
+static int cffi_start_python(void)
+{
+    if (_cffi_call_python == &_cffi_start_and_call_python) {
+        if (_cffi_start_python() == NULL)
+            return -1;
+    }
+    cffi_read_barrier();
+    return 0;
+}
+
+#undef cffi_compare_and_swap
+#undef cffi_write_barrier
+#undef cffi_read_barrier
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/api.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..999a8aefc4af0b27120823116212b0afe8484aad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/api.py
@@ -0,0 +1,965 @@
+import sys, types
+from .lock import allocate_lock
+from .error import CDefError
+from . import model
+
+try:
+    callable
+except NameError:
+    # Python 3.1
+    from collections import Callable
+    callable = lambda x: isinstance(x, Callable)
+
+try:
+    basestring
+except NameError:
+    # Python 3.x
+    basestring = str
+
+_unspecified = object()
+
+
+
+class FFI(object):
+    r'''
+    The main top-level class that you instantiate once, or once per module.
+
+    Example usage:
+
+        ffi = FFI()
+        ffi.cdef("""
+            int printf(const char *, ...);
+        """)
+
+        C = ffi.dlopen(None)   # standard library
+        -or-
+        C = ffi.verify()  # use a C compiler: verify the decl above is right
+
+        C.printf("hello, %s!\n", ffi.new("char[]", "world"))
+    '''
+
+    def __init__(self, backend=None):
+        """Create an FFI instance.  The 'backend' argument is used to
+        select a non-default backend, mostly for tests.
+        """
+        if backend is None:
+            # You need PyPy (>= 2.0 beta), or a CPython (>= 2.6) with
+            # _cffi_backend.so compiled.
+            import _cffi_backend as backend
+            from . import __version__
+            if backend.__version__ != __version__:
+                # bad version!  Try to be as explicit as possible.
+                if hasattr(backend, '__file__'):
+                    # CPython
+                    raise Exception("Version mismatch: this is the 'cffi' package version %s, located in %r.  When we import the top-level '_cffi_backend' extension module, we get version %s, located in %r.  The two versions should be equal; check your installation." % (
+                        __version__, __file__,
+                        backend.__version__, backend.__file__))
+                else:
+                    # PyPy
+                    raise Exception("Version mismatch: this is the 'cffi' package version %s, located in %r.  This interpreter comes with a built-in '_cffi_backend' module, which is version %s.  The two versions should be equal; check your installation." % (
+                        __version__, __file__, backend.__version__))
+            # (If you insist you can also try to pass the option
+            # 'backend=backend_ctypes.CTypesBackend()', but don't
+            # rely on it!  It's probably not going to work well.)
+
+        from . import cparser
+        self._backend = backend
+        self._lock = allocate_lock()
+        self._parser = cparser.Parser()
+        self._cached_btypes = {}
+        self._parsed_types = types.ModuleType('parsed_types').__dict__
+        self._new_types = types.ModuleType('new_types').__dict__
+        self._function_caches = []
+        self._libraries = []
+        self._cdefsources = []
+        self._included_ffis = []
+        self._windows_unicode = None
+        self._init_once_cache = {}
+        self._cdef_version = None
+        self._embedding = None
+        self._typecache = model.get_typecache(backend)
+        if hasattr(backend, 'set_ffi'):
+            backend.set_ffi(self)
+        for name in list(backend.__dict__):
+            if name.startswith('RTLD_'):
+                setattr(self, name, getattr(backend, name))
+        #
+        with self._lock:
+            self.BVoidP = self._get_cached_btype(model.voidp_type)
+            self.BCharA = self._get_cached_btype(model.char_array_type)
+        if isinstance(backend, types.ModuleType):
+            # _cffi_backend: attach these constants to the class
+            if not hasattr(FFI, 'NULL'):
+                FFI.NULL = self.cast(self.BVoidP, 0)
+                FFI.CData, FFI.CType = backend._get_types()
+        else:
+            # ctypes backend: attach these constants to the instance
+            self.NULL = self.cast(self.BVoidP, 0)
+            self.CData, self.CType = backend._get_types()
+        self.buffer = backend.buffer
+
+    def cdef(self, csource, override=False, packed=False, pack=None):
+        """Parse the given C source.  This registers all declared functions,
+        types, and global variables.  The functions and global variables can
+        then be accessed via either 'ffi.dlopen()' or 'ffi.verify()'.
+        The types can be used in 'ffi.new()' and other functions.
+        If 'packed' is specified as True, all structs declared inside this
+        cdef are packed, i.e. laid out without any field alignment at all.
+        Alternatively, 'pack' can be a small integer, and requests for
+        alignment greater than that are ignored (pack=1 is equivalent to
+        packed=True).
+        """
+        self._cdef(csource, override=override, packed=packed, pack=pack)
+
+    def embedding_api(self, csource, packed=False, pack=None):
+        self._cdef(csource, packed=packed, pack=pack, dllexport=True)
+        if self._embedding is None:
+            self._embedding = ''
+
+    def _cdef(self, csource, override=False, **options):
+        if not isinstance(csource, str):    # unicode, on Python 2
+            if not isinstance(csource, basestring):
+                raise TypeError("cdef() argument must be a string")
+            csource = csource.encode('ascii')
+        with self._lock:
+            self._cdef_version = object()
+            self._parser.parse(csource, override=override, **options)
+            self._cdefsources.append(csource)
+            if override:
+                for cache in self._function_caches:
+                    cache.clear()
+            finishlist = self._parser._recomplete
+            if finishlist:
+                self._parser._recomplete = []
+                for tp in finishlist:
+                    tp.finish_backend_type(self, finishlist)
+
+    def dlopen(self, name, flags=0):
+        """Load and return a dynamic library identified by 'name'.
+        The standard C library can be loaded by passing None.
+        Note that functions and types declared by 'ffi.cdef()' are not
+        linked to a particular library, just like C headers; in the
+        library we only look for the actual (untyped) symbols.
+        """
+        if not (isinstance(name, basestring) or
+                name is None or
+                isinstance(name, self.CData)):
+            raise TypeError("dlopen(name): name must be a file name, None, "
+                            "or an already-opened 'void *' handle")
+        with self._lock:
+            lib, function_cache = _make_ffi_library(self, name, flags)
+            self._function_caches.append(function_cache)
+            self._libraries.append(lib)
+        return lib
+
+    def dlclose(self, lib):
+        """Close a library obtained with ffi.dlopen().  After this call,
+        access to functions or variables from the library will fail
+        (possibly with a segmentation fault).
+        """
+        type(lib).__cffi_close__(lib)
+
+    def _typeof_locked(self, cdecl):
+        # call me with the lock!
+        key = cdecl
+        if key in self._parsed_types:
+            return self._parsed_types[key]
+        #
+        if not isinstance(cdecl, str):    # unicode, on Python 2
+            cdecl = cdecl.encode('ascii')
+        #
+        type = self._parser.parse_type(cdecl)
+        really_a_function_type = type.is_raw_function
+        if really_a_function_type:
+            type = type.as_function_pointer()
+        btype = self._get_cached_btype(type)
+        result = btype, really_a_function_type
+        self._parsed_types[key] = result
+        return result
+
+    def _typeof(self, cdecl, consider_function_as_funcptr=False):
+        # string -> ctype object
+        try:
+            result = self._parsed_types[cdecl]
+        except KeyError:
+            with self._lock:
+                result = self._typeof_locked(cdecl)
+        #
+        btype, really_a_function_type = result
+        if really_a_function_type and not consider_function_as_funcptr:
+            raise CDefError("the type %r is a function type, not a "
+                            "pointer-to-function type" % (cdecl,))
+        return btype
+
+    def typeof(self, cdecl):
+        """Parse the C type given as a string and return the
+        corresponding <ctype> object.
+        It can also be used on 'cdata' instance to get its C type.
+        """
+        if isinstance(cdecl, basestring):
+            return self._typeof(cdecl)
+        if isinstance(cdecl, self.CData):
+            return self._backend.typeof(cdecl)
+        if isinstance(cdecl, types.BuiltinFunctionType):
+            res = _builtin_function_type(cdecl)
+            if res is not None:
+                return res
+        if (isinstance(cdecl, types.FunctionType)
+                and hasattr(cdecl, '_cffi_base_type')):
+            with self._lock:
+                return self._get_cached_btype(cdecl._cffi_base_type)
+        raise TypeError(type(cdecl))
+
+    def sizeof(self, cdecl):
+        """Return the size in bytes of the argument.  It can be a
+        string naming a C type, or a 'cdata' instance.
+        """
+        if isinstance(cdecl, basestring):
+            BType = self._typeof(cdecl)
+            return self._backend.sizeof(BType)
+        else:
+            return self._backend.sizeof(cdecl)
+
+    def alignof(self, cdecl):
+        """Return the natural alignment size in bytes of the C type
+        given as a string.
+        """
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        return self._backend.alignof(cdecl)
+
+    def offsetof(self, cdecl, *fields_or_indexes):
+        """Return the offset of the named field inside the given
+        structure or array, which must be given as a C type name.
+        You can give several field names in case of nested structures.
+        You can also give numeric values which correspond to array
+        items, in case of an array type.
+        """
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        return self._typeoffsetof(cdecl, *fields_or_indexes)[1]
+
+    def new(self, cdecl, init=None):
+        """Allocate an instance according to the specified C type and
+        return a pointer to it.  The specified C type must be either a
+        pointer or an array: ``new('X *')`` allocates an X and returns
+        a pointer to it, whereas ``new('X[n]')`` allocates an array of
+        n X'es and returns an array referencing it (which works
+        mostly like a pointer, like in C).  You can also use
+        ``new('X[]', n)`` to allocate an array of a non-constant
+        length n.
+
+        The memory is initialized following the rules of declaring a
+        global variable in C: by default it is zero-initialized, but
+        an explicit initializer can be given which can be used to
+        fill all or part of the memory.
+
+        When the returned <cdata> object goes out of scope, the memory
+        is freed.  In other words the returned <cdata> object has
+        ownership of the value of type 'cdecl' that it points to.  This
+        means that the raw data can be used as long as this object is
+        kept alive, but must not be used for a longer time.  Be careful
+        about that when copying the pointer to the memory somewhere
+        else, e.g. into another structure.
+        """
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        return self._backend.newp(cdecl, init)
+
+    def new_allocator(self, alloc=None, free=None,
+                      should_clear_after_alloc=True):
+        """Return a new allocator, i.e. a function that behaves like ffi.new()
+        but uses the provided low-level 'alloc' and 'free' functions.
+
+        'alloc' is called with the size as argument.  If it returns NULL, a
+        MemoryError is raised.  'free' is called with the result of 'alloc'
+        as argument.  Both can be either Python function or directly C
+        functions.  If 'free' is None, then no free function is called.
+        If both 'alloc' and 'free' are None, the default is used.
+
+        If 'should_clear_after_alloc' is set to False, then the memory
+        returned by 'alloc' is assumed to be already cleared (or you are
+        fine with garbage); otherwise CFFI will clear it.
+        """
+        compiled_ffi = self._backend.FFI()
+        allocator = compiled_ffi.new_allocator(alloc, free,
+                                               should_clear_after_alloc)
+        def allocate(cdecl, init=None):
+            if isinstance(cdecl, basestring):
+                cdecl = self._typeof(cdecl)
+            return allocator(cdecl, init)
+        return allocate
+
+    def cast(self, cdecl, source):
+        """Similar to a C cast: returns an instance of the named C
+        type initialized with the given 'source'.  The source is
+        casted between integers or pointers of any type.
+        """
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        return self._backend.cast(cdecl, source)
+
+    def string(self, cdata, maxlen=-1):
+        """Return a Python string (or unicode string) from the 'cdata'.
+        If 'cdata' is a pointer or array of characters or bytes, returns
+        the null-terminated string.  The returned string extends until
+        the first null character, or at most 'maxlen' characters.  If
+        'cdata' is an array then 'maxlen' defaults to its length.
+
+        If 'cdata' is a pointer or array of wchar_t, returns a unicode
+        string following the same rules.
+
+        If 'cdata' is a single character or byte or a wchar_t, returns
+        it as a string or unicode string.
+
+        If 'cdata' is an enum, returns the value of the enumerator as a
+        string, or 'NUMBER' if the value is out of range.
+        """
+        return self._backend.string(cdata, maxlen)
+
+    def unpack(self, cdata, length):
+        """Unpack an array of C data of the given length,
+        returning a Python string/unicode/list.
+
+        If 'cdata' is a pointer to 'char', returns a byte string.
+        It does not stop at the first null.  This is equivalent to:
+        ffi.buffer(cdata, length)[:]
+
+        If 'cdata' is a pointer to 'wchar_t', returns a unicode string.
+        'length' is measured in wchar_t's; it is not the size in bytes.
+
+        If 'cdata' is a pointer to anything else, returns a list of
+        'length' items.  This is a faster equivalent to:
+        [cdata[i] for i in range(length)]
+        """
+        return self._backend.unpack(cdata, length)
+
+   #def buffer(self, cdata, size=-1):
+   #    """Return a read-write buffer object that references the raw C data
+   #    pointed to by the given 'cdata'.  The 'cdata' must be a pointer or
+   #    an array.  Can be passed to functions expecting a buffer, or directly
+   #    manipulated with:
+   #
+   #        buf[:]          get a copy of it in a regular string, or
+   #        buf[idx]        as a single character
+   #        buf[:] = ...
+   #        buf[idx] = ...  change the content
+   #    """
+   #    note that 'buffer' is a type, set on this instance by __init__
+
+    def from_buffer(self, cdecl, python_buffer=_unspecified,
+                    require_writable=False):
+        """Return a cdata of the given type pointing to the data of the
+        given Python object, which must support the buffer interface.
+        Note that this is not meant to be used on the built-in types
+        str or unicode (you can build 'char[]' arrays explicitly)
+        but only on objects containing large quantities of raw data
+        in some other format, like 'array.array' or numpy arrays.
+
+        The first argument is optional and default to 'char[]'.
+        """
+        if python_buffer is _unspecified:
+            cdecl, python_buffer = self.BCharA, cdecl
+        elif isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        return self._backend.from_buffer(cdecl, python_buffer,
+                                         require_writable)
+
+    def memmove(self, dest, src, n):
+        """ffi.memmove(dest, src, n) copies n bytes of memory from src to dest.
+
+        Like the C function memmove(), the memory areas may overlap;
+        apart from that it behaves like the C function memcpy().
+
+        'src' can be any cdata ptr or array, or any Python buffer object.
+        'dest' can be any cdata ptr or array, or a writable Python buffer
+        object.  The size to copy, 'n', is always measured in bytes.
+
+        Unlike other methods, this one supports all Python buffer including
+        byte strings and bytearrays---but it still does not support
+        non-contiguous buffers.
+        """
+        return self._backend.memmove(dest, src, n)
+
+    def callback(self, cdecl, python_callable=None, error=None, onerror=None):
+        """Return a callback object or a decorator making such a
+        callback object.  'cdecl' must name a C function pointer type.
+        The callback invokes the specified 'python_callable' (which may
+        be provided either directly or via a decorator).  Important: the
+        callback object must be manually kept alive for as long as the
+        callback may be invoked from the C level.
+        """
+        def callback_decorator_wrap(python_callable):
+            if not callable(python_callable):
+                raise TypeError("the 'python_callable' argument "
+                                "is not callable")
+            return self._backend.callback(cdecl, python_callable,
+                                          error, onerror)
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl, consider_function_as_funcptr=True)
+        if python_callable is None:
+            return callback_decorator_wrap                # decorator mode
+        else:
+            return callback_decorator_wrap(python_callable)  # direct mode
+
+    def getctype(self, cdecl, replace_with=''):
+        """Return a string giving the C type 'cdecl', which may be itself
+        a string or a <ctype> object.  If 'replace_with' is given, it gives
+        extra text to append (or insert for more complicated C types), like
+        a variable name, or '*' to get actually the C type 'pointer-to-cdecl'.
+        """
+        if isinstance(cdecl, basestring):
+            cdecl = self._typeof(cdecl)
+        replace_with = replace_with.strip()
+        if (replace_with.startswith('*')
+                and '&[' in self._backend.getcname(cdecl, '&')):
+            replace_with = '(%s)' % replace_with
+        elif replace_with and not replace_with[0] in '[(':
+            replace_with = ' ' + replace_with
+        return self._backend.getcname(cdecl, replace_with)
+
+    def gc(self, cdata, destructor, size=0):
+        """Return a new cdata object that points to the same
+        data.  Later, when this new cdata object is garbage-collected,
+        'destructor(old_cdata_object)' will be called.
+
+        The optional 'size' gives an estimate of the size, used to
+        trigger the garbage collection more eagerly.  So far only used
+        on PyPy.  It tells the GC that the returned object keeps alive
+        roughly 'size' bytes of external memory.
+        """
+        return self._backend.gcp(cdata, destructor, size)
+
+    def _get_cached_btype(self, type):
+        assert self._lock.acquire(False) is False
+        # call me with the lock!
+        try:
+            BType = self._cached_btypes[type]
+        except KeyError:
+            finishlist = []
+            BType = type.get_cached_btype(self, finishlist)
+            for type in finishlist:
+                type.finish_backend_type(self, finishlist)
+        return BType
+
+    def verify(self, source='', tmpdir=None, **kwargs):
+        """Verify that the current ffi signatures compile on this
+        machine, and return a dynamic library object.  The dynamic
+        library can be used to call functions and access global
+        variables declared in this 'ffi'.  The library is compiled
+        by the C compiler: it gives you C-level API compatibility
+        (including calling macros).  This is unlike 'ffi.dlopen()',
+        which requires binary compatibility in the signatures.
+        """
+        from .verifier import Verifier, _caller_dir_pycache
+        #
+        # If set_unicode(True) was called, insert the UNICODE and
+        # _UNICODE macro declarations
+        if self._windows_unicode:
+            self._apply_windows_unicode(kwargs)
+        #
+        # Set the tmpdir here, and not in Verifier.__init__: it picks
+        # up the caller's directory, which we want to be the caller of
+        # ffi.verify(), as opposed to the caller of Veritier().
+        tmpdir = tmpdir or _caller_dir_pycache()
+        #
+        # Make a Verifier() and use it to load the library.
+        self.verifier = Verifier(self, source, tmpdir, **kwargs)
+        lib = self.verifier.load_library()
+        #
+        # Save the loaded library for keep-alive purposes, even
+        # if the caller doesn't keep it alive itself (it should).
+        self._libraries.append(lib)
+        return lib
+
+    def _get_errno(self):
+        return self._backend.get_errno()
+    def _set_errno(self, errno):
+        self._backend.set_errno(errno)
+    errno = property(_get_errno, _set_errno, None,
+                     "the value of 'errno' from/to the C calls")
+
+    def getwinerror(self, code=-1):
+        return self._backend.getwinerror(code)
+
+    def _pointer_to(self, ctype):
+        with self._lock:
+            return model.pointer_cache(self, ctype)
+
+    def addressof(self, cdata, *fields_or_indexes):
+        """Return the address of a <cdata 'struct-or-union'>.
+        If 'fields_or_indexes' are given, returns the address of that
+        field or array item in the structure or array, recursively in
+        case of nested structures.
+        """
+        try:
+            ctype = self._backend.typeof(cdata)
+        except TypeError:
+            if '__addressof__' in type(cdata).__dict__:
+                return type(cdata).__addressof__(cdata, *fields_or_indexes)
+            raise
+        if fields_or_indexes:
+            ctype, offset = self._typeoffsetof(ctype, *fields_or_indexes)
+        else:
+            if ctype.kind == "pointer":
+                raise TypeError("addressof(pointer)")
+            offset = 0
+        ctypeptr = self._pointer_to(ctype)
+        return self._backend.rawaddressof(ctypeptr, cdata, offset)
+
+    def _typeoffsetof(self, ctype, field_or_index, *fields_or_indexes):
+        ctype, offset = self._backend.typeoffsetof(ctype, field_or_index)
+        for field1 in fields_or_indexes:
+            ctype, offset1 = self._backend.typeoffsetof(ctype, field1, 1)
+            offset += offset1
+        return ctype, offset
+
+    def include(self, ffi_to_include):
+        """Includes the typedefs, structs, unions and enums defined
+        in another FFI instance.  Usage is similar to a #include in C,
+        where a part of the program might include types defined in
+        another part for its own usage.  Note that the include()
+        method has no effect on functions, constants and global
+        variables, which must anyway be accessed directly from the
+        lib object returned by the original FFI instance.
+        """
+        if not isinstance(ffi_to_include, FFI):
+            raise TypeError("ffi.include() expects an argument that is also of"
+                            " type cffi.FFI, not %r" % (
+                                type(ffi_to_include).__name__,))
+        if ffi_to_include is self:
+            raise ValueError("self.include(self)")
+        with ffi_to_include._lock:
+            with self._lock:
+                self._parser.include(ffi_to_include._parser)
+                self._cdefsources.append('[')
+                self._cdefsources.extend(ffi_to_include._cdefsources)
+                self._cdefsources.append(']')
+                self._included_ffis.append(ffi_to_include)
+
+    def new_handle(self, x):
+        return self._backend.newp_handle(self.BVoidP, x)
+
+    def from_handle(self, x):
+        return self._backend.from_handle(x)
+
+    def release(self, x):
+        self._backend.release(x)
+
+    def set_unicode(self, enabled_flag):
+        """Windows: if 'enabled_flag' is True, enable the UNICODE and
+        _UNICODE defines in C, and declare the types like TCHAR and LPTCSTR
+        to be (pointers to) wchar_t.  If 'enabled_flag' is False,
+        declare these types to be (pointers to) plain 8-bit characters.
+        This is mostly for backward compatibility; you usually want True.
+        """
+        if self._windows_unicode is not None:
+            raise ValueError("set_unicode() can only be called once")
+        enabled_flag = bool(enabled_flag)
+        if enabled_flag:
+            self.cdef("typedef wchar_t TBYTE;"
+                      "typedef wchar_t TCHAR;"
+                      "typedef const wchar_t *LPCTSTR;"
+                      "typedef const wchar_t *PCTSTR;"
+                      "typedef wchar_t *LPTSTR;"
+                      "typedef wchar_t *PTSTR;"
+                      "typedef TBYTE *PTBYTE;"
+                      "typedef TCHAR *PTCHAR;")
+        else:
+            self.cdef("typedef char TBYTE;"
+                      "typedef char TCHAR;"
+                      "typedef const char *LPCTSTR;"
+                      "typedef const char *PCTSTR;"
+                      "typedef char *LPTSTR;"
+                      "typedef char *PTSTR;"
+                      "typedef TBYTE *PTBYTE;"
+                      "typedef TCHAR *PTCHAR;")
+        self._windows_unicode = enabled_flag
+
+    def _apply_windows_unicode(self, kwds):
+        defmacros = kwds.get('define_macros', ())
+        if not isinstance(defmacros, (list, tuple)):
+            raise TypeError("'define_macros' must be a list or tuple")
+        defmacros = list(defmacros) + [('UNICODE', '1'),
+                                       ('_UNICODE', '1')]
+        kwds['define_macros'] = defmacros
+
+    def _apply_embedding_fix(self, kwds):
+        # must include an argument like "-lpython2.7" for the compiler
+        def ensure(key, value):
+            lst = kwds.setdefault(key, [])
+            if value not in lst:
+                lst.append(value)
+        #
+        if '__pypy__' in sys.builtin_module_names:
+            import os
+            if sys.platform == "win32":
+                # we need 'libpypy-c.lib'.  Current distributions of
+                # pypy (>= 4.1) contain it as 'libs/python27.lib'.
+                pythonlib = "python{0[0]}{0[1]}".format(sys.version_info)
+                if hasattr(sys, 'prefix'):
+                    ensure('library_dirs', os.path.join(sys.prefix, 'libs'))
+            else:
+                # we need 'libpypy-c.{so,dylib}', which should be by
+                # default located in 'sys.prefix/bin' for installed
+                # systems.
+                if sys.version_info < (3,):
+                    pythonlib = "pypy-c"
+                else:
+                    pythonlib = "pypy3-c"
+                if hasattr(sys, 'prefix'):
+                    ensure('library_dirs', os.path.join(sys.prefix, 'bin'))
+            # On uninstalled pypy's, the libpypy-c is typically found in
+            # .../pypy/goal/.
+            if hasattr(sys, 'prefix'):
+                ensure('library_dirs', os.path.join(sys.prefix, 'pypy', 'goal'))
+        else:
+            if sys.platform == "win32":
+                template = "python%d%d"
+                if hasattr(sys, 'gettotalrefcount'):
+                    template += '_d'
+            else:
+                try:
+                    import sysconfig
+                except ImportError:    # 2.6
+                    from distutils import sysconfig
+                template = "python%d.%d"
+                if sysconfig.get_config_var('DEBUG_EXT'):
+                    template += sysconfig.get_config_var('DEBUG_EXT')
+            pythonlib = (template %
+                    (sys.hexversion >> 24, (sys.hexversion >> 16) & 0xff))
+            if hasattr(sys, 'abiflags'):
+                pythonlib += sys.abiflags
+        ensure('libraries', pythonlib)
+        if sys.platform == "win32":
+            ensure('extra_link_args', '/MANIFEST')
+
+    def set_source(self, module_name, source, source_extension='.c', **kwds):
+        import os
+        if hasattr(self, '_assigned_source'):
+            raise ValueError("set_source() cannot be called several times "
+                             "per ffi object")
+        if not isinstance(module_name, basestring):
+            raise TypeError("'module_name' must be a string")
+        if os.sep in module_name or (os.altsep and os.altsep in module_name):
+            raise ValueError("'module_name' must not contain '/': use a dotted "
+                             "name to make a 'package.module' location")
+        self._assigned_source = (str(module_name), source,
+                                 source_extension, kwds)
+
+    def set_source_pkgconfig(self, module_name, pkgconfig_libs, source,
+                             source_extension='.c', **kwds):
+        from . import pkgconfig
+        if not isinstance(pkgconfig_libs, list):
+            raise TypeError("the pkgconfig_libs argument must be a list "
+                            "of package names")
+        kwds2 = pkgconfig.flags_from_pkgconfig(pkgconfig_libs)
+        pkgconfig.merge_flags(kwds, kwds2)
+        self.set_source(module_name, source, source_extension, **kwds)
+
+    def distutils_extension(self, tmpdir='build', verbose=True):
+        from distutils.dir_util import mkpath
+        from .recompiler import recompile
+        #
+        if not hasattr(self, '_assigned_source'):
+            if hasattr(self, 'verifier'):     # fallback, 'tmpdir' ignored
+                return self.verifier.get_extension()
+            raise ValueError("set_source() must be called before"
+                             " distutils_extension()")
+        module_name, source, source_extension, kwds = self._assigned_source
+        if source is None:
+            raise TypeError("distutils_extension() is only for C extension "
+                            "modules, not for dlopen()-style pure Python "
+                            "modules")
+        mkpath(tmpdir)
+        ext, updated = recompile(self, module_name,
+                                 source, tmpdir=tmpdir, extradir=tmpdir,
+                                 source_extension=source_extension,
+                                 call_c_compiler=False, **kwds)
+        if verbose:
+            if updated:
+                sys.stderr.write("regenerated: %r\n" % (ext.sources[0],))
+            else:
+                sys.stderr.write("not modified: %r\n" % (ext.sources[0],))
+        return ext
+
+    def emit_c_code(self, filename):
+        from .recompiler import recompile
+        #
+        if not hasattr(self, '_assigned_source'):
+            raise ValueError("set_source() must be called before emit_c_code()")
+        module_name, source, source_extension, kwds = self._assigned_source
+        if source is None:
+            raise TypeError("emit_c_code() is only for C extension modules, "
+                            "not for dlopen()-style pure Python modules")
+        recompile(self, module_name, source,
+                  c_file=filename, call_c_compiler=False, **kwds)
+
+    def emit_python_code(self, filename):
+        from .recompiler import recompile
+        #
+        if not hasattr(self, '_assigned_source'):
+            raise ValueError("set_source() must be called before emit_c_code()")
+        module_name, source, source_extension, kwds = self._assigned_source
+        if source is not None:
+            raise TypeError("emit_python_code() is only for dlopen()-style "
+                            "pure Python modules, not for C extension modules")
+        recompile(self, module_name, source,
+                  c_file=filename, call_c_compiler=False, **kwds)
+
+    def compile(self, tmpdir='.', verbose=0, target=None, debug=None):
+        """The 'target' argument gives the final file name of the
+        compiled DLL.  Use '*' to force distutils' choice, suitable for
+        regular CPython C API modules.  Use a file name ending in '.*'
+        to ask for the system's default extension for dynamic libraries
+        (.so/.dll/.dylib).
+
+        The default is '*' when building a non-embedded C API extension,
+        and (module_name + '.*') when building an embedded library.
+        """
+        from .recompiler import recompile
+        #
+        if not hasattr(self, '_assigned_source'):
+            raise ValueError("set_source() must be called before compile()")
+        module_name, source, source_extension, kwds = self._assigned_source
+        return recompile(self, module_name, source, tmpdir=tmpdir,
+                         target=target, source_extension=source_extension,
+                         compiler_verbose=verbose, debug=debug, **kwds)
+
+    def init_once(self, func, tag):
+        # Read _init_once_cache[tag], which is either (False, lock) if
+        # we're calling the function now in some thread, or (True, result).
+        # Don't call setdefault() in most cases, to avoid allocating and
+        # immediately freeing a lock; but still use setdefaut() to avoid
+        # races.
+        try:
+            x = self._init_once_cache[tag]
+        except KeyError:
+            x = self._init_once_cache.setdefault(tag, (False, allocate_lock()))
+        # Common case: we got (True, result), so we return the result.
+        if x[0]:
+            return x[1]
+        # Else, it's a lock.  Acquire it to serialize the following tests.
+        with x[1]:
+            # Read again from _init_once_cache the current status.
+            x = self._init_once_cache[tag]
+            if x[0]:
+                return x[1]
+            # Call the function and store the result back.
+            result = func()
+            self._init_once_cache[tag] = (True, result)
+        return result
+
+    def embedding_init_code(self, pysource):
+        if self._embedding:
+            raise ValueError("embedding_init_code() can only be called once")
+        # fix 'pysource' before it gets dumped into the C file:
+        # - remove empty lines at the beginning, so it starts at "line 1"
+        # - dedent, if all non-empty lines are indented
+        # - check for SyntaxErrors
+        import re
+        match = re.match(r'\s*\n', pysource)
+        if match:
+            pysource = pysource[match.end():]
+        lines = pysource.splitlines() or ['']
+        prefix = re.match(r'\s*', lines[0]).group()
+        for i in range(1, len(lines)):
+            line = lines[i]
+            if line.rstrip():
+                while not line.startswith(prefix):
+                    prefix = prefix[:-1]
+        i = len(prefix)
+        lines = [line[i:]+'\n' for line in lines]
+        pysource = ''.join(lines)
+        #
+        compile(pysource, "cffi_init", "exec")
+        #
+        self._embedding = pysource
+
+    def def_extern(self, *args, **kwds):
+        raise ValueError("ffi.def_extern() is only available on API-mode FFI "
+                         "objects")
+
+    def list_types(self):
+        """Returns the user type names known to this FFI instance.
+        This returns a tuple containing three lists of names:
+        (typedef_names, names_of_structs, names_of_unions)
+        """
+        typedefs = []
+        structs = []
+        unions = []
+        for key in self._parser._declarations:
+            if key.startswith('typedef '):
+                typedefs.append(key[8:])
+            elif key.startswith('struct '):
+                structs.append(key[7:])
+            elif key.startswith('union '):
+                unions.append(key[6:])
+        typedefs.sort()
+        structs.sort()
+        unions.sort()
+        return (typedefs, structs, unions)
+
+
+def _load_backend_lib(backend, name, flags):
+    import os
+    if not isinstance(name, basestring):
+        if sys.platform != "win32" or name is not None:
+            return backend.load_library(name, flags)
+        name = "c"    # Windows: load_library(None) fails, but this works
+                      # on Python 2 (backward compatibility hack only)
+    first_error = None
+    if '.' in name or '/' in name or os.sep in name:
+        try:
+            return backend.load_library(name, flags)
+        except OSError as e:
+            first_error = e
+    import ctypes.util
+    path = ctypes.util.find_library(name)
+    if path is None:
+        if name == "c" and sys.platform == "win32" and sys.version_info >= (3,):
+            raise OSError("dlopen(None) cannot work on Windows for Python 3 "
+                          "(see http://bugs.python.org/issue23606)")
+        msg = ("ctypes.util.find_library() did not manage "
+               "to locate a library called %r" % (name,))
+        if first_error is not None:
+            msg = "%s.  Additionally, %s" % (first_error, msg)
+        raise OSError(msg)
+    return backend.load_library(path, flags)
+
+def _make_ffi_library(ffi, libname, flags):
+    backend = ffi._backend
+    backendlib = _load_backend_lib(backend, libname, flags)
+    #
+    def accessor_function(name):
+        key = 'function ' + name
+        tp, _ = ffi._parser._declarations[key]
+        BType = ffi._get_cached_btype(tp)
+        value = backendlib.load_function(BType, name)
+        library.__dict__[name] = value
+    #
+    def accessor_variable(name):
+        key = 'variable ' + name
+        tp, _ = ffi._parser._declarations[key]
+        BType = ffi._get_cached_btype(tp)
+        read_variable = backendlib.read_variable
+        write_variable = backendlib.write_variable
+        setattr(FFILibrary, name, property(
+            lambda self: read_variable(BType, name),
+            lambda self, value: write_variable(BType, name, value)))
+    #
+    def addressof_var(name):
+        try:
+            return addr_variables[name]
+        except KeyError:
+            with ffi._lock:
+                if name not in addr_variables:
+                    key = 'variable ' + name
+                    tp, _ = ffi._parser._declarations[key]
+                    BType = ffi._get_cached_btype(tp)
+                    if BType.kind != 'array':
+                        BType = model.pointer_cache(ffi, BType)
+                    p = backendlib.load_function(BType, name)
+                    addr_variables[name] = p
+            return addr_variables[name]
+    #
+    def accessor_constant(name):
+        raise NotImplementedError("non-integer constant '%s' cannot be "
+                                  "accessed from a dlopen() library" % (name,))
+    #
+    def accessor_int_constant(name):
+        library.__dict__[name] = ffi._parser._int_constants[name]
+    #
+    accessors = {}
+    accessors_version = [False]
+    addr_variables = {}
+    #
+    def update_accessors():
+        if accessors_version[0] is ffi._cdef_version:
+            return
+        #
+        for key, (tp, _) in ffi._parser._declarations.items():
+            if not isinstance(tp, model.EnumType):
+                tag, name = key.split(' ', 1)
+                if tag == 'function':
+                    accessors[name] = accessor_function
+                elif tag == 'variable':
+                    accessors[name] = accessor_variable
+                elif tag == 'constant':
+                    accessors[name] = accessor_constant
+            else:
+                for i, enumname in enumerate(tp.enumerators):
+                    def accessor_enum(name, tp=tp, i=i):
+                        tp.check_not_partial()
+                        library.__dict__[name] = tp.enumvalues[i]
+                    accessors[enumname] = accessor_enum
+        for name in ffi._parser._int_constants:
+            accessors.setdefault(name, accessor_int_constant)
+        accessors_version[0] = ffi._cdef_version
+    #
+    def make_accessor(name):
+        with ffi._lock:
+            if name in library.__dict__ or name in FFILibrary.__dict__:
+                return    # added by another thread while waiting for the lock
+            if name not in accessors:
+                update_accessors()
+                if name not in accessors:
+                    raise AttributeError(name)
+            accessors[name](name)
+    #
+    class FFILibrary(object):
+        def __getattr__(self, name):
+            make_accessor(name)
+            return getattr(self, name)
+        def __setattr__(self, name, value):
+            try:
+                property = getattr(self.__class__, name)
+            except AttributeError:
+                make_accessor(name)
+                setattr(self, name, value)
+            else:
+                property.__set__(self, value)
+        def __dir__(self):
+            with ffi._lock:
+                update_accessors()
+                return accessors.keys()
+        def __addressof__(self, name):
+            if name in library.__dict__:
+                return library.__dict__[name]
+            if name in FFILibrary.__dict__:
+                return addressof_var(name)
+            make_accessor(name)
+            if name in library.__dict__:
+                return library.__dict__[name]
+            if name in FFILibrary.__dict__:
+                return addressof_var(name)
+            raise AttributeError("cffi library has no function or "
+                                 "global variable named '%s'" % (name,))
+        def __cffi_close__(self):
+            backendlib.close_lib()
+            self.__dict__.clear()
+    #
+    if isinstance(libname, basestring):
+        try:
+            if not isinstance(libname, str):    # unicode, on Python 2
+                libname = libname.encode('utf-8')
+            FFILibrary.__name__ = 'FFILibrary_%s' % libname
+        except UnicodeError:
+            pass
+    library = FFILibrary()
+    return library, library.__dict__
+
+def _builtin_function_type(func):
+    # a hack to make at least ffi.typeof(builtin_function) work,
+    # if the builtin function was obtained by 'vengine_cpy'.
+    import sys
+    try:
+        module = sys.modules[func.__module__]
+        ffi = module._cffi_original_ffi
+        types_of_builtin_funcs = module._cffi_types_of_builtin_funcs
+        tp = types_of_builtin_funcs[func]
+    except (KeyError, AttributeError, TypeError):
+        return None
+    else:
+        with ffi._lock:
+            return ffi._get_cached_btype(tp)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/backend_ctypes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/backend_ctypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..e7956a79cfb1c3d28a2ad22a40b261ae7dbbbb5f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/backend_ctypes.py
@@ -0,0 +1,1121 @@
+import ctypes, ctypes.util, operator, sys
+from . import model
+
+if sys.version_info < (3,):
+    bytechr = chr
+else:
+    unicode = str
+    long = int
+    xrange = range
+    bytechr = lambda num: bytes([num])
+
+class CTypesType(type):
+    pass
+
+class CTypesData(object):
+    __metaclass__ = CTypesType
+    __slots__ = ['__weakref__']
+    __name__ = '<cdata>'
+
+    def __init__(self, *args):
+        raise TypeError("cannot instantiate %r" % (self.__class__,))
+
+    @classmethod
+    def _newp(cls, init):
+        raise TypeError("expected a pointer or array ctype, got '%s'"
+                        % (cls._get_c_name(),))
+
+    @staticmethod
+    def _to_ctypes(value):
+        raise TypeError
+
+    @classmethod
+    def _arg_to_ctypes(cls, *value):
+        try:
+            ctype = cls._ctype
+        except AttributeError:
+            raise TypeError("cannot create an instance of %r" % (cls,))
+        if value:
+            res = cls._to_ctypes(*value)
+            if not isinstance(res, ctype):
+                res = cls._ctype(res)
+        else:
+            res = cls._ctype()
+        return res
+
+    @classmethod
+    def _create_ctype_obj(cls, init):
+        if init is None:
+            return cls._arg_to_ctypes()
+        else:
+            return cls._arg_to_ctypes(init)
+
+    @staticmethod
+    def _from_ctypes(ctypes_value):
+        raise TypeError
+
+    @classmethod
+    def _get_c_name(cls, replace_with=''):
+        return cls._reftypename.replace(' &', replace_with)
+
+    @classmethod
+    def _fix_class(cls):
+        cls.__name__ = 'CData<%s>' % (cls._get_c_name(),)
+        cls.__qualname__ = 'CData<%s>' % (cls._get_c_name(),)
+        cls.__module__ = 'ffi'
+
+    def _get_own_repr(self):
+        raise NotImplementedError
+
+    def _addr_repr(self, address):
+        if address == 0:
+            return 'NULL'
+        else:
+            if address < 0:
+                address += 1 << (8*ctypes.sizeof(ctypes.c_void_p))
+            return '0x%x' % address
+
+    def __repr__(self, c_name=None):
+        own = self._get_own_repr()
+        return '<cdata %r %s>' % (c_name or self._get_c_name(), own)
+
+    def _convert_to_address(self, BClass):
+        if BClass is None:
+            raise TypeError("cannot convert %r to an address" % (
+                self._get_c_name(),))
+        else:
+            raise TypeError("cannot convert %r to %r" % (
+                self._get_c_name(), BClass._get_c_name()))
+
+    @classmethod
+    def _get_size(cls):
+        return ctypes.sizeof(cls._ctype)
+
+    def _get_size_of_instance(self):
+        return ctypes.sizeof(self._ctype)
+
+    @classmethod
+    def _cast_from(cls, source):
+        raise TypeError("cannot cast to %r" % (cls._get_c_name(),))
+
+    def _cast_to_integer(self):
+        return self._convert_to_address(None)
+
+    @classmethod
+    def _alignment(cls):
+        return ctypes.alignment(cls._ctype)
+
+    def __iter__(self):
+        raise TypeError("cdata %r does not support iteration" % (
+            self._get_c_name()),)
+
+    def _make_cmp(name):
+        cmpfunc = getattr(operator, name)
+        def cmp(self, other):
+            v_is_ptr = not isinstance(self, CTypesGenericPrimitive)
+            w_is_ptr = (isinstance(other, CTypesData) and
+                           not isinstance(other, CTypesGenericPrimitive))
+            if v_is_ptr and w_is_ptr:
+                return cmpfunc(self._convert_to_address(None),
+                               other._convert_to_address(None))
+            elif v_is_ptr or w_is_ptr:
+                return NotImplemented
+            else:
+                if isinstance(self, CTypesGenericPrimitive):
+                    self = self._value
+                if isinstance(other, CTypesGenericPrimitive):
+                    other = other._value
+                return cmpfunc(self, other)
+        cmp.func_name = name
+        return cmp
+
+    __eq__ = _make_cmp('__eq__')
+    __ne__ = _make_cmp('__ne__')
+    __lt__ = _make_cmp('__lt__')
+    __le__ = _make_cmp('__le__')
+    __gt__ = _make_cmp('__gt__')
+    __ge__ = _make_cmp('__ge__')
+
+    def __hash__(self):
+        return hash(self._convert_to_address(None))
+
+    def _to_string(self, maxlen):
+        raise TypeError("string(): %r" % (self,))
+
+
+class CTypesGenericPrimitive(CTypesData):
+    __slots__ = []
+
+    def __hash__(self):
+        return hash(self._value)
+
+    def _get_own_repr(self):
+        return repr(self._from_ctypes(self._value))
+
+
+class CTypesGenericArray(CTypesData):
+    __slots__ = []
+
+    @classmethod
+    def _newp(cls, init):
+        return cls(init)
+
+    def __iter__(self):
+        for i in xrange(len(self)):
+            yield self[i]
+
+    def _get_own_repr(self):
+        return self._addr_repr(ctypes.addressof(self._blob))
+
+
+class CTypesGenericPtr(CTypesData):
+    __slots__ = ['_address', '_as_ctype_ptr']
+    _automatic_casts = False
+    kind = "pointer"
+
+    @classmethod
+    def _newp(cls, init):
+        return cls(init)
+
+    @classmethod
+    def _cast_from(cls, source):
+        if source is None:
+            address = 0
+        elif isinstance(source, CTypesData):
+            address = source._cast_to_integer()
+        elif isinstance(source, (int, long)):
+            address = source
+        else:
+            raise TypeError("bad type for cast to %r: %r" %
+                            (cls, type(source).__name__))
+        return cls._new_pointer_at(address)
+
+    @classmethod
+    def _new_pointer_at(cls, address):
+        self = cls.__new__(cls)
+        self._address = address
+        self._as_ctype_ptr = ctypes.cast(address, cls._ctype)
+        return self
+
+    def _get_own_repr(self):
+        try:
+            return self._addr_repr(self._address)
+        except AttributeError:
+            return '???'
+
+    def _cast_to_integer(self):
+        return self._address
+
+    def __nonzero__(self):
+        return bool(self._address)
+    __bool__ = __nonzero__
+
+    @classmethod
+    def _to_ctypes(cls, value):
+        if not isinstance(value, CTypesData):
+            raise TypeError("unexpected %s object" % type(value).__name__)
+        address = value._convert_to_address(cls)
+        return ctypes.cast(address, cls._ctype)
+
+    @classmethod
+    def _from_ctypes(cls, ctypes_ptr):
+        address = ctypes.cast(ctypes_ptr, ctypes.c_void_p).value or 0
+        return cls._new_pointer_at(address)
+
+    @classmethod
+    def _initialize(cls, ctypes_ptr, value):
+        if value:
+            ctypes_ptr.contents = cls._to_ctypes(value).contents
+
+    def _convert_to_address(self, BClass):
+        if (BClass in (self.__class__, None) or BClass._automatic_casts
+            or self._automatic_casts):
+            return self._address
+        else:
+            return CTypesData._convert_to_address(self, BClass)
+
+
+class CTypesBaseStructOrUnion(CTypesData):
+    __slots__ = ['_blob']
+
+    @classmethod
+    def _create_ctype_obj(cls, init):
+        # may be overridden
+        raise TypeError("cannot instantiate opaque type %s" % (cls,))
+
+    def _get_own_repr(self):
+        return self._addr_repr(ctypes.addressof(self._blob))
+
+    @classmethod
+    def _offsetof(cls, fieldname):
+        return getattr(cls._ctype, fieldname).offset
+
+    def _convert_to_address(self, BClass):
+        if getattr(BClass, '_BItem', None) is self.__class__:
+            return ctypes.addressof(self._blob)
+        else:
+            return CTypesData._convert_to_address(self, BClass)
+
+    @classmethod
+    def _from_ctypes(cls, ctypes_struct_or_union):
+        self = cls.__new__(cls)
+        self._blob = ctypes_struct_or_union
+        return self
+
+    @classmethod
+    def _to_ctypes(cls, value):
+        return value._blob
+
+    def __repr__(self, c_name=None):
+        return CTypesData.__repr__(self, c_name or self._get_c_name(' &'))
+
+
+class CTypesBackend(object):
+
+    PRIMITIVE_TYPES = {
+        'char': ctypes.c_char,
+        'short': ctypes.c_short,
+        'int': ctypes.c_int,
+        'long': ctypes.c_long,
+        'long long': ctypes.c_longlong,
+        'signed char': ctypes.c_byte,
+        'unsigned char': ctypes.c_ubyte,
+        'unsigned short': ctypes.c_ushort,
+        'unsigned int': ctypes.c_uint,
+        'unsigned long': ctypes.c_ulong,
+        'unsigned long long': ctypes.c_ulonglong,
+        'float': ctypes.c_float,
+        'double': ctypes.c_double,
+        '_Bool': ctypes.c_bool,
+        }
+
+    for _name in ['unsigned long long', 'unsigned long',
+                  'unsigned int', 'unsigned short', 'unsigned char']:
+        _size = ctypes.sizeof(PRIMITIVE_TYPES[_name])
+        PRIMITIVE_TYPES['uint%d_t' % (8*_size)] = PRIMITIVE_TYPES[_name]
+        if _size == ctypes.sizeof(ctypes.c_void_p):
+            PRIMITIVE_TYPES['uintptr_t'] = PRIMITIVE_TYPES[_name]
+        if _size == ctypes.sizeof(ctypes.c_size_t):
+            PRIMITIVE_TYPES['size_t'] = PRIMITIVE_TYPES[_name]
+
+    for _name in ['long long', 'long', 'int', 'short', 'signed char']:
+        _size = ctypes.sizeof(PRIMITIVE_TYPES[_name])
+        PRIMITIVE_TYPES['int%d_t' % (8*_size)] = PRIMITIVE_TYPES[_name]
+        if _size == ctypes.sizeof(ctypes.c_void_p):
+            PRIMITIVE_TYPES['intptr_t'] = PRIMITIVE_TYPES[_name]
+            PRIMITIVE_TYPES['ptrdiff_t'] = PRIMITIVE_TYPES[_name]
+        if _size == ctypes.sizeof(ctypes.c_size_t):
+            PRIMITIVE_TYPES['ssize_t'] = PRIMITIVE_TYPES[_name]
+
+
+    def __init__(self):
+        self.RTLD_LAZY = 0   # not supported anyway by ctypes
+        self.RTLD_NOW  = 0
+        self.RTLD_GLOBAL = ctypes.RTLD_GLOBAL
+        self.RTLD_LOCAL = ctypes.RTLD_LOCAL
+
+    def set_ffi(self, ffi):
+        self.ffi = ffi
+
+    def _get_types(self):
+        return CTypesData, CTypesType
+
+    def load_library(self, path, flags=0):
+        cdll = ctypes.CDLL(path, flags)
+        return CTypesLibrary(self, cdll)
+
+    def new_void_type(self):
+        class CTypesVoid(CTypesData):
+            __slots__ = []
+            _reftypename = 'void &'
+            @staticmethod
+            def _from_ctypes(novalue):
+                return None
+            @staticmethod
+            def _to_ctypes(novalue):
+                if novalue is not None:
+                    raise TypeError("None expected, got %s object" %
+                                    (type(novalue).__name__,))
+                return None
+        CTypesVoid._fix_class()
+        return CTypesVoid
+
+    def new_primitive_type(self, name):
+        if name == 'wchar_t':
+            raise NotImplementedError(name)
+        ctype = self.PRIMITIVE_TYPES[name]
+        if name == 'char':
+            kind = 'char'
+        elif name in ('float', 'double'):
+            kind = 'float'
+        else:
+            if name in ('signed char', 'unsigned char'):
+                kind = 'byte'
+            elif name == '_Bool':
+                kind = 'bool'
+            else:
+                kind = 'int'
+            is_signed = (ctype(-1).value == -1)
+        #
+        def _cast_source_to_int(source):
+            if isinstance(source, (int, long, float)):
+                source = int(source)
+            elif isinstance(source, CTypesData):
+                source = source._cast_to_integer()
+            elif isinstance(source, bytes):
+                source = ord(source)
+            elif source is None:
+                source = 0
+            else:
+                raise TypeError("bad type for cast to %r: %r" %
+                                (CTypesPrimitive, type(source).__name__))
+            return source
+        #
+        kind1 = kind
+        class CTypesPrimitive(CTypesGenericPrimitive):
+            __slots__ = ['_value']
+            _ctype = ctype
+            _reftypename = '%s &' % name
+            kind = kind1
+
+            def __init__(self, value):
+                self._value = value
+
+            @staticmethod
+            def _create_ctype_obj(init):
+                if init is None:
+                    return ctype()
+                return ctype(CTypesPrimitive._to_ctypes(init))
+
+            if kind == 'int' or kind == 'byte':
+                @classmethod
+                def _cast_from(cls, source):
+                    source = _cast_source_to_int(source)
+                    source = ctype(source).value     # cast within range
+                    return cls(source)
+                def __int__(self):
+                    return self._value
+
+            if kind == 'bool':
+                @classmethod
+                def _cast_from(cls, source):
+                    if not isinstance(source, (int, long, float)):
+                        source = _cast_source_to_int(source)
+                    return cls(bool(source))
+                def __int__(self):
+                    return int(self._value)
+
+            if kind == 'char':
+                @classmethod
+                def _cast_from(cls, source):
+                    source = _cast_source_to_int(source)
+                    source = bytechr(source & 0xFF)
+                    return cls(source)
+                def __int__(self):
+                    return ord(self._value)
+
+            if kind == 'float':
+                @classmethod
+                def _cast_from(cls, source):
+                    if isinstance(source, float):
+                        pass
+                    elif isinstance(source, CTypesGenericPrimitive):
+                        if hasattr(source, '__float__'):
+                            source = float(source)
+                        else:
+                            source = int(source)
+                    else:
+                        source = _cast_source_to_int(source)
+                    source = ctype(source).value     # fix precision
+                    return cls(source)
+                def __int__(self):
+                    return int(self._value)
+                def __float__(self):
+                    return self._value
+
+            _cast_to_integer = __int__
+
+            if kind == 'int' or kind == 'byte' or kind == 'bool':
+                @staticmethod
+                def _to_ctypes(x):
+                    if not isinstance(x, (int, long)):
+                        if isinstance(x, CTypesData):
+                            x = int(x)
+                        else:
+                            raise TypeError("integer expected, got %s" %
+                                            type(x).__name__)
+                    if ctype(x).value != x:
+                        if not is_signed and x < 0:
+                            raise OverflowError("%s: negative integer" % name)
+                        else:
+                            raise OverflowError("%s: integer out of bounds"
+                                                % name)
+                    return x
+
+            if kind == 'char':
+                @staticmethod
+                def _to_ctypes(x):
+                    if isinstance(x, bytes) and len(x) == 1:
+                        return x
+                    if isinstance(x, CTypesPrimitive):    # <CData <char>>
+                        return x._value
+                    raise TypeError("character expected, got %s" %
+                                    type(x).__name__)
+                def __nonzero__(self):
+                    return ord(self._value) != 0
+            else:
+                def __nonzero__(self):
+                    return self._value != 0
+            __bool__ = __nonzero__
+
+            if kind == 'float':
+                @staticmethod
+                def _to_ctypes(x):
+                    if not isinstance(x, (int, long, float, CTypesData)):
+                        raise TypeError("float expected, got %s" %
+                                        type(x).__name__)
+                    return ctype(x).value
+
+            @staticmethod
+            def _from_ctypes(value):
+                return getattr(value, 'value', value)
+
+            @staticmethod
+            def _initialize(blob, init):
+                blob.value = CTypesPrimitive._to_ctypes(init)
+
+            if kind == 'char':
+                def _to_string(self, maxlen):
+                    return self._value
+            if kind == 'byte':
+                def _to_string(self, maxlen):
+                    return chr(self._value & 0xff)
+        #
+        CTypesPrimitive._fix_class()
+        return CTypesPrimitive
+
+    def new_pointer_type(self, BItem):
+        getbtype = self.ffi._get_cached_btype
+        if BItem is getbtype(model.PrimitiveType('char')):
+            kind = 'charp'
+        elif BItem in (getbtype(model.PrimitiveType('signed char')),
+                       getbtype(model.PrimitiveType('unsigned char'))):
+            kind = 'bytep'
+        elif BItem is getbtype(model.void_type):
+            kind = 'voidp'
+        else:
+            kind = 'generic'
+        #
+        class CTypesPtr(CTypesGenericPtr):
+            __slots__ = ['_own']
+            if kind == 'charp':
+                __slots__ += ['__as_strbuf']
+            _BItem = BItem
+            if hasattr(BItem, '_ctype'):
+                _ctype = ctypes.POINTER(BItem._ctype)
+                _bitem_size = ctypes.sizeof(BItem._ctype)
+            else:
+                _ctype = ctypes.c_void_p
+            if issubclass(BItem, CTypesGenericArray):
+                _reftypename = BItem._get_c_name('(* &)')
+            else:
+                _reftypename = BItem._get_c_name(' * &')
+
+            def __init__(self, init):
+                ctypeobj = BItem._create_ctype_obj(init)
+                if kind == 'charp':
+                    self.__as_strbuf = ctypes.create_string_buffer(
+                        ctypeobj.value + b'\x00')
+                    self._as_ctype_ptr = ctypes.cast(
+                        self.__as_strbuf, self._ctype)
+                else:
+                    self._as_ctype_ptr = ctypes.pointer(ctypeobj)
+                self._address = ctypes.cast(self._as_ctype_ptr,
+                                            ctypes.c_void_p).value
+                self._own = True
+
+            def __add__(self, other):
+                if isinstance(other, (int, long)):
+                    return self._new_pointer_at(self._address +
+                                                other * self._bitem_size)
+                else:
+                    return NotImplemented
+
+            def __sub__(self, other):
+                if isinstance(other, (int, long)):
+                    return self._new_pointer_at(self._address -
+                                                other * self._bitem_size)
+                elif type(self) is type(other):
+                    return (self._address - other._address) // self._bitem_size
+                else:
+                    return NotImplemented
+
+            def __getitem__(self, index):
+                if getattr(self, '_own', False) and index != 0:
+                    raise IndexError
+                return BItem._from_ctypes(self._as_ctype_ptr[index])
+
+            def __setitem__(self, index, value):
+                self._as_ctype_ptr[index] = BItem._to_ctypes(value)
+
+            if kind == 'charp' or kind == 'voidp':
+                @classmethod
+                def _arg_to_ctypes(cls, *value):
+                    if value and isinstance(value[0], bytes):
+                        return ctypes.c_char_p(value[0])
+                    else:
+                        return super(CTypesPtr, cls)._arg_to_ctypes(*value)
+
+            if kind == 'charp' or kind == 'bytep':
+                def _to_string(self, maxlen):
+                    if maxlen < 0:
+                        maxlen = sys.maxsize
+                    p = ctypes.cast(self._as_ctype_ptr,
+                                    ctypes.POINTER(ctypes.c_char))
+                    n = 0
+                    while n < maxlen and p[n] != b'\x00':
+                        n += 1
+                    return b''.join([p[i] for i in range(n)])
+
+            def _get_own_repr(self):
+                if getattr(self, '_own', False):
+                    return 'owning %d bytes' % (
+                        ctypes.sizeof(self._as_ctype_ptr.contents),)
+                return super(CTypesPtr, self)._get_own_repr()
+        #
+        if (BItem is self.ffi._get_cached_btype(model.void_type) or
+            BItem is self.ffi._get_cached_btype(model.PrimitiveType('char'))):
+            CTypesPtr._automatic_casts = True
+        #
+        CTypesPtr._fix_class()
+        return CTypesPtr
+
+    def new_array_type(self, CTypesPtr, length):
+        if length is None:
+            brackets = ' &[]'
+        else:
+            brackets = ' &[%d]' % length
+        BItem = CTypesPtr._BItem
+        getbtype = self.ffi._get_cached_btype
+        if BItem is getbtype(model.PrimitiveType('char')):
+            kind = 'char'
+        elif BItem in (getbtype(model.PrimitiveType('signed char')),
+                       getbtype(model.PrimitiveType('unsigned char'))):
+            kind = 'byte'
+        else:
+            kind = 'generic'
+        #
+        class CTypesArray(CTypesGenericArray):
+            __slots__ = ['_blob', '_own']
+            if length is not None:
+                _ctype = BItem._ctype * length
+            else:
+                __slots__.append('_ctype')
+            _reftypename = BItem._get_c_name(brackets)
+            _declared_length = length
+            _CTPtr = CTypesPtr
+
+            def __init__(self, init):
+                if length is None:
+                    if isinstance(init, (int, long)):
+                        len1 = init
+                        init = None
+                    elif kind == 'char' and isinstance(init, bytes):
+                        len1 = len(init) + 1    # extra null
+                    else:
+                        init = tuple(init)
+                        len1 = len(init)
+                    self._ctype = BItem._ctype * len1
+                self._blob = self._ctype()
+                self._own = True
+                if init is not None:
+                    self._initialize(self._blob, init)
+
+            @staticmethod
+            def _initialize(blob, init):
+                if isinstance(init, bytes):
+                    init = [init[i:i+1] for i in range(len(init))]
+                else:
+                    if isinstance(init, CTypesGenericArray):
+                        if (len(init) != len(blob) or
+                            not isinstance(init, CTypesArray)):
+                            raise TypeError("length/type mismatch: %s" % (init,))
+                    init = tuple(init)
+                if len(init) > len(blob):
+                    raise IndexError("too many initializers")
+                addr = ctypes.cast(blob, ctypes.c_void_p).value
+                PTR = ctypes.POINTER(BItem._ctype)
+                itemsize = ctypes.sizeof(BItem._ctype)
+                for i, value in enumerate(init):
+                    p = ctypes.cast(addr + i * itemsize, PTR)
+                    BItem._initialize(p.contents, value)
+
+            def __len__(self):
+                return len(self._blob)
+
+            def __getitem__(self, index):
+                if not (0 <= index < len(self._blob)):
+                    raise IndexError
+                return BItem._from_ctypes(self._blob[index])
+
+            def __setitem__(self, index, value):
+                if not (0 <= index < len(self._blob)):
+                    raise IndexError
+                self._blob[index] = BItem._to_ctypes(value)
+
+            if kind == 'char' or kind == 'byte':
+                def _to_string(self, maxlen):
+                    if maxlen < 0:
+                        maxlen = len(self._blob)
+                    p = ctypes.cast(self._blob,
+                                    ctypes.POINTER(ctypes.c_char))
+                    n = 0
+                    while n < maxlen and p[n] != b'\x00':
+                        n += 1
+                    return b''.join([p[i] for i in range(n)])
+
+            def _get_own_repr(self):
+                if getattr(self, '_own', False):
+                    return 'owning %d bytes' % (ctypes.sizeof(self._blob),)
+                return super(CTypesArray, self)._get_own_repr()
+
+            def _convert_to_address(self, BClass):
+                if BClass in (CTypesPtr, None) or BClass._automatic_casts:
+                    return ctypes.addressof(self._blob)
+                else:
+                    return CTypesData._convert_to_address(self, BClass)
+
+            @staticmethod
+            def _from_ctypes(ctypes_array):
+                self = CTypesArray.__new__(CTypesArray)
+                self._blob = ctypes_array
+                return self
+
+            @staticmethod
+            def _arg_to_ctypes(value):
+                return CTypesPtr._arg_to_ctypes(value)
+
+            def __add__(self, other):
+                if isinstance(other, (int, long)):
+                    return CTypesPtr._new_pointer_at(
+                        ctypes.addressof(self._blob) +
+                        other * ctypes.sizeof(BItem._ctype))
+                else:
+                    return NotImplemented
+
+            @classmethod
+            def _cast_from(cls, source):
+                raise NotImplementedError("casting to %r" % (
+                    cls._get_c_name(),))
+        #
+        CTypesArray._fix_class()
+        return CTypesArray
+
+    def _new_struct_or_union(self, kind, name, base_ctypes_class):
+        #
+        class struct_or_union(base_ctypes_class):
+            pass
+        struct_or_union.__name__ = '%s_%s' % (kind, name)
+        kind1 = kind
+        #
+        class CTypesStructOrUnion(CTypesBaseStructOrUnion):
+            __slots__ = ['_blob']
+            _ctype = struct_or_union
+            _reftypename = '%s &' % (name,)
+            _kind = kind = kind1
+        #
+        CTypesStructOrUnion._fix_class()
+        return CTypesStructOrUnion
+
+    def new_struct_type(self, name):
+        return self._new_struct_or_union('struct', name, ctypes.Structure)
+
+    def new_union_type(self, name):
+        return self._new_struct_or_union('union', name, ctypes.Union)
+
+    def complete_struct_or_union(self, CTypesStructOrUnion, fields, tp,
+                                 totalsize=-1, totalalignment=-1, sflags=0,
+                                 pack=0):
+        if totalsize >= 0 or totalalignment >= 0:
+            raise NotImplementedError("the ctypes backend of CFFI does not support "
+                                      "structures completed by verify(); please "
+                                      "compile and install the _cffi_backend module.")
+        struct_or_union = CTypesStructOrUnion._ctype
+        fnames = [fname for (fname, BField, bitsize) in fields]
+        btypes = [BField for (fname, BField, bitsize) in fields]
+        bitfields = [bitsize for (fname, BField, bitsize) in fields]
+        #
+        bfield_types = {}
+        cfields = []
+        for (fname, BField, bitsize) in fields:
+            if bitsize < 0:
+                cfields.append((fname, BField._ctype))
+                bfield_types[fname] = BField
+            else:
+                cfields.append((fname, BField._ctype, bitsize))
+                bfield_types[fname] = Ellipsis
+        if sflags & 8:
+            struct_or_union._pack_ = 1
+        elif pack:
+            struct_or_union._pack_ = pack
+        struct_or_union._fields_ = cfields
+        CTypesStructOrUnion._bfield_types = bfield_types
+        #
+        @staticmethod
+        def _create_ctype_obj(init):
+            result = struct_or_union()
+            if init is not None:
+                initialize(result, init)
+            return result
+        CTypesStructOrUnion._create_ctype_obj = _create_ctype_obj
+        #
+        def initialize(blob, init):
+            if is_union:
+                if len(init) > 1:
+                    raise ValueError("union initializer: %d items given, but "
+                                    "only one supported (use a dict if needed)"
+                                     % (len(init),))
+            if not isinstance(init, dict):
+                if isinstance(init, (bytes, unicode)):
+                    raise TypeError("union initializer: got a str")
+                init = tuple(init)
+                if len(init) > len(fnames):
+                    raise ValueError("too many values for %s initializer" %
+                                     CTypesStructOrUnion._get_c_name())
+                init = dict(zip(fnames, init))
+            addr = ctypes.addressof(blob)
+            for fname, value in init.items():
+                BField, bitsize = name2fieldtype[fname]
+                assert bitsize < 0, \
+                       "not implemented: initializer with bit fields"
+                offset = CTypesStructOrUnion._offsetof(fname)
+                PTR = ctypes.POINTER(BField._ctype)
+                p = ctypes.cast(addr + offset, PTR)
+                BField._initialize(p.contents, value)
+        is_union = CTypesStructOrUnion._kind == 'union'
+        name2fieldtype = dict(zip(fnames, zip(btypes, bitfields)))
+        #
+        for fname, BField, bitsize in fields:
+            if fname == '':
+                raise NotImplementedError("nested anonymous structs/unions")
+            if hasattr(CTypesStructOrUnion, fname):
+                raise ValueError("the field name %r conflicts in "
+                                 "the ctypes backend" % fname)
+            if bitsize < 0:
+                def getter(self, fname=fname, BField=BField,
+                           offset=CTypesStructOrUnion._offsetof(fname),
+                           PTR=ctypes.POINTER(BField._ctype)):
+                    addr = ctypes.addressof(self._blob)
+                    p = ctypes.cast(addr + offset, PTR)
+                    return BField._from_ctypes(p.contents)
+                def setter(self, value, fname=fname, BField=BField):
+                    setattr(self._blob, fname, BField._to_ctypes(value))
+                #
+                if issubclass(BField, CTypesGenericArray):
+                    setter = None
+                    if BField._declared_length == 0:
+                        def getter(self, fname=fname, BFieldPtr=BField._CTPtr,
+                                   offset=CTypesStructOrUnion._offsetof(fname),
+                                   PTR=ctypes.POINTER(BField._ctype)):
+                            addr = ctypes.addressof(self._blob)
+                            p = ctypes.cast(addr + offset, PTR)
+                            return BFieldPtr._from_ctypes(p)
+                #
+            else:
+                def getter(self, fname=fname, BField=BField):
+                    return BField._from_ctypes(getattr(self._blob, fname))
+                def setter(self, value, fname=fname, BField=BField):
+                    # xxx obscure workaround
+                    value = BField._to_ctypes(value)
+                    oldvalue = getattr(self._blob, fname)
+                    setattr(self._blob, fname, value)
+                    if value != getattr(self._blob, fname):
+                        setattr(self._blob, fname, oldvalue)
+                        raise OverflowError("value too large for bitfield")
+            setattr(CTypesStructOrUnion, fname, property(getter, setter))
+        #
+        CTypesPtr = self.ffi._get_cached_btype(model.PointerType(tp))
+        for fname in fnames:
+            if hasattr(CTypesPtr, fname):
+                raise ValueError("the field name %r conflicts in "
+                                 "the ctypes backend" % fname)
+            def getter(self, fname=fname):
+                return getattr(self[0], fname)
+            def setter(self, value, fname=fname):
+                setattr(self[0], fname, value)
+            setattr(CTypesPtr, fname, property(getter, setter))
+
+    def new_function_type(self, BArgs, BResult, has_varargs):
+        nameargs = [BArg._get_c_name() for BArg in BArgs]
+        if has_varargs:
+            nameargs.append('...')
+        nameargs = ', '.join(nameargs)
+        #
+        class CTypesFunctionPtr(CTypesGenericPtr):
+            __slots__ = ['_own_callback', '_name']
+            _ctype = ctypes.CFUNCTYPE(getattr(BResult, '_ctype', None),
+                                      *[BArg._ctype for BArg in BArgs],
+                                      use_errno=True)
+            _reftypename = BResult._get_c_name('(* &)(%s)' % (nameargs,))
+
+            def __init__(self, init, error=None):
+                # create a callback to the Python callable init()
+                import traceback
+                assert not has_varargs, "varargs not supported for callbacks"
+                if getattr(BResult, '_ctype', None) is not None:
+                    error = BResult._from_ctypes(
+                        BResult._create_ctype_obj(error))
+                else:
+                    error = None
+                def callback(*args):
+                    args2 = []
+                    for arg, BArg in zip(args, BArgs):
+                        args2.append(BArg._from_ctypes(arg))
+                    try:
+                        res2 = init(*args2)
+                        res2 = BResult._to_ctypes(res2)
+                    except:
+                        traceback.print_exc()
+                        res2 = error
+                    if issubclass(BResult, CTypesGenericPtr):
+                        if res2:
+                            res2 = ctypes.cast(res2, ctypes.c_void_p).value
+                                # .value: http://bugs.python.org/issue1574593
+                        else:
+                            res2 = None
+                    #print repr(res2)
+                    return res2
+                if issubclass(BResult, CTypesGenericPtr):
+                    # The only pointers callbacks can return are void*s:
+                    # http://bugs.python.org/issue5710
+                    callback_ctype = ctypes.CFUNCTYPE(
+                        ctypes.c_void_p,
+                        *[BArg._ctype for BArg in BArgs],
+                        use_errno=True)
+                else:
+                    callback_ctype = CTypesFunctionPtr._ctype
+                self._as_ctype_ptr = callback_ctype(callback)
+                self._address = ctypes.cast(self._as_ctype_ptr,
+                                            ctypes.c_void_p).value
+                self._own_callback = init
+
+            @staticmethod
+            def _initialize(ctypes_ptr, value):
+                if value:
+                    raise NotImplementedError("ctypes backend: not supported: "
+                                          "initializers for function pointers")
+
+            def __repr__(self):
+                c_name = getattr(self, '_name', None)
+                if c_name:
+                    i = self._reftypename.index('(* &)')
+                    if self._reftypename[i-1] not in ' )*':
+                        c_name = ' ' + c_name
+                    c_name = self._reftypename.replace('(* &)', c_name)
+                return CTypesData.__repr__(self, c_name)
+
+            def _get_own_repr(self):
+                if getattr(self, '_own_callback', None) is not None:
+                    return 'calling %r' % (self._own_callback,)
+                return super(CTypesFunctionPtr, self)._get_own_repr()
+
+            def __call__(self, *args):
+                if has_varargs:
+                    assert len(args) >= len(BArgs)
+                    extraargs = args[len(BArgs):]
+                    args = args[:len(BArgs)]
+                else:
+                    assert len(args) == len(BArgs)
+                ctypes_args = []
+                for arg, BArg in zip(args, BArgs):
+                    ctypes_args.append(BArg._arg_to_ctypes(arg))
+                if has_varargs:
+                    for i, arg in enumerate(extraargs):
+                        if arg is None:
+                            ctypes_args.append(ctypes.c_void_p(0))  # NULL
+                            continue
+                        if not isinstance(arg, CTypesData):
+                            raise TypeError(
+                                "argument %d passed in the variadic part "
+                                "needs to be a cdata object (got %s)" %
+                                (1 + len(BArgs) + i, type(arg).__name__))
+                        ctypes_args.append(arg._arg_to_ctypes(arg))
+                result = self._as_ctype_ptr(*ctypes_args)
+                return BResult._from_ctypes(result)
+        #
+        CTypesFunctionPtr._fix_class()
+        return CTypesFunctionPtr
+
+    def new_enum_type(self, name, enumerators, enumvalues, CTypesInt):
+        assert isinstance(name, str)
+        reverse_mapping = dict(zip(reversed(enumvalues),
+                                   reversed(enumerators)))
+        #
+        class CTypesEnum(CTypesInt):
+            __slots__ = []
+            _reftypename = '%s &' % name
+
+            def _get_own_repr(self):
+                value = self._value
+                try:
+                    return '%d: %s' % (value, reverse_mapping[value])
+                except KeyError:
+                    return str(value)
+
+            def _to_string(self, maxlen):
+                value = self._value
+                try:
+                    return reverse_mapping[value]
+                except KeyError:
+                    return str(value)
+        #
+        CTypesEnum._fix_class()
+        return CTypesEnum
+
+    def get_errno(self):
+        return ctypes.get_errno()
+
+    def set_errno(self, value):
+        ctypes.set_errno(value)
+
+    def string(self, b, maxlen=-1):
+        return b._to_string(maxlen)
+
+    def buffer(self, bptr, size=-1):
+        raise NotImplementedError("buffer() with ctypes backend")
+
+    def sizeof(self, cdata_or_BType):
+        if isinstance(cdata_or_BType, CTypesData):
+            return cdata_or_BType._get_size_of_instance()
+        else:
+            assert issubclass(cdata_or_BType, CTypesData)
+            return cdata_or_BType._get_size()
+
+    def alignof(self, BType):
+        assert issubclass(BType, CTypesData)
+        return BType._alignment()
+
+    def newp(self, BType, source):
+        if not issubclass(BType, CTypesData):
+            raise TypeError
+        return BType._newp(source)
+
+    def cast(self, BType, source):
+        return BType._cast_from(source)
+
+    def callback(self, BType, source, error, onerror):
+        assert onerror is None   # XXX not implemented
+        return BType(source, error)
+
+    _weakref_cache_ref = None
+
+    def gcp(self, cdata, destructor, size=0):
+        if self._weakref_cache_ref is None:
+            import weakref
+            class MyRef(weakref.ref):
+                def __eq__(self, other):
+                    myref = self()
+                    return self is other or (
+                        myref is not None and myref is other())
+                def __ne__(self, other):
+                    return not (self == other)
+                def __hash__(self):
+                    try:
+                        return self._hash
+                    except AttributeError:
+                        self._hash = hash(self())
+                        return self._hash
+            self._weakref_cache_ref = {}, MyRef
+        weak_cache, MyRef = self._weakref_cache_ref
+
+        if destructor is None:
+            try:
+                del weak_cache[MyRef(cdata)]
+            except KeyError:
+                raise TypeError("Can remove destructor only on a object "
+                                "previously returned by ffi.gc()")
+            return None
+
+        def remove(k):
+            cdata, destructor = weak_cache.pop(k, (None, None))
+            if destructor is not None:
+                destructor(cdata)
+
+        new_cdata = self.cast(self.typeof(cdata), cdata)
+        assert new_cdata is not cdata
+        weak_cache[MyRef(new_cdata, remove)] = (cdata, destructor)
+        return new_cdata
+
+    typeof = type
+
+    def getcname(self, BType, replace_with):
+        return BType._get_c_name(replace_with)
+
+    def typeoffsetof(self, BType, fieldname, num=0):
+        if isinstance(fieldname, str):
+            if num == 0 and issubclass(BType, CTypesGenericPtr):
+                BType = BType._BItem
+            if not issubclass(BType, CTypesBaseStructOrUnion):
+                raise TypeError("expected a struct or union ctype")
+            BField = BType._bfield_types[fieldname]
+            if BField is Ellipsis:
+                raise TypeError("not supported for bitfields")
+            return (BField, BType._offsetof(fieldname))
+        elif isinstance(fieldname, (int, long)):
+            if issubclass(BType, CTypesGenericArray):
+                BType = BType._CTPtr
+            if not issubclass(BType, CTypesGenericPtr):
+                raise TypeError("expected an array or ptr ctype")
+            BItem = BType._BItem
+            offset = BItem._get_size() * fieldname
+            if offset > sys.maxsize:
+                raise OverflowError
+            return (BItem, offset)
+        else:
+            raise TypeError(type(fieldname))
+
+    def rawaddressof(self, BTypePtr, cdata, offset=None):
+        if isinstance(cdata, CTypesBaseStructOrUnion):
+            ptr = ctypes.pointer(type(cdata)._to_ctypes(cdata))
+        elif isinstance(cdata, CTypesGenericPtr):
+            if offset is None or not issubclass(type(cdata)._BItem,
+                                                CTypesBaseStructOrUnion):
+                raise TypeError("unexpected cdata type")
+            ptr = type(cdata)._to_ctypes(cdata)
+        elif isinstance(cdata, CTypesGenericArray):
+            ptr = type(cdata)._to_ctypes(cdata)
+        else:
+            raise TypeError("expected a <cdata 'struct-or-union'>")
+        if offset:
+            ptr = ctypes.cast(
+                ctypes.c_void_p(
+                    ctypes.cast(ptr, ctypes.c_void_p).value + offset),
+                type(ptr))
+        return BTypePtr._from_ctypes(ptr)
+
+
+class CTypesLibrary(object):
+
+    def __init__(self, backend, cdll):
+        self.backend = backend
+        self.cdll = cdll
+
+    def load_function(self, BType, name):
+        c_func = getattr(self.cdll, name)
+        funcobj = BType._from_ctypes(c_func)
+        funcobj._name = name
+        return funcobj
+
+    def read_variable(self, BType, name):
+        try:
+            ctypes_obj = BType._ctype.in_dll(self.cdll, name)
+        except AttributeError as e:
+            raise NotImplementedError(e)
+        return BType._from_ctypes(ctypes_obj)
+
+    def write_variable(self, BType, name, value):
+        new_ctypes_obj = BType._to_ctypes(value)
+        ctypes_obj = BType._ctype.in_dll(self.cdll, name)
+        ctypes.memmove(ctypes.addressof(ctypes_obj),
+                       ctypes.addressof(new_ctypes_obj),
+                       ctypes.sizeof(BType._ctype))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cffi_opcode.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cffi_opcode.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0df98d1c743790f4047672abcae0d00f993a2ce
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cffi_opcode.py
@@ -0,0 +1,187 @@
+from .error import VerificationError
+
+class CffiOp(object):
+    def __init__(self, op, arg):
+        self.op = op
+        self.arg = arg
+
+    def as_c_expr(self):
+        if self.op is None:
+            assert isinstance(self.arg, str)
+            return '(_cffi_opcode_t)(%s)' % (self.arg,)
+        classname = CLASS_NAME[self.op]
+        return '_CFFI_OP(_CFFI_OP_%s, %s)' % (classname, self.arg)
+
+    def as_python_bytes(self):
+        if self.op is None and self.arg.isdigit():
+            value = int(self.arg)     # non-negative: '-' not in self.arg
+            if value >= 2**31:
+                raise OverflowError("cannot emit %r: limited to 2**31-1"
+                                    % (self.arg,))
+            return format_four_bytes(value)
+        if isinstance(self.arg, str):
+            raise VerificationError("cannot emit to Python: %r" % (self.arg,))
+        return format_four_bytes((self.arg << 8) | self.op)
+
+    def __str__(self):
+        classname = CLASS_NAME.get(self.op, self.op)
+        return '(%s %s)' % (classname, self.arg)
+
+def format_four_bytes(num):
+    return '\\x%02X\\x%02X\\x%02X\\x%02X' % (
+        (num >> 24) & 0xFF,
+        (num >> 16) & 0xFF,
+        (num >>  8) & 0xFF,
+        (num      ) & 0xFF)
+
+OP_PRIMITIVE       = 1
+OP_POINTER         = 3
+OP_ARRAY           = 5
+OP_OPEN_ARRAY      = 7
+OP_STRUCT_UNION    = 9
+OP_ENUM            = 11
+OP_FUNCTION        = 13
+OP_FUNCTION_END    = 15
+OP_NOOP            = 17
+OP_BITFIELD        = 19
+OP_TYPENAME        = 21
+OP_CPYTHON_BLTN_V  = 23   # varargs
+OP_CPYTHON_BLTN_N  = 25   # noargs
+OP_CPYTHON_BLTN_O  = 27   # O  (i.e. a single arg)
+OP_CONSTANT        = 29
+OP_CONSTANT_INT    = 31
+OP_GLOBAL_VAR      = 33
+OP_DLOPEN_FUNC     = 35
+OP_DLOPEN_CONST    = 37
+OP_GLOBAL_VAR_F    = 39
+OP_EXTERN_PYTHON   = 41
+
+PRIM_VOID          = 0
+PRIM_BOOL          = 1
+PRIM_CHAR          = 2
+PRIM_SCHAR         = 3
+PRIM_UCHAR         = 4
+PRIM_SHORT         = 5
+PRIM_USHORT        = 6
+PRIM_INT           = 7
+PRIM_UINT          = 8
+PRIM_LONG          = 9
+PRIM_ULONG         = 10
+PRIM_LONGLONG      = 11
+PRIM_ULONGLONG     = 12
+PRIM_FLOAT         = 13
+PRIM_DOUBLE        = 14
+PRIM_LONGDOUBLE    = 15
+
+PRIM_WCHAR         = 16
+PRIM_INT8          = 17
+PRIM_UINT8         = 18
+PRIM_INT16         = 19
+PRIM_UINT16        = 20
+PRIM_INT32         = 21
+PRIM_UINT32        = 22
+PRIM_INT64         = 23
+PRIM_UINT64        = 24
+PRIM_INTPTR        = 25
+PRIM_UINTPTR       = 26
+PRIM_PTRDIFF       = 27
+PRIM_SIZE          = 28
+PRIM_SSIZE         = 29
+PRIM_INT_LEAST8    = 30
+PRIM_UINT_LEAST8   = 31
+PRIM_INT_LEAST16   = 32
+PRIM_UINT_LEAST16  = 33
+PRIM_INT_LEAST32   = 34
+PRIM_UINT_LEAST32  = 35
+PRIM_INT_LEAST64   = 36
+PRIM_UINT_LEAST64  = 37
+PRIM_INT_FAST8     = 38
+PRIM_UINT_FAST8    = 39
+PRIM_INT_FAST16    = 40
+PRIM_UINT_FAST16   = 41
+PRIM_INT_FAST32    = 42
+PRIM_UINT_FAST32   = 43
+PRIM_INT_FAST64    = 44
+PRIM_UINT_FAST64   = 45
+PRIM_INTMAX        = 46
+PRIM_UINTMAX       = 47
+PRIM_FLOATCOMPLEX  = 48
+PRIM_DOUBLECOMPLEX = 49
+PRIM_CHAR16        = 50
+PRIM_CHAR32        = 51
+
+_NUM_PRIM          = 52
+_UNKNOWN_PRIM          = -1
+_UNKNOWN_FLOAT_PRIM    = -2
+_UNKNOWN_LONG_DOUBLE   = -3
+
+_IO_FILE_STRUCT        = -1
+
+PRIMITIVE_TO_INDEX = {
+    'char':               PRIM_CHAR,
+    'short':              PRIM_SHORT,
+    'int':                PRIM_INT,
+    'long':               PRIM_LONG,
+    'long long':          PRIM_LONGLONG,
+    'signed char':        PRIM_SCHAR,
+    'unsigned char':      PRIM_UCHAR,
+    'unsigned short':     PRIM_USHORT,
+    'unsigned int':       PRIM_UINT,
+    'unsigned long':      PRIM_ULONG,
+    'unsigned long long': PRIM_ULONGLONG,
+    'float':              PRIM_FLOAT,
+    'double':             PRIM_DOUBLE,
+    'long double':        PRIM_LONGDOUBLE,
+    'float _Complex':     PRIM_FLOATCOMPLEX,
+    'double _Complex':    PRIM_DOUBLECOMPLEX,
+    '_Bool':              PRIM_BOOL,
+    'wchar_t':            PRIM_WCHAR,
+    'char16_t':           PRIM_CHAR16,
+    'char32_t':           PRIM_CHAR32,
+    'int8_t':             PRIM_INT8,
+    'uint8_t':            PRIM_UINT8,
+    'int16_t':            PRIM_INT16,
+    'uint16_t':           PRIM_UINT16,
+    'int32_t':            PRIM_INT32,
+    'uint32_t':           PRIM_UINT32,
+    'int64_t':            PRIM_INT64,
+    'uint64_t':           PRIM_UINT64,
+    'intptr_t':           PRIM_INTPTR,
+    'uintptr_t':          PRIM_UINTPTR,
+    'ptrdiff_t':          PRIM_PTRDIFF,
+    'size_t':             PRIM_SIZE,
+    'ssize_t':            PRIM_SSIZE,
+    'int_least8_t':       PRIM_INT_LEAST8,
+    'uint_least8_t':      PRIM_UINT_LEAST8,
+    'int_least16_t':      PRIM_INT_LEAST16,
+    'uint_least16_t':     PRIM_UINT_LEAST16,
+    'int_least32_t':      PRIM_INT_LEAST32,
+    'uint_least32_t':     PRIM_UINT_LEAST32,
+    'int_least64_t':      PRIM_INT_LEAST64,
+    'uint_least64_t':     PRIM_UINT_LEAST64,
+    'int_fast8_t':        PRIM_INT_FAST8,
+    'uint_fast8_t':       PRIM_UINT_FAST8,
+    'int_fast16_t':       PRIM_INT_FAST16,
+    'uint_fast16_t':      PRIM_UINT_FAST16,
+    'int_fast32_t':       PRIM_INT_FAST32,
+    'uint_fast32_t':      PRIM_UINT_FAST32,
+    'int_fast64_t':       PRIM_INT_FAST64,
+    'uint_fast64_t':      PRIM_UINT_FAST64,
+    'intmax_t':           PRIM_INTMAX,
+    'uintmax_t':          PRIM_UINTMAX,
+    }
+
+F_UNION         = 0x01
+F_CHECK_FIELDS  = 0x02
+F_PACKED        = 0x04
+F_EXTERNAL      = 0x08
+F_OPAQUE        = 0x10
+
+G_FLAGS = dict([('_CFFI_' + _key, globals()[_key])
+                for _key in ['F_UNION', 'F_CHECK_FIELDS', 'F_PACKED',
+                             'F_EXTERNAL', 'F_OPAQUE']])
+
+CLASS_NAME = {}
+for _name, _value in list(globals().items()):
+    if _name.startswith('OP_') and isinstance(_value, int):
+        CLASS_NAME[_value] = _name[3:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/commontypes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/commontypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..8ec97c756a4b1023fd3963dd39b706f7c0e34373
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/commontypes.py
@@ -0,0 +1,80 @@
+import sys
+from . import model
+from .error import FFIError
+
+
+COMMON_TYPES = {}
+
+try:
+    # fetch "bool" and all simple Windows types
+    from _cffi_backend import _get_common_types
+    _get_common_types(COMMON_TYPES)
+except ImportError:
+    pass
+
+COMMON_TYPES['FILE'] = model.unknown_type('FILE', '_IO_FILE')
+COMMON_TYPES['bool'] = '_Bool'    # in case we got ImportError above
+
+for _type in model.PrimitiveType.ALL_PRIMITIVE_TYPES:
+    if _type.endswith('_t'):
+        COMMON_TYPES[_type] = _type
+del _type
+
+_CACHE = {}
+
+def resolve_common_type(parser, commontype):
+    try:
+        return _CACHE[commontype]
+    except KeyError:
+        cdecl = COMMON_TYPES.get(commontype, commontype)
+        if not isinstance(cdecl, str):
+            result, quals = cdecl, 0    # cdecl is already a BaseType
+        elif cdecl in model.PrimitiveType.ALL_PRIMITIVE_TYPES:
+            result, quals = model.PrimitiveType(cdecl), 0
+        elif cdecl == 'set-unicode-needed':
+            raise FFIError("The Windows type %r is only available after "
+                           "you call ffi.set_unicode()" % (commontype,))
+        else:
+            if commontype == cdecl:
+                raise FFIError(
+                    "Unsupported type: %r.  Please look at "
+        "http://cffi.readthedocs.io/en/latest/cdef.html#ffi-cdef-limitations "
+                    "and file an issue if you think this type should really "
+                    "be supported." % (commontype,))
+            result, quals = parser.parse_type_and_quals(cdecl)   # recursive
+
+        assert isinstance(result, model.BaseTypeByIdentity)
+        _CACHE[commontype] = result, quals
+        return result, quals
+
+
+# ____________________________________________________________
+# extra types for Windows (most of them are in commontypes.c)
+
+
+def win_common_types():
+    return {
+        "UNICODE_STRING": model.StructType(
+            "_UNICODE_STRING",
+            ["Length",
+             "MaximumLength",
+             "Buffer"],
+            [model.PrimitiveType("unsigned short"),
+             model.PrimitiveType("unsigned short"),
+             model.PointerType(model.PrimitiveType("wchar_t"))],
+            [-1, -1, -1]),
+        "PUNICODE_STRING": "UNICODE_STRING *",
+        "PCUNICODE_STRING": "const UNICODE_STRING *",
+
+        "TBYTE": "set-unicode-needed",
+        "TCHAR": "set-unicode-needed",
+        "LPCTSTR": "set-unicode-needed",
+        "PCTSTR": "set-unicode-needed",
+        "LPTSTR": "set-unicode-needed",
+        "PTSTR": "set-unicode-needed",
+        "PTBYTE": "set-unicode-needed",
+        "PTCHAR": "set-unicode-needed",
+        }
+
+if sys.platform == 'win32':
+    COMMON_TYPES.update(win_common_types())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cparser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..74830e913f21409f536febddae7769d0364cd24b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/cparser.py
@@ -0,0 +1,1006 @@
+from . import model
+from .commontypes import COMMON_TYPES, resolve_common_type
+from .error import FFIError, CDefError
+try:
+    from . import _pycparser as pycparser
+except ImportError:
+    import pycparser
+import weakref, re, sys
+
+try:
+    if sys.version_info < (3,):
+        import thread as _thread
+    else:
+        import _thread
+    lock = _thread.allocate_lock()
+except ImportError:
+    lock = None
+
+def _workaround_for_static_import_finders():
+    # Issue #392: packaging tools like cx_Freeze can not find these
+    # because pycparser uses exec dynamic import.  This is an obscure
+    # workaround.  This function is never called.
+    import pycparser.yacctab
+    import pycparser.lextab
+
+CDEF_SOURCE_STRING = "<cdef source string>"
+_r_comment = re.compile(r"/\*.*?\*/|//([^\n\\]|\\.)*?$",
+                        re.DOTALL | re.MULTILINE)
+_r_define  = re.compile(r"^\s*#\s*define\s+([A-Za-z_][A-Za-z_0-9]*)"
+                        r"\b((?:[^\n\\]|\\.)*?)$",
+                        re.DOTALL | re.MULTILINE)
+_r_line_directive = re.compile(r"^[ \t]*#[ \t]*(?:line|\d+)\b.*$", re.MULTILINE)
+_r_partial_enum = re.compile(r"=\s*\.\.\.\s*[,}]|\.\.\.\s*\}")
+_r_enum_dotdotdot = re.compile(r"__dotdotdot\d+__$")
+_r_partial_array = re.compile(r"\[\s*\.\.\.\s*\]")
+_r_words = re.compile(r"\w+|\S")
+_parser_cache = None
+_r_int_literal = re.compile(r"-?0?x?[0-9a-f]+[lu]*$", re.IGNORECASE)
+_r_stdcall1 = re.compile(r"\b(__stdcall|WINAPI)\b")
+_r_stdcall2 = re.compile(r"[(]\s*(__stdcall|WINAPI)\b")
+_r_cdecl = re.compile(r"\b__cdecl\b")
+_r_extern_python = re.compile(r'\bextern\s*"'
+                              r'(Python|Python\s*\+\s*C|C\s*\+\s*Python)"\s*.')
+_r_star_const_space = re.compile(       # matches "* const "
+    r"[*]\s*((const|volatile|restrict)\b\s*)+")
+_r_int_dotdotdot = re.compile(r"(\b(int|long|short|signed|unsigned|char)\s*)+"
+                              r"\.\.\.")
+_r_float_dotdotdot = re.compile(r"\b(double|float)\s*\.\.\.")
+
+def _get_parser():
+    global _parser_cache
+    if _parser_cache is None:
+        _parser_cache = pycparser.CParser()
+    return _parser_cache
+
+def _workaround_for_old_pycparser(csource):
+    # Workaround for a pycparser issue (fixed between pycparser 2.10 and
+    # 2.14): "char*const***" gives us a wrong syntax tree, the same as
+    # for "char***(*const)".  This means we can't tell the difference
+    # afterwards.  But "char(*const(***))" gives us the right syntax
+    # tree.  The issue only occurs if there are several stars in
+    # sequence with no parenthesis inbetween, just possibly qualifiers.
+    # Attempt to fix it by adding some parentheses in the source: each
+    # time we see "* const" or "* const *", we add an opening
+    # parenthesis before each star---the hard part is figuring out where
+    # to close them.
+    parts = []
+    while True:
+        match = _r_star_const_space.search(csource)
+        if not match:
+            break
+        #print repr(''.join(parts)+csource), '=>',
+        parts.append(csource[:match.start()])
+        parts.append('('); closing = ')'
+        parts.append(match.group())   # e.g. "* const "
+        endpos = match.end()
+        if csource.startswith('*', endpos):
+            parts.append('('); closing += ')'
+        level = 0
+        i = endpos
+        while i < len(csource):
+            c = csource[i]
+            if c == '(':
+                level += 1
+            elif c == ')':
+                if level == 0:
+                    break
+                level -= 1
+            elif c in ',;=':
+                if level == 0:
+                    break
+            i += 1
+        csource = csource[endpos:i] + closing + csource[i:]
+        #print repr(''.join(parts)+csource)
+    parts.append(csource)
+    return ''.join(parts)
+
+def _preprocess_extern_python(csource):
+    # input: `extern "Python" int foo(int);` or
+    #        `extern "Python" { int foo(int); }`
+    # output:
+    #     void __cffi_extern_python_start;
+    #     int foo(int);
+    #     void __cffi_extern_python_stop;
+    #
+    # input: `extern "Python+C" int foo(int);`
+    # output:
+    #     void __cffi_extern_python_plus_c_start;
+    #     int foo(int);
+    #     void __cffi_extern_python_stop;
+    parts = []
+    while True:
+        match = _r_extern_python.search(csource)
+        if not match:
+            break
+        endpos = match.end() - 1
+        #print
+        #print ''.join(parts)+csource
+        #print '=>'
+        parts.append(csource[:match.start()])
+        if 'C' in match.group(1):
+            parts.append('void __cffi_extern_python_plus_c_start; ')
+        else:
+            parts.append('void __cffi_extern_python_start; ')
+        if csource[endpos] == '{':
+            # grouping variant
+            closing = csource.find('}', endpos)
+            if closing < 0:
+                raise CDefError("'extern \"Python\" {': no '}' found")
+            if csource.find('{', endpos + 1, closing) >= 0:
+                raise NotImplementedError("cannot use { } inside a block "
+                                          "'extern \"Python\" { ... }'")
+            parts.append(csource[endpos+1:closing])
+            csource = csource[closing+1:]
+        else:
+            # non-grouping variant
+            semicolon = csource.find(';', endpos)
+            if semicolon < 0:
+                raise CDefError("'extern \"Python\": no ';' found")
+            parts.append(csource[endpos:semicolon+1])
+            csource = csource[semicolon+1:]
+        parts.append(' void __cffi_extern_python_stop;')
+        #print ''.join(parts)+csource
+        #print
+    parts.append(csource)
+    return ''.join(parts)
+
+def _warn_for_string_literal(csource):
+    if '"' not in csource:
+        return
+    for line in csource.splitlines():
+        if '"' in line and not line.lstrip().startswith('#'):
+            import warnings
+            warnings.warn("String literal found in cdef() or type source. "
+                          "String literals are ignored here, but you should "
+                          "remove them anyway because some character sequences "
+                          "confuse pre-parsing.")
+            break
+
+def _warn_for_non_extern_non_static_global_variable(decl):
+    if not decl.storage:
+        import warnings
+        warnings.warn("Global variable '%s' in cdef(): for consistency "
+                      "with C it should have a storage class specifier "
+                      "(usually 'extern')" % (decl.name,))
+
+def _remove_line_directives(csource):
+    # _r_line_directive matches whole lines, without the final \n, if they
+    # start with '#line' with some spacing allowed, or '#NUMBER'.  This
+    # function stores them away and replaces them with exactly the string
+    # '#line@N', where N is the index in the list 'line_directives'.
+    line_directives = []
+    def replace(m):
+        i = len(line_directives)
+        line_directives.append(m.group())
+        return '#line@%d' % i
+    csource = _r_line_directive.sub(replace, csource)
+    return csource, line_directives
+
+def _put_back_line_directives(csource, line_directives):
+    def replace(m):
+        s = m.group()
+        if not s.startswith('#line@'):
+            raise AssertionError("unexpected #line directive "
+                                 "(should have been processed and removed")
+        return line_directives[int(s[6:])]
+    return _r_line_directive.sub(replace, csource)
+
+def _preprocess(csource):
+    # First, remove the lines of the form '#line N "filename"' because
+    # the "filename" part could confuse the rest
+    csource, line_directives = _remove_line_directives(csource)
+    # Remove comments.  NOTE: this only work because the cdef() section
+    # should not contain any string literals (except in line directives)!
+    def replace_keeping_newlines(m):
+        return ' ' + m.group().count('\n') * '\n'
+    csource = _r_comment.sub(replace_keeping_newlines, csource)
+    # Remove the "#define FOO x" lines
+    macros = {}
+    for match in _r_define.finditer(csource):
+        macroname, macrovalue = match.groups()
+        macrovalue = macrovalue.replace('\\\n', '').strip()
+        macros[macroname] = macrovalue
+    csource = _r_define.sub('', csource)
+    #
+    if pycparser.__version__ < '2.14':
+        csource = _workaround_for_old_pycparser(csource)
+    #
+    # BIG HACK: replace WINAPI or __stdcall with "volatile const".
+    # It doesn't make sense for the return type of a function to be
+    # "volatile volatile const", so we abuse it to detect __stdcall...
+    # Hack number 2 is that "int(volatile *fptr)();" is not valid C
+    # syntax, so we place the "volatile" before the opening parenthesis.
+    csource = _r_stdcall2.sub(' volatile volatile const(', csource)
+    csource = _r_stdcall1.sub(' volatile volatile const ', csource)
+    csource = _r_cdecl.sub(' ', csource)
+    #
+    # Replace `extern "Python"` with start/end markers
+    csource = _preprocess_extern_python(csource)
+    #
+    # Now there should not be any string literal left; warn if we get one
+    _warn_for_string_literal(csource)
+    #
+    # Replace "[...]" with "[__dotdotdotarray__]"
+    csource = _r_partial_array.sub('[__dotdotdotarray__]', csource)
+    #
+    # Replace "...}" with "__dotdotdotNUM__}".  This construction should
+    # occur only at the end of enums; at the end of structs we have "...;}"
+    # and at the end of vararg functions "...);".  Also replace "=...[,}]"
+    # with ",__dotdotdotNUM__[,}]": this occurs in the enums too, when
+    # giving an unknown value.
+    matches = list(_r_partial_enum.finditer(csource))
+    for number, match in enumerate(reversed(matches)):
+        p = match.start()
+        if csource[p] == '=':
+            p2 = csource.find('...', p, match.end())
+            assert p2 > p
+            csource = '%s,__dotdotdot%d__ %s' % (csource[:p], number,
+                                                 csource[p2+3:])
+        else:
+            assert csource[p:p+3] == '...'
+            csource = '%s __dotdotdot%d__ %s' % (csource[:p], number,
+                                                 csource[p+3:])
+    # Replace "int ..." or "unsigned long int..." with "__dotdotdotint__"
+    csource = _r_int_dotdotdot.sub(' __dotdotdotint__ ', csource)
+    # Replace "float ..." or "double..." with "__dotdotdotfloat__"
+    csource = _r_float_dotdotdot.sub(' __dotdotdotfloat__ ', csource)
+    # Replace all remaining "..." with the same name, "__dotdotdot__",
+    # which is declared with a typedef for the purpose of C parsing.
+    csource = csource.replace('...', ' __dotdotdot__ ')
+    # Finally, put back the line directives
+    csource = _put_back_line_directives(csource, line_directives)
+    return csource, macros
+
+def _common_type_names(csource):
+    # Look in the source for what looks like usages of types from the
+    # list of common types.  A "usage" is approximated here as the
+    # appearance of the word, minus a "definition" of the type, which
+    # is the last word in a "typedef" statement.  Approximative only
+    # but should be fine for all the common types.
+    look_for_words = set(COMMON_TYPES)
+    look_for_words.add(';')
+    look_for_words.add(',')
+    look_for_words.add('(')
+    look_for_words.add(')')
+    look_for_words.add('typedef')
+    words_used = set()
+    is_typedef = False
+    paren = 0
+    previous_word = ''
+    for word in _r_words.findall(csource):
+        if word in look_for_words:
+            if word == ';':
+                if is_typedef:
+                    words_used.discard(previous_word)
+                    look_for_words.discard(previous_word)
+                    is_typedef = False
+            elif word == 'typedef':
+                is_typedef = True
+                paren = 0
+            elif word == '(':
+                paren += 1
+            elif word == ')':
+                paren -= 1
+            elif word == ',':
+                if is_typedef and paren == 0:
+                    words_used.discard(previous_word)
+                    look_for_words.discard(previous_word)
+            else:   # word in COMMON_TYPES
+                words_used.add(word)
+        previous_word = word
+    return words_used
+
+
+class Parser(object):
+
+    def __init__(self):
+        self._declarations = {}
+        self._included_declarations = set()
+        self._anonymous_counter = 0
+        self._structnode2type = weakref.WeakKeyDictionary()
+        self._options = {}
+        self._int_constants = {}
+        self._recomplete = []
+        self._uses_new_feature = None
+
+    def _parse(self, csource):
+        csource, macros = _preprocess(csource)
+        # XXX: for more efficiency we would need to poke into the
+        # internals of CParser...  the following registers the
+        # typedefs, because their presence or absence influences the
+        # parsing itself (but what they are typedef'ed to plays no role)
+        ctn = _common_type_names(csource)
+        typenames = []
+        for name in sorted(self._declarations):
+            if name.startswith('typedef '):
+                name = name[8:]
+                typenames.append(name)
+                ctn.discard(name)
+        typenames += sorted(ctn)
+        #
+        csourcelines = []
+        csourcelines.append('# 1 "<cdef automatic initialization code>"')
+        for typename in typenames:
+            csourcelines.append('typedef int %s;' % typename)
+        csourcelines.append('typedef int __dotdotdotint__, __dotdotdotfloat__,'
+                            ' __dotdotdot__;')
+        # this forces pycparser to consider the following in the file
+        # called <cdef source string> from line 1
+        csourcelines.append('# 1 "%s"' % (CDEF_SOURCE_STRING,))
+        csourcelines.append(csource)
+        fullcsource = '\n'.join(csourcelines)
+        if lock is not None:
+            lock.acquire()     # pycparser is not thread-safe...
+        try:
+            ast = _get_parser().parse(fullcsource)
+        except pycparser.c_parser.ParseError as e:
+            self.convert_pycparser_error(e, csource)
+        finally:
+            if lock is not None:
+                lock.release()
+        # csource will be used to find buggy source text
+        return ast, macros, csource
+
+    def _convert_pycparser_error(self, e, csource):
+        # xxx look for "<cdef source string>:NUM:" at the start of str(e)
+        # and interpret that as a line number.  This will not work if
+        # the user gives explicit ``# NUM "FILE"`` directives.
+        line = None
+        msg = str(e)
+        match = re.match(r"%s:(\d+):" % (CDEF_SOURCE_STRING,), msg)
+        if match:
+            linenum = int(match.group(1), 10)
+            csourcelines = csource.splitlines()
+            if 1 <= linenum <= len(csourcelines):
+                line = csourcelines[linenum-1]
+        return line
+
+    def convert_pycparser_error(self, e, csource):
+        line = self._convert_pycparser_error(e, csource)
+
+        msg = str(e)
+        if line:
+            msg = 'cannot parse "%s"\n%s' % (line.strip(), msg)
+        else:
+            msg = 'parse error\n%s' % (msg,)
+        raise CDefError(msg)
+
+    def parse(self, csource, override=False, packed=False, pack=None,
+                    dllexport=False):
+        if packed:
+            if packed != True:
+                raise ValueError("'packed' should be False or True; use "
+                                 "'pack' to give another value")
+            if pack:
+                raise ValueError("cannot give both 'pack' and 'packed'")
+            pack = 1
+        elif pack:
+            if pack & (pack - 1):
+                raise ValueError("'pack' must be a power of two, not %r" %
+                    (pack,))
+        else:
+            pack = 0
+        prev_options = self._options
+        try:
+            self._options = {'override': override,
+                             'packed': pack,
+                             'dllexport': dllexport}
+            self._internal_parse(csource)
+        finally:
+            self._options = prev_options
+
+    def _internal_parse(self, csource):
+        ast, macros, csource = self._parse(csource)
+        # add the macros
+        self._process_macros(macros)
+        # find the first "__dotdotdot__" and use that as a separator
+        # between the repeated typedefs and the real csource
+        iterator = iter(ast.ext)
+        for decl in iterator:
+            if decl.name == '__dotdotdot__':
+                break
+        else:
+            assert 0
+        current_decl = None
+        #
+        try:
+            self._inside_extern_python = '__cffi_extern_python_stop'
+            for decl in iterator:
+                current_decl = decl
+                if isinstance(decl, pycparser.c_ast.Decl):
+                    self._parse_decl(decl)
+                elif isinstance(decl, pycparser.c_ast.Typedef):
+                    if not decl.name:
+                        raise CDefError("typedef does not declare any name",
+                                        decl)
+                    quals = 0
+                    if (isinstance(decl.type.type, pycparser.c_ast.IdentifierType) and
+                            decl.type.type.names[-1].startswith('__dotdotdot')):
+                        realtype = self._get_unknown_type(decl)
+                    elif (isinstance(decl.type, pycparser.c_ast.PtrDecl) and
+                          isinstance(decl.type.type, pycparser.c_ast.TypeDecl) and
+                          isinstance(decl.type.type.type,
+                                     pycparser.c_ast.IdentifierType) and
+                          decl.type.type.type.names[-1].startswith('__dotdotdot')):
+                        realtype = self._get_unknown_ptr_type(decl)
+                    else:
+                        realtype, quals = self._get_type_and_quals(
+                            decl.type, name=decl.name, partial_length_ok=True,
+                            typedef_example="*(%s *)0" % (decl.name,))
+                    self._declare('typedef ' + decl.name, realtype, quals=quals)
+                elif decl.__class__.__name__ == 'Pragma':
+                    pass    # skip pragma, only in pycparser 2.15
+                else:
+                    raise CDefError("unexpected <%s>: this construct is valid "
+                                    "C but not valid in cdef()" %
+                                    decl.__class__.__name__, decl)
+        except CDefError as e:
+            if len(e.args) == 1:
+                e.args = e.args + (current_decl,)
+            raise
+        except FFIError as e:
+            msg = self._convert_pycparser_error(e, csource)
+            if msg:
+                e.args = (e.args[0] + "\n    *** Err: %s" % msg,)
+            raise
+
+    def _add_constants(self, key, val):
+        if key in self._int_constants:
+            if self._int_constants[key] == val:
+                return     # ignore identical double declarations
+            raise FFIError(
+                "multiple declarations of constant: %s" % (key,))
+        self._int_constants[key] = val
+
+    def _add_integer_constant(self, name, int_str):
+        int_str = int_str.lower().rstrip("ul")
+        neg = int_str.startswith('-')
+        if neg:
+            int_str = int_str[1:]
+        # "010" is not valid oct in py3
+        if (int_str.startswith("0") and int_str != '0'
+                and not int_str.startswith("0x")):
+            int_str = "0o" + int_str[1:]
+        pyvalue = int(int_str, 0)
+        if neg:
+            pyvalue = -pyvalue
+        self._add_constants(name, pyvalue)
+        self._declare('macro ' + name, pyvalue)
+
+    def _process_macros(self, macros):
+        for key, value in macros.items():
+            value = value.strip()
+            if _r_int_literal.match(value):
+                self._add_integer_constant(key, value)
+            elif value == '...':
+                self._declare('macro ' + key, value)
+            else:
+                raise CDefError(
+                    'only supports one of the following syntax:\n'
+                    '  #define %s ...     (literally dot-dot-dot)\n'
+                    '  #define %s NUMBER  (with NUMBER an integer'
+                                    ' constant, decimal/hex/octal)\n'
+                    'got:\n'
+                    '  #define %s %s'
+                    % (key, key, key, value))
+
+    def _declare_function(self, tp, quals, decl):
+        tp = self._get_type_pointer(tp, quals)
+        if self._options.get('dllexport'):
+            tag = 'dllexport_python '
+        elif self._inside_extern_python == '__cffi_extern_python_start':
+            tag = 'extern_python '
+        elif self._inside_extern_python == '__cffi_extern_python_plus_c_start':
+            tag = 'extern_python_plus_c '
+        else:
+            tag = 'function '
+        self._declare(tag + decl.name, tp)
+
+    def _parse_decl(self, decl):
+        node = decl.type
+        if isinstance(node, pycparser.c_ast.FuncDecl):
+            tp, quals = self._get_type_and_quals(node, name=decl.name)
+            assert isinstance(tp, model.RawFunctionType)
+            self._declare_function(tp, quals, decl)
+        else:
+            if isinstance(node, pycparser.c_ast.Struct):
+                self._get_struct_union_enum_type('struct', node)
+            elif isinstance(node, pycparser.c_ast.Union):
+                self._get_struct_union_enum_type('union', node)
+            elif isinstance(node, pycparser.c_ast.Enum):
+                self._get_struct_union_enum_type('enum', node)
+            elif not decl.name:
+                raise CDefError("construct does not declare any variable",
+                                decl)
+            #
+            if decl.name:
+                tp, quals = self._get_type_and_quals(node,
+                                                     partial_length_ok=True)
+                if tp.is_raw_function:
+                    self._declare_function(tp, quals, decl)
+                elif (tp.is_integer_type() and
+                        hasattr(decl, 'init') and
+                        hasattr(decl.init, 'value') and
+                        _r_int_literal.match(decl.init.value)):
+                    self._add_integer_constant(decl.name, decl.init.value)
+                elif (tp.is_integer_type() and
+                        isinstance(decl.init, pycparser.c_ast.UnaryOp) and
+                        decl.init.op == '-' and
+                        hasattr(decl.init.expr, 'value') and
+                        _r_int_literal.match(decl.init.expr.value)):
+                    self._add_integer_constant(decl.name,
+                                               '-' + decl.init.expr.value)
+                elif (tp is model.void_type and
+                      decl.name.startswith('__cffi_extern_python_')):
+                    # hack: `extern "Python"` in the C source is replaced
+                    # with "void __cffi_extern_python_start;" and
+                    # "void __cffi_extern_python_stop;"
+                    self._inside_extern_python = decl.name
+                else:
+                    if self._inside_extern_python !='__cffi_extern_python_stop':
+                        raise CDefError(
+                            "cannot declare constants or "
+                            "variables with 'extern \"Python\"'")
+                    if (quals & model.Q_CONST) and not tp.is_array_type:
+                        self._declare('constant ' + decl.name, tp, quals=quals)
+                    else:
+                        _warn_for_non_extern_non_static_global_variable(decl)
+                        self._declare('variable ' + decl.name, tp, quals=quals)
+
+    def parse_type(self, cdecl):
+        return self.parse_type_and_quals(cdecl)[0]
+
+    def parse_type_and_quals(self, cdecl):
+        ast, macros = self._parse('void __dummy(\n%s\n);' % cdecl)[:2]
+        assert not macros
+        exprnode = ast.ext[-1].type.args.params[0]
+        if isinstance(exprnode, pycparser.c_ast.ID):
+            raise CDefError("unknown identifier '%s'" % (exprnode.name,))
+        return self._get_type_and_quals(exprnode.type)
+
+    def _declare(self, name, obj, included=False, quals=0):
+        if name in self._declarations:
+            prevobj, prevquals = self._declarations[name]
+            if prevobj is obj and prevquals == quals:
+                return
+            if not self._options.get('override'):
+                raise FFIError(
+                    "multiple declarations of %s (for interactive usage, "
+                    "try cdef(xx, override=True))" % (name,))
+        assert '__dotdotdot__' not in name.split()
+        self._declarations[name] = (obj, quals)
+        if included:
+            self._included_declarations.add(obj)
+
+    def _extract_quals(self, type):
+        quals = 0
+        if isinstance(type, (pycparser.c_ast.TypeDecl,
+                             pycparser.c_ast.PtrDecl)):
+            if 'const' in type.quals:
+                quals |= model.Q_CONST
+            if 'volatile' in type.quals:
+                quals |= model.Q_VOLATILE
+            if 'restrict' in type.quals:
+                quals |= model.Q_RESTRICT
+        return quals
+
+    def _get_type_pointer(self, type, quals, declname=None):
+        if isinstance(type, model.RawFunctionType):
+            return type.as_function_pointer()
+        if (isinstance(type, model.StructOrUnionOrEnum) and
+                type.name.startswith('$') and type.name[1:].isdigit() and
+                type.forcename is None and declname is not None):
+            return model.NamedPointerType(type, declname, quals)
+        return model.PointerType(type, quals)
+
+    def _get_type_and_quals(self, typenode, name=None, partial_length_ok=False,
+                            typedef_example=None):
+        # first, dereference typedefs, if we have it already parsed, we're good
+        if (isinstance(typenode, pycparser.c_ast.TypeDecl) and
+            isinstance(typenode.type, pycparser.c_ast.IdentifierType) and
+            len(typenode.type.names) == 1 and
+            ('typedef ' + typenode.type.names[0]) in self._declarations):
+            tp, quals = self._declarations['typedef ' + typenode.type.names[0]]
+            quals |= self._extract_quals(typenode)
+            return tp, quals
+        #
+        if isinstance(typenode, pycparser.c_ast.ArrayDecl):
+            # array type
+            if typenode.dim is None:
+                length = None
+            else:
+                length = self._parse_constant(
+                    typenode.dim, partial_length_ok=partial_length_ok)
+            # a hack: in 'typedef int foo_t[...][...];', don't use '...' as
+            # the length but use directly the C expression that would be
+            # generated by recompiler.py.  This lets the typedef be used in
+            # many more places within recompiler.py
+            if typedef_example is not None:
+                if length == '...':
+                    length = '_cffi_array_len(%s)' % (typedef_example,)
+                typedef_example = "*" + typedef_example
+            #
+            tp, quals = self._get_type_and_quals(typenode.type,
+                                partial_length_ok=partial_length_ok,
+                                typedef_example=typedef_example)
+            return model.ArrayType(tp, length), quals
+        #
+        if isinstance(typenode, pycparser.c_ast.PtrDecl):
+            # pointer type
+            itemtype, itemquals = self._get_type_and_quals(typenode.type)
+            tp = self._get_type_pointer(itemtype, itemquals, declname=name)
+            quals = self._extract_quals(typenode)
+            return tp, quals
+        #
+        if isinstance(typenode, pycparser.c_ast.TypeDecl):
+            quals = self._extract_quals(typenode)
+            type = typenode.type
+            if isinstance(type, pycparser.c_ast.IdentifierType):
+                # assume a primitive type.  get it from .names, but reduce
+                # synonyms to a single chosen combination
+                names = list(type.names)
+                if names != ['signed', 'char']:    # keep this unmodified
+                    prefixes = {}
+                    while names:
+                        name = names[0]
+                        if name in ('short', 'long', 'signed', 'unsigned'):
+                            prefixes[name] = prefixes.get(name, 0) + 1
+                            del names[0]
+                        else:
+                            break
+                    # ignore the 'signed' prefix below, and reorder the others
+                    newnames = []
+                    for prefix in ('unsigned', 'short', 'long'):
+                        for i in range(prefixes.get(prefix, 0)):
+                            newnames.append(prefix)
+                    if not names:
+                        names = ['int']    # implicitly
+                    if names == ['int']:   # but kill it if 'short' or 'long'
+                        if 'short' in prefixes or 'long' in prefixes:
+                            names = []
+                    names = newnames + names
+                ident = ' '.join(names)
+                if ident == 'void':
+                    return model.void_type, quals
+                if ident == '__dotdotdot__':
+                    raise FFIError(':%d: bad usage of "..."' %
+                            typenode.coord.line)
+                tp0, quals0 = resolve_common_type(self, ident)
+                return tp0, (quals | quals0)
+            #
+            if isinstance(type, pycparser.c_ast.Struct):
+                # 'struct foobar'
+                tp = self._get_struct_union_enum_type('struct', type, name)
+                return tp, quals
+            #
+            if isinstance(type, pycparser.c_ast.Union):
+                # 'union foobar'
+                tp = self._get_struct_union_enum_type('union', type, name)
+                return tp, quals
+            #
+            if isinstance(type, pycparser.c_ast.Enum):
+                # 'enum foobar'
+                tp = self._get_struct_union_enum_type('enum', type, name)
+                return tp, quals
+        #
+        if isinstance(typenode, pycparser.c_ast.FuncDecl):
+            # a function type
+            return self._parse_function_type(typenode, name), 0
+        #
+        # nested anonymous structs or unions end up here
+        if isinstance(typenode, pycparser.c_ast.Struct):
+            return self._get_struct_union_enum_type('struct', typenode, name,
+                                                    nested=True), 0
+        if isinstance(typenode, pycparser.c_ast.Union):
+            return self._get_struct_union_enum_type('union', typenode, name,
+                                                    nested=True), 0
+        #
+        raise FFIError(":%d: bad or unsupported type declaration" %
+                typenode.coord.line)
+
+    def _parse_function_type(self, typenode, funcname=None):
+        params = list(getattr(typenode.args, 'params', []))
+        for i, arg in enumerate(params):
+            if not hasattr(arg, 'type'):
+                raise CDefError("%s arg %d: unknown type '%s'"
+                    " (if you meant to use the old C syntax of giving"
+                    " untyped arguments, it is not supported)"
+                    % (funcname or 'in expression', i + 1,
+                       getattr(arg, 'name', '?')))
+        ellipsis = (
+            len(params) > 0 and
+            isinstance(params[-1].type, pycparser.c_ast.TypeDecl) and
+            isinstance(params[-1].type.type,
+                       pycparser.c_ast.IdentifierType) and
+            params[-1].type.type.names == ['__dotdotdot__'])
+        if ellipsis:
+            params.pop()
+            if not params:
+                raise CDefError(
+                    "%s: a function with only '(...)' as argument"
+                    " is not correct C" % (funcname or 'in expression'))
+        args = [self._as_func_arg(*self._get_type_and_quals(argdeclnode.type))
+                for argdeclnode in params]
+        if not ellipsis and args == [model.void_type]:
+            args = []
+        result, quals = self._get_type_and_quals(typenode.type)
+        # the 'quals' on the result type are ignored.  HACK: we absure them
+        # to detect __stdcall functions: we textually replace "__stdcall"
+        # with "volatile volatile const" above.
+        abi = None
+        if hasattr(typenode.type, 'quals'): # else, probable syntax error anyway
+            if typenode.type.quals[-3:] == ['volatile', 'volatile', 'const']:
+                abi = '__stdcall'
+        return model.RawFunctionType(tuple(args), result, ellipsis, abi)
+
+    def _as_func_arg(self, type, quals):
+        if isinstance(type, model.ArrayType):
+            return model.PointerType(type.item, quals)
+        elif isinstance(type, model.RawFunctionType):
+            return type.as_function_pointer()
+        else:
+            return type
+
+    def _get_struct_union_enum_type(self, kind, type, name=None, nested=False):
+        # First, a level of caching on the exact 'type' node of the AST.
+        # This is obscure, but needed because pycparser "unrolls" declarations
+        # such as "typedef struct { } foo_t, *foo_p" and we end up with
+        # an AST that is not a tree, but a DAG, with the "type" node of the
+        # two branches foo_t and foo_p of the trees being the same node.
+        # It's a bit silly but detecting "DAG-ness" in the AST tree seems
+        # to be the only way to distinguish this case from two independent
+        # structs.  See test_struct_with_two_usages.
+        try:
+            return self._structnode2type[type]
+        except KeyError:
+            pass
+        #
+        # Note that this must handle parsing "struct foo" any number of
+        # times and always return the same StructType object.  Additionally,
+        # one of these times (not necessarily the first), the fields of
+        # the struct can be specified with "struct foo { ...fields... }".
+        # If no name is given, then we have to create a new anonymous struct
+        # with no caching; in this case, the fields are either specified
+        # right now or never.
+        #
+        force_name = name
+        name = type.name
+        #
+        # get the type or create it if needed
+        if name is None:
+            # 'force_name' is used to guess a more readable name for
+            # anonymous structs, for the common case "typedef struct { } foo".
+            if force_name is not None:
+                explicit_name = '$%s' % force_name
+            else:
+                self._anonymous_counter += 1
+                explicit_name = '$%d' % self._anonymous_counter
+            tp = None
+        else:
+            explicit_name = name
+            key = '%s %s' % (kind, name)
+            tp, _ = self._declarations.get(key, (None, None))
+        #
+        if tp is None:
+            if kind == 'struct':
+                tp = model.StructType(explicit_name, None, None, None)
+            elif kind == 'union':
+                tp = model.UnionType(explicit_name, None, None, None)
+            elif kind == 'enum':
+                if explicit_name == '__dotdotdot__':
+                    raise CDefError("Enums cannot be declared with ...")
+                tp = self._build_enum_type(explicit_name, type.values)
+            else:
+                raise AssertionError("kind = %r" % (kind,))
+            if name is not None:
+                self._declare(key, tp)
+        else:
+            if kind == 'enum' and type.values is not None:
+                raise NotImplementedError(
+                    "enum %s: the '{}' declaration should appear on the first "
+                    "time the enum is mentioned, not later" % explicit_name)
+        if not tp.forcename:
+            tp.force_the_name(force_name)
+        if tp.forcename and '$' in tp.name:
+            self._declare('anonymous %s' % tp.forcename, tp)
+        #
+        self._structnode2type[type] = tp
+        #
+        # enums: done here
+        if kind == 'enum':
+            return tp
+        #
+        # is there a 'type.decls'?  If yes, then this is the place in the
+        # C sources that declare the fields.  If no, then just return the
+        # existing type, possibly still incomplete.
+        if type.decls is None:
+            return tp
+        #
+        if tp.fldnames is not None:
+            raise CDefError("duplicate declaration of struct %s" % name)
+        fldnames = []
+        fldtypes = []
+        fldbitsize = []
+        fldquals = []
+        for decl in type.decls:
+            if (isinstance(decl.type, pycparser.c_ast.IdentifierType) and
+                    ''.join(decl.type.names) == '__dotdotdot__'):
+                # XXX pycparser is inconsistent: 'names' should be a list
+                # of strings, but is sometimes just one string.  Use
+                # str.join() as a way to cope with both.
+                self._make_partial(tp, nested)
+                continue
+            if decl.bitsize is None:
+                bitsize = -1
+            else:
+                bitsize = self._parse_constant(decl.bitsize)
+            self._partial_length = False
+            type, fqual = self._get_type_and_quals(decl.type,
+                                                   partial_length_ok=True)
+            if self._partial_length:
+                self._make_partial(tp, nested)
+            if isinstance(type, model.StructType) and type.partial:
+                self._make_partial(tp, nested)
+            fldnames.append(decl.name or '')
+            fldtypes.append(type)
+            fldbitsize.append(bitsize)
+            fldquals.append(fqual)
+        tp.fldnames = tuple(fldnames)
+        tp.fldtypes = tuple(fldtypes)
+        tp.fldbitsize = tuple(fldbitsize)
+        tp.fldquals = tuple(fldquals)
+        if fldbitsize != [-1] * len(fldbitsize):
+            if isinstance(tp, model.StructType) and tp.partial:
+                raise NotImplementedError("%s: using both bitfields and '...;'"
+                                          % (tp,))
+        tp.packed = self._options.get('packed')
+        if tp.completed:    # must be re-completed: it is not opaque any more
+            tp.completed = 0
+            self._recomplete.append(tp)
+        return tp
+
+    def _make_partial(self, tp, nested):
+        if not isinstance(tp, model.StructOrUnion):
+            raise CDefError("%s cannot be partial" % (tp,))
+        if not tp.has_c_name() and not nested:
+            raise NotImplementedError("%s is partial but has no C name" %(tp,))
+        tp.partial = True
+
+    def _parse_constant(self, exprnode, partial_length_ok=False):
+        # for now, limited to expressions that are an immediate number
+        # or positive/negative number
+        if isinstance(exprnode, pycparser.c_ast.Constant):
+            s = exprnode.value
+            if '0' <= s[0] <= '9':
+                s = s.rstrip('uUlL')
+                try:
+                    if s.startswith('0'):
+                        return int(s, 8)
+                    else:
+                        return int(s, 10)
+                except ValueError:
+                    if len(s) > 1:
+                        if s.lower()[0:2] == '0x':
+                            return int(s, 16)
+                        elif s.lower()[0:2] == '0b':
+                            return int(s, 2)
+                raise CDefError("invalid constant %r" % (s,))
+            elif s[0] == "'" and s[-1] == "'" and (
+                    len(s) == 3 or (len(s) == 4 and s[1] == "\\")):
+                return ord(s[-2])
+            else:
+                raise CDefError("invalid constant %r" % (s,))
+        #
+        if (isinstance(exprnode, pycparser.c_ast.UnaryOp) and
+                exprnode.op == '+'):
+            return self._parse_constant(exprnode.expr)
+        #
+        if (isinstance(exprnode, pycparser.c_ast.UnaryOp) and
+                exprnode.op == '-'):
+            return -self._parse_constant(exprnode.expr)
+        # load previously defined int constant
+        if (isinstance(exprnode, pycparser.c_ast.ID) and
+                exprnode.name in self._int_constants):
+            return self._int_constants[exprnode.name]
+        #
+        if (isinstance(exprnode, pycparser.c_ast.ID) and
+                    exprnode.name == '__dotdotdotarray__'):
+            if partial_length_ok:
+                self._partial_length = True
+                return '...'
+            raise FFIError(":%d: unsupported '[...]' here, cannot derive "
+                           "the actual array length in this context"
+                           % exprnode.coord.line)
+        #
+        if isinstance(exprnode, pycparser.c_ast.BinaryOp):
+            left = self._parse_constant(exprnode.left)
+            right = self._parse_constant(exprnode.right)
+            if exprnode.op == '+':
+                return left + right
+            elif exprnode.op == '-':
+                return left - right
+            elif exprnode.op == '*':
+                return left * right
+            elif exprnode.op == '/':
+                return self._c_div(left, right)
+            elif exprnode.op == '%':
+                return left - self._c_div(left, right) * right
+            elif exprnode.op == '<<':
+                return left << right
+            elif exprnode.op == '>>':
+                return left >> right
+            elif exprnode.op == '&':
+                return left & right
+            elif exprnode.op == '|':
+                return left | right
+            elif exprnode.op == '^':
+                return left ^ right
+        #
+        raise FFIError(":%d: unsupported expression: expected a "
+                       "simple numeric constant" % exprnode.coord.line)
+
+    def _c_div(self, a, b):
+        result = a // b
+        if ((a < 0) ^ (b < 0)) and (a % b) != 0:
+            result += 1
+        return result
+
+    def _build_enum_type(self, explicit_name, decls):
+        if decls is not None:
+            partial = False
+            enumerators = []
+            enumvalues = []
+            nextenumvalue = 0
+            for enum in decls.enumerators:
+                if _r_enum_dotdotdot.match(enum.name):
+                    partial = True
+                    continue
+                if enum.value is not None:
+                    nextenumvalue = self._parse_constant(enum.value)
+                enumerators.append(enum.name)
+                enumvalues.append(nextenumvalue)
+                self._add_constants(enum.name, nextenumvalue)
+                nextenumvalue += 1
+            enumerators = tuple(enumerators)
+            enumvalues = tuple(enumvalues)
+            tp = model.EnumType(explicit_name, enumerators, enumvalues)
+            tp.partial = partial
+        else:   # opaque enum
+            tp = model.EnumType(explicit_name, (), ())
+        return tp
+
+    def include(self, other):
+        for name, (tp, quals) in other._declarations.items():
+            if name.startswith('anonymous $enum_$'):
+                continue   # fix for test_anonymous_enum_include
+            kind = name.split(' ', 1)[0]
+            if kind in ('struct', 'union', 'enum', 'anonymous', 'typedef'):
+                self._declare(name, tp, included=True, quals=quals)
+        for k, v in other._int_constants.items():
+            self._add_constants(k, v)
+
+    def _get_unknown_type(self, decl):
+        typenames = decl.type.type.names
+        if typenames == ['__dotdotdot__']:
+            return model.unknown_type(decl.name)
+
+        if typenames == ['__dotdotdotint__']:
+            if self._uses_new_feature is None:
+                self._uses_new_feature = "'typedef int... %s'" % decl.name
+            return model.UnknownIntegerType(decl.name)
+
+        if typenames == ['__dotdotdotfloat__']:
+            # note: not for 'long double' so far
+            if self._uses_new_feature is None:
+                self._uses_new_feature = "'typedef float... %s'" % decl.name
+            return model.UnknownFloatType(decl.name)
+
+        raise FFIError(':%d: unsupported usage of "..." in typedef'
+                       % decl.coord.line)
+
+    def _get_unknown_ptr_type(self, decl):
+        if decl.type.type.type.names == ['__dotdotdot__']:
+            return model.unknown_ptr_type(decl.name)
+        raise FFIError(':%d: unsupported usage of "..." in typedef'
+                       % decl.coord.line)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/error.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/error.py
new file mode 100644
index 0000000000000000000000000000000000000000..0a27247c32a381ab7cecedd0f985b781619c1ea5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/error.py
@@ -0,0 +1,31 @@
+
+class FFIError(Exception):
+    __module__ = 'cffi'
+
+class CDefError(Exception):
+    __module__ = 'cffi'
+    def __str__(self):
+        try:
+            current_decl = self.args[1]
+            filename = current_decl.coord.file
+            linenum = current_decl.coord.line
+            prefix = '%s:%d: ' % (filename, linenum)
+        except (AttributeError, TypeError, IndexError):
+            prefix = ''
+        return '%s%s' % (prefix, self.args[0])
+
+class VerificationError(Exception):
+    """ An error raised when verification fails
+    """
+    __module__ = 'cffi'
+
+class VerificationMissing(Exception):
+    """ An error raised when incomplete structures are passed into
+    cdef, but no verification has been done
+    """
+    __module__ = 'cffi'
+
+class PkgConfigError(Exception):
+    """ An error raised for missing modules in pkg-config
+    """
+    __module__ = 'cffi'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/ffiplatform.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/ffiplatform.py
new file mode 100644
index 0000000000000000000000000000000000000000..85313460a69477513c8e00f4df430925f2c4ecc9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/ffiplatform.py
@@ -0,0 +1,127 @@
+import sys, os
+from .error import VerificationError
+
+
+LIST_OF_FILE_NAMES = ['sources', 'include_dirs', 'library_dirs',
+                      'extra_objects', 'depends']
+
+def get_extension(srcfilename, modname, sources=(), **kwds):
+    _hack_at_distutils()
+    from distutils.core import Extension
+    allsources = [srcfilename]
+    for src in sources:
+        allsources.append(os.path.normpath(src))
+    return Extension(name=modname, sources=allsources, **kwds)
+
+def compile(tmpdir, ext, compiler_verbose=0, debug=None):
+    """Compile a C extension module using distutils."""
+
+    _hack_at_distutils()
+    saved_environ = os.environ.copy()
+    try:
+        outputfilename = _build(tmpdir, ext, compiler_verbose, debug)
+        outputfilename = os.path.abspath(outputfilename)
+    finally:
+        # workaround for a distutils bugs where some env vars can
+        # become longer and longer every time it is used
+        for key, value in saved_environ.items():
+            if os.environ.get(key) != value:
+                os.environ[key] = value
+    return outputfilename
+
+def _build(tmpdir, ext, compiler_verbose=0, debug=None):
+    # XXX compact but horrible :-(
+    from distutils.core import Distribution
+    import distutils.errors, distutils.log
+    #
+    dist = Distribution({'ext_modules': [ext]})
+    dist.parse_config_files()
+    options = dist.get_option_dict('build_ext')
+    if debug is None:
+        debug = sys.flags.debug
+    options['debug'] = ('ffiplatform', debug)
+    options['force'] = ('ffiplatform', True)
+    options['build_lib'] = ('ffiplatform', tmpdir)
+    options['build_temp'] = ('ffiplatform', tmpdir)
+    #
+    try:
+        old_level = distutils.log.set_threshold(0) or 0
+        try:
+            distutils.log.set_verbosity(compiler_verbose)
+            dist.run_command('build_ext')
+            cmd_obj = dist.get_command_obj('build_ext')
+            [soname] = cmd_obj.get_outputs()
+        finally:
+            distutils.log.set_threshold(old_level)
+    except (distutils.errors.CompileError,
+            distutils.errors.LinkError) as e:
+        raise VerificationError('%s: %s' % (e.__class__.__name__, e))
+    #
+    return soname
+
+try:
+    from os.path import samefile
+except ImportError:
+    def samefile(f1, f2):
+        return os.path.abspath(f1) == os.path.abspath(f2)
+
+def maybe_relative_path(path):
+    if not os.path.isabs(path):
+        return path      # already relative
+    dir = path
+    names = []
+    while True:
+        prevdir = dir
+        dir, name = os.path.split(prevdir)
+        if dir == prevdir or not dir:
+            return path     # failed to make it relative
+        names.append(name)
+        try:
+            if samefile(dir, os.curdir):
+                names.reverse()
+                return os.path.join(*names)
+        except OSError:
+            pass
+
+# ____________________________________________________________
+
+try:
+    int_or_long = (int, long)
+    import cStringIO
+except NameError:
+    int_or_long = int      # Python 3
+    import io as cStringIO
+
+def _flatten(x, f):
+    if isinstance(x, str):
+        f.write('%ds%s' % (len(x), x))
+    elif isinstance(x, dict):
+        keys = sorted(x.keys())
+        f.write('%dd' % len(keys))
+        for key in keys:
+            _flatten(key, f)
+            _flatten(x[key], f)
+    elif isinstance(x, (list, tuple)):
+        f.write('%dl' % len(x))
+        for value in x:
+            _flatten(value, f)
+    elif isinstance(x, int_or_long):
+        f.write('%di' % (x,))
+    else:
+        raise TypeError(
+            "the keywords to verify() contains unsupported object %r" % (x,))
+
+def flatten(x):
+    f = cStringIO.StringIO()
+    _flatten(x, f)
+    return f.getvalue()
+
+def _hack_at_distutils():
+    # Windows-only workaround for some configurations: see
+    # https://bugs.python.org/issue23246 (Python 2.7 with 
+    # a specific MS compiler suite download)
+    if sys.platform == "win32":
+        try:
+            import setuptools    # for side-effects, patches distutils
+        except ImportError:
+            pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/lock.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/lock.py
new file mode 100644
index 0000000000000000000000000000000000000000..db91b7158c4ee9aa653462fe38e79ed1b553db87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/lock.py
@@ -0,0 +1,30 @@
+import sys
+
+if sys.version_info < (3,):
+    try:
+        from thread import allocate_lock
+    except ImportError:
+        from dummy_thread import allocate_lock
+else:
+    try:
+        from _thread import allocate_lock
+    except ImportError:
+        from _dummy_thread import allocate_lock
+
+
+##import sys
+##l1 = allocate_lock
+
+##class allocate_lock(object):
+##    def __init__(self):
+##        self._real = l1()
+##    def __enter__(self):
+##        for i in range(4, 0, -1):
+##            print sys._getframe(i).f_code
+##        print
+##        return self._real.__enter__()
+##    def __exit__(self, *args):
+##        return self._real.__exit__(*args)
+##    def acquire(self, f):
+##        assert f is False
+##        return self._real.acquire(f)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/model.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad1c1764893d0257c0e75eeb61b0a359e89adf0f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/model.py
@@ -0,0 +1,617 @@
+import types
+import weakref
+
+from .lock import allocate_lock
+from .error import CDefError, VerificationError, VerificationMissing
+
+# type qualifiers
+Q_CONST    = 0x01
+Q_RESTRICT = 0x02
+Q_VOLATILE = 0x04
+
+def qualify(quals, replace_with):
+    if quals & Q_CONST:
+        replace_with = ' const ' + replace_with.lstrip()
+    if quals & Q_VOLATILE:
+        replace_with = ' volatile ' + replace_with.lstrip()
+    if quals & Q_RESTRICT:
+        # It seems that __restrict is supported by gcc and msvc.
+        # If you hit some different compiler, add a #define in
+        # _cffi_include.h for it (and in its copies, documented there)
+        replace_with = ' __restrict ' + replace_with.lstrip()
+    return replace_with
+
+
+class BaseTypeByIdentity(object):
+    is_array_type = False
+    is_raw_function = False
+
+    def get_c_name(self, replace_with='', context='a C file', quals=0):
+        result = self.c_name_with_marker
+        assert result.count('&') == 1
+        # some logic duplication with ffi.getctype()... :-(
+        replace_with = replace_with.strip()
+        if replace_with:
+            if replace_with.startswith('*') and '&[' in result:
+                replace_with = '(%s)' % replace_with
+            elif not replace_with[0] in '[(':
+                replace_with = ' ' + replace_with
+        replace_with = qualify(quals, replace_with)
+        result = result.replace('&', replace_with)
+        if '$' in result:
+            raise VerificationError(
+                "cannot generate '%s' in %s: unknown type name"
+                % (self._get_c_name(), context))
+        return result
+
+    def _get_c_name(self):
+        return self.c_name_with_marker.replace('&', '')
+
+    def has_c_name(self):
+        return '$' not in self._get_c_name()
+
+    def is_integer_type(self):
+        return False
+
+    def get_cached_btype(self, ffi, finishlist, can_delay=False):
+        try:
+            BType = ffi._cached_btypes[self]
+        except KeyError:
+            BType = self.build_backend_type(ffi, finishlist)
+            BType2 = ffi._cached_btypes.setdefault(self, BType)
+            assert BType2 is BType
+        return BType
+
+    def __repr__(self):
+        return '<%s>' % (self._get_c_name(),)
+
+    def _get_items(self):
+        return [(name, getattr(self, name)) for name in self._attrs_]
+
+
+class BaseType(BaseTypeByIdentity):
+
+    def __eq__(self, other):
+        return (self.__class__ == other.__class__ and
+                self._get_items() == other._get_items())
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        return hash((self.__class__, tuple(self._get_items())))
+
+
+class VoidType(BaseType):
+    _attrs_ = ()
+
+    def __init__(self):
+        self.c_name_with_marker = 'void&'
+
+    def build_backend_type(self, ffi, finishlist):
+        return global_cache(self, ffi, 'new_void_type')
+
+void_type = VoidType()
+
+
+class BasePrimitiveType(BaseType):
+    def is_complex_type(self):
+        return False
+
+
+class PrimitiveType(BasePrimitiveType):
+    _attrs_ = ('name',)
+
+    ALL_PRIMITIVE_TYPES = {
+        'char':               'c',
+        'short':              'i',
+        'int':                'i',
+        'long':               'i',
+        'long long':          'i',
+        'signed char':        'i',
+        'unsigned char':      'i',
+        'unsigned short':     'i',
+        'unsigned int':       'i',
+        'unsigned long':      'i',
+        'unsigned long long': 'i',
+        'float':              'f',
+        'double':             'f',
+        'long double':        'f',
+        'float _Complex':     'j',
+        'double _Complex':    'j',
+        '_Bool':              'i',
+        # the following types are not primitive in the C sense
+        'wchar_t':            'c',
+        'char16_t':           'c',
+        'char32_t':           'c',
+        'int8_t':             'i',
+        'uint8_t':            'i',
+        'int16_t':            'i',
+        'uint16_t':           'i',
+        'int32_t':            'i',
+        'uint32_t':           'i',
+        'int64_t':            'i',
+        'uint64_t':           'i',
+        'int_least8_t':       'i',
+        'uint_least8_t':      'i',
+        'int_least16_t':      'i',
+        'uint_least16_t':     'i',
+        'int_least32_t':      'i',
+        'uint_least32_t':     'i',
+        'int_least64_t':      'i',
+        'uint_least64_t':     'i',
+        'int_fast8_t':        'i',
+        'uint_fast8_t':       'i',
+        'int_fast16_t':       'i',
+        'uint_fast16_t':      'i',
+        'int_fast32_t':       'i',
+        'uint_fast32_t':      'i',
+        'int_fast64_t':       'i',
+        'uint_fast64_t':      'i',
+        'intptr_t':           'i',
+        'uintptr_t':          'i',
+        'intmax_t':           'i',
+        'uintmax_t':          'i',
+        'ptrdiff_t':          'i',
+        'size_t':             'i',
+        'ssize_t':            'i',
+        }
+
+    def __init__(self, name):
+        assert name in self.ALL_PRIMITIVE_TYPES
+        self.name = name
+        self.c_name_with_marker = name + '&'
+
+    def is_char_type(self):
+        return self.ALL_PRIMITIVE_TYPES[self.name] == 'c'
+    def is_integer_type(self):
+        return self.ALL_PRIMITIVE_TYPES[self.name] == 'i'
+    def is_float_type(self):
+        return self.ALL_PRIMITIVE_TYPES[self.name] == 'f'
+    def is_complex_type(self):
+        return self.ALL_PRIMITIVE_TYPES[self.name] == 'j'
+
+    def build_backend_type(self, ffi, finishlist):
+        return global_cache(self, ffi, 'new_primitive_type', self.name)
+
+
+class UnknownIntegerType(BasePrimitiveType):
+    _attrs_ = ('name',)
+
+    def __init__(self, name):
+        self.name = name
+        self.c_name_with_marker = name + '&'
+
+    def is_integer_type(self):
+        return True
+
+    def build_backend_type(self, ffi, finishlist):
+        raise NotImplementedError("integer type '%s' can only be used after "
+                                  "compilation" % self.name)
+
+class UnknownFloatType(BasePrimitiveType):
+    _attrs_ = ('name', )
+
+    def __init__(self, name):
+        self.name = name
+        self.c_name_with_marker = name + '&'
+
+    def build_backend_type(self, ffi, finishlist):
+        raise NotImplementedError("float type '%s' can only be used after "
+                                  "compilation" % self.name)
+
+
+class BaseFunctionType(BaseType):
+    _attrs_ = ('args', 'result', 'ellipsis', 'abi')
+
+    def __init__(self, args, result, ellipsis, abi=None):
+        self.args = args
+        self.result = result
+        self.ellipsis = ellipsis
+        self.abi = abi
+        #
+        reprargs = [arg._get_c_name() for arg in self.args]
+        if self.ellipsis:
+            reprargs.append('...')
+        reprargs = reprargs or ['void']
+        replace_with = self._base_pattern % (', '.join(reprargs),)
+        if abi is not None:
+            replace_with = replace_with[:1] + abi + ' ' + replace_with[1:]
+        self.c_name_with_marker = (
+            self.result.c_name_with_marker.replace('&', replace_with))
+
+
+class RawFunctionType(BaseFunctionType):
+    # Corresponds to a C type like 'int(int)', which is the C type of
+    # a function, but not a pointer-to-function.  The backend has no
+    # notion of such a type; it's used temporarily by parsing.
+    _base_pattern = '(&)(%s)'
+    is_raw_function = True
+
+    def build_backend_type(self, ffi, finishlist):
+        raise CDefError("cannot render the type %r: it is a function "
+                        "type, not a pointer-to-function type" % (self,))
+
+    def as_function_pointer(self):
+        return FunctionPtrType(self.args, self.result, self.ellipsis, self.abi)
+
+
+class FunctionPtrType(BaseFunctionType):
+    _base_pattern = '(*&)(%s)'
+
+    def build_backend_type(self, ffi, finishlist):
+        result = self.result.get_cached_btype(ffi, finishlist)
+        args = []
+        for tp in self.args:
+            args.append(tp.get_cached_btype(ffi, finishlist))
+        abi_args = ()
+        if self.abi == "__stdcall":
+            if not self.ellipsis:    # __stdcall ignored for variadic funcs
+                try:
+                    abi_args = (ffi._backend.FFI_STDCALL,)
+                except AttributeError:
+                    pass
+        return global_cache(self, ffi, 'new_function_type',
+                            tuple(args), result, self.ellipsis, *abi_args)
+
+    def as_raw_function(self):
+        return RawFunctionType(self.args, self.result, self.ellipsis, self.abi)
+
+
+class PointerType(BaseType):
+    _attrs_ = ('totype', 'quals')
+
+    def __init__(self, totype, quals=0):
+        self.totype = totype
+        self.quals = quals
+        extra = qualify(quals, " *&")
+        if totype.is_array_type:
+            extra = "(%s)" % (extra.lstrip(),)
+        self.c_name_with_marker = totype.c_name_with_marker.replace('&', extra)
+
+    def build_backend_type(self, ffi, finishlist):
+        BItem = self.totype.get_cached_btype(ffi, finishlist, can_delay=True)
+        return global_cache(self, ffi, 'new_pointer_type', BItem)
+
+voidp_type = PointerType(void_type)
+
+def ConstPointerType(totype):
+    return PointerType(totype, Q_CONST)
+
+const_voidp_type = ConstPointerType(void_type)
+
+
+class NamedPointerType(PointerType):
+    _attrs_ = ('totype', 'name')
+
+    def __init__(self, totype, name, quals=0):
+        PointerType.__init__(self, totype, quals)
+        self.name = name
+        self.c_name_with_marker = name + '&'
+
+
+class ArrayType(BaseType):
+    _attrs_ = ('item', 'length')
+    is_array_type = True
+
+    def __init__(self, item, length):
+        self.item = item
+        self.length = length
+        #
+        if length is None:
+            brackets = '&[]'
+        elif length == '...':
+            brackets = '&[/*...*/]'
+        else:
+            brackets = '&[%s]' % length
+        self.c_name_with_marker = (
+            self.item.c_name_with_marker.replace('&', brackets))
+
+    def length_is_unknown(self):
+        return isinstance(self.length, str)
+
+    def resolve_length(self, newlength):
+        return ArrayType(self.item, newlength)
+
+    def build_backend_type(self, ffi, finishlist):
+        if self.length_is_unknown():
+            raise CDefError("cannot render the type %r: unknown length" %
+                            (self,))
+        self.item.get_cached_btype(ffi, finishlist)   # force the item BType
+        BPtrItem = PointerType(self.item).get_cached_btype(ffi, finishlist)
+        return global_cache(self, ffi, 'new_array_type', BPtrItem, self.length)
+
+char_array_type = ArrayType(PrimitiveType('char'), None)
+
+
+class StructOrUnionOrEnum(BaseTypeByIdentity):
+    _attrs_ = ('name',)
+    forcename = None
+
+    def build_c_name_with_marker(self):
+        name = self.forcename or '%s %s' % (self.kind, self.name)
+        self.c_name_with_marker = name + '&'
+
+    def force_the_name(self, forcename):
+        self.forcename = forcename
+        self.build_c_name_with_marker()
+
+    def get_official_name(self):
+        assert self.c_name_with_marker.endswith('&')
+        return self.c_name_with_marker[:-1]
+
+
+class StructOrUnion(StructOrUnionOrEnum):
+    fixedlayout = None
+    completed = 0
+    partial = False
+    packed = 0
+
+    def __init__(self, name, fldnames, fldtypes, fldbitsize, fldquals=None):
+        self.name = name
+        self.fldnames = fldnames
+        self.fldtypes = fldtypes
+        self.fldbitsize = fldbitsize
+        self.fldquals = fldquals
+        self.build_c_name_with_marker()
+
+    def anonymous_struct_fields(self):
+        if self.fldtypes is not None:
+            for name, type in zip(self.fldnames, self.fldtypes):
+                if name == '' and isinstance(type, StructOrUnion):
+                    yield type
+
+    def enumfields(self, expand_anonymous_struct_union=True):
+        fldquals = self.fldquals
+        if fldquals is None:
+            fldquals = (0,) * len(self.fldnames)
+        for name, type, bitsize, quals in zip(self.fldnames, self.fldtypes,
+                                              self.fldbitsize, fldquals):
+            if (name == '' and isinstance(type, StructOrUnion)
+                    and expand_anonymous_struct_union):
+                # nested anonymous struct/union
+                for result in type.enumfields():
+                    yield result
+            else:
+                yield (name, type, bitsize, quals)
+
+    def force_flatten(self):
+        # force the struct or union to have a declaration that lists
+        # directly all fields returned by enumfields(), flattening
+        # nested anonymous structs/unions.
+        names = []
+        types = []
+        bitsizes = []
+        fldquals = []
+        for name, type, bitsize, quals in self.enumfields():
+            names.append(name)
+            types.append(type)
+            bitsizes.append(bitsize)
+            fldquals.append(quals)
+        self.fldnames = tuple(names)
+        self.fldtypes = tuple(types)
+        self.fldbitsize = tuple(bitsizes)
+        self.fldquals = tuple(fldquals)
+
+    def get_cached_btype(self, ffi, finishlist, can_delay=False):
+        BType = StructOrUnionOrEnum.get_cached_btype(self, ffi, finishlist,
+                                                     can_delay)
+        if not can_delay:
+            self.finish_backend_type(ffi, finishlist)
+        return BType
+
+    def finish_backend_type(self, ffi, finishlist):
+        if self.completed:
+            if self.completed != 2:
+                raise NotImplementedError("recursive structure declaration "
+                                          "for '%s'" % (self.name,))
+            return
+        BType = ffi._cached_btypes[self]
+        #
+        self.completed = 1
+        #
+        if self.fldtypes is None:
+            pass    # not completing it: it's an opaque struct
+            #
+        elif self.fixedlayout is None:
+            fldtypes = [tp.get_cached_btype(ffi, finishlist)
+                        for tp in self.fldtypes]
+            lst = list(zip(self.fldnames, fldtypes, self.fldbitsize))
+            extra_flags = ()
+            if self.packed:
+                if self.packed == 1:
+                    extra_flags = (8,)    # SF_PACKED
+                else:
+                    extra_flags = (0, self.packed)
+            ffi._backend.complete_struct_or_union(BType, lst, self,
+                                                  -1, -1, *extra_flags)
+            #
+        else:
+            fldtypes = []
+            fieldofs, fieldsize, totalsize, totalalignment = self.fixedlayout
+            for i in range(len(self.fldnames)):
+                fsize = fieldsize[i]
+                ftype = self.fldtypes[i]
+                #
+                if isinstance(ftype, ArrayType) and ftype.length_is_unknown():
+                    # fix the length to match the total size
+                    BItemType = ftype.item.get_cached_btype(ffi, finishlist)
+                    nlen, nrest = divmod(fsize, ffi.sizeof(BItemType))
+                    if nrest != 0:
+                        self._verification_error(
+                            "field '%s.%s' has a bogus size?" % (
+                            self.name, self.fldnames[i] or '{}'))
+                    ftype = ftype.resolve_length(nlen)
+                    self.fldtypes = (self.fldtypes[:i] + (ftype,) +
+                                     self.fldtypes[i+1:])
+                #
+                BFieldType = ftype.get_cached_btype(ffi, finishlist)
+                if isinstance(ftype, ArrayType) and ftype.length is None:
+                    assert fsize == 0
+                else:
+                    bitemsize = ffi.sizeof(BFieldType)
+                    if bitemsize != fsize:
+                        self._verification_error(
+                            "field '%s.%s' is declared as %d bytes, but is "
+                            "really %d bytes" % (self.name,
+                                                 self.fldnames[i] or '{}',
+                                                 bitemsize, fsize))
+                fldtypes.append(BFieldType)
+            #
+            lst = list(zip(self.fldnames, fldtypes, self.fldbitsize, fieldofs))
+            ffi._backend.complete_struct_or_union(BType, lst, self,
+                                                  totalsize, totalalignment)
+        self.completed = 2
+
+    def _verification_error(self, msg):
+        raise VerificationError(msg)
+
+    def check_not_partial(self):
+        if self.partial and self.fixedlayout is None:
+            raise VerificationMissing(self._get_c_name())
+
+    def build_backend_type(self, ffi, finishlist):
+        self.check_not_partial()
+        finishlist.append(self)
+        #
+        return global_cache(self, ffi, 'new_%s_type' % self.kind,
+                            self.get_official_name(), key=self)
+
+
+class StructType(StructOrUnion):
+    kind = 'struct'
+
+
+class UnionType(StructOrUnion):
+    kind = 'union'
+
+
+class EnumType(StructOrUnionOrEnum):
+    kind = 'enum'
+    partial = False
+    partial_resolved = False
+
+    def __init__(self, name, enumerators, enumvalues, baseinttype=None):
+        self.name = name
+        self.enumerators = enumerators
+        self.enumvalues = enumvalues
+        self.baseinttype = baseinttype
+        self.build_c_name_with_marker()
+
+    def force_the_name(self, forcename):
+        StructOrUnionOrEnum.force_the_name(self, forcename)
+        if self.forcename is None:
+            name = self.get_official_name()
+            self.forcename = '$' + name.replace(' ', '_')
+
+    def check_not_partial(self):
+        if self.partial and not self.partial_resolved:
+            raise VerificationMissing(self._get_c_name())
+
+    def build_backend_type(self, ffi, finishlist):
+        self.check_not_partial()
+        base_btype = self.build_baseinttype(ffi, finishlist)
+        return global_cache(self, ffi, 'new_enum_type',
+                            self.get_official_name(),
+                            self.enumerators, self.enumvalues,
+                            base_btype, key=self)
+
+    def build_baseinttype(self, ffi, finishlist):
+        if self.baseinttype is not None:
+            return self.baseinttype.get_cached_btype(ffi, finishlist)
+        #
+        if self.enumvalues:
+            smallest_value = min(self.enumvalues)
+            largest_value = max(self.enumvalues)
+        else:
+            import warnings
+            try:
+                # XXX!  The goal is to ensure that the warnings.warn()
+                # will not suppress the warning.  We want to get it
+                # several times if we reach this point several times.
+                __warningregistry__.clear()
+            except NameError:
+                pass
+            warnings.warn("%r has no values explicitly defined; "
+                          "guessing that it is equivalent to 'unsigned int'"
+                          % self._get_c_name())
+            smallest_value = largest_value = 0
+        if smallest_value < 0:   # needs a signed type
+            sign = 1
+            candidate1 = PrimitiveType("int")
+            candidate2 = PrimitiveType("long")
+        else:
+            sign = 0
+            candidate1 = PrimitiveType("unsigned int")
+            candidate2 = PrimitiveType("unsigned long")
+        btype1 = candidate1.get_cached_btype(ffi, finishlist)
+        btype2 = candidate2.get_cached_btype(ffi, finishlist)
+        size1 = ffi.sizeof(btype1)
+        size2 = ffi.sizeof(btype2)
+        if (smallest_value >= ((-1) << (8*size1-1)) and
+            largest_value < (1 << (8*size1-sign))):
+            return btype1
+        if (smallest_value >= ((-1) << (8*size2-1)) and
+            largest_value < (1 << (8*size2-sign))):
+            return btype2
+        raise CDefError("%s values don't all fit into either 'long' "
+                        "or 'unsigned long'" % self._get_c_name())
+
+def unknown_type(name, structname=None):
+    if structname is None:
+        structname = '$%s' % name
+    tp = StructType(structname, None, None, None)
+    tp.force_the_name(name)
+    tp.origin = "unknown_type"
+    return tp
+
+def unknown_ptr_type(name, structname=None):
+    if structname is None:
+        structname = '$$%s' % name
+    tp = StructType(structname, None, None, None)
+    return NamedPointerType(tp, name)
+
+
+global_lock = allocate_lock()
+_typecache_cffi_backend = weakref.WeakValueDictionary()
+
+def get_typecache(backend):
+    # returns _typecache_cffi_backend if backend is the _cffi_backend
+    # module, or type(backend).__typecache if backend is an instance of
+    # CTypesBackend (or some FakeBackend class during tests)
+    if isinstance(backend, types.ModuleType):
+        return _typecache_cffi_backend
+    with global_lock:
+        if not hasattr(type(backend), '__typecache'):
+            type(backend).__typecache = weakref.WeakValueDictionary()
+        return type(backend).__typecache
+
+def global_cache(srctype, ffi, funcname, *args, **kwds):
+    key = kwds.pop('key', (funcname, args))
+    assert not kwds
+    try:
+        return ffi._typecache[key]
+    except KeyError:
+        pass
+    try:
+        res = getattr(ffi._backend, funcname)(*args)
+    except NotImplementedError as e:
+        raise NotImplementedError("%s: %r: %s" % (funcname, srctype, e))
+    # note that setdefault() on WeakValueDictionary is not atomic
+    # and contains a rare bug (http://bugs.python.org/issue19542);
+    # we have to use a lock and do it ourselves
+    cache = ffi._typecache
+    with global_lock:
+        res1 = cache.get(key)
+        if res1 is None:
+            cache[key] = res
+            return res
+        else:
+            return res1
+
+def pointer_cache(ffi, BType):
+    return global_cache('?', ffi, 'new_pointer_type', BType)
+
+def attach_exception_info(e, name):
+    if e.args and type(e.args[0]) is str:
+        e.args = ('%s: %s' % (name, e.args[0]),) + e.args[1:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/parse_c_type.h b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/parse_c_type.h
new file mode 100644
index 0000000000000000000000000000000000000000..84e4ef85659eb63e6453d8af9f024f1866182342
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/parse_c_type.h
@@ -0,0 +1,181 @@
+
+/* This part is from file 'cffi/parse_c_type.h'.  It is copied at the
+   beginning of C sources generated by CFFI's ffi.set_source(). */
+
+typedef void *_cffi_opcode_t;
+
+#define _CFFI_OP(opcode, arg)   (_cffi_opcode_t)(opcode | (((uintptr_t)(arg)) << 8))
+#define _CFFI_GETOP(cffi_opcode)    ((unsigned char)(uintptr_t)cffi_opcode)
+#define _CFFI_GETARG(cffi_opcode)   (((intptr_t)cffi_opcode) >> 8)
+
+#define _CFFI_OP_PRIMITIVE       1
+#define _CFFI_OP_POINTER         3
+#define _CFFI_OP_ARRAY           5
+#define _CFFI_OP_OPEN_ARRAY      7
+#define _CFFI_OP_STRUCT_UNION    9
+#define _CFFI_OP_ENUM           11
+#define _CFFI_OP_FUNCTION       13
+#define _CFFI_OP_FUNCTION_END   15
+#define _CFFI_OP_NOOP           17
+#define _CFFI_OP_BITFIELD       19
+#define _CFFI_OP_TYPENAME       21
+#define _CFFI_OP_CPYTHON_BLTN_V 23   // varargs
+#define _CFFI_OP_CPYTHON_BLTN_N 25   // noargs
+#define _CFFI_OP_CPYTHON_BLTN_O 27   // O  (i.e. a single arg)
+#define _CFFI_OP_CONSTANT       29
+#define _CFFI_OP_CONSTANT_INT   31
+#define _CFFI_OP_GLOBAL_VAR     33
+#define _CFFI_OP_DLOPEN_FUNC    35
+#define _CFFI_OP_DLOPEN_CONST   37
+#define _CFFI_OP_GLOBAL_VAR_F   39
+#define _CFFI_OP_EXTERN_PYTHON  41
+
+#define _CFFI_PRIM_VOID          0
+#define _CFFI_PRIM_BOOL          1
+#define _CFFI_PRIM_CHAR          2
+#define _CFFI_PRIM_SCHAR         3
+#define _CFFI_PRIM_UCHAR         4
+#define _CFFI_PRIM_SHORT         5
+#define _CFFI_PRIM_USHORT        6
+#define _CFFI_PRIM_INT           7
+#define _CFFI_PRIM_UINT          8
+#define _CFFI_PRIM_LONG          9
+#define _CFFI_PRIM_ULONG        10
+#define _CFFI_PRIM_LONGLONG     11
+#define _CFFI_PRIM_ULONGLONG    12
+#define _CFFI_PRIM_FLOAT        13
+#define _CFFI_PRIM_DOUBLE       14
+#define _CFFI_PRIM_LONGDOUBLE   15
+
+#define _CFFI_PRIM_WCHAR        16
+#define _CFFI_PRIM_INT8         17
+#define _CFFI_PRIM_UINT8        18
+#define _CFFI_PRIM_INT16        19
+#define _CFFI_PRIM_UINT16       20
+#define _CFFI_PRIM_INT32        21
+#define _CFFI_PRIM_UINT32       22
+#define _CFFI_PRIM_INT64        23
+#define _CFFI_PRIM_UINT64       24
+#define _CFFI_PRIM_INTPTR       25
+#define _CFFI_PRIM_UINTPTR      26
+#define _CFFI_PRIM_PTRDIFF      27
+#define _CFFI_PRIM_SIZE         28
+#define _CFFI_PRIM_SSIZE        29
+#define _CFFI_PRIM_INT_LEAST8   30
+#define _CFFI_PRIM_UINT_LEAST8  31
+#define _CFFI_PRIM_INT_LEAST16  32
+#define _CFFI_PRIM_UINT_LEAST16 33
+#define _CFFI_PRIM_INT_LEAST32  34
+#define _CFFI_PRIM_UINT_LEAST32 35
+#define _CFFI_PRIM_INT_LEAST64  36
+#define _CFFI_PRIM_UINT_LEAST64 37
+#define _CFFI_PRIM_INT_FAST8    38
+#define _CFFI_PRIM_UINT_FAST8   39
+#define _CFFI_PRIM_INT_FAST16   40
+#define _CFFI_PRIM_UINT_FAST16  41
+#define _CFFI_PRIM_INT_FAST32   42
+#define _CFFI_PRIM_UINT_FAST32  43
+#define _CFFI_PRIM_INT_FAST64   44
+#define _CFFI_PRIM_UINT_FAST64  45
+#define _CFFI_PRIM_INTMAX       46
+#define _CFFI_PRIM_UINTMAX      47
+#define _CFFI_PRIM_FLOATCOMPLEX 48
+#define _CFFI_PRIM_DOUBLECOMPLEX 49
+#define _CFFI_PRIM_CHAR16       50
+#define _CFFI_PRIM_CHAR32       51
+
+#define _CFFI__NUM_PRIM         52
+#define _CFFI__UNKNOWN_PRIM           (-1)
+#define _CFFI__UNKNOWN_FLOAT_PRIM     (-2)
+#define _CFFI__UNKNOWN_LONG_DOUBLE    (-3)
+
+#define _CFFI__IO_FILE_STRUCT         (-1)
+
+
+struct _cffi_global_s {
+    const char *name;
+    void *address;
+    _cffi_opcode_t type_op;
+    void *size_or_direct_fn;  // OP_GLOBAL_VAR: size, or 0 if unknown
+                              // OP_CPYTHON_BLTN_*: addr of direct function
+};
+
+struct _cffi_getconst_s {
+    unsigned long long value;
+    const struct _cffi_type_context_s *ctx;
+    int gindex;
+};
+
+struct _cffi_struct_union_s {
+    const char *name;
+    int type_index;          // -> _cffi_types, on a OP_STRUCT_UNION
+    int flags;               // _CFFI_F_* flags below
+    size_t size;
+    int alignment;
+    int first_field_index;   // -> _cffi_fields array
+    int num_fields;
+};
+#define _CFFI_F_UNION         0x01   // is a union, not a struct
+#define _CFFI_F_CHECK_FIELDS  0x02   // complain if fields are not in the
+                                     // "standard layout" or if some are missing
+#define _CFFI_F_PACKED        0x04   // for CHECK_FIELDS, assume a packed struct
+#define _CFFI_F_EXTERNAL      0x08   // in some other ffi.include()
+#define _CFFI_F_OPAQUE        0x10   // opaque
+
+struct _cffi_field_s {
+    const char *name;
+    size_t field_offset;
+    size_t field_size;
+    _cffi_opcode_t field_type_op;
+};
+
+struct _cffi_enum_s {
+    const char *name;
+    int type_index;          // -> _cffi_types, on a OP_ENUM
+    int type_prim;           // _CFFI_PRIM_xxx
+    const char *enumerators; // comma-delimited string
+};
+
+struct _cffi_typename_s {
+    const char *name;
+    int type_index;   /* if opaque, points to a possibly artificial
+                         OP_STRUCT which is itself opaque */
+};
+
+struct _cffi_type_context_s {
+    _cffi_opcode_t *types;
+    const struct _cffi_global_s *globals;
+    const struct _cffi_field_s *fields;
+    const struct _cffi_struct_union_s *struct_unions;
+    const struct _cffi_enum_s *enums;
+    const struct _cffi_typename_s *typenames;
+    int num_globals;
+    int num_struct_unions;
+    int num_enums;
+    int num_typenames;
+    const char *const *includes;
+    int num_types;
+    int flags;      /* future extension */
+};
+
+struct _cffi_parse_info_s {
+    const struct _cffi_type_context_s *ctx;
+    _cffi_opcode_t *output;
+    unsigned int output_size;
+    size_t error_location;
+    const char *error_message;
+};
+
+struct _cffi_externpy_s {
+    const char *name;
+    size_t size_of_result;
+    void *reserved1, *reserved2;
+};
+
+#ifdef _CFFI_INTERNAL
+static int parse_c_type(struct _cffi_parse_info_s *info, const char *input);
+static int search_in_globals(const struct _cffi_type_context_s *ctx,
+                             const char *search, size_t search_len);
+static int search_in_struct_unions(const struct _cffi_type_context_s *ctx,
+                                   const char *search, size_t search_len);
+#endif
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/pkgconfig.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/pkgconfig.py
new file mode 100644
index 0000000000000000000000000000000000000000..5c93f15a60e6f904b2dd108d6e22044a5890bcb4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/pkgconfig.py
@@ -0,0 +1,121 @@
+# pkg-config, https://www.freedesktop.org/wiki/Software/pkg-config/ integration for cffi
+import sys, os, subprocess
+
+from .error import PkgConfigError
+
+
+def merge_flags(cfg1, cfg2):
+    """Merge values from cffi config flags cfg2 to cf1
+
+    Example:
+        merge_flags({"libraries": ["one"]}, {"libraries": ["two"]})
+        {"libraries": ["one", "two"]}
+    """
+    for key, value in cfg2.items():
+        if key not in cfg1:
+            cfg1[key] = value
+        else:
+            if not isinstance(cfg1[key], list):
+                raise TypeError("cfg1[%r] should be a list of strings" % (key,))
+            if not isinstance(value, list):
+                raise TypeError("cfg2[%r] should be a list of strings" % (key,))
+            cfg1[key].extend(value)
+    return cfg1
+
+
+def call(libname, flag, encoding=sys.getfilesystemencoding()):
+    """Calls pkg-config and returns the output if found
+    """
+    a = ["pkg-config", "--print-errors"]
+    a.append(flag)
+    a.append(libname)
+    try:
+        pc = subprocess.Popen(a, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+    except EnvironmentError as e:
+        raise PkgConfigError("cannot run pkg-config: %s" % (str(e).strip(),))
+
+    bout, berr = pc.communicate()
+    if pc.returncode != 0:
+        try:
+            berr = berr.decode(encoding)
+        except Exception:
+            pass
+        raise PkgConfigError(berr.strip())
+
+    if sys.version_info >= (3,) and not isinstance(bout, str):   # Python 3.x
+        try:
+            bout = bout.decode(encoding)
+        except UnicodeDecodeError:
+            raise PkgConfigError("pkg-config %s %s returned bytes that cannot "
+                                 "be decoded with encoding %r:\n%r" %
+                                 (flag, libname, encoding, bout))
+
+    if os.altsep != '\\' and '\\' in bout:
+        raise PkgConfigError("pkg-config %s %s returned an unsupported "
+                             "backslash-escaped output:\n%r" %
+                             (flag, libname, bout))
+    return bout
+
+
+def flags_from_pkgconfig(libs):
+    r"""Return compiler line flags for FFI.set_source based on pkg-config output
+
+    Usage
+        ...
+        ffibuilder.set_source("_foo", pkgconfig = ["libfoo", "libbar >= 1.8.3"])
+
+    If pkg-config is installed on build machine, then arguments include_dirs,
+    library_dirs, libraries, define_macros, extra_compile_args and
+    extra_link_args are extended with an output of pkg-config for libfoo and
+    libbar.
+
+    Raises PkgConfigError in case the pkg-config call fails.
+    """
+
+    def get_include_dirs(string):
+        return [x[2:] for x in string.split() if x.startswith("-I")]
+
+    def get_library_dirs(string):
+        return [x[2:] for x in string.split() if x.startswith("-L")]
+
+    def get_libraries(string):
+        return [x[2:] for x in string.split() if x.startswith("-l")]
+
+    # convert -Dfoo=bar to list of tuples [("foo", "bar")] expected by distutils
+    def get_macros(string):
+        def _macro(x):
+            x = x[2:]    # drop "-D"
+            if '=' in x:
+                return tuple(x.split("=", 1))  # "-Dfoo=bar" => ("foo", "bar")
+            else:
+                return (x, None)               # "-Dfoo" => ("foo", None)
+        return [_macro(x) for x in string.split() if x.startswith("-D")]
+
+    def get_other_cflags(string):
+        return [x for x in string.split() if not x.startswith("-I") and
+                                             not x.startswith("-D")]
+
+    def get_other_libs(string):
+        return [x for x in string.split() if not x.startswith("-L") and
+                                             not x.startswith("-l")]
+
+    # return kwargs for given libname
+    def kwargs(libname):
+        fse = sys.getfilesystemencoding()
+        all_cflags = call(libname, "--cflags")
+        all_libs = call(libname, "--libs")
+        return {
+            "include_dirs": get_include_dirs(all_cflags),
+            "library_dirs": get_library_dirs(all_libs),
+            "libraries": get_libraries(all_libs),
+            "define_macros": get_macros(all_cflags),
+            "extra_compile_args": get_other_cflags(all_cflags),
+            "extra_link_args": get_other_libs(all_libs),
+            }
+
+    # merge all arguments together
+    ret = {}
+    for libname in libs:
+        lib_flags = kwargs(libname)
+        merge_flags(ret, lib_flags)
+    return ret
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/recompiler.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/recompiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..86b37d7ffcb77f62783e2394f6c0c6d3bcbe3f26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/recompiler.py
@@ -0,0 +1,1581 @@
+import os, sys, io
+from . import ffiplatform, model
+from .error import VerificationError
+from .cffi_opcode import *
+
+VERSION_BASE = 0x2601
+VERSION_EMBEDDED = 0x2701
+VERSION_CHAR16CHAR32 = 0x2801
+
+USE_LIMITED_API = (sys.platform != 'win32' or sys.version_info < (3, 0) or
+                   sys.version_info >= (3, 5))
+
+
+class GlobalExpr:
+    def __init__(self, name, address, type_op, size=0, check_value=0):
+        self.name = name
+        self.address = address
+        self.type_op = type_op
+        self.size = size
+        self.check_value = check_value
+
+    def as_c_expr(self):
+        return '  { "%s", (void *)%s, %s, (void *)%s },' % (
+            self.name, self.address, self.type_op.as_c_expr(), self.size)
+
+    def as_python_expr(self):
+        return "b'%s%s',%d" % (self.type_op.as_python_bytes(), self.name,
+                               self.check_value)
+
+class FieldExpr:
+    def __init__(self, name, field_offset, field_size, fbitsize, field_type_op):
+        self.name = name
+        self.field_offset = field_offset
+        self.field_size = field_size
+        self.fbitsize = fbitsize
+        self.field_type_op = field_type_op
+
+    def as_c_expr(self):
+        spaces = " " * len(self.name)
+        return ('  { "%s", %s,\n' % (self.name, self.field_offset) +
+                '     %s   %s,\n' % (spaces, self.field_size) +
+                '     %s   %s },' % (spaces, self.field_type_op.as_c_expr()))
+
+    def as_python_expr(self):
+        raise NotImplementedError
+
+    def as_field_python_expr(self):
+        if self.field_type_op.op == OP_NOOP:
+            size_expr = ''
+        elif self.field_type_op.op == OP_BITFIELD:
+            size_expr = format_four_bytes(self.fbitsize)
+        else:
+            raise NotImplementedError
+        return "b'%s%s%s'" % (self.field_type_op.as_python_bytes(),
+                              size_expr,
+                              self.name)
+
+class StructUnionExpr:
+    def __init__(self, name, type_index, flags, size, alignment, comment,
+                 first_field_index, c_fields):
+        self.name = name
+        self.type_index = type_index
+        self.flags = flags
+        self.size = size
+        self.alignment = alignment
+        self.comment = comment
+        self.first_field_index = first_field_index
+        self.c_fields = c_fields
+
+    def as_c_expr(self):
+        return ('  { "%s", %d, %s,' % (self.name, self.type_index, self.flags)
+                + '\n    %s, %s, ' % (self.size, self.alignment)
+                + '%d, %d ' % (self.first_field_index, len(self.c_fields))
+                + ('/* %s */ ' % self.comment if self.comment else '')
+                + '},')
+
+    def as_python_expr(self):
+        flags = eval(self.flags, G_FLAGS)
+        fields_expr = [c_field.as_field_python_expr()
+                       for c_field in self.c_fields]
+        return "(b'%s%s%s',%s)" % (
+            format_four_bytes(self.type_index),
+            format_four_bytes(flags),
+            self.name,
+            ','.join(fields_expr))
+
+class EnumExpr:
+    def __init__(self, name, type_index, size, signed, allenums):
+        self.name = name
+        self.type_index = type_index
+        self.size = size
+        self.signed = signed
+        self.allenums = allenums
+
+    def as_c_expr(self):
+        return ('  { "%s", %d, _cffi_prim_int(%s, %s),\n'
+                '    "%s" },' % (self.name, self.type_index,
+                                 self.size, self.signed, self.allenums))
+
+    def as_python_expr(self):
+        prim_index = {
+            (1, 0): PRIM_UINT8,  (1, 1):  PRIM_INT8,
+            (2, 0): PRIM_UINT16, (2, 1):  PRIM_INT16,
+            (4, 0): PRIM_UINT32, (4, 1):  PRIM_INT32,
+            (8, 0): PRIM_UINT64, (8, 1):  PRIM_INT64,
+            }[self.size, self.signed]
+        return "b'%s%s%s\\x00%s'" % (format_four_bytes(self.type_index),
+                                     format_four_bytes(prim_index),
+                                     self.name, self.allenums)
+
+class TypenameExpr:
+    def __init__(self, name, type_index):
+        self.name = name
+        self.type_index = type_index
+
+    def as_c_expr(self):
+        return '  { "%s", %d },' % (self.name, self.type_index)
+
+    def as_python_expr(self):
+        return "b'%s%s'" % (format_four_bytes(self.type_index), self.name)
+
+
+# ____________________________________________________________
+
+
+class Recompiler:
+    _num_externpy = 0
+
+    def __init__(self, ffi, module_name, target_is_python=False):
+        self.ffi = ffi
+        self.module_name = module_name
+        self.target_is_python = target_is_python
+        self._version = VERSION_BASE
+
+    def needs_version(self, ver):
+        self._version = max(self._version, ver)
+
+    def collect_type_table(self):
+        self._typesdict = {}
+        self._generate("collecttype")
+        #
+        all_decls = sorted(self._typesdict, key=str)
+        #
+        # prepare all FUNCTION bytecode sequences first
+        self.cffi_types = []
+        for tp in all_decls:
+            if tp.is_raw_function:
+                assert self._typesdict[tp] is None
+                self._typesdict[tp] = len(self.cffi_types)
+                self.cffi_types.append(tp)     # placeholder
+                for tp1 in tp.args:
+                    assert isinstance(tp1, (model.VoidType,
+                                            model.BasePrimitiveType,
+                                            model.PointerType,
+                                            model.StructOrUnionOrEnum,
+                                            model.FunctionPtrType))
+                    if self._typesdict[tp1] is None:
+                        self._typesdict[tp1] = len(self.cffi_types)
+                    self.cffi_types.append(tp1)   # placeholder
+                self.cffi_types.append('END')     # placeholder
+        #
+        # prepare all OTHER bytecode sequences
+        for tp in all_decls:
+            if not tp.is_raw_function and self._typesdict[tp] is None:
+                self._typesdict[tp] = len(self.cffi_types)
+                self.cffi_types.append(tp)        # placeholder
+                if tp.is_array_type and tp.length is not None:
+                    self.cffi_types.append('LEN') # placeholder
+        assert None not in self._typesdict.values()
+        #
+        # collect all structs and unions and enums
+        self._struct_unions = {}
+        self._enums = {}
+        for tp in all_decls:
+            if isinstance(tp, model.StructOrUnion):
+                self._struct_unions[tp] = None
+            elif isinstance(tp, model.EnumType):
+                self._enums[tp] = None
+        for i, tp in enumerate(sorted(self._struct_unions,
+                                      key=lambda tp: tp.name)):
+            self._struct_unions[tp] = i
+        for i, tp in enumerate(sorted(self._enums,
+                                      key=lambda tp: tp.name)):
+            self._enums[tp] = i
+        #
+        # emit all bytecode sequences now
+        for tp in all_decls:
+            method = getattr(self, '_emit_bytecode_' + tp.__class__.__name__)
+            method(tp, self._typesdict[tp])
+        #
+        # consistency check
+        for op in self.cffi_types:
+            assert isinstance(op, CffiOp)
+        self.cffi_types = tuple(self.cffi_types)    # don't change any more
+
+    def _enum_fields(self, tp):
+        # When producing C, expand all anonymous struct/union fields.
+        # That's necessary to have C code checking the offsets of the
+        # individual fields contained in them.  When producing Python,
+        # don't do it and instead write it like it is, with the
+        # corresponding fields having an empty name.  Empty names are
+        # recognized at runtime when we import the generated Python
+        # file.
+        expand_anonymous_struct_union = not self.target_is_python
+        return tp.enumfields(expand_anonymous_struct_union)
+
+    def _do_collect_type(self, tp):
+        if not isinstance(tp, model.BaseTypeByIdentity):
+            if isinstance(tp, tuple):
+                for x in tp:
+                    self._do_collect_type(x)
+            return
+        if tp not in self._typesdict:
+            self._typesdict[tp] = None
+            if isinstance(tp, model.FunctionPtrType):
+                self._do_collect_type(tp.as_raw_function())
+            elif isinstance(tp, model.StructOrUnion):
+                if tp.fldtypes is not None and (
+                        tp not in self.ffi._parser._included_declarations):
+                    for name1, tp1, _, _ in self._enum_fields(tp):
+                        self._do_collect_type(self._field_type(tp, name1, tp1))
+            else:
+                for _, x in tp._get_items():
+                    self._do_collect_type(x)
+
+    def _generate(self, step_name):
+        lst = self.ffi._parser._declarations.items()
+        for name, (tp, quals) in sorted(lst):
+            kind, realname = name.split(' ', 1)
+            try:
+                method = getattr(self, '_generate_cpy_%s_%s' % (kind,
+                                                                step_name))
+            except AttributeError:
+                raise VerificationError(
+                    "not implemented in recompile(): %r" % name)
+            try:
+                self._current_quals = quals
+                method(tp, realname)
+            except Exception as e:
+                model.attach_exception_info(e, name)
+                raise
+
+    # ----------
+
+    ALL_STEPS = ["global", "field", "struct_union", "enum", "typename"]
+
+    def collect_step_tables(self):
+        # collect the declarations for '_cffi_globals', '_cffi_typenames', etc.
+        self._lsts = {}
+        for step_name in self.ALL_STEPS:
+            self._lsts[step_name] = []
+        self._seen_struct_unions = set()
+        self._generate("ctx")
+        self._add_missing_struct_unions()
+        #
+        for step_name in self.ALL_STEPS:
+            lst = self._lsts[step_name]
+            if step_name != "field":
+                lst.sort(key=lambda entry: entry.name)
+            self._lsts[step_name] = tuple(lst)    # don't change any more
+        #
+        # check for a possible internal inconsistency: _cffi_struct_unions
+        # should have been generated with exactly self._struct_unions
+        lst = self._lsts["struct_union"]
+        for tp, i in self._struct_unions.items():
+            assert i < len(lst)
+            assert lst[i].name == tp.name
+        assert len(lst) == len(self._struct_unions)
+        # same with enums
+        lst = self._lsts["enum"]
+        for tp, i in self._enums.items():
+            assert i < len(lst)
+            assert lst[i].name == tp.name
+        assert len(lst) == len(self._enums)
+
+    # ----------
+
+    def _prnt(self, what=''):
+        self._f.write(what + '\n')
+
+    def write_source_to_f(self, f, preamble):
+        if self.target_is_python:
+            assert preamble is None
+            self.write_py_source_to_f(f)
+        else:
+            assert preamble is not None
+            self.write_c_source_to_f(f, preamble)
+
+    def _rel_readlines(self, filename):
+        g = open(os.path.join(os.path.dirname(__file__), filename), 'r')
+        lines = g.readlines()
+        g.close()
+        return lines
+
+    def write_c_source_to_f(self, f, preamble):
+        self._f = f
+        prnt = self._prnt
+        if self.ffi._embedding is not None:
+            prnt('#define _CFFI_USE_EMBEDDING')
+        if not USE_LIMITED_API:
+            prnt('#define _CFFI_NO_LIMITED_API')
+        #
+        # first the '#include' (actually done by inlining the file's content)
+        lines = self._rel_readlines('_cffi_include.h')
+        i = lines.index('#include "parse_c_type.h"\n')
+        lines[i:i+1] = self._rel_readlines('parse_c_type.h')
+        prnt(''.join(lines))
+        #
+        # if we have ffi._embedding != None, we give it here as a macro
+        # and include an extra file
+        base_module_name = self.module_name.split('.')[-1]
+        if self.ffi._embedding is not None:
+            prnt('#define _CFFI_MODULE_NAME  "%s"' % (self.module_name,))
+            prnt('static const char _CFFI_PYTHON_STARTUP_CODE[] = {')
+            self._print_string_literal_in_array(self.ffi._embedding)
+            prnt('0 };')
+            prnt('#ifdef PYPY_VERSION')
+            prnt('# define _CFFI_PYTHON_STARTUP_FUNC  _cffi_pypyinit_%s' % (
+                base_module_name,))
+            prnt('#elif PY_MAJOR_VERSION >= 3')
+            prnt('# define _CFFI_PYTHON_STARTUP_FUNC  PyInit_%s' % (
+                base_module_name,))
+            prnt('#else')
+            prnt('# define _CFFI_PYTHON_STARTUP_FUNC  init%s' % (
+                base_module_name,))
+            prnt('#endif')
+            lines = self._rel_readlines('_embedding.h')
+            i = lines.index('#include "_cffi_errors.h"\n')
+            lines[i:i+1] = self._rel_readlines('_cffi_errors.h')
+            prnt(''.join(lines))
+            self.needs_version(VERSION_EMBEDDED)
+        #
+        # then paste the C source given by the user, verbatim.
+        prnt('/************************************************************/')
+        prnt()
+        prnt(preamble)
+        prnt()
+        prnt('/************************************************************/')
+        prnt()
+        #
+        # the declaration of '_cffi_types'
+        prnt('static void *_cffi_types[] = {')
+        typeindex2type = dict([(i, tp) for (tp, i) in self._typesdict.items()])
+        for i, op in enumerate(self.cffi_types):
+            comment = ''
+            if i in typeindex2type:
+                comment = ' // ' + typeindex2type[i]._get_c_name()
+            prnt('/* %2d */ %s,%s' % (i, op.as_c_expr(), comment))
+        if not self.cffi_types:
+            prnt('  0')
+        prnt('};')
+        prnt()
+        #
+        # call generate_cpy_xxx_decl(), for every xxx found from
+        # ffi._parser._declarations.  This generates all the functions.
+        self._seen_constants = set()
+        self._generate("decl")
+        #
+        # the declaration of '_cffi_globals' and '_cffi_typenames'
+        nums = {}
+        for step_name in self.ALL_STEPS:
+            lst = self._lsts[step_name]
+            nums[step_name] = len(lst)
+            if nums[step_name] > 0:
+                prnt('static const struct _cffi_%s_s _cffi_%ss[] = {' % (
+                    step_name, step_name))
+                for entry in lst:
+                    prnt(entry.as_c_expr())
+                prnt('};')
+                prnt()
+        #
+        # the declaration of '_cffi_includes'
+        if self.ffi._included_ffis:
+            prnt('static const char * const _cffi_includes[] = {')
+            for ffi_to_include in self.ffi._included_ffis:
+                try:
+                    included_module_name, included_source = (
+                        ffi_to_include._assigned_source[:2])
+                except AttributeError:
+                    raise VerificationError(
+                        "ffi object %r includes %r, but the latter has not "
+                        "been prepared with set_source()" % (
+                            self.ffi, ffi_to_include,))
+                if included_source is None:
+                    raise VerificationError(
+                        "not implemented yet: ffi.include() of a Python-based "
+                        "ffi inside a C-based ffi")
+                prnt('  "%s",' % (included_module_name,))
+            prnt('  NULL')
+            prnt('};')
+            prnt()
+        #
+        # the declaration of '_cffi_type_context'
+        prnt('static const struct _cffi_type_context_s _cffi_type_context = {')
+        prnt('  _cffi_types,')
+        for step_name in self.ALL_STEPS:
+            if nums[step_name] > 0:
+                prnt('  _cffi_%ss,' % step_name)
+            else:
+                prnt('  NULL,  /* no %ss */' % step_name)
+        for step_name in self.ALL_STEPS:
+            if step_name != "field":
+                prnt('  %d,  /* num_%ss */' % (nums[step_name], step_name))
+        if self.ffi._included_ffis:
+            prnt('  _cffi_includes,')
+        else:
+            prnt('  NULL,  /* no includes */')
+        prnt('  %d,  /* num_types */' % (len(self.cffi_types),))
+        flags = 0
+        if self._num_externpy:
+            flags |= 1     # set to mean that we use extern "Python"
+        prnt('  %d,  /* flags */' % flags)
+        prnt('};')
+        prnt()
+        #
+        # the init function
+        prnt('#ifdef __GNUC__')
+        prnt('#  pragma GCC visibility push(default)  /* for -fvisibility= */')
+        prnt('#endif')
+        prnt()
+        prnt('#ifdef PYPY_VERSION')
+        prnt('PyMODINIT_FUNC')
+        prnt('_cffi_pypyinit_%s(const void *p[])' % (base_module_name,))
+        prnt('{')
+        if self._num_externpy:
+            prnt('    if (((intptr_t)p[0]) >= 0x0A03) {')
+            prnt('        _cffi_call_python_org = '
+                 '(void(*)(struct _cffi_externpy_s *, char *))p[1];')
+            prnt('    }')
+        prnt('    p[0] = (const void *)0x%x;' % self._version)
+        prnt('    p[1] = &_cffi_type_context;')
+        prnt('#if PY_MAJOR_VERSION >= 3')
+        prnt('    return NULL;')
+        prnt('#endif')
+        prnt('}')
+        # on Windows, distutils insists on putting init_cffi_xyz in
+        # 'export_symbols', so instead of fighting it, just give up and
+        # give it one
+        prnt('#  ifdef _MSC_VER')
+        prnt('     PyMODINIT_FUNC')
+        prnt('#  if PY_MAJOR_VERSION >= 3')
+        prnt('     PyInit_%s(void) { return NULL; }' % (base_module_name,))
+        prnt('#  else')
+        prnt('     init%s(void) { }' % (base_module_name,))
+        prnt('#  endif')
+        prnt('#  endif')
+        prnt('#elif PY_MAJOR_VERSION >= 3')
+        prnt('PyMODINIT_FUNC')
+        prnt('PyInit_%s(void)' % (base_module_name,))
+        prnt('{')
+        prnt('  return _cffi_init("%s", 0x%x, &_cffi_type_context);' % (
+            self.module_name, self._version))
+        prnt('}')
+        prnt('#else')
+        prnt('PyMODINIT_FUNC')
+        prnt('init%s(void)' % (base_module_name,))
+        prnt('{')
+        prnt('  _cffi_init("%s", 0x%x, &_cffi_type_context);' % (
+            self.module_name, self._version))
+        prnt('}')
+        prnt('#endif')
+        prnt()
+        prnt('#ifdef __GNUC__')
+        prnt('#  pragma GCC visibility pop')
+        prnt('#endif')
+        self._version = None
+
+    def _to_py(self, x):
+        if isinstance(x, str):
+            return "b'%s'" % (x,)
+        if isinstance(x, (list, tuple)):
+            rep = [self._to_py(item) for item in x]
+            if len(rep) == 1:
+                rep.append('')
+            return "(%s)" % (','.join(rep),)
+        return x.as_python_expr()  # Py2: unicode unexpected; Py3: bytes unexp.
+
+    def write_py_source_to_f(self, f):
+        self._f = f
+        prnt = self._prnt
+        #
+        # header
+        prnt("# auto-generated file")
+        prnt("import _cffi_backend")
+        #
+        # the 'import' of the included ffis
+        num_includes = len(self.ffi._included_ffis or ())
+        for i in range(num_includes):
+            ffi_to_include = self.ffi._included_ffis[i]
+            try:
+                included_module_name, included_source = (
+                    ffi_to_include._assigned_source[:2])
+            except AttributeError:
+                raise VerificationError(
+                    "ffi object %r includes %r, but the latter has not "
+                    "been prepared with set_source()" % (
+                        self.ffi, ffi_to_include,))
+            if included_source is not None:
+                raise VerificationError(
+                    "not implemented yet: ffi.include() of a C-based "
+                    "ffi inside a Python-based ffi")
+            prnt('from %s import ffi as _ffi%d' % (included_module_name, i))
+        prnt()
+        prnt("ffi = _cffi_backend.FFI('%s'," % (self.module_name,))
+        prnt("    _version = 0x%x," % (self._version,))
+        self._version = None
+        #
+        # the '_types' keyword argument
+        self.cffi_types = tuple(self.cffi_types)    # don't change any more
+        types_lst = [op.as_python_bytes() for op in self.cffi_types]
+        prnt('    _types = %s,' % (self._to_py(''.join(types_lst)),))
+        typeindex2type = dict([(i, tp) for (tp, i) in self._typesdict.items()])
+        #
+        # the keyword arguments from ALL_STEPS
+        for step_name in self.ALL_STEPS:
+            lst = self._lsts[step_name]
+            if len(lst) > 0 and step_name != "field":
+                prnt('    _%ss = %s,' % (step_name, self._to_py(lst)))
+        #
+        # the '_includes' keyword argument
+        if num_includes > 0:
+            prnt('    _includes = (%s,),' % (
+                ', '.join(['_ffi%d' % i for i in range(num_includes)]),))
+        #
+        # the footer
+        prnt(')')
+
+    # ----------
+
+    def _gettypenum(self, type):
+        # a KeyError here is a bug.  please report it! :-)
+        return self._typesdict[type]
+
+    def _convert_funcarg_to_c(self, tp, fromvar, tovar, errcode):
+        extraarg = ''
+        if isinstance(tp, model.BasePrimitiveType) and not tp.is_complex_type():
+            if tp.is_integer_type() and tp.name != '_Bool':
+                converter = '_cffi_to_c_int'
+                extraarg = ', %s' % tp.name
+            elif isinstance(tp, model.UnknownFloatType):
+                # don't check with is_float_type(): it may be a 'long
+                # double' here, and _cffi_to_c_double would loose precision
+                converter = '(%s)_cffi_to_c_double' % (tp.get_c_name(''),)
+            else:
+                cname = tp.get_c_name('')
+                converter = '(%s)_cffi_to_c_%s' % (cname,
+                                                   tp.name.replace(' ', '_'))
+                if cname in ('char16_t', 'char32_t'):
+                    self.needs_version(VERSION_CHAR16CHAR32)
+            errvalue = '-1'
+        #
+        elif isinstance(tp, model.PointerType):
+            self._convert_funcarg_to_c_ptr_or_array(tp, fromvar,
+                                                    tovar, errcode)
+            return
+        #
+        elif (isinstance(tp, model.StructOrUnionOrEnum) or
+              isinstance(tp, model.BasePrimitiveType)):
+            # a struct (not a struct pointer) as a function argument;
+            # or, a complex (the same code works)
+            self._prnt('  if (_cffi_to_c((char *)&%s, _cffi_type(%d), %s) < 0)'
+                      % (tovar, self._gettypenum(tp), fromvar))
+            self._prnt('    %s;' % errcode)
+            return
+        #
+        elif isinstance(tp, model.FunctionPtrType):
+            converter = '(%s)_cffi_to_c_pointer' % tp.get_c_name('')
+            extraarg = ', _cffi_type(%d)' % self._gettypenum(tp)
+            errvalue = 'NULL'
+        #
+        else:
+            raise NotImplementedError(tp)
+        #
+        self._prnt('  %s = %s(%s%s);' % (tovar, converter, fromvar, extraarg))
+        self._prnt('  if (%s == (%s)%s && PyErr_Occurred())' % (
+            tovar, tp.get_c_name(''), errvalue))
+        self._prnt('    %s;' % errcode)
+
+    def _extra_local_variables(self, tp, localvars, freelines):
+        if isinstance(tp, model.PointerType):
+            localvars.add('Py_ssize_t datasize')
+            localvars.add('struct _cffi_freeme_s *large_args_free = NULL')
+            freelines.add('if (large_args_free != NULL)'
+                          ' _cffi_free_array_arguments(large_args_free);')
+
+    def _convert_funcarg_to_c_ptr_or_array(self, tp, fromvar, tovar, errcode):
+        self._prnt('  datasize = _cffi_prepare_pointer_call_argument(')
+        self._prnt('      _cffi_type(%d), %s, (char **)&%s);' % (
+            self._gettypenum(tp), fromvar, tovar))
+        self._prnt('  if (datasize != 0) {')
+        self._prnt('    %s = ((size_t)datasize) <= 640 ? '
+                   '(%s)alloca((size_t)datasize) : NULL;' % (
+            tovar, tp.get_c_name('')))
+        self._prnt('    if (_cffi_convert_array_argument(_cffi_type(%d), %s, '
+                   '(char **)&%s,' % (self._gettypenum(tp), fromvar, tovar))
+        self._prnt('            datasize, &large_args_free) < 0)')
+        self._prnt('      %s;' % errcode)
+        self._prnt('  }')
+
+    def _convert_expr_from_c(self, tp, var, context):
+        if isinstance(tp, model.BasePrimitiveType):
+            if tp.is_integer_type() and tp.name != '_Bool':
+                return '_cffi_from_c_int(%s, %s)' % (var, tp.name)
+            elif isinstance(tp, model.UnknownFloatType):
+                return '_cffi_from_c_double(%s)' % (var,)
+            elif tp.name != 'long double' and not tp.is_complex_type():
+                cname = tp.name.replace(' ', '_')
+                if cname in ('char16_t', 'char32_t'):
+                    self.needs_version(VERSION_CHAR16CHAR32)
+                return '_cffi_from_c_%s(%s)' % (cname, var)
+            else:
+                return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (
+                    var, self._gettypenum(tp))
+        elif isinstance(tp, (model.PointerType, model.FunctionPtrType)):
+            return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        elif isinstance(tp, model.ArrayType):
+            return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (
+                var, self._gettypenum(model.PointerType(tp.item)))
+        elif isinstance(tp, model.StructOrUnion):
+            if tp.fldnames is None:
+                raise TypeError("'%s' is used as %s, but is opaque" % (
+                    tp._get_c_name(), context))
+            return '_cffi_from_c_struct((char *)&%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        elif isinstance(tp, model.EnumType):
+            return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        else:
+            raise NotImplementedError(tp)
+
+    # ----------
+    # typedefs
+
+    def _typedef_type(self, tp, name):
+        return self._global_type(tp, "(*(%s *)0)" % (name,))
+
+    def _generate_cpy_typedef_collecttype(self, tp, name):
+        self._do_collect_type(self._typedef_type(tp, name))
+
+    def _generate_cpy_typedef_decl(self, tp, name):
+        pass
+
+    def _typedef_ctx(self, tp, name):
+        type_index = self._typesdict[tp]
+        self._lsts["typename"].append(TypenameExpr(name, type_index))
+
+    def _generate_cpy_typedef_ctx(self, tp, name):
+        tp = self._typedef_type(tp, name)
+        self._typedef_ctx(tp, name)
+        if getattr(tp, "origin", None) == "unknown_type":
+            self._struct_ctx(tp, tp.name, approxname=None)
+        elif isinstance(tp, model.NamedPointerType):
+            self._struct_ctx(tp.totype, tp.totype.name, approxname=tp.name,
+                             named_ptr=tp)
+
+    # ----------
+    # function declarations
+
+    def _generate_cpy_function_collecttype(self, tp, name):
+        self._do_collect_type(tp.as_raw_function())
+        if tp.ellipsis and not self.target_is_python:
+            self._do_collect_type(tp)
+
+    def _generate_cpy_function_decl(self, tp, name):
+        assert not self.target_is_python
+        assert isinstance(tp, model.FunctionPtrType)
+        if tp.ellipsis:
+            # cannot support vararg functions better than this: check for its
+            # exact type (including the fixed arguments), and build it as a
+            # constant function pointer (no CPython wrapper)
+            self._generate_cpy_constant_decl(tp, name)
+            return
+        prnt = self._prnt
+        numargs = len(tp.args)
+        if numargs == 0:
+            argname = 'noarg'
+        elif numargs == 1:
+            argname = 'arg0'
+        else:
+            argname = 'args'
+        #
+        # ------------------------------
+        # the 'd' version of the function, only for addressof(lib, 'func')
+        arguments = []
+        call_arguments = []
+        context = 'argument of %s' % name
+        for i, type in enumerate(tp.args):
+            arguments.append(type.get_c_name(' x%d' % i, context))
+            call_arguments.append('x%d' % i)
+        repr_arguments = ', '.join(arguments)
+        repr_arguments = repr_arguments or 'void'
+        if tp.abi:
+            abi = tp.abi + ' '
+        else:
+            abi = ''
+        name_and_arguments = '%s_cffi_d_%s(%s)' % (abi, name, repr_arguments)
+        prnt('static %s' % (tp.result.get_c_name(name_and_arguments),))
+        prnt('{')
+        call_arguments = ', '.join(call_arguments)
+        result_code = 'return '
+        if isinstance(tp.result, model.VoidType):
+            result_code = ''
+        prnt('  %s%s(%s);' % (result_code, name, call_arguments))
+        prnt('}')
+        #
+        prnt('#ifndef PYPY_VERSION')        # ------------------------------
+        #
+        prnt('static PyObject *')
+        prnt('_cffi_f_%s(PyObject *self, PyObject *%s)' % (name, argname))
+        prnt('{')
+        #
+        context = 'argument of %s' % name
+        for i, type in enumerate(tp.args):
+            arg = type.get_c_name(' x%d' % i, context)
+            prnt('  %s;' % arg)
+        #
+        localvars = set()
+        freelines = set()
+        for type in tp.args:
+            self._extra_local_variables(type, localvars, freelines)
+        for decl in sorted(localvars):
+            prnt('  %s;' % (decl,))
+        #
+        if not isinstance(tp.result, model.VoidType):
+            result_code = 'result = '
+            context = 'result of %s' % name
+            result_decl = '  %s;' % tp.result.get_c_name(' result', context)
+            prnt(result_decl)
+            prnt('  PyObject *pyresult;')
+        else:
+            result_decl = None
+            result_code = ''
+        #
+        if len(tp.args) > 1:
+            rng = range(len(tp.args))
+            for i in rng:
+                prnt('  PyObject *arg%d;' % i)
+            prnt()
+            prnt('  if (!PyArg_UnpackTuple(args, "%s", %d, %d, %s))' % (
+                name, len(rng), len(rng),
+                ', '.join(['&arg%d' % i for i in rng])))
+            prnt('    return NULL;')
+        prnt()
+        #
+        for i, type in enumerate(tp.args):
+            self._convert_funcarg_to_c(type, 'arg%d' % i, 'x%d' % i,
+                                       'return NULL')
+            prnt()
+        #
+        prnt('  Py_BEGIN_ALLOW_THREADS')
+        prnt('  _cffi_restore_errno();')
+        call_arguments = ['x%d' % i for i in range(len(tp.args))]
+        call_arguments = ', '.join(call_arguments)
+        prnt('  { %s%s(%s); }' % (result_code, name, call_arguments))
+        prnt('  _cffi_save_errno();')
+        prnt('  Py_END_ALLOW_THREADS')
+        prnt()
+        #
+        prnt('  (void)self; /* unused */')
+        if numargs == 0:
+            prnt('  (void)noarg; /* unused */')
+        if result_code:
+            prnt('  pyresult = %s;' %
+                 self._convert_expr_from_c(tp.result, 'result', 'result type'))
+            for freeline in freelines:
+                prnt('  ' + freeline)
+            prnt('  return pyresult;')
+        else:
+            for freeline in freelines:
+                prnt('  ' + freeline)
+            prnt('  Py_INCREF(Py_None);')
+            prnt('  return Py_None;')
+        prnt('}')
+        #
+        prnt('#else')        # ------------------------------
+        #
+        # the PyPy version: need to replace struct/union arguments with
+        # pointers, and if the result is a struct/union, insert a first
+        # arg that is a pointer to the result.  We also do that for
+        # complex args and return type.
+        def need_indirection(type):
+            return (isinstance(type, model.StructOrUnion) or
+                    (isinstance(type, model.PrimitiveType) and
+                     type.is_complex_type()))
+        difference = False
+        arguments = []
+        call_arguments = []
+        context = 'argument of %s' % name
+        for i, type in enumerate(tp.args):
+            indirection = ''
+            if need_indirection(type):
+                indirection = '*'
+                difference = True
+            arg = type.get_c_name(' %sx%d' % (indirection, i), context)
+            arguments.append(arg)
+            call_arguments.append('%sx%d' % (indirection, i))
+        tp_result = tp.result
+        if need_indirection(tp_result):
+            context = 'result of %s' % name
+            arg = tp_result.get_c_name(' *result', context)
+            arguments.insert(0, arg)
+            tp_result = model.void_type
+            result_decl = None
+            result_code = '*result = '
+            difference = True
+        if difference:
+            repr_arguments = ', '.join(arguments)
+            repr_arguments = repr_arguments or 'void'
+            name_and_arguments = '%s_cffi_f_%s(%s)' % (abi, name,
+                                                       repr_arguments)
+            prnt('static %s' % (tp_result.get_c_name(name_and_arguments),))
+            prnt('{')
+            if result_decl:
+                prnt(result_decl)
+            call_arguments = ', '.join(call_arguments)
+            prnt('  { %s%s(%s); }' % (result_code, name, call_arguments))
+            if result_decl:
+                prnt('  return result;')
+            prnt('}')
+        else:
+            prnt('#  define _cffi_f_%s _cffi_d_%s' % (name, name))
+        #
+        prnt('#endif')        # ------------------------------
+        prnt()
+
+    def _generate_cpy_function_ctx(self, tp, name):
+        if tp.ellipsis and not self.target_is_python:
+            self._generate_cpy_constant_ctx(tp, name)
+            return
+        type_index = self._typesdict[tp.as_raw_function()]
+        numargs = len(tp.args)
+        if self.target_is_python:
+            meth_kind = OP_DLOPEN_FUNC
+        elif numargs == 0:
+            meth_kind = OP_CPYTHON_BLTN_N   # 'METH_NOARGS'
+        elif numargs == 1:
+            meth_kind = OP_CPYTHON_BLTN_O   # 'METH_O'
+        else:
+            meth_kind = OP_CPYTHON_BLTN_V   # 'METH_VARARGS'
+        self._lsts["global"].append(
+            GlobalExpr(name, '_cffi_f_%s' % name,
+                       CffiOp(meth_kind, type_index),
+                       size='_cffi_d_%s' % name))
+
+    # ----------
+    # named structs or unions
+
+    def _field_type(self, tp_struct, field_name, tp_field):
+        if isinstance(tp_field, model.ArrayType):
+            actual_length = tp_field.length
+            if actual_length == '...':
+                ptr_struct_name = tp_struct.get_c_name('*')
+                actual_length = '_cffi_array_len(((%s)0)->%s)' % (
+                    ptr_struct_name, field_name)
+            tp_item = self._field_type(tp_struct, '%s[0]' % field_name,
+                                       tp_field.item)
+            tp_field = model.ArrayType(tp_item, actual_length)
+        return tp_field
+
+    def _struct_collecttype(self, tp):
+        self._do_collect_type(tp)
+        if self.target_is_python:
+            # also requires nested anon struct/unions in ABI mode, recursively
+            for fldtype in tp.anonymous_struct_fields():
+                self._struct_collecttype(fldtype)
+
+    def _struct_decl(self, tp, cname, approxname):
+        if tp.fldtypes is None:
+            return
+        prnt = self._prnt
+        checkfuncname = '_cffi_checkfld_%s' % (approxname,)
+        prnt('_CFFI_UNUSED_FN')
+        prnt('static void %s(%s *p)' % (checkfuncname, cname))
+        prnt('{')
+        prnt('  /* only to generate compile-time warnings or errors */')
+        prnt('  (void)p;')
+        for fname, ftype, fbitsize, fqual in self._enum_fields(tp):
+            try:
+                if ftype.is_integer_type() or fbitsize >= 0:
+                    # accept all integers, but complain on float or double
+                    if fname != '':
+                        prnt("  (void)((p->%s) | 0);  /* check that '%s.%s' is "
+                             "an integer */" % (fname, cname, fname))
+                    continue
+                # only accept exactly the type declared, except that '[]'
+                # is interpreted as a '*' and so will match any array length.
+                # (It would also match '*', but that's harder to detect...)
+                while (isinstance(ftype, model.ArrayType)
+                       and (ftype.length is None or ftype.length == '...')):
+                    ftype = ftype.item
+                    fname = fname + '[0]'
+                prnt('  { %s = &p->%s; (void)tmp; }' % (
+                    ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),
+                    fname))
+            except VerificationError as e:
+                prnt('  /* %s */' % str(e))   # cannot verify it, ignore
+        prnt('}')
+        prnt('struct _cffi_align_%s { char x; %s y; };' % (approxname, cname))
+        prnt()
+
+    def _struct_ctx(self, tp, cname, approxname, named_ptr=None):
+        type_index = self._typesdict[tp]
+        reason_for_not_expanding = None
+        flags = []
+        if isinstance(tp, model.UnionType):
+            flags.append("_CFFI_F_UNION")
+        if tp.fldtypes is None:
+            flags.append("_CFFI_F_OPAQUE")
+            reason_for_not_expanding = "opaque"
+        if (tp not in self.ffi._parser._included_declarations and
+                (named_ptr is None or
+                 named_ptr not in self.ffi._parser._included_declarations)):
+            if tp.fldtypes is None:
+                pass    # opaque
+            elif tp.partial or any(tp.anonymous_struct_fields()):
+                pass    # field layout obtained silently from the C compiler
+            else:
+                flags.append("_CFFI_F_CHECK_FIELDS")
+            if tp.packed:
+                if tp.packed > 1:
+                    raise NotImplementedError(
+                        "%r is declared with 'pack=%r'; only 0 or 1 are "
+                        "supported in API mode (try to use \"...;\", which "
+                        "does not require a 'pack' declaration)" %
+                        (tp, tp.packed))
+                flags.append("_CFFI_F_PACKED")
+        else:
+            flags.append("_CFFI_F_EXTERNAL")
+            reason_for_not_expanding = "external"
+        flags = '|'.join(flags) or '0'
+        c_fields = []
+        if reason_for_not_expanding is None:
+            enumfields = list(self._enum_fields(tp))
+            for fldname, fldtype, fbitsize, fqual in enumfields:
+                fldtype = self._field_type(tp, fldname, fldtype)
+                self._check_not_opaque(fldtype,
+                                       "field '%s.%s'" % (tp.name, fldname))
+                # cname is None for _add_missing_struct_unions() only
+                op = OP_NOOP
+                if fbitsize >= 0:
+                    op = OP_BITFIELD
+                    size = '%d /* bits */' % fbitsize
+                elif cname is None or (
+                        isinstance(fldtype, model.ArrayType) and
+                        fldtype.length is None):
+                    size = '(size_t)-1'
+                else:
+                    size = 'sizeof(((%s)0)->%s)' % (
+                        tp.get_c_name('*') if named_ptr is None
+                                           else named_ptr.name,
+                        fldname)
+                if cname is None or fbitsize >= 0:
+                    offset = '(size_t)-1'
+                elif named_ptr is not None:
+                    offset = '((char *)&((%s)0)->%s) - (char *)0' % (
+                        named_ptr.name, fldname)
+                else:
+                    offset = 'offsetof(%s, %s)' % (tp.get_c_name(''), fldname)
+                c_fields.append(
+                    FieldExpr(fldname, offset, size, fbitsize,
+                              CffiOp(op, self._typesdict[fldtype])))
+            first_field_index = len(self._lsts["field"])
+            self._lsts["field"].extend(c_fields)
+            #
+            if cname is None:  # unknown name, for _add_missing_struct_unions
+                size = '(size_t)-2'
+                align = -2
+                comment = "unnamed"
+            else:
+                if named_ptr is not None:
+                    size = 'sizeof(*(%s)0)' % (named_ptr.name,)
+                    align = '-1 /* unknown alignment */'
+                else:
+                    size = 'sizeof(%s)' % (cname,)
+                    align = 'offsetof(struct _cffi_align_%s, y)' % (approxname,)
+                comment = None
+        else:
+            size = '(size_t)-1'
+            align = -1
+            first_field_index = -1
+            comment = reason_for_not_expanding
+        self._lsts["struct_union"].append(
+            StructUnionExpr(tp.name, type_index, flags, size, align, comment,
+                            first_field_index, c_fields))
+        self._seen_struct_unions.add(tp)
+
+    def _check_not_opaque(self, tp, location):
+        while isinstance(tp, model.ArrayType):
+            tp = tp.item
+        if isinstance(tp, model.StructOrUnion) and tp.fldtypes is None:
+            raise TypeError(
+                "%s is of an opaque type (not declared in cdef())" % location)
+
+    def _add_missing_struct_unions(self):
+        # not very nice, but some struct declarations might be missing
+        # because they don't have any known C name.  Check that they are
+        # not partial (we can't complete or verify them!) and emit them
+        # anonymously.
+        lst = list(self._struct_unions.items())
+        lst.sort(key=lambda tp_order: tp_order[1])
+        for tp, order in lst:
+            if tp not in self._seen_struct_unions:
+                if tp.partial:
+                    raise NotImplementedError("internal inconsistency: %r is "
+                                              "partial but was not seen at "
+                                              "this point" % (tp,))
+                if tp.name.startswith('$') and tp.name[1:].isdigit():
+                    approxname = tp.name[1:]
+                elif tp.name == '_IO_FILE' and tp.forcename == 'FILE':
+                    approxname = 'FILE'
+                    self._typedef_ctx(tp, 'FILE')
+                else:
+                    raise NotImplementedError("internal inconsistency: %r" %
+                                              (tp,))
+                self._struct_ctx(tp, None, approxname)
+
+    def _generate_cpy_struct_collecttype(self, tp, name):
+        self._struct_collecttype(tp)
+    _generate_cpy_union_collecttype = _generate_cpy_struct_collecttype
+
+    def _struct_names(self, tp):
+        cname = tp.get_c_name('')
+        if ' ' in cname:
+            return cname, cname.replace(' ', '_')
+        else:
+            return cname, '_' + cname
+
+    def _generate_cpy_struct_decl(self, tp, name):
+        self._struct_decl(tp, *self._struct_names(tp))
+    _generate_cpy_union_decl = _generate_cpy_struct_decl
+
+    def _generate_cpy_struct_ctx(self, tp, name):
+        self._struct_ctx(tp, *self._struct_names(tp))
+    _generate_cpy_union_ctx = _generate_cpy_struct_ctx
+
+    # ----------
+    # 'anonymous' declarations.  These are produced for anonymous structs
+    # or unions; the 'name' is obtained by a typedef.
+
+    def _generate_cpy_anonymous_collecttype(self, tp, name):
+        if isinstance(tp, model.EnumType):
+            self._generate_cpy_enum_collecttype(tp, name)
+        else:
+            self._struct_collecttype(tp)
+
+    def _generate_cpy_anonymous_decl(self, tp, name):
+        if isinstance(tp, model.EnumType):
+            self._generate_cpy_enum_decl(tp)
+        else:
+            self._struct_decl(tp, name, 'typedef_' + name)
+
+    def _generate_cpy_anonymous_ctx(self, tp, name):
+        if isinstance(tp, model.EnumType):
+            self._enum_ctx(tp, name)
+        else:
+            self._struct_ctx(tp, name, 'typedef_' + name)
+
+    # ----------
+    # constants, declared with "static const ..."
+
+    def _generate_cpy_const(self, is_int, name, tp=None, category='const',
+                            check_value=None):
+        if (category, name) in self._seen_constants:
+            raise VerificationError(
+                "duplicate declaration of %s '%s'" % (category, name))
+        self._seen_constants.add((category, name))
+        #
+        prnt = self._prnt
+        funcname = '_cffi_%s_%s' % (category, name)
+        if is_int:
+            prnt('static int %s(unsigned long long *o)' % funcname)
+            prnt('{')
+            prnt('  int n = (%s) <= 0;' % (name,))
+            prnt('  *o = (unsigned long long)((%s) | 0);'
+                 '  /* check that %s is an integer */' % (name, name))
+            if check_value is not None:
+                if check_value > 0:
+                    check_value = '%dU' % (check_value,)
+                prnt('  if (!_cffi_check_int(*o, n, %s))' % (check_value,))
+                prnt('    n |= 2;')
+            prnt('  return n;')
+            prnt('}')
+        else:
+            assert check_value is None
+            prnt('static void %s(char *o)' % funcname)
+            prnt('{')
+            prnt('  *(%s)o = %s;' % (tp.get_c_name('*'), name))
+            prnt('}')
+        prnt()
+
+    def _generate_cpy_constant_collecttype(self, tp, name):
+        is_int = tp.is_integer_type()
+        if not is_int or self.target_is_python:
+            self._do_collect_type(tp)
+
+    def _generate_cpy_constant_decl(self, tp, name):
+        is_int = tp.is_integer_type()
+        self._generate_cpy_const(is_int, name, tp)
+
+    def _generate_cpy_constant_ctx(self, tp, name):
+        if not self.target_is_python and tp.is_integer_type():
+            type_op = CffiOp(OP_CONSTANT_INT, -1)
+        else:
+            if self.target_is_python:
+                const_kind = OP_DLOPEN_CONST
+            else:
+                const_kind = OP_CONSTANT
+            type_index = self._typesdict[tp]
+            type_op = CffiOp(const_kind, type_index)
+        self._lsts["global"].append(
+            GlobalExpr(name, '_cffi_const_%s' % name, type_op))
+
+    # ----------
+    # enums
+
+    def _generate_cpy_enum_collecttype(self, tp, name):
+        self._do_collect_type(tp)
+
+    def _generate_cpy_enum_decl(self, tp, name=None):
+        for enumerator in tp.enumerators:
+            self._generate_cpy_const(True, enumerator)
+
+    def _enum_ctx(self, tp, cname):
+        type_index = self._typesdict[tp]
+        type_op = CffiOp(OP_ENUM, -1)
+        if self.target_is_python:
+            tp.check_not_partial()
+        for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):
+            self._lsts["global"].append(
+                GlobalExpr(enumerator, '_cffi_const_%s' % enumerator, type_op,
+                           check_value=enumvalue))
+        #
+        if cname is not None and '$' not in cname and not self.target_is_python:
+            size = "sizeof(%s)" % cname
+            signed = "((%s)-1) <= 0" % cname
+        else:
+            basetp = tp.build_baseinttype(self.ffi, [])
+            size = self.ffi.sizeof(basetp)
+            signed = int(int(self.ffi.cast(basetp, -1)) < 0)
+        allenums = ",".join(tp.enumerators)
+        self._lsts["enum"].append(
+            EnumExpr(tp.name, type_index, size, signed, allenums))
+
+    def _generate_cpy_enum_ctx(self, tp, name):
+        self._enum_ctx(tp, tp._get_c_name())
+
+    # ----------
+    # macros: for now only for integers
+
+    def _generate_cpy_macro_collecttype(self, tp, name):
+        pass
+
+    def _generate_cpy_macro_decl(self, tp, name):
+        if tp == '...':
+            check_value = None
+        else:
+            check_value = tp     # an integer
+        self._generate_cpy_const(True, name, check_value=check_value)
+
+    def _generate_cpy_macro_ctx(self, tp, name):
+        if tp == '...':
+            if self.target_is_python:
+                raise VerificationError(
+                    "cannot use the syntax '...' in '#define %s ...' when "
+                    "using the ABI mode" % (name,))
+            check_value = None
+        else:
+            check_value = tp     # an integer
+        type_op = CffiOp(OP_CONSTANT_INT, -1)
+        self._lsts["global"].append(
+            GlobalExpr(name, '_cffi_const_%s' % name, type_op,
+                       check_value=check_value))
+
+    # ----------
+    # global variables
+
+    def _global_type(self, tp, global_name):
+        if isinstance(tp, model.ArrayType):
+            actual_length = tp.length
+            if actual_length == '...':
+                actual_length = '_cffi_array_len(%s)' % (global_name,)
+            tp_item = self._global_type(tp.item, '%s[0]' % global_name)
+            tp = model.ArrayType(tp_item, actual_length)
+        return tp
+
+    def _generate_cpy_variable_collecttype(self, tp, name):
+        self._do_collect_type(self._global_type(tp, name))
+
+    def _generate_cpy_variable_decl(self, tp, name):
+        prnt = self._prnt
+        tp = self._global_type(tp, name)
+        if isinstance(tp, model.ArrayType) and tp.length is None:
+            tp = tp.item
+            ampersand = ''
+        else:
+            ampersand = '&'
+        # This code assumes that casts from "tp *" to "void *" is a
+        # no-op, i.e. a function that returns a "tp *" can be called
+        # as if it returned a "void *".  This should be generally true
+        # on any modern machine.  The only exception to that rule (on
+        # uncommon architectures, and as far as I can tell) might be
+        # if 'tp' were a function type, but that is not possible here.
+        # (If 'tp' is a function _pointer_ type, then casts from "fn_t
+        # **" to "void *" are again no-ops, as far as I can tell.)
+        decl = '*_cffi_var_%s(void)' % (name,)
+        prnt('static ' + tp.get_c_name(decl, quals=self._current_quals))
+        prnt('{')
+        prnt('  return %s(%s);' % (ampersand, name))
+        prnt('}')
+        prnt()
+
+    def _generate_cpy_variable_ctx(self, tp, name):
+        tp = self._global_type(tp, name)
+        type_index = self._typesdict[tp]
+        if self.target_is_python:
+            op = OP_GLOBAL_VAR
+        else:
+            op = OP_GLOBAL_VAR_F
+        self._lsts["global"].append(
+            GlobalExpr(name, '_cffi_var_%s' % name, CffiOp(op, type_index)))
+
+    # ----------
+    # extern "Python"
+
+    def _generate_cpy_extern_python_collecttype(self, tp, name):
+        assert isinstance(tp, model.FunctionPtrType)
+        self._do_collect_type(tp)
+    _generate_cpy_dllexport_python_collecttype = \
+      _generate_cpy_extern_python_plus_c_collecttype = \
+      _generate_cpy_extern_python_collecttype
+
+    def _extern_python_decl(self, tp, name, tag_and_space):
+        prnt = self._prnt
+        if isinstance(tp.result, model.VoidType):
+            size_of_result = '0'
+        else:
+            context = 'result of %s' % name
+            size_of_result = '(int)sizeof(%s)' % (
+                tp.result.get_c_name('', context),)
+        prnt('static struct _cffi_externpy_s _cffi_externpy__%s =' % name)
+        prnt('  { "%s.%s", %s, 0, 0 };' % (
+            self.module_name, name, size_of_result))
+        prnt()
+        #
+        arguments = []
+        context = 'argument of %s' % name
+        for i, type in enumerate(tp.args):
+            arg = type.get_c_name(' a%d' % i, context)
+            arguments.append(arg)
+        #
+        repr_arguments = ', '.join(arguments)
+        repr_arguments = repr_arguments or 'void'
+        name_and_arguments = '%s(%s)' % (name, repr_arguments)
+        if tp.abi == "__stdcall":
+            name_and_arguments = '_cffi_stdcall ' + name_and_arguments
+        #
+        def may_need_128_bits(tp):
+            return (isinstance(tp, model.PrimitiveType) and
+                    tp.name == 'long double')
+        #
+        size_of_a = max(len(tp.args)*8, 8)
+        if may_need_128_bits(tp.result):
+            size_of_a = max(size_of_a, 16)
+        if isinstance(tp.result, model.StructOrUnion):
+            size_of_a = 'sizeof(%s) > %d ? sizeof(%s) : %d' % (
+                tp.result.get_c_name(''), size_of_a,
+                tp.result.get_c_name(''), size_of_a)
+        prnt('%s%s' % (tag_and_space, tp.result.get_c_name(name_and_arguments)))
+        prnt('{')
+        prnt('  char a[%s];' % size_of_a)
+        prnt('  char *p = a;')
+        for i, type in enumerate(tp.args):
+            arg = 'a%d' % i
+            if (isinstance(type, model.StructOrUnion) or
+                    may_need_128_bits(type)):
+                arg = '&' + arg
+                type = model.PointerType(type)
+            prnt('  *(%s)(p + %d) = %s;' % (type.get_c_name('*'), i*8, arg))
+        prnt('  _cffi_call_python(&_cffi_externpy__%s, p);' % name)
+        if not isinstance(tp.result, model.VoidType):
+            prnt('  return *(%s)p;' % (tp.result.get_c_name('*'),))
+        prnt('}')
+        prnt()
+        self._num_externpy += 1
+
+    def _generate_cpy_extern_python_decl(self, tp, name):
+        self._extern_python_decl(tp, name, 'static ')
+
+    def _generate_cpy_dllexport_python_decl(self, tp, name):
+        self._extern_python_decl(tp, name, 'CFFI_DLLEXPORT ')
+
+    def _generate_cpy_extern_python_plus_c_decl(self, tp, name):
+        self._extern_python_decl(tp, name, '')
+
+    def _generate_cpy_extern_python_ctx(self, tp, name):
+        if self.target_is_python:
+            raise VerificationError(
+                "cannot use 'extern \"Python\"' in the ABI mode")
+        if tp.ellipsis:
+            raise NotImplementedError("a vararg function is extern \"Python\"")
+        type_index = self._typesdict[tp]
+        type_op = CffiOp(OP_EXTERN_PYTHON, type_index)
+        self._lsts["global"].append(
+            GlobalExpr(name, '&_cffi_externpy__%s' % name, type_op, name))
+
+    _generate_cpy_dllexport_python_ctx = \
+      _generate_cpy_extern_python_plus_c_ctx = \
+      _generate_cpy_extern_python_ctx
+
+    def _print_string_literal_in_array(self, s):
+        prnt = self._prnt
+        prnt('// # NB. this is not a string because of a size limit in MSVC')
+        if not isinstance(s, bytes):    # unicode
+            s = s.encode('utf-8')       # -> bytes
+        else:
+            s.decode('utf-8')           # got bytes, check for valid utf-8
+        try:
+            s.decode('ascii')
+        except UnicodeDecodeError:
+            s = b'# -*- encoding: utf8 -*-\n' + s
+        for line in s.splitlines(True):
+            comment = line
+            if type('//') is bytes:     # python2
+                line = map(ord, line)   #     make a list of integers
+            else:                       # python3
+                # type(line) is bytes, which enumerates like a list of integers
+                comment = ascii(comment)[1:-1]
+            prnt(('// ' + comment).rstrip())
+            printed_line = ''
+            for c in line:
+                if len(printed_line) >= 76:
+                    prnt(printed_line)
+                    printed_line = ''
+                printed_line += '%d,' % (c,)
+            prnt(printed_line)
+
+    # ----------
+    # emitting the opcodes for individual types
+
+    def _emit_bytecode_VoidType(self, tp, index):
+        self.cffi_types[index] = CffiOp(OP_PRIMITIVE, PRIM_VOID)
+
+    def _emit_bytecode_PrimitiveType(self, tp, index):
+        prim_index = PRIMITIVE_TO_INDEX[tp.name]
+        self.cffi_types[index] = CffiOp(OP_PRIMITIVE, prim_index)
+
+    def _emit_bytecode_UnknownIntegerType(self, tp, index):
+        s = ('_cffi_prim_int(sizeof(%s), (\n'
+             '           ((%s)-1) | 0 /* check that %s is an integer type */\n'
+             '         ) <= 0)' % (tp.name, tp.name, tp.name))
+        self.cffi_types[index] = CffiOp(OP_PRIMITIVE, s)
+
+    def _emit_bytecode_UnknownFloatType(self, tp, index):
+        s = ('_cffi_prim_float(sizeof(%s) *\n'
+             '           (((%s)1) / 2) * 2 /* integer => 0, float => 1 */\n'
+             '         )' % (tp.name, tp.name))
+        self.cffi_types[index] = CffiOp(OP_PRIMITIVE, s)
+
+    def _emit_bytecode_RawFunctionType(self, tp, index):
+        self.cffi_types[index] = CffiOp(OP_FUNCTION, self._typesdict[tp.result])
+        index += 1
+        for tp1 in tp.args:
+            realindex = self._typesdict[tp1]
+            if index != realindex:
+                if isinstance(tp1, model.PrimitiveType):
+                    self._emit_bytecode_PrimitiveType(tp1, index)
+                else:
+                    self.cffi_types[index] = CffiOp(OP_NOOP, realindex)
+            index += 1
+        flags = int(tp.ellipsis)
+        if tp.abi is not None:
+            if tp.abi == '__stdcall':
+                flags |= 2
+            else:
+                raise NotImplementedError("abi=%r" % (tp.abi,))
+        self.cffi_types[index] = CffiOp(OP_FUNCTION_END, flags)
+
+    def _emit_bytecode_PointerType(self, tp, index):
+        self.cffi_types[index] = CffiOp(OP_POINTER, self._typesdict[tp.totype])
+
+    _emit_bytecode_ConstPointerType = _emit_bytecode_PointerType
+    _emit_bytecode_NamedPointerType = _emit_bytecode_PointerType
+
+    def _emit_bytecode_FunctionPtrType(self, tp, index):
+        raw = tp.as_raw_function()
+        self.cffi_types[index] = CffiOp(OP_POINTER, self._typesdict[raw])
+
+    def _emit_bytecode_ArrayType(self, tp, index):
+        item_index = self._typesdict[tp.item]
+        if tp.length is None:
+            self.cffi_types[index] = CffiOp(OP_OPEN_ARRAY, item_index)
+        elif tp.length == '...':
+            raise VerificationError(
+                "type %s badly placed: the '...' array length can only be "
+                "used on global arrays or on fields of structures" % (
+                    str(tp).replace('/*...*/', '...'),))
+        else:
+            assert self.cffi_types[index + 1] == 'LEN'
+            self.cffi_types[index] = CffiOp(OP_ARRAY, item_index)
+            self.cffi_types[index + 1] = CffiOp(None, str(tp.length))
+
+    def _emit_bytecode_StructType(self, tp, index):
+        struct_index = self._struct_unions[tp]
+        self.cffi_types[index] = CffiOp(OP_STRUCT_UNION, struct_index)
+    _emit_bytecode_UnionType = _emit_bytecode_StructType
+
+    def _emit_bytecode_EnumType(self, tp, index):
+        enum_index = self._enums[tp]
+        self.cffi_types[index] = CffiOp(OP_ENUM, enum_index)
+
+
+if sys.version_info >= (3,):
+    NativeIO = io.StringIO
+else:
+    class NativeIO(io.BytesIO):
+        def write(self, s):
+            if isinstance(s, unicode):
+                s = s.encode('ascii')
+            super(NativeIO, self).write(s)
+
+def _make_c_or_py_source(ffi, module_name, preamble, target_file, verbose):
+    if verbose:
+        print("generating %s" % (target_file,))
+    recompiler = Recompiler(ffi, module_name,
+                            target_is_python=(preamble is None))
+    recompiler.collect_type_table()
+    recompiler.collect_step_tables()
+    f = NativeIO()
+    recompiler.write_source_to_f(f, preamble)
+    output = f.getvalue()
+    try:
+        with open(target_file, 'r') as f1:
+            if f1.read(len(output) + 1) != output:
+                raise IOError
+        if verbose:
+            print("(already up-to-date)")
+        return False     # already up-to-date
+    except IOError:
+        tmp_file = '%s.~%d' % (target_file, os.getpid())
+        with open(tmp_file, 'w') as f1:
+            f1.write(output)
+        try:
+            os.rename(tmp_file, target_file)
+        except OSError:
+            os.unlink(target_file)
+            os.rename(tmp_file, target_file)
+        return True
+
+def make_c_source(ffi, module_name, preamble, target_c_file, verbose=False):
+    assert preamble is not None
+    return _make_c_or_py_source(ffi, module_name, preamble, target_c_file,
+                                verbose)
+
+def make_py_source(ffi, module_name, target_py_file, verbose=False):
+    return _make_c_or_py_source(ffi, module_name, None, target_py_file,
+                                verbose)
+
+def _modname_to_file(outputdir, modname, extension):
+    parts = modname.split('.')
+    try:
+        os.makedirs(os.path.join(outputdir, *parts[:-1]))
+    except OSError:
+        pass
+    parts[-1] += extension
+    return os.path.join(outputdir, *parts), parts
+
+
+# Aaargh.  Distutils is not tested at all for the purpose of compiling
+# DLLs that are not extension modules.  Here are some hacks to work
+# around that, in the _patch_for_*() functions...
+
+def _patch_meth(patchlist, cls, name, new_meth):
+    old = getattr(cls, name)
+    patchlist.append((cls, name, old))
+    setattr(cls, name, new_meth)
+    return old
+
+def _unpatch_meths(patchlist):
+    for cls, name, old_meth in reversed(patchlist):
+        setattr(cls, name, old_meth)
+
+def _patch_for_embedding(patchlist):
+    if sys.platform == 'win32':
+        # we must not remove the manifest when building for embedding!
+        from distutils.msvc9compiler import MSVCCompiler
+        _patch_meth(patchlist, MSVCCompiler, '_remove_visual_c_ref',
+                    lambda self, manifest_file: manifest_file)
+
+    if sys.platform == 'darwin':
+        # we must not make a '-bundle', but a '-dynamiclib' instead
+        from distutils.ccompiler import CCompiler
+        def my_link_shared_object(self, *args, **kwds):
+            if '-bundle' in self.linker_so:
+                self.linker_so = list(self.linker_so)
+                i = self.linker_so.index('-bundle')
+                self.linker_so[i] = '-dynamiclib'
+            return old_link_shared_object(self, *args, **kwds)
+        old_link_shared_object = _patch_meth(patchlist, CCompiler,
+                                             'link_shared_object',
+                                             my_link_shared_object)
+
+def _patch_for_target(patchlist, target):
+    from distutils.command.build_ext import build_ext
+    # if 'target' is different from '*', we need to patch some internal
+    # method to just return this 'target' value, instead of having it
+    # built from module_name
+    if target.endswith('.*'):
+        target = target[:-2]
+        if sys.platform == 'win32':
+            target += '.dll'
+        elif sys.platform == 'darwin':
+            target += '.dylib'
+        else:
+            target += '.so'
+    _patch_meth(patchlist, build_ext, 'get_ext_filename',
+                lambda self, ext_name: target)
+
+
+def recompile(ffi, module_name, preamble, tmpdir='.', call_c_compiler=True,
+              c_file=None, source_extension='.c', extradir=None,
+              compiler_verbose=1, target=None, debug=None, **kwds):
+    if not isinstance(module_name, str):
+        module_name = module_name.encode('ascii')
+    if ffi._windows_unicode:
+        ffi._apply_windows_unicode(kwds)
+    if preamble is not None:
+        embedding = (ffi._embedding is not None)
+        if embedding:
+            ffi._apply_embedding_fix(kwds)
+        if c_file is None:
+            c_file, parts = _modname_to_file(tmpdir, module_name,
+                                             source_extension)
+            if extradir:
+                parts = [extradir] + parts
+            ext_c_file = os.path.join(*parts)
+        else:
+            ext_c_file = c_file
+        #
+        if target is None:
+            if embedding:
+                target = '%s.*' % module_name
+            else:
+                target = '*'
+        #
+        ext = ffiplatform.get_extension(ext_c_file, module_name, **kwds)
+        updated = make_c_source(ffi, module_name, preamble, c_file,
+                                verbose=compiler_verbose)
+        if call_c_compiler:
+            patchlist = []
+            cwd = os.getcwd()
+            try:
+                if embedding:
+                    _patch_for_embedding(patchlist)
+                if target != '*':
+                    _patch_for_target(patchlist, target)
+                if compiler_verbose:
+                    if tmpdir == '.':
+                        msg = 'the current directory is'
+                    else:
+                        msg = 'setting the current directory to'
+                    print('%s %r' % (msg, os.path.abspath(tmpdir)))
+                os.chdir(tmpdir)
+                outputfilename = ffiplatform.compile('.', ext,
+                                                     compiler_verbose, debug)
+            finally:
+                os.chdir(cwd)
+                _unpatch_meths(patchlist)
+            return outputfilename
+        else:
+            return ext, updated
+    else:
+        if c_file is None:
+            c_file, _ = _modname_to_file(tmpdir, module_name, '.py')
+        updated = make_py_source(ffi, module_name, c_file,
+                                 verbose=compiler_verbose)
+        if call_c_compiler:
+            return c_file
+        else:
+            return None, updated
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/setuptools_ext.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/setuptools_ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fe361487e469b3a87b80ddec1c5585b3801c587
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/setuptools_ext.py
@@ -0,0 +1,219 @@
+import os
+import sys
+
+try:
+    basestring
+except NameError:
+    # Python 3.x
+    basestring = str
+
+def error(msg):
+    from distutils.errors import DistutilsSetupError
+    raise DistutilsSetupError(msg)
+
+
+def execfile(filename, glob):
+    # We use execfile() (here rewritten for Python 3) instead of
+    # __import__() to load the build script.  The problem with
+    # a normal import is that in some packages, the intermediate
+    # __init__.py files may already try to import the file that
+    # we are generating.
+    with open(filename) as f:
+        src = f.read()
+    src += '\n'      # Python 2.6 compatibility
+    code = compile(src, filename, 'exec')
+    exec(code, glob, glob)
+
+
+def add_cffi_module(dist, mod_spec):
+    from cffi.api import FFI
+
+    if not isinstance(mod_spec, basestring):
+        error("argument to 'cffi_modules=...' must be a str or a list of str,"
+              " not %r" % (type(mod_spec).__name__,))
+    mod_spec = str(mod_spec)
+    try:
+        build_file_name, ffi_var_name = mod_spec.split(':')
+    except ValueError:
+        error("%r must be of the form 'path/build.py:ffi_variable'" %
+              (mod_spec,))
+    if not os.path.exists(build_file_name):
+        ext = ''
+        rewritten = build_file_name.replace('.', '/') + '.py'
+        if os.path.exists(rewritten):
+            ext = ' (rewrite cffi_modules to [%r])' % (
+                rewritten + ':' + ffi_var_name,)
+        error("%r does not name an existing file%s" % (build_file_name, ext))
+
+    mod_vars = {'__name__': '__cffi__', '__file__': build_file_name}
+    execfile(build_file_name, mod_vars)
+
+    try:
+        ffi = mod_vars[ffi_var_name]
+    except KeyError:
+        error("%r: object %r not found in module" % (mod_spec,
+                                                     ffi_var_name))
+    if not isinstance(ffi, FFI):
+        ffi = ffi()      # maybe it's a function instead of directly an ffi
+    if not isinstance(ffi, FFI):
+        error("%r is not an FFI instance (got %r)" % (mod_spec,
+                                                      type(ffi).__name__))
+    if not hasattr(ffi, '_assigned_source'):
+        error("%r: the set_source() method was not called" % (mod_spec,))
+    module_name, source, source_extension, kwds = ffi._assigned_source
+    if ffi._windows_unicode:
+        kwds = kwds.copy()
+        ffi._apply_windows_unicode(kwds)
+
+    if source is None:
+        _add_py_module(dist, ffi, module_name)
+    else:
+        _add_c_module(dist, ffi, module_name, source, source_extension, kwds)
+
+def _set_py_limited_api(Extension, kwds):
+    """
+    Add py_limited_api to kwds if setuptools >= 26 is in use.
+    Do not alter the setting if it already exists.
+    Setuptools takes care of ignoring the flag on Python 2 and PyPy.
+
+    CPython itself should ignore the flag in a debugging version
+    (by not listing .abi3.so in the extensions it supports), but
+    it doesn't so far, creating troubles.  That's why we check
+    for "not hasattr(sys, 'gettotalrefcount')" (the 2.7 compatible equivalent
+    of 'd' not in sys.abiflags). (http://bugs.python.org/issue28401)
+
+    On Windows, with CPython <= 3.4, it's better not to use py_limited_api
+    because virtualenv *still* doesn't copy PYTHON3.DLL on these versions.
+    Recently (2020) we started shipping only >= 3.5 wheels, though.  So
+    we'll give it another try and set py_limited_api on Windows >= 3.5.
+    """
+    from cffi import recompiler
+
+    if ('py_limited_api' not in kwds and not hasattr(sys, 'gettotalrefcount')
+            and recompiler.USE_LIMITED_API):
+        import setuptools
+        try:
+            setuptools_major_version = int(setuptools.__version__.partition('.')[0])
+            if setuptools_major_version >= 26:
+                kwds['py_limited_api'] = True
+        except ValueError:  # certain development versions of setuptools
+            # If we don't know the version number of setuptools, we
+            # try to set 'py_limited_api' anyway.  At worst, we get a
+            # warning.
+            kwds['py_limited_api'] = True
+    return kwds
+
+def _add_c_module(dist, ffi, module_name, source, source_extension, kwds):
+    from distutils.core import Extension
+    # We are a setuptools extension. Need this build_ext for py_limited_api.
+    from setuptools.command.build_ext import build_ext
+    from distutils.dir_util import mkpath
+    from distutils import log
+    from cffi import recompiler
+
+    allsources = ['$PLACEHOLDER']
+    allsources.extend(kwds.pop('sources', []))
+    kwds = _set_py_limited_api(Extension, kwds)
+    ext = Extension(name=module_name, sources=allsources, **kwds)
+
+    def make_mod(tmpdir, pre_run=None):
+        c_file = os.path.join(tmpdir, module_name + source_extension)
+        log.info("generating cffi module %r" % c_file)
+        mkpath(tmpdir)
+        # a setuptools-only, API-only hook: called with the "ext" and "ffi"
+        # arguments just before we turn the ffi into C code.  To use it,
+        # subclass the 'distutils.command.build_ext.build_ext' class and
+        # add a method 'def pre_run(self, ext, ffi)'.
+        if pre_run is not None:
+            pre_run(ext, ffi)
+        updated = recompiler.make_c_source(ffi, module_name, source, c_file)
+        if not updated:
+            log.info("already up-to-date")
+        return c_file
+
+    if dist.ext_modules is None:
+        dist.ext_modules = []
+    dist.ext_modules.append(ext)
+
+    base_class = dist.cmdclass.get('build_ext', build_ext)
+    class build_ext_make_mod(base_class):
+        def run(self):
+            if ext.sources[0] == '$PLACEHOLDER':
+                pre_run = getattr(self, 'pre_run', None)
+                ext.sources[0] = make_mod(self.build_temp, pre_run)
+            base_class.run(self)
+    dist.cmdclass['build_ext'] = build_ext_make_mod
+    # NB. multiple runs here will create multiple 'build_ext_make_mod'
+    # classes.  Even in this case the 'build_ext' command should be
+    # run once; but just in case, the logic above does nothing if
+    # called again.
+
+
+def _add_py_module(dist, ffi, module_name):
+    from distutils.dir_util import mkpath
+    from setuptools.command.build_py import build_py
+    from setuptools.command.build_ext import build_ext
+    from distutils import log
+    from cffi import recompiler
+
+    def generate_mod(py_file):
+        log.info("generating cffi module %r" % py_file)
+        mkpath(os.path.dirname(py_file))
+        updated = recompiler.make_py_source(ffi, module_name, py_file)
+        if not updated:
+            log.info("already up-to-date")
+
+    base_class = dist.cmdclass.get('build_py', build_py)
+    class build_py_make_mod(base_class):
+        def run(self):
+            base_class.run(self)
+            module_path = module_name.split('.')
+            module_path[-1] += '.py'
+            generate_mod(os.path.join(self.build_lib, *module_path))
+        def get_source_files(self):
+            # This is called from 'setup.py sdist' only.  Exclude
+            # the generate .py module in this case.
+            saved_py_modules = self.py_modules
+            try:
+                if saved_py_modules:
+                    self.py_modules = [m for m in saved_py_modules
+                                         if m != module_name]
+                return base_class.get_source_files(self)
+            finally:
+                self.py_modules = saved_py_modules
+    dist.cmdclass['build_py'] = build_py_make_mod
+
+    # distutils and setuptools have no notion I could find of a
+    # generated python module.  If we don't add module_name to
+    # dist.py_modules, then things mostly work but there are some
+    # combination of options (--root and --record) that will miss
+    # the module.  So we add it here, which gives a few apparently
+    # harmless warnings about not finding the file outside the
+    # build directory.
+    # Then we need to hack more in get_source_files(); see above.
+    if dist.py_modules is None:
+        dist.py_modules = []
+    dist.py_modules.append(module_name)
+
+    # the following is only for "build_ext -i"
+    base_class_2 = dist.cmdclass.get('build_ext', build_ext)
+    class build_ext_make_mod(base_class_2):
+        def run(self):
+            base_class_2.run(self)
+            if self.inplace:
+                # from get_ext_fullpath() in distutils/command/build_ext.py
+                module_path = module_name.split('.')
+                package = '.'.join(module_path[:-1])
+                build_py = self.get_finalized_command('build_py')
+                package_dir = build_py.get_package_dir(package)
+                file_name = module_path[-1] + '.py'
+                generate_mod(os.path.join(package_dir, file_name))
+    dist.cmdclass['build_ext'] = build_ext_make_mod
+
+def cffi_modules(dist, attr, value):
+    assert attr == 'cffi_modules'
+    if isinstance(value, basestring):
+        value = [value]
+
+    for cffi_module in value:
+        add_cffi_module(dist, cffi_module)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_cpy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_cpy.py
new file mode 100644
index 0000000000000000000000000000000000000000..6de0df0ea4e1a98e65964ab61588df9abf536bac
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_cpy.py
@@ -0,0 +1,1076 @@
+#
+# DEPRECATED: implementation for ffi.verify()
+#
+import sys, imp
+from . import model
+from .error import VerificationError
+
+
+class VCPythonEngine(object):
+    _class_key = 'x'
+    _gen_python_module = True
+
+    def __init__(self, verifier):
+        self.verifier = verifier
+        self.ffi = verifier.ffi
+        self._struct_pending_verification = {}
+        self._types_of_builtin_functions = {}
+
+    def patch_extension_kwds(self, kwds):
+        pass
+
+    def find_module(self, module_name, path, so_suffixes):
+        try:
+            f, filename, descr = imp.find_module(module_name, path)
+        except ImportError:
+            return None
+        if f is not None:
+            f.close()
+        # Note that after a setuptools installation, there are both .py
+        # and .so files with the same basename.  The code here relies on
+        # imp.find_module() locating the .so in priority.
+        if descr[0] not in so_suffixes:
+            return None
+        return filename
+
+    def collect_types(self):
+        self._typesdict = {}
+        self._generate("collecttype")
+
+    def _prnt(self, what=''):
+        self._f.write(what + '\n')
+
+    def _gettypenum(self, type):
+        # a KeyError here is a bug.  please report it! :-)
+        return self._typesdict[type]
+
+    def _do_collect_type(self, tp):
+        if ((not isinstance(tp, model.PrimitiveType)
+             or tp.name == 'long double')
+                and tp not in self._typesdict):
+            num = len(self._typesdict)
+            self._typesdict[tp] = num
+
+    def write_source_to_f(self):
+        self.collect_types()
+        #
+        # The new module will have a _cffi_setup() function that receives
+        # objects from the ffi world, and that calls some setup code in
+        # the module.  This setup code is split in several independent
+        # functions, e.g. one per constant.  The functions are "chained"
+        # by ending in a tail call to each other.
+        #
+        # This is further split in two chained lists, depending on if we
+        # can do it at import-time or if we must wait for _cffi_setup() to
+        # provide us with the <ctype> objects.  This is needed because we
+        # need the values of the enum constants in order to build the
+        # <ctype 'enum'> that we may have to pass to _cffi_setup().
+        #
+        # The following two 'chained_list_constants' items contains
+        # the head of these two chained lists, as a string that gives the
+        # call to do, if any.
+        self._chained_list_constants = ['((void)lib,0)', '((void)lib,0)']
+        #
+        prnt = self._prnt
+        # first paste some standard set of lines that are mostly '#define'
+        prnt(cffimod_header)
+        prnt()
+        # then paste the C source given by the user, verbatim.
+        prnt(self.verifier.preamble)
+        prnt()
+        #
+        # call generate_cpy_xxx_decl(), for every xxx found from
+        # ffi._parser._declarations.  This generates all the functions.
+        self._generate("decl")
+        #
+        # implement the function _cffi_setup_custom() as calling the
+        # head of the chained list.
+        self._generate_setup_custom()
+        prnt()
+        #
+        # produce the method table, including the entries for the
+        # generated Python->C function wrappers, which are done
+        # by generate_cpy_function_method().
+        prnt('static PyMethodDef _cffi_methods[] = {')
+        self._generate("method")
+        prnt('  {"_cffi_setup", _cffi_setup, METH_VARARGS, NULL},')
+        prnt('  {NULL, NULL, 0, NULL}    /* Sentinel */')
+        prnt('};')
+        prnt()
+        #
+        # standard init.
+        modname = self.verifier.get_module_name()
+        constants = self._chained_list_constants[False]
+        prnt('#if PY_MAJOR_VERSION >= 3')
+        prnt()
+        prnt('static struct PyModuleDef _cffi_module_def = {')
+        prnt('  PyModuleDef_HEAD_INIT,')
+        prnt('  "%s",' % modname)
+        prnt('  NULL,')
+        prnt('  -1,')
+        prnt('  _cffi_methods,')
+        prnt('  NULL, NULL, NULL, NULL')
+        prnt('};')
+        prnt()
+        prnt('PyMODINIT_FUNC')
+        prnt('PyInit_%s(void)' % modname)
+        prnt('{')
+        prnt('  PyObject *lib;')
+        prnt('  lib = PyModule_Create(&_cffi_module_def);')
+        prnt('  if (lib == NULL)')
+        prnt('    return NULL;')
+        prnt('  if (%s < 0 || _cffi_init() < 0) {' % (constants,))
+        prnt('    Py_DECREF(lib);')
+        prnt('    return NULL;')
+        prnt('  }')
+        prnt('  return lib;')
+        prnt('}')
+        prnt()
+        prnt('#else')
+        prnt()
+        prnt('PyMODINIT_FUNC')
+        prnt('init%s(void)' % modname)
+        prnt('{')
+        prnt('  PyObject *lib;')
+        prnt('  lib = Py_InitModule("%s", _cffi_methods);' % modname)
+        prnt('  if (lib == NULL)')
+        prnt('    return;')
+        prnt('  if (%s < 0 || _cffi_init() < 0)' % (constants,))
+        prnt('    return;')
+        prnt('  return;')
+        prnt('}')
+        prnt()
+        prnt('#endif')
+
+    def load_library(self, flags=None):
+        # XXX review all usages of 'self' here!
+        # import it as a new extension module
+        imp.acquire_lock()
+        try:
+            if hasattr(sys, "getdlopenflags"):
+                previous_flags = sys.getdlopenflags()
+            try:
+                if hasattr(sys, "setdlopenflags") and flags is not None:
+                    sys.setdlopenflags(flags)
+                module = imp.load_dynamic(self.verifier.get_module_name(),
+                                          self.verifier.modulefilename)
+            except ImportError as e:
+                error = "importing %r: %s" % (self.verifier.modulefilename, e)
+                raise VerificationError(error)
+            finally:
+                if hasattr(sys, "setdlopenflags"):
+                    sys.setdlopenflags(previous_flags)
+        finally:
+            imp.release_lock()
+        #
+        # call loading_cpy_struct() to get the struct layout inferred by
+        # the C compiler
+        self._load(module, 'loading')
+        #
+        # the C code will need the <ctype> objects.  Collect them in
+        # order in a list.
+        revmapping = dict([(value, key)
+                           for (key, value) in self._typesdict.items()])
+        lst = [revmapping[i] for i in range(len(revmapping))]
+        lst = list(map(self.ffi._get_cached_btype, lst))
+        #
+        # build the FFILibrary class and instance and call _cffi_setup().
+        # this will set up some fields like '_cffi_types', and only then
+        # it will invoke the chained list of functions that will really
+        # build (notably) the constant objects, as <cdata> if they are
+        # pointers, and store them as attributes on the 'library' object.
+        class FFILibrary(object):
+            _cffi_python_module = module
+            _cffi_ffi = self.ffi
+            _cffi_dir = []
+            def __dir__(self):
+                return FFILibrary._cffi_dir + list(self.__dict__)
+        library = FFILibrary()
+        if module._cffi_setup(lst, VerificationError, library):
+            import warnings
+            warnings.warn("reimporting %r might overwrite older definitions"
+                          % (self.verifier.get_module_name()))
+        #
+        # finally, call the loaded_cpy_xxx() functions.  This will perform
+        # the final adjustments, like copying the Python->C wrapper
+        # functions from the module to the 'library' object, and setting
+        # up the FFILibrary class with properties for the global C variables.
+        self._load(module, 'loaded', library=library)
+        module._cffi_original_ffi = self.ffi
+        module._cffi_types_of_builtin_funcs = self._types_of_builtin_functions
+        return library
+
+    def _get_declarations(self):
+        lst = [(key, tp) for (key, (tp, qual)) in
+                                self.ffi._parser._declarations.items()]
+        lst.sort()
+        return lst
+
+    def _generate(self, step_name):
+        for name, tp in self._get_declarations():
+            kind, realname = name.split(' ', 1)
+            try:
+                method = getattr(self, '_generate_cpy_%s_%s' % (kind,
+                                                                step_name))
+            except AttributeError:
+                raise VerificationError(
+                    "not implemented in verify(): %r" % name)
+            try:
+                method(tp, realname)
+            except Exception as e:
+                model.attach_exception_info(e, name)
+                raise
+
+    def _load(self, module, step_name, **kwds):
+        for name, tp in self._get_declarations():
+            kind, realname = name.split(' ', 1)
+            method = getattr(self, '_%s_cpy_%s' % (step_name, kind))
+            try:
+                method(tp, realname, module, **kwds)
+            except Exception as e:
+                model.attach_exception_info(e, name)
+                raise
+
+    def _generate_nothing(self, tp, name):
+        pass
+
+    def _loaded_noop(self, tp, name, module, **kwds):
+        pass
+
+    # ----------
+
+    def _convert_funcarg_to_c(self, tp, fromvar, tovar, errcode):
+        extraarg = ''
+        if isinstance(tp, model.PrimitiveType):
+            if tp.is_integer_type() and tp.name != '_Bool':
+                converter = '_cffi_to_c_int'
+                extraarg = ', %s' % tp.name
+            else:
+                converter = '(%s)_cffi_to_c_%s' % (tp.get_c_name(''),
+                                                   tp.name.replace(' ', '_'))
+            errvalue = '-1'
+        #
+        elif isinstance(tp, model.PointerType):
+            self._convert_funcarg_to_c_ptr_or_array(tp, fromvar,
+                                                    tovar, errcode)
+            return
+        #
+        elif isinstance(tp, (model.StructOrUnion, model.EnumType)):
+            # a struct (not a struct pointer) as a function argument
+            self._prnt('  if (_cffi_to_c((char *)&%s, _cffi_type(%d), %s) < 0)'
+                      % (tovar, self._gettypenum(tp), fromvar))
+            self._prnt('    %s;' % errcode)
+            return
+        #
+        elif isinstance(tp, model.FunctionPtrType):
+            converter = '(%s)_cffi_to_c_pointer' % tp.get_c_name('')
+            extraarg = ', _cffi_type(%d)' % self._gettypenum(tp)
+            errvalue = 'NULL'
+        #
+        else:
+            raise NotImplementedError(tp)
+        #
+        self._prnt('  %s = %s(%s%s);' % (tovar, converter, fromvar, extraarg))
+        self._prnt('  if (%s == (%s)%s && PyErr_Occurred())' % (
+            tovar, tp.get_c_name(''), errvalue))
+        self._prnt('    %s;' % errcode)
+
+    def _extra_local_variables(self, tp, localvars, freelines):
+        if isinstance(tp, model.PointerType):
+            localvars.add('Py_ssize_t datasize')
+            localvars.add('struct _cffi_freeme_s *large_args_free = NULL')
+            freelines.add('if (large_args_free != NULL)'
+                          ' _cffi_free_array_arguments(large_args_free);')
+
+    def _convert_funcarg_to_c_ptr_or_array(self, tp, fromvar, tovar, errcode):
+        self._prnt('  datasize = _cffi_prepare_pointer_call_argument(')
+        self._prnt('      _cffi_type(%d), %s, (char **)&%s);' % (
+            self._gettypenum(tp), fromvar, tovar))
+        self._prnt('  if (datasize != 0) {')
+        self._prnt('    %s = ((size_t)datasize) <= 640 ? '
+                   'alloca((size_t)datasize) : NULL;' % (tovar,))
+        self._prnt('    if (_cffi_convert_array_argument(_cffi_type(%d), %s, '
+                   '(char **)&%s,' % (self._gettypenum(tp), fromvar, tovar))
+        self._prnt('            datasize, &large_args_free) < 0)')
+        self._prnt('      %s;' % errcode)
+        self._prnt('  }')
+
+    def _convert_expr_from_c(self, tp, var, context):
+        if isinstance(tp, model.PrimitiveType):
+            if tp.is_integer_type() and tp.name != '_Bool':
+                return '_cffi_from_c_int(%s, %s)' % (var, tp.name)
+            elif tp.name != 'long double':
+                return '_cffi_from_c_%s(%s)' % (tp.name.replace(' ', '_'), var)
+            else:
+                return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (
+                    var, self._gettypenum(tp))
+        elif isinstance(tp, (model.PointerType, model.FunctionPtrType)):
+            return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        elif isinstance(tp, model.ArrayType):
+            return '_cffi_from_c_pointer((char *)%s, _cffi_type(%d))' % (
+                var, self._gettypenum(model.PointerType(tp.item)))
+        elif isinstance(tp, model.StructOrUnion):
+            if tp.fldnames is None:
+                raise TypeError("'%s' is used as %s, but is opaque" % (
+                    tp._get_c_name(), context))
+            return '_cffi_from_c_struct((char *)&%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        elif isinstance(tp, model.EnumType):
+            return '_cffi_from_c_deref((char *)&%s, _cffi_type(%d))' % (
+                var, self._gettypenum(tp))
+        else:
+            raise NotImplementedError(tp)
+
+    # ----------
+    # typedefs: generates no code so far
+
+    _generate_cpy_typedef_collecttype = _generate_nothing
+    _generate_cpy_typedef_decl   = _generate_nothing
+    _generate_cpy_typedef_method = _generate_nothing
+    _loading_cpy_typedef         = _loaded_noop
+    _loaded_cpy_typedef          = _loaded_noop
+
+    # ----------
+    # function declarations
+
+    def _generate_cpy_function_collecttype(self, tp, name):
+        assert isinstance(tp, model.FunctionPtrType)
+        if tp.ellipsis:
+            self._do_collect_type(tp)
+        else:
+            # don't call _do_collect_type(tp) in this common case,
+            # otherwise test_autofilled_struct_as_argument fails
+            for type in tp.args:
+                self._do_collect_type(type)
+            self._do_collect_type(tp.result)
+
+    def _generate_cpy_function_decl(self, tp, name):
+        assert isinstance(tp, model.FunctionPtrType)
+        if tp.ellipsis:
+            # cannot support vararg functions better than this: check for its
+            # exact type (including the fixed arguments), and build it as a
+            # constant function pointer (no CPython wrapper)
+            self._generate_cpy_const(False, name, tp)
+            return
+        prnt = self._prnt
+        numargs = len(tp.args)
+        if numargs == 0:
+            argname = 'noarg'
+        elif numargs == 1:
+            argname = 'arg0'
+        else:
+            argname = 'args'
+        prnt('static PyObject *')
+        prnt('_cffi_f_%s(PyObject *self, PyObject *%s)' % (name, argname))
+        prnt('{')
+        #
+        context = 'argument of %s' % name
+        for i, type in enumerate(tp.args):
+            prnt('  %s;' % type.get_c_name(' x%d' % i, context))
+        #
+        localvars = set()
+        freelines = set()
+        for type in tp.args:
+            self._extra_local_variables(type, localvars, freelines)
+        for decl in sorted(localvars):
+            prnt('  %s;' % (decl,))
+        #
+        if not isinstance(tp.result, model.VoidType):
+            result_code = 'result = '
+            context = 'result of %s' % name
+            prnt('  %s;' % tp.result.get_c_name(' result', context))
+            prnt('  PyObject *pyresult;')
+        else:
+            result_code = ''
+        #
+        if len(tp.args) > 1:
+            rng = range(len(tp.args))
+            for i in rng:
+                prnt('  PyObject *arg%d;' % i)
+            prnt()
+            prnt('  if (!PyArg_ParseTuple(args, "%s:%s", %s))' % (
+                'O' * numargs, name, ', '.join(['&arg%d' % i for i in rng])))
+            prnt('    return NULL;')
+        prnt()
+        #
+        for i, type in enumerate(tp.args):
+            self._convert_funcarg_to_c(type, 'arg%d' % i, 'x%d' % i,
+                                       'return NULL')
+            prnt()
+        #
+        prnt('  Py_BEGIN_ALLOW_THREADS')
+        prnt('  _cffi_restore_errno();')
+        prnt('  { %s%s(%s); }' % (
+            result_code, name,
+            ', '.join(['x%d' % i for i in range(len(tp.args))])))
+        prnt('  _cffi_save_errno();')
+        prnt('  Py_END_ALLOW_THREADS')
+        prnt()
+        #
+        prnt('  (void)self; /* unused */')
+        if numargs == 0:
+            prnt('  (void)noarg; /* unused */')
+        if result_code:
+            prnt('  pyresult = %s;' %
+                 self._convert_expr_from_c(tp.result, 'result', 'result type'))
+            for freeline in freelines:
+                prnt('  ' + freeline)
+            prnt('  return pyresult;')
+        else:
+            for freeline in freelines:
+                prnt('  ' + freeline)
+            prnt('  Py_INCREF(Py_None);')
+            prnt('  return Py_None;')
+        prnt('}')
+        prnt()
+
+    def _generate_cpy_function_method(self, tp, name):
+        if tp.ellipsis:
+            return
+        numargs = len(tp.args)
+        if numargs == 0:
+            meth = 'METH_NOARGS'
+        elif numargs == 1:
+            meth = 'METH_O'
+        else:
+            meth = 'METH_VARARGS'
+        self._prnt('  {"%s", _cffi_f_%s, %s, NULL},' % (name, name, meth))
+
+    _loading_cpy_function = _loaded_noop
+
+    def _loaded_cpy_function(self, tp, name, module, library):
+        if tp.ellipsis:
+            return
+        func = getattr(module, name)
+        setattr(library, name, func)
+        self._types_of_builtin_functions[func] = tp
+
+    # ----------
+    # named structs
+
+    _generate_cpy_struct_collecttype = _generate_nothing
+    def _generate_cpy_struct_decl(self, tp, name):
+        assert name == tp.name
+        self._generate_struct_or_union_decl(tp, 'struct', name)
+    def _generate_cpy_struct_method(self, tp, name):
+        self._generate_struct_or_union_method(tp, 'struct', name)
+    def _loading_cpy_struct(self, tp, name, module):
+        self._loading_struct_or_union(tp, 'struct', name, module)
+    def _loaded_cpy_struct(self, tp, name, module, **kwds):
+        self._loaded_struct_or_union(tp)
+
+    _generate_cpy_union_collecttype = _generate_nothing
+    def _generate_cpy_union_decl(self, tp, name):
+        assert name == tp.name
+        self._generate_struct_or_union_decl(tp, 'union', name)
+    def _generate_cpy_union_method(self, tp, name):
+        self._generate_struct_or_union_method(tp, 'union', name)
+    def _loading_cpy_union(self, tp, name, module):
+        self._loading_struct_or_union(tp, 'union', name, module)
+    def _loaded_cpy_union(self, tp, name, module, **kwds):
+        self._loaded_struct_or_union(tp)
+
+    def _generate_struct_or_union_decl(self, tp, prefix, name):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        checkfuncname = '_cffi_check_%s_%s' % (prefix, name)
+        layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)
+        cname = ('%s %s' % (prefix, name)).strip()
+        #
+        prnt = self._prnt
+        prnt('static void %s(%s *p)' % (checkfuncname, cname))
+        prnt('{')
+        prnt('  /* only to generate compile-time warnings or errors */')
+        prnt('  (void)p;')
+        for fname, ftype, fbitsize, fqual in tp.enumfields():
+            if (isinstance(ftype, model.PrimitiveType)
+                and ftype.is_integer_type()) or fbitsize >= 0:
+                # accept all integers, but complain on float or double
+                prnt('  (void)((p->%s) << 1);' % fname)
+            else:
+                # only accept exactly the type declared.
+                try:
+                    prnt('  { %s = &p->%s; (void)tmp; }' % (
+                        ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),
+                        fname))
+                except VerificationError as e:
+                    prnt('  /* %s */' % str(e))   # cannot verify it, ignore
+        prnt('}')
+        prnt('static PyObject *')
+        prnt('%s(PyObject *self, PyObject *noarg)' % (layoutfuncname,))
+        prnt('{')
+        prnt('  struct _cffi_aligncheck { char x; %s y; };' % cname)
+        prnt('  static Py_ssize_t nums[] = {')
+        prnt('    sizeof(%s),' % cname)
+        prnt('    offsetof(struct _cffi_aligncheck, y),')
+        for fname, ftype, fbitsize, fqual in tp.enumfields():
+            if fbitsize >= 0:
+                continue      # xxx ignore fbitsize for now
+            prnt('    offsetof(%s, %s),' % (cname, fname))
+            if isinstance(ftype, model.ArrayType) and ftype.length is None:
+                prnt('    0,  /* %s */' % ftype._get_c_name())
+            else:
+                prnt('    sizeof(((%s *)0)->%s),' % (cname, fname))
+        prnt('    -1')
+        prnt('  };')
+        prnt('  (void)self; /* unused */')
+        prnt('  (void)noarg; /* unused */')
+        prnt('  return _cffi_get_struct_layout(nums);')
+        prnt('  /* the next line is not executed, but compiled */')
+        prnt('  %s(0);' % (checkfuncname,))
+        prnt('}')
+        prnt()
+
+    def _generate_struct_or_union_method(self, tp, prefix, name):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)
+        self._prnt('  {"%s", %s, METH_NOARGS, NULL},' % (layoutfuncname,
+                                                         layoutfuncname))
+
+    def _loading_struct_or_union(self, tp, prefix, name, module):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)
+        #
+        function = getattr(module, layoutfuncname)
+        layout = function()
+        if isinstance(tp, model.StructOrUnion) and tp.partial:
+            # use the function()'s sizes and offsets to guide the
+            # layout of the struct
+            totalsize = layout[0]
+            totalalignment = layout[1]
+            fieldofs = layout[2::2]
+            fieldsize = layout[3::2]
+            tp.force_flatten()
+            assert len(fieldofs) == len(fieldsize) == len(tp.fldnames)
+            tp.fixedlayout = fieldofs, fieldsize, totalsize, totalalignment
+        else:
+            cname = ('%s %s' % (prefix, name)).strip()
+            self._struct_pending_verification[tp] = layout, cname
+
+    def _loaded_struct_or_union(self, tp):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        self.ffi._get_cached_btype(tp)   # force 'fixedlayout' to be considered
+
+        if tp in self._struct_pending_verification:
+            # check that the layout sizes and offsets match the real ones
+            def check(realvalue, expectedvalue, msg):
+                if realvalue != expectedvalue:
+                    raise VerificationError(
+                        "%s (we have %d, but C compiler says %d)"
+                        % (msg, expectedvalue, realvalue))
+            ffi = self.ffi
+            BStruct = ffi._get_cached_btype(tp)
+            layout, cname = self._struct_pending_verification.pop(tp)
+            check(layout[0], ffi.sizeof(BStruct), "wrong total size")
+            check(layout[1], ffi.alignof(BStruct), "wrong total alignment")
+            i = 2
+            for fname, ftype, fbitsize, fqual in tp.enumfields():
+                if fbitsize >= 0:
+                    continue        # xxx ignore fbitsize for now
+                check(layout[i], ffi.offsetof(BStruct, fname),
+                      "wrong offset for field %r" % (fname,))
+                if layout[i+1] != 0:
+                    BField = ffi._get_cached_btype(ftype)
+                    check(layout[i+1], ffi.sizeof(BField),
+                          "wrong size for field %r" % (fname,))
+                i += 2
+            assert i == len(layout)
+
+    # ----------
+    # 'anonymous' declarations.  These are produced for anonymous structs
+    # or unions; the 'name' is obtained by a typedef.
+
+    _generate_cpy_anonymous_collecttype = _generate_nothing
+
+    def _generate_cpy_anonymous_decl(self, tp, name):
+        if isinstance(tp, model.EnumType):
+            self._generate_cpy_enum_decl(tp, name, '')
+        else:
+            self._generate_struct_or_union_decl(tp, '', name)
+
+    def _generate_cpy_anonymous_method(self, tp, name):
+        if not isinstance(tp, model.EnumType):
+            self._generate_struct_or_union_method(tp, '', name)
+
+    def _loading_cpy_anonymous(self, tp, name, module):
+        if isinstance(tp, model.EnumType):
+            self._loading_cpy_enum(tp, name, module)
+        else:
+            self._loading_struct_or_union(tp, '', name, module)
+
+    def _loaded_cpy_anonymous(self, tp, name, module, **kwds):
+        if isinstance(tp, model.EnumType):
+            self._loaded_cpy_enum(tp, name, module, **kwds)
+        else:
+            self._loaded_struct_or_union(tp)
+
+    # ----------
+    # constants, likely declared with '#define'
+
+    def _generate_cpy_const(self, is_int, name, tp=None, category='const',
+                            vartp=None, delayed=True, size_too=False,
+                            check_value=None):
+        prnt = self._prnt
+        funcname = '_cffi_%s_%s' % (category, name)
+        prnt('static int %s(PyObject *lib)' % funcname)
+        prnt('{')
+        prnt('  PyObject *o;')
+        prnt('  int res;')
+        if not is_int:
+            prnt('  %s;' % (vartp or tp).get_c_name(' i', name))
+        else:
+            assert category == 'const'
+        #
+        if check_value is not None:
+            self._check_int_constant_value(name, check_value)
+        #
+        if not is_int:
+            if category == 'var':
+                realexpr = '&' + name
+            else:
+                realexpr = name
+            prnt('  i = (%s);' % (realexpr,))
+            prnt('  o = %s;' % (self._convert_expr_from_c(tp, 'i',
+                                                          'variable type'),))
+            assert delayed
+        else:
+            prnt('  o = _cffi_from_c_int_const(%s);' % name)
+        prnt('  if (o == NULL)')
+        prnt('    return -1;')
+        if size_too:
+            prnt('  {')
+            prnt('    PyObject *o1 = o;')
+            prnt('    o = Py_BuildValue("On", o1, (Py_ssize_t)sizeof(%s));'
+                 % (name,))
+            prnt('    Py_DECREF(o1);')
+            prnt('    if (o == NULL)')
+            prnt('      return -1;')
+            prnt('  }')
+        prnt('  res = PyObject_SetAttrString(lib, "%s", o);' % name)
+        prnt('  Py_DECREF(o);')
+        prnt('  if (res < 0)')
+        prnt('    return -1;')
+        prnt('  return %s;' % self._chained_list_constants[delayed])
+        self._chained_list_constants[delayed] = funcname + '(lib)'
+        prnt('}')
+        prnt()
+
+    def _generate_cpy_constant_collecttype(self, tp, name):
+        is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()
+        if not is_int:
+            self._do_collect_type(tp)
+
+    def _generate_cpy_constant_decl(self, tp, name):
+        is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()
+        self._generate_cpy_const(is_int, name, tp)
+
+    _generate_cpy_constant_method = _generate_nothing
+    _loading_cpy_constant = _loaded_noop
+    _loaded_cpy_constant  = _loaded_noop
+
+    # ----------
+    # enums
+
+    def _check_int_constant_value(self, name, value, err_prefix=''):
+        prnt = self._prnt
+        if value <= 0:
+            prnt('  if ((%s) > 0 || (long)(%s) != %dL) {' % (
+                name, name, value))
+        else:
+            prnt('  if ((%s) <= 0 || (unsigned long)(%s) != %dUL) {' % (
+                name, name, value))
+        prnt('    char buf[64];')
+        prnt('    if ((%s) <= 0)' % name)
+        prnt('        snprintf(buf, 63, "%%ld", (long)(%s));' % name)
+        prnt('    else')
+        prnt('        snprintf(buf, 63, "%%lu", (unsigned long)(%s));' %
+             name)
+        prnt('    PyErr_Format(_cffi_VerificationError,')
+        prnt('                 "%s%s has the real value %s, not %s",')
+        prnt('                 "%s", "%s", buf, "%d");' % (
+            err_prefix, name, value))
+        prnt('    return -1;')
+        prnt('  }')
+
+    def _enum_funcname(self, prefix, name):
+        # "$enum_$1" => "___D_enum____D_1"
+        name = name.replace('$', '___D_')
+        return '_cffi_e_%s_%s' % (prefix, name)
+
+    def _generate_cpy_enum_decl(self, tp, name, prefix='enum'):
+        if tp.partial:
+            for enumerator in tp.enumerators:
+                self._generate_cpy_const(True, enumerator, delayed=False)
+            return
+        #
+        funcname = self._enum_funcname(prefix, name)
+        prnt = self._prnt
+        prnt('static int %s(PyObject *lib)' % funcname)
+        prnt('{')
+        for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):
+            self._check_int_constant_value(enumerator, enumvalue,
+                                           "enum %s: " % name)
+        prnt('  return %s;' % self._chained_list_constants[True])
+        self._chained_list_constants[True] = funcname + '(lib)'
+        prnt('}')
+        prnt()
+
+    _generate_cpy_enum_collecttype = _generate_nothing
+    _generate_cpy_enum_method = _generate_nothing
+
+    def _loading_cpy_enum(self, tp, name, module):
+        if tp.partial:
+            enumvalues = [getattr(module, enumerator)
+                          for enumerator in tp.enumerators]
+            tp.enumvalues = tuple(enumvalues)
+            tp.partial_resolved = True
+
+    def _loaded_cpy_enum(self, tp, name, module, library):
+        for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):
+            setattr(library, enumerator, enumvalue)
+
+    # ----------
+    # macros: for now only for integers
+
+    def _generate_cpy_macro_decl(self, tp, name):
+        if tp == '...':
+            check_value = None
+        else:
+            check_value = tp     # an integer
+        self._generate_cpy_const(True, name, check_value=check_value)
+
+    _generate_cpy_macro_collecttype = _generate_nothing
+    _generate_cpy_macro_method = _generate_nothing
+    _loading_cpy_macro = _loaded_noop
+    _loaded_cpy_macro  = _loaded_noop
+
+    # ----------
+    # global variables
+
+    def _generate_cpy_variable_collecttype(self, tp, name):
+        if isinstance(tp, model.ArrayType):
+            tp_ptr = model.PointerType(tp.item)
+        else:
+            tp_ptr = model.PointerType(tp)
+        self._do_collect_type(tp_ptr)
+
+    def _generate_cpy_variable_decl(self, tp, name):
+        if isinstance(tp, model.ArrayType):
+            tp_ptr = model.PointerType(tp.item)
+            self._generate_cpy_const(False, name, tp, vartp=tp_ptr,
+                                     size_too = tp.length_is_unknown())
+        else:
+            tp_ptr = model.PointerType(tp)
+            self._generate_cpy_const(False, name, tp_ptr, category='var')
+
+    _generate_cpy_variable_method = _generate_nothing
+    _loading_cpy_variable = _loaded_noop
+
+    def _loaded_cpy_variable(self, tp, name, module, library):
+        value = getattr(library, name)
+        if isinstance(tp, model.ArrayType):   # int a[5] is "constant" in the
+                                              # sense that "a=..." is forbidden
+            if tp.length_is_unknown():
+                assert isinstance(value, tuple)
+                (value, size) = value
+                BItemType = self.ffi._get_cached_btype(tp.item)
+                length, rest = divmod(size, self.ffi.sizeof(BItemType))
+                if rest != 0:
+                    raise VerificationError(
+                        "bad size: %r does not seem to be an array of %s" %
+                        (name, tp.item))
+                tp = tp.resolve_length(length)
+            # 'value' is a <cdata 'type *'> which we have to replace with
+            # a <cdata 'type[N]'> if the N is actually known
+            if tp.length is not None:
+                BArray = self.ffi._get_cached_btype(tp)
+                value = self.ffi.cast(BArray, value)
+                setattr(library, name, value)
+            return
+        # remove ptr=<cdata 'int *'> from the library instance, and replace
+        # it by a property on the class, which reads/writes into ptr[0].
+        ptr = value
+        delattr(library, name)
+        def getter(library):
+            return ptr[0]
+        def setter(library, value):
+            ptr[0] = value
+        setattr(type(library), name, property(getter, setter))
+        type(library)._cffi_dir.append(name)
+
+    # ----------
+
+    def _generate_setup_custom(self):
+        prnt = self._prnt
+        prnt('static int _cffi_setup_custom(PyObject *lib)')
+        prnt('{')
+        prnt('  return %s;' % self._chained_list_constants[True])
+        prnt('}')
+
+cffimod_header = r'''
+#include <Python.h>
+#include <stddef.h>
+
+/* this block of #ifs should be kept exactly identical between
+   c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py
+   and cffi/_cffi_include.h */
+#if defined(_MSC_VER)
+# include <malloc.h>   /* for alloca() */
+# if _MSC_VER < 1600   /* MSVC < 2010 */
+   typedef __int8 int8_t;
+   typedef __int16 int16_t;
+   typedef __int32 int32_t;
+   typedef __int64 int64_t;
+   typedef unsigned __int8 uint8_t;
+   typedef unsigned __int16 uint16_t;
+   typedef unsigned __int32 uint32_t;
+   typedef unsigned __int64 uint64_t;
+   typedef __int8 int_least8_t;
+   typedef __int16 int_least16_t;
+   typedef __int32 int_least32_t;
+   typedef __int64 int_least64_t;
+   typedef unsigned __int8 uint_least8_t;
+   typedef unsigned __int16 uint_least16_t;
+   typedef unsigned __int32 uint_least32_t;
+   typedef unsigned __int64 uint_least64_t;
+   typedef __int8 int_fast8_t;
+   typedef __int16 int_fast16_t;
+   typedef __int32 int_fast32_t;
+   typedef __int64 int_fast64_t;
+   typedef unsigned __int8 uint_fast8_t;
+   typedef unsigned __int16 uint_fast16_t;
+   typedef unsigned __int32 uint_fast32_t;
+   typedef unsigned __int64 uint_fast64_t;
+   typedef __int64 intmax_t;
+   typedef unsigned __int64 uintmax_t;
+# else
+#  include <stdint.h>
+# endif
+# if _MSC_VER < 1800   /* MSVC < 2013 */
+#  ifndef __cplusplus
+    typedef unsigned char _Bool;
+#  endif
+# endif
+#else
+# include <stdint.h>
+# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)
+#  include <alloca.h>
+# endif
+#endif
+
+#if PY_MAJOR_VERSION < 3
+# undef PyCapsule_CheckExact
+# undef PyCapsule_GetPointer
+# define PyCapsule_CheckExact(capsule) (PyCObject_Check(capsule))
+# define PyCapsule_GetPointer(capsule, name) \
+    (PyCObject_AsVoidPtr(capsule))
+#endif
+
+#if PY_MAJOR_VERSION >= 3
+# define PyInt_FromLong PyLong_FromLong
+#endif
+
+#define _cffi_from_c_double PyFloat_FromDouble
+#define _cffi_from_c_float PyFloat_FromDouble
+#define _cffi_from_c_long PyInt_FromLong
+#define _cffi_from_c_ulong PyLong_FromUnsignedLong
+#define _cffi_from_c_longlong PyLong_FromLongLong
+#define _cffi_from_c_ulonglong PyLong_FromUnsignedLongLong
+#define _cffi_from_c__Bool PyBool_FromLong
+
+#define _cffi_to_c_double PyFloat_AsDouble
+#define _cffi_to_c_float PyFloat_AsDouble
+
+#define _cffi_from_c_int_const(x)                                        \
+    (((x) > 0) ?                                                         \
+        ((unsigned long long)(x) <= (unsigned long long)LONG_MAX) ?      \
+            PyInt_FromLong((long)(x)) :                                  \
+            PyLong_FromUnsignedLongLong((unsigned long long)(x)) :       \
+        ((long long)(x) >= (long long)LONG_MIN) ?                        \
+            PyInt_FromLong((long)(x)) :                                  \
+            PyLong_FromLongLong((long long)(x)))
+
+#define _cffi_from_c_int(x, type)                                        \
+    (((type)-1) > 0 ? /* unsigned */                                     \
+        (sizeof(type) < sizeof(long) ?                                   \
+            PyInt_FromLong((long)x) :                                    \
+         sizeof(type) == sizeof(long) ?                                  \
+            PyLong_FromUnsignedLong((unsigned long)x) :                  \
+            PyLong_FromUnsignedLongLong((unsigned long long)x)) :        \
+        (sizeof(type) <= sizeof(long) ?                                  \
+            PyInt_FromLong((long)x) :                                    \
+            PyLong_FromLongLong((long long)x)))
+
+#define _cffi_to_c_int(o, type)                                          \
+    ((type)(                                                             \
+     sizeof(type) == 1 ? (((type)-1) > 0 ? (type)_cffi_to_c_u8(o)        \
+                                         : (type)_cffi_to_c_i8(o)) :     \
+     sizeof(type) == 2 ? (((type)-1) > 0 ? (type)_cffi_to_c_u16(o)       \
+                                         : (type)_cffi_to_c_i16(o)) :    \
+     sizeof(type) == 4 ? (((type)-1) > 0 ? (type)_cffi_to_c_u32(o)       \
+                                         : (type)_cffi_to_c_i32(o)) :    \
+     sizeof(type) == 8 ? (((type)-1) > 0 ? (type)_cffi_to_c_u64(o)       \
+                                         : (type)_cffi_to_c_i64(o)) :    \
+     (Py_FatalError("unsupported size for type " #type), (type)0)))
+
+#define _cffi_to_c_i8                                                    \
+                 ((int(*)(PyObject *))_cffi_exports[1])
+#define _cffi_to_c_u8                                                    \
+                 ((int(*)(PyObject *))_cffi_exports[2])
+#define _cffi_to_c_i16                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[3])
+#define _cffi_to_c_u16                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[4])
+#define _cffi_to_c_i32                                                   \
+                 ((int(*)(PyObject *))_cffi_exports[5])
+#define _cffi_to_c_u32                                                   \
+                 ((unsigned int(*)(PyObject *))_cffi_exports[6])
+#define _cffi_to_c_i64                                                   \
+                 ((long long(*)(PyObject *))_cffi_exports[7])
+#define _cffi_to_c_u64                                                   \
+                 ((unsigned long long(*)(PyObject *))_cffi_exports[8])
+#define _cffi_to_c_char                                                  \
+                 ((int(*)(PyObject *))_cffi_exports[9])
+#define _cffi_from_c_pointer                                             \
+    ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[10])
+#define _cffi_to_c_pointer                                               \
+    ((char *(*)(PyObject *, CTypeDescrObject *))_cffi_exports[11])
+#define _cffi_get_struct_layout                                          \
+    ((PyObject *(*)(Py_ssize_t[]))_cffi_exports[12])
+#define _cffi_restore_errno                                              \
+    ((void(*)(void))_cffi_exports[13])
+#define _cffi_save_errno                                                 \
+    ((void(*)(void))_cffi_exports[14])
+#define _cffi_from_c_char                                                \
+    ((PyObject *(*)(char))_cffi_exports[15])
+#define _cffi_from_c_deref                                               \
+    ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[16])
+#define _cffi_to_c                                                       \
+    ((int(*)(char *, CTypeDescrObject *, PyObject *))_cffi_exports[17])
+#define _cffi_from_c_struct                                              \
+    ((PyObject *(*)(char *, CTypeDescrObject *))_cffi_exports[18])
+#define _cffi_to_c_wchar_t                                               \
+    ((wchar_t(*)(PyObject *))_cffi_exports[19])
+#define _cffi_from_c_wchar_t                                             \
+    ((PyObject *(*)(wchar_t))_cffi_exports[20])
+#define _cffi_to_c_long_double                                           \
+    ((long double(*)(PyObject *))_cffi_exports[21])
+#define _cffi_to_c__Bool                                                 \
+    ((_Bool(*)(PyObject *))_cffi_exports[22])
+#define _cffi_prepare_pointer_call_argument                              \
+    ((Py_ssize_t(*)(CTypeDescrObject *, PyObject *, char **))_cffi_exports[23])
+#define _cffi_convert_array_from_object                                  \
+    ((int(*)(char *, CTypeDescrObject *, PyObject *))_cffi_exports[24])
+#define _CFFI_NUM_EXPORTS 25
+
+typedef struct _ctypedescr CTypeDescrObject;
+
+static void *_cffi_exports[_CFFI_NUM_EXPORTS];
+static PyObject *_cffi_types, *_cffi_VerificationError;
+
+static int _cffi_setup_custom(PyObject *lib);   /* forward */
+
+static PyObject *_cffi_setup(PyObject *self, PyObject *args)
+{
+    PyObject *library;
+    int was_alive = (_cffi_types != NULL);
+    (void)self; /* unused */
+    if (!PyArg_ParseTuple(args, "OOO", &_cffi_types, &_cffi_VerificationError,
+                                       &library))
+        return NULL;
+    Py_INCREF(_cffi_types);
+    Py_INCREF(_cffi_VerificationError);
+    if (_cffi_setup_custom(library) < 0)
+        return NULL;
+    return PyBool_FromLong(was_alive);
+}
+
+union _cffi_union_alignment_u {
+    unsigned char m_char;
+    unsigned short m_short;
+    unsigned int m_int;
+    unsigned long m_long;
+    unsigned long long m_longlong;
+    float m_float;
+    double m_double;
+    long double m_longdouble;
+};
+
+struct _cffi_freeme_s {
+    struct _cffi_freeme_s *next;
+    union _cffi_union_alignment_u alignment;
+};
+
+#ifdef __GNUC__
+  __attribute__((unused))
+#endif
+static int _cffi_convert_array_argument(CTypeDescrObject *ctptr, PyObject *arg,
+                                        char **output_data, Py_ssize_t datasize,
+                                        struct _cffi_freeme_s **freeme)
+{
+    char *p;
+    if (datasize < 0)
+        return -1;
+
+    p = *output_data;
+    if (p == NULL) {
+        struct _cffi_freeme_s *fp = (struct _cffi_freeme_s *)PyObject_Malloc(
+            offsetof(struct _cffi_freeme_s, alignment) + (size_t)datasize);
+        if (fp == NULL)
+            return -1;
+        fp->next = *freeme;
+        *freeme = fp;
+        p = *output_data = (char *)&fp->alignment;
+    }
+    memset((void *)p, 0, (size_t)datasize);
+    return _cffi_convert_array_from_object(p, ctptr, arg);
+}
+
+#ifdef __GNUC__
+  __attribute__((unused))
+#endif
+static void _cffi_free_array_arguments(struct _cffi_freeme_s *freeme)
+{
+    do {
+        void *p = (void *)freeme;
+        freeme = freeme->next;
+        PyObject_Free(p);
+    } while (freeme != NULL);
+}
+
+static int _cffi_init(void)
+{
+    PyObject *module, *c_api_object = NULL;
+
+    module = PyImport_ImportModule("_cffi_backend");
+    if (module == NULL)
+        goto failure;
+
+    c_api_object = PyObject_GetAttrString(module, "_C_API");
+    if (c_api_object == NULL)
+        goto failure;
+    if (!PyCapsule_CheckExact(c_api_object)) {
+        PyErr_SetNone(PyExc_ImportError);
+        goto failure;
+    }
+    memcpy(_cffi_exports, PyCapsule_GetPointer(c_api_object, "cffi"),
+           _CFFI_NUM_EXPORTS * sizeof(void *));
+
+    Py_DECREF(module);
+    Py_DECREF(c_api_object);
+    return 0;
+
+  failure:
+    Py_XDECREF(module);
+    Py_XDECREF(c_api_object);
+    return -1;
+}
+
+#define _cffi_type(num) ((CTypeDescrObject *)PyList_GET_ITEM(_cffi_types, num))
+
+/**********/
+'''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_gen.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_gen.py
new file mode 100644
index 0000000000000000000000000000000000000000..26421526f62a07e04419cd57f1f19a64ecd36452
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/vengine_gen.py
@@ -0,0 +1,675 @@
+#
+# DEPRECATED: implementation for ffi.verify()
+#
+import sys, os
+import types
+
+from . import model
+from .error import VerificationError
+
+
+class VGenericEngine(object):
+    _class_key = 'g'
+    _gen_python_module = False
+
+    def __init__(self, verifier):
+        self.verifier = verifier
+        self.ffi = verifier.ffi
+        self.export_symbols = []
+        self._struct_pending_verification = {}
+
+    def patch_extension_kwds(self, kwds):
+        # add 'export_symbols' to the dictionary.  Note that we add the
+        # list before filling it.  When we fill it, it will thus also show
+        # up in kwds['export_symbols'].
+        kwds.setdefault('export_symbols', self.export_symbols)
+
+    def find_module(self, module_name, path, so_suffixes):
+        for so_suffix in so_suffixes:
+            basename = module_name + so_suffix
+            if path is None:
+                path = sys.path
+            for dirname in path:
+                filename = os.path.join(dirname, basename)
+                if os.path.isfile(filename):
+                    return filename
+
+    def collect_types(self):
+        pass      # not needed in the generic engine
+
+    def _prnt(self, what=''):
+        self._f.write(what + '\n')
+
+    def write_source_to_f(self):
+        prnt = self._prnt
+        # first paste some standard set of lines that are mostly '#include'
+        prnt(cffimod_header)
+        # then paste the C source given by the user, verbatim.
+        prnt(self.verifier.preamble)
+        #
+        # call generate_gen_xxx_decl(), for every xxx found from
+        # ffi._parser._declarations.  This generates all the functions.
+        self._generate('decl')
+        #
+        # on Windows, distutils insists on putting init_cffi_xyz in
+        # 'export_symbols', so instead of fighting it, just give up and
+        # give it one
+        if sys.platform == 'win32':
+            if sys.version_info >= (3,):
+                prefix = 'PyInit_'
+            else:
+                prefix = 'init'
+            modname = self.verifier.get_module_name()
+            prnt("void %s%s(void) { }\n" % (prefix, modname))
+
+    def load_library(self, flags=0):
+        # import it with the CFFI backend
+        backend = self.ffi._backend
+        # needs to make a path that contains '/', on Posix
+        filename = os.path.join(os.curdir, self.verifier.modulefilename)
+        module = backend.load_library(filename, flags)
+        #
+        # call loading_gen_struct() to get the struct layout inferred by
+        # the C compiler
+        self._load(module, 'loading')
+
+        # build the FFILibrary class and instance, this is a module subclass
+        # because modules are expected to have usually-constant-attributes and
+        # in PyPy this means the JIT is able to treat attributes as constant,
+        # which we want.
+        class FFILibrary(types.ModuleType):
+            _cffi_generic_module = module
+            _cffi_ffi = self.ffi
+            _cffi_dir = []
+            def __dir__(self):
+                return FFILibrary._cffi_dir
+        library = FFILibrary("")
+        #
+        # finally, call the loaded_gen_xxx() functions.  This will set
+        # up the 'library' object.
+        self._load(module, 'loaded', library=library)
+        return library
+
+    def _get_declarations(self):
+        lst = [(key, tp) for (key, (tp, qual)) in
+                                self.ffi._parser._declarations.items()]
+        lst.sort()
+        return lst
+
+    def _generate(self, step_name):
+        for name, tp in self._get_declarations():
+            kind, realname = name.split(' ', 1)
+            try:
+                method = getattr(self, '_generate_gen_%s_%s' % (kind,
+                                                                step_name))
+            except AttributeError:
+                raise VerificationError(
+                    "not implemented in verify(): %r" % name)
+            try:
+                method(tp, realname)
+            except Exception as e:
+                model.attach_exception_info(e, name)
+                raise
+
+    def _load(self, module, step_name, **kwds):
+        for name, tp in self._get_declarations():
+            kind, realname = name.split(' ', 1)
+            method = getattr(self, '_%s_gen_%s' % (step_name, kind))
+            try:
+                method(tp, realname, module, **kwds)
+            except Exception as e:
+                model.attach_exception_info(e, name)
+                raise
+
+    def _generate_nothing(self, tp, name):
+        pass
+
+    def _loaded_noop(self, tp, name, module, **kwds):
+        pass
+
+    # ----------
+    # typedefs: generates no code so far
+
+    _generate_gen_typedef_decl   = _generate_nothing
+    _loading_gen_typedef         = _loaded_noop
+    _loaded_gen_typedef          = _loaded_noop
+
+    # ----------
+    # function declarations
+
+    def _generate_gen_function_decl(self, tp, name):
+        assert isinstance(tp, model.FunctionPtrType)
+        if tp.ellipsis:
+            # cannot support vararg functions better than this: check for its
+            # exact type (including the fixed arguments), and build it as a
+            # constant function pointer (no _cffi_f_%s wrapper)
+            self._generate_gen_const(False, name, tp)
+            return
+        prnt = self._prnt
+        numargs = len(tp.args)
+        argnames = []
+        for i, type in enumerate(tp.args):
+            indirection = ''
+            if isinstance(type, model.StructOrUnion):
+                indirection = '*'
+            argnames.append('%sx%d' % (indirection, i))
+        context = 'argument of %s' % name
+        arglist = [type.get_c_name(' %s' % arg, context)
+                   for type, arg in zip(tp.args, argnames)]
+        tpresult = tp.result
+        if isinstance(tpresult, model.StructOrUnion):
+            arglist.insert(0, tpresult.get_c_name(' *r', context))
+            tpresult = model.void_type
+        arglist = ', '.join(arglist) or 'void'
+        wrappername = '_cffi_f_%s' % name
+        self.export_symbols.append(wrappername)
+        if tp.abi:
+            abi = tp.abi + ' '
+        else:
+            abi = ''
+        funcdecl = ' %s%s(%s)' % (abi, wrappername, arglist)
+        context = 'result of %s' % name
+        prnt(tpresult.get_c_name(funcdecl, context))
+        prnt('{')
+        #
+        if isinstance(tp.result, model.StructOrUnion):
+            result_code = '*r = '
+        elif not isinstance(tp.result, model.VoidType):
+            result_code = 'return '
+        else:
+            result_code = ''
+        prnt('  %s%s(%s);' % (result_code, name, ', '.join(argnames)))
+        prnt('}')
+        prnt()
+
+    _loading_gen_function = _loaded_noop
+
+    def _loaded_gen_function(self, tp, name, module, library):
+        assert isinstance(tp, model.FunctionPtrType)
+        if tp.ellipsis:
+            newfunction = self._load_constant(False, tp, name, module)
+        else:
+            indirections = []
+            base_tp = tp
+            if (any(isinstance(typ, model.StructOrUnion) for typ in tp.args)
+                    or isinstance(tp.result, model.StructOrUnion)):
+                indirect_args = []
+                for i, typ in enumerate(tp.args):
+                    if isinstance(typ, model.StructOrUnion):
+                        typ = model.PointerType(typ)
+                        indirections.append((i, typ))
+                    indirect_args.append(typ)
+                indirect_result = tp.result
+                if isinstance(indirect_result, model.StructOrUnion):
+                    if indirect_result.fldtypes is None:
+                        raise TypeError("'%s' is used as result type, "
+                                        "but is opaque" % (
+                                            indirect_result._get_c_name(),))
+                    indirect_result = model.PointerType(indirect_result)
+                    indirect_args.insert(0, indirect_result)
+                    indirections.insert(0, ("result", indirect_result))
+                    indirect_result = model.void_type
+                tp = model.FunctionPtrType(tuple(indirect_args),
+                                           indirect_result, tp.ellipsis)
+            BFunc = self.ffi._get_cached_btype(tp)
+            wrappername = '_cffi_f_%s' % name
+            newfunction = module.load_function(BFunc, wrappername)
+            for i, typ in indirections:
+                newfunction = self._make_struct_wrapper(newfunction, i, typ,
+                                                        base_tp)
+        setattr(library, name, newfunction)
+        type(library)._cffi_dir.append(name)
+
+    def _make_struct_wrapper(self, oldfunc, i, tp, base_tp):
+        backend = self.ffi._backend
+        BType = self.ffi._get_cached_btype(tp)
+        if i == "result":
+            ffi = self.ffi
+            def newfunc(*args):
+                res = ffi.new(BType)
+                oldfunc(res, *args)
+                return res[0]
+        else:
+            def newfunc(*args):
+                args = args[:i] + (backend.newp(BType, args[i]),) + args[i+1:]
+                return oldfunc(*args)
+        newfunc._cffi_base_type = base_tp
+        return newfunc
+
+    # ----------
+    # named structs
+
+    def _generate_gen_struct_decl(self, tp, name):
+        assert name == tp.name
+        self._generate_struct_or_union_decl(tp, 'struct', name)
+
+    def _loading_gen_struct(self, tp, name, module):
+        self._loading_struct_or_union(tp, 'struct', name, module)
+
+    def _loaded_gen_struct(self, tp, name, module, **kwds):
+        self._loaded_struct_or_union(tp)
+
+    def _generate_gen_union_decl(self, tp, name):
+        assert name == tp.name
+        self._generate_struct_or_union_decl(tp, 'union', name)
+
+    def _loading_gen_union(self, tp, name, module):
+        self._loading_struct_or_union(tp, 'union', name, module)
+
+    def _loaded_gen_union(self, tp, name, module, **kwds):
+        self._loaded_struct_or_union(tp)
+
+    def _generate_struct_or_union_decl(self, tp, prefix, name):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        checkfuncname = '_cffi_check_%s_%s' % (prefix, name)
+        layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)
+        cname = ('%s %s' % (prefix, name)).strip()
+        #
+        prnt = self._prnt
+        prnt('static void %s(%s *p)' % (checkfuncname, cname))
+        prnt('{')
+        prnt('  /* only to generate compile-time warnings or errors */')
+        prnt('  (void)p;')
+        for fname, ftype, fbitsize, fqual in tp.enumfields():
+            if (isinstance(ftype, model.PrimitiveType)
+                and ftype.is_integer_type()) or fbitsize >= 0:
+                # accept all integers, but complain on float or double
+                prnt('  (void)((p->%s) << 1);' % fname)
+            else:
+                # only accept exactly the type declared.
+                try:
+                    prnt('  { %s = &p->%s; (void)tmp; }' % (
+                        ftype.get_c_name('*tmp', 'field %r'%fname, quals=fqual),
+                        fname))
+                except VerificationError as e:
+                    prnt('  /* %s */' % str(e))   # cannot verify it, ignore
+        prnt('}')
+        self.export_symbols.append(layoutfuncname)
+        prnt('intptr_t %s(intptr_t i)' % (layoutfuncname,))
+        prnt('{')
+        prnt('  struct _cffi_aligncheck { char x; %s y; };' % cname)
+        prnt('  static intptr_t nums[] = {')
+        prnt('    sizeof(%s),' % cname)
+        prnt('    offsetof(struct _cffi_aligncheck, y),')
+        for fname, ftype, fbitsize, fqual in tp.enumfields():
+            if fbitsize >= 0:
+                continue      # xxx ignore fbitsize for now
+            prnt('    offsetof(%s, %s),' % (cname, fname))
+            if isinstance(ftype, model.ArrayType) and ftype.length is None:
+                prnt('    0,  /* %s */' % ftype._get_c_name())
+            else:
+                prnt('    sizeof(((%s *)0)->%s),' % (cname, fname))
+        prnt('    -1')
+        prnt('  };')
+        prnt('  return nums[i];')
+        prnt('  /* the next line is not executed, but compiled */')
+        prnt('  %s(0);' % (checkfuncname,))
+        prnt('}')
+        prnt()
+
+    def _loading_struct_or_union(self, tp, prefix, name, module):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        layoutfuncname = '_cffi_layout_%s_%s' % (prefix, name)
+        #
+        BFunc = self.ffi._typeof_locked("intptr_t(*)(intptr_t)")[0]
+        function = module.load_function(BFunc, layoutfuncname)
+        layout = []
+        num = 0
+        while True:
+            x = function(num)
+            if x < 0: break
+            layout.append(x)
+            num += 1
+        if isinstance(tp, model.StructOrUnion) and tp.partial:
+            # use the function()'s sizes and offsets to guide the
+            # layout of the struct
+            totalsize = layout[0]
+            totalalignment = layout[1]
+            fieldofs = layout[2::2]
+            fieldsize = layout[3::2]
+            tp.force_flatten()
+            assert len(fieldofs) == len(fieldsize) == len(tp.fldnames)
+            tp.fixedlayout = fieldofs, fieldsize, totalsize, totalalignment
+        else:
+            cname = ('%s %s' % (prefix, name)).strip()
+            self._struct_pending_verification[tp] = layout, cname
+
+    def _loaded_struct_or_union(self, tp):
+        if tp.fldnames is None:
+            return     # nothing to do with opaque structs
+        self.ffi._get_cached_btype(tp)   # force 'fixedlayout' to be considered
+
+        if tp in self._struct_pending_verification:
+            # check that the layout sizes and offsets match the real ones
+            def check(realvalue, expectedvalue, msg):
+                if realvalue != expectedvalue:
+                    raise VerificationError(
+                        "%s (we have %d, but C compiler says %d)"
+                        % (msg, expectedvalue, realvalue))
+            ffi = self.ffi
+            BStruct = ffi._get_cached_btype(tp)
+            layout, cname = self._struct_pending_verification.pop(tp)
+            check(layout[0], ffi.sizeof(BStruct), "wrong total size")
+            check(layout[1], ffi.alignof(BStruct), "wrong total alignment")
+            i = 2
+            for fname, ftype, fbitsize, fqual in tp.enumfields():
+                if fbitsize >= 0:
+                    continue        # xxx ignore fbitsize for now
+                check(layout[i], ffi.offsetof(BStruct, fname),
+                      "wrong offset for field %r" % (fname,))
+                if layout[i+1] != 0:
+                    BField = ffi._get_cached_btype(ftype)
+                    check(layout[i+1], ffi.sizeof(BField),
+                          "wrong size for field %r" % (fname,))
+                i += 2
+            assert i == len(layout)
+
+    # ----------
+    # 'anonymous' declarations.  These are produced for anonymous structs
+    # or unions; the 'name' is obtained by a typedef.
+
+    def _generate_gen_anonymous_decl(self, tp, name):
+        if isinstance(tp, model.EnumType):
+            self._generate_gen_enum_decl(tp, name, '')
+        else:
+            self._generate_struct_or_union_decl(tp, '', name)
+
+    def _loading_gen_anonymous(self, tp, name, module):
+        if isinstance(tp, model.EnumType):
+            self._loading_gen_enum(tp, name, module, '')
+        else:
+            self._loading_struct_or_union(tp, '', name, module)
+
+    def _loaded_gen_anonymous(self, tp, name, module, **kwds):
+        if isinstance(tp, model.EnumType):
+            self._loaded_gen_enum(tp, name, module, **kwds)
+        else:
+            self._loaded_struct_or_union(tp)
+
+    # ----------
+    # constants, likely declared with '#define'
+
+    def _generate_gen_const(self, is_int, name, tp=None, category='const',
+                            check_value=None):
+        prnt = self._prnt
+        funcname = '_cffi_%s_%s' % (category, name)
+        self.export_symbols.append(funcname)
+        if check_value is not None:
+            assert is_int
+            assert category == 'const'
+            prnt('int %s(char *out_error)' % funcname)
+            prnt('{')
+            self._check_int_constant_value(name, check_value)
+            prnt('  return 0;')
+            prnt('}')
+        elif is_int:
+            assert category == 'const'
+            prnt('int %s(long long *out_value)' % funcname)
+            prnt('{')
+            prnt('  *out_value = (long long)(%s);' % (name,))
+            prnt('  return (%s) <= 0;' % (name,))
+            prnt('}')
+        else:
+            assert tp is not None
+            assert check_value is None
+            if category == 'var':
+                ampersand = '&'
+            else:
+                ampersand = ''
+            extra = ''
+            if category == 'const' and isinstance(tp, model.StructOrUnion):
+                extra = 'const *'
+                ampersand = '&'
+            prnt(tp.get_c_name(' %s%s(void)' % (extra, funcname), name))
+            prnt('{')
+            prnt('  return (%s%s);' % (ampersand, name))
+            prnt('}')
+        prnt()
+
+    def _generate_gen_constant_decl(self, tp, name):
+        is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()
+        self._generate_gen_const(is_int, name, tp)
+
+    _loading_gen_constant = _loaded_noop
+
+    def _load_constant(self, is_int, tp, name, module, check_value=None):
+        funcname = '_cffi_const_%s' % name
+        if check_value is not None:
+            assert is_int
+            self._load_known_int_constant(module, funcname)
+            value = check_value
+        elif is_int:
+            BType = self.ffi._typeof_locked("long long*")[0]
+            BFunc = self.ffi._typeof_locked("int(*)(long long*)")[0]
+            function = module.load_function(BFunc, funcname)
+            p = self.ffi.new(BType)
+            negative = function(p)
+            value = int(p[0])
+            if value < 0 and not negative:
+                BLongLong = self.ffi._typeof_locked("long long")[0]
+                value += (1 << (8*self.ffi.sizeof(BLongLong)))
+        else:
+            assert check_value is None
+            fntypeextra = '(*)(void)'
+            if isinstance(tp, model.StructOrUnion):
+                fntypeextra = '*' + fntypeextra
+            BFunc = self.ffi._typeof_locked(tp.get_c_name(fntypeextra, name))[0]
+            function = module.load_function(BFunc, funcname)
+            value = function()
+            if isinstance(tp, model.StructOrUnion):
+                value = value[0]
+        return value
+
+    def _loaded_gen_constant(self, tp, name, module, library):
+        is_int = isinstance(tp, model.PrimitiveType) and tp.is_integer_type()
+        value = self._load_constant(is_int, tp, name, module)
+        setattr(library, name, value)
+        type(library)._cffi_dir.append(name)
+
+    # ----------
+    # enums
+
+    def _check_int_constant_value(self, name, value):
+        prnt = self._prnt
+        if value <= 0:
+            prnt('  if ((%s) > 0 || (long)(%s) != %dL) {' % (
+                name, name, value))
+        else:
+            prnt('  if ((%s) <= 0 || (unsigned long)(%s) != %dUL) {' % (
+                name, name, value))
+        prnt('    char buf[64];')
+        prnt('    if ((%s) <= 0)' % name)
+        prnt('        sprintf(buf, "%%ld", (long)(%s));' % name)
+        prnt('    else')
+        prnt('        sprintf(buf, "%%lu", (unsigned long)(%s));' %
+             name)
+        prnt('    sprintf(out_error, "%s has the real value %s, not %s",')
+        prnt('            "%s", buf, "%d");' % (name[:100], value))
+        prnt('    return -1;')
+        prnt('  }')
+
+    def _load_known_int_constant(self, module, funcname):
+        BType = self.ffi._typeof_locked("char[]")[0]
+        BFunc = self.ffi._typeof_locked("int(*)(char*)")[0]
+        function = module.load_function(BFunc, funcname)
+        p = self.ffi.new(BType, 256)
+        if function(p) < 0:
+            error = self.ffi.string(p)
+            if sys.version_info >= (3,):
+                error = str(error, 'utf-8')
+            raise VerificationError(error)
+
+    def _enum_funcname(self, prefix, name):
+        # "$enum_$1" => "___D_enum____D_1"
+        name = name.replace('$', '___D_')
+        return '_cffi_e_%s_%s' % (prefix, name)
+
+    def _generate_gen_enum_decl(self, tp, name, prefix='enum'):
+        if tp.partial:
+            for enumerator in tp.enumerators:
+                self._generate_gen_const(True, enumerator)
+            return
+        #
+        funcname = self._enum_funcname(prefix, name)
+        self.export_symbols.append(funcname)
+        prnt = self._prnt
+        prnt('int %s(char *out_error)' % funcname)
+        prnt('{')
+        for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):
+            self._check_int_constant_value(enumerator, enumvalue)
+        prnt('  return 0;')
+        prnt('}')
+        prnt()
+
+    def _loading_gen_enum(self, tp, name, module, prefix='enum'):
+        if tp.partial:
+            enumvalues = [self._load_constant(True, tp, enumerator, module)
+                          for enumerator in tp.enumerators]
+            tp.enumvalues = tuple(enumvalues)
+            tp.partial_resolved = True
+        else:
+            funcname = self._enum_funcname(prefix, name)
+            self._load_known_int_constant(module, funcname)
+
+    def _loaded_gen_enum(self, tp, name, module, library):
+        for enumerator, enumvalue in zip(tp.enumerators, tp.enumvalues):
+            setattr(library, enumerator, enumvalue)
+            type(library)._cffi_dir.append(enumerator)
+
+    # ----------
+    # macros: for now only for integers
+
+    def _generate_gen_macro_decl(self, tp, name):
+        if tp == '...':
+            check_value = None
+        else:
+            check_value = tp     # an integer
+        self._generate_gen_const(True, name, check_value=check_value)
+
+    _loading_gen_macro = _loaded_noop
+
+    def _loaded_gen_macro(self, tp, name, module, library):
+        if tp == '...':
+            check_value = None
+        else:
+            check_value = tp     # an integer
+        value = self._load_constant(True, tp, name, module,
+                                    check_value=check_value)
+        setattr(library, name, value)
+        type(library)._cffi_dir.append(name)
+
+    # ----------
+    # global variables
+
+    def _generate_gen_variable_decl(self, tp, name):
+        if isinstance(tp, model.ArrayType):
+            if tp.length_is_unknown():
+                prnt = self._prnt
+                funcname = '_cffi_sizeof_%s' % (name,)
+                self.export_symbols.append(funcname)
+                prnt("size_t %s(void)" % funcname)
+                prnt("{")
+                prnt("  return sizeof(%s);" % (name,))
+                prnt("}")
+            tp_ptr = model.PointerType(tp.item)
+            self._generate_gen_const(False, name, tp_ptr)
+        else:
+            tp_ptr = model.PointerType(tp)
+            self._generate_gen_const(False, name, tp_ptr, category='var')
+
+    _loading_gen_variable = _loaded_noop
+
+    def _loaded_gen_variable(self, tp, name, module, library):
+        if isinstance(tp, model.ArrayType):   # int a[5] is "constant" in the
+                                              # sense that "a=..." is forbidden
+            if tp.length_is_unknown():
+                funcname = '_cffi_sizeof_%s' % (name,)
+                BFunc = self.ffi._typeof_locked('size_t(*)(void)')[0]
+                function = module.load_function(BFunc, funcname)
+                size = function()
+                BItemType = self.ffi._get_cached_btype(tp.item)
+                length, rest = divmod(size, self.ffi.sizeof(BItemType))
+                if rest != 0:
+                    raise VerificationError(
+                        "bad size: %r does not seem to be an array of %s" %
+                        (name, tp.item))
+                tp = tp.resolve_length(length)
+            tp_ptr = model.PointerType(tp.item)
+            value = self._load_constant(False, tp_ptr, name, module)
+            # 'value' is a <cdata 'type *'> which we have to replace with
+            # a <cdata 'type[N]'> if the N is actually known
+            if tp.length is not None:
+                BArray = self.ffi._get_cached_btype(tp)
+                value = self.ffi.cast(BArray, value)
+            setattr(library, name, value)
+            type(library)._cffi_dir.append(name)
+            return
+        # remove ptr=<cdata 'int *'> from the library instance, and replace
+        # it by a property on the class, which reads/writes into ptr[0].
+        funcname = '_cffi_var_%s' % name
+        BFunc = self.ffi._typeof_locked(tp.get_c_name('*(*)(void)', name))[0]
+        function = module.load_function(BFunc, funcname)
+        ptr = function()
+        def getter(library):
+            return ptr[0]
+        def setter(library, value):
+            ptr[0] = value
+        setattr(type(library), name, property(getter, setter))
+        type(library)._cffi_dir.append(name)
+
+cffimod_header = r'''
+#include <stdio.h>
+#include <stddef.h>
+#include <stdarg.h>
+#include <errno.h>
+#include <sys/types.h>   /* XXX for ssize_t on some platforms */
+
+/* this block of #ifs should be kept exactly identical between
+   c/_cffi_backend.c, cffi/vengine_cpy.py, cffi/vengine_gen.py
+   and cffi/_cffi_include.h */
+#if defined(_MSC_VER)
+# include <malloc.h>   /* for alloca() */
+# if _MSC_VER < 1600   /* MSVC < 2010 */
+   typedef __int8 int8_t;
+   typedef __int16 int16_t;
+   typedef __int32 int32_t;
+   typedef __int64 int64_t;
+   typedef unsigned __int8 uint8_t;
+   typedef unsigned __int16 uint16_t;
+   typedef unsigned __int32 uint32_t;
+   typedef unsigned __int64 uint64_t;
+   typedef __int8 int_least8_t;
+   typedef __int16 int_least16_t;
+   typedef __int32 int_least32_t;
+   typedef __int64 int_least64_t;
+   typedef unsigned __int8 uint_least8_t;
+   typedef unsigned __int16 uint_least16_t;
+   typedef unsigned __int32 uint_least32_t;
+   typedef unsigned __int64 uint_least64_t;
+   typedef __int8 int_fast8_t;
+   typedef __int16 int_fast16_t;
+   typedef __int32 int_fast32_t;
+   typedef __int64 int_fast64_t;
+   typedef unsigned __int8 uint_fast8_t;
+   typedef unsigned __int16 uint_fast16_t;
+   typedef unsigned __int32 uint_fast32_t;
+   typedef unsigned __int64 uint_fast64_t;
+   typedef __int64 intmax_t;
+   typedef unsigned __int64 uintmax_t;
+# else
+#  include <stdint.h>
+# endif
+# if _MSC_VER < 1800   /* MSVC < 2013 */
+#  ifndef __cplusplus
+    typedef unsigned char _Bool;
+#  endif
+# endif
+#else
+# include <stdint.h>
+# if (defined (__SVR4) && defined (__sun)) || defined(_AIX) || defined(__hpux)
+#  include <alloca.h>
+# endif
+#endif
+'''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/verifier.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/verifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..59b78c216f36044501f7443955cfac3782885529
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/cffi/verifier.py
@@ -0,0 +1,306 @@
+#
+# DEPRECATED: implementation for ffi.verify()
+#
+import sys, os, binascii, shutil, io
+from . import __version_verifier_modules__
+from . import ffiplatform
+from .error import VerificationError
+
+if sys.version_info >= (3, 3):
+    import importlib.machinery
+    def _extension_suffixes():
+        return importlib.machinery.EXTENSION_SUFFIXES[:]
+else:
+    import imp
+    def _extension_suffixes():
+        return [suffix for suffix, _, type in imp.get_suffixes()
+                if type == imp.C_EXTENSION]
+
+
+if sys.version_info >= (3,):
+    NativeIO = io.StringIO
+else:
+    class NativeIO(io.BytesIO):
+        def write(self, s):
+            if isinstance(s, unicode):
+                s = s.encode('ascii')
+            super(NativeIO, self).write(s)
+
+
+class Verifier(object):
+
+    def __init__(self, ffi, preamble, tmpdir=None, modulename=None,
+                 ext_package=None, tag='', force_generic_engine=False,
+                 source_extension='.c', flags=None, relative_to=None, **kwds):
+        if ffi._parser._uses_new_feature:
+            raise VerificationError(
+                "feature not supported with ffi.verify(), but only "
+                "with ffi.set_source(): %s" % (ffi._parser._uses_new_feature,))
+        self.ffi = ffi
+        self.preamble = preamble
+        if not modulename:
+            flattened_kwds = ffiplatform.flatten(kwds)
+        vengine_class = _locate_engine_class(ffi, force_generic_engine)
+        self._vengine = vengine_class(self)
+        self._vengine.patch_extension_kwds(kwds)
+        self.flags = flags
+        self.kwds = self.make_relative_to(kwds, relative_to)
+        #
+        if modulename:
+            if tag:
+                raise TypeError("can't specify both 'modulename' and 'tag'")
+        else:
+            key = '\x00'.join([sys.version[:3], __version_verifier_modules__,
+                               preamble, flattened_kwds] +
+                              ffi._cdefsources)
+            if sys.version_info >= (3,):
+                key = key.encode('utf-8')
+            k1 = hex(binascii.crc32(key[0::2]) & 0xffffffff)
+            k1 = k1.lstrip('0x').rstrip('L')
+            k2 = hex(binascii.crc32(key[1::2]) & 0xffffffff)
+            k2 = k2.lstrip('0').rstrip('L')
+            modulename = '_cffi_%s_%s%s%s' % (tag, self._vengine._class_key,
+                                              k1, k2)
+        suffix = _get_so_suffixes()[0]
+        self.tmpdir = tmpdir or _caller_dir_pycache()
+        self.sourcefilename = os.path.join(self.tmpdir, modulename + source_extension)
+        self.modulefilename = os.path.join(self.tmpdir, modulename + suffix)
+        self.ext_package = ext_package
+        self._has_source = False
+        self._has_module = False
+
+    def write_source(self, file=None):
+        """Write the C source code.  It is produced in 'self.sourcefilename',
+        which can be tweaked beforehand."""
+        with self.ffi._lock:
+            if self._has_source and file is None:
+                raise VerificationError(
+                    "source code already written")
+            self._write_source(file)
+
+    def compile_module(self):
+        """Write the C source code (if not done already) and compile it.
+        This produces a dynamic link library in 'self.modulefilename'."""
+        with self.ffi._lock:
+            if self._has_module:
+                raise VerificationError("module already compiled")
+            if not self._has_source:
+                self._write_source()
+            self._compile_module()
+
+    def load_library(self):
+        """Get a C module from this Verifier instance.
+        Returns an instance of a FFILibrary class that behaves like the
+        objects returned by ffi.dlopen(), but that delegates all
+        operations to the C module.  If necessary, the C code is written
+        and compiled first.
+        """
+        with self.ffi._lock:
+            if not self._has_module:
+                self._locate_module()
+                if not self._has_module:
+                    if not self._has_source:
+                        self._write_source()
+                    self._compile_module()
+            return self._load_library()
+
+    def get_module_name(self):
+        basename = os.path.basename(self.modulefilename)
+        # kill both the .so extension and the other .'s, as introduced
+        # by Python 3: 'basename.cpython-33m.so'
+        basename = basename.split('.', 1)[0]
+        # and the _d added in Python 2 debug builds --- but try to be
+        # conservative and not kill a legitimate _d
+        if basename.endswith('_d') and hasattr(sys, 'gettotalrefcount'):
+            basename = basename[:-2]
+        return basename
+
+    def get_extension(self):
+        ffiplatform._hack_at_distutils() # backward compatibility hack
+        if not self._has_source:
+            with self.ffi._lock:
+                if not self._has_source:
+                    self._write_source()
+        sourcename = ffiplatform.maybe_relative_path(self.sourcefilename)
+        modname = self.get_module_name()
+        return ffiplatform.get_extension(sourcename, modname, **self.kwds)
+
+    def generates_python_module(self):
+        return self._vengine._gen_python_module
+
+    def make_relative_to(self, kwds, relative_to):
+        if relative_to and os.path.dirname(relative_to):
+            dirname = os.path.dirname(relative_to)
+            kwds = kwds.copy()
+            for key in ffiplatform.LIST_OF_FILE_NAMES:
+                if key in kwds:
+                    lst = kwds[key]
+                    if not isinstance(lst, (list, tuple)):
+                        raise TypeError("keyword '%s' should be a list or tuple"
+                                        % (key,))
+                    lst = [os.path.join(dirname, fn) for fn in lst]
+                    kwds[key] = lst
+        return kwds
+
+    # ----------
+
+    def _locate_module(self):
+        if not os.path.isfile(self.modulefilename):
+            if self.ext_package:
+                try:
+                    pkg = __import__(self.ext_package, None, None, ['__doc__'])
+                except ImportError:
+                    return      # cannot import the package itself, give up
+                    # (e.g. it might be called differently before installation)
+                path = pkg.__path__
+            else:
+                path = None
+            filename = self._vengine.find_module(self.get_module_name(), path,
+                                                 _get_so_suffixes())
+            if filename is None:
+                return
+            self.modulefilename = filename
+        self._vengine.collect_types()
+        self._has_module = True
+
+    def _write_source_to(self, file):
+        self._vengine._f = file
+        try:
+            self._vengine.write_source_to_f()
+        finally:
+            del self._vengine._f
+
+    def _write_source(self, file=None):
+        if file is not None:
+            self._write_source_to(file)
+        else:
+            # Write our source file to an in memory file.
+            f = NativeIO()
+            self._write_source_to(f)
+            source_data = f.getvalue()
+
+            # Determine if this matches the current file
+            if os.path.exists(self.sourcefilename):
+                with open(self.sourcefilename, "r") as fp:
+                    needs_written = not (fp.read() == source_data)
+            else:
+                needs_written = True
+
+            # Actually write the file out if it doesn't match
+            if needs_written:
+                _ensure_dir(self.sourcefilename)
+                with open(self.sourcefilename, "w") as fp:
+                    fp.write(source_data)
+
+            # Set this flag
+            self._has_source = True
+
+    def _compile_module(self):
+        # compile this C source
+        tmpdir = os.path.dirname(self.sourcefilename)
+        outputfilename = ffiplatform.compile(tmpdir, self.get_extension())
+        try:
+            same = ffiplatform.samefile(outputfilename, self.modulefilename)
+        except OSError:
+            same = False
+        if not same:
+            _ensure_dir(self.modulefilename)
+            shutil.move(outputfilename, self.modulefilename)
+        self._has_module = True
+
+    def _load_library(self):
+        assert self._has_module
+        if self.flags is not None:
+            return self._vengine.load_library(self.flags)
+        else:
+            return self._vengine.load_library()
+
+# ____________________________________________________________
+
+_FORCE_GENERIC_ENGINE = False      # for tests
+
+def _locate_engine_class(ffi, force_generic_engine):
+    if _FORCE_GENERIC_ENGINE:
+        force_generic_engine = True
+    if not force_generic_engine:
+        if '__pypy__' in sys.builtin_module_names:
+            force_generic_engine = True
+        else:
+            try:
+                import _cffi_backend
+            except ImportError:
+                _cffi_backend = '?'
+            if ffi._backend is not _cffi_backend:
+                force_generic_engine = True
+    if force_generic_engine:
+        from . import vengine_gen
+        return vengine_gen.VGenericEngine
+    else:
+        from . import vengine_cpy
+        return vengine_cpy.VCPythonEngine
+
+# ____________________________________________________________
+
+_TMPDIR = None
+
+def _caller_dir_pycache():
+    if _TMPDIR:
+        return _TMPDIR
+    result = os.environ.get('CFFI_TMPDIR')
+    if result:
+        return result
+    filename = sys._getframe(2).f_code.co_filename
+    return os.path.abspath(os.path.join(os.path.dirname(filename),
+                           '__pycache__'))
+
+def set_tmpdir(dirname):
+    """Set the temporary directory to use instead of __pycache__."""
+    global _TMPDIR
+    _TMPDIR = dirname
+
+def cleanup_tmpdir(tmpdir=None, keep_so=False):
+    """Clean up the temporary directory by removing all files in it
+    called `_cffi_*.{c,so}` as well as the `build` subdirectory."""
+    tmpdir = tmpdir or _caller_dir_pycache()
+    try:
+        filelist = os.listdir(tmpdir)
+    except OSError:
+        return
+    if keep_so:
+        suffix = '.c'   # only remove .c files
+    else:
+        suffix = _get_so_suffixes()[0].lower()
+    for fn in filelist:
+        if fn.lower().startswith('_cffi_') and (
+                fn.lower().endswith(suffix) or fn.lower().endswith('.c')):
+            try:
+                os.unlink(os.path.join(tmpdir, fn))
+            except OSError:
+                pass
+    clean_dir = [os.path.join(tmpdir, 'build')]
+    for dir in clean_dir:
+        try:
+            for fn in os.listdir(dir):
+                fn = os.path.join(dir, fn)
+                if os.path.isdir(fn):
+                    clean_dir.append(fn)
+                else:
+                    os.unlink(fn)
+        except OSError:
+            pass
+
+def _get_so_suffixes():
+    suffixes = _extension_suffixes()
+    if not suffixes:
+        # bah, no C_EXTENSION available.  Occurs on pypy without cpyext
+        if sys.platform == 'win32':
+            suffixes = [".pyd"]
+        else:
+            suffixes = [".so"]
+
+    return suffixes
+
+def _ensure_dir(filename):
+    dirname = os.path.dirname(filename)
+    if dirname and not os.path.isdir(dirname):
+        os.makedirs(dirname)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f1f13a85571a799a7fd2d62cc1b96b0e0689d052
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/METADATA
@@ -0,0 +1,98 @@
+Metadata-Version: 2.1
+Name: chardet
+Version: 3.0.4
+Summary: Universal encoding detector for Python 2 and 3
+Home-page: https://github.com/chardet/chardet
+Author: Mark Pilgrim
+Author-email: mark@diveintomark.org
+Maintainer: Daniel Blanchard
+Maintainer-email: dan.blanchard@gmail.com
+License: LGPL
+Keywords: encoding,i18n,xml
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Linguistic
+
+Chardet: The Universal Character Encoding Detector
+--------------------------------------------------
+
+.. image:: https://img.shields.io/travis/chardet/chardet/stable.svg
+   :alt: Build status
+   :target: https://travis-ci.org/chardet/chardet
+
+.. image:: https://img.shields.io/coveralls/chardet/chardet/stable.svg
+   :target: https://coveralls.io/r/chardet/chardet
+
+.. image:: https://img.shields.io/pypi/v/chardet.svg
+   :target: https://warehouse.python.org/project/chardet/
+   :alt: Latest version on PyPI
+
+.. image:: https://img.shields.io/pypi/l/chardet.svg
+   :alt: License
+
+
+Detects
+ - ASCII, UTF-8, UTF-16 (2 variants), UTF-32 (4 variants)
+ - Big5, GB2312, EUC-TW, HZ-GB-2312, ISO-2022-CN (Traditional and Simplified Chinese)
+ - EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP (Japanese)
+ - EUC-KR, ISO-2022-KR (Korean)
+ - KOI8-R, MacCyrillic, IBM855, IBM866, ISO-8859-5, windows-1251 (Cyrillic)
+ - ISO-8859-5, windows-1251 (Bulgarian)
+ - ISO-8859-1, windows-1252 (Western European languages)
+ - ISO-8859-7, windows-1253 (Greek)
+ - ISO-8859-8, windows-1255 (Visual and Logical Hebrew)
+ - TIS-620 (Thai)
+
+.. note::
+   Our ISO-8859-2 and windows-1250 (Hungarian) probers have been temporarily
+   disabled until we can retrain the models.
+
+Requires Python 2.6, 2.7, or 3.3+.
+
+Installation
+------------
+
+Install from `PyPI <https://pypi.python.org/pypi/chardet>`_::
+
+    pip install chardet
+
+Documentation
+-------------
+
+For users, docs are now available at https://chardet.readthedocs.io/.
+
+Command-line Tool
+-----------------
+
+chardet comes with a command-line script which reports on the encodings of one
+or more files::
+
+    % chardetect somefile someotherfile
+    somefile: windows-1252 with confidence 0.5
+    someotherfile: ascii with confidence 1.0
+
+About
+-----
+
+This is a continuation of Mark Pilgrim's excellent chardet. Previously, two
+versions needed to be maintained: one that supported python 2.x and one that
+supported python 3.x.  We've recently merged with `Ian Cordasco <https://github.com/sigmavirus24>`_'s
+`charade <https://github.com/sigmavirus24/charade>`_ fork, so now we have one
+coherent version that works for Python 2.6+.
+
+:maintainer: Dan Blanchard
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..03310b99907c5e4b600ffb99dd63a89415a44485
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/RECORD
@@ -0,0 +1,97 @@
+chardet/__init__.py,sha256=YsP5wQlsHJ2auF1RZJfypiSrCA7_bQiRm3ES_NI76-Y,1559
+chardet/big5freq.py,sha256=D_zK5GyzoVsRes0HkLJziltFQX0bKCLOrFe9_xDvO_8,31254
+chardet/big5prober.py,sha256=kBxHbdetBpPe7xrlb-e990iot64g_eGSLd32lB7_h3M,1757
+chardet/chardistribution.py,sha256=3woWS62KrGooKyqz4zQSnjFbJpa6V7g02daAibTwcl8,9411
+chardet/charsetgroupprober.py,sha256=6bDu8YIiRuScX4ca9Igb0U69TA2PGXXDej6Cc4_9kO4,3787
+chardet/charsetprober.py,sha256=KSmwJErjypyj0bRZmC5F5eM7c8YQgLYIjZXintZNstg,5110
+chardet/codingstatemachine.py,sha256=VYp_6cyyki5sHgXDSZnXW4q1oelHc3cu9AyQTX7uug8,3590
+chardet/compat.py,sha256=PKTzHkSbtbHDqS9PyujMbX74q1a8mMpeQTDVsQhZMRw,1134
+chardet/cp949prober.py,sha256=TZ434QX8zzBsnUvL_8wm4AQVTZ2ZkqEEQL_lNw9f9ow,1855
+chardet/enums.py,sha256=Aimwdb9as1dJKZaFNUH2OhWIVBVd6ZkJJ_WK5sNY8cU,1661
+chardet/escprober.py,sha256=kkyqVg1Yw3DIOAMJ2bdlyQgUFQhuHAW8dUGskToNWSc,3950
+chardet/escsm.py,sha256=RuXlgNvTIDarndvllNCk5WZBIpdCxQ0kcd9EAuxUh84,10510
+chardet/eucjpprober.py,sha256=iD8Jdp0ISRjgjiVN7f0e8xGeQJ5GM2oeZ1dA8nbSeUw,3749
+chardet/euckrfreq.py,sha256=-7GdmvgWez4-eO4SuXpa7tBiDi5vRXQ8WvdFAzVaSfo,13546
+chardet/euckrprober.py,sha256=MqFMTQXxW4HbzIpZ9lKDHB3GN8SP4yiHenTmf8g_PxY,1748
+chardet/euctwfreq.py,sha256=No1WyduFOgB5VITUA7PLyC5oJRNzRyMbBxaKI1l16MA,31621
+chardet/euctwprober.py,sha256=13p6EP4yRaxqnP4iHtxHOJ6R2zxHq1_m8hTRjzVZ95c,1747
+chardet/gb2312freq.py,sha256=JX8lsweKLmnCwmk8UHEQsLgkr_rP_kEbvivC4qPOrlc,20715
+chardet/gb2312prober.py,sha256=gGvIWi9WhDjE-xQXHvNIyrnLvEbMAYgyUSZ65HUfylw,1754
+chardet/hebrewprober.py,sha256=c3SZ-K7hvyzGY6JRAZxJgwJ_sUS9k0WYkvMY00YBYFo,13838
+chardet/jisfreq.py,sha256=vpmJv2Bu0J8gnMVRPHMFefTRvo_ha1mryLig8CBwgOg,25777
+chardet/jpcntx.py,sha256=PYlNqRUQT8LM3cT5FmHGP0iiscFlTWED92MALvBungo,19643
+chardet/langbulgarianmodel.py,sha256=1HqQS9Pbtnj1xQgxitJMvw8X6kKr5OockNCZWfEQrPE,12839
+chardet/langcyrillicmodel.py,sha256=LODajvsetH87yYDDQKA2CULXUH87tI223dhfjh9Zx9c,17948
+chardet/langgreekmodel.py,sha256=8YAW7bU8YwSJap0kIJSbPMw1BEqzGjWzqcqf0WgUKAA,12688
+chardet/langhebrewmodel.py,sha256=JSnqmE5E62tDLTPTvLpQsg5gOMO4PbdWRvV7Avkc0HA,11345
+chardet/langhungarianmodel.py,sha256=RhapYSG5l0ZaO-VV4Fan5sW0WRGQqhwBM61yx3yxyOA,12592
+chardet/langthaimodel.py,sha256=8l0173Gu_W6G8mxmQOTEF4ls2YdE7FxWf3QkSxEGXJQ,11290
+chardet/langturkishmodel.py,sha256=W22eRNJsqI6uWAfwXSKVWWnCerYqrI8dZQTm_M0lRFk,11102
+chardet/latin1prober.py,sha256=S2IoORhFk39FEFOlSFWtgVybRiP6h7BlLldHVclNkU8,5370
+chardet/mbcharsetprober.py,sha256=AR95eFH9vuqSfvLQZN-L5ijea25NOBCoXqw8s5O9xLQ,3413
+chardet/mbcsgroupprober.py,sha256=h6TRnnYq2OxG1WdD5JOyxcdVpn7dG0q-vB8nWr5mbh4,2012
+chardet/mbcssm.py,sha256=SY32wVIF3HzcjY3BaEspy9metbNSKxIIB0RKPn7tjpI,25481
+chardet/sbcharsetprober.py,sha256=LDSpCldDCFlYwUkGkwD2oFxLlPWIWXT09akH_2PiY74,5657
+chardet/sbcsgroupprober.py,sha256=1IprcCB_k1qfmnxGC6MBbxELlKqD3scW6S8YIwdeyXA,3546
+chardet/sjisprober.py,sha256=IIt-lZj0WJqK4rmUZzKZP4GJlE8KUEtFYVuY96ek5MQ,3774
+chardet/universaldetector.py,sha256=qL0174lSZE442eB21nnktT9_VcAye07laFWUeUrjttY,12485
+chardet/utf8prober.py,sha256=IdD8v3zWOsB8OLiyPi-y_fqwipRFxV9Nc1eKBLSuIEw,2766
+chardet/version.py,sha256=sp3B08mrDXB-pf3K9fqJ_zeDHOCLC8RrngQyDFap_7g,242
+chardet/cli/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+chardet/cli/chardetect.py,sha256=YBO8L4mXo0WR6_-Fjh_8QxPBoEBNqB9oNxNrdc54AQs,2738
+chardet-3.0.4.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+chardet-3.0.4.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+chardet-3.0.4.dist-info/METADATA,sha256=o6XNN41EUioeDnklH1-8haOSjI60AkAaI823ANFkOM4,3304
+chardet-3.0.4.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+chardet-3.0.4.dist-info/entry_points.txt,sha256=fAMmhu5eJ-zAJ-smfqQwRClQ3-nozOCmvJ6-E8lgGJo,60
+chardet-3.0.4.dist-info/top_level.txt,sha256=AowzBbZy4x8EirABDdJSLJZMkJ_53iIag8xfKR6D7kI,8
+chardet-3.0.4.dist-info/RECORD,,
+chardet/euctwprober.cpython-38.pyc,,
+chardet/charsetgroupprober.cpython-38.pyc,,
+chardet/hebrewprober.cpython-38.pyc,,
+chardet/cp949prober.cpython-38.pyc,,
+chardet/__pycache__,,
+chardet/sjisprober.cpython-38.pyc,,
+chardet/big5prober.cpython-38.pyc,,
+chardet-3.0.4.virtualenv,,
+chardet/euckrfreq.cpython-38.pyc,,
+chardet/charsetprober.cpython-38.pyc,,
+chardet/cli/__pycache__,,
+chardet/gb2312prober.cpython-38.pyc,,
+../../../bin/chardetect-3.8,,
+chardet/cli/chardetect.cpython-38.pyc,,
+chardet/eucjpprober.cpython-38.pyc,,
+chardet/jisfreq.cpython-38.pyc,,
+chardet/codingstatemachine.cpython-38.pyc,,
+chardet/chardistribution.cpython-38.pyc,,
+chardet/universaldetector.cpython-38.pyc,,
+chardet/escprober.cpython-38.pyc,,
+chardet/langcyrillicmodel.cpython-38.pyc,,
+chardet/mbcsgroupprober.cpython-38.pyc,,
+chardet/escsm.cpython-38.pyc,,
+chardet-3.0.4.dist-info/__pycache__,,
+chardet/sbcsgroupprober.cpython-38.pyc,,
+chardet/langturkishmodel.cpython-38.pyc,,
+chardet/latin1prober.cpython-38.pyc,,
+chardet/compat.cpython-38.pyc,,
+chardet/__init__.cpython-38.pyc,,
+chardet/langhungarianmodel.cpython-38.pyc,,
+chardet/utf8prober.cpython-38.pyc,,
+chardet/langhebrewmodel.cpython-38.pyc,,
+chardet/langgreekmodel.cpython-38.pyc,,
+chardet/big5freq.cpython-38.pyc,,
+chardet/mbcssm.cpython-38.pyc,,
+../../../bin/chardetect3,,
+chardet/langbulgarianmodel.cpython-38.pyc,,
+chardet/jpcntx.cpython-38.pyc,,
+chardet/sbcharsetprober.cpython-38.pyc,,
+../../../bin/chardetect,,
+chardet-3.0.4.dist-info/INSTALLER,,
+chardet/cli/__init__.cpython-38.pyc,,
+chardet/euckrprober.cpython-38.pyc,,
+chardet/gb2312freq.cpython-38.pyc,,
+chardet/enums.cpython-38.pyc,,
+chardet/langthaimodel.cpython-38.pyc,,
+chardet/version.cpython-38.pyc,,
+chardet/euctwfreq.cpython-38.pyc,,
+chardet/mbcharsetprober.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a884269e7fc0d5f0cd96ba63c8d473c6560264b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+chardetect = chardet.cli.chardetect:main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..79236f25cda563eb57cd7b5838256d9f3fdf18ab
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.dist-info/top_level.txt
@@ -0,0 +1 @@
+chardet
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet-3.0.4.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0f9f820ef6e5f21042efd0e9dc18d097388d7207
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/__init__.py
@@ -0,0 +1,39 @@
+######################## BEGIN LICENSE BLOCK ########################
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+
+from .compat import PY2, PY3
+from .universaldetector import UniversalDetector
+from .version import __version__, VERSION
+
+
+def detect(byte_str):
+    """
+    Detect the encoding of the given byte string.
+
+    :param byte_str:     The byte sequence to examine.
+    :type byte_str:      ``bytes`` or ``bytearray``
+    """
+    if not isinstance(byte_str, bytearray):
+        if not isinstance(byte_str, bytes):
+            raise TypeError('Expected object of type bytes or bytearray, got: '
+                            '{0}'.format(type(byte_str)))
+        else:
+            byte_str = bytearray(byte_str)
+    detector = UniversalDetector()
+    detector.feed(byte_str)
+    return detector.close()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5freq.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5freq.py
new file mode 100644
index 0000000000000000000000000000000000000000..38f32517aa8f6cf5970f7ceddd1a415289184c3e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5freq.py
@@ -0,0 +1,386 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Big5 frequency table
+# by Taiwan's Mandarin Promotion Council
+# <http://www.edu.tw:81/mandr/>
+#
+# 128  --> 0.42261
+# 256  --> 0.57851
+# 512  --> 0.74851
+# 1024 --> 0.89384
+# 2048 --> 0.97583
+#
+# Ideal Distribution Ratio = 0.74851/(1-0.74851) =2.98
+# Random Distribution Ration = 512/(5401-512)=0.105
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR
+
+BIG5_TYPICAL_DISTRIBUTION_RATIO = 0.75
+
+#Char to FreqOrder table
+BIG5_TABLE_SIZE = 5376
+
+BIG5_CHAR_TO_FREQ_ORDER = (
+   1,1801,1506, 255,1431, 198,   9,  82,   6,5008, 177, 202,3681,1256,2821, 110, #   16
+3814,  33,3274, 261,  76,  44,2114,  16,2946,2187,1176, 659,3971,  26,3451,2653, #   32
+1198,3972,3350,4202, 410,2215, 302, 590, 361,1964,   8, 204,  58,4510,5009,1932, #   48
+  63,5010,5011, 317,1614,  75, 222, 159,4203,2417,1480,5012,3555,3091, 224,2822, #   64
+3682,   3,  10,3973,1471,  29,2787,1135,2866,1940, 873, 130,3275,1123, 312,5013, #   80
+4511,2052, 507, 252, 682,5014, 142,1915, 124, 206,2947,  34,3556,3204,  64, 604, #   96
+5015,2501,1977,1978, 155,1991, 645, 641,1606,5016,3452, 337,  72, 406,5017,  80, #  112
+ 630, 238,3205,1509, 263, 939,1092,2654, 756,1440,1094,3453, 449,  69,2987, 591, #  128
+ 179,2096, 471, 115,2035,1844,  60,  50,2988, 134, 806,1869, 734,2036,3454, 180, #  144
+ 995,1607, 156, 537,2907, 688,5018, 319,1305, 779,2145, 514,2379, 298,4512, 359, #  160
+2502,  90,2716,1338, 663,  11, 906,1099,2553,  20,2441, 182, 532,1716,5019, 732, #  176
+1376,4204,1311,1420,3206,  25,2317,1056, 113, 399, 382,1950, 242,3455,2474, 529, #  192
+3276, 475,1447,3683,5020, 117,  21, 656, 810,1297,2300,2334,3557,5021, 126,4205, #  208
+ 706, 456, 150, 613,4513,  71,1118,2037,4206, 145,3092,  85, 835, 486,2115,1246, #  224
+1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,5022,2128,2359, 347,3815, 221, #  240
+3558,3135,5023,1956,1153,4207,  83, 296,1199,3093, 192, 624,  93,5024, 822,1898, #  256
+2823,3136, 795,2065, 991,1554,1542,1592,  27,  43,2867, 859, 139,1456, 860,4514, #  272
+ 437, 712,3974, 164,2397,3137, 695, 211,3037,2097, 195,3975,1608,3559,3560,3684, #  288
+3976, 234, 811,2989,2098,3977,2233,1441,3561,1615,2380, 668,2077,1638, 305, 228, #  304
+1664,4515, 467, 415,5025, 262,2099,1593, 239, 108, 300, 200,1033, 512,1247,2078, #  320
+5026,5027,2176,3207,3685,2682, 593, 845,1062,3277,  88,1723,2038,3978,1951, 212, #  336
+ 266, 152, 149, 468,1899,4208,4516,  77, 187,5028,3038,  37,   5,2990,5029,3979, #  352
+5030,5031,  39,2524,4517,2908,3208,2079,  55, 148,  74,4518, 545, 483,1474,1029, #  368
+1665, 217,1870,1531,3138,1104,2655,4209,  24, 172,3562, 900,3980,3563,3564,4519, #  384
+  32,1408,2824,1312, 329, 487,2360,2251,2717, 784,2683,   4,3039,3351,1427,1789, #  400
+ 188, 109, 499,5032,3686,1717,1790, 888,1217,3040,4520,5033,3565,5034,3352,1520, #  416
+3687,3981, 196,1034, 775,5035,5036, 929,1816, 249, 439,  38,5037,1063,5038, 794, #  432
+3982,1435,2301,  46, 178,3278,2066,5039,2381,5040, 214,1709,4521, 804,  35, 707, #  448
+ 324,3688,1601,2554, 140, 459,4210,5041,5042,1365, 839, 272, 978,2262,2580,3456, #  464
+2129,1363,3689,1423, 697, 100,3094,  48,  70,1231, 495,3139,2196,5043,1294,5044, #  480
+2080, 462, 586,1042,3279, 853, 256, 988, 185,2382,3457,1698, 434,1084,5045,3458, #  496
+ 314,2625,2788,4522,2335,2336, 569,2285, 637,1817,2525, 757,1162,1879,1616,3459, #  512
+ 287,1577,2116, 768,4523,1671,2868,3566,2526,1321,3816, 909,2418,5046,4211, 933, #  528
+3817,4212,2053,2361,1222,4524, 765,2419,1322, 786,4525,5047,1920,1462,1677,2909, #  544
+1699,5048,4526,1424,2442,3140,3690,2600,3353,1775,1941,3460,3983,4213, 309,1369, #  560
+1130,2825, 364,2234,1653,1299,3984,3567,3985,3986,2656, 525,1085,3041, 902,2001, #  576
+1475, 964,4527, 421,1845,1415,1057,2286, 940,1364,3141, 376,4528,4529,1381,   7, #  592
+2527, 983,2383, 336,1710,2684,1846, 321,3461, 559,1131,3042,2752,1809,1132,1313, #  608
+ 265,1481,1858,5049, 352,1203,2826,3280, 167,1089, 420,2827, 776, 792,1724,3568, #  624
+4214,2443,3281,5050,4215,5051, 446, 229, 333,2753, 901,3818,1200,1557,4530,2657, #  640
+1921, 395,2754,2685,3819,4216,1836, 125, 916,3209,2626,4531,5052,5053,3820,5054, #  656
+5055,5056,4532,3142,3691,1133,2555,1757,3462,1510,2318,1409,3569,5057,2146, 438, #  672
+2601,2910,2384,3354,1068, 958,3043, 461, 311,2869,2686,4217,1916,3210,4218,1979, #  688
+ 383, 750,2755,2627,4219, 274, 539, 385,1278,1442,5058,1154,1965, 384, 561, 210, #  704
+  98,1295,2556,3570,5059,1711,2420,1482,3463,3987,2911,1257, 129,5060,3821, 642, #  720
+ 523,2789,2790,2658,5061, 141,2235,1333,  68, 176, 441, 876, 907,4220, 603,2602, #  736
+ 710, 171,3464, 404, 549,  18,3143,2398,1410,3692,1666,5062,3571,4533,2912,4534, #  752
+5063,2991, 368,5064, 146, 366,  99, 871,3693,1543, 748, 807,1586,1185,  22,2263, #  768
+ 379,3822,3211,5065,3212, 505,1942,2628,1992,1382,2319,5066, 380,2362, 218, 702, #  784
+1818,1248,3465,3044,3572,3355,3282,5067,2992,3694, 930,3283,3823,5068,  59,5069, #  800
+ 585, 601,4221, 497,3466,1112,1314,4535,1802,5070,1223,1472,2177,5071, 749,1837, #  816
+ 690,1900,3824,1773,3988,1476, 429,1043,1791,2236,2117, 917,4222, 447,1086,1629, #  832
+5072, 556,5073,5074,2021,1654, 844,1090, 105, 550, 966,1758,2828,1008,1783, 686, #  848
+1095,5075,2287, 793,1602,5076,3573,2603,4536,4223,2948,2302,4537,3825, 980,2503, #  864
+ 544, 353, 527,4538, 908,2687,2913,5077, 381,2629,1943,1348,5078,1341,1252, 560, #  880
+3095,5079,3467,2870,5080,2054, 973, 886,2081, 143,4539,5081,5082, 157,3989, 496, #  896
+4224,  57, 840, 540,2039,4540,4541,3468,2118,1445, 970,2264,1748,1966,2082,4225, #  912
+3144,1234,1776,3284,2829,3695, 773,1206,2130,1066,2040,1326,3990,1738,1725,4226, #  928
+ 279,3145,  51,1544,2604, 423,1578,2131,2067, 173,4542,1880,5083,5084,1583, 264, #  944
+ 610,3696,4543,2444, 280, 154,5085,5086,5087,1739, 338,1282,3096, 693,2871,1411, #  960
+1074,3826,2445,5088,4544,5089,5090,1240, 952,2399,5091,2914,1538,2688, 685,1483, #  976
+4227,2475,1436, 953,4228,2055,4545, 671,2400,  79,4229,2446,3285, 608, 567,2689, #  992
+3469,4230,4231,1691, 393,1261,1792,2401,5092,4546,5093,5094,5095,5096,1383,1672, # 1008
+3827,3213,1464, 522,1119, 661,1150, 216, 675,4547,3991,1432,3574, 609,4548,2690, # 1024
+2402,5097,5098,5099,4232,3045,   0,5100,2476, 315, 231,2447, 301,3356,4549,2385, # 1040
+5101, 233,4233,3697,1819,4550,4551,5102,  96,1777,1315,2083,5103, 257,5104,1810, # 1056
+3698,2718,1139,1820,4234,2022,1124,2164,2791,1778,2659,5105,3097, 363,1655,3214, # 1072
+5106,2993,5107,5108,5109,3992,1567,3993, 718, 103,3215, 849,1443, 341,3357,2949, # 1088
+1484,5110,1712, 127,  67, 339,4235,2403, 679,1412, 821,5111,5112, 834, 738, 351, # 1104
+2994,2147, 846, 235,1497,1881, 418,1993,3828,2719, 186,1100,2148,2756,3575,1545, # 1120
+1355,2950,2872,1377, 583,3994,4236,2581,2995,5113,1298,3699,1078,2557,3700,2363, # 1136
+  78,3829,3830, 267,1289,2100,2002,1594,4237, 348, 369,1274,2197,2178,1838,4552, # 1152
+1821,2830,3701,2757,2288,2003,4553,2951,2758, 144,3358, 882,4554,3995,2759,3470, # 1168
+4555,2915,5114,4238,1726, 320,5115,3996,3046, 788,2996,5116,2831,1774,1327,2873, # 1184
+3997,2832,5117,1306,4556,2004,1700,3831,3576,2364,2660, 787,2023, 506, 824,3702, # 1200
+ 534, 323,4557,1044,3359,2024,1901, 946,3471,5118,1779,1500,1678,5119,1882,4558, # 1216
+ 165, 243,4559,3703,2528, 123, 683,4239, 764,4560,  36,3998,1793, 589,2916, 816, # 1232
+ 626,1667,3047,2237,1639,1555,1622,3832,3999,5120,4000,2874,1370,1228,1933, 891, # 1248
+2084,2917, 304,4240,5121, 292,2997,2720,3577, 691,2101,4241,1115,4561, 118, 662, # 1264
+5122, 611,1156, 854,2386,1316,2875,   2, 386, 515,2918,5123,5124,3286, 868,2238, # 1280
+1486, 855,2661, 785,2216,3048,5125,1040,3216,3578,5126,3146, 448,5127,1525,5128, # 1296
+2165,4562,5129,3833,5130,4242,2833,3579,3147, 503, 818,4001,3148,1568, 814, 676, # 1312
+1444, 306,1749,5131,3834,1416,1030, 197,1428, 805,2834,1501,4563,5132,5133,5134, # 1328
+1994,5135,4564,5136,5137,2198,  13,2792,3704,2998,3149,1229,1917,5138,3835,2132, # 1344
+5139,4243,4565,2404,3580,5140,2217,1511,1727,1120,5141,5142, 646,3836,2448, 307, # 1360
+5143,5144,1595,3217,5145,5146,5147,3705,1113,1356,4002,1465,2529,2530,5148, 519, # 1376
+5149, 128,2133,  92,2289,1980,5150,4003,1512, 342,3150,2199,5151,2793,2218,1981, # 1392
+3360,4244, 290,1656,1317, 789, 827,2365,5152,3837,4566, 562, 581,4004,5153, 401, # 1408
+4567,2252,  94,4568,5154,1399,2794,5155,1463,2025,4569,3218,1944,5156, 828,1105, # 1424
+4245,1262,1394,5157,4246, 605,4570,5158,1784,2876,5159,2835, 819,2102, 578,2200, # 1440
+2952,5160,1502, 436,3287,4247,3288,2836,4005,2919,3472,3473,5161,2721,2320,5162, # 1456
+5163,2337,2068,  23,4571, 193, 826,3838,2103, 699,1630,4248,3098, 390,1794,1064, # 1472
+3581,5164,1579,3099,3100,1400,5165,4249,1839,1640,2877,5166,4572,4573, 137,4250, # 1488
+ 598,3101,1967, 780, 104, 974,2953,5167, 278, 899, 253, 402, 572, 504, 493,1339, # 1504
+5168,4006,1275,4574,2582,2558,5169,3706,3049,3102,2253, 565,1334,2722, 863,  41, # 1520
+5170,5171,4575,5172,1657,2338,  19, 463,2760,4251, 606,5173,2999,3289,1087,2085, # 1536
+1323,2662,3000,5174,1631,1623,1750,4252,2691,5175,2878, 791,2723,2663,2339, 232, # 1552
+2421,5176,3001,1498,5177,2664,2630, 755,1366,3707,3290,3151,2026,1609, 119,1918, # 1568
+3474, 862,1026,4253,5178,4007,3839,4576,4008,4577,2265,1952,2477,5179,1125, 817, # 1584
+4254,4255,4009,1513,1766,2041,1487,4256,3050,3291,2837,3840,3152,5180,5181,1507, # 1600
+5182,2692, 733,  40,1632,1106,2879, 345,4257, 841,2531, 230,4578,3002,1847,3292, # 1616
+3475,5183,1263, 986,3476,5184, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562, # 1632
+4010,4011,2954, 967,2761,2665,1349, 592,2134,1692,3361,3003,1995,4258,1679,4012, # 1648
+1902,2188,5185, 739,3708,2724,1296,1290,5186,4259,2201,2202,1922,1563,2605,2559, # 1664
+1871,2762,3004,5187, 435,5188, 343,1108, 596,  17,1751,4579,2239,3477,3709,5189, # 1680
+4580, 294,3582,2955,1693, 477, 979, 281,2042,3583, 643,2043,3710,2631,2795,2266, # 1696
+1031,2340,2135,2303,3584,4581, 367,1249,2560,5190,3585,5191,4582,1283,3362,2005, # 1712
+ 240,1762,3363,4583,4584, 836,1069,3153, 474,5192,2149,2532, 268,3586,5193,3219, # 1728
+1521,1284,5194,1658,1546,4260,5195,3587,3588,5196,4261,3364,2693,1685,4262, 961, # 1744
+1673,2632, 190,2006,2203,3841,4585,4586,5197, 570,2504,3711,1490,5198,4587,2633, # 1760
+3293,1957,4588, 584,1514, 396,1045,1945,5199,4589,1968,2449,5200,5201,4590,4013, # 1776
+ 619,5202,3154,3294, 215,2007,2796,2561,3220,4591,3221,4592, 763,4263,3842,4593, # 1792
+5203,5204,1958,1767,2956,3365,3712,1174, 452,1477,4594,3366,3155,5205,2838,1253, # 1808
+2387,2189,1091,2290,4264, 492,5206, 638,1169,1825,2136,1752,4014, 648, 926,1021, # 1824
+1324,4595, 520,4596, 997, 847,1007, 892,4597,3843,2267,1872,3713,2405,1785,4598, # 1840
+1953,2957,3103,3222,1728,4265,2044,3714,4599,2008,1701,3156,1551,  30,2268,4266, # 1856
+5207,2027,4600,3589,5208, 501,5209,4267, 594,3478,2166,1822,3590,3479,3591,3223, # 1872
+ 829,2839,4268,5210,1680,3157,1225,4269,5211,3295,4601,4270,3158,2341,5212,4602, # 1888
+4271,5213,4015,4016,5214,1848,2388,2606,3367,5215,4603, 374,4017, 652,4272,4273, # 1904
+ 375,1140, 798,5216,5217,5218,2366,4604,2269, 546,1659, 138,3051,2450,4605,5219, # 1920
+2254, 612,1849, 910, 796,3844,1740,1371, 825,3845,3846,5220,2920,2562,5221, 692, # 1936
+ 444,3052,2634, 801,4606,4274,5222,1491, 244,1053,3053,4275,4276, 340,5223,4018, # 1952
+1041,3005, 293,1168,  87,1357,5224,1539, 959,5225,2240, 721, 694,4277,3847, 219, # 1968
+1478, 644,1417,3368,2666,1413,1401,1335,1389,4019,5226,5227,3006,2367,3159,1826, # 1984
+ 730,1515, 184,2840,  66,4607,5228,1660,2958, 246,3369, 378,1457, 226,3480, 975, # 2000
+4020,2959,1264,3592, 674, 696,5229, 163,5230,1141,2422,2167, 713,3593,3370,4608, # 2016
+4021,5231,5232,1186,  15,5233,1079,1070,5234,1522,3224,3594, 276,1050,2725, 758, # 2032
+1126, 653,2960,3296,5235,2342, 889,3595,4022,3104,3007, 903,1250,4609,4023,3481, # 2048
+3596,1342,1681,1718, 766,3297, 286,  89,2961,3715,5236,1713,5237,2607,3371,3008, # 2064
+5238,2962,2219,3225,2880,5239,4610,2505,2533, 181, 387,1075,4024, 731,2190,3372, # 2080
+5240,3298, 310, 313,3482,2304, 770,4278,  54,3054, 189,4611,3105,3848,4025,5241, # 2096
+1230,1617,1850, 355,3597,4279,4612,3373, 111,4280,3716,1350,3160,3483,3055,4281, # 2112
+2150,3299,3598,5242,2797,4026,4027,3009, 722,2009,5243,1071, 247,1207,2343,2478, # 2128
+1378,4613,2010, 864,1437,1214,4614, 373,3849,1142,2220, 667,4615, 442,2763,2563, # 2144
+3850,4028,1969,4282,3300,1840, 837, 170,1107, 934,1336,1883,5244,5245,2119,4283, # 2160
+2841, 743,1569,5246,4616,4284, 582,2389,1418,3484,5247,1803,5248, 357,1395,1729, # 2176
+3717,3301,2423,1564,2241,5249,3106,3851,1633,4617,1114,2086,4285,1532,5250, 482, # 2192
+2451,4618,5251,5252,1492, 833,1466,5253,2726,3599,1641,2842,5254,1526,1272,3718, # 2208
+4286,1686,1795, 416,2564,1903,1954,1804,5255,3852,2798,3853,1159,2321,5256,2881, # 2224
+4619,1610,1584,3056,2424,2764, 443,3302,1163,3161,5257,5258,4029,5259,4287,2506, # 2240
+3057,4620,4030,3162,2104,1647,3600,2011,1873,4288,5260,4289, 431,3485,5261, 250, # 2256
+  97,  81,4290,5262,1648,1851,1558, 160, 848,5263, 866, 740,1694,5264,2204,2843, # 2272
+3226,4291,4621,3719,1687, 950,2479, 426, 469,3227,3720,3721,4031,5265,5266,1188, # 2288
+ 424,1996, 861,3601,4292,3854,2205,2694, 168,1235,3602,4293,5267,2087,1674,4622, # 2304
+3374,3303, 220,2565,1009,5268,3855, 670,3010, 332,1208, 717,5269,5270,3603,2452, # 2320
+4032,3375,5271, 513,5272,1209,2882,3376,3163,4623,1080,5273,5274,5275,5276,2534, # 2336
+3722,3604, 815,1587,4033,4034,5277,3605,3486,3856,1254,4624,1328,3058,1390,4035, # 2352
+1741,4036,3857,4037,5278, 236,3858,2453,3304,5279,5280,3723,3859,1273,3860,4625, # 2368
+5281, 308,5282,4626, 245,4627,1852,2480,1307,2583, 430, 715,2137,2454,5283, 270, # 2384
+ 199,2883,4038,5284,3606,2727,1753, 761,1754, 725,1661,1841,4628,3487,3724,5285, # 2400
+5286, 587,  14,3305, 227,2608, 326, 480,2270, 943,2765,3607, 291, 650,1884,5287, # 2416
+1702,1226, 102,1547,  62,3488, 904,4629,3489,1164,4294,5288,5289,1224,1548,2766, # 2432
+ 391, 498,1493,5290,1386,1419,5291,2056,1177,4630, 813, 880,1081,2368, 566,1145, # 2448
+4631,2291,1001,1035,2566,2609,2242, 394,1286,5292,5293,2069,5294,  86,1494,1730, # 2464
+4039, 491,1588, 745, 897,2963, 843,3377,4040,2767,2884,3306,1768, 998,2221,2070, # 2480
+ 397,1827,1195,1970,3725,3011,3378, 284,5295,3861,2507,2138,2120,1904,5296,4041, # 2496
+2151,4042,4295,1036,3490,1905, 114,2567,4296, 209,1527,5297,5298,2964,2844,2635, # 2512
+2390,2728,3164, 812,2568,5299,3307,5300,1559, 737,1885,3726,1210, 885,  28,2695, # 2528
+3608,3862,5301,4297,1004,1780,4632,5302, 346,1982,2222,2696,4633,3863,1742, 797, # 2544
+1642,4043,1934,1072,1384,2152, 896,4044,3308,3727,3228,2885,3609,5303,2569,1959, # 2560
+4634,2455,1786,5304,5305,5306,4045,4298,1005,1308,3728,4299,2729,4635,4636,1528, # 2576
+2610, 161,1178,4300,1983, 987,4637,1101,4301, 631,4046,1157,3229,2425,1343,1241, # 2592
+1016,2243,2570, 372, 877,2344,2508,1160, 555,1935, 911,4047,5307, 466,1170, 169, # 2608
+1051,2921,2697,3729,2481,3012,1182,2012,2571,1251,2636,5308, 992,2345,3491,1540, # 2624
+2730,1201,2071,2406,1997,2482,5309,4638, 528,1923,2191,1503,1874,1570,2369,3379, # 2640
+3309,5310, 557,1073,5311,1828,3492,2088,2271,3165,3059,3107, 767,3108,2799,4639, # 2656
+1006,4302,4640,2346,1267,2179,3730,3230, 778,4048,3231,2731,1597,2667,5312,4641, # 2672
+5313,3493,5314,5315,5316,3310,2698,1433,3311, 131,  95,1504,4049, 723,4303,3166, # 2688
+1842,3610,2768,2192,4050,2028,2105,3731,5317,3013,4051,1218,5318,3380,3232,4052, # 2704
+4304,2584, 248,1634,3864, 912,5319,2845,3732,3060,3865, 654,  53,5320,3014,5321, # 2720
+1688,4642, 777,3494,1032,4053,1425,5322, 191, 820,2121,2846, 971,4643, 931,3233, # 2736
+ 135, 664, 783,3866,1998, 772,2922,1936,4054,3867,4644,2923,3234, 282,2732, 640, # 2752
+1372,3495,1127, 922, 325,3381,5323,5324, 711,2045,5325,5326,4055,2223,2800,1937, # 2768
+4056,3382,2224,2255,3868,2305,5327,4645,3869,1258,3312,4057,3235,2139,2965,4058, # 2784
+4059,5328,2225, 258,3236,4646, 101,1227,5329,3313,1755,5330,1391,3314,5331,2924, # 2800
+2057, 893,5332,5333,5334,1402,4305,2347,5335,5336,3237,3611,5337,5338, 878,1325, # 2816
+1781,2801,4647, 259,1385,2585, 744,1183,2272,4648,5339,4060,2509,5340, 684,1024, # 2832
+4306,5341, 472,3612,3496,1165,3315,4061,4062, 322,2153, 881, 455,1695,1152,1340, # 2848
+ 660, 554,2154,4649,1058,4650,4307, 830,1065,3383,4063,4651,1924,5342,1703,1919, # 2864
+5343, 932,2273, 122,5344,4652, 947, 677,5345,3870,2637, 297,1906,1925,2274,4653, # 2880
+2322,3316,5346,5347,4308,5348,4309,  84,4310, 112, 989,5349, 547,1059,4064, 701, # 2896
+3613,1019,5350,4311,5351,3497, 942, 639, 457,2306,2456, 993,2966, 407, 851, 494, # 2912
+4654,3384, 927,5352,1237,5353,2426,3385, 573,4312, 680, 921,2925,1279,1875, 285, # 2928
+ 790,1448,1984, 719,2168,5354,5355,4655,4065,4066,1649,5356,1541, 563,5357,1077, # 2944
+5358,3386,3061,3498, 511,3015,4067,4068,3733,4069,1268,2572,3387,3238,4656,4657, # 2960
+5359, 535,1048,1276,1189,2926,2029,3167,1438,1373,2847,2967,1134,2013,5360,4313, # 2976
+1238,2586,3109,1259,5361, 700,5362,2968,3168,3734,4314,5363,4315,1146,1876,1907, # 2992
+4658,2611,4070, 781,2427, 132,1589, 203, 147, 273,2802,2407, 898,1787,2155,4071, # 3008
+4072,5364,3871,2803,5365,5366,4659,4660,5367,3239,5368,1635,3872, 965,5369,1805, # 3024
+2699,1516,3614,1121,1082,1329,3317,4073,1449,3873,  65,1128,2848,2927,2769,1590, # 3040
+3874,5370,5371,  12,2668,  45, 976,2587,3169,4661, 517,2535,1013,1037,3240,5372, # 3056
+3875,2849,5373,3876,5374,3499,5375,2612, 614,1999,2323,3877,3110,2733,2638,5376, # 3072
+2588,4316, 599,1269,5377,1811,3735,5378,2700,3111, 759,1060, 489,1806,3388,3318, # 3088
+1358,5379,5380,2391,1387,1215,2639,2256, 490,5381,5382,4317,1759,2392,2348,5383, # 3104
+4662,3878,1908,4074,2640,1807,3241,4663,3500,3319,2770,2349, 874,5384,5385,3501, # 3120
+3736,1859,  91,2928,3737,3062,3879,4664,5386,3170,4075,2669,5387,3502,1202,1403, # 3136
+3880,2969,2536,1517,2510,4665,3503,2511,5388,4666,5389,2701,1886,1495,1731,4076, # 3152
+2370,4667,5390,2030,5391,5392,4077,2702,1216, 237,2589,4318,2324,4078,3881,4668, # 3168
+4669,2703,3615,3504, 445,4670,5393,5394,5395,5396,2771,  61,4079,3738,1823,4080, # 3184
+5397, 687,2046, 935, 925, 405,2670, 703,1096,1860,2734,4671,4081,1877,1367,2704, # 3200
+3389, 918,2106,1782,2483, 334,3320,1611,1093,4672, 564,3171,3505,3739,3390, 945, # 3216
+2641,2058,4673,5398,1926, 872,4319,5399,3506,2705,3112, 349,4320,3740,4082,4674, # 3232
+3882,4321,3741,2156,4083,4675,4676,4322,4677,2408,2047, 782,4084, 400, 251,4323, # 3248
+1624,5400,5401, 277,3742, 299,1265, 476,1191,3883,2122,4324,4325,1109, 205,5402, # 3264
+2590,1000,2157,3616,1861,5403,5404,5405,4678,5406,4679,2573, 107,2484,2158,4085, # 3280
+3507,3172,5407,1533, 541,1301, 158, 753,4326,2886,3617,5408,1696, 370,1088,4327, # 3296
+4680,3618, 579, 327, 440, 162,2244, 269,1938,1374,3508, 968,3063,  56,1396,3113, # 3312
+2107,3321,3391,5409,1927,2159,4681,3016,5410,3619,5411,5412,3743,4682,2485,5413, # 3328
+2804,5414,1650,4683,5415,2613,5416,5417,4086,2671,3392,1149,3393,4087,3884,4088, # 3344
+5418,1076,  49,5419, 951,3242,3322,3323, 450,2850, 920,5420,1812,2805,2371,4328, # 3360
+1909,1138,2372,3885,3509,5421,3243,4684,1910,1147,1518,2428,4685,3886,5422,4686, # 3376
+2393,2614, 260,1796,3244,5423,5424,3887,3324, 708,5425,3620,1704,5426,3621,1351, # 3392
+1618,3394,3017,1887, 944,4329,3395,4330,3064,3396,4331,5427,3744, 422, 413,1714, # 3408
+3325, 500,2059,2350,4332,2486,5428,1344,1911, 954,5429,1668,5430,5431,4089,2409, # 3424
+4333,3622,3888,4334,5432,2307,1318,2512,3114, 133,3115,2887,4687, 629,  31,2851, # 3440
+2706,3889,4688, 850, 949,4689,4090,2970,1732,2089,4335,1496,1853,5433,4091, 620, # 3456
+3245, 981,1242,3745,3397,1619,3746,1643,3326,2140,2457,1971,1719,3510,2169,5434, # 3472
+3246,5435,5436,3398,1829,5437,1277,4690,1565,2048,5438,1636,3623,3116,5439, 869, # 3488
+2852, 655,3890,3891,3117,4092,3018,3892,1310,3624,4691,5440,5441,5442,1733, 558, # 3504
+4692,3747, 335,1549,3065,1756,4336,3748,1946,3511,1830,1291,1192, 470,2735,2108, # 3520
+2806, 913,1054,4093,5443,1027,5444,3066,4094,4693, 982,2672,3399,3173,3512,3247, # 3536
+3248,1947,2807,5445, 571,4694,5446,1831,5447,3625,2591,1523,2429,5448,2090, 984, # 3552
+4695,3749,1960,5449,3750, 852, 923,2808,3513,3751, 969,1519, 999,2049,2325,1705, # 3568
+5450,3118, 615,1662, 151, 597,4095,2410,2326,1049, 275,4696,3752,4337, 568,3753, # 3584
+3626,2487,4338,3754,5451,2430,2275, 409,3249,5452,1566,2888,3514,1002, 769,2853, # 3600
+ 194,2091,3174,3755,2226,3327,4339, 628,1505,5453,5454,1763,2180,3019,4096, 521, # 3616
+1161,2592,1788,2206,2411,4697,4097,1625,4340,4341, 412,  42,3119, 464,5455,2642, # 3632
+4698,3400,1760,1571,2889,3515,2537,1219,2207,3893,2643,2141,2373,4699,4700,3328, # 3648
+1651,3401,3627,5456,5457,3628,2488,3516,5458,3756,5459,5460,2276,2092, 460,5461, # 3664
+4701,5462,3020, 962, 588,3629, 289,3250,2644,1116,  52,5463,3067,1797,5464,5465, # 3680
+5466,1467,5467,1598,1143,3757,4342,1985,1734,1067,4702,1280,3402, 465,4703,1572, # 3696
+ 510,5468,1928,2245,1813,1644,3630,5469,4704,3758,5470,5471,2673,1573,1534,5472, # 3712
+5473, 536,1808,1761,3517,3894,3175,2645,5474,5475,5476,4705,3518,2929,1912,2809, # 3728
+5477,3329,1122, 377,3251,5478, 360,5479,5480,4343,1529, 551,5481,2060,3759,1769, # 3744
+2431,5482,2930,4344,3330,3120,2327,2109,2031,4706,1404, 136,1468,1479, 672,1171, # 3760
+3252,2308, 271,3176,5483,2772,5484,2050, 678,2736, 865,1948,4707,5485,2014,4098, # 3776
+2971,5486,2737,2227,1397,3068,3760,4708,4709,1735,2931,3403,3631,5487,3895, 509, # 3792
+2854,2458,2890,3896,5488,5489,3177,3178,4710,4345,2538,4711,2309,1166,1010, 552, # 3808
+ 681,1888,5490,5491,2972,2973,4099,1287,1596,1862,3179, 358, 453, 736, 175, 478, # 3824
+1117, 905,1167,1097,5492,1854,1530,5493,1706,5494,2181,3519,2292,3761,3520,3632, # 3840
+4346,2093,4347,5495,3404,1193,2489,4348,1458,2193,2208,1863,1889,1421,3331,2932, # 3856
+3069,2182,3521, 595,2123,5496,4100,5497,5498,4349,1707,2646, 223,3762,1359, 751, # 3872
+3121, 183,3522,5499,2810,3021, 419,2374, 633, 704,3897,2394, 241,5500,5501,5502, # 3888
+ 838,3022,3763,2277,2773,2459,3898,1939,2051,4101,1309,3122,2246,1181,5503,1136, # 3904
+2209,3899,2375,1446,4350,2310,4712,5504,5505,4351,1055,2615, 484,3764,5506,4102, # 3920
+ 625,4352,2278,3405,1499,4353,4103,5507,4104,4354,3253,2279,2280,3523,5508,5509, # 3936
+2774, 808,2616,3765,3406,4105,4355,3123,2539, 526,3407,3900,4356, 955,5510,1620, # 3952
+4357,2647,2432,5511,1429,3766,1669,1832, 994, 928,5512,3633,1260,5513,5514,5515, # 3968
+1949,2293, 741,2933,1626,4358,2738,2460, 867,1184, 362,3408,1392,5516,5517,4106, # 3984
+4359,1770,1736,3254,2934,4713,4714,1929,2707,1459,1158,5518,3070,3409,2891,1292, # 4000
+1930,2513,2855,3767,1986,1187,2072,2015,2617,4360,5519,2574,2514,2170,3768,2490, # 4016
+3332,5520,3769,4715,5521,5522, 666,1003,3023,1022,3634,4361,5523,4716,1814,2257, # 4032
+ 574,3901,1603, 295,1535, 705,3902,4362, 283, 858, 417,5524,5525,3255,4717,4718, # 4048
+3071,1220,1890,1046,2281,2461,4107,1393,1599, 689,2575, 388,4363,5526,2491, 802, # 4064
+5527,2811,3903,2061,1405,2258,5528,4719,3904,2110,1052,1345,3256,1585,5529, 809, # 4080
+5530,5531,5532, 575,2739,3524, 956,1552,1469,1144,2328,5533,2329,1560,2462,3635, # 4096
+3257,4108, 616,2210,4364,3180,2183,2294,5534,1833,5535,3525,4720,5536,1319,3770, # 4112
+3771,1211,3636,1023,3258,1293,2812,5537,5538,5539,3905, 607,2311,3906, 762,2892, # 4128
+1439,4365,1360,4721,1485,3072,5540,4722,1038,4366,1450,2062,2648,4367,1379,4723, # 4144
+2593,5541,5542,4368,1352,1414,2330,2935,1172,5543,5544,3907,3908,4724,1798,1451, # 4160
+5545,5546,5547,5548,2936,4109,4110,2492,2351, 411,4111,4112,3637,3333,3124,4725, # 4176
+1561,2674,1452,4113,1375,5549,5550,  47,2974, 316,5551,1406,1591,2937,3181,5552, # 4192
+1025,2142,3125,3182, 354,2740, 884,2228,4369,2412, 508,3772, 726,3638, 996,2433, # 4208
+3639, 729,5553, 392,2194,1453,4114,4726,3773,5554,5555,2463,3640,2618,1675,2813, # 4224
+ 919,2352,2975,2353,1270,4727,4115,  73,5556,5557, 647,5558,3259,2856,2259,1550, # 4240
+1346,3024,5559,1332, 883,3526,5560,5561,5562,5563,3334,2775,5564,1212, 831,1347, # 4256
+4370,4728,2331,3909,1864,3073, 720,3910,4729,4730,3911,5565,4371,5566,5567,4731, # 4272
+5568,5569,1799,4732,3774,2619,4733,3641,1645,2376,4734,5570,2938, 669,2211,2675, # 4288
+2434,5571,2893,5572,5573,1028,3260,5574,4372,2413,5575,2260,1353,5576,5577,4735, # 4304
+3183, 518,5578,4116,5579,4373,1961,5580,2143,4374,5581,5582,3025,2354,2355,3912, # 4320
+ 516,1834,1454,4117,2708,4375,4736,2229,2620,1972,1129,3642,5583,2776,5584,2976, # 4336
+1422, 577,1470,3026,1524,3410,5585,5586, 432,4376,3074,3527,5587,2594,1455,2515, # 4352
+2230,1973,1175,5588,1020,2741,4118,3528,4737,5589,2742,5590,1743,1361,3075,3529, # 4368
+2649,4119,4377,4738,2295, 895, 924,4378,2171, 331,2247,3076, 166,1627,3077,1098, # 4384
+5591,1232,2894,2231,3411,4739, 657, 403,1196,2377, 542,3775,3412,1600,4379,3530, # 4400
+5592,4740,2777,3261, 576, 530,1362,4741,4742,2540,2676,3776,4120,5593, 842,3913, # 4416
+5594,2814,2032,1014,4121, 213,2709,3413, 665, 621,4380,5595,3777,2939,2435,5596, # 4432
+2436,3335,3643,3414,4743,4381,2541,4382,4744,3644,1682,4383,3531,1380,5597, 724, # 4448
+2282, 600,1670,5598,1337,1233,4745,3126,2248,5599,1621,4746,5600, 651,4384,5601, # 4464
+1612,4385,2621,5602,2857,5603,2743,2312,3078,5604, 716,2464,3079, 174,1255,2710, # 4480
+4122,3645, 548,1320,1398, 728,4123,1574,5605,1891,1197,3080,4124,5606,3081,3082, # 4496
+3778,3646,3779, 747,5607, 635,4386,4747,5608,5609,5610,4387,5611,5612,4748,5613, # 4512
+3415,4749,2437, 451,5614,3780,2542,2073,4388,2744,4389,4125,5615,1764,4750,5616, # 4528
+4390, 350,4751,2283,2395,2493,5617,4391,4126,2249,1434,4127, 488,4752, 458,4392, # 4544
+4128,3781, 771,1330,2396,3914,2576,3184,2160,2414,1553,2677,3185,4393,5618,2494, # 4560
+2895,2622,1720,2711,4394,3416,4753,5619,2543,4395,5620,3262,4396,2778,5621,2016, # 4576
+2745,5622,1155,1017,3782,3915,5623,3336,2313, 201,1865,4397,1430,5624,4129,5625, # 4592
+5626,5627,5628,5629,4398,1604,5630, 414,1866, 371,2595,4754,4755,3532,2017,3127, # 4608
+4756,1708, 960,4399, 887, 389,2172,1536,1663,1721,5631,2232,4130,2356,2940,1580, # 4624
+5632,5633,1744,4757,2544,4758,4759,5634,4760,5635,2074,5636,4761,3647,3417,2896, # 4640
+4400,5637,4401,2650,3418,2815, 673,2712,2465, 709,3533,4131,3648,4402,5638,1148, # 4656
+ 502, 634,5639,5640,1204,4762,3649,1575,4763,2623,3783,5641,3784,3128, 948,3263, # 4672
+ 121,1745,3916,1110,5642,4403,3083,2516,3027,4132,3785,1151,1771,3917,1488,4133, # 4688
+1987,5643,2438,3534,5644,5645,2094,5646,4404,3918,1213,1407,2816, 531,2746,2545, # 4704
+3264,1011,1537,4764,2779,4405,3129,1061,5647,3786,3787,1867,2897,5648,2018, 120, # 4720
+4406,4407,2063,3650,3265,2314,3919,2678,3419,1955,4765,4134,5649,3535,1047,2713, # 4736
+1266,5650,1368,4766,2858, 649,3420,3920,2546,2747,1102,2859,2679,5651,5652,2000, # 4752
+5653,1111,3651,2977,5654,2495,3921,3652,2817,1855,3421,3788,5655,5656,3422,2415, # 4768
+2898,3337,3266,3653,5657,2577,5658,3654,2818,4135,1460, 856,5659,3655,5660,2899, # 4784
+2978,5661,2900,3922,5662,4408, 632,2517, 875,3923,1697,3924,2296,5663,5664,4767, # 4800
+3028,1239, 580,4768,4409,5665, 914, 936,2075,1190,4136,1039,2124,5666,5667,5668, # 4816
+5669,3423,1473,5670,1354,4410,3925,4769,2173,3084,4137, 915,3338,4411,4412,3339, # 4832
+1605,1835,5671,2748, 398,3656,4413,3926,4138, 328,1913,2860,4139,3927,1331,4414, # 4848
+3029, 937,4415,5672,3657,4140,4141,3424,2161,4770,3425, 524, 742, 538,3085,1012, # 4864
+5673,5674,3928,2466,5675, 658,1103, 225,3929,5676,5677,4771,5678,4772,5679,3267, # 4880
+1243,5680,4142, 963,2250,4773,5681,2714,3658,3186,5682,5683,2596,2332,5684,4774, # 4896
+5685,5686,5687,3536, 957,3426,2547,2033,1931,2941,2467, 870,2019,3659,1746,2780, # 4912
+2781,2439,2468,5688,3930,5689,3789,3130,3790,3537,3427,3791,5690,1179,3086,5691, # 4928
+3187,2378,4416,3792,2548,3188,3131,2749,4143,5692,3428,1556,2549,2297, 977,2901, # 4944
+2034,4144,1205,3429,5693,1765,3430,3189,2125,1271, 714,1689,4775,3538,5694,2333, # 4960
+3931, 533,4417,3660,2184, 617,5695,2469,3340,3539,2315,5696,5697,3190,5698,5699, # 4976
+3932,1988, 618, 427,2651,3540,3431,5700,5701,1244,1690,5702,2819,4418,4776,5703, # 4992
+3541,4777,5704,2284,1576, 473,3661,4419,3432, 972,5705,3662,5706,3087,5707,5708, # 5008
+4778,4779,5709,3793,4145,4146,5710, 153,4780, 356,5711,1892,2902,4420,2144, 408, # 5024
+ 803,2357,5712,3933,5713,4421,1646,2578,2518,4781,4782,3934,5714,3935,4422,5715, # 5040
+2416,3433, 752,5716,5717,1962,3341,2979,5718, 746,3030,2470,4783,4423,3794, 698, # 5056
+4784,1893,4424,3663,2550,4785,3664,3936,5719,3191,3434,5720,1824,1302,4147,2715, # 5072
+3937,1974,4425,5721,4426,3192, 823,1303,1288,1236,2861,3542,4148,3435, 774,3938, # 5088
+5722,1581,4786,1304,2862,3939,4787,5723,2440,2162,1083,3268,4427,4149,4428, 344, # 5104
+1173, 288,2316, 454,1683,5724,5725,1461,4788,4150,2597,5726,5727,4789, 985, 894, # 5120
+5728,3436,3193,5729,1914,2942,3795,1989,5730,2111,1975,5731,4151,5732,2579,1194, # 5136
+ 425,5733,4790,3194,1245,3796,4429,5734,5735,2863,5736, 636,4791,1856,3940, 760, # 5152
+1800,5737,4430,2212,1508,4792,4152,1894,1684,2298,5738,5739,4793,4431,4432,2213, # 5168
+ 479,5740,5741, 832,5742,4153,2496,5743,2980,2497,3797, 990,3132, 627,1815,2652, # 5184
+4433,1582,4434,2126,2112,3543,4794,5744, 799,4435,3195,5745,4795,2113,1737,3031, # 5200
+1018, 543, 754,4436,3342,1676,4796,4797,4154,4798,1489,5746,3544,5747,2624,2903, # 5216
+4155,5748,5749,2981,5750,5751,5752,5753,3196,4799,4800,2185,1722,5754,3269,3270, # 5232
+1843,3665,1715, 481, 365,1976,1857,5755,5756,1963,2498,4801,5757,2127,3666,3271, # 5248
+ 433,1895,2064,2076,5758, 602,2750,5759,5760,5761,5762,5763,3032,1628,3437,5764, # 5264
+3197,4802,4156,2904,4803,2519,5765,2551,2782,5766,5767,5768,3343,4804,2905,5769, # 5280
+4805,5770,2864,4806,4807,1221,2982,4157,2520,5771,5772,5773,1868,1990,5774,5775, # 5296
+5776,1896,5777,5778,4808,1897,4158, 318,5779,2095,4159,4437,5780,5781, 485,5782, # 5312
+ 938,3941, 553,2680, 116,5783,3942,3667,5784,3545,2681,2783,3438,3344,2820,5785, # 5328
+3668,2943,4160,1747,2944,2983,5786,5787, 207,5788,4809,5789,4810,2521,5790,3033, # 5344
+ 890,3669,3943,5791,1878,3798,3439,5792,2186,2358,3440,1652,5793,5794,5795, 941, # 5360
+2299, 208,3546,4161,2020, 330,4438,3944,2906,2499,3799,4439,4811,5796,5797,5798, # 5376
+)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5prober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5prober.py
new file mode 100644
index 0000000000000000000000000000000000000000..98f9970122088c14a5830e091ca8a12fc8e4c563
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/big5prober.py
@@ -0,0 +1,47 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import Big5DistributionAnalysis
+from .mbcssm import BIG5_SM_MODEL
+
+
+class Big5Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(Big5Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(BIG5_SM_MODEL)
+        self.distribution_analyzer = Big5DistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "Big5"
+
+    @property
+    def language(self):
+        return "Chinese"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/chardistribution.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/chardistribution.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0395f4a45aaa5c4ba1824a81d8ef8f69b46dc60
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/chardistribution.py
@@ -0,0 +1,233 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .euctwfreq import (EUCTW_CHAR_TO_FREQ_ORDER, EUCTW_TABLE_SIZE,
+                        EUCTW_TYPICAL_DISTRIBUTION_RATIO)
+from .euckrfreq import (EUCKR_CHAR_TO_FREQ_ORDER, EUCKR_TABLE_SIZE,
+                        EUCKR_TYPICAL_DISTRIBUTION_RATIO)
+from .gb2312freq import (GB2312_CHAR_TO_FREQ_ORDER, GB2312_TABLE_SIZE,
+                         GB2312_TYPICAL_DISTRIBUTION_RATIO)
+from .big5freq import (BIG5_CHAR_TO_FREQ_ORDER, BIG5_TABLE_SIZE,
+                       BIG5_TYPICAL_DISTRIBUTION_RATIO)
+from .jisfreq import (JIS_CHAR_TO_FREQ_ORDER, JIS_TABLE_SIZE,
+                      JIS_TYPICAL_DISTRIBUTION_RATIO)
+
+
+class CharDistributionAnalysis(object):
+    ENOUGH_DATA_THRESHOLD = 1024
+    SURE_YES = 0.99
+    SURE_NO = 0.01
+    MINIMUM_DATA_THRESHOLD = 3
+
+    def __init__(self):
+        # Mapping table to get frequency order from char order (get from
+        # GetOrder())
+        self._char_to_freq_order = None
+        self._table_size = None  # Size of above table
+        # This is a constant value which varies from language to language,
+        # used in calculating confidence.  See
+        # http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html
+        # for further detail.
+        self.typical_distribution_ratio = None
+        self._done = None
+        self._total_chars = None
+        self._freq_chars = None
+        self.reset()
+
+    def reset(self):
+        """reset analyser, clear any state"""
+        # If this flag is set to True, detection is done and conclusion has
+        # been made
+        self._done = False
+        self._total_chars = 0  # Total characters encountered
+        # The number of characters whose frequency order is less than 512
+        self._freq_chars = 0
+
+    def feed(self, char, char_len):
+        """feed a character with known length"""
+        if char_len == 2:
+            # we only care about 2-bytes character in our distribution analysis
+            order = self.get_order(char)
+        else:
+            order = -1
+        if order >= 0:
+            self._total_chars += 1
+            # order is valid
+            if order < self._table_size:
+                if 512 > self._char_to_freq_order[order]:
+                    self._freq_chars += 1
+
+    def get_confidence(self):
+        """return confidence based on existing data"""
+        # if we didn't receive any character in our consideration range,
+        # return negative answer
+        if self._total_chars <= 0 or self._freq_chars <= self.MINIMUM_DATA_THRESHOLD:
+            return self.SURE_NO
+
+        if self._total_chars != self._freq_chars:
+            r = (self._freq_chars / ((self._total_chars - self._freq_chars)
+                 * self.typical_distribution_ratio))
+            if r < self.SURE_YES:
+                return r
+
+        # normalize confidence (we don't want to be 100% sure)
+        return self.SURE_YES
+
+    def got_enough_data(self):
+        # It is not necessary to receive all data to draw conclusion.
+        # For charset detection, certain amount of data is enough
+        return self._total_chars > self.ENOUGH_DATA_THRESHOLD
+
+    def get_order(self, byte_str):
+        # We do not handle characters based on the original encoding string,
+        # but convert this encoding string to a number, here called order.
+        # This allows multiple encodings of a language to share one frequency
+        # table.
+        return -1
+
+
+class EUCTWDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCTWDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = EUCTW_CHAR_TO_FREQ_ORDER
+        self._table_size = EUCTW_TABLE_SIZE
+        self.typical_distribution_ratio = EUCTW_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-TW encoding, we are interested
+        #   first  byte range: 0xc4 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char = byte_str[0]
+        if first_char >= 0xC4:
+            return 94 * (first_char - 0xC4) + byte_str[1] - 0xA1
+        else:
+            return -1
+
+
+class EUCKRDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCKRDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = EUCKR_CHAR_TO_FREQ_ORDER
+        self._table_size = EUCKR_TABLE_SIZE
+        self.typical_distribution_ratio = EUCKR_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-KR encoding, we are interested
+        #   first  byte range: 0xb0 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char = byte_str[0]
+        if first_char >= 0xB0:
+            return 94 * (first_char - 0xB0) + byte_str[1] - 0xA1
+        else:
+            return -1
+
+
+class GB2312DistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(GB2312DistributionAnalysis, self).__init__()
+        self._char_to_freq_order = GB2312_CHAR_TO_FREQ_ORDER
+        self._table_size = GB2312_TABLE_SIZE
+        self.typical_distribution_ratio = GB2312_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for GB2312 encoding, we are interested
+        #  first  byte range: 0xb0 -- 0xfe
+        #  second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if (first_char >= 0xB0) and (second_char >= 0xA1):
+            return 94 * (first_char - 0xB0) + second_char - 0xA1
+        else:
+            return -1
+
+
+class Big5DistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(Big5DistributionAnalysis, self).__init__()
+        self._char_to_freq_order = BIG5_CHAR_TO_FREQ_ORDER
+        self._table_size = BIG5_TABLE_SIZE
+        self.typical_distribution_ratio = BIG5_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for big5 encoding, we are interested
+        #   first  byte range: 0xa4 -- 0xfe
+        #   second byte range: 0x40 -- 0x7e , 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if first_char >= 0xA4:
+            if second_char >= 0xA1:
+                return 157 * (first_char - 0xA4) + second_char - 0xA1 + 63
+            else:
+                return 157 * (first_char - 0xA4) + second_char - 0x40
+        else:
+            return -1
+
+
+class SJISDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(SJISDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
+        self._table_size = JIS_TABLE_SIZE
+        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for sjis encoding, we are interested
+        #   first  byte range: 0x81 -- 0x9f , 0xe0 -- 0xfe
+        #   second byte range: 0x40 -- 0x7e,  0x81 -- oxfe
+        # no validation needed here. State machine has done that
+        first_char, second_char = byte_str[0], byte_str[1]
+        if (first_char >= 0x81) and (first_char <= 0x9F):
+            order = 188 * (first_char - 0x81)
+        elif (first_char >= 0xE0) and (first_char <= 0xEF):
+            order = 188 * (first_char - 0xE0 + 31)
+        else:
+            return -1
+        order = order + second_char - 0x40
+        if second_char > 0x7F:
+            order = -1
+        return order
+
+
+class EUCJPDistributionAnalysis(CharDistributionAnalysis):
+    def __init__(self):
+        super(EUCJPDistributionAnalysis, self).__init__()
+        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
+        self._table_size = JIS_TABLE_SIZE
+        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO
+
+    def get_order(self, byte_str):
+        # for euc-JP encoding, we are interested
+        #   first  byte range: 0xa0 -- 0xfe
+        #   second byte range: 0xa1 -- 0xfe
+        # no validation needed here. State machine has done that
+        char = byte_str[0]
+        if char >= 0xA0:
+            return 94 * (char - 0xA1) + byte_str[1] - 0xa1
+        else:
+            return -1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetgroupprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetgroupprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b3738efd8ea1e42d196d381d2809beae7f4c649
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetgroupprober.py
@@ -0,0 +1,106 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import ProbingState
+from .charsetprober import CharSetProber
+
+
+class CharSetGroupProber(CharSetProber):
+    def __init__(self, lang_filter=None):
+        super(CharSetGroupProber, self).__init__(lang_filter=lang_filter)
+        self._active_num = 0
+        self.probers = []
+        self._best_guess_prober = None
+
+    def reset(self):
+        super(CharSetGroupProber, self).reset()
+        self._active_num = 0
+        for prober in self.probers:
+            if prober:
+                prober.reset()
+                prober.active = True
+                self._active_num += 1
+        self._best_guess_prober = None
+
+    @property
+    def charset_name(self):
+        if not self._best_guess_prober:
+            self.get_confidence()
+            if not self._best_guess_prober:
+                return None
+        return self._best_guess_prober.charset_name
+
+    @property
+    def language(self):
+        if not self._best_guess_prober:
+            self.get_confidence()
+            if not self._best_guess_prober:
+                return None
+        return self._best_guess_prober.language
+
+    def feed(self, byte_str):
+        for prober in self.probers:
+            if not prober:
+                continue
+            if not prober.active:
+                continue
+            state = prober.feed(byte_str)
+            if not state:
+                continue
+            if state == ProbingState.FOUND_IT:
+                self._best_guess_prober = prober
+                return self.state
+            elif state == ProbingState.NOT_ME:
+                prober.active = False
+                self._active_num -= 1
+                if self._active_num <= 0:
+                    self._state = ProbingState.NOT_ME
+                    return self.state
+        return self.state
+
+    def get_confidence(self):
+        state = self.state
+        if state == ProbingState.FOUND_IT:
+            return 0.99
+        elif state == ProbingState.NOT_ME:
+            return 0.01
+        best_conf = 0.0
+        self._best_guess_prober = None
+        for prober in self.probers:
+            if not prober:
+                continue
+            if not prober.active:
+                self.logger.debug('%s not active', prober.charset_name)
+                continue
+            conf = prober.get_confidence()
+            self.logger.debug('%s %s confidence = %s', prober.charset_name, prober.language, conf)
+            if best_conf < conf:
+                best_conf = conf
+                self._best_guess_prober = prober
+        if not self._best_guess_prober:
+            return 0.0
+        return best_conf
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..eac4e5986578636ad414648e6015e8b7e9f10432
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/charsetprober.py
@@ -0,0 +1,145 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import logging
+import re
+
+from .enums import ProbingState
+
+
+class CharSetProber(object):
+
+    SHORTCUT_THRESHOLD = 0.95
+
+    def __init__(self, lang_filter=None):
+        self._state = None
+        self.lang_filter = lang_filter
+        self.logger = logging.getLogger(__name__)
+
+    def reset(self):
+        self._state = ProbingState.DETECTING
+
+    @property
+    def charset_name(self):
+        return None
+
+    def feed(self, buf):
+        pass
+
+    @property
+    def state(self):
+        return self._state
+
+    def get_confidence(self):
+        return 0.0
+
+    @staticmethod
+    def filter_high_byte_only(buf):
+        buf = re.sub(b'([\x00-\x7F])+', b' ', buf)
+        return buf
+
+    @staticmethod
+    def filter_international_words(buf):
+        """
+        We define three types of bytes:
+        alphabet: english alphabets [a-zA-Z]
+        international: international characters [\x80-\xFF]
+        marker: everything else [^a-zA-Z\x80-\xFF]
+
+        The input buffer can be thought to contain a series of words delimited
+        by markers. This function works to filter all words that contain at
+        least one international character. All contiguous sequences of markers
+        are replaced by a single space ascii character.
+
+        This filter applies to all scripts which do not use English characters.
+        """
+        filtered = bytearray()
+
+        # This regex expression filters out only words that have at-least one
+        # international character. The word may include one marker character at
+        # the end.
+        words = re.findall(b'[a-zA-Z]*[\x80-\xFF]+[a-zA-Z]*[^a-zA-Z\x80-\xFF]?',
+                           buf)
+
+        for word in words:
+            filtered.extend(word[:-1])
+
+            # If the last character in the word is a marker, replace it with a
+            # space as markers shouldn't affect our analysis (they are used
+            # similarly across all languages and may thus have similar
+            # frequencies).
+            last_char = word[-1:]
+            if not last_char.isalpha() and last_char < b'\x80':
+                last_char = b' '
+            filtered.extend(last_char)
+
+        return filtered
+
+    @staticmethod
+    def filter_with_english_letters(buf):
+        """
+        Returns a copy of ``buf`` that retains only the sequences of English
+        alphabet and high byte characters that are not between <> characters.
+        Also retains English alphabet and high byte characters immediately
+        before occurrences of >.
+
+        This filter can be applied to all scripts which contain both English
+        characters and extended ASCII characters, but is currently only used by
+        ``Latin1Prober``.
+        """
+        filtered = bytearray()
+        in_tag = False
+        prev = 0
+
+        for curr in range(len(buf)):
+            # Slice here to get bytes instead of an int with Python 3
+            buf_char = buf[curr:curr + 1]
+            # Check if we're coming out of or entering an HTML tag
+            if buf_char == b'>':
+                in_tag = False
+            elif buf_char == b'<':
+                in_tag = True
+
+            # If current character is not extended-ASCII and not alphabetic...
+            if buf_char < b'\x80' and not buf_char.isalpha():
+                # ...and we're not in a tag
+                if curr > prev and not in_tag:
+                    # Keep everything after last non-extended-ASCII,
+                    # non-alphabetic character
+                    filtered.extend(buf[prev:curr])
+                    # Output a space to delimit stretch we kept
+                    filtered.extend(b' ')
+                prev = curr + 1
+
+        # If we're not in a tag...
+        if not in_tag:
+            # Keep everything after last non-extended-ASCII, non-alphabetic
+            # character
+            filtered.extend(buf[prev:])
+
+        return filtered
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8b137891791fe96927ad78e64b0aad7bded08bdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/__init__.py
@@ -0,0 +1 @@
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/chardetect.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/chardetect.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0a4cc5d79f2b42486631f96558a47093dd6298e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cli/chardetect.py
@@ -0,0 +1,85 @@
+#!/usr/bin/env python
+"""
+Script which takes one or more file paths and reports on their detected
+encodings
+
+Example::
+
+    % chardetect somefile someotherfile
+    somefile: windows-1252 with confidence 0.5
+    someotherfile: ascii with confidence 1.0
+
+If no paths are provided, it takes its input from stdin.
+
+"""
+
+from __future__ import absolute_import, print_function, unicode_literals
+
+import argparse
+import sys
+
+from chardet import __version__
+from chardet.compat import PY2
+from chardet.universaldetector import UniversalDetector
+
+
+def description_of(lines, name='stdin'):
+    """
+    Return a string describing the probable encoding of a file or
+    list of strings.
+
+    :param lines: The lines to get the encoding of.
+    :type lines: Iterable of bytes
+    :param name: Name of file or collection of lines
+    :type name: str
+    """
+    u = UniversalDetector()
+    for line in lines:
+        line = bytearray(line)
+        u.feed(line)
+        # shortcut out of the loop to save reading further - particularly useful if we read a BOM.
+        if u.done:
+            break
+    u.close()
+    result = u.result
+    if PY2:
+        name = name.decode(sys.getfilesystemencoding(), 'ignore')
+    if result['encoding']:
+        return '{0}: {1} with confidence {2}'.format(name, result['encoding'],
+                                                     result['confidence'])
+    else:
+        return '{0}: no result'.format(name)
+
+
+def main(argv=None):
+    """
+    Handles command line arguments and gets things started.
+
+    :param argv: List of arguments, as if specified on the command-line.
+                 If None, ``sys.argv[1:]`` is used instead.
+    :type argv: list of str
+    """
+    # Get command line arguments
+    parser = argparse.ArgumentParser(
+        description="Takes one or more file paths and reports their detected \
+                     encodings")
+    parser.add_argument('input',
+                        help='File whose encoding we would like to determine. \
+                              (default: stdin)',
+                        type=argparse.FileType('rb'), nargs='*',
+                        default=[sys.stdin if PY2 else sys.stdin.buffer])
+    parser.add_argument('--version', action='version',
+                        version='%(prog)s {0}'.format(__version__))
+    args = parser.parse_args(argv)
+
+    for f in args.input:
+        if f.isatty():
+            print("You are running chardetect interactively. Press " +
+                  "CTRL-D twice at the start of a blank line to signal the " +
+                  "end of your input. If you want help, run chardetect " +
+                  "--help\n", file=sys.stderr)
+        print(description_of(f, f.name))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/codingstatemachine.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/codingstatemachine.py
new file mode 100644
index 0000000000000000000000000000000000000000..68fba44f14366c448f13db3cf9cf1665af2e498c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/codingstatemachine.py
@@ -0,0 +1,88 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import logging
+
+from .enums import MachineState
+
+
+class CodingStateMachine(object):
+    """
+    A state machine to verify a byte sequence for a particular encoding. For
+    each byte the detector receives, it will feed that byte to every active
+    state machine available, one byte at a time. The state machine changes its
+    state based on its previous state and the byte it receives. There are 3
+    states in a state machine that are of interest to an auto-detector:
+
+    START state: This is the state to start with, or a legal byte sequence
+                 (i.e. a valid code point) for character has been identified.
+
+    ME state:  This indicates that the state machine identified a byte sequence
+               that is specific to the charset it is designed for and that
+               there is no other possible encoding which can contain this byte
+               sequence. This will to lead to an immediate positive answer for
+               the detector.
+
+    ERROR state: This indicates the state machine identified an illegal byte
+                 sequence for that encoding. This will lead to an immediate
+                 negative answer for this encoding. Detector will exclude this
+                 encoding from consideration from here on.
+    """
+    def __init__(self, sm):
+        self._model = sm
+        self._curr_byte_pos = 0
+        self._curr_char_len = 0
+        self._curr_state = None
+        self.logger = logging.getLogger(__name__)
+        self.reset()
+
+    def reset(self):
+        self._curr_state = MachineState.START
+
+    def next_state(self, c):
+        # for each byte we get its class
+        # if it is first byte, we also get byte length
+        byte_class = self._model['class_table'][c]
+        if self._curr_state == MachineState.START:
+            self._curr_byte_pos = 0
+            self._curr_char_len = self._model['char_len_table'][byte_class]
+        # from byte's class and state_table, we get its next state
+        curr_state = (self._curr_state * self._model['class_factor']
+                      + byte_class)
+        self._curr_state = self._model['state_table'][curr_state]
+        self._curr_byte_pos += 1
+        return self._curr_state
+
+    def get_current_charlen(self):
+        return self._curr_char_len
+
+    def get_coding_state_machine(self):
+        return self._model['name']
+
+    @property
+    def language(self):
+        return self._model['language']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddd74687c02a12ecc296ee803997a345e984bc9d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/compat.py
@@ -0,0 +1,34 @@
+######################## BEGIN LICENSE BLOCK ########################
+# Contributor(s):
+#   Dan Blanchard
+#   Ian Cordasco
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+import sys
+
+
+if sys.version_info < (3, 0):
+    PY2 = True
+    PY3 = False
+    base_str = (str, unicode)
+    text_type = unicode
+else:
+    PY2 = False
+    PY3 = True
+    base_str = (bytes, str)
+    text_type = str
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cp949prober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cp949prober.py
new file mode 100644
index 0000000000000000000000000000000000000000..efd793abca4bf496001a4e46a67557e5a6f16bba
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/cp949prober.py
@@ -0,0 +1,49 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .chardistribution import EUCKRDistributionAnalysis
+from .codingstatemachine import CodingStateMachine
+from .mbcharsetprober import MultiByteCharSetProber
+from .mbcssm import CP949_SM_MODEL
+
+
+class CP949Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(CP949Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(CP949_SM_MODEL)
+        # NOTE: CP949 is a superset of EUC-KR, so the distribution should be
+        #       not different.
+        self.distribution_analyzer = EUCKRDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "CP949"
+
+    @property
+    def language(self):
+        return "Korean"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/enums.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/enums.py
new file mode 100644
index 0000000000000000000000000000000000000000..04512072251c429e63ed110cdbafaf4b3cca3412
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/enums.py
@@ -0,0 +1,76 @@
+"""
+All of the Enums that are used throughout the chardet package.
+
+:author: Dan Blanchard (dan.blanchard@gmail.com)
+"""
+
+
+class InputState(object):
+    """
+    This enum represents the different states a universal detector can be in.
+    """
+    PURE_ASCII = 0
+    ESC_ASCII = 1
+    HIGH_BYTE = 2
+
+
+class LanguageFilter(object):
+    """
+    This enum represents the different language filters we can apply to a
+    ``UniversalDetector``.
+    """
+    CHINESE_SIMPLIFIED = 0x01
+    CHINESE_TRADITIONAL = 0x02
+    JAPANESE = 0x04
+    KOREAN = 0x08
+    NON_CJK = 0x10
+    ALL = 0x1F
+    CHINESE = CHINESE_SIMPLIFIED | CHINESE_TRADITIONAL
+    CJK = CHINESE | JAPANESE | KOREAN
+
+
+class ProbingState(object):
+    """
+    This enum represents the different states a prober can be in.
+    """
+    DETECTING = 0
+    FOUND_IT = 1
+    NOT_ME = 2
+
+
+class MachineState(object):
+    """
+    This enum represents the different states a state machine can be in.
+    """
+    START = 0
+    ERROR = 1
+    ITS_ME = 2
+
+
+class SequenceLikelihood(object):
+    """
+    This enum represents the likelihood of a character following the previous one.
+    """
+    NEGATIVE = 0
+    UNLIKELY = 1
+    LIKELY = 2
+    POSITIVE = 3
+
+    @classmethod
+    def get_num_categories(cls):
+        """:returns: The number of likelihood categories in the enum."""
+        return 4
+
+
+class CharacterCategory(object):
+    """
+    This enum represents the different categories language models for
+    ``SingleByteCharsetProber`` put characters into.
+
+    Anything less than CONTROL is considered a letter.
+    """
+    UNDEFINED = 255
+    LINE_BREAK = 254
+    SYMBOL = 253
+    DIGIT = 252
+    CONTROL = 251
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..c70493f2b131b32378612044f30173eabbfbc3f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escprober.py
@@ -0,0 +1,101 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .codingstatemachine import CodingStateMachine
+from .enums import LanguageFilter, ProbingState, MachineState
+from .escsm import (HZ_SM_MODEL, ISO2022CN_SM_MODEL, ISO2022JP_SM_MODEL,
+                    ISO2022KR_SM_MODEL)
+
+
+class EscCharSetProber(CharSetProber):
+    """
+    This CharSetProber uses a "code scheme" approach for detecting encodings,
+    whereby easily recognizable escape or shift sequences are relied on to
+    identify these encodings.
+    """
+
+    def __init__(self, lang_filter=None):
+        super(EscCharSetProber, self).__init__(lang_filter=lang_filter)
+        self.coding_sm = []
+        if self.lang_filter & LanguageFilter.CHINESE_SIMPLIFIED:
+            self.coding_sm.append(CodingStateMachine(HZ_SM_MODEL))
+            self.coding_sm.append(CodingStateMachine(ISO2022CN_SM_MODEL))
+        if self.lang_filter & LanguageFilter.JAPANESE:
+            self.coding_sm.append(CodingStateMachine(ISO2022JP_SM_MODEL))
+        if self.lang_filter & LanguageFilter.KOREAN:
+            self.coding_sm.append(CodingStateMachine(ISO2022KR_SM_MODEL))
+        self.active_sm_count = None
+        self._detected_charset = None
+        self._detected_language = None
+        self._state = None
+        self.reset()
+
+    def reset(self):
+        super(EscCharSetProber, self).reset()
+        for coding_sm in self.coding_sm:
+            if not coding_sm:
+                continue
+            coding_sm.active = True
+            coding_sm.reset()
+        self.active_sm_count = len(self.coding_sm)
+        self._detected_charset = None
+        self._detected_language = None
+
+    @property
+    def charset_name(self):
+        return self._detected_charset
+
+    @property
+    def language(self):
+        return self._detected_language
+
+    def get_confidence(self):
+        if self._detected_charset:
+            return 0.99
+        else:
+            return 0.00
+
+    def feed(self, byte_str):
+        for c in byte_str:
+            for coding_sm in self.coding_sm:
+                if not coding_sm or not coding_sm.active:
+                    continue
+                coding_state = coding_sm.next_state(c)
+                if coding_state == MachineState.ERROR:
+                    coding_sm.active = False
+                    self.active_sm_count -= 1
+                    if self.active_sm_count <= 0:
+                        self._state = ProbingState.NOT_ME
+                        return self.state
+                elif coding_state == MachineState.ITS_ME:
+                    self._state = ProbingState.FOUND_IT
+                    self._detected_charset = coding_sm.get_coding_state_machine()
+                    self._detected_language = coding_sm.language
+                    return self.state
+
+        return self.state
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escsm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escsm.py
new file mode 100644
index 0000000000000000000000000000000000000000..0069523a04969dd920ea4b43a497162157729174
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/escsm.py
@@ -0,0 +1,246 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import MachineState
+
+HZ_CLS = (
+1,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,0,0,0,0,  # 20 - 27
+0,0,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,0,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,4,0,5,2,0,  # 78 - 7f
+1,1,1,1,1,1,1,1,  # 80 - 87
+1,1,1,1,1,1,1,1,  # 88 - 8f
+1,1,1,1,1,1,1,1,  # 90 - 97
+1,1,1,1,1,1,1,1,  # 98 - 9f
+1,1,1,1,1,1,1,1,  # a0 - a7
+1,1,1,1,1,1,1,1,  # a8 - af
+1,1,1,1,1,1,1,1,  # b0 - b7
+1,1,1,1,1,1,1,1,  # b8 - bf
+1,1,1,1,1,1,1,1,  # c0 - c7
+1,1,1,1,1,1,1,1,  # c8 - cf
+1,1,1,1,1,1,1,1,  # d0 - d7
+1,1,1,1,1,1,1,1,  # d8 - df
+1,1,1,1,1,1,1,1,  # e0 - e7
+1,1,1,1,1,1,1,1,  # e8 - ef
+1,1,1,1,1,1,1,1,  # f0 - f7
+1,1,1,1,1,1,1,1,  # f8 - ff
+)
+
+HZ_ST = (
+MachineState.START,MachineState.ERROR,     3,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,     4,MachineState.ERROR,# 10-17
+     5,MachineState.ERROR,     6,MachineState.ERROR,     5,     5,     4,MachineState.ERROR,# 18-1f
+     4,MachineState.ERROR,     4,     4,     4,MachineState.ERROR,     4,MachineState.ERROR,# 20-27
+     4,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 28-2f
+)
+
+HZ_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)
+
+HZ_SM_MODEL = {'class_table': HZ_CLS,
+               'class_factor': 6,
+               'state_table': HZ_ST,
+               'char_len_table': HZ_CHAR_LEN_TABLE,
+               'name': "HZ-GB-2312",
+               'language': 'Chinese'}
+
+ISO2022CN_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,0,0,0,0,  # 20 - 27
+0,3,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,4,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022CN_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
+MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
+MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,# 18-1f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 20-27
+     5,     6,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 28-2f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 30-37
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,# 38-3f
+)
+
+ISO2022CN_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0)
+
+ISO2022CN_SM_MODEL = {'class_table': ISO2022CN_CLS,
+                      'class_factor': 9,
+                      'state_table': ISO2022CN_ST,
+                      'char_len_table': ISO2022CN_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-CN",
+                      'language': 'Chinese'}
+
+ISO2022JP_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,2,2,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,7,0,0,0,  # 20 - 27
+3,0,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+6,0,4,0,8,0,0,0,  # 40 - 47
+0,9,5,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022JP_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
+MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,# 18-1f
+MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 20-27
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     6,MachineState.ITS_ME,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,# 28-2f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,# 30-37
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 38-3f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.START,# 40-47
+)
+
+ISO2022JP_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
+
+ISO2022JP_SM_MODEL = {'class_table': ISO2022JP_CLS,
+                      'class_factor': 10,
+                      'state_table': ISO2022JP_ST,
+                      'char_len_table': ISO2022JP_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-JP",
+                      'language': 'Japanese'}
+
+ISO2022KR_CLS = (
+2,0,0,0,0,0,0,0,  # 00 - 07
+0,0,0,0,0,0,0,0,  # 08 - 0f
+0,0,0,0,0,0,0,0,  # 10 - 17
+0,0,0,1,0,0,0,0,  # 18 - 1f
+0,0,0,0,3,0,0,0,  # 20 - 27
+0,4,0,0,0,0,0,0,  # 28 - 2f
+0,0,0,0,0,0,0,0,  # 30 - 37
+0,0,0,0,0,0,0,0,  # 38 - 3f
+0,0,0,5,0,0,0,0,  # 40 - 47
+0,0,0,0,0,0,0,0,  # 48 - 4f
+0,0,0,0,0,0,0,0,  # 50 - 57
+0,0,0,0,0,0,0,0,  # 58 - 5f
+0,0,0,0,0,0,0,0,  # 60 - 67
+0,0,0,0,0,0,0,0,  # 68 - 6f
+0,0,0,0,0,0,0,0,  # 70 - 77
+0,0,0,0,0,0,0,0,  # 78 - 7f
+2,2,2,2,2,2,2,2,  # 80 - 87
+2,2,2,2,2,2,2,2,  # 88 - 8f
+2,2,2,2,2,2,2,2,  # 90 - 97
+2,2,2,2,2,2,2,2,  # 98 - 9f
+2,2,2,2,2,2,2,2,  # a0 - a7
+2,2,2,2,2,2,2,2,  # a8 - af
+2,2,2,2,2,2,2,2,  # b0 - b7
+2,2,2,2,2,2,2,2,  # b8 - bf
+2,2,2,2,2,2,2,2,  # c0 - c7
+2,2,2,2,2,2,2,2,  # c8 - cf
+2,2,2,2,2,2,2,2,  # d0 - d7
+2,2,2,2,2,2,2,2,  # d8 - df
+2,2,2,2,2,2,2,2,  # e0 - e7
+2,2,2,2,2,2,2,2,  # e8 - ef
+2,2,2,2,2,2,2,2,  # f0 - f7
+2,2,2,2,2,2,2,2,  # f8 - ff
+)
+
+ISO2022KR_ST = (
+MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
+MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 10-17
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 18-1f
+MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 20-27
+)
+
+ISO2022KR_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)
+
+ISO2022KR_SM_MODEL = {'class_table': ISO2022KR_CLS,
+                      'class_factor': 6,
+                      'state_table': ISO2022KR_ST,
+                      'char_len_table': ISO2022KR_CHAR_LEN_TABLE,
+                      'name': "ISO-2022-KR",
+                      'language': 'Korean'}
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/eucjpprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/eucjpprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..20ce8f7d15bad9d48a3e0363de2286093a4a28cc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/eucjpprober.py
@@ -0,0 +1,92 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import ProbingState, MachineState
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCJPDistributionAnalysis
+from .jpcntx import EUCJPContextAnalysis
+from .mbcssm import EUCJP_SM_MODEL
+
+
+class EUCJPProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCJPProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCJP_SM_MODEL)
+        self.distribution_analyzer = EUCJPDistributionAnalysis()
+        self.context_analyzer = EUCJPContextAnalysis()
+        self.reset()
+
+    def reset(self):
+        super(EUCJPProber, self).reset()
+        self.context_analyzer.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-JP"
+
+    @property
+    def language(self):
+        return "Japanese"
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            # PY3K: byte_str is a byte array, so byte_str[i] is an int, not a byte
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.context_analyzer.feed(self._last_char, char_len)
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.context_analyzer.feed(byte_str[i - 1:i + 1],
+                                                char_len)
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                     char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.context_analyzer.got_enough_data() and
+               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        context_conf = self.context_analyzer.get_confidence()
+        distrib_conf = self.distribution_analyzer.get_confidence()
+        return max(context_conf, distrib_conf)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrfreq.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrfreq.py
new file mode 100644
index 0000000000000000000000000000000000000000..b68078cb9680de4cca65b1145632a37c5e751c38
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrfreq.py
@@ -0,0 +1,195 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Sampling from about 20M text materials include literature and computer technology
+
+# 128  --> 0.79
+# 256  --> 0.92
+# 512  --> 0.986
+# 1024 --> 0.99944
+# 2048 --> 0.99999
+#
+# Idea Distribution Ratio = 0.98653 / (1-0.98653) = 73.24
+# Random Distribution Ration = 512 / (2350-512) = 0.279.
+#
+# Typical Distribution Ratio
+
+EUCKR_TYPICAL_DISTRIBUTION_RATIO = 6.0
+
+EUCKR_TABLE_SIZE = 2352
+
+# Char to FreqOrder table ,
+EUCKR_CHAR_TO_FREQ_ORDER = (
+  13, 130, 120,1396, 481,1719,1720, 328, 609, 212,1721, 707, 400, 299,1722,  87,
+1397,1723, 104, 536,1117,1203,1724,1267, 685,1268, 508,1725,1726,1727,1728,1398,
+1399,1729,1730,1731, 141, 621, 326,1057, 368,1732, 267, 488,  20,1733,1269,1734,
+ 945,1400,1735,  47, 904,1270,1736,1737, 773, 248,1738, 409, 313, 786, 429,1739,
+ 116, 987, 813,1401, 683,  75,1204, 145,1740,1741,1742,1743,  16, 847, 667, 622,
+ 708,1744,1745,1746, 966, 787, 304, 129,1747,  60, 820, 123, 676,1748,1749,1750,
+1751, 617,1752, 626,1753,1754,1755,1756, 653,1757,1758,1759,1760,1761,1762, 856,
+ 344,1763,1764,1765,1766,  89, 401, 418, 806, 905, 848,1767,1768,1769, 946,1205,
+ 709,1770,1118,1771, 241,1772,1773,1774,1271,1775, 569,1776, 999,1777,1778,1779,
+1780, 337, 751,1058,  28, 628, 254,1781, 177, 906, 270, 349, 891,1079,1782,  19,
+1783, 379,1784, 315,1785, 629, 754,1402, 559,1786, 636, 203,1206,1787, 710, 567,
+1788, 935, 814,1789,1790,1207, 766, 528,1791,1792,1208,1793,1794,1795,1796,1797,
+1403,1798,1799, 533,1059,1404,1405,1156,1406, 936, 884,1080,1800, 351,1801,1802,
+1803,1804,1805, 801,1806,1807,1808,1119,1809,1157, 714, 474,1407,1810, 298, 899,
+ 885,1811,1120, 802,1158,1812, 892,1813,1814,1408, 659,1815,1816,1121,1817,1818,
+1819,1820,1821,1822, 319,1823, 594, 545,1824, 815, 937,1209,1825,1826, 573,1409,
+1022,1827,1210,1828,1829,1830,1831,1832,1833, 556, 722, 807,1122,1060,1834, 697,
+1835, 900, 557, 715,1836,1410, 540,1411, 752,1159, 294, 597,1211, 976, 803, 770,
+1412,1837,1838,  39, 794,1413, 358,1839, 371, 925,1840, 453, 661, 788, 531, 723,
+ 544,1023,1081, 869,  91,1841, 392, 430, 790, 602,1414, 677,1082, 457,1415,1416,
+1842,1843, 475, 327,1024,1417, 795, 121,1844, 733, 403,1418,1845,1846,1847, 300,
+ 119, 711,1212, 627,1848,1272, 207,1849,1850, 796,1213, 382,1851, 519,1852,1083,
+ 893,1853,1854,1855, 367, 809, 487, 671,1856, 663,1857,1858, 956, 471, 306, 857,
+1859,1860,1160,1084,1861,1862,1863,1864,1865,1061,1866,1867,1868,1869,1870,1871,
+ 282,  96, 574,1872, 502,1085,1873,1214,1874, 907,1875,1876, 827, 977,1419,1420,
+1421, 268,1877,1422,1878,1879,1880, 308,1881,   2, 537,1882,1883,1215,1884,1885,
+ 127, 791,1886,1273,1423,1887,  34, 336, 404, 643,1888, 571, 654, 894, 840,1889,
+   0, 886,1274, 122, 575, 260, 908, 938,1890,1275, 410, 316,1891,1892, 100,1893,
+1894,1123,  48,1161,1124,1025,1895, 633, 901,1276,1896,1897, 115, 816,1898, 317,
+1899, 694,1900, 909, 734,1424, 572, 866,1425, 691,  85, 524,1010, 543, 394, 841,
+1901,1902,1903,1026,1904,1905,1906,1907,1908,1909,  30, 451, 651, 988, 310,1910,
+1911,1426, 810,1216,  93,1912,1913,1277,1217,1914, 858, 759,  45,  58, 181, 610,
+ 269,1915,1916, 131,1062, 551, 443,1000, 821,1427, 957, 895,1086,1917,1918, 375,
+1919, 359,1920, 687,1921, 822,1922, 293,1923,1924,  40, 662, 118, 692,  29, 939,
+ 887, 640, 482, 174,1925,  69,1162, 728,1428, 910,1926,1278,1218,1279, 386, 870,
+ 217, 854,1163, 823,1927,1928,1929,1930, 834,1931,  78,1932, 859,1933,1063,1934,
+1935,1936,1937, 438,1164, 208, 595,1938,1939,1940,1941,1219,1125,1942, 280, 888,
+1429,1430,1220,1431,1943,1944,1945,1946,1947,1280, 150, 510,1432,1948,1949,1950,
+1951,1952,1953,1954,1011,1087,1955,1433,1043,1956, 881,1957, 614, 958,1064,1065,
+1221,1958, 638,1001, 860, 967, 896,1434, 989, 492, 553,1281,1165,1959,1282,1002,
+1283,1222,1960,1961,1962,1963,  36, 383, 228, 753, 247, 454,1964, 876, 678,1965,
+1966,1284, 126, 464, 490, 835, 136, 672, 529, 940,1088,1435, 473,1967,1968, 467,
+  50, 390, 227, 587, 279, 378, 598, 792, 968, 240, 151, 160, 849, 882,1126,1285,
+ 639,1044, 133, 140, 288, 360, 811, 563,1027, 561, 142, 523,1969,1970,1971,   7,
+ 103, 296, 439, 407, 506, 634, 990,1972,1973,1974,1975, 645,1976,1977,1978,1979,
+1980,1981, 236,1982,1436,1983,1984,1089, 192, 828, 618, 518,1166, 333,1127,1985,
+ 818,1223,1986,1987,1988,1989,1990,1991,1992,1993, 342,1128,1286, 746, 842,1994,
+1995, 560, 223,1287,  98,   8, 189, 650, 978,1288,1996,1437,1997,  17, 345, 250,
+ 423, 277, 234, 512, 226,  97, 289,  42, 167,1998, 201,1999,2000, 843, 836, 824,
+ 532, 338, 783,1090, 182, 576, 436,1438,1439, 527, 500,2001, 947, 889,2002,2003,
+2004,2005, 262, 600, 314, 447,2006, 547,2007, 693, 738,1129,2008,  71,1440, 745,
+ 619, 688,2009, 829,2010,2011, 147,2012,  33, 948,2013,2014,  74, 224,2015,  61,
+ 191, 918, 399, 637,2016,1028,1130, 257, 902,2017,2018,2019,2020,2021,2022,2023,
+2024,2025,2026, 837,2027,2028,2029,2030, 179, 874, 591,  52, 724, 246,2031,2032,
+2033,2034,1167, 969,2035,1289, 630, 605, 911,1091,1168,2036,2037,2038,1441, 912,
+2039, 623,2040,2041, 253,1169,1290,2042,1442, 146, 620, 611, 577, 433,2043,1224,
+ 719,1170, 959, 440, 437, 534,  84, 388, 480,1131, 159, 220, 198, 679,2044,1012,
+ 819,1066,1443, 113,1225, 194, 318,1003,1029,2045,2046,2047,2048,1067,2049,2050,
+2051,2052,2053,  59, 913, 112,2054, 632,2055, 455, 144, 739,1291,2056, 273, 681,
+ 499,2057, 448,2058,2059, 760,2060,2061, 970, 384, 169, 245,1132,2062,2063, 414,
+1444,2064,2065,  41, 235,2066, 157, 252, 877, 568, 919, 789, 580,2067, 725,2068,
+2069,1292,2070,2071,1445,2072,1446,2073,2074,  55, 588,  66,1447, 271,1092,2075,
+1226,2076, 960,1013, 372,2077,2078,2079,2080,2081,1293,2082,2083,2084,2085, 850,
+2086,2087,2088,2089,2090, 186,2091,1068, 180,2092,2093,2094, 109,1227, 522, 606,
+2095, 867,1448,1093, 991,1171, 926, 353,1133,2096, 581,2097,2098,2099,1294,1449,
+1450,2100, 596,1172,1014,1228,2101,1451,1295,1173,1229,2102,2103,1296,1134,1452,
+ 949,1135,2104,2105,1094,1453,1454,1455,2106,1095,2107,2108,2109,2110,2111,2112,
+2113,2114,2115,2116,2117, 804,2118,2119,1230,1231, 805,1456, 405,1136,2120,2121,
+2122,2123,2124, 720, 701,1297, 992,1457, 927,1004,2125,2126,2127,2128,2129,2130,
+  22, 417,2131, 303,2132, 385,2133, 971, 520, 513,2134,1174,  73,1096, 231, 274,
+ 962,1458, 673,2135,1459,2136, 152,1137,2137,2138,2139,2140,1005,1138,1460,1139,
+2141,2142,2143,2144,  11, 374, 844,2145, 154,1232,  46,1461,2146, 838, 830, 721,
+1233, 106,2147,  90, 428, 462, 578, 566,1175, 352,2148,2149, 538,1234, 124,1298,
+2150,1462, 761, 565,2151, 686,2152, 649,2153,  72, 173,2154, 460, 415,2155,1463,
+2156,1235, 305,2157,2158,2159,2160,2161,2162, 579,2163,2164,2165,2166,2167, 747,
+2168,2169,2170,2171,1464, 669,2172,2173,2174,2175,2176,1465,2177,  23, 530, 285,
+2178, 335, 729,2179, 397,2180,2181,2182,1030,2183,2184, 698,2185,2186, 325,2187,
+2188, 369,2189, 799,1097,1015, 348,2190,1069, 680,2191, 851,1466,2192,2193,  10,
+2194, 613, 424,2195, 979, 108, 449, 589,  27, 172,  81,1031,  80, 774, 281, 350,
+1032, 525, 301, 582,1176,2196, 674,1045,2197,2198,1467, 730, 762,2199,2200,2201,
+2202,1468,2203, 993,2204,2205, 266,1070, 963,1140,2206,2207,2208, 664,1098, 972,
+2209,2210,2211,1177,1469,1470, 871,2212,2213,2214,2215,2216,1471,2217,2218,2219,
+2220,2221,2222,2223,2224,2225,2226,2227,1472,1236,2228,2229,2230,2231,2232,2233,
+2234,2235,1299,2236,2237, 200,2238, 477, 373,2239,2240, 731, 825, 777,2241,2242,
+2243, 521, 486, 548,2244,2245,2246,1473,1300,  53, 549, 137, 875,  76, 158,2247,
+1301,1474, 469, 396,1016, 278, 712,2248, 321, 442, 503, 767, 744, 941,1237,1178,
+1475,2249,  82, 178,1141,1179, 973,2250,1302,2251, 297,2252,2253, 570,2254,2255,
+2256,  18, 450, 206,2257, 290, 292,1142,2258, 511, 162,  99, 346, 164, 735,2259,
+1476,1477,   4, 554, 343, 798,1099,2260,1100,2261,  43, 171,1303, 139, 215,2262,
+2263, 717, 775,2264,1033, 322, 216,2265, 831,2266, 149,2267,1304,2268,2269, 702,
+1238, 135, 845, 347, 309,2270, 484,2271, 878, 655, 238,1006,1478,2272,  67,2273,
+ 295,2274,2275, 461,2276, 478, 942, 412,2277,1034,2278,2279,2280, 265,2281, 541,
+2282,2283,2284,2285,2286,  70, 852,1071,2287,2288,2289,2290,  21,  56, 509, 117,
+ 432,2291,2292, 331, 980, 552,1101, 148, 284, 105, 393,1180,1239, 755,2293, 187,
+2294,1046,1479,2295, 340,2296,  63,1047, 230,2297,2298,1305, 763,1306, 101, 800,
+ 808, 494,2299,2300,2301, 903,2302,  37,1072,  14,   5,2303,  79, 675,2304, 312,
+2305,2306,2307,2308,2309,1480,   6,1307,2310,2311,2312,   1, 470,  35,  24, 229,
+2313, 695, 210,  86, 778,  15, 784, 592, 779,  32,  77, 855, 964,2314, 259,2315,
+ 501, 380,2316,2317,  83, 981, 153, 689,1308,1481,1482,1483,2318,2319, 716,1484,
+2320,2321,2322,2323,2324,2325,1485,2326,2327, 128,  57,  68, 261,1048, 211, 170,
+1240,  31,2328,  51, 435, 742,2329,2330,2331, 635,2332, 264, 456,2333,2334,2335,
+ 425,2336,1486, 143, 507, 263, 943,2337, 363, 920,1487, 256,1488,1102, 243, 601,
+1489,2338,2339,2340,2341,2342,2343,2344, 861,2345,2346,2347,2348,2349,2350, 395,
+2351,1490,1491,  62, 535, 166, 225,2352,2353, 668, 419,1241, 138, 604, 928,2354,
+1181,2355,1492,1493,2356,2357,2358,1143,2359, 696,2360, 387, 307,1309, 682, 476,
+2361,2362, 332,  12, 222, 156,2363, 232,2364, 641, 276, 656, 517,1494,1495,1035,
+ 416, 736,1496,2365,1017, 586,2366,2367,2368,1497,2369, 242,2370,2371,2372,1498,
+2373, 965, 713,2374,2375,2376,2377, 740, 982,1499, 944,1500,1007,2378,2379,1310,
+1501,2380,2381,2382, 785, 329,2383,2384,1502,2385,2386,2387, 932,2388,1503,2389,
+2390,2391,2392,1242,2393,2394,2395,2396,2397, 994, 950,2398,2399,2400,2401,1504,
+1311,2402,2403,2404,2405,1049, 749,2406,2407, 853, 718,1144,1312,2408,1182,1505,
+2409,2410, 255, 516, 479, 564, 550, 214,1506,1507,1313, 413, 239, 444, 339,1145,
+1036,1508,1509,1314,1037,1510,1315,2411,1511,2412,2413,2414, 176, 703, 497, 624,
+ 593, 921, 302,2415, 341, 165,1103,1512,2416,1513,2417,2418,2419, 376,2420, 700,
+2421,2422,2423, 258, 768,1316,2424,1183,2425, 995, 608,2426,2427,2428,2429, 221,
+2430,2431,2432,2433,2434,2435,2436,2437, 195, 323, 726, 188, 897, 983,1317, 377,
+ 644,1050, 879,2438, 452,2439,2440,2441,2442,2443,2444, 914,2445,2446,2447,2448,
+ 915, 489,2449,1514,1184,2450,2451, 515,  64, 427, 495,2452, 583,2453, 483, 485,
+1038, 562, 213,1515, 748, 666,2454,2455,2456,2457, 334,2458, 780, 996,1008, 705,
+1243,2459,2460,2461,2462,2463, 114,2464, 493,1146, 366, 163,1516, 961,1104,2465,
+ 291,2466,1318,1105,2467,1517, 365,2468, 355, 951,1244,2469,1319,2470, 631,2471,
+2472, 218,1320, 364, 320, 756,1518,1519,1321,1520,1322,2473,2474,2475,2476, 997,
+2477,2478,2479,2480, 665,1185,2481, 916,1521,2482,2483,2484, 584, 684,2485,2486,
+ 797,2487,1051,1186,2488,2489,2490,1522,2491,2492, 370,2493,1039,1187,  65,2494,
+ 434, 205, 463,1188,2495, 125, 812, 391, 402, 826, 699, 286, 398, 155, 781, 771,
+ 585,2496, 590, 505,1073,2497, 599, 244, 219, 917,1018, 952, 646,1523,2498,1323,
+2499,2500,  49, 984, 354, 741,2501, 625,2502,1324,2503,1019, 190, 357, 757, 491,
+  95, 782, 868,2504,2505,2506,2507,2508,2509, 134,1524,1074, 422,1525, 898,2510,
+ 161,2511,2512,2513,2514, 769,2515,1526,2516,2517, 411,1325,2518, 472,1527,2519,
+2520,2521,2522,2523,2524, 985,2525,2526,2527,2528,2529,2530, 764,2531,1245,2532,
+2533,  25, 204, 311,2534, 496,2535,1052,2536,2537,2538,2539,2540,2541,2542, 199,
+ 704, 504, 468, 758, 657,1528, 196,  44, 839,1246, 272, 750,2543, 765, 862,2544,
+2545,1326,2546, 132, 615, 933,2547, 732,2548,2549,2550,1189,1529,2551, 283,1247,
+1053, 607, 929,2552,2553,2554, 930, 183, 872, 616,1040,1147,2555,1148,1020, 441,
+ 249,1075,2556,2557,2558, 466, 743,2559,2560,2561,  92, 514, 426, 420, 526,2562,
+2563,2564,2565,2566,2567,2568, 185,2569,2570,2571,2572, 776,1530, 658,2573, 362,
+2574, 361, 922,1076, 793,2575,2576,2577,2578,2579,2580,1531, 251,2581,2582,2583,
+2584,1532,  54, 612, 237,1327,2585,2586, 275, 408, 647, 111,2587,1533,1106, 465,
+   3, 458,   9,  38,2588, 107, 110, 890, 209,  26, 737, 498,2589,1534,2590, 431,
+ 202,  88,1535, 356, 287,1107, 660,1149,2591, 381,1536, 986,1150, 445,1248,1151,
+ 974,2592,2593, 846,2594, 446, 953, 184,1249,1250, 727,2595, 923, 193, 883,2596,
+2597,2598, 102, 324, 539, 817,2599, 421,1041,2600, 832,2601,  94, 175, 197, 406,
+2602, 459,2603,2604,2605,2606,2607, 330, 555,2608,2609,2610, 706,1108, 389,2611,
+2612,2613,2614, 233,2615, 833, 558, 931, 954,1251,2616,2617,1537, 546,2618,2619,
+1009,2620,2621,2622,1538, 690,1328,2623, 955,2624,1539,2625,2626, 772,2627,2628,
+2629,2630,2631, 924, 648, 863, 603,2632,2633, 934,1540, 864, 865,2634, 642,1042,
+ 670,1190,2635,2636,2637,2638, 168,2639, 652, 873, 542,1054,1541,2640,2641,2642,  # 512, 256
+)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..345a060d0230ada58f769b0f6b55f43a428fc3bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euckrprober.py
@@ -0,0 +1,47 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCKRDistributionAnalysis
+from .mbcssm import EUCKR_SM_MODEL
+
+
+class EUCKRProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCKRProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCKR_SM_MODEL)
+        self.distribution_analyzer = EUCKRDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-KR"
+
+    @property
+    def language(self):
+        return "Korean"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwfreq.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwfreq.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed7a995a3aa311583efa5a47e316d4490e5f3463
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwfreq.py
@@ -0,0 +1,387 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# EUCTW frequency table
+# Converted from big5 work
+# by Taiwan's Mandarin Promotion Council
+# <http:#www.edu.tw:81/mandr/>
+
+# 128  --> 0.42261
+# 256  --> 0.57851
+# 512  --> 0.74851
+# 1024 --> 0.89384
+# 2048 --> 0.97583
+#
+# Idea Distribution Ratio = 0.74851/(1-0.74851) =2.98
+# Random Distribution Ration = 512/(5401-512)=0.105
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR
+
+EUCTW_TYPICAL_DISTRIBUTION_RATIO = 0.75
+
+# Char to FreqOrder table ,
+EUCTW_TABLE_SIZE = 5376
+
+EUCTW_CHAR_TO_FREQ_ORDER = (
+   1,1800,1506, 255,1431, 198,   9,  82,   6,7310, 177, 202,3615,1256,2808, 110,  # 2742
+3735,  33,3241, 261,  76,  44,2113,  16,2931,2184,1176, 659,3868,  26,3404,2643,  # 2758
+1198,3869,3313,4060, 410,2211, 302, 590, 361,1963,   8, 204,  58,4296,7311,1931,  # 2774
+  63,7312,7313, 317,1614,  75, 222, 159,4061,2412,1480,7314,3500,3068, 224,2809,  # 2790
+3616,   3,  10,3870,1471,  29,2774,1135,2852,1939, 873, 130,3242,1123, 312,7315,  # 2806
+4297,2051, 507, 252, 682,7316, 142,1914, 124, 206,2932,  34,3501,3173,  64, 604,  # 2822
+7317,2494,1976,1977, 155,1990, 645, 641,1606,7318,3405, 337,  72, 406,7319,  80,  # 2838
+ 630, 238,3174,1509, 263, 939,1092,2644, 756,1440,1094,3406, 449,  69,2969, 591,  # 2854
+ 179,2095, 471, 115,2034,1843,  60,  50,2970, 134, 806,1868, 734,2035,3407, 180,  # 2870
+ 995,1607, 156, 537,2893, 688,7320, 319,1305, 779,2144, 514,2374, 298,4298, 359,  # 2886
+2495,  90,2707,1338, 663,  11, 906,1099,2545,  20,2436, 182, 532,1716,7321, 732,  # 2902
+1376,4062,1311,1420,3175,  25,2312,1056, 113, 399, 382,1949, 242,3408,2467, 529,  # 2918
+3243, 475,1447,3617,7322, 117,  21, 656, 810,1297,2295,2329,3502,7323, 126,4063,  # 2934
+ 706, 456, 150, 613,4299,  71,1118,2036,4064, 145,3069,  85, 835, 486,2114,1246,  # 2950
+1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,7324,2127,2354, 347,3736, 221,  # 2966
+3503,3110,7325,1955,1153,4065,  83, 296,1199,3070, 192, 624,  93,7326, 822,1897,  # 2982
+2810,3111, 795,2064, 991,1554,1542,1592,  27,  43,2853, 859, 139,1456, 860,4300,  # 2998
+ 437, 712,3871, 164,2392,3112, 695, 211,3017,2096, 195,3872,1608,3504,3505,3618,  # 3014
+3873, 234, 811,2971,2097,3874,2229,1441,3506,1615,2375, 668,2076,1638, 305, 228,  # 3030
+1664,4301, 467, 415,7327, 262,2098,1593, 239, 108, 300, 200,1033, 512,1247,2077,  # 3046
+7328,7329,2173,3176,3619,2673, 593, 845,1062,3244,  88,1723,2037,3875,1950, 212,  # 3062
+ 266, 152, 149, 468,1898,4066,4302,  77, 187,7330,3018,  37,   5,2972,7331,3876,  # 3078
+7332,7333,  39,2517,4303,2894,3177,2078,  55, 148,  74,4304, 545, 483,1474,1029,  # 3094
+1665, 217,1869,1531,3113,1104,2645,4067,  24, 172,3507, 900,3877,3508,3509,4305,  # 3110
+  32,1408,2811,1312, 329, 487,2355,2247,2708, 784,2674,   4,3019,3314,1427,1788,  # 3126
+ 188, 109, 499,7334,3620,1717,1789, 888,1217,3020,4306,7335,3510,7336,3315,1520,  # 3142
+3621,3878, 196,1034, 775,7337,7338, 929,1815, 249, 439,  38,7339,1063,7340, 794,  # 3158
+3879,1435,2296,  46, 178,3245,2065,7341,2376,7342, 214,1709,4307, 804,  35, 707,  # 3174
+ 324,3622,1601,2546, 140, 459,4068,7343,7344,1365, 839, 272, 978,2257,2572,3409,  # 3190
+2128,1363,3623,1423, 697, 100,3071,  48,  70,1231, 495,3114,2193,7345,1294,7346,  # 3206
+2079, 462, 586,1042,3246, 853, 256, 988, 185,2377,3410,1698, 434,1084,7347,3411,  # 3222
+ 314,2615,2775,4308,2330,2331, 569,2280, 637,1816,2518, 757,1162,1878,1616,3412,  # 3238
+ 287,1577,2115, 768,4309,1671,2854,3511,2519,1321,3737, 909,2413,7348,4069, 933,  # 3254
+3738,7349,2052,2356,1222,4310, 765,2414,1322, 786,4311,7350,1919,1462,1677,2895,  # 3270
+1699,7351,4312,1424,2437,3115,3624,2590,3316,1774,1940,3413,3880,4070, 309,1369,  # 3286
+1130,2812, 364,2230,1653,1299,3881,3512,3882,3883,2646, 525,1085,3021, 902,2000,  # 3302
+1475, 964,4313, 421,1844,1415,1057,2281, 940,1364,3116, 376,4314,4315,1381,   7,  # 3318
+2520, 983,2378, 336,1710,2675,1845, 321,3414, 559,1131,3022,2742,1808,1132,1313,  # 3334
+ 265,1481,1857,7352, 352,1203,2813,3247, 167,1089, 420,2814, 776, 792,1724,3513,  # 3350
+4071,2438,3248,7353,4072,7354, 446, 229, 333,2743, 901,3739,1200,1557,4316,2647,  # 3366
+1920, 395,2744,2676,3740,4073,1835, 125, 916,3178,2616,4317,7355,7356,3741,7357,  # 3382
+7358,7359,4318,3117,3625,1133,2547,1757,3415,1510,2313,1409,3514,7360,2145, 438,  # 3398
+2591,2896,2379,3317,1068, 958,3023, 461, 311,2855,2677,4074,1915,3179,4075,1978,  # 3414
+ 383, 750,2745,2617,4076, 274, 539, 385,1278,1442,7361,1154,1964, 384, 561, 210,  # 3430
+  98,1295,2548,3515,7362,1711,2415,1482,3416,3884,2897,1257, 129,7363,3742, 642,  # 3446
+ 523,2776,2777,2648,7364, 141,2231,1333,  68, 176, 441, 876, 907,4077, 603,2592,  # 3462
+ 710, 171,3417, 404, 549,  18,3118,2393,1410,3626,1666,7365,3516,4319,2898,4320,  # 3478
+7366,2973, 368,7367, 146, 366,  99, 871,3627,1543, 748, 807,1586,1185,  22,2258,  # 3494
+ 379,3743,3180,7368,3181, 505,1941,2618,1991,1382,2314,7369, 380,2357, 218, 702,  # 3510
+1817,1248,3418,3024,3517,3318,3249,7370,2974,3628, 930,3250,3744,7371,  59,7372,  # 3526
+ 585, 601,4078, 497,3419,1112,1314,4321,1801,7373,1223,1472,2174,7374, 749,1836,  # 3542
+ 690,1899,3745,1772,3885,1476, 429,1043,1790,2232,2116, 917,4079, 447,1086,1629,  # 3558
+7375, 556,7376,7377,2020,1654, 844,1090, 105, 550, 966,1758,2815,1008,1782, 686,  # 3574
+1095,7378,2282, 793,1602,7379,3518,2593,4322,4080,2933,2297,4323,3746, 980,2496,  # 3590
+ 544, 353, 527,4324, 908,2678,2899,7380, 381,2619,1942,1348,7381,1341,1252, 560,  # 3606
+3072,7382,3420,2856,7383,2053, 973, 886,2080, 143,4325,7384,7385, 157,3886, 496,  # 3622
+4081,  57, 840, 540,2038,4326,4327,3421,2117,1445, 970,2259,1748,1965,2081,4082,  # 3638
+3119,1234,1775,3251,2816,3629, 773,1206,2129,1066,2039,1326,3887,1738,1725,4083,  # 3654
+ 279,3120,  51,1544,2594, 423,1578,2130,2066, 173,4328,1879,7386,7387,1583, 264,  # 3670
+ 610,3630,4329,2439, 280, 154,7388,7389,7390,1739, 338,1282,3073, 693,2857,1411,  # 3686
+1074,3747,2440,7391,4330,7392,7393,1240, 952,2394,7394,2900,1538,2679, 685,1483,  # 3702
+4084,2468,1436, 953,4085,2054,4331, 671,2395,  79,4086,2441,3252, 608, 567,2680,  # 3718
+3422,4087,4088,1691, 393,1261,1791,2396,7395,4332,7396,7397,7398,7399,1383,1672,  # 3734
+3748,3182,1464, 522,1119, 661,1150, 216, 675,4333,3888,1432,3519, 609,4334,2681,  # 3750
+2397,7400,7401,7402,4089,3025,   0,7403,2469, 315, 231,2442, 301,3319,4335,2380,  # 3766
+7404, 233,4090,3631,1818,4336,4337,7405,  96,1776,1315,2082,7406, 257,7407,1809,  # 3782
+3632,2709,1139,1819,4091,2021,1124,2163,2778,1777,2649,7408,3074, 363,1655,3183,  # 3798
+7409,2975,7410,7411,7412,3889,1567,3890, 718, 103,3184, 849,1443, 341,3320,2934,  # 3814
+1484,7413,1712, 127,  67, 339,4092,2398, 679,1412, 821,7414,7415, 834, 738, 351,  # 3830
+2976,2146, 846, 235,1497,1880, 418,1992,3749,2710, 186,1100,2147,2746,3520,1545,  # 3846
+1355,2935,2858,1377, 583,3891,4093,2573,2977,7416,1298,3633,1078,2549,3634,2358,  # 3862
+  78,3750,3751, 267,1289,2099,2001,1594,4094, 348, 369,1274,2194,2175,1837,4338,  # 3878
+1820,2817,3635,2747,2283,2002,4339,2936,2748, 144,3321, 882,4340,3892,2749,3423,  # 3894
+4341,2901,7417,4095,1726, 320,7418,3893,3026, 788,2978,7419,2818,1773,1327,2859,  # 3910
+3894,2819,7420,1306,4342,2003,1700,3752,3521,2359,2650, 787,2022, 506, 824,3636,  # 3926
+ 534, 323,4343,1044,3322,2023,1900, 946,3424,7421,1778,1500,1678,7422,1881,4344,  # 3942
+ 165, 243,4345,3637,2521, 123, 683,4096, 764,4346,  36,3895,1792, 589,2902, 816,  # 3958
+ 626,1667,3027,2233,1639,1555,1622,3753,3896,7423,3897,2860,1370,1228,1932, 891,  # 3974
+2083,2903, 304,4097,7424, 292,2979,2711,3522, 691,2100,4098,1115,4347, 118, 662,  # 3990
+7425, 611,1156, 854,2381,1316,2861,   2, 386, 515,2904,7426,7427,3253, 868,2234,  # 4006
+1486, 855,2651, 785,2212,3028,7428,1040,3185,3523,7429,3121, 448,7430,1525,7431,  # 4022
+2164,4348,7432,3754,7433,4099,2820,3524,3122, 503, 818,3898,3123,1568, 814, 676,  # 4038
+1444, 306,1749,7434,3755,1416,1030, 197,1428, 805,2821,1501,4349,7435,7436,7437,  # 4054
+1993,7438,4350,7439,7440,2195,  13,2779,3638,2980,3124,1229,1916,7441,3756,2131,  # 4070
+7442,4100,4351,2399,3525,7443,2213,1511,1727,1120,7444,7445, 646,3757,2443, 307,  # 4086
+7446,7447,1595,3186,7448,7449,7450,3639,1113,1356,3899,1465,2522,2523,7451, 519,  # 4102
+7452, 128,2132,  92,2284,1979,7453,3900,1512, 342,3125,2196,7454,2780,2214,1980,  # 4118
+3323,7455, 290,1656,1317, 789, 827,2360,7456,3758,4352, 562, 581,3901,7457, 401,  # 4134
+4353,2248,  94,4354,1399,2781,7458,1463,2024,4355,3187,1943,7459, 828,1105,4101,  # 4150
+1262,1394,7460,4102, 605,4356,7461,1783,2862,7462,2822, 819,2101, 578,2197,2937,  # 4166
+7463,1502, 436,3254,4103,3255,2823,3902,2905,3425,3426,7464,2712,2315,7465,7466,  # 4182
+2332,2067,  23,4357, 193, 826,3759,2102, 699,1630,4104,3075, 390,1793,1064,3526,  # 4198
+7467,1579,3076,3077,1400,7468,4105,1838,1640,2863,7469,4358,4359, 137,4106, 598,  # 4214
+3078,1966, 780, 104, 974,2938,7470, 278, 899, 253, 402, 572, 504, 493,1339,7471,  # 4230
+3903,1275,4360,2574,2550,7472,3640,3029,3079,2249, 565,1334,2713, 863,  41,7473,  # 4246
+7474,4361,7475,1657,2333,  19, 463,2750,4107, 606,7476,2981,3256,1087,2084,1323,  # 4262
+2652,2982,7477,1631,1623,1750,4108,2682,7478,2864, 791,2714,2653,2334, 232,2416,  # 4278
+7479,2983,1498,7480,2654,2620, 755,1366,3641,3257,3126,2025,1609, 119,1917,3427,  # 4294
+ 862,1026,4109,7481,3904,3760,4362,3905,4363,2260,1951,2470,7482,1125, 817,4110,  # 4310
+4111,3906,1513,1766,2040,1487,4112,3030,3258,2824,3761,3127,7483,7484,1507,7485,  # 4326
+2683, 733,  40,1632,1106,2865, 345,4113, 841,2524, 230,4364,2984,1846,3259,3428,  # 4342
+7486,1263, 986,3429,7487, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562,3907,  # 4358
+3908,2939, 967,2751,2655,1349, 592,2133,1692,3324,2985,1994,4114,1679,3909,1901,  # 4374
+2185,7488, 739,3642,2715,1296,1290,7489,4115,2198,2199,1921,1563,2595,2551,1870,  # 4390
+2752,2986,7490, 435,7491, 343,1108, 596,  17,1751,4365,2235,3430,3643,7492,4366,  # 4406
+ 294,3527,2940,1693, 477, 979, 281,2041,3528, 643,2042,3644,2621,2782,2261,1031,  # 4422
+2335,2134,2298,3529,4367, 367,1249,2552,7493,3530,7494,4368,1283,3325,2004, 240,  # 4438
+1762,3326,4369,4370, 836,1069,3128, 474,7495,2148,2525, 268,3531,7496,3188,1521,  # 4454
+1284,7497,1658,1546,4116,7498,3532,3533,7499,4117,3327,2684,1685,4118, 961,1673,  # 4470
+2622, 190,2005,2200,3762,4371,4372,7500, 570,2497,3645,1490,7501,4373,2623,3260,  # 4486
+1956,4374, 584,1514, 396,1045,1944,7502,4375,1967,2444,7503,7504,4376,3910, 619,  # 4502
+7505,3129,3261, 215,2006,2783,2553,3189,4377,3190,4378, 763,4119,3763,4379,7506,  # 4518
+7507,1957,1767,2941,3328,3646,1174, 452,1477,4380,3329,3130,7508,2825,1253,2382,  # 4534
+2186,1091,2285,4120, 492,7509, 638,1169,1824,2135,1752,3911, 648, 926,1021,1324,  # 4550
+4381, 520,4382, 997, 847,1007, 892,4383,3764,2262,1871,3647,7510,2400,1784,4384,  # 4566
+1952,2942,3080,3191,1728,4121,2043,3648,4385,2007,1701,3131,1551,  30,2263,4122,  # 4582
+7511,2026,4386,3534,7512, 501,7513,4123, 594,3431,2165,1821,3535,3432,3536,3192,  # 4598
+ 829,2826,4124,7514,1680,3132,1225,4125,7515,3262,4387,4126,3133,2336,7516,4388,  # 4614
+4127,7517,3912,3913,7518,1847,2383,2596,3330,7519,4389, 374,3914, 652,4128,4129,  # 4630
+ 375,1140, 798,7520,7521,7522,2361,4390,2264, 546,1659, 138,3031,2445,4391,7523,  # 4646
+2250, 612,1848, 910, 796,3765,1740,1371, 825,3766,3767,7524,2906,2554,7525, 692,  # 4662
+ 444,3032,2624, 801,4392,4130,7526,1491, 244,1053,3033,4131,4132, 340,7527,3915,  # 4678
+1041,2987, 293,1168,  87,1357,7528,1539, 959,7529,2236, 721, 694,4133,3768, 219,  # 4694
+1478, 644,1417,3331,2656,1413,1401,1335,1389,3916,7530,7531,2988,2362,3134,1825,  # 4710
+ 730,1515, 184,2827,  66,4393,7532,1660,2943, 246,3332, 378,1457, 226,3433, 975,  # 4726
+3917,2944,1264,3537, 674, 696,7533, 163,7534,1141,2417,2166, 713,3538,3333,4394,  # 4742
+3918,7535,7536,1186,  15,7537,1079,1070,7538,1522,3193,3539, 276,1050,2716, 758,  # 4758
+1126, 653,2945,3263,7539,2337, 889,3540,3919,3081,2989, 903,1250,4395,3920,3434,  # 4774
+3541,1342,1681,1718, 766,3264, 286,  89,2946,3649,7540,1713,7541,2597,3334,2990,  # 4790
+7542,2947,2215,3194,2866,7543,4396,2498,2526, 181, 387,1075,3921, 731,2187,3335,  # 4806
+7544,3265, 310, 313,3435,2299, 770,4134,  54,3034, 189,4397,3082,3769,3922,7545,  # 4822
+1230,1617,1849, 355,3542,4135,4398,3336, 111,4136,3650,1350,3135,3436,3035,4137,  # 4838
+2149,3266,3543,7546,2784,3923,3924,2991, 722,2008,7547,1071, 247,1207,2338,2471,  # 4854
+1378,4399,2009, 864,1437,1214,4400, 373,3770,1142,2216, 667,4401, 442,2753,2555,  # 4870
+3771,3925,1968,4138,3267,1839, 837, 170,1107, 934,1336,1882,7548,7549,2118,4139,  # 4886
+2828, 743,1569,7550,4402,4140, 582,2384,1418,3437,7551,1802,7552, 357,1395,1729,  # 4902
+3651,3268,2418,1564,2237,7553,3083,3772,1633,4403,1114,2085,4141,1532,7554, 482,  # 4918
+2446,4404,7555,7556,1492, 833,1466,7557,2717,3544,1641,2829,7558,1526,1272,3652,  # 4934
+4142,1686,1794, 416,2556,1902,1953,1803,7559,3773,2785,3774,1159,2316,7560,2867,  # 4950
+4405,1610,1584,3036,2419,2754, 443,3269,1163,3136,7561,7562,3926,7563,4143,2499,  # 4966
+3037,4406,3927,3137,2103,1647,3545,2010,1872,4144,7564,4145, 431,3438,7565, 250,  # 4982
+  97,  81,4146,7566,1648,1850,1558, 160, 848,7567, 866, 740,1694,7568,2201,2830,  # 4998
+3195,4147,4407,3653,1687, 950,2472, 426, 469,3196,3654,3655,3928,7569,7570,1188,  # 5014
+ 424,1995, 861,3546,4148,3775,2202,2685, 168,1235,3547,4149,7571,2086,1674,4408,  # 5030
+3337,3270, 220,2557,1009,7572,3776, 670,2992, 332,1208, 717,7573,7574,3548,2447,  # 5046
+3929,3338,7575, 513,7576,1209,2868,3339,3138,4409,1080,7577,7578,7579,7580,2527,  # 5062
+3656,3549, 815,1587,3930,3931,7581,3550,3439,3777,1254,4410,1328,3038,1390,3932,  # 5078
+1741,3933,3778,3934,7582, 236,3779,2448,3271,7583,7584,3657,3780,1273,3781,4411,  # 5094
+7585, 308,7586,4412, 245,4413,1851,2473,1307,2575, 430, 715,2136,2449,7587, 270,  # 5110
+ 199,2869,3935,7588,3551,2718,1753, 761,1754, 725,1661,1840,4414,3440,3658,7589,  # 5126
+7590, 587,  14,3272, 227,2598, 326, 480,2265, 943,2755,3552, 291, 650,1883,7591,  # 5142
+1702,1226, 102,1547,  62,3441, 904,4415,3442,1164,4150,7592,7593,1224,1548,2756,  # 5158
+ 391, 498,1493,7594,1386,1419,7595,2055,1177,4416, 813, 880,1081,2363, 566,1145,  # 5174
+4417,2286,1001,1035,2558,2599,2238, 394,1286,7596,7597,2068,7598,  86,1494,1730,  # 5190
+3936, 491,1588, 745, 897,2948, 843,3340,3937,2757,2870,3273,1768, 998,2217,2069,  # 5206
+ 397,1826,1195,1969,3659,2993,3341, 284,7599,3782,2500,2137,2119,1903,7600,3938,  # 5222
+2150,3939,4151,1036,3443,1904, 114,2559,4152, 209,1527,7601,7602,2949,2831,2625,  # 5238
+2385,2719,3139, 812,2560,7603,3274,7604,1559, 737,1884,3660,1210, 885,  28,2686,  # 5254
+3553,3783,7605,4153,1004,1779,4418,7606, 346,1981,2218,2687,4419,3784,1742, 797,  # 5270
+1642,3940,1933,1072,1384,2151, 896,3941,3275,3661,3197,2871,3554,7607,2561,1958,  # 5286
+4420,2450,1785,7608,7609,7610,3942,4154,1005,1308,3662,4155,2720,4421,4422,1528,  # 5302
+2600, 161,1178,4156,1982, 987,4423,1101,4157, 631,3943,1157,3198,2420,1343,1241,  # 5318
+1016,2239,2562, 372, 877,2339,2501,1160, 555,1934, 911,3944,7611, 466,1170, 169,  # 5334
+1051,2907,2688,3663,2474,2994,1182,2011,2563,1251,2626,7612, 992,2340,3444,1540,  # 5350
+2721,1201,2070,2401,1996,2475,7613,4424, 528,1922,2188,1503,1873,1570,2364,3342,  # 5366
+3276,7614, 557,1073,7615,1827,3445,2087,2266,3140,3039,3084, 767,3085,2786,4425,  # 5382
+1006,4158,4426,2341,1267,2176,3664,3199, 778,3945,3200,2722,1597,2657,7616,4427,  # 5398
+7617,3446,7618,7619,7620,3277,2689,1433,3278, 131,  95,1504,3946, 723,4159,3141,  # 5414
+1841,3555,2758,2189,3947,2027,2104,3665,7621,2995,3948,1218,7622,3343,3201,3949,  # 5430
+4160,2576, 248,1634,3785, 912,7623,2832,3666,3040,3786, 654,  53,7624,2996,7625,  # 5446
+1688,4428, 777,3447,1032,3950,1425,7626, 191, 820,2120,2833, 971,4429, 931,3202,  # 5462
+ 135, 664, 783,3787,1997, 772,2908,1935,3951,3788,4430,2909,3203, 282,2723, 640,  # 5478
+1372,3448,1127, 922, 325,3344,7627,7628, 711,2044,7629,7630,3952,2219,2787,1936,  # 5494
+3953,3345,2220,2251,3789,2300,7631,4431,3790,1258,3279,3954,3204,2138,2950,3955,  # 5510
+3956,7632,2221, 258,3205,4432, 101,1227,7633,3280,1755,7634,1391,3281,7635,2910,  # 5526
+2056, 893,7636,7637,7638,1402,4161,2342,7639,7640,3206,3556,7641,7642, 878,1325,  # 5542
+1780,2788,4433, 259,1385,2577, 744,1183,2267,4434,7643,3957,2502,7644, 684,1024,  # 5558
+4162,7645, 472,3557,3449,1165,3282,3958,3959, 322,2152, 881, 455,1695,1152,1340,  # 5574
+ 660, 554,2153,4435,1058,4436,4163, 830,1065,3346,3960,4437,1923,7646,1703,1918,  # 5590
+7647, 932,2268, 122,7648,4438, 947, 677,7649,3791,2627, 297,1905,1924,2269,4439,  # 5606
+2317,3283,7650,7651,4164,7652,4165,  84,4166, 112, 989,7653, 547,1059,3961, 701,  # 5622
+3558,1019,7654,4167,7655,3450, 942, 639, 457,2301,2451, 993,2951, 407, 851, 494,  # 5638
+4440,3347, 927,7656,1237,7657,2421,3348, 573,4168, 680, 921,2911,1279,1874, 285,  # 5654
+ 790,1448,1983, 719,2167,7658,7659,4441,3962,3963,1649,7660,1541, 563,7661,1077,  # 5670
+7662,3349,3041,3451, 511,2997,3964,3965,3667,3966,1268,2564,3350,3207,4442,4443,  # 5686
+7663, 535,1048,1276,1189,2912,2028,3142,1438,1373,2834,2952,1134,2012,7664,4169,  # 5702
+1238,2578,3086,1259,7665, 700,7666,2953,3143,3668,4170,7667,4171,1146,1875,1906,  # 5718
+4444,2601,3967, 781,2422, 132,1589, 203, 147, 273,2789,2402, 898,1786,2154,3968,  # 5734
+3969,7668,3792,2790,7669,7670,4445,4446,7671,3208,7672,1635,3793, 965,7673,1804,  # 5750
+2690,1516,3559,1121,1082,1329,3284,3970,1449,3794,  65,1128,2835,2913,2759,1590,  # 5766
+3795,7674,7675,  12,2658,  45, 976,2579,3144,4447, 517,2528,1013,1037,3209,7676,  # 5782
+3796,2836,7677,3797,7678,3452,7679,2602, 614,1998,2318,3798,3087,2724,2628,7680,  # 5798
+2580,4172, 599,1269,7681,1810,3669,7682,2691,3088, 759,1060, 489,1805,3351,3285,  # 5814
+1358,7683,7684,2386,1387,1215,2629,2252, 490,7685,7686,4173,1759,2387,2343,7687,  # 5830
+4448,3799,1907,3971,2630,1806,3210,4449,3453,3286,2760,2344, 874,7688,7689,3454,  # 5846
+3670,1858,  91,2914,3671,3042,3800,4450,7690,3145,3972,2659,7691,3455,1202,1403,  # 5862
+3801,2954,2529,1517,2503,4451,3456,2504,7692,4452,7693,2692,1885,1495,1731,3973,  # 5878
+2365,4453,7694,2029,7695,7696,3974,2693,1216, 237,2581,4174,2319,3975,3802,4454,  # 5894
+4455,2694,3560,3457, 445,4456,7697,7698,7699,7700,2761,  61,3976,3672,1822,3977,  # 5910
+7701, 687,2045, 935, 925, 405,2660, 703,1096,1859,2725,4457,3978,1876,1367,2695,  # 5926
+3352, 918,2105,1781,2476, 334,3287,1611,1093,4458, 564,3146,3458,3673,3353, 945,  # 5942
+2631,2057,4459,7702,1925, 872,4175,7703,3459,2696,3089, 349,4176,3674,3979,4460,  # 5958
+3803,4177,3675,2155,3980,4461,4462,4178,4463,2403,2046, 782,3981, 400, 251,4179,  # 5974
+1624,7704,7705, 277,3676, 299,1265, 476,1191,3804,2121,4180,4181,1109, 205,7706,  # 5990
+2582,1000,2156,3561,1860,7707,7708,7709,4464,7710,4465,2565, 107,2477,2157,3982,  # 6006
+3460,3147,7711,1533, 541,1301, 158, 753,4182,2872,3562,7712,1696, 370,1088,4183,  # 6022
+4466,3563, 579, 327, 440, 162,2240, 269,1937,1374,3461, 968,3043,  56,1396,3090,  # 6038
+2106,3288,3354,7713,1926,2158,4467,2998,7714,3564,7715,7716,3677,4468,2478,7717,  # 6054
+2791,7718,1650,4469,7719,2603,7720,7721,3983,2661,3355,1149,3356,3984,3805,3985,  # 6070
+7722,1076,  49,7723, 951,3211,3289,3290, 450,2837, 920,7724,1811,2792,2366,4184,  # 6086
+1908,1138,2367,3806,3462,7725,3212,4470,1909,1147,1518,2423,4471,3807,7726,4472,  # 6102
+2388,2604, 260,1795,3213,7727,7728,3808,3291, 708,7729,3565,1704,7730,3566,1351,  # 6118
+1618,3357,2999,1886, 944,4185,3358,4186,3044,3359,4187,7731,3678, 422, 413,1714,  # 6134
+3292, 500,2058,2345,4188,2479,7732,1344,1910, 954,7733,1668,7734,7735,3986,2404,  # 6150
+4189,3567,3809,4190,7736,2302,1318,2505,3091, 133,3092,2873,4473, 629,  31,2838,  # 6166
+2697,3810,4474, 850, 949,4475,3987,2955,1732,2088,4191,1496,1852,7737,3988, 620,  # 6182
+3214, 981,1242,3679,3360,1619,3680,1643,3293,2139,2452,1970,1719,3463,2168,7738,  # 6198
+3215,7739,7740,3361,1828,7741,1277,4476,1565,2047,7742,1636,3568,3093,7743, 869,  # 6214
+2839, 655,3811,3812,3094,3989,3000,3813,1310,3569,4477,7744,7745,7746,1733, 558,  # 6230
+4478,3681, 335,1549,3045,1756,4192,3682,1945,3464,1829,1291,1192, 470,2726,2107,  # 6246
+2793, 913,1054,3990,7747,1027,7748,3046,3991,4479, 982,2662,3362,3148,3465,3216,  # 6262
+3217,1946,2794,7749, 571,4480,7750,1830,7751,3570,2583,1523,2424,7752,2089, 984,  # 6278
+4481,3683,1959,7753,3684, 852, 923,2795,3466,3685, 969,1519, 999,2048,2320,1705,  # 6294
+7754,3095, 615,1662, 151, 597,3992,2405,2321,1049, 275,4482,3686,4193, 568,3687,  # 6310
+3571,2480,4194,3688,7755,2425,2270, 409,3218,7756,1566,2874,3467,1002, 769,2840,  # 6326
+ 194,2090,3149,3689,2222,3294,4195, 628,1505,7757,7758,1763,2177,3001,3993, 521,  # 6342
+1161,2584,1787,2203,2406,4483,3994,1625,4196,4197, 412,  42,3096, 464,7759,2632,  # 6358
+4484,3363,1760,1571,2875,3468,2530,1219,2204,3814,2633,2140,2368,4485,4486,3295,  # 6374
+1651,3364,3572,7760,7761,3573,2481,3469,7762,3690,7763,7764,2271,2091, 460,7765,  # 6390
+4487,7766,3002, 962, 588,3574, 289,3219,2634,1116,  52,7767,3047,1796,7768,7769,  # 6406
+7770,1467,7771,1598,1143,3691,4198,1984,1734,1067,4488,1280,3365, 465,4489,1572,  # 6422
+ 510,7772,1927,2241,1812,1644,3575,7773,4490,3692,7774,7775,2663,1573,1534,7776,  # 6438
+7777,4199, 536,1807,1761,3470,3815,3150,2635,7778,7779,7780,4491,3471,2915,1911,  # 6454
+2796,7781,3296,1122, 377,3220,7782, 360,7783,7784,4200,1529, 551,7785,2059,3693,  # 6470
+1769,2426,7786,2916,4201,3297,3097,2322,2108,2030,4492,1404, 136,1468,1479, 672,  # 6486
+1171,3221,2303, 271,3151,7787,2762,7788,2049, 678,2727, 865,1947,4493,7789,2013,  # 6502
+3995,2956,7790,2728,2223,1397,3048,3694,4494,4495,1735,2917,3366,3576,7791,3816,  # 6518
+ 509,2841,2453,2876,3817,7792,7793,3152,3153,4496,4202,2531,4497,2304,1166,1010,  # 6534
+ 552, 681,1887,7794,7795,2957,2958,3996,1287,1596,1861,3154, 358, 453, 736, 175,  # 6550
+ 478,1117, 905,1167,1097,7796,1853,1530,7797,1706,7798,2178,3472,2287,3695,3473,  # 6566
+3577,4203,2092,4204,7799,3367,1193,2482,4205,1458,2190,2205,1862,1888,1421,3298,  # 6582
+2918,3049,2179,3474, 595,2122,7800,3997,7801,7802,4206,1707,2636, 223,3696,1359,  # 6598
+ 751,3098, 183,3475,7803,2797,3003, 419,2369, 633, 704,3818,2389, 241,7804,7805,  # 6614
+7806, 838,3004,3697,2272,2763,2454,3819,1938,2050,3998,1309,3099,2242,1181,7807,  # 6630
+1136,2206,3820,2370,1446,4207,2305,4498,7808,7809,4208,1055,2605, 484,3698,7810,  # 6646
+3999, 625,4209,2273,3368,1499,4210,4000,7811,4001,4211,3222,2274,2275,3476,7812,  # 6662
+7813,2764, 808,2606,3699,3369,4002,4212,3100,2532, 526,3370,3821,4213, 955,7814,  # 6678
+1620,4214,2637,2427,7815,1429,3700,1669,1831, 994, 928,7816,3578,1260,7817,7818,  # 6694
+7819,1948,2288, 741,2919,1626,4215,2729,2455, 867,1184, 362,3371,1392,7820,7821,  # 6710
+4003,4216,1770,1736,3223,2920,4499,4500,1928,2698,1459,1158,7822,3050,3372,2877,  # 6726
+1292,1929,2506,2842,3701,1985,1187,2071,2014,2607,4217,7823,2566,2507,2169,3702,  # 6742
+2483,3299,7824,3703,4501,7825,7826, 666,1003,3005,1022,3579,4218,7827,4502,1813,  # 6758
+2253, 574,3822,1603, 295,1535, 705,3823,4219, 283, 858, 417,7828,7829,3224,4503,  # 6774
+4504,3051,1220,1889,1046,2276,2456,4004,1393,1599, 689,2567, 388,4220,7830,2484,  # 6790
+ 802,7831,2798,3824,2060,1405,2254,7832,4505,3825,2109,1052,1345,3225,1585,7833,  # 6806
+ 809,7834,7835,7836, 575,2730,3477, 956,1552,1469,1144,2323,7837,2324,1560,2457,  # 6822
+3580,3226,4005, 616,2207,3155,2180,2289,7838,1832,7839,3478,4506,7840,1319,3704,  # 6838
+3705,1211,3581,1023,3227,1293,2799,7841,7842,7843,3826, 607,2306,3827, 762,2878,  # 6854
+1439,4221,1360,7844,1485,3052,7845,4507,1038,4222,1450,2061,2638,4223,1379,4508,  # 6870
+2585,7846,7847,4224,1352,1414,2325,2921,1172,7848,7849,3828,3829,7850,1797,1451,  # 6886
+7851,7852,7853,7854,2922,4006,4007,2485,2346, 411,4008,4009,3582,3300,3101,4509,  # 6902
+1561,2664,1452,4010,1375,7855,7856,  47,2959, 316,7857,1406,1591,2923,3156,7858,  # 6918
+1025,2141,3102,3157, 354,2731, 884,2224,4225,2407, 508,3706, 726,3583, 996,2428,  # 6934
+3584, 729,7859, 392,2191,1453,4011,4510,3707,7860,7861,2458,3585,2608,1675,2800,  # 6950
+ 919,2347,2960,2348,1270,4511,4012,  73,7862,7863, 647,7864,3228,2843,2255,1550,  # 6966
+1346,3006,7865,1332, 883,3479,7866,7867,7868,7869,3301,2765,7870,1212, 831,1347,  # 6982
+4226,4512,2326,3830,1863,3053, 720,3831,4513,4514,3832,7871,4227,7872,7873,4515,  # 6998
+7874,7875,1798,4516,3708,2609,4517,3586,1645,2371,7876,7877,2924, 669,2208,2665,  # 7014
+2429,7878,2879,7879,7880,1028,3229,7881,4228,2408,7882,2256,1353,7883,7884,4518,  # 7030
+3158, 518,7885,4013,7886,4229,1960,7887,2142,4230,7888,7889,3007,2349,2350,3833,  # 7046
+ 516,1833,1454,4014,2699,4231,4519,2225,2610,1971,1129,3587,7890,2766,7891,2961,  # 7062
+1422, 577,1470,3008,1524,3373,7892,7893, 432,4232,3054,3480,7894,2586,1455,2508,  # 7078
+2226,1972,1175,7895,1020,2732,4015,3481,4520,7896,2733,7897,1743,1361,3055,3482,  # 7094
+2639,4016,4233,4521,2290, 895, 924,4234,2170, 331,2243,3056, 166,1627,3057,1098,  # 7110
+7898,1232,2880,2227,3374,4522, 657, 403,1196,2372, 542,3709,3375,1600,4235,3483,  # 7126
+7899,4523,2767,3230, 576, 530,1362,7900,4524,2533,2666,3710,4017,7901, 842,3834,  # 7142
+7902,2801,2031,1014,4018, 213,2700,3376, 665, 621,4236,7903,3711,2925,2430,7904,  # 7158
+2431,3302,3588,3377,7905,4237,2534,4238,4525,3589,1682,4239,3484,1380,7906, 724,  # 7174
+2277, 600,1670,7907,1337,1233,4526,3103,2244,7908,1621,4527,7909, 651,4240,7910,  # 7190
+1612,4241,2611,7911,2844,7912,2734,2307,3058,7913, 716,2459,3059, 174,1255,2701,  # 7206
+4019,3590, 548,1320,1398, 728,4020,1574,7914,1890,1197,3060,4021,7915,3061,3062,  # 7222
+3712,3591,3713, 747,7916, 635,4242,4528,7917,7918,7919,4243,7920,7921,4529,7922,  # 7238
+3378,4530,2432, 451,7923,3714,2535,2072,4244,2735,4245,4022,7924,1764,4531,7925,  # 7254
+4246, 350,7926,2278,2390,2486,7927,4247,4023,2245,1434,4024, 488,4532, 458,4248,  # 7270
+4025,3715, 771,1330,2391,3835,2568,3159,2159,2409,1553,2667,3160,4249,7928,2487,  # 7286
+2881,2612,1720,2702,4250,3379,4533,7929,2536,4251,7930,3231,4252,2768,7931,2015,  # 7302
+2736,7932,1155,1017,3716,3836,7933,3303,2308, 201,1864,4253,1430,7934,4026,7935,  # 7318
+7936,7937,7938,7939,4254,1604,7940, 414,1865, 371,2587,4534,4535,3485,2016,3104,  # 7334
+4536,1708, 960,4255, 887, 389,2171,1536,1663,1721,7941,2228,4027,2351,2926,1580,  # 7350
+7942,7943,7944,1744,7945,2537,4537,4538,7946,4539,7947,2073,7948,7949,3592,3380,  # 7366
+2882,4256,7950,4257,2640,3381,2802, 673,2703,2460, 709,3486,4028,3593,4258,7951,  # 7382
+1148, 502, 634,7952,7953,1204,4540,3594,1575,4541,2613,3717,7954,3718,3105, 948,  # 7398
+3232, 121,1745,3837,1110,7955,4259,3063,2509,3009,4029,3719,1151,1771,3838,1488,  # 7414
+4030,1986,7956,2433,3487,7957,7958,2093,7959,4260,3839,1213,1407,2803, 531,2737,  # 7430
+2538,3233,1011,1537,7960,2769,4261,3106,1061,7961,3720,3721,1866,2883,7962,2017,  # 7446
+ 120,4262,4263,2062,3595,3234,2309,3840,2668,3382,1954,4542,7963,7964,3488,1047,  # 7462
+2704,1266,7965,1368,4543,2845, 649,3383,3841,2539,2738,1102,2846,2669,7966,7967,  # 7478
+1999,7968,1111,3596,2962,7969,2488,3842,3597,2804,1854,3384,3722,7970,7971,3385,  # 7494
+2410,2884,3304,3235,3598,7972,2569,7973,3599,2805,4031,1460, 856,7974,3600,7975,  # 7510
+2885,2963,7976,2886,3843,7977,4264, 632,2510, 875,3844,1697,3845,2291,7978,7979,  # 7526
+4544,3010,1239, 580,4545,4265,7980, 914, 936,2074,1190,4032,1039,2123,7981,7982,  # 7542
+7983,3386,1473,7984,1354,4266,3846,7985,2172,3064,4033, 915,3305,4267,4268,3306,  # 7558
+1605,1834,7986,2739, 398,3601,4269,3847,4034, 328,1912,2847,4035,3848,1331,4270,  # 7574
+3011, 937,4271,7987,3602,4036,4037,3387,2160,4546,3388, 524, 742, 538,3065,1012,  # 7590
+7988,7989,3849,2461,7990, 658,1103, 225,3850,7991,7992,4547,7993,4548,7994,3236,  # 7606
+1243,7995,4038, 963,2246,4549,7996,2705,3603,3161,7997,7998,2588,2327,7999,4550,  # 7622
+8000,8001,8002,3489,3307, 957,3389,2540,2032,1930,2927,2462, 870,2018,3604,1746,  # 7638
+2770,2771,2434,2463,8003,3851,8004,3723,3107,3724,3490,3390,3725,8005,1179,3066,  # 7654
+8006,3162,2373,4272,3726,2541,3163,3108,2740,4039,8007,3391,1556,2542,2292, 977,  # 7670
+2887,2033,4040,1205,3392,8008,1765,3393,3164,2124,1271,1689, 714,4551,3491,8009,  # 7686
+2328,3852, 533,4273,3605,2181, 617,8010,2464,3308,3492,2310,8011,8012,3165,8013,  # 7702
+8014,3853,1987, 618, 427,2641,3493,3394,8015,8016,1244,1690,8017,2806,4274,4552,  # 7718
+8018,3494,8019,8020,2279,1576, 473,3606,4275,3395, 972,8021,3607,8022,3067,8023,  # 7734
+8024,4553,4554,8025,3727,4041,4042,8026, 153,4555, 356,8027,1891,2888,4276,2143,  # 7750
+ 408, 803,2352,8028,3854,8029,4277,1646,2570,2511,4556,4557,3855,8030,3856,4278,  # 7766
+8031,2411,3396, 752,8032,8033,1961,2964,8034, 746,3012,2465,8035,4279,3728, 698,  # 7782
+4558,1892,4280,3608,2543,4559,3609,3857,8036,3166,3397,8037,1823,1302,4043,2706,  # 7798
+3858,1973,4281,8038,4282,3167, 823,1303,1288,1236,2848,3495,4044,3398, 774,3859,  # 7814
+8039,1581,4560,1304,2849,3860,4561,8040,2435,2161,1083,3237,4283,4045,4284, 344,  # 7830
+1173, 288,2311, 454,1683,8041,8042,1461,4562,4046,2589,8043,8044,4563, 985, 894,  # 7846
+8045,3399,3168,8046,1913,2928,3729,1988,8047,2110,1974,8048,4047,8049,2571,1194,  # 7862
+ 425,8050,4564,3169,1245,3730,4285,8051,8052,2850,8053, 636,4565,1855,3861, 760,  # 7878
+1799,8054,4286,2209,1508,4566,4048,1893,1684,2293,8055,8056,8057,4287,4288,2210,  # 7894
+ 479,8058,8059, 832,8060,4049,2489,8061,2965,2490,3731, 990,3109, 627,1814,2642,  # 7910
+4289,1582,4290,2125,2111,3496,4567,8062, 799,4291,3170,8063,4568,2112,1737,3013,  # 7926
+1018, 543, 754,4292,3309,1676,4569,4570,4050,8064,1489,8065,3497,8066,2614,2889,  # 7942
+4051,8067,8068,2966,8069,8070,8071,8072,3171,4571,4572,2182,1722,8073,3238,3239,  # 7958
+1842,3610,1715, 481, 365,1975,1856,8074,8075,1962,2491,4573,8076,2126,3611,3240,  # 7974
+ 433,1894,2063,2075,8077, 602,2741,8078,8079,8080,8081,8082,3014,1628,3400,8083,  # 7990
+3172,4574,4052,2890,4575,2512,8084,2544,2772,8085,8086,8087,3310,4576,2891,8088,  # 8006
+4577,8089,2851,4578,4579,1221,2967,4053,2513,8090,8091,8092,1867,1989,8093,8094,  # 8022
+8095,1895,8096,8097,4580,1896,4054, 318,8098,2094,4055,4293,8099,8100, 485,8101,  # 8038
+ 938,3862, 553,2670, 116,8102,3863,3612,8103,3498,2671,2773,3401,3311,2807,8104,  # 8054
+3613,2929,4056,1747,2930,2968,8105,8106, 207,8107,8108,2672,4581,2514,8109,3015,  # 8070
+ 890,3614,3864,8110,1877,3732,3402,8111,2183,2353,3403,1652,8112,8113,8114, 941,  # 8086
+2294, 208,3499,4057,2019, 330,4294,3865,2892,2492,3733,4295,8115,8116,8117,8118,  # 8102
+)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..35669cc4dd809fa4007ee67c752f1be991135e77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/euctwprober.py
@@ -0,0 +1,46 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import EUCTWDistributionAnalysis
+from .mbcssm import EUCTW_SM_MODEL
+
+class EUCTWProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(EUCTWProber, self).__init__()
+        self.coding_sm = CodingStateMachine(EUCTW_SM_MODEL)
+        self.distribution_analyzer = EUCTWDistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "EUC-TW"
+
+    @property
+    def language(self):
+        return "Taiwan"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312freq.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312freq.py
new file mode 100644
index 0000000000000000000000000000000000000000..697837bd9a87a77fc468fd1f10dd470d01701362
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312freq.py
@@ -0,0 +1,283 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# GB2312 most frequently used character table
+#
+# Char to FreqOrder table , from hz6763
+
+# 512  --> 0.79  -- 0.79
+# 1024 --> 0.92  -- 0.13
+# 2048 --> 0.98  -- 0.06
+# 6768 --> 1.00  -- 0.02
+#
+# Ideal Distribution Ratio = 0.79135/(1-0.79135) = 3.79
+# Random Distribution Ration = 512 / (3755 - 512) = 0.157
+#
+# Typical Distribution Ratio about 25% of Ideal one, still much higher that RDR
+
+GB2312_TYPICAL_DISTRIBUTION_RATIO = 0.9
+
+GB2312_TABLE_SIZE = 3760
+
+GB2312_CHAR_TO_FREQ_ORDER = (
+1671, 749,1443,2364,3924,3807,2330,3921,1704,3463,2691,1511,1515, 572,3191,2205,
+2361, 224,2558, 479,1711, 963,3162, 440,4060,1905,2966,2947,3580,2647,3961,3842,
+2204, 869,4207, 970,2678,5626,2944,2956,1479,4048, 514,3595, 588,1346,2820,3409,
+ 249,4088,1746,1873,2047,1774, 581,1813, 358,1174,3590,1014,1561,4844,2245, 670,
+1636,3112, 889,1286, 953, 556,2327,3060,1290,3141, 613, 185,3477,1367, 850,3820,
+1715,2428,2642,2303,2732,3041,2562,2648,3566,3946,1349, 388,3098,2091,1360,3585,
+ 152,1687,1539, 738,1559,  59,1232,2925,2267,1388,1249,1741,1679,2960, 151,1566,
+1125,1352,4271, 924,4296, 385,3166,4459, 310,1245,2850,  70,3285,2729,3534,3575,
+2398,3298,3466,1960,2265, 217,3647, 864,1909,2084,4401,2773,1010,3269,5152, 853,
+3051,3121,1244,4251,1895, 364,1499,1540,2313,1180,3655,2268, 562, 715,2417,3061,
+ 544, 336,3768,2380,1752,4075, 950, 280,2425,4382, 183,2759,3272, 333,4297,2155,
+1688,2356,1444,1039,4540, 736,1177,3349,2443,2368,2144,2225, 565, 196,1482,3406,
+ 927,1335,4147, 692, 878,1311,1653,3911,3622,1378,4200,1840,2969,3149,2126,1816,
+2534,1546,2393,2760, 737,2494,  13, 447, 245,2747,  38,2765,2129,2589,1079, 606,
+ 360, 471,3755,2890, 404, 848, 699,1785,1236, 370,2221,1023,3746,2074,2026,2023,
+2388,1581,2119, 812,1141,3091,2536,1519, 804,2053, 406,1596,1090, 784, 548,4414,
+1806,2264,2936,1100, 343,4114,5096, 622,3358, 743,3668,1510,1626,5020,3567,2513,
+3195,4115,5627,2489,2991,  24,2065,2697,1087,2719,  48,1634, 315,  68, 985,2052,
+ 198,2239,1347,1107,1439, 597,2366,2172, 871,3307, 919,2487,2790,1867, 236,2570,
+1413,3794, 906,3365,3381,1701,1982,1818,1524,2924,1205, 616,2586,2072,2004, 575,
+ 253,3099,  32,1365,1182, 197,1714,2454,1201, 554,3388,3224,2748, 756,2587, 250,
+2567,1507,1517,3529,1922,2761,2337,3416,1961,1677,2452,2238,3153, 615, 911,1506,
+1474,2495,1265,1906,2749,3756,3280,2161, 898,2714,1759,3450,2243,2444, 563,  26,
+3286,2266,3769,3344,2707,3677, 611,1402, 531,1028,2871,4548,1375, 261,2948, 835,
+1190,4134, 353, 840,2684,1900,3082,1435,2109,1207,1674, 329,1872,2781,4055,2686,
+2104, 608,3318,2423,2957,2768,1108,3739,3512,3271,3985,2203,1771,3520,1418,2054,
+1681,1153, 225,1627,2929, 162,2050,2511,3687,1954, 124,1859,2431,1684,3032,2894,
+ 585,4805,3969,2869,2704,2088,2032,2095,3656,2635,4362,2209, 256, 518,2042,2105,
+3777,3657, 643,2298,1148,1779, 190, 989,3544, 414,  11,2135,2063,2979,1471, 403,
+3678, 126, 770,1563, 671,2499,3216,2877, 600,1179, 307,2805,4937,1268,1297,2694,
+ 252,4032,1448,1494,1331,1394, 127,2256, 222,1647,1035,1481,3056,1915,1048, 873,
+3651, 210,  33,1608,2516, 200,1520, 415, 102,   0,3389,1287, 817,  91,3299,2940,
+ 836,1814, 549,2197,1396,1669,2987,3582,2297,2848,4528,1070, 687,  20,1819, 121,
+1552,1364,1461,1968,2617,3540,2824,2083, 177, 948,4938,2291, 110,4549,2066, 648,
+3359,1755,2110,2114,4642,4845,1693,3937,3308,1257,1869,2123, 208,1804,3159,2992,
+2531,2549,3361,2418,1350,2347,2800,2568,1291,2036,2680,  72, 842,1990, 212,1233,
+1154,1586,  75,2027,3410,4900,1823,1337,2710,2676, 728,2810,1522,3026,4995, 157,
+ 755,1050,4022, 710, 785,1936,2194,2085,1406,2777,2400, 150,1250,4049,1206, 807,
+1910, 534, 529,3309,1721,1660, 274,  39,2827, 661,2670,1578, 925,3248,3815,1094,
+4278,4901,4252,  41,1150,3747,2572,2227,4501,3658,4902,3813,3357,3617,2884,2258,
+ 887, 538,4187,3199,1294,2439,3042,2329,2343,2497,1255, 107, 543,1527, 521,3478,
+3568, 194,5062,  15, 961,3870,1241,1192,2664,  66,5215,3260,2111,1295,1127,2152,
+3805,4135, 901,1164,1976, 398,1278, 530,1460, 748, 904,1054,1966,1426,  53,2909,
+ 509, 523,2279,1534, 536,1019, 239,1685, 460,2353, 673,1065,2401,3600,4298,2272,
+1272,2363, 284,1753,3679,4064,1695,  81, 815,2677,2757,2731,1386, 859, 500,4221,
+2190,2566, 757,1006,2519,2068,1166,1455, 337,2654,3203,1863,1682,1914,3025,1252,
+1409,1366, 847, 714,2834,2038,3209, 964,2970,1901, 885,2553,1078,1756,3049, 301,
+1572,3326, 688,2130,1996,2429,1805,1648,2930,3421,2750,3652,3088, 262,1158,1254,
+ 389,1641,1812, 526,1719, 923,2073,1073,1902, 468, 489,4625,1140, 857,2375,3070,
+3319,2863, 380, 116,1328,2693,1161,2244, 273,1212,1884,2769,3011,1775,1142, 461,
+3066,1200,2147,2212, 790, 702,2695,4222,1601,1058, 434,2338,5153,3640,  67,2360,
+4099,2502, 618,3472,1329, 416,1132, 830,2782,1807,2653,3211,3510,1662, 192,2124,
+ 296,3979,1739,1611,3684,  23, 118, 324, 446,1239,1225, 293,2520,3814,3795,2535,
+3116,  17,1074, 467,2692,2201, 387,2922,  45,1326,3055,1645,3659,2817, 958, 243,
+1903,2320,1339,2825,1784,3289, 356, 576, 865,2315,2381,3377,3916,1088,3122,1713,
+1655, 935, 628,4689,1034,1327, 441, 800, 720, 894,1979,2183,1528,5289,2702,1071,
+4046,3572,2399,1571,3281,  79, 761,1103, 327, 134, 758,1899,1371,1615, 879, 442,
+ 215,2605,2579, 173,2048,2485,1057,2975,3317,1097,2253,3801,4263,1403,1650,2946,
+ 814,4968,3487,1548,2644,1567,1285,   2, 295,2636,  97, 946,3576, 832, 141,4257,
+3273, 760,3821,3521,3156,2607, 949,1024,1733,1516,1803,1920,2125,2283,2665,3180,
+1501,2064,3560,2171,1592, 803,3518,1416, 732,3897,4258,1363,1362,2458, 119,1427,
+ 602,1525,2608,1605,1639,3175, 694,3064,  10, 465,  76,2000,4846,4208, 444,3781,
+1619,3353,2206,1273,3796, 740,2483, 320,1723,2377,3660,2619,1359,1137,1762,1724,
+2345,2842,1850,1862, 912, 821,1866, 612,2625,1735,2573,3369,1093, 844,  89, 937,
+ 930,1424,3564,2413,2972,1004,3046,3019,2011, 711,3171,1452,4178, 428, 801,1943,
+ 432, 445,2811, 206,4136,1472, 730, 349,  73, 397,2802,2547, 998,1637,1167, 789,
+ 396,3217, 154,1218, 716,1120,1780,2819,4826,1931,3334,3762,2139,1215,2627, 552,
+3664,3628,3232,1405,2383,3111,1356,2652,3577,3320,3101,1703, 640,1045,1370,1246,
+4996, 371,1575,2436,1621,2210, 984,4033,1734,2638,  16,4529, 663,2755,3255,1451,
+3917,2257,1253,1955,2234,1263,2951, 214,1229, 617, 485, 359,1831,1969, 473,2310,
+ 750,2058, 165,  80,2864,2419, 361,4344,2416,2479,1134, 796,3726,1266,2943, 860,
+2715, 938, 390,2734,1313,1384, 248, 202, 877,1064,2854, 522,3907, 279,1602, 297,
+2357, 395,3740, 137,2075, 944,4089,2584,1267,3802,  62,1533,2285, 178, 176, 780,
+2440, 201,3707, 590, 478,1560,4354,2117,1075,  30,  74,4643,4004,1635,1441,2745,
+ 776,2596, 238,1077,1692,1912,2844, 605, 499,1742,3947, 241,3053, 980,1749, 936,
+2640,4511,2582, 515,1543,2162,5322,2892,2993, 890,2148,1924, 665,1827,3581,1032,
+ 968,3163, 339,1044,1896, 270, 583,1791,1720,4367,1194,3488,3669,  43,2523,1657,
+ 163,2167, 290,1209,1622,3378, 550, 634,2508,2510, 695,2634,2384,2512,1476,1414,
+ 220,1469,2341,2138,2852,3183,2900,4939,2865,3502,1211,3680, 854,3227,1299,2976,
+3172, 186,2998,1459, 443,1067,3251,1495, 321,1932,3054, 909, 753,1410,1828, 436,
+2441,1119,1587,3164,2186,1258, 227, 231,1425,1890,3200,3942, 247, 959, 725,5254,
+2741, 577,2158,2079, 929, 120, 174, 838,2813, 591,1115, 417,2024,  40,3240,1536,
+1037, 291,4151,2354, 632,1298,2406,2500,3535,1825,1846,3451, 205,1171, 345,4238,
+  18,1163, 811, 685,2208,1217, 425,1312,1508,1175,4308,2552,1033, 587,1381,3059,
+2984,3482, 340,1316,4023,3972, 792,3176, 519, 777,4690, 918, 933,4130,2981,3741,
+  90,3360,2911,2200,5184,4550, 609,3079,2030, 272,3379,2736, 363,3881,1130,1447,
+ 286, 779, 357,1169,3350,3137,1630,1220,2687,2391, 747,1277,3688,2618,2682,2601,
+1156,3196,5290,4034,3102,1689,3596,3128, 874, 219,2783, 798, 508,1843,2461, 269,
+1658,1776,1392,1913,2983,3287,2866,2159,2372, 829,4076,  46,4253,2873,1889,1894,
+ 915,1834,1631,2181,2318, 298, 664,2818,3555,2735, 954,3228,3117, 527,3511,2173,
+ 681,2712,3033,2247,2346,3467,1652, 155,2164,3382, 113,1994, 450, 899, 494, 994,
+1237,2958,1875,2336,1926,3727, 545,1577,1550, 633,3473, 204,1305,3072,2410,1956,
+2471, 707,2134, 841,2195,2196,2663,3843,1026,4940, 990,3252,4997, 368,1092, 437,
+3212,3258,1933,1829, 675,2977,2893, 412, 943,3723,4644,3294,3283,2230,2373,5154,
+2389,2241,2661,2323,1404,2524, 593, 787, 677,3008,1275,2059, 438,2709,2609,2240,
+2269,2246,1446,  36,1568,1373,3892,1574,2301,1456,3962, 693,2276,5216,2035,1143,
+2720,1919,1797,1811,2763,4137,2597,1830,1699,1488,1198,2090, 424,1694, 312,3634,
+3390,4179,3335,2252,1214, 561,1059,3243,2295,2561, 975,5155,2321,2751,3772, 472,
+1537,3282,3398,1047,2077,2348,2878,1323,3340,3076, 690,2906,  51, 369, 170,3541,
+1060,2187,2688,3670,2541,1083,1683, 928,3918, 459, 109,4427, 599,3744,4286, 143,
+2101,2730,2490,  82,1588,3036,2121, 281,1860, 477,4035,1238,2812,3020,2716,3312,
+1530,2188,2055,1317, 843, 636,1808,1173,3495, 649, 181,1002, 147,3641,1159,2414,
+3750,2289,2795, 813,3123,2610,1136,4368,   5,3391,4541,2174, 420, 429,1728, 754,
+1228,2115,2219, 347,2223,2733, 735,1518,3003,2355,3134,1764,3948,3329,1888,2424,
+1001,1234,1972,3321,3363,1672,1021,1450,1584, 226, 765, 655,2526,3404,3244,2302,
+3665, 731, 594,2184, 319,1576, 621, 658,2656,4299,2099,3864,1279,2071,2598,2739,
+ 795,3086,3699,3908,1707,2352,2402,1382,3136,2475,1465,4847,3496,3865,1085,3004,
+2591,1084, 213,2287,1963,3565,2250, 822, 793,4574,3187,1772,1789,3050, 595,1484,
+1959,2770,1080,2650, 456, 422,2996, 940,3322,4328,4345,3092,2742, 965,2784, 739,
+4124, 952,1358,2498,2949,2565, 332,2698,2378, 660,2260,2473,4194,3856,2919, 535,
+1260,2651,1208,1428,1300,1949,1303,2942, 433,2455,2450,1251,1946, 614,1269, 641,
+1306,1810,2737,3078,2912, 564,2365,1419,1415,1497,4460,2367,2185,1379,3005,1307,
+3218,2175,1897,3063, 682,1157,4040,4005,1712,1160,1941,1399, 394, 402,2952,1573,
+1151,2986,2404, 862, 299,2033,1489,3006, 346, 171,2886,3401,1726,2932, 168,2533,
+  47,2507,1030,3735,1145,3370,1395,1318,1579,3609,4560,2857,4116,1457,2529,1965,
+ 504,1036,2690,2988,2405, 745,5871, 849,2397,2056,3081, 863,2359,3857,2096,  99,
+1397,1769,2300,4428,1643,3455,1978,1757,3718,1440,  35,4879,3742,1296,4228,2280,
+ 160,5063,1599,2013, 166, 520,3479,1646,3345,3012, 490,1937,1545,1264,2182,2505,
+1096,1188,1369,1436,2421,1667,2792,2460,1270,2122, 727,3167,2143, 806,1706,1012,
+1800,3037, 960,2218,1882, 805, 139,2456,1139,1521, 851,1052,3093,3089, 342,2039,
+ 744,5097,1468,1502,1585,2087, 223, 939, 326,2140,2577, 892,2481,1623,4077, 982,
+3708, 135,2131,  87,2503,3114,2326,1106, 876,1616, 547,2997,2831,2093,3441,4530,
+4314,   9,3256,4229,4148, 659,1462,1986,1710,2046,2913,2231,4090,4880,5255,3392,
+3274,1368,3689,4645,1477, 705,3384,3635,1068,1529,2941,1458,3782,1509, 100,1656,
+2548, 718,2339, 408,1590,2780,3548,1838,4117,3719,1345,3530, 717,3442,2778,3220,
+2898,1892,4590,3614,3371,2043,1998,1224,3483, 891, 635, 584,2559,3355, 733,1766,
+1729,1172,3789,1891,2307, 781,2982,2271,1957,1580,5773,2633,2005,4195,3097,1535,
+3213,1189,1934,5693,3262, 586,3118,1324,1598, 517,1564,2217,1868,1893,4445,3728,
+2703,3139,1526,1787,1992,3882,2875,1549,1199,1056,2224,1904,2711,5098,4287, 338,
+1993,3129,3489,2689,1809,2815,1997, 957,1855,3898,2550,3275,3057,1105,1319, 627,
+1505,1911,1883,3526, 698,3629,3456,1833,1431, 746,  77,1261,2017,2296,1977,1885,
+ 125,1334,1600, 525,1798,1109,2222,1470,1945, 559,2236,1186,3443,2476,1929,1411,
+2411,3135,1777,3372,2621,1841,1613,3229, 668,1430,1839,2643,2916, 195,1989,2671,
+2358,1387, 629,3205,2293,5256,4439, 123,1310, 888,1879,4300,3021,3605,1003,1162,
+3192,2910,2010, 140,2395,2859,  55,1082,2012,2901, 662, 419,2081,1438, 680,2774,
+4654,3912,1620,1731,1625,5035,4065,2328, 512,1344, 802,5443,2163,2311,2537, 524,
+3399,  98,1155,2103,1918,2606,3925,2816,1393,2465,1504,3773,2177,3963,1478,4346,
+ 180,1113,4655,3461,2028,1698, 833,2696,1235,1322,1594,4408,3623,3013,3225,2040,
+3022, 541,2881, 607,3632,2029,1665,1219, 639,1385,1686,1099,2803,3231,1938,3188,
+2858, 427, 676,2772,1168,2025, 454,3253,2486,3556, 230,1950, 580, 791,1991,1280,
+1086,1974,2034, 630, 257,3338,2788,4903,1017,  86,4790, 966,2789,1995,1696,1131,
+ 259,3095,4188,1308, 179,1463,5257, 289,4107,1248,  42,3413,1725,2288, 896,1947,
+ 774,4474,4254, 604,3430,4264, 392,2514,2588, 452, 237,1408,3018, 988,4531,1970,
+3034,3310, 540,2370,1562,1288,2990, 502,4765,1147,   4,1853,2708, 207, 294,2814,
+4078,2902,2509, 684,  34,3105,3532,2551, 644, 709,2801,2344, 573,1727,3573,3557,
+2021,1081,3100,4315,2100,3681, 199,2263,1837,2385, 146,3484,1195,2776,3949, 997,
+1939,3973,1008,1091,1202,1962,1847,1149,4209,5444,1076, 493, 117,5400,2521, 972,
+1490,2934,1796,4542,2374,1512,2933,2657, 413,2888,1135,2762,2314,2156,1355,2369,
+ 766,2007,2527,2170,3124,2491,2593,2632,4757,2437, 234,3125,3591,1898,1750,1376,
+1942,3468,3138, 570,2127,2145,3276,4131, 962, 132,1445,4196,  19, 941,3624,3480,
+3366,1973,1374,4461,3431,2629, 283,2415,2275, 808,2887,3620,2112,2563,1353,3610,
+ 955,1089,3103,1053,  96,  88,4097, 823,3808,1583, 399, 292,4091,3313, 421,1128,
+ 642,4006, 903,2539,1877,2082, 596,  29,4066,1790, 722,2157, 130, 995,1569, 769,
+1485, 464, 513,2213, 288,1923,1101,2453,4316, 133, 486,2445,  50, 625, 487,2207,
+  57, 423, 481,2962, 159,3729,1558, 491, 303, 482, 501, 240,2837, 112,3648,2392,
+1783, 362,   8,3433,3422, 610,2793,3277,1390,1284,1654,  21,3823, 734, 367, 623,
+ 193, 287, 374,1009,1483, 816, 476, 313,2255,2340,1262,2150,2899,1146,2581, 782,
+2116,1659,2018,1880, 255,3586,3314,1110,2867,2137,2564, 986,2767,5185,2006, 650,
+ 158, 926, 762, 881,3157,2717,2362,3587, 306,3690,3245,1542,3077,2427,1691,2478,
+2118,2985,3490,2438, 539,2305, 983, 129,1754, 355,4201,2386, 827,2923, 104,1773,
+2838,2771, 411,2905,3919, 376, 767, 122,1114, 828,2422,1817,3506, 266,3460,1007,
+1609,4998, 945,2612,4429,2274, 726,1247,1964,2914,2199,2070,4002,4108, 657,3323,
+1422, 579, 455,2764,4737,1222,2895,1670, 824,1223,1487,2525, 558, 861,3080, 598,
+2659,2515,1967, 752,2583,2376,2214,4180, 977, 704,2464,4999,2622,4109,1210,2961,
+ 819,1541, 142,2284,  44, 418, 457,1126,3730,4347,4626,1644,1876,3671,1864, 302,
+1063,5694, 624, 723,1984,3745,1314,1676,2488,1610,1449,3558,3569,2166,2098, 409,
+1011,2325,3704,2306, 818,1732,1383,1824,1844,3757, 999,2705,3497,1216,1423,2683,
+2426,2954,2501,2726,2229,1475,2554,5064,1971,1794,1666,2014,1343, 783, 724, 191,
+2434,1354,2220,5065,1763,2752,2472,4152, 131, 175,2885,3434,  92,1466,4920,2616,
+3871,3872,3866, 128,1551,1632, 669,1854,3682,4691,4125,1230, 188,2973,3290,1302,
+1213, 560,3266, 917, 763,3909,3249,1760, 868,1958, 764,1782,2097, 145,2277,3774,
+4462,  64,1491,3062, 971,2132,3606,2442, 221,1226,1617, 218, 323,1185,3207,3147,
+ 571, 619,1473,1005,1744,2281, 449,1887,2396,3685, 275, 375,3816,1743,3844,3731,
+ 845,1983,2350,4210,1377, 773, 967,3499,3052,3743,2725,4007,1697,1022,3943,1464,
+3264,2855,2722,1952,1029,2839,2467,  84,4383,2215, 820,1391,2015,2448,3672, 377,
+1948,2168, 797,2545,3536,2578,2645,  94,2874,1678, 405,1259,3071, 771, 546,1315,
+ 470,1243,3083, 895,2468, 981, 969,2037, 846,4181, 653,1276,2928,  14,2594, 557,
+3007,2474, 156, 902,1338,1740,2574, 537,2518, 973,2282,2216,2433,1928, 138,2903,
+1293,2631,1612, 646,3457, 839,2935, 111, 496,2191,2847, 589,3186, 149,3994,2060,
+4031,2641,4067,3145,1870,  37,3597,2136,1025,2051,3009,3383,3549,1121,1016,3261,
+1301, 251,2446,2599,2153, 872,3246, 637, 334,3705, 831, 884, 921,3065,3140,4092,
+2198,1944, 246,2964, 108,2045,1152,1921,2308,1031, 203,3173,4170,1907,3890, 810,
+1401,2003,1690, 506, 647,1242,2828,1761,1649,3208,2249,1589,3709,2931,5156,1708,
+ 498, 666,2613, 834,3817,1231, 184,2851,1124, 883,3197,2261,3710,1765,1553,2658,
+1178,2639,2351,  93,1193, 942,2538,2141,4402, 235,1821, 870,1591,2192,1709,1871,
+3341,1618,4126,2595,2334, 603, 651,  69, 701, 268,2662,3411,2555,1380,1606, 503,
+ 448, 254,2371,2646, 574,1187,2309,1770, 322,2235,1292,1801, 305, 566,1133, 229,
+2067,2057, 706, 167, 483,2002,2672,3295,1820,3561,3067, 316, 378,2746,3452,1112,
+ 136,1981, 507,1651,2917,1117, 285,4591, 182,2580,3522,1304, 335,3303,1835,2504,
+1795,1792,2248, 674,1018,2106,2449,1857,2292,2845, 976,3047,1781,2600,2727,1389,
+1281,  52,3152, 153, 265,3950, 672,3485,3951,4463, 430,1183, 365, 278,2169,  27,
+1407,1336,2304, 209,1340,1730,2202,1852,2403,2883, 979,1737,1062, 631,2829,2542,
+3876,2592, 825,2086,2226,3048,3625, 352,1417,3724, 542, 991, 431,1351,3938,1861,
+2294, 826,1361,2927,3142,3503,1738, 463,2462,2723, 582,1916,1595,2808, 400,3845,
+3891,2868,3621,2254,  58,2492,1123, 910,2160,2614,1372,1603,1196,1072,3385,1700,
+3267,1980, 696, 480,2430, 920, 799,1570,2920,1951,2041,4047,2540,1321,4223,2469,
+3562,2228,1271,2602, 401,2833,3351,2575,5157, 907,2312,1256, 410, 263,3507,1582,
+ 996, 678,1849,2316,1480, 908,3545,2237, 703,2322, 667,1826,2849,1531,2604,2999,
+2407,3146,2151,2630,1786,3711, 469,3542, 497,3899,2409, 858, 837,4446,3393,1274,
+ 786, 620,1845,2001,3311, 484, 308,3367,1204,1815,3691,2332,1532,2557,1842,2020,
+2724,1927,2333,4440, 567,  22,1673,2728,4475,1987,1858,1144,1597, 101,1832,3601,
+  12, 974,3783,4391, 951,1412,   1,3720, 453,4608,4041, 528,1041,1027,3230,2628,
+1129, 875,1051,3291,1203,2262,1069,2860,2799,2149,2615,3278, 144,1758,3040,  31,
+ 475,1680, 366,2685,3184, 311,1642,4008,2466,5036,1593,1493,2809, 216,1420,1668,
+ 233, 304,2128,3284, 232,1429,1768,1040,2008,3407,2740,2967,2543, 242,2133, 778,
+1565,2022,2620, 505,2189,2756,1098,2273, 372,1614, 708, 553,2846,2094,2278, 169,
+3626,2835,4161, 228,2674,3165, 809,1454,1309, 466,1705,1095, 900,3423, 880,2667,
+3751,5258,2317,3109,2571,4317,2766,1503,1342, 866,4447,1118,  63,2076, 314,1881,
+1348,1061, 172, 978,3515,1747, 532, 511,3970,   6, 601, 905,2699,3300,1751, 276,
+1467,3725,2668,  65,4239,2544,2779,2556,1604, 578,2451,1802, 992,2331,2624,1320,
+3446, 713,1513,1013, 103,2786,2447,1661, 886,1702, 916, 654,3574,2031,1556, 751,
+2178,2821,2179,1498,1538,2176, 271, 914,2251,2080,1325, 638,1953,2937,3877,2432,
+2754,  95,3265,1716, 260,1227,4083, 775, 106,1357,3254, 426,1607, 555,2480, 772,
+1985, 244,2546, 474, 495,1046,2611,1851,2061,  71,2089,1675,2590, 742,3758,2843,
+3222,1433, 267,2180,2576,2826,2233,2092,3913,2435, 956,1745,3075, 856,2113,1116,
+ 451,   3,1988,2896,1398, 993,2463,1878,2049,1341,2718,2721,2870,2108, 712,2904,
+4363,2753,2324, 277,2872,2349,2649, 384, 987, 435, 691,3000, 922, 164,3939, 652,
+1500,1184,4153,2482,3373,2165,4848,2335,3775,3508,3154,2806,2830,1554,2102,1664,
+2530,1434,2408, 893,1547,2623,3447,2832,2242,2532,3169,2856,3223,2078,  49,3770,
+3469, 462, 318, 656,2259,3250,3069, 679,1629,2758, 344,1138,1104,3120,1836,1283,
+3115,2154,1437,4448, 934, 759,1999, 794,2862,1038, 533,2560,1722,2342, 855,2626,
+1197,1663,4476,3127,  85,4240,2528,  25,1111,1181,3673, 407,3470,4561,2679,2713,
+ 768,1925,2841,3986,1544,1165, 932, 373,1240,2146,1930,2673, 721,4766, 354,4333,
+ 391,2963, 187,  61,3364,1442,1102, 330,1940,1767, 341,3809,4118, 393,2496,2062,
+2211, 105, 331, 300, 439, 913,1332, 626, 379,3304,1557, 328, 689,3952, 309,1555,
+ 931, 317,2517,3027, 325, 569, 686,2107,3084,  60,1042,1333,2794, 264,3177,4014,
+1628, 258,3712,   7,4464,1176,1043,1778, 683, 114,1975,  78,1492, 383,1886, 510,
+ 386, 645,5291,2891,2069,3305,4138,3867,2939,2603,2493,1935,1066,1848,3588,1015,
+1282,1289,4609, 697,1453,3044,2666,3611,1856,2412,  54, 719,1330, 568,3778,2459,
+1748, 788, 492, 551,1191,1000, 488,3394,3763, 282,1799, 348,2016,1523,3155,2390,
+1049, 382,2019,1788,1170, 729,2968,3523, 897,3926,2785,2938,3292, 350,2319,3238,
+1718,1717,2655,3453,3143,4465, 161,2889,2980,2009,1421,  56,1908,1640,2387,2232,
+1917,1874,2477,4921, 148,  83,3438, 592,4245,2882,1822,1055, 741, 115,1496,1624,
+ 381,1638,4592,1020, 516,3214, 458, 947,4575,1432, 211,1514,2926,1865,2142, 189,
+ 852,1221,1400,1486, 882,2299,4036, 351,  28,1122, 700,6479,6480,6481,6482,6483,  #last 512
+)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312prober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312prober.py
new file mode 100644
index 0000000000000000000000000000000000000000..8446d2dd959721cc86d4ae5a7699197454f3aa91
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/gb2312prober.py
@@ -0,0 +1,46 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import GB2312DistributionAnalysis
+from .mbcssm import GB2312_SM_MODEL
+
+class GB2312Prober(MultiByteCharSetProber):
+    def __init__(self):
+        super(GB2312Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(GB2312_SM_MODEL)
+        self.distribution_analyzer = GB2312DistributionAnalysis()
+        self.reset()
+
+    @property
+    def charset_name(self):
+        return "GB2312"
+
+    @property
+    def language(self):
+        return "Chinese"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/hebrewprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/hebrewprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0e1bf49268203d1f9d14cbe73753d95dc66c8a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/hebrewprober.py
@@ -0,0 +1,292 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+#          Shy Shalom
+# Portions created by the Initial Developer are Copyright (C) 2005
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState
+
+# This prober doesn't actually recognize a language or a charset.
+# It is a helper prober for the use of the Hebrew model probers
+
+### General ideas of the Hebrew charset recognition ###
+#
+# Four main charsets exist in Hebrew:
+# "ISO-8859-8" - Visual Hebrew
+# "windows-1255" - Logical Hebrew
+# "ISO-8859-8-I" - Logical Hebrew
+# "x-mac-hebrew" - ?? Logical Hebrew ??
+#
+# Both "ISO" charsets use a completely identical set of code points, whereas
+# "windows-1255" and "x-mac-hebrew" are two different proper supersets of
+# these code points. windows-1255 defines additional characters in the range
+# 0x80-0x9F as some misc punctuation marks as well as some Hebrew-specific
+# diacritics and additional 'Yiddish' ligature letters in the range 0xc0-0xd6.
+# x-mac-hebrew defines similar additional code points but with a different
+# mapping.
+#
+# As far as an average Hebrew text with no diacritics is concerned, all four
+# charsets are identical with respect to code points. Meaning that for the
+# main Hebrew alphabet, all four map the same values to all 27 Hebrew letters
+# (including final letters).
+#
+# The dominant difference between these charsets is their directionality.
+# "Visual" directionality means that the text is ordered as if the renderer is
+# not aware of a BIDI rendering algorithm. The renderer sees the text and
+# draws it from left to right. The text itself when ordered naturally is read
+# backwards. A buffer of Visual Hebrew generally looks like so:
+# "[last word of first line spelled backwards] [whole line ordered backwards
+# and spelled backwards] [first word of first line spelled backwards]
+# [end of line] [last word of second line] ... etc' "
+# adding punctuation marks, numbers and English text to visual text is
+# naturally also "visual" and from left to right.
+#
+# "Logical" directionality means the text is ordered "naturally" according to
+# the order it is read. It is the responsibility of the renderer to display
+# the text from right to left. A BIDI algorithm is used to place general
+# punctuation marks, numbers and English text in the text.
+#
+# Texts in x-mac-hebrew are almost impossible to find on the Internet. From
+# what little evidence I could find, it seems that its general directionality
+# is Logical.
+#
+# To sum up all of the above, the Hebrew probing mechanism knows about two
+# charsets:
+# Visual Hebrew - "ISO-8859-8" - backwards text - Words and sentences are
+#    backwards while line order is natural. For charset recognition purposes
+#    the line order is unimportant (In fact, for this implementation, even
+#    word order is unimportant).
+# Logical Hebrew - "windows-1255" - normal, naturally ordered text.
+#
+# "ISO-8859-8-I" is a subset of windows-1255 and doesn't need to be
+#    specifically identified.
+# "x-mac-hebrew" is also identified as windows-1255. A text in x-mac-hebrew
+#    that contain special punctuation marks or diacritics is displayed with
+#    some unconverted characters showing as question marks. This problem might
+#    be corrected using another model prober for x-mac-hebrew. Due to the fact
+#    that x-mac-hebrew texts are so rare, writing another model prober isn't
+#    worth the effort and performance hit.
+#
+#### The Prober ####
+#
+# The prober is divided between two SBCharSetProbers and a HebrewProber,
+# all of which are managed, created, fed data, inquired and deleted by the
+# SBCSGroupProber. The two SBCharSetProbers identify that the text is in
+# fact some kind of Hebrew, Logical or Visual. The final decision about which
+# one is it is made by the HebrewProber by combining final-letter scores
+# with the scores of the two SBCharSetProbers to produce a final answer.
+#
+# The SBCSGroupProber is responsible for stripping the original text of HTML
+# tags, English characters, numbers, low-ASCII punctuation characters, spaces
+# and new lines. It reduces any sequence of such characters to a single space.
+# The buffer fed to each prober in the SBCS group prober is pure text in
+# high-ASCII.
+# The two SBCharSetProbers (model probers) share the same language model:
+# Win1255Model.
+# The first SBCharSetProber uses the model normally as any other
+# SBCharSetProber does, to recognize windows-1255, upon which this model was
+# built. The second SBCharSetProber is told to make the pair-of-letter
+# lookup in the language model backwards. This in practice exactly simulates
+# a visual Hebrew model using the windows-1255 logical Hebrew model.
+#
+# The HebrewProber is not using any language model. All it does is look for
+# final-letter evidence suggesting the text is either logical Hebrew or visual
+# Hebrew. Disjointed from the model probers, the results of the HebrewProber
+# alone are meaningless. HebrewProber always returns 0.00 as confidence
+# since it never identifies a charset by itself. Instead, the pointer to the
+# HebrewProber is passed to the model probers as a helper "Name Prober".
+# When the Group prober receives a positive identification from any prober,
+# it asks for the name of the charset identified. If the prober queried is a
+# Hebrew model prober, the model prober forwards the call to the
+# HebrewProber to make the final decision. In the HebrewProber, the
+# decision is made according to the final-letters scores maintained and Both
+# model probers scores. The answer is returned in the form of the name of the
+# charset identified, either "windows-1255" or "ISO-8859-8".
+
+class HebrewProber(CharSetProber):
+    # windows-1255 / ISO-8859-8 code points of interest
+    FINAL_KAF = 0xea
+    NORMAL_KAF = 0xeb
+    FINAL_MEM = 0xed
+    NORMAL_MEM = 0xee
+    FINAL_NUN = 0xef
+    NORMAL_NUN = 0xf0
+    FINAL_PE = 0xf3
+    NORMAL_PE = 0xf4
+    FINAL_TSADI = 0xf5
+    NORMAL_TSADI = 0xf6
+
+    # Minimum Visual vs Logical final letter score difference.
+    # If the difference is below this, don't rely solely on the final letter score
+    # distance.
+    MIN_FINAL_CHAR_DISTANCE = 5
+
+    # Minimum Visual vs Logical model score difference.
+    # If the difference is below this, don't rely at all on the model score
+    # distance.
+    MIN_MODEL_DISTANCE = 0.01
+
+    VISUAL_HEBREW_NAME = "ISO-8859-8"
+    LOGICAL_HEBREW_NAME = "windows-1255"
+
+    def __init__(self):
+        super(HebrewProber, self).__init__()
+        self._final_char_logical_score = None
+        self._final_char_visual_score = None
+        self._prev = None
+        self._before_prev = None
+        self._logical_prober = None
+        self._visual_prober = None
+        self.reset()
+
+    def reset(self):
+        self._final_char_logical_score = 0
+        self._final_char_visual_score = 0
+        # The two last characters seen in the previous buffer,
+        # mPrev and mBeforePrev are initialized to space in order to simulate
+        # a word delimiter at the beginning of the data
+        self._prev = ' '
+        self._before_prev = ' '
+        # These probers are owned by the group prober.
+
+    def set_model_probers(self, logicalProber, visualProber):
+        self._logical_prober = logicalProber
+        self._visual_prober = visualProber
+
+    def is_final(self, c):
+        return c in [self.FINAL_KAF, self.FINAL_MEM, self.FINAL_NUN,
+                     self.FINAL_PE, self.FINAL_TSADI]
+
+    def is_non_final(self, c):
+        # The normal Tsadi is not a good Non-Final letter due to words like
+        # 'lechotet' (to chat) containing an apostrophe after the tsadi. This
+        # apostrophe is converted to a space in FilterWithoutEnglishLetters
+        # causing the Non-Final tsadi to appear at an end of a word even
+        # though this is not the case in the original text.
+        # The letters Pe and Kaf rarely display a related behavior of not being
+        # a good Non-Final letter. Words like 'Pop', 'Winamp' and 'Mubarak'
+        # for example legally end with a Non-Final Pe or Kaf. However, the
+        # benefit of these letters as Non-Final letters outweighs the damage
+        # since these words are quite rare.
+        return c in [self.NORMAL_KAF, self.NORMAL_MEM,
+                     self.NORMAL_NUN, self.NORMAL_PE]
+
+    def feed(self, byte_str):
+        # Final letter analysis for logical-visual decision.
+        # Look for evidence that the received buffer is either logical Hebrew
+        # or visual Hebrew.
+        # The following cases are checked:
+        # 1) A word longer than 1 letter, ending with a final letter. This is
+        #    an indication that the text is laid out "naturally" since the
+        #    final letter really appears at the end. +1 for logical score.
+        # 2) A word longer than 1 letter, ending with a Non-Final letter. In
+        #    normal Hebrew, words ending with Kaf, Mem, Nun, Pe or Tsadi,
+        #    should not end with the Non-Final form of that letter. Exceptions
+        #    to this rule are mentioned above in isNonFinal(). This is an
+        #    indication that the text is laid out backwards. +1 for visual
+        #    score
+        # 3) A word longer than 1 letter, starting with a final letter. Final
+        #    letters should not appear at the beginning of a word. This is an
+        #    indication that the text is laid out backwards. +1 for visual
+        #    score.
+        #
+        # The visual score and logical score are accumulated throughout the
+        # text and are finally checked against each other in GetCharSetName().
+        # No checking for final letters in the middle of words is done since
+        # that case is not an indication for either Logical or Visual text.
+        #
+        # We automatically filter out all 7-bit characters (replace them with
+        # spaces) so the word boundary detection works properly. [MAP]
+
+        if self.state == ProbingState.NOT_ME:
+            # Both model probers say it's not them. No reason to continue.
+            return ProbingState.NOT_ME
+
+        byte_str = self.filter_high_byte_only(byte_str)
+
+        for cur in byte_str:
+            if cur == ' ':
+                # We stand on a space - a word just ended
+                if self._before_prev != ' ':
+                    # next-to-last char was not a space so self._prev is not a
+                    # 1 letter word
+                    if self.is_final(self._prev):
+                        # case (1) [-2:not space][-1:final letter][cur:space]
+                        self._final_char_logical_score += 1
+                    elif self.is_non_final(self._prev):
+                        # case (2) [-2:not space][-1:Non-Final letter][
+                        #  cur:space]
+                        self._final_char_visual_score += 1
+            else:
+                # Not standing on a space
+                if ((self._before_prev == ' ') and
+                        (self.is_final(self._prev)) and (cur != ' ')):
+                    # case (3) [-2:space][-1:final letter][cur:not space]
+                    self._final_char_visual_score += 1
+            self._before_prev = self._prev
+            self._prev = cur
+
+        # Forever detecting, till the end or until both model probers return
+        # ProbingState.NOT_ME (handled above)
+        return ProbingState.DETECTING
+
+    @property
+    def charset_name(self):
+        # Make the decision: is it Logical or Visual?
+        # If the final letter score distance is dominant enough, rely on it.
+        finalsub = self._final_char_logical_score - self._final_char_visual_score
+        if finalsub >= self.MIN_FINAL_CHAR_DISTANCE:
+            return self.LOGICAL_HEBREW_NAME
+        if finalsub <= -self.MIN_FINAL_CHAR_DISTANCE:
+            return self.VISUAL_HEBREW_NAME
+
+        # It's not dominant enough, try to rely on the model scores instead.
+        modelsub = (self._logical_prober.get_confidence()
+                    - self._visual_prober.get_confidence())
+        if modelsub > self.MIN_MODEL_DISTANCE:
+            return self.LOGICAL_HEBREW_NAME
+        if modelsub < -self.MIN_MODEL_DISTANCE:
+            return self.VISUAL_HEBREW_NAME
+
+        # Still no good, back to final letter distance, maybe it'll save the
+        # day.
+        if finalsub < 0.0:
+            return self.VISUAL_HEBREW_NAME
+
+        # (finalsub > 0 - Logical) or (don't know what to do) default to
+        # Logical.
+        return self.LOGICAL_HEBREW_NAME
+
+    @property
+    def language(self):
+        return 'Hebrew'
+
+    @property
+    def state(self):
+        # Remain active as long as any of the model probers are active.
+        if (self._logical_prober.state == ProbingState.NOT_ME) and \
+           (self._visual_prober.state == ProbingState.NOT_ME):
+            return ProbingState.NOT_ME
+        return ProbingState.DETECTING
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jisfreq.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jisfreq.py
new file mode 100644
index 0000000000000000000000000000000000000000..83fc082b545106d02622de20f2083e8a7562f96c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jisfreq.py
@@ -0,0 +1,325 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# Sampling from about 20M text materials include literature and computer technology
+#
+# Japanese frequency table, applied to both S-JIS and EUC-JP
+# They are sorted in order.
+
+# 128  --> 0.77094
+# 256  --> 0.85710
+# 512  --> 0.92635
+# 1024 --> 0.97130
+# 2048 --> 0.99431
+#
+# Ideal Distribution Ratio = 0.92635 / (1-0.92635) = 12.58
+# Random Distribution Ration = 512 / (2965+62+83+86-512) = 0.191
+#
+# Typical Distribution Ratio, 25% of IDR
+
+JIS_TYPICAL_DISTRIBUTION_RATIO = 3.0
+
+# Char to FreqOrder table ,
+JIS_TABLE_SIZE = 4368
+
+JIS_CHAR_TO_FREQ_ORDER = (
+  40,   1,   6, 182, 152, 180, 295,2127, 285, 381,3295,4304,3068,4606,3165,3510, #   16
+3511,1822,2785,4607,1193,2226,5070,4608, 171,2996,1247,  18, 179,5071, 856,1661, #   32
+1262,5072, 619, 127,3431,3512,3230,1899,1700, 232, 228,1294,1298, 284, 283,2041, #   48
+2042,1061,1062,  48,  49,  44,  45, 433, 434,1040,1041, 996, 787,2997,1255,4305, #   64
+2108,4609,1684,1648,5073,5074,5075,5076,5077,5078,3687,5079,4610,5080,3927,3928, #   80
+5081,3296,3432, 290,2285,1471,2187,5082,2580,2825,1303,2140,1739,1445,2691,3375, #   96
+1691,3297,4306,4307,4611, 452,3376,1182,2713,3688,3069,4308,5083,5084,5085,5086, #  112
+5087,5088,5089,5090,5091,5092,5093,5094,5095,5096,5097,5098,5099,5100,5101,5102, #  128
+5103,5104,5105,5106,5107,5108,5109,5110,5111,5112,4097,5113,5114,5115,5116,5117, #  144
+5118,5119,5120,5121,5122,5123,5124,5125,5126,5127,5128,5129,5130,5131,5132,5133, #  160
+5134,5135,5136,5137,5138,5139,5140,5141,5142,5143,5144,5145,5146,5147,5148,5149, #  176
+5150,5151,5152,4612,5153,5154,5155,5156,5157,5158,5159,5160,5161,5162,5163,5164, #  192
+5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,1472, 598, 618, 820,1205, #  208
+1309,1412,1858,1307,1692,5176,5177,5178,5179,5180,5181,5182,1142,1452,1234,1172, #  224
+1875,2043,2149,1793,1382,2973, 925,2404,1067,1241, 960,1377,2935,1491, 919,1217, #  240
+1865,2030,1406,1499,2749,4098,5183,5184,5185,5186,5187,5188,2561,4099,3117,1804, #  256
+2049,3689,4309,3513,1663,5189,3166,3118,3298,1587,1561,3433,5190,3119,1625,2998, #  272
+3299,4613,1766,3690,2786,4614,5191,5192,5193,5194,2161,  26,3377,   2,3929,  20, #  288
+3691,  47,4100,  50,  17,  16,  35, 268,  27, 243,  42, 155,  24, 154,  29, 184, #  304
+   4,  91,  14,  92,  53, 396,  33, 289,   9,  37,  64, 620,  21,  39, 321,   5, #  320
+  12,  11,  52,  13,   3, 208, 138,   0,   7,  60, 526, 141, 151,1069, 181, 275, #  336
+1591,  83, 132,1475, 126, 331, 829,  15,  69, 160,  59,  22, 157,  55,1079, 312, #  352
+ 109,  38,  23,  25,  10,  19,  79,5195,  61, 382,1124,   8,  30,5196,5197,5198, #  368
+5199,5200,5201,5202,5203,5204,5205,5206,  89,  62,  74,  34,2416, 112, 139, 196, #  384
+ 271, 149,  84, 607, 131, 765,  46,  88, 153, 683,  76, 874, 101, 258,  57,  80, #  400
+  32, 364, 121,1508, 169,1547,  68, 235, 145,2999,  41, 360,3027,  70,  63,  31, #  416
+  43, 259, 262,1383,  99, 533, 194,  66,  93, 846, 217, 192,  56, 106,  58, 565, #  432
+ 280, 272, 311, 256, 146,  82, 308,  71, 100, 128, 214, 655, 110, 261, 104,1140, #  448
+  54,  51,  36,  87,  67,3070, 185,2618,2936,2020,  28,1066,2390,2059,5207,5208, #  464
+5209,5210,5211,5212,5213,5214,5215,5216,4615,5217,5218,5219,5220,5221,5222,5223, #  480
+5224,5225,5226,5227,5228,5229,5230,5231,5232,5233,5234,5235,5236,3514,5237,5238, #  496
+5239,5240,5241,5242,5243,5244,2297,2031,4616,4310,3692,5245,3071,5246,3598,5247, #  512
+4617,3231,3515,5248,4101,4311,4618,3808,4312,4102,5249,4103,4104,3599,5250,5251, #  528
+5252,5253,5254,5255,5256,5257,5258,5259,5260,5261,5262,5263,5264,5265,5266,5267, #  544
+5268,5269,5270,5271,5272,5273,5274,5275,5276,5277,5278,5279,5280,5281,5282,5283, #  560
+5284,5285,5286,5287,5288,5289,5290,5291,5292,5293,5294,5295,5296,5297,5298,5299, #  576
+5300,5301,5302,5303,5304,5305,5306,5307,5308,5309,5310,5311,5312,5313,5314,5315, #  592
+5316,5317,5318,5319,5320,5321,5322,5323,5324,5325,5326,5327,5328,5329,5330,5331, #  608
+5332,5333,5334,5335,5336,5337,5338,5339,5340,5341,5342,5343,5344,5345,5346,5347, #  624
+5348,5349,5350,5351,5352,5353,5354,5355,5356,5357,5358,5359,5360,5361,5362,5363, #  640
+5364,5365,5366,5367,5368,5369,5370,5371,5372,5373,5374,5375,5376,5377,5378,5379, #  656
+5380,5381, 363, 642,2787,2878,2788,2789,2316,3232,2317,3434,2011, 165,1942,3930, #  672
+3931,3932,3933,5382,4619,5383,4620,5384,5385,5386,5387,5388,5389,5390,5391,5392, #  688
+5393,5394,5395,5396,5397,5398,5399,5400,5401,5402,5403,5404,5405,5406,5407,5408, #  704
+5409,5410,5411,5412,5413,5414,5415,5416,5417,5418,5419,5420,5421,5422,5423,5424, #  720
+5425,5426,5427,5428,5429,5430,5431,5432,5433,5434,5435,5436,5437,5438,5439,5440, #  736
+5441,5442,5443,5444,5445,5446,5447,5448,5449,5450,5451,5452,5453,5454,5455,5456, #  752
+5457,5458,5459,5460,5461,5462,5463,5464,5465,5466,5467,5468,5469,5470,5471,5472, #  768
+5473,5474,5475,5476,5477,5478,5479,5480,5481,5482,5483,5484,5485,5486,5487,5488, #  784
+5489,5490,5491,5492,5493,5494,5495,5496,5497,5498,5499,5500,5501,5502,5503,5504, #  800
+5505,5506,5507,5508,5509,5510,5511,5512,5513,5514,5515,5516,5517,5518,5519,5520, #  816
+5521,5522,5523,5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536, #  832
+5537,5538,5539,5540,5541,5542,5543,5544,5545,5546,5547,5548,5549,5550,5551,5552, #  848
+5553,5554,5555,5556,5557,5558,5559,5560,5561,5562,5563,5564,5565,5566,5567,5568, #  864
+5569,5570,5571,5572,5573,5574,5575,5576,5577,5578,5579,5580,5581,5582,5583,5584, #  880
+5585,5586,5587,5588,5589,5590,5591,5592,5593,5594,5595,5596,5597,5598,5599,5600, #  896
+5601,5602,5603,5604,5605,5606,5607,5608,5609,5610,5611,5612,5613,5614,5615,5616, #  912
+5617,5618,5619,5620,5621,5622,5623,5624,5625,5626,5627,5628,5629,5630,5631,5632, #  928
+5633,5634,5635,5636,5637,5638,5639,5640,5641,5642,5643,5644,5645,5646,5647,5648, #  944
+5649,5650,5651,5652,5653,5654,5655,5656,5657,5658,5659,5660,5661,5662,5663,5664, #  960
+5665,5666,5667,5668,5669,5670,5671,5672,5673,5674,5675,5676,5677,5678,5679,5680, #  976
+5681,5682,5683,5684,5685,5686,5687,5688,5689,5690,5691,5692,5693,5694,5695,5696, #  992
+5697,5698,5699,5700,5701,5702,5703,5704,5705,5706,5707,5708,5709,5710,5711,5712, # 1008
+5713,5714,5715,5716,5717,5718,5719,5720,5721,5722,5723,5724,5725,5726,5727,5728, # 1024
+5729,5730,5731,5732,5733,5734,5735,5736,5737,5738,5739,5740,5741,5742,5743,5744, # 1040
+5745,5746,5747,5748,5749,5750,5751,5752,5753,5754,5755,5756,5757,5758,5759,5760, # 1056
+5761,5762,5763,5764,5765,5766,5767,5768,5769,5770,5771,5772,5773,5774,5775,5776, # 1072
+5777,5778,5779,5780,5781,5782,5783,5784,5785,5786,5787,5788,5789,5790,5791,5792, # 1088
+5793,5794,5795,5796,5797,5798,5799,5800,5801,5802,5803,5804,5805,5806,5807,5808, # 1104
+5809,5810,5811,5812,5813,5814,5815,5816,5817,5818,5819,5820,5821,5822,5823,5824, # 1120
+5825,5826,5827,5828,5829,5830,5831,5832,5833,5834,5835,5836,5837,5838,5839,5840, # 1136
+5841,5842,5843,5844,5845,5846,5847,5848,5849,5850,5851,5852,5853,5854,5855,5856, # 1152
+5857,5858,5859,5860,5861,5862,5863,5864,5865,5866,5867,5868,5869,5870,5871,5872, # 1168
+5873,5874,5875,5876,5877,5878,5879,5880,5881,5882,5883,5884,5885,5886,5887,5888, # 1184
+5889,5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904, # 1200
+5905,5906,5907,5908,5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920, # 1216
+5921,5922,5923,5924,5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,5936, # 1232
+5937,5938,5939,5940,5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951,5952, # 1248
+5953,5954,5955,5956,5957,5958,5959,5960,5961,5962,5963,5964,5965,5966,5967,5968, # 1264
+5969,5970,5971,5972,5973,5974,5975,5976,5977,5978,5979,5980,5981,5982,5983,5984, # 1280
+5985,5986,5987,5988,5989,5990,5991,5992,5993,5994,5995,5996,5997,5998,5999,6000, # 1296
+6001,6002,6003,6004,6005,6006,6007,6008,6009,6010,6011,6012,6013,6014,6015,6016, # 1312
+6017,6018,6019,6020,6021,6022,6023,6024,6025,6026,6027,6028,6029,6030,6031,6032, # 1328
+6033,6034,6035,6036,6037,6038,6039,6040,6041,6042,6043,6044,6045,6046,6047,6048, # 1344
+6049,6050,6051,6052,6053,6054,6055,6056,6057,6058,6059,6060,6061,6062,6063,6064, # 1360
+6065,6066,6067,6068,6069,6070,6071,6072,6073,6074,6075,6076,6077,6078,6079,6080, # 1376
+6081,6082,6083,6084,6085,6086,6087,6088,6089,6090,6091,6092,6093,6094,6095,6096, # 1392
+6097,6098,6099,6100,6101,6102,6103,6104,6105,6106,6107,6108,6109,6110,6111,6112, # 1408
+6113,6114,2044,2060,4621, 997,1235, 473,1186,4622, 920,3378,6115,6116, 379,1108, # 1424
+4313,2657,2735,3934,6117,3809, 636,3233, 573,1026,3693,3435,2974,3300,2298,4105, # 1440
+ 854,2937,2463, 393,2581,2417, 539, 752,1280,2750,2480, 140,1161, 440, 708,1569, # 1456
+ 665,2497,1746,1291,1523,3000, 164,1603, 847,1331, 537,1997, 486, 508,1693,2418, # 1472
+1970,2227, 878,1220, 299,1030, 969, 652,2751, 624,1137,3301,2619,  65,3302,2045, # 1488
+1761,1859,3120,1930,3694,3516, 663,1767, 852, 835,3695, 269, 767,2826,2339,1305, # 1504
+ 896,1150, 770,1616,6118, 506,1502,2075,1012,2519, 775,2520,2975,2340,2938,4314, # 1520
+3028,2086,1224,1943,2286,6119,3072,4315,2240,1273,1987,3935,1557, 175, 597, 985, # 1536
+3517,2419,2521,1416,3029, 585, 938,1931,1007,1052,1932,1685,6120,3379,4316,4623, # 1552
+ 804, 599,3121,1333,2128,2539,1159,1554,2032,3810, 687,2033,2904, 952, 675,1467, # 1568
+3436,6121,2241,1096,1786,2440,1543,1924, 980,1813,2228, 781,2692,1879, 728,1918, # 1584
+3696,4624, 548,1950,4625,1809,1088,1356,3303,2522,1944, 502, 972, 373, 513,2827, # 1600
+ 586,2377,2391,1003,1976,1631,6122,2464,1084, 648,1776,4626,2141, 324, 962,2012, # 1616
+2177,2076,1384, 742,2178,1448,1173,1810, 222, 102, 301, 445, 125,2420, 662,2498, # 1632
+ 277, 200,1476,1165,1068, 224,2562,1378,1446, 450,1880, 659, 791, 582,4627,2939, # 1648
+3936,1516,1274, 555,2099,3697,1020,1389,1526,3380,1762,1723,1787,2229, 412,2114, # 1664
+1900,2392,3518, 512,2597, 427,1925,2341,3122,1653,1686,2465,2499, 697, 330, 273, # 1680
+ 380,2162, 951, 832, 780, 991,1301,3073, 965,2270,3519, 668,2523,2636,1286, 535, # 1696
+1407, 518, 671, 957,2658,2378, 267, 611,2197,3030,6123, 248,2299, 967,1799,2356, # 1712
+ 850,1418,3437,1876,1256,1480,2828,1718,6124,6125,1755,1664,2405,6126,4628,2879, # 1728
+2829, 499,2179, 676,4629, 557,2329,2214,2090, 325,3234, 464, 811,3001, 992,2342, # 1744
+2481,1232,1469, 303,2242, 466,1070,2163, 603,1777,2091,4630,2752,4631,2714, 322, # 1760
+2659,1964,1768, 481,2188,1463,2330,2857,3600,2092,3031,2421,4632,2318,2070,1849, # 1776
+2598,4633,1302,2254,1668,1701,2422,3811,2905,3032,3123,2046,4106,1763,1694,4634, # 1792
+1604, 943,1724,1454, 917, 868,2215,1169,2940, 552,1145,1800,1228,1823,1955, 316, # 1808
+1080,2510, 361,1807,2830,4107,2660,3381,1346,1423,1134,4108,6127, 541,1263,1229, # 1824
+1148,2540, 545, 465,1833,2880,3438,1901,3074,2482, 816,3937, 713,1788,2500, 122, # 1840
+1575, 195,1451,2501,1111,6128, 859, 374,1225,2243,2483,4317, 390,1033,3439,3075, # 1856
+2524,1687, 266, 793,1440,2599, 946, 779, 802, 507, 897,1081, 528,2189,1292, 711, # 1872
+1866,1725,1167,1640, 753, 398,2661,1053, 246, 348,4318, 137,1024,3440,1600,2077, # 1888
+2129, 825,4319, 698, 238, 521, 187,2300,1157,2423,1641,1605,1464,1610,1097,2541, # 1904
+1260,1436, 759,2255,1814,2150, 705,3235, 409,2563,3304, 561,3033,2005,2564, 726, # 1920
+1956,2343,3698,4109, 949,3812,3813,3520,1669, 653,1379,2525, 881,2198, 632,2256, # 1936
+1027, 778,1074, 733,1957, 514,1481,2466, 554,2180, 702,3938,1606,1017,1398,6129, # 1952
+1380,3521, 921, 993,1313, 594, 449,1489,1617,1166, 768,1426,1360, 495,1794,3601, # 1968
+1177,3602,1170,4320,2344, 476, 425,3167,4635,3168,1424, 401,2662,1171,3382,1998, # 1984
+1089,4110, 477,3169, 474,6130,1909, 596,2831,1842, 494, 693,1051,1028,1207,3076, # 2000
+ 606,2115, 727,2790,1473,1115, 743,3522, 630, 805,1532,4321,2021, 366,1057, 838, # 2016
+ 684,1114,2142,4322,2050,1492,1892,1808,2271,3814,2424,1971,1447,1373,3305,1090, # 2032
+1536,3939,3523,3306,1455,2199, 336, 369,2331,1035, 584,2393, 902, 718,2600,6131, # 2048
+2753, 463,2151,1149,1611,2467, 715,1308,3124,1268, 343,1413,3236,1517,1347,2663, # 2064
+2093,3940,2022,1131,1553,2100,2941,1427,3441,2942,1323,2484,6132,1980, 872,2368, # 2080
+2441,2943, 320,2369,2116,1082, 679,1933,3941,2791,3815, 625,1143,2023, 422,2200, # 2096
+3816,6133, 730,1695, 356,2257,1626,2301,2858,2637,1627,1778, 937, 883,2906,2693, # 2112
+3002,1769,1086, 400,1063,1325,3307,2792,4111,3077, 456,2345,1046, 747,6134,1524, # 2128
+ 884,1094,3383,1474,2164,1059, 974,1688,2181,2258,1047, 345,1665,1187, 358, 875, # 2144
+3170, 305, 660,3524,2190,1334,1135,3171,1540,1649,2542,1527, 927, 968,2793, 885, # 2160
+1972,1850, 482, 500,2638,1218,1109,1085,2543,1654,2034, 876,  78,2287,1482,1277, # 2176
+ 861,1675,1083,1779, 724,2754, 454, 397,1132,1612,2332, 893, 672,1237, 257,2259, # 2192
+2370, 135,3384, 337,2244, 547, 352, 340, 709,2485,1400, 788,1138,2511, 540, 772, # 2208
+1682,2260,2272,2544,2013,1843,1902,4636,1999,1562,2288,4637,2201,1403,1533, 407, # 2224
+ 576,3308,1254,2071, 978,3385, 170, 136,1201,3125,2664,3172,2394, 213, 912, 873, # 2240
+3603,1713,2202, 699,3604,3699, 813,3442, 493, 531,1054, 468,2907,1483, 304, 281, # 2256
+4112,1726,1252,2094, 339,2319,2130,2639, 756,1563,2944, 748, 571,2976,1588,2425, # 2272
+2715,1851,1460,2426,1528,1392,1973,3237, 288,3309, 685,3386, 296, 892,2716,2216, # 2288
+1570,2245, 722,1747,2217, 905,3238,1103,6135,1893,1441,1965, 251,1805,2371,3700, # 2304
+2601,1919,1078,  75,2182,1509,1592,1270,2640,4638,2152,6136,3310,3817, 524, 706, # 2320
+1075, 292,3818,1756,2602, 317,  98,3173,3605,3525,1844,2218,3819,2502, 814, 567, # 2336
+ 385,2908,1534,6137, 534,1642,3239, 797,6138,1670,1529, 953,4323, 188,1071, 538, # 2352
+ 178, 729,3240,2109,1226,1374,2000,2357,2977, 731,2468,1116,2014,2051,6139,1261, # 2368
+1593, 803,2859,2736,3443, 556, 682, 823,1541,6140,1369,2289,1706,2794, 845, 462, # 2384
+2603,2665,1361, 387, 162,2358,1740, 739,1770,1720,1304,1401,3241,1049, 627,1571, # 2400
+2427,3526,1877,3942,1852,1500, 431,1910,1503, 677, 297,2795, 286,1433,1038,1198, # 2416
+2290,1133,1596,4113,4639,2469,1510,1484,3943,6141,2442, 108, 712,4640,2372, 866, # 2432
+3701,2755,3242,1348, 834,1945,1408,3527,2395,3243,1811, 824, 994,1179,2110,1548, # 2448
+1453, 790,3003, 690,4324,4325,2832,2909,3820,1860,3821, 225,1748, 310, 346,1780, # 2464
+2470, 821,1993,2717,2796, 828, 877,3528,2860,2471,1702,2165,2910,2486,1789, 453, # 2480
+ 359,2291,1676,  73,1164,1461,1127,3311, 421, 604, 314,1037, 589, 116,2487, 737, # 2496
+ 837,1180, 111, 244, 735,6142,2261,1861,1362, 986, 523, 418, 581,2666,3822, 103, # 2512
+ 855, 503,1414,1867,2488,1091, 657,1597, 979, 605,1316,4641,1021,2443,2078,2001, # 2528
+1209,  96, 587,2166,1032, 260,1072,2153, 173,  94, 226,3244, 819,2006,4642,4114, # 2544
+2203, 231,1744, 782,  97,2667, 786,3387, 887, 391, 442,2219,4326,1425,6143,2694, # 2560
+ 633,1544,1202, 483,2015, 592,2052,1958,2472,1655, 419, 129,4327,3444,3312,1714, # 2576
+1257,3078,4328,1518,1098, 865,1310,1019,1885,1512,1734, 469,2444, 148, 773, 436, # 2592
+1815,1868,1128,1055,4329,1245,2756,3445,2154,1934,1039,4643, 579,1238, 932,2320, # 2608
+ 353, 205, 801, 115,2428, 944,2321,1881, 399,2565,1211, 678, 766,3944, 335,2101, # 2624
+1459,1781,1402,3945,2737,2131,1010, 844, 981,1326,1013, 550,1816,1545,2620,1335, # 2640
+1008, 371,2881, 936,1419,1613,3529,1456,1395,2273,1834,2604,1317,2738,2503, 416, # 2656
+1643,4330, 806,1126, 229, 591,3946,1314,1981,1576,1837,1666, 347,1790, 977,3313, # 2672
+ 764,2861,1853, 688,2429,1920,1462,  77, 595, 415,2002,3034, 798,1192,4115,6144, # 2688
+2978,4331,3035,2695,2582,2072,2566, 430,2430,1727, 842,1396,3947,3702, 613, 377, # 2704
+ 278, 236,1417,3388,3314,3174, 757,1869, 107,3530,6145,1194, 623,2262, 207,1253, # 2720
+2167,3446,3948, 492,1117,1935, 536,1838,2757,1246,4332, 696,2095,2406,1393,1572, # 2736
+3175,1782, 583, 190, 253,1390,2230, 830,3126,3389, 934,3245,1703,1749,2979,1870, # 2752
+2545,1656,2204, 869,2346,4116,3176,1817, 496,1764,4644, 942,1504, 404,1903,1122, # 2768
+1580,3606,2945,1022, 515, 372,1735, 955,2431,3036,6146,2797,1110,2302,2798, 617, # 2784
+6147, 441, 762,1771,3447,3607,3608,1904, 840,3037,  86, 939,1385, 572,1370,2445, # 2800
+1336, 114,3703, 898, 294, 203,3315, 703,1583,2274, 429, 961,4333,1854,1951,3390, # 2816
+2373,3704,4334,1318,1381, 966,1911,2322,1006,1155, 309, 989, 458,2718,1795,1372, # 2832
+1203, 252,1689,1363,3177, 517,1936, 168,1490, 562, 193,3823,1042,4117,1835, 551, # 2848
+ 470,4645, 395, 489,3448,1871,1465,2583,2641, 417,1493, 279,1295, 511,1236,1119, # 2864
+  72,1231,1982,1812,3004, 871,1564, 984,3449,1667,2696,2096,4646,2347,2833,1673, # 2880
+3609, 695,3246,2668, 807,1183,4647, 890, 388,2333,1801,1457,2911,1765,1477,1031, # 2896
+3316,3317,1278,3391,2799,2292,2526, 163,3450,4335,2669,1404,1802,6148,2323,2407, # 2912
+1584,1728,1494,1824,1269, 298, 909,3318,1034,1632, 375, 776,1683,2061, 291, 210, # 2928
+1123, 809,1249,1002,2642,3038, 206,1011,2132, 144, 975, 882,1565, 342, 667, 754, # 2944
+1442,2143,1299,2303,2062, 447, 626,2205,1221,2739,2912,1144,1214,2206,2584, 760, # 2960
+1715, 614, 950,1281,2670,2621, 810, 577,1287,2546,4648, 242,2168, 250,2643, 691, # 2976
+ 123,2644, 647, 313,1029, 689,1357,2946,1650, 216, 771,1339,1306, 808,2063, 549, # 2992
+ 913,1371,2913,2914,6149,1466,1092,1174,1196,1311,2605,2396,1783,1796,3079, 406, # 3008
+2671,2117,3949,4649, 487,1825,2220,6150,2915, 448,2348,1073,6151,2397,1707, 130, # 3024
+ 900,1598, 329, 176,1959,2527,1620,6152,2275,4336,3319,1983,2191,3705,3610,2155, # 3040
+3706,1912,1513,1614,6153,1988, 646, 392,2304,1589,3320,3039,1826,1239,1352,1340, # 3056
+2916, 505,2567,1709,1437,2408,2547, 906,6154,2672, 384,1458,1594,1100,1329, 710, # 3072
+ 423,3531,2064,2231,2622,1989,2673,1087,1882, 333, 841,3005,1296,2882,2379, 580, # 3088
+1937,1827,1293,2585, 601, 574, 249,1772,4118,2079,1120, 645, 901,1176,1690, 795, # 3104
+2207, 478,1434, 516,1190,1530, 761,2080, 930,1264, 355, 435,1552, 644,1791, 987, # 3120
+ 220,1364,1163,1121,1538, 306,2169,1327,1222, 546,2645, 218, 241, 610,1704,3321, # 3136
+1984,1839,1966,2528, 451,6155,2586,3707,2568, 907,3178, 254,2947, 186,1845,4650, # 3152
+ 745, 432,1757, 428,1633, 888,2246,2221,2489,3611,2118,1258,1265, 956,3127,1784, # 3168
+4337,2490, 319, 510, 119, 457,3612, 274,2035,2007,4651,1409,3128, 970,2758, 590, # 3184
+2800, 661,2247,4652,2008,3950,1420,1549,3080,3322,3951,1651,1375,2111, 485,2491, # 3200
+1429,1156,6156,2548,2183,1495, 831,1840,2529,2446, 501,1657, 307,1894,3247,1341, # 3216
+ 666, 899,2156,1539,2549,1559, 886, 349,2208,3081,2305,1736,3824,2170,2759,1014, # 3232
+1913,1386, 542,1397,2948, 490, 368, 716, 362, 159, 282,2569,1129,1658,1288,1750, # 3248
+2674, 276, 649,2016, 751,1496, 658,1818,1284,1862,2209,2087,2512,3451, 622,2834, # 3264
+ 376, 117,1060,2053,1208,1721,1101,1443, 247,1250,3179,1792,3952,2760,2398,3953, # 3280
+6157,2144,3708, 446,2432,1151,2570,3452,2447,2761,2835,1210,2448,3082, 424,2222, # 3296
+1251,2449,2119,2836, 504,1581,4338, 602, 817, 857,3825,2349,2306, 357,3826,1470, # 3312
+1883,2883, 255, 958, 929,2917,3248, 302,4653,1050,1271,1751,2307,1952,1430,2697, # 3328
+2719,2359, 354,3180, 777, 158,2036,4339,1659,4340,4654,2308,2949,2248,1146,2232, # 3344
+3532,2720,1696,2623,3827,6158,3129,1550,2698,1485,1297,1428, 637, 931,2721,2145, # 3360
+ 914,2550,2587,  81,2450, 612, 827,2646,1242,4655,1118,2884, 472,1855,3181,3533, # 3376
+3534, 569,1353,2699,1244,1758,2588,4119,2009,2762,2171,3709,1312,1531,6159,1152, # 3392
+1938, 134,1830, 471,3710,2276,1112,1535,3323,3453,3535, 982,1337,2950, 488, 826, # 3408
+ 674,1058,1628,4120,2017, 522,2399, 211, 568,1367,3454, 350, 293,1872,1139,3249, # 3424
+1399,1946,3006,1300,2360,3324, 588, 736,6160,2606, 744, 669,3536,3828,6161,1358, # 3440
+ 199, 723, 848, 933, 851,1939,1505,1514,1338,1618,1831,4656,1634,3613, 443,2740, # 3456
+3829, 717,1947, 491,1914,6162,2551,1542,4121,1025,6163,1099,1223, 198,3040,2722, # 3472
+ 370, 410,1905,2589, 998,1248,3182,2380, 519,1449,4122,1710, 947, 928,1153,4341, # 3488
+2277, 344,2624,1511, 615, 105, 161,1212,1076,1960,3130,2054,1926,1175,1906,2473, # 3504
+ 414,1873,2801,6164,2309, 315,1319,3325, 318,2018,2146,2157, 963, 631, 223,4342, # 3520
+4343,2675, 479,3711,1197,2625,3712,2676,2361,6165,4344,4123,6166,2451,3183,1886, # 3536
+2184,1674,1330,1711,1635,1506, 799, 219,3250,3083,3954,1677,3713,3326,2081,3614, # 3552
+1652,2073,4657,1147,3041,1752, 643,1961, 147,1974,3955,6167,1716,2037, 918,3007, # 3568
+1994, 120,1537, 118, 609,3184,4345, 740,3455,1219, 332,1615,3830,6168,1621,2980, # 3584
+1582, 783, 212, 553,2350,3714,1349,2433,2082,4124, 889,6169,2310,1275,1410, 973, # 3600
+ 166,1320,3456,1797,1215,3185,2885,1846,2590,2763,4658, 629, 822,3008, 763, 940, # 3616
+1990,2862, 439,2409,1566,1240,1622, 926,1282,1907,2764, 654,2210,1607, 327,1130, # 3632
+3956,1678,1623,6170,2434,2192, 686, 608,3831,3715, 903,3957,3042,6171,2741,1522, # 3648
+1915,1105,1555,2552,1359, 323,3251,4346,3457, 738,1354,2553,2311,2334,1828,2003, # 3664
+3832,1753,2351,1227,6172,1887,4125,1478,6173,2410,1874,1712,1847, 520,1204,2607, # 3680
+ 264,4659, 836,2677,2102, 600,4660,3833,2278,3084,6174,4347,3615,1342, 640, 532, # 3696
+ 543,2608,1888,2400,2591,1009,4348,1497, 341,1737,3616,2723,1394, 529,3252,1321, # 3712
+ 983,4661,1515,2120, 971,2592, 924, 287,1662,3186,4349,2700,4350,1519, 908,1948, # 3728
+2452, 156, 796,1629,1486,2223,2055, 694,4126,1259,1036,3392,1213,2249,2742,1889, # 3744
+1230,3958,1015, 910, 408, 559,3617,4662, 746, 725, 935,4663,3959,3009,1289, 563, # 3760
+ 867,4664,3960,1567,2981,2038,2626, 988,2263,2381,4351, 143,2374, 704,1895,6175, # 3776
+1188,3716,2088, 673,3085,2362,4352, 484,1608,1921,2765,2918, 215, 904,3618,3537, # 3792
+ 894, 509, 976,3043,2701,3961,4353,2837,2982, 498,6176,6177,1102,3538,1332,3393, # 3808
+1487,1636,1637, 233, 245,3962, 383, 650, 995,3044, 460,1520,1206,2352, 749,3327, # 3824
+ 530, 700, 389,1438,1560,1773,3963,2264, 719,2951,2724,3834, 870,1832,1644,1000, # 3840
+ 839,2474,3717, 197,1630,3394, 365,2886,3964,1285,2133, 734, 922, 818,1106, 732, # 3856
+ 480,2083,1774,3458, 923,2279,1350, 221,3086,  85,2233,2234,3835,1585,3010,2147, # 3872
+1387,1705,2382,1619,2475, 133, 239,2802,1991,1016,2084,2383, 411,2838,1113, 651, # 3888
+1985,1160,3328, 990,1863,3087,1048,1276,2647, 265,2627,1599,3253,2056, 150, 638, # 3904
+2019, 656, 853, 326,1479, 680,1439,4354,1001,1759, 413,3459,3395,2492,1431, 459, # 3920
+4355,1125,3329,2265,1953,1450,2065,2863, 849, 351,2678,3131,3254,3255,1104,1577, # 3936
+ 227,1351,1645,2453,2193,1421,2887, 812,2121, 634,  95,2435, 201,2312,4665,1646, # 3952
+1671,2743,1601,2554,2702,2648,2280,1315,1366,2089,3132,1573,3718,3965,1729,1189, # 3968
+ 328,2679,1077,1940,1136, 558,1283, 964,1195, 621,2074,1199,1743,3460,3619,1896, # 3984
+1916,1890,3836,2952,1154,2112,1064, 862, 378,3011,2066,2113,2803,1568,2839,6178, # 4000
+3088,2919,1941,1660,2004,1992,2194, 142, 707,1590,1708,1624,1922,1023,1836,1233, # 4016
+1004,2313, 789, 741,3620,6179,1609,2411,1200,4127,3719,3720,4666,2057,3721, 593, # 4032
+2840, 367,2920,1878,6180,3461,1521, 628,1168, 692,2211,2649, 300, 720,2067,2571, # 4048
+2953,3396, 959,2504,3966,3539,3462,1977, 701,6181, 954,1043, 800, 681, 183,3722, # 4064
+1803,1730,3540,4128,2103, 815,2314, 174, 467, 230,2454,1093,2134, 755,3541,3397, # 4080
+1141,1162,6182,1738,2039, 270,3256,2513,1005,1647,2185,3837, 858,1679,1897,1719, # 4096
+2954,2324,1806, 402, 670, 167,4129,1498,2158,2104, 750,6183, 915, 189,1680,1551, # 4112
+ 455,4356,1501,2455, 405,1095,2955, 338,1586,1266,1819, 570, 641,1324, 237,1556, # 4128
+2650,1388,3723,6184,1368,2384,1343,1978,3089,2436, 879,3724, 792,1191, 758,3012, # 4144
+1411,2135,1322,4357, 240,4667,1848,3725,1574,6185, 420,3045,1546,1391, 714,4358, # 4160
+1967, 941,1864, 863, 664, 426, 560,1731,2680,1785,2864,1949,2363, 403,3330,1415, # 4176
+1279,2136,1697,2335, 204, 721,2097,3838,  90,6186,2085,2505, 191,3967, 124,2148, # 4192
+1376,1798,1178,1107,1898,1405, 860,4359,1243,1272,2375,2983,1558,2456,1638, 113, # 4208
+3621, 578,1923,2609, 880, 386,4130, 784,2186,2266,1422,2956,2172,1722, 497, 263, # 4224
+2514,1267,2412,2610, 177,2703,3542, 774,1927,1344, 616,1432,1595,1018, 172,4360, # 4240
+2325, 911,4361, 438,1468,3622, 794,3968,2024,2173,1681,1829,2957, 945, 895,3090, # 4256
+ 575,2212,2476, 475,2401,2681, 785,2744,1745,2293,2555,1975,3133,2865, 394,4668, # 4272
+3839, 635,4131, 639, 202,1507,2195,2766,1345,1435,2572,3726,1908,1184,1181,2457, # 4288
+3727,3134,4362, 843,2611, 437, 916,4669, 234, 769,1884,3046,3047,3623, 833,6187, # 4304
+1639,2250,2402,1355,1185,2010,2047, 999, 525,1732,1290,1488,2612, 948,1578,3728, # 4320
+2413,2477,1216,2725,2159, 334,3840,1328,3624,2921,1525,4132, 564,1056, 891,4363, # 4336
+1444,1698,2385,2251,3729,1365,2281,2235,1717,6188, 864,3841,2515, 444, 527,2767, # 4352
+2922,3625, 544, 461,6189, 566, 209,2437,3398,2098,1065,2068,3331,3626,3257,2137, # 4368  #last 512
+)
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jpcntx.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jpcntx.py
new file mode 100644
index 0000000000000000000000000000000000000000..20044e4bc8f5a9775d82be0ecf387ce752732507
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/jpcntx.py
@@ -0,0 +1,233 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+
+# This is hiragana 2-char sequence table, the number in each cell represents its frequency category
+jp2CharContext = (
+(0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1),
+(2,4,0,4,0,3,0,4,0,3,4,4,4,2,4,3,3,4,3,2,3,3,4,2,3,3,3,2,4,1,4,3,3,1,5,4,3,4,3,4,3,5,3,0,3,5,4,2,0,3,1,0,3,3,0,3,3,0,1,1,0,4,3,0,3,3,0,4,0,2,0,3,5,5,5,5,4,0,4,1,0,3,4),
+(0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2),
+(0,4,0,5,0,5,0,4,0,4,5,4,4,3,5,3,5,1,5,3,4,3,4,4,3,4,3,3,4,3,5,4,4,3,5,5,3,5,5,5,3,5,5,3,4,5,5,3,1,3,2,0,3,4,0,4,2,0,4,2,1,5,3,2,3,5,0,4,0,2,0,5,4,4,5,4,5,0,4,0,0,4,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,4,0,3,0,3,0,4,5,4,3,3,3,3,4,3,5,4,4,3,5,4,4,3,4,3,4,4,4,4,5,3,4,4,3,4,5,5,4,5,5,1,4,5,4,3,0,3,3,1,3,3,0,4,4,0,3,3,1,5,3,3,3,5,0,4,0,3,0,4,4,3,4,3,3,0,4,1,1,3,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,4,0,3,0,3,0,4,0,3,4,4,3,2,2,1,2,1,3,1,3,3,3,3,3,4,3,1,3,3,5,3,3,0,4,3,0,5,4,3,3,5,4,4,3,4,4,5,0,1,2,0,1,2,0,2,2,0,1,0,0,5,2,2,1,4,0,3,0,1,0,4,4,3,5,4,3,0,2,1,0,4,3),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,5,0,4,0,2,1,4,4,2,4,1,4,2,4,2,4,3,3,3,4,3,3,3,3,1,4,2,3,3,3,1,4,4,1,1,1,4,3,3,2,0,2,4,3,2,0,3,3,0,3,1,1,0,0,0,3,3,0,4,2,2,3,4,0,4,0,3,0,4,4,5,3,4,4,0,3,0,0,1,4),
+(1,4,0,4,0,4,0,4,0,3,5,4,4,3,4,3,5,4,3,3,4,3,5,4,4,4,4,3,4,2,4,3,3,1,5,4,3,2,4,5,4,5,5,4,4,5,4,4,0,3,2,2,3,3,0,4,3,1,3,2,1,4,3,3,4,5,0,3,0,2,0,4,5,5,4,5,4,0,4,0,0,5,4),
+(0,5,0,5,0,4,0,3,0,4,4,3,4,3,3,3,4,0,4,4,4,3,4,3,4,3,3,1,4,2,4,3,4,0,5,4,1,4,5,4,4,5,3,2,4,3,4,3,2,4,1,3,3,3,2,3,2,0,4,3,3,4,3,3,3,4,0,4,0,3,0,4,5,4,4,4,3,0,4,1,0,1,3),
+(0,3,1,4,0,3,0,2,0,3,4,4,3,1,4,2,3,3,4,3,4,3,4,3,4,4,3,2,3,1,5,4,4,1,4,4,3,5,4,4,3,5,5,4,3,4,4,3,1,2,3,1,2,2,0,3,2,0,3,1,0,5,3,3,3,4,3,3,3,3,4,4,4,4,5,4,2,0,3,3,2,4,3),
+(0,2,0,3,0,1,0,1,0,0,3,2,0,0,2,0,1,0,2,1,3,3,3,1,2,3,1,0,1,0,4,2,1,1,3,3,0,4,3,3,1,4,3,3,0,3,3,2,0,0,0,0,1,0,0,2,0,0,0,0,0,4,1,0,2,3,2,2,2,1,3,3,3,4,4,3,2,0,3,1,0,3,3),
+(0,4,0,4,0,3,0,3,0,4,4,4,3,3,3,3,3,3,4,3,4,2,4,3,4,3,3,2,4,3,4,5,4,1,4,5,3,5,4,5,3,5,4,0,3,5,5,3,1,3,3,2,2,3,0,3,4,1,3,3,2,4,3,3,3,4,0,4,0,3,0,4,5,4,4,5,3,0,4,1,0,3,4),
+(0,2,0,3,0,3,0,0,0,2,2,2,1,0,1,0,0,0,3,0,3,0,3,0,1,3,1,0,3,1,3,3,3,1,3,3,3,0,1,3,1,3,4,0,0,3,1,1,0,3,2,0,0,0,0,1,3,0,1,0,0,3,3,2,0,3,0,0,0,0,0,3,4,3,4,3,3,0,3,0,0,2,3),
+(2,3,0,3,0,2,0,1,0,3,3,4,3,1,3,1,1,1,3,1,4,3,4,3,3,3,0,0,3,1,5,4,3,1,4,3,2,5,5,4,4,4,4,3,3,4,4,4,0,2,1,1,3,2,0,1,2,0,0,1,0,4,1,3,3,3,0,3,0,1,0,4,4,4,5,5,3,0,2,0,0,4,4),
+(0,2,0,1,0,3,1,3,0,2,3,3,3,0,3,1,0,0,3,0,3,2,3,1,3,2,1,1,0,0,4,2,1,0,2,3,1,4,3,2,0,4,4,3,1,3,1,3,0,1,0,0,1,0,0,0,1,0,0,0,0,4,1,1,1,2,0,3,0,0,0,3,4,2,4,3,2,0,1,0,0,3,3),
+(0,1,0,4,0,5,0,4,0,2,4,4,2,3,3,2,3,3,5,3,3,3,4,3,4,2,3,0,4,3,3,3,4,1,4,3,2,1,5,5,3,4,5,1,3,5,4,2,0,3,3,0,1,3,0,4,2,0,1,3,1,4,3,3,3,3,0,3,0,1,0,3,4,4,4,5,5,0,3,0,1,4,5),
+(0,2,0,3,0,3,0,0,0,2,3,1,3,0,4,0,1,1,3,0,3,4,3,2,3,1,0,3,3,2,3,1,3,0,2,3,0,2,1,4,1,2,2,0,0,3,3,0,0,2,0,0,0,1,0,0,0,0,2,2,0,3,2,1,3,3,0,2,0,2,0,0,3,3,1,2,4,0,3,0,2,2,3),
+(2,4,0,5,0,4,0,4,0,2,4,4,4,3,4,3,3,3,1,2,4,3,4,3,4,4,5,0,3,3,3,3,2,0,4,3,1,4,3,4,1,4,4,3,3,4,4,3,1,2,3,0,4,2,0,4,1,0,3,3,0,4,3,3,3,4,0,4,0,2,0,3,5,3,4,5,2,0,3,0,0,4,5),
+(0,3,0,4,0,1,0,1,0,1,3,2,2,1,3,0,3,0,2,0,2,0,3,0,2,0,0,0,1,0,1,1,0,0,3,1,0,0,0,4,0,3,1,0,2,1,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,4,2,2,3,1,0,3,0,0,0,1,4,4,4,3,0,0,4,0,0,1,4),
+(1,4,1,5,0,3,0,3,0,4,5,4,4,3,5,3,3,4,4,3,4,1,3,3,3,3,2,1,4,1,5,4,3,1,4,4,3,5,4,4,3,5,4,3,3,4,4,4,0,3,3,1,2,3,0,3,1,0,3,3,0,5,4,4,4,4,4,4,3,3,5,4,4,3,3,5,4,0,3,2,0,4,4),
+(0,2,0,3,0,1,0,0,0,1,3,3,3,2,4,1,3,0,3,1,3,0,2,2,1,1,0,0,2,0,4,3,1,0,4,3,0,4,4,4,1,4,3,1,1,3,3,1,0,2,0,0,1,3,0,0,0,0,2,0,0,4,3,2,4,3,5,4,3,3,3,4,3,3,4,3,3,0,2,1,0,3,3),
+(0,2,0,4,0,3,0,2,0,2,5,5,3,4,4,4,4,1,4,3,3,0,4,3,4,3,1,3,3,2,4,3,0,3,4,3,0,3,4,4,2,4,4,0,4,5,3,3,2,2,1,1,1,2,0,1,5,0,3,3,2,4,3,3,3,4,0,3,0,2,0,4,4,3,5,5,0,0,3,0,2,3,3),
+(0,3,0,4,0,3,0,1,0,3,4,3,3,1,3,3,3,0,3,1,3,0,4,3,3,1,1,0,3,0,3,3,0,0,4,4,0,1,5,4,3,3,5,0,3,3,4,3,0,2,0,1,1,1,0,1,3,0,1,2,1,3,3,2,3,3,0,3,0,1,0,1,3,3,4,4,1,0,1,2,2,1,3),
+(0,1,0,4,0,4,0,3,0,1,3,3,3,2,3,1,1,0,3,0,3,3,4,3,2,4,2,0,1,0,4,3,2,0,4,3,0,5,3,3,2,4,4,4,3,3,3,4,0,1,3,0,0,1,0,0,1,0,0,0,0,4,2,3,3,3,0,3,0,0,0,4,4,4,5,3,2,0,3,3,0,3,5),
+(0,2,0,3,0,0,0,3,0,1,3,0,2,0,0,0,1,0,3,1,1,3,3,0,0,3,0,0,3,0,2,3,1,0,3,1,0,3,3,2,0,4,2,2,0,2,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,2,1,2,0,1,0,1,0,0,0,1,3,1,2,0,0,0,1,0,0,1,4),
+(0,3,0,3,0,5,0,1,0,2,4,3,1,3,3,2,1,1,5,2,1,0,5,1,2,0,0,0,3,3,2,2,3,2,4,3,0,0,3,3,1,3,3,0,2,5,3,4,0,3,3,0,1,2,0,2,2,0,3,2,0,2,2,3,3,3,0,2,0,1,0,3,4,4,2,5,4,0,3,0,0,3,5),
+(0,3,0,3,0,3,0,1,0,3,3,3,3,0,3,0,2,0,2,1,1,0,2,0,1,0,0,0,2,1,0,0,1,0,3,2,0,0,3,3,1,2,3,1,0,3,3,0,0,1,0,0,0,0,0,2,0,0,0,0,0,2,3,1,2,3,0,3,0,1,0,3,2,1,0,4,3,0,1,1,0,3,3),
+(0,4,0,5,0,3,0,3,0,4,5,5,4,3,5,3,4,3,5,3,3,2,5,3,4,4,4,3,4,3,4,5,5,3,4,4,3,4,4,5,4,4,4,3,4,5,5,4,2,3,4,2,3,4,0,3,3,1,4,3,2,4,3,3,5,5,0,3,0,3,0,5,5,5,5,4,4,0,4,0,1,4,4),
+(0,4,0,4,0,3,0,3,0,3,5,4,4,2,3,2,5,1,3,2,5,1,4,2,3,2,3,3,4,3,3,3,3,2,5,4,1,3,3,5,3,4,4,0,4,4,3,1,1,3,1,0,2,3,0,2,3,0,3,0,0,4,3,1,3,4,0,3,0,2,0,4,4,4,3,4,5,0,4,0,0,3,4),
+(0,3,0,3,0,3,1,2,0,3,4,4,3,3,3,0,2,2,4,3,3,1,3,3,3,1,1,0,3,1,4,3,2,3,4,4,2,4,4,4,3,4,4,3,2,4,4,3,1,3,3,1,3,3,0,4,1,0,2,2,1,4,3,2,3,3,5,4,3,3,5,4,4,3,3,0,4,0,3,2,2,4,4),
+(0,2,0,1,0,0,0,0,0,1,2,1,3,0,0,0,0,0,2,0,1,2,1,0,0,1,0,0,0,0,3,0,0,1,0,1,1,3,1,0,0,0,1,1,0,1,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,1,2,2,0,3,4,0,0,0,1,1,0,0,1,0,0,0,0,0,1,1),
+(0,1,0,0,0,1,0,0,0,0,4,0,4,1,4,0,3,0,4,0,3,0,4,0,3,0,3,0,4,1,5,1,4,0,0,3,0,5,0,5,2,0,1,0,0,0,2,1,4,0,1,3,0,0,3,0,0,3,1,1,4,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0),
+(1,4,0,5,0,3,0,2,0,3,5,4,4,3,4,3,5,3,4,3,3,0,4,3,3,3,3,3,3,2,4,4,3,1,3,4,4,5,4,4,3,4,4,1,3,5,4,3,3,3,1,2,2,3,3,1,3,1,3,3,3,5,3,3,4,5,0,3,0,3,0,3,4,3,4,4,3,0,3,0,2,4,3),
+(0,1,0,4,0,0,0,0,0,1,4,0,4,1,4,2,4,0,3,0,1,0,1,0,0,0,0,0,2,0,3,1,1,1,0,3,0,0,0,1,2,1,0,0,1,1,1,1,0,1,0,0,0,1,0,0,3,0,0,0,0,3,2,0,2,2,0,1,0,0,0,2,3,2,3,3,0,0,0,0,2,1,0),
+(0,5,1,5,0,3,0,3,0,5,4,4,5,1,5,3,3,0,4,3,4,3,5,3,4,3,3,2,4,3,4,3,3,0,3,3,1,4,4,3,4,4,4,3,4,5,5,3,2,3,1,1,3,3,1,3,1,1,3,3,2,4,5,3,3,5,0,4,0,3,0,4,4,3,5,3,3,0,3,4,0,4,3),
+(0,5,0,5,0,3,0,2,0,4,4,3,5,2,4,3,3,3,4,4,4,3,5,3,5,3,3,1,4,0,4,3,3,0,3,3,0,4,4,4,4,5,4,3,3,5,5,3,2,3,1,2,3,2,0,1,0,0,3,2,2,4,4,3,1,5,0,4,0,3,0,4,3,1,3,2,1,0,3,3,0,3,3),
+(0,4,0,5,0,5,0,4,0,4,5,5,5,3,4,3,3,2,5,4,4,3,5,3,5,3,4,0,4,3,4,4,3,2,4,4,3,4,5,4,4,5,5,0,3,5,5,4,1,3,3,2,3,3,1,3,1,0,4,3,1,4,4,3,4,5,0,4,0,2,0,4,3,4,4,3,3,0,4,0,0,5,5),
+(0,4,0,4,0,5,0,1,1,3,3,4,4,3,4,1,3,0,5,1,3,0,3,1,3,1,1,0,3,0,3,3,4,0,4,3,0,4,4,4,3,4,4,0,3,5,4,1,0,3,0,0,2,3,0,3,1,0,3,1,0,3,2,1,3,5,0,3,0,1,0,3,2,3,3,4,4,0,2,2,0,4,4),
+(2,4,0,5,0,4,0,3,0,4,5,5,4,3,5,3,5,3,5,3,5,2,5,3,4,3,3,4,3,4,5,3,2,1,5,4,3,2,3,4,5,3,4,1,2,5,4,3,0,3,3,0,3,2,0,2,3,0,4,1,0,3,4,3,3,5,0,3,0,1,0,4,5,5,5,4,3,0,4,2,0,3,5),
+(0,5,0,4,0,4,0,2,0,5,4,3,4,3,4,3,3,3,4,3,4,2,5,3,5,3,4,1,4,3,4,4,4,0,3,5,0,4,4,4,4,5,3,1,3,4,5,3,3,3,3,3,3,3,0,2,2,0,3,3,2,4,3,3,3,5,3,4,1,3,3,5,3,2,0,0,0,0,4,3,1,3,3),
+(0,1,0,3,0,3,0,1,0,1,3,3,3,2,3,3,3,0,3,0,0,0,3,1,3,0,0,0,2,2,2,3,0,0,3,2,0,1,2,4,1,3,3,0,0,3,3,3,0,1,0,0,2,1,0,0,3,0,3,1,0,3,0,0,1,3,0,2,0,1,0,3,3,1,3,3,0,0,1,1,0,3,3),
+(0,2,0,3,0,2,1,4,0,2,2,3,1,1,3,1,1,0,2,0,3,1,2,3,1,3,0,0,1,0,4,3,2,3,3,3,1,4,2,3,3,3,3,1,0,3,1,4,0,1,1,0,1,2,0,1,1,0,1,1,0,3,1,3,2,2,0,1,0,0,0,2,3,3,3,1,0,0,0,0,0,2,3),
+(0,5,0,4,0,5,0,2,0,4,5,5,3,3,4,3,3,1,5,4,4,2,4,4,4,3,4,2,4,3,5,5,4,3,3,4,3,3,5,5,4,5,5,1,3,4,5,3,1,4,3,1,3,3,0,3,3,1,4,3,1,4,5,3,3,5,0,4,0,3,0,5,3,3,1,4,3,0,4,0,1,5,3),
+(0,5,0,5,0,4,0,2,0,4,4,3,4,3,3,3,3,3,5,4,4,4,4,4,4,5,3,3,5,2,4,4,4,3,4,4,3,3,4,4,5,5,3,3,4,3,4,3,3,4,3,3,3,3,1,2,2,1,4,3,3,5,4,4,3,4,0,4,0,3,0,4,4,4,4,4,1,0,4,2,0,2,4),
+(0,4,0,4,0,3,0,1,0,3,5,2,3,0,3,0,2,1,4,2,3,3,4,1,4,3,3,2,4,1,3,3,3,0,3,3,0,0,3,3,3,5,3,3,3,3,3,2,0,2,0,0,2,0,0,2,0,0,1,0,0,3,1,2,2,3,0,3,0,2,0,4,4,3,3,4,1,0,3,0,0,2,4),
+(0,0,0,4,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,1,0,2,0,1,0,0,0,0,0,3,1,3,0,3,2,0,0,0,1,0,3,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,4,0,2,0,0,0,0,0,0,2),
+(0,2,1,3,0,2,0,2,0,3,3,3,3,1,3,1,3,3,3,3,3,3,4,2,2,1,2,1,4,0,4,3,1,3,3,3,2,4,3,5,4,3,3,3,3,3,3,3,0,1,3,0,2,0,0,1,0,0,1,0,0,4,2,0,2,3,0,3,3,0,3,3,4,2,3,1,4,0,1,2,0,2,3),
+(0,3,0,3,0,1,0,3,0,2,3,3,3,0,3,1,2,0,3,3,2,3,3,2,3,2,3,1,3,0,4,3,2,0,3,3,1,4,3,3,2,3,4,3,1,3,3,1,1,0,1,1,0,1,0,1,0,1,0,0,0,4,1,1,0,3,0,3,1,0,2,3,3,3,3,3,1,0,0,2,0,3,3),
+(0,0,0,0,0,0,0,0,0,0,3,0,2,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,3,0,3,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,2,0,2,3,0,0,0,0,0,0,0,0,3),
+(0,2,0,3,1,3,0,3,0,2,3,3,3,1,3,1,3,1,3,1,3,3,3,1,3,0,2,3,1,1,4,3,3,2,3,3,1,2,2,4,1,3,3,0,1,4,2,3,0,1,3,0,3,0,0,1,3,0,2,0,0,3,3,2,1,3,0,3,0,2,0,3,4,4,4,3,1,0,3,0,0,3,3),
+(0,2,0,1,0,2,0,0,0,1,3,2,2,1,3,0,1,1,3,0,3,2,3,1,2,0,2,0,1,1,3,3,3,0,3,3,1,1,2,3,2,3,3,1,2,3,2,0,0,1,0,0,0,0,0,0,3,0,1,0,0,2,1,2,1,3,0,3,0,0,0,3,4,4,4,3,2,0,2,0,0,2,4),
+(0,0,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,3,1,0,0,0,0,0,0,0,3),
+(0,3,0,3,0,2,0,3,0,3,3,3,2,3,2,2,2,0,3,1,3,3,3,2,3,3,0,0,3,0,3,2,2,0,2,3,1,4,3,4,3,3,2,3,1,5,4,4,0,3,1,2,1,3,0,3,1,1,2,0,2,3,1,3,1,3,0,3,0,1,0,3,3,4,4,2,1,0,2,1,0,2,4),
+(0,1,0,3,0,1,0,2,0,1,4,2,5,1,4,0,2,0,2,1,3,1,4,0,2,1,0,0,2,1,4,1,1,0,3,3,0,5,1,3,2,3,3,1,0,3,2,3,0,1,0,0,0,0,0,0,1,0,0,0,0,4,0,1,0,3,0,2,0,1,0,3,3,3,4,3,3,0,0,0,0,2,3),
+(0,0,0,1,0,0,0,0,0,0,2,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,1,0,0,0,0,0,3),
+(0,1,0,3,0,4,0,3,0,2,4,3,1,0,3,2,2,1,3,1,2,2,3,1,1,1,2,1,3,0,1,2,0,1,3,2,1,3,0,5,5,1,0,0,1,3,2,1,0,3,0,0,1,0,0,0,0,0,3,4,0,1,1,1,3,2,0,2,0,1,0,2,3,3,1,2,3,0,1,0,1,0,4),
+(0,0,0,1,0,3,0,3,0,2,2,1,0,0,4,0,3,0,3,1,3,0,3,0,3,0,1,0,3,0,3,1,3,0,3,3,0,0,1,2,1,1,1,0,1,2,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,2,2,1,2,0,0,2,0,0,0,0,2,3,3,3,3,0,0,0,0,1,4),
+(0,0,0,3,0,3,0,0,0,0,3,1,1,0,3,0,1,0,2,0,1,0,0,0,0,0,0,0,1,0,3,0,2,0,2,3,0,0,2,2,3,1,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,2,3),
+(2,4,0,5,0,5,0,4,0,3,4,3,3,3,4,3,3,3,4,3,4,4,5,4,5,5,5,2,3,0,5,5,4,1,5,4,3,1,5,4,3,4,4,3,3,4,3,3,0,3,2,0,2,3,0,3,0,0,3,3,0,5,3,2,3,3,0,3,0,3,0,3,4,5,4,5,3,0,4,3,0,3,4),
+(0,3,0,3,0,3,0,3,0,3,3,4,3,2,3,2,3,0,4,3,3,3,3,3,3,3,3,0,3,2,4,3,3,1,3,4,3,4,4,4,3,4,4,3,2,4,4,1,0,2,0,0,1,1,0,2,0,0,3,1,0,5,3,2,1,3,0,3,0,1,2,4,3,2,4,3,3,0,3,2,0,4,4),
+(0,3,0,3,0,1,0,0,0,1,4,3,3,2,3,1,3,1,4,2,3,2,4,2,3,4,3,0,2,2,3,3,3,0,3,3,3,0,3,4,1,3,3,0,3,4,3,3,0,1,1,0,1,0,0,0,4,0,3,0,0,3,1,2,1,3,0,4,0,1,0,4,3,3,4,3,3,0,2,0,0,3,3),
+(0,3,0,4,0,1,0,3,0,3,4,3,3,0,3,3,3,1,3,1,3,3,4,3,3,3,0,0,3,1,5,3,3,1,3,3,2,5,4,3,3,4,5,3,2,5,3,4,0,1,0,0,0,0,0,2,0,0,1,1,0,4,2,2,1,3,0,3,0,2,0,4,4,3,5,3,2,0,1,1,0,3,4),
+(0,5,0,4,0,5,0,2,0,4,4,3,3,2,3,3,3,1,4,3,4,1,5,3,4,3,4,0,4,2,4,3,4,1,5,4,0,4,4,4,4,5,4,1,3,5,4,2,1,4,1,1,3,2,0,3,1,0,3,2,1,4,3,3,3,4,0,4,0,3,0,4,4,4,3,3,3,0,4,2,0,3,4),
+(1,4,0,4,0,3,0,1,0,3,3,3,1,1,3,3,2,2,3,3,1,0,3,2,2,1,2,0,3,1,2,1,2,0,3,2,0,2,2,3,3,4,3,0,3,3,1,2,0,1,1,3,1,2,0,0,3,0,1,1,0,3,2,2,3,3,0,3,0,0,0,2,3,3,4,3,3,0,1,0,0,1,4),
+(0,4,0,4,0,4,0,0,0,3,4,4,3,1,4,2,3,2,3,3,3,1,4,3,4,0,3,0,4,2,3,3,2,2,5,4,2,1,3,4,3,4,3,1,3,3,4,2,0,2,1,0,3,3,0,0,2,0,3,1,0,4,4,3,4,3,0,4,0,1,0,2,4,4,4,4,4,0,3,2,0,3,3),
+(0,0,0,1,0,4,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,3,2,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2),
+(0,2,0,3,0,4,0,4,0,1,3,3,3,0,4,0,2,1,2,1,1,1,2,0,3,1,1,0,1,0,3,1,0,0,3,3,2,0,1,1,0,0,0,0,0,1,0,2,0,2,2,0,3,1,0,0,1,0,1,1,0,1,2,0,3,0,0,0,0,1,0,0,3,3,4,3,1,0,1,0,3,0,2),
+(0,0,0,3,0,5,0,0,0,0,1,0,2,0,3,1,0,1,3,0,0,0,2,0,0,0,1,0,0,0,1,1,0,0,4,0,0,0,2,3,0,1,4,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,1,0,0,0,0,0,0,0,2,0,0,3,0,0,0,0,0,3),
+(0,2,0,5,0,5,0,1,0,2,4,3,3,2,5,1,3,2,3,3,3,0,4,1,2,0,3,0,4,0,2,2,1,1,5,3,0,0,1,4,2,3,2,0,3,3,3,2,0,2,4,1,1,2,0,1,1,0,3,1,0,1,3,1,2,3,0,2,0,0,0,1,3,5,4,4,4,0,3,0,0,1,3),
+(0,4,0,5,0,4,0,4,0,4,5,4,3,3,4,3,3,3,4,3,4,4,5,3,4,5,4,2,4,2,3,4,3,1,4,4,1,3,5,4,4,5,5,4,4,5,5,5,2,3,3,1,4,3,1,3,3,0,3,3,1,4,3,4,4,4,0,3,0,4,0,3,3,4,4,5,0,0,4,3,0,4,5),
+(0,4,0,4,0,3,0,3,0,3,4,4,4,3,3,2,4,3,4,3,4,3,5,3,4,3,2,1,4,2,4,4,3,1,3,4,2,4,5,5,3,4,5,4,1,5,4,3,0,3,2,2,3,2,1,3,1,0,3,3,3,5,3,3,3,5,4,4,2,3,3,4,3,3,3,2,1,0,3,2,1,4,3),
+(0,4,0,5,0,4,0,3,0,3,5,5,3,2,4,3,4,0,5,4,4,1,4,4,4,3,3,3,4,3,5,5,2,3,3,4,1,2,5,5,3,5,5,2,3,5,5,4,0,3,2,0,3,3,1,1,5,1,4,1,0,4,3,2,3,5,0,4,0,3,0,5,4,3,4,3,0,0,4,1,0,4,4),
+(1,3,0,4,0,2,0,2,0,2,5,5,3,3,3,3,3,0,4,2,3,4,4,4,3,4,0,0,3,4,5,4,3,3,3,3,2,5,5,4,5,5,5,4,3,5,5,5,1,3,1,0,1,0,0,3,2,0,4,2,0,5,2,3,2,4,1,3,0,3,0,4,5,4,5,4,3,0,4,2,0,5,4),
+(0,3,0,4,0,5,0,3,0,3,4,4,3,2,3,2,3,3,3,3,3,2,4,3,3,2,2,0,3,3,3,3,3,1,3,3,3,0,4,4,3,4,4,1,1,4,4,2,0,3,1,0,1,1,0,4,1,0,2,3,1,3,3,1,3,4,0,3,0,1,0,3,1,3,0,0,1,0,2,0,0,4,4),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
+(0,3,0,3,0,2,0,3,0,1,5,4,3,3,3,1,4,2,1,2,3,4,4,2,4,4,5,0,3,1,4,3,4,0,4,3,3,3,2,3,2,5,3,4,3,2,2,3,0,0,3,0,2,1,0,1,2,0,0,0,0,2,1,1,3,1,0,2,0,4,0,3,4,4,4,5,2,0,2,0,0,1,3),
+(0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,1,0,0,1,1,0,0,0,4,2,1,1,0,1,0,3,2,0,0,3,1,1,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,1,0,0,0,2,0,0,0,1,4,0,4,2,1,0,0,0,0,0,1),
+(0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,1,0,1,0,0,0,0,3,1,0,0,0,2,0,2,1,0,0,1,2,1,0,1,1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,1,3,1,0,0,0,0,0,1,0,0,2,1,0,0,0,0,0,0,0,0,2),
+(0,4,0,4,0,4,0,3,0,4,4,3,4,2,4,3,2,0,4,4,4,3,5,3,5,3,3,2,4,2,4,3,4,3,1,4,0,2,3,4,4,4,3,3,3,4,4,4,3,4,1,3,4,3,2,1,2,1,3,3,3,4,4,3,3,5,0,4,0,3,0,4,3,3,3,2,1,0,3,0,0,3,3),
+(0,4,0,3,0,3,0,3,0,3,5,5,3,3,3,3,4,3,4,3,3,3,4,4,4,3,3,3,3,4,3,5,3,3,1,3,2,4,5,5,5,5,4,3,4,5,5,3,2,2,3,3,3,3,2,3,3,1,2,3,2,4,3,3,3,4,0,4,0,2,0,4,3,2,2,1,2,0,3,0,0,4,1),
+)
+
+class JapaneseContextAnalysis(object):
+    NUM_OF_CATEGORY = 6
+    DONT_KNOW = -1
+    ENOUGH_REL_THRESHOLD = 100
+    MAX_REL_THRESHOLD = 1000
+    MINIMUM_DATA_THRESHOLD = 4
+
+    def __init__(self):
+        self._total_rel = None
+        self._rel_sample = None
+        self._need_to_skip_char_num = None
+        self._last_char_order = None
+        self._done = None
+        self.reset()
+
+    def reset(self):
+        self._total_rel = 0  # total sequence received
+        # category counters, each integer counts sequence in its category
+        self._rel_sample = [0] * self.NUM_OF_CATEGORY
+        # if last byte in current buffer is not the last byte of a character,
+        # we need to know how many bytes to skip in next buffer
+        self._need_to_skip_char_num = 0
+        self._last_char_order = -1  # The order of previous char
+        # If this flag is set to True, detection is done and conclusion has
+        # been made
+        self._done = False
+
+    def feed(self, byte_str, num_bytes):
+        if self._done:
+            return
+
+        # The buffer we got is byte oriented, and a character may span in more than one
+        # buffers. In case the last one or two byte in last buffer is not
+        # complete, we record how many byte needed to complete that character
+        # and skip these bytes here.  We can choose to record those bytes as
+        # well and analyse the character once it is complete, but since a
+        # character will not make much difference, by simply skipping
+        # this character will simply our logic and improve performance.
+        i = self._need_to_skip_char_num
+        while i < num_bytes:
+            order, char_len = self.get_order(byte_str[i:i + 2])
+            i += char_len
+            if i > num_bytes:
+                self._need_to_skip_char_num = i - num_bytes
+                self._last_char_order = -1
+            else:
+                if (order != -1) and (self._last_char_order != -1):
+                    self._total_rel += 1
+                    if self._total_rel > self.MAX_REL_THRESHOLD:
+                        self._done = True
+                        break
+                    self._rel_sample[jp2CharContext[self._last_char_order][order]] += 1
+                self._last_char_order = order
+
+    def got_enough_data(self):
+        return self._total_rel > self.ENOUGH_REL_THRESHOLD
+
+    def get_confidence(self):
+        # This is just one way to calculate confidence. It works well for me.
+        if self._total_rel > self.MINIMUM_DATA_THRESHOLD:
+            return (self._total_rel - self._rel_sample[0]) / self._total_rel
+        else:
+            return self.DONT_KNOW
+
+    def get_order(self, byte_str):
+        return -1, 1
+
+class SJISContextAnalysis(JapaneseContextAnalysis):
+    def __init__(self):
+        super(SJISContextAnalysis, self).__init__()
+        self._charset_name = "SHIFT_JIS"
+
+    @property
+    def charset_name(self):
+        return self._charset_name
+
+    def get_order(self, byte_str):
+        if not byte_str:
+            return -1, 1
+        # find out current char's byte length
+        first_char = byte_str[0]
+        if (0x81 <= first_char <= 0x9F) or (0xE0 <= first_char <= 0xFC):
+            char_len = 2
+            if (first_char == 0x87) or (0xFA <= first_char <= 0xFC):
+                self._charset_name = "CP932"
+        else:
+            char_len = 1
+
+        # return its order if it is hiragana
+        if len(byte_str) > 1:
+            second_char = byte_str[1]
+            if (first_char == 202) and (0x9F <= second_char <= 0xF1):
+                return second_char - 0x9F, char_len
+
+        return -1, char_len
+
+class EUCJPContextAnalysis(JapaneseContextAnalysis):
+    def get_order(self, byte_str):
+        if not byte_str:
+            return -1, 1
+        # find out current char's byte length
+        first_char = byte_str[0]
+        if (first_char == 0x8E) or (0xA1 <= first_char <= 0xFE):
+            char_len = 2
+        elif first_char == 0x8F:
+            char_len = 3
+        else:
+            char_len = 1
+
+        # return its order if it is hiragana
+        if len(byte_str) > 1:
+            second_char = byte_str[1]
+            if (first_char == 0xA4) and (0xA1 <= second_char <= 0xF3):
+                return second_char - 0xA1, char_len
+
+        return -1, char_len
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langbulgarianmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langbulgarianmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..2aa4fb2e22fc3bfa26b569273c6cb18c4c415dd9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langbulgarianmodel.py
@@ -0,0 +1,228 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# Character Mapping Table:
+# this table is modified base on win1251BulgarianCharToOrderMap, so
+# only number <64 is sure valid
+
+Latin5_BulgarianCharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82,  # 40
+110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253,  # 50
+253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71,  # 60
+116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253,  # 70
+194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,  # 80
+210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,  # 90
+ 81,226,227,228,229,230,105,231,232,233,234,235,236, 45,237,238,  # a0
+ 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30,  # b0
+ 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,239, 67,240, 60, 56,  # c0
+  1, 18,  9, 20, 11,  3, 23, 15,  2, 26, 12, 10, 14,  6,  4, 13,  # d0
+  7,  8,  5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,241, 42, 16,  # e0
+ 62,242,243,244, 58,245, 98,246,247,248,249,250,251, 91,252,253,  # f0
+)
+
+win1251BulgarianCharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82,  # 40
+110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253,  # 50
+253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71,  # 60
+116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253,  # 70
+206,207,208,209,210,211,212,213,120,214,215,216,217,218,219,220,  # 80
+221, 78, 64, 83,121, 98,117,105,222,223,224,225,226,227,228,229,  # 90
+ 88,230,231,232,233,122, 89,106,234,235,236,237,238, 45,239,240,  # a0
+ 73, 80,118,114,241,242,243,244,245, 62, 58,246,247,248,249,250,  # b0
+ 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30,  # c0
+ 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,251, 67,252, 60, 56,  # d0
+  1, 18,  9, 20, 11,  3, 23, 15,  2, 26, 12, 10, 14,  6,  4, 13,  # e0
+  7,  8,  5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,253, 42, 16,  # f0
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 96.9392%
+# first 1024 sequences:3.0618%
+# rest  sequences:     0.2992%
+# negative sequences:  0.0020%
+BulgarianLangModel = (
+0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,3,3,3,3,3,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,2,2,1,2,2,
+3,1,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,0,1,
+0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,3,3,0,3,1,0,
+0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,2,3,2,2,1,3,3,3,3,2,2,2,1,1,2,0,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,2,3,2,2,3,3,1,1,2,3,3,2,3,3,3,3,2,1,2,0,2,0,3,0,0,
+0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,1,3,3,3,3,3,2,3,2,3,3,3,3,3,2,3,3,1,3,0,3,0,2,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,3,1,3,3,2,3,3,3,1,3,3,2,3,2,2,2,0,0,2,0,2,0,2,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,3,3,1,2,2,3,2,1,1,2,0,2,0,0,0,0,
+1,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,2,3,3,1,2,3,2,2,2,3,3,3,3,3,2,2,3,1,2,0,2,1,2,0,0,
+0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,1,3,3,3,3,3,2,3,3,3,2,3,3,2,3,2,2,2,3,1,2,0,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,3,3,3,3,1,1,1,2,2,1,3,1,3,2,2,3,0,0,1,0,1,0,1,0,0,
+0,0,0,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,2,2,3,2,2,3,1,2,1,1,1,2,3,1,3,1,2,2,0,1,1,1,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,1,3,2,2,3,3,1,2,3,1,1,3,3,3,3,1,2,2,1,1,1,0,2,0,2,0,1,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,2,2,3,3,3,2,2,1,1,2,0,2,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,0,1,2,1,3,3,2,3,3,3,3,3,2,3,2,1,0,3,1,2,1,2,1,2,3,2,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,1,1,2,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,1,3,3,2,3,3,2,2,2,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,3,0,3,3,3,3,3,2,1,1,2,1,3,3,0,3,1,1,1,1,3,2,0,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,1,1,3,1,3,3,2,3,2,2,2,3,0,2,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,2,3,3,2,2,3,2,1,1,1,1,1,3,1,3,1,1,0,0,0,1,0,0,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,2,3,2,0,3,2,0,3,0,2,0,0,2,1,3,1,0,0,1,0,0,0,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,2,1,1,1,1,2,1,1,2,1,1,1,2,2,1,2,1,1,1,0,1,1,0,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,2,1,3,1,1,2,1,3,2,1,1,0,1,2,3,2,1,1,1,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,3,2,2,1,0,1,0,0,1,0,0,0,2,1,0,3,0,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,2,3,2,3,3,1,3,2,1,1,1,2,1,1,2,1,3,0,1,0,0,0,1,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,1,2,2,3,3,2,3,2,2,2,3,1,2,2,1,1,2,1,1,2,2,0,1,1,0,1,0,2,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,2,1,3,1,0,2,2,1,3,2,1,0,0,2,0,2,0,1,0,0,0,0,0,0,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,3,1,2,0,2,3,1,2,3,2,0,1,3,1,2,1,1,1,0,0,1,0,0,2,2,2,3,
+2,2,2,2,1,2,1,1,2,2,1,1,2,0,1,1,1,0,0,1,1,0,0,1,1,0,0,0,1,1,0,1,
+3,3,3,3,3,2,1,2,2,1,2,0,2,0,1,0,1,2,1,2,1,1,0,0,0,1,0,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
+3,3,2,3,3,1,1,3,1,0,3,2,1,0,0,0,1,2,0,2,0,1,0,0,0,1,0,1,2,1,2,2,
+1,1,1,1,1,1,1,2,2,2,1,1,1,1,1,1,1,0,1,2,1,1,1,0,0,0,0,0,1,1,0,0,
+3,1,0,1,0,2,3,2,2,2,3,2,2,2,2,2,1,0,2,1,2,1,1,1,0,1,2,1,2,2,2,1,
+1,1,2,2,2,2,1,2,1,1,0,1,2,1,2,2,2,1,1,1,0,1,1,1,1,2,0,1,0,0,0,0,
+2,3,2,3,3,0,0,2,1,0,2,1,0,0,0,0,2,3,0,2,0,0,0,0,0,1,0,0,2,0,1,2,
+2,1,2,1,2,2,1,1,1,2,1,1,1,0,1,2,2,1,1,1,1,1,0,1,1,1,0,0,1,2,0,0,
+3,3,2,2,3,0,2,3,1,1,2,0,0,0,1,0,0,2,0,2,0,0,0,1,0,1,0,1,2,0,2,2,
+1,1,1,1,2,1,0,1,2,2,2,1,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,1,0,0,
+2,3,2,3,3,0,0,3,0,1,1,0,1,0,0,0,2,2,1,2,0,0,0,0,0,0,0,0,2,0,1,2,
+2,2,1,1,1,1,1,2,2,2,1,0,2,0,1,0,1,0,0,1,0,1,0,0,1,0,0,0,0,1,0,0,
+3,3,3,3,2,2,2,2,2,0,2,1,1,1,1,2,1,2,1,1,0,2,0,1,0,1,0,0,2,0,1,2,
+1,1,1,1,1,1,1,2,2,1,1,0,2,0,1,0,2,0,0,1,1,1,0,0,2,0,0,0,1,1,0,0,
+2,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0,0,0,0,1,2,0,1,2,
+2,2,2,1,1,2,1,1,2,2,2,1,2,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,1,1,0,0,
+2,3,3,3,3,0,2,2,0,2,1,0,0,0,1,1,1,2,0,2,0,0,0,3,0,0,0,0,2,0,2,2,
+1,1,1,2,1,2,1,1,2,2,2,1,2,0,1,1,1,0,1,1,1,1,0,2,1,0,0,0,1,1,0,0,
+2,3,3,3,3,0,2,1,0,0,2,0,0,0,0,0,1,2,0,2,0,0,0,0,0,0,0,0,2,0,1,2,
+1,1,1,2,1,1,1,1,2,2,2,0,1,0,1,1,1,0,0,1,1,1,0,0,1,0,0,0,0,1,0,0,
+3,3,2,2,3,0,1,0,1,0,0,0,0,0,0,0,1,1,0,3,0,0,0,0,0,0,0,0,1,0,2,2,
+1,1,1,1,1,2,1,1,2,2,1,2,2,1,0,1,1,1,1,1,0,1,0,0,1,0,0,0,1,1,0,0,
+3,1,0,1,0,2,2,2,2,3,2,1,1,1,2,3,0,0,1,0,2,1,1,0,1,1,1,1,2,1,1,1,
+1,2,2,1,2,1,2,2,1,1,0,1,2,1,2,2,1,1,1,0,0,1,1,1,2,1,0,1,0,0,0,0,
+2,1,0,1,0,3,1,2,2,2,2,1,2,2,1,1,1,0,2,1,2,2,1,1,2,1,1,0,2,1,1,1,
+1,2,2,2,2,2,2,2,1,2,0,1,1,0,2,1,1,1,1,1,0,0,1,1,1,1,0,1,0,0,0,0,
+2,1,1,1,1,2,2,2,2,1,2,2,2,1,2,2,1,1,2,1,2,3,2,2,1,1,1,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,3,2,0,1,2,0,1,2,1,1,0,1,0,1,2,1,2,0,0,0,1,1,0,0,0,1,0,0,2,
+1,1,0,0,1,1,0,1,1,1,1,0,2,0,1,1,1,0,0,1,1,0,0,0,0,1,0,0,0,1,0,0,
+2,0,0,0,0,1,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,2,1,1,1,
+1,2,2,2,2,1,1,2,1,2,1,1,1,0,2,1,2,1,1,1,0,2,1,1,1,1,0,1,0,0,0,0,
+3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,
+1,1,0,1,0,1,1,1,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,3,2,0,0,0,0,1,0,0,0,0,0,0,1,1,0,2,0,0,0,0,0,0,0,0,1,0,1,2,
+1,1,1,1,1,1,0,0,2,2,2,2,2,0,1,1,0,1,1,1,1,1,0,0,1,0,0,0,1,1,0,1,
+2,3,1,2,1,0,1,1,0,2,2,2,0,0,1,0,0,1,1,1,1,0,0,0,0,0,0,0,1,0,1,2,
+1,1,1,1,2,1,1,1,1,1,1,1,1,0,1,1,0,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0,
+2,2,2,2,2,0,0,2,0,0,2,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,0,2,2,
+1,1,1,1,1,0,0,1,2,1,1,0,1,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,2,2,0,0,2,0,1,1,0,0,0,1,0,0,2,0,2,0,0,0,0,0,0,0,0,0,0,1,1,
+0,0,0,1,1,1,1,1,1,1,1,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,3,2,0,0,1,0,0,1,0,0,0,0,0,0,1,0,2,0,0,0,1,0,0,0,0,0,0,0,2,
+1,1,0,0,1,0,0,0,1,1,0,0,1,0,1,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
+2,1,2,2,2,1,2,1,2,2,1,1,2,1,1,1,0,1,1,1,1,2,0,1,0,1,1,1,1,0,1,1,
+1,1,2,1,1,1,1,1,1,0,0,1,2,1,1,1,1,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0,
+1,0,0,1,3,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,2,1,0,0,1,0,2,0,0,0,0,0,1,1,1,0,1,0,0,0,0,0,0,0,0,2,0,0,1,
+0,2,0,1,0,0,1,1,2,0,1,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,2,2,0,1,1,0,2,1,0,1,1,1,0,0,1,0,2,0,1,0,0,0,0,0,0,0,0,0,1,
+0,1,0,0,1,0,0,0,1,1,0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,2,2,0,0,1,0,0,0,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1,
+0,1,0,1,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
+2,0,1,0,0,1,2,1,1,1,1,1,1,2,2,1,0,0,1,0,1,0,0,0,0,1,1,1,1,0,0,0,
+1,1,2,1,1,1,1,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,1,2,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1,
+0,0,0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
+0,1,1,0,1,1,1,0,0,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,
+1,0,1,0,0,1,1,1,1,1,1,1,1,1,1,1,0,0,1,0,2,0,0,2,0,1,0,0,1,0,0,1,
+1,1,0,0,1,1,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,
+1,1,1,1,1,1,1,2,0,0,0,0,0,0,2,1,0,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,1,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+)
+
+Latin5BulgarianModel = {
+  'char_to_order_map': Latin5_BulgarianCharToOrderMap,
+  'precedence_matrix': BulgarianLangModel,
+  'typical_positive_ratio': 0.969392,
+  'keep_english_letter': False,
+  'charset_name': "ISO-8859-5",
+  'language': 'Bulgairan',
+}
+
+Win1251BulgarianModel = {
+  'char_to_order_map': win1251BulgarianCharToOrderMap,
+  'precedence_matrix': BulgarianLangModel,
+  'typical_positive_ratio': 0.969392,
+  'keep_english_letter': False,
+  'charset_name': "windows-1251",
+  'language': 'Bulgarian',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langcyrillicmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langcyrillicmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..e5f9a1fd19cca472d785bf90c6395cd11b524766
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langcyrillicmodel.py
@@ -0,0 +1,333 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# KOI8-R language model
+# Character Mapping Table:
+KOI8R_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,  # 80
+207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,  # 90
+223,224,225, 68,226,227,228,229,230,231,232,233,234,235,236,237,  # a0
+238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,  # b0
+ 27,  3, 21, 28, 13,  2, 39, 19, 26,  4, 23, 11,  8, 12,  5,  1,  # c0
+ 15, 16,  9,  7,  6, 14, 24, 10, 17, 18, 20, 25, 30, 29, 22, 54,  # d0
+ 59, 37, 44, 58, 41, 48, 53, 46, 55, 42, 60, 36, 49, 38, 31, 34,  # e0
+ 35, 43, 45, 32, 40, 52, 56, 33, 61, 62, 51, 57, 47, 63, 50, 70,  # f0
+)
+
+win1251_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
+207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
+223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
+239,240,241,242,243,244,245,246, 68,247,248,249,250,251,252,253,
+ 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
+ 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
+  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
+  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
+)
+
+latin5_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
+207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
+223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
+ 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
+ 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
+  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
+  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
+239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255,
+)
+
+macCyrillic_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+ 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
+ 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
+191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
+207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
+223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
+239,240,241,242,243,244,245,246,247,248,249,250,251,252, 68, 16,
+  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
+  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27,255,
+)
+
+IBM855_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+191,192,193,194, 68,195,196,197,198,199,200,201,202,203,204,205,
+206,207,208,209,210,211,212,213,214,215,216,217, 27, 59, 54, 70,
+  3, 37, 21, 44, 28, 58, 13, 41,  2, 48, 39, 53, 19, 46,218,219,
+220,221,222,223,224, 26, 55,  4, 42,225,226,227,228, 23, 60,229,
+230,231,232,233,234,235, 11, 36,236,237,238,239,240,241,242,243,
+  8, 49, 12, 38,  5, 31,  1, 34, 15,244,245,246,247, 35, 16,248,
+ 43,  9, 45,  7, 32,  6, 40, 14, 52, 24, 56, 10, 33, 17, 61,249,
+250, 18, 62, 20, 51, 25, 57, 30, 47, 29, 63, 22, 50,251,252,255,
+)
+
+IBM866_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
+155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
+253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
+ 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
+ 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
+ 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
+  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
+191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
+207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
+223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
+  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
+239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255,
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 97.6601%
+# first 1024 sequences: 2.3389%
+# rest  sequences:      0.1237%
+# negative sequences:   0.0009%
+RussianLangModel = (
+0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,1,3,3,3,3,1,3,3,3,2,3,2,3,3,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,2,2,2,2,2,0,0,2,
+3,3,3,2,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,2,3,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,2,2,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,2,3,3,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1,
+0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1,
+0,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,2,2,2,3,1,3,3,1,3,3,3,3,2,2,3,0,2,2,2,3,3,2,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,3,3,3,3,3,2,2,3,2,3,3,3,2,1,2,2,0,1,2,2,2,2,2,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,3,0,2,2,3,3,2,1,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,3,3,1,2,3,2,2,3,2,3,3,3,3,2,2,3,0,3,2,2,3,1,1,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,3,3,3,3,2,2,2,0,3,3,3,2,2,2,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,2,3,2,2,0,1,3,2,1,2,2,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,2,1,1,3,0,1,1,1,1,2,1,1,0,2,2,2,1,2,0,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,3,3,2,2,2,2,1,3,2,3,2,3,2,1,2,2,0,1,1,2,1,2,1,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,2,3,3,3,2,2,2,2,0,2,2,2,2,3,1,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+3,2,3,2,2,3,3,3,3,3,3,3,3,3,1,3,2,0,0,3,3,3,3,2,3,3,3,3,2,3,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,3,3,2,2,3,3,0,2,1,0,3,2,3,2,3,0,0,1,2,0,0,1,0,1,2,1,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,3,0,2,3,3,3,3,2,3,3,3,3,1,2,2,0,0,2,3,2,2,2,3,2,3,2,2,3,0,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,3,0,2,3,2,3,0,1,2,3,3,2,0,2,3,0,0,2,3,2,2,0,1,3,1,3,2,2,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,3,0,2,3,3,3,3,3,3,3,3,2,1,3,2,0,0,2,2,3,3,3,2,3,3,0,2,2,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,2,3,3,2,2,2,3,3,0,0,1,1,1,1,1,2,0,0,1,1,1,1,0,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,2,3,3,3,3,3,3,3,0,3,2,3,3,2,3,2,0,2,1,0,1,1,0,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,3,3,3,2,2,2,2,3,1,3,2,3,1,1,2,1,0,2,2,2,2,1,3,1,0,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+2,2,3,3,3,3,3,1,2,2,1,3,1,0,3,0,0,3,0,0,0,1,1,0,1,2,1,0,0,0,0,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,2,1,1,3,3,3,2,2,1,2,2,3,1,1,2,0,0,2,2,1,3,0,0,2,1,1,2,1,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,3,3,3,3,1,2,2,2,1,2,1,3,3,1,1,2,1,2,1,2,2,0,2,0,0,1,1,0,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,3,3,2,1,3,2,2,3,2,0,3,2,0,3,0,1,0,1,1,0,0,1,1,1,1,0,1,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,2,3,3,3,2,2,2,3,3,1,2,1,2,1,0,1,0,1,1,0,1,0,0,2,1,1,1,0,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+3,1,1,2,1,2,3,3,2,2,1,2,2,3,0,2,1,0,0,2,2,3,2,1,2,2,2,2,2,3,1,0,
+0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,1,1,0,1,1,2,2,1,1,3,0,0,1,3,1,1,1,0,0,0,1,0,1,1,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,1,3,3,3,2,0,0,0,2,1,0,1,0,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,1,0,0,2,3,2,2,2,1,2,2,2,1,2,1,0,0,1,1,1,0,2,0,1,1,1,0,0,1,1,
+1,0,0,0,0,0,1,2,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,3,0,0,0,0,1,0,0,0,0,3,0,1,2,1,0,0,0,0,0,0,0,1,1,0,0,1,1,
+1,0,1,0,1,2,0,0,1,1,2,1,0,1,1,1,1,0,1,1,1,1,0,1,0,0,1,0,0,1,1,0,
+2,2,3,2,2,2,3,1,2,2,2,2,2,2,2,2,1,1,1,1,1,1,1,0,1,0,1,1,1,0,2,1,
+1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,0,1,1,0,
+3,3,3,2,2,2,2,3,2,2,1,1,2,2,2,2,1,1,3,1,2,1,2,0,0,1,1,0,1,0,2,1,
+1,1,1,1,1,2,1,0,1,1,1,1,0,1,0,0,1,1,0,0,1,0,1,0,0,1,0,0,0,1,1,0,
+2,0,0,1,0,3,2,2,2,2,1,2,1,2,1,2,0,0,0,2,1,2,2,1,1,2,2,0,1,1,0,2,
+1,1,1,1,1,0,1,1,1,2,1,1,1,2,1,0,1,2,1,1,1,1,0,1,1,1,0,0,1,0,0,1,
+1,3,2,2,2,1,1,1,2,3,0,0,0,0,2,0,2,2,1,0,0,0,0,0,0,1,0,0,0,0,1,1,
+1,0,1,1,0,1,0,1,1,0,1,1,0,2,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,
+2,3,2,3,2,1,2,2,2,2,1,0,0,0,2,0,0,1,1,0,0,0,0,0,0,0,1,1,0,0,2,1,
+1,1,2,1,0,2,0,0,1,0,1,0,0,1,0,0,1,1,0,1,1,0,0,0,0,0,1,0,0,0,0,0,
+3,0,0,1,0,2,2,2,3,2,2,2,2,2,2,2,0,0,0,2,1,2,1,1,1,2,2,0,0,0,1,2,
+1,1,1,1,1,0,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,1,0,1,1,1,1,1,1,0,0,1,
+2,3,2,3,3,2,0,1,1,1,0,0,1,0,2,0,1,1,3,1,0,0,0,0,0,0,0,1,0,0,2,1,
+1,1,1,1,1,1,1,0,1,0,1,1,1,1,0,1,1,1,0,0,1,1,0,1,0,0,0,0,0,0,1,0,
+2,3,3,3,3,1,2,2,2,2,0,1,1,0,2,1,1,1,2,1,0,1,1,0,0,1,0,1,0,0,2,0,
+0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,3,3,2,0,0,1,1,2,2,1,0,0,2,0,1,1,3,0,0,1,0,0,0,0,0,1,0,1,2,1,
+1,1,2,0,1,1,1,0,1,0,1,1,0,1,0,1,1,1,1,0,1,0,0,0,0,0,0,1,0,1,1,0,
+1,3,2,3,2,1,0,0,2,2,2,0,1,0,2,0,1,1,1,0,1,0,0,0,3,0,1,1,0,0,2,1,
+1,1,1,0,1,1,0,0,0,0,1,1,0,1,0,0,2,1,1,0,1,0,0,0,1,0,1,0,0,1,1,0,
+3,1,2,1,1,2,2,2,2,2,2,1,2,2,1,1,0,0,0,2,2,2,0,0,0,1,2,1,0,1,0,1,
+2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,2,1,1,1,0,1,0,1,1,0,1,1,1,0,0,1,
+3,0,0,0,0,2,0,1,1,1,1,1,1,1,0,1,0,0,0,1,1,1,0,1,0,1,1,0,0,1,0,1,
+1,1,0,0,1,0,0,0,1,0,1,1,0,0,1,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,1,
+1,3,3,2,2,0,0,0,2,2,0,0,0,1,2,0,1,1,2,0,0,0,0,0,0,0,0,1,0,0,2,1,
+0,1,1,0,0,1,1,0,0,0,1,1,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
+2,3,2,3,2,0,0,0,0,1,1,0,0,0,2,0,2,0,2,0,0,0,0,0,1,0,0,1,0,0,1,1,
+1,1,2,0,1,2,1,0,1,1,2,1,1,1,1,1,2,1,1,0,1,0,0,1,1,1,1,1,0,1,1,0,
+1,3,2,2,2,1,0,0,2,2,1,0,1,2,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,1,1,
+0,0,1,1,0,1,1,0,0,1,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,1,0,2,3,1,2,2,2,2,2,2,1,1,0,0,0,1,0,1,0,2,1,1,1,0,0,0,0,1,
+1,1,0,1,1,0,1,1,1,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
+2,0,2,0,0,1,0,3,2,1,2,1,2,2,0,1,0,0,0,2,1,0,0,2,1,1,1,1,0,2,0,2,
+2,1,1,1,1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,0,0,0,1,1,1,1,0,1,0,0,1,
+1,2,2,2,2,1,0,0,1,0,0,0,0,0,2,0,1,1,1,1,0,0,0,0,1,0,1,2,0,0,2,0,
+1,0,1,1,1,2,1,0,1,0,1,1,0,0,1,0,1,1,1,0,1,0,0,0,1,0,0,1,0,1,1,0,
+2,1,2,2,2,0,3,0,1,1,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+0,0,0,1,1,1,0,0,1,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,
+1,2,2,3,2,2,0,0,1,1,2,0,1,2,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1,
+0,1,1,0,0,1,1,0,0,1,1,0,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,
+2,2,1,1,2,1,2,2,2,2,2,1,2,2,0,1,0,0,0,1,2,2,2,1,2,1,1,1,1,1,2,1,
+1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,0,1,
+1,2,2,2,2,0,1,0,2,2,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,
+0,0,1,0,0,1,0,0,0,0,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,2,2,0,0,0,2,2,2,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,1,
+0,1,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,2,2,0,0,0,0,1,0,0,1,1,2,0,0,0,0,1,0,1,0,0,1,0,0,2,0,0,0,1,
+0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
+1,2,2,2,1,1,2,0,2,1,1,1,1,0,2,2,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,1,
+0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+1,0,2,1,2,0,0,0,0,0,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,
+0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
+1,0,0,0,0,2,0,1,2,1,0,1,1,1,0,1,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,1,
+0,0,0,0,0,1,0,0,1,1,0,0,1,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,
+2,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+1,0,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+1,1,1,0,1,0,1,0,0,1,1,1,1,0,0,0,1,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+1,1,0,1,1,0,1,0,1,0,0,0,0,1,1,0,1,1,0,0,0,0,0,1,0,1,1,0,1,0,0,0,
+0,1,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,
+)
+
+Koi8rModel = {
+  'char_to_order_map': KOI8R_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "KOI8-R",
+  'language': 'Russian',
+}
+
+Win1251CyrillicModel = {
+  'char_to_order_map': win1251_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "windows-1251",
+  'language': 'Russian',
+}
+
+Latin5CyrillicModel = {
+  'char_to_order_map': latin5_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "ISO-8859-5",
+  'language': 'Russian',
+}
+
+MacCyrillicModel = {
+  'char_to_order_map': macCyrillic_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "MacCyrillic",
+  'language': 'Russian',
+}
+
+Ibm866Model = {
+  'char_to_order_map': IBM866_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "IBM866",
+  'language': 'Russian',
+}
+
+Ibm855Model = {
+  'char_to_order_map': IBM855_char_to_order_map,
+  'precedence_matrix': RussianLangModel,
+  'typical_positive_ratio': 0.976601,
+  'keep_english_letter': False,
+  'charset_name': "IBM855",
+  'language': 'Russian',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langgreekmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langgreekmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..533222166cca9fce442655d9f3098126f50e6140
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langgreekmodel.py
@@ -0,0 +1,225 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# Character Mapping Table:
+Latin7_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85,  # 40
+ 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253,  # 50
+253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55,  # 60
+ 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253,  # 70
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 80
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 90
+253,233, 90,253,253,253,253,253,253,253,253,253,253, 74,253,253,  # a0
+253,253,253,253,247,248, 61, 36, 46, 71, 73,253, 54,253,108,123,  # b0
+110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39,  # c0
+ 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15,  # d0
+124,  1, 29, 20, 21,  3, 32, 13, 25,  5, 11, 16, 10,  6, 30,  4,  # e0
+  9,  8, 14,  7,  2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253,  # f0
+)
+
+win1253_char_to_order_map = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85,  # 40
+ 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253,  # 50
+253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55,  # 60
+ 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253,  # 70
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 80
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 90
+253,233, 61,253,253,253,253,253,253,253,253,253,253, 74,253,253,  # a0
+253,253,253,253,247,253,253, 36, 46, 71, 73,253, 54,253,108,123,  # b0
+110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39,  # c0
+ 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15,  # d0
+124,  1, 29, 20, 21,  3, 32, 13, 25,  5, 11, 16, 10,  6, 30,  4,  # e0
+  9,  8, 14,  7,  2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253,  # f0
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 98.2851%
+# first 1024 sequences:1.7001%
+# rest  sequences:     0.0359%
+# negative sequences:  0.0148%
+GreekLangModel = (
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,2,2,3,3,3,3,3,3,3,3,1,3,3,3,0,2,2,3,3,0,3,0,3,2,0,3,3,3,0,
+3,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,0,3,3,0,3,2,3,3,0,3,2,3,3,3,0,0,3,0,3,0,3,3,2,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
+0,2,3,2,2,3,3,3,3,3,3,3,3,0,3,3,3,3,0,2,3,3,0,3,3,3,3,2,3,3,3,0,
+2,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,2,1,3,3,3,3,2,3,3,2,3,3,2,0,
+0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,2,3,3,0,
+2,0,1,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,2,3,0,0,0,0,3,3,0,3,1,3,3,3,0,3,3,0,3,3,3,3,0,0,0,0,
+2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,0,3,0,3,3,3,3,3,0,3,2,2,2,3,0,2,3,3,3,3,3,2,3,3,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,3,2,2,2,3,3,3,3,0,3,1,3,3,3,3,2,3,3,3,3,3,3,3,2,2,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,2,0,3,0,0,0,3,3,2,3,3,3,3,3,0,0,3,2,3,0,2,3,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,3,3,3,3,0,0,3,3,0,2,3,0,3,0,3,3,3,0,0,3,0,3,0,2,2,3,3,0,0,
+0,0,1,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,2,0,3,2,3,3,3,3,0,3,3,3,3,3,0,3,3,2,3,2,3,3,2,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,2,3,2,3,3,3,3,3,3,0,2,3,2,3,2,2,2,3,2,3,3,2,3,0,2,2,2,3,0,
+2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,0,0,0,3,3,3,2,3,3,0,0,3,0,3,0,0,0,3,2,0,3,0,3,0,0,2,0,2,0,
+0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,0,0,0,3,3,0,3,3,3,0,0,1,2,3,0,
+3,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,2,0,0,3,2,2,3,3,0,3,3,3,3,3,2,1,3,0,3,2,3,3,2,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,3,0,2,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,3,0,3,2,3,0,0,3,3,3,0,
+3,0,0,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,0,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,2,0,3,2,3,0,0,3,2,3,0,
+2,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,1,2,2,3,3,3,3,3,3,0,2,3,0,3,0,0,0,3,3,0,3,0,2,0,0,2,3,1,0,
+2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,3,3,3,3,0,3,0,3,3,2,3,0,3,3,3,3,3,3,0,3,3,3,0,2,3,0,0,3,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,3,3,3,0,0,3,0,0,0,3,3,0,3,0,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,0,0,0,3,3,3,3,3,3,0,0,3,0,2,0,0,0,3,3,0,3,0,3,0,0,2,0,2,0,
+0,0,0,0,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,3,0,3,0,2,0,3,2,0,3,2,3,2,3,0,0,3,2,3,2,3,3,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,0,0,2,3,3,3,3,3,0,0,0,3,0,2,1,0,0,3,2,2,2,0,3,0,0,2,2,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,3,3,3,2,0,3,0,3,0,3,3,0,2,1,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,3,3,3,0,3,3,3,3,3,3,0,2,3,0,3,0,0,0,2,1,0,2,2,3,0,0,2,2,2,0,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,3,0,0,2,3,3,3,2,3,0,0,1,3,0,2,0,0,0,0,3,0,1,0,2,0,0,1,1,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,3,1,0,3,0,0,0,3,2,0,3,2,3,3,3,0,0,3,0,3,2,2,2,1,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,3,3,3,0,0,3,0,0,0,0,2,0,2,3,3,2,2,2,2,3,0,2,0,2,2,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,3,3,3,2,0,0,0,0,0,0,2,3,0,2,0,2,3,2,0,0,3,0,3,0,3,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,3,2,3,3,2,2,3,0,2,0,3,0,0,0,2,0,0,0,0,1,2,0,2,0,2,0,
+0,2,0,2,0,2,2,0,0,1,0,2,2,2,0,2,2,2,0,2,2,2,0,0,2,0,0,1,0,0,0,0,
+0,2,0,3,3,2,0,0,0,0,0,0,1,3,0,2,0,2,2,2,0,0,2,0,3,0,0,2,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,0,2,3,2,0,2,2,0,2,0,2,2,0,2,0,2,2,2,0,0,0,0,0,0,2,3,0,0,0,2,
+0,1,2,0,0,0,0,2,2,0,0,0,2,1,0,2,2,0,0,0,0,0,0,1,0,2,0,0,0,0,0,0,
+0,0,2,1,0,2,3,2,2,3,2,3,2,0,0,3,3,3,0,0,3,2,0,0,0,1,1,0,2,0,2,2,
+0,2,0,2,0,2,2,0,0,2,0,2,2,2,0,2,2,2,2,0,0,2,0,0,0,2,0,1,0,0,0,0,
+0,3,0,3,3,2,2,0,3,0,0,0,2,2,0,2,2,2,1,2,0,0,1,2,2,0,0,3,0,0,0,2,
+0,1,2,0,0,0,1,2,0,0,0,0,0,0,0,2,2,0,1,0,0,2,0,0,0,2,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,3,3,2,2,0,0,0,2,0,2,3,3,0,2,0,0,0,0,0,0,2,2,2,0,2,2,0,2,0,2,
+0,2,2,0,0,2,2,2,2,1,0,0,2,2,0,2,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,
+0,2,0,3,2,3,0,0,0,3,0,0,2,2,0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,0,2,
+0,0,2,2,0,0,2,2,2,0,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,2,0,0,3,2,0,2,2,2,2,2,0,0,0,2,0,0,0,0,2,0,1,0,0,2,0,1,0,0,0,
+0,2,2,2,0,2,2,0,1,2,0,2,2,2,0,2,2,2,2,1,2,2,0,0,2,0,0,0,0,0,0,0,
+0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+0,2,0,2,0,2,2,0,0,0,0,1,2,1,0,0,2,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,3,2,3,0,0,2,0,0,0,2,2,0,2,0,0,0,1,0,0,2,0,2,0,2,2,0,0,0,0,
+0,0,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,
+0,2,2,3,2,2,0,0,0,0,0,0,1,3,0,2,0,2,2,0,0,0,1,0,2,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,0,2,0,3,2,0,2,0,0,0,0,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+0,0,2,0,0,0,0,1,1,0,0,2,1,2,0,2,2,0,1,0,0,1,0,0,0,2,0,0,0,0,0,0,
+0,3,0,2,2,2,0,0,2,0,0,0,2,0,0,0,2,3,0,2,0,0,0,0,0,0,2,2,0,0,0,2,
+0,1,2,0,0,0,1,2,2,1,0,0,0,2,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,1,2,0,2,2,0,2,0,0,2,0,0,0,0,1,2,1,0,2,1,0,0,0,0,0,0,0,0,0,0,
+0,0,2,0,0,0,3,1,2,2,0,2,0,0,0,0,2,0,0,0,2,0,0,3,0,0,0,0,2,2,2,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,1,0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,2,
+0,2,2,0,0,2,2,2,2,2,0,1,2,0,0,0,2,2,0,1,0,2,0,0,2,2,0,0,0,0,0,0,
+0,0,0,0,1,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,0,0,0,0,2,0,2,0,0,0,0,2,
+0,1,2,0,0,0,0,2,2,1,0,1,0,1,0,2,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0,
+0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,2,0,0,2,2,0,0,0,0,1,0,0,0,0,0,0,2,
+0,2,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,
+0,2,2,2,2,0,0,0,3,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,1,
+0,0,2,0,0,0,0,1,2,0,0,0,0,0,0,2,2,1,1,0,0,0,0,0,0,1,0,0,0,0,0,0,
+0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,2,2,2,0,0,0,2,0,0,0,0,0,0,0,0,2,
+0,0,1,0,0,0,0,2,1,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
+0,3,0,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,2,
+0,0,2,0,0,0,0,2,2,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,2,0,2,2,1,0,0,0,0,0,0,2,0,0,2,0,2,2,2,0,0,0,0,0,0,2,0,0,0,0,2,
+0,0,2,0,0,2,0,2,2,0,0,0,0,2,0,2,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0,
+0,0,3,0,0,0,2,2,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,0,0,
+0,2,2,2,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,
+0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+0,2,0,0,0,2,0,0,0,0,0,1,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,2,0,0,0,
+0,2,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,2,0,2,0,0,0,
+0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+)
+
+Latin7GreekModel = {
+  'char_to_order_map': Latin7_char_to_order_map,
+  'precedence_matrix': GreekLangModel,
+  'typical_positive_ratio': 0.982851,
+  'keep_english_letter': False,
+  'charset_name': "ISO-8859-7",
+  'language': 'Greek',
+}
+
+Win1253GreekModel = {
+  'char_to_order_map': win1253_char_to_order_map,
+  'precedence_matrix': GreekLangModel,
+  'typical_positive_ratio': 0.982851,
+  'keep_english_letter': False,
+  'charset_name': "windows-1253",
+  'language': 'Greek',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhebrewmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhebrewmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..58f4c875ec926b85256fd3866369fc8a81a14350
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhebrewmodel.py
@@ -0,0 +1,200 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+#          Simon Montagu
+# Portions created by the Initial Developer are Copyright (C) 2005
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#   Shoshannah Forbes - original C code (?)
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# Windows-1255 language model
+# Character Mapping Table:
+WIN1255_CHAR_TO_ORDER_MAP = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 69, 91, 79, 80, 92, 89, 97, 90, 68,111,112, 82, 73, 95, 85,  # 40
+ 78,121, 86, 71, 67,102,107, 84,114,103,115,253,253,253,253,253,  # 50
+253, 50, 74, 60, 61, 42, 76, 70, 64, 53,105, 93, 56, 65, 54, 49,  # 60
+ 66,110, 51, 43, 44, 63, 81, 77, 98, 75,108,253,253,253,253,253,  # 70
+124,202,203,204,205, 40, 58,206,207,208,209,210,211,212,213,214,
+215, 83, 52, 47, 46, 72, 32, 94,216,113,217,109,218,219,220,221,
+ 34,116,222,118,100,223,224,117,119,104,125,225,226, 87, 99,227,
+106,122,123,228, 55,229,230,101,231,232,120,233, 48, 39, 57,234,
+ 30, 59, 41, 88, 33, 37, 36, 31, 29, 35,235, 62, 28,236,126,237,
+238, 38, 45,239,240,241,242,243,127,244,245,246,247,248,249,250,
+  9,  8, 20, 16,  3,  2, 24, 14, 22,  1, 25, 15,  4, 11,  6, 23,
+ 12, 19, 13, 26, 18, 27, 21, 17,  7, 10,  5,251,252,128, 96,253,
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 98.4004%
+# first 1024 sequences: 1.5981%
+# rest  sequences:      0.087%
+# negative sequences:   0.0015%
+HEBREW_LANG_MODEL = (
+0,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,3,2,1,2,0,1,0,0,
+3,0,3,1,0,0,1,3,2,0,1,1,2,0,2,2,2,1,1,1,1,2,1,1,1,2,0,0,2,2,0,1,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,
+1,2,1,2,1,2,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,
+1,2,1,3,1,1,0,0,2,0,0,0,1,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,1,2,2,1,3,
+1,2,1,1,2,2,0,0,2,2,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,1,0,1,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,2,2,2,3,2,
+1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,3,2,2,3,2,2,2,1,2,2,2,2,
+1,2,1,1,2,2,0,1,2,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,0,2,2,2,2,2,
+0,2,0,2,2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,0,2,2,2,
+0,2,1,2,2,2,0,0,2,1,0,0,0,0,1,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,2,1,2,3,2,2,2,
+1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,0,
+3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,2,0,2,
+0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,2,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,2,2,3,2,1,2,1,1,1,
+0,1,1,1,1,1,3,0,1,0,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,1,1,0,0,1,0,0,1,0,0,0,0,
+0,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2,
+0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,2,3,3,3,2,1,2,3,3,2,3,3,3,3,2,3,2,1,2,0,2,1,2,
+0,2,0,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,
+3,3,3,3,3,3,3,3,3,2,3,3,3,1,2,2,3,3,2,3,2,3,2,2,3,1,2,2,0,2,2,2,
+0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,1,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,2,2,3,3,3,3,1,3,2,2,2,
+0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,2,3,2,2,2,1,2,2,0,2,2,2,2,
+0,2,0,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,1,3,2,3,3,2,3,3,2,2,1,2,2,2,2,2,2,
+0,2,1,2,1,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,2,3,2,3,3,2,3,3,3,3,2,3,2,3,3,3,3,3,2,2,2,2,2,2,2,1,
+0,2,0,1,2,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,2,1,2,3,3,3,3,3,3,3,2,3,2,3,2,1,2,3,0,2,1,2,2,
+0,2,1,1,2,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,2,0,
+3,3,3,3,3,3,3,3,3,2,3,3,3,3,2,1,3,1,2,2,2,1,2,3,3,1,2,1,2,2,2,2,
+0,1,1,1,1,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,0,2,3,3,3,1,3,3,3,1,2,2,2,2,1,1,2,2,2,2,2,2,
+0,2,0,1,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,2,3,3,3,2,2,3,3,3,2,1,2,3,2,3,2,2,2,2,1,2,1,1,1,2,2,
+0,2,1,1,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,1,0,0,0,0,0,
+1,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,2,3,3,2,3,1,2,2,2,2,3,2,3,1,1,2,2,1,2,2,1,1,0,2,2,2,2,
+0,1,0,1,2,2,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
+3,0,0,1,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,2,2,0,
+0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,1,0,1,0,1,1,0,1,1,0,0,0,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,0,0,1,1,0,1,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+3,2,2,1,2,2,2,2,2,2,2,1,2,2,1,2,2,1,1,1,1,1,1,1,1,2,1,1,0,3,3,3,
+0,3,0,2,2,2,2,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+2,2,2,3,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,2,1,2,2,2,1,1,1,2,0,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,2,2,2,2,2,2,0,2,2,0,0,0,0,0,0,
+0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,1,0,2,1,0,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,1,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+0,3,1,1,2,2,2,2,2,1,2,2,2,1,1,2,2,2,2,2,2,2,1,2,2,1,0,1,1,1,1,0,
+0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,2,1,1,1,1,2,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0,
+0,0,2,0,0,0,0,0,0,0,0,1,1,0,0,0,0,1,1,0,0,1,1,0,0,0,0,0,0,1,0,0,
+2,1,1,2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,1,2,1,2,1,1,1,1,0,0,0,0,
+0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,2,1,2,2,2,2,2,2,2,2,2,2,1,2,1,2,1,1,2,1,1,1,2,1,2,1,2,0,1,0,1,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,3,1,2,2,2,1,2,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,2,1,2,1,1,0,1,0,1,
+0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,1,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,2,2,
+0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,1,1,1,1,1,1,1,0,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,2,0,1,1,1,0,1,0,0,0,1,1,0,1,1,0,0,0,0,0,1,1,0,0,
+0,1,1,1,2,1,2,2,2,0,2,0,2,0,1,1,2,1,1,1,1,2,1,0,1,1,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,1,0,0,0,0,0,1,0,1,2,2,0,1,0,0,1,1,2,2,1,2,0,2,0,0,0,1,2,0,1,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,2,0,2,1,2,0,2,0,0,1,1,1,1,1,1,0,1,0,0,0,1,0,0,1,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,1,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,1,2,2,0,0,1,0,0,0,1,0,0,1,
+1,1,2,1,0,1,1,1,0,1,0,1,1,1,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,2,1,
+0,2,0,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,1,0,0,1,0,1,1,1,1,0,0,0,0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,1,0,0,0,1,1,0,1,
+2,0,1,0,1,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,1,1,1,0,1,0,0,1,1,2,1,1,2,0,1,0,0,0,1,1,0,1,
+1,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,0,0,2,1,1,2,0,2,0,0,0,1,1,0,1,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,2,2,1,2,1,1,0,1,0,0,0,1,1,0,1,
+2,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,1,0,1,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,2,1,1,1,0,2,1,1,0,0,0,2,1,0,1,
+1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,0,2,1,1,0,1,0,0,0,1,1,0,1,
+2,2,1,1,1,0,1,1,0,1,1,0,1,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,0,1,2,1,0,2,0,0,0,1,1,0,1,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,
+0,1,0,0,2,0,2,1,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,1,0,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,1,0,1,0,0,1,0,0,0,1,0,0,1,
+1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,0,0,0,0,0,1,0,1,1,0,0,1,0,0,2,1,1,1,1,1,0,1,0,0,0,0,1,0,1,
+0,1,1,1,2,1,1,1,1,0,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,1,2,1,0,0,0,0,0,1,1,1,1,1,0,1,0,0,0,1,1,0,0,
+)
+
+Win1255HebrewModel = {
+  'char_to_order_map': WIN1255_CHAR_TO_ORDER_MAP,
+  'precedence_matrix': HEBREW_LANG_MODEL,
+  'typical_positive_ratio': 0.984004,
+  'keep_english_letter': False,
+  'charset_name': "windows-1255",
+  'language': 'Hebrew',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhungarianmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhungarianmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb7c095e1ea6523bd00365384e4c662954c678a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langhungarianmodel.py
@@ -0,0 +1,225 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# Character Mapping Table:
+Latin2_HungarianCharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47,
+ 46, 71, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253,
+253,  2, 18, 26, 17,  1, 27, 12, 20,  9, 22,  7,  6, 13,  4,  8,
+ 23, 67, 10,  5,  3, 21, 19, 65, 62, 16, 11,253,253,253,253,253,
+159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,
+175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,
+191,192,193,194,195,196,197, 75,198,199,200,201,202,203,204,205,
+ 79,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,
+221, 51, 81,222, 78,223,224,225,226, 44,227,228,229, 61,230,231,
+232,233,234, 58,235, 66, 59,236,237,238, 60, 69, 63,239,240,241,
+ 82, 14, 74,242, 70, 80,243, 72,244, 15, 83, 77, 84, 30, 76, 85,
+245,246,247, 25, 73, 42, 24,248,249,250, 31, 56, 29,251,252,253,
+)
+
+win1250HungarianCharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47,
+ 46, 72, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253,
+253,  2, 18, 26, 17,  1, 27, 12, 20,  9, 22,  7,  6, 13,  4,  8,
+ 23, 67, 10,  5,  3, 21, 19, 65, 62, 16, 11,253,253,253,253,253,
+161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,
+177,178,179,180, 78,181, 69,182,183,184,185,186,187,188,189,190,
+191,192,193,194,195,196,197, 76,198,199,200,201,202,203,204,205,
+ 81,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,
+221, 51, 83,222, 80,223,224,225,226, 44,227,228,229, 61,230,231,
+232,233,234, 58,235, 66, 59,236,237,238, 60, 70, 63,239,240,241,
+ 84, 14, 75,242, 71, 82,243, 73,244, 15, 85, 79, 86, 30, 77, 87,
+245,246,247, 25, 74, 42, 24,248,249,250, 31, 56, 29,251,252,253,
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 94.7368%
+# first 1024 sequences:5.2623%
+# rest  sequences:     0.8894%
+# negative sequences:  0.0009%
+HungarianLangModel = (
+0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
+3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,2,3,3,1,1,2,2,2,2,2,1,2,
+3,2,2,3,3,3,3,3,2,3,3,3,3,3,3,1,2,3,3,3,3,2,3,3,1,1,3,3,0,1,1,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,
+3,2,1,3,3,3,3,3,2,3,3,3,3,3,1,1,2,3,3,3,3,3,3,3,1,1,3,2,0,1,1,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,1,1,2,3,3,3,1,3,3,3,3,3,1,3,3,2,2,0,3,2,3,
+0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,3,3,2,3,3,2,2,3,2,3,2,0,3,2,2,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,
+3,3,3,3,3,3,2,3,3,3,3,3,2,3,3,3,1,2,3,2,2,3,1,2,3,3,2,2,0,3,3,3,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,3,2,3,3,3,3,2,3,3,3,3,0,2,3,2,
+0,0,0,1,1,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,1,1,1,3,3,2,1,3,2,2,3,2,1,3,2,2,1,0,3,3,1,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,2,2,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,3,2,2,3,1,1,3,2,0,1,1,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,1,3,3,3,3,3,2,2,1,3,3,3,0,1,1,2,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,2,0,3,2,3,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,1,0,
+3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,1,3,2,2,2,3,1,1,3,3,1,1,0,3,3,2,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,2,3,3,3,3,3,1,2,3,2,2,0,2,2,2,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,2,2,2,3,1,3,3,2,2,1,3,3,3,1,1,3,1,2,3,2,3,2,2,2,1,0,2,2,2,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
+3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,2,2,3,2,1,0,3,2,0,1,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,1,0,3,3,3,3,0,2,3,0,0,2,1,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,2,2,3,3,2,2,2,2,3,3,0,1,2,3,2,3,2,2,3,2,1,2,0,2,2,2,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
+3,3,3,3,3,3,1,2,3,3,3,2,1,2,3,3,2,2,2,3,2,3,3,1,3,3,1,1,0,2,3,2,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,1,2,2,2,2,3,3,3,1,1,1,3,3,1,1,3,1,1,3,2,1,2,3,1,1,0,2,2,2,
+0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,2,1,2,1,1,3,3,1,1,1,1,3,3,1,1,2,2,1,2,1,1,2,2,1,1,0,2,2,1,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,1,1,2,1,1,3,3,1,0,1,1,3,3,2,0,1,1,2,3,1,0,2,2,1,0,0,1,3,2,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,2,1,3,3,3,3,3,1,2,3,2,3,3,2,1,1,3,2,3,2,1,2,2,0,1,2,1,0,0,1,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,3,3,2,2,2,2,3,1,2,2,1,1,3,3,0,3,2,1,2,3,2,1,3,3,1,1,0,2,1,3,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,3,3,2,2,2,3,2,3,3,3,2,1,1,3,3,1,1,1,2,2,3,2,3,2,2,2,1,0,2,2,1,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+1,0,0,3,3,3,3,3,0,0,3,3,2,3,0,0,0,2,3,3,1,0,1,2,0,0,1,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,2,3,3,3,3,3,1,2,3,3,2,2,1,1,0,3,3,2,2,1,2,2,1,0,2,2,0,1,1,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,2,2,1,3,1,2,3,3,2,2,1,1,2,2,1,1,1,1,3,2,1,1,1,1,2,1,0,1,2,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+2,3,3,1,1,1,1,1,3,3,3,0,1,1,3,3,1,1,1,1,1,2,2,0,3,1,1,2,0,2,1,1,
+0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
+3,1,0,1,2,1,2,2,0,1,2,3,1,2,0,0,0,2,1,1,1,1,1,2,0,0,1,1,0,0,0,0,
+1,2,1,2,2,2,1,2,1,2,0,2,0,2,2,1,1,2,1,1,2,1,1,1,0,1,0,0,0,1,1,0,
+1,1,1,2,3,2,3,3,0,1,2,2,3,1,0,1,0,2,1,2,2,0,1,1,0,0,1,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,3,3,2,2,1,0,0,3,2,3,2,0,0,0,1,1,3,0,0,1,1,0,0,2,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,1,2,2,3,3,1,0,1,3,2,3,1,1,1,0,1,1,1,1,1,3,1,0,0,2,2,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,1,1,2,2,2,1,0,1,2,3,3,2,0,0,0,2,1,1,1,2,1,1,1,0,1,1,1,0,0,0,
+1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,2,1,1,1,1,1,1,0,1,1,1,0,0,1,1,
+3,2,2,1,0,0,1,1,2,2,0,3,0,1,2,1,1,0,0,1,1,1,0,1,1,1,1,0,2,1,1,1,
+2,2,1,1,1,2,1,2,1,1,1,1,1,1,1,2,1,1,1,2,3,1,1,1,1,1,1,1,1,1,0,1,
+2,3,3,0,1,0,0,0,3,3,1,0,0,1,2,2,1,0,0,0,0,2,0,0,1,1,1,0,2,1,1,1,
+2,1,1,1,1,1,1,2,1,1,0,1,1,0,1,1,1,0,1,2,1,1,0,1,1,1,1,1,1,1,0,1,
+2,3,3,0,1,0,0,0,2,2,0,0,0,0,1,2,2,0,0,0,0,1,0,0,1,1,0,0,2,0,1,0,
+2,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1,
+3,2,2,0,1,0,1,0,2,3,2,0,0,1,2,2,1,0,0,1,1,1,0,0,2,1,0,1,2,2,1,1,
+2,1,1,1,1,1,1,2,1,1,1,1,1,1,0,2,1,0,1,1,0,1,1,1,0,1,1,2,1,1,0,1,
+2,2,2,0,0,1,0,0,2,2,1,1,0,0,2,1,1,0,0,0,1,2,0,0,2,1,0,0,2,1,1,1,
+2,1,1,1,1,2,1,2,1,1,1,2,2,1,1,2,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1,
+1,2,3,0,0,0,1,0,3,2,1,0,0,1,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,2,1,
+1,1,0,0,0,1,0,1,1,1,1,1,2,0,0,1,0,0,0,2,0,0,1,1,1,1,1,1,1,1,0,1,
+3,0,0,2,1,2,2,1,0,0,2,1,2,2,0,0,0,2,1,1,1,0,1,1,0,0,1,1,2,0,0,0,
+1,2,1,2,2,1,1,2,1,2,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,0,0,1,
+1,3,2,0,0,0,1,0,2,2,2,0,0,0,2,2,1,0,0,0,0,3,1,1,1,1,0,0,2,1,1,1,
+2,1,0,1,1,1,0,1,1,1,1,1,1,1,0,2,1,0,0,1,0,1,1,0,1,1,1,1,1,1,0,1,
+2,3,2,0,0,0,1,0,2,2,0,0,0,0,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,1,0,
+2,1,1,1,1,2,1,2,1,2,0,1,1,1,0,2,1,1,1,2,1,1,1,1,0,1,1,1,1,1,0,1,
+3,1,1,2,2,2,3,2,1,1,2,2,1,1,0,1,0,2,2,1,1,1,1,1,0,0,1,1,0,1,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,0,0,0,0,0,2,2,0,0,0,0,2,2,1,0,0,0,1,1,0,0,1,2,0,0,2,1,1,1,
+2,2,1,1,1,2,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,1,1,0,1,2,1,1,1,0,1,
+1,0,0,1,2,3,2,1,0,0,2,0,1,1,0,0,0,1,1,1,1,0,1,1,0,0,1,0,0,0,0,0,
+1,2,1,2,1,2,1,1,1,2,0,2,1,1,1,0,1,2,0,0,1,1,1,0,0,0,0,0,0,0,0,0,
+2,3,2,0,0,0,0,0,1,1,2,1,0,0,1,1,1,0,0,0,0,2,0,0,1,1,0,0,2,1,1,1,
+2,1,1,1,1,1,1,2,1,0,1,1,1,1,0,2,1,1,1,1,1,1,0,1,0,1,1,1,1,1,0,1,
+1,2,2,0,1,1,1,0,2,2,2,0,0,0,3,2,1,0,0,0,1,1,0,0,1,1,0,1,1,1,0,0,
+1,1,0,1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,0,0,1,1,1,0,1,0,1,
+2,1,0,2,1,1,2,2,1,1,2,1,1,1,0,0,0,1,1,0,1,1,1,1,0,0,1,1,1,0,0,0,
+1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,1,0,
+1,2,3,0,0,0,1,0,2,2,0,0,0,0,2,2,0,0,0,0,0,1,0,0,1,0,0,0,2,0,1,0,
+2,1,1,1,1,1,0,2,0,0,0,1,2,1,1,1,1,0,1,2,0,1,0,1,0,1,1,1,0,1,0,1,
+2,2,2,0,0,0,1,0,2,1,2,0,0,0,1,1,2,0,0,0,0,1,0,0,1,1,0,0,2,1,0,1,
+2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1,
+1,2,2,0,0,0,1,0,2,2,2,0,0,0,1,1,0,0,0,0,0,1,1,0,2,0,0,1,1,1,0,1,
+1,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,0,0,1,1,0,1,0,1,1,1,1,1,0,0,0,1,
+1,0,0,1,0,1,2,1,0,0,1,1,1,2,0,0,0,1,1,0,1,0,1,1,0,0,1,0,0,0,0,0,
+0,2,1,2,1,1,1,1,1,2,0,2,0,1,1,0,1,2,1,0,1,1,1,0,0,0,0,0,0,1,0,0,
+2,1,1,0,1,2,0,0,1,1,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,2,1,0,1,
+2,2,1,1,1,1,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,0,1,0,1,1,1,1,1,0,1,
+1,2,2,0,0,0,0,0,1,1,0,0,0,0,2,1,0,0,0,0,0,2,0,0,2,2,0,0,2,0,0,1,
+2,1,1,1,1,1,1,1,0,1,1,0,1,1,0,1,0,0,0,1,1,1,1,0,0,1,1,1,1,0,0,1,
+1,1,2,0,0,3,1,0,2,1,1,1,0,0,1,1,1,0,0,0,1,1,0,0,0,1,0,0,1,0,1,0,
+1,2,1,0,1,1,1,2,1,1,0,1,1,1,1,1,0,0,0,1,1,1,1,1,0,1,0,0,0,1,0,0,
+2,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,2,0,0,0,
+2,1,1,1,1,1,1,1,1,1,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,1,0,1,
+2,1,1,1,2,1,1,1,0,1,1,2,1,0,0,0,0,1,1,1,1,0,1,0,0,0,0,1,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,1,0,1,1,1,1,1,0,0,1,1,2,1,0,0,0,1,1,0,0,0,1,1,0,0,1,0,1,0,0,0,
+1,2,1,1,1,1,1,1,1,1,0,1,0,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0,
+2,0,0,0,1,1,1,1,0,0,1,1,0,0,0,0,0,1,1,1,2,0,0,1,0,0,1,0,1,0,0,0,
+0,1,1,1,1,1,1,1,1,2,0,1,1,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
+1,0,0,1,1,1,1,1,0,0,2,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,
+0,1,1,1,1,1,1,0,1,1,0,1,0,1,1,0,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0,0,
+1,0,0,1,1,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+0,1,1,1,1,1,0,0,1,1,0,1,0,1,0,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
+0,0,0,1,0,0,0,0,0,0,1,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,1,1,1,0,1,0,0,1,1,0,1,0,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
+2,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,0,1,0,0,1,0,1,0,1,1,1,0,0,1,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,0,1,1,1,1,0,0,0,1,1,1,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,
+0,1,1,1,1,1,1,0,1,1,0,1,0,1,0,0,1,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
+)
+
+Latin2HungarianModel = {
+  'char_to_order_map': Latin2_HungarianCharToOrderMap,
+  'precedence_matrix': HungarianLangModel,
+  'typical_positive_ratio': 0.947368,
+  'keep_english_letter': True,
+  'charset_name': "ISO-8859-2",
+  'language': 'Hungarian',
+}
+
+Win1250HungarianModel = {
+  'char_to_order_map': win1250HungarianCharToOrderMap,
+  'precedence_matrix': HungarianLangModel,
+  'typical_positive_ratio': 0.947368,
+  'keep_english_letter': True,
+  'charset_name': "windows-1250",
+  'language': 'Hungarian',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langthaimodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langthaimodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..15f94c2df021c9cccc761ebeec80146edbb000c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langthaimodel.py
@@ -0,0 +1,199 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# The following result for thai was collected from a limited sample (1M).
+
+# Character Mapping Table:
+TIS620CharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
+253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
+252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
+253,182,106,107,100,183,184,185,101, 94,186,187,108,109,110,111,  # 40
+188,189,190, 89, 95,112,113,191,192,193,194,253,253,253,253,253,  # 50
+253, 64, 72, 73,114, 74,115,116,102, 81,201,117, 90,103, 78, 82,  # 60
+ 96,202, 91, 79, 84,104,105, 97, 98, 92,203,253,253,253,253,253,  # 70
+209,210,211,212,213, 88,214,215,216,217,218,219,220,118,221,222,
+223,224, 99, 85, 83,225,226,227,228,229,230,231,232,233,234,235,
+236,  5, 30,237, 24,238, 75,  8, 26, 52, 34, 51,119, 47, 58, 57,
+ 49, 53, 55, 43, 20, 19, 44, 14, 48,  3, 17, 25, 39, 62, 31, 54,
+ 45,  9, 16,  2, 61, 15,239, 12, 42, 46, 18, 21, 76,  4, 66, 63,
+ 22, 10,  1, 36, 23, 13, 40, 27, 32, 35, 86,240,241,242,243,244,
+ 11, 28, 41, 29, 33,245, 50, 37,  6,  7, 67, 77, 38, 93,246,247,
+ 68, 56, 59, 65, 69, 60, 70, 80, 71, 87,248,249,250,251,252,253,
+)
+
+# Model Table:
+# total sequences: 100%
+# first 512 sequences: 92.6386%
+# first 1024 sequences:7.3177%
+# rest  sequences:     1.0230%
+# negative sequences:  0.0436%
+ThaiLangModel = (
+0,1,3,3,3,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,0,0,3,3,3,0,3,3,3,3,
+0,3,3,0,0,0,1,3,0,3,3,2,3,3,0,1,2,3,3,3,3,0,2,0,2,0,0,3,2,1,2,2,
+3,0,3,3,2,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,0,3,2,3,0,2,2,2,3,
+0,2,3,0,0,0,0,1,0,1,2,3,1,1,3,2,2,0,1,1,0,0,1,0,0,0,0,0,0,0,1,1,
+3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2,3,3,2,3,2,3,3,2,2,2,
+3,1,2,3,0,3,3,2,2,1,2,3,3,1,2,0,1,3,0,1,0,0,1,0,0,0,0,0,0,0,1,1,
+3,3,2,2,3,3,3,3,1,2,3,3,3,3,3,2,2,2,2,3,3,2,2,3,3,2,2,3,2,3,2,2,
+3,3,1,2,3,1,2,2,3,3,1,0,2,1,0,0,3,1,2,1,0,0,1,0,0,0,0,0,0,1,0,1,
+3,3,3,3,3,3,2,2,3,3,3,3,2,3,2,2,3,3,2,2,3,2,2,2,2,1,1,3,1,2,1,1,
+3,2,1,0,2,1,0,1,0,1,1,0,1,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,
+3,3,3,2,3,2,3,3,2,2,3,2,3,3,2,3,1,1,2,3,2,2,2,3,2,2,2,2,2,1,2,1,
+2,2,1,1,3,3,2,1,0,1,2,2,0,1,3,0,0,0,1,1,0,0,0,0,0,2,3,0,0,2,1,1,
+3,3,2,3,3,2,0,0,3,3,0,3,3,0,2,2,3,1,2,2,1,1,1,0,2,2,2,0,2,2,1,1,
+0,2,1,0,2,0,0,2,0,1,0,0,1,0,0,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0,1,0,
+3,3,2,3,3,2,0,0,3,3,0,2,3,0,2,1,2,2,2,2,1,2,0,0,2,2,2,0,2,2,1,1,
+0,2,1,0,2,0,0,2,0,1,1,0,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,
+3,3,2,3,2,3,2,0,2,2,1,3,2,1,3,2,1,2,3,2,2,3,0,2,3,2,2,1,2,2,2,2,
+1,2,2,0,0,0,0,2,0,1,2,0,1,1,1,0,1,0,3,1,1,0,0,0,0,0,0,0,0,0,1,0,
+3,3,2,3,3,2,3,2,2,2,3,2,2,3,2,2,1,2,3,2,2,3,1,3,2,2,2,3,2,2,2,3,
+3,2,1,3,0,1,1,1,0,2,1,1,1,1,1,0,1,0,1,1,0,0,0,0,0,0,0,0,0,2,0,0,
+1,0,0,3,0,3,3,3,3,3,0,0,3,0,2,2,3,3,3,3,3,0,0,0,1,1,3,0,0,0,0,2,
+0,0,1,0,0,0,0,0,0,0,2,3,0,0,0,3,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
+2,0,3,3,3,3,0,0,2,3,0,0,3,0,3,3,2,3,3,3,3,3,0,0,3,3,3,0,0,0,3,3,
+0,0,3,0,0,0,0,2,0,0,2,1,1,3,0,0,1,0,0,2,3,0,1,0,0,0,0,0,0,0,1,0,
+3,3,3,3,2,3,3,3,3,3,3,3,1,2,1,3,3,2,2,1,2,2,2,3,1,1,2,0,2,1,2,1,
+2,2,1,0,0,0,1,1,0,1,0,1,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,
+3,0,2,1,2,3,3,3,0,2,0,2,2,0,2,1,3,2,2,1,2,1,0,0,2,2,1,0,2,1,2,2,
+0,1,1,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,2,1,3,3,1,1,3,0,2,3,1,1,3,2,1,1,2,0,2,2,3,2,1,1,1,1,1,2,
+3,0,0,1,3,1,2,1,2,0,3,0,0,0,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,
+3,3,1,1,3,2,3,3,3,1,3,2,1,3,2,1,3,2,2,2,2,1,3,3,1,2,1,3,1,2,3,0,
+2,1,1,3,2,2,2,1,2,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,
+3,3,2,3,2,3,3,2,3,2,3,2,3,3,2,1,0,3,2,2,2,1,2,2,2,1,2,2,1,2,1,1,
+2,2,2,3,0,1,3,1,1,1,1,0,1,1,0,2,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,2,3,2,2,1,1,3,2,3,2,3,2,0,3,2,2,1,2,0,2,2,2,1,2,2,2,2,1,
+3,2,1,2,2,1,0,2,0,1,0,0,1,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,1,
+3,3,3,3,3,2,3,1,2,3,3,2,2,3,0,1,1,2,0,3,3,2,2,3,0,1,1,3,0,0,0,0,
+3,1,0,3,3,0,2,0,2,1,0,0,3,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,2,3,2,3,3,0,1,3,1,1,2,1,2,1,1,3,1,1,0,2,3,1,1,1,1,1,1,1,1,
+3,1,1,2,2,2,2,1,1,1,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,2,2,1,1,2,1,3,3,2,3,2,2,3,2,2,3,1,2,2,1,2,0,3,2,1,2,2,2,2,2,1,
+3,2,1,2,2,2,1,1,1,1,0,0,1,1,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,1,3,3,0,2,1,0,3,2,0,0,3,1,0,1,1,0,1,0,0,0,0,0,1,
+1,0,0,1,0,3,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,2,2,2,3,0,0,1,3,0,3,2,0,3,2,2,3,3,3,3,3,1,0,2,2,2,0,2,2,1,2,
+0,2,3,0,0,0,0,1,0,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+3,0,2,3,1,3,3,2,3,3,0,3,3,0,3,2,2,3,2,3,3,3,0,0,2,2,3,0,1,1,1,3,
+0,0,3,0,0,0,2,2,0,1,3,0,1,2,2,2,3,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,
+3,2,3,3,2,0,3,3,2,2,3,1,3,2,1,3,2,0,1,2,2,0,2,3,2,1,0,3,0,0,0,0,
+3,0,0,2,3,1,3,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,1,3,2,2,2,1,2,0,1,3,1,1,3,1,3,0,0,2,1,1,1,1,2,1,1,1,0,2,1,0,1,
+1,2,0,0,0,3,1,1,0,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,0,3,1,0,0,0,1,0,
+3,3,3,3,2,2,2,2,2,1,3,1,1,1,2,0,1,1,2,1,2,1,3,2,0,0,3,1,1,1,1,1,
+3,1,0,2,3,0,0,0,3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,2,3,0,3,3,0,2,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,2,3,1,3,0,0,1,2,0,0,2,0,3,3,2,3,3,3,2,3,0,0,2,2,2,0,0,0,2,2,
+0,0,1,0,0,0,0,3,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+0,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,1,2,3,1,3,3,0,0,1,0,3,0,0,0,0,0,
+0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,1,2,3,1,2,3,1,0,3,0,2,2,1,0,2,1,1,2,0,1,0,0,1,1,1,1,0,1,0,0,
+1,0,0,0,0,1,1,0,3,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,2,1,0,1,1,1,3,1,2,2,2,2,2,2,1,1,1,1,0,3,1,0,1,3,1,1,1,1,
+1,1,0,2,0,1,3,1,1,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,1,
+3,0,2,2,1,3,3,2,3,3,0,1,1,0,2,2,1,2,1,3,3,1,0,0,3,2,0,0,0,0,2,1,
+0,1,0,0,0,0,1,2,0,1,1,3,1,1,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
+0,0,3,0,0,1,0,0,0,3,0,0,3,0,3,1,0,1,1,1,3,2,0,0,0,3,0,0,0,0,2,0,
+0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
+3,3,1,3,2,1,3,3,1,2,2,0,1,2,1,0,1,2,0,0,0,0,0,3,0,0,0,3,0,0,0,0,
+3,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,1,2,0,3,3,3,2,2,0,1,1,0,1,3,0,0,0,2,2,0,0,0,0,3,1,0,1,0,0,0,
+0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,2,3,1,2,0,0,2,1,0,3,1,0,1,2,0,1,1,1,1,3,0,0,3,1,1,0,2,2,1,1,
+0,2,0,0,0,0,0,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,0,3,1,2,0,0,2,2,0,1,2,0,1,0,1,3,1,2,1,0,0,0,2,0,3,0,0,0,1,0,
+0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,1,1,2,2,0,0,0,2,0,2,1,0,1,1,0,1,1,1,2,1,0,0,1,1,1,0,2,1,1,1,
+0,1,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,1,
+0,0,0,2,0,1,3,1,1,1,1,0,0,0,0,3,2,0,1,0,0,0,1,2,0,0,0,1,0,0,0,0,
+0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,0,2,3,2,2,0,0,0,1,0,0,0,0,2,3,2,1,2,2,3,0,0,0,2,3,1,0,0,0,1,1,
+0,0,1,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,
+3,3,2,2,0,1,0,0,0,0,2,0,2,0,1,0,0,0,1,1,0,0,0,2,1,0,1,0,1,1,0,0,
+0,1,0,2,0,0,1,0,3,0,1,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,1,0,0,1,0,0,0,0,0,1,1,2,0,0,0,0,1,0,0,1,3,1,0,0,0,0,1,1,0,0,
+0,1,0,0,0,0,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,
+3,3,1,1,1,1,2,3,0,0,2,1,1,1,1,1,0,2,1,1,0,0,0,2,1,0,1,2,1,1,0,1,
+2,1,0,3,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,3,1,0,0,0,0,0,0,0,3,0,0,0,3,0,0,0,0,0,0,0,0,1,1,0,0,0,0,0,0,1,
+0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,2,0,0,0,0,0,0,1,2,1,0,1,1,0,2,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,2,0,0,0,1,3,0,1,0,0,0,2,0,0,0,0,0,0,0,1,2,0,0,0,0,0,
+3,3,0,0,1,1,2,0,0,1,2,1,0,1,1,1,0,1,1,0,0,2,1,1,0,1,0,0,1,1,1,0,
+0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,1,0,0,0,0,1,0,0,0,0,3,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
+2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,3,0,0,1,1,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+1,1,0,1,2,0,1,2,0,0,1,1,0,2,0,1,0,0,1,0,0,0,0,1,0,0,0,2,0,0,0,0,
+1,0,0,1,0,1,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,1,0,0,0,0,0,0,0,1,1,0,1,1,0,2,1,3,0,0,0,0,1,1,0,0,0,0,0,0,0,3,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,1,0,1,0,0,2,0,0,2,0,0,1,1,2,0,0,1,1,0,0,0,1,0,0,0,1,1,0,0,0,
+1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
+1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,3,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,
+1,0,0,0,0,0,0,0,0,1,0,0,0,0,2,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,1,1,0,0,2,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+)
+
+TIS620ThaiModel = {
+  'char_to_order_map': TIS620CharToOrderMap,
+  'precedence_matrix': ThaiLangModel,
+  'typical_positive_ratio': 0.926386,
+  'keep_english_letter': False,
+  'charset_name': "TIS-620",
+  'language': 'Thai',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langturkishmodel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langturkishmodel.py
new file mode 100644
index 0000000000000000000000000000000000000000..a427a457398de8076cdcefb5a6c391e89500bce8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/langturkishmodel.py
@@ -0,0 +1,193 @@
+# -*- coding: utf-8 -*-
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Communicator client code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Özgür Baskın - Turkish Language Model
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+# 255: Control characters that usually does not exist in any text
+# 254: Carriage/Return
+# 253: symbol (punctuation) that does not belong to word
+# 252: 0 - 9
+
+# Character Mapping Table:
+Latin5_TurkishCharToOrderMap = (
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
+255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
+255, 23, 37, 47, 39, 29, 52, 36, 45, 53, 60, 16, 49, 20, 46, 42,
+ 48, 69, 44, 35, 31, 51, 38, 62, 65, 43, 56,255,255,255,255,255,
+255,  1, 21, 28, 12,  2, 18, 27, 25,  3, 24, 10,  5, 13,  4, 15,
+ 26, 64,  7,  8,  9, 14, 32, 57, 58, 11, 22,255,255,255,255,255,
+180,179,178,177,176,175,174,173,172,171,170,169,168,167,166,165,
+164,163,162,161,160,159,101,158,157,156,155,154,153,152,151,106,
+150,149,148,147,146,145,144,100,143,142,141,140,139,138,137,136,
+ 94, 80, 93,135,105,134,133, 63,132,131,130,129,128,127,126,125,
+124,104, 73, 99, 79, 85,123, 54,122, 98, 92,121,120, 91,103,119,
+ 68,118,117, 97,116,115, 50, 90,114,113,112,111, 55, 41, 40, 86,
+ 89, 70, 59, 78, 71, 82, 88, 33, 77, 66, 84, 83,110, 75, 61, 96,
+ 30, 67,109, 74, 87,102, 34, 95, 81,108, 76, 72, 17,  6, 19,107,
+)
+
+TurkishLangModel = (
+3,2,3,3,3,1,3,3,3,3,3,3,3,3,2,1,1,3,3,1,3,3,0,3,3,3,3,3,0,3,1,3,
+3,2,1,0,0,1,1,0,0,0,1,0,0,1,1,1,1,0,0,0,0,0,0,0,2,2,0,0,1,0,0,1,
+3,2,2,3,3,0,3,3,3,3,3,3,3,2,3,1,0,3,3,1,3,3,0,3,3,3,3,3,0,3,0,3,
+3,1,1,0,1,0,1,0,0,0,0,0,0,1,1,1,1,0,0,0,0,0,0,0,2,2,0,0,0,1,0,1,
+3,3,2,3,3,0,3,3,3,3,3,3,3,2,3,1,1,3,3,0,3,3,1,2,3,3,3,3,0,3,0,3,
+3,1,1,0,0,0,1,0,0,0,0,1,1,0,1,2,1,0,0,0,1,0,0,0,0,2,0,0,0,0,0,1,
+3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,1,3,3,2,0,3,2,1,2,2,1,3,3,0,0,0,2,
+2,2,0,1,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,1,0,0,1,
+3,3,3,2,3,3,1,2,3,3,3,3,3,3,3,1,3,2,1,0,3,2,0,1,2,3,3,2,1,0,0,2,
+2,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,2,0,0,0,
+1,0,1,3,3,1,3,3,3,3,3,3,3,1,2,0,0,2,3,0,2,3,0,0,2,2,2,3,0,3,0,1,
+2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,0,3,2,0,2,3,2,3,3,1,0,0,2,
+3,2,0,0,1,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,1,1,1,0,2,0,0,1,
+3,3,3,2,3,3,2,3,3,3,3,2,3,3,3,0,3,3,0,0,2,1,0,0,2,3,2,2,0,0,0,2,
+2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,0,1,0,2,0,0,1,
+3,3,3,2,3,3,3,3,3,3,3,2,3,3,3,0,3,2,0,1,3,2,1,1,3,2,3,2,1,0,0,2,
+2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,
+3,3,3,2,3,3,3,3,3,3,3,2,3,3,3,0,3,2,2,0,2,3,0,0,2,2,2,2,0,0,0,2,
+3,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,2,0,1,0,0,0,
+3,3,3,3,3,3,3,2,2,2,2,3,2,3,3,0,3,3,1,1,2,2,0,0,2,2,3,2,0,0,1,3,
+0,3,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,
+3,3,3,2,3,3,3,2,1,2,2,3,2,3,3,0,3,2,0,0,1,1,0,1,1,2,1,2,0,0,0,1,
+0,3,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,1,0,0,0,
+3,3,3,2,3,3,2,3,2,2,2,3,3,3,3,1,3,1,1,0,3,2,1,1,3,3,2,3,1,0,0,1,
+1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,2,0,0,1,
+3,2,2,3,3,0,3,3,3,3,3,3,3,2,2,1,0,3,3,1,3,3,0,1,3,3,2,3,0,3,0,3,
+2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
+2,2,2,3,3,0,3,3,3,3,3,3,3,3,3,0,0,3,2,0,3,3,0,3,2,3,3,3,0,3,1,3,
+2,0,0,0,0,0,0,0,0,0,0,1,0,1,2,0,1,0,0,0,0,0,0,0,2,2,0,0,1,0,0,1,
+3,3,3,1,2,3,3,1,0,0,1,0,0,3,3,2,3,0,0,2,0,0,2,0,2,0,0,0,2,0,2,0,
+0,3,1,0,1,0,0,0,2,2,1,0,1,1,2,1,2,2,2,0,2,1,1,0,0,0,2,0,0,0,0,0,
+1,2,1,3,3,0,3,3,3,3,3,2,3,0,0,0,0,2,3,0,2,3,1,0,2,3,1,3,0,3,0,2,
+3,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,1,3,3,2,2,3,2,2,0,1,2,3,0,1,2,1,0,1,0,0,0,1,0,2,2,0,0,0,1,
+1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,1,0,0,1,0,0,0,
+3,3,3,1,3,3,1,1,3,3,1,1,3,3,1,0,2,1,2,0,2,1,0,0,1,1,2,1,0,0,0,2,
+2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,1,0,2,1,3,0,0,2,0,0,3,3,0,3,0,0,1,0,1,2,0,0,1,1,2,2,0,1,0,
+0,1,2,1,1,0,1,0,1,1,1,1,1,0,1,1,1,2,2,1,2,0,1,0,0,0,0,0,0,1,0,0,
+3,3,3,2,3,2,3,3,0,2,2,2,3,3,3,0,3,0,0,0,2,2,0,1,2,1,1,1,0,0,0,1,
+0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
+3,3,3,3,3,3,2,1,2,2,3,3,3,3,2,0,2,0,0,0,2,2,0,0,2,1,3,3,0,0,1,1,
+1,1,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,
+1,1,2,3,3,0,3,3,3,3,3,3,2,2,0,2,0,2,3,2,3,2,2,2,2,2,2,2,1,3,2,3,
+2,0,2,1,2,2,2,2,1,1,2,2,1,2,2,1,2,0,0,2,1,1,0,2,1,0,0,1,0,0,0,1,
+2,3,3,1,1,1,0,1,1,1,2,3,2,1,1,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,
+0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,2,2,2,3,2,3,2,2,1,3,3,3,0,2,1,2,0,2,1,0,0,1,1,1,1,1,0,0,1,
+2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,2,0,1,0,0,0,
+3,3,3,2,3,3,3,3,3,2,3,1,2,3,3,1,2,0,0,0,0,0,0,0,3,2,1,1,0,0,0,0,
+2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
+3,3,3,2,2,3,3,2,1,1,1,1,1,3,3,0,3,1,0,0,1,1,0,0,3,1,2,1,0,0,0,0,
+0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,
+3,3,3,2,2,3,2,2,2,3,2,1,1,3,3,0,3,0,0,0,0,1,0,0,3,1,1,2,0,0,0,1,
+1,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
+1,1,1,3,3,0,3,3,3,3,3,2,2,2,1,2,0,2,1,2,2,1,1,0,1,2,2,2,2,2,2,2,
+0,0,2,1,2,1,2,1,0,1,1,3,1,2,1,1,2,0,0,2,0,1,0,1,0,1,0,0,0,1,0,1,
+3,3,3,1,3,3,3,0,1,1,0,2,2,3,1,0,3,0,0,0,1,0,0,0,1,0,0,1,0,1,0,0,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,2,0,0,2,2,1,0,0,1,0,0,3,3,1,3,0,0,1,1,0,2,0,3,0,0,0,2,0,1,1,
+0,1,2,0,1,2,2,0,2,2,2,2,1,0,2,1,1,0,2,0,2,1,2,0,0,0,0,0,0,0,0,0,
+3,3,3,1,3,2,3,2,0,2,2,2,1,3,2,0,2,1,2,0,1,2,0,0,1,0,2,2,0,0,0,2,
+1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,1,0,0,0,
+3,3,3,0,3,3,1,1,2,3,1,0,3,2,3,0,3,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,
+1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,3,3,0,3,3,2,3,3,2,2,0,0,0,0,1,2,0,1,3,0,0,0,3,1,1,0,3,0,2,
+2,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,1,2,2,1,0,3,1,1,1,1,3,3,2,3,0,0,1,0,1,2,0,2,2,0,2,2,0,2,1,
+0,2,2,1,1,1,1,0,2,1,1,0,1,1,1,1,2,1,2,1,2,0,1,0,1,0,0,0,0,0,0,0,
+3,3,3,0,1,1,3,0,0,1,1,0,0,2,2,0,3,0,0,1,1,0,1,0,0,0,0,0,2,0,0,0,
+0,3,1,0,1,0,1,0,2,0,0,1,0,1,0,1,1,1,2,1,1,0,2,0,0,0,0,0,0,0,0,0,
+3,3,3,0,2,0,2,0,1,1,1,0,0,3,3,0,2,0,0,1,0,0,2,1,1,0,1,0,1,0,1,0,
+0,2,0,1,2,0,2,0,2,1,1,0,1,0,2,1,1,0,2,1,1,0,1,0,0,0,1,1,0,0,0,0,
+3,2,3,0,1,0,0,0,0,0,0,0,0,1,2,0,1,0,0,1,0,0,1,0,0,0,0,0,2,0,0,0,
+0,0,1,1,0,0,1,0,1,0,0,1,0,0,0,2,1,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,0,0,2,3,0,0,1,0,1,0,2,3,2,3,0,0,1,3,0,2,1,0,0,0,0,2,0,1,0,
+0,2,1,0,0,1,1,0,2,1,0,0,1,0,0,1,1,0,1,1,2,0,1,0,0,0,0,1,0,0,0,0,
+3,2,2,0,0,1,1,0,0,0,0,0,0,3,1,1,1,0,0,0,0,0,1,0,0,0,0,0,2,0,1,0,
+0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,3,3,0,2,3,2,2,1,2,2,1,1,2,0,1,3,2,2,2,0,0,2,2,0,0,0,1,2,1,
+3,0,2,1,1,0,1,1,1,0,1,2,2,2,1,1,2,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,
+0,1,1,2,3,0,3,3,3,2,2,2,2,1,0,1,0,1,0,1,2,2,0,0,2,2,1,3,1,1,2,1,
+0,0,1,1,2,0,1,1,0,0,1,2,0,2,1,1,2,0,0,1,0,0,0,1,0,1,0,1,0,0,0,0,
+3,3,2,0,0,3,1,0,0,0,0,0,0,3,2,1,2,0,0,1,0,0,2,0,0,0,0,0,2,0,1,0,
+0,2,1,1,0,0,1,0,1,2,0,0,1,1,0,0,2,1,1,1,1,0,2,0,0,0,0,0,0,0,0,0,
+3,3,2,0,0,1,0,0,0,0,1,0,0,3,3,2,2,0,0,1,0,0,2,0,1,0,0,0,2,0,1,0,
+0,0,1,1,0,0,2,0,2,1,0,0,1,1,2,1,2,0,2,1,2,1,1,1,0,0,1,1,0,0,0,0,
+3,3,2,0,0,2,2,0,0,0,1,1,0,2,2,1,3,1,0,1,0,1,2,0,0,0,0,0,1,0,1,0,
+0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,1,1,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,2,0,0,0,1,0,0,1,0,0,2,3,1,2,0,0,1,0,0,2,0,0,0,1,0,2,0,2,0,
+0,1,1,2,2,1,2,0,2,1,1,0,0,1,1,0,1,1,1,1,2,1,1,0,0,0,0,0,0,0,0,0,
+3,3,3,0,2,1,2,1,0,0,1,1,0,3,3,1,2,0,0,1,0,0,2,0,2,0,1,1,2,0,0,0,
+0,0,1,1,1,1,2,0,1,1,0,1,1,1,1,0,0,0,1,1,1,0,1,0,0,0,1,0,0,0,0,0,
+3,3,3,0,2,2,3,2,0,0,1,0,0,2,3,1,0,0,0,0,0,0,2,0,2,0,0,0,2,0,0,0,
+0,1,1,0,0,0,1,0,0,1,0,1,1,0,1,0,1,1,1,0,1,0,0,0,0,0,0,0,0,0,0,0,
+3,2,3,0,0,0,0,0,0,0,1,0,0,2,2,2,2,0,0,1,0,0,2,0,0,0,0,0,2,0,1,0,
+0,0,2,1,1,0,1,0,2,1,1,0,0,1,1,2,1,0,2,0,2,0,1,0,0,0,2,0,0,0,0,0,
+0,0,0,2,2,0,2,1,1,1,1,2,2,0,0,1,0,1,0,0,1,3,0,0,0,0,1,0,0,2,1,0,
+0,0,1,0,1,0,0,0,0,0,2,1,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
+2,0,0,2,3,0,2,3,1,2,2,0,2,0,0,2,0,2,1,1,1,2,1,0,0,1,2,1,1,2,1,0,
+1,0,2,0,1,0,1,1,0,0,2,2,1,2,1,1,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
+3,3,3,0,2,1,2,0,0,0,1,0,0,3,2,0,1,0,0,1,0,0,2,0,0,0,1,2,1,0,1,0,
+0,0,0,0,1,0,1,0,0,1,0,0,0,0,1,0,1,0,1,1,1,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,2,2,0,2,2,1,1,0,1,1,1,1,1,0,0,1,2,1,1,1,0,1,0,0,0,1,1,1,1,
+0,0,2,1,0,1,1,1,0,1,1,2,1,2,1,1,2,0,1,1,2,1,0,2,0,0,0,0,0,0,0,0,
+3,2,2,0,0,2,0,0,0,0,0,0,0,2,2,0,2,0,0,1,0,0,2,0,0,0,0,0,2,0,0,0,
+0,2,1,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,3,2,0,2,2,0,1,1,0,1,0,0,1,0,0,0,1,0,1,0,0,0,0,0,1,0,0,0,0,
+2,0,1,0,1,0,1,1,0,0,1,2,0,1,0,1,1,0,0,1,0,1,0,2,0,0,0,0,0,0,0,0,
+2,2,2,0,1,1,0,0,0,1,0,0,0,1,2,0,1,0,0,1,0,0,1,0,0,0,0,1,2,0,1,0,
+0,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,2,1,0,1,1,1,0,0,0,0,1,2,0,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
+1,1,2,0,1,0,0,0,1,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2,0,0,0,0,0,1,
+0,0,1,2,2,0,2,1,2,1,1,2,2,0,0,0,0,1,0,0,1,1,0,0,2,0,0,0,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
+2,2,2,0,0,0,1,0,0,0,0,0,0,2,2,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
+0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,1,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+2,2,2,0,1,0,1,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,1,0,0,0,0,0,0,0,0,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
+)
+
+Latin5TurkishModel = {
+  'char_to_order_map': Latin5_TurkishCharToOrderMap,
+  'precedence_matrix': TurkishLangModel,
+  'typical_positive_ratio': 0.970290,
+  'keep_english_letter': True,
+  'charset_name': "ISO-8859-9",
+  'language': 'Turkish',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/latin1prober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/latin1prober.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d1e8c20fb09ddaa0254ae74cbd4425ffdc5dcdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/latin1prober.py
@@ -0,0 +1,145 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState
+
+FREQ_CAT_NUM = 4
+
+UDF = 0  # undefined
+OTH = 1  # other
+ASC = 2  # ascii capital letter
+ASS = 3  # ascii small letter
+ACV = 4  # accent capital vowel
+ACO = 5  # accent capital other
+ASV = 6  # accent small vowel
+ASO = 7  # accent small other
+CLASS_NUM = 8  # total classes
+
+Latin1_CharToClass = (
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 00 - 07
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 08 - 0F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 10 - 17
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 18 - 1F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 20 - 27
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 28 - 2F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 30 - 37
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 38 - 3F
+    OTH, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 40 - 47
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 48 - 4F
+    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 50 - 57
+    ASC, ASC, ASC, OTH, OTH, OTH, OTH, OTH,   # 58 - 5F
+    OTH, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 60 - 67
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 68 - 6F
+    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 70 - 77
+    ASS, ASS, ASS, OTH, OTH, OTH, OTH, OTH,   # 78 - 7F
+    OTH, UDF, OTH, ASO, OTH, OTH, OTH, OTH,   # 80 - 87
+    OTH, OTH, ACO, OTH, ACO, UDF, ACO, UDF,   # 88 - 8F
+    UDF, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 90 - 97
+    OTH, OTH, ASO, OTH, ASO, UDF, ASO, ACO,   # 98 - 9F
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A0 - A7
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A8 - AF
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B0 - B7
+    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B8 - BF
+    ACV, ACV, ACV, ACV, ACV, ACV, ACO, ACO,   # C0 - C7
+    ACV, ACV, ACV, ACV, ACV, ACV, ACV, ACV,   # C8 - CF
+    ACO, ACO, ACV, ACV, ACV, ACV, ACV, OTH,   # D0 - D7
+    ACV, ACV, ACV, ACV, ACV, ACO, ACO, ACO,   # D8 - DF
+    ASV, ASV, ASV, ASV, ASV, ASV, ASO, ASO,   # E0 - E7
+    ASV, ASV, ASV, ASV, ASV, ASV, ASV, ASV,   # E8 - EF
+    ASO, ASO, ASV, ASV, ASV, ASV, ASV, OTH,   # F0 - F7
+    ASV, ASV, ASV, ASV, ASV, ASO, ASO, ASO,   # F8 - FF
+)
+
+# 0 : illegal
+# 1 : very unlikely
+# 2 : normal
+# 3 : very likely
+Latin1ClassModel = (
+# UDF OTH ASC ASS ACV ACO ASV ASO
+    0,  0,  0,  0,  0,  0,  0,  0,  # UDF
+    0,  3,  3,  3,  3,  3,  3,  3,  # OTH
+    0,  3,  3,  3,  3,  3,  3,  3,  # ASC
+    0,  3,  3,  3,  1,  1,  3,  3,  # ASS
+    0,  3,  3,  3,  1,  2,  1,  2,  # ACV
+    0,  3,  3,  3,  3,  3,  3,  3,  # ACO
+    0,  3,  1,  3,  1,  1,  1,  3,  # ASV
+    0,  3,  1,  3,  1,  1,  3,  3,  # ASO
+)
+
+
+class Latin1Prober(CharSetProber):
+    def __init__(self):
+        super(Latin1Prober, self).__init__()
+        self._last_char_class = None
+        self._freq_counter = None
+        self.reset()
+
+    def reset(self):
+        self._last_char_class = OTH
+        self._freq_counter = [0] * FREQ_CAT_NUM
+        CharSetProber.reset(self)
+
+    @property
+    def charset_name(self):
+        return "ISO-8859-1"
+
+    @property
+    def language(self):
+        return ""
+
+    def feed(self, byte_str):
+        byte_str = self.filter_with_english_letters(byte_str)
+        for c in byte_str:
+            char_class = Latin1_CharToClass[c]
+            freq = Latin1ClassModel[(self._last_char_class * CLASS_NUM)
+                                    + char_class]
+            if freq == 0:
+                self._state = ProbingState.NOT_ME
+                break
+            self._freq_counter[freq] += 1
+            self._last_char_class = char_class
+
+        return self.state
+
+    def get_confidence(self):
+        if self.state == ProbingState.NOT_ME:
+            return 0.01
+
+        total = sum(self._freq_counter)
+        if total < 0.01:
+            confidence = 0.0
+        else:
+            confidence = ((self._freq_counter[3] - self._freq_counter[1] * 20.0)
+                          / total)
+        if confidence < 0.0:
+            confidence = 0.0
+        # lower the confidence of latin1 so that other more accurate
+        # detector can take priority.
+        confidence = confidence * 0.73
+        return confidence
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcharsetprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcharsetprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..6256ecfd1e2c9ac4cfa3fac359cd12dce85b759c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcharsetprober.py
@@ -0,0 +1,91 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#   Proofpoint, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState, MachineState
+
+
+class MultiByteCharSetProber(CharSetProber):
+    """
+    MultiByteCharSetProber
+    """
+
+    def __init__(self, lang_filter=None):
+        super(MultiByteCharSetProber, self).__init__(lang_filter=lang_filter)
+        self.distribution_analyzer = None
+        self.coding_sm = None
+        self._last_char = [0, 0]
+
+    def reset(self):
+        super(MultiByteCharSetProber, self).reset()
+        if self.coding_sm:
+            self.coding_sm.reset()
+        if self.distribution_analyzer:
+            self.distribution_analyzer.reset()
+        self._last_char = [0, 0]
+
+    @property
+    def charset_name(self):
+        raise NotImplementedError
+
+    @property
+    def language(self):
+        raise NotImplementedError
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                    char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.distribution_analyzer.got_enough_data() and
+                    (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        return self.distribution_analyzer.get_confidence()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcsgroupprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcsgroupprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..530abe75e0c00cbfcb2a310d872866f320977d0a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcsgroupprober.py
@@ -0,0 +1,54 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#   Proofpoint, Inc.
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetgroupprober import CharSetGroupProber
+from .utf8prober import UTF8Prober
+from .sjisprober import SJISProber
+from .eucjpprober import EUCJPProber
+from .gb2312prober import GB2312Prober
+from .euckrprober import EUCKRProber
+from .cp949prober import CP949Prober
+from .big5prober import Big5Prober
+from .euctwprober import EUCTWProber
+
+
+class MBCSGroupProber(CharSetGroupProber):
+    def __init__(self, lang_filter=None):
+        super(MBCSGroupProber, self).__init__(lang_filter=lang_filter)
+        self.probers = [
+            UTF8Prober(),
+            SJISProber(),
+            EUCJPProber(),
+            GB2312Prober(),
+            EUCKRProber(),
+            CP949Prober(),
+            Big5Prober(),
+            EUCTWProber()
+        ]
+        self.reset()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcssm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcssm.py
new file mode 100644
index 0000000000000000000000000000000000000000..8360d0f284ef394f2980b5bb89548e234385cdf1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/mbcssm.py
@@ -0,0 +1,572 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .enums import MachineState
+
+# BIG5
+
+BIG5_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07    #allow 0x00 as legal value
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,1,  # 78 - 7f
+    4,4,4,4,4,4,4,4,  # 80 - 87
+    4,4,4,4,4,4,4,4,  # 88 - 8f
+    4,4,4,4,4,4,4,4,  # 90 - 97
+    4,4,4,4,4,4,4,4,  # 98 - 9f
+    4,3,3,3,3,3,3,3,  # a0 - a7
+    3,3,3,3,3,3,3,3,  # a8 - af
+    3,3,3,3,3,3,3,3,  # b0 - b7
+    3,3,3,3,3,3,3,3,  # b8 - bf
+    3,3,3,3,3,3,3,3,  # c0 - c7
+    3,3,3,3,3,3,3,3,  # c8 - cf
+    3,3,3,3,3,3,3,3,  # d0 - d7
+    3,3,3,3,3,3,3,3,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,3,3,3,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,3,3,0  # f8 - ff
+)
+
+BIG5_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,#08-0f
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START#10-17
+)
+
+BIG5_CHAR_LEN_TABLE = (0, 1, 1, 2, 0)
+
+BIG5_SM_MODEL = {'class_table': BIG5_CLS,
+                 'class_factor': 5,
+                 'state_table': BIG5_ST,
+                 'char_len_table': BIG5_CHAR_LEN_TABLE,
+                 'name': 'Big5'}
+
+# CP949
+
+CP949_CLS  = (
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,0,0,  # 00 - 0f
+    1,1,1,1,1,1,1,1, 1,1,1,0,1,1,1,1,  # 10 - 1f
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 20 - 2f
+    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 30 - 3f
+    1,4,4,4,4,4,4,4, 4,4,4,4,4,4,4,4,  # 40 - 4f
+    4,4,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 50 - 5f
+    1,5,5,5,5,5,5,5, 5,5,5,5,5,5,5,5,  # 60 - 6f
+    5,5,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 70 - 7f
+    0,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 80 - 8f
+    6,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 90 - 9f
+    6,7,7,7,7,7,7,7, 7,7,7,7,7,8,8,8,  # a0 - af
+    7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,  # b0 - bf
+    7,7,7,7,7,7,9,2, 2,3,2,2,2,2,2,2,  # c0 - cf
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # d0 - df
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # e0 - ef
+    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,0,  # f0 - ff
+)
+
+CP949_ST = (
+#cls=    0      1      2      3      4      5      6      7      8      9  # previous state =
+    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,     4,     5,MachineState.ERROR,     6, # MachineState.START
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR, # MachineState.ERROR
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME, # MachineState.ITS_ME
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 3
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 4
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 5
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 6
+)
+
+CP949_CHAR_LEN_TABLE = (0, 1, 2, 0, 1, 1, 2, 2, 0, 2)
+
+CP949_SM_MODEL = {'class_table': CP949_CLS,
+                  'class_factor': 10,
+                  'state_table': CP949_ST,
+                  'char_len_table': CP949_CHAR_LEN_TABLE,
+                  'name': 'CP949'}
+
+# EUC-JP
+
+EUCJP_CLS = (
+    4,4,4,4,4,4,4,4,  # 00 - 07
+    4,4,4,4,4,4,5,5,  # 08 - 0f
+    4,4,4,4,4,4,4,4,  # 10 - 17
+    4,4,4,5,4,4,4,4,  # 18 - 1f
+    4,4,4,4,4,4,4,4,  # 20 - 27
+    4,4,4,4,4,4,4,4,  # 28 - 2f
+    4,4,4,4,4,4,4,4,  # 30 - 37
+    4,4,4,4,4,4,4,4,  # 38 - 3f
+    4,4,4,4,4,4,4,4,  # 40 - 47
+    4,4,4,4,4,4,4,4,  # 48 - 4f
+    4,4,4,4,4,4,4,4,  # 50 - 57
+    4,4,4,4,4,4,4,4,  # 58 - 5f
+    4,4,4,4,4,4,4,4,  # 60 - 67
+    4,4,4,4,4,4,4,4,  # 68 - 6f
+    4,4,4,4,4,4,4,4,  # 70 - 77
+    4,4,4,4,4,4,4,4,  # 78 - 7f
+    5,5,5,5,5,5,5,5,  # 80 - 87
+    5,5,5,5,5,5,1,3,  # 88 - 8f
+    5,5,5,5,5,5,5,5,  # 90 - 97
+    5,5,5,5,5,5,5,5,  # 98 - 9f
+    5,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,2,2,2,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,2,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,0,5  # f8 - ff
+)
+
+EUCJP_ST = (
+          3,     4,     3,     5,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
+     MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     3,MachineState.ERROR,#18-1f
+          3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START#20-27
+)
+
+EUCJP_CHAR_LEN_TABLE = (2, 2, 2, 3, 1, 0)
+
+EUCJP_SM_MODEL = {'class_table': EUCJP_CLS,
+                  'class_factor': 6,
+                  'state_table': EUCJP_ST,
+                  'char_len_table': EUCJP_CHAR_LEN_TABLE,
+                  'name': 'EUC-JP'}
+
+# EUC-KR
+
+EUCKR_CLS  = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    1,1,1,1,1,1,1,1,  # 40 - 47
+    1,1,1,1,1,1,1,1,  # 48 - 4f
+    1,1,1,1,1,1,1,1,  # 50 - 57
+    1,1,1,1,1,1,1,1,  # 58 - 5f
+    1,1,1,1,1,1,1,1,  # 60 - 67
+    1,1,1,1,1,1,1,1,  # 68 - 6f
+    1,1,1,1,1,1,1,1,  # 70 - 77
+    1,1,1,1,1,1,1,1,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,3,3,3,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,3,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    2,2,2,2,2,2,2,2,  # e0 - e7
+    2,2,2,2,2,2,2,2,  # e8 - ef
+    2,2,2,2,2,2,2,2,  # f0 - f7
+    2,2,2,2,2,2,2,0   # f8 - ff
+)
+
+EUCKR_ST = (
+    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #08-0f
+)
+
+EUCKR_CHAR_LEN_TABLE = (0, 1, 2, 0)
+
+EUCKR_SM_MODEL = {'class_table': EUCKR_CLS,
+                'class_factor': 4,
+                'state_table': EUCKR_ST,
+                'char_len_table': EUCKR_CHAR_LEN_TABLE,
+                'name': 'EUC-KR'}
+
+# EUC-TW
+
+EUCTW_CLS = (
+    2,2,2,2,2,2,2,2,  # 00 - 07
+    2,2,2,2,2,2,0,0,  # 08 - 0f
+    2,2,2,2,2,2,2,2,  # 10 - 17
+    2,2,2,0,2,2,2,2,  # 18 - 1f
+    2,2,2,2,2,2,2,2,  # 20 - 27
+    2,2,2,2,2,2,2,2,  # 28 - 2f
+    2,2,2,2,2,2,2,2,  # 30 - 37
+    2,2,2,2,2,2,2,2,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,2,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,6,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,3,4,4,4,4,4,4,  # a0 - a7
+    5,5,1,1,1,1,1,1,  # a8 - af
+    1,1,1,1,1,1,1,1,  # b0 - b7
+    1,1,1,1,1,1,1,1,  # b8 - bf
+    1,1,3,1,3,3,3,3,  # c0 - c7
+    3,3,3,3,3,3,3,3,  # c8 - cf
+    3,3,3,3,3,3,3,3,  # d0 - d7
+    3,3,3,3,3,3,3,3,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,3,3,3,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,3,3,0   # f8 - ff
+)
+
+EUCTW_ST = (
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,     3,     3,     3,     4,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.ERROR,#10-17
+    MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+         5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,#20-27
+    MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
+)
+
+EUCTW_CHAR_LEN_TABLE = (0, 0, 1, 2, 2, 2, 3)
+
+EUCTW_SM_MODEL = {'class_table': EUCTW_CLS,
+                'class_factor': 7,
+                'state_table': EUCTW_ST,
+                'char_len_table': EUCTW_CHAR_LEN_TABLE,
+                'name': 'x-euc-tw'}
+
+# GB2312
+
+GB2312_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    3,3,3,3,3,3,3,3,  # 30 - 37
+    3,3,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,4,  # 78 - 7f
+    5,6,6,6,6,6,6,6,  # 80 - 87
+    6,6,6,6,6,6,6,6,  # 88 - 8f
+    6,6,6,6,6,6,6,6,  # 90 - 97
+    6,6,6,6,6,6,6,6,  # 98 - 9f
+    6,6,6,6,6,6,6,6,  # a0 - a7
+    6,6,6,6,6,6,6,6,  # a8 - af
+    6,6,6,6,6,6,6,6,  # b0 - b7
+    6,6,6,6,6,6,6,6,  # b8 - bf
+    6,6,6,6,6,6,6,6,  # c0 - c7
+    6,6,6,6,6,6,6,6,  # c8 - cf
+    6,6,6,6,6,6,6,6,  # d0 - d7
+    6,6,6,6,6,6,6,6,  # d8 - df
+    6,6,6,6,6,6,6,6,  # e0 - e7
+    6,6,6,6,6,6,6,6,  # e8 - ef
+    6,6,6,6,6,6,6,6,  # f0 - f7
+    6,6,6,6,6,6,6,0   # f8 - ff
+)
+
+GB2312_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,     3,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,#10-17
+         4,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+    MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#20-27
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
+)
+
+# To be accurate, the length of class 6 can be either 2 or 4.
+# But it is not necessary to discriminate between the two since
+# it is used for frequency analysis only, and we are validating
+# each code range there as well. So it is safe to set it to be
+# 2 here.
+GB2312_CHAR_LEN_TABLE = (0, 1, 1, 1, 1, 1, 2)
+
+GB2312_SM_MODEL = {'class_table': GB2312_CLS,
+                   'class_factor': 7,
+                   'state_table': GB2312_ST,
+                   'char_len_table': GB2312_CHAR_LEN_TABLE,
+                   'name': 'GB2312'}
+
+# Shift_JIS
+
+SJIS_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    2,2,2,2,2,2,2,2,  # 40 - 47
+    2,2,2,2,2,2,2,2,  # 48 - 4f
+    2,2,2,2,2,2,2,2,  # 50 - 57
+    2,2,2,2,2,2,2,2,  # 58 - 5f
+    2,2,2,2,2,2,2,2,  # 60 - 67
+    2,2,2,2,2,2,2,2,  # 68 - 6f
+    2,2,2,2,2,2,2,2,  # 70 - 77
+    2,2,2,2,2,2,2,1,  # 78 - 7f
+    3,3,3,3,3,2,2,3,  # 80 - 87
+    3,3,3,3,3,3,3,3,  # 88 - 8f
+    3,3,3,3,3,3,3,3,  # 90 - 97
+    3,3,3,3,3,3,3,3,  # 98 - 9f
+    #0xa0 is illegal in sjis encoding, but some pages does
+    #contain such byte. We need to be more error forgiven.
+    2,2,2,2,2,2,2,2,  # a0 - a7
+    2,2,2,2,2,2,2,2,  # a8 - af
+    2,2,2,2,2,2,2,2,  # b0 - b7
+    2,2,2,2,2,2,2,2,  # b8 - bf
+    2,2,2,2,2,2,2,2,  # c0 - c7
+    2,2,2,2,2,2,2,2,  # c8 - cf
+    2,2,2,2,2,2,2,2,  # d0 - d7
+    2,2,2,2,2,2,2,2,  # d8 - df
+    3,3,3,3,3,3,3,3,  # e0 - e7
+    3,3,3,3,3,4,4,4,  # e8 - ef
+    3,3,3,3,3,3,3,3,  # f0 - f7
+    3,3,3,3,3,0,0,0)  # f8 - ff
+
+
+SJIS_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START #10-17
+)
+
+SJIS_CHAR_LEN_TABLE = (0, 1, 1, 2, 0, 0)
+
+SJIS_SM_MODEL = {'class_table': SJIS_CLS,
+               'class_factor': 6,
+               'state_table': SJIS_ST,
+               'char_len_table': SJIS_CHAR_LEN_TABLE,
+               'name': 'Shift_JIS'}
+
+# UCS2-BE
+
+UCS2BE_CLS = (
+    0,0,0,0,0,0,0,0,  # 00 - 07
+    0,0,1,0,0,2,0,0,  # 08 - 0f
+    0,0,0,0,0,0,0,0,  # 10 - 17
+    0,0,0,3,0,0,0,0,  # 18 - 1f
+    0,0,0,0,0,0,0,0,  # 20 - 27
+    0,3,3,3,3,3,0,0,  # 28 - 2f
+    0,0,0,0,0,0,0,0,  # 30 - 37
+    0,0,0,0,0,0,0,0,  # 38 - 3f
+    0,0,0,0,0,0,0,0,  # 40 - 47
+    0,0,0,0,0,0,0,0,  # 48 - 4f
+    0,0,0,0,0,0,0,0,  # 50 - 57
+    0,0,0,0,0,0,0,0,  # 58 - 5f
+    0,0,0,0,0,0,0,0,  # 60 - 67
+    0,0,0,0,0,0,0,0,  # 68 - 6f
+    0,0,0,0,0,0,0,0,  # 70 - 77
+    0,0,0,0,0,0,0,0,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,0,0,0,0,0,0,0,  # a0 - a7
+    0,0,0,0,0,0,0,0,  # a8 - af
+    0,0,0,0,0,0,0,0,  # b0 - b7
+    0,0,0,0,0,0,0,0,  # b8 - bf
+    0,0,0,0,0,0,0,0,  # c0 - c7
+    0,0,0,0,0,0,0,0,  # c8 - cf
+    0,0,0,0,0,0,0,0,  # d0 - d7
+    0,0,0,0,0,0,0,0,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,4,5   # f8 - ff
+)
+
+UCS2BE_ST  = (
+          5,     7,     7,MachineState.ERROR,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,     6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,#10-17
+          6,     6,     6,     6,     6,MachineState.ITS_ME,     6,     6,#18-1f
+          6,     6,     6,     6,     5,     7,     7,MachineState.ERROR,#20-27
+          5,     8,     6,     6,MachineState.ERROR,     6,     6,     6,#28-2f
+          6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #30-37
+)
+
+UCS2BE_CHAR_LEN_TABLE = (2, 2, 2, 0, 2, 2)
+
+UCS2BE_SM_MODEL = {'class_table': UCS2BE_CLS,
+                   'class_factor': 6,
+                   'state_table': UCS2BE_ST,
+                   'char_len_table': UCS2BE_CHAR_LEN_TABLE,
+                   'name': 'UTF-16BE'}
+
+# UCS2-LE
+
+UCS2LE_CLS = (
+    0,0,0,0,0,0,0,0,  # 00 - 07
+    0,0,1,0,0,2,0,0,  # 08 - 0f
+    0,0,0,0,0,0,0,0,  # 10 - 17
+    0,0,0,3,0,0,0,0,  # 18 - 1f
+    0,0,0,0,0,0,0,0,  # 20 - 27
+    0,3,3,3,3,3,0,0,  # 28 - 2f
+    0,0,0,0,0,0,0,0,  # 30 - 37
+    0,0,0,0,0,0,0,0,  # 38 - 3f
+    0,0,0,0,0,0,0,0,  # 40 - 47
+    0,0,0,0,0,0,0,0,  # 48 - 4f
+    0,0,0,0,0,0,0,0,  # 50 - 57
+    0,0,0,0,0,0,0,0,  # 58 - 5f
+    0,0,0,0,0,0,0,0,  # 60 - 67
+    0,0,0,0,0,0,0,0,  # 68 - 6f
+    0,0,0,0,0,0,0,0,  # 70 - 77
+    0,0,0,0,0,0,0,0,  # 78 - 7f
+    0,0,0,0,0,0,0,0,  # 80 - 87
+    0,0,0,0,0,0,0,0,  # 88 - 8f
+    0,0,0,0,0,0,0,0,  # 90 - 97
+    0,0,0,0,0,0,0,0,  # 98 - 9f
+    0,0,0,0,0,0,0,0,  # a0 - a7
+    0,0,0,0,0,0,0,0,  # a8 - af
+    0,0,0,0,0,0,0,0,  # b0 - b7
+    0,0,0,0,0,0,0,0,  # b8 - bf
+    0,0,0,0,0,0,0,0,  # c0 - c7
+    0,0,0,0,0,0,0,0,  # c8 - cf
+    0,0,0,0,0,0,0,0,  # d0 - d7
+    0,0,0,0,0,0,0,0,  # d8 - df
+    0,0,0,0,0,0,0,0,  # e0 - e7
+    0,0,0,0,0,0,0,0,  # e8 - ef
+    0,0,0,0,0,0,0,0,  # f0 - f7
+    0,0,0,0,0,0,4,5   # f8 - ff
+)
+
+UCS2LE_ST = (
+          6,     6,     7,     6,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
+     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
+     MachineState.ITS_ME,MachineState.ITS_ME,     5,     5,     5,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#10-17
+          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,     6,     6,#18-1f
+          7,     6,     8,     8,     5,     5,     5,MachineState.ERROR,#20-27
+          5,     5,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,#28-2f
+          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,MachineState.START,MachineState.START #30-37
+)
+
+UCS2LE_CHAR_LEN_TABLE = (2, 2, 2, 2, 2, 2)
+
+UCS2LE_SM_MODEL = {'class_table': UCS2LE_CLS,
+                 'class_factor': 6,
+                 'state_table': UCS2LE_ST,
+                 'char_len_table': UCS2LE_CHAR_LEN_TABLE,
+                 'name': 'UTF-16LE'}
+
+# UTF-8
+
+UTF8_CLS = (
+    1,1,1,1,1,1,1,1,  # 00 - 07  #allow 0x00 as a legal value
+    1,1,1,1,1,1,0,0,  # 08 - 0f
+    1,1,1,1,1,1,1,1,  # 10 - 17
+    1,1,1,0,1,1,1,1,  # 18 - 1f
+    1,1,1,1,1,1,1,1,  # 20 - 27
+    1,1,1,1,1,1,1,1,  # 28 - 2f
+    1,1,1,1,1,1,1,1,  # 30 - 37
+    1,1,1,1,1,1,1,1,  # 38 - 3f
+    1,1,1,1,1,1,1,1,  # 40 - 47
+    1,1,1,1,1,1,1,1,  # 48 - 4f
+    1,1,1,1,1,1,1,1,  # 50 - 57
+    1,1,1,1,1,1,1,1,  # 58 - 5f
+    1,1,1,1,1,1,1,1,  # 60 - 67
+    1,1,1,1,1,1,1,1,  # 68 - 6f
+    1,1,1,1,1,1,1,1,  # 70 - 77
+    1,1,1,1,1,1,1,1,  # 78 - 7f
+    2,2,2,2,3,3,3,3,  # 80 - 87
+    4,4,4,4,4,4,4,4,  # 88 - 8f
+    4,4,4,4,4,4,4,4,  # 90 - 97
+    4,4,4,4,4,4,4,4,  # 98 - 9f
+    5,5,5,5,5,5,5,5,  # a0 - a7
+    5,5,5,5,5,5,5,5,  # a8 - af
+    5,5,5,5,5,5,5,5,  # b0 - b7
+    5,5,5,5,5,5,5,5,  # b8 - bf
+    0,0,6,6,6,6,6,6,  # c0 - c7
+    6,6,6,6,6,6,6,6,  # c8 - cf
+    6,6,6,6,6,6,6,6,  # d0 - d7
+    6,6,6,6,6,6,6,6,  # d8 - df
+    7,8,8,8,8,8,8,8,  # e0 - e7
+    8,8,8,8,8,9,8,8,  # e8 - ef
+    10,11,11,11,11,11,11,11,  # f0 - f7
+    12,13,13,13,14,15,0,0    # f8 - ff
+)
+
+UTF8_ST = (
+    MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     12,   10,#00-07
+         9,     11,     8,     7,     6,     5,     4,    3,#08-0f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#20-27
+    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#28-2f
+    MachineState.ERROR,MachineState.ERROR,     5,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#30-37
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#38-3f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#40-47
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#48-4f
+    MachineState.ERROR,MachineState.ERROR,     7,     7,     7,     7,MachineState.ERROR,MachineState.ERROR,#50-57
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#58-5f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     7,     7,MachineState.ERROR,MachineState.ERROR,#60-67
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#68-6f
+    MachineState.ERROR,MachineState.ERROR,     9,     9,     9,     9,MachineState.ERROR,MachineState.ERROR,#70-77
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#78-7f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     9,MachineState.ERROR,MachineState.ERROR,#80-87
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#88-8f
+    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,#90-97
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#98-9f
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,    12,MachineState.ERROR,MachineState.ERROR,#a0-a7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#a8-af
+    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b0-b7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b8-bf
+    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,#c0-c7
+    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR #c8-cf
+)
+
+UTF8_CHAR_LEN_TABLE = (0, 1, 0, 0, 0, 0, 2, 3, 3, 3, 4, 4, 5, 5, 6, 6)
+
+UTF8_SM_MODEL = {'class_table': UTF8_CLS,
+                 'class_factor': 16,
+                 'state_table': UTF8_ST,
+                 'char_len_table': UTF8_CHAR_LEN_TABLE,
+                 'name': 'UTF-8'}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcharsetprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcharsetprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..0adb51de5a210aa36849cd149ed0f4ae424fce42
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcharsetprober.py
@@ -0,0 +1,132 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import CharacterCategory, ProbingState, SequenceLikelihood
+
+
+class SingleByteCharSetProber(CharSetProber):
+    SAMPLE_SIZE = 64
+    SB_ENOUGH_REL_THRESHOLD = 1024  #  0.25 * SAMPLE_SIZE^2
+    POSITIVE_SHORTCUT_THRESHOLD = 0.95
+    NEGATIVE_SHORTCUT_THRESHOLD = 0.05
+
+    def __init__(self, model, reversed=False, name_prober=None):
+        super(SingleByteCharSetProber, self).__init__()
+        self._model = model
+        # TRUE if we need to reverse every pair in the model lookup
+        self._reversed = reversed
+        # Optional auxiliary prober for name decision
+        self._name_prober = name_prober
+        self._last_order = None
+        self._seq_counters = None
+        self._total_seqs = None
+        self._total_char = None
+        self._freq_char = None
+        self.reset()
+
+    def reset(self):
+        super(SingleByteCharSetProber, self).reset()
+        # char order of last character
+        self._last_order = 255
+        self._seq_counters = [0] * SequenceLikelihood.get_num_categories()
+        self._total_seqs = 0
+        self._total_char = 0
+        # characters that fall in our sampling range
+        self._freq_char = 0
+
+    @property
+    def charset_name(self):
+        if self._name_prober:
+            return self._name_prober.charset_name
+        else:
+            return self._model['charset_name']
+
+    @property
+    def language(self):
+        if self._name_prober:
+            return self._name_prober.language
+        else:
+            return self._model.get('language')
+
+    def feed(self, byte_str):
+        if not self._model['keep_english_letter']:
+            byte_str = self.filter_international_words(byte_str)
+        if not byte_str:
+            return self.state
+        char_to_order_map = self._model['char_to_order_map']
+        for i, c in enumerate(byte_str):
+            # XXX: Order is in range 1-64, so one would think we want 0-63 here,
+            #      but that leads to 27 more test failures than before.
+            order = char_to_order_map[c]
+            # XXX: This was SYMBOL_CAT_ORDER before, with a value of 250, but
+            #      CharacterCategory.SYMBOL is actually 253, so we use CONTROL
+            #      to make it closer to the original intent. The only difference
+            #      is whether or not we count digits and control characters for
+            #      _total_char purposes.
+            if order < CharacterCategory.CONTROL:
+                self._total_char += 1
+            if order < self.SAMPLE_SIZE:
+                self._freq_char += 1
+                if self._last_order < self.SAMPLE_SIZE:
+                    self._total_seqs += 1
+                    if not self._reversed:
+                        i = (self._last_order * self.SAMPLE_SIZE) + order
+                        model = self._model['precedence_matrix'][i]
+                    else:  # reverse the order of the letters in the lookup
+                        i = (order * self.SAMPLE_SIZE) + self._last_order
+                        model = self._model['precedence_matrix'][i]
+                    self._seq_counters[model] += 1
+            self._last_order = order
+
+        charset_name = self._model['charset_name']
+        if self.state == ProbingState.DETECTING:
+            if self._total_seqs > self.SB_ENOUGH_REL_THRESHOLD:
+                confidence = self.get_confidence()
+                if confidence > self.POSITIVE_SHORTCUT_THRESHOLD:
+                    self.logger.debug('%s confidence = %s, we have a winner',
+                                      charset_name, confidence)
+                    self._state = ProbingState.FOUND_IT
+                elif confidence < self.NEGATIVE_SHORTCUT_THRESHOLD:
+                    self.logger.debug('%s confidence = %s, below negative '
+                                      'shortcut threshhold %s', charset_name,
+                                      confidence,
+                                      self.NEGATIVE_SHORTCUT_THRESHOLD)
+                    self._state = ProbingState.NOT_ME
+
+        return self.state
+
+    def get_confidence(self):
+        r = 0.01
+        if self._total_seqs > 0:
+            r = ((1.0 * self._seq_counters[SequenceLikelihood.POSITIVE]) /
+                 self._total_seqs / self._model['typical_positive_ratio'])
+            r = r * self._freq_char / self._total_char
+            if r >= 1.0:
+                r = 0.99
+        return r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcsgroupprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcsgroupprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..98e95dc1a3cbc65e97bc726ab7000955132719dd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sbcsgroupprober.py
@@ -0,0 +1,73 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetgroupprober import CharSetGroupProber
+from .sbcharsetprober import SingleByteCharSetProber
+from .langcyrillicmodel import (Win1251CyrillicModel, Koi8rModel,
+                                Latin5CyrillicModel, MacCyrillicModel,
+                                Ibm866Model, Ibm855Model)
+from .langgreekmodel import Latin7GreekModel, Win1253GreekModel
+from .langbulgarianmodel import Latin5BulgarianModel, Win1251BulgarianModel
+# from .langhungarianmodel import Latin2HungarianModel, Win1250HungarianModel
+from .langthaimodel import TIS620ThaiModel
+from .langhebrewmodel import Win1255HebrewModel
+from .hebrewprober import HebrewProber
+from .langturkishmodel import Latin5TurkishModel
+
+
+class SBCSGroupProber(CharSetGroupProber):
+    def __init__(self):
+        super(SBCSGroupProber, self).__init__()
+        self.probers = [
+            SingleByteCharSetProber(Win1251CyrillicModel),
+            SingleByteCharSetProber(Koi8rModel),
+            SingleByteCharSetProber(Latin5CyrillicModel),
+            SingleByteCharSetProber(MacCyrillicModel),
+            SingleByteCharSetProber(Ibm866Model),
+            SingleByteCharSetProber(Ibm855Model),
+            SingleByteCharSetProber(Latin7GreekModel),
+            SingleByteCharSetProber(Win1253GreekModel),
+            SingleByteCharSetProber(Latin5BulgarianModel),
+            SingleByteCharSetProber(Win1251BulgarianModel),
+            # TODO: Restore Hungarian encodings (iso-8859-2 and windows-1250)
+            #       after we retrain model.
+            # SingleByteCharSetProber(Latin2HungarianModel),
+            # SingleByteCharSetProber(Win1250HungarianModel),
+            SingleByteCharSetProber(TIS620ThaiModel),
+            SingleByteCharSetProber(Latin5TurkishModel),
+        ]
+        hebrew_prober = HebrewProber()
+        logical_hebrew_prober = SingleByteCharSetProber(Win1255HebrewModel,
+                                                        False, hebrew_prober)
+        visual_hebrew_prober = SingleByteCharSetProber(Win1255HebrewModel, True,
+                                                       hebrew_prober)
+        hebrew_prober.set_model_probers(logical_hebrew_prober, visual_hebrew_prober)
+        self.probers.extend([hebrew_prober, logical_hebrew_prober,
+                             visual_hebrew_prober])
+
+        self.reset()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sjisprober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sjisprober.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e29623bdc54a7c6d11bcc167d71bb44cc9be39d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/sjisprober.py
@@ -0,0 +1,92 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .mbcharsetprober import MultiByteCharSetProber
+from .codingstatemachine import CodingStateMachine
+from .chardistribution import SJISDistributionAnalysis
+from .jpcntx import SJISContextAnalysis
+from .mbcssm import SJIS_SM_MODEL
+from .enums import ProbingState, MachineState
+
+
+class SJISProber(MultiByteCharSetProber):
+    def __init__(self):
+        super(SJISProber, self).__init__()
+        self.coding_sm = CodingStateMachine(SJIS_SM_MODEL)
+        self.distribution_analyzer = SJISDistributionAnalysis()
+        self.context_analyzer = SJISContextAnalysis()
+        self.reset()
+
+    def reset(self):
+        super(SJISProber, self).reset()
+        self.context_analyzer.reset()
+
+    @property
+    def charset_name(self):
+        return self.context_analyzer.charset_name
+
+    @property
+    def language(self):
+        return "Japanese"
+
+    def feed(self, byte_str):
+        for i in range(len(byte_str)):
+            coding_state = self.coding_sm.next_state(byte_str[i])
+            if coding_state == MachineState.ERROR:
+                self.logger.debug('%s %s prober hit error at byte %s',
+                                  self.charset_name, self.language, i)
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                char_len = self.coding_sm.get_current_charlen()
+                if i == 0:
+                    self._last_char[1] = byte_str[0]
+                    self.context_analyzer.feed(self._last_char[2 - char_len:],
+                                               char_len)
+                    self.distribution_analyzer.feed(self._last_char, char_len)
+                else:
+                    self.context_analyzer.feed(byte_str[i + 1 - char_len:i + 3
+                                                        - char_len], char_len)
+                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
+                                                    char_len)
+
+        self._last_char[0] = byte_str[-1]
+
+        if self.state == ProbingState.DETECTING:
+            if (self.context_analyzer.got_enough_data() and
+               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        context_conf = self.context_analyzer.get_confidence()
+        distrib_conf = self.distribution_analyzer.get_confidence()
+        return max(context_conf, distrib_conf)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/universaldetector.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/universaldetector.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b4e92d6158527736e3d14d6f725edada8f94b00
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/universaldetector.py
@@ -0,0 +1,286 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is Mozilla Universal charset detector code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 2001
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#   Shy Shalom - original C code
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+"""
+Module containing the UniversalDetector detector class, which is the primary
+class a user of ``chardet`` should use.
+
+:author: Mark Pilgrim (initial port to Python)
+:author: Shy Shalom (original C code)
+:author: Dan Blanchard (major refactoring for 3.0)
+:author: Ian Cordasco
+"""
+
+
+import codecs
+import logging
+import re
+
+from .charsetgroupprober import CharSetGroupProber
+from .enums import InputState, LanguageFilter, ProbingState
+from .escprober import EscCharSetProber
+from .latin1prober import Latin1Prober
+from .mbcsgroupprober import MBCSGroupProber
+from .sbcsgroupprober import SBCSGroupProber
+
+
+class UniversalDetector(object):
+    """
+    The ``UniversalDetector`` class underlies the ``chardet.detect`` function
+    and coordinates all of the different charset probers.
+
+    To get a ``dict`` containing an encoding and its confidence, you can simply
+    run:
+
+    .. code::
+
+            u = UniversalDetector()
+            u.feed(some_bytes)
+            u.close()
+            detected = u.result
+
+    """
+
+    MINIMUM_THRESHOLD = 0.20
+    HIGH_BYTE_DETECTOR = re.compile(b'[\x80-\xFF]')
+    ESC_DETECTOR = re.compile(b'(\033|~{)')
+    WIN_BYTE_DETECTOR = re.compile(b'[\x80-\x9F]')
+    ISO_WIN_MAP = {'iso-8859-1': 'Windows-1252',
+                   'iso-8859-2': 'Windows-1250',
+                   'iso-8859-5': 'Windows-1251',
+                   'iso-8859-6': 'Windows-1256',
+                   'iso-8859-7': 'Windows-1253',
+                   'iso-8859-8': 'Windows-1255',
+                   'iso-8859-9': 'Windows-1254',
+                   'iso-8859-13': 'Windows-1257'}
+
+    def __init__(self, lang_filter=LanguageFilter.ALL):
+        self._esc_charset_prober = None
+        self._charset_probers = []
+        self.result = None
+        self.done = None
+        self._got_data = None
+        self._input_state = None
+        self._last_char = None
+        self.lang_filter = lang_filter
+        self.logger = logging.getLogger(__name__)
+        self._has_win_bytes = None
+        self.reset()
+
+    def reset(self):
+        """
+        Reset the UniversalDetector and all of its probers back to their
+        initial states.  This is called by ``__init__``, so you only need to
+        call this directly in between analyses of different documents.
+        """
+        self.result = {'encoding': None, 'confidence': 0.0, 'language': None}
+        self.done = False
+        self._got_data = False
+        self._has_win_bytes = False
+        self._input_state = InputState.PURE_ASCII
+        self._last_char = b''
+        if self._esc_charset_prober:
+            self._esc_charset_prober.reset()
+        for prober in self._charset_probers:
+            prober.reset()
+
+    def feed(self, byte_str):
+        """
+        Takes a chunk of a document and feeds it through all of the relevant
+        charset probers.
+
+        After calling ``feed``, you can check the value of the ``done``
+        attribute to see if you need to continue feeding the
+        ``UniversalDetector`` more data, or if it has made a prediction
+        (in the ``result`` attribute).
+
+        .. note::
+           You should always call ``close`` when you're done feeding in your
+           document if ``done`` is not already ``True``.
+        """
+        if self.done:
+            return
+
+        if not len(byte_str):
+            return
+
+        if not isinstance(byte_str, bytearray):
+            byte_str = bytearray(byte_str)
+
+        # First check for known BOMs, since these are guaranteed to be correct
+        if not self._got_data:
+            # If the data starts with BOM, we know it is UTF
+            if byte_str.startswith(codecs.BOM_UTF8):
+                # EF BB BF  UTF-8 with BOM
+                self.result = {'encoding': "UTF-8-SIG",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith((codecs.BOM_UTF32_LE,
+                                      codecs.BOM_UTF32_BE)):
+                # FF FE 00 00  UTF-32, little-endian BOM
+                # 00 00 FE FF  UTF-32, big-endian BOM
+                self.result = {'encoding': "UTF-32",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith(b'\xFE\xFF\x00\x00'):
+                # FE FF 00 00  UCS-4, unusual octet order BOM (3412)
+                self.result = {'encoding': "X-ISO-10646-UCS-4-3412",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith(b'\x00\x00\xFF\xFE'):
+                # 00 00 FF FE  UCS-4, unusual octet order BOM (2143)
+                self.result = {'encoding': "X-ISO-10646-UCS-4-2143",
+                               'confidence': 1.0,
+                               'language': ''}
+            elif byte_str.startswith((codecs.BOM_LE, codecs.BOM_BE)):
+                # FF FE  UTF-16, little endian BOM
+                # FE FF  UTF-16, big endian BOM
+                self.result = {'encoding': "UTF-16",
+                               'confidence': 1.0,
+                               'language': ''}
+
+            self._got_data = True
+            if self.result['encoding'] is not None:
+                self.done = True
+                return
+
+        # If none of those matched and we've only see ASCII so far, check
+        # for high bytes and escape sequences
+        if self._input_state == InputState.PURE_ASCII:
+            if self.HIGH_BYTE_DETECTOR.search(byte_str):
+                self._input_state = InputState.HIGH_BYTE
+            elif self._input_state == InputState.PURE_ASCII and \
+                    self.ESC_DETECTOR.search(self._last_char + byte_str):
+                self._input_state = InputState.ESC_ASCII
+
+        self._last_char = byte_str[-1:]
+
+        # If we've seen escape sequences, use the EscCharSetProber, which
+        # uses a simple state machine to check for known escape sequences in
+        # HZ and ISO-2022 encodings, since those are the only encodings that
+        # use such sequences.
+        if self._input_state == InputState.ESC_ASCII:
+            if not self._esc_charset_prober:
+                self._esc_charset_prober = EscCharSetProber(self.lang_filter)
+            if self._esc_charset_prober.feed(byte_str) == ProbingState.FOUND_IT:
+                self.result = {'encoding':
+                               self._esc_charset_prober.charset_name,
+                               'confidence':
+                               self._esc_charset_prober.get_confidence(),
+                               'language':
+                               self._esc_charset_prober.language}
+                self.done = True
+        # If we've seen high bytes (i.e., those with values greater than 127),
+        # we need to do more complicated checks using all our multi-byte and
+        # single-byte probers that are left.  The single-byte probers
+        # use character bigram distributions to determine the encoding, whereas
+        # the multi-byte probers use a combination of character unigram and
+        # bigram distributions.
+        elif self._input_state == InputState.HIGH_BYTE:
+            if not self._charset_probers:
+                self._charset_probers = [MBCSGroupProber(self.lang_filter)]
+                # If we're checking non-CJK encodings, use single-byte prober
+                if self.lang_filter & LanguageFilter.NON_CJK:
+                    self._charset_probers.append(SBCSGroupProber())
+                self._charset_probers.append(Latin1Prober())
+            for prober in self._charset_probers:
+                if prober.feed(byte_str) == ProbingState.FOUND_IT:
+                    self.result = {'encoding': prober.charset_name,
+                                   'confidence': prober.get_confidence(),
+                                   'language': prober.language}
+                    self.done = True
+                    break
+            if self.WIN_BYTE_DETECTOR.search(byte_str):
+                self._has_win_bytes = True
+
+    def close(self):
+        """
+        Stop analyzing the current document and come up with a final
+        prediction.
+
+        :returns:  The ``result`` attribute, a ``dict`` with the keys
+                   `encoding`, `confidence`, and `language`.
+        """
+        # Don't bother with checks if we're already done
+        if self.done:
+            return self.result
+        self.done = True
+
+        if not self._got_data:
+            self.logger.debug('no data received!')
+
+        # Default to ASCII if it is all we've seen so far
+        elif self._input_state == InputState.PURE_ASCII:
+            self.result = {'encoding': 'ascii',
+                           'confidence': 1.0,
+                           'language': ''}
+
+        # If we have seen non-ASCII, return the best that met MINIMUM_THRESHOLD
+        elif self._input_state == InputState.HIGH_BYTE:
+            prober_confidence = None
+            max_prober_confidence = 0.0
+            max_prober = None
+            for prober in self._charset_probers:
+                if not prober:
+                    continue
+                prober_confidence = prober.get_confidence()
+                if prober_confidence > max_prober_confidence:
+                    max_prober_confidence = prober_confidence
+                    max_prober = prober
+            if max_prober and (max_prober_confidence > self.MINIMUM_THRESHOLD):
+                charset_name = max_prober.charset_name
+                lower_charset_name = max_prober.charset_name.lower()
+                confidence = max_prober.get_confidence()
+                # Use Windows encoding name instead of ISO-8859 if we saw any
+                # extra Windows-specific bytes
+                if lower_charset_name.startswith('iso-8859'):
+                    if self._has_win_bytes:
+                        charset_name = self.ISO_WIN_MAP.get(lower_charset_name,
+                                                            charset_name)
+                self.result = {'encoding': charset_name,
+                               'confidence': confidence,
+                               'language': max_prober.language}
+
+        # Log all prober confidences if none met MINIMUM_THRESHOLD
+        if self.logger.getEffectiveLevel() == logging.DEBUG:
+            if self.result['encoding'] is None:
+                self.logger.debug('no probers hit minimum threshold')
+                for group_prober in self._charset_probers:
+                    if not group_prober:
+                        continue
+                    if isinstance(group_prober, CharSetGroupProber):
+                        for prober in group_prober.probers:
+                            self.logger.debug('%s %s confidence = %s',
+                                              prober.charset_name,
+                                              prober.language,
+                                              prober.get_confidence())
+                    else:
+                        self.logger.debug('%s %s confidence = %s',
+                                          prober.charset_name,
+                                          prober.language,
+                                          prober.get_confidence())
+        return self.result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/utf8prober.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/utf8prober.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c3196cc2d7e46e6756580267f5643c6f7b448dd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/utf8prober.py
@@ -0,0 +1,82 @@
+######################## BEGIN LICENSE BLOCK ########################
+# The Original Code is mozilla.org code.
+#
+# The Initial Developer of the Original Code is
+# Netscape Communications Corporation.
+# Portions created by the Initial Developer are Copyright (C) 1998
+# the Initial Developer. All Rights Reserved.
+#
+# Contributor(s):
+#   Mark Pilgrim - port to Python
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+# 02110-1301  USA
+######################### END LICENSE BLOCK #########################
+
+from .charsetprober import CharSetProber
+from .enums import ProbingState, MachineState
+from .codingstatemachine import CodingStateMachine
+from .mbcssm import UTF8_SM_MODEL
+
+
+
+class UTF8Prober(CharSetProber):
+    ONE_CHAR_PROB = 0.5
+
+    def __init__(self):
+        super(UTF8Prober, self).__init__()
+        self.coding_sm = CodingStateMachine(UTF8_SM_MODEL)
+        self._num_mb_chars = None
+        self.reset()
+
+    def reset(self):
+        super(UTF8Prober, self).reset()
+        self.coding_sm.reset()
+        self._num_mb_chars = 0
+
+    @property
+    def charset_name(self):
+        return "utf-8"
+
+    @property
+    def language(self):
+        return ""
+
+    def feed(self, byte_str):
+        for c in byte_str:
+            coding_state = self.coding_sm.next_state(c)
+            if coding_state == MachineState.ERROR:
+                self._state = ProbingState.NOT_ME
+                break
+            elif coding_state == MachineState.ITS_ME:
+                self._state = ProbingState.FOUND_IT
+                break
+            elif coding_state == MachineState.START:
+                if self.coding_sm.get_current_charlen() >= 2:
+                    self._num_mb_chars += 1
+
+        if self.state == ProbingState.DETECTING:
+            if self.get_confidence() > self.SHORTCUT_THRESHOLD:
+                self._state = ProbingState.FOUND_IT
+
+        return self.state
+
+    def get_confidence(self):
+        unlike = 0.99
+        if self._num_mb_chars < 6:
+            unlike *= self.ONE_CHAR_PROB ** self._num_mb_chars
+            return 1.0 - unlike
+        else:
+            return unlike
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..bb2a34a70ea760ad1f58979acfc8fa466e30c511
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/chardet/version.py
@@ -0,0 +1,9 @@
+"""
+This module exists only to simplify retrieving the version number of chardet
+from within setup.py and from chardet subpackages.
+
+:author: Dan Blanchard (dan.blanchard@gmail.com)
+"""
+
+__version__ = "3.0.4"
+VERSION = __version__.split('.')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..ad14c77137c4111a12f8c66870017c486a233b10
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/METADATA
@@ -0,0 +1,184 @@
+Metadata-Version: 2.1
+Name: charmcraft
+Version: 0.8.1
+Summary: The main tool to build, upload, and develop in general the Juju charms.
+Home-page: https://github.com/canonical/charmcraft
+Author: Facundo Batista
+Author-email: facundo.batista@canonical.com
+License: Apache-2.0
+Platform: UNKNOWN
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3
+Description-Content-Type: text/markdown
+Requires-Dist: Jinja2 (==2.11.2)
+Requires-Dist: PyYAML (==5.3.1)
+Requires-Dist: appdirs (==1.4.4)
+Requires-Dist: attrs (==20.3.0)
+Requires-Dist: jsonschema (==3.2.0)
+Requires-Dist: macaroonbakery (==1.3.1)
+Requires-Dist: python-dateutil (==2.8.1)
+Requires-Dist: requests-toolbelt (==0.9.1)
+Requires-Dist: requests (==2.24.0)
+Requires-Dist: tabulate (==0.8.7)
+
+# Charmcraft is for Kubernetes operator developers
+
+Charmcraft supports Kubernetes operator development.
+
+Charmcraft enables collaboration between operator developers, and
+publication on [Charmhub](https://charmhub.io/), home of the Open Operator
+Collection.
+
+Use `charmcraft` to:
+
+ * Init a new charm file structure
+ * Build your operator into a charm for distribution
+ * Register your charm name on Charmhub
+ * Upload your charms to Charmhub
+ * Release your charms into channels
+
+You can use charmcraft with operators written in any language but we
+recommend the [Python Operator Framework on
+Github](https://github.com/canonical/operator) which is also [on
+PyPI](https://pypi.org/project/ops/) for ease of development and
+collaboration.
+
+Charmcraft and the Python Operator Framework extend the operator pattern
+beyond Kubernetes with [universal
+operators](https://juju.is/universal-operators) that drive Linux and
+Windows apps. The universal operator pattern is very exciting for
+multi-cloud application management.
+
+## Install
+
+The easiest way to install `charmcraft` is with
+
+    sudo snap install charmcraft --beta
+
+There are multiple channels other than `--beta`. See the full list with
+`snap info charmcraft`. We recommend either `latest/stable` or `latest/beta`
+for everyday charming. With the snap you will always be up to date as
+Charmhub services and APIs evolve.
+
+You can also install from PyPI with `pip3 install --user charmcraft`
+
+## Initialize a charm operator package file structure
+
+Use `charmcraft init` to create a new template charm operator file tree:
+
+```bash
+$ mkdir my-new-charm; cd my-new-charm
+$ charmcraft init
+All done.
+There are some notes about things we think you should do.
+These are marked with ‘TODO:’, as is customary. Namely:
+      README.md: fill out the description
+      README.md: explain how to use the charm
+  metadata.yaml: fill out the charm's description
+  metadata.yaml: fill out the charm's summary
+```
+
+You will now have all the essential files for a charmed operator, including
+the actual `src/charm.py` skeleton and various items of metadata. Charmcraft
+assumes you want to work in Python so it will add `requirements.txt` with
+the Python operator framework `ops`, and other conventional development
+support files.
+
+## Build your charm
+
+With a correct `metadata.yaml` and with `ops` in `requirements.txt` you can
+build a charm with:
+
+```text
+$ charmcraft build
+Created 'test-charm.charm'.
+```
+
+`charmcraft build` will fetch additional files into the tree from PyPI based
+on `requirements.txt` and will compile modules using a virtualenv.
+
+The charm is just a zipfile with metadata and the operator code itself:
+
+```text
+$ unzip -l test-charm.charm
+Archive:  test-charm.charm
+  Length      Date    Time    Name
+---------  ---------- -----   ----
+      221  2020-11-15 08:10   metadata.yaml
+[...]
+    25304  2020-11-15 08:14   venv/yaml/__pycache__/scanner.cpython-38.pyc
+---------                     -------
+   812617                     84 files
+```
+
+Now, if you have a Kubernetes cluster with the Juju OLM accessible you can
+directly `juju deploy <test-charm.charm>` to the cluster. You do not need to
+publish your operator on Charmhub, you can pass the charm file around
+directly to users, or for CI/CD purposes.
+
+## Charmhub login and charm name reservations
+
+[Charmhub](https://charmhub.io/) is the world's largest repository of
+operators.  It makes it easy to share and collaborate on operators. The
+community are interested in operators for a very wide range of purposes,
+including infrastructure-as-code and legacy application management, and of
+course Kubernetes operators.
+
+Use `charmcraft login` and `charmcraft logout` to sign into Charmhub.
+
+## Charmhub name registration
+
+You can register operator names in Charmhub with `charmcraft register
+<name>`. Many common names have been reserved, you are encouraged to discuss
+your interest in leading or collaborating on a charm in [Charmhub
+Discourse](https://discourse.charmhub.io/).
+
+Charmhub naming policy is the principle of least surprise - a well-known
+name should map to an operator that most people would expect to get for that
+name.
+
+Operators in Charmhub can be renamed as needed, so feel free to register a
+temporary name, such as <username>-<charmname> as a placeholder.
+
+## Operator upload and release
+
+Charmhub operators are published in channels, like:
+
+```text
+latest/stable
+latest/candidate
+latest/beta
+latest/edge
+1.3/beta
+1.3/edge
+1.2/stable
+1.2/candidate
+1.0/stable
+```
+
+Use `charmcraft upload` to get a new revision number for your freshly built
+charm, and `charmcraft release` to release a revision into any particular
+channel for your users.
+
+# Charmcraft source
+
+Get the source from github with:
+
+    git clone https://github.com/canonical/charmcraft.git
+    cd charmcraft
+    virtualenv venv
+    . venv/bin/activate
+    pip install -r requirements.txt
+    python -m charmcraft
+
+If you would like to run the tests you can do so with
+
+    pip install -r requirements-dev.txt
+    ./run_tests
+
+Contributions welcome!
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f647a035fc59ec815e424c33b786a5e4a2dcf528
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/RECORD
@@ -0,0 +1,60 @@
+../../../bin/charmcraft,sha256=fAaIBsliYVWVXzAYVjcVYridqqw0bPQK50dmRbE-RIk,293
+charmcraft-0.8.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+charmcraft-0.8.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+charmcraft-0.8.1.dist-info/METADATA,sha256=5lgDbi7x0cy_yZBVDkwH5THtStmFeX5Ml0z6MhJV4Mw,5960
+charmcraft-0.8.1.dist-info/RECORD,,
+charmcraft-0.8.1.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+charmcraft-0.8.1.dist-info/entry_points.txt,sha256=FdKmbFVt0I-CrHjl2mkwDf8fEx8GUIay0WIqdShVCoE,53
+charmcraft-0.8.1.dist-info/top_level.txt,sha256=ka37dQ3nvtNMpOvQhGWe3mn6HAXzkIyXk_sDS-_pqwg,11
+charmcraft/__init__.py,sha256=U0JaBQpFXw-eN4coTMHoAYL3ta6H3NhYzjcUwrTTvcM,778
+charmcraft/__main__.py,sha256=1E7b40xpslduLrUAy1SJJGrv0aiS_z9cOBo99Na_1jo,769
+charmcraft/__pycache__/__init__.cpython-38.pyc,,
+charmcraft/__pycache__/__main__.cpython-38.pyc,,
+charmcraft/__pycache__/cmdbase.cpython-38.pyc,,
+charmcraft/__pycache__/config.cpython-38.pyc,,
+charmcraft/__pycache__/helptexts.cpython-38.pyc,,
+charmcraft/__pycache__/jujuignore.cpython-38.pyc,,
+charmcraft/__pycache__/logsetup.cpython-38.pyc,,
+charmcraft/__pycache__/main.cpython-38.pyc,,
+charmcraft/__pycache__/utils.cpython-38.pyc,,
+charmcraft/__pycache__/version.cpython-38.pyc,,
+charmcraft/cmdbase.py,sha256=QLDNWfO_nEZsmo4CBe7uwcsntu-S00GvIw_mO3CgSh8,2868
+charmcraft/commands/__init__.py,sha256=LZ2OkKYoSMuPEKljK6kdFuR4weflnaCEkgnWU51_fuo,719
+charmcraft/commands/__pycache__/__init__.cpython-38.pyc,,
+charmcraft/commands/__pycache__/build.cpython-38.pyc,,
+charmcraft/commands/__pycache__/init.cpython-38.pyc,,
+charmcraft/commands/__pycache__/pack.cpython-38.pyc,,
+charmcraft/commands/__pycache__/utils.cpython-38.pyc,,
+charmcraft/commands/__pycache__/version.cpython-38.pyc,,
+charmcraft/commands/build.py,sha256=JqFYEE53ClwCHXi_KaWsrgfJNZNC1fmWvwzEgu_i0U4,15598
+charmcraft/commands/init.py,sha256=-ER6ibBYVM0t1QwU-rgVvzyFEnEpS2JI_cZxkfBcZBA,5756
+charmcraft/commands/pack.py,sha256=euv21xou4T5NTshqAErhktYCpa0_SI8o4BWhLwcBzzo,3465
+charmcraft/commands/store/__init__.py,sha256=nhWO4DIutpMvuhfirHXQdjo3IiHRlP5XvvMtFBoGq7c,37408
+charmcraft/commands/store/__pycache__/__init__.cpython-38.pyc,,
+charmcraft/commands/store/__pycache__/client.cpython-38.pyc,,
+charmcraft/commands/store/__pycache__/store.cpython-38.pyc,,
+charmcraft/commands/store/client.py,sha256=UCZus7S9Lef0pfNGc9XwFPktzHy7BCy9tPafptGg26w,10811
+charmcraft/commands/store/store.py,sha256=IrFDMxnbUJa-TgJb4acE9CJ6jn1qK4WPcs5kj04QHEQ,9756
+charmcraft/commands/utils.py,sha256=KtpKn0KcA_oRh03ccLp17_KAmIlu5qgsur8Y5RWoC6c,2205
+charmcraft/commands/version.py,sha256=0EYCsGFQh4Mt3LW5hkpGWtki9YCR02-pI_nfytaVEQg,1572
+charmcraft/config.py,sha256=eZfs5VBw1OMZU8hXTnemYkZXR5u2EhdPXiMaCFrm_ws,6730
+charmcraft/helptexts.py,sha256=6iWbDScQdLqajeXPVXf5oLIZ_oyDXU4NKPNrJyRJsbk,9143
+charmcraft/jujuignore.py,sha256=7ZQTyxeSzfj2LW-NB-AYxNunt0KN7tU5C45gCUdbe9w,6954
+charmcraft/logsetup.py,sha256=nkfnzexNZTVgEHp77skcDdhY1wXKLhfKtQRoJMeHGrQ,4303
+charmcraft/main.py,sha256=4Lbn9MNGjUQyXmrfx9YBSjIlhXHtaDu6Auj6GFWNE3M,12578
+charmcraft/templates/charmlibs/new_library.py.j2,sha256=_m3DD9Pppdi4AY5reBb-GBTklTvfoc3TKDASUdIhwK0,1028
+charmcraft/templates/init/.flake8.j2,sha256=yOvP97zjncARsnYbYuS_w-t_iVxGrBtw1FCC59spFyY,99
+charmcraft/templates/init/.jujuignore.j2,sha256=d3D298wbcb9lpzaJazhatEIPVe2Ad6wtWqQy7m5E28A,24
+charmcraft/templates/init/LICENSE.j2,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+charmcraft/templates/init/README.md.j2,sha256=zxVTpo1f9DgqObe7QbjZlvnTCe2Tq8CgyEKCtUiRx64,517
+charmcraft/templates/init/actions.yaml.j2,sha256=qenRrrPa-ktCVSNI-QszxXnvbYDeT6HRGedrgiyseAY,447
+charmcraft/templates/init/config.yaml.j2,sha256=IGe6LZ8H_Hdrbvk-R9huvEv9ndGmes0otlZH0VkTMpo,319
+charmcraft/templates/init/metadata.yaml.j2,sha256=_w0f5m5Usi_tLEu3XGoSUTbB3MIvOeNPWBBq_BFhDek,221
+charmcraft/templates/init/requirements-dev.txt.j2,sha256=k_Yz7UH3mvSaAIHSnZDUMB_jwKtyYd0B2BZ9kWt439c,36
+charmcraft/templates/init/requirements.txt.j2,sha256=enC05wWafSg8iDKIvj3gvtAtEP2kYCyN5Gmd689q-_I,4
+charmcraft/templates/init/run_tests.j2,sha256=HHNPI8NLJGkR65WqOmDdHikW5r_t9D6VFo3VNO6zKVk,340
+charmcraft/templates/init/src/charm.py.j2,sha256=6K9peWQyDAQM5iDzKqmjELWv-8ykKX-tWSQCeshMZrE,1531
+charmcraft/templates/init/tests/__init__.py.j2,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+charmcraft/templates/init/tests/test_charm.py.j2,sha256=ur5WN8-yoKI5_9Bbobs8_TauyBuLWV1EOn3a93sbYi4,1175
+charmcraft/utils.py,sha256=MHJzQH3JgTcpxhkfrR1TJG-UA7dI0_LsCEQiqQpot5M,2253
+charmcraft/version.py,sha256=HbQcNycvTh_GG9dkE3Cfg9zBZDRhdfe0iiVe9I18Msk,47
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..1d892b95ec32cc7169077c20d49122b7a66b2db3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+charmcraft = charmcraft.main:main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..8b826e4b45a3d1aeeb0ce928caddef6300dccd05
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft-0.8.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+charmcraft
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8420e7fe48adf694f12eca5029dc018d53c0fe08
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__init__.py
@@ -0,0 +1,19 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Expose needed names at main package level."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__main__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..68a3d121172e6d5b809773c6ea35b310bdbaac49
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/__main__.py
@@ -0,0 +1,23 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Init file to allow execution of charmcraft as a module."""
+
+import sys
+
+from charmcraft import main
+
+sys.exit(main.main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/cmdbase.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/cmdbase.py
new file mode 100644
index 0000000000000000000000000000000000000000..fcaba30645eb54f6873ccd7e2ce944164a5b8085
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/cmdbase.py
@@ -0,0 +1,81 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Infrastructure for common base commands functionality."""
+
+
+class CommandError(Exception):
+    """Base exception for all error commands.
+
+    It optionally receives a `retcode` parameter that will be the returned code
+    by the process on exit, and a `argsparsing` one to indicate that the problem
+    is in the command line usage.
+
+    XXX Facundo 2020-09-21: This will be refactored soon in the branch where all
+    output messages are standarized.
+    """
+
+    def __init__(self, message, retcode=1, argsparsing=False):
+        self.retcode = retcode
+        self.argsparsing = argsparsing
+        super().__init__(message)
+
+
+class BaseCommand:
+    """Base class to build charmcraft commands.
+
+    Subclass this to create a new command; the subclass must define the following attributes:
+
+    - name: the identifier in the command line
+    - help_msg: a one line help for user documentation
+    - common: if it's a common/starter command, which are prioritized in the help
+    - needs_config: will ensure a config is provided when executing the command
+
+    It also must/can override some methods for the proper command behaviour (see each
+    method's docstring).
+
+    The subclass must be declared in the corresponding section of main.COMMAND_GROUPS,
+    and will receive and store this group on instantiation (if overriding `__init__`, the
+    subclass must pass it through upwards).
+    """
+
+    name = None
+    help_msg = None
+    overview = None
+    common = False
+    needs_config = False
+
+    def __init__(self, group, config):
+        self.group = group
+        self.config = config
+
+    def fill_parser(self, parser):
+        """Specify command's specific parameters.
+
+        Each command parameters are independant of other commands, but note there are some
+        global ones (see `main.Dispatcher._build_argument_parser`).
+
+        If this method is not overriden, the command will not have any parameters.
+        """
+
+    def run(self, parsed_args):
+        """Execute command's actual functionality.
+
+        It must be overridden by the command implementation.
+
+        This will receive parsed arguments that were defined in :meth:.fill_parser.
+        """
+        raise NotImplementedError()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..85360b3784f1929cbb0cb04d2d873c19049c97e2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/__init__.py
@@ -0,0 +1,17 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Flag the sub package for files to be included when distributing."""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/build.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/build.py
new file mode 100644
index 0000000000000000000000000000000000000000..25775c650a9fa0fcfd8faf6cb4600992c96747e7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/build.py
@@ -0,0 +1,398 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Infrastructure for the 'build' command."""
+
+import errno
+import logging
+import os
+import pathlib
+import shutil
+import subprocess
+import zipfile
+
+import yaml
+
+from charmcraft.cmdbase import BaseCommand, CommandError
+from charmcraft.jujuignore import JujuIgnore, default_juju_ignore
+from charmcraft.utils import make_executable
+
+logger = logging.getLogger(__name__)
+
+# Some constants that are used through the code.
+CHARM_METADATA = 'metadata.yaml'
+BUILD_DIRNAME = 'build'
+VENV_DIRNAME = 'venv'
+
+# The file name and template for the dispatch script
+DISPATCH_FILENAME = 'dispatch'
+# If Juju doesn't support the dispatch mechanism, it will execute the
+# hook, and we'd need sys.argv[0] to be the name of the hook but it's
+# geting lost by calling this dispatch, so we fake JUJU_DISPATCH_PATH
+# to be the value it would've otherwise been.
+DISPATCH_CONTENT = """#!/bin/sh
+
+JUJU_DISPATCH_PATH="${{JUJU_DISPATCH_PATH:-$0}}" PYTHONPATH=lib:venv ./{entrypoint_relative_path}
+"""
+
+# The minimum set of hooks to be provided for compatibility with old Juju
+MANDATORY_HOOK_NAMES = {'install', 'start', 'upgrade-charm'}
+HOOKS_DIR = 'hooks'
+
+
+def _pip_needs_system():
+    """Determine whether pip3 defaults to --user, needing --system to turn it off."""
+    try:
+        from pip.commands.install import InstallCommand
+        return InstallCommand().cmd_opts.get_option('--system') is not None
+    except (ImportError, AttributeError, TypeError):
+        # probably not the bionic pip version then
+        return False
+
+
+def polite_exec(cmd):
+    """Execute a command, only showing output if error."""
+    logger.debug("Running external command %s", cmd)
+    try:
+        proc = subprocess.Popen(
+            cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, universal_newlines=True)
+    except Exception as err:
+        logger.error("Executing %s crashed with %r", cmd, err)
+        return 1
+
+    for line in proc.stdout:
+        logger.debug(":: %s", line.rstrip())
+    retcode = proc.wait()
+
+    if retcode:
+        logger.error("Executing %s failed with return code %d", cmd, retcode)
+    return retcode
+
+
+def relativise(src, dst):
+    """Build a relative path from src to dst."""
+    return pathlib.Path(os.path.relpath(str(dst), str(src.parent)))
+
+
+class Builder:
+    """The package builder."""
+
+    def __init__(self, args):
+        self.charmdir = args['from']
+        self.entrypoint = args['entrypoint']
+        self.requirement_paths = args['requirement']
+
+        self.buildpath = self.charmdir / BUILD_DIRNAME
+        self.ignore_rules = self._load_juju_ignore()
+
+    def run(self):
+        """Build the charm."""
+        logger.debug("Building charm in '%s'", self.buildpath)
+
+        if self.buildpath.exists():
+            shutil.rmtree(str(self.buildpath))
+        self.buildpath.mkdir()
+
+        linked_entrypoint = self.handle_generic_paths()
+        self.handle_dispatcher(linked_entrypoint)
+        self.handle_dependencies()
+        zipname = self.handle_package()
+
+        logger.info("Created '%s'.", zipname)
+        return zipname
+
+    def _load_juju_ignore(self):
+        ignore = JujuIgnore(default_juju_ignore)
+        path = self.charmdir / '.jujuignore'
+        if path.exists():
+            with path.open('r', encoding='utf-8') as ignores:
+                ignore.extend_patterns(ignores)
+        return ignore
+
+    def create_symlink(self, src_path, dest_path):
+        """Create a symlink in dest_path pointing relatively like src_path.
+
+        It also verifies that the linked dir or file is inside the project.
+        """
+        resolved_path = src_path.resolve()
+        if self.charmdir in resolved_path.parents:
+            relative_link = relativise(src_path, resolved_path)
+            dest_path.symlink_to(relative_link)
+        else:
+            rel_path = src_path.relative_to(self.charmdir)
+            logger.warning(
+                "Ignoring symlink because targets outside the project: '%s'", rel_path)
+
+    def handle_generic_paths(self):
+        """Handle all files and dirs except what's ignored and what will be handled later.
+
+        Works differently for the different file types:
+        - regular files: hard links
+        - directories: created
+        - symlinks: respected if are internal to the project
+        - other types (blocks, mount points, etc): ignored
+        """
+        logger.debug("Linking in generic paths")
+
+        for basedir, dirnames, filenames in os.walk(str(self.charmdir), followlinks=False):
+            abs_basedir = pathlib.Path(basedir)
+            rel_basedir = abs_basedir.relative_to(self.charmdir)
+
+            # process the directories
+            ignored = []
+            for pos, name in enumerate(dirnames):
+                rel_path = rel_basedir / name
+                abs_path = abs_basedir / name
+
+                if self.ignore_rules.match(str(rel_path), is_dir=True):
+                    logger.debug("Ignoring directory because of rules: '%s'", rel_path)
+                    ignored.append(pos)
+                elif abs_path.is_symlink():
+                    dest_path = self.buildpath / rel_path
+                    self.create_symlink(abs_path, dest_path)
+                else:
+                    dest_path = self.buildpath / rel_path
+                    dest_path.mkdir(mode=abs_path.stat().st_mode)
+
+            # in the future don't go inside ignored directories
+            for pos in reversed(ignored):
+                del dirnames[pos]
+
+            # process the files
+            for name in filenames:
+                rel_path = rel_basedir / name
+                abs_path = abs_basedir / name
+
+                if self.ignore_rules.match(str(rel_path), is_dir=False):
+                    logger.debug("Ignoring file because of rules: '%s'", rel_path)
+                elif abs_path.is_symlink():
+                    dest_path = self.buildpath / rel_path
+                    self.create_symlink(abs_path, dest_path)
+                elif abs_path.is_file():
+                    dest_path = self.buildpath / rel_path
+                    try:
+                        os.link(str(abs_path), str(dest_path))
+                    except PermissionError:
+                        # when not allowed to create hard links
+                        shutil.copy2(str(abs_path), str(dest_path))
+                    except OSError as e:
+                        if e.errno != errno.EXDEV:
+                            raise
+                        shutil.copy2(str(abs_path), str(dest_path))
+                else:
+                    logger.debug("Ignoring file because of type: '%s'", rel_path)
+
+        # the linked entrypoint is calculated here because it's when it's really in the build dir
+        linked_entrypoint = self.buildpath / self.entrypoint.relative_to(self.charmdir)
+        return linked_entrypoint
+
+    def handle_dispatcher(self, linked_entrypoint):
+        """Handle modern and classic dispatch mechanisms."""
+        # dispatch mechanism, create one if wasn't provided by the project
+        dispatch_path = self.buildpath / DISPATCH_FILENAME
+        if not dispatch_path.exists():
+            logger.debug("Creating the dispatch mechanism")
+            dispatch_content = DISPATCH_CONTENT.format(
+                entrypoint_relative_path=linked_entrypoint.relative_to(self.buildpath))
+            with dispatch_path.open("wt", encoding="utf8") as fh:
+                fh.write(dispatch_content)
+                make_executable(fh)
+
+        # bunch of symlinks, to support old juju: verify that any of the already included hooks
+        # in the directory is not linking directly to the entrypoint, and also check all the
+        # mandatory ones are present
+        dest_hookpath = self.buildpath / HOOKS_DIR
+        if not dest_hookpath.exists():
+            dest_hookpath.mkdir()
+
+        # get those built hooks that we need to replace because they are pointing to the
+        # entrypoint directly and we need to fix the environment in the middle
+        current_hooks_to_replace = []
+        for node in dest_hookpath.iterdir():
+            if node.resolve() == linked_entrypoint:
+                current_hooks_to_replace.append(node)
+                node.unlink()
+                logger.debug(
+                    "Replacing existing hook %r as it's a symlink to the entrypoint", node.name)
+
+        # include the mandatory ones and those we need to replace
+        hooknames = MANDATORY_HOOK_NAMES | {x.name for x in current_hooks_to_replace}
+        for hookname in hooknames:
+            logger.debug("Creating the %r hook script pointing to dispatch", hookname)
+            dest_hook = dest_hookpath / hookname
+            if not dest_hook.exists():
+                relative_link = relativise(dest_hook, dispatch_path)
+                dest_hook.symlink_to(relative_link)
+
+    def handle_dependencies(self):
+        """Handle from-directory and virtualenv dependencies."""
+        logger.debug("Installing dependencies")
+
+        # virtualenv with other dependencies (if any)
+        if self.requirement_paths:
+            retcode = polite_exec(['pip3', 'list'])
+            if retcode:
+                raise CommandError("problems using pip")
+
+            venvpath = self.buildpath / VENV_DIRNAME
+            cmd = [
+                'pip3', 'install',  # base command
+                '--target={}'.format(venvpath),  # put all the resulting files in that specific dir
+            ]
+            if _pip_needs_system():
+                logger.debug("adding --system to work around pip3 defaulting to --user")
+                cmd.append("--system")
+            for reqspath in self.requirement_paths:
+                cmd.append('--requirement={}'.format(reqspath))  # the dependencies file(s)
+            retcode = polite_exec(cmd)
+            if retcode:
+                raise CommandError("problems installing dependencies")
+
+    def handle_package(self):
+        """Handle the final package creation."""
+        logger.debug("Parsing the project's metadata")
+        with (self.charmdir / CHARM_METADATA).open('rt', encoding='utf8') as fh:
+            metadata = yaml.safe_load(fh)
+
+        logger.debug("Creating the package itself")
+        zipname = metadata['name'] + '.charm'
+        zipfh = zipfile.ZipFile(zipname, 'w', zipfile.ZIP_DEFLATED)
+        buildpath_str = str(self.buildpath)  # os.walk does not support pathlib in 3.5
+        for dirpath, dirnames, filenames in os.walk(buildpath_str, followlinks=True):
+            dirpath = pathlib.Path(dirpath)
+            for filename in filenames:
+                filepath = dirpath / filename
+                zipfh.write(str(filepath), str(filepath.relative_to(self.buildpath)))
+
+        zipfh.close()
+        return zipname
+
+
+class Validator:
+    """A validator of all received options."""
+
+    _options = [
+        'from',  # this needs to be processed first, as it's a base dir to find other files
+        'entrypoint',
+        'requirement',
+    ]
+
+    def __init__(self):
+        self.basedir = None  # this will be fulfilled when processing 'from'
+
+    def process(self, parsed_args):
+        """Process the received options."""
+        result = {}
+        for opt in self._options:
+            meth = getattr(self, 'validate_' + opt)
+            result[opt] = meth(getattr(parsed_args, opt, None))
+        return result
+
+    def validate_from(self, dirpath):
+        """Validate that the charm dir is there and yes, a directory."""
+        if dirpath is None:
+            dirpath = pathlib.Path.cwd()
+        else:
+            dirpath = dirpath.expanduser().absolute()
+
+        if not dirpath.exists():
+            raise CommandError("Charm directory was not found: {!r}".format(str(dirpath)))
+        if not dirpath.is_dir():
+            raise CommandError(
+                "Charm directory is not really a directory: {!r}".format(str(dirpath)))
+
+        self.basedir = dirpath
+        return dirpath
+
+    def validate_entrypoint(self, filepath):
+        """Validate that the entrypoint exists and is executable."""
+        if filepath is None:
+            filepath = self.basedir / 'src' / 'charm.py'
+        else:
+            filepath = filepath.expanduser().absolute()
+
+        if not filepath.exists():
+            raise CommandError("Charm entry point was not found: {!r}".format(str(filepath)))
+        if self.basedir not in filepath.parents:
+            raise CommandError(
+                "Charm entry point must be inside the project: {!r}".format(str(filepath)))
+        if not os.access(str(filepath), os.X_OK):  # access does not support pathlib in 3.5
+            raise CommandError(
+                "Charm entry point must be executable: {!r}".format(str(filepath)))
+        return filepath
+
+    def validate_requirement(self, filepaths):
+        """Validate that the given requirement(s) (if any) exist.
+
+        If not specified, default to requirements.txt if there.
+        """
+        if filepaths is None:
+            req = self.basedir / 'requirements.txt'
+            if req.exists() and os.access(str(req), os.R_OK):  # access doesn't support pathlib 3.5
+                return [req]
+            return []
+
+        filepaths = [x.expanduser().absolute() for x in filepaths]
+        for fpath in filepaths:
+            if not fpath.exists():
+                raise CommandError("the requirements file was not found: {!r}".format(str(fpath)))
+        return filepaths
+
+
+_overview = """
+Build a charm operator package.
+
+You can `juju deploy` the resulting `.charm` file directly, or upload it
+to Charmhub with `charmcraft upload`.
+
+You must be inside a charm directory with a valid `metadata.yaml`,
+`requirements.txt` including the `ops` package for the Python operator
+framework, and an operator entrypoint, usually `src/charm.py`.
+
+See `charmcraft init` to create a template charm directory structure.
+"""
+
+
+class BuildCommand(BaseCommand):
+    """Build the charm."""
+
+    name = 'build'
+    help_msg = "Build the charm"
+    overview = _overview
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            '-f', '--from', type=pathlib.Path,
+            help="Charm directory with metadata.yaml where the build "
+                 "takes place; defaults to '.'")
+        parser.add_argument(
+            '-e', '--entrypoint', type=pathlib.Path,
+            help="The executable which is the operator entry point; "
+                 "defaults to 'src/charm.py'")
+        parser.add_argument(
+            '-r', '--requirement', action='append', type=pathlib.Path,
+            help="File(s) listing needed PyPI dependencies (can be used multiple "
+                  "times); defaults to 'requirements.txt'")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        validator = Validator()
+        args = validator.process(parsed_args)
+        logger.debug("working arguments: %s", args)
+        builder = Builder(args)
+        builder.run()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/init.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/init.py
new file mode 100644
index 0000000000000000000000000000000000000000..04793e828ddcefe2a37d10c1357656425ba473c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/init.py
@@ -0,0 +1,145 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Infrastructure for the 'init' command."""
+
+import logging
+import os
+import pwd
+import re
+from datetime import date
+
+import yaml
+
+from charmcraft.cmdbase import BaseCommand, CommandError
+from charmcraft.utils import make_executable, get_templates_environment
+
+logger = logging.getLogger(__name__)
+
+_overview = """
+Initialize a charm operator package tree and files.
+
+This command will modify the directory to create the necessary files for a
+charm operator package. By default it will work in the current directory.
+It will setup the following tree of files and directories:
+
+.
+├── metadata.yaml        - Charm operator package description
+├── README.md            - Frontpage for your charmhub.io/charm/
+├── actions.yaml         - Day-2 action declarations, e.g. backup, restore
+├── config.yaml          - Config schema for your operator
+├── LICENSE              - Your charm license, we recommend Apache 2
+├── requirements.txt     - PyPI dependencies for your charm, with `ops`
+├── requirements-dev.txt - PyPI for development tooling, notably flake8
+├── run_tests
+├── src
+│   └── charm.py         - Minimal operator using Python operator framework
+└── tests
+    ├── __init__.py
+    └── test_charm.py
+
+You will need to edit at least metadata.yaml and README.md.
+
+Your minimal operator code is in src/charm.py which uses the Python operator
+framework from https://github.com/canonical/operator and there are some
+example tests with a harness to run them.
+"""
+
+
+class InitCommand(BaseCommand):
+    """Initialize a directory to be a charm project."""
+
+    name = "init"
+    help_msg = "Initialize a charm operator package tree and files"
+    overview = _overview
+    common = True
+
+    def fill_parser(self, parser):
+        """Specify command's specific parameters."""
+        parser.add_argument(
+            "--name",
+            help="The name of the charm; defaults to the directory name")
+        parser.add_argument(
+            "--author",
+            help="The charm author; defaults to the current user name per GECOS")
+        parser.add_argument(
+            "--series", default="kubernetes",
+            help="A comma-separated list of supported platform series;"
+            " defaults to 'kubernetes'")
+        parser.add_argument(
+            "-f", "--force", action="store_true",
+            help="Initialize even if the directory is not empty (will not overwrite files)")
+
+    def run(self, args):
+        """Execute command's actual functionality."""
+        if any(self.config.project.dirpath.iterdir()) and not args.force:
+            raise CommandError(
+                "{} is not empty (consider using --force to work on nonempty directories)"
+                .format(self.config.project.dirpath))
+        logger.debug("Using project directory '%s'", self.config.project.dirpath)
+
+        if args.author is None:
+            gecos = pwd.getpwuid(os.getuid()).pw_gecos.split(',', 1)[0]
+            if not gecos:
+                raise CommandError("Author not given, and nothing in GECOS field")
+            logger.debug("Setting author to %r from GECOS field", gecos)
+            args.author = gecos
+
+        if not args.name:
+            args.name = self.config.project.dirpath.name
+            logger.debug("Set project name to '%s'", args.name)
+
+        if not re.match(r"[a-z][a-z0-9-]*[a-z0-9]$", args.name):
+            raise CommandError("{} is not a valid charm name".format(args.name))
+
+        context = {
+            "name": args.name,
+            "author": args.author,
+            "year": date.today().year,
+            "class_name": "".join(re.split(r"\W+", args.name.title())) + "Charm",
+            "series": yaml.dump(args.series.split(","), default_flow_style=True),
+        }
+
+        env = get_templates_environment('init')
+
+        _todo_rx = re.compile("TODO: (.*)")
+        todos = []
+        executables = ["run_tests", "src/charm.py"]
+        for template_name in env.list_templates():
+            if not template_name.endswith(".j2"):
+                continue
+            template = env.get_template(template_name)
+            template_name = template_name[:-3]
+            logger.debug("Rendering %s", template_name)
+            path = self.config.project.dirpath / template_name
+            if path.exists():
+                continue
+            path.parent.mkdir(parents=True, exist_ok=True)
+            with path.open("wt", encoding="utf8") as fh:
+                out = template.render(context)
+                fh.write(out)
+                for todo in _todo_rx.findall(out):
+                    todos.append((template_name, todo))
+                if template_name in executables:
+                    make_executable(fh)
+                    logger.debug("  made executable")
+        logger.info("Charm operator package file and directory tree initialized.")
+        if todos:
+            logger.info("TODO:")
+            logger.info("")
+            w = max(len(i[0]) for i in todos)
+            for fn, todo in todos:
+                logger.info("%*s: %s", w + 2, fn, todo)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/pack.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/pack.py
new file mode 100644
index 0000000000000000000000000000000000000000..7eb58a6226c4fbda9ef37378da31b28acd2f8fc0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/pack.py
@@ -0,0 +1,104 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Infrastructure for the 'pack' command."""
+
+import logging
+import zipfile
+
+from charmcraft.cmdbase import BaseCommand, CommandError
+from charmcraft.utils import load_yaml
+
+logger = logging.getLogger(__name__)
+
+# the minimum set of files in a bundle
+MANDATORY_FILES = {'bundle.yaml'}
+
+
+def build_zip(zippath, basedir, fpaths):
+    """Build the final file.
+
+    Note we convert all paths to str to support Python 3.5.
+    """
+    zipfh = zipfile.ZipFile(str(zippath), 'w', zipfile.ZIP_DEFLATED)
+    for fpath in fpaths:
+        zipfh.write(str(fpath), str(fpath.relative_to(basedir)))
+    zipfh.close()
+
+
+def get_paths_to_include(config):
+    """Get all file/dir paths to include."""
+    dirpath = config.project.dirpath
+    allpaths = set()
+
+    # all mandatory files, which must exist (currently only bundles.yaml is mandatory, and
+    # it's verified before)
+    for fname in MANDATORY_FILES:
+        allpaths.add(dirpath / fname)
+
+    # the extra files (relative paths)
+    for spec in config.parts:
+        fpaths = sorted(fpath for fpath in dirpath.glob(spec) if fpath.is_file())
+        logger.debug("Including per prime config %r: %s.", spec, fpaths)
+        allpaths.update(fpaths)
+
+    return sorted(allpaths)
+
+
+_overview = """
+Build the bundle and package it as a zip archive.
+
+You can `juju deploy` the bundle .zip file or upload it to
+the store (see the "upload" command).
+"""
+
+
+class PackCommand(BaseCommand):
+    """Build the bundle or the charm.
+
+    Eventually this command will also support charms, but for now it will work only
+    on bundles.
+    """
+
+    name = 'pack'
+    help_msg = "Build the bundle"
+    overview = _overview
+    needs_config = True
+
+    def run(self, parsed_args):
+        """Run the command."""
+        # get the config files
+        bundle_filepath = self.config.project.dirpath / 'bundle.yaml'
+        bundle_config = load_yaml(bundle_filepath)
+        if bundle_config is None:
+            raise CommandError(
+                "Missing or invalid main bundle file: '{}'.".format(bundle_filepath))
+        bundle_name = bundle_config.get('name')
+        if not bundle_name:
+            raise CommandError(
+                "Invalid bundle config; missing a 'name' field indicating the bundle's name in "
+                "file '{}'.".format(bundle_filepath))
+
+        # so far 'pack' works for bundles only (later this will operate also on charms)
+        if self.config.type != 'bundle':
+            raise CommandError(
+                "Bad config: 'type' field in charmcraft.yaml must be 'bundle' for this command.")
+
+        # pack everything
+        paths = get_paths_to_include(self.config)
+        zipname = self.config.project.dirpath / (bundle_name + '.zip')
+        build_zip(zipname, self.config.project.dirpath, paths)
+        logger.info("Created '%s'.", zipname)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff0cf214c7c2a02dfc453710e8d3b4d364ea06e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/__init__.py
@@ -0,0 +1,977 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Commands related to Charmhub."""
+
+import ast
+import hashlib
+import logging
+import os
+import pathlib
+import string
+import textwrap
+from collections import namedtuple
+from operator import attrgetter
+
+import yaml
+from tabulate import tabulate
+
+from charmcraft.cmdbase import BaseCommand, CommandError
+from charmcraft.utils import get_templates_environment
+
+from .store import Store
+
+logger = logging.getLogger('charmcraft.commands.store')
+
+LibData = namedtuple(
+    'LibData', 'lib_id api patch content content_hash full_name path lib_name charm_name')
+
+
+def get_name_from_metadata():
+    """Return the name if present and plausible in metadata.yaml."""
+    try:
+        with open('metadata.yaml', 'rb') as fh:
+            metadata = yaml.safe_load(fh)
+        charm_name = metadata['name']
+    except (yaml.error.YAMLError, OSError, KeyError):
+        return
+    return charm_name
+
+
+class LoginCommand(BaseCommand):
+    """Login to Charmhub."""
+
+    name = 'login'
+    help_msg = "Login to Charmhub"
+    overview = textwrap.dedent("""
+        Login to Charmhub.
+
+        Charmcraft will provide a URL for the Charmhub login. When you have
+        successfully logged in, charmcraft will store a token for ongoing
+        access to Charmhub at the CLI.
+
+        Remember to `charmcraft logout` if you want to remove that token
+        from your local system, especially in a shared environment.
+
+        See also `charmcraft whoami` to verify that you are logged in.
+
+    """)
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+        store.login()
+        logger.info("Logged in as '%s'.", store.whoami().username)
+
+
+class LogoutCommand(BaseCommand):
+    """Clear Charmhub token."""
+
+    name = 'logout'
+    help_msg = "Logout from Charmhub and remove token"
+    overview = textwrap.dedent("""
+        Clear the Charmhub token.
+
+        Charmcraft will remove the local token used for Charmhub access.
+        This is important on any shared system because the token allows
+        manipulation of your published charms.
+
+        See also `charmcraft whoami` to verify that you are logged in,
+        and `charmcraft login`.
+
+    """)
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+        store.logout()
+        logger.info("Charmhub token cleared.")
+
+
+class WhoamiCommand(BaseCommand):
+    """Show login information."""
+
+    name = 'whoami'
+    help_msg = "Show your Charmhub login status"
+    overview = textwrap.dedent("""
+        Show your Charmhub login status.
+
+        See also `charmcraft login` and `charmcraft logout`.
+    """)
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+        result = store.whoami()
+
+        data = [
+            ('name:', result.name),
+            ('username:', result.username),
+            ('id:', result.userid),
+        ]
+        table = tabulate(data, tablefmt='plain')
+        for line in table.splitlines():
+            logger.info(line)
+
+
+class RegisterNameCommand(BaseCommand):
+    """Register a name in Charmhub."""
+
+    name = 'register'
+    help_msg = "Register a charm name in Charmhub"
+    overview = textwrap.dedent("""
+        Register a charm name in Charmhub.
+
+        Claim a name for your operator in Charmhub. Once you have registered
+        a name, you can upload charm operator packages for that name and
+        release them for wider consumption.
+
+        Charmhub operates on the 'principle of least surprise' with regard
+        to naming. A charm with a well-known name should provide the best
+        operator for the microservice most people associate with that name.
+        Charms can be renamed in the Charmhub, but we would nonetheless ask
+        you to use a qualified name, such as `yourname-charmname` if you are
+        in any doubt about your ability to meet that standard.
+
+        We discuss registrations in Charmhub Discourse:
+
+           https://discourse.charmhub.io/c/charm
+
+        Registration will take you through login if needed.
+
+    """)
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument('name', help="The name to register in Charmhub")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+        store.register_name(parsed_args.name)
+        logger.info("You are now the publisher of %r in Charmhub.", parsed_args.name)
+
+
+class ListNamesCommand(BaseCommand):
+    """List the charms registered in Charmhub."""
+
+    name = 'names'
+    help_msg = "List your registered charm names in Charmhub"
+    overview = textwrap.dedent("""
+        An overview of names you have registered to publish in Charmhub.
+
+          $ charmcraft names
+          Name                Visibility    Status
+          sabdfl-hello-world  public        registered
+
+        Visibility and status are shown for each name. `public` items can be
+        seen by any user, while `private` items are only for you and the
+        other accounts with permission to collaborate on that specific name.
+
+        Listing names will take you through login if needed.
+
+    """)
+    common = True
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+        result = store.list_registered_names()
+        if not result:
+            logger.info("No charms registered.")
+            return
+
+        headers = ['Name', 'Visibility', 'Status']
+        data = []
+        for item in result:
+            visibility = 'private' if item.private else 'public'
+            data.append([
+                item.name,
+                visibility,
+                item.status,
+            ])
+
+        table = tabulate(data, headers=headers, tablefmt='plain')
+        for line in table.splitlines():
+            logger.info(line)
+
+
+class UploadCommand(BaseCommand):
+    """Upload a charm to Charmhub."""
+
+    name = 'upload'
+    help_msg = "Upload a charm to Charmhub"
+    overview = textwrap.dedent("""
+        Upload a charm to Charmhub.
+
+        Push a charm to Charmhub where it will be verified for conformance
+        to the packaging standard. This command will finish successfully
+        once the package is approved by Charmhub.
+
+        In the event of a failure in the verification process, charmcraft
+        will report details of the failure, otherwise it will give you the
+        new charm revision.
+
+        Upload will take you through login if needed.
+
+    """)
+    common = True
+
+    def _discover_charm(self, charm_filepath):
+        """Discover the charm name and file path.
+
+        If received path is None, a metadata.yaml will be searched in the current directory. If
+        path is given the name is taken from the filename.
+
+        """
+        if charm_filepath is None:
+            # discover the info using project's metadata, asume the file has the project's name
+            # with a .charm extension
+            charm_name = get_name_from_metadata()
+            if charm_name is None:
+                raise CommandError(
+                    "Cannot find a valid charm name in metadata.yaml to upload. Check you are in "
+                    "a charm directory with metadata.yaml, or use --charm-file=foo.charm.")
+
+            charm_filepath = pathlib.Path(charm_name + '.charm').absolute()
+            if not os.access(str(charm_filepath), os.R_OK):  # access doesnt support pathlib in 3.5
+                raise CommandError(
+                    "Cannot access charm at {!r}. Try --charm-file=foo.charm"
+                    .format(str(charm_filepath)))
+
+        else:
+            # the path is given, asume the charm name is part of the file name
+            # XXX Facundo 2020-06-30: Actually, we need to open the ZIP file, extract the
+            # included metadata.yaml file, and read the name from there. Issue: #77.
+            charm_filepath = charm_filepath.expanduser()
+            if not os.access(str(charm_filepath), os.R_OK):  # access doesnt support pathlib in 3.5
+                raise CommandError(
+                    "Cannot access {!r}.".format(str(charm_filepath)))
+            if not charm_filepath.is_file():
+                raise CommandError(
+                    "{!r} is not a file.".format(str(charm_filepath)))
+
+            charm_name = charm_filepath.stem
+
+        return charm_name, charm_filepath
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            '--charm-file', type=pathlib.Path,
+            help="The charm to upload")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        name, path = self._discover_charm(parsed_args.charm_file)
+        store = Store(self.config.charmhub)
+        result = store.upload(name, path)
+        if result.ok:
+            logger.info("Revision %s of %r created", result.revision, str(name))
+        else:
+            logger.info("Upload failed with status %r:", result.status)
+            for error in result.errors:
+                logger.info("- %s: %s", error.code, error.message)
+
+
+class ListRevisionsCommand(BaseCommand):
+    """List revisions for a charm."""
+
+    name = 'revisions'
+    help_msg = "List revisions for a charm in Charmhub"
+    overview = textwrap.dedent("""
+        Show version, date and status for each revision in Charmhub.
+
+        For example:
+
+           $ charmcraft revisions
+           Revision    Version    Created at    Status
+           1           1          2020-11-15    released
+
+        Listing revisions will take you through login if needed.
+
+    """)
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument('--name', help="The name of the charm")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        if parsed_args.name:
+            charm_name = parsed_args.name
+        else:
+            charm_name = get_name_from_metadata()
+            if charm_name is None:
+                raise CommandError(
+                    "Cannot find a valid charm name in metadata.yaml. Check you are in a charm "
+                    "directory with metadata.yaml, or use --name=foo.")
+
+        store = Store(self.config.charmhub)
+        result = store.list_revisions(charm_name)
+        if not result:
+            logger.info("No revisions found.")
+            return
+
+        headers = ['Revision', 'Version', 'Created at', 'Status']
+        data = []
+        for item in sorted(result, key=attrgetter('revision'), reverse=True):
+            # use just the status or include error message/code in it (if exist)
+            if item.errors:
+                errors = ("{0.message} [{0.code}]".format(e) for e in item.errors)
+                status = "{}: {}".format(item.status, '; '.join(errors))
+            else:
+                status = item.status
+
+            data.append([
+                item.revision,
+                item.version,
+                item.created_at.strftime('%Y-%m-%d'),
+                status,
+            ])
+
+        table = tabulate(data, headers=headers, tablefmt='plain', numalign='left')
+        for line in table.splitlines():
+            logger.info(line)
+
+
+class ReleaseCommand(BaseCommand):
+    """Release a charm revision to specific channels."""
+
+    name = 'release'
+    help_msg = "Release a charm revision in one or more channels"
+    overview = textwrap.dedent("""
+        Release a charm revision in the channel(s) provided.
+
+        Charm revisions are not published for anybody else until you release
+        them in a channel. When you release a revision into a channel, users
+        who deploy the charm from that channel will get see the new revision
+        as a potential update.
+
+        A channel is made up of `track/risk/branch` with both the track and
+        the branch as optional items, so formally:
+
+          [track/]risk[/branch]
+
+        Channel risk must be one of stable, candidate, beta or edge. The
+        track defaults to `latest` and branch has no default.
+
+        It is enough just to provide a channel risk, like `stable` because
+        the track will be assumed to be `latest` and branch is not required.
+
+        Some channel examples:
+
+            stable
+            edge
+            2.0/candidate
+            beta/hotfix-23425
+            1.3/beta/feature-foo
+
+        Listing revisions will take you through login if needed.
+    """)
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            'revision', type=int, help='The revision to release')
+        parser.add_argument(
+            'channels', metavar='channel', nargs='+',
+            help="The channel(s) to release to")
+        parser.add_argument('--name', help="The name of the charm")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        store = Store(self.config.charmhub)
+
+        if parsed_args.name:
+            charm_name = parsed_args.name
+        else:
+            charm_name = get_name_from_metadata()
+            if charm_name is None:
+                raise CommandError(
+                    "Cannot find a valid charm name in metadata.yaml. Check you are in a charm "
+                    "directory with metadata.yaml, or use --name=foo.")
+
+        store.release(charm_name, parsed_args.revision, parsed_args.channels)
+        logger.info(
+            "Revision %d of charm %r released to %s",
+            parsed_args.revision, charm_name, ", ".join(parsed_args.channels))
+
+
+class StatusCommand(BaseCommand):
+    """Show channel status for a charm."""
+
+    name = 'status'
+    help_msg = "Show channel and released revisions"
+    overview = textwrap.dedent("""
+        Show channels and released revisions in Charmhub
+
+        Charm revisions are not available to users until they are released
+        into a channel. This command shows the various channels for a charm
+        and whether there is a charm released.
+
+        For example:
+
+          $ charmcraft status
+          Track    Channel    Version    Revision
+          latest   stable     -          -
+                   candidate  -          -
+                   beta       -          -
+                   edge       1          1
+
+        Showing channels will take you through login if needed.
+    """)
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument('--name', help="The name of the charm")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        if parsed_args.name:
+            charm_name = parsed_args.name
+        else:
+            charm_name = get_name_from_metadata()
+            if charm_name is None:
+                raise CommandError(
+                    "Cannot find a valid charm name in metadata.yaml. Check you are in a charm "
+                    "directory with metadata.yaml, or use --name=foo.")
+
+        store = Store(self.config.charmhub)
+        channel_map, channels, revisions = store.list_releases(charm_name)
+        if not channel_map:
+            logger.info("Nothing has been released yet.")
+            return
+
+        # build easier to access structures
+        releases_by_channel = {item.channel: item for item in channel_map}
+        revisions_by_revno = {item.revision: item for item in revisions}
+
+        # process and order the channels, while preserving the tracks order
+        all_tracks = []
+        per_track = {}
+        branch_present = False
+        for channel in channels:
+            # it's super rare to have a more than just a bunch of tracks (furthermore, normally
+            # there's only one), so it's ok to do this sequential search
+            if channel.track not in all_tracks:
+                all_tracks.append(channel.track)
+
+            nonbranches_list, branches_list = per_track.setdefault(channel.track, ([], []))
+            if channel.branch is None:
+                # insert branch right after its fallback
+                for idx, stored in enumerate(nonbranches_list, 1):
+                    if stored.name == channel.fallback:
+                        nonbranches_list.insert(idx, channel)
+                        break
+                else:
+                    nonbranches_list.append(channel)
+            else:
+                branches_list.append(channel)
+                branch_present = True
+
+        headers = ['Track', 'Channel', 'Version', 'Revision']
+        if branch_present:
+            headers.append('Expires at')
+
+        # show everything, grouped by tracks, with regular channels at first and
+        # branches (if any) after those
+        data = []
+        for track in all_tracks:
+            release_shown_for_this_track = False
+            shown_track = track
+            channels, branches = per_track[track]
+
+            for channel in channels:
+                description = channel.risk
+
+                # get the release of the channel, fallbacking accordingly
+                release = releases_by_channel.get(channel.name)
+                if release is None:
+                    version = revno = '↑' if release_shown_for_this_track else '-'
+                else:
+                    release_shown_for_this_track = True
+                    revno = release.revision
+                    revision = revisions_by_revno[revno]
+                    version = revision.version
+
+                data.append([shown_track, description, version, revno])
+
+                # stop showing the track name for the rest of the track
+                shown_track = ''
+
+            for branch in branches:
+                description = '/'.join((branch.risk, branch.branch))
+                release = releases_by_channel[branch.name]
+                expiration = release.expires_at.isoformat()
+                revision = revisions_by_revno[release.revision]
+                data.append(['', description, revision.version, release.revision, expiration])
+
+        table = tabulate(data, headers=headers, tablefmt='plain', numalign='left')
+        for line in table.splitlines():
+            logger.info(line)
+
+
+class _BadLibraryPathError(CommandError):
+    """Subclass to provide a specific error for a bad library path."""
+
+    def __init__(self, path):
+        super().__init__(
+            "Charm library path {} must conform to lib/charms/<charm>/vN/<libname>.py"
+            "".format(path))
+
+
+class _BadLibraryNameError(CommandError):
+    """Subclass to provide a specific error for a bad library name."""
+
+    def __init__(self, name):
+        super().__init__(
+            "Charm library name {!r} must conform to charms.<charm>.vN.<libname>"
+            .format(name))
+
+
+def _get_positive_int(raw_value):
+    """Convert the raw value for api/patch into a positive integer."""
+    value = int(raw_value)
+    if value < 0:
+        raise ValueError('negative')
+    return value
+
+
+def _get_lib_info(*, full_name=None, lib_path=None):
+    """Get the whole lib info from the path/file."""
+    if full_name is None:
+        # get it from the lib_path
+        try:
+            libsdir, charmsdir, charm_name, v_api = lib_path.parts[:-1]
+        except ValueError:
+            raise _BadLibraryPathError(lib_path)
+        if libsdir != 'lib' or charmsdir != 'charms' or lib_path.suffix != '.py':
+            raise _BadLibraryPathError(lib_path)
+        full_name = '.'.join((charmsdir, charm_name, v_api, lib_path.stem))
+
+    else:
+        # build the path! convert a lib name with dots to the full path, including lib
+        # dir and Python extension.
+        #    e.g.: charms.mycharm.v4.foo -> lib/charms/mycharm/v4/foo.py
+        try:
+            charmsdir, charm_name, v_api, libfile = full_name.split('.')
+        except ValueError:
+            raise _BadLibraryNameError(full_name)
+        if charmsdir != 'charms':
+            raise _BadLibraryNameError(full_name)
+        lib_path = pathlib.Path('lib') / charmsdir / charm_name / v_api / (libfile + '.py')
+
+    if v_api[0] != 'v' or not v_api[1:].isdigit():
+        raise CommandError(
+            "The API version in the library path must be 'vN' where N is an integer.")
+    api_from_path = int(v_api[1:])
+
+    lib_name = lib_path.stem
+    if not lib_path.exists():
+        return LibData(
+            lib_id=None, api=api_from_path, patch=-1, content_hash=None, content=None,
+            full_name=full_name, path=lib_path, lib_name=lib_name, charm_name=charm_name)
+
+    # parse the file and extract metadata from it, while hashing
+    metadata_fields = (b'LIBAPI', b'LIBPATCH', b'LIBID')
+    metadata = dict.fromkeys(metadata_fields)
+    hasher = hashlib.sha256()
+    with lib_path.open('rb') as fh:
+        for line in fh:
+            if line.startswith(metadata_fields):
+                try:
+                    field, value = [x.strip() for x in line.split(b'=')]
+                except ValueError:
+                    raise CommandError("Bad metadata line in {}: {!r}".format(lib_path, line))
+                metadata[field] = value
+            else:
+                hasher.update(line)
+
+    missing = [k.decode('ascii') for k, v in metadata.items() if v is None]
+    if missing:
+        raise CommandError(
+            "Library {} is missing the mandatory metadata fields: {}."
+            .format(lib_path, ', '.join(sorted(missing))))
+
+    bad_api_patch_msg = "Library {} metadata field {} is not zero or a positive integer."
+    try:
+        libapi = _get_positive_int(metadata[b'LIBAPI'])
+    except ValueError:
+        raise CommandError(bad_api_patch_msg.format(lib_path, 'LIBAPI'))
+    try:
+        libpatch = _get_positive_int(metadata[b'LIBPATCH'])
+    except ValueError:
+        raise CommandError(bad_api_patch_msg.format(lib_path, 'LIBPATCH'))
+
+    if libapi == 0 and libpatch == 0:
+        raise CommandError(
+            "Library {} metadata fields LIBAPI and LIBPATCH cannot both be zero."
+            .format(lib_path))
+
+    if libapi != api_from_path:
+        raise CommandError(
+            "Library {} metadata field LIBAPI is different from the version in the path."
+            .format(lib_path))
+
+    bad_libid_msg = "Library {} metadata field LIBID must be a non-empty ASCII string."
+    try:
+        libid = ast.literal_eval(metadata[b'LIBID'].decode('ascii'))
+    except (ValueError, UnicodeDecodeError):
+        raise CommandError(bad_libid_msg.format(lib_path))
+    if not libid or not isinstance(libid, str):
+        raise CommandError(bad_libid_msg.format(lib_path))
+
+    content_hash = hasher.hexdigest()
+    content = lib_path.read_text()
+
+    return LibData(
+        lib_id=libid, api=libapi, patch=libpatch, content_hash=content_hash, content=content,
+        full_name=full_name, path=lib_path, lib_name=lib_name, charm_name=charm_name)
+
+
+def _get_libs_from_tree(charm_name=None):
+    """Get library info from the directories tree (for a specific charm if specified).
+
+    It only follows/uses the the directories/files for a correct charmlibs
+    disk structure.
+    """
+    local_libs_data = []
+
+    if charm_name is None:
+        base_dir = pathlib.Path('lib') / 'charms'
+        charm_dirs = sorted(base_dir.iterdir()) if base_dir.is_dir() else []
+    else:
+        base_dir = pathlib.Path('lib') / 'charms' / charm_name
+        charm_dirs = [base_dir] if base_dir.is_dir() else []
+
+    for charm_dir in charm_dirs:
+        for v_dir in sorted(charm_dir.iterdir()):
+            if v_dir.is_dir() and v_dir.name[0] == 'v' and v_dir.name[1:].isdigit():
+                for libfile in sorted(v_dir.glob('*.py')):
+                    local_libs_data.append(_get_lib_info(lib_path=libfile))
+
+    found_libs = [lib_data.full_name for lib_data in local_libs_data]
+    logger.debug("Libraries found under %s: %s", base_dir, found_libs)
+    return local_libs_data
+
+
+class CreateLibCommand(BaseCommand):
+    """Create a charm library."""
+
+    name = 'create-lib'
+    help_msg = "Create a charm library"
+    overview = textwrap.dedent("""
+        Create a charm library.
+
+        Charmcraft manages charm libraries, which are published by charmers
+        to help other charmers integrate their charms. This command creates
+        a new library in your charm which you are publishing for others.
+
+        This command MUST be run inside your charm directory with a valid
+        metadata.yaml. It will create the Python library with API version 0
+        initially:
+
+          lib/charms/<yourcharm>/v0/<name>.py
+
+        Each library has a unique identifier assigned by Charmhub that
+        supports accurate updates of libraries even if charms are renamed.
+        Charmcraft will request a unique ID from Charmhub and initialise a
+        template Python library.
+
+        Creating a charm library will take you through login if needed.
+
+    """)
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            'name', metavar='name',
+            help="The name of the library file (e.g. 'db')")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        lib_name = parsed_args.name
+        valid_all_chars = set(string.ascii_lowercase + string.digits + '_')
+        valid_first_char = string.ascii_lowercase
+        if set(lib_name) - valid_all_chars or not lib_name or lib_name[0] not in valid_first_char:
+            raise CommandError(
+                "Invalid library name. Must only use lowercase alphanumeric "
+                "characters and underscore, starting with alpha.")
+
+        charm_name = get_name_from_metadata()
+        if charm_name is None:
+            raise CommandError(
+                "Cannot find a valid charm name in metadata.yaml. Check you are in a charm "
+                "directory with metadata.yaml.")
+
+        # all libraries born with API version 0
+        full_name = 'charms.{}.v0.{}'.format(charm_name, lib_name)
+        lib_data = _get_lib_info(full_name=full_name)
+        lib_path = lib_data.path
+        if lib_path.exists():
+            raise CommandError('This library already exists: {}'.format(lib_path))
+
+        store = Store(self.config.charmhub)
+        lib_id = store.create_library_id(charm_name, lib_name)
+
+        # create the new library file from the template
+        env = get_templates_environment('charmlibs')
+        template = env.get_template('new_library.py.j2')
+        context = dict(lib_id=lib_id)
+        try:
+            lib_path.parent.mkdir(parents=True, exist_ok=True)
+            lib_path.write_text(template.render(context))
+        except OSError as exc:
+            raise CommandError(
+                "Error writing the library in {}: {!r}.".format(lib_path, exc))
+
+        logger.info("Library %s created with id %s.", full_name, lib_id)
+        logger.info("Consider 'git add %s'.", lib_path)
+
+
+class PublishLibCommand(BaseCommand):
+    """Publish one or more charm libraries."""
+
+    name = 'publish-lib'
+    help_msg = "Publish one or more charm libraries"
+    overview = textwrap.dedent("""
+        Publish charm libraries.
+
+        Upload and release in Charmhub the new api/patch version of the
+        indicated library, or all the charm libraries if --all is used.
+
+        It will automatically take you through the login process if
+        your credentials are missing or too old.
+    """)
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            'library', nargs='?',
+            help="Library to publish (e.g. charms.mycharm.v2.foo.); optional, default to all")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        charm_name = get_name_from_metadata()
+        if charm_name is None:
+            raise CommandError(
+                "Can't access name in 'metadata.yaml' file. The 'publish-lib' command needs to "
+                "be executed in a valid project's directory.")
+
+        if parsed_args.library:
+            lib_data = _get_lib_info(full_name=parsed_args.library)
+            if not lib_data.path.exists():
+                raise CommandError(
+                    "The specified library was not found at path {}.".format(lib_data.path))
+            if lib_data.charm_name != charm_name:
+                raise CommandError(
+                    "The library {} does not belong to this charm {!r}.".format(
+                        lib_data.full_name, charm_name))
+            local_libs_data = [lib_data]
+        else:
+            local_libs_data = _get_libs_from_tree(charm_name)
+
+        # check if something needs to be done
+        store = Store(self.config.charmhub)
+        to_query = [dict(lib_id=lib.lib_id, api=lib.api) for lib in local_libs_data]
+        libs_tips = store.get_libraries_tips(to_query)
+        to_publish = []
+        for lib_data in local_libs_data:
+            logger.debug("Verifying local lib %s", lib_data)
+            tip = libs_tips.get((lib_data.lib_id, lib_data.api))
+            logger.debug("Store tip: %s", tip)
+            if tip is None:
+                # needs to first publish
+                to_publish.append(lib_data)
+                continue
+
+            if tip.patch > lib_data.patch:
+                # the store is more advanced than local
+                logger.info(
+                    "Library %s is out-of-date locally, Charmhub has version %d.%d, please "
+                    "fetch the updates before publishing.", lib_data.full_name, tip.api, tip.patch)
+            elif tip.patch == lib_data.patch:
+                # the store has same version numbers than local
+                if tip.content_hash == lib_data.content_hash:
+                    logger.info("Library %s is already updated in Charmhub.", lib_data.full_name)
+                else:
+                    # but shouldn't as hash is different!
+                    logger.info(
+                        "Library %s version %d.%d is the same than in Charmhub but content is "
+                        "different", lib_data.full_name, tip.api, tip.patch)
+            elif tip.patch + 1 == lib_data.patch:
+                # local is correctly incremented
+                if tip.content_hash == lib_data.content_hash:
+                    # but shouldn't as hash is the same!
+                    logger.info(
+                        "Library %s LIBPATCH number was incorrectly incremented, Charmhub has the "
+                        "same content in version %d.%d.", lib_data.full_name, tip.api, tip.patch)
+                else:
+                    to_publish.append(lib_data)
+            else:
+                logger.info(
+                    "Library %s has a wrong LIBPATCH number, it's too high, Charmhub "
+                    "highest version is %d.%d.", lib_data.full_name, tip.api, tip.patch)
+
+        for lib_data in to_publish:
+            store.create_library_revision(
+                lib_data.charm_name, lib_data.lib_id, lib_data.api, lib_data.patch,
+                lib_data.content, lib_data.content_hash)
+            logger.info(
+                "Library %s sent to the store with version %d.%d",
+                lib_data.full_name, lib_data.api, lib_data.patch)
+
+
+class FetchLibCommand(BaseCommand):
+    """Fetch one or more charm libraries."""
+
+    name = 'fetch-lib'
+    help_msg = "Fetch one or more charm libraries"
+    overview = textwrap.dedent("""
+        Fetch charm libraries.
+
+        The first time a library is downloaded the command will create the needed
+        directories to place it, subsequent fetches will just update the local copy.
+    """)
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            'library', nargs='?',
+            help="Library to fetch (e.g. charms.mycharm.v2.foo.); optional, default to all")
+
+    def run(self, parsed_args):
+        """Run the command."""
+        if parsed_args.library:
+            local_libs_data = [_get_lib_info(full_name=parsed_args.library)]
+        else:
+            local_libs_data = _get_libs_from_tree()
+
+        # get tips from the Store
+        store = Store(self.config.charmhub)
+        to_query = []
+        for lib in local_libs_data:
+            if lib.lib_id is None:
+                item = dict(charm_name=lib.charm_name, lib_name=lib.lib_name)
+            else:
+                item = dict(lib_id=lib.lib_id)
+            item['api'] = lib.api
+            to_query.append(item)
+        libs_tips = store.get_libraries_tips(to_query)
+
+        # check if something needs to be done
+        to_fetch = []
+        for lib_data in local_libs_data:
+            logger.debug("Verifying local lib %s", lib_data)
+            # fix any missing lib id using the Store info
+            if lib_data.lib_id is None:
+                for tip in libs_tips.values():
+                    if lib_data.charm_name == tip.charm_name and lib_data.lib_name == tip.lib_name:
+                        lib_data = lib_data._replace(lib_id=tip.lib_id)
+                        break
+
+            tip = libs_tips.get((lib_data.lib_id, lib_data.api))
+            logger.debug("Store tip: %s", tip)
+            if tip is None:
+                logger.info("Library %s not found in Charmhub.", lib_data.full_name)
+                continue
+
+            if tip.patch > lib_data.patch:
+                # the store has a higher version than local
+                to_fetch.append(lib_data)
+            elif tip.patch < lib_data.patch:
+                # the store has a lower version numbers than local
+                logger.info(
+                    "Library %s has local changes, can not be updated.", lib_data.full_name)
+            else:
+                # same versions locally and in the store
+                if tip.content_hash == lib_data.content_hash:
+                    logger.info(
+                        "Library %s was already up to date in version %d.%d.",
+                        lib_data.full_name, tip.api, tip.patch)
+                else:
+                    logger.info(
+                        "Library %s has local changes, can not be updated.", lib_data.full_name)
+
+        for lib_data in to_fetch:
+            downloaded = store.get_library(lib_data.charm_name, lib_data.lib_id, lib_data.api)
+            if lib_data.content is None:
+                # locally new
+                lib_data.path.parent.mkdir(parents=True, exist_ok=True)
+                lib_data.path.write_text(downloaded.content)
+                logger.info(
+                    "Library %s version %d.%d downloaded.",
+                    lib_data.full_name, downloaded.api, downloaded.patch)
+            else:
+                # XXX Facundo 2020-12-17: manage the case where the library was renamed
+                # (related GH issue: #214)
+                lib_data.path.write_text(downloaded.content)
+                logger.info(
+                    "Library %s updated to version %d.%d.",
+                    lib_data.full_name, downloaded.api, downloaded.patch)
+
+
+class ListLibCommand(BaseCommand):
+    """List all libraries belonging to a charm."""
+
+    name = 'list-lib'
+    help_msg = "List all libraries from a charm"
+    overview = textwrap.dedent("""
+        List all libraries from a charm.
+
+        For each library, it will show the name and the api and patch versions
+        for its tip.
+    """)
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            'name', nargs='?', help=(
+                "The name of the charm (optional, will get the name from"
+                "metadata.yaml if not given)"))
+
+    def run(self, parsed_args):
+        """Run the command."""
+        if parsed_args.name:
+            charm_name = parsed_args.name
+        else:
+            charm_name = get_name_from_metadata()
+            if charm_name is None:
+                raise CommandError(
+                    "Can't access name in 'metadata.yaml' file. The 'list-lib' command must "
+                    "either be executed from a valid project directory, or specify a charm "
+                    "name using the --charm-name option.")
+
+        # get tips from the Store
+        store = Store(self.config.charmhub)
+        to_query = [{'charm_name': charm_name}]
+        libs_tips = store.get_libraries_tips(to_query)
+
+        if not libs_tips:
+            logger.info("No libraries found for charm %s.", charm_name)
+            return
+
+        headers = ['Library name', 'API', 'Patch']
+        data = sorted((item.lib_name, item.api, item.patch) for item in libs_tips.values())
+
+        table = tabulate(data, headers=headers, tablefmt='plain', numalign='left')
+        for line in table.splitlines():
+            logger.info(line)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/client.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/client.py
new file mode 100644
index 0000000000000000000000000000000000000000..8bd2024a002f506db5ec208752647e64ed18a1f5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/client.py
@@ -0,0 +1,278 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""A client to hit the Store."""
+
+import logging
+import os
+import pathlib
+import platform
+import webbrowser
+from http.cookiejar import MozillaCookieJar
+
+import appdirs
+import requests
+from macaroonbakery import httpbakery
+from requests.adapters import HTTPAdapter
+from requests.exceptions import RequestException
+from requests.packages.urllib3.util.retry import Retry
+from requests_toolbelt import MultipartEncoder, MultipartEncoderMonitor
+
+from charmcraft import __version__
+from charmcraft.cmdbase import CommandError
+
+# set urllib3's logger to only emit errors, not warnings. Otherwise even
+# retries are printed, and they're nasty.
+logging.getLogger(requests.packages.urllib3.__package__).setLevel(logging.ERROR)
+
+logger = logging.getLogger('charmcraft.commands.store')
+
+TESTING_ENV_PREFIXES = ["TRAVIS", "AUTOPKGTEST_TMP"]
+
+
+def _get_os_platform(filepath=pathlib.Path("/etc/os-release")):
+    """Determine a system/release combo for an OS using /etc/os-release if available."""
+    system = platform.system()
+    release = platform.release()
+    machine = platform.machine()
+
+    if system == "Linux":
+        os_release = {}
+        try:
+            with filepath.open("r", encoding='utf-8') as f:
+                for line in f:
+                    if "=" in line:
+                        key, value = line.rstrip().split("=", 1)
+                        os_release[key] = value.strip('"')
+        except FileNotFoundError:
+            logger.debug("Unable to locate 'os-release' file, using default values")
+        finally:
+            system = os_release.get("NAME", system)
+            release = os_release.get("VERSION_ID", release)
+
+    return "{}/{} ({})".format(system, release, machine)
+
+
+def build_user_agent():
+    """Build the charmcraft's user agent."""
+    if any(key.startswith(prefix) for prefix in TESTING_ENV_PREFIXES for key in os.environ.keys()):
+        testing = " (testing) "
+    else:
+        testing = " "
+    return "charmcraft/{}{}{} python/{}".format(__version__,
+                                                testing,
+                                                _get_os_platform(),
+                                                platform.python_version())
+
+
+def visit_page_with_browser(visit_url):
+    """Open a browser so the user can validate its identity."""
+    logger.warning(
+        "Opening an authorization web page in your browser; if it does not open, "
+        "please open this URL: %s", visit_url)
+    webbrowser.open(visit_url, new=1)
+
+
+class _AuthHolder:
+    """Holder and wrapper of all authentication bits.
+
+    Main two purposes of this class:
+
+    - deal with credentials persistence
+
+    - wrap HTTP calls to ensure authentication
+
+    XXX Facundo 2020-06-18: right now for functionality bootstrapping we're storing credentials
+    on disk, we may move to a keyring, wallet, other solution, or firmly remain here when we
+    get a "security" recommendation (related: issue #52).
+    """
+
+    def __init__(self):
+        self._cookiejar_filepath = appdirs.user_config_dir('charmcraft.credentials')
+        self._cookiejar = None
+        self._client = None
+
+    def clear_credentials(self):
+        """Clear stored credentials."""
+        if os.path.exists(self._cookiejar_filepath):
+            os.unlink(self._cookiejar_filepath)
+            logger.debug("Credentials cleared: file '%s' removed", self._cookiejar_filepath)
+        else:
+            logger.debug(
+                "Credentials file not found to be removed: '%s'", self._cookiejar_filepath)
+
+    def _save_credentials_if_changed(self):
+        """Save credentials if changed."""
+        if list(self._cookiejar) != self._old_cookies:
+            logger.debug("Saving credentials to file: '%s'", self._cookiejar_filepath)
+            dirpath = os.path.dirname(self._cookiejar_filepath)
+            os.makedirs(dirpath, exist_ok=True)
+
+            fd = os.open(self._cookiejar_filepath, os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
+            os.fchmod(fd, 0o600)
+            self._cookiejar.save(fd)
+
+    def _load_credentials(self):
+        """Load credentials and set up internal auth request objects."""
+        wbi = httpbakery.WebBrowserInteractor(open=visit_page_with_browser)
+        self._cookiejar = MozillaCookieJar(self._cookiejar_filepath)
+        self._client = httpbakery.Client(cookies=self._cookiejar, interaction_methods=[wbi])
+
+        if os.path.exists(self._cookiejar_filepath):
+            logger.debug("Loading credentials from file: '%s'", self._cookiejar_filepath)
+            try:
+                self._cookiejar.load()
+            except Exception as err:
+                # alert and continue processing (without having credentials, of course, the user
+                # will be asked to authenticate)
+                logger.warning("Failed to read credentials: %r", err)
+        else:
+            logger.debug("Credentials file not found: '%s'", self._cookiejar_filepath)
+
+        # iterates the cookiejar (which is mutable, may change later) and get the cookies
+        # for comparison after hitting the endpoint
+        self._old_cookies = list(self._cookiejar)
+
+    def request(self, method, url, body):
+        """Do a request."""
+        if self._client is None:
+            # load everything on first usage
+            self._load_credentials()
+
+        headers = {"User-Agent": build_user_agent()}
+
+        # this request through the bakery lib will automatically catch any authentication
+        # problem and (if any) ask the user to authenticate and retry the original request; if
+        # that fails we capture it and raise a proper error
+        try:
+            resp = self._client.request(method, url, json=body, headers=headers)
+        except httpbakery.InteractionError as err:
+            raise CommandError("Authentication failure: {}".format(err))
+
+        self._save_credentials_if_changed()
+        return resp
+
+
+def _storage_push(monitor, storage_base_url):
+    """Push bytes to the storage."""
+    url = storage_base_url + '/unscanned-upload/'
+    headers = {
+        'Content-Type': monitor.content_type,
+        'Accept': 'application/json',
+        'User-Agent': build_user_agent(),
+    }
+    retries = Retry(total=5, backoff_factor=2, status_forcelist=[500, 502, 503, 504])
+
+    with requests.Session() as session:
+        session.mount("https://", HTTPAdapter(max_retries=retries))
+
+        try:
+            response = session.post(url, headers=headers, data=monitor)
+        except RequestException as err:
+            raise CommandError("Network error when pushing file: {}({!r})".format(
+                err.__class__.__name__, str(err)))
+
+    return response
+
+
+class Client:
+    """Lightweight layer above _AuthHolder to present a more network oriented interface."""
+
+    def __init__(self, api_base_url, storage_base_url):
+        self._auth_client = _AuthHolder()
+        self.api_base_url = api_base_url.rstrip('/')
+        self.storage_base_url = storage_base_url.rstrip('/')
+
+    def clear_credentials(self):
+        """Clear stored credentials."""
+        self._auth_client.clear_credentials()
+
+    def _parse_store_error(self, response):
+        """Get the proper error from the Store response."""
+        default_msg = "Failure working with the Store: [{}] {!r}".format(
+            response.status_code, response.content)
+        try:
+            error_data = response.json()
+        except ValueError:
+            return default_msg
+
+        try:
+            error_info = [(error['message'], error['code']) for error in error_data['error-list']]
+        except (KeyError, TypeError):
+            return default_msg
+
+        if not error_info:
+            return default_msg
+
+        messages = []
+        for msg, code in error_info:
+            if code:
+                msg += " [code: {}]".format(code)
+            messages.append(msg)
+        return "Store failure! " + "; ".join(messages)
+
+    def _hit(self, method, urlpath, body=None):
+        """Issue a request to the Store."""
+        url = self.api_base_url + urlpath
+        logger.debug("Hitting the store: %s %s %s", method, url, body)
+        resp = self._auth_client.request(method, url, body)
+        if not resp.ok:
+            raise CommandError(self._parse_store_error(resp))
+
+        logger.debug("Store ok: %s", resp.status_code)
+        # XXX Facundo 2020-06-30: we need to wrap this .json() call, and raise UnknownError (after
+        # logging in debug the received raw response). This would catch weird "html" responses,
+        # for example, without making charmcraft to badly crash. Related: issue #73.
+        data = resp.json()
+        return data
+
+    def get(self, urlpath):
+        """GET something from the Store."""
+        return self._hit('GET', urlpath)
+
+    def post(self, urlpath, body):
+        """POST a body (json-encoded) to the Store."""
+        return self._hit('POST', urlpath, body)
+
+    def push(self, filepath):
+        """Push the bytes from filepath to the Storage."""
+        logger.debug("Starting to push %s", filepath)
+
+        def _progress(monitor):
+            # XXX Facundo 2020-07-01: use a real progress bar
+            if monitor.bytes_read <= monitor.len:
+                progress = 100 * monitor.bytes_read / monitor.len
+                print("Uploading... {:.2f}%\r".format(progress), end='', flush=True)
+
+        with filepath.open('rb') as fh:
+            encoder = MultipartEncoder(
+                fields={"binary": (filepath.name, fh, "application/octet-stream")})
+
+            # create a monitor (so that progress can be displayed) as call the real pusher
+            monitor = MultipartEncoderMonitor(encoder, _progress)
+            response = _storage_push(monitor, self.storage_base_url)
+
+        if not response.ok:
+            raise CommandError("Failure while pushing file: [{}] {!r}".format(
+                response.status_code, response.content))
+
+        result = response.json()
+        if not result['successful']:
+            raise CommandError("Server error while pushing file: {}".format(result))
+
+        upload_id = result['upload_id']
+        logger.debug("Uploading bytes ended, id %s", upload_id)
+        return upload_id
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/store.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/store.py
new file mode 100644
index 0000000000000000000000000000000000000000..05511e9fadb31237fea268d7fa38be746dff8bdf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/store/store.py
@@ -0,0 +1,252 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""The Store API handling."""
+
+import logging
+import time
+from collections import namedtuple
+
+from dateutil import parser
+
+from charmcraft.commands.store.client import Client
+
+logger = logging.getLogger('charmcraft.commands.store')
+
+# helpers to build responses from this layer
+User = namedtuple('User', 'name username userid')
+Charm = namedtuple('Charm', 'name private status')
+Uploaded = namedtuple('Uploaded', 'ok status revision errors')
+# XXX Facundo 2020-07-23: Need to do a massive rename to call `revno` to the "revision as
+# the number" inside the "revision as the structure", this gets super confusing in the code with
+# time, and now it's the moment to do it (also in Release below!)
+Revision = namedtuple('Revision', 'revision version created_at status errors')
+Error = namedtuple('Error', 'message code')
+Release = namedtuple('Release', 'revision channel expires_at')
+Channel = namedtuple('Channel', 'name fallback track risk branch')
+Library = namedtuple('Library', 'api content content_hash lib_id lib_name charm_name patch')
+
+# those statuses after upload that flag that the review ended (and if it ended succesfully or not)
+UPLOAD_ENDING_STATUSES = {
+    'approved': True,
+    'rejected': False,
+}
+POLL_DELAY = 1
+
+
+def _build_errors(item):
+    """Build a list of Errors from response item."""
+    return [Error(message=e['message'], code=e['code']) for e in (item['errors'] or [])]
+
+
+def _build_revision(item):
+    """Build a Revision from a response item."""
+    rev = Revision(
+        revision=item['revision'],
+        version=item['version'],
+        created_at=parser.parse(item['created-at']),
+        status=item['status'],
+        errors=_build_errors(item),
+    )
+    return rev
+
+
+def _build_library(resp):
+    """Build a Library from a response."""
+    lib = Library(
+        api=resp['api'],
+        content=resp.get('content'),  # not always present
+        content_hash=resp['hash'],
+        lib_id=resp['library-id'],
+        lib_name=resp['library-name'],
+        charm_name=resp['charm-name'],
+        patch=resp['patch'],
+    )
+    return lib
+
+
+class Store:
+    """The main interface to the Store's API."""
+
+    def __init__(self, charmhub_config):
+        self._client = Client(charmhub_config.api_url, charmhub_config.storage_url)
+
+    def login(self):
+        """Login into the store.
+
+        The login happens on every request to the Store (if current credentials were not
+        enough), so to trigger a new login we...
+
+            - remove local credentials
+
+            - exercise the simplest command regarding developer identity
+        """
+        self._client.clear_credentials()
+        self._client.get('/v1/whoami')
+
+    def logout(self):
+        """Logout from the store.
+
+        There's no action really in the Store to logout, we just remove local credentials.
+        """
+        self._client.clear_credentials()
+
+    def whoami(self):
+        """Return authenticated user details."""
+        response = self._client.get('/v1/whoami')
+        # XXX Facundo 2020-06-30: Every time we consume data from the Store (after a succesful
+        # call) we need to wrap it with a context manager that will raise UnknownError (after
+        # logging in debug the received response). This would catch API changes, for example,
+        # without making charmcraft to badly crash. Related: issue #73.
+        result = User(
+            name=response['display-name'],
+            username=response['username'],
+            userid=response['id'],
+        )
+        return result
+
+    def register_name(self, name):
+        """Register the specified name for the authenticated user."""
+        self._client.post('/v1/charm', {'name': name})
+
+    def list_registered_names(self):
+        """Return names registered by the authenticated user."""
+        response = self._client.get('/v1/charm')
+        result = []
+        for item in response['results']:
+            result.append(Charm(name=item['name'], private=item['private'], status=item['status']))
+        return result
+
+    def upload(self, name, filepath):
+        """Upload the content of filepath to the indicated charm."""
+        upload_id = self._client.push(filepath)
+
+        endpoint = '/v1/charm/{}/revisions'.format(name)
+        response = self._client.post(endpoint, {'upload-id': upload_id})
+        status_url = response['status-url']
+        logger.debug("Upload %s started, got status url %s", upload_id, status_url)
+
+        while True:
+            response = self._client.get(status_url)
+            logger.debug("Status checked: %s", response)
+
+            # as we're asking for a single upload_id, the response will always have only one item
+            (revision,) = response['revisions']
+            status = revision['status']
+
+            if status in UPLOAD_ENDING_STATUSES:
+                return Uploaded(
+                    ok=UPLOAD_ENDING_STATUSES[status], errors=_build_errors(revision),
+                    status=status, revision=revision['revision'])
+
+            # XXX Facundo 2020-06-30: Implement a slight backoff algorithm and fallout after
+            # N attempts (which should be big, as per snapcraft experience). Issue: #79.
+            time.sleep(POLL_DELAY)
+
+    def list_revisions(self, name):
+        """Return charm revisions for the indicated charm."""
+        response = self._client.get('/v1/charm/{}/revisions'.format(name))
+        result = [_build_revision(item) for item in response['revisions']]
+        return result
+
+    def release(self, name, revision, channels):
+        """Release one or more revisions for a package."""
+        endpoint = '/v1/charm/{}/releases'.format(name)
+        items = [{'revision': revision, 'channel': channel} for channel in channels]
+        self._client.post(endpoint, items)
+
+    def list_releases(self, name):
+        """List current releases for a package."""
+        endpoint = '/v1/charm/{}/releases'.format(name)
+        response = self._client.get(endpoint)
+
+        channel_map = []
+        for item in response['channel-map']:
+            expires_at = item['expiration-date']
+            if expires_at is not None:
+                # `datetime.datetime.fromisoformat` is available only since Py3.7
+                expires_at = parser.parse(expires_at)
+            channel_map.append(
+                Release(revision=item['revision'], channel=item['channel'], expires_at=expires_at))
+
+        channels = [
+            Channel(
+                name=item['name'],
+                fallback=item['fallback'],
+                track=item['track'],
+                risk=item['risk'],
+                branch=item['branch'],
+            ) for item in response['package']['channels']]
+
+        revisions = [_build_revision(item) for item in response['revisions']]
+
+        return channel_map, channels, revisions
+
+    def create_library_id(self, charm_name, lib_name):
+        """Create a new library id."""
+        endpoint = '/v1/charm/libraries/{}'.format(charm_name)
+        response = self._client.post(endpoint, {'library-name': lib_name})
+        lib_id = response['library-id']
+        return lib_id
+
+    def create_library_revision(self, charm_name, lib_id, api, patch, content, content_hash):
+        """Create a new library revision."""
+        endpoint = '/v1/charm/libraries/{}/{}'.format(charm_name, lib_id)
+        payload = {
+            'api': api,
+            'patch': patch,
+            'content': content,
+            'hash': content_hash,
+        }
+        response = self._client.post(endpoint, payload)
+        result = _build_library(response)
+        return result
+
+    def get_library(self, charm_name, lib_id, api):
+        """Get the library tip by id for a given api version."""
+        endpoint = '/v1/charm/libraries/{}/{}?api={}'.format(charm_name, lib_id, api)
+        response = self._client.get(endpoint)
+        result = _build_library(response)
+        return result
+
+    def get_libraries_tips(self, libraries):
+        """Get the tip details for several libraries at once.
+
+        Each requested library can be specified in different ways: using the library id
+        or the charm and library names (both will pinpoint the library), but in the later
+        case the library name is optional (so all libraries for that charm will be
+        returned). Also, for all those cases, an API version can be specified.
+        """
+        endpoint = '/v1/charm/libraries/bulk'
+        payload = []
+        for lib in libraries:
+            if 'lib_id' in lib:
+                item = {
+                    'library-id': lib['lib_id'],
+                }
+            else:
+                item = {
+                    'charm-name': lib['charm_name'],
+                }
+                if 'lib_name' in lib:
+                    item['library-name'] = lib['lib_name']
+            if 'api' in lib:
+                item['api'] = lib['api']
+            payload.append(item)
+        response = self._client.post(endpoint, payload)
+        libraries = response['libraries']
+        result = {(item['library-id'], item['api']): _build_library(item) for item in libraries}
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ba5da08a125b572efc7222a90ebd99655ef94fc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/utils.py
@@ -0,0 +1,64 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+import logging
+import os
+from stat import S_IXUSR, S_IXGRP, S_IXOTH, S_IRUSR, S_IRGRP, S_IROTH
+
+import yaml
+from jinja2 import Environment, PackageLoader, StrictUndefined
+
+logger = logging.getLogger('charmcraft.commands')
+
+
+# handy masks for execution and reading for everybody
+S_IXALL = S_IXUSR | S_IXGRP | S_IXOTH
+S_IRALL = S_IRUSR | S_IRGRP | S_IROTH
+
+
+def make_executable(fh):
+    """make open file fh executable"""
+    fileno = fh.fileno()
+    mode = os.fstat(fileno).st_mode
+    mode_r = mode & S_IRALL
+    mode_x = mode_r >> 2
+    mode = mode | mode_x
+    os.fchmod(fileno, mode)
+
+
+def load_yaml(fpath):
+    """Return the content of a YAML file."""
+    if not fpath.is_file():
+        logger.debug("Couldn't find config file %s", fpath)
+        return
+    try:
+        with fpath.open('rb') as fh:
+            content = yaml.safe_load(fh)
+    except (yaml.error.YAMLError, OSError) as err:
+        logger.error("Failed to read/parse config file %s (got %r)", fpath, err)
+        return
+    return content
+
+
+def get_templates_environment(templates_dir):
+    """Create and return a Jinja environment to deal with the templates."""
+    env = Environment(
+        loader=PackageLoader('charmcraft', 'templates/{}'.format(templates_dir)),
+        autoescape=False,            # no need to escape things here :-)
+        keep_trailing_newline=True,  # they're not text files if they don't end in newline!
+        optimized=False,             # optimization doesn't make sense for one-offs
+        undefined=StrictUndefined)   # fail on undefined
+    return env
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..cdc7cff0cffc4f780bb9f70a45147cd6f8ee19bf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/commands/version.py
@@ -0,0 +1,56 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Infrastructure for the 'version' command."""
+
+import logging
+
+from charmcraft import __version__
+from charmcraft.cmdbase import BaseCommand
+
+logger = logging.getLogger(__name__)
+
+_overview = """
+Show charmcraft version.
+
+The output has the following format: X.Y.Z[+N.gHASH[.dirty]]
+
+Where:
+
+- X, Y and Z are the major, minor and patch version numbers,
+  upgraded when a release is done
+
+- +N.gHASH is present if using charmcraft from the project (how many
+  commits after last release, and last commit's hash)
+
+- .dirty is present if the branch you're executing charmcraft from has
+  modifications
+
+Example: 0.3.1+40.g883455b.dirty
+"""
+
+
+class VersionCommand(BaseCommand):
+    """Show the charmcraft version."""
+
+    name = 'version'
+    help_msg = "Show charmcraft version"
+    overview = _overview
+    common = True
+
+    def run(self, parsed_args):
+        """Run the command."""
+        logger.info("%s", __version__)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..b08b4336379817ac39f0f733ad35eccc4cd03023
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/config.py
@@ -0,0 +1,202 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Central configuration management."""
+
+import pathlib
+from urllib.parse import urlparse
+
+import attr
+import jsonschema
+
+from charmcraft.cmdbase import CommandError
+from charmcraft.utils import load_yaml
+
+format_checker = jsonschema.FormatChecker()
+
+# translator between "json" and pythonic yaml names
+TYPE_TRANSLATOR = {
+    'object': 'dict',
+    'array': 'list',
+}
+
+
+def get_field_reference(path):
+    """Get a field indicator from the received path."""
+    if isinstance(path[-1], int):
+        field = '.'.join(list(path)[:-1])
+        ref = "item {} in '{}' field".format(path[-1], field)
+    else:
+        field = '.'.join(path)
+        ref = "'{}' field".format(field)
+    return ref
+
+
+def adapt_validation_error(error):
+    """Take a jsonschema.ValidationError and create a proper CommandError."""
+    if error.validator == 'required':
+        msg = "Bad charmcraft.yaml content; missing fields: {}.".format(
+            ', '.join(error.validator_value))
+    elif error.validator == 'type':
+        expected_type = TYPE_TRANSLATOR.get(error.validator_value, error.validator_value)
+        field_ref = get_field_reference(error.absolute_path)
+        msg = "Bad charmcraft.yaml content; the {} must be a {}: got '{}'.".format(
+            field_ref, expected_type, error.instance.__class__.__name__)
+    elif error.validator == 'enum':
+        field_ref = get_field_reference(error.absolute_path)
+        msg = "Bad charmcraft.yaml content; the {} must be one of: {}.".format(
+            field_ref, ', '.join(map(repr, error.validator_value)))
+    elif error.validator == 'format':
+        field_ref = get_field_reference(error.absolute_path)
+        msg = "Bad charmcraft.yaml content; the {} {}: got {!r}.".format(
+            field_ref, error.cause, error.instance)
+    else:
+        # safe fallback
+        msg = error.message
+
+    raise CommandError(msg)
+
+
+@format_checker.checks('url', raises=ValueError)
+def check_url(value):
+    """Check that the URL has at least scheme and net location."""
+    if isinstance(value, str):
+        url = urlparse(value)
+        if url.scheme and url.netloc:
+            return True
+    raise ValueError("must be a full URL (e.g. 'https://some.server.com')")
+
+
+@format_checker.checks('relative_path', raises=ValueError)
+def check_relative_paths(value):
+    """Check that the received paths are all valid relative ones."""
+    if isinstance(value, str):
+        # check if it's an absolute path using POSIX's '/' (not os.path.sep, as the charm's
+        # config is independent of the platform where charmcraft is running)
+        if value and value[0] != '/':
+            return True
+    raise ValueError("must be a valid relative URL")
+
+
+@attr.s(kw_only=True, frozen=True)
+class CharmhubConfig:
+    """Configuration for all Charmhub related options."""
+
+    api_url = attr.ib(default='https://api.charmhub.io')
+    storage_url = attr.ib(default='https://storage.snapcraftcontent.com')
+
+    @classmethod
+    def from_dict(cls, source):
+        """Build from a raw dict."""
+        return cls(**source)
+
+
+class BasicPrime(tuple):
+    """Hold the list of files to include, specified under parts/bundle/prime configs.
+
+    This is a intermediate structure until we have the full Lifecycle in place.
+    """
+
+    @classmethod
+    def from_dict(cls, parts):
+        """Build from a dicts sequence."""
+        prime = parts.get('bundle', {}).get('prime', [])
+        return cls(prime)
+
+
+@attr.s(kw_only=True, frozen=True)
+class Project:
+    """Configuration for all project-related options, used internally."""
+
+    dirpath = attr.ib(default=None)
+    config_provided = attr.ib(default=None)
+
+
+@attr.s(kw_only=True, frozen=True)
+class Config:
+    """Root of all the configuration."""
+
+    charmhub = attr.ib(default={}, converter=CharmhubConfig.from_dict)
+    parts = attr.ib(default={}, converter=BasicPrime.from_dict)
+    type = attr.ib(default=None)
+
+    # this item is provided by the code itself, not the user, as convenience for the
+    # rest of the code
+    project = attr.ib(default=None)
+
+
+CONFIG_SCHEMA = {
+    'type': 'object',
+    'properties': {
+        'type': {'type': 'string', 'enum': ['charm', 'bundle']},
+        'charmhub': {
+            'type': 'object',
+            'properties': {
+                'api_url': {'type': 'string', 'format': 'url'},
+                'storage_url': {'type': 'string', 'format': 'url'},
+            },
+            'additionalProperties': False,
+        },
+        'parts': {
+            'type': 'object',
+            'properties': {
+                'bundle': {
+                    'type': 'object',
+                    'properties': {
+                        'prime': {
+                            'type': 'array',
+                            'items': {
+                                'type': 'string',
+                                'format': 'relative_path',
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    'required': ['type'],
+    'additionalProperties': False,
+}
+
+
+def load(dirpath):
+    """Load the config from charmcraft.yaml in the indicated directory."""
+    if dirpath is None:
+        dirpath = pathlib.Path.cwd()
+    else:
+        dirpath = pathlib.Path(dirpath).expanduser().resolve()
+
+    content = load_yaml(dirpath / 'charmcraft.yaml')
+    if content is None:
+        # configuration is mandatory only for some commands; when not provided, it will
+        # be initialized all with defaults (but marked as not provided for later verification)
+        content = {}
+        config_provided = False
+
+    else:
+        # config provided! validate the loaded config is ok and mark as such
+        try:
+            jsonschema.validate(
+                instance=content, schema=CONFIG_SCHEMA, format_checker=format_checker)
+        except jsonschema.ValidationError as exc:
+            adapt_validation_error(exc)
+        config_provided = True
+
+    # inject project's config
+    content['project'] = Project(dirpath=dirpath, config_provided=config_provided)
+
+    return Config(**content)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/helptexts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/helptexts.py
new file mode 100644
index 0000000000000000000000000000000000000000..16e037d51841c2338bc09625f4efceedbb19eeeb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/helptexts.py
@@ -0,0 +1,271 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Provide all help texts."""
+
+import textwrap
+from operator import attrgetter
+
+# max columns used in the terminal
+TERMINAL_WIDTH = 72
+
+# the summary of the whole program, already indented so it represents the real
+# "columns spread", for easier human editing.
+GENERAL_SUMMARY = """
+    Charmcraft helps build, package and publish operators on Charmhub.
+
+    Together with the Python Operator Framework, charmcraft simplifies
+    operator development and collaboration.
+
+    See https://charmhub.io/publishing for more information.
+"""
+# XXX Facundo 2020-09-10: we should add an extra (separated) line to the summary with:
+#   See <url> for additional documentation.
+# Related issue: https://github.com/canonical/charmcraft/issues/161
+
+# generic intro and outro texts
+HEADER = """
+Usage:
+    charmcraft [help] <command>
+"""
+
+USAGE = """\
+Usage: charmcraft [options] command [args]...
+Try '{fullcommand} -h' for help.
+
+Error: {error_message}
+"""
+
+
+def get_usage_message(fullcommand, error_message):
+    """Build a usage and error message.
+
+    The fullcommand is the command used by the user (`charmcraft`, `charmcraft build`, etc),
+    and the error message is the specific problem in the given parameters.
+    """
+    return USAGE.format(fullcommand=fullcommand, error_message=error_message)
+
+
+def _build_item(title, text, title_space):
+    """Show an item in the help, generically a title and a text aligned.
+
+    The title starts in column 4 with an extra ':'. The text starts in
+    4 plus the title space; if too wide it's wrapped.
+    """
+    # wrap the general text to the desired max width (discounting the space for the title,
+    # the first 4 spaces, the two spaces to separate title/text, and the ':'
+    not_title_space = 7
+    text_space = TERMINAL_WIDTH - title_space - not_title_space
+    wrapped_lines = textwrap.wrap(text, text_space)
+
+    # first line goes with the title at column 4
+    first = "    {:>{title_space}s}:  {}".format(title, wrapped_lines[0], title_space=title_space)
+    result = [first]
+
+    # the rest (if any) still aligned but without title
+    for line in wrapped_lines[1:]:
+        result.append(" " * (title_space + not_title_space) + line)
+
+    return result
+
+
+def get_full_help(command_groups, global_options):
+    """Produce the text for the default help.
+
+    - command_groups: list of grouped commands, as it's defined in the main
+      module
+
+    - global_options: options defined at charmcraft level (not in the commands),
+      with the (options, description) structure
+
+    The help text has the following structure:
+
+    - usage
+    - summary
+    - common commands listed and described shortly
+    - all commands grouped, just listed
+    - more help
+    """
+    textblocks = []
+
+    # title
+    textblocks.append(HEADER)
+
+    # summary
+    textblocks.append("Summary:" + GENERAL_SUMMARY)
+
+    # column alignment is dictated by longest common commands names and groups names
+    max_title_len = 0
+
+    # collect common commands
+    common_commands = []
+    for group, _, commands in command_groups:
+        max_title_len = max(len(group), max_title_len)
+        for cmd in commands:
+            if cmd.common:
+                common_commands.append(cmd)
+                max_title_len = max(len(cmd.name), max_title_len)
+
+    for title, _ in global_options:
+        max_title_len = max(len(title), max_title_len)
+
+    global_lines = ["Global options:"]
+    for title, text in global_options:
+        global_lines.extend(_build_item(title, text, max_title_len))
+    textblocks.append("\n".join(global_lines))
+
+    common_lines = ["Starter commands:"]
+    for cmd in sorted(common_commands, key=attrgetter('name')):
+        common_lines.extend(_build_item(cmd.name, cmd.help_msg, max_title_len))
+    textblocks.append("\n".join(common_lines))
+
+    grouped_lines = ["Commands can be classified as follows:"]
+    for group, _, commands in sorted(command_groups):
+        command_names = ", ".join(sorted(cmd.name for cmd in commands))
+        grouped_lines.extend(_build_item(group, command_names, max_title_len))
+    textblocks.append("\n".join(grouped_lines))
+
+    textblocks.append(textwrap.dedent("""
+        For more information about a command, run 'charmcraft help <command>'.
+        For a summary of all commands, run 'charmcraft help --all'.
+    """))
+
+    # join all stripped blocks, leaving ONE empty blank line between
+    text = '\n\n'.join(block.strip() for block in textblocks) + '\n'
+    return text
+
+
+def get_detailed_help(command_groups, global_options):
+    """Produce the text for the detailed help.
+
+    - command_groups: list of grouped commands, as it's defined in the main
+      module
+
+    - global_options: options defined at charmcraft level (not in the commands),
+      with the (options, description) structure
+
+    The help text has the following structure:
+
+    - usage
+    - summary
+    - global options
+    - all commands shown with description, grouped
+    - more help
+    """
+    textblocks = []
+
+    # title
+    textblocks.append(HEADER)
+
+    # summary
+    textblocks.append("Summary:" + GENERAL_SUMMARY)
+
+    # column alignment is dictated by longest common commands names and groups names
+    max_title_len = 0
+    for _, _, commands in command_groups:
+        for cmd in commands:
+            max_title_len = max(len(cmd.name), max_title_len)
+    for title, _ in global_options:
+        max_title_len = max(len(title), max_title_len)
+
+    global_lines = ["Global options:"]
+    for title, text in global_options:
+        global_lines.extend(_build_item(title, text, max_title_len))
+    textblocks.append("\n".join(global_lines))
+
+    textblocks.append("Commands can be classified as follows:")
+
+    for _, group_description, commands in command_groups:
+        group_lines = ["{}:".format(group_description)]
+        for cmd in commands:
+            group_lines.extend(_build_item(cmd.name, cmd.help_msg, max_title_len))
+        textblocks.append("\n".join(group_lines))
+
+    textblocks.append(textwrap.dedent("""
+        For more information about a specific command, run 'charmcraft help <command>'.
+    """))
+
+    # join all stripped blocks, leaving ONE empty blank line between
+    text = '\n\n'.join(block.strip() for block in textblocks) + '\n'
+    return text
+
+
+def get_command_help(command_groups, command, arguments):
+    """Produce the text for each command's help.
+
+    - command_groups: list of grouped commands, as it's defined in the main
+      module
+
+    - command: the instanciated command for which help is prepared
+
+    - arguments: all command options and parameters, with the (name, description) structure
+
+    The help text has the following structure:
+
+    - usage
+    - summary
+    - options
+    - other related commands
+    - footer
+    """
+    textblocks = []
+
+    # separate all arguments into the parameters and optional ones, just checking
+    # if first char is a dash
+    parameters = []
+    options = []
+    for name, title in arguments:
+        if name[0] == '-':
+            options.append((name, title))
+        else:
+            parameters.append(name)
+
+    textblocks.append(textwrap.dedent("""\
+        Usage:
+            charmcraft {} [options] {}
+    """.format(command.name, " ".join("<{}>".format(parameter) for parameter in parameters))))
+
+    textblocks.append("Summary:{}".format(textwrap.indent(command.overview, '    ')))
+
+    # column alignment is dictated by longest options title
+    max_title_len = max(len(title) for title, text in options)
+
+    # command options
+    option_lines = ["Options:"]
+    for title, text in options:
+        option_lines.extend(_build_item(title, text, max_title_len))
+    textblocks.append("\n".join(option_lines))
+
+    # recommend other commands of the same group
+    for group_name, _, command_classes in command_groups:
+        if group_name == command.group:
+            break
+    else:
+        raise RuntimeError("Internal inconsistency in commands groups")
+    other_command_names = [c.name for c in command_classes if not isinstance(command, c)]
+    if other_command_names:
+        see_also_block = ["See also:"]
+        see_also_block.extend(("    " + name) for name in sorted(other_command_names))
+        textblocks.append('\n'.join(see_also_block))
+
+    # footer
+    textblocks.append("""
+        For a summary of all commands, run 'charmcraft help --all'.
+    """)
+
+    # join all stripped blocks, leaving ONE empty blank line between
+    text = '\n\n'.join(block.strip() for block in textblocks) + '\n'
+    return text
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/jujuignore.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/jujuignore.py
new file mode 100644
index 0000000000000000000000000000000000000000..f0c103f76a185536b38ac948335e6393cc83396b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/jujuignore.py
@@ -0,0 +1,228 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Indicate which files are ignored by Juju."""
+
+import logging
+import re
+import typing
+
+logger = logging.getLogger(__name__)
+
+KEEP = 'keep'
+SKIP = 'skip'
+FORCEKEEP = 'forcekeep'
+
+_unescapes = {
+    r'\!': '!',
+    r'\ ': ' ',
+    r'\#': '#',
+
+}
+
+
+def _rstrip_unescaped(rule):
+    """Remove trailing whitespace that isn't escaped."""
+    i = len(rule) - 1
+    last = len(rule)
+    while i >= 0:
+        if rule[i] == '\n' or rule[i] == '\r':
+            last = i
+        elif rule[i] != ' ':
+            break
+        elif i == 0 or rule[i - 1] != '\\':
+            last = i
+        i -= 1
+    rule = rule[:last]
+    return rule
+
+
+def _unescape_rule(rule):
+    """Take out escape characters and trailing unescaped whitespace from the rule."""
+    rule = rule.lstrip()
+    rule = _rstrip_unescaped(rule)
+    for old, new in _unescapes.items():
+        rule = rule.replace(old, new)
+    return rule
+
+
+def _rule_to_regex(rule):
+    """Turn a rule into a regex that we can use.
+
+    This assumes that all the meta processing, like 'ends with /' and 'starts with !' have
+    already been checked.
+    """
+    # Things we currently care about:
+    # * = matches only within a directory "[^/]*"
+    # ** = matches across directories ".*"
+    # ? = matches a single character
+    # [0-9] can match anything 0-9
+    # This is taken from fnmatch.fnmatch, but that doesn't handle '**' and '*' also matches
+    # directories
+
+    i, n = 0, len(rule)
+    res = ''
+    while i < n:
+        c = rule[i]
+        i += 1
+        if c == '*':
+            if i < n and rule[i] == '*':
+                i += 1
+                res += '.*'
+            else:
+                res += '[^/]*'
+        elif c == '?':
+            res += '[^/]'
+        elif c == '[':
+            j = i
+            if j < n and rule[j] == '!':
+                j += 1
+            if j < n and rule[j] == ']':
+                j += 1
+            while j < n and rule[j] != ']':
+                j += 1
+            if j >= n:
+                res += '\\['
+            else:
+                stuff = rule[i:j]
+                # Escape regex set operations (&~|).
+                stuff = re.sub(r'([&~|])', r'\\\1', stuff)
+                i = j + 1
+                if stuff[0] == '!':
+                    stuff = '^' + stuff[1:]
+                elif stuff[0] in ('['):
+                    stuff = '\\' + stuff
+                res = '%s[%s]' % (res, stuff)
+        elif c == '/':
+            # Special case of '/**/' which can match a single '/'
+            if i < n and rule[i] == '*' and rule[i - 1:i + 3] == '/**/':
+                i += 3
+                res = res + '.*/'
+            else:
+                res = res + '/'
+        else:
+            res += re.escape(c)
+    res += r'\Z'
+    return res
+
+
+class _Matcher:
+    """Couple a regex with other metadata for how we should match a given pattern."""
+
+    def __init__(self, line_num: int, orig_rule: str, invert: bool, only_dirs: bool,
+                 regex: typing.Pattern):
+        self.line_num = line_num
+        self.orig_rule = orig_rule
+        self.invert = invert
+        self.only_dirs = only_dirs
+        self.compiled = re.compile(regex, re.DOTALL)
+
+    def match(self, path: str, is_dir: bool) -> str:
+        """Check if a path matches.
+
+        Returns:
+            Can return one of KEEP, SKIP, FORCEKEEP
+        """
+        if self.only_dirs and not is_dir:
+            return KEEP
+        if self.compiled.match(path):
+            if self.invert:
+                return FORCEKEEP
+            return SKIP
+        return KEEP
+
+
+class JujuIgnore:
+    """Track a set of ignore patterns from a .jujuignore file."""
+
+    def __init__(self, patterns: typing.Iterable[str]):
+        self._matchers = []
+        self._compile_from(patterns)
+
+    def extend_patterns(self, patterns: typing.Iterable[str]) -> None:
+        """Add more patterns to the ignore list."""
+        self._compile_from(patterns)
+
+    def _compile_from(self, patterns: typing.Iterable[str]):
+        for line_num, rule in enumerate(patterns, 1):
+            orig_rule = rule
+            rule = rule.lstrip().rstrip('\r\n')
+            if not rule or rule.startswith('#'):
+                continue
+            invert = False
+            if rule.startswith('!'):
+                invert = True
+                rule = rule.lstrip('!')
+            rule = _unescape_rule(rule)
+            only_dirs = False
+            if rule.endswith('/'):
+                only_dirs = True
+                rule = rule.rstrip('/')
+            if not rule.startswith('/'):
+                # A rule that doesn't start with '/' means to match any
+                # subdirectory
+                rule = '**/' + rule
+            regex = _rule_to_regex(rule)
+            m = _Matcher(
+                line_num=line_num,
+                orig_rule=orig_rule,
+                invert=invert,
+                only_dirs=only_dirs,
+                regex=regex,
+            )
+            self._matchers.append(m)
+            logger.debug('Translated .jujuignore %d "%s" => "%s"', line_num, orig_rule, regex)
+
+    def match(self, path: str, is_dir: bool) -> bool:
+        """Check if the given path should be ignored.
+
+        Args:
+            path: A local path (eg /foo/bar or foo/bar) from the root directory of the project.
+            is_dir: Indicate whether the given path is a directory (because of special handling
+            from ignore files when the path ends with a '/')
+        Return:
+            A boolean indicating whether the ignore rules matched the given path (thus the path
+            should be ignored).
+        """
+        if not path.startswith('/'):
+            path = '/' + path
+        keep = True
+        for matcher in self._matchers:
+            matchRes = matcher.match(path, is_dir)
+            if matchRes == SKIP:
+                keep = False
+            elif matchRes == FORCEKEEP:
+                keep = True
+                break
+        return not keep
+
+
+# default_juju_ignore is the initial set of ignores.
+# juju itself always includes these before adding the contents of .jujuignore
+# NOTE that this diverges from Juju ignore list, which also ignores "version",
+# because we need the version file to populate the store
+default_juju_ignore = '''
+.git
+.svn
+.hg
+.bzr
+.tox
+
+/build/
+/revision
+
+.jujuignore
+'''.split('\n')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/logsetup.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/logsetup.py
new file mode 100644
index 0000000000000000000000000000000000000000..de2cf2f1bb9c12d7a0b8d96334794d9e09445437
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/logsetup.py
@@ -0,0 +1,121 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Set up logging."""
+
+import logging
+import os
+import tempfile
+
+from charmcraft import __version__
+
+FORMATTER_SIMPLE = "%(message)s"
+FORMATTER_DETAILED = "%(asctime)s  %(name)-30s %(levelname)-8s %(message)s"
+
+_logger = logging.getLogger('charmcraft')
+_logger.setLevel(logging.DEBUG)
+
+
+class _MessageHandler:
+    """Handle all the messages to the user.
+
+    This class deals with several combination of the following dimensions:
+
+    - the mode: quiet, normal or verbose
+    - the output: sometimes, some messages, to the terminal; always to the file
+    - the execution result: what happens if succeeded, raise a controlled error, or crashed
+    """
+
+    _modes = {
+        'quiet': (logging.WARNING, FORMATTER_SIMPLE),
+        'normal': (logging.INFO, FORMATTER_SIMPLE),
+        'verbose': (logging.DEBUG, FORMATTER_DETAILED),
+    }
+
+    def __init__(self):
+        self._stderr_handler = logging.StreamHandler()
+        _logger.addHandler(self._stderr_handler)
+
+        # autoset modes constants for simpler interface
+        for k in self._modes:
+            setattr(self, k.upper(), k)
+
+    def init(self, initial_mode):
+        """Initialize internal structures; this must be done before start logging."""
+        self._set_filehandler()
+        self.set_mode(initial_mode)
+
+    def set_mode(self, mode):
+        """Set logging in different modes."""
+        self.mode = mode
+        level, format_string = self._modes[mode]
+        self._stderr_handler.setFormatter(logging.Formatter(format_string))
+        self._stderr_handler.setLevel(level)
+        if mode == self.VERBOSE:
+            _logger.debug("Starting charmcraft version %s", __version__)
+
+    def _set_filehandler(self):
+        """Set the file handler to log everything to the temp file."""
+        _, self._log_filepath = tempfile.mkstemp(prefix='charmcraft-log-')
+
+        file_handler = logging.FileHandler(self._log_filepath)
+        file_handler.setFormatter(logging.Formatter(FORMATTER_DETAILED))
+        file_handler.setLevel(0)  # log eeeeeverything
+        _logger.addHandler(file_handler)
+
+        # a logger for only the file
+        self._file_logger = logging.getLogger('charmcraft.guard')
+        self._file_logger.propagate = False
+        self._file_logger.addHandler(file_handler)
+        self._file_logger.debug("Starting charmcraft version %s", __version__)
+
+    def ended_ok(self):
+        """Cleanup after successful execution."""
+        os.unlink(self._log_filepath)
+
+    def ended_interrupt(self):
+        """Clean up on keyboard interrupt."""
+        if self.mode == self.VERBOSE:
+            _logger.exception("Interrupted.")
+        else:
+            _logger.error("Interrupted.")
+        os.unlink(self._log_filepath)
+
+    def ended_cmderror(self, err):
+        """Report the (expected) problem and (maybe) logfile location."""
+        if err.argsparsing:
+            print(err)
+        else:
+            msg = "{} (full execution logs in {})".format(err, self._log_filepath)
+            _logger.error(msg)
+
+    def ended_crash(self, err):
+        """Report the internal error and logfile location.
+
+        Show just the error to the user, but send the whole traceback to the log file.
+        """
+        msg = "charmcraft internal error! {}: {} (full execution logs in {})".format(
+            err.__class__.__name__, err, self._log_filepath)
+        if self.mode == self.VERBOSE:
+            # both to screen and file!
+            _logger.exception(msg)
+        else:
+            # the error to screen and file, plus the traceback to the file
+            _logger.error(msg)
+            self._file_logger.exception('')
+
+
+message_handler = _MessageHandler()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..282836725d6024912e00d3e580688aef3c8035df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/main.py
@@ -0,0 +1,319 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Main entry point module for all the tool functionality."""
+
+import argparse
+import logging
+import sys
+from collections import namedtuple
+
+from charmcraft import helptexts, config
+from charmcraft.commands import version, build, store, init, pack
+from charmcraft.cmdbase import CommandError, BaseCommand
+from charmcraft.logsetup import message_handler
+
+logger = logging.getLogger(__name__)
+
+
+class HelpCommand(BaseCommand):
+    """Special internal command to produce help and usage messages.
+
+    It bends the rules for parameters (we have an optional parameter without dashes), the
+    idea is to lower the barrier as much as possible for the user getting help.
+    """
+
+    name = 'help'
+    help_msg = "Provide help on charmcraft usage"
+    overview = "Produce a general or a detailed charmcraft help, or a specific command one."
+    common = True
+
+    def fill_parser(self, parser):
+        """Add own parameters to the general parser."""
+        parser.add_argument(
+            '--all', action='store_true', help="Produce an extensive help of all commands")
+        parser.add_argument(
+            'command_to_help', nargs='?', metavar='command',
+            help="Produce a detailed help of the specified command")
+
+    def run(self, parsed_args, all_commands):
+        """Present different help messages to the user.
+
+        Unlike other commands, this one receives an extra parameter with all commands,
+        to validate if the help requested is on a valid one, or even parse its data.
+        """
+        retcode = 0
+        if parsed_args.command_to_help is None or parsed_args.command_to_help == self.name:
+            # help on no command in particular, get general text
+            help_text = get_general_help(detailed=parsed_args.all)
+        elif parsed_args.command_to_help not in all_commands:
+            # asked help on a command that doesn't exist
+            msg = "no such command {!r}".format(parsed_args.command_to_help)
+            help_text = helptexts.get_usage_message('charmcraft', msg)
+            retcode = 1
+        else:
+            cmd_class, group = all_commands[parsed_args.command_to_help]
+            cmd = cmd_class(group, None)
+            parser = CustomArgumentParser(prog=cmd.name, add_help=False)
+            cmd.fill_parser(parser)
+            help_text = get_command_help(parser, cmd)
+        raise CommandError(help_text, argsparsing=True, retcode=retcode)
+
+
+# Collect commands in different groups, for easier human consumption. Note that this is not
+# declared in each command because it's much easier to do this separation/grouping in one
+# central place and not distributed in several classes/files. Also note that order here is
+# important when lisgint commands and showing help.
+COMMAND_GROUPS = [
+    ('basic', "Basic", [
+        HelpCommand,
+        build.BuildCommand,
+        pack.PackCommand,
+        init.InitCommand,
+        version.VersionCommand,
+    ]),
+    ('store', "Charmhub", [
+        # auth
+        store.LoginCommand, store.LogoutCommand, store.WhoamiCommand,
+        # name handling
+        store.RegisterNameCommand, store.ListNamesCommand,
+        # pushing files and checking revisions
+        store.UploadCommand, store.ListRevisionsCommand,
+        # release process, and show status
+        store.ReleaseCommand, store.StatusCommand,
+        # libraries support
+        store.CreateLibCommand, store.PublishLibCommand, store.ListLibCommand,
+        store.FetchLibCommand,
+    ]),
+]
+
+
+# global options: the name used internally, its type, short and long parameters, and help text
+_Global = namedtuple('Global', 'name type short_option long_option help_message')
+GLOBAL_ARGS = [
+    _Global('help', 'flag', '-h', '--help', "Show this help message and exit"),
+    _Global('verbose', 'flag', '-v', '--verbose', "Show debug information and be more verbose"),
+    _Global('quiet', 'flag', '-q', '--quiet', "Only show warnings and errors, not progress"),
+    _Global(
+        'project_dir', 'option', '-p', '--project-dir',
+        "Specify the project's directory (defaults to current)"),
+]
+
+
+class CustomArgumentParser(argparse.ArgumentParser):
+    """ArgumentParser with custom error manager.."""
+
+    def error(self, message):
+        """Show the usage, the error message, and no more."""
+        fullcommand = "charmcraft " + self.prog
+        full_msg = helptexts.get_usage_message(fullcommand, message)
+        raise CommandError(full_msg, argsparsing=True)
+
+
+def _get_global_options():
+    """Return the global flags ready to present as options in the help messages."""
+    options = []
+    for arg in GLOBAL_ARGS:
+        options.append(("{}, {}".format(arg.short_option, arg.long_option), arg.help_message))
+    return options
+
+
+def get_command_help(parser, command):
+    """Produce the complete help message for a command."""
+    options = _get_global_options()
+
+    for action in parser._actions:
+        # store the different options if present, otherwise it's just the dest
+        if action.option_strings:
+            options.append((', '.join(action.option_strings), action.help))
+        else:
+            options.append((action.dest, action.help))
+
+    help_text = helptexts.get_command_help(COMMAND_GROUPS, command, options)
+    return help_text
+
+
+def get_general_help(detailed=False):
+    """Produce the "general charmcraft" help."""
+    options = _get_global_options()
+    if detailed:
+        help_text = helptexts.get_detailed_help(COMMAND_GROUPS, options)
+    else:
+        help_text = helptexts.get_full_help(COMMAND_GROUPS, options)
+    return help_text
+
+
+class Dispatcher:
+    """Set up infrastructure and let the needed command run.
+
+    ♪♫"Leeeeeet, the command ruuun"♪♫ https://www.youtube.com/watch?v=cv-0mmVnxPA
+    """
+
+    def __init__(self, sysargs, commands_groups):
+        self.commands = self._get_commands_info(commands_groups)
+        command_name, cmd_args, charmcraft_config = self._pre_parse_args(sysargs)
+        self.command, self.parsed_args = self._load_command(
+            command_name, cmd_args, charmcraft_config)
+
+    def _get_commands_info(self, commands_groups):
+        """Process the commands groups structure for easier programmable access."""
+        commands = {}
+        for _cmd_group, _, _cmd_classes in commands_groups:
+            for _cmd_class in _cmd_classes:
+                if _cmd_class.name in commands:
+                    _stored_class, _ = commands[_cmd_class.name]
+                    raise RuntimeError(
+                        "Multiple commands with same name: {} and {}".format(
+                            _cmd_class.__name__, _stored_class.__name__))
+                commands[_cmd_class.name] = (_cmd_class, _cmd_group)
+        return commands
+
+    def _load_command(self, command_name, cmd_args, charmcraft_config):
+        """Load a command."""
+        cmd_class, group = self.commands[command_name]
+        cmd = cmd_class(group, charmcraft_config)
+
+        # load and parse the command specific options/params
+        parser = CustomArgumentParser(prog=cmd.name)
+        cmd.fill_parser(parser)
+        parsed_args = parser.parse_args(cmd_args)
+        logger.debug("Command parsed sysargs: %s", parsed_args)
+
+        return cmd, parsed_args
+
+    def _pre_parse_args(self, sysargs):
+        """Pre-parse sys args.
+
+        Several steps:
+
+        - extract the global options and detects the possible command and its args
+
+        - validate global options and apply them
+
+        - validate that command is correct (NOT loading and parsing its arguments)
+        """
+        # get all arguments (default to what's specified) and those per options, to filter sysargs
+        global_args = {}
+        arg_per_option = {}
+        options_with_equal = []
+        for arg in GLOBAL_ARGS:
+            arg_per_option[arg.short_option] = arg
+            arg_per_option[arg.long_option] = arg
+            if arg.type == 'flag':
+                default = False
+            elif arg.type == 'option':
+                default = None
+                options_with_equal.append(arg.long_option + '=')
+            else:
+                raise ValueError("Bad GLOBAL_ARGS structure.")
+            global_args[arg.name] = default
+
+        filtered_sysargs = []
+        sysargs = iter(sysargs)
+        options_with_equal = tuple(options_with_equal)
+        for sysarg in sysargs:
+            if sysarg in arg_per_option:
+                arg = arg_per_option[sysarg]
+                if arg.type == 'flag':
+                    value = True
+                else:
+                    try:
+                        value = next(sysargs)
+                    except StopIteration:
+                        raise CommandError("The 'project-dir' option expects one argument.")
+                global_args[arg.name] = value
+            elif sysarg.startswith(options_with_equal):
+                option, value = sysarg.split('=', 1)
+                if not value:
+                    raise CommandError("The 'project-dir' option expects one argument.")
+                arg = arg_per_option[option]
+                global_args[arg.name] = value
+            else:
+                filtered_sysargs.append(sysarg)
+
+        # control and use quiet/verbose options
+        if global_args['quiet'] and global_args['verbose']:
+            raise CommandError("The 'verbose' and 'quiet' options are mutually exclusive.")
+        if global_args['quiet']:
+            message_handler.set_mode(message_handler.QUIET)
+        elif global_args['verbose']:
+            message_handler.set_mode(message_handler.VERBOSE)
+        logger.debug("Raw pre-parsed sysargs: args=%s filtered=%s", global_args, filtered_sysargs)
+
+        # if help requested, transform the parameters to make that explicit
+        if global_args['help']:
+            command = HelpCommand.name
+            cmd_args = filtered_sysargs
+        elif filtered_sysargs:
+            command = filtered_sysargs[0]
+            cmd_args = filtered_sysargs[1:]
+            if command not in self.commands:
+                msg = "no such command {!r}".format(command)
+                help_text = helptexts.get_usage_message('charmcraft', msg)
+                raise CommandError(help_text, argsparsing=True)
+        else:
+            # no command!
+            help_text = get_general_help()
+            raise CommandError(help_text, argsparsing=True)
+
+        # load the system's config
+        charmcraft_config = config.load(global_args['project_dir'])
+
+        logger.debug("General parsed sysargs: command=%r args=%s", command, cmd_args)
+        return command, cmd_args, charmcraft_config
+
+    def run(self):
+        """Really run the command."""
+        if isinstance(self.command, HelpCommand):
+            self.command.run(self.parsed_args, self.commands)
+        else:
+            if self.command.needs_config and not self.command.config.project.config_provided:
+                raise CommandError(
+                    "The specified command needs a valid 'charmcraft.yaml' configuration file (in "
+                    "the current directory or where specified with --project-dir option); see "
+                    "the reference: https://discourse.charmhub.io/t/charmcraft-configuration/4138")
+            self.command.run(self.parsed_args)
+
+
+def main(argv=None):
+    """Provide the main entry point."""
+    message_handler.init(message_handler.NORMAL)
+
+    if argv is None:
+        argv = sys.argv
+
+    # process
+    try:
+        dispatcher = Dispatcher(argv[1:], COMMAND_GROUPS)
+        dispatcher.run()
+    except CommandError as err:
+        message_handler.ended_cmderror(err)
+        retcode = err.retcode
+    except KeyboardInterrupt:
+        message_handler.ended_interrupt()
+        retcode = 1
+    except Exception as err:
+        message_handler.ended_crash(err)
+        retcode = 1
+    else:
+        message_handler.ended_ok()
+        retcode = 0
+
+    return retcode
+
+
+if __name__ == '__main__':
+    sys.exit(main(sys.argv))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/charmlibs/new_library.py.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/charmlibs/new_library.py.j2
new file mode 100644
index 0000000000000000000000000000000000000000..4a7da958b28af51c10c52ec890ef5996c5b1c6d0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/charmlibs/new_library.py.j2
@@ -0,0 +1,29 @@
+"""TODO: Add a proper docstring here.
+
+This is a placeholder docstring for this charm library. Docstrings are
+presented on Charmhub and updated whenever you push a new version of the
+library.
+
+See `charmcraft push-lib` and `charmcraft fetch-lib` for details of how to
+share and consume charm libraries. They serve to enhance collaboration
+between charmers. Use a charmer's libraries for classes that handle
+integration with their charm.
+
+Bear in mind that new revisions of the different major API versions (v0, v1,
+v2 etc) are maintained independently.  You can continue to update v0 and v1
+after you have pushed v3.
+
+Markdown is supported, following the CommonMark specification.
+"""
+
+# The unique Charmhub library identifier, never change it
+LIBID = "{{ lib_id }}"
+
+# Increment this major API version when introducing breaking changes
+LIBAPI = 0
+
+# Increment this PATCH version before using `charmcraft push-lib` or reset
+# to 0 if you are raising the major API version
+LIBPATCH = 1
+
+# TODO: add your code here! Happy coding!
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.flake8.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.flake8.j2
new file mode 100644
index 0000000000000000000000000000000000000000..8ef84fcd43f3b7a46768c31b20f36cab48ffdfe0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.flake8.j2
@@ -0,0 +1,9 @@
+[flake8]
+max-line-length = 99
+select: E,W,F,C,N
+exclude:
+  venv
+  .git
+  build
+  dist
+  *.egg_info
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.jujuignore.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.jujuignore.j2
new file mode 100644
index 0000000000000000000000000000000000000000..6ccd559eabeae93e4d23215fa450130fa9b37ace
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/.jujuignore.j2
@@ -0,0 +1,3 @@
+/venv
+*.py[cod]
+*.charm
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/LICENSE.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/LICENSE.j2
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/LICENSE.j2
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/README.md.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/README.md.j2
new file mode 100644
index 0000000000000000000000000000000000000000..a1a54301787085d192da3c1908d3a312794eab4c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/README.md.j2
@@ -0,0 +1,25 @@
+# {{ name }}
+
+## Description
+
+TODO: Describe your charm in a few paragraphs of Markdown
+
+## Usage
+
+TODO: Provide high-level usage, such as required config or relations
+
+
+## Developing
+
+Create and activate a virtualenv with the development requirements:
+
+    virtualenv -p python3 venv
+    source venv/bin/activate
+    pip install -r requirements-dev.txt
+
+## Testing
+
+The Python operator framework includes a very nice harness for testing
+operator behaviour without full deployment. Just `run_tests`:
+
+    ./run_tests
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/actions.yaml.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/actions.yaml.j2
new file mode 100644
index 0000000000000000000000000000000000000000..98b14cea956651115a3851241e1e8737bd3500d2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/actions.yaml.j2
@@ -0,0 +1,14 @@
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need actions, you can remove the file entirely.
+# It ties in to the example _on_fortune_action handler in src/charm.py
+# 
+# fortune:
+#   description: Returns a pithy phrase.
+#   params:
+#     fail:
+#       description: "Fail with this message"
+#       type: string
+#       default: ""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/config.yaml.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/config.yaml.j2
new file mode 100644
index 0000000000000000000000000000000000000000..5f47d30fc928b54fbc5ad314ab9dd086302a43c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/config.yaml.j2
@@ -0,0 +1,11 @@
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need config, you can remove the file entirely.
+# 
+# options:
+#   thing:
+#     default: 🎁
+#     description: A thing used by the charm.
+#     type: string
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/metadata.yaml.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/metadata.yaml.j2
new file mode 100644
index 0000000000000000000000000000000000000000..c26951c23c21059d96eedd51d7db7268c3aa08f3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/metadata.yaml.j2
@@ -0,0 +1,9 @@
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+name: {{ name }}
+description: |
+  TODO: fill out the charm's description
+summary: |
+  TODO: fill out the charm's summary
+series: {{ series }}
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements-dev.txt.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements-dev.txt.j2
new file mode 100644
index 0000000000000000000000000000000000000000..4f2a3f5bcd8cf79122b586c767c812b481079593
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements-dev.txt.j2
@@ -0,0 +1,3 @@
+-r requirements.txt
+coverage
+flake8
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements.txt.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements.txt.j2
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/requirements.txt.j2
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/run_tests.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/run_tests.j2
new file mode 100755
index 0000000000000000000000000000000000000000..da70cb36f2fbbac9264aa89430d571532bebf9ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/run_tests.j2
@@ -0,0 +1,17 @@
+#!/bin/sh -e
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+
+if [ -z "$VIRTUAL_ENV" -a -d venv/ ]; then
+    . venv/bin/activate
+fi
+
+if [ -z "$PYTHONPATH" ]; then
+    export PYTHONPATH=src
+else
+    export PYTHONPATH="src:$PYTHONPATH"
+fi
+
+flake8
+coverage run --source=src -m unittest -v "$@"
+coverage report -m
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/src/charm.py.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/src/charm.py.j2
new file mode 100644
index 0000000000000000000000000000000000000000..d7ea6197e1570a2c1ac87b915c861db91e26fcb8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/src/charm.py.j2
@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+
+"""Charm the service."""
+
+import logging
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.framework import StoredState
+
+logger = logging.getLogger(__name__)
+
+
+class {{ class_name }}(CharmBase):
+    """Charm the service."""
+
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.config_changed, self._on_config_changed)
+        self.framework.observe(self.on.fortune_action, self._on_fortune_action)
+        self._stored.set_default(things=[])
+
+    def _on_config_changed(self, _):
+        # Note: you need to uncomment the example in the config.yaml file for this to work (ensure
+        # to not just leave the example, but adapt to your configuration needs)
+        current = self.config["thing"]
+        if current not in self._stored.things:
+            logger.debug("found a new thing: %r", current)
+            self._stored.things.append(current)
+
+    def _on_fortune_action(self, event):
+        # Note: you need to uncomment the example in the actions.yaml file for this to work (ensure
+        # to not just leave the example, but adapt to your needs for actions commands)
+        fail = event.params["fail"]
+        if fail:
+            event.fail(fail)
+        else:
+            event.set_results({"fortune": "A bug in the code is worth two in the documentation."})
+
+
+if __name__ == "__main__":
+    main({{ class_name }})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/tests/__init__.py.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/tests/__init__.py.j2
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/tests/test_charm.py.j2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/tests/test_charm.py.j2
new file mode 100644
index 0000000000000000000000000000000000000000..e0348ff32d7f1cf8d8201dd2499f9feb87cc973c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/templates/init/tests/test_charm.py.j2
@@ -0,0 +1,35 @@
+# Copyright {{ year }} {{ author }}
+# See LICENSE file for licensing details.
+
+import unittest
+from unittest.mock import Mock
+
+from ops.testing import Harness
+from charm import {{ class_name }}
+
+
+class TestCharm(unittest.TestCase):
+    def test_config_changed(self):
+        harness = Harness({{ class_name }})
+        self.addCleanup(harness.cleanup)
+        harness.begin()
+        self.assertEqual(list(harness.charm._stored.things), [])
+        harness.update_config({"thing": "foo"})
+        self.assertEqual(list(harness.charm._stored.things), ["foo"])
+
+    def test_action(self):
+        harness = Harness({{ class_name }})
+        harness.begin()
+        # the harness doesn't (yet!) help much with actions themselves
+        action_event = Mock(params={"fail": ""})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertTrue(action_event.set_results.called)
+
+    def test_action_fail(self):
+        harness = Harness({{ class_name }})
+        harness.begin()
+        action_event = Mock(params={"fail": "fail this"})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertEqual(action_event.fail.call_args, [("fail this",)])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..8dc03a5b773040f0048a654b2a5c752f3d6cc41d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/utils.py
@@ -0,0 +1,66 @@
+# Copyright 2020-2021 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For further info, check https://github.com/canonical/charmcraft
+
+"""Collection of utilities for charmcraft."""
+
+import logging
+import os
+from stat import S_IXUSR, S_IXGRP, S_IXOTH, S_IRUSR, S_IRGRP, S_IROTH
+
+import yaml
+from jinja2 import Environment, PackageLoader, StrictUndefined
+
+logger = logging.getLogger('charmcraft.commands')
+
+
+# handy masks for execution and reading for everybody
+S_IXALL = S_IXUSR | S_IXGRP | S_IXOTH
+S_IRALL = S_IRUSR | S_IRGRP | S_IROTH
+
+
+def make_executable(fh):
+    """Make open file fh executable."""
+    fileno = fh.fileno()
+    mode = os.fstat(fileno).st_mode
+    mode_r = mode & S_IRALL
+    mode_x = mode_r >> 2
+    mode = mode | mode_x
+    os.fchmod(fileno, mode)
+
+
+def load_yaml(fpath):
+    """Return the content of a YAML file."""
+    if not fpath.is_file():
+        logger.debug("Couldn't find config file %s", fpath)
+        return
+    try:
+        with fpath.open('rb') as fh:
+            content = yaml.safe_load(fh)
+    except (yaml.error.YAMLError, OSError) as err:
+        logger.error("Failed to read/parse config file %s: %r", fpath, err)
+        return
+    return content
+
+
+def get_templates_environment(templates_dir):
+    """Create and return a Jinja environment to deal with the templates."""
+    env = Environment(
+        loader=PackageLoader('charmcraft', 'templates/{}'.format(templates_dir)),
+        autoescape=False,            # no need to escape things here :-)
+        keep_trailing_newline=True,  # they're not text files if they don't end in newline!
+        optimized=False,             # optimization doesn't make sense for one-offs
+        undefined=StrictUndefined)   # fail on undefined
+    return env
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..eac7dc5ef0c3dfd7cd8e9297ce0ba6bc8521ea95
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/charmcraft/version.py
@@ -0,0 +1,4 @@
+
+# this is a generated file
+
+version = '0.8.1'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c455cb515632088458de0546ddad104e029b64ba
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/METADATA
@@ -0,0 +1,411 @@
+Metadata-Version: 2.1
+Name: colorama
+Version: 0.4.3
+Summary: Cross-platform colored terminal text.
+Home-page: https://github.com/tartley/colorama
+Author: Jonathan Hartley
+Author-email: tartley@tartley.com
+Maintainer: Arnon Yaari
+License: BSD
+Keywords: color colour terminal text ansi windows crossplatform xplatform
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Terminals
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+
+.. image:: https://img.shields.io/pypi/v/colorama.svg
+    :target: https://pypi.org/project/colorama/
+    :alt: Latest Version
+
+.. image:: https://img.shields.io/pypi/pyversions/colorama.svg
+    :target: https://pypi.org/project/colorama/
+    :alt: Supported Python versions
+
+.. image:: https://travis-ci.org/tartley/colorama.svg?branch=master
+    :target: https://travis-ci.org/tartley/colorama
+    :alt: Build Status
+
+Download and docs:
+    https://pypi.org/project/colorama/
+Source code & Development:
+    https://github.com/tartley/colorama
+Colorama for Enterprise:
+    https://github.com/tartley/colorama/blob/master/ENTERPRISE.md
+
+Description
+===========
+
+Makes ANSI escape character sequences (for producing colored terminal text and
+cursor positioning) work under MS Windows.
+
+ANSI escape character sequences have long been used to produce colored terminal
+text and cursor positioning on Unix and Macs. Colorama makes this work on
+Windows, too, by wrapping ``stdout``, stripping ANSI sequences it finds (which
+would appear as gobbledygook in the output), and converting them into the
+appropriate win32 calls to modify the state of the terminal. On other platforms,
+Colorama does nothing.
+
+Colorama also provides some shortcuts to help generate ANSI sequences
+but works fine in conjunction with any other ANSI sequence generation library,
+such as the venerable Termcolor (https://pypi.org/project/termcolor/)
+or the fabulous Blessings (https://pypi.org/project/blessings/).
+
+This has the upshot of providing a simple cross-platform API for printing
+colored terminal text from Python, and has the happy side-effect that existing
+applications or libraries which use ANSI sequences to produce colored output on
+Linux or Macs can now also work on Windows, simply by calling
+``colorama.init()``.
+
+An alternative approach is to install ``ansi.sys`` on Windows machines, which
+provides the same behaviour for all applications running in terminals. Colorama
+is intended for situations where that isn't easy (e.g., maybe your app doesn't
+have an installer.)
+
+Demo scripts in the source code repository print some colored text using
+ANSI sequences. Compare their output under Gnome-terminal's built in ANSI
+handling, versus on Windows Command-Prompt using Colorama:
+
+.. image:: https://github.com/tartley/colorama/raw/master/screenshots/ubuntu-demo.png
+    :width: 661
+    :height: 357
+    :alt: ANSI sequences on Ubuntu under gnome-terminal.
+
+.. image:: https://github.com/tartley/colorama/raw/master/screenshots/windows-demo.png
+    :width: 668
+    :height: 325
+    :alt: Same ANSI sequences on Windows, using Colorama.
+
+These screengrabs show that, on Windows, Colorama does not support ANSI 'dim
+text'; it looks the same as 'normal text'.
+
+
+License
+=======
+
+Copyright Jonathan Hartley & Arnon Yaari, 2013. BSD 3-Clause license; see LICENSE file.
+
+
+Dependencies
+============
+
+None, other than Python. Tested on Python 2.7, 3.5, 3.6, 3.7 and 3.8.
+
+Usage
+=====
+
+Initialisation
+--------------
+
+Applications should initialise Colorama using:
+
+.. code-block:: python
+
+    from colorama import init
+    init()
+
+On Windows, calling ``init()`` will filter ANSI escape sequences out of any
+text sent to ``stdout`` or ``stderr``, and replace them with equivalent Win32
+calls.
+
+On other platforms, calling ``init()`` has no effect (unless you request other
+optional functionality; see "Init Keyword Args", below). By design, this permits
+applications to call ``init()`` unconditionally on all platforms, after which
+ANSI output should just work.
+
+To stop using colorama before your program exits, simply call ``deinit()``.
+This will restore ``stdout`` and ``stderr`` to their original values, so that
+Colorama is disabled. To resume using Colorama again, call ``reinit()``; it is
+cheaper to calling ``init()`` again (but does the same thing).
+
+
+Colored Output
+--------------
+
+Cross-platform printing of colored text can then be done using Colorama's
+constant shorthand for ANSI escape sequences:
+
+.. code-block:: python
+
+    from colorama import Fore, Back, Style
+    print(Fore.RED + 'some red text')
+    print(Back.GREEN + 'and with a green background')
+    print(Style.DIM + 'and in dim text')
+    print(Style.RESET_ALL)
+    print('back to normal now')
+
+...or simply by manually printing ANSI sequences from your own code:
+
+.. code-block:: python
+
+    print('\033[31m' + 'some red text')
+    print('\033[39m') # and reset to default color
+
+...or, Colorama can be used happily in conjunction with existing ANSI libraries
+such as Termcolor:
+
+.. code-block:: python
+
+    from colorama import init
+    from termcolor import colored
+
+    # use Colorama to make Termcolor work on Windows too
+    init()
+
+    # then use Termcolor for all colored text output
+    print(colored('Hello, World!', 'green', 'on_red'))
+
+Available formatting constants are::
+
+    Fore: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET.
+    Back: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE, RESET.
+    Style: DIM, NORMAL, BRIGHT, RESET_ALL
+
+``Style.RESET_ALL`` resets foreground, background, and brightness. Colorama will
+perform this reset automatically on program exit.
+
+
+Cursor Positioning
+------------------
+
+ANSI codes to reposition the cursor are supported. See ``demos/demo06.py`` for
+an example of how to generate them.
+
+
+Init Keyword Args
+-----------------
+
+``init()`` accepts some ``**kwargs`` to override default behaviour.
+
+init(autoreset=False):
+    If you find yourself repeatedly sending reset sequences to turn off color
+    changes at the end of every print, then ``init(autoreset=True)`` will
+    automate that:
+
+    .. code-block:: python
+
+        from colorama import init
+        init(autoreset=True)
+        print(Fore.RED + 'some red text')
+        print('automatically back to default color again')
+
+init(strip=None):
+    Pass ``True`` or ``False`` to override whether ansi codes should be
+    stripped from the output. The default behaviour is to strip if on Windows
+    or if output is redirected (not a tty).
+
+init(convert=None):
+    Pass ``True`` or ``False`` to override whether to convert ANSI codes in the
+    output into win32 calls. The default behaviour is to convert if on Windows
+    and output is to a tty (terminal).
+
+init(wrap=True):
+    On Windows, colorama works by replacing ``sys.stdout`` and ``sys.stderr``
+    with proxy objects, which override the ``.write()`` method to do their work.
+    If this wrapping causes you problems, then this can be disabled by passing
+    ``init(wrap=False)``. The default behaviour is to wrap if ``autoreset`` or
+    ``strip`` or ``convert`` are True.
+
+    When wrapping is disabled, colored printing on non-Windows platforms will
+    continue to work as normal. To do cross-platform colored output, you can
+    use Colorama's ``AnsiToWin32`` proxy directly:
+
+    .. code-block:: python
+
+        import sys
+        from colorama import init, AnsiToWin32
+        init(wrap=False)
+        stream = AnsiToWin32(sys.stderr).stream
+
+        # Python 2
+        print >>stream, Fore.BLUE + 'blue text on stderr'
+
+        # Python 3
+        print(Fore.BLUE + 'blue text on stderr', file=stream)
+
+
+Installation
+=======================
+colorama is currently installable from PyPI:
+
+    pip install colorama
+
+colorama also can be installed by the conda package manager:
+
+    conda install -c anaconda colorama 
+
+
+Status & Known Problems
+=======================
+
+I've personally only tested it on Windows XP (CMD, Console2), Ubuntu
+(gnome-terminal, xterm), and OS X.
+
+Some presumably valid ANSI sequences aren't recognised (see details below),
+but to my knowledge nobody has yet complained about this. Puzzling.
+
+See outstanding issues and wishlist:
+https://github.com/tartley/colorama/issues
+
+If anything doesn't work for you, or doesn't do what you expected or hoped for,
+I'd love to hear about it on that issues list, would be delighted by patches,
+and would be happy to grant commit access to anyone who submits a working patch
+or two.
+
+
+Recognised ANSI Sequences
+=========================
+
+ANSI sequences generally take the form:
+
+    ESC [ <param> ; <param> ... <command>
+
+Where ``<param>`` is an integer, and ``<command>`` is a single letter. Zero or
+more params are passed to a ``<command>``. If no params are passed, it is
+generally synonymous with passing a single zero. No spaces exist in the
+sequence; they have been inserted here simply to read more easily.
+
+The only ANSI sequences that colorama converts into win32 calls are::
+
+    ESC [ 0 m       # reset all (colors and brightness)
+    ESC [ 1 m       # bright
+    ESC [ 2 m       # dim (looks same as normal brightness)
+    ESC [ 22 m      # normal brightness
+
+    # FOREGROUND:
+    ESC [ 30 m      # black
+    ESC [ 31 m      # red
+    ESC [ 32 m      # green
+    ESC [ 33 m      # yellow
+    ESC [ 34 m      # blue
+    ESC [ 35 m      # magenta
+    ESC [ 36 m      # cyan
+    ESC [ 37 m      # white
+    ESC [ 39 m      # reset
+
+    # BACKGROUND
+    ESC [ 40 m      # black
+    ESC [ 41 m      # red
+    ESC [ 42 m      # green
+    ESC [ 43 m      # yellow
+    ESC [ 44 m      # blue
+    ESC [ 45 m      # magenta
+    ESC [ 46 m      # cyan
+    ESC [ 47 m      # white
+    ESC [ 49 m      # reset
+
+    # cursor positioning
+    ESC [ y;x H     # position cursor at x across, y down
+    ESC [ y;x f     # position cursor at x across, y down
+    ESC [ n A       # move cursor n lines up
+    ESC [ n B       # move cursor n lines down
+    ESC [ n C       # move cursor n characters forward
+    ESC [ n D       # move cursor n characters backward
+
+    # clear the screen
+    ESC [ mode J    # clear the screen
+
+    # clear the line
+    ESC [ mode K    # clear the line
+
+Multiple numeric params to the ``'m'`` command can be combined into a single
+sequence::
+
+    ESC [ 36 ; 45 ; 1 m     # bright cyan text on magenta background
+
+All other ANSI sequences of the form ``ESC [ <param> ; <param> ... <command>``
+are silently stripped from the output on Windows.
+
+Any other form of ANSI sequence, such as single-character codes or alternative
+initial characters, are not recognised or stripped. It would be cool to add
+them though. Let me know if it would be useful for you, via the Issues on
+GitHub.
+
+
+Development
+===========
+
+Help and fixes welcome!
+
+Running tests requires:
+
+- Michael Foord's ``mock`` module to be installed.
+- Tests are written using 2010-era updates to ``unittest``
+
+To run tests::
+
+   python -m unittest discover -p *_test.py
+
+This, like a few other handy commands, is captured in a ``Makefile``.
+
+If you use nose to run the tests, you must pass the ``-s`` flag; otherwise,
+``nosetests`` applies its own proxy to ``stdout``, which confuses the unit
+tests.
+
+
+Professional support
+====================
+
+.. |tideliftlogo| image:: https://cdn2.hubspot.net/hubfs/4008838/website/logos/logos_for_download/Tidelift_primary-shorthand-logo.png
+   :alt: Tidelift
+   :target: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme
+
+.. list-table::
+   :widths: 10 100
+
+   * - |tideliftlogo|
+     - Professional support for colorama is available as part of the
+       `Tidelift Subscription`_.
+       Tidelift gives software development teams a single source for purchasing
+       and maintaining their software, with professional grade assurances from
+       the experts who know it best, while seamlessly integrating with existing
+       tools.
+
+.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-colorama?utm_source=pypi-colorama&utm_medium=referral&utm_campaign=readme
+
+
+Thanks
+======
+* Marc Schlaich (schlamar) for a ``setup.py`` fix for Python2.5.
+* Marc Abramowitz, reported & fixed a crash on exit with closed ``stdout``,
+  providing a solution to issue #7's setuptools/distutils debate,
+  and other fixes.
+* User 'eryksun', for guidance on correctly instantiating ``ctypes.windll``.
+* Matthew McCormick for politely pointing out a longstanding crash on non-Win.
+* Ben Hoyt, for a magnificent fix under 64-bit Windows.
+* Jesse at Empty Square for submitting a fix for examples in the README.
+* User 'jamessp', an observant documentation fix for cursor positioning.
+* User 'vaal1239', Dave Mckee & Lackner Kristof for a tiny but much-needed Win7
+  fix.
+* Julien Stuyck, for wisely suggesting Python3 compatible updates to README.
+* Daniel Griffith for multiple fabulous patches.
+* Oscar Lesta for a valuable fix to stop ANSI chars being sent to non-tty
+  output.
+* Roger Binns, for many suggestions, valuable feedback, & bug reports.
+* Tim Golden for thought and much appreciated feedback on the initial idea.
+* User 'Zearin' for updates to the README file.
+* John Szakmeister for adding support for light colors
+* Charles Merriam for adding documentation to demos
+* Jurko for a fix on 64-bit Windows CPython2.5 w/o ctypes
+* Florian Bruhin for a fix when stdout or stderr are None
+* Thomas Weininger for fixing ValueError on Windows
+* Remi Rampin for better Github integration and fixes to the README file
+* Simeon Visser for closing a file handle using 'with' and updating classifiers
+  to include Python 3.3 and 3.4
+* Andy Neff for fixing RESET of LIGHT_EX colors.
+* Jonathan Hartley for the initial idea and implementation.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f9bdc1a7459d9ef1d2e133712e2c56cadbf2d773
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/RECORD
@@ -0,0 +1,22 @@
+colorama/__init__.py,sha256=DqjXH9URVP3IJwmMt7peYw50ns1RNAymIB9-XdPEFV8,239
+colorama/ansi.py,sha256=Fi0un-QLqRm-v7o_nKiOqyC8PapBJK7DLV_q9LKtTO0,2524
+colorama/ansitowin32.py,sha256=u8QaqdqS_xYSfNkPM1eRJLHz6JMWPodaJaP0mxgHCDc,10462
+colorama/initialise.py,sha256=PprovDNxMTrvoNHFcL2NZjpH2XzDc8BLxLxiErfUl4k,1915
+colorama/win32.py,sha256=bJ8Il9jwaBN5BJ8bmN6FoYZ1QYuMKv2j8fGrXh7TJjw,5404
+colorama/winterm.py,sha256=2y_2b7Zsv34feAsP67mLOVc-Bgq51mdYGo571VprlrM,6438
+colorama-0.4.3.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+colorama-0.4.3.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+colorama-0.4.3.dist-info/METADATA,sha256=-ovqULHfBHs9pV2e_Ua8-w2VSVLno-6x36SXSTsWvSc,14432
+colorama-0.4.3.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+colorama-0.4.3.dist-info/top_level.txt,sha256=_Kx6-Cni2BT1PEATPhrSRxo0d7kSgfBbHf5o7IF1ABw,9
+colorama-0.4.3.dist-info/RECORD,,
+colorama/__pycache__,,
+colorama/winterm.cpython-38.pyc,,
+colorama-0.4.3.dist-info/__pycache__,,
+colorama/ansi.cpython-38.pyc,,
+colorama/ansitowin32.cpython-38.pyc,,
+colorama/win32.cpython-38.pyc,,
+colorama-0.4.3.virtualenv,,
+colorama/initialise.cpython-38.pyc,,
+colorama/__init__.cpython-38.pyc,,
+colorama-0.4.3.dist-info/INSTALLER,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3fcfb51b2ad06cc0cb6c7155260a79fd2896b3d1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+colorama
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama-0.4.3.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..34c263cc8bb4a12d99b9d375193d4eb634ed094a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/__init__.py
@@ -0,0 +1,6 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from .initialise import init, deinit, reinit, colorama_text
+from .ansi import Fore, Back, Style, Cursor
+from .ansitowin32 import AnsiToWin32
+
+__version__ = '0.4.3'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansi.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansi.py
new file mode 100644
index 0000000000000000000000000000000000000000..78776588db9410924d8e4af0922fbc3960a37624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansi.py
@@ -0,0 +1,102 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+'''
+This module generates ANSI character codes to printing colors to terminals.
+See: http://en.wikipedia.org/wiki/ANSI_escape_code
+'''
+
+CSI = '\033['
+OSC = '\033]'
+BEL = '\007'
+
+
+def code_to_chars(code):
+    return CSI + str(code) + 'm'
+
+def set_title(title):
+    return OSC + '2;' + title + BEL
+
+def clear_screen(mode=2):
+    return CSI + str(mode) + 'J'
+
+def clear_line(mode=2):
+    return CSI + str(mode) + 'K'
+
+
+class AnsiCodes(object):
+    def __init__(self):
+        # the subclasses declare class attributes which are numbers.
+        # Upon instantiation we define instance attributes, which are the same
+        # as the class attributes but wrapped with the ANSI escape sequence
+        for name in dir(self):
+            if not name.startswith('_'):
+                value = getattr(self, name)
+                setattr(self, name, code_to_chars(value))
+
+
+class AnsiCursor(object):
+    def UP(self, n=1):
+        return CSI + str(n) + 'A'
+    def DOWN(self, n=1):
+        return CSI + str(n) + 'B'
+    def FORWARD(self, n=1):
+        return CSI + str(n) + 'C'
+    def BACK(self, n=1):
+        return CSI + str(n) + 'D'
+    def POS(self, x=1, y=1):
+        return CSI + str(y) + ';' + str(x) + 'H'
+
+
+class AnsiFore(AnsiCodes):
+    BLACK           = 30
+    RED             = 31
+    GREEN           = 32
+    YELLOW          = 33
+    BLUE            = 34
+    MAGENTA         = 35
+    CYAN            = 36
+    WHITE           = 37
+    RESET           = 39
+
+    # These are fairly well supported, but not part of the standard.
+    LIGHTBLACK_EX   = 90
+    LIGHTRED_EX     = 91
+    LIGHTGREEN_EX   = 92
+    LIGHTYELLOW_EX  = 93
+    LIGHTBLUE_EX    = 94
+    LIGHTMAGENTA_EX = 95
+    LIGHTCYAN_EX    = 96
+    LIGHTWHITE_EX   = 97
+
+
+class AnsiBack(AnsiCodes):
+    BLACK           = 40
+    RED             = 41
+    GREEN           = 42
+    YELLOW          = 43
+    BLUE            = 44
+    MAGENTA         = 45
+    CYAN            = 46
+    WHITE           = 47
+    RESET           = 49
+
+    # These are fairly well supported, but not part of the standard.
+    LIGHTBLACK_EX   = 100
+    LIGHTRED_EX     = 101
+    LIGHTGREEN_EX   = 102
+    LIGHTYELLOW_EX  = 103
+    LIGHTBLUE_EX    = 104
+    LIGHTMAGENTA_EX = 105
+    LIGHTCYAN_EX    = 106
+    LIGHTWHITE_EX   = 107
+
+
+class AnsiStyle(AnsiCodes):
+    BRIGHT    = 1
+    DIM       = 2
+    NORMAL    = 22
+    RESET_ALL = 0
+
+Fore   = AnsiFore()
+Back   = AnsiBack()
+Style  = AnsiStyle()
+Cursor = AnsiCursor()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansitowin32.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansitowin32.py
new file mode 100644
index 0000000000000000000000000000000000000000..359c92be50ee3c97aafbc8d31c16e5fbf2e6d022
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/ansitowin32.py
@@ -0,0 +1,257 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import re
+import sys
+import os
+
+from .ansi import AnsiFore, AnsiBack, AnsiStyle, Style
+from .winterm import WinTerm, WinColor, WinStyle
+from .win32 import windll, winapi_test
+
+
+winterm = None
+if windll is not None:
+    winterm = WinTerm()
+
+
+class StreamWrapper(object):
+    '''
+    Wraps a stream (such as stdout), acting as a transparent proxy for all
+    attribute access apart from method 'write()', which is delegated to our
+    Converter instance.
+    '''
+    def __init__(self, wrapped, converter):
+        # double-underscore everything to prevent clashes with names of
+        # attributes on the wrapped stream object.
+        self.__wrapped = wrapped
+        self.__convertor = converter
+
+    def __getattr__(self, name):
+        return getattr(self.__wrapped, name)
+
+    def __enter__(self, *args, **kwargs):
+        # special method lookup bypasses __getattr__/__getattribute__, see
+        # https://stackoverflow.com/questions/12632894/why-doesnt-getattr-work-with-exit
+        # thus, contextlib magic methods are not proxied via __getattr__
+        return self.__wrapped.__enter__(*args, **kwargs)
+
+    def __exit__(self, *args, **kwargs):
+        return self.__wrapped.__exit__(*args, **kwargs)
+
+    def write(self, text):
+        self.__convertor.write(text)
+
+    def isatty(self):
+        stream = self.__wrapped
+        if 'PYCHARM_HOSTED' in os.environ:
+            if stream is not None and (stream is sys.__stdout__ or stream is sys.__stderr__):
+                return True
+        try:
+            stream_isatty = stream.isatty
+        except AttributeError:
+            return False
+        else:
+            return stream_isatty()
+
+    @property
+    def closed(self):
+        stream = self.__wrapped
+        try:
+            return stream.closed
+        except AttributeError:
+            return True
+
+
+class AnsiToWin32(object):
+    '''
+    Implements a 'write()' method which, on Windows, will strip ANSI character
+    sequences from the text, and if outputting to a tty, will convert them into
+    win32 function calls.
+    '''
+    ANSI_CSI_RE = re.compile('\001?\033\\[((?:\\d|;)*)([a-zA-Z])\002?')   # Control Sequence Introducer
+    ANSI_OSC_RE = re.compile('\001?\033\\]((?:.|;)*?)(\x07)\002?')        # Operating System Command
+
+    def __init__(self, wrapped, convert=None, strip=None, autoreset=False):
+        # The wrapped stream (normally sys.stdout or sys.stderr)
+        self.wrapped = wrapped
+
+        # should we reset colors to defaults after every .write()
+        self.autoreset = autoreset
+
+        # create the proxy wrapping our output stream
+        self.stream = StreamWrapper(wrapped, self)
+
+        on_windows = os.name == 'nt'
+        # We test if the WinAPI works, because even if we are on Windows
+        # we may be using a terminal that doesn't support the WinAPI
+        # (e.g. Cygwin Terminal). In this case it's up to the terminal
+        # to support the ANSI codes.
+        conversion_supported = on_windows and winapi_test()
+
+        # should we strip ANSI sequences from our output?
+        if strip is None:
+            strip = conversion_supported or (not self.stream.closed and not self.stream.isatty())
+        self.strip = strip
+
+        # should we should convert ANSI sequences into win32 calls?
+        if convert is None:
+            convert = conversion_supported and not self.stream.closed and self.stream.isatty()
+        self.convert = convert
+
+        # dict of ansi codes to win32 functions and parameters
+        self.win32_calls = self.get_win32_calls()
+
+        # are we wrapping stderr?
+        self.on_stderr = self.wrapped is sys.stderr
+
+    def should_wrap(self):
+        '''
+        True if this class is actually needed. If false, then the output
+        stream will not be affected, nor will win32 calls be issued, so
+        wrapping stdout is not actually required. This will generally be
+        False on non-Windows platforms, unless optional functionality like
+        autoreset has been requested using kwargs to init()
+        '''
+        return self.convert or self.strip or self.autoreset
+
+    def get_win32_calls(self):
+        if self.convert and winterm:
+            return {
+                AnsiStyle.RESET_ALL: (winterm.reset_all, ),
+                AnsiStyle.BRIGHT: (winterm.style, WinStyle.BRIGHT),
+                AnsiStyle.DIM: (winterm.style, WinStyle.NORMAL),
+                AnsiStyle.NORMAL: (winterm.style, WinStyle.NORMAL),
+                AnsiFore.BLACK: (winterm.fore, WinColor.BLACK),
+                AnsiFore.RED: (winterm.fore, WinColor.RED),
+                AnsiFore.GREEN: (winterm.fore, WinColor.GREEN),
+                AnsiFore.YELLOW: (winterm.fore, WinColor.YELLOW),
+                AnsiFore.BLUE: (winterm.fore, WinColor.BLUE),
+                AnsiFore.MAGENTA: (winterm.fore, WinColor.MAGENTA),
+                AnsiFore.CYAN: (winterm.fore, WinColor.CYAN),
+                AnsiFore.WHITE: (winterm.fore, WinColor.GREY),
+                AnsiFore.RESET: (winterm.fore, ),
+                AnsiFore.LIGHTBLACK_EX: (winterm.fore, WinColor.BLACK, True),
+                AnsiFore.LIGHTRED_EX: (winterm.fore, WinColor.RED, True),
+                AnsiFore.LIGHTGREEN_EX: (winterm.fore, WinColor.GREEN, True),
+                AnsiFore.LIGHTYELLOW_EX: (winterm.fore, WinColor.YELLOW, True),
+                AnsiFore.LIGHTBLUE_EX: (winterm.fore, WinColor.BLUE, True),
+                AnsiFore.LIGHTMAGENTA_EX: (winterm.fore, WinColor.MAGENTA, True),
+                AnsiFore.LIGHTCYAN_EX: (winterm.fore, WinColor.CYAN, True),
+                AnsiFore.LIGHTWHITE_EX: (winterm.fore, WinColor.GREY, True),
+                AnsiBack.BLACK: (winterm.back, WinColor.BLACK),
+                AnsiBack.RED: (winterm.back, WinColor.RED),
+                AnsiBack.GREEN: (winterm.back, WinColor.GREEN),
+                AnsiBack.YELLOW: (winterm.back, WinColor.YELLOW),
+                AnsiBack.BLUE: (winterm.back, WinColor.BLUE),
+                AnsiBack.MAGENTA: (winterm.back, WinColor.MAGENTA),
+                AnsiBack.CYAN: (winterm.back, WinColor.CYAN),
+                AnsiBack.WHITE: (winterm.back, WinColor.GREY),
+                AnsiBack.RESET: (winterm.back, ),
+                AnsiBack.LIGHTBLACK_EX: (winterm.back, WinColor.BLACK, True),
+                AnsiBack.LIGHTRED_EX: (winterm.back, WinColor.RED, True),
+                AnsiBack.LIGHTGREEN_EX: (winterm.back, WinColor.GREEN, True),
+                AnsiBack.LIGHTYELLOW_EX: (winterm.back, WinColor.YELLOW, True),
+                AnsiBack.LIGHTBLUE_EX: (winterm.back, WinColor.BLUE, True),
+                AnsiBack.LIGHTMAGENTA_EX: (winterm.back, WinColor.MAGENTA, True),
+                AnsiBack.LIGHTCYAN_EX: (winterm.back, WinColor.CYAN, True),
+                AnsiBack.LIGHTWHITE_EX: (winterm.back, WinColor.GREY, True),
+            }
+        return dict()
+
+    def write(self, text):
+        if self.strip or self.convert:
+            self.write_and_convert(text)
+        else:
+            self.wrapped.write(text)
+            self.wrapped.flush()
+        if self.autoreset:
+            self.reset_all()
+
+
+    def reset_all(self):
+        if self.convert:
+            self.call_win32('m', (0,))
+        elif not self.strip and not self.stream.closed:
+            self.wrapped.write(Style.RESET_ALL)
+
+
+    def write_and_convert(self, text):
+        '''
+        Write the given text to our wrapped stream, stripping any ANSI
+        sequences from the text, and optionally converting them into win32
+        calls.
+        '''
+        cursor = 0
+        text = self.convert_osc(text)
+        for match in self.ANSI_CSI_RE.finditer(text):
+            start, end = match.span()
+            self.write_plain_text(text, cursor, start)
+            self.convert_ansi(*match.groups())
+            cursor = end
+        self.write_plain_text(text, cursor, len(text))
+
+
+    def write_plain_text(self, text, start, end):
+        if start < end:
+            self.wrapped.write(text[start:end])
+            self.wrapped.flush()
+
+
+    def convert_ansi(self, paramstring, command):
+        if self.convert:
+            params = self.extract_params(command, paramstring)
+            self.call_win32(command, params)
+
+
+    def extract_params(self, command, paramstring):
+        if command in 'Hf':
+            params = tuple(int(p) if len(p) != 0 else 1 for p in paramstring.split(';'))
+            while len(params) < 2:
+                # defaults:
+                params = params + (1,)
+        else:
+            params = tuple(int(p) for p in paramstring.split(';') if len(p) != 0)
+            if len(params) == 0:
+                # defaults:
+                if command in 'JKm':
+                    params = (0,)
+                elif command in 'ABCD':
+                    params = (1,)
+
+        return params
+
+
+    def call_win32(self, command, params):
+        if command == 'm':
+            for param in params:
+                if param in self.win32_calls:
+                    func_args = self.win32_calls[param]
+                    func = func_args[0]
+                    args = func_args[1:]
+                    kwargs = dict(on_stderr=self.on_stderr)
+                    func(*args, **kwargs)
+        elif command in 'J':
+            winterm.erase_screen(params[0], on_stderr=self.on_stderr)
+        elif command in 'K':
+            winterm.erase_line(params[0], on_stderr=self.on_stderr)
+        elif command in 'Hf':     # cursor position - absolute
+            winterm.set_cursor_position(params, on_stderr=self.on_stderr)
+        elif command in 'ABCD':   # cursor position - relative
+            n = params[0]
+            # A - up, B - down, C - forward, D - back
+            x, y = {'A': (0, -n), 'B': (0, n), 'C': (n, 0), 'D': (-n, 0)}[command]
+            winterm.cursor_adjust(x, y, on_stderr=self.on_stderr)
+
+
+    def convert_osc(self, text):
+        for match in self.ANSI_OSC_RE.finditer(text):
+            start, end = match.span()
+            text = text[:start] + text[end:]
+            paramstring, command = match.groups()
+            if command in '\x07':       # \x07 = BEL
+                params = paramstring.split(";")
+                # 0 - change title and icon (we will only change title)
+                # 1 - change icon (we don't support this)
+                # 2 - change title
+                if params[0] in '02':
+                    winterm.set_title(params[1])
+        return text
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/initialise.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/initialise.py
new file mode 100644
index 0000000000000000000000000000000000000000..430d0668727cd0521270a52c962867907d743b34
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/initialise.py
@@ -0,0 +1,80 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+import atexit
+import contextlib
+import sys
+
+from .ansitowin32 import AnsiToWin32
+
+
+orig_stdout = None
+orig_stderr = None
+
+wrapped_stdout = None
+wrapped_stderr = None
+
+atexit_done = False
+
+
+def reset_all():
+    if AnsiToWin32 is not None:    # Issue #74: objects might become None at exit
+        AnsiToWin32(orig_stdout).reset_all()
+
+
+def init(autoreset=False, convert=None, strip=None, wrap=True):
+
+    if not wrap and any([autoreset, convert, strip]):
+        raise ValueError('wrap=False conflicts with any other arg=True')
+
+    global wrapped_stdout, wrapped_stderr
+    global orig_stdout, orig_stderr
+
+    orig_stdout = sys.stdout
+    orig_stderr = sys.stderr
+
+    if sys.stdout is None:
+        wrapped_stdout = None
+    else:
+        sys.stdout = wrapped_stdout = \
+            wrap_stream(orig_stdout, convert, strip, autoreset, wrap)
+    if sys.stderr is None:
+        wrapped_stderr = None
+    else:
+        sys.stderr = wrapped_stderr = \
+            wrap_stream(orig_stderr, convert, strip, autoreset, wrap)
+
+    global atexit_done
+    if not atexit_done:
+        atexit.register(reset_all)
+        atexit_done = True
+
+
+def deinit():
+    if orig_stdout is not None:
+        sys.stdout = orig_stdout
+    if orig_stderr is not None:
+        sys.stderr = orig_stderr
+
+
+@contextlib.contextmanager
+def colorama_text(*args, **kwargs):
+    init(*args, **kwargs)
+    try:
+        yield
+    finally:
+        deinit()
+
+
+def reinit():
+    if wrapped_stdout is not None:
+        sys.stdout = wrapped_stdout
+    if wrapped_stderr is not None:
+        sys.stderr = wrapped_stderr
+
+
+def wrap_stream(stream, convert, strip, autoreset, wrap):
+    if wrap:
+        wrapper = AnsiToWin32(stream,
+            convert=convert, strip=strip, autoreset=autoreset)
+        if wrapper.should_wrap():
+            stream = wrapper.stream
+    return stream
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/win32.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/win32.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2d836033673993e00a02d5a3802b61cd051cf08
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/win32.py
@@ -0,0 +1,152 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+
+# from winbase.h
+STDOUT = -11
+STDERR = -12
+
+try:
+    import ctypes
+    from ctypes import LibraryLoader
+    windll = LibraryLoader(ctypes.WinDLL)
+    from ctypes import wintypes
+except (AttributeError, ImportError):
+    windll = None
+    SetConsoleTextAttribute = lambda *_: None
+    winapi_test = lambda *_: None
+else:
+    from ctypes import byref, Structure, c_char, POINTER
+
+    COORD = wintypes._COORD
+
+    class CONSOLE_SCREEN_BUFFER_INFO(Structure):
+        """struct in wincon.h."""
+        _fields_ = [
+            ("dwSize", COORD),
+            ("dwCursorPosition", COORD),
+            ("wAttributes", wintypes.WORD),
+            ("srWindow", wintypes.SMALL_RECT),
+            ("dwMaximumWindowSize", COORD),
+        ]
+        def __str__(self):
+            return '(%d,%d,%d,%d,%d,%d,%d,%d,%d,%d,%d)' % (
+                self.dwSize.Y, self.dwSize.X
+                , self.dwCursorPosition.Y, self.dwCursorPosition.X
+                , self.wAttributes
+                , self.srWindow.Top, self.srWindow.Left, self.srWindow.Bottom, self.srWindow.Right
+                , self.dwMaximumWindowSize.Y, self.dwMaximumWindowSize.X
+            )
+
+    _GetStdHandle = windll.kernel32.GetStdHandle
+    _GetStdHandle.argtypes = [
+        wintypes.DWORD,
+    ]
+    _GetStdHandle.restype = wintypes.HANDLE
+
+    _GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo
+    _GetConsoleScreenBufferInfo.argtypes = [
+        wintypes.HANDLE,
+        POINTER(CONSOLE_SCREEN_BUFFER_INFO),
+    ]
+    _GetConsoleScreenBufferInfo.restype = wintypes.BOOL
+
+    _SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute
+    _SetConsoleTextAttribute.argtypes = [
+        wintypes.HANDLE,
+        wintypes.WORD,
+    ]
+    _SetConsoleTextAttribute.restype = wintypes.BOOL
+
+    _SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition
+    _SetConsoleCursorPosition.argtypes = [
+        wintypes.HANDLE,
+        COORD,
+    ]
+    _SetConsoleCursorPosition.restype = wintypes.BOOL
+
+    _FillConsoleOutputCharacterA = windll.kernel32.FillConsoleOutputCharacterA
+    _FillConsoleOutputCharacterA.argtypes = [
+        wintypes.HANDLE,
+        c_char,
+        wintypes.DWORD,
+        COORD,
+        POINTER(wintypes.DWORD),
+    ]
+    _FillConsoleOutputCharacterA.restype = wintypes.BOOL
+
+    _FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute
+    _FillConsoleOutputAttribute.argtypes = [
+        wintypes.HANDLE,
+        wintypes.WORD,
+        wintypes.DWORD,
+        COORD,
+        POINTER(wintypes.DWORD),
+    ]
+    _FillConsoleOutputAttribute.restype = wintypes.BOOL
+
+    _SetConsoleTitleW = windll.kernel32.SetConsoleTitleW
+    _SetConsoleTitleW.argtypes = [
+        wintypes.LPCWSTR
+    ]
+    _SetConsoleTitleW.restype = wintypes.BOOL
+
+    def _winapi_test(handle):
+        csbi = CONSOLE_SCREEN_BUFFER_INFO()
+        success = _GetConsoleScreenBufferInfo(
+            handle, byref(csbi))
+        return bool(success)
+
+    def winapi_test():
+        return any(_winapi_test(h) for h in
+                   (_GetStdHandle(STDOUT), _GetStdHandle(STDERR)))
+
+    def GetConsoleScreenBufferInfo(stream_id=STDOUT):
+        handle = _GetStdHandle(stream_id)
+        csbi = CONSOLE_SCREEN_BUFFER_INFO()
+        success = _GetConsoleScreenBufferInfo(
+            handle, byref(csbi))
+        return csbi
+
+    def SetConsoleTextAttribute(stream_id, attrs):
+        handle = _GetStdHandle(stream_id)
+        return _SetConsoleTextAttribute(handle, attrs)
+
+    def SetConsoleCursorPosition(stream_id, position, adjust=True):
+        position = COORD(*position)
+        # If the position is out of range, do nothing.
+        if position.Y <= 0 or position.X <= 0:
+            return
+        # Adjust for Windows' SetConsoleCursorPosition:
+        #    1. being 0-based, while ANSI is 1-based.
+        #    2. expecting (x,y), while ANSI uses (y,x).
+        adjusted_position = COORD(position.Y - 1, position.X - 1)
+        if adjust:
+            # Adjust for viewport's scroll position
+            sr = GetConsoleScreenBufferInfo(STDOUT).srWindow
+            adjusted_position.Y += sr.Top
+            adjusted_position.X += sr.Left
+        # Resume normal processing
+        handle = _GetStdHandle(stream_id)
+        return _SetConsoleCursorPosition(handle, adjusted_position)
+
+    def FillConsoleOutputCharacter(stream_id, char, length, start):
+        handle = _GetStdHandle(stream_id)
+        char = c_char(char.encode())
+        length = wintypes.DWORD(length)
+        num_written = wintypes.DWORD(0)
+        # Note that this is hard-coded for ANSI (vs wide) bytes.
+        success = _FillConsoleOutputCharacterA(
+            handle, char, length, start, byref(num_written))
+        return num_written.value
+
+    def FillConsoleOutputAttribute(stream_id, attr, length, start):
+        ''' FillConsoleOutputAttribute( hConsole, csbi.wAttributes, dwConSize, coordScreen, &cCharsWritten )'''
+        handle = _GetStdHandle(stream_id)
+        attribute = wintypes.WORD(attr)
+        length = wintypes.DWORD(length)
+        num_written = wintypes.DWORD(0)
+        # Note that this is hard-coded for ANSI (vs wide) bytes.
+        return _FillConsoleOutputAttribute(
+            handle, attribute, length, start, byref(num_written))
+
+    def SetConsoleTitle(title):
+        return _SetConsoleTitleW(title)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/winterm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/winterm.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fdb4ec4e91090876dc3fbf207049b521fa0dd73
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/colorama/winterm.py
@@ -0,0 +1,169 @@
+# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
+from . import win32
+
+
+# from wincon.h
+class WinColor(object):
+    BLACK   = 0
+    BLUE    = 1
+    GREEN   = 2
+    CYAN    = 3
+    RED     = 4
+    MAGENTA = 5
+    YELLOW  = 6
+    GREY    = 7
+
+# from wincon.h
+class WinStyle(object):
+    NORMAL              = 0x00 # dim text, dim background
+    BRIGHT              = 0x08 # bright text, dim background
+    BRIGHT_BACKGROUND   = 0x80 # dim text, bright background
+
+class WinTerm(object):
+
+    def __init__(self):
+        self._default = win32.GetConsoleScreenBufferInfo(win32.STDOUT).wAttributes
+        self.set_attrs(self._default)
+        self._default_fore = self._fore
+        self._default_back = self._back
+        self._default_style = self._style
+        # In order to emulate LIGHT_EX in windows, we borrow the BRIGHT style.
+        # So that LIGHT_EX colors and BRIGHT style do not clobber each other,
+        # we track them separately, since LIGHT_EX is overwritten by Fore/Back
+        # and BRIGHT is overwritten by Style codes.
+        self._light = 0
+
+    def get_attrs(self):
+        return self._fore + self._back * 16 + (self._style | self._light)
+
+    def set_attrs(self, value):
+        self._fore = value & 7
+        self._back = (value >> 4) & 7
+        self._style = value & (WinStyle.BRIGHT | WinStyle.BRIGHT_BACKGROUND)
+
+    def reset_all(self, on_stderr=None):
+        self.set_attrs(self._default)
+        self.set_console(attrs=self._default)
+        self._light = 0
+
+    def fore(self, fore=None, light=False, on_stderr=False):
+        if fore is None:
+            fore = self._default_fore
+        self._fore = fore
+        # Emulate LIGHT_EX with BRIGHT Style
+        if light:
+            self._light |= WinStyle.BRIGHT
+        else:
+            self._light &= ~WinStyle.BRIGHT
+        self.set_console(on_stderr=on_stderr)
+
+    def back(self, back=None, light=False, on_stderr=False):
+        if back is None:
+            back = self._default_back
+        self._back = back
+        # Emulate LIGHT_EX with BRIGHT_BACKGROUND Style
+        if light:
+            self._light |= WinStyle.BRIGHT_BACKGROUND
+        else:
+            self._light &= ~WinStyle.BRIGHT_BACKGROUND
+        self.set_console(on_stderr=on_stderr)
+
+    def style(self, style=None, on_stderr=False):
+        if style is None:
+            style = self._default_style
+        self._style = style
+        self.set_console(on_stderr=on_stderr)
+
+    def set_console(self, attrs=None, on_stderr=False):
+        if attrs is None:
+            attrs = self.get_attrs()
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        win32.SetConsoleTextAttribute(handle, attrs)
+
+    def get_position(self, handle):
+        position = win32.GetConsoleScreenBufferInfo(handle).dwCursorPosition
+        # Because Windows coordinates are 0-based,
+        # and win32.SetConsoleCursorPosition expects 1-based.
+        position.X += 1
+        position.Y += 1
+        return position
+
+    def set_cursor_position(self, position=None, on_stderr=False):
+        if position is None:
+            # I'm not currently tracking the position, so there is no default.
+            # position = self.get_position()
+            return
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        win32.SetConsoleCursorPosition(handle, position)
+
+    def cursor_adjust(self, x, y, on_stderr=False):
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        position = self.get_position(handle)
+        adjusted_position = (position.Y + y, position.X + x)
+        win32.SetConsoleCursorPosition(handle, adjusted_position, adjust=False)
+
+    def erase_screen(self, mode=0, on_stderr=False):
+        # 0 should clear from the cursor to the end of the screen.
+        # 1 should clear from the cursor to the beginning of the screen.
+        # 2 should clear the entire screen, and move cursor to (1,1)
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        csbi = win32.GetConsoleScreenBufferInfo(handle)
+        # get the number of character cells in the current buffer
+        cells_in_screen = csbi.dwSize.X * csbi.dwSize.Y
+        # get number of character cells before current cursor position
+        cells_before_cursor = csbi.dwSize.X * csbi.dwCursorPosition.Y + csbi.dwCursorPosition.X
+        if mode == 0:
+            from_coord = csbi.dwCursorPosition
+            cells_to_erase = cells_in_screen - cells_before_cursor
+        elif mode == 1:
+            from_coord = win32.COORD(0, 0)
+            cells_to_erase = cells_before_cursor
+        elif mode == 2:
+            from_coord = win32.COORD(0, 0)
+            cells_to_erase = cells_in_screen
+        else:
+            # invalid mode
+            return
+        # fill the entire screen with blanks
+        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
+        # now set the buffer's attributes accordingly
+        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)
+        if mode == 2:
+            # put the cursor where needed
+            win32.SetConsoleCursorPosition(handle, (1, 1))
+
+    def erase_line(self, mode=0, on_stderr=False):
+        # 0 should clear from the cursor to the end of the line.
+        # 1 should clear from the cursor to the beginning of the line.
+        # 2 should clear the entire line.
+        handle = win32.STDOUT
+        if on_stderr:
+            handle = win32.STDERR
+        csbi = win32.GetConsoleScreenBufferInfo(handle)
+        if mode == 0:
+            from_coord = csbi.dwCursorPosition
+            cells_to_erase = csbi.dwSize.X - csbi.dwCursorPosition.X
+        elif mode == 1:
+            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
+            cells_to_erase = csbi.dwCursorPosition.X
+        elif mode == 2:
+            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
+            cells_to_erase = csbi.dwSize.X
+        else:
+            # invalid mode
+            return
+        # fill the entire screen with blanks
+        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
+        # now set the buffer's attributes accordingly
+        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)
+
+    def set_title(self, title):
+        win32.SetConsoleTitle(title)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..f4d89c410dc876674e85238d4a455546ab9e9f5f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/METADATA
@@ -0,0 +1,70 @@
+Metadata-Version: 2.1
+Name: contextlib2
+Version: 0.6.0
+Summary: Backports and enhancements for the contextlib module
+Home-page: http://contextlib2.readthedocs.org
+Author: Nick Coghlan
+Author-email: ncoghlan@gmail.com
+License: PSF License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: Python Software Foundation License
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+
+.. image:: https://jazzband.co/static/img/badge.svg
+   :target: https://jazzband.co/
+   :alt: Jazzband
+
+.. image:: https://readthedocs.org/projects/contextlib2/badge/?version=latest
+   :target: https://contextlib2.readthedocs.org/
+   :alt: Latest Docs
+
+.. image:: https://img.shields.io/travis/jazzband/contextlib2/master.svg
+   :target: http://travis-ci.org/jazzband/contextlib2
+
+.. image:: https://coveralls.io/repos/github/jazzband/contextlib2/badge.svg?branch=master
+   :target: https://coveralls.io/github/jazzband/contextlib2?branch=master
+
+.. image:: https://landscape.io/github/jazzband/contextlib2/master/landscape.svg
+   :target: https://landscape.io/github/jazzband/contextlib2/
+
+contextlib2 is a backport of the `standard library's contextlib
+module <https://docs.python.org/3.5/library/contextlib.html>`_ to
+earlier Python versions.
+
+It also serves as a real world proving ground for possible future
+enhancements to the standard library version.
+
+Development
+-----------
+
+contextlib2 has no runtime dependencies, but requires ``unittest2`` for testing
+on Python 2.x, as well as ``setuptools`` and ``wheel`` to generate universal
+wheel archives.
+
+Local testing is just a matter of running ``python test_contextlib2.py``.
+
+You can test against multiple versions of Python with
+`tox <https://tox.testrun.org/>`_::
+
+    pip install tox
+    tox
+
+Versions currently tested in both tox and Travis CI are:
+
+* CPython 2.7
+* CPython 3.4
+* CPython 3.5
+* CPython 3.6
+* CPython 3.7
+* PyPy
+* PyPy3
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..d64bd47430432624a8c047657a380d425af8abd2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/RECORD
@@ -0,0 +1,11 @@
+contextlib2.py,sha256=5HjGflUzwWAUfcILhSmC2GqvoYdZZzFzVfIDztHigUs,16915
+contextlib2-0.6.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+contextlib2-0.6.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+contextlib2-0.6.0.dist-info/METADATA,sha256=gSVIyF9xprVGAJdZdrVoZR9VXpXRWURqyrugGzj66Rk,2291
+contextlib2-0.6.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+contextlib2-0.6.0.dist-info/top_level.txt,sha256=RxWWBMkHA_rsw1laXJ8L3yE_fyYaBmvt2bVUvj3WbMg,12
+contextlib2-0.6.0.dist-info/RECORD,,
+contextlib2-0.6.0.dist-info/INSTALLER,,
+contextlib2-0.6.0.dist-info/__pycache__,,
+contextlib2.cpython-38.pyc,,
+contextlib2-0.6.0.virtualenv,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..03fdf8ed24f99c297b402190021f7c75f205a70f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+contextlib2
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2-0.6.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2.py
new file mode 100644
index 0000000000000000000000000000000000000000..3aae8f4117cf8824748f5b7bc74b0aca4516bb6a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/contextlib2.py
@@ -0,0 +1,518 @@
+"""contextlib2 - backports and enhancements to the contextlib module"""
+
+import abc
+import sys
+import warnings
+from collections import deque
+from functools import wraps
+
+__all__ = ["contextmanager", "closing", "nullcontext",
+           "AbstractContextManager",
+           "ContextDecorator", "ExitStack",
+           "redirect_stdout", "redirect_stderr", "suppress"]
+
+# Backwards compatibility
+__all__ += ["ContextStack"]
+
+
+# Backport abc.ABC
+if sys.version_info[:2] >= (3, 4):
+    _abc_ABC = abc.ABC
+else:
+    _abc_ABC = abc.ABCMeta('ABC', (object,), {'__slots__': ()})
+
+
+# Backport classic class MRO
+def _classic_mro(C, result):
+    if C in result:
+        return
+    result.append(C)
+    for B in C.__bases__:
+        _classic_mro(B, result)
+    return result
+
+
+# Backport _collections_abc._check_methods
+def _check_methods(C, *methods):
+    try:
+        mro = C.__mro__
+    except AttributeError:
+        mro = tuple(_classic_mro(C, []))
+
+    for method in methods:
+        for B in mro:
+            if method in B.__dict__:
+                if B.__dict__[method] is None:
+                    return NotImplemented
+                break
+        else:
+            return NotImplemented
+    return True
+
+
+class AbstractContextManager(_abc_ABC):
+    """An abstract base class for context managers."""
+
+    def __enter__(self):
+        """Return `self` upon entering the runtime context."""
+        return self
+
+    @abc.abstractmethod
+    def __exit__(self, exc_type, exc_value, traceback):
+        """Raise any exception triggered within the runtime context."""
+        return None
+
+    @classmethod
+    def __subclasshook__(cls, C):
+        """Check whether subclass is considered a subclass of this ABC."""
+        if cls is AbstractContextManager:
+            return _check_methods(C, "__enter__", "__exit__")
+        return NotImplemented
+
+
+class ContextDecorator(object):
+    """A base class or mixin that enables context managers to work as decorators."""
+
+    def refresh_cm(self):
+        """Returns the context manager used to actually wrap the call to the
+        decorated function.
+
+        The default implementation just returns *self*.
+
+        Overriding this method allows otherwise one-shot context managers
+        like _GeneratorContextManager to support use as decorators via
+        implicit recreation.
+
+        DEPRECATED: refresh_cm was never added to the standard library's
+                    ContextDecorator API
+        """
+        warnings.warn("refresh_cm was never added to the standard library",
+                      DeprecationWarning)
+        return self._recreate_cm()
+
+    def _recreate_cm(self):
+        """Return a recreated instance of self.
+
+        Allows an otherwise one-shot context manager like
+        _GeneratorContextManager to support use as
+        a decorator via implicit recreation.
+
+        This is a private interface just for _GeneratorContextManager.
+        See issue #11647 for details.
+        """
+        return self
+
+    def __call__(self, func):
+        @wraps(func)
+        def inner(*args, **kwds):
+            with self._recreate_cm():
+                return func(*args, **kwds)
+        return inner
+
+
+class _GeneratorContextManager(ContextDecorator):
+    """Helper for @contextmanager decorator."""
+
+    def __init__(self, func, args, kwds):
+        self.gen = func(*args, **kwds)
+        self.func, self.args, self.kwds = func, args, kwds
+        # Issue 19330: ensure context manager instances have good docstrings
+        doc = getattr(func, "__doc__", None)
+        if doc is None:
+            doc = type(self).__doc__
+        self.__doc__ = doc
+        # Unfortunately, this still doesn't provide good help output when
+        # inspecting the created context manager instances, since pydoc
+        # currently bypasses the instance docstring and shows the docstring
+        # for the class instead.
+        # See http://bugs.python.org/issue19404 for more details.
+
+    def _recreate_cm(self):
+        # _GCM instances are one-shot context managers, so the
+        # CM must be recreated each time a decorated function is
+        # called
+        return self.__class__(self.func, self.args, self.kwds)
+
+    def __enter__(self):
+        try:
+            return next(self.gen)
+        except StopIteration:
+            raise RuntimeError("generator didn't yield")
+
+    def __exit__(self, type, value, traceback):
+        if type is None:
+            try:
+                next(self.gen)
+            except StopIteration:
+                return
+            else:
+                raise RuntimeError("generator didn't stop")
+        else:
+            if value is None:
+                # Need to force instantiation so we can reliably
+                # tell if we get the same exception back
+                value = type()
+            try:
+                self.gen.throw(type, value, traceback)
+                raise RuntimeError("generator didn't stop after throw()")
+            except StopIteration as exc:
+                # Suppress StopIteration *unless* it's the same exception that
+                # was passed to throw().  This prevents a StopIteration
+                # raised inside the "with" statement from being suppressed.
+                return exc is not value
+            except RuntimeError as exc:
+                # Don't re-raise the passed in exception
+                if exc is value:
+                    return False
+                # Likewise, avoid suppressing if a StopIteration exception
+                # was passed to throw() and later wrapped into a RuntimeError
+                # (see PEP 479).
+                if _HAVE_EXCEPTION_CHAINING and exc.__cause__ is value:
+                    return False
+                raise
+            except:
+                # only re-raise if it's *not* the exception that was
+                # passed to throw(), because __exit__() must not raise
+                # an exception unless __exit__() itself failed.  But throw()
+                # has to raise the exception to signal propagation, so this
+                # fixes the impedance mismatch between the throw() protocol
+                # and the __exit__() protocol.
+                #
+                if sys.exc_info()[1] is not value:
+                    raise
+
+
+def contextmanager(func):
+    """@contextmanager decorator.
+
+    Typical usage:
+
+        @contextmanager
+        def some_generator(<arguments>):
+            <setup>
+            try:
+                yield <value>
+            finally:
+                <cleanup>
+
+    This makes this:
+
+        with some_generator(<arguments>) as <variable>:
+            <body>
+
+    equivalent to this:
+
+        <setup>
+        try:
+            <variable> = <value>
+            <body>
+        finally:
+            <cleanup>
+
+    """
+    @wraps(func)
+    def helper(*args, **kwds):
+        return _GeneratorContextManager(func, args, kwds)
+    return helper
+
+
+class closing(object):
+    """Context to automatically close something at the end of a block.
+
+    Code like this:
+
+        with closing(<module>.open(<arguments>)) as f:
+            <block>
+
+    is equivalent to this:
+
+        f = <module>.open(<arguments>)
+        try:
+            <block>
+        finally:
+            f.close()
+
+    """
+    def __init__(self, thing):
+        self.thing = thing
+
+    def __enter__(self):
+        return self.thing
+
+    def __exit__(self, *exc_info):
+        self.thing.close()
+
+
+class _RedirectStream(object):
+
+    _stream = None
+
+    def __init__(self, new_target):
+        self._new_target = new_target
+        # We use a list of old targets to make this CM re-entrant
+        self._old_targets = []
+
+    def __enter__(self):
+        self._old_targets.append(getattr(sys, self._stream))
+        setattr(sys, self._stream, self._new_target)
+        return self._new_target
+
+    def __exit__(self, exctype, excinst, exctb):
+        setattr(sys, self._stream, self._old_targets.pop())
+
+
+class redirect_stdout(_RedirectStream):
+    """Context manager for temporarily redirecting stdout to another file.
+
+        # How to send help() to stderr
+        with redirect_stdout(sys.stderr):
+            help(dir)
+
+        # How to write help() to a file
+        with open('help.txt', 'w') as f:
+            with redirect_stdout(f):
+                help(pow)
+    """
+
+    _stream = "stdout"
+
+
+class redirect_stderr(_RedirectStream):
+    """Context manager for temporarily redirecting stderr to another file."""
+
+    _stream = "stderr"
+
+
+class suppress(object):
+    """Context manager to suppress specified exceptions
+
+    After the exception is suppressed, execution proceeds with the next
+    statement following the with statement.
+
+         with suppress(FileNotFoundError):
+             os.remove(somefile)
+         # Execution still resumes here if the file was already removed
+    """
+
+    def __init__(self, *exceptions):
+        self._exceptions = exceptions
+
+    def __enter__(self):
+        pass
+
+    def __exit__(self, exctype, excinst, exctb):
+        # Unlike isinstance and issubclass, CPython exception handling
+        # currently only looks at the concrete type hierarchy (ignoring
+        # the instance and subclass checking hooks). While Guido considers
+        # that a bug rather than a feature, it's a fairly hard one to fix
+        # due to various internal implementation details. suppress provides
+        # the simpler issubclass based semantics, rather than trying to
+        # exactly reproduce the limitations of the CPython interpreter.
+        #
+        # See http://bugs.python.org/issue12029 for more details
+        return exctype is not None and issubclass(exctype, self._exceptions)
+
+
+# Context manipulation is Python 3 only
+_HAVE_EXCEPTION_CHAINING = sys.version_info[0] >= 3
+if _HAVE_EXCEPTION_CHAINING:
+    def _make_context_fixer(frame_exc):
+        def _fix_exception_context(new_exc, old_exc):
+            # Context may not be correct, so find the end of the chain
+            while 1:
+                exc_context = new_exc.__context__
+                if exc_context is old_exc:
+                    # Context is already set correctly (see issue 20317)
+                    return
+                if exc_context is None or exc_context is frame_exc:
+                    break
+                new_exc = exc_context
+            # Change the end of the chain to point to the exception
+            # we expect it to reference
+            new_exc.__context__ = old_exc
+        return _fix_exception_context
+
+    def _reraise_with_existing_context(exc_details):
+        try:
+            # bare "raise exc_details[1]" replaces our carefully
+            # set-up context
+            fixed_ctx = exc_details[1].__context__
+            raise exc_details[1]
+        except BaseException:
+            exc_details[1].__context__ = fixed_ctx
+            raise
+else:
+    # No exception context in Python 2
+    def _make_context_fixer(frame_exc):
+        return lambda new_exc, old_exc: None
+
+    # Use 3 argument raise in Python 2,
+    # but use exec to avoid SyntaxError in Python 3
+    def _reraise_with_existing_context(exc_details):
+        exc_type, exc_value, exc_tb = exc_details
+        exec("raise exc_type, exc_value, exc_tb")
+
+# Handle old-style classes if they exist
+try:
+    from types import InstanceType
+except ImportError:
+    # Python 3 doesn't have old-style classes
+    _get_type = type
+else:
+    # Need to handle old-style context managers on Python 2
+    def _get_type(obj):
+        obj_type = type(obj)
+        if obj_type is InstanceType:
+            return obj.__class__  # Old-style class
+        return obj_type  # New-style class
+
+
+# Inspired by discussions on http://bugs.python.org/issue13585
+class ExitStack(object):
+    """Context manager for dynamic management of a stack of exit callbacks
+
+    For example:
+
+        with ExitStack() as stack:
+            files = [stack.enter_context(open(fname)) for fname in filenames]
+            # All opened files will automatically be closed at the end of
+            # the with statement, even if attempts to open files later
+            # in the list raise an exception
+
+    """
+    def __init__(self):
+        self._exit_callbacks = deque()
+
+    def pop_all(self):
+        """Preserve the context stack by transferring it to a new instance"""
+        new_stack = type(self)()
+        new_stack._exit_callbacks = self._exit_callbacks
+        self._exit_callbacks = deque()
+        return new_stack
+
+    def _push_cm_exit(self, cm, cm_exit):
+        """Helper to correctly register callbacks to __exit__ methods"""
+        def _exit_wrapper(*exc_details):
+            return cm_exit(cm, *exc_details)
+        _exit_wrapper.__self__ = cm
+        self.push(_exit_wrapper)
+
+    def push(self, exit):
+        """Registers a callback with the standard __exit__ method signature
+
+        Can suppress exceptions the same way __exit__ methods can.
+
+        Also accepts any object with an __exit__ method (registering a call
+        to the method instead of the object itself)
+        """
+        # We use an unbound method rather than a bound method to follow
+        # the standard lookup behaviour for special methods
+        _cb_type = _get_type(exit)
+        try:
+            exit_method = _cb_type.__exit__
+        except AttributeError:
+            # Not a context manager, so assume its a callable
+            self._exit_callbacks.append(exit)
+        else:
+            self._push_cm_exit(exit, exit_method)
+        return exit # Allow use as a decorator
+
+    def callback(self, callback, *args, **kwds):
+        """Registers an arbitrary callback and arguments.
+
+        Cannot suppress exceptions.
+        """
+        def _exit_wrapper(exc_type, exc, tb):
+            callback(*args, **kwds)
+        # We changed the signature, so using @wraps is not appropriate, but
+        # setting __wrapped__ may still help with introspection
+        _exit_wrapper.__wrapped__ = callback
+        self.push(_exit_wrapper)
+        return callback # Allow use as a decorator
+
+    def enter_context(self, cm):
+        """Enters the supplied context manager
+
+        If successful, also pushes its __exit__ method as a callback and
+        returns the result of the __enter__ method.
+        """
+        # We look up the special methods on the type to match the with statement
+        _cm_type = _get_type(cm)
+        _exit = _cm_type.__exit__
+        result = _cm_type.__enter__(cm)
+        self._push_cm_exit(cm, _exit)
+        return result
+
+    def close(self):
+        """Immediately unwind the context stack"""
+        self.__exit__(None, None, None)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc_details):
+        received_exc = exc_details[0] is not None
+
+        # We manipulate the exception state so it behaves as though
+        # we were actually nesting multiple with statements
+        frame_exc = sys.exc_info()[1]
+        _fix_exception_context = _make_context_fixer(frame_exc)
+
+        # Callbacks are invoked in LIFO order to match the behaviour of
+        # nested context managers
+        suppressed_exc = False
+        pending_raise = False
+        while self._exit_callbacks:
+            cb = self._exit_callbacks.pop()
+            try:
+                if cb(*exc_details):
+                    suppressed_exc = True
+                    pending_raise = False
+                    exc_details = (None, None, None)
+            except:
+                new_exc_details = sys.exc_info()
+                # simulate the stack of exceptions by setting the context
+                _fix_exception_context(new_exc_details[1], exc_details[1])
+                pending_raise = True
+                exc_details = new_exc_details
+        if pending_raise:
+            _reraise_with_existing_context(exc_details)
+        return received_exc and suppressed_exc
+
+
+# Preserve backwards compatibility
+class ContextStack(ExitStack):
+    """Backwards compatibility alias for ExitStack"""
+
+    def __init__(self):
+        warnings.warn("ContextStack has been renamed to ExitStack",
+                      DeprecationWarning)
+        super(ContextStack, self).__init__()
+
+    def register_exit(self, callback):
+        return self.push(callback)
+
+    def register(self, callback, *args, **kwds):
+        return self.callback(callback, *args, **kwds)
+
+    def preserve(self):
+        return self.pop_all()
+
+
+class nullcontext(AbstractContextManager):
+    """Context manager that does no additional processing.
+    Used as a stand-in for a normal context manager, when a particular
+    block of code is only sometimes used with a normal context manager:
+    cm = optional_cm if condition else nullcontext()
+    with cm:
+        # Perform operation, using optional_cm if condition is True
+    """
+
+    def __init__(self, enter_result=None):
+        self.enter_result = enter_result
+
+    def __enter__(self):
+        return self.enter_result
+
+    def __exit__(self, *excinfo):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..0defb82e21f21da442706e25145b4ef0b59d576c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/__init__.py
@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+try:
+    from ._version import version as __version__
+except ImportError:
+    __version__ = 'unknown'
+
+__all__ = ['easter', 'parser', 'relativedelta', 'rrule', 'tz',
+           'utils', 'zoneinfo']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_common.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..4eb2659bd2986125fcfb4afea5bae9efc2dcd1a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_common.py
@@ -0,0 +1,43 @@
+"""
+Common code used in multiple modules.
+"""
+
+
+class weekday(object):
+    __slots__ = ["weekday", "n"]
+
+    def __init__(self, weekday, n=None):
+        self.weekday = weekday
+        self.n = n
+
+    def __call__(self, n):
+        if n == self.n:
+            return self
+        else:
+            return self.__class__(self.weekday, n)
+
+    def __eq__(self, other):
+        try:
+            if self.weekday != other.weekday or self.n != other.n:
+                return False
+        except AttributeError:
+            return False
+        return True
+
+    def __hash__(self):
+        return hash((
+          self.weekday,
+          self.n,
+        ))
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        s = ("MO", "TU", "WE", "TH", "FR", "SA", "SU")[self.weekday]
+        if not self.n:
+            return s
+        else:
+            return "%s(%+d)" % (s, self.n)
+
+# vim:ts=4:sw=4:et
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..eac12096982504fedcf97d9dd75970ac513af9d9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/_version.py
@@ -0,0 +1,4 @@
+# coding: utf-8
+# file generated by setuptools_scm
+# don't change, don't track in version control
+version = '2.8.1'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/easter.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/easter.py
new file mode 100644
index 0000000000000000000000000000000000000000..53b7c78938f193d5b0a10216bb2e3888e9710dfa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/easter.py
@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a generic easter computing method for any given year, using
+Western, Orthodox or Julian algorithms.
+"""
+
+import datetime
+
+__all__ = ["easter", "EASTER_JULIAN", "EASTER_ORTHODOX", "EASTER_WESTERN"]
+
+EASTER_JULIAN = 1
+EASTER_ORTHODOX = 2
+EASTER_WESTERN = 3
+
+
+def easter(year, method=EASTER_WESTERN):
+    """
+    This method was ported from the work done by GM Arts,
+    on top of the algorithm by Claus Tondering, which was
+    based in part on the algorithm of Ouding (1940), as
+    quoted in "Explanatory Supplement to the Astronomical
+    Almanac", P.  Kenneth Seidelmann, editor.
+
+    This algorithm implements three different easter
+    calculation methods:
+
+    1 - Original calculation in Julian calendar, valid in
+        dates after 326 AD
+    2 - Original method, with date converted to Gregorian
+        calendar, valid in years 1583 to 4099
+    3 - Revised method, in Gregorian calendar, valid in
+        years 1583 to 4099 as well
+
+    These methods are represented by the constants:
+
+    * ``EASTER_JULIAN   = 1``
+    * ``EASTER_ORTHODOX = 2``
+    * ``EASTER_WESTERN  = 3``
+
+    The default method is method 3.
+
+    More about the algorithm may be found at:
+
+    `GM Arts: Easter Algorithms <http://www.gmarts.org/index.php?go=415>`_
+
+    and
+
+    `The Calendar FAQ: Easter <https://www.tondering.dk/claus/cal/easter.php>`_
+
+    """
+
+    if not (1 <= method <= 3):
+        raise ValueError("invalid method")
+
+    # g - Golden year - 1
+    # c - Century
+    # h - (23 - Epact) mod 30
+    # i - Number of days from March 21 to Paschal Full Moon
+    # j - Weekday for PFM (0=Sunday, etc)
+    # p - Number of days from March 21 to Sunday on or before PFM
+    #     (-6 to 28 methods 1 & 3, to 56 for method 2)
+    # e - Extra days to add for method 2 (converting Julian
+    #     date to Gregorian date)
+
+    y = year
+    g = y % 19
+    e = 0
+    if method < 3:
+        # Old method
+        i = (19*g + 15) % 30
+        j = (y + y//4 + i) % 7
+        if method == 2:
+            # Extra dates to convert Julian to Gregorian date
+            e = 10
+            if y > 1600:
+                e = e + y//100 - 16 - (y//100 - 16)//4
+    else:
+        # New method
+        c = y//100
+        h = (c - c//4 - (8*c + 13)//25 + 19*g + 15) % 30
+        i = h - (h//28)*(1 - (h//28)*(29//(h + 1))*((21 - g)//11))
+        j = (y + y//4 + i + 2 - c + c//4) % 7
+
+    # p can be from -6 to 56 corresponding to dates 22 March to 23 May
+    # (later dates apply to method 2, although 23 May never actually occurs)
+    p = i - j + e
+    d = 1 + (p + 27 + (p + 6)//40) % 31
+    m = 3 + (p + 26)//30
+    return datetime.date(int(y), int(m), int(d))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d174b0e4dcc472999b75e55ebb88af320ae38081
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/__init__.py
@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+from ._parser import parse, parser, parserinfo, ParserError
+from ._parser import DEFAULTPARSER, DEFAULTTZPARSER
+from ._parser import UnknownTimezoneWarning
+
+from ._parser import __doc__
+
+from .isoparser import isoparser, isoparse
+
+__all__ = ['parse', 'parser', 'parserinfo',
+           'isoparse', 'isoparser',
+           'ParserError',
+           'UnknownTimezoneWarning']
+
+
+###
+# Deprecate portions of the private interface so that downstream code that
+# is improperly relying on it is given *some* notice.
+
+
+def __deprecated_private_func(f):
+    from functools import wraps
+    import warnings
+
+    msg = ('{name} is a private function and may break without warning, '
+           'it will be moved and or renamed in future versions.')
+    msg = msg.format(name=f.__name__)
+
+    @wraps(f)
+    def deprecated_func(*args, **kwargs):
+        warnings.warn(msg, DeprecationWarning)
+        return f(*args, **kwargs)
+
+    return deprecated_func
+
+def __deprecate_private_class(c):
+    import warnings
+
+    msg = ('{name} is a private class and may break without warning, '
+           'it will be moved and or renamed in future versions.')
+    msg = msg.format(name=c.__name__)
+
+    class private_class(c):
+        __doc__ = c.__doc__
+
+        def __init__(self, *args, **kwargs):
+            warnings.warn(msg, DeprecationWarning)
+            super(private_class, self).__init__(*args, **kwargs)
+
+    private_class.__name__ = c.__name__
+
+    return private_class
+
+
+from ._parser import _timelex, _resultbase
+from ._parser import _tzparser, _parsetz
+
+_timelex = __deprecate_private_class(_timelex)
+_tzparser = __deprecate_private_class(_tzparser)
+_resultbase = __deprecate_private_class(_resultbase)
+_parsetz = __deprecated_private_func(_parsetz)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/_parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..458aa6a3294fcd70efff38e6f447b232ae2afc21
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/_parser.py
@@ -0,0 +1,1609 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a generic date/time string parser which is able to parse
+most known formats to represent a date and/or time.
+
+This module attempts to be forgiving with regards to unlikely input formats,
+returning a datetime object even for dates which are ambiguous. If an element
+of a date/time stamp is omitted, the following rules are applied:
+
+- If AM or PM is left unspecified, a 24-hour clock is assumed, however, an hour
+  on a 12-hour clock (``0 <= hour <= 12``) *must* be specified if AM or PM is
+  specified.
+- If a time zone is omitted, a timezone-naive datetime is returned.
+
+If any other elements are missing, they are taken from the
+:class:`datetime.datetime` object passed to the parameter ``default``. If this
+results in a day number exceeding the valid number of days per month, the
+value falls back to the end of the month.
+
+Additional resources about date/time string formats can be found below:
+
+- `A summary of the international standard date and time notation
+  <http://www.cl.cam.ac.uk/~mgk25/iso-time.html>`_
+- `W3C Date and Time Formats <http://www.w3.org/TR/NOTE-datetime>`_
+- `Time Formats (Planetary Rings Node) <https://pds-rings.seti.org:443/tools/time_formats.html>`_
+- `CPAN ParseDate module
+  <http://search.cpan.org/~muir/Time-modules-2013.0912/lib/Time/ParseDate.pm>`_
+- `Java SimpleDateFormat Class
+  <https://docs.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>`_
+"""
+from __future__ import unicode_literals
+
+import datetime
+import re
+import string
+import time
+import warnings
+
+from calendar import monthrange
+from io import StringIO
+
+import six
+from six import integer_types, text_type
+
+from decimal import Decimal
+
+from warnings import warn
+
+from .. import relativedelta
+from .. import tz
+
+__all__ = ["parse", "parserinfo", "ParserError"]
+
+
+# TODO: pandas.core.tools.datetimes imports this explicitly.  Might be worth
+# making public and/or figuring out if there is something we can
+# take off their plate.
+class _timelex(object):
+    # Fractional seconds are sometimes split by a comma
+    _split_decimal = re.compile("([.,])")
+
+    def __init__(self, instream):
+        if six.PY2:
+            # In Python 2, we can't duck type properly because unicode has
+            # a 'decode' function, and we'd be double-decoding
+            if isinstance(instream, (bytes, bytearray)):
+                instream = instream.decode()
+        else:
+            if getattr(instream, 'decode', None) is not None:
+                instream = instream.decode()
+
+        if isinstance(instream, text_type):
+            instream = StringIO(instream)
+        elif getattr(instream, 'read', None) is None:
+            raise TypeError('Parser must be a string or character stream, not '
+                            '{itype}'.format(itype=instream.__class__.__name__))
+
+        self.instream = instream
+        self.charstack = []
+        self.tokenstack = []
+        self.eof = False
+
+    def get_token(self):
+        """
+        This function breaks the time string into lexical units (tokens), which
+        can be parsed by the parser. Lexical units are demarcated by changes in
+        the character set, so any continuous string of letters is considered
+        one unit, any continuous string of numbers is considered one unit.
+
+        The main complication arises from the fact that dots ('.') can be used
+        both as separators (e.g. "Sep.20.2009") or decimal points (e.g.
+        "4:30:21.447"). As such, it is necessary to read the full context of
+        any dot-separated strings before breaking it into tokens; as such, this
+        function maintains a "token stack", for when the ambiguous context
+        demands that multiple tokens be parsed at once.
+        """
+        if self.tokenstack:
+            return self.tokenstack.pop(0)
+
+        seenletters = False
+        token = None
+        state = None
+
+        while not self.eof:
+            # We only realize that we've reached the end of a token when we
+            # find a character that's not part of the current token - since
+            # that character may be part of the next token, it's stored in the
+            # charstack.
+            if self.charstack:
+                nextchar = self.charstack.pop(0)
+            else:
+                nextchar = self.instream.read(1)
+                while nextchar == '\x00':
+                    nextchar = self.instream.read(1)
+
+            if not nextchar:
+                self.eof = True
+                break
+            elif not state:
+                # First character of the token - determines if we're starting
+                # to parse a word, a number or something else.
+                token = nextchar
+                if self.isword(nextchar):
+                    state = 'a'
+                elif self.isnum(nextchar):
+                    state = '0'
+                elif self.isspace(nextchar):
+                    token = ' '
+                    break  # emit token
+                else:
+                    break  # emit token
+            elif state == 'a':
+                # If we've already started reading a word, we keep reading
+                # letters until we find something that's not part of a word.
+                seenletters = True
+                if self.isword(nextchar):
+                    token += nextchar
+                elif nextchar == '.':
+                    token += nextchar
+                    state = 'a.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == '0':
+                # If we've already started reading a number, we keep reading
+                # numbers until we find something that doesn't fit.
+                if self.isnum(nextchar):
+                    token += nextchar
+                elif nextchar == '.' or (nextchar == ',' and len(token) >= 2):
+                    token += nextchar
+                    state = '0.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == 'a.':
+                # If we've seen some letters and a dot separator, continue
+                # parsing, and the tokens will be broken up later.
+                seenletters = True
+                if nextchar == '.' or self.isword(nextchar):
+                    token += nextchar
+                elif self.isnum(nextchar) and token[-1] == '.':
+                    token += nextchar
+                    state = '0.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+            elif state == '0.':
+                # If we've seen at least one dot separator, keep going, we'll
+                # break up the tokens later.
+                if nextchar == '.' or self.isnum(nextchar):
+                    token += nextchar
+                elif self.isword(nextchar) and token[-1] == '.':
+                    token += nextchar
+                    state = 'a.'
+                else:
+                    self.charstack.append(nextchar)
+                    break  # emit token
+
+        if (state in ('a.', '0.') and (seenletters or token.count('.') > 1 or
+                                       token[-1] in '.,')):
+            l = self._split_decimal.split(token)
+            token = l[0]
+            for tok in l[1:]:
+                if tok:
+                    self.tokenstack.append(tok)
+
+        if state == '0.' and token.count('.') == 0:
+            token = token.replace(',', '.')
+
+        return token
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        token = self.get_token()
+        if token is None:
+            raise StopIteration
+
+        return token
+
+    def next(self):
+        return self.__next__()  # Python 2.x support
+
+    @classmethod
+    def split(cls, s):
+        return list(cls(s))
+
+    @classmethod
+    def isword(cls, nextchar):
+        """ Whether or not the next character is part of a word """
+        return nextchar.isalpha()
+
+    @classmethod
+    def isnum(cls, nextchar):
+        """ Whether the next character is part of a number """
+        return nextchar.isdigit()
+
+    @classmethod
+    def isspace(cls, nextchar):
+        """ Whether the next character is whitespace """
+        return nextchar.isspace()
+
+
+class _resultbase(object):
+
+    def __init__(self):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+
+    def _repr(self, classname):
+        l = []
+        for attr in self.__slots__:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("%s=%s" % (attr, repr(value)))
+        return "%s(%s)" % (classname, ", ".join(l))
+
+    def __len__(self):
+        return (sum(getattr(self, attr) is not None
+                    for attr in self.__slots__))
+
+    def __repr__(self):
+        return self._repr(self.__class__.__name__)
+
+
+class parserinfo(object):
+    """
+    Class which handles what inputs are accepted. Subclass this to customize
+    the language and acceptable values for each parameter.
+
+    :param dayfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+        ``yearfirst`` is set to ``True``, this distinguishes between YDM
+        and YMD. Default is ``False``.
+
+    :param yearfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the year. If ``True``, the first number is taken
+        to be the year, otherwise the last number is taken to be the year.
+        Default is ``False``.
+    """
+
+    # m from a.m/p.m, t from ISO T separator
+    JUMP = [" ", ".", ",", ";", "-", "/", "'",
+            "at", "on", "and", "ad", "m", "t", "of",
+            "st", "nd", "rd", "th"]
+
+    WEEKDAYS = [("Mon", "Monday"),
+                ("Tue", "Tuesday"),     # TODO: "Tues"
+                ("Wed", "Wednesday"),
+                ("Thu", "Thursday"),    # TODO: "Thurs"
+                ("Fri", "Friday"),
+                ("Sat", "Saturday"),
+                ("Sun", "Sunday")]
+    MONTHS = [("Jan", "January"),
+              ("Feb", "February"),      # TODO: "Febr"
+              ("Mar", "March"),
+              ("Apr", "April"),
+              ("May", "May"),
+              ("Jun", "June"),
+              ("Jul", "July"),
+              ("Aug", "August"),
+              ("Sep", "Sept", "September"),
+              ("Oct", "October"),
+              ("Nov", "November"),
+              ("Dec", "December")]
+    HMS = [("h", "hour", "hours"),
+           ("m", "minute", "minutes"),
+           ("s", "second", "seconds")]
+    AMPM = [("am", "a"),
+            ("pm", "p")]
+    UTCZONE = ["UTC", "GMT", "Z", "z"]
+    PERTAIN = ["of"]
+    TZOFFSET = {}
+    # TODO: ERA = ["AD", "BC", "CE", "BCE", "Stardate",
+    #              "Anno Domini", "Year of Our Lord"]
+
+    def __init__(self, dayfirst=False, yearfirst=False):
+        self._jump = self._convert(self.JUMP)
+        self._weekdays = self._convert(self.WEEKDAYS)
+        self._months = self._convert(self.MONTHS)
+        self._hms = self._convert(self.HMS)
+        self._ampm = self._convert(self.AMPM)
+        self._utczone = self._convert(self.UTCZONE)
+        self._pertain = self._convert(self.PERTAIN)
+
+        self.dayfirst = dayfirst
+        self.yearfirst = yearfirst
+
+        self._year = time.localtime().tm_year
+        self._century = self._year // 100 * 100
+
+    def _convert(self, lst):
+        dct = {}
+        for i, v in enumerate(lst):
+            if isinstance(v, tuple):
+                for v in v:
+                    dct[v.lower()] = i
+            else:
+                dct[v.lower()] = i
+        return dct
+
+    def jump(self, name):
+        return name.lower() in self._jump
+
+    def weekday(self, name):
+        try:
+            return self._weekdays[name.lower()]
+        except KeyError:
+            pass
+        return None
+
+    def month(self, name):
+        try:
+            return self._months[name.lower()] + 1
+        except KeyError:
+            pass
+        return None
+
+    def hms(self, name):
+        try:
+            return self._hms[name.lower()]
+        except KeyError:
+            return None
+
+    def ampm(self, name):
+        try:
+            return self._ampm[name.lower()]
+        except KeyError:
+            return None
+
+    def pertain(self, name):
+        return name.lower() in self._pertain
+
+    def utczone(self, name):
+        return name.lower() in self._utczone
+
+    def tzoffset(self, name):
+        if name in self._utczone:
+            return 0
+
+        return self.TZOFFSET.get(name)
+
+    def convertyear(self, year, century_specified=False):
+        """
+        Converts two-digit years to year within [-50, 49]
+        range of self._year (current local time)
+        """
+
+        # Function contract is that the year is always positive
+        assert year >= 0
+
+        if year < 100 and not century_specified:
+            # assume current century to start
+            year += self._century
+
+            if year >= self._year + 50:  # if too far in future
+                year -= 100
+            elif year < self._year - 50:  # if too far in past
+                year += 100
+
+        return year
+
+    def validate(self, res):
+        # move to info
+        if res.year is not None:
+            res.year = self.convertyear(res.year, res.century_specified)
+
+        if ((res.tzoffset == 0 and not res.tzname) or
+             (res.tzname == 'Z' or res.tzname == 'z')):
+            res.tzname = "UTC"
+            res.tzoffset = 0
+        elif res.tzoffset != 0 and res.tzname and self.utczone(res.tzname):
+            res.tzoffset = 0
+        return True
+
+
+class _ymd(list):
+    def __init__(self, *args, **kwargs):
+        super(self.__class__, self).__init__(*args, **kwargs)
+        self.century_specified = False
+        self.dstridx = None
+        self.mstridx = None
+        self.ystridx = None
+
+    @property
+    def has_year(self):
+        return self.ystridx is not None
+
+    @property
+    def has_month(self):
+        return self.mstridx is not None
+
+    @property
+    def has_day(self):
+        return self.dstridx is not None
+
+    def could_be_day(self, value):
+        if self.has_day:
+            return False
+        elif not self.has_month:
+            return 1 <= value <= 31
+        elif not self.has_year:
+            # Be permissive, assume leap year
+            month = self[self.mstridx]
+            return 1 <= value <= monthrange(2000, month)[1]
+        else:
+            month = self[self.mstridx]
+            year = self[self.ystridx]
+            return 1 <= value <= monthrange(year, month)[1]
+
+    def append(self, val, label=None):
+        if hasattr(val, '__len__'):
+            if val.isdigit() and len(val) > 2:
+                self.century_specified = True
+                if label not in [None, 'Y']:  # pragma: no cover
+                    raise ValueError(label)
+                label = 'Y'
+        elif val > 100:
+            self.century_specified = True
+            if label not in [None, 'Y']:  # pragma: no cover
+                raise ValueError(label)
+            label = 'Y'
+
+        super(self.__class__, self).append(int(val))
+
+        if label == 'M':
+            if self.has_month:
+                raise ValueError('Month is already set')
+            self.mstridx = len(self) - 1
+        elif label == 'D':
+            if self.has_day:
+                raise ValueError('Day is already set')
+            self.dstridx = len(self) - 1
+        elif label == 'Y':
+            if self.has_year:
+                raise ValueError('Year is already set')
+            self.ystridx = len(self) - 1
+
+    def _resolve_from_stridxs(self, strids):
+        """
+        Try to resolve the identities of year/month/day elements using
+        ystridx, mstridx, and dstridx, if enough of these are specified.
+        """
+        if len(self) == 3 and len(strids) == 2:
+            # we can back out the remaining stridx value
+            missing = [x for x in range(3) if x not in strids.values()]
+            key = [x for x in ['y', 'm', 'd'] if x not in strids]
+            assert len(missing) == len(key) == 1
+            key = key[0]
+            val = missing[0]
+            strids[key] = val
+
+        assert len(self) == len(strids)  # otherwise this should not be called
+        out = {key: self[strids[key]] for key in strids}
+        return (out.get('y'), out.get('m'), out.get('d'))
+
+    def resolve_ymd(self, yearfirst, dayfirst):
+        len_ymd = len(self)
+        year, month, day = (None, None, None)
+
+        strids = (('y', self.ystridx),
+                  ('m', self.mstridx),
+                  ('d', self.dstridx))
+
+        strids = {key: val for key, val in strids if val is not None}
+        if (len(self) == len(strids) > 0 or
+                (len(self) == 3 and len(strids) == 2)):
+            return self._resolve_from_stridxs(strids)
+
+        mstridx = self.mstridx
+
+        if len_ymd > 3:
+            raise ValueError("More than three YMD values")
+        elif len_ymd == 1 or (mstridx is not None and len_ymd == 2):
+            # One member, or two members with a month string
+            if mstridx is not None:
+                month = self[mstridx]
+                # since mstridx is 0 or 1, self[mstridx-1] always
+                # looks up the other element
+                other = self[mstridx - 1]
+            else:
+                other = self[0]
+
+            if len_ymd > 1 or mstridx is None:
+                if other > 31:
+                    year = other
+                else:
+                    day = other
+
+        elif len_ymd == 2:
+            # Two members with numbers
+            if self[0] > 31:
+                # 99-01
+                year, month = self
+            elif self[1] > 31:
+                # 01-99
+                month, year = self
+            elif dayfirst and self[1] <= 12:
+                # 13-01
+                day, month = self
+            else:
+                # 01-13
+                month, day = self
+
+        elif len_ymd == 3:
+            # Three members
+            if mstridx == 0:
+                if self[1] > 31:
+                    # Apr-2003-25
+                    month, year, day = self
+                else:
+                    month, day, year = self
+            elif mstridx == 1:
+                if self[0] > 31 or (yearfirst and self[2] <= 31):
+                    # 99-Jan-01
+                    year, month, day = self
+                else:
+                    # 01-Jan-01
+                    # Give precedence to day-first, since
+                    # two-digit years is usually hand-written.
+                    day, month, year = self
+
+            elif mstridx == 2:
+                # WTF!?
+                if self[1] > 31:
+                    # 01-99-Jan
+                    day, year, month = self
+                else:
+                    # 99-01-Jan
+                    year, day, month = self
+
+            else:
+                if (self[0] > 31 or
+                    self.ystridx == 0 or
+                        (yearfirst and self[1] <= 12 and self[2] <= 31)):
+                    # 99-01-01
+                    if dayfirst and self[2] <= 12:
+                        year, day, month = self
+                    else:
+                        year, month, day = self
+                elif self[0] > 12 or (dayfirst and self[1] <= 12):
+                    # 13-01-01
+                    day, month, year = self
+                else:
+                    # 01-13-01
+                    month, day, year = self
+
+        return year, month, day
+
+
+class parser(object):
+    def __init__(self, info=None):
+        self.info = info or parserinfo()
+
+    def parse(self, timestr, default=None,
+              ignoretz=False, tzinfos=None, **kwargs):
+        """
+        Parse the date/time string into a :class:`datetime.datetime` object.
+
+        :param timestr:
+            Any date/time string using the supported formats.
+
+        :param default:
+            The default datetime object, if this is a datetime object and not
+            ``None``, elements specified in ``timestr`` replace elements in the
+            default object.
+
+        :param ignoretz:
+            If set ``True``, time zones in parsed strings are ignored and a
+            naive :class:`datetime.datetime` object is returned.
+
+        :param tzinfos:
+            Additional time zone names / aliases which may be present in the
+            string. This argument maps time zone names (and optionally offsets
+            from those time zones) to time zones. This parameter can be a
+            dictionary with timezone aliases mapping time zone names to time
+            zones or a function taking two parameters (``tzname`` and
+            ``tzoffset``) and returning a time zone.
+
+            The timezones to which the names are mapped can be an integer
+            offset from UTC in seconds or a :class:`tzinfo` object.
+
+            .. doctest::
+               :options: +NORMALIZE_WHITESPACE
+
+                >>> from dateutil.parser import parse
+                >>> from dateutil.tz import gettz
+                >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
+                >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
+                datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
+                >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
+                datetime.datetime(2012, 1, 19, 17, 21,
+                                  tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
+
+            This parameter is ignored if ``ignoretz`` is set.
+
+        :param \\*\\*kwargs:
+            Keyword arguments as passed to ``_parse()``.
+
+        :return:
+            Returns a :class:`datetime.datetime` object or, if the
+            ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
+            first element being a :class:`datetime.datetime` object, the second
+            a tuple containing the fuzzy tokens.
+
+        :raises ParserError:
+            Raised for invalid or unknown string format, if the provided
+            :class:`tzinfo` is not in a valid format, or if an invalid date
+            would be created.
+
+        :raises TypeError:
+            Raised for non-string or character stream input.
+
+        :raises OverflowError:
+            Raised if the parsed date exceeds the largest valid C integer on
+            your system.
+        """
+
+        if default is None:
+            default = datetime.datetime.now().replace(hour=0, minute=0,
+                                                      second=0, microsecond=0)
+
+        res, skipped_tokens = self._parse(timestr, **kwargs)
+
+        if res is None:
+            raise ParserError("Unknown string format: %s", timestr)
+
+        if len(res) == 0:
+            raise ParserError("String does not contain a date: %s", timestr)
+
+        try:
+            ret = self._build_naive(res, default)
+        except ValueError as e:
+            six.raise_from(ParserError(e.args[0] + ": %s", timestr), e)
+
+        if not ignoretz:
+            ret = self._build_tzaware(ret, res, tzinfos)
+
+        if kwargs.get('fuzzy_with_tokens', False):
+            return ret, skipped_tokens
+        else:
+            return ret
+
+    class _result(_resultbase):
+        __slots__ = ["year", "month", "day", "weekday",
+                     "hour", "minute", "second", "microsecond",
+                     "tzname", "tzoffset", "ampm","any_unused_tokens"]
+
+    def _parse(self, timestr, dayfirst=None, yearfirst=None, fuzzy=False,
+               fuzzy_with_tokens=False):
+        """
+        Private method which performs the heavy lifting of parsing, called from
+        ``parse()``, which passes on its ``kwargs`` to this function.
+
+        :param timestr:
+            The string to parse.
+
+        :param dayfirst:
+            Whether to interpret the first value in an ambiguous 3-integer date
+            (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+            ``yearfirst`` is set to ``True``, this distinguishes between YDM
+            and YMD. If set to ``None``, this value is retrieved from the
+            current :class:`parserinfo` object (which itself defaults to
+            ``False``).
+
+        :param yearfirst:
+            Whether to interpret the first value in an ambiguous 3-integer date
+            (e.g. 01/05/09) as the year. If ``True``, the first number is taken
+            to be the year, otherwise the last number is taken to be the year.
+            If this is set to ``None``, the value is retrieved from the current
+            :class:`parserinfo` object (which itself defaults to ``False``).
+
+        :param fuzzy:
+            Whether to allow fuzzy parsing, allowing for string like "Today is
+            January 1, 2047 at 8:21:00AM".
+
+        :param fuzzy_with_tokens:
+            If ``True``, ``fuzzy`` is automatically set to True, and the parser
+            will return a tuple where the first element is the parsed
+            :class:`datetime.datetime` datetimestamp and the second element is
+            a tuple containing the portions of the string which were ignored:
+
+            .. doctest::
+
+                >>> from dateutil.parser import parse
+                >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
+                (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
+
+        """
+        if fuzzy_with_tokens:
+            fuzzy = True
+
+        info = self.info
+
+        if dayfirst is None:
+            dayfirst = info.dayfirst
+
+        if yearfirst is None:
+            yearfirst = info.yearfirst
+
+        res = self._result()
+        l = _timelex.split(timestr)         # Splits the timestr into tokens
+
+        skipped_idxs = []
+
+        # year/month/day list
+        ymd = _ymd()
+
+        len_l = len(l)
+        i = 0
+        try:
+            while i < len_l:
+
+                # Check if it's a number
+                value_repr = l[i]
+                try:
+                    value = float(value_repr)
+                except ValueError:
+                    value = None
+
+                if value is not None:
+                    # Numeric token
+                    i = self._parse_numeric_token(l, i, info, ymd, res, fuzzy)
+
+                # Check weekday
+                elif info.weekday(l[i]) is not None:
+                    value = info.weekday(l[i])
+                    res.weekday = value
+
+                # Check month name
+                elif info.month(l[i]) is not None:
+                    value = info.month(l[i])
+                    ymd.append(value, 'M')
+
+                    if i + 1 < len_l:
+                        if l[i + 1] in ('-', '/'):
+                            # Jan-01[-99]
+                            sep = l[i + 1]
+                            ymd.append(l[i + 2])
+
+                            if i + 3 < len_l and l[i + 3] == sep:
+                                # Jan-01-99
+                                ymd.append(l[i + 4])
+                                i += 2
+
+                            i += 2
+
+                        elif (i + 4 < len_l and l[i + 1] == l[i + 3] == ' ' and
+                              info.pertain(l[i + 2])):
+                            # Jan of 01
+                            # In this case, 01 is clearly year
+                            if l[i + 4].isdigit():
+                                # Convert it here to become unambiguous
+                                value = int(l[i + 4])
+                                year = str(info.convertyear(value))
+                                ymd.append(year, 'Y')
+                            else:
+                                # Wrong guess
+                                pass
+                                # TODO: not hit in tests
+                            i += 4
+
+                # Check am/pm
+                elif info.ampm(l[i]) is not None:
+                    value = info.ampm(l[i])
+                    val_is_ampm = self._ampm_valid(res.hour, res.ampm, fuzzy)
+
+                    if val_is_ampm:
+                        res.hour = self._adjust_ampm(res.hour, value)
+                        res.ampm = value
+
+                    elif fuzzy:
+                        skipped_idxs.append(i)
+
+                # Check for a timezone name
+                elif self._could_be_tzname(res.hour, res.tzname, res.tzoffset, l[i]):
+                    res.tzname = l[i]
+                    res.tzoffset = info.tzoffset(res.tzname)
+
+                    # Check for something like GMT+3, or BRST+3. Notice
+                    # that it doesn't mean "I am 3 hours after GMT", but
+                    # "my time +3 is GMT". If found, we reverse the
+                    # logic so that timezone parsing code will get it
+                    # right.
+                    if i + 1 < len_l and l[i + 1] in ('+', '-'):
+                        l[i + 1] = ('+', '-')[l[i + 1] == '+']
+                        res.tzoffset = None
+                        if info.utczone(res.tzname):
+                            # With something like GMT+3, the timezone
+                            # is *not* GMT.
+                            res.tzname = None
+
+                # Check for a numbered timezone
+                elif res.hour is not None and l[i] in ('+', '-'):
+                    signal = (-1, 1)[l[i] == '+']
+                    len_li = len(l[i + 1])
+
+                    # TODO: check that l[i + 1] is integer?
+                    if len_li == 4:
+                        # -0300
+                        hour_offset = int(l[i + 1][:2])
+                        min_offset = int(l[i + 1][2:])
+                    elif i + 2 < len_l and l[i + 2] == ':':
+                        # -03:00
+                        hour_offset = int(l[i + 1])
+                        min_offset = int(l[i + 3])  # TODO: Check that l[i+3] is minute-like?
+                        i += 2
+                    elif len_li <= 2:
+                        # -[0]3
+                        hour_offset = int(l[i + 1][:2])
+                        min_offset = 0
+                    else:
+                        raise ValueError(timestr)
+
+                    res.tzoffset = signal * (hour_offset * 3600 + min_offset * 60)
+
+                    # Look for a timezone name between parenthesis
+                    if (i + 5 < len_l and
+                            info.jump(l[i + 2]) and l[i + 3] == '(' and
+                            l[i + 5] == ')' and
+                            3 <= len(l[i + 4]) and
+                            self._could_be_tzname(res.hour, res.tzname,
+                                                  None, l[i + 4])):
+                        # -0300 (BRST)
+                        res.tzname = l[i + 4]
+                        i += 4
+
+                    i += 1
+
+                # Check jumps
+                elif not (info.jump(l[i]) or fuzzy):
+                    raise ValueError(timestr)
+
+                else:
+                    skipped_idxs.append(i)
+                i += 1
+
+            # Process year/month/day
+            year, month, day = ymd.resolve_ymd(yearfirst, dayfirst)
+
+            res.century_specified = ymd.century_specified
+            res.year = year
+            res.month = month
+            res.day = day
+
+        except (IndexError, ValueError):
+            return None, None
+
+        if not info.validate(res):
+            return None, None
+
+        if fuzzy_with_tokens:
+            skipped_tokens = self._recombine_skipped(l, skipped_idxs)
+            return res, tuple(skipped_tokens)
+        else:
+            return res, None
+
+    def _parse_numeric_token(self, tokens, idx, info, ymd, res, fuzzy):
+        # Token is a number
+        value_repr = tokens[idx]
+        try:
+            value = self._to_decimal(value_repr)
+        except Exception as e:
+            six.raise_from(ValueError('Unknown numeric token'), e)
+
+        len_li = len(value_repr)
+
+        len_l = len(tokens)
+
+        if (len(ymd) == 3 and len_li in (2, 4) and
+            res.hour is None and
+            (idx + 1 >= len_l or
+             (tokens[idx + 1] != ':' and
+              info.hms(tokens[idx + 1]) is None))):
+            # 19990101T23[59]
+            s = tokens[idx]
+            res.hour = int(s[:2])
+
+            if len_li == 4:
+                res.minute = int(s[2:])
+
+        elif len_li == 6 or (len_li > 6 and tokens[idx].find('.') == 6):
+            # YYMMDD or HHMMSS[.ss]
+            s = tokens[idx]
+
+            if not ymd and '.' not in tokens[idx]:
+                ymd.append(s[:2])
+                ymd.append(s[2:4])
+                ymd.append(s[4:])
+            else:
+                # 19990101T235959[.59]
+
+                # TODO: Check if res attributes already set.
+                res.hour = int(s[:2])
+                res.minute = int(s[2:4])
+                res.second, res.microsecond = self._parsems(s[4:])
+
+        elif len_li in (8, 12, 14):
+            # YYYYMMDD
+            s = tokens[idx]
+            ymd.append(s[:4], 'Y')
+            ymd.append(s[4:6])
+            ymd.append(s[6:8])
+
+            if len_li > 8:
+                res.hour = int(s[8:10])
+                res.minute = int(s[10:12])
+
+                if len_li > 12:
+                    res.second = int(s[12:])
+
+        elif self._find_hms_idx(idx, tokens, info, allow_jump=True) is not None:
+            # HH[ ]h or MM[ ]m or SS[.ss][ ]s
+            hms_idx = self._find_hms_idx(idx, tokens, info, allow_jump=True)
+            (idx, hms) = self._parse_hms(idx, tokens, info, hms_idx)
+            if hms is not None:
+                # TODO: checking that hour/minute/second are not
+                # already set?
+                self._assign_hms(res, value_repr, hms)
+
+        elif idx + 2 < len_l and tokens[idx + 1] == ':':
+            # HH:MM[:SS[.ss]]
+            res.hour = int(value)
+            value = self._to_decimal(tokens[idx + 2])  # TODO: try/except for this?
+            (res.minute, res.second) = self._parse_min_sec(value)
+
+            if idx + 4 < len_l and tokens[idx + 3] == ':':
+                res.second, res.microsecond = self._parsems(tokens[idx + 4])
+
+                idx += 2
+
+            idx += 2
+
+        elif idx + 1 < len_l and tokens[idx + 1] in ('-', '/', '.'):
+            sep = tokens[idx + 1]
+            ymd.append(value_repr)
+
+            if idx + 2 < len_l and not info.jump(tokens[idx + 2]):
+                if tokens[idx + 2].isdigit():
+                    # 01-01[-01]
+                    ymd.append(tokens[idx + 2])
+                else:
+                    # 01-Jan[-01]
+                    value = info.month(tokens[idx + 2])
+
+                    if value is not None:
+                        ymd.append(value, 'M')
+                    else:
+                        raise ValueError()
+
+                if idx + 3 < len_l and tokens[idx + 3] == sep:
+                    # We have three members
+                    value = info.month(tokens[idx + 4])
+
+                    if value is not None:
+                        ymd.append(value, 'M')
+                    else:
+                        ymd.append(tokens[idx + 4])
+                    idx += 2
+
+                idx += 1
+            idx += 1
+
+        elif idx + 1 >= len_l or info.jump(tokens[idx + 1]):
+            if idx + 2 < len_l and info.ampm(tokens[idx + 2]) is not None:
+                # 12 am
+                hour = int(value)
+                res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 2]))
+                idx += 1
+            else:
+                # Year, month or day
+                ymd.append(value)
+            idx += 1
+
+        elif info.ampm(tokens[idx + 1]) is not None and (0 <= value < 24):
+            # 12am
+            hour = int(value)
+            res.hour = self._adjust_ampm(hour, info.ampm(tokens[idx + 1]))
+            idx += 1
+
+        elif ymd.could_be_day(value):
+            ymd.append(value)
+
+        elif not fuzzy:
+            raise ValueError()
+
+        return idx
+
+    def _find_hms_idx(self, idx, tokens, info, allow_jump):
+        len_l = len(tokens)
+
+        if idx+1 < len_l and info.hms(tokens[idx+1]) is not None:
+            # There is an "h", "m", or "s" label following this token.  We take
+            # assign the upcoming label to the current token.
+            # e.g. the "12" in 12h"
+            hms_idx = idx + 1
+
+        elif (allow_jump and idx+2 < len_l and tokens[idx+1] == ' ' and
+              info.hms(tokens[idx+2]) is not None):
+            # There is a space and then an "h", "m", or "s" label.
+            # e.g. the "12" in "12 h"
+            hms_idx = idx + 2
+
+        elif idx > 0 and info.hms(tokens[idx-1]) is not None:
+            # There is a "h", "m", or "s" preceding this token.  Since neither
+            # of the previous cases was hit, there is no label following this
+            # token, so we use the previous label.
+            # e.g. the "04" in "12h04"
+            hms_idx = idx-1
+
+        elif (1 < idx == len_l-1 and tokens[idx-1] == ' ' and
+              info.hms(tokens[idx-2]) is not None):
+            # If we are looking at the final token, we allow for a
+            # backward-looking check to skip over a space.
+            # TODO: Are we sure this is the right condition here?
+            hms_idx = idx - 2
+
+        else:
+            hms_idx = None
+
+        return hms_idx
+
+    def _assign_hms(self, res, value_repr, hms):
+        # See GH issue #427, fixing float rounding
+        value = self._to_decimal(value_repr)
+
+        if hms == 0:
+            # Hour
+            res.hour = int(value)
+            if value % 1:
+                res.minute = int(60*(value % 1))
+
+        elif hms == 1:
+            (res.minute, res.second) = self._parse_min_sec(value)
+
+        elif hms == 2:
+            (res.second, res.microsecond) = self._parsems(value_repr)
+
+    def _could_be_tzname(self, hour, tzname, tzoffset, token):
+        return (hour is not None and
+                tzname is None and
+                tzoffset is None and
+                len(token) <= 5 and
+                (all(x in string.ascii_uppercase for x in token)
+                 or token in self.info.UTCZONE))
+
+    def _ampm_valid(self, hour, ampm, fuzzy):
+        """
+        For fuzzy parsing, 'a' or 'am' (both valid English words)
+        may erroneously trigger the AM/PM flag. Deal with that
+        here.
+        """
+        val_is_ampm = True
+
+        # If there's already an AM/PM flag, this one isn't one.
+        if fuzzy and ampm is not None:
+            val_is_ampm = False
+
+        # If AM/PM is found and hour is not, raise a ValueError
+        if hour is None:
+            if fuzzy:
+                val_is_ampm = False
+            else:
+                raise ValueError('No hour specified with AM or PM flag.')
+        elif not 0 <= hour <= 12:
+            # If AM/PM is found, it's a 12 hour clock, so raise
+            # an error for invalid range
+            if fuzzy:
+                val_is_ampm = False
+            else:
+                raise ValueError('Invalid hour specified for 12-hour clock.')
+
+        return val_is_ampm
+
+    def _adjust_ampm(self, hour, ampm):
+        if hour < 12 and ampm == 1:
+            hour += 12
+        elif hour == 12 and ampm == 0:
+            hour = 0
+        return hour
+
+    def _parse_min_sec(self, value):
+        # TODO: Every usage of this function sets res.second to the return
+        # value. Are there any cases where second will be returned as None and
+        # we *don't* want to set res.second = None?
+        minute = int(value)
+        second = None
+
+        sec_remainder = value % 1
+        if sec_remainder:
+            second = int(60 * sec_remainder)
+        return (minute, second)
+
+    def _parse_hms(self, idx, tokens, info, hms_idx):
+        # TODO: Is this going to admit a lot of false-positives for when we
+        # just happen to have digits and "h", "m" or "s" characters in non-date
+        # text?  I guess hex hashes won't have that problem, but there's plenty
+        # of random junk out there.
+        if hms_idx is None:
+            hms = None
+            new_idx = idx
+        elif hms_idx > idx:
+            hms = info.hms(tokens[hms_idx])
+            new_idx = hms_idx
+        else:
+            # Looking backwards, increment one.
+            hms = info.hms(tokens[hms_idx]) + 1
+            new_idx = idx
+
+        return (new_idx, hms)
+
+    # ------------------------------------------------------------------
+    # Handling for individual tokens.  These are kept as methods instead
+    #  of functions for the sake of customizability via subclassing.
+
+    def _parsems(self, value):
+        """Parse a I[.F] seconds value into (seconds, microseconds)."""
+        if "." not in value:
+            return int(value), 0
+        else:
+            i, f = value.split(".")
+            return int(i), int(f.ljust(6, "0")[:6])
+
+    def _to_decimal(self, val):
+        try:
+            decimal_value = Decimal(val)
+            # See GH 662, edge case, infinite value should not be converted
+            #  via `_to_decimal`
+            if not decimal_value.is_finite():
+                raise ValueError("Converted decimal value is infinite or NaN")
+        except Exception as e:
+            msg = "Could not convert %s to decimal" % val
+            six.raise_from(ValueError(msg), e)
+        else:
+            return decimal_value
+
+    # ------------------------------------------------------------------
+    # Post-Parsing construction of datetime output.  These are kept as
+    #  methods instead of functions for the sake of customizability via
+    #  subclassing.
+
+    def _build_tzinfo(self, tzinfos, tzname, tzoffset):
+        if callable(tzinfos):
+            tzdata = tzinfos(tzname, tzoffset)
+        else:
+            tzdata = tzinfos.get(tzname)
+        # handle case where tzinfo is paased an options that returns None
+        # eg tzinfos = {'BRST' : None}
+        if isinstance(tzdata, datetime.tzinfo) or tzdata is None:
+            tzinfo = tzdata
+        elif isinstance(tzdata, text_type):
+            tzinfo = tz.tzstr(tzdata)
+        elif isinstance(tzdata, integer_types):
+            tzinfo = tz.tzoffset(tzname, tzdata)
+        else:
+            raise TypeError("Offset must be tzinfo subclass, tz string, "
+                            "or int offset.")
+        return tzinfo
+
+    def _build_tzaware(self, naive, res, tzinfos):
+        if (callable(tzinfos) or (tzinfos and res.tzname in tzinfos)):
+            tzinfo = self._build_tzinfo(tzinfos, res.tzname, res.tzoffset)
+            aware = naive.replace(tzinfo=tzinfo)
+            aware = self._assign_tzname(aware, res.tzname)
+
+        elif res.tzname and res.tzname in time.tzname:
+            aware = naive.replace(tzinfo=tz.tzlocal())
+
+            # Handle ambiguous local datetime
+            aware = self._assign_tzname(aware, res.tzname)
+
+            # This is mostly relevant for winter GMT zones parsed in the UK
+            if (aware.tzname() != res.tzname and
+                    res.tzname in self.info.UTCZONE):
+                aware = aware.replace(tzinfo=tz.UTC)
+
+        elif res.tzoffset == 0:
+            aware = naive.replace(tzinfo=tz.UTC)
+
+        elif res.tzoffset:
+            aware = naive.replace(tzinfo=tz.tzoffset(res.tzname, res.tzoffset))
+
+        elif not res.tzname and not res.tzoffset:
+            # i.e. no timezone information was found.
+            aware = naive
+
+        elif res.tzname:
+            # tz-like string was parsed but we don't know what to do
+            # with it
+            warnings.warn("tzname {tzname} identified but not understood.  "
+                          "Pass `tzinfos` argument in order to correctly "
+                          "return a timezone-aware datetime.  In a future "
+                          "version, this will raise an "
+                          "exception.".format(tzname=res.tzname),
+                          category=UnknownTimezoneWarning)
+            aware = naive
+
+        return aware
+
+    def _build_naive(self, res, default):
+        repl = {}
+        for attr in ("year", "month", "day", "hour",
+                     "minute", "second", "microsecond"):
+            value = getattr(res, attr)
+            if value is not None:
+                repl[attr] = value
+
+        if 'day' not in repl:
+            # If the default day exceeds the last day of the month, fall back
+            # to the end of the month.
+            cyear = default.year if res.year is None else res.year
+            cmonth = default.month if res.month is None else res.month
+            cday = default.day if res.day is None else res.day
+
+            if cday > monthrange(cyear, cmonth)[1]:
+                repl['day'] = monthrange(cyear, cmonth)[1]
+
+        naive = default.replace(**repl)
+
+        if res.weekday is not None and not res.day:
+            naive = naive + relativedelta.relativedelta(weekday=res.weekday)
+
+        return naive
+
+    def _assign_tzname(self, dt, tzname):
+        if dt.tzname() != tzname:
+            new_dt = tz.enfold(dt, fold=1)
+            if new_dt.tzname() == tzname:
+                return new_dt
+
+        return dt
+
+    def _recombine_skipped(self, tokens, skipped_idxs):
+        """
+        >>> tokens = ["foo", " ", "bar", " ", "19June2000", "baz"]
+        >>> skipped_idxs = [0, 1, 2, 5]
+        >>> _recombine_skipped(tokens, skipped_idxs)
+        ["foo bar", "baz"]
+        """
+        skipped_tokens = []
+        for i, idx in enumerate(sorted(skipped_idxs)):
+            if i > 0 and idx - 1 == skipped_idxs[i - 1]:
+                skipped_tokens[-1] = skipped_tokens[-1] + tokens[idx]
+            else:
+                skipped_tokens.append(tokens[idx])
+
+        return skipped_tokens
+
+
+DEFAULTPARSER = parser()
+
+
+def parse(timestr, parserinfo=None, **kwargs):
+    """
+
+    Parse a string in one of the supported formats, using the
+    ``parserinfo`` parameters.
+
+    :param timestr:
+        A string containing a date/time stamp.
+
+    :param parserinfo:
+        A :class:`parserinfo` object containing parameters for the parser.
+        If ``None``, the default arguments to the :class:`parserinfo`
+        constructor are used.
+
+    The ``**kwargs`` parameter takes the following keyword arguments:
+
+    :param default:
+        The default datetime object, if this is a datetime object and not
+        ``None``, elements specified in ``timestr`` replace elements in the
+        default object.
+
+    :param ignoretz:
+        If set ``True``, time zones in parsed strings are ignored and a naive
+        :class:`datetime` object is returned.
+
+    :param tzinfos:
+        Additional time zone names / aliases which may be present in the
+        string. This argument maps time zone names (and optionally offsets
+        from those time zones) to time zones. This parameter can be a
+        dictionary with timezone aliases mapping time zone names to time
+        zones or a function taking two parameters (``tzname`` and
+        ``tzoffset``) and returning a time zone.
+
+        The timezones to which the names are mapped can be an integer
+        offset from UTC in seconds or a :class:`tzinfo` object.
+
+        .. doctest::
+           :options: +NORMALIZE_WHITESPACE
+
+            >>> from dateutil.parser import parse
+            >>> from dateutil.tz import gettz
+            >>> tzinfos = {"BRST": -7200, "CST": gettz("America/Chicago")}
+            >>> parse("2012-01-19 17:21:00 BRST", tzinfos=tzinfos)
+            datetime.datetime(2012, 1, 19, 17, 21, tzinfo=tzoffset(u'BRST', -7200))
+            >>> parse("2012-01-19 17:21:00 CST", tzinfos=tzinfos)
+            datetime.datetime(2012, 1, 19, 17, 21,
+                              tzinfo=tzfile('/usr/share/zoneinfo/America/Chicago'))
+
+        This parameter is ignored if ``ignoretz`` is set.
+
+    :param dayfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the day (``True``) or month (``False``). If
+        ``yearfirst`` is set to ``True``, this distinguishes between YDM and
+        YMD. If set to ``None``, this value is retrieved from the current
+        :class:`parserinfo` object (which itself defaults to ``False``).
+
+    :param yearfirst:
+        Whether to interpret the first value in an ambiguous 3-integer date
+        (e.g. 01/05/09) as the year. If ``True``, the first number is taken to
+        be the year, otherwise the last number is taken to be the year. If
+        this is set to ``None``, the value is retrieved from the current
+        :class:`parserinfo` object (which itself defaults to ``False``).
+
+    :param fuzzy:
+        Whether to allow fuzzy parsing, allowing for string like "Today is
+        January 1, 2047 at 8:21:00AM".
+
+    :param fuzzy_with_tokens:
+        If ``True``, ``fuzzy`` is automatically set to True, and the parser
+        will return a tuple where the first element is the parsed
+        :class:`datetime.datetime` datetimestamp and the second element is
+        a tuple containing the portions of the string which were ignored:
+
+        .. doctest::
+
+            >>> from dateutil.parser import parse
+            >>> parse("Today is January 1, 2047 at 8:21:00AM", fuzzy_with_tokens=True)
+            (datetime.datetime(2047, 1, 1, 8, 21), (u'Today is ', u' ', u'at '))
+
+    :return:
+        Returns a :class:`datetime.datetime` object or, if the
+        ``fuzzy_with_tokens`` option is ``True``, returns a tuple, the
+        first element being a :class:`datetime.datetime` object, the second
+        a tuple containing the fuzzy tokens.
+
+    :raises ValueError:
+        Raised for invalid or unknown string format, if the provided
+        :class:`tzinfo` is not in a valid format, or if an invalid date
+        would be created.
+
+    :raises OverflowError:
+        Raised if the parsed date exceeds the largest valid C integer on
+        your system.
+    """
+    if parserinfo:
+        return parser(parserinfo).parse(timestr, **kwargs)
+    else:
+        return DEFAULTPARSER.parse(timestr, **kwargs)
+
+
+class _tzparser(object):
+
+    class _result(_resultbase):
+
+        __slots__ = ["stdabbr", "stdoffset", "dstabbr", "dstoffset",
+                     "start", "end"]
+
+        class _attr(_resultbase):
+            __slots__ = ["month", "week", "weekday",
+                         "yday", "jyday", "day", "time"]
+
+        def __repr__(self):
+            return self._repr("")
+
+        def __init__(self):
+            _resultbase.__init__(self)
+            self.start = self._attr()
+            self.end = self._attr()
+
+    def parse(self, tzstr):
+        res = self._result()
+        l = [x for x in re.split(r'([,:.]|[a-zA-Z]+|[0-9]+)',tzstr) if x]
+        used_idxs = list()
+        try:
+
+            len_l = len(l)
+
+            i = 0
+            while i < len_l:
+                # BRST+3[BRDT[+2]]
+                j = i
+                while j < len_l and not [x for x in l[j]
+                                         if x in "0123456789:,-+"]:
+                    j += 1
+                if j != i:
+                    if not res.stdabbr:
+                        offattr = "stdoffset"
+                        res.stdabbr = "".join(l[i:j])
+                    else:
+                        offattr = "dstoffset"
+                        res.dstabbr = "".join(l[i:j])
+
+                    for ii in range(j):
+                        used_idxs.append(ii)
+                    i = j
+                    if (i < len_l and (l[i] in ('+', '-') or l[i][0] in
+                                       "0123456789")):
+                        if l[i] in ('+', '-'):
+                            # Yes, that's right.  See the TZ variable
+                            # documentation.
+                            signal = (1, -1)[l[i] == '+']
+                            used_idxs.append(i)
+                            i += 1
+                        else:
+                            signal = -1
+                        len_li = len(l[i])
+                        if len_li == 4:
+                            # -0300
+                            setattr(res, offattr, (int(l[i][:2]) * 3600 +
+                                                   int(l[i][2:]) * 60) * signal)
+                        elif i + 1 < len_l and l[i + 1] == ':':
+                            # -03:00
+                            setattr(res, offattr,
+                                    (int(l[i]) * 3600 +
+                                     int(l[i + 2]) * 60) * signal)
+                            used_idxs.append(i)
+                            i += 2
+                        elif len_li <= 2:
+                            # -[0]3
+                            setattr(res, offattr,
+                                    int(l[i][:2]) * 3600 * signal)
+                        else:
+                            return None
+                        used_idxs.append(i)
+                        i += 1
+                    if res.dstabbr:
+                        break
+                else:
+                    break
+
+
+            if i < len_l:
+                for j in range(i, len_l):
+                    if l[j] == ';':
+                        l[j] = ','
+
+                assert l[i] == ','
+
+                i += 1
+
+            if i >= len_l:
+                pass
+            elif (8 <= l.count(',') <= 9 and
+                  not [y for x in l[i:] if x != ','
+                       for y in x if y not in "0123456789+-"]):
+                # GMT0BST,3,0,30,3600,10,0,26,7200[,3600]
+                for x in (res.start, res.end):
+                    x.month = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    if l[i] == '-':
+                        value = int(l[i + 1]) * -1
+                        used_idxs.append(i)
+                        i += 1
+                    else:
+                        value = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    if value:
+                        x.week = value
+                        x.weekday = (int(l[i]) - 1) % 7
+                    else:
+                        x.day = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                    x.time = int(l[i])
+                    used_idxs.append(i)
+                    i += 2
+                if i < len_l:
+                    if l[i] in ('-', '+'):
+                        signal = (-1, 1)[l[i] == "+"]
+                        used_idxs.append(i)
+                        i += 1
+                    else:
+                        signal = 1
+                    used_idxs.append(i)
+                    res.dstoffset = (res.stdoffset + int(l[i]) * signal)
+
+                # This was a made-up format that is not in normal use
+                warn(('Parsed time zone "%s"' % tzstr) +
+                     'is in a non-standard dateutil-specific format, which ' +
+                     'is now deprecated; support for parsing this format ' +
+                     'will be removed in future versions. It is recommended ' +
+                     'that you switch to a standard format like the GNU ' +
+                     'TZ variable format.', tz.DeprecatedTzFormatWarning)
+            elif (l.count(',') == 2 and l[i:].count('/') <= 2 and
+                  not [y for x in l[i:] if x not in (',', '/', 'J', 'M',
+                                                     '.', '-', ':')
+                       for y in x if y not in "0123456789"]):
+                for x in (res.start, res.end):
+                    if l[i] == 'J':
+                        # non-leap year day (1 based)
+                        used_idxs.append(i)
+                        i += 1
+                        x.jyday = int(l[i])
+                    elif l[i] == 'M':
+                        # month[-.]week[-.]weekday
+                        used_idxs.append(i)
+                        i += 1
+                        x.month = int(l[i])
+                        used_idxs.append(i)
+                        i += 1
+                        assert l[i] in ('-', '.')
+                        used_idxs.append(i)
+                        i += 1
+                        x.week = int(l[i])
+                        if x.week == 5:
+                            x.week = -1
+                        used_idxs.append(i)
+                        i += 1
+                        assert l[i] in ('-', '.')
+                        used_idxs.append(i)
+                        i += 1
+                        x.weekday = (int(l[i]) - 1) % 7
+                    else:
+                        # year day (zero based)
+                        x.yday = int(l[i]) + 1
+
+                    used_idxs.append(i)
+                    i += 1
+
+                    if i < len_l and l[i] == '/':
+                        used_idxs.append(i)
+                        i += 1
+                        # start time
+                        len_li = len(l[i])
+                        if len_li == 4:
+                            # -0300
+                            x.time = (int(l[i][:2]) * 3600 +
+                                      int(l[i][2:]) * 60)
+                        elif i + 1 < len_l and l[i + 1] == ':':
+                            # -03:00
+                            x.time = int(l[i]) * 3600 + int(l[i + 2]) * 60
+                            used_idxs.append(i)
+                            i += 2
+                            if i + 1 < len_l and l[i + 1] == ':':
+                                used_idxs.append(i)
+                                i += 2
+                                x.time += int(l[i])
+                        elif len_li <= 2:
+                            # -[0]3
+                            x.time = (int(l[i][:2]) * 3600)
+                        else:
+                            return None
+                        used_idxs.append(i)
+                        i += 1
+
+                    assert i == len_l or l[i] == ','
+
+                    i += 1
+
+                assert i >= len_l
+
+        except (IndexError, ValueError, AssertionError):
+            return None
+
+        unused_idxs = set(range(len_l)).difference(used_idxs)
+        res.any_unused_tokens = not {l[n] for n in unused_idxs}.issubset({",",":"})
+        return res
+
+
+DEFAULTTZPARSER = _tzparser()
+
+
+def _parsetz(tzstr):
+    return DEFAULTTZPARSER.parse(tzstr)
+
+
+class ParserError(ValueError):
+    """Error class for representing failure to parse a datetime string."""
+    def __str__(self):
+        try:
+            return self.args[0] % self.args[1:]
+        except (TypeError, IndexError):
+            return super(ParserError, self).__str__()
+
+        def __repr__(self):
+            return "%s(%s)" % (self.__class__.__name__, str(self))
+
+
+class UnknownTimezoneWarning(RuntimeWarning):
+    """Raised when the parser finds a timezone it cannot parse into a tzinfo"""
+# vim:ts=4:sw=4:et
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/isoparser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/isoparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..48f86a335591ed4cc9a42320c59205f9bbfb5b8e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/parser/isoparser.py
@@ -0,0 +1,411 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers a parser for ISO-8601 strings
+
+It is intended to support all valid date, time and datetime formats per the
+ISO-8601 specification.
+
+..versionadded:: 2.7.0
+"""
+from datetime import datetime, timedelta, time, date
+import calendar
+from dateutil import tz
+
+from functools import wraps
+
+import re
+import six
+
+__all__ = ["isoparse", "isoparser"]
+
+
+def _takes_ascii(f):
+    @wraps(f)
+    def func(self, str_in, *args, **kwargs):
+        # If it's a stream, read the whole thing
+        str_in = getattr(str_in, 'read', lambda: str_in)()
+
+        # If it's unicode, turn it into bytes, since ISO-8601 only covers ASCII
+        if isinstance(str_in, six.text_type):
+            # ASCII is the same in UTF-8
+            try:
+                str_in = str_in.encode('ascii')
+            except UnicodeEncodeError as e:
+                msg = 'ISO-8601 strings should contain only ASCII characters'
+                six.raise_from(ValueError(msg), e)
+
+        return f(self, str_in, *args, **kwargs)
+
+    return func
+
+
+class isoparser(object):
+    def __init__(self, sep=None):
+        """
+        :param sep:
+            A single character that separates date and time portions. If
+            ``None``, the parser will accept any single character.
+            For strict ISO-8601 adherence, pass ``'T'``.
+        """
+        if sep is not None:
+            if (len(sep) != 1 or ord(sep) >= 128 or sep in '0123456789'):
+                raise ValueError('Separator must be a single, non-numeric ' +
+                                 'ASCII character')
+
+            sep = sep.encode('ascii')
+
+        self._sep = sep
+
+    @_takes_ascii
+    def isoparse(self, dt_str):
+        """
+        Parse an ISO-8601 datetime string into a :class:`datetime.datetime`.
+
+        An ISO-8601 datetime string consists of a date portion, followed
+        optionally by a time portion - the date and time portions are separated
+        by a single character separator, which is ``T`` in the official
+        standard. Incomplete date formats (such as ``YYYY-MM``) may *not* be
+        combined with a time portion.
+
+        Supported date formats are:
+
+        Common:
+
+        - ``YYYY``
+        - ``YYYY-MM`` or ``YYYYMM``
+        - ``YYYY-MM-DD`` or ``YYYYMMDD``
+
+        Uncommon:
+
+        - ``YYYY-Www`` or ``YYYYWww`` - ISO week (day defaults to 0)
+        - ``YYYY-Www-D`` or ``YYYYWwwD`` - ISO week and day
+
+        The ISO week and day numbering follows the same logic as
+        :func:`datetime.date.isocalendar`.
+
+        Supported time formats are:
+
+        - ``hh``
+        - ``hh:mm`` or ``hhmm``
+        - ``hh:mm:ss`` or ``hhmmss``
+        - ``hh:mm:ss.ssssss`` (Up to 6 sub-second digits)
+
+        Midnight is a special case for `hh`, as the standard supports both
+        00:00 and 24:00 as a representation. The decimal separator can be
+        either a dot or a comma.
+
+
+        .. caution::
+
+            Support for fractional components other than seconds is part of the
+            ISO-8601 standard, but is not currently implemented in this parser.
+
+        Supported time zone offset formats are:
+
+        - `Z` (UTC)
+        - `±HH:MM`
+        - `±HHMM`
+        - `±HH`
+
+        Offsets will be represented as :class:`dateutil.tz.tzoffset` objects,
+        with the exception of UTC, which will be represented as
+        :class:`dateutil.tz.tzutc`. Time zone offsets equivalent to UTC (such
+        as `+00:00`) will also be represented as :class:`dateutil.tz.tzutc`.
+
+        :param dt_str:
+            A string or stream containing only an ISO-8601 datetime string
+
+        :return:
+            Returns a :class:`datetime.datetime` representing the string.
+            Unspecified components default to their lowest value.
+
+        .. warning::
+
+            As of version 2.7.0, the strictness of the parser should not be
+            considered a stable part of the contract. Any valid ISO-8601 string
+            that parses correctly with the default settings will continue to
+            parse correctly in future versions, but invalid strings that
+            currently fail (e.g. ``2017-01-01T00:00+00:00:00``) are not
+            guaranteed to continue failing in future versions if they encode
+            a valid date.
+
+        .. versionadded:: 2.7.0
+        """
+        components, pos = self._parse_isodate(dt_str)
+
+        if len(dt_str) > pos:
+            if self._sep is None or dt_str[pos:pos + 1] == self._sep:
+                components += self._parse_isotime(dt_str[pos + 1:])
+            else:
+                raise ValueError('String contains unknown ISO components')
+
+        if len(components) > 3 and components[3] == 24:
+            components[3] = 0
+            return datetime(*components) + timedelta(days=1)
+
+        return datetime(*components)
+
+    @_takes_ascii
+    def parse_isodate(self, datestr):
+        """
+        Parse the date portion of an ISO string.
+
+        :param datestr:
+            The string portion of an ISO string, without a separator
+
+        :return:
+            Returns a :class:`datetime.date` object
+        """
+        components, pos = self._parse_isodate(datestr)
+        if pos < len(datestr):
+            raise ValueError('String contains unknown ISO ' +
+                             'components: {}'.format(datestr))
+        return date(*components)
+
+    @_takes_ascii
+    def parse_isotime(self, timestr):
+        """
+        Parse the time portion of an ISO string.
+
+        :param timestr:
+            The time portion of an ISO string, without a separator
+
+        :return:
+            Returns a :class:`datetime.time` object
+        """
+        components = self._parse_isotime(timestr)
+        if components[0] == 24:
+            components[0] = 0
+        return time(*components)
+
+    @_takes_ascii
+    def parse_tzstr(self, tzstr, zero_as_utc=True):
+        """
+        Parse a valid ISO time zone string.
+
+        See :func:`isoparser.isoparse` for details on supported formats.
+
+        :param tzstr:
+            A string representing an ISO time zone offset
+
+        :param zero_as_utc:
+            Whether to return :class:`dateutil.tz.tzutc` for zero-offset zones
+
+        :return:
+            Returns :class:`dateutil.tz.tzoffset` for offsets and
+            :class:`dateutil.tz.tzutc` for ``Z`` and (if ``zero_as_utc`` is
+            specified) offsets equivalent to UTC.
+        """
+        return self._parse_tzstr(tzstr, zero_as_utc=zero_as_utc)
+
+    # Constants
+    _DATE_SEP = b'-'
+    _TIME_SEP = b':'
+    _FRACTION_REGEX = re.compile(b'[\\.,]([0-9]+)')
+
+    def _parse_isodate(self, dt_str):
+        try:
+            return self._parse_isodate_common(dt_str)
+        except ValueError:
+            return self._parse_isodate_uncommon(dt_str)
+
+    def _parse_isodate_common(self, dt_str):
+        len_str = len(dt_str)
+        components = [1, 1, 1]
+
+        if len_str < 4:
+            raise ValueError('ISO string too short')
+
+        # Year
+        components[0] = int(dt_str[0:4])
+        pos = 4
+        if pos >= len_str:
+            return components, pos
+
+        has_sep = dt_str[pos:pos + 1] == self._DATE_SEP
+        if has_sep:
+            pos += 1
+
+        # Month
+        if len_str - pos < 2:
+            raise ValueError('Invalid common month')
+
+        components[1] = int(dt_str[pos:pos + 2])
+        pos += 2
+
+        if pos >= len_str:
+            if has_sep:
+                return components, pos
+            else:
+                raise ValueError('Invalid ISO format')
+
+        if has_sep:
+            if dt_str[pos:pos + 1] != self._DATE_SEP:
+                raise ValueError('Invalid separator in ISO string')
+            pos += 1
+
+        # Day
+        if len_str - pos < 2:
+            raise ValueError('Invalid common day')
+        components[2] = int(dt_str[pos:pos + 2])
+        return components, pos + 2
+
+    def _parse_isodate_uncommon(self, dt_str):
+        if len(dt_str) < 4:
+            raise ValueError('ISO string too short')
+
+        # All ISO formats start with the year
+        year = int(dt_str[0:4])
+
+        has_sep = dt_str[4:5] == self._DATE_SEP
+
+        pos = 4 + has_sep       # Skip '-' if it's there
+        if dt_str[pos:pos + 1] == b'W':
+            # YYYY-?Www-?D?
+            pos += 1
+            weekno = int(dt_str[pos:pos + 2])
+            pos += 2
+
+            dayno = 1
+            if len(dt_str) > pos:
+                if (dt_str[pos:pos + 1] == self._DATE_SEP) != has_sep:
+                    raise ValueError('Inconsistent use of dash separator')
+
+                pos += has_sep
+
+                dayno = int(dt_str[pos:pos + 1])
+                pos += 1
+
+            base_date = self._calculate_weekdate(year, weekno, dayno)
+        else:
+            # YYYYDDD or YYYY-DDD
+            if len(dt_str) - pos < 3:
+                raise ValueError('Invalid ordinal day')
+
+            ordinal_day = int(dt_str[pos:pos + 3])
+            pos += 3
+
+            if ordinal_day < 1 or ordinal_day > (365 + calendar.isleap(year)):
+                raise ValueError('Invalid ordinal day' +
+                                 ' {} for year {}'.format(ordinal_day, year))
+
+            base_date = date(year, 1, 1) + timedelta(days=ordinal_day - 1)
+
+        components = [base_date.year, base_date.month, base_date.day]
+        return components, pos
+
+    def _calculate_weekdate(self, year, week, day):
+        """
+        Calculate the day of corresponding to the ISO year-week-day calendar.
+
+        This function is effectively the inverse of
+        :func:`datetime.date.isocalendar`.
+
+        :param year:
+            The year in the ISO calendar
+
+        :param week:
+            The week in the ISO calendar - range is [1, 53]
+
+        :param day:
+            The day in the ISO calendar - range is [1 (MON), 7 (SUN)]
+
+        :return:
+            Returns a :class:`datetime.date`
+        """
+        if not 0 < week < 54:
+            raise ValueError('Invalid week: {}'.format(week))
+
+        if not 0 < day < 8:     # Range is 1-7
+            raise ValueError('Invalid weekday: {}'.format(day))
+
+        # Get week 1 for the specific year:
+        jan_4 = date(year, 1, 4)   # Week 1 always has January 4th in it
+        week_1 = jan_4 - timedelta(days=jan_4.isocalendar()[2] - 1)
+
+        # Now add the specific number of weeks and days to get what we want
+        week_offset = (week - 1) * 7 + (day - 1)
+        return week_1 + timedelta(days=week_offset)
+
+    def _parse_isotime(self, timestr):
+        len_str = len(timestr)
+        components = [0, 0, 0, 0, None]
+        pos = 0
+        comp = -1
+
+        if len(timestr) < 2:
+            raise ValueError('ISO time too short')
+
+        has_sep = len_str >= 3 and timestr[2:3] == self._TIME_SEP
+
+        while pos < len_str and comp < 5:
+            comp += 1
+
+            if timestr[pos:pos + 1] in b'-+Zz':
+                # Detect time zone boundary
+                components[-1] = self._parse_tzstr(timestr[pos:])
+                pos = len_str
+                break
+
+            if comp < 3:
+                # Hour, minute, second
+                components[comp] = int(timestr[pos:pos + 2])
+                pos += 2
+                if (has_sep and pos < len_str and
+                        timestr[pos:pos + 1] == self._TIME_SEP):
+                    pos += 1
+
+            if comp == 3:
+                # Fraction of a second
+                frac = self._FRACTION_REGEX.match(timestr[pos:])
+                if not frac:
+                    continue
+
+                us_str = frac.group(1)[:6]  # Truncate to microseconds
+                components[comp] = int(us_str) * 10**(6 - len(us_str))
+                pos += len(frac.group())
+
+        if pos < len_str:
+            raise ValueError('Unused components in ISO string')
+
+        if components[0] == 24:
+            # Standard supports 00:00 and 24:00 as representations of midnight
+            if any(component != 0 for component in components[1:4]):
+                raise ValueError('Hour may only be 24 at 24:00:00.000')
+
+        return components
+
+    def _parse_tzstr(self, tzstr, zero_as_utc=True):
+        if tzstr == b'Z' or tzstr == b'z':
+            return tz.UTC
+
+        if len(tzstr) not in {3, 5, 6}:
+            raise ValueError('Time zone offset must be 1, 3, 5 or 6 characters')
+
+        if tzstr[0:1] == b'-':
+            mult = -1
+        elif tzstr[0:1] == b'+':
+            mult = 1
+        else:
+            raise ValueError('Time zone offset requires sign')
+
+        hours = int(tzstr[1:3])
+        if len(tzstr) == 3:
+            minutes = 0
+        else:
+            minutes = int(tzstr[(4 if tzstr[3:4] == self._TIME_SEP else 3):])
+
+        if zero_as_utc and hours == 0 and minutes == 0:
+            return tz.UTC
+        else:
+            if minutes > 59:
+                raise ValueError('Invalid minutes in time zone offset')
+
+            if hours > 23:
+                raise ValueError('Invalid hours in time zone offset')
+
+            return tz.tzoffset(None, mult * (hours * 60 + minutes) * 60)
+
+
+DEFAULT_ISOPARSER = isoparser()
+isoparse = DEFAULT_ISOPARSER.isoparse
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/relativedelta.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/relativedelta.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9e85f7e6cd7488e6b2f4b249d5cf6af314c3859
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/relativedelta.py
@@ -0,0 +1,599 @@
+# -*- coding: utf-8 -*-
+import datetime
+import calendar
+
+import operator
+from math import copysign
+
+from six import integer_types
+from warnings import warn
+
+from ._common import weekday
+
+MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7))
+
+__all__ = ["relativedelta", "MO", "TU", "WE", "TH", "FR", "SA", "SU"]
+
+
+class relativedelta(object):
+    """
+    The relativedelta type is designed to be applied to an existing datetime and
+    can replace specific components of that datetime, or represents an interval
+    of time.
+
+    It is based on the specification of the excellent work done by M.-A. Lemburg
+    in his
+    `mx.DateTime <https://www.egenix.com/products/python/mxBase/mxDateTime/>`_ extension.
+    However, notice that this type does *NOT* implement the same algorithm as
+    his work. Do *NOT* expect it to behave like mx.DateTime's counterpart.
+
+    There are two different ways to build a relativedelta instance. The
+    first one is passing it two date/datetime classes::
+
+        relativedelta(datetime1, datetime2)
+
+    The second one is passing it any number of the following keyword arguments::
+
+        relativedelta(arg1=x,arg2=y,arg3=z...)
+
+        year, month, day, hour, minute, second, microsecond:
+            Absolute information (argument is singular); adding or subtracting a
+            relativedelta with absolute information does not perform an arithmetic
+            operation, but rather REPLACES the corresponding value in the
+            original datetime with the value(s) in relativedelta.
+
+        years, months, weeks, days, hours, minutes, seconds, microseconds:
+            Relative information, may be negative (argument is plural); adding
+            or subtracting a relativedelta with relative information performs
+            the corresponding arithmetic operation on the original datetime value
+            with the information in the relativedelta.
+
+        weekday: 
+            One of the weekday instances (MO, TU, etc) available in the
+            relativedelta module. These instances may receive a parameter N,
+            specifying the Nth weekday, which could be positive or negative
+            (like MO(+1) or MO(-2)). Not specifying it is the same as specifying
+            +1. You can also use an integer, where 0=MO. This argument is always
+            relative e.g. if the calculated date is already Monday, using MO(1)
+            or MO(-1) won't change the day. To effectively make it absolute, use
+            it in combination with the day argument (e.g. day=1, MO(1) for first
+            Monday of the month).
+
+        leapdays:
+            Will add given days to the date found, if year is a leap
+            year, and the date found is post 28 of february.
+
+        yearday, nlyearday:
+            Set the yearday or the non-leap year day (jump leap days).
+            These are converted to day/month/leapdays information.
+
+    There are relative and absolute forms of the keyword
+    arguments. The plural is relative, and the singular is
+    absolute. For each argument in the order below, the absolute form
+    is applied first (by setting each attribute to that value) and
+    then the relative form (by adding the value to the attribute).
+
+    The order of attributes considered when this relativedelta is
+    added to a datetime is:
+
+    1. Year
+    2. Month
+    3. Day
+    4. Hours
+    5. Minutes
+    6. Seconds
+    7. Microseconds
+
+    Finally, weekday is applied, using the rule described above.
+
+    For example
+
+    >>> from datetime import datetime
+    >>> from dateutil.relativedelta import relativedelta, MO
+    >>> dt = datetime(2018, 4, 9, 13, 37, 0)
+    >>> delta = relativedelta(hours=25, day=1, weekday=MO(1))
+    >>> dt + delta
+    datetime.datetime(2018, 4, 2, 14, 37)
+
+    First, the day is set to 1 (the first of the month), then 25 hours
+    are added, to get to the 2nd day and 14th hour, finally the
+    weekday is applied, but since the 2nd is already a Monday there is
+    no effect.
+
+    """
+
+    def __init__(self, dt1=None, dt2=None,
+                 years=0, months=0, days=0, leapdays=0, weeks=0,
+                 hours=0, minutes=0, seconds=0, microseconds=0,
+                 year=None, month=None, day=None, weekday=None,
+                 yearday=None, nlyearday=None,
+                 hour=None, minute=None, second=None, microsecond=None):
+
+        if dt1 and dt2:
+            # datetime is a subclass of date. So both must be date
+            if not (isinstance(dt1, datetime.date) and
+                    isinstance(dt2, datetime.date)):
+                raise TypeError("relativedelta only diffs datetime/date")
+
+            # We allow two dates, or two datetimes, so we coerce them to be
+            # of the same type
+            if (isinstance(dt1, datetime.datetime) !=
+                    isinstance(dt2, datetime.datetime)):
+                if not isinstance(dt1, datetime.datetime):
+                    dt1 = datetime.datetime.fromordinal(dt1.toordinal())
+                elif not isinstance(dt2, datetime.datetime):
+                    dt2 = datetime.datetime.fromordinal(dt2.toordinal())
+
+            self.years = 0
+            self.months = 0
+            self.days = 0
+            self.leapdays = 0
+            self.hours = 0
+            self.minutes = 0
+            self.seconds = 0
+            self.microseconds = 0
+            self.year = None
+            self.month = None
+            self.day = None
+            self.weekday = None
+            self.hour = None
+            self.minute = None
+            self.second = None
+            self.microsecond = None
+            self._has_time = 0
+
+            # Get year / month delta between the two
+            months = (dt1.year - dt2.year) * 12 + (dt1.month - dt2.month)
+            self._set_months(months)
+
+            # Remove the year/month delta so the timedelta is just well-defined
+            # time units (seconds, days and microseconds)
+            dtm = self.__radd__(dt2)
+
+            # If we've overshot our target, make an adjustment
+            if dt1 < dt2:
+                compare = operator.gt
+                increment = 1
+            else:
+                compare = operator.lt
+                increment = -1
+
+            while compare(dt1, dtm):
+                months += increment
+                self._set_months(months)
+                dtm = self.__radd__(dt2)
+
+            # Get the timedelta between the "months-adjusted" date and dt1
+            delta = dt1 - dtm
+            self.seconds = delta.seconds + delta.days * 86400
+            self.microseconds = delta.microseconds
+        else:
+            # Check for non-integer values in integer-only quantities
+            if any(x is not None and x != int(x) for x in (years, months)):
+                raise ValueError("Non-integer years and months are "
+                                 "ambiguous and not currently supported.")
+
+            # Relative information
+            self.years = int(years)
+            self.months = int(months)
+            self.days = days + weeks * 7
+            self.leapdays = leapdays
+            self.hours = hours
+            self.minutes = minutes
+            self.seconds = seconds
+            self.microseconds = microseconds
+
+            # Absolute information
+            self.year = year
+            self.month = month
+            self.day = day
+            self.hour = hour
+            self.minute = minute
+            self.second = second
+            self.microsecond = microsecond
+
+            if any(x is not None and int(x) != x
+                   for x in (year, month, day, hour,
+                             minute, second, microsecond)):
+                # For now we'll deprecate floats - later it'll be an error.
+                warn("Non-integer value passed as absolute information. " +
+                     "This is not a well-defined condition and will raise " +
+                     "errors in future versions.", DeprecationWarning)
+
+            if isinstance(weekday, integer_types):
+                self.weekday = weekdays[weekday]
+            else:
+                self.weekday = weekday
+
+            yday = 0
+            if nlyearday:
+                yday = nlyearday
+            elif yearday:
+                yday = yearday
+                if yearday > 59:
+                    self.leapdays = -1
+            if yday:
+                ydayidx = [31, 59, 90, 120, 151, 181, 212,
+                           243, 273, 304, 334, 366]
+                for idx, ydays in enumerate(ydayidx):
+                    if yday <= ydays:
+                        self.month = idx+1
+                        if idx == 0:
+                            self.day = yday
+                        else:
+                            self.day = yday-ydayidx[idx-1]
+                        break
+                else:
+                    raise ValueError("invalid year day (%d)" % yday)
+
+        self._fix()
+
+    def _fix(self):
+        if abs(self.microseconds) > 999999:
+            s = _sign(self.microseconds)
+            div, mod = divmod(self.microseconds * s, 1000000)
+            self.microseconds = mod * s
+            self.seconds += div * s
+        if abs(self.seconds) > 59:
+            s = _sign(self.seconds)
+            div, mod = divmod(self.seconds * s, 60)
+            self.seconds = mod * s
+            self.minutes += div * s
+        if abs(self.minutes) > 59:
+            s = _sign(self.minutes)
+            div, mod = divmod(self.minutes * s, 60)
+            self.minutes = mod * s
+            self.hours += div * s
+        if abs(self.hours) > 23:
+            s = _sign(self.hours)
+            div, mod = divmod(self.hours * s, 24)
+            self.hours = mod * s
+            self.days += div * s
+        if abs(self.months) > 11:
+            s = _sign(self.months)
+            div, mod = divmod(self.months * s, 12)
+            self.months = mod * s
+            self.years += div * s
+        if (self.hours or self.minutes or self.seconds or self.microseconds
+                or self.hour is not None or self.minute is not None or
+                self.second is not None or self.microsecond is not None):
+            self._has_time = 1
+        else:
+            self._has_time = 0
+
+    @property
+    def weeks(self):
+        return int(self.days / 7.0)
+
+    @weeks.setter
+    def weeks(self, value):
+        self.days = self.days - (self.weeks * 7) + value * 7
+
+    def _set_months(self, months):
+        self.months = months
+        if abs(self.months) > 11:
+            s = _sign(self.months)
+            div, mod = divmod(self.months * s, 12)
+            self.months = mod * s
+            self.years = div * s
+        else:
+            self.years = 0
+
+    def normalized(self):
+        """
+        Return a version of this object represented entirely using integer
+        values for the relative attributes.
+
+        >>> relativedelta(days=1.5, hours=2).normalized()
+        relativedelta(days=+1, hours=+14)
+
+        :return:
+            Returns a :class:`dateutil.relativedelta.relativedelta` object.
+        """
+        # Cascade remainders down (rounding each to roughly nearest microsecond)
+        days = int(self.days)
+
+        hours_f = round(self.hours + 24 * (self.days - days), 11)
+        hours = int(hours_f)
+
+        minutes_f = round(self.minutes + 60 * (hours_f - hours), 10)
+        minutes = int(minutes_f)
+
+        seconds_f = round(self.seconds + 60 * (minutes_f - minutes), 8)
+        seconds = int(seconds_f)
+
+        microseconds = round(self.microseconds + 1e6 * (seconds_f - seconds))
+
+        # Constructor carries overflow back up with call to _fix()
+        return self.__class__(years=self.years, months=self.months,
+                              days=days, hours=hours, minutes=minutes,
+                              seconds=seconds, microseconds=microseconds,
+                              leapdays=self.leapdays, year=self.year,
+                              month=self.month, day=self.day,
+                              weekday=self.weekday, hour=self.hour,
+                              minute=self.minute, second=self.second,
+                              microsecond=self.microsecond)
+
+    def __add__(self, other):
+        if isinstance(other, relativedelta):
+            return self.__class__(years=other.years + self.years,
+                                 months=other.months + self.months,
+                                 days=other.days + self.days,
+                                 hours=other.hours + self.hours,
+                                 minutes=other.minutes + self.minutes,
+                                 seconds=other.seconds + self.seconds,
+                                 microseconds=(other.microseconds +
+                                               self.microseconds),
+                                 leapdays=other.leapdays or self.leapdays,
+                                 year=(other.year if other.year is not None
+                                       else self.year),
+                                 month=(other.month if other.month is not None
+                                        else self.month),
+                                 day=(other.day if other.day is not None
+                                      else self.day),
+                                 weekday=(other.weekday if other.weekday is not None
+                                          else self.weekday),
+                                 hour=(other.hour if other.hour is not None
+                                       else self.hour),
+                                 minute=(other.minute if other.minute is not None
+                                         else self.minute),
+                                 second=(other.second if other.second is not None
+                                         else self.second),
+                                 microsecond=(other.microsecond if other.microsecond
+                                              is not None else
+                                              self.microsecond))
+        if isinstance(other, datetime.timedelta):
+            return self.__class__(years=self.years,
+                                  months=self.months,
+                                  days=self.days + other.days,
+                                  hours=self.hours,
+                                  minutes=self.minutes,
+                                  seconds=self.seconds + other.seconds,
+                                  microseconds=self.microseconds + other.microseconds,
+                                  leapdays=self.leapdays,
+                                  year=self.year,
+                                  month=self.month,
+                                  day=self.day,
+                                  weekday=self.weekday,
+                                  hour=self.hour,
+                                  minute=self.minute,
+                                  second=self.second,
+                                  microsecond=self.microsecond)
+        if not isinstance(other, datetime.date):
+            return NotImplemented
+        elif self._has_time and not isinstance(other, datetime.datetime):
+            other = datetime.datetime.fromordinal(other.toordinal())
+        year = (self.year or other.year)+self.years
+        month = self.month or other.month
+        if self.months:
+            assert 1 <= abs(self.months) <= 12
+            month += self.months
+            if month > 12:
+                year += 1
+                month -= 12
+            elif month < 1:
+                year -= 1
+                month += 12
+        day = min(calendar.monthrange(year, month)[1],
+                  self.day or other.day)
+        repl = {"year": year, "month": month, "day": day}
+        for attr in ["hour", "minute", "second", "microsecond"]:
+            value = getattr(self, attr)
+            if value is not None:
+                repl[attr] = value
+        days = self.days
+        if self.leapdays and month > 2 and calendar.isleap(year):
+            days += self.leapdays
+        ret = (other.replace(**repl)
+               + datetime.timedelta(days=days,
+                                    hours=self.hours,
+                                    minutes=self.minutes,
+                                    seconds=self.seconds,
+                                    microseconds=self.microseconds))
+        if self.weekday:
+            weekday, nth = self.weekday.weekday, self.weekday.n or 1
+            jumpdays = (abs(nth) - 1) * 7
+            if nth > 0:
+                jumpdays += (7 - ret.weekday() + weekday) % 7
+            else:
+                jumpdays += (ret.weekday() - weekday) % 7
+                jumpdays *= -1
+            ret += datetime.timedelta(days=jumpdays)
+        return ret
+
+    def __radd__(self, other):
+        return self.__add__(other)
+
+    def __rsub__(self, other):
+        return self.__neg__().__radd__(other)
+
+    def __sub__(self, other):
+        if not isinstance(other, relativedelta):
+            return NotImplemented   # In case the other object defines __rsub__
+        return self.__class__(years=self.years - other.years,
+                             months=self.months - other.months,
+                             days=self.days - other.days,
+                             hours=self.hours - other.hours,
+                             minutes=self.minutes - other.minutes,
+                             seconds=self.seconds - other.seconds,
+                             microseconds=self.microseconds - other.microseconds,
+                             leapdays=self.leapdays or other.leapdays,
+                             year=(self.year if self.year is not None
+                                   else other.year),
+                             month=(self.month if self.month is not None else
+                                    other.month),
+                             day=(self.day if self.day is not None else
+                                  other.day),
+                             weekday=(self.weekday if self.weekday is not None else
+                                      other.weekday),
+                             hour=(self.hour if self.hour is not None else
+                                   other.hour),
+                             minute=(self.minute if self.minute is not None else
+                                     other.minute),
+                             second=(self.second if self.second is not None else
+                                     other.second),
+                             microsecond=(self.microsecond if self.microsecond
+                                          is not None else
+                                          other.microsecond))
+
+    def __abs__(self):
+        return self.__class__(years=abs(self.years),
+                              months=abs(self.months),
+                              days=abs(self.days),
+                              hours=abs(self.hours),
+                              minutes=abs(self.minutes),
+                              seconds=abs(self.seconds),
+                              microseconds=abs(self.microseconds),
+                              leapdays=self.leapdays,
+                              year=self.year,
+                              month=self.month,
+                              day=self.day,
+                              weekday=self.weekday,
+                              hour=self.hour,
+                              minute=self.minute,
+                              second=self.second,
+                              microsecond=self.microsecond)
+
+    def __neg__(self):
+        return self.__class__(years=-self.years,
+                             months=-self.months,
+                             days=-self.days,
+                             hours=-self.hours,
+                             minutes=-self.minutes,
+                             seconds=-self.seconds,
+                             microseconds=-self.microseconds,
+                             leapdays=self.leapdays,
+                             year=self.year,
+                             month=self.month,
+                             day=self.day,
+                             weekday=self.weekday,
+                             hour=self.hour,
+                             minute=self.minute,
+                             second=self.second,
+                             microsecond=self.microsecond)
+
+    def __bool__(self):
+        return not (not self.years and
+                    not self.months and
+                    not self.days and
+                    not self.hours and
+                    not self.minutes and
+                    not self.seconds and
+                    not self.microseconds and
+                    not self.leapdays and
+                    self.year is None and
+                    self.month is None and
+                    self.day is None and
+                    self.weekday is None and
+                    self.hour is None and
+                    self.minute is None and
+                    self.second is None and
+                    self.microsecond is None)
+    # Compatibility with Python 2.x
+    __nonzero__ = __bool__
+
+    def __mul__(self, other):
+        try:
+            f = float(other)
+        except TypeError:
+            return NotImplemented
+
+        return self.__class__(years=int(self.years * f),
+                             months=int(self.months * f),
+                             days=int(self.days * f),
+                             hours=int(self.hours * f),
+                             minutes=int(self.minutes * f),
+                             seconds=int(self.seconds * f),
+                             microseconds=int(self.microseconds * f),
+                             leapdays=self.leapdays,
+                             year=self.year,
+                             month=self.month,
+                             day=self.day,
+                             weekday=self.weekday,
+                             hour=self.hour,
+                             minute=self.minute,
+                             second=self.second,
+                             microsecond=self.microsecond)
+
+    __rmul__ = __mul__
+
+    def __eq__(self, other):
+        if not isinstance(other, relativedelta):
+            return NotImplemented
+        if self.weekday or other.weekday:
+            if not self.weekday or not other.weekday:
+                return False
+            if self.weekday.weekday != other.weekday.weekday:
+                return False
+            n1, n2 = self.weekday.n, other.weekday.n
+            if n1 != n2 and not ((not n1 or n1 == 1) and (not n2 or n2 == 1)):
+                return False
+        return (self.years == other.years and
+                self.months == other.months and
+                self.days == other.days and
+                self.hours == other.hours and
+                self.minutes == other.minutes and
+                self.seconds == other.seconds and
+                self.microseconds == other.microseconds and
+                self.leapdays == other.leapdays and
+                self.year == other.year and
+                self.month == other.month and
+                self.day == other.day and
+                self.hour == other.hour and
+                self.minute == other.minute and
+                self.second == other.second and
+                self.microsecond == other.microsecond)
+
+    def __hash__(self):
+        return hash((
+            self.weekday,
+            self.years,
+            self.months,
+            self.days,
+            self.hours,
+            self.minutes,
+            self.seconds,
+            self.microseconds,
+            self.leapdays,
+            self.year,
+            self.month,
+            self.day,
+            self.hour,
+            self.minute,
+            self.second,
+            self.microsecond,
+        ))
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __div__(self, other):
+        try:
+            reciprocal = 1 / float(other)
+        except TypeError:
+            return NotImplemented
+
+        return self.__mul__(reciprocal)
+
+    __truediv__ = __div__
+
+    def __repr__(self):
+        l = []
+        for attr in ["years", "months", "days", "leapdays",
+                     "hours", "minutes", "seconds", "microseconds"]:
+            value = getattr(self, attr)
+            if value:
+                l.append("{attr}={value:+g}".format(attr=attr, value=value))
+        for attr in ["year", "month", "day", "weekday",
+                     "hour", "minute", "second", "microsecond"]:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("{attr}={value}".format(attr=attr, value=repr(value)))
+        return "{classname}({attrs})".format(classname=self.__class__.__name__,
+                                             attrs=", ".join(l))
+
+
+def _sign(x):
+    return int(copysign(1, x))
+
+# vim:ts=4:sw=4:et
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/rrule.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/rrule.py
new file mode 100644
index 0000000000000000000000000000000000000000..6bf0ea9c648ba8c7fcca72badadf02b652436707
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/rrule.py
@@ -0,0 +1,1735 @@
+# -*- coding: utf-8 -*-
+"""
+The rrule module offers a small, complete, and very fast, implementation of
+the recurrence rules documented in the
+`iCalendar RFC <https://tools.ietf.org/html/rfc5545>`_,
+including support for caching of results.
+"""
+import itertools
+import datetime
+import calendar
+import re
+import sys
+
+try:
+    from math import gcd
+except ImportError:
+    from fractions import gcd
+
+from six import advance_iterator, integer_types
+from six.moves import _thread, range
+import heapq
+
+from ._common import weekday as weekdaybase
+
+# For warning about deprecation of until and count
+from warnings import warn
+
+__all__ = ["rrule", "rruleset", "rrulestr",
+           "YEARLY", "MONTHLY", "WEEKLY", "DAILY",
+           "HOURLY", "MINUTELY", "SECONDLY",
+           "MO", "TU", "WE", "TH", "FR", "SA", "SU"]
+
+# Every mask is 7 days longer to handle cross-year weekly periods.
+M366MASK = tuple([1]*31+[2]*29+[3]*31+[4]*30+[5]*31+[6]*30 +
+                 [7]*31+[8]*31+[9]*30+[10]*31+[11]*30+[12]*31+[1]*7)
+M365MASK = list(M366MASK)
+M29, M30, M31 = list(range(1, 30)), list(range(1, 31)), list(range(1, 32))
+MDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7])
+MDAY365MASK = list(MDAY366MASK)
+M29, M30, M31 = list(range(-29, 0)), list(range(-30, 0)), list(range(-31, 0))
+NMDAY366MASK = tuple(M31+M29+M31+M30+M31+M30+M31+M31+M30+M31+M30+M31+M31[:7])
+NMDAY365MASK = list(NMDAY366MASK)
+M366RANGE = (0, 31, 60, 91, 121, 152, 182, 213, 244, 274, 305, 335, 366)
+M365RANGE = (0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334, 365)
+WDAYMASK = [0, 1, 2, 3, 4, 5, 6]*55
+del M29, M30, M31, M365MASK[59], MDAY365MASK[59], NMDAY365MASK[31]
+MDAY365MASK = tuple(MDAY365MASK)
+M365MASK = tuple(M365MASK)
+
+FREQNAMES = ['YEARLY', 'MONTHLY', 'WEEKLY', 'DAILY', 'HOURLY', 'MINUTELY', 'SECONDLY']
+
+(YEARLY,
+ MONTHLY,
+ WEEKLY,
+ DAILY,
+ HOURLY,
+ MINUTELY,
+ SECONDLY) = list(range(7))
+
+# Imported on demand.
+easter = None
+parser = None
+
+
+class weekday(weekdaybase):
+    """
+    This version of weekday does not allow n = 0.
+    """
+    def __init__(self, wkday, n=None):
+        if n == 0:
+            raise ValueError("Can't create weekday with n==0")
+
+        super(weekday, self).__init__(wkday, n)
+
+
+MO, TU, WE, TH, FR, SA, SU = weekdays = tuple(weekday(x) for x in range(7))
+
+
+def _invalidates_cache(f):
+    """
+    Decorator for rruleset methods which may invalidate the
+    cached length.
+    """
+    def inner_func(self, *args, **kwargs):
+        rv = f(self, *args, **kwargs)
+        self._invalidate_cache()
+        return rv
+
+    return inner_func
+
+
+class rrulebase(object):
+    def __init__(self, cache=False):
+        if cache:
+            self._cache = []
+            self._cache_lock = _thread.allocate_lock()
+            self._invalidate_cache()
+        else:
+            self._cache = None
+            self._cache_complete = False
+            self._len = None
+
+    def __iter__(self):
+        if self._cache_complete:
+            return iter(self._cache)
+        elif self._cache is None:
+            return self._iter()
+        else:
+            return self._iter_cached()
+
+    def _invalidate_cache(self):
+        if self._cache is not None:
+            self._cache = []
+            self._cache_complete = False
+            self._cache_gen = self._iter()
+
+            if self._cache_lock.locked():
+                self._cache_lock.release()
+
+        self._len = None
+
+    def _iter_cached(self):
+        i = 0
+        gen = self._cache_gen
+        cache = self._cache
+        acquire = self._cache_lock.acquire
+        release = self._cache_lock.release
+        while gen:
+            if i == len(cache):
+                acquire()
+                if self._cache_complete:
+                    break
+                try:
+                    for j in range(10):
+                        cache.append(advance_iterator(gen))
+                except StopIteration:
+                    self._cache_gen = gen = None
+                    self._cache_complete = True
+                    break
+                release()
+            yield cache[i]
+            i += 1
+        while i < self._len:
+            yield cache[i]
+            i += 1
+
+    def __getitem__(self, item):
+        if self._cache_complete:
+            return self._cache[item]
+        elif isinstance(item, slice):
+            if item.step and item.step < 0:
+                return list(iter(self))[item]
+            else:
+                return list(itertools.islice(self,
+                                             item.start or 0,
+                                             item.stop or sys.maxsize,
+                                             item.step or 1))
+        elif item >= 0:
+            gen = iter(self)
+            try:
+                for i in range(item+1):
+                    res = advance_iterator(gen)
+            except StopIteration:
+                raise IndexError
+            return res
+        else:
+            return list(iter(self))[item]
+
+    def __contains__(self, item):
+        if self._cache_complete:
+            return item in self._cache
+        else:
+            for i in self:
+                if i == item:
+                    return True
+                elif i > item:
+                    return False
+        return False
+
+    # __len__() introduces a large performance penalty.
+    def count(self):
+        """ Returns the number of recurrences in this set. It will have go
+            trough the whole recurrence, if this hasn't been done before. """
+        if self._len is None:
+            for x in self:
+                pass
+        return self._len
+
+    def before(self, dt, inc=False):
+        """ Returns the last recurrence before the given datetime instance. The
+            inc keyword defines what happens if dt is an occurrence. With
+            inc=True, if dt itself is an occurrence, it will be returned. """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        last = None
+        if inc:
+            for i in gen:
+                if i > dt:
+                    break
+                last = i
+        else:
+            for i in gen:
+                if i >= dt:
+                    break
+                last = i
+        return last
+
+    def after(self, dt, inc=False):
+        """ Returns the first recurrence after the given datetime instance. The
+            inc keyword defines what happens if dt is an occurrence. With
+            inc=True, if dt itself is an occurrence, it will be returned.  """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        if inc:
+            for i in gen:
+                if i >= dt:
+                    return i
+        else:
+            for i in gen:
+                if i > dt:
+                    return i
+        return None
+
+    def xafter(self, dt, count=None, inc=False):
+        """
+        Generator which yields up to `count` recurrences after the given
+        datetime instance, equivalent to `after`.
+
+        :param dt:
+            The datetime at which to start generating recurrences.
+
+        :param count:
+            The maximum number of recurrences to generate. If `None` (default),
+            dates are generated until the recurrence rule is exhausted.
+
+        :param inc:
+            If `dt` is an instance of the rule and `inc` is `True`, it is
+            included in the output.
+
+        :yields: Yields a sequence of `datetime` objects.
+        """
+
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+
+        # Select the comparison function
+        if inc:
+            comp = lambda dc, dtc: dc >= dtc
+        else:
+            comp = lambda dc, dtc: dc > dtc
+
+        # Generate dates
+        n = 0
+        for d in gen:
+            if comp(d, dt):
+                if count is not None:
+                    n += 1
+                    if n > count:
+                        break
+
+                yield d
+
+    def between(self, after, before, inc=False, count=1):
+        """ Returns all the occurrences of the rrule between after and before.
+        The inc keyword defines what happens if after and/or before are
+        themselves occurrences. With inc=True, they will be included in the
+        list, if they are found in the recurrence set. """
+        if self._cache_complete:
+            gen = self._cache
+        else:
+            gen = self
+        started = False
+        l = []
+        if inc:
+            for i in gen:
+                if i > before:
+                    break
+                elif not started:
+                    if i >= after:
+                        started = True
+                        l.append(i)
+                else:
+                    l.append(i)
+        else:
+            for i in gen:
+                if i >= before:
+                    break
+                elif not started:
+                    if i > after:
+                        started = True
+                        l.append(i)
+                else:
+                    l.append(i)
+        return l
+
+
+class rrule(rrulebase):
+    """
+    That's the base of the rrule operation. It accepts all the keywords
+    defined in the RFC as its constructor parameters (except byday,
+    which was renamed to byweekday) and more. The constructor prototype is::
+
+            rrule(freq)
+
+    Where freq must be one of YEARLY, MONTHLY, WEEKLY, DAILY, HOURLY, MINUTELY,
+    or SECONDLY.
+
+    .. note::
+        Per RFC section 3.3.10, recurrence instances falling on invalid dates
+        and times are ignored rather than coerced:
+
+            Recurrence rules may generate recurrence instances with an invalid
+            date (e.g., February 30) or nonexistent local time (e.g., 1:30 AM
+            on a day where the local time is moved forward by an hour at 1:00
+            AM).  Such recurrence instances MUST be ignored and MUST NOT be
+            counted as part of the recurrence set.
+
+        This can lead to possibly surprising behavior when, for example, the
+        start date occurs at the end of the month:
+
+        >>> from dateutil.rrule import rrule, MONTHLY
+        >>> from datetime import datetime
+        >>> start_date = datetime(2014, 12, 31)
+        >>> list(rrule(freq=MONTHLY, count=4, dtstart=start_date))
+        ... # doctest: +NORMALIZE_WHITESPACE
+        [datetime.datetime(2014, 12, 31, 0, 0),
+         datetime.datetime(2015, 1, 31, 0, 0),
+         datetime.datetime(2015, 3, 31, 0, 0),
+         datetime.datetime(2015, 5, 31, 0, 0)]
+
+    Additionally, it supports the following keyword arguments:
+
+    :param dtstart:
+        The recurrence start. Besides being the base for the recurrence,
+        missing parameters in the final recurrence instances will also be
+        extracted from this date. If not given, datetime.now() will be used
+        instead.
+    :param interval:
+        The interval between each freq iteration. For example, when using
+        YEARLY, an interval of 2 means once every two years, but with HOURLY,
+        it means once every two hours. The default interval is 1.
+    :param wkst:
+        The week start day. Must be one of the MO, TU, WE constants, or an
+        integer, specifying the first day of the week. This will affect
+        recurrences based on weekly periods. The default week start is got
+        from calendar.firstweekday(), and may be modified by
+        calendar.setfirstweekday().
+    :param count:
+        If given, this determines how many occurrences will be generated.
+
+        .. note::
+            As of version 2.5.0, the use of the keyword ``until`` in conjunction
+            with ``count`` is deprecated, to make sure ``dateutil`` is fully
+            compliant with `RFC-5545 Sec. 3.3.10 <https://tools.ietf.org/
+            html/rfc5545#section-3.3.10>`_. Therefore, ``until`` and ``count``
+            **must not** occur in the same call to ``rrule``.
+    :param until:
+        If given, this must be a datetime instance specifying the upper-bound
+        limit of the recurrence. The last recurrence in the rule is the greatest
+        datetime that is less than or equal to the value specified in the
+        ``until`` parameter.
+
+        .. note::
+            As of version 2.5.0, the use of the keyword ``until`` in conjunction
+            with ``count`` is deprecated, to make sure ``dateutil`` is fully
+            compliant with `RFC-5545 Sec. 3.3.10 <https://tools.ietf.org/
+            html/rfc5545#section-3.3.10>`_. Therefore, ``until`` and ``count``
+            **must not** occur in the same call to ``rrule``.
+    :param bysetpos:
+        If given, it must be either an integer, or a sequence of integers,
+        positive or negative. Each given integer will specify an occurrence
+        number, corresponding to the nth occurrence of the rule inside the
+        frequency period. For example, a bysetpos of -1 if combined with a
+        MONTHLY frequency, and a byweekday of (MO, TU, WE, TH, FR), will
+        result in the last work day of every month.
+    :param bymonth:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the months to apply the recurrence to.
+    :param bymonthday:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the month days to apply the recurrence to.
+    :param byyearday:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the year days to apply the recurrence to.
+    :param byeaster:
+        If given, it must be either an integer, or a sequence of integers,
+        positive or negative. Each integer will define an offset from the
+        Easter Sunday. Passing the offset 0 to byeaster will yield the Easter
+        Sunday itself. This is an extension to the RFC specification.
+    :param byweekno:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the week numbers to apply the recurrence to. Week numbers
+        have the meaning described in ISO8601, that is, the first week of
+        the year is that containing at least four days of the new year.
+    :param byweekday:
+        If given, it must be either an integer (0 == MO), a sequence of
+        integers, one of the weekday constants (MO, TU, etc), or a sequence
+        of these constants. When given, these variables will define the
+        weekdays where the recurrence will be applied. It's also possible to
+        use an argument n for the weekday instances, which will mean the nth
+        occurrence of this weekday in the period. For example, with MONTHLY,
+        or with YEARLY and BYMONTH, using FR(+1) in byweekday will specify the
+        first friday of the month where the recurrence happens. Notice that in
+        the RFC documentation, this is specified as BYDAY, but was renamed to
+        avoid the ambiguity of that keyword.
+    :param byhour:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the hours to apply the recurrence to.
+    :param byminute:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the minutes to apply the recurrence to.
+    :param bysecond:
+        If given, it must be either an integer, or a sequence of integers,
+        meaning the seconds to apply the recurrence to.
+    :param cache:
+        If given, it must be a boolean value specifying to enable or disable
+        caching of results. If you will use the same rrule instance multiple
+        times, enabling caching will improve the performance considerably.
+     """
+    def __init__(self, freq, dtstart=None,
+                 interval=1, wkst=None, count=None, until=None, bysetpos=None,
+                 bymonth=None, bymonthday=None, byyearday=None, byeaster=None,
+                 byweekno=None, byweekday=None,
+                 byhour=None, byminute=None, bysecond=None,
+                 cache=False):
+        super(rrule, self).__init__(cache)
+        global easter
+        if not dtstart:
+            if until and until.tzinfo:
+                dtstart = datetime.datetime.now(tz=until.tzinfo).replace(microsecond=0)
+            else:
+                dtstart = datetime.datetime.now().replace(microsecond=0)
+        elif not isinstance(dtstart, datetime.datetime):
+            dtstart = datetime.datetime.fromordinal(dtstart.toordinal())
+        else:
+            dtstart = dtstart.replace(microsecond=0)
+        self._dtstart = dtstart
+        self._tzinfo = dtstart.tzinfo
+        self._freq = freq
+        self._interval = interval
+        self._count = count
+
+        # Cache the original byxxx rules, if they are provided, as the _byxxx
+        # attributes do not necessarily map to the inputs, and this can be
+        # a problem in generating the strings. Only store things if they've
+        # been supplied (the string retrieval will just use .get())
+        self._original_rule = {}
+
+        if until and not isinstance(until, datetime.datetime):
+            until = datetime.datetime.fromordinal(until.toordinal())
+        self._until = until
+
+        if self._dtstart and self._until:
+            if (self._dtstart.tzinfo is not None) != (self._until.tzinfo is not None):
+                # According to RFC5545 Section 3.3.10:
+                # https://tools.ietf.org/html/rfc5545#section-3.3.10
+                #
+                # > If the "DTSTART" property is specified as a date with UTC
+                # > time or a date with local time and time zone reference,
+                # > then the UNTIL rule part MUST be specified as a date with
+                # > UTC time.
+                raise ValueError(
+                    'RRULE UNTIL values must be specified in UTC when DTSTART '
+                    'is timezone-aware'
+                )
+
+        if count is not None and until:
+            warn("Using both 'count' and 'until' is inconsistent with RFC 5545"
+                 " and has been deprecated in dateutil. Future versions will "
+                 "raise an error.", DeprecationWarning)
+
+        if wkst is None:
+            self._wkst = calendar.firstweekday()
+        elif isinstance(wkst, integer_types):
+            self._wkst = wkst
+        else:
+            self._wkst = wkst.weekday
+
+        if bysetpos is None:
+            self._bysetpos = None
+        elif isinstance(bysetpos, integer_types):
+            if bysetpos == 0 or not (-366 <= bysetpos <= 366):
+                raise ValueError("bysetpos must be between 1 and 366, "
+                                 "or between -366 and -1")
+            self._bysetpos = (bysetpos,)
+        else:
+            self._bysetpos = tuple(bysetpos)
+            for pos in self._bysetpos:
+                if pos == 0 or not (-366 <= pos <= 366):
+                    raise ValueError("bysetpos must be between 1 and 366, "
+                                     "or between -366 and -1")
+
+        if self._bysetpos:
+            self._original_rule['bysetpos'] = self._bysetpos
+
+        if (byweekno is None and byyearday is None and bymonthday is None and
+                byweekday is None and byeaster is None):
+            if freq == YEARLY:
+                if bymonth is None:
+                    bymonth = dtstart.month
+                    self._original_rule['bymonth'] = None
+                bymonthday = dtstart.day
+                self._original_rule['bymonthday'] = None
+            elif freq == MONTHLY:
+                bymonthday = dtstart.day
+                self._original_rule['bymonthday'] = None
+            elif freq == WEEKLY:
+                byweekday = dtstart.weekday()
+                self._original_rule['byweekday'] = None
+
+        # bymonth
+        if bymonth is None:
+            self._bymonth = None
+        else:
+            if isinstance(bymonth, integer_types):
+                bymonth = (bymonth,)
+
+            self._bymonth = tuple(sorted(set(bymonth)))
+
+            if 'bymonth' not in self._original_rule:
+                self._original_rule['bymonth'] = self._bymonth
+
+        # byyearday
+        if byyearday is None:
+            self._byyearday = None
+        else:
+            if isinstance(byyearday, integer_types):
+                byyearday = (byyearday,)
+
+            self._byyearday = tuple(sorted(set(byyearday)))
+            self._original_rule['byyearday'] = self._byyearday
+
+        # byeaster
+        if byeaster is not None:
+            if not easter:
+                from dateutil import easter
+            if isinstance(byeaster, integer_types):
+                self._byeaster = (byeaster,)
+            else:
+                self._byeaster = tuple(sorted(byeaster))
+
+            self._original_rule['byeaster'] = self._byeaster
+        else:
+            self._byeaster = None
+
+        # bymonthday
+        if bymonthday is None:
+            self._bymonthday = ()
+            self._bynmonthday = ()
+        else:
+            if isinstance(bymonthday, integer_types):
+                bymonthday = (bymonthday,)
+
+            bymonthday = set(bymonthday)            # Ensure it's unique
+
+            self._bymonthday = tuple(sorted(x for x in bymonthday if x > 0))
+            self._bynmonthday = tuple(sorted(x for x in bymonthday if x < 0))
+
+            # Storing positive numbers first, then negative numbers
+            if 'bymonthday' not in self._original_rule:
+                self._original_rule['bymonthday'] = tuple(
+                    itertools.chain(self._bymonthday, self._bynmonthday))
+
+        # byweekno
+        if byweekno is None:
+            self._byweekno = None
+        else:
+            if isinstance(byweekno, integer_types):
+                byweekno = (byweekno,)
+
+            self._byweekno = tuple(sorted(set(byweekno)))
+
+            self._original_rule['byweekno'] = self._byweekno
+
+        # byweekday / bynweekday
+        if byweekday is None:
+            self._byweekday = None
+            self._bynweekday = None
+        else:
+            # If it's one of the valid non-sequence types, convert to a
+            # single-element sequence before the iterator that builds the
+            # byweekday set.
+            if isinstance(byweekday, integer_types) or hasattr(byweekday, "n"):
+                byweekday = (byweekday,)
+
+            self._byweekday = set()
+            self._bynweekday = set()
+            for wday in byweekday:
+                if isinstance(wday, integer_types):
+                    self._byweekday.add(wday)
+                elif not wday.n or freq > MONTHLY:
+                    self._byweekday.add(wday.weekday)
+                else:
+                    self._bynweekday.add((wday.weekday, wday.n))
+
+            if not self._byweekday:
+                self._byweekday = None
+            elif not self._bynweekday:
+                self._bynweekday = None
+
+            if self._byweekday is not None:
+                self._byweekday = tuple(sorted(self._byweekday))
+                orig_byweekday = [weekday(x) for x in self._byweekday]
+            else:
+                orig_byweekday = ()
+
+            if self._bynweekday is not None:
+                self._bynweekday = tuple(sorted(self._bynweekday))
+                orig_bynweekday = [weekday(*x) for x in self._bynweekday]
+            else:
+                orig_bynweekday = ()
+
+            if 'byweekday' not in self._original_rule:
+                self._original_rule['byweekday'] = tuple(itertools.chain(
+                    orig_byweekday, orig_bynweekday))
+
+        # byhour
+        if byhour is None:
+            if freq < HOURLY:
+                self._byhour = {dtstart.hour}
+            else:
+                self._byhour = None
+        else:
+            if isinstance(byhour, integer_types):
+                byhour = (byhour,)
+
+            if freq == HOURLY:
+                self._byhour = self.__construct_byset(start=dtstart.hour,
+                                                      byxxx=byhour,
+                                                      base=24)
+            else:
+                self._byhour = set(byhour)
+
+            self._byhour = tuple(sorted(self._byhour))
+            self._original_rule['byhour'] = self._byhour
+
+        # byminute
+        if byminute is None:
+            if freq < MINUTELY:
+                self._byminute = {dtstart.minute}
+            else:
+                self._byminute = None
+        else:
+            if isinstance(byminute, integer_types):
+                byminute = (byminute,)
+
+            if freq == MINUTELY:
+                self._byminute = self.__construct_byset(start=dtstart.minute,
+                                                        byxxx=byminute,
+                                                        base=60)
+            else:
+                self._byminute = set(byminute)
+
+            self._byminute = tuple(sorted(self._byminute))
+            self._original_rule['byminute'] = self._byminute
+
+        # bysecond
+        if bysecond is None:
+            if freq < SECONDLY:
+                self._bysecond = ((dtstart.second,))
+            else:
+                self._bysecond = None
+        else:
+            if isinstance(bysecond, integer_types):
+                bysecond = (bysecond,)
+
+            self._bysecond = set(bysecond)
+
+            if freq == SECONDLY:
+                self._bysecond = self.__construct_byset(start=dtstart.second,
+                                                        byxxx=bysecond,
+                                                        base=60)
+            else:
+                self._bysecond = set(bysecond)
+
+            self._bysecond = tuple(sorted(self._bysecond))
+            self._original_rule['bysecond'] = self._bysecond
+
+        if self._freq >= HOURLY:
+            self._timeset = None
+        else:
+            self._timeset = []
+            for hour in self._byhour:
+                for minute in self._byminute:
+                    for second in self._bysecond:
+                        self._timeset.append(
+                            datetime.time(hour, minute, second,
+                                          tzinfo=self._tzinfo))
+            self._timeset.sort()
+            self._timeset = tuple(self._timeset)
+
+    def __str__(self):
+        """
+        Output a string that would generate this RRULE if passed to rrulestr.
+        This is mostly compatible with RFC5545, except for the
+        dateutil-specific extension BYEASTER.
+        """
+
+        output = []
+        h, m, s = [None] * 3
+        if self._dtstart:
+            output.append(self._dtstart.strftime('DTSTART:%Y%m%dT%H%M%S'))
+            h, m, s = self._dtstart.timetuple()[3:6]
+
+        parts = ['FREQ=' + FREQNAMES[self._freq]]
+        if self._interval != 1:
+            parts.append('INTERVAL=' + str(self._interval))
+
+        if self._wkst:
+            parts.append('WKST=' + repr(weekday(self._wkst))[0:2])
+
+        if self._count is not None:
+            parts.append('COUNT=' + str(self._count))
+
+        if self._until:
+            parts.append(self._until.strftime('UNTIL=%Y%m%dT%H%M%S'))
+
+        if self._original_rule.get('byweekday') is not None:
+            # The str() method on weekday objects doesn't generate
+            # RFC5545-compliant strings, so we should modify that.
+            original_rule = dict(self._original_rule)
+            wday_strings = []
+            for wday in original_rule['byweekday']:
+                if wday.n:
+                    wday_strings.append('{n:+d}{wday}'.format(
+                        n=wday.n,
+                        wday=repr(wday)[0:2]))
+                else:
+                    wday_strings.append(repr(wday))
+
+            original_rule['byweekday'] = wday_strings
+        else:
+            original_rule = self._original_rule
+
+        partfmt = '{name}={vals}'
+        for name, key in [('BYSETPOS', 'bysetpos'),
+                          ('BYMONTH', 'bymonth'),
+                          ('BYMONTHDAY', 'bymonthday'),
+                          ('BYYEARDAY', 'byyearday'),
+                          ('BYWEEKNO', 'byweekno'),
+                          ('BYDAY', 'byweekday'),
+                          ('BYHOUR', 'byhour'),
+                          ('BYMINUTE', 'byminute'),
+                          ('BYSECOND', 'bysecond'),
+                          ('BYEASTER', 'byeaster')]:
+            value = original_rule.get(key)
+            if value:
+                parts.append(partfmt.format(name=name, vals=(','.join(str(v)
+                                                             for v in value))))
+
+        output.append('RRULE:' + ';'.join(parts))
+        return '\n'.join(output)
+
+    def replace(self, **kwargs):
+        """Return new rrule with same attributes except for those attributes given new
+           values by whichever keyword arguments are specified."""
+        new_kwargs = {"interval": self._interval,
+                      "count": self._count,
+                      "dtstart": self._dtstart,
+                      "freq": self._freq,
+                      "until": self._until,
+                      "wkst": self._wkst,
+                      "cache": False if self._cache is None else True }
+        new_kwargs.update(self._original_rule)
+        new_kwargs.update(kwargs)
+        return rrule(**new_kwargs)
+
+    def _iter(self):
+        year, month, day, hour, minute, second, weekday, yearday, _ = \
+            self._dtstart.timetuple()
+
+        # Some local variables to speed things up a bit
+        freq = self._freq
+        interval = self._interval
+        wkst = self._wkst
+        until = self._until
+        bymonth = self._bymonth
+        byweekno = self._byweekno
+        byyearday = self._byyearday
+        byweekday = self._byweekday
+        byeaster = self._byeaster
+        bymonthday = self._bymonthday
+        bynmonthday = self._bynmonthday
+        bysetpos = self._bysetpos
+        byhour = self._byhour
+        byminute = self._byminute
+        bysecond = self._bysecond
+
+        ii = _iterinfo(self)
+        ii.rebuild(year, month)
+
+        getdayset = {YEARLY: ii.ydayset,
+                     MONTHLY: ii.mdayset,
+                     WEEKLY: ii.wdayset,
+                     DAILY: ii.ddayset,
+                     HOURLY: ii.ddayset,
+                     MINUTELY: ii.ddayset,
+                     SECONDLY: ii.ddayset}[freq]
+
+        if freq < HOURLY:
+            timeset = self._timeset
+        else:
+            gettimeset = {HOURLY: ii.htimeset,
+                          MINUTELY: ii.mtimeset,
+                          SECONDLY: ii.stimeset}[freq]
+            if ((freq >= HOURLY and
+                 self._byhour and hour not in self._byhour) or
+                (freq >= MINUTELY and
+                 self._byminute and minute not in self._byminute) or
+                (freq >= SECONDLY and
+                 self._bysecond and second not in self._bysecond)):
+                timeset = ()
+            else:
+                timeset = gettimeset(hour, minute, second)
+
+        total = 0
+        count = self._count
+        while True:
+            # Get dayset with the right frequency
+            dayset, start, end = getdayset(year, month, day)
+
+            # Do the "hard" work ;-)
+            filtered = False
+            for i in dayset[start:end]:
+                if ((bymonth and ii.mmask[i] not in bymonth) or
+                    (byweekno and not ii.wnomask[i]) or
+                    (byweekday and ii.wdaymask[i] not in byweekday) or
+                    (ii.nwdaymask and not ii.nwdaymask[i]) or
+                    (byeaster and not ii.eastermask[i]) or
+                    ((bymonthday or bynmonthday) and
+                     ii.mdaymask[i] not in bymonthday and
+                     ii.nmdaymask[i] not in bynmonthday) or
+                    (byyearday and
+                     ((i < ii.yearlen and i+1 not in byyearday and
+                       -ii.yearlen+i not in byyearday) or
+                      (i >= ii.yearlen and i+1-ii.yearlen not in byyearday and
+                       -ii.nextyearlen+i-ii.yearlen not in byyearday)))):
+                    dayset[i] = None
+                    filtered = True
+
+            # Output results
+            if bysetpos and timeset:
+                poslist = []
+                for pos in bysetpos:
+                    if pos < 0:
+                        daypos, timepos = divmod(pos, len(timeset))
+                    else:
+                        daypos, timepos = divmod(pos-1, len(timeset))
+                    try:
+                        i = [x for x in dayset[start:end]
+                             if x is not None][daypos]
+                        time = timeset[timepos]
+                    except IndexError:
+                        pass
+                    else:
+                        date = datetime.date.fromordinal(ii.yearordinal+i)
+                        res = datetime.datetime.combine(date, time)
+                        if res not in poslist:
+                            poslist.append(res)
+                poslist.sort()
+                for res in poslist:
+                    if until and res > until:
+                        self._len = total
+                        return
+                    elif res >= self._dtstart:
+                        if count is not None:
+                            count -= 1
+                            if count < 0:
+                                self._len = total
+                                return
+                        total += 1
+                        yield res
+            else:
+                for i in dayset[start:end]:
+                    if i is not None:
+                        date = datetime.date.fromordinal(ii.yearordinal + i)
+                        for time in timeset:
+                            res = datetime.datetime.combine(date, time)
+                            if until and res > until:
+                                self._len = total
+                                return
+                            elif res >= self._dtstart:
+                                if count is not None:
+                                    count -= 1
+                                    if count < 0:
+                                        self._len = total
+                                        return
+
+                                total += 1
+                                yield res
+
+            # Handle frequency and interval
+            fixday = False
+            if freq == YEARLY:
+                year += interval
+                if year > datetime.MAXYEAR:
+                    self._len = total
+                    return
+                ii.rebuild(year, month)
+            elif freq == MONTHLY:
+                month += interval
+                if month > 12:
+                    div, mod = divmod(month, 12)
+                    month = mod
+                    year += div
+                    if month == 0:
+                        month = 12
+                        year -= 1
+                    if year > datetime.MAXYEAR:
+                        self._len = total
+                        return
+                ii.rebuild(year, month)
+            elif freq == WEEKLY:
+                if wkst > weekday:
+                    day += -(weekday+1+(6-wkst))+self._interval*7
+                else:
+                    day += -(weekday-wkst)+self._interval*7
+                weekday = wkst
+                fixday = True
+            elif freq == DAILY:
+                day += interval
+                fixday = True
+            elif freq == HOURLY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    hour += ((23-hour)//interval)*interval
+
+                if byhour:
+                    ndays, hour = self.__mod_distance(value=hour,
+                                                      byxxx=self._byhour,
+                                                      base=24)
+                else:
+                    ndays, hour = divmod(hour+interval, 24)
+
+                if ndays:
+                    day += ndays
+                    fixday = True
+
+                timeset = gettimeset(hour, minute, second)
+            elif freq == MINUTELY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    minute += ((1439-(hour*60+minute))//interval)*interval
+
+                valid = False
+                rep_rate = (24*60)
+                for j in range(rep_rate // gcd(interval, rep_rate)):
+                    if byminute:
+                        nhours, minute = \
+                            self.__mod_distance(value=minute,
+                                                byxxx=self._byminute,
+                                                base=60)
+                    else:
+                        nhours, minute = divmod(minute+interval, 60)
+
+                    div, hour = divmod(hour+nhours, 24)
+                    if div:
+                        day += div
+                        fixday = True
+                        filtered = False
+
+                    if not byhour or hour in byhour:
+                        valid = True
+                        break
+
+                if not valid:
+                    raise ValueError('Invalid combination of interval and ' +
+                                     'byhour resulting in empty rule.')
+
+                timeset = gettimeset(hour, minute, second)
+            elif freq == SECONDLY:
+                if filtered:
+                    # Jump to one iteration before next day
+                    second += (((86399 - (hour * 3600 + minute * 60 + second))
+                                // interval) * interval)
+
+                rep_rate = (24 * 3600)
+                valid = False
+                for j in range(0, rep_rate // gcd(interval, rep_rate)):
+                    if bysecond:
+                        nminutes, second = \
+                            self.__mod_distance(value=second,
+                                                byxxx=self._bysecond,
+                                                base=60)
+                    else:
+                        nminutes, second = divmod(second+interval, 60)
+
+                    div, minute = divmod(minute+nminutes, 60)
+                    if div:
+                        hour += div
+                        div, hour = divmod(hour, 24)
+                        if div:
+                            day += div
+                            fixday = True
+
+                    if ((not byhour or hour in byhour) and
+                            (not byminute or minute in byminute) and
+                            (not bysecond or second in bysecond)):
+                        valid = True
+                        break
+
+                if not valid:
+                    raise ValueError('Invalid combination of interval, ' +
+                                     'byhour and byminute resulting in empty' +
+                                     ' rule.')
+
+                timeset = gettimeset(hour, minute, second)
+
+            if fixday and day > 28:
+                daysinmonth = calendar.monthrange(year, month)[1]
+                if day > daysinmonth:
+                    while day > daysinmonth:
+                        day -= daysinmonth
+                        month += 1
+                        if month == 13:
+                            month = 1
+                            year += 1
+                            if year > datetime.MAXYEAR:
+                                self._len = total
+                                return
+                        daysinmonth = calendar.monthrange(year, month)[1]
+                    ii.rebuild(year, month)
+
+    def __construct_byset(self, start, byxxx, base):
+        """
+        If a `BYXXX` sequence is passed to the constructor at the same level as
+        `FREQ` (e.g. `FREQ=HOURLY,BYHOUR={2,4,7},INTERVAL=3`), there are some
+        specifications which cannot be reached given some starting conditions.
+
+        This occurs whenever the interval is not coprime with the base of a
+        given unit and the difference between the starting position and the
+        ending position is not coprime with the greatest common denominator
+        between the interval and the base. For example, with a FREQ of hourly
+        starting at 17:00 and an interval of 4, the only valid values for
+        BYHOUR would be {21, 1, 5, 9, 13, 17}, because 4 and 24 are not
+        coprime.
+
+        :param start:
+            Specifies the starting position.
+        :param byxxx:
+            An iterable containing the list of allowed values.
+        :param base:
+            The largest allowable value for the specified frequency (e.g.
+            24 hours, 60 minutes).
+
+        This does not preserve the type of the iterable, returning a set, since
+        the values should be unique and the order is irrelevant, this will
+        speed up later lookups.
+
+        In the event of an empty set, raises a :exception:`ValueError`, as this
+        results in an empty rrule.
+        """
+
+        cset = set()
+
+        # Support a single byxxx value.
+        if isinstance(byxxx, integer_types):
+            byxxx = (byxxx, )
+
+        for num in byxxx:
+            i_gcd = gcd(self._interval, base)
+            # Use divmod rather than % because we need to wrap negative nums.
+            if i_gcd == 1 or divmod(num - start, i_gcd)[1] == 0:
+                cset.add(num)
+
+        if len(cset) == 0:
+            raise ValueError("Invalid rrule byxxx generates an empty set.")
+
+        return cset
+
+    def __mod_distance(self, value, byxxx, base):
+        """
+        Calculates the next value in a sequence where the `FREQ` parameter is
+        specified along with a `BYXXX` parameter at the same "level"
+        (e.g. `HOURLY` specified with `BYHOUR`).
+
+        :param value:
+            The old value of the component.
+        :param byxxx:
+            The `BYXXX` set, which should have been generated by
+            `rrule._construct_byset`, or something else which checks that a
+            valid rule is present.
+        :param base:
+            The largest allowable value for the specified frequency (e.g.
+            24 hours, 60 minutes).
+
+        If a valid value is not found after `base` iterations (the maximum
+        number before the sequence would start to repeat), this raises a
+        :exception:`ValueError`, as no valid values were found.
+
+        This returns a tuple of `divmod(n*interval, base)`, where `n` is the
+        smallest number of `interval` repetitions until the next specified
+        value in `byxxx` is found.
+        """
+        accumulator = 0
+        for ii in range(1, base + 1):
+            # Using divmod() over % to account for negative intervals
+            div, value = divmod(value + self._interval, base)
+            accumulator += div
+            if value in byxxx:
+                return (accumulator, value)
+
+
+class _iterinfo(object):
+    __slots__ = ["rrule", "lastyear", "lastmonth",
+                 "yearlen", "nextyearlen", "yearordinal", "yearweekday",
+                 "mmask", "mrange", "mdaymask", "nmdaymask",
+                 "wdaymask", "wnomask", "nwdaymask", "eastermask"]
+
+    def __init__(self, rrule):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+        self.rrule = rrule
+
+    def rebuild(self, year, month):
+        # Every mask is 7 days longer to handle cross-year weekly periods.
+        rr = self.rrule
+        if year != self.lastyear:
+            self.yearlen = 365 + calendar.isleap(year)
+            self.nextyearlen = 365 + calendar.isleap(year + 1)
+            firstyday = datetime.date(year, 1, 1)
+            self.yearordinal = firstyday.toordinal()
+            self.yearweekday = firstyday.weekday()
+
+            wday = datetime.date(year, 1, 1).weekday()
+            if self.yearlen == 365:
+                self.mmask = M365MASK
+                self.mdaymask = MDAY365MASK
+                self.nmdaymask = NMDAY365MASK
+                self.wdaymask = WDAYMASK[wday:]
+                self.mrange = M365RANGE
+            else:
+                self.mmask = M366MASK
+                self.mdaymask = MDAY366MASK
+                self.nmdaymask = NMDAY366MASK
+                self.wdaymask = WDAYMASK[wday:]
+                self.mrange = M366RANGE
+
+            if not rr._byweekno:
+                self.wnomask = None
+            else:
+                self.wnomask = [0]*(self.yearlen+7)
+                # no1wkst = firstwkst = self.wdaymask.index(rr._wkst)
+                no1wkst = firstwkst = (7-self.yearweekday+rr._wkst) % 7
+                if no1wkst >= 4:
+                    no1wkst = 0
+                    # Number of days in the year, plus the days we got
+                    # from last year.
+                    wyearlen = self.yearlen+(self.yearweekday-rr._wkst) % 7
+                else:
+                    # Number of days in the year, minus the days we
+                    # left in last year.
+                    wyearlen = self.yearlen-no1wkst
+                div, mod = divmod(wyearlen, 7)
+                numweeks = div+mod//4
+                for n in rr._byweekno:
+                    if n < 0:
+                        n += numweeks+1
+                    if not (0 < n <= numweeks):
+                        continue
+                    if n > 1:
+                        i = no1wkst+(n-1)*7
+                        if no1wkst != firstwkst:
+                            i -= 7-firstwkst
+                    else:
+                        i = no1wkst
+                    for j in range(7):
+                        self.wnomask[i] = 1
+                        i += 1
+                        if self.wdaymask[i] == rr._wkst:
+                            break
+                if 1 in rr._byweekno:
+                    # Check week number 1 of next year as well
+                    # TODO: Check -numweeks for next year.
+                    i = no1wkst+numweeks*7
+                    if no1wkst != firstwkst:
+                        i -= 7-firstwkst
+                    if i < self.yearlen:
+                        # If week starts in next year, we
+                        # don't care about it.
+                        for j in range(7):
+                            self.wnomask[i] = 1
+                            i += 1
+                            if self.wdaymask[i] == rr._wkst:
+                                break
+                if no1wkst:
+                    # Check last week number of last year as
+                    # well. If no1wkst is 0, either the year
+                    # started on week start, or week number 1
+                    # got days from last year, so there are no
+                    # days from last year's last week number in
+                    # this year.
+                    if -1 not in rr._byweekno:
+                        lyearweekday = datetime.date(year-1, 1, 1).weekday()
+                        lno1wkst = (7-lyearweekday+rr._wkst) % 7
+                        lyearlen = 365+calendar.isleap(year-1)
+                        if lno1wkst >= 4:
+                            lno1wkst = 0
+                            lnumweeks = 52+(lyearlen +
+                                            (lyearweekday-rr._wkst) % 7) % 7//4
+                        else:
+                            lnumweeks = 52+(self.yearlen-no1wkst) % 7//4
+                    else:
+                        lnumweeks = -1
+                    if lnumweeks in rr._byweekno:
+                        for i in range(no1wkst):
+                            self.wnomask[i] = 1
+
+        if (rr._bynweekday and (month != self.lastmonth or
+                                year != self.lastyear)):
+            ranges = []
+            if rr._freq == YEARLY:
+                if rr._bymonth:
+                    for month in rr._bymonth:
+                        ranges.append(self.mrange[month-1:month+1])
+                else:
+                    ranges = [(0, self.yearlen)]
+            elif rr._freq == MONTHLY:
+                ranges = [self.mrange[month-1:month+1]]
+            if ranges:
+                # Weekly frequency won't get here, so we may not
+                # care about cross-year weekly periods.
+                self.nwdaymask = [0]*self.yearlen
+                for first, last in ranges:
+                    last -= 1
+                    for wday, n in rr._bynweekday:
+                        if n < 0:
+                            i = last+(n+1)*7
+                            i -= (self.wdaymask[i]-wday) % 7
+                        else:
+                            i = first+(n-1)*7
+                            i += (7-self.wdaymask[i]+wday) % 7
+                        if first <= i <= last:
+                            self.nwdaymask[i] = 1
+
+        if rr._byeaster:
+            self.eastermask = [0]*(self.yearlen+7)
+            eyday = easter.easter(year).toordinal()-self.yearordinal
+            for offset in rr._byeaster:
+                self.eastermask[eyday+offset] = 1
+
+        self.lastyear = year
+        self.lastmonth = month
+
+    def ydayset(self, year, month, day):
+        return list(range(self.yearlen)), 0, self.yearlen
+
+    def mdayset(self, year, month, day):
+        dset = [None]*self.yearlen
+        start, end = self.mrange[month-1:month+1]
+        for i in range(start, end):
+            dset[i] = i
+        return dset, start, end
+
+    def wdayset(self, year, month, day):
+        # We need to handle cross-year weeks here.
+        dset = [None]*(self.yearlen+7)
+        i = datetime.date(year, month, day).toordinal()-self.yearordinal
+        start = i
+        for j in range(7):
+            dset[i] = i
+            i += 1
+            # if (not (0 <= i < self.yearlen) or
+            #    self.wdaymask[i] == self.rrule._wkst):
+            # This will cross the year boundary, if necessary.
+            if self.wdaymask[i] == self.rrule._wkst:
+                break
+        return dset, start, i
+
+    def ddayset(self, year, month, day):
+        dset = [None] * self.yearlen
+        i = datetime.date(year, month, day).toordinal() - self.yearordinal
+        dset[i] = i
+        return dset, i, i + 1
+
+    def htimeset(self, hour, minute, second):
+        tset = []
+        rr = self.rrule
+        for minute in rr._byminute:
+            for second in rr._bysecond:
+                tset.append(datetime.time(hour, minute, second,
+                                          tzinfo=rr._tzinfo))
+        tset.sort()
+        return tset
+
+    def mtimeset(self, hour, minute, second):
+        tset = []
+        rr = self.rrule
+        for second in rr._bysecond:
+            tset.append(datetime.time(hour, minute, second, tzinfo=rr._tzinfo))
+        tset.sort()
+        return tset
+
+    def stimeset(self, hour, minute, second):
+        return (datetime.time(hour, minute, second,
+                tzinfo=self.rrule._tzinfo),)
+
+
+class rruleset(rrulebase):
+    """ The rruleset type allows more complex recurrence setups, mixing
+    multiple rules, dates, exclusion rules, and exclusion dates. The type
+    constructor takes the following keyword arguments:
+
+    :param cache: If True, caching of results will be enabled, improving
+                  performance of multiple queries considerably. """
+
+    class _genitem(object):
+        def __init__(self, genlist, gen):
+            try:
+                self.dt = advance_iterator(gen)
+                genlist.append(self)
+            except StopIteration:
+                pass
+            self.genlist = genlist
+            self.gen = gen
+
+        def __next__(self):
+            try:
+                self.dt = advance_iterator(self.gen)
+            except StopIteration:
+                if self.genlist[0] is self:
+                    heapq.heappop(self.genlist)
+                else:
+                    self.genlist.remove(self)
+                    heapq.heapify(self.genlist)
+
+        next = __next__
+
+        def __lt__(self, other):
+            return self.dt < other.dt
+
+        def __gt__(self, other):
+            return self.dt > other.dt
+
+        def __eq__(self, other):
+            return self.dt == other.dt
+
+        def __ne__(self, other):
+            return self.dt != other.dt
+
+    def __init__(self, cache=False):
+        super(rruleset, self).__init__(cache)
+        self._rrule = []
+        self._rdate = []
+        self._exrule = []
+        self._exdate = []
+
+    @_invalidates_cache
+    def rrule(self, rrule):
+        """ Include the given :py:class:`rrule` instance in the recurrence set
+            generation. """
+        self._rrule.append(rrule)
+
+    @_invalidates_cache
+    def rdate(self, rdate):
+        """ Include the given :py:class:`datetime` instance in the recurrence
+            set generation. """
+        self._rdate.append(rdate)
+
+    @_invalidates_cache
+    def exrule(self, exrule):
+        """ Include the given rrule instance in the recurrence set exclusion
+            list. Dates which are part of the given recurrence rules will not
+            be generated, even if some inclusive rrule or rdate matches them.
+        """
+        self._exrule.append(exrule)
+
+    @_invalidates_cache
+    def exdate(self, exdate):
+        """ Include the given datetime instance in the recurrence set
+            exclusion list. Dates included that way will not be generated,
+            even if some inclusive rrule or rdate matches them. """
+        self._exdate.append(exdate)
+
+    def _iter(self):
+        rlist = []
+        self._rdate.sort()
+        self._genitem(rlist, iter(self._rdate))
+        for gen in [iter(x) for x in self._rrule]:
+            self._genitem(rlist, gen)
+        exlist = []
+        self._exdate.sort()
+        self._genitem(exlist, iter(self._exdate))
+        for gen in [iter(x) for x in self._exrule]:
+            self._genitem(exlist, gen)
+        lastdt = None
+        total = 0
+        heapq.heapify(rlist)
+        heapq.heapify(exlist)
+        while rlist:
+            ritem = rlist[0]
+            if not lastdt or lastdt != ritem.dt:
+                while exlist and exlist[0] < ritem:
+                    exitem = exlist[0]
+                    advance_iterator(exitem)
+                    if exlist and exlist[0] is exitem:
+                        heapq.heapreplace(exlist, exitem)
+                if not exlist or ritem != exlist[0]:
+                    total += 1
+                    yield ritem.dt
+                lastdt = ritem.dt
+            advance_iterator(ritem)
+            if rlist and rlist[0] is ritem:
+                heapq.heapreplace(rlist, ritem)
+        self._len = total
+
+
+
+
+class _rrulestr(object):
+    """ Parses a string representation of a recurrence rule or set of
+    recurrence rules.
+
+    :param s:
+        Required, a string defining one or more recurrence rules.
+
+    :param dtstart:
+        If given, used as the default recurrence start if not specified in the
+        rule string.
+
+    :param cache:
+        If set ``True`` caching of results will be enabled, improving
+        performance of multiple queries considerably.
+
+    :param unfold:
+        If set ``True`` indicates that a rule string is split over more
+        than one line and should be joined before processing.
+
+    :param forceset:
+        If set ``True`` forces a :class:`dateutil.rrule.rruleset` to
+        be returned.
+
+    :param compatible:
+        If set ``True`` forces ``unfold`` and ``forceset`` to be ``True``.
+
+    :param ignoretz:
+        If set ``True``, time zones in parsed strings are ignored and a naive
+        :class:`datetime.datetime` object is returned.
+
+    :param tzids:
+        If given, a callable or mapping used to retrieve a
+        :class:`datetime.tzinfo` from a string representation.
+        Defaults to :func:`dateutil.tz.gettz`.
+
+    :param tzinfos:
+        Additional time zone names / aliases which may be present in a string
+        representation.  See :func:`dateutil.parser.parse` for more
+        information.
+
+    :return:
+        Returns a :class:`dateutil.rrule.rruleset` or
+        :class:`dateutil.rrule.rrule`
+    """
+
+    _freq_map = {"YEARLY": YEARLY,
+                 "MONTHLY": MONTHLY,
+                 "WEEKLY": WEEKLY,
+                 "DAILY": DAILY,
+                 "HOURLY": HOURLY,
+                 "MINUTELY": MINUTELY,
+                 "SECONDLY": SECONDLY}
+
+    _weekday_map = {"MO": 0, "TU": 1, "WE": 2, "TH": 3,
+                    "FR": 4, "SA": 5, "SU": 6}
+
+    def _handle_int(self, rrkwargs, name, value, **kwargs):
+        rrkwargs[name.lower()] = int(value)
+
+    def _handle_int_list(self, rrkwargs, name, value, **kwargs):
+        rrkwargs[name.lower()] = [int(x) for x in value.split(',')]
+
+    _handle_INTERVAL = _handle_int
+    _handle_COUNT = _handle_int
+    _handle_BYSETPOS = _handle_int_list
+    _handle_BYMONTH = _handle_int_list
+    _handle_BYMONTHDAY = _handle_int_list
+    _handle_BYYEARDAY = _handle_int_list
+    _handle_BYEASTER = _handle_int_list
+    _handle_BYWEEKNO = _handle_int_list
+    _handle_BYHOUR = _handle_int_list
+    _handle_BYMINUTE = _handle_int_list
+    _handle_BYSECOND = _handle_int_list
+
+    def _handle_FREQ(self, rrkwargs, name, value, **kwargs):
+        rrkwargs["freq"] = self._freq_map[value]
+
+    def _handle_UNTIL(self, rrkwargs, name, value, **kwargs):
+        global parser
+        if not parser:
+            from dateutil import parser
+        try:
+            rrkwargs["until"] = parser.parse(value,
+                                             ignoretz=kwargs.get("ignoretz"),
+                                             tzinfos=kwargs.get("tzinfos"))
+        except ValueError:
+            raise ValueError("invalid until date")
+
+    def _handle_WKST(self, rrkwargs, name, value, **kwargs):
+        rrkwargs["wkst"] = self._weekday_map[value]
+
+    def _handle_BYWEEKDAY(self, rrkwargs, name, value, **kwargs):
+        """
+        Two ways to specify this: +1MO or MO(+1)
+        """
+        l = []
+        for wday in value.split(','):
+            if '(' in wday:
+                # If it's of the form TH(+1), etc.
+                splt = wday.split('(')
+                w = splt[0]
+                n = int(splt[1][:-1])
+            elif len(wday):
+                # If it's of the form +1MO
+                for i in range(len(wday)):
+                    if wday[i] not in '+-0123456789':
+                        break
+                n = wday[:i] or None
+                w = wday[i:]
+                if n:
+                    n = int(n)
+            else:
+                raise ValueError("Invalid (empty) BYDAY specification.")
+
+            l.append(weekdays[self._weekday_map[w]](n))
+        rrkwargs["byweekday"] = l
+
+    _handle_BYDAY = _handle_BYWEEKDAY
+
+    def _parse_rfc_rrule(self, line,
+                         dtstart=None,
+                         cache=False,
+                         ignoretz=False,
+                         tzinfos=None):
+        if line.find(':') != -1:
+            name, value = line.split(':')
+            if name != "RRULE":
+                raise ValueError("unknown parameter name")
+        else:
+            value = line
+        rrkwargs = {}
+        for pair in value.split(';'):
+            name, value = pair.split('=')
+            name = name.upper()
+            value = value.upper()
+            try:
+                getattr(self, "_handle_"+name)(rrkwargs, name, value,
+                                               ignoretz=ignoretz,
+                                               tzinfos=tzinfos)
+            except AttributeError:
+                raise ValueError("unknown parameter '%s'" % name)
+            except (KeyError, ValueError):
+                raise ValueError("invalid '%s': %s" % (name, value))
+        return rrule(dtstart=dtstart, cache=cache, **rrkwargs)
+
+    def _parse_date_value(self, date_value, parms, rule_tzids,
+                          ignoretz, tzids, tzinfos):
+        global parser
+        if not parser:
+            from dateutil import parser
+
+        datevals = []
+        value_found = False
+        TZID = None
+
+        for parm in parms:
+            if parm.startswith("TZID="):
+                try:
+                    tzkey = rule_tzids[parm.split('TZID=')[-1]]
+                except KeyError:
+                    continue
+                if tzids is None:
+                    from . import tz
+                    tzlookup = tz.gettz
+                elif callable(tzids):
+                    tzlookup = tzids
+                else:
+                    tzlookup = getattr(tzids, 'get', None)
+                    if tzlookup is None:
+                        msg = ('tzids must be a callable, mapping, or None, '
+                               'not %s' % tzids)
+                        raise ValueError(msg)
+
+                TZID = tzlookup(tzkey)
+                continue
+
+            # RFC 5445 3.8.2.4: The VALUE parameter is optional, but may be found
+            # only once.
+            if parm not in {"VALUE=DATE-TIME", "VALUE=DATE"}:
+                raise ValueError("unsupported parm: " + parm)
+            else:
+                if value_found:
+                    msg = ("Duplicate value parameter found in: " + parm)
+                    raise ValueError(msg)
+                value_found = True
+
+        for datestr in date_value.split(','):
+            date = parser.parse(datestr, ignoretz=ignoretz, tzinfos=tzinfos)
+            if TZID is not None:
+                if date.tzinfo is None:
+                    date = date.replace(tzinfo=TZID)
+                else:
+                    raise ValueError('DTSTART/EXDATE specifies multiple timezone')
+            datevals.append(date)
+
+        return datevals
+
+    def _parse_rfc(self, s,
+                   dtstart=None,
+                   cache=False,
+                   unfold=False,
+                   forceset=False,
+                   compatible=False,
+                   ignoretz=False,
+                   tzids=None,
+                   tzinfos=None):
+        global parser
+        if compatible:
+            forceset = True
+            unfold = True
+
+        TZID_NAMES = dict(map(
+            lambda x: (x.upper(), x),
+            re.findall('TZID=(?P<name>[^:]+):', s)
+        ))
+        s = s.upper()
+        if not s.strip():
+            raise ValueError("empty string")
+        if unfold:
+            lines = s.splitlines()
+            i = 0
+            while i < len(lines):
+                line = lines[i].rstrip()
+                if not line:
+                    del lines[i]
+                elif i > 0 and line[0] == " ":
+                    lines[i-1] += line[1:]
+                    del lines[i]
+                else:
+                    i += 1
+        else:
+            lines = s.split()
+        if (not forceset and len(lines) == 1 and (s.find(':') == -1 or
+                                                  s.startswith('RRULE:'))):
+            return self._parse_rfc_rrule(lines[0], cache=cache,
+                                         dtstart=dtstart, ignoretz=ignoretz,
+                                         tzinfos=tzinfos)
+        else:
+            rrulevals = []
+            rdatevals = []
+            exrulevals = []
+            exdatevals = []
+            for line in lines:
+                if not line:
+                    continue
+                if line.find(':') == -1:
+                    name = "RRULE"
+                    value = line
+                else:
+                    name, value = line.split(':', 1)
+                parms = name.split(';')
+                if not parms:
+                    raise ValueError("empty property name")
+                name = parms[0]
+                parms = parms[1:]
+                if name == "RRULE":
+                    for parm in parms:
+                        raise ValueError("unsupported RRULE parm: "+parm)
+                    rrulevals.append(value)
+                elif name == "RDATE":
+                    for parm in parms:
+                        if parm != "VALUE=DATE-TIME":
+                            raise ValueError("unsupported RDATE parm: "+parm)
+                    rdatevals.append(value)
+                elif name == "EXRULE":
+                    for parm in parms:
+                        raise ValueError("unsupported EXRULE parm: "+parm)
+                    exrulevals.append(value)
+                elif name == "EXDATE":
+                    exdatevals.extend(
+                        self._parse_date_value(value, parms,
+                                               TZID_NAMES, ignoretz,
+                                               tzids, tzinfos)
+                    )
+                elif name == "DTSTART":
+                    dtvals = self._parse_date_value(value, parms, TZID_NAMES,
+                                                    ignoretz, tzids, tzinfos)
+                    if len(dtvals) != 1:
+                        raise ValueError("Multiple DTSTART values specified:" +
+                                         value)
+                    dtstart = dtvals[0]
+                else:
+                    raise ValueError("unsupported property: "+name)
+            if (forceset or len(rrulevals) > 1 or rdatevals
+                    or exrulevals or exdatevals):
+                if not parser and (rdatevals or exdatevals):
+                    from dateutil import parser
+                rset = rruleset(cache=cache)
+                for value in rrulevals:
+                    rset.rrule(self._parse_rfc_rrule(value, dtstart=dtstart,
+                                                     ignoretz=ignoretz,
+                                                     tzinfos=tzinfos))
+                for value in rdatevals:
+                    for datestr in value.split(','):
+                        rset.rdate(parser.parse(datestr,
+                                                ignoretz=ignoretz,
+                                                tzinfos=tzinfos))
+                for value in exrulevals:
+                    rset.exrule(self._parse_rfc_rrule(value, dtstart=dtstart,
+                                                      ignoretz=ignoretz,
+                                                      tzinfos=tzinfos))
+                for value in exdatevals:
+                    rset.exdate(value)
+                if compatible and dtstart:
+                    rset.rdate(dtstart)
+                return rset
+            else:
+                return self._parse_rfc_rrule(rrulevals[0],
+                                             dtstart=dtstart,
+                                             cache=cache,
+                                             ignoretz=ignoretz,
+                                             tzinfos=tzinfos)
+
+    def __call__(self, s, **kwargs):
+        return self._parse_rfc(s, **kwargs)
+
+
+rrulestr = _rrulestr()
+
+# vim:ts=4:sw=4:et
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..af1352c47292f4eebc5cae8da45641b5544558e3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/__init__.py
@@ -0,0 +1,12 @@
+# -*- coding: utf-8 -*-
+from .tz import *
+from .tz import __doc__
+
+__all__ = ["tzutc", "tzoffset", "tzlocal", "tzfile", "tzrange",
+           "tzstr", "tzical", "tzwin", "tzwinlocal", "gettz",
+           "enfold", "datetime_ambiguous", "datetime_exists",
+           "resolve_imaginary", "UTC", "DeprecatedTzFormatWarning"]
+
+
+class DeprecatedTzFormatWarning(Warning):
+    """Warning raised when time zones are parsed from deprecated formats."""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_common.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..e6ac11831522b266114d5b68ee1da298e3aeb14a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_common.py
@@ -0,0 +1,419 @@
+from six import PY2
+
+from functools import wraps
+
+from datetime import datetime, timedelta, tzinfo
+
+
+ZERO = timedelta(0)
+
+__all__ = ['tzname_in_python2', 'enfold']
+
+
+def tzname_in_python2(namefunc):
+    """Change unicode output into bytestrings in Python 2
+
+    tzname() API changed in Python 3. It used to return bytes, but was changed
+    to unicode strings
+    """
+    if PY2:
+        @wraps(namefunc)
+        def adjust_encoding(*args, **kwargs):
+            name = namefunc(*args, **kwargs)
+            if name is not None:
+                name = name.encode()
+
+            return name
+
+        return adjust_encoding
+    else:
+        return namefunc
+
+
+# The following is adapted from Alexander Belopolsky's tz library
+# https://github.com/abalkin/tz
+if hasattr(datetime, 'fold'):
+    # This is the pre-python 3.6 fold situation
+    def enfold(dt, fold=1):
+        """
+        Provides a unified interface for assigning the ``fold`` attribute to
+        datetimes both before and after the implementation of PEP-495.
+
+        :param fold:
+            The value for the ``fold`` attribute in the returned datetime. This
+            should be either 0 or 1.
+
+        :return:
+            Returns an object for which ``getattr(dt, 'fold', 0)`` returns
+            ``fold`` for all versions of Python. In versions prior to
+            Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
+            subclass of :py:class:`datetime.datetime` with the ``fold``
+            attribute added, if ``fold`` is 1.
+
+        .. versionadded:: 2.6.0
+        """
+        return dt.replace(fold=fold)
+
+else:
+    class _DatetimeWithFold(datetime):
+        """
+        This is a class designed to provide a PEP 495-compliant interface for
+        Python versions before 3.6. It is used only for dates in a fold, so
+        the ``fold`` attribute is fixed at ``1``.
+
+        .. versionadded:: 2.6.0
+        """
+        __slots__ = ()
+
+        def replace(self, *args, **kwargs):
+            """
+            Return a datetime with the same attributes, except for those
+            attributes given new values by whichever keyword arguments are
+            specified. Note that tzinfo=None can be specified to create a naive
+            datetime from an aware datetime with no conversion of date and time
+            data.
+
+            This is reimplemented in ``_DatetimeWithFold`` because pypy3 will
+            return a ``datetime.datetime`` even if ``fold`` is unchanged.
+            """
+            argnames = (
+                'year', 'month', 'day', 'hour', 'minute', 'second',
+                'microsecond', 'tzinfo'
+            )
+
+            for arg, argname in zip(args, argnames):
+                if argname in kwargs:
+                    raise TypeError('Duplicate argument: {}'.format(argname))
+
+                kwargs[argname] = arg
+
+            for argname in argnames:
+                if argname not in kwargs:
+                    kwargs[argname] = getattr(self, argname)
+
+            dt_class = self.__class__ if kwargs.get('fold', 1) else datetime
+
+            return dt_class(**kwargs)
+
+        @property
+        def fold(self):
+            return 1
+
+    def enfold(dt, fold=1):
+        """
+        Provides a unified interface for assigning the ``fold`` attribute to
+        datetimes both before and after the implementation of PEP-495.
+
+        :param fold:
+            The value for the ``fold`` attribute in the returned datetime. This
+            should be either 0 or 1.
+
+        :return:
+            Returns an object for which ``getattr(dt, 'fold', 0)`` returns
+            ``fold`` for all versions of Python. In versions prior to
+            Python 3.6, this is a ``_DatetimeWithFold`` object, which is a
+            subclass of :py:class:`datetime.datetime` with the ``fold``
+            attribute added, if ``fold`` is 1.
+
+        .. versionadded:: 2.6.0
+        """
+        if getattr(dt, 'fold', 0) == fold:
+            return dt
+
+        args = dt.timetuple()[:6]
+        args += (dt.microsecond, dt.tzinfo)
+
+        if fold:
+            return _DatetimeWithFold(*args)
+        else:
+            return datetime(*args)
+
+
+def _validate_fromutc_inputs(f):
+    """
+    The CPython version of ``fromutc`` checks that the input is a ``datetime``
+    object and that ``self`` is attached as its ``tzinfo``.
+    """
+    @wraps(f)
+    def fromutc(self, dt):
+        if not isinstance(dt, datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        return f(self, dt)
+
+    return fromutc
+
+
+class _tzinfo(tzinfo):
+    """
+    Base class for all ``dateutil`` ``tzinfo`` objects.
+    """
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+
+        dt = dt.replace(tzinfo=self)
+
+        wall_0 = enfold(dt, fold=0)
+        wall_1 = enfold(dt, fold=1)
+
+        same_offset = wall_0.utcoffset() == wall_1.utcoffset()
+        same_dt = wall_0.replace(tzinfo=None) == wall_1.replace(tzinfo=None)
+
+        return same_dt and not same_offset
+
+    def _fold_status(self, dt_utc, dt_wall):
+        """
+        Determine the fold status of a "wall" datetime, given a representation
+        of the same datetime as a (naive) UTC datetime. This is calculated based
+        on the assumption that ``dt.utcoffset() - dt.dst()`` is constant for all
+        datetimes, and that this offset is the actual number of hours separating
+        ``dt_utc`` and ``dt_wall``.
+
+        :param dt_utc:
+            Representation of the datetime as UTC
+
+        :param dt_wall:
+            Representation of the datetime as "wall time". This parameter must
+            either have a `fold` attribute or have a fold-naive
+            :class:`datetime.tzinfo` attached, otherwise the calculation may
+            fail.
+        """
+        if self.is_ambiguous(dt_wall):
+            delta_wall = dt_wall - dt_utc
+            _fold = int(delta_wall == (dt_utc.utcoffset() - dt_utc.dst()))
+        else:
+            _fold = 0
+
+        return _fold
+
+    def _fold(self, dt):
+        return getattr(dt, 'fold', 0)
+
+    def _fromutc(self, dt):
+        """
+        Given a timezone-aware datetime in a given timezone, calculates a
+        timezone-aware datetime in a new timezone.
+
+        Since this is the one time that we *know* we have an unambiguous
+        datetime object, we take this opportunity to determine whether the
+        datetime is ambiguous and in a "fold" state (e.g. if it's the first
+        occurrence, chronologically, of the ambiguous datetime).
+
+        :param dt:
+            A timezone-aware :class:`datetime.datetime` object.
+        """
+
+        # Re-implement the algorithm from Python's datetime.py
+        dtoff = dt.utcoffset()
+        if dtoff is None:
+            raise ValueError("fromutc() requires a non-None utcoffset() "
+                             "result")
+
+        # The original datetime.py code assumes that `dst()` defaults to
+        # zero during ambiguous times. PEP 495 inverts this presumption, so
+        # for pre-PEP 495 versions of python, we need to tweak the algorithm.
+        dtdst = dt.dst()
+        if dtdst is None:
+            raise ValueError("fromutc() requires a non-None dst() result")
+        delta = dtoff - dtdst
+
+        dt += delta
+        # Set fold=1 so we can default to being in the fold for
+        # ambiguous dates.
+        dtdst = enfold(dt, fold=1).dst()
+        if dtdst is None:
+            raise ValueError("fromutc(): dt.dst gave inconsistent "
+                             "results; cannot convert")
+        return dt + dtdst
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        """
+        Given a timezone-aware datetime in a given timezone, calculates a
+        timezone-aware datetime in a new timezone.
+
+        Since this is the one time that we *know* we have an unambiguous
+        datetime object, we take this opportunity to determine whether the
+        datetime is ambiguous and in a "fold" state (e.g. if it's the first
+        occurrence, chronologically, of the ambiguous datetime).
+
+        :param dt:
+            A timezone-aware :class:`datetime.datetime` object.
+        """
+        dt_wall = self._fromutc(dt)
+
+        # Calculate the fold status given the two datetimes.
+        _fold = self._fold_status(dt, dt_wall)
+
+        # Set the default fold value for ambiguous dates
+        return enfold(dt_wall, fold=_fold)
+
+
+class tzrangebase(_tzinfo):
+    """
+    This is an abstract base class for time zones represented by an annual
+    transition into and out of DST. Child classes should implement the following
+    methods:
+
+        * ``__init__(self, *args, **kwargs)``
+        * ``transitions(self, year)`` - this is expected to return a tuple of
+          datetimes representing the DST on and off transitions in standard
+          time.
+
+    A fully initialized ``tzrangebase`` subclass should also provide the
+    following attributes:
+        * ``hasdst``: Boolean whether or not the zone uses DST.
+        * ``_dst_offset`` / ``_std_offset``: :class:`datetime.timedelta` objects
+          representing the respective UTC offsets.
+        * ``_dst_abbr`` / ``_std_abbr``: Strings representing the timezone short
+          abbreviations in DST and STD, respectively.
+        * ``_hasdst``: Whether or not the zone has DST.
+
+    .. versionadded:: 2.6.0
+    """
+    def __init__(self):
+        raise NotImplementedError('tzrangebase is an abstract base class')
+
+    def utcoffset(self, dt):
+        isdst = self._isdst(dt)
+
+        if isdst is None:
+            return None
+        elif isdst:
+            return self._dst_offset
+        else:
+            return self._std_offset
+
+    def dst(self, dt):
+        isdst = self._isdst(dt)
+
+        if isdst is None:
+            return None
+        elif isdst:
+            return self._dst_base_offset
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        if self._isdst(dt):
+            return self._dst_abbr
+        else:
+            return self._std_abbr
+
+    def fromutc(self, dt):
+        """ Given a datetime in UTC, return local time """
+        if not isinstance(dt, datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        # Get transitions - if there are none, fixed offset
+        transitions = self.transitions(dt.year)
+        if transitions is None:
+            return dt + self.utcoffset(dt)
+
+        # Get the transition times in UTC
+        dston, dstoff = transitions
+
+        dston -= self._std_offset
+        dstoff -= self._std_offset
+
+        utc_transitions = (dston, dstoff)
+        dt_utc = dt.replace(tzinfo=None)
+
+        isdst = self._naive_isdst(dt_utc, utc_transitions)
+
+        if isdst:
+            dt_wall = dt + self._dst_offset
+        else:
+            dt_wall = dt + self._std_offset
+
+        _fold = int(not isdst and self.is_ambiguous(dt_wall))
+
+        return enfold(dt_wall, fold=_fold)
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        if not self.hasdst:
+            return False
+
+        start, end = self.transitions(dt.year)
+
+        dt = dt.replace(tzinfo=None)
+        return (end <= dt < end + self._dst_base_offset)
+
+    def _isdst(self, dt):
+        if not self.hasdst:
+            return False
+        elif dt is None:
+            return None
+
+        transitions = self.transitions(dt.year)
+
+        if transitions is None:
+            return False
+
+        dt = dt.replace(tzinfo=None)
+
+        isdst = self._naive_isdst(dt, transitions)
+
+        # Handle ambiguous dates
+        if not isdst and self.is_ambiguous(dt):
+            return not self._fold(dt)
+        else:
+            return isdst
+
+    def _naive_isdst(self, dt, transitions):
+        dston, dstoff = transitions
+
+        dt = dt.replace(tzinfo=None)
+
+        if dston < dstoff:
+            isdst = dston <= dt < dstoff
+        else:
+            isdst = not dstoff <= dt < dston
+
+        return isdst
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_offset - self._std_offset
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(...)" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_factories.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_factories.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8a65891a023ebf9eb0c24d391ba67541b7133f1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/_factories.py
@@ -0,0 +1,80 @@
+from datetime import timedelta
+import weakref
+from collections import OrderedDict
+
+from six.moves import _thread
+
+
+class _TzSingleton(type):
+    def __init__(cls, *args, **kwargs):
+        cls.__instance = None
+        super(_TzSingleton, cls).__init__(*args, **kwargs)
+
+    def __call__(cls):
+        if cls.__instance is None:
+            cls.__instance = super(_TzSingleton, cls).__call__()
+        return cls.__instance
+
+
+class _TzFactory(type):
+    def instance(cls, *args, **kwargs):
+        """Alternate constructor that returns a fresh instance"""
+        return type.__call__(cls, *args, **kwargs)
+
+
+class _TzOffsetFactory(_TzFactory):
+    def __init__(cls, *args, **kwargs):
+        cls.__instances = weakref.WeakValueDictionary()
+        cls.__strong_cache = OrderedDict()
+        cls.__strong_cache_size = 8
+
+        cls._cache_lock = _thread.allocate_lock()
+
+    def __call__(cls, name, offset):
+        if isinstance(offset, timedelta):
+            key = (name, offset.total_seconds())
+        else:
+            key = (name, offset)
+
+        instance = cls.__instances.get(key, None)
+        if instance is None:
+            instance = cls.__instances.setdefault(key,
+                                                  cls.instance(name, offset))
+
+        # This lock may not be necessary in Python 3. See GH issue #901
+        with cls._cache_lock:
+            cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance)
+
+            # Remove an item if the strong cache is overpopulated
+            if len(cls.__strong_cache) > cls.__strong_cache_size:
+                cls.__strong_cache.popitem(last=False)
+
+        return instance
+
+
+class _TzStrFactory(_TzFactory):
+    def __init__(cls, *args, **kwargs):
+        cls.__instances = weakref.WeakValueDictionary()
+        cls.__strong_cache = OrderedDict()
+        cls.__strong_cache_size = 8
+
+        cls.__cache_lock = _thread.allocate_lock()
+
+    def __call__(cls, s, posix_offset=False):
+        key = (s, posix_offset)
+        instance = cls.__instances.get(key, None)
+
+        if instance is None:
+            instance = cls.__instances.setdefault(key,
+                cls.instance(s, posix_offset))
+
+        # This lock may not be necessary in Python 3. See GH issue #901
+        with cls.__cache_lock:
+            cls.__strong_cache[key] = cls.__strong_cache.pop(key, instance)
+
+            # Remove an item if the strong cache is overpopulated
+            if len(cls.__strong_cache) > cls.__strong_cache_size:
+                cls.__strong_cache.popitem(last=False)
+
+        return instance
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/tz.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/tz.py
new file mode 100644
index 0000000000000000000000000000000000000000..af81e88e1188112051414c9f2222a1c0781aaed3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/tz.py
@@ -0,0 +1,1849 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers timezone implementations subclassing the abstract
+:py:class:`datetime.tzinfo` type. There are classes to handle tzfile format
+files (usually are in :file:`/etc/localtime`, :file:`/usr/share/zoneinfo`,
+etc), TZ environment string (in all known formats), given ranges (with help
+from relative deltas), local machine timezone, fixed offset timezone, and UTC
+timezone.
+"""
+import datetime
+import struct
+import time
+import sys
+import os
+import bisect
+import weakref
+from collections import OrderedDict
+
+import six
+from six import string_types
+from six.moves import _thread
+from ._common import tzname_in_python2, _tzinfo
+from ._common import tzrangebase, enfold
+from ._common import _validate_fromutc_inputs
+
+from ._factories import _TzSingleton, _TzOffsetFactory
+from ._factories import _TzStrFactory
+try:
+    from .win import tzwin, tzwinlocal
+except ImportError:
+    tzwin = tzwinlocal = None
+
+# For warning about rounding tzinfo
+from warnings import warn
+
+ZERO = datetime.timedelta(0)
+EPOCH = datetime.datetime.utcfromtimestamp(0)
+EPOCHORDINAL = EPOCH.toordinal()
+
+
+@six.add_metaclass(_TzSingleton)
+class tzutc(datetime.tzinfo):
+    """
+    This is a tzinfo object that represents the UTC time zone.
+
+    **Examples:**
+
+    .. doctest::
+
+        >>> from datetime import *
+        >>> from dateutil.tz import *
+
+        >>> datetime.now()
+        datetime.datetime(2003, 9, 27, 9, 40, 1, 521290)
+
+        >>> datetime.now(tzutc())
+        datetime.datetime(2003, 9, 27, 12, 40, 12, 156379, tzinfo=tzutc())
+
+        >>> datetime.now(tzutc()).tzname()
+        'UTC'
+
+    .. versionchanged:: 2.7.0
+        ``tzutc()`` is now a singleton, so the result of ``tzutc()`` will
+        always return the same object.
+
+        .. doctest::
+
+            >>> from dateutil.tz import tzutc, UTC
+            >>> tzutc() is tzutc()
+            True
+            >>> tzutc() is UTC
+            True
+    """
+    def utcoffset(self, dt):
+        return ZERO
+
+    def dst(self, dt):
+        return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return "UTC"
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        return False
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        """
+        Fast track version of fromutc() returns the original ``dt`` object for
+        any valid :py:class:`datetime.datetime` object.
+        """
+        return dt
+
+    def __eq__(self, other):
+        if not isinstance(other, (tzutc, tzoffset)):
+            return NotImplemented
+
+        return (isinstance(other, tzutc) or
+                (isinstance(other, tzoffset) and other._offset == ZERO))
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s()" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
+
+
+#: Convenience constant providing a :class:`tzutc()` instance
+#:
+#: .. versionadded:: 2.7.0
+UTC = tzutc()
+
+
+@six.add_metaclass(_TzOffsetFactory)
+class tzoffset(datetime.tzinfo):
+    """
+    A simple class for representing a fixed offset from UTC.
+
+    :param name:
+        The timezone name, to be returned when ``tzname()`` is called.
+    :param offset:
+        The time zone offset in seconds, or (since version 2.6.0, represented
+        as a :py:class:`datetime.timedelta` object).
+    """
+    def __init__(self, name, offset):
+        self._name = name
+
+        try:
+            # Allow a timedelta
+            offset = offset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        self._offset = datetime.timedelta(seconds=_get_supported_offset(offset))
+
+    def utcoffset(self, dt):
+        return self._offset
+
+    def dst(self, dt):
+        return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._name
+
+    @_validate_fromutc_inputs
+    def fromutc(self, dt):
+        return dt + self._offset
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        return False
+
+    def __eq__(self, other):
+        if not isinstance(other, tzoffset):
+            return NotImplemented
+
+        return self._offset == other._offset
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(%s, %s)" % (self.__class__.__name__,
+                               repr(self._name),
+                               int(self._offset.total_seconds()))
+
+    __reduce__ = object.__reduce__
+
+
+class tzlocal(_tzinfo):
+    """
+    A :class:`tzinfo` subclass built around the ``time`` timezone functions.
+    """
+    def __init__(self):
+        super(tzlocal, self).__init__()
+
+        self._std_offset = datetime.timedelta(seconds=-time.timezone)
+        if time.daylight:
+            self._dst_offset = datetime.timedelta(seconds=-time.altzone)
+        else:
+            self._dst_offset = self._std_offset
+
+        self._dst_saved = self._dst_offset - self._std_offset
+        self._hasdst = bool(self._dst_saved)
+        self._tznames = tuple(time.tzname)
+
+    def utcoffset(self, dt):
+        if dt is None and self._hasdst:
+            return None
+
+        if self._isdst(dt):
+            return self._dst_offset
+        else:
+            return self._std_offset
+
+    def dst(self, dt):
+        if dt is None and self._hasdst:
+            return None
+
+        if self._isdst(dt):
+            return self._dst_offset - self._std_offset
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._tznames[self._isdst(dt)]
+
+    def is_ambiguous(self, dt):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        naive_dst = self._naive_is_dst(dt)
+        return (not naive_dst and
+                (naive_dst != self._naive_is_dst(dt - self._dst_saved)))
+
+    def _naive_is_dst(self, dt):
+        timestamp = _datetime_to_timestamp(dt)
+        return time.localtime(timestamp + time.timezone).tm_isdst
+
+    def _isdst(self, dt, fold_naive=True):
+        # We can't use mktime here. It is unstable when deciding if
+        # the hour near to a change is DST or not.
+        #
+        # timestamp = time.mktime((dt.year, dt.month, dt.day, dt.hour,
+        #                         dt.minute, dt.second, dt.weekday(), 0, -1))
+        # return time.localtime(timestamp).tm_isdst
+        #
+        # The code above yields the following result:
+        #
+        # >>> import tz, datetime
+        # >>> t = tz.tzlocal()
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRDT'
+        # >>> datetime.datetime(2003,2,16,0,tzinfo=t).tzname()
+        # 'BRST'
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRST'
+        # >>> datetime.datetime(2003,2,15,22,tzinfo=t).tzname()
+        # 'BRDT'
+        # >>> datetime.datetime(2003,2,15,23,tzinfo=t).tzname()
+        # 'BRDT'
+        #
+        # Here is a more stable implementation:
+        #
+        if not self._hasdst:
+            return False
+
+        # Check for ambiguous times:
+        dstval = self._naive_is_dst(dt)
+        fold = getattr(dt, 'fold', None)
+
+        if self.is_ambiguous(dt):
+            if fold is not None:
+                return not self._fold(dt)
+            else:
+                return True
+
+        return dstval
+
+    def __eq__(self, other):
+        if isinstance(other, tzlocal):
+            return (self._std_offset == other._std_offset and
+                    self._dst_offset == other._dst_offset)
+        elif isinstance(other, tzutc):
+            return (not self._hasdst and
+                    self._tznames[0] in {'UTC', 'GMT'} and
+                    self._std_offset == ZERO)
+        elif isinstance(other, tzoffset):
+            return (not self._hasdst and
+                    self._tznames[0] == other._name and
+                    self._std_offset == other._offset)
+        else:
+            return NotImplemented
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s()" % self.__class__.__name__
+
+    __reduce__ = object.__reduce__
+
+
+class _ttinfo(object):
+    __slots__ = ["offset", "delta", "isdst", "abbr",
+                 "isstd", "isgmt", "dstoffset"]
+
+    def __init__(self):
+        for attr in self.__slots__:
+            setattr(self, attr, None)
+
+    def __repr__(self):
+        l = []
+        for attr in self.__slots__:
+            value = getattr(self, attr)
+            if value is not None:
+                l.append("%s=%s" % (attr, repr(value)))
+        return "%s(%s)" % (self.__class__.__name__, ", ".join(l))
+
+    def __eq__(self, other):
+        if not isinstance(other, _ttinfo):
+            return NotImplemented
+
+        return (self.offset == other.offset and
+                self.delta == other.delta and
+                self.isdst == other.isdst and
+                self.abbr == other.abbr and
+                self.isstd == other.isstd and
+                self.isgmt == other.isgmt and
+                self.dstoffset == other.dstoffset)
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __getstate__(self):
+        state = {}
+        for name in self.__slots__:
+            state[name] = getattr(self, name, None)
+        return state
+
+    def __setstate__(self, state):
+        for name in self.__slots__:
+            if name in state:
+                setattr(self, name, state[name])
+
+
+class _tzfile(object):
+    """
+    Lightweight class for holding the relevant transition and time zone
+    information read from binary tzfiles.
+    """
+    attrs = ['trans_list', 'trans_list_utc', 'trans_idx', 'ttinfo_list',
+             'ttinfo_std', 'ttinfo_dst', 'ttinfo_before', 'ttinfo_first']
+
+    def __init__(self, **kwargs):
+        for attr in self.attrs:
+            setattr(self, attr, kwargs.get(attr, None))
+
+
+class tzfile(_tzinfo):
+    """
+    This is a ``tzinfo`` subclass that allows one to use the ``tzfile(5)``
+    format timezone files to extract current and historical zone information.
+
+    :param fileobj:
+        This can be an opened file stream or a file name that the time zone
+        information can be read from.
+
+    :param filename:
+        This is an optional parameter specifying the source of the time zone
+        information in the event that ``fileobj`` is a file object. If omitted
+        and ``fileobj`` is a file stream, this parameter will be set either to
+        ``fileobj``'s ``name`` attribute or to ``repr(fileobj)``.
+
+    See `Sources for Time Zone and Daylight Saving Time Data
+    <https://data.iana.org/time-zones/tz-link.html>`_ for more information.
+    Time zone files can be compiled from the `IANA Time Zone database files
+    <https://www.iana.org/time-zones>`_ with the `zic time zone compiler
+    <https://www.freebsd.org/cgi/man.cgi?query=zic&sektion=8>`_
+
+    .. note::
+
+        Only construct a ``tzfile`` directly if you have a specific timezone
+        file on disk that you want to read into a Python ``tzinfo`` object.
+        If you want to get a ``tzfile`` representing a specific IANA zone,
+        (e.g. ``'America/New_York'``), you should call
+        :func:`dateutil.tz.gettz` with the zone identifier.
+
+
+    **Examples:**
+
+    Using the US Eastern time zone as an example, we can see that a ``tzfile``
+    provides time zone information for the standard Daylight Saving offsets:
+
+    .. testsetup:: tzfile
+
+        from dateutil.tz import gettz
+        from datetime import datetime
+
+    .. doctest:: tzfile
+
+        >>> NYC = gettz('America/New_York')
+        >>> NYC
+        tzfile('/usr/share/zoneinfo/America/New_York')
+
+        >>> print(datetime(2016, 1, 3, tzinfo=NYC))     # EST
+        2016-01-03 00:00:00-05:00
+
+        >>> print(datetime(2016, 7, 7, tzinfo=NYC))     # EDT
+        2016-07-07 00:00:00-04:00
+
+
+    The ``tzfile`` structure contains a fully history of the time zone,
+    so historical dates will also have the right offsets. For example, before
+    the adoption of the UTC standards, New York used local solar  mean time:
+
+    .. doctest:: tzfile
+
+       >>> print(datetime(1901, 4, 12, tzinfo=NYC))    # LMT
+       1901-04-12 00:00:00-04:56
+
+    And during World War II, New York was on "Eastern War Time", which was a
+    state of permanent daylight saving time:
+
+    .. doctest:: tzfile
+
+        >>> print(datetime(1944, 2, 7, tzinfo=NYC))    # EWT
+        1944-02-07 00:00:00-04:00
+
+    """
+
+    def __init__(self, fileobj, filename=None):
+        super(tzfile, self).__init__()
+
+        file_opened_here = False
+        if isinstance(fileobj, string_types):
+            self._filename = fileobj
+            fileobj = open(fileobj, 'rb')
+            file_opened_here = True
+        elif filename is not None:
+            self._filename = filename
+        elif hasattr(fileobj, "name"):
+            self._filename = fileobj.name
+        else:
+            self._filename = repr(fileobj)
+
+        if fileobj is not None:
+            if not file_opened_here:
+                fileobj = _nullcontext(fileobj)
+
+            with fileobj as file_stream:
+                tzobj = self._read_tzfile(file_stream)
+
+            self._set_tzdata(tzobj)
+
+    def _set_tzdata(self, tzobj):
+        """ Set the time zone data of this object from a _tzfile object """
+        # Copy the relevant attributes over as private attributes
+        for attr in _tzfile.attrs:
+            setattr(self, '_' + attr, getattr(tzobj, attr))
+
+    def _read_tzfile(self, fileobj):
+        out = _tzfile()
+
+        # From tzfile(5):
+        #
+        # The time zone information files used by tzset(3)
+        # begin with the magic characters "TZif" to identify
+        # them as time zone information files, followed by
+        # sixteen bytes reserved for future use, followed by
+        # six four-byte values of type long, written in a
+        # ``standard'' byte order (the high-order  byte
+        # of the value is written first).
+        if fileobj.read(4).decode() != "TZif":
+            raise ValueError("magic not found")
+
+        fileobj.read(16)
+
+        (
+            # The number of UTC/local indicators stored in the file.
+            ttisgmtcnt,
+
+            # The number of standard/wall indicators stored in the file.
+            ttisstdcnt,
+
+            # The number of leap seconds for which data is
+            # stored in the file.
+            leapcnt,
+
+            # The number of "transition times" for which data
+            # is stored in the file.
+            timecnt,
+
+            # The number of "local time types" for which data
+            # is stored in the file (must not be zero).
+            typecnt,
+
+            # The  number  of  characters  of "time zone
+            # abbreviation strings" stored in the file.
+            charcnt,
+
+        ) = struct.unpack(">6l", fileobj.read(24))
+
+        # The above header is followed by tzh_timecnt four-byte
+        # values  of  type long,  sorted  in ascending order.
+        # These values are written in ``standard'' byte order.
+        # Each is used as a transition time (as  returned  by
+        # time(2)) at which the rules for computing local time
+        # change.
+
+        if timecnt:
+            out.trans_list_utc = list(struct.unpack(">%dl" % timecnt,
+                                                    fileobj.read(timecnt*4)))
+        else:
+            out.trans_list_utc = []
+
+        # Next come tzh_timecnt one-byte values of type unsigned
+        # char; each one tells which of the different types of
+        # ``local time'' types described in the file is associated
+        # with the same-indexed transition time. These values
+        # serve as indices into an array of ttinfo structures that
+        # appears next in the file.
+
+        if timecnt:
+            out.trans_idx = struct.unpack(">%dB" % timecnt,
+                                          fileobj.read(timecnt))
+        else:
+            out.trans_idx = []
+
+        # Each ttinfo structure is written as a four-byte value
+        # for tt_gmtoff  of  type long,  in  a  standard  byte
+        # order, followed  by a one-byte value for tt_isdst
+        # and a one-byte  value  for  tt_abbrind.   In  each
+        # structure, tt_gmtoff  gives  the  number  of
+        # seconds to be added to UTC, tt_isdst tells whether
+        # tm_isdst should be set by  localtime(3),  and
+        # tt_abbrind serves  as an index into the array of
+        # time zone abbreviation characters that follow the
+        # ttinfo structure(s) in the file.
+
+        ttinfo = []
+
+        for i in range(typecnt):
+            ttinfo.append(struct.unpack(">lbb", fileobj.read(6)))
+
+        abbr = fileobj.read(charcnt).decode()
+
+        # Then there are tzh_leapcnt pairs of four-byte
+        # values, written in  standard byte  order;  the
+        # first  value  of  each pair gives the time (as
+        # returned by time(2)) at which a leap second
+        # occurs;  the  second  gives the  total  number of
+        # leap seconds to be applied after the given time.
+        # The pairs of values are sorted in ascending order
+        # by time.
+
+        # Not used, for now (but seek for correct file position)
+        if leapcnt:
+            fileobj.seek(leapcnt * 8, os.SEEK_CUR)
+
+        # Then there are tzh_ttisstdcnt standard/wall
+        # indicators, each stored as a one-byte value;
+        # they tell whether the transition times associated
+        # with local time types were specified as standard
+        # time or wall clock time, and are used when
+        # a time zone file is used in handling POSIX-style
+        # time zone environment variables.
+
+        if ttisstdcnt:
+            isstd = struct.unpack(">%db" % ttisstdcnt,
+                                  fileobj.read(ttisstdcnt))
+
+        # Finally, there are tzh_ttisgmtcnt UTC/local
+        # indicators, each stored as a one-byte value;
+        # they tell whether the transition times associated
+        # with local time types were specified as UTC or
+        # local time, and are used when a time zone file
+        # is used in handling POSIX-style time zone envi-
+        # ronment variables.
+
+        if ttisgmtcnt:
+            isgmt = struct.unpack(">%db" % ttisgmtcnt,
+                                  fileobj.read(ttisgmtcnt))
+
+        # Build ttinfo list
+        out.ttinfo_list = []
+        for i in range(typecnt):
+            gmtoff, isdst, abbrind = ttinfo[i]
+            gmtoff = _get_supported_offset(gmtoff)
+            tti = _ttinfo()
+            tti.offset = gmtoff
+            tti.dstoffset = datetime.timedelta(0)
+            tti.delta = datetime.timedelta(seconds=gmtoff)
+            tti.isdst = isdst
+            tti.abbr = abbr[abbrind:abbr.find('\x00', abbrind)]
+            tti.isstd = (ttisstdcnt > i and isstd[i] != 0)
+            tti.isgmt = (ttisgmtcnt > i and isgmt[i] != 0)
+            out.ttinfo_list.append(tti)
+
+        # Replace ttinfo indexes for ttinfo objects.
+        out.trans_idx = [out.ttinfo_list[idx] for idx in out.trans_idx]
+
+        # Set standard, dst, and before ttinfos. before will be
+        # used when a given time is before any transitions,
+        # and will be set to the first non-dst ttinfo, or to
+        # the first dst, if all of them are dst.
+        out.ttinfo_std = None
+        out.ttinfo_dst = None
+        out.ttinfo_before = None
+        if out.ttinfo_list:
+            if not out.trans_list_utc:
+                out.ttinfo_std = out.ttinfo_first = out.ttinfo_list[0]
+            else:
+                for i in range(timecnt-1, -1, -1):
+                    tti = out.trans_idx[i]
+                    if not out.ttinfo_std and not tti.isdst:
+                        out.ttinfo_std = tti
+                    elif not out.ttinfo_dst and tti.isdst:
+                        out.ttinfo_dst = tti
+
+                    if out.ttinfo_std and out.ttinfo_dst:
+                        break
+                else:
+                    if out.ttinfo_dst and not out.ttinfo_std:
+                        out.ttinfo_std = out.ttinfo_dst
+
+                for tti in out.ttinfo_list:
+                    if not tti.isdst:
+                        out.ttinfo_before = tti
+                        break
+                else:
+                    out.ttinfo_before = out.ttinfo_list[0]
+
+        # Now fix transition times to become relative to wall time.
+        #
+        # I'm not sure about this. In my tests, the tz source file
+        # is setup to wall time, and in the binary file isstd and
+        # isgmt are off, so it should be in wall time. OTOH, it's
+        # always in gmt time. Let me know if you have comments
+        # about this.
+        lastdst = None
+        lastoffset = None
+        lastdstoffset = None
+        lastbaseoffset = None
+        out.trans_list = []
+
+        for i, tti in enumerate(out.trans_idx):
+            offset = tti.offset
+            dstoffset = 0
+
+            if lastdst is not None:
+                if tti.isdst:
+                    if not lastdst:
+                        dstoffset = offset - lastoffset
+
+                    if not dstoffset and lastdstoffset:
+                        dstoffset = lastdstoffset
+
+                    tti.dstoffset = datetime.timedelta(seconds=dstoffset)
+                    lastdstoffset = dstoffset
+
+            # If a time zone changes its base offset during a DST transition,
+            # then you need to adjust by the previous base offset to get the
+            # transition time in local time. Otherwise you use the current
+            # base offset. Ideally, I would have some mathematical proof of
+            # why this is true, but I haven't really thought about it enough.
+            baseoffset = offset - dstoffset
+            adjustment = baseoffset
+            if (lastbaseoffset is not None and baseoffset != lastbaseoffset
+                    and tti.isdst != lastdst):
+                # The base DST has changed
+                adjustment = lastbaseoffset
+
+            lastdst = tti.isdst
+            lastoffset = offset
+            lastbaseoffset = baseoffset
+
+            out.trans_list.append(out.trans_list_utc[i] + adjustment)
+
+        out.trans_idx = tuple(out.trans_idx)
+        out.trans_list = tuple(out.trans_list)
+        out.trans_list_utc = tuple(out.trans_list_utc)
+
+        return out
+
+    def _find_last_transition(self, dt, in_utc=False):
+        # If there's no list, there are no transitions to find
+        if not self._trans_list:
+            return None
+
+        timestamp = _datetime_to_timestamp(dt)
+
+        # Find where the timestamp fits in the transition list - if the
+        # timestamp is a transition time, it's part of the "after" period.
+        trans_list = self._trans_list_utc if in_utc else self._trans_list
+        idx = bisect.bisect_right(trans_list, timestamp)
+
+        # We want to know when the previous transition was, so subtract off 1
+        return idx - 1
+
+    def _get_ttinfo(self, idx):
+        # For no list or after the last transition, default to _ttinfo_std
+        if idx is None or (idx + 1) >= len(self._trans_list):
+            return self._ttinfo_std
+
+        # If there is a list and the time is before it, return _ttinfo_before
+        if idx < 0:
+            return self._ttinfo_before
+
+        return self._trans_idx[idx]
+
+    def _find_ttinfo(self, dt):
+        idx = self._resolve_ambiguous_time(dt)
+
+        return self._get_ttinfo(idx)
+
+    def fromutc(self, dt):
+        """
+        The ``tzfile`` implementation of :py:func:`datetime.tzinfo.fromutc`.
+
+        :param dt:
+            A :py:class:`datetime.datetime` object.
+
+        :raises TypeError:
+            Raised if ``dt`` is not a :py:class:`datetime.datetime` object.
+
+        :raises ValueError:
+            Raised if this is called with a ``dt`` which does not have this
+            ``tzinfo`` attached.
+
+        :return:
+            Returns a :py:class:`datetime.datetime` object representing the
+            wall time in ``self``'s time zone.
+        """
+        # These isinstance checks are in datetime.tzinfo, so we'll preserve
+        # them, even if we don't care about duck typing.
+        if not isinstance(dt, datetime.datetime):
+            raise TypeError("fromutc() requires a datetime argument")
+
+        if dt.tzinfo is not self:
+            raise ValueError("dt.tzinfo is not self")
+
+        # First treat UTC as wall time and get the transition we're in.
+        idx = self._find_last_transition(dt, in_utc=True)
+        tti = self._get_ttinfo(idx)
+
+        dt_out = dt + datetime.timedelta(seconds=tti.offset)
+
+        fold = self.is_ambiguous(dt_out, idx=idx)
+
+        return enfold(dt_out, fold=int(fold))
+
+    def is_ambiguous(self, dt, idx=None):
+        """
+        Whether or not the "wall time" of a given datetime is ambiguous in this
+        zone.
+
+        :param dt:
+            A :py:class:`datetime.datetime`, naive or time zone aware.
+
+
+        :return:
+            Returns ``True`` if ambiguous, ``False`` otherwise.
+
+        .. versionadded:: 2.6.0
+        """
+        if idx is None:
+            idx = self._find_last_transition(dt)
+
+        # Calculate the difference in offsets from current to previous
+        timestamp = _datetime_to_timestamp(dt)
+        tti = self._get_ttinfo(idx)
+
+        if idx is None or idx <= 0:
+            return False
+
+        od = self._get_ttinfo(idx - 1).offset - tti.offset
+        tt = self._trans_list[idx]          # Transition time
+
+        return timestamp < tt + od
+
+    def _resolve_ambiguous_time(self, dt):
+        idx = self._find_last_transition(dt)
+
+        # If we have no transitions, return the index
+        _fold = self._fold(dt)
+        if idx is None or idx == 0:
+            return idx
+
+        # If it's ambiguous and we're in a fold, shift to a different index.
+        idx_offset = int(not _fold and self.is_ambiguous(dt, idx))
+
+        return idx - idx_offset
+
+    def utcoffset(self, dt):
+        if dt is None:
+            return None
+
+        if not self._ttinfo_std:
+            return ZERO
+
+        return self._find_ttinfo(dt).delta
+
+    def dst(self, dt):
+        if dt is None:
+            return None
+
+        if not self._ttinfo_dst:
+            return ZERO
+
+        tti = self._find_ttinfo(dt)
+
+        if not tti.isdst:
+            return ZERO
+
+        # The documentation says that utcoffset()-dst() must
+        # be constant for every dt.
+        return tti.dstoffset
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        if not self._ttinfo_std or dt is None:
+            return None
+        return self._find_ttinfo(dt).abbr
+
+    def __eq__(self, other):
+        if not isinstance(other, tzfile):
+            return NotImplemented
+        return (self._trans_list == other._trans_list and
+                self._trans_idx == other._trans_idx and
+                self._ttinfo_list == other._ttinfo_list)
+
+    __hash__ = None
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._filename))
+
+    def __reduce__(self):
+        return self.__reduce_ex__(None)
+
+    def __reduce_ex__(self, protocol):
+        return (self.__class__, (None, self._filename), self.__dict__)
+
+
+class tzrange(tzrangebase):
+    """
+    The ``tzrange`` object is a time zone specified by a set of offsets and
+    abbreviations, equivalent to the way the ``TZ`` variable can be specified
+    in POSIX-like systems, but using Python delta objects to specify DST
+    start, end and offsets.
+
+    :param stdabbr:
+        The abbreviation for standard time (e.g. ``'EST'``).
+
+    :param stdoffset:
+        An integer or :class:`datetime.timedelta` object or equivalent
+        specifying the base offset from UTC.
+
+        If unspecified, +00:00 is used.
+
+    :param dstabbr:
+        The abbreviation for DST / "Summer" time (e.g. ``'EDT'``).
+
+        If specified, with no other DST information, DST is assumed to occur
+        and the default behavior or ``dstoffset``, ``start`` and ``end`` is
+        used. If unspecified and no other DST information is specified, it
+        is assumed that this zone has no DST.
+
+        If this is unspecified and other DST information is *is* specified,
+        DST occurs in the zone but the time zone abbreviation is left
+        unchanged.
+
+    :param dstoffset:
+        A an integer or :class:`datetime.timedelta` object or equivalent
+        specifying the UTC offset during DST. If unspecified and any other DST
+        information is specified, it is assumed to be the STD offset +1 hour.
+
+    :param start:
+        A :class:`relativedelta.relativedelta` object or equivalent specifying
+        the time and time of year that daylight savings time starts. To
+        specify, for example, that DST starts at 2AM on the 2nd Sunday in
+        March, pass:
+
+            ``relativedelta(hours=2, month=3, day=1, weekday=SU(+2))``
+
+        If unspecified and any other DST information is specified, the default
+        value is 2 AM on the first Sunday in April.
+
+    :param end:
+        A :class:`relativedelta.relativedelta` object or equivalent
+        representing the time and time of year that daylight savings time
+        ends, with the same specification method as in ``start``. One note is
+        that this should point to the first time in the *standard* zone, so if
+        a transition occurs at 2AM in the DST zone and the clocks are set back
+        1 hour to 1AM, set the ``hours`` parameter to +1.
+
+
+    **Examples:**
+
+    .. testsetup:: tzrange
+
+        from dateutil.tz import tzrange, tzstr
+
+    .. doctest:: tzrange
+
+        >>> tzstr('EST5EDT') == tzrange("EST", -18000, "EDT")
+        True
+
+        >>> from dateutil.relativedelta import *
+        >>> range1 = tzrange("EST", -18000, "EDT")
+        >>> range2 = tzrange("EST", -18000, "EDT", -14400,
+        ...                  relativedelta(hours=+2, month=4, day=1,
+        ...                                weekday=SU(+1)),
+        ...                  relativedelta(hours=+1, month=10, day=31,
+        ...                                weekday=SU(-1)))
+        >>> tzstr('EST5EDT') == range1 == range2
+        True
+
+    """
+    def __init__(self, stdabbr, stdoffset=None,
+                 dstabbr=None, dstoffset=None,
+                 start=None, end=None):
+
+        global relativedelta
+        from dateutil import relativedelta
+
+        self._std_abbr = stdabbr
+        self._dst_abbr = dstabbr
+
+        try:
+            stdoffset = stdoffset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        try:
+            dstoffset = dstoffset.total_seconds()
+        except (TypeError, AttributeError):
+            pass
+
+        if stdoffset is not None:
+            self._std_offset = datetime.timedelta(seconds=stdoffset)
+        else:
+            self._std_offset = ZERO
+
+        if dstoffset is not None:
+            self._dst_offset = datetime.timedelta(seconds=dstoffset)
+        elif dstabbr and stdoffset is not None:
+            self._dst_offset = self._std_offset + datetime.timedelta(hours=+1)
+        else:
+            self._dst_offset = ZERO
+
+        if dstabbr and start is None:
+            self._start_delta = relativedelta.relativedelta(
+                hours=+2, month=4, day=1, weekday=relativedelta.SU(+1))
+        else:
+            self._start_delta = start
+
+        if dstabbr and end is None:
+            self._end_delta = relativedelta.relativedelta(
+                hours=+1, month=10, day=31, weekday=relativedelta.SU(-1))
+        else:
+            self._end_delta = end
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = bool(self._start_delta)
+
+    def transitions(self, year):
+        """
+        For a given year, get the DST on and off transition times, expressed
+        always on the standard time side. For zones with no transitions, this
+        function returns ``None``.
+
+        :param year:
+            The year whose transitions you would like to query.
+
+        :return:
+            Returns a :class:`tuple` of :class:`datetime.datetime` objects,
+            ``(dston, dstoff)`` for zones with an annual DST transition, or
+            ``None`` for fixed offset zones.
+        """
+        if not self.hasdst:
+            return None
+
+        base_year = datetime.datetime(year, 1, 1)
+
+        start = base_year + self._start_delta
+        end = base_year + self._end_delta
+
+        return (start, end)
+
+    def __eq__(self, other):
+        if not isinstance(other, tzrange):
+            return NotImplemented
+
+        return (self._std_abbr == other._std_abbr and
+                self._dst_abbr == other._dst_abbr and
+                self._std_offset == other._std_offset and
+                self._dst_offset == other._dst_offset and
+                self._start_delta == other._start_delta and
+                self._end_delta == other._end_delta)
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_base_offset_
+
+
+@six.add_metaclass(_TzStrFactory)
+class tzstr(tzrange):
+    """
+    ``tzstr`` objects are time zone objects specified by a time-zone string as
+    it would be passed to a ``TZ`` variable on POSIX-style systems (see
+    the `GNU C Library: TZ Variable`_ for more details).
+
+    There is one notable exception, which is that POSIX-style time zones use an
+    inverted offset format, so normally ``GMT+3`` would be parsed as an offset
+    3 hours *behind* GMT. The ``tzstr`` time zone object will parse this as an
+    offset 3 hours *ahead* of GMT. If you would like to maintain the POSIX
+    behavior, pass a ``True`` value to ``posix_offset``.
+
+    The :class:`tzrange` object provides the same functionality, but is
+    specified using :class:`relativedelta.relativedelta` objects. rather than
+    strings.
+
+    :param s:
+        A time zone string in ``TZ`` variable format. This can be a
+        :class:`bytes` (2.x: :class:`str`), :class:`str` (2.x:
+        :class:`unicode`) or a stream emitting unicode characters
+        (e.g. :class:`StringIO`).
+
+    :param posix_offset:
+        Optional. If set to ``True``, interpret strings such as ``GMT+3`` or
+        ``UTC+3`` as being 3 hours *behind* UTC rather than ahead, per the
+        POSIX standard.
+
+    .. caution::
+
+        Prior to version 2.7.0, this function also supported time zones
+        in the format:
+
+            * ``EST5EDT,4,0,6,7200,10,0,26,7200,3600``
+            * ``EST5EDT,4,1,0,7200,10,-1,0,7200,3600``
+
+        This format is non-standard and has been deprecated; this function
+        will raise a :class:`DeprecatedTZFormatWarning` until
+        support is removed in a future version.
+
+    .. _`GNU C Library: TZ Variable`:
+        https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
+    """
+    def __init__(self, s, posix_offset=False):
+        global parser
+        from dateutil.parser import _parser as parser
+
+        self._s = s
+
+        res = parser._parsetz(s)
+        if res is None or res.any_unused_tokens:
+            raise ValueError("unknown string format")
+
+        # Here we break the compatibility with the TZ variable handling.
+        # GMT-3 actually *means* the timezone -3.
+        if res.stdabbr in ("GMT", "UTC") and not posix_offset:
+            res.stdoffset *= -1
+
+        # We must initialize it first, since _delta() needs
+        # _std_offset and _dst_offset set. Use False in start/end
+        # to avoid building it two times.
+        tzrange.__init__(self, res.stdabbr, res.stdoffset,
+                         res.dstabbr, res.dstoffset,
+                         start=False, end=False)
+
+        if not res.dstabbr:
+            self._start_delta = None
+            self._end_delta = None
+        else:
+            self._start_delta = self._delta(res.start)
+            if self._start_delta:
+                self._end_delta = self._delta(res.end, isend=1)
+
+        self.hasdst = bool(self._start_delta)
+
+    def _delta(self, x, isend=0):
+        from dateutil import relativedelta
+        kwargs = {}
+        if x.month is not None:
+            kwargs["month"] = x.month
+            if x.weekday is not None:
+                kwargs["weekday"] = relativedelta.weekday(x.weekday, x.week)
+                if x.week > 0:
+                    kwargs["day"] = 1
+                else:
+                    kwargs["day"] = 31
+            elif x.day:
+                kwargs["day"] = x.day
+        elif x.yday is not None:
+            kwargs["yearday"] = x.yday
+        elif x.jyday is not None:
+            kwargs["nlyearday"] = x.jyday
+        if not kwargs:
+            # Default is to start on first sunday of april, and end
+            # on last sunday of october.
+            if not isend:
+                kwargs["month"] = 4
+                kwargs["day"] = 1
+                kwargs["weekday"] = relativedelta.SU(+1)
+            else:
+                kwargs["month"] = 10
+                kwargs["day"] = 31
+                kwargs["weekday"] = relativedelta.SU(-1)
+        if x.time is not None:
+            kwargs["seconds"] = x.time
+        else:
+            # Default is 2AM.
+            kwargs["seconds"] = 7200
+        if isend:
+            # Convert to standard time, to follow the documented way
+            # of working with the extra hour. See the documentation
+            # of the tzinfo class.
+            delta = self._dst_offset - self._std_offset
+            kwargs["seconds"] -= delta.seconds + delta.days * 86400
+        return relativedelta.relativedelta(**kwargs)
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._s))
+
+
+class _tzicalvtzcomp(object):
+    def __init__(self, tzoffsetfrom, tzoffsetto, isdst,
+                 tzname=None, rrule=None):
+        self.tzoffsetfrom = datetime.timedelta(seconds=tzoffsetfrom)
+        self.tzoffsetto = datetime.timedelta(seconds=tzoffsetto)
+        self.tzoffsetdiff = self.tzoffsetto - self.tzoffsetfrom
+        self.isdst = isdst
+        self.tzname = tzname
+        self.rrule = rrule
+
+
+class _tzicalvtz(_tzinfo):
+    def __init__(self, tzid, comps=[]):
+        super(_tzicalvtz, self).__init__()
+
+        self._tzid = tzid
+        self._comps = comps
+        self._cachedate = []
+        self._cachecomp = []
+        self._cache_lock = _thread.allocate_lock()
+
+    def _find_comp(self, dt):
+        if len(self._comps) == 1:
+            return self._comps[0]
+
+        dt = dt.replace(tzinfo=None)
+
+        try:
+            with self._cache_lock:
+                return self._cachecomp[self._cachedate.index(
+                    (dt, self._fold(dt)))]
+        except ValueError:
+            pass
+
+        lastcompdt = None
+        lastcomp = None
+
+        for comp in self._comps:
+            compdt = self._find_compdt(comp, dt)
+
+            if compdt and (not lastcompdt or lastcompdt < compdt):
+                lastcompdt = compdt
+                lastcomp = comp
+
+        if not lastcomp:
+            # RFC says nothing about what to do when a given
+            # time is before the first onset date. We'll look for the
+            # first standard component, or the first component, if
+            # none is found.
+            for comp in self._comps:
+                if not comp.isdst:
+                    lastcomp = comp
+                    break
+            else:
+                lastcomp = comp[0]
+
+        with self._cache_lock:
+            self._cachedate.insert(0, (dt, self._fold(dt)))
+            self._cachecomp.insert(0, lastcomp)
+
+            if len(self._cachedate) > 10:
+                self._cachedate.pop()
+                self._cachecomp.pop()
+
+        return lastcomp
+
+    def _find_compdt(self, comp, dt):
+        if comp.tzoffsetdiff < ZERO and self._fold(dt):
+            dt -= comp.tzoffsetdiff
+
+        compdt = comp.rrule.before(dt, inc=True)
+
+        return compdt
+
+    def utcoffset(self, dt):
+        if dt is None:
+            return None
+
+        return self._find_comp(dt).tzoffsetto
+
+    def dst(self, dt):
+        comp = self._find_comp(dt)
+        if comp.isdst:
+            return comp.tzoffsetdiff
+        else:
+            return ZERO
+
+    @tzname_in_python2
+    def tzname(self, dt):
+        return self._find_comp(dt).tzname
+
+    def __repr__(self):
+        return "<tzicalvtz %s>" % repr(self._tzid)
+
+    __reduce__ = object.__reduce__
+
+
+class tzical(object):
+    """
+    This object is designed to parse an iCalendar-style ``VTIMEZONE`` structure
+    as set out in `RFC 5545`_ Section 4.6.5 into one or more `tzinfo` objects.
+
+    :param `fileobj`:
+        A file or stream in iCalendar format, which should be UTF-8 encoded
+        with CRLF endings.
+
+    .. _`RFC 5545`: https://tools.ietf.org/html/rfc5545
+    """
+    def __init__(self, fileobj):
+        global rrule
+        from dateutil import rrule
+
+        if isinstance(fileobj, string_types):
+            self._s = fileobj
+            # ical should be encoded in UTF-8 with CRLF
+            fileobj = open(fileobj, 'r')
+        else:
+            self._s = getattr(fileobj, 'name', repr(fileobj))
+            fileobj = _nullcontext(fileobj)
+
+        self._vtz = {}
+
+        with fileobj as fobj:
+            self._parse_rfc(fobj.read())
+
+    def keys(self):
+        """
+        Retrieves the available time zones as a list.
+        """
+        return list(self._vtz.keys())
+
+    def get(self, tzid=None):
+        """
+        Retrieve a :py:class:`datetime.tzinfo` object by its ``tzid``.
+
+        :param tzid:
+            If there is exactly one time zone available, omitting ``tzid``
+            or passing :py:const:`None` value returns it. Otherwise a valid
+            key (which can be retrieved from :func:`keys`) is required.
+
+        :raises ValueError:
+            Raised if ``tzid`` is not specified but there are either more
+            or fewer than 1 zone defined.
+
+        :returns:
+            Returns either a :py:class:`datetime.tzinfo` object representing
+            the relevant time zone or :py:const:`None` if the ``tzid`` was
+            not found.
+        """
+        if tzid is None:
+            if len(self._vtz) == 0:
+                raise ValueError("no timezones defined")
+            elif len(self._vtz) > 1:
+                raise ValueError("more than one timezone available")
+            tzid = next(iter(self._vtz))
+
+        return self._vtz.get(tzid)
+
+    def _parse_offset(self, s):
+        s = s.strip()
+        if not s:
+            raise ValueError("empty offset")
+        if s[0] in ('+', '-'):
+            signal = (-1, +1)[s[0] == '+']
+            s = s[1:]
+        else:
+            signal = +1
+        if len(s) == 4:
+            return (int(s[:2]) * 3600 + int(s[2:]) * 60) * signal
+        elif len(s) == 6:
+            return (int(s[:2]) * 3600 + int(s[2:4]) * 60 + int(s[4:])) * signal
+        else:
+            raise ValueError("invalid offset: " + s)
+
+    def _parse_rfc(self, s):
+        lines = s.splitlines()
+        if not lines:
+            raise ValueError("empty string")
+
+        # Unfold
+        i = 0
+        while i < len(lines):
+            line = lines[i].rstrip()
+            if not line:
+                del lines[i]
+            elif i > 0 and line[0] == " ":
+                lines[i-1] += line[1:]
+                del lines[i]
+            else:
+                i += 1
+
+        tzid = None
+        comps = []
+        invtz = False
+        comptype = None
+        for line in lines:
+            if not line:
+                continue
+            name, value = line.split(':', 1)
+            parms = name.split(';')
+            if not parms:
+                raise ValueError("empty property name")
+            name = parms[0].upper()
+            parms = parms[1:]
+            if invtz:
+                if name == "BEGIN":
+                    if value in ("STANDARD", "DAYLIGHT"):
+                        # Process component
+                        pass
+                    else:
+                        raise ValueError("unknown component: "+value)
+                    comptype = value
+                    founddtstart = False
+                    tzoffsetfrom = None
+                    tzoffsetto = None
+                    rrulelines = []
+                    tzname = None
+                elif name == "END":
+                    if value == "VTIMEZONE":
+                        if comptype:
+                            raise ValueError("component not closed: "+comptype)
+                        if not tzid:
+                            raise ValueError("mandatory TZID not found")
+                        if not comps:
+                            raise ValueError(
+                                "at least one component is needed")
+                        # Process vtimezone
+                        self._vtz[tzid] = _tzicalvtz(tzid, comps)
+                        invtz = False
+                    elif value == comptype:
+                        if not founddtstart:
+                            raise ValueError("mandatory DTSTART not found")
+                        if tzoffsetfrom is None:
+                            raise ValueError(
+                                "mandatory TZOFFSETFROM not found")
+                        if tzoffsetto is None:
+                            raise ValueError(
+                                "mandatory TZOFFSETFROM not found")
+                        # Process component
+                        rr = None
+                        if rrulelines:
+                            rr = rrule.rrulestr("\n".join(rrulelines),
+                                                compatible=True,
+                                                ignoretz=True,
+                                                cache=True)
+                        comp = _tzicalvtzcomp(tzoffsetfrom, tzoffsetto,
+                                              (comptype == "DAYLIGHT"),
+                                              tzname, rr)
+                        comps.append(comp)
+                        comptype = None
+                    else:
+                        raise ValueError("invalid component end: "+value)
+                elif comptype:
+                    if name == "DTSTART":
+                        # DTSTART in VTIMEZONE takes a subset of valid RRULE
+                        # values under RFC 5545.
+                        for parm in parms:
+                            if parm != 'VALUE=DATE-TIME':
+                                msg = ('Unsupported DTSTART param in ' +
+                                       'VTIMEZONE: ' + parm)
+                                raise ValueError(msg)
+                        rrulelines.append(line)
+                        founddtstart = True
+                    elif name in ("RRULE", "RDATE", "EXRULE", "EXDATE"):
+                        rrulelines.append(line)
+                    elif name == "TZOFFSETFROM":
+                        if parms:
+                            raise ValueError(
+                                "unsupported %s parm: %s " % (name, parms[0]))
+                        tzoffsetfrom = self._parse_offset(value)
+                    elif name == "TZOFFSETTO":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZOFFSETTO parm: "+parms[0])
+                        tzoffsetto = self._parse_offset(value)
+                    elif name == "TZNAME":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZNAME parm: "+parms[0])
+                        tzname = value
+                    elif name == "COMMENT":
+                        pass
+                    else:
+                        raise ValueError("unsupported property: "+name)
+                else:
+                    if name == "TZID":
+                        if parms:
+                            raise ValueError(
+                                "unsupported TZID parm: "+parms[0])
+                        tzid = value
+                    elif name in ("TZURL", "LAST-MODIFIED", "COMMENT"):
+                        pass
+                    else:
+                        raise ValueError("unsupported property: "+name)
+            elif name == "BEGIN" and value == "VTIMEZONE":
+                tzid = None
+                comps = []
+                invtz = True
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, repr(self._s))
+
+
+if sys.platform != "win32":
+    TZFILES = ["/etc/localtime", "localtime"]
+    TZPATHS = ["/usr/share/zoneinfo",
+               "/usr/lib/zoneinfo",
+               "/usr/share/lib/zoneinfo",
+               "/etc/zoneinfo"]
+else:
+    TZFILES = []
+    TZPATHS = []
+
+
+def __get_gettz():
+    tzlocal_classes = (tzlocal,)
+    if tzwinlocal is not None:
+        tzlocal_classes += (tzwinlocal,)
+
+    class GettzFunc(object):
+        """
+        Retrieve a time zone object from a string representation
+
+        This function is intended to retrieve the :py:class:`tzinfo` subclass
+        that best represents the time zone that would be used if a POSIX
+        `TZ variable`_ were set to the same value.
+
+        If no argument or an empty string is passed to ``gettz``, local time
+        is returned:
+
+        .. code-block:: python3
+
+            >>> gettz()
+            tzfile('/etc/localtime')
+
+        This function is also the preferred way to map IANA tz database keys
+        to :class:`tzfile` objects:
+
+        .. code-block:: python3
+
+            >>> gettz('Pacific/Kiritimati')
+            tzfile('/usr/share/zoneinfo/Pacific/Kiritimati')
+
+        On Windows, the standard is extended to include the Windows-specific
+        zone names provided by the operating system:
+
+        .. code-block:: python3
+
+            >>> gettz('Egypt Standard Time')
+            tzwin('Egypt Standard Time')
+
+        Passing a GNU ``TZ`` style string time zone specification returns a
+        :class:`tzstr` object:
+
+        .. code-block:: python3
+
+            >>> gettz('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
+            tzstr('AEST-10AEDT-11,M10.1.0/2,M4.1.0/3')
+
+        :param name:
+            A time zone name (IANA, or, on Windows, Windows keys), location of
+            a ``tzfile(5)`` zoneinfo file or ``TZ`` variable style time zone
+            specifier. An empty string, no argument or ``None`` is interpreted
+            as local time.
+
+        :return:
+            Returns an instance of one of ``dateutil``'s :py:class:`tzinfo`
+            subclasses.
+
+        .. versionchanged:: 2.7.0
+
+            After version 2.7.0, any two calls to ``gettz`` using the same
+            input strings will return the same object:
+
+            .. code-block:: python3
+
+                >>> tz.gettz('America/Chicago') is tz.gettz('America/Chicago')
+                True
+
+            In addition to improving performance, this ensures that
+            `"same zone" semantics`_ are used for datetimes in the same zone.
+
+
+        .. _`TZ variable`:
+            https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
+
+        .. _`"same zone" semantics`:
+            https://blog.ganssle.io/articles/2018/02/aware-datetime-arithmetic.html
+        """
+        def __init__(self):
+
+            self.__instances = weakref.WeakValueDictionary()
+            self.__strong_cache_size = 8
+            self.__strong_cache = OrderedDict()
+            self._cache_lock = _thread.allocate_lock()
+
+        def __call__(self, name=None):
+            with self._cache_lock:
+                rv = self.__instances.get(name, None)
+
+                if rv is None:
+                    rv = self.nocache(name=name)
+                    if not (name is None
+                            or isinstance(rv, tzlocal_classes)
+                            or rv is None):
+                        # tzlocal is slightly more complicated than the other
+                        # time zone providers because it depends on environment
+                        # at construction time, so don't cache that.
+                        #
+                        # We also cannot store weak references to None, so we
+                        # will also not store that.
+                        self.__instances[name] = rv
+                    else:
+                        # No need for strong caching, return immediately
+                        return rv
+
+                self.__strong_cache[name] = self.__strong_cache.pop(name, rv)
+
+                if len(self.__strong_cache) > self.__strong_cache_size:
+                    self.__strong_cache.popitem(last=False)
+
+            return rv
+
+        def set_cache_size(self, size):
+            with self._cache_lock:
+                self.__strong_cache_size = size
+                while len(self.__strong_cache) > size:
+                    self.__strong_cache.popitem(last=False)
+
+        def cache_clear(self):
+            with self._cache_lock:
+                self.__instances = weakref.WeakValueDictionary()
+                self.__strong_cache.clear()
+
+        @staticmethod
+        def nocache(name=None):
+            """A non-cached version of gettz"""
+            tz = None
+            if not name:
+                try:
+                    name = os.environ["TZ"]
+                except KeyError:
+                    pass
+            if name is None or name == ":":
+                for filepath in TZFILES:
+                    if not os.path.isabs(filepath):
+                        filename = filepath
+                        for path in TZPATHS:
+                            filepath = os.path.join(path, filename)
+                            if os.path.isfile(filepath):
+                                break
+                        else:
+                            continue
+                    if os.path.isfile(filepath):
+                        try:
+                            tz = tzfile(filepath)
+                            break
+                        except (IOError, OSError, ValueError):
+                            pass
+                else:
+                    tz = tzlocal()
+            else:
+                try:
+                    if name.startswith(":"):
+                        name = name[1:]
+                except TypeError as e:
+                    if isinstance(name, bytes):
+                        new_msg = "gettz argument should be str, not bytes"
+                        six.raise_from(TypeError(new_msg), e)
+                    else:
+                        raise
+                if os.path.isabs(name):
+                    if os.path.isfile(name):
+                        tz = tzfile(name)
+                    else:
+                        tz = None
+                else:
+                    for path in TZPATHS:
+                        filepath = os.path.join(path, name)
+                        if not os.path.isfile(filepath):
+                            filepath = filepath.replace(' ', '_')
+                            if not os.path.isfile(filepath):
+                                continue
+                        try:
+                            tz = tzfile(filepath)
+                            break
+                        except (IOError, OSError, ValueError):
+                            pass
+                    else:
+                        tz = None
+                        if tzwin is not None:
+                            try:
+                                tz = tzwin(name)
+                            except (WindowsError, UnicodeEncodeError):
+                                # UnicodeEncodeError is for Python 2.7 compat
+                                tz = None
+
+                        if not tz:
+                            from dateutil.zoneinfo import get_zonefile_instance
+                            tz = get_zonefile_instance().get(name)
+
+                        if not tz:
+                            for c in name:
+                                # name is not a tzstr unless it has at least
+                                # one offset. For short values of "name", an
+                                # explicit for loop seems to be the fastest way
+                                # To determine if a string contains a digit
+                                if c in "0123456789":
+                                    try:
+                                        tz = tzstr(name)
+                                    except ValueError:
+                                        pass
+                                    break
+                            else:
+                                if name in ("GMT", "UTC"):
+                                    tz = UTC
+                                elif name in time.tzname:
+                                    tz = tzlocal()
+            return tz
+
+    return GettzFunc()
+
+
+gettz = __get_gettz()
+del __get_gettz
+
+
+def datetime_exists(dt, tz=None):
+    """
+    Given a datetime and a time zone, determine whether or not a given datetime
+    would fall in a gap.
+
+    :param dt:
+        A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
+        is provided.)
+
+    :param tz:
+        A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
+        ``None`` or not provided, the datetime's own time zone will be used.
+
+    :return:
+        Returns a boolean value whether or not the "wall time" exists in
+        ``tz``.
+
+    .. versionadded:: 2.7.0
+    """
+    if tz is None:
+        if dt.tzinfo is None:
+            raise ValueError('Datetime is naive and no time zone provided.')
+        tz = dt.tzinfo
+
+    dt = dt.replace(tzinfo=None)
+
+    # This is essentially a test of whether or not the datetime can survive
+    # a round trip to UTC.
+    dt_rt = dt.replace(tzinfo=tz).astimezone(UTC).astimezone(tz)
+    dt_rt = dt_rt.replace(tzinfo=None)
+
+    return dt == dt_rt
+
+
+def datetime_ambiguous(dt, tz=None):
+    """
+    Given a datetime and a time zone, determine whether or not a given datetime
+    is ambiguous (i.e if there are two times differentiated only by their DST
+    status).
+
+    :param dt:
+        A :class:`datetime.datetime` (whose time zone will be ignored if ``tz``
+        is provided.)
+
+    :param tz:
+        A :class:`datetime.tzinfo` with support for the ``fold`` attribute. If
+        ``None`` or not provided, the datetime's own time zone will be used.
+
+    :return:
+        Returns a boolean value whether or not the "wall time" is ambiguous in
+        ``tz``.
+
+    .. versionadded:: 2.6.0
+    """
+    if tz is None:
+        if dt.tzinfo is None:
+            raise ValueError('Datetime is naive and no time zone provided.')
+
+        tz = dt.tzinfo
+
+    # If a time zone defines its own "is_ambiguous" function, we'll use that.
+    is_ambiguous_fn = getattr(tz, 'is_ambiguous', None)
+    if is_ambiguous_fn is not None:
+        try:
+            return tz.is_ambiguous(dt)
+        except Exception:
+            pass
+
+    # If it doesn't come out and tell us it's ambiguous, we'll just check if
+    # the fold attribute has any effect on this particular date and time.
+    dt = dt.replace(tzinfo=tz)
+    wall_0 = enfold(dt, fold=0)
+    wall_1 = enfold(dt, fold=1)
+
+    same_offset = wall_0.utcoffset() == wall_1.utcoffset()
+    same_dst = wall_0.dst() == wall_1.dst()
+
+    return not (same_offset and same_dst)
+
+
+def resolve_imaginary(dt):
+    """
+    Given a datetime that may be imaginary, return an existing datetime.
+
+    This function assumes that an imaginary datetime represents what the
+    wall time would be in a zone had the offset transition not occurred, so
+    it will always fall forward by the transition's change in offset.
+
+    .. doctest::
+
+        >>> from dateutil import tz
+        >>> from datetime import datetime
+        >>> NYC = tz.gettz('America/New_York')
+        >>> print(tz.resolve_imaginary(datetime(2017, 3, 12, 2, 30, tzinfo=NYC)))
+        2017-03-12 03:30:00-04:00
+
+        >>> KIR = tz.gettz('Pacific/Kiritimati')
+        >>> print(tz.resolve_imaginary(datetime(1995, 1, 1, 12, 30, tzinfo=KIR)))
+        1995-01-02 12:30:00+14:00
+
+    As a note, :func:`datetime.astimezone` is guaranteed to produce a valid,
+    existing datetime, so a round-trip to and from UTC is sufficient to get
+    an extant datetime, however, this generally "falls back" to an earlier time
+    rather than falling forward to the STD side (though no guarantees are made
+    about this behavior).
+
+    :param dt:
+        A :class:`datetime.datetime` which may or may not exist.
+
+    :return:
+        Returns an existing :class:`datetime.datetime`. If ``dt`` was not
+        imaginary, the datetime returned is guaranteed to be the same object
+        passed to the function.
+
+    .. versionadded:: 2.7.0
+    """
+    if dt.tzinfo is not None and not datetime_exists(dt):
+
+        curr_offset = (dt + datetime.timedelta(hours=24)).utcoffset()
+        old_offset = (dt - datetime.timedelta(hours=24)).utcoffset()
+
+        dt += curr_offset - old_offset
+
+    return dt
+
+
+def _datetime_to_timestamp(dt):
+    """
+    Convert a :class:`datetime.datetime` object to an epoch timestamp in
+    seconds since January 1, 1970, ignoring the time zone.
+    """
+    return (dt.replace(tzinfo=None) - EPOCH).total_seconds()
+
+
+if sys.version_info >= (3, 6):
+    def _get_supported_offset(second_offset):
+        return second_offset
+else:
+    def _get_supported_offset(second_offset):
+        # For python pre-3.6, round to full-minutes if that's not the case.
+        # Python's datetime doesn't accept sub-minute timezones. Check
+        # http://python.org/sf/1447945 or https://bugs.python.org/issue5288
+        # for some information.
+        old_offset = second_offset
+        calculated_offset = 60 * ((second_offset + 30) // 60)
+        return calculated_offset
+
+
+try:
+    # Python 3.7 feature
+    from contextlib import nullcontext as _nullcontext
+except ImportError:
+    class _nullcontext(object):
+        """
+        Class for wrapping contexts so that they are passed through in a
+        with statement.
+        """
+        def __init__(self, context):
+            self.context = context
+
+        def __enter__(self):
+            return self.context
+
+        def __exit__(*args, **kwargs):
+            pass
+
+# vim:ts=4:sw=4:et
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/win.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/win.py
new file mode 100644
index 0000000000000000000000000000000000000000..cde07ba792c40903f0c334839140173b39fd8124
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tz/win.py
@@ -0,0 +1,370 @@
+# -*- coding: utf-8 -*-
+"""
+This module provides an interface to the native time zone data on Windows,
+including :py:class:`datetime.tzinfo` implementations.
+
+Attempting to import this module on a non-Windows platform will raise an
+:py:obj:`ImportError`.
+"""
+# This code was originally contributed by Jeffrey Harris.
+import datetime
+import struct
+
+from six.moves import winreg
+from six import text_type
+
+try:
+    import ctypes
+    from ctypes import wintypes
+except ValueError:
+    # ValueError is raised on non-Windows systems for some horrible reason.
+    raise ImportError("Running tzwin on non-Windows system")
+
+from ._common import tzrangebase
+
+__all__ = ["tzwin", "tzwinlocal", "tzres"]
+
+ONEWEEK = datetime.timedelta(7)
+
+TZKEYNAMENT = r"SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones"
+TZKEYNAME9X = r"SOFTWARE\Microsoft\Windows\CurrentVersion\Time Zones"
+TZLOCALKEYNAME = r"SYSTEM\CurrentControlSet\Control\TimeZoneInformation"
+
+
+def _settzkeyname():
+    handle = winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE)
+    try:
+        winreg.OpenKey(handle, TZKEYNAMENT).Close()
+        TZKEYNAME = TZKEYNAMENT
+    except WindowsError:
+        TZKEYNAME = TZKEYNAME9X
+    handle.Close()
+    return TZKEYNAME
+
+
+TZKEYNAME = _settzkeyname()
+
+
+class tzres(object):
+    """
+    Class for accessing ``tzres.dll``, which contains timezone name related
+    resources.
+
+    .. versionadded:: 2.5.0
+    """
+    p_wchar = ctypes.POINTER(wintypes.WCHAR)        # Pointer to a wide char
+
+    def __init__(self, tzres_loc='tzres.dll'):
+        # Load the user32 DLL so we can load strings from tzres
+        user32 = ctypes.WinDLL('user32')
+
+        # Specify the LoadStringW function
+        user32.LoadStringW.argtypes = (wintypes.HINSTANCE,
+                                       wintypes.UINT,
+                                       wintypes.LPWSTR,
+                                       ctypes.c_int)
+
+        self.LoadStringW = user32.LoadStringW
+        self._tzres = ctypes.WinDLL(tzres_loc)
+        self.tzres_loc = tzres_loc
+
+    def load_name(self, offset):
+        """
+        Load a timezone name from a DLL offset (integer).
+
+        >>> from dateutil.tzwin import tzres
+        >>> tzr = tzres()
+        >>> print(tzr.load_name(112))
+        'Eastern Standard Time'
+
+        :param offset:
+            A positive integer value referring to a string from the tzres dll.
+
+        .. note::
+
+            Offsets found in the registry are generally of the form
+            ``@tzres.dll,-114``. The offset in this case is 114, not -114.
+
+        """
+        resource = self.p_wchar()
+        lpBuffer = ctypes.cast(ctypes.byref(resource), wintypes.LPWSTR)
+        nchar = self.LoadStringW(self._tzres._handle, offset, lpBuffer, 0)
+        return resource[:nchar]
+
+    def name_from_string(self, tzname_str):
+        """
+        Parse strings as returned from the Windows registry into the time zone
+        name as defined in the registry.
+
+        >>> from dateutil.tzwin import tzres
+        >>> tzr = tzres()
+        >>> print(tzr.name_from_string('@tzres.dll,-251'))
+        'Dateline Daylight Time'
+        >>> print(tzr.name_from_string('Eastern Standard Time'))
+        'Eastern Standard Time'
+
+        :param tzname_str:
+            A timezone name string as returned from a Windows registry key.
+
+        :return:
+            Returns the localized timezone string from tzres.dll if the string
+            is of the form `@tzres.dll,-offset`, else returns the input string.
+        """
+        if not tzname_str.startswith('@'):
+            return tzname_str
+
+        name_splt = tzname_str.split(',-')
+        try:
+            offset = int(name_splt[1])
+        except:
+            raise ValueError("Malformed timezone string.")
+
+        return self.load_name(offset)
+
+
+class tzwinbase(tzrangebase):
+    """tzinfo class based on win32's timezones available in the registry."""
+    def __init__(self):
+        raise NotImplementedError('tzwinbase is an abstract base class')
+
+    def __eq__(self, other):
+        # Compare on all relevant dimensions, including name.
+        if not isinstance(other, tzwinbase):
+            return NotImplemented
+
+        return  (self._std_offset == other._std_offset and
+                 self._dst_offset == other._dst_offset and
+                 self._stddayofweek == other._stddayofweek and
+                 self._dstdayofweek == other._dstdayofweek and
+                 self._stdweeknumber == other._stdweeknumber and
+                 self._dstweeknumber == other._dstweeknumber and
+                 self._stdhour == other._stdhour and
+                 self._dsthour == other._dsthour and
+                 self._stdminute == other._stdminute and
+                 self._dstminute == other._dstminute and
+                 self._std_abbr == other._std_abbr and
+                 self._dst_abbr == other._dst_abbr)
+
+    @staticmethod
+    def list():
+        """Return a list of all time zones known to the system."""
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            with winreg.OpenKey(handle, TZKEYNAME) as tzkey:
+                result = [winreg.EnumKey(tzkey, i)
+                          for i in range(winreg.QueryInfoKey(tzkey)[0])]
+        return result
+
+    def display(self):
+        """
+        Return the display name of the time zone.
+        """
+        return self._display
+
+    def transitions(self, year):
+        """
+        For a given year, get the DST on and off transition times, expressed
+        always on the standard time side. For zones with no transitions, this
+        function returns ``None``.
+
+        :param year:
+            The year whose transitions you would like to query.
+
+        :return:
+            Returns a :class:`tuple` of :class:`datetime.datetime` objects,
+            ``(dston, dstoff)`` for zones with an annual DST transition, or
+            ``None`` for fixed offset zones.
+        """
+
+        if not self.hasdst:
+            return None
+
+        dston = picknthweekday(year, self._dstmonth, self._dstdayofweek,
+                               self._dsthour, self._dstminute,
+                               self._dstweeknumber)
+
+        dstoff = picknthweekday(year, self._stdmonth, self._stddayofweek,
+                                self._stdhour, self._stdminute,
+                                self._stdweeknumber)
+
+        # Ambiguous dates default to the STD side
+        dstoff -= self._dst_base_offset
+
+        return dston, dstoff
+
+    def _get_hasdst(self):
+        return self._dstmonth != 0
+
+    @property
+    def _dst_base_offset(self):
+        return self._dst_base_offset_
+
+
+class tzwin(tzwinbase):
+    """
+    Time zone object created from the zone info in the Windows registry
+
+    These are similar to :py:class:`dateutil.tz.tzrange` objects in that
+    the time zone data is provided in the format of a single offset rule
+    for either 0 or 2 time zone transitions per year.
+
+    :param: name
+        The name of a Windows time zone key, e.g. "Eastern Standard Time".
+        The full list of keys can be retrieved with :func:`tzwin.list`.
+    """
+
+    def __init__(self, name):
+        self._name = name
+
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            tzkeyname = text_type("{kn}\\{name}").format(kn=TZKEYNAME, name=name)
+            with winreg.OpenKey(handle, tzkeyname) as tzkey:
+                keydict = valuestodict(tzkey)
+
+        self._std_abbr = keydict["Std"]
+        self._dst_abbr = keydict["Dlt"]
+
+        self._display = keydict["Display"]
+
+        # See http://ww_winreg.jsiinc.com/SUBA/tip0300/rh0398.htm
+        tup = struct.unpack("=3l16h", keydict["TZI"])
+        stdoffset = -tup[0]-tup[1]          # Bias + StandardBias * -1
+        dstoffset = stdoffset-tup[2]        # + DaylightBias * -1
+        self._std_offset = datetime.timedelta(minutes=stdoffset)
+        self._dst_offset = datetime.timedelta(minutes=dstoffset)
+
+        # for the meaning see the win32 TIME_ZONE_INFORMATION structure docs
+        # http://msdn.microsoft.com/en-us/library/windows/desktop/ms725481(v=vs.85).aspx
+        (self._stdmonth,
+         self._stddayofweek,   # Sunday = 0
+         self._stdweeknumber,  # Last = 5
+         self._stdhour,
+         self._stdminute) = tup[4:9]
+
+        (self._dstmonth,
+         self._dstdayofweek,   # Sunday = 0
+         self._dstweeknumber,  # Last = 5
+         self._dsthour,
+         self._dstminute) = tup[12:17]
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = self._get_hasdst()
+
+    def __repr__(self):
+        return "tzwin(%s)" % repr(self._name)
+
+    def __reduce__(self):
+        return (self.__class__, (self._name,))
+
+
+class tzwinlocal(tzwinbase):
+    """
+    Class representing the local time zone information in the Windows registry
+
+    While :class:`dateutil.tz.tzlocal` makes system calls (via the :mod:`time`
+    module) to retrieve time zone information, ``tzwinlocal`` retrieves the
+    rules directly from the Windows registry and creates an object like
+    :class:`dateutil.tz.tzwin`.
+
+    Because Windows does not have an equivalent of :func:`time.tzset`, on
+    Windows, :class:`dateutil.tz.tzlocal` instances will always reflect the
+    time zone settings *at the time that the process was started*, meaning
+    changes to the machine's time zone settings during the run of a program
+    on Windows will **not** be reflected by :class:`dateutil.tz.tzlocal`.
+    Because ``tzwinlocal`` reads the registry directly, it is unaffected by
+    this issue.
+    """
+    def __init__(self):
+        with winreg.ConnectRegistry(None, winreg.HKEY_LOCAL_MACHINE) as handle:
+            with winreg.OpenKey(handle, TZLOCALKEYNAME) as tzlocalkey:
+                keydict = valuestodict(tzlocalkey)
+
+            self._std_abbr = keydict["StandardName"]
+            self._dst_abbr = keydict["DaylightName"]
+
+            try:
+                tzkeyname = text_type('{kn}\\{sn}').format(kn=TZKEYNAME,
+                                                          sn=self._std_abbr)
+                with winreg.OpenKey(handle, tzkeyname) as tzkey:
+                    _keydict = valuestodict(tzkey)
+                    self._display = _keydict["Display"]
+            except OSError:
+                self._display = None
+
+        stdoffset = -keydict["Bias"]-keydict["StandardBias"]
+        dstoffset = stdoffset-keydict["DaylightBias"]
+
+        self._std_offset = datetime.timedelta(minutes=stdoffset)
+        self._dst_offset = datetime.timedelta(minutes=dstoffset)
+
+        # For reasons unclear, in this particular key, the day of week has been
+        # moved to the END of the SYSTEMTIME structure.
+        tup = struct.unpack("=8h", keydict["StandardStart"])
+
+        (self._stdmonth,
+         self._stdweeknumber,  # Last = 5
+         self._stdhour,
+         self._stdminute) = tup[1:5]
+
+        self._stddayofweek = tup[7]
+
+        tup = struct.unpack("=8h", keydict["DaylightStart"])
+
+        (self._dstmonth,
+         self._dstweeknumber,  # Last = 5
+         self._dsthour,
+         self._dstminute) = tup[1:5]
+
+        self._dstdayofweek = tup[7]
+
+        self._dst_base_offset_ = self._dst_offset - self._std_offset
+        self.hasdst = self._get_hasdst()
+
+    def __repr__(self):
+        return "tzwinlocal()"
+
+    def __str__(self):
+        # str will return the standard name, not the daylight name.
+        return "tzwinlocal(%s)" % repr(self._std_abbr)
+
+    def __reduce__(self):
+        return (self.__class__, ())
+
+
+def picknthweekday(year, month, dayofweek, hour, minute, whichweek):
+    """ dayofweek == 0 means Sunday, whichweek 5 means last instance """
+    first = datetime.datetime(year, month, 1, hour, minute)
+
+    # This will work if dayofweek is ISO weekday (1-7) or Microsoft-style (0-6),
+    # Because 7 % 7 = 0
+    weekdayone = first.replace(day=((dayofweek - first.isoweekday()) % 7) + 1)
+    wd = weekdayone + ((whichweek - 1) * ONEWEEK)
+    if (wd.month != month):
+        wd -= ONEWEEK
+
+    return wd
+
+
+def valuestodict(key):
+    """Convert a registry key's values to a dictionary."""
+    dout = {}
+    size = winreg.QueryInfoKey(key)[1]
+    tz_res = None
+
+    for i in range(size):
+        key_name, value, dtype = winreg.EnumValue(key, i)
+        if dtype == winreg.REG_DWORD or dtype == winreg.REG_DWORD_LITTLE_ENDIAN:
+            # If it's a DWORD (32-bit integer), it's stored as unsigned - convert
+            # that to a proper signed integer
+            if value & (1 << 31):
+                value = value - (1 << 32)
+        elif dtype == winreg.REG_SZ:
+            # If it's a reference to the tzres DLL, load the actual string
+            if value.startswith('@tzres'):
+                tz_res = tz_res or tzres()
+                value = tz_res.name_from_string(value)
+
+            value = value.rstrip('\x00')    # Remove trailing nulls
+
+        dout[key_name] = value
+
+    return dout
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tzwin.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tzwin.py
new file mode 100644
index 0000000000000000000000000000000000000000..cebc673e40fc376653ebf037e96f0a6d0b33e906
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/tzwin.py
@@ -0,0 +1,2 @@
+# tzwin has moved to dateutil.tz.win
+from .tz.win import *
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..44d9c99455f0147cd5cd38fa41e758f6638d1f1c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/utils.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+"""
+This module offers general convenience and utility functions for dealing with
+datetimes.
+
+.. versionadded:: 2.7.0
+"""
+from __future__ import unicode_literals
+
+from datetime import datetime, time
+
+
+def today(tzinfo=None):
+    """
+    Returns a :py:class:`datetime` representing the current day at midnight
+
+    :param tzinfo:
+        The time zone to attach (also used to determine the current day).
+
+    :return:
+        A :py:class:`datetime.datetime` object representing the current day
+        at midnight.
+    """
+
+    dt = datetime.now(tzinfo)
+    return datetime.combine(dt.date(), time(0, tzinfo=tzinfo))
+
+
+def default_tzinfo(dt, tzinfo):
+    """
+    Sets the ``tzinfo`` parameter on naive datetimes only
+
+    This is useful for example when you are provided a datetime that may have
+    either an implicit or explicit time zone, such as when parsing a time zone
+    string.
+
+    .. doctest::
+
+        >>> from dateutil.tz import tzoffset
+        >>> from dateutil.parser import parse
+        >>> from dateutil.utils import default_tzinfo
+        >>> dflt_tz = tzoffset("EST", -18000)
+        >>> print(default_tzinfo(parse('2014-01-01 12:30 UTC'), dflt_tz))
+        2014-01-01 12:30:00+00:00
+        >>> print(default_tzinfo(parse('2014-01-01 12:30'), dflt_tz))
+        2014-01-01 12:30:00-05:00
+
+    :param dt:
+        The datetime on which to replace the time zone
+
+    :param tzinfo:
+        The :py:class:`datetime.tzinfo` subclass instance to assign to
+        ``dt`` if (and only if) it is naive.
+
+    :return:
+        Returns an aware :py:class:`datetime.datetime`.
+    """
+    if dt.tzinfo is not None:
+        return dt
+    else:
+        return dt.replace(tzinfo=tzinfo)
+
+
+def within_delta(dt1, dt2, delta):
+    """
+    Useful for comparing two datetimes that may a negilible difference
+    to be considered equal.
+    """
+    delta = abs(delta)
+    difference = dt1 - dt2
+    return -delta <= difference <= delta
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..34f11ad66c88047f2c049a4cdcc937b4b78ea6d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/__init__.py
@@ -0,0 +1,167 @@
+# -*- coding: utf-8 -*-
+import warnings
+import json
+
+from tarfile import TarFile
+from pkgutil import get_data
+from io import BytesIO
+
+from dateutil.tz import tzfile as _tzfile
+
+__all__ = ["get_zonefile_instance", "gettz", "gettz_db_metadata"]
+
+ZONEFILENAME = "dateutil-zoneinfo.tar.gz"
+METADATA_FN = 'METADATA'
+
+
+class tzfile(_tzfile):
+    def __reduce__(self):
+        return (gettz, (self._filename,))
+
+
+def getzoneinfofile_stream():
+    try:
+        return BytesIO(get_data(__name__, ZONEFILENAME))
+    except IOError as e:  # TODO  switch to FileNotFoundError?
+        warnings.warn("I/O error({0}): {1}".format(e.errno, e.strerror))
+        return None
+
+
+class ZoneInfoFile(object):
+    def __init__(self, zonefile_stream=None):
+        if zonefile_stream is not None:
+            with TarFile.open(fileobj=zonefile_stream) as tf:
+                self.zones = {zf.name: tzfile(tf.extractfile(zf), filename=zf.name)
+                              for zf in tf.getmembers()
+                              if zf.isfile() and zf.name != METADATA_FN}
+                # deal with links: They'll point to their parent object. Less
+                # waste of memory
+                links = {zl.name: self.zones[zl.linkname]
+                         for zl in tf.getmembers() if
+                         zl.islnk() or zl.issym()}
+                self.zones.update(links)
+                try:
+                    metadata_json = tf.extractfile(tf.getmember(METADATA_FN))
+                    metadata_str = metadata_json.read().decode('UTF-8')
+                    self.metadata = json.loads(metadata_str)
+                except KeyError:
+                    # no metadata in tar file
+                    self.metadata = None
+        else:
+            self.zones = {}
+            self.metadata = None
+
+    def get(self, name, default=None):
+        """
+        Wrapper for :func:`ZoneInfoFile.zones.get`. This is a convenience method
+        for retrieving zones from the zone dictionary.
+
+        :param name:
+            The name of the zone to retrieve. (Generally IANA zone names)
+
+        :param default:
+            The value to return in the event of a missing key.
+
+        .. versionadded:: 2.6.0
+
+        """
+        return self.zones.get(name, default)
+
+
+# The current API has gettz as a module function, although in fact it taps into
+# a stateful class. So as a workaround for now, without changing the API, we
+# will create a new "global" class instance the first time a user requests a
+# timezone. Ugly, but adheres to the api.
+#
+# TODO: Remove after deprecation period.
+_CLASS_ZONE_INSTANCE = []
+
+
+def get_zonefile_instance(new_instance=False):
+    """
+    This is a convenience function which provides a :class:`ZoneInfoFile`
+    instance using the data provided by the ``dateutil`` package. By default, it
+    caches a single instance of the ZoneInfoFile object and returns that.
+
+    :param new_instance:
+        If ``True``, a new instance of :class:`ZoneInfoFile` is instantiated and
+        used as the cached instance for the next call. Otherwise, new instances
+        are created only as necessary.
+
+    :return:
+        Returns a :class:`ZoneInfoFile` object.
+
+    .. versionadded:: 2.6
+    """
+    if new_instance:
+        zif = None
+    else:
+        zif = getattr(get_zonefile_instance, '_cached_instance', None)
+
+    if zif is None:
+        zif = ZoneInfoFile(getzoneinfofile_stream())
+
+        get_zonefile_instance._cached_instance = zif
+
+    return zif
+
+
+def gettz(name):
+    """
+    This retrieves a time zone from the local zoneinfo tarball that is packaged
+    with dateutil.
+
+    :param name:
+        An IANA-style time zone name, as found in the zoneinfo file.
+
+    :return:
+        Returns a :class:`dateutil.tz.tzfile` time zone object.
+
+    .. warning::
+        It is generally inadvisable to use this function, and it is only
+        provided for API compatibility with earlier versions. This is *not*
+        equivalent to ``dateutil.tz.gettz()``, which selects an appropriate
+        time zone based on the inputs, favoring system zoneinfo. This is ONLY
+        for accessing the dateutil-specific zoneinfo (which may be out of
+        date compared to the system zoneinfo).
+
+    .. deprecated:: 2.6
+        If you need to use a specific zoneinfofile over the system zoneinfo,
+        instantiate a :class:`dateutil.zoneinfo.ZoneInfoFile` object and call
+        :func:`dateutil.zoneinfo.ZoneInfoFile.get(name)` instead.
+
+        Use :func:`get_zonefile_instance` to retrieve an instance of the
+        dateutil-provided zoneinfo.
+    """
+    warnings.warn("zoneinfo.gettz() will be removed in future versions, "
+                  "to use the dateutil-provided zoneinfo files, instantiate a "
+                  "ZoneInfoFile object and use ZoneInfoFile.zones.get() "
+                  "instead. See the documentation for details.",
+                  DeprecationWarning)
+
+    if len(_CLASS_ZONE_INSTANCE) == 0:
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+    return _CLASS_ZONE_INSTANCE[0].zones.get(name)
+
+
+def gettz_db_metadata():
+    """ Get the zonefile metadata
+
+    See `zonefile_metadata`_
+
+    :returns:
+        A dictionary with the database metadata
+
+    .. deprecated:: 2.6
+        See deprecation warning in :func:`zoneinfo.gettz`. To get metadata,
+        query the attribute ``zoneinfo.ZoneInfoFile.metadata``.
+    """
+    warnings.warn("zoneinfo.gettz_db_metadata() will be removed in future "
+                  "versions, to use the dateutil-provided zoneinfo files, "
+                  "ZoneInfoFile object and query the 'metadata' attribute "
+                  "instead. See the documentation for details.",
+                  DeprecationWarning)
+
+    if len(_CLASS_ZONE_INSTANCE) == 0:
+        _CLASS_ZONE_INSTANCE.append(ZoneInfoFile(getzoneinfofile_stream()))
+    return _CLASS_ZONE_INSTANCE[0].metadata
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/rebuild.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/rebuild.py
new file mode 100644
index 0000000000000000000000000000000000000000..78f0d1a0ce57f188c28156555a6cbe85e3e08d19
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/dateutil/zoneinfo/rebuild.py
@@ -0,0 +1,53 @@
+import logging
+import os
+import tempfile
+import shutil
+import json
+from subprocess import check_call
+from tarfile import TarFile
+
+from dateutil.zoneinfo import METADATA_FN, ZONEFILENAME
+
+
+def rebuild(filename, tag=None, format="gz", zonegroups=[], metadata=None):
+    """Rebuild the internal timezone info in dateutil/zoneinfo/zoneinfo*tar*
+
+    filename is the timezone tarball from ``ftp.iana.org/tz``.
+
+    """
+    tmpdir = tempfile.mkdtemp()
+    zonedir = os.path.join(tmpdir, "zoneinfo")
+    moduledir = os.path.dirname(__file__)
+    try:
+        with TarFile.open(filename) as tf:
+            for name in zonegroups:
+                tf.extract(name, tmpdir)
+            filepaths = [os.path.join(tmpdir, n) for n in zonegroups]
+            try:
+                check_call(["zic", "-d", zonedir] + filepaths)
+            except OSError as e:
+                _print_on_nosuchfile(e)
+                raise
+        # write metadata file
+        with open(os.path.join(zonedir, METADATA_FN), 'w') as f:
+            json.dump(metadata, f, indent=4, sort_keys=True)
+        target = os.path.join(moduledir, ZONEFILENAME)
+        with TarFile.open(target, "w:%s" % format) as tf:
+            for entry in os.listdir(zonedir):
+                entrypath = os.path.join(zonedir, entry)
+                tf.add(entrypath, entry)
+    finally:
+        shutil.rmtree(tmpdir)
+
+
+def _print_on_nosuchfile(e):
+    """Print helpful troubleshooting message
+
+    e is an exception raised by subprocess.check_call()
+
+    """
+    if e.errno == 2:
+        logging.error(
+            "Could not find zic. Perhaps you need to install "
+            "libc-bin or some other package that provides it, "
+            "or it's not in your PATH?")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..7905cc971c8dded864bb6ade93ba3d02e9d322e8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/METADATA
@@ -0,0 +1,31 @@
+Metadata-Version: 2.1
+Name: distlib
+Version: 0.3.0
+Summary: Distribution utilities
+Home-page: https://bitbucket.org/pypa/distlib
+Author: Vinay Sajip
+Author-email: vinay_sajip@red-dove.com
+License: Python license
+Download-URL: https://bitbucket.org/pypa/distlib/downloads/distlib-0.3.0.zip
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Python Software Foundation License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development
+
+Low-level components of distutils2/packaging, augmented with higher-level APIs for making packaging easier.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..39025d47cae1e96de2287eec47a0fb0bd84258de
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/RECORD
@@ -0,0 +1,48 @@
+distlib/__init__.py,sha256=gzl1hjUXmDGrqRyU7ZLjBwJGAcMimQbrZ22XPVaKaRE,581
+distlib/compat.py,sha256=xdNZmqFN5HwF30HjRn5M415pcC2kgXRBXn767xS8v-M,41404
+distlib/database.py,sha256=fhNzEDtb4HXrpxKyQvhVzDXcOiJlzrOM--UYnvCeZrI,51045
+distlib/index.py,sha256=SXKzpQCERctxYDMp_OLee2f0J0e19ZhGdCIoMlUfUQM,21066
+distlib/locators.py,sha256=c9E4cDEacJ_uKbuE5BqAVocoWp6rsuBGTkiNDQq3zV4,52100
+distlib/manifest.py,sha256=nQEhYmgoreaBZzyFzwYsXxJARu3fo4EkunU163U16iE,14811
+distlib/markers.py,sha256=6Ac3cCfFBERexiESWIOXmg-apIP8l2esafNSX3KMy-8,4387
+distlib/metadata.py,sha256=OhbCKmf5lswE8unWBopI1hj7tRpHp4ZbFvU4d6aAEMM,40234
+distlib/resources.py,sha256=2FGv0ZHF14KXjLIlL0R991lyQQGcewOS4mJ-5n-JVnc,10766
+distlib/scripts.py,sha256=OAkEwxRvIzX-VSfhEttQEKJFVLA47gbW0OgQXJRs7OQ,16998
+distlib/util.py,sha256=f2jZCPrcLCt6LcnC0gUy-Fur60tXD8reA7k4rDpHMDw,59845
+distlib/version.py,sha256=_n7F6juvQGAcn769E_SHa7fOcf5ERlEVymJ_EjPRwGw,23391
+distlib/wheel.py,sha256=bRtR5bNR_u_DwkwktN1bgZuwLVOJT1p_vNIUPyN8kJc,40452
+distlib/_backport/__init__.py,sha256=bqS_dTOH6uW9iGgd0uzfpPjo6vZ4xpPZ7kyfZJ2vNaw,274
+distlib/_backport/misc.py,sha256=KWecINdbFNOxSOP1fGF680CJnaC6S4fBRgEtaYTw0ig,971
+distlib/_backport/shutil.py,sha256=VW1t3uYqUjWZH7jV-6QiimLhnldoV5uIpH4EuiT1jfw,25647
+distlib/_backport/sysconfig.cfg,sha256=swZKxq9RY5e9r3PXCrlvQPMsvOdiWZBTHLEbqS8LJLU,2617
+distlib/_backport/sysconfig.py,sha256=BQHFlb6pubCl_dvT1NjtzIthylofjKisox239stDg0U,26854
+distlib/_backport/tarfile.py,sha256=Ihp7rXRcjbIKw8COm9wSePV9ARGXbSF9gGXAMn2Q-KU,92628
+distlib-0.3.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+distlib-0.3.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+distlib-0.3.0.dist-info/METADATA,sha256=K-1KbKXfYWPNkxh639g8H_epsxZqI8SOWXsMxZfD3j4,1251
+distlib-0.3.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+distlib-0.3.0.dist-info/top_level.txt,sha256=9BERqitu_vzyeyILOcGzX9YyA2AB_xlC4-81V6xoizk,8
+distlib-0.3.0.dist-info/RECORD,,
+distlib/index.cpython-38.pyc,,
+distlib/__pycache__,,
+distlib/resources.cpython-38.pyc,,
+distlib/_backport/sysconfig.cpython-38.pyc,,
+distlib-0.3.0.dist-info/__pycache__,,
+distlib/_backport/tarfile.cpython-38.pyc,,
+distlib/util.cpython-38.pyc,,
+distlib/_backport/__pycache__,,
+distlib/scripts.cpython-38.pyc,,
+distlib/_backport/shutil.cpython-38.pyc,,
+distlib/locators.cpython-38.pyc,,
+distlib-0.3.0.virtualenv,,
+distlib/manifest.cpython-38.pyc,,
+distlib-0.3.0.dist-info/INSTALLER,,
+distlib/compat.cpython-38.pyc,,
+distlib/markers.cpython-38.pyc,,
+distlib/__init__.cpython-38.pyc,,
+distlib/metadata.cpython-38.pyc,,
+distlib/wheel.cpython-38.pyc,,
+distlib/_backport/misc.cpython-38.pyc,,
+distlib/database.cpython-38.pyc,,
+distlib/version.cpython-38.pyc,,
+distlib/_backport/__init__.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f68bb07272ddc517a1ca4c3d4e50ac67bf78d3e2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+distlib
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib-0.3.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e19aebdc4cc8700bb740176baca1cda6dce1c99c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/__init__.py
@@ -0,0 +1,23 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2019 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+import logging
+
+__version__ = '0.3.0'
+
+class DistlibException(Exception):
+    pass
+
+try:
+    from logging import NullHandler
+except ImportError: # pragma: no cover
+    class NullHandler(logging.Handler):
+        def handle(self, record): pass
+        def emit(self, record): pass
+        def createLock(self): self.lock = None
+
+logger = logging.getLogger(__name__)
+logger.addHandler(NullHandler())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f7dbf4c9aa8314816f9bcbe5357146369ee71391
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/__init__.py
@@ -0,0 +1,6 @@
+"""Modules copied from Python 3 standard libraries, for internal use only.
+
+Individual classes and functions are found in d2._backport.misc.  Intended
+usage is to always import things missing from 3.1 from that module: the
+built-in/stdlib objects will be used if found.
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/misc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/misc.py
new file mode 100644
index 0000000000000000000000000000000000000000..cfb318d34f761cde906d8b02dde3f9329688b8c6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/misc.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""Backports for individual classes and functions."""
+
+import os
+import sys
+
+__all__ = ['cache_from_source', 'callable', 'fsencode']
+
+
+try:
+    from imp import cache_from_source
+except ImportError:
+    def cache_from_source(py_file, debug=__debug__):
+        ext = debug and 'c' or 'o'
+        return py_file + ext
+
+
+try:
+    callable = callable
+except NameError:
+    from collections import Callable
+
+    def callable(obj):
+        return isinstance(obj, Callable)
+
+
+try:
+    fsencode = os.fsencode
+except AttributeError:
+    def fsencode(filename):
+        if isinstance(filename, bytes):
+            return filename
+        elif isinstance(filename, str):
+            return filename.encode(sys.getfilesystemencoding())
+        else:
+            raise TypeError("expect bytes or str, not %s" %
+                            type(filename).__name__)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/shutil.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/shutil.py
new file mode 100644
index 0000000000000000000000000000000000000000..159e49ee8c2aa698aea9a191db91a14716187324
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/shutil.py
@@ -0,0 +1,761 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""Utility functions for copying and archiving files and directory trees.
+
+XXX The functions here don't copy the resource fork or other metadata on Mac.
+
+"""
+
+import os
+import sys
+import stat
+from os.path import abspath
+import fnmatch
+import collections
+import errno
+from . import tarfile
+
+try:
+    import bz2
+    _BZ2_SUPPORTED = True
+except ImportError:
+    _BZ2_SUPPORTED = False
+
+try:
+    from pwd import getpwnam
+except ImportError:
+    getpwnam = None
+
+try:
+    from grp import getgrnam
+except ImportError:
+    getgrnam = None
+
+__all__ = ["copyfileobj", "copyfile", "copymode", "copystat", "copy", "copy2",
+           "copytree", "move", "rmtree", "Error", "SpecialFileError",
+           "ExecError", "make_archive", "get_archive_formats",
+           "register_archive_format", "unregister_archive_format",
+           "get_unpack_formats", "register_unpack_format",
+           "unregister_unpack_format", "unpack_archive", "ignore_patterns"]
+
+class Error(EnvironmentError):
+    pass
+
+class SpecialFileError(EnvironmentError):
+    """Raised when trying to do a kind of operation (e.g. copying) which is
+    not supported on a special file (e.g. a named pipe)"""
+
+class ExecError(EnvironmentError):
+    """Raised when a command could not be executed"""
+
+class ReadError(EnvironmentError):
+    """Raised when an archive cannot be read"""
+
+class RegistryError(Exception):
+    """Raised when a registry operation with the archiving
+    and unpacking registries fails"""
+
+
+try:
+    WindowsError
+except NameError:
+    WindowsError = None
+
+def copyfileobj(fsrc, fdst, length=16*1024):
+    """copy data from file-like object fsrc to file-like object fdst"""
+    while 1:
+        buf = fsrc.read(length)
+        if not buf:
+            break
+        fdst.write(buf)
+
+def _samefile(src, dst):
+    # Macintosh, Unix.
+    if hasattr(os.path, 'samefile'):
+        try:
+            return os.path.samefile(src, dst)
+        except OSError:
+            return False
+
+    # All other platforms: check for same pathname.
+    return (os.path.normcase(os.path.abspath(src)) ==
+            os.path.normcase(os.path.abspath(dst)))
+
+def copyfile(src, dst):
+    """Copy data from src to dst"""
+    if _samefile(src, dst):
+        raise Error("`%s` and `%s` are the same file" % (src, dst))
+
+    for fn in [src, dst]:
+        try:
+            st = os.stat(fn)
+        except OSError:
+            # File most likely does not exist
+            pass
+        else:
+            # XXX What about other special files? (sockets, devices...)
+            if stat.S_ISFIFO(st.st_mode):
+                raise SpecialFileError("`%s` is a named pipe" % fn)
+
+    with open(src, 'rb') as fsrc:
+        with open(dst, 'wb') as fdst:
+            copyfileobj(fsrc, fdst)
+
+def copymode(src, dst):
+    """Copy mode bits from src to dst"""
+    if hasattr(os, 'chmod'):
+        st = os.stat(src)
+        mode = stat.S_IMODE(st.st_mode)
+        os.chmod(dst, mode)
+
+def copystat(src, dst):
+    """Copy all stat info (mode bits, atime, mtime, flags) from src to dst"""
+    st = os.stat(src)
+    mode = stat.S_IMODE(st.st_mode)
+    if hasattr(os, 'utime'):
+        os.utime(dst, (st.st_atime, st.st_mtime))
+    if hasattr(os, 'chmod'):
+        os.chmod(dst, mode)
+    if hasattr(os, 'chflags') and hasattr(st, 'st_flags'):
+        try:
+            os.chflags(dst, st.st_flags)
+        except OSError as why:
+            if (not hasattr(errno, 'EOPNOTSUPP') or
+                why.errno != errno.EOPNOTSUPP):
+                raise
+
+def copy(src, dst):
+    """Copy data and mode bits ("cp src dst").
+
+    The destination may be a directory.
+
+    """
+    if os.path.isdir(dst):
+        dst = os.path.join(dst, os.path.basename(src))
+    copyfile(src, dst)
+    copymode(src, dst)
+
+def copy2(src, dst):
+    """Copy data and all stat info ("cp -p src dst").
+
+    The destination may be a directory.
+
+    """
+    if os.path.isdir(dst):
+        dst = os.path.join(dst, os.path.basename(src))
+    copyfile(src, dst)
+    copystat(src, dst)
+
+def ignore_patterns(*patterns):
+    """Function that can be used as copytree() ignore parameter.
+
+    Patterns is a sequence of glob-style patterns
+    that are used to exclude files"""
+    def _ignore_patterns(path, names):
+        ignored_names = []
+        for pattern in patterns:
+            ignored_names.extend(fnmatch.filter(names, pattern))
+        return set(ignored_names)
+    return _ignore_patterns
+
+def copytree(src, dst, symlinks=False, ignore=None, copy_function=copy2,
+             ignore_dangling_symlinks=False):
+    """Recursively copy a directory tree.
+
+    The destination directory must not already exist.
+    If exception(s) occur, an Error is raised with a list of reasons.
+
+    If the optional symlinks flag is true, symbolic links in the
+    source tree result in symbolic links in the destination tree; if
+    it is false, the contents of the files pointed to by symbolic
+    links are copied. If the file pointed by the symlink doesn't
+    exist, an exception will be added in the list of errors raised in
+    an Error exception at the end of the copy process.
+
+    You can set the optional ignore_dangling_symlinks flag to true if you
+    want to silence this exception. Notice that this has no effect on
+    platforms that don't support os.symlink.
+
+    The optional ignore argument is a callable. If given, it
+    is called with the `src` parameter, which is the directory
+    being visited by copytree(), and `names` which is the list of
+    `src` contents, as returned by os.listdir():
+
+        callable(src, names) -> ignored_names
+
+    Since copytree() is called recursively, the callable will be
+    called once for each directory that is copied. It returns a
+    list of names relative to the `src` directory that should
+    not be copied.
+
+    The optional copy_function argument is a callable that will be used
+    to copy each file. It will be called with the source path and the
+    destination path as arguments. By default, copy2() is used, but any
+    function that supports the same signature (like copy()) can be used.
+
+    """
+    names = os.listdir(src)
+    if ignore is not None:
+        ignored_names = ignore(src, names)
+    else:
+        ignored_names = set()
+
+    os.makedirs(dst)
+    errors = []
+    for name in names:
+        if name in ignored_names:
+            continue
+        srcname = os.path.join(src, name)
+        dstname = os.path.join(dst, name)
+        try:
+            if os.path.islink(srcname):
+                linkto = os.readlink(srcname)
+                if symlinks:
+                    os.symlink(linkto, dstname)
+                else:
+                    # ignore dangling symlink if the flag is on
+                    if not os.path.exists(linkto) and ignore_dangling_symlinks:
+                        continue
+                    # otherwise let the copy occurs. copy2 will raise an error
+                    copy_function(srcname, dstname)
+            elif os.path.isdir(srcname):
+                copytree(srcname, dstname, symlinks, ignore, copy_function)
+            else:
+                # Will raise a SpecialFileError for unsupported file types
+                copy_function(srcname, dstname)
+        # catch the Error from the recursive copytree so that we can
+        # continue with other files
+        except Error as err:
+            errors.extend(err.args[0])
+        except EnvironmentError as why:
+            errors.append((srcname, dstname, str(why)))
+    try:
+        copystat(src, dst)
+    except OSError as why:
+        if WindowsError is not None and isinstance(why, WindowsError):
+            # Copying file access times may fail on Windows
+            pass
+        else:
+            errors.extend((src, dst, str(why)))
+    if errors:
+        raise Error(errors)
+
+def rmtree(path, ignore_errors=False, onerror=None):
+    """Recursively delete a directory tree.
+
+    If ignore_errors is set, errors are ignored; otherwise, if onerror
+    is set, it is called to handle the error with arguments (func,
+    path, exc_info) where func is os.listdir, os.remove, or os.rmdir;
+    path is the argument to that function that caused it to fail; and
+    exc_info is a tuple returned by sys.exc_info().  If ignore_errors
+    is false and onerror is None, an exception is raised.
+
+    """
+    if ignore_errors:
+        def onerror(*args):
+            pass
+    elif onerror is None:
+        def onerror(*args):
+            raise
+    try:
+        if os.path.islink(path):
+            # symlinks to directories are forbidden, see bug #1669
+            raise OSError("Cannot call rmtree on a symbolic link")
+    except OSError:
+        onerror(os.path.islink, path, sys.exc_info())
+        # can't continue even if onerror hook returns
+        return
+    names = []
+    try:
+        names = os.listdir(path)
+    except os.error:
+        onerror(os.listdir, path, sys.exc_info())
+    for name in names:
+        fullname = os.path.join(path, name)
+        try:
+            mode = os.lstat(fullname).st_mode
+        except os.error:
+            mode = 0
+        if stat.S_ISDIR(mode):
+            rmtree(fullname, ignore_errors, onerror)
+        else:
+            try:
+                os.remove(fullname)
+            except os.error:
+                onerror(os.remove, fullname, sys.exc_info())
+    try:
+        os.rmdir(path)
+    except os.error:
+        onerror(os.rmdir, path, sys.exc_info())
+
+
+def _basename(path):
+    # A basename() variant which first strips the trailing slash, if present.
+    # Thus we always get the last component of the path, even for directories.
+    return os.path.basename(path.rstrip(os.path.sep))
+
+def move(src, dst):
+    """Recursively move a file or directory to another location. This is
+    similar to the Unix "mv" command.
+
+    If the destination is a directory or a symlink to a directory, the source
+    is moved inside the directory. The destination path must not already
+    exist.
+
+    If the destination already exists but is not a directory, it may be
+    overwritten depending on os.rename() semantics.
+
+    If the destination is on our current filesystem, then rename() is used.
+    Otherwise, src is copied to the destination and then removed.
+    A lot more could be done here...  A look at a mv.c shows a lot of
+    the issues this implementation glosses over.
+
+    """
+    real_dst = dst
+    if os.path.isdir(dst):
+        if _samefile(src, dst):
+            # We might be on a case insensitive filesystem,
+            # perform the rename anyway.
+            os.rename(src, dst)
+            return
+
+        real_dst = os.path.join(dst, _basename(src))
+        if os.path.exists(real_dst):
+            raise Error("Destination path '%s' already exists" % real_dst)
+    try:
+        os.rename(src, real_dst)
+    except OSError:
+        if os.path.isdir(src):
+            if _destinsrc(src, dst):
+                raise Error("Cannot move a directory '%s' into itself '%s'." % (src, dst))
+            copytree(src, real_dst, symlinks=True)
+            rmtree(src)
+        else:
+            copy2(src, real_dst)
+            os.unlink(src)
+
+def _destinsrc(src, dst):
+    src = abspath(src)
+    dst = abspath(dst)
+    if not src.endswith(os.path.sep):
+        src += os.path.sep
+    if not dst.endswith(os.path.sep):
+        dst += os.path.sep
+    return dst.startswith(src)
+
+def _get_gid(name):
+    """Returns a gid, given a group name."""
+    if getgrnam is None or name is None:
+        return None
+    try:
+        result = getgrnam(name)
+    except KeyError:
+        result = None
+    if result is not None:
+        return result[2]
+    return None
+
+def _get_uid(name):
+    """Returns an uid, given a user name."""
+    if getpwnam is None or name is None:
+        return None
+    try:
+        result = getpwnam(name)
+    except KeyError:
+        result = None
+    if result is not None:
+        return result[2]
+    return None
+
+def _make_tarball(base_name, base_dir, compress="gzip", verbose=0, dry_run=0,
+                  owner=None, group=None, logger=None):
+    """Create a (possibly compressed) tar file from all the files under
+    'base_dir'.
+
+    'compress' must be "gzip" (the default), "bzip2", or None.
+
+    'owner' and 'group' can be used to define an owner and a group for the
+    archive that is being built. If not provided, the current owner and group
+    will be used.
+
+    The output tar file will be named 'base_name' +  ".tar", possibly plus
+    the appropriate compression extension (".gz", or ".bz2").
+
+    Returns the output filename.
+    """
+    tar_compression = {'gzip': 'gz', None: ''}
+    compress_ext = {'gzip': '.gz'}
+
+    if _BZ2_SUPPORTED:
+        tar_compression['bzip2'] = 'bz2'
+        compress_ext['bzip2'] = '.bz2'
+
+    # flags for compression program, each element of list will be an argument
+    if compress is not None and compress not in compress_ext:
+        raise ValueError("bad value for 'compress', or compression format not "
+                         "supported : {0}".format(compress))
+
+    archive_name = base_name + '.tar' + compress_ext.get(compress, '')
+    archive_dir = os.path.dirname(archive_name)
+
+    if not os.path.exists(archive_dir):
+        if logger is not None:
+            logger.info("creating %s", archive_dir)
+        if not dry_run:
+            os.makedirs(archive_dir)
+
+    # creating the tarball
+    if logger is not None:
+        logger.info('Creating tar archive')
+
+    uid = _get_uid(owner)
+    gid = _get_gid(group)
+
+    def _set_uid_gid(tarinfo):
+        if gid is not None:
+            tarinfo.gid = gid
+            tarinfo.gname = group
+        if uid is not None:
+            tarinfo.uid = uid
+            tarinfo.uname = owner
+        return tarinfo
+
+    if not dry_run:
+        tar = tarfile.open(archive_name, 'w|%s' % tar_compression[compress])
+        try:
+            tar.add(base_dir, filter=_set_uid_gid)
+        finally:
+            tar.close()
+
+    return archive_name
+
+def _call_external_zip(base_dir, zip_filename, verbose=False, dry_run=False):
+    # XXX see if we want to keep an external call here
+    if verbose:
+        zipoptions = "-r"
+    else:
+        zipoptions = "-rq"
+    from distutils.errors import DistutilsExecError
+    from distutils.spawn import spawn
+    try:
+        spawn(["zip", zipoptions, zip_filename, base_dir], dry_run=dry_run)
+    except DistutilsExecError:
+        # XXX really should distinguish between "couldn't find
+        # external 'zip' command" and "zip failed".
+        raise ExecError("unable to create zip file '%s': "
+            "could neither import the 'zipfile' module nor "
+            "find a standalone zip utility") % zip_filename
+
+def _make_zipfile(base_name, base_dir, verbose=0, dry_run=0, logger=None):
+    """Create a zip file from all the files under 'base_dir'.
+
+    The output zip file will be named 'base_name' + ".zip".  Uses either the
+    "zipfile" Python module (if available) or the InfoZIP "zip" utility
+    (if installed and found on the default search path).  If neither tool is
+    available, raises ExecError.  Returns the name of the output zip
+    file.
+    """
+    zip_filename = base_name + ".zip"
+    archive_dir = os.path.dirname(base_name)
+
+    if not os.path.exists(archive_dir):
+        if logger is not None:
+            logger.info("creating %s", archive_dir)
+        if not dry_run:
+            os.makedirs(archive_dir)
+
+    # If zipfile module is not available, try spawning an external 'zip'
+    # command.
+    try:
+        import zipfile
+    except ImportError:
+        zipfile = None
+
+    if zipfile is None:
+        _call_external_zip(base_dir, zip_filename, verbose, dry_run)
+    else:
+        if logger is not None:
+            logger.info("creating '%s' and adding '%s' to it",
+                        zip_filename, base_dir)
+
+        if not dry_run:
+            zip = zipfile.ZipFile(zip_filename, "w",
+                                  compression=zipfile.ZIP_DEFLATED)
+
+            for dirpath, dirnames, filenames in os.walk(base_dir):
+                for name in filenames:
+                    path = os.path.normpath(os.path.join(dirpath, name))
+                    if os.path.isfile(path):
+                        zip.write(path, path)
+                        if logger is not None:
+                            logger.info("adding '%s'", path)
+            zip.close()
+
+    return zip_filename
+
+_ARCHIVE_FORMATS = {
+    'gztar': (_make_tarball, [('compress', 'gzip')], "gzip'ed tar-file"),
+    'bztar': (_make_tarball, [('compress', 'bzip2')], "bzip2'ed tar-file"),
+    'tar':   (_make_tarball, [('compress', None)], "uncompressed tar file"),
+    'zip':   (_make_zipfile, [], "ZIP file"),
+    }
+
+if _BZ2_SUPPORTED:
+    _ARCHIVE_FORMATS['bztar'] = (_make_tarball, [('compress', 'bzip2')],
+                                "bzip2'ed tar-file")
+
+def get_archive_formats():
+    """Returns a list of supported formats for archiving and unarchiving.
+
+    Each element of the returned sequence is a tuple (name, description)
+    """
+    formats = [(name, registry[2]) for name, registry in
+               _ARCHIVE_FORMATS.items()]
+    formats.sort()
+    return formats
+
+def register_archive_format(name, function, extra_args=None, description=''):
+    """Registers an archive format.
+
+    name is the name of the format. function is the callable that will be
+    used to create archives. If provided, extra_args is a sequence of
+    (name, value) tuples that will be passed as arguments to the callable.
+    description can be provided to describe the format, and will be returned
+    by the get_archive_formats() function.
+    """
+    if extra_args is None:
+        extra_args = []
+    if not isinstance(function, collections.Callable):
+        raise TypeError('The %s object is not callable' % function)
+    if not isinstance(extra_args, (tuple, list)):
+        raise TypeError('extra_args needs to be a sequence')
+    for element in extra_args:
+        if not isinstance(element, (tuple, list)) or len(element) !=2:
+            raise TypeError('extra_args elements are : (arg_name, value)')
+
+    _ARCHIVE_FORMATS[name] = (function, extra_args, description)
+
+def unregister_archive_format(name):
+    del _ARCHIVE_FORMATS[name]
+
+def make_archive(base_name, format, root_dir=None, base_dir=None, verbose=0,
+                 dry_run=0, owner=None, group=None, logger=None):
+    """Create an archive file (eg. zip or tar).
+
+    'base_name' is the name of the file to create, minus any format-specific
+    extension; 'format' is the archive format: one of "zip", "tar", "bztar"
+    or "gztar".
+
+    'root_dir' is a directory that will be the root directory of the
+    archive; ie. we typically chdir into 'root_dir' before creating the
+    archive.  'base_dir' is the directory where we start archiving from;
+    ie. 'base_dir' will be the common prefix of all files and
+    directories in the archive.  'root_dir' and 'base_dir' both default
+    to the current directory.  Returns the name of the archive file.
+
+    'owner' and 'group' are used when creating a tar archive. By default,
+    uses the current owner and group.
+    """
+    save_cwd = os.getcwd()
+    if root_dir is not None:
+        if logger is not None:
+            logger.debug("changing into '%s'", root_dir)
+        base_name = os.path.abspath(base_name)
+        if not dry_run:
+            os.chdir(root_dir)
+
+    if base_dir is None:
+        base_dir = os.curdir
+
+    kwargs = {'dry_run': dry_run, 'logger': logger}
+
+    try:
+        format_info = _ARCHIVE_FORMATS[format]
+    except KeyError:
+        raise ValueError("unknown archive format '%s'" % format)
+
+    func = format_info[0]
+    for arg, val in format_info[1]:
+        kwargs[arg] = val
+
+    if format != 'zip':
+        kwargs['owner'] = owner
+        kwargs['group'] = group
+
+    try:
+        filename = func(base_name, base_dir, **kwargs)
+    finally:
+        if root_dir is not None:
+            if logger is not None:
+                logger.debug("changing back to '%s'", save_cwd)
+            os.chdir(save_cwd)
+
+    return filename
+
+
+def get_unpack_formats():
+    """Returns a list of supported formats for unpacking.
+
+    Each element of the returned sequence is a tuple
+    (name, extensions, description)
+    """
+    formats = [(name, info[0], info[3]) for name, info in
+               _UNPACK_FORMATS.items()]
+    formats.sort()
+    return formats
+
+def _check_unpack_options(extensions, function, extra_args):
+    """Checks what gets registered as an unpacker."""
+    # first make sure no other unpacker is registered for this extension
+    existing_extensions = {}
+    for name, info in _UNPACK_FORMATS.items():
+        for ext in info[0]:
+            existing_extensions[ext] = name
+
+    for extension in extensions:
+        if extension in existing_extensions:
+            msg = '%s is already registered for "%s"'
+            raise RegistryError(msg % (extension,
+                                       existing_extensions[extension]))
+
+    if not isinstance(function, collections.Callable):
+        raise TypeError('The registered function must be a callable')
+
+
+def register_unpack_format(name, extensions, function, extra_args=None,
+                           description=''):
+    """Registers an unpack format.
+
+    `name` is the name of the format. `extensions` is a list of extensions
+    corresponding to the format.
+
+    `function` is the callable that will be
+    used to unpack archives. The callable will receive archives to unpack.
+    If it's unable to handle an archive, it needs to raise a ReadError
+    exception.
+
+    If provided, `extra_args` is a sequence of
+    (name, value) tuples that will be passed as arguments to the callable.
+    description can be provided to describe the format, and will be returned
+    by the get_unpack_formats() function.
+    """
+    if extra_args is None:
+        extra_args = []
+    _check_unpack_options(extensions, function, extra_args)
+    _UNPACK_FORMATS[name] = extensions, function, extra_args, description
+
+def unregister_unpack_format(name):
+    """Removes the pack format from the registry."""
+    del _UNPACK_FORMATS[name]
+
+def _ensure_directory(path):
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    if not os.path.isdir(dirname):
+        os.makedirs(dirname)
+
+def _unpack_zipfile(filename, extract_dir):
+    """Unpack zip `filename` to `extract_dir`
+    """
+    try:
+        import zipfile
+    except ImportError:
+        raise ReadError('zlib not supported, cannot unpack this archive.')
+
+    if not zipfile.is_zipfile(filename):
+        raise ReadError("%s is not a zip file" % filename)
+
+    zip = zipfile.ZipFile(filename)
+    try:
+        for info in zip.infolist():
+            name = info.filename
+
+            # don't extract absolute paths or ones with .. in them
+            if name.startswith('/') or '..' in name:
+                continue
+
+            target = os.path.join(extract_dir, *name.split('/'))
+            if not target:
+                continue
+
+            _ensure_directory(target)
+            if not name.endswith('/'):
+                # file
+                data = zip.read(info.filename)
+                f = open(target, 'wb')
+                try:
+                    f.write(data)
+                finally:
+                    f.close()
+                    del data
+    finally:
+        zip.close()
+
+def _unpack_tarfile(filename, extract_dir):
+    """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`
+    """
+    try:
+        tarobj = tarfile.open(filename)
+    except tarfile.TarError:
+        raise ReadError(
+            "%s is not a compressed or uncompressed tar file" % filename)
+    try:
+        tarobj.extractall(extract_dir)
+    finally:
+        tarobj.close()
+
+_UNPACK_FORMATS = {
+    'gztar': (['.tar.gz', '.tgz'], _unpack_tarfile, [], "gzip'ed tar-file"),
+    'tar':   (['.tar'], _unpack_tarfile, [], "uncompressed tar file"),
+    'zip':   (['.zip'], _unpack_zipfile, [], "ZIP file")
+    }
+
+if _BZ2_SUPPORTED:
+    _UNPACK_FORMATS['bztar'] = (['.bz2'], _unpack_tarfile, [],
+                                "bzip2'ed tar-file")
+
+def _find_unpack_format(filename):
+    for name, info in _UNPACK_FORMATS.items():
+        for extension in info[0]:
+            if filename.endswith(extension):
+                return name
+    return None
+
+def unpack_archive(filename, extract_dir=None, format=None):
+    """Unpack an archive.
+
+    `filename` is the name of the archive.
+
+    `extract_dir` is the name of the target directory, where the archive
+    is unpacked. If not provided, the current working directory is used.
+
+    `format` is the archive format: one of "zip", "tar", or "gztar". Or any
+    other registered format. If not provided, unpack_archive will use the
+    filename extension and see if an unpacker was registered for that
+    extension.
+
+    In case none is found, a ValueError is raised.
+    """
+    if extract_dir is None:
+        extract_dir = os.getcwd()
+
+    if format is not None:
+        try:
+            format_info = _UNPACK_FORMATS[format]
+        except KeyError:
+            raise ValueError("Unknown unpack format '{0}'".format(format))
+
+        func = format_info[1]
+        func(filename, extract_dir, **dict(format_info[2]))
+    else:
+        # we need to look at the registered unpackers supported extensions
+        format = _find_unpack_format(filename)
+        if format is None:
+            raise ReadError("Unknown archive format '{0}'".format(filename))
+
+        func = _UNPACK_FORMATS[format][1]
+        kwargs = dict(_UNPACK_FORMATS[format][2])
+        func(filename, extract_dir, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..1746bd01c1ad915b728ab58b4668c82b2bd578e1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.cfg
@@ -0,0 +1,84 @@
+[posix_prefix]
+# Configuration directories.  Some of these come straight out of the
+# configure script.  They are for implementing the other variables, not to
+# be used directly in [resource_locations].
+confdir = /etc
+datadir = /usr/share
+libdir = /usr/lib
+statedir = /var
+# User resource directory
+local = ~/.local/{distribution.name}
+
+stdlib = {base}/lib/python{py_version_short}
+platstdlib = {platbase}/lib/python{py_version_short}
+purelib = {base}/lib/python{py_version_short}/site-packages
+platlib = {platbase}/lib/python{py_version_short}/site-packages
+include = {base}/include/python{py_version_short}{abiflags}
+platinclude = {platbase}/include/python{py_version_short}{abiflags}
+data = {base}
+
+[posix_home]
+stdlib = {base}/lib/python
+platstdlib = {base}/lib/python
+purelib = {base}/lib/python
+platlib = {base}/lib/python
+include = {base}/include/python
+platinclude = {base}/include/python
+scripts = {base}/bin
+data = {base}
+
+[nt]
+stdlib = {base}/Lib
+platstdlib = {base}/Lib
+purelib = {base}/Lib/site-packages
+platlib = {base}/Lib/site-packages
+include = {base}/Include
+platinclude = {base}/Include
+scripts = {base}/Scripts
+data = {base}
+
+[os2]
+stdlib = {base}/Lib
+platstdlib = {base}/Lib
+purelib = {base}/Lib/site-packages
+platlib = {base}/Lib/site-packages
+include = {base}/Include
+platinclude = {base}/Include
+scripts = {base}/Scripts
+data = {base}
+
+[os2_home]
+stdlib = {userbase}/lib/python{py_version_short}
+platstdlib = {userbase}/lib/python{py_version_short}
+purelib = {userbase}/lib/python{py_version_short}/site-packages
+platlib = {userbase}/lib/python{py_version_short}/site-packages
+include = {userbase}/include/python{py_version_short}
+scripts = {userbase}/bin
+data = {userbase}
+
+[nt_user]
+stdlib = {userbase}/Python{py_version_nodot}
+platstdlib = {userbase}/Python{py_version_nodot}
+purelib = {userbase}/Python{py_version_nodot}/site-packages
+platlib = {userbase}/Python{py_version_nodot}/site-packages
+include = {userbase}/Python{py_version_nodot}/Include
+scripts = {userbase}/Scripts
+data = {userbase}
+
+[posix_user]
+stdlib = {userbase}/lib/python{py_version_short}
+platstdlib = {userbase}/lib/python{py_version_short}
+purelib = {userbase}/lib/python{py_version_short}/site-packages
+platlib = {userbase}/lib/python{py_version_short}/site-packages
+include = {userbase}/include/python{py_version_short}
+scripts = {userbase}/bin
+data = {userbase}
+
+[osx_framework_user]
+stdlib = {userbase}/lib/python
+platstdlib = {userbase}/lib/python
+purelib = {userbase}/lib/python/site-packages
+platlib = {userbase}/lib/python/site-packages
+include = {userbase}/include
+scripts = {userbase}/bin
+data = {userbase}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.py
new file mode 100644
index 0000000000000000000000000000000000000000..b470a373c8664325d0d00c367c0a93e926f468fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/sysconfig.py
@@ -0,0 +1,786 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""Access to Python's configuration information."""
+
+import codecs
+import os
+import re
+import sys
+from os.path import pardir, realpath
+try:
+    import configparser
+except ImportError:
+    import ConfigParser as configparser
+
+
+__all__ = [
+    'get_config_h_filename',
+    'get_config_var',
+    'get_config_vars',
+    'get_makefile_filename',
+    'get_path',
+    'get_path_names',
+    'get_paths',
+    'get_platform',
+    'get_python_version',
+    'get_scheme_names',
+    'parse_config_h',
+]
+
+
+def _safe_realpath(path):
+    try:
+        return realpath(path)
+    except OSError:
+        return path
+
+
+if sys.executable:
+    _PROJECT_BASE = os.path.dirname(_safe_realpath(sys.executable))
+else:
+    # sys.executable can be empty if argv[0] has been changed and Python is
+    # unable to retrieve the real program name
+    _PROJECT_BASE = _safe_realpath(os.getcwd())
+
+if os.name == "nt" and "pcbuild" in _PROJECT_BASE[-8:].lower():
+    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir))
+# PC/VS7.1
+if os.name == "nt" and "\\pc\\v" in _PROJECT_BASE[-10:].lower():
+    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir, pardir))
+# PC/AMD64
+if os.name == "nt" and "\\pcbuild\\amd64" in _PROJECT_BASE[-14:].lower():
+    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir, pardir))
+
+
+def is_python_build():
+    for fn in ("Setup.dist", "Setup.local"):
+        if os.path.isfile(os.path.join(_PROJECT_BASE, "Modules", fn)):
+            return True
+    return False
+
+_PYTHON_BUILD = is_python_build()
+
+_cfg_read = False
+
+def _ensure_cfg_read():
+    global _cfg_read
+    if not _cfg_read:
+        from ..resources import finder
+        backport_package = __name__.rsplit('.', 1)[0]
+        _finder = finder(backport_package)
+        _cfgfile = _finder.find('sysconfig.cfg')
+        assert _cfgfile, 'sysconfig.cfg exists'
+        with _cfgfile.as_stream() as s:
+            _SCHEMES.readfp(s)
+        if _PYTHON_BUILD:
+            for scheme in ('posix_prefix', 'posix_home'):
+                _SCHEMES.set(scheme, 'include', '{srcdir}/Include')
+                _SCHEMES.set(scheme, 'platinclude', '{projectbase}/.')
+
+        _cfg_read = True
+
+
+_SCHEMES = configparser.RawConfigParser()
+_VAR_REPL = re.compile(r'\{([^{]*?)\}')
+
+def _expand_globals(config):
+    _ensure_cfg_read()
+    if config.has_section('globals'):
+        globals = config.items('globals')
+    else:
+        globals = tuple()
+
+    sections = config.sections()
+    for section in sections:
+        if section == 'globals':
+            continue
+        for option, value in globals:
+            if config.has_option(section, option):
+                continue
+            config.set(section, option, value)
+    config.remove_section('globals')
+
+    # now expanding local variables defined in the cfg file
+    #
+    for section in config.sections():
+        variables = dict(config.items(section))
+
+        def _replacer(matchobj):
+            name = matchobj.group(1)
+            if name in variables:
+                return variables[name]
+            return matchobj.group(0)
+
+        for option, value in config.items(section):
+            config.set(section, option, _VAR_REPL.sub(_replacer, value))
+
+#_expand_globals(_SCHEMES)
+
+_PY_VERSION = '%s.%s.%s' % sys.version_info[:3]
+_PY_VERSION_SHORT = '%s.%s' % sys.version_info[:2]
+_PY_VERSION_SHORT_NO_DOT = '%s%s' % sys.version_info[:2]
+_PREFIX = os.path.normpath(sys.prefix)
+_EXEC_PREFIX = os.path.normpath(sys.exec_prefix)
+_CONFIG_VARS = None
+_USER_BASE = None
+
+
+def _subst_vars(path, local_vars):
+    """In the string `path`, replace tokens like {some.thing} with the
+    corresponding value from the map `local_vars`.
+
+    If there is no corresponding value, leave the token unchanged.
+    """
+    def _replacer(matchobj):
+        name = matchobj.group(1)
+        if name in local_vars:
+            return local_vars[name]
+        elif name in os.environ:
+            return os.environ[name]
+        return matchobj.group(0)
+    return _VAR_REPL.sub(_replacer, path)
+
+
+def _extend_dict(target_dict, other_dict):
+    target_keys = target_dict.keys()
+    for key, value in other_dict.items():
+        if key in target_keys:
+            continue
+        target_dict[key] = value
+
+
+def _expand_vars(scheme, vars):
+    res = {}
+    if vars is None:
+        vars = {}
+    _extend_dict(vars, get_config_vars())
+
+    for key, value in _SCHEMES.items(scheme):
+        if os.name in ('posix', 'nt'):
+            value = os.path.expanduser(value)
+        res[key] = os.path.normpath(_subst_vars(value, vars))
+    return res
+
+
+def format_value(value, vars):
+    def _replacer(matchobj):
+        name = matchobj.group(1)
+        if name in vars:
+            return vars[name]
+        return matchobj.group(0)
+    return _VAR_REPL.sub(_replacer, value)
+
+
+def _get_default_scheme():
+    if os.name == 'posix':
+        # the default scheme for posix is posix_prefix
+        return 'posix_prefix'
+    return os.name
+
+
+def _getuserbase():
+    env_base = os.environ.get("PYTHONUSERBASE", None)
+
+    def joinuser(*args):
+        return os.path.expanduser(os.path.join(*args))
+
+    # what about 'os2emx', 'riscos' ?
+    if os.name == "nt":
+        base = os.environ.get("APPDATA") or "~"
+        if env_base:
+            return env_base
+        else:
+            return joinuser(base, "Python")
+
+    if sys.platform == "darwin":
+        framework = get_config_var("PYTHONFRAMEWORK")
+        if framework:
+            if env_base:
+                return env_base
+            else:
+                return joinuser("~", "Library", framework, "%d.%d" %
+                                sys.version_info[:2])
+
+    if env_base:
+        return env_base
+    else:
+        return joinuser("~", ".local")
+
+
+def _parse_makefile(filename, vars=None):
+    """Parse a Makefile-style file.
+
+    A dictionary containing name/value pairs is returned.  If an
+    optional dictionary is passed in as the second argument, it is
+    used instead of a new dictionary.
+    """
+    # Regexes needed for parsing Makefile (and similar syntaxes,
+    # like old-style Setup files).
+    _variable_rx = re.compile(r"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)")
+    _findvar1_rx = re.compile(r"\$\(([A-Za-z][A-Za-z0-9_]*)\)")
+    _findvar2_rx = re.compile(r"\${([A-Za-z][A-Za-z0-9_]*)}")
+
+    if vars is None:
+        vars = {}
+    done = {}
+    notdone = {}
+
+    with codecs.open(filename, encoding='utf-8', errors="surrogateescape") as f:
+        lines = f.readlines()
+
+    for line in lines:
+        if line.startswith('#') or line.strip() == '':
+            continue
+        m = _variable_rx.match(line)
+        if m:
+            n, v = m.group(1, 2)
+            v = v.strip()
+            # `$$' is a literal `$' in make
+            tmpv = v.replace('$$', '')
+
+            if "$" in tmpv:
+                notdone[n] = v
+            else:
+                try:
+                    v = int(v)
+                except ValueError:
+                    # insert literal `$'
+                    done[n] = v.replace('$$', '$')
+                else:
+                    done[n] = v
+
+    # do variable interpolation here
+    variables = list(notdone.keys())
+
+    # Variables with a 'PY_' prefix in the makefile. These need to
+    # be made available without that prefix through sysconfig.
+    # Special care is needed to ensure that variable expansion works, even
+    # if the expansion uses the name without a prefix.
+    renamed_variables = ('CFLAGS', 'LDFLAGS', 'CPPFLAGS')
+
+    while len(variables) > 0:
+        for name in tuple(variables):
+            value = notdone[name]
+            m = _findvar1_rx.search(value) or _findvar2_rx.search(value)
+            if m is not None:
+                n = m.group(1)
+                found = True
+                if n in done:
+                    item = str(done[n])
+                elif n in notdone:
+                    # get it on a subsequent round
+                    found = False
+                elif n in os.environ:
+                    # do it like make: fall back to environment
+                    item = os.environ[n]
+
+                elif n in renamed_variables:
+                    if (name.startswith('PY_') and
+                        name[3:] in renamed_variables):
+                        item = ""
+
+                    elif 'PY_' + n in notdone:
+                        found = False
+
+                    else:
+                        item = str(done['PY_' + n])
+
+                else:
+                    done[n] = item = ""
+
+                if found:
+                    after = value[m.end():]
+                    value = value[:m.start()] + item + after
+                    if "$" in after:
+                        notdone[name] = value
+                    else:
+                        try:
+                            value = int(value)
+                        except ValueError:
+                            done[name] = value.strip()
+                        else:
+                            done[name] = value
+                        variables.remove(name)
+
+                        if (name.startswith('PY_') and
+                            name[3:] in renamed_variables):
+
+                            name = name[3:]
+                            if name not in done:
+                                done[name] = value
+
+            else:
+                # bogus variable reference (e.g. "prefix=$/opt/python");
+                # just drop it since we can't deal
+                done[name] = value
+                variables.remove(name)
+
+    # strip spurious spaces
+    for k, v in done.items():
+        if isinstance(v, str):
+            done[k] = v.strip()
+
+    # save the results in the global dictionary
+    vars.update(done)
+    return vars
+
+
+def get_makefile_filename():
+    """Return the path of the Makefile."""
+    if _PYTHON_BUILD:
+        return os.path.join(_PROJECT_BASE, "Makefile")
+    if hasattr(sys, 'abiflags'):
+        config_dir_name = 'config-%s%s' % (_PY_VERSION_SHORT, sys.abiflags)
+    else:
+        config_dir_name = 'config'
+    return os.path.join(get_path('stdlib'), config_dir_name, 'Makefile')
+
+
+def _init_posix(vars):
+    """Initialize the module as appropriate for POSIX systems."""
+    # load the installed Makefile:
+    makefile = get_makefile_filename()
+    try:
+        _parse_makefile(makefile, vars)
+    except IOError as e:
+        msg = "invalid Python installation: unable to open %s" % makefile
+        if hasattr(e, "strerror"):
+            msg = msg + " (%s)" % e.strerror
+        raise IOError(msg)
+    # load the installed pyconfig.h:
+    config_h = get_config_h_filename()
+    try:
+        with open(config_h) as f:
+            parse_config_h(f, vars)
+    except IOError as e:
+        msg = "invalid Python installation: unable to open %s" % config_h
+        if hasattr(e, "strerror"):
+            msg = msg + " (%s)" % e.strerror
+        raise IOError(msg)
+    # On AIX, there are wrong paths to the linker scripts in the Makefile
+    # -- these paths are relative to the Python source, but when installed
+    # the scripts are in another directory.
+    if _PYTHON_BUILD:
+        vars['LDSHARED'] = vars['BLDSHARED']
+
+
+def _init_non_posix(vars):
+    """Initialize the module as appropriate for NT"""
+    # set basic install directories
+    vars['LIBDEST'] = get_path('stdlib')
+    vars['BINLIBDEST'] = get_path('platstdlib')
+    vars['INCLUDEPY'] = get_path('include')
+    vars['SO'] = '.pyd'
+    vars['EXE'] = '.exe'
+    vars['VERSION'] = _PY_VERSION_SHORT_NO_DOT
+    vars['BINDIR'] = os.path.dirname(_safe_realpath(sys.executable))
+
+#
+# public APIs
+#
+
+
+def parse_config_h(fp, vars=None):
+    """Parse a config.h-style file.
+
+    A dictionary containing name/value pairs is returned.  If an
+    optional dictionary is passed in as the second argument, it is
+    used instead of a new dictionary.
+    """
+    if vars is None:
+        vars = {}
+    define_rx = re.compile("#define ([A-Z][A-Za-z0-9_]+) (.*)\n")
+    undef_rx = re.compile("/[*] #undef ([A-Z][A-Za-z0-9_]+) [*]/\n")
+
+    while True:
+        line = fp.readline()
+        if not line:
+            break
+        m = define_rx.match(line)
+        if m:
+            n, v = m.group(1, 2)
+            try:
+                v = int(v)
+            except ValueError:
+                pass
+            vars[n] = v
+        else:
+            m = undef_rx.match(line)
+            if m:
+                vars[m.group(1)] = 0
+    return vars
+
+
+def get_config_h_filename():
+    """Return the path of pyconfig.h."""
+    if _PYTHON_BUILD:
+        if os.name == "nt":
+            inc_dir = os.path.join(_PROJECT_BASE, "PC")
+        else:
+            inc_dir = _PROJECT_BASE
+    else:
+        inc_dir = get_path('platinclude')
+    return os.path.join(inc_dir, 'pyconfig.h')
+
+
+def get_scheme_names():
+    """Return a tuple containing the schemes names."""
+    return tuple(sorted(_SCHEMES.sections()))
+
+
+def get_path_names():
+    """Return a tuple containing the paths names."""
+    # xxx see if we want a static list
+    return _SCHEMES.options('posix_prefix')
+
+
+def get_paths(scheme=_get_default_scheme(), vars=None, expand=True):
+    """Return a mapping containing an install scheme.
+
+    ``scheme`` is the install scheme name. If not provided, it will
+    return the default scheme for the current platform.
+    """
+    _ensure_cfg_read()
+    if expand:
+        return _expand_vars(scheme, vars)
+    else:
+        return dict(_SCHEMES.items(scheme))
+
+
+def get_path(name, scheme=_get_default_scheme(), vars=None, expand=True):
+    """Return a path corresponding to the scheme.
+
+    ``scheme`` is the install scheme name.
+    """
+    return get_paths(scheme, vars, expand)[name]
+
+
+def get_config_vars(*args):
+    """With no arguments, return a dictionary of all configuration
+    variables relevant for the current platform.
+
+    On Unix, this means every variable defined in Python's installed Makefile;
+    On Windows and Mac OS it's a much smaller set.
+
+    With arguments, return a list of values that result from looking up
+    each argument in the configuration variable dictionary.
+    """
+    global _CONFIG_VARS
+    if _CONFIG_VARS is None:
+        _CONFIG_VARS = {}
+        # Normalized versions of prefix and exec_prefix are handy to have;
+        # in fact, these are the standard versions used most places in the
+        # distutils2 module.
+        _CONFIG_VARS['prefix'] = _PREFIX
+        _CONFIG_VARS['exec_prefix'] = _EXEC_PREFIX
+        _CONFIG_VARS['py_version'] = _PY_VERSION
+        _CONFIG_VARS['py_version_short'] = _PY_VERSION_SHORT
+        _CONFIG_VARS['py_version_nodot'] = _PY_VERSION[0] + _PY_VERSION[2]
+        _CONFIG_VARS['base'] = _PREFIX
+        _CONFIG_VARS['platbase'] = _EXEC_PREFIX
+        _CONFIG_VARS['projectbase'] = _PROJECT_BASE
+        try:
+            _CONFIG_VARS['abiflags'] = sys.abiflags
+        except AttributeError:
+            # sys.abiflags may not be defined on all platforms.
+            _CONFIG_VARS['abiflags'] = ''
+
+        if os.name in ('nt', 'os2'):
+            _init_non_posix(_CONFIG_VARS)
+        if os.name == 'posix':
+            _init_posix(_CONFIG_VARS)
+        # Setting 'userbase' is done below the call to the
+        # init function to enable using 'get_config_var' in
+        # the init-function.
+        if sys.version >= '2.6':
+            _CONFIG_VARS['userbase'] = _getuserbase()
+
+        if 'srcdir' not in _CONFIG_VARS:
+            _CONFIG_VARS['srcdir'] = _PROJECT_BASE
+        else:
+            _CONFIG_VARS['srcdir'] = _safe_realpath(_CONFIG_VARS['srcdir'])
+
+        # Convert srcdir into an absolute path if it appears necessary.
+        # Normally it is relative to the build directory.  However, during
+        # testing, for example, we might be running a non-installed python
+        # from a different directory.
+        if _PYTHON_BUILD and os.name == "posix":
+            base = _PROJECT_BASE
+            try:
+                cwd = os.getcwd()
+            except OSError:
+                cwd = None
+            if (not os.path.isabs(_CONFIG_VARS['srcdir']) and
+                base != cwd):
+                # srcdir is relative and we are not in the same directory
+                # as the executable. Assume executable is in the build
+                # directory and make srcdir absolute.
+                srcdir = os.path.join(base, _CONFIG_VARS['srcdir'])
+                _CONFIG_VARS['srcdir'] = os.path.normpath(srcdir)
+
+        if sys.platform == 'darwin':
+            kernel_version = os.uname()[2]  # Kernel version (8.4.3)
+            major_version = int(kernel_version.split('.')[0])
+
+            if major_version < 8:
+                # On Mac OS X before 10.4, check if -arch and -isysroot
+                # are in CFLAGS or LDFLAGS and remove them if they are.
+                # This is needed when building extensions on a 10.3 system
+                # using a universal build of python.
+                for key in ('LDFLAGS', 'BASECFLAGS',
+                        # a number of derived variables. These need to be
+                        # patched up as well.
+                        'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):
+                    flags = _CONFIG_VARS[key]
+                    flags = re.sub(r'-arch\s+\w+\s', ' ', flags)
+                    flags = re.sub('-isysroot [^ \t]*', ' ', flags)
+                    _CONFIG_VARS[key] = flags
+            else:
+                # Allow the user to override the architecture flags using
+                # an environment variable.
+                # NOTE: This name was introduced by Apple in OSX 10.5 and
+                # is used by several scripting languages distributed with
+                # that OS release.
+                if 'ARCHFLAGS' in os.environ:
+                    arch = os.environ['ARCHFLAGS']
+                    for key in ('LDFLAGS', 'BASECFLAGS',
+                        # a number of derived variables. These need to be
+                        # patched up as well.
+                        'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):
+
+                        flags = _CONFIG_VARS[key]
+                        flags = re.sub(r'-arch\s+\w+\s', ' ', flags)
+                        flags = flags + ' ' + arch
+                        _CONFIG_VARS[key] = flags
+
+                # If we're on OSX 10.5 or later and the user tries to
+                # compiles an extension using an SDK that is not present
+                # on the current machine it is better to not use an SDK
+                # than to fail.
+                #
+                # The major usecase for this is users using a Python.org
+                # binary installer  on OSX 10.6: that installer uses
+                # the 10.4u SDK, but that SDK is not installed by default
+                # when you install Xcode.
+                #
+                CFLAGS = _CONFIG_VARS.get('CFLAGS', '')
+                m = re.search(r'-isysroot\s+(\S+)', CFLAGS)
+                if m is not None:
+                    sdk = m.group(1)
+                    if not os.path.exists(sdk):
+                        for key in ('LDFLAGS', 'BASECFLAGS',
+                             # a number of derived variables. These need to be
+                             # patched up as well.
+                            'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):
+
+                            flags = _CONFIG_VARS[key]
+                            flags = re.sub(r'-isysroot\s+\S+(\s|$)', ' ', flags)
+                            _CONFIG_VARS[key] = flags
+
+    if args:
+        vals = []
+        for name in args:
+            vals.append(_CONFIG_VARS.get(name))
+        return vals
+    else:
+        return _CONFIG_VARS
+
+
+def get_config_var(name):
+    """Return the value of a single variable using the dictionary returned by
+    'get_config_vars()'.
+
+    Equivalent to get_config_vars().get(name)
+    """
+    return get_config_vars().get(name)
+
+
+def get_platform():
+    """Return a string that identifies the current platform.
+
+    This is used mainly to distinguish platform-specific build directories and
+    platform-specific built distributions.  Typically includes the OS name
+    and version and the architecture (as supplied by 'os.uname()'),
+    although the exact information included depends on the OS; eg. for IRIX
+    the architecture isn't particularly important (IRIX only runs on SGI
+    hardware), but for Linux the kernel version isn't particularly
+    important.
+
+    Examples of returned values:
+       linux-i586
+       linux-alpha (?)
+       solaris-2.6-sun4u
+       irix-5.3
+       irix64-6.2
+
+    Windows will return one of:
+       win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)
+       win-ia64 (64bit Windows on Itanium)
+       win32 (all others - specifically, sys.platform is returned)
+
+    For other non-POSIX platforms, currently just returns 'sys.platform'.
+    """
+    if os.name == 'nt':
+        # sniff sys.version for architecture.
+        prefix = " bit ("
+        i = sys.version.find(prefix)
+        if i == -1:
+            return sys.platform
+        j = sys.version.find(")", i)
+        look = sys.version[i+len(prefix):j].lower()
+        if look == 'amd64':
+            return 'win-amd64'
+        if look == 'itanium':
+            return 'win-ia64'
+        return sys.platform
+
+    if os.name != "posix" or not hasattr(os, 'uname'):
+        # XXX what about the architecture? NT is Intel or Alpha,
+        # Mac OS is M68k or PPC, etc.
+        return sys.platform
+
+    # Try to distinguish various flavours of Unix
+    osname, host, release, version, machine = os.uname()
+
+    # Convert the OS name to lowercase, remove '/' characters
+    # (to accommodate BSD/OS), and translate spaces (for "Power Macintosh")
+    osname = osname.lower().replace('/', '')
+    machine = machine.replace(' ', '_')
+    machine = machine.replace('/', '-')
+
+    if osname[:5] == "linux":
+        # At least on Linux/Intel, 'machine' is the processor --
+        # i386, etc.
+        # XXX what about Alpha, SPARC, etc?
+        return  "%s-%s" % (osname, machine)
+    elif osname[:5] == "sunos":
+        if release[0] >= "5":           # SunOS 5 == Solaris 2
+            osname = "solaris"
+            release = "%d.%s" % (int(release[0]) - 3, release[2:])
+        # fall through to standard osname-release-machine representation
+    elif osname[:4] == "irix":              # could be "irix64"!
+        return "%s-%s" % (osname, release)
+    elif osname[:3] == "aix":
+        return "%s-%s.%s" % (osname, version, release)
+    elif osname[:6] == "cygwin":
+        osname = "cygwin"
+        rel_re = re.compile(r'[\d.]+')
+        m = rel_re.match(release)
+        if m:
+            release = m.group()
+    elif osname[:6] == "darwin":
+        #
+        # For our purposes, we'll assume that the system version from
+        # distutils' perspective is what MACOSX_DEPLOYMENT_TARGET is set
+        # to. This makes the compatibility story a bit more sane because the
+        # machine is going to compile and link as if it were
+        # MACOSX_DEPLOYMENT_TARGET.
+        cfgvars = get_config_vars()
+        macver = cfgvars.get('MACOSX_DEPLOYMENT_TARGET')
+
+        if True:
+            # Always calculate the release of the running machine,
+            # needed to determine if we can build fat binaries or not.
+
+            macrelease = macver
+            # Get the system version. Reading this plist is a documented
+            # way to get the system version (see the documentation for
+            # the Gestalt Manager)
+            try:
+                f = open('/System/Library/CoreServices/SystemVersion.plist')
+            except IOError:
+                # We're on a plain darwin box, fall back to the default
+                # behaviour.
+                pass
+            else:
+                try:
+                    m = re.search(r'<key>ProductUserVisibleVersion</key>\s*'
+                                  r'<string>(.*?)</string>', f.read())
+                finally:
+                    f.close()
+                if m is not None:
+                    macrelease = '.'.join(m.group(1).split('.')[:2])
+                # else: fall back to the default behaviour
+
+        if not macver:
+            macver = macrelease
+
+        if macver:
+            release = macver
+            osname = "macosx"
+
+            if ((macrelease + '.') >= '10.4.' and
+                '-arch' in get_config_vars().get('CFLAGS', '').strip()):
+                # The universal build will build fat binaries, but not on
+                # systems before 10.4
+                #
+                # Try to detect 4-way universal builds, those have machine-type
+                # 'universal' instead of 'fat'.
+
+                machine = 'fat'
+                cflags = get_config_vars().get('CFLAGS')
+
+                archs = re.findall(r'-arch\s+(\S+)', cflags)
+                archs = tuple(sorted(set(archs)))
+
+                if len(archs) == 1:
+                    machine = archs[0]
+                elif archs == ('i386', 'ppc'):
+                    machine = 'fat'
+                elif archs == ('i386', 'x86_64'):
+                    machine = 'intel'
+                elif archs == ('i386', 'ppc', 'x86_64'):
+                    machine = 'fat3'
+                elif archs == ('ppc64', 'x86_64'):
+                    machine = 'fat64'
+                elif archs == ('i386', 'ppc', 'ppc64', 'x86_64'):
+                    machine = 'universal'
+                else:
+                    raise ValueError(
+                       "Don't know machine value for archs=%r" % (archs,))
+
+            elif machine == 'i386':
+                # On OSX the machine type returned by uname is always the
+                # 32-bit variant, even if the executable architecture is
+                # the 64-bit variant
+                if sys.maxsize >= 2**32:
+                    machine = 'x86_64'
+
+            elif machine in ('PowerPC', 'Power_Macintosh'):
+                # Pick a sane name for the PPC architecture.
+                # See 'i386' case
+                if sys.maxsize >= 2**32:
+                    machine = 'ppc64'
+                else:
+                    machine = 'ppc'
+
+    return "%s-%s-%s" % (osname, release, machine)
+
+
+def get_python_version():
+    return _PY_VERSION_SHORT
+
+
+def _print_dict(title, data):
+    for index, (key, value) in enumerate(sorted(data.items())):
+        if index == 0:
+            print('%s: ' % (title))
+        print('\t%s = "%s"' % (key, value))
+
+
+def _main():
+    """Display all information sysconfig detains."""
+    print('Platform: "%s"' % get_platform())
+    print('Python version: "%s"' % get_python_version())
+    print('Current installation scheme: "%s"' % _get_default_scheme())
+    print()
+    _print_dict('Paths', get_paths())
+    print()
+    _print_dict('Variables', get_config_vars())
+
+
+if __name__ == '__main__':
+    _main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/tarfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/tarfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..d66d8566374be661085213468bce338c6a747702
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/_backport/tarfile.py
@@ -0,0 +1,2607 @@
+#-------------------------------------------------------------------
+# tarfile.py
+#-------------------------------------------------------------------
+# Copyright (C) 2002 Lars Gustaebel <lars@gustaebel.de>
+# All rights reserved.
+#
+# Permission  is  hereby granted,  free  of charge,  to  any person
+# obtaining a  copy of  this software  and associated documentation
+# files  (the  "Software"),  to   deal  in  the  Software   without
+# restriction,  including  without limitation  the  rights to  use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies  of  the  Software,  and to  permit  persons  to  whom the
+# Software  is  furnished  to  do  so,  subject  to  the  following
+# conditions:
+#
+# The above copyright  notice and this  permission notice shall  be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS  IS", WITHOUT WARRANTY OF ANY  KIND,
+# EXPRESS OR IMPLIED, INCLUDING  BUT NOT LIMITED TO  THE WARRANTIES
+# OF  MERCHANTABILITY,  FITNESS   FOR  A  PARTICULAR   PURPOSE  AND
+# NONINFRINGEMENT.  IN  NO  EVENT SHALL  THE  AUTHORS  OR COPYRIGHT
+# HOLDERS  BE LIABLE  FOR ANY  CLAIM, DAMAGES  OR OTHER  LIABILITY,
+# WHETHER  IN AN  ACTION OF  CONTRACT, TORT  OR OTHERWISE,  ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+#
+from __future__ import print_function
+
+"""Read from and write to tar format archives.
+"""
+
+__version__ = "$Revision$"
+
+version     = "0.9.0"
+__author__  = "Lars Gust\u00e4bel (lars@gustaebel.de)"
+__date__    = "$Date: 2011-02-25 17:42:01 +0200 (Fri, 25 Feb 2011) $"
+__cvsid__   = "$Id: tarfile.py 88586 2011-02-25 15:42:01Z marc-andre.lemburg $"
+__credits__ = "Gustavo Niemeyer, Niels Gust\u00e4bel, Richard Townsend."
+
+#---------
+# Imports
+#---------
+import sys
+import os
+import stat
+import errno
+import time
+import struct
+import copy
+import re
+
+try:
+    import grp, pwd
+except ImportError:
+    grp = pwd = None
+
+# os.symlink on Windows prior to 6.0 raises NotImplementedError
+symlink_exception = (AttributeError, NotImplementedError)
+try:
+    # WindowsError (1314) will be raised if the caller does not hold the
+    # SeCreateSymbolicLinkPrivilege privilege
+    symlink_exception += (WindowsError,)
+except NameError:
+    pass
+
+# from tarfile import *
+__all__ = ["TarFile", "TarInfo", "is_tarfile", "TarError"]
+
+if sys.version_info[0] < 3:
+    import __builtin__ as builtins
+else:
+    import builtins
+
+_open = builtins.open   # Since 'open' is TarFile.open
+
+#---------------------------------------------------------
+# tar constants
+#---------------------------------------------------------
+NUL = b"\0"                     # the null character
+BLOCKSIZE = 512                 # length of processing blocks
+RECORDSIZE = BLOCKSIZE * 20     # length of records
+GNU_MAGIC = b"ustar  \0"        # magic gnu tar string
+POSIX_MAGIC = b"ustar\x0000"    # magic posix tar string
+
+LENGTH_NAME = 100               # maximum length of a filename
+LENGTH_LINK = 100               # maximum length of a linkname
+LENGTH_PREFIX = 155             # maximum length of the prefix field
+
+REGTYPE = b"0"                  # regular file
+AREGTYPE = b"\0"                # regular file
+LNKTYPE = b"1"                  # link (inside tarfile)
+SYMTYPE = b"2"                  # symbolic link
+CHRTYPE = b"3"                  # character special device
+BLKTYPE = b"4"                  # block special device
+DIRTYPE = b"5"                  # directory
+FIFOTYPE = b"6"                 # fifo special device
+CONTTYPE = b"7"                 # contiguous file
+
+GNUTYPE_LONGNAME = b"L"         # GNU tar longname
+GNUTYPE_LONGLINK = b"K"         # GNU tar longlink
+GNUTYPE_SPARSE = b"S"           # GNU tar sparse file
+
+XHDTYPE = b"x"                  # POSIX.1-2001 extended header
+XGLTYPE = b"g"                  # POSIX.1-2001 global header
+SOLARIS_XHDTYPE = b"X"          # Solaris extended header
+
+USTAR_FORMAT = 0                # POSIX.1-1988 (ustar) format
+GNU_FORMAT = 1                  # GNU tar format
+PAX_FORMAT = 2                  # POSIX.1-2001 (pax) format
+DEFAULT_FORMAT = GNU_FORMAT
+
+#---------------------------------------------------------
+# tarfile constants
+#---------------------------------------------------------
+# File types that tarfile supports:
+SUPPORTED_TYPES = (REGTYPE, AREGTYPE, LNKTYPE,
+                   SYMTYPE, DIRTYPE, FIFOTYPE,
+                   CONTTYPE, CHRTYPE, BLKTYPE,
+                   GNUTYPE_LONGNAME, GNUTYPE_LONGLINK,
+                   GNUTYPE_SPARSE)
+
+# File types that will be treated as a regular file.
+REGULAR_TYPES = (REGTYPE, AREGTYPE,
+                 CONTTYPE, GNUTYPE_SPARSE)
+
+# File types that are part of the GNU tar format.
+GNU_TYPES = (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK,
+             GNUTYPE_SPARSE)
+
+# Fields from a pax header that override a TarInfo attribute.
+PAX_FIELDS = ("path", "linkpath", "size", "mtime",
+              "uid", "gid", "uname", "gname")
+
+# Fields from a pax header that are affected by hdrcharset.
+PAX_NAME_FIELDS = set(("path", "linkpath", "uname", "gname"))
+
+# Fields in a pax header that are numbers, all other fields
+# are treated as strings.
+PAX_NUMBER_FIELDS = {
+    "atime": float,
+    "ctime": float,
+    "mtime": float,
+    "uid": int,
+    "gid": int,
+    "size": int
+}
+
+#---------------------------------------------------------
+# Bits used in the mode field, values in octal.
+#---------------------------------------------------------
+S_IFLNK = 0o120000        # symbolic link
+S_IFREG = 0o100000        # regular file
+S_IFBLK = 0o060000        # block device
+S_IFDIR = 0o040000        # directory
+S_IFCHR = 0o020000        # character device
+S_IFIFO = 0o010000        # fifo
+
+TSUID   = 0o4000          # set UID on execution
+TSGID   = 0o2000          # set GID on execution
+TSVTX   = 0o1000          # reserved
+
+TUREAD  = 0o400           # read by owner
+TUWRITE = 0o200           # write by owner
+TUEXEC  = 0o100           # execute/search by owner
+TGREAD  = 0o040           # read by group
+TGWRITE = 0o020           # write by group
+TGEXEC  = 0o010           # execute/search by group
+TOREAD  = 0o004           # read by other
+TOWRITE = 0o002           # write by other
+TOEXEC  = 0o001           # execute/search by other
+
+#---------------------------------------------------------
+# initialization
+#---------------------------------------------------------
+if os.name in ("nt", "ce"):
+    ENCODING = "utf-8"
+else:
+    ENCODING = sys.getfilesystemencoding()
+
+#---------------------------------------------------------
+# Some useful functions
+#---------------------------------------------------------
+
+def stn(s, length, encoding, errors):
+    """Convert a string to a null-terminated bytes object.
+    """
+    s = s.encode(encoding, errors)
+    return s[:length] + (length - len(s)) * NUL
+
+def nts(s, encoding, errors):
+    """Convert a null-terminated bytes object to a string.
+    """
+    p = s.find(b"\0")
+    if p != -1:
+        s = s[:p]
+    return s.decode(encoding, errors)
+
+def nti(s):
+    """Convert a number field to a python number.
+    """
+    # There are two possible encodings for a number field, see
+    # itn() below.
+    if s[0] != chr(0o200):
+        try:
+            n = int(nts(s, "ascii", "strict") or "0", 8)
+        except ValueError:
+            raise InvalidHeaderError("invalid header")
+    else:
+        n = 0
+        for i in range(len(s) - 1):
+            n <<= 8
+            n += ord(s[i + 1])
+    return n
+
+def itn(n, digits=8, format=DEFAULT_FORMAT):
+    """Convert a python number to a number field.
+    """
+    # POSIX 1003.1-1988 requires numbers to be encoded as a string of
+    # octal digits followed by a null-byte, this allows values up to
+    # (8**(digits-1))-1. GNU tar allows storing numbers greater than
+    # that if necessary. A leading 0o200 byte indicates this particular
+    # encoding, the following digits-1 bytes are a big-endian
+    # representation. This allows values up to (256**(digits-1))-1.
+    if 0 <= n < 8 ** (digits - 1):
+        s = ("%0*o" % (digits - 1, n)).encode("ascii") + NUL
+    else:
+        if format != GNU_FORMAT or n >= 256 ** (digits - 1):
+            raise ValueError("overflow in number field")
+
+        if n < 0:
+            # XXX We mimic GNU tar's behaviour with negative numbers,
+            # this could raise OverflowError.
+            n = struct.unpack("L", struct.pack("l", n))[0]
+
+        s = bytearray()
+        for i in range(digits - 1):
+            s.insert(0, n & 0o377)
+            n >>= 8
+        s.insert(0, 0o200)
+    return s
+
+def calc_chksums(buf):
+    """Calculate the checksum for a member's header by summing up all
+       characters except for the chksum field which is treated as if
+       it was filled with spaces. According to the GNU tar sources,
+       some tars (Sun and NeXT) calculate chksum with signed char,
+       which will be different if there are chars in the buffer with
+       the high bit set. So we calculate two checksums, unsigned and
+       signed.
+    """
+    unsigned_chksum = 256 + sum(struct.unpack("148B", buf[:148]) + struct.unpack("356B", buf[156:512]))
+    signed_chksum = 256 + sum(struct.unpack("148b", buf[:148]) + struct.unpack("356b", buf[156:512]))
+    return unsigned_chksum, signed_chksum
+
+def copyfileobj(src, dst, length=None):
+    """Copy length bytes from fileobj src to fileobj dst.
+       If length is None, copy the entire content.
+    """
+    if length == 0:
+        return
+    if length is None:
+        while True:
+            buf = src.read(16*1024)
+            if not buf:
+                break
+            dst.write(buf)
+        return
+
+    BUFSIZE = 16 * 1024
+    blocks, remainder = divmod(length, BUFSIZE)
+    for b in range(blocks):
+        buf = src.read(BUFSIZE)
+        if len(buf) < BUFSIZE:
+            raise IOError("end of file reached")
+        dst.write(buf)
+
+    if remainder != 0:
+        buf = src.read(remainder)
+        if len(buf) < remainder:
+            raise IOError("end of file reached")
+        dst.write(buf)
+    return
+
+filemode_table = (
+    ((S_IFLNK,      "l"),
+     (S_IFREG,      "-"),
+     (S_IFBLK,      "b"),
+     (S_IFDIR,      "d"),
+     (S_IFCHR,      "c"),
+     (S_IFIFO,      "p")),
+
+    ((TUREAD,       "r"),),
+    ((TUWRITE,      "w"),),
+    ((TUEXEC|TSUID, "s"),
+     (TSUID,        "S"),
+     (TUEXEC,       "x")),
+
+    ((TGREAD,       "r"),),
+    ((TGWRITE,      "w"),),
+    ((TGEXEC|TSGID, "s"),
+     (TSGID,        "S"),
+     (TGEXEC,       "x")),
+
+    ((TOREAD,       "r"),),
+    ((TOWRITE,      "w"),),
+    ((TOEXEC|TSVTX, "t"),
+     (TSVTX,        "T"),
+     (TOEXEC,       "x"))
+)
+
+def filemode(mode):
+    """Convert a file's mode to a string of the form
+       -rwxrwxrwx.
+       Used by TarFile.list()
+    """
+    perm = []
+    for table in filemode_table:
+        for bit, char in table:
+            if mode & bit == bit:
+                perm.append(char)
+                break
+        else:
+            perm.append("-")
+    return "".join(perm)
+
+class TarError(Exception):
+    """Base exception."""
+    pass
+class ExtractError(TarError):
+    """General exception for extract errors."""
+    pass
+class ReadError(TarError):
+    """Exception for unreadable tar archives."""
+    pass
+class CompressionError(TarError):
+    """Exception for unavailable compression methods."""
+    pass
+class StreamError(TarError):
+    """Exception for unsupported operations on stream-like TarFiles."""
+    pass
+class HeaderError(TarError):
+    """Base exception for header errors."""
+    pass
+class EmptyHeaderError(HeaderError):
+    """Exception for empty headers."""
+    pass
+class TruncatedHeaderError(HeaderError):
+    """Exception for truncated headers."""
+    pass
+class EOFHeaderError(HeaderError):
+    """Exception for end of file headers."""
+    pass
+class InvalidHeaderError(HeaderError):
+    """Exception for invalid headers."""
+    pass
+class SubsequentHeaderError(HeaderError):
+    """Exception for missing and invalid extended headers."""
+    pass
+
+#---------------------------
+# internal stream interface
+#---------------------------
+class _LowLevelFile(object):
+    """Low-level file object. Supports reading and writing.
+       It is used instead of a regular file object for streaming
+       access.
+    """
+
+    def __init__(self, name, mode):
+        mode = {
+            "r": os.O_RDONLY,
+            "w": os.O_WRONLY | os.O_CREAT | os.O_TRUNC,
+        }[mode]
+        if hasattr(os, "O_BINARY"):
+            mode |= os.O_BINARY
+        self.fd = os.open(name, mode, 0o666)
+
+    def close(self):
+        os.close(self.fd)
+
+    def read(self, size):
+        return os.read(self.fd, size)
+
+    def write(self, s):
+        os.write(self.fd, s)
+
+class _Stream(object):
+    """Class that serves as an adapter between TarFile and
+       a stream-like object.  The stream-like object only
+       needs to have a read() or write() method and is accessed
+       blockwise.  Use of gzip or bzip2 compression is possible.
+       A stream-like object could be for example: sys.stdin,
+       sys.stdout, a socket, a tape device etc.
+
+       _Stream is intended to be used only internally.
+    """
+
+    def __init__(self, name, mode, comptype, fileobj, bufsize):
+        """Construct a _Stream object.
+        """
+        self._extfileobj = True
+        if fileobj is None:
+            fileobj = _LowLevelFile(name, mode)
+            self._extfileobj = False
+
+        if comptype == '*':
+            # Enable transparent compression detection for the
+            # stream interface
+            fileobj = _StreamProxy(fileobj)
+            comptype = fileobj.getcomptype()
+
+        self.name     = name or ""
+        self.mode     = mode
+        self.comptype = comptype
+        self.fileobj  = fileobj
+        self.bufsize  = bufsize
+        self.buf      = b""
+        self.pos      = 0
+        self.closed   = False
+
+        try:
+            if comptype == "gz":
+                try:
+                    import zlib
+                except ImportError:
+                    raise CompressionError("zlib module is not available")
+                self.zlib = zlib
+                self.crc = zlib.crc32(b"")
+                if mode == "r":
+                    self._init_read_gz()
+                else:
+                    self._init_write_gz()
+
+            if comptype == "bz2":
+                try:
+                    import bz2
+                except ImportError:
+                    raise CompressionError("bz2 module is not available")
+                if mode == "r":
+                    self.dbuf = b""
+                    self.cmp = bz2.BZ2Decompressor()
+                else:
+                    self.cmp = bz2.BZ2Compressor()
+        except:
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+            raise
+
+    def __del__(self):
+        if hasattr(self, "closed") and not self.closed:
+            self.close()
+
+    def _init_write_gz(self):
+        """Initialize for writing with gzip compression.
+        """
+        self.cmp = self.zlib.compressobj(9, self.zlib.DEFLATED,
+                                            -self.zlib.MAX_WBITS,
+                                            self.zlib.DEF_MEM_LEVEL,
+                                            0)
+        timestamp = struct.pack("<L", int(time.time()))
+        self.__write(b"\037\213\010\010" + timestamp + b"\002\377")
+        if self.name.endswith(".gz"):
+            self.name = self.name[:-3]
+        # RFC1952 says we must use ISO-8859-1 for the FNAME field.
+        self.__write(self.name.encode("iso-8859-1", "replace") + NUL)
+
+    def write(self, s):
+        """Write string s to the stream.
+        """
+        if self.comptype == "gz":
+            self.crc = self.zlib.crc32(s, self.crc)
+        self.pos += len(s)
+        if self.comptype != "tar":
+            s = self.cmp.compress(s)
+        self.__write(s)
+
+    def __write(self, s):
+        """Write string s to the stream if a whole new block
+           is ready to be written.
+        """
+        self.buf += s
+        while len(self.buf) > self.bufsize:
+            self.fileobj.write(self.buf[:self.bufsize])
+            self.buf = self.buf[self.bufsize:]
+
+    def close(self):
+        """Close the _Stream object. No operation should be
+           done on it afterwards.
+        """
+        if self.closed:
+            return
+
+        if self.mode == "w" and self.comptype != "tar":
+            self.buf += self.cmp.flush()
+
+        if self.mode == "w" and self.buf:
+            self.fileobj.write(self.buf)
+            self.buf = b""
+            if self.comptype == "gz":
+                # The native zlib crc is an unsigned 32-bit integer, but
+                # the Python wrapper implicitly casts that to a signed C
+                # long.  So, on a 32-bit box self.crc may "look negative",
+                # while the same crc on a 64-bit box may "look positive".
+                # To avoid irksome warnings from the `struct` module, force
+                # it to look positive on all boxes.
+                self.fileobj.write(struct.pack("<L", self.crc & 0xffffffff))
+                self.fileobj.write(struct.pack("<L", self.pos & 0xffffFFFF))
+
+        if not self._extfileobj:
+            self.fileobj.close()
+
+        self.closed = True
+
+    def _init_read_gz(self):
+        """Initialize for reading a gzip compressed fileobj.
+        """
+        self.cmp = self.zlib.decompressobj(-self.zlib.MAX_WBITS)
+        self.dbuf = b""
+
+        # taken from gzip.GzipFile with some alterations
+        if self.__read(2) != b"\037\213":
+            raise ReadError("not a gzip file")
+        if self.__read(1) != b"\010":
+            raise CompressionError("unsupported compression method")
+
+        flag = ord(self.__read(1))
+        self.__read(6)
+
+        if flag & 4:
+            xlen = ord(self.__read(1)) + 256 * ord(self.__read(1))
+            self.read(xlen)
+        if flag & 8:
+            while True:
+                s = self.__read(1)
+                if not s or s == NUL:
+                    break
+        if flag & 16:
+            while True:
+                s = self.__read(1)
+                if not s or s == NUL:
+                    break
+        if flag & 2:
+            self.__read(2)
+
+    def tell(self):
+        """Return the stream's file pointer position.
+        """
+        return self.pos
+
+    def seek(self, pos=0):
+        """Set the stream's file pointer to pos. Negative seeking
+           is forbidden.
+        """
+        if pos - self.pos >= 0:
+            blocks, remainder = divmod(pos - self.pos, self.bufsize)
+            for i in range(blocks):
+                self.read(self.bufsize)
+            self.read(remainder)
+        else:
+            raise StreamError("seeking backwards is not allowed")
+        return self.pos
+
+    def read(self, size=None):
+        """Return the next size number of bytes from the stream.
+           If size is not defined, return all bytes of the stream
+           up to EOF.
+        """
+        if size is None:
+            t = []
+            while True:
+                buf = self._read(self.bufsize)
+                if not buf:
+                    break
+                t.append(buf)
+            buf = "".join(t)
+        else:
+            buf = self._read(size)
+        self.pos += len(buf)
+        return buf
+
+    def _read(self, size):
+        """Return size bytes from the stream.
+        """
+        if self.comptype == "tar":
+            return self.__read(size)
+
+        c = len(self.dbuf)
+        while c < size:
+            buf = self.__read(self.bufsize)
+            if not buf:
+                break
+            try:
+                buf = self.cmp.decompress(buf)
+            except IOError:
+                raise ReadError("invalid compressed data")
+            self.dbuf += buf
+            c += len(buf)
+        buf = self.dbuf[:size]
+        self.dbuf = self.dbuf[size:]
+        return buf
+
+    def __read(self, size):
+        """Return size bytes from stream. If internal buffer is empty,
+           read another block from the stream.
+        """
+        c = len(self.buf)
+        while c < size:
+            buf = self.fileobj.read(self.bufsize)
+            if not buf:
+                break
+            self.buf += buf
+            c += len(buf)
+        buf = self.buf[:size]
+        self.buf = self.buf[size:]
+        return buf
+# class _Stream
+
+class _StreamProxy(object):
+    """Small proxy class that enables transparent compression
+       detection for the Stream interface (mode 'r|*').
+    """
+
+    def __init__(self, fileobj):
+        self.fileobj = fileobj
+        self.buf = self.fileobj.read(BLOCKSIZE)
+
+    def read(self, size):
+        self.read = self.fileobj.read
+        return self.buf
+
+    def getcomptype(self):
+        if self.buf.startswith(b"\037\213\010"):
+            return "gz"
+        if self.buf.startswith(b"BZh91"):
+            return "bz2"
+        return "tar"
+
+    def close(self):
+        self.fileobj.close()
+# class StreamProxy
+
+class _BZ2Proxy(object):
+    """Small proxy class that enables external file object
+       support for "r:bz2" and "w:bz2" modes. This is actually
+       a workaround for a limitation in bz2 module's BZ2File
+       class which (unlike gzip.GzipFile) has no support for
+       a file object argument.
+    """
+
+    blocksize = 16 * 1024
+
+    def __init__(self, fileobj, mode):
+        self.fileobj = fileobj
+        self.mode = mode
+        self.name = getattr(self.fileobj, "name", None)
+        self.init()
+
+    def init(self):
+        import bz2
+        self.pos = 0
+        if self.mode == "r":
+            self.bz2obj = bz2.BZ2Decompressor()
+            self.fileobj.seek(0)
+            self.buf = b""
+        else:
+            self.bz2obj = bz2.BZ2Compressor()
+
+    def read(self, size):
+        x = len(self.buf)
+        while x < size:
+            raw = self.fileobj.read(self.blocksize)
+            if not raw:
+                break
+            data = self.bz2obj.decompress(raw)
+            self.buf += data
+            x += len(data)
+
+        buf = self.buf[:size]
+        self.buf = self.buf[size:]
+        self.pos += len(buf)
+        return buf
+
+    def seek(self, pos):
+        if pos < self.pos:
+            self.init()
+        self.read(pos - self.pos)
+
+    def tell(self):
+        return self.pos
+
+    def write(self, data):
+        self.pos += len(data)
+        raw = self.bz2obj.compress(data)
+        self.fileobj.write(raw)
+
+    def close(self):
+        if self.mode == "w":
+            raw = self.bz2obj.flush()
+            self.fileobj.write(raw)
+# class _BZ2Proxy
+
+#------------------------
+# Extraction file object
+#------------------------
+class _FileInFile(object):
+    """A thin wrapper around an existing file object that
+       provides a part of its data as an individual file
+       object.
+    """
+
+    def __init__(self, fileobj, offset, size, blockinfo=None):
+        self.fileobj = fileobj
+        self.offset = offset
+        self.size = size
+        self.position = 0
+
+        if blockinfo is None:
+            blockinfo = [(0, size)]
+
+        # Construct a map with data and zero blocks.
+        self.map_index = 0
+        self.map = []
+        lastpos = 0
+        realpos = self.offset
+        for offset, size in blockinfo:
+            if offset > lastpos:
+                self.map.append((False, lastpos, offset, None))
+            self.map.append((True, offset, offset + size, realpos))
+            realpos += size
+            lastpos = offset + size
+        if lastpos < self.size:
+            self.map.append((False, lastpos, self.size, None))
+
+    def seekable(self):
+        if not hasattr(self.fileobj, "seekable"):
+            # XXX gzip.GzipFile and bz2.BZ2File
+            return True
+        return self.fileobj.seekable()
+
+    def tell(self):
+        """Return the current file position.
+        """
+        return self.position
+
+    def seek(self, position):
+        """Seek to a position in the file.
+        """
+        self.position = position
+
+    def read(self, size=None):
+        """Read data from the file.
+        """
+        if size is None:
+            size = self.size - self.position
+        else:
+            size = min(size, self.size - self.position)
+
+        buf = b""
+        while size > 0:
+            while True:
+                data, start, stop, offset = self.map[self.map_index]
+                if start <= self.position < stop:
+                    break
+                else:
+                    self.map_index += 1
+                    if self.map_index == len(self.map):
+                        self.map_index = 0
+            length = min(size, stop - self.position)
+            if data:
+                self.fileobj.seek(offset + (self.position - start))
+                buf += self.fileobj.read(length)
+            else:
+                buf += NUL * length
+            size -= length
+            self.position += length
+        return buf
+#class _FileInFile
+
+
+class ExFileObject(object):
+    """File-like object for reading an archive member.
+       Is returned by TarFile.extractfile().
+    """
+    blocksize = 1024
+
+    def __init__(self, tarfile, tarinfo):
+        self.fileobj = _FileInFile(tarfile.fileobj,
+                                   tarinfo.offset_data,
+                                   tarinfo.size,
+                                   tarinfo.sparse)
+        self.name = tarinfo.name
+        self.mode = "r"
+        self.closed = False
+        self.size = tarinfo.size
+
+        self.position = 0
+        self.buffer = b""
+
+    def readable(self):
+        return True
+
+    def writable(self):
+        return False
+
+    def seekable(self):
+        return self.fileobj.seekable()
+
+    def read(self, size=None):
+        """Read at most size bytes from the file. If size is not
+           present or None, read all data until EOF is reached.
+        """
+        if self.closed:
+            raise ValueError("I/O operation on closed file")
+
+        buf = b""
+        if self.buffer:
+            if size is None:
+                buf = self.buffer
+                self.buffer = b""
+            else:
+                buf = self.buffer[:size]
+                self.buffer = self.buffer[size:]
+
+        if size is None:
+            buf += self.fileobj.read()
+        else:
+            buf += self.fileobj.read(size - len(buf))
+
+        self.position += len(buf)
+        return buf
+
+    # XXX TextIOWrapper uses the read1() method.
+    read1 = read
+
+    def readline(self, size=-1):
+        """Read one entire line from the file. If size is present
+           and non-negative, return a string with at most that
+           size, which may be an incomplete line.
+        """
+        if self.closed:
+            raise ValueError("I/O operation on closed file")
+
+        pos = self.buffer.find(b"\n") + 1
+        if pos == 0:
+            # no newline found.
+            while True:
+                buf = self.fileobj.read(self.blocksize)
+                self.buffer += buf
+                if not buf or b"\n" in buf:
+                    pos = self.buffer.find(b"\n") + 1
+                    if pos == 0:
+                        # no newline found.
+                        pos = len(self.buffer)
+                    break
+
+        if size != -1:
+            pos = min(size, pos)
+
+        buf = self.buffer[:pos]
+        self.buffer = self.buffer[pos:]
+        self.position += len(buf)
+        return buf
+
+    def readlines(self):
+        """Return a list with all remaining lines.
+        """
+        result = []
+        while True:
+            line = self.readline()
+            if not line: break
+            result.append(line)
+        return result
+
+    def tell(self):
+        """Return the current file position.
+        """
+        if self.closed:
+            raise ValueError("I/O operation on closed file")
+
+        return self.position
+
+    def seek(self, pos, whence=os.SEEK_SET):
+        """Seek to a position in the file.
+        """
+        if self.closed:
+            raise ValueError("I/O operation on closed file")
+
+        if whence == os.SEEK_SET:
+            self.position = min(max(pos, 0), self.size)
+        elif whence == os.SEEK_CUR:
+            if pos < 0:
+                self.position = max(self.position + pos, 0)
+            else:
+                self.position = min(self.position + pos, self.size)
+        elif whence == os.SEEK_END:
+            self.position = max(min(self.size + pos, self.size), 0)
+        else:
+            raise ValueError("Invalid argument")
+
+        self.buffer = b""
+        self.fileobj.seek(self.position)
+
+    def close(self):
+        """Close the file object.
+        """
+        self.closed = True
+
+    def __iter__(self):
+        """Get an iterator over the file's lines.
+        """
+        while True:
+            line = self.readline()
+            if not line:
+                break
+            yield line
+#class ExFileObject
+
+#------------------
+# Exported Classes
+#------------------
+class TarInfo(object):
+    """Informational class which holds the details about an
+       archive member given by a tar header block.
+       TarInfo objects are returned by TarFile.getmember(),
+       TarFile.getmembers() and TarFile.gettarinfo() and are
+       usually created internally.
+    """
+
+    __slots__ = ("name", "mode", "uid", "gid", "size", "mtime",
+                 "chksum", "type", "linkname", "uname", "gname",
+                 "devmajor", "devminor",
+                 "offset", "offset_data", "pax_headers", "sparse",
+                 "tarfile", "_sparse_structs", "_link_target")
+
+    def __init__(self, name=""):
+        """Construct a TarInfo object. name is the optional name
+           of the member.
+        """
+        self.name = name        # member name
+        self.mode = 0o644       # file permissions
+        self.uid = 0            # user id
+        self.gid = 0            # group id
+        self.size = 0           # file size
+        self.mtime = 0          # modification time
+        self.chksum = 0         # header checksum
+        self.type = REGTYPE     # member type
+        self.linkname = ""      # link name
+        self.uname = ""         # user name
+        self.gname = ""         # group name
+        self.devmajor = 0       # device major number
+        self.devminor = 0       # device minor number
+
+        self.offset = 0         # the tar header starts here
+        self.offset_data = 0    # the file's data starts here
+
+        self.sparse = None      # sparse member information
+        self.pax_headers = {}   # pax header information
+
+    # In pax headers the "name" and "linkname" field are called
+    # "path" and "linkpath".
+    def _getpath(self):
+        return self.name
+    def _setpath(self, name):
+        self.name = name
+    path = property(_getpath, _setpath)
+
+    def _getlinkpath(self):
+        return self.linkname
+    def _setlinkpath(self, linkname):
+        self.linkname = linkname
+    linkpath = property(_getlinkpath, _setlinkpath)
+
+    def __repr__(self):
+        return "<%s %r at %#x>" % (self.__class__.__name__,self.name,id(self))
+
+    def get_info(self):
+        """Return the TarInfo's attributes as a dictionary.
+        """
+        info = {
+            "name":     self.name,
+            "mode":     self.mode & 0o7777,
+            "uid":      self.uid,
+            "gid":      self.gid,
+            "size":     self.size,
+            "mtime":    self.mtime,
+            "chksum":   self.chksum,
+            "type":     self.type,
+            "linkname": self.linkname,
+            "uname":    self.uname,
+            "gname":    self.gname,
+            "devmajor": self.devmajor,
+            "devminor": self.devminor
+        }
+
+        if info["type"] == DIRTYPE and not info["name"].endswith("/"):
+            info["name"] += "/"
+
+        return info
+
+    def tobuf(self, format=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescape"):
+        """Return a tar header as a string of 512 byte blocks.
+        """
+        info = self.get_info()
+
+        if format == USTAR_FORMAT:
+            return self.create_ustar_header(info, encoding, errors)
+        elif format == GNU_FORMAT:
+            return self.create_gnu_header(info, encoding, errors)
+        elif format == PAX_FORMAT:
+            return self.create_pax_header(info, encoding)
+        else:
+            raise ValueError("invalid format")
+
+    def create_ustar_header(self, info, encoding, errors):
+        """Return the object as a ustar header block.
+        """
+        info["magic"] = POSIX_MAGIC
+
+        if len(info["linkname"]) > LENGTH_LINK:
+            raise ValueError("linkname is too long")
+
+        if len(info["name"]) > LENGTH_NAME:
+            info["prefix"], info["name"] = self._posix_split_name(info["name"])
+
+        return self._create_header(info, USTAR_FORMAT, encoding, errors)
+
+    def create_gnu_header(self, info, encoding, errors):
+        """Return the object as a GNU header block sequence.
+        """
+        info["magic"] = GNU_MAGIC
+
+        buf = b""
+        if len(info["linkname"]) > LENGTH_LINK:
+            buf += self._create_gnu_long_header(info["linkname"], GNUTYPE_LONGLINK, encoding, errors)
+
+        if len(info["name"]) > LENGTH_NAME:
+            buf += self._create_gnu_long_header(info["name"], GNUTYPE_LONGNAME, encoding, errors)
+
+        return buf + self._create_header(info, GNU_FORMAT, encoding, errors)
+
+    def create_pax_header(self, info, encoding):
+        """Return the object as a ustar header block. If it cannot be
+           represented this way, prepend a pax extended header sequence
+           with supplement information.
+        """
+        info["magic"] = POSIX_MAGIC
+        pax_headers = self.pax_headers.copy()
+
+        # Test string fields for values that exceed the field length or cannot
+        # be represented in ASCII encoding.
+        for name, hname, length in (
+                ("name", "path", LENGTH_NAME), ("linkname", "linkpath", LENGTH_LINK),
+                ("uname", "uname", 32), ("gname", "gname", 32)):
+
+            if hname in pax_headers:
+                # The pax header has priority.
+                continue
+
+            # Try to encode the string as ASCII.
+            try:
+                info[name].encode("ascii", "strict")
+            except UnicodeEncodeError:
+                pax_headers[hname] = info[name]
+                continue
+
+            if len(info[name]) > length:
+                pax_headers[hname] = info[name]
+
+        # Test number fields for values that exceed the field limit or values
+        # that like to be stored as float.
+        for name, digits in (("uid", 8), ("gid", 8), ("size", 12), ("mtime", 12)):
+            if name in pax_headers:
+                # The pax header has priority. Avoid overflow.
+                info[name] = 0
+                continue
+
+            val = info[name]
+            if not 0 <= val < 8 ** (digits - 1) or isinstance(val, float):
+                pax_headers[name] = str(val)
+                info[name] = 0
+
+        # Create a pax extended header if necessary.
+        if pax_headers:
+            buf = self._create_pax_generic_header(pax_headers, XHDTYPE, encoding)
+        else:
+            buf = b""
+
+        return buf + self._create_header(info, USTAR_FORMAT, "ascii", "replace")
+
+    @classmethod
+    def create_pax_global_header(cls, pax_headers):
+        """Return the object as a pax global header block sequence.
+        """
+        return cls._create_pax_generic_header(pax_headers, XGLTYPE, "utf8")
+
+    def _posix_split_name(self, name):
+        """Split a name longer than 100 chars into a prefix
+           and a name part.
+        """
+        prefix = name[:LENGTH_PREFIX + 1]
+        while prefix and prefix[-1] != "/":
+            prefix = prefix[:-1]
+
+        name = name[len(prefix):]
+        prefix = prefix[:-1]
+
+        if not prefix or len(name) > LENGTH_NAME:
+            raise ValueError("name is too long")
+        return prefix, name
+
+    @staticmethod
+    def _create_header(info, format, encoding, errors):
+        """Return a header block. info is a dictionary with file
+           information, format must be one of the *_FORMAT constants.
+        """
+        parts = [
+            stn(info.get("name", ""), 100, encoding, errors),
+            itn(info.get("mode", 0) & 0o7777, 8, format),
+            itn(info.get("uid", 0), 8, format),
+            itn(info.get("gid", 0), 8, format),
+            itn(info.get("size", 0), 12, format),
+            itn(info.get("mtime", 0), 12, format),
+            b"        ", # checksum field
+            info.get("type", REGTYPE),
+            stn(info.get("linkname", ""), 100, encoding, errors),
+            info.get("magic", POSIX_MAGIC),
+            stn(info.get("uname", ""), 32, encoding, errors),
+            stn(info.get("gname", ""), 32, encoding, errors),
+            itn(info.get("devmajor", 0), 8, format),
+            itn(info.get("devminor", 0), 8, format),
+            stn(info.get("prefix", ""), 155, encoding, errors)
+        ]
+
+        buf = struct.pack("%ds" % BLOCKSIZE, b"".join(parts))
+        chksum = calc_chksums(buf[-BLOCKSIZE:])[0]
+        buf = buf[:-364] + ("%06o\0" % chksum).encode("ascii") + buf[-357:]
+        return buf
+
+    @staticmethod
+    def _create_payload(payload):
+        """Return the string payload filled with zero bytes
+           up to the next 512 byte border.
+        """
+        blocks, remainder = divmod(len(payload), BLOCKSIZE)
+        if remainder > 0:
+            payload += (BLOCKSIZE - remainder) * NUL
+        return payload
+
+    @classmethod
+    def _create_gnu_long_header(cls, name, type, encoding, errors):
+        """Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence
+           for name.
+        """
+        name = name.encode(encoding, errors) + NUL
+
+        info = {}
+        info["name"] = "././@LongLink"
+        info["type"] = type
+        info["size"] = len(name)
+        info["magic"] = GNU_MAGIC
+
+        # create extended header + name blocks.
+        return cls._create_header(info, USTAR_FORMAT, encoding, errors) + \
+                cls._create_payload(name)
+
+    @classmethod
+    def _create_pax_generic_header(cls, pax_headers, type, encoding):
+        """Return a POSIX.1-2008 extended or global header sequence
+           that contains a list of keyword, value pairs. The values
+           must be strings.
+        """
+        # Check if one of the fields contains surrogate characters and thereby
+        # forces hdrcharset=BINARY, see _proc_pax() for more information.
+        binary = False
+        for keyword, value in pax_headers.items():
+            try:
+                value.encode("utf8", "strict")
+            except UnicodeEncodeError:
+                binary = True
+                break
+
+        records = b""
+        if binary:
+            # Put the hdrcharset field at the beginning of the header.
+            records += b"21 hdrcharset=BINARY\n"
+
+        for keyword, value in pax_headers.items():
+            keyword = keyword.encode("utf8")
+            if binary:
+                # Try to restore the original byte representation of `value'.
+                # Needless to say, that the encoding must match the string.
+                value = value.encode(encoding, "surrogateescape")
+            else:
+                value = value.encode("utf8")
+
+            l = len(keyword) + len(value) + 3   # ' ' + '=' + '\n'
+            n = p = 0
+            while True:
+                n = l + len(str(p))
+                if n == p:
+                    break
+                p = n
+            records += bytes(str(p), "ascii") + b" " + keyword + b"=" + value + b"\n"
+
+        # We use a hardcoded "././@PaxHeader" name like star does
+        # instead of the one that POSIX recommends.
+        info = {}
+        info["name"] = "././@PaxHeader"
+        info["type"] = type
+        info["size"] = len(records)
+        info["magic"] = POSIX_MAGIC
+
+        # Create pax header + record blocks.
+        return cls._create_header(info, USTAR_FORMAT, "ascii", "replace") + \
+                cls._create_payload(records)
+
+    @classmethod
+    def frombuf(cls, buf, encoding, errors):
+        """Construct a TarInfo object from a 512 byte bytes object.
+        """
+        if len(buf) == 0:
+            raise EmptyHeaderError("empty header")
+        if len(buf) != BLOCKSIZE:
+            raise TruncatedHeaderError("truncated header")
+        if buf.count(NUL) == BLOCKSIZE:
+            raise EOFHeaderError("end of file header")
+
+        chksum = nti(buf[148:156])
+        if chksum not in calc_chksums(buf):
+            raise InvalidHeaderError("bad checksum")
+
+        obj = cls()
+        obj.name = nts(buf[0:100], encoding, errors)
+        obj.mode = nti(buf[100:108])
+        obj.uid = nti(buf[108:116])
+        obj.gid = nti(buf[116:124])
+        obj.size = nti(buf[124:136])
+        obj.mtime = nti(buf[136:148])
+        obj.chksum = chksum
+        obj.type = buf[156:157]
+        obj.linkname = nts(buf[157:257], encoding, errors)
+        obj.uname = nts(buf[265:297], encoding, errors)
+        obj.gname = nts(buf[297:329], encoding, errors)
+        obj.devmajor = nti(buf[329:337])
+        obj.devminor = nti(buf[337:345])
+        prefix = nts(buf[345:500], encoding, errors)
+
+        # Old V7 tar format represents a directory as a regular
+        # file with a trailing slash.
+        if obj.type == AREGTYPE and obj.name.endswith("/"):
+            obj.type = DIRTYPE
+
+        # The old GNU sparse format occupies some of the unused
+        # space in the buffer for up to 4 sparse structures.
+        # Save the them for later processing in _proc_sparse().
+        if obj.type == GNUTYPE_SPARSE:
+            pos = 386
+            structs = []
+            for i in range(4):
+                try:
+                    offset = nti(buf[pos:pos + 12])
+                    numbytes = nti(buf[pos + 12:pos + 24])
+                except ValueError:
+                    break
+                structs.append((offset, numbytes))
+                pos += 24
+            isextended = bool(buf[482])
+            origsize = nti(buf[483:495])
+            obj._sparse_structs = (structs, isextended, origsize)
+
+        # Remove redundant slashes from directories.
+        if obj.isdir():
+            obj.name = obj.name.rstrip("/")
+
+        # Reconstruct a ustar longname.
+        if prefix and obj.type not in GNU_TYPES:
+            obj.name = prefix + "/" + obj.name
+        return obj
+
+    @classmethod
+    def fromtarfile(cls, tarfile):
+        """Return the next TarInfo object from TarFile object
+           tarfile.
+        """
+        buf = tarfile.fileobj.read(BLOCKSIZE)
+        obj = cls.frombuf(buf, tarfile.encoding, tarfile.errors)
+        obj.offset = tarfile.fileobj.tell() - BLOCKSIZE
+        return obj._proc_member(tarfile)
+
+    #--------------------------------------------------------------------------
+    # The following are methods that are called depending on the type of a
+    # member. The entry point is _proc_member() which can be overridden in a
+    # subclass to add custom _proc_*() methods. A _proc_*() method MUST
+    # implement the following
+    # operations:
+    # 1. Set self.offset_data to the position where the data blocks begin,
+    #    if there is data that follows.
+    # 2. Set tarfile.offset to the position where the next member's header will
+    #    begin.
+    # 3. Return self or another valid TarInfo object.
+    def _proc_member(self, tarfile):
+        """Choose the right processing method depending on
+           the type and call it.
+        """
+        if self.type in (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK):
+            return self._proc_gnulong(tarfile)
+        elif self.type == GNUTYPE_SPARSE:
+            return self._proc_sparse(tarfile)
+        elif self.type in (XHDTYPE, XGLTYPE, SOLARIS_XHDTYPE):
+            return self._proc_pax(tarfile)
+        else:
+            return self._proc_builtin(tarfile)
+
+    def _proc_builtin(self, tarfile):
+        """Process a builtin type or an unknown type which
+           will be treated as a regular file.
+        """
+        self.offset_data = tarfile.fileobj.tell()
+        offset = self.offset_data
+        if self.isreg() or self.type not in SUPPORTED_TYPES:
+            # Skip the following data blocks.
+            offset += self._block(self.size)
+        tarfile.offset = offset
+
+        # Patch the TarInfo object with saved global
+        # header information.
+        self._apply_pax_info(tarfile.pax_headers, tarfile.encoding, tarfile.errors)
+
+        return self
+
+    def _proc_gnulong(self, tarfile):
+        """Process the blocks that hold a GNU longname
+           or longlink member.
+        """
+        buf = tarfile.fileobj.read(self._block(self.size))
+
+        # Fetch the next header and process it.
+        try:
+            next = self.fromtarfile(tarfile)
+        except HeaderError:
+            raise SubsequentHeaderError("missing or bad subsequent header")
+
+        # Patch the TarInfo object from the next header with
+        # the longname information.
+        next.offset = self.offset
+        if self.type == GNUTYPE_LONGNAME:
+            next.name = nts(buf, tarfile.encoding, tarfile.errors)
+        elif self.type == GNUTYPE_LONGLINK:
+            next.linkname = nts(buf, tarfile.encoding, tarfile.errors)
+
+        return next
+
+    def _proc_sparse(self, tarfile):
+        """Process a GNU sparse header plus extra headers.
+        """
+        # We already collected some sparse structures in frombuf().
+        structs, isextended, origsize = self._sparse_structs
+        del self._sparse_structs
+
+        # Collect sparse structures from extended header blocks.
+        while isextended:
+            buf = tarfile.fileobj.read(BLOCKSIZE)
+            pos = 0
+            for i in range(21):
+                try:
+                    offset = nti(buf[pos:pos + 12])
+                    numbytes = nti(buf[pos + 12:pos + 24])
+                except ValueError:
+                    break
+                if offset and numbytes:
+                    structs.append((offset, numbytes))
+                pos += 24
+            isextended = bool(buf[504])
+        self.sparse = structs
+
+        self.offset_data = tarfile.fileobj.tell()
+        tarfile.offset = self.offset_data + self._block(self.size)
+        self.size = origsize
+        return self
+
+    def _proc_pax(self, tarfile):
+        """Process an extended or global header as described in
+           POSIX.1-2008.
+        """
+        # Read the header information.
+        buf = tarfile.fileobj.read(self._block(self.size))
+
+        # A pax header stores supplemental information for either
+        # the following file (extended) or all following files
+        # (global).
+        if self.type == XGLTYPE:
+            pax_headers = tarfile.pax_headers
+        else:
+            pax_headers = tarfile.pax_headers.copy()
+
+        # Check if the pax header contains a hdrcharset field. This tells us
+        # the encoding of the path, linkpath, uname and gname fields. Normally,
+        # these fields are UTF-8 encoded but since POSIX.1-2008 tar
+        # implementations are allowed to store them as raw binary strings if
+        # the translation to UTF-8 fails.
+        match = re.search(br"\d+ hdrcharset=([^\n]+)\n", buf)
+        if match is not None:
+            pax_headers["hdrcharset"] = match.group(1).decode("utf8")
+
+        # For the time being, we don't care about anything other than "BINARY".
+        # The only other value that is currently allowed by the standard is
+        # "ISO-IR 10646 2000 UTF-8" in other words UTF-8.
+        hdrcharset = pax_headers.get("hdrcharset")
+        if hdrcharset == "BINARY":
+            encoding = tarfile.encoding
+        else:
+            encoding = "utf8"
+
+        # Parse pax header information. A record looks like that:
+        # "%d %s=%s\n" % (length, keyword, value). length is the size
+        # of the complete record including the length field itself and
+        # the newline. keyword and value are both UTF-8 encoded strings.
+        regex = re.compile(br"(\d+) ([^=]+)=")
+        pos = 0
+        while True:
+            match = regex.match(buf, pos)
+            if not match:
+                break
+
+            length, keyword = match.groups()
+            length = int(length)
+            value = buf[match.end(2) + 1:match.start(1) + length - 1]
+
+            # Normally, we could just use "utf8" as the encoding and "strict"
+            # as the error handler, but we better not take the risk. For
+            # example, GNU tar <= 1.23 is known to store filenames it cannot
+            # translate to UTF-8 as raw strings (unfortunately without a
+            # hdrcharset=BINARY header).
+            # We first try the strict standard encoding, and if that fails we
+            # fall back on the user's encoding and error handler.
+            keyword = self._decode_pax_field(keyword, "utf8", "utf8",
+                    tarfile.errors)
+            if keyword in PAX_NAME_FIELDS:
+                value = self._decode_pax_field(value, encoding, tarfile.encoding,
+                        tarfile.errors)
+            else:
+                value = self._decode_pax_field(value, "utf8", "utf8",
+                        tarfile.errors)
+
+            pax_headers[keyword] = value
+            pos += length
+
+        # Fetch the next header.
+        try:
+            next = self.fromtarfile(tarfile)
+        except HeaderError:
+            raise SubsequentHeaderError("missing or bad subsequent header")
+
+        # Process GNU sparse information.
+        if "GNU.sparse.map" in pax_headers:
+            # GNU extended sparse format version 0.1.
+            self._proc_gnusparse_01(next, pax_headers)
+
+        elif "GNU.sparse.size" in pax_headers:
+            # GNU extended sparse format version 0.0.
+            self._proc_gnusparse_00(next, pax_headers, buf)
+
+        elif pax_headers.get("GNU.sparse.major") == "1" and pax_headers.get("GNU.sparse.minor") == "0":
+            # GNU extended sparse format version 1.0.
+            self._proc_gnusparse_10(next, pax_headers, tarfile)
+
+        if self.type in (XHDTYPE, SOLARIS_XHDTYPE):
+            # Patch the TarInfo object with the extended header info.
+            next._apply_pax_info(pax_headers, tarfile.encoding, tarfile.errors)
+            next.offset = self.offset
+
+            if "size" in pax_headers:
+                # If the extended header replaces the size field,
+                # we need to recalculate the offset where the next
+                # header starts.
+                offset = next.offset_data
+                if next.isreg() or next.type not in SUPPORTED_TYPES:
+                    offset += next._block(next.size)
+                tarfile.offset = offset
+
+        return next
+
+    def _proc_gnusparse_00(self, next, pax_headers, buf):
+        """Process a GNU tar extended sparse header, version 0.0.
+        """
+        offsets = []
+        for match in re.finditer(br"\d+ GNU.sparse.offset=(\d+)\n", buf):
+            offsets.append(int(match.group(1)))
+        numbytes = []
+        for match in re.finditer(br"\d+ GNU.sparse.numbytes=(\d+)\n", buf):
+            numbytes.append(int(match.group(1)))
+        next.sparse = list(zip(offsets, numbytes))
+
+    def _proc_gnusparse_01(self, next, pax_headers):
+        """Process a GNU tar extended sparse header, version 0.1.
+        """
+        sparse = [int(x) for x in pax_headers["GNU.sparse.map"].split(",")]
+        next.sparse = list(zip(sparse[::2], sparse[1::2]))
+
+    def _proc_gnusparse_10(self, next, pax_headers, tarfile):
+        """Process a GNU tar extended sparse header, version 1.0.
+        """
+        fields = None
+        sparse = []
+        buf = tarfile.fileobj.read(BLOCKSIZE)
+        fields, buf = buf.split(b"\n", 1)
+        fields = int(fields)
+        while len(sparse) < fields * 2:
+            if b"\n" not in buf:
+                buf += tarfile.fileobj.read(BLOCKSIZE)
+            number, buf = buf.split(b"\n", 1)
+            sparse.append(int(number))
+        next.offset_data = tarfile.fileobj.tell()
+        next.sparse = list(zip(sparse[::2], sparse[1::2]))
+
+    def _apply_pax_info(self, pax_headers, encoding, errors):
+        """Replace fields with supplemental information from a previous
+           pax extended or global header.
+        """
+        for keyword, value in pax_headers.items():
+            if keyword == "GNU.sparse.name":
+                setattr(self, "path", value)
+            elif keyword == "GNU.sparse.size":
+                setattr(self, "size", int(value))
+            elif keyword == "GNU.sparse.realsize":
+                setattr(self, "size", int(value))
+            elif keyword in PAX_FIELDS:
+                if keyword in PAX_NUMBER_FIELDS:
+                    try:
+                        value = PAX_NUMBER_FIELDS[keyword](value)
+                    except ValueError:
+                        value = 0
+                if keyword == "path":
+                    value = value.rstrip("/")
+                setattr(self, keyword, value)
+
+        self.pax_headers = pax_headers.copy()
+
+    def _decode_pax_field(self, value, encoding, fallback_encoding, fallback_errors):
+        """Decode a single field from a pax record.
+        """
+        try:
+            return value.decode(encoding, "strict")
+        except UnicodeDecodeError:
+            return value.decode(fallback_encoding, fallback_errors)
+
+    def _block(self, count):
+        """Round up a byte count by BLOCKSIZE and return it,
+           e.g. _block(834) => 1024.
+        """
+        blocks, remainder = divmod(count, BLOCKSIZE)
+        if remainder:
+            blocks += 1
+        return blocks * BLOCKSIZE
+
+    def isreg(self):
+        return self.type in REGULAR_TYPES
+    def isfile(self):
+        return self.isreg()
+    def isdir(self):
+        return self.type == DIRTYPE
+    def issym(self):
+        return self.type == SYMTYPE
+    def islnk(self):
+        return self.type == LNKTYPE
+    def ischr(self):
+        return self.type == CHRTYPE
+    def isblk(self):
+        return self.type == BLKTYPE
+    def isfifo(self):
+        return self.type == FIFOTYPE
+    def issparse(self):
+        return self.sparse is not None
+    def isdev(self):
+        return self.type in (CHRTYPE, BLKTYPE, FIFOTYPE)
+# class TarInfo
+
+class TarFile(object):
+    """The TarFile Class provides an interface to tar archives.
+    """
+
+    debug = 0                   # May be set from 0 (no msgs) to 3 (all msgs)
+
+    dereference = False         # If true, add content of linked file to the
+                                # tar file, else the link.
+
+    ignore_zeros = False        # If true, skips empty or invalid blocks and
+                                # continues processing.
+
+    errorlevel = 1              # If 0, fatal errors only appear in debug
+                                # messages (if debug >= 0). If > 0, errors
+                                # are passed to the caller as exceptions.
+
+    format = DEFAULT_FORMAT     # The format to use when creating an archive.
+
+    encoding = ENCODING         # Encoding for 8-bit character strings.
+
+    errors = None               # Error handler for unicode conversion.
+
+    tarinfo = TarInfo           # The default TarInfo class to use.
+
+    fileobject = ExFileObject   # The default ExFileObject class to use.
+
+    def __init__(self, name=None, mode="r", fileobj=None, format=None,
+            tarinfo=None, dereference=None, ignore_zeros=None, encoding=None,
+            errors="surrogateescape", pax_headers=None, debug=None, errorlevel=None):
+        """Open an (uncompressed) tar archive `name'. `mode' is either 'r' to
+           read from an existing archive, 'a' to append data to an existing
+           file or 'w' to create a new file overwriting an existing one. `mode'
+           defaults to 'r'.
+           If `fileobj' is given, it is used for reading or writing data. If it
+           can be determined, `mode' is overridden by `fileobj's mode.
+           `fileobj' is not closed, when TarFile is closed.
+        """
+        if len(mode) > 1 or mode not in "raw":
+            raise ValueError("mode must be 'r', 'a' or 'w'")
+        self.mode = mode
+        self._mode = {"r": "rb", "a": "r+b", "w": "wb"}[mode]
+
+        if not fileobj:
+            if self.mode == "a" and not os.path.exists(name):
+                # Create nonexistent files in append mode.
+                self.mode = "w"
+                self._mode = "wb"
+            fileobj = bltn_open(name, self._mode)
+            self._extfileobj = False
+        else:
+            if name is None and hasattr(fileobj, "name"):
+                name = fileobj.name
+            if hasattr(fileobj, "mode"):
+                self._mode = fileobj.mode
+            self._extfileobj = True
+        self.name = os.path.abspath(name) if name else None
+        self.fileobj = fileobj
+
+        # Init attributes.
+        if format is not None:
+            self.format = format
+        if tarinfo is not None:
+            self.tarinfo = tarinfo
+        if dereference is not None:
+            self.dereference = dereference
+        if ignore_zeros is not None:
+            self.ignore_zeros = ignore_zeros
+        if encoding is not None:
+            self.encoding = encoding
+        self.errors = errors
+
+        if pax_headers is not None and self.format == PAX_FORMAT:
+            self.pax_headers = pax_headers
+        else:
+            self.pax_headers = {}
+
+        if debug is not None:
+            self.debug = debug
+        if errorlevel is not None:
+            self.errorlevel = errorlevel
+
+        # Init datastructures.
+        self.closed = False
+        self.members = []       # list of members as TarInfo objects
+        self._loaded = False    # flag if all members have been read
+        self.offset = self.fileobj.tell()
+                                # current position in the archive file
+        self.inodes = {}        # dictionary caching the inodes of
+                                # archive members already added
+
+        try:
+            if self.mode == "r":
+                self.firstmember = None
+                self.firstmember = self.next()
+
+            if self.mode == "a":
+                # Move to the end of the archive,
+                # before the first empty block.
+                while True:
+                    self.fileobj.seek(self.offset)
+                    try:
+                        tarinfo = self.tarinfo.fromtarfile(self)
+                        self.members.append(tarinfo)
+                    except EOFHeaderError:
+                        self.fileobj.seek(self.offset)
+                        break
+                    except HeaderError as e:
+                        raise ReadError(str(e))
+
+            if self.mode in "aw":
+                self._loaded = True
+
+                if self.pax_headers:
+                    buf = self.tarinfo.create_pax_global_header(self.pax_headers.copy())
+                    self.fileobj.write(buf)
+                    self.offset += len(buf)
+        except:
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+            raise
+
+    #--------------------------------------------------------------------------
+    # Below are the classmethods which act as alternate constructors to the
+    # TarFile class. The open() method is the only one that is needed for
+    # public use; it is the "super"-constructor and is able to select an
+    # adequate "sub"-constructor for a particular compression using the mapping
+    # from OPEN_METH.
+    #
+    # This concept allows one to subclass TarFile without losing the comfort of
+    # the super-constructor. A sub-constructor is registered and made available
+    # by adding it to the mapping in OPEN_METH.
+
+    @classmethod
+    def open(cls, name=None, mode="r", fileobj=None, bufsize=RECORDSIZE, **kwargs):
+        """Open a tar archive for reading, writing or appending. Return
+           an appropriate TarFile class.
+
+           mode:
+           'r' or 'r:*' open for reading with transparent compression
+           'r:'         open for reading exclusively uncompressed
+           'r:gz'       open for reading with gzip compression
+           'r:bz2'      open for reading with bzip2 compression
+           'a' or 'a:'  open for appending, creating the file if necessary
+           'w' or 'w:'  open for writing without compression
+           'w:gz'       open for writing with gzip compression
+           'w:bz2'      open for writing with bzip2 compression
+
+           'r|*'        open a stream of tar blocks with transparent compression
+           'r|'         open an uncompressed stream of tar blocks for reading
+           'r|gz'       open a gzip compressed stream of tar blocks
+           'r|bz2'      open a bzip2 compressed stream of tar blocks
+           'w|'         open an uncompressed stream for writing
+           'w|gz'       open a gzip compressed stream for writing
+           'w|bz2'      open a bzip2 compressed stream for writing
+        """
+
+        if not name and not fileobj:
+            raise ValueError("nothing to open")
+
+        if mode in ("r", "r:*"):
+            # Find out which *open() is appropriate for opening the file.
+            for comptype in cls.OPEN_METH:
+                func = getattr(cls, cls.OPEN_METH[comptype])
+                if fileobj is not None:
+                    saved_pos = fileobj.tell()
+                try:
+                    return func(name, "r", fileobj, **kwargs)
+                except (ReadError, CompressionError) as e:
+                    if fileobj is not None:
+                        fileobj.seek(saved_pos)
+                    continue
+            raise ReadError("file could not be opened successfully")
+
+        elif ":" in mode:
+            filemode, comptype = mode.split(":", 1)
+            filemode = filemode or "r"
+            comptype = comptype or "tar"
+
+            # Select the *open() function according to
+            # given compression.
+            if comptype in cls.OPEN_METH:
+                func = getattr(cls, cls.OPEN_METH[comptype])
+            else:
+                raise CompressionError("unknown compression type %r" % comptype)
+            return func(name, filemode, fileobj, **kwargs)
+
+        elif "|" in mode:
+            filemode, comptype = mode.split("|", 1)
+            filemode = filemode or "r"
+            comptype = comptype or "tar"
+
+            if filemode not in "rw":
+                raise ValueError("mode must be 'r' or 'w'")
+
+            stream = _Stream(name, filemode, comptype, fileobj, bufsize)
+            try:
+                t = cls(name, filemode, stream, **kwargs)
+            except:
+                stream.close()
+                raise
+            t._extfileobj = False
+            return t
+
+        elif mode in "aw":
+            return cls.taropen(name, mode, fileobj, **kwargs)
+
+        raise ValueError("undiscernible mode")
+
+    @classmethod
+    def taropen(cls, name, mode="r", fileobj=None, **kwargs):
+        """Open uncompressed tar archive name for reading or writing.
+        """
+        if len(mode) > 1 or mode not in "raw":
+            raise ValueError("mode must be 'r', 'a' or 'w'")
+        return cls(name, mode, fileobj, **kwargs)
+
+    @classmethod
+    def gzopen(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs):
+        """Open gzip compressed tar archive name for reading or writing.
+           Appending is not allowed.
+        """
+        if len(mode) > 1 or mode not in "rw":
+            raise ValueError("mode must be 'r' or 'w'")
+
+        try:
+            import gzip
+            gzip.GzipFile
+        except (ImportError, AttributeError):
+            raise CompressionError("gzip module is not available")
+
+        extfileobj = fileobj is not None
+        try:
+            fileobj = gzip.GzipFile(name, mode + "b", compresslevel, fileobj)
+            t = cls.taropen(name, mode, fileobj, **kwargs)
+        except IOError:
+            if not extfileobj and fileobj is not None:
+                fileobj.close()
+            if fileobj is None:
+                raise
+            raise ReadError("not a gzip file")
+        except:
+            if not extfileobj and fileobj is not None:
+                fileobj.close()
+            raise
+        t._extfileobj = extfileobj
+        return t
+
+    @classmethod
+    def bz2open(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs):
+        """Open bzip2 compressed tar archive name for reading or writing.
+           Appending is not allowed.
+        """
+        if len(mode) > 1 or mode not in "rw":
+            raise ValueError("mode must be 'r' or 'w'.")
+
+        try:
+            import bz2
+        except ImportError:
+            raise CompressionError("bz2 module is not available")
+
+        if fileobj is not None:
+            fileobj = _BZ2Proxy(fileobj, mode)
+        else:
+            fileobj = bz2.BZ2File(name, mode, compresslevel=compresslevel)
+
+        try:
+            t = cls.taropen(name, mode, fileobj, **kwargs)
+        except (IOError, EOFError):
+            fileobj.close()
+            raise ReadError("not a bzip2 file")
+        t._extfileobj = False
+        return t
+
+    # All *open() methods are registered here.
+    OPEN_METH = {
+        "tar": "taropen",   # uncompressed tar
+        "gz":  "gzopen",    # gzip compressed tar
+        "bz2": "bz2open"    # bzip2 compressed tar
+    }
+
+    #--------------------------------------------------------------------------
+    # The public methods which TarFile provides:
+
+    def close(self):
+        """Close the TarFile. In write-mode, two finishing zero blocks are
+           appended to the archive.
+        """
+        if self.closed:
+            return
+
+        if self.mode in "aw":
+            self.fileobj.write(NUL * (BLOCKSIZE * 2))
+            self.offset += (BLOCKSIZE * 2)
+            # fill up the end with zero-blocks
+            # (like option -b20 for tar does)
+            blocks, remainder = divmod(self.offset, RECORDSIZE)
+            if remainder > 0:
+                self.fileobj.write(NUL * (RECORDSIZE - remainder))
+
+        if not self._extfileobj:
+            self.fileobj.close()
+        self.closed = True
+
+    def getmember(self, name):
+        """Return a TarInfo object for member `name'. If `name' can not be
+           found in the archive, KeyError is raised. If a member occurs more
+           than once in the archive, its last occurrence is assumed to be the
+           most up-to-date version.
+        """
+        tarinfo = self._getmember(name)
+        if tarinfo is None:
+            raise KeyError("filename %r not found" % name)
+        return tarinfo
+
+    def getmembers(self):
+        """Return the members of the archive as a list of TarInfo objects. The
+           list has the same order as the members in the archive.
+        """
+        self._check()
+        if not self._loaded:    # if we want to obtain a list of
+            self._load()        # all members, we first have to
+                                # scan the whole archive.
+        return self.members
+
+    def getnames(self):
+        """Return the members of the archive as a list of their names. It has
+           the same order as the list returned by getmembers().
+        """
+        return [tarinfo.name for tarinfo in self.getmembers()]
+
+    def gettarinfo(self, name=None, arcname=None, fileobj=None):
+        """Create a TarInfo object for either the file `name' or the file
+           object `fileobj' (using os.fstat on its file descriptor). You can
+           modify some of the TarInfo's attributes before you add it using
+           addfile(). If given, `arcname' specifies an alternative name for the
+           file in the archive.
+        """
+        self._check("aw")
+
+        # When fileobj is given, replace name by
+        # fileobj's real name.
+        if fileobj is not None:
+            name = fileobj.name
+
+        # Building the name of the member in the archive.
+        # Backward slashes are converted to forward slashes,
+        # Absolute paths are turned to relative paths.
+        if arcname is None:
+            arcname = name
+        drv, arcname = os.path.splitdrive(arcname)
+        arcname = arcname.replace(os.sep, "/")
+        arcname = arcname.lstrip("/")
+
+        # Now, fill the TarInfo object with
+        # information specific for the file.
+        tarinfo = self.tarinfo()
+        tarinfo.tarfile = self
+
+        # Use os.stat or os.lstat, depending on platform
+        # and if symlinks shall be resolved.
+        if fileobj is None:
+            if hasattr(os, "lstat") and not self.dereference:
+                statres = os.lstat(name)
+            else:
+                statres = os.stat(name)
+        else:
+            statres = os.fstat(fileobj.fileno())
+        linkname = ""
+
+        stmd = statres.st_mode
+        if stat.S_ISREG(stmd):
+            inode = (statres.st_ino, statres.st_dev)
+            if not self.dereference and statres.st_nlink > 1 and \
+                    inode in self.inodes and arcname != self.inodes[inode]:
+                # Is it a hardlink to an already
+                # archived file?
+                type = LNKTYPE
+                linkname = self.inodes[inode]
+            else:
+                # The inode is added only if its valid.
+                # For win32 it is always 0.
+                type = REGTYPE
+                if inode[0]:
+                    self.inodes[inode] = arcname
+        elif stat.S_ISDIR(stmd):
+            type = DIRTYPE
+        elif stat.S_ISFIFO(stmd):
+            type = FIFOTYPE
+        elif stat.S_ISLNK(stmd):
+            type = SYMTYPE
+            linkname = os.readlink(name)
+        elif stat.S_ISCHR(stmd):
+            type = CHRTYPE
+        elif stat.S_ISBLK(stmd):
+            type = BLKTYPE
+        else:
+            return None
+
+        # Fill the TarInfo object with all
+        # information we can get.
+        tarinfo.name = arcname
+        tarinfo.mode = stmd
+        tarinfo.uid = statres.st_uid
+        tarinfo.gid = statres.st_gid
+        if type == REGTYPE:
+            tarinfo.size = statres.st_size
+        else:
+            tarinfo.size = 0
+        tarinfo.mtime = statres.st_mtime
+        tarinfo.type = type
+        tarinfo.linkname = linkname
+        if pwd:
+            try:
+                tarinfo.uname = pwd.getpwuid(tarinfo.uid)[0]
+            except KeyError:
+                pass
+        if grp:
+            try:
+                tarinfo.gname = grp.getgrgid(tarinfo.gid)[0]
+            except KeyError:
+                pass
+
+        if type in (CHRTYPE, BLKTYPE):
+            if hasattr(os, "major") and hasattr(os, "minor"):
+                tarinfo.devmajor = os.major(statres.st_rdev)
+                tarinfo.devminor = os.minor(statres.st_rdev)
+        return tarinfo
+
+    def list(self, verbose=True):
+        """Print a table of contents to sys.stdout. If `verbose' is False, only
+           the names of the members are printed. If it is True, an `ls -l'-like
+           output is produced.
+        """
+        self._check()
+
+        for tarinfo in self:
+            if verbose:
+                print(filemode(tarinfo.mode), end=' ')
+                print("%s/%s" % (tarinfo.uname or tarinfo.uid,
+                                 tarinfo.gname or tarinfo.gid), end=' ')
+                if tarinfo.ischr() or tarinfo.isblk():
+                    print("%10s" % ("%d,%d" \
+                                    % (tarinfo.devmajor, tarinfo.devminor)), end=' ')
+                else:
+                    print("%10d" % tarinfo.size, end=' ')
+                print("%d-%02d-%02d %02d:%02d:%02d" \
+                      % time.localtime(tarinfo.mtime)[:6], end=' ')
+
+            print(tarinfo.name + ("/" if tarinfo.isdir() else ""), end=' ')
+
+            if verbose:
+                if tarinfo.issym():
+                    print("->", tarinfo.linkname, end=' ')
+                if tarinfo.islnk():
+                    print("link to", tarinfo.linkname, end=' ')
+            print()
+
+    def add(self, name, arcname=None, recursive=True, exclude=None, filter=None):
+        """Add the file `name' to the archive. `name' may be any type of file
+           (directory, fifo, symbolic link, etc.). If given, `arcname'
+           specifies an alternative name for the file in the archive.
+           Directories are added recursively by default. This can be avoided by
+           setting `recursive' to False. `exclude' is a function that should
+           return True for each filename to be excluded. `filter' is a function
+           that expects a TarInfo object argument and returns the changed
+           TarInfo object, if it returns None the TarInfo object will be
+           excluded from the archive.
+        """
+        self._check("aw")
+
+        if arcname is None:
+            arcname = name
+
+        # Exclude pathnames.
+        if exclude is not None:
+            import warnings
+            warnings.warn("use the filter argument instead",
+                    DeprecationWarning, 2)
+            if exclude(name):
+                self._dbg(2, "tarfile: Excluded %r" % name)
+                return
+
+        # Skip if somebody tries to archive the archive...
+        if self.name is not None and os.path.abspath(name) == self.name:
+            self._dbg(2, "tarfile: Skipped %r" % name)
+            return
+
+        self._dbg(1, name)
+
+        # Create a TarInfo object from the file.
+        tarinfo = self.gettarinfo(name, arcname)
+
+        if tarinfo is None:
+            self._dbg(1, "tarfile: Unsupported type %r" % name)
+            return
+
+        # Change or exclude the TarInfo object.
+        if filter is not None:
+            tarinfo = filter(tarinfo)
+            if tarinfo is None:
+                self._dbg(2, "tarfile: Excluded %r" % name)
+                return
+
+        # Append the tar header and data to the archive.
+        if tarinfo.isreg():
+            f = bltn_open(name, "rb")
+            self.addfile(tarinfo, f)
+            f.close()
+
+        elif tarinfo.isdir():
+            self.addfile(tarinfo)
+            if recursive:
+                for f in os.listdir(name):
+                    self.add(os.path.join(name, f), os.path.join(arcname, f),
+                            recursive, exclude, filter=filter)
+
+        else:
+            self.addfile(tarinfo)
+
+    def addfile(self, tarinfo, fileobj=None):
+        """Add the TarInfo object `tarinfo' to the archive. If `fileobj' is
+           given, tarinfo.size bytes are read from it and added to the archive.
+           You can create TarInfo objects using gettarinfo().
+           On Windows platforms, `fileobj' should always be opened with mode
+           'rb' to avoid irritation about the file size.
+        """
+        self._check("aw")
+
+        tarinfo = copy.copy(tarinfo)
+
+        buf = tarinfo.tobuf(self.format, self.encoding, self.errors)
+        self.fileobj.write(buf)
+        self.offset += len(buf)
+
+        # If there's data to follow, append it.
+        if fileobj is not None:
+            copyfileobj(fileobj, self.fileobj, tarinfo.size)
+            blocks, remainder = divmod(tarinfo.size, BLOCKSIZE)
+            if remainder > 0:
+                self.fileobj.write(NUL * (BLOCKSIZE - remainder))
+                blocks += 1
+            self.offset += blocks * BLOCKSIZE
+
+        self.members.append(tarinfo)
+
+    def extractall(self, path=".", members=None):
+        """Extract all members from the archive to the current working
+           directory and set owner, modification time and permissions on
+           directories afterwards. `path' specifies a different directory
+           to extract to. `members' is optional and must be a subset of the
+           list returned by getmembers().
+        """
+        directories = []
+
+        if members is None:
+            members = self
+
+        for tarinfo in members:
+            if tarinfo.isdir():
+                # Extract directories with a safe mode.
+                directories.append(tarinfo)
+                tarinfo = copy.copy(tarinfo)
+                tarinfo.mode = 0o700
+            # Do not set_attrs directories, as we will do that further down
+            self.extract(tarinfo, path, set_attrs=not tarinfo.isdir())
+
+        # Reverse sort directories.
+        directories.sort(key=lambda a: a.name)
+        directories.reverse()
+
+        # Set correct owner, mtime and filemode on directories.
+        for tarinfo in directories:
+            dirpath = os.path.join(path, tarinfo.name)
+            try:
+                self.chown(tarinfo, dirpath)
+                self.utime(tarinfo, dirpath)
+                self.chmod(tarinfo, dirpath)
+            except ExtractError as e:
+                if self.errorlevel > 1:
+                    raise
+                else:
+                    self._dbg(1, "tarfile: %s" % e)
+
+    def extract(self, member, path="", set_attrs=True):
+        """Extract a member from the archive to the current working directory,
+           using its full name. Its file information is extracted as accurately
+           as possible. `member' may be a filename or a TarInfo object. You can
+           specify a different directory using `path'. File attributes (owner,
+           mtime, mode) are set unless `set_attrs' is False.
+        """
+        self._check("r")
+
+        if isinstance(member, str):
+            tarinfo = self.getmember(member)
+        else:
+            tarinfo = member
+
+        # Prepare the link target for makelink().
+        if tarinfo.islnk():
+            tarinfo._link_target = os.path.join(path, tarinfo.linkname)
+
+        try:
+            self._extract_member(tarinfo, os.path.join(path, tarinfo.name),
+                                 set_attrs=set_attrs)
+        except EnvironmentError as e:
+            if self.errorlevel > 0:
+                raise
+            else:
+                if e.filename is None:
+                    self._dbg(1, "tarfile: %s" % e.strerror)
+                else:
+                    self._dbg(1, "tarfile: %s %r" % (e.strerror, e.filename))
+        except ExtractError as e:
+            if self.errorlevel > 1:
+                raise
+            else:
+                self._dbg(1, "tarfile: %s" % e)
+
+    def extractfile(self, member):
+        """Extract a member from the archive as a file object. `member' may be
+           a filename or a TarInfo object. If `member' is a regular file, a
+           file-like object is returned. If `member' is a link, a file-like
+           object is constructed from the link's target. If `member' is none of
+           the above, None is returned.
+           The file-like object is read-only and provides the following
+           methods: read(), readline(), readlines(), seek() and tell()
+        """
+        self._check("r")
+
+        if isinstance(member, str):
+            tarinfo = self.getmember(member)
+        else:
+            tarinfo = member
+
+        if tarinfo.isreg():
+            return self.fileobject(self, tarinfo)
+
+        elif tarinfo.type not in SUPPORTED_TYPES:
+            # If a member's type is unknown, it is treated as a
+            # regular file.
+            return self.fileobject(self, tarinfo)
+
+        elif tarinfo.islnk() or tarinfo.issym():
+            if isinstance(self.fileobj, _Stream):
+                # A small but ugly workaround for the case that someone tries
+                # to extract a (sym)link as a file-object from a non-seekable
+                # stream of tar blocks.
+                raise StreamError("cannot extract (sym)link as file object")
+            else:
+                # A (sym)link's file object is its target's file object.
+                return self.extractfile(self._find_link_target(tarinfo))
+        else:
+            # If there's no data associated with the member (directory, chrdev,
+            # blkdev, etc.), return None instead of a file object.
+            return None
+
+    def _extract_member(self, tarinfo, targetpath, set_attrs=True):
+        """Extract the TarInfo object tarinfo to a physical
+           file called targetpath.
+        """
+        # Fetch the TarInfo object for the given name
+        # and build the destination pathname, replacing
+        # forward slashes to platform specific separators.
+        targetpath = targetpath.rstrip("/")
+        targetpath = targetpath.replace("/", os.sep)
+
+        # Create all upper directories.
+        upperdirs = os.path.dirname(targetpath)
+        if upperdirs and not os.path.exists(upperdirs):
+            # Create directories that are not part of the archive with
+            # default permissions.
+            os.makedirs(upperdirs)
+
+        if tarinfo.islnk() or tarinfo.issym():
+            self._dbg(1, "%s -> %s" % (tarinfo.name, tarinfo.linkname))
+        else:
+            self._dbg(1, tarinfo.name)
+
+        if tarinfo.isreg():
+            self.makefile(tarinfo, targetpath)
+        elif tarinfo.isdir():
+            self.makedir(tarinfo, targetpath)
+        elif tarinfo.isfifo():
+            self.makefifo(tarinfo, targetpath)
+        elif tarinfo.ischr() or tarinfo.isblk():
+            self.makedev(tarinfo, targetpath)
+        elif tarinfo.islnk() or tarinfo.issym():
+            self.makelink(tarinfo, targetpath)
+        elif tarinfo.type not in SUPPORTED_TYPES:
+            self.makeunknown(tarinfo, targetpath)
+        else:
+            self.makefile(tarinfo, targetpath)
+
+        if set_attrs:
+            self.chown(tarinfo, targetpath)
+            if not tarinfo.issym():
+                self.chmod(tarinfo, targetpath)
+                self.utime(tarinfo, targetpath)
+
+    #--------------------------------------------------------------------------
+    # Below are the different file methods. They are called via
+    # _extract_member() when extract() is called. They can be replaced in a
+    # subclass to implement other functionality.
+
+    def makedir(self, tarinfo, targetpath):
+        """Make a directory called targetpath.
+        """
+        try:
+            # Use a safe mode for the directory, the real mode is set
+            # later in _extract_member().
+            os.mkdir(targetpath, 0o700)
+        except EnvironmentError as e:
+            if e.errno != errno.EEXIST:
+                raise
+
+    def makefile(self, tarinfo, targetpath):
+        """Make a file called targetpath.
+        """
+        source = self.fileobj
+        source.seek(tarinfo.offset_data)
+        target = bltn_open(targetpath, "wb")
+        if tarinfo.sparse is not None:
+            for offset, size in tarinfo.sparse:
+                target.seek(offset)
+                copyfileobj(source, target, size)
+        else:
+            copyfileobj(source, target, tarinfo.size)
+        target.seek(tarinfo.size)
+        target.truncate()
+        target.close()
+
+    def makeunknown(self, tarinfo, targetpath):
+        """Make a file from a TarInfo object with an unknown type
+           at targetpath.
+        """
+        self.makefile(tarinfo, targetpath)
+        self._dbg(1, "tarfile: Unknown file type %r, " \
+                     "extracted as regular file." % tarinfo.type)
+
+    def makefifo(self, tarinfo, targetpath):
+        """Make a fifo called targetpath.
+        """
+        if hasattr(os, "mkfifo"):
+            os.mkfifo(targetpath)
+        else:
+            raise ExtractError("fifo not supported by system")
+
+    def makedev(self, tarinfo, targetpath):
+        """Make a character or block device called targetpath.
+        """
+        if not hasattr(os, "mknod") or not hasattr(os, "makedev"):
+            raise ExtractError("special devices not supported by system")
+
+        mode = tarinfo.mode
+        if tarinfo.isblk():
+            mode |= stat.S_IFBLK
+        else:
+            mode |= stat.S_IFCHR
+
+        os.mknod(targetpath, mode,
+                 os.makedev(tarinfo.devmajor, tarinfo.devminor))
+
+    def makelink(self, tarinfo, targetpath):
+        """Make a (symbolic) link called targetpath. If it cannot be created
+          (platform limitation), we try to make a copy of the referenced file
+          instead of a link.
+        """
+        try:
+            # For systems that support symbolic and hard links.
+            if tarinfo.issym():
+                os.symlink(tarinfo.linkname, targetpath)
+            else:
+                # See extract().
+                if os.path.exists(tarinfo._link_target):
+                    os.link(tarinfo._link_target, targetpath)
+                else:
+                    self._extract_member(self._find_link_target(tarinfo),
+                                         targetpath)
+        except symlink_exception:
+            if tarinfo.issym():
+                linkpath = os.path.join(os.path.dirname(tarinfo.name),
+                                        tarinfo.linkname)
+            else:
+                linkpath = tarinfo.linkname
+        else:
+            try:
+                self._extract_member(self._find_link_target(tarinfo),
+                                     targetpath)
+            except KeyError:
+                raise ExtractError("unable to resolve link inside archive")
+
+    def chown(self, tarinfo, targetpath):
+        """Set owner of targetpath according to tarinfo.
+        """
+        if pwd and hasattr(os, "geteuid") and os.geteuid() == 0:
+            # We have to be root to do so.
+            try:
+                g = grp.getgrnam(tarinfo.gname)[2]
+            except KeyError:
+                g = tarinfo.gid
+            try:
+                u = pwd.getpwnam(tarinfo.uname)[2]
+            except KeyError:
+                u = tarinfo.uid
+            try:
+                if tarinfo.issym() and hasattr(os, "lchown"):
+                    os.lchown(targetpath, u, g)
+                else:
+                    if sys.platform != "os2emx":
+                        os.chown(targetpath, u, g)
+            except EnvironmentError as e:
+                raise ExtractError("could not change owner")
+
+    def chmod(self, tarinfo, targetpath):
+        """Set file permissions of targetpath according to tarinfo.
+        """
+        if hasattr(os, 'chmod'):
+            try:
+                os.chmod(targetpath, tarinfo.mode)
+            except EnvironmentError as e:
+                raise ExtractError("could not change mode")
+
+    def utime(self, tarinfo, targetpath):
+        """Set modification time of targetpath according to tarinfo.
+        """
+        if not hasattr(os, 'utime'):
+            return
+        try:
+            os.utime(targetpath, (tarinfo.mtime, tarinfo.mtime))
+        except EnvironmentError as e:
+            raise ExtractError("could not change modification time")
+
+    #--------------------------------------------------------------------------
+    def next(self):
+        """Return the next member of the archive as a TarInfo object, when
+           TarFile is opened for reading. Return None if there is no more
+           available.
+        """
+        self._check("ra")
+        if self.firstmember is not None:
+            m = self.firstmember
+            self.firstmember = None
+            return m
+
+        # Read the next block.
+        self.fileobj.seek(self.offset)
+        tarinfo = None
+        while True:
+            try:
+                tarinfo = self.tarinfo.fromtarfile(self)
+            except EOFHeaderError as e:
+                if self.ignore_zeros:
+                    self._dbg(2, "0x%X: %s" % (self.offset, e))
+                    self.offset += BLOCKSIZE
+                    continue
+            except InvalidHeaderError as e:
+                if self.ignore_zeros:
+                    self._dbg(2, "0x%X: %s" % (self.offset, e))
+                    self.offset += BLOCKSIZE
+                    continue
+                elif self.offset == 0:
+                    raise ReadError(str(e))
+            except EmptyHeaderError:
+                if self.offset == 0:
+                    raise ReadError("empty file")
+            except TruncatedHeaderError as e:
+                if self.offset == 0:
+                    raise ReadError(str(e))
+            except SubsequentHeaderError as e:
+                raise ReadError(str(e))
+            break
+
+        if tarinfo is not None:
+            self.members.append(tarinfo)
+        else:
+            self._loaded = True
+
+        return tarinfo
+
+    #--------------------------------------------------------------------------
+    # Little helper methods:
+
+    def _getmember(self, name, tarinfo=None, normalize=False):
+        """Find an archive member by name from bottom to top.
+           If tarinfo is given, it is used as the starting point.
+        """
+        # Ensure that all members have been loaded.
+        members = self.getmembers()
+
+        # Limit the member search list up to tarinfo.
+        if tarinfo is not None:
+            members = members[:members.index(tarinfo)]
+
+        if normalize:
+            name = os.path.normpath(name)
+
+        for member in reversed(members):
+            if normalize:
+                member_name = os.path.normpath(member.name)
+            else:
+                member_name = member.name
+
+            if name == member_name:
+                return member
+
+    def _load(self):
+        """Read through the entire archive file and look for readable
+           members.
+        """
+        while True:
+            tarinfo = self.next()
+            if tarinfo is None:
+                break
+        self._loaded = True
+
+    def _check(self, mode=None):
+        """Check if TarFile is still open, and if the operation's mode
+           corresponds to TarFile's mode.
+        """
+        if self.closed:
+            raise IOError("%s is closed" % self.__class__.__name__)
+        if mode is not None and self.mode not in mode:
+            raise IOError("bad operation for mode %r" % self.mode)
+
+    def _find_link_target(self, tarinfo):
+        """Find the target member of a symlink or hardlink member in the
+           archive.
+        """
+        if tarinfo.issym():
+            # Always search the entire archive.
+            linkname = os.path.dirname(tarinfo.name) + "/" + tarinfo.linkname
+            limit = None
+        else:
+            # Search the archive before the link, because a hard link is
+            # just a reference to an already archived file.
+            linkname = tarinfo.linkname
+            limit = tarinfo
+
+        member = self._getmember(linkname, tarinfo=limit, normalize=True)
+        if member is None:
+            raise KeyError("linkname %r not found" % linkname)
+        return member
+
+    def __iter__(self):
+        """Provide an iterator object.
+        """
+        if self._loaded:
+            return iter(self.members)
+        else:
+            return TarIter(self)
+
+    def _dbg(self, level, msg):
+        """Write debugging output to sys.stderr.
+        """
+        if level <= self.debug:
+            print(msg, file=sys.stderr)
+
+    def __enter__(self):
+        self._check()
+        return self
+
+    def __exit__(self, type, value, traceback):
+        if type is None:
+            self.close()
+        else:
+            # An exception occurred. We must not call close() because
+            # it would try to write end-of-archive blocks and padding.
+            if not self._extfileobj:
+                self.fileobj.close()
+            self.closed = True
+# class TarFile
+
+class TarIter(object):
+    """Iterator Class.
+
+       for tarinfo in TarFile(...):
+           suite...
+    """
+
+    def __init__(self, tarfile):
+        """Construct a TarIter object.
+        """
+        self.tarfile = tarfile
+        self.index = 0
+    def __iter__(self):
+        """Return iterator object.
+        """
+        return self
+
+    def __next__(self):
+        """Return the next item using TarFile's next() method.
+           When all members have been read, set TarFile as _loaded.
+        """
+        # Fix for SF #1100429: Under rare circumstances it can
+        # happen that getmembers() is called during iteration,
+        # which will cause TarIter to stop prematurely.
+        if not self.tarfile._loaded:
+            tarinfo = self.tarfile.next()
+            if not tarinfo:
+                self.tarfile._loaded = True
+                raise StopIteration
+        else:
+            try:
+                tarinfo = self.tarfile.members[self.index]
+            except IndexError:
+                raise StopIteration
+        self.index += 1
+        return tarinfo
+
+    next = __next__ # for Python 2.x
+
+#--------------------
+# exported functions
+#--------------------
+def is_tarfile(name):
+    """Return True if name points to a tar archive that we
+       are able to handle, else return False.
+    """
+    try:
+        t = open(name)
+        t.close()
+        return True
+    except TarError:
+        return False
+
+bltn_open = open
+open = TarFile.open
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff328c8ee491f9f3c943cf637dc7ea17ea33ee3b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/compat.py
@@ -0,0 +1,1120 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013-2017 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+from __future__ import absolute_import
+
+import os
+import re
+import sys
+
+try:
+    import ssl
+except ImportError:  # pragma: no cover
+    ssl = None
+
+if sys.version_info[0] < 3:  # pragma: no cover
+    from StringIO import StringIO
+    string_types = basestring,
+    text_type = unicode
+    from types import FileType as file_type
+    import __builtin__ as builtins
+    import ConfigParser as configparser
+    from ._backport import shutil
+    from urlparse import urlparse, urlunparse, urljoin, urlsplit, urlunsplit
+    from urllib import (urlretrieve, quote as _quote, unquote, url2pathname,
+                        pathname2url, ContentTooShortError, splittype)
+
+    def quote(s):
+        if isinstance(s, unicode):
+            s = s.encode('utf-8')
+        return _quote(s)
+
+    import urllib2
+    from urllib2 import (Request, urlopen, URLError, HTTPError,
+                         HTTPBasicAuthHandler, HTTPPasswordMgr,
+                         HTTPHandler, HTTPRedirectHandler,
+                         build_opener)
+    if ssl:
+        from urllib2 import HTTPSHandler
+    import httplib
+    import xmlrpclib
+    import Queue as queue
+    from HTMLParser import HTMLParser
+    import htmlentitydefs
+    raw_input = raw_input
+    from itertools import ifilter as filter
+    from itertools import ifilterfalse as filterfalse
+
+    _userprog = None
+    def splituser(host):
+        """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'."""
+        global _userprog
+        if _userprog is None:
+            import re
+            _userprog = re.compile('^(.*)@(.*)$')
+
+        match = _userprog.match(host)
+        if match: return match.group(1, 2)
+        return None, host
+
+else:  # pragma: no cover
+    from io import StringIO
+    string_types = str,
+    text_type = str
+    from io import TextIOWrapper as file_type
+    import builtins
+    import configparser
+    import shutil
+    from urllib.parse import (urlparse, urlunparse, urljoin, splituser, quote,
+                              unquote, urlsplit, urlunsplit, splittype)
+    from urllib.request import (urlopen, urlretrieve, Request, url2pathname,
+                                pathname2url,
+                                HTTPBasicAuthHandler, HTTPPasswordMgr,
+                                HTTPHandler, HTTPRedirectHandler,
+                                build_opener)
+    if ssl:
+        from urllib.request import HTTPSHandler
+    from urllib.error import HTTPError, URLError, ContentTooShortError
+    import http.client as httplib
+    import urllib.request as urllib2
+    import xmlrpc.client as xmlrpclib
+    import queue
+    from html.parser import HTMLParser
+    import html.entities as htmlentitydefs
+    raw_input = input
+    from itertools import filterfalse
+    filter = filter
+
+try:
+    from ssl import match_hostname, CertificateError
+except ImportError: # pragma: no cover
+    class CertificateError(ValueError):
+        pass
+
+
+    def _dnsname_match(dn, hostname, max_wildcards=1):
+        """Matching according to RFC 6125, section 6.4.3
+
+        http://tools.ietf.org/html/rfc6125#section-6.4.3
+        """
+        pats = []
+        if not dn:
+            return False
+
+        parts = dn.split('.')
+        leftmost, remainder = parts[0], parts[1:]
+
+        wildcards = leftmost.count('*')
+        if wildcards > max_wildcards:
+            # Issue #17980: avoid denials of service by refusing more
+            # than one wildcard per fragment.  A survey of established
+            # policy among SSL implementations showed it to be a
+            # reasonable choice.
+            raise CertificateError(
+                "too many wildcards in certificate DNS name: " + repr(dn))
+
+        # speed up common case w/o wildcards
+        if not wildcards:
+            return dn.lower() == hostname.lower()
+
+        # RFC 6125, section 6.4.3, subitem 1.
+        # The client SHOULD NOT attempt to match a presented identifier in which
+        # the wildcard character comprises a label other than the left-most label.
+        if leftmost == '*':
+            # When '*' is a fragment by itself, it matches a non-empty dotless
+            # fragment.
+            pats.append('[^.]+')
+        elif leftmost.startswith('xn--') or hostname.startswith('xn--'):
+            # RFC 6125, section 6.4.3, subitem 3.
+            # The client SHOULD NOT attempt to match a presented identifier
+            # where the wildcard character is embedded within an A-label or
+            # U-label of an internationalized domain name.
+            pats.append(re.escape(leftmost))
+        else:
+            # Otherwise, '*' matches any dotless string, e.g. www*
+            pats.append(re.escape(leftmost).replace(r'\*', '[^.]*'))
+
+        # add the remaining fragments, ignore any wildcards
+        for frag in remainder:
+            pats.append(re.escape(frag))
+
+        pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE)
+        return pat.match(hostname)
+
+
+    def match_hostname(cert, hostname):
+        """Verify that *cert* (in decoded format as returned by
+        SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
+        rules are followed, but IP addresses are not accepted for *hostname*.
+
+        CertificateError is raised on failure. On success, the function
+        returns nothing.
+        """
+        if not cert:
+            raise ValueError("empty or no certificate, match_hostname needs a "
+                             "SSL socket or SSL context with either "
+                             "CERT_OPTIONAL or CERT_REQUIRED")
+        dnsnames = []
+        san = cert.get('subjectAltName', ())
+        for key, value in san:
+            if key == 'DNS':
+                if _dnsname_match(value, hostname):
+                    return
+                dnsnames.append(value)
+        if not dnsnames:
+            # The subject is only checked when there is no dNSName entry
+            # in subjectAltName
+            for sub in cert.get('subject', ()):
+                for key, value in sub:
+                    # XXX according to RFC 2818, the most specific Common Name
+                    # must be used.
+                    if key == 'commonName':
+                        if _dnsname_match(value, hostname):
+                            return
+                        dnsnames.append(value)
+        if len(dnsnames) > 1:
+            raise CertificateError("hostname %r "
+                "doesn't match either of %s"
+                % (hostname, ', '.join(map(repr, dnsnames))))
+        elif len(dnsnames) == 1:
+            raise CertificateError("hostname %r "
+                "doesn't match %r"
+                % (hostname, dnsnames[0]))
+        else:
+            raise CertificateError("no appropriate commonName or "
+                "subjectAltName fields were found")
+
+
+try:
+    from types import SimpleNamespace as Container
+except ImportError:  # pragma: no cover
+    class Container(object):
+        """
+        A generic container for when multiple values need to be returned
+        """
+        def __init__(self, **kwargs):
+            self.__dict__.update(kwargs)
+
+
+try:
+    from shutil import which
+except ImportError:  # pragma: no cover
+    # Implementation from Python 3.3
+    def which(cmd, mode=os.F_OK | os.X_OK, path=None):
+        """Given a command, mode, and a PATH string, return the path which
+        conforms to the given mode on the PATH, or None if there is no such
+        file.
+
+        `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
+        of os.environ.get("PATH"), or can be overridden with a custom search
+        path.
+
+        """
+        # Check that a given file can be accessed with the correct mode.
+        # Additionally check that `file` is not a directory, as on Windows
+        # directories pass the os.access check.
+        def _access_check(fn, mode):
+            return (os.path.exists(fn) and os.access(fn, mode)
+                    and not os.path.isdir(fn))
+
+        # If we're given a path with a directory part, look it up directly rather
+        # than referring to PATH directories. This includes checking relative to the
+        # current directory, e.g. ./script
+        if os.path.dirname(cmd):
+            if _access_check(cmd, mode):
+                return cmd
+            return None
+
+        if path is None:
+            path = os.environ.get("PATH", os.defpath)
+        if not path:
+            return None
+        path = path.split(os.pathsep)
+
+        if sys.platform == "win32":
+            # The current directory takes precedence on Windows.
+            if not os.curdir in path:
+                path.insert(0, os.curdir)
+
+            # PATHEXT is necessary to check on Windows.
+            pathext = os.environ.get("PATHEXT", "").split(os.pathsep)
+            # See if the given file matches any of the expected path extensions.
+            # This will allow us to short circuit when given "python.exe".
+            # If it does match, only test that one, otherwise we have to try
+            # others.
+            if any(cmd.lower().endswith(ext.lower()) for ext in pathext):
+                files = [cmd]
+            else:
+                files = [cmd + ext for ext in pathext]
+        else:
+            # On other platforms you don't have things like PATHEXT to tell you
+            # what file suffixes are executable, so just pass on cmd as-is.
+            files = [cmd]
+
+        seen = set()
+        for dir in path:
+            normdir = os.path.normcase(dir)
+            if not normdir in seen:
+                seen.add(normdir)
+                for thefile in files:
+                    name = os.path.join(dir, thefile)
+                    if _access_check(name, mode):
+                        return name
+        return None
+
+
+# ZipFile is a context manager in 2.7, but not in 2.6
+
+from zipfile import ZipFile as BaseZipFile
+
+if hasattr(BaseZipFile, '__enter__'):  # pragma: no cover
+    ZipFile = BaseZipFile
+else:  # pragma: no cover
+    from zipfile import ZipExtFile as BaseZipExtFile
+
+    class ZipExtFile(BaseZipExtFile):
+        def __init__(self, base):
+            self.__dict__.update(base.__dict__)
+
+        def __enter__(self):
+            return self
+
+        def __exit__(self, *exc_info):
+            self.close()
+            # return None, so if an exception occurred, it will propagate
+
+    class ZipFile(BaseZipFile):
+        def __enter__(self):
+            return self
+
+        def __exit__(self, *exc_info):
+            self.close()
+            # return None, so if an exception occurred, it will propagate
+
+        def open(self, *args, **kwargs):
+            base = BaseZipFile.open(self, *args, **kwargs)
+            return ZipExtFile(base)
+
+try:
+    from platform import python_implementation
+except ImportError: # pragma: no cover
+    def python_implementation():
+        """Return a string identifying the Python implementation."""
+        if 'PyPy' in sys.version:
+            return 'PyPy'
+        if os.name == 'java':
+            return 'Jython'
+        if sys.version.startswith('IronPython'):
+            return 'IronPython'
+        return 'CPython'
+
+try:
+    import sysconfig
+except ImportError: # pragma: no cover
+    from ._backport import sysconfig
+
+try:
+    callable = callable
+except NameError:   # pragma: no cover
+    from collections import Callable
+
+    def callable(obj):
+        return isinstance(obj, Callable)
+
+
+try:
+    fsencode = os.fsencode
+    fsdecode = os.fsdecode
+except AttributeError:  # pragma: no cover
+    # Issue #99: on some systems (e.g. containerised),
+    # sys.getfilesystemencoding() returns None, and we need a real value,
+    # so fall back to utf-8. From the CPython 2.7 docs relating to Unix and
+    # sys.getfilesystemencoding(): the return value is "the user’s preference
+    # according to the result of nl_langinfo(CODESET), or None if the
+    # nl_langinfo(CODESET) failed."
+    _fsencoding = sys.getfilesystemencoding() or 'utf-8'
+    if _fsencoding == 'mbcs':
+        _fserrors = 'strict'
+    else:
+        _fserrors = 'surrogateescape'
+
+    def fsencode(filename):
+        if isinstance(filename, bytes):
+            return filename
+        elif isinstance(filename, text_type):
+            return filename.encode(_fsencoding, _fserrors)
+        else:
+            raise TypeError("expect bytes or str, not %s" %
+                            type(filename).__name__)
+
+    def fsdecode(filename):
+        if isinstance(filename, text_type):
+            return filename
+        elif isinstance(filename, bytes):
+            return filename.decode(_fsencoding, _fserrors)
+        else:
+            raise TypeError("expect bytes or str, not %s" %
+                            type(filename).__name__)
+
+try:
+    from tokenize import detect_encoding
+except ImportError: # pragma: no cover
+    from codecs import BOM_UTF8, lookup
+    import re
+
+    cookie_re = re.compile(r"coding[:=]\s*([-\w.]+)")
+
+    def _get_normal_name(orig_enc):
+        """Imitates get_normal_name in tokenizer.c."""
+        # Only care about the first 12 characters.
+        enc = orig_enc[:12].lower().replace("_", "-")
+        if enc == "utf-8" or enc.startswith("utf-8-"):
+            return "utf-8"
+        if enc in ("latin-1", "iso-8859-1", "iso-latin-1") or \
+           enc.startswith(("latin-1-", "iso-8859-1-", "iso-latin-1-")):
+            return "iso-8859-1"
+        return orig_enc
+
+    def detect_encoding(readline):
+        """
+        The detect_encoding() function is used to detect the encoding that should
+        be used to decode a Python source file.  It requires one argument, readline,
+        in the same way as the tokenize() generator.
+
+        It will call readline a maximum of twice, and return the encoding used
+        (as a string) and a list of any lines (left as bytes) it has read in.
+
+        It detects the encoding from the presence of a utf-8 bom or an encoding
+        cookie as specified in pep-0263.  If both a bom and a cookie are present,
+        but disagree, a SyntaxError will be raised.  If the encoding cookie is an
+        invalid charset, raise a SyntaxError.  Note that if a utf-8 bom is found,
+        'utf-8-sig' is returned.
+
+        If no encoding is specified, then the default of 'utf-8' will be returned.
+        """
+        try:
+            filename = readline.__self__.name
+        except AttributeError:
+            filename = None
+        bom_found = False
+        encoding = None
+        default = 'utf-8'
+        def read_or_stop():
+            try:
+                return readline()
+            except StopIteration:
+                return b''
+
+        def find_cookie(line):
+            try:
+                # Decode as UTF-8. Either the line is an encoding declaration,
+                # in which case it should be pure ASCII, or it must be UTF-8
+                # per default encoding.
+                line_string = line.decode('utf-8')
+            except UnicodeDecodeError:
+                msg = "invalid or missing encoding declaration"
+                if filename is not None:
+                    msg = '{} for {!r}'.format(msg, filename)
+                raise SyntaxError(msg)
+
+            matches = cookie_re.findall(line_string)
+            if not matches:
+                return None
+            encoding = _get_normal_name(matches[0])
+            try:
+                codec = lookup(encoding)
+            except LookupError:
+                # This behaviour mimics the Python interpreter
+                if filename is None:
+                    msg = "unknown encoding: " + encoding
+                else:
+                    msg = "unknown encoding for {!r}: {}".format(filename,
+                            encoding)
+                raise SyntaxError(msg)
+
+            if bom_found:
+                if codec.name != 'utf-8':
+                    # This behaviour mimics the Python interpreter
+                    if filename is None:
+                        msg = 'encoding problem: utf-8'
+                    else:
+                        msg = 'encoding problem for {!r}: utf-8'.format(filename)
+                    raise SyntaxError(msg)
+                encoding += '-sig'
+            return encoding
+
+        first = read_or_stop()
+        if first.startswith(BOM_UTF8):
+            bom_found = True
+            first = first[3:]
+            default = 'utf-8-sig'
+        if not first:
+            return default, []
+
+        encoding = find_cookie(first)
+        if encoding:
+            return encoding, [first]
+
+        second = read_or_stop()
+        if not second:
+            return default, [first]
+
+        encoding = find_cookie(second)
+        if encoding:
+            return encoding, [first, second]
+
+        return default, [first, second]
+
+# For converting & <-> &amp; etc.
+try:
+    from html import escape
+except ImportError:
+    from cgi import escape
+if sys.version_info[:2] < (3, 4):
+    unescape = HTMLParser().unescape
+else:
+    from html import unescape
+
+try:
+    from collections import ChainMap
+except ImportError: # pragma: no cover
+    from collections import MutableMapping
+
+    try:
+        from reprlib import recursive_repr as _recursive_repr
+    except ImportError:
+        def _recursive_repr(fillvalue='...'):
+            '''
+            Decorator to make a repr function return fillvalue for a recursive
+            call
+            '''
+
+            def decorating_function(user_function):
+                repr_running = set()
+
+                def wrapper(self):
+                    key = id(self), get_ident()
+                    if key in repr_running:
+                        return fillvalue
+                    repr_running.add(key)
+                    try:
+                        result = user_function(self)
+                    finally:
+                        repr_running.discard(key)
+                    return result
+
+                # Can't use functools.wraps() here because of bootstrap issues
+                wrapper.__module__ = getattr(user_function, '__module__')
+                wrapper.__doc__ = getattr(user_function, '__doc__')
+                wrapper.__name__ = getattr(user_function, '__name__')
+                wrapper.__annotations__ = getattr(user_function, '__annotations__', {})
+                return wrapper
+
+            return decorating_function
+
+    class ChainMap(MutableMapping):
+        ''' A ChainMap groups multiple dicts (or other mappings) together
+        to create a single, updateable view.
+
+        The underlying mappings are stored in a list.  That list is public and can
+        accessed or updated using the *maps* attribute.  There is no other state.
+
+        Lookups search the underlying mappings successively until a key is found.
+        In contrast, writes, updates, and deletions only operate on the first
+        mapping.
+
+        '''
+
+        def __init__(self, *maps):
+            '''Initialize a ChainMap by setting *maps* to the given mappings.
+            If no mappings are provided, a single empty dictionary is used.
+
+            '''
+            self.maps = list(maps) or [{}]          # always at least one map
+
+        def __missing__(self, key):
+            raise KeyError(key)
+
+        def __getitem__(self, key):
+            for mapping in self.maps:
+                try:
+                    return mapping[key]             # can't use 'key in mapping' with defaultdict
+                except KeyError:
+                    pass
+            return self.__missing__(key)            # support subclasses that define __missing__
+
+        def get(self, key, default=None):
+            return self[key] if key in self else default
+
+        def __len__(self):
+            return len(set().union(*self.maps))     # reuses stored hash values if possible
+
+        def __iter__(self):
+            return iter(set().union(*self.maps))
+
+        def __contains__(self, key):
+            return any(key in m for m in self.maps)
+
+        def __bool__(self):
+            return any(self.maps)
+
+        @_recursive_repr()
+        def __repr__(self):
+            return '{0.__class__.__name__}({1})'.format(
+                self, ', '.join(map(repr, self.maps)))
+
+        @classmethod
+        def fromkeys(cls, iterable, *args):
+            'Create a ChainMap with a single dict created from the iterable.'
+            return cls(dict.fromkeys(iterable, *args))
+
+        def copy(self):
+            'New ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]'
+            return self.__class__(self.maps[0].copy(), *self.maps[1:])
+
+        __copy__ = copy
+
+        def new_child(self):                        # like Django's Context.push()
+            'New ChainMap with a new dict followed by all previous maps.'
+            return self.__class__({}, *self.maps)
+
+        @property
+        def parents(self):                          # like Django's Context.pop()
+            'New ChainMap from maps[1:].'
+            return self.__class__(*self.maps[1:])
+
+        def __setitem__(self, key, value):
+            self.maps[0][key] = value
+
+        def __delitem__(self, key):
+            try:
+                del self.maps[0][key]
+            except KeyError:
+                raise KeyError('Key not found in the first mapping: {!r}'.format(key))
+
+        def popitem(self):
+            'Remove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.'
+            try:
+                return self.maps[0].popitem()
+            except KeyError:
+                raise KeyError('No keys found in the first mapping.')
+
+        def pop(self, key, *args):
+            'Remove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].'
+            try:
+                return self.maps[0].pop(key, *args)
+            except KeyError:
+                raise KeyError('Key not found in the first mapping: {!r}'.format(key))
+
+        def clear(self):
+            'Clear maps[0], leaving maps[1:] intact.'
+            self.maps[0].clear()
+
+try:
+    from importlib.util import cache_from_source  # Python >= 3.4
+except ImportError:  # pragma: no cover
+    try:
+        from imp import cache_from_source
+    except ImportError:  # pragma: no cover
+        def cache_from_source(path, debug_override=None):
+            assert path.endswith('.py')
+            if debug_override is None:
+                debug_override = __debug__
+            if debug_override:
+                suffix = 'c'
+            else:
+                suffix = 'o'
+            return path + suffix
+
+try:
+    from collections import OrderedDict
+except ImportError: # pragma: no cover
+## {{{ http://code.activestate.com/recipes/576693/ (r9)
+# Backport of OrderedDict() class that runs on Python 2.4, 2.5, 2.6, 2.7 and pypy.
+# Passes Python2.7's test suite and incorporates all the latest updates.
+    try:
+        from thread import get_ident as _get_ident
+    except ImportError:
+        from dummy_thread import get_ident as _get_ident
+
+    try:
+        from _abcoll import KeysView, ValuesView, ItemsView
+    except ImportError:
+        pass
+
+
+    class OrderedDict(dict):
+        'Dictionary that remembers insertion order'
+        # An inherited dict maps keys to values.
+        # The inherited dict provides __getitem__, __len__, __contains__, and get.
+        # The remaining methods are order-aware.
+        # Big-O running times for all methods are the same as for regular dictionaries.
+
+        # The internal self.__map dictionary maps keys to links in a doubly linked list.
+        # The circular doubly linked list starts and ends with a sentinel element.
+        # The sentinel element never gets deleted (this simplifies the algorithm).
+        # Each link is stored as a list of length three:  [PREV, NEXT, KEY].
+
+        def __init__(self, *args, **kwds):
+            '''Initialize an ordered dictionary.  Signature is the same as for
+            regular dictionaries, but keyword arguments are not recommended
+            because their insertion order is arbitrary.
+
+            '''
+            if len(args) > 1:
+                raise TypeError('expected at most 1 arguments, got %d' % len(args))
+            try:
+                self.__root
+            except AttributeError:
+                self.__root = root = []                     # sentinel node
+                root[:] = [root, root, None]
+                self.__map = {}
+            self.__update(*args, **kwds)
+
+        def __setitem__(self, key, value, dict_setitem=dict.__setitem__):
+            'od.__setitem__(i, y) <==> od[i]=y'
+            # Setting a new item creates a new link which goes at the end of the linked
+            # list, and the inherited dictionary is updated with the new key/value pair.
+            if key not in self:
+                root = self.__root
+                last = root[0]
+                last[1] = root[0] = self.__map[key] = [last, root, key]
+            dict_setitem(self, key, value)
+
+        def __delitem__(self, key, dict_delitem=dict.__delitem__):
+            'od.__delitem__(y) <==> del od[y]'
+            # Deleting an existing item uses self.__map to find the link which is
+            # then removed by updating the links in the predecessor and successor nodes.
+            dict_delitem(self, key)
+            link_prev, link_next, key = self.__map.pop(key)
+            link_prev[1] = link_next
+            link_next[0] = link_prev
+
+        def __iter__(self):
+            'od.__iter__() <==> iter(od)'
+            root = self.__root
+            curr = root[1]
+            while curr is not root:
+                yield curr[2]
+                curr = curr[1]
+
+        def __reversed__(self):
+            'od.__reversed__() <==> reversed(od)'
+            root = self.__root
+            curr = root[0]
+            while curr is not root:
+                yield curr[2]
+                curr = curr[0]
+
+        def clear(self):
+            'od.clear() -> None.  Remove all items from od.'
+            try:
+                for node in self.__map.itervalues():
+                    del node[:]
+                root = self.__root
+                root[:] = [root, root, None]
+                self.__map.clear()
+            except AttributeError:
+                pass
+            dict.clear(self)
+
+        def popitem(self, last=True):
+            '''od.popitem() -> (k, v), return and remove a (key, value) pair.
+            Pairs are returned in LIFO order if last is true or FIFO order if false.
+
+            '''
+            if not self:
+                raise KeyError('dictionary is empty')
+            root = self.__root
+            if last:
+                link = root[0]
+                link_prev = link[0]
+                link_prev[1] = root
+                root[0] = link_prev
+            else:
+                link = root[1]
+                link_next = link[1]
+                root[1] = link_next
+                link_next[0] = root
+            key = link[2]
+            del self.__map[key]
+            value = dict.pop(self, key)
+            return key, value
+
+        # -- the following methods do not depend on the internal structure --
+
+        def keys(self):
+            'od.keys() -> list of keys in od'
+            return list(self)
+
+        def values(self):
+            'od.values() -> list of values in od'
+            return [self[key] for key in self]
+
+        def items(self):
+            'od.items() -> list of (key, value) pairs in od'
+            return [(key, self[key]) for key in self]
+
+        def iterkeys(self):
+            'od.iterkeys() -> an iterator over the keys in od'
+            return iter(self)
+
+        def itervalues(self):
+            'od.itervalues -> an iterator over the values in od'
+            for k in self:
+                yield self[k]
+
+        def iteritems(self):
+            'od.iteritems -> an iterator over the (key, value) items in od'
+            for k in self:
+                yield (k, self[k])
+
+        def update(*args, **kwds):
+            '''od.update(E, **F) -> None.  Update od from dict/iterable E and F.
+
+            If E is a dict instance, does:           for k in E: od[k] = E[k]
+            If E has a .keys() method, does:         for k in E.keys(): od[k] = E[k]
+            Or if E is an iterable of items, does:   for k, v in E: od[k] = v
+            In either case, this is followed by:     for k, v in F.items(): od[k] = v
+
+            '''
+            if len(args) > 2:
+                raise TypeError('update() takes at most 2 positional '
+                                'arguments (%d given)' % (len(args),))
+            elif not args:
+                raise TypeError('update() takes at least 1 argument (0 given)')
+            self = args[0]
+            # Make progressively weaker assumptions about "other"
+            other = ()
+            if len(args) == 2:
+                other = args[1]
+            if isinstance(other, dict):
+                for key in other:
+                    self[key] = other[key]
+            elif hasattr(other, 'keys'):
+                for key in other.keys():
+                    self[key] = other[key]
+            else:
+                for key, value in other:
+                    self[key] = value
+            for key, value in kwds.items():
+                self[key] = value
+
+        __update = update  # let subclasses override update without breaking __init__
+
+        __marker = object()
+
+        def pop(self, key, default=__marker):
+            '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+            If key is not found, d is returned if given, otherwise KeyError is raised.
+
+            '''
+            if key in self:
+                result = self[key]
+                del self[key]
+                return result
+            if default is self.__marker:
+                raise KeyError(key)
+            return default
+
+        def setdefault(self, key, default=None):
+            'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od'
+            if key in self:
+                return self[key]
+            self[key] = default
+            return default
+
+        def __repr__(self, _repr_running=None):
+            'od.__repr__() <==> repr(od)'
+            if not _repr_running: _repr_running = {}
+            call_key = id(self), _get_ident()
+            if call_key in _repr_running:
+                return '...'
+            _repr_running[call_key] = 1
+            try:
+                if not self:
+                    return '%s()' % (self.__class__.__name__,)
+                return '%s(%r)' % (self.__class__.__name__, self.items())
+            finally:
+                del _repr_running[call_key]
+
+        def __reduce__(self):
+            'Return state information for pickling'
+            items = [[k, self[k]] for k in self]
+            inst_dict = vars(self).copy()
+            for k in vars(OrderedDict()):
+                inst_dict.pop(k, None)
+            if inst_dict:
+                return (self.__class__, (items,), inst_dict)
+            return self.__class__, (items,)
+
+        def copy(self):
+            'od.copy() -> a shallow copy of od'
+            return self.__class__(self)
+
+        @classmethod
+        def fromkeys(cls, iterable, value=None):
+            '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S
+            and values equal to v (which defaults to None).
+
+            '''
+            d = cls()
+            for key in iterable:
+                d[key] = value
+            return d
+
+        def __eq__(self, other):
+            '''od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive
+            while comparison to a regular mapping is order-insensitive.
+
+            '''
+            if isinstance(other, OrderedDict):
+                return len(self)==len(other) and self.items() == other.items()
+            return dict.__eq__(self, other)
+
+        def __ne__(self, other):
+            return not self == other
+
+        # -- the following methods are only used in Python 2.7 --
+
+        def viewkeys(self):
+            "od.viewkeys() -> a set-like object providing a view on od's keys"
+            return KeysView(self)
+
+        def viewvalues(self):
+            "od.viewvalues() -> an object providing a view on od's values"
+            return ValuesView(self)
+
+        def viewitems(self):
+            "od.viewitems() -> a set-like object providing a view on od's items"
+            return ItemsView(self)
+
+try:
+    from logging.config import BaseConfigurator, valid_ident
+except ImportError: # pragma: no cover
+    IDENTIFIER = re.compile('^[a-z_][a-z0-9_]*$', re.I)
+
+
+    def valid_ident(s):
+        m = IDENTIFIER.match(s)
+        if not m:
+            raise ValueError('Not a valid Python identifier: %r' % s)
+        return True
+
+
+    # The ConvertingXXX classes are wrappers around standard Python containers,
+    # and they serve to convert any suitable values in the container. The
+    # conversion converts base dicts, lists and tuples to their wrapped
+    # equivalents, whereas strings which match a conversion format are converted
+    # appropriately.
+    #
+    # Each wrapper should have a configurator attribute holding the actual
+    # configurator to use for conversion.
+
+    class ConvertingDict(dict):
+        """A converting dictionary wrapper."""
+
+        def __getitem__(self, key):
+            value = dict.__getitem__(self, key)
+            result = self.configurator.convert(value)
+            #If the converted value is different, save for next time
+            if value is not result:
+                self[key] = result
+                if type(result) in (ConvertingDict, ConvertingList,
+                                    ConvertingTuple):
+                    result.parent = self
+                    result.key = key
+            return result
+
+        def get(self, key, default=None):
+            value = dict.get(self, key, default)
+            result = self.configurator.convert(value)
+            #If the converted value is different, save for next time
+            if value is not result:
+                self[key] = result
+                if type(result) in (ConvertingDict, ConvertingList,
+                                    ConvertingTuple):
+                    result.parent = self
+                    result.key = key
+            return result
+
+    def pop(self, key, default=None):
+        value = dict.pop(self, key, default)
+        result = self.configurator.convert(value)
+        if value is not result:
+            if type(result) in (ConvertingDict, ConvertingList,
+                                ConvertingTuple):
+                result.parent = self
+                result.key = key
+        return result
+
+    class ConvertingList(list):
+        """A converting list wrapper."""
+        def __getitem__(self, key):
+            value = list.__getitem__(self, key)
+            result = self.configurator.convert(value)
+            #If the converted value is different, save for next time
+            if value is not result:
+                self[key] = result
+                if type(result) in (ConvertingDict, ConvertingList,
+                                    ConvertingTuple):
+                    result.parent = self
+                    result.key = key
+            return result
+
+        def pop(self, idx=-1):
+            value = list.pop(self, idx)
+            result = self.configurator.convert(value)
+            if value is not result:
+                if type(result) in (ConvertingDict, ConvertingList,
+                                    ConvertingTuple):
+                    result.parent = self
+            return result
+
+    class ConvertingTuple(tuple):
+        """A converting tuple wrapper."""
+        def __getitem__(self, key):
+            value = tuple.__getitem__(self, key)
+            result = self.configurator.convert(value)
+            if value is not result:
+                if type(result) in (ConvertingDict, ConvertingList,
+                                    ConvertingTuple):
+                    result.parent = self
+                    result.key = key
+            return result
+
+    class BaseConfigurator(object):
+        """
+        The configurator base class which defines some useful defaults.
+        """
+
+        CONVERT_PATTERN = re.compile(r'^(?P<prefix>[a-z]+)://(?P<suffix>.*)$')
+
+        WORD_PATTERN = re.compile(r'^\s*(\w+)\s*')
+        DOT_PATTERN = re.compile(r'^\.\s*(\w+)\s*')
+        INDEX_PATTERN = re.compile(r'^\[\s*(\w+)\s*\]\s*')
+        DIGIT_PATTERN = re.compile(r'^\d+$')
+
+        value_converters = {
+            'ext' : 'ext_convert',
+            'cfg' : 'cfg_convert',
+        }
+
+        # We might want to use a different one, e.g. importlib
+        importer = staticmethod(__import__)
+
+        def __init__(self, config):
+            self.config = ConvertingDict(config)
+            self.config.configurator = self
+
+        def resolve(self, s):
+            """
+            Resolve strings to objects using standard import and attribute
+            syntax.
+            """
+            name = s.split('.')
+            used = name.pop(0)
+            try:
+                found = self.importer(used)
+                for frag in name:
+                    used += '.' + frag
+                    try:
+                        found = getattr(found, frag)
+                    except AttributeError:
+                        self.importer(used)
+                        found = getattr(found, frag)
+                return found
+            except ImportError:
+                e, tb = sys.exc_info()[1:]
+                v = ValueError('Cannot resolve %r: %s' % (s, e))
+                v.__cause__, v.__traceback__ = e, tb
+                raise v
+
+        def ext_convert(self, value):
+            """Default converter for the ext:// protocol."""
+            return self.resolve(value)
+
+        def cfg_convert(self, value):
+            """Default converter for the cfg:// protocol."""
+            rest = value
+            m = self.WORD_PATTERN.match(rest)
+            if m is None:
+                raise ValueError("Unable to convert %r" % value)
+            else:
+                rest = rest[m.end():]
+                d = self.config[m.groups()[0]]
+                #print d, rest
+                while rest:
+                    m = self.DOT_PATTERN.match(rest)
+                    if m:
+                        d = d[m.groups()[0]]
+                    else:
+                        m = self.INDEX_PATTERN.match(rest)
+                        if m:
+                            idx = m.groups()[0]
+                            if not self.DIGIT_PATTERN.match(idx):
+                                d = d[idx]
+                            else:
+                                try:
+                                    n = int(idx) # try as number first (most likely)
+                                    d = d[n]
+                                except TypeError:
+                                    d = d[idx]
+                    if m:
+                        rest = rest[m.end():]
+                    else:
+                        raise ValueError('Unable to convert '
+                                         '%r at %r' % (value, rest))
+            #rest should be empty
+            return d
+
+        def convert(self, value):
+            """
+            Convert values to an appropriate type. dicts, lists and tuples are
+            replaced by their converting alternatives. Strings are checked to
+            see if they have a conversion format and are converted if they do.
+            """
+            if not isinstance(value, ConvertingDict) and isinstance(value, dict):
+                value = ConvertingDict(value)
+                value.configurator = self
+            elif not isinstance(value, ConvertingList) and isinstance(value, list):
+                value = ConvertingList(value)
+                value.configurator = self
+            elif not isinstance(value, ConvertingTuple) and\
+                     isinstance(value, tuple):
+                value = ConvertingTuple(value)
+                value.configurator = self
+            elif isinstance(value, string_types):
+                m = self.CONVERT_PATTERN.match(value)
+                if m:
+                    d = m.groupdict()
+                    prefix = d['prefix']
+                    converter = self.value_converters.get(prefix, None)
+                    if converter:
+                        suffix = d['suffix']
+                        converter = getattr(self, converter)
+                        value = converter(suffix)
+            return value
+
+        def configure_custom(self, config):
+            """Configure an object with a user-supplied factory."""
+            c = config.pop('()')
+            if not callable(c):
+                c = self.resolve(c)
+            props = config.pop('.', None)
+            # Check for valid identifiers
+            kwargs = dict([(k, config[k]) for k in config if valid_ident(k)])
+            result = c(**kwargs)
+            if props:
+                for name, value in props.items():
+                    setattr(result, name, value)
+            return result
+
+        def as_tuple(self, value):
+            """Utility function which converts lists to tuples."""
+            if isinstance(value, list):
+                value = tuple(value)
+            return value
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/database.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/database.py
new file mode 100644
index 0000000000000000000000000000000000000000..c16c0c8d9edd833e2a2bcf5322766c4709fc1e64
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/database.py
@@ -0,0 +1,1339 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2017 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""PEP 376 implementation."""
+
+from __future__ import unicode_literals
+
+import base64
+import codecs
+import contextlib
+import hashlib
+import logging
+import os
+import posixpath
+import sys
+import zipimport
+
+from . import DistlibException, resources
+from .compat import StringIO
+from .version import get_scheme, UnsupportedVersionError
+from .metadata import (Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME,
+                       LEGACY_METADATA_FILENAME)
+from .util import (parse_requirement, cached_property, parse_name_and_version,
+                   read_exports, write_exports, CSVReader, CSVWriter)
+
+
+__all__ = ['Distribution', 'BaseInstalledDistribution',
+           'InstalledDistribution', 'EggInfoDistribution',
+           'DistributionPath']
+
+
+logger = logging.getLogger(__name__)
+
+EXPORTS_FILENAME = 'pydist-exports.json'
+COMMANDS_FILENAME = 'pydist-commands.json'
+
+DIST_FILES = ('INSTALLER', METADATA_FILENAME, 'RECORD', 'REQUESTED',
+              'RESOURCES', EXPORTS_FILENAME, 'SHARED')
+
+DISTINFO_EXT = '.dist-info'
+
+
+class _Cache(object):
+    """
+    A simple cache mapping names and .dist-info paths to distributions
+    """
+    def __init__(self):
+        """
+        Initialise an instance. There is normally one for each DistributionPath.
+        """
+        self.name = {}
+        self.path = {}
+        self.generated = False
+
+    def clear(self):
+        """
+        Clear the cache, setting it to its initial state.
+        """
+        self.name.clear()
+        self.path.clear()
+        self.generated = False
+
+    def add(self, dist):
+        """
+        Add a distribution to the cache.
+        :param dist: The distribution to add.
+        """
+        if dist.path not in self.path:
+            self.path[dist.path] = dist
+            self.name.setdefault(dist.key, []).append(dist)
+
+
+class DistributionPath(object):
+    """
+    Represents a set of distributions installed on a path (typically sys.path).
+    """
+    def __init__(self, path=None, include_egg=False):
+        """
+        Create an instance from a path, optionally including legacy (distutils/
+        setuptools/distribute) distributions.
+        :param path: The path to use, as a list of directories. If not specified,
+                     sys.path is used.
+        :param include_egg: If True, this instance will look for and return legacy
+                            distributions as well as those based on PEP 376.
+        """
+        if path is None:
+            path = sys.path
+        self.path = path
+        self._include_dist = True
+        self._include_egg = include_egg
+
+        self._cache = _Cache()
+        self._cache_egg = _Cache()
+        self._cache_enabled = True
+        self._scheme = get_scheme('default')
+
+    def _get_cache_enabled(self):
+        return self._cache_enabled
+
+    def _set_cache_enabled(self, value):
+        self._cache_enabled = value
+
+    cache_enabled = property(_get_cache_enabled, _set_cache_enabled)
+
+    def clear_cache(self):
+        """
+        Clears the internal cache.
+        """
+        self._cache.clear()
+        self._cache_egg.clear()
+
+
+    def _yield_distributions(self):
+        """
+        Yield .dist-info and/or .egg(-info) distributions.
+        """
+        # We need to check if we've seen some resources already, because on
+        # some Linux systems (e.g. some Debian/Ubuntu variants) there are
+        # symlinks which alias other files in the environment.
+        seen = set()
+        for path in self.path:
+            finder = resources.finder_for_path(path)
+            if finder is None:
+                continue
+            r = finder.find('')
+            if not r or not r.is_container:
+                continue
+            rset = sorted(r.resources)
+            for entry in rset:
+                r = finder.find(entry)
+                if not r or r.path in seen:
+                    continue
+                if self._include_dist and entry.endswith(DISTINFO_EXT):
+                    possible_filenames = [METADATA_FILENAME,
+                                          WHEEL_METADATA_FILENAME,
+                                          LEGACY_METADATA_FILENAME]
+                    for metadata_filename in possible_filenames:
+                        metadata_path = posixpath.join(entry, metadata_filename)
+                        pydist = finder.find(metadata_path)
+                        if pydist:
+                            break
+                    else:
+                        continue
+
+                    with contextlib.closing(pydist.as_stream()) as stream:
+                        metadata = Metadata(fileobj=stream, scheme='legacy')
+                    logger.debug('Found %s', r.path)
+                    seen.add(r.path)
+                    yield new_dist_class(r.path, metadata=metadata,
+                                         env=self)
+                elif self._include_egg and entry.endswith(('.egg-info',
+                                                          '.egg')):
+                    logger.debug('Found %s', r.path)
+                    seen.add(r.path)
+                    yield old_dist_class(r.path, self)
+
+    def _generate_cache(self):
+        """
+        Scan the path for distributions and populate the cache with
+        those that are found.
+        """
+        gen_dist = not self._cache.generated
+        gen_egg = self._include_egg and not self._cache_egg.generated
+        if gen_dist or gen_egg:
+            for dist in self._yield_distributions():
+                if isinstance(dist, InstalledDistribution):
+                    self._cache.add(dist)
+                else:
+                    self._cache_egg.add(dist)
+
+            if gen_dist:
+                self._cache.generated = True
+            if gen_egg:
+                self._cache_egg.generated = True
+
+    @classmethod
+    def distinfo_dirname(cls, name, version):
+        """
+        The *name* and *version* parameters are converted into their
+        filename-escaped form, i.e. any ``'-'`` characters are replaced
+        with ``'_'`` other than the one in ``'dist-info'`` and the one
+        separating the name from the version number.
+
+        :parameter name: is converted to a standard distribution name by replacing
+                         any runs of non- alphanumeric characters with a single
+                         ``'-'``.
+        :type name: string
+        :parameter version: is converted to a standard version string. Spaces
+                            become dots, and all other non-alphanumeric characters
+                            (except dots) become dashes, with runs of multiple
+                            dashes condensed to a single dash.
+        :type version: string
+        :returns: directory name
+        :rtype: string"""
+        name = name.replace('-', '_')
+        return '-'.join([name, version]) + DISTINFO_EXT
+
+    def get_distributions(self):
+        """
+        Provides an iterator that looks for distributions and returns
+        :class:`InstalledDistribution` or
+        :class:`EggInfoDistribution` instances for each one of them.
+
+        :rtype: iterator of :class:`InstalledDistribution` and
+                :class:`EggInfoDistribution` instances
+        """
+        if not self._cache_enabled:
+            for dist in self._yield_distributions():
+                yield dist
+        else:
+            self._generate_cache()
+
+            for dist in self._cache.path.values():
+                yield dist
+
+            if self._include_egg:
+                for dist in self._cache_egg.path.values():
+                    yield dist
+
+    def get_distribution(self, name):
+        """
+        Looks for a named distribution on the path.
+
+        This function only returns the first result found, as no more than one
+        value is expected. If nothing is found, ``None`` is returned.
+
+        :rtype: :class:`InstalledDistribution`, :class:`EggInfoDistribution`
+                or ``None``
+        """
+        result = None
+        name = name.lower()
+        if not self._cache_enabled:
+            for dist in self._yield_distributions():
+                if dist.key == name:
+                    result = dist
+                    break
+        else:
+            self._generate_cache()
+
+            if name in self._cache.name:
+                result = self._cache.name[name][0]
+            elif self._include_egg and name in self._cache_egg.name:
+                result = self._cache_egg.name[name][0]
+        return result
+
+    def provides_distribution(self, name, version=None):
+        """
+        Iterates over all distributions to find which distributions provide *name*.
+        If a *version* is provided, it will be used to filter the results.
+
+        This function only returns the first result found, since no more than
+        one values are expected. If the directory is not found, returns ``None``.
+
+        :parameter version: a version specifier that indicates the version
+                            required, conforming to the format in ``PEP-345``
+
+        :type name: string
+        :type version: string
+        """
+        matcher = None
+        if version is not None:
+            try:
+                matcher = self._scheme.matcher('%s (%s)' % (name, version))
+            except ValueError:
+                raise DistlibException('invalid name or version: %r, %r' %
+                                      (name, version))
+
+        for dist in self.get_distributions():
+            # We hit a problem on Travis where enum34 was installed and doesn't
+            # have a provides attribute ...
+            if not hasattr(dist, 'provides'):
+                logger.debug('No "provides": %s', dist)
+            else:
+                provided = dist.provides
+
+                for p in provided:
+                    p_name, p_ver = parse_name_and_version(p)
+                    if matcher is None:
+                        if p_name == name:
+                            yield dist
+                            break
+                    else:
+                        if p_name == name and matcher.match(p_ver):
+                            yield dist
+                            break
+
+    def get_file_path(self, name, relative_path):
+        """
+        Return the path to a resource file.
+        """
+        dist = self.get_distribution(name)
+        if dist is None:
+            raise LookupError('no distribution named %r found' % name)
+        return dist.get_resource_path(relative_path)
+
+    def get_exported_entries(self, category, name=None):
+        """
+        Return all of the exported entries in a particular category.
+
+        :param category: The category to search for entries.
+        :param name: If specified, only entries with that name are returned.
+        """
+        for dist in self.get_distributions():
+            r = dist.exports
+            if category in r:
+                d = r[category]
+                if name is not None:
+                    if name in d:
+                        yield d[name]
+                else:
+                    for v in d.values():
+                        yield v
+
+
+class Distribution(object):
+    """
+    A base class for distributions, whether installed or from indexes.
+    Either way, it must have some metadata, so that's all that's needed
+    for construction.
+    """
+
+    build_time_dependency = False
+    """
+    Set to True if it's known to be only a build-time dependency (i.e.
+    not needed after installation).
+    """
+
+    requested = False
+    """A boolean that indicates whether the ``REQUESTED`` metadata file is
+    present (in other words, whether the package was installed by user
+    request or it was installed as a dependency)."""
+
+    def __init__(self, metadata):
+        """
+        Initialise an instance.
+        :param metadata: The instance of :class:`Metadata` describing this
+        distribution.
+        """
+        self.metadata = metadata
+        self.name = metadata.name
+        self.key = self.name.lower()    # for case-insensitive comparisons
+        self.version = metadata.version
+        self.locator = None
+        self.digest = None
+        self.extras = None      # additional features requested
+        self.context = None     # environment marker overrides
+        self.download_urls = set()
+        self.digests = {}
+
+    @property
+    def source_url(self):
+        """
+        The source archive download URL for this distribution.
+        """
+        return self.metadata.source_url
+
+    download_url = source_url   # Backward compatibility
+
+    @property
+    def name_and_version(self):
+        """
+        A utility property which displays the name and version in parentheses.
+        """
+        return '%s (%s)' % (self.name, self.version)
+
+    @property
+    def provides(self):
+        """
+        A set of distribution names and versions provided by this distribution.
+        :return: A set of "name (version)" strings.
+        """
+        plist = self.metadata.provides
+        s = '%s (%s)' % (self.name, self.version)
+        if s not in plist:
+            plist.append(s)
+        return plist
+
+    def _get_requirements(self, req_attr):
+        md = self.metadata
+        logger.debug('Getting requirements from metadata %r', md.todict())
+        reqts = getattr(md, req_attr)
+        return set(md.get_requirements(reqts, extras=self.extras,
+                                       env=self.context))
+
+    @property
+    def run_requires(self):
+        return self._get_requirements('run_requires')
+
+    @property
+    def meta_requires(self):
+        return self._get_requirements('meta_requires')
+
+    @property
+    def build_requires(self):
+        return self._get_requirements('build_requires')
+
+    @property
+    def test_requires(self):
+        return self._get_requirements('test_requires')
+
+    @property
+    def dev_requires(self):
+        return self._get_requirements('dev_requires')
+
+    def matches_requirement(self, req):
+        """
+        Say if this instance matches (fulfills) a requirement.
+        :param req: The requirement to match.
+        :rtype req: str
+        :return: True if it matches, else False.
+        """
+        # Requirement may contain extras - parse to lose those
+        # from what's passed to the matcher
+        r = parse_requirement(req)
+        scheme = get_scheme(self.metadata.scheme)
+        try:
+            matcher = scheme.matcher(r.requirement)
+        except UnsupportedVersionError:
+            # XXX compat-mode if cannot read the version
+            logger.warning('could not read version %r - using name only',
+                           req)
+            name = req.split()[0]
+            matcher = scheme.matcher(name)
+
+        name = matcher.key   # case-insensitive
+
+        result = False
+        for p in self.provides:
+            p_name, p_ver = parse_name_and_version(p)
+            if p_name != name:
+                continue
+            try:
+                result = matcher.match(p_ver)
+                break
+            except UnsupportedVersionError:
+                pass
+        return result
+
+    def __repr__(self):
+        """
+        Return a textual representation of this instance,
+        """
+        if self.source_url:
+            suffix = ' [%s]' % self.source_url
+        else:
+            suffix = ''
+        return '<Distribution %s (%s)%s>' % (self.name, self.version, suffix)
+
+    def __eq__(self, other):
+        """
+        See if this distribution is the same as another.
+        :param other: The distribution to compare with. To be equal to one
+                      another. distributions must have the same type, name,
+                      version and source_url.
+        :return: True if it is the same, else False.
+        """
+        if type(other) is not type(self):
+            result = False
+        else:
+            result = (self.name == other.name and
+                      self.version == other.version and
+                      self.source_url == other.source_url)
+        return result
+
+    def __hash__(self):
+        """
+        Compute hash in a way which matches the equality test.
+        """
+        return hash(self.name) + hash(self.version) + hash(self.source_url)
+
+
+class BaseInstalledDistribution(Distribution):
+    """
+    This is the base class for installed distributions (whether PEP 376 or
+    legacy).
+    """
+
+    hasher = None
+
+    def __init__(self, metadata, path, env=None):
+        """
+        Initialise an instance.
+        :param metadata: An instance of :class:`Metadata` which describes the
+                         distribution. This will normally have been initialised
+                         from a metadata file in the ``path``.
+        :param path:     The path of the ``.dist-info`` or ``.egg-info``
+                         directory for the distribution.
+        :param env:      This is normally the :class:`DistributionPath`
+                         instance where this distribution was found.
+        """
+        super(BaseInstalledDistribution, self).__init__(metadata)
+        self.path = path
+        self.dist_path = env
+
+    def get_hash(self, data, hasher=None):
+        """
+        Get the hash of some data, using a particular hash algorithm, if
+        specified.
+
+        :param data: The data to be hashed.
+        :type data: bytes
+        :param hasher: The name of a hash implementation, supported by hashlib,
+                       or ``None``. Examples of valid values are ``'sha1'``,
+                       ``'sha224'``, ``'sha384'``, '``sha256'``, ``'md5'`` and
+                       ``'sha512'``. If no hasher is specified, the ``hasher``
+                       attribute of the :class:`InstalledDistribution` instance
+                       is used. If the hasher is determined to be ``None``, MD5
+                       is used as the hashing algorithm.
+        :returns: The hash of the data. If a hasher was explicitly specified,
+                  the returned hash will be prefixed with the specified hasher
+                  followed by '='.
+        :rtype: str
+        """
+        if hasher is None:
+            hasher = self.hasher
+        if hasher is None:
+            hasher = hashlib.md5
+            prefix = ''
+        else:
+            hasher = getattr(hashlib, hasher)
+            prefix = '%s=' % self.hasher
+        digest = hasher(data).digest()
+        digest = base64.urlsafe_b64encode(digest).rstrip(b'=').decode('ascii')
+        return '%s%s' % (prefix, digest)
+
+
+class InstalledDistribution(BaseInstalledDistribution):
+    """
+    Created with the *path* of the ``.dist-info`` directory provided to the
+    constructor. It reads the metadata contained in ``pydist.json`` when it is
+    instantiated., or uses a passed in Metadata instance (useful for when
+    dry-run mode is being used).
+    """
+
+    hasher = 'sha256'
+
+    def __init__(self, path, metadata=None, env=None):
+        self.modules = []
+        self.finder = finder = resources.finder_for_path(path)
+        if finder is None:
+            raise ValueError('finder unavailable for %s' % path)
+        if env and env._cache_enabled and path in env._cache.path:
+            metadata = env._cache.path[path].metadata
+        elif metadata is None:
+            r = finder.find(METADATA_FILENAME)
+            # Temporary - for Wheel 0.23 support
+            if r is None:
+                r = finder.find(WHEEL_METADATA_FILENAME)
+            # Temporary - for legacy support
+            if r is None:
+                r = finder.find('METADATA')
+            if r is None:
+                raise ValueError('no %s found in %s' % (METADATA_FILENAME,
+                                                        path))
+            with contextlib.closing(r.as_stream()) as stream:
+                metadata = Metadata(fileobj=stream, scheme='legacy')
+
+        super(InstalledDistribution, self).__init__(metadata, path, env)
+
+        if env and env._cache_enabled:
+            env._cache.add(self)
+
+        r = finder.find('REQUESTED')
+        self.requested = r is not None
+        p  = os.path.join(path, 'top_level.txt')
+        if os.path.exists(p):
+            with open(p, 'rb') as f:
+                data = f.read().decode('utf-8')
+            self.modules = data.splitlines()
+
+    def __repr__(self):
+        return '<InstalledDistribution %r %s at %r>' % (
+            self.name, self.version, self.path)
+
+    def __str__(self):
+        return "%s %s" % (self.name, self.version)
+
+    def _get_records(self):
+        """
+        Get the list of installed files for the distribution
+        :return: A list of tuples of path, hash and size. Note that hash and
+                 size might be ``None`` for some entries. The path is exactly
+                 as stored in the file (which is as in PEP 376).
+        """
+        results = []
+        r = self.get_distinfo_resource('RECORD')
+        with contextlib.closing(r.as_stream()) as stream:
+            with CSVReader(stream=stream) as record_reader:
+                # Base location is parent dir of .dist-info dir
+                #base_location = os.path.dirname(self.path)
+                #base_location = os.path.abspath(base_location)
+                for row in record_reader:
+                    missing = [None for i in range(len(row), 3)]
+                    path, checksum, size = row + missing
+                    #if not os.path.isabs(path):
+                    #    path = path.replace('/', os.sep)
+                    #    path = os.path.join(base_location, path)
+                    results.append((path, checksum, size))
+        return results
+
+    @cached_property
+    def exports(self):
+        """
+        Return the information exported by this distribution.
+        :return: A dictionary of exports, mapping an export category to a dict
+                 of :class:`ExportEntry` instances describing the individual
+                 export entries, and keyed by name.
+        """
+        result = {}
+        r = self.get_distinfo_resource(EXPORTS_FILENAME)
+        if r:
+            result = self.read_exports()
+        return result
+
+    def read_exports(self):
+        """
+        Read exports data from a file in .ini format.
+
+        :return: A dictionary of exports, mapping an export category to a list
+                 of :class:`ExportEntry` instances describing the individual
+                 export entries.
+        """
+        result = {}
+        r = self.get_distinfo_resource(EXPORTS_FILENAME)
+        if r:
+            with contextlib.closing(r.as_stream()) as stream:
+                result = read_exports(stream)
+        return result
+
+    def write_exports(self, exports):
+        """
+        Write a dictionary of exports to a file in .ini format.
+        :param exports: A dictionary of exports, mapping an export category to
+                        a list of :class:`ExportEntry` instances describing the
+                        individual export entries.
+        """
+        rf = self.get_distinfo_file(EXPORTS_FILENAME)
+        with open(rf, 'w') as f:
+            write_exports(exports, f)
+
+    def get_resource_path(self, relative_path):
+        """
+        NOTE: This API may change in the future.
+
+        Return the absolute path to a resource file with the given relative
+        path.
+
+        :param relative_path: The path, relative to .dist-info, of the resource
+                              of interest.
+        :return: The absolute path where the resource is to be found.
+        """
+        r = self.get_distinfo_resource('RESOURCES')
+        with contextlib.closing(r.as_stream()) as stream:
+            with CSVReader(stream=stream) as resources_reader:
+                for relative, destination in resources_reader:
+                    if relative == relative_path:
+                        return destination
+        raise KeyError('no resource file with relative path %r '
+                       'is installed' % relative_path)
+
+    def list_installed_files(self):
+        """
+        Iterates over the ``RECORD`` entries and returns a tuple
+        ``(path, hash, size)`` for each line.
+
+        :returns: iterator of (path, hash, size)
+        """
+        for result in self._get_records():
+            yield result
+
+    def write_installed_files(self, paths, prefix, dry_run=False):
+        """
+        Writes the ``RECORD`` file, using the ``paths`` iterable passed in. Any
+        existing ``RECORD`` file is silently overwritten.
+
+        prefix is used to determine when to write absolute paths.
+        """
+        prefix = os.path.join(prefix, '')
+        base = os.path.dirname(self.path)
+        base_under_prefix = base.startswith(prefix)
+        base = os.path.join(base, '')
+        record_path = self.get_distinfo_file('RECORD')
+        logger.info('creating %s', record_path)
+        if dry_run:
+            return None
+        with CSVWriter(record_path) as writer:
+            for path in paths:
+                if os.path.isdir(path) or path.endswith(('.pyc', '.pyo')):
+                    # do not put size and hash, as in PEP-376
+                    hash_value = size = ''
+                else:
+                    size = '%d' % os.path.getsize(path)
+                    with open(path, 'rb') as fp:
+                        hash_value = self.get_hash(fp.read())
+                if path.startswith(base) or (base_under_prefix and
+                                             path.startswith(prefix)):
+                    path = os.path.relpath(path, base)
+                writer.writerow((path, hash_value, size))
+
+            # add the RECORD file itself
+            if record_path.startswith(base):
+                record_path = os.path.relpath(record_path, base)
+            writer.writerow((record_path, '', ''))
+        return record_path
+
+    def check_installed_files(self):
+        """
+        Checks that the hashes and sizes of the files in ``RECORD`` are
+        matched by the files themselves. Returns a (possibly empty) list of
+        mismatches. Each entry in the mismatch list will be a tuple consisting
+        of the path, 'exists', 'size' or 'hash' according to what didn't match
+        (existence is checked first, then size, then hash), the expected
+        value and the actual value.
+        """
+        mismatches = []
+        base = os.path.dirname(self.path)
+        record_path = self.get_distinfo_file('RECORD')
+        for path, hash_value, size in self.list_installed_files():
+            if not os.path.isabs(path):
+                path = os.path.join(base, path)
+            if path == record_path:
+                continue
+            if not os.path.exists(path):
+                mismatches.append((path, 'exists', True, False))
+            elif os.path.isfile(path):
+                actual_size = str(os.path.getsize(path))
+                if size and actual_size != size:
+                    mismatches.append((path, 'size', size, actual_size))
+                elif hash_value:
+                    if '=' in hash_value:
+                        hasher = hash_value.split('=', 1)[0]
+                    else:
+                        hasher = None
+
+                    with open(path, 'rb') as f:
+                        actual_hash = self.get_hash(f.read(), hasher)
+                        if actual_hash != hash_value:
+                            mismatches.append((path, 'hash', hash_value, actual_hash))
+        return mismatches
+
+    @cached_property
+    def shared_locations(self):
+        """
+        A dictionary of shared locations whose keys are in the set 'prefix',
+        'purelib', 'platlib', 'scripts', 'headers', 'data' and 'namespace'.
+        The corresponding value is the absolute path of that category for
+        this distribution, and takes into account any paths selected by the
+        user at installation time (e.g. via command-line arguments). In the
+        case of the 'namespace' key, this would be a list of absolute paths
+        for the roots of namespace packages in this distribution.
+
+        The first time this property is accessed, the relevant information is
+        read from the SHARED file in the .dist-info directory.
+        """
+        result = {}
+        shared_path = os.path.join(self.path, 'SHARED')
+        if os.path.isfile(shared_path):
+            with codecs.open(shared_path, 'r', encoding='utf-8') as f:
+                lines = f.read().splitlines()
+            for line in lines:
+                key, value = line.split('=', 1)
+                if key == 'namespace':
+                    result.setdefault(key, []).append(value)
+                else:
+                    result[key] = value
+        return result
+
+    def write_shared_locations(self, paths, dry_run=False):
+        """
+        Write shared location information to the SHARED file in .dist-info.
+        :param paths: A dictionary as described in the documentation for
+        :meth:`shared_locations`.
+        :param dry_run: If True, the action is logged but no file is actually
+                        written.
+        :return: The path of the file written to.
+        """
+        shared_path = os.path.join(self.path, 'SHARED')
+        logger.info('creating %s', shared_path)
+        if dry_run:
+            return None
+        lines = []
+        for key in ('prefix', 'lib', 'headers', 'scripts', 'data'):
+            path = paths[key]
+            if os.path.isdir(paths[key]):
+                lines.append('%s=%s' % (key,  path))
+        for ns in paths.get('namespace', ()):
+            lines.append('namespace=%s' % ns)
+
+        with codecs.open(shared_path, 'w', encoding='utf-8') as f:
+            f.write('\n'.join(lines))
+        return shared_path
+
+    def get_distinfo_resource(self, path):
+        if path not in DIST_FILES:
+            raise DistlibException('invalid path for a dist-info file: '
+                                   '%r at %r' % (path, self.path))
+        finder = resources.finder_for_path(self.path)
+        if finder is None:
+            raise DistlibException('Unable to get a finder for %s' % self.path)
+        return finder.find(path)
+
+    def get_distinfo_file(self, path):
+        """
+        Returns a path located under the ``.dist-info`` directory. Returns a
+        string representing the path.
+
+        :parameter path: a ``'/'``-separated path relative to the
+                         ``.dist-info`` directory or an absolute path;
+                         If *path* is an absolute path and doesn't start
+                         with the ``.dist-info`` directory path,
+                         a :class:`DistlibException` is raised
+        :type path: str
+        :rtype: str
+        """
+        # Check if it is an absolute path  # XXX use relpath, add tests
+        if path.find(os.sep) >= 0:
+            # it's an absolute path?
+            distinfo_dirname, path = path.split(os.sep)[-2:]
+            if distinfo_dirname != self.path.split(os.sep)[-1]:
+                raise DistlibException(
+                    'dist-info file %r does not belong to the %r %s '
+                    'distribution' % (path, self.name, self.version))
+
+        # The file must be relative
+        if path not in DIST_FILES:
+            raise DistlibException('invalid path for a dist-info file: '
+                                   '%r at %r' % (path, self.path))
+
+        return os.path.join(self.path, path)
+
+    def list_distinfo_files(self):
+        """
+        Iterates over the ``RECORD`` entries and returns paths for each line if
+        the path is pointing to a file located in the ``.dist-info`` directory
+        or one of its subdirectories.
+
+        :returns: iterator of paths
+        """
+        base = os.path.dirname(self.path)
+        for path, checksum, size in self._get_records():
+            # XXX add separator or use real relpath algo
+            if not os.path.isabs(path):
+                path = os.path.join(base, path)
+            if path.startswith(self.path):
+                yield path
+
+    def __eq__(self, other):
+        return (isinstance(other, InstalledDistribution) and
+                self.path == other.path)
+
+    # See http://docs.python.org/reference/datamodel#object.__hash__
+    __hash__ = object.__hash__
+
+
+class EggInfoDistribution(BaseInstalledDistribution):
+    """Created with the *path* of the ``.egg-info`` directory or file provided
+    to the constructor. It reads the metadata contained in the file itself, or
+    if the given path happens to be a directory, the metadata is read from the
+    file ``PKG-INFO`` under that directory."""
+
+    requested = True    # as we have no way of knowing, assume it was
+    shared_locations = {}
+
+    def __init__(self, path, env=None):
+        def set_name_and_version(s, n, v):
+            s.name = n
+            s.key = n.lower()   # for case-insensitive comparisons
+            s.version = v
+
+        self.path = path
+        self.dist_path = env
+        if env and env._cache_enabled and path in env._cache_egg.path:
+            metadata = env._cache_egg.path[path].metadata
+            set_name_and_version(self, metadata.name, metadata.version)
+        else:
+            metadata = self._get_metadata(path)
+
+            # Need to be set before caching
+            set_name_and_version(self, metadata.name, metadata.version)
+
+            if env and env._cache_enabled:
+                env._cache_egg.add(self)
+        super(EggInfoDistribution, self).__init__(metadata, path, env)
+
+    def _get_metadata(self, path):
+        requires = None
+
+        def parse_requires_data(data):
+            """Create a list of dependencies from a requires.txt file.
+
+            *data*: the contents of a setuptools-produced requires.txt file.
+            """
+            reqs = []
+            lines = data.splitlines()
+            for line in lines:
+                line = line.strip()
+                if line.startswith('['):
+                    logger.warning('Unexpected line: quitting requirement scan: %r',
+                                   line)
+                    break
+                r = parse_requirement(line)
+                if not r:
+                    logger.warning('Not recognised as a requirement: %r', line)
+                    continue
+                if r.extras:
+                    logger.warning('extra requirements in requires.txt are '
+                                   'not supported')
+                if not r.constraints:
+                    reqs.append(r.name)
+                else:
+                    cons = ', '.join('%s%s' % c for c in r.constraints)
+                    reqs.append('%s (%s)' % (r.name, cons))
+            return reqs
+
+        def parse_requires_path(req_path):
+            """Create a list of dependencies from a requires.txt file.
+
+            *req_path*: the path to a setuptools-produced requires.txt file.
+            """
+
+            reqs = []
+            try:
+                with codecs.open(req_path, 'r', 'utf-8') as fp:
+                    reqs = parse_requires_data(fp.read())
+            except IOError:
+                pass
+            return reqs
+
+        tl_path = tl_data = None
+        if path.endswith('.egg'):
+            if os.path.isdir(path):
+                p = os.path.join(path, 'EGG-INFO')
+                meta_path = os.path.join(p, 'PKG-INFO')
+                metadata = Metadata(path=meta_path, scheme='legacy')
+                req_path = os.path.join(p, 'requires.txt')
+                tl_path = os.path.join(p, 'top_level.txt')
+                requires = parse_requires_path(req_path)
+            else:
+                # FIXME handle the case where zipfile is not available
+                zipf = zipimport.zipimporter(path)
+                fileobj = StringIO(
+                    zipf.get_data('EGG-INFO/PKG-INFO').decode('utf8'))
+                metadata = Metadata(fileobj=fileobj, scheme='legacy')
+                try:
+                    data = zipf.get_data('EGG-INFO/requires.txt')
+                    tl_data = zipf.get_data('EGG-INFO/top_level.txt').decode('utf-8')
+                    requires = parse_requires_data(data.decode('utf-8'))
+                except IOError:
+                    requires = None
+        elif path.endswith('.egg-info'):
+            if os.path.isdir(path):
+                req_path = os.path.join(path, 'requires.txt')
+                requires = parse_requires_path(req_path)
+                path = os.path.join(path, 'PKG-INFO')
+                tl_path = os.path.join(path, 'top_level.txt')
+            metadata = Metadata(path=path, scheme='legacy')
+        else:
+            raise DistlibException('path must end with .egg-info or .egg, '
+                                   'got %r' % path)
+
+        if requires:
+            metadata.add_requirements(requires)
+        # look for top-level modules in top_level.txt, if present
+        if tl_data is None:
+            if tl_path is not None and os.path.exists(tl_path):
+                with open(tl_path, 'rb') as f:
+                    tl_data = f.read().decode('utf-8')
+        if not tl_data:
+            tl_data = []
+        else:
+            tl_data = tl_data.splitlines()
+        self.modules = tl_data
+        return metadata
+
+    def __repr__(self):
+        return '<EggInfoDistribution %r %s at %r>' % (
+            self.name, self.version, self.path)
+
+    def __str__(self):
+        return "%s %s" % (self.name, self.version)
+
+    def check_installed_files(self):
+        """
+        Checks that the hashes and sizes of the files in ``RECORD`` are
+        matched by the files themselves. Returns a (possibly empty) list of
+        mismatches. Each entry in the mismatch list will be a tuple consisting
+        of the path, 'exists', 'size' or 'hash' according to what didn't match
+        (existence is checked first, then size, then hash), the expected
+        value and the actual value.
+        """
+        mismatches = []
+        record_path = os.path.join(self.path, 'installed-files.txt')
+        if os.path.exists(record_path):
+            for path, _, _ in self.list_installed_files():
+                if path == record_path:
+                    continue
+                if not os.path.exists(path):
+                    mismatches.append((path, 'exists', True, False))
+        return mismatches
+
+    def list_installed_files(self):
+        """
+        Iterates over the ``installed-files.txt`` entries and returns a tuple
+        ``(path, hash, size)`` for each line.
+
+        :returns: a list of (path, hash, size)
+        """
+
+        def _md5(path):
+            f = open(path, 'rb')
+            try:
+                content = f.read()
+            finally:
+                f.close()
+            return hashlib.md5(content).hexdigest()
+
+        def _size(path):
+            return os.stat(path).st_size
+
+        record_path = os.path.join(self.path, 'installed-files.txt')
+        result = []
+        if os.path.exists(record_path):
+            with codecs.open(record_path, 'r', encoding='utf-8') as f:
+                for line in f:
+                    line = line.strip()
+                    p = os.path.normpath(os.path.join(self.path, line))
+                    # "./" is present as a marker between installed files
+                    # and installation metadata files
+                    if not os.path.exists(p):
+                        logger.warning('Non-existent file: %s', p)
+                        if p.endswith(('.pyc', '.pyo')):
+                            continue
+                        #otherwise fall through and fail
+                    if not os.path.isdir(p):
+                        result.append((p, _md5(p), _size(p)))
+            result.append((record_path, None, None))
+        return result
+
+    def list_distinfo_files(self, absolute=False):
+        """
+        Iterates over the ``installed-files.txt`` entries and returns paths for
+        each line if the path is pointing to a file located in the
+        ``.egg-info`` directory or one of its subdirectories.
+
+        :parameter absolute: If *absolute* is ``True``, each returned path is
+                          transformed into a local absolute path. Otherwise the
+                          raw value from ``installed-files.txt`` is returned.
+        :type absolute: boolean
+        :returns: iterator of paths
+        """
+        record_path = os.path.join(self.path, 'installed-files.txt')
+        if os.path.exists(record_path):
+            skip = True
+            with codecs.open(record_path, 'r', encoding='utf-8') as f:
+                for line in f:
+                    line = line.strip()
+                    if line == './':
+                        skip = False
+                        continue
+                    if not skip:
+                        p = os.path.normpath(os.path.join(self.path, line))
+                        if p.startswith(self.path):
+                            if absolute:
+                                yield p
+                            else:
+                                yield line
+
+    def __eq__(self, other):
+        return (isinstance(other, EggInfoDistribution) and
+                self.path == other.path)
+
+    # See http://docs.python.org/reference/datamodel#object.__hash__
+    __hash__ = object.__hash__
+
+new_dist_class = InstalledDistribution
+old_dist_class = EggInfoDistribution
+
+
+class DependencyGraph(object):
+    """
+    Represents a dependency graph between distributions.
+
+    The dependency relationships are stored in an ``adjacency_list`` that maps
+    distributions to a list of ``(other, label)`` tuples where  ``other``
+    is a distribution and the edge is labeled with ``label`` (i.e. the version
+    specifier, if such was provided). Also, for more efficient traversal, for
+    every distribution ``x``, a list of predecessors is kept in
+    ``reverse_list[x]``. An edge from distribution ``a`` to
+    distribution ``b`` means that ``a`` depends on ``b``. If any missing
+    dependencies are found, they are stored in ``missing``, which is a
+    dictionary that maps distributions to a list of requirements that were not
+    provided by any other distributions.
+    """
+
+    def __init__(self):
+        self.adjacency_list = {}
+        self.reverse_list = {}
+        self.missing = {}
+
+    def add_distribution(self, distribution):
+        """Add the *distribution* to the graph.
+
+        :type distribution: :class:`distutils2.database.InstalledDistribution`
+                            or :class:`distutils2.database.EggInfoDistribution`
+        """
+        self.adjacency_list[distribution] = []
+        self.reverse_list[distribution] = []
+        #self.missing[distribution] = []
+
+    def add_edge(self, x, y, label=None):
+        """Add an edge from distribution *x* to distribution *y* with the given
+        *label*.
+
+        :type x: :class:`distutils2.database.InstalledDistribution` or
+                 :class:`distutils2.database.EggInfoDistribution`
+        :type y: :class:`distutils2.database.InstalledDistribution` or
+                 :class:`distutils2.database.EggInfoDistribution`
+        :type label: ``str`` or ``None``
+        """
+        self.adjacency_list[x].append((y, label))
+        # multiple edges are allowed, so be careful
+        if x not in self.reverse_list[y]:
+            self.reverse_list[y].append(x)
+
+    def add_missing(self, distribution, requirement):
+        """
+        Add a missing *requirement* for the given *distribution*.
+
+        :type distribution: :class:`distutils2.database.InstalledDistribution`
+                            or :class:`distutils2.database.EggInfoDistribution`
+        :type requirement: ``str``
+        """
+        logger.debug('%s missing %r', distribution, requirement)
+        self.missing.setdefault(distribution, []).append(requirement)
+
+    def _repr_dist(self, dist):
+        return '%s %s' % (dist.name, dist.version)
+
+    def repr_node(self, dist, level=1):
+        """Prints only a subgraph"""
+        output = [self._repr_dist(dist)]
+        for other, label in self.adjacency_list[dist]:
+            dist = self._repr_dist(other)
+            if label is not None:
+                dist = '%s [%s]' % (dist, label)
+            output.append('    ' * level + str(dist))
+            suboutput = self.repr_node(other, level + 1)
+            subs = suboutput.split('\n')
+            output.extend(subs[1:])
+        return '\n'.join(output)
+
+    def to_dot(self, f, skip_disconnected=True):
+        """Writes a DOT output for the graph to the provided file *f*.
+
+        If *skip_disconnected* is set to ``True``, then all distributions
+        that are not dependent on any other distribution are skipped.
+
+        :type f: has to support ``file``-like operations
+        :type skip_disconnected: ``bool``
+        """
+        disconnected = []
+
+        f.write("digraph dependencies {\n")
+        for dist, adjs in self.adjacency_list.items():
+            if len(adjs) == 0 and not skip_disconnected:
+                disconnected.append(dist)
+            for other, label in adjs:
+                if not label is None:
+                    f.write('"%s" -> "%s" [label="%s"]\n' %
+                            (dist.name, other.name, label))
+                else:
+                    f.write('"%s" -> "%s"\n' % (dist.name, other.name))
+        if not skip_disconnected and len(disconnected) > 0:
+            f.write('subgraph disconnected {\n')
+            f.write('label = "Disconnected"\n')
+            f.write('bgcolor = red\n')
+
+            for dist in disconnected:
+                f.write('"%s"' % dist.name)
+                f.write('\n')
+            f.write('}\n')
+        f.write('}\n')
+
+    def topological_sort(self):
+        """
+        Perform a topological sort of the graph.
+        :return: A tuple, the first element of which is a topologically sorted
+                 list of distributions, and the second element of which is a
+                 list of distributions that cannot be sorted because they have
+                 circular dependencies and so form a cycle.
+        """
+        result = []
+        # Make a shallow copy of the adjacency list
+        alist = {}
+        for k, v in self.adjacency_list.items():
+            alist[k] = v[:]
+        while True:
+            # See what we can remove in this run
+            to_remove = []
+            for k, v in list(alist.items())[:]:
+                if not v:
+                    to_remove.append(k)
+                    del alist[k]
+            if not to_remove:
+                # What's left in alist (if anything) is a cycle.
+                break
+            # Remove from the adjacency list of others
+            for k, v in alist.items():
+                alist[k] = [(d, r) for d, r in v if d not in to_remove]
+            logger.debug('Moving to result: %s',
+                         ['%s (%s)' % (d.name, d.version) for d in to_remove])
+            result.extend(to_remove)
+        return result, list(alist.keys())
+
+    def __repr__(self):
+        """Representation of the graph"""
+        output = []
+        for dist, adjs in self.adjacency_list.items():
+            output.append(self.repr_node(dist))
+        return '\n'.join(output)
+
+
+def make_graph(dists, scheme='default'):
+    """Makes a dependency graph from the given distributions.
+
+    :parameter dists: a list of distributions
+    :type dists: list of :class:`distutils2.database.InstalledDistribution` and
+                 :class:`distutils2.database.EggInfoDistribution` instances
+    :rtype: a :class:`DependencyGraph` instance
+    """
+    scheme = get_scheme(scheme)
+    graph = DependencyGraph()
+    provided = {}  # maps names to lists of (version, dist) tuples
+
+    # first, build the graph and find out what's provided
+    for dist in dists:
+        graph.add_distribution(dist)
+
+        for p in dist.provides:
+            name, version = parse_name_and_version(p)
+            logger.debug('Add to provided: %s, %s, %s', name, version, dist)
+            provided.setdefault(name, []).append((version, dist))
+
+    # now make the edges
+    for dist in dists:
+        requires = (dist.run_requires | dist.meta_requires |
+                    dist.build_requires | dist.dev_requires)
+        for req in requires:
+            try:
+                matcher = scheme.matcher(req)
+            except UnsupportedVersionError:
+                # XXX compat-mode if cannot read the version
+                logger.warning('could not read version %r - using name only',
+                               req)
+                name = req.split()[0]
+                matcher = scheme.matcher(name)
+
+            name = matcher.key   # case-insensitive
+
+            matched = False
+            if name in provided:
+                for version, provider in provided[name]:
+                    try:
+                        match = matcher.match(version)
+                    except UnsupportedVersionError:
+                        match = False
+
+                    if match:
+                        graph.add_edge(dist, provider, req)
+                        matched = True
+                        break
+            if not matched:
+                graph.add_missing(dist, req)
+    return graph
+
+
+def get_dependent_dists(dists, dist):
+    """Recursively generate a list of distributions from *dists* that are
+    dependent on *dist*.
+
+    :param dists: a list of distributions
+    :param dist: a distribution, member of *dists* for which we are interested
+    """
+    if dist not in dists:
+        raise DistlibException('given distribution %r is not a member '
+                               'of the list' % dist.name)
+    graph = make_graph(dists)
+
+    dep = [dist]  # dependent distributions
+    todo = graph.reverse_list[dist]  # list of nodes we should inspect
+
+    while todo:
+        d = todo.pop()
+        dep.append(d)
+        for succ in graph.reverse_list[d]:
+            if succ not in dep:
+                todo.append(succ)
+
+    dep.pop(0)  # remove dist from dep, was there to prevent infinite loops
+    return dep
+
+
+def get_required_dists(dists, dist):
+    """Recursively generate a list of distributions from *dists* that are
+    required by *dist*.
+
+    :param dists: a list of distributions
+    :param dist: a distribution, member of *dists* for which we are interested
+    """
+    if dist not in dists:
+        raise DistlibException('given distribution %r is not a member '
+                               'of the list' % dist.name)
+    graph = make_graph(dists)
+
+    req = []  # required distributions
+    todo = graph.adjacency_list[dist]  # list of nodes we should inspect
+
+    while todo:
+        d = todo.pop()[0]
+        req.append(d)
+        for pred in graph.adjacency_list[d]:
+            if pred not in req:
+                todo.append(pred)
+
+    return req
+
+
+def make_dist(name, version, **kwargs):
+    """
+    A convenience method for making a dist given just a name and version.
+    """
+    summary = kwargs.pop('summary', 'Placeholder for summary')
+    md = Metadata(**kwargs)
+    md.name = name
+    md.version = version
+    md.summary = summary or 'Placeholder for summary'
+    return Distribution(md)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/index.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/index.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a87cdcf7a19987ad0344b8c5d161027b345e212
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/index.py
@@ -0,0 +1,516 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+import hashlib
+import logging
+import os
+import shutil
+import subprocess
+import tempfile
+try:
+    from threading import Thread
+except ImportError:
+    from dummy_threading import Thread
+
+from . import DistlibException
+from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr,
+                     urlparse, build_opener, string_types)
+from .util import cached_property, zip_dir, ServerProxy
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_INDEX = 'https://pypi.org/pypi'
+DEFAULT_REALM = 'pypi'
+
+class PackageIndex(object):
+    """
+    This class represents a package index compatible with PyPI, the Python
+    Package Index.
+    """
+
+    boundary = b'----------ThIs_Is_tHe_distlib_index_bouNdaRY_$'
+
+    def __init__(self, url=None):
+        """
+        Initialise an instance.
+
+        :param url: The URL of the index. If not specified, the URL for PyPI is
+                    used.
+        """
+        self.url = url or DEFAULT_INDEX
+        self.read_configuration()
+        scheme, netloc, path, params, query, frag = urlparse(self.url)
+        if params or query or frag or scheme not in ('http', 'https'):
+            raise DistlibException('invalid repository: %s' % self.url)
+        self.password_handler = None
+        self.ssl_verifier = None
+        self.gpg = None
+        self.gpg_home = None
+        with open(os.devnull, 'w') as sink:
+            # Use gpg by default rather than gpg2, as gpg2 insists on
+            # prompting for passwords
+            for s in ('gpg', 'gpg2'):
+                try:
+                    rc = subprocess.check_call([s, '--version'], stdout=sink,
+                                               stderr=sink)
+                    if rc == 0:
+                        self.gpg = s
+                        break
+                except OSError:
+                    pass
+
+    def _get_pypirc_command(self):
+        """
+        Get the distutils command for interacting with PyPI configurations.
+        :return: the command.
+        """
+        from distutils.core import Distribution
+        from distutils.config import PyPIRCCommand
+        d = Distribution()
+        return PyPIRCCommand(d)
+
+    def read_configuration(self):
+        """
+        Read the PyPI access configuration as supported by distutils, getting
+        PyPI to do the actual work. This populates ``username``, ``password``,
+        ``realm`` and ``url`` attributes from the configuration.
+        """
+        # get distutils to do the work
+        c = self._get_pypirc_command()
+        c.repository = self.url
+        cfg = c._read_pypirc()
+        self.username = cfg.get('username')
+        self.password = cfg.get('password')
+        self.realm = cfg.get('realm', 'pypi')
+        self.url = cfg.get('repository', self.url)
+
+    def save_configuration(self):
+        """
+        Save the PyPI access configuration. You must have set ``username`` and
+        ``password`` attributes before calling this method.
+
+        Again, distutils is used to do the actual work.
+        """
+        self.check_credentials()
+        # get distutils to do the work
+        c = self._get_pypirc_command()
+        c._store_pypirc(self.username, self.password)
+
+    def check_credentials(self):
+        """
+        Check that ``username`` and ``password`` have been set, and raise an
+        exception if not.
+        """
+        if self.username is None or self.password is None:
+            raise DistlibException('username and password must be set')
+        pm = HTTPPasswordMgr()
+        _, netloc, _, _, _, _ = urlparse(self.url)
+        pm.add_password(self.realm, netloc, self.username, self.password)
+        self.password_handler = HTTPBasicAuthHandler(pm)
+
+    def register(self, metadata):
+        """
+        Register a distribution on PyPI, using the provided metadata.
+
+        :param metadata: A :class:`Metadata` instance defining at least a name
+                         and version number for the distribution to be
+                         registered.
+        :return: The HTTP response received from PyPI upon submission of the
+                request.
+        """
+        self.check_credentials()
+        metadata.validate()
+        d = metadata.todict()
+        d[':action'] = 'verify'
+        request = self.encode_request(d.items(), [])
+        response = self.send_request(request)
+        d[':action'] = 'submit'
+        request = self.encode_request(d.items(), [])
+        return self.send_request(request)
+
+    def _reader(self, name, stream, outbuf):
+        """
+        Thread runner for reading lines of from a subprocess into a buffer.
+
+        :param name: The logical name of the stream (used for logging only).
+        :param stream: The stream to read from. This will typically a pipe
+                       connected to the output stream of a subprocess.
+        :param outbuf: The list to append the read lines to.
+        """
+        while True:
+            s = stream.readline()
+            if not s:
+                break
+            s = s.decode('utf-8').rstrip()
+            outbuf.append(s)
+            logger.debug('%s: %s' % (name, s))
+        stream.close()
+
+    def get_sign_command(self, filename, signer, sign_password,
+                         keystore=None):
+        """
+        Return a suitable command for signing a file.
+
+        :param filename: The pathname to the file to be signed.
+        :param signer: The identifier of the signer of the file.
+        :param sign_password: The passphrase for the signer's
+                              private key used for signing.
+        :param keystore: The path to a directory which contains the keys
+                         used in verification. If not specified, the
+                         instance's ``gpg_home`` attribute is used instead.
+        :return: The signing command as a list suitable to be
+                 passed to :class:`subprocess.Popen`.
+        """
+        cmd = [self.gpg, '--status-fd', '2', '--no-tty']
+        if keystore is None:
+            keystore = self.gpg_home
+        if keystore:
+            cmd.extend(['--homedir', keystore])
+        if sign_password is not None:
+            cmd.extend(['--batch', '--passphrase-fd', '0'])
+        td = tempfile.mkdtemp()
+        sf = os.path.join(td, os.path.basename(filename) + '.asc')
+        cmd.extend(['--detach-sign', '--armor', '--local-user',
+                    signer, '--output', sf, filename])
+        logger.debug('invoking: %s', ' '.join(cmd))
+        return cmd, sf
+
+    def run_command(self, cmd, input_data=None):
+        """
+        Run a command in a child process , passing it any input data specified.
+
+        :param cmd: The command to run.
+        :param input_data: If specified, this must be a byte string containing
+                           data to be sent to the child process.
+        :return: A tuple consisting of the subprocess' exit code, a list of
+                 lines read from the subprocess' ``stdout``, and a list of
+                 lines read from the subprocess' ``stderr``.
+        """
+        kwargs = {
+            'stdout': subprocess.PIPE,
+            'stderr': subprocess.PIPE,
+        }
+        if input_data is not None:
+            kwargs['stdin'] = subprocess.PIPE
+        stdout = []
+        stderr = []
+        p = subprocess.Popen(cmd, **kwargs)
+        # We don't use communicate() here because we may need to
+        # get clever with interacting with the command
+        t1 = Thread(target=self._reader, args=('stdout', p.stdout, stdout))
+        t1.start()
+        t2 = Thread(target=self._reader, args=('stderr', p.stderr, stderr))
+        t2.start()
+        if input_data is not None:
+            p.stdin.write(input_data)
+            p.stdin.close()
+
+        p.wait()
+        t1.join()
+        t2.join()
+        return p.returncode, stdout, stderr
+
+    def sign_file(self, filename, signer, sign_password, keystore=None):
+        """
+        Sign a file.
+
+        :param filename: The pathname to the file to be signed.
+        :param signer: The identifier of the signer of the file.
+        :param sign_password: The passphrase for the signer's
+                              private key used for signing.
+        :param keystore: The path to a directory which contains the keys
+                         used in signing. If not specified, the instance's
+                         ``gpg_home`` attribute is used instead.
+        :return: The absolute pathname of the file where the signature is
+                 stored.
+        """
+        cmd, sig_file = self.get_sign_command(filename, signer, sign_password,
+                                              keystore)
+        rc, stdout, stderr = self.run_command(cmd,
+                                              sign_password.encode('utf-8'))
+        if rc != 0:
+            raise DistlibException('sign command failed with error '
+                                   'code %s' % rc)
+        return sig_file
+
+    def upload_file(self, metadata, filename, signer=None, sign_password=None,
+                    filetype='sdist', pyversion='source', keystore=None):
+        """
+        Upload a release file to the index.
+
+        :param metadata: A :class:`Metadata` instance defining at least a name
+                         and version number for the file to be uploaded.
+        :param filename: The pathname of the file to be uploaded.
+        :param signer: The identifier of the signer of the file.
+        :param sign_password: The passphrase for the signer's
+                              private key used for signing.
+        :param filetype: The type of the file being uploaded. This is the
+                        distutils command which produced that file, e.g.
+                        ``sdist`` or ``bdist_wheel``.
+        :param pyversion: The version of Python which the release relates
+                          to. For code compatible with any Python, this would
+                          be ``source``, otherwise it would be e.g. ``3.2``.
+        :param keystore: The path to a directory which contains the keys
+                         used in signing. If not specified, the instance's
+                         ``gpg_home`` attribute is used instead.
+        :return: The HTTP response received from PyPI upon submission of the
+                request.
+        """
+        self.check_credentials()
+        if not os.path.exists(filename):
+            raise DistlibException('not found: %s' % filename)
+        metadata.validate()
+        d = metadata.todict()
+        sig_file = None
+        if signer:
+            if not self.gpg:
+                logger.warning('no signing program available - not signed')
+            else:
+                sig_file = self.sign_file(filename, signer, sign_password,
+                                          keystore)
+        with open(filename, 'rb') as f:
+            file_data = f.read()
+        md5_digest = hashlib.md5(file_data).hexdigest()
+        sha256_digest = hashlib.sha256(file_data).hexdigest()
+        d.update({
+            ':action': 'file_upload',
+            'protocol_version': '1',
+            'filetype': filetype,
+            'pyversion': pyversion,
+            'md5_digest': md5_digest,
+            'sha256_digest': sha256_digest,
+        })
+        files = [('content', os.path.basename(filename), file_data)]
+        if sig_file:
+            with open(sig_file, 'rb') as f:
+                sig_data = f.read()
+            files.append(('gpg_signature', os.path.basename(sig_file),
+                         sig_data))
+            shutil.rmtree(os.path.dirname(sig_file))
+        request = self.encode_request(d.items(), files)
+        return self.send_request(request)
+
+    def upload_documentation(self, metadata, doc_dir):
+        """
+        Upload documentation to the index.
+
+        :param metadata: A :class:`Metadata` instance defining at least a name
+                         and version number for the documentation to be
+                         uploaded.
+        :param doc_dir: The pathname of the directory which contains the
+                        documentation. This should be the directory that
+                        contains the ``index.html`` for the documentation.
+        :return: The HTTP response received from PyPI upon submission of the
+                request.
+        """
+        self.check_credentials()
+        if not os.path.isdir(doc_dir):
+            raise DistlibException('not a directory: %r' % doc_dir)
+        fn = os.path.join(doc_dir, 'index.html')
+        if not os.path.exists(fn):
+            raise DistlibException('not found: %r' % fn)
+        metadata.validate()
+        name, version = metadata.name, metadata.version
+        zip_data = zip_dir(doc_dir).getvalue()
+        fields = [(':action', 'doc_upload'),
+                  ('name', name), ('version', version)]
+        files = [('content', name, zip_data)]
+        request = self.encode_request(fields, files)
+        return self.send_request(request)
+
+    def get_verify_command(self, signature_filename, data_filename,
+                           keystore=None):
+        """
+        Return a suitable command for verifying a file.
+
+        :param signature_filename: The pathname to the file containing the
+                                   signature.
+        :param data_filename: The pathname to the file containing the
+                              signed data.
+        :param keystore: The path to a directory which contains the keys
+                         used in verification. If not specified, the
+                         instance's ``gpg_home`` attribute is used instead.
+        :return: The verifying command as a list suitable to be
+                 passed to :class:`subprocess.Popen`.
+        """
+        cmd = [self.gpg, '--status-fd', '2', '--no-tty']
+        if keystore is None:
+            keystore = self.gpg_home
+        if keystore:
+            cmd.extend(['--homedir', keystore])
+        cmd.extend(['--verify', signature_filename, data_filename])
+        logger.debug('invoking: %s', ' '.join(cmd))
+        return cmd
+
+    def verify_signature(self, signature_filename, data_filename,
+                         keystore=None):
+        """
+        Verify a signature for a file.
+
+        :param signature_filename: The pathname to the file containing the
+                                   signature.
+        :param data_filename: The pathname to the file containing the
+                              signed data.
+        :param keystore: The path to a directory which contains the keys
+                         used in verification. If not specified, the
+                         instance's ``gpg_home`` attribute is used instead.
+        :return: True if the signature was verified, else False.
+        """
+        if not self.gpg:
+            raise DistlibException('verification unavailable because gpg '
+                                   'unavailable')
+        cmd = self.get_verify_command(signature_filename, data_filename,
+                                      keystore)
+        rc, stdout, stderr = self.run_command(cmd)
+        if rc not in (0, 1):
+            raise DistlibException('verify command failed with error '
+                             'code %s' % rc)
+        return rc == 0
+
+    def download_file(self, url, destfile, digest=None, reporthook=None):
+        """
+        This is a convenience method for downloading a file from an URL.
+        Normally, this will be a file from the index, though currently
+        no check is made for this (i.e. a file can be downloaded from
+        anywhere).
+
+        The method is just like the :func:`urlretrieve` function in the
+        standard library, except that it allows digest computation to be
+        done during download and checking that the downloaded data
+        matched any expected value.
+
+        :param url: The URL of the file to be downloaded (assumed to be
+                    available via an HTTP GET request).
+        :param destfile: The pathname where the downloaded file is to be
+                         saved.
+        :param digest: If specified, this must be a (hasher, value)
+                       tuple, where hasher is the algorithm used (e.g.
+                       ``'md5'``) and ``value`` is the expected value.
+        :param reporthook: The same as for :func:`urlretrieve` in the
+                           standard library.
+        """
+        if digest is None:
+            digester = None
+            logger.debug('No digest specified')
+        else:
+            if isinstance(digest, (list, tuple)):
+                hasher, digest = digest
+            else:
+                hasher = 'md5'
+            digester = getattr(hashlib, hasher)()
+            logger.debug('Digest specified: %s' % digest)
+        # The following code is equivalent to urlretrieve.
+        # We need to do it this way so that we can compute the
+        # digest of the file as we go.
+        with open(destfile, 'wb') as dfp:
+            # addinfourl is not a context manager on 2.x
+            # so we have to use try/finally
+            sfp = self.send_request(Request(url))
+            try:
+                headers = sfp.info()
+                blocksize = 8192
+                size = -1
+                read = 0
+                blocknum = 0
+                if "content-length" in headers:
+                    size = int(headers["Content-Length"])
+                if reporthook:
+                    reporthook(blocknum, blocksize, size)
+                while True:
+                    block = sfp.read(blocksize)
+                    if not block:
+                        break
+                    read += len(block)
+                    dfp.write(block)
+                    if digester:
+                        digester.update(block)
+                    blocknum += 1
+                    if reporthook:
+                        reporthook(blocknum, blocksize, size)
+            finally:
+                sfp.close()
+
+        # check that we got the whole file, if we can
+        if size >= 0 and read < size:
+            raise DistlibException(
+                'retrieval incomplete: got only %d out of %d bytes'
+                % (read, size))
+        # if we have a digest, it must match.
+        if digester:
+            actual = digester.hexdigest()
+            if digest != actual:
+                raise DistlibException('%s digest mismatch for %s: expected '
+                                       '%s, got %s' % (hasher, destfile,
+                                                       digest, actual))
+            logger.debug('Digest verified: %s', digest)
+
+    def send_request(self, req):
+        """
+        Send a standard library :class:`Request` to PyPI and return its
+        response.
+
+        :param req: The request to send.
+        :return: The HTTP response from PyPI (a standard library HTTPResponse).
+        """
+        handlers = []
+        if self.password_handler:
+            handlers.append(self.password_handler)
+        if self.ssl_verifier:
+            handlers.append(self.ssl_verifier)
+        opener = build_opener(*handlers)
+        return opener.open(req)
+
+    def encode_request(self, fields, files):
+        """
+        Encode fields and files for posting to an HTTP server.
+
+        :param fields: The fields to send as a list of (fieldname, value)
+                       tuples.
+        :param files: The files to send as a list of (fieldname, filename,
+                      file_bytes) tuple.
+        """
+        # Adapted from packaging, which in turn was adapted from
+        # http://code.activestate.com/recipes/146306
+
+        parts = []
+        boundary = self.boundary
+        for k, values in fields:
+            if not isinstance(values, (list, tuple)):
+                values = [values]
+
+            for v in values:
+                parts.extend((
+                    b'--' + boundary,
+                    ('Content-Disposition: form-data; name="%s"' %
+                     k).encode('utf-8'),
+                    b'',
+                    v.encode('utf-8')))
+        for key, filename, value in files:
+            parts.extend((
+                b'--' + boundary,
+                ('Content-Disposition: form-data; name="%s"; filename="%s"' %
+                 (key, filename)).encode('utf-8'),
+                b'',
+                value))
+
+        parts.extend((b'--' + boundary + b'--', b''))
+
+        body = b'\r\n'.join(parts)
+        ct = b'multipart/form-data; boundary=' + boundary
+        headers = {
+            'Content-type': ct,
+            'Content-length': str(len(body))
+        }
+        return Request(self.url, body, headers)
+
+    def search(self, terms, operator=None):
+        if isinstance(terms, string_types):
+            terms = {'name': terms}
+        rpc_proxy = ServerProxy(self.url, timeout=3.0)
+        try:
+            return rpc_proxy.search(terms, operator or 'and')
+        finally:
+            rpc_proxy('close')()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/locators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/locators.py
new file mode 100644
index 0000000000000000000000000000000000000000..12a1d06351e50b52c8672974d4a9053b7641abaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/locators.py
@@ -0,0 +1,1302 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2015 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+
+import gzip
+from io import BytesIO
+import json
+import logging
+import os
+import posixpath
+import re
+try:
+    import threading
+except ImportError:  # pragma: no cover
+    import dummy_threading as threading
+import zlib
+
+from . import DistlibException
+from .compat import (urljoin, urlparse, urlunparse, url2pathname, pathname2url,
+                     queue, quote, unescape, string_types, build_opener,
+                     HTTPRedirectHandler as BaseRedirectHandler, text_type,
+                     Request, HTTPError, URLError)
+from .database import Distribution, DistributionPath, make_dist
+from .metadata import Metadata, MetadataInvalidError
+from .util import (cached_property, parse_credentials, ensure_slash,
+                   split_filename, get_project_data, parse_requirement,
+                   parse_name_and_version, ServerProxy, normalize_name)
+from .version import get_scheme, UnsupportedVersionError
+from .wheel import Wheel, is_compatible
+
+logger = logging.getLogger(__name__)
+
+HASHER_HASH = re.compile(r'^(\w+)=([a-f0-9]+)')
+CHARSET = re.compile(r';\s*charset\s*=\s*(.*)\s*$', re.I)
+HTML_CONTENT_TYPE = re.compile('text/html|application/x(ht)?ml')
+DEFAULT_INDEX = 'https://pypi.org/pypi'
+
+def get_all_distribution_names(url=None):
+    """
+    Return all distribution names known by an index.
+    :param url: The URL of the index.
+    :return: A list of all known distribution names.
+    """
+    if url is None:
+        url = DEFAULT_INDEX
+    client = ServerProxy(url, timeout=3.0)
+    try:
+        return client.list_packages()
+    finally:
+        client('close')()
+
+class RedirectHandler(BaseRedirectHandler):
+    """
+    A class to work around a bug in some Python 3.2.x releases.
+    """
+    # There's a bug in the base version for some 3.2.x
+    # (e.g. 3.2.2 on Ubuntu Oneiric). If a Location header
+    # returns e.g. /abc, it bails because it says the scheme ''
+    # is bogus, when actually it should use the request's
+    # URL for the scheme. See Python issue #13696.
+    def http_error_302(self, req, fp, code, msg, headers):
+        # Some servers (incorrectly) return multiple Location headers
+        # (so probably same goes for URI).  Use first header.
+        newurl = None
+        for key in ('location', 'uri'):
+            if key in headers:
+                newurl = headers[key]
+                break
+        if newurl is None:  # pragma: no cover
+            return
+        urlparts = urlparse(newurl)
+        if urlparts.scheme == '':
+            newurl = urljoin(req.get_full_url(), newurl)
+            if hasattr(headers, 'replace_header'):
+                headers.replace_header(key, newurl)
+            else:
+                headers[key] = newurl
+        return BaseRedirectHandler.http_error_302(self, req, fp, code, msg,
+                                                  headers)
+
+    http_error_301 = http_error_303 = http_error_307 = http_error_302
+
+class Locator(object):
+    """
+    A base class for locators - things that locate distributions.
+    """
+    source_extensions = ('.tar.gz', '.tar.bz2', '.tar', '.zip', '.tgz', '.tbz')
+    binary_extensions = ('.egg', '.exe', '.whl')
+    excluded_extensions = ('.pdf',)
+
+    # A list of tags indicating which wheels you want to match. The default
+    # value of None matches against the tags compatible with the running
+    # Python. If you want to match other values, set wheel_tags on a locator
+    # instance to a list of tuples (pyver, abi, arch) which you want to match.
+    wheel_tags = None
+
+    downloadable_extensions = source_extensions + ('.whl',)
+
+    def __init__(self, scheme='default'):
+        """
+        Initialise an instance.
+        :param scheme: Because locators look for most recent versions, they
+                       need to know the version scheme to use. This specifies
+                       the current PEP-recommended scheme - use ``'legacy'``
+                       if you need to support existing distributions on PyPI.
+        """
+        self._cache = {}
+        self.scheme = scheme
+        # Because of bugs in some of the handlers on some of the platforms,
+        # we use our own opener rather than just using urlopen.
+        self.opener = build_opener(RedirectHandler())
+        # If get_project() is called from locate(), the matcher instance
+        # is set from the requirement passed to locate(). See issue #18 for
+        # why this can be useful to know.
+        self.matcher = None
+        self.errors = queue.Queue()
+
+    def get_errors(self):
+        """
+        Return any errors which have occurred.
+        """
+        result = []
+        while not self.errors.empty():  # pragma: no cover
+            try:
+                e = self.errors.get(False)
+                result.append(e)
+            except self.errors.Empty:
+                continue
+            self.errors.task_done()
+        return result
+
+    def clear_errors(self):
+        """
+        Clear any errors which may have been logged.
+        """
+        # Just get the errors and throw them away
+        self.get_errors()
+
+    def clear_cache(self):
+        self._cache.clear()
+
+    def _get_scheme(self):
+        return self._scheme
+
+    def _set_scheme(self, value):
+        self._scheme = value
+
+    scheme = property(_get_scheme, _set_scheme)
+
+    def _get_project(self, name):
+        """
+        For a given project, get a dictionary mapping available versions to Distribution
+        instances.
+
+        This should be implemented in subclasses.
+
+        If called from a locate() request, self.matcher will be set to a
+        matcher for the requirement to satisfy, otherwise it will be None.
+        """
+        raise NotImplementedError('Please implement in the subclass')
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        raise NotImplementedError('Please implement in the subclass')
+
+    def get_project(self, name):
+        """
+        For a given project, get a dictionary mapping available versions to Distribution
+        instances.
+
+        This calls _get_project to do all the work, and just implements a caching layer on top.
+        """
+        if self._cache is None:  # pragma: no cover
+            result = self._get_project(name)
+        elif name in self._cache:
+            result = self._cache[name]
+        else:
+            self.clear_errors()
+            result = self._get_project(name)
+            self._cache[name] = result
+        return result
+
+    def score_url(self, url):
+        """
+        Give an url a score which can be used to choose preferred URLs
+        for a given project release.
+        """
+        t = urlparse(url)
+        basename = posixpath.basename(t.path)
+        compatible = True
+        is_wheel = basename.endswith('.whl')
+        is_downloadable = basename.endswith(self.downloadable_extensions)
+        if is_wheel:
+            compatible = is_compatible(Wheel(basename), self.wheel_tags)
+        return (t.scheme == 'https', 'pypi.org' in t.netloc,
+                is_downloadable, is_wheel, compatible, basename)
+
+    def prefer_url(self, url1, url2):
+        """
+        Choose one of two URLs where both are candidates for distribution
+        archives for the same version of a distribution (for example,
+        .tar.gz vs. zip).
+
+        The current implementation favours https:// URLs over http://, archives
+        from PyPI over those from other locations, wheel compatibility (if a
+        wheel) and then the archive name.
+        """
+        result = url2
+        if url1:
+            s1 = self.score_url(url1)
+            s2 = self.score_url(url2)
+            if s1 > s2:
+                result = url1
+            if result != url2:
+                logger.debug('Not replacing %r with %r', url1, url2)
+            else:
+                logger.debug('Replacing %r with %r', url1, url2)
+        return result
+
+    def split_filename(self, filename, project_name):
+        """
+        Attempt to split a filename in project name, version and Python version.
+        """
+        return split_filename(filename, project_name)
+
+    def convert_url_to_download_info(self, url, project_name):
+        """
+        See if a URL is a candidate for a download URL for a project (the URL
+        has typically been scraped from an HTML page).
+
+        If it is, a dictionary is returned with keys "name", "version",
+        "filename" and "url"; otherwise, None is returned.
+        """
+        def same_project(name1, name2):
+            return normalize_name(name1) == normalize_name(name2)
+
+        result = None
+        scheme, netloc, path, params, query, frag = urlparse(url)
+        if frag.lower().startswith('egg='):  # pragma: no cover
+            logger.debug('%s: version hint in fragment: %r',
+                         project_name, frag)
+        m = HASHER_HASH.match(frag)
+        if m:
+            algo, digest = m.groups()
+        else:
+            algo, digest = None, None
+        origpath = path
+        if path and path[-1] == '/':  # pragma: no cover
+            path = path[:-1]
+        if path.endswith('.whl'):
+            try:
+                wheel = Wheel(path)
+                if not is_compatible(wheel, self.wheel_tags):
+                    logger.debug('Wheel not compatible: %s', path)
+                else:
+                    if project_name is None:
+                        include = True
+                    else:
+                        include = same_project(wheel.name, project_name)
+                    if include:
+                        result = {
+                            'name': wheel.name,
+                            'version': wheel.version,
+                            'filename': wheel.filename,
+                            'url': urlunparse((scheme, netloc, origpath,
+                                               params, query, '')),
+                            'python-version': ', '.join(
+                                ['.'.join(list(v[2:])) for v in wheel.pyver]),
+                        }
+            except Exception as e:  # pragma: no cover
+                logger.warning('invalid path for wheel: %s', path)
+        elif not path.endswith(self.downloadable_extensions):  # pragma: no cover
+            logger.debug('Not downloadable: %s', path)
+        else:  # downloadable extension
+            path = filename = posixpath.basename(path)
+            for ext in self.downloadable_extensions:
+                if path.endswith(ext):
+                    path = path[:-len(ext)]
+                    t = self.split_filename(path, project_name)
+                    if not t:  # pragma: no cover
+                        logger.debug('No match for project/version: %s', path)
+                    else:
+                        name, version, pyver = t
+                        if not project_name or same_project(project_name, name):
+                            result = {
+                                'name': name,
+                                'version': version,
+                                'filename': filename,
+                                'url': urlunparse((scheme, netloc, origpath,
+                                                   params, query, '')),
+                                #'packagetype': 'sdist',
+                            }
+                            if pyver:  # pragma: no cover
+                                result['python-version'] = pyver
+                    break
+        if result and algo:
+            result['%s_digest' % algo] = digest
+        return result
+
+    def _get_digest(self, info):
+        """
+        Get a digest from a dictionary by looking at a "digests" dictionary
+        or keys of the form 'algo_digest'.
+
+        Returns a 2-tuple (algo, digest) if found, else None. Currently
+        looks only for SHA256, then MD5.
+        """
+        result = None
+        if 'digests' in info:
+            digests = info['digests']
+            for algo in ('sha256', 'md5'):
+                if algo in digests:
+                    result = (algo, digests[algo])
+                    break
+        if not result:
+            for algo in ('sha256', 'md5'):
+                key = '%s_digest' % algo
+                if key in info:
+                    result = (algo, info[key])
+                    break
+        return result
+
+    def _update_version_data(self, result, info):
+        """
+        Update a result dictionary (the final result from _get_project) with a
+        dictionary for a specific version, which typically holds information
+        gleaned from a filename or URL for an archive for the distribution.
+        """
+        name = info.pop('name')
+        version = info.pop('version')
+        if version in result:
+            dist = result[version]
+            md = dist.metadata
+        else:
+            dist = make_dist(name, version, scheme=self.scheme)
+            md = dist.metadata
+        dist.digest = digest = self._get_digest(info)
+        url = info['url']
+        result['digests'][url] = digest
+        if md.source_url != info['url']:
+            md.source_url = self.prefer_url(md.source_url, url)
+            result['urls'].setdefault(version, set()).add(url)
+        dist.locator = self
+        result[version] = dist
+
+    def locate(self, requirement, prereleases=False):
+        """
+        Find the most recent distribution which matches the given
+        requirement.
+
+        :param requirement: A requirement of the form 'foo (1.0)' or perhaps
+                            'foo (>= 1.0, < 2.0, != 1.3)'
+        :param prereleases: If ``True``, allow pre-release versions
+                            to be located. Otherwise, pre-release versions
+                            are not returned.
+        :return: A :class:`Distribution` instance, or ``None`` if no such
+                 distribution could be located.
+        """
+        result = None
+        r = parse_requirement(requirement)
+        if r is None:  # pragma: no cover
+            raise DistlibException('Not a valid requirement: %r' % requirement)
+        scheme = get_scheme(self.scheme)
+        self.matcher = matcher = scheme.matcher(r.requirement)
+        logger.debug('matcher: %s (%s)', matcher, type(matcher).__name__)
+        versions = self.get_project(r.name)
+        if len(versions) > 2:   # urls and digests keys are present
+            # sometimes, versions are invalid
+            slist = []
+            vcls = matcher.version_class
+            for k in versions:
+                if k in ('urls', 'digests'):
+                    continue
+                try:
+                    if not matcher.match(k):
+                        logger.debug('%s did not match %r', matcher, k)
+                    else:
+                        if prereleases or not vcls(k).is_prerelease:
+                            slist.append(k)
+                        else:
+                            logger.debug('skipping pre-release '
+                                         'version %s of %s', k, matcher.name)
+                except Exception:  # pragma: no cover
+                    logger.warning('error matching %s with %r', matcher, k)
+                    pass # slist.append(k)
+            if len(slist) > 1:
+                slist = sorted(slist, key=scheme.key)
+            if slist:
+                logger.debug('sorted list: %s', slist)
+                version = slist[-1]
+                result = versions[version]
+        if result:
+            if r.extras:
+                result.extras = r.extras
+            result.download_urls = versions.get('urls', {}).get(version, set())
+            d = {}
+            sd = versions.get('digests', {})
+            for url in result.download_urls:
+                if url in sd:  # pragma: no cover
+                    d[url] = sd[url]
+            result.digests = d
+        self.matcher = None
+        return result
+
+
+class PyPIRPCLocator(Locator):
+    """
+    This locator uses XML-RPC to locate distributions. It therefore
+    cannot be used with simple mirrors (that only mirror file content).
+    """
+    def __init__(self, url, **kwargs):
+        """
+        Initialise an instance.
+
+        :param url: The URL to use for XML-RPC.
+        :param kwargs: Passed to the superclass constructor.
+        """
+        super(PyPIRPCLocator, self).__init__(**kwargs)
+        self.base_url = url
+        self.client = ServerProxy(url, timeout=3.0)
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        return set(self.client.list_packages())
+
+    def _get_project(self, name):
+        result = {'urls': {}, 'digests': {}}
+        versions = self.client.package_releases(name, True)
+        for v in versions:
+            urls = self.client.release_urls(name, v)
+            data = self.client.release_data(name, v)
+            metadata = Metadata(scheme=self.scheme)
+            metadata.name = data['name']
+            metadata.version = data['version']
+            metadata.license = data.get('license')
+            metadata.keywords = data.get('keywords', [])
+            metadata.summary = data.get('summary')
+            dist = Distribution(metadata)
+            if urls:
+                info = urls[0]
+                metadata.source_url = info['url']
+                dist.digest = self._get_digest(info)
+                dist.locator = self
+                result[v] = dist
+                for info in urls:
+                    url = info['url']
+                    digest = self._get_digest(info)
+                    result['urls'].setdefault(v, set()).add(url)
+                    result['digests'][url] = digest
+        return result
+
+class PyPIJSONLocator(Locator):
+    """
+    This locator uses PyPI's JSON interface. It's very limited in functionality
+    and probably not worth using.
+    """
+    def __init__(self, url, **kwargs):
+        super(PyPIJSONLocator, self).__init__(**kwargs)
+        self.base_url = ensure_slash(url)
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        raise NotImplementedError('Not available from this locator')
+
+    def _get_project(self, name):
+        result = {'urls': {}, 'digests': {}}
+        url = urljoin(self.base_url, '%s/json' % quote(name))
+        try:
+            resp = self.opener.open(url)
+            data = resp.read().decode() # for now
+            d = json.loads(data)
+            md = Metadata(scheme=self.scheme)
+            data = d['info']
+            md.name = data['name']
+            md.version = data['version']
+            md.license = data.get('license')
+            md.keywords = data.get('keywords', [])
+            md.summary = data.get('summary')
+            dist = Distribution(md)
+            dist.locator = self
+            urls = d['urls']
+            result[md.version] = dist
+            for info in d['urls']:
+                url = info['url']
+                dist.download_urls.add(url)
+                dist.digests[url] = self._get_digest(info)
+                result['urls'].setdefault(md.version, set()).add(url)
+                result['digests'][url] = self._get_digest(info)
+            # Now get other releases
+            for version, infos in d['releases'].items():
+                if version == md.version:
+                    continue    # already done
+                omd = Metadata(scheme=self.scheme)
+                omd.name = md.name
+                omd.version = version
+                odist = Distribution(omd)
+                odist.locator = self
+                result[version] = odist
+                for info in infos:
+                    url = info['url']
+                    odist.download_urls.add(url)
+                    odist.digests[url] = self._get_digest(info)
+                    result['urls'].setdefault(version, set()).add(url)
+                    result['digests'][url] = self._get_digest(info)
+#            for info in urls:
+#                md.source_url = info['url']
+#                dist.digest = self._get_digest(info)
+#                dist.locator = self
+#                for info in urls:
+#                    url = info['url']
+#                    result['urls'].setdefault(md.version, set()).add(url)
+#                    result['digests'][url] = self._get_digest(info)
+        except Exception as e:
+            self.errors.put(text_type(e))
+            logger.exception('JSON fetch failed: %s', e)
+        return result
+
+
+class Page(object):
+    """
+    This class represents a scraped HTML page.
+    """
+    # The following slightly hairy-looking regex just looks for the contents of
+    # an anchor link, which has an attribute "href" either immediately preceded
+    # or immediately followed by a "rel" attribute. The attribute values can be
+    # declared with double quotes, single quotes or no quotes - which leads to
+    # the length of the expression.
+    _href = re.compile("""
+(rel\\s*=\\s*(?:"(?P<rel1>[^"]*)"|'(?P<rel2>[^']*)'|(?P<rel3>[^>\\s\n]*))\\s+)?
+href\\s*=\\s*(?:"(?P<url1>[^"]*)"|'(?P<url2>[^']*)'|(?P<url3>[^>\\s\n]*))
+(\\s+rel\\s*=\\s*(?:"(?P<rel4>[^"]*)"|'(?P<rel5>[^']*)'|(?P<rel6>[^>\\s\n]*)))?
+""", re.I | re.S | re.X)
+    _base = re.compile(r"""<base\s+href\s*=\s*['"]?([^'">]+)""", re.I | re.S)
+
+    def __init__(self, data, url):
+        """
+        Initialise an instance with the Unicode page contents and the URL they
+        came from.
+        """
+        self.data = data
+        self.base_url = self.url = url
+        m = self._base.search(self.data)
+        if m:
+            self.base_url = m.group(1)
+
+    _clean_re = re.compile(r'[^a-z0-9$&+,/:;=?@.#%_\\|-]', re.I)
+
+    @cached_property
+    def links(self):
+        """
+        Return the URLs of all the links on a page together with information
+        about their "rel" attribute, for determining which ones to treat as
+        downloads and which ones to queue for further scraping.
+        """
+        def clean(url):
+            "Tidy up an URL."
+            scheme, netloc, path, params, query, frag = urlparse(url)
+            return urlunparse((scheme, netloc, quote(path),
+                               params, query, frag))
+
+        result = set()
+        for match in self._href.finditer(self.data):
+            d = match.groupdict('')
+            rel = (d['rel1'] or d['rel2'] or d['rel3'] or
+                   d['rel4'] or d['rel5'] or d['rel6'])
+            url = d['url1'] or d['url2'] or d['url3']
+            url = urljoin(self.base_url, url)
+            url = unescape(url)
+            url = self._clean_re.sub(lambda m: '%%%2x' % ord(m.group(0)), url)
+            result.add((url, rel))
+        # We sort the result, hoping to bring the most recent versions
+        # to the front
+        result = sorted(result, key=lambda t: t[0], reverse=True)
+        return result
+
+
+class SimpleScrapingLocator(Locator):
+    """
+    A locator which scrapes HTML pages to locate downloads for a distribution.
+    This runs multiple threads to do the I/O; performance is at least as good
+    as pip's PackageFinder, which works in an analogous fashion.
+    """
+
+    # These are used to deal with various Content-Encoding schemes.
+    decoders = {
+        'deflate': zlib.decompress,
+        'gzip': lambda b: gzip.GzipFile(fileobj=BytesIO(d)).read(),
+        'none': lambda b: b,
+    }
+
+    def __init__(self, url, timeout=None, num_workers=10, **kwargs):
+        """
+        Initialise an instance.
+        :param url: The root URL to use for scraping.
+        :param timeout: The timeout, in seconds, to be applied to requests.
+                        This defaults to ``None`` (no timeout specified).
+        :param num_workers: The number of worker threads you want to do I/O,
+                            This defaults to 10.
+        :param kwargs: Passed to the superclass.
+        """
+        super(SimpleScrapingLocator, self).__init__(**kwargs)
+        self.base_url = ensure_slash(url)
+        self.timeout = timeout
+        self._page_cache = {}
+        self._seen = set()
+        self._to_fetch = queue.Queue()
+        self._bad_hosts = set()
+        self.skip_externals = False
+        self.num_workers = num_workers
+        self._lock = threading.RLock()
+        # See issue #45: we need to be resilient when the locator is used
+        # in a thread, e.g. with concurrent.futures. We can't use self._lock
+        # as it is for coordinating our internal threads - the ones created
+        # in _prepare_threads.
+        self._gplock = threading.RLock()
+        self.platform_check = False  # See issue #112
+
+    def _prepare_threads(self):
+        """
+        Threads are created only when get_project is called, and terminate
+        before it returns. They are there primarily to parallelise I/O (i.e.
+        fetching web pages).
+        """
+        self._threads = []
+        for i in range(self.num_workers):
+            t = threading.Thread(target=self._fetch)
+            t.setDaemon(True)
+            t.start()
+            self._threads.append(t)
+
+    def _wait_threads(self):
+        """
+        Tell all the threads to terminate (by sending a sentinel value) and
+        wait for them to do so.
+        """
+        # Note that you need two loops, since you can't say which
+        # thread will get each sentinel
+        for t in self._threads:
+            self._to_fetch.put(None)    # sentinel
+        for t in self._threads:
+            t.join()
+        self._threads = []
+
+    def _get_project(self, name):
+        result = {'urls': {}, 'digests': {}}
+        with self._gplock:
+            self.result = result
+            self.project_name = name
+            url = urljoin(self.base_url, '%s/' % quote(name))
+            self._seen.clear()
+            self._page_cache.clear()
+            self._prepare_threads()
+            try:
+                logger.debug('Queueing %s', url)
+                self._to_fetch.put(url)
+                self._to_fetch.join()
+            finally:
+                self._wait_threads()
+            del self.result
+        return result
+
+    platform_dependent = re.compile(r'\b(linux_(i\d86|x86_64|arm\w+)|'
+                                    r'win(32|_amd64)|macosx_?\d+)\b', re.I)
+
+    def _is_platform_dependent(self, url):
+        """
+        Does an URL refer to a platform-specific download?
+        """
+        return self.platform_dependent.search(url)
+
+    def _process_download(self, url):
+        """
+        See if an URL is a suitable download for a project.
+
+        If it is, register information in the result dictionary (for
+        _get_project) about the specific version it's for.
+
+        Note that the return value isn't actually used other than as a boolean
+        value.
+        """
+        if self.platform_check and self._is_platform_dependent(url):
+            info = None
+        else:
+            info = self.convert_url_to_download_info(url, self.project_name)
+        logger.debug('process_download: %s -> %s', url, info)
+        if info:
+            with self._lock:    # needed because self.result is shared
+                self._update_version_data(self.result, info)
+        return info
+
+    def _should_queue(self, link, referrer, rel):
+        """
+        Determine whether a link URL from a referring page and with a
+        particular "rel" attribute should be queued for scraping.
+        """
+        scheme, netloc, path, _, _, _ = urlparse(link)
+        if path.endswith(self.source_extensions + self.binary_extensions +
+                         self.excluded_extensions):
+            result = False
+        elif self.skip_externals and not link.startswith(self.base_url):
+            result = False
+        elif not referrer.startswith(self.base_url):
+            result = False
+        elif rel not in ('homepage', 'download'):
+            result = False
+        elif scheme not in ('http', 'https', 'ftp'):
+            result = False
+        elif self._is_platform_dependent(link):
+            result = False
+        else:
+            host = netloc.split(':', 1)[0]
+            if host.lower() == 'localhost':
+                result = False
+            else:
+                result = True
+        logger.debug('should_queue: %s (%s) from %s -> %s', link, rel,
+                     referrer, result)
+        return result
+
+    def _fetch(self):
+        """
+        Get a URL to fetch from the work queue, get the HTML page, examine its
+        links for download candidates and candidates for further scraping.
+
+        This is a handy method to run in a thread.
+        """
+        while True:
+            url = self._to_fetch.get()
+            try:
+                if url:
+                    page = self.get_page(url)
+                    if page is None:    # e.g. after an error
+                        continue
+                    for link, rel in page.links:
+                        if link not in self._seen:
+                            try:
+                                self._seen.add(link)
+                                if (not self._process_download(link) and
+                                    self._should_queue(link, url, rel)):
+                                    logger.debug('Queueing %s from %s', link, url)
+                                    self._to_fetch.put(link)
+                            except MetadataInvalidError:  # e.g. invalid versions
+                                pass
+            except Exception as e:  # pragma: no cover
+                self.errors.put(text_type(e))
+            finally:
+                # always do this, to avoid hangs :-)
+                self._to_fetch.task_done()
+            if not url:
+                #logger.debug('Sentinel seen, quitting.')
+                break
+
+    def get_page(self, url):
+        """
+        Get the HTML for an URL, possibly from an in-memory cache.
+
+        XXX TODO Note: this cache is never actually cleared. It's assumed that
+        the data won't get stale over the lifetime of a locator instance (not
+        necessarily true for the default_locator).
+        """
+        # http://peak.telecommunity.com/DevCenter/EasyInstall#package-index-api
+        scheme, netloc, path, _, _, _ = urlparse(url)
+        if scheme == 'file' and os.path.isdir(url2pathname(path)):
+            url = urljoin(ensure_slash(url), 'index.html')
+
+        if url in self._page_cache:
+            result = self._page_cache[url]
+            logger.debug('Returning %s from cache: %s', url, result)
+        else:
+            host = netloc.split(':', 1)[0]
+            result = None
+            if host in self._bad_hosts:
+                logger.debug('Skipping %s due to bad host %s', url, host)
+            else:
+                req = Request(url, headers={'Accept-encoding': 'identity'})
+                try:
+                    logger.debug('Fetching %s', url)
+                    resp = self.opener.open(req, timeout=self.timeout)
+                    logger.debug('Fetched %s', url)
+                    headers = resp.info()
+                    content_type = headers.get('Content-Type', '')
+                    if HTML_CONTENT_TYPE.match(content_type):
+                        final_url = resp.geturl()
+                        data = resp.read()
+                        encoding = headers.get('Content-Encoding')
+                        if encoding:
+                            decoder = self.decoders[encoding]   # fail if not found
+                            data = decoder(data)
+                        encoding = 'utf-8'
+                        m = CHARSET.search(content_type)
+                        if m:
+                            encoding = m.group(1)
+                        try:
+                            data = data.decode(encoding)
+                        except UnicodeError:  # pragma: no cover
+                            data = data.decode('latin-1')    # fallback
+                        result = Page(data, final_url)
+                        self._page_cache[final_url] = result
+                except HTTPError as e:
+                    if e.code != 404:
+                        logger.exception('Fetch failed: %s: %s', url, e)
+                except URLError as e:  # pragma: no cover
+                    logger.exception('Fetch failed: %s: %s', url, e)
+                    with self._lock:
+                        self._bad_hosts.add(host)
+                except Exception as e:  # pragma: no cover
+                    logger.exception('Fetch failed: %s: %s', url, e)
+                finally:
+                    self._page_cache[url] = result   # even if None (failure)
+        return result
+
+    _distname_re = re.compile('<a href=[^>]*>([^<]+)<')
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        result = set()
+        page = self.get_page(self.base_url)
+        if not page:
+            raise DistlibException('Unable to get %s' % self.base_url)
+        for match in self._distname_re.finditer(page.data):
+            result.add(match.group(1))
+        return result
+
+class DirectoryLocator(Locator):
+    """
+    This class locates distributions in a directory tree.
+    """
+
+    def __init__(self, path, **kwargs):
+        """
+        Initialise an instance.
+        :param path: The root of the directory tree to search.
+        :param kwargs: Passed to the superclass constructor,
+                       except for:
+                       * recursive - if True (the default), subdirectories are
+                         recursed into. If False, only the top-level directory
+                         is searched,
+        """
+        self.recursive = kwargs.pop('recursive', True)
+        super(DirectoryLocator, self).__init__(**kwargs)
+        path = os.path.abspath(path)
+        if not os.path.isdir(path):  # pragma: no cover
+            raise DistlibException('Not a directory: %r' % path)
+        self.base_dir = path
+
+    def should_include(self, filename, parent):
+        """
+        Should a filename be considered as a candidate for a distribution
+        archive? As well as the filename, the directory which contains it
+        is provided, though not used by the current implementation.
+        """
+        return filename.endswith(self.downloadable_extensions)
+
+    def _get_project(self, name):
+        result = {'urls': {}, 'digests': {}}
+        for root, dirs, files in os.walk(self.base_dir):
+            for fn in files:
+                if self.should_include(fn, root):
+                    fn = os.path.join(root, fn)
+                    url = urlunparse(('file', '',
+                                      pathname2url(os.path.abspath(fn)),
+                                      '', '', ''))
+                    info = self.convert_url_to_download_info(url, name)
+                    if info:
+                        self._update_version_data(result, info)
+            if not self.recursive:
+                break
+        return result
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        result = set()
+        for root, dirs, files in os.walk(self.base_dir):
+            for fn in files:
+                if self.should_include(fn, root):
+                    fn = os.path.join(root, fn)
+                    url = urlunparse(('file', '',
+                                      pathname2url(os.path.abspath(fn)),
+                                      '', '', ''))
+                    info = self.convert_url_to_download_info(url, None)
+                    if info:
+                        result.add(info['name'])
+            if not self.recursive:
+                break
+        return result
+
+class JSONLocator(Locator):
+    """
+    This locator uses special extended metadata (not available on PyPI) and is
+    the basis of performant dependency resolution in distlib. Other locators
+    require archive downloads before dependencies can be determined! As you
+    might imagine, that can be slow.
+    """
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        raise NotImplementedError('Not available from this locator')
+
+    def _get_project(self, name):
+        result = {'urls': {}, 'digests': {}}
+        data = get_project_data(name)
+        if data:
+            for info in data.get('files', []):
+                if info['ptype'] != 'sdist' or info['pyversion'] != 'source':
+                    continue
+                # We don't store summary in project metadata as it makes
+                # the data bigger for no benefit during dependency
+                # resolution
+                dist = make_dist(data['name'], info['version'],
+                                 summary=data.get('summary',
+                                                  'Placeholder for summary'),
+                                 scheme=self.scheme)
+                md = dist.metadata
+                md.source_url = info['url']
+                # TODO SHA256 digest
+                if 'digest' in info and info['digest']:
+                    dist.digest = ('md5', info['digest'])
+                md.dependencies = info.get('requirements', {})
+                dist.exports = info.get('exports', {})
+                result[dist.version] = dist
+                result['urls'].setdefault(dist.version, set()).add(info['url'])
+        return result
+
+class DistPathLocator(Locator):
+    """
+    This locator finds installed distributions in a path. It can be useful for
+    adding to an :class:`AggregatingLocator`.
+    """
+    def __init__(self, distpath, **kwargs):
+        """
+        Initialise an instance.
+
+        :param distpath: A :class:`DistributionPath` instance to search.
+        """
+        super(DistPathLocator, self).__init__(**kwargs)
+        assert isinstance(distpath, DistributionPath)
+        self.distpath = distpath
+
+    def _get_project(self, name):
+        dist = self.distpath.get_distribution(name)
+        if dist is None:
+            result = {'urls': {}, 'digests': {}}
+        else:
+            result = {
+                dist.version: dist,
+                'urls': {dist.version: set([dist.source_url])},
+                'digests': {dist.version: set([None])}
+            }
+        return result
+
+
+class AggregatingLocator(Locator):
+    """
+    This class allows you to chain and/or merge a list of locators.
+    """
+    def __init__(self, *locators, **kwargs):
+        """
+        Initialise an instance.
+
+        :param locators: The list of locators to search.
+        :param kwargs: Passed to the superclass constructor,
+                       except for:
+                       * merge - if False (the default), the first successful
+                         search from any of the locators is returned. If True,
+                         the results from all locators are merged (this can be
+                         slow).
+        """
+        self.merge = kwargs.pop('merge', False)
+        self.locators = locators
+        super(AggregatingLocator, self).__init__(**kwargs)
+
+    def clear_cache(self):
+        super(AggregatingLocator, self).clear_cache()
+        for locator in self.locators:
+            locator.clear_cache()
+
+    def _set_scheme(self, value):
+        self._scheme = value
+        for locator in self.locators:
+            locator.scheme = value
+
+    scheme = property(Locator.scheme.fget, _set_scheme)
+
+    def _get_project(self, name):
+        result = {}
+        for locator in self.locators:
+            d = locator.get_project(name)
+            if d:
+                if self.merge:
+                    files = result.get('urls', {})
+                    digests = result.get('digests', {})
+                    # next line could overwrite result['urls'], result['digests']
+                    result.update(d)
+                    df = result.get('urls')
+                    if files and df:
+                        for k, v in files.items():
+                            if k in df:
+                                df[k] |= v
+                            else:
+                                df[k] = v
+                    dd = result.get('digests')
+                    if digests and dd:
+                        dd.update(digests)
+                else:
+                    # See issue #18. If any dists are found and we're looking
+                    # for specific constraints, we only return something if
+                    # a match is found. For example, if a DirectoryLocator
+                    # returns just foo (1.0) while we're looking for
+                    # foo (>= 2.0), we'll pretend there was nothing there so
+                    # that subsequent locators can be queried. Otherwise we
+                    # would just return foo (1.0) which would then lead to a
+                    # failure to find foo (>= 2.0), because other locators
+                    # weren't searched. Note that this only matters when
+                    # merge=False.
+                    if self.matcher is None:
+                        found = True
+                    else:
+                        found = False
+                        for k in d:
+                            if self.matcher.match(k):
+                                found = True
+                                break
+                    if found:
+                        result = d
+                        break
+        return result
+
+    def get_distribution_names(self):
+        """
+        Return all the distribution names known to this locator.
+        """
+        result = set()
+        for locator in self.locators:
+            try:
+                result |= locator.get_distribution_names()
+            except NotImplementedError:
+                pass
+        return result
+
+
+# We use a legacy scheme simply because most of the dists on PyPI use legacy
+# versions which don't conform to PEP 426 / PEP 440.
+default_locator = AggregatingLocator(
+                    JSONLocator(),
+                    SimpleScrapingLocator('https://pypi.org/simple/',
+                                          timeout=3.0),
+                    scheme='legacy')
+
+locate = default_locator.locate
+
+NAME_VERSION_RE = re.compile(r'(?P<name>[\w-]+)\s*'
+                             r'\(\s*(==\s*)?(?P<ver>[^)]+)\)$')
+
+class DependencyFinder(object):
+    """
+    Locate dependencies for distributions.
+    """
+
+    def __init__(self, locator=None):
+        """
+        Initialise an instance, using the specified locator
+        to locate distributions.
+        """
+        self.locator = locator or default_locator
+        self.scheme = get_scheme(self.locator.scheme)
+
+    def add_distribution(self, dist):
+        """
+        Add a distribution to the finder. This will update internal information
+        about who provides what.
+        :param dist: The distribution to add.
+        """
+        logger.debug('adding distribution %s', dist)
+        name = dist.key
+        self.dists_by_name[name] = dist
+        self.dists[(name, dist.version)] = dist
+        for p in dist.provides:
+            name, version = parse_name_and_version(p)
+            logger.debug('Add to provided: %s, %s, %s', name, version, dist)
+            self.provided.setdefault(name, set()).add((version, dist))
+
+    def remove_distribution(self, dist):
+        """
+        Remove a distribution from the finder. This will update internal
+        information about who provides what.
+        :param dist: The distribution to remove.
+        """
+        logger.debug('removing distribution %s', dist)
+        name = dist.key
+        del self.dists_by_name[name]
+        del self.dists[(name, dist.version)]
+        for p in dist.provides:
+            name, version = parse_name_and_version(p)
+            logger.debug('Remove from provided: %s, %s, %s', name, version, dist)
+            s = self.provided[name]
+            s.remove((version, dist))
+            if not s:
+                del self.provided[name]
+
+    def get_matcher(self, reqt):
+        """
+        Get a version matcher for a requirement.
+        :param reqt: The requirement
+        :type reqt: str
+        :return: A version matcher (an instance of
+                 :class:`distlib.version.Matcher`).
+        """
+        try:
+            matcher = self.scheme.matcher(reqt)
+        except UnsupportedVersionError:  # pragma: no cover
+            # XXX compat-mode if cannot read the version
+            name = reqt.split()[0]
+            matcher = self.scheme.matcher(name)
+        return matcher
+
+    def find_providers(self, reqt):
+        """
+        Find the distributions which can fulfill a requirement.
+
+        :param reqt: The requirement.
+         :type reqt: str
+        :return: A set of distribution which can fulfill the requirement.
+        """
+        matcher = self.get_matcher(reqt)
+        name = matcher.key   # case-insensitive
+        result = set()
+        provided = self.provided
+        if name in provided:
+            for version, provider in provided[name]:
+                try:
+                    match = matcher.match(version)
+                except UnsupportedVersionError:
+                    match = False
+
+                if match:
+                    result.add(provider)
+                    break
+        return result
+
+    def try_to_replace(self, provider, other, problems):
+        """
+        Attempt to replace one provider with another. This is typically used
+        when resolving dependencies from multiple sources, e.g. A requires
+        (B >= 1.0) while C requires (B >= 1.1).
+
+        For successful replacement, ``provider`` must meet all the requirements
+        which ``other`` fulfills.
+
+        :param provider: The provider we are trying to replace with.
+        :param other: The provider we're trying to replace.
+        :param problems: If False is returned, this will contain what
+                         problems prevented replacement. This is currently
+                         a tuple of the literal string 'cantreplace',
+                         ``provider``, ``other``  and the set of requirements
+                         that ``provider`` couldn't fulfill.
+        :return: True if we can replace ``other`` with ``provider``, else
+                 False.
+        """
+        rlist = self.reqts[other]
+        unmatched = set()
+        for s in rlist:
+            matcher = self.get_matcher(s)
+            if not matcher.match(provider.version):
+                unmatched.add(s)
+        if unmatched:
+            # can't replace other with provider
+            problems.add(('cantreplace', provider, other,
+                          frozenset(unmatched)))
+            result = False
+        else:
+            # can replace other with provider
+            self.remove_distribution(other)
+            del self.reqts[other]
+            for s in rlist:
+                self.reqts.setdefault(provider, set()).add(s)
+            self.add_distribution(provider)
+            result = True
+        return result
+
+    def find(self, requirement, meta_extras=None, prereleases=False):
+        """
+        Find a distribution and all distributions it depends on.
+
+        :param requirement: The requirement specifying the distribution to
+                            find, or a Distribution instance.
+        :param meta_extras: A list of meta extras such as :test:, :build: and
+                            so on.
+        :param prereleases: If ``True``, allow pre-release versions to be
+                            returned - otherwise, don't return prereleases
+                            unless they're all that's available.
+
+        Return a set of :class:`Distribution` instances and a set of
+        problems.
+
+        The distributions returned should be such that they have the
+        :attr:`required` attribute set to ``True`` if they were
+        from the ``requirement`` passed to ``find()``, and they have the
+        :attr:`build_time_dependency` attribute set to ``True`` unless they
+        are post-installation dependencies of the ``requirement``.
+
+        The problems should be a tuple consisting of the string
+        ``'unsatisfied'`` and the requirement which couldn't be satisfied
+        by any distribution known to the locator.
+        """
+
+        self.provided = {}
+        self.dists = {}
+        self.dists_by_name = {}
+        self.reqts = {}
+
+        meta_extras = set(meta_extras or [])
+        if ':*:' in meta_extras:
+            meta_extras.remove(':*:')
+            # :meta: and :run: are implicitly included
+            meta_extras |= set([':test:', ':build:', ':dev:'])
+
+        if isinstance(requirement, Distribution):
+            dist = odist = requirement
+            logger.debug('passed %s as requirement', odist)
+        else:
+            dist = odist = self.locator.locate(requirement,
+                                               prereleases=prereleases)
+            if dist is None:
+                raise DistlibException('Unable to locate %r' % requirement)
+            logger.debug('located %s', odist)
+        dist.requested = True
+        problems = set()
+        todo = set([dist])
+        install_dists = set([odist])
+        while todo:
+            dist = todo.pop()
+            name = dist.key     # case-insensitive
+            if name not in self.dists_by_name:
+                self.add_distribution(dist)
+            else:
+                #import pdb; pdb.set_trace()
+                other = self.dists_by_name[name]
+                if other != dist:
+                    self.try_to_replace(dist, other, problems)
+
+            ireqts = dist.run_requires | dist.meta_requires
+            sreqts = dist.build_requires
+            ereqts = set()
+            if meta_extras and dist in install_dists:
+                for key in ('test', 'build', 'dev'):
+                    e = ':%s:' % key
+                    if e in meta_extras:
+                        ereqts |= getattr(dist, '%s_requires' % key)
+            all_reqts = ireqts | sreqts | ereqts
+            for r in all_reqts:
+                providers = self.find_providers(r)
+                if not providers:
+                    logger.debug('No providers found for %r', r)
+                    provider = self.locator.locate(r, prereleases=prereleases)
+                    # If no provider is found and we didn't consider
+                    # prereleases, consider them now.
+                    if provider is None and not prereleases:
+                        provider = self.locator.locate(r, prereleases=True)
+                    if provider is None:
+                        logger.debug('Cannot satisfy %r', r)
+                        problems.add(('unsatisfied', r))
+                    else:
+                        n, v = provider.key, provider.version
+                        if (n, v) not in self.dists:
+                            todo.add(provider)
+                        providers.add(provider)
+                        if r in ireqts and dist in install_dists:
+                            install_dists.add(provider)
+                            logger.debug('Adding %s to install_dists',
+                                         provider.name_and_version)
+                for p in providers:
+                    name = p.key
+                    if name not in self.dists_by_name:
+                        self.reqts.setdefault(p, set()).add(r)
+                    else:
+                        other = self.dists_by_name[name]
+                        if other != p:
+                            # see if other can be replaced by p
+                            self.try_to_replace(p, other, problems)
+
+        dists = set(self.dists.values())
+        for dist in dists:
+            dist.build_time_dependency = dist not in install_dists
+            if dist.build_time_dependency:
+                logger.debug('%s is a build-time dependency only.',
+                             dist.name_and_version)
+        logger.debug('find done for %s', odist)
+        return dists, problems
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/manifest.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/manifest.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca0fe442d9ca499466df9438df16eca405c5f102
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/manifest.py
@@ -0,0 +1,393 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2013 Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""
+Class representing the list of files in a distribution.
+
+Equivalent to distutils.filelist, but fixes some problems.
+"""
+import fnmatch
+import logging
+import os
+import re
+import sys
+
+from . import DistlibException
+from .compat import fsdecode
+from .util import convert_path
+
+
+__all__ = ['Manifest']
+
+logger = logging.getLogger(__name__)
+
+# a \ followed by some spaces + EOL
+_COLLAPSE_PATTERN = re.compile('\\\\w*\n', re.M)
+_COMMENTED_LINE = re.compile('#.*?(?=\n)|\n(?=$)', re.M | re.S)
+
+#
+# Due to the different results returned by fnmatch.translate, we need
+# to do slightly different processing for Python 2.7 and 3.2 ... this needed
+# to be brought in for Python 3.6 onwards.
+#
+_PYTHON_VERSION = sys.version_info[:2]
+
+class Manifest(object):
+    """A list of files built by on exploring the filesystem and filtered by
+    applying various patterns to what we find there.
+    """
+
+    def __init__(self, base=None):
+        """
+        Initialise an instance.
+
+        :param base: The base directory to explore under.
+        """
+        self.base = os.path.abspath(os.path.normpath(base or os.getcwd()))
+        self.prefix = self.base + os.sep
+        self.allfiles = None
+        self.files = set()
+
+    #
+    # Public API
+    #
+
+    def findall(self):
+        """Find all files under the base and set ``allfiles`` to the absolute
+        pathnames of files found.
+        """
+        from stat import S_ISREG, S_ISDIR, S_ISLNK
+
+        self.allfiles = allfiles = []
+        root = self.base
+        stack = [root]
+        pop = stack.pop
+        push = stack.append
+
+        while stack:
+            root = pop()
+            names = os.listdir(root)
+
+            for name in names:
+                fullname = os.path.join(root, name)
+
+                # Avoid excess stat calls -- just one will do, thank you!
+                stat = os.stat(fullname)
+                mode = stat.st_mode
+                if S_ISREG(mode):
+                    allfiles.append(fsdecode(fullname))
+                elif S_ISDIR(mode) and not S_ISLNK(mode):
+                    push(fullname)
+
+    def add(self, item):
+        """
+        Add a file to the manifest.
+
+        :param item: The pathname to add. This can be relative to the base.
+        """
+        if not item.startswith(self.prefix):
+            item = os.path.join(self.base, item)
+        self.files.add(os.path.normpath(item))
+
+    def add_many(self, items):
+        """
+        Add a list of files to the manifest.
+
+        :param items: The pathnames to add. These can be relative to the base.
+        """
+        for item in items:
+            self.add(item)
+
+    def sorted(self, wantdirs=False):
+        """
+        Return sorted files in directory order
+        """
+
+        def add_dir(dirs, d):
+            dirs.add(d)
+            logger.debug('add_dir added %s', d)
+            if d != self.base:
+                parent, _ = os.path.split(d)
+                assert parent not in ('', '/')
+                add_dir(dirs, parent)
+
+        result = set(self.files)    # make a copy!
+        if wantdirs:
+            dirs = set()
+            for f in result:
+                add_dir(dirs, os.path.dirname(f))
+            result |= dirs
+        return [os.path.join(*path_tuple) for path_tuple in
+                sorted(os.path.split(path) for path in result)]
+
+    def clear(self):
+        """Clear all collected files."""
+        self.files = set()
+        self.allfiles = []
+
+    def process_directive(self, directive):
+        """
+        Process a directive which either adds some files from ``allfiles`` to
+        ``files``, or removes some files from ``files``.
+
+        :param directive: The directive to process. This should be in a format
+                     compatible with distutils ``MANIFEST.in`` files:
+
+                     http://docs.python.org/distutils/sourcedist.html#commands
+        """
+        # Parse the line: split it up, make sure the right number of words
+        # is there, and return the relevant words.  'action' is always
+        # defined: it's the first word of the line.  Which of the other
+        # three are defined depends on the action; it'll be either
+        # patterns, (dir and patterns), or (dirpattern).
+        action, patterns, thedir, dirpattern = self._parse_directive(directive)
+
+        # OK, now we know that the action is valid and we have the
+        # right number of words on the line for that action -- so we
+        # can proceed with minimal error-checking.
+        if action == 'include':
+            for pattern in patterns:
+                if not self._include_pattern(pattern, anchor=True):
+                    logger.warning('no files found matching %r', pattern)
+
+        elif action == 'exclude':
+            for pattern in patterns:
+                found = self._exclude_pattern(pattern, anchor=True)
+                #if not found:
+                #    logger.warning('no previously-included files '
+                #                   'found matching %r', pattern)
+
+        elif action == 'global-include':
+            for pattern in patterns:
+                if not self._include_pattern(pattern, anchor=False):
+                    logger.warning('no files found matching %r '
+                                   'anywhere in distribution', pattern)
+
+        elif action == 'global-exclude':
+            for pattern in patterns:
+                found = self._exclude_pattern(pattern, anchor=False)
+                #if not found:
+                #    logger.warning('no previously-included files '
+                #                   'matching %r found anywhere in '
+                #                   'distribution', pattern)
+
+        elif action == 'recursive-include':
+            for pattern in patterns:
+                if not self._include_pattern(pattern, prefix=thedir):
+                    logger.warning('no files found matching %r '
+                                   'under directory %r', pattern, thedir)
+
+        elif action == 'recursive-exclude':
+            for pattern in patterns:
+                found = self._exclude_pattern(pattern, prefix=thedir)
+                #if not found:
+                #    logger.warning('no previously-included files '
+                #                   'matching %r found under directory %r',
+                #                   pattern, thedir)
+
+        elif action == 'graft':
+            if not self._include_pattern(None, prefix=dirpattern):
+                logger.warning('no directories found matching %r',
+                               dirpattern)
+
+        elif action == 'prune':
+            if not self._exclude_pattern(None, prefix=dirpattern):
+                logger.warning('no previously-included directories found '
+                               'matching %r', dirpattern)
+        else:   # pragma: no cover
+            # This should never happen, as it should be caught in
+            # _parse_template_line
+            raise DistlibException(
+                'invalid action %r' % action)
+
+    #
+    # Private API
+    #
+
+    def _parse_directive(self, directive):
+        """
+        Validate a directive.
+        :param directive: The directive to validate.
+        :return: A tuple of action, patterns, thedir, dir_patterns
+        """
+        words = directive.split()
+        if len(words) == 1 and words[0] not in ('include', 'exclude',
+                                                'global-include',
+                                                'global-exclude',
+                                                'recursive-include',
+                                                'recursive-exclude',
+                                                'graft', 'prune'):
+            # no action given, let's use the default 'include'
+            words.insert(0, 'include')
+
+        action = words[0]
+        patterns = thedir = dir_pattern = None
+
+        if action in ('include', 'exclude',
+                      'global-include', 'global-exclude'):
+            if len(words) < 2:
+                raise DistlibException(
+                    '%r expects <pattern1> <pattern2> ...' % action)
+
+            patterns = [convert_path(word) for word in words[1:]]
+
+        elif action in ('recursive-include', 'recursive-exclude'):
+            if len(words) < 3:
+                raise DistlibException(
+                    '%r expects <dir> <pattern1> <pattern2> ...' % action)
+
+            thedir = convert_path(words[1])
+            patterns = [convert_path(word) for word in words[2:]]
+
+        elif action in ('graft', 'prune'):
+            if len(words) != 2:
+                raise DistlibException(
+                    '%r expects a single <dir_pattern>' % action)
+
+            dir_pattern = convert_path(words[1])
+
+        else:
+            raise DistlibException('unknown action %r' % action)
+
+        return action, patterns, thedir, dir_pattern
+
+    def _include_pattern(self, pattern, anchor=True, prefix=None,
+                         is_regex=False):
+        """Select strings (presumably filenames) from 'self.files' that
+        match 'pattern', a Unix-style wildcard (glob) pattern.
+
+        Patterns are not quite the same as implemented by the 'fnmatch'
+        module: '*' and '?'  match non-special characters, where "special"
+        is platform-dependent: slash on Unix; colon, slash, and backslash on
+        DOS/Windows; and colon on Mac OS.
+
+        If 'anchor' is true (the default), then the pattern match is more
+        stringent: "*.py" will match "foo.py" but not "foo/bar.py".  If
+        'anchor' is false, both of these will match.
+
+        If 'prefix' is supplied, then only filenames starting with 'prefix'
+        (itself a pattern) and ending with 'pattern', with anything in between
+        them, will match.  'anchor' is ignored in this case.
+
+        If 'is_regex' is true, 'anchor' and 'prefix' are ignored, and
+        'pattern' is assumed to be either a string containing a regex or a
+        regex object -- no translation is done, the regex is just compiled
+        and used as-is.
+
+        Selected strings will be added to self.files.
+
+        Return True if files are found.
+        """
+        # XXX docstring lying about what the special chars are?
+        found = False
+        pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex)
+
+        # delayed loading of allfiles list
+        if self.allfiles is None:
+            self.findall()
+
+        for name in self.allfiles:
+            if pattern_re.search(name):
+                self.files.add(name)
+                found = True
+        return found
+
+    def _exclude_pattern(self, pattern, anchor=True, prefix=None,
+                         is_regex=False):
+        """Remove strings (presumably filenames) from 'files' that match
+        'pattern'.
+
+        Other parameters are the same as for 'include_pattern()', above.
+        The list 'self.files' is modified in place. Return True if files are
+        found.
+
+        This API is public to allow e.g. exclusion of SCM subdirs, e.g. when
+        packaging source distributions
+        """
+        found = False
+        pattern_re = self._translate_pattern(pattern, anchor, prefix, is_regex)
+        for f in list(self.files):
+            if pattern_re.search(f):
+                self.files.remove(f)
+                found = True
+        return found
+
+    def _translate_pattern(self, pattern, anchor=True, prefix=None,
+                           is_regex=False):
+        """Translate a shell-like wildcard pattern to a compiled regular
+        expression.
+
+        Return the compiled regex.  If 'is_regex' true,
+        then 'pattern' is directly compiled to a regex (if it's a string)
+        or just returned as-is (assumes it's a regex object).
+        """
+        if is_regex:
+            if isinstance(pattern, str):
+                return re.compile(pattern)
+            else:
+                return pattern
+
+        if _PYTHON_VERSION > (3, 2):
+            # ditch start and end characters
+            start, _, end = self._glob_to_re('_').partition('_')
+
+        if pattern:
+            pattern_re = self._glob_to_re(pattern)
+            if _PYTHON_VERSION > (3, 2):
+                assert pattern_re.startswith(start) and pattern_re.endswith(end)
+        else:
+            pattern_re = ''
+
+        base = re.escape(os.path.join(self.base, ''))
+        if prefix is not None:
+            # ditch end of pattern character
+            if _PYTHON_VERSION <= (3, 2):
+                empty_pattern = self._glob_to_re('')
+                prefix_re = self._glob_to_re(prefix)[:-len(empty_pattern)]
+            else:
+                prefix_re = self._glob_to_re(prefix)
+                assert prefix_re.startswith(start) and prefix_re.endswith(end)
+                prefix_re = prefix_re[len(start): len(prefix_re) - len(end)]
+            sep = os.sep
+            if os.sep == '\\':
+                sep = r'\\'
+            if _PYTHON_VERSION <= (3, 2):
+                pattern_re = '^' + base + sep.join((prefix_re,
+                                                    '.*' + pattern_re))
+            else:
+                pattern_re = pattern_re[len(start): len(pattern_re) - len(end)]
+                pattern_re = r'%s%s%s%s.*%s%s' % (start, base, prefix_re, sep,
+                                                  pattern_re, end)
+        else:  # no prefix -- respect anchor flag
+            if anchor:
+                if _PYTHON_VERSION <= (3, 2):
+                    pattern_re = '^' + base + pattern_re
+                else:
+                    pattern_re = r'%s%s%s' % (start, base, pattern_re[len(start):])
+
+        return re.compile(pattern_re)
+
+    def _glob_to_re(self, pattern):
+        """Translate a shell-like glob pattern to a regular expression.
+
+        Return a string containing the regex.  Differs from
+        'fnmatch.translate()' in that '*' does not match "special characters"
+        (which are platform-specific).
+        """
+        pattern_re = fnmatch.translate(pattern)
+
+        # '?' and '*' in the glob pattern become '.' and '.*' in the RE, which
+        # IMHO is wrong -- '?' and '*' aren't supposed to match slash in Unix,
+        # and by extension they shouldn't match such "special characters" under
+        # any OS.  So change all non-escaped dots in the RE to match any
+        # character except the special characters (currently: just os.sep).
+        sep = os.sep
+        if os.sep == '\\':
+            # we're using a regex to manipulate a regex, so we need
+            # to escape the backslash twice
+            sep = r'\\\\'
+        escaped = r'\1[^%s]' % sep
+        pattern_re = re.sub(r'((?<!\\)(\\\\)*)\.', escaped, pattern_re)
+        return pattern_re
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/markers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/markers.py
new file mode 100644
index 0000000000000000000000000000000000000000..ee1f3e23655b53293cc2d5bf50e835ac2662cc7f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/markers.py
@@ -0,0 +1,131 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2017 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""
+Parser for the environment markers micro-language defined in PEP 508.
+"""
+
+# Note: In PEP 345, the micro-language was Python compatible, so the ast
+# module could be used to parse it. However, PEP 508 introduced operators such
+# as ~= and === which aren't in Python, necessitating a different approach.
+
+import os
+import sys
+import platform
+import re
+
+from .compat import python_implementation, urlparse, string_types
+from .util import in_venv, parse_marker
+
+__all__ = ['interpret']
+
+def _is_literal(o):
+    if not isinstance(o, string_types) or not o:
+        return False
+    return o[0] in '\'"'
+
+class Evaluator(object):
+    """
+    This class is used to evaluate marker expessions.
+    """
+
+    operations = {
+        '==': lambda x, y: x == y,
+        '===': lambda x, y: x == y,
+        '~=': lambda x, y: x == y or x > y,
+        '!=': lambda x, y: x != y,
+        '<':  lambda x, y: x < y,
+        '<=':  lambda x, y: x == y or x < y,
+        '>':  lambda x, y: x > y,
+        '>=':  lambda x, y: x == y or x > y,
+        'and': lambda x, y: x and y,
+        'or': lambda x, y: x or y,
+        'in': lambda x, y: x in y,
+        'not in': lambda x, y: x not in y,
+    }
+
+    def evaluate(self, expr, context):
+        """
+        Evaluate a marker expression returned by the :func:`parse_requirement`
+        function in the specified context.
+        """
+        if isinstance(expr, string_types):
+            if expr[0] in '\'"':
+                result = expr[1:-1]
+            else:
+                if expr not in context:
+                    raise SyntaxError('unknown variable: %s' % expr)
+                result = context[expr]
+        else:
+            assert isinstance(expr, dict)
+            op = expr['op']
+            if op not in self.operations:
+                raise NotImplementedError('op not implemented: %s' % op)
+            elhs = expr['lhs']
+            erhs = expr['rhs']
+            if _is_literal(expr['lhs']) and _is_literal(expr['rhs']):
+                raise SyntaxError('invalid comparison: %s %s %s' % (elhs, op, erhs))
+
+            lhs = self.evaluate(elhs, context)
+            rhs = self.evaluate(erhs, context)
+            result = self.operations[op](lhs, rhs)
+        return result
+
+def default_context():
+    def format_full_version(info):
+        version = '%s.%s.%s' % (info.major, info.minor, info.micro)
+        kind = info.releaselevel
+        if kind != 'final':
+            version += kind[0] + str(info.serial)
+        return version
+
+    if hasattr(sys, 'implementation'):
+        implementation_version = format_full_version(sys.implementation.version)
+        implementation_name = sys.implementation.name
+    else:
+        implementation_version = '0'
+        implementation_name = ''
+
+    result = {
+        'implementation_name': implementation_name,
+        'implementation_version': implementation_version,
+        'os_name': os.name,
+        'platform_machine': platform.machine(),
+        'platform_python_implementation': platform.python_implementation(),
+        'platform_release': platform.release(),
+        'platform_system': platform.system(),
+        'platform_version': platform.version(),
+        'platform_in_venv': str(in_venv()),
+        'python_full_version': platform.python_version(),
+        'python_version': platform.python_version()[:3],
+        'sys_platform': sys.platform,
+    }
+    return result
+
+DEFAULT_CONTEXT = default_context()
+del default_context
+
+evaluator = Evaluator()
+
+def interpret(marker, execution_context=None):
+    """
+    Interpret a marker and return a result depending on environment.
+
+    :param marker: The marker to interpret.
+    :type marker: str
+    :param execution_context: The context used for name lookup.
+    :type execution_context: mapping
+    """
+    try:
+        expr, rest = parse_marker(marker)
+    except Exception as e:
+        raise SyntaxError('Unable to interpret marker syntax: %s: %s' % (marker, e))
+    if rest and rest[0] != '#':
+        raise SyntaxError('unexpected trailing data in marker: %s: %s' % (marker, rest))
+    context = dict(DEFAULT_CONTEXT)
+    if execution_context:
+        context.update(execution_context)
+    return evaluator.evaluate(expr, context)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/metadata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/metadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d61378e9942fb67c15544db57bac502fa50376b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/metadata.py
@@ -0,0 +1,1096 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""Implementation of the Metadata for Python packages PEPs.
+
+Supports all metadata formats (1.0, 1.1, 1.2, and 2.0 experimental).
+"""
+from __future__ import unicode_literals
+
+import codecs
+from email import message_from_file
+import json
+import logging
+import re
+
+
+from . import DistlibException, __version__
+from .compat import StringIO, string_types, text_type
+from .markers import interpret
+from .util import extract_by_key, get_extras
+from .version import get_scheme, PEP440_VERSION_RE
+
+logger = logging.getLogger(__name__)
+
+
+class MetadataMissingError(DistlibException):
+    """A required metadata is missing"""
+
+
+class MetadataConflictError(DistlibException):
+    """Attempt to read or write metadata fields that are conflictual."""
+
+
+class MetadataUnrecognizedVersionError(DistlibException):
+    """Unknown metadata version number."""
+
+
+class MetadataInvalidError(DistlibException):
+    """A metadata value is invalid"""
+
+# public API of this module
+__all__ = ['Metadata', 'PKG_INFO_ENCODING', 'PKG_INFO_PREFERRED_VERSION']
+
+# Encoding used for the PKG-INFO files
+PKG_INFO_ENCODING = 'utf-8'
+
+# preferred version. Hopefully will be changed
+# to 1.2 once PEP 345 is supported everywhere
+PKG_INFO_PREFERRED_VERSION = '1.1'
+
+_LINE_PREFIX_1_2 = re.compile('\n       \\|')
+_LINE_PREFIX_PRE_1_2 = re.compile('\n        ')
+_241_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform',
+               'Summary', 'Description',
+               'Keywords', 'Home-page', 'Author', 'Author-email',
+               'License')
+
+_314_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform',
+               'Supported-Platform', 'Summary', 'Description',
+               'Keywords', 'Home-page', 'Author', 'Author-email',
+               'License', 'Classifier', 'Download-URL', 'Obsoletes',
+               'Provides', 'Requires')
+
+_314_MARKERS = ('Obsoletes', 'Provides', 'Requires', 'Classifier',
+                'Download-URL')
+
+_345_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform',
+               'Supported-Platform', 'Summary', 'Description',
+               'Keywords', 'Home-page', 'Author', 'Author-email',
+               'Maintainer', 'Maintainer-email', 'License',
+               'Classifier', 'Download-URL', 'Obsoletes-Dist',
+               'Project-URL', 'Provides-Dist', 'Requires-Dist',
+               'Requires-Python', 'Requires-External')
+
+_345_MARKERS = ('Provides-Dist', 'Requires-Dist', 'Requires-Python',
+                'Obsoletes-Dist', 'Requires-External', 'Maintainer',
+                'Maintainer-email', 'Project-URL')
+
+_426_FIELDS = ('Metadata-Version', 'Name', 'Version', 'Platform',
+               'Supported-Platform', 'Summary', 'Description',
+               'Keywords', 'Home-page', 'Author', 'Author-email',
+               'Maintainer', 'Maintainer-email', 'License',
+               'Classifier', 'Download-URL', 'Obsoletes-Dist',
+               'Project-URL', 'Provides-Dist', 'Requires-Dist',
+               'Requires-Python', 'Requires-External', 'Private-Version',
+               'Obsoleted-By', 'Setup-Requires-Dist', 'Extension',
+               'Provides-Extra')
+
+_426_MARKERS = ('Private-Version', 'Provides-Extra', 'Obsoleted-By',
+                'Setup-Requires-Dist', 'Extension')
+
+# See issue #106: Sometimes 'Requires' and 'Provides' occur wrongly in
+# the metadata. Include them in the tuple literal below to allow them
+# (for now).
+_566_FIELDS = _426_FIELDS + ('Description-Content-Type',
+                             'Requires', 'Provides')
+
+_566_MARKERS = ('Description-Content-Type',)
+
+_ALL_FIELDS = set()
+_ALL_FIELDS.update(_241_FIELDS)
+_ALL_FIELDS.update(_314_FIELDS)
+_ALL_FIELDS.update(_345_FIELDS)
+_ALL_FIELDS.update(_426_FIELDS)
+_ALL_FIELDS.update(_566_FIELDS)
+
+EXTRA_RE = re.compile(r'''extra\s*==\s*("([^"]+)"|'([^']+)')''')
+
+
+def _version2fieldlist(version):
+    if version == '1.0':
+        return _241_FIELDS
+    elif version == '1.1':
+        return _314_FIELDS
+    elif version == '1.2':
+        return _345_FIELDS
+    elif version in ('1.3', '2.1'):
+        return _345_FIELDS + _566_FIELDS
+    elif version == '2.0':
+        return _426_FIELDS
+    raise MetadataUnrecognizedVersionError(version)
+
+
+def _best_version(fields):
+    """Detect the best version depending on the fields used."""
+    def _has_marker(keys, markers):
+        for marker in markers:
+            if marker in keys:
+                return True
+        return False
+
+    keys = []
+    for key, value in fields.items():
+        if value in ([], 'UNKNOWN', None):
+            continue
+        keys.append(key)
+
+    possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.0', '2.1']
+
+    # first let's try to see if a field is not part of one of the version
+    for key in keys:
+        if key not in _241_FIELDS and '1.0' in possible_versions:
+            possible_versions.remove('1.0')
+            logger.debug('Removed 1.0 due to %s', key)
+        if key not in _314_FIELDS and '1.1' in possible_versions:
+            possible_versions.remove('1.1')
+            logger.debug('Removed 1.1 due to %s', key)
+        if key not in _345_FIELDS and '1.2' in possible_versions:
+            possible_versions.remove('1.2')
+            logger.debug('Removed 1.2 due to %s', key)
+        if key not in _566_FIELDS and '1.3' in possible_versions:
+            possible_versions.remove('1.3')
+            logger.debug('Removed 1.3 due to %s', key)
+        if key not in _566_FIELDS and '2.1' in possible_versions:
+            if key != 'Description':  # In 2.1, description allowed after headers
+                possible_versions.remove('2.1')
+                logger.debug('Removed 2.1 due to %s', key)
+        if key not in _426_FIELDS and '2.0' in possible_versions:
+            possible_versions.remove('2.0')
+            logger.debug('Removed 2.0 due to %s', key)
+
+    # possible_version contains qualified versions
+    if len(possible_versions) == 1:
+        return possible_versions[0]   # found !
+    elif len(possible_versions) == 0:
+        logger.debug('Out of options - unknown metadata set: %s', fields)
+        raise MetadataConflictError('Unknown metadata set')
+
+    # let's see if one unique marker is found
+    is_1_1 = '1.1' in possible_versions and _has_marker(keys, _314_MARKERS)
+    is_1_2 = '1.2' in possible_versions and _has_marker(keys, _345_MARKERS)
+    is_2_1 = '2.1' in possible_versions and _has_marker(keys, _566_MARKERS)
+    is_2_0 = '2.0' in possible_versions and _has_marker(keys, _426_MARKERS)
+    if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_0) > 1:
+        raise MetadataConflictError('You used incompatible 1.1/1.2/2.0/2.1 fields')
+
+    # we have the choice, 1.0, or 1.2, or 2.0
+    #   - 1.0 has a broken Summary field but works with all tools
+    #   - 1.1 is to avoid
+    #   - 1.2 fixes Summary but has little adoption
+    #   - 2.0 adds more features and is very new
+    if not is_1_1 and not is_1_2 and not is_2_1 and not is_2_0:
+        # we couldn't find any specific marker
+        if PKG_INFO_PREFERRED_VERSION in possible_versions:
+            return PKG_INFO_PREFERRED_VERSION
+    if is_1_1:
+        return '1.1'
+    if is_1_2:
+        return '1.2'
+    if is_2_1:
+        return '2.1'
+
+    return '2.0'
+
+_ATTR2FIELD = {
+    'metadata_version': 'Metadata-Version',
+    'name': 'Name',
+    'version': 'Version',
+    'platform': 'Platform',
+    'supported_platform': 'Supported-Platform',
+    'summary': 'Summary',
+    'description': 'Description',
+    'keywords': 'Keywords',
+    'home_page': 'Home-page',
+    'author': 'Author',
+    'author_email': 'Author-email',
+    'maintainer': 'Maintainer',
+    'maintainer_email': 'Maintainer-email',
+    'license': 'License',
+    'classifier': 'Classifier',
+    'download_url': 'Download-URL',
+    'obsoletes_dist': 'Obsoletes-Dist',
+    'provides_dist': 'Provides-Dist',
+    'requires_dist': 'Requires-Dist',
+    'setup_requires_dist': 'Setup-Requires-Dist',
+    'requires_python': 'Requires-Python',
+    'requires_external': 'Requires-External',
+    'requires': 'Requires',
+    'provides': 'Provides',
+    'obsoletes': 'Obsoletes',
+    'project_url': 'Project-URL',
+    'private_version': 'Private-Version',
+    'obsoleted_by': 'Obsoleted-By',
+    'extension': 'Extension',
+    'provides_extra': 'Provides-Extra',
+}
+
+_PREDICATE_FIELDS = ('Requires-Dist', 'Obsoletes-Dist', 'Provides-Dist')
+_VERSIONS_FIELDS = ('Requires-Python',)
+_VERSION_FIELDS = ('Version',)
+_LISTFIELDS = ('Platform', 'Classifier', 'Obsoletes',
+               'Requires', 'Provides', 'Obsoletes-Dist',
+               'Provides-Dist', 'Requires-Dist', 'Requires-External',
+               'Project-URL', 'Supported-Platform', 'Setup-Requires-Dist',
+               'Provides-Extra', 'Extension')
+_LISTTUPLEFIELDS = ('Project-URL',)
+
+_ELEMENTSFIELD = ('Keywords',)
+
+_UNICODEFIELDS = ('Author', 'Maintainer', 'Summary', 'Description')
+
+_MISSING = object()
+
+_FILESAFE = re.compile('[^A-Za-z0-9.]+')
+
+
+def _get_name_and_version(name, version, for_filename=False):
+    """Return the distribution name with version.
+
+    If for_filename is true, return a filename-escaped form."""
+    if for_filename:
+        # For both name and version any runs of non-alphanumeric or '.'
+        # characters are replaced with a single '-'.  Additionally any
+        # spaces in the version string become '.'
+        name = _FILESAFE.sub('-', name)
+        version = _FILESAFE.sub('-', version.replace(' ', '.'))
+    return '%s-%s' % (name, version)
+
+
+class LegacyMetadata(object):
+    """The legacy metadata of a release.
+
+    Supports versions 1.0, 1.1 and 1.2 (auto-detected). You can
+    instantiate the class with one of these arguments (or none):
+    - *path*, the path to a metadata file
+    - *fileobj* give a file-like object with metadata as content
+    - *mapping* is a dict-like object
+    - *scheme* is a version scheme name
+    """
+    # TODO document the mapping API and UNKNOWN default key
+
+    def __init__(self, path=None, fileobj=None, mapping=None,
+                 scheme='default'):
+        if [path, fileobj, mapping].count(None) < 2:
+            raise TypeError('path, fileobj and mapping are exclusive')
+        self._fields = {}
+        self.requires_files = []
+        self._dependencies = None
+        self.scheme = scheme
+        if path is not None:
+            self.read(path)
+        elif fileobj is not None:
+            self.read_file(fileobj)
+        elif mapping is not None:
+            self.update(mapping)
+            self.set_metadata_version()
+
+    def set_metadata_version(self):
+        self._fields['Metadata-Version'] = _best_version(self._fields)
+
+    def _write_field(self, fileobj, name, value):
+        fileobj.write('%s: %s\n' % (name, value))
+
+    def __getitem__(self, name):
+        return self.get(name)
+
+    def __setitem__(self, name, value):
+        return self.set(name, value)
+
+    def __delitem__(self, name):
+        field_name = self._convert_name(name)
+        try:
+            del self._fields[field_name]
+        except KeyError:
+            raise KeyError(name)
+
+    def __contains__(self, name):
+        return (name in self._fields or
+                self._convert_name(name) in self._fields)
+
+    def _convert_name(self, name):
+        if name in _ALL_FIELDS:
+            return name
+        name = name.replace('-', '_').lower()
+        return _ATTR2FIELD.get(name, name)
+
+    def _default_value(self, name):
+        if name in _LISTFIELDS or name in _ELEMENTSFIELD:
+            return []
+        return 'UNKNOWN'
+
+    def _remove_line_prefix(self, value):
+        if self.metadata_version in ('1.0', '1.1'):
+            return _LINE_PREFIX_PRE_1_2.sub('\n', value)
+        else:
+            return _LINE_PREFIX_1_2.sub('\n', value)
+
+    def __getattr__(self, name):
+        if name in _ATTR2FIELD:
+            return self[name]
+        raise AttributeError(name)
+
+    #
+    # Public API
+    #
+
+#    dependencies = property(_get_dependencies, _set_dependencies)
+
+    def get_fullname(self, filesafe=False):
+        """Return the distribution name with version.
+
+        If filesafe is true, return a filename-escaped form."""
+        return _get_name_and_version(self['Name'], self['Version'], filesafe)
+
+    def is_field(self, name):
+        """return True if name is a valid metadata key"""
+        name = self._convert_name(name)
+        return name in _ALL_FIELDS
+
+    def is_multi_field(self, name):
+        name = self._convert_name(name)
+        return name in _LISTFIELDS
+
+    def read(self, filepath):
+        """Read the metadata values from a file path."""
+        fp = codecs.open(filepath, 'r', encoding='utf-8')
+        try:
+            self.read_file(fp)
+        finally:
+            fp.close()
+
+    def read_file(self, fileob):
+        """Read the metadata values from a file object."""
+        msg = message_from_file(fileob)
+        self._fields['Metadata-Version'] = msg['metadata-version']
+
+        # When reading, get all the fields we can
+        for field in _ALL_FIELDS:
+            if field not in msg:
+                continue
+            if field in _LISTFIELDS:
+                # we can have multiple lines
+                values = msg.get_all(field)
+                if field in _LISTTUPLEFIELDS and values is not None:
+                    values = [tuple(value.split(',')) for value in values]
+                self.set(field, values)
+            else:
+                # single line
+                value = msg[field]
+                if value is not None and value != 'UNKNOWN':
+                    self.set(field, value)
+        # logger.debug('Attempting to set metadata for %s', self)
+        # self.set_metadata_version()
+
+    def write(self, filepath, skip_unknown=False):
+        """Write the metadata fields to filepath."""
+        fp = codecs.open(filepath, 'w', encoding='utf-8')
+        try:
+            self.write_file(fp, skip_unknown)
+        finally:
+            fp.close()
+
+    def write_file(self, fileobject, skip_unknown=False):
+        """Write the PKG-INFO format data to a file object."""
+        self.set_metadata_version()
+
+        for field in _version2fieldlist(self['Metadata-Version']):
+            values = self.get(field)
+            if skip_unknown and values in ('UNKNOWN', [], ['UNKNOWN']):
+                continue
+            if field in _ELEMENTSFIELD:
+                self._write_field(fileobject, field, ','.join(values))
+                continue
+            if field not in _LISTFIELDS:
+                if field == 'Description':
+                    if self.metadata_version in ('1.0', '1.1'):
+                        values = values.replace('\n', '\n        ')
+                    else:
+                        values = values.replace('\n', '\n       |')
+                values = [values]
+
+            if field in _LISTTUPLEFIELDS:
+                values = [','.join(value) for value in values]
+
+            for value in values:
+                self._write_field(fileobject, field, value)
+
+    def update(self, other=None, **kwargs):
+        """Set metadata values from the given iterable `other` and kwargs.
+
+        Behavior is like `dict.update`: If `other` has a ``keys`` method,
+        they are looped over and ``self[key]`` is assigned ``other[key]``.
+        Else, ``other`` is an iterable of ``(key, value)`` iterables.
+
+        Keys that don't match a metadata field or that have an empty value are
+        dropped.
+        """
+        def _set(key, value):
+            if key in _ATTR2FIELD and value:
+                self.set(self._convert_name(key), value)
+
+        if not other:
+            # other is None or empty container
+            pass
+        elif hasattr(other, 'keys'):
+            for k in other.keys():
+                _set(k, other[k])
+        else:
+            for k, v in other:
+                _set(k, v)
+
+        if kwargs:
+            for k, v in kwargs.items():
+                _set(k, v)
+
+    def set(self, name, value):
+        """Control then set a metadata field."""
+        name = self._convert_name(name)
+
+        if ((name in _ELEMENTSFIELD or name == 'Platform') and
+            not isinstance(value, (list, tuple))):
+            if isinstance(value, string_types):
+                value = [v.strip() for v in value.split(',')]
+            else:
+                value = []
+        elif (name in _LISTFIELDS and
+              not isinstance(value, (list, tuple))):
+            if isinstance(value, string_types):
+                value = [value]
+            else:
+                value = []
+
+        if logger.isEnabledFor(logging.WARNING):
+            project_name = self['Name']
+
+            scheme = get_scheme(self.scheme)
+            if name in _PREDICATE_FIELDS and value is not None:
+                for v in value:
+                    # check that the values are valid
+                    if not scheme.is_valid_matcher(v.split(';')[0]):
+                        logger.warning(
+                            "'%s': '%s' is not valid (field '%s')",
+                            project_name, v, name)
+            # FIXME this rejects UNKNOWN, is that right?
+            elif name in _VERSIONS_FIELDS and value is not None:
+                if not scheme.is_valid_constraint_list(value):
+                    logger.warning("'%s': '%s' is not a valid version (field '%s')",
+                                   project_name, value, name)
+            elif name in _VERSION_FIELDS and value is not None:
+                if not scheme.is_valid_version(value):
+                    logger.warning("'%s': '%s' is not a valid version (field '%s')",
+                                   project_name, value, name)
+
+        if name in _UNICODEFIELDS:
+            if name == 'Description':
+                value = self._remove_line_prefix(value)
+
+        self._fields[name] = value
+
+    def get(self, name, default=_MISSING):
+        """Get a metadata field."""
+        name = self._convert_name(name)
+        if name not in self._fields:
+            if default is _MISSING:
+                default = self._default_value(name)
+            return default
+        if name in _UNICODEFIELDS:
+            value = self._fields[name]
+            return value
+        elif name in _LISTFIELDS:
+            value = self._fields[name]
+            if value is None:
+                return []
+            res = []
+            for val in value:
+                if name not in _LISTTUPLEFIELDS:
+                    res.append(val)
+                else:
+                    # That's for Project-URL
+                    res.append((val[0], val[1]))
+            return res
+
+        elif name in _ELEMENTSFIELD:
+            value = self._fields[name]
+            if isinstance(value, string_types):
+                return value.split(',')
+        return self._fields[name]
+
+    def check(self, strict=False):
+        """Check if the metadata is compliant. If strict is True then raise if
+        no Name or Version are provided"""
+        self.set_metadata_version()
+
+        # XXX should check the versions (if the file was loaded)
+        missing, warnings = [], []
+
+        for attr in ('Name', 'Version'):  # required by PEP 345
+            if attr not in self:
+                missing.append(attr)
+
+        if strict and missing != []:
+            msg = 'missing required metadata: %s' % ', '.join(missing)
+            raise MetadataMissingError(msg)
+
+        for attr in ('Home-page', 'Author'):
+            if attr not in self:
+                missing.append(attr)
+
+        # checking metadata 1.2 (XXX needs to check 1.1, 1.0)
+        if self['Metadata-Version'] != '1.2':
+            return missing, warnings
+
+        scheme = get_scheme(self.scheme)
+
+        def are_valid_constraints(value):
+            for v in value:
+                if not scheme.is_valid_matcher(v.split(';')[0]):
+                    return False
+            return True
+
+        for fields, controller in ((_PREDICATE_FIELDS, are_valid_constraints),
+                                   (_VERSIONS_FIELDS,
+                                    scheme.is_valid_constraint_list),
+                                   (_VERSION_FIELDS,
+                                    scheme.is_valid_version)):
+            for field in fields:
+                value = self.get(field, None)
+                if value is not None and not controller(value):
+                    warnings.append("Wrong value for '%s': %s" % (field, value))
+
+        return missing, warnings
+
+    def todict(self, skip_missing=False):
+        """Return fields as a dict.
+
+        Field names will be converted to use the underscore-lowercase style
+        instead of hyphen-mixed case (i.e. home_page instead of Home-page).
+        """
+        self.set_metadata_version()
+
+        mapping_1_0 = (
+            ('metadata_version', 'Metadata-Version'),
+            ('name', 'Name'),
+            ('version', 'Version'),
+            ('summary', 'Summary'),
+            ('home_page', 'Home-page'),
+            ('author', 'Author'),
+            ('author_email', 'Author-email'),
+            ('license', 'License'),
+            ('description', 'Description'),
+            ('keywords', 'Keywords'),
+            ('platform', 'Platform'),
+            ('classifiers', 'Classifier'),
+            ('download_url', 'Download-URL'),
+        )
+
+        data = {}
+        for key, field_name in mapping_1_0:
+            if not skip_missing or field_name in self._fields:
+                data[key] = self[field_name]
+
+        if self['Metadata-Version'] == '1.2':
+            mapping_1_2 = (
+                ('requires_dist', 'Requires-Dist'),
+                ('requires_python', 'Requires-Python'),
+                ('requires_external', 'Requires-External'),
+                ('provides_dist', 'Provides-Dist'),
+                ('obsoletes_dist', 'Obsoletes-Dist'),
+                ('project_url', 'Project-URL'),
+                ('maintainer', 'Maintainer'),
+                ('maintainer_email', 'Maintainer-email'),
+            )
+            for key, field_name in mapping_1_2:
+                if not skip_missing or field_name in self._fields:
+                    if key != 'project_url':
+                        data[key] = self[field_name]
+                    else:
+                        data[key] = [','.join(u) for u in self[field_name]]
+
+        elif self['Metadata-Version'] == '1.1':
+            mapping_1_1 = (
+                ('provides', 'Provides'),
+                ('requires', 'Requires'),
+                ('obsoletes', 'Obsoletes'),
+            )
+            for key, field_name in mapping_1_1:
+                if not skip_missing or field_name in self._fields:
+                    data[key] = self[field_name]
+
+        return data
+
+    def add_requirements(self, requirements):
+        if self['Metadata-Version'] == '1.1':
+            # we can't have 1.1 metadata *and* Setuptools requires
+            for field in ('Obsoletes', 'Requires', 'Provides'):
+                if field in self:
+                    del self[field]
+        self['Requires-Dist'] += requirements
+
+    # Mapping API
+    # TODO could add iter* variants
+
+    def keys(self):
+        return list(_version2fieldlist(self['Metadata-Version']))
+
+    def __iter__(self):
+        for key in self.keys():
+            yield key
+
+    def values(self):
+        return [self[key] for key in self.keys()]
+
+    def items(self):
+        return [(key, self[key]) for key in self.keys()]
+
+    def __repr__(self):
+        return '<%s %s %s>' % (self.__class__.__name__, self.name,
+                               self.version)
+
+
+METADATA_FILENAME = 'pydist.json'
+WHEEL_METADATA_FILENAME = 'metadata.json'
+LEGACY_METADATA_FILENAME = 'METADATA'
+
+
+class Metadata(object):
+    """
+    The metadata of a release. This implementation uses 2.0 (JSON)
+    metadata where possible. If not possible, it wraps a LegacyMetadata
+    instance which handles the key-value metadata format.
+    """
+
+    METADATA_VERSION_MATCHER = re.compile(r'^\d+(\.\d+)*$')
+
+    NAME_MATCHER = re.compile('^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$', re.I)
+
+    VERSION_MATCHER = PEP440_VERSION_RE
+
+    SUMMARY_MATCHER = re.compile('.{1,2047}')
+
+    METADATA_VERSION = '2.0'
+
+    GENERATOR = 'distlib (%s)' % __version__
+
+    MANDATORY_KEYS = {
+        'name': (),
+        'version': (),
+        'summary': ('legacy',),
+    }
+
+    INDEX_KEYS = ('name version license summary description author '
+                  'author_email keywords platform home_page classifiers '
+                  'download_url')
+
+    DEPENDENCY_KEYS = ('extras run_requires test_requires build_requires '
+                       'dev_requires provides meta_requires obsoleted_by '
+                       'supports_environments')
+
+    SYNTAX_VALIDATORS = {
+        'metadata_version': (METADATA_VERSION_MATCHER, ()),
+        'name': (NAME_MATCHER, ('legacy',)),
+        'version': (VERSION_MATCHER, ('legacy',)),
+        'summary': (SUMMARY_MATCHER, ('legacy',)),
+    }
+
+    __slots__ = ('_legacy', '_data', 'scheme')
+
+    def __init__(self, path=None, fileobj=None, mapping=None,
+                 scheme='default'):
+        if [path, fileobj, mapping].count(None) < 2:
+            raise TypeError('path, fileobj and mapping are exclusive')
+        self._legacy = None
+        self._data = None
+        self.scheme = scheme
+        #import pdb; pdb.set_trace()
+        if mapping is not None:
+            try:
+                self._validate_mapping(mapping, scheme)
+                self._data = mapping
+            except MetadataUnrecognizedVersionError:
+                self._legacy = LegacyMetadata(mapping=mapping, scheme=scheme)
+                self.validate()
+        else:
+            data = None
+            if path:
+                with open(path, 'rb') as f:
+                    data = f.read()
+            elif fileobj:
+                data = fileobj.read()
+            if data is None:
+                # Initialised with no args - to be added
+                self._data = {
+                    'metadata_version': self.METADATA_VERSION,
+                    'generator': self.GENERATOR,
+                }
+            else:
+                if not isinstance(data, text_type):
+                    data = data.decode('utf-8')
+                try:
+                    self._data = json.loads(data)
+                    self._validate_mapping(self._data, scheme)
+                except ValueError:
+                    # Note: MetadataUnrecognizedVersionError does not
+                    # inherit from ValueError (it's a DistlibException,
+                    # which should not inherit from ValueError).
+                    # The ValueError comes from the json.load - if that
+                    # succeeds and we get a validation error, we want
+                    # that to propagate
+                    self._legacy = LegacyMetadata(fileobj=StringIO(data),
+                                                  scheme=scheme)
+                    self.validate()
+
+    common_keys = set(('name', 'version', 'license', 'keywords', 'summary'))
+
+    none_list = (None, list)
+    none_dict = (None, dict)
+
+    mapped_keys = {
+        'run_requires': ('Requires-Dist', list),
+        'build_requires': ('Setup-Requires-Dist', list),
+        'dev_requires': none_list,
+        'test_requires': none_list,
+        'meta_requires': none_list,
+        'extras': ('Provides-Extra', list),
+        'modules': none_list,
+        'namespaces': none_list,
+        'exports': none_dict,
+        'commands': none_dict,
+        'classifiers': ('Classifier', list),
+        'source_url': ('Download-URL', None),
+        'metadata_version': ('Metadata-Version', None),
+    }
+
+    del none_list, none_dict
+
+    def __getattribute__(self, key):
+        common = object.__getattribute__(self, 'common_keys')
+        mapped = object.__getattribute__(self, 'mapped_keys')
+        if key in mapped:
+            lk, maker = mapped[key]
+            if self._legacy:
+                if lk is None:
+                    result = None if maker is None else maker()
+                else:
+                    result = self._legacy.get(lk)
+            else:
+                value = None if maker is None else maker()
+                if key not in ('commands', 'exports', 'modules', 'namespaces',
+                               'classifiers'):
+                    result = self._data.get(key, value)
+                else:
+                    # special cases for PEP 459
+                    sentinel = object()
+                    result = sentinel
+                    d = self._data.get('extensions')
+                    if d:
+                        if key == 'commands':
+                            result = d.get('python.commands', value)
+                        elif key == 'classifiers':
+                            d = d.get('python.details')
+                            if d:
+                                result = d.get(key, value)
+                        else:
+                            d = d.get('python.exports')
+                            if not d:
+                                d = self._data.get('python.exports')
+                            if d:
+                                result = d.get(key, value)
+                    if result is sentinel:
+                        result = value
+        elif key not in common:
+            result = object.__getattribute__(self, key)
+        elif self._legacy:
+            result = self._legacy.get(key)
+        else:
+            result = self._data.get(key)
+        return result
+
+    def _validate_value(self, key, value, scheme=None):
+        if key in self.SYNTAX_VALIDATORS:
+            pattern, exclusions = self.SYNTAX_VALIDATORS[key]
+            if (scheme or self.scheme) not in exclusions:
+                m = pattern.match(value)
+                if not m:
+                    raise MetadataInvalidError("'%s' is an invalid value for "
+                                               "the '%s' property" % (value,
+                                                                    key))
+
+    def __setattr__(self, key, value):
+        self._validate_value(key, value)
+        common = object.__getattribute__(self, 'common_keys')
+        mapped = object.__getattribute__(self, 'mapped_keys')
+        if key in mapped:
+            lk, _ = mapped[key]
+            if self._legacy:
+                if lk is None:
+                    raise NotImplementedError
+                self._legacy[lk] = value
+            elif key not in ('commands', 'exports', 'modules', 'namespaces',
+                             'classifiers'):
+                self._data[key] = value
+            else:
+                # special cases for PEP 459
+                d = self._data.setdefault('extensions', {})
+                if key == 'commands':
+                    d['python.commands'] = value
+                elif key == 'classifiers':
+                    d = d.setdefault('python.details', {})
+                    d[key] = value
+                else:
+                    d = d.setdefault('python.exports', {})
+                    d[key] = value
+        elif key not in common:
+            object.__setattr__(self, key, value)
+        else:
+            if key == 'keywords':
+                if isinstance(value, string_types):
+                    value = value.strip()
+                    if value:
+                        value = value.split()
+                    else:
+                        value = []
+            if self._legacy:
+                self._legacy[key] = value
+            else:
+                self._data[key] = value
+
+    @property
+    def name_and_version(self):
+        return _get_name_and_version(self.name, self.version, True)
+
+    @property
+    def provides(self):
+        if self._legacy:
+            result = self._legacy['Provides-Dist']
+        else:
+            result = self._data.setdefault('provides', [])
+        s = '%s (%s)' % (self.name, self.version)
+        if s not in result:
+            result.append(s)
+        return result
+
+    @provides.setter
+    def provides(self, value):
+        if self._legacy:
+            self._legacy['Provides-Dist'] = value
+        else:
+            self._data['provides'] = value
+
+    def get_requirements(self, reqts, extras=None, env=None):
+        """
+        Base method to get dependencies, given a set of extras
+        to satisfy and an optional environment context.
+        :param reqts: A list of sometimes-wanted dependencies,
+                      perhaps dependent on extras and environment.
+        :param extras: A list of optional components being requested.
+        :param env: An optional environment for marker evaluation.
+        """
+        if self._legacy:
+            result = reqts
+        else:
+            result = []
+            extras = get_extras(extras or [], self.extras)
+            for d in reqts:
+                if 'extra' not in d and 'environment' not in d:
+                    # unconditional
+                    include = True
+                else:
+                    if 'extra' not in d:
+                        # Not extra-dependent - only environment-dependent
+                        include = True
+                    else:
+                        include = d.get('extra') in extras
+                    if include:
+                        # Not excluded because of extras, check environment
+                        marker = d.get('environment')
+                        if marker:
+                            include = interpret(marker, env)
+                if include:
+                    result.extend(d['requires'])
+            for key in ('build', 'dev', 'test'):
+                e = ':%s:' % key
+                if e in extras:
+                    extras.remove(e)
+                    # A recursive call, but it should terminate since 'test'
+                    # has been removed from the extras
+                    reqts = self._data.get('%s_requires' % key, [])
+                    result.extend(self.get_requirements(reqts, extras=extras,
+                                                        env=env))
+        return result
+
+    @property
+    def dictionary(self):
+        if self._legacy:
+            return self._from_legacy()
+        return self._data
+
+    @property
+    def dependencies(self):
+        if self._legacy:
+            raise NotImplementedError
+        else:
+            return extract_by_key(self._data, self.DEPENDENCY_KEYS)
+
+    @dependencies.setter
+    def dependencies(self, value):
+        if self._legacy:
+            raise NotImplementedError
+        else:
+            self._data.update(value)
+
+    def _validate_mapping(self, mapping, scheme):
+        if mapping.get('metadata_version') != self.METADATA_VERSION:
+            raise MetadataUnrecognizedVersionError()
+        missing = []
+        for key, exclusions in self.MANDATORY_KEYS.items():
+            if key not in mapping:
+                if scheme not in exclusions:
+                    missing.append(key)
+        if missing:
+            msg = 'Missing metadata items: %s' % ', '.join(missing)
+            raise MetadataMissingError(msg)
+        for k, v in mapping.items():
+            self._validate_value(k, v, scheme)
+
+    def validate(self):
+        if self._legacy:
+            missing, warnings = self._legacy.check(True)
+            if missing or warnings:
+                logger.warning('Metadata: missing: %s, warnings: %s',
+                               missing, warnings)
+        else:
+            self._validate_mapping(self._data, self.scheme)
+
+    def todict(self):
+        if self._legacy:
+            return self._legacy.todict(True)
+        else:
+            result = extract_by_key(self._data, self.INDEX_KEYS)
+            return result
+
+    def _from_legacy(self):
+        assert self._legacy and not self._data
+        result = {
+            'metadata_version': self.METADATA_VERSION,
+            'generator': self.GENERATOR,
+        }
+        lmd = self._legacy.todict(True)     # skip missing ones
+        for k in ('name', 'version', 'license', 'summary', 'description',
+                  'classifier'):
+            if k in lmd:
+                if k == 'classifier':
+                    nk = 'classifiers'
+                else:
+                    nk = k
+                result[nk] = lmd[k]
+        kw = lmd.get('Keywords', [])
+        if kw == ['']:
+            kw = []
+        result['keywords'] = kw
+        keys = (('requires_dist', 'run_requires'),
+                ('setup_requires_dist', 'build_requires'))
+        for ok, nk in keys:
+            if ok in lmd and lmd[ok]:
+                result[nk] = [{'requires': lmd[ok]}]
+        result['provides'] = self.provides
+        author = {}
+        maintainer = {}
+        return result
+
+    LEGACY_MAPPING = {
+        'name': 'Name',
+        'version': 'Version',
+        'license': 'License',
+        'summary': 'Summary',
+        'description': 'Description',
+        'classifiers': 'Classifier',
+    }
+
+    def _to_legacy(self):
+        def process_entries(entries):
+            reqts = set()
+            for e in entries:
+                extra = e.get('extra')
+                env = e.get('environment')
+                rlist = e['requires']
+                for r in rlist:
+                    if not env and not extra:
+                        reqts.add(r)
+                    else:
+                        marker = ''
+                        if extra:
+                            marker = 'extra == "%s"' % extra
+                        if env:
+                            if marker:
+                                marker = '(%s) and %s' % (env, marker)
+                            else:
+                                marker = env
+                        reqts.add(';'.join((r, marker)))
+            return reqts
+
+        assert self._data and not self._legacy
+        result = LegacyMetadata()
+        nmd = self._data
+        for nk, ok in self.LEGACY_MAPPING.items():
+            if nk in nmd:
+                result[ok] = nmd[nk]
+        r1 = process_entries(self.run_requires + self.meta_requires)
+        r2 = process_entries(self.build_requires + self.dev_requires)
+        if self.extras:
+            result['Provides-Extra'] = sorted(self.extras)
+        result['Requires-Dist'] = sorted(r1)
+        result['Setup-Requires-Dist'] = sorted(r2)
+        # TODO: other fields such as contacts
+        return result
+
+    def write(self, path=None, fileobj=None, legacy=False, skip_unknown=True):
+        if [path, fileobj].count(None) != 1:
+            raise ValueError('Exactly one of path and fileobj is needed')
+        self.validate()
+        if legacy:
+            if self._legacy:
+                legacy_md = self._legacy
+            else:
+                legacy_md = self._to_legacy()
+            if path:
+                legacy_md.write(path, skip_unknown=skip_unknown)
+            else:
+                legacy_md.write_file(fileobj, skip_unknown=skip_unknown)
+        else:
+            if self._legacy:
+                d = self._from_legacy()
+            else:
+                d = self._data
+            if fileobj:
+                json.dump(d, fileobj, ensure_ascii=True, indent=2,
+                          sort_keys=True)
+            else:
+                with codecs.open(path, 'w', 'utf-8') as f:
+                    json.dump(d, f, ensure_ascii=True, indent=2,
+                              sort_keys=True)
+
+    def add_requirements(self, requirements):
+        if self._legacy:
+            self._legacy.add_requirements(requirements)
+        else:
+            run_requires = self._data.setdefault('run_requires', [])
+            always = None
+            for entry in run_requires:
+                if 'environment' not in entry and 'extra' not in entry:
+                    always = entry
+                    break
+            if always is None:
+                always = { 'requires': requirements }
+                run_requires.insert(0, always)
+            else:
+                rset = set(always['requires']) | set(requirements)
+                always['requires'] = sorted(rset)
+
+    def __repr__(self):
+        name = self.name or '(no name)'
+        version = self.version or 'no version'
+        return '<%s %s %s (%s)>' % (self.__class__.__name__,
+                                    self.metadata_version, name, version)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/resources.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/resources.py
new file mode 100644
index 0000000000000000000000000000000000000000..18840167a9e3ea1cf443b0803230e41481df41d2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/resources.py
@@ -0,0 +1,355 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013-2017 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+from __future__ import unicode_literals
+
+import bisect
+import io
+import logging
+import os
+import pkgutil
+import shutil
+import sys
+import types
+import zipimport
+
+from . import DistlibException
+from .util import cached_property, get_cache_base, path_to_cache_dir, Cache
+
+logger = logging.getLogger(__name__)
+
+
+cache = None    # created when needed
+
+
+class ResourceCache(Cache):
+    def __init__(self, base=None):
+        if base is None:
+            # Use native string to avoid issues on 2.x: see Python #20140.
+            base = os.path.join(get_cache_base(), str('resource-cache'))
+        super(ResourceCache, self).__init__(base)
+
+    def is_stale(self, resource, path):
+        """
+        Is the cache stale for the given resource?
+
+        :param resource: The :class:`Resource` being cached.
+        :param path: The path of the resource in the cache.
+        :return: True if the cache is stale.
+        """
+        # Cache invalidation is a hard problem :-)
+        return True
+
+    def get(self, resource):
+        """
+        Get a resource into the cache,
+
+        :param resource: A :class:`Resource` instance.
+        :return: The pathname of the resource in the cache.
+        """
+        prefix, path = resource.finder.get_cache_info(resource)
+        if prefix is None:
+            result = path
+        else:
+            result = os.path.join(self.base, self.prefix_to_dir(prefix), path)
+            dirname = os.path.dirname(result)
+            if not os.path.isdir(dirname):
+                os.makedirs(dirname)
+            if not os.path.exists(result):
+                stale = True
+            else:
+                stale = self.is_stale(resource, path)
+            if stale:
+                # write the bytes of the resource to the cache location
+                with open(result, 'wb') as f:
+                    f.write(resource.bytes)
+        return result
+
+
+class ResourceBase(object):
+    def __init__(self, finder, name):
+        self.finder = finder
+        self.name = name
+
+
+class Resource(ResourceBase):
+    """
+    A class representing an in-package resource, such as a data file. This is
+    not normally instantiated by user code, but rather by a
+    :class:`ResourceFinder` which manages the resource.
+    """
+    is_container = False        # Backwards compatibility
+
+    def as_stream(self):
+        """
+        Get the resource as a stream.
+
+        This is not a property to make it obvious that it returns a new stream
+        each time.
+        """
+        return self.finder.get_stream(self)
+
+    @cached_property
+    def file_path(self):
+        global cache
+        if cache is None:
+            cache = ResourceCache()
+        return cache.get(self)
+
+    @cached_property
+    def bytes(self):
+        return self.finder.get_bytes(self)
+
+    @cached_property
+    def size(self):
+        return self.finder.get_size(self)
+
+
+class ResourceContainer(ResourceBase):
+    is_container = True     # Backwards compatibility
+
+    @cached_property
+    def resources(self):
+        return self.finder.get_resources(self)
+
+
+class ResourceFinder(object):
+    """
+    Resource finder for file system resources.
+    """
+
+    if sys.platform.startswith('java'):
+        skipped_extensions = ('.pyc', '.pyo', '.class')
+    else:
+        skipped_extensions = ('.pyc', '.pyo')
+
+    def __init__(self, module):
+        self.module = module
+        self.loader = getattr(module, '__loader__', None)
+        self.base = os.path.dirname(getattr(module, '__file__', ''))
+
+    def _adjust_path(self, path):
+        return os.path.realpath(path)
+
+    def _make_path(self, resource_name):
+        # Issue #50: need to preserve type of path on Python 2.x
+        # like os.path._get_sep
+        if isinstance(resource_name, bytes):    # should only happen on 2.x
+            sep = b'/'
+        else:
+            sep = '/'
+        parts = resource_name.split(sep)
+        parts.insert(0, self.base)
+        result = os.path.join(*parts)
+        return self._adjust_path(result)
+
+    def _find(self, path):
+        return os.path.exists(path)
+
+    def get_cache_info(self, resource):
+        return None, resource.path
+
+    def find(self, resource_name):
+        path = self._make_path(resource_name)
+        if not self._find(path):
+            result = None
+        else:
+            if self._is_directory(path):
+                result = ResourceContainer(self, resource_name)
+            else:
+                result = Resource(self, resource_name)
+            result.path = path
+        return result
+
+    def get_stream(self, resource):
+        return open(resource.path, 'rb')
+
+    def get_bytes(self, resource):
+        with open(resource.path, 'rb') as f:
+            return f.read()
+
+    def get_size(self, resource):
+        return os.path.getsize(resource.path)
+
+    def get_resources(self, resource):
+        def allowed(f):
+            return (f != '__pycache__' and not
+                    f.endswith(self.skipped_extensions))
+        return set([f for f in os.listdir(resource.path) if allowed(f)])
+
+    def is_container(self, resource):
+        return self._is_directory(resource.path)
+
+    _is_directory = staticmethod(os.path.isdir)
+
+    def iterator(self, resource_name):
+        resource = self.find(resource_name)
+        if resource is not None:
+            todo = [resource]
+            while todo:
+                resource = todo.pop(0)
+                yield resource
+                if resource.is_container:
+                    rname = resource.name
+                    for name in resource.resources:
+                        if not rname:
+                            new_name = name
+                        else:
+                            new_name = '/'.join([rname, name])
+                        child = self.find(new_name)
+                        if child.is_container:
+                            todo.append(child)
+                        else:
+                            yield child
+
+
+class ZipResourceFinder(ResourceFinder):
+    """
+    Resource finder for resources in .zip files.
+    """
+    def __init__(self, module):
+        super(ZipResourceFinder, self).__init__(module)
+        archive = self.loader.archive
+        self.prefix_len = 1 + len(archive)
+        # PyPy doesn't have a _files attr on zipimporter, and you can't set one
+        if hasattr(self.loader, '_files'):
+            self._files = self.loader._files
+        else:
+            self._files = zipimport._zip_directory_cache[archive]
+        self.index = sorted(self._files)
+
+    def _adjust_path(self, path):
+        return path
+
+    def _find(self, path):
+        path = path[self.prefix_len:]
+        if path in self._files:
+            result = True
+        else:
+            if path and path[-1] != os.sep:
+                path = path + os.sep
+            i = bisect.bisect(self.index, path)
+            try:
+                result = self.index[i].startswith(path)
+            except IndexError:
+                result = False
+        if not result:
+            logger.debug('_find failed: %r %r', path, self.loader.prefix)
+        else:
+            logger.debug('_find worked: %r %r', path, self.loader.prefix)
+        return result
+
+    def get_cache_info(self, resource):
+        prefix = self.loader.archive
+        path = resource.path[1 + len(prefix):]
+        return prefix, path
+
+    def get_bytes(self, resource):
+        return self.loader.get_data(resource.path)
+
+    def get_stream(self, resource):
+        return io.BytesIO(self.get_bytes(resource))
+
+    def get_size(self, resource):
+        path = resource.path[self.prefix_len:]
+        return self._files[path][3]
+
+    def get_resources(self, resource):
+        path = resource.path[self.prefix_len:]
+        if path and path[-1] != os.sep:
+            path += os.sep
+        plen = len(path)
+        result = set()
+        i = bisect.bisect(self.index, path)
+        while i < len(self.index):
+            if not self.index[i].startswith(path):
+                break
+            s = self.index[i][plen:]
+            result.add(s.split(os.sep, 1)[0])   # only immediate children
+            i += 1
+        return result
+
+    def _is_directory(self, path):
+        path = path[self.prefix_len:]
+        if path and path[-1] != os.sep:
+            path += os.sep
+        i = bisect.bisect(self.index, path)
+        try:
+            result = self.index[i].startswith(path)
+        except IndexError:
+            result = False
+        return result
+
+_finder_registry = {
+    type(None): ResourceFinder,
+    zipimport.zipimporter: ZipResourceFinder
+}
+
+try:
+    # In Python 3.6, _frozen_importlib -> _frozen_importlib_external
+    try:
+        import _frozen_importlib_external as _fi
+    except ImportError:
+        import _frozen_importlib as _fi
+    _finder_registry[_fi.SourceFileLoader] = ResourceFinder
+    _finder_registry[_fi.FileFinder] = ResourceFinder
+    del _fi
+except (ImportError, AttributeError):
+    pass
+
+
+def register_finder(loader, finder_maker):
+    _finder_registry[type(loader)] = finder_maker
+
+_finder_cache = {}
+
+
+def finder(package):
+    """
+    Return a resource finder for a package.
+    :param package: The name of the package.
+    :return: A :class:`ResourceFinder` instance for the package.
+    """
+    if package in _finder_cache:
+        result = _finder_cache[package]
+    else:
+        if package not in sys.modules:
+            __import__(package)
+        module = sys.modules[package]
+        path = getattr(module, '__path__', None)
+        if path is None:
+            raise DistlibException('You cannot get a finder for a module, '
+                                   'only for a package')
+        loader = getattr(module, '__loader__', None)
+        finder_maker = _finder_registry.get(type(loader))
+        if finder_maker is None:
+            raise DistlibException('Unable to locate finder for %r' % package)
+        result = finder_maker(module)
+        _finder_cache[package] = result
+    return result
+
+
+_dummy_module = types.ModuleType(str('__dummy__'))
+
+
+def finder_for_path(path):
+    """
+    Return a resource finder for a path, which should represent a container.
+
+    :param path: The path.
+    :return: A :class:`ResourceFinder` instance for the path.
+    """
+    result = None
+    # calls any path hooks, gets importer into cache
+    pkgutil.get_importer(path)
+    loader = sys.path_importer_cache.get(path)
+    finder = _finder_registry.get(type(loader))
+    if finder:
+        module = _dummy_module
+        module.__file__ = os.path.join(path, '')
+        module.__loader__ = loader
+        result = finder(module)
+    return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/scripts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/scripts.py
new file mode 100644
index 0000000000000000000000000000000000000000..51859741867d195f91d8ba84b87baa37d0c4a8f0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/scripts.py
@@ -0,0 +1,416 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013-2015 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+from io import BytesIO
+import logging
+import os
+import re
+import struct
+import sys
+
+from .compat import sysconfig, detect_encoding, ZipFile
+from .resources import finder
+from .util import (FileOperator, get_export_entry, convert_path,
+                   get_executable, in_venv)
+
+logger = logging.getLogger(__name__)
+
+_DEFAULT_MANIFEST = '''
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+ <assemblyIdentity version="1.0.0.0"
+ processorArchitecture="X86"
+ name="%s"
+ type="win32"/>
+
+ <!-- Identify the application security requirements. -->
+ <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
+ <security>
+ <requestedPrivileges>
+ <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
+ </requestedPrivileges>
+ </security>
+ </trustInfo>
+</assembly>'''.strip()
+
+# check if Python is called on the first line with this expression
+FIRST_LINE_RE = re.compile(b'^#!.*pythonw?[0-9.]*([ \t].*)?$')
+SCRIPT_TEMPLATE = r'''# -*- coding: utf-8 -*-
+import re
+import sys
+from %(module)s import %(import_name)s
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(%(func)s())
+'''
+
+
+def _enquote_executable(executable):
+    if ' ' in executable:
+        # make sure we quote only the executable in case of env
+        # for example /usr/bin/env "/dir with spaces/bin/jython"
+        # instead of "/usr/bin/env /dir with spaces/bin/jython"
+        # otherwise whole
+        if executable.startswith('/usr/bin/env '):
+            env, _executable = executable.split(' ', 1)
+            if ' ' in _executable and not _executable.startswith('"'):
+                executable = '%s "%s"' % (env, _executable)
+        else:
+            if not executable.startswith('"'):
+                executable = '"%s"' % executable
+    return executable
+
+
+class ScriptMaker(object):
+    """
+    A class to copy or create scripts from source scripts or callable
+    specifications.
+    """
+    script_template = SCRIPT_TEMPLATE
+
+    executable = None  # for shebangs
+
+    def __init__(self, source_dir, target_dir, add_launchers=True,
+                 dry_run=False, fileop=None):
+        self.source_dir = source_dir
+        self.target_dir = target_dir
+        self.add_launchers = add_launchers
+        self.force = False
+        self.clobber = False
+        # It only makes sense to set mode bits on POSIX.
+        self.set_mode = (os.name == 'posix') or (os.name == 'java' and
+                                                 os._name == 'posix')
+        self.variants = set(('', 'X.Y'))
+        self._fileop = fileop or FileOperator(dry_run)
+
+        self._is_nt = os.name == 'nt' or (
+            os.name == 'java' and os._name == 'nt')
+
+    def _get_alternate_executable(self, executable, options):
+        if options.get('gui', False) and self._is_nt:  # pragma: no cover
+            dn, fn = os.path.split(executable)
+            fn = fn.replace('python', 'pythonw')
+            executable = os.path.join(dn, fn)
+        return executable
+
+    if sys.platform.startswith('java'):  # pragma: no cover
+        def _is_shell(self, executable):
+            """
+            Determine if the specified executable is a script
+            (contains a #! line)
+            """
+            try:
+                with open(executable) as fp:
+                    return fp.read(2) == '#!'
+            except (OSError, IOError):
+                logger.warning('Failed to open %s', executable)
+                return False
+
+        def _fix_jython_executable(self, executable):
+            if self._is_shell(executable):
+                # Workaround for Jython is not needed on Linux systems.
+                import java
+
+                if java.lang.System.getProperty('os.name') == 'Linux':
+                    return executable
+            elif executable.lower().endswith('jython.exe'):
+                # Use wrapper exe for Jython on Windows
+                return executable
+            return '/usr/bin/env %s' % executable
+
+    def _build_shebang(self, executable, post_interp):
+        """
+        Build a shebang line. In the simple case (on Windows, or a shebang line
+        which is not too long or contains spaces) use a simple formulation for
+        the shebang. Otherwise, use /bin/sh as the executable, with a contrived
+        shebang which allows the script to run either under Python or sh, using
+        suitable quoting. Thanks to Harald Nordgren for his input.
+
+        See also: http://www.in-ulm.de/~mascheck/various/shebang/#length
+                  https://hg.mozilla.org/mozilla-central/file/tip/mach
+        """
+        if os.name != 'posix':
+            simple_shebang = True
+        else:
+            # Add 3 for '#!' prefix and newline suffix.
+            shebang_length = len(executable) + len(post_interp) + 3
+            if sys.platform == 'darwin':
+                max_shebang_length = 512
+            else:
+                max_shebang_length = 127
+            simple_shebang = ((b' ' not in executable) and
+                              (shebang_length <= max_shebang_length))
+
+        if simple_shebang:
+            result = b'#!' + executable + post_interp + b'\n'
+        else:
+            result = b'#!/bin/sh\n'
+            result += b"'''exec' " + executable + post_interp + b' "$0" "$@"\n'
+            result += b"' '''"
+        return result
+
+    def _get_shebang(self, encoding, post_interp=b'', options=None):
+        enquote = True
+        if self.executable:
+            executable = self.executable
+            enquote = False     # assume this will be taken care of
+        elif not sysconfig.is_python_build():
+            executable = get_executable()
+        elif in_venv():  # pragma: no cover
+            executable = os.path.join(sysconfig.get_path('scripts'),
+                            'python%s' % sysconfig.get_config_var('EXE'))
+        else:  # pragma: no cover
+            executable = os.path.join(
+                sysconfig.get_config_var('BINDIR'),
+               'python%s%s' % (sysconfig.get_config_var('VERSION'),
+                               sysconfig.get_config_var('EXE')))
+        if options:
+            executable = self._get_alternate_executable(executable, options)
+
+        if sys.platform.startswith('java'):  # pragma: no cover
+            executable = self._fix_jython_executable(executable)
+
+        # Normalise case for Windows - COMMENTED OUT
+        # executable = os.path.normcase(executable)
+        # N.B. The normalising operation above has been commented out: See
+        # issue #124. Although paths in Windows are generally case-insensitive,
+        # they aren't always. For example, a path containing a ẞ (which is a
+        # LATIN CAPITAL LETTER SHARP S - U+1E9E) is normcased to ß (which is a
+        # LATIN SMALL LETTER SHARP S' - U+00DF). The two are not considered by
+        # Windows as equivalent in path names.
+
+        # If the user didn't specify an executable, it may be necessary to
+        # cater for executable paths with spaces (not uncommon on Windows)
+        if enquote:
+            executable = _enquote_executable(executable)
+        # Issue #51: don't use fsencode, since we later try to
+        # check that the shebang is decodable using utf-8.
+        executable = executable.encode('utf-8')
+        # in case of IronPython, play safe and enable frames support
+        if (sys.platform == 'cli' and '-X:Frames' not in post_interp
+            and '-X:FullFrames' not in post_interp):  # pragma: no cover
+            post_interp += b' -X:Frames'
+        shebang = self._build_shebang(executable, post_interp)
+        # Python parser starts to read a script using UTF-8 until
+        # it gets a #coding:xxx cookie. The shebang has to be the
+        # first line of a file, the #coding:xxx cookie cannot be
+        # written before. So the shebang has to be decodable from
+        # UTF-8.
+        try:
+            shebang.decode('utf-8')
+        except UnicodeDecodeError:  # pragma: no cover
+            raise ValueError(
+                'The shebang (%r) is not decodable from utf-8' % shebang)
+        # If the script is encoded to a custom encoding (use a
+        # #coding:xxx cookie), the shebang has to be decodable from
+        # the script encoding too.
+        if encoding != 'utf-8':
+            try:
+                shebang.decode(encoding)
+            except UnicodeDecodeError:  # pragma: no cover
+                raise ValueError(
+                    'The shebang (%r) is not decodable '
+                    'from the script encoding (%r)' % (shebang, encoding))
+        return shebang
+
+    def _get_script_text(self, entry):
+        return self.script_template % dict(module=entry.prefix,
+                                           import_name=entry.suffix.split('.')[0],
+                                           func=entry.suffix)
+
+    manifest = _DEFAULT_MANIFEST
+
+    def get_manifest(self, exename):
+        base = os.path.basename(exename)
+        return self.manifest % base
+
+    def _write_script(self, names, shebang, script_bytes, filenames, ext):
+        use_launcher = self.add_launchers and self._is_nt
+        linesep = os.linesep.encode('utf-8')
+        if not shebang.endswith(linesep):
+            shebang += linesep
+        if not use_launcher:
+            script_bytes = shebang + script_bytes
+        else:  # pragma: no cover
+            if ext == 'py':
+                launcher = self._get_launcher('t')
+            else:
+                launcher = self._get_launcher('w')
+            stream = BytesIO()
+            with ZipFile(stream, 'w') as zf:
+                zf.writestr('__main__.py', script_bytes)
+            zip_data = stream.getvalue()
+            script_bytes = launcher + shebang + zip_data
+        for name in names:
+            outname = os.path.join(self.target_dir, name)
+            if use_launcher:  # pragma: no cover
+                n, e = os.path.splitext(outname)
+                if e.startswith('.py'):
+                    outname = n
+                outname = '%s.exe' % outname
+                try:
+                    self._fileop.write_binary_file(outname, script_bytes)
+                except Exception:
+                    # Failed writing an executable - it might be in use.
+                    logger.warning('Failed to write executable - trying to '
+                                   'use .deleteme logic')
+                    dfname = '%s.deleteme' % outname
+                    if os.path.exists(dfname):
+                        os.remove(dfname)       # Not allowed to fail here
+                    os.rename(outname, dfname)  # nor here
+                    self._fileop.write_binary_file(outname, script_bytes)
+                    logger.debug('Able to replace executable using '
+                                 '.deleteme logic')
+                    try:
+                        os.remove(dfname)
+                    except Exception:
+                        pass    # still in use - ignore error
+            else:
+                if self._is_nt and not outname.endswith('.' + ext):  # pragma: no cover
+                    outname = '%s.%s' % (outname, ext)
+                if os.path.exists(outname) and not self.clobber:
+                    logger.warning('Skipping existing file %s', outname)
+                    continue
+                self._fileop.write_binary_file(outname, script_bytes)
+                if self.set_mode:
+                    self._fileop.set_executable_mode([outname])
+            filenames.append(outname)
+
+    def _make_script(self, entry, filenames, options=None):
+        post_interp = b''
+        if options:
+            args = options.get('interpreter_args', [])
+            if args:
+                args = ' %s' % ' '.join(args)
+                post_interp = args.encode('utf-8')
+        shebang = self._get_shebang('utf-8', post_interp, options=options)
+        script = self._get_script_text(entry).encode('utf-8')
+        name = entry.name
+        scriptnames = set()
+        if '' in self.variants:
+            scriptnames.add(name)
+        if 'X' in self.variants:
+            scriptnames.add('%s%s' % (name, sys.version_info[0]))
+        if 'X.Y' in self.variants:
+            scriptnames.add('%s-%s.%s' % (name, sys.version_info[0],
+                            sys.version_info[1]))
+        if options and options.get('gui', False):
+            ext = 'pyw'
+        else:
+            ext = 'py'
+        self._write_script(scriptnames, shebang, script, filenames, ext)
+
+    def _copy_script(self, script, filenames):
+        adjust = False
+        script = os.path.join(self.source_dir, convert_path(script))
+        outname = os.path.join(self.target_dir, os.path.basename(script))
+        if not self.force and not self._fileop.newer(script, outname):
+            logger.debug('not copying %s (up-to-date)', script)
+            return
+
+        # Always open the file, but ignore failures in dry-run mode --
+        # that way, we'll get accurate feedback if we can read the
+        # script.
+        try:
+            f = open(script, 'rb')
+        except IOError:  # pragma: no cover
+            if not self.dry_run:
+                raise
+            f = None
+        else:
+            first_line = f.readline()
+            if not first_line:  # pragma: no cover
+                logger.warning('%s: %s is an empty file (skipping)',
+                               self.get_command_name(),  script)
+                return
+
+            match = FIRST_LINE_RE.match(first_line.replace(b'\r\n', b'\n'))
+            if match:
+                adjust = True
+                post_interp = match.group(1) or b''
+
+        if not adjust:
+            if f:
+                f.close()
+            self._fileop.copy_file(script, outname)
+            if self.set_mode:
+                self._fileop.set_executable_mode([outname])
+            filenames.append(outname)
+        else:
+            logger.info('copying and adjusting %s -> %s', script,
+                        self.target_dir)
+            if not self._fileop.dry_run:
+                encoding, lines = detect_encoding(f.readline)
+                f.seek(0)
+                shebang = self._get_shebang(encoding, post_interp)
+                if b'pythonw' in first_line:  # pragma: no cover
+                    ext = 'pyw'
+                else:
+                    ext = 'py'
+                n = os.path.basename(outname)
+                self._write_script([n], shebang, f.read(), filenames, ext)
+            if f:
+                f.close()
+
+    @property
+    def dry_run(self):
+        return self._fileop.dry_run
+
+    @dry_run.setter
+    def dry_run(self, value):
+        self._fileop.dry_run = value
+
+    if os.name == 'nt' or (os.name == 'java' and os._name == 'nt'):  # pragma: no cover
+        # Executable launcher support.
+        # Launchers are from https://bitbucket.org/vinay.sajip/simple_launcher/
+
+        def _get_launcher(self, kind):
+            if struct.calcsize('P') == 8:   # 64-bit
+                bits = '64'
+            else:
+                bits = '32'
+            name = '%s%s.exe' % (kind, bits)
+            # Issue 31: don't hardcode an absolute package name, but
+            # determine it relative to the current package
+            distlib_package = __name__.rsplit('.', 1)[0]
+            resource = finder(distlib_package).find(name)
+            if not resource:
+                msg = ('Unable to find resource %s in package %s' % (name,
+                       distlib_package))
+                raise ValueError(msg)
+            return resource.bytes
+
+    # Public API follows
+
+    def make(self, specification, options=None):
+        """
+        Make a script.
+
+        :param specification: The specification, which is either a valid export
+                              entry specification (to make a script from a
+                              callable) or a filename (to make a script by
+                              copying from a source location).
+        :param options: A dictionary of options controlling script generation.
+        :return: A list of all absolute pathnames written to.
+        """
+        filenames = []
+        entry = get_export_entry(specification)
+        if entry is None:
+            self._copy_script(specification, filenames)
+        else:
+            self._make_script(entry, filenames, options=options)
+        return filenames
+
+    def make_multiple(self, specifications, options=None):
+        """
+        Take a list of specifications and make scripts from them,
+        :param specifications: A list of specifications.
+        :return: A list of all absolute pathnames written to,
+        """
+        filenames = []
+        for specification in specifications:
+            filenames.extend(self.make(specification, options))
+        return filenames
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/util.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..01324eae462f3384358a77e649b9c59a26cdfa9e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/util.py
@@ -0,0 +1,1761 @@
+#
+# Copyright (C) 2012-2017 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+import codecs
+from collections import deque
+import contextlib
+import csv
+from glob import iglob as std_iglob
+import io
+import json
+import logging
+import os
+import py_compile
+import re
+import socket
+try:
+    import ssl
+except ImportError:  # pragma: no cover
+    ssl = None
+import subprocess
+import sys
+import tarfile
+import tempfile
+import textwrap
+
+try:
+    import threading
+except ImportError:  # pragma: no cover
+    import dummy_threading as threading
+import time
+
+from . import DistlibException
+from .compat import (string_types, text_type, shutil, raw_input, StringIO,
+                     cache_from_source, urlopen, urljoin, httplib, xmlrpclib,
+                     splittype, HTTPHandler, BaseConfigurator, valid_ident,
+                     Container, configparser, URLError, ZipFile, fsdecode,
+                     unquote, urlparse)
+
+logger = logging.getLogger(__name__)
+
+#
+# Requirement parsing code as per PEP 508
+#
+
+IDENTIFIER = re.compile(r'^([\w\.-]+)\s*')
+VERSION_IDENTIFIER = re.compile(r'^([\w\.*+-]+)\s*')
+COMPARE_OP = re.compile(r'^(<=?|>=?|={2,3}|[~!]=)\s*')
+MARKER_OP = re.compile(r'^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*')
+OR = re.compile(r'^or\b\s*')
+AND = re.compile(r'^and\b\s*')
+NON_SPACE = re.compile(r'(\S+)\s*')
+STRING_CHUNK = re.compile(r'([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)')
+
+
+def parse_marker(marker_string):
+    """
+    Parse a marker string and return a dictionary containing a marker expression.
+
+    The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in
+    the expression grammar, or strings. A string contained in quotes is to be
+    interpreted as a literal string, and a string not contained in quotes is a
+    variable (such as os_name).
+    """
+    def marker_var(remaining):
+        # either identifier, or literal string
+        m = IDENTIFIER.match(remaining)
+        if m:
+            result = m.groups()[0]
+            remaining = remaining[m.end():]
+        elif not remaining:
+            raise SyntaxError('unexpected end of input')
+        else:
+            q = remaining[0]
+            if q not in '\'"':
+                raise SyntaxError('invalid expression: %s' % remaining)
+            oq = '\'"'.replace(q, '')
+            remaining = remaining[1:]
+            parts = [q]
+            while remaining:
+                # either a string chunk, or oq, or q to terminate
+                if remaining[0] == q:
+                    break
+                elif remaining[0] == oq:
+                    parts.append(oq)
+                    remaining = remaining[1:]
+                else:
+                    m = STRING_CHUNK.match(remaining)
+                    if not m:
+                        raise SyntaxError('error in string literal: %s' % remaining)
+                    parts.append(m.groups()[0])
+                    remaining = remaining[m.end():]
+            else:
+                s = ''.join(parts)
+                raise SyntaxError('unterminated string: %s' % s)
+            parts.append(q)
+            result = ''.join(parts)
+            remaining = remaining[1:].lstrip() # skip past closing quote
+        return result, remaining
+
+    def marker_expr(remaining):
+        if remaining and remaining[0] == '(':
+            result, remaining = marker(remaining[1:].lstrip())
+            if remaining[0] != ')':
+                raise SyntaxError('unterminated parenthesis: %s' % remaining)
+            remaining = remaining[1:].lstrip()
+        else:
+            lhs, remaining = marker_var(remaining)
+            while remaining:
+                m = MARKER_OP.match(remaining)
+                if not m:
+                    break
+                op = m.groups()[0]
+                remaining = remaining[m.end():]
+                rhs, remaining = marker_var(remaining)
+                lhs = {'op': op, 'lhs': lhs, 'rhs': rhs}
+            result = lhs
+        return result, remaining
+
+    def marker_and(remaining):
+        lhs, remaining = marker_expr(remaining)
+        while remaining:
+            m = AND.match(remaining)
+            if not m:
+                break
+            remaining = remaining[m.end():]
+            rhs, remaining = marker_expr(remaining)
+            lhs = {'op': 'and', 'lhs': lhs, 'rhs': rhs}
+        return lhs, remaining
+
+    def marker(remaining):
+        lhs, remaining = marker_and(remaining)
+        while remaining:
+            m = OR.match(remaining)
+            if not m:
+                break
+            remaining = remaining[m.end():]
+            rhs, remaining = marker_and(remaining)
+            lhs = {'op': 'or', 'lhs': lhs, 'rhs': rhs}
+        return lhs, remaining
+
+    return marker(marker_string)
+
+
+def parse_requirement(req):
+    """
+    Parse a requirement passed in as a string. Return a Container
+    whose attributes contain the various parts of the requirement.
+    """
+    remaining = req.strip()
+    if not remaining or remaining.startswith('#'):
+        return None
+    m = IDENTIFIER.match(remaining)
+    if not m:
+        raise SyntaxError('name expected: %s' % remaining)
+    distname = m.groups()[0]
+    remaining = remaining[m.end():]
+    extras = mark_expr = versions = uri = None
+    if remaining and remaining[0] == '[':
+        i = remaining.find(']', 1)
+        if i < 0:
+            raise SyntaxError('unterminated extra: %s' % remaining)
+        s = remaining[1:i]
+        remaining = remaining[i + 1:].lstrip()
+        extras = []
+        while s:
+            m = IDENTIFIER.match(s)
+            if not m:
+                raise SyntaxError('malformed extra: %s' % s)
+            extras.append(m.groups()[0])
+            s = s[m.end():]
+            if not s:
+                break
+            if s[0] != ',':
+                raise SyntaxError('comma expected in extras: %s' % s)
+            s = s[1:].lstrip()
+        if not extras:
+            extras = None
+    if remaining:
+        if remaining[0] == '@':
+            # it's a URI
+            remaining = remaining[1:].lstrip()
+            m = NON_SPACE.match(remaining)
+            if not m:
+                raise SyntaxError('invalid URI: %s' % remaining)
+            uri = m.groups()[0]
+            t = urlparse(uri)
+            # there are issues with Python and URL parsing, so this test
+            # is a bit crude. See bpo-20271, bpo-23505. Python doesn't
+            # always parse invalid URLs correctly - it should raise
+            # exceptions for malformed URLs
+            if not (t.scheme and t.netloc):
+                raise SyntaxError('Invalid URL: %s' % uri)
+            remaining = remaining[m.end():].lstrip()
+        else:
+
+            def get_versions(ver_remaining):
+                """
+                Return a list of operator, version tuples if any are
+                specified, else None.
+                """
+                m = COMPARE_OP.match(ver_remaining)
+                versions = None
+                if m:
+                    versions = []
+                    while True:
+                        op = m.groups()[0]
+                        ver_remaining = ver_remaining[m.end():]
+                        m = VERSION_IDENTIFIER.match(ver_remaining)
+                        if not m:
+                            raise SyntaxError('invalid version: %s' % ver_remaining)
+                        v = m.groups()[0]
+                        versions.append((op, v))
+                        ver_remaining = ver_remaining[m.end():]
+                        if not ver_remaining or ver_remaining[0] != ',':
+                            break
+                        ver_remaining = ver_remaining[1:].lstrip()
+                        m = COMPARE_OP.match(ver_remaining)
+                        if not m:
+                            raise SyntaxError('invalid constraint: %s' % ver_remaining)
+                    if not versions:
+                        versions = None
+                return versions, ver_remaining
+
+            if remaining[0] != '(':
+                versions, remaining = get_versions(remaining)
+            else:
+                i = remaining.find(')', 1)
+                if i < 0:
+                    raise SyntaxError('unterminated parenthesis: %s' % remaining)
+                s = remaining[1:i]
+                remaining = remaining[i + 1:].lstrip()
+                # As a special diversion from PEP 508, allow a version number
+                # a.b.c in parentheses as a synonym for ~= a.b.c (because this
+                # is allowed in earlier PEPs)
+                if COMPARE_OP.match(s):
+                    versions, _ = get_versions(s)
+                else:
+                    m = VERSION_IDENTIFIER.match(s)
+                    if not m:
+                        raise SyntaxError('invalid constraint: %s' % s)
+                    v = m.groups()[0]
+                    s = s[m.end():].lstrip()
+                    if s:
+                        raise SyntaxError('invalid constraint: %s' % s)
+                    versions = [('~=', v)]
+
+    if remaining:
+        if remaining[0] != ';':
+            raise SyntaxError('invalid requirement: %s' % remaining)
+        remaining = remaining[1:].lstrip()
+
+        mark_expr, remaining = parse_marker(remaining)
+
+    if remaining and remaining[0] != '#':
+        raise SyntaxError('unexpected trailing data: %s' % remaining)
+
+    if not versions:
+        rs = distname
+    else:
+        rs = '%s %s' % (distname, ', '.join(['%s %s' % con for con in versions]))
+    return Container(name=distname, extras=extras, constraints=versions,
+                     marker=mark_expr, url=uri, requirement=rs)
+
+
+def get_resources_dests(resources_root, rules):
+    """Find destinations for resources files"""
+
+    def get_rel_path(root, path):
+        # normalizes and returns a lstripped-/-separated path
+        root = root.replace(os.path.sep, '/')
+        path = path.replace(os.path.sep, '/')
+        assert path.startswith(root)
+        return path[len(root):].lstrip('/')
+
+    destinations = {}
+    for base, suffix, dest in rules:
+        prefix = os.path.join(resources_root, base)
+        for abs_base in iglob(prefix):
+            abs_glob = os.path.join(abs_base, suffix)
+            for abs_path in iglob(abs_glob):
+                resource_file = get_rel_path(resources_root, abs_path)
+                if dest is None:  # remove the entry if it was here
+                    destinations.pop(resource_file, None)
+                else:
+                    rel_path = get_rel_path(abs_base, abs_path)
+                    rel_dest = dest.replace(os.path.sep, '/').rstrip('/')
+                    destinations[resource_file] = rel_dest + '/' + rel_path
+    return destinations
+
+
+def in_venv():
+    if hasattr(sys, 'real_prefix'):
+        # virtualenv venvs
+        result = True
+    else:
+        # PEP 405 venvs
+        result = sys.prefix != getattr(sys, 'base_prefix', sys.prefix)
+    return result
+
+
+def get_executable():
+# The __PYVENV_LAUNCHER__ dance is apparently no longer needed, as
+# changes to the stub launcher mean that sys.executable always points
+# to the stub on OS X
+#    if sys.platform == 'darwin' and ('__PYVENV_LAUNCHER__'
+#                                     in os.environ):
+#        result =  os.environ['__PYVENV_LAUNCHER__']
+#    else:
+#        result = sys.executable
+#    return result
+    result = os.path.normcase(sys.executable)
+    if not isinstance(result, text_type):
+        result = fsdecode(result)
+    return result
+
+
+def proceed(prompt, allowed_chars, error_prompt=None, default=None):
+    p = prompt
+    while True:
+        s = raw_input(p)
+        p = prompt
+        if not s and default:
+            s = default
+        if s:
+            c = s[0].lower()
+            if c in allowed_chars:
+                break
+            if error_prompt:
+                p = '%c: %s\n%s' % (c, error_prompt, prompt)
+    return c
+
+
+def extract_by_key(d, keys):
+    if isinstance(keys, string_types):
+        keys = keys.split()
+    result = {}
+    for key in keys:
+        if key in d:
+            result[key] = d[key]
+    return result
+
+def read_exports(stream):
+    if sys.version_info[0] >= 3:
+        # needs to be a text stream
+        stream = codecs.getreader('utf-8')(stream)
+    # Try to load as JSON, falling back on legacy format
+    data = stream.read()
+    stream = StringIO(data)
+    try:
+        jdata = json.load(stream)
+        result = jdata['extensions']['python.exports']['exports']
+        for group, entries in result.items():
+            for k, v in entries.items():
+                s = '%s = %s' % (k, v)
+                entry = get_export_entry(s)
+                assert entry is not None
+                entries[k] = entry
+        return result
+    except Exception:
+        stream.seek(0, 0)
+
+    def read_stream(cp, stream):
+        if hasattr(cp, 'read_file'):
+            cp.read_file(stream)
+        else:
+            cp.readfp(stream)
+
+    cp = configparser.ConfigParser()
+    try:
+        read_stream(cp, stream)
+    except configparser.MissingSectionHeaderError:
+        stream.close()
+        data = textwrap.dedent(data)
+        stream = StringIO(data)
+        read_stream(cp, stream)
+
+    result = {}
+    for key in cp.sections():
+        result[key] = entries = {}
+        for name, value in cp.items(key):
+            s = '%s = %s' % (name, value)
+            entry = get_export_entry(s)
+            assert entry is not None
+            #entry.dist = self
+            entries[name] = entry
+    return result
+
+
+def write_exports(exports, stream):
+    if sys.version_info[0] >= 3:
+        # needs to be a text stream
+        stream = codecs.getwriter('utf-8')(stream)
+    cp = configparser.ConfigParser()
+    for k, v in exports.items():
+        # TODO check k, v for valid values
+        cp.add_section(k)
+        for entry in v.values():
+            if entry.suffix is None:
+                s = entry.prefix
+            else:
+                s = '%s:%s' % (entry.prefix, entry.suffix)
+            if entry.flags:
+                s = '%s [%s]' % (s, ', '.join(entry.flags))
+            cp.set(k, entry.name, s)
+    cp.write(stream)
+
+
+@contextlib.contextmanager
+def tempdir():
+    td = tempfile.mkdtemp()
+    try:
+        yield td
+    finally:
+        shutil.rmtree(td)
+
+@contextlib.contextmanager
+def chdir(d):
+    cwd = os.getcwd()
+    try:
+        os.chdir(d)
+        yield
+    finally:
+        os.chdir(cwd)
+
+
+@contextlib.contextmanager
+def socket_timeout(seconds=15):
+    cto = socket.getdefaulttimeout()
+    try:
+        socket.setdefaulttimeout(seconds)
+        yield
+    finally:
+        socket.setdefaulttimeout(cto)
+
+
+class cached_property(object):
+    def __init__(self, func):
+        self.func = func
+        #for attr in ('__name__', '__module__', '__doc__'):
+        #    setattr(self, attr, getattr(func, attr, None))
+
+    def __get__(self, obj, cls=None):
+        if obj is None:
+            return self
+        value = self.func(obj)
+        object.__setattr__(obj, self.func.__name__, value)
+        #obj.__dict__[self.func.__name__] = value = self.func(obj)
+        return value
+
+def convert_path(pathname):
+    """Return 'pathname' as a name that will work on the native filesystem.
+
+    The path is split on '/' and put back together again using the current
+    directory separator.  Needed because filenames in the setup script are
+    always supplied in Unix style, and have to be converted to the local
+    convention before we can actually use them in the filesystem.  Raises
+    ValueError on non-Unix-ish systems if 'pathname' either starts or
+    ends with a slash.
+    """
+    if os.sep == '/':
+        return pathname
+    if not pathname:
+        return pathname
+    if pathname[0] == '/':
+        raise ValueError("path '%s' cannot be absolute" % pathname)
+    if pathname[-1] == '/':
+        raise ValueError("path '%s' cannot end with '/'" % pathname)
+
+    paths = pathname.split('/')
+    while os.curdir in paths:
+        paths.remove(os.curdir)
+    if not paths:
+        return os.curdir
+    return os.path.join(*paths)
+
+
+class FileOperator(object):
+    def __init__(self, dry_run=False):
+        self.dry_run = dry_run
+        self.ensured = set()
+        self._init_record()
+
+    def _init_record(self):
+        self.record = False
+        self.files_written = set()
+        self.dirs_created = set()
+
+    def record_as_written(self, path):
+        if self.record:
+            self.files_written.add(path)
+
+    def newer(self, source, target):
+        """Tell if the target is newer than the source.
+
+        Returns true if 'source' exists and is more recently modified than
+        'target', or if 'source' exists and 'target' doesn't.
+
+        Returns false if both exist and 'target' is the same age or younger
+        than 'source'. Raise PackagingFileError if 'source' does not exist.
+
+        Note that this test is not very accurate: files created in the same
+        second will have the same "age".
+        """
+        if not os.path.exists(source):
+            raise DistlibException("file '%r' does not exist" %
+                                   os.path.abspath(source))
+        if not os.path.exists(target):
+            return True
+
+        return os.stat(source).st_mtime > os.stat(target).st_mtime
+
+    def copy_file(self, infile, outfile, check=True):
+        """Copy a file respecting dry-run and force flags.
+        """
+        self.ensure_dir(os.path.dirname(outfile))
+        logger.info('Copying %s to %s', infile, outfile)
+        if not self.dry_run:
+            msg = None
+            if check:
+                if os.path.islink(outfile):
+                    msg = '%s is a symlink' % outfile
+                elif os.path.exists(outfile) and not os.path.isfile(outfile):
+                    msg = '%s is a non-regular file' % outfile
+            if msg:
+                raise ValueError(msg + ' which would be overwritten')
+            shutil.copyfile(infile, outfile)
+        self.record_as_written(outfile)
+
+    def copy_stream(self, instream, outfile, encoding=None):
+        assert not os.path.isdir(outfile)
+        self.ensure_dir(os.path.dirname(outfile))
+        logger.info('Copying stream %s to %s', instream, outfile)
+        if not self.dry_run:
+            if encoding is None:
+                outstream = open(outfile, 'wb')
+            else:
+                outstream = codecs.open(outfile, 'w', encoding=encoding)
+            try:
+                shutil.copyfileobj(instream, outstream)
+            finally:
+                outstream.close()
+        self.record_as_written(outfile)
+
+    def write_binary_file(self, path, data):
+        self.ensure_dir(os.path.dirname(path))
+        if not self.dry_run:
+            if os.path.exists(path):
+                os.remove(path)
+            with open(path, 'wb') as f:
+                f.write(data)
+        self.record_as_written(path)
+
+    def write_text_file(self, path, data, encoding):
+        self.write_binary_file(path, data.encode(encoding))
+
+    def set_mode(self, bits, mask, files):
+        if os.name == 'posix' or (os.name == 'java' and os._name == 'posix'):
+            # Set the executable bits (owner, group, and world) on
+            # all the files specified.
+            for f in files:
+                if self.dry_run:
+                    logger.info("changing mode of %s", f)
+                else:
+                    mode = (os.stat(f).st_mode | bits) & mask
+                    logger.info("changing mode of %s to %o", f, mode)
+                    os.chmod(f, mode)
+
+    set_executable_mode = lambda s, f: s.set_mode(0o555, 0o7777, f)
+
+    def ensure_dir(self, path):
+        path = os.path.abspath(path)
+        if path not in self.ensured and not os.path.exists(path):
+            self.ensured.add(path)
+            d, f = os.path.split(path)
+            self.ensure_dir(d)
+            logger.info('Creating %s' % path)
+            if not self.dry_run:
+                os.mkdir(path)
+            if self.record:
+                self.dirs_created.add(path)
+
+    def byte_compile(self, path, optimize=False, force=False, prefix=None, hashed_invalidation=False):
+        dpath = cache_from_source(path, not optimize)
+        logger.info('Byte-compiling %s to %s', path, dpath)
+        if not self.dry_run:
+            if force or self.newer(path, dpath):
+                if not prefix:
+                    diagpath = None
+                else:
+                    assert path.startswith(prefix)
+                    diagpath = path[len(prefix):]
+            compile_kwargs = {}
+            if hashed_invalidation and hasattr(py_compile, 'PycInvalidationMode'):
+                compile_kwargs['invalidation_mode'] = py_compile.PycInvalidationMode.CHECKED_HASH
+            py_compile.compile(path, dpath, diagpath, True, **compile_kwargs)     # raise error
+        self.record_as_written(dpath)
+        return dpath
+
+    def ensure_removed(self, path):
+        if os.path.exists(path):
+            if os.path.isdir(path) and not os.path.islink(path):
+                logger.debug('Removing directory tree at %s', path)
+                if not self.dry_run:
+                    shutil.rmtree(path)
+                if self.record:
+                    if path in self.dirs_created:
+                        self.dirs_created.remove(path)
+            else:
+                if os.path.islink(path):
+                    s = 'link'
+                else:
+                    s = 'file'
+                logger.debug('Removing %s %s', s, path)
+                if not self.dry_run:
+                    os.remove(path)
+                if self.record:
+                    if path in self.files_written:
+                        self.files_written.remove(path)
+
+    def is_writable(self, path):
+        result = False
+        while not result:
+            if os.path.exists(path):
+                result = os.access(path, os.W_OK)
+                break
+            parent = os.path.dirname(path)
+            if parent == path:
+                break
+            path = parent
+        return result
+
+    def commit(self):
+        """
+        Commit recorded changes, turn off recording, return
+        changes.
+        """
+        assert self.record
+        result = self.files_written, self.dirs_created
+        self._init_record()
+        return result
+
+    def rollback(self):
+        if not self.dry_run:
+            for f in list(self.files_written):
+                if os.path.exists(f):
+                    os.remove(f)
+            # dirs should all be empty now, except perhaps for
+            # __pycache__ subdirs
+            # reverse so that subdirs appear before their parents
+            dirs = sorted(self.dirs_created, reverse=True)
+            for d in dirs:
+                flist = os.listdir(d)
+                if flist:
+                    assert flist == ['__pycache__']
+                    sd = os.path.join(d, flist[0])
+                    os.rmdir(sd)
+                os.rmdir(d)     # should fail if non-empty
+        self._init_record()
+
+def resolve(module_name, dotted_path):
+    if module_name in sys.modules:
+        mod = sys.modules[module_name]
+    else:
+        mod = __import__(module_name)
+    if dotted_path is None:
+        result = mod
+    else:
+        parts = dotted_path.split('.')
+        result = getattr(mod, parts.pop(0))
+        for p in parts:
+            result = getattr(result, p)
+    return result
+
+
+class ExportEntry(object):
+    def __init__(self, name, prefix, suffix, flags):
+        self.name = name
+        self.prefix = prefix
+        self.suffix = suffix
+        self.flags = flags
+
+    @cached_property
+    def value(self):
+        return resolve(self.prefix, self.suffix)
+
+    def __repr__(self):  # pragma: no cover
+        return '<ExportEntry %s = %s:%s %s>' % (self.name, self.prefix,
+                                                self.suffix, self.flags)
+
+    def __eq__(self, other):
+        if not isinstance(other, ExportEntry):
+            result = False
+        else:
+            result = (self.name == other.name and
+                      self.prefix == other.prefix and
+                      self.suffix == other.suffix and
+                      self.flags == other.flags)
+        return result
+
+    __hash__ = object.__hash__
+
+
+ENTRY_RE = re.compile(r'''(?P<name>(\w|[-.+])+)
+                      \s*=\s*(?P<callable>(\w+)([:\.]\w+)*)
+                      \s*(\[\s*(?P<flags>[\w-]+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])?
+                      ''', re.VERBOSE)
+
+def get_export_entry(specification):
+    m = ENTRY_RE.search(specification)
+    if not m:
+        result = None
+        if '[' in specification or ']' in specification:
+            raise DistlibException("Invalid specification "
+                                   "'%s'" % specification)
+    else:
+        d = m.groupdict()
+        name = d['name']
+        path = d['callable']
+        colons = path.count(':')
+        if colons == 0:
+            prefix, suffix = path, None
+        else:
+            if colons != 1:
+                raise DistlibException("Invalid specification "
+                                       "'%s'" % specification)
+            prefix, suffix = path.split(':')
+        flags = d['flags']
+        if flags is None:
+            if '[' in specification or ']' in specification:
+                raise DistlibException("Invalid specification "
+                                       "'%s'" % specification)
+            flags = []
+        else:
+            flags = [f.strip() for f in flags.split(',')]
+        result = ExportEntry(name, prefix, suffix, flags)
+    return result
+
+
+def get_cache_base(suffix=None):
+    """
+    Return the default base location for distlib caches. If the directory does
+    not exist, it is created. Use the suffix provided for the base directory,
+    and default to '.distlib' if it isn't provided.
+
+    On Windows, if LOCALAPPDATA is defined in the environment, then it is
+    assumed to be a directory, and will be the parent directory of the result.
+    On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home
+    directory - using os.expanduser('~') - will be the parent directory of
+    the result.
+
+    The result is just the directory '.distlib' in the parent directory as
+    determined above, or with the name specified with ``suffix``.
+    """
+    if suffix is None:
+        suffix = '.distlib'
+    if os.name == 'nt' and 'LOCALAPPDATA' in os.environ:
+        result = os.path.expandvars('$localappdata')
+    else:
+        # Assume posix, or old Windows
+        result = os.path.expanduser('~')
+    # we use 'isdir' instead of 'exists', because we want to
+    # fail if there's a file with that name
+    if os.path.isdir(result):
+        usable = os.access(result, os.W_OK)
+        if not usable:
+            logger.warning('Directory exists but is not writable: %s', result)
+    else:
+        try:
+            os.makedirs(result)
+            usable = True
+        except OSError:
+            logger.warning('Unable to create %s', result, exc_info=True)
+            usable = False
+    if not usable:
+        result = tempfile.mkdtemp()
+        logger.warning('Default location unusable, using %s', result)
+    return os.path.join(result, suffix)
+
+
+def path_to_cache_dir(path):
+    """
+    Convert an absolute path to a directory name for use in a cache.
+
+    The algorithm used is:
+
+    #. On Windows, any ``':'`` in the drive is replaced with ``'---'``.
+    #. Any occurrence of ``os.sep`` is replaced with ``'--'``.
+    #. ``'.cache'`` is appended.
+    """
+    d, p = os.path.splitdrive(os.path.abspath(path))
+    if d:
+        d = d.replace(':', '---')
+    p = p.replace(os.sep, '--')
+    return d + p + '.cache'
+
+
+def ensure_slash(s):
+    if not s.endswith('/'):
+        return s + '/'
+    return s
+
+
+def parse_credentials(netloc):
+    username = password = None
+    if '@' in netloc:
+        prefix, netloc = netloc.rsplit('@', 1)
+        if ':' not in prefix:
+            username = prefix
+        else:
+            username, password = prefix.split(':', 1)
+    if username:
+        username = unquote(username)
+    if password:
+        password = unquote(password)
+    return username, password, netloc
+
+
+def get_process_umask():
+    result = os.umask(0o22)
+    os.umask(result)
+    return result
+
+def is_string_sequence(seq):
+    result = True
+    i = None
+    for i, s in enumerate(seq):
+        if not isinstance(s, string_types):
+            result = False
+            break
+    assert i is not None
+    return result
+
+PROJECT_NAME_AND_VERSION = re.compile('([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-'
+                                      '([a-z0-9_.+-]+)', re.I)
+PYTHON_VERSION = re.compile(r'-py(\d\.?\d?)')
+
+
+def split_filename(filename, project_name=None):
+    """
+    Extract name, version, python version from a filename (no extension)
+
+    Return name, version, pyver or None
+    """
+    result = None
+    pyver = None
+    filename = unquote(filename).replace(' ', '-')
+    m = PYTHON_VERSION.search(filename)
+    if m:
+        pyver = m.group(1)
+        filename = filename[:m.start()]
+    if project_name and len(filename) > len(project_name) + 1:
+        m = re.match(re.escape(project_name) + r'\b', filename)
+        if m:
+            n = m.end()
+            result = filename[:n], filename[n + 1:], pyver
+    if result is None:
+        m = PROJECT_NAME_AND_VERSION.match(filename)
+        if m:
+            result = m.group(1), m.group(3), pyver
+    return result
+
+# Allow spaces in name because of legacy dists like "Twisted Core"
+NAME_VERSION_RE = re.compile(r'(?P<name>[\w .-]+)\s*'
+                             r'\(\s*(?P<ver>[^\s)]+)\)$')
+
+def parse_name_and_version(p):
+    """
+    A utility method used to get name and version from a string.
+
+    From e.g. a Provides-Dist value.
+
+    :param p: A value in a form 'foo (1.0)'
+    :return: The name and version as a tuple.
+    """
+    m = NAME_VERSION_RE.match(p)
+    if not m:
+        raise DistlibException('Ill-formed name/version string: \'%s\'' % p)
+    d = m.groupdict()
+    return d['name'].strip().lower(), d['ver']
+
+def get_extras(requested, available):
+    result = set()
+    requested = set(requested or [])
+    available = set(available or [])
+    if '*' in requested:
+        requested.remove('*')
+        result |= available
+    for r in requested:
+        if r == '-':
+            result.add(r)
+        elif r.startswith('-'):
+            unwanted = r[1:]
+            if unwanted not in available:
+                logger.warning('undeclared extra: %s' % unwanted)
+            if unwanted in result:
+                result.remove(unwanted)
+        else:
+            if r not in available:
+                logger.warning('undeclared extra: %s' % r)
+            result.add(r)
+    return result
+#
+# Extended metadata functionality
+#
+
+def _get_external_data(url):
+    result = {}
+    try:
+        # urlopen might fail if it runs into redirections,
+        # because of Python issue #13696. Fixed in locators
+        # using a custom redirect handler.
+        resp = urlopen(url)
+        headers = resp.info()
+        ct = headers.get('Content-Type')
+        if not ct.startswith('application/json'):
+            logger.debug('Unexpected response for JSON request: %s', ct)
+        else:
+            reader = codecs.getreader('utf-8')(resp)
+            #data = reader.read().decode('utf-8')
+            #result = json.loads(data)
+            result = json.load(reader)
+    except Exception as e:
+        logger.exception('Failed to get external data for %s: %s', url, e)
+    return result
+
+_external_data_base_url = 'https://www.red-dove.com/pypi/projects/'
+
+def get_project_data(name):
+    url = '%s/%s/project.json' % (name[0].upper(), name)
+    url = urljoin(_external_data_base_url, url)
+    result = _get_external_data(url)
+    return result
+
+def get_package_data(name, version):
+    url = '%s/%s/package-%s.json' % (name[0].upper(), name, version)
+    url = urljoin(_external_data_base_url, url)
+    return _get_external_data(url)
+
+
+class Cache(object):
+    """
+    A class implementing a cache for resources that need to live in the file system
+    e.g. shared libraries. This class was moved from resources to here because it
+    could be used by other modules, e.g. the wheel module.
+    """
+
+    def __init__(self, base):
+        """
+        Initialise an instance.
+
+        :param base: The base directory where the cache should be located.
+        """
+        # we use 'isdir' instead of 'exists', because we want to
+        # fail if there's a file with that name
+        if not os.path.isdir(base):  # pragma: no cover
+            os.makedirs(base)
+        if (os.stat(base).st_mode & 0o77) != 0:
+            logger.warning('Directory \'%s\' is not private', base)
+        self.base = os.path.abspath(os.path.normpath(base))
+
+    def prefix_to_dir(self, prefix):
+        """
+        Converts a resource prefix to a directory name in the cache.
+        """
+        return path_to_cache_dir(prefix)
+
+    def clear(self):
+        """
+        Clear the cache.
+        """
+        not_removed = []
+        for fn in os.listdir(self.base):
+            fn = os.path.join(self.base, fn)
+            try:
+                if os.path.islink(fn) or os.path.isfile(fn):
+                    os.remove(fn)
+                elif os.path.isdir(fn):
+                    shutil.rmtree(fn)
+            except Exception:
+                not_removed.append(fn)
+        return not_removed
+
+
+class EventMixin(object):
+    """
+    A very simple publish/subscribe system.
+    """
+    def __init__(self):
+        self._subscribers = {}
+
+    def add(self, event, subscriber, append=True):
+        """
+        Add a subscriber for an event.
+
+        :param event: The name of an event.
+        :param subscriber: The subscriber to be added (and called when the
+                           event is published).
+        :param append: Whether to append or prepend the subscriber to an
+                       existing subscriber list for the event.
+        """
+        subs = self._subscribers
+        if event not in subs:
+            subs[event] = deque([subscriber])
+        else:
+            sq = subs[event]
+            if append:
+                sq.append(subscriber)
+            else:
+                sq.appendleft(subscriber)
+
+    def remove(self, event, subscriber):
+        """
+        Remove a subscriber for an event.
+
+        :param event: The name of an event.
+        :param subscriber: The subscriber to be removed.
+        """
+        subs = self._subscribers
+        if event not in subs:
+            raise ValueError('No subscribers: %r' % event)
+        subs[event].remove(subscriber)
+
+    def get_subscribers(self, event):
+        """
+        Return an iterator for the subscribers for an event.
+        :param event: The event to return subscribers for.
+        """
+        return iter(self._subscribers.get(event, ()))
+
+    def publish(self, event, *args, **kwargs):
+        """
+        Publish a event and return a list of values returned by its
+        subscribers.
+
+        :param event: The event to publish.
+        :param args: The positional arguments to pass to the event's
+                     subscribers.
+        :param kwargs: The keyword arguments to pass to the event's
+                       subscribers.
+        """
+        result = []
+        for subscriber in self.get_subscribers(event):
+            try:
+                value = subscriber(event, *args, **kwargs)
+            except Exception:
+                logger.exception('Exception during event publication')
+                value = None
+            result.append(value)
+        logger.debug('publish %s: args = %s, kwargs = %s, result = %s',
+                     event, args, kwargs, result)
+        return result
+
+#
+# Simple sequencing
+#
+class Sequencer(object):
+    def __init__(self):
+        self._preds = {}
+        self._succs = {}
+        self._nodes = set()     # nodes with no preds/succs
+
+    def add_node(self, node):
+        self._nodes.add(node)
+
+    def remove_node(self, node, edges=False):
+        if node in self._nodes:
+            self._nodes.remove(node)
+        if edges:
+            for p in set(self._preds.get(node, ())):
+                self.remove(p, node)
+            for s in set(self._succs.get(node, ())):
+                self.remove(node, s)
+            # Remove empties
+            for k, v in list(self._preds.items()):
+                if not v:
+                    del self._preds[k]
+            for k, v in list(self._succs.items()):
+                if not v:
+                    del self._succs[k]
+
+    def add(self, pred, succ):
+        assert pred != succ
+        self._preds.setdefault(succ, set()).add(pred)
+        self._succs.setdefault(pred, set()).add(succ)
+
+    def remove(self, pred, succ):
+        assert pred != succ
+        try:
+            preds = self._preds[succ]
+            succs = self._succs[pred]
+        except KeyError:  # pragma: no cover
+            raise ValueError('%r not a successor of anything' % succ)
+        try:
+            preds.remove(pred)
+            succs.remove(succ)
+        except KeyError:  # pragma: no cover
+            raise ValueError('%r not a successor of %r' % (succ, pred))
+
+    def is_step(self, step):
+        return (step in self._preds or step in self._succs or
+                step in self._nodes)
+
+    def get_steps(self, final):
+        if not self.is_step(final):
+            raise ValueError('Unknown: %r' % final)
+        result = []
+        todo = []
+        seen = set()
+        todo.append(final)
+        while todo:
+            step = todo.pop(0)
+            if step in seen:
+                # if a step was already seen,
+                # move it to the end (so it will appear earlier
+                # when reversed on return) ... but not for the
+                # final step, as that would be confusing for
+                # users
+                if step != final:
+                    result.remove(step)
+                    result.append(step)
+            else:
+                seen.add(step)
+                result.append(step)
+                preds = self._preds.get(step, ())
+                todo.extend(preds)
+        return reversed(result)
+
+    @property
+    def strong_connections(self):
+        #http://en.wikipedia.org/wiki/Tarjan%27s_strongly_connected_components_algorithm
+        index_counter = [0]
+        stack = []
+        lowlinks = {}
+        index = {}
+        result = []
+
+        graph = self._succs
+
+        def strongconnect(node):
+            # set the depth index for this node to the smallest unused index
+            index[node] = index_counter[0]
+            lowlinks[node] = index_counter[0]
+            index_counter[0] += 1
+            stack.append(node)
+
+            # Consider successors
+            try:
+                successors = graph[node]
+            except Exception:
+                successors = []
+            for successor in successors:
+                if successor not in lowlinks:
+                    # Successor has not yet been visited
+                    strongconnect(successor)
+                    lowlinks[node] = min(lowlinks[node],lowlinks[successor])
+                elif successor in stack:
+                    # the successor is in the stack and hence in the current
+                    # strongly connected component (SCC)
+                    lowlinks[node] = min(lowlinks[node],index[successor])
+
+            # If `node` is a root node, pop the stack and generate an SCC
+            if lowlinks[node] == index[node]:
+                connected_component = []
+
+                while True:
+                    successor = stack.pop()
+                    connected_component.append(successor)
+                    if successor == node: break
+                component = tuple(connected_component)
+                # storing the result
+                result.append(component)
+
+        for node in graph:
+            if node not in lowlinks:
+                strongconnect(node)
+
+        return result
+
+    @property
+    def dot(self):
+        result = ['digraph G {']
+        for succ in self._preds:
+            preds = self._preds[succ]
+            for pred in preds:
+                result.append('  %s -> %s;' % (pred, succ))
+        for node in self._nodes:
+            result.append('  %s;' % node)
+        result.append('}')
+        return '\n'.join(result)
+
+#
+# Unarchiving functionality for zip, tar, tgz, tbz, whl
+#
+
+ARCHIVE_EXTENSIONS = ('.tar.gz', '.tar.bz2', '.tar', '.zip',
+                      '.tgz', '.tbz', '.whl')
+
+def unarchive(archive_filename, dest_dir, format=None, check=True):
+
+    def check_path(path):
+        if not isinstance(path, text_type):
+            path = path.decode('utf-8')
+        p = os.path.abspath(os.path.join(dest_dir, path))
+        if not p.startswith(dest_dir) or p[plen] != os.sep:
+            raise ValueError('path outside destination: %r' % p)
+
+    dest_dir = os.path.abspath(dest_dir)
+    plen = len(dest_dir)
+    archive = None
+    if format is None:
+        if archive_filename.endswith(('.zip', '.whl')):
+            format = 'zip'
+        elif archive_filename.endswith(('.tar.gz', '.tgz')):
+            format = 'tgz'
+            mode = 'r:gz'
+        elif archive_filename.endswith(('.tar.bz2', '.tbz')):
+            format = 'tbz'
+            mode = 'r:bz2'
+        elif archive_filename.endswith('.tar'):
+            format = 'tar'
+            mode = 'r'
+        else:  # pragma: no cover
+            raise ValueError('Unknown format for %r' % archive_filename)
+    try:
+        if format == 'zip':
+            archive = ZipFile(archive_filename, 'r')
+            if check:
+                names = archive.namelist()
+                for name in names:
+                    check_path(name)
+        else:
+            archive = tarfile.open(archive_filename, mode)
+            if check:
+                names = archive.getnames()
+                for name in names:
+                    check_path(name)
+        if format != 'zip' and sys.version_info[0] < 3:
+            # See Python issue 17153. If the dest path contains Unicode,
+            # tarfile extraction fails on Python 2.x if a member path name
+            # contains non-ASCII characters - it leads to an implicit
+            # bytes -> unicode conversion using ASCII to decode.
+            for tarinfo in archive.getmembers():
+                if not isinstance(tarinfo.name, text_type):
+                    tarinfo.name = tarinfo.name.decode('utf-8')
+        archive.extractall(dest_dir)
+
+    finally:
+        if archive:
+            archive.close()
+
+
+def zip_dir(directory):
+    """zip a directory tree into a BytesIO object"""
+    result = io.BytesIO()
+    dlen = len(directory)
+    with ZipFile(result, "w") as zf:
+        for root, dirs, files in os.walk(directory):
+            for name in files:
+                full = os.path.join(root, name)
+                rel = root[dlen:]
+                dest = os.path.join(rel, name)
+                zf.write(full, dest)
+    return result
+
+#
+# Simple progress bar
+#
+
+UNITS = ('', 'K', 'M', 'G','T','P')
+
+
+class Progress(object):
+    unknown = 'UNKNOWN'
+
+    def __init__(self, minval=0, maxval=100):
+        assert maxval is None or maxval >= minval
+        self.min = self.cur = minval
+        self.max = maxval
+        self.started = None
+        self.elapsed = 0
+        self.done = False
+
+    def update(self, curval):
+        assert self.min <= curval
+        assert self.max is None or curval <= self.max
+        self.cur = curval
+        now = time.time()
+        if self.started is None:
+            self.started = now
+        else:
+            self.elapsed = now - self.started
+
+    def increment(self, incr):
+        assert incr >= 0
+        self.update(self.cur + incr)
+
+    def start(self):
+        self.update(self.min)
+        return self
+
+    def stop(self):
+        if self.max is not None:
+            self.update(self.max)
+        self.done = True
+
+    @property
+    def maximum(self):
+        return self.unknown if self.max is None else self.max
+
+    @property
+    def percentage(self):
+        if self.done:
+            result = '100 %'
+        elif self.max is None:
+            result = ' ?? %'
+        else:
+            v = 100.0 * (self.cur - self.min) / (self.max - self.min)
+            result = '%3d %%' % v
+        return result
+
+    def format_duration(self, duration):
+        if (duration <= 0) and self.max is None or self.cur == self.min:
+            result = '??:??:??'
+        #elif duration < 1:
+        #    result = '--:--:--'
+        else:
+            result = time.strftime('%H:%M:%S', time.gmtime(duration))
+        return result
+
+    @property
+    def ETA(self):
+        if self.done:
+            prefix = 'Done'
+            t = self.elapsed
+            #import pdb; pdb.set_trace()
+        else:
+            prefix = 'ETA '
+            if self.max is None:
+                t = -1
+            elif self.elapsed == 0 or (self.cur == self.min):
+                t = 0
+            else:
+                #import pdb; pdb.set_trace()
+                t = float(self.max - self.min)
+                t /= self.cur - self.min
+                t = (t - 1) * self.elapsed
+        return '%s: %s' % (prefix, self.format_duration(t))
+
+    @property
+    def speed(self):
+        if self.elapsed == 0:
+            result = 0.0
+        else:
+            result = (self.cur - self.min) / self.elapsed
+        for unit in UNITS:
+            if result < 1000:
+                break
+            result /= 1000.0
+        return '%d %sB/s' % (result, unit)
+
+#
+# Glob functionality
+#
+
+RICH_GLOB = re.compile(r'\{([^}]*)\}')
+_CHECK_RECURSIVE_GLOB = re.compile(r'[^/\\,{]\*\*|\*\*[^/\\,}]')
+_CHECK_MISMATCH_SET = re.compile(r'^[^{]*\}|\{[^}]*$')
+
+
+def iglob(path_glob):
+    """Extended globbing function that supports ** and {opt1,opt2,opt3}."""
+    if _CHECK_RECURSIVE_GLOB.search(path_glob):
+        msg = """invalid glob %r: recursive glob "**" must be used alone"""
+        raise ValueError(msg % path_glob)
+    if _CHECK_MISMATCH_SET.search(path_glob):
+        msg = """invalid glob %r: mismatching set marker '{' or '}'"""
+        raise ValueError(msg % path_glob)
+    return _iglob(path_glob)
+
+
+def _iglob(path_glob):
+    rich_path_glob = RICH_GLOB.split(path_glob, 1)
+    if len(rich_path_glob) > 1:
+        assert len(rich_path_glob) == 3, rich_path_glob
+        prefix, set, suffix = rich_path_glob
+        for item in set.split(','):
+            for path in _iglob(''.join((prefix, item, suffix))):
+                yield path
+    else:
+        if '**' not in path_glob:
+            for item in std_iglob(path_glob):
+                yield item
+        else:
+            prefix, radical = path_glob.split('**', 1)
+            if prefix == '':
+                prefix = '.'
+            if radical == '':
+                radical = '*'
+            else:
+                # we support both
+                radical = radical.lstrip('/')
+                radical = radical.lstrip('\\')
+            for path, dir, files in os.walk(prefix):
+                path = os.path.normpath(path)
+                for fn in _iglob(os.path.join(path, radical)):
+                    yield fn
+
+if ssl:
+    from .compat import (HTTPSHandler as BaseHTTPSHandler, match_hostname,
+                         CertificateError)
+
+
+#
+# HTTPSConnection which verifies certificates/matches domains
+#
+
+    class HTTPSConnection(httplib.HTTPSConnection):
+        ca_certs = None # set this to the path to the certs file (.pem)
+        check_domain = True # only used if ca_certs is not None
+
+        # noinspection PyPropertyAccess
+        def connect(self):
+            sock = socket.create_connection((self.host, self.port), self.timeout)
+            if getattr(self, '_tunnel_host', False):
+                self.sock = sock
+                self._tunnel()
+
+            if not hasattr(ssl, 'SSLContext'):
+                # For 2.x
+                if self.ca_certs:
+                    cert_reqs = ssl.CERT_REQUIRED
+                else:
+                    cert_reqs = ssl.CERT_NONE
+                self.sock = ssl.wrap_socket(sock, self.key_file, self.cert_file,
+                                            cert_reqs=cert_reqs,
+                                            ssl_version=ssl.PROTOCOL_SSLv23,
+                                            ca_certs=self.ca_certs)
+            else:  # pragma: no cover
+                context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
+                if hasattr(ssl, 'OP_NO_SSLv2'):
+                    context.options |= ssl.OP_NO_SSLv2
+                if self.cert_file:
+                    context.load_cert_chain(self.cert_file, self.key_file)
+                kwargs = {}
+                if self.ca_certs:
+                    context.verify_mode = ssl.CERT_REQUIRED
+                    context.load_verify_locations(cafile=self.ca_certs)
+                    if getattr(ssl, 'HAS_SNI', False):
+                        kwargs['server_hostname'] = self.host
+                self.sock = context.wrap_socket(sock, **kwargs)
+            if self.ca_certs and self.check_domain:
+                try:
+                    match_hostname(self.sock.getpeercert(), self.host)
+                    logger.debug('Host verified: %s', self.host)
+                except CertificateError:  # pragma: no cover
+                    self.sock.shutdown(socket.SHUT_RDWR)
+                    self.sock.close()
+                    raise
+
+    class HTTPSHandler(BaseHTTPSHandler):
+        def __init__(self, ca_certs, check_domain=True):
+            BaseHTTPSHandler.__init__(self)
+            self.ca_certs = ca_certs
+            self.check_domain = check_domain
+
+        def _conn_maker(self, *args, **kwargs):
+            """
+            This is called to create a connection instance. Normally you'd
+            pass a connection class to do_open, but it doesn't actually check for
+            a class, and just expects a callable. As long as we behave just as a
+            constructor would have, we should be OK. If it ever changes so that
+            we *must* pass a class, we'll create an UnsafeHTTPSConnection class
+            which just sets check_domain to False in the class definition, and
+            choose which one to pass to do_open.
+            """
+            result = HTTPSConnection(*args, **kwargs)
+            if self.ca_certs:
+                result.ca_certs = self.ca_certs
+                result.check_domain = self.check_domain
+            return result
+
+        def https_open(self, req):
+            try:
+                return self.do_open(self._conn_maker, req)
+            except URLError as e:
+                if 'certificate verify failed' in str(e.reason):
+                    raise CertificateError('Unable to verify server certificate '
+                                           'for %s' % req.host)
+                else:
+                    raise
+
+    #
+    # To prevent against mixing HTTP traffic with HTTPS (examples: A Man-In-The-
+    # Middle proxy using HTTP listens on port 443, or an index mistakenly serves
+    # HTML containing a http://xyz link when it should be https://xyz),
+    # you can use the following handler class, which does not allow HTTP traffic.
+    #
+    # It works by inheriting from HTTPHandler - so build_opener won't add a
+    # handler for HTTP itself.
+    #
+    class HTTPSOnlyHandler(HTTPSHandler, HTTPHandler):
+        def http_open(self, req):
+            raise URLError('Unexpected HTTP request on what should be a secure '
+                           'connection: %s' % req)
+
+#
+# XML-RPC with timeouts
+#
+
+_ver_info = sys.version_info[:2]
+
+if _ver_info == (2, 6):
+    class HTTP(httplib.HTTP):
+        def __init__(self, host='', port=None, **kwargs):
+            if port == 0:   # 0 means use port 0, not the default port
+                port = None
+            self._setup(self._connection_class(host, port, **kwargs))
+
+
+    if ssl:
+        class HTTPS(httplib.HTTPS):
+            def __init__(self, host='', port=None, **kwargs):
+                if port == 0:   # 0 means use port 0, not the default port
+                    port = None
+                self._setup(self._connection_class(host, port, **kwargs))
+
+
+class Transport(xmlrpclib.Transport):
+    def __init__(self, timeout, use_datetime=0):
+        self.timeout = timeout
+        xmlrpclib.Transport.__init__(self, use_datetime)
+
+    def make_connection(self, host):
+        h, eh, x509 = self.get_host_info(host)
+        if _ver_info == (2, 6):
+            result = HTTP(h, timeout=self.timeout)
+        else:
+            if not self._connection or host != self._connection[0]:
+                self._extra_headers = eh
+                self._connection = host, httplib.HTTPConnection(h)
+            result = self._connection[1]
+        return result
+
+if ssl:
+    class SafeTransport(xmlrpclib.SafeTransport):
+        def __init__(self, timeout, use_datetime=0):
+            self.timeout = timeout
+            xmlrpclib.SafeTransport.__init__(self, use_datetime)
+
+        def make_connection(self, host):
+            h, eh, kwargs = self.get_host_info(host)
+            if not kwargs:
+                kwargs = {}
+            kwargs['timeout'] = self.timeout
+            if _ver_info == (2, 6):
+                result = HTTPS(host, None, **kwargs)
+            else:
+                if not self._connection or host != self._connection[0]:
+                    self._extra_headers = eh
+                    self._connection = host, httplib.HTTPSConnection(h, None,
+                                                                     **kwargs)
+                result = self._connection[1]
+            return result
+
+
+class ServerProxy(xmlrpclib.ServerProxy):
+    def __init__(self, uri, **kwargs):
+        self.timeout = timeout = kwargs.pop('timeout', None)
+        # The above classes only come into play if a timeout
+        # is specified
+        if timeout is not None:
+            scheme, _ = splittype(uri)
+            use_datetime = kwargs.get('use_datetime', 0)
+            if scheme == 'https':
+                tcls = SafeTransport
+            else:
+                tcls = Transport
+            kwargs['transport'] = t = tcls(timeout, use_datetime=use_datetime)
+            self.transport = t
+        xmlrpclib.ServerProxy.__init__(self, uri, **kwargs)
+
+#
+# CSV functionality. This is provided because on 2.x, the csv module can't
+# handle Unicode. However, we need to deal with Unicode in e.g. RECORD files.
+#
+
+def _csv_open(fn, mode, **kwargs):
+    if sys.version_info[0] < 3:
+        mode += 'b'
+    else:
+        kwargs['newline'] = ''
+        # Python 3 determines encoding from locale. Force 'utf-8'
+        # file encoding to match other forced utf-8 encoding
+        kwargs['encoding'] = 'utf-8'
+    return open(fn, mode, **kwargs)
+
+
+class CSVBase(object):
+    defaults = {
+        'delimiter': str(','),      # The strs are used because we need native
+        'quotechar': str('"'),      # str in the csv API (2.x won't take
+        'lineterminator': str('\n') # Unicode)
+    }
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc_info):
+        self.stream.close()
+
+
+class CSVReader(CSVBase):
+    def __init__(self, **kwargs):
+        if 'stream' in kwargs:
+            stream = kwargs['stream']
+            if sys.version_info[0] >= 3:
+                # needs to be a text stream
+                stream = codecs.getreader('utf-8')(stream)
+            self.stream = stream
+        else:
+            self.stream = _csv_open(kwargs['path'], 'r')
+        self.reader = csv.reader(self.stream, **self.defaults)
+
+    def __iter__(self):
+        return self
+
+    def next(self):
+        result = next(self.reader)
+        if sys.version_info[0] < 3:
+            for i, item in enumerate(result):
+                if not isinstance(item, text_type):
+                    result[i] = item.decode('utf-8')
+        return result
+
+    __next__ = next
+
+class CSVWriter(CSVBase):
+    def __init__(self, fn, **kwargs):
+        self.stream = _csv_open(fn, 'w')
+        self.writer = csv.writer(self.stream, **self.defaults)
+
+    def writerow(self, row):
+        if sys.version_info[0] < 3:
+            r = []
+            for item in row:
+                if isinstance(item, text_type):
+                    item = item.encode('utf-8')
+                r.append(item)
+            row = r
+        self.writer.writerow(row)
+
+#
+#   Configurator functionality
+#
+
+class Configurator(BaseConfigurator):
+
+    value_converters = dict(BaseConfigurator.value_converters)
+    value_converters['inc'] = 'inc_convert'
+
+    def __init__(self, config, base=None):
+        super(Configurator, self).__init__(config)
+        self.base = base or os.getcwd()
+
+    def configure_custom(self, config):
+        def convert(o):
+            if isinstance(o, (list, tuple)):
+                result = type(o)([convert(i) for i in o])
+            elif isinstance(o, dict):
+                if '()' in o:
+                    result = self.configure_custom(o)
+                else:
+                    result = {}
+                    for k in o:
+                        result[k] = convert(o[k])
+            else:
+                result = self.convert(o)
+            return result
+
+        c = config.pop('()')
+        if not callable(c):
+            c = self.resolve(c)
+        props = config.pop('.', None)
+        # Check for valid identifiers
+        args = config.pop('[]', ())
+        if args:
+            args = tuple([convert(o) for o in args])
+        items = [(k, convert(config[k])) for k in config if valid_ident(k)]
+        kwargs = dict(items)
+        result = c(*args, **kwargs)
+        if props:
+            for n, v in props.items():
+                setattr(result, n, convert(v))
+        return result
+
+    def __getitem__(self, key):
+        result = self.config[key]
+        if isinstance(result, dict) and '()' in result:
+            self.config[key] = result = self.configure_custom(result)
+        return result
+
+    def inc_convert(self, value):
+        """Default converter for the inc:// protocol."""
+        if not os.path.isabs(value):
+            value = os.path.join(self.base, value)
+        with codecs.open(value, 'r', encoding='utf-8') as f:
+            result = json.load(f)
+        return result
+
+
+class SubprocessMixin(object):
+    """
+    Mixin for running subprocesses and capturing their output
+    """
+    def __init__(self, verbose=False, progress=None):
+        self.verbose = verbose
+        self.progress = progress
+
+    def reader(self, stream, context):
+        """
+        Read lines from a subprocess' output stream and either pass to a progress
+        callable (if specified) or write progress information to sys.stderr.
+        """
+        progress = self.progress
+        verbose = self.verbose
+        while True:
+            s = stream.readline()
+            if not s:
+                break
+            if progress is not None:
+                progress(s, context)
+            else:
+                if not verbose:
+                    sys.stderr.write('.')
+                else:
+                    sys.stderr.write(s.decode('utf-8'))
+                sys.stderr.flush()
+        stream.close()
+
+    def run_command(self, cmd, **kwargs):
+        p = subprocess.Popen(cmd, stdout=subprocess.PIPE,
+                             stderr=subprocess.PIPE, **kwargs)
+        t1 = threading.Thread(target=self.reader, args=(p.stdout, 'stdout'))
+        t1.start()
+        t2 = threading.Thread(target=self.reader, args=(p.stderr, 'stderr'))
+        t2.start()
+        p.wait()
+        t1.join()
+        t2.join()
+        if self.progress is not None:
+            self.progress('done.', 'main')
+        elif self.verbose:
+            sys.stderr.write('done.\n')
+        return p
+
+
+def normalize_name(name):
+    """Normalize a python package name a la PEP 503"""
+    # https://www.python.org/dev/peps/pep-0503/#normalized-names
+    return re.sub('[-_.]+', '-', name).lower()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..3eebe18ee849dcafe39246ce2f4cabbe8e5a2b33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/version.py
@@ -0,0 +1,736 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2012-2017 The Python Software Foundation.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+"""
+Implementation of a flexible versioning scheme providing support for PEP-440,
+setuptools-compatible and semantic versioning.
+"""
+
+import logging
+import re
+
+from .compat import string_types
+from .util import parse_requirement
+
+__all__ = ['NormalizedVersion', 'NormalizedMatcher',
+           'LegacyVersion', 'LegacyMatcher',
+           'SemanticVersion', 'SemanticMatcher',
+           'UnsupportedVersionError', 'get_scheme']
+
+logger = logging.getLogger(__name__)
+
+
+class UnsupportedVersionError(ValueError):
+    """This is an unsupported version."""
+    pass
+
+
+class Version(object):
+    def __init__(self, s):
+        self._string = s = s.strip()
+        self._parts = parts = self.parse(s)
+        assert isinstance(parts, tuple)
+        assert len(parts) > 0
+
+    def parse(self, s):
+        raise NotImplementedError('please implement in a subclass')
+
+    def _check_compatible(self, other):
+        if type(self) != type(other):
+            raise TypeError('cannot compare %r and %r' % (self, other))
+
+    def __eq__(self, other):
+        self._check_compatible(other)
+        return self._parts == other._parts
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __lt__(self, other):
+        self._check_compatible(other)
+        return self._parts < other._parts
+
+    def __gt__(self, other):
+        return not (self.__lt__(other) or self.__eq__(other))
+
+    def __le__(self, other):
+        return self.__lt__(other) or self.__eq__(other)
+
+    def __ge__(self, other):
+        return self.__gt__(other) or self.__eq__(other)
+
+    # See http://docs.python.org/reference/datamodel#object.__hash__
+    def __hash__(self):
+        return hash(self._parts)
+
+    def __repr__(self):
+        return "%s('%s')" % (self.__class__.__name__, self._string)
+
+    def __str__(self):
+        return self._string
+
+    @property
+    def is_prerelease(self):
+        raise NotImplementedError('Please implement in subclasses.')
+
+
+class Matcher(object):
+    version_class = None
+
+    # value is either a callable or the name of a method
+    _operators = {
+        '<': lambda v, c, p: v < c,
+        '>': lambda v, c, p: v > c,
+        '<=': lambda v, c, p: v == c or v < c,
+        '>=': lambda v, c, p: v == c or v > c,
+        '==': lambda v, c, p: v == c,
+        '===': lambda v, c, p: v == c,
+        # by default, compatible => >=.
+        '~=': lambda v, c, p: v == c or v > c,
+        '!=': lambda v, c, p: v != c,
+    }
+
+    # this is a method only to support alternative implementations
+    # via overriding
+    def parse_requirement(self, s):
+        return parse_requirement(s)
+
+    def __init__(self, s):
+        if self.version_class is None:
+            raise ValueError('Please specify a version class')
+        self._string = s = s.strip()
+        r = self.parse_requirement(s)
+        if not r:
+            raise ValueError('Not valid: %r' % s)
+        self.name = r.name
+        self.key = self.name.lower()    # for case-insensitive comparisons
+        clist = []
+        if r.constraints:
+            # import pdb; pdb.set_trace()
+            for op, s in r.constraints:
+                if s.endswith('.*'):
+                    if op not in ('==', '!='):
+                        raise ValueError('\'.*\' not allowed for '
+                                         '%r constraints' % op)
+                    # Could be a partial version (e.g. for '2.*') which
+                    # won't parse as a version, so keep it as a string
+                    vn, prefix = s[:-2], True
+                    # Just to check that vn is a valid version
+                    self.version_class(vn)
+                else:
+                    # Should parse as a version, so we can create an
+                    # instance for the comparison
+                    vn, prefix = self.version_class(s), False
+                clist.append((op, vn, prefix))
+        self._parts = tuple(clist)
+
+    def match(self, version):
+        """
+        Check if the provided version matches the constraints.
+
+        :param version: The version to match against this instance.
+        :type version: String or :class:`Version` instance.
+        """
+        if isinstance(version, string_types):
+            version = self.version_class(version)
+        for operator, constraint, prefix in self._parts:
+            f = self._operators.get(operator)
+            if isinstance(f, string_types):
+                f = getattr(self, f)
+            if not f:
+                msg = ('%r not implemented '
+                       'for %s' % (operator, self.__class__.__name__))
+                raise NotImplementedError(msg)
+            if not f(version, constraint, prefix):
+                return False
+        return True
+
+    @property
+    def exact_version(self):
+        result = None
+        if len(self._parts) == 1 and self._parts[0][0] in ('==', '==='):
+            result = self._parts[0][1]
+        return result
+
+    def _check_compatible(self, other):
+        if type(self) != type(other) or self.name != other.name:
+            raise TypeError('cannot compare %s and %s' % (self, other))
+
+    def __eq__(self, other):
+        self._check_compatible(other)
+        return self.key == other.key and self._parts == other._parts
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    # See http://docs.python.org/reference/datamodel#object.__hash__
+    def __hash__(self):
+        return hash(self.key) + hash(self._parts)
+
+    def __repr__(self):
+        return "%s(%r)" % (self.__class__.__name__, self._string)
+
+    def __str__(self):
+        return self._string
+
+
+PEP440_VERSION_RE = re.compile(r'^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?'
+                               r'(\.(post)(\d+))?(\.(dev)(\d+))?'
+                               r'(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$')
+
+
+def _pep_440_key(s):
+    s = s.strip()
+    m = PEP440_VERSION_RE.match(s)
+    if not m:
+        raise UnsupportedVersionError('Not a valid version: %s' % s)
+    groups = m.groups()
+    nums = tuple(int(v) for v in groups[1].split('.'))
+    while len(nums) > 1 and nums[-1] == 0:
+        nums = nums[:-1]
+
+    if not groups[0]:
+        epoch = 0
+    else:
+        epoch = int(groups[0])
+    pre = groups[4:6]
+    post = groups[7:9]
+    dev = groups[10:12]
+    local = groups[13]
+    if pre == (None, None):
+        pre = ()
+    else:
+        pre = pre[0], int(pre[1])
+    if post == (None, None):
+        post = ()
+    else:
+        post = post[0], int(post[1])
+    if dev == (None, None):
+        dev = ()
+    else:
+        dev = dev[0], int(dev[1])
+    if local is None:
+        local = ()
+    else:
+        parts = []
+        for part in local.split('.'):
+            # to ensure that numeric compares as > lexicographic, avoid
+            # comparing them directly, but encode a tuple which ensures
+            # correct sorting
+            if part.isdigit():
+                part = (1, int(part))
+            else:
+                part = (0, part)
+            parts.append(part)
+        local = tuple(parts)
+    if not pre:
+        # either before pre-release, or final release and after
+        if not post and dev:
+            # before pre-release
+            pre = ('a', -1)     # to sort before a0
+        else:
+            pre = ('z',)        # to sort after all pre-releases
+    # now look at the state of post and dev.
+    if not post:
+        post = ('_',)   # sort before 'a'
+    if not dev:
+        dev = ('final',)
+
+    #print('%s -> %s' % (s, m.groups()))
+    return epoch, nums, pre, post, dev, local
+
+
+_normalized_key = _pep_440_key
+
+
+class NormalizedVersion(Version):
+    """A rational version.
+
+    Good:
+        1.2         # equivalent to "1.2.0"
+        1.2.0
+        1.2a1
+        1.2.3a2
+        1.2.3b1
+        1.2.3c1
+        1.2.3.4
+        TODO: fill this out
+
+    Bad:
+        1           # minimum two numbers
+        1.2a        # release level must have a release serial
+        1.2.3b
+    """
+    def parse(self, s):
+        result = _normalized_key(s)
+        # _normalized_key loses trailing zeroes in the release
+        # clause, since that's needed to ensure that X.Y == X.Y.0 == X.Y.0.0
+        # However, PEP 440 prefix matching needs it: for example,
+        # (~= 1.4.5.0) matches differently to (~= 1.4.5.0.0).
+        m = PEP440_VERSION_RE.match(s)      # must succeed
+        groups = m.groups()
+        self._release_clause = tuple(int(v) for v in groups[1].split('.'))
+        return result
+
+    PREREL_TAGS = set(['a', 'b', 'c', 'rc', 'dev'])
+
+    @property
+    def is_prerelease(self):
+        return any(t[0] in self.PREREL_TAGS for t in self._parts if t)
+
+
+def _match_prefix(x, y):
+    x = str(x)
+    y = str(y)
+    if x == y:
+        return True
+    if not x.startswith(y):
+        return False
+    n = len(y)
+    return x[n] == '.'
+
+
+class NormalizedMatcher(Matcher):
+    version_class = NormalizedVersion
+
+    # value is either a callable or the name of a method
+    _operators = {
+        '~=': '_match_compatible',
+        '<': '_match_lt',
+        '>': '_match_gt',
+        '<=': '_match_le',
+        '>=': '_match_ge',
+        '==': '_match_eq',
+        '===': '_match_arbitrary',
+        '!=': '_match_ne',
+    }
+
+    def _adjust_local(self, version, constraint, prefix):
+        if prefix:
+            strip_local = '+' not in constraint and version._parts[-1]
+        else:
+            # both constraint and version are
+            # NormalizedVersion instances.
+            # If constraint does not have a local component,
+            # ensure the version doesn't, either.
+            strip_local = not constraint._parts[-1] and version._parts[-1]
+        if strip_local:
+            s = version._string.split('+', 1)[0]
+            version = self.version_class(s)
+        return version, constraint
+
+    def _match_lt(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        if version >= constraint:
+            return False
+        release_clause = constraint._release_clause
+        pfx = '.'.join([str(i) for i in release_clause])
+        return not _match_prefix(version, pfx)
+
+    def _match_gt(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        if version <= constraint:
+            return False
+        release_clause = constraint._release_clause
+        pfx = '.'.join([str(i) for i in release_clause])
+        return not _match_prefix(version, pfx)
+
+    def _match_le(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        return version <= constraint
+
+    def _match_ge(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        return version >= constraint
+
+    def _match_eq(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        if not prefix:
+            result = (version == constraint)
+        else:
+            result = _match_prefix(version, constraint)
+        return result
+
+    def _match_arbitrary(self, version, constraint, prefix):
+        return str(version) == str(constraint)
+
+    def _match_ne(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        if not prefix:
+            result = (version != constraint)
+        else:
+            result = not _match_prefix(version, constraint)
+        return result
+
+    def _match_compatible(self, version, constraint, prefix):
+        version, constraint = self._adjust_local(version, constraint, prefix)
+        if version == constraint:
+            return True
+        if version < constraint:
+            return False
+#        if not prefix:
+#            return True
+        release_clause = constraint._release_clause
+        if len(release_clause) > 1:
+            release_clause = release_clause[:-1]
+        pfx = '.'.join([str(i) for i in release_clause])
+        return _match_prefix(version, pfx)
+
+_REPLACEMENTS = (
+    (re.compile('[.+-]$'), ''),                     # remove trailing puncts
+    (re.compile(r'^[.](\d)'), r'0.\1'),             # .N -> 0.N at start
+    (re.compile('^[.-]'), ''),                      # remove leading puncts
+    (re.compile(r'^\((.*)\)$'), r'\1'),             # remove parentheses
+    (re.compile(r'^v(ersion)?\s*(\d+)'), r'\2'),    # remove leading v(ersion)
+    (re.compile(r'^r(ev)?\s*(\d+)'), r'\2'),        # remove leading v(ersion)
+    (re.compile('[.]{2,}'), '.'),                   # multiple runs of '.'
+    (re.compile(r'\b(alfa|apha)\b'), 'alpha'),      # misspelt alpha
+    (re.compile(r'\b(pre-alpha|prealpha)\b'),
+                'pre.alpha'),                       # standardise
+    (re.compile(r'\(beta\)$'), 'beta'),             # remove parentheses
+)
+
+_SUFFIX_REPLACEMENTS = (
+    (re.compile('^[:~._+-]+'), ''),                   # remove leading puncts
+    (re.compile('[,*")([\\]]'), ''),                  # remove unwanted chars
+    (re.compile('[~:+_ -]'), '.'),                    # replace illegal chars
+    (re.compile('[.]{2,}'), '.'),                   # multiple runs of '.'
+    (re.compile(r'\.$'), ''),                       # trailing '.'
+)
+
+_NUMERIC_PREFIX = re.compile(r'(\d+(\.\d+)*)')
+
+
+def _suggest_semantic_version(s):
+    """
+    Try to suggest a semantic form for a version for which
+    _suggest_normalized_version couldn't come up with anything.
+    """
+    result = s.strip().lower()
+    for pat, repl in _REPLACEMENTS:
+        result = pat.sub(repl, result)
+    if not result:
+        result = '0.0.0'
+
+    # Now look for numeric prefix, and separate it out from
+    # the rest.
+    #import pdb; pdb.set_trace()
+    m = _NUMERIC_PREFIX.match(result)
+    if not m:
+        prefix = '0.0.0'
+        suffix = result
+    else:
+        prefix = m.groups()[0].split('.')
+        prefix = [int(i) for i in prefix]
+        while len(prefix) < 3:
+            prefix.append(0)
+        if len(prefix) == 3:
+            suffix = result[m.end():]
+        else:
+            suffix = '.'.join([str(i) for i in prefix[3:]]) + result[m.end():]
+            prefix = prefix[:3]
+        prefix = '.'.join([str(i) for i in prefix])
+        suffix = suffix.strip()
+    if suffix:
+        #import pdb; pdb.set_trace()
+        # massage the suffix.
+        for pat, repl in _SUFFIX_REPLACEMENTS:
+            suffix = pat.sub(repl, suffix)
+
+    if not suffix:
+        result = prefix
+    else:
+        sep = '-' if 'dev' in suffix else '+'
+        result = prefix + sep + suffix
+    if not is_semver(result):
+        result = None
+    return result
+
+
+def _suggest_normalized_version(s):
+    """Suggest a normalized version close to the given version string.
+
+    If you have a version string that isn't rational (i.e. NormalizedVersion
+    doesn't like it) then you might be able to get an equivalent (or close)
+    rational version from this function.
+
+    This does a number of simple normalizations to the given string, based
+    on observation of versions currently in use on PyPI. Given a dump of
+    those version during PyCon 2009, 4287 of them:
+    - 2312 (53.93%) match NormalizedVersion without change
+      with the automatic suggestion
+    - 3474 (81.04%) match when using this suggestion method
+
+    @param s {str} An irrational version string.
+    @returns A rational version string, or None, if couldn't determine one.
+    """
+    try:
+        _normalized_key(s)
+        return s   # already rational
+    except UnsupportedVersionError:
+        pass
+
+    rs = s.lower()
+
+    # part of this could use maketrans
+    for orig, repl in (('-alpha', 'a'), ('-beta', 'b'), ('alpha', 'a'),
+                       ('beta', 'b'), ('rc', 'c'), ('-final', ''),
+                       ('-pre', 'c'),
+                       ('-release', ''), ('.release', ''), ('-stable', ''),
+                       ('+', '.'), ('_', '.'), (' ', ''), ('.final', ''),
+                       ('final', '')):
+        rs = rs.replace(orig, repl)
+
+    # if something ends with dev or pre, we add a 0
+    rs = re.sub(r"pre$", r"pre0", rs)
+    rs = re.sub(r"dev$", r"dev0", rs)
+
+    # if we have something like "b-2" or "a.2" at the end of the
+    # version, that is probably beta, alpha, etc
+    # let's remove the dash or dot
+    rs = re.sub(r"([abc]|rc)[\-\.](\d+)$", r"\1\2", rs)
+
+    # 1.0-dev-r371 -> 1.0.dev371
+    # 0.1-dev-r79 -> 0.1.dev79
+    rs = re.sub(r"[\-\.](dev)[\-\.]?r?(\d+)$", r".\1\2", rs)
+
+    # Clean: 2.0.a.3, 2.0.b1, 0.9.0~c1
+    rs = re.sub(r"[.~]?([abc])\.?", r"\1", rs)
+
+    # Clean: v0.3, v1.0
+    if rs.startswith('v'):
+        rs = rs[1:]
+
+    # Clean leading '0's on numbers.
+    #TODO: unintended side-effect on, e.g., "2003.05.09"
+    # PyPI stats: 77 (~2%) better
+    rs = re.sub(r"\b0+(\d+)(?!\d)", r"\1", rs)
+
+    # Clean a/b/c with no version. E.g. "1.0a" -> "1.0a0". Setuptools infers
+    # zero.
+    # PyPI stats: 245 (7.56%) better
+    rs = re.sub(r"(\d+[abc])$", r"\g<1>0", rs)
+
+    # the 'dev-rNNN' tag is a dev tag
+    rs = re.sub(r"\.?(dev-r|dev\.r)\.?(\d+)$", r".dev\2", rs)
+
+    # clean the - when used as a pre delimiter
+    rs = re.sub(r"-(a|b|c)(\d+)$", r"\1\2", rs)
+
+    # a terminal "dev" or "devel" can be changed into ".dev0"
+    rs = re.sub(r"[\.\-](dev|devel)$", r".dev0", rs)
+
+    # a terminal "dev" can be changed into ".dev0"
+    rs = re.sub(r"(?![\.\-])dev$", r".dev0", rs)
+
+    # a terminal "final" or "stable" can be removed
+    rs = re.sub(r"(final|stable)$", "", rs)
+
+    # The 'r' and the '-' tags are post release tags
+    #   0.4a1.r10       ->  0.4a1.post10
+    #   0.9.33-17222    ->  0.9.33.post17222
+    #   0.9.33-r17222   ->  0.9.33.post17222
+    rs = re.sub(r"\.?(r|-|-r)\.?(\d+)$", r".post\2", rs)
+
+    # Clean 'r' instead of 'dev' usage:
+    #   0.9.33+r17222   ->  0.9.33.dev17222
+    #   1.0dev123       ->  1.0.dev123
+    #   1.0.git123      ->  1.0.dev123
+    #   1.0.bzr123      ->  1.0.dev123
+    #   0.1a0dev.123    ->  0.1a0.dev123
+    # PyPI stats:  ~150 (~4%) better
+    rs = re.sub(r"\.?(dev|git|bzr)\.?(\d+)$", r".dev\2", rs)
+
+    # Clean '.pre' (normalized from '-pre' above) instead of 'c' usage:
+    #   0.2.pre1        ->  0.2c1
+    #   0.2-c1         ->  0.2c1
+    #   1.0preview123   ->  1.0c123
+    # PyPI stats: ~21 (0.62%) better
+    rs = re.sub(r"\.?(pre|preview|-c)(\d+)$", r"c\g<2>", rs)
+
+    # Tcl/Tk uses "px" for their post release markers
+    rs = re.sub(r"p(\d+)$", r".post\1", rs)
+
+    try:
+        _normalized_key(rs)
+    except UnsupportedVersionError:
+        rs = None
+    return rs
+
+#
+#   Legacy version processing (distribute-compatible)
+#
+
+_VERSION_PART = re.compile(r'([a-z]+|\d+|[\.-])', re.I)
+_VERSION_REPLACE = {
+    'pre': 'c',
+    'preview': 'c',
+    '-': 'final-',
+    'rc': 'c',
+    'dev': '@',
+    '': None,
+    '.': None,
+}
+
+
+def _legacy_key(s):
+    def get_parts(s):
+        result = []
+        for p in _VERSION_PART.split(s.lower()):
+            p = _VERSION_REPLACE.get(p, p)
+            if p:
+                if '0' <= p[:1] <= '9':
+                    p = p.zfill(8)
+                else:
+                    p = '*' + p
+                result.append(p)
+        result.append('*final')
+        return result
+
+    result = []
+    for p in get_parts(s):
+        if p.startswith('*'):
+            if p < '*final':
+                while result and result[-1] == '*final-':
+                    result.pop()
+            while result and result[-1] == '00000000':
+                result.pop()
+        result.append(p)
+    return tuple(result)
+
+
+class LegacyVersion(Version):
+    def parse(self, s):
+        return _legacy_key(s)
+
+    @property
+    def is_prerelease(self):
+        result = False
+        for x in self._parts:
+            if (isinstance(x, string_types) and x.startswith('*') and
+                x < '*final'):
+                result = True
+                break
+        return result
+
+
+class LegacyMatcher(Matcher):
+    version_class = LegacyVersion
+
+    _operators = dict(Matcher._operators)
+    _operators['~='] = '_match_compatible'
+
+    numeric_re = re.compile(r'^(\d+(\.\d+)*)')
+
+    def _match_compatible(self, version, constraint, prefix):
+        if version < constraint:
+            return False
+        m = self.numeric_re.match(str(constraint))
+        if not m:
+            logger.warning('Cannot compute compatible match for version %s '
+                           ' and constraint %s', version, constraint)
+            return True
+        s = m.groups()[0]
+        if '.' in s:
+            s = s.rsplit('.', 1)[0]
+        return _match_prefix(version, s)
+
+#
+#   Semantic versioning
+#
+
+_SEMVER_RE = re.compile(r'^(\d+)\.(\d+)\.(\d+)'
+                        r'(-[a-z0-9]+(\.[a-z0-9-]+)*)?'
+                        r'(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$', re.I)
+
+
+def is_semver(s):
+    return _SEMVER_RE.match(s)
+
+
+def _semantic_key(s):
+    def make_tuple(s, absent):
+        if s is None:
+            result = (absent,)
+        else:
+            parts = s[1:].split('.')
+            # We can't compare ints and strings on Python 3, so fudge it
+            # by zero-filling numeric values so simulate a numeric comparison
+            result = tuple([p.zfill(8) if p.isdigit() else p for p in parts])
+        return result
+
+    m = is_semver(s)
+    if not m:
+        raise UnsupportedVersionError(s)
+    groups = m.groups()
+    major, minor, patch = [int(i) for i in groups[:3]]
+    # choose the '|' and '*' so that versions sort correctly
+    pre, build = make_tuple(groups[3], '|'), make_tuple(groups[5], '*')
+    return (major, minor, patch), pre, build
+
+
+class SemanticVersion(Version):
+    def parse(self, s):
+        return _semantic_key(s)
+
+    @property
+    def is_prerelease(self):
+        return self._parts[1][0] != '|'
+
+
+class SemanticMatcher(Matcher):
+    version_class = SemanticVersion
+
+
+class VersionScheme(object):
+    def __init__(self, key, matcher, suggester=None):
+        self.key = key
+        self.matcher = matcher
+        self.suggester = suggester
+
+    def is_valid_version(self, s):
+        try:
+            self.matcher.version_class(s)
+            result = True
+        except UnsupportedVersionError:
+            result = False
+        return result
+
+    def is_valid_matcher(self, s):
+        try:
+            self.matcher(s)
+            result = True
+        except UnsupportedVersionError:
+            result = False
+        return result
+
+    def is_valid_constraint_list(self, s):
+        """
+        Used for processing some metadata fields
+        """
+        return self.is_valid_matcher('dummy_name (%s)' % s)
+
+    def suggest(self, s):
+        if self.suggester is None:
+            result = None
+        else:
+            result = self.suggester(s)
+        return result
+
+_SCHEMES = {
+    'normalized': VersionScheme(_normalized_key, NormalizedMatcher,
+                                _suggest_normalized_version),
+    'legacy': VersionScheme(_legacy_key, LegacyMatcher, lambda self, s: s),
+    'semantic': VersionScheme(_semantic_key, SemanticMatcher,
+                              _suggest_semantic_version),
+}
+
+_SCHEMES['default'] = _SCHEMES['normalized']
+
+
+def get_scheme(name):
+    if name not in _SCHEMES:
+        raise ValueError('unknown scheme name: %r' % name)
+    return _SCHEMES[name]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd179383ac98bb0b7ff3571666837e1f4a789c72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distlib/wheel.py
@@ -0,0 +1,1004 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (C) 2013-2017 Vinay Sajip.
+# Licensed to the Python Software Foundation under a contributor agreement.
+# See LICENSE.txt and CONTRIBUTORS.txt.
+#
+from __future__ import unicode_literals
+
+import base64
+import codecs
+import datetime
+import distutils.util
+from email import message_from_file
+import hashlib
+import imp
+import json
+import logging
+import os
+import posixpath
+import re
+import shutil
+import sys
+import tempfile
+import zipfile
+
+from . import __version__, DistlibException
+from .compat import sysconfig, ZipFile, fsdecode, text_type, filter
+from .database import InstalledDistribution
+from .metadata import Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME
+from .util import (FileOperator, convert_path, CSVReader, CSVWriter, Cache,
+                   cached_property, get_cache_base, read_exports, tempdir)
+from .version import NormalizedVersion, UnsupportedVersionError
+
+logger = logging.getLogger(__name__)
+
+cache = None    # created when needed
+
+if hasattr(sys, 'pypy_version_info'):  # pragma: no cover
+    IMP_PREFIX = 'pp'
+elif sys.platform.startswith('java'):  # pragma: no cover
+    IMP_PREFIX = 'jy'
+elif sys.platform == 'cli':  # pragma: no cover
+    IMP_PREFIX = 'ip'
+else:
+    IMP_PREFIX = 'cp'
+
+VER_SUFFIX = sysconfig.get_config_var('py_version_nodot')
+if not VER_SUFFIX:   # pragma: no cover
+    VER_SUFFIX = '%s%s' % sys.version_info[:2]
+PYVER = 'py' + VER_SUFFIX
+IMPVER = IMP_PREFIX + VER_SUFFIX
+
+ARCH = distutils.util.get_platform().replace('-', '_').replace('.', '_')
+
+ABI = sysconfig.get_config_var('SOABI')
+if ABI and ABI.startswith('cpython-'):
+    ABI = ABI.replace('cpython-', 'cp')
+else:
+    def _derive_abi():
+        parts = ['cp', VER_SUFFIX]
+        if sysconfig.get_config_var('Py_DEBUG'):
+            parts.append('d')
+        if sysconfig.get_config_var('WITH_PYMALLOC'):
+            parts.append('m')
+        if sysconfig.get_config_var('Py_UNICODE_SIZE') == 4:
+            parts.append('u')
+        return ''.join(parts)
+    ABI = _derive_abi()
+    del _derive_abi
+
+FILENAME_RE = re.compile(r'''
+(?P<nm>[^-]+)
+-(?P<vn>\d+[^-]*)
+(-(?P<bn>\d+[^-]*))?
+-(?P<py>\w+\d+(\.\w+\d+)*)
+-(?P<bi>\w+)
+-(?P<ar>\w+(\.\w+)*)
+\.whl$
+''', re.IGNORECASE | re.VERBOSE)
+
+NAME_VERSION_RE = re.compile(r'''
+(?P<nm>[^-]+)
+-(?P<vn>\d+[^-]*)
+(-(?P<bn>\d+[^-]*))?$
+''', re.IGNORECASE | re.VERBOSE)
+
+SHEBANG_RE = re.compile(br'\s*#![^\r\n]*')
+SHEBANG_DETAIL_RE = re.compile(br'^(\s*#!("[^"]+"|\S+))\s+(.*)$')
+SHEBANG_PYTHON = b'#!python'
+SHEBANG_PYTHONW = b'#!pythonw'
+
+if os.sep == '/':
+    to_posix = lambda o: o
+else:
+    to_posix = lambda o: o.replace(os.sep, '/')
+
+
+class Mounter(object):
+    def __init__(self):
+        self.impure_wheels = {}
+        self.libs = {}
+
+    def add(self, pathname, extensions):
+        self.impure_wheels[pathname] = extensions
+        self.libs.update(extensions)
+
+    def remove(self, pathname):
+        extensions = self.impure_wheels.pop(pathname)
+        for k, v in extensions:
+            if k in self.libs:
+                del self.libs[k]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.libs:
+            result = self
+        else:
+            result = None
+        return result
+
+    def load_module(self, fullname):
+        if fullname in sys.modules:
+            result = sys.modules[fullname]
+        else:
+            if fullname not in self.libs:
+                raise ImportError('unable to find extension for %s' % fullname)
+            result = imp.load_dynamic(fullname, self.libs[fullname])
+            result.__loader__ = self
+            parts = fullname.rsplit('.', 1)
+            if len(parts) > 1:
+                result.__package__ = parts[0]
+        return result
+
+_hook = Mounter()
+
+
+class Wheel(object):
+    """
+    Class to build and install from Wheel files (PEP 427).
+    """
+
+    wheel_version = (1, 1)
+    hash_kind = 'sha256'
+
+    def __init__(self, filename=None, sign=False, verify=False):
+        """
+        Initialise an instance using a (valid) filename.
+        """
+        self.sign = sign
+        self.should_verify = verify
+        self.buildver = ''
+        self.pyver = [PYVER]
+        self.abi = ['none']
+        self.arch = ['any']
+        self.dirname = os.getcwd()
+        if filename is None:
+            self.name = 'dummy'
+            self.version = '0.1'
+            self._filename = self.filename
+        else:
+            m = NAME_VERSION_RE.match(filename)
+            if m:
+                info = m.groupdict('')
+                self.name = info['nm']
+                # Reinstate the local version separator
+                self.version = info['vn'].replace('_', '-')
+                self.buildver = info['bn']
+                self._filename = self.filename
+            else:
+                dirname, filename = os.path.split(filename)
+                m = FILENAME_RE.match(filename)
+                if not m:
+                    raise DistlibException('Invalid name or '
+                                           'filename: %r' % filename)
+                if dirname:
+                    self.dirname = os.path.abspath(dirname)
+                self._filename = filename
+                info = m.groupdict('')
+                self.name = info['nm']
+                self.version = info['vn']
+                self.buildver = info['bn']
+                self.pyver = info['py'].split('.')
+                self.abi = info['bi'].split('.')
+                self.arch = info['ar'].split('.')
+
+    @property
+    def filename(self):
+        """
+        Build and return a filename from the various components.
+        """
+        if self.buildver:
+            buildver = '-' + self.buildver
+        else:
+            buildver = ''
+        pyver = '.'.join(self.pyver)
+        abi = '.'.join(self.abi)
+        arch = '.'.join(self.arch)
+        # replace - with _ as a local version separator
+        version = self.version.replace('-', '_')
+        return '%s-%s%s-%s-%s-%s.whl' % (self.name, version, buildver,
+                                         pyver, abi, arch)
+
+    @property
+    def exists(self):
+        path = os.path.join(self.dirname, self.filename)
+        return os.path.isfile(path)
+
+    @property
+    def tags(self):
+        for pyver in self.pyver:
+            for abi in self.abi:
+                for arch in self.arch:
+                    yield pyver, abi, arch
+
+    @cached_property
+    def metadata(self):
+        pathname = os.path.join(self.dirname, self.filename)
+        name_ver = '%s-%s' % (self.name, self.version)
+        info_dir = '%s.dist-info' % name_ver
+        wrapper = codecs.getreader('utf-8')
+        with ZipFile(pathname, 'r') as zf:
+            wheel_metadata = self.get_wheel_metadata(zf)
+            wv = wheel_metadata['Wheel-Version'].split('.', 1)
+            file_version = tuple([int(i) for i in wv])
+            if file_version < (1, 1):
+                fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME, 'METADATA']
+            else:
+                fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME]
+            result = None
+            for fn in fns:
+                try:
+                    metadata_filename = posixpath.join(info_dir, fn)
+                    with zf.open(metadata_filename) as bf:
+                        wf = wrapper(bf)
+                        result = Metadata(fileobj=wf)
+                        if result:
+                            break
+                except KeyError:
+                    pass
+            if not result:
+                raise ValueError('Invalid wheel, because metadata is '
+                                 'missing: looked in %s' % ', '.join(fns))
+        return result
+
+    def get_wheel_metadata(self, zf):
+        name_ver = '%s-%s' % (self.name, self.version)
+        info_dir = '%s.dist-info' % name_ver
+        metadata_filename = posixpath.join(info_dir, 'WHEEL')
+        with zf.open(metadata_filename) as bf:
+            wf = codecs.getreader('utf-8')(bf)
+            message = message_from_file(wf)
+        return dict(message)
+
+    @cached_property
+    def info(self):
+        pathname = os.path.join(self.dirname, self.filename)
+        with ZipFile(pathname, 'r') as zf:
+            result = self.get_wheel_metadata(zf)
+        return result
+
+    def process_shebang(self, data):
+        m = SHEBANG_RE.match(data)
+        if m:
+            end = m.end()
+            shebang, data_after_shebang = data[:end], data[end:]
+            # Preserve any arguments after the interpreter
+            if b'pythonw' in shebang.lower():
+                shebang_python = SHEBANG_PYTHONW
+            else:
+                shebang_python = SHEBANG_PYTHON
+            m = SHEBANG_DETAIL_RE.match(shebang)
+            if m:
+                args = b' ' + m.groups()[-1]
+            else:
+                args = b''
+            shebang = shebang_python + args
+            data = shebang + data_after_shebang
+        else:
+            cr = data.find(b'\r')
+            lf = data.find(b'\n')
+            if cr < 0 or cr > lf:
+                term = b'\n'
+            else:
+                if data[cr:cr + 2] == b'\r\n':
+                    term = b'\r\n'
+                else:
+                    term = b'\r'
+            data = SHEBANG_PYTHON + term + data
+        return data
+
+    def get_hash(self, data, hash_kind=None):
+        if hash_kind is None:
+            hash_kind = self.hash_kind
+        try:
+            hasher = getattr(hashlib, hash_kind)
+        except AttributeError:
+            raise DistlibException('Unsupported hash algorithm: %r' % hash_kind)
+        result = hasher(data).digest()
+        result = base64.urlsafe_b64encode(result).rstrip(b'=').decode('ascii')
+        return hash_kind, result
+
+    def write_record(self, records, record_path, base):
+        records = list(records) # make a copy for sorting
+        p = to_posix(os.path.relpath(record_path, base))
+        records.append((p, '', ''))
+        records.sort()
+        with CSVWriter(record_path) as writer:
+            for row in records:
+                writer.writerow(row)
+
+    def write_records(self, info, libdir, archive_paths):
+        records = []
+        distinfo, info_dir = info
+        hasher = getattr(hashlib, self.hash_kind)
+        for ap, p in archive_paths:
+            with open(p, 'rb') as f:
+                data = f.read()
+            digest = '%s=%s' % self.get_hash(data)
+            size = os.path.getsize(p)
+            records.append((ap, digest, size))
+
+        p = os.path.join(distinfo, 'RECORD')
+        self.write_record(records, p, libdir)
+        ap = to_posix(os.path.join(info_dir, 'RECORD'))
+        archive_paths.append((ap, p))
+
+    def build_zip(self, pathname, archive_paths):
+        with ZipFile(pathname, 'w', zipfile.ZIP_DEFLATED) as zf:
+            for ap, p in archive_paths:
+                logger.debug('Wrote %s to %s in wheel', p, ap)
+                zf.write(p, ap)
+
+    def build(self, paths, tags=None, wheel_version=None):
+        """
+        Build a wheel from files in specified paths, and use any specified tags
+        when determining the name of the wheel.
+        """
+        if tags is None:
+            tags = {}
+
+        libkey = list(filter(lambda o: o in paths, ('purelib', 'platlib')))[0]
+        if libkey == 'platlib':
+            is_pure = 'false'
+            default_pyver = [IMPVER]
+            default_abi = [ABI]
+            default_arch = [ARCH]
+        else:
+            is_pure = 'true'
+            default_pyver = [PYVER]
+            default_abi = ['none']
+            default_arch = ['any']
+
+        self.pyver = tags.get('pyver', default_pyver)
+        self.abi = tags.get('abi', default_abi)
+        self.arch = tags.get('arch', default_arch)
+
+        libdir = paths[libkey]
+
+        name_ver = '%s-%s' % (self.name, self.version)
+        data_dir = '%s.data' % name_ver
+        info_dir = '%s.dist-info' % name_ver
+
+        archive_paths = []
+
+        # First, stuff which is not in site-packages
+        for key in ('data', 'headers', 'scripts'):
+            if key not in paths:
+                continue
+            path = paths[key]
+            if os.path.isdir(path):
+                for root, dirs, files in os.walk(path):
+                    for fn in files:
+                        p = fsdecode(os.path.join(root, fn))
+                        rp = os.path.relpath(p, path)
+                        ap = to_posix(os.path.join(data_dir, key, rp))
+                        archive_paths.append((ap, p))
+                        if key == 'scripts' and not p.endswith('.exe'):
+                            with open(p, 'rb') as f:
+                                data = f.read()
+                            data = self.process_shebang(data)
+                            with open(p, 'wb') as f:
+                                f.write(data)
+
+        # Now, stuff which is in site-packages, other than the
+        # distinfo stuff.
+        path = libdir
+        distinfo = None
+        for root, dirs, files in os.walk(path):
+            if root == path:
+                # At the top level only, save distinfo for later
+                # and skip it for now
+                for i, dn in enumerate(dirs):
+                    dn = fsdecode(dn)
+                    if dn.endswith('.dist-info'):
+                        distinfo = os.path.join(root, dn)
+                        del dirs[i]
+                        break
+                assert distinfo, '.dist-info directory expected, not found'
+
+            for fn in files:
+                # comment out next suite to leave .pyc files in
+                if fsdecode(fn).endswith(('.pyc', '.pyo')):
+                    continue
+                p = os.path.join(root, fn)
+                rp = to_posix(os.path.relpath(p, path))
+                archive_paths.append((rp, p))
+
+        # Now distinfo. Assumed to be flat, i.e. os.listdir is enough.
+        files = os.listdir(distinfo)
+        for fn in files:
+            if fn not in ('RECORD', 'INSTALLER', 'SHARED', 'WHEEL'):
+                p = fsdecode(os.path.join(distinfo, fn))
+                ap = to_posix(os.path.join(info_dir, fn))
+                archive_paths.append((ap, p))
+
+        wheel_metadata = [
+            'Wheel-Version: %d.%d' % (wheel_version or self.wheel_version),
+            'Generator: distlib %s' % __version__,
+            'Root-Is-Purelib: %s' % is_pure,
+        ]
+        for pyver, abi, arch in self.tags:
+            wheel_metadata.append('Tag: %s-%s-%s' % (pyver, abi, arch))
+        p = os.path.join(distinfo, 'WHEEL')
+        with open(p, 'w') as f:
+            f.write('\n'.join(wheel_metadata))
+        ap = to_posix(os.path.join(info_dir, 'WHEEL'))
+        archive_paths.append((ap, p))
+
+        # Now, at last, RECORD.
+        # Paths in here are archive paths - nothing else makes sense.
+        self.write_records((distinfo, info_dir), libdir, archive_paths)
+        # Now, ready to build the zip file
+        pathname = os.path.join(self.dirname, self.filename)
+        self.build_zip(pathname, archive_paths)
+        return pathname
+
+    def skip_entry(self, arcname):
+        """
+        Determine whether an archive entry should be skipped when verifying
+        or installing.
+        """
+        # The signature file won't be in RECORD,
+        # and we  don't currently don't do anything with it
+        # We also skip directories, as they won't be in RECORD
+        # either. See:
+        #
+        # https://github.com/pypa/wheel/issues/294
+        # https://github.com/pypa/wheel/issues/287
+        # https://github.com/pypa/wheel/pull/289
+        #
+        return arcname.endswith(('/', '/RECORD.jws'))
+
+    def install(self, paths, maker, **kwargs):
+        """
+        Install a wheel to the specified paths. If kwarg ``warner`` is
+        specified, it should be a callable, which will be called with two
+        tuples indicating the wheel version of this software and the wheel
+        version in the file, if there is a discrepancy in the versions.
+        This can be used to issue any warnings to raise any exceptions.
+        If kwarg ``lib_only`` is True, only the purelib/platlib files are
+        installed, and the headers, scripts, data and dist-info metadata are
+        not written. If kwarg ``bytecode_hashed_invalidation`` is True, written
+        bytecode will try to use file-hash based invalidation (PEP-552) on
+        supported interpreter versions (CPython 2.7+).
+
+        The return value is a :class:`InstalledDistribution` instance unless
+        ``options.lib_only`` is True, in which case the return value is ``None``.
+        """
+
+        dry_run = maker.dry_run
+        warner = kwargs.get('warner')
+        lib_only = kwargs.get('lib_only', False)
+        bc_hashed_invalidation = kwargs.get('bytecode_hashed_invalidation', False)
+
+        pathname = os.path.join(self.dirname, self.filename)
+        name_ver = '%s-%s' % (self.name, self.version)
+        data_dir = '%s.data' % name_ver
+        info_dir = '%s.dist-info' % name_ver
+
+        metadata_name = posixpath.join(info_dir, METADATA_FILENAME)
+        wheel_metadata_name = posixpath.join(info_dir, 'WHEEL')
+        record_name = posixpath.join(info_dir, 'RECORD')
+
+        wrapper = codecs.getreader('utf-8')
+
+        with ZipFile(pathname, 'r') as zf:
+            with zf.open(wheel_metadata_name) as bwf:
+                wf = wrapper(bwf)
+                message = message_from_file(wf)
+            wv = message['Wheel-Version'].split('.', 1)
+            file_version = tuple([int(i) for i in wv])
+            if (file_version != self.wheel_version) and warner:
+                warner(self.wheel_version, file_version)
+
+            if message['Root-Is-Purelib'] == 'true':
+                libdir = paths['purelib']
+            else:
+                libdir = paths['platlib']
+
+            records = {}
+            with zf.open(record_name) as bf:
+                with CSVReader(stream=bf) as reader:
+                    for row in reader:
+                        p = row[0]
+                        records[p] = row
+
+            data_pfx = posixpath.join(data_dir, '')
+            info_pfx = posixpath.join(info_dir, '')
+            script_pfx = posixpath.join(data_dir, 'scripts', '')
+
+            # make a new instance rather than a copy of maker's,
+            # as we mutate it
+            fileop = FileOperator(dry_run=dry_run)
+            fileop.record = True    # so we can rollback if needed
+
+            bc = not sys.dont_write_bytecode    # Double negatives. Lovely!
+
+            outfiles = []   # for RECORD writing
+
+            # for script copying/shebang processing
+            workdir = tempfile.mkdtemp()
+            # set target dir later
+            # we default add_launchers to False, as the
+            # Python Launcher should be used instead
+            maker.source_dir = workdir
+            maker.target_dir = None
+            try:
+                for zinfo in zf.infolist():
+                    arcname = zinfo.filename
+                    if isinstance(arcname, text_type):
+                        u_arcname = arcname
+                    else:
+                        u_arcname = arcname.decode('utf-8')
+                    if self.skip_entry(u_arcname):
+                        continue
+                    row = records[u_arcname]
+                    if row[2] and str(zinfo.file_size) != row[2]:
+                        raise DistlibException('size mismatch for '
+                                               '%s' % u_arcname)
+                    if row[1]:
+                        kind, value = row[1].split('=', 1)
+                        with zf.open(arcname) as bf:
+                            data = bf.read()
+                        _, digest = self.get_hash(data, kind)
+                        if digest != value:
+                            raise DistlibException('digest mismatch for '
+                                                   '%s' % arcname)
+
+                    if lib_only and u_arcname.startswith((info_pfx, data_pfx)):
+                        logger.debug('lib_only: skipping %s', u_arcname)
+                        continue
+                    is_script = (u_arcname.startswith(script_pfx)
+                                 and not u_arcname.endswith('.exe'))
+
+                    if u_arcname.startswith(data_pfx):
+                        _, where, rp = u_arcname.split('/', 2)
+                        outfile = os.path.join(paths[where], convert_path(rp))
+                    else:
+                        # meant for site-packages.
+                        if u_arcname in (wheel_metadata_name, record_name):
+                            continue
+                        outfile = os.path.join(libdir, convert_path(u_arcname))
+                    if not is_script:
+                        with zf.open(arcname) as bf:
+                            fileop.copy_stream(bf, outfile)
+                        outfiles.append(outfile)
+                        # Double check the digest of the written file
+                        if not dry_run and row[1]:
+                            with open(outfile, 'rb') as bf:
+                                data = bf.read()
+                                _, newdigest = self.get_hash(data, kind)
+                                if newdigest != digest:
+                                    raise DistlibException('digest mismatch '
+                                                           'on write for '
+                                                           '%s' % outfile)
+                        if bc and outfile.endswith('.py'):
+                            try:
+                                pyc = fileop.byte_compile(outfile,
+                                                          hashed_invalidation=bc_hashed_invalidation)
+                                outfiles.append(pyc)
+                            except Exception:
+                                # Don't give up if byte-compilation fails,
+                                # but log it and perhaps warn the user
+                                logger.warning('Byte-compilation failed',
+                                               exc_info=True)
+                    else:
+                        fn = os.path.basename(convert_path(arcname))
+                        workname = os.path.join(workdir, fn)
+                        with zf.open(arcname) as bf:
+                            fileop.copy_stream(bf, workname)
+
+                        dn, fn = os.path.split(outfile)
+                        maker.target_dir = dn
+                        filenames = maker.make(fn)
+                        fileop.set_executable_mode(filenames)
+                        outfiles.extend(filenames)
+
+                if lib_only:
+                    logger.debug('lib_only: returning None')
+                    dist = None
+                else:
+                    # Generate scripts
+
+                    # Try to get pydist.json so we can see if there are
+                    # any commands to generate. If this fails (e.g. because
+                    # of a legacy wheel), log a warning but don't give up.
+                    commands = None
+                    file_version = self.info['Wheel-Version']
+                    if file_version == '1.0':
+                        # Use legacy info
+                        ep = posixpath.join(info_dir, 'entry_points.txt')
+                        try:
+                            with zf.open(ep) as bwf:
+                                epdata = read_exports(bwf)
+                            commands = {}
+                            for key in ('console', 'gui'):
+                                k = '%s_scripts' % key
+                                if k in epdata:
+                                    commands['wrap_%s' % key] = d = {}
+                                    for v in epdata[k].values():
+                                        s = '%s:%s' % (v.prefix, v.suffix)
+                                        if v.flags:
+                                            s += ' %s' % v.flags
+                                        d[v.name] = s
+                        except Exception:
+                            logger.warning('Unable to read legacy script '
+                                           'metadata, so cannot generate '
+                                           'scripts')
+                    else:
+                        try:
+                            with zf.open(metadata_name) as bwf:
+                                wf = wrapper(bwf)
+                                commands = json.load(wf).get('extensions')
+                                if commands:
+                                    commands = commands.get('python.commands')
+                        except Exception:
+                            logger.warning('Unable to read JSON metadata, so '
+                                           'cannot generate scripts')
+                    if commands:
+                        console_scripts = commands.get('wrap_console', {})
+                        gui_scripts = commands.get('wrap_gui', {})
+                        if console_scripts or gui_scripts:
+                            script_dir = paths.get('scripts', '')
+                            if not os.path.isdir(script_dir):
+                                raise ValueError('Valid script path not '
+                                                 'specified')
+                            maker.target_dir = script_dir
+                            for k, v in console_scripts.items():
+                                script = '%s = %s' % (k, v)
+                                filenames = maker.make(script)
+                                fileop.set_executable_mode(filenames)
+
+                            if gui_scripts:
+                                options = {'gui': True }
+                                for k, v in gui_scripts.items():
+                                    script = '%s = %s' % (k, v)
+                                    filenames = maker.make(script, options)
+                                    fileop.set_executable_mode(filenames)
+
+                    p = os.path.join(libdir, info_dir)
+                    dist = InstalledDistribution(p)
+
+                    # Write SHARED
+                    paths = dict(paths)     # don't change passed in dict
+                    del paths['purelib']
+                    del paths['platlib']
+                    paths['lib'] = libdir
+                    p = dist.write_shared_locations(paths, dry_run)
+                    if p:
+                        outfiles.append(p)
+
+                    # Write RECORD
+                    dist.write_installed_files(outfiles, paths['prefix'],
+                                               dry_run)
+                return dist
+            except Exception:  # pragma: no cover
+                logger.exception('installation failed.')
+                fileop.rollback()
+                raise
+            finally:
+                shutil.rmtree(workdir)
+
+    def _get_dylib_cache(self):
+        global cache
+        if cache is None:
+            # Use native string to avoid issues on 2.x: see Python #20140.
+            base = os.path.join(get_cache_base(), str('dylib-cache'),
+                                '%s.%s' % sys.version_info[:2])
+            cache = Cache(base)
+        return cache
+
+    def _get_extensions(self):
+        pathname = os.path.join(self.dirname, self.filename)
+        name_ver = '%s-%s' % (self.name, self.version)
+        info_dir = '%s.dist-info' % name_ver
+        arcname = posixpath.join(info_dir, 'EXTENSIONS')
+        wrapper = codecs.getreader('utf-8')
+        result = []
+        with ZipFile(pathname, 'r') as zf:
+            try:
+                with zf.open(arcname) as bf:
+                    wf = wrapper(bf)
+                    extensions = json.load(wf)
+                    cache = self._get_dylib_cache()
+                    prefix = cache.prefix_to_dir(pathname)
+                    cache_base = os.path.join(cache.base, prefix)
+                    if not os.path.isdir(cache_base):
+                        os.makedirs(cache_base)
+                    for name, relpath in extensions.items():
+                        dest = os.path.join(cache_base, convert_path(relpath))
+                        if not os.path.exists(dest):
+                            extract = True
+                        else:
+                            file_time = os.stat(dest).st_mtime
+                            file_time = datetime.datetime.fromtimestamp(file_time)
+                            info = zf.getinfo(relpath)
+                            wheel_time = datetime.datetime(*info.date_time)
+                            extract = wheel_time > file_time
+                        if extract:
+                            zf.extract(relpath, cache_base)
+                        result.append((name, dest))
+            except KeyError:
+                pass
+        return result
+
+    def is_compatible(self):
+        """
+        Determine if a wheel is compatible with the running system.
+        """
+        return is_compatible(self)
+
+    def is_mountable(self):
+        """
+        Determine if a wheel is asserted as mountable by its metadata.
+        """
+        return True # for now - metadata details TBD
+
+    def mount(self, append=False):
+        pathname = os.path.abspath(os.path.join(self.dirname, self.filename))
+        if not self.is_compatible():
+            msg = 'Wheel %s not compatible with this Python.' % pathname
+            raise DistlibException(msg)
+        if not self.is_mountable():
+            msg = 'Wheel %s is marked as not mountable.' % pathname
+            raise DistlibException(msg)
+        if pathname in sys.path:
+            logger.debug('%s already in path', pathname)
+        else:
+            if append:
+                sys.path.append(pathname)
+            else:
+                sys.path.insert(0, pathname)
+            extensions = self._get_extensions()
+            if extensions:
+                if _hook not in sys.meta_path:
+                    sys.meta_path.append(_hook)
+                _hook.add(pathname, extensions)
+
+    def unmount(self):
+        pathname = os.path.abspath(os.path.join(self.dirname, self.filename))
+        if pathname not in sys.path:
+            logger.debug('%s not in path', pathname)
+        else:
+            sys.path.remove(pathname)
+            if pathname in _hook.impure_wheels:
+                _hook.remove(pathname)
+            if not _hook.impure_wheels:
+                if _hook in sys.meta_path:
+                    sys.meta_path.remove(_hook)
+
+    def verify(self):
+        pathname = os.path.join(self.dirname, self.filename)
+        name_ver = '%s-%s' % (self.name, self.version)
+        data_dir = '%s.data' % name_ver
+        info_dir = '%s.dist-info' % name_ver
+
+        metadata_name = posixpath.join(info_dir, METADATA_FILENAME)
+        wheel_metadata_name = posixpath.join(info_dir, 'WHEEL')
+        record_name = posixpath.join(info_dir, 'RECORD')
+
+        wrapper = codecs.getreader('utf-8')
+
+        with ZipFile(pathname, 'r') as zf:
+            with zf.open(wheel_metadata_name) as bwf:
+                wf = wrapper(bwf)
+                message = message_from_file(wf)
+            wv = message['Wheel-Version'].split('.', 1)
+            file_version = tuple([int(i) for i in wv])
+            # TODO version verification
+
+            records = {}
+            with zf.open(record_name) as bf:
+                with CSVReader(stream=bf) as reader:
+                    for row in reader:
+                        p = row[0]
+                        records[p] = row
+
+            for zinfo in zf.infolist():
+                arcname = zinfo.filename
+                if isinstance(arcname, text_type):
+                    u_arcname = arcname
+                else:
+                    u_arcname = arcname.decode('utf-8')
+                # See issue #115: some wheels have .. in their entries, but
+                # in the filename ... e.g. __main__..py ! So the check is
+                # updated to look for .. in the directory portions
+                p = u_arcname.split('/')
+                if '..' in p:
+                    raise DistlibException('invalid entry in '
+                                           'wheel: %r' % u_arcname)
+
+                if self.skip_entry(u_arcname):
+                    continue
+                row = records[u_arcname]
+                if row[2] and str(zinfo.file_size) != row[2]:
+                    raise DistlibException('size mismatch for '
+                                           '%s' % u_arcname)
+                if row[1]:
+                    kind, value = row[1].split('=', 1)
+                    with zf.open(arcname) as bf:
+                        data = bf.read()
+                    _, digest = self.get_hash(data, kind)
+                    if digest != value:
+                        raise DistlibException('digest mismatch for '
+                                               '%s' % arcname)
+
+    def update(self, modifier, dest_dir=None, **kwargs):
+        """
+        Update the contents of a wheel in a generic way. The modifier should
+        be a callable which expects a dictionary argument: its keys are
+        archive-entry paths, and its values are absolute filesystem paths
+        where the contents the corresponding archive entries can be found. The
+        modifier is free to change the contents of the files pointed to, add
+        new entries and remove entries, before returning. This method will
+        extract the entire contents of the wheel to a temporary location, call
+        the modifier, and then use the passed (and possibly updated)
+        dictionary to write a new wheel. If ``dest_dir`` is specified, the new
+        wheel is written there -- otherwise, the original wheel is overwritten.
+
+        The modifier should return True if it updated the wheel, else False.
+        This method returns the same value the modifier returns.
+        """
+
+        def get_version(path_map, info_dir):
+            version = path = None
+            key = '%s/%s' % (info_dir, METADATA_FILENAME)
+            if key not in path_map:
+                key = '%s/PKG-INFO' % info_dir
+            if key in path_map:
+                path = path_map[key]
+                version = Metadata(path=path).version
+            return version, path
+
+        def update_version(version, path):
+            updated = None
+            try:
+                v = NormalizedVersion(version)
+                i = version.find('-')
+                if i < 0:
+                    updated = '%s+1' % version
+                else:
+                    parts = [int(s) for s in version[i + 1:].split('.')]
+                    parts[-1] += 1
+                    updated = '%s+%s' % (version[:i],
+                                         '.'.join(str(i) for i in parts))
+            except UnsupportedVersionError:
+                logger.debug('Cannot update non-compliant (PEP-440) '
+                             'version %r', version)
+            if updated:
+                md = Metadata(path=path)
+                md.version = updated
+                legacy = not path.endswith(METADATA_FILENAME)
+                md.write(path=path, legacy=legacy)
+                logger.debug('Version updated from %r to %r', version,
+                             updated)
+
+        pathname = os.path.join(self.dirname, self.filename)
+        name_ver = '%s-%s' % (self.name, self.version)
+        info_dir = '%s.dist-info' % name_ver
+        record_name = posixpath.join(info_dir, 'RECORD')
+        with tempdir() as workdir:
+            with ZipFile(pathname, 'r') as zf:
+                path_map = {}
+                for zinfo in zf.infolist():
+                    arcname = zinfo.filename
+                    if isinstance(arcname, text_type):
+                        u_arcname = arcname
+                    else:
+                        u_arcname = arcname.decode('utf-8')
+                    if u_arcname == record_name:
+                        continue
+                    if '..' in u_arcname:
+                        raise DistlibException('invalid entry in '
+                                               'wheel: %r' % u_arcname)
+                    zf.extract(zinfo, workdir)
+                    path = os.path.join(workdir, convert_path(u_arcname))
+                    path_map[u_arcname] = path
+
+            # Remember the version.
+            original_version, _ = get_version(path_map, info_dir)
+            # Files extracted. Call the modifier.
+            modified = modifier(path_map, **kwargs)
+            if modified:
+                # Something changed - need to build a new wheel.
+                current_version, path = get_version(path_map, info_dir)
+                if current_version and (current_version == original_version):
+                    # Add or update local version to signify changes.
+                    update_version(current_version, path)
+                # Decide where the new wheel goes.
+                if dest_dir is None:
+                    fd, newpath = tempfile.mkstemp(suffix='.whl',
+                                                   prefix='wheel-update-',
+                                                   dir=workdir)
+                    os.close(fd)
+                else:
+                    if not os.path.isdir(dest_dir):
+                        raise DistlibException('Not a directory: %r' % dest_dir)
+                    newpath = os.path.join(dest_dir, self.filename)
+                archive_paths = list(path_map.items())
+                distinfo = os.path.join(workdir, info_dir)
+                info = distinfo, info_dir
+                self.write_records(info, workdir, archive_paths)
+                self.build_zip(newpath, archive_paths)
+                if dest_dir is None:
+                    shutil.copyfile(newpath, pathname)
+        return modified
+
+def compatible_tags():
+    """
+    Return (pyver, abi, arch) tuples compatible with this Python.
+    """
+    versions = [VER_SUFFIX]
+    major = VER_SUFFIX[0]
+    for minor in range(sys.version_info[1] - 1, - 1, -1):
+        versions.append(''.join([major, str(minor)]))
+
+    abis = []
+    for suffix, _, _ in imp.get_suffixes():
+        if suffix.startswith('.abi'):
+            abis.append(suffix.split('.', 2)[1])
+    abis.sort()
+    if ABI != 'none':
+        abis.insert(0, ABI)
+    abis.append('none')
+    result = []
+
+    arches = [ARCH]
+    if sys.platform == 'darwin':
+        m = re.match(r'(\w+)_(\d+)_(\d+)_(\w+)$', ARCH)
+        if m:
+            name, major, minor, arch = m.groups()
+            minor = int(minor)
+            matches = [arch]
+            if arch in ('i386', 'ppc'):
+                matches.append('fat')
+            if arch in ('i386', 'ppc', 'x86_64'):
+                matches.append('fat3')
+            if arch in ('ppc64', 'x86_64'):
+                matches.append('fat64')
+            if arch in ('i386', 'x86_64'):
+                matches.append('intel')
+            if arch in ('i386', 'x86_64', 'intel', 'ppc', 'ppc64'):
+                matches.append('universal')
+            while minor >= 0:
+                for match in matches:
+                    s = '%s_%s_%s_%s' % (name, major, minor, match)
+                    if s != ARCH:   # already there
+                        arches.append(s)
+                minor -= 1
+
+    # Most specific - our Python version, ABI and arch
+    for abi in abis:
+        for arch in arches:
+            result.append((''.join((IMP_PREFIX, versions[0])), abi, arch))
+
+    # where no ABI / arch dependency, but IMP_PREFIX dependency
+    for i, version in enumerate(versions):
+        result.append((''.join((IMP_PREFIX, version)), 'none', 'any'))
+        if i == 0:
+            result.append((''.join((IMP_PREFIX, version[0])), 'none', 'any'))
+
+    # no IMP_PREFIX, ABI or arch dependency
+    for i, version in enumerate(versions):
+        result.append((''.join(('py', version)), 'none', 'any'))
+        if i == 0:
+            result.append((''.join(('py', version[0])), 'none', 'any'))
+    return set(result)
+
+
+COMPATIBLE_TAGS = compatible_tags()
+
+del compatible_tags
+
+
+def is_compatible(wheel, tags=None):
+    if not isinstance(wheel, Wheel):
+        wheel = Wheel(wheel)    # assume it's a filename
+    result = False
+    if tags is None:
+        tags = COMPATIBLE_TAGS
+    for ver, abi, arch in tags:
+        if ver in wheel.pyver and abi in wheel.abi and arch in wheel.arch:
+            result = True
+            break
+    return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b34cf6205d1de724dd38179b318dc0f4172d8257
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/METADATA
@@ -0,0 +1,170 @@
+Metadata-Version: 2.1
+Name: distro
+Version: 1.4.0
+Summary: Distro - an OS platform information API
+Home-page: https://github.com/nir0s/distro
+Author: Nir Cohen
+Author-email: nir36g@gmail.com
+License: Apache License, Version 2.0
+Platform: All
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: BSD :: NetBSD
+Classifier: Operating System :: POSIX :: BSD :: OpenBSD
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Operating System
+Description-Content-Type: text/markdown
+
+Distro - an OS platform information API
+=======================================
+
+[![Build Status](https://travis-ci.org/nir0s/distro.svg?branch=master)](https://travis-ci.org/nir0s/distro)
+[![Build status](https://ci.appveyor.com/api/projects/status/e812qjk1gf0f74r5/branch/master?svg=true)](https://ci.appveyor.com/project/nir0s/distro/branch/master)
+[![PyPI version](http://img.shields.io/pypi/v/distro.svg)](https://pypi.python.org/pypi/distro)
+[![Supported Python Versions](https://img.shields.io/pypi/pyversions/distro.svg)](https://img.shields.io/pypi/pyversions/distro.svg)
+[![Requirements Status](https://requires.io/github/nir0s/distro/requirements.svg?branch=master)](https://requires.io/github/nir0s/distro/requirements/?branch=master)
+[![Code Coverage](https://codecov.io/github/nir0s/distro/coverage.svg?branch=master)](https://codecov.io/github/nir0s/distro?branch=master)
+[![Code Quality](https://landscape.io/github/nir0s/distro/master/landscape.svg?style=flat)](https://landscape.io/github/nir0s/distro)
+[![Is Wheel](https://img.shields.io/pypi/wheel/distro.svg?style=flat)](https://pypi.python.org/pypi/distro)
+[![Latest Github Release](https://readthedocs.org/projects/distro/badge/?version=stable)](http://distro.readthedocs.io/en/latest/)
+[![Join the chat at https://gitter.im/nir0s/distro](https://badges.gitter.im/nir0s/distro.svg)](https://gitter.im/nir0s/distro?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+`distro` provides information about the
+OS distribution it runs on, such as a reliable machine-readable ID, or
+version information.
+
+It is the recommended replacement for Python's original
+[`platform.linux_distribution`](https://docs.python.org/3.7/library/platform.html#platform.linux_distribution)
+function (which will be removed in Python 3.8).
+It also provides much more functionality which isn't necessarily Python bound,
+like a command-line interface.
+
+Distro currently supports Linux and BSD based systems but [Windows and OS X support](https://github.com/nir0s/distro/issues/177) is also planned.
+
+For Python 2.6 support, see https://github.com/nir0s/distro/tree/python2.6-support
+
+## Installation
+
+Installation of the latest released version from PyPI:
+
+```shell
+pip install distro
+```
+
+Installation of the latest development version:
+
+```shell
+pip install https://github.com/nir0s/distro/archive/master.tar.gz
+```
+
+
+## Usage
+
+```bash
+$ distro
+Name: Antergos Linux
+Version: 2015.10 (ISO-Rolling)
+Codename: ISO-Rolling
+
+$ distro -j
+{
+    "codename": "ISO-Rolling",
+    "id": "antergos",
+    "like": "arch",
+    "version": "16.9",
+    "version_parts": {
+        "build_number": "",
+        "major": "16",
+        "minor": "9"
+    }
+}
+
+
+$ python
+>>> import distro
+>>> distro.linux_distribution(full_distribution_name=False)
+('centos', '7.1.1503', 'Core')
+```
+
+
+## Documentation
+
+On top of the aforementioned API, several more functions are available. For a complete description of the
+API, see the [latest API documentation](http://distro.readthedocs.org/en/latest/).
+
+## Background
+
+An alternative implementation became necessary because Python 3.5 deprecated
+this function, and Python 3.8 will remove it altogether.
+Its predecessor function `platform.dist` was already deprecated since
+Python 2.6 and will also be removed in Python 3.8.
+Still, there are many cases in which access to that information is needed.
+See [Python issue 1322](https://bugs.python.org/issue1322) for more
+information.
+
+The `distro` package implements a robust and inclusive way of retrieving the
+information about a distribution based on new standards and old methods,
+namely from these data sources (from high to low precedence):
+
+* The os-release file `/etc/os-release`, if present.
+* The output of the `lsb_release` command, if available.
+* The distro release file (`/etc/*(-|_)(release|version)`), if present.
+* The `uname` command for BSD based distrubtions.
+
+
+## Python and Distribution Support
+
+`distro` is supported and tested on Python 2.7, 3.4+ and PyPy and on
+any distribution that provides one or more of the data sources
+covered.
+
+This package is tested with test data that mimics the exact behavior of the data sources of [a number of Linux distributions](https://github.com/nir0s/distro/tree/master/tests/resources/distros).
+
+
+## Testing
+
+```shell
+git clone git@github.com:nir0s/distro.git
+cd distro
+pip install tox
+tox
+```
+
+
+## Contributions
+
+Pull requests are always welcome to deal with specific distributions or just
+for general merriment.
+
+See [CONTRIBUTIONS](https://github.com/nir0s/distro/blob/master/CONTRIBUTING.md) for contribution info.
+
+Reference implementations for supporting additional distributions and file
+formats can be found here:
+
+* https://github.com/saltstack/salt/blob/develop/salt/grains/core.py#L1172
+* https://github.com/chef/ohai/blob/master/lib/ohai/plugins/linux/platform.rb
+* https://github.com/ansible/ansible/blob/devel/lib/ansible/module_utils/facts/system/distribution.py
+* https://github.com/puppetlabs/facter/blob/master/lib/src/facts/linux/os_linux.cc
+
+## Package manager distributions
+
+* https://src.fedoraproject.org/rpms/python-distro
+* https://www.archlinux.org/packages/community/any/python-distro/
+* https://launchpad.net/ubuntu/+source/python-distro
+* https://packages.debian.org/sid/python-distro
+* https://packages.gentoo.org/packages/dev-python/distro
+* https://pkgs.org/download/python2-distro
+* https://slackbuilds.org/repository/14.2/python/python-distro/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..0ad020978447d7a6505ef3c39349ecf0a8f47251
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/RECORD
@@ -0,0 +1,15 @@
+distro.py,sha256=X2So5kjrRKyMbQJ90Xgy93HU5eFtujCzKaYNeoy1k1c,43251
+distro-1.4.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+distro-1.4.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+distro-1.4.0.dist-info/METADATA,sha256=7u13dPkDA9zu5ahg3Ns-H2vfMpR6gBBS55EaBzlXIeg,6648
+distro-1.4.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+distro-1.4.0.dist-info/entry_points.txt,sha256=mDMyvS_AzB0WhRYe_6xrRkAAET1LwFiDTL5Sx57UFiY,40
+distro-1.4.0.dist-info/top_level.txt,sha256=ikde_V_XEdSBqaGd5tEriN_wzYHLgTX_zVtlsGLHvwQ,7
+distro-1.4.0.dist-info/RECORD,,
+distro-1.4.0.dist-info/INSTALLER,,
+distro-1.4.0.virtualenv,,
+../../../bin/distro3,,
+distro-1.4.0.dist-info/__pycache__,,
+../../../bin/distro,,
+distro.cpython-38.pyc,,
+../../../bin/distro-3.8,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..dd4023997f5b0b48c6939d03086d2caccd209d4c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+distro = distro:main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..0e0933171d3eb977bbc6911eec27b9c0ba289500
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+distro
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro-1.4.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro.py
new file mode 100644
index 0000000000000000000000000000000000000000..33061633efb6b03f6ca845ec5b0e69c90c25fdb8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/distro.py
@@ -0,0 +1,1216 @@
+# Copyright 2015,2016,2017 Nir Cohen
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+The ``distro`` package (``distro`` stands for Linux Distribution) provides
+information about the Linux distribution it runs on, such as a reliable
+machine-readable distro ID, or version information.
+
+It is the recommended replacement for Python's original
+:py:func:`platform.linux_distribution` function, but it provides much more
+functionality. An alternative implementation became necessary because Python
+3.5 deprecated this function, and Python 3.8 will remove it altogether.
+Its predecessor function :py:func:`platform.dist` was already
+deprecated since Python 2.6 and will also be removed in Python 3.8.
+Still, there are many cases in which access to OS distribution information
+is needed. See `Python issue 1322 <https://bugs.python.org/issue1322>`_ for
+more information.
+"""
+
+import os
+import re
+import sys
+import json
+import shlex
+import logging
+import argparse
+import subprocess
+
+
+_UNIXCONFDIR = os.environ.get('UNIXCONFDIR', '/etc')
+_OS_RELEASE_BASENAME = 'os-release'
+
+#: Translation table for normalizing the "ID" attribute defined in os-release
+#: files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as defined in the os-release file, translated to lower case,
+#:   with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_OS_ID = {
+    'ol': 'oracle',  # Oracle Enterprise Linux
+}
+
+#: Translation table for normalizing the "Distributor ID" attribute returned by
+#: the lsb_release command, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as returned by the lsb_release command, translated to lower
+#:   case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_LSB_ID = {
+    'enterpriseenterprise': 'oracle',  # Oracle Enterprise Linux
+    'redhatenterpriseworkstation': 'rhel',  # RHEL 6, 7 Workstation
+    'redhatenterpriseserver': 'rhel',  # RHEL 6, 7 Server
+}
+
+#: Translation table for normalizing the distro ID derived from the file name
+#: of distro release files, for use by the :func:`distro.id` method.
+#:
+#: * Key: Value as derived from the file name of a distro release file,
+#:   translated to lower case, with blanks translated to underscores.
+#:
+#: * Value: Normalized value.
+NORMALIZED_DISTRO_ID = {
+    'redhat': 'rhel',  # RHEL 6.x, 7.x
+}
+
+# Pattern for content of distro release file (reversed)
+_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
+    r'(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)')
+
+# Pattern for base file name of distro release file
+_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(
+    r'(\w+)[-_](release|version)$')
+
+# Base file names to be ignored when searching for distro release file
+_DISTRO_RELEASE_IGNORE_BASENAMES = (
+    'debian_version',
+    'lsb-release',
+    'oem-release',
+    _OS_RELEASE_BASENAME,
+    'system-release'
+)
+
+
+def linux_distribution(full_distribution_name=True):
+    """
+    Return information about the current OS distribution as a tuple
+    ``(id_name, version, codename)`` with items as follows:
+
+    * ``id_name``:  If *full_distribution_name* is false, the result of
+      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``codename``:  The result of :func:`distro.codename`.
+
+    The interface of this function is compatible with the original
+    :py:func:`platform.linux_distribution` function, supporting a subset of
+    its parameters.
+
+    The data it returns may not exactly be the same, because it uses more data
+    sources than the original function, and that may lead to different data if
+    the OS distribution is not consistent across multiple data sources it
+    provides (there are indeed such distributions ...).
+
+    Another reason for differences is the fact that the :func:`distro.id`
+    method normalizes the distro ID string to a reliable machine-readable value
+    for a number of popular OS distributions.
+    """
+    return _distro.linux_distribution(full_distribution_name)
+
+
+def id():
+    """
+    Return the distro ID of the current distribution, as a
+    machine-readable string.
+
+    For a number of OS distributions, the returned distro ID value is
+    *reliable*, in the sense that it is documented and that it does not change
+    across releases of the distribution.
+
+    This package maintains the following reliable distro ID values:
+
+    ==============  =========================================
+    Distro ID       Distribution
+    ==============  =========================================
+    "ubuntu"        Ubuntu
+    "debian"        Debian
+    "rhel"          RedHat Enterprise Linux
+    "centos"        CentOS
+    "fedora"        Fedora
+    "sles"          SUSE Linux Enterprise Server
+    "opensuse"      openSUSE
+    "amazon"        Amazon Linux
+    "arch"          Arch Linux
+    "cloudlinux"    CloudLinux OS
+    "exherbo"       Exherbo Linux
+    "gentoo"        GenToo Linux
+    "ibm_powerkvm"  IBM PowerKVM
+    "kvmibm"        KVM for IBM z Systems
+    "linuxmint"     Linux Mint
+    "mageia"        Mageia
+    "mandriva"      Mandriva Linux
+    "parallels"     Parallels
+    "pidora"        Pidora
+    "raspbian"      Raspbian
+    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
+    "scientific"    Scientific Linux
+    "slackware"     Slackware
+    "xenserver"     XenServer
+    "openbsd"       OpenBSD
+    "netbsd"        NetBSD
+    "freebsd"       FreeBSD
+    ==============  =========================================
+
+    If you have a need to get distros for reliable IDs added into this set,
+    or if you find that the :func:`distro.id` function returns a different
+    distro ID for one of the listed distros, please create an issue in the
+    `distro issue tracker`_.
+
+    **Lookup hierarchy and transformations:**
+
+    First, the ID is obtained from the following sources, in the specified
+    order. The first available and non-empty value is used:
+
+    * the value of the "ID" attribute of the os-release file,
+
+    * the value of the "Distributor ID" attribute returned by the lsb_release
+      command,
+
+    * the first part of the file name of the distro release file,
+
+    The so determined ID value then passes the following transformations,
+    before it is returned by this method:
+
+    * it is translated to lower case,
+
+    * blanks (which should not be there anyway) are translated to underscores,
+
+    * a normalization of the ID is performed, based upon
+      `normalization tables`_. The purpose of this normalization is to ensure
+      that the ID is as reliable as possible, even across incompatible changes
+      in the OS distributions. A common reason for an incompatible change is
+      the addition of an os-release file, or the addition of the lsb_release
+      command, with ID values that differ from what was previously determined
+      from the distro release file name.
+    """
+    return _distro.id()
+
+
+def name(pretty=False):
+    """
+    Return the name of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the name is returned without version or codename.
+    (e.g. "CentOS Linux")
+
+    If *pretty* is true, the version and codename are appended.
+    (e.g. "CentOS Linux 7.1.1503 (Core)")
+
+    **Lookup hierarchy:**
+
+    The name is obtained from the following sources, in the specified order.
+    The first available and non-empty value is used:
+
+    * If *pretty* is false:
+
+      - the value of the "NAME" attribute of the os-release file,
+
+      - the value of the "Distributor ID" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file.
+
+    * If *pretty* is true:
+
+      - the value of the "PRETTY_NAME" attribute of the os-release file,
+
+      - the value of the "Description" attribute returned by the lsb_release
+        command,
+
+      - the value of the "<name>" field of the distro release file, appended
+        with the value of the pretty version ("<version_id>" and "<codename>"
+        fields) of the distro release file, if available.
+    """
+    return _distro.name(pretty)
+
+
+def version(pretty=False, best=False):
+    """
+    Return the version of the current OS distribution, as a human-readable
+    string.
+
+    If *pretty* is false, the version is returned without codename (e.g.
+    "7.0").
+
+    If *pretty* is true, the codename in parenthesis is appended, if the
+    codename is non-empty (e.g. "7.0 (Maipo)").
+
+    Some distributions provide version numbers with different precisions in
+    the different sources of distribution information. Examining the different
+    sources in a fixed priority order does not always yield the most precise
+    version (e.g. for Debian 8.2, or CentOS 7.1).
+
+    The *best* parameter can be used to control the approach for the returned
+    version:
+
+    If *best* is false, the first non-empty version number in priority order of
+    the examined sources is returned.
+
+    If *best* is true, the most precise version number out of all examined
+    sources is returned.
+
+    **Lookup hierarchy:**
+
+    In all cases, the version number is obtained from the following sources.
+    If *best* is false, this order represents the priority order:
+
+    * the value of the "VERSION_ID" attribute of the os-release file,
+    * the value of the "Release" attribute returned by the lsb_release
+      command,
+    * the version number parsed from the "<version_id>" field of the first line
+      of the distro release file,
+    * the version number parsed from the "PRETTY_NAME" attribute of the
+      os-release file, if it follows the format of the distro release files.
+    * the version number parsed from the "Description" attribute returned by
+      the lsb_release command, if it follows the format of the distro release
+      files.
+    """
+    return _distro.version(pretty, best)
+
+
+def version_parts(best=False):
+    """
+    Return the version of the current OS distribution as a tuple
+    ``(major, minor, build_number)`` with items as follows:
+
+    * ``major``:  The result of :func:`distro.major_version`.
+
+    * ``minor``:  The result of :func:`distro.minor_version`.
+
+    * ``build_number``:  The result of :func:`distro.build_number`.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.version_parts(best)
+
+
+def major_version(best=False):
+    """
+    Return the major version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The major version is the first
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.major_version(best)
+
+
+def minor_version(best=False):
+    """
+    Return the minor version of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The minor version is the second
+    part of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.minor_version(best)
+
+
+def build_number(best=False):
+    """
+    Return the build number of the current OS distribution, as a string,
+    if provided.
+    Otherwise, the empty string is returned. The build number is the third part
+    of the dot-separated version string.
+
+    For a description of the *best* parameter, see the :func:`distro.version`
+    method.
+    """
+    return _distro.build_number(best)
+
+
+def like():
+    """
+    Return a space-separated list of distro IDs of distributions that are
+    closely related to the current OS distribution in regards to packaging
+    and programming interfaces, for example distributions the current
+    distribution is a derivative from.
+
+    **Lookup hierarchy:**
+
+    This information item is only provided by the os-release file.
+    For details, see the description of the "ID_LIKE" attribute in the
+    `os-release man page
+    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
+    """
+    return _distro.like()
+
+
+def codename():
+    """
+    Return the codename for the release of the current OS distribution,
+    as a string.
+
+    If the distribution does not have a codename, an empty string is returned.
+
+    Note that the returned codename is not always really a codename. For
+    example, openSUSE returns "x86_64". This function does not handle such
+    cases in any special way and just returns the string it finds, if any.
+
+    **Lookup hierarchy:**
+
+    * the codename within the "VERSION" attribute of the os-release file, if
+      provided,
+
+    * the value of the "Codename" attribute returned by the lsb_release
+      command,
+
+    * the value of the "<codename>" field of the distro release file.
+    """
+    return _distro.codename()
+
+
+def info(pretty=False, best=False):
+    """
+    Return certain machine-readable information items about the current OS
+    distribution in a dictionary, as shown in the following example:
+
+    .. sourcecode:: python
+
+        {
+            'id': 'rhel',
+            'version': '7.0',
+            'version_parts': {
+                'major': '7',
+                'minor': '0',
+                'build_number': ''
+            },
+            'like': 'fedora',
+            'codename': 'Maipo'
+        }
+
+    The dictionary structure and keys are always the same, regardless of which
+    information items are available in the underlying data sources. The values
+    for the various keys are as follows:
+
+    * ``id``:  The result of :func:`distro.id`.
+
+    * ``version``:  The result of :func:`distro.version`.
+
+    * ``version_parts -> major``:  The result of :func:`distro.major_version`.
+
+    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.
+
+    * ``version_parts -> build_number``:  The result of
+      :func:`distro.build_number`.
+
+    * ``like``:  The result of :func:`distro.like`.
+
+    * ``codename``:  The result of :func:`distro.codename`.
+
+    For a description of the *pretty* and *best* parameters, see the
+    :func:`distro.version` method.
+    """
+    return _distro.info(pretty, best)
+
+
+def os_release_info():
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the os-release file data source of the current OS distribution.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_info()
+
+
+def lsb_release_info():
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the lsb_release command data source of the current OS distribution.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_info()
+
+
+def distro_release_info():
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_info()
+
+
+def uname_info():
+    """
+    Return a dictionary containing key-value pairs for the information items
+    from the distro release file data source of the current OS distribution.
+    """
+    return _distro.uname_info()
+
+
+def os_release_attr(attribute):
+    """
+    Return a single named information item from the os-release file data source
+    of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `os-release file`_ for details about these information items.
+    """
+    return _distro.os_release_attr(attribute)
+
+
+def lsb_release_attr(attribute):
+    """
+    Return a single named information item from the lsb_release command output
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `lsb_release command output`_ for details about these information
+    items.
+    """
+    return _distro.lsb_release_attr(attribute)
+
+
+def distro_release_attr(attribute):
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+      The empty string, if the item does not exist.
+
+    See `distro release file`_ for details about these information items.
+    """
+    return _distro.distro_release_attr(attribute)
+
+
+def uname_attr(attribute):
+    """
+    Return a single named information item from the distro release file
+    data source of the current OS distribution.
+
+    Parameters:
+
+    * ``attribute`` (string): Key of the information item.
+
+    Returns:
+
+    * (string): Value of the information item, if the item exists.
+                The empty string, if the item does not exist.
+    """
+    return _distro.uname_attr(attribute)
+
+
+class cached_property(object):
+    """A version of @property which caches the value.  On access, it calls the
+    underlying function and sets the value in `__dict__` so future accesses
+    will not re-call the property.
+    """
+    def __init__(self, f):
+        self._fname = f.__name__
+        self._f = f
+
+    def __get__(self, obj, owner):
+        assert obj is not None, 'call {} on an instance'.format(self._fname)
+        ret = obj.__dict__[self._fname] = self._f(obj)
+        return ret
+
+
+class LinuxDistribution(object):
+    """
+    Provides information about a OS distribution.
+
+    This package creates a private module-global instance of this class with
+    default initialization arguments, that is used by the
+    `consolidated accessor functions`_ and `single source accessor functions`_.
+    By using default initialization arguments, that module-global instance
+    returns data about the current OS distribution (i.e. the distro this
+    package runs on).
+
+    Normally, it is not necessary to create additional instances of this class.
+    However, in situations where control is needed over the exact data sources
+    that are used, instances of this class can be created with a specific
+    distro release file, or a specific os-release file, or without invoking the
+    lsb_release command.
+    """
+
+    def __init__(self,
+                 include_lsb=True,
+                 os_release_file='',
+                 distro_release_file='',
+                 include_uname=True):
+        """
+        The initialization method of this class gathers information from the
+        available data sources, and stores that in private instance attributes.
+        Subsequent access to the information items uses these private instance
+        attributes, so that the data sources are read only once.
+
+        Parameters:
+
+        * ``include_lsb`` (bool): Controls whether the
+          `lsb_release command output`_ is included as a data source.
+
+          If the lsb_release command is not available in the program execution
+          path, the data source for the lsb_release command will be empty.
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause the default path name to
+          be used (see `os-release file`_ for details).
+
+          If the specified or defaulted os-release file does not exist, the
+          data source for the os-release file will be empty.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is to be used as a data source.
+
+          An empty string (the default) will cause a default search algorithm
+          to be used (see `distro release file`_ for details).
+
+          If the specified distro release file does not exist, or if no default
+          distro release file can be found, the data source for the distro
+          release file will be empty.
+
+        * ``include_name`` (bool): Controls whether uname command output is
+          included as a data source. If the uname command is not available in
+          the program execution path the data source for the uname command will
+          be empty.
+
+        Public instance attributes:
+
+        * ``os_release_file`` (string): The path name of the
+          `os-release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``distro_release_file`` (string): The path name of the
+          `distro release file`_ that is actually used as a data source. The
+          empty string if no distro release file is used as a data source.
+
+        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
+          This controls whether the lsb information will be loaded.
+
+        * ``include_uname`` (bool): The result of the ``include_uname``
+          parameter. This controls whether the uname information will
+          be loaded.
+
+        Raises:
+
+        * :py:exc:`IOError`: Some I/O issue with an os-release file or distro
+          release file.
+
+        * :py:exc:`subprocess.CalledProcessError`: The lsb_release command had
+          some issue (other than not being available in the program execution
+          path).
+
+        * :py:exc:`UnicodeError`: A data source has unexpected characters or
+          uses an unexpected encoding.
+        """
+        self.os_release_file = os_release_file or \
+            os.path.join(_UNIXCONFDIR, _OS_RELEASE_BASENAME)
+        self.distro_release_file = distro_release_file or ''  # updated later
+        self.include_lsb = include_lsb
+        self.include_uname = include_uname
+
+    def __repr__(self):
+        """Return repr of all info
+        """
+        return \
+            "LinuxDistribution(" \
+            "os_release_file={self.os_release_file!r}, " \
+            "distro_release_file={self.distro_release_file!r}, " \
+            "include_lsb={self.include_lsb!r}, " \
+            "include_uname={self.include_uname!r}, " \
+            "_os_release_info={self._os_release_info!r}, " \
+            "_lsb_release_info={self._lsb_release_info!r}, " \
+            "_distro_release_info={self._distro_release_info!r}, " \
+            "_uname_info={self._uname_info!r})".format(
+                self=self)
+
+    def linux_distribution(self, full_distribution_name=True):
+        """
+        Return information about the OS distribution that is compatible
+        with Python's :func:`platform.linux_distribution`, supporting a subset
+        of its parameters.
+
+        For details, see :func:`distro.linux_distribution`.
+        """
+        return (
+            self.name() if full_distribution_name else self.id(),
+            self.version(),
+            self.codename()
+        )
+
+    def id(self):
+        """Return the distro ID of the OS distribution, as a string.
+
+        For details, see :func:`distro.id`.
+        """
+        def normalize(distro_id, table):
+            distro_id = distro_id.lower().replace(' ', '_')
+            return table.get(distro_id, distro_id)
+
+        distro_id = self.os_release_attr('id')
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_OS_ID)
+
+        distro_id = self.lsb_release_attr('distributor_id')
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_LSB_ID)
+
+        distro_id = self.distro_release_attr('id')
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        distro_id = self.uname_attr('id')
+        if distro_id:
+            return normalize(distro_id, NORMALIZED_DISTRO_ID)
+
+        return ''
+
+    def name(self, pretty=False):
+        """
+        Return the name of the OS distribution, as a string.
+
+        For details, see :func:`distro.name`.
+        """
+        name = self.os_release_attr('name') \
+            or self.lsb_release_attr('distributor_id') \
+            or self.distro_release_attr('name') \
+            or self.uname_attr('name')
+        if pretty:
+            name = self.os_release_attr('pretty_name') \
+                or self.lsb_release_attr('description')
+            if not name:
+                name = self.distro_release_attr('name') \
+                       or self.uname_attr('name')
+                version = self.version(pretty=True)
+                if version:
+                    name = name + ' ' + version
+        return name or ''
+
+    def version(self, pretty=False, best=False):
+        """
+        Return the version of the OS distribution, as a string.
+
+        For details, see :func:`distro.version`.
+        """
+        versions = [
+            self.os_release_attr('version_id'),
+            self.lsb_release_attr('release'),
+            self.distro_release_attr('version_id'),
+            self._parse_distro_release_content(
+                self.os_release_attr('pretty_name')).get('version_id', ''),
+            self._parse_distro_release_content(
+                self.lsb_release_attr('description')).get('version_id', ''),
+            self.uname_attr('release')
+        ]
+        version = ''
+        if best:
+            # This algorithm uses the last version in priority order that has
+            # the best precision. If the versions are not in conflict, that
+            # does not matter; otherwise, using the last one instead of the
+            # first one might be considered a surprise.
+            for v in versions:
+                if v.count(".") > version.count(".") or version == '':
+                    version = v
+        else:
+            for v in versions:
+                if v != '':
+                    version = v
+                    break
+        if pretty and version and self.codename():
+            version = u'{0} ({1})'.format(version, self.codename())
+        return version
+
+    def version_parts(self, best=False):
+        """
+        Return the version of the OS distribution, as a tuple of version
+        numbers.
+
+        For details, see :func:`distro.version_parts`.
+        """
+        version_str = self.version(best=best)
+        if version_str:
+            version_regex = re.compile(r'(\d+)\.?(\d+)?\.?(\d+)?')
+            matches = version_regex.match(version_str)
+            if matches:
+                major, minor, build_number = matches.groups()
+                return major, minor or '', build_number or ''
+        return '', '', ''
+
+    def major_version(self, best=False):
+        """
+        Return the major version number of the current distribution.
+
+        For details, see :func:`distro.major_version`.
+        """
+        return self.version_parts(best)[0]
+
+    def minor_version(self, best=False):
+        """
+        Return the minor version number of the current distribution.
+
+        For details, see :func:`distro.minor_version`.
+        """
+        return self.version_parts(best)[1]
+
+    def build_number(self, best=False):
+        """
+        Return the build number of the current distribution.
+
+        For details, see :func:`distro.build_number`.
+        """
+        return self.version_parts(best)[2]
+
+    def like(self):
+        """
+        Return the IDs of distributions that are like the OS distribution.
+
+        For details, see :func:`distro.like`.
+        """
+        return self.os_release_attr('id_like') or ''
+
+    def codename(self):
+        """
+        Return the codename of the OS distribution.
+
+        For details, see :func:`distro.codename`.
+        """
+        try:
+            # Handle os_release specially since distros might purposefully set
+            # this to empty string to have no codename
+            return self._os_release_info['codename']
+        except KeyError:
+            return self.lsb_release_attr('codename') \
+                or self.distro_release_attr('codename') \
+                or ''
+
+    def info(self, pretty=False, best=False):
+        """
+        Return certain machine-readable information about the OS
+        distribution.
+
+        For details, see :func:`distro.info`.
+        """
+        return dict(
+            id=self.id(),
+            version=self.version(pretty, best),
+            version_parts=dict(
+                major=self.major_version(best),
+                minor=self.minor_version(best),
+                build_number=self.build_number(best)
+            ),
+            like=self.like(),
+            codename=self.codename(),
+        )
+
+    def os_release_info(self):
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the os-release file data source of the OS distribution.
+
+        For details, see :func:`distro.os_release_info`.
+        """
+        return self._os_release_info
+
+    def lsb_release_info(self):
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the lsb_release command data source of the OS
+        distribution.
+
+        For details, see :func:`distro.lsb_release_info`.
+        """
+        return self._lsb_release_info
+
+    def distro_release_info(self):
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the distro release file data source of the OS
+        distribution.
+
+        For details, see :func:`distro.distro_release_info`.
+        """
+        return self._distro_release_info
+
+    def uname_info(self):
+        """
+        Return a dictionary containing key-value pairs for the information
+        items from the uname command data source of the OS distribution.
+
+        For details, see :func:`distro.uname_info`.
+        """
+        return self._uname_info
+
+    def os_release_attr(self, attribute):
+        """
+        Return a single named information item from the os-release file data
+        source of the OS distribution.
+
+        For details, see :func:`distro.os_release_attr`.
+        """
+        return self._os_release_info.get(attribute, '')
+
+    def lsb_release_attr(self, attribute):
+        """
+        Return a single named information item from the lsb_release command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.lsb_release_attr`.
+        """
+        return self._lsb_release_info.get(attribute, '')
+
+    def distro_release_attr(self, attribute):
+        """
+        Return a single named information item from the distro release file
+        data source of the OS distribution.
+
+        For details, see :func:`distro.distro_release_attr`.
+        """
+        return self._distro_release_info.get(attribute, '')
+
+    def uname_attr(self, attribute):
+        """
+        Return a single named information item from the uname command
+        output data source of the OS distribution.
+
+        For details, see :func:`distro.uname_release_attr`.
+        """
+        return self._uname_info.get(attribute, '')
+
+    @cached_property
+    def _os_release_info(self):
+        """
+        Get the information items from the specified os-release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if os.path.isfile(self.os_release_file):
+            with open(self.os_release_file) as release_file:
+                return self._parse_os_release_content(release_file)
+        return {}
+
+    @staticmethod
+    def _parse_os_release_content(lines):
+        """
+        Parse the lines of an os-release file.
+
+        Parameters:
+
+        * lines: Iterable through the lines in the os-release file.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        lexer = shlex.shlex(lines, posix=True)
+        lexer.whitespace_split = True
+
+        # The shlex module defines its `wordchars` variable using literals,
+        # making it dependent on the encoding of the Python source file.
+        # In Python 2.6 and 2.7, the shlex source file is encoded in
+        # 'iso-8859-1', and the `wordchars` variable is defined as a byte
+        # string. This causes a UnicodeDecodeError to be raised when the
+        # parsed content is a unicode object. The following fix resolves that
+        # (... but it should be fixed in shlex...):
+        if sys.version_info[0] == 2 and isinstance(lexer.wordchars, bytes):
+            lexer.wordchars = lexer.wordchars.decode('iso-8859-1')
+
+        tokens = list(lexer)
+        for token in tokens:
+            # At this point, all shell-like parsing has been done (i.e.
+            # comments processed, quotes and backslash escape sequences
+            # processed, multi-line values assembled, trailing newlines
+            # stripped, etc.), so the tokens are now either:
+            # * variable assignments: var=value
+            # * commands or their arguments (not allowed in os-release)
+            if '=' in token:
+                k, v = token.split('=', 1)
+                if isinstance(v, bytes):
+                    v = v.decode('utf-8')
+                props[k.lower()] = v
+            else:
+                # Ignore any tokens that are not variable assignments
+                pass
+
+        if 'version_codename' in props:
+            # os-release added a version_codename field.  Use that in
+            # preference to anything else Note that some distros purposefully
+            # do not have code names.  They should be setting
+            # version_codename=""
+            props['codename'] = props['version_codename']
+        elif 'ubuntu_codename' in props:
+            # Same as above but a non-standard field name used on older Ubuntus
+            props['codename'] = props['ubuntu_codename']
+        elif 'version' in props:
+            # If there is no version_codename, parse it from the version
+            codename = re.search(r'(\(\D+\))|,(\s+)?\D+', props['version'])
+            if codename:
+                codename = codename.group()
+                codename = codename.strip('()')
+                codename = codename.strip(',')
+                codename = codename.strip()
+                # codename appears within paranthese.
+                props['codename'] = codename
+
+        return props
+
+    @cached_property
+    def _lsb_release_info(self):
+        """
+        Get the information items from the lsb_release command output.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if not self.include_lsb:
+            return {}
+        with open(os.devnull, 'w') as devnull:
+            try:
+                cmd = ('lsb_release', '-a')
+                stdout = subprocess.check_output(cmd, stderr=devnull)
+            except OSError:  # Command not found
+                return {}
+        content = stdout.decode(sys.getfilesystemencoding()).splitlines()
+        return self._parse_lsb_release_content(content)
+
+    @staticmethod
+    def _parse_lsb_release_content(lines):
+        """
+        Parse the output of the lsb_release command.
+
+        Parameters:
+
+        * lines: Iterable through the lines of the lsb_release output.
+                 Each line must be a unicode string or a UTF-8 encoded byte
+                 string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        props = {}
+        for line in lines:
+            kv = line.strip('\n').split(':', 1)
+            if len(kv) != 2:
+                # Ignore lines without colon.
+                continue
+            k, v = kv
+            props.update({k.replace(' ', '_').lower(): v.strip()})
+        return props
+
+    @cached_property
+    def _uname_info(self):
+        with open(os.devnull, 'w') as devnull:
+            try:
+                cmd = ('uname', '-rs')
+                stdout = subprocess.check_output(cmd, stderr=devnull)
+            except OSError:
+                return {}
+        content = stdout.decode(sys.getfilesystemencoding()).splitlines()
+        return self._parse_uname_content(content)
+
+    @staticmethod
+    def _parse_uname_content(lines):
+        props = {}
+        match = re.search(r'^([^\s]+)\s+([\d\.]+)', lines[0].strip())
+        if match:
+            name, version = match.groups()
+
+            # This is to prevent the Linux kernel version from
+            # appearing as the 'best' version on otherwise
+            # identifiable distributions.
+            if name == 'Linux':
+                return {}
+            props['id'] = name.lower()
+            props['name'] = name
+            props['release'] = version
+        return props
+
+    @cached_property
+    def _distro_release_info(self):
+        """
+        Get the information items from the specified distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if self.distro_release_file:
+            # If it was specified, we use it and parse what we can, even if
+            # its file name or content does not match the expected pattern.
+            distro_info = self._parse_distro_release_file(
+                self.distro_release_file)
+            basename = os.path.basename(self.distro_release_file)
+            # The file name pattern for user-specified distro release files
+            # is somewhat more tolerant (compared to when searching for the
+            # file), because we want to use what was specified as best as
+            # possible.
+            match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+            if 'name' in distro_info \
+               and 'cloudlinux' in distro_info['name'].lower():
+                distro_info['id'] = 'cloudlinux'
+            elif match:
+                distro_info['id'] = match.group(1)
+            return distro_info
+        else:
+            try:
+                basenames = os.listdir(_UNIXCONFDIR)
+                # We sort for repeatability in cases where there are multiple
+                # distro specific files; e.g. CentOS, Oracle, Enterprise all
+                # containing `redhat-release` on top of their own.
+                basenames.sort()
+            except OSError:
+                # This may occur when /etc is not readable but we can't be
+                # sure about the *-release files. Check common entries of
+                # /etc for information. If they turn out to not be there the
+                # error is handled in `_parse_distro_release_file()`.
+                basenames = ['SuSE-release',
+                             'arch-release',
+                             'base-release',
+                             'centos-release',
+                             'fedora-release',
+                             'gentoo-release',
+                             'mageia-release',
+                             'mandrake-release',
+                             'mandriva-release',
+                             'mandrivalinux-release',
+                             'manjaro-release',
+                             'oracle-release',
+                             'redhat-release',
+                             'sl-release',
+                             'slackware-version']
+            for basename in basenames:
+                if basename in _DISTRO_RELEASE_IGNORE_BASENAMES:
+                    continue
+                match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
+                if match:
+                    filepath = os.path.join(_UNIXCONFDIR, basename)
+                    distro_info = self._parse_distro_release_file(filepath)
+                    if 'name' in distro_info:
+                        # The name is always present if the pattern matches
+                        self.distro_release_file = filepath
+                        distro_info['id'] = match.group(1)
+                        if 'cloudlinux' in distro_info['name'].lower():
+                            distro_info['id'] = 'cloudlinux'
+                        return distro_info
+            return {}
+
+    def _parse_distro_release_file(self, filepath):
+        """
+        Parse a distro release file.
+
+        Parameters:
+
+        * filepath: Path name of the distro release file.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        try:
+            with open(filepath) as fp:
+                # Only parse the first line. For instance, on SLES there
+                # are multiple lines. We don't want them...
+                return self._parse_distro_release_content(fp.readline())
+        except (OSError, IOError):
+            # Ignore not being able to read a specific, seemingly version
+            # related file.
+            # See https://github.com/nir0s/distro/issues/162
+            return {}
+
+    @staticmethod
+    def _parse_distro_release_content(line):
+        """
+        Parse a line from a distro release file.
+
+        Parameters:
+        * line: Line from the distro release file. Must be a unicode string
+                or a UTF-8 encoded byte string.
+
+        Returns:
+            A dictionary containing all information items.
+        """
+        if isinstance(line, bytes):
+            line = line.decode('utf-8')
+        matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(
+            line.strip()[::-1])
+        distro_info = {}
+        if matches:
+            # regexp ensures non-None
+            distro_info['name'] = matches.group(3)[::-1]
+            if matches.group(2):
+                distro_info['version_id'] = matches.group(2)[::-1]
+            if matches.group(1):
+                distro_info['codename'] = matches.group(1)[::-1]
+        elif line:
+            distro_info['name'] = line.strip()
+        return distro_info
+
+
+_distro = LinuxDistribution()
+
+
+def main():
+    logger = logging.getLogger(__name__)
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(logging.StreamHandler(sys.stdout))
+
+    parser = argparse.ArgumentParser(description="OS distro info tool")
+    parser.add_argument(
+        '--json',
+        '-j',
+        help="Output in machine readable format",
+        action="store_true")
+    args = parser.parse_args()
+
+    if args.json:
+        logger.info(json.dumps(info(), indent=4, sort_keys=True))
+    else:
+        logger.info('Name: %s', name(pretty=True))
+        distribution_version = version(pretty=True)
+        logger.info('Version: %s', distribution_version)
+        distribution_codename = codename()
+        logger.info('Codename: %s', distribution_codename)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/easy_install.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/easy_install.py
new file mode 100644
index 0000000000000000000000000000000000000000..d87e984034b6e6e9eb456ebcb2b3f420c07a48bc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/easy_install.py
@@ -0,0 +1,5 @@
+"""Run the EasyInstall command"""
+
+if __name__ == '__main__':
+    from setuptools.command.easy_install import main
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ecd917aa016dea4e807ef051ea048b9828b5f450
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/__init__.py
@@ -0,0 +1,33 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# Copyright 2007 Google Inc. All Rights Reserved.
+
+__version__ = '3.15.4'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/any_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/any_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3b6ad81b200e190c3fe632d2ec271dfc8247de5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/any_pb2.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/any.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/any.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\010AnyProtoP\001Z,google.golang.org/protobuf/types/known/anypb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x19google/protobuf/any.proto\x12\x0fgoogle.protobuf\"&\n\x03\x41ny\x12\x10\n\x08type_url\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x0c\x42v\n\x13\x63om.google.protobufB\x08\x41nyProtoP\x01Z,google.golang.org/protobuf/types/known/anypb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_ANY = _descriptor.Descriptor(
+  name='Any',
+  full_name='google.protobuf.Any',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='type_url', full_name='google.protobuf.Any.type_url', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.Any.value', index=1,
+      number=2, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=46,
+  serialized_end=84,
+)
+
+DESCRIPTOR.message_types_by_name['Any'] = _ANY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Any = _reflection.GeneratedProtocolMessageType('Any', (_message.Message,), {
+  'DESCRIPTOR' : _ANY,
+  '__module__' : 'google.protobuf.any_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Any)
+  })
+_sym_db.RegisterMessage(Any)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/api_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/api_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ecc064979ef0dcfef435e3f4f8cdc1e728a6918
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/api_pb2.py
@@ -0,0 +1,252 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/api.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import source_context_pb2 as google_dot_protobuf_dot_source__context__pb2
+from google.protobuf import type_pb2 as google_dot_protobuf_dot_type__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/api.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\010ApiProtoP\001Z,google.golang.org/protobuf/types/known/apipb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x19google/protobuf/api.proto\x12\x0fgoogle.protobuf\x1a$google/protobuf/source_context.proto\x1a\x1agoogle/protobuf/type.proto\"\x81\x02\n\x03\x41pi\x12\x0c\n\x04name\x18\x01 \x01(\t\x12(\n\x07methods\x18\x02 \x03(\x0b\x32\x17.google.protobuf.Method\x12(\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.Option\x12\x0f\n\x07version\x18\x04 \x01(\t\x12\x36\n\x0esource_context\x18\x05 \x01(\x0b\x32\x1e.google.protobuf.SourceContext\x12&\n\x06mixins\x18\x06 \x03(\x0b\x32\x16.google.protobuf.Mixin\x12\'\n\x06syntax\x18\x07 \x01(\x0e\x32\x17.google.protobuf.Syntax\"\xd5\x01\n\x06Method\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x18\n\x10request_type_url\x18\x02 \x01(\t\x12\x19\n\x11request_streaming\x18\x03 \x01(\x08\x12\x19\n\x11response_type_url\x18\x04 \x01(\t\x12\x1a\n\x12response_streaming\x18\x05 \x01(\x08\x12(\n\x07options\x18\x06 \x03(\x0b\x32\x17.google.protobuf.Option\x12\'\n\x06syntax\x18\x07 \x01(\x0e\x32\x17.google.protobuf.Syntax\"#\n\x05Mixin\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04root\x18\x02 \x01(\tBv\n\x13\x63om.google.protobufB\x08\x41piProtoP\x01Z,google.golang.org/protobuf/types/known/apipb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+  ,
+  dependencies=[google_dot_protobuf_dot_source__context__pb2.DESCRIPTOR,google_dot_protobuf_dot_type__pb2.DESCRIPTOR,])
+
+
+
+
+_API = _descriptor.Descriptor(
+  name='Api',
+  full_name='google.protobuf.Api',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Api.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='methods', full_name='google.protobuf.Api.methods', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.Api.options', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='version', full_name='google.protobuf.Api.version', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='source_context', full_name='google.protobuf.Api.source_context', index=4,
+      number=5, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='mixins', full_name='google.protobuf.Api.mixins', index=5,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='syntax', full_name='google.protobuf.Api.syntax', index=6,
+      number=7, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=113,
+  serialized_end=370,
+)
+
+
+_METHOD = _descriptor.Descriptor(
+  name='Method',
+  full_name='google.protobuf.Method',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Method.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='request_type_url', full_name='google.protobuf.Method.request_type_url', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='request_streaming', full_name='google.protobuf.Method.request_streaming', index=2,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='response_type_url', full_name='google.protobuf.Method.response_type_url', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='response_streaming', full_name='google.protobuf.Method.response_streaming', index=4,
+      number=5, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.Method.options', index=5,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='syntax', full_name='google.protobuf.Method.syntax', index=6,
+      number=7, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=373,
+  serialized_end=586,
+)
+
+
+_MIXIN = _descriptor.Descriptor(
+  name='Mixin',
+  full_name='google.protobuf.Mixin',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Mixin.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='root', full_name='google.protobuf.Mixin.root', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=588,
+  serialized_end=623,
+)
+
+_API.fields_by_name['methods'].message_type = _METHOD
+_API.fields_by_name['options'].message_type = google_dot_protobuf_dot_type__pb2._OPTION
+_API.fields_by_name['source_context'].message_type = google_dot_protobuf_dot_source__context__pb2._SOURCECONTEXT
+_API.fields_by_name['mixins'].message_type = _MIXIN
+_API.fields_by_name['syntax'].enum_type = google_dot_protobuf_dot_type__pb2._SYNTAX
+_METHOD.fields_by_name['options'].message_type = google_dot_protobuf_dot_type__pb2._OPTION
+_METHOD.fields_by_name['syntax'].enum_type = google_dot_protobuf_dot_type__pb2._SYNTAX
+DESCRIPTOR.message_types_by_name['Api'] = _API
+DESCRIPTOR.message_types_by_name['Method'] = _METHOD
+DESCRIPTOR.message_types_by_name['Mixin'] = _MIXIN
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Api = _reflection.GeneratedProtocolMessageType('Api', (_message.Message,), {
+  'DESCRIPTOR' : _API,
+  '__module__' : 'google.protobuf.api_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Api)
+  })
+_sym_db.RegisterMessage(Api)
+
+Method = _reflection.GeneratedProtocolMessageType('Method', (_message.Message,), {
+  'DESCRIPTOR' : _METHOD,
+  '__module__' : 'google.protobuf.api_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Method)
+  })
+_sym_db.RegisterMessage(Method)
+
+Mixin = _reflection.GeneratedProtocolMessageType('Mixin', (_message.Message,), {
+  'DESCRIPTOR' : _MIXIN,
+  '__module__' : 'google.protobuf.api_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Mixin)
+  })
+_sym_db.RegisterMessage(Mixin)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/compiler/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/compiler/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/compiler/plugin_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/compiler/plugin_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..ff90d18f1b88f555e15d7cdbb6535617f1fc916e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/compiler/plugin_pb2.py
@@ -0,0 +1,301 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/compiler/plugin.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import descriptor_pb2 as google_dot_protobuf_dot_descriptor__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/compiler/plugin.proto',
+  package='google.protobuf.compiler',
+  syntax='proto2',
+  serialized_options=b'\n\034com.google.protobuf.compilerB\014PluginProtosZ)google.golang.org/protobuf/types/pluginpb',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n%google/protobuf/compiler/plugin.proto\x12\x18google.protobuf.compiler\x1a google/protobuf/descriptor.proto\"F\n\x07Version\x12\r\n\x05major\x18\x01 \x01(\x05\x12\r\n\x05minor\x18\x02 \x01(\x05\x12\r\n\x05patch\x18\x03 \x01(\x05\x12\x0e\n\x06suffix\x18\x04 \x01(\t\"\xba\x01\n\x14\x43odeGeneratorRequest\x12\x18\n\x10\x66ile_to_generate\x18\x01 \x03(\t\x12\x11\n\tparameter\x18\x02 \x01(\t\x12\x38\n\nproto_file\x18\x0f \x03(\x0b\x32$.google.protobuf.FileDescriptorProto\x12;\n\x10\x63ompiler_version\x18\x03 \x01(\x0b\x32!.google.protobuf.compiler.Version\"\xc1\x02\n\x15\x43odeGeneratorResponse\x12\r\n\x05\x65rror\x18\x01 \x01(\t\x12\x1a\n\x12supported_features\x18\x02 \x01(\x04\x12\x42\n\x04\x66ile\x18\x0f \x03(\x0b\x32\x34.google.protobuf.compiler.CodeGeneratorResponse.File\x1a\x7f\n\x04\x46ile\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x17\n\x0finsertion_point\x18\x02 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x0f \x01(\t\x12?\n\x13generated_code_info\x18\x10 \x01(\x0b\x32\".google.protobuf.GeneratedCodeInfo\"8\n\x07\x46\x65\x61ture\x12\x10\n\x0c\x46\x45\x41TURE_NONE\x10\x00\x12\x1b\n\x17\x46\x45\x41TURE_PROTO3_OPTIONAL\x10\x01\x42W\n\x1c\x63om.google.protobuf.compilerB\x0cPluginProtosZ)google.golang.org/protobuf/types/pluginpb'
+  ,
+  dependencies=[google_dot_protobuf_dot_descriptor__pb2.DESCRIPTOR,])
+
+
+
+_CODEGENERATORRESPONSE_FEATURE = _descriptor.EnumDescriptor(
+  name='Feature',
+  full_name='google.protobuf.compiler.CodeGeneratorResponse.Feature',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='FEATURE_NONE', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='FEATURE_PROTO3_OPTIONAL', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=628,
+  serialized_end=684,
+)
+_sym_db.RegisterEnumDescriptor(_CODEGENERATORRESPONSE_FEATURE)
+
+
+_VERSION = _descriptor.Descriptor(
+  name='Version',
+  full_name='google.protobuf.compiler.Version',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='major', full_name='google.protobuf.compiler.Version.major', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='minor', full_name='google.protobuf.compiler.Version.minor', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='patch', full_name='google.protobuf.compiler.Version.patch', index=2,
+      number=3, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='suffix', full_name='google.protobuf.compiler.Version.suffix', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=101,
+  serialized_end=171,
+)
+
+
+_CODEGENERATORREQUEST = _descriptor.Descriptor(
+  name='CodeGeneratorRequest',
+  full_name='google.protobuf.compiler.CodeGeneratorRequest',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='file_to_generate', full_name='google.protobuf.compiler.CodeGeneratorRequest.file_to_generate', index=0,
+      number=1, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='parameter', full_name='google.protobuf.compiler.CodeGeneratorRequest.parameter', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='proto_file', full_name='google.protobuf.compiler.CodeGeneratorRequest.proto_file', index=2,
+      number=15, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='compiler_version', full_name='google.protobuf.compiler.CodeGeneratorRequest.compiler_version', index=3,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=174,
+  serialized_end=360,
+)
+
+
+_CODEGENERATORRESPONSE_FILE = _descriptor.Descriptor(
+  name='File',
+  full_name='google.protobuf.compiler.CodeGeneratorResponse.File',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.compiler.CodeGeneratorResponse.File.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='insertion_point', full_name='google.protobuf.compiler.CodeGeneratorResponse.File.insertion_point', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='content', full_name='google.protobuf.compiler.CodeGeneratorResponse.File.content', index=2,
+      number=15, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='generated_code_info', full_name='google.protobuf.compiler.CodeGeneratorResponse.File.generated_code_info', index=3,
+      number=16, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=499,
+  serialized_end=626,
+)
+
+_CODEGENERATORRESPONSE = _descriptor.Descriptor(
+  name='CodeGeneratorResponse',
+  full_name='google.protobuf.compiler.CodeGeneratorResponse',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='error', full_name='google.protobuf.compiler.CodeGeneratorResponse.error', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='supported_features', full_name='google.protobuf.compiler.CodeGeneratorResponse.supported_features', index=1,
+      number=2, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='file', full_name='google.protobuf.compiler.CodeGeneratorResponse.file', index=2,
+      number=15, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_CODEGENERATORRESPONSE_FILE, ],
+  enum_types=[
+    _CODEGENERATORRESPONSE_FEATURE,
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=363,
+  serialized_end=684,
+)
+
+_CODEGENERATORREQUEST.fields_by_name['proto_file'].message_type = google_dot_protobuf_dot_descriptor__pb2._FILEDESCRIPTORPROTO
+_CODEGENERATORREQUEST.fields_by_name['compiler_version'].message_type = _VERSION
+_CODEGENERATORRESPONSE_FILE.fields_by_name['generated_code_info'].message_type = google_dot_protobuf_dot_descriptor__pb2._GENERATEDCODEINFO
+_CODEGENERATORRESPONSE_FILE.containing_type = _CODEGENERATORRESPONSE
+_CODEGENERATORRESPONSE.fields_by_name['file'].message_type = _CODEGENERATORRESPONSE_FILE
+_CODEGENERATORRESPONSE_FEATURE.containing_type = _CODEGENERATORRESPONSE
+DESCRIPTOR.message_types_by_name['Version'] = _VERSION
+DESCRIPTOR.message_types_by_name['CodeGeneratorRequest'] = _CODEGENERATORREQUEST
+DESCRIPTOR.message_types_by_name['CodeGeneratorResponse'] = _CODEGENERATORRESPONSE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Version = _reflection.GeneratedProtocolMessageType('Version', (_message.Message,), {
+  'DESCRIPTOR' : _VERSION,
+  '__module__' : 'google.protobuf.compiler.plugin_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.compiler.Version)
+  })
+_sym_db.RegisterMessage(Version)
+
+CodeGeneratorRequest = _reflection.GeneratedProtocolMessageType('CodeGeneratorRequest', (_message.Message,), {
+  'DESCRIPTOR' : _CODEGENERATORREQUEST,
+  '__module__' : 'google.protobuf.compiler.plugin_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.compiler.CodeGeneratorRequest)
+  })
+_sym_db.RegisterMessage(CodeGeneratorRequest)
+
+CodeGeneratorResponse = _reflection.GeneratedProtocolMessageType('CodeGeneratorResponse', (_message.Message,), {
+
+  'File' : _reflection.GeneratedProtocolMessageType('File', (_message.Message,), {
+    'DESCRIPTOR' : _CODEGENERATORRESPONSE_FILE,
+    '__module__' : 'google.protobuf.compiler.plugin_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.compiler.CodeGeneratorResponse.File)
+    })
+  ,
+  'DESCRIPTOR' : _CODEGENERATORRESPONSE,
+  '__module__' : 'google.protobuf.compiler.plugin_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.compiler.CodeGeneratorResponse)
+  })
+_sym_db.RegisterMessage(CodeGeneratorResponse)
+_sym_db.RegisterMessage(CodeGeneratorResponse.File)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor.py
new file mode 100644
index 0000000000000000000000000000000000000000..190b89536fdfd3c13126e2d862643da05c3093f3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor.py
@@ -0,0 +1,1165 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Descriptors essentially contain exactly the information found in a .proto
+file, in types that make this information accessible in Python.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+import threading
+import warnings
+import six
+
+from google.protobuf.internal import api_implementation
+
+_USE_C_DESCRIPTORS = False
+if api_implementation.Type() == 'cpp':
+  # Used by MakeDescriptor in cpp mode
+  import binascii
+  import os
+  from google.protobuf.pyext import _message
+  _USE_C_DESCRIPTORS = True
+
+
+class Error(Exception):
+  """Base error for this module."""
+
+
+class TypeTransformationError(Error):
+  """Error transforming between python proto type and corresponding C++ type."""
+
+
+if _USE_C_DESCRIPTORS:
+  # This metaclass allows to override the behavior of code like
+  #     isinstance(my_descriptor, FieldDescriptor)
+  # and make it return True when the descriptor is an instance of the extension
+  # type written in C++.
+  class DescriptorMetaclass(type):
+    def __instancecheck__(cls, obj):
+      if super(DescriptorMetaclass, cls).__instancecheck__(obj):
+        return True
+      if isinstance(obj, cls._C_DESCRIPTOR_CLASS):
+        return True
+      return False
+else:
+  # The standard metaclass; nothing changes.
+  DescriptorMetaclass = type
+
+
+class _Lock(object):
+  """Wrapper class of threading.Lock(), which is allowed by 'with'."""
+
+  def __new__(cls):
+    self = object.__new__(cls)
+    self._lock = threading.Lock()  # pylint: disable=protected-access
+    return self
+
+  def __enter__(self):
+    self._lock.acquire()
+
+  def __exit__(self, exc_type, exc_value, exc_tb):
+    self._lock.release()
+
+
+_lock = threading.Lock()
+
+
+def _Deprecated(name):
+  if _Deprecated.count > 0:
+    _Deprecated.count -= 1
+    warnings.warn(
+        'Call to deprecated create function %s(). Note: Create unlinked '
+        'descriptors is going to go away. Please use get/find descriptors from '
+        'generated code or query the descriptor_pool.'
+        % name,
+        category=DeprecationWarning, stacklevel=3)
+
+
+# Deprecated warnings will print 100 times at most which should be enough for
+# users to notice and do not cause timeout.
+_Deprecated.count = 100
+
+
+_internal_create_key = object()
+
+
+class DescriptorBase(six.with_metaclass(DescriptorMetaclass)):
+
+  """Descriptors base class.
+
+  This class is the base of all descriptor classes. It provides common options
+  related functionality.
+
+  Attributes:
+    has_options:  True if the descriptor has non-default options.  Usually it
+        is not necessary to read this -- just call GetOptions() which will
+        happily return the default instance.  However, it's sometimes useful
+        for efficiency, and also useful inside the protobuf implementation to
+        avoid some bootstrapping issues.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    # The class, or tuple of classes, that are considered as "virtual
+    # subclasses" of this descriptor class.
+    _C_DESCRIPTOR_CLASS = ()
+
+  def __init__(self, options, serialized_options, options_class_name):
+    """Initialize the descriptor given its options message and the name of the
+    class of the options message. The name of the class is required in case
+    the options message is None and has to be created.
+    """
+    self._options = options
+    self._options_class_name = options_class_name
+    self._serialized_options = serialized_options
+
+    # Does this descriptor have non-default options?
+    self.has_options = (options is not None) or (serialized_options is not None)
+
+  def _SetOptions(self, options, options_class_name):
+    """Sets the descriptor's options
+
+    This function is used in generated proto2 files to update descriptor
+    options. It must not be used outside proto2.
+    """
+    self._options = options
+    self._options_class_name = options_class_name
+
+    # Does this descriptor have non-default options?
+    self.has_options = options is not None
+
+  def GetOptions(self):
+    """Retrieves descriptor options.
+
+    This method returns the options set or creates the default options for the
+    descriptor.
+    """
+    if self._options:
+      return self._options
+
+    from google.protobuf import descriptor_pb2
+    try:
+      options_class = getattr(descriptor_pb2,
+                              self._options_class_name)
+    except AttributeError:
+      raise RuntimeError('Unknown options class name %s!' %
+                         (self._options_class_name))
+
+    with _lock:
+      if self._serialized_options is None:
+        self._options = options_class()
+      else:
+        self._options = _ParseOptions(options_class(),
+                                      self._serialized_options)
+
+      return self._options
+
+
+class _NestedDescriptorBase(DescriptorBase):
+  """Common class for descriptors that can be nested."""
+
+  def __init__(self, options, options_class_name, name, full_name,
+               file, containing_type, serialized_start=None,
+               serialized_end=None, serialized_options=None):
+    """Constructor.
+
+    Args:
+      options: Protocol message options or None
+        to use default message options.
+      options_class_name (str): The class name of the above options.
+      name (str): Name of this protocol message type.
+      full_name (str): Fully-qualified name of this protocol message type,
+        which will include protocol "package" name and the name of any
+        enclosing types.
+      file (FileDescriptor): Reference to file info.
+      containing_type: if provided, this is a nested descriptor, with this
+        descriptor as parent, otherwise None.
+      serialized_start: The start index (inclusive) in block in the
+        file.serialized_pb that describes this descriptor.
+      serialized_end: The end index (exclusive) in block in the
+        file.serialized_pb that describes this descriptor.
+      serialized_options: Protocol message serialized options or None.
+    """
+    super(_NestedDescriptorBase, self).__init__(
+        options, serialized_options, options_class_name)
+
+    self.name = name
+    # TODO(falk): Add function to calculate full_name instead of having it in
+    #             memory?
+    self.full_name = full_name
+    self.file = file
+    self.containing_type = containing_type
+
+    self._serialized_start = serialized_start
+    self._serialized_end = serialized_end
+
+  def CopyToProto(self, proto):
+    """Copies this to the matching proto in descriptor_pb2.
+
+    Args:
+      proto: An empty proto instance from descriptor_pb2.
+
+    Raises:
+      Error: If self couldn't be serialized, due to to few constructor
+        arguments.
+    """
+    if (self.file is not None and
+        self._serialized_start is not None and
+        self._serialized_end is not None):
+      proto.ParseFromString(self.file.serialized_pb[
+          self._serialized_start:self._serialized_end])
+    else:
+      raise Error('Descriptor does not contain serialization.')
+
+
+class Descriptor(_NestedDescriptorBase):
+
+  """Descriptor for a protocol message type.
+
+  Attributes:
+      name (str): Name of this protocol message type.
+      full_name (str): Fully-qualified name of this protocol message type,
+          which will include protocol "package" name and the name of any
+          enclosing types.
+      containing_type (Descriptor): Reference to the descriptor of the type
+          containing us, or None if this is top-level.
+      fields (list[FieldDescriptor]): Field descriptors for all fields in
+          this type.
+      fields_by_number (dict(int, FieldDescriptor)): Same
+          :class:`FieldDescriptor` objects as in :attr:`fields`, but indexed
+          by "number" attribute in each FieldDescriptor.
+      fields_by_name (dict(str, FieldDescriptor)): Same
+          :class:`FieldDescriptor` objects as in :attr:`fields`, but indexed by
+          "name" attribute in each :class:`FieldDescriptor`.
+      nested_types (list[Descriptor]): Descriptor references
+          for all protocol message types nested within this one.
+      nested_types_by_name (dict(str, Descriptor)): Same Descriptor
+          objects as in :attr:`nested_types`, but indexed by "name" attribute
+          in each Descriptor.
+      enum_types (list[EnumDescriptor]): :class:`EnumDescriptor` references
+          for all enums contained within this type.
+      enum_types_by_name (dict(str, EnumDescriptor)): Same
+          :class:`EnumDescriptor` objects as in :attr:`enum_types`, but
+          indexed by "name" attribute in each EnumDescriptor.
+      enum_values_by_name (dict(str, EnumValueDescriptor)): Dict mapping
+          from enum value name to :class:`EnumValueDescriptor` for that value.
+      extensions (list[FieldDescriptor]): All extensions defined directly
+          within this message type (NOT within a nested type).
+      extensions_by_name (dict(str, FieldDescriptor)): Same FieldDescriptor
+          objects as :attr:`extensions`, but indexed by "name" attribute of each
+          FieldDescriptor.
+      is_extendable (bool):  Does this type define any extension ranges?
+      oneofs (list[OneofDescriptor]): The list of descriptors for oneof fields
+          in this message.
+      oneofs_by_name (dict(str, OneofDescriptor)): Same objects as in
+          :attr:`oneofs`, but indexed by "name" attribute.
+      file (FileDescriptor): Reference to file descriptor.
+
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.Descriptor
+
+    def __new__(
+        cls,
+        name=None,
+        full_name=None,
+        filename=None,
+        containing_type=None,
+        fields=None,
+        nested_types=None,
+        enum_types=None,
+        extensions=None,
+        options=None,
+        serialized_options=None,
+        is_extendable=True,
+        extension_ranges=None,
+        oneofs=None,
+        file=None,  # pylint: disable=redefined-builtin
+        serialized_start=None,
+        serialized_end=None,
+        syntax=None,
+        create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindMessageTypeByName(full_name)
+
+  # NOTE(tmarek): The file argument redefining a builtin is nothing we can
+  # fix right now since we don't know how many clients already rely on the
+  # name of the argument.
+  def __init__(self, name, full_name, filename, containing_type, fields,
+               nested_types, enum_types, extensions, options=None,
+               serialized_options=None,
+               is_extendable=True, extension_ranges=None, oneofs=None,
+               file=None, serialized_start=None, serialized_end=None,  # pylint: disable=redefined-builtin
+               syntax=None, create_key=None):
+    """Arguments to __init__() are as described in the description
+    of Descriptor fields above.
+
+    Note that filename is an obsolete argument, that is not used anymore.
+    Please use file.name to access this as an attribute.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('Descriptor')
+
+    super(Descriptor, self).__init__(
+        options, 'MessageOptions', name, full_name, file,
+        containing_type, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+
+    # We have fields in addition to fields_by_name and fields_by_number,
+    # so that:
+    #   1. Clients can index fields by "order in which they're listed."
+    #   2. Clients can easily iterate over all fields with the terse
+    #      syntax: for f in descriptor.fields: ...
+    self.fields = fields
+    for field in self.fields:
+      field.containing_type = self
+    self.fields_by_number = dict((f.number, f) for f in fields)
+    self.fields_by_name = dict((f.name, f) for f in fields)
+    self._fields_by_camelcase_name = None
+
+    self.nested_types = nested_types
+    for nested_type in nested_types:
+      nested_type.containing_type = self
+    self.nested_types_by_name = dict((t.name, t) for t in nested_types)
+
+    self.enum_types = enum_types
+    for enum_type in self.enum_types:
+      enum_type.containing_type = self
+    self.enum_types_by_name = dict((t.name, t) for t in enum_types)
+    self.enum_values_by_name = dict(
+        (v.name, v) for t in enum_types for v in t.values)
+
+    self.extensions = extensions
+    for extension in self.extensions:
+      extension.extension_scope = self
+    self.extensions_by_name = dict((f.name, f) for f in extensions)
+    self.is_extendable = is_extendable
+    self.extension_ranges = extension_ranges
+    self.oneofs = oneofs if oneofs is not None else []
+    self.oneofs_by_name = dict((o.name, o) for o in self.oneofs)
+    for oneof in self.oneofs:
+      oneof.containing_type = self
+    self.syntax = syntax or "proto2"
+
+  @property
+  def fields_by_camelcase_name(self):
+    """Same FieldDescriptor objects as in :attr:`fields`, but indexed by
+    :attr:`FieldDescriptor.camelcase_name`.
+    """
+    if self._fields_by_camelcase_name is None:
+      self._fields_by_camelcase_name = dict(
+          (f.camelcase_name, f) for f in self.fields)
+    return self._fields_by_camelcase_name
+
+  def EnumValueName(self, enum, value):
+    """Returns the string name of an enum value.
+
+    This is just a small helper method to simplify a common operation.
+
+    Args:
+      enum: string name of the Enum.
+      value: int, value of the enum.
+
+    Returns:
+      string name of the enum value.
+
+    Raises:
+      KeyError if either the Enum doesn't exist or the value is not a valid
+        value for the enum.
+    """
+    return self.enum_types_by_name[enum].values_by_number[value].name
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.DescriptorProto.
+
+    Args:
+      proto: An empty descriptor_pb2.DescriptorProto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(Descriptor, self).CopyToProto(proto)
+
+
+# TODO(robinson): We should have aggressive checking here,
+# for example:
+#   * If you specify a repeated field, you should not be allowed
+#     to specify a default value.
+#   * [Other examples here as needed].
+#
+# TODO(robinson): for this and other *Descriptor classes, we
+# might also want to lock things down aggressively (e.g.,
+# prevent clients from setting the attributes).  Having
+# stronger invariants here in general will reduce the number
+# of runtime checks we must do in reflection.py...
+class FieldDescriptor(DescriptorBase):
+
+  """Descriptor for a single field in a .proto file.
+
+  Attributes:
+    name (str): Name of this field, exactly as it appears in .proto.
+    full_name (str): Name of this field, including containing scope.  This is
+      particularly relevant for extensions.
+    index (int): Dense, 0-indexed index giving the order that this
+      field textually appears within its message in the .proto file.
+    number (int): Tag number declared for this field in the .proto file.
+
+    type (int): (One of the TYPE_* constants below) Declared type.
+    cpp_type (int): (One of the CPPTYPE_* constants below) C++ type used to
+      represent this field.
+
+    label (int): (One of the LABEL_* constants below) Tells whether this
+      field is optional, required, or repeated.
+    has_default_value (bool): True if this field has a default value defined,
+      otherwise false.
+    default_value (Varies): Default value of this field.  Only
+      meaningful for non-repeated scalar fields.  Repeated fields
+      should always set this to [], and non-repeated composite
+      fields should always set this to None.
+
+    containing_type (Descriptor): Descriptor of the protocol message
+      type that contains this field.  Set by the Descriptor constructor
+      if we're passed into one.
+      Somewhat confusingly, for extension fields, this is the
+      descriptor of the EXTENDED message, not the descriptor
+      of the message containing this field.  (See is_extension and
+      extension_scope below).
+    message_type (Descriptor): If a composite field, a descriptor
+      of the message type contained in this field.  Otherwise, this is None.
+    enum_type (EnumDescriptor): If this field contains an enum, a
+      descriptor of that enum.  Otherwise, this is None.
+
+    is_extension: True iff this describes an extension field.
+    extension_scope (Descriptor): Only meaningful if is_extension is True.
+      Gives the message that immediately contains this extension field.
+      Will be None iff we're a top-level (file-level) extension field.
+
+    options (descriptor_pb2.FieldOptions): Protocol message field options or
+      None to use default field options.
+
+    containing_oneof (OneofDescriptor): If the field is a member of a oneof
+      union, contains its descriptor. Otherwise, None.
+
+    file (FileDescriptor): Reference to file descriptor.
+  """
+
+  # Must be consistent with C++ FieldDescriptor::Type enum in
+  # descriptor.h.
+  #
+  # TODO(robinson): Find a way to eliminate this repetition.
+  TYPE_DOUBLE         = 1
+  TYPE_FLOAT          = 2
+  TYPE_INT64          = 3
+  TYPE_UINT64         = 4
+  TYPE_INT32          = 5
+  TYPE_FIXED64        = 6
+  TYPE_FIXED32        = 7
+  TYPE_BOOL           = 8
+  TYPE_STRING         = 9
+  TYPE_GROUP          = 10
+  TYPE_MESSAGE        = 11
+  TYPE_BYTES          = 12
+  TYPE_UINT32         = 13
+  TYPE_ENUM           = 14
+  TYPE_SFIXED32       = 15
+  TYPE_SFIXED64       = 16
+  TYPE_SINT32         = 17
+  TYPE_SINT64         = 18
+  MAX_TYPE            = 18
+
+  # Must be consistent with C++ FieldDescriptor::CppType enum in
+  # descriptor.h.
+  #
+  # TODO(robinson): Find a way to eliminate this repetition.
+  CPPTYPE_INT32       = 1
+  CPPTYPE_INT64       = 2
+  CPPTYPE_UINT32      = 3
+  CPPTYPE_UINT64      = 4
+  CPPTYPE_DOUBLE      = 5
+  CPPTYPE_FLOAT       = 6
+  CPPTYPE_BOOL        = 7
+  CPPTYPE_ENUM        = 8
+  CPPTYPE_STRING      = 9
+  CPPTYPE_MESSAGE     = 10
+  MAX_CPPTYPE         = 10
+
+  _PYTHON_TO_CPP_PROTO_TYPE_MAP = {
+      TYPE_DOUBLE: CPPTYPE_DOUBLE,
+      TYPE_FLOAT: CPPTYPE_FLOAT,
+      TYPE_ENUM: CPPTYPE_ENUM,
+      TYPE_INT64: CPPTYPE_INT64,
+      TYPE_SINT64: CPPTYPE_INT64,
+      TYPE_SFIXED64: CPPTYPE_INT64,
+      TYPE_UINT64: CPPTYPE_UINT64,
+      TYPE_FIXED64: CPPTYPE_UINT64,
+      TYPE_INT32: CPPTYPE_INT32,
+      TYPE_SFIXED32: CPPTYPE_INT32,
+      TYPE_SINT32: CPPTYPE_INT32,
+      TYPE_UINT32: CPPTYPE_UINT32,
+      TYPE_FIXED32: CPPTYPE_UINT32,
+      TYPE_BYTES: CPPTYPE_STRING,
+      TYPE_STRING: CPPTYPE_STRING,
+      TYPE_BOOL: CPPTYPE_BOOL,
+      TYPE_MESSAGE: CPPTYPE_MESSAGE,
+      TYPE_GROUP: CPPTYPE_MESSAGE
+      }
+
+  # Must be consistent with C++ FieldDescriptor::Label enum in
+  # descriptor.h.
+  #
+  # TODO(robinson): Find a way to eliminate this repetition.
+  LABEL_OPTIONAL      = 1
+  LABEL_REQUIRED      = 2
+  LABEL_REPEATED      = 3
+  MAX_LABEL           = 3
+
+  # Must be consistent with C++ constants kMaxNumber, kFirstReservedNumber,
+  # and kLastReservedNumber in descriptor.h
+  MAX_FIELD_NUMBER = (1 << 29) - 1
+  FIRST_RESERVED_FIELD_NUMBER = 19000
+  LAST_RESERVED_FIELD_NUMBER = 19999
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.FieldDescriptor
+
+    def __new__(cls, name, full_name, index, number, type, cpp_type, label,
+                default_value, message_type, enum_type, containing_type,
+                is_extension, extension_scope, options=None,
+                serialized_options=None,
+                has_default_value=True, containing_oneof=None, json_name=None,
+                file=None, create_key=None):  # pylint: disable=redefined-builtin
+      _message.Message._CheckCalledFromGeneratedFile()
+      if is_extension:
+        return _message.default_pool.FindExtensionByName(full_name)
+      else:
+        return _message.default_pool.FindFieldByName(full_name)
+
+  def __init__(self, name, full_name, index, number, type, cpp_type, label,
+               default_value, message_type, enum_type, containing_type,
+               is_extension, extension_scope, options=None,
+               serialized_options=None,
+               has_default_value=True, containing_oneof=None, json_name=None,
+               file=None, create_key=None):  # pylint: disable=redefined-builtin
+    """The arguments are as described in the description of FieldDescriptor
+    attributes above.
+
+    Note that containing_type may be None, and may be set later if necessary
+    (to deal with circular references between message types, for example).
+    Likewise for extension_scope.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('FieldDescriptor')
+
+    super(FieldDescriptor, self).__init__(
+        options, serialized_options, 'FieldOptions')
+    self.name = name
+    self.full_name = full_name
+    self.file = file
+    self._camelcase_name = None
+    if json_name is None:
+      self.json_name = _ToJsonName(name)
+    else:
+      self.json_name = json_name
+    self.index = index
+    self.number = number
+    self.type = type
+    self.cpp_type = cpp_type
+    self.label = label
+    self.has_default_value = has_default_value
+    self.default_value = default_value
+    self.containing_type = containing_type
+    self.message_type = message_type
+    self.enum_type = enum_type
+    self.is_extension = is_extension
+    self.extension_scope = extension_scope
+    self.containing_oneof = containing_oneof
+    if api_implementation.Type() == 'cpp':
+      if is_extension:
+        self._cdescriptor = _message.default_pool.FindExtensionByName(full_name)
+      else:
+        self._cdescriptor = _message.default_pool.FindFieldByName(full_name)
+    else:
+      self._cdescriptor = None
+
+  @property
+  def camelcase_name(self):
+    """Camelcase name of this field.
+
+    Returns:
+      str: the name in CamelCase.
+    """
+    if self._camelcase_name is None:
+      self._camelcase_name = _ToCamelCase(self.name)
+    return self._camelcase_name
+
+  @staticmethod
+  def ProtoTypeToCppProtoType(proto_type):
+    """Converts from a Python proto type to a C++ Proto Type.
+
+    The Python ProtocolBuffer classes specify both the 'Python' datatype and the
+    'C++' datatype - and they're not the same. This helper method should
+    translate from one to another.
+
+    Args:
+      proto_type: the Python proto type (descriptor.FieldDescriptor.TYPE_*)
+    Returns:
+      int: descriptor.FieldDescriptor.CPPTYPE_*, the C++ type.
+    Raises:
+      TypeTransformationError: when the Python proto type isn't known.
+    """
+    try:
+      return FieldDescriptor._PYTHON_TO_CPP_PROTO_TYPE_MAP[proto_type]
+    except KeyError:
+      raise TypeTransformationError('Unknown proto_type: %s' % proto_type)
+
+
+class EnumDescriptor(_NestedDescriptorBase):
+
+  """Descriptor for an enum defined in a .proto file.
+
+  Attributes:
+    name (str): Name of the enum type.
+    full_name (str): Full name of the type, including package name
+      and any enclosing type(s).
+
+    values (list[EnumValueDescriptors]): List of the values
+      in this enum.
+    values_by_name (dict(str, EnumValueDescriptor)): Same as :attr:`values`,
+      but indexed by the "name" field of each EnumValueDescriptor.
+    values_by_number (dict(int, EnumValueDescriptor)): Same as :attr:`values`,
+      but indexed by the "number" field of each EnumValueDescriptor.
+    containing_type (Descriptor): Descriptor of the immediate containing
+      type of this enum, or None if this is an enum defined at the
+      top level in a .proto file.  Set by Descriptor's constructor
+      if we're passed into one.
+    file (FileDescriptor): Reference to file descriptor.
+    options (descriptor_pb2.EnumOptions): Enum options message or
+      None to use default enum options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.EnumDescriptor
+
+    def __new__(cls, name, full_name, filename, values,
+                containing_type=None, options=None,
+                serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+                serialized_start=None, serialized_end=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindEnumTypeByName(full_name)
+
+  def __init__(self, name, full_name, filename, values,
+               containing_type=None, options=None,
+               serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+               serialized_start=None, serialized_end=None, create_key=None):
+    """Arguments are as described in the attribute description above.
+
+    Note that filename is an obsolete argument, that is not used anymore.
+    Please use file.name to access this as an attribute.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('EnumDescriptor')
+
+    super(EnumDescriptor, self).__init__(
+        options, 'EnumOptions', name, full_name, file,
+        containing_type, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+
+    self.values = values
+    for value in self.values:
+      value.type = self
+    self.values_by_name = dict((v.name, v) for v in values)
+    # Values are reversed to ensure that the first alias is retained.
+    self.values_by_number = dict((v.number, v) for v in reversed(values))
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.EnumDescriptorProto.
+
+    Args:
+      proto (descriptor_pb2.EnumDescriptorProto): An empty descriptor proto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(EnumDescriptor, self).CopyToProto(proto)
+
+
+class EnumValueDescriptor(DescriptorBase):
+
+  """Descriptor for a single value within an enum.
+
+  Attributes:
+    name (str): Name of this value.
+    index (int): Dense, 0-indexed index giving the order that this
+      value appears textually within its enum in the .proto file.
+    number (int): Actual number assigned to this enum value.
+    type (EnumDescriptor): :class:`EnumDescriptor` to which this value
+      belongs.  Set by :class:`EnumDescriptor`'s constructor if we're
+      passed into one.
+    options (descriptor_pb2.EnumValueOptions): Enum value options message or
+      None to use default enum value options options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.EnumValueDescriptor
+
+    def __new__(cls, name, index, number,
+                type=None,  # pylint: disable=redefined-builtin
+                options=None, serialized_options=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      # There is no way we can build a complete EnumValueDescriptor with the
+      # given parameters (the name of the Enum is not known, for example).
+      # Fortunately generated files just pass it to the EnumDescriptor()
+      # constructor, which will ignore it, so returning None is good enough.
+      return None
+
+  def __init__(self, name, index, number,
+               type=None,  # pylint: disable=redefined-builtin
+               options=None, serialized_options=None, create_key=None):
+    """Arguments are as described in the attribute description above."""
+    if create_key is not _internal_create_key:
+      _Deprecated('EnumValueDescriptor')
+
+    super(EnumValueDescriptor, self).__init__(
+        options, serialized_options, 'EnumValueOptions')
+    self.name = name
+    self.index = index
+    self.number = number
+    self.type = type
+
+
+class OneofDescriptor(DescriptorBase):
+  """Descriptor for a oneof field.
+
+  Attributes:
+    name (str): Name of the oneof field.
+    full_name (str): Full name of the oneof field, including package name.
+    index (int): 0-based index giving the order of the oneof field inside
+      its containing type.
+    containing_type (Descriptor): :class:`Descriptor` of the protocol message
+      type that contains this field.  Set by the :class:`Descriptor` constructor
+      if we're passed into one.
+    fields (list[FieldDescriptor]): The list of field descriptors this
+      oneof can contain.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.OneofDescriptor
+
+    def __new__(
+        cls, name, full_name, index, containing_type, fields, options=None,
+        serialized_options=None, create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()
+      return _message.default_pool.FindOneofByName(full_name)
+
+  def __init__(
+      self, name, full_name, index, containing_type, fields, options=None,
+      serialized_options=None, create_key=None):
+    """Arguments are as described in the attribute description above."""
+    if create_key is not _internal_create_key:
+      _Deprecated('OneofDescriptor')
+
+    super(OneofDescriptor, self).__init__(
+        options, serialized_options, 'OneofOptions')
+    self.name = name
+    self.full_name = full_name
+    self.index = index
+    self.containing_type = containing_type
+    self.fields = fields
+
+
+class ServiceDescriptor(_NestedDescriptorBase):
+
+  """Descriptor for a service.
+
+  Attributes:
+    name (str): Name of the service.
+    full_name (str): Full name of the service, including package name.
+    index (int): 0-indexed index giving the order that this services
+      definition appears within the .proto file.
+    methods (list[MethodDescriptor]): List of methods provided by this
+      service.
+    methods_by_name (dict(str, MethodDescriptor)): Same
+      :class:`MethodDescriptor` objects as in :attr:`methods_by_name`, but
+      indexed by "name" attribute in each :class:`MethodDescriptor`.
+    options (descriptor_pb2.ServiceOptions): Service options message or
+      None to use default service options.
+    file (FileDescriptor): Reference to file info.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.ServiceDescriptor
+
+    def __new__(
+        cls,
+        name=None,
+        full_name=None,
+        index=None,
+        methods=None,
+        options=None,
+        serialized_options=None,
+        file=None,  # pylint: disable=redefined-builtin
+        serialized_start=None,
+        serialized_end=None,
+        create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()  # pylint: disable=protected-access
+      return _message.default_pool.FindServiceByName(full_name)
+
+  def __init__(self, name, full_name, index, methods, options=None,
+               serialized_options=None, file=None,  # pylint: disable=redefined-builtin
+               serialized_start=None, serialized_end=None, create_key=None):
+    if create_key is not _internal_create_key:
+      _Deprecated('ServiceDescriptor')
+
+    super(ServiceDescriptor, self).__init__(
+        options, 'ServiceOptions', name, full_name, file,
+        None, serialized_start=serialized_start,
+        serialized_end=serialized_end, serialized_options=serialized_options)
+    self.index = index
+    self.methods = methods
+    self.methods_by_name = dict((m.name, m) for m in methods)
+    # Set the containing service for each method in this service.
+    for method in self.methods:
+      method.containing_service = self
+
+  def FindMethodByName(self, name):
+    """Searches for the specified method, and returns its descriptor.
+
+    Args:
+      name (str): Name of the method.
+    Returns:
+      MethodDescriptor or None: the descriptor for the requested method, if
+      found.
+    """
+    return self.methods_by_name.get(name, None)
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.ServiceDescriptorProto.
+
+    Args:
+      proto (descriptor_pb2.ServiceDescriptorProto): An empty descriptor proto.
+    """
+    # This function is overridden to give a better doc comment.
+    super(ServiceDescriptor, self).CopyToProto(proto)
+
+
+class MethodDescriptor(DescriptorBase):
+
+  """Descriptor for a method in a service.
+
+  Attributes:
+    name (str): Name of the method within the service.
+    full_name (str): Full name of method.
+    index (int): 0-indexed index of the method inside the service.
+    containing_service (ServiceDescriptor): The service that contains this
+      method.
+    input_type (Descriptor): The descriptor of the message that this method
+      accepts.
+    output_type (Descriptor): The descriptor of the message that this method
+      returns.
+    options (descriptor_pb2.MethodOptions or None): Method options message, or
+      None to use default method options.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.MethodDescriptor
+
+    def __new__(cls, name, full_name, index, containing_service,
+                input_type, output_type, options=None, serialized_options=None,
+                create_key=None):
+      _message.Message._CheckCalledFromGeneratedFile()  # pylint: disable=protected-access
+      return _message.default_pool.FindMethodByName(full_name)
+
+  def __init__(self, name, full_name, index, containing_service,
+               input_type, output_type, options=None, serialized_options=None,
+               create_key=None):
+    """The arguments are as described in the description of MethodDescriptor
+    attributes above.
+
+    Note that containing_service may be None, and may be set later if necessary.
+    """
+    if create_key is not _internal_create_key:
+      _Deprecated('MethodDescriptor')
+
+    super(MethodDescriptor, self).__init__(
+        options, serialized_options, 'MethodOptions')
+    self.name = name
+    self.full_name = full_name
+    self.index = index
+    self.containing_service = containing_service
+    self.input_type = input_type
+    self.output_type = output_type
+
+
+class FileDescriptor(DescriptorBase):
+  """Descriptor for a file. Mimics the descriptor_pb2.FileDescriptorProto.
+
+  Note that :attr:`enum_types_by_name`, :attr:`extensions_by_name`, and
+  :attr:`dependencies` fields are only set by the
+  :py:mod:`google.protobuf.message_factory` module, and not by the generated
+  proto code.
+
+  Attributes:
+    name (str): Name of file, relative to root of source tree.
+    package (str): Name of the package
+    syntax (str): string indicating syntax of the file (can be "proto2" or
+      "proto3")
+    serialized_pb (bytes): Byte string of serialized
+      :class:`descriptor_pb2.FileDescriptorProto`.
+    dependencies (list[FileDescriptor]): List of other :class:`FileDescriptor`
+      objects this :class:`FileDescriptor` depends on.
+    public_dependencies (list[FileDescriptor]): A subset of
+      :attr:`dependencies`, which were declared as "public".
+    message_types_by_name (dict(str, Descriptor)): Mapping from message names
+      to their :class:`Desctiptor`.
+    enum_types_by_name (dict(str, EnumDescriptor)): Mapping from enum names to
+      their :class:`EnumDescriptor`.
+    extensions_by_name (dict(str, FieldDescriptor)): Mapping from extension
+      names declared at file scope to their :class:`FieldDescriptor`.
+    services_by_name (dict(str, ServiceDescriptor)): Mapping from services'
+      names to their :class:`ServiceDescriptor`.
+    pool (DescriptorPool): The pool this descriptor belongs to.  When not
+      passed to the constructor, the global default pool is used.
+  """
+
+  if _USE_C_DESCRIPTORS:
+    _C_DESCRIPTOR_CLASS = _message.FileDescriptor
+
+    def __new__(cls, name, package, options=None,
+                serialized_options=None, serialized_pb=None,
+                dependencies=None, public_dependencies=None,
+                syntax=None, pool=None, create_key=None):
+      # FileDescriptor() is called from various places, not only from generated
+      # files, to register dynamic proto files and messages.
+      # pylint: disable=g-explicit-bool-comparison
+      if serialized_pb == b'':
+        # Cpp generated code must be linked in if serialized_pb is ''
+        try:
+          return _message.default_pool.FindFileByName(name)
+        except KeyError:
+          raise RuntimeError('Please link in cpp generated lib for %s' % (name))
+      elif serialized_pb:
+        return _message.default_pool.AddSerializedFile(serialized_pb)
+      else:
+        return super(FileDescriptor, cls).__new__(cls)
+
+  def __init__(self, name, package, options=None,
+               serialized_options=None, serialized_pb=None,
+               dependencies=None, public_dependencies=None,
+               syntax=None, pool=None, create_key=None):
+    """Constructor."""
+    if create_key is not _internal_create_key:
+      _Deprecated('FileDescriptor')
+
+    super(FileDescriptor, self).__init__(
+        options, serialized_options, 'FileOptions')
+
+    if pool is None:
+      from google.protobuf import descriptor_pool
+      pool = descriptor_pool.Default()
+    self.pool = pool
+    self.message_types_by_name = {}
+    self.name = name
+    self.package = package
+    self.syntax = syntax or "proto2"
+    self.serialized_pb = serialized_pb
+
+    self.enum_types_by_name = {}
+    self.extensions_by_name = {}
+    self.services_by_name = {}
+    self.dependencies = (dependencies or [])
+    self.public_dependencies = (public_dependencies or [])
+
+  def CopyToProto(self, proto):
+    """Copies this to a descriptor_pb2.FileDescriptorProto.
+
+    Args:
+      proto: An empty descriptor_pb2.FileDescriptorProto.
+    """
+    proto.ParseFromString(self.serialized_pb)
+
+
+def _ParseOptions(message, string):
+  """Parses serialized options.
+
+  This helper function is used to parse serialized options in generated
+  proto2 files. It must not be used outside proto2.
+  """
+  message.ParseFromString(string)
+  return message
+
+
+def _ToCamelCase(name):
+  """Converts name to camel-case and returns it."""
+  capitalize_next = False
+  result = []
+
+  for c in name:
+    if c == '_':
+      if result:
+        capitalize_next = True
+    elif capitalize_next:
+      result.append(c.upper())
+      capitalize_next = False
+    else:
+      result += c
+
+  # Lower-case the first letter.
+  if result and result[0].isupper():
+    result[0] = result[0].lower()
+  return ''.join(result)
+
+
+def _OptionsOrNone(descriptor_proto):
+  """Returns the value of the field `options`, or None if it is not set."""
+  if descriptor_proto.HasField('options'):
+    return descriptor_proto.options
+  else:
+    return None
+
+
+def _ToJsonName(name):
+  """Converts name to Json name and returns it."""
+  capitalize_next = False
+  result = []
+
+  for c in name:
+    if c == '_':
+      capitalize_next = True
+    elif capitalize_next:
+      result.append(c.upper())
+      capitalize_next = False
+    else:
+      result += c
+
+  return ''.join(result)
+
+
+def MakeDescriptor(desc_proto, package='', build_file_if_cpp=True,
+                   syntax=None):
+  """Make a protobuf Descriptor given a DescriptorProto protobuf.
+
+  Handles nested descriptors. Note that this is limited to the scope of defining
+  a message inside of another message. Composite fields can currently only be
+  resolved if the message is defined in the same scope as the field.
+
+  Args:
+    desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
+    package: Optional package name for the new message Descriptor (string).
+    build_file_if_cpp: Update the C++ descriptor pool if api matches.
+                       Set to False on recursion, so no duplicates are created.
+    syntax: The syntax/semantics that should be used.  Set to "proto3" to get
+            proto3 field presence semantics.
+  Returns:
+    A Descriptor for protobuf messages.
+  """
+  if api_implementation.Type() == 'cpp' and build_file_if_cpp:
+    # The C++ implementation requires all descriptors to be backed by the same
+    # definition in the C++ descriptor pool. To do this, we build a
+    # FileDescriptorProto with the same definition as this descriptor and build
+    # it into the pool.
+    from google.protobuf import descriptor_pb2
+    file_descriptor_proto = descriptor_pb2.FileDescriptorProto()
+    file_descriptor_proto.message_type.add().MergeFrom(desc_proto)
+
+    # Generate a random name for this proto file to prevent conflicts with any
+    # imported ones. We need to specify a file name so the descriptor pool
+    # accepts our FileDescriptorProto, but it is not important what that file
+    # name is actually set to.
+    proto_name = binascii.hexlify(os.urandom(16)).decode('ascii')
+
+    if package:
+      file_descriptor_proto.name = os.path.join(package.replace('.', '/'),
+                                                proto_name + '.proto')
+      file_descriptor_proto.package = package
+    else:
+      file_descriptor_proto.name = proto_name + '.proto'
+
+    _message.default_pool.Add(file_descriptor_proto)
+    result = _message.default_pool.FindFileByName(file_descriptor_proto.name)
+
+    if _USE_C_DESCRIPTORS:
+      return result.message_types_by_name[desc_proto.name]
+
+  full_message_name = [desc_proto.name]
+  if package: full_message_name.insert(0, package)
+
+  # Create Descriptors for enum types
+  enum_types = {}
+  for enum_proto in desc_proto.enum_type:
+    full_name = '.'.join(full_message_name + [enum_proto.name])
+    enum_desc = EnumDescriptor(
+        enum_proto.name, full_name, None, [
+            EnumValueDescriptor(enum_val.name, ii, enum_val.number,
+                                create_key=_internal_create_key)
+            for ii, enum_val in enumerate(enum_proto.value)],
+        create_key=_internal_create_key)
+    enum_types[full_name] = enum_desc
+
+  # Create Descriptors for nested types
+  nested_types = {}
+  for nested_proto in desc_proto.nested_type:
+    full_name = '.'.join(full_message_name + [nested_proto.name])
+    # Nested types are just those defined inside of the message, not all types
+    # used by fields in the message, so no loops are possible here.
+    nested_desc = MakeDescriptor(nested_proto,
+                                 package='.'.join(full_message_name),
+                                 build_file_if_cpp=False,
+                                 syntax=syntax)
+    nested_types[full_name] = nested_desc
+
+  fields = []
+  for field_proto in desc_proto.field:
+    full_name = '.'.join(full_message_name + [field_proto.name])
+    enum_desc = None
+    nested_desc = None
+    if field_proto.json_name:
+      json_name = field_proto.json_name
+    else:
+      json_name = None
+    if field_proto.HasField('type_name'):
+      type_name = field_proto.type_name
+      full_type_name = '.'.join(full_message_name +
+                                [type_name[type_name.rfind('.')+1:]])
+      if full_type_name in nested_types:
+        nested_desc = nested_types[full_type_name]
+      elif full_type_name in enum_types:
+        enum_desc = enum_types[full_type_name]
+      # Else type_name references a non-local type, which isn't implemented
+    field = FieldDescriptor(
+        field_proto.name, full_name, field_proto.number - 1,
+        field_proto.number, field_proto.type,
+        FieldDescriptor.ProtoTypeToCppProtoType(field_proto.type),
+        field_proto.label, None, nested_desc, enum_desc, None, False, None,
+        options=_OptionsOrNone(field_proto), has_default_value=False,
+        json_name=json_name, create_key=_internal_create_key)
+    fields.append(field)
+
+  desc_name = '.'.join(full_message_name)
+  return Descriptor(desc_proto.name, desc_name, None, None, fields,
+                    list(nested_types.values()), list(enum_types.values()), [],
+                    options=_OptionsOrNone(desc_proto),
+                    create_key=_internal_create_key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_database.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..073eddc711571a7f510ff8b189e2a9a863d53454
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_database.py
@@ -0,0 +1,177 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Provides a container for DescriptorProtos."""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+import warnings
+
+
+class Error(Exception):
+  pass
+
+
+class DescriptorDatabaseConflictingDefinitionError(Error):
+  """Raised when a proto is added with the same name & different descriptor."""
+
+
+class DescriptorDatabase(object):
+  """A container accepting FileDescriptorProtos and maps DescriptorProtos."""
+
+  def __init__(self):
+    self._file_desc_protos_by_file = {}
+    self._file_desc_protos_by_symbol = {}
+
+  def Add(self, file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this database.
+
+    Args:
+      file_desc_proto: The FileDescriptorProto to add.
+    Raises:
+      DescriptorDatabaseConflictingDefinitionError: if an attempt is made to
+        add a proto with the same name but different definition than an
+        existing proto in the database.
+    """
+    proto_name = file_desc_proto.name
+    if proto_name not in self._file_desc_protos_by_file:
+      self._file_desc_protos_by_file[proto_name] = file_desc_proto
+    elif self._file_desc_protos_by_file[proto_name] != file_desc_proto:
+      raise DescriptorDatabaseConflictingDefinitionError(
+          '%s already added, but with different descriptor.' % proto_name)
+    else:
+      return
+
+    # Add all the top-level descriptors to the index.
+    package = file_desc_proto.package
+    for message in file_desc_proto.message_type:
+      for name in _ExtractSymbols(message, package):
+        self._AddSymbol(name, file_desc_proto)
+    for enum in file_desc_proto.enum_type:
+      self._AddSymbol(('.'.join((package, enum.name))), file_desc_proto)
+      for enum_value in enum.value:
+        self._file_desc_protos_by_symbol[
+            '.'.join((package, enum_value.name))] = file_desc_proto
+    for extension in file_desc_proto.extension:
+      self._AddSymbol(('.'.join((package, extension.name))), file_desc_proto)
+    for service in file_desc_proto.service:
+      self._AddSymbol(('.'.join((package, service.name))), file_desc_proto)
+
+  def FindFileByName(self, name):
+    """Finds the file descriptor proto by file name.
+
+    Typically the file name is a relative path ending to a .proto file. The
+    proto with the given name will have to have been added to this database
+    using the Add method or else an error will be raised.
+
+    Args:
+      name: The file name to find.
+
+    Returns:
+      The file descriptor proto matching the name.
+
+    Raises:
+      KeyError if no file by the given name was added.
+    """
+
+    return self._file_desc_protos_by_file[name]
+
+  def FindFileContainingSymbol(self, symbol):
+    """Finds the file descriptor proto containing the specified symbol.
+
+    The symbol should be a fully qualified name including the file descriptor's
+    package and any containing messages. Some examples:
+
+    'some.package.name.Message'
+    'some.package.name.Message.NestedEnum'
+    'some.package.name.Message.some_field'
+
+    The file descriptor proto containing the specified symbol must be added to
+    this database using the Add method or else an error will be raised.
+
+    Args:
+      symbol: The fully qualified symbol name.
+
+    Returns:
+      The file descriptor proto containing the symbol.
+
+    Raises:
+      KeyError if no file contains the specified symbol.
+    """
+    try:
+      return self._file_desc_protos_by_symbol[symbol]
+    except KeyError:
+      # Fields, enum values, and nested extensions are not in
+      # _file_desc_protos_by_symbol. Try to find the top level
+      # descriptor. Non-existent nested symbol under a valid top level
+      # descriptor can also be found. The behavior is the same with
+      # protobuf C++.
+      top_level, _, _ = symbol.rpartition('.')
+      try:
+        return self._file_desc_protos_by_symbol[top_level]
+      except KeyError:
+        # Raise the original symbol as a KeyError for better diagnostics.
+        raise KeyError(symbol)
+
+  def FindFileContainingExtension(self, extendee_name, extension_number):
+    # TODO(jieluo): implement this API.
+    return None
+
+  def FindAllExtensionNumbers(self, extendee_name):
+    # TODO(jieluo): implement this API.
+    return []
+
+  def _AddSymbol(self, name, file_desc_proto):
+    if name in self._file_desc_protos_by_symbol:
+      warn_msg = ('Conflict register for file "' + file_desc_proto.name +
+                  '": ' + name +
+                  ' is already defined in file "' +
+                  self._file_desc_protos_by_symbol[name].name + '"')
+      warnings.warn(warn_msg, RuntimeWarning)
+    self._file_desc_protos_by_symbol[name] = file_desc_proto
+
+
+def _ExtractSymbols(desc_proto, package):
+  """Pulls out all the symbols from a descriptor proto.
+
+  Args:
+    desc_proto: The proto to extract symbols from.
+    package: The package containing the descriptor type.
+
+  Yields:
+    The fully qualified name found in the descriptor.
+  """
+  message_name = package + '.' + desc_proto.name if package else desc_proto.name
+  yield message_name
+  for nested_type in desc_proto.nested_type:
+    for symbol in _ExtractSymbols(nested_type, message_name):
+      yield symbol
+  for enum_type in desc_proto.enum_type:
+    yield '.'.join((message_name, enum_type.name))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..0de963f8b5933b5ca7eefb3165c156011c678bc4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pb2.py
@@ -0,0 +1,2106 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/descriptor.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/descriptor.proto',
+  package='google.protobuf',
+  syntax='proto2',
+  serialized_options=None,
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n google/protobuf/descriptor.proto\x12\x0fgoogle.protobuf\"G\n\x11\x46ileDescriptorSet\x12\x32\n\x04\x66ile\x18\x01 \x03(\x0b\x32$.google.protobuf.FileDescriptorProto\"\xdb\x03\n\x13\x46ileDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07package\x18\x02 \x01(\t\x12\x12\n\ndependency\x18\x03 \x03(\t\x12\x19\n\x11public_dependency\x18\n \x03(\x05\x12\x17\n\x0fweak_dependency\x18\x0b \x03(\x05\x12\x36\n\x0cmessage_type\x18\x04 \x03(\x0b\x32 .google.protobuf.DescriptorProto\x12\x37\n\tenum_type\x18\x05 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProto\x12\x38\n\x07service\x18\x06 \x03(\x0b\x32\'.google.protobuf.ServiceDescriptorProto\x12\x38\n\textension\x18\x07 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProto\x12-\n\x07options\x18\x08 \x01(\x0b\x32\x1c.google.protobuf.FileOptions\x12\x39\n\x10source_code_info\x18\t \x01(\x0b\x32\x1f.google.protobuf.SourceCodeInfo\x12\x0e\n\x06syntax\x18\x0c \x01(\t\"\xa9\x05\n\x0f\x44\x65scriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x05\x66ield\x18\x02 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProto\x12\x38\n\textension\x18\x06 \x03(\x0b\x32%.google.protobuf.FieldDescriptorProto\x12\x35\n\x0bnested_type\x18\x03 \x03(\x0b\x32 .google.protobuf.DescriptorProto\x12\x37\n\tenum_type\x18\x04 \x03(\x0b\x32$.google.protobuf.EnumDescriptorProto\x12H\n\x0f\x65xtension_range\x18\x05 \x03(\x0b\x32/.google.protobuf.DescriptorProto.ExtensionRange\x12\x39\n\noneof_decl\x18\x08 \x03(\x0b\x32%.google.protobuf.OneofDescriptorProto\x12\x30\n\x07options\x18\x07 \x01(\x0b\x32\x1f.google.protobuf.MessageOptions\x12\x46\n\x0ereserved_range\x18\t \x03(\x0b\x32..google.protobuf.DescriptorProto.ReservedRange\x12\x15\n\rreserved_name\x18\n \x03(\t\x1a\x65\n\x0e\x45xtensionRange\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05\x12\x37\n\x07options\x18\x03 \x01(\x0b\x32&.google.protobuf.ExtensionRangeOptions\x1a+\n\rReservedRange\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05\"g\n\x15\x45xtensionRangeOptions\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xd5\x05\n\x14\x46ieldDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06number\x18\x03 \x01(\x05\x12:\n\x05label\x18\x04 \x01(\x0e\x32+.google.protobuf.FieldDescriptorProto.Label\x12\x38\n\x04type\x18\x05 \x01(\x0e\x32*.google.protobuf.FieldDescriptorProto.Type\x12\x11\n\ttype_name\x18\x06 \x01(\t\x12\x10\n\x08\x65xtendee\x18\x02 \x01(\t\x12\x15\n\rdefault_value\x18\x07 \x01(\t\x12\x13\n\x0boneof_index\x18\t \x01(\x05\x12\x11\n\tjson_name\x18\n \x01(\t\x12.\n\x07options\x18\x08 \x01(\x0b\x32\x1d.google.protobuf.FieldOptions\x12\x17\n\x0fproto3_optional\x18\x11 \x01(\x08\"\xb6\x02\n\x04Type\x12\x0f\n\x0bTYPE_DOUBLE\x10\x01\x12\x0e\n\nTYPE_FLOAT\x10\x02\x12\x0e\n\nTYPE_INT64\x10\x03\x12\x0f\n\x0bTYPE_UINT64\x10\x04\x12\x0e\n\nTYPE_INT32\x10\x05\x12\x10\n\x0cTYPE_FIXED64\x10\x06\x12\x10\n\x0cTYPE_FIXED32\x10\x07\x12\r\n\tTYPE_BOOL\x10\x08\x12\x0f\n\x0bTYPE_STRING\x10\t\x12\x0e\n\nTYPE_GROUP\x10\n\x12\x10\n\x0cTYPE_MESSAGE\x10\x0b\x12\x0e\n\nTYPE_BYTES\x10\x0c\x12\x0f\n\x0bTYPE_UINT32\x10\r\x12\r\n\tTYPE_ENUM\x10\x0e\x12\x11\n\rTYPE_SFIXED32\x10\x0f\x12\x11\n\rTYPE_SFIXED64\x10\x10\x12\x0f\n\x0bTYPE_SINT32\x10\x11\x12\x0f\n\x0bTYPE_SINT64\x10\x12\"C\n\x05Label\x12\x12\n\x0eLABEL_OPTIONAL\x10\x01\x12\x12\n\x0eLABEL_REQUIRED\x10\x02\x12\x12\n\x0eLABEL_REPEATED\x10\x03\"T\n\x14OneofDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12.\n\x07options\x18\x02 \x01(\x0b\x32\x1d.google.protobuf.OneofOptions\"\xa4\x02\n\x13\x45numDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x38\n\x05value\x18\x02 \x03(\x0b\x32).google.protobuf.EnumValueDescriptorProto\x12-\n\x07options\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.EnumOptions\x12N\n\x0ereserved_range\x18\x04 \x03(\x0b\x32\x36.google.protobuf.EnumDescriptorProto.EnumReservedRange\x12\x15\n\rreserved_name\x18\x05 \x03(\t\x1a/\n\x11\x45numReservedRange\x12\r\n\x05start\x18\x01 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x05\"l\n\x18\x45numValueDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06number\x18\x02 \x01(\x05\x12\x32\n\x07options\x18\x03 \x01(\x0b\x32!.google.protobuf.EnumValueOptions\"\x90\x01\n\x16ServiceDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x36\n\x06method\x18\x02 \x03(\x0b\x32&.google.protobuf.MethodDescriptorProto\x12\x30\n\x07options\x18\x03 \x01(\x0b\x32\x1f.google.protobuf.ServiceOptions\"\xc1\x01\n\x15MethodDescriptorProto\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x12\n\ninput_type\x18\x02 \x01(\t\x12\x13\n\x0boutput_type\x18\x03 \x01(\t\x12/\n\x07options\x18\x04 \x01(\x0b\x32\x1e.google.protobuf.MethodOptions\x12\x1f\n\x10\x63lient_streaming\x18\x05 \x01(\x08:\x05\x66\x61lse\x12\x1f\n\x10server_streaming\x18\x06 \x01(\x08:\x05\x66\x61lse\"\xa5\x06\n\x0b\x46ileOptions\x12\x14\n\x0cjava_package\x18\x01 \x01(\t\x12\x1c\n\x14java_outer_classname\x18\x08 \x01(\t\x12\"\n\x13java_multiple_files\x18\n \x01(\x08:\x05\x66\x61lse\x12)\n\x1djava_generate_equals_and_hash\x18\x14 \x01(\x08\x42\x02\x18\x01\x12%\n\x16java_string_check_utf8\x18\x1b \x01(\x08:\x05\x66\x61lse\x12\x46\n\x0coptimize_for\x18\t \x01(\x0e\x32).google.protobuf.FileOptions.OptimizeMode:\x05SPEED\x12\x12\n\ngo_package\x18\x0b \x01(\t\x12\"\n\x13\x63\x63_generic_services\x18\x10 \x01(\x08:\x05\x66\x61lse\x12$\n\x15java_generic_services\x18\x11 \x01(\x08:\x05\x66\x61lse\x12\"\n\x13py_generic_services\x18\x12 \x01(\x08:\x05\x66\x61lse\x12#\n\x14php_generic_services\x18* \x01(\x08:\x05\x66\x61lse\x12\x19\n\ndeprecated\x18\x17 \x01(\x08:\x05\x66\x61lse\x12\x1e\n\x10\x63\x63_enable_arenas\x18\x1f \x01(\x08:\x04true\x12\x19\n\x11objc_class_prefix\x18$ \x01(\t\x12\x18\n\x10\x63sharp_namespace\x18% \x01(\t\x12\x14\n\x0cswift_prefix\x18\' \x01(\t\x12\x18\n\x10php_class_prefix\x18( \x01(\t\x12\x15\n\rphp_namespace\x18) \x01(\t\x12\x1e\n\x16php_metadata_namespace\x18, \x01(\t\x12\x14\n\x0cruby_package\x18- \x01(\t\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption\":\n\x0cOptimizeMode\x12\t\n\x05SPEED\x10\x01\x12\r\n\tCODE_SIZE\x10\x02\x12\x10\n\x0cLITE_RUNTIME\x10\x03*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08&\x10\'\"\xf2\x01\n\x0eMessageOptions\x12&\n\x17message_set_wire_format\x18\x01 \x01(\x08:\x05\x66\x61lse\x12.\n\x1fno_standard_descriptor_accessor\x18\x02 \x01(\x08:\x05\x66\x61lse\x12\x19\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lse\x12\x11\n\tmap_entry\x18\x07 \x01(\x08\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x08\x10\tJ\x04\x08\t\x10\n\"\x9e\x03\n\x0c\x46ieldOptions\x12:\n\x05\x63type\x18\x01 \x01(\x0e\x32#.google.protobuf.FieldOptions.CType:\x06STRING\x12\x0e\n\x06packed\x18\x02 \x01(\x08\x12?\n\x06jstype\x18\x06 \x01(\x0e\x32$.google.protobuf.FieldOptions.JSType:\tJS_NORMAL\x12\x13\n\x04lazy\x18\x05 \x01(\x08:\x05\x66\x61lse\x12\x19\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lse\x12\x13\n\x04weak\x18\n \x01(\x08:\x05\x66\x61lse\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption\"/\n\x05\x43Type\x12\n\n\x06STRING\x10\x00\x12\x08\n\x04\x43ORD\x10\x01\x12\x10\n\x0cSTRING_PIECE\x10\x02\"5\n\x06JSType\x12\r\n\tJS_NORMAL\x10\x00\x12\r\n\tJS_STRING\x10\x01\x12\r\n\tJS_NUMBER\x10\x02*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x04\x10\x05\"^\n\x0cOneofOptions\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x93\x01\n\x0b\x45numOptions\x12\x13\n\x0b\x61llow_alias\x18\x02 \x01(\x08\x12\x19\n\ndeprecated\x18\x03 \x01(\x08:\x05\x66\x61lse\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02J\x04\x08\x05\x10\x06\"}\n\x10\x45numValueOptions\x12\x19\n\ndeprecated\x18\x01 \x01(\x08:\x05\x66\x61lse\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"{\n\x0eServiceOptions\x12\x19\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lse\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\xad\x02\n\rMethodOptions\x12\x19\n\ndeprecated\x18! \x01(\x08:\x05\x66\x61lse\x12_\n\x11idempotency_level\x18\" \x01(\x0e\x32/.google.protobuf.MethodOptions.IdempotencyLevel:\x13IDEMPOTENCY_UNKNOWN\x12\x43\n\x14uninterpreted_option\x18\xe7\x07 \x03(\x0b\x32$.google.protobuf.UninterpretedOption\"P\n\x10IdempotencyLevel\x12\x17\n\x13IDEMPOTENCY_UNKNOWN\x10\x00\x12\x13\n\x0fNO_SIDE_EFFECTS\x10\x01\x12\x0e\n\nIDEMPOTENT\x10\x02*\t\x08\xe8\x07\x10\x80\x80\x80\x80\x02\"\x9e\x02\n\x13UninterpretedOption\x12;\n\x04name\x18\x02 \x03(\x0b\x32-.google.protobuf.UninterpretedOption.NamePart\x12\x18\n\x10identifier_value\x18\x03 \x01(\t\x12\x1a\n\x12positive_int_value\x18\x04 \x01(\x04\x12\x1a\n\x12negative_int_value\x18\x05 \x01(\x03\x12\x14\n\x0c\x64ouble_value\x18\x06 \x01(\x01\x12\x14\n\x0cstring_value\x18\x07 \x01(\x0c\x12\x17\n\x0f\x61ggregate_value\x18\x08 \x01(\t\x1a\x33\n\x08NamePart\x12\x11\n\tname_part\x18\x01 \x02(\t\x12\x14\n\x0cis_extension\x18\x02 \x02(\x08\"\xd5\x01\n\x0eSourceCodeInfo\x12:\n\x08location\x18\x01 \x03(\x0b\x32(.google.protobuf.SourceCodeInfo.Location\x1a\x86\x01\n\x08Location\x12\x10\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01\x12\x10\n\x04span\x18\x02 \x03(\x05\x42\x02\x10\x01\x12\x18\n\x10leading_comments\x18\x03 \x01(\t\x12\x19\n\x11trailing_comments\x18\x04 \x01(\t\x12!\n\x19leading_detached_comments\x18\x06 \x03(\t\"\xa7\x01\n\x11GeneratedCodeInfo\x12\x41\n\nannotation\x18\x01 \x03(\x0b\x32-.google.protobuf.GeneratedCodeInfo.Annotation\x1aO\n\nAnnotation\x12\x10\n\x04path\x18\x01 \x03(\x05\x42\x02\x10\x01\x12\x13\n\x0bsource_file\x18\x02 \x01(\t\x12\r\n\x05\x62\x65gin\x18\x03 \x01(\x05\x12\x0b\n\x03\x65nd\x18\x04 \x01(\x05\x42~\n\x13\x63om.google.protobufB\x10\x44\x65scriptorProtosH\x01Z-google.golang.org/protobuf/types/descriptorpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1aGoogle.Protobuf.Reflection'
+)
+
+
+
+_FIELDDESCRIPTORPROTO_TYPE = _descriptor.EnumDescriptor(
+  name='Type',
+  full_name='google.protobuf.FieldDescriptorProto.Type',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_DOUBLE', index=0, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FLOAT', index=1, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_INT64', index=2, number=3,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_UINT64', index=3, number=4,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_INT32', index=4, number=5,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FIXED64', index=5, number=6,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FIXED32', index=6, number=7,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_BOOL', index=7, number=8,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_STRING', index=8, number=9,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_GROUP', index=9, number=10,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_MESSAGE', index=10, number=11,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_BYTES', index=11, number=12,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_UINT32', index=12, number=13,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_ENUM', index=13, number=14,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SFIXED32', index=14, number=15,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SFIXED64', index=15, number=16,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SINT32', index=16, number=17,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SINT64', index=17, number=18,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=1740,
+  serialized_end=2050,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDDESCRIPTORPROTO_TYPE)
+
+_FIELDDESCRIPTORPROTO_LABEL = _descriptor.EnumDescriptor(
+  name='Label',
+  full_name='google.protobuf.FieldDescriptorProto.Label',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='LABEL_OPTIONAL', index=0, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='LABEL_REQUIRED', index=1, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='LABEL_REPEATED', index=2, number=3,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=2052,
+  serialized_end=2119,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDDESCRIPTORPROTO_LABEL)
+
+_FILEOPTIONS_OPTIMIZEMODE = _descriptor.EnumDescriptor(
+  name='OptimizeMode',
+  full_name='google.protobuf.FileOptions.OptimizeMode',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='SPEED', index=0, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='CODE_SIZE', index=1, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='LITE_RUNTIME', index=2, number=3,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=3686,
+  serialized_end=3744,
+)
+_sym_db.RegisterEnumDescriptor(_FILEOPTIONS_OPTIMIZEMODE)
+
+_FIELDOPTIONS_CTYPE = _descriptor.EnumDescriptor(
+  name='CType',
+  full_name='google.protobuf.FieldOptions.CType',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='STRING', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='CORD', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='STRING_PIECE', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=4304,
+  serialized_end=4351,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_CTYPE)
+
+_FIELDOPTIONS_JSTYPE = _descriptor.EnumDescriptor(
+  name='JSType',
+  full_name='google.protobuf.FieldOptions.JSType',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='JS_NORMAL', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='JS_STRING', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='JS_NUMBER', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=4353,
+  serialized_end=4406,
+)
+_sym_db.RegisterEnumDescriptor(_FIELDOPTIONS_JSTYPE)
+
+_METHODOPTIONS_IDEMPOTENCYLEVEL = _descriptor.EnumDescriptor(
+  name='IdempotencyLevel',
+  full_name='google.protobuf.MethodOptions.IdempotencyLevel',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='IDEMPOTENCY_UNKNOWN', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='NO_SIDE_EFFECTS', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='IDEMPOTENT', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=5134,
+  serialized_end=5214,
+)
+_sym_db.RegisterEnumDescriptor(_METHODOPTIONS_IDEMPOTENCYLEVEL)
+
+
+_FILEDESCRIPTORSET = _descriptor.Descriptor(
+  name='FileDescriptorSet',
+  full_name='google.protobuf.FileDescriptorSet',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='file', full_name='google.protobuf.FileDescriptorSet.file', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=53,
+  serialized_end=124,
+)
+
+
+_FILEDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='FileDescriptorProto',
+  full_name='google.protobuf.FileDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.FileDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='package', full_name='google.protobuf.FileDescriptorProto.package', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='dependency', full_name='google.protobuf.FileDescriptorProto.dependency', index=2,
+      number=3, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='public_dependency', full_name='google.protobuf.FileDescriptorProto.public_dependency', index=3,
+      number=10, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='weak_dependency', full_name='google.protobuf.FileDescriptorProto.weak_dependency', index=4,
+      number=11, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='message_type', full_name='google.protobuf.FileDescriptorProto.message_type', index=5,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enum_type', full_name='google.protobuf.FileDescriptorProto.enum_type', index=6,
+      number=5, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='service', full_name='google.protobuf.FileDescriptorProto.service', index=7,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='extension', full_name='google.protobuf.FileDescriptorProto.extension', index=8,
+      number=7, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.FileDescriptorProto.options', index=9,
+      number=8, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='source_code_info', full_name='google.protobuf.FileDescriptorProto.source_code_info', index=10,
+      number=9, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='syntax', full_name='google.protobuf.FileDescriptorProto.syntax', index=11,
+      number=12, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=127,
+  serialized_end=602,
+)
+
+
+_DESCRIPTORPROTO_EXTENSIONRANGE = _descriptor.Descriptor(
+  name='ExtensionRange',
+  full_name='google.protobuf.DescriptorProto.ExtensionRange',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='start', full_name='google.protobuf.DescriptorProto.ExtensionRange.start', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='end', full_name='google.protobuf.DescriptorProto.ExtensionRange.end', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.DescriptorProto.ExtensionRange.options', index=2,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1140,
+  serialized_end=1241,
+)
+
+_DESCRIPTORPROTO_RESERVEDRANGE = _descriptor.Descriptor(
+  name='ReservedRange',
+  full_name='google.protobuf.DescriptorProto.ReservedRange',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='start', full_name='google.protobuf.DescriptorProto.ReservedRange.start', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='end', full_name='google.protobuf.DescriptorProto.ReservedRange.end', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1243,
+  serialized_end=1286,
+)
+
+_DESCRIPTORPROTO = _descriptor.Descriptor(
+  name='DescriptorProto',
+  full_name='google.protobuf.DescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.DescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='field', full_name='google.protobuf.DescriptorProto.field', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='extension', full_name='google.protobuf.DescriptorProto.extension', index=2,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='nested_type', full_name='google.protobuf.DescriptorProto.nested_type', index=3,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enum_type', full_name='google.protobuf.DescriptorProto.enum_type', index=4,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='extension_range', full_name='google.protobuf.DescriptorProto.extension_range', index=5,
+      number=5, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_decl', full_name='google.protobuf.DescriptorProto.oneof_decl', index=6,
+      number=8, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.DescriptorProto.options', index=7,
+      number=7, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='reserved_range', full_name='google.protobuf.DescriptorProto.reserved_range', index=8,
+      number=9, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='reserved_name', full_name='google.protobuf.DescriptorProto.reserved_name', index=9,
+      number=10, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_DESCRIPTORPROTO_EXTENSIONRANGE, _DESCRIPTORPROTO_RESERVEDRANGE, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=605,
+  serialized_end=1286,
+)
+
+
+_EXTENSIONRANGEOPTIONS = _descriptor.Descriptor(
+  name='ExtensionRangeOptions',
+  full_name='google.protobuf.ExtensionRangeOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.ExtensionRangeOptions.uninterpreted_option', index=0,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=1288,
+  serialized_end=1391,
+)
+
+
+_FIELDDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='FieldDescriptorProto',
+  full_name='google.protobuf.FieldDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.FieldDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='number', full_name='google.protobuf.FieldDescriptorProto.number', index=1,
+      number=3, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='label', full_name='google.protobuf.FieldDescriptorProto.label', index=2,
+      number=4, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=1,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='type', full_name='google.protobuf.FieldDescriptorProto.type', index=3,
+      number=5, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=1,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='type_name', full_name='google.protobuf.FieldDescriptorProto.type_name', index=4,
+      number=6, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='extendee', full_name='google.protobuf.FieldDescriptorProto.extendee', index=5,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='default_value', full_name='google.protobuf.FieldDescriptorProto.default_value', index=6,
+      number=7, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_index', full_name='google.protobuf.FieldDescriptorProto.oneof_index', index=7,
+      number=9, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='json_name', full_name='google.protobuf.FieldDescriptorProto.json_name', index=8,
+      number=10, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.FieldDescriptorProto.options', index=9,
+      number=8, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='proto3_optional', full_name='google.protobuf.FieldDescriptorProto.proto3_optional', index=10,
+      number=17, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _FIELDDESCRIPTORPROTO_TYPE,
+    _FIELDDESCRIPTORPROTO_LABEL,
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1394,
+  serialized_end=2119,
+)
+
+
+_ONEOFDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='OneofDescriptorProto',
+  full_name='google.protobuf.OneofDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.OneofDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.OneofDescriptorProto.options', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2121,
+  serialized_end=2205,
+)
+
+
+_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE = _descriptor.Descriptor(
+  name='EnumReservedRange',
+  full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='start', full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange.start', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='end', full_name='google.protobuf.EnumDescriptorProto.EnumReservedRange.end', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2453,
+  serialized_end=2500,
+)
+
+_ENUMDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='EnumDescriptorProto',
+  full_name='google.protobuf.EnumDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.EnumDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.EnumDescriptorProto.value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.EnumDescriptorProto.options', index=2,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='reserved_range', full_name='google.protobuf.EnumDescriptorProto.reserved_range', index=3,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='reserved_name', full_name='google.protobuf.EnumDescriptorProto.reserved_name', index=4,
+      number=5, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2208,
+  serialized_end=2500,
+)
+
+
+_ENUMVALUEDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='EnumValueDescriptorProto',
+  full_name='google.protobuf.EnumValueDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.EnumValueDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='number', full_name='google.protobuf.EnumValueDescriptorProto.number', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.EnumValueDescriptorProto.options', index=2,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2502,
+  serialized_end=2610,
+)
+
+
+_SERVICEDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='ServiceDescriptorProto',
+  full_name='google.protobuf.ServiceDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.ServiceDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='method', full_name='google.protobuf.ServiceDescriptorProto.method', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.ServiceDescriptorProto.options', index=2,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2613,
+  serialized_end=2757,
+)
+
+
+_METHODDESCRIPTORPROTO = _descriptor.Descriptor(
+  name='MethodDescriptorProto',
+  full_name='google.protobuf.MethodDescriptorProto',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.MethodDescriptorProto.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='input_type', full_name='google.protobuf.MethodDescriptorProto.input_type', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='output_type', full_name='google.protobuf.MethodDescriptorProto.output_type', index=2,
+      number=3, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.MethodDescriptorProto.options', index=3,
+      number=4, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='client_streaming', full_name='google.protobuf.MethodDescriptorProto.client_streaming', index=4,
+      number=5, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='server_streaming', full_name='google.protobuf.MethodDescriptorProto.server_streaming', index=5,
+      number=6, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2760,
+  serialized_end=2953,
+)
+
+
+_FILEOPTIONS = _descriptor.Descriptor(
+  name='FileOptions',
+  full_name='google.protobuf.FileOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='java_package', full_name='google.protobuf.FileOptions.java_package', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='java_outer_classname', full_name='google.protobuf.FileOptions.java_outer_classname', index=1,
+      number=8, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='java_multiple_files', full_name='google.protobuf.FileOptions.java_multiple_files', index=2,
+      number=10, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='java_generate_equals_and_hash', full_name='google.protobuf.FileOptions.java_generate_equals_and_hash', index=3,
+      number=20, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='java_string_check_utf8', full_name='google.protobuf.FileOptions.java_string_check_utf8', index=4,
+      number=27, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='optimize_for', full_name='google.protobuf.FileOptions.optimize_for', index=5,
+      number=9, type=14, cpp_type=8, label=1,
+      has_default_value=True, default_value=1,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='go_package', full_name='google.protobuf.FileOptions.go_package', index=6,
+      number=11, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='cc_generic_services', full_name='google.protobuf.FileOptions.cc_generic_services', index=7,
+      number=16, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='java_generic_services', full_name='google.protobuf.FileOptions.java_generic_services', index=8,
+      number=17, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='py_generic_services', full_name='google.protobuf.FileOptions.py_generic_services', index=9,
+      number=18, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='php_generic_services', full_name='google.protobuf.FileOptions.php_generic_services', index=10,
+      number=42, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.FileOptions.deprecated', index=11,
+      number=23, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='cc_enable_arenas', full_name='google.protobuf.FileOptions.cc_enable_arenas', index=12,
+      number=31, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=True,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='objc_class_prefix', full_name='google.protobuf.FileOptions.objc_class_prefix', index=13,
+      number=36, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='csharp_namespace', full_name='google.protobuf.FileOptions.csharp_namespace', index=14,
+      number=37, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='swift_prefix', full_name='google.protobuf.FileOptions.swift_prefix', index=15,
+      number=39, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='php_class_prefix', full_name='google.protobuf.FileOptions.php_class_prefix', index=16,
+      number=40, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='php_namespace', full_name='google.protobuf.FileOptions.php_namespace', index=17,
+      number=41, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='php_metadata_namespace', full_name='google.protobuf.FileOptions.php_metadata_namespace', index=18,
+      number=44, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='ruby_package', full_name='google.protobuf.FileOptions.ruby_package', index=19,
+      number=45, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.FileOptions.uninterpreted_option', index=20,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _FILEOPTIONS_OPTIMIZEMODE,
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=2956,
+  serialized_end=3761,
+)
+
+
+_MESSAGEOPTIONS = _descriptor.Descriptor(
+  name='MessageOptions',
+  full_name='google.protobuf.MessageOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='message_set_wire_format', full_name='google.protobuf.MessageOptions.message_set_wire_format', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='no_standard_descriptor_accessor', full_name='google.protobuf.MessageOptions.no_standard_descriptor_accessor', index=1,
+      number=2, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.MessageOptions.deprecated', index=2,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='map_entry', full_name='google.protobuf.MessageOptions.map_entry', index=3,
+      number=7, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.MessageOptions.uninterpreted_option', index=4,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=3764,
+  serialized_end=4006,
+)
+
+
+_FIELDOPTIONS = _descriptor.Descriptor(
+  name='FieldOptions',
+  full_name='google.protobuf.FieldOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='ctype', full_name='google.protobuf.FieldOptions.ctype', index=0,
+      number=1, type=14, cpp_type=8, label=1,
+      has_default_value=True, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='packed', full_name='google.protobuf.FieldOptions.packed', index=1,
+      number=2, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='jstype', full_name='google.protobuf.FieldOptions.jstype', index=2,
+      number=6, type=14, cpp_type=8, label=1,
+      has_default_value=True, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='lazy', full_name='google.protobuf.FieldOptions.lazy', index=3,
+      number=5, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.FieldOptions.deprecated', index=4,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='weak', full_name='google.protobuf.FieldOptions.weak', index=5,
+      number=10, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.FieldOptions.uninterpreted_option', index=6,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _FIELDOPTIONS_CTYPE,
+    _FIELDOPTIONS_JSTYPE,
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4009,
+  serialized_end=4423,
+)
+
+
+_ONEOFOPTIONS = _descriptor.Descriptor(
+  name='OneofOptions',
+  full_name='google.protobuf.OneofOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.OneofOptions.uninterpreted_option', index=0,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4425,
+  serialized_end=4519,
+)
+
+
+_ENUMOPTIONS = _descriptor.Descriptor(
+  name='EnumOptions',
+  full_name='google.protobuf.EnumOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='allow_alias', full_name='google.protobuf.EnumOptions.allow_alias', index=0,
+      number=2, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.EnumOptions.deprecated', index=1,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.EnumOptions.uninterpreted_option', index=2,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4522,
+  serialized_end=4669,
+)
+
+
+_ENUMVALUEOPTIONS = _descriptor.Descriptor(
+  name='EnumValueOptions',
+  full_name='google.protobuf.EnumValueOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.EnumValueOptions.deprecated', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.EnumValueOptions.uninterpreted_option', index=1,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4671,
+  serialized_end=4796,
+)
+
+
+_SERVICEOPTIONS = _descriptor.Descriptor(
+  name='ServiceOptions',
+  full_name='google.protobuf.ServiceOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.ServiceOptions.deprecated', index=0,
+      number=33, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.ServiceOptions.uninterpreted_option', index=1,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4798,
+  serialized_end=4921,
+)
+
+
+_METHODOPTIONS = _descriptor.Descriptor(
+  name='MethodOptions',
+  full_name='google.protobuf.MethodOptions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='deprecated', full_name='google.protobuf.MethodOptions.deprecated', index=0,
+      number=33, type=8, cpp_type=7, label=1,
+      has_default_value=True, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='idempotency_level', full_name='google.protobuf.MethodOptions.idempotency_level', index=1,
+      number=34, type=14, cpp_type=8, label=1,
+      has_default_value=True, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uninterpreted_option', full_name='google.protobuf.MethodOptions.uninterpreted_option', index=2,
+      number=999, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _METHODOPTIONS_IDEMPOTENCYLEVEL,
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(1000, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=4924,
+  serialized_end=5225,
+)
+
+
+_UNINTERPRETEDOPTION_NAMEPART = _descriptor.Descriptor(
+  name='NamePart',
+  full_name='google.protobuf.UninterpretedOption.NamePart',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name_part', full_name='google.protobuf.UninterpretedOption.NamePart.name_part', index=0,
+      number=1, type=9, cpp_type=9, label=2,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='is_extension', full_name='google.protobuf.UninterpretedOption.NamePart.is_extension', index=1,
+      number=2, type=8, cpp_type=7, label=2,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5463,
+  serialized_end=5514,
+)
+
+_UNINTERPRETEDOPTION = _descriptor.Descriptor(
+  name='UninterpretedOption',
+  full_name='google.protobuf.UninterpretedOption',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.UninterpretedOption.name', index=0,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='identifier_value', full_name='google.protobuf.UninterpretedOption.identifier_value', index=1,
+      number=3, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='positive_int_value', full_name='google.protobuf.UninterpretedOption.positive_int_value', index=2,
+      number=4, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='negative_int_value', full_name='google.protobuf.UninterpretedOption.negative_int_value', index=3,
+      number=5, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='double_value', full_name='google.protobuf.UninterpretedOption.double_value', index=4,
+      number=6, type=1, cpp_type=5, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_value', full_name='google.protobuf.UninterpretedOption.string_value', index=5,
+      number=7, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='aggregate_value', full_name='google.protobuf.UninterpretedOption.aggregate_value', index=6,
+      number=8, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_UNINTERPRETEDOPTION_NAMEPART, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5228,
+  serialized_end=5514,
+)
+
+
+_SOURCECODEINFO_LOCATION = _descriptor.Descriptor(
+  name='Location',
+  full_name='google.protobuf.SourceCodeInfo.Location',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='path', full_name='google.protobuf.SourceCodeInfo.Location.path', index=0,
+      number=1, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='span', full_name='google.protobuf.SourceCodeInfo.Location.span', index=1,
+      number=2, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='leading_comments', full_name='google.protobuf.SourceCodeInfo.Location.leading_comments', index=2,
+      number=3, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='trailing_comments', full_name='google.protobuf.SourceCodeInfo.Location.trailing_comments', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='leading_detached_comments', full_name='google.protobuf.SourceCodeInfo.Location.leading_detached_comments', index=4,
+      number=6, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5596,
+  serialized_end=5730,
+)
+
+_SOURCECODEINFO = _descriptor.Descriptor(
+  name='SourceCodeInfo',
+  full_name='google.protobuf.SourceCodeInfo',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='location', full_name='google.protobuf.SourceCodeInfo.location', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_SOURCECODEINFO_LOCATION, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5517,
+  serialized_end=5730,
+)
+
+
+_GENERATEDCODEINFO_ANNOTATION = _descriptor.Descriptor(
+  name='Annotation',
+  full_name='google.protobuf.GeneratedCodeInfo.Annotation',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='path', full_name='google.protobuf.GeneratedCodeInfo.Annotation.path', index=0,
+      number=1, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='source_file', full_name='google.protobuf.GeneratedCodeInfo.Annotation.source_file', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='begin', full_name='google.protobuf.GeneratedCodeInfo.Annotation.begin', index=2,
+      number=3, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='end', full_name='google.protobuf.GeneratedCodeInfo.Annotation.end', index=3,
+      number=4, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5821,
+  serialized_end=5900,
+)
+
+_GENERATEDCODEINFO = _descriptor.Descriptor(
+  name='GeneratedCodeInfo',
+  full_name='google.protobuf.GeneratedCodeInfo',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='annotation', full_name='google.protobuf.GeneratedCodeInfo.annotation', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_GENERATEDCODEINFO_ANNOTATION, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=5733,
+  serialized_end=5900,
+)
+
+_FILEDESCRIPTORSET.fields_by_name['file'].message_type = _FILEDESCRIPTORPROTO
+_FILEDESCRIPTORPROTO.fields_by_name['message_type'].message_type = _DESCRIPTORPROTO
+_FILEDESCRIPTORPROTO.fields_by_name['enum_type'].message_type = _ENUMDESCRIPTORPROTO
+_FILEDESCRIPTORPROTO.fields_by_name['service'].message_type = _SERVICEDESCRIPTORPROTO
+_FILEDESCRIPTORPROTO.fields_by_name['extension'].message_type = _FIELDDESCRIPTORPROTO
+_FILEDESCRIPTORPROTO.fields_by_name['options'].message_type = _FILEOPTIONS
+_FILEDESCRIPTORPROTO.fields_by_name['source_code_info'].message_type = _SOURCECODEINFO
+_DESCRIPTORPROTO_EXTENSIONRANGE.fields_by_name['options'].message_type = _EXTENSIONRANGEOPTIONS
+_DESCRIPTORPROTO_EXTENSIONRANGE.containing_type = _DESCRIPTORPROTO
+_DESCRIPTORPROTO_RESERVEDRANGE.containing_type = _DESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['field'].message_type = _FIELDDESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['extension'].message_type = _FIELDDESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['nested_type'].message_type = _DESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['enum_type'].message_type = _ENUMDESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['extension_range'].message_type = _DESCRIPTORPROTO_EXTENSIONRANGE
+_DESCRIPTORPROTO.fields_by_name['oneof_decl'].message_type = _ONEOFDESCRIPTORPROTO
+_DESCRIPTORPROTO.fields_by_name['options'].message_type = _MESSAGEOPTIONS
+_DESCRIPTORPROTO.fields_by_name['reserved_range'].message_type = _DESCRIPTORPROTO_RESERVEDRANGE
+_EXTENSIONRANGEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_FIELDDESCRIPTORPROTO.fields_by_name['label'].enum_type = _FIELDDESCRIPTORPROTO_LABEL
+_FIELDDESCRIPTORPROTO.fields_by_name['type'].enum_type = _FIELDDESCRIPTORPROTO_TYPE
+_FIELDDESCRIPTORPROTO.fields_by_name['options'].message_type = _FIELDOPTIONS
+_FIELDDESCRIPTORPROTO_TYPE.containing_type = _FIELDDESCRIPTORPROTO
+_FIELDDESCRIPTORPROTO_LABEL.containing_type = _FIELDDESCRIPTORPROTO
+_ONEOFDESCRIPTORPROTO.fields_by_name['options'].message_type = _ONEOFOPTIONS
+_ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE.containing_type = _ENUMDESCRIPTORPROTO
+_ENUMDESCRIPTORPROTO.fields_by_name['value'].message_type = _ENUMVALUEDESCRIPTORPROTO
+_ENUMDESCRIPTORPROTO.fields_by_name['options'].message_type = _ENUMOPTIONS
+_ENUMDESCRIPTORPROTO.fields_by_name['reserved_range'].message_type = _ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE
+_ENUMVALUEDESCRIPTORPROTO.fields_by_name['options'].message_type = _ENUMVALUEOPTIONS
+_SERVICEDESCRIPTORPROTO.fields_by_name['method'].message_type = _METHODDESCRIPTORPROTO
+_SERVICEDESCRIPTORPROTO.fields_by_name['options'].message_type = _SERVICEOPTIONS
+_METHODDESCRIPTORPROTO.fields_by_name['options'].message_type = _METHODOPTIONS
+_FILEOPTIONS.fields_by_name['optimize_for'].enum_type = _FILEOPTIONS_OPTIMIZEMODE
+_FILEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_FILEOPTIONS_OPTIMIZEMODE.containing_type = _FILEOPTIONS
+_MESSAGEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_FIELDOPTIONS.fields_by_name['ctype'].enum_type = _FIELDOPTIONS_CTYPE
+_FIELDOPTIONS.fields_by_name['jstype'].enum_type = _FIELDOPTIONS_JSTYPE
+_FIELDOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_FIELDOPTIONS_CTYPE.containing_type = _FIELDOPTIONS
+_FIELDOPTIONS_JSTYPE.containing_type = _FIELDOPTIONS
+_ONEOFOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_ENUMOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_ENUMVALUEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_SERVICEOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_METHODOPTIONS.fields_by_name['idempotency_level'].enum_type = _METHODOPTIONS_IDEMPOTENCYLEVEL
+_METHODOPTIONS.fields_by_name['uninterpreted_option'].message_type = _UNINTERPRETEDOPTION
+_METHODOPTIONS_IDEMPOTENCYLEVEL.containing_type = _METHODOPTIONS
+_UNINTERPRETEDOPTION_NAMEPART.containing_type = _UNINTERPRETEDOPTION
+_UNINTERPRETEDOPTION.fields_by_name['name'].message_type = _UNINTERPRETEDOPTION_NAMEPART
+_SOURCECODEINFO_LOCATION.containing_type = _SOURCECODEINFO
+_SOURCECODEINFO.fields_by_name['location'].message_type = _SOURCECODEINFO_LOCATION
+_GENERATEDCODEINFO_ANNOTATION.containing_type = _GENERATEDCODEINFO
+_GENERATEDCODEINFO.fields_by_name['annotation'].message_type = _GENERATEDCODEINFO_ANNOTATION
+DESCRIPTOR.message_types_by_name['FileDescriptorSet'] = _FILEDESCRIPTORSET
+DESCRIPTOR.message_types_by_name['FileDescriptorProto'] = _FILEDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['DescriptorProto'] = _DESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['ExtensionRangeOptions'] = _EXTENSIONRANGEOPTIONS
+DESCRIPTOR.message_types_by_name['FieldDescriptorProto'] = _FIELDDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['OneofDescriptorProto'] = _ONEOFDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['EnumDescriptorProto'] = _ENUMDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['EnumValueDescriptorProto'] = _ENUMVALUEDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['ServiceDescriptorProto'] = _SERVICEDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['MethodDescriptorProto'] = _METHODDESCRIPTORPROTO
+DESCRIPTOR.message_types_by_name['FileOptions'] = _FILEOPTIONS
+DESCRIPTOR.message_types_by_name['MessageOptions'] = _MESSAGEOPTIONS
+DESCRIPTOR.message_types_by_name['FieldOptions'] = _FIELDOPTIONS
+DESCRIPTOR.message_types_by_name['OneofOptions'] = _ONEOFOPTIONS
+DESCRIPTOR.message_types_by_name['EnumOptions'] = _ENUMOPTIONS
+DESCRIPTOR.message_types_by_name['EnumValueOptions'] = _ENUMVALUEOPTIONS
+DESCRIPTOR.message_types_by_name['ServiceOptions'] = _SERVICEOPTIONS
+DESCRIPTOR.message_types_by_name['MethodOptions'] = _METHODOPTIONS
+DESCRIPTOR.message_types_by_name['UninterpretedOption'] = _UNINTERPRETEDOPTION
+DESCRIPTOR.message_types_by_name['SourceCodeInfo'] = _SOURCECODEINFO
+DESCRIPTOR.message_types_by_name['GeneratedCodeInfo'] = _GENERATEDCODEINFO
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+FileDescriptorSet = _reflection.GeneratedProtocolMessageType('FileDescriptorSet', (_message.Message,), {
+  'DESCRIPTOR' : _FILEDESCRIPTORSET,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FileDescriptorSet)
+  })
+_sym_db.RegisterMessage(FileDescriptorSet)
+
+FileDescriptorProto = _reflection.GeneratedProtocolMessageType('FileDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _FILEDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FileDescriptorProto)
+  })
+_sym_db.RegisterMessage(FileDescriptorProto)
+
+DescriptorProto = _reflection.GeneratedProtocolMessageType('DescriptorProto', (_message.Message,), {
+
+  'ExtensionRange' : _reflection.GeneratedProtocolMessageType('ExtensionRange', (_message.Message,), {
+    'DESCRIPTOR' : _DESCRIPTORPROTO_EXTENSIONRANGE,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.DescriptorProto.ExtensionRange)
+    })
+  ,
+
+  'ReservedRange' : _reflection.GeneratedProtocolMessageType('ReservedRange', (_message.Message,), {
+    'DESCRIPTOR' : _DESCRIPTORPROTO_RESERVEDRANGE,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.DescriptorProto.ReservedRange)
+    })
+  ,
+  'DESCRIPTOR' : _DESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.DescriptorProto)
+  })
+_sym_db.RegisterMessage(DescriptorProto)
+_sym_db.RegisterMessage(DescriptorProto.ExtensionRange)
+_sym_db.RegisterMessage(DescriptorProto.ReservedRange)
+
+ExtensionRangeOptions = _reflection.GeneratedProtocolMessageType('ExtensionRangeOptions', (_message.Message,), {
+  'DESCRIPTOR' : _EXTENSIONRANGEOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.ExtensionRangeOptions)
+  })
+_sym_db.RegisterMessage(ExtensionRangeOptions)
+
+FieldDescriptorProto = _reflection.GeneratedProtocolMessageType('FieldDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _FIELDDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FieldDescriptorProto)
+  })
+_sym_db.RegisterMessage(FieldDescriptorProto)
+
+OneofDescriptorProto = _reflection.GeneratedProtocolMessageType('OneofDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _ONEOFDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.OneofDescriptorProto)
+  })
+_sym_db.RegisterMessage(OneofDescriptorProto)
+
+EnumDescriptorProto = _reflection.GeneratedProtocolMessageType('EnumDescriptorProto', (_message.Message,), {
+
+  'EnumReservedRange' : _reflection.GeneratedProtocolMessageType('EnumReservedRange', (_message.Message,), {
+    'DESCRIPTOR' : _ENUMDESCRIPTORPROTO_ENUMRESERVEDRANGE,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.EnumDescriptorProto.EnumReservedRange)
+    })
+  ,
+  'DESCRIPTOR' : _ENUMDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.EnumDescriptorProto)
+  })
+_sym_db.RegisterMessage(EnumDescriptorProto)
+_sym_db.RegisterMessage(EnumDescriptorProto.EnumReservedRange)
+
+EnumValueDescriptorProto = _reflection.GeneratedProtocolMessageType('EnumValueDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _ENUMVALUEDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.EnumValueDescriptorProto)
+  })
+_sym_db.RegisterMessage(EnumValueDescriptorProto)
+
+ServiceDescriptorProto = _reflection.GeneratedProtocolMessageType('ServiceDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _SERVICEDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.ServiceDescriptorProto)
+  })
+_sym_db.RegisterMessage(ServiceDescriptorProto)
+
+MethodDescriptorProto = _reflection.GeneratedProtocolMessageType('MethodDescriptorProto', (_message.Message,), {
+  'DESCRIPTOR' : _METHODDESCRIPTORPROTO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.MethodDescriptorProto)
+  })
+_sym_db.RegisterMessage(MethodDescriptorProto)
+
+FileOptions = _reflection.GeneratedProtocolMessageType('FileOptions', (_message.Message,), {
+  'DESCRIPTOR' : _FILEOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FileOptions)
+  })
+_sym_db.RegisterMessage(FileOptions)
+
+MessageOptions = _reflection.GeneratedProtocolMessageType('MessageOptions', (_message.Message,), {
+  'DESCRIPTOR' : _MESSAGEOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.MessageOptions)
+  })
+_sym_db.RegisterMessage(MessageOptions)
+
+FieldOptions = _reflection.GeneratedProtocolMessageType('FieldOptions', (_message.Message,), {
+  'DESCRIPTOR' : _FIELDOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FieldOptions)
+  })
+_sym_db.RegisterMessage(FieldOptions)
+
+OneofOptions = _reflection.GeneratedProtocolMessageType('OneofOptions', (_message.Message,), {
+  'DESCRIPTOR' : _ONEOFOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.OneofOptions)
+  })
+_sym_db.RegisterMessage(OneofOptions)
+
+EnumOptions = _reflection.GeneratedProtocolMessageType('EnumOptions', (_message.Message,), {
+  'DESCRIPTOR' : _ENUMOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.EnumOptions)
+  })
+_sym_db.RegisterMessage(EnumOptions)
+
+EnumValueOptions = _reflection.GeneratedProtocolMessageType('EnumValueOptions', (_message.Message,), {
+  'DESCRIPTOR' : _ENUMVALUEOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.EnumValueOptions)
+  })
+_sym_db.RegisterMessage(EnumValueOptions)
+
+ServiceOptions = _reflection.GeneratedProtocolMessageType('ServiceOptions', (_message.Message,), {
+  'DESCRIPTOR' : _SERVICEOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.ServiceOptions)
+  })
+_sym_db.RegisterMessage(ServiceOptions)
+
+MethodOptions = _reflection.GeneratedProtocolMessageType('MethodOptions', (_message.Message,), {
+  'DESCRIPTOR' : _METHODOPTIONS,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.MethodOptions)
+  })
+_sym_db.RegisterMessage(MethodOptions)
+
+UninterpretedOption = _reflection.GeneratedProtocolMessageType('UninterpretedOption', (_message.Message,), {
+
+  'NamePart' : _reflection.GeneratedProtocolMessageType('NamePart', (_message.Message,), {
+    'DESCRIPTOR' : _UNINTERPRETEDOPTION_NAMEPART,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.UninterpretedOption.NamePart)
+    })
+  ,
+  'DESCRIPTOR' : _UNINTERPRETEDOPTION,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.UninterpretedOption)
+  })
+_sym_db.RegisterMessage(UninterpretedOption)
+_sym_db.RegisterMessage(UninterpretedOption.NamePart)
+
+SourceCodeInfo = _reflection.GeneratedProtocolMessageType('SourceCodeInfo', (_message.Message,), {
+
+  'Location' : _reflection.GeneratedProtocolMessageType('Location', (_message.Message,), {
+    'DESCRIPTOR' : _SOURCECODEINFO_LOCATION,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.SourceCodeInfo.Location)
+    })
+  ,
+  'DESCRIPTOR' : _SOURCECODEINFO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.SourceCodeInfo)
+  })
+_sym_db.RegisterMessage(SourceCodeInfo)
+_sym_db.RegisterMessage(SourceCodeInfo.Location)
+
+GeneratedCodeInfo = _reflection.GeneratedProtocolMessageType('GeneratedCodeInfo', (_message.Message,), {
+
+  'Annotation' : _reflection.GeneratedProtocolMessageType('Annotation', (_message.Message,), {
+    'DESCRIPTOR' : _GENERATEDCODEINFO_ANNOTATION,
+    '__module__' : 'google.protobuf.descriptor_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.GeneratedCodeInfo.Annotation)
+    })
+  ,
+  'DESCRIPTOR' : _GENERATEDCODEINFO,
+  '__module__' : 'google.protobuf.descriptor_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.GeneratedCodeInfo)
+  })
+_sym_db.RegisterMessage(GeneratedCodeInfo)
+_sym_db.RegisterMessage(GeneratedCodeInfo.Annotation)
+
+
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pool.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..de9100b09ca590d229e3fd8518e98664bd4e7205
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/descriptor_pool.py
@@ -0,0 +1,1271 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Provides DescriptorPool to use as a container for proto2 descriptors.
+
+The DescriptorPool is used in conjection with a DescriptorDatabase to maintain
+a collection of protocol buffer descriptors for use when dynamically creating
+message types at runtime.
+
+For most applications protocol buffers should be used via modules generated by
+the protocol buffer compiler tool. This should only be used when the type of
+protocol buffers used in an application or library cannot be predetermined.
+
+Below is a straightforward example on how to use this class::
+
+  pool = DescriptorPool()
+  file_descriptor_protos = [ ... ]
+  for file_descriptor_proto in file_descriptor_protos:
+    pool.Add(file_descriptor_proto)
+  my_message_descriptor = pool.FindMessageTypeByName('some.package.MessageType')
+
+The message descriptor can be used in conjunction with the message_factory
+module in order to create a protocol buffer class that can be encoded and
+decoded.
+
+If you want to get a Python class for the specified proto, use the
+helper functions inside google.protobuf.message_factory
+directly instead of this class.
+"""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+import collections
+import warnings
+
+from google.protobuf import descriptor
+from google.protobuf import descriptor_database
+from google.protobuf import text_encoding
+
+
+_USE_C_DESCRIPTORS = descriptor._USE_C_DESCRIPTORS  # pylint: disable=protected-access
+
+
+def _Deprecated(func):
+  """Mark functions as deprecated."""
+
+  def NewFunc(*args, **kwargs):
+    warnings.warn(
+        'Call to deprecated function %s(). Note: Do add unlinked descriptors '
+        'to descriptor_pool is wrong. Use Add() or AddSerializedFile() '
+        'instead.' % func.__name__,
+        category=DeprecationWarning)
+    return func(*args, **kwargs)
+  NewFunc.__name__ = func.__name__
+  NewFunc.__doc__ = func.__doc__
+  NewFunc.__dict__.update(func.__dict__)
+  return NewFunc
+
+
+def _NormalizeFullyQualifiedName(name):
+  """Remove leading period from fully-qualified type name.
+
+  Due to b/13860351 in descriptor_database.py, types in the root namespace are
+  generated with a leading period. This function removes that prefix.
+
+  Args:
+    name (str): The fully-qualified symbol name.
+
+  Returns:
+    str: The normalized fully-qualified symbol name.
+  """
+  return name.lstrip('.')
+
+
+def _OptionsOrNone(descriptor_proto):
+  """Returns the value of the field `options`, or None if it is not set."""
+  if descriptor_proto.HasField('options'):
+    return descriptor_proto.options
+  else:
+    return None
+
+
+def _IsMessageSetExtension(field):
+  return (field.is_extension and
+          field.containing_type.has_options and
+          field.containing_type.GetOptions().message_set_wire_format and
+          field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.label == descriptor.FieldDescriptor.LABEL_OPTIONAL)
+
+
+class DescriptorPool(object):
+  """A collection of protobufs dynamically constructed by descriptor protos."""
+
+  if _USE_C_DESCRIPTORS:
+
+    def __new__(cls, descriptor_db=None):
+      # pylint: disable=protected-access
+      return descriptor._message.DescriptorPool(descriptor_db)
+
+  def __init__(self, descriptor_db=None):
+    """Initializes a Pool of proto buffs.
+
+    The descriptor_db argument to the constructor is provided to allow
+    specialized file descriptor proto lookup code to be triggered on demand. An
+    example would be an implementation which will read and compile a file
+    specified in a call to FindFileByName() and not require the call to Add()
+    at all. Results from this database will be cached internally here as well.
+
+    Args:
+      descriptor_db: A secondary source of file descriptors.
+    """
+
+    self._internal_db = descriptor_database.DescriptorDatabase()
+    self._descriptor_db = descriptor_db
+    self._descriptors = {}
+    self._enum_descriptors = {}
+    self._service_descriptors = {}
+    self._file_descriptors = {}
+    self._toplevel_extensions = {}
+    # TODO(jieluo): Remove _file_desc_by_toplevel_extension after
+    # maybe year 2020 for compatibility issue (with 3.4.1 only).
+    self._file_desc_by_toplevel_extension = {}
+    self._top_enum_values = {}
+    # We store extensions in two two-level mappings: The first key is the
+    # descriptor of the message being extended, the second key is the extension
+    # full name or its tag number.
+    self._extensions_by_name = collections.defaultdict(dict)
+    self._extensions_by_number = collections.defaultdict(dict)
+
+  def _CheckConflictRegister(self, desc, desc_name, file_name):
+    """Check if the descriptor name conflicts with another of the same name.
+
+    Args:
+      desc: Descriptor of a message, enum, service, extension or enum value.
+      desc_name (str): the full name of desc.
+      file_name (str): The file name of descriptor.
+    """
+    for register, descriptor_type in [
+        (self._descriptors, descriptor.Descriptor),
+        (self._enum_descriptors, descriptor.EnumDescriptor),
+        (self._service_descriptors, descriptor.ServiceDescriptor),
+        (self._toplevel_extensions, descriptor.FieldDescriptor),
+        (self._top_enum_values, descriptor.EnumValueDescriptor)]:
+      if desc_name in register:
+        old_desc = register[desc_name]
+        if isinstance(old_desc, descriptor.EnumValueDescriptor):
+          old_file = old_desc.type.file.name
+        else:
+          old_file = old_desc.file.name
+
+        if not isinstance(desc, descriptor_type) or (
+            old_file != file_name):
+          error_msg = ('Conflict register for file "' + file_name +
+                       '": ' + desc_name +
+                       ' is already defined in file "' +
+                       old_file + '". Please fix the conflict by adding '
+                       'package name on the proto file, or use different '
+                       'name for the duplication.')
+          if isinstance(desc, descriptor.EnumValueDescriptor):
+            error_msg += ('\nNote: enum values appear as '
+                          'siblings of the enum type instead of '
+                          'children of it.')
+
+          raise TypeError(error_msg)
+
+        return
+
+  def Add(self, file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this pool.
+
+    Args:
+      file_desc_proto (FileDescriptorProto): The file descriptor to add.
+    """
+
+    self._internal_db.Add(file_desc_proto)
+
+  def AddSerializedFile(self, serialized_file_desc_proto):
+    """Adds the FileDescriptorProto and its types to this pool.
+
+    Args:
+      serialized_file_desc_proto (bytes): A bytes string, serialization of the
+        :class:`FileDescriptorProto` to add.
+    """
+
+    # pylint: disable=g-import-not-at-top
+    from google.protobuf import descriptor_pb2
+    file_desc_proto = descriptor_pb2.FileDescriptorProto.FromString(
+        serialized_file_desc_proto)
+    self.Add(file_desc_proto)
+
+  # Add Descriptor to descriptor pool is dreprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddDescriptor(self, desc):
+    self._AddDescriptor(desc)
+
+  # Never call this method. It is for internal usage only.
+  def _AddDescriptor(self, desc):
+    """Adds a Descriptor to the pool, non-recursively.
+
+    If the Descriptor contains nested messages or enums, the caller must
+    explicitly register them. This method also registers the FileDescriptor
+    associated with the message.
+
+    Args:
+      desc: A Descriptor.
+    """
+    if not isinstance(desc, descriptor.Descriptor):
+      raise TypeError('Expected instance of descriptor.Descriptor.')
+
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+
+    self._descriptors[desc.full_name] = desc
+    self._AddFileDescriptor(desc.file)
+
+  # Add EnumDescriptor to descriptor pool is dreprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddEnumDescriptor(self, enum_desc):
+    self._AddEnumDescriptor(enum_desc)
+
+  # Never call this method. It is for internal usage only.
+  def _AddEnumDescriptor(self, enum_desc):
+    """Adds an EnumDescriptor to the pool.
+
+    This method also registers the FileDescriptor associated with the enum.
+
+    Args:
+      enum_desc: An EnumDescriptor.
+    """
+
+    if not isinstance(enum_desc, descriptor.EnumDescriptor):
+      raise TypeError('Expected instance of descriptor.EnumDescriptor.')
+
+    file_name = enum_desc.file.name
+    self._CheckConflictRegister(enum_desc, enum_desc.full_name, file_name)
+    self._enum_descriptors[enum_desc.full_name] = enum_desc
+
+    # Top enum values need to be indexed.
+    # Count the number of dots to see whether the enum is toplevel or nested
+    # in a message. We cannot use enum_desc.containing_type at this stage.
+    if enum_desc.file.package:
+      top_level = (enum_desc.full_name.count('.')
+                   - enum_desc.file.package.count('.') == 1)
+    else:
+      top_level = enum_desc.full_name.count('.') == 0
+    if top_level:
+      file_name = enum_desc.file.name
+      package = enum_desc.file.package
+      for enum_value in enum_desc.values:
+        full_name = _NormalizeFullyQualifiedName(
+            '.'.join((package, enum_value.name)))
+        self._CheckConflictRegister(enum_value, full_name, file_name)
+        self._top_enum_values[full_name] = enum_value
+    self._AddFileDescriptor(enum_desc.file)
+
+  # Add ServiceDescriptor to descriptor pool is dreprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddServiceDescriptor(self, service_desc):
+    self._AddServiceDescriptor(service_desc)
+
+  # Never call this method. It is for internal usage only.
+  def _AddServiceDescriptor(self, service_desc):
+    """Adds a ServiceDescriptor to the pool.
+
+    Args:
+      service_desc: A ServiceDescriptor.
+    """
+
+    if not isinstance(service_desc, descriptor.ServiceDescriptor):
+      raise TypeError('Expected instance of descriptor.ServiceDescriptor.')
+
+    self._CheckConflictRegister(service_desc, service_desc.full_name,
+                                service_desc.file.name)
+    self._service_descriptors[service_desc.full_name] = service_desc
+
+  # Add ExtensionDescriptor to descriptor pool is dreprecated. Please use Add()
+  # or AddSerializedFile() to add a FileDescriptorProto instead.
+  @_Deprecated
+  def AddExtensionDescriptor(self, extension):
+    self._AddExtensionDescriptor(extension)
+
+  # Never call this method. It is for internal usage only.
+  def _AddExtensionDescriptor(self, extension):
+    """Adds a FieldDescriptor describing an extension to the pool.
+
+    Args:
+      extension: A FieldDescriptor.
+
+    Raises:
+      AssertionError: when another extension with the same number extends the
+        same message.
+      TypeError: when the specified extension is not a
+        descriptor.FieldDescriptor.
+    """
+    if not (isinstance(extension, descriptor.FieldDescriptor) and
+            extension.is_extension):
+      raise TypeError('Expected an extension descriptor.')
+
+    if extension.extension_scope is None:
+      self._toplevel_extensions[extension.full_name] = extension
+
+    try:
+      existing_desc = self._extensions_by_number[
+          extension.containing_type][extension.number]
+    except KeyError:
+      pass
+    else:
+      if extension is not existing_desc:
+        raise AssertionError(
+            'Extensions "%s" and "%s" both try to extend message type "%s" '
+            'with field number %d.' %
+            (extension.full_name, existing_desc.full_name,
+             extension.containing_type.full_name, extension.number))
+
+    self._extensions_by_number[extension.containing_type][
+        extension.number] = extension
+    self._extensions_by_name[extension.containing_type][
+        extension.full_name] = extension
+
+    # Also register MessageSet extensions with the type name.
+    if _IsMessageSetExtension(extension):
+      self._extensions_by_name[extension.containing_type][
+          extension.message_type.full_name] = extension
+
+  @_Deprecated
+  def AddFileDescriptor(self, file_desc):
+    self._InternalAddFileDescriptor(file_desc)
+
+  # Never call this method. It is for internal usage only.
+  def _InternalAddFileDescriptor(self, file_desc):
+    """Adds a FileDescriptor to the pool, non-recursively.
+
+    If the FileDescriptor contains messages or enums, the caller must explicitly
+    register them.
+
+    Args:
+      file_desc: A FileDescriptor.
+    """
+
+    self._AddFileDescriptor(file_desc)
+    # TODO(jieluo): This is a temporary solution for FieldDescriptor.file.
+    # FieldDescriptor.file is added in code gen. Remove this solution after
+    # maybe 2020 for compatibility reason (with 3.4.1 only).
+    for extension in file_desc.extensions_by_name.values():
+      self._file_desc_by_toplevel_extension[
+          extension.full_name] = file_desc
+
+  def _AddFileDescriptor(self, file_desc):
+    """Adds a FileDescriptor to the pool, non-recursively.
+
+    If the FileDescriptor contains messages or enums, the caller must explicitly
+    register them.
+
+    Args:
+      file_desc: A FileDescriptor.
+    """
+
+    if not isinstance(file_desc, descriptor.FileDescriptor):
+      raise TypeError('Expected instance of descriptor.FileDescriptor.')
+    self._file_descriptors[file_desc.name] = file_desc
+
+  def FindFileByName(self, file_name):
+    """Gets a FileDescriptor by file name.
+
+    Args:
+      file_name (str): The path to the file to get a descriptor for.
+
+    Returns:
+      FileDescriptor: The descriptor for the named file.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+
+    try:
+      return self._file_descriptors[file_name]
+    except KeyError:
+      pass
+
+    try:
+      file_proto = self._internal_db.FindFileByName(file_name)
+    except KeyError as error:
+      if self._descriptor_db:
+        file_proto = self._descriptor_db.FindFileByName(file_name)
+      else:
+        raise error
+    if not file_proto:
+      raise KeyError('Cannot find a file named %s' % file_name)
+    return self._ConvertFileProtoToFileDescriptor(file_proto)
+
+  def FindFileContainingSymbol(self, symbol):
+    """Gets the FileDescriptor for the file containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: Descriptor for the file that contains the specified
+      symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+
+    symbol = _NormalizeFullyQualifiedName(symbol)
+    try:
+      return self._InternalFindFileContainingSymbol(symbol)
+    except KeyError:
+      pass
+
+    try:
+      # Try fallback database. Build and find again if possible.
+      self._FindFileContainingSymbolInDb(symbol)
+      return self._InternalFindFileContainingSymbol(symbol)
+    except KeyError:
+      raise KeyError('Cannot find a file containing %s' % symbol)
+
+  def _InternalFindFileContainingSymbol(self, symbol):
+    """Gets the already built FileDescriptor containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: Descriptor for the file that contains the specified
+      symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the pool.
+    """
+    try:
+      return self._descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._enum_descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._service_descriptors[symbol].file
+    except KeyError:
+      pass
+
+    try:
+      return self._top_enum_values[symbol].type.file
+    except KeyError:
+      pass
+
+    try:
+      return self._file_desc_by_toplevel_extension[symbol]
+    except KeyError:
+      pass
+
+    # Try fields, enum values and nested extensions inside a message.
+    top_name, _, sub_name = symbol.rpartition('.')
+    try:
+      message = self.FindMessageTypeByName(top_name)
+      assert (sub_name in message.extensions_by_name or
+              sub_name in message.fields_by_name or
+              sub_name in message.enum_values_by_name)
+      return message.file
+    except (KeyError, AssertionError):
+      raise KeyError('Cannot find a file containing %s' % symbol)
+
+  def FindMessageTypeByName(self, full_name):
+    """Loads the named descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the descriptor to load.
+
+    Returns:
+      Descriptor: The descriptor for the named type.
+
+    Raises:
+      KeyError: if the message cannot be found in the pool.
+    """
+
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._descriptors[full_name]
+
+  def FindEnumTypeByName(self, full_name):
+    """Loads the named enum descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the enum descriptor to load.
+
+    Returns:
+      EnumDescriptor: The enum descriptor for the named type.
+
+    Raises:
+      KeyError: if the enum cannot be found in the pool.
+    """
+
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._enum_descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._enum_descriptors[full_name]
+
+  def FindFieldByName(self, full_name):
+    """Loads the named field descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the field descriptor to load.
+
+    Returns:
+      FieldDescriptor: The field descriptor for the named field.
+
+    Raises:
+      KeyError: if the field cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    message_name, _, field_name = full_name.rpartition('.')
+    message_descriptor = self.FindMessageTypeByName(message_name)
+    return message_descriptor.fields_by_name[field_name]
+
+  def FindOneofByName(self, full_name):
+    """Loads the named oneof descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the oneof descriptor to load.
+
+    Returns:
+      OneofDescriptor: The oneof descriptor for the named oneof.
+
+    Raises:
+      KeyError: if the oneof cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    message_name, _, oneof_name = full_name.rpartition('.')
+    message_descriptor = self.FindMessageTypeByName(message_name)
+    return message_descriptor.oneofs_by_name[oneof_name]
+
+  def FindExtensionByName(self, full_name):
+    """Loads the named extension descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the extension descriptor to load.
+
+    Returns:
+      FieldDescriptor: The field descriptor for the named extension.
+
+    Raises:
+      KeyError: if the extension cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    try:
+      # The proto compiler does not give any link between the FileDescriptor
+      # and top-level extensions unless the FileDescriptorProto is added to
+      # the DescriptorDatabase, but this can impact memory usage.
+      # So we registered these extensions by name explicitly.
+      return self._toplevel_extensions[full_name]
+    except KeyError:
+      pass
+    message_name, _, extension_name = full_name.rpartition('.')
+    try:
+      # Most extensions are nested inside a message.
+      scope = self.FindMessageTypeByName(message_name)
+    except KeyError:
+      # Some extensions are defined at file scope.
+      scope = self._FindFileContainingSymbolInDb(full_name)
+    return scope.extensions_by_name[extension_name]
+
+  def FindExtensionByNumber(self, message_descriptor, number):
+    """Gets the extension of the specified message with the specified number.
+
+    Extensions have to be registered to this pool by calling :func:`Add` or
+    :func:`AddExtensionDescriptor`.
+
+    Args:
+      message_descriptor (Descriptor): descriptor of the extended message.
+      number (int): Number of the extension field.
+
+    Returns:
+      FieldDescriptor: The descriptor for the extension.
+
+    Raises:
+      KeyError: when no extension with the given number is known for the
+        specified message.
+    """
+    try:
+      return self._extensions_by_number[message_descriptor][number]
+    except KeyError:
+      self._TryLoadExtensionFromDB(message_descriptor, number)
+      return self._extensions_by_number[message_descriptor][number]
+
+  def FindAllExtensions(self, message_descriptor):
+    """Gets all the known extensions of a given message.
+
+    Extensions have to be registered to this pool by build related
+    :func:`Add` or :func:`AddExtensionDescriptor`.
+
+    Args:
+      message_descriptor (Descriptor): Descriptor of the extended message.
+
+    Returns:
+      list[FieldDescriptor]: Field descriptors describing the extensions.
+    """
+    # Fallback to descriptor db if FindAllExtensionNumbers is provided.
+    if self._descriptor_db and hasattr(
+        self._descriptor_db, 'FindAllExtensionNumbers'):
+      full_name = message_descriptor.full_name
+      all_numbers = self._descriptor_db.FindAllExtensionNumbers(full_name)
+      for number in all_numbers:
+        if number in self._extensions_by_number[message_descriptor]:
+          continue
+        self._TryLoadExtensionFromDB(message_descriptor, number)
+
+    return list(self._extensions_by_number[message_descriptor].values())
+
+  def _TryLoadExtensionFromDB(self, message_descriptor, number):
+    """Try to Load extensions from descriptor db.
+
+    Args:
+      message_descriptor: descriptor of the extended message.
+      number: the extension number that needs to be loaded.
+    """
+    if not self._descriptor_db:
+      return
+    # Only supported when FindFileContainingExtension is provided.
+    if not hasattr(
+        self._descriptor_db, 'FindFileContainingExtension'):
+      return
+
+    full_name = message_descriptor.full_name
+    file_proto = self._descriptor_db.FindFileContainingExtension(
+        full_name, number)
+
+    if file_proto is None:
+      return
+
+    try:
+      self._ConvertFileProtoToFileDescriptor(file_proto)
+    except:
+      warn_msg = ('Unable to load proto file %s for extension number %d.' %
+                  (file_proto.name, number))
+      warnings.warn(warn_msg, RuntimeWarning)
+
+  def FindServiceByName(self, full_name):
+    """Loads the named service descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the service descriptor to load.
+
+    Returns:
+      ServiceDescriptor: The service descriptor for the named service.
+
+    Raises:
+      KeyError: if the service cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    if full_name not in self._service_descriptors:
+      self._FindFileContainingSymbolInDb(full_name)
+    return self._service_descriptors[full_name]
+
+  def FindMethodByName(self, full_name):
+    """Loads the named service method descriptor from the pool.
+
+    Args:
+      full_name (str): The full name of the method descriptor to load.
+
+    Returns:
+      MethodDescriptor: The method descriptor for the service method.
+
+    Raises:
+      KeyError: if the method cannot be found in the pool.
+    """
+    full_name = _NormalizeFullyQualifiedName(full_name)
+    service_name, _, method_name = full_name.rpartition('.')
+    service_descriptor = self.FindServiceByName(service_name)
+    return service_descriptor.methods_by_name[method_name]
+
+  def _FindFileContainingSymbolInDb(self, symbol):
+    """Finds the file in descriptor DB containing the specified symbol.
+
+    Args:
+      symbol (str): The name of the symbol to search for.
+
+    Returns:
+      FileDescriptor: The file that contains the specified symbol.
+
+    Raises:
+      KeyError: if the file cannot be found in the descriptor database.
+    """
+    try:
+      file_proto = self._internal_db.FindFileContainingSymbol(symbol)
+    except KeyError as error:
+      if self._descriptor_db:
+        file_proto = self._descriptor_db.FindFileContainingSymbol(symbol)
+      else:
+        raise error
+    if not file_proto:
+      raise KeyError('Cannot find a file containing %s' % symbol)
+    return self._ConvertFileProtoToFileDescriptor(file_proto)
+
+  def _ConvertFileProtoToFileDescriptor(self, file_proto):
+    """Creates a FileDescriptor from a proto or returns a cached copy.
+
+    This method also has the side effect of loading all the symbols found in
+    the file into the appropriate dictionaries in the pool.
+
+    Args:
+      file_proto: The proto to convert.
+
+    Returns:
+      A FileDescriptor matching the passed in proto.
+    """
+    if file_proto.name not in self._file_descriptors:
+      built_deps = list(self._GetDeps(file_proto.dependency))
+      direct_deps = [self.FindFileByName(n) for n in file_proto.dependency]
+      public_deps = [direct_deps[i] for i in file_proto.public_dependency]
+
+      file_descriptor = descriptor.FileDescriptor(
+          pool=self,
+          name=file_proto.name,
+          package=file_proto.package,
+          syntax=file_proto.syntax,
+          options=_OptionsOrNone(file_proto),
+          serialized_pb=file_proto.SerializeToString(),
+          dependencies=direct_deps,
+          public_dependencies=public_deps,
+          # pylint: disable=protected-access
+          create_key=descriptor._internal_create_key)
+      scope = {}
+
+      # This loop extracts all the message and enum types from all the
+      # dependencies of the file_proto. This is necessary to create the
+      # scope of available message types when defining the passed in
+      # file proto.
+      for dependency in built_deps:
+        scope.update(self._ExtractSymbols(
+            dependency.message_types_by_name.values()))
+        scope.update((_PrefixWithDot(enum.full_name), enum)
+                     for enum in dependency.enum_types_by_name.values())
+
+      for message_type in file_proto.message_type:
+        message_desc = self._ConvertMessageDescriptor(
+            message_type, file_proto.package, file_descriptor, scope,
+            file_proto.syntax)
+        file_descriptor.message_types_by_name[message_desc.name] = (
+            message_desc)
+
+      for enum_type in file_proto.enum_type:
+        file_descriptor.enum_types_by_name[enum_type.name] = (
+            self._ConvertEnumDescriptor(enum_type, file_proto.package,
+                                        file_descriptor, None, scope, True))
+
+      for index, extension_proto in enumerate(file_proto.extension):
+        extension_desc = self._MakeFieldDescriptor(
+            extension_proto, file_proto.package, index, file_descriptor,
+            is_extension=True)
+        extension_desc.containing_type = self._GetTypeFromScope(
+            file_descriptor.package, extension_proto.extendee, scope)
+        self._SetFieldType(extension_proto, extension_desc,
+                           file_descriptor.package, scope)
+        file_descriptor.extensions_by_name[extension_desc.name] = (
+            extension_desc)
+        self._file_desc_by_toplevel_extension[extension_desc.full_name] = (
+            file_descriptor)
+
+      for desc_proto in file_proto.message_type:
+        self._SetAllFieldTypes(file_proto.package, desc_proto, scope)
+
+      if file_proto.package:
+        desc_proto_prefix = _PrefixWithDot(file_proto.package)
+      else:
+        desc_proto_prefix = ''
+
+      for desc_proto in file_proto.message_type:
+        desc = self._GetTypeFromScope(
+            desc_proto_prefix, desc_proto.name, scope)
+        file_descriptor.message_types_by_name[desc_proto.name] = desc
+
+      for index, service_proto in enumerate(file_proto.service):
+        file_descriptor.services_by_name[service_proto.name] = (
+            self._MakeServiceDescriptor(service_proto, index, scope,
+                                        file_proto.package, file_descriptor))
+
+      self.Add(file_proto)
+      self._file_descriptors[file_proto.name] = file_descriptor
+
+    # Add extensions to the pool
+    file_desc = self._file_descriptors[file_proto.name]
+    for extension in file_desc.extensions_by_name.values():
+      self._AddExtensionDescriptor(extension)
+    for message_type in file_desc.message_types_by_name.values():
+      for extension in message_type.extensions:
+        self._AddExtensionDescriptor(extension)
+
+    return file_desc
+
+  def _ConvertMessageDescriptor(self, desc_proto, package=None, file_desc=None,
+                                scope=None, syntax=None):
+    """Adds the proto to the pool in the specified package.
+
+    Args:
+      desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
+      package: The package the proto should be located in.
+      file_desc: The file containing this message.
+      scope: Dict mapping short and full symbols to message and enum types.
+      syntax: string indicating syntax of the file ("proto2" or "proto3")
+
+    Returns:
+      The added descriptor.
+    """
+
+    if package:
+      desc_name = '.'.join((package, desc_proto.name))
+    else:
+      desc_name = desc_proto.name
+
+    if file_desc is None:
+      file_name = None
+    else:
+      file_name = file_desc.name
+
+    if scope is None:
+      scope = {}
+
+    nested = [
+        self._ConvertMessageDescriptor(
+            nested, desc_name, file_desc, scope, syntax)
+        for nested in desc_proto.nested_type]
+    enums = [
+        self._ConvertEnumDescriptor(enum, desc_name, file_desc, None,
+                                    scope, False)
+        for enum in desc_proto.enum_type]
+    fields = [self._MakeFieldDescriptor(field, desc_name, index, file_desc)
+              for index, field in enumerate(desc_proto.field)]
+    extensions = [
+        self._MakeFieldDescriptor(extension, desc_name, index, file_desc,
+                                  is_extension=True)
+        for index, extension in enumerate(desc_proto.extension)]
+    oneofs = [
+        # pylint: disable=g-complex-comprehension
+        descriptor.OneofDescriptor(desc.name, '.'.join((desc_name, desc.name)),
+                                   index, None, [], desc.options,
+                                   # pylint: disable=protected-access
+                                   create_key=descriptor._internal_create_key)
+        for index, desc in enumerate(desc_proto.oneof_decl)]
+    extension_ranges = [(r.start, r.end) for r in desc_proto.extension_range]
+    if extension_ranges:
+      is_extendable = True
+    else:
+      is_extendable = False
+    desc = descriptor.Descriptor(
+        name=desc_proto.name,
+        full_name=desc_name,
+        filename=file_name,
+        containing_type=None,
+        fields=fields,
+        oneofs=oneofs,
+        nested_types=nested,
+        enum_types=enums,
+        extensions=extensions,
+        options=_OptionsOrNone(desc_proto),
+        is_extendable=is_extendable,
+        extension_ranges=extension_ranges,
+        file=file_desc,
+        serialized_start=None,
+        serialized_end=None,
+        syntax=syntax,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+    for nested in desc.nested_types:
+      nested.containing_type = desc
+    for enum in desc.enum_types:
+      enum.containing_type = desc
+    for field_index, field_desc in enumerate(desc_proto.field):
+      if field_desc.HasField('oneof_index'):
+        oneof_index = field_desc.oneof_index
+        oneofs[oneof_index].fields.append(fields[field_index])
+        fields[field_index].containing_oneof = oneofs[oneof_index]
+
+    scope[_PrefixWithDot(desc_name)] = desc
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._descriptors[desc_name] = desc
+    return desc
+
+  def _ConvertEnumDescriptor(self, enum_proto, package=None, file_desc=None,
+                             containing_type=None, scope=None, top_level=False):
+    """Make a protobuf EnumDescriptor given an EnumDescriptorProto protobuf.
+
+    Args:
+      enum_proto: The descriptor_pb2.EnumDescriptorProto protobuf message.
+      package: Optional package name for the new message EnumDescriptor.
+      file_desc: The file containing the enum descriptor.
+      containing_type: The type containing this enum.
+      scope: Scope containing available types.
+      top_level: If True, the enum is a top level symbol. If False, the enum
+          is defined inside a message.
+
+    Returns:
+      The added descriptor
+    """
+
+    if package:
+      enum_name = '.'.join((package, enum_proto.name))
+    else:
+      enum_name = enum_proto.name
+
+    if file_desc is None:
+      file_name = None
+    else:
+      file_name = file_desc.name
+
+    values = [self._MakeEnumValueDescriptor(value, index)
+              for index, value in enumerate(enum_proto.value)]
+    desc = descriptor.EnumDescriptor(name=enum_proto.name,
+                                     full_name=enum_name,
+                                     filename=file_name,
+                                     file=file_desc,
+                                     values=values,
+                                     containing_type=containing_type,
+                                     options=_OptionsOrNone(enum_proto),
+                                     # pylint: disable=protected-access
+                                     create_key=descriptor._internal_create_key)
+    scope['.%s' % enum_name] = desc
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._enum_descriptors[enum_name] = desc
+
+    # Add top level enum values.
+    if top_level:
+      for value in values:
+        full_name = _NormalizeFullyQualifiedName(
+            '.'.join((package, value.name)))
+        self._CheckConflictRegister(value, full_name, file_name)
+        self._top_enum_values[full_name] = value
+
+    return desc
+
+  def _MakeFieldDescriptor(self, field_proto, message_name, index,
+                           file_desc, is_extension=False):
+    """Creates a field descriptor from a FieldDescriptorProto.
+
+    For message and enum type fields, this method will do a look up
+    in the pool for the appropriate descriptor for that type. If it
+    is unavailable, it will fall back to the _source function to
+    create it. If this type is still unavailable, construction will
+    fail.
+
+    Args:
+      field_proto: The proto describing the field.
+      message_name: The name of the containing message.
+      index: Index of the field
+      file_desc: The file containing the field descriptor.
+      is_extension: Indication that this field is for an extension.
+
+    Returns:
+      An initialized FieldDescriptor object
+    """
+
+    if message_name:
+      full_name = '.'.join((message_name, field_proto.name))
+    else:
+      full_name = field_proto.name
+
+    return descriptor.FieldDescriptor(
+        name=field_proto.name,
+        full_name=full_name,
+        index=index,
+        number=field_proto.number,
+        type=field_proto.type,
+        cpp_type=None,
+        message_type=None,
+        enum_type=None,
+        containing_type=None,
+        label=field_proto.label,
+        has_default_value=False,
+        default_value=None,
+        is_extension=is_extension,
+        extension_scope=None,
+        options=_OptionsOrNone(field_proto),
+        file=file_desc,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _SetAllFieldTypes(self, package, desc_proto, scope):
+    """Sets all the descriptor's fields's types.
+
+    This method also sets the containing types on any extensions.
+
+    Args:
+      package: The current package of desc_proto.
+      desc_proto: The message descriptor to update.
+      scope: Enclosing scope of available types.
+    """
+
+    package = _PrefixWithDot(package)
+
+    main_desc = self._GetTypeFromScope(package, desc_proto.name, scope)
+
+    if package == '.':
+      nested_package = _PrefixWithDot(desc_proto.name)
+    else:
+      nested_package = '.'.join([package, desc_proto.name])
+
+    for field_proto, field_desc in zip(desc_proto.field, main_desc.fields):
+      self._SetFieldType(field_proto, field_desc, nested_package, scope)
+
+    for extension_proto, extension_desc in (
+        zip(desc_proto.extension, main_desc.extensions)):
+      extension_desc.containing_type = self._GetTypeFromScope(
+          nested_package, extension_proto.extendee, scope)
+      self._SetFieldType(extension_proto, extension_desc, nested_package, scope)
+
+    for nested_type in desc_proto.nested_type:
+      self._SetAllFieldTypes(nested_package, nested_type, scope)
+
+  def _SetFieldType(self, field_proto, field_desc, package, scope):
+    """Sets the field's type, cpp_type, message_type and enum_type.
+
+    Args:
+      field_proto: Data about the field in proto format.
+      field_desc: The descriptor to modify.
+      package: The package the field's container is in.
+      scope: Enclosing scope of available types.
+    """
+    if field_proto.type_name:
+      desc = self._GetTypeFromScope(package, field_proto.type_name, scope)
+    else:
+      desc = None
+
+    if not field_proto.HasField('type'):
+      if isinstance(desc, descriptor.Descriptor):
+        field_proto.type = descriptor.FieldDescriptor.TYPE_MESSAGE
+      else:
+        field_proto.type = descriptor.FieldDescriptor.TYPE_ENUM
+
+    field_desc.cpp_type = descriptor.FieldDescriptor.ProtoTypeToCppProtoType(
+        field_proto.type)
+
+    if (field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE
+        or field_proto.type == descriptor.FieldDescriptor.TYPE_GROUP):
+      field_desc.message_type = desc
+
+    if field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+      field_desc.enum_type = desc
+
+    if field_proto.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      field_desc.has_default_value = False
+      field_desc.default_value = []
+    elif field_proto.HasField('default_value'):
+      field_desc.has_default_value = True
+      if (field_proto.type == descriptor.FieldDescriptor.TYPE_DOUBLE or
+          field_proto.type == descriptor.FieldDescriptor.TYPE_FLOAT):
+        field_desc.default_value = float(field_proto.default_value)
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_STRING:
+        field_desc.default_value = field_proto.default_value
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BOOL:
+        field_desc.default_value = field_proto.default_value.lower() == 'true'
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+        field_desc.default_value = field_desc.enum_type.values_by_name[
+            field_proto.default_value].number
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        field_desc.default_value = text_encoding.CUnescape(
+            field_proto.default_value)
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE:
+        field_desc.default_value = None
+      else:
+        # All other types are of the "int" type.
+        field_desc.default_value = int(field_proto.default_value)
+    else:
+      field_desc.has_default_value = False
+      if (field_proto.type == descriptor.FieldDescriptor.TYPE_DOUBLE or
+          field_proto.type == descriptor.FieldDescriptor.TYPE_FLOAT):
+        field_desc.default_value = 0.0
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_STRING:
+        field_desc.default_value = u''
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BOOL:
+        field_desc.default_value = False
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_ENUM:
+        field_desc.default_value = field_desc.enum_type.values[0].number
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        field_desc.default_value = b''
+      elif field_proto.type == descriptor.FieldDescriptor.TYPE_MESSAGE:
+        field_desc.default_value = None
+      else:
+        # All other types are of the "int" type.
+        field_desc.default_value = 0
+
+    field_desc.type = field_proto.type
+
+  def _MakeEnumValueDescriptor(self, value_proto, index):
+    """Creates a enum value descriptor object from a enum value proto.
+
+    Args:
+      value_proto: The proto describing the enum value.
+      index: The index of the enum value.
+
+    Returns:
+      An initialized EnumValueDescriptor object.
+    """
+
+    return descriptor.EnumValueDescriptor(
+        name=value_proto.name,
+        index=index,
+        number=value_proto.number,
+        options=_OptionsOrNone(value_proto),
+        type=None,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _MakeServiceDescriptor(self, service_proto, service_index, scope,
+                             package, file_desc):
+    """Make a protobuf ServiceDescriptor given a ServiceDescriptorProto.
+
+    Args:
+      service_proto: The descriptor_pb2.ServiceDescriptorProto protobuf message.
+      service_index: The index of the service in the File.
+      scope: Dict mapping short and full symbols to message and enum types.
+      package: Optional package name for the new message EnumDescriptor.
+      file_desc: The file containing the service descriptor.
+
+    Returns:
+      The added descriptor.
+    """
+
+    if package:
+      service_name = '.'.join((package, service_proto.name))
+    else:
+      service_name = service_proto.name
+
+    methods = [self._MakeMethodDescriptor(method_proto, service_name, package,
+                                          scope, index)
+               for index, method_proto in enumerate(service_proto.method)]
+    desc = descriptor.ServiceDescriptor(
+        name=service_proto.name,
+        full_name=service_name,
+        index=service_index,
+        methods=methods,
+        options=_OptionsOrNone(service_proto),
+        file=file_desc,
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+    self._CheckConflictRegister(desc, desc.full_name, desc.file.name)
+    self._service_descriptors[service_name] = desc
+    return desc
+
+  def _MakeMethodDescriptor(self, method_proto, service_name, package, scope,
+                            index):
+    """Creates a method descriptor from a MethodDescriptorProto.
+
+    Args:
+      method_proto: The proto describing the method.
+      service_name: The name of the containing service.
+      package: Optional package name to look up for types.
+      scope: Scope containing available types.
+      index: Index of the method in the service.
+
+    Returns:
+      An initialized MethodDescriptor object.
+    """
+    full_name = '.'.join((service_name, method_proto.name))
+    input_type = self._GetTypeFromScope(
+        package, method_proto.input_type, scope)
+    output_type = self._GetTypeFromScope(
+        package, method_proto.output_type, scope)
+    return descriptor.MethodDescriptor(
+        name=method_proto.name,
+        full_name=full_name,
+        index=index,
+        containing_service=None,
+        input_type=input_type,
+        output_type=output_type,
+        options=_OptionsOrNone(method_proto),
+        # pylint: disable=protected-access
+        create_key=descriptor._internal_create_key)
+
+  def _ExtractSymbols(self, descriptors):
+    """Pulls out all the symbols from descriptor protos.
+
+    Args:
+      descriptors: The messages to extract descriptors from.
+    Yields:
+      A two element tuple of the type name and descriptor object.
+    """
+
+    for desc in descriptors:
+      yield (_PrefixWithDot(desc.full_name), desc)
+      for symbol in self._ExtractSymbols(desc.nested_types):
+        yield symbol
+      for enum in desc.enum_types:
+        yield (_PrefixWithDot(enum.full_name), enum)
+
+  def _GetDeps(self, dependencies):
+    """Recursively finds dependencies for file protos.
+
+    Args:
+      dependencies: The names of the files being depended on.
+
+    Yields:
+      Each direct and indirect dependency.
+    """
+
+    for dependency in dependencies:
+      dep_desc = self.FindFileByName(dependency)
+      yield dep_desc
+      for parent_dep in dep_desc.dependencies:
+        yield parent_dep
+
+  def _GetTypeFromScope(self, package, type_name, scope):
+    """Finds a given type name in the current scope.
+
+    Args:
+      package: The package the proto should be located in.
+      type_name: The name of the type to be found in the scope.
+      scope: Dict mapping short and full symbols to message and enum types.
+
+    Returns:
+      The descriptor for the requested type.
+    """
+    if type_name not in scope:
+      components = _PrefixWithDot(package).split('.')
+      while components:
+        possible_match = '.'.join(components + [type_name])
+        if possible_match in scope:
+          type_name = possible_match
+          break
+        else:
+          components.pop(-1)
+    return scope[type_name]
+
+
+def _PrefixWithDot(name):
+  return name if name.startswith('.') else '.%s' % name
+
+
+if _USE_C_DESCRIPTORS:
+  # TODO(amauryfa): This pool could be constructed from Python code, when we
+  # support a flag like 'use_cpp_generated_pool=True'.
+  # pylint: disable=protected-access
+  _DEFAULT = descriptor._message.default_pool
+else:
+  _DEFAULT = DescriptorPool()
+
+
+def Default():
+  return _DEFAULT
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/duration_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/duration_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..813a92dfcc82567c4c1e61ff1d928527cff00231
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/duration_pb2.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/duration.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/duration.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\rDurationProtoP\001Z1google.golang.org/protobuf/types/known/durationpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1egoogle/protobuf/duration.proto\x12\x0fgoogle.protobuf\"*\n\x08\x44uration\x12\x0f\n\x07seconds\x18\x01 \x01(\x03\x12\r\n\x05nanos\x18\x02 \x01(\x05\x42\x83\x01\n\x13\x63om.google.protobufB\rDurationProtoP\x01Z1google.golang.org/protobuf/types/known/durationpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_DURATION = _descriptor.Descriptor(
+  name='Duration',
+  full_name='google.protobuf.Duration',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='seconds', full_name='google.protobuf.Duration.seconds', index=0,
+      number=1, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='nanos', full_name='google.protobuf.Duration.nanos', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=51,
+  serialized_end=93,
+)
+
+DESCRIPTOR.message_types_by_name['Duration'] = _DURATION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Duration = _reflection.GeneratedProtocolMessageType('Duration', (_message.Message,), {
+  'DESCRIPTOR' : _DURATION,
+  '__module__' : 'google.protobuf.duration_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Duration)
+  })
+_sym_db.RegisterMessage(Duration)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/empty_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/empty_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..009d4d580a26ecd2df9694258a97a759d15062a3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/empty_pb2.py
@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/empty.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/empty.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\nEmptyProtoP\001Z.google.golang.org/protobuf/types/known/emptypb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1bgoogle/protobuf/empty.proto\x12\x0fgoogle.protobuf\"\x07\n\x05\x45mptyB}\n\x13\x63om.google.protobufB\nEmptyProtoP\x01Z.google.golang.org/protobuf/types/known/emptypb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_EMPTY = _descriptor.Descriptor(
+  name='Empty',
+  full_name='google.protobuf.Empty',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=48,
+  serialized_end=55,
+)
+
+DESCRIPTOR.message_types_by_name['Empty'] = _EMPTY
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Empty = _reflection.GeneratedProtocolMessageType('Empty', (_message.Message,), {
+  'DESCRIPTOR' : _EMPTY,
+  '__module__' : 'google.protobuf.empty_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Empty)
+  })
+_sym_db.RegisterMessage(Empty)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/field_mask_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/field_mask_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7494248aca8e17a23d99338725fed9ae2cdaaf6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/field_mask_pb2.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/field_mask.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/field_mask.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\016FieldMaskProtoP\001Z2google.golang.org/protobuf/types/known/fieldmaskpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n google/protobuf/field_mask.proto\x12\x0fgoogle.protobuf\"\x1a\n\tFieldMask\x12\r\n\x05paths\x18\x01 \x03(\tB\x85\x01\n\x13\x63om.google.protobufB\x0e\x46ieldMaskProtoP\x01Z2google.golang.org/protobuf/types/known/fieldmaskpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_FIELDMASK = _descriptor.Descriptor(
+  name='FieldMask',
+  full_name='google.protobuf.FieldMask',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='paths', full_name='google.protobuf.FieldMask.paths', index=0,
+      number=1, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=53,
+  serialized_end=79,
+)
+
+DESCRIPTOR.message_types_by_name['FieldMask'] = _FIELDMASK
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+FieldMask = _reflection.GeneratedProtocolMessageType('FieldMask', (_message.Message,), {
+  'DESCRIPTOR' : _FIELDMASK,
+  '__module__' : 'google.protobuf.field_mask_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FieldMask)
+  })
+_sym_db.RegisterMessage(FieldMask)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d2e571a143a51d4b385a645a77c0316edc87b98
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/__init__.py
@@ -0,0 +1,30 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/_api_implementation.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/_api_implementation.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..255ab1a7e7a4db8f025e40ceb82f71c9b2ad2621
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/_api_implementation.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/api_implementation.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/api_implementation.py
new file mode 100644
index 0000000000000000000000000000000000000000..7592be4eed3d3d14d3545490fa11977084dd7e1b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/api_implementation.py
@@ -0,0 +1,158 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Determine which implementation of the protobuf API is used in this process.
+"""
+
+import os
+import warnings
+import sys
+
+try:
+  # pylint: disable=g-import-not-at-top
+  from google.protobuf.internal import _api_implementation
+  # The compile-time constants in the _api_implementation module can be used to
+  # switch to a certain implementation of the Python API at build time.
+  _api_version = _api_implementation.api_version
+  _proto_extension_modules_exist_in_build = True
+except ImportError:
+  _api_version = -1  # Unspecified by compiler flags.
+  _proto_extension_modules_exist_in_build = False
+
+if _api_version == 1:
+  raise ValueError('api_version=1 is no longer supported.')
+if _api_version < 0:  # Still unspecified?
+  try:
+    # The presence of this module in a build allows the proto implementation to
+    # be upgraded merely via build deps rather than a compiler flag or the
+    # runtime environment variable.
+    # pylint: disable=g-import-not-at-top
+    from google.protobuf import _use_fast_cpp_protos
+    # Work around a known issue in the classic bootstrap .par import hook.
+    if not _use_fast_cpp_protos:
+      raise ImportError('_use_fast_cpp_protos import succeeded but was None')
+    del _use_fast_cpp_protos
+    _api_version = 2
+    # Can not import both use_fast_cpp_protos and use_pure_python.
+    from google.protobuf import use_pure_python
+    raise RuntimeError(
+        'Conflict depend on both use_fast_cpp_protos and use_pure_python')
+  except ImportError:
+    try:
+      # pylint: disable=g-import-not-at-top
+      from google.protobuf import use_pure_python
+      del use_pure_python  # Avoids a pylint error and namespace pollution.
+      _api_version = 0
+    except ImportError:
+      # TODO(b/74017912): It's unsafe to enable :use_fast_cpp_protos by default;
+      # it can cause data loss if you have any Python-only extensions to any
+      # message passed back and forth with C++ code.
+      #
+      # TODO(b/17427486): Once that bug is fixed, we want to make both Python 2
+      # and Python 3 default to `_api_version = 2` (C++ implementation V2).
+      pass
+
+_default_implementation_type = (
+    'python' if _api_version <= 0 else 'cpp')
+
+# This environment variable can be used to switch to a certain implementation
+# of the Python API, overriding the compile-time constants in the
+# _api_implementation module. Right now only 'python' and 'cpp' are valid
+# values. Any other value will be ignored.
+_implementation_type = os.getenv('PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION',
+                                 _default_implementation_type)
+
+if _implementation_type != 'python':
+  _implementation_type = 'cpp'
+
+if 'PyPy' in sys.version and _implementation_type == 'cpp':
+  warnings.warn('PyPy does not work yet with cpp protocol buffers. '
+                'Falling back to the python implementation.')
+  _implementation_type = 'python'
+
+# This environment variable can be used to switch between the two
+# 'cpp' implementations, overriding the compile-time constants in the
+# _api_implementation module. Right now only '2' is supported. Any other
+# value will cause an error to be raised.
+_implementation_version_str = os.getenv(
+    'PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION_VERSION', '2')
+
+if _implementation_version_str != '2':
+  raise ValueError(
+      'unsupported PROTOCOL_BUFFERS_PYTHON_IMPLEMENTATION_VERSION: "' +
+      _implementation_version_str + '" (supported versions: 2)'
+      )
+
+_implementation_version = int(_implementation_version_str)
+
+
+# Detect if serialization should be deterministic by default
+try:
+  # The presence of this module in a build allows the proto implementation to
+  # be upgraded merely via build deps.
+  #
+  # NOTE: Merely importing this automatically enables deterministic proto
+  # serialization for C++ code, but we still need to export it as a boolean so
+  # that we can do the same for `_implementation_type == 'python'`.
+  #
+  # NOTE2: It is possible for C++ code to enable deterministic serialization by
+  # default _without_ affecting Python code, if the C++ implementation is not in
+  # use by this module.  That is intended behavior, so we don't actually expose
+  # this boolean outside of this module.
+  #
+  # pylint: disable=g-import-not-at-top,unused-import
+  from google.protobuf import enable_deterministic_proto_serialization
+  _python_deterministic_proto_serialization = True
+except ImportError:
+  _python_deterministic_proto_serialization = False
+
+
+# Usage of this function is discouraged. Clients shouldn't care which
+# implementation of the API is in use. Note that there is no guarantee
+# that differences between APIs will be maintained.
+# Please don't use this function if possible.
+def Type():
+  return _implementation_type
+
+
+def _SetType(implementation_type):
+  """Never use! Only for protobuf benchmark."""
+  global _implementation_type
+  _implementation_type = implementation_type
+
+
+# See comment on 'Type' above.
+def Version():
+  return _implementation_version
+
+
+# For internal use only
+def IsPythonDefaultSerializationDeterministic():
+  return _python_deterministic_proto_serialization
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/containers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/containers.py
new file mode 100644
index 0000000000000000000000000000000000000000..92793490bbc3e1f664e82d9993562c2e6da20acb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/containers.py
@@ -0,0 +1,785 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains container classes to represent different protocol buffer types.
+
+This file defines container classes which represent categories of protocol
+buffer field types which need extra maintenance. Currently these categories
+are:
+
+-   Repeated scalar fields - These are all repeated fields which aren't
+    composite (e.g. they are of simple types like int32, string, etc).
+-   Repeated composite fields - Repeated fields which are composite. This
+    includes groups and nested messages.
+"""
+
+__author__ = 'petar@google.com (Petar Petrov)'
+
+import sys
+try:
+  # This fallback applies for all versions of Python before 3.3
+  import collections.abc as collections_abc
+except ImportError:
+  import collections as collections_abc
+
+if sys.version_info[0] < 3:
+  # We would use collections_abc.MutableMapping all the time, but in Python 2
+  # it doesn't define __slots__.  This causes two significant problems:
+  #
+  # 1. we can't disallow arbitrary attribute assignment, even if our derived
+  #    classes *do* define __slots__.
+  #
+  # 2. we can't safely derive a C type from it without __slots__ defined (the
+  #    interpreter expects to find a dict at tp_dictoffset, which we can't
+  #    robustly provide.  And we don't want an instance dict anyway.
+  #
+  # So this is the Python 2.7 definition of Mapping/MutableMapping functions
+  # verbatim, except that:
+  # 1. We declare __slots__.
+  # 2. We don't declare this as a virtual base class.  The classes defined
+  #    in collections_abc are the interesting base classes, not us.
+  #
+  # Note: deriving from object is critical.  It is the only thing that makes
+  # this a true type, allowing us to derive from it in C++ cleanly and making
+  # __slots__ properly disallow arbitrary element assignment.
+
+  class Mapping(object):
+    __slots__ = ()
+
+    def get(self, key, default=None):
+      try:
+        return self[key]
+      except KeyError:
+        return default
+
+    def __contains__(self, key):
+      try:
+        self[key]
+      except KeyError:
+        return False
+      else:
+        return True
+
+    def iterkeys(self):
+      return iter(self)
+
+    def itervalues(self):
+      for key in self:
+        yield self[key]
+
+    def iteritems(self):
+      for key in self:
+        yield (key, self[key])
+
+    def keys(self):
+      return list(self)
+
+    def items(self):
+      return [(key, self[key]) for key in self]
+
+    def values(self):
+      return [self[key] for key in self]
+
+    # Mappings are not hashable by default, but subclasses can change this
+    __hash__ = None
+
+    def __eq__(self, other):
+      if not isinstance(other, collections_abc.Mapping):
+        return NotImplemented
+      return dict(self.items()) == dict(other.items())
+
+    def __ne__(self, other):
+      return not (self == other)
+
+  class MutableMapping(Mapping):
+    __slots__ = ()
+
+    __marker = object()
+
+    def pop(self, key, default=__marker):
+      try:
+        value = self[key]
+      except KeyError:
+        if default is self.__marker:
+          raise
+        return default
+      else:
+        del self[key]
+        return value
+
+    def popitem(self):
+      try:
+        key = next(iter(self))
+      except StopIteration:
+        raise KeyError
+      value = self[key]
+      del self[key]
+      return key, value
+
+    def clear(self):
+      try:
+        while True:
+          self.popitem()
+      except KeyError:
+        pass
+
+    def update(*args, **kwds):
+      if len(args) > 2:
+        raise TypeError("update() takes at most 2 positional "
+                        "arguments ({} given)".format(len(args)))
+      elif not args:
+        raise TypeError("update() takes at least 1 argument (0 given)")
+      self = args[0]
+      other = args[1] if len(args) >= 2 else ()
+
+      if isinstance(other, Mapping):
+        for key in other:
+          self[key] = other[key]
+      elif hasattr(other, "keys"):
+        for key in other.keys():
+          self[key] = other[key]
+      else:
+        for key, value in other:
+          self[key] = value
+      for key, value in kwds.items():
+        self[key] = value
+
+    def setdefault(self, key, default=None):
+      try:
+        return self[key]
+      except KeyError:
+        self[key] = default
+      return default
+
+  collections_abc.Mapping.register(Mapping)
+  collections_abc.MutableMapping.register(MutableMapping)
+
+else:
+  # In Python 3 we can just use MutableMapping directly, because it defines
+  # __slots__.
+  MutableMapping = collections_abc.MutableMapping
+
+
+class BaseContainer(object):
+
+  """Base container class."""
+
+  # Minimizes memory usage and disallows assignment to other attributes.
+  __slots__ = ['_message_listener', '_values']
+
+  def __init__(self, message_listener):
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The RepeatedScalarFieldContainer will call this object's
+        Modified() method when it is modified.
+    """
+    self._message_listener = message_listener
+    self._values = []
+
+  def __getitem__(self, key):
+    """Retrieves item by the specified key."""
+    return self._values[key]
+
+  def __len__(self):
+    """Returns the number of elements in the container."""
+    return len(self._values)
+
+  def __ne__(self, other):
+    """Checks if another instance isn't equal to this one."""
+    # The concrete classes should define __eq__.
+    return not self == other
+
+  def __hash__(self):
+    raise TypeError('unhashable object')
+
+  def __repr__(self):
+    return repr(self._values)
+
+  def sort(self, *args, **kwargs):
+    # Continue to support the old sort_function keyword argument.
+    # This is expected to be a rare occurrence, so use LBYL to avoid
+    # the overhead of actually catching KeyError.
+    if 'sort_function' in kwargs:
+      kwargs['cmp'] = kwargs.pop('sort_function')
+    self._values.sort(*args, **kwargs)
+
+  def reverse(self):
+    self._values.reverse()
+
+
+collections_abc.MutableSequence.register(BaseContainer)
+
+
+class RepeatedScalarFieldContainer(BaseContainer):
+  """Simple, type-checked, list-like container for holding repeated scalars."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_type_checker']
+
+  def __init__(self, message_listener, type_checker):
+    """Args:
+
+      message_listener: A MessageListener implementation. The
+      RepeatedScalarFieldContainer will call this object's Modified() method
+      when it is modified.
+      type_checker: A type_checkers.ValueChecker instance to run on elements
+      inserted into this container.
+    """
+    super(RepeatedScalarFieldContainer, self).__init__(message_listener)
+    self._type_checker = type_checker
+
+  def append(self, value):
+    """Appends an item to the list. Similar to list.append()."""
+    self._values.append(self._type_checker.CheckValue(value))
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def insert(self, key, value):
+    """Inserts the item at the specified position. Similar to list.insert()."""
+    self._values.insert(key, self._type_checker.CheckValue(value))
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def extend(self, elem_seq):
+    """Extends by appending the given iterable. Similar to list.extend()."""
+
+    if elem_seq is None:
+      return
+    try:
+      elem_seq_iter = iter(elem_seq)
+    except TypeError:
+      if not elem_seq:
+        # silently ignore falsy inputs :-/.
+        # TODO(ptucker): Deprecate this behavior. b/18413862
+        return
+      raise
+
+    new_values = [self._type_checker.CheckValue(elem) for elem in elem_seq_iter]
+    if new_values:
+      self._values.extend(new_values)
+    self._message_listener.Modified()
+
+  def MergeFrom(self, other):
+    """Appends the contents of another repeated field of the same type to this
+    one. We do not check the types of the individual fields.
+    """
+    self._values.extend(other._values)
+    self._message_listener.Modified()
+
+  def remove(self, elem):
+    """Removes an item from the list. Similar to list.remove()."""
+    self._values.remove(elem)
+    self._message_listener.Modified()
+
+  def pop(self, key=-1):
+    """Removes and returns an item at a given index. Similar to list.pop()."""
+    value = self._values[key]
+    self.__delitem__(key)
+    return value
+
+  def __setitem__(self, key, value):
+    """Sets the item on the specified position."""
+    if isinstance(key, slice):  # PY3
+      if key.step is not None:
+        raise ValueError('Extended slices not supported')
+      self.__setslice__(key.start, key.stop, value)
+    else:
+      self._values[key] = self._type_checker.CheckValue(value)
+      self._message_listener.Modified()
+
+  def __getslice__(self, start, stop):
+    """Retrieves the subset of items from between the specified indices."""
+    return self._values[start:stop]
+
+  def __setslice__(self, start, stop, values):
+    """Sets the subset of items from between the specified indices."""
+    new_values = []
+    for value in values:
+      new_values.append(self._type_checker.CheckValue(value))
+    self._values[start:stop] = new_values
+    self._message_listener.Modified()
+
+  def __delitem__(self, key):
+    """Deletes the item at the specified position."""
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __delslice__(self, start, stop):
+    """Deletes the subset of items from between the specified indices."""
+    del self._values[start:stop]
+    self._message_listener.Modified()
+
+  def __eq__(self, other):
+    """Compares the current instance with another one."""
+    if self is other:
+      return True
+    # Special case for the same type which should be common and fast.
+    if isinstance(other, self.__class__):
+      return other._values == self._values
+    # We are presumably comparing against some other sequence type.
+    return other == self._values
+
+
+class RepeatedCompositeFieldContainer(BaseContainer):
+
+  """Simple, list-like container for holding repeated composite fields."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_message_descriptor']
+
+  def __init__(self, message_listener, message_descriptor):
+    """
+    Note that we pass in a descriptor instead of the generated directly,
+    since at the time we construct a _RepeatedCompositeFieldContainer we
+    haven't yet necessarily initialized the type that will be contained in the
+    container.
+
+    Args:
+      message_listener: A MessageListener implementation.
+        The RepeatedCompositeFieldContainer will call this object's
+        Modified() method when it is modified.
+      message_descriptor: A Descriptor instance describing the protocol type
+        that should be present in this container.  We'll use the
+        _concrete_class field of this descriptor when the client calls add().
+    """
+    super(RepeatedCompositeFieldContainer, self).__init__(message_listener)
+    self._message_descriptor = message_descriptor
+
+  def add(self, **kwargs):
+    """Adds a new element at the end of the list and returns it. Keyword
+    arguments may be used to initialize the element.
+    """
+    new_element = self._message_descriptor._concrete_class(**kwargs)
+    new_element._SetListener(self._message_listener)
+    self._values.append(new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+    return new_element
+
+  def append(self, value):
+    """Appends one element by copying the message."""
+    new_element = self._message_descriptor._concrete_class()
+    new_element._SetListener(self._message_listener)
+    new_element.CopyFrom(value)
+    self._values.append(new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def insert(self, key, value):
+    """Inserts the item at the specified position by copying."""
+    new_element = self._message_descriptor._concrete_class()
+    new_element._SetListener(self._message_listener)
+    new_element.CopyFrom(value)
+    self._values.insert(key, new_element)
+    if not self._message_listener.dirty:
+      self._message_listener.Modified()
+
+  def extend(self, elem_seq):
+    """Extends by appending the given sequence of elements of the same type
+
+    as this one, copying each individual message.
+    """
+    message_class = self._message_descriptor._concrete_class
+    listener = self._message_listener
+    values = self._values
+    for message in elem_seq:
+      new_element = message_class()
+      new_element._SetListener(listener)
+      new_element.MergeFrom(message)
+      values.append(new_element)
+    listener.Modified()
+
+  def MergeFrom(self, other):
+    """Appends the contents of another repeated field of the same type to this
+    one, copying each individual message.
+    """
+    self.extend(other._values)
+
+  def remove(self, elem):
+    """Removes an item from the list. Similar to list.remove()."""
+    self._values.remove(elem)
+    self._message_listener.Modified()
+
+  def pop(self, key=-1):
+    """Removes and returns an item at a given index. Similar to list.pop()."""
+    value = self._values[key]
+    self.__delitem__(key)
+    return value
+
+  def __getslice__(self, start, stop):
+    """Retrieves the subset of items from between the specified indices."""
+    return self._values[start:stop]
+
+  def __delitem__(self, key):
+    """Deletes the item at the specified position."""
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __delslice__(self, start, stop):
+    """Deletes the subset of items from between the specified indices."""
+    del self._values[start:stop]
+    self._message_listener.Modified()
+
+  def __eq__(self, other):
+    """Compares the current instance with another one."""
+    if self is other:
+      return True
+    if not isinstance(other, self.__class__):
+      raise TypeError('Can only compare repeated composite fields against '
+                      'other repeated composite fields.')
+    return self._values == other._values
+
+
+class ScalarMap(MutableMapping):
+
+  """Simple, type-checked, dict-like container for holding repeated scalars."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_key_checker', '_value_checker', '_values', '_message_listener',
+               '_entry_descriptor']
+
+  def __init__(self, message_listener, key_checker, value_checker,
+               entry_descriptor):
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The ScalarMap will call this object's Modified() method when it
+        is modified.
+      key_checker: A type_checkers.ValueChecker instance to run on keys
+        inserted into this container.
+      value_checker: A type_checkers.ValueChecker instance to run on values
+        inserted into this container.
+      entry_descriptor: The MessageDescriptor of a map entry: key and value.
+    """
+    self._message_listener = message_listener
+    self._key_checker = key_checker
+    self._value_checker = value_checker
+    self._entry_descriptor = entry_descriptor
+    self._values = {}
+
+  def __getitem__(self, key):
+    try:
+      return self._values[key]
+    except KeyError:
+      key = self._key_checker.CheckValue(key)
+      val = self._value_checker.DefaultValue()
+      self._values[key] = val
+      return val
+
+  def __contains__(self, item):
+    # We check the key's type to match the strong-typing flavor of the API.
+    # Also this makes it easier to match the behavior of the C++ implementation.
+    self._key_checker.CheckValue(item)
+    return item in self._values
+
+  # We need to override this explicitly, because our defaultdict-like behavior
+  # will make the default implementation (from our base class) always insert
+  # the key.
+  def get(self, key, default=None):
+    if key in self:
+      return self[key]
+    else:
+      return default
+
+  def __setitem__(self, key, value):
+    checked_key = self._key_checker.CheckValue(key)
+    checked_value = self._value_checker.CheckValue(value)
+    self._values[checked_key] = checked_value
+    self._message_listener.Modified()
+
+  def __delitem__(self, key):
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __len__(self):
+    return len(self._values)
+
+  def __iter__(self):
+    return iter(self._values)
+
+  def __repr__(self):
+    return repr(self._values)
+
+  def MergeFrom(self, other):
+    self._values.update(other._values)
+    self._message_listener.Modified()
+
+  def InvalidateIterators(self):
+    # It appears that the only way to reliably invalidate iterators to
+    # self._values is to ensure that its size changes.
+    original = self._values
+    self._values = original.copy()
+    original[None] = None
+
+  # This is defined in the abstract base, but we can do it much more cheaply.
+  def clear(self):
+    self._values.clear()
+    self._message_listener.Modified()
+
+  def GetEntryClass(self):
+    return self._entry_descriptor._concrete_class
+
+
+class MessageMap(MutableMapping):
+
+  """Simple, type-checked, dict-like container for with submessage values."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_key_checker', '_values', '_message_listener',
+               '_message_descriptor', '_entry_descriptor']
+
+  def __init__(self, message_listener, message_descriptor, key_checker,
+               entry_descriptor):
+    """
+    Args:
+      message_listener: A MessageListener implementation.
+        The ScalarMap will call this object's Modified() method when it
+        is modified.
+      key_checker: A type_checkers.ValueChecker instance to run on keys
+        inserted into this container.
+      value_checker: A type_checkers.ValueChecker instance to run on values
+        inserted into this container.
+      entry_descriptor: The MessageDescriptor of a map entry: key and value.
+    """
+    self._message_listener = message_listener
+    self._message_descriptor = message_descriptor
+    self._key_checker = key_checker
+    self._entry_descriptor = entry_descriptor
+    self._values = {}
+
+  def __getitem__(self, key):
+    key = self._key_checker.CheckValue(key)
+    try:
+      return self._values[key]
+    except KeyError:
+      new_element = self._message_descriptor._concrete_class()
+      new_element._SetListener(self._message_listener)
+      self._values[key] = new_element
+      self._message_listener.Modified()
+
+      return new_element
+
+  def get_or_create(self, key):
+    """get_or_create() is an alias for getitem (ie. map[key]).
+
+    Args:
+      key: The key to get or create in the map.
+
+    This is useful in cases where you want to be explicit that the call is
+    mutating the map.  This can avoid lint errors for statements like this
+    that otherwise would appear to be pointless statements:
+
+      msg.my_map[key]
+    """
+    return self[key]
+
+  # We need to override this explicitly, because our defaultdict-like behavior
+  # will make the default implementation (from our base class) always insert
+  # the key.
+  def get(self, key, default=None):
+    if key in self:
+      return self[key]
+    else:
+      return default
+
+  def __contains__(self, item):
+    item = self._key_checker.CheckValue(item)
+    return item in self._values
+
+  def __setitem__(self, key, value):
+    raise ValueError('May not set values directly, call my_map[key].foo = 5')
+
+  def __delitem__(self, key):
+    key = self._key_checker.CheckValue(key)
+    del self._values[key]
+    self._message_listener.Modified()
+
+  def __len__(self):
+    return len(self._values)
+
+  def __iter__(self):
+    return iter(self._values)
+
+  def __repr__(self):
+    return repr(self._values)
+
+  def MergeFrom(self, other):
+    # pylint: disable=protected-access
+    for key in other._values:
+      # According to documentation: "When parsing from the wire or when merging,
+      # if there are duplicate map keys the last key seen is used".
+      if key in self:
+        del self[key]
+      self[key].CopyFrom(other[key])
+    # self._message_listener.Modified() not required here, because
+    # mutations to submessages already propagate.
+
+  def InvalidateIterators(self):
+    # It appears that the only way to reliably invalidate iterators to
+    # self._values is to ensure that its size changes.
+    original = self._values
+    self._values = original.copy()
+    original[None] = None
+
+  # This is defined in the abstract base, but we can do it much more cheaply.
+  def clear(self):
+    self._values.clear()
+    self._message_listener.Modified()
+
+  def GetEntryClass(self):
+    return self._entry_descriptor._concrete_class
+
+
+class _UnknownField(object):
+
+  """A parsed unknown field."""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_field_number', '_wire_type', '_data']
+
+  def __init__(self, field_number, wire_type, data):
+    self._field_number = field_number
+    self._wire_type = wire_type
+    self._data = data
+    return
+
+  def __lt__(self, other):
+    # pylint: disable=protected-access
+    return self._field_number < other._field_number
+
+  def __eq__(self, other):
+    if self is other:
+      return True
+    # pylint: disable=protected-access
+    return (self._field_number == other._field_number and
+            self._wire_type == other._wire_type and
+            self._data == other._data)
+
+
+class UnknownFieldRef(object):
+
+  def __init__(self, parent, index):
+    self._parent = parent
+    self._index = index
+    return
+
+  def _check_valid(self):
+    if not self._parent:
+      raise ValueError('UnknownField does not exist. '
+                       'The parent message might be cleared.')
+    if self._index >= len(self._parent):
+      raise ValueError('UnknownField does not exist. '
+                       'The parent message might be cleared.')
+
+  @property
+  def field_number(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._field_number
+
+  @property
+  def wire_type(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._wire_type
+
+  @property
+  def data(self):
+    self._check_valid()
+    # pylint: disable=protected-access
+    return self._parent._internal_get(self._index)._data
+
+
+class UnknownFieldSet(object):
+
+  """UnknownField container"""
+
+  # Disallows assignment to other attributes.
+  __slots__ = ['_values']
+
+  def __init__(self):
+    self._values = []
+
+  def __getitem__(self, index):
+    if self._values is None:
+      raise ValueError('UnknownFields does not exist. '
+                       'The parent message might be cleared.')
+    size = len(self._values)
+    if index < 0:
+      index += size
+    if index < 0 or index >= size:
+      raise IndexError('index %d out of range'.index)
+
+    return UnknownFieldRef(self, index)
+
+  def _internal_get(self, index):
+    return self._values[index]
+
+  def __len__(self):
+    if self._values is None:
+      raise ValueError('UnknownFields does not exist. '
+                       'The parent message might be cleared.')
+    return len(self._values)
+
+  def _add(self, field_number, wire_type, data):
+    unknown_field = _UnknownField(field_number, wire_type, data)
+    self._values.append(unknown_field)
+    return unknown_field
+
+  def __iter__(self):
+    for i in range(len(self)):
+      yield UnknownFieldRef(self, i)
+
+  def _extend(self, other):
+    if other is None:
+      return
+    # pylint: disable=protected-access
+    self._values.extend(other._values)
+
+  def __eq__(self, other):
+    if self is other:
+      return True
+    # Sort unknown fields because their order shouldn't
+    # affect equality test.
+    values = list(self._values)
+    if other is None:
+      return not values
+    values.sort()
+    # pylint: disable=protected-access
+    other_values = sorted(other._values)
+    return values == other_values
+
+  def _clear(self):
+    for value in self._values:
+      # pylint: disable=protected-access
+      if isinstance(value._data, UnknownFieldSet):
+        value._data._clear()  # pylint: disable=protected-access
+    self._values = None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/decoder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/decoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..6804986b6ebe2cd91fa3156503f4d81446967ec6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/decoder.py
@@ -0,0 +1,1057 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Code for decoding protocol buffer primitives.
+
+This code is very similar to encoder.py -- read the docs for that module first.
+
+A "decoder" is a function with the signature:
+  Decode(buffer, pos, end, message, field_dict)
+The arguments are:
+  buffer:     The string containing the encoded message.
+  pos:        The current position in the string.
+  end:        The position in the string where the current message ends.  May be
+              less than len(buffer) if we're reading a sub-message.
+  message:    The message object into which we're parsing.
+  field_dict: message._fields (avoids a hashtable lookup).
+The decoder reads the field and stores it into field_dict, returning the new
+buffer position.  A decoder for a repeated field may proactively decode all of
+the elements of that field, if they appear consecutively.
+
+Note that decoders may throw any of the following:
+  IndexError:  Indicates a truncated message.
+  struct.error:  Unpacking of a fixed-width field failed.
+  message.DecodeError:  Other errors.
+
+Decoders are expected to raise an exception if they are called with pos > end.
+This allows callers to be lax about bounds checking:  it's fineto read past
+"end" as long as you are sure that someone else will notice and throw an
+exception later on.
+
+Something up the call stack is expected to catch IndexError and struct.error
+and convert them to message.DecodeError.
+
+Decoders are constructed using decoder constructors with the signature:
+  MakeDecoder(field_number, is_repeated, is_packed, key, new_default)
+The arguments are:
+  field_number:  The field number of the field we want to decode.
+  is_repeated:   Is the field a repeated field? (bool)
+  is_packed:     Is the field a packed field? (bool)
+  key:           The key to use when looking up the field within field_dict.
+                 (This is actually the FieldDescriptor but nothing in this
+                 file should depend on that.)
+  new_default:   A function which takes a message object as a parameter and
+                 returns a new instance of the default value for this field.
+                 (This is called for repeated fields and sub-messages, when an
+                 instance does not already exist.)
+
+As with encoders, we define a decoder constructor for every type of field.
+Then, for every field of every message class we construct an actual decoder.
+That decoder goes into a dict indexed by tag, so when we decode a message
+we repeatedly read a tag, look up the corresponding decoder, and invoke it.
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+import struct
+import sys
+import six
+
+_UCS2_MAXUNICODE = 65535
+if six.PY3:
+  long = int
+else:
+  import re    # pylint: disable=g-import-not-at-top
+  _SURROGATE_PATTERN = re.compile(six.u(r'[\ud800-\udfff]'))
+
+from google.protobuf.internal import containers
+from google.protobuf.internal import encoder
+from google.protobuf.internal import wire_format
+from google.protobuf import message
+
+
+# This will overflow and thus become IEEE-754 "infinity".  We would use
+# "float('inf')" but it doesn't work on Windows pre-Python-2.6.
+_POS_INF = 1e10000
+_NEG_INF = -_POS_INF
+_NAN = _POS_INF * 0
+
+
+# This is not for optimization, but rather to avoid conflicts with local
+# variables named "message".
+_DecodeError = message.DecodeError
+
+
+def _VarintDecoder(mask, result_type):
+  """Return an encoder for a basic varint value (does not include tag).
+
+  Decoded values will be bitwise-anded with the given mask before being
+  returned, e.g. to limit them to 32 bits.  The returned decoder does not
+  take the usual "end" parameter -- the caller is expected to do bounds checking
+  after the fact (often the caller can defer such checking until later).  The
+  decoder returns a (value, new_pos) pair.
+  """
+
+  def DecodeVarint(buffer, pos):
+    result = 0
+    shift = 0
+    while 1:
+      b = six.indexbytes(buffer, pos)
+      result |= ((b & 0x7f) << shift)
+      pos += 1
+      if not (b & 0x80):
+        result &= mask
+        result = result_type(result)
+        return (result, pos)
+      shift += 7
+      if shift >= 64:
+        raise _DecodeError('Too many bytes when decoding varint.')
+  return DecodeVarint
+
+
+def _SignedVarintDecoder(bits, result_type):
+  """Like _VarintDecoder() but decodes signed values."""
+
+  signbit = 1 << (bits - 1)
+  mask = (1 << bits) - 1
+
+  def DecodeVarint(buffer, pos):
+    result = 0
+    shift = 0
+    while 1:
+      b = six.indexbytes(buffer, pos)
+      result |= ((b & 0x7f) << shift)
+      pos += 1
+      if not (b & 0x80):
+        result &= mask
+        result = (result ^ signbit) - signbit
+        result = result_type(result)
+        return (result, pos)
+      shift += 7
+      if shift >= 64:
+        raise _DecodeError('Too many bytes when decoding varint.')
+  return DecodeVarint
+
+# We force 32-bit values to int and 64-bit values to long to make
+# alternate implementations where the distinction is more significant
+# (e.g. the C++ implementation) simpler.
+
+_DecodeVarint = _VarintDecoder((1 << 64) - 1, long)
+_DecodeSignedVarint = _SignedVarintDecoder(64, long)
+
+# Use these versions for values which must be limited to 32 bits.
+_DecodeVarint32 = _VarintDecoder((1 << 32) - 1, int)
+_DecodeSignedVarint32 = _SignedVarintDecoder(32, int)
+
+
+def ReadTag(buffer, pos):
+  """Read a tag from the memoryview, and return a (tag_bytes, new_pos) tuple.
+
+  We return the raw bytes of the tag rather than decoding them.  The raw
+  bytes can then be used to look up the proper decoder.  This effectively allows
+  us to trade some work that would be done in pure-python (decoding a varint)
+  for work that is done in C (searching for a byte string in a hash table).
+  In a low-level language it would be much cheaper to decode the varint and
+  use that, but not in Python.
+
+  Args:
+    buffer: memoryview object of the encoded bytes
+    pos: int of the current position to start from
+
+  Returns:
+    Tuple[bytes, int] of the tag data and new position.
+  """
+  start = pos
+  while six.indexbytes(buffer, pos) & 0x80:
+    pos += 1
+  pos += 1
+
+  tag_bytes = buffer[start:pos].tobytes()
+  return tag_bytes, pos
+
+
+# --------------------------------------------------------------------
+
+
+def _SimpleDecoder(wire_type, decode_value):
+  """Return a constructor for a decoder for fields of a particular type.
+
+  Args:
+      wire_type:  The field's wire type.
+      decode_value:  A function which decodes an individual value, e.g.
+        _DecodeVarint()
+  """
+
+  def SpecificDecoder(field_number, is_repeated, is_packed, key, new_default,
+                      clear_if_default=False):
+    if is_packed:
+      local_DecodeVarint = _DecodeVarint
+      def DecodePackedField(buffer, pos, end, message, field_dict):
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        (endpoint, pos) = local_DecodeVarint(buffer, pos)
+        endpoint += pos
+        if endpoint > end:
+          raise _DecodeError('Truncated message.')
+        while pos < endpoint:
+          (element, pos) = decode_value(buffer, pos)
+          value.append(element)
+        if pos > endpoint:
+          del value[-1]   # Discard corrupt value.
+          raise _DecodeError('Packed element was truncated.')
+        return pos
+      return DecodePackedField
+    elif is_repeated:
+      tag_bytes = encoder.TagBytes(field_number, wire_type)
+      tag_len = len(tag_bytes)
+      def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        while 1:
+          (element, new_pos) = decode_value(buffer, pos)
+          value.append(element)
+          # Predict that the next tag is another copy of the same repeated
+          # field.
+          pos = new_pos + tag_len
+          if buffer[new_pos:pos] != tag_bytes or new_pos >= end:
+            # Prediction failed.  Return.
+            if new_pos > end:
+              raise _DecodeError('Truncated message.')
+            return new_pos
+      return DecodeRepeatedField
+    else:
+      def DecodeField(buffer, pos, end, message, field_dict):
+        (new_value, pos) = decode_value(buffer, pos)
+        if pos > end:
+          raise _DecodeError('Truncated message.')
+        if clear_if_default and not new_value:
+          field_dict.pop(key, None)
+        else:
+          field_dict[key] = new_value
+        return pos
+      return DecodeField
+
+  return SpecificDecoder
+
+
+def _ModifiedDecoder(wire_type, decode_value, modify_value):
+  """Like SimpleDecoder but additionally invokes modify_value on every value
+  before storing it.  Usually modify_value is ZigZagDecode.
+  """
+
+  # Reusing _SimpleDecoder is slightly slower than copying a bunch of code, but
+  # not enough to make a significant difference.
+
+  def InnerDecode(buffer, pos):
+    (result, new_pos) = decode_value(buffer, pos)
+    return (modify_value(result), new_pos)
+  return _SimpleDecoder(wire_type, InnerDecode)
+
+
+def _StructPackDecoder(wire_type, format):
+  """Return a constructor for a decoder for a fixed-width field.
+
+  Args:
+      wire_type:  The field's wire type.
+      format:  The format string to pass to struct.unpack().
+  """
+
+  value_size = struct.calcsize(format)
+  local_unpack = struct.unpack
+
+  # Reusing _SimpleDecoder is slightly slower than copying a bunch of code, but
+  # not enough to make a significant difference.
+
+  # Note that we expect someone up-stack to catch struct.error and convert
+  # it to _DecodeError -- this way we don't have to set up exception-
+  # handling blocks every time we parse one value.
+
+  def InnerDecode(buffer, pos):
+    new_pos = pos + value_size
+    result = local_unpack(format, buffer[pos:new_pos])[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_type, InnerDecode)
+
+
+def _FloatDecoder():
+  """Returns a decoder for a float field.
+
+  This code works around a bug in struct.unpack for non-finite 32-bit
+  floating-point values.
+  """
+
+  local_unpack = struct.unpack
+
+  def InnerDecode(buffer, pos):
+    """Decode serialized float to a float and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes
+      pos: int, position in the memory view to start at.
+
+    Returns:
+      Tuple[float, int] of the deserialized float value and new position
+      in the serialized data.
+    """
+    # We expect a 32-bit value in little-endian byte order.  Bit 1 is the sign
+    # bit, bits 2-9 represent the exponent, and bits 10-32 are the significand.
+    new_pos = pos + 4
+    float_bytes = buffer[pos:new_pos].tobytes()
+
+    # If this value has all its exponent bits set, then it's non-finite.
+    # In Python 2.4, struct.unpack will convert it to a finite 64-bit value.
+    # To avoid that, we parse it specially.
+    if (float_bytes[3:4] in b'\x7F\xFF' and float_bytes[2:3] >= b'\x80'):
+      # If at least one significand bit is set...
+      if float_bytes[0:3] != b'\x00\x00\x80':
+        return (_NAN, new_pos)
+      # If sign bit is set...
+      if float_bytes[3:4] == b'\xFF':
+        return (_NEG_INF, new_pos)
+      return (_POS_INF, new_pos)
+
+    # Note that we expect someone up-stack to catch struct.error and convert
+    # it to _DecodeError -- this way we don't have to set up exception-
+    # handling blocks every time we parse one value.
+    result = local_unpack('<f', float_bytes)[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_format.WIRETYPE_FIXED32, InnerDecode)
+
+
+def _DoubleDecoder():
+  """Returns a decoder for a double field.
+
+  This code works around a bug in struct.unpack for not-a-number.
+  """
+
+  local_unpack = struct.unpack
+
+  def InnerDecode(buffer, pos):
+    """Decode serialized double to a double and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes.
+      pos: int, position in the memory view to start at.
+
+    Returns:
+      Tuple[float, int] of the decoded double value and new position
+      in the serialized data.
+    """
+    # We expect a 64-bit value in little-endian byte order.  Bit 1 is the sign
+    # bit, bits 2-12 represent the exponent, and bits 13-64 are the significand.
+    new_pos = pos + 8
+    double_bytes = buffer[pos:new_pos].tobytes()
+
+    # If this value has all its exponent bits set and at least one significand
+    # bit set, it's not a number.  In Python 2.4, struct.unpack will treat it
+    # as inf or -inf.  To avoid that, we treat it specially.
+    if ((double_bytes[7:8] in b'\x7F\xFF')
+        and (double_bytes[6:7] >= b'\xF0')
+        and (double_bytes[0:7] != b'\x00\x00\x00\x00\x00\x00\xF0')):
+      return (_NAN, new_pos)
+
+    # Note that we expect someone up-stack to catch struct.error and convert
+    # it to _DecodeError -- this way we don't have to set up exception-
+    # handling blocks every time we parse one value.
+    result = local_unpack('<d', double_bytes)[0]
+    return (result, new_pos)
+  return _SimpleDecoder(wire_format.WIRETYPE_FIXED64, InnerDecode)
+
+
+def EnumDecoder(field_number, is_repeated, is_packed, key, new_default,
+                clear_if_default=False):
+  """Returns a decoder for enum field."""
+  enum_type = key.enum_type
+  if is_packed:
+    local_DecodeVarint = _DecodeVarint
+    def DecodePackedField(buffer, pos, end, message, field_dict):
+      """Decode serialized packed enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      (endpoint, pos) = local_DecodeVarint(buffer, pos)
+      endpoint += pos
+      if endpoint > end:
+        raise _DecodeError('Truncated message.')
+      while pos < endpoint:
+        value_start_pos = pos
+        (element, pos) = _DecodeSignedVarint32(buffer, pos)
+        # pylint: disable=protected-access
+        if element in enum_type.values_by_number:
+          value.append(element)
+        else:
+          if not message._unknown_fields:
+            message._unknown_fields = []
+          tag_bytes = encoder.TagBytes(field_number,
+                                       wire_format.WIRETYPE_VARINT)
+
+          message._unknown_fields.append(
+              (tag_bytes, buffer[value_start_pos:pos].tobytes()))
+          if message._unknown_field_set is None:
+            message._unknown_field_set = containers.UnknownFieldSet()
+          message._unknown_field_set._add(
+              field_number, wire_format.WIRETYPE_VARINT, element)
+          # pylint: enable=protected-access
+      if pos > endpoint:
+        if element in enum_type.values_by_number:
+          del value[-1]   # Discard corrupt value.
+        else:
+          del message._unknown_fields[-1]
+          # pylint: disable=protected-access
+          del message._unknown_field_set._values[-1]
+          # pylint: enable=protected-access
+        raise _DecodeError('Packed element was truncated.')
+      return pos
+    return DecodePackedField
+  elif is_repeated:
+    tag_bytes = encoder.TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      """Decode serialized repeated enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (element, new_pos) = _DecodeSignedVarint32(buffer, pos)
+        # pylint: disable=protected-access
+        if element in enum_type.values_by_number:
+          value.append(element)
+        else:
+          if not message._unknown_fields:
+            message._unknown_fields = []
+          message._unknown_fields.append(
+              (tag_bytes, buffer[pos:new_pos].tobytes()))
+          if message._unknown_field_set is None:
+            message._unknown_field_set = containers.UnknownFieldSet()
+          message._unknown_field_set._add(
+              field_number, wire_format.WIRETYPE_VARINT, element)
+        # pylint: enable=protected-access
+        # Predict that the next tag is another copy of the same repeated
+        # field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos >= end:
+          # Prediction failed.  Return.
+          if new_pos > end:
+            raise _DecodeError('Truncated message.')
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      """Decode serialized repeated enum to its value and a new position.
+
+      Args:
+        buffer: memoryview of the serialized bytes.
+        pos: int, position in the memory view to start at.
+        end: int, end position of serialized data
+        message: Message object to store unknown fields in
+        field_dict: Map[Descriptor, Any] to store decoded values in.
+
+      Returns:
+        int, new position in serialized data.
+      """
+      value_start_pos = pos
+      (enum_value, pos) = _DecodeSignedVarint32(buffer, pos)
+      if pos > end:
+        raise _DecodeError('Truncated message.')
+      if clear_if_default and not enum_value:
+        field_dict.pop(key, None)
+        return pos
+      # pylint: disable=protected-access
+      if enum_value in enum_type.values_by_number:
+        field_dict[key] = enum_value
+      else:
+        if not message._unknown_fields:
+          message._unknown_fields = []
+        tag_bytes = encoder.TagBytes(field_number,
+                                     wire_format.WIRETYPE_VARINT)
+        message._unknown_fields.append(
+            (tag_bytes, buffer[value_start_pos:pos].tobytes()))
+        if message._unknown_field_set is None:
+          message._unknown_field_set = containers.UnknownFieldSet()
+        message._unknown_field_set._add(
+            field_number, wire_format.WIRETYPE_VARINT, enum_value)
+        # pylint: enable=protected-access
+      return pos
+    return DecodeField
+
+
+# --------------------------------------------------------------------
+
+
+Int32Decoder = _SimpleDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeSignedVarint32)
+
+Int64Decoder = _SimpleDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeSignedVarint)
+
+UInt32Decoder = _SimpleDecoder(wire_format.WIRETYPE_VARINT, _DecodeVarint32)
+UInt64Decoder = _SimpleDecoder(wire_format.WIRETYPE_VARINT, _DecodeVarint)
+
+SInt32Decoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint32, wire_format.ZigZagDecode)
+SInt64Decoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint, wire_format.ZigZagDecode)
+
+# Note that Python conveniently guarantees that when using the '<' prefix on
+# formats, they will also have the same size across all platforms (as opposed
+# to without the prefix, where their sizes depend on the C compiler's basic
+# type sizes).
+Fixed32Decoder  = _StructPackDecoder(wire_format.WIRETYPE_FIXED32, '<I')
+Fixed64Decoder  = _StructPackDecoder(wire_format.WIRETYPE_FIXED64, '<Q')
+SFixed32Decoder = _StructPackDecoder(wire_format.WIRETYPE_FIXED32, '<i')
+SFixed64Decoder = _StructPackDecoder(wire_format.WIRETYPE_FIXED64, '<q')
+FloatDecoder = _FloatDecoder()
+DoubleDecoder = _DoubleDecoder()
+
+BoolDecoder = _ModifiedDecoder(
+    wire_format.WIRETYPE_VARINT, _DecodeVarint, bool)
+
+
+def StringDecoder(field_number, is_repeated, is_packed, key, new_default,
+                  is_strict_utf8=False, clear_if_default=False):
+  """Returns a decoder for a string field."""
+
+  local_DecodeVarint = _DecodeVarint
+  local_unicode = six.text_type
+
+  def _ConvertToUnicode(memview):
+    """Convert byte to unicode."""
+    byte_str = memview.tobytes()
+    try:
+      value = local_unicode(byte_str, 'utf-8')
+    except UnicodeDecodeError as e:
+      # add more information to the error message and re-raise it.
+      e.reason = '%s in field: %s' % (e, key.full_name)
+      raise
+
+    if is_strict_utf8 and six.PY2 and sys.maxunicode > _UCS2_MAXUNICODE:
+      # Only do the check for python2 ucs4 when is_strict_utf8 enabled
+      if _SURROGATE_PATTERN.search(value):
+        reason = ('String field %s contains invalid UTF-8 data when parsing'
+                  'a protocol buffer: surrogates not allowed. Use'
+                  'the bytes type if you intend to send raw bytes.') % (
+                      key.full_name)
+        raise message.DecodeError(reason)
+
+    return value
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated string.')
+        value.append(_ConvertToUnicode(buffer[pos:new_pos]))
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated string.')
+      if clear_if_default and not size:
+        field_dict.pop(key, None)
+      else:
+        field_dict[key] = _ConvertToUnicode(buffer[pos:new_pos])
+      return new_pos
+    return DecodeField
+
+
+def BytesDecoder(field_number, is_repeated, is_packed, key, new_default,
+                 clear_if_default=False):
+  """Returns a decoder for a bytes field."""
+
+  local_DecodeVarint = _DecodeVarint
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated string.')
+        value.append(buffer[pos:new_pos].tobytes())
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated string.')
+      if clear_if_default and not size:
+        field_dict.pop(key, None)
+      else:
+        field_dict[key] = buffer[pos:new_pos].tobytes()
+      return new_pos
+    return DecodeField
+
+
+def GroupDecoder(field_number, is_repeated, is_packed, key, new_default):
+  """Returns a decoder for a group field."""
+
+  end_tag_bytes = encoder.TagBytes(field_number,
+                                   wire_format.WIRETYPE_END_GROUP)
+  end_tag_len = len(end_tag_bytes)
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_START_GROUP)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        value = field_dict.get(key)
+        if value is None:
+          value = field_dict.setdefault(key, new_default(message))
+        # Read sub-message.
+        pos = value.add()._InternalParse(buffer, pos, end)
+        # Read end tag.
+        new_pos = pos+end_tag_len
+        if buffer[pos:new_pos] != end_tag_bytes or new_pos > end:
+          raise _DecodeError('Missing group end tag.')
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      # Read sub-message.
+      pos = value._InternalParse(buffer, pos, end)
+      # Read end tag.
+      new_pos = pos+end_tag_len
+      if buffer[pos:new_pos] != end_tag_bytes or new_pos > end:
+        raise _DecodeError('Missing group end tag.')
+      return new_pos
+    return DecodeField
+
+
+def MessageDecoder(field_number, is_repeated, is_packed, key, new_default):
+  """Returns a decoder for a message field."""
+
+  local_DecodeVarint = _DecodeVarint
+
+  assert not is_packed
+  if is_repeated:
+    tag_bytes = encoder.TagBytes(field_number,
+                                 wire_format.WIRETYPE_LENGTH_DELIMITED)
+    tag_len = len(tag_bytes)
+    def DecodeRepeatedField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      while 1:
+        # Read length.
+        (size, pos) = local_DecodeVarint(buffer, pos)
+        new_pos = pos + size
+        if new_pos > end:
+          raise _DecodeError('Truncated message.')
+        # Read sub-message.
+        if value.add()._InternalParse(buffer, pos, new_pos) != new_pos:
+          # The only reason _InternalParse would return early is if it
+          # encountered an end-group tag.
+          raise _DecodeError('Unexpected end-group tag.')
+        # Predict that the next tag is another copy of the same repeated field.
+        pos = new_pos + tag_len
+        if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+          # Prediction failed.  Return.
+          return new_pos
+    return DecodeRepeatedField
+  else:
+    def DecodeField(buffer, pos, end, message, field_dict):
+      value = field_dict.get(key)
+      if value is None:
+        value = field_dict.setdefault(key, new_default(message))
+      # Read length.
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated message.')
+      # Read sub-message.
+      if value._InternalParse(buffer, pos, new_pos) != new_pos:
+        # The only reason _InternalParse would return early is if it encountered
+        # an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+      return new_pos
+    return DecodeField
+
+
+# --------------------------------------------------------------------
+
+MESSAGE_SET_ITEM_TAG = encoder.TagBytes(1, wire_format.WIRETYPE_START_GROUP)
+
+def MessageSetItemDecoder(descriptor):
+  """Returns a decoder for a MessageSet item.
+
+  The parameter is the message Descriptor.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+
+  type_id_tag_bytes = encoder.TagBytes(2, wire_format.WIRETYPE_VARINT)
+  message_tag_bytes = encoder.TagBytes(3, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  item_end_tag_bytes = encoder.TagBytes(1, wire_format.WIRETYPE_END_GROUP)
+
+  local_ReadTag = ReadTag
+  local_DecodeVarint = _DecodeVarint
+  local_SkipField = SkipField
+
+  def DecodeItem(buffer, pos, end, message, field_dict):
+    """Decode serialized message set to its value and new position.
+
+    Args:
+      buffer: memoryview of the serialized bytes.
+      pos: int, position in the memory view to start at.
+      end: int, end position of serialized data
+      message: Message object to store unknown fields in
+      field_dict: Map[Descriptor, Any] to store decoded values in.
+
+    Returns:
+      int, new position in serialized data.
+    """
+    message_set_item_start = pos
+    type_id = -1
+    message_start = -1
+    message_end = -1
+
+    # Technically, type_id and message can appear in any order, so we need
+    # a little loop here.
+    while 1:
+      (tag_bytes, pos) = local_ReadTag(buffer, pos)
+      if tag_bytes == type_id_tag_bytes:
+        (type_id, pos) = local_DecodeVarint(buffer, pos)
+      elif tag_bytes == message_tag_bytes:
+        (size, message_start) = local_DecodeVarint(buffer, pos)
+        pos = message_end = message_start + size
+      elif tag_bytes == item_end_tag_bytes:
+        break
+      else:
+        pos = SkipField(buffer, pos, end, tag_bytes)
+        if pos == -1:
+          raise _DecodeError('Missing group end tag.')
+
+    if pos > end:
+      raise _DecodeError('Truncated message.')
+
+    if type_id == -1:
+      raise _DecodeError('MessageSet item missing type_id.')
+    if message_start == -1:
+      raise _DecodeError('MessageSet item missing message.')
+
+    extension = message.Extensions._FindExtensionByNumber(type_id)
+    # pylint: disable=protected-access
+    if extension is not None:
+      value = field_dict.get(extension)
+      if value is None:
+        message_type = extension.message_type
+        if not hasattr(message_type, '_concrete_class'):
+          # pylint: disable=protected-access
+          message._FACTORY.GetPrototype(message_type)
+        value = field_dict.setdefault(
+            extension, message_type._concrete_class())
+      if value._InternalParse(buffer, message_start,message_end) != message_end:
+        # The only reason _InternalParse would return early is if it encountered
+        # an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+    else:
+      if not message._unknown_fields:
+        message._unknown_fields = []
+      message._unknown_fields.append(
+          (MESSAGE_SET_ITEM_TAG, buffer[message_set_item_start:pos].tobytes()))
+      if message._unknown_field_set is None:
+        message._unknown_field_set = containers.UnknownFieldSet()
+      message._unknown_field_set._add(
+          type_id,
+          wire_format.WIRETYPE_LENGTH_DELIMITED,
+          buffer[message_start:message_end].tobytes())
+      # pylint: enable=protected-access
+
+    return pos
+
+  return DecodeItem
+
+# --------------------------------------------------------------------
+
+def MapDecoder(field_descriptor, new_default, is_message_map):
+  """Returns a decoder for a map field."""
+
+  key = field_descriptor
+  tag_bytes = encoder.TagBytes(field_descriptor.number,
+                               wire_format.WIRETYPE_LENGTH_DELIMITED)
+  tag_len = len(tag_bytes)
+  local_DecodeVarint = _DecodeVarint
+  # Can't read _concrete_class yet; might not be initialized.
+  message_type = field_descriptor.message_type
+
+  def DecodeMap(buffer, pos, end, message, field_dict):
+    submsg = message_type._concrete_class()
+    value = field_dict.get(key)
+    if value is None:
+      value = field_dict.setdefault(key, new_default(message))
+    while 1:
+      # Read length.
+      (size, pos) = local_DecodeVarint(buffer, pos)
+      new_pos = pos + size
+      if new_pos > end:
+        raise _DecodeError('Truncated message.')
+      # Read sub-message.
+      submsg.Clear()
+      if submsg._InternalParse(buffer, pos, new_pos) != new_pos:
+        # The only reason _InternalParse would return early is if it
+        # encountered an end-group tag.
+        raise _DecodeError('Unexpected end-group tag.')
+
+      if is_message_map:
+        value[submsg.key].CopyFrom(submsg.value)
+      else:
+        value[submsg.key] = submsg.value
+
+      # Predict that the next tag is another copy of the same repeated field.
+      pos = new_pos + tag_len
+      if buffer[new_pos:pos] != tag_bytes or new_pos == end:
+        # Prediction failed.  Return.
+        return new_pos
+
+  return DecodeMap
+
+# --------------------------------------------------------------------
+# Optimization is not as heavy here because calls to SkipField() are rare,
+# except for handling end-group tags.
+
+def _SkipVarint(buffer, pos, end):
+  """Skip a varint value.  Returns the new position."""
+  # Previously ord(buffer[pos]) raised IndexError when pos is out of range.
+  # With this code, ord(b'') raises TypeError.  Both are handled in
+  # python_message.py to generate a 'Truncated message' error.
+  while ord(buffer[pos:pos+1].tobytes()) & 0x80:
+    pos += 1
+  pos += 1
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+def _SkipFixed64(buffer, pos, end):
+  """Skip a fixed64 value.  Returns the new position."""
+
+  pos += 8
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _DecodeFixed64(buffer, pos):
+  """Decode a fixed64."""
+  new_pos = pos + 8
+  return (struct.unpack('<Q', buffer[pos:new_pos])[0], new_pos)
+
+
+def _SkipLengthDelimited(buffer, pos, end):
+  """Skip a length-delimited value.  Returns the new position."""
+
+  (size, pos) = _DecodeVarint(buffer, pos)
+  pos += size
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _SkipGroup(buffer, pos, end):
+  """Skip sub-group.  Returns the new position."""
+
+  while 1:
+    (tag_bytes, pos) = ReadTag(buffer, pos)
+    new_pos = SkipField(buffer, pos, end, tag_bytes)
+    if new_pos == -1:
+      return pos
+    pos = new_pos
+
+
+def _DecodeUnknownFieldSet(buffer, pos, end_pos=None):
+  """Decode UnknownFieldSet.  Returns the UnknownFieldSet and new position."""
+
+  unknown_field_set = containers.UnknownFieldSet()
+  while end_pos is None or pos < end_pos:
+    (tag_bytes, pos) = ReadTag(buffer, pos)
+    (tag, _) = _DecodeVarint(tag_bytes, 0)
+    field_number, wire_type = wire_format.UnpackTag(tag)
+    if wire_type == wire_format.WIRETYPE_END_GROUP:
+      break
+    (data, pos) = _DecodeUnknownField(buffer, pos, wire_type)
+    # pylint: disable=protected-access
+    unknown_field_set._add(field_number, wire_type, data)
+
+  return (unknown_field_set, pos)
+
+
+def _DecodeUnknownField(buffer, pos, wire_type):
+  """Decode a unknown field.  Returns the UnknownField and new position."""
+
+  if wire_type == wire_format.WIRETYPE_VARINT:
+    (data, pos) = _DecodeVarint(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_FIXED64:
+    (data, pos) = _DecodeFixed64(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_FIXED32:
+    (data, pos) = _DecodeFixed32(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_LENGTH_DELIMITED:
+    (size, pos) = _DecodeVarint(buffer, pos)
+    data = buffer[pos:pos+size].tobytes()
+    pos += size
+  elif wire_type == wire_format.WIRETYPE_START_GROUP:
+    (data, pos) = _DecodeUnknownFieldSet(buffer, pos)
+  elif wire_type == wire_format.WIRETYPE_END_GROUP:
+    return (0, -1)
+  else:
+    raise _DecodeError('Wrong wire type in tag.')
+
+  return (data, pos)
+
+
+def _EndGroup(buffer, pos, end):
+  """Skipping an END_GROUP tag returns -1 to tell the parent loop to break."""
+
+  return -1
+
+
+def _SkipFixed32(buffer, pos, end):
+  """Skip a fixed32 value.  Returns the new position."""
+
+  pos += 4
+  if pos > end:
+    raise _DecodeError('Truncated message.')
+  return pos
+
+
+def _DecodeFixed32(buffer, pos):
+  """Decode a fixed32."""
+
+  new_pos = pos + 4
+  return (struct.unpack('<I', buffer[pos:new_pos])[0], new_pos)
+
+
+def _RaiseInvalidWireType(buffer, pos, end):
+  """Skip function for unknown wire types.  Raises an exception."""
+
+  raise _DecodeError('Tag had invalid wire type.')
+
+def _FieldSkipper():
+  """Constructs the SkipField function."""
+
+  WIRETYPE_TO_SKIPPER = [
+      _SkipVarint,
+      _SkipFixed64,
+      _SkipLengthDelimited,
+      _SkipGroup,
+      _EndGroup,
+      _SkipFixed32,
+      _RaiseInvalidWireType,
+      _RaiseInvalidWireType,
+      ]
+
+  wiretype_mask = wire_format.TAG_TYPE_MASK
+
+  def SkipField(buffer, pos, end, tag_bytes):
+    """Skips a field with the specified tag.
+
+    |pos| should point to the byte immediately after the tag.
+
+    Returns:
+        The new position (after the tag value), or -1 if the tag is an end-group
+        tag (in which case the calling loop should break).
+    """
+
+    # The wire type is always in the first byte since varints are little-endian.
+    wire_type = ord(tag_bytes[0:1]) & wiretype_mask
+    return WIRETYPE_TO_SKIPPER[wire_type](buffer, pos, end)
+
+  return SkipField
+
+SkipField = _FieldSkipper()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/encoder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/encoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c016f3cfafd2a98d119f3408289b92ab88f45ef
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/encoder.py
@@ -0,0 +1,830 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Code for encoding protocol message primitives.
+
+Contains the logic for encoding every logical protocol field type
+into one of the 5 physical wire types.
+
+This code is designed to push the Python interpreter's performance to the
+limits.
+
+The basic idea is that at startup time, for every field (i.e. every
+FieldDescriptor) we construct two functions:  a "sizer" and an "encoder".  The
+sizer takes a value of this field's type and computes its byte size.  The
+encoder takes a writer function and a value.  It encodes the value into byte
+strings and invokes the writer function to write those strings.  Typically the
+writer function is the write() method of a BytesIO.
+
+We try to do as much work as possible when constructing the writer and the
+sizer rather than when calling them.  In particular:
+* We copy any needed global functions to local variables, so that we do not need
+  to do costly global table lookups at runtime.
+* Similarly, we try to do any attribute lookups at startup time if possible.
+* Every field's tag is encoded to bytes at startup, since it can't change at
+  runtime.
+* Whatever component of the field size we can compute at startup, we do.
+* We *avoid* sharing code if doing so would make the code slower and not sharing
+  does not burden us too much.  For example, encoders for repeated fields do
+  not just call the encoders for singular fields in a loop because this would
+  add an extra function call overhead for every loop iteration; instead, we
+  manually inline the single-value encoder into the loop.
+* If a Python function lacks a return statement, Python actually generates
+  instructions to pop the result of the last statement off the stack, push
+  None onto the stack, and then return that.  If we really don't care what
+  value is returned, then we can save two instructions by returning the
+  result of the last statement.  It looks funny but it helps.
+* We assume that type and bounds checking has happened at a higher level.
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+import struct
+
+import six
+
+from google.protobuf.internal import wire_format
+
+
+# This will overflow and thus become IEEE-754 "infinity".  We would use
+# "float('inf')" but it doesn't work on Windows pre-Python-2.6.
+_POS_INF = 1e10000
+_NEG_INF = -_POS_INF
+
+
+def _VarintSize(value):
+  """Compute the size of a varint value."""
+  if value <= 0x7f: return 1
+  if value <= 0x3fff: return 2
+  if value <= 0x1fffff: return 3
+  if value <= 0xfffffff: return 4
+  if value <= 0x7ffffffff: return 5
+  if value <= 0x3ffffffffff: return 6
+  if value <= 0x1ffffffffffff: return 7
+  if value <= 0xffffffffffffff: return 8
+  if value <= 0x7fffffffffffffff: return 9
+  return 10
+
+
+def _SignedVarintSize(value):
+  """Compute the size of a signed varint value."""
+  if value < 0: return 10
+  if value <= 0x7f: return 1
+  if value <= 0x3fff: return 2
+  if value <= 0x1fffff: return 3
+  if value <= 0xfffffff: return 4
+  if value <= 0x7ffffffff: return 5
+  if value <= 0x3ffffffffff: return 6
+  if value <= 0x1ffffffffffff: return 7
+  if value <= 0xffffffffffffff: return 8
+  if value <= 0x7fffffffffffffff: return 9
+  return 10
+
+
+def _TagSize(field_number):
+  """Returns the number of bytes required to serialize a tag with this field
+  number."""
+  # Just pass in type 0, since the type won't affect the tag+type size.
+  return _VarintSize(wire_format.PackTag(field_number, 0))
+
+
+# --------------------------------------------------------------------
+# In this section we define some generic sizers.  Each of these functions
+# takes parameters specific to a particular field type, e.g. int32 or fixed64.
+# It returns another function which in turn takes parameters specific to a
+# particular field, e.g. the field number and whether it is repeated or packed.
+# Look at the next section to see how these are used.
+
+
+def _SimpleSizer(compute_value_size):
+  """A sizer which uses the function compute_value_size to compute the size of
+  each value.  Typically compute_value_size is _VarintSize."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = 0
+        for element in value:
+          result += compute_value_size(element)
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      def RepeatedFieldSize(value):
+        result = tag_size * len(value)
+        for element in value:
+          result += compute_value_size(element)
+        return result
+      return RepeatedFieldSize
+    else:
+      def FieldSize(value):
+        return tag_size + compute_value_size(value)
+      return FieldSize
+
+  return SpecificSizer
+
+
+def _ModifiedSizer(compute_value_size, modify_value):
+  """Like SimpleSizer, but modify_value is invoked on each value before it is
+  passed to compute_value_size.  modify_value is typically ZigZagEncode."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = 0
+        for element in value:
+          result += compute_value_size(modify_value(element))
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      def RepeatedFieldSize(value):
+        result = tag_size * len(value)
+        for element in value:
+          result += compute_value_size(modify_value(element))
+        return result
+      return RepeatedFieldSize
+    else:
+      def FieldSize(value):
+        return tag_size + compute_value_size(modify_value(value))
+      return FieldSize
+
+  return SpecificSizer
+
+
+def _FixedSizer(value_size):
+  """Like _SimpleSizer except for a fixed-size field.  The input is the size
+  of one value."""
+
+  def SpecificSizer(field_number, is_repeated, is_packed):
+    tag_size = _TagSize(field_number)
+    if is_packed:
+      local_VarintSize = _VarintSize
+      def PackedFieldSize(value):
+        result = len(value) * value_size
+        return result + local_VarintSize(result) + tag_size
+      return PackedFieldSize
+    elif is_repeated:
+      element_size = value_size + tag_size
+      def RepeatedFieldSize(value):
+        return len(value) * element_size
+      return RepeatedFieldSize
+    else:
+      field_size = value_size + tag_size
+      def FieldSize(value):
+        return field_size
+      return FieldSize
+
+  return SpecificSizer
+
+
+# ====================================================================
+# Here we declare a sizer constructor for each field type.  Each "sizer
+# constructor" is a function that takes (field_number, is_repeated, is_packed)
+# as parameters and returns a sizer, which in turn takes a field value as
+# a parameter and returns its encoded size.
+
+
+Int32Sizer = Int64Sizer = EnumSizer = _SimpleSizer(_SignedVarintSize)
+
+UInt32Sizer = UInt64Sizer = _SimpleSizer(_VarintSize)
+
+SInt32Sizer = SInt64Sizer = _ModifiedSizer(
+    _SignedVarintSize, wire_format.ZigZagEncode)
+
+Fixed32Sizer = SFixed32Sizer = FloatSizer  = _FixedSizer(4)
+Fixed64Sizer = SFixed64Sizer = DoubleSizer = _FixedSizer(8)
+
+BoolSizer = _FixedSizer(1)
+
+
+def StringSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a string field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = local_len(element.encode('utf-8'))
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = local_len(value.encode('utf-8'))
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+def BytesSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a bytes field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = local_len(element)
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = local_len(value)
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+def GroupSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a group field."""
+
+  tag_size = _TagSize(field_number) * 2
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        result += element.ByteSize()
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      return tag_size + value.ByteSize()
+    return FieldSize
+
+
+def MessageSizer(field_number, is_repeated, is_packed):
+  """Returns a sizer for a message field."""
+
+  tag_size = _TagSize(field_number)
+  local_VarintSize = _VarintSize
+  assert not is_packed
+  if is_repeated:
+    def RepeatedFieldSize(value):
+      result = tag_size * len(value)
+      for element in value:
+        l = element.ByteSize()
+        result += local_VarintSize(l) + l
+      return result
+    return RepeatedFieldSize
+  else:
+    def FieldSize(value):
+      l = value.ByteSize()
+      return tag_size + local_VarintSize(l) + l
+    return FieldSize
+
+
+# --------------------------------------------------------------------
+# MessageSet is special: it needs custom logic to compute its size properly.
+
+
+def MessageSetItemSizer(field_number):
+  """Returns a sizer for extensions of MessageSet.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+  static_size = (_TagSize(1) * 2 + _TagSize(2) + _VarintSize(field_number) +
+                 _TagSize(3))
+  local_VarintSize = _VarintSize
+
+  def FieldSize(value):
+    l = value.ByteSize()
+    return static_size + local_VarintSize(l) + l
+
+  return FieldSize
+
+
+# --------------------------------------------------------------------
+# Map is special: it needs custom logic to compute its size properly.
+
+
+def MapSizer(field_descriptor, is_message_map):
+  """Returns a sizer for a map field."""
+
+  # Can't look at field_descriptor.message_type._concrete_class because it may
+  # not have been initialized yet.
+  message_type = field_descriptor.message_type
+  message_sizer = MessageSizer(field_descriptor.number, False, False)
+
+  def FieldSize(map_value):
+    total = 0
+    for key in map_value:
+      value = map_value[key]
+      # It's wasteful to create the messages and throw them away one second
+      # later since we'll do the same for the actual encode.  But there's not an
+      # obvious way to avoid this within the current design without tons of code
+      # duplication. For message map, value.ByteSize() should be called to
+      # update the status.
+      entry_msg = message_type._concrete_class(key=key, value=value)
+      total += message_sizer(entry_msg)
+      if is_message_map:
+        value.ByteSize()
+    return total
+
+  return FieldSize
+
+# ====================================================================
+# Encoders!
+
+
+def _VarintEncoder():
+  """Return an encoder for a basic varint value (does not include tag)."""
+
+  local_int2byte = six.int2byte
+  def EncodeVarint(write, value, unused_deterministic=None):
+    bits = value & 0x7f
+    value >>= 7
+    while value:
+      write(local_int2byte(0x80|bits))
+      bits = value & 0x7f
+      value >>= 7
+    return write(local_int2byte(bits))
+
+  return EncodeVarint
+
+
+def _SignedVarintEncoder():
+  """Return an encoder for a basic signed varint value (does not include
+  tag)."""
+
+  local_int2byte = six.int2byte
+  def EncodeSignedVarint(write, value, unused_deterministic=None):
+    if value < 0:
+      value += (1 << 64)
+    bits = value & 0x7f
+    value >>= 7
+    while value:
+      write(local_int2byte(0x80|bits))
+      bits = value & 0x7f
+      value >>= 7
+    return write(local_int2byte(bits))
+
+  return EncodeSignedVarint
+
+
+_EncodeVarint = _VarintEncoder()
+_EncodeSignedVarint = _SignedVarintEncoder()
+
+
+def _VarintBytes(value):
+  """Encode the given integer as a varint and return the bytes.  This is only
+  called at startup time so it doesn't need to be fast."""
+
+  pieces = []
+  _EncodeVarint(pieces.append, value, True)
+  return b"".join(pieces)
+
+
+def TagBytes(field_number, wire_type):
+  """Encode the given tag and return the bytes.  Only called at startup."""
+
+  return six.binary_type(
+      _VarintBytes(wire_format.PackTag(field_number, wire_type)))
+
+# --------------------------------------------------------------------
+# As with sizers (see above), we have a number of common encoder
+# implementations.
+
+
+def _SimpleEncoder(wire_type, encode_value, compute_value_size):
+  """Return a constructor for an encoder for fields of a particular type.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      encode_value:  A function which encodes an individual value, e.g.
+        _EncodeVarint().
+      compute_value_size:  A function which computes the size of an individual
+        value, e.g. _VarintSize().
+  """
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        size = 0
+        for element in value:
+          size += compute_value_size(element)
+        local_EncodeVarint(write, size, deterministic)
+        for element in value:
+          encode_value(write, element, deterministic)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, deterministic):
+        for element in value:
+          write(tag_bytes)
+          encode_value(write, element, deterministic)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, deterministic):
+        write(tag_bytes)
+        return encode_value(write, value, deterministic)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _ModifiedEncoder(wire_type, encode_value, compute_value_size, modify_value):
+  """Like SimpleEncoder but additionally invokes modify_value on every value
+  before passing it to encode_value.  Usually modify_value is ZigZagEncode."""
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        size = 0
+        for element in value:
+          size += compute_value_size(modify_value(element))
+        local_EncodeVarint(write, size, deterministic)
+        for element in value:
+          encode_value(write, modify_value(element), deterministic)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, deterministic):
+        for element in value:
+          write(tag_bytes)
+          encode_value(write, modify_value(element), deterministic)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, deterministic):
+        write(tag_bytes)
+        return encode_value(write, modify_value(value), deterministic)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _StructPackEncoder(wire_type, format):
+  """Return a constructor for an encoder for a fixed-width field.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      format:  The format string to pass to struct.pack().
+  """
+
+  value_size = struct.calcsize(format)
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    local_struct_pack = struct.pack
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        local_EncodeVarint(write, len(value) * value_size, deterministic)
+        for element in value:
+          write(local_struct_pack(format, element))
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, unused_deterministic=None):
+        for element in value:
+          write(tag_bytes)
+          write(local_struct_pack(format, element))
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, unused_deterministic=None):
+        write(tag_bytes)
+        return write(local_struct_pack(format, value))
+      return EncodeField
+
+  return SpecificEncoder
+
+
+def _FloatingPointEncoder(wire_type, format):
+  """Return a constructor for an encoder for float fields.
+
+  This is like StructPackEncoder, but catches errors that may be due to
+  passing non-finite floating-point values to struct.pack, and makes a
+  second attempt to encode those values.
+
+  Args:
+      wire_type:  The field's wire type, for encoding tags.
+      format:  The format string to pass to struct.pack().
+  """
+
+  value_size = struct.calcsize(format)
+  if value_size == 4:
+    def EncodeNonFiniteOrRaise(write, value):
+      # Remember that the serialized form uses little-endian byte order.
+      if value == _POS_INF:
+        write(b'\x00\x00\x80\x7F')
+      elif value == _NEG_INF:
+        write(b'\x00\x00\x80\xFF')
+      elif value != value:           # NaN
+        write(b'\x00\x00\xC0\x7F')
+      else:
+        raise
+  elif value_size == 8:
+    def EncodeNonFiniteOrRaise(write, value):
+      if value == _POS_INF:
+        write(b'\x00\x00\x00\x00\x00\x00\xF0\x7F')
+      elif value == _NEG_INF:
+        write(b'\x00\x00\x00\x00\x00\x00\xF0\xFF')
+      elif value != value:                         # NaN
+        write(b'\x00\x00\x00\x00\x00\x00\xF8\x7F')
+      else:
+        raise
+  else:
+    raise ValueError('Can\'t encode floating-point values that are '
+                     '%d bytes long (only 4 or 8)' % value_size)
+
+  def SpecificEncoder(field_number, is_repeated, is_packed):
+    local_struct_pack = struct.pack
+    if is_packed:
+      tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+      local_EncodeVarint = _EncodeVarint
+      def EncodePackedField(write, value, deterministic):
+        write(tag_bytes)
+        local_EncodeVarint(write, len(value) * value_size, deterministic)
+        for element in value:
+          # This try/except block is going to be faster than any code that
+          # we could write to check whether element is finite.
+          try:
+            write(local_struct_pack(format, element))
+          except SystemError:
+            EncodeNonFiniteOrRaise(write, element)
+      return EncodePackedField
+    elif is_repeated:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeRepeatedField(write, value, unused_deterministic=None):
+        for element in value:
+          write(tag_bytes)
+          try:
+            write(local_struct_pack(format, element))
+          except SystemError:
+            EncodeNonFiniteOrRaise(write, element)
+      return EncodeRepeatedField
+    else:
+      tag_bytes = TagBytes(field_number, wire_type)
+      def EncodeField(write, value, unused_deterministic=None):
+        write(tag_bytes)
+        try:
+          write(local_struct_pack(format, value))
+        except SystemError:
+          EncodeNonFiniteOrRaise(write, value)
+      return EncodeField
+
+  return SpecificEncoder
+
+
+# ====================================================================
+# Here we declare an encoder constructor for each field type.  These work
+# very similarly to sizer constructors, described earlier.
+
+
+Int32Encoder = Int64Encoder = EnumEncoder = _SimpleEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeSignedVarint, _SignedVarintSize)
+
+UInt32Encoder = UInt64Encoder = _SimpleEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeVarint, _VarintSize)
+
+SInt32Encoder = SInt64Encoder = _ModifiedEncoder(
+    wire_format.WIRETYPE_VARINT, _EncodeVarint, _VarintSize,
+    wire_format.ZigZagEncode)
+
+# Note that Python conveniently guarantees that when using the '<' prefix on
+# formats, they will also have the same size across all platforms (as opposed
+# to without the prefix, where their sizes depend on the C compiler's basic
+# type sizes).
+Fixed32Encoder  = _StructPackEncoder(wire_format.WIRETYPE_FIXED32, '<I')
+Fixed64Encoder  = _StructPackEncoder(wire_format.WIRETYPE_FIXED64, '<Q')
+SFixed32Encoder = _StructPackEncoder(wire_format.WIRETYPE_FIXED32, '<i')
+SFixed64Encoder = _StructPackEncoder(wire_format.WIRETYPE_FIXED64, '<q')
+FloatEncoder    = _FloatingPointEncoder(wire_format.WIRETYPE_FIXED32, '<f')
+DoubleEncoder   = _FloatingPointEncoder(wire_format.WIRETYPE_FIXED64, '<d')
+
+
+def BoolEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a boolean field."""
+
+  false_byte = b'\x00'
+  true_byte = b'\x01'
+  if is_packed:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+    local_EncodeVarint = _EncodeVarint
+    def EncodePackedField(write, value, deterministic):
+      write(tag_bytes)
+      local_EncodeVarint(write, len(value), deterministic)
+      for element in value:
+        if element:
+          write(true_byte)
+        else:
+          write(false_byte)
+    return EncodePackedField
+  elif is_repeated:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    def EncodeRepeatedField(write, value, unused_deterministic=None):
+      for element in value:
+        write(tag_bytes)
+        if element:
+          write(true_byte)
+        else:
+          write(false_byte)
+    return EncodeRepeatedField
+  else:
+    tag_bytes = TagBytes(field_number, wire_format.WIRETYPE_VARINT)
+    def EncodeField(write, value, unused_deterministic=None):
+      write(tag_bytes)
+      if value:
+        return write(true_byte)
+      return write(false_byte)
+    return EncodeField
+
+
+def StringEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a string field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        encoded = element.encode('utf-8')
+        write(tag)
+        local_EncodeVarint(write, local_len(encoded), deterministic)
+        write(encoded)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      encoded = value.encode('utf-8')
+      write(tag)
+      local_EncodeVarint(write, local_len(encoded), deterministic)
+      return write(encoded)
+    return EncodeField
+
+
+def BytesEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a bytes field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  local_len = len
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(tag)
+        local_EncodeVarint(write, local_len(element), deterministic)
+        write(element)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(tag)
+      local_EncodeVarint(write, local_len(value), deterministic)
+      return write(value)
+    return EncodeField
+
+
+def GroupEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a group field."""
+
+  start_tag = TagBytes(field_number, wire_format.WIRETYPE_START_GROUP)
+  end_tag = TagBytes(field_number, wire_format.WIRETYPE_END_GROUP)
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(start_tag)
+        element._InternalSerialize(write, deterministic)
+        write(end_tag)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(start_tag)
+      value._InternalSerialize(write, deterministic)
+      return write(end_tag)
+    return EncodeField
+
+
+def MessageEncoder(field_number, is_repeated, is_packed):
+  """Returns an encoder for a message field."""
+
+  tag = TagBytes(field_number, wire_format.WIRETYPE_LENGTH_DELIMITED)
+  local_EncodeVarint = _EncodeVarint
+  assert not is_packed
+  if is_repeated:
+    def EncodeRepeatedField(write, value, deterministic):
+      for element in value:
+        write(tag)
+        local_EncodeVarint(write, element.ByteSize(), deterministic)
+        element._InternalSerialize(write, deterministic)
+    return EncodeRepeatedField
+  else:
+    def EncodeField(write, value, deterministic):
+      write(tag)
+      local_EncodeVarint(write, value.ByteSize(), deterministic)
+      return value._InternalSerialize(write, deterministic)
+    return EncodeField
+
+
+# --------------------------------------------------------------------
+# As before, MessageSet is special.
+
+
+def MessageSetItemEncoder(field_number):
+  """Encoder for extensions of MessageSet.
+
+  The message set message looks like this:
+    message MessageSet {
+      repeated group Item = 1 {
+        required int32 type_id = 2;
+        required string message = 3;
+      }
+    }
+  """
+  start_bytes = b"".join([
+      TagBytes(1, wire_format.WIRETYPE_START_GROUP),
+      TagBytes(2, wire_format.WIRETYPE_VARINT),
+      _VarintBytes(field_number),
+      TagBytes(3, wire_format.WIRETYPE_LENGTH_DELIMITED)])
+  end_bytes = TagBytes(1, wire_format.WIRETYPE_END_GROUP)
+  local_EncodeVarint = _EncodeVarint
+
+  def EncodeField(write, value, deterministic):
+    write(start_bytes)
+    local_EncodeVarint(write, value.ByteSize(), deterministic)
+    value._InternalSerialize(write, deterministic)
+    return write(end_bytes)
+
+  return EncodeField
+
+
+# --------------------------------------------------------------------
+# As before, Map is special.
+
+
+def MapEncoder(field_descriptor):
+  """Encoder for extensions of MessageSet.
+
+  Maps always have a wire format like this:
+    message MapEntry {
+      key_type key = 1;
+      value_type value = 2;
+    }
+    repeated MapEntry map = N;
+  """
+  # Can't look at field_descriptor.message_type._concrete_class because it may
+  # not have been initialized yet.
+  message_type = field_descriptor.message_type
+  encode_message = MessageEncoder(field_descriptor.number, False, False)
+
+  def EncodeField(write, value, deterministic):
+    value_keys = sorted(value.keys()) if deterministic else value
+    for key in value_keys:
+      entry_msg = message_type._concrete_class(key=key, value=value[key])
+      encode_message(write, entry_msg, deterministic)
+
+  return EncodeField
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/enum_type_wrapper.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/enum_type_wrapper.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ae00665849902a4505ab8d11ae591aeaace6158
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/enum_type_wrapper.py
@@ -0,0 +1,117 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""A simple wrapper around enum types to expose utility functions.
+
+Instances are created as properties with the same name as the enum they wrap
+on proto classes.  For usage, see:
+  reflection_test.py
+"""
+
+__author__ = 'rabsatt@google.com (Kevin Rabsatt)'
+
+import six
+
+
+class EnumTypeWrapper(object):
+  """A utility for finding the names of enum values."""
+
+  DESCRIPTOR = None
+
+  def __init__(self, enum_type):
+    """Inits EnumTypeWrapper with an EnumDescriptor."""
+    self._enum_type = enum_type
+    self.DESCRIPTOR = enum_type  # pylint: disable=invalid-name
+
+  def Name(self, number):  # pylint: disable=invalid-name
+    """Returns a string containing the name of an enum value."""
+    try:
+      return self._enum_type.values_by_number[number].name
+    except KeyError:
+      pass  # fall out to break exception chaining
+
+    if not isinstance(number, six.integer_types):
+      raise TypeError(
+          'Enum value for {} must be an int, but got {} {!r}.'.format(
+              self._enum_type.name, type(number), number))
+    else:
+      # repr here to handle the odd case when you pass in a boolean.
+      raise ValueError('Enum {} has no name defined for value {!r}'.format(
+          self._enum_type.name, number))
+
+  def Value(self, name):  # pylint: disable=invalid-name
+    """Returns the value corresponding to the given enum name."""
+    try:
+      return self._enum_type.values_by_name[name].number
+    except KeyError:
+      pass  # fall out to break exception chaining
+    raise ValueError('Enum {} has no value defined for name {!r}'.format(
+        self._enum_type.name, name))
+
+  def keys(self):
+    """Return a list of the string names in the enum.
+
+    Returns:
+      A list of strs, in the order they were defined in the .proto file.
+    """
+
+    return [value_descriptor.name
+            for value_descriptor in self._enum_type.values]
+
+  def values(self):
+    """Return a list of the integer values in the enum.
+
+    Returns:
+      A list of ints, in the order they were defined in the .proto file.
+    """
+
+    return [value_descriptor.number
+            for value_descriptor in self._enum_type.values]
+
+  def items(self):
+    """Return a list of the (name, value) pairs of the enum.
+
+    Returns:
+      A list of (str, int) pairs, in the order they were defined
+      in the .proto file.
+    """
+    return [(value_descriptor.name, value_descriptor.number)
+            for value_descriptor in self._enum_type.values]
+
+  def __getattr__(self, name):
+    """Returns the value corresponding to the given enum name."""
+    try:
+      return super(
+          EnumTypeWrapper,
+          self).__getattribute__('_enum_type').values_by_name[name].number
+    except KeyError:
+      pass  # fall out to break exception chaining
+    raise AttributeError('Enum {} has no value defined for name {!r}'.format(
+        self._enum_type.name, name))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/extension_dict.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/extension_dict.py
new file mode 100644
index 0000000000000000000000000000000000000000..b346cf283e2ca7d76306d99ecf153d61709fd1ea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/extension_dict.py
@@ -0,0 +1,213 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains _ExtensionDict class to represent extensions.
+"""
+
+from google.protobuf.internal import type_checkers
+from google.protobuf.descriptor import FieldDescriptor
+
+
+def _VerifyExtensionHandle(message, extension_handle):
+  """Verify that the given extension handle is valid."""
+
+  if not isinstance(extension_handle, FieldDescriptor):
+    raise KeyError('HasExtension() expects an extension handle, got: %s' %
+                   extension_handle)
+
+  if not extension_handle.is_extension:
+    raise KeyError('"%s" is not an extension.' % extension_handle.full_name)
+
+  if not extension_handle.containing_type:
+    raise KeyError('"%s" is missing a containing_type.'
+                   % extension_handle.full_name)
+
+  if extension_handle.containing_type is not message.DESCRIPTOR:
+    raise KeyError('Extension "%s" extends message type "%s", but this '
+                   'message is of type "%s".' %
+                   (extension_handle.full_name,
+                    extension_handle.containing_type.full_name,
+                    message.DESCRIPTOR.full_name))
+
+
+# TODO(robinson): Unify error handling of "unknown extension" crap.
+# TODO(robinson): Support iteritems()-style iteration over all
+# extensions with the "has" bits turned on?
+class _ExtensionDict(object):
+
+  """Dict-like container for Extension fields on proto instances.
+
+  Note that in all cases we expect extension handles to be
+  FieldDescriptors.
+  """
+
+  def __init__(self, extended_message):
+    """
+    Args:
+      extended_message: Message instance for which we are the Extensions dict.
+    """
+    self._extended_message = extended_message
+
+  def __getitem__(self, extension_handle):
+    """Returns the current value of the given extension handle."""
+
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    result = self._extended_message._fields.get(extension_handle)
+    if result is not None:
+      return result
+
+    if extension_handle.label == FieldDescriptor.LABEL_REPEATED:
+      result = extension_handle._default_constructor(self._extended_message)
+    elif extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+      message_type = extension_handle.message_type
+      if not hasattr(message_type, '_concrete_class'):
+        # pylint: disable=protected-access
+        self._extended_message._FACTORY.GetPrototype(message_type)
+      assert getattr(extension_handle.message_type, '_concrete_class', None), (
+          'Uninitialized concrete class found for field %r (message type %r)'
+          % (extension_handle.full_name,
+             extension_handle.message_type.full_name))
+      result = extension_handle.message_type._concrete_class()
+      try:
+        result._SetListener(self._extended_message._listener_for_children)
+      except ReferenceError:
+        pass
+    else:
+      # Singular scalar -- just return the default without inserting into the
+      # dict.
+      return extension_handle.default_value
+
+    # Atomically check if another thread has preempted us and, if not, swap
+    # in the new object we just created.  If someone has preempted us, we
+    # take that object and discard ours.
+    # WARNING:  We are relying on setdefault() being atomic.  This is true
+    #   in CPython but we haven't investigated others.  This warning appears
+    #   in several other locations in this file.
+    result = self._extended_message._fields.setdefault(
+        extension_handle, result)
+
+    return result
+
+  def __eq__(self, other):
+    if not isinstance(other, self.__class__):
+      return False
+
+    my_fields = self._extended_message.ListFields()
+    other_fields = other._extended_message.ListFields()
+
+    # Get rid of non-extension fields.
+    my_fields = [field for field in my_fields if field.is_extension]
+    other_fields = [field for field in other_fields if field.is_extension]
+
+    return my_fields == other_fields
+
+  def __ne__(self, other):
+    return not self == other
+
+  def __len__(self):
+    fields = self._extended_message.ListFields()
+    # Get rid of non-extension fields.
+    extension_fields = [field for field in fields if field[0].is_extension]
+    return len(extension_fields)
+
+  def __hash__(self):
+    raise TypeError('unhashable object')
+
+  # Note that this is only meaningful for non-repeated, scalar extension
+  # fields.  Note also that we may have to call _Modified() when we do
+  # successfully set a field this way, to set any necessary "has" bits in the
+  # ancestors of the extended message.
+  def __setitem__(self, extension_handle, value):
+    """If extension_handle specifies a non-repeated, scalar extension
+    field, sets the value of that field.
+    """
+
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    if (extension_handle.label == FieldDescriptor.LABEL_REPEATED or
+        extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE):
+      raise TypeError(
+          'Cannot assign to extension "%s" because it is a repeated or '
+          'composite type.' % extension_handle.full_name)
+
+    # It's slightly wasteful to lookup the type checker each time,
+    # but we expect this to be a vanishingly uncommon case anyway.
+    type_checker = type_checkers.GetTypeChecker(extension_handle)
+    # pylint: disable=protected-access
+    self._extended_message._fields[extension_handle] = (
+        type_checker.CheckValue(value))
+    self._extended_message._Modified()
+
+  def __delitem__(self, extension_handle):
+    self._extended_message.ClearExtension(extension_handle)
+
+  def _FindExtensionByName(self, name):
+    """Tries to find a known extension with the specified name.
+
+    Args:
+      name: Extension full name.
+
+    Returns:
+      Extension field descriptor.
+    """
+    return self._extended_message._extensions_by_name.get(name, None)
+
+  def _FindExtensionByNumber(self, number):
+    """Tries to find a known extension with the field number.
+
+    Args:
+      number: Extension field number.
+
+    Returns:
+      Extension field descriptor.
+    """
+    return self._extended_message._extensions_by_number.get(number, None)
+
+  def __iter__(self):
+    # Return a generator over the populated extension fields
+    return (f[0] for f in self._extended_message.ListFields()
+            if f[0].is_extension)
+
+  def __contains__(self, extension_handle):
+    _VerifyExtensionHandle(self._extended_message, extension_handle)
+
+    if extension_handle not in self._extended_message._fields:
+      return False
+
+    if extension_handle.label == FieldDescriptor.LABEL_REPEATED:
+      return bool(self._extended_message._fields.get(extension_handle))
+
+    if extension_handle.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+      value = self._extended_message._fields.get(extension_handle)
+      # pylint: disable=protected-access
+      return value is not None and value._is_present_in_parent
+
+    return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/message_listener.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/message_listener.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fc255a774563473edb7c0c4315d5a60a98b419a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/message_listener.py
@@ -0,0 +1,78 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Defines a listener interface for observing certain
+state transitions on Message objects.
+
+Also defines a null implementation of this interface.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+
+class MessageListener(object):
+
+  """Listens for modifications made to a message.  Meant to be registered via
+  Message._SetListener().
+
+  Attributes:
+    dirty:  If True, then calling Modified() would be a no-op.  This can be
+            used to avoid these calls entirely in the common case.
+  """
+
+  def Modified(self):
+    """Called every time the message is modified in such a way that the parent
+    message may need to be updated.  This currently means either:
+    (a) The message was modified for the first time, so the parent message
+        should henceforth mark the message as present.
+    (b) The message's cached byte size became dirty -- i.e. the message was
+        modified for the first time after a previous call to ByteSize().
+        Therefore the parent should also mark its byte size as dirty.
+    Note that (a) implies (b), since new objects start out with a client cached
+    size (zero).  However, we document (a) explicitly because it is important.
+
+    Modified() will *only* be called in response to one of these two events --
+    not every time the sub-message is modified.
+
+    Note that if the listener's |dirty| attribute is true, then calling
+    Modified at the moment would be a no-op, so it can be skipped.  Performance-
+    sensitive callers should check this attribute directly before calling since
+    it will be true most of the time.
+    """
+
+    raise NotImplementedError
+
+
+class NullMessageListener(object):
+
+  """No-op MessageListener implementation."""
+
+  def Modified(self):
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/python_message.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/python_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1f4dcde8e5e6f061122ad1efc39d641a00c5205
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/python_message.py
@@ -0,0 +1,1547 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# This code is meant to work on Python 2.4 and above only.
+#
+# TODO(robinson): Helpers for verbose, common checks like seeing if a
+# descriptor's cpp_type is CPPTYPE_MESSAGE.
+
+"""Contains a metaclass and helper functions used to create
+protocol message classes from Descriptor objects at runtime.
+
+Recall that a metaclass is the "type" of a class.
+(A class is to a metaclass what an instance is to a class.)
+
+In this case, we use the GeneratedProtocolMessageType metaclass
+to inject all the useful functionality into the classes
+output by the protocol compiler at compile-time.
+
+The upshot of all this is that the real implementation
+details for ALL pure-Python protocol buffers are *here in
+this file*.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+from io import BytesIO
+import struct
+import sys
+import weakref
+
+import six
+from six.moves import range
+
+# We use "as" to avoid name collisions with variables.
+from google.protobuf.internal import api_implementation
+from google.protobuf.internal import containers
+from google.protobuf.internal import decoder
+from google.protobuf.internal import encoder
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf.internal import extension_dict
+from google.protobuf.internal import message_listener as message_listener_mod
+from google.protobuf.internal import type_checkers
+from google.protobuf.internal import well_known_types
+from google.protobuf.internal import wire_format
+from google.protobuf import descriptor as descriptor_mod
+from google.protobuf import message as message_mod
+from google.protobuf import text_format
+
+_FieldDescriptor = descriptor_mod.FieldDescriptor
+_AnyFullTypeName = 'google.protobuf.Any'
+_ExtensionDict = extension_dict._ExtensionDict
+
+class GeneratedProtocolMessageType(type):
+
+  """Metaclass for protocol message classes created at runtime from Descriptors.
+
+  We add implementations for all methods described in the Message class.  We
+  also create properties to allow getting/setting all fields in the protocol
+  message.  Finally, we create slots to prevent users from accidentally
+  "setting" nonexistent fields in the protocol message, which then wouldn't get
+  serialized / deserialized properly.
+
+  The protocol compiler currently uses this metaclass to create protocol
+  message classes at runtime.  Clients can also manually create their own
+  classes at runtime, as in this example:
+
+  mydescriptor = Descriptor(.....)
+  factory = symbol_database.Default()
+  factory.pool.AddDescriptor(mydescriptor)
+  MyProtoClass = factory.GetPrototype(mydescriptor)
+  myproto_instance = MyProtoClass()
+  myproto.foo_field = 23
+  ...
+  """
+
+  # Must be consistent with the protocol-compiler code in
+  # proto2/compiler/internal/generator.*.
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __new__(cls, name, bases, dictionary):
+    """Custom allocation for runtime-generated class types.
+
+    We override __new__ because this is apparently the only place
+    where we can meaningfully set __slots__ on the class we're creating(?).
+    (The interplay between metaclasses and slots is not very well-documented).
+
+    Args:
+      name: Name of the class (ignored, but required by the
+        metaclass protocol).
+      bases: Base classes of the class we're constructing.
+        (Should be message.Message).  We ignore this field, but
+        it's required by the metaclass protocol
+      dictionary: The class dictionary of the class we're
+        constructing.  dictionary[_DESCRIPTOR_KEY] must contain
+        a Descriptor object describing this protocol message
+        type.
+
+    Returns:
+      Newly-allocated class.
+
+    Raises:
+      RuntimeError: Generated code only work with python cpp extension.
+    """
+    descriptor = dictionary[GeneratedProtocolMessageType._DESCRIPTOR_KEY]
+
+    if isinstance(descriptor, str):
+      raise RuntimeError('The generated code only work with python cpp '
+                         'extension, but it is using pure python runtime.')
+
+    # If a concrete class already exists for this descriptor, don't try to
+    # create another.  Doing so will break any messages that already exist with
+    # the existing class.
+    #
+    # The C++ implementation appears to have its own internal `PyMessageFactory`
+    # to achieve similar results.
+    #
+    # This most commonly happens in `text_format.py` when using descriptors from
+    # a custom pool; it calls symbol_database.Global().getPrototype() on a
+    # descriptor which already has an existing concrete class.
+    new_class = getattr(descriptor, '_concrete_class', None)
+    if new_class:
+      return new_class
+
+    if descriptor.full_name in well_known_types.WKTBASES:
+      bases += (well_known_types.WKTBASES[descriptor.full_name],)
+    _AddClassAttributesForNestedExtensions(descriptor, dictionary)
+    _AddSlots(descriptor, dictionary)
+
+    superclass = super(GeneratedProtocolMessageType, cls)
+    new_class = superclass.__new__(cls, name, bases, dictionary)
+    return new_class
+
+  def __init__(cls, name, bases, dictionary):
+    """Here we perform the majority of our work on the class.
+    We add enum getters, an __init__ method, implementations
+    of all Message methods, and properties for all fields
+    in the protocol type.
+
+    Args:
+      name: Name of the class (ignored, but required by the
+        metaclass protocol).
+      bases: Base classes of the class we're constructing.
+        (Should be message.Message).  We ignore this field, but
+        it's required by the metaclass protocol
+      dictionary: The class dictionary of the class we're
+        constructing.  dictionary[_DESCRIPTOR_KEY] must contain
+        a Descriptor object describing this protocol message
+        type.
+    """
+    descriptor = dictionary[GeneratedProtocolMessageType._DESCRIPTOR_KEY]
+
+    # If this is an _existing_ class looked up via `_concrete_class` in the
+    # __new__ method above, then we don't need to re-initialize anything.
+    existing_class = getattr(descriptor, '_concrete_class', None)
+    if existing_class:
+      assert existing_class is cls, (
+          'Duplicate `GeneratedProtocolMessageType` created for descriptor %r'
+          % (descriptor.full_name))
+      return
+
+    cls._decoders_by_tag = {}
+    if (descriptor.has_options and
+        descriptor.GetOptions().message_set_wire_format):
+      cls._decoders_by_tag[decoder.MESSAGE_SET_ITEM_TAG] = (
+          decoder.MessageSetItemDecoder(descriptor), None)
+
+    # Attach stuff to each FieldDescriptor for quick lookup later on.
+    for field in descriptor.fields:
+      _AttachFieldHelpers(cls, field)
+
+    descriptor._concrete_class = cls  # pylint: disable=protected-access
+    _AddEnumValues(descriptor, cls)
+    _AddInitMethod(descriptor, cls)
+    _AddPropertiesForFields(descriptor, cls)
+    _AddPropertiesForExtensions(descriptor, cls)
+    _AddStaticMethods(cls)
+    _AddMessageMethods(descriptor, cls)
+    _AddPrivateHelperMethods(descriptor, cls)
+
+    superclass = super(GeneratedProtocolMessageType, cls)
+    superclass.__init__(name, bases, dictionary)
+
+
+# Stateless helpers for GeneratedProtocolMessageType below.
+# Outside clients should not access these directly.
+#
+# I opted not to make any of these methods on the metaclass, to make it more
+# clear that I'm not really using any state there and to keep clients from
+# thinking that they have direct access to these construction helpers.
+
+
+def _PropertyName(proto_field_name):
+  """Returns the name of the public property attribute which
+  clients can use to get and (in some cases) set the value
+  of a protocol message field.
+
+  Args:
+    proto_field_name: The protocol message field name, exactly
+      as it appears (or would appear) in a .proto file.
+  """
+  # TODO(robinson): Escape Python keywords (e.g., yield), and test this support.
+  # nnorwitz makes my day by writing:
+  # """
+  # FYI.  See the keyword module in the stdlib. This could be as simple as:
+  #
+  # if keyword.iskeyword(proto_field_name):
+  #   return proto_field_name + "_"
+  # return proto_field_name
+  # """
+  # Kenton says:  The above is a BAD IDEA.  People rely on being able to use
+  #   getattr() and setattr() to reflectively manipulate field values.  If we
+  #   rename the properties, then every such user has to also make sure to apply
+  #   the same transformation.  Note that currently if you name a field "yield",
+  #   you can still access it just fine using getattr/setattr -- it's not even
+  #   that cumbersome to do so.
+  # TODO(kenton):  Remove this method entirely if/when everyone agrees with my
+  #   position.
+  return proto_field_name
+
+
+def _AddSlots(message_descriptor, dictionary):
+  """Adds a __slots__ entry to dictionary, containing the names of all valid
+  attributes for this message type.
+
+  Args:
+    message_descriptor: A Descriptor instance describing this message type.
+    dictionary: Class dictionary to which we'll add a '__slots__' entry.
+  """
+  dictionary['__slots__'] = ['_cached_byte_size',
+                             '_cached_byte_size_dirty',
+                             '_fields',
+                             '_unknown_fields',
+                             '_unknown_field_set',
+                             '_is_present_in_parent',
+                             '_listener',
+                             '_listener_for_children',
+                             '__weakref__',
+                             '_oneofs']
+
+
+def _IsMessageSetExtension(field):
+  return (field.is_extension and
+          field.containing_type.has_options and
+          field.containing_type.GetOptions().message_set_wire_format and
+          field.type == _FieldDescriptor.TYPE_MESSAGE and
+          field.label == _FieldDescriptor.LABEL_OPTIONAL)
+
+
+def _IsMapField(field):
+  return (field.type == _FieldDescriptor.TYPE_MESSAGE and
+          field.message_type.has_options and
+          field.message_type.GetOptions().map_entry)
+
+
+def _IsMessageMapField(field):
+  value_type = field.message_type.fields_by_name['value']
+  return value_type.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE
+
+
+def _IsStrictUtf8Check(field):
+  if field.containing_type.syntax != 'proto3':
+    return False
+  enforce_utf8 = True
+  return enforce_utf8
+
+
+def _AttachFieldHelpers(cls, field_descriptor):
+  is_repeated = (field_descriptor.label == _FieldDescriptor.LABEL_REPEATED)
+  is_packable = (is_repeated and
+                 wire_format.IsTypePackable(field_descriptor.type))
+  is_proto3 = field_descriptor.containing_type.syntax == 'proto3'
+  if not is_packable:
+    is_packed = False
+  elif field_descriptor.containing_type.syntax == 'proto2':
+    is_packed = (field_descriptor.has_options and
+                field_descriptor.GetOptions().packed)
+  else:
+    has_packed_false = (field_descriptor.has_options and
+                        field_descriptor.GetOptions().HasField('packed') and
+                        field_descriptor.GetOptions().packed == False)
+    is_packed = not has_packed_false
+  is_map_entry = _IsMapField(field_descriptor)
+
+  if is_map_entry:
+    field_encoder = encoder.MapEncoder(field_descriptor)
+    sizer = encoder.MapSizer(field_descriptor,
+                             _IsMessageMapField(field_descriptor))
+  elif _IsMessageSetExtension(field_descriptor):
+    field_encoder = encoder.MessageSetItemEncoder(field_descriptor.number)
+    sizer = encoder.MessageSetItemSizer(field_descriptor.number)
+  else:
+    field_encoder = type_checkers.TYPE_TO_ENCODER[field_descriptor.type](
+        field_descriptor.number, is_repeated, is_packed)
+    sizer = type_checkers.TYPE_TO_SIZER[field_descriptor.type](
+        field_descriptor.number, is_repeated, is_packed)
+
+  field_descriptor._encoder = field_encoder
+  field_descriptor._sizer = sizer
+  field_descriptor._default_constructor = _DefaultValueConstructorForField(
+      field_descriptor)
+
+  def AddDecoder(wiretype, is_packed):
+    tag_bytes = encoder.TagBytes(field_descriptor.number, wiretype)
+    decode_type = field_descriptor.type
+    if (decode_type == _FieldDescriptor.TYPE_ENUM and
+        type_checkers.SupportsOpenEnums(field_descriptor)):
+      decode_type = _FieldDescriptor.TYPE_INT32
+
+    oneof_descriptor = None
+    clear_if_default = False
+    if field_descriptor.containing_oneof is not None:
+      oneof_descriptor = field_descriptor
+    elif (is_proto3 and not is_repeated and
+          field_descriptor.cpp_type != _FieldDescriptor.CPPTYPE_MESSAGE):
+      clear_if_default = True
+
+    if is_map_entry:
+      is_message_map = _IsMessageMapField(field_descriptor)
+
+      field_decoder = decoder.MapDecoder(
+          field_descriptor, _GetInitializeDefaultForMap(field_descriptor),
+          is_message_map)
+    elif decode_type == _FieldDescriptor.TYPE_STRING:
+      is_strict_utf8_check = _IsStrictUtf8Check(field_descriptor)
+      field_decoder = decoder.StringDecoder(
+          field_descriptor.number, is_repeated, is_packed,
+          field_descriptor, field_descriptor._default_constructor,
+          is_strict_utf8_check, clear_if_default)
+    elif field_descriptor.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      field_decoder = type_checkers.TYPE_TO_DECODER[decode_type](
+          field_descriptor.number, is_repeated, is_packed,
+          field_descriptor, field_descriptor._default_constructor)
+    else:
+      field_decoder = type_checkers.TYPE_TO_DECODER[decode_type](
+          field_descriptor.number, is_repeated, is_packed,
+          # pylint: disable=protected-access
+          field_descriptor, field_descriptor._default_constructor,
+          clear_if_default)
+
+    cls._decoders_by_tag[tag_bytes] = (field_decoder, oneof_descriptor)
+
+  AddDecoder(type_checkers.FIELD_TYPE_TO_WIRE_TYPE[field_descriptor.type],
+             False)
+
+  if is_repeated and wire_format.IsTypePackable(field_descriptor.type):
+    # To support wire compatibility of adding packed = true, add a decoder for
+    # packed values regardless of the field's options.
+    AddDecoder(wire_format.WIRETYPE_LENGTH_DELIMITED, True)
+
+
+def _AddClassAttributesForNestedExtensions(descriptor, dictionary):
+  extensions = descriptor.extensions_by_name
+  for extension_name, extension_field in extensions.items():
+    assert extension_name not in dictionary
+    dictionary[extension_name] = extension_field
+
+
+def _AddEnumValues(descriptor, cls):
+  """Sets class-level attributes for all enum fields defined in this message.
+
+  Also exporting a class-level object that can name enum values.
+
+  Args:
+    descriptor: Descriptor object for this message type.
+    cls: Class we're constructing for this message type.
+  """
+  for enum_type in descriptor.enum_types:
+    setattr(cls, enum_type.name, enum_type_wrapper.EnumTypeWrapper(enum_type))
+    for enum_value in enum_type.values:
+      setattr(cls, enum_value.name, enum_value.number)
+
+
+def _GetInitializeDefaultForMap(field):
+  if field.label != _FieldDescriptor.LABEL_REPEATED:
+    raise ValueError('map_entry set on non-repeated field %s' % (
+        field.name))
+  fields_by_name = field.message_type.fields_by_name
+  key_checker = type_checkers.GetTypeChecker(fields_by_name['key'])
+
+  value_field = fields_by_name['value']
+  if _IsMessageMapField(field):
+    def MakeMessageMapDefault(message):
+      return containers.MessageMap(
+          message._listener_for_children, value_field.message_type, key_checker,
+          field.message_type)
+    return MakeMessageMapDefault
+  else:
+    value_checker = type_checkers.GetTypeChecker(value_field)
+    def MakePrimitiveMapDefault(message):
+      return containers.ScalarMap(
+          message._listener_for_children, key_checker, value_checker,
+          field.message_type)
+    return MakePrimitiveMapDefault
+
+def _DefaultValueConstructorForField(field):
+  """Returns a function which returns a default value for a field.
+
+  Args:
+    field: FieldDescriptor object for this field.
+
+  The returned function has one argument:
+    message: Message instance containing this field, or a weakref proxy
+      of same.
+
+  That function in turn returns a default value for this field.  The default
+    value may refer back to |message| via a weak reference.
+  """
+
+  if _IsMapField(field):
+    return _GetInitializeDefaultForMap(field)
+
+  if field.label == _FieldDescriptor.LABEL_REPEATED:
+    if field.has_default_value and field.default_value != []:
+      raise ValueError('Repeated field default value not empty list: %s' % (
+          field.default_value))
+    if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      # We can't look at _concrete_class yet since it might not have
+      # been set.  (Depends on order in which we initialize the classes).
+      message_type = field.message_type
+      def MakeRepeatedMessageDefault(message):
+        return containers.RepeatedCompositeFieldContainer(
+            message._listener_for_children, field.message_type)
+      return MakeRepeatedMessageDefault
+    else:
+      type_checker = type_checkers.GetTypeChecker(field)
+      def MakeRepeatedScalarDefault(message):
+        return containers.RepeatedScalarFieldContainer(
+            message._listener_for_children, type_checker)
+      return MakeRepeatedScalarDefault
+
+  if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    # _concrete_class may not yet be initialized.
+    message_type = field.message_type
+    def MakeSubMessageDefault(message):
+      assert getattr(message_type, '_concrete_class', None), (
+          'Uninitialized concrete class found for field %r (message type %r)'
+          % (field.full_name, message_type.full_name))
+      result = message_type._concrete_class()
+      result._SetListener(
+          _OneofListener(message, field)
+          if field.containing_oneof is not None
+          else message._listener_for_children)
+      return result
+    return MakeSubMessageDefault
+
+  def MakeScalarDefault(message):
+    # TODO(protobuf-team): This may be broken since there may not be
+    # default_value.  Combine with has_default_value somehow.
+    return field.default_value
+  return MakeScalarDefault
+
+
+def _ReraiseTypeErrorWithFieldName(message_name, field_name):
+  """Re-raise the currently-handled TypeError with the field name added."""
+  exc = sys.exc_info()[1]
+  if len(exc.args) == 1 and type(exc) is TypeError:
+    # simple TypeError; add field name to exception message
+    exc = TypeError('%s for field %s.%s' % (str(exc), message_name, field_name))
+
+  # re-raise possibly-amended exception with original traceback:
+  six.reraise(type(exc), exc, sys.exc_info()[2])
+
+
+def _AddInitMethod(message_descriptor, cls):
+  """Adds an __init__ method to cls."""
+
+  def _GetIntegerEnumValue(enum_type, value):
+    """Convert a string or integer enum value to an integer.
+
+    If the value is a string, it is converted to the enum value in
+    enum_type with the same name.  If the value is not a string, it's
+    returned as-is.  (No conversion or bounds-checking is done.)
+    """
+    if isinstance(value, six.string_types):
+      try:
+        return enum_type.values_by_name[value].number
+      except KeyError:
+        raise ValueError('Enum type %s: unknown label "%s"' % (
+            enum_type.full_name, value))
+    return value
+
+  def init(self, **kwargs):
+    self._cached_byte_size = 0
+    self._cached_byte_size_dirty = len(kwargs) > 0
+    self._fields = {}
+    # Contains a mapping from oneof field descriptors to the descriptor
+    # of the currently set field in that oneof field.
+    self._oneofs = {}
+
+    # _unknown_fields is () when empty for efficiency, and will be turned into
+    # a list if fields are added.
+    self._unknown_fields = ()
+    # _unknown_field_set is None when empty for efficiency, and will be
+    # turned into UnknownFieldSet struct if fields are added.
+    self._unknown_field_set = None      # pylint: disable=protected-access
+    self._is_present_in_parent = False
+    self._listener = message_listener_mod.NullMessageListener()
+    self._listener_for_children = _Listener(self)
+    for field_name, field_value in kwargs.items():
+      field = _GetFieldByName(message_descriptor, field_name)
+      if field is None:
+        raise TypeError('%s() got an unexpected keyword argument "%s"' %
+                        (message_descriptor.name, field_name))
+      if field_value is None:
+        # field=None is the same as no field at all.
+        continue
+      if field.label == _FieldDescriptor.LABEL_REPEATED:
+        copy = field._default_constructor(self)
+        if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:  # Composite
+          if _IsMapField(field):
+            if _IsMessageMapField(field):
+              for key in field_value:
+                copy[key].MergeFrom(field_value[key])
+            else:
+              copy.update(field_value)
+          else:
+            for val in field_value:
+              if isinstance(val, dict):
+                copy.add(**val)
+              else:
+                copy.add().MergeFrom(val)
+        else:  # Scalar
+          if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+            field_value = [_GetIntegerEnumValue(field.enum_type, val)
+                           for val in field_value]
+          copy.extend(field_value)
+        self._fields[field] = copy
+      elif field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        copy = field._default_constructor(self)
+        new_val = field_value
+        if isinstance(field_value, dict):
+          new_val = field.message_type._concrete_class(**field_value)
+        try:
+          copy.MergeFrom(new_val)
+        except TypeError:
+          _ReraiseTypeErrorWithFieldName(message_descriptor.name, field_name)
+        self._fields[field] = copy
+      else:
+        if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+          field_value = _GetIntegerEnumValue(field.enum_type, field_value)
+        try:
+          setattr(self, field_name, field_value)
+        except TypeError:
+          _ReraiseTypeErrorWithFieldName(message_descriptor.name, field_name)
+
+  init.__module__ = None
+  init.__doc__ = None
+  cls.__init__ = init
+
+
+def _GetFieldByName(message_descriptor, field_name):
+  """Returns a field descriptor by field name.
+
+  Args:
+    message_descriptor: A Descriptor describing all fields in message.
+    field_name: The name of the field to retrieve.
+  Returns:
+    The field descriptor associated with the field name.
+  """
+  try:
+    return message_descriptor.fields_by_name[field_name]
+  except KeyError:
+    raise ValueError('Protocol message %s has no "%s" field.' %
+                     (message_descriptor.name, field_name))
+
+
+def _AddPropertiesForFields(descriptor, cls):
+  """Adds properties for all fields in this protocol message type."""
+  for field in descriptor.fields:
+    _AddPropertiesForField(field, cls)
+
+  if descriptor.is_extendable:
+    # _ExtensionDict is just an adaptor with no state so we allocate a new one
+    # every time it is accessed.
+    cls.Extensions = property(lambda self: _ExtensionDict(self))
+
+
+def _AddPropertiesForField(field, cls):
+  """Adds a public property for a protocol message field.
+  Clients can use this property to get and (in the case
+  of non-repeated scalar fields) directly set the value
+  of a protocol message field.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  # Catch it if we add other types that we should
+  # handle specially here.
+  assert _FieldDescriptor.MAX_CPPTYPE == 10
+
+  constant_name = field.name.upper() + '_FIELD_NUMBER'
+  setattr(cls, constant_name, field.number)
+
+  if field.label == _FieldDescriptor.LABEL_REPEATED:
+    _AddPropertiesForRepeatedField(field, cls)
+  elif field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    _AddPropertiesForNonRepeatedCompositeField(field, cls)
+  else:
+    _AddPropertiesForNonRepeatedScalarField(field, cls)
+
+
+class _FieldProperty(property):
+  __slots__ = ('DESCRIPTOR',)
+
+  def __init__(self, descriptor, getter, setter, doc):
+    property.__init__(self, getter, setter, doc=doc)
+    self.DESCRIPTOR = descriptor
+
+
+def _AddPropertiesForRepeatedField(field, cls):
+  """Adds a public property for a "repeated" protocol message field.  Clients
+  can use this property to get the value of the field, which will be either a
+  RepeatedScalarFieldContainer or RepeatedCompositeFieldContainer (see
+  below).
+
+  Note that when clients add values to these containers, we perform
+  type-checking in the case of repeated scalar fields, and we also set any
+  necessary "has" bits as a side-effect.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+
+  def getter(self):
+    field_value = self._fields.get(field)
+    if field_value is None:
+      # Construct a new object to represent this field.
+      field_value = field._default_constructor(self)
+
+      # Atomically check if another thread has preempted us and, if not, swap
+      # in the new object we just created.  If someone has preempted us, we
+      # take that object and discard ours.
+      # WARNING:  We are relying on setdefault() being atomic.  This is true
+      #   in CPython but we haven't investigated others.  This warning appears
+      #   in several other locations in this file.
+      field_value = self._fields.setdefault(field, field_value)
+    return field_value
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  # We define a setter just so we can throw an exception with a more
+  # helpful error message.
+  def setter(self, new_value):
+    raise AttributeError('Assignment not allowed to repeated field '
+                         '"%s" in protocol message object.' % proto_field_name)
+
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForNonRepeatedScalarField(field, cls):
+  """Adds a public property for a nonrepeated, scalar protocol message field.
+  Clients can use this property to get and directly set the value of the field.
+  Note that when the client sets the value of a field by using this property,
+  all necessary "has" bits are set as a side-effect, and we also perform
+  type-checking.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+  type_checker = type_checkers.GetTypeChecker(field)
+  default_value = field.default_value
+  is_proto3 = field.containing_type.syntax == 'proto3'
+
+  def getter(self):
+    # TODO(protobuf-team): This may be broken since there may not be
+    # default_value.  Combine with has_default_value somehow.
+    return self._fields.get(field, default_value)
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  clear_when_set_to_default = is_proto3 and not field.containing_oneof
+
+  def field_setter(self, new_value):
+    # pylint: disable=protected-access
+    # Testing the value for truthiness captures all of the proto3 defaults
+    # (0, 0.0, enum 0, and False).
+    try:
+      new_value = type_checker.CheckValue(new_value)
+    except TypeError as e:
+      raise TypeError(
+          'Cannot set %s to %.1024r: %s' % (field.full_name, new_value, e))
+    if clear_when_set_to_default and not new_value:
+      self._fields.pop(field, None)
+    else:
+      self._fields[field] = new_value
+    # Check _cached_byte_size_dirty inline to improve performance, since scalar
+    # setters are called frequently.
+    if not self._cached_byte_size_dirty:
+      self._Modified()
+
+  if field.containing_oneof:
+    def setter(self, new_value):
+      field_setter(self, new_value)
+      self._UpdateOneofState(field)
+  else:
+    setter = field_setter
+
+  setter.__module__ = None
+  setter.__doc__ = 'Setter for %s.' % proto_field_name
+
+  # Add a property to encapsulate the getter/setter.
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForNonRepeatedCompositeField(field, cls):
+  """Adds a public property for a nonrepeated, composite protocol message field.
+  A composite field is a "group" or "message" field.
+
+  Clients can use this property to get the value of the field, but cannot
+  assign to the property directly.
+
+  Args:
+    field: A FieldDescriptor for this field.
+    cls: The class we're constructing.
+  """
+  # TODO(robinson): Remove duplication with similar method
+  # for non-repeated scalars.
+  proto_field_name = field.name
+  property_name = _PropertyName(proto_field_name)
+
+  def getter(self):
+    field_value = self._fields.get(field)
+    if field_value is None:
+      # Construct a new object to represent this field.
+      field_value = field._default_constructor(self)
+
+      # Atomically check if another thread has preempted us and, if not, swap
+      # in the new object we just created.  If someone has preempted us, we
+      # take that object and discard ours.
+      # WARNING:  We are relying on setdefault() being atomic.  This is true
+      #   in CPython but we haven't investigated others.  This warning appears
+      #   in several other locations in this file.
+      field_value = self._fields.setdefault(field, field_value)
+    return field_value
+  getter.__module__ = None
+  getter.__doc__ = 'Getter for %s.' % proto_field_name
+
+  # We define a setter just so we can throw an exception with a more
+  # helpful error message.
+  def setter(self, new_value):
+    raise AttributeError('Assignment not allowed to composite field '
+                         '"%s" in protocol message object.' % proto_field_name)
+
+  # Add a property to encapsulate the getter.
+  doc = 'Magic attribute generated for "%s" proto field.' % proto_field_name
+  setattr(cls, property_name, _FieldProperty(field, getter, setter, doc=doc))
+
+
+def _AddPropertiesForExtensions(descriptor, cls):
+  """Adds properties for all fields in this protocol message type."""
+  extensions = descriptor.extensions_by_name
+  for extension_name, extension_field in extensions.items():
+    constant_name = extension_name.upper() + '_FIELD_NUMBER'
+    setattr(cls, constant_name, extension_field.number)
+
+  # TODO(amauryfa): Migrate all users of these attributes to functions like
+  #   pool.FindExtensionByNumber(descriptor).
+  if descriptor.file is not None:
+    # TODO(amauryfa): Use cls.MESSAGE_FACTORY.pool when available.
+    pool = descriptor.file.pool
+    cls._extensions_by_number = pool._extensions_by_number[descriptor]
+    cls._extensions_by_name = pool._extensions_by_name[descriptor]
+
+def _AddStaticMethods(cls):
+  # TODO(robinson): This probably needs to be thread-safe(?)
+  def RegisterExtension(extension_handle):
+    extension_handle.containing_type = cls.DESCRIPTOR
+    # TODO(amauryfa): Use cls.MESSAGE_FACTORY.pool when available.
+    # pylint: disable=protected-access
+    cls.DESCRIPTOR.file.pool._AddExtensionDescriptor(extension_handle)
+    _AttachFieldHelpers(cls, extension_handle)
+  cls.RegisterExtension = staticmethod(RegisterExtension)
+
+  def FromString(s):
+    message = cls()
+    message.MergeFromString(s)
+    return message
+  cls.FromString = staticmethod(FromString)
+
+
+def _IsPresent(item):
+  """Given a (FieldDescriptor, value) tuple from _fields, return true if the
+  value should be included in the list returned by ListFields()."""
+
+  if item[0].label == _FieldDescriptor.LABEL_REPEATED:
+    return bool(item[1])
+  elif item[0].cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+    return item[1]._is_present_in_parent
+  else:
+    return True
+
+
+def _AddListFieldsMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def ListFields(self):
+    all_fields = [item for item in self._fields.items() if _IsPresent(item)]
+    all_fields.sort(key = lambda item: item[0].number)
+    return all_fields
+
+  cls.ListFields = ListFields
+
+_PROTO3_ERROR_TEMPLATE = \
+  ('Protocol message %s has no non-repeated submessage field "%s" '
+   'nor marked as optional')
+_PROTO2_ERROR_TEMPLATE = 'Protocol message %s has no non-repeated field "%s"'
+
+def _AddHasFieldMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  is_proto3 = (message_descriptor.syntax == "proto3")
+  error_msg = _PROTO3_ERROR_TEMPLATE if is_proto3 else _PROTO2_ERROR_TEMPLATE
+
+  hassable_fields = {}
+  for field in message_descriptor.fields:
+    if field.label == _FieldDescriptor.LABEL_REPEATED:
+      continue
+    # For proto3, only submessages and fields inside a oneof have presence.
+    if (is_proto3 and field.cpp_type != _FieldDescriptor.CPPTYPE_MESSAGE and
+        not field.containing_oneof):
+      continue
+    hassable_fields[field.name] = field
+
+  # Has methods are supported for oneof descriptors.
+  for oneof in message_descriptor.oneofs:
+    hassable_fields[oneof.name] = oneof
+
+  def HasField(self, field_name):
+    try:
+      field = hassable_fields[field_name]
+    except KeyError:
+      raise ValueError(error_msg % (message_descriptor.full_name, field_name))
+
+    if isinstance(field, descriptor_mod.OneofDescriptor):
+      try:
+        return HasField(self, self._oneofs[field].name)
+      except KeyError:
+        return False
+    else:
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        value = self._fields.get(field)
+        return value is not None and value._is_present_in_parent
+      else:
+        return field in self._fields
+
+  cls.HasField = HasField
+
+
+def _AddClearFieldMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def ClearField(self, field_name):
+    try:
+      field = message_descriptor.fields_by_name[field_name]
+    except KeyError:
+      try:
+        field = message_descriptor.oneofs_by_name[field_name]
+        if field in self._oneofs:
+          field = self._oneofs[field]
+        else:
+          return
+      except KeyError:
+        raise ValueError('Protocol message %s has no "%s" field.' %
+                         (message_descriptor.name, field_name))
+
+    if field in self._fields:
+      # To match the C++ implementation, we need to invalidate iterators
+      # for map fields when ClearField() happens.
+      if hasattr(self._fields[field], 'InvalidateIterators'):
+        self._fields[field].InvalidateIterators()
+
+      # Note:  If the field is a sub-message, its listener will still point
+      #   at us.  That's fine, because the worst than can happen is that it
+      #   will call _Modified() and invalidate our byte size.  Big deal.
+      del self._fields[field]
+
+      if self._oneofs.get(field.containing_oneof, None) is field:
+        del self._oneofs[field.containing_oneof]
+
+    # Always call _Modified() -- even if nothing was changed, this is
+    # a mutating method, and thus calling it should cause the field to become
+    # present in the parent message.
+    self._Modified()
+
+  cls.ClearField = ClearField
+
+
+def _AddClearExtensionMethod(cls):
+  """Helper for _AddMessageMethods()."""
+  def ClearExtension(self, extension_handle):
+    extension_dict._VerifyExtensionHandle(self, extension_handle)
+
+    # Similar to ClearField(), above.
+    if extension_handle in self._fields:
+      del self._fields[extension_handle]
+    self._Modified()
+  cls.ClearExtension = ClearExtension
+
+
+def _AddHasExtensionMethod(cls):
+  """Helper for _AddMessageMethods()."""
+  def HasExtension(self, extension_handle):
+    extension_dict._VerifyExtensionHandle(self, extension_handle)
+    if extension_handle.label == _FieldDescriptor.LABEL_REPEATED:
+      raise KeyError('"%s" is repeated.' % extension_handle.full_name)
+
+    if extension_handle.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      value = self._fields.get(extension_handle)
+      return value is not None and value._is_present_in_parent
+    else:
+      return extension_handle in self._fields
+  cls.HasExtension = HasExtension
+
+def _InternalUnpackAny(msg):
+  """Unpacks Any message and returns the unpacked message.
+
+  This internal method is different from public Any Unpack method which takes
+  the target message as argument. _InternalUnpackAny method does not have
+  target message type and need to find the message type in descriptor pool.
+
+  Args:
+    msg: An Any message to be unpacked.
+
+  Returns:
+    The unpacked message.
+  """
+  # TODO(amauryfa): Don't use the factory of generated messages.
+  # To make Any work with custom factories, use the message factory of the
+  # parent message.
+  # pylint: disable=g-import-not-at-top
+  from google.protobuf import symbol_database
+  factory = symbol_database.Default()
+
+  type_url = msg.type_url
+
+  if not type_url:
+    return None
+
+  # TODO(haberman): For now we just strip the hostname.  Better logic will be
+  # required.
+  type_name = type_url.split('/')[-1]
+  descriptor = factory.pool.FindMessageTypeByName(type_name)
+
+  if descriptor is None:
+    return None
+
+  message_class = factory.GetPrototype(descriptor)
+  message = message_class()
+
+  message.ParseFromString(msg.value)
+  return message
+
+
+def _AddEqualsMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __eq__(self, other):
+    if (not isinstance(other, message_mod.Message) or
+        other.DESCRIPTOR != self.DESCRIPTOR):
+      return False
+
+    if self is other:
+      return True
+
+    if self.DESCRIPTOR.full_name == _AnyFullTypeName:
+      any_a = _InternalUnpackAny(self)
+      any_b = _InternalUnpackAny(other)
+      if any_a and any_b:
+        return any_a == any_b
+
+    if not self.ListFields() == other.ListFields():
+      return False
+
+    # TODO(jieluo): Fix UnknownFieldSet to consider MessageSet extensions,
+    # then use it for the comparison.
+    unknown_fields = list(self._unknown_fields)
+    unknown_fields.sort()
+    other_unknown_fields = list(other._unknown_fields)
+    other_unknown_fields.sort()
+    return unknown_fields == other_unknown_fields
+
+  cls.__eq__ = __eq__
+
+
+def _AddStrMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __str__(self):
+    return text_format.MessageToString(self)
+  cls.__str__ = __str__
+
+
+def _AddReprMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def __repr__(self):
+    return text_format.MessageToString(self)
+  cls.__repr__ = __repr__
+
+
+def _AddUnicodeMethod(unused_message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def __unicode__(self):
+    return text_format.MessageToString(self, as_utf8=True).decode('utf-8')
+  cls.__unicode__ = __unicode__
+
+
+def _BytesForNonRepeatedElement(value, field_number, field_type):
+  """Returns the number of bytes needed to serialize a non-repeated element.
+  The returned byte count includes space for tag information and any
+  other additional space associated with serializing value.
+
+  Args:
+    value: Value we're serializing.
+    field_number: Field number of this value.  (Since the field number
+      is stored as part of a varint-encoded tag, this has an impact
+      on the total bytes required to serialize the value).
+    field_type: The type of the field.  One of the TYPE_* constants
+      within FieldDescriptor.
+  """
+  try:
+    fn = type_checkers.TYPE_TO_BYTE_SIZE_FN[field_type]
+    return fn(field_number, value)
+  except KeyError:
+    raise message_mod.EncodeError('Unrecognized field type: %d' % field_type)
+
+
+def _AddByteSizeMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def ByteSize(self):
+    if not self._cached_byte_size_dirty:
+      return self._cached_byte_size
+
+    size = 0
+    descriptor = self.DESCRIPTOR
+    if descriptor.GetOptions().map_entry:
+      # Fields of map entry should always be serialized.
+      size = descriptor.fields_by_name['key']._sizer(self.key)
+      size += descriptor.fields_by_name['value']._sizer(self.value)
+    else:
+      for field_descriptor, field_value in self.ListFields():
+        size += field_descriptor._sizer(field_value)
+      for tag_bytes, value_bytes in self._unknown_fields:
+        size += len(tag_bytes) + len(value_bytes)
+
+    self._cached_byte_size = size
+    self._cached_byte_size_dirty = False
+    self._listener_for_children.dirty = False
+    return size
+
+  cls.ByteSize = ByteSize
+
+
+def _AddSerializeToStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def SerializeToString(self, **kwargs):
+    # Check if the message has all of its required fields set.
+    if not self.IsInitialized():
+      raise message_mod.EncodeError(
+          'Message %s is missing required fields: %s' % (
+          self.DESCRIPTOR.full_name, ','.join(self.FindInitializationErrors())))
+    return self.SerializePartialToString(**kwargs)
+  cls.SerializeToString = SerializeToString
+
+
+def _AddSerializePartialToStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+
+  def SerializePartialToString(self, **kwargs):
+    out = BytesIO()
+    self._InternalSerialize(out.write, **kwargs)
+    return out.getvalue()
+  cls.SerializePartialToString = SerializePartialToString
+
+  def InternalSerialize(self, write_bytes, deterministic=None):
+    if deterministic is None:
+      deterministic = (
+          api_implementation.IsPythonDefaultSerializationDeterministic())
+    else:
+      deterministic = bool(deterministic)
+
+    descriptor = self.DESCRIPTOR
+    if descriptor.GetOptions().map_entry:
+      # Fields of map entry should always be serialized.
+      descriptor.fields_by_name['key']._encoder(
+          write_bytes, self.key, deterministic)
+      descriptor.fields_by_name['value']._encoder(
+          write_bytes, self.value, deterministic)
+    else:
+      for field_descriptor, field_value in self.ListFields():
+        field_descriptor._encoder(write_bytes, field_value, deterministic)
+      for tag_bytes, value_bytes in self._unknown_fields:
+        write_bytes(tag_bytes)
+        write_bytes(value_bytes)
+  cls._InternalSerialize = InternalSerialize
+
+
+def _AddMergeFromStringMethod(message_descriptor, cls):
+  """Helper for _AddMessageMethods()."""
+  def MergeFromString(self, serialized):
+    if isinstance(serialized, memoryview) and six.PY2:
+      raise TypeError(
+          'memoryview not supported in Python 2 with the pure Python proto '
+          'implementation: this is to maintain compatibility with the C++ '
+          'implementation')
+
+    serialized = memoryview(serialized)
+    length = len(serialized)
+    try:
+      if self._InternalParse(serialized, 0, length) != length:
+        # The only reason _InternalParse would return early is if it
+        # encountered an end-group tag.
+        raise message_mod.DecodeError('Unexpected end-group tag.')
+    except (IndexError, TypeError):
+      # Now ord(buf[p:p+1]) == ord('') gets TypeError.
+      raise message_mod.DecodeError('Truncated message.')
+    except struct.error as e:
+      raise message_mod.DecodeError(e)
+    return length   # Return this for legacy reasons.
+  cls.MergeFromString = MergeFromString
+
+  local_ReadTag = decoder.ReadTag
+  local_SkipField = decoder.SkipField
+  decoders_by_tag = cls._decoders_by_tag
+
+  def InternalParse(self, buffer, pos, end):
+    """Create a message from serialized bytes.
+
+    Args:
+      self: Message, instance of the proto message object.
+      buffer: memoryview of the serialized data.
+      pos: int, position to start in the serialized data.
+      end: int, end position of the serialized data.
+
+    Returns:
+      Message object.
+    """
+    # Guard against internal misuse, since this function is called internally
+    # quite extensively, and its easy to accidentally pass bytes.
+    assert isinstance(buffer, memoryview)
+    self._Modified()
+    field_dict = self._fields
+    # pylint: disable=protected-access
+    unknown_field_set = self._unknown_field_set
+    while pos != end:
+      (tag_bytes, new_pos) = local_ReadTag(buffer, pos)
+      field_decoder, field_desc = decoders_by_tag.get(tag_bytes, (None, None))
+      if field_decoder is None:
+        if not self._unknown_fields:   # pylint: disable=protected-access
+          self._unknown_fields = []    # pylint: disable=protected-access
+        if unknown_field_set is None:
+          # pylint: disable=protected-access
+          self._unknown_field_set = containers.UnknownFieldSet()
+          # pylint: disable=protected-access
+          unknown_field_set = self._unknown_field_set
+        # pylint: disable=protected-access
+        (tag, _) = decoder._DecodeVarint(tag_bytes, 0)
+        field_number, wire_type = wire_format.UnpackTag(tag)
+        if field_number == 0:
+          raise message_mod.DecodeError('Field number 0 is illegal.')
+        # TODO(jieluo): remove old_pos.
+        old_pos = new_pos
+        (data, new_pos) = decoder._DecodeUnknownField(
+            buffer, new_pos, wire_type)  # pylint: disable=protected-access
+        if new_pos == -1:
+          return pos
+        # pylint: disable=protected-access
+        unknown_field_set._add(field_number, wire_type, data)
+        # TODO(jieluo): remove _unknown_fields.
+        new_pos = local_SkipField(buffer, old_pos, end, tag_bytes)
+        if new_pos == -1:
+          return pos
+        self._unknown_fields.append(
+            (tag_bytes, buffer[old_pos:new_pos].tobytes()))
+        pos = new_pos
+      else:
+        pos = field_decoder(buffer, new_pos, end, self, field_dict)
+        if field_desc:
+          self._UpdateOneofState(field_desc)
+    return pos
+  cls._InternalParse = InternalParse
+
+
+def _AddIsInitializedMethod(message_descriptor, cls):
+  """Adds the IsInitialized and FindInitializationError methods to the
+  protocol message class."""
+
+  required_fields = [field for field in message_descriptor.fields
+                           if field.label == _FieldDescriptor.LABEL_REQUIRED]
+
+  def IsInitialized(self, errors=None):
+    """Checks if all required fields of a message are set.
+
+    Args:
+      errors:  A list which, if provided, will be populated with the field
+               paths of all missing required fields.
+
+    Returns:
+      True iff the specified message has all required fields set.
+    """
+
+    # Performance is critical so we avoid HasField() and ListFields().
+
+    for field in required_fields:
+      if (field not in self._fields or
+          (field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE and
+           not self._fields[field]._is_present_in_parent)):
+        if errors is not None:
+          errors.extend(self.FindInitializationErrors())
+        return False
+
+    for field, value in list(self._fields.items()):  # dict can change size!
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        if field.label == _FieldDescriptor.LABEL_REPEATED:
+          if (field.message_type.has_options and
+              field.message_type.GetOptions().map_entry):
+            continue
+          for element in value:
+            if not element.IsInitialized():
+              if errors is not None:
+                errors.extend(self.FindInitializationErrors())
+              return False
+        elif value._is_present_in_parent and not value.IsInitialized():
+          if errors is not None:
+            errors.extend(self.FindInitializationErrors())
+          return False
+
+    return True
+
+  cls.IsInitialized = IsInitialized
+
+  def FindInitializationErrors(self):
+    """Finds required fields which are not initialized.
+
+    Returns:
+      A list of strings.  Each string is a path to an uninitialized field from
+      the top-level message, e.g. "foo.bar[5].baz".
+    """
+
+    errors = []  # simplify things
+
+    for field in required_fields:
+      if not self.HasField(field.name):
+        errors.append(field.name)
+
+    for field, value in self.ListFields():
+      if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+        if field.is_extension:
+          name = '(%s)' % field.full_name
+        else:
+          name = field.name
+
+        if _IsMapField(field):
+          if _IsMessageMapField(field):
+            for key in value:
+              element = value[key]
+              prefix = '%s[%s].' % (name, key)
+              sub_errors = element.FindInitializationErrors()
+              errors += [prefix + error for error in sub_errors]
+          else:
+            # ScalarMaps can't have any initialization errors.
+            pass
+        elif field.label == _FieldDescriptor.LABEL_REPEATED:
+          for i in range(len(value)):
+            element = value[i]
+            prefix = '%s[%d].' % (name, i)
+            sub_errors = element.FindInitializationErrors()
+            errors += [prefix + error for error in sub_errors]
+        else:
+          prefix = name + '.'
+          sub_errors = value.FindInitializationErrors()
+          errors += [prefix + error for error in sub_errors]
+
+    return errors
+
+  cls.FindInitializationErrors = FindInitializationErrors
+
+
+def _AddMergeFromMethod(cls):
+  LABEL_REPEATED = _FieldDescriptor.LABEL_REPEATED
+  CPPTYPE_MESSAGE = _FieldDescriptor.CPPTYPE_MESSAGE
+
+  def MergeFrom(self, msg):
+    if not isinstance(msg, cls):
+      raise TypeError(
+          'Parameter to MergeFrom() must be instance of same class: '
+          'expected %s got %s.' % (cls.__name__, msg.__class__.__name__))
+
+    assert msg is not self
+    self._Modified()
+
+    fields = self._fields
+
+    for field, value in msg._fields.items():
+      if field.label == LABEL_REPEATED:
+        field_value = fields.get(field)
+        if field_value is None:
+          # Construct a new object to represent this field.
+          field_value = field._default_constructor(self)
+          fields[field] = field_value
+        field_value.MergeFrom(value)
+      elif field.cpp_type == CPPTYPE_MESSAGE:
+        if value._is_present_in_parent:
+          field_value = fields.get(field)
+          if field_value is None:
+            # Construct a new object to represent this field.
+            field_value = field._default_constructor(self)
+            fields[field] = field_value
+          field_value.MergeFrom(value)
+      else:
+        self._fields[field] = value
+        if field.containing_oneof:
+          self._UpdateOneofState(field)
+
+    if msg._unknown_fields:
+      if not self._unknown_fields:
+        self._unknown_fields = []
+      self._unknown_fields.extend(msg._unknown_fields)
+      # pylint: disable=protected-access
+      if self._unknown_field_set is None:
+        self._unknown_field_set = containers.UnknownFieldSet()
+      self._unknown_field_set._extend(msg._unknown_field_set)
+
+  cls.MergeFrom = MergeFrom
+
+
+def _AddWhichOneofMethod(message_descriptor, cls):
+  def WhichOneof(self, oneof_name):
+    """Returns the name of the currently set field inside a oneof, or None."""
+    try:
+      field = message_descriptor.oneofs_by_name[oneof_name]
+    except KeyError:
+      raise ValueError(
+          'Protocol message has no oneof "%s" field.' % oneof_name)
+
+    nested_field = self._oneofs.get(field, None)
+    if nested_field is not None and self.HasField(nested_field.name):
+      return nested_field.name
+    else:
+      return None
+
+  cls.WhichOneof = WhichOneof
+
+
+def _Clear(self):
+  # Clear fields.
+  self._fields = {}
+  self._unknown_fields = ()
+  # pylint: disable=protected-access
+  if self._unknown_field_set is not None:
+    self._unknown_field_set._clear()
+    self._unknown_field_set = None
+
+  self._oneofs = {}
+  self._Modified()
+
+
+def _UnknownFields(self):
+  if self._unknown_field_set is None:  # pylint: disable=protected-access
+    # pylint: disable=protected-access
+    self._unknown_field_set = containers.UnknownFieldSet()
+  return self._unknown_field_set    # pylint: disable=protected-access
+
+
+def _DiscardUnknownFields(self):
+  self._unknown_fields = []
+  self._unknown_field_set = None      # pylint: disable=protected-access
+  for field, value in self.ListFields():
+    if field.cpp_type == _FieldDescriptor.CPPTYPE_MESSAGE:
+      if _IsMapField(field):
+        if _IsMessageMapField(field):
+          for key in value:
+            value[key].DiscardUnknownFields()
+      elif field.label == _FieldDescriptor.LABEL_REPEATED:
+        for sub_message in value:
+          sub_message.DiscardUnknownFields()
+      else:
+        value.DiscardUnknownFields()
+
+
+def _SetListener(self, listener):
+  if listener is None:
+    self._listener = message_listener_mod.NullMessageListener()
+  else:
+    self._listener = listener
+
+
+def _AddMessageMethods(message_descriptor, cls):
+  """Adds implementations of all Message methods to cls."""
+  _AddListFieldsMethod(message_descriptor, cls)
+  _AddHasFieldMethod(message_descriptor, cls)
+  _AddClearFieldMethod(message_descriptor, cls)
+  if message_descriptor.is_extendable:
+    _AddClearExtensionMethod(cls)
+    _AddHasExtensionMethod(cls)
+  _AddEqualsMethod(message_descriptor, cls)
+  _AddStrMethod(message_descriptor, cls)
+  _AddReprMethod(message_descriptor, cls)
+  _AddUnicodeMethod(message_descriptor, cls)
+  _AddByteSizeMethod(message_descriptor, cls)
+  _AddSerializeToStringMethod(message_descriptor, cls)
+  _AddSerializePartialToStringMethod(message_descriptor, cls)
+  _AddMergeFromStringMethod(message_descriptor, cls)
+  _AddIsInitializedMethod(message_descriptor, cls)
+  _AddMergeFromMethod(cls)
+  _AddWhichOneofMethod(message_descriptor, cls)
+  # Adds methods which do not depend on cls.
+  cls.Clear = _Clear
+  cls.UnknownFields = _UnknownFields
+  cls.DiscardUnknownFields = _DiscardUnknownFields
+  cls._SetListener = _SetListener
+
+
+def _AddPrivateHelperMethods(message_descriptor, cls):
+  """Adds implementation of private helper methods to cls."""
+
+  def Modified(self):
+    """Sets the _cached_byte_size_dirty bit to true,
+    and propagates this to our listener iff this was a state change.
+    """
+
+    # Note:  Some callers check _cached_byte_size_dirty before calling
+    #   _Modified() as an extra optimization.  So, if this method is ever
+    #   changed such that it does stuff even when _cached_byte_size_dirty is
+    #   already true, the callers need to be updated.
+    if not self._cached_byte_size_dirty:
+      self._cached_byte_size_dirty = True
+      self._listener_for_children.dirty = True
+      self._is_present_in_parent = True
+      self._listener.Modified()
+
+  def _UpdateOneofState(self, field):
+    """Sets field as the active field in its containing oneof.
+
+    Will also delete currently active field in the oneof, if it is different
+    from the argument. Does not mark the message as modified.
+    """
+    other_field = self._oneofs.setdefault(field.containing_oneof, field)
+    if other_field is not field:
+      del self._fields[other_field]
+      self._oneofs[field.containing_oneof] = field
+
+  cls._Modified = Modified
+  cls.SetInParent = Modified
+  cls._UpdateOneofState = _UpdateOneofState
+
+
+class _Listener(object):
+
+  """MessageListener implementation that a parent message registers with its
+  child message.
+
+  In order to support semantics like:
+
+    foo.bar.baz.qux = 23
+    assert foo.HasField('bar')
+
+  ...child objects must have back references to their parents.
+  This helper class is at the heart of this support.
+  """
+
+  def __init__(self, parent_message):
+    """Args:
+      parent_message: The message whose _Modified() method we should call when
+        we receive Modified() messages.
+    """
+    # This listener establishes a back reference from a child (contained) object
+    # to its parent (containing) object.  We make this a weak reference to avoid
+    # creating cyclic garbage when the client finishes with the 'parent' object
+    # in the tree.
+    if isinstance(parent_message, weakref.ProxyType):
+      self._parent_message_weakref = parent_message
+    else:
+      self._parent_message_weakref = weakref.proxy(parent_message)
+
+    # As an optimization, we also indicate directly on the listener whether
+    # or not the parent message is dirty.  This way we can avoid traversing
+    # up the tree in the common case.
+    self.dirty = False
+
+  def Modified(self):
+    if self.dirty:
+      return
+    try:
+      # Propagate the signal to our parents iff this is the first field set.
+      self._parent_message_weakref._Modified()
+    except ReferenceError:
+      # We can get here if a client has kept a reference to a child object,
+      # and is now setting a field on it, but the child's parent has been
+      # garbage-collected.  This is not an error.
+      pass
+
+
+class _OneofListener(_Listener):
+  """Special listener implementation for setting composite oneof fields."""
+
+  def __init__(self, parent_message, field):
+    """Args:
+      parent_message: The message whose _Modified() method we should call when
+        we receive Modified() messages.
+      field: The descriptor of the field being set in the parent message.
+    """
+    super(_OneofListener, self).__init__(parent_message)
+    self._field = field
+
+  def Modified(self):
+    """Also updates the state of the containing oneof in the parent message."""
+    try:
+      self._parent_message_weakref._UpdateOneofState(self._field)
+      super(_OneofListener, self).Modified()
+    except ReferenceError:
+      pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/type_checkers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/type_checkers.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb66f9f6fbaeeaf190792b76eb0b7cc62b82e782
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/type_checkers.py
@@ -0,0 +1,426 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Provides type checking routines.
+
+This module defines type checking utilities in the forms of dictionaries:
+
+VALUE_CHECKERS: A dictionary of field types and a value validation object.
+TYPE_TO_BYTE_SIZE_FN: A dictionary with field types and a size computing
+  function.
+TYPE_TO_SERIALIZE_METHOD: A dictionary with field types and serialization
+  function.
+FIELD_TYPE_TO_WIRE_TYPE: A dictionary with field typed and their
+  corresponding wire types.
+TYPE_TO_DESERIALIZE_METHOD: A dictionary with field types and deserialization
+  function.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+try:
+  import ctypes
+except Exception:  # pylint: disable=broad-except
+  ctypes = None
+  import struct
+import numbers
+import six
+
+if six.PY3:
+  long = int
+
+from google.protobuf.internal import api_implementation
+from google.protobuf.internal import decoder
+from google.protobuf.internal import encoder
+from google.protobuf.internal import wire_format
+from google.protobuf import descriptor
+
+_FieldDescriptor = descriptor.FieldDescriptor
+
+
+def TruncateToFourByteFloat(original):
+  if ctypes:
+    return ctypes.c_float(original).value
+  else:
+    return struct.unpack('<f', struct.pack('<f', original))[0]
+
+
+def ToShortestFloat(original):
+  """Returns the shortest float that has same value in wire."""
+  # All 4 byte floats have between 6 and 9 significant digits, so we
+  # start with 6 as the lower bound.
+  # It has to be iterative because use '.9g' directly can not get rid
+  # of the noises for most values. For example if set a float_field=0.9
+  # use '.9g' will print 0.899999976.
+  precision = 6
+  rounded = float('{0:.{1}g}'.format(original, precision))
+  while TruncateToFourByteFloat(rounded) != original:
+    precision += 1
+    rounded = float('{0:.{1}g}'.format(original, precision))
+  return rounded
+
+
+def SupportsOpenEnums(field_descriptor):
+  return field_descriptor.containing_type.syntax == "proto3"
+
+def GetTypeChecker(field):
+  """Returns a type checker for a message field of the specified types.
+
+  Args:
+    field: FieldDescriptor object for this field.
+
+  Returns:
+    An instance of TypeChecker which can be used to verify the types
+    of values assigned to a field of the specified type.
+  """
+  if (field.cpp_type == _FieldDescriptor.CPPTYPE_STRING and
+      field.type == _FieldDescriptor.TYPE_STRING):
+    return UnicodeValueChecker()
+  if field.cpp_type == _FieldDescriptor.CPPTYPE_ENUM:
+    if SupportsOpenEnums(field):
+      # When open enums are supported, any int32 can be assigned.
+      return _VALUE_CHECKERS[_FieldDescriptor.CPPTYPE_INT32]
+    else:
+      return EnumValueChecker(field.enum_type)
+  return _VALUE_CHECKERS[field.cpp_type]
+
+
+# None of the typecheckers below make any attempt to guard against people
+# subclassing builtin types and doing weird things.  We're not trying to
+# protect against malicious clients here, just people accidentally shooting
+# themselves in the foot in obvious ways.
+
+class TypeChecker(object):
+
+  """Type checker used to catch type errors as early as possible
+  when the client is setting scalar fields in protocol messages.
+  """
+
+  def __init__(self, *acceptable_types):
+    self._acceptable_types = acceptable_types
+
+  def CheckValue(self, proposed_value):
+    """Type check the provided value and return it.
+
+    The returned value might have been normalized to another type.
+    """
+    if not isinstance(proposed_value, self._acceptable_types):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), self._acceptable_types))
+      raise TypeError(message)
+    # Some field types(float, double and bool) accept other types, must
+    # convert to the correct type in such cases.
+    if self._acceptable_types:
+      if self._acceptable_types[0] in (bool, float):
+        return self._acceptable_types[0](proposed_value)
+    return proposed_value
+
+
+class TypeCheckerWithDefault(TypeChecker):
+
+  def __init__(self, default_value, *acceptable_types):
+    TypeChecker.__init__(self, *acceptable_types)
+    self._default_value = default_value
+
+  def DefaultValue(self):
+    return self._default_value
+
+
+# IntValueChecker and its subclasses perform integer type-checks
+# and bounds-checks.
+class IntValueChecker(object):
+
+  """Checker used for integer fields.  Performs type-check and range check."""
+
+  def CheckValue(self, proposed_value):
+    if not isinstance(proposed_value, numbers.Integral):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), six.integer_types))
+      raise TypeError(message)
+    if not self._MIN <= int(proposed_value) <= self._MAX:
+      raise ValueError('Value out of range: %d' % proposed_value)
+    # We force 32-bit values to int and 64-bit values to long to make
+    # alternate implementations where the distinction is more significant
+    # (e.g. the C++ implementation) simpler.
+    proposed_value = self._TYPE(proposed_value)
+    return proposed_value
+
+  def DefaultValue(self):
+    return 0
+
+
+class EnumValueChecker(object):
+
+  """Checker used for enum fields.  Performs type-check and range check."""
+
+  def __init__(self, enum_type):
+    self._enum_type = enum_type
+
+  def CheckValue(self, proposed_value):
+    if not isinstance(proposed_value, numbers.Integral):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), six.integer_types))
+      raise TypeError(message)
+    if int(proposed_value) not in self._enum_type.values_by_number:
+      raise ValueError('Unknown enum value: %d' % proposed_value)
+    return proposed_value
+
+  def DefaultValue(self):
+    return self._enum_type.values[0].number
+
+
+class UnicodeValueChecker(object):
+
+  """Checker used for string fields.
+
+  Always returns a unicode value, even if the input is of type str.
+  """
+
+  def CheckValue(self, proposed_value):
+    if not isinstance(proposed_value, (bytes, six.text_type)):
+      message = ('%.1024r has type %s, but expected one of: %s' %
+                 (proposed_value, type(proposed_value), (bytes, six.text_type)))
+      raise TypeError(message)
+
+    # If the value is of type 'bytes' make sure that it is valid UTF-8 data.
+    if isinstance(proposed_value, bytes):
+      try:
+        proposed_value = proposed_value.decode('utf-8')
+      except UnicodeDecodeError:
+        raise ValueError('%.1024r has type bytes, but isn\'t valid UTF-8 '
+                         'encoding. Non-UTF-8 strings must be converted to '
+                         'unicode objects before being added.' %
+                         (proposed_value))
+    else:
+      try:
+        proposed_value.encode('utf8')
+      except UnicodeEncodeError:
+        raise ValueError('%.1024r isn\'t a valid unicode string and '
+                         'can\'t be encoded in UTF-8.'%
+                         (proposed_value))
+
+    return proposed_value
+
+  def DefaultValue(self):
+    return u""
+
+
+class Int32ValueChecker(IntValueChecker):
+  # We're sure to use ints instead of longs here since comparison may be more
+  # efficient.
+  _MIN = -2147483648
+  _MAX = 2147483647
+  _TYPE = int
+
+
+class Uint32ValueChecker(IntValueChecker):
+  _MIN = 0
+  _MAX = (1 << 32) - 1
+  _TYPE = int
+
+
+class Int64ValueChecker(IntValueChecker):
+  _MIN = -(1 << 63)
+  _MAX = (1 << 63) - 1
+  _TYPE = long
+
+
+class Uint64ValueChecker(IntValueChecker):
+  _MIN = 0
+  _MAX = (1 << 64) - 1
+  _TYPE = long
+
+
+# The max 4 bytes float is about 3.4028234663852886e+38
+_FLOAT_MAX = float.fromhex('0x1.fffffep+127')
+_FLOAT_MIN = -_FLOAT_MAX
+_INF = float('inf')
+_NEG_INF = float('-inf')
+
+
+class FloatValueChecker(object):
+
+  """Checker used for float fields.  Performs type-check and range check.
+
+  Values exceeding a 32-bit float will be converted to inf/-inf.
+  """
+
+  def CheckValue(self, proposed_value):
+    """Check and convert proposed_value to float."""
+    if not isinstance(proposed_value, numbers.Real):
+      message = ('%.1024r has type %s, but expected one of: numbers.Real' %
+                 (proposed_value, type(proposed_value)))
+      raise TypeError(message)
+    converted_value = float(proposed_value)
+    # This inf rounding matches the C++ proto SafeDoubleToFloat logic.
+    if converted_value > _FLOAT_MAX:
+      return _INF
+    if converted_value < _FLOAT_MIN:
+      return _NEG_INF
+
+    return TruncateToFourByteFloat(converted_value)
+
+  def DefaultValue(self):
+    return 0.0
+
+
+# Type-checkers for all scalar CPPTYPEs.
+_VALUE_CHECKERS = {
+    _FieldDescriptor.CPPTYPE_INT32: Int32ValueChecker(),
+    _FieldDescriptor.CPPTYPE_INT64: Int64ValueChecker(),
+    _FieldDescriptor.CPPTYPE_UINT32: Uint32ValueChecker(),
+    _FieldDescriptor.CPPTYPE_UINT64: Uint64ValueChecker(),
+    _FieldDescriptor.CPPTYPE_DOUBLE: TypeCheckerWithDefault(
+        0.0, float, numbers.Real),
+    _FieldDescriptor.CPPTYPE_FLOAT: FloatValueChecker(),
+    _FieldDescriptor.CPPTYPE_BOOL: TypeCheckerWithDefault(
+        False, bool, numbers.Integral),
+    _FieldDescriptor.CPPTYPE_STRING: TypeCheckerWithDefault(b'', bytes),
+    }
+
+
+# Map from field type to a function F, such that F(field_num, value)
+# gives the total byte size for a value of the given type.  This
+# byte size includes tag information and any other additional space
+# associated with serializing "value".
+TYPE_TO_BYTE_SIZE_FN = {
+    _FieldDescriptor.TYPE_DOUBLE: wire_format.DoubleByteSize,
+    _FieldDescriptor.TYPE_FLOAT: wire_format.FloatByteSize,
+    _FieldDescriptor.TYPE_INT64: wire_format.Int64ByteSize,
+    _FieldDescriptor.TYPE_UINT64: wire_format.UInt64ByteSize,
+    _FieldDescriptor.TYPE_INT32: wire_format.Int32ByteSize,
+    _FieldDescriptor.TYPE_FIXED64: wire_format.Fixed64ByteSize,
+    _FieldDescriptor.TYPE_FIXED32: wire_format.Fixed32ByteSize,
+    _FieldDescriptor.TYPE_BOOL: wire_format.BoolByteSize,
+    _FieldDescriptor.TYPE_STRING: wire_format.StringByteSize,
+    _FieldDescriptor.TYPE_GROUP: wire_format.GroupByteSize,
+    _FieldDescriptor.TYPE_MESSAGE: wire_format.MessageByteSize,
+    _FieldDescriptor.TYPE_BYTES: wire_format.BytesByteSize,
+    _FieldDescriptor.TYPE_UINT32: wire_format.UInt32ByteSize,
+    _FieldDescriptor.TYPE_ENUM: wire_format.EnumByteSize,
+    _FieldDescriptor.TYPE_SFIXED32: wire_format.SFixed32ByteSize,
+    _FieldDescriptor.TYPE_SFIXED64: wire_format.SFixed64ByteSize,
+    _FieldDescriptor.TYPE_SINT32: wire_format.SInt32ByteSize,
+    _FieldDescriptor.TYPE_SINT64: wire_format.SInt64ByteSize
+    }
+
+
+# Maps from field types to encoder constructors.
+TYPE_TO_ENCODER = {
+    _FieldDescriptor.TYPE_DOUBLE: encoder.DoubleEncoder,
+    _FieldDescriptor.TYPE_FLOAT: encoder.FloatEncoder,
+    _FieldDescriptor.TYPE_INT64: encoder.Int64Encoder,
+    _FieldDescriptor.TYPE_UINT64: encoder.UInt64Encoder,
+    _FieldDescriptor.TYPE_INT32: encoder.Int32Encoder,
+    _FieldDescriptor.TYPE_FIXED64: encoder.Fixed64Encoder,
+    _FieldDescriptor.TYPE_FIXED32: encoder.Fixed32Encoder,
+    _FieldDescriptor.TYPE_BOOL: encoder.BoolEncoder,
+    _FieldDescriptor.TYPE_STRING: encoder.StringEncoder,
+    _FieldDescriptor.TYPE_GROUP: encoder.GroupEncoder,
+    _FieldDescriptor.TYPE_MESSAGE: encoder.MessageEncoder,
+    _FieldDescriptor.TYPE_BYTES: encoder.BytesEncoder,
+    _FieldDescriptor.TYPE_UINT32: encoder.UInt32Encoder,
+    _FieldDescriptor.TYPE_ENUM: encoder.EnumEncoder,
+    _FieldDescriptor.TYPE_SFIXED32: encoder.SFixed32Encoder,
+    _FieldDescriptor.TYPE_SFIXED64: encoder.SFixed64Encoder,
+    _FieldDescriptor.TYPE_SINT32: encoder.SInt32Encoder,
+    _FieldDescriptor.TYPE_SINT64: encoder.SInt64Encoder,
+    }
+
+
+# Maps from field types to sizer constructors.
+TYPE_TO_SIZER = {
+    _FieldDescriptor.TYPE_DOUBLE: encoder.DoubleSizer,
+    _FieldDescriptor.TYPE_FLOAT: encoder.FloatSizer,
+    _FieldDescriptor.TYPE_INT64: encoder.Int64Sizer,
+    _FieldDescriptor.TYPE_UINT64: encoder.UInt64Sizer,
+    _FieldDescriptor.TYPE_INT32: encoder.Int32Sizer,
+    _FieldDescriptor.TYPE_FIXED64: encoder.Fixed64Sizer,
+    _FieldDescriptor.TYPE_FIXED32: encoder.Fixed32Sizer,
+    _FieldDescriptor.TYPE_BOOL: encoder.BoolSizer,
+    _FieldDescriptor.TYPE_STRING: encoder.StringSizer,
+    _FieldDescriptor.TYPE_GROUP: encoder.GroupSizer,
+    _FieldDescriptor.TYPE_MESSAGE: encoder.MessageSizer,
+    _FieldDescriptor.TYPE_BYTES: encoder.BytesSizer,
+    _FieldDescriptor.TYPE_UINT32: encoder.UInt32Sizer,
+    _FieldDescriptor.TYPE_ENUM: encoder.EnumSizer,
+    _FieldDescriptor.TYPE_SFIXED32: encoder.SFixed32Sizer,
+    _FieldDescriptor.TYPE_SFIXED64: encoder.SFixed64Sizer,
+    _FieldDescriptor.TYPE_SINT32: encoder.SInt32Sizer,
+    _FieldDescriptor.TYPE_SINT64: encoder.SInt64Sizer,
+    }
+
+
+# Maps from field type to a decoder constructor.
+TYPE_TO_DECODER = {
+    _FieldDescriptor.TYPE_DOUBLE: decoder.DoubleDecoder,
+    _FieldDescriptor.TYPE_FLOAT: decoder.FloatDecoder,
+    _FieldDescriptor.TYPE_INT64: decoder.Int64Decoder,
+    _FieldDescriptor.TYPE_UINT64: decoder.UInt64Decoder,
+    _FieldDescriptor.TYPE_INT32: decoder.Int32Decoder,
+    _FieldDescriptor.TYPE_FIXED64: decoder.Fixed64Decoder,
+    _FieldDescriptor.TYPE_FIXED32: decoder.Fixed32Decoder,
+    _FieldDescriptor.TYPE_BOOL: decoder.BoolDecoder,
+    _FieldDescriptor.TYPE_STRING: decoder.StringDecoder,
+    _FieldDescriptor.TYPE_GROUP: decoder.GroupDecoder,
+    _FieldDescriptor.TYPE_MESSAGE: decoder.MessageDecoder,
+    _FieldDescriptor.TYPE_BYTES: decoder.BytesDecoder,
+    _FieldDescriptor.TYPE_UINT32: decoder.UInt32Decoder,
+    _FieldDescriptor.TYPE_ENUM: decoder.EnumDecoder,
+    _FieldDescriptor.TYPE_SFIXED32: decoder.SFixed32Decoder,
+    _FieldDescriptor.TYPE_SFIXED64: decoder.SFixed64Decoder,
+    _FieldDescriptor.TYPE_SINT32: decoder.SInt32Decoder,
+    _FieldDescriptor.TYPE_SINT64: decoder.SInt64Decoder,
+    }
+
+# Maps from field type to expected wiretype.
+FIELD_TYPE_TO_WIRE_TYPE = {
+    _FieldDescriptor.TYPE_DOUBLE: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_FLOAT: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_INT64: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_UINT64: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_INT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_FIXED64: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_FIXED32: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_BOOL: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_STRING:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_GROUP: wire_format.WIRETYPE_START_GROUP,
+    _FieldDescriptor.TYPE_MESSAGE:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_BYTES:
+      wire_format.WIRETYPE_LENGTH_DELIMITED,
+    _FieldDescriptor.TYPE_UINT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_ENUM: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_SFIXED32: wire_format.WIRETYPE_FIXED32,
+    _FieldDescriptor.TYPE_SFIXED64: wire_format.WIRETYPE_FIXED64,
+    _FieldDescriptor.TYPE_SINT32: wire_format.WIRETYPE_VARINT,
+    _FieldDescriptor.TYPE_SINT64: wire_format.WIRETYPE_VARINT,
+    }
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/well_known_types.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/well_known_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f55d6b17b42528b276703db572925ce9a70b083
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/well_known_types.py
@@ -0,0 +1,863 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains well known classes.
+
+This files defines well known classes which need extra maintenance including:
+  - Any
+  - Duration
+  - FieldMask
+  - Struct
+  - Timestamp
+"""
+
+__author__ = 'jieluo@google.com (Jie Luo)'
+
+import calendar
+from datetime import datetime
+from datetime import timedelta
+import six
+
+try:
+  # Since python 3
+  import collections.abc as collections_abc
+except ImportError:
+  # Won't work after python 3.8
+  import collections as collections_abc
+
+from google.protobuf.descriptor import FieldDescriptor
+
+_TIMESTAMPFOMAT = '%Y-%m-%dT%H:%M:%S'
+_NANOS_PER_SECOND = 1000000000
+_NANOS_PER_MILLISECOND = 1000000
+_NANOS_PER_MICROSECOND = 1000
+_MILLIS_PER_SECOND = 1000
+_MICROS_PER_SECOND = 1000000
+_SECONDS_PER_DAY = 24 * 3600
+_DURATION_SECONDS_MAX = 315576000000
+
+
+class Any(object):
+  """Class for Any Message type."""
+
+  __slots__ = ()
+
+  def Pack(self, msg, type_url_prefix='type.googleapis.com/',
+           deterministic=None):
+    """Packs the specified message into current Any message."""
+    if len(type_url_prefix) < 1 or type_url_prefix[-1] != '/':
+      self.type_url = '%s/%s' % (type_url_prefix, msg.DESCRIPTOR.full_name)
+    else:
+      self.type_url = '%s%s' % (type_url_prefix, msg.DESCRIPTOR.full_name)
+    self.value = msg.SerializeToString(deterministic=deterministic)
+
+  def Unpack(self, msg):
+    """Unpacks the current Any message into specified message."""
+    descriptor = msg.DESCRIPTOR
+    if not self.Is(descriptor):
+      return False
+    msg.ParseFromString(self.value)
+    return True
+
+  def TypeName(self):
+    """Returns the protobuf type name of the inner message."""
+    # Only last part is to be used: b/25630112
+    return self.type_url.split('/')[-1]
+
+  def Is(self, descriptor):
+    """Checks if this Any represents the given protobuf type."""
+    return '/' in self.type_url and self.TypeName() == descriptor.full_name
+
+
+_EPOCH_DATETIME = datetime.utcfromtimestamp(0)
+
+
+class Timestamp(object):
+  """Class for Timestamp message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts Timestamp to RFC 3339 date string format.
+
+    Returns:
+      A string converted from timestamp. The string is always Z-normalized
+      and uses 3, 6 or 9 fractional digits as required to represent the
+      exact time. Example of the return format: '1972-01-01T10:00:20.021Z'
+    """
+    nanos = self.nanos % _NANOS_PER_SECOND
+    total_sec = self.seconds + (self.nanos - nanos) // _NANOS_PER_SECOND
+    seconds = total_sec % _SECONDS_PER_DAY
+    days = (total_sec - seconds) // _SECONDS_PER_DAY
+    dt = datetime(1970, 1, 1) + timedelta(days, seconds)
+
+    result = dt.isoformat()
+    if (nanos % 1e9) == 0:
+      # If there are 0 fractional digits, the fractional
+      # point '.' should be omitted when serializing.
+      return result + 'Z'
+    if (nanos % 1e6) == 0:
+      # Serialize 3 fractional digits.
+      return result + '.%03dZ' % (nanos / 1e6)
+    if (nanos % 1e3) == 0:
+      # Serialize 6 fractional digits.
+      return result + '.%06dZ' % (nanos / 1e3)
+    # Serialize 9 fractional digits.
+    return result + '.%09dZ' % nanos
+
+  def FromJsonString(self, value):
+    """Parse a RFC 3339 date string format to Timestamp.
+
+    Args:
+      value: A date string. Any fractional digits (or none) and any offset are
+          accepted as long as they fit into nano-seconds precision.
+          Example of accepted format: '1972-01-01T10:00:20.021-05:00'
+
+    Raises:
+      ValueError: On parsing problems.
+    """
+    timezone_offset = value.find('Z')
+    if timezone_offset == -1:
+      timezone_offset = value.find('+')
+    if timezone_offset == -1:
+      timezone_offset = value.rfind('-')
+    if timezone_offset == -1:
+      raise ValueError(
+          'Failed to parse timestamp: missing valid timezone offset.')
+    time_value = value[0:timezone_offset]
+    # Parse datetime and nanos.
+    point_position = time_value.find('.')
+    if point_position == -1:
+      second_value = time_value
+      nano_value = ''
+    else:
+      second_value = time_value[:point_position]
+      nano_value = time_value[point_position + 1:]
+    if 't' in second_value:
+      raise ValueError(
+          'time data \'{0}\' does not match format \'%Y-%m-%dT%H:%M:%S\', '
+          'lowercase \'t\' is not accepted'.format(second_value))
+    date_object = datetime.strptime(second_value, _TIMESTAMPFOMAT)
+    td = date_object - datetime(1970, 1, 1)
+    seconds = td.seconds + td.days * _SECONDS_PER_DAY
+    if len(nano_value) > 9:
+      raise ValueError(
+          'Failed to parse Timestamp: nanos {0} more than '
+          '9 fractional digits.'.format(nano_value))
+    if nano_value:
+      nanos = round(float('0.' + nano_value) * 1e9)
+    else:
+      nanos = 0
+    # Parse timezone offsets.
+    if value[timezone_offset] == 'Z':
+      if len(value) != timezone_offset + 1:
+        raise ValueError('Failed to parse timestamp: invalid trailing'
+                         ' data {0}.'.format(value))
+    else:
+      timezone = value[timezone_offset:]
+      pos = timezone.find(':')
+      if pos == -1:
+        raise ValueError(
+            'Invalid timezone offset value: {0}.'.format(timezone))
+      if timezone[0] == '+':
+        seconds -= (int(timezone[1:pos])*60+int(timezone[pos+1:]))*60
+      else:
+        seconds += (int(timezone[1:pos])*60+int(timezone[pos+1:]))*60
+    # Set seconds and nanos
+    self.seconds = int(seconds)
+    self.nanos = int(nanos)
+
+  def GetCurrentTime(self):
+    """Get the current UTC into Timestamp."""
+    self.FromDatetime(datetime.utcnow())
+
+  def ToNanoseconds(self):
+    """Converts Timestamp to nanoseconds since epoch."""
+    return self.seconds * _NANOS_PER_SECOND + self.nanos
+
+  def ToMicroseconds(self):
+    """Converts Timestamp to microseconds since epoch."""
+    return (self.seconds * _MICROS_PER_SECOND +
+            self.nanos // _NANOS_PER_MICROSECOND)
+
+  def ToMilliseconds(self):
+    """Converts Timestamp to milliseconds since epoch."""
+    return (self.seconds * _MILLIS_PER_SECOND +
+            self.nanos // _NANOS_PER_MILLISECOND)
+
+  def ToSeconds(self):
+    """Converts Timestamp to seconds since epoch."""
+    return self.seconds
+
+  def FromNanoseconds(self, nanos):
+    """Converts nanoseconds since epoch to Timestamp."""
+    self.seconds = nanos // _NANOS_PER_SECOND
+    self.nanos = nanos % _NANOS_PER_SECOND
+
+  def FromMicroseconds(self, micros):
+    """Converts microseconds since epoch to Timestamp."""
+    self.seconds = micros // _MICROS_PER_SECOND
+    self.nanos = (micros % _MICROS_PER_SECOND) * _NANOS_PER_MICROSECOND
+
+  def FromMilliseconds(self, millis):
+    """Converts milliseconds since epoch to Timestamp."""
+    self.seconds = millis // _MILLIS_PER_SECOND
+    self.nanos = (millis % _MILLIS_PER_SECOND) * _NANOS_PER_MILLISECOND
+
+  def FromSeconds(self, seconds):
+    """Converts seconds since epoch to Timestamp."""
+    self.seconds = seconds
+    self.nanos = 0
+
+  def ToDatetime(self):
+    """Converts Timestamp to datetime."""
+    return _EPOCH_DATETIME + timedelta(
+        seconds=self.seconds, microseconds=_RoundTowardZero(
+            self.nanos, _NANOS_PER_MICROSECOND))
+
+  def FromDatetime(self, dt):
+    """Converts datetime to Timestamp."""
+    # Using this guide: http://wiki.python.org/moin/WorkingWithTime
+    # And this conversion guide: http://docs.python.org/library/time.html
+
+    # Turn the date parameter into a tuple (struct_time) that can then be
+    # manipulated into a long value of seconds.  During the conversion from
+    # struct_time to long, the source date in UTC, and so it follows that the
+    # correct transformation is calendar.timegm()
+    self.seconds = calendar.timegm(dt.utctimetuple())
+    self.nanos = dt.microsecond * _NANOS_PER_MICROSECOND
+
+
+class Duration(object):
+  """Class for Duration message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts Duration to string format.
+
+    Returns:
+      A string converted from self. The string format will contains
+      3, 6, or 9 fractional digits depending on the precision required to
+      represent the exact Duration value. For example: "1s", "1.010s",
+      "1.000000100s", "-3.100s"
+    """
+    _CheckDurationValid(self.seconds, self.nanos)
+    if self.seconds < 0 or self.nanos < 0:
+      result = '-'
+      seconds = - self.seconds + int((0 - self.nanos) // 1e9)
+      nanos = (0 - self.nanos) % 1e9
+    else:
+      result = ''
+      seconds = self.seconds + int(self.nanos // 1e9)
+      nanos = self.nanos % 1e9
+    result += '%d' % seconds
+    if (nanos % 1e9) == 0:
+      # If there are 0 fractional digits, the fractional
+      # point '.' should be omitted when serializing.
+      return result + 's'
+    if (nanos % 1e6) == 0:
+      # Serialize 3 fractional digits.
+      return result + '.%03ds' % (nanos / 1e6)
+    if (nanos % 1e3) == 0:
+      # Serialize 6 fractional digits.
+      return result + '.%06ds' % (nanos / 1e3)
+    # Serialize 9 fractional digits.
+    return result + '.%09ds' % nanos
+
+  def FromJsonString(self, value):
+    """Converts a string to Duration.
+
+    Args:
+      value: A string to be converted. The string must end with 's'. Any
+          fractional digits (or none) are accepted as long as they fit into
+          precision. For example: "1s", "1.01s", "1.0000001s", "-3.100s
+
+    Raises:
+      ValueError: On parsing problems.
+    """
+    if len(value) < 1 or value[-1] != 's':
+      raise ValueError(
+          'Duration must end with letter "s": {0}.'.format(value))
+    try:
+      pos = value.find('.')
+      if pos == -1:
+        seconds = int(value[:-1])
+        nanos = 0
+      else:
+        seconds = int(value[:pos])
+        if value[0] == '-':
+          nanos = int(round(float('-0{0}'.format(value[pos: -1])) *1e9))
+        else:
+          nanos = int(round(float('0{0}'.format(value[pos: -1])) *1e9))
+      _CheckDurationValid(seconds, nanos)
+      self.seconds = seconds
+      self.nanos = nanos
+    except ValueError as e:
+      raise ValueError(
+          'Couldn\'t parse duration: {0} : {1}.'.format(value, e))
+
+  def ToNanoseconds(self):
+    """Converts a Duration to nanoseconds."""
+    return self.seconds * _NANOS_PER_SECOND + self.nanos
+
+  def ToMicroseconds(self):
+    """Converts a Duration to microseconds."""
+    micros = _RoundTowardZero(self.nanos, _NANOS_PER_MICROSECOND)
+    return self.seconds * _MICROS_PER_SECOND + micros
+
+  def ToMilliseconds(self):
+    """Converts a Duration to milliseconds."""
+    millis = _RoundTowardZero(self.nanos, _NANOS_PER_MILLISECOND)
+    return self.seconds * _MILLIS_PER_SECOND + millis
+
+  def ToSeconds(self):
+    """Converts a Duration to seconds."""
+    return self.seconds
+
+  def FromNanoseconds(self, nanos):
+    """Converts nanoseconds to Duration."""
+    self._NormalizeDuration(nanos // _NANOS_PER_SECOND,
+                            nanos % _NANOS_PER_SECOND)
+
+  def FromMicroseconds(self, micros):
+    """Converts microseconds to Duration."""
+    self._NormalizeDuration(
+        micros // _MICROS_PER_SECOND,
+        (micros % _MICROS_PER_SECOND) * _NANOS_PER_MICROSECOND)
+
+  def FromMilliseconds(self, millis):
+    """Converts milliseconds to Duration."""
+    self._NormalizeDuration(
+        millis // _MILLIS_PER_SECOND,
+        (millis % _MILLIS_PER_SECOND) * _NANOS_PER_MILLISECOND)
+
+  def FromSeconds(self, seconds):
+    """Converts seconds to Duration."""
+    self.seconds = seconds
+    self.nanos = 0
+
+  def ToTimedelta(self):
+    """Converts Duration to timedelta."""
+    return timedelta(
+        seconds=self.seconds, microseconds=_RoundTowardZero(
+            self.nanos, _NANOS_PER_MICROSECOND))
+
+  def FromTimedelta(self, td):
+    """Converts timedelta to Duration."""
+    self._NormalizeDuration(td.seconds + td.days * _SECONDS_PER_DAY,
+                            td.microseconds * _NANOS_PER_MICROSECOND)
+
+  def _NormalizeDuration(self, seconds, nanos):
+    """Set Duration by seconds and nanos."""
+    # Force nanos to be negative if the duration is negative.
+    if seconds < 0 and nanos > 0:
+      seconds += 1
+      nanos -= _NANOS_PER_SECOND
+    self.seconds = seconds
+    self.nanos = nanos
+
+
+def _CheckDurationValid(seconds, nanos):
+  if seconds < -_DURATION_SECONDS_MAX or seconds > _DURATION_SECONDS_MAX:
+    raise ValueError(
+        'Duration is not valid: Seconds {0} must be in range '
+        '[-315576000000, 315576000000].'.format(seconds))
+  if nanos <= -_NANOS_PER_SECOND or nanos >= _NANOS_PER_SECOND:
+    raise ValueError(
+        'Duration is not valid: Nanos {0} must be in range '
+        '[-999999999, 999999999].'.format(nanos))
+  if (nanos < 0 and seconds > 0) or (nanos > 0 and seconds < 0):
+    raise ValueError(
+        'Duration is not valid: Sign mismatch.')
+
+
+def _RoundTowardZero(value, divider):
+  """Truncates the remainder part after division."""
+  # For some languages, the sign of the remainder is implementation
+  # dependent if any of the operands is negative. Here we enforce
+  # "rounded toward zero" semantics. For example, for (-5) / 2 an
+  # implementation may give -3 as the result with the remainder being
+  # 1. This function ensures we always return -2 (closer to zero).
+  result = value // divider
+  remainder = value % divider
+  if result < 0 and remainder > 0:
+    return result + 1
+  else:
+    return result
+
+
+class FieldMask(object):
+  """Class for FieldMask message type."""
+
+  __slots__ = ()
+
+  def ToJsonString(self):
+    """Converts FieldMask to string according to proto3 JSON spec."""
+    camelcase_paths = []
+    for path in self.paths:
+      camelcase_paths.append(_SnakeCaseToCamelCase(path))
+    return ','.join(camelcase_paths)
+
+  def FromJsonString(self, value):
+    """Converts string to FieldMask according to proto3 JSON spec."""
+    self.Clear()
+    if value:
+      for path in value.split(','):
+        self.paths.append(_CamelCaseToSnakeCase(path))
+
+  def IsValidForDescriptor(self, message_descriptor):
+    """Checks whether the FieldMask is valid for Message Descriptor."""
+    for path in self.paths:
+      if not _IsValidPath(message_descriptor, path):
+        return False
+    return True
+
+  def AllFieldsFromDescriptor(self, message_descriptor):
+    """Gets all direct fields of Message Descriptor to FieldMask."""
+    self.Clear()
+    for field in message_descriptor.fields:
+      self.paths.append(field.name)
+
+  def CanonicalFormFromMask(self, mask):
+    """Converts a FieldMask to the canonical form.
+
+    Removes paths that are covered by another path. For example,
+    "foo.bar" is covered by "foo" and will be removed if "foo"
+    is also in the FieldMask. Then sorts all paths in alphabetical order.
+
+    Args:
+      mask: The original FieldMask to be converted.
+    """
+    tree = _FieldMaskTree(mask)
+    tree.ToFieldMask(self)
+
+  def Union(self, mask1, mask2):
+    """Merges mask1 and mask2 into this FieldMask."""
+    _CheckFieldMaskMessage(mask1)
+    _CheckFieldMaskMessage(mask2)
+    tree = _FieldMaskTree(mask1)
+    tree.MergeFromFieldMask(mask2)
+    tree.ToFieldMask(self)
+
+  def Intersect(self, mask1, mask2):
+    """Intersects mask1 and mask2 into this FieldMask."""
+    _CheckFieldMaskMessage(mask1)
+    _CheckFieldMaskMessage(mask2)
+    tree = _FieldMaskTree(mask1)
+    intersection = _FieldMaskTree()
+    for path in mask2.paths:
+      tree.IntersectPath(path, intersection)
+    intersection.ToFieldMask(self)
+
+  def MergeMessage(
+      self, source, destination,
+      replace_message_field=False, replace_repeated_field=False):
+    """Merges fields specified in FieldMask from source to destination.
+
+    Args:
+      source: Source message.
+      destination: The destination message to be merged into.
+      replace_message_field: Replace message field if True. Merge message
+          field if False.
+      replace_repeated_field: Replace repeated field if True. Append
+          elements of repeated field if False.
+    """
+    tree = _FieldMaskTree(self)
+    tree.MergeMessage(
+        source, destination, replace_message_field, replace_repeated_field)
+
+
+def _IsValidPath(message_descriptor, path):
+  """Checks whether the path is valid for Message Descriptor."""
+  parts = path.split('.')
+  last = parts.pop()
+  for name in parts:
+    field = message_descriptor.fields_by_name.get(name)
+    if (field is None or
+        field.label == FieldDescriptor.LABEL_REPEATED or
+        field.type != FieldDescriptor.TYPE_MESSAGE):
+      return False
+    message_descriptor = field.message_type
+  return last in message_descriptor.fields_by_name
+
+
+def _CheckFieldMaskMessage(message):
+  """Raises ValueError if message is not a FieldMask."""
+  message_descriptor = message.DESCRIPTOR
+  if (message_descriptor.name != 'FieldMask' or
+      message_descriptor.file.name != 'google/protobuf/field_mask.proto'):
+    raise ValueError('Message {0} is not a FieldMask.'.format(
+        message_descriptor.full_name))
+
+
+def _SnakeCaseToCamelCase(path_name):
+  """Converts a path name from snake_case to camelCase."""
+  result = []
+  after_underscore = False
+  for c in path_name:
+    if c.isupper():
+      raise ValueError(
+          'Fail to print FieldMask to Json string: Path name '
+          '{0} must not contain uppercase letters.'.format(path_name))
+    if after_underscore:
+      if c.islower():
+        result.append(c.upper())
+        after_underscore = False
+      else:
+        raise ValueError(
+            'Fail to print FieldMask to Json string: The '
+            'character after a "_" must be a lowercase letter '
+            'in path name {0}.'.format(path_name))
+    elif c == '_':
+      after_underscore = True
+    else:
+      result += c
+
+  if after_underscore:
+    raise ValueError('Fail to print FieldMask to Json string: Trailing "_" '
+                     'in path name {0}.'.format(path_name))
+  return ''.join(result)
+
+
+def _CamelCaseToSnakeCase(path_name):
+  """Converts a field name from camelCase to snake_case."""
+  result = []
+  for c in path_name:
+    if c == '_':
+      raise ValueError('Fail to parse FieldMask: Path name '
+                       '{0} must not contain "_"s.'.format(path_name))
+    if c.isupper():
+      result += '_'
+      result += c.lower()
+    else:
+      result += c
+  return ''.join(result)
+
+
+class _FieldMaskTree(object):
+  """Represents a FieldMask in a tree structure.
+
+  For example, given a FieldMask "foo.bar,foo.baz,bar.baz",
+  the FieldMaskTree will be:
+      [_root] -+- foo -+- bar
+            |       |
+            |       +- baz
+            |
+            +- bar --- baz
+  In the tree, each leaf node represents a field path.
+  """
+
+  __slots__ = ('_root',)
+
+  def __init__(self, field_mask=None):
+    """Initializes the tree by FieldMask."""
+    self._root = {}
+    if field_mask:
+      self.MergeFromFieldMask(field_mask)
+
+  def MergeFromFieldMask(self, field_mask):
+    """Merges a FieldMask to the tree."""
+    for path in field_mask.paths:
+      self.AddPath(path)
+
+  def AddPath(self, path):
+    """Adds a field path into the tree.
+
+    If the field path to add is a sub-path of an existing field path
+    in the tree (i.e., a leaf node), it means the tree already matches
+    the given path so nothing will be added to the tree. If the path
+    matches an existing non-leaf node in the tree, that non-leaf node
+    will be turned into a leaf node with all its children removed because
+    the path matches all the node's children. Otherwise, a new path will
+    be added.
+
+    Args:
+      path: The field path to add.
+    """
+    node = self._root
+    for name in path.split('.'):
+      if name not in node:
+        node[name] = {}
+      elif not node[name]:
+        # Pre-existing empty node implies we already have this entire tree.
+        return
+      node = node[name]
+    # Remove any sub-trees we might have had.
+    node.clear()
+
+  def ToFieldMask(self, field_mask):
+    """Converts the tree to a FieldMask."""
+    field_mask.Clear()
+    _AddFieldPaths(self._root, '', field_mask)
+
+  def IntersectPath(self, path, intersection):
+    """Calculates the intersection part of a field path with this tree.
+
+    Args:
+      path: The field path to calculates.
+      intersection: The out tree to record the intersection part.
+    """
+    node = self._root
+    for name in path.split('.'):
+      if name not in node:
+        return
+      elif not node[name]:
+        intersection.AddPath(path)
+        return
+      node = node[name]
+    intersection.AddLeafNodes(path, node)
+
+  def AddLeafNodes(self, prefix, node):
+    """Adds leaf nodes begin with prefix to this tree."""
+    if not node:
+      self.AddPath(prefix)
+    for name in node:
+      child_path = prefix + '.' + name
+      self.AddLeafNodes(child_path, node[name])
+
+  def MergeMessage(
+      self, source, destination,
+      replace_message, replace_repeated):
+    """Merge all fields specified by this tree from source to destination."""
+    _MergeMessage(
+        self._root, source, destination, replace_message, replace_repeated)
+
+
+def _StrConvert(value):
+  """Converts value to str if it is not."""
+  # This file is imported by c extension and some methods like ClearField
+  # requires string for the field name. py2/py3 has different text
+  # type and may use unicode.
+  if not isinstance(value, str):
+    return value.encode('utf-8')
+  return value
+
+
+def _MergeMessage(
+    node, source, destination, replace_message, replace_repeated):
+  """Merge all fields specified by a sub-tree from source to destination."""
+  source_descriptor = source.DESCRIPTOR
+  for name in node:
+    child = node[name]
+    field = source_descriptor.fields_by_name[name]
+    if field is None:
+      raise ValueError('Error: Can\'t find field {0} in message {1}.'.format(
+          name, source_descriptor.full_name))
+    if child:
+      # Sub-paths are only allowed for singular message fields.
+      if (field.label == FieldDescriptor.LABEL_REPEATED or
+          field.cpp_type != FieldDescriptor.CPPTYPE_MESSAGE):
+        raise ValueError('Error: Field {0} in message {1} is not a singular '
+                         'message field and cannot have sub-fields.'.format(
+                             name, source_descriptor.full_name))
+      if source.HasField(name):
+        _MergeMessage(
+            child, getattr(source, name), getattr(destination, name),
+            replace_message, replace_repeated)
+      continue
+    if field.label == FieldDescriptor.LABEL_REPEATED:
+      if replace_repeated:
+        destination.ClearField(_StrConvert(name))
+      repeated_source = getattr(source, name)
+      repeated_destination = getattr(destination, name)
+      repeated_destination.MergeFrom(repeated_source)
+    else:
+      if field.cpp_type == FieldDescriptor.CPPTYPE_MESSAGE:
+        if replace_message:
+          destination.ClearField(_StrConvert(name))
+        if source.HasField(name):
+          getattr(destination, name).MergeFrom(getattr(source, name))
+      else:
+        setattr(destination, name, getattr(source, name))
+
+
+def _AddFieldPaths(node, prefix, field_mask):
+  """Adds the field paths descended from node to field_mask."""
+  if not node and prefix:
+    field_mask.paths.append(prefix)
+    return
+  for name in sorted(node):
+    if prefix:
+      child_path = prefix + '.' + name
+    else:
+      child_path = name
+    _AddFieldPaths(node[name], child_path, field_mask)
+
+
+_INT_OR_FLOAT = six.integer_types + (float,)
+
+
+def _SetStructValue(struct_value, value):
+  if value is None:
+    struct_value.null_value = 0
+  elif isinstance(value, bool):
+    # Note: this check must come before the number check because in Python
+    # True and False are also considered numbers.
+    struct_value.bool_value = value
+  elif isinstance(value, six.string_types):
+    struct_value.string_value = value
+  elif isinstance(value, _INT_OR_FLOAT):
+    struct_value.number_value = value
+  elif isinstance(value, (dict, Struct)):
+    struct_value.struct_value.Clear()
+    struct_value.struct_value.update(value)
+  elif isinstance(value, (list, ListValue)):
+    struct_value.list_value.Clear()
+    struct_value.list_value.extend(value)
+  else:
+    raise ValueError('Unexpected type')
+
+
+def _GetStructValue(struct_value):
+  which = struct_value.WhichOneof('kind')
+  if which == 'struct_value':
+    return struct_value.struct_value
+  elif which == 'null_value':
+    return None
+  elif which == 'number_value':
+    return struct_value.number_value
+  elif which == 'string_value':
+    return struct_value.string_value
+  elif which == 'bool_value':
+    return struct_value.bool_value
+  elif which == 'list_value':
+    return struct_value.list_value
+  elif which is None:
+    raise ValueError('Value not set')
+
+
+class Struct(object):
+  """Class for Struct message type."""
+
+  __slots__ = ()
+
+  def __getitem__(self, key):
+    return _GetStructValue(self.fields[key])
+
+  def __contains__(self, item):
+    return item in self.fields
+
+  def __setitem__(self, key, value):
+    _SetStructValue(self.fields[key], value)
+
+  def __delitem__(self, key):
+    del self.fields[key]
+
+  def __len__(self):
+    return len(self.fields)
+
+  def __iter__(self):
+    return iter(self.fields)
+
+  def keys(self):  # pylint: disable=invalid-name
+    return self.fields.keys()
+
+  def values(self):  # pylint: disable=invalid-name
+    return [self[key] for key in self]
+
+  def items(self):  # pylint: disable=invalid-name
+    return [(key, self[key]) for key in self]
+
+  def get_or_create_list(self, key):
+    """Returns a list for this key, creating if it didn't exist already."""
+    if not self.fields[key].HasField('list_value'):
+      # Clear will mark list_value modified which will indeed create a list.
+      self.fields[key].list_value.Clear()
+    return self.fields[key].list_value
+
+  def get_or_create_struct(self, key):
+    """Returns a struct for this key, creating if it didn't exist already."""
+    if not self.fields[key].HasField('struct_value'):
+      # Clear will mark struct_value modified which will indeed create a struct.
+      self.fields[key].struct_value.Clear()
+    return self.fields[key].struct_value
+
+  def update(self, dictionary):  # pylint: disable=invalid-name
+    for key, value in dictionary.items():
+      _SetStructValue(self.fields[key], value)
+
+collections_abc.MutableMapping.register(Struct)
+
+
+class ListValue(object):
+  """Class for ListValue message type."""
+
+  __slots__ = ()
+
+  def __len__(self):
+    return len(self.values)
+
+  def append(self, value):
+    _SetStructValue(self.values.add(), value)
+
+  def extend(self, elem_seq):
+    for value in elem_seq:
+      self.append(value)
+
+  def __getitem__(self, index):
+    """Retrieves item by the specified index."""
+    return _GetStructValue(self.values.__getitem__(index))
+
+  def __setitem__(self, index, value):
+    _SetStructValue(self.values.__getitem__(index), value)
+
+  def __delitem__(self, key):
+    del self.values[key]
+
+  def items(self):
+    for i in range(len(self)):
+      yield self[i]
+
+  def add_struct(self):
+    """Appends and returns a struct value as the next value in the list."""
+    struct_value = self.values.add().struct_value
+    # Clear will mark struct_value modified which will indeed create a struct.
+    struct_value.Clear()
+    return struct_value
+
+  def add_list(self):
+    """Appends and returns a list value as the next value in the list."""
+    list_value = self.values.add().list_value
+    # Clear will mark list_value modified which will indeed create a list.
+    list_value.Clear()
+    return list_value
+
+collections_abc.MutableSequence.register(ListValue)
+
+
+WKTBASES = {
+    'google.protobuf.Any': Any,
+    'google.protobuf.Duration': Duration,
+    'google.protobuf.FieldMask': FieldMask,
+    'google.protobuf.ListValue': ListValue,
+    'google.protobuf.Struct': Struct,
+    'google.protobuf.Timestamp': Timestamp,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/wire_format.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/wire_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..883f525585139493438c3c8922bbb82cf1b0084e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/internal/wire_format.py
@@ -0,0 +1,268 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Constants and static functions to support protocol buffer wire format."""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+import struct
+from google.protobuf import descriptor
+from google.protobuf import message
+
+
+TAG_TYPE_BITS = 3  # Number of bits used to hold type info in a proto tag.
+TAG_TYPE_MASK = (1 << TAG_TYPE_BITS) - 1  # 0x7
+
+# These numbers identify the wire type of a protocol buffer value.
+# We use the least-significant TAG_TYPE_BITS bits of the varint-encoded
+# tag-and-type to store one of these WIRETYPE_* constants.
+# These values must match WireType enum in google/protobuf/wire_format.h.
+WIRETYPE_VARINT = 0
+WIRETYPE_FIXED64 = 1
+WIRETYPE_LENGTH_DELIMITED = 2
+WIRETYPE_START_GROUP = 3
+WIRETYPE_END_GROUP = 4
+WIRETYPE_FIXED32 = 5
+_WIRETYPE_MAX = 5
+
+
+# Bounds for various integer types.
+INT32_MAX = int((1 << 31) - 1)
+INT32_MIN = int(-(1 << 31))
+UINT32_MAX = (1 << 32) - 1
+
+INT64_MAX = (1 << 63) - 1
+INT64_MIN = -(1 << 63)
+UINT64_MAX = (1 << 64) - 1
+
+# "struct" format strings that will encode/decode the specified formats.
+FORMAT_UINT32_LITTLE_ENDIAN = '<I'
+FORMAT_UINT64_LITTLE_ENDIAN = '<Q'
+FORMAT_FLOAT_LITTLE_ENDIAN = '<f'
+FORMAT_DOUBLE_LITTLE_ENDIAN = '<d'
+
+
+# We'll have to provide alternate implementations of AppendLittleEndian*() on
+# any architectures where these checks fail.
+if struct.calcsize(FORMAT_UINT32_LITTLE_ENDIAN) != 4:
+  raise AssertionError('Format "I" is not a 32-bit number.')
+if struct.calcsize(FORMAT_UINT64_LITTLE_ENDIAN) != 8:
+  raise AssertionError('Format "Q" is not a 64-bit number.')
+
+
+def PackTag(field_number, wire_type):
+  """Returns an unsigned 32-bit integer that encodes the field number and
+  wire type information in standard protocol message wire format.
+
+  Args:
+    field_number: Expected to be an integer in the range [1, 1 << 29)
+    wire_type: One of the WIRETYPE_* constants.
+  """
+  if not 0 <= wire_type <= _WIRETYPE_MAX:
+    raise message.EncodeError('Unknown wire type: %d' % wire_type)
+  return (field_number << TAG_TYPE_BITS) | wire_type
+
+
+def UnpackTag(tag):
+  """The inverse of PackTag().  Given an unsigned 32-bit number,
+  returns a (field_number, wire_type) tuple.
+  """
+  return (tag >> TAG_TYPE_BITS), (tag & TAG_TYPE_MASK)
+
+
+def ZigZagEncode(value):
+  """ZigZag Transform:  Encodes signed integers so that they can be
+  effectively used with varint encoding.  See wire_format.h for
+  more details.
+  """
+  if value >= 0:
+    return value << 1
+  return (value << 1) ^ (~0)
+
+
+def ZigZagDecode(value):
+  """Inverse of ZigZagEncode()."""
+  if not value & 0x1:
+    return value >> 1
+  return (value >> 1) ^ (~0)
+
+
+
+# The *ByteSize() functions below return the number of bytes required to
+# serialize "field number + type" information and then serialize the value.
+
+
+def Int32ByteSize(field_number, int32):
+  return Int64ByteSize(field_number, int32)
+
+
+def Int32ByteSizeNoTag(int32):
+  return _VarUInt64ByteSizeNoTag(0xffffffffffffffff & int32)
+
+
+def Int64ByteSize(field_number, int64):
+  # Have to convert to uint before calling UInt64ByteSize().
+  return UInt64ByteSize(field_number, 0xffffffffffffffff & int64)
+
+
+def UInt32ByteSize(field_number, uint32):
+  return UInt64ByteSize(field_number, uint32)
+
+
+def UInt64ByteSize(field_number, uint64):
+  return TagByteSize(field_number) + _VarUInt64ByteSizeNoTag(uint64)
+
+
+def SInt32ByteSize(field_number, int32):
+  return UInt32ByteSize(field_number, ZigZagEncode(int32))
+
+
+def SInt64ByteSize(field_number, int64):
+  return UInt64ByteSize(field_number, ZigZagEncode(int64))
+
+
+def Fixed32ByteSize(field_number, fixed32):
+  return TagByteSize(field_number) + 4
+
+
+def Fixed64ByteSize(field_number, fixed64):
+  return TagByteSize(field_number) + 8
+
+
+def SFixed32ByteSize(field_number, sfixed32):
+  return TagByteSize(field_number) + 4
+
+
+def SFixed64ByteSize(field_number, sfixed64):
+  return TagByteSize(field_number) + 8
+
+
+def FloatByteSize(field_number, flt):
+  return TagByteSize(field_number) + 4
+
+
+def DoubleByteSize(field_number, double):
+  return TagByteSize(field_number) + 8
+
+
+def BoolByteSize(field_number, b):
+  return TagByteSize(field_number) + 1
+
+
+def EnumByteSize(field_number, enum):
+  return UInt32ByteSize(field_number, enum)
+
+
+def StringByteSize(field_number, string):
+  return BytesByteSize(field_number, string.encode('utf-8'))
+
+
+def BytesByteSize(field_number, b):
+  return (TagByteSize(field_number)
+          + _VarUInt64ByteSizeNoTag(len(b))
+          + len(b))
+
+
+def GroupByteSize(field_number, message):
+  return (2 * TagByteSize(field_number)  # START and END group.
+          + message.ByteSize())
+
+
+def MessageByteSize(field_number, message):
+  return (TagByteSize(field_number)
+          + _VarUInt64ByteSizeNoTag(message.ByteSize())
+          + message.ByteSize())
+
+
+def MessageSetItemByteSize(field_number, msg):
+  # First compute the sizes of the tags.
+  # There are 2 tags for the beginning and ending of the repeated group, that
+  # is field number 1, one with field number 2 (type_id) and one with field
+  # number 3 (message).
+  total_size = (2 * TagByteSize(1) + TagByteSize(2) + TagByteSize(3))
+
+  # Add the number of bytes for type_id.
+  total_size += _VarUInt64ByteSizeNoTag(field_number)
+
+  message_size = msg.ByteSize()
+
+  # The number of bytes for encoding the length of the message.
+  total_size += _VarUInt64ByteSizeNoTag(message_size)
+
+  # The size of the message.
+  total_size += message_size
+  return total_size
+
+
+def TagByteSize(field_number):
+  """Returns the bytes required to serialize a tag with this field number."""
+  # Just pass in type 0, since the type won't affect the tag+type size.
+  return _VarUInt64ByteSizeNoTag(PackTag(field_number, 0))
+
+
+# Private helper function for the *ByteSize() functions above.
+
+def _VarUInt64ByteSizeNoTag(uint64):
+  """Returns the number of bytes required to serialize a single varint
+  using boundary value comparisons. (unrolled loop optimization -WPierce)
+  uint64 must be unsigned.
+  """
+  if uint64 <= 0x7f: return 1
+  if uint64 <= 0x3fff: return 2
+  if uint64 <= 0x1fffff: return 3
+  if uint64 <= 0xfffffff: return 4
+  if uint64 <= 0x7ffffffff: return 5
+  if uint64 <= 0x3ffffffffff: return 6
+  if uint64 <= 0x1ffffffffffff: return 7
+  if uint64 <= 0xffffffffffffff: return 8
+  if uint64 <= 0x7fffffffffffffff: return 9
+  if uint64 > UINT64_MAX:
+    raise message.EncodeError('Value out of range: %d' % uint64)
+  return 10
+
+
+NON_PACKABLE_TYPES = (
+  descriptor.FieldDescriptor.TYPE_STRING,
+  descriptor.FieldDescriptor.TYPE_GROUP,
+  descriptor.FieldDescriptor.TYPE_MESSAGE,
+  descriptor.FieldDescriptor.TYPE_BYTES
+)
+
+
+def IsTypePackable(field_type):
+  """Return true iff packable = true is valid for fields of this type.
+
+  Args:
+    field_type: a FieldDescriptor::Type value.
+
+  Returns:
+    True iff fields of this type are packable.
+  """
+  return field_type not in NON_PACKABLE_TYPES
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/json_format.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/json_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8f5602f36b112d7ce2615144e496b200d546f8c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/json_format.py
@@ -0,0 +1,865 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains routines for printing protocol messages in JSON format.
+
+Simple usage example:
+
+  # Create a proto object and serialize it to a json format string.
+  message = my_proto_pb2.MyMessage(foo='bar')
+  json_string = json_format.MessageToJson(message)
+
+  # Parse a json format string to proto object.
+  message = json_format.Parse(json_string, my_proto_pb2.MyMessage())
+"""
+
+__author__ = 'jieluo@google.com (Jie Luo)'
+
+# pylint: disable=g-statement-before-imports,g-import-not-at-top
+try:
+  from collections import OrderedDict
+except ImportError:
+  from ordereddict import OrderedDict  # PY26
+# pylint: enable=g-statement-before-imports,g-import-not-at-top
+
+import base64
+import json
+import math
+
+from operator import methodcaller
+
+import re
+import sys
+
+import six
+
+from google.protobuf.internal import type_checkers
+from google.protobuf import descriptor
+from google.protobuf import symbol_database
+
+
+_TIMESTAMPFOMAT = '%Y-%m-%dT%H:%M:%S'
+_INT_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_INT32,
+                        descriptor.FieldDescriptor.CPPTYPE_UINT32,
+                        descriptor.FieldDescriptor.CPPTYPE_INT64,
+                        descriptor.FieldDescriptor.CPPTYPE_UINT64])
+_INT64_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_INT64,
+                          descriptor.FieldDescriptor.CPPTYPE_UINT64])
+_FLOAT_TYPES = frozenset([descriptor.FieldDescriptor.CPPTYPE_FLOAT,
+                          descriptor.FieldDescriptor.CPPTYPE_DOUBLE])
+_INFINITY = 'Infinity'
+_NEG_INFINITY = '-Infinity'
+_NAN = 'NaN'
+
+_UNPAIRED_SURROGATE_PATTERN = re.compile(six.u(
+    r'[\ud800-\udbff](?![\udc00-\udfff])|(?<![\ud800-\udbff])[\udc00-\udfff]'
+))
+
+_VALID_EXTENSION_NAME = re.compile(r'\[[a-zA-Z0-9\._]*\]$')
+
+
+class Error(Exception):
+  """Top-level module error for json_format."""
+
+
+class SerializeToJsonError(Error):
+  """Thrown if serialization to JSON fails."""
+
+
+class ParseError(Error):
+  """Thrown in case of parsing error."""
+
+
+def MessageToJson(
+    message,
+    including_default_value_fields=False,
+    preserving_proto_field_name=False,
+    indent=2,
+    sort_keys=False,
+    use_integers_for_enums=False,
+    descriptor_pool=None,
+    float_precision=None):
+  """Converts protobuf message to JSON format.
+
+  Args:
+    message: The protocol buffers message instance to serialize.
+    including_default_value_fields: If True, singular primitive fields,
+        repeated fields, and map fields will always be serialized.  If
+        False, only serialize non-empty fields.  Singular message fields
+        and oneof fields are not affected by this option.
+    preserving_proto_field_name: If True, use the original proto field
+        names as defined in the .proto file. If False, convert the field
+        names to lowerCamelCase.
+    indent: The JSON object will be pretty-printed with this indent level.
+        An indent level of 0 or negative will only insert newlines.
+    sort_keys: If True, then the output will be sorted by field names.
+    use_integers_for_enums: If true, print integers instead of enum names.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+        default.
+    float_precision: If set, use this to specify float field valid digits.
+
+  Returns:
+    A string containing the JSON formatted protocol buffer message.
+  """
+  printer = _Printer(
+      including_default_value_fields,
+      preserving_proto_field_name,
+      use_integers_for_enums,
+      descriptor_pool,
+      float_precision=float_precision)
+  return printer.ToJsonString(message, indent, sort_keys)
+
+
+def MessageToDict(
+    message,
+    including_default_value_fields=False,
+    preserving_proto_field_name=False,
+    use_integers_for_enums=False,
+    descriptor_pool=None,
+    float_precision=None):
+  """Converts protobuf message to a dictionary.
+
+  When the dictionary is encoded to JSON, it conforms to proto3 JSON spec.
+
+  Args:
+    message: The protocol buffers message instance to serialize.
+    including_default_value_fields: If True, singular primitive fields,
+        repeated fields, and map fields will always be serialized.  If
+        False, only serialize non-empty fields.  Singular message fields
+        and oneof fields are not affected by this option.
+    preserving_proto_field_name: If True, use the original proto field
+        names as defined in the .proto file. If False, convert the field
+        names to lowerCamelCase.
+    use_integers_for_enums: If true, print integers instead of enum names.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+        default.
+    float_precision: If set, use this to specify float field valid digits.
+
+  Returns:
+    A dict representation of the protocol buffer message.
+  """
+  printer = _Printer(
+      including_default_value_fields,
+      preserving_proto_field_name,
+      use_integers_for_enums,
+      descriptor_pool,
+      float_precision=float_precision)
+  # pylint: disable=protected-access
+  return printer._MessageToJsonObject(message)
+
+
+def _IsMapEntry(field):
+  return (field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.message_type.has_options and
+          field.message_type.GetOptions().map_entry)
+
+
+class _Printer(object):
+  """JSON format printer for protocol message."""
+
+  def __init__(
+      self,
+      including_default_value_fields=False,
+      preserving_proto_field_name=False,
+      use_integers_for_enums=False,
+      descriptor_pool=None,
+      float_precision=None):
+    self.including_default_value_fields = including_default_value_fields
+    self.preserving_proto_field_name = preserving_proto_field_name
+    self.use_integers_for_enums = use_integers_for_enums
+    self.descriptor_pool = descriptor_pool
+    if float_precision:
+      self.float_format = '.{}g'.format(float_precision)
+    else:
+      self.float_format = None
+
+  def ToJsonString(self, message, indent, sort_keys):
+    js = self._MessageToJsonObject(message)
+    return json.dumps(js, indent=indent, sort_keys=sort_keys)
+
+  def _MessageToJsonObject(self, message):
+    """Converts message to an object according to Proto3 JSON Specification."""
+    message_descriptor = message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      return self._WrapperMessageToJsonObject(message)
+    if full_name in _WKTJSONMETHODS:
+      return methodcaller(_WKTJSONMETHODS[full_name][0], message)(self)
+    js = {}
+    return self._RegularMessageToJsonObject(message, js)
+
+  def _RegularMessageToJsonObject(self, message, js):
+    """Converts normal message according to Proto3 JSON Specification."""
+    fields = message.ListFields()
+
+    try:
+      for field, value in fields:
+        if self.preserving_proto_field_name:
+          name = field.name
+        else:
+          name = field.json_name
+        if _IsMapEntry(field):
+          # Convert a map field.
+          v_field = field.message_type.fields_by_name['value']
+          js_map = {}
+          for key in value:
+            if isinstance(key, bool):
+              if key:
+                recorded_key = 'true'
+              else:
+                recorded_key = 'false'
+            else:
+              recorded_key = key
+            js_map[recorded_key] = self._FieldToJsonObject(
+                v_field, value[key])
+          js[name] = js_map
+        elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+          # Convert a repeated field.
+          js[name] = [self._FieldToJsonObject(field, k)
+                      for k in value]
+        elif field.is_extension:
+          name = '[%s]' % field.full_name
+          js[name] = self._FieldToJsonObject(field, value)
+        else:
+          js[name] = self._FieldToJsonObject(field, value)
+
+      # Serialize default value if including_default_value_fields is True.
+      if self.including_default_value_fields:
+        message_descriptor = message.DESCRIPTOR
+        for field in message_descriptor.fields:
+          # Singular message fields and oneof fields will not be affected.
+          if ((field.label != descriptor.FieldDescriptor.LABEL_REPEATED and
+               field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE) or
+              field.containing_oneof):
+            continue
+          if self.preserving_proto_field_name:
+            name = field.name
+          else:
+            name = field.json_name
+          if name in js:
+            # Skip the field which has been serialized already.
+            continue
+          if _IsMapEntry(field):
+            js[name] = {}
+          elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+            js[name] = []
+          else:
+            js[name] = self._FieldToJsonObject(field, field.default_value)
+
+    except ValueError as e:
+      raise SerializeToJsonError(
+          'Failed to serialize {0} field: {1}.'.format(field.name, e))
+
+    return js
+
+  def _FieldToJsonObject(self, field, value):
+    """Converts field value according to Proto3 JSON Specification."""
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+      return self._MessageToJsonObject(value)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+      if self.use_integers_for_enums:
+        return value
+      if field.enum_type.full_name == 'google.protobuf.NullValue':
+        return None
+      enum_value = field.enum_type.values_by_number.get(value, None)
+      if enum_value is not None:
+        return enum_value.name
+      else:
+        if field.file.syntax == 'proto3':
+          return value
+        raise SerializeToJsonError('Enum field contains an integer value '
+                                   'which can not mapped to an enum value.')
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+      if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        # Use base64 Data encoding for bytes
+        return base64.b64encode(value).decode('utf-8')
+      else:
+        return value
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+      return bool(value)
+    elif field.cpp_type in _INT64_TYPES:
+      return str(value)
+    elif field.cpp_type in _FLOAT_TYPES:
+      if math.isinf(value):
+        if value < 0.0:
+          return _NEG_INFINITY
+        else:
+          return _INFINITY
+      if math.isnan(value):
+        return _NAN
+      if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+        if self.float_format:
+          return float(format(value, self.float_format))
+        else:
+          return type_checkers.ToShortestFloat(value)
+
+    return value
+
+  def _AnyMessageToJsonObject(self, message):
+    """Converts Any message according to Proto3 JSON Specification."""
+    if not message.ListFields():
+      return {}
+    # Must print @type first, use OrderedDict instead of {}
+    js = OrderedDict()
+    type_url = message.type_url
+    js['@type'] = type_url
+    sub_message = _CreateMessageFromTypeUrl(type_url, self.descriptor_pool)
+    sub_message.ParseFromString(message.value)
+    message_descriptor = sub_message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      js['value'] = self._WrapperMessageToJsonObject(sub_message)
+      return js
+    if full_name in _WKTJSONMETHODS:
+      js['value'] = methodcaller(_WKTJSONMETHODS[full_name][0],
+                                 sub_message)(self)
+      return js
+    return self._RegularMessageToJsonObject(sub_message, js)
+
+  def _GenericMessageToJsonObject(self, message):
+    """Converts message according to Proto3 JSON Specification."""
+    # Duration, Timestamp and FieldMask have ToJsonString method to do the
+    # convert. Users can also call the method directly.
+    return message.ToJsonString()
+
+  def _ValueMessageToJsonObject(self, message):
+    """Converts Value message according to Proto3 JSON Specification."""
+    which = message.WhichOneof('kind')
+    # If the Value message is not set treat as null_value when serialize
+    # to JSON. The parse back result will be different from original message.
+    if which is None or which == 'null_value':
+      return None
+    if which == 'list_value':
+      return self._ListValueMessageToJsonObject(message.list_value)
+    if which == 'struct_value':
+      value = message.struct_value
+    else:
+      value = getattr(message, which)
+    oneof_descriptor = message.DESCRIPTOR.fields_by_name[which]
+    return self._FieldToJsonObject(oneof_descriptor, value)
+
+  def _ListValueMessageToJsonObject(self, message):
+    """Converts ListValue message according to Proto3 JSON Specification."""
+    return [self._ValueMessageToJsonObject(value)
+            for value in message.values]
+
+  def _StructMessageToJsonObject(self, message):
+    """Converts Struct message according to Proto3 JSON Specification."""
+    fields = message.fields
+    ret = {}
+    for key in fields:
+      ret[key] = self._ValueMessageToJsonObject(fields[key])
+    return ret
+
+  def _WrapperMessageToJsonObject(self, message):
+    return self._FieldToJsonObject(
+        message.DESCRIPTOR.fields_by_name['value'], message.value)
+
+
+def _IsWrapperMessage(message_descriptor):
+  return message_descriptor.file.name == 'google/protobuf/wrappers.proto'
+
+
+def _DuplicateChecker(js):
+  result = {}
+  for name, value in js:
+    if name in result:
+      raise ParseError('Failed to load JSON: duplicate key {0}.'.format(name))
+    result[name] = value
+  return result
+
+
+def _CreateMessageFromTypeUrl(type_url, descriptor_pool):
+  """Creates a message from a type URL."""
+  db = symbol_database.Default()
+  pool = db.pool if descriptor_pool is None else descriptor_pool
+  type_name = type_url.split('/')[-1]
+  try:
+    message_descriptor = pool.FindMessageTypeByName(type_name)
+  except KeyError:
+    raise TypeError(
+        'Can not find message descriptor by type_url: {0}.'.format(type_url))
+  message_class = db.GetPrototype(message_descriptor)
+  return message_class()
+
+
+def Parse(text, message, ignore_unknown_fields=False, descriptor_pool=None):
+  """Parses a JSON representation of a protocol message into a message.
+
+  Args:
+    text: Message JSON representation.
+    message: A protocol buffer message to merge into.
+    ignore_unknown_fields: If True, do not raise errors for unknown fields.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+        default.
+
+  Returns:
+    The same message passed as argument.
+
+  Raises::
+    ParseError: On JSON parsing problems.
+  """
+  if not isinstance(text, six.text_type): text = text.decode('utf-8')
+  try:
+    js = json.loads(text, object_pairs_hook=_DuplicateChecker)
+  except ValueError as e:
+    raise ParseError('Failed to load JSON: {0}.'.format(str(e)))
+  return ParseDict(js, message, ignore_unknown_fields, descriptor_pool)
+
+
+def ParseDict(js_dict,
+              message,
+              ignore_unknown_fields=False,
+              descriptor_pool=None):
+  """Parses a JSON dictionary representation into a message.
+
+  Args:
+    js_dict: Dict representation of a JSON message.
+    message: A protocol buffer message to merge into.
+    ignore_unknown_fields: If True, do not raise errors for unknown fields.
+    descriptor_pool: A Descriptor Pool for resolving types. If None use the
+      default.
+
+  Returns:
+    The same message passed as argument.
+  """
+  parser = _Parser(ignore_unknown_fields, descriptor_pool)
+  parser.ConvertMessage(js_dict, message)
+  return message
+
+
+_INT_OR_FLOAT = six.integer_types + (float,)
+
+
+class _Parser(object):
+  """JSON format parser for protocol message."""
+
+  def __init__(self, ignore_unknown_fields, descriptor_pool):
+    self.ignore_unknown_fields = ignore_unknown_fields
+    self.descriptor_pool = descriptor_pool
+
+  def ConvertMessage(self, value, message):
+    """Convert a JSON object into a message.
+
+    Args:
+      value: A JSON object.
+      message: A WKT or regular protocol message to record the data.
+
+    Raises:
+      ParseError: In case of convert problems.
+    """
+    message_descriptor = message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      self._ConvertWrapperMessage(value, message)
+    elif full_name in _WKTJSONMETHODS:
+      methodcaller(_WKTJSONMETHODS[full_name][1], value, message)(self)
+    else:
+      self._ConvertFieldValuePair(value, message)
+
+  def _ConvertFieldValuePair(self, js, message):
+    """Convert field value pairs into regular message.
+
+    Args:
+      js: A JSON object to convert the field value pairs.
+      message: A regular protocol message to record the data.
+
+    Raises:
+      ParseError: In case of problems converting.
+    """
+    names = []
+    message_descriptor = message.DESCRIPTOR
+    fields_by_json_name = dict((f.json_name, f)
+                               for f in message_descriptor.fields)
+    for name in js:
+      try:
+        field = fields_by_json_name.get(name, None)
+        if not field:
+          field = message_descriptor.fields_by_name.get(name, None)
+        if not field and _VALID_EXTENSION_NAME.match(name):
+          if not message_descriptor.is_extendable:
+            raise ParseError('Message type {0} does not have extensions'.format(
+                message_descriptor.full_name))
+          identifier = name[1:-1]  # strip [] brackets
+          # pylint: disable=protected-access
+          field = message.Extensions._FindExtensionByName(identifier)
+          # pylint: enable=protected-access
+          if not field:
+            # Try looking for extension by the message type name, dropping the
+            # field name following the final . separator in full_name.
+            identifier = '.'.join(identifier.split('.')[:-1])
+            # pylint: disable=protected-access
+            field = message.Extensions._FindExtensionByName(identifier)
+            # pylint: enable=protected-access
+        if not field:
+          if self.ignore_unknown_fields:
+            continue
+          raise ParseError(
+              ('Message type "{0}" has no field named "{1}".\n'
+               ' Available Fields(except extensions): {2}').format(
+                   message_descriptor.full_name, name,
+                   [f.json_name for f in message_descriptor.fields]))
+        if name in names:
+          raise ParseError('Message type "{0}" should not have multiple '
+                           '"{1}" fields.'.format(
+                               message.DESCRIPTOR.full_name, name))
+        names.append(name)
+        # Check no other oneof field is parsed.
+        if field.containing_oneof is not None:
+          oneof_name = field.containing_oneof.name
+          if oneof_name in names:
+            raise ParseError('Message type "{0}" should not have multiple '
+                             '"{1}" oneof fields.'.format(
+                                 message.DESCRIPTOR.full_name, oneof_name))
+          names.append(oneof_name)
+
+        value = js[name]
+        if value is None:
+          if (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE
+              and field.message_type.full_name == 'google.protobuf.Value'):
+            sub_message = getattr(message, field.name)
+            sub_message.null_value = 0
+          elif (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM
+                and field.enum_type.full_name == 'google.protobuf.NullValue'):
+            setattr(message, field.name, 0)
+          else:
+            message.ClearField(field.name)
+          continue
+
+        # Parse field value.
+        if _IsMapEntry(field):
+          message.ClearField(field.name)
+          self._ConvertMapFieldValue(value, message, field)
+        elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+          message.ClearField(field.name)
+          if not isinstance(value, list):
+            raise ParseError('repeated field {0} must be in [] which is '
+                             '{1}.'.format(name, value))
+          if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+            # Repeated message field.
+            for item in value:
+              sub_message = getattr(message, field.name).add()
+              # None is a null_value in Value.
+              if (item is None and
+                  sub_message.DESCRIPTOR.full_name != 'google.protobuf.Value'):
+                raise ParseError('null is not allowed to be used as an element'
+                                 ' in a repeated field.')
+              self.ConvertMessage(item, sub_message)
+          else:
+            # Repeated scalar field.
+            for item in value:
+              if item is None:
+                raise ParseError('null is not allowed to be used as an element'
+                                 ' in a repeated field.')
+              getattr(message, field.name).append(
+                  _ConvertScalarFieldValue(item, field))
+        elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+          if field.is_extension:
+            sub_message = message.Extensions[field]
+          else:
+            sub_message = getattr(message, field.name)
+          sub_message.SetInParent()
+          self.ConvertMessage(value, sub_message)
+        else:
+          if field.is_extension:
+            message.Extensions[field] = _ConvertScalarFieldValue(value, field)
+          else:
+            setattr(message, field.name, _ConvertScalarFieldValue(value, field))
+      except ParseError as e:
+        if field and field.containing_oneof is None:
+          raise ParseError('Failed to parse {0} field: {1}.'.format(name, e))
+        else:
+          raise ParseError(str(e))
+      except ValueError as e:
+        raise ParseError('Failed to parse {0} field: {1}.'.format(name, e))
+      except TypeError as e:
+        raise ParseError('Failed to parse {0} field: {1}.'.format(name, e))
+
+  def _ConvertAnyMessage(self, value, message):
+    """Convert a JSON representation into Any message."""
+    if isinstance(value, dict) and not value:
+      return
+    try:
+      type_url = value['@type']
+    except KeyError:
+      raise ParseError('@type is missing when parsing any message.')
+
+    sub_message = _CreateMessageFromTypeUrl(type_url, self.descriptor_pool)
+    message_descriptor = sub_message.DESCRIPTOR
+    full_name = message_descriptor.full_name
+    if _IsWrapperMessage(message_descriptor):
+      self._ConvertWrapperMessage(value['value'], sub_message)
+    elif full_name in _WKTJSONMETHODS:
+      methodcaller(
+          _WKTJSONMETHODS[full_name][1], value['value'], sub_message)(self)
+    else:
+      del value['@type']
+      self._ConvertFieldValuePair(value, sub_message)
+      value['@type'] = type_url
+    # Sets Any message
+    message.value = sub_message.SerializeToString()
+    message.type_url = type_url
+
+  def _ConvertGenericMessage(self, value, message):
+    """Convert a JSON representation into message with FromJsonString."""
+    # Duration, Timestamp, FieldMask have a FromJsonString method to do the
+    # conversion. Users can also call the method directly.
+    try:
+      message.FromJsonString(value)
+    except ValueError as e:
+      raise ParseError(e)
+
+  def _ConvertValueMessage(self, value, message):
+    """Convert a JSON representation into Value message."""
+    if isinstance(value, dict):
+      self._ConvertStructMessage(value, message.struct_value)
+    elif isinstance(value, list):
+      self. _ConvertListValueMessage(value, message.list_value)
+    elif value is None:
+      message.null_value = 0
+    elif isinstance(value, bool):
+      message.bool_value = value
+    elif isinstance(value, six.string_types):
+      message.string_value = value
+    elif isinstance(value, _INT_OR_FLOAT):
+      message.number_value = value
+    else:
+      raise ParseError('Value {0} has unexpected type {1}.'.format(
+          value, type(value)))
+
+  def _ConvertListValueMessage(self, value, message):
+    """Convert a JSON representation into ListValue message."""
+    if not isinstance(value, list):
+      raise ParseError(
+          'ListValue must be in [] which is {0}.'.format(value))
+    message.ClearField('values')
+    for item in value:
+      self._ConvertValueMessage(item, message.values.add())
+
+  def _ConvertStructMessage(self, value, message):
+    """Convert a JSON representation into Struct message."""
+    if not isinstance(value, dict):
+      raise ParseError(
+          'Struct must be in a dict which is {0}.'.format(value))
+    # Clear will mark the struct as modified so it will be created even if
+    # there are no values.
+    message.Clear()
+    for key in value:
+      self._ConvertValueMessage(value[key], message.fields[key])
+    return
+
+  def _ConvertWrapperMessage(self, value, message):
+    """Convert a JSON representation into Wrapper message."""
+    field = message.DESCRIPTOR.fields_by_name['value']
+    setattr(message, 'value', _ConvertScalarFieldValue(value, field))
+
+  def _ConvertMapFieldValue(self, value, message, field):
+    """Convert map field value for a message map field.
+
+    Args:
+      value: A JSON object to convert the map field value.
+      message: A protocol message to record the converted data.
+      field: The descriptor of the map field to be converted.
+
+    Raises:
+      ParseError: In case of convert problems.
+    """
+    if not isinstance(value, dict):
+      raise ParseError(
+          'Map field {0} must be in a dict which is {1}.'.format(
+              field.name, value))
+    key_field = field.message_type.fields_by_name['key']
+    value_field = field.message_type.fields_by_name['value']
+    for key in value:
+      key_value = _ConvertScalarFieldValue(key, key_field, True)
+      if value_field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        self.ConvertMessage(value[key], getattr(
+            message, field.name)[key_value])
+      else:
+        getattr(message, field.name)[key_value] = _ConvertScalarFieldValue(
+            value[key], value_field)
+
+
+def _ConvertScalarFieldValue(value, field, require_str=False):
+  """Convert a single scalar field value.
+
+  Args:
+    value: A scalar value to convert the scalar field value.
+    field: The descriptor of the field to convert.
+    require_str: If True, the field value must be a str.
+
+  Returns:
+    The converted scalar field value
+
+  Raises:
+    ParseError: In case of convert problems.
+  """
+  if field.cpp_type in _INT_TYPES:
+    return _ConvertInteger(value)
+  elif field.cpp_type in _FLOAT_TYPES:
+    return _ConvertFloat(value, field)
+  elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+    return _ConvertBool(value, require_str)
+  elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+    if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+      if isinstance(value, six.text_type):
+        encoded = value.encode('utf-8')
+      else:
+        encoded = value
+      # Add extra padding '='
+      padded_value = encoded + b'=' * (4 - len(encoded) % 4)
+      return base64.urlsafe_b64decode(padded_value)
+    else:
+      # Checking for unpaired surrogates appears to be unreliable,
+      # depending on the specific Python version, so we check manually.
+      if _UNPAIRED_SURROGATE_PATTERN.search(value):
+        raise ParseError('Unpaired surrogate')
+      return value
+  elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+    # Convert an enum value.
+    enum_value = field.enum_type.values_by_name.get(value, None)
+    if enum_value is None:
+      try:
+        number = int(value)
+        enum_value = field.enum_type.values_by_number.get(number, None)
+      except ValueError:
+        raise ParseError('Invalid enum value {0} for enum type {1}.'.format(
+            value, field.enum_type.full_name))
+      if enum_value is None:
+        if field.file.syntax == 'proto3':
+          # Proto3 accepts unknown enums.
+          return number
+        raise ParseError('Invalid enum value {0} for enum type {1}.'.format(
+            value, field.enum_type.full_name))
+    return enum_value.number
+
+
+def _ConvertInteger(value):
+  """Convert an integer.
+
+  Args:
+    value: A scalar value to convert.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ParseError: If an integer couldn't be consumed.
+  """
+  if isinstance(value, float) and not value.is_integer():
+    raise ParseError('Couldn\'t parse integer: {0}.'.format(value))
+
+  if isinstance(value, six.text_type) and value.find(' ') != -1:
+    raise ParseError('Couldn\'t parse integer: "{0}".'.format(value))
+
+  if isinstance(value, bool):
+    raise ParseError('Bool value {0} is not acceptable for '
+                     'integer field.'.format(value))
+
+  return int(value)
+
+
+def _ConvertFloat(value, field):
+  """Convert an floating point number."""
+  if isinstance(value, float):
+    if math.isnan(value):
+      raise ParseError('Couldn\'t parse NaN, use quoted "NaN" instead.')
+    if math.isinf(value):
+      if value > 0:
+        raise ParseError('Couldn\'t parse Infinity or value too large, '
+                         'use quoted "Infinity" instead.')
+      else:
+        raise ParseError('Couldn\'t parse -Infinity or value too small, '
+                         'use quoted "-Infinity" instead.')
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+      # pylint: disable=protected-access
+      if value > type_checkers._FLOAT_MAX:
+        raise ParseError('Float value too large')
+      # pylint: disable=protected-access
+      if value < type_checkers._FLOAT_MIN:
+        raise ParseError('Float value too small')
+  if value == 'nan':
+    raise ParseError('Couldn\'t parse float "nan", use "NaN" instead.')
+  try:
+    # Assume Python compatible syntax.
+    return float(value)
+  except ValueError:
+    # Check alternative spellings.
+    if value == _NEG_INFINITY:
+      return float('-inf')
+    elif value == _INFINITY:
+      return float('inf')
+    elif value == _NAN:
+      return float('nan')
+    else:
+      raise ParseError('Couldn\'t parse float: {0}.'.format(value))
+
+
+def _ConvertBool(value, require_str):
+  """Convert a boolean value.
+
+  Args:
+    value: A scalar value to convert.
+    require_str: If True, value must be a str.
+
+  Returns:
+    The bool parsed.
+
+  Raises:
+    ParseError: If a boolean value couldn't be consumed.
+  """
+  if require_str:
+    if value == 'true':
+      return True
+    elif value == 'false':
+      return False
+    else:
+      raise ParseError('Expected "true" or "false", not {0}.'.format(value))
+
+  if not isinstance(value, bool):
+    raise ParseError('Expected true or false without quotes.')
+  return value
+
+_WKTJSONMETHODS = {
+    'google.protobuf.Any': ['_AnyMessageToJsonObject',
+                            '_ConvertAnyMessage'],
+    'google.protobuf.Duration': ['_GenericMessageToJsonObject',
+                                 '_ConvertGenericMessage'],
+    'google.protobuf.FieldMask': ['_GenericMessageToJsonObject',
+                                  '_ConvertGenericMessage'],
+    'google.protobuf.ListValue': ['_ListValueMessageToJsonObject',
+                                  '_ConvertListValueMessage'],
+    'google.protobuf.Struct': ['_StructMessageToJsonObject',
+                               '_ConvertStructMessage'],
+    'google.protobuf.Timestamp': ['_GenericMessageToJsonObject',
+                                  '_ConvertGenericMessage'],
+    'google.protobuf.Value': ['_ValueMessageToJsonObject',
+                              '_ConvertValueMessage']
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message.py
new file mode 100644
index 0000000000000000000000000000000000000000..224d2fc49178169fbe5add2a1989e839d154c746
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message.py
@@ -0,0 +1,413 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# TODO(robinson): We should just make these methods all "pure-virtual" and move
+# all implementation out, into reflection.py for now.
+
+
+"""Contains an abstract base class for protocol messages."""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+class Error(Exception):
+  """Base error type for this module."""
+  pass
+
+
+class DecodeError(Error):
+  """Exception raised when deserializing messages."""
+  pass
+
+
+class EncodeError(Error):
+  """Exception raised when serializing messages."""
+  pass
+
+
+class Message(object):
+
+  """Abstract base class for protocol messages.
+
+  Protocol message classes are almost always generated by the protocol
+  compiler.  These generated types subclass Message and implement the methods
+  shown below.
+  """
+
+  # TODO(robinson): Link to an HTML document here.
+
+  # TODO(robinson): Document that instances of this class will also
+  # have an Extensions attribute with __getitem__ and __setitem__.
+  # Again, not sure how to best convey this.
+
+  # TODO(robinson): Document that the class must also have a static
+  #   RegisterExtension(extension_field) method.
+  #   Not sure how to best express at this point.
+
+  # TODO(robinson): Document these fields and methods.
+
+  __slots__ = []
+
+  #: The :class:`google.protobuf.descriptor.Descriptor` for this message type.
+  DESCRIPTOR = None
+
+  def __deepcopy__(self, memo=None):
+    clone = type(self)()
+    clone.MergeFrom(self)
+    return clone
+
+  def __eq__(self, other_msg):
+    """Recursively compares two messages by value and structure."""
+    raise NotImplementedError
+
+  def __ne__(self, other_msg):
+    # Can't just say self != other_msg, since that would infinitely recurse. :)
+    return not self == other_msg
+
+  def __hash__(self):
+    raise TypeError('unhashable object')
+
+  def __str__(self):
+    """Outputs a human-readable representation of the message."""
+    raise NotImplementedError
+
+  def __unicode__(self):
+    """Outputs a human-readable representation of the message."""
+    raise NotImplementedError
+
+  def MergeFrom(self, other_msg):
+    """Merges the contents of the specified message into current message.
+
+    This method merges the contents of the specified message into the current
+    message. Singular fields that are set in the specified message overwrite
+    the corresponding fields in the current message. Repeated fields are
+    appended. Singular sub-messages and groups are recursively merged.
+
+    Args:
+      other_msg (Message): A message to merge into the current message.
+    """
+    raise NotImplementedError
+
+  def CopyFrom(self, other_msg):
+    """Copies the content of the specified message into the current message.
+
+    The method clears the current message and then merges the specified
+    message using MergeFrom.
+
+    Args:
+      other_msg (Message): A message to copy into the current one.
+    """
+    if self is other_msg:
+      return
+    self.Clear()
+    self.MergeFrom(other_msg)
+
+  def Clear(self):
+    """Clears all data that was set in the message."""
+    raise NotImplementedError
+
+  def SetInParent(self):
+    """Mark this as present in the parent.
+
+    This normally happens automatically when you assign a field of a
+    sub-message, but sometimes you want to make the sub-message
+    present while keeping it empty.  If you find yourself using this,
+    you may want to reconsider your design.
+    """
+    raise NotImplementedError
+
+  def IsInitialized(self):
+    """Checks if the message is initialized.
+
+    Returns:
+      bool: The method returns True if the message is initialized (i.e. all of
+      its required fields are set).
+    """
+    raise NotImplementedError
+
+  # TODO(robinson): MergeFromString() should probably return None and be
+  # implemented in terms of a helper that returns the # of bytes read.  Our
+  # deserialization routines would use the helper when recursively
+  # deserializing, but the end user would almost always just want the no-return
+  # MergeFromString().
+
+  def MergeFromString(self, serialized):
+    """Merges serialized protocol buffer data into this message.
+
+    When we find a field in `serialized` that is already present
+    in this message:
+
+    -   If it's a "repeated" field, we append to the end of our list.
+    -   Else, if it's a scalar, we overwrite our field.
+    -   Else, (it's a nonrepeated composite), we recursively merge
+        into the existing composite.
+
+    Args:
+      serialized (bytes): Any object that allows us to call
+        ``memoryview(serialized)`` to access a string of bytes using the
+        buffer interface.
+
+    Returns:
+      int: The number of bytes read from `serialized`.
+      For non-group messages, this will always be `len(serialized)`,
+      but for messages which are actually groups, this will
+      generally be less than `len(serialized)`, since we must
+      stop when we reach an ``END_GROUP`` tag.  Note that if
+      we *do* stop because of an ``END_GROUP`` tag, the number
+      of bytes returned does not include the bytes
+      for the ``END_GROUP`` tag information.
+
+    Raises:
+      DecodeError: if the input cannot be parsed.
+    """
+    # TODO(robinson): Document handling of unknown fields.
+    # TODO(robinson): When we switch to a helper, this will return None.
+    raise NotImplementedError
+
+  def ParseFromString(self, serialized):
+    """Parse serialized protocol buffer data into this message.
+
+    Like :func:`MergeFromString()`, except we clear the object first.
+    """
+    self.Clear()
+    return self.MergeFromString(serialized)
+
+  def SerializeToString(self, **kwargs):
+    """Serializes the protocol message to a binary string.
+
+    Keyword Args:
+      deterministic (bool): If true, requests deterministic serialization
+        of the protobuf, with predictable ordering of map keys.
+
+    Returns:
+      A binary string representation of the message if all of the required
+      fields in the message are set (i.e. the message is initialized).
+
+    Raises:
+      EncodeError: if the message isn't initialized (see :func:`IsInitialized`).
+    """
+    raise NotImplementedError
+
+  def SerializePartialToString(self, **kwargs):
+    """Serializes the protocol message to a binary string.
+
+    This method is similar to SerializeToString but doesn't check if the
+    message is initialized.
+
+    Keyword Args:
+      deterministic (bool): If true, requests deterministic serialization
+        of the protobuf, with predictable ordering of map keys.
+
+    Returns:
+      bytes: A serialized representation of the partial message.
+    """
+    raise NotImplementedError
+
+  # TODO(robinson): Decide whether we like these better
+  # than auto-generated has_foo() and clear_foo() methods
+  # on the instances themselves.  This way is less consistent
+  # with C++, but it makes reflection-type access easier and
+  # reduces the number of magically autogenerated things.
+  #
+  # TODO(robinson): Be sure to document (and test) exactly
+  # which field names are accepted here.  Are we case-sensitive?
+  # What do we do with fields that share names with Python keywords
+  # like 'lambda' and 'yield'?
+  #
+  # nnorwitz says:
+  # """
+  # Typically (in python), an underscore is appended to names that are
+  # keywords. So they would become lambda_ or yield_.
+  # """
+  def ListFields(self):
+    """Returns a list of (FieldDescriptor, value) tuples for present fields.
+
+    A message field is non-empty if HasField() would return true. A singular
+    primitive field is non-empty if HasField() would return true in proto2 or it
+    is non zero in proto3. A repeated field is non-empty if it contains at least
+    one element. The fields are ordered by field number.
+
+    Returns:
+      list[tuple(FieldDescriptor, value)]: field descriptors and values
+      for all fields in the message which are not empty. The values vary by
+      field type.
+    """
+    raise NotImplementedError
+
+  def HasField(self, field_name):
+    """Checks if a certain field is set for the message.
+
+    For a oneof group, checks if any field inside is set. Note that if the
+    field_name is not defined in the message descriptor, :exc:`ValueError` will
+    be raised.
+
+    Args:
+      field_name (str): The name of the field to check for presence.
+
+    Returns:
+      bool: Whether a value has been set for the named field.
+
+    Raises:
+      ValueError: if the `field_name` is not a member of this message.
+    """
+    raise NotImplementedError
+
+  def ClearField(self, field_name):
+    """Clears the contents of a given field.
+
+    Inside a oneof group, clears the field set. If the name neither refers to a
+    defined field or oneof group, :exc:`ValueError` is raised.
+
+    Args:
+      field_name (str): The name of the field to check for presence.
+
+    Raises:
+      ValueError: if the `field_name` is not a member of this message.
+    """
+    raise NotImplementedError
+
+  def WhichOneof(self, oneof_group):
+    """Returns the name of the field that is set inside a oneof group.
+
+    If no field is set, returns None.
+
+    Args:
+      oneof_group (str): the name of the oneof group to check.
+
+    Returns:
+      str or None: The name of the group that is set, or None.
+
+    Raises:
+      ValueError: no group with the given name exists
+    """
+    raise NotImplementedError
+
+  def HasExtension(self, extension_handle):
+    """Checks if a certain extension is present for this message.
+
+    Extensions are retrieved using the :attr:`Extensions` mapping (if present).
+
+    Args:
+      extension_handle: The handle for the extension to check.
+
+    Returns:
+      bool: Whether the extension is present for this message.
+
+    Raises:
+      KeyError: if the extension is repeated. Similar to repeated fields,
+        there is no separate notion of presence: a "not present" repeated
+        extension is an empty list.
+    """
+    raise NotImplementedError
+
+  def ClearExtension(self, extension_handle):
+    """Clears the contents of a given extension.
+
+    Args:
+      extension_handle: The handle for the extension to clear.
+    """
+    raise NotImplementedError
+
+  def UnknownFields(self):
+    """Returns the UnknownFieldSet.
+
+    Returns:
+      UnknownFieldSet: The unknown fields stored in this message.
+    """
+    raise NotImplementedError
+
+  def DiscardUnknownFields(self):
+    """Clears all fields in the :class:`UnknownFieldSet`.
+
+    This operation is recursive for nested message.
+    """
+    raise NotImplementedError
+
+  def ByteSize(self):
+    """Returns the serialized size of this message.
+
+    Recursively calls ByteSize() on all contained messages.
+
+    Returns:
+      int: The number of bytes required to serialize this message.
+    """
+    raise NotImplementedError
+
+  def _SetListener(self, message_listener):
+    """Internal method used by the protocol message implementation.
+    Clients should not call this directly.
+
+    Sets a listener that this message will call on certain state transitions.
+
+    The purpose of this method is to register back-edges from children to
+    parents at runtime, for the purpose of setting "has" bits and
+    byte-size-dirty bits in the parent and ancestor objects whenever a child or
+    descendant object is modified.
+
+    If the client wants to disconnect this Message from the object tree, she
+    explicitly sets callback to None.
+
+    If message_listener is None, unregisters any existing listener.  Otherwise,
+    message_listener must implement the MessageListener interface in
+    internal/message_listener.py, and we discard any listener registered
+    via a previous _SetListener() call.
+    """
+    raise NotImplementedError
+
+  def __getstate__(self):
+    """Support the pickle protocol."""
+    return dict(serialized=self.SerializePartialToString())
+
+  def __setstate__(self, state):
+    """Support the pickle protocol."""
+    self.__init__()
+    serialized = state['serialized']
+    # On Python 3, using encoding='latin1' is required for unpickling
+    # protos pickled by Python 2.
+    if not isinstance(serialized, bytes):
+      serialized = serialized.encode('latin1')
+    self.ParseFromString(serialized)
+
+  def __reduce__(self):
+    message_descriptor = self.DESCRIPTOR
+    if message_descriptor.containing_type is None:
+      return type(self), (), self.__getstate__()
+    # the message type must be nested.
+    # Python does not pickle nested classes; use the symbol_database on the
+    # receiving end.
+    container = message_descriptor
+    return (_InternalConstructMessage, (container.full_name,),
+            self.__getstate__())
+
+
+def _InternalConstructMessage(full_name):
+  """Constructs a nested message."""
+  from google.protobuf import symbol_database  # pylint:disable=g-import-not-at-top
+
+  return symbol_database.Default().GetSymbol(full_name)()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message_factory.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message_factory.py
new file mode 100644
index 0000000000000000000000000000000000000000..7dfaec88e15e176adb7363c288c53d189b37a294
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/message_factory.py
@@ -0,0 +1,187 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Provides a factory class for generating dynamic messages.
+
+The easiest way to use this class is if you have access to the FileDescriptor
+protos containing the messages you want to create you can just do the following:
+
+message_classes = message_factory.GetMessages(iterable_of_file_descriptors)
+my_proto_instance = message_classes['some.proto.package.MessageName']()
+"""
+
+__author__ = 'matthewtoia@google.com (Matt Toia)'
+
+from google.protobuf.internal import api_implementation
+from google.protobuf import descriptor_pool
+from google.protobuf import message
+
+if api_implementation.Type() == 'cpp':
+  from google.protobuf.pyext import cpp_message as message_impl
+else:
+  from google.protobuf.internal import python_message as message_impl
+
+
+# The type of all Message classes.
+_GENERATED_PROTOCOL_MESSAGE_TYPE = message_impl.GeneratedProtocolMessageType
+
+
+class MessageFactory(object):
+  """Factory for creating Proto2 messages from descriptors in a pool."""
+
+  def __init__(self, pool=None):
+    """Initializes a new factory."""
+    self.pool = pool or descriptor_pool.DescriptorPool()
+
+    # local cache of all classes built from protobuf descriptors
+    self._classes = {}
+
+  def GetPrototype(self, descriptor):
+    """Obtains a proto2 message class based on the passed in descriptor.
+
+    Passing a descriptor with a fully qualified name matching a previous
+    invocation will cause the same class to be returned.
+
+    Args:
+      descriptor: The descriptor to build from.
+
+    Returns:
+      A class describing the passed in descriptor.
+    """
+    if descriptor not in self._classes:
+      result_class = self.CreatePrototype(descriptor)
+      # The assignment to _classes is redundant for the base implementation, but
+      # might avoid confusion in cases where CreatePrototype gets overridden and
+      # does not call the base implementation.
+      self._classes[descriptor] = result_class
+      return result_class
+    return self._classes[descriptor]
+
+  def CreatePrototype(self, descriptor):
+    """Builds a proto2 message class based on the passed in descriptor.
+
+    Don't call this function directly, it always creates a new class. Call
+    GetPrototype() instead. This method is meant to be overridden in subblasses
+    to perform additional operations on the newly constructed class.
+
+    Args:
+      descriptor: The descriptor to build from.
+
+    Returns:
+      A class describing the passed in descriptor.
+    """
+    descriptor_name = descriptor.name
+    if str is bytes:  # PY2
+      descriptor_name = descriptor.name.encode('ascii', 'ignore')
+    result_class = _GENERATED_PROTOCOL_MESSAGE_TYPE(
+        descriptor_name,
+        (message.Message,),
+        {
+            'DESCRIPTOR': descriptor,
+            # If module not set, it wrongly points to message_factory module.
+            '__module__': None,
+        })
+    result_class._FACTORY = self  # pylint: disable=protected-access
+    # Assign in _classes before doing recursive calls to avoid infinite
+    # recursion.
+    self._classes[descriptor] = result_class
+    for field in descriptor.fields:
+      if field.message_type:
+        self.GetPrototype(field.message_type)
+    for extension in result_class.DESCRIPTOR.extensions:
+      if extension.containing_type not in self._classes:
+        self.GetPrototype(extension.containing_type)
+      extended_class = self._classes[extension.containing_type]
+      extended_class.RegisterExtension(extension)
+    return result_class
+
+  def GetMessages(self, files):
+    """Gets all the messages from a specified file.
+
+    This will find and resolve dependencies, failing if the descriptor
+    pool cannot satisfy them.
+
+    Args:
+      files: The file names to extract messages from.
+
+    Returns:
+      A dictionary mapping proto names to the message classes. This will include
+      any dependent messages as well as any messages defined in the same file as
+      a specified message.
+    """
+    result = {}
+    for file_name in files:
+      file_desc = self.pool.FindFileByName(file_name)
+      for desc in file_desc.message_types_by_name.values():
+        result[desc.full_name] = self.GetPrototype(desc)
+
+      # While the extension FieldDescriptors are created by the descriptor pool,
+      # the python classes created in the factory need them to be registered
+      # explicitly, which is done below.
+      #
+      # The call to RegisterExtension will specifically check if the
+      # extension was already registered on the object and either
+      # ignore the registration if the original was the same, or raise
+      # an error if they were different.
+
+      for extension in file_desc.extensions_by_name.values():
+        if extension.containing_type not in self._classes:
+          self.GetPrototype(extension.containing_type)
+        extended_class = self._classes[extension.containing_type]
+        extended_class.RegisterExtension(extension)
+    return result
+
+
+_FACTORY = MessageFactory()
+
+
+def GetMessages(file_protos):
+  """Builds a dictionary of all the messages available in a set of files.
+
+  Args:
+    file_protos: Iterable of FileDescriptorProto to build messages out of.
+
+  Returns:
+    A dictionary mapping proto names to the message classes. This will include
+    any dependent messages as well as any messages defined in the same file as
+    a specified message.
+  """
+  # The cpp implementation of the protocol buffer library requires to add the
+  # message in topological order of the dependency graph.
+  file_by_name = {file_proto.name: file_proto for file_proto in file_protos}
+  def _AddFile(file_proto):
+    for dependency in file_proto.dependency:
+      if dependency in file_by_name:
+        # Remove from elements to be visited, in order to cut cycles.
+        _AddFile(file_by_name.pop(dependency))
+    _FACTORY.pool.Add(file_proto)
+  while file_by_name:
+    _AddFile(file_by_name.popitem()[1])
+  return _FACTORY.GetMessages([file_proto.name for file_proto in file_protos])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/proto_builder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/proto_builder.py
new file mode 100644
index 0000000000000000000000000000000000000000..736caed385947c5c0c446b86a4d9592571d33326
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/proto_builder.py
@@ -0,0 +1,130 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Dynamic Protobuf class creator."""
+
+try:
+    from collections import OrderedDict
+except ImportError:
+    from ordereddict import OrderedDict  #PY26
+import hashlib
+import os
+
+from google.protobuf import descriptor_pb2
+from google.protobuf import message_factory
+
+
+def _GetMessageFromFactory(factory, full_name):
+  """Get a proto class from the MessageFactory by name.
+
+  Args:
+    factory: a MessageFactory instance.
+    full_name: str, the fully qualified name of the proto type.
+  Returns:
+    A class, for the type identified by full_name.
+  Raises:
+    KeyError, if the proto is not found in the factory's descriptor pool.
+  """
+  proto_descriptor = factory.pool.FindMessageTypeByName(full_name)
+  proto_cls = factory.GetPrototype(proto_descriptor)
+  return proto_cls
+
+
+def MakeSimpleProtoClass(fields, full_name=None, pool=None):
+  """Create a Protobuf class whose fields are basic types.
+
+  Note: this doesn't validate field names!
+
+  Args:
+    fields: dict of {name: field_type} mappings for each field in the proto. If
+        this is an OrderedDict the order will be maintained, otherwise the
+        fields will be sorted by name.
+    full_name: optional str, the fully-qualified name of the proto type.
+    pool: optional DescriptorPool instance.
+  Returns:
+    a class, the new protobuf class with a FileDescriptor.
+  """
+  factory = message_factory.MessageFactory(pool=pool)
+
+  if full_name is not None:
+    try:
+      proto_cls = _GetMessageFromFactory(factory, full_name)
+      return proto_cls
+    except KeyError:
+      # The factory's DescriptorPool doesn't know about this class yet.
+      pass
+
+  # Get a list of (name, field_type) tuples from the fields dict. If fields was
+  # an OrderedDict we keep the order, but otherwise we sort the field to ensure
+  # consistent ordering.
+  field_items = fields.items()
+  if not isinstance(fields, OrderedDict):
+    field_items = sorted(field_items)
+
+  # Use a consistent file name that is unlikely to conflict with any imported
+  # proto files.
+  fields_hash = hashlib.sha1()
+  for f_name, f_type in field_items:
+    fields_hash.update(f_name.encode('utf-8'))
+    fields_hash.update(str(f_type).encode('utf-8'))
+  proto_file_name = fields_hash.hexdigest() + '.proto'
+
+  # If the proto is anonymous, use the same hash to name it.
+  if full_name is None:
+    full_name = ('net.proto2.python.public.proto_builder.AnonymousProto_' +
+                 fields_hash.hexdigest())
+    try:
+      proto_cls = _GetMessageFromFactory(factory, full_name)
+      return proto_cls
+    except KeyError:
+      # The factory's DescriptorPool doesn't know about this class yet.
+      pass
+
+  # This is the first time we see this proto: add a new descriptor to the pool.
+  factory.pool.Add(
+      _MakeFileDescriptorProto(proto_file_name, full_name, field_items))
+  return _GetMessageFromFactory(factory, full_name)
+
+
+def _MakeFileDescriptorProto(proto_file_name, full_name, field_items):
+  """Populate FileDescriptorProto for MessageFactory's DescriptorPool."""
+  package, name = full_name.rsplit('.', 1)
+  file_proto = descriptor_pb2.FileDescriptorProto()
+  file_proto.name = os.path.join(package.replace('.', '/'), proto_file_name)
+  file_proto.package = package
+  desc_proto = file_proto.message_type.add()
+  desc_proto.name = name
+  for f_number, (f_name, f_type) in enumerate(field_items, 1):
+    field_proto = desc_proto.field.add()
+    field_proto.name = f_name
+    field_proto.number = f_number
+    field_proto.label = descriptor_pb2.FieldDescriptorProto.LABEL_OPTIONAL
+    field_proto.type = f_type
+  return file_proto
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/_message.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/_message.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..5e77c633f0d3df7910413eed356dbc9b03400ceb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/_message.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/cpp_message.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/cpp_message.py
new file mode 100644
index 0000000000000000000000000000000000000000..fc8eb32d79f60ff95b328ec5a828593ab78e1802
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/pyext/cpp_message.py
@@ -0,0 +1,65 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Protocol message implementation hooks for C++ implementation.
+
+Contains helper functions used to create protocol message classes from
+Descriptor objects at runtime backed by the protocol buffer C++ API.
+"""
+
+__author__ = 'tibell@google.com (Johan Tibell)'
+
+from google.protobuf.pyext import _message
+
+
+class GeneratedProtocolMessageType(_message.MessageMeta):
+
+  """Metaclass for protocol message classes created at runtime from Descriptors.
+
+  The protocol compiler currently uses this metaclass to create protocol
+  message classes at runtime.  Clients can also manually create their own
+  classes at runtime, as in this example:
+
+  mydescriptor = Descriptor(.....)
+  factory = symbol_database.Default()
+  factory.pool.AddDescriptor(mydescriptor)
+  MyProtoClass = factory.GetPrototype(mydescriptor)
+  myproto_instance = MyProtoClass()
+  myproto.foo_field = 23
+  ...
+
+  The above example will not work for nested types. If you wish to include them,
+  use reflection.MakeClass() instead of manually instantiating the class in
+  order to create the appropriate class structure.
+  """
+
+  # Must be consistent with the protocol-compiler code in
+  # proto2/compiler/internal/generator.*.
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/reflection.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/reflection.py
new file mode 100644
index 0000000000000000000000000000000000000000..81e18859a804d589d67b0a0642de718ba1bbce13
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/reflection.py
@@ -0,0 +1,95 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# This code is meant to work on Python 2.4 and above only.
+
+"""Contains a metaclass and helper functions used to create
+protocol message classes from Descriptor objects at runtime.
+
+Recall that a metaclass is the "type" of a class.
+(A class is to a metaclass what an instance is to a class.)
+
+In this case, we use the GeneratedProtocolMessageType metaclass
+to inject all the useful functionality into the classes
+output by the protocol compiler at compile-time.
+
+The upshot of all this is that the real implementation
+details for ALL pure-Python protocol buffers are *here in
+this file*.
+"""
+
+__author__ = 'robinson@google.com (Will Robinson)'
+
+
+from google.protobuf import message_factory
+from google.protobuf import symbol_database
+
+# The type of all Message classes.
+# Part of the public interface, but normally only used by message factories.
+GeneratedProtocolMessageType = message_factory._GENERATED_PROTOCOL_MESSAGE_TYPE
+
+MESSAGE_CLASS_CACHE = {}
+
+
+# Deprecated. Please NEVER use reflection.ParseMessage().
+def ParseMessage(descriptor, byte_str):
+  """Generate a new Message instance from this Descriptor and a byte string.
+
+  DEPRECATED: ParseMessage is deprecated because it is using MakeClass().
+  Please use MessageFactory.GetPrototype() instead.
+
+  Args:
+    descriptor: Protobuf Descriptor object
+    byte_str: Serialized protocol buffer byte string
+
+  Returns:
+    Newly created protobuf Message object.
+  """
+  result_class = MakeClass(descriptor)
+  new_msg = result_class()
+  new_msg.ParseFromString(byte_str)
+  return new_msg
+
+
+# Deprecated. Please NEVER use reflection.MakeClass().
+def MakeClass(descriptor):
+  """Construct a class object for a protobuf described by descriptor.
+
+  DEPRECATED: use MessageFactory.GetPrototype() instead.
+
+  Args:
+    descriptor: A descriptor.Descriptor object describing the protobuf.
+  Returns:
+    The Message class object described by the descriptor.
+  """
+  # Original implementation leads to duplicate message classes, which won't play
+  # well with extensions. Message factory info is also missing.
+  # Redirect to message_factory.
+  return symbol_database.Default().GetPrototype(descriptor)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service.py
new file mode 100644
index 0000000000000000000000000000000000000000..5625246324cad3c71108a4466466d1d3b1568907
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service.py
@@ -0,0 +1,228 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""DEPRECATED:  Declares the RPC service interfaces.
+
+This module declares the abstract interfaces underlying proto2 RPC
+services.  These are intended to be independent of any particular RPC
+implementation, so that proto2 services can be used on top of a variety
+of implementations.  Starting with version 2.3.0, RPC implementations should
+not try to build on these, but should instead provide code generator plugins
+which generate code specific to the particular RPC implementation.  This way
+the generated code can be more appropriate for the implementation in use
+and can avoid unnecessary layers of indirection.
+"""
+
+__author__ = 'petar@google.com (Petar Petrov)'
+
+
+class RpcException(Exception):
+  """Exception raised on failed blocking RPC method call."""
+  pass
+
+
+class Service(object):
+
+  """Abstract base interface for protocol-buffer-based RPC services.
+
+  Services themselves are abstract classes (implemented either by servers or as
+  stubs), but they subclass this base interface. The methods of this
+  interface can be used to call the methods of the service without knowing
+  its exact type at compile time (analogous to the Message interface).
+  """
+
+  def GetDescriptor():
+    """Retrieves this service's descriptor."""
+    raise NotImplementedError
+
+  def CallMethod(self, method_descriptor, rpc_controller,
+                 request, done):
+    """Calls a method of the service specified by method_descriptor.
+
+    If "done" is None then the call is blocking and the response
+    message will be returned directly.  Otherwise the call is asynchronous
+    and "done" will later be called with the response value.
+
+    In the blocking case, RpcException will be raised on error.
+
+    Preconditions:
+
+    * method_descriptor.service == GetDescriptor
+    * request is of the exact same classes as returned by
+      GetRequestClass(method).
+    * After the call has started, the request must not be modified.
+    * "rpc_controller" is of the correct type for the RPC implementation being
+      used by this Service.  For stubs, the "correct type" depends on the
+      RpcChannel which the stub is using.
+
+    Postconditions:
+
+    * "done" will be called when the method is complete.  This may be
+      before CallMethod() returns or it may be at some point in the future.
+    * If the RPC failed, the response value passed to "done" will be None.
+      Further details about the failure can be found by querying the
+      RpcController.
+    """
+    raise NotImplementedError
+
+  def GetRequestClass(self, method_descriptor):
+    """Returns the class of the request message for the specified method.
+
+    CallMethod() requires that the request is of a particular subclass of
+    Message. GetRequestClass() gets the default instance of this required
+    type.
+
+    Example:
+      method = service.GetDescriptor().FindMethodByName("Foo")
+      request = stub.GetRequestClass(method)()
+      request.ParseFromString(input)
+      service.CallMethod(method, request, callback)
+    """
+    raise NotImplementedError
+
+  def GetResponseClass(self, method_descriptor):
+    """Returns the class of the response message for the specified method.
+
+    This method isn't really needed, as the RpcChannel's CallMethod constructs
+    the response protocol message. It's provided anyway in case it is useful
+    for the caller to know the response type in advance.
+    """
+    raise NotImplementedError
+
+
+class RpcController(object):
+
+  """An RpcController mediates a single method call.
+
+  The primary purpose of the controller is to provide a way to manipulate
+  settings specific to the RPC implementation and to find out about RPC-level
+  errors. The methods provided by the RpcController interface are intended
+  to be a "least common denominator" set of features which we expect all
+  implementations to support.  Specific implementations may provide more
+  advanced features (e.g. deadline propagation).
+  """
+
+  # Client-side methods below
+
+  def Reset(self):
+    """Resets the RpcController to its initial state.
+
+    After the RpcController has been reset, it may be reused in
+    a new call. Must not be called while an RPC is in progress.
+    """
+    raise NotImplementedError
+
+  def Failed(self):
+    """Returns true if the call failed.
+
+    After a call has finished, returns true if the call failed.  The possible
+    reasons for failure depend on the RPC implementation.  Failed() must not
+    be called before a call has finished.  If Failed() returns true, the
+    contents of the response message are undefined.
+    """
+    raise NotImplementedError
+
+  def ErrorText(self):
+    """If Failed is true, returns a human-readable description of the error."""
+    raise NotImplementedError
+
+  def StartCancel(self):
+    """Initiate cancellation.
+
+    Advises the RPC system that the caller desires that the RPC call be
+    canceled.  The RPC system may cancel it immediately, may wait awhile and
+    then cancel it, or may not even cancel the call at all.  If the call is
+    canceled, the "done" callback will still be called and the RpcController
+    will indicate that the call failed at that time.
+    """
+    raise NotImplementedError
+
+  # Server-side methods below
+
+  def SetFailed(self, reason):
+    """Sets a failure reason.
+
+    Causes Failed() to return true on the client side.  "reason" will be
+    incorporated into the message returned by ErrorText().  If you find
+    you need to return machine-readable information about failures, you
+    should incorporate it into your response protocol buffer and should
+    NOT call SetFailed().
+    """
+    raise NotImplementedError
+
+  def IsCanceled(self):
+    """Checks if the client cancelled the RPC.
+
+    If true, indicates that the client canceled the RPC, so the server may
+    as well give up on replying to it.  The server should still call the
+    final "done" callback.
+    """
+    raise NotImplementedError
+
+  def NotifyOnCancel(self, callback):
+    """Sets a callback to invoke on cancel.
+
+    Asks that the given callback be called when the RPC is canceled.  The
+    callback will always be called exactly once.  If the RPC completes without
+    being canceled, the callback will be called after completion.  If the RPC
+    has already been canceled when NotifyOnCancel() is called, the callback
+    will be called immediately.
+
+    NotifyOnCancel() must be called no more than once per request.
+    """
+    raise NotImplementedError
+
+
+class RpcChannel(object):
+
+  """Abstract interface for an RPC channel.
+
+  An RpcChannel represents a communication line to a service which can be used
+  to call that service's methods.  The service may be running on another
+  machine. Normally, you should not use an RpcChannel directly, but instead
+  construct a stub {@link Service} wrapping it.  Example:
+
+  Example:
+    RpcChannel channel = rpcImpl.Channel("remotehost.example.com:1234")
+    RpcController controller = rpcImpl.Controller()
+    MyService service = MyService_Stub(channel)
+    service.MyMethod(controller, request, callback)
+  """
+
+  def CallMethod(self, method_descriptor, rpc_controller,
+                 request, response_class, done):
+    """Calls the method identified by the descriptor.
+
+    Call the given method of the remote service.  The signature of this
+    procedure looks the same as Service.CallMethod(), but the requirements
+    are less strict in one important way:  the request object doesn't have to
+    be of any specific class as long as its descriptor is method.input_type.
+    """
+    raise NotImplementedError
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service_reflection.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service_reflection.py
new file mode 100644
index 0000000000000000000000000000000000000000..75c51ff3221af114d73e9eca6e74b14e32a59a57
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/service_reflection.py
@@ -0,0 +1,287 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains metaclasses used to create protocol service and service stub
+classes from ServiceDescriptor objects at runtime.
+
+The GeneratedServiceType and GeneratedServiceStubType metaclasses are used to
+inject all useful functionality into the classes output by the protocol
+compiler at compile-time.
+"""
+
+__author__ = 'petar@google.com (Petar Petrov)'
+
+
+class GeneratedServiceType(type):
+
+  """Metaclass for service classes created at runtime from ServiceDescriptors.
+
+  Implementations for all methods described in the Service class are added here
+  by this class. We also create properties to allow getting/setting all fields
+  in the protocol message.
+
+  The protocol compiler currently uses this metaclass to create protocol service
+  classes at runtime. Clients can also manually create their own classes at
+  runtime, as in this example::
+
+    mydescriptor = ServiceDescriptor(.....)
+    class MyProtoService(service.Service):
+      __metaclass__ = GeneratedServiceType
+      DESCRIPTOR = mydescriptor
+    myservice_instance = MyProtoService()
+    # ...
+  """
+
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __init__(cls, name, bases, dictionary):
+    """Creates a message service class.
+
+    Args:
+      name: Name of the class (ignored, but required by the metaclass
+        protocol).
+      bases: Base classes of the class being constructed.
+      dictionary: The class dictionary of the class being constructed.
+        dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
+        describing this protocol service type.
+    """
+    # Don't do anything if this class doesn't have a descriptor. This happens
+    # when a service class is subclassed.
+    if GeneratedServiceType._DESCRIPTOR_KEY not in dictionary:
+      return
+
+    descriptor = dictionary[GeneratedServiceType._DESCRIPTOR_KEY]
+    service_builder = _ServiceBuilder(descriptor)
+    service_builder.BuildService(cls)
+    cls.DESCRIPTOR = descriptor
+
+
+class GeneratedServiceStubType(GeneratedServiceType):
+
+  """Metaclass for service stubs created at runtime from ServiceDescriptors.
+
+  This class has similar responsibilities as GeneratedServiceType, except that
+  it creates the service stub classes.
+  """
+
+  _DESCRIPTOR_KEY = 'DESCRIPTOR'
+
+  def __init__(cls, name, bases, dictionary):
+    """Creates a message service stub class.
+
+    Args:
+      name: Name of the class (ignored, here).
+      bases: Base classes of the class being constructed.
+      dictionary: The class dictionary of the class being constructed.
+        dictionary[_DESCRIPTOR_KEY] must contain a ServiceDescriptor object
+        describing this protocol service type.
+    """
+    super(GeneratedServiceStubType, cls).__init__(name, bases, dictionary)
+    # Don't do anything if this class doesn't have a descriptor. This happens
+    # when a service stub is subclassed.
+    if GeneratedServiceStubType._DESCRIPTOR_KEY not in dictionary:
+      return
+
+    descriptor = dictionary[GeneratedServiceStubType._DESCRIPTOR_KEY]
+    service_stub_builder = _ServiceStubBuilder(descriptor)
+    service_stub_builder.BuildServiceStub(cls)
+
+
+class _ServiceBuilder(object):
+
+  """This class constructs a protocol service class using a service descriptor.
+
+  Given a service descriptor, this class constructs a class that represents
+  the specified service descriptor. One service builder instance constructs
+  exactly one service class. That means all instances of that class share the
+  same builder.
+  """
+
+  def __init__(self, service_descriptor):
+    """Initializes an instance of the service class builder.
+
+    Args:
+      service_descriptor: ServiceDescriptor to use when constructing the
+        service class.
+    """
+    self.descriptor = service_descriptor
+
+  def BuildService(self, cls):
+    """Constructs the service class.
+
+    Args:
+      cls: The class that will be constructed.
+    """
+
+    # CallMethod needs to operate with an instance of the Service class. This
+    # internal wrapper function exists only to be able to pass the service
+    # instance to the method that does the real CallMethod work.
+    def _WrapCallMethod(srvc, method_descriptor,
+                        rpc_controller, request, callback):
+      return self._CallMethod(srvc, method_descriptor,
+                       rpc_controller, request, callback)
+    self.cls = cls
+    cls.CallMethod = _WrapCallMethod
+    cls.GetDescriptor = staticmethod(lambda: self.descriptor)
+    cls.GetDescriptor.__doc__ = "Returns the service descriptor."
+    cls.GetRequestClass = self._GetRequestClass
+    cls.GetResponseClass = self._GetResponseClass
+    for method in self.descriptor.methods:
+      setattr(cls, method.name, self._GenerateNonImplementedMethod(method))
+
+  def _CallMethod(self, srvc, method_descriptor,
+                  rpc_controller, request, callback):
+    """Calls the method described by a given method descriptor.
+
+    Args:
+      srvc: Instance of the service for which this method is called.
+      method_descriptor: Descriptor that represent the method to call.
+      rpc_controller: RPC controller to use for this method's execution.
+      request: Request protocol message.
+      callback: A callback to invoke after the method has completed.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'CallMethod() given method descriptor for wrong service type.')
+    method = getattr(srvc, method_descriptor.name)
+    return method(rpc_controller, request, callback)
+
+  def _GetRequestClass(self, method_descriptor):
+    """Returns the class of the request protocol message.
+
+    Args:
+      method_descriptor: Descriptor of the method for which to return the
+        request protocol message class.
+
+    Returns:
+      A class that represents the input protocol message of the specified
+      method.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'GetRequestClass() given method descriptor for wrong service type.')
+    return method_descriptor.input_type._concrete_class
+
+  def _GetResponseClass(self, method_descriptor):
+    """Returns the class of the response protocol message.
+
+    Args:
+      method_descriptor: Descriptor of the method for which to return the
+        response protocol message class.
+
+    Returns:
+      A class that represents the output protocol message of the specified
+      method.
+    """
+    if method_descriptor.containing_service != self.descriptor:
+      raise RuntimeError(
+          'GetResponseClass() given method descriptor for wrong service type.')
+    return method_descriptor.output_type._concrete_class
+
+  def _GenerateNonImplementedMethod(self, method):
+    """Generates and returns a method that can be set for a service methods.
+
+    Args:
+      method: Descriptor of the service method for which a method is to be
+        generated.
+
+    Returns:
+      A method that can be added to the service class.
+    """
+    return lambda inst, rpc_controller, request, callback: (
+        self._NonImplementedMethod(method.name, rpc_controller, callback))
+
+  def _NonImplementedMethod(self, method_name, rpc_controller, callback):
+    """The body of all methods in the generated service class.
+
+    Args:
+      method_name: Name of the method being executed.
+      rpc_controller: RPC controller used to execute this method.
+      callback: A callback which will be invoked when the method finishes.
+    """
+    rpc_controller.SetFailed('Method %s not implemented.' % method_name)
+    callback(None)
+
+
+class _ServiceStubBuilder(object):
+
+  """Constructs a protocol service stub class using a service descriptor.
+
+  Given a service descriptor, this class constructs a suitable stub class.
+  A stub is just a type-safe wrapper around an RpcChannel which emulates a
+  local implementation of the service.
+
+  One service stub builder instance constructs exactly one class. It means all
+  instances of that class share the same service stub builder.
+  """
+
+  def __init__(self, service_descriptor):
+    """Initializes an instance of the service stub class builder.
+
+    Args:
+      service_descriptor: ServiceDescriptor to use when constructing the
+        stub class.
+    """
+    self.descriptor = service_descriptor
+
+  def BuildServiceStub(self, cls):
+    """Constructs the stub class.
+
+    Args:
+      cls: The class that will be constructed.
+    """
+
+    def _ServiceStubInit(stub, rpc_channel):
+      stub.rpc_channel = rpc_channel
+    self.cls = cls
+    cls.__init__ = _ServiceStubInit
+    for method in self.descriptor.methods:
+      setattr(cls, method.name, self._GenerateStubMethod(method))
+
+  def _GenerateStubMethod(self, method):
+    return (lambda inst, rpc_controller, request, callback=None:
+        self._StubMethod(inst, method, rpc_controller, request, callback))
+
+  def _StubMethod(self, stub, method_descriptor,
+                  rpc_controller, request, callback):
+    """The body of all service methods in the generated stub class.
+
+    Args:
+      stub: Stub instance.
+      method_descriptor: Descriptor of the invoked method.
+      rpc_controller: Rpc controller to execute the method.
+      request: Request protocol message.
+      callback: A callback to execute when the method finishes.
+    Returns:
+      Response message (in case of blocking call).
+    """
+    return stub.rpc_channel.CallMethod(
+        method_descriptor, rpc_controller, request,
+        method_descriptor.output_type._concrete_class, callback)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/source_context_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/source_context_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..cfcd9e49a931325d2f6761a4e808ce3500242ae2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/source_context_pb2.py
@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/source_context.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/source_context.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\022SourceContextProtoP\001Z6google.golang.org/protobuf/types/known/sourcecontextpb\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n$google/protobuf/source_context.proto\x12\x0fgoogle.protobuf\"\"\n\rSourceContext\x12\x11\n\tfile_name\x18\x01 \x01(\tB\x8a\x01\n\x13\x63om.google.protobufB\x12SourceContextProtoP\x01Z6google.golang.org/protobuf/types/known/sourcecontextpb\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_SOURCECONTEXT = _descriptor.Descriptor(
+  name='SourceContext',
+  full_name='google.protobuf.SourceContext',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='file_name', full_name='google.protobuf.SourceContext.file_name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=57,
+  serialized_end=91,
+)
+
+DESCRIPTOR.message_types_by_name['SourceContext'] = _SOURCECONTEXT
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+SourceContext = _reflection.GeneratedProtocolMessageType('SourceContext', (_message.Message,), {
+  'DESCRIPTOR' : _SOURCECONTEXT,
+  '__module__' : 'google.protobuf.source_context_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.SourceContext)
+  })
+_sym_db.RegisterMessage(SourceContext)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/struct_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/struct_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..efc8facad7fbd57d05066fdf282ef8fefe88c495
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/struct_pb2.py
@@ -0,0 +1,287 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/struct.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/struct.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\013StructProtoP\001Z/google.golang.org/protobuf/types/known/structpb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1cgoogle/protobuf/struct.proto\x12\x0fgoogle.protobuf\"\x84\x01\n\x06Struct\x12\x33\n\x06\x66ields\x18\x01 \x03(\x0b\x32#.google.protobuf.Struct.FieldsEntry\x1a\x45\n\x0b\x46ieldsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12%\n\x05value\x18\x02 \x01(\x0b\x32\x16.google.protobuf.Value:\x02\x38\x01\"\xea\x01\n\x05Value\x12\x30\n\nnull_value\x18\x01 \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x12\x16\n\x0cnumber_value\x18\x02 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x03 \x01(\tH\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12/\n\x0cstruct_value\x18\x05 \x01(\x0b\x32\x17.google.protobuf.StructH\x00\x12\x30\n\nlist_value\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.ListValueH\x00\x42\x06\n\x04kind\"3\n\tListValue\x12&\n\x06values\x18\x01 \x03(\x0b\x32\x16.google.protobuf.Value*\x1b\n\tNullValue\x12\x0e\n\nNULL_VALUE\x10\x00\x42\x7f\n\x13\x63om.google.protobufB\x0bStructProtoP\x01Z/google.golang.org/protobuf/types/known/structpb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+_NULLVALUE = _descriptor.EnumDescriptor(
+  name='NullValue',
+  full_name='google.protobuf.NullValue',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='NULL_VALUE', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=474,
+  serialized_end=501,
+)
+_sym_db.RegisterEnumDescriptor(_NULLVALUE)
+
+NullValue = enum_type_wrapper.EnumTypeWrapper(_NULLVALUE)
+NULL_VALUE = 0
+
+
+
+_STRUCT_FIELDSENTRY = _descriptor.Descriptor(
+  name='FieldsEntry',
+  full_name='google.protobuf.Struct.FieldsEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='google.protobuf.Struct.FieldsEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.Struct.FieldsEntry.value', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=113,
+  serialized_end=182,
+)
+
+_STRUCT = _descriptor.Descriptor(
+  name='Struct',
+  full_name='google.protobuf.Struct',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='fields', full_name='google.protobuf.Struct.fields', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_STRUCT_FIELDSENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=50,
+  serialized_end=182,
+)
+
+
+_VALUE = _descriptor.Descriptor(
+  name='Value',
+  full_name='google.protobuf.Value',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='null_value', full_name='google.protobuf.Value.null_value', index=0,
+      number=1, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='number_value', full_name='google.protobuf.Value.number_value', index=1,
+      number=2, type=1, cpp_type=5, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_value', full_name='google.protobuf.Value.string_value', index=2,
+      number=3, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='bool_value', full_name='google.protobuf.Value.bool_value', index=3,
+      number=4, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='struct_value', full_name='google.protobuf.Value.struct_value', index=4,
+      number=5, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='list_value', full_name='google.protobuf.Value.list_value', index=5,
+      number=6, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+    _descriptor.OneofDescriptor(
+      name='kind', full_name='google.protobuf.Value.kind',
+      index=0, containing_type=None,
+      create_key=_descriptor._internal_create_key,
+    fields=[]),
+  ],
+  serialized_start=185,
+  serialized_end=419,
+)
+
+
+_LISTVALUE = _descriptor.Descriptor(
+  name='ListValue',
+  full_name='google.protobuf.ListValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='values', full_name='google.protobuf.ListValue.values', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=421,
+  serialized_end=472,
+)
+
+_STRUCT_FIELDSENTRY.fields_by_name['value'].message_type = _VALUE
+_STRUCT_FIELDSENTRY.containing_type = _STRUCT
+_STRUCT.fields_by_name['fields'].message_type = _STRUCT_FIELDSENTRY
+_VALUE.fields_by_name['null_value'].enum_type = _NULLVALUE
+_VALUE.fields_by_name['struct_value'].message_type = _STRUCT
+_VALUE.fields_by_name['list_value'].message_type = _LISTVALUE
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['null_value'])
+_VALUE.fields_by_name['null_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['number_value'])
+_VALUE.fields_by_name['number_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['string_value'])
+_VALUE.fields_by_name['string_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['bool_value'])
+_VALUE.fields_by_name['bool_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['struct_value'])
+_VALUE.fields_by_name['struct_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_VALUE.oneofs_by_name['kind'].fields.append(
+  _VALUE.fields_by_name['list_value'])
+_VALUE.fields_by_name['list_value'].containing_oneof = _VALUE.oneofs_by_name['kind']
+_LISTVALUE.fields_by_name['values'].message_type = _VALUE
+DESCRIPTOR.message_types_by_name['Struct'] = _STRUCT
+DESCRIPTOR.message_types_by_name['Value'] = _VALUE
+DESCRIPTOR.message_types_by_name['ListValue'] = _LISTVALUE
+DESCRIPTOR.enum_types_by_name['NullValue'] = _NULLVALUE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Struct = _reflection.GeneratedProtocolMessageType('Struct', (_message.Message,), {
+
+  'FieldsEntry' : _reflection.GeneratedProtocolMessageType('FieldsEntry', (_message.Message,), {
+    'DESCRIPTOR' : _STRUCT_FIELDSENTRY,
+    '__module__' : 'google.protobuf.struct_pb2'
+    # @@protoc_insertion_point(class_scope:google.protobuf.Struct.FieldsEntry)
+    })
+  ,
+  'DESCRIPTOR' : _STRUCT,
+  '__module__' : 'google.protobuf.struct_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Struct)
+  })
+_sym_db.RegisterMessage(Struct)
+_sym_db.RegisterMessage(Struct.FieldsEntry)
+
+Value = _reflection.GeneratedProtocolMessageType('Value', (_message.Message,), {
+  'DESCRIPTOR' : _VALUE,
+  '__module__' : 'google.protobuf.struct_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Value)
+  })
+_sym_db.RegisterMessage(Value)
+
+ListValue = _reflection.GeneratedProtocolMessageType('ListValue', (_message.Message,), {
+  'DESCRIPTOR' : _LISTVALUE,
+  '__module__' : 'google.protobuf.struct_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.ListValue)
+  })
+_sym_db.RegisterMessage(ListValue)
+
+
+DESCRIPTOR._options = None
+_STRUCT_FIELDSENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/symbol_database.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/symbol_database.py
new file mode 100644
index 0000000000000000000000000000000000000000..fdcf8cf06ced70c01d291c672a08850238e5d3c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/symbol_database.py
@@ -0,0 +1,194 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""A database of Python protocol buffer generated symbols.
+
+SymbolDatabase is the MessageFactory for messages generated at compile time,
+and makes it easy to create new instances of a registered type, given only the
+type's protocol buffer symbol name.
+
+Example usage::
+
+  db = symbol_database.SymbolDatabase()
+
+  # Register symbols of interest, from one or multiple files.
+  db.RegisterFileDescriptor(my_proto_pb2.DESCRIPTOR)
+  db.RegisterMessage(my_proto_pb2.MyMessage)
+  db.RegisterEnumDescriptor(my_proto_pb2.MyEnum.DESCRIPTOR)
+
+  # The database can be used as a MessageFactory, to generate types based on
+  # their name:
+  types = db.GetMessages(['my_proto.proto'])
+  my_message_instance = types['MyMessage']()
+
+  # The database's underlying descriptor pool can be queried, so it's not
+  # necessary to know a type's filename to be able to generate it:
+  filename = db.pool.FindFileContainingSymbol('MyMessage')
+  my_message_instance = db.GetMessages([filename])['MyMessage']()
+
+  # This functionality is also provided directly via a convenience method:
+  my_message_instance = db.GetSymbol('MyMessage')()
+"""
+
+
+from google.protobuf.internal import api_implementation
+from google.protobuf import descriptor_pool
+from google.protobuf import message_factory
+
+
+class SymbolDatabase(message_factory.MessageFactory):
+  """A database of Python generated symbols."""
+
+  def RegisterMessage(self, message):
+    """Registers the given message type in the local database.
+
+    Calls to GetSymbol() and GetMessages() will return messages registered here.
+
+    Args:
+      message: A :class:`google.protobuf.message.Message` subclass (or
+        instance); its descriptor will be registered.
+
+    Returns:
+      The provided message.
+    """
+
+    desc = message.DESCRIPTOR
+    self._classes[desc] = message
+    self.RegisterMessageDescriptor(desc)
+    return message
+
+  def RegisterMessageDescriptor(self, message_descriptor):
+    """Registers the given message descriptor in the local database.
+
+    Args:
+      message_descriptor (Descriptor): the message descriptor to add.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddDescriptor(message_descriptor)
+
+  def RegisterEnumDescriptor(self, enum_descriptor):
+    """Registers the given enum descriptor in the local database.
+
+    Args:
+      enum_descriptor (EnumDescriptor): The enum descriptor to register.
+
+    Returns:
+      EnumDescriptor: The provided descriptor.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddEnumDescriptor(enum_descriptor)
+    return enum_descriptor
+
+  def RegisterServiceDescriptor(self, service_descriptor):
+    """Registers the given service descriptor in the local database.
+
+    Args:
+      service_descriptor (ServiceDescriptor): the service descriptor to
+        register.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._AddServiceDescriptor(service_descriptor)
+
+  def RegisterFileDescriptor(self, file_descriptor):
+    """Registers the given file descriptor in the local database.
+
+    Args:
+      file_descriptor (FileDescriptor): The file descriptor to register.
+    """
+    if api_implementation.Type() == 'python':
+      # pylint: disable=protected-access
+      self.pool._InternalAddFileDescriptor(file_descriptor)
+
+  def GetSymbol(self, symbol):
+    """Tries to find a symbol in the local database.
+
+    Currently, this method only returns message.Message instances, however, if
+    may be extended in future to support other symbol types.
+
+    Args:
+      symbol (str): a protocol buffer symbol.
+
+    Returns:
+      A Python class corresponding to the symbol.
+
+    Raises:
+      KeyError: if the symbol could not be found.
+    """
+
+    return self._classes[self.pool.FindMessageTypeByName(symbol)]
+
+  def GetMessages(self, files):
+    # TODO(amauryfa): Fix the differences with MessageFactory.
+    """Gets all registered messages from a specified file.
+
+    Only messages already created and registered will be returned; (this is the
+    case for imported _pb2 modules)
+    But unlike MessageFactory, this version also returns already defined nested
+    messages, but does not register any message extensions.
+
+    Args:
+      files (list[str]): The file names to extract messages from.
+
+    Returns:
+      A dictionary mapping proto names to the message classes.
+
+    Raises:
+      KeyError: if a file could not be found.
+    """
+
+    def _GetAllMessages(desc):
+      """Walk a message Descriptor and recursively yields all message names."""
+      yield desc
+      for msg_desc in desc.nested_types:
+        for nested_desc in _GetAllMessages(msg_desc):
+          yield nested_desc
+
+    result = {}
+    for file_name in files:
+      file_desc = self.pool.FindFileByName(file_name)
+      for msg_desc in file_desc.message_types_by_name.values():
+        for desc in _GetAllMessages(msg_desc):
+          try:
+            result[desc.full_name] = self._classes[desc]
+          except KeyError:
+            # This descriptor has no registered class, skip it.
+            pass
+    return result
+
+
+_DEFAULT = SymbolDatabase(pool=descriptor_pool.Default())
+
+
+def Default():
+  """Returns the default SymbolDatabase."""
+  return _DEFAULT
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_encoding.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..39898765f28f2ad2149813e892f4cc6f92adb57d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_encoding.py
@@ -0,0 +1,117 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Encoding related utilities."""
+import re
+
+import six
+
+_cescape_chr_to_symbol_map = {}
+_cescape_chr_to_symbol_map[9] = r'\t'  # optional escape
+_cescape_chr_to_symbol_map[10] = r'\n'  # optional escape
+_cescape_chr_to_symbol_map[13] = r'\r'  # optional escape
+_cescape_chr_to_symbol_map[34] = r'\"'  # necessary escape
+_cescape_chr_to_symbol_map[39] = r"\'"  # optional escape
+_cescape_chr_to_symbol_map[92] = r'\\'  # necessary escape
+
+# Lookup table for unicode
+_cescape_unicode_to_str = [chr(i) for i in range(0, 256)]
+for byte, string in _cescape_chr_to_symbol_map.items():
+  _cescape_unicode_to_str[byte] = string
+
+# Lookup table for non-utf8, with necessary escapes at (o >= 127 or o < 32)
+_cescape_byte_to_str = ([r'\%03o' % i for i in range(0, 32)] +
+                        [chr(i) for i in range(32, 127)] +
+                        [r'\%03o' % i for i in range(127, 256)])
+for byte, string in _cescape_chr_to_symbol_map.items():
+  _cescape_byte_to_str[byte] = string
+del byte, string
+
+
+def CEscape(text, as_utf8):
+  # type: (...) -> str
+  """Escape a bytes string for use in an text protocol buffer.
+
+  Args:
+    text: A byte string to be escaped.
+    as_utf8: Specifies if result may contain non-ASCII characters.
+        In Python 3 this allows unescaped non-ASCII Unicode characters.
+        In Python 2 the return value will be valid UTF-8 rather than only ASCII.
+  Returns:
+    Escaped string (str).
+  """
+  # Python's text.encode() 'string_escape' or 'unicode_escape' codecs do not
+  # satisfy our needs; they encodes unprintable characters using two-digit hex
+  # escapes whereas our C++ unescaping function allows hex escapes to be any
+  # length.  So, "\0011".encode('string_escape') ends up being "\\x011", which
+  # will be decoded in C++ as a single-character string with char code 0x11.
+  if six.PY3:
+    text_is_unicode = isinstance(text, str)
+    if as_utf8 and text_is_unicode:
+      # We're already unicode, no processing beyond control char escapes.
+      return text.translate(_cescape_chr_to_symbol_map)
+    ord_ = ord if text_is_unicode else lambda x: x  # bytes iterate as ints.
+  else:
+    ord_ = ord  # PY2
+  if as_utf8:
+    return ''.join(_cescape_unicode_to_str[ord_(c)] for c in text)
+  return ''.join(_cescape_byte_to_str[ord_(c)] for c in text)
+
+
+_CUNESCAPE_HEX = re.compile(r'(\\+)x([0-9a-fA-F])(?![0-9a-fA-F])')
+
+
+def CUnescape(text):
+  # type: (str) -> bytes
+  """Unescape a text string with C-style escape sequences to UTF-8 bytes.
+
+  Args:
+    text: The data to parse in a str.
+  Returns:
+    A byte string.
+  """
+
+  def ReplaceHex(m):
+    # Only replace the match if the number of leading back slashes is odd. i.e.
+    # the slash itself is not escaped.
+    if len(m.group(1)) & 1:
+      return m.group(1) + 'x0' + m.group(2)
+    return m.group(0)
+
+  # This is required because the 'string_escape' encoding doesn't
+  # allow single-digit hex escapes (like '\xf').
+  result = _CUNESCAPE_HEX.sub(ReplaceHex, text)
+
+  if six.PY2:
+    return result.decode('string_escape')
+  return (result.encode('utf-8')  # PY3: Make it bytes to allow decode.
+          .decode('unicode_escape')
+          # Make it bytes again to return the proper type.
+          .encode('raw_unicode_escape'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_format.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..c376c7bac78aa4109fbeb4f3dd8bb08805b066d3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/text_format.py
@@ -0,0 +1,1828 @@
+# Protocol Buffers - Google's data interchange format
+# Copyright 2008 Google Inc.  All rights reserved.
+# https://developers.google.com/protocol-buffers/
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+#     * Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#     * Redistributions in binary form must reproduce the above
+# copyright notice, this list of conditions and the following disclaimer
+# in the documentation and/or other materials provided with the
+# distribution.
+#     * Neither the name of Google Inc. nor the names of its
+# contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+"""Contains routines for printing protocol messages in text format.
+
+Simple usage example::
+
+  # Create a proto object and serialize it to a text proto string.
+  message = my_proto_pb2.MyMessage(foo='bar')
+  text_proto = text_format.MessageToString(message)
+
+  # Parse a text proto string.
+  message = text_format.Parse(text_proto, my_proto_pb2.MyMessage())
+"""
+
+__author__ = 'kenton@google.com (Kenton Varda)'
+
+# TODO(b/129989314) Import thread contention leads to test failures.
+import encodings.raw_unicode_escape  # pylint: disable=unused-import
+import encodings.unicode_escape  # pylint: disable=unused-import
+import io
+import math
+import re
+import six
+
+from google.protobuf.internal import decoder
+from google.protobuf.internal import type_checkers
+from google.protobuf import descriptor
+from google.protobuf import text_encoding
+
+if six.PY3:
+  long = int  # pylint: disable=redefined-builtin,invalid-name
+
+# pylint: disable=g-import-not-at-top
+__all__ = ['MessageToString', 'Parse', 'PrintMessage', 'PrintField',
+           'PrintFieldValue', 'Merge', 'MessageToBytes']
+
+_INTEGER_CHECKERS = (type_checkers.Uint32ValueChecker(),
+                     type_checkers.Int32ValueChecker(),
+                     type_checkers.Uint64ValueChecker(),
+                     type_checkers.Int64ValueChecker())
+_FLOAT_INFINITY = re.compile('-?inf(?:inity)?f?$', re.IGNORECASE)
+_FLOAT_NAN = re.compile('nanf?$', re.IGNORECASE)
+_QUOTES = frozenset(("'", '"'))
+_ANY_FULL_TYPE_NAME = 'google.protobuf.Any'
+
+
+class Error(Exception):
+  """Top-level module error for text_format."""
+
+
+class ParseError(Error):
+  """Thrown in case of text parsing or tokenizing error."""
+
+  def __init__(self, message=None, line=None, column=None):
+    if message is not None and line is not None:
+      loc = str(line)
+      if column is not None:
+        loc += ':{0}'.format(column)
+      message = '{0} : {1}'.format(loc, message)
+    if message is not None:
+      super(ParseError, self).__init__(message)
+    else:
+      super(ParseError, self).__init__()
+    self._line = line
+    self._column = column
+
+  def GetLine(self):
+    return self._line
+
+  def GetColumn(self):
+    return self._column
+
+
+class TextWriter(object):
+
+  def __init__(self, as_utf8):
+    if six.PY2:
+      self._writer = io.BytesIO()
+    else:
+      self._writer = io.StringIO()
+
+  def write(self, val):
+    if six.PY2:
+      if isinstance(val, six.text_type):
+        val = val.encode('utf-8')
+    return self._writer.write(val)
+
+  def close(self):
+    return self._writer.close()
+
+  def getvalue(self):
+    return self._writer.getvalue()
+
+
+def MessageToString(
+    message,
+    as_utf8=False,
+    as_one_line=False,
+    use_short_repeated_primitives=False,
+    pointy_brackets=False,
+    use_index_order=False,
+    float_format=None,
+    double_format=None,
+    use_field_number=False,
+    descriptor_pool=None,
+    indent=0,
+    message_formatter=None,
+    print_unknown_fields=False,
+    force_colon=False):
+  # type: (...) -> str
+  """Convert protobuf message to text format.
+
+  Double values can be formatted compactly with 15 digits of
+  precision (which is the most that IEEE 754 "double" can guarantee)
+  using double_format='.15g'. To ensure that converting to text and back to a
+  proto will result in an identical value, double_format='.17g' should be used.
+
+  Args:
+    message: The protocol buffers message.
+    as_utf8: Return unescaped Unicode for non-ASCII characters.
+        In Python 3 actual Unicode characters may appear as is in strings.
+        In Python 2 the return value will be valid UTF-8 rather than only ASCII.
+    as_one_line: Don't introduce newlines between fields.
+    use_short_repeated_primitives: Use short repeated format for primitives.
+    pointy_brackets: If True, use angle brackets instead of curly braces for
+      nesting.
+    use_index_order: If True, fields of a proto message will be printed using
+      the order defined in source code instead of the field number, extensions
+      will be printed at the end of the message and their relative order is
+      determined by the extension number. By default, use the field number
+      order.
+    float_format (str): If set, use this to specify float field formatting
+      (per the "Format Specification Mini-Language"); otherwise, shortest float
+      that has same value in wire will be printed. Also affect double field
+      if double_format is not set but float_format is set.
+    double_format (str): If set, use this to specify double field formatting
+      (per the "Format Specification Mini-Language"); if it is not set but
+      float_format is set, use float_format. Otherwise, use ``str()``
+    use_field_number: If True, print field numbers instead of names.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    indent (int): The initial indent level, in terms of spaces, for pretty
+      print.
+    message_formatter (function(message, indent, as_one_line) -> unicode|None):
+      Custom formatter for selected sub-messages (usually based on message
+      type). Use to pretty print parts of the protobuf for easier diffing.
+    print_unknown_fields: If True, unknown fields will be printed.
+    force_colon: If set, a colon will be added after the field name even if the
+      field is a proto message.
+
+  Returns:
+    str: A string of the text formatted protocol buffer message.
+  """
+  out = TextWriter(as_utf8)
+  printer = _Printer(
+      out,
+      indent,
+      as_utf8,
+      as_one_line,
+      use_short_repeated_primitives,
+      pointy_brackets,
+      use_index_order,
+      float_format,
+      double_format,
+      use_field_number,
+      descriptor_pool,
+      message_formatter,
+      print_unknown_fields=print_unknown_fields,
+      force_colon=force_colon)
+  printer.PrintMessage(message)
+  result = out.getvalue()
+  out.close()
+  if as_one_line:
+    return result.rstrip()
+  return result
+
+
+def MessageToBytes(message, **kwargs):
+  # type: (...) -> bytes
+  """Convert protobuf message to encoded text format.  See MessageToString."""
+  text = MessageToString(message, **kwargs)
+  if isinstance(text, bytes):
+    return text
+  codec = 'utf-8' if kwargs.get('as_utf8') else 'ascii'
+  return text.encode(codec)
+
+
+def _IsMapEntry(field):
+  return (field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+          field.message_type.has_options and
+          field.message_type.GetOptions().map_entry)
+
+
+def PrintMessage(message,
+                 out,
+                 indent=0,
+                 as_utf8=False,
+                 as_one_line=False,
+                 use_short_repeated_primitives=False,
+                 pointy_brackets=False,
+                 use_index_order=False,
+                 float_format=None,
+                 double_format=None,
+                 use_field_number=False,
+                 descriptor_pool=None,
+                 message_formatter=None,
+                 print_unknown_fields=False,
+                 force_colon=False):
+  printer = _Printer(
+      out=out, indent=indent, as_utf8=as_utf8,
+      as_one_line=as_one_line,
+      use_short_repeated_primitives=use_short_repeated_primitives,
+      pointy_brackets=pointy_brackets,
+      use_index_order=use_index_order,
+      float_format=float_format,
+      double_format=double_format,
+      use_field_number=use_field_number,
+      descriptor_pool=descriptor_pool,
+      message_formatter=message_formatter,
+      print_unknown_fields=print_unknown_fields,
+      force_colon=force_colon)
+  printer.PrintMessage(message)
+
+
+def PrintField(field,
+               value,
+               out,
+               indent=0,
+               as_utf8=False,
+               as_one_line=False,
+               use_short_repeated_primitives=False,
+               pointy_brackets=False,
+               use_index_order=False,
+               float_format=None,
+               double_format=None,
+               message_formatter=None,
+               print_unknown_fields=False,
+               force_colon=False):
+  """Print a single field name/value pair."""
+  printer = _Printer(out, indent, as_utf8, as_one_line,
+                     use_short_repeated_primitives, pointy_brackets,
+                     use_index_order, float_format, double_format,
+                     message_formatter=message_formatter,
+                     print_unknown_fields=print_unknown_fields,
+                     force_colon=force_colon)
+  printer.PrintField(field, value)
+
+
+def PrintFieldValue(field,
+                    value,
+                    out,
+                    indent=0,
+                    as_utf8=False,
+                    as_one_line=False,
+                    use_short_repeated_primitives=False,
+                    pointy_brackets=False,
+                    use_index_order=False,
+                    float_format=None,
+                    double_format=None,
+                    message_formatter=None,
+                    print_unknown_fields=False,
+                    force_colon=False):
+  """Print a single field value (not including name)."""
+  printer = _Printer(out, indent, as_utf8, as_one_line,
+                     use_short_repeated_primitives, pointy_brackets,
+                     use_index_order, float_format, double_format,
+                     message_formatter=message_formatter,
+                     print_unknown_fields=print_unknown_fields,
+                     force_colon=force_colon)
+  printer.PrintFieldValue(field, value)
+
+
+def _BuildMessageFromTypeName(type_name, descriptor_pool):
+  """Returns a protobuf message instance.
+
+  Args:
+    type_name: Fully-qualified protobuf  message type name string.
+    descriptor_pool: DescriptorPool instance.
+
+  Returns:
+    A Message instance of type matching type_name, or None if the a Descriptor
+    wasn't found matching type_name.
+  """
+  # pylint: disable=g-import-not-at-top
+  if descriptor_pool is None:
+    from google.protobuf import descriptor_pool as pool_mod
+    descriptor_pool = pool_mod.Default()
+  from google.protobuf import symbol_database
+  database = symbol_database.Default()
+  try:
+    message_descriptor = descriptor_pool.FindMessageTypeByName(type_name)
+  except KeyError:
+    return None
+  message_type = database.GetPrototype(message_descriptor)
+  return message_type()
+
+
+# These values must match WireType enum in google/protobuf/wire_format.h.
+WIRETYPE_LENGTH_DELIMITED = 2
+WIRETYPE_START_GROUP = 3
+
+
+class _Printer(object):
+  """Text format printer for protocol message."""
+
+  def __init__(
+      self,
+      out,
+      indent=0,
+      as_utf8=False,
+      as_one_line=False,
+      use_short_repeated_primitives=False,
+      pointy_brackets=False,
+      use_index_order=False,
+      float_format=None,
+      double_format=None,
+      use_field_number=False,
+      descriptor_pool=None,
+      message_formatter=None,
+      print_unknown_fields=False,
+      force_colon=False):
+    """Initialize the Printer.
+
+    Double values can be formatted compactly with 15 digits of precision
+    (which is the most that IEEE 754 "double" can guarantee) using
+    double_format='.15g'. To ensure that converting to text and back to a proto
+    will result in an identical value, double_format='.17g' should be used.
+
+    Args:
+      out: To record the text format result.
+      indent: The initial indent level for pretty print.
+      as_utf8: Return unescaped Unicode for non-ASCII characters.
+          In Python 3 actual Unicode characters may appear as is in strings.
+          In Python 2 the return value will be valid UTF-8 rather than ASCII.
+      as_one_line: Don't introduce newlines between fields.
+      use_short_repeated_primitives: Use short repeated format for primitives.
+      pointy_brackets: If True, use angle brackets instead of curly braces for
+        nesting.
+      use_index_order: If True, print fields of a proto message using the order
+        defined in source code instead of the field number. By default, use the
+        field number order.
+      float_format: If set, use this to specify float field formatting
+        (per the "Format Specification Mini-Language"); otherwise, shortest
+        float that has same value in wire will be printed. Also affect double
+        field if double_format is not set but float_format is set.
+      double_format: If set, use this to specify double field formatting
+        (per the "Format Specification Mini-Language"); if it is not set but
+        float_format is set, use float_format. Otherwise, str() is used.
+      use_field_number: If True, print field numbers instead of names.
+      descriptor_pool: A DescriptorPool used to resolve Any types.
+      message_formatter: A function(message, indent, as_one_line): unicode|None
+        to custom format selected sub-messages (usually based on message type).
+        Use to pretty print parts of the protobuf for easier diffing.
+      print_unknown_fields: If True, unknown fields will be printed.
+      force_colon: If set, a colon will be added after the field name even if
+        the field is a proto message.
+    """
+    self.out = out
+    self.indent = indent
+    self.as_utf8 = as_utf8
+    self.as_one_line = as_one_line
+    self.use_short_repeated_primitives = use_short_repeated_primitives
+    self.pointy_brackets = pointy_brackets
+    self.use_index_order = use_index_order
+    self.float_format = float_format
+    if double_format is not None:
+      self.double_format = double_format
+    else:
+      self.double_format = float_format
+    self.use_field_number = use_field_number
+    self.descriptor_pool = descriptor_pool
+    self.message_formatter = message_formatter
+    self.print_unknown_fields = print_unknown_fields
+    self.force_colon = force_colon
+
+  def _TryPrintAsAnyMessage(self, message):
+    """Serializes if message is a google.protobuf.Any field."""
+    if '/' not in message.type_url:
+      return False
+    packed_message = _BuildMessageFromTypeName(message.TypeName(),
+                                               self.descriptor_pool)
+    if packed_message:
+      packed_message.MergeFromString(message.value)
+      colon = ':' if self.force_colon else ''
+      self.out.write('%s[%s]%s ' % (self.indent * ' ', message.type_url, colon))
+      self._PrintMessageFieldValue(packed_message)
+      self.out.write(' ' if self.as_one_line else '\n')
+      return True
+    else:
+      return False
+
+  def _TryCustomFormatMessage(self, message):
+    formatted = self.message_formatter(message, self.indent, self.as_one_line)
+    if formatted is None:
+      return False
+
+    out = self.out
+    out.write(' ' * self.indent)
+    out.write(formatted)
+    out.write(' ' if self.as_one_line else '\n')
+    return True
+
+  def PrintMessage(self, message):
+    """Convert protobuf message to text format.
+
+    Args:
+      message: The protocol buffers message.
+    """
+    if self.message_formatter and self._TryCustomFormatMessage(message):
+      return
+    if (message.DESCRIPTOR.full_name == _ANY_FULL_TYPE_NAME and
+        self._TryPrintAsAnyMessage(message)):
+      return
+    fields = message.ListFields()
+    if self.use_index_order:
+      fields.sort(
+          key=lambda x: x[0].number if x[0].is_extension else x[0].index)
+    for field, value in fields:
+      if _IsMapEntry(field):
+        for key in sorted(value):
+          # This is slow for maps with submessage entries because it copies the
+          # entire tree.  Unfortunately this would take significant refactoring
+          # of this file to work around.
+          #
+          # TODO(haberman): refactor and optimize if this becomes an issue.
+          entry_submsg = value.GetEntryClass()(key=key, value=value[key])
+          self.PrintField(field, entry_submsg)
+      elif field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+        if (self.use_short_repeated_primitives
+            and field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_MESSAGE
+            and field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_STRING):
+          self._PrintShortRepeatedPrimitivesValue(field, value)
+        else:
+          for element in value:
+            self.PrintField(field, element)
+      else:
+        self.PrintField(field, value)
+
+    if self.print_unknown_fields:
+      self._PrintUnknownFields(message.UnknownFields())
+
+  def _PrintUnknownFields(self, unknown_fields):
+    """Print unknown fields."""
+    out = self.out
+    for field in unknown_fields:
+      out.write(' ' * self.indent)
+      out.write(str(field.field_number))
+      if field.wire_type == WIRETYPE_START_GROUP:
+        if self.as_one_line:
+          out.write(' { ')
+        else:
+          out.write(' {\n')
+          self.indent += 2
+
+        self._PrintUnknownFields(field.data)
+
+        if self.as_one_line:
+          out.write('} ')
+        else:
+          self.indent -= 2
+          out.write(' ' * self.indent + '}\n')
+      elif field.wire_type == WIRETYPE_LENGTH_DELIMITED:
+        try:
+          # If this field is parseable as a Message, it is probably
+          # an embedded message.
+          # pylint: disable=protected-access
+          (embedded_unknown_message, pos) = decoder._DecodeUnknownFieldSet(
+              memoryview(field.data), 0, len(field.data))
+        except Exception:    # pylint: disable=broad-except
+          pos = 0
+
+        if pos == len(field.data):
+          if self.as_one_line:
+            out.write(' { ')
+          else:
+            out.write(' {\n')
+            self.indent += 2
+
+          self._PrintUnknownFields(embedded_unknown_message)
+
+          if self.as_one_line:
+            out.write('} ')
+          else:
+            self.indent -= 2
+            out.write(' ' * self.indent + '}\n')
+        else:
+          # A string or bytes field. self.as_utf8 may not work.
+          out.write(': \"')
+          out.write(text_encoding.CEscape(field.data, False))
+          out.write('\" ' if self.as_one_line else '\"\n')
+      else:
+        # varint, fixed32, fixed64
+        out.write(': ')
+        out.write(str(field.data))
+        out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintFieldName(self, field):
+    """Print field name."""
+    out = self.out
+    out.write(' ' * self.indent)
+    if self.use_field_number:
+      out.write(str(field.number))
+    else:
+      if field.is_extension:
+        out.write('[')
+        if (field.containing_type.GetOptions().message_set_wire_format and
+            field.type == descriptor.FieldDescriptor.TYPE_MESSAGE and
+            field.label == descriptor.FieldDescriptor.LABEL_OPTIONAL):
+          out.write(field.message_type.full_name)
+        else:
+          out.write(field.full_name)
+        out.write(']')
+      elif field.type == descriptor.FieldDescriptor.TYPE_GROUP:
+        # For groups, use the capitalized name.
+        out.write(field.message_type.name)
+      else:
+          out.write(field.name)
+
+    if (self.force_colon or
+        field.cpp_type != descriptor.FieldDescriptor.CPPTYPE_MESSAGE):
+      # The colon is optional in this case, but our cross-language golden files
+      # don't include it. Here, the colon is only included if force_colon is
+      # set to True
+      out.write(':')
+
+  def PrintField(self, field, value):
+    """Print a single field name/value pair."""
+    self._PrintFieldName(field)
+    self.out.write(' ')
+    self.PrintFieldValue(field, value)
+    self.out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintShortRepeatedPrimitivesValue(self, field, value):
+    """"Prints short repeated primitives value."""
+    # Note: this is called only when value has at least one element.
+    self._PrintFieldName(field)
+    self.out.write(' [')
+    for i in six.moves.range(len(value) - 1):
+      self.PrintFieldValue(field, value[i])
+      self.out.write(', ')
+    self.PrintFieldValue(field, value[-1])
+    self.out.write(']')
+    if self.force_colon:
+      self.out.write(':')
+    self.out.write(' ' if self.as_one_line else '\n')
+
+  def _PrintMessageFieldValue(self, value):
+    if self.pointy_brackets:
+      openb = '<'
+      closeb = '>'
+    else:
+      openb = '{'
+      closeb = '}'
+
+    if self.as_one_line:
+      self.out.write('%s ' % openb)
+      self.PrintMessage(value)
+      self.out.write(closeb)
+    else:
+      self.out.write('%s\n' % openb)
+      self.indent += 2
+      self.PrintMessage(value)
+      self.indent -= 2
+      self.out.write(' ' * self.indent + closeb)
+
+  def PrintFieldValue(self, field, value):
+    """Print a single field value (not including name).
+
+    For repeated fields, the value should be a single element.
+
+    Args:
+      field: The descriptor of the field to be printed.
+      value: The value of the field.
+    """
+    out = self.out
+    if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+      self._PrintMessageFieldValue(value)
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_ENUM:
+      enum_value = field.enum_type.values_by_number.get(value, None)
+      if enum_value is not None:
+        out.write(enum_value.name)
+      else:
+        out.write(str(value))
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_STRING:
+      out.write('\"')
+      if isinstance(value, six.text_type) and (six.PY2 or not self.as_utf8):
+        out_value = value.encode('utf-8')
+      else:
+        out_value = value
+      if field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+        # We always need to escape all binary data in TYPE_BYTES fields.
+        out_as_utf8 = False
+      else:
+        out_as_utf8 = self.as_utf8
+      out.write(text_encoding.CEscape(out_value, out_as_utf8))
+      out.write('\"')
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_BOOL:
+      if value:
+        out.write('true')
+      else:
+        out.write('false')
+    elif field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_FLOAT:
+      if self.float_format is not None:
+        out.write('{1:{0}}'.format(self.float_format, value))
+      else:
+        if math.isnan(value):
+          out.write(str(value))
+        else:
+          out.write(str(type_checkers.ToShortestFloat(value)))
+    elif (field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_DOUBLE and
+          self.double_format is not None):
+      out.write('{1:{0}}'.format(self.double_format, value))
+    else:
+      out.write(str(value))
+
+
+def Parse(text,
+          message,
+          allow_unknown_extension=False,
+          allow_field_number=False,
+          descriptor_pool=None,
+          allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  NOTE: for historical reasons this function does not clear the input
+  message. This is different from what the binary msg.ParseFrom(...) does.
+  If text contains a field already set in message, the value is appended if the
+  field is repeated. Otherwise, an error is raised.
+
+  Example::
+
+    a = MyProto()
+    a.repeated_field.append('test')
+    b = MyProto()
+
+    # Repeated fields are combined
+    text_format.Parse(repr(a), b)
+    text_format.Parse(repr(a), b) # repeated_field contains ["test", "test"]
+
+    # Non-repeated fields cannot be overwritten
+    a.singular_field = 1
+    b.singular_field = 2
+    text_format.Parse(repr(a), b) # ParseError
+
+    # Binary version:
+    b.ParseFromString(a.SerializeToString()) # repeated_field is now "test"
+
+  Caller is responsible for clearing the message as needed.
+
+  Args:
+    text (str): Message text representation.
+    message (Message): A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    Message: The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  return ParseLines(text.split(b'\n' if isinstance(text, bytes) else u'\n'),
+                    message,
+                    allow_unknown_extension,
+                    allow_field_number,
+                    descriptor_pool=descriptor_pool,
+                    allow_unknown_field=allow_unknown_field)
+
+
+def Merge(text,
+          message,
+          allow_unknown_extension=False,
+          allow_field_number=False,
+          descriptor_pool=None,
+          allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  Like Parse(), but allows repeated values for a non-repeated field, and uses
+  the last one. This means any non-repeated, top-level fields specified in text
+  replace those in the message.
+
+  Args:
+    text (str): Message text representation.
+    message (Message): A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    Message: The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  return MergeLines(
+      text.split(b'\n' if isinstance(text, bytes) else u'\n'),
+      message,
+      allow_unknown_extension,
+      allow_field_number,
+      descriptor_pool=descriptor_pool,
+      allow_unknown_field=allow_unknown_field)
+
+
+def ParseLines(lines,
+               message,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  See Parse() for caveats.
+
+  Args:
+    lines: An iterable of lines of a message's text representation.
+    message: A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool: A DescriptorPool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  parser = _Parser(allow_unknown_extension,
+                   allow_field_number,
+                   descriptor_pool=descriptor_pool,
+                   allow_unknown_field=allow_unknown_field)
+  return parser.ParseLines(lines, message)
+
+
+def MergeLines(lines,
+               message,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+  """Parses a text representation of a protocol message into a message.
+
+  See Merge() for more details.
+
+  Args:
+    lines: An iterable of lines of a message's text representation.
+    message: A protocol buffer message to merge into.
+    allow_unknown_extension: if True, skip over missing extensions and keep
+      parsing
+    allow_field_number: if True, both field number and field name are allowed.
+    descriptor_pool: A DescriptorPool used to resolve Any types.
+    allow_unknown_field: if True, skip over unknown field and keep
+      parsing. Avoid to use this option if possible. It may hide some
+      errors (e.g. spelling error on field name)
+
+  Returns:
+    The same message passed as argument.
+
+  Raises:
+    ParseError: On text parsing problems.
+  """
+  parser = _Parser(allow_unknown_extension,
+                   allow_field_number,
+                   descriptor_pool=descriptor_pool,
+                   allow_unknown_field=allow_unknown_field)
+  return parser.MergeLines(lines, message)
+
+
+class _Parser(object):
+  """Text format parser for protocol message."""
+
+  def __init__(self,
+               allow_unknown_extension=False,
+               allow_field_number=False,
+               descriptor_pool=None,
+               allow_unknown_field=False):
+    self.allow_unknown_extension = allow_unknown_extension
+    self.allow_field_number = allow_field_number
+    self.descriptor_pool = descriptor_pool
+    self.allow_unknown_field = allow_unknown_field
+
+  def ParseLines(self, lines, message):
+    """Parses a text representation of a protocol message into a message."""
+    self._allow_multiple_scalars = False
+    self._ParseOrMerge(lines, message)
+    return message
+
+  def MergeLines(self, lines, message):
+    """Merges a text representation of a protocol message into a message."""
+    self._allow_multiple_scalars = True
+    self._ParseOrMerge(lines, message)
+    return message
+
+  def _ParseOrMerge(self, lines, message):
+    """Converts a text representation of a protocol message into a message.
+
+    Args:
+      lines: Lines of a message's text representation.
+      message: A protocol buffer message to merge into.
+
+    Raises:
+      ParseError: On text parsing problems.
+    """
+    # Tokenize expects native str lines.
+    if six.PY2:
+      str_lines = (line if isinstance(line, str) else line.encode('utf-8')
+                   for line in lines)
+    else:
+      str_lines = (line if isinstance(line, str) else line.decode('utf-8')
+                   for line in lines)
+    tokenizer = Tokenizer(str_lines)
+    while not tokenizer.AtEnd():
+      self._MergeField(tokenizer, message)
+
+  def _MergeField(self, tokenizer, message):
+    """Merges a single protocol message field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field name and values.
+      message: A protocol message to record the data.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+    """
+    message_descriptor = message.DESCRIPTOR
+    if (message_descriptor.full_name == _ANY_FULL_TYPE_NAME and
+        tokenizer.TryConsume('[')):
+      type_url_prefix, packed_type_name = self._ConsumeAnyTypeUrl(tokenizer)
+      tokenizer.Consume(']')
+      tokenizer.TryConsume(':')
+      if tokenizer.TryConsume('<'):
+        expanded_any_end_token = '>'
+      else:
+        tokenizer.Consume('{')
+        expanded_any_end_token = '}'
+      expanded_any_sub_message = _BuildMessageFromTypeName(packed_type_name,
+                                                           self.descriptor_pool)
+      if not expanded_any_sub_message:
+        raise ParseError('Type %s not found in descriptor pool' %
+                         packed_type_name)
+      while not tokenizer.TryConsume(expanded_any_end_token):
+        if tokenizer.AtEnd():
+          raise tokenizer.ParseErrorPreviousToken('Expected "%s".' %
+                                                  (expanded_any_end_token,))
+        self._MergeField(tokenizer, expanded_any_sub_message)
+      deterministic = False
+
+      message.Pack(expanded_any_sub_message,
+                   type_url_prefix=type_url_prefix,
+                   deterministic=deterministic)
+      return
+
+    if tokenizer.TryConsume('['):
+      name = [tokenizer.ConsumeIdentifier()]
+      while tokenizer.TryConsume('.'):
+        name.append(tokenizer.ConsumeIdentifier())
+      name = '.'.join(name)
+
+      if not message_descriptor.is_extendable:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Message type "%s" does not have extensions.' %
+            message_descriptor.full_name)
+      # pylint: disable=protected-access
+      field = message.Extensions._FindExtensionByName(name)
+      # pylint: enable=protected-access
+
+
+      if not field:
+        if self.allow_unknown_extension:
+          field = None
+        else:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Extension "%s" not registered. '
+              'Did you import the _pb2 module which defines it? '
+              'If you are trying to place the extension in the MessageSet '
+              'field of another message that is in an Any or MessageSet field, '
+              'that message\'s _pb2 module must be imported as well' % name)
+      elif message_descriptor != field.containing_type:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Extension "%s" does not extend message type "%s".' %
+            (name, message_descriptor.full_name))
+
+      tokenizer.Consume(']')
+
+    else:
+      name = tokenizer.ConsumeIdentifierOrNumber()
+      if self.allow_field_number and name.isdigit():
+        number = ParseInteger(name, True, True)
+        field = message_descriptor.fields_by_number.get(number, None)
+        if not field and message_descriptor.is_extendable:
+          field = message.Extensions._FindExtensionByNumber(number)
+      else:
+        field = message_descriptor.fields_by_name.get(name, None)
+
+        # Group names are expected to be capitalized as they appear in the
+        # .proto file, which actually matches their type names, not their field
+        # names.
+        if not field:
+          field = message_descriptor.fields_by_name.get(name.lower(), None)
+          if field and field.type != descriptor.FieldDescriptor.TYPE_GROUP:
+            field = None
+
+        if (field and field.type == descriptor.FieldDescriptor.TYPE_GROUP and
+            field.message_type.name != name):
+          field = None
+
+      if not field and not self.allow_unknown_field:
+        raise tokenizer.ParseErrorPreviousToken(
+            'Message type "%s" has no field named "%s".' %
+            (message_descriptor.full_name, name))
+
+    if field:
+      if not self._allow_multiple_scalars and field.containing_oneof:
+        # Check if there's a different field set in this oneof.
+        # Note that we ignore the case if the same field was set before, and we
+        # apply _allow_multiple_scalars to non-scalar fields as well.
+        which_oneof = message.WhichOneof(field.containing_oneof.name)
+        if which_oneof is not None and which_oneof != field.name:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Field "%s" is specified along with field "%s", another member '
+              'of oneof "%s" for message type "%s".' %
+              (field.name, which_oneof, field.containing_oneof.name,
+               message_descriptor.full_name))
+
+      if field.cpp_type == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        tokenizer.TryConsume(':')
+        merger = self._MergeMessageField
+      else:
+        tokenizer.Consume(':')
+        merger = self._MergeScalarField
+
+      if (field.label == descriptor.FieldDescriptor.LABEL_REPEATED and
+          tokenizer.TryConsume('[')):
+        # Short repeated format, e.g. "foo: [1, 2, 3]"
+        if not tokenizer.TryConsume(']'):
+          while True:
+            merger(tokenizer, message, field)
+            if tokenizer.TryConsume(']'):
+              break
+            tokenizer.Consume(',')
+
+      else:
+        merger(tokenizer, message, field)
+
+    else:  # Proto field is unknown.
+      assert (self.allow_unknown_extension or self.allow_unknown_field)
+      _SkipFieldContents(tokenizer)
+
+    # For historical reasons, fields may optionally be separated by commas or
+    # semicolons.
+    if not tokenizer.TryConsume(','):
+      tokenizer.TryConsume(';')
+
+
+  def _ConsumeAnyTypeUrl(self, tokenizer):
+    """Consumes a google.protobuf.Any type URL and returns the type name."""
+    # Consume "type.googleapis.com/".
+    prefix = [tokenizer.ConsumeIdentifier()]
+    tokenizer.Consume('.')
+    prefix.append(tokenizer.ConsumeIdentifier())
+    tokenizer.Consume('.')
+    prefix.append(tokenizer.ConsumeIdentifier())
+    tokenizer.Consume('/')
+    # Consume the fully-qualified type name.
+    name = [tokenizer.ConsumeIdentifier()]
+    while tokenizer.TryConsume('.'):
+      name.append(tokenizer.ConsumeIdentifier())
+    return '.'.join(prefix), '.'.join(name)
+
+  def _MergeMessageField(self, tokenizer, message, field):
+    """Merges a single scalar field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field value.
+      message: The message of which field is a member.
+      field: The descriptor of the field to be merged.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+    """
+    is_map_entry = _IsMapEntry(field)
+
+    if tokenizer.TryConsume('<'):
+      end_token = '>'
+    else:
+      tokenizer.Consume('{')
+      end_token = '}'
+
+    if field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      if field.is_extension:
+        sub_message = message.Extensions[field].add()
+      elif is_map_entry:
+        sub_message = getattr(message, field.name).GetEntryClass()()
+      else:
+        sub_message = getattr(message, field.name).add()
+    else:
+      if field.is_extension:
+        if (not self._allow_multiple_scalars and
+            message.HasExtension(field)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" extensions.' %
+              (message.DESCRIPTOR.full_name, field.full_name))
+        sub_message = message.Extensions[field]
+      else:
+        # Also apply _allow_multiple_scalars to message field.
+        # TODO(jieluo): Change to _allow_singular_overwrites.
+        if (not self._allow_multiple_scalars and
+            message.HasField(field.name)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" fields.' %
+              (message.DESCRIPTOR.full_name, field.name))
+        sub_message = getattr(message, field.name)
+      sub_message.SetInParent()
+
+    while not tokenizer.TryConsume(end_token):
+      if tokenizer.AtEnd():
+        raise tokenizer.ParseErrorPreviousToken('Expected "%s".' % (end_token,))
+      self._MergeField(tokenizer, sub_message)
+
+    if is_map_entry:
+      value_cpptype = field.message_type.fields_by_name['value'].cpp_type
+      if value_cpptype == descriptor.FieldDescriptor.CPPTYPE_MESSAGE:
+        value = getattr(message, field.name)[sub_message.key]
+        value.MergeFrom(sub_message.value)
+      else:
+        getattr(message, field.name)[sub_message.key] = sub_message.value
+
+  @staticmethod
+  def _IsProto3Syntax(message):
+    message_descriptor = message.DESCRIPTOR
+    return (hasattr(message_descriptor, 'syntax') and
+            message_descriptor.syntax == 'proto3')
+
+  def _MergeScalarField(self, tokenizer, message, field):
+    """Merges a single scalar field into a message.
+
+    Args:
+      tokenizer: A tokenizer to parse the field value.
+      message: A protocol message to record the data.
+      field: The descriptor of the field to be merged.
+
+    Raises:
+      ParseError: In case of text parsing problems.
+      RuntimeError: On runtime errors.
+    """
+    _ = self.allow_unknown_extension
+    value = None
+
+    if field.type in (descriptor.FieldDescriptor.TYPE_INT32,
+                      descriptor.FieldDescriptor.TYPE_SINT32,
+                      descriptor.FieldDescriptor.TYPE_SFIXED32):
+      value = _ConsumeInt32(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_INT64,
+                        descriptor.FieldDescriptor.TYPE_SINT64,
+                        descriptor.FieldDescriptor.TYPE_SFIXED64):
+      value = _ConsumeInt64(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_UINT32,
+                        descriptor.FieldDescriptor.TYPE_FIXED32):
+      value = _ConsumeUint32(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_UINT64,
+                        descriptor.FieldDescriptor.TYPE_FIXED64):
+      value = _ConsumeUint64(tokenizer)
+    elif field.type in (descriptor.FieldDescriptor.TYPE_FLOAT,
+                        descriptor.FieldDescriptor.TYPE_DOUBLE):
+      value = tokenizer.ConsumeFloat()
+    elif field.type == descriptor.FieldDescriptor.TYPE_BOOL:
+      value = tokenizer.ConsumeBool()
+    elif field.type == descriptor.FieldDescriptor.TYPE_STRING:
+      value = tokenizer.ConsumeString()
+    elif field.type == descriptor.FieldDescriptor.TYPE_BYTES:
+      value = tokenizer.ConsumeByteString()
+    elif field.type == descriptor.FieldDescriptor.TYPE_ENUM:
+      value = tokenizer.ConsumeEnum(field)
+    else:
+      raise RuntimeError('Unknown field type %d' % field.type)
+
+    if field.label == descriptor.FieldDescriptor.LABEL_REPEATED:
+      if field.is_extension:
+        message.Extensions[field].append(value)
+      else:
+        getattr(message, field.name).append(value)
+    else:
+      if field.is_extension:
+        if (not self._allow_multiple_scalars and
+            not self._IsProto3Syntax(message) and
+            message.HasExtension(field)):
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" extensions.' %
+              (message.DESCRIPTOR.full_name, field.full_name))
+        else:
+          message.Extensions[field] = value
+      else:
+        duplicate_error = False
+        if not self._allow_multiple_scalars:
+          if self._IsProto3Syntax(message):
+            # Proto3 doesn't represent presence so we try best effort to check
+            # multiple scalars by compare to default values.
+            duplicate_error = bool(getattr(message, field.name))
+          else:
+            duplicate_error = message.HasField(field.name)
+
+        if duplicate_error:
+          raise tokenizer.ParseErrorPreviousToken(
+              'Message type "%s" should not have multiple "%s" fields.' %
+              (message.DESCRIPTOR.full_name, field.name))
+        else:
+          setattr(message, field.name, value)
+
+
+def _SkipFieldContents(tokenizer):
+  """Skips over contents (value or message) of a field.
+
+  Args:
+    tokenizer: A tokenizer to parse the field name and values.
+  """
+  # Try to guess the type of this field.
+  # If this field is not a message, there should be a ":" between the
+  # field name and the field value and also the field value should not
+  # start with "{" or "<" which indicates the beginning of a message body.
+  # If there is no ":" or there is a "{" or "<" after ":", this field has
+  # to be a message or the input is ill-formed.
+  if tokenizer.TryConsume(':') and not tokenizer.LookingAt(
+      '{') and not tokenizer.LookingAt('<'):
+    _SkipFieldValue(tokenizer)
+  else:
+    _SkipFieldMessage(tokenizer)
+
+
+def _SkipField(tokenizer):
+  """Skips over a complete field (name and value/message).
+
+  Args:
+    tokenizer: A tokenizer to parse the field name and values.
+  """
+  if tokenizer.TryConsume('['):
+    # Consume extension name.
+    tokenizer.ConsumeIdentifier()
+    while tokenizer.TryConsume('.'):
+      tokenizer.ConsumeIdentifier()
+    tokenizer.Consume(']')
+  else:
+    tokenizer.ConsumeIdentifierOrNumber()
+
+  _SkipFieldContents(tokenizer)
+
+  # For historical reasons, fields may optionally be separated by commas or
+  # semicolons.
+  if not tokenizer.TryConsume(','):
+    tokenizer.TryConsume(';')
+
+
+def _SkipFieldMessage(tokenizer):
+  """Skips over a field message.
+
+  Args:
+    tokenizer: A tokenizer to parse the field name and values.
+  """
+
+  if tokenizer.TryConsume('<'):
+    delimiter = '>'
+  else:
+    tokenizer.Consume('{')
+    delimiter = '}'
+
+  while not tokenizer.LookingAt('>') and not tokenizer.LookingAt('}'):
+    _SkipField(tokenizer)
+
+  tokenizer.Consume(delimiter)
+
+
+def _SkipFieldValue(tokenizer):
+  """Skips over a field value.
+
+  Args:
+    tokenizer: A tokenizer to parse the field name and values.
+
+  Raises:
+    ParseError: In case an invalid field value is found.
+  """
+  # String/bytes tokens can come in multiple adjacent string literals.
+  # If we can consume one, consume as many as we can.
+  if tokenizer.TryConsumeByteString():
+    while tokenizer.TryConsumeByteString():
+      pass
+    return
+
+  if (not tokenizer.TryConsumeIdentifier() and
+      not _TryConsumeInt64(tokenizer) and not _TryConsumeUint64(tokenizer) and
+      not tokenizer.TryConsumeFloat()):
+    raise ParseError('Invalid field value: ' + tokenizer.token)
+
+
+class Tokenizer(object):
+  """Protocol buffer text representation tokenizer.
+
+  This class handles the lower level string parsing by splitting it into
+  meaningful tokens.
+
+  It was directly ported from the Java protocol buffer API.
+  """
+
+  _WHITESPACE = re.compile(r'\s+')
+  _COMMENT = re.compile(r'(\s*#.*$)', re.MULTILINE)
+  _WHITESPACE_OR_COMMENT = re.compile(r'(\s|(#.*$))+', re.MULTILINE)
+  _TOKEN = re.compile('|'.join([
+      r'[a-zA-Z_][0-9a-zA-Z_+-]*',  # an identifier
+      r'([0-9+-]|(\.[0-9]))[0-9a-zA-Z_.+-]*',  # a number
+  ] + [  # quoted str for each quote mark
+      # Avoid backtracking! https://stackoverflow.com/a/844267
+      r'{qt}[^{qt}\n\\]*((\\.)+[^{qt}\n\\]*)*({qt}|\\?$)'.format(qt=mark)
+      for mark in _QUOTES
+  ]))
+
+  _IDENTIFIER = re.compile(r'[^\d\W]\w*')
+  _IDENTIFIER_OR_NUMBER = re.compile(r'\w+')
+
+  def __init__(self, lines, skip_comments=True):
+    self._position = 0
+    self._line = -1
+    self._column = 0
+    self._token_start = None
+    self.token = ''
+    self._lines = iter(lines)
+    self._current_line = ''
+    self._previous_line = 0
+    self._previous_column = 0
+    self._more_lines = True
+    self._skip_comments = skip_comments
+    self._whitespace_pattern = (skip_comments and self._WHITESPACE_OR_COMMENT
+                                or self._WHITESPACE)
+    self._SkipWhitespace()
+    self.NextToken()
+
+  def LookingAt(self, token):
+    return self.token == token
+
+  def AtEnd(self):
+    """Checks the end of the text was reached.
+
+    Returns:
+      True iff the end was reached.
+    """
+    return not self.token
+
+  def _PopLine(self):
+    while len(self._current_line) <= self._column:
+      try:
+        self._current_line = next(self._lines)
+      except StopIteration:
+        self._current_line = ''
+        self._more_lines = False
+        return
+      else:
+        self._line += 1
+        self._column = 0
+
+  def _SkipWhitespace(self):
+    while True:
+      self._PopLine()
+      match = self._whitespace_pattern.match(self._current_line, self._column)
+      if not match:
+        break
+      length = len(match.group(0))
+      self._column += length
+
+  def TryConsume(self, token):
+    """Tries to consume a given piece of text.
+
+    Args:
+      token: Text to consume.
+
+    Returns:
+      True iff the text was consumed.
+    """
+    if self.token == token:
+      self.NextToken()
+      return True
+    return False
+
+  def Consume(self, token):
+    """Consumes a piece of text.
+
+    Args:
+      token: Text to consume.
+
+    Raises:
+      ParseError: If the text couldn't be consumed.
+    """
+    if not self.TryConsume(token):
+      raise self.ParseError('Expected "%s".' % token)
+
+  def ConsumeComment(self):
+    result = self.token
+    if not self._COMMENT.match(result):
+      raise self.ParseError('Expected comment.')
+    self.NextToken()
+    return result
+
+  def ConsumeCommentOrTrailingComment(self):
+    """Consumes a comment, returns a 2-tuple (trailing bool, comment str)."""
+
+    # Tokenizer initializes _previous_line and _previous_column to 0. As the
+    # tokenizer starts, it looks like there is a previous token on the line.
+    just_started = self._line == 0 and self._column == 0
+
+    before_parsing = self._previous_line
+    comment = self.ConsumeComment()
+
+    # A trailing comment is a comment on the same line than the previous token.
+    trailing = (self._previous_line == before_parsing
+                and not just_started)
+
+    return trailing, comment
+
+  def TryConsumeIdentifier(self):
+    try:
+      self.ConsumeIdentifier()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeIdentifier(self):
+    """Consumes protocol message field identifier.
+
+    Returns:
+      Identifier string.
+
+    Raises:
+      ParseError: If an identifier couldn't be consumed.
+    """
+    result = self.token
+    if not self._IDENTIFIER.match(result):
+      raise self.ParseError('Expected identifier.')
+    self.NextToken()
+    return result
+
+  def TryConsumeIdentifierOrNumber(self):
+    try:
+      self.ConsumeIdentifierOrNumber()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeIdentifierOrNumber(self):
+    """Consumes protocol message field identifier.
+
+    Returns:
+      Identifier string.
+
+    Raises:
+      ParseError: If an identifier couldn't be consumed.
+    """
+    result = self.token
+    if not self._IDENTIFIER_OR_NUMBER.match(result):
+      raise self.ParseError('Expected identifier or number, got %s.' % result)
+    self.NextToken()
+    return result
+
+  def TryConsumeInteger(self):
+    try:
+      # Note: is_long only affects value type, not whether an error is raised.
+      self.ConsumeInteger()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeInteger(self, is_long=False):
+    """Consumes an integer number.
+
+    Args:
+      is_long: True if the value should be returned as a long integer.
+    Returns:
+      The integer parsed.
+
+    Raises:
+      ParseError: If an integer couldn't be consumed.
+    """
+    try:
+      result = _ParseAbstractInteger(self.token, is_long=is_long)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def TryConsumeFloat(self):
+    try:
+      self.ConsumeFloat()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeFloat(self):
+    """Consumes an floating point number.
+
+    Returns:
+      The number parsed.
+
+    Raises:
+      ParseError: If a floating point number couldn't be consumed.
+    """
+    try:
+      result = ParseFloat(self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ConsumeBool(self):
+    """Consumes a boolean value.
+
+    Returns:
+      The bool parsed.
+
+    Raises:
+      ParseError: If a boolean value couldn't be consumed.
+    """
+    try:
+      result = ParseBool(self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def TryConsumeByteString(self):
+    try:
+      self.ConsumeByteString()
+      return True
+    except ParseError:
+      return False
+
+  def ConsumeString(self):
+    """Consumes a string value.
+
+    Returns:
+      The string parsed.
+
+    Raises:
+      ParseError: If a string value couldn't be consumed.
+    """
+    the_bytes = self.ConsumeByteString()
+    try:
+      return six.text_type(the_bytes, 'utf-8')
+    except UnicodeDecodeError as e:
+      raise self._StringParseError(e)
+
+  def ConsumeByteString(self):
+    """Consumes a byte array value.
+
+    Returns:
+      The array parsed (as a string).
+
+    Raises:
+      ParseError: If a byte array value couldn't be consumed.
+    """
+    the_list = [self._ConsumeSingleByteString()]
+    while self.token and self.token[0] in _QUOTES:
+      the_list.append(self._ConsumeSingleByteString())
+    return b''.join(the_list)
+
+  def _ConsumeSingleByteString(self):
+    """Consume one token of a string literal.
+
+    String literals (whether bytes or text) can come in multiple adjacent
+    tokens which are automatically concatenated, like in C or Python.  This
+    method only consumes one token.
+
+    Returns:
+      The token parsed.
+    Raises:
+      ParseError: When the wrong format data is found.
+    """
+    text = self.token
+    if len(text) < 1 or text[0] not in _QUOTES:
+      raise self.ParseError('Expected string but found: %r' % (text,))
+
+    if len(text) < 2 or text[-1] != text[0]:
+      raise self.ParseError('String missing ending quote: %r' % (text,))
+
+    try:
+      result = text_encoding.CUnescape(text[1:-1])
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ConsumeEnum(self, field):
+    try:
+      result = ParseEnum(field, self.token)
+    except ValueError as e:
+      raise self.ParseError(str(e))
+    self.NextToken()
+    return result
+
+  def ParseErrorPreviousToken(self, message):
+    """Creates and *returns* a ParseError for the previously read token.
+
+    Args:
+      message: A message to set for the exception.
+
+    Returns:
+      A ParseError instance.
+    """
+    return ParseError(message, self._previous_line + 1,
+                      self._previous_column + 1)
+
+  def ParseError(self, message):
+    """Creates and *returns* a ParseError for the current token."""
+    return ParseError('\'' + self._current_line + '\': ' + message,
+                      self._line + 1, self._column + 1)
+
+  def _StringParseError(self, e):
+    return self.ParseError('Couldn\'t parse string: ' + str(e))
+
+  def NextToken(self):
+    """Reads the next meaningful token."""
+    self._previous_line = self._line
+    self._previous_column = self._column
+
+    self._column += len(self.token)
+    self._SkipWhitespace()
+
+    if not self._more_lines:
+      self.token = ''
+      return
+
+    match = self._TOKEN.match(self._current_line, self._column)
+    if not match and not self._skip_comments:
+      match = self._COMMENT.match(self._current_line, self._column)
+    if match:
+      token = match.group(0)
+      self.token = token
+    else:
+      self.token = self._current_line[self._column]
+
+# Aliased so it can still be accessed by current visibility violators.
+# TODO(dbarnett): Migrate violators to textformat_tokenizer.
+_Tokenizer = Tokenizer  # pylint: disable=invalid-name
+
+
+def _ConsumeInt32(tokenizer):
+  """Consumes a signed 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If a signed 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=True, is_long=False)
+
+
+def _ConsumeUint32(tokenizer):
+  """Consumes an unsigned 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an unsigned 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=False, is_long=False)
+
+
+def _TryConsumeInt64(tokenizer):
+  try:
+    _ConsumeInt64(tokenizer)
+    return True
+  except ParseError:
+    return False
+
+
+def _ConsumeInt64(tokenizer):
+  """Consumes a signed 32bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If a signed 32bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=True, is_long=True)
+
+
+def _TryConsumeUint64(tokenizer):
+  try:
+    _ConsumeUint64(tokenizer)
+    return True
+  except ParseError:
+    return False
+
+
+def _ConsumeUint64(tokenizer):
+  """Consumes an unsigned 64bit integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an unsigned 64bit integer couldn't be consumed.
+  """
+  return _ConsumeInteger(tokenizer, is_signed=False, is_long=True)
+
+
+def _TryConsumeInteger(tokenizer, is_signed=False, is_long=False):
+  try:
+    _ConsumeInteger(tokenizer, is_signed=is_signed, is_long=is_long)
+    return True
+  except ParseError:
+    return False
+
+
+def _ConsumeInteger(tokenizer, is_signed=False, is_long=False):
+  """Consumes an integer number from tokenizer.
+
+  Args:
+    tokenizer: A tokenizer used to parse the number.
+    is_signed: True if a signed integer must be parsed.
+    is_long: True if a long integer must be parsed.
+
+  Returns:
+    The integer parsed.
+
+  Raises:
+    ParseError: If an integer with given characteristics couldn't be consumed.
+  """
+  try:
+    result = ParseInteger(tokenizer.token, is_signed=is_signed, is_long=is_long)
+  except ValueError as e:
+    raise tokenizer.ParseError(str(e))
+  tokenizer.NextToken()
+  return result
+
+
+def ParseInteger(text, is_signed=False, is_long=False):
+  """Parses an integer.
+
+  Args:
+    text: The text to parse.
+    is_signed: True if a signed integer must be parsed.
+    is_long: True if a long integer must be parsed.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ValueError: Thrown Iff the text is not a valid integer.
+  """
+  # Do the actual parsing. Exception handling is propagated to caller.
+  result = _ParseAbstractInteger(text, is_long=is_long)
+
+  # Check if the integer is sane. Exceptions handled by callers.
+  checker = _INTEGER_CHECKERS[2 * int(is_long) + int(is_signed)]
+  checker.CheckValue(result)
+  return result
+
+
+def _ParseAbstractInteger(text, is_long=False):
+  """Parses an integer without checking size/signedness.
+
+  Args:
+    text: The text to parse.
+    is_long: True if the value should be returned as a long integer.
+
+  Returns:
+    The integer value.
+
+  Raises:
+    ValueError: Thrown Iff the text is not a valid integer.
+  """
+  # Do the actual parsing. Exception handling is propagated to caller.
+  orig_text = text
+  c_octal_match = re.match(r'(-?)0(\d+)$', text)
+  if c_octal_match:
+    # Python 3 no longer supports 0755 octal syntax without the 'o', so
+    # we always use the '0o' prefix for multi-digit numbers starting with 0.
+    text = c_octal_match.group(1) + '0o' + c_octal_match.group(2)
+  try:
+    # We force 32-bit values to int and 64-bit values to long to make
+    # alternate implementations where the distinction is more significant
+    # (e.g. the C++ implementation) simpler.
+    if is_long:
+      return long(text, 0)
+    else:
+      return int(text, 0)
+  except ValueError:
+    raise ValueError('Couldn\'t parse integer: %s' % orig_text)
+
+
+def ParseFloat(text):
+  """Parse a floating point number.
+
+  Args:
+    text: Text to parse.
+
+  Returns:
+    The number parsed.
+
+  Raises:
+    ValueError: If a floating point number couldn't be parsed.
+  """
+  try:
+    # Assume Python compatible syntax.
+    return float(text)
+  except ValueError:
+    # Check alternative spellings.
+    if _FLOAT_INFINITY.match(text):
+      if text[0] == '-':
+        return float('-inf')
+      else:
+        return float('inf')
+    elif _FLOAT_NAN.match(text):
+      return float('nan')
+    else:
+      # assume '1.0f' format
+      try:
+        return float(text.rstrip('f'))
+      except ValueError:
+        raise ValueError('Couldn\'t parse float: %s' % text)
+
+
+def ParseBool(text):
+  """Parse a boolean value.
+
+  Args:
+    text: Text to parse.
+
+  Returns:
+    Boolean values parsed
+
+  Raises:
+    ValueError: If text is not a valid boolean.
+  """
+  if text in ('true', 't', '1', 'True'):
+    return True
+  elif text in ('false', 'f', '0', 'False'):
+    return False
+  else:
+    raise ValueError('Expected "true" or "false".')
+
+
+def ParseEnum(field, value):
+  """Parse an enum value.
+
+  The value can be specified by a number (the enum value), or by
+  a string literal (the enum name).
+
+  Args:
+    field: Enum field descriptor.
+    value: String value.
+
+  Returns:
+    Enum value number.
+
+  Raises:
+    ValueError: If the enum value could not be parsed.
+  """
+  enum_descriptor = field.enum_type
+  try:
+    number = int(value, 0)
+  except ValueError:
+    # Identifier.
+    enum_value = enum_descriptor.values_by_name.get(value, None)
+    if enum_value is None:
+      raise ValueError('Enum type "%s" has no value named %s.' %
+                       (enum_descriptor.full_name, value))
+  else:
+    # Numeric value.
+    if hasattr(field.file, 'syntax'):
+      # Attribute is checked for compatibility.
+      if field.file.syntax == 'proto3':
+        # Proto3 accept numeric unknown enums.
+        return number
+    enum_value = enum_descriptor.values_by_number.get(number, None)
+    if enum_value is None:
+      raise ValueError('Enum type "%s" has no value with number %d.' %
+                       (enum_descriptor.full_name, number))
+  return enum_value.number
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/timestamp_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/timestamp_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..6fb22d2c0e6be48524b9923ae39a06480627b8fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/timestamp_pb2.py
@@ -0,0 +1,78 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/timestamp.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/timestamp.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\016TimestampProtoP\001Z2google.golang.org/protobuf/types/known/timestamppb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1fgoogle/protobuf/timestamp.proto\x12\x0fgoogle.protobuf\"+\n\tTimestamp\x12\x0f\n\x07seconds\x18\x01 \x01(\x03\x12\r\n\x05nanos\x18\x02 \x01(\x05\x42\x85\x01\n\x13\x63om.google.protobufB\x0eTimestampProtoP\x01Z2google.golang.org/protobuf/types/known/timestamppb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_TIMESTAMP = _descriptor.Descriptor(
+  name='Timestamp',
+  full_name='google.protobuf.Timestamp',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='seconds', full_name='google.protobuf.Timestamp.seconds', index=0,
+      number=1, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='nanos', full_name='google.protobuf.Timestamp.nanos', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=52,
+  serialized_end=95,
+)
+
+DESCRIPTOR.message_types_by_name['Timestamp'] = _TIMESTAMP
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Timestamp = _reflection.GeneratedProtocolMessageType('Timestamp', (_message.Message,), {
+  'DESCRIPTOR' : _TIMESTAMP,
+  '__module__' : 'google.protobuf.timestamp_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Timestamp)
+  })
+_sym_db.RegisterMessage(Timestamp)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/type_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/type_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..bec1a1e105bd7e36d63830d345623c40085e6acf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/type_pb2.py
@@ -0,0 +1,573 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/type.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import source_context_pb2 as google_dot_protobuf_dot_source__context__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/type.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\tTypeProtoP\001Z-google.golang.org/protobuf/types/known/typepb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1agoogle/protobuf/type.proto\x12\x0fgoogle.protobuf\x1a\x19google/protobuf/any.proto\x1a$google/protobuf/source_context.proto\"\xd7\x01\n\x04Type\x12\x0c\n\x04name\x18\x01 \x01(\t\x12&\n\x06\x66ields\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Field\x12\x0e\n\x06oneofs\x18\x03 \x03(\t\x12(\n\x07options\x18\x04 \x03(\x0b\x32\x17.google.protobuf.Option\x12\x36\n\x0esource_context\x18\x05 \x01(\x0b\x32\x1e.google.protobuf.SourceContext\x12\'\n\x06syntax\x18\x06 \x01(\x0e\x32\x17.google.protobuf.Syntax\"\xd5\x05\n\x05\x46ield\x12)\n\x04kind\x18\x01 \x01(\x0e\x32\x1b.google.protobuf.Field.Kind\x12\x37\n\x0b\x63\x61rdinality\x18\x02 \x01(\x0e\x32\".google.protobuf.Field.Cardinality\x12\x0e\n\x06number\x18\x03 \x01(\x05\x12\x0c\n\x04name\x18\x04 \x01(\t\x12\x10\n\x08type_url\x18\x06 \x01(\t\x12\x13\n\x0boneof_index\x18\x07 \x01(\x05\x12\x0e\n\x06packed\x18\x08 \x01(\x08\x12(\n\x07options\x18\t \x03(\x0b\x32\x17.google.protobuf.Option\x12\x11\n\tjson_name\x18\n \x01(\t\x12\x15\n\rdefault_value\x18\x0b \x01(\t\"\xc8\x02\n\x04Kind\x12\x10\n\x0cTYPE_UNKNOWN\x10\x00\x12\x0f\n\x0bTYPE_DOUBLE\x10\x01\x12\x0e\n\nTYPE_FLOAT\x10\x02\x12\x0e\n\nTYPE_INT64\x10\x03\x12\x0f\n\x0bTYPE_UINT64\x10\x04\x12\x0e\n\nTYPE_INT32\x10\x05\x12\x10\n\x0cTYPE_FIXED64\x10\x06\x12\x10\n\x0cTYPE_FIXED32\x10\x07\x12\r\n\tTYPE_BOOL\x10\x08\x12\x0f\n\x0bTYPE_STRING\x10\t\x12\x0e\n\nTYPE_GROUP\x10\n\x12\x10\n\x0cTYPE_MESSAGE\x10\x0b\x12\x0e\n\nTYPE_BYTES\x10\x0c\x12\x0f\n\x0bTYPE_UINT32\x10\r\x12\r\n\tTYPE_ENUM\x10\x0e\x12\x11\n\rTYPE_SFIXED32\x10\x0f\x12\x11\n\rTYPE_SFIXED64\x10\x10\x12\x0f\n\x0bTYPE_SINT32\x10\x11\x12\x0f\n\x0bTYPE_SINT64\x10\x12\"t\n\x0b\x43\x61rdinality\x12\x17\n\x13\x43\x41RDINALITY_UNKNOWN\x10\x00\x12\x18\n\x14\x43\x41RDINALITY_OPTIONAL\x10\x01\x12\x18\n\x14\x43\x41RDINALITY_REQUIRED\x10\x02\x12\x18\n\x14\x43\x41RDINALITY_REPEATED\x10\x03\"\xce\x01\n\x04\x45num\x12\x0c\n\x04name\x18\x01 \x01(\t\x12-\n\tenumvalue\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.EnumValue\x12(\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.Option\x12\x36\n\x0esource_context\x18\x04 \x01(\x0b\x32\x1e.google.protobuf.SourceContext\x12\'\n\x06syntax\x18\x05 \x01(\x0e\x32\x17.google.protobuf.Syntax\"S\n\tEnumValue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06number\x18\x02 \x01(\x05\x12(\n\x07options\x18\x03 \x03(\x0b\x32\x17.google.protobuf.Option\";\n\x06Option\x12\x0c\n\x04name\x18\x01 \x01(\t\x12#\n\x05value\x18\x02 \x01(\x0b\x32\x14.google.protobuf.Any*.\n\x06Syntax\x12\x11\n\rSYNTAX_PROTO2\x10\x00\x12\x11\n\rSYNTAX_PROTO3\x10\x01\x42{\n\x13\x63om.google.protobufB\tTypeProtoP\x01Z-google.golang.org/protobuf/types/known/typepb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+  ,
+  dependencies=[google_dot_protobuf_dot_any__pb2.DESCRIPTOR,google_dot_protobuf_dot_source__context__pb2.DESCRIPTOR,])
+
+_SYNTAX = _descriptor.EnumDescriptor(
+  name='Syntax',
+  full_name='google.protobuf.Syntax',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='SYNTAX_PROTO2', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='SYNTAX_PROTO3', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=1413,
+  serialized_end=1459,
+)
+_sym_db.RegisterEnumDescriptor(_SYNTAX)
+
+Syntax = enum_type_wrapper.EnumTypeWrapper(_SYNTAX)
+SYNTAX_PROTO2 = 0
+SYNTAX_PROTO3 = 1
+
+
+_FIELD_KIND = _descriptor.EnumDescriptor(
+  name='Kind',
+  full_name='google.protobuf.Field.Kind',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_UNKNOWN', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_DOUBLE', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FLOAT', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_INT64', index=3, number=3,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_UINT64', index=4, number=4,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_INT32', index=5, number=5,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FIXED64', index=6, number=6,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_FIXED32', index=7, number=7,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_BOOL', index=8, number=8,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_STRING', index=9, number=9,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_GROUP', index=10, number=10,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_MESSAGE', index=11, number=11,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_BYTES', index=12, number=12,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_UINT32', index=13, number=13,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_ENUM', index=14, number=14,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SFIXED32', index=15, number=15,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SFIXED64', index=16, number=16,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SINT32', index=17, number=17,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='TYPE_SINT64', index=18, number=18,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=610,
+  serialized_end=938,
+)
+_sym_db.RegisterEnumDescriptor(_FIELD_KIND)
+
+_FIELD_CARDINALITY = _descriptor.EnumDescriptor(
+  name='Cardinality',
+  full_name='google.protobuf.Field.Cardinality',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='CARDINALITY_UNKNOWN', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='CARDINALITY_OPTIONAL', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='CARDINALITY_REQUIRED', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='CARDINALITY_REPEATED', index=3, number=3,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=940,
+  serialized_end=1056,
+)
+_sym_db.RegisterEnumDescriptor(_FIELD_CARDINALITY)
+
+
+_TYPE = _descriptor.Descriptor(
+  name='Type',
+  full_name='google.protobuf.Type',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Type.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='fields', full_name='google.protobuf.Type.fields', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneofs', full_name='google.protobuf.Type.oneofs', index=2,
+      number=3, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.Type.options', index=3,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='source_context', full_name='google.protobuf.Type.source_context', index=4,
+      number=5, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='syntax', full_name='google.protobuf.Type.syntax', index=5,
+      number=6, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=113,
+  serialized_end=328,
+)
+
+
+_FIELD = _descriptor.Descriptor(
+  name='Field',
+  full_name='google.protobuf.Field',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='kind', full_name='google.protobuf.Field.kind', index=0,
+      number=1, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='cardinality', full_name='google.protobuf.Field.cardinality', index=1,
+      number=2, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='number', full_name='google.protobuf.Field.number', index=2,
+      number=3, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Field.name', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='type_url', full_name='google.protobuf.Field.type_url', index=4,
+      number=6, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_index', full_name='google.protobuf.Field.oneof_index', index=5,
+      number=7, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='packed', full_name='google.protobuf.Field.packed', index=6,
+      number=8, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.Field.options', index=7,
+      number=9, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='json_name', full_name='google.protobuf.Field.json_name', index=8,
+      number=10, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='default_value', full_name='google.protobuf.Field.default_value', index=9,
+      number=11, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _FIELD_KIND,
+    _FIELD_CARDINALITY,
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=331,
+  serialized_end=1056,
+)
+
+
+_ENUM = _descriptor.Descriptor(
+  name='Enum',
+  full_name='google.protobuf.Enum',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Enum.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enumvalue', full_name='google.protobuf.Enum.enumvalue', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.Enum.options', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='source_context', full_name='google.protobuf.Enum.source_context', index=3,
+      number=4, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='syntax', full_name='google.protobuf.Enum.syntax', index=4,
+      number=5, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1059,
+  serialized_end=1265,
+)
+
+
+_ENUMVALUE = _descriptor.Descriptor(
+  name='EnumValue',
+  full_name='google.protobuf.EnumValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.EnumValue.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='number', full_name='google.protobuf.EnumValue.number', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='options', full_name='google.protobuf.EnumValue.options', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1267,
+  serialized_end=1350,
+)
+
+
+_OPTION = _descriptor.Descriptor(
+  name='Option',
+  full_name='google.protobuf.Option',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='name', full_name='google.protobuf.Option.name', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.Option.value', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1352,
+  serialized_end=1411,
+)
+
+_TYPE.fields_by_name['fields'].message_type = _FIELD
+_TYPE.fields_by_name['options'].message_type = _OPTION
+_TYPE.fields_by_name['source_context'].message_type = google_dot_protobuf_dot_source__context__pb2._SOURCECONTEXT
+_TYPE.fields_by_name['syntax'].enum_type = _SYNTAX
+_FIELD.fields_by_name['kind'].enum_type = _FIELD_KIND
+_FIELD.fields_by_name['cardinality'].enum_type = _FIELD_CARDINALITY
+_FIELD.fields_by_name['options'].message_type = _OPTION
+_FIELD_KIND.containing_type = _FIELD
+_FIELD_CARDINALITY.containing_type = _FIELD
+_ENUM.fields_by_name['enumvalue'].message_type = _ENUMVALUE
+_ENUM.fields_by_name['options'].message_type = _OPTION
+_ENUM.fields_by_name['source_context'].message_type = google_dot_protobuf_dot_source__context__pb2._SOURCECONTEXT
+_ENUM.fields_by_name['syntax'].enum_type = _SYNTAX
+_ENUMVALUE.fields_by_name['options'].message_type = _OPTION
+_OPTION.fields_by_name['value'].message_type = google_dot_protobuf_dot_any__pb2._ANY
+DESCRIPTOR.message_types_by_name['Type'] = _TYPE
+DESCRIPTOR.message_types_by_name['Field'] = _FIELD
+DESCRIPTOR.message_types_by_name['Enum'] = _ENUM
+DESCRIPTOR.message_types_by_name['EnumValue'] = _ENUMVALUE
+DESCRIPTOR.message_types_by_name['Option'] = _OPTION
+DESCRIPTOR.enum_types_by_name['Syntax'] = _SYNTAX
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+Type = _reflection.GeneratedProtocolMessageType('Type', (_message.Message,), {
+  'DESCRIPTOR' : _TYPE,
+  '__module__' : 'google.protobuf.type_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Type)
+  })
+_sym_db.RegisterMessage(Type)
+
+Field = _reflection.GeneratedProtocolMessageType('Field', (_message.Message,), {
+  'DESCRIPTOR' : _FIELD,
+  '__module__' : 'google.protobuf.type_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Field)
+  })
+_sym_db.RegisterMessage(Field)
+
+Enum = _reflection.GeneratedProtocolMessageType('Enum', (_message.Message,), {
+  'DESCRIPTOR' : _ENUM,
+  '__module__' : 'google.protobuf.type_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Enum)
+  })
+_sym_db.RegisterMessage(Enum)
+
+EnumValue = _reflection.GeneratedProtocolMessageType('EnumValue', (_message.Message,), {
+  'DESCRIPTOR' : _ENUMVALUE,
+  '__module__' : 'google.protobuf.type_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.EnumValue)
+  })
+_sym_db.RegisterMessage(EnumValue)
+
+Option = _reflection.GeneratedProtocolMessageType('Option', (_message.Message,), {
+  'DESCRIPTOR' : _OPTION,
+  '__module__' : 'google.protobuf.type_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Option)
+  })
+_sym_db.RegisterMessage(Option)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..72be1609f36e42f94ebf9c83459cb18d7ea6857f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_pb2.py
@@ -0,0 +1,983 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/util/json_format.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/util/json_format.proto',
+  package='protobuf_unittest',
+  syntax='proto2',
+  serialized_options=None,
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n&google/protobuf/util/json_format.proto\x12\x11protobuf_unittest\"\x89\x01\n\x13TestFlagsAndStrings\x12\t\n\x01\x41\x18\x01 \x02(\x05\x12K\n\rrepeatedgroup\x18\x02 \x03(\n24.protobuf_unittest.TestFlagsAndStrings.RepeatedGroup\x1a\x1a\n\rRepeatedGroup\x12\t\n\x01\x66\x18\x03 \x02(\t\"!\n\x14TestBase64ByteArrays\x12\t\n\x01\x61\x18\x01 \x02(\x0c\"G\n\x12TestJavaScriptJSON\x12\t\n\x01\x61\x18\x01 \x01(\x05\x12\r\n\x05\x66inal\x18\x02 \x01(\x02\x12\n\n\x02in\x18\x03 \x01(\t\x12\x0b\n\x03Var\x18\x04 \x01(\t\"Q\n\x18TestJavaScriptOrderJSON1\x12\t\n\x01\x64\x18\x01 \x01(\x05\x12\t\n\x01\x63\x18\x02 \x01(\x05\x12\t\n\x01x\x18\x03 \x01(\x08\x12\t\n\x01\x62\x18\x04 \x01(\x05\x12\t\n\x01\x61\x18\x05 \x01(\x05\"\x89\x01\n\x18TestJavaScriptOrderJSON2\x12\t\n\x01\x64\x18\x01 \x01(\x05\x12\t\n\x01\x63\x18\x02 \x01(\x05\x12\t\n\x01x\x18\x03 \x01(\x08\x12\t\n\x01\x62\x18\x04 \x01(\x05\x12\t\n\x01\x61\x18\x05 \x01(\x05\x12\x36\n\x01z\x18\x06 \x03(\x0b\x32+.protobuf_unittest.TestJavaScriptOrderJSON1\"$\n\x0cTestLargeInt\x12\t\n\x01\x61\x18\x01 \x02(\x03\x12\t\n\x01\x62\x18\x02 \x02(\x04\"\xa0\x01\n\x0bTestNumbers\x12\x30\n\x01\x61\x18\x01 \x01(\x0e\x32%.protobuf_unittest.TestNumbers.MyType\x12\t\n\x01\x62\x18\x02 \x01(\x05\x12\t\n\x01\x63\x18\x03 \x01(\x02\x12\t\n\x01\x64\x18\x04 \x01(\x08\x12\t\n\x01\x65\x18\x05 \x01(\x01\x12\t\n\x01\x66\x18\x06 \x01(\r\"(\n\x06MyType\x12\x06\n\x02OK\x10\x00\x12\x0b\n\x07WARNING\x10\x01\x12\t\n\x05\x45RROR\x10\x02\"T\n\rTestCamelCase\x12\x14\n\x0cnormal_field\x18\x01 \x01(\t\x12\x15\n\rCAPITAL_FIELD\x18\x02 \x01(\x05\x12\x16\n\x0e\x43\x61melCaseField\x18\x03 \x01(\x05\"|\n\x0bTestBoolMap\x12=\n\x08\x62ool_map\x18\x01 \x03(\x0b\x32+.protobuf_unittest.TestBoolMap.BoolMapEntry\x1a.\n\x0c\x42oolMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x08\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\"O\n\rTestRecursion\x12\r\n\x05value\x18\x01 \x01(\x05\x12/\n\x05\x63hild\x18\x02 \x01(\x0b\x32 .protobuf_unittest.TestRecursion\"\x86\x01\n\rTestStringMap\x12\x43\n\nstring_map\x18\x01 \x03(\x0b\x32/.protobuf_unittest.TestStringMap.StringMapEntry\x1a\x30\n\x0eStringMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xc4\x01\n\x14TestStringSerializer\x12\x15\n\rscalar_string\x18\x01 \x01(\t\x12\x17\n\x0frepeated_string\x18\x02 \x03(\t\x12J\n\nstring_map\x18\x03 \x03(\x0b\x32\x36.protobuf_unittest.TestStringSerializer.StringMapEntry\x1a\x30\n\x0eStringMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"$\n\x18TestMessageWithExtension*\x08\x08\x64\x10\x80\x80\x80\x80\x02\"z\n\rTestExtension\x12\r\n\x05value\x18\x01 \x01(\t2Z\n\x03\x65xt\x12+.protobuf_unittest.TestMessageWithExtension\x18\x64 \x01(\x0b\x32 .protobuf_unittest.TestExtension'
+)
+
+
+
+_TESTNUMBERS_MYTYPE = _descriptor.EnumDescriptor(
+  name='MyType',
+  full_name='protobuf_unittest.TestNumbers.MyType',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='OK', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='WARNING', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='ERROR', index=2, number=2,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=691,
+  serialized_end=731,
+)
+_sym_db.RegisterEnumDescriptor(_TESTNUMBERS_MYTYPE)
+
+
+_TESTFLAGSANDSTRINGS_REPEATEDGROUP = _descriptor.Descriptor(
+  name='RepeatedGroup',
+  full_name='protobuf_unittest.TestFlagsAndStrings.RepeatedGroup',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='f', full_name='protobuf_unittest.TestFlagsAndStrings.RepeatedGroup.f', index=0,
+      number=3, type=9, cpp_type=9, label=2,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=173,
+  serialized_end=199,
+)
+
+_TESTFLAGSANDSTRINGS = _descriptor.Descriptor(
+  name='TestFlagsAndStrings',
+  full_name='protobuf_unittest.TestFlagsAndStrings',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='A', full_name='protobuf_unittest.TestFlagsAndStrings.A', index=0,
+      number=1, type=5, cpp_type=1, label=2,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeatedgroup', full_name='protobuf_unittest.TestFlagsAndStrings.repeatedgroup', index=1,
+      number=2, type=10, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTFLAGSANDSTRINGS_REPEATEDGROUP, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=62,
+  serialized_end=199,
+)
+
+
+_TESTBASE64BYTEARRAYS = _descriptor.Descriptor(
+  name='TestBase64ByteArrays',
+  full_name='protobuf_unittest.TestBase64ByteArrays',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestBase64ByteArrays.a', index=0,
+      number=1, type=12, cpp_type=9, label=2,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=201,
+  serialized_end=234,
+)
+
+
+_TESTJAVASCRIPTJSON = _descriptor.Descriptor(
+  name='TestJavaScriptJSON',
+  full_name='protobuf_unittest.TestJavaScriptJSON',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestJavaScriptJSON.a', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='final', full_name='protobuf_unittest.TestJavaScriptJSON.final', index=1,
+      number=2, type=2, cpp_type=6, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='in', full_name='protobuf_unittest.TestJavaScriptJSON.in', index=2,
+      number=3, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='Var', full_name='protobuf_unittest.TestJavaScriptJSON.Var', index=3,
+      number=4, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=236,
+  serialized_end=307,
+)
+
+
+_TESTJAVASCRIPTORDERJSON1 = _descriptor.Descriptor(
+  name='TestJavaScriptOrderJSON1',
+  full_name='protobuf_unittest.TestJavaScriptOrderJSON1',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='d', full_name='protobuf_unittest.TestJavaScriptOrderJSON1.d', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='c', full_name='protobuf_unittest.TestJavaScriptOrderJSON1.c', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='x', full_name='protobuf_unittest.TestJavaScriptOrderJSON1.x', index=2,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='b', full_name='protobuf_unittest.TestJavaScriptOrderJSON1.b', index=3,
+      number=4, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestJavaScriptOrderJSON1.a', index=4,
+      number=5, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=309,
+  serialized_end=390,
+)
+
+
+_TESTJAVASCRIPTORDERJSON2 = _descriptor.Descriptor(
+  name='TestJavaScriptOrderJSON2',
+  full_name='protobuf_unittest.TestJavaScriptOrderJSON2',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='d', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.d', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='c', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.c', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='x', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.x', index=2,
+      number=3, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='b', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.b', index=3,
+      number=4, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.a', index=4,
+      number=5, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='z', full_name='protobuf_unittest.TestJavaScriptOrderJSON2.z', index=5,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=393,
+  serialized_end=530,
+)
+
+
+_TESTLARGEINT = _descriptor.Descriptor(
+  name='TestLargeInt',
+  full_name='protobuf_unittest.TestLargeInt',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestLargeInt.a', index=0,
+      number=1, type=3, cpp_type=2, label=2,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='b', full_name='protobuf_unittest.TestLargeInt.b', index=1,
+      number=2, type=4, cpp_type=4, label=2,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=532,
+  serialized_end=568,
+)
+
+
+_TESTNUMBERS = _descriptor.Descriptor(
+  name='TestNumbers',
+  full_name='protobuf_unittest.TestNumbers',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='a', full_name='protobuf_unittest.TestNumbers.a', index=0,
+      number=1, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='b', full_name='protobuf_unittest.TestNumbers.b', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='c', full_name='protobuf_unittest.TestNumbers.c', index=2,
+      number=3, type=2, cpp_type=6, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='d', full_name='protobuf_unittest.TestNumbers.d', index=3,
+      number=4, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='e', full_name='protobuf_unittest.TestNumbers.e', index=4,
+      number=5, type=1, cpp_type=5, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='f', full_name='protobuf_unittest.TestNumbers.f', index=5,
+      number=6, type=13, cpp_type=3, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+    _TESTNUMBERS_MYTYPE,
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=571,
+  serialized_end=731,
+)
+
+
+_TESTCAMELCASE = _descriptor.Descriptor(
+  name='TestCamelCase',
+  full_name='protobuf_unittest.TestCamelCase',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='normal_field', full_name='protobuf_unittest.TestCamelCase.normal_field', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='CAPITAL_FIELD', full_name='protobuf_unittest.TestCamelCase.CAPITAL_FIELD', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='CamelCaseField', full_name='protobuf_unittest.TestCamelCase.CamelCaseField', index=2,
+      number=3, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=733,
+  serialized_end=817,
+)
+
+
+_TESTBOOLMAP_BOOLMAPENTRY = _descriptor.Descriptor(
+  name='BoolMapEntry',
+  full_name='protobuf_unittest.TestBoolMap.BoolMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='protobuf_unittest.TestBoolMap.BoolMapEntry.key', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='protobuf_unittest.TestBoolMap.BoolMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=897,
+  serialized_end=943,
+)
+
+_TESTBOOLMAP = _descriptor.Descriptor(
+  name='TestBoolMap',
+  full_name='protobuf_unittest.TestBoolMap',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_map', full_name='protobuf_unittest.TestBoolMap.bool_map', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTBOOLMAP_BOOLMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=819,
+  serialized_end=943,
+)
+
+
+_TESTRECURSION = _descriptor.Descriptor(
+  name='TestRecursion',
+  full_name='protobuf_unittest.TestRecursion',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='protobuf_unittest.TestRecursion.value', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='child', full_name='protobuf_unittest.TestRecursion.child', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=945,
+  serialized_end=1024,
+)
+
+
+_TESTSTRINGMAP_STRINGMAPENTRY = _descriptor.Descriptor(
+  name='StringMapEntry',
+  full_name='protobuf_unittest.TestStringMap.StringMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='protobuf_unittest.TestStringMap.StringMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='protobuf_unittest.TestStringMap.StringMapEntry.value', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1113,
+  serialized_end=1161,
+)
+
+_TESTSTRINGMAP = _descriptor.Descriptor(
+  name='TestStringMap',
+  full_name='protobuf_unittest.TestStringMap',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='string_map', full_name='protobuf_unittest.TestStringMap.string_map', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTSTRINGMAP_STRINGMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1027,
+  serialized_end=1161,
+)
+
+
+_TESTSTRINGSERIALIZER_STRINGMAPENTRY = _descriptor.Descriptor(
+  name='StringMapEntry',
+  full_name='protobuf_unittest.TestStringSerializer.StringMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='protobuf_unittest.TestStringSerializer.StringMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='protobuf_unittest.TestStringSerializer.StringMapEntry.value', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1113,
+  serialized_end=1161,
+)
+
+_TESTSTRINGSERIALIZER = _descriptor.Descriptor(
+  name='TestStringSerializer',
+  full_name='protobuf_unittest.TestStringSerializer',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='scalar_string', full_name='protobuf_unittest.TestStringSerializer.scalar_string', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_string', full_name='protobuf_unittest.TestStringSerializer.repeated_string', index=1,
+      number=2, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_map', full_name='protobuf_unittest.TestStringSerializer.string_map', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTSTRINGSERIALIZER_STRINGMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1164,
+  serialized_end=1360,
+)
+
+
+_TESTMESSAGEWITHEXTENSION = _descriptor.Descriptor(
+  name='TestMessageWithExtension',
+  full_name='protobuf_unittest.TestMessageWithExtension',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=True,
+  syntax='proto2',
+  extension_ranges=[(100, 536870912), ],
+  oneofs=[
+  ],
+  serialized_start=1362,
+  serialized_end=1398,
+)
+
+
+_TESTEXTENSION = _descriptor.Descriptor(
+  name='TestExtension',
+  full_name='protobuf_unittest.TestExtension',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='protobuf_unittest.TestExtension.value', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+    _descriptor.FieldDescriptor(
+      name='ext', full_name='protobuf_unittest.TestExtension.ext', index=0,
+      number=100, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=True, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto2',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1400,
+  serialized_end=1522,
+)
+
+_TESTFLAGSANDSTRINGS_REPEATEDGROUP.containing_type = _TESTFLAGSANDSTRINGS
+_TESTFLAGSANDSTRINGS.fields_by_name['repeatedgroup'].message_type = _TESTFLAGSANDSTRINGS_REPEATEDGROUP
+_TESTJAVASCRIPTORDERJSON2.fields_by_name['z'].message_type = _TESTJAVASCRIPTORDERJSON1
+_TESTNUMBERS.fields_by_name['a'].enum_type = _TESTNUMBERS_MYTYPE
+_TESTNUMBERS_MYTYPE.containing_type = _TESTNUMBERS
+_TESTBOOLMAP_BOOLMAPENTRY.containing_type = _TESTBOOLMAP
+_TESTBOOLMAP.fields_by_name['bool_map'].message_type = _TESTBOOLMAP_BOOLMAPENTRY
+_TESTRECURSION.fields_by_name['child'].message_type = _TESTRECURSION
+_TESTSTRINGMAP_STRINGMAPENTRY.containing_type = _TESTSTRINGMAP
+_TESTSTRINGMAP.fields_by_name['string_map'].message_type = _TESTSTRINGMAP_STRINGMAPENTRY
+_TESTSTRINGSERIALIZER_STRINGMAPENTRY.containing_type = _TESTSTRINGSERIALIZER
+_TESTSTRINGSERIALIZER.fields_by_name['string_map'].message_type = _TESTSTRINGSERIALIZER_STRINGMAPENTRY
+DESCRIPTOR.message_types_by_name['TestFlagsAndStrings'] = _TESTFLAGSANDSTRINGS
+DESCRIPTOR.message_types_by_name['TestBase64ByteArrays'] = _TESTBASE64BYTEARRAYS
+DESCRIPTOR.message_types_by_name['TestJavaScriptJSON'] = _TESTJAVASCRIPTJSON
+DESCRIPTOR.message_types_by_name['TestJavaScriptOrderJSON1'] = _TESTJAVASCRIPTORDERJSON1
+DESCRIPTOR.message_types_by_name['TestJavaScriptOrderJSON2'] = _TESTJAVASCRIPTORDERJSON2
+DESCRIPTOR.message_types_by_name['TestLargeInt'] = _TESTLARGEINT
+DESCRIPTOR.message_types_by_name['TestNumbers'] = _TESTNUMBERS
+DESCRIPTOR.message_types_by_name['TestCamelCase'] = _TESTCAMELCASE
+DESCRIPTOR.message_types_by_name['TestBoolMap'] = _TESTBOOLMAP
+DESCRIPTOR.message_types_by_name['TestRecursion'] = _TESTRECURSION
+DESCRIPTOR.message_types_by_name['TestStringMap'] = _TESTSTRINGMAP
+DESCRIPTOR.message_types_by_name['TestStringSerializer'] = _TESTSTRINGSERIALIZER
+DESCRIPTOR.message_types_by_name['TestMessageWithExtension'] = _TESTMESSAGEWITHEXTENSION
+DESCRIPTOR.message_types_by_name['TestExtension'] = _TESTEXTENSION
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+TestFlagsAndStrings = _reflection.GeneratedProtocolMessageType('TestFlagsAndStrings', (_message.Message,), {
+
+  'RepeatedGroup' : _reflection.GeneratedProtocolMessageType('RepeatedGroup', (_message.Message,), {
+    'DESCRIPTOR' : _TESTFLAGSANDSTRINGS_REPEATEDGROUP,
+    '__module__' : 'google.protobuf.util.json_format_pb2'
+    # @@protoc_insertion_point(class_scope:protobuf_unittest.TestFlagsAndStrings.RepeatedGroup)
+    })
+  ,
+  'DESCRIPTOR' : _TESTFLAGSANDSTRINGS,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestFlagsAndStrings)
+  })
+_sym_db.RegisterMessage(TestFlagsAndStrings)
+_sym_db.RegisterMessage(TestFlagsAndStrings.RepeatedGroup)
+
+TestBase64ByteArrays = _reflection.GeneratedProtocolMessageType('TestBase64ByteArrays', (_message.Message,), {
+  'DESCRIPTOR' : _TESTBASE64BYTEARRAYS,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestBase64ByteArrays)
+  })
+_sym_db.RegisterMessage(TestBase64ByteArrays)
+
+TestJavaScriptJSON = _reflection.GeneratedProtocolMessageType('TestJavaScriptJSON', (_message.Message,), {
+  'DESCRIPTOR' : _TESTJAVASCRIPTJSON,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestJavaScriptJSON)
+  })
+_sym_db.RegisterMessage(TestJavaScriptJSON)
+
+TestJavaScriptOrderJSON1 = _reflection.GeneratedProtocolMessageType('TestJavaScriptOrderJSON1', (_message.Message,), {
+  'DESCRIPTOR' : _TESTJAVASCRIPTORDERJSON1,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestJavaScriptOrderJSON1)
+  })
+_sym_db.RegisterMessage(TestJavaScriptOrderJSON1)
+
+TestJavaScriptOrderJSON2 = _reflection.GeneratedProtocolMessageType('TestJavaScriptOrderJSON2', (_message.Message,), {
+  'DESCRIPTOR' : _TESTJAVASCRIPTORDERJSON2,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestJavaScriptOrderJSON2)
+  })
+_sym_db.RegisterMessage(TestJavaScriptOrderJSON2)
+
+TestLargeInt = _reflection.GeneratedProtocolMessageType('TestLargeInt', (_message.Message,), {
+  'DESCRIPTOR' : _TESTLARGEINT,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestLargeInt)
+  })
+_sym_db.RegisterMessage(TestLargeInt)
+
+TestNumbers = _reflection.GeneratedProtocolMessageType('TestNumbers', (_message.Message,), {
+  'DESCRIPTOR' : _TESTNUMBERS,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestNumbers)
+  })
+_sym_db.RegisterMessage(TestNumbers)
+
+TestCamelCase = _reflection.GeneratedProtocolMessageType('TestCamelCase', (_message.Message,), {
+  'DESCRIPTOR' : _TESTCAMELCASE,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestCamelCase)
+  })
+_sym_db.RegisterMessage(TestCamelCase)
+
+TestBoolMap = _reflection.GeneratedProtocolMessageType('TestBoolMap', (_message.Message,), {
+
+  'BoolMapEntry' : _reflection.GeneratedProtocolMessageType('BoolMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTBOOLMAP_BOOLMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_pb2'
+    # @@protoc_insertion_point(class_scope:protobuf_unittest.TestBoolMap.BoolMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTBOOLMAP,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestBoolMap)
+  })
+_sym_db.RegisterMessage(TestBoolMap)
+_sym_db.RegisterMessage(TestBoolMap.BoolMapEntry)
+
+TestRecursion = _reflection.GeneratedProtocolMessageType('TestRecursion', (_message.Message,), {
+  'DESCRIPTOR' : _TESTRECURSION,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestRecursion)
+  })
+_sym_db.RegisterMessage(TestRecursion)
+
+TestStringMap = _reflection.GeneratedProtocolMessageType('TestStringMap', (_message.Message,), {
+
+  'StringMapEntry' : _reflection.GeneratedProtocolMessageType('StringMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTSTRINGMAP_STRINGMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_pb2'
+    # @@protoc_insertion_point(class_scope:protobuf_unittest.TestStringMap.StringMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTSTRINGMAP,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestStringMap)
+  })
+_sym_db.RegisterMessage(TestStringMap)
+_sym_db.RegisterMessage(TestStringMap.StringMapEntry)
+
+TestStringSerializer = _reflection.GeneratedProtocolMessageType('TestStringSerializer', (_message.Message,), {
+
+  'StringMapEntry' : _reflection.GeneratedProtocolMessageType('StringMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTSTRINGSERIALIZER_STRINGMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_pb2'
+    # @@protoc_insertion_point(class_scope:protobuf_unittest.TestStringSerializer.StringMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTSTRINGSERIALIZER,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestStringSerializer)
+  })
+_sym_db.RegisterMessage(TestStringSerializer)
+_sym_db.RegisterMessage(TestStringSerializer.StringMapEntry)
+
+TestMessageWithExtension = _reflection.GeneratedProtocolMessageType('TestMessageWithExtension', (_message.Message,), {
+  'DESCRIPTOR' : _TESTMESSAGEWITHEXTENSION,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestMessageWithExtension)
+  })
+_sym_db.RegisterMessage(TestMessageWithExtension)
+
+TestExtension = _reflection.GeneratedProtocolMessageType('TestExtension', (_message.Message,), {
+  'DESCRIPTOR' : _TESTEXTENSION,
+  '__module__' : 'google.protobuf.util.json_format_pb2'
+  # @@protoc_insertion_point(class_scope:protobuf_unittest.TestExtension)
+  })
+_sym_db.RegisterMessage(TestExtension)
+
+_TESTEXTENSION.extensions_by_name['ext'].message_type = _TESTEXTENSION
+TestMessageWithExtension.RegisterExtension(_TESTEXTENSION.extensions_by_name['ext'])
+
+_TESTBOOLMAP_BOOLMAPENTRY._options = None
+_TESTSTRINGMAP_STRINGMAPENTRY._options = None
+_TESTSTRINGSERIALIZER_STRINGMAPENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_proto3_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_proto3_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3d4e484cbd71fe32e0a056902b1ecd41bea55e9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/util/json_format_proto3_pb2.py
@@ -0,0 +1,2031 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/util/json_format_proto3.proto
+"""Generated protocol buffer code."""
+from google.protobuf.internal import enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from google.protobuf import duration_pb2 as google_dot_protobuf_dot_duration__pb2
+from google.protobuf import field_mask_pb2 as google_dot_protobuf_dot_field__mask__pb2
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+from google.protobuf import unittest_pb2 as google_dot_protobuf_dot_unittest__pb2
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/util/json_format_proto3.proto',
+  package='proto3',
+  syntax='proto3',
+  serialized_options=b'\n\030com.google.protobuf.utilB\020JsonFormatProto3',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n-google/protobuf/util/json_format_proto3.proto\x12\x06proto3\x1a\x19google/protobuf/any.proto\x1a\x1egoogle/protobuf/duration.proto\x1a google/protobuf/field_mask.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1egoogle/protobuf/unittest.proto\"\x1c\n\x0bMessageType\x12\r\n\x05value\x18\x01 \x01(\x05\"\x94\x05\n\x0bTestMessage\x12\x12\n\nbool_value\x18\x01 \x01(\x08\x12\x13\n\x0bint32_value\x18\x02 \x01(\x05\x12\x13\n\x0bint64_value\x18\x03 \x01(\x03\x12\x14\n\x0cuint32_value\x18\x04 \x01(\r\x12\x14\n\x0cuint64_value\x18\x05 \x01(\x04\x12\x13\n\x0b\x66loat_value\x18\x06 \x01(\x02\x12\x14\n\x0c\x64ouble_value\x18\x07 \x01(\x01\x12\x14\n\x0cstring_value\x18\x08 \x01(\t\x12\x13\n\x0b\x62ytes_value\x18\t \x01(\x0c\x12$\n\nenum_value\x18\n \x01(\x0e\x32\x10.proto3.EnumType\x12*\n\rmessage_value\x18\x0b \x01(\x0b\x32\x13.proto3.MessageType\x12\x1b\n\x13repeated_bool_value\x18\x15 \x03(\x08\x12\x1c\n\x14repeated_int32_value\x18\x16 \x03(\x05\x12\x1c\n\x14repeated_int64_value\x18\x17 \x03(\x03\x12\x1d\n\x15repeated_uint32_value\x18\x18 \x03(\r\x12\x1d\n\x15repeated_uint64_value\x18\x19 \x03(\x04\x12\x1c\n\x14repeated_float_value\x18\x1a \x03(\x02\x12\x1d\n\x15repeated_double_value\x18\x1b \x03(\x01\x12\x1d\n\x15repeated_string_value\x18\x1c \x03(\t\x12\x1c\n\x14repeated_bytes_value\x18\x1d \x03(\x0c\x12-\n\x13repeated_enum_value\x18\x1e \x03(\x0e\x32\x10.proto3.EnumType\x12\x33\n\x16repeated_message_value\x18\x1f \x03(\x0b\x32\x13.proto3.MessageType\"\x8c\x02\n\tTestOneof\x12\x1b\n\x11oneof_int32_value\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12oneof_string_value\x18\x02 \x01(\tH\x00\x12\x1b\n\x11oneof_bytes_value\x18\x03 \x01(\x0cH\x00\x12,\n\x10oneof_enum_value\x18\x04 \x01(\x0e\x32\x10.proto3.EnumTypeH\x00\x12\x32\n\x13oneof_message_value\x18\x05 \x01(\x0b\x32\x13.proto3.MessageTypeH\x00\x12\x36\n\x10oneof_null_value\x18\x06 \x01(\x0e\x32\x1a.google.protobuf.NullValueH\x00\x42\r\n\x0boneof_value\"\xe1\x04\n\x07TestMap\x12.\n\x08\x62ool_map\x18\x01 \x03(\x0b\x32\x1c.proto3.TestMap.BoolMapEntry\x12\x30\n\tint32_map\x18\x02 \x03(\x0b\x32\x1d.proto3.TestMap.Int32MapEntry\x12\x30\n\tint64_map\x18\x03 \x03(\x0b\x32\x1d.proto3.TestMap.Int64MapEntry\x12\x32\n\nuint32_map\x18\x04 \x03(\x0b\x32\x1e.proto3.TestMap.Uint32MapEntry\x12\x32\n\nuint64_map\x18\x05 \x03(\x0b\x32\x1e.proto3.TestMap.Uint64MapEntry\x12\x32\n\nstring_map\x18\x06 \x03(\x0b\x32\x1e.proto3.TestMap.StringMapEntry\x1a.\n\x0c\x42oolMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x08\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a/\n\rInt32MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x05\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a/\n\rInt64MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x03\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eUint32MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\r\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eUint64MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eStringMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\"\x85\x06\n\rTestNestedMap\x12\x34\n\x08\x62ool_map\x18\x01 \x03(\x0b\x32\".proto3.TestNestedMap.BoolMapEntry\x12\x36\n\tint32_map\x18\x02 \x03(\x0b\x32#.proto3.TestNestedMap.Int32MapEntry\x12\x36\n\tint64_map\x18\x03 \x03(\x0b\x32#.proto3.TestNestedMap.Int64MapEntry\x12\x38\n\nuint32_map\x18\x04 \x03(\x0b\x32$.proto3.TestNestedMap.Uint32MapEntry\x12\x38\n\nuint64_map\x18\x05 \x03(\x0b\x32$.proto3.TestNestedMap.Uint64MapEntry\x12\x38\n\nstring_map\x18\x06 \x03(\x0b\x32$.proto3.TestNestedMap.StringMapEntry\x12\x32\n\x07map_map\x18\x07 \x03(\x0b\x32!.proto3.TestNestedMap.MapMapEntry\x1a.\n\x0c\x42oolMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x08\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a/\n\rInt32MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x05\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a/\n\rInt64MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x03\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eUint32MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\r\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eUint64MapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x30\n\x0eStringMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\x1a\x44\n\x0bMapMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12$\n\x05value\x18\x02 \x01(\x0b\x32\x15.proto3.TestNestedMap:\x02\x38\x01\"{\n\rTestStringMap\x12\x38\n\nstring_map\x18\x01 \x03(\x0b\x32$.proto3.TestStringMap.StringMapEntry\x1a\x30\n\x0eStringMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xee\x07\n\x0bTestWrapper\x12.\n\nbool_value\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x30\n\x0bint32_value\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int32Value\x12\x30\n\x0bint64_value\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x32\n\x0cuint32_value\x18\x04 \x01(\x0b\x32\x1c.google.protobuf.UInt32Value\x12\x32\n\x0cuint64_value\x18\x05 \x01(\x0b\x32\x1c.google.protobuf.UInt64Value\x12\x30\n\x0b\x66loat_value\x18\x06 \x01(\x0b\x32\x1b.google.protobuf.FloatValue\x12\x32\n\x0c\x64ouble_value\x18\x07 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12\x32\n\x0cstring_value\x18\x08 \x01(\x0b\x32\x1c.google.protobuf.StringValue\x12\x30\n\x0b\x62ytes_value\x18\t \x01(\x0b\x32\x1b.google.protobuf.BytesValue\x12\x37\n\x13repeated_bool_value\x18\x0b \x03(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x39\n\x14repeated_int32_value\x18\x0c \x03(\x0b\x32\x1b.google.protobuf.Int32Value\x12\x39\n\x14repeated_int64_value\x18\r \x03(\x0b\x32\x1b.google.protobuf.Int64Value\x12;\n\x15repeated_uint32_value\x18\x0e \x03(\x0b\x32\x1c.google.protobuf.UInt32Value\x12;\n\x15repeated_uint64_value\x18\x0f \x03(\x0b\x32\x1c.google.protobuf.UInt64Value\x12\x39\n\x14repeated_float_value\x18\x10 \x03(\x0b\x32\x1b.google.protobuf.FloatValue\x12;\n\x15repeated_double_value\x18\x11 \x03(\x0b\x32\x1c.google.protobuf.DoubleValue\x12;\n\x15repeated_string_value\x18\x12 \x03(\x0b\x32\x1c.google.protobuf.StringValue\x12\x39\n\x14repeated_bytes_value\x18\x13 \x03(\x0b\x32\x1b.google.protobuf.BytesValue\"n\n\rTestTimestamp\x12)\n\x05value\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x32\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.Timestamp\"k\n\x0cTestDuration\x12(\n\x05value\x18\x01 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x31\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x19.google.protobuf.Duration\":\n\rTestFieldMask\x12)\n\x05value\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.FieldMask\"e\n\nTestStruct\x12&\n\x05value\x18\x01 \x01(\x0b\x32\x17.google.protobuf.Struct\x12/\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x17.google.protobuf.Struct\"\\\n\x07TestAny\x12#\n\x05value\x18\x01 \x01(\x0b\x32\x14.google.protobuf.Any\x12,\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x14.google.protobuf.Any\"b\n\tTestValue\x12%\n\x05value\x18\x01 \x01(\x0b\x32\x16.google.protobuf.Value\x12.\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x16.google.protobuf.Value\"n\n\rTestListValue\x12)\n\x05value\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.ListValue\x12\x32\n\x0erepeated_value\x18\x02 \x03(\x0b\x32\x1a.google.protobuf.ListValue\"\x89\x01\n\rTestBoolValue\x12\x12\n\nbool_value\x18\x01 \x01(\x08\x12\x34\n\x08\x62ool_map\x18\x02 \x03(\x0b\x32\".proto3.TestBoolValue.BoolMapEntry\x1a.\n\x0c\x42oolMapEntry\x12\x0b\n\x03key\x18\x01 \x01(\x08\x12\r\n\x05value\x18\x02 \x01(\x05:\x02\x38\x01\"+\n\x12TestCustomJsonName\x12\x15\n\x05value\x18\x01 \x01(\x05R\x06@value\"J\n\x0eTestExtensions\x12\x38\n\nextensions\x18\x01 \x01(\x0b\x32$.protobuf_unittest.TestAllExtensions\"\x84\x01\n\rTestEnumValue\x12%\n\x0b\x65num_value1\x18\x01 \x01(\x0e\x32\x10.proto3.EnumType\x12%\n\x0b\x65num_value2\x18\x02 \x01(\x0e\x32\x10.proto3.EnumType\x12%\n\x0b\x65num_value3\x18\x03 \x01(\x0e\x32\x10.proto3.EnumType*\x1c\n\x08\x45numType\x12\x07\n\x03\x46OO\x10\x00\x12\x07\n\x03\x42\x41R\x10\x01\x42,\n\x18\x63om.google.protobuf.utilB\x10JsonFormatProto3b\x06proto3'
+  ,
+  dependencies=[google_dot_protobuf_dot_any__pb2.DESCRIPTOR,google_dot_protobuf_dot_duration__pb2.DESCRIPTOR,google_dot_protobuf_dot_field__mask__pb2.DESCRIPTOR,google_dot_protobuf_dot_struct__pb2.DESCRIPTOR,google_dot_protobuf_dot_timestamp__pb2.DESCRIPTOR,google_dot_protobuf_dot_wrappers__pb2.DESCRIPTOR,google_dot_protobuf_dot_unittest__pb2.DESCRIPTOR,])
+
+_ENUMTYPE = _descriptor.EnumDescriptor(
+  name='EnumType',
+  full_name='proto3.EnumType',
+  filename=None,
+  file=DESCRIPTOR,
+  create_key=_descriptor._internal_create_key,
+  values=[
+    _descriptor.EnumValueDescriptor(
+      name='FOO', index=0, number=0,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+    _descriptor.EnumValueDescriptor(
+      name='BAR', index=1, number=1,
+      serialized_options=None,
+      type=None,
+      create_key=_descriptor._internal_create_key),
+  ],
+  containing_type=None,
+  serialized_options=None,
+  serialized_start=4849,
+  serialized_end=4877,
+)
+_sym_db.RegisterEnumDescriptor(_ENUMTYPE)
+
+EnumType = enum_type_wrapper.EnumTypeWrapper(_ENUMTYPE)
+FOO = 0
+BAR = 1
+
+
+
+_MESSAGETYPE = _descriptor.Descriptor(
+  name='MessageType',
+  full_name='proto3.MessageType',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.MessageType.value', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=277,
+  serialized_end=305,
+)
+
+
+_TESTMESSAGE = _descriptor.Descriptor(
+  name='TestMessage',
+  full_name='proto3.TestMessage',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_value', full_name='proto3.TestMessage.bool_value', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int32_value', full_name='proto3.TestMessage.int32_value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int64_value', full_name='proto3.TestMessage.int64_value', index=2,
+      number=3, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint32_value', full_name='proto3.TestMessage.uint32_value', index=3,
+      number=4, type=13, cpp_type=3, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint64_value', full_name='proto3.TestMessage.uint64_value', index=4,
+      number=5, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='float_value', full_name='proto3.TestMessage.float_value', index=5,
+      number=6, type=2, cpp_type=6, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='double_value', full_name='proto3.TestMessage.double_value', index=6,
+      number=7, type=1, cpp_type=5, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_value', full_name='proto3.TestMessage.string_value', index=7,
+      number=8, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='bytes_value', full_name='proto3.TestMessage.bytes_value', index=8,
+      number=9, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enum_value', full_name='proto3.TestMessage.enum_value', index=9,
+      number=10, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='message_value', full_name='proto3.TestMessage.message_value', index=10,
+      number=11, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_bool_value', full_name='proto3.TestMessage.repeated_bool_value', index=11,
+      number=21, type=8, cpp_type=7, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_int32_value', full_name='proto3.TestMessage.repeated_int32_value', index=12,
+      number=22, type=5, cpp_type=1, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_int64_value', full_name='proto3.TestMessage.repeated_int64_value', index=13,
+      number=23, type=3, cpp_type=2, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_uint32_value', full_name='proto3.TestMessage.repeated_uint32_value', index=14,
+      number=24, type=13, cpp_type=3, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_uint64_value', full_name='proto3.TestMessage.repeated_uint64_value', index=15,
+      number=25, type=4, cpp_type=4, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_float_value', full_name='proto3.TestMessage.repeated_float_value', index=16,
+      number=26, type=2, cpp_type=6, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_double_value', full_name='proto3.TestMessage.repeated_double_value', index=17,
+      number=27, type=1, cpp_type=5, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_string_value', full_name='proto3.TestMessage.repeated_string_value', index=18,
+      number=28, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_bytes_value', full_name='proto3.TestMessage.repeated_bytes_value', index=19,
+      number=29, type=12, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_enum_value', full_name='proto3.TestMessage.repeated_enum_value', index=20,
+      number=30, type=14, cpp_type=8, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_message_value', full_name='proto3.TestMessage.repeated_message_value', index=21,
+      number=31, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=308,
+  serialized_end=968,
+)
+
+
+_TESTONEOF = _descriptor.Descriptor(
+  name='TestOneof',
+  full_name='proto3.TestOneof',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='oneof_int32_value', full_name='proto3.TestOneof.oneof_int32_value', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_string_value', full_name='proto3.TestOneof.oneof_string_value', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_bytes_value', full_name='proto3.TestOneof.oneof_bytes_value', index=2,
+      number=3, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_enum_value', full_name='proto3.TestOneof.oneof_enum_value', index=3,
+      number=4, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_message_value', full_name='proto3.TestOneof.oneof_message_value', index=4,
+      number=5, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='oneof_null_value', full_name='proto3.TestOneof.oneof_null_value', index=5,
+      number=6, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+    _descriptor.OneofDescriptor(
+      name='oneof_value', full_name='proto3.TestOneof.oneof_value',
+      index=0, containing_type=None,
+      create_key=_descriptor._internal_create_key,
+    fields=[]),
+  ],
+  serialized_start=971,
+  serialized_end=1239,
+)
+
+
+_TESTMAP_BOOLMAPENTRY = _descriptor.Descriptor(
+  name='BoolMapEntry',
+  full_name='proto3.TestMap.BoolMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.BoolMapEntry.key', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.BoolMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1557,
+  serialized_end=1603,
+)
+
+_TESTMAP_INT32MAPENTRY = _descriptor.Descriptor(
+  name='Int32MapEntry',
+  full_name='proto3.TestMap.Int32MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.Int32MapEntry.key', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.Int32MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1605,
+  serialized_end=1652,
+)
+
+_TESTMAP_INT64MAPENTRY = _descriptor.Descriptor(
+  name='Int64MapEntry',
+  full_name='proto3.TestMap.Int64MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.Int64MapEntry.key', index=0,
+      number=1, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.Int64MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1654,
+  serialized_end=1701,
+)
+
+_TESTMAP_UINT32MAPENTRY = _descriptor.Descriptor(
+  name='Uint32MapEntry',
+  full_name='proto3.TestMap.Uint32MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.Uint32MapEntry.key', index=0,
+      number=1, type=13, cpp_type=3, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.Uint32MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1703,
+  serialized_end=1751,
+)
+
+_TESTMAP_UINT64MAPENTRY = _descriptor.Descriptor(
+  name='Uint64MapEntry',
+  full_name='proto3.TestMap.Uint64MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.Uint64MapEntry.key', index=0,
+      number=1, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.Uint64MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1753,
+  serialized_end=1801,
+)
+
+_TESTMAP_STRINGMAPENTRY = _descriptor.Descriptor(
+  name='StringMapEntry',
+  full_name='proto3.TestMap.StringMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestMap.StringMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestMap.StringMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1803,
+  serialized_end=1851,
+)
+
+_TESTMAP = _descriptor.Descriptor(
+  name='TestMap',
+  full_name='proto3.TestMap',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_map', full_name='proto3.TestMap.bool_map', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int32_map', full_name='proto3.TestMap.int32_map', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int64_map', full_name='proto3.TestMap.int64_map', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint32_map', full_name='proto3.TestMap.uint32_map', index=3,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint64_map', full_name='proto3.TestMap.uint64_map', index=4,
+      number=5, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_map', full_name='proto3.TestMap.string_map', index=5,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTMAP_BOOLMAPENTRY, _TESTMAP_INT32MAPENTRY, _TESTMAP_INT64MAPENTRY, _TESTMAP_UINT32MAPENTRY, _TESTMAP_UINT64MAPENTRY, _TESTMAP_STRINGMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1242,
+  serialized_end=1851,
+)
+
+
+_TESTNESTEDMAP_BOOLMAPENTRY = _descriptor.Descriptor(
+  name='BoolMapEntry',
+  full_name='proto3.TestNestedMap.BoolMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.BoolMapEntry.key', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.BoolMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1557,
+  serialized_end=1603,
+)
+
+_TESTNESTEDMAP_INT32MAPENTRY = _descriptor.Descriptor(
+  name='Int32MapEntry',
+  full_name='proto3.TestNestedMap.Int32MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.Int32MapEntry.key', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.Int32MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1605,
+  serialized_end=1652,
+)
+
+_TESTNESTEDMAP_INT64MAPENTRY = _descriptor.Descriptor(
+  name='Int64MapEntry',
+  full_name='proto3.TestNestedMap.Int64MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.Int64MapEntry.key', index=0,
+      number=1, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.Int64MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1654,
+  serialized_end=1701,
+)
+
+_TESTNESTEDMAP_UINT32MAPENTRY = _descriptor.Descriptor(
+  name='Uint32MapEntry',
+  full_name='proto3.TestNestedMap.Uint32MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.Uint32MapEntry.key', index=0,
+      number=1, type=13, cpp_type=3, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.Uint32MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1703,
+  serialized_end=1751,
+)
+
+_TESTNESTEDMAP_UINT64MAPENTRY = _descriptor.Descriptor(
+  name='Uint64MapEntry',
+  full_name='proto3.TestNestedMap.Uint64MapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.Uint64MapEntry.key', index=0,
+      number=1, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.Uint64MapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1753,
+  serialized_end=1801,
+)
+
+_TESTNESTEDMAP_STRINGMAPENTRY = _descriptor.Descriptor(
+  name='StringMapEntry',
+  full_name='proto3.TestNestedMap.StringMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.StringMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.StringMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1803,
+  serialized_end=1851,
+)
+
+_TESTNESTEDMAP_MAPMAPENTRY = _descriptor.Descriptor(
+  name='MapMapEntry',
+  full_name='proto3.TestNestedMap.MapMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestNestedMap.MapMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestNestedMap.MapMapEntry.value', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2559,
+  serialized_end=2627,
+)
+
+_TESTNESTEDMAP = _descriptor.Descriptor(
+  name='TestNestedMap',
+  full_name='proto3.TestNestedMap',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_map', full_name='proto3.TestNestedMap.bool_map', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int32_map', full_name='proto3.TestNestedMap.int32_map', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int64_map', full_name='proto3.TestNestedMap.int64_map', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint32_map', full_name='proto3.TestNestedMap.uint32_map', index=3,
+      number=4, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint64_map', full_name='proto3.TestNestedMap.uint64_map', index=4,
+      number=5, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_map', full_name='proto3.TestNestedMap.string_map', index=5,
+      number=6, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='map_map', full_name='proto3.TestNestedMap.map_map', index=6,
+      number=7, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTNESTEDMAP_BOOLMAPENTRY, _TESTNESTEDMAP_INT32MAPENTRY, _TESTNESTEDMAP_INT64MAPENTRY, _TESTNESTEDMAP_UINT32MAPENTRY, _TESTNESTEDMAP_UINT64MAPENTRY, _TESTNESTEDMAP_STRINGMAPENTRY, _TESTNESTEDMAP_MAPMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1854,
+  serialized_end=2627,
+)
+
+
+_TESTSTRINGMAP_STRINGMAPENTRY = _descriptor.Descriptor(
+  name='StringMapEntry',
+  full_name='proto3.TestStringMap.StringMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestStringMap.StringMapEntry.key', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestStringMap.StringMapEntry.value', index=1,
+      number=2, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2704,
+  serialized_end=2752,
+)
+
+_TESTSTRINGMAP = _descriptor.Descriptor(
+  name='TestStringMap',
+  full_name='proto3.TestStringMap',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='string_map', full_name='proto3.TestStringMap.string_map', index=0,
+      number=1, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTSTRINGMAP_STRINGMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2629,
+  serialized_end=2752,
+)
+
+
+_TESTWRAPPER = _descriptor.Descriptor(
+  name='TestWrapper',
+  full_name='proto3.TestWrapper',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_value', full_name='proto3.TestWrapper.bool_value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int32_value', full_name='proto3.TestWrapper.int32_value', index=1,
+      number=2, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='int64_value', full_name='proto3.TestWrapper.int64_value', index=2,
+      number=3, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint32_value', full_name='proto3.TestWrapper.uint32_value', index=3,
+      number=4, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='uint64_value', full_name='proto3.TestWrapper.uint64_value', index=4,
+      number=5, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='float_value', full_name='proto3.TestWrapper.float_value', index=5,
+      number=6, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='double_value', full_name='proto3.TestWrapper.double_value', index=6,
+      number=7, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='string_value', full_name='proto3.TestWrapper.string_value', index=7,
+      number=8, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='bytes_value', full_name='proto3.TestWrapper.bytes_value', index=8,
+      number=9, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_bool_value', full_name='proto3.TestWrapper.repeated_bool_value', index=9,
+      number=11, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_int32_value', full_name='proto3.TestWrapper.repeated_int32_value', index=10,
+      number=12, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_int64_value', full_name='proto3.TestWrapper.repeated_int64_value', index=11,
+      number=13, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_uint32_value', full_name='proto3.TestWrapper.repeated_uint32_value', index=12,
+      number=14, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_uint64_value', full_name='proto3.TestWrapper.repeated_uint64_value', index=13,
+      number=15, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_float_value', full_name='proto3.TestWrapper.repeated_float_value', index=14,
+      number=16, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_double_value', full_name='proto3.TestWrapper.repeated_double_value', index=15,
+      number=17, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_string_value', full_name='proto3.TestWrapper.repeated_string_value', index=16,
+      number=18, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_bytes_value', full_name='proto3.TestWrapper.repeated_bytes_value', index=17,
+      number=19, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=2755,
+  serialized_end=3761,
+)
+
+
+_TESTTIMESTAMP = _descriptor.Descriptor(
+  name='TestTimestamp',
+  full_name='proto3.TestTimestamp',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestTimestamp.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestTimestamp.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=3763,
+  serialized_end=3873,
+)
+
+
+_TESTDURATION = _descriptor.Descriptor(
+  name='TestDuration',
+  full_name='proto3.TestDuration',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestDuration.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestDuration.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=3875,
+  serialized_end=3982,
+)
+
+
+_TESTFIELDMASK = _descriptor.Descriptor(
+  name='TestFieldMask',
+  full_name='proto3.TestFieldMask',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestFieldMask.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=3984,
+  serialized_end=4042,
+)
+
+
+_TESTSTRUCT = _descriptor.Descriptor(
+  name='TestStruct',
+  full_name='proto3.TestStruct',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestStruct.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestStruct.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4044,
+  serialized_end=4145,
+)
+
+
+_TESTANY = _descriptor.Descriptor(
+  name='TestAny',
+  full_name='proto3.TestAny',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestAny.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestAny.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4147,
+  serialized_end=4239,
+)
+
+
+_TESTVALUE = _descriptor.Descriptor(
+  name='TestValue',
+  full_name='proto3.TestValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestValue.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestValue.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4241,
+  serialized_end=4339,
+)
+
+
+_TESTLISTVALUE = _descriptor.Descriptor(
+  name='TestListValue',
+  full_name='proto3.TestListValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestListValue.value', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='repeated_value', full_name='proto3.TestListValue.repeated_value', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4341,
+  serialized_end=4451,
+)
+
+
+_TESTBOOLVALUE_BOOLMAPENTRY = _descriptor.Descriptor(
+  name='BoolMapEntry',
+  full_name='proto3.TestBoolValue.BoolMapEntry',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='key', full_name='proto3.TestBoolValue.BoolMapEntry.key', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestBoolValue.BoolMapEntry.value', index=1,
+      number=2, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=b'8\001',
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=1557,
+  serialized_end=1603,
+)
+
+_TESTBOOLVALUE = _descriptor.Descriptor(
+  name='TestBoolValue',
+  full_name='proto3.TestBoolValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='bool_value', full_name='proto3.TestBoolValue.bool_value', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='bool_map', full_name='proto3.TestBoolValue.bool_map', index=1,
+      number=2, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[_TESTBOOLVALUE_BOOLMAPENTRY, ],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4454,
+  serialized_end=4591,
+)
+
+
+_TESTCUSTOMJSONNAME = _descriptor.Descriptor(
+  name='TestCustomJsonName',
+  full_name='proto3.TestCustomJsonName',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='proto3.TestCustomJsonName.value', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, json_name='@value', file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4593,
+  serialized_end=4636,
+)
+
+
+_TESTEXTENSIONS = _descriptor.Descriptor(
+  name='TestExtensions',
+  full_name='proto3.TestExtensions',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='extensions', full_name='proto3.TestExtensions.extensions', index=0,
+      number=1, type=11, cpp_type=10, label=1,
+      has_default_value=False, default_value=None,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4638,
+  serialized_end=4712,
+)
+
+
+_TESTENUMVALUE = _descriptor.Descriptor(
+  name='TestEnumValue',
+  full_name='proto3.TestEnumValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='enum_value1', full_name='proto3.TestEnumValue.enum_value1', index=0,
+      number=1, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enum_value2', full_name='proto3.TestEnumValue.enum_value2', index=1,
+      number=2, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+    _descriptor.FieldDescriptor(
+      name='enum_value3', full_name='proto3.TestEnumValue.enum_value3', index=2,
+      number=3, type=14, cpp_type=8, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=4715,
+  serialized_end=4847,
+)
+
+_TESTMESSAGE.fields_by_name['enum_value'].enum_type = _ENUMTYPE
+_TESTMESSAGE.fields_by_name['message_value'].message_type = _MESSAGETYPE
+_TESTMESSAGE.fields_by_name['repeated_enum_value'].enum_type = _ENUMTYPE
+_TESTMESSAGE.fields_by_name['repeated_message_value'].message_type = _MESSAGETYPE
+_TESTONEOF.fields_by_name['oneof_enum_value'].enum_type = _ENUMTYPE
+_TESTONEOF.fields_by_name['oneof_message_value'].message_type = _MESSAGETYPE
+_TESTONEOF.fields_by_name['oneof_null_value'].enum_type = google_dot_protobuf_dot_struct__pb2._NULLVALUE
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_int32_value'])
+_TESTONEOF.fields_by_name['oneof_int32_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_string_value'])
+_TESTONEOF.fields_by_name['oneof_string_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_bytes_value'])
+_TESTONEOF.fields_by_name['oneof_bytes_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_enum_value'])
+_TESTONEOF.fields_by_name['oneof_enum_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_message_value'])
+_TESTONEOF.fields_by_name['oneof_message_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTONEOF.oneofs_by_name['oneof_value'].fields.append(
+  _TESTONEOF.fields_by_name['oneof_null_value'])
+_TESTONEOF.fields_by_name['oneof_null_value'].containing_oneof = _TESTONEOF.oneofs_by_name['oneof_value']
+_TESTMAP_BOOLMAPENTRY.containing_type = _TESTMAP
+_TESTMAP_INT32MAPENTRY.containing_type = _TESTMAP
+_TESTMAP_INT64MAPENTRY.containing_type = _TESTMAP
+_TESTMAP_UINT32MAPENTRY.containing_type = _TESTMAP
+_TESTMAP_UINT64MAPENTRY.containing_type = _TESTMAP
+_TESTMAP_STRINGMAPENTRY.containing_type = _TESTMAP
+_TESTMAP.fields_by_name['bool_map'].message_type = _TESTMAP_BOOLMAPENTRY
+_TESTMAP.fields_by_name['int32_map'].message_type = _TESTMAP_INT32MAPENTRY
+_TESTMAP.fields_by_name['int64_map'].message_type = _TESTMAP_INT64MAPENTRY
+_TESTMAP.fields_by_name['uint32_map'].message_type = _TESTMAP_UINT32MAPENTRY
+_TESTMAP.fields_by_name['uint64_map'].message_type = _TESTMAP_UINT64MAPENTRY
+_TESTMAP.fields_by_name['string_map'].message_type = _TESTMAP_STRINGMAPENTRY
+_TESTNESTEDMAP_BOOLMAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_INT32MAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_INT64MAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_UINT32MAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_UINT64MAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_STRINGMAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_MAPMAPENTRY.fields_by_name['value'].message_type = _TESTNESTEDMAP
+_TESTNESTEDMAP_MAPMAPENTRY.containing_type = _TESTNESTEDMAP
+_TESTNESTEDMAP.fields_by_name['bool_map'].message_type = _TESTNESTEDMAP_BOOLMAPENTRY
+_TESTNESTEDMAP.fields_by_name['int32_map'].message_type = _TESTNESTEDMAP_INT32MAPENTRY
+_TESTNESTEDMAP.fields_by_name['int64_map'].message_type = _TESTNESTEDMAP_INT64MAPENTRY
+_TESTNESTEDMAP.fields_by_name['uint32_map'].message_type = _TESTNESTEDMAP_UINT32MAPENTRY
+_TESTNESTEDMAP.fields_by_name['uint64_map'].message_type = _TESTNESTEDMAP_UINT64MAPENTRY
+_TESTNESTEDMAP.fields_by_name['string_map'].message_type = _TESTNESTEDMAP_STRINGMAPENTRY
+_TESTNESTEDMAP.fields_by_name['map_map'].message_type = _TESTNESTEDMAP_MAPMAPENTRY
+_TESTSTRINGMAP_STRINGMAPENTRY.containing_type = _TESTSTRINGMAP
+_TESTSTRINGMAP.fields_by_name['string_map'].message_type = _TESTSTRINGMAP_STRINGMAPENTRY
+_TESTWRAPPER.fields_by_name['bool_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_TESTWRAPPER.fields_by_name['int32_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_TESTWRAPPER.fields_by_name['int64_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_TESTWRAPPER.fields_by_name['uint32_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._UINT32VALUE
+_TESTWRAPPER.fields_by_name['uint64_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._UINT64VALUE
+_TESTWRAPPER.fields_by_name['float_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._FLOATVALUE
+_TESTWRAPPER.fields_by_name['double_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_TESTWRAPPER.fields_by_name['string_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
+_TESTWRAPPER.fields_by_name['bytes_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._BYTESVALUE
+_TESTWRAPPER.fields_by_name['repeated_bool_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._BOOLVALUE
+_TESTWRAPPER.fields_by_name['repeated_int32_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._INT32VALUE
+_TESTWRAPPER.fields_by_name['repeated_int64_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._INT64VALUE
+_TESTWRAPPER.fields_by_name['repeated_uint32_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._UINT32VALUE
+_TESTWRAPPER.fields_by_name['repeated_uint64_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._UINT64VALUE
+_TESTWRAPPER.fields_by_name['repeated_float_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._FLOATVALUE
+_TESTWRAPPER.fields_by_name['repeated_double_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._DOUBLEVALUE
+_TESTWRAPPER.fields_by_name['repeated_string_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._STRINGVALUE
+_TESTWRAPPER.fields_by_name['repeated_bytes_value'].message_type = google_dot_protobuf_dot_wrappers__pb2._BYTESVALUE
+_TESTTIMESTAMP.fields_by_name['value'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TESTTIMESTAMP.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_timestamp__pb2._TIMESTAMP
+_TESTDURATION.fields_by_name['value'].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TESTDURATION.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_duration__pb2._DURATION
+_TESTFIELDMASK.fields_by_name['value'].message_type = google_dot_protobuf_dot_field__mask__pb2._FIELDMASK
+_TESTSTRUCT.fields_by_name['value'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_TESTSTRUCT.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_struct__pb2._STRUCT
+_TESTANY.fields_by_name['value'].message_type = google_dot_protobuf_dot_any__pb2._ANY
+_TESTANY.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_any__pb2._ANY
+_TESTVALUE.fields_by_name['value'].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_TESTVALUE.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_struct__pb2._VALUE
+_TESTLISTVALUE.fields_by_name['value'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_TESTLISTVALUE.fields_by_name['repeated_value'].message_type = google_dot_protobuf_dot_struct__pb2._LISTVALUE
+_TESTBOOLVALUE_BOOLMAPENTRY.containing_type = _TESTBOOLVALUE
+_TESTBOOLVALUE.fields_by_name['bool_map'].message_type = _TESTBOOLVALUE_BOOLMAPENTRY
+_TESTEXTENSIONS.fields_by_name['extensions'].message_type = google_dot_protobuf_dot_unittest__pb2._TESTALLEXTENSIONS
+_TESTENUMVALUE.fields_by_name['enum_value1'].enum_type = _ENUMTYPE
+_TESTENUMVALUE.fields_by_name['enum_value2'].enum_type = _ENUMTYPE
+_TESTENUMVALUE.fields_by_name['enum_value3'].enum_type = _ENUMTYPE
+DESCRIPTOR.message_types_by_name['MessageType'] = _MESSAGETYPE
+DESCRIPTOR.message_types_by_name['TestMessage'] = _TESTMESSAGE
+DESCRIPTOR.message_types_by_name['TestOneof'] = _TESTONEOF
+DESCRIPTOR.message_types_by_name['TestMap'] = _TESTMAP
+DESCRIPTOR.message_types_by_name['TestNestedMap'] = _TESTNESTEDMAP
+DESCRIPTOR.message_types_by_name['TestStringMap'] = _TESTSTRINGMAP
+DESCRIPTOR.message_types_by_name['TestWrapper'] = _TESTWRAPPER
+DESCRIPTOR.message_types_by_name['TestTimestamp'] = _TESTTIMESTAMP
+DESCRIPTOR.message_types_by_name['TestDuration'] = _TESTDURATION
+DESCRIPTOR.message_types_by_name['TestFieldMask'] = _TESTFIELDMASK
+DESCRIPTOR.message_types_by_name['TestStruct'] = _TESTSTRUCT
+DESCRIPTOR.message_types_by_name['TestAny'] = _TESTANY
+DESCRIPTOR.message_types_by_name['TestValue'] = _TESTVALUE
+DESCRIPTOR.message_types_by_name['TestListValue'] = _TESTLISTVALUE
+DESCRIPTOR.message_types_by_name['TestBoolValue'] = _TESTBOOLVALUE
+DESCRIPTOR.message_types_by_name['TestCustomJsonName'] = _TESTCUSTOMJSONNAME
+DESCRIPTOR.message_types_by_name['TestExtensions'] = _TESTEXTENSIONS
+DESCRIPTOR.message_types_by_name['TestEnumValue'] = _TESTENUMVALUE
+DESCRIPTOR.enum_types_by_name['EnumType'] = _ENUMTYPE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+MessageType = _reflection.GeneratedProtocolMessageType('MessageType', (_message.Message,), {
+  'DESCRIPTOR' : _MESSAGETYPE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.MessageType)
+  })
+_sym_db.RegisterMessage(MessageType)
+
+TestMessage = _reflection.GeneratedProtocolMessageType('TestMessage', (_message.Message,), {
+  'DESCRIPTOR' : _TESTMESSAGE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestMessage)
+  })
+_sym_db.RegisterMessage(TestMessage)
+
+TestOneof = _reflection.GeneratedProtocolMessageType('TestOneof', (_message.Message,), {
+  'DESCRIPTOR' : _TESTONEOF,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestOneof)
+  })
+_sym_db.RegisterMessage(TestOneof)
+
+TestMap = _reflection.GeneratedProtocolMessageType('TestMap', (_message.Message,), {
+
+  'BoolMapEntry' : _reflection.GeneratedProtocolMessageType('BoolMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_BOOLMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.BoolMapEntry)
+    })
+  ,
+
+  'Int32MapEntry' : _reflection.GeneratedProtocolMessageType('Int32MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_INT32MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.Int32MapEntry)
+    })
+  ,
+
+  'Int64MapEntry' : _reflection.GeneratedProtocolMessageType('Int64MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_INT64MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.Int64MapEntry)
+    })
+  ,
+
+  'Uint32MapEntry' : _reflection.GeneratedProtocolMessageType('Uint32MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_UINT32MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.Uint32MapEntry)
+    })
+  ,
+
+  'Uint64MapEntry' : _reflection.GeneratedProtocolMessageType('Uint64MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_UINT64MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.Uint64MapEntry)
+    })
+  ,
+
+  'StringMapEntry' : _reflection.GeneratedProtocolMessageType('StringMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTMAP_STRINGMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestMap.StringMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTMAP,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestMap)
+  })
+_sym_db.RegisterMessage(TestMap)
+_sym_db.RegisterMessage(TestMap.BoolMapEntry)
+_sym_db.RegisterMessage(TestMap.Int32MapEntry)
+_sym_db.RegisterMessage(TestMap.Int64MapEntry)
+_sym_db.RegisterMessage(TestMap.Uint32MapEntry)
+_sym_db.RegisterMessage(TestMap.Uint64MapEntry)
+_sym_db.RegisterMessage(TestMap.StringMapEntry)
+
+TestNestedMap = _reflection.GeneratedProtocolMessageType('TestNestedMap', (_message.Message,), {
+
+  'BoolMapEntry' : _reflection.GeneratedProtocolMessageType('BoolMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_BOOLMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.BoolMapEntry)
+    })
+  ,
+
+  'Int32MapEntry' : _reflection.GeneratedProtocolMessageType('Int32MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_INT32MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.Int32MapEntry)
+    })
+  ,
+
+  'Int64MapEntry' : _reflection.GeneratedProtocolMessageType('Int64MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_INT64MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.Int64MapEntry)
+    })
+  ,
+
+  'Uint32MapEntry' : _reflection.GeneratedProtocolMessageType('Uint32MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_UINT32MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.Uint32MapEntry)
+    })
+  ,
+
+  'Uint64MapEntry' : _reflection.GeneratedProtocolMessageType('Uint64MapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_UINT64MAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.Uint64MapEntry)
+    })
+  ,
+
+  'StringMapEntry' : _reflection.GeneratedProtocolMessageType('StringMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_STRINGMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.StringMapEntry)
+    })
+  ,
+
+  'MapMapEntry' : _reflection.GeneratedProtocolMessageType('MapMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTNESTEDMAP_MAPMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestNestedMap.MapMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTNESTEDMAP,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestNestedMap)
+  })
+_sym_db.RegisterMessage(TestNestedMap)
+_sym_db.RegisterMessage(TestNestedMap.BoolMapEntry)
+_sym_db.RegisterMessage(TestNestedMap.Int32MapEntry)
+_sym_db.RegisterMessage(TestNestedMap.Int64MapEntry)
+_sym_db.RegisterMessage(TestNestedMap.Uint32MapEntry)
+_sym_db.RegisterMessage(TestNestedMap.Uint64MapEntry)
+_sym_db.RegisterMessage(TestNestedMap.StringMapEntry)
+_sym_db.RegisterMessage(TestNestedMap.MapMapEntry)
+
+TestStringMap = _reflection.GeneratedProtocolMessageType('TestStringMap', (_message.Message,), {
+
+  'StringMapEntry' : _reflection.GeneratedProtocolMessageType('StringMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTSTRINGMAP_STRINGMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestStringMap.StringMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTSTRINGMAP,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestStringMap)
+  })
+_sym_db.RegisterMessage(TestStringMap)
+_sym_db.RegisterMessage(TestStringMap.StringMapEntry)
+
+TestWrapper = _reflection.GeneratedProtocolMessageType('TestWrapper', (_message.Message,), {
+  'DESCRIPTOR' : _TESTWRAPPER,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestWrapper)
+  })
+_sym_db.RegisterMessage(TestWrapper)
+
+TestTimestamp = _reflection.GeneratedProtocolMessageType('TestTimestamp', (_message.Message,), {
+  'DESCRIPTOR' : _TESTTIMESTAMP,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestTimestamp)
+  })
+_sym_db.RegisterMessage(TestTimestamp)
+
+TestDuration = _reflection.GeneratedProtocolMessageType('TestDuration', (_message.Message,), {
+  'DESCRIPTOR' : _TESTDURATION,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestDuration)
+  })
+_sym_db.RegisterMessage(TestDuration)
+
+TestFieldMask = _reflection.GeneratedProtocolMessageType('TestFieldMask', (_message.Message,), {
+  'DESCRIPTOR' : _TESTFIELDMASK,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestFieldMask)
+  })
+_sym_db.RegisterMessage(TestFieldMask)
+
+TestStruct = _reflection.GeneratedProtocolMessageType('TestStruct', (_message.Message,), {
+  'DESCRIPTOR' : _TESTSTRUCT,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestStruct)
+  })
+_sym_db.RegisterMessage(TestStruct)
+
+TestAny = _reflection.GeneratedProtocolMessageType('TestAny', (_message.Message,), {
+  'DESCRIPTOR' : _TESTANY,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestAny)
+  })
+_sym_db.RegisterMessage(TestAny)
+
+TestValue = _reflection.GeneratedProtocolMessageType('TestValue', (_message.Message,), {
+  'DESCRIPTOR' : _TESTVALUE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestValue)
+  })
+_sym_db.RegisterMessage(TestValue)
+
+TestListValue = _reflection.GeneratedProtocolMessageType('TestListValue', (_message.Message,), {
+  'DESCRIPTOR' : _TESTLISTVALUE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestListValue)
+  })
+_sym_db.RegisterMessage(TestListValue)
+
+TestBoolValue = _reflection.GeneratedProtocolMessageType('TestBoolValue', (_message.Message,), {
+
+  'BoolMapEntry' : _reflection.GeneratedProtocolMessageType('BoolMapEntry', (_message.Message,), {
+    'DESCRIPTOR' : _TESTBOOLVALUE_BOOLMAPENTRY,
+    '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+    # @@protoc_insertion_point(class_scope:proto3.TestBoolValue.BoolMapEntry)
+    })
+  ,
+  'DESCRIPTOR' : _TESTBOOLVALUE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestBoolValue)
+  })
+_sym_db.RegisterMessage(TestBoolValue)
+_sym_db.RegisterMessage(TestBoolValue.BoolMapEntry)
+
+TestCustomJsonName = _reflection.GeneratedProtocolMessageType('TestCustomJsonName', (_message.Message,), {
+  'DESCRIPTOR' : _TESTCUSTOMJSONNAME,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestCustomJsonName)
+  })
+_sym_db.RegisterMessage(TestCustomJsonName)
+
+TestExtensions = _reflection.GeneratedProtocolMessageType('TestExtensions', (_message.Message,), {
+  'DESCRIPTOR' : _TESTEXTENSIONS,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestExtensions)
+  })
+_sym_db.RegisterMessage(TestExtensions)
+
+TestEnumValue = _reflection.GeneratedProtocolMessageType('TestEnumValue', (_message.Message,), {
+  'DESCRIPTOR' : _TESTENUMVALUE,
+  '__module__' : 'google.protobuf.util.json_format_proto3_pb2'
+  # @@protoc_insertion_point(class_scope:proto3.TestEnumValue)
+  })
+_sym_db.RegisterMessage(TestEnumValue)
+
+
+DESCRIPTOR._options = None
+_TESTMAP_BOOLMAPENTRY._options = None
+_TESTMAP_INT32MAPENTRY._options = None
+_TESTMAP_INT64MAPENTRY._options = None
+_TESTMAP_UINT32MAPENTRY._options = None
+_TESTMAP_UINT64MAPENTRY._options = None
+_TESTMAP_STRINGMAPENTRY._options = None
+_TESTNESTEDMAP_BOOLMAPENTRY._options = None
+_TESTNESTEDMAP_INT32MAPENTRY._options = None
+_TESTNESTEDMAP_INT64MAPENTRY._options = None
+_TESTNESTEDMAP_UINT32MAPENTRY._options = None
+_TESTNESTEDMAP_UINT64MAPENTRY._options = None
+_TESTNESTEDMAP_STRINGMAPENTRY._options = None
+_TESTNESTEDMAP_MAPMAPENTRY._options = None
+_TESTSTRINGMAP_STRINGMAPENTRY._options = None
+_TESTBOOLVALUE_BOOLMAPENTRY._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/wrappers_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/wrappers_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e5e2bc74256c02bdeb02275473749a07860c882
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/google/protobuf/wrappers_pb2.py
@@ -0,0 +1,391 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/protobuf/wrappers.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='google/protobuf/wrappers.proto',
+  package='google.protobuf',
+  syntax='proto3',
+  serialized_options=b'\n\023com.google.protobufB\rWrappersProtoP\001Z1google.golang.org/protobuf/types/known/wrapperspb\370\001\001\242\002\003GPB\252\002\036Google.Protobuf.WellKnownTypes',
+  create_key=_descriptor._internal_create_key,
+  serialized_pb=b'\n\x1egoogle/protobuf/wrappers.proto\x12\x0fgoogle.protobuf\"\x1c\n\x0b\x44oubleValue\x12\r\n\x05value\x18\x01 \x01(\x01\"\x1b\n\nFloatValue\x12\r\n\x05value\x18\x01 \x01(\x02\"\x1b\n\nInt64Value\x12\r\n\x05value\x18\x01 \x01(\x03\"\x1c\n\x0bUInt64Value\x12\r\n\x05value\x18\x01 \x01(\x04\"\x1b\n\nInt32Value\x12\r\n\x05value\x18\x01 \x01(\x05\"\x1c\n\x0bUInt32Value\x12\r\n\x05value\x18\x01 \x01(\r\"\x1a\n\tBoolValue\x12\r\n\x05value\x18\x01 \x01(\x08\"\x1c\n\x0bStringValue\x12\r\n\x05value\x18\x01 \x01(\t\"\x1b\n\nBytesValue\x12\r\n\x05value\x18\x01 \x01(\x0c\x42\x83\x01\n\x13\x63om.google.protobufB\rWrappersProtoP\x01Z1google.golang.org/protobuf/types/known/wrapperspb\xf8\x01\x01\xa2\x02\x03GPB\xaa\x02\x1eGoogle.Protobuf.WellKnownTypesb\x06proto3'
+)
+
+
+
+
+_DOUBLEVALUE = _descriptor.Descriptor(
+  name='DoubleValue',
+  full_name='google.protobuf.DoubleValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.DoubleValue.value', index=0,
+      number=1, type=1, cpp_type=5, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=51,
+  serialized_end=79,
+)
+
+
+_FLOATVALUE = _descriptor.Descriptor(
+  name='FloatValue',
+  full_name='google.protobuf.FloatValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.FloatValue.value', index=0,
+      number=1, type=2, cpp_type=6, label=1,
+      has_default_value=False, default_value=float(0),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=81,
+  serialized_end=108,
+)
+
+
+_INT64VALUE = _descriptor.Descriptor(
+  name='Int64Value',
+  full_name='google.protobuf.Int64Value',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.Int64Value.value', index=0,
+      number=1, type=3, cpp_type=2, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=110,
+  serialized_end=137,
+)
+
+
+_UINT64VALUE = _descriptor.Descriptor(
+  name='UInt64Value',
+  full_name='google.protobuf.UInt64Value',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.UInt64Value.value', index=0,
+      number=1, type=4, cpp_type=4, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=139,
+  serialized_end=167,
+)
+
+
+_INT32VALUE = _descriptor.Descriptor(
+  name='Int32Value',
+  full_name='google.protobuf.Int32Value',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.Int32Value.value', index=0,
+      number=1, type=5, cpp_type=1, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=169,
+  serialized_end=196,
+)
+
+
+_UINT32VALUE = _descriptor.Descriptor(
+  name='UInt32Value',
+  full_name='google.protobuf.UInt32Value',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.UInt32Value.value', index=0,
+      number=1, type=13, cpp_type=3, label=1,
+      has_default_value=False, default_value=0,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=198,
+  serialized_end=226,
+)
+
+
+_BOOLVALUE = _descriptor.Descriptor(
+  name='BoolValue',
+  full_name='google.protobuf.BoolValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.BoolValue.value', index=0,
+      number=1, type=8, cpp_type=7, label=1,
+      has_default_value=False, default_value=False,
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=228,
+  serialized_end=254,
+)
+
+
+_STRINGVALUE = _descriptor.Descriptor(
+  name='StringValue',
+  full_name='google.protobuf.StringValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.StringValue.value', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"".decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=256,
+  serialized_end=284,
+)
+
+
+_BYTESVALUE = _descriptor.Descriptor(
+  name='BytesValue',
+  full_name='google.protobuf.BytesValue',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  create_key=_descriptor._internal_create_key,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='value', full_name='google.protobuf.BytesValue.value', index=0,
+      number=1, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=b"",
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      serialized_options=None, file=DESCRIPTOR,  create_key=_descriptor._internal_create_key),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  serialized_options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=286,
+  serialized_end=313,
+)
+
+DESCRIPTOR.message_types_by_name['DoubleValue'] = _DOUBLEVALUE
+DESCRIPTOR.message_types_by_name['FloatValue'] = _FLOATVALUE
+DESCRIPTOR.message_types_by_name['Int64Value'] = _INT64VALUE
+DESCRIPTOR.message_types_by_name['UInt64Value'] = _UINT64VALUE
+DESCRIPTOR.message_types_by_name['Int32Value'] = _INT32VALUE
+DESCRIPTOR.message_types_by_name['UInt32Value'] = _UINT32VALUE
+DESCRIPTOR.message_types_by_name['BoolValue'] = _BOOLVALUE
+DESCRIPTOR.message_types_by_name['StringValue'] = _STRINGVALUE
+DESCRIPTOR.message_types_by_name['BytesValue'] = _BYTESVALUE
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+DoubleValue = _reflection.GeneratedProtocolMessageType('DoubleValue', (_message.Message,), {
+  'DESCRIPTOR' : _DOUBLEVALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.DoubleValue)
+  })
+_sym_db.RegisterMessage(DoubleValue)
+
+FloatValue = _reflection.GeneratedProtocolMessageType('FloatValue', (_message.Message,), {
+  'DESCRIPTOR' : _FLOATVALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.FloatValue)
+  })
+_sym_db.RegisterMessage(FloatValue)
+
+Int64Value = _reflection.GeneratedProtocolMessageType('Int64Value', (_message.Message,), {
+  'DESCRIPTOR' : _INT64VALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Int64Value)
+  })
+_sym_db.RegisterMessage(Int64Value)
+
+UInt64Value = _reflection.GeneratedProtocolMessageType('UInt64Value', (_message.Message,), {
+  'DESCRIPTOR' : _UINT64VALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.UInt64Value)
+  })
+_sym_db.RegisterMessage(UInt64Value)
+
+Int32Value = _reflection.GeneratedProtocolMessageType('Int32Value', (_message.Message,), {
+  'DESCRIPTOR' : _INT32VALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.Int32Value)
+  })
+_sym_db.RegisterMessage(Int32Value)
+
+UInt32Value = _reflection.GeneratedProtocolMessageType('UInt32Value', (_message.Message,), {
+  'DESCRIPTOR' : _UINT32VALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.UInt32Value)
+  })
+_sym_db.RegisterMessage(UInt32Value)
+
+BoolValue = _reflection.GeneratedProtocolMessageType('BoolValue', (_message.Message,), {
+  'DESCRIPTOR' : _BOOLVALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.BoolValue)
+  })
+_sym_db.RegisterMessage(BoolValue)
+
+StringValue = _reflection.GeneratedProtocolMessageType('StringValue', (_message.Message,), {
+  'DESCRIPTOR' : _STRINGVALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.StringValue)
+  })
+_sym_db.RegisterMessage(StringValue)
+
+BytesValue = _reflection.GeneratedProtocolMessageType('BytesValue', (_message.Message,), {
+  'DESCRIPTOR' : _BYTESVALUE,
+  '__module__' : 'google.protobuf.wrappers_pb2'
+  # @@protoc_insertion_point(class_scope:google.protobuf.BytesValue)
+  })
+_sym_db.RegisterMessage(BytesValue)
+
+
+DESCRIPTOR._options = None
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a9b0bba23f0362b9da9b1a7d64575188cf076aa4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/METADATA
@@ -0,0 +1,526 @@
+Metadata-Version: 2.1
+Name: html5lib
+Version: 1.0.1
+Summary: HTML parser based on the WHATWG HTML specification
+Home-page: https://github.com/html5lib/html5lib-python
+Maintainer: James Graham
+Maintainer-email: james@hoppipolla.co.uk
+License: MIT License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Provides-Extra: all
+Requires-Dist: chardet (>=2.2) ; extra == 'all'
+Requires-Dist: genshi ; extra == 'all'
+Requires-Dist: datrie ; (platform_python_implementation == 'CPython') and extra == 'all'
+Requires-Dist: lxml ; (platform_python_implementation == 'CPython') and extra == 'all'
+Provides-Extra: chardet
+Requires-Dist: chardet (>=2.2) ; extra == 'chardet'
+Provides-Extra: datrie
+Requires-Dist: datrie ; (platform_python_implementation == 'CPython') and extra == 'datrie'
+Provides-Extra: genshi
+Requires-Dist: genshi ; extra == 'genshi'
+Provides-Extra: lxml
+Requires-Dist: lxml ; (platform_python_implementation == 'CPython') and extra == 'lxml'
+
+html5lib
+========
+
+.. image:: https://travis-ci.org/html5lib/html5lib-python.png?branch=master
+  :target: https://travis-ci.org/html5lib/html5lib-python
+
+html5lib is a pure-python library for parsing HTML. It is designed to
+conform to the WHATWG HTML specification, as is implemented by all major
+web browsers.
+
+
+Usage
+-----
+
+Simple usage follows this pattern:
+
+.. code-block:: python
+
+  import html5lib
+  with open("mydocument.html", "rb") as f:
+      document = html5lib.parse(f)
+
+or:
+
+.. code-block:: python
+
+  import html5lib
+  document = html5lib.parse("<p>Hello World!")
+
+By default, the ``document`` will be an ``xml.etree`` element instance.
+Whenever possible, html5lib chooses the accelerated ``ElementTree``
+implementation (i.e. ``xml.etree.cElementTree`` on Python 2.x).
+
+Two other tree types are supported: ``xml.dom.minidom`` and
+``lxml.etree``. To use an alternative format, specify the name of
+a treebuilder:
+
+.. code-block:: python
+
+  import html5lib
+  with open("mydocument.html", "rb") as f:
+      lxml_etree_document = html5lib.parse(f, treebuilder="lxml")
+
+When using with ``urllib2`` (Python 2), the charset from HTTP should be
+pass into html5lib as follows:
+
+.. code-block:: python
+
+  from contextlib import closing
+  from urllib2 import urlopen
+  import html5lib
+
+  with closing(urlopen("http://example.com/")) as f:
+      document = html5lib.parse(f, transport_encoding=f.info().getparam("charset"))
+
+When using with ``urllib.request`` (Python 3), the charset from HTTP
+should be pass into html5lib as follows:
+
+.. code-block:: python
+
+  from urllib.request import urlopen
+  import html5lib
+
+  with urlopen("http://example.com/") as f:
+      document = html5lib.parse(f, transport_encoding=f.info().get_content_charset())
+
+To have more control over the parser, create a parser object explicitly.
+For instance, to make the parser raise exceptions on parse errors, use:
+
+.. code-block:: python
+
+  import html5lib
+  with open("mydocument.html", "rb") as f:
+      parser = html5lib.HTMLParser(strict=True)
+      document = parser.parse(f)
+
+When you're instantiating parser objects explicitly, pass a treebuilder
+class as the ``tree`` keyword argument to use an alternative document
+format:
+
+.. code-block:: python
+
+  import html5lib
+  parser = html5lib.HTMLParser(tree=html5lib.getTreeBuilder("dom"))
+  minidom_document = parser.parse("<p>Hello World!")
+
+More documentation is available at https://html5lib.readthedocs.io/.
+
+
+Installation
+------------
+
+html5lib works on CPython 2.7+, CPython 3.3+ and PyPy.  To install it,
+use:
+
+.. code-block:: bash
+
+    $ pip install html5lib
+
+
+Optional Dependencies
+---------------------
+
+The following third-party libraries may be used for additional
+functionality:
+
+- ``datrie`` can be used under CPython to improve parsing performance
+  (though in almost all cases the improvement is marginal);
+
+- ``lxml`` is supported as a tree format (for both building and
+  walking) under CPython (but *not* PyPy where it is known to cause
+  segfaults);
+
+- ``genshi`` has a treewalker (but not builder); and
+
+- ``chardet`` can be used as a fallback when character encoding cannot
+  be determined.
+
+
+Bugs
+----
+
+Please report any bugs on the `issue tracker
+<https://github.com/html5lib/html5lib-python/issues>`_.
+
+
+Tests
+-----
+
+Unit tests require the ``pytest`` and ``mock`` libraries and can be
+run using the ``py.test`` command in the root directory.
+
+Test data are contained in a separate `html5lib-tests
+<https://github.com/html5lib/html5lib-tests>`_ repository and included
+as a submodule, thus for git checkouts they must be initialized::
+
+  $ git submodule init
+  $ git submodule update
+
+If you have all compatible Python implementations available on your
+system, you can run tests on all of them using the ``tox`` utility,
+which can be found on PyPI.
+
+
+Questions?
+----------
+
+There's a mailing list available for support on Google Groups,
+`html5lib-discuss <http://groups.google.com/group/html5lib-discuss>`_,
+though you may get a quicker response asking on IRC in `#whatwg on
+irc.freenode.net <http://wiki.whatwg.org/wiki/IRC>`_.
+
+Change Log
+----------
+
+1.0.1
+~~~~~
+
+Released on December 7, 2017
+
+Breaking changes:
+
+* Drop support for Python 2.6. (#330) (Thank you, Hugo, Will Kahn-Greene!)
+* Remove ``utils/spider.py`` (#353) (Thank you, Jon Dufresne!)
+
+Features:
+
+* Improve documentation. (#300, #307) (Thank you, Jon Dufresne, Tom Most,
+  Will Kahn-Greene!)
+* Add iframe seamless boolean attribute. (Thank you, Ritwik Gupta!)
+* Add itemscope as a boolean attribute. (#194) (Thank you, Jonathan Vanasco!)
+* Support Python 3.6. (#333) (Thank you, Jon Dufresne!)
+* Add CI support for Windows using AppVeyor. (Thank you, John Vandenberg!)
+* Improve testing and CI and add code coverage (#323, #334), (Thank you, Jon
+  Dufresne, John Vandenberg, Geoffrey Sneddon, Will Kahn-Greene!)
+* Semver-compliant version number.
+
+Bug fixes:
+
+* Add support for setuptools < 18.5 to support environment markers. (Thank you,
+  John Vandenberg!)
+* Add explicit dependency for six >= 1.9. (Thank you, Eric Amorde!)
+* Fix regexes to work with Python 3.7 regex adjustments. (#318, #379) (Thank
+  you, Benedikt Morbach, Ville Skyttä, Mark Vasilkov!)
+* Fix alphabeticalattributes filter namespace bug. (#324) (Thank you, Will
+  Kahn-Greene!)
+* Include license file in generated wheel package. (#350) (Thank you, Jon
+  Dufresne!)
+* Fix annotation-xml typo. (#339) (Thank you, Will Kahn-Greene!)
+* Allow uppercase hex chararcters in CSS colour check. (#377) (Thank you,
+  Komal Dembla, Hugo!)
+
+
+1.0
+~~~
+
+Released and unreleased on December 7, 2017. Badly packaged release.
+
+
+0.999999999/1.0b10
+~~~~~~~~~~~~~~~~~~
+
+Released on July 15, 2016
+
+* Fix attribute order going to the tree builder to be document order
+  instead of reverse document order(!).
+
+
+0.99999999/1.0b9
+~~~~~~~~~~~~~~~~
+
+Released on July 14, 2016
+
+* **Added ordereddict as a mandatory dependency on Python 2.6.**
+
+* Added ``lxml``, ``genshi``, ``datrie``, ``charade``, and ``all``
+  extras that will do the right thing based on the specific
+  interpreter implementation.
+
+* Now requires the ``mock`` package for the testsuite.
+
+* Cease supporting DATrie under PyPy.
+
+* **Remove PullDOM support, as this hasn't ever been properly
+  tested, doesn't entirely work, and as far as I can tell is
+  completely unused by anyone.**
+
+* Move testsuite to ``py.test``.
+
+* **Fix #124: move to webencodings for decoding the input byte stream;
+  this makes html5lib compliant with the Encoding Standard, and
+  introduces a required dependency on webencodings.**
+
+* **Cease supporting Python 3.2 (in both CPython and PyPy forms).**
+
+* **Fix comments containing double-dash with lxml 3.5 and above.**
+
+* **Use scripting disabled by default (as we don't implement
+  scripting).**
+
+* **Fix #11, avoiding the XSS bug potentially caused by serializer
+  allowing attribute values to be escaped out of in old browser versions,
+  changing the quote_attr_values option on serializer to take one of
+  three values, "always" (the old True value), "legacy" (the new option,
+  and the new default), and "spec" (the old False value, and the old
+  default).**
+
+* **Fix #72 by rewriting the sanitizer to apply only to treewalkers
+  (instead of the tokenizer); as such, this will require amending all
+  callers of it to use it via the treewalker API.**
+
+* **Drop support of charade, now that chardet is supported once more.**
+
+* **Replace the charset keyword argument on parse and related methods
+  with a set of keyword arguments: override_encoding, transport_encoding,
+  same_origin_parent_encoding, likely_encoding, and default_encoding.**
+
+* **Move filters._base, treebuilder._base, and treewalkers._base to .base
+  to clarify their status as public.**
+
+* **Get rid of the sanitizer package. Merge sanitizer.sanitize into the
+  sanitizer.htmlsanitizer module and move that to sanitizer. This means
+  anyone who used sanitizer.sanitize or sanitizer.HTMLSanitizer needs no
+  code changes.**
+
+* **Rename treewalkers.lxmletree to .etree_lxml and
+  treewalkers.genshistream to .genshi to have a consistent API.**
+
+* Move a whole load of stuff (inputstream, ihatexml, trie, tokenizer,
+  utils) to be underscore prefixed to clarify their status as private.
+
+
+0.9999999/1.0b8
+~~~~~~~~~~~~~~~
+
+Released on September 10, 2015
+
+* Fix #195: fix the sanitizer to drop broken URLs (it threw an
+  exception between 0.9999 and 0.999999).
+
+
+0.999999/1.0b7
+~~~~~~~~~~~~~~
+
+Released on July 7, 2015
+
+* Fix #189: fix the sanitizer to allow relative URLs again (as it did
+  prior to 0.9999/1.0b5).
+
+
+0.99999/1.0b6
+~~~~~~~~~~~~~
+
+Released on April 30, 2015
+
+* Fix #188: fix the sanitizer to not throw an exception when sanitizing
+  bogus data URLs.
+
+
+0.9999/1.0b5
+~~~~~~~~~~~~
+
+Released on April 29, 2015
+
+* Fix #153: Sanitizer fails to treat some attributes as URLs. Despite how
+  this sounds, this has no known security implications.  No known version
+  of IE (5.5 to current), Firefox (3 to current), Safari (6 to current),
+  Chrome (1 to current), or Opera (12 to current) will run any script
+  provided in these attributes.
+
+* Pass error message to the ParseError exception in strict parsing mode.
+
+* Allow data URIs in the sanitizer, with a whitelist of content-types.
+
+* Add support for Python implementations that don't support lone
+  surrogates (read: Jython). Fixes #2.
+
+* Remove localization of error messages. This functionality was totally
+  unused (and untested that everything was localizable), so we may as
+  well follow numerous browsers in not supporting translating technical
+  strings.
+
+* Expose treewalkers.pprint as a public API.
+
+* Add a documentEncoding property to HTML5Parser, fix #121.
+
+
+0.999
+~~~~~
+
+Released on December 23, 2013
+
+* Fix #127: add work-around for CPython issue #20007: .read(0) on
+  http.client.HTTPResponse drops the rest of the content.
+
+* Fix #115: lxml treewalker can now deal with fragments containing, at
+  their root level, text nodes with non-ASCII characters on Python 2.
+
+
+0.99
+~~~~
+
+Released on September 10, 2013
+
+* No library changes from 1.0b3; released as 0.99 as pip has changed
+  behaviour from 1.4 to avoid installing pre-release versions per
+  PEP 440.
+
+
+1.0b3
+~~~~~
+
+Released on July 24, 2013
+
+* Removed ``RecursiveTreeWalker`` from ``treewalkers._base``. Any
+  implementation using it should be moved to
+  ``NonRecursiveTreeWalker``, as everything bundled with html5lib has
+  for years.
+
+* Fix #67 so that ``BufferedStream`` to correctly returns a bytes
+  object, thereby fixing any case where html5lib is passed a
+  non-seekable RawIOBase-like object.
+
+
+1.0b2
+~~~~~
+
+Released on June 27, 2013
+
+* Removed reordering of attributes within the serializer. There is now
+  an ``alphabetical_attributes`` option which preserves the previous
+  behaviour through a new filter. This allows attribute order to be
+  preserved through html5lib if the tree builder preserves order.
+
+* Removed ``dom2sax`` from DOM treebuilders. It has been replaced by
+  ``treeadapters.sax.to_sax`` which is generic and supports any
+  treewalker; it also resolves all known bugs with ``dom2sax``.
+
+* Fix treewalker assertions on hitting bytes strings on
+  Python 2. Previous to 1.0b1, treewalkers coped with mixed
+  bytes/unicode data on Python 2; this reintroduces this prior
+  behaviour on Python 2. Behaviour is unchanged on Python 3.
+
+
+1.0b1
+~~~~~
+
+Released on May 17, 2013
+
+* Implementation updated to implement the `HTML specification
+  <http://www.whatwg.org/specs/web-apps/current-work/>`_ as of 5th May
+  2013 (`SVN <http://svn.whatwg.org/webapps/>`_ revision r7867).
+
+* Python 3.2+ supported in a single codebase using the ``six`` library.
+
+* Removed support for Python 2.5 and older.
+
+* Removed the deprecated Beautiful Soup 3 treebuilder.
+  ``beautifulsoup4`` can use ``html5lib`` as a parser instead. Note that
+  since it doesn't support namespaces, foreign content like SVG and
+  MathML is parsed incorrectly.
+
+* Removed ``simpletree`` from the package. The default tree builder is
+  now ``etree`` (using the ``xml.etree.cElementTree`` implementation if
+  available, and ``xml.etree.ElementTree`` otherwise).
+
+* Removed the ``XHTMLSerializer`` as it never actually guaranteed its
+  output was well-formed XML, and hence provided little of use.
+
+* Removed default DOM treebuilder, so ``html5lib.treebuilders.dom`` is no
+  longer supported. ``html5lib.treebuilders.getTreeBuilder("dom")`` will
+  return the default DOM treebuilder, which uses ``xml.dom.minidom``.
+
+* Optional heuristic character encoding detection now based on
+  ``charade`` for Python 2.6 - 3.3 compatibility.
+
+* Optional ``Genshi`` treewalker support fixed.
+
+* Many bugfixes, including:
+
+  * #33: null in attribute value breaks XML AttValue;
+
+  * #4: nested, indirect descendant, <button> causes infinite loop;
+
+  * `Google Code 215
+    <http://code.google.com/p/html5lib/issues/detail?id=215>`_: Properly
+    detect seekable streams;
+
+  * `Google Code 206
+    <http://code.google.com/p/html5lib/issues/detail?id=206>`_: add
+    support for <video preload=...>, <audio preload=...>;
+
+  * `Google Code 205
+    <http://code.google.com/p/html5lib/issues/detail?id=205>`_: add
+    support for <video poster=...>;
+
+  * `Google Code 202
+    <http://code.google.com/p/html5lib/issues/detail?id=202>`_: Unicode
+    file breaks InputStream.
+
+* Source code is now mostly PEP 8 compliant.
+
+* Test harness has been improved and now depends on ``nose``.
+
+* Documentation updated and moved to https://html5lib.readthedocs.io/.
+
+
+0.95
+~~~~
+
+Released on February 11, 2012
+
+
+0.90
+~~~~
+
+Released on January 17, 2010
+
+
+0.11.1
+~~~~~~
+
+Released on June 12, 2008
+
+
+0.11
+~~~~
+
+Released on June 10, 2008
+
+
+0.10
+~~~~
+
+Released on October 7, 2007
+
+
+0.9
+~~~
+
+Released on March 11, 2007
+
+
+0.2
+~~~
+
+Released on January 8, 2007
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..0617bbf987e4c8292f8cd8867d543aabcdf686d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/RECORD
@@ -0,0 +1,83 @@
+html5lib/__init__.py,sha256=q1D20NqqzRVgmTHW2xiVtaQT2eKna-iit3tL62Yn5OI,1145
+html5lib/_ihatexml.py,sha256=3LBtJMlzgwM8vpQiU1TvGmEEmNH72sV0yD8yS53y07A,16705
+html5lib/_inputstream.py,sha256=WtC-hb3nS7Du6XvdL9JACOQgD5ydPKb7f9z0q4OIvRM,32499
+html5lib/_tokenizer.py,sha256=JFZ4kiYfas1f62q2bdXH8Ch5DtXAWEZg0KYkRF4boRQ,76568
+html5lib/_utils.py,sha256=UHC4fXEZRJ0YM44Z4DeLem66auCjb08vSPcN6Y714Iw,4003
+html5lib/constants.py,sha256=4lmZWLtEPRLnl8NzftOoYTJdo6jpeMtP6dqQC0g_bWQ,83518
+html5lib/html5parser.py,sha256=eeMsctZUonbJZPegB_CElFye2lGufMcMsxQxsJtf7Mg,118951
+html5lib/serializer.py,sha256=cmZQjjaXThEe2_6yzDqeb3yXS_hUggv0cCa2VBD9e2Y,15746
+html5lib/_trie/__init__.py,sha256=8VR1bcgD2OpeS2XExpu5yBhP_Q1K-lwKbBKICBPf1kU,289
+html5lib/_trie/_base.py,sha256=uJHVhzif9S0MJXgy9F98iEev5evi_rgUk5BmEbUSp8c,930
+html5lib/_trie/datrie.py,sha256=rGMj61020CBiR97e4kyMyqn_FSIJzgDcYT2uj7PZkoo,1166
+html5lib/_trie/py.py,sha256=zg7RZSHxJ8mLmuI_7VEIV8AomISrgkvqCP477AgXaG0,1763
+html5lib/filters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+html5lib/filters/alphabeticalattributes.py,sha256=lViZc2JMCclXi_5gduvmdzrRxtO5Xo9ONnbHBVCsykU,919
+html5lib/filters/base.py,sha256=z-IU9ZAYjpsVsqmVt7kuWC63jR11hDMr6CVrvuao8W0,286
+html5lib/filters/inject_meta_charset.py,sha256=egDXUEHXmAG9504xz0K6ALDgYkvUrC2q15YUVeNlVQg,2945
+html5lib/filters/lint.py,sha256=upXATs6By7cot7o0bnNqR15sPq2Fn6Vnjvoy3gyO_rY,3631
+html5lib/filters/optionaltags.py,sha256=8lWT75J0aBOHmPgfmqTHSfPpPMp01T84NKu0CRedxcE,10588
+html5lib/filters/sanitizer.py,sha256=V6_cpCq9EXgXkL1CblWEUxSgHy466Hy8k0453x8PSs8,26236
+html5lib/filters/whitespace.py,sha256=8eWqZxd4UC4zlFGW6iyY6f-2uuT8pOCSALc3IZt7_t4,1214
+html5lib/treeadapters/__init__.py,sha256=18hyI-at2aBsdKzpwRwa5lGF1ipgctaTYXoU9En2ZQg,650
+html5lib/treeadapters/genshi.py,sha256=CH27pAsDKmu4ZGkAUrwty7u0KauGLCZRLPMzaO3M5vo,1715
+html5lib/treeadapters/sax.py,sha256=BKS8woQTnKiqeffHsxChUqL4q2ZR_wb5fc9MJ3zQC8s,1776
+html5lib/treebuilders/__init__.py,sha256=AysSJyvPfikCMMsTVvaxwkgDieELD5dfR8FJIAuq7hY,3592
+html5lib/treebuilders/base.py,sha256=JEFLxUEsluRl7vY-6cnAk44HxgCAkaj4GpEOBpg8tao,14567
+html5lib/treebuilders/dom.py,sha256=SY3MsijXyzdNPc8aK5IQsupBoM8J67y56DgNtGvsb9g,8835
+html5lib/treebuilders/etree.py,sha256=R0zaNrdtPel3XHV8PUVcQzVnMuiOm_8fpZof7tU7ips,12752
+html5lib/treebuilders/etree_lxml.py,sha256=9V0dXxbJYYq-Skgb5-_OL2NkVYpjioEb4CHajo0e9yI,14122
+html5lib/treewalkers/__init__.py,sha256=yhXxHpjlSqfQyUag3v8-vWjMPriFBU8YRAPNpDgBTn8,5714
+html5lib/treewalkers/base.py,sha256=ouiOsuSzvI0KgzdWP8PlxIaSNs9falhbiinAEc_UIJY,7476
+html5lib/treewalkers/dom.py,sha256=EHyFR8D8lYNnyDU9lx_IKigVJRyecUGua0mOi7HBukc,1413
+html5lib/treewalkers/etree.py,sha256=gRzfuNnWg6r-fvtXRp4xPVTC1CHPowcn8Dc4-WcDoOg,4538
+html5lib/treewalkers/etree_lxml.py,sha256=AR07dDrdkDqrQT4yNK_5WeGiZMHfOrM3ZmmII6YrSgs,6297
+html5lib/treewalkers/genshi.py,sha256=4D2PECZ5n3ZN3qu3jMl9yY7B81jnQApBQSVlfaIuYbA,2309
+html5lib-1.0.1.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+html5lib-1.0.1.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+html5lib-1.0.1.dist-info/METADATA,sha256=mEePwLlKnFqJkD6arLbyS6_526le7NuTkAhdtDpnOQs,15399
+html5lib-1.0.1.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+html5lib-1.0.1.dist-info/top_level.txt,sha256=XEX6CHpskSmvjJB4tP6m4Q5NYXhIf_0ceMc0PNbzJPQ,9
+html5lib-1.0.1.dist-info/RECORD,,
+html5lib/treewalkers/__pycache__,,
+html5lib/filters/inject_meta_charset.cpython-38.pyc,,
+html5lib/treewalkers/base.cpython-38.pyc,,
+html5lib/filters/__init__.cpython-38.pyc,,
+html5lib/html5parser.cpython-38.pyc,,
+html5lib/_trie/datrie.cpython-38.pyc,,
+html5lib/_trie/__init__.cpython-38.pyc,,
+html5lib/treebuilders/__init__.cpython-38.pyc,,
+html5lib/treewalkers/etree.cpython-38.pyc,,
+html5lib/__init__.cpython-38.pyc,,
+html5lib/_inputstream.cpython-38.pyc,,
+html5lib/constants.cpython-38.pyc,,
+html5lib/_trie/_base.cpython-38.pyc,,
+html5lib/treewalkers/dom.cpython-38.pyc,,
+html5lib/_ihatexml.cpython-38.pyc,,
+html5lib/filters/optionaltags.cpython-38.pyc,,
+html5lib/_utils.cpython-38.pyc,,
+html5lib/filters/whitespace.cpython-38.pyc,,
+html5lib-1.0.1.dist-info/INSTALLER,,
+html5lib/treebuilders/etree_lxml.cpython-38.pyc,,
+html5lib/filters/__pycache__,,
+html5lib/filters/alphabeticalattributes.cpython-38.pyc,,
+html5lib/treeadapters/sax.cpython-38.pyc,,
+html5lib/_trie/__pycache__,,
+html5lib/treebuilders/__pycache__,,
+html5lib/_tokenizer.cpython-38.pyc,,
+html5lib/_trie/py.cpython-38.pyc,,
+html5lib/filters/base.cpython-38.pyc,,
+html5lib/__pycache__,,
+html5lib/treebuilders/base.cpython-38.pyc,,
+html5lib/treeadapters/__init__.cpython-38.pyc,,
+html5lib/serializer.cpython-38.pyc,,
+html5lib/treewalkers/__init__.cpython-38.pyc,,
+html5lib/treebuilders/etree.cpython-38.pyc,,
+html5lib-1.0.1.virtualenv,,
+html5lib/filters/sanitizer.cpython-38.pyc,,
+html5lib/treebuilders/dom.cpython-38.pyc,,
+html5lib/treewalkers/etree_lxml.cpython-38.pyc,,
+html5lib/filters/lint.cpython-38.pyc,,
+html5lib/treeadapters/genshi.cpython-38.pyc,,
+html5lib/treeadapters/__pycache__,,
+html5lib-1.0.1.dist-info/__pycache__,,
+html5lib/treewalkers/genshi.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..6bcef8ab7d47003a44d0fbd9588f5eb87747af16
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+html5lib
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib-1.0.1.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba01065ef63abab6c99f002b2187102da2e03080
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/__init__.py
@@ -0,0 +1,35 @@
+"""
+HTML parsing library based on the `WHATWG HTML specification
+<https://whatwg.org/html>`_. The parser is designed to be compatible with
+existing HTML found in the wild and implements well-defined error recovery that
+is largely compatible with modern desktop web browsers.
+
+Example usage::
+
+    import html5lib
+    with open("my_document.html", "rb") as f:
+        tree = html5lib.parse(f)
+
+For convenience, this module re-exports the following names:
+
+* :func:`~.html5parser.parse`
+* :func:`~.html5parser.parseFragment`
+* :class:`~.html5parser.HTMLParser`
+* :func:`~.treebuilders.getTreeBuilder`
+* :func:`~.treewalkers.getTreeWalker`
+* :func:`~.serializer.serialize`
+"""
+
+from __future__ import absolute_import, division, unicode_literals
+
+from .html5parser import HTMLParser, parse, parseFragment
+from .treebuilders import getTreeBuilder
+from .treewalkers import getTreeWalker
+from .serializer import serialize
+
+__all__ = ["HTMLParser", "parse", "parseFragment", "getTreeBuilder",
+           "getTreeWalker", "serialize"]
+
+# this has to be at the top level, see how setup.py parses this
+#: Distribution version number.
+__version__ = "1.0.1"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_ihatexml.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_ihatexml.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c77717bbc02c96907e1ce8c5bd36cc7bbed09cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_ihatexml.py
@@ -0,0 +1,288 @@
+from __future__ import absolute_import, division, unicode_literals
+
+import re
+import warnings
+
+from .constants import DataLossWarning
+
+baseChar = """
+[#x0041-#x005A] | [#x0061-#x007A] | [#x00C0-#x00D6] | [#x00D8-#x00F6] |
+[#x00F8-#x00FF] | [#x0100-#x0131] | [#x0134-#x013E] | [#x0141-#x0148] |
+[#x014A-#x017E] | [#x0180-#x01C3] | [#x01CD-#x01F0] | [#x01F4-#x01F5] |
+[#x01FA-#x0217] | [#x0250-#x02A8] | [#x02BB-#x02C1] | #x0386 |
+[#x0388-#x038A] | #x038C | [#x038E-#x03A1] | [#x03A3-#x03CE] |
+[#x03D0-#x03D6] | #x03DA | #x03DC | #x03DE | #x03E0 | [#x03E2-#x03F3] |
+[#x0401-#x040C] | [#x040E-#x044F] | [#x0451-#x045C] | [#x045E-#x0481] |
+[#x0490-#x04C4] | [#x04C7-#x04C8] | [#x04CB-#x04CC] | [#x04D0-#x04EB] |
+[#x04EE-#x04F5] | [#x04F8-#x04F9] | [#x0531-#x0556] | #x0559 |
+[#x0561-#x0586] | [#x05D0-#x05EA] | [#x05F0-#x05F2] | [#x0621-#x063A] |
+[#x0641-#x064A] | [#x0671-#x06B7] | [#x06BA-#x06BE] | [#x06C0-#x06CE] |
+[#x06D0-#x06D3] | #x06D5 | [#x06E5-#x06E6] | [#x0905-#x0939] | #x093D |
+[#x0958-#x0961] | [#x0985-#x098C] | [#x098F-#x0990] | [#x0993-#x09A8] |
+[#x09AA-#x09B0] | #x09B2 | [#x09B6-#x09B9] | [#x09DC-#x09DD] |
+[#x09DF-#x09E1] | [#x09F0-#x09F1] | [#x0A05-#x0A0A] | [#x0A0F-#x0A10] |
+[#x0A13-#x0A28] | [#x0A2A-#x0A30] | [#x0A32-#x0A33] | [#x0A35-#x0A36] |
+[#x0A38-#x0A39] | [#x0A59-#x0A5C] | #x0A5E | [#x0A72-#x0A74] |
+[#x0A85-#x0A8B] | #x0A8D | [#x0A8F-#x0A91] | [#x0A93-#x0AA8] |
+[#x0AAA-#x0AB0] | [#x0AB2-#x0AB3] | [#x0AB5-#x0AB9] | #x0ABD | #x0AE0 |
+[#x0B05-#x0B0C] | [#x0B0F-#x0B10] | [#x0B13-#x0B28] | [#x0B2A-#x0B30] |
+[#x0B32-#x0B33] | [#x0B36-#x0B39] | #x0B3D | [#x0B5C-#x0B5D] |
+[#x0B5F-#x0B61] | [#x0B85-#x0B8A] | [#x0B8E-#x0B90] | [#x0B92-#x0B95] |
+[#x0B99-#x0B9A] | #x0B9C | [#x0B9E-#x0B9F] | [#x0BA3-#x0BA4] |
+[#x0BA8-#x0BAA] | [#x0BAE-#x0BB5] | [#x0BB7-#x0BB9] | [#x0C05-#x0C0C] |
+[#x0C0E-#x0C10] | [#x0C12-#x0C28] | [#x0C2A-#x0C33] | [#x0C35-#x0C39] |
+[#x0C60-#x0C61] | [#x0C85-#x0C8C] | [#x0C8E-#x0C90] | [#x0C92-#x0CA8] |
+[#x0CAA-#x0CB3] | [#x0CB5-#x0CB9] | #x0CDE | [#x0CE0-#x0CE1] |
+[#x0D05-#x0D0C] | [#x0D0E-#x0D10] | [#x0D12-#x0D28] | [#x0D2A-#x0D39] |
+[#x0D60-#x0D61] | [#x0E01-#x0E2E] | #x0E30 | [#x0E32-#x0E33] |
+[#x0E40-#x0E45] | [#x0E81-#x0E82] | #x0E84 | [#x0E87-#x0E88] | #x0E8A |
+#x0E8D | [#x0E94-#x0E97] | [#x0E99-#x0E9F] | [#x0EA1-#x0EA3] | #x0EA5 |
+#x0EA7 | [#x0EAA-#x0EAB] | [#x0EAD-#x0EAE] | #x0EB0 | [#x0EB2-#x0EB3] |
+#x0EBD | [#x0EC0-#x0EC4] | [#x0F40-#x0F47] | [#x0F49-#x0F69] |
+[#x10A0-#x10C5] | [#x10D0-#x10F6] | #x1100 | [#x1102-#x1103] |
+[#x1105-#x1107] | #x1109 | [#x110B-#x110C] | [#x110E-#x1112] | #x113C |
+#x113E | #x1140 | #x114C | #x114E | #x1150 | [#x1154-#x1155] | #x1159 |
+[#x115F-#x1161] | #x1163 | #x1165 | #x1167 | #x1169 | [#x116D-#x116E] |
+[#x1172-#x1173] | #x1175 | #x119E | #x11A8 | #x11AB | [#x11AE-#x11AF] |
+[#x11B7-#x11B8] | #x11BA | [#x11BC-#x11C2] | #x11EB | #x11F0 | #x11F9 |
+[#x1E00-#x1E9B] | [#x1EA0-#x1EF9] | [#x1F00-#x1F15] | [#x1F18-#x1F1D] |
+[#x1F20-#x1F45] | [#x1F48-#x1F4D] | [#x1F50-#x1F57] | #x1F59 | #x1F5B |
+#x1F5D | [#x1F5F-#x1F7D] | [#x1F80-#x1FB4] | [#x1FB6-#x1FBC] | #x1FBE |
+[#x1FC2-#x1FC4] | [#x1FC6-#x1FCC] | [#x1FD0-#x1FD3] | [#x1FD6-#x1FDB] |
+[#x1FE0-#x1FEC] | [#x1FF2-#x1FF4] | [#x1FF6-#x1FFC] | #x2126 |
+[#x212A-#x212B] | #x212E | [#x2180-#x2182] | [#x3041-#x3094] |
+[#x30A1-#x30FA] | [#x3105-#x312C] | [#xAC00-#xD7A3]"""
+
+ideographic = """[#x4E00-#x9FA5] | #x3007 | [#x3021-#x3029]"""
+
+combiningCharacter = """
+[#x0300-#x0345] | [#x0360-#x0361] | [#x0483-#x0486] | [#x0591-#x05A1] |
+[#x05A3-#x05B9] | [#x05BB-#x05BD] | #x05BF | [#x05C1-#x05C2] | #x05C4 |
+[#x064B-#x0652] | #x0670 | [#x06D6-#x06DC] | [#x06DD-#x06DF] |
+[#x06E0-#x06E4] | [#x06E7-#x06E8] | [#x06EA-#x06ED] | [#x0901-#x0903] |
+#x093C | [#x093E-#x094C] | #x094D | [#x0951-#x0954] | [#x0962-#x0963] |
+[#x0981-#x0983] | #x09BC | #x09BE | #x09BF | [#x09C0-#x09C4] |
+[#x09C7-#x09C8] | [#x09CB-#x09CD] | #x09D7 | [#x09E2-#x09E3] | #x0A02 |
+#x0A3C | #x0A3E | #x0A3F | [#x0A40-#x0A42] | [#x0A47-#x0A48] |
+[#x0A4B-#x0A4D] | [#x0A70-#x0A71] | [#x0A81-#x0A83] | #x0ABC |
+[#x0ABE-#x0AC5] | [#x0AC7-#x0AC9] | [#x0ACB-#x0ACD] | [#x0B01-#x0B03] |
+#x0B3C | [#x0B3E-#x0B43] | [#x0B47-#x0B48] | [#x0B4B-#x0B4D] |
+[#x0B56-#x0B57] | [#x0B82-#x0B83] | [#x0BBE-#x0BC2] | [#x0BC6-#x0BC8] |
+[#x0BCA-#x0BCD] | #x0BD7 | [#x0C01-#x0C03] | [#x0C3E-#x0C44] |
+[#x0C46-#x0C48] | [#x0C4A-#x0C4D] | [#x0C55-#x0C56] | [#x0C82-#x0C83] |
+[#x0CBE-#x0CC4] | [#x0CC6-#x0CC8] | [#x0CCA-#x0CCD] | [#x0CD5-#x0CD6] |
+[#x0D02-#x0D03] | [#x0D3E-#x0D43] | [#x0D46-#x0D48] | [#x0D4A-#x0D4D] |
+#x0D57 | #x0E31 | [#x0E34-#x0E3A] | [#x0E47-#x0E4E] | #x0EB1 |
+[#x0EB4-#x0EB9] | [#x0EBB-#x0EBC] | [#x0EC8-#x0ECD] | [#x0F18-#x0F19] |
+#x0F35 | #x0F37 | #x0F39 | #x0F3E | #x0F3F | [#x0F71-#x0F84] |
+[#x0F86-#x0F8B] | [#x0F90-#x0F95] | #x0F97 | [#x0F99-#x0FAD] |
+[#x0FB1-#x0FB7] | #x0FB9 | [#x20D0-#x20DC] | #x20E1 | [#x302A-#x302F] |
+#x3099 | #x309A"""
+
+digit = """
+[#x0030-#x0039] | [#x0660-#x0669] | [#x06F0-#x06F9] | [#x0966-#x096F] |
+[#x09E6-#x09EF] | [#x0A66-#x0A6F] | [#x0AE6-#x0AEF] | [#x0B66-#x0B6F] |
+[#x0BE7-#x0BEF] | [#x0C66-#x0C6F] | [#x0CE6-#x0CEF] | [#x0D66-#x0D6F] |
+[#x0E50-#x0E59] | [#x0ED0-#x0ED9] | [#x0F20-#x0F29]"""
+
+extender = """
+#x00B7 | #x02D0 | #x02D1 | #x0387 | #x0640 | #x0E46 | #x0EC6 | #x3005 |
+#[#x3031-#x3035] | [#x309D-#x309E] | [#x30FC-#x30FE]"""
+
+letter = " | ".join([baseChar, ideographic])
+
+# Without the
+name = " | ".join([letter, digit, ".", "-", "_", combiningCharacter,
+                   extender])
+nameFirst = " | ".join([letter, "_"])
+
+reChar = re.compile(r"#x([\d|A-F]{4,4})")
+reCharRange = re.compile(r"\[#x([\d|A-F]{4,4})-#x([\d|A-F]{4,4})\]")
+
+
+def charStringToList(chars):
+    charRanges = [item.strip() for item in chars.split(" | ")]
+    rv = []
+    for item in charRanges:
+        foundMatch = False
+        for regexp in (reChar, reCharRange):
+            match = regexp.match(item)
+            if match is not None:
+                rv.append([hexToInt(item) for item in match.groups()])
+                if len(rv[-1]) == 1:
+                    rv[-1] = rv[-1] * 2
+                foundMatch = True
+                break
+        if not foundMatch:
+            assert len(item) == 1
+
+            rv.append([ord(item)] * 2)
+    rv = normaliseCharList(rv)
+    return rv
+
+
+def normaliseCharList(charList):
+    charList = sorted(charList)
+    for item in charList:
+        assert item[1] >= item[0]
+    rv = []
+    i = 0
+    while i < len(charList):
+        j = 1
+        rv.append(charList[i])
+        while i + j < len(charList) and charList[i + j][0] <= rv[-1][1] + 1:
+            rv[-1][1] = charList[i + j][1]
+            j += 1
+        i += j
+    return rv
+
+# We don't really support characters above the BMP :(
+max_unicode = int("FFFF", 16)
+
+
+def missingRanges(charList):
+    rv = []
+    if charList[0] != 0:
+        rv.append([0, charList[0][0] - 1])
+    for i, item in enumerate(charList[:-1]):
+        rv.append([item[1] + 1, charList[i + 1][0] - 1])
+    if charList[-1][1] != max_unicode:
+        rv.append([charList[-1][1] + 1, max_unicode])
+    return rv
+
+
+def listToRegexpStr(charList):
+    rv = []
+    for item in charList:
+        if item[0] == item[1]:
+            rv.append(escapeRegexp(chr(item[0])))
+        else:
+            rv.append(escapeRegexp(chr(item[0])) + "-" +
+                      escapeRegexp(chr(item[1])))
+    return "[%s]" % "".join(rv)
+
+
+def hexToInt(hex_str):
+    return int(hex_str, 16)
+
+
+def escapeRegexp(string):
+    specialCharacters = (".", "^", "$", "*", "+", "?", "{", "}",
+                         "[", "]", "|", "(", ")", "-")
+    for char in specialCharacters:
+        string = string.replace(char, "\\" + char)
+
+    return string
+
+# output from the above
+nonXmlNameBMPRegexp = re.compile('[\x00-,/:-@\\[-\\^`\\{-\xb6\xb8-\xbf\xd7\xf7\u0132-\u0133\u013f-\u0140\u0149\u017f\u01c4-\u01cc\u01f1-\u01f3\u01f6-\u01f9\u0218-\u024f\u02a9-\u02ba\u02c2-\u02cf\u02d2-\u02ff\u0346-\u035f\u0362-\u0385\u038b\u038d\u03a2\u03cf\u03d7-\u03d9\u03db\u03dd\u03df\u03e1\u03f4-\u0400\u040d\u0450\u045d\u0482\u0487-\u048f\u04c5-\u04c6\u04c9-\u04ca\u04cd-\u04cf\u04ec-\u04ed\u04f6-\u04f7\u04fa-\u0530\u0557-\u0558\u055a-\u0560\u0587-\u0590\u05a2\u05ba\u05be\u05c0\u05c3\u05c5-\u05cf\u05eb-\u05ef\u05f3-\u0620\u063b-\u063f\u0653-\u065f\u066a-\u066f\u06b8-\u06b9\u06bf\u06cf\u06d4\u06e9\u06ee-\u06ef\u06fa-\u0900\u0904\u093a-\u093b\u094e-\u0950\u0955-\u0957\u0964-\u0965\u0970-\u0980\u0984\u098d-\u098e\u0991-\u0992\u09a9\u09b1\u09b3-\u09b5\u09ba-\u09bb\u09bd\u09c5-\u09c6\u09c9-\u09ca\u09ce-\u09d6\u09d8-\u09db\u09de\u09e4-\u09e5\u09f2-\u0a01\u0a03-\u0a04\u0a0b-\u0a0e\u0a11-\u0a12\u0a29\u0a31\u0a34\u0a37\u0a3a-\u0a3b\u0a3d\u0a43-\u0a46\u0a49-\u0a4a\u0a4e-\u0a58\u0a5d\u0a5f-\u0a65\u0a75-\u0a80\u0a84\u0a8c\u0a8e\u0a92\u0aa9\u0ab1\u0ab4\u0aba-\u0abb\u0ac6\u0aca\u0ace-\u0adf\u0ae1-\u0ae5\u0af0-\u0b00\u0b04\u0b0d-\u0b0e\u0b11-\u0b12\u0b29\u0b31\u0b34-\u0b35\u0b3a-\u0b3b\u0b44-\u0b46\u0b49-\u0b4a\u0b4e-\u0b55\u0b58-\u0b5b\u0b5e\u0b62-\u0b65\u0b70-\u0b81\u0b84\u0b8b-\u0b8d\u0b91\u0b96-\u0b98\u0b9b\u0b9d\u0ba0-\u0ba2\u0ba5-\u0ba7\u0bab-\u0bad\u0bb6\u0bba-\u0bbd\u0bc3-\u0bc5\u0bc9\u0bce-\u0bd6\u0bd8-\u0be6\u0bf0-\u0c00\u0c04\u0c0d\u0c11\u0c29\u0c34\u0c3a-\u0c3d\u0c45\u0c49\u0c4e-\u0c54\u0c57-\u0c5f\u0c62-\u0c65\u0c70-\u0c81\u0c84\u0c8d\u0c91\u0ca9\u0cb4\u0cba-\u0cbd\u0cc5\u0cc9\u0cce-\u0cd4\u0cd7-\u0cdd\u0cdf\u0ce2-\u0ce5\u0cf0-\u0d01\u0d04\u0d0d\u0d11\u0d29\u0d3a-\u0d3d\u0d44-\u0d45\u0d49\u0d4e-\u0d56\u0d58-\u0d5f\u0d62-\u0d65\u0d70-\u0e00\u0e2f\u0e3b-\u0e3f\u0e4f\u0e5a-\u0e80\u0e83\u0e85-\u0e86\u0e89\u0e8b-\u0e8c\u0e8e-\u0e93\u0e98\u0ea0\u0ea4\u0ea6\u0ea8-\u0ea9\u0eac\u0eaf\u0eba\u0ebe-\u0ebf\u0ec5\u0ec7\u0ece-\u0ecf\u0eda-\u0f17\u0f1a-\u0f1f\u0f2a-\u0f34\u0f36\u0f38\u0f3a-\u0f3d\u0f48\u0f6a-\u0f70\u0f85\u0f8c-\u0f8f\u0f96\u0f98\u0fae-\u0fb0\u0fb8\u0fba-\u109f\u10c6-\u10cf\u10f7-\u10ff\u1101\u1104\u1108\u110a\u110d\u1113-\u113b\u113d\u113f\u1141-\u114b\u114d\u114f\u1151-\u1153\u1156-\u1158\u115a-\u115e\u1162\u1164\u1166\u1168\u116a-\u116c\u116f-\u1171\u1174\u1176-\u119d\u119f-\u11a7\u11a9-\u11aa\u11ac-\u11ad\u11b0-\u11b6\u11b9\u11bb\u11c3-\u11ea\u11ec-\u11ef\u11f1-\u11f8\u11fa-\u1dff\u1e9c-\u1e9f\u1efa-\u1eff\u1f16-\u1f17\u1f1e-\u1f1f\u1f46-\u1f47\u1f4e-\u1f4f\u1f58\u1f5a\u1f5c\u1f5e\u1f7e-\u1f7f\u1fb5\u1fbd\u1fbf-\u1fc1\u1fc5\u1fcd-\u1fcf\u1fd4-\u1fd5\u1fdc-\u1fdf\u1fed-\u1ff1\u1ff5\u1ffd-\u20cf\u20dd-\u20e0\u20e2-\u2125\u2127-\u2129\u212c-\u212d\u212f-\u217f\u2183-\u3004\u3006\u3008-\u3020\u3030\u3036-\u3040\u3095-\u3098\u309b-\u309c\u309f-\u30a0\u30fb\u30ff-\u3104\u312d-\u4dff\u9fa6-\uabff\ud7a4-\uffff]')  # noqa
+
+nonXmlNameFirstBMPRegexp = re.compile('[\x00-@\\[-\\^`\\{-\xbf\xd7\xf7\u0132-\u0133\u013f-\u0140\u0149\u017f\u01c4-\u01cc\u01f1-\u01f3\u01f6-\u01f9\u0218-\u024f\u02a9-\u02ba\u02c2-\u0385\u0387\u038b\u038d\u03a2\u03cf\u03d7-\u03d9\u03db\u03dd\u03df\u03e1\u03f4-\u0400\u040d\u0450\u045d\u0482-\u048f\u04c5-\u04c6\u04c9-\u04ca\u04cd-\u04cf\u04ec-\u04ed\u04f6-\u04f7\u04fa-\u0530\u0557-\u0558\u055a-\u0560\u0587-\u05cf\u05eb-\u05ef\u05f3-\u0620\u063b-\u0640\u064b-\u0670\u06b8-\u06b9\u06bf\u06cf\u06d4\u06d6-\u06e4\u06e7-\u0904\u093a-\u093c\u093e-\u0957\u0962-\u0984\u098d-\u098e\u0991-\u0992\u09a9\u09b1\u09b3-\u09b5\u09ba-\u09db\u09de\u09e2-\u09ef\u09f2-\u0a04\u0a0b-\u0a0e\u0a11-\u0a12\u0a29\u0a31\u0a34\u0a37\u0a3a-\u0a58\u0a5d\u0a5f-\u0a71\u0a75-\u0a84\u0a8c\u0a8e\u0a92\u0aa9\u0ab1\u0ab4\u0aba-\u0abc\u0abe-\u0adf\u0ae1-\u0b04\u0b0d-\u0b0e\u0b11-\u0b12\u0b29\u0b31\u0b34-\u0b35\u0b3a-\u0b3c\u0b3e-\u0b5b\u0b5e\u0b62-\u0b84\u0b8b-\u0b8d\u0b91\u0b96-\u0b98\u0b9b\u0b9d\u0ba0-\u0ba2\u0ba5-\u0ba7\u0bab-\u0bad\u0bb6\u0bba-\u0c04\u0c0d\u0c11\u0c29\u0c34\u0c3a-\u0c5f\u0c62-\u0c84\u0c8d\u0c91\u0ca9\u0cb4\u0cba-\u0cdd\u0cdf\u0ce2-\u0d04\u0d0d\u0d11\u0d29\u0d3a-\u0d5f\u0d62-\u0e00\u0e2f\u0e31\u0e34-\u0e3f\u0e46-\u0e80\u0e83\u0e85-\u0e86\u0e89\u0e8b-\u0e8c\u0e8e-\u0e93\u0e98\u0ea0\u0ea4\u0ea6\u0ea8-\u0ea9\u0eac\u0eaf\u0eb1\u0eb4-\u0ebc\u0ebe-\u0ebf\u0ec5-\u0f3f\u0f48\u0f6a-\u109f\u10c6-\u10cf\u10f7-\u10ff\u1101\u1104\u1108\u110a\u110d\u1113-\u113b\u113d\u113f\u1141-\u114b\u114d\u114f\u1151-\u1153\u1156-\u1158\u115a-\u115e\u1162\u1164\u1166\u1168\u116a-\u116c\u116f-\u1171\u1174\u1176-\u119d\u119f-\u11a7\u11a9-\u11aa\u11ac-\u11ad\u11b0-\u11b6\u11b9\u11bb\u11c3-\u11ea\u11ec-\u11ef\u11f1-\u11f8\u11fa-\u1dff\u1e9c-\u1e9f\u1efa-\u1eff\u1f16-\u1f17\u1f1e-\u1f1f\u1f46-\u1f47\u1f4e-\u1f4f\u1f58\u1f5a\u1f5c\u1f5e\u1f7e-\u1f7f\u1fb5\u1fbd\u1fbf-\u1fc1\u1fc5\u1fcd-\u1fcf\u1fd4-\u1fd5\u1fdc-\u1fdf\u1fed-\u1ff1\u1ff5\u1ffd-\u2125\u2127-\u2129\u212c-\u212d\u212f-\u217f\u2183-\u3006\u3008-\u3020\u302a-\u3040\u3095-\u30a0\u30fb-\u3104\u312d-\u4dff\u9fa6-\uabff\ud7a4-\uffff]')  # noqa
+
+# Simpler things
+nonPubidCharRegexp = re.compile("[^\x20\x0D\x0Aa-zA-Z0-9\\-'()+,./:=?;!*#@$_%]")
+
+
+class InfosetFilter(object):
+    replacementRegexp = re.compile(r"U[\dA-F]{5,5}")
+
+    def __init__(self,
+                 dropXmlnsLocalName=False,
+                 dropXmlnsAttrNs=False,
+                 preventDoubleDashComments=False,
+                 preventDashAtCommentEnd=False,
+                 replaceFormFeedCharacters=True,
+                 preventSingleQuotePubid=False):
+
+        self.dropXmlnsLocalName = dropXmlnsLocalName
+        self.dropXmlnsAttrNs = dropXmlnsAttrNs
+
+        self.preventDoubleDashComments = preventDoubleDashComments
+        self.preventDashAtCommentEnd = preventDashAtCommentEnd
+
+        self.replaceFormFeedCharacters = replaceFormFeedCharacters
+
+        self.preventSingleQuotePubid = preventSingleQuotePubid
+
+        self.replaceCache = {}
+
+    def coerceAttribute(self, name, namespace=None):
+        if self.dropXmlnsLocalName and name.startswith("xmlns:"):
+            warnings.warn("Attributes cannot begin with xmlns", DataLossWarning)
+            return None
+        elif (self.dropXmlnsAttrNs and
+              namespace == "http://www.w3.org/2000/xmlns/"):
+            warnings.warn("Attributes cannot be in the xml namespace", DataLossWarning)
+            return None
+        else:
+            return self.toXmlName(name)
+
+    def coerceElement(self, name):
+        return self.toXmlName(name)
+
+    def coerceComment(self, data):
+        if self.preventDoubleDashComments:
+            while "--" in data:
+                warnings.warn("Comments cannot contain adjacent dashes", DataLossWarning)
+                data = data.replace("--", "- -")
+            if data.endswith("-"):
+                warnings.warn("Comments cannot end in a dash", DataLossWarning)
+                data += " "
+        return data
+
+    def coerceCharacters(self, data):
+        if self.replaceFormFeedCharacters:
+            for _ in range(data.count("\x0C")):
+                warnings.warn("Text cannot contain U+000C", DataLossWarning)
+            data = data.replace("\x0C", " ")
+        # Other non-xml characters
+        return data
+
+    def coercePubid(self, data):
+        dataOutput = data
+        for char in nonPubidCharRegexp.findall(data):
+            warnings.warn("Coercing non-XML pubid", DataLossWarning)
+            replacement = self.getReplacementCharacter(char)
+            dataOutput = dataOutput.replace(char, replacement)
+        if self.preventSingleQuotePubid and dataOutput.find("'") >= 0:
+            warnings.warn("Pubid cannot contain single quote", DataLossWarning)
+            dataOutput = dataOutput.replace("'", self.getReplacementCharacter("'"))
+        return dataOutput
+
+    def toXmlName(self, name):
+        nameFirst = name[0]
+        nameRest = name[1:]
+        m = nonXmlNameFirstBMPRegexp.match(nameFirst)
+        if m:
+            warnings.warn("Coercing non-XML name", DataLossWarning)
+            nameFirstOutput = self.getReplacementCharacter(nameFirst)
+        else:
+            nameFirstOutput = nameFirst
+
+        nameRestOutput = nameRest
+        replaceChars = set(nonXmlNameBMPRegexp.findall(nameRest))
+        for char in replaceChars:
+            warnings.warn("Coercing non-XML name", DataLossWarning)
+            replacement = self.getReplacementCharacter(char)
+            nameRestOutput = nameRestOutput.replace(char, replacement)
+        return nameFirstOutput + nameRestOutput
+
+    def getReplacementCharacter(self, char):
+        if char in self.replaceCache:
+            replacement = self.replaceCache[char]
+        else:
+            replacement = self.escapeChar(char)
+        return replacement
+
+    def fromXmlName(self, name):
+        for item in set(self.replacementRegexp.findall(name)):
+            name = name.replace(item, self.unescapeChar(item))
+        return name
+
+    def escapeChar(self, char):
+        replacement = "U%05X" % ord(char)
+        self.replaceCache[char] = replacement
+        return replacement
+
+    def unescapeChar(self, charcode):
+        return chr(int(charcode[1:], 16))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_inputstream.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_inputstream.py
new file mode 100644
index 0000000000000000000000000000000000000000..177f0ab9ee3498d2c81808ff64bffc12e21a2bff
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_inputstream.py
@@ -0,0 +1,923 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from six import text_type, binary_type
+from six.moves import http_client, urllib
+
+import codecs
+import re
+
+import webencodings
+
+from .constants import EOF, spaceCharacters, asciiLetters, asciiUppercase
+from .constants import _ReparseException
+from . import _utils
+
+from io import StringIO
+
+try:
+    from io import BytesIO
+except ImportError:
+    BytesIO = StringIO
+
+# Non-unicode versions of constants for use in the pre-parser
+spaceCharactersBytes = frozenset([item.encode("ascii") for item in spaceCharacters])
+asciiLettersBytes = frozenset([item.encode("ascii") for item in asciiLetters])
+asciiUppercaseBytes = frozenset([item.encode("ascii") for item in asciiUppercase])
+spacesAngleBrackets = spaceCharactersBytes | frozenset([b">", b"<"])
+
+
+invalid_unicode_no_surrogate = "[\u0001-\u0008\u000B\u000E-\u001F\u007F-\u009F\uFDD0-\uFDEF\uFFFE\uFFFF\U0001FFFE\U0001FFFF\U0002FFFE\U0002FFFF\U0003FFFE\U0003FFFF\U0004FFFE\U0004FFFF\U0005FFFE\U0005FFFF\U0006FFFE\U0006FFFF\U0007FFFE\U0007FFFF\U0008FFFE\U0008FFFF\U0009FFFE\U0009FFFF\U000AFFFE\U000AFFFF\U000BFFFE\U000BFFFF\U000CFFFE\U000CFFFF\U000DFFFE\U000DFFFF\U000EFFFE\U000EFFFF\U000FFFFE\U000FFFFF\U0010FFFE\U0010FFFF]"  # noqa
+
+if _utils.supports_lone_surrogates:
+    # Use one extra step of indirection and create surrogates with
+    # eval. Not using this indirection would introduce an illegal
+    # unicode literal on platforms not supporting such lone
+    # surrogates.
+    assert invalid_unicode_no_surrogate[-1] == "]" and invalid_unicode_no_surrogate.count("]") == 1
+    invalid_unicode_re = re.compile(invalid_unicode_no_surrogate[:-1] +
+                                    eval('"\\uD800-\\uDFFF"') +  # pylint:disable=eval-used
+                                    "]")
+else:
+    invalid_unicode_re = re.compile(invalid_unicode_no_surrogate)
+
+non_bmp_invalid_codepoints = set([0x1FFFE, 0x1FFFF, 0x2FFFE, 0x2FFFF, 0x3FFFE,
+                                  0x3FFFF, 0x4FFFE, 0x4FFFF, 0x5FFFE, 0x5FFFF,
+                                  0x6FFFE, 0x6FFFF, 0x7FFFE, 0x7FFFF, 0x8FFFE,
+                                  0x8FFFF, 0x9FFFE, 0x9FFFF, 0xAFFFE, 0xAFFFF,
+                                  0xBFFFE, 0xBFFFF, 0xCFFFE, 0xCFFFF, 0xDFFFE,
+                                  0xDFFFF, 0xEFFFE, 0xEFFFF, 0xFFFFE, 0xFFFFF,
+                                  0x10FFFE, 0x10FFFF])
+
+ascii_punctuation_re = re.compile("[\u0009-\u000D\u0020-\u002F\u003A-\u0040\u005C\u005B-\u0060\u007B-\u007E]")
+
+# Cache for charsUntil()
+charsUntilRegEx = {}
+
+
+class BufferedStream(object):
+    """Buffering for streams that do not have buffering of their own
+
+    The buffer is implemented as a list of chunks on the assumption that
+    joining many strings will be slow since it is O(n**2)
+    """
+
+    def __init__(self, stream):
+        self.stream = stream
+        self.buffer = []
+        self.position = [-1, 0]  # chunk number, offset
+
+    def tell(self):
+        pos = 0
+        for chunk in self.buffer[:self.position[0]]:
+            pos += len(chunk)
+        pos += self.position[1]
+        return pos
+
+    def seek(self, pos):
+        assert pos <= self._bufferedBytes()
+        offset = pos
+        i = 0
+        while len(self.buffer[i]) < offset:
+            offset -= len(self.buffer[i])
+            i += 1
+        self.position = [i, offset]
+
+    def read(self, bytes):
+        if not self.buffer:
+            return self._readStream(bytes)
+        elif (self.position[0] == len(self.buffer) and
+              self.position[1] == len(self.buffer[-1])):
+            return self._readStream(bytes)
+        else:
+            return self._readFromBuffer(bytes)
+
+    def _bufferedBytes(self):
+        return sum([len(item) for item in self.buffer])
+
+    def _readStream(self, bytes):
+        data = self.stream.read(bytes)
+        self.buffer.append(data)
+        self.position[0] += 1
+        self.position[1] = len(data)
+        return data
+
+    def _readFromBuffer(self, bytes):
+        remainingBytes = bytes
+        rv = []
+        bufferIndex = self.position[0]
+        bufferOffset = self.position[1]
+        while bufferIndex < len(self.buffer) and remainingBytes != 0:
+            assert remainingBytes > 0
+            bufferedData = self.buffer[bufferIndex]
+
+            if remainingBytes <= len(bufferedData) - bufferOffset:
+                bytesToRead = remainingBytes
+                self.position = [bufferIndex, bufferOffset + bytesToRead]
+            else:
+                bytesToRead = len(bufferedData) - bufferOffset
+                self.position = [bufferIndex, len(bufferedData)]
+                bufferIndex += 1
+            rv.append(bufferedData[bufferOffset:bufferOffset + bytesToRead])
+            remainingBytes -= bytesToRead
+
+            bufferOffset = 0
+
+        if remainingBytes:
+            rv.append(self._readStream(remainingBytes))
+
+        return b"".join(rv)
+
+
+def HTMLInputStream(source, **kwargs):
+    # Work around Python bug #20007: read(0) closes the connection.
+    # http://bugs.python.org/issue20007
+    if (isinstance(source, http_client.HTTPResponse) or
+        # Also check for addinfourl wrapping HTTPResponse
+        (isinstance(source, urllib.response.addbase) and
+         isinstance(source.fp, http_client.HTTPResponse))):
+        isUnicode = False
+    elif hasattr(source, "read"):
+        isUnicode = isinstance(source.read(0), text_type)
+    else:
+        isUnicode = isinstance(source, text_type)
+
+    if isUnicode:
+        encodings = [x for x in kwargs if x.endswith("_encoding")]
+        if encodings:
+            raise TypeError("Cannot set an encoding with a unicode input, set %r" % encodings)
+
+        return HTMLUnicodeInputStream(source, **kwargs)
+    else:
+        return HTMLBinaryInputStream(source, **kwargs)
+
+
+class HTMLUnicodeInputStream(object):
+    """Provides a unicode stream of characters to the HTMLTokenizer.
+
+    This class takes care of character encoding and removing or replacing
+    incorrect byte-sequences and also provides column and line tracking.
+
+    """
+
+    _defaultChunkSize = 10240
+
+    def __init__(self, source):
+        """Initialises the HTMLInputStream.
+
+        HTMLInputStream(source, [encoding]) -> Normalized stream from source
+        for use by html5lib.
+
+        source can be either a file-object, local filename or a string.
+
+        The optional encoding parameter must be a string that indicates
+        the encoding.  If specified, that encoding will be used,
+        regardless of any BOM or later declaration (such as in a meta
+        element)
+
+        """
+
+        if not _utils.supports_lone_surrogates:
+            # Such platforms will have already checked for such
+            # surrogate errors, so no need to do this checking.
+            self.reportCharacterErrors = None
+        elif len("\U0010FFFF") == 1:
+            self.reportCharacterErrors = self.characterErrorsUCS4
+        else:
+            self.reportCharacterErrors = self.characterErrorsUCS2
+
+        # List of where new lines occur
+        self.newLines = [0]
+
+        self.charEncoding = (lookupEncoding("utf-8"), "certain")
+        self.dataStream = self.openStream(source)
+
+        self.reset()
+
+    def reset(self):
+        self.chunk = ""
+        self.chunkSize = 0
+        self.chunkOffset = 0
+        self.errors = []
+
+        # number of (complete) lines in previous chunks
+        self.prevNumLines = 0
+        # number of columns in the last line of the previous chunk
+        self.prevNumCols = 0
+
+        # Deal with CR LF and surrogates split over chunk boundaries
+        self._bufferedCharacter = None
+
+    def openStream(self, source):
+        """Produces a file object from source.
+
+        source can be either a file object, local filename or a string.
+
+        """
+        # Already a file object
+        if hasattr(source, 'read'):
+            stream = source
+        else:
+            stream = StringIO(source)
+
+        return stream
+
+    def _position(self, offset):
+        chunk = self.chunk
+        nLines = chunk.count('\n', 0, offset)
+        positionLine = self.prevNumLines + nLines
+        lastLinePos = chunk.rfind('\n', 0, offset)
+        if lastLinePos == -1:
+            positionColumn = self.prevNumCols + offset
+        else:
+            positionColumn = offset - (lastLinePos + 1)
+        return (positionLine, positionColumn)
+
+    def position(self):
+        """Returns (line, col) of the current position in the stream."""
+        line, col = self._position(self.chunkOffset)
+        return (line + 1, col)
+
+    def char(self):
+        """ Read one character from the stream or queue if available. Return
+            EOF when EOF is reached.
+        """
+        # Read a new chunk from the input stream if necessary
+        if self.chunkOffset >= self.chunkSize:
+            if not self.readChunk():
+                return EOF
+
+        chunkOffset = self.chunkOffset
+        char = self.chunk[chunkOffset]
+        self.chunkOffset = chunkOffset + 1
+
+        return char
+
+    def readChunk(self, chunkSize=None):
+        if chunkSize is None:
+            chunkSize = self._defaultChunkSize
+
+        self.prevNumLines, self.prevNumCols = self._position(self.chunkSize)
+
+        self.chunk = ""
+        self.chunkSize = 0
+        self.chunkOffset = 0
+
+        data = self.dataStream.read(chunkSize)
+
+        # Deal with CR LF and surrogates broken across chunks
+        if self._bufferedCharacter:
+            data = self._bufferedCharacter + data
+            self._bufferedCharacter = None
+        elif not data:
+            # We have no more data, bye-bye stream
+            return False
+
+        if len(data) > 1:
+            lastv = ord(data[-1])
+            if lastv == 0x0D or 0xD800 <= lastv <= 0xDBFF:
+                self._bufferedCharacter = data[-1]
+                data = data[:-1]
+
+        if self.reportCharacterErrors:
+            self.reportCharacterErrors(data)
+
+        # Replace invalid characters
+        data = data.replace("\r\n", "\n")
+        data = data.replace("\r", "\n")
+
+        self.chunk = data
+        self.chunkSize = len(data)
+
+        return True
+
+    def characterErrorsUCS4(self, data):
+        for _ in range(len(invalid_unicode_re.findall(data))):
+            self.errors.append("invalid-codepoint")
+
+    def characterErrorsUCS2(self, data):
+        # Someone picked the wrong compile option
+        # You lose
+        skip = False
+        for match in invalid_unicode_re.finditer(data):
+            if skip:
+                continue
+            codepoint = ord(match.group())
+            pos = match.start()
+            # Pretty sure there should be endianness issues here
+            if _utils.isSurrogatePair(data[pos:pos + 2]):
+                # We have a surrogate pair!
+                char_val = _utils.surrogatePairToCodepoint(data[pos:pos + 2])
+                if char_val in non_bmp_invalid_codepoints:
+                    self.errors.append("invalid-codepoint")
+                skip = True
+            elif (codepoint >= 0xD800 and codepoint <= 0xDFFF and
+                  pos == len(data) - 1):
+                self.errors.append("invalid-codepoint")
+            else:
+                skip = False
+                self.errors.append("invalid-codepoint")
+
+    def charsUntil(self, characters, opposite=False):
+        """ Returns a string of characters from the stream up to but not
+        including any character in 'characters' or EOF. 'characters' must be
+        a container that supports the 'in' method and iteration over its
+        characters.
+        """
+
+        # Use a cache of regexps to find the required characters
+        try:
+            chars = charsUntilRegEx[(characters, opposite)]
+        except KeyError:
+            if __debug__:
+                for c in characters:
+                    assert(ord(c) < 128)
+            regex = "".join(["\\x%02x" % ord(c) for c in characters])
+            if not opposite:
+                regex = "^%s" % regex
+            chars = charsUntilRegEx[(characters, opposite)] = re.compile("[%s]+" % regex)
+
+        rv = []
+
+        while True:
+            # Find the longest matching prefix
+            m = chars.match(self.chunk, self.chunkOffset)
+            if m is None:
+                # If nothing matched, and it wasn't because we ran out of chunk,
+                # then stop
+                if self.chunkOffset != self.chunkSize:
+                    break
+            else:
+                end = m.end()
+                # If not the whole chunk matched, return everything
+                # up to the part that didn't match
+                if end != self.chunkSize:
+                    rv.append(self.chunk[self.chunkOffset:end])
+                    self.chunkOffset = end
+                    break
+            # If the whole remainder of the chunk matched,
+            # use it all and read the next chunk
+            rv.append(self.chunk[self.chunkOffset:])
+            if not self.readChunk():
+                # Reached EOF
+                break
+
+        r = "".join(rv)
+        return r
+
+    def unget(self, char):
+        # Only one character is allowed to be ungotten at once - it must
+        # be consumed again before any further call to unget
+        if char is not None:
+            if self.chunkOffset == 0:
+                # unget is called quite rarely, so it's a good idea to do
+                # more work here if it saves a bit of work in the frequently
+                # called char and charsUntil.
+                # So, just prepend the ungotten character onto the current
+                # chunk:
+                self.chunk = char + self.chunk
+                self.chunkSize += 1
+            else:
+                self.chunkOffset -= 1
+                assert self.chunk[self.chunkOffset] == char
+
+
+class HTMLBinaryInputStream(HTMLUnicodeInputStream):
+    """Provides a unicode stream of characters to the HTMLTokenizer.
+
+    This class takes care of character encoding and removing or replacing
+    incorrect byte-sequences and also provides column and line tracking.
+
+    """
+
+    def __init__(self, source, override_encoding=None, transport_encoding=None,
+                 same_origin_parent_encoding=None, likely_encoding=None,
+                 default_encoding="windows-1252", useChardet=True):
+        """Initialises the HTMLInputStream.
+
+        HTMLInputStream(source, [encoding]) -> Normalized stream from source
+        for use by html5lib.
+
+        source can be either a file-object, local filename or a string.
+
+        The optional encoding parameter must be a string that indicates
+        the encoding.  If specified, that encoding will be used,
+        regardless of any BOM or later declaration (such as in a meta
+        element)
+
+        """
+        # Raw Stream - for unicode objects this will encode to utf-8 and set
+        #              self.charEncoding as appropriate
+        self.rawStream = self.openStream(source)
+
+        HTMLUnicodeInputStream.__init__(self, self.rawStream)
+
+        # Encoding Information
+        # Number of bytes to use when looking for a meta element with
+        # encoding information
+        self.numBytesMeta = 1024
+        # Number of bytes to use when using detecting encoding using chardet
+        self.numBytesChardet = 100
+        # Things from args
+        self.override_encoding = override_encoding
+        self.transport_encoding = transport_encoding
+        self.same_origin_parent_encoding = same_origin_parent_encoding
+        self.likely_encoding = likely_encoding
+        self.default_encoding = default_encoding
+
+        # Determine encoding
+        self.charEncoding = self.determineEncoding(useChardet)
+        assert self.charEncoding[0] is not None
+
+        # Call superclass
+        self.reset()
+
+    def reset(self):
+        self.dataStream = self.charEncoding[0].codec_info.streamreader(self.rawStream, 'replace')
+        HTMLUnicodeInputStream.reset(self)
+
+    def openStream(self, source):
+        """Produces a file object from source.
+
+        source can be either a file object, local filename or a string.
+
+        """
+        # Already a file object
+        if hasattr(source, 'read'):
+            stream = source
+        else:
+            stream = BytesIO(source)
+
+        try:
+            stream.seek(stream.tell())
+        except:  # pylint:disable=bare-except
+            stream = BufferedStream(stream)
+
+        return stream
+
+    def determineEncoding(self, chardet=True):
+        # BOMs take precedence over everything
+        # This will also read past the BOM if present
+        charEncoding = self.detectBOM(), "certain"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # If we've been overriden, we've been overriden
+        charEncoding = lookupEncoding(self.override_encoding), "certain"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # Now check the transport layer
+        charEncoding = lookupEncoding(self.transport_encoding), "certain"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # Look for meta elements with encoding information
+        charEncoding = self.detectEncodingMeta(), "tentative"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # Parent document encoding
+        charEncoding = lookupEncoding(self.same_origin_parent_encoding), "tentative"
+        if charEncoding[0] is not None and not charEncoding[0].name.startswith("utf-16"):
+            return charEncoding
+
+        # "likely" encoding
+        charEncoding = lookupEncoding(self.likely_encoding), "tentative"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # Guess with chardet, if available
+        if chardet:
+            try:
+                from chardet.universaldetector import UniversalDetector
+            except ImportError:
+                pass
+            else:
+                buffers = []
+                detector = UniversalDetector()
+                while not detector.done:
+                    buffer = self.rawStream.read(self.numBytesChardet)
+                    assert isinstance(buffer, bytes)
+                    if not buffer:
+                        break
+                    buffers.append(buffer)
+                    detector.feed(buffer)
+                detector.close()
+                encoding = lookupEncoding(detector.result['encoding'])
+                self.rawStream.seek(0)
+                if encoding is not None:
+                    return encoding, "tentative"
+
+        # Try the default encoding
+        charEncoding = lookupEncoding(self.default_encoding), "tentative"
+        if charEncoding[0] is not None:
+            return charEncoding
+
+        # Fallback to html5lib's default if even that hasn't worked
+        return lookupEncoding("windows-1252"), "tentative"
+
+    def changeEncoding(self, newEncoding):
+        assert self.charEncoding[1] != "certain"
+        newEncoding = lookupEncoding(newEncoding)
+        if newEncoding is None:
+            return
+        if newEncoding.name in ("utf-16be", "utf-16le"):
+            newEncoding = lookupEncoding("utf-8")
+            assert newEncoding is not None
+        elif newEncoding == self.charEncoding[0]:
+            self.charEncoding = (self.charEncoding[0], "certain")
+        else:
+            self.rawStream.seek(0)
+            self.charEncoding = (newEncoding, "certain")
+            self.reset()
+            raise _ReparseException("Encoding changed from %s to %s" % (self.charEncoding[0], newEncoding))
+
+    def detectBOM(self):
+        """Attempts to detect at BOM at the start of the stream. If
+        an encoding can be determined from the BOM return the name of the
+        encoding otherwise return None"""
+        bomDict = {
+            codecs.BOM_UTF8: 'utf-8',
+            codecs.BOM_UTF16_LE: 'utf-16le', codecs.BOM_UTF16_BE: 'utf-16be',
+            codecs.BOM_UTF32_LE: 'utf-32le', codecs.BOM_UTF32_BE: 'utf-32be'
+        }
+
+        # Go to beginning of file and read in 4 bytes
+        string = self.rawStream.read(4)
+        assert isinstance(string, bytes)
+
+        # Try detecting the BOM using bytes from the string
+        encoding = bomDict.get(string[:3])         # UTF-8
+        seek = 3
+        if not encoding:
+            # Need to detect UTF-32 before UTF-16
+            encoding = bomDict.get(string)         # UTF-32
+            seek = 4
+            if not encoding:
+                encoding = bomDict.get(string[:2])  # UTF-16
+                seek = 2
+
+        # Set the read position past the BOM if one was found, otherwise
+        # set it to the start of the stream
+        if encoding:
+            self.rawStream.seek(seek)
+            return lookupEncoding(encoding)
+        else:
+            self.rawStream.seek(0)
+            return None
+
+    def detectEncodingMeta(self):
+        """Report the encoding declared by the meta element
+        """
+        buffer = self.rawStream.read(self.numBytesMeta)
+        assert isinstance(buffer, bytes)
+        parser = EncodingParser(buffer)
+        self.rawStream.seek(0)
+        encoding = parser.getEncoding()
+
+        if encoding is not None and encoding.name in ("utf-16be", "utf-16le"):
+            encoding = lookupEncoding("utf-8")
+
+        return encoding
+
+
+class EncodingBytes(bytes):
+    """String-like object with an associated position and various extra methods
+    If the position is ever greater than the string length then an exception is
+    raised"""
+    def __new__(self, value):
+        assert isinstance(value, bytes)
+        return bytes.__new__(self, value.lower())
+
+    def __init__(self, value):
+        # pylint:disable=unused-argument
+        self._position = -1
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        p = self._position = self._position + 1
+        if p >= len(self):
+            raise StopIteration
+        elif p < 0:
+            raise TypeError
+        return self[p:p + 1]
+
+    def next(self):
+        # Py2 compat
+        return self.__next__()
+
+    def previous(self):
+        p = self._position
+        if p >= len(self):
+            raise StopIteration
+        elif p < 0:
+            raise TypeError
+        self._position = p = p - 1
+        return self[p:p + 1]
+
+    def setPosition(self, position):
+        if self._position >= len(self):
+            raise StopIteration
+        self._position = position
+
+    def getPosition(self):
+        if self._position >= len(self):
+            raise StopIteration
+        if self._position >= 0:
+            return self._position
+        else:
+            return None
+
+    position = property(getPosition, setPosition)
+
+    def getCurrentByte(self):
+        return self[self.position:self.position + 1]
+
+    currentByte = property(getCurrentByte)
+
+    def skip(self, chars=spaceCharactersBytes):
+        """Skip past a list of characters"""
+        p = self.position               # use property for the error-checking
+        while p < len(self):
+            c = self[p:p + 1]
+            if c not in chars:
+                self._position = p
+                return c
+            p += 1
+        self._position = p
+        return None
+
+    def skipUntil(self, chars):
+        p = self.position
+        while p < len(self):
+            c = self[p:p + 1]
+            if c in chars:
+                self._position = p
+                return c
+            p += 1
+        self._position = p
+        return None
+
+    def matchBytes(self, bytes):
+        """Look for a sequence of bytes at the start of a string. If the bytes
+        are found return True and advance the position to the byte after the
+        match. Otherwise return False and leave the position alone"""
+        p = self.position
+        data = self[p:p + len(bytes)]
+        rv = data.startswith(bytes)
+        if rv:
+            self.position += len(bytes)
+        return rv
+
+    def jumpTo(self, bytes):
+        """Look for the next sequence of bytes matching a given sequence. If
+        a match is found advance the position to the last byte of the match"""
+        newPosition = self[self.position:].find(bytes)
+        if newPosition > -1:
+            # XXX: This is ugly, but I can't see a nicer way to fix this.
+            if self._position == -1:
+                self._position = 0
+            self._position += (newPosition + len(bytes) - 1)
+            return True
+        else:
+            raise StopIteration
+
+
+class EncodingParser(object):
+    """Mini parser for detecting character encoding from meta elements"""
+
+    def __init__(self, data):
+        """string - the data to work on for encoding detection"""
+        self.data = EncodingBytes(data)
+        self.encoding = None
+
+    def getEncoding(self):
+        methodDispatch = (
+            (b"<!--", self.handleComment),
+            (b"<meta", self.handleMeta),
+            (b"</", self.handlePossibleEndTag),
+            (b"<!", self.handleOther),
+            (b"<?", self.handleOther),
+            (b"<", self.handlePossibleStartTag))
+        for _ in self.data:
+            keepParsing = True
+            for key, method in methodDispatch:
+                if self.data.matchBytes(key):
+                    try:
+                        keepParsing = method()
+                        break
+                    except StopIteration:
+                        keepParsing = False
+                        break
+            if not keepParsing:
+                break
+
+        return self.encoding
+
+    def handleComment(self):
+        """Skip over comments"""
+        return self.data.jumpTo(b"-->")
+
+    def handleMeta(self):
+        if self.data.currentByte not in spaceCharactersBytes:
+            # if we have <meta not followed by a space so just keep going
+            return True
+        # We have a valid meta element we want to search for attributes
+        hasPragma = False
+        pendingEncoding = None
+        while True:
+            # Try to find the next attribute after the current position
+            attr = self.getAttribute()
+            if attr is None:
+                return True
+            else:
+                if attr[0] == b"http-equiv":
+                    hasPragma = attr[1] == b"content-type"
+                    if hasPragma and pendingEncoding is not None:
+                        self.encoding = pendingEncoding
+                        return False
+                elif attr[0] == b"charset":
+                    tentativeEncoding = attr[1]
+                    codec = lookupEncoding(tentativeEncoding)
+                    if codec is not None:
+                        self.encoding = codec
+                        return False
+                elif attr[0] == b"content":
+                    contentParser = ContentAttrParser(EncodingBytes(attr[1]))
+                    tentativeEncoding = contentParser.parse()
+                    if tentativeEncoding is not None:
+                        codec = lookupEncoding(tentativeEncoding)
+                        if codec is not None:
+                            if hasPragma:
+                                self.encoding = codec
+                                return False
+                            else:
+                                pendingEncoding = codec
+
+    def handlePossibleStartTag(self):
+        return self.handlePossibleTag(False)
+
+    def handlePossibleEndTag(self):
+        next(self.data)
+        return self.handlePossibleTag(True)
+
+    def handlePossibleTag(self, endTag):
+        data = self.data
+        if data.currentByte not in asciiLettersBytes:
+            # If the next byte is not an ascii letter either ignore this
+            # fragment (possible start tag case) or treat it according to
+            # handleOther
+            if endTag:
+                data.previous()
+                self.handleOther()
+            return True
+
+        c = data.skipUntil(spacesAngleBrackets)
+        if c == b"<":
+            # return to the first step in the overall "two step" algorithm
+            # reprocessing the < byte
+            data.previous()
+        else:
+            # Read all attributes
+            attr = self.getAttribute()
+            while attr is not None:
+                attr = self.getAttribute()
+        return True
+
+    def handleOther(self):
+        return self.data.jumpTo(b">")
+
+    def getAttribute(self):
+        """Return a name,value pair for the next attribute in the stream,
+        if one is found, or None"""
+        data = self.data
+        # Step 1 (skip chars)
+        c = data.skip(spaceCharactersBytes | frozenset([b"/"]))
+        assert c is None or len(c) == 1
+        # Step 2
+        if c in (b">", None):
+            return None
+        # Step 3
+        attrName = []
+        attrValue = []
+        # Step 4 attribute name
+        while True:
+            if c == b"=" and attrName:
+                break
+            elif c in spaceCharactersBytes:
+                # Step 6!
+                c = data.skip()
+                break
+            elif c in (b"/", b">"):
+                return b"".join(attrName), b""
+            elif c in asciiUppercaseBytes:
+                attrName.append(c.lower())
+            elif c is None:
+                return None
+            else:
+                attrName.append(c)
+            # Step 5
+            c = next(data)
+        # Step 7
+        if c != b"=":
+            data.previous()
+            return b"".join(attrName), b""
+        # Step 8
+        next(data)
+        # Step 9
+        c = data.skip()
+        # Step 10
+        if c in (b"'", b'"'):
+            # 10.1
+            quoteChar = c
+            while True:
+                # 10.2
+                c = next(data)
+                # 10.3
+                if c == quoteChar:
+                    next(data)
+                    return b"".join(attrName), b"".join(attrValue)
+                # 10.4
+                elif c in asciiUppercaseBytes:
+                    attrValue.append(c.lower())
+                # 10.5
+                else:
+                    attrValue.append(c)
+        elif c == b">":
+            return b"".join(attrName), b""
+        elif c in asciiUppercaseBytes:
+            attrValue.append(c.lower())
+        elif c is None:
+            return None
+        else:
+            attrValue.append(c)
+        # Step 11
+        while True:
+            c = next(data)
+            if c in spacesAngleBrackets:
+                return b"".join(attrName), b"".join(attrValue)
+            elif c in asciiUppercaseBytes:
+                attrValue.append(c.lower())
+            elif c is None:
+                return None
+            else:
+                attrValue.append(c)
+
+
+class ContentAttrParser(object):
+    def __init__(self, data):
+        assert isinstance(data, bytes)
+        self.data = data
+
+    def parse(self):
+        try:
+            # Check if the attr name is charset
+            # otherwise return
+            self.data.jumpTo(b"charset")
+            self.data.position += 1
+            self.data.skip()
+            if not self.data.currentByte == b"=":
+                # If there is no = sign keep looking for attrs
+                return None
+            self.data.position += 1
+            self.data.skip()
+            # Look for an encoding between matching quote marks
+            if self.data.currentByte in (b'"', b"'"):
+                quoteMark = self.data.currentByte
+                self.data.position += 1
+                oldPosition = self.data.position
+                if self.data.jumpTo(quoteMark):
+                    return self.data[oldPosition:self.data.position]
+                else:
+                    return None
+            else:
+                # Unquoted value
+                oldPosition = self.data.position
+                try:
+                    self.data.skipUntil(spaceCharactersBytes)
+                    return self.data[oldPosition:self.data.position]
+                except StopIteration:
+                    # Return the whole remaining value
+                    return self.data[oldPosition:]
+        except StopIteration:
+            return None
+
+
+def lookupEncoding(encoding):
+    """Return the python codec name corresponding to an encoding or None if the
+    string doesn't correspond to a valid encoding."""
+    if isinstance(encoding, binary_type):
+        try:
+            encoding = encoding.decode("ascii")
+        except UnicodeDecodeError:
+            return None
+
+    if encoding is not None:
+        try:
+            return webencodings.lookup(encoding)
+        except AttributeError:
+            return None
+    else:
+        return None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_tokenizer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_tokenizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6078f66aa0d3195c45668fc65efbf19217b3185e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_tokenizer.py
@@ -0,0 +1,1721 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from six import unichr as chr
+
+from collections import deque
+
+from .constants import spaceCharacters
+from .constants import entities
+from .constants import asciiLetters, asciiUpper2Lower
+from .constants import digits, hexDigits, EOF
+from .constants import tokenTypes, tagTokenTypes
+from .constants import replacementCharacters
+
+from ._inputstream import HTMLInputStream
+
+from ._trie import Trie
+
+entitiesTrie = Trie(entities)
+
+
+class HTMLTokenizer(object):
+    """ This class takes care of tokenizing HTML.
+
+    * self.currentToken
+      Holds the token that is currently being processed.
+
+    * self.state
+      Holds a reference to the method to be invoked... XXX
+
+    * self.stream
+      Points to HTMLInputStream object.
+    """
+
+    def __init__(self, stream, parser=None, **kwargs):
+
+        self.stream = HTMLInputStream(stream, **kwargs)
+        self.parser = parser
+
+        # Setup the initial tokenizer state
+        self.escapeFlag = False
+        self.lastFourChars = []
+        self.state = self.dataState
+        self.escape = False
+
+        # The current token being created
+        self.currentToken = None
+        super(HTMLTokenizer, self).__init__()
+
+    def __iter__(self):
+        """ This is where the magic happens.
+
+        We do our usually processing through the states and when we have a token
+        to return we yield the token which pauses processing until the next token
+        is requested.
+        """
+        self.tokenQueue = deque([])
+        # Start processing. When EOF is reached self.state will return False
+        # instead of True and the loop will terminate.
+        while self.state():
+            while self.stream.errors:
+                yield {"type": tokenTypes["ParseError"], "data": self.stream.errors.pop(0)}
+            while self.tokenQueue:
+                yield self.tokenQueue.popleft()
+
+    def consumeNumberEntity(self, isHex):
+        """This function returns either U+FFFD or the character based on the
+        decimal or hexadecimal representation. It also discards ";" if present.
+        If not present self.tokenQueue.append({"type": tokenTypes["ParseError"]}) is invoked.
+        """
+
+        allowed = digits
+        radix = 10
+        if isHex:
+            allowed = hexDigits
+            radix = 16
+
+        charStack = []
+
+        # Consume all the characters that are in range while making sure we
+        # don't hit an EOF.
+        c = self.stream.char()
+        while c in allowed and c is not EOF:
+            charStack.append(c)
+            c = self.stream.char()
+
+        # Convert the set of characters consumed to an int.
+        charAsInt = int("".join(charStack), radix)
+
+        # Certain characters get replaced with others
+        if charAsInt in replacementCharacters:
+            char = replacementCharacters[charAsInt]
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "illegal-codepoint-for-numeric-entity",
+                                    "datavars": {"charAsInt": charAsInt}})
+        elif ((0xD800 <= charAsInt <= 0xDFFF) or
+              (charAsInt > 0x10FFFF)):
+            char = "\uFFFD"
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "illegal-codepoint-for-numeric-entity",
+                                    "datavars": {"charAsInt": charAsInt}})
+        else:
+            # Should speed up this check somehow (e.g. move the set to a constant)
+            if ((0x0001 <= charAsInt <= 0x0008) or
+                (0x000E <= charAsInt <= 0x001F) or
+                (0x007F <= charAsInt <= 0x009F) or
+                (0xFDD0 <= charAsInt <= 0xFDEF) or
+                charAsInt in frozenset([0x000B, 0xFFFE, 0xFFFF, 0x1FFFE,
+                                        0x1FFFF, 0x2FFFE, 0x2FFFF, 0x3FFFE,
+                                        0x3FFFF, 0x4FFFE, 0x4FFFF, 0x5FFFE,
+                                        0x5FFFF, 0x6FFFE, 0x6FFFF, 0x7FFFE,
+                                        0x7FFFF, 0x8FFFE, 0x8FFFF, 0x9FFFE,
+                                        0x9FFFF, 0xAFFFE, 0xAFFFF, 0xBFFFE,
+                                        0xBFFFF, 0xCFFFE, 0xCFFFF, 0xDFFFE,
+                                        0xDFFFF, 0xEFFFE, 0xEFFFF, 0xFFFFE,
+                                        0xFFFFF, 0x10FFFE, 0x10FFFF])):
+                self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                        "data":
+                                        "illegal-codepoint-for-numeric-entity",
+                                        "datavars": {"charAsInt": charAsInt}})
+            try:
+                # Try/except needed as UCS-2 Python builds' unichar only works
+                # within the BMP.
+                char = chr(charAsInt)
+            except ValueError:
+                v = charAsInt - 0x10000
+                char = chr(0xD800 | (v >> 10)) + chr(0xDC00 | (v & 0x3FF))
+
+        # Discard the ; if present. Otherwise, put it back on the queue and
+        # invoke parseError on parser.
+        if c != ";":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "numeric-entity-without-semicolon"})
+            self.stream.unget(c)
+
+        return char
+
+    def consumeEntity(self, allowedChar=None, fromAttribute=False):
+        # Initialise to the default output for when no entity is matched
+        output = "&"
+
+        charStack = [self.stream.char()]
+        if (charStack[0] in spaceCharacters or charStack[0] in (EOF, "<", "&") or
+                (allowedChar is not None and allowedChar == charStack[0])):
+            self.stream.unget(charStack[0])
+
+        elif charStack[0] == "#":
+            # Read the next character to see if it's hex or decimal
+            hex = False
+            charStack.append(self.stream.char())
+            if charStack[-1] in ("x", "X"):
+                hex = True
+                charStack.append(self.stream.char())
+
+            # charStack[-1] should be the first digit
+            if (hex and charStack[-1] in hexDigits) \
+                    or (not hex and charStack[-1] in digits):
+                # At least one digit found, so consume the whole number
+                self.stream.unget(charStack[-1])
+                output = self.consumeNumberEntity(hex)
+            else:
+                # No digits found
+                self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                        "data": "expected-numeric-entity"})
+                self.stream.unget(charStack.pop())
+                output = "&" + "".join(charStack)
+
+        else:
+            # At this point in the process might have named entity. Entities
+            # are stored in the global variable "entities".
+            #
+            # Consume characters and compare to these to a substring of the
+            # entity names in the list until the substring no longer matches.
+            while (charStack[-1] is not EOF):
+                if not entitiesTrie.has_keys_with_prefix("".join(charStack)):
+                    break
+                charStack.append(self.stream.char())
+
+            # At this point we have a string that starts with some characters
+            # that may match an entity
+            # Try to find the longest entity the string will match to take care
+            # of &noti for instance.
+            try:
+                entityName = entitiesTrie.longest_prefix("".join(charStack[:-1]))
+                entityLength = len(entityName)
+            except KeyError:
+                entityName = None
+
+            if entityName is not None:
+                if entityName[-1] != ";":
+                    self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                            "named-entity-without-semicolon"})
+                if (entityName[-1] != ";" and fromAttribute and
+                    (charStack[entityLength] in asciiLetters or
+                     charStack[entityLength] in digits or
+                     charStack[entityLength] == "=")):
+                    self.stream.unget(charStack.pop())
+                    output = "&" + "".join(charStack)
+                else:
+                    output = entities[entityName]
+                    self.stream.unget(charStack.pop())
+                    output += "".join(charStack[entityLength:])
+            else:
+                self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                        "expected-named-entity"})
+                self.stream.unget(charStack.pop())
+                output = "&" + "".join(charStack)
+
+        if fromAttribute:
+            self.currentToken["data"][-1][1] += output
+        else:
+            if output in spaceCharacters:
+                tokenType = "SpaceCharacters"
+            else:
+                tokenType = "Characters"
+            self.tokenQueue.append({"type": tokenTypes[tokenType], "data": output})
+
+    def processEntityInAttribute(self, allowedChar):
+        """This method replaces the need for "entityInAttributeValueState".
+        """
+        self.consumeEntity(allowedChar=allowedChar, fromAttribute=True)
+
+    def emitCurrentToken(self):
+        """This method is a generic handler for emitting the tags. It also sets
+        the state to "data" because that's what's needed after a token has been
+        emitted.
+        """
+        token = self.currentToken
+        # Add token to the queue to be yielded
+        if (token["type"] in tagTokenTypes):
+            token["name"] = token["name"].translate(asciiUpper2Lower)
+            if token["type"] == tokenTypes["EndTag"]:
+                if token["data"]:
+                    self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                            "data": "attributes-in-end-tag"})
+                if token["selfClosing"]:
+                    self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                            "data": "self-closing-flag-on-end-tag"})
+        self.tokenQueue.append(token)
+        self.state = self.dataState
+
+    # Below are the various tokenizer states worked out.
+    def dataState(self):
+        data = self.stream.char()
+        if data == "&":
+            self.state = self.entityDataState
+        elif data == "<":
+            self.state = self.tagOpenState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\u0000"})
+        elif data is EOF:
+            # Tokenization ends.
+            return False
+        elif data in spaceCharacters:
+            # Directly after emitting a token you switch back to the "data
+            # state". At that point spaceCharacters are important so they are
+            # emitted separately.
+            self.tokenQueue.append({"type": tokenTypes["SpaceCharacters"], "data":
+                                    data + self.stream.charsUntil(spaceCharacters, True)})
+            # No need to update lastFourChars here, since the first space will
+            # have already been appended to lastFourChars and will have broken
+            # any <!-- or --> sequences
+        else:
+            chars = self.stream.charsUntil(("&", "<", "\u0000"))
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + chars})
+        return True
+
+    def entityDataState(self):
+        self.consumeEntity()
+        self.state = self.dataState
+        return True
+
+    def rcdataState(self):
+        data = self.stream.char()
+        if data == "&":
+            self.state = self.characterReferenceInRcdata
+        elif data == "<":
+            self.state = self.rcdataLessThanSignState
+        elif data == EOF:
+            # Tokenization ends.
+            return False
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        elif data in spaceCharacters:
+            # Directly after emitting a token you switch back to the "data
+            # state". At that point spaceCharacters are important so they are
+            # emitted separately.
+            self.tokenQueue.append({"type": tokenTypes["SpaceCharacters"], "data":
+                                    data + self.stream.charsUntil(spaceCharacters, True)})
+            # No need to update lastFourChars here, since the first space will
+            # have already been appended to lastFourChars and will have broken
+            # any <!-- or --> sequences
+        else:
+            chars = self.stream.charsUntil(("&", "<", "\u0000"))
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + chars})
+        return True
+
+    def characterReferenceInRcdata(self):
+        self.consumeEntity()
+        self.state = self.rcdataState
+        return True
+
+    def rawtextState(self):
+        data = self.stream.char()
+        if data == "<":
+            self.state = self.rawtextLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        elif data == EOF:
+            # Tokenization ends.
+            return False
+        else:
+            chars = self.stream.charsUntil(("<", "\u0000"))
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + chars})
+        return True
+
+    def scriptDataState(self):
+        data = self.stream.char()
+        if data == "<":
+            self.state = self.scriptDataLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        elif data == EOF:
+            # Tokenization ends.
+            return False
+        else:
+            chars = self.stream.charsUntil(("<", "\u0000"))
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + chars})
+        return True
+
+    def plaintextState(self):
+        data = self.stream.char()
+        if data == EOF:
+            # Tokenization ends.
+            return False
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + self.stream.charsUntil("\u0000")})
+        return True
+
+    def tagOpenState(self):
+        data = self.stream.char()
+        if data == "!":
+            self.state = self.markupDeclarationOpenState
+        elif data == "/":
+            self.state = self.closeTagOpenState
+        elif data in asciiLetters:
+            self.currentToken = {"type": tokenTypes["StartTag"],
+                                 "name": data, "data": [],
+                                 "selfClosing": False,
+                                 "selfClosingAcknowledged": False}
+            self.state = self.tagNameState
+        elif data == ">":
+            # XXX In theory it could be something besides a tag name. But
+            # do we really care?
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-tag-name-but-got-right-bracket"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<>"})
+            self.state = self.dataState
+        elif data == "?":
+            # XXX In theory it could be something besides a tag name. But
+            # do we really care?
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-tag-name-but-got-question-mark"})
+            self.stream.unget(data)
+            self.state = self.bogusCommentState
+        else:
+            # XXX
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-tag-name"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.stream.unget(data)
+            self.state = self.dataState
+        return True
+
+    def closeTagOpenState(self):
+        data = self.stream.char()
+        if data in asciiLetters:
+            self.currentToken = {"type": tokenTypes["EndTag"], "name": data,
+                                 "data": [], "selfClosing": False}
+            self.state = self.tagNameState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-closing-tag-but-got-right-bracket"})
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-closing-tag-but-got-eof"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
+            self.state = self.dataState
+        else:
+            # XXX data can be _'_...
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-closing-tag-but-got-char",
+                                    "datavars": {"data": data}})
+            self.stream.unget(data)
+            self.state = self.bogusCommentState
+        return True
+
+    def tagNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeAttributeNameState
+        elif data == ">":
+            self.emitCurrentToken()
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-tag-name"})
+            self.state = self.dataState
+        elif data == "/":
+            self.state = self.selfClosingStartTagState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["name"] += "\uFFFD"
+        else:
+            self.currentToken["name"] += data
+            # (Don't use charsUntil here, because tag names are
+            # very short and it's faster to not do anything fancy)
+        return True
+
+    def rcdataLessThanSignState(self):
+        data = self.stream.char()
+        if data == "/":
+            self.temporaryBuffer = ""
+            self.state = self.rcdataEndTagOpenState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.stream.unget(data)
+            self.state = self.rcdataState
+        return True
+
+    def rcdataEndTagOpenState(self):
+        data = self.stream.char()
+        if data in asciiLetters:
+            self.temporaryBuffer += data
+            self.state = self.rcdataEndTagNameState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
+            self.stream.unget(data)
+            self.state = self.rcdataState
+        return True
+
+    def rcdataEndTagNameState(self):
+        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
+        data = self.stream.char()
+        if data in spaceCharacters and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.beforeAttributeNameState
+        elif data == "/" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.selfClosingStartTagState
+        elif data == ">" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.emitCurrentToken()
+            self.state = self.dataState
+        elif data in asciiLetters:
+            self.temporaryBuffer += data
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "</" + self.temporaryBuffer})
+            self.stream.unget(data)
+            self.state = self.rcdataState
+        return True
+
+    def rawtextLessThanSignState(self):
+        data = self.stream.char()
+        if data == "/":
+            self.temporaryBuffer = ""
+            self.state = self.rawtextEndTagOpenState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.stream.unget(data)
+            self.state = self.rawtextState
+        return True
+
+    def rawtextEndTagOpenState(self):
+        data = self.stream.char()
+        if data in asciiLetters:
+            self.temporaryBuffer += data
+            self.state = self.rawtextEndTagNameState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
+            self.stream.unget(data)
+            self.state = self.rawtextState
+        return True
+
+    def rawtextEndTagNameState(self):
+        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
+        data = self.stream.char()
+        if data in spaceCharacters and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.beforeAttributeNameState
+        elif data == "/" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.selfClosingStartTagState
+        elif data == ">" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.emitCurrentToken()
+            self.state = self.dataState
+        elif data in asciiLetters:
+            self.temporaryBuffer += data
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "</" + self.temporaryBuffer})
+            self.stream.unget(data)
+            self.state = self.rawtextState
+        return True
+
+    def scriptDataLessThanSignState(self):
+        data = self.stream.char()
+        if data == "/":
+            self.temporaryBuffer = ""
+            self.state = self.scriptDataEndTagOpenState
+        elif data == "!":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<!"})
+            self.state = self.scriptDataEscapeStartState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.stream.unget(data)
+            self.state = self.scriptDataState
+        return True
+
+    def scriptDataEndTagOpenState(self):
+        data = self.stream.char()
+        if data in asciiLetters:
+            self.temporaryBuffer += data
+            self.state = self.scriptDataEndTagNameState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
+            self.stream.unget(data)
+            self.state = self.scriptDataState
+        return True
+
+    def scriptDataEndTagNameState(self):
+        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
+        data = self.stream.char()
+        if data in spaceCharacters and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.beforeAttributeNameState
+        elif data == "/" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.selfClosingStartTagState
+        elif data == ">" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.emitCurrentToken()
+            self.state = self.dataState
+        elif data in asciiLetters:
+            self.temporaryBuffer += data
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "</" + self.temporaryBuffer})
+            self.stream.unget(data)
+            self.state = self.scriptDataState
+        return True
+
+    def scriptDataEscapeStartState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataEscapeStartDashState
+        else:
+            self.stream.unget(data)
+            self.state = self.scriptDataState
+        return True
+
+    def scriptDataEscapeStartDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataEscapedDashDashState
+        else:
+            self.stream.unget(data)
+            self.state = self.scriptDataState
+        return True
+
+    def scriptDataEscapedState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataEscapedDashState
+        elif data == "<":
+            self.state = self.scriptDataEscapedLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        elif data == EOF:
+            self.state = self.dataState
+        else:
+            chars = self.stream.charsUntil(("<", "-", "\u0000"))
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
+                                    data + chars})
+        return True
+
+    def scriptDataEscapedDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataEscapedDashDashState
+        elif data == "<":
+            self.state = self.scriptDataEscapedLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+            self.state = self.scriptDataEscapedState
+        elif data == EOF:
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataEscapedDashDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+        elif data == "<":
+            self.state = self.scriptDataEscapedLessThanSignState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": ">"})
+            self.state = self.scriptDataState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+            self.state = self.scriptDataEscapedState
+        elif data == EOF:
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataEscapedLessThanSignState(self):
+        data = self.stream.char()
+        if data == "/":
+            self.temporaryBuffer = ""
+            self.state = self.scriptDataEscapedEndTagOpenState
+        elif data in asciiLetters:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<" + data})
+            self.temporaryBuffer = data
+            self.state = self.scriptDataDoubleEscapeStartState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.stream.unget(data)
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataEscapedEndTagOpenState(self):
+        data = self.stream.char()
+        if data in asciiLetters:
+            self.temporaryBuffer = data
+            self.state = self.scriptDataEscapedEndTagNameState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
+            self.stream.unget(data)
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataEscapedEndTagNameState(self):
+        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
+        data = self.stream.char()
+        if data in spaceCharacters and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.beforeAttributeNameState
+        elif data == "/" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.state = self.selfClosingStartTagState
+        elif data == ">" and appropriate:
+            self.currentToken = {"type": tokenTypes["EndTag"],
+                                 "name": self.temporaryBuffer,
+                                 "data": [], "selfClosing": False}
+            self.emitCurrentToken()
+            self.state = self.dataState
+        elif data in asciiLetters:
+            self.temporaryBuffer += data
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "</" + self.temporaryBuffer})
+            self.stream.unget(data)
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataDoubleEscapeStartState(self):
+        data = self.stream.char()
+        if data in (spaceCharacters | frozenset(("/", ">"))):
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            if self.temporaryBuffer.lower() == "script":
+                self.state = self.scriptDataDoubleEscapedState
+            else:
+                self.state = self.scriptDataEscapedState
+        elif data in asciiLetters:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.temporaryBuffer += data
+        else:
+            self.stream.unget(data)
+            self.state = self.scriptDataEscapedState
+        return True
+
+    def scriptDataDoubleEscapedState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataDoubleEscapedDashState
+        elif data == "<":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.state = self.scriptDataDoubleEscapedLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+        elif data == EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-script-in-script"})
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+        return True
+
+    def scriptDataDoubleEscapedDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+            self.state = self.scriptDataDoubleEscapedDashDashState
+        elif data == "<":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.state = self.scriptDataDoubleEscapedLessThanSignState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+            self.state = self.scriptDataDoubleEscapedState
+        elif data == EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-script-in-script"})
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.state = self.scriptDataDoubleEscapedState
+        return True
+
+    def scriptDataDoubleEscapedDashDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
+        elif data == "<":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
+            self.state = self.scriptDataDoubleEscapedLessThanSignState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": ">"})
+            self.state = self.scriptDataState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": "\uFFFD"})
+            self.state = self.scriptDataDoubleEscapedState
+        elif data == EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-script-in-script"})
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.state = self.scriptDataDoubleEscapedState
+        return True
+
+    def scriptDataDoubleEscapedLessThanSignState(self):
+        data = self.stream.char()
+        if data == "/":
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "/"})
+            self.temporaryBuffer = ""
+            self.state = self.scriptDataDoubleEscapeEndState
+        else:
+            self.stream.unget(data)
+            self.state = self.scriptDataDoubleEscapedState
+        return True
+
+    def scriptDataDoubleEscapeEndState(self):
+        data = self.stream.char()
+        if data in (spaceCharacters | frozenset(("/", ">"))):
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            if self.temporaryBuffer.lower() == "script":
+                self.state = self.scriptDataEscapedState
+            else:
+                self.state = self.scriptDataDoubleEscapedState
+        elif data in asciiLetters:
+            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
+            self.temporaryBuffer += data
+        else:
+            self.stream.unget(data)
+            self.state = self.scriptDataDoubleEscapedState
+        return True
+
+    def beforeAttributeNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.stream.charsUntil(spaceCharacters, True)
+        elif data in asciiLetters:
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        elif data == ">":
+            self.emitCurrentToken()
+        elif data == "/":
+            self.state = self.selfClosingStartTagState
+        elif data in ("'", '"', "=", "<"):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "invalid-character-in-attribute-name"})
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"].append(["\uFFFD", ""])
+            self.state = self.attributeNameState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-attribute-name-but-got-eof"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        return True
+
+    def attributeNameState(self):
+        data = self.stream.char()
+        leavingThisState = True
+        emitToken = False
+        if data == "=":
+            self.state = self.beforeAttributeValueState
+        elif data in asciiLetters:
+            self.currentToken["data"][-1][0] += data +\
+                self.stream.charsUntil(asciiLetters, True)
+            leavingThisState = False
+        elif data == ">":
+            # XXX If we emit here the attributes are converted to a dict
+            # without being checked and when the code below runs we error
+            # because data is a dict not a list
+            emitToken = True
+        elif data in spaceCharacters:
+            self.state = self.afterAttributeNameState
+        elif data == "/":
+            self.state = self.selfClosingStartTagState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"][-1][0] += "\uFFFD"
+            leavingThisState = False
+        elif data in ("'", '"', "<"):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data":
+                                    "invalid-character-in-attribute-name"})
+            self.currentToken["data"][-1][0] += data
+            leavingThisState = False
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "eof-in-attribute-name"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"][-1][0] += data
+            leavingThisState = False
+
+        if leavingThisState:
+            # Attributes are not dropped at this stage. That happens when the
+            # start tag token is emitted so values can still be safely appended
+            # to attributes, but we do want to report the parse error in time.
+            self.currentToken["data"][-1][0] = (
+                self.currentToken["data"][-1][0].translate(asciiUpper2Lower))
+            for name, _ in self.currentToken["data"][:-1]:
+                if self.currentToken["data"][-1][0] == name:
+                    self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                            "duplicate-attribute"})
+                    break
+            # XXX Fix for above XXX
+            if emitToken:
+                self.emitCurrentToken()
+        return True
+
+    def afterAttributeNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.stream.charsUntil(spaceCharacters, True)
+        elif data == "=":
+            self.state = self.beforeAttributeValueState
+        elif data == ">":
+            self.emitCurrentToken()
+        elif data in asciiLetters:
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        elif data == "/":
+            self.state = self.selfClosingStartTagState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"].append(["\uFFFD", ""])
+            self.state = self.attributeNameState
+        elif data in ("'", '"', "<"):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "invalid-character-after-attribute-name"})
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-end-of-tag-but-got-eof"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"].append([data, ""])
+            self.state = self.attributeNameState
+        return True
+
+    def beforeAttributeValueState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.stream.charsUntil(spaceCharacters, True)
+        elif data == "\"":
+            self.state = self.attributeValueDoubleQuotedState
+        elif data == "&":
+            self.state = self.attributeValueUnQuotedState
+            self.stream.unget(data)
+        elif data == "'":
+            self.state = self.attributeValueSingleQuotedState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-attribute-value-but-got-right-bracket"})
+            self.emitCurrentToken()
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"][-1][1] += "\uFFFD"
+            self.state = self.attributeValueUnQuotedState
+        elif data in ("=", "<", "`"):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "equals-in-unquoted-attribute-value"})
+            self.currentToken["data"][-1][1] += data
+            self.state = self.attributeValueUnQuotedState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-attribute-value-but-got-eof"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"][-1][1] += data
+            self.state = self.attributeValueUnQuotedState
+        return True
+
+    def attributeValueDoubleQuotedState(self):
+        data = self.stream.char()
+        if data == "\"":
+            self.state = self.afterAttributeValueState
+        elif data == "&":
+            self.processEntityInAttribute('"')
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"][-1][1] += "\uFFFD"
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-attribute-value-double-quote"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"][-1][1] += data +\
+                self.stream.charsUntil(("\"", "&", "\u0000"))
+        return True
+
+    def attributeValueSingleQuotedState(self):
+        data = self.stream.char()
+        if data == "'":
+            self.state = self.afterAttributeValueState
+        elif data == "&":
+            self.processEntityInAttribute("'")
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"][-1][1] += "\uFFFD"
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-attribute-value-single-quote"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"][-1][1] += data +\
+                self.stream.charsUntil(("'", "&", "\u0000"))
+        return True
+
+    def attributeValueUnQuotedState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeAttributeNameState
+        elif data == "&":
+            self.processEntityInAttribute(">")
+        elif data == ">":
+            self.emitCurrentToken()
+        elif data in ('"', "'", "=", "<", "`"):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-character-in-unquoted-attribute-value"})
+            self.currentToken["data"][-1][1] += data
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"][-1][1] += "\uFFFD"
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-attribute-value-no-quotes"})
+            self.state = self.dataState
+        else:
+            self.currentToken["data"][-1][1] += data + self.stream.charsUntil(
+                frozenset(("&", ">", '"', "'", "=", "<", "`", "\u0000")) | spaceCharacters)
+        return True
+
+    def afterAttributeValueState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeAttributeNameState
+        elif data == ">":
+            self.emitCurrentToken()
+        elif data == "/":
+            self.state = self.selfClosingStartTagState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-EOF-after-attribute-value"})
+            self.stream.unget(data)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-character-after-attribute-value"})
+            self.stream.unget(data)
+            self.state = self.beforeAttributeNameState
+        return True
+
+    def selfClosingStartTagState(self):
+        data = self.stream.char()
+        if data == ">":
+            self.currentToken["selfClosing"] = True
+            self.emitCurrentToken()
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data":
+                                    "unexpected-EOF-after-solidus-in-tag"})
+            self.stream.unget(data)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-character-after-solidus-in-tag"})
+            self.stream.unget(data)
+            self.state = self.beforeAttributeNameState
+        return True
+
+    def bogusCommentState(self):
+        # Make a new comment token and give it as value all the characters
+        # until the first > or EOF (charsUntil checks for EOF automatically)
+        # and emit it.
+        data = self.stream.charsUntil(">")
+        data = data.replace("\u0000", "\uFFFD")
+        self.tokenQueue.append(
+            {"type": tokenTypes["Comment"], "data": data})
+
+        # Eat the character directly after the bogus comment which is either a
+        # ">" or an EOF.
+        self.stream.char()
+        self.state = self.dataState
+        return True
+
+    def markupDeclarationOpenState(self):
+        charStack = [self.stream.char()]
+        if charStack[-1] == "-":
+            charStack.append(self.stream.char())
+            if charStack[-1] == "-":
+                self.currentToken = {"type": tokenTypes["Comment"], "data": ""}
+                self.state = self.commentStartState
+                return True
+        elif charStack[-1] in ('d', 'D'):
+            matched = True
+            for expected in (('o', 'O'), ('c', 'C'), ('t', 'T'),
+                             ('y', 'Y'), ('p', 'P'), ('e', 'E')):
+                charStack.append(self.stream.char())
+                if charStack[-1] not in expected:
+                    matched = False
+                    break
+            if matched:
+                self.currentToken = {"type": tokenTypes["Doctype"],
+                                     "name": "",
+                                     "publicId": None, "systemId": None,
+                                     "correct": True}
+                self.state = self.doctypeState
+                return True
+        elif (charStack[-1] == "[" and
+              self.parser is not None and
+              self.parser.tree.openElements and
+              self.parser.tree.openElements[-1].namespace != self.parser.tree.defaultNamespace):
+            matched = True
+            for expected in ["C", "D", "A", "T", "A", "["]:
+                charStack.append(self.stream.char())
+                if charStack[-1] != expected:
+                    matched = False
+                    break
+            if matched:
+                self.state = self.cdataSectionState
+                return True
+
+        self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                "expected-dashes-or-doctype"})
+
+        while charStack:
+            self.stream.unget(charStack.pop())
+        self.state = self.bogusCommentState
+        return True
+
+    def commentStartState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.state = self.commentStartDashState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "incorrect-comment"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-comment"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["data"] += data
+            self.state = self.commentState
+        return True
+
+    def commentStartDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.state = self.commentEndState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "-\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "incorrect-comment"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-comment"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["data"] += "-" + data
+            self.state = self.commentState
+        return True
+
+    def commentState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.state = self.commentEndDashState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "\uFFFD"
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "eof-in-comment"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["data"] += data + \
+                self.stream.charsUntil(("-", "\u0000"))
+        return True
+
+    def commentEndDashState(self):
+        data = self.stream.char()
+        if data == "-":
+            self.state = self.commentEndState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "-\uFFFD"
+            self.state = self.commentState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-comment-end-dash"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["data"] += "-" + data
+            self.state = self.commentState
+        return True
+
+    def commentEndState(self):
+        data = self.stream.char()
+        if data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "--\uFFFD"
+            self.state = self.commentState
+        elif data == "!":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-bang-after-double-dash-in-comment"})
+            self.state = self.commentEndBangState
+        elif data == "-":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-dash-after-double-dash-in-comment"})
+            self.currentToken["data"] += data
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-comment-double-dash"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            # XXX
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-comment"})
+            self.currentToken["data"] += "--" + data
+            self.state = self.commentState
+        return True
+
+    def commentEndBangState(self):
+        data = self.stream.char()
+        if data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == "-":
+            self.currentToken["data"] += "--!"
+            self.state = self.commentEndDashState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["data"] += "--!\uFFFD"
+            self.state = self.commentState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-comment-end-bang-state"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["data"] += "--!" + data
+            self.state = self.commentState
+        return True
+
+    def doctypeState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeDoctypeNameState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-doctype-name-but-got-eof"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "need-space-after-doctype"})
+            self.stream.unget(data)
+            self.state = self.beforeDoctypeNameState
+        return True
+
+    def beforeDoctypeNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-doctype-name-but-got-right-bracket"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["name"] = "\uFFFD"
+            self.state = self.doctypeNameState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-doctype-name-but-got-eof"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["name"] = data
+            self.state = self.doctypeNameState
+        return True
+
+    def doctypeNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
+            self.state = self.afterDoctypeNameState
+        elif data == ">":
+            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["name"] += "\uFFFD"
+            self.state = self.doctypeNameState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype-name"})
+            self.currentToken["correct"] = False
+            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["name"] += data
+        return True
+
+    def afterDoctypeNameState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.currentToken["correct"] = False
+            self.stream.unget(data)
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            if data in ("p", "P"):
+                matched = True
+                for expected in (("u", "U"), ("b", "B"), ("l", "L"),
+                                 ("i", "I"), ("c", "C")):
+                    data = self.stream.char()
+                    if data not in expected:
+                        matched = False
+                        break
+                if matched:
+                    self.state = self.afterDoctypePublicKeywordState
+                    return True
+            elif data in ("s", "S"):
+                matched = True
+                for expected in (("y", "Y"), ("s", "S"), ("t", "T"),
+                                 ("e", "E"), ("m", "M")):
+                    data = self.stream.char()
+                    if data not in expected:
+                        matched = False
+                        break
+                if matched:
+                    self.state = self.afterDoctypeSystemKeywordState
+                    return True
+
+            # All the characters read before the current 'data' will be
+            # [a-zA-Z], so they're garbage in the bogus doctype and can be
+            # discarded; only the latest character might be '>' or EOF
+            # and needs to be ungetted
+            self.stream.unget(data)
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "expected-space-or-right-bracket-in-doctype", "datavars":
+                                    {"data": data}})
+            self.currentToken["correct"] = False
+            self.state = self.bogusDoctypeState
+
+        return True
+
+    def afterDoctypePublicKeywordState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeDoctypePublicIdentifierState
+        elif data in ("'", '"'):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.stream.unget(data)
+            self.state = self.beforeDoctypePublicIdentifierState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.stream.unget(data)
+            self.state = self.beforeDoctypePublicIdentifierState
+        return True
+
+    def beforeDoctypePublicIdentifierState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == "\"":
+            self.currentToken["publicId"] = ""
+            self.state = self.doctypePublicIdentifierDoubleQuotedState
+        elif data == "'":
+            self.currentToken["publicId"] = ""
+            self.state = self.doctypePublicIdentifierSingleQuotedState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-end-of-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["correct"] = False
+            self.state = self.bogusDoctypeState
+        return True
+
+    def doctypePublicIdentifierDoubleQuotedState(self):
+        data = self.stream.char()
+        if data == "\"":
+            self.state = self.afterDoctypePublicIdentifierState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["publicId"] += "\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-end-of-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["publicId"] += data
+        return True
+
+    def doctypePublicIdentifierSingleQuotedState(self):
+        data = self.stream.char()
+        if data == "'":
+            self.state = self.afterDoctypePublicIdentifierState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["publicId"] += "\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-end-of-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["publicId"] += data
+        return True
+
+    def afterDoctypePublicIdentifierState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.betweenDoctypePublicAndSystemIdentifiersState
+        elif data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == '"':
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierDoubleQuotedState
+        elif data == "'":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierSingleQuotedState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["correct"] = False
+            self.state = self.bogusDoctypeState
+        return True
+
+    def betweenDoctypePublicAndSystemIdentifiersState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data == '"':
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierDoubleQuotedState
+        elif data == "'":
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierSingleQuotedState
+        elif data == EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["correct"] = False
+            self.state = self.bogusDoctypeState
+        return True
+
+    def afterDoctypeSystemKeywordState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            self.state = self.beforeDoctypeSystemIdentifierState
+        elif data in ("'", '"'):
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.stream.unget(data)
+            self.state = self.beforeDoctypeSystemIdentifierState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.stream.unget(data)
+            self.state = self.beforeDoctypeSystemIdentifierState
+        return True
+
+    def beforeDoctypeSystemIdentifierState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == "\"":
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierDoubleQuotedState
+        elif data == "'":
+            self.currentToken["systemId"] = ""
+            self.state = self.doctypeSystemIdentifierSingleQuotedState
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.currentToken["correct"] = False
+            self.state = self.bogusDoctypeState
+        return True
+
+    def doctypeSystemIdentifierDoubleQuotedState(self):
+        data = self.stream.char()
+        if data == "\"":
+            self.state = self.afterDoctypeSystemIdentifierState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["systemId"] += "\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-end-of-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["systemId"] += data
+        return True
+
+    def doctypeSystemIdentifierSingleQuotedState(self):
+        data = self.stream.char()
+        if data == "'":
+            self.state = self.afterDoctypeSystemIdentifierState
+        elif data == "\u0000":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                    "data": "invalid-codepoint"})
+            self.currentToken["systemId"] += "\uFFFD"
+        elif data == ">":
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-end-of-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.currentToken["systemId"] += data
+        return True
+
+    def afterDoctypeSystemIdentifierState(self):
+        data = self.stream.char()
+        if data in spaceCharacters:
+            pass
+        elif data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "eof-in-doctype"})
+            self.currentToken["correct"] = False
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
+                                    "unexpected-char-in-doctype"})
+            self.state = self.bogusDoctypeState
+        return True
+
+    def bogusDoctypeState(self):
+        data = self.stream.char()
+        if data == ">":
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        elif data is EOF:
+            # XXX EMIT
+            self.stream.unget(data)
+            self.tokenQueue.append(self.currentToken)
+            self.state = self.dataState
+        else:
+            pass
+        return True
+
+    def cdataSectionState(self):
+        data = []
+        while True:
+            data.append(self.stream.charsUntil("]"))
+            data.append(self.stream.charsUntil(">"))
+            char = self.stream.char()
+            if char == EOF:
+                break
+            else:
+                assert char == ">"
+                if data[-1][-2:] == "]]":
+                    data[-1] = data[-1][:-2]
+                    break
+                else:
+                    data.append(char)
+
+        data = "".join(data)  # pylint:disable=redefined-variable-type
+        # Deal with null here rather than in the parser
+        nullCount = data.count("\u0000")
+        if nullCount > 0:
+            for _ in range(nullCount):
+                self.tokenQueue.append({"type": tokenTypes["ParseError"],
+                                        "data": "invalid-codepoint"})
+            data = data.replace("\u0000", "\uFFFD")
+        if data:
+            self.tokenQueue.append({"type": tokenTypes["Characters"],
+                                    "data": data})
+        self.state = self.dataState
+        return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a5ba4bf123aa585ec8a47dce6838b09b4dfa0b1a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/__init__.py
@@ -0,0 +1,14 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from .py import Trie as PyTrie
+
+Trie = PyTrie
+
+# pylint:disable=wrong-import-position
+try:
+    from .datrie import Trie as DATrie
+except ImportError:
+    pass
+else:
+    Trie = DATrie
+# pylint:enable=wrong-import-position
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/_base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/_base.py
new file mode 100644
index 0000000000000000000000000000000000000000..a1158bbbfa5b7421b17ba5d3d48d9736b87fd059
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/_base.py
@@ -0,0 +1,37 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from collections import Mapping
+
+
+class Trie(Mapping):
+    """Abstract base class for tries"""
+
+    def keys(self, prefix=None):
+        # pylint:disable=arguments-differ
+        keys = super(Trie, self).keys()
+
+        if prefix is None:
+            return set(keys)
+
+        return {x for x in keys if x.startswith(prefix)}
+
+    def has_keys_with_prefix(self, prefix):
+        for key in self.keys():
+            if key.startswith(prefix):
+                return True
+
+        return False
+
+    def longest_prefix(self, prefix):
+        if prefix in self:
+            return prefix
+
+        for i in range(1, len(prefix) + 1):
+            if prefix[:-i] in self:
+                return prefix[:-i]
+
+        raise KeyError(prefix)
+
+    def longest_prefix_item(self, prefix):
+        lprefix = self.longest_prefix(prefix)
+        return (lprefix, self[lprefix])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/datrie.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/datrie.py
new file mode 100644
index 0000000000000000000000000000000000000000..51f3d046a740834d2c183cd7e98cc12201e8f9be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/datrie.py
@@ -0,0 +1,44 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from datrie import Trie as DATrie
+from six import text_type
+
+from ._base import Trie as ABCTrie
+
+
+class Trie(ABCTrie):
+    def __init__(self, data):
+        chars = set()
+        for key in data.keys():
+            if not isinstance(key, text_type):
+                raise TypeError("All keys must be strings")
+            for char in key:
+                chars.add(char)
+
+        self._data = DATrie("".join(chars))
+        for key, value in data.items():
+            self._data[key] = value
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        raise NotImplementedError()
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def keys(self, prefix=None):
+        return self._data.keys(prefix)
+
+    def has_keys_with_prefix(self, prefix):
+        return self._data.has_keys_with_prefix(prefix)
+
+    def longest_prefix(self, prefix):
+        return self._data.longest_prefix(prefix)
+
+    def longest_prefix_item(self, prefix):
+        return self._data.longest_prefix_item(prefix)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/py.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/py.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2ba3da757646ea1bbd5386c51590cf378db2cd8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_trie/py.py
@@ -0,0 +1,67 @@
+from __future__ import absolute_import, division, unicode_literals
+from six import text_type
+
+from bisect import bisect_left
+
+from ._base import Trie as ABCTrie
+
+
+class Trie(ABCTrie):
+    def __init__(self, data):
+        if not all(isinstance(x, text_type) for x in data.keys()):
+            raise TypeError("All keys must be strings")
+
+        self._data = data
+        self._keys = sorted(data.keys())
+        self._cachestr = ""
+        self._cachepoints = (0, len(data))
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def keys(self, prefix=None):
+        if prefix is None or prefix == "" or not self._keys:
+            return set(self._keys)
+
+        if prefix.startswith(self._cachestr):
+            lo, hi = self._cachepoints
+            start = i = bisect_left(self._keys, prefix, lo, hi)
+        else:
+            start = i = bisect_left(self._keys, prefix)
+
+        keys = set()
+        if start == len(self._keys):
+            return keys
+
+        while self._keys[i].startswith(prefix):
+            keys.add(self._keys[i])
+            i += 1
+
+        self._cachestr = prefix
+        self._cachepoints = (start, i)
+
+        return keys
+
+    def has_keys_with_prefix(self, prefix):
+        if prefix in self._data:
+            return True
+
+        if prefix.startswith(self._cachestr):
+            lo, hi = self._cachepoints
+            i = bisect_left(self._keys, prefix, lo, hi)
+        else:
+            i = bisect_left(self._keys, prefix)
+
+        if i == len(self._keys):
+            return False
+
+        return self._keys[i].startswith(prefix)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..91252f2c0a8fb51df84a50ed6157ede7d71253a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/_utils.py
@@ -0,0 +1,124 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from types import ModuleType
+
+from six import text_type
+
+try:
+    import xml.etree.cElementTree as default_etree
+except ImportError:
+    import xml.etree.ElementTree as default_etree
+
+
+__all__ = ["default_etree", "MethodDispatcher", "isSurrogatePair",
+           "surrogatePairToCodepoint", "moduleFactoryFactory",
+           "supports_lone_surrogates"]
+
+
+# Platforms not supporting lone surrogates (\uD800-\uDFFF) should be
+# caught by the below test. In general this would be any platform
+# using UTF-16 as its encoding of unicode strings, such as
+# Jython. This is because UTF-16 itself is based on the use of such
+# surrogates, and there is no mechanism to further escape such
+# escapes.
+try:
+    _x = eval('"\\uD800"')  # pylint:disable=eval-used
+    if not isinstance(_x, text_type):
+        # We need this with u"" because of http://bugs.jython.org/issue2039
+        _x = eval('u"\\uD800"')  # pylint:disable=eval-used
+        assert isinstance(_x, text_type)
+except:  # pylint:disable=bare-except
+    supports_lone_surrogates = False
+else:
+    supports_lone_surrogates = True
+
+
+class MethodDispatcher(dict):
+    """Dict with 2 special properties:
+
+    On initiation, keys that are lists, sets or tuples are converted to
+    multiple keys so accessing any one of the items in the original
+    list-like object returns the matching value
+
+    md = MethodDispatcher({("foo", "bar"):"baz"})
+    md["foo"] == "baz"
+
+    A default value which can be set through the default attribute.
+    """
+
+    def __init__(self, items=()):
+        # Using _dictEntries instead of directly assigning to self is about
+        # twice as fast. Please do careful performance testing before changing
+        # anything here.
+        _dictEntries = []
+        for name, value in items:
+            if isinstance(name, (list, tuple, frozenset, set)):
+                for item in name:
+                    _dictEntries.append((item, value))
+            else:
+                _dictEntries.append((name, value))
+        dict.__init__(self, _dictEntries)
+        assert len(self) == len(_dictEntries)
+        self.default = None
+
+    def __getitem__(self, key):
+        return dict.get(self, key, self.default)
+
+
+# Some utility functions to deal with weirdness around UCS2 vs UCS4
+# python builds
+
+def isSurrogatePair(data):
+    return (len(data) == 2 and
+            ord(data[0]) >= 0xD800 and ord(data[0]) <= 0xDBFF and
+            ord(data[1]) >= 0xDC00 and ord(data[1]) <= 0xDFFF)
+
+
+def surrogatePairToCodepoint(data):
+    char_val = (0x10000 + (ord(data[0]) - 0xD800) * 0x400 +
+                (ord(data[1]) - 0xDC00))
+    return char_val
+
+# Module Factory Factory (no, this isn't Java, I know)
+# Here to stop this being duplicated all over the place.
+
+
+def moduleFactoryFactory(factory):
+    moduleCache = {}
+
+    def moduleFactory(baseModule, *args, **kwargs):
+        if isinstance(ModuleType.__name__, type("")):
+            name = "_%s_factory" % baseModule.__name__
+        else:
+            name = b"_%s_factory" % baseModule.__name__
+
+        kwargs_tuple = tuple(kwargs.items())
+
+        try:
+            return moduleCache[name][args][kwargs_tuple]
+        except KeyError:
+            mod = ModuleType(name)
+            objs = factory(baseModule, *args, **kwargs)
+            mod.__dict__.update(objs)
+            if "name" not in moduleCache:
+                moduleCache[name] = {}
+            if "args" not in moduleCache[name]:
+                moduleCache[name][args] = {}
+            if "kwargs" not in moduleCache[name][args]:
+                moduleCache[name][args][kwargs_tuple] = {}
+            moduleCache[name][args][kwargs_tuple] = mod
+            return mod
+
+    return moduleFactory
+
+
+def memoize(func):
+    cache = {}
+
+    def wrapped(*args, **kwargs):
+        key = (tuple(args), tuple(kwargs.items()))
+        if key not in cache:
+            cache[key] = func(*args, **kwargs)
+        return cache[key]
+
+    return wrapped
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/constants.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ff804190cd890e68be62fccb1a907ff9122f78a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/constants.py
@@ -0,0 +1,2947 @@
+from __future__ import absolute_import, division, unicode_literals
+
+import string
+
+EOF = None
+
+E = {
+    "null-character":
+        "Null character in input stream, replaced with U+FFFD.",
+    "invalid-codepoint":
+        "Invalid codepoint in stream.",
+    "incorrectly-placed-solidus":
+        "Solidus (/) incorrectly placed in tag.",
+    "incorrect-cr-newline-entity":
+        "Incorrect CR newline entity, replaced with LF.",
+    "illegal-windows-1252-entity":
+        "Entity used with illegal number (windows-1252 reference).",
+    "cant-convert-numeric-entity":
+        "Numeric entity couldn't be converted to character "
+        "(codepoint U+%(charAsInt)08x).",
+    "illegal-codepoint-for-numeric-entity":
+        "Numeric entity represents an illegal codepoint: "
+        "U+%(charAsInt)08x.",
+    "numeric-entity-without-semicolon":
+        "Numeric entity didn't end with ';'.",
+    "expected-numeric-entity-but-got-eof":
+        "Numeric entity expected. Got end of file instead.",
+    "expected-numeric-entity":
+        "Numeric entity expected but none found.",
+    "named-entity-without-semicolon":
+        "Named entity didn't end with ';'.",
+    "expected-named-entity":
+        "Named entity expected. Got none.",
+    "attributes-in-end-tag":
+        "End tag contains unexpected attributes.",
+    'self-closing-flag-on-end-tag':
+        "End tag contains unexpected self-closing flag.",
+    "expected-tag-name-but-got-right-bracket":
+        "Expected tag name. Got '>' instead.",
+    "expected-tag-name-but-got-question-mark":
+        "Expected tag name. Got '?' instead. (HTML doesn't "
+        "support processing instructions.)",
+    "expected-tag-name":
+        "Expected tag name. Got something else instead",
+    "expected-closing-tag-but-got-right-bracket":
+        "Expected closing tag. Got '>' instead. Ignoring '</>'.",
+    "expected-closing-tag-but-got-eof":
+        "Expected closing tag. Unexpected end of file.",
+    "expected-closing-tag-but-got-char":
+        "Expected closing tag. Unexpected character '%(data)s' found.",
+    "eof-in-tag-name":
+        "Unexpected end of file in the tag name.",
+    "expected-attribute-name-but-got-eof":
+        "Unexpected end of file. Expected attribute name instead.",
+    "eof-in-attribute-name":
+        "Unexpected end of file in attribute name.",
+    "invalid-character-in-attribute-name":
+        "Invalid character in attribute name",
+    "duplicate-attribute":
+        "Dropped duplicate attribute on tag.",
+    "expected-end-of-tag-name-but-got-eof":
+        "Unexpected end of file. Expected = or end of tag.",
+    "expected-attribute-value-but-got-eof":
+        "Unexpected end of file. Expected attribute value.",
+    "expected-attribute-value-but-got-right-bracket":
+        "Expected attribute value. Got '>' instead.",
+    'equals-in-unquoted-attribute-value':
+        "Unexpected = in unquoted attribute",
+    'unexpected-character-in-unquoted-attribute-value':
+        "Unexpected character in unquoted attribute",
+    "invalid-character-after-attribute-name":
+        "Unexpected character after attribute name.",
+    "unexpected-character-after-attribute-value":
+        "Unexpected character after attribute value.",
+    "eof-in-attribute-value-double-quote":
+        "Unexpected end of file in attribute value (\").",
+    "eof-in-attribute-value-single-quote":
+        "Unexpected end of file in attribute value (').",
+    "eof-in-attribute-value-no-quotes":
+        "Unexpected end of file in attribute value.",
+    "unexpected-EOF-after-solidus-in-tag":
+        "Unexpected end of file in tag. Expected >",
+    "unexpected-character-after-solidus-in-tag":
+        "Unexpected character after / in tag. Expected >",
+    "expected-dashes-or-doctype":
+        "Expected '--' or 'DOCTYPE'. Not found.",
+    "unexpected-bang-after-double-dash-in-comment":
+        "Unexpected ! after -- in comment",
+    "unexpected-space-after-double-dash-in-comment":
+        "Unexpected space after -- in comment",
+    "incorrect-comment":
+        "Incorrect comment.",
+    "eof-in-comment":
+        "Unexpected end of file in comment.",
+    "eof-in-comment-end-dash":
+        "Unexpected end of file in comment (-)",
+    "unexpected-dash-after-double-dash-in-comment":
+        "Unexpected '-' after '--' found in comment.",
+    "eof-in-comment-double-dash":
+        "Unexpected end of file in comment (--).",
+    "eof-in-comment-end-space-state":
+        "Unexpected end of file in comment.",
+    "eof-in-comment-end-bang-state":
+        "Unexpected end of file in comment.",
+    "unexpected-char-in-comment":
+        "Unexpected character in comment found.",
+    "need-space-after-doctype":
+        "No space after literal string 'DOCTYPE'.",
+    "expected-doctype-name-but-got-right-bracket":
+        "Unexpected > character. Expected DOCTYPE name.",
+    "expected-doctype-name-but-got-eof":
+        "Unexpected end of file. Expected DOCTYPE name.",
+    "eof-in-doctype-name":
+        "Unexpected end of file in DOCTYPE name.",
+    "eof-in-doctype":
+        "Unexpected end of file in DOCTYPE.",
+    "expected-space-or-right-bracket-in-doctype":
+        "Expected space or '>'. Got '%(data)s'",
+    "unexpected-end-of-doctype":
+        "Unexpected end of DOCTYPE.",
+    "unexpected-char-in-doctype":
+        "Unexpected character in DOCTYPE.",
+    "eof-in-innerhtml":
+        "XXX innerHTML EOF",
+    "unexpected-doctype":
+        "Unexpected DOCTYPE. Ignored.",
+    "non-html-root":
+        "html needs to be the first start tag.",
+    "expected-doctype-but-got-eof":
+        "Unexpected End of file. Expected DOCTYPE.",
+    "unknown-doctype":
+        "Erroneous DOCTYPE.",
+    "expected-doctype-but-got-chars":
+        "Unexpected non-space characters. Expected DOCTYPE.",
+    "expected-doctype-but-got-start-tag":
+        "Unexpected start tag (%(name)s). Expected DOCTYPE.",
+    "expected-doctype-but-got-end-tag":
+        "Unexpected end tag (%(name)s). Expected DOCTYPE.",
+    "end-tag-after-implied-root":
+        "Unexpected end tag (%(name)s) after the (implied) root element.",
+    "expected-named-closing-tag-but-got-eof":
+        "Unexpected end of file. Expected end tag (%(name)s).",
+    "two-heads-are-not-better-than-one":
+        "Unexpected start tag head in existing head. Ignored.",
+    "unexpected-end-tag":
+        "Unexpected end tag (%(name)s). Ignored.",
+    "unexpected-start-tag-out-of-my-head":
+        "Unexpected start tag (%(name)s) that can be in head. Moved.",
+    "unexpected-start-tag":
+        "Unexpected start tag (%(name)s).",
+    "missing-end-tag":
+        "Missing end tag (%(name)s).",
+    "missing-end-tags":
+        "Missing end tags (%(name)s).",
+    "unexpected-start-tag-implies-end-tag":
+        "Unexpected start tag (%(startName)s) "
+        "implies end tag (%(endName)s).",
+    "unexpected-start-tag-treated-as":
+        "Unexpected start tag (%(originalName)s). Treated as %(newName)s.",
+    "deprecated-tag":
+        "Unexpected start tag %(name)s. Don't use it!",
+    "unexpected-start-tag-ignored":
+        "Unexpected start tag %(name)s. Ignored.",
+    "expected-one-end-tag-but-got-another":
+        "Unexpected end tag (%(gotName)s). "
+        "Missing end tag (%(expectedName)s).",
+    "end-tag-too-early":
+        "End tag (%(name)s) seen too early. Expected other end tag.",
+    "end-tag-too-early-named":
+        "Unexpected end tag (%(gotName)s). Expected end tag (%(expectedName)s).",
+    "end-tag-too-early-ignored":
+        "End tag (%(name)s) seen too early. Ignored.",
+    "adoption-agency-1.1":
+        "End tag (%(name)s) violates step 1, "
+        "paragraph 1 of the adoption agency algorithm.",
+    "adoption-agency-1.2":
+        "End tag (%(name)s) violates step 1, "
+        "paragraph 2 of the adoption agency algorithm.",
+    "adoption-agency-1.3":
+        "End tag (%(name)s) violates step 1, "
+        "paragraph 3 of the adoption agency algorithm.",
+    "adoption-agency-4.4":
+        "End tag (%(name)s) violates step 4, "
+        "paragraph 4 of the adoption agency algorithm.",
+    "unexpected-end-tag-treated-as":
+        "Unexpected end tag (%(originalName)s). Treated as %(newName)s.",
+    "no-end-tag":
+        "This element (%(name)s) has no end tag.",
+    "unexpected-implied-end-tag-in-table":
+        "Unexpected implied end tag (%(name)s) in the table phase.",
+    "unexpected-implied-end-tag-in-table-body":
+        "Unexpected implied end tag (%(name)s) in the table body phase.",
+    "unexpected-char-implies-table-voodoo":
+        "Unexpected non-space characters in "
+        "table context caused voodoo mode.",
+    "unexpected-hidden-input-in-table":
+        "Unexpected input with type hidden in table context.",
+    "unexpected-form-in-table":
+        "Unexpected form in table context.",
+    "unexpected-start-tag-implies-table-voodoo":
+        "Unexpected start tag (%(name)s) in "
+        "table context caused voodoo mode.",
+    "unexpected-end-tag-implies-table-voodoo":
+        "Unexpected end tag (%(name)s) in "
+        "table context caused voodoo mode.",
+    "unexpected-cell-in-table-body":
+        "Unexpected table cell start tag (%(name)s) "
+        "in the table body phase.",
+    "unexpected-cell-end-tag":
+        "Got table cell end tag (%(name)s) "
+        "while required end tags are missing.",
+    "unexpected-end-tag-in-table-body":
+        "Unexpected end tag (%(name)s) in the table body phase. Ignored.",
+    "unexpected-implied-end-tag-in-table-row":
+        "Unexpected implied end tag (%(name)s) in the table row phase.",
+    "unexpected-end-tag-in-table-row":
+        "Unexpected end tag (%(name)s) in the table row phase. Ignored.",
+    "unexpected-select-in-select":
+        "Unexpected select start tag in the select phase "
+        "treated as select end tag.",
+    "unexpected-input-in-select":
+        "Unexpected input start tag in the select phase.",
+    "unexpected-start-tag-in-select":
+        "Unexpected start tag token (%(name)s in the select phase. "
+        "Ignored.",
+    "unexpected-end-tag-in-select":
+        "Unexpected end tag (%(name)s) in the select phase. Ignored.",
+    "unexpected-table-element-start-tag-in-select-in-table":
+        "Unexpected table element start tag (%(name)s) in the select in table phase.",
+    "unexpected-table-element-end-tag-in-select-in-table":
+        "Unexpected table element end tag (%(name)s) in the select in table phase.",
+    "unexpected-char-after-body":
+        "Unexpected non-space characters in the after body phase.",
+    "unexpected-start-tag-after-body":
+        "Unexpected start tag token (%(name)s)"
+        " in the after body phase.",
+    "unexpected-end-tag-after-body":
+        "Unexpected end tag token (%(name)s)"
+        " in the after body phase.",
+    "unexpected-char-in-frameset":
+        "Unexpected characters in the frameset phase. Characters ignored.",
+    "unexpected-start-tag-in-frameset":
+        "Unexpected start tag token (%(name)s)"
+        " in the frameset phase. Ignored.",
+    "unexpected-frameset-in-frameset-innerhtml":
+        "Unexpected end tag token (frameset) "
+        "in the frameset phase (innerHTML).",
+    "unexpected-end-tag-in-frameset":
+        "Unexpected end tag token (%(name)s)"
+        " in the frameset phase. Ignored.",
+    "unexpected-char-after-frameset":
+        "Unexpected non-space characters in the "
+        "after frameset phase. Ignored.",
+    "unexpected-start-tag-after-frameset":
+        "Unexpected start tag (%(name)s)"
+        " in the after frameset phase. Ignored.",
+    "unexpected-end-tag-after-frameset":
+        "Unexpected end tag (%(name)s)"
+        " in the after frameset phase. Ignored.",
+    "unexpected-end-tag-after-body-innerhtml":
+        "Unexpected end tag after body(innerHtml)",
+    "expected-eof-but-got-char":
+        "Unexpected non-space characters. Expected end of file.",
+    "expected-eof-but-got-start-tag":
+        "Unexpected start tag (%(name)s)"
+        ". Expected end of file.",
+    "expected-eof-but-got-end-tag":
+        "Unexpected end tag (%(name)s)"
+        ". Expected end of file.",
+    "eof-in-table":
+        "Unexpected end of file. Expected table content.",
+    "eof-in-select":
+        "Unexpected end of file. Expected select content.",
+    "eof-in-frameset":
+        "Unexpected end of file. Expected frameset content.",
+    "eof-in-script-in-script":
+        "Unexpected end of file. Expected script content.",
+    "eof-in-foreign-lands":
+        "Unexpected end of file. Expected foreign content",
+    "non-void-element-with-trailing-solidus":
+        "Trailing solidus not allowed on element %(name)s",
+    "unexpected-html-element-in-foreign-content":
+        "Element %(name)s not allowed in a non-html context",
+    "unexpected-end-tag-before-html":
+        "Unexpected end tag (%(name)s) before html.",
+    "unexpected-inhead-noscript-tag":
+        "Element %(name)s not allowed in a inhead-noscript context",
+    "eof-in-head-noscript":
+        "Unexpected end of file. Expected inhead-noscript content",
+    "char-in-head-noscript":
+        "Unexpected non-space character. Expected inhead-noscript content",
+    "XXX-undefined-error":
+        "Undefined error (this sucks and should be fixed)",
+}
+
+namespaces = {
+    "html": "http://www.w3.org/1999/xhtml",
+    "mathml": "http://www.w3.org/1998/Math/MathML",
+    "svg": "http://www.w3.org/2000/svg",
+    "xlink": "http://www.w3.org/1999/xlink",
+    "xml": "http://www.w3.org/XML/1998/namespace",
+    "xmlns": "http://www.w3.org/2000/xmlns/"
+}
+
+scopingElements = frozenset([
+    (namespaces["html"], "applet"),
+    (namespaces["html"], "caption"),
+    (namespaces["html"], "html"),
+    (namespaces["html"], "marquee"),
+    (namespaces["html"], "object"),
+    (namespaces["html"], "table"),
+    (namespaces["html"], "td"),
+    (namespaces["html"], "th"),
+    (namespaces["mathml"], "mi"),
+    (namespaces["mathml"], "mo"),
+    (namespaces["mathml"], "mn"),
+    (namespaces["mathml"], "ms"),
+    (namespaces["mathml"], "mtext"),
+    (namespaces["mathml"], "annotation-xml"),
+    (namespaces["svg"], "foreignObject"),
+    (namespaces["svg"], "desc"),
+    (namespaces["svg"], "title"),
+])
+
+formattingElements = frozenset([
+    (namespaces["html"], "a"),
+    (namespaces["html"], "b"),
+    (namespaces["html"], "big"),
+    (namespaces["html"], "code"),
+    (namespaces["html"], "em"),
+    (namespaces["html"], "font"),
+    (namespaces["html"], "i"),
+    (namespaces["html"], "nobr"),
+    (namespaces["html"], "s"),
+    (namespaces["html"], "small"),
+    (namespaces["html"], "strike"),
+    (namespaces["html"], "strong"),
+    (namespaces["html"], "tt"),
+    (namespaces["html"], "u")
+])
+
+specialElements = frozenset([
+    (namespaces["html"], "address"),
+    (namespaces["html"], "applet"),
+    (namespaces["html"], "area"),
+    (namespaces["html"], "article"),
+    (namespaces["html"], "aside"),
+    (namespaces["html"], "base"),
+    (namespaces["html"], "basefont"),
+    (namespaces["html"], "bgsound"),
+    (namespaces["html"], "blockquote"),
+    (namespaces["html"], "body"),
+    (namespaces["html"], "br"),
+    (namespaces["html"], "button"),
+    (namespaces["html"], "caption"),
+    (namespaces["html"], "center"),
+    (namespaces["html"], "col"),
+    (namespaces["html"], "colgroup"),
+    (namespaces["html"], "command"),
+    (namespaces["html"], "dd"),
+    (namespaces["html"], "details"),
+    (namespaces["html"], "dir"),
+    (namespaces["html"], "div"),
+    (namespaces["html"], "dl"),
+    (namespaces["html"], "dt"),
+    (namespaces["html"], "embed"),
+    (namespaces["html"], "fieldset"),
+    (namespaces["html"], "figure"),
+    (namespaces["html"], "footer"),
+    (namespaces["html"], "form"),
+    (namespaces["html"], "frame"),
+    (namespaces["html"], "frameset"),
+    (namespaces["html"], "h1"),
+    (namespaces["html"], "h2"),
+    (namespaces["html"], "h3"),
+    (namespaces["html"], "h4"),
+    (namespaces["html"], "h5"),
+    (namespaces["html"], "h6"),
+    (namespaces["html"], "head"),
+    (namespaces["html"], "header"),
+    (namespaces["html"], "hr"),
+    (namespaces["html"], "html"),
+    (namespaces["html"], "iframe"),
+    # Note that image is commented out in the spec as "this isn't an
+    # element that can end up on the stack, so it doesn't matter,"
+    (namespaces["html"], "image"),
+    (namespaces["html"], "img"),
+    (namespaces["html"], "input"),
+    (namespaces["html"], "isindex"),
+    (namespaces["html"], "li"),
+    (namespaces["html"], "link"),
+    (namespaces["html"], "listing"),
+    (namespaces["html"], "marquee"),
+    (namespaces["html"], "menu"),
+    (namespaces["html"], "meta"),
+    (namespaces["html"], "nav"),
+    (namespaces["html"], "noembed"),
+    (namespaces["html"], "noframes"),
+    (namespaces["html"], "noscript"),
+    (namespaces["html"], "object"),
+    (namespaces["html"], "ol"),
+    (namespaces["html"], "p"),
+    (namespaces["html"], "param"),
+    (namespaces["html"], "plaintext"),
+    (namespaces["html"], "pre"),
+    (namespaces["html"], "script"),
+    (namespaces["html"], "section"),
+    (namespaces["html"], "select"),
+    (namespaces["html"], "style"),
+    (namespaces["html"], "table"),
+    (namespaces["html"], "tbody"),
+    (namespaces["html"], "td"),
+    (namespaces["html"], "textarea"),
+    (namespaces["html"], "tfoot"),
+    (namespaces["html"], "th"),
+    (namespaces["html"], "thead"),
+    (namespaces["html"], "title"),
+    (namespaces["html"], "tr"),
+    (namespaces["html"], "ul"),
+    (namespaces["html"], "wbr"),
+    (namespaces["html"], "xmp"),
+    (namespaces["svg"], "foreignObject")
+])
+
+htmlIntegrationPointElements = frozenset([
+    (namespaces["mathml"], "annotation-xml"),
+    (namespaces["svg"], "foreignObject"),
+    (namespaces["svg"], "desc"),
+    (namespaces["svg"], "title")
+])
+
+mathmlTextIntegrationPointElements = frozenset([
+    (namespaces["mathml"], "mi"),
+    (namespaces["mathml"], "mo"),
+    (namespaces["mathml"], "mn"),
+    (namespaces["mathml"], "ms"),
+    (namespaces["mathml"], "mtext")
+])
+
+adjustSVGAttributes = {
+    "attributename": "attributeName",
+    "attributetype": "attributeType",
+    "basefrequency": "baseFrequency",
+    "baseprofile": "baseProfile",
+    "calcmode": "calcMode",
+    "clippathunits": "clipPathUnits",
+    "contentscripttype": "contentScriptType",
+    "contentstyletype": "contentStyleType",
+    "diffuseconstant": "diffuseConstant",
+    "edgemode": "edgeMode",
+    "externalresourcesrequired": "externalResourcesRequired",
+    "filterres": "filterRes",
+    "filterunits": "filterUnits",
+    "glyphref": "glyphRef",
+    "gradienttransform": "gradientTransform",
+    "gradientunits": "gradientUnits",
+    "kernelmatrix": "kernelMatrix",
+    "kernelunitlength": "kernelUnitLength",
+    "keypoints": "keyPoints",
+    "keysplines": "keySplines",
+    "keytimes": "keyTimes",
+    "lengthadjust": "lengthAdjust",
+    "limitingconeangle": "limitingConeAngle",
+    "markerheight": "markerHeight",
+    "markerunits": "markerUnits",
+    "markerwidth": "markerWidth",
+    "maskcontentunits": "maskContentUnits",
+    "maskunits": "maskUnits",
+    "numoctaves": "numOctaves",
+    "pathlength": "pathLength",
+    "patterncontentunits": "patternContentUnits",
+    "patterntransform": "patternTransform",
+    "patternunits": "patternUnits",
+    "pointsatx": "pointsAtX",
+    "pointsaty": "pointsAtY",
+    "pointsatz": "pointsAtZ",
+    "preservealpha": "preserveAlpha",
+    "preserveaspectratio": "preserveAspectRatio",
+    "primitiveunits": "primitiveUnits",
+    "refx": "refX",
+    "refy": "refY",
+    "repeatcount": "repeatCount",
+    "repeatdur": "repeatDur",
+    "requiredextensions": "requiredExtensions",
+    "requiredfeatures": "requiredFeatures",
+    "specularconstant": "specularConstant",
+    "specularexponent": "specularExponent",
+    "spreadmethod": "spreadMethod",
+    "startoffset": "startOffset",
+    "stddeviation": "stdDeviation",
+    "stitchtiles": "stitchTiles",
+    "surfacescale": "surfaceScale",
+    "systemlanguage": "systemLanguage",
+    "tablevalues": "tableValues",
+    "targetx": "targetX",
+    "targety": "targetY",
+    "textlength": "textLength",
+    "viewbox": "viewBox",
+    "viewtarget": "viewTarget",
+    "xchannelselector": "xChannelSelector",
+    "ychannelselector": "yChannelSelector",
+    "zoomandpan": "zoomAndPan"
+}
+
+adjustMathMLAttributes = {"definitionurl": "definitionURL"}
+
+adjustForeignAttributes = {
+    "xlink:actuate": ("xlink", "actuate", namespaces["xlink"]),
+    "xlink:arcrole": ("xlink", "arcrole", namespaces["xlink"]),
+    "xlink:href": ("xlink", "href", namespaces["xlink"]),
+    "xlink:role": ("xlink", "role", namespaces["xlink"]),
+    "xlink:show": ("xlink", "show", namespaces["xlink"]),
+    "xlink:title": ("xlink", "title", namespaces["xlink"]),
+    "xlink:type": ("xlink", "type", namespaces["xlink"]),
+    "xml:base": ("xml", "base", namespaces["xml"]),
+    "xml:lang": ("xml", "lang", namespaces["xml"]),
+    "xml:space": ("xml", "space", namespaces["xml"]),
+    "xmlns": (None, "xmlns", namespaces["xmlns"]),
+    "xmlns:xlink": ("xmlns", "xlink", namespaces["xmlns"])
+}
+
+unadjustForeignAttributes = dict([((ns, local), qname) for qname, (prefix, local, ns) in
+                                  adjustForeignAttributes.items()])
+
+spaceCharacters = frozenset([
+    "\t",
+    "\n",
+    "\u000C",
+    " ",
+    "\r"
+])
+
+tableInsertModeElements = frozenset([
+    "table",
+    "tbody",
+    "tfoot",
+    "thead",
+    "tr"
+])
+
+asciiLowercase = frozenset(string.ascii_lowercase)
+asciiUppercase = frozenset(string.ascii_uppercase)
+asciiLetters = frozenset(string.ascii_letters)
+digits = frozenset(string.digits)
+hexDigits = frozenset(string.hexdigits)
+
+asciiUpper2Lower = dict([(ord(c), ord(c.lower()))
+                         for c in string.ascii_uppercase])
+
+# Heading elements need to be ordered
+headingElements = (
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6"
+)
+
+voidElements = frozenset([
+    "base",
+    "command",
+    "event-source",
+    "link",
+    "meta",
+    "hr",
+    "br",
+    "img",
+    "embed",
+    "param",
+    "area",
+    "col",
+    "input",
+    "source",
+    "track"
+])
+
+cdataElements = frozenset(['title', 'textarea'])
+
+rcdataElements = frozenset([
+    'style',
+    'script',
+    'xmp',
+    'iframe',
+    'noembed',
+    'noframes',
+    'noscript'
+])
+
+booleanAttributes = {
+    "": frozenset(["irrelevant", "itemscope"]),
+    "style": frozenset(["scoped"]),
+    "img": frozenset(["ismap"]),
+    "audio": frozenset(["autoplay", "controls"]),
+    "video": frozenset(["autoplay", "controls"]),
+    "script": frozenset(["defer", "async"]),
+    "details": frozenset(["open"]),
+    "datagrid": frozenset(["multiple", "disabled"]),
+    "command": frozenset(["hidden", "disabled", "checked", "default"]),
+    "hr": frozenset(["noshade"]),
+    "menu": frozenset(["autosubmit"]),
+    "fieldset": frozenset(["disabled", "readonly"]),
+    "option": frozenset(["disabled", "readonly", "selected"]),
+    "optgroup": frozenset(["disabled", "readonly"]),
+    "button": frozenset(["disabled", "autofocus"]),
+    "input": frozenset(["disabled", "readonly", "required", "autofocus", "checked", "ismap"]),
+    "select": frozenset(["disabled", "readonly", "autofocus", "multiple"]),
+    "output": frozenset(["disabled", "readonly"]),
+    "iframe": frozenset(["seamless"]),
+}
+
+# entitiesWindows1252 has to be _ordered_ and needs to have an index. It
+# therefore can't be a frozenset.
+entitiesWindows1252 = (
+    8364,   # 0x80  0x20AC  EURO SIGN
+    65533,  # 0x81          UNDEFINED
+    8218,   # 0x82  0x201A  SINGLE LOW-9 QUOTATION MARK
+    402,    # 0x83  0x0192  LATIN SMALL LETTER F WITH HOOK
+    8222,   # 0x84  0x201E  DOUBLE LOW-9 QUOTATION MARK
+    8230,   # 0x85  0x2026  HORIZONTAL ELLIPSIS
+    8224,   # 0x86  0x2020  DAGGER
+    8225,   # 0x87  0x2021  DOUBLE DAGGER
+    710,    # 0x88  0x02C6  MODIFIER LETTER CIRCUMFLEX ACCENT
+    8240,   # 0x89  0x2030  PER MILLE SIGN
+    352,    # 0x8A  0x0160  LATIN CAPITAL LETTER S WITH CARON
+    8249,   # 0x8B  0x2039  SINGLE LEFT-POINTING ANGLE QUOTATION MARK
+    338,    # 0x8C  0x0152  LATIN CAPITAL LIGATURE OE
+    65533,  # 0x8D          UNDEFINED
+    381,    # 0x8E  0x017D  LATIN CAPITAL LETTER Z WITH CARON
+    65533,  # 0x8F          UNDEFINED
+    65533,  # 0x90          UNDEFINED
+    8216,   # 0x91  0x2018  LEFT SINGLE QUOTATION MARK
+    8217,   # 0x92  0x2019  RIGHT SINGLE QUOTATION MARK
+    8220,   # 0x93  0x201C  LEFT DOUBLE QUOTATION MARK
+    8221,   # 0x94  0x201D  RIGHT DOUBLE QUOTATION MARK
+    8226,   # 0x95  0x2022  BULLET
+    8211,   # 0x96  0x2013  EN DASH
+    8212,   # 0x97  0x2014  EM DASH
+    732,    # 0x98  0x02DC  SMALL TILDE
+    8482,   # 0x99  0x2122  TRADE MARK SIGN
+    353,    # 0x9A  0x0161  LATIN SMALL LETTER S WITH CARON
+    8250,   # 0x9B  0x203A  SINGLE RIGHT-POINTING ANGLE QUOTATION MARK
+    339,    # 0x9C  0x0153  LATIN SMALL LIGATURE OE
+    65533,  # 0x9D          UNDEFINED
+    382,    # 0x9E  0x017E  LATIN SMALL LETTER Z WITH CARON
+    376     # 0x9F  0x0178  LATIN CAPITAL LETTER Y WITH DIAERESIS
+)
+
+xmlEntities = frozenset(['lt;', 'gt;', 'amp;', 'apos;', 'quot;'])
+
+entities = {
+    "AElig": "\xc6",
+    "AElig;": "\xc6",
+    "AMP": "&",
+    "AMP;": "&",
+    "Aacute": "\xc1",
+    "Aacute;": "\xc1",
+    "Abreve;": "\u0102",
+    "Acirc": "\xc2",
+    "Acirc;": "\xc2",
+    "Acy;": "\u0410",
+    "Afr;": "\U0001d504",
+    "Agrave": "\xc0",
+    "Agrave;": "\xc0",
+    "Alpha;": "\u0391",
+    "Amacr;": "\u0100",
+    "And;": "\u2a53",
+    "Aogon;": "\u0104",
+    "Aopf;": "\U0001d538",
+    "ApplyFunction;": "\u2061",
+    "Aring": "\xc5",
+    "Aring;": "\xc5",
+    "Ascr;": "\U0001d49c",
+    "Assign;": "\u2254",
+    "Atilde": "\xc3",
+    "Atilde;": "\xc3",
+    "Auml": "\xc4",
+    "Auml;": "\xc4",
+    "Backslash;": "\u2216",
+    "Barv;": "\u2ae7",
+    "Barwed;": "\u2306",
+    "Bcy;": "\u0411",
+    "Because;": "\u2235",
+    "Bernoullis;": "\u212c",
+    "Beta;": "\u0392",
+    "Bfr;": "\U0001d505",
+    "Bopf;": "\U0001d539",
+    "Breve;": "\u02d8",
+    "Bscr;": "\u212c",
+    "Bumpeq;": "\u224e",
+    "CHcy;": "\u0427",
+    "COPY": "\xa9",
+    "COPY;": "\xa9",
+    "Cacute;": "\u0106",
+    "Cap;": "\u22d2",
+    "CapitalDifferentialD;": "\u2145",
+    "Cayleys;": "\u212d",
+    "Ccaron;": "\u010c",
+    "Ccedil": "\xc7",
+    "Ccedil;": "\xc7",
+    "Ccirc;": "\u0108",
+    "Cconint;": "\u2230",
+    "Cdot;": "\u010a",
+    "Cedilla;": "\xb8",
+    "CenterDot;": "\xb7",
+    "Cfr;": "\u212d",
+    "Chi;": "\u03a7",
+    "CircleDot;": "\u2299",
+    "CircleMinus;": "\u2296",
+    "CirclePlus;": "\u2295",
+    "CircleTimes;": "\u2297",
+    "ClockwiseContourIntegral;": "\u2232",
+    "CloseCurlyDoubleQuote;": "\u201d",
+    "CloseCurlyQuote;": "\u2019",
+    "Colon;": "\u2237",
+    "Colone;": "\u2a74",
+    "Congruent;": "\u2261",
+    "Conint;": "\u222f",
+    "ContourIntegral;": "\u222e",
+    "Copf;": "\u2102",
+    "Coproduct;": "\u2210",
+    "CounterClockwiseContourIntegral;": "\u2233",
+    "Cross;": "\u2a2f",
+    "Cscr;": "\U0001d49e",
+    "Cup;": "\u22d3",
+    "CupCap;": "\u224d",
+    "DD;": "\u2145",
+    "DDotrahd;": "\u2911",
+    "DJcy;": "\u0402",
+    "DScy;": "\u0405",
+    "DZcy;": "\u040f",
+    "Dagger;": "\u2021",
+    "Darr;": "\u21a1",
+    "Dashv;": "\u2ae4",
+    "Dcaron;": "\u010e",
+    "Dcy;": "\u0414",
+    "Del;": "\u2207",
+    "Delta;": "\u0394",
+    "Dfr;": "\U0001d507",
+    "DiacriticalAcute;": "\xb4",
+    "DiacriticalDot;": "\u02d9",
+    "DiacriticalDoubleAcute;": "\u02dd",
+    "DiacriticalGrave;": "`",
+    "DiacriticalTilde;": "\u02dc",
+    "Diamond;": "\u22c4",
+    "DifferentialD;": "\u2146",
+    "Dopf;": "\U0001d53b",
+    "Dot;": "\xa8",
+    "DotDot;": "\u20dc",
+    "DotEqual;": "\u2250",
+    "DoubleContourIntegral;": "\u222f",
+    "DoubleDot;": "\xa8",
+    "DoubleDownArrow;": "\u21d3",
+    "DoubleLeftArrow;": "\u21d0",
+    "DoubleLeftRightArrow;": "\u21d4",
+    "DoubleLeftTee;": "\u2ae4",
+    "DoubleLongLeftArrow;": "\u27f8",
+    "DoubleLongLeftRightArrow;": "\u27fa",
+    "DoubleLongRightArrow;": "\u27f9",
+    "DoubleRightArrow;": "\u21d2",
+    "DoubleRightTee;": "\u22a8",
+    "DoubleUpArrow;": "\u21d1",
+    "DoubleUpDownArrow;": "\u21d5",
+    "DoubleVerticalBar;": "\u2225",
+    "DownArrow;": "\u2193",
+    "DownArrowBar;": "\u2913",
+    "DownArrowUpArrow;": "\u21f5",
+    "DownBreve;": "\u0311",
+    "DownLeftRightVector;": "\u2950",
+    "DownLeftTeeVector;": "\u295e",
+    "DownLeftVector;": "\u21bd",
+    "DownLeftVectorBar;": "\u2956",
+    "DownRightTeeVector;": "\u295f",
+    "DownRightVector;": "\u21c1",
+    "DownRightVectorBar;": "\u2957",
+    "DownTee;": "\u22a4",
+    "DownTeeArrow;": "\u21a7",
+    "Downarrow;": "\u21d3",
+    "Dscr;": "\U0001d49f",
+    "Dstrok;": "\u0110",
+    "ENG;": "\u014a",
+    "ETH": "\xd0",
+    "ETH;": "\xd0",
+    "Eacute": "\xc9",
+    "Eacute;": "\xc9",
+    "Ecaron;": "\u011a",
+    "Ecirc": "\xca",
+    "Ecirc;": "\xca",
+    "Ecy;": "\u042d",
+    "Edot;": "\u0116",
+    "Efr;": "\U0001d508",
+    "Egrave": "\xc8",
+    "Egrave;": "\xc8",
+    "Element;": "\u2208",
+    "Emacr;": "\u0112",
+    "EmptySmallSquare;": "\u25fb",
+    "EmptyVerySmallSquare;": "\u25ab",
+    "Eogon;": "\u0118",
+    "Eopf;": "\U0001d53c",
+    "Epsilon;": "\u0395",
+    "Equal;": "\u2a75",
+    "EqualTilde;": "\u2242",
+    "Equilibrium;": "\u21cc",
+    "Escr;": "\u2130",
+    "Esim;": "\u2a73",
+    "Eta;": "\u0397",
+    "Euml": "\xcb",
+    "Euml;": "\xcb",
+    "Exists;": "\u2203",
+    "ExponentialE;": "\u2147",
+    "Fcy;": "\u0424",
+    "Ffr;": "\U0001d509",
+    "FilledSmallSquare;": "\u25fc",
+    "FilledVerySmallSquare;": "\u25aa",
+    "Fopf;": "\U0001d53d",
+    "ForAll;": "\u2200",
+    "Fouriertrf;": "\u2131",
+    "Fscr;": "\u2131",
+    "GJcy;": "\u0403",
+    "GT": ">",
+    "GT;": ">",
+    "Gamma;": "\u0393",
+    "Gammad;": "\u03dc",
+    "Gbreve;": "\u011e",
+    "Gcedil;": "\u0122",
+    "Gcirc;": "\u011c",
+    "Gcy;": "\u0413",
+    "Gdot;": "\u0120",
+    "Gfr;": "\U0001d50a",
+    "Gg;": "\u22d9",
+    "Gopf;": "\U0001d53e",
+    "GreaterEqual;": "\u2265",
+    "GreaterEqualLess;": "\u22db",
+    "GreaterFullEqual;": "\u2267",
+    "GreaterGreater;": "\u2aa2",
+    "GreaterLess;": "\u2277",
+    "GreaterSlantEqual;": "\u2a7e",
+    "GreaterTilde;": "\u2273",
+    "Gscr;": "\U0001d4a2",
+    "Gt;": "\u226b",
+    "HARDcy;": "\u042a",
+    "Hacek;": "\u02c7",
+    "Hat;": "^",
+    "Hcirc;": "\u0124",
+    "Hfr;": "\u210c",
+    "HilbertSpace;": "\u210b",
+    "Hopf;": "\u210d",
+    "HorizontalLine;": "\u2500",
+    "Hscr;": "\u210b",
+    "Hstrok;": "\u0126",
+    "HumpDownHump;": "\u224e",
+    "HumpEqual;": "\u224f",
+    "IEcy;": "\u0415",
+    "IJlig;": "\u0132",
+    "IOcy;": "\u0401",
+    "Iacute": "\xcd",
+    "Iacute;": "\xcd",
+    "Icirc": "\xce",
+    "Icirc;": "\xce",
+    "Icy;": "\u0418",
+    "Idot;": "\u0130",
+    "Ifr;": "\u2111",
+    "Igrave": "\xcc",
+    "Igrave;": "\xcc",
+    "Im;": "\u2111",
+    "Imacr;": "\u012a",
+    "ImaginaryI;": "\u2148",
+    "Implies;": "\u21d2",
+    "Int;": "\u222c",
+    "Integral;": "\u222b",
+    "Intersection;": "\u22c2",
+    "InvisibleComma;": "\u2063",
+    "InvisibleTimes;": "\u2062",
+    "Iogon;": "\u012e",
+    "Iopf;": "\U0001d540",
+    "Iota;": "\u0399",
+    "Iscr;": "\u2110",
+    "Itilde;": "\u0128",
+    "Iukcy;": "\u0406",
+    "Iuml": "\xcf",
+    "Iuml;": "\xcf",
+    "Jcirc;": "\u0134",
+    "Jcy;": "\u0419",
+    "Jfr;": "\U0001d50d",
+    "Jopf;": "\U0001d541",
+    "Jscr;": "\U0001d4a5",
+    "Jsercy;": "\u0408",
+    "Jukcy;": "\u0404",
+    "KHcy;": "\u0425",
+    "KJcy;": "\u040c",
+    "Kappa;": "\u039a",
+    "Kcedil;": "\u0136",
+    "Kcy;": "\u041a",
+    "Kfr;": "\U0001d50e",
+    "Kopf;": "\U0001d542",
+    "Kscr;": "\U0001d4a6",
+    "LJcy;": "\u0409",
+    "LT": "<",
+    "LT;": "<",
+    "Lacute;": "\u0139",
+    "Lambda;": "\u039b",
+    "Lang;": "\u27ea",
+    "Laplacetrf;": "\u2112",
+    "Larr;": "\u219e",
+    "Lcaron;": "\u013d",
+    "Lcedil;": "\u013b",
+    "Lcy;": "\u041b",
+    "LeftAngleBracket;": "\u27e8",
+    "LeftArrow;": "\u2190",
+    "LeftArrowBar;": "\u21e4",
+    "LeftArrowRightArrow;": "\u21c6",
+    "LeftCeiling;": "\u2308",
+    "LeftDoubleBracket;": "\u27e6",
+    "LeftDownTeeVector;": "\u2961",
+    "LeftDownVector;": "\u21c3",
+    "LeftDownVectorBar;": "\u2959",
+    "LeftFloor;": "\u230a",
+    "LeftRightArrow;": "\u2194",
+    "LeftRightVector;": "\u294e",
+    "LeftTee;": "\u22a3",
+    "LeftTeeArrow;": "\u21a4",
+    "LeftTeeVector;": "\u295a",
+    "LeftTriangle;": "\u22b2",
+    "LeftTriangleBar;": "\u29cf",
+    "LeftTriangleEqual;": "\u22b4",
+    "LeftUpDownVector;": "\u2951",
+    "LeftUpTeeVector;": "\u2960",
+    "LeftUpVector;": "\u21bf",
+    "LeftUpVectorBar;": "\u2958",
+    "LeftVector;": "\u21bc",
+    "LeftVectorBar;": "\u2952",
+    "Leftarrow;": "\u21d0",
+    "Leftrightarrow;": "\u21d4",
+    "LessEqualGreater;": "\u22da",
+    "LessFullEqual;": "\u2266",
+    "LessGreater;": "\u2276",
+    "LessLess;": "\u2aa1",
+    "LessSlantEqual;": "\u2a7d",
+    "LessTilde;": "\u2272",
+    "Lfr;": "\U0001d50f",
+    "Ll;": "\u22d8",
+    "Lleftarrow;": "\u21da",
+    "Lmidot;": "\u013f",
+    "LongLeftArrow;": "\u27f5",
+    "LongLeftRightArrow;": "\u27f7",
+    "LongRightArrow;": "\u27f6",
+    "Longleftarrow;": "\u27f8",
+    "Longleftrightarrow;": "\u27fa",
+    "Longrightarrow;": "\u27f9",
+    "Lopf;": "\U0001d543",
+    "LowerLeftArrow;": "\u2199",
+    "LowerRightArrow;": "\u2198",
+    "Lscr;": "\u2112",
+    "Lsh;": "\u21b0",
+    "Lstrok;": "\u0141",
+    "Lt;": "\u226a",
+    "Map;": "\u2905",
+    "Mcy;": "\u041c",
+    "MediumSpace;": "\u205f",
+    "Mellintrf;": "\u2133",
+    "Mfr;": "\U0001d510",
+    "MinusPlus;": "\u2213",
+    "Mopf;": "\U0001d544",
+    "Mscr;": "\u2133",
+    "Mu;": "\u039c",
+    "NJcy;": "\u040a",
+    "Nacute;": "\u0143",
+    "Ncaron;": "\u0147",
+    "Ncedil;": "\u0145",
+    "Ncy;": "\u041d",
+    "NegativeMediumSpace;": "\u200b",
+    "NegativeThickSpace;": "\u200b",
+    "NegativeThinSpace;": "\u200b",
+    "NegativeVeryThinSpace;": "\u200b",
+    "NestedGreaterGreater;": "\u226b",
+    "NestedLessLess;": "\u226a",
+    "NewLine;": "\n",
+    "Nfr;": "\U0001d511",
+    "NoBreak;": "\u2060",
+    "NonBreakingSpace;": "\xa0",
+    "Nopf;": "\u2115",
+    "Not;": "\u2aec",
+    "NotCongruent;": "\u2262",
+    "NotCupCap;": "\u226d",
+    "NotDoubleVerticalBar;": "\u2226",
+    "NotElement;": "\u2209",
+    "NotEqual;": "\u2260",
+    "NotEqualTilde;": "\u2242\u0338",
+    "NotExists;": "\u2204",
+    "NotGreater;": "\u226f",
+    "NotGreaterEqual;": "\u2271",
+    "NotGreaterFullEqual;": "\u2267\u0338",
+    "NotGreaterGreater;": "\u226b\u0338",
+    "NotGreaterLess;": "\u2279",
+    "NotGreaterSlantEqual;": "\u2a7e\u0338",
+    "NotGreaterTilde;": "\u2275",
+    "NotHumpDownHump;": "\u224e\u0338",
+    "NotHumpEqual;": "\u224f\u0338",
+    "NotLeftTriangle;": "\u22ea",
+    "NotLeftTriangleBar;": "\u29cf\u0338",
+    "NotLeftTriangleEqual;": "\u22ec",
+    "NotLess;": "\u226e",
+    "NotLessEqual;": "\u2270",
+    "NotLessGreater;": "\u2278",
+    "NotLessLess;": "\u226a\u0338",
+    "NotLessSlantEqual;": "\u2a7d\u0338",
+    "NotLessTilde;": "\u2274",
+    "NotNestedGreaterGreater;": "\u2aa2\u0338",
+    "NotNestedLessLess;": "\u2aa1\u0338",
+    "NotPrecedes;": "\u2280",
+    "NotPrecedesEqual;": "\u2aaf\u0338",
+    "NotPrecedesSlantEqual;": "\u22e0",
+    "NotReverseElement;": "\u220c",
+    "NotRightTriangle;": "\u22eb",
+    "NotRightTriangleBar;": "\u29d0\u0338",
+    "NotRightTriangleEqual;": "\u22ed",
+    "NotSquareSubset;": "\u228f\u0338",
+    "NotSquareSubsetEqual;": "\u22e2",
+    "NotSquareSuperset;": "\u2290\u0338",
+    "NotSquareSupersetEqual;": "\u22e3",
+    "NotSubset;": "\u2282\u20d2",
+    "NotSubsetEqual;": "\u2288",
+    "NotSucceeds;": "\u2281",
+    "NotSucceedsEqual;": "\u2ab0\u0338",
+    "NotSucceedsSlantEqual;": "\u22e1",
+    "NotSucceedsTilde;": "\u227f\u0338",
+    "NotSuperset;": "\u2283\u20d2",
+    "NotSupersetEqual;": "\u2289",
+    "NotTilde;": "\u2241",
+    "NotTildeEqual;": "\u2244",
+    "NotTildeFullEqual;": "\u2247",
+    "NotTildeTilde;": "\u2249",
+    "NotVerticalBar;": "\u2224",
+    "Nscr;": "\U0001d4a9",
+    "Ntilde": "\xd1",
+    "Ntilde;": "\xd1",
+    "Nu;": "\u039d",
+    "OElig;": "\u0152",
+    "Oacute": "\xd3",
+    "Oacute;": "\xd3",
+    "Ocirc": "\xd4",
+    "Ocirc;": "\xd4",
+    "Ocy;": "\u041e",
+    "Odblac;": "\u0150",
+    "Ofr;": "\U0001d512",
+    "Ograve": "\xd2",
+    "Ograve;": "\xd2",
+    "Omacr;": "\u014c",
+    "Omega;": "\u03a9",
+    "Omicron;": "\u039f",
+    "Oopf;": "\U0001d546",
+    "OpenCurlyDoubleQuote;": "\u201c",
+    "OpenCurlyQuote;": "\u2018",
+    "Or;": "\u2a54",
+    "Oscr;": "\U0001d4aa",
+    "Oslash": "\xd8",
+    "Oslash;": "\xd8",
+    "Otilde": "\xd5",
+    "Otilde;": "\xd5",
+    "Otimes;": "\u2a37",
+    "Ouml": "\xd6",
+    "Ouml;": "\xd6",
+    "OverBar;": "\u203e",
+    "OverBrace;": "\u23de",
+    "OverBracket;": "\u23b4",
+    "OverParenthesis;": "\u23dc",
+    "PartialD;": "\u2202",
+    "Pcy;": "\u041f",
+    "Pfr;": "\U0001d513",
+    "Phi;": "\u03a6",
+    "Pi;": "\u03a0",
+    "PlusMinus;": "\xb1",
+    "Poincareplane;": "\u210c",
+    "Popf;": "\u2119",
+    "Pr;": "\u2abb",
+    "Precedes;": "\u227a",
+    "PrecedesEqual;": "\u2aaf",
+    "PrecedesSlantEqual;": "\u227c",
+    "PrecedesTilde;": "\u227e",
+    "Prime;": "\u2033",
+    "Product;": "\u220f",
+    "Proportion;": "\u2237",
+    "Proportional;": "\u221d",
+    "Pscr;": "\U0001d4ab",
+    "Psi;": "\u03a8",
+    "QUOT": "\"",
+    "QUOT;": "\"",
+    "Qfr;": "\U0001d514",
+    "Qopf;": "\u211a",
+    "Qscr;": "\U0001d4ac",
+    "RBarr;": "\u2910",
+    "REG": "\xae",
+    "REG;": "\xae",
+    "Racute;": "\u0154",
+    "Rang;": "\u27eb",
+    "Rarr;": "\u21a0",
+    "Rarrtl;": "\u2916",
+    "Rcaron;": "\u0158",
+    "Rcedil;": "\u0156",
+    "Rcy;": "\u0420",
+    "Re;": "\u211c",
+    "ReverseElement;": "\u220b",
+    "ReverseEquilibrium;": "\u21cb",
+    "ReverseUpEquilibrium;": "\u296f",
+    "Rfr;": "\u211c",
+    "Rho;": "\u03a1",
+    "RightAngleBracket;": "\u27e9",
+    "RightArrow;": "\u2192",
+    "RightArrowBar;": "\u21e5",
+    "RightArrowLeftArrow;": "\u21c4",
+    "RightCeiling;": "\u2309",
+    "RightDoubleBracket;": "\u27e7",
+    "RightDownTeeVector;": "\u295d",
+    "RightDownVector;": "\u21c2",
+    "RightDownVectorBar;": "\u2955",
+    "RightFloor;": "\u230b",
+    "RightTee;": "\u22a2",
+    "RightTeeArrow;": "\u21a6",
+    "RightTeeVector;": "\u295b",
+    "RightTriangle;": "\u22b3",
+    "RightTriangleBar;": "\u29d0",
+    "RightTriangleEqual;": "\u22b5",
+    "RightUpDownVector;": "\u294f",
+    "RightUpTeeVector;": "\u295c",
+    "RightUpVector;": "\u21be",
+    "RightUpVectorBar;": "\u2954",
+    "RightVector;": "\u21c0",
+    "RightVectorBar;": "\u2953",
+    "Rightarrow;": "\u21d2",
+    "Ropf;": "\u211d",
+    "RoundImplies;": "\u2970",
+    "Rrightarrow;": "\u21db",
+    "Rscr;": "\u211b",
+    "Rsh;": "\u21b1",
+    "RuleDelayed;": "\u29f4",
+    "SHCHcy;": "\u0429",
+    "SHcy;": "\u0428",
+    "SOFTcy;": "\u042c",
+    "Sacute;": "\u015a",
+    "Sc;": "\u2abc",
+    "Scaron;": "\u0160",
+    "Scedil;": "\u015e",
+    "Scirc;": "\u015c",
+    "Scy;": "\u0421",
+    "Sfr;": "\U0001d516",
+    "ShortDownArrow;": "\u2193",
+    "ShortLeftArrow;": "\u2190",
+    "ShortRightArrow;": "\u2192",
+    "ShortUpArrow;": "\u2191",
+    "Sigma;": "\u03a3",
+    "SmallCircle;": "\u2218",
+    "Sopf;": "\U0001d54a",
+    "Sqrt;": "\u221a",
+    "Square;": "\u25a1",
+    "SquareIntersection;": "\u2293",
+    "SquareSubset;": "\u228f",
+    "SquareSubsetEqual;": "\u2291",
+    "SquareSuperset;": "\u2290",
+    "SquareSupersetEqual;": "\u2292",
+    "SquareUnion;": "\u2294",
+    "Sscr;": "\U0001d4ae",
+    "Star;": "\u22c6",
+    "Sub;": "\u22d0",
+    "Subset;": "\u22d0",
+    "SubsetEqual;": "\u2286",
+    "Succeeds;": "\u227b",
+    "SucceedsEqual;": "\u2ab0",
+    "SucceedsSlantEqual;": "\u227d",
+    "SucceedsTilde;": "\u227f",
+    "SuchThat;": "\u220b",
+    "Sum;": "\u2211",
+    "Sup;": "\u22d1",
+    "Superset;": "\u2283",
+    "SupersetEqual;": "\u2287",
+    "Supset;": "\u22d1",
+    "THORN": "\xde",
+    "THORN;": "\xde",
+    "TRADE;": "\u2122",
+    "TSHcy;": "\u040b",
+    "TScy;": "\u0426",
+    "Tab;": "\t",
+    "Tau;": "\u03a4",
+    "Tcaron;": "\u0164",
+    "Tcedil;": "\u0162",
+    "Tcy;": "\u0422",
+    "Tfr;": "\U0001d517",
+    "Therefore;": "\u2234",
+    "Theta;": "\u0398",
+    "ThickSpace;": "\u205f\u200a",
+    "ThinSpace;": "\u2009",
+    "Tilde;": "\u223c",
+    "TildeEqual;": "\u2243",
+    "TildeFullEqual;": "\u2245",
+    "TildeTilde;": "\u2248",
+    "Topf;": "\U0001d54b",
+    "TripleDot;": "\u20db",
+    "Tscr;": "\U0001d4af",
+    "Tstrok;": "\u0166",
+    "Uacute": "\xda",
+    "Uacute;": "\xda",
+    "Uarr;": "\u219f",
+    "Uarrocir;": "\u2949",
+    "Ubrcy;": "\u040e",
+    "Ubreve;": "\u016c",
+    "Ucirc": "\xdb",
+    "Ucirc;": "\xdb",
+    "Ucy;": "\u0423",
+    "Udblac;": "\u0170",
+    "Ufr;": "\U0001d518",
+    "Ugrave": "\xd9",
+    "Ugrave;": "\xd9",
+    "Umacr;": "\u016a",
+    "UnderBar;": "_",
+    "UnderBrace;": "\u23df",
+    "UnderBracket;": "\u23b5",
+    "UnderParenthesis;": "\u23dd",
+    "Union;": "\u22c3",
+    "UnionPlus;": "\u228e",
+    "Uogon;": "\u0172",
+    "Uopf;": "\U0001d54c",
+    "UpArrow;": "\u2191",
+    "UpArrowBar;": "\u2912",
+    "UpArrowDownArrow;": "\u21c5",
+    "UpDownArrow;": "\u2195",
+    "UpEquilibrium;": "\u296e",
+    "UpTee;": "\u22a5",
+    "UpTeeArrow;": "\u21a5",
+    "Uparrow;": "\u21d1",
+    "Updownarrow;": "\u21d5",
+    "UpperLeftArrow;": "\u2196",
+    "UpperRightArrow;": "\u2197",
+    "Upsi;": "\u03d2",
+    "Upsilon;": "\u03a5",
+    "Uring;": "\u016e",
+    "Uscr;": "\U0001d4b0",
+    "Utilde;": "\u0168",
+    "Uuml": "\xdc",
+    "Uuml;": "\xdc",
+    "VDash;": "\u22ab",
+    "Vbar;": "\u2aeb",
+    "Vcy;": "\u0412",
+    "Vdash;": "\u22a9",
+    "Vdashl;": "\u2ae6",
+    "Vee;": "\u22c1",
+    "Verbar;": "\u2016",
+    "Vert;": "\u2016",
+    "VerticalBar;": "\u2223",
+    "VerticalLine;": "|",
+    "VerticalSeparator;": "\u2758",
+    "VerticalTilde;": "\u2240",
+    "VeryThinSpace;": "\u200a",
+    "Vfr;": "\U0001d519",
+    "Vopf;": "\U0001d54d",
+    "Vscr;": "\U0001d4b1",
+    "Vvdash;": "\u22aa",
+    "Wcirc;": "\u0174",
+    "Wedge;": "\u22c0",
+    "Wfr;": "\U0001d51a",
+    "Wopf;": "\U0001d54e",
+    "Wscr;": "\U0001d4b2",
+    "Xfr;": "\U0001d51b",
+    "Xi;": "\u039e",
+    "Xopf;": "\U0001d54f",
+    "Xscr;": "\U0001d4b3",
+    "YAcy;": "\u042f",
+    "YIcy;": "\u0407",
+    "YUcy;": "\u042e",
+    "Yacute": "\xdd",
+    "Yacute;": "\xdd",
+    "Ycirc;": "\u0176",
+    "Ycy;": "\u042b",
+    "Yfr;": "\U0001d51c",
+    "Yopf;": "\U0001d550",
+    "Yscr;": "\U0001d4b4",
+    "Yuml;": "\u0178",
+    "ZHcy;": "\u0416",
+    "Zacute;": "\u0179",
+    "Zcaron;": "\u017d",
+    "Zcy;": "\u0417",
+    "Zdot;": "\u017b",
+    "ZeroWidthSpace;": "\u200b",
+    "Zeta;": "\u0396",
+    "Zfr;": "\u2128",
+    "Zopf;": "\u2124",
+    "Zscr;": "\U0001d4b5",
+    "aacute": "\xe1",
+    "aacute;": "\xe1",
+    "abreve;": "\u0103",
+    "ac;": "\u223e",
+    "acE;": "\u223e\u0333",
+    "acd;": "\u223f",
+    "acirc": "\xe2",
+    "acirc;": "\xe2",
+    "acute": "\xb4",
+    "acute;": "\xb4",
+    "acy;": "\u0430",
+    "aelig": "\xe6",
+    "aelig;": "\xe6",
+    "af;": "\u2061",
+    "afr;": "\U0001d51e",
+    "agrave": "\xe0",
+    "agrave;": "\xe0",
+    "alefsym;": "\u2135",
+    "aleph;": "\u2135",
+    "alpha;": "\u03b1",
+    "amacr;": "\u0101",
+    "amalg;": "\u2a3f",
+    "amp": "&",
+    "amp;": "&",
+    "and;": "\u2227",
+    "andand;": "\u2a55",
+    "andd;": "\u2a5c",
+    "andslope;": "\u2a58",
+    "andv;": "\u2a5a",
+    "ang;": "\u2220",
+    "ange;": "\u29a4",
+    "angle;": "\u2220",
+    "angmsd;": "\u2221",
+    "angmsdaa;": "\u29a8",
+    "angmsdab;": "\u29a9",
+    "angmsdac;": "\u29aa",
+    "angmsdad;": "\u29ab",
+    "angmsdae;": "\u29ac",
+    "angmsdaf;": "\u29ad",
+    "angmsdag;": "\u29ae",
+    "angmsdah;": "\u29af",
+    "angrt;": "\u221f",
+    "angrtvb;": "\u22be",
+    "angrtvbd;": "\u299d",
+    "angsph;": "\u2222",
+    "angst;": "\xc5",
+    "angzarr;": "\u237c",
+    "aogon;": "\u0105",
+    "aopf;": "\U0001d552",
+    "ap;": "\u2248",
+    "apE;": "\u2a70",
+    "apacir;": "\u2a6f",
+    "ape;": "\u224a",
+    "apid;": "\u224b",
+    "apos;": "'",
+    "approx;": "\u2248",
+    "approxeq;": "\u224a",
+    "aring": "\xe5",
+    "aring;": "\xe5",
+    "ascr;": "\U0001d4b6",
+    "ast;": "*",
+    "asymp;": "\u2248",
+    "asympeq;": "\u224d",
+    "atilde": "\xe3",
+    "atilde;": "\xe3",
+    "auml": "\xe4",
+    "auml;": "\xe4",
+    "awconint;": "\u2233",
+    "awint;": "\u2a11",
+    "bNot;": "\u2aed",
+    "backcong;": "\u224c",
+    "backepsilon;": "\u03f6",
+    "backprime;": "\u2035",
+    "backsim;": "\u223d",
+    "backsimeq;": "\u22cd",
+    "barvee;": "\u22bd",
+    "barwed;": "\u2305",
+    "barwedge;": "\u2305",
+    "bbrk;": "\u23b5",
+    "bbrktbrk;": "\u23b6",
+    "bcong;": "\u224c",
+    "bcy;": "\u0431",
+    "bdquo;": "\u201e",
+    "becaus;": "\u2235",
+    "because;": "\u2235",
+    "bemptyv;": "\u29b0",
+    "bepsi;": "\u03f6",
+    "bernou;": "\u212c",
+    "beta;": "\u03b2",
+    "beth;": "\u2136",
+    "between;": "\u226c",
+    "bfr;": "\U0001d51f",
+    "bigcap;": "\u22c2",
+    "bigcirc;": "\u25ef",
+    "bigcup;": "\u22c3",
+    "bigodot;": "\u2a00",
+    "bigoplus;": "\u2a01",
+    "bigotimes;": "\u2a02",
+    "bigsqcup;": "\u2a06",
+    "bigstar;": "\u2605",
+    "bigtriangledown;": "\u25bd",
+    "bigtriangleup;": "\u25b3",
+    "biguplus;": "\u2a04",
+    "bigvee;": "\u22c1",
+    "bigwedge;": "\u22c0",
+    "bkarow;": "\u290d",
+    "blacklozenge;": "\u29eb",
+    "blacksquare;": "\u25aa",
+    "blacktriangle;": "\u25b4",
+    "blacktriangledown;": "\u25be",
+    "blacktriangleleft;": "\u25c2",
+    "blacktriangleright;": "\u25b8",
+    "blank;": "\u2423",
+    "blk12;": "\u2592",
+    "blk14;": "\u2591",
+    "blk34;": "\u2593",
+    "block;": "\u2588",
+    "bne;": "=\u20e5",
+    "bnequiv;": "\u2261\u20e5",
+    "bnot;": "\u2310",
+    "bopf;": "\U0001d553",
+    "bot;": "\u22a5",
+    "bottom;": "\u22a5",
+    "bowtie;": "\u22c8",
+    "boxDL;": "\u2557",
+    "boxDR;": "\u2554",
+    "boxDl;": "\u2556",
+    "boxDr;": "\u2553",
+    "boxH;": "\u2550",
+    "boxHD;": "\u2566",
+    "boxHU;": "\u2569",
+    "boxHd;": "\u2564",
+    "boxHu;": "\u2567",
+    "boxUL;": "\u255d",
+    "boxUR;": "\u255a",
+    "boxUl;": "\u255c",
+    "boxUr;": "\u2559",
+    "boxV;": "\u2551",
+    "boxVH;": "\u256c",
+    "boxVL;": "\u2563",
+    "boxVR;": "\u2560",
+    "boxVh;": "\u256b",
+    "boxVl;": "\u2562",
+    "boxVr;": "\u255f",
+    "boxbox;": "\u29c9",
+    "boxdL;": "\u2555",
+    "boxdR;": "\u2552",
+    "boxdl;": "\u2510",
+    "boxdr;": "\u250c",
+    "boxh;": "\u2500",
+    "boxhD;": "\u2565",
+    "boxhU;": "\u2568",
+    "boxhd;": "\u252c",
+    "boxhu;": "\u2534",
+    "boxminus;": "\u229f",
+    "boxplus;": "\u229e",
+    "boxtimes;": "\u22a0",
+    "boxuL;": "\u255b",
+    "boxuR;": "\u2558",
+    "boxul;": "\u2518",
+    "boxur;": "\u2514",
+    "boxv;": "\u2502",
+    "boxvH;": "\u256a",
+    "boxvL;": "\u2561",
+    "boxvR;": "\u255e",
+    "boxvh;": "\u253c",
+    "boxvl;": "\u2524",
+    "boxvr;": "\u251c",
+    "bprime;": "\u2035",
+    "breve;": "\u02d8",
+    "brvbar": "\xa6",
+    "brvbar;": "\xa6",
+    "bscr;": "\U0001d4b7",
+    "bsemi;": "\u204f",
+    "bsim;": "\u223d",
+    "bsime;": "\u22cd",
+    "bsol;": "\\",
+    "bsolb;": "\u29c5",
+    "bsolhsub;": "\u27c8",
+    "bull;": "\u2022",
+    "bullet;": "\u2022",
+    "bump;": "\u224e",
+    "bumpE;": "\u2aae",
+    "bumpe;": "\u224f",
+    "bumpeq;": "\u224f",
+    "cacute;": "\u0107",
+    "cap;": "\u2229",
+    "capand;": "\u2a44",
+    "capbrcup;": "\u2a49",
+    "capcap;": "\u2a4b",
+    "capcup;": "\u2a47",
+    "capdot;": "\u2a40",
+    "caps;": "\u2229\ufe00",
+    "caret;": "\u2041",
+    "caron;": "\u02c7",
+    "ccaps;": "\u2a4d",
+    "ccaron;": "\u010d",
+    "ccedil": "\xe7",
+    "ccedil;": "\xe7",
+    "ccirc;": "\u0109",
+    "ccups;": "\u2a4c",
+    "ccupssm;": "\u2a50",
+    "cdot;": "\u010b",
+    "cedil": "\xb8",
+    "cedil;": "\xb8",
+    "cemptyv;": "\u29b2",
+    "cent": "\xa2",
+    "cent;": "\xa2",
+    "centerdot;": "\xb7",
+    "cfr;": "\U0001d520",
+    "chcy;": "\u0447",
+    "check;": "\u2713",
+    "checkmark;": "\u2713",
+    "chi;": "\u03c7",
+    "cir;": "\u25cb",
+    "cirE;": "\u29c3",
+    "circ;": "\u02c6",
+    "circeq;": "\u2257",
+    "circlearrowleft;": "\u21ba",
+    "circlearrowright;": "\u21bb",
+    "circledR;": "\xae",
+    "circledS;": "\u24c8",
+    "circledast;": "\u229b",
+    "circledcirc;": "\u229a",
+    "circleddash;": "\u229d",
+    "cire;": "\u2257",
+    "cirfnint;": "\u2a10",
+    "cirmid;": "\u2aef",
+    "cirscir;": "\u29c2",
+    "clubs;": "\u2663",
+    "clubsuit;": "\u2663",
+    "colon;": ":",
+    "colone;": "\u2254",
+    "coloneq;": "\u2254",
+    "comma;": ",",
+    "commat;": "@",
+    "comp;": "\u2201",
+    "compfn;": "\u2218",
+    "complement;": "\u2201",
+    "complexes;": "\u2102",
+    "cong;": "\u2245",
+    "congdot;": "\u2a6d",
+    "conint;": "\u222e",
+    "copf;": "\U0001d554",
+    "coprod;": "\u2210",
+    "copy": "\xa9",
+    "copy;": "\xa9",
+    "copysr;": "\u2117",
+    "crarr;": "\u21b5",
+    "cross;": "\u2717",
+    "cscr;": "\U0001d4b8",
+    "csub;": "\u2acf",
+    "csube;": "\u2ad1",
+    "csup;": "\u2ad0",
+    "csupe;": "\u2ad2",
+    "ctdot;": "\u22ef",
+    "cudarrl;": "\u2938",
+    "cudarrr;": "\u2935",
+    "cuepr;": "\u22de",
+    "cuesc;": "\u22df",
+    "cularr;": "\u21b6",
+    "cularrp;": "\u293d",
+    "cup;": "\u222a",
+    "cupbrcap;": "\u2a48",
+    "cupcap;": "\u2a46",
+    "cupcup;": "\u2a4a",
+    "cupdot;": "\u228d",
+    "cupor;": "\u2a45",
+    "cups;": "\u222a\ufe00",
+    "curarr;": "\u21b7",
+    "curarrm;": "\u293c",
+    "curlyeqprec;": "\u22de",
+    "curlyeqsucc;": "\u22df",
+    "curlyvee;": "\u22ce",
+    "curlywedge;": "\u22cf",
+    "curren": "\xa4",
+    "curren;": "\xa4",
+    "curvearrowleft;": "\u21b6",
+    "curvearrowright;": "\u21b7",
+    "cuvee;": "\u22ce",
+    "cuwed;": "\u22cf",
+    "cwconint;": "\u2232",
+    "cwint;": "\u2231",
+    "cylcty;": "\u232d",
+    "dArr;": "\u21d3",
+    "dHar;": "\u2965",
+    "dagger;": "\u2020",
+    "daleth;": "\u2138",
+    "darr;": "\u2193",
+    "dash;": "\u2010",
+    "dashv;": "\u22a3",
+    "dbkarow;": "\u290f",
+    "dblac;": "\u02dd",
+    "dcaron;": "\u010f",
+    "dcy;": "\u0434",
+    "dd;": "\u2146",
+    "ddagger;": "\u2021",
+    "ddarr;": "\u21ca",
+    "ddotseq;": "\u2a77",
+    "deg": "\xb0",
+    "deg;": "\xb0",
+    "delta;": "\u03b4",
+    "demptyv;": "\u29b1",
+    "dfisht;": "\u297f",
+    "dfr;": "\U0001d521",
+    "dharl;": "\u21c3",
+    "dharr;": "\u21c2",
+    "diam;": "\u22c4",
+    "diamond;": "\u22c4",
+    "diamondsuit;": "\u2666",
+    "diams;": "\u2666",
+    "die;": "\xa8",
+    "digamma;": "\u03dd",
+    "disin;": "\u22f2",
+    "div;": "\xf7",
+    "divide": "\xf7",
+    "divide;": "\xf7",
+    "divideontimes;": "\u22c7",
+    "divonx;": "\u22c7",
+    "djcy;": "\u0452",
+    "dlcorn;": "\u231e",
+    "dlcrop;": "\u230d",
+    "dollar;": "$",
+    "dopf;": "\U0001d555",
+    "dot;": "\u02d9",
+    "doteq;": "\u2250",
+    "doteqdot;": "\u2251",
+    "dotminus;": "\u2238",
+    "dotplus;": "\u2214",
+    "dotsquare;": "\u22a1",
+    "doublebarwedge;": "\u2306",
+    "downarrow;": "\u2193",
+    "downdownarrows;": "\u21ca",
+    "downharpoonleft;": "\u21c3",
+    "downharpoonright;": "\u21c2",
+    "drbkarow;": "\u2910",
+    "drcorn;": "\u231f",
+    "drcrop;": "\u230c",
+    "dscr;": "\U0001d4b9",
+    "dscy;": "\u0455",
+    "dsol;": "\u29f6",
+    "dstrok;": "\u0111",
+    "dtdot;": "\u22f1",
+    "dtri;": "\u25bf",
+    "dtrif;": "\u25be",
+    "duarr;": "\u21f5",
+    "duhar;": "\u296f",
+    "dwangle;": "\u29a6",
+    "dzcy;": "\u045f",
+    "dzigrarr;": "\u27ff",
+    "eDDot;": "\u2a77",
+    "eDot;": "\u2251",
+    "eacute": "\xe9",
+    "eacute;": "\xe9",
+    "easter;": "\u2a6e",
+    "ecaron;": "\u011b",
+    "ecir;": "\u2256",
+    "ecirc": "\xea",
+    "ecirc;": "\xea",
+    "ecolon;": "\u2255",
+    "ecy;": "\u044d",
+    "edot;": "\u0117",
+    "ee;": "\u2147",
+    "efDot;": "\u2252",
+    "efr;": "\U0001d522",
+    "eg;": "\u2a9a",
+    "egrave": "\xe8",
+    "egrave;": "\xe8",
+    "egs;": "\u2a96",
+    "egsdot;": "\u2a98",
+    "el;": "\u2a99",
+    "elinters;": "\u23e7",
+    "ell;": "\u2113",
+    "els;": "\u2a95",
+    "elsdot;": "\u2a97",
+    "emacr;": "\u0113",
+    "empty;": "\u2205",
+    "emptyset;": "\u2205",
+    "emptyv;": "\u2205",
+    "emsp13;": "\u2004",
+    "emsp14;": "\u2005",
+    "emsp;": "\u2003",
+    "eng;": "\u014b",
+    "ensp;": "\u2002",
+    "eogon;": "\u0119",
+    "eopf;": "\U0001d556",
+    "epar;": "\u22d5",
+    "eparsl;": "\u29e3",
+    "eplus;": "\u2a71",
+    "epsi;": "\u03b5",
+    "epsilon;": "\u03b5",
+    "epsiv;": "\u03f5",
+    "eqcirc;": "\u2256",
+    "eqcolon;": "\u2255",
+    "eqsim;": "\u2242",
+    "eqslantgtr;": "\u2a96",
+    "eqslantless;": "\u2a95",
+    "equals;": "=",
+    "equest;": "\u225f",
+    "equiv;": "\u2261",
+    "equivDD;": "\u2a78",
+    "eqvparsl;": "\u29e5",
+    "erDot;": "\u2253",
+    "erarr;": "\u2971",
+    "escr;": "\u212f",
+    "esdot;": "\u2250",
+    "esim;": "\u2242",
+    "eta;": "\u03b7",
+    "eth": "\xf0",
+    "eth;": "\xf0",
+    "euml": "\xeb",
+    "euml;": "\xeb",
+    "euro;": "\u20ac",
+    "excl;": "!",
+    "exist;": "\u2203",
+    "expectation;": "\u2130",
+    "exponentiale;": "\u2147",
+    "fallingdotseq;": "\u2252",
+    "fcy;": "\u0444",
+    "female;": "\u2640",
+    "ffilig;": "\ufb03",
+    "fflig;": "\ufb00",
+    "ffllig;": "\ufb04",
+    "ffr;": "\U0001d523",
+    "filig;": "\ufb01",
+    "fjlig;": "fj",
+    "flat;": "\u266d",
+    "fllig;": "\ufb02",
+    "fltns;": "\u25b1",
+    "fnof;": "\u0192",
+    "fopf;": "\U0001d557",
+    "forall;": "\u2200",
+    "fork;": "\u22d4",
+    "forkv;": "\u2ad9",
+    "fpartint;": "\u2a0d",
+    "frac12": "\xbd",
+    "frac12;": "\xbd",
+    "frac13;": "\u2153",
+    "frac14": "\xbc",
+    "frac14;": "\xbc",
+    "frac15;": "\u2155",
+    "frac16;": "\u2159",
+    "frac18;": "\u215b",
+    "frac23;": "\u2154",
+    "frac25;": "\u2156",
+    "frac34": "\xbe",
+    "frac34;": "\xbe",
+    "frac35;": "\u2157",
+    "frac38;": "\u215c",
+    "frac45;": "\u2158",
+    "frac56;": "\u215a",
+    "frac58;": "\u215d",
+    "frac78;": "\u215e",
+    "frasl;": "\u2044",
+    "frown;": "\u2322",
+    "fscr;": "\U0001d4bb",
+    "gE;": "\u2267",
+    "gEl;": "\u2a8c",
+    "gacute;": "\u01f5",
+    "gamma;": "\u03b3",
+    "gammad;": "\u03dd",
+    "gap;": "\u2a86",
+    "gbreve;": "\u011f",
+    "gcirc;": "\u011d",
+    "gcy;": "\u0433",
+    "gdot;": "\u0121",
+    "ge;": "\u2265",
+    "gel;": "\u22db",
+    "geq;": "\u2265",
+    "geqq;": "\u2267",
+    "geqslant;": "\u2a7e",
+    "ges;": "\u2a7e",
+    "gescc;": "\u2aa9",
+    "gesdot;": "\u2a80",
+    "gesdoto;": "\u2a82",
+    "gesdotol;": "\u2a84",
+    "gesl;": "\u22db\ufe00",
+    "gesles;": "\u2a94",
+    "gfr;": "\U0001d524",
+    "gg;": "\u226b",
+    "ggg;": "\u22d9",
+    "gimel;": "\u2137",
+    "gjcy;": "\u0453",
+    "gl;": "\u2277",
+    "glE;": "\u2a92",
+    "gla;": "\u2aa5",
+    "glj;": "\u2aa4",
+    "gnE;": "\u2269",
+    "gnap;": "\u2a8a",
+    "gnapprox;": "\u2a8a",
+    "gne;": "\u2a88",
+    "gneq;": "\u2a88",
+    "gneqq;": "\u2269",
+    "gnsim;": "\u22e7",
+    "gopf;": "\U0001d558",
+    "grave;": "`",
+    "gscr;": "\u210a",
+    "gsim;": "\u2273",
+    "gsime;": "\u2a8e",
+    "gsiml;": "\u2a90",
+    "gt": ">",
+    "gt;": ">",
+    "gtcc;": "\u2aa7",
+    "gtcir;": "\u2a7a",
+    "gtdot;": "\u22d7",
+    "gtlPar;": "\u2995",
+    "gtquest;": "\u2a7c",
+    "gtrapprox;": "\u2a86",
+    "gtrarr;": "\u2978",
+    "gtrdot;": "\u22d7",
+    "gtreqless;": "\u22db",
+    "gtreqqless;": "\u2a8c",
+    "gtrless;": "\u2277",
+    "gtrsim;": "\u2273",
+    "gvertneqq;": "\u2269\ufe00",
+    "gvnE;": "\u2269\ufe00",
+    "hArr;": "\u21d4",
+    "hairsp;": "\u200a",
+    "half;": "\xbd",
+    "hamilt;": "\u210b",
+    "hardcy;": "\u044a",
+    "harr;": "\u2194",
+    "harrcir;": "\u2948",
+    "harrw;": "\u21ad",
+    "hbar;": "\u210f",
+    "hcirc;": "\u0125",
+    "hearts;": "\u2665",
+    "heartsuit;": "\u2665",
+    "hellip;": "\u2026",
+    "hercon;": "\u22b9",
+    "hfr;": "\U0001d525",
+    "hksearow;": "\u2925",
+    "hkswarow;": "\u2926",
+    "hoarr;": "\u21ff",
+    "homtht;": "\u223b",
+    "hookleftarrow;": "\u21a9",
+    "hookrightarrow;": "\u21aa",
+    "hopf;": "\U0001d559",
+    "horbar;": "\u2015",
+    "hscr;": "\U0001d4bd",
+    "hslash;": "\u210f",
+    "hstrok;": "\u0127",
+    "hybull;": "\u2043",
+    "hyphen;": "\u2010",
+    "iacute": "\xed",
+    "iacute;": "\xed",
+    "ic;": "\u2063",
+    "icirc": "\xee",
+    "icirc;": "\xee",
+    "icy;": "\u0438",
+    "iecy;": "\u0435",
+    "iexcl": "\xa1",
+    "iexcl;": "\xa1",
+    "iff;": "\u21d4",
+    "ifr;": "\U0001d526",
+    "igrave": "\xec",
+    "igrave;": "\xec",
+    "ii;": "\u2148",
+    "iiiint;": "\u2a0c",
+    "iiint;": "\u222d",
+    "iinfin;": "\u29dc",
+    "iiota;": "\u2129",
+    "ijlig;": "\u0133",
+    "imacr;": "\u012b",
+    "image;": "\u2111",
+    "imagline;": "\u2110",
+    "imagpart;": "\u2111",
+    "imath;": "\u0131",
+    "imof;": "\u22b7",
+    "imped;": "\u01b5",
+    "in;": "\u2208",
+    "incare;": "\u2105",
+    "infin;": "\u221e",
+    "infintie;": "\u29dd",
+    "inodot;": "\u0131",
+    "int;": "\u222b",
+    "intcal;": "\u22ba",
+    "integers;": "\u2124",
+    "intercal;": "\u22ba",
+    "intlarhk;": "\u2a17",
+    "intprod;": "\u2a3c",
+    "iocy;": "\u0451",
+    "iogon;": "\u012f",
+    "iopf;": "\U0001d55a",
+    "iota;": "\u03b9",
+    "iprod;": "\u2a3c",
+    "iquest": "\xbf",
+    "iquest;": "\xbf",
+    "iscr;": "\U0001d4be",
+    "isin;": "\u2208",
+    "isinE;": "\u22f9",
+    "isindot;": "\u22f5",
+    "isins;": "\u22f4",
+    "isinsv;": "\u22f3",
+    "isinv;": "\u2208",
+    "it;": "\u2062",
+    "itilde;": "\u0129",
+    "iukcy;": "\u0456",
+    "iuml": "\xef",
+    "iuml;": "\xef",
+    "jcirc;": "\u0135",
+    "jcy;": "\u0439",
+    "jfr;": "\U0001d527",
+    "jmath;": "\u0237",
+    "jopf;": "\U0001d55b",
+    "jscr;": "\U0001d4bf",
+    "jsercy;": "\u0458",
+    "jukcy;": "\u0454",
+    "kappa;": "\u03ba",
+    "kappav;": "\u03f0",
+    "kcedil;": "\u0137",
+    "kcy;": "\u043a",
+    "kfr;": "\U0001d528",
+    "kgreen;": "\u0138",
+    "khcy;": "\u0445",
+    "kjcy;": "\u045c",
+    "kopf;": "\U0001d55c",
+    "kscr;": "\U0001d4c0",
+    "lAarr;": "\u21da",
+    "lArr;": "\u21d0",
+    "lAtail;": "\u291b",
+    "lBarr;": "\u290e",
+    "lE;": "\u2266",
+    "lEg;": "\u2a8b",
+    "lHar;": "\u2962",
+    "lacute;": "\u013a",
+    "laemptyv;": "\u29b4",
+    "lagran;": "\u2112",
+    "lambda;": "\u03bb",
+    "lang;": "\u27e8",
+    "langd;": "\u2991",
+    "langle;": "\u27e8",
+    "lap;": "\u2a85",
+    "laquo": "\xab",
+    "laquo;": "\xab",
+    "larr;": "\u2190",
+    "larrb;": "\u21e4",
+    "larrbfs;": "\u291f",
+    "larrfs;": "\u291d",
+    "larrhk;": "\u21a9",
+    "larrlp;": "\u21ab",
+    "larrpl;": "\u2939",
+    "larrsim;": "\u2973",
+    "larrtl;": "\u21a2",
+    "lat;": "\u2aab",
+    "latail;": "\u2919",
+    "late;": "\u2aad",
+    "lates;": "\u2aad\ufe00",
+    "lbarr;": "\u290c",
+    "lbbrk;": "\u2772",
+    "lbrace;": "{",
+    "lbrack;": "[",
+    "lbrke;": "\u298b",
+    "lbrksld;": "\u298f",
+    "lbrkslu;": "\u298d",
+    "lcaron;": "\u013e",
+    "lcedil;": "\u013c",
+    "lceil;": "\u2308",
+    "lcub;": "{",
+    "lcy;": "\u043b",
+    "ldca;": "\u2936",
+    "ldquo;": "\u201c",
+    "ldquor;": "\u201e",
+    "ldrdhar;": "\u2967",
+    "ldrushar;": "\u294b",
+    "ldsh;": "\u21b2",
+    "le;": "\u2264",
+    "leftarrow;": "\u2190",
+    "leftarrowtail;": "\u21a2",
+    "leftharpoondown;": "\u21bd",
+    "leftharpoonup;": "\u21bc",
+    "leftleftarrows;": "\u21c7",
+    "leftrightarrow;": "\u2194",
+    "leftrightarrows;": "\u21c6",
+    "leftrightharpoons;": "\u21cb",
+    "leftrightsquigarrow;": "\u21ad",
+    "leftthreetimes;": "\u22cb",
+    "leg;": "\u22da",
+    "leq;": "\u2264",
+    "leqq;": "\u2266",
+    "leqslant;": "\u2a7d",
+    "les;": "\u2a7d",
+    "lescc;": "\u2aa8",
+    "lesdot;": "\u2a7f",
+    "lesdoto;": "\u2a81",
+    "lesdotor;": "\u2a83",
+    "lesg;": "\u22da\ufe00",
+    "lesges;": "\u2a93",
+    "lessapprox;": "\u2a85",
+    "lessdot;": "\u22d6",
+    "lesseqgtr;": "\u22da",
+    "lesseqqgtr;": "\u2a8b",
+    "lessgtr;": "\u2276",
+    "lesssim;": "\u2272",
+    "lfisht;": "\u297c",
+    "lfloor;": "\u230a",
+    "lfr;": "\U0001d529",
+    "lg;": "\u2276",
+    "lgE;": "\u2a91",
+    "lhard;": "\u21bd",
+    "lharu;": "\u21bc",
+    "lharul;": "\u296a",
+    "lhblk;": "\u2584",
+    "ljcy;": "\u0459",
+    "ll;": "\u226a",
+    "llarr;": "\u21c7",
+    "llcorner;": "\u231e",
+    "llhard;": "\u296b",
+    "lltri;": "\u25fa",
+    "lmidot;": "\u0140",
+    "lmoust;": "\u23b0",
+    "lmoustache;": "\u23b0",
+    "lnE;": "\u2268",
+    "lnap;": "\u2a89",
+    "lnapprox;": "\u2a89",
+    "lne;": "\u2a87",
+    "lneq;": "\u2a87",
+    "lneqq;": "\u2268",
+    "lnsim;": "\u22e6",
+    "loang;": "\u27ec",
+    "loarr;": "\u21fd",
+    "lobrk;": "\u27e6",
+    "longleftarrow;": "\u27f5",
+    "longleftrightarrow;": "\u27f7",
+    "longmapsto;": "\u27fc",
+    "longrightarrow;": "\u27f6",
+    "looparrowleft;": "\u21ab",
+    "looparrowright;": "\u21ac",
+    "lopar;": "\u2985",
+    "lopf;": "\U0001d55d",
+    "loplus;": "\u2a2d",
+    "lotimes;": "\u2a34",
+    "lowast;": "\u2217",
+    "lowbar;": "_",
+    "loz;": "\u25ca",
+    "lozenge;": "\u25ca",
+    "lozf;": "\u29eb",
+    "lpar;": "(",
+    "lparlt;": "\u2993",
+    "lrarr;": "\u21c6",
+    "lrcorner;": "\u231f",
+    "lrhar;": "\u21cb",
+    "lrhard;": "\u296d",
+    "lrm;": "\u200e",
+    "lrtri;": "\u22bf",
+    "lsaquo;": "\u2039",
+    "lscr;": "\U0001d4c1",
+    "lsh;": "\u21b0",
+    "lsim;": "\u2272",
+    "lsime;": "\u2a8d",
+    "lsimg;": "\u2a8f",
+    "lsqb;": "[",
+    "lsquo;": "\u2018",
+    "lsquor;": "\u201a",
+    "lstrok;": "\u0142",
+    "lt": "<",
+    "lt;": "<",
+    "ltcc;": "\u2aa6",
+    "ltcir;": "\u2a79",
+    "ltdot;": "\u22d6",
+    "lthree;": "\u22cb",
+    "ltimes;": "\u22c9",
+    "ltlarr;": "\u2976",
+    "ltquest;": "\u2a7b",
+    "ltrPar;": "\u2996",
+    "ltri;": "\u25c3",
+    "ltrie;": "\u22b4",
+    "ltrif;": "\u25c2",
+    "lurdshar;": "\u294a",
+    "luruhar;": "\u2966",
+    "lvertneqq;": "\u2268\ufe00",
+    "lvnE;": "\u2268\ufe00",
+    "mDDot;": "\u223a",
+    "macr": "\xaf",
+    "macr;": "\xaf",
+    "male;": "\u2642",
+    "malt;": "\u2720",
+    "maltese;": "\u2720",
+    "map;": "\u21a6",
+    "mapsto;": "\u21a6",
+    "mapstodown;": "\u21a7",
+    "mapstoleft;": "\u21a4",
+    "mapstoup;": "\u21a5",
+    "marker;": "\u25ae",
+    "mcomma;": "\u2a29",
+    "mcy;": "\u043c",
+    "mdash;": "\u2014",
+    "measuredangle;": "\u2221",
+    "mfr;": "\U0001d52a",
+    "mho;": "\u2127",
+    "micro": "\xb5",
+    "micro;": "\xb5",
+    "mid;": "\u2223",
+    "midast;": "*",
+    "midcir;": "\u2af0",
+    "middot": "\xb7",
+    "middot;": "\xb7",
+    "minus;": "\u2212",
+    "minusb;": "\u229f",
+    "minusd;": "\u2238",
+    "minusdu;": "\u2a2a",
+    "mlcp;": "\u2adb",
+    "mldr;": "\u2026",
+    "mnplus;": "\u2213",
+    "models;": "\u22a7",
+    "mopf;": "\U0001d55e",
+    "mp;": "\u2213",
+    "mscr;": "\U0001d4c2",
+    "mstpos;": "\u223e",
+    "mu;": "\u03bc",
+    "multimap;": "\u22b8",
+    "mumap;": "\u22b8",
+    "nGg;": "\u22d9\u0338",
+    "nGt;": "\u226b\u20d2",
+    "nGtv;": "\u226b\u0338",
+    "nLeftarrow;": "\u21cd",
+    "nLeftrightarrow;": "\u21ce",
+    "nLl;": "\u22d8\u0338",
+    "nLt;": "\u226a\u20d2",
+    "nLtv;": "\u226a\u0338",
+    "nRightarrow;": "\u21cf",
+    "nVDash;": "\u22af",
+    "nVdash;": "\u22ae",
+    "nabla;": "\u2207",
+    "nacute;": "\u0144",
+    "nang;": "\u2220\u20d2",
+    "nap;": "\u2249",
+    "napE;": "\u2a70\u0338",
+    "napid;": "\u224b\u0338",
+    "napos;": "\u0149",
+    "napprox;": "\u2249",
+    "natur;": "\u266e",
+    "natural;": "\u266e",
+    "naturals;": "\u2115",
+    "nbsp": "\xa0",
+    "nbsp;": "\xa0",
+    "nbump;": "\u224e\u0338",
+    "nbumpe;": "\u224f\u0338",
+    "ncap;": "\u2a43",
+    "ncaron;": "\u0148",
+    "ncedil;": "\u0146",
+    "ncong;": "\u2247",
+    "ncongdot;": "\u2a6d\u0338",
+    "ncup;": "\u2a42",
+    "ncy;": "\u043d",
+    "ndash;": "\u2013",
+    "ne;": "\u2260",
+    "neArr;": "\u21d7",
+    "nearhk;": "\u2924",
+    "nearr;": "\u2197",
+    "nearrow;": "\u2197",
+    "nedot;": "\u2250\u0338",
+    "nequiv;": "\u2262",
+    "nesear;": "\u2928",
+    "nesim;": "\u2242\u0338",
+    "nexist;": "\u2204",
+    "nexists;": "\u2204",
+    "nfr;": "\U0001d52b",
+    "ngE;": "\u2267\u0338",
+    "nge;": "\u2271",
+    "ngeq;": "\u2271",
+    "ngeqq;": "\u2267\u0338",
+    "ngeqslant;": "\u2a7e\u0338",
+    "nges;": "\u2a7e\u0338",
+    "ngsim;": "\u2275",
+    "ngt;": "\u226f",
+    "ngtr;": "\u226f",
+    "nhArr;": "\u21ce",
+    "nharr;": "\u21ae",
+    "nhpar;": "\u2af2",
+    "ni;": "\u220b",
+    "nis;": "\u22fc",
+    "nisd;": "\u22fa",
+    "niv;": "\u220b",
+    "njcy;": "\u045a",
+    "nlArr;": "\u21cd",
+    "nlE;": "\u2266\u0338",
+    "nlarr;": "\u219a",
+    "nldr;": "\u2025",
+    "nle;": "\u2270",
+    "nleftarrow;": "\u219a",
+    "nleftrightarrow;": "\u21ae",
+    "nleq;": "\u2270",
+    "nleqq;": "\u2266\u0338",
+    "nleqslant;": "\u2a7d\u0338",
+    "nles;": "\u2a7d\u0338",
+    "nless;": "\u226e",
+    "nlsim;": "\u2274",
+    "nlt;": "\u226e",
+    "nltri;": "\u22ea",
+    "nltrie;": "\u22ec",
+    "nmid;": "\u2224",
+    "nopf;": "\U0001d55f",
+    "not": "\xac",
+    "not;": "\xac",
+    "notin;": "\u2209",
+    "notinE;": "\u22f9\u0338",
+    "notindot;": "\u22f5\u0338",
+    "notinva;": "\u2209",
+    "notinvb;": "\u22f7",
+    "notinvc;": "\u22f6",
+    "notni;": "\u220c",
+    "notniva;": "\u220c",
+    "notnivb;": "\u22fe",
+    "notnivc;": "\u22fd",
+    "npar;": "\u2226",
+    "nparallel;": "\u2226",
+    "nparsl;": "\u2afd\u20e5",
+    "npart;": "\u2202\u0338",
+    "npolint;": "\u2a14",
+    "npr;": "\u2280",
+    "nprcue;": "\u22e0",
+    "npre;": "\u2aaf\u0338",
+    "nprec;": "\u2280",
+    "npreceq;": "\u2aaf\u0338",
+    "nrArr;": "\u21cf",
+    "nrarr;": "\u219b",
+    "nrarrc;": "\u2933\u0338",
+    "nrarrw;": "\u219d\u0338",
+    "nrightarrow;": "\u219b",
+    "nrtri;": "\u22eb",
+    "nrtrie;": "\u22ed",
+    "nsc;": "\u2281",
+    "nsccue;": "\u22e1",
+    "nsce;": "\u2ab0\u0338",
+    "nscr;": "\U0001d4c3",
+    "nshortmid;": "\u2224",
+    "nshortparallel;": "\u2226",
+    "nsim;": "\u2241",
+    "nsime;": "\u2244",
+    "nsimeq;": "\u2244",
+    "nsmid;": "\u2224",
+    "nspar;": "\u2226",
+    "nsqsube;": "\u22e2",
+    "nsqsupe;": "\u22e3",
+    "nsub;": "\u2284",
+    "nsubE;": "\u2ac5\u0338",
+    "nsube;": "\u2288",
+    "nsubset;": "\u2282\u20d2",
+    "nsubseteq;": "\u2288",
+    "nsubseteqq;": "\u2ac5\u0338",
+    "nsucc;": "\u2281",
+    "nsucceq;": "\u2ab0\u0338",
+    "nsup;": "\u2285",
+    "nsupE;": "\u2ac6\u0338",
+    "nsupe;": "\u2289",
+    "nsupset;": "\u2283\u20d2",
+    "nsupseteq;": "\u2289",
+    "nsupseteqq;": "\u2ac6\u0338",
+    "ntgl;": "\u2279",
+    "ntilde": "\xf1",
+    "ntilde;": "\xf1",
+    "ntlg;": "\u2278",
+    "ntriangleleft;": "\u22ea",
+    "ntrianglelefteq;": "\u22ec",
+    "ntriangleright;": "\u22eb",
+    "ntrianglerighteq;": "\u22ed",
+    "nu;": "\u03bd",
+    "num;": "#",
+    "numero;": "\u2116",
+    "numsp;": "\u2007",
+    "nvDash;": "\u22ad",
+    "nvHarr;": "\u2904",
+    "nvap;": "\u224d\u20d2",
+    "nvdash;": "\u22ac",
+    "nvge;": "\u2265\u20d2",
+    "nvgt;": ">\u20d2",
+    "nvinfin;": "\u29de",
+    "nvlArr;": "\u2902",
+    "nvle;": "\u2264\u20d2",
+    "nvlt;": "<\u20d2",
+    "nvltrie;": "\u22b4\u20d2",
+    "nvrArr;": "\u2903",
+    "nvrtrie;": "\u22b5\u20d2",
+    "nvsim;": "\u223c\u20d2",
+    "nwArr;": "\u21d6",
+    "nwarhk;": "\u2923",
+    "nwarr;": "\u2196",
+    "nwarrow;": "\u2196",
+    "nwnear;": "\u2927",
+    "oS;": "\u24c8",
+    "oacute": "\xf3",
+    "oacute;": "\xf3",
+    "oast;": "\u229b",
+    "ocir;": "\u229a",
+    "ocirc": "\xf4",
+    "ocirc;": "\xf4",
+    "ocy;": "\u043e",
+    "odash;": "\u229d",
+    "odblac;": "\u0151",
+    "odiv;": "\u2a38",
+    "odot;": "\u2299",
+    "odsold;": "\u29bc",
+    "oelig;": "\u0153",
+    "ofcir;": "\u29bf",
+    "ofr;": "\U0001d52c",
+    "ogon;": "\u02db",
+    "ograve": "\xf2",
+    "ograve;": "\xf2",
+    "ogt;": "\u29c1",
+    "ohbar;": "\u29b5",
+    "ohm;": "\u03a9",
+    "oint;": "\u222e",
+    "olarr;": "\u21ba",
+    "olcir;": "\u29be",
+    "olcross;": "\u29bb",
+    "oline;": "\u203e",
+    "olt;": "\u29c0",
+    "omacr;": "\u014d",
+    "omega;": "\u03c9",
+    "omicron;": "\u03bf",
+    "omid;": "\u29b6",
+    "ominus;": "\u2296",
+    "oopf;": "\U0001d560",
+    "opar;": "\u29b7",
+    "operp;": "\u29b9",
+    "oplus;": "\u2295",
+    "or;": "\u2228",
+    "orarr;": "\u21bb",
+    "ord;": "\u2a5d",
+    "order;": "\u2134",
+    "orderof;": "\u2134",
+    "ordf": "\xaa",
+    "ordf;": "\xaa",
+    "ordm": "\xba",
+    "ordm;": "\xba",
+    "origof;": "\u22b6",
+    "oror;": "\u2a56",
+    "orslope;": "\u2a57",
+    "orv;": "\u2a5b",
+    "oscr;": "\u2134",
+    "oslash": "\xf8",
+    "oslash;": "\xf8",
+    "osol;": "\u2298",
+    "otilde": "\xf5",
+    "otilde;": "\xf5",
+    "otimes;": "\u2297",
+    "otimesas;": "\u2a36",
+    "ouml": "\xf6",
+    "ouml;": "\xf6",
+    "ovbar;": "\u233d",
+    "par;": "\u2225",
+    "para": "\xb6",
+    "para;": "\xb6",
+    "parallel;": "\u2225",
+    "parsim;": "\u2af3",
+    "parsl;": "\u2afd",
+    "part;": "\u2202",
+    "pcy;": "\u043f",
+    "percnt;": "%",
+    "period;": ".",
+    "permil;": "\u2030",
+    "perp;": "\u22a5",
+    "pertenk;": "\u2031",
+    "pfr;": "\U0001d52d",
+    "phi;": "\u03c6",
+    "phiv;": "\u03d5",
+    "phmmat;": "\u2133",
+    "phone;": "\u260e",
+    "pi;": "\u03c0",
+    "pitchfork;": "\u22d4",
+    "piv;": "\u03d6",
+    "planck;": "\u210f",
+    "planckh;": "\u210e",
+    "plankv;": "\u210f",
+    "plus;": "+",
+    "plusacir;": "\u2a23",
+    "plusb;": "\u229e",
+    "pluscir;": "\u2a22",
+    "plusdo;": "\u2214",
+    "plusdu;": "\u2a25",
+    "pluse;": "\u2a72",
+    "plusmn": "\xb1",
+    "plusmn;": "\xb1",
+    "plussim;": "\u2a26",
+    "plustwo;": "\u2a27",
+    "pm;": "\xb1",
+    "pointint;": "\u2a15",
+    "popf;": "\U0001d561",
+    "pound": "\xa3",
+    "pound;": "\xa3",
+    "pr;": "\u227a",
+    "prE;": "\u2ab3",
+    "prap;": "\u2ab7",
+    "prcue;": "\u227c",
+    "pre;": "\u2aaf",
+    "prec;": "\u227a",
+    "precapprox;": "\u2ab7",
+    "preccurlyeq;": "\u227c",
+    "preceq;": "\u2aaf",
+    "precnapprox;": "\u2ab9",
+    "precneqq;": "\u2ab5",
+    "precnsim;": "\u22e8",
+    "precsim;": "\u227e",
+    "prime;": "\u2032",
+    "primes;": "\u2119",
+    "prnE;": "\u2ab5",
+    "prnap;": "\u2ab9",
+    "prnsim;": "\u22e8",
+    "prod;": "\u220f",
+    "profalar;": "\u232e",
+    "profline;": "\u2312",
+    "profsurf;": "\u2313",
+    "prop;": "\u221d",
+    "propto;": "\u221d",
+    "prsim;": "\u227e",
+    "prurel;": "\u22b0",
+    "pscr;": "\U0001d4c5",
+    "psi;": "\u03c8",
+    "puncsp;": "\u2008",
+    "qfr;": "\U0001d52e",
+    "qint;": "\u2a0c",
+    "qopf;": "\U0001d562",
+    "qprime;": "\u2057",
+    "qscr;": "\U0001d4c6",
+    "quaternions;": "\u210d",
+    "quatint;": "\u2a16",
+    "quest;": "?",
+    "questeq;": "\u225f",
+    "quot": "\"",
+    "quot;": "\"",
+    "rAarr;": "\u21db",
+    "rArr;": "\u21d2",
+    "rAtail;": "\u291c",
+    "rBarr;": "\u290f",
+    "rHar;": "\u2964",
+    "race;": "\u223d\u0331",
+    "racute;": "\u0155",
+    "radic;": "\u221a",
+    "raemptyv;": "\u29b3",
+    "rang;": "\u27e9",
+    "rangd;": "\u2992",
+    "range;": "\u29a5",
+    "rangle;": "\u27e9",
+    "raquo": "\xbb",
+    "raquo;": "\xbb",
+    "rarr;": "\u2192",
+    "rarrap;": "\u2975",
+    "rarrb;": "\u21e5",
+    "rarrbfs;": "\u2920",
+    "rarrc;": "\u2933",
+    "rarrfs;": "\u291e",
+    "rarrhk;": "\u21aa",
+    "rarrlp;": "\u21ac",
+    "rarrpl;": "\u2945",
+    "rarrsim;": "\u2974",
+    "rarrtl;": "\u21a3",
+    "rarrw;": "\u219d",
+    "ratail;": "\u291a",
+    "ratio;": "\u2236",
+    "rationals;": "\u211a",
+    "rbarr;": "\u290d",
+    "rbbrk;": "\u2773",
+    "rbrace;": "}",
+    "rbrack;": "]",
+    "rbrke;": "\u298c",
+    "rbrksld;": "\u298e",
+    "rbrkslu;": "\u2990",
+    "rcaron;": "\u0159",
+    "rcedil;": "\u0157",
+    "rceil;": "\u2309",
+    "rcub;": "}",
+    "rcy;": "\u0440",
+    "rdca;": "\u2937",
+    "rdldhar;": "\u2969",
+    "rdquo;": "\u201d",
+    "rdquor;": "\u201d",
+    "rdsh;": "\u21b3",
+    "real;": "\u211c",
+    "realine;": "\u211b",
+    "realpart;": "\u211c",
+    "reals;": "\u211d",
+    "rect;": "\u25ad",
+    "reg": "\xae",
+    "reg;": "\xae",
+    "rfisht;": "\u297d",
+    "rfloor;": "\u230b",
+    "rfr;": "\U0001d52f",
+    "rhard;": "\u21c1",
+    "rharu;": "\u21c0",
+    "rharul;": "\u296c",
+    "rho;": "\u03c1",
+    "rhov;": "\u03f1",
+    "rightarrow;": "\u2192",
+    "rightarrowtail;": "\u21a3",
+    "rightharpoondown;": "\u21c1",
+    "rightharpoonup;": "\u21c0",
+    "rightleftarrows;": "\u21c4",
+    "rightleftharpoons;": "\u21cc",
+    "rightrightarrows;": "\u21c9",
+    "rightsquigarrow;": "\u219d",
+    "rightthreetimes;": "\u22cc",
+    "ring;": "\u02da",
+    "risingdotseq;": "\u2253",
+    "rlarr;": "\u21c4",
+    "rlhar;": "\u21cc",
+    "rlm;": "\u200f",
+    "rmoust;": "\u23b1",
+    "rmoustache;": "\u23b1",
+    "rnmid;": "\u2aee",
+    "roang;": "\u27ed",
+    "roarr;": "\u21fe",
+    "robrk;": "\u27e7",
+    "ropar;": "\u2986",
+    "ropf;": "\U0001d563",
+    "roplus;": "\u2a2e",
+    "rotimes;": "\u2a35",
+    "rpar;": ")",
+    "rpargt;": "\u2994",
+    "rppolint;": "\u2a12",
+    "rrarr;": "\u21c9",
+    "rsaquo;": "\u203a",
+    "rscr;": "\U0001d4c7",
+    "rsh;": "\u21b1",
+    "rsqb;": "]",
+    "rsquo;": "\u2019",
+    "rsquor;": "\u2019",
+    "rthree;": "\u22cc",
+    "rtimes;": "\u22ca",
+    "rtri;": "\u25b9",
+    "rtrie;": "\u22b5",
+    "rtrif;": "\u25b8",
+    "rtriltri;": "\u29ce",
+    "ruluhar;": "\u2968",
+    "rx;": "\u211e",
+    "sacute;": "\u015b",
+    "sbquo;": "\u201a",
+    "sc;": "\u227b",
+    "scE;": "\u2ab4",
+    "scap;": "\u2ab8",
+    "scaron;": "\u0161",
+    "sccue;": "\u227d",
+    "sce;": "\u2ab0",
+    "scedil;": "\u015f",
+    "scirc;": "\u015d",
+    "scnE;": "\u2ab6",
+    "scnap;": "\u2aba",
+    "scnsim;": "\u22e9",
+    "scpolint;": "\u2a13",
+    "scsim;": "\u227f",
+    "scy;": "\u0441",
+    "sdot;": "\u22c5",
+    "sdotb;": "\u22a1",
+    "sdote;": "\u2a66",
+    "seArr;": "\u21d8",
+    "searhk;": "\u2925",
+    "searr;": "\u2198",
+    "searrow;": "\u2198",
+    "sect": "\xa7",
+    "sect;": "\xa7",
+    "semi;": ";",
+    "seswar;": "\u2929",
+    "setminus;": "\u2216",
+    "setmn;": "\u2216",
+    "sext;": "\u2736",
+    "sfr;": "\U0001d530",
+    "sfrown;": "\u2322",
+    "sharp;": "\u266f",
+    "shchcy;": "\u0449",
+    "shcy;": "\u0448",
+    "shortmid;": "\u2223",
+    "shortparallel;": "\u2225",
+    "shy": "\xad",
+    "shy;": "\xad",
+    "sigma;": "\u03c3",
+    "sigmaf;": "\u03c2",
+    "sigmav;": "\u03c2",
+    "sim;": "\u223c",
+    "simdot;": "\u2a6a",
+    "sime;": "\u2243",
+    "simeq;": "\u2243",
+    "simg;": "\u2a9e",
+    "simgE;": "\u2aa0",
+    "siml;": "\u2a9d",
+    "simlE;": "\u2a9f",
+    "simne;": "\u2246",
+    "simplus;": "\u2a24",
+    "simrarr;": "\u2972",
+    "slarr;": "\u2190",
+    "smallsetminus;": "\u2216",
+    "smashp;": "\u2a33",
+    "smeparsl;": "\u29e4",
+    "smid;": "\u2223",
+    "smile;": "\u2323",
+    "smt;": "\u2aaa",
+    "smte;": "\u2aac",
+    "smtes;": "\u2aac\ufe00",
+    "softcy;": "\u044c",
+    "sol;": "/",
+    "solb;": "\u29c4",
+    "solbar;": "\u233f",
+    "sopf;": "\U0001d564",
+    "spades;": "\u2660",
+    "spadesuit;": "\u2660",
+    "spar;": "\u2225",
+    "sqcap;": "\u2293",
+    "sqcaps;": "\u2293\ufe00",
+    "sqcup;": "\u2294",
+    "sqcups;": "\u2294\ufe00",
+    "sqsub;": "\u228f",
+    "sqsube;": "\u2291",
+    "sqsubset;": "\u228f",
+    "sqsubseteq;": "\u2291",
+    "sqsup;": "\u2290",
+    "sqsupe;": "\u2292",
+    "sqsupset;": "\u2290",
+    "sqsupseteq;": "\u2292",
+    "squ;": "\u25a1",
+    "square;": "\u25a1",
+    "squarf;": "\u25aa",
+    "squf;": "\u25aa",
+    "srarr;": "\u2192",
+    "sscr;": "\U0001d4c8",
+    "ssetmn;": "\u2216",
+    "ssmile;": "\u2323",
+    "sstarf;": "\u22c6",
+    "star;": "\u2606",
+    "starf;": "\u2605",
+    "straightepsilon;": "\u03f5",
+    "straightphi;": "\u03d5",
+    "strns;": "\xaf",
+    "sub;": "\u2282",
+    "subE;": "\u2ac5",
+    "subdot;": "\u2abd",
+    "sube;": "\u2286",
+    "subedot;": "\u2ac3",
+    "submult;": "\u2ac1",
+    "subnE;": "\u2acb",
+    "subne;": "\u228a",
+    "subplus;": "\u2abf",
+    "subrarr;": "\u2979",
+    "subset;": "\u2282",
+    "subseteq;": "\u2286",
+    "subseteqq;": "\u2ac5",
+    "subsetneq;": "\u228a",
+    "subsetneqq;": "\u2acb",
+    "subsim;": "\u2ac7",
+    "subsub;": "\u2ad5",
+    "subsup;": "\u2ad3",
+    "succ;": "\u227b",
+    "succapprox;": "\u2ab8",
+    "succcurlyeq;": "\u227d",
+    "succeq;": "\u2ab0",
+    "succnapprox;": "\u2aba",
+    "succneqq;": "\u2ab6",
+    "succnsim;": "\u22e9",
+    "succsim;": "\u227f",
+    "sum;": "\u2211",
+    "sung;": "\u266a",
+    "sup1": "\xb9",
+    "sup1;": "\xb9",
+    "sup2": "\xb2",
+    "sup2;": "\xb2",
+    "sup3": "\xb3",
+    "sup3;": "\xb3",
+    "sup;": "\u2283",
+    "supE;": "\u2ac6",
+    "supdot;": "\u2abe",
+    "supdsub;": "\u2ad8",
+    "supe;": "\u2287",
+    "supedot;": "\u2ac4",
+    "suphsol;": "\u27c9",
+    "suphsub;": "\u2ad7",
+    "suplarr;": "\u297b",
+    "supmult;": "\u2ac2",
+    "supnE;": "\u2acc",
+    "supne;": "\u228b",
+    "supplus;": "\u2ac0",
+    "supset;": "\u2283",
+    "supseteq;": "\u2287",
+    "supseteqq;": "\u2ac6",
+    "supsetneq;": "\u228b",
+    "supsetneqq;": "\u2acc",
+    "supsim;": "\u2ac8",
+    "supsub;": "\u2ad4",
+    "supsup;": "\u2ad6",
+    "swArr;": "\u21d9",
+    "swarhk;": "\u2926",
+    "swarr;": "\u2199",
+    "swarrow;": "\u2199",
+    "swnwar;": "\u292a",
+    "szlig": "\xdf",
+    "szlig;": "\xdf",
+    "target;": "\u2316",
+    "tau;": "\u03c4",
+    "tbrk;": "\u23b4",
+    "tcaron;": "\u0165",
+    "tcedil;": "\u0163",
+    "tcy;": "\u0442",
+    "tdot;": "\u20db",
+    "telrec;": "\u2315",
+    "tfr;": "\U0001d531",
+    "there4;": "\u2234",
+    "therefore;": "\u2234",
+    "theta;": "\u03b8",
+    "thetasym;": "\u03d1",
+    "thetav;": "\u03d1",
+    "thickapprox;": "\u2248",
+    "thicksim;": "\u223c",
+    "thinsp;": "\u2009",
+    "thkap;": "\u2248",
+    "thksim;": "\u223c",
+    "thorn": "\xfe",
+    "thorn;": "\xfe",
+    "tilde;": "\u02dc",
+    "times": "\xd7",
+    "times;": "\xd7",
+    "timesb;": "\u22a0",
+    "timesbar;": "\u2a31",
+    "timesd;": "\u2a30",
+    "tint;": "\u222d",
+    "toea;": "\u2928",
+    "top;": "\u22a4",
+    "topbot;": "\u2336",
+    "topcir;": "\u2af1",
+    "topf;": "\U0001d565",
+    "topfork;": "\u2ada",
+    "tosa;": "\u2929",
+    "tprime;": "\u2034",
+    "trade;": "\u2122",
+    "triangle;": "\u25b5",
+    "triangledown;": "\u25bf",
+    "triangleleft;": "\u25c3",
+    "trianglelefteq;": "\u22b4",
+    "triangleq;": "\u225c",
+    "triangleright;": "\u25b9",
+    "trianglerighteq;": "\u22b5",
+    "tridot;": "\u25ec",
+    "trie;": "\u225c",
+    "triminus;": "\u2a3a",
+    "triplus;": "\u2a39",
+    "trisb;": "\u29cd",
+    "tritime;": "\u2a3b",
+    "trpezium;": "\u23e2",
+    "tscr;": "\U0001d4c9",
+    "tscy;": "\u0446",
+    "tshcy;": "\u045b",
+    "tstrok;": "\u0167",
+    "twixt;": "\u226c",
+    "twoheadleftarrow;": "\u219e",
+    "twoheadrightarrow;": "\u21a0",
+    "uArr;": "\u21d1",
+    "uHar;": "\u2963",
+    "uacute": "\xfa",
+    "uacute;": "\xfa",
+    "uarr;": "\u2191",
+    "ubrcy;": "\u045e",
+    "ubreve;": "\u016d",
+    "ucirc": "\xfb",
+    "ucirc;": "\xfb",
+    "ucy;": "\u0443",
+    "udarr;": "\u21c5",
+    "udblac;": "\u0171",
+    "udhar;": "\u296e",
+    "ufisht;": "\u297e",
+    "ufr;": "\U0001d532",
+    "ugrave": "\xf9",
+    "ugrave;": "\xf9",
+    "uharl;": "\u21bf",
+    "uharr;": "\u21be",
+    "uhblk;": "\u2580",
+    "ulcorn;": "\u231c",
+    "ulcorner;": "\u231c",
+    "ulcrop;": "\u230f",
+    "ultri;": "\u25f8",
+    "umacr;": "\u016b",
+    "uml": "\xa8",
+    "uml;": "\xa8",
+    "uogon;": "\u0173",
+    "uopf;": "\U0001d566",
+    "uparrow;": "\u2191",
+    "updownarrow;": "\u2195",
+    "upharpoonleft;": "\u21bf",
+    "upharpoonright;": "\u21be",
+    "uplus;": "\u228e",
+    "upsi;": "\u03c5",
+    "upsih;": "\u03d2",
+    "upsilon;": "\u03c5",
+    "upuparrows;": "\u21c8",
+    "urcorn;": "\u231d",
+    "urcorner;": "\u231d",
+    "urcrop;": "\u230e",
+    "uring;": "\u016f",
+    "urtri;": "\u25f9",
+    "uscr;": "\U0001d4ca",
+    "utdot;": "\u22f0",
+    "utilde;": "\u0169",
+    "utri;": "\u25b5",
+    "utrif;": "\u25b4",
+    "uuarr;": "\u21c8",
+    "uuml": "\xfc",
+    "uuml;": "\xfc",
+    "uwangle;": "\u29a7",
+    "vArr;": "\u21d5",
+    "vBar;": "\u2ae8",
+    "vBarv;": "\u2ae9",
+    "vDash;": "\u22a8",
+    "vangrt;": "\u299c",
+    "varepsilon;": "\u03f5",
+    "varkappa;": "\u03f0",
+    "varnothing;": "\u2205",
+    "varphi;": "\u03d5",
+    "varpi;": "\u03d6",
+    "varpropto;": "\u221d",
+    "varr;": "\u2195",
+    "varrho;": "\u03f1",
+    "varsigma;": "\u03c2",
+    "varsubsetneq;": "\u228a\ufe00",
+    "varsubsetneqq;": "\u2acb\ufe00",
+    "varsupsetneq;": "\u228b\ufe00",
+    "varsupsetneqq;": "\u2acc\ufe00",
+    "vartheta;": "\u03d1",
+    "vartriangleleft;": "\u22b2",
+    "vartriangleright;": "\u22b3",
+    "vcy;": "\u0432",
+    "vdash;": "\u22a2",
+    "vee;": "\u2228",
+    "veebar;": "\u22bb",
+    "veeeq;": "\u225a",
+    "vellip;": "\u22ee",
+    "verbar;": "|",
+    "vert;": "|",
+    "vfr;": "\U0001d533",
+    "vltri;": "\u22b2",
+    "vnsub;": "\u2282\u20d2",
+    "vnsup;": "\u2283\u20d2",
+    "vopf;": "\U0001d567",
+    "vprop;": "\u221d",
+    "vrtri;": "\u22b3",
+    "vscr;": "\U0001d4cb",
+    "vsubnE;": "\u2acb\ufe00",
+    "vsubne;": "\u228a\ufe00",
+    "vsupnE;": "\u2acc\ufe00",
+    "vsupne;": "\u228b\ufe00",
+    "vzigzag;": "\u299a",
+    "wcirc;": "\u0175",
+    "wedbar;": "\u2a5f",
+    "wedge;": "\u2227",
+    "wedgeq;": "\u2259",
+    "weierp;": "\u2118",
+    "wfr;": "\U0001d534",
+    "wopf;": "\U0001d568",
+    "wp;": "\u2118",
+    "wr;": "\u2240",
+    "wreath;": "\u2240",
+    "wscr;": "\U0001d4cc",
+    "xcap;": "\u22c2",
+    "xcirc;": "\u25ef",
+    "xcup;": "\u22c3",
+    "xdtri;": "\u25bd",
+    "xfr;": "\U0001d535",
+    "xhArr;": "\u27fa",
+    "xharr;": "\u27f7",
+    "xi;": "\u03be",
+    "xlArr;": "\u27f8",
+    "xlarr;": "\u27f5",
+    "xmap;": "\u27fc",
+    "xnis;": "\u22fb",
+    "xodot;": "\u2a00",
+    "xopf;": "\U0001d569",
+    "xoplus;": "\u2a01",
+    "xotime;": "\u2a02",
+    "xrArr;": "\u27f9",
+    "xrarr;": "\u27f6",
+    "xscr;": "\U0001d4cd",
+    "xsqcup;": "\u2a06",
+    "xuplus;": "\u2a04",
+    "xutri;": "\u25b3",
+    "xvee;": "\u22c1",
+    "xwedge;": "\u22c0",
+    "yacute": "\xfd",
+    "yacute;": "\xfd",
+    "yacy;": "\u044f",
+    "ycirc;": "\u0177",
+    "ycy;": "\u044b",
+    "yen": "\xa5",
+    "yen;": "\xa5",
+    "yfr;": "\U0001d536",
+    "yicy;": "\u0457",
+    "yopf;": "\U0001d56a",
+    "yscr;": "\U0001d4ce",
+    "yucy;": "\u044e",
+    "yuml": "\xff",
+    "yuml;": "\xff",
+    "zacute;": "\u017a",
+    "zcaron;": "\u017e",
+    "zcy;": "\u0437",
+    "zdot;": "\u017c",
+    "zeetrf;": "\u2128",
+    "zeta;": "\u03b6",
+    "zfr;": "\U0001d537",
+    "zhcy;": "\u0436",
+    "zigrarr;": "\u21dd",
+    "zopf;": "\U0001d56b",
+    "zscr;": "\U0001d4cf",
+    "zwj;": "\u200d",
+    "zwnj;": "\u200c",
+}
+
+replacementCharacters = {
+    0x0: "\uFFFD",
+    0x0d: "\u000D",
+    0x80: "\u20AC",
+    0x81: "\u0081",
+    0x82: "\u201A",
+    0x83: "\u0192",
+    0x84: "\u201E",
+    0x85: "\u2026",
+    0x86: "\u2020",
+    0x87: "\u2021",
+    0x88: "\u02C6",
+    0x89: "\u2030",
+    0x8A: "\u0160",
+    0x8B: "\u2039",
+    0x8C: "\u0152",
+    0x8D: "\u008D",
+    0x8E: "\u017D",
+    0x8F: "\u008F",
+    0x90: "\u0090",
+    0x91: "\u2018",
+    0x92: "\u2019",
+    0x93: "\u201C",
+    0x94: "\u201D",
+    0x95: "\u2022",
+    0x96: "\u2013",
+    0x97: "\u2014",
+    0x98: "\u02DC",
+    0x99: "\u2122",
+    0x9A: "\u0161",
+    0x9B: "\u203A",
+    0x9C: "\u0153",
+    0x9D: "\u009D",
+    0x9E: "\u017E",
+    0x9F: "\u0178",
+}
+
+tokenTypes = {
+    "Doctype": 0,
+    "Characters": 1,
+    "SpaceCharacters": 2,
+    "StartTag": 3,
+    "EndTag": 4,
+    "EmptyTag": 5,
+    "Comment": 6,
+    "ParseError": 7
+}
+
+tagTokenTypes = frozenset([tokenTypes["StartTag"], tokenTypes["EndTag"],
+                           tokenTypes["EmptyTag"]])
+
+
+prefixes = dict([(v, k) for k, v in namespaces.items()])
+prefixes["http://www.w3.org/1998/Math/MathML"] = "math"
+
+
+class DataLossWarning(UserWarning):
+    """Raised when the current tree is unable to represent the input data"""
+    pass
+
+
+class _ReparseException(Exception):
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/alphabeticalattributes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/alphabeticalattributes.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ba926e3b09a71121d3c10b962c26137221d5a34
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/alphabeticalattributes.py
@@ -0,0 +1,29 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from . import base
+
+from collections import OrderedDict
+
+
+def _attr_key(attr):
+    """Return an appropriate key for an attribute for sorting
+
+    Attributes have a namespace that can be either ``None`` or a string. We
+    can't compare the two because they're different types, so we convert
+    ``None`` to an empty string first.
+
+    """
+    return (attr[0][0] or ''), attr[0][1]
+
+
+class Filter(base.Filter):
+    """Alphabetizes attributes for elements"""
+    def __iter__(self):
+        for token in base.Filter.__iter__(self):
+            if token["type"] in ("StartTag", "EmptyTag"):
+                attrs = OrderedDict()
+                for name, value in sorted(token["data"].items(),
+                                          key=_attr_key):
+                    attrs[name] = value
+                token["data"] = attrs
+            yield token
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..c7dbaed0fab5afb4f8947b24dd175d2239d35d6b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/base.py
@@ -0,0 +1,12 @@
+from __future__ import absolute_import, division, unicode_literals
+
+
+class Filter(object):
+    def __init__(self, source):
+        self.source = source
+
+    def __iter__(self):
+        return iter(self.source)
+
+    def __getattr__(self, name):
+        return getattr(self.source, name)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/inject_meta_charset.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/inject_meta_charset.py
new file mode 100644
index 0000000000000000000000000000000000000000..aefb5c842c2f55075546065cfba3c66d137e8184
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/inject_meta_charset.py
@@ -0,0 +1,73 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from . import base
+
+
+class Filter(base.Filter):
+    """Injects ``<meta charset=ENCODING>`` tag into head of document"""
+    def __init__(self, source, encoding):
+        """Creates a Filter
+
+        :arg source: the source token stream
+
+        :arg encoding: the encoding to set
+
+        """
+        base.Filter.__init__(self, source)
+        self.encoding = encoding
+
+    def __iter__(self):
+        state = "pre_head"
+        meta_found = (self.encoding is None)
+        pending = []
+
+        for token in base.Filter.__iter__(self):
+            type = token["type"]
+            if type == "StartTag":
+                if token["name"].lower() == "head":
+                    state = "in_head"
+
+            elif type == "EmptyTag":
+                if token["name"].lower() == "meta":
+                    # replace charset with actual encoding
+                    has_http_equiv_content_type = False
+                    for (namespace, name), value in token["data"].items():
+                        if namespace is not None:
+                            continue
+                        elif name.lower() == 'charset':
+                            token["data"][(namespace, name)] = self.encoding
+                            meta_found = True
+                            break
+                        elif name == 'http-equiv' and value.lower() == 'content-type':
+                            has_http_equiv_content_type = True
+                    else:
+                        if has_http_equiv_content_type and (None, "content") in token["data"]:
+                            token["data"][(None, "content")] = 'text/html; charset=%s' % self.encoding
+                            meta_found = True
+
+                elif token["name"].lower() == "head" and not meta_found:
+                    # insert meta into empty head
+                    yield {"type": "StartTag", "name": "head",
+                           "data": token["data"]}
+                    yield {"type": "EmptyTag", "name": "meta",
+                           "data": {(None, "charset"): self.encoding}}
+                    yield {"type": "EndTag", "name": "head"}
+                    meta_found = True
+                    continue
+
+            elif type == "EndTag":
+                if token["name"].lower() == "head" and pending:
+                    # insert meta into head (if necessary) and flush pending queue
+                    yield pending.pop(0)
+                    if not meta_found:
+                        yield {"type": "EmptyTag", "name": "meta",
+                               "data": {(None, "charset"): self.encoding}}
+                    while pending:
+                        yield pending.pop(0)
+                    meta_found = True
+                    state = "post_head"
+
+            if state == "in_head":
+                pending.append(token)
+            else:
+                yield token
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/lint.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/lint.py
new file mode 100644
index 0000000000000000000000000000000000000000..acd4d7a2af1f63ccdcdf72e132df9b2d47759046
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/lint.py
@@ -0,0 +1,93 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from six import text_type
+
+from . import base
+from ..constants import namespaces, voidElements
+
+from ..constants import spaceCharacters
+spaceCharacters = "".join(spaceCharacters)
+
+
+class Filter(base.Filter):
+    """Lints the token stream for errors
+
+    If it finds any errors, it'll raise an ``AssertionError``.
+
+    """
+    def __init__(self, source, require_matching_tags=True):
+        """Creates a Filter
+
+        :arg source: the source token stream
+
+        :arg require_matching_tags: whether or not to require matching tags
+
+        """
+        super(Filter, self).__init__(source)
+        self.require_matching_tags = require_matching_tags
+
+    def __iter__(self):
+        open_elements = []
+        for token in base.Filter.__iter__(self):
+            type = token["type"]
+            if type in ("StartTag", "EmptyTag"):
+                namespace = token["namespace"]
+                name = token["name"]
+                assert namespace is None or isinstance(namespace, text_type)
+                assert namespace != ""
+                assert isinstance(name, text_type)
+                assert name != ""
+                assert isinstance(token["data"], dict)
+                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
+                    assert type == "EmptyTag"
+                else:
+                    assert type == "StartTag"
+                if type == "StartTag" and self.require_matching_tags:
+                    open_elements.append((namespace, name))
+                for (namespace, name), value in token["data"].items():
+                    assert namespace is None or isinstance(namespace, text_type)
+                    assert namespace != ""
+                    assert isinstance(name, text_type)
+                    assert name != ""
+                    assert isinstance(value, text_type)
+
+            elif type == "EndTag":
+                namespace = token["namespace"]
+                name = token["name"]
+                assert namespace is None or isinstance(namespace, text_type)
+                assert namespace != ""
+                assert isinstance(name, text_type)
+                assert name != ""
+                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
+                    assert False, "Void element reported as EndTag token: %(tag)s" % {"tag": name}
+                elif self.require_matching_tags:
+                    start = open_elements.pop()
+                    assert start == (namespace, name)
+
+            elif type == "Comment":
+                data = token["data"]
+                assert isinstance(data, text_type)
+
+            elif type in ("Characters", "SpaceCharacters"):
+                data = token["data"]
+                assert isinstance(data, text_type)
+                assert data != ""
+                if type == "SpaceCharacters":
+                    assert data.strip(spaceCharacters) == ""
+
+            elif type == "Doctype":
+                name = token["name"]
+                assert name is None or isinstance(name, text_type)
+                assert token["publicId"] is None or isinstance(name, text_type)
+                assert token["systemId"] is None or isinstance(name, text_type)
+
+            elif type == "Entity":
+                assert isinstance(token["name"], text_type)
+
+            elif type == "SerializerError":
+                assert isinstance(token["data"], text_type)
+
+            else:
+                assert False, "Unknown token type: %(type)s" % {"type": type}
+
+            yield token
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/optionaltags.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/optionaltags.py
new file mode 100644
index 0000000000000000000000000000000000000000..4a865012c16237c3c4dd3404af7ed767b98d235a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/optionaltags.py
@@ -0,0 +1,207 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from . import base
+
+
+class Filter(base.Filter):
+    """Removes optional tags from the token stream"""
+    def slider(self):
+        previous1 = previous2 = None
+        for token in self.source:
+            if previous1 is not None:
+                yield previous2, previous1, token
+            previous2 = previous1
+            previous1 = token
+        if previous1 is not None:
+            yield previous2, previous1, None
+
+    def __iter__(self):
+        for previous, token, next in self.slider():
+            type = token["type"]
+            if type == "StartTag":
+                if (token["data"] or
+                        not self.is_optional_start(token["name"], previous, next)):
+                    yield token
+            elif type == "EndTag":
+                if not self.is_optional_end(token["name"], next):
+                    yield token
+            else:
+                yield token
+
+    def is_optional_start(self, tagname, previous, next):
+        type = next and next["type"] or None
+        if tagname in 'html':
+            # An html element's start tag may be omitted if the first thing
+            # inside the html element is not a space character or a comment.
+            return type not in ("Comment", "SpaceCharacters")
+        elif tagname == 'head':
+            # A head element's start tag may be omitted if the first thing
+            # inside the head element is an element.
+            # XXX: we also omit the start tag if the head element is empty
+            if type in ("StartTag", "EmptyTag"):
+                return True
+            elif type == "EndTag":
+                return next["name"] == "head"
+        elif tagname == 'body':
+            # A body element's start tag may be omitted if the first thing
+            # inside the body element is not a space character or a comment,
+            # except if the first thing inside the body element is a script
+            # or style element and the node immediately preceding the body
+            # element is a head element whose end tag has been omitted.
+            if type in ("Comment", "SpaceCharacters"):
+                return False
+            elif type == "StartTag":
+                # XXX: we do not look at the preceding event, so we never omit
+                # the body element's start tag if it's followed by a script or
+                # a style element.
+                return next["name"] not in ('script', 'style')
+            else:
+                return True
+        elif tagname == 'colgroup':
+            # A colgroup element's start tag may be omitted if the first thing
+            # inside the colgroup element is a col element, and if the element
+            # is not immediately preceded by another colgroup element whose
+            # end tag has been omitted.
+            if type in ("StartTag", "EmptyTag"):
+                # XXX: we do not look at the preceding event, so instead we never
+                # omit the colgroup element's end tag when it is immediately
+                # followed by another colgroup element. See is_optional_end.
+                return next["name"] == "col"
+            else:
+                return False
+        elif tagname == 'tbody':
+            # A tbody element's start tag may be omitted if the first thing
+            # inside the tbody element is a tr element, and if the element is
+            # not immediately preceded by a tbody, thead, or tfoot element
+            # whose end tag has been omitted.
+            if type == "StartTag":
+                # omit the thead and tfoot elements' end tag when they are
+                # immediately followed by a tbody element. See is_optional_end.
+                if previous and previous['type'] == 'EndTag' and \
+                        previous['name'] in ('tbody', 'thead', 'tfoot'):
+                    return False
+                return next["name"] == 'tr'
+            else:
+                return False
+        return False
+
+    def is_optional_end(self, tagname, next):
+        type = next and next["type"] or None
+        if tagname in ('html', 'head', 'body'):
+            # An html element's end tag may be omitted if the html element
+            # is not immediately followed by a space character or a comment.
+            return type not in ("Comment", "SpaceCharacters")
+        elif tagname in ('li', 'optgroup', 'tr'):
+            # A li element's end tag may be omitted if the li element is
+            # immediately followed by another li element or if there is
+            # no more content in the parent element.
+            # An optgroup element's end tag may be omitted if the optgroup
+            # element is immediately followed by another optgroup element,
+            # or if there is no more content in the parent element.
+            # A tr element's end tag may be omitted if the tr element is
+            # immediately followed by another tr element, or if there is
+            # no more content in the parent element.
+            if type == "StartTag":
+                return next["name"] == tagname
+            else:
+                return type == "EndTag" or type is None
+        elif tagname in ('dt', 'dd'):
+            # A dt element's end tag may be omitted if the dt element is
+            # immediately followed by another dt element or a dd element.
+            # A dd element's end tag may be omitted if the dd element is
+            # immediately followed by another dd element or a dt element,
+            # or if there is no more content in the parent element.
+            if type == "StartTag":
+                return next["name"] in ('dt', 'dd')
+            elif tagname == 'dd':
+                return type == "EndTag" or type is None
+            else:
+                return False
+        elif tagname == 'p':
+            # A p element's end tag may be omitted if the p element is
+            # immediately followed by an address, article, aside,
+            # blockquote, datagrid, dialog, dir, div, dl, fieldset,
+            # footer, form, h1, h2, h3, h4, h5, h6, header, hr, menu,
+            # nav, ol, p, pre, section, table, or ul, element, or if
+            # there is no more content in the parent element.
+            if type in ("StartTag", "EmptyTag"):
+                return next["name"] in ('address', 'article', 'aside',
+                                        'blockquote', 'datagrid', 'dialog',
+                                        'dir', 'div', 'dl', 'fieldset', 'footer',
+                                        'form', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
+                                        'header', 'hr', 'menu', 'nav', 'ol',
+                                        'p', 'pre', 'section', 'table', 'ul')
+            else:
+                return type == "EndTag" or type is None
+        elif tagname == 'option':
+            # An option element's end tag may be omitted if the option
+            # element is immediately followed by another option element,
+            # or if it is immediately followed by an <code>optgroup</code>
+            # element, or if there is no more content in the parent
+            # element.
+            if type == "StartTag":
+                return next["name"] in ('option', 'optgroup')
+            else:
+                return type == "EndTag" or type is None
+        elif tagname in ('rt', 'rp'):
+            # An rt element's end tag may be omitted if the rt element is
+            # immediately followed by an rt or rp element, or if there is
+            # no more content in the parent element.
+            # An rp element's end tag may be omitted if the rp element is
+            # immediately followed by an rt or rp element, or if there is
+            # no more content in the parent element.
+            if type == "StartTag":
+                return next["name"] in ('rt', 'rp')
+            else:
+                return type == "EndTag" or type is None
+        elif tagname == 'colgroup':
+            # A colgroup element's end tag may be omitted if the colgroup
+            # element is not immediately followed by a space character or
+            # a comment.
+            if type in ("Comment", "SpaceCharacters"):
+                return False
+            elif type == "StartTag":
+                # XXX: we also look for an immediately following colgroup
+                # element. See is_optional_start.
+                return next["name"] != 'colgroup'
+            else:
+                return True
+        elif tagname in ('thead', 'tbody'):
+            # A thead element's end tag may be omitted if the thead element
+            # is immediately followed by a tbody or tfoot element.
+            # A tbody element's end tag may be omitted if the tbody element
+            # is immediately followed by a tbody or tfoot element, or if
+            # there is no more content in the parent element.
+            # A tfoot element's end tag may be omitted if the tfoot element
+            # is immediately followed by a tbody element, or if there is no
+            # more content in the parent element.
+            # XXX: we never omit the end tag when the following element is
+            # a tbody. See is_optional_start.
+            if type == "StartTag":
+                return next["name"] in ['tbody', 'tfoot']
+            elif tagname == 'tbody':
+                return type == "EndTag" or type is None
+            else:
+                return False
+        elif tagname == 'tfoot':
+            # A tfoot element's end tag may be omitted if the tfoot element
+            # is immediately followed by a tbody element, or if there is no
+            # more content in the parent element.
+            # XXX: we never omit the end tag when the following element is
+            # a tbody. See is_optional_start.
+            if type == "StartTag":
+                return next["name"] == 'tbody'
+            else:
+                return type == "EndTag" or type is None
+        elif tagname in ('td', 'th'):
+            # A td element's end tag may be omitted if the td element is
+            # immediately followed by a td or th element, or if there is
+            # no more content in the parent element.
+            # A th element's end tag may be omitted if the th element is
+            # immediately followed by a td or th element, or if there is
+            # no more content in the parent element.
+            if type == "StartTag":
+                return next["name"] in ('td', 'th')
+            else:
+                return type == "EndTag" or type is None
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/sanitizer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/sanitizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..e852f53be8af5ca9c142a8ed436bdab45d17bc75
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/sanitizer.py
@@ -0,0 +1,896 @@
+from __future__ import absolute_import, division, unicode_literals
+
+import re
+from xml.sax.saxutils import escape, unescape
+
+from six.moves import urllib_parse as urlparse
+
+from . import base
+from ..constants import namespaces, prefixes
+
+__all__ = ["Filter"]
+
+
+allowed_elements = frozenset((
+    (namespaces['html'], 'a'),
+    (namespaces['html'], 'abbr'),
+    (namespaces['html'], 'acronym'),
+    (namespaces['html'], 'address'),
+    (namespaces['html'], 'area'),
+    (namespaces['html'], 'article'),
+    (namespaces['html'], 'aside'),
+    (namespaces['html'], 'audio'),
+    (namespaces['html'], 'b'),
+    (namespaces['html'], 'big'),
+    (namespaces['html'], 'blockquote'),
+    (namespaces['html'], 'br'),
+    (namespaces['html'], 'button'),
+    (namespaces['html'], 'canvas'),
+    (namespaces['html'], 'caption'),
+    (namespaces['html'], 'center'),
+    (namespaces['html'], 'cite'),
+    (namespaces['html'], 'code'),
+    (namespaces['html'], 'col'),
+    (namespaces['html'], 'colgroup'),
+    (namespaces['html'], 'command'),
+    (namespaces['html'], 'datagrid'),
+    (namespaces['html'], 'datalist'),
+    (namespaces['html'], 'dd'),
+    (namespaces['html'], 'del'),
+    (namespaces['html'], 'details'),
+    (namespaces['html'], 'dfn'),
+    (namespaces['html'], 'dialog'),
+    (namespaces['html'], 'dir'),
+    (namespaces['html'], 'div'),
+    (namespaces['html'], 'dl'),
+    (namespaces['html'], 'dt'),
+    (namespaces['html'], 'em'),
+    (namespaces['html'], 'event-source'),
+    (namespaces['html'], 'fieldset'),
+    (namespaces['html'], 'figcaption'),
+    (namespaces['html'], 'figure'),
+    (namespaces['html'], 'footer'),
+    (namespaces['html'], 'font'),
+    (namespaces['html'], 'form'),
+    (namespaces['html'], 'header'),
+    (namespaces['html'], 'h1'),
+    (namespaces['html'], 'h2'),
+    (namespaces['html'], 'h3'),
+    (namespaces['html'], 'h4'),
+    (namespaces['html'], 'h5'),
+    (namespaces['html'], 'h6'),
+    (namespaces['html'], 'hr'),
+    (namespaces['html'], 'i'),
+    (namespaces['html'], 'img'),
+    (namespaces['html'], 'input'),
+    (namespaces['html'], 'ins'),
+    (namespaces['html'], 'keygen'),
+    (namespaces['html'], 'kbd'),
+    (namespaces['html'], 'label'),
+    (namespaces['html'], 'legend'),
+    (namespaces['html'], 'li'),
+    (namespaces['html'], 'm'),
+    (namespaces['html'], 'map'),
+    (namespaces['html'], 'menu'),
+    (namespaces['html'], 'meter'),
+    (namespaces['html'], 'multicol'),
+    (namespaces['html'], 'nav'),
+    (namespaces['html'], 'nextid'),
+    (namespaces['html'], 'ol'),
+    (namespaces['html'], 'output'),
+    (namespaces['html'], 'optgroup'),
+    (namespaces['html'], 'option'),
+    (namespaces['html'], 'p'),
+    (namespaces['html'], 'pre'),
+    (namespaces['html'], 'progress'),
+    (namespaces['html'], 'q'),
+    (namespaces['html'], 's'),
+    (namespaces['html'], 'samp'),
+    (namespaces['html'], 'section'),
+    (namespaces['html'], 'select'),
+    (namespaces['html'], 'small'),
+    (namespaces['html'], 'sound'),
+    (namespaces['html'], 'source'),
+    (namespaces['html'], 'spacer'),
+    (namespaces['html'], 'span'),
+    (namespaces['html'], 'strike'),
+    (namespaces['html'], 'strong'),
+    (namespaces['html'], 'sub'),
+    (namespaces['html'], 'sup'),
+    (namespaces['html'], 'table'),
+    (namespaces['html'], 'tbody'),
+    (namespaces['html'], 'td'),
+    (namespaces['html'], 'textarea'),
+    (namespaces['html'], 'time'),
+    (namespaces['html'], 'tfoot'),
+    (namespaces['html'], 'th'),
+    (namespaces['html'], 'thead'),
+    (namespaces['html'], 'tr'),
+    (namespaces['html'], 'tt'),
+    (namespaces['html'], 'u'),
+    (namespaces['html'], 'ul'),
+    (namespaces['html'], 'var'),
+    (namespaces['html'], 'video'),
+    (namespaces['mathml'], 'maction'),
+    (namespaces['mathml'], 'math'),
+    (namespaces['mathml'], 'merror'),
+    (namespaces['mathml'], 'mfrac'),
+    (namespaces['mathml'], 'mi'),
+    (namespaces['mathml'], 'mmultiscripts'),
+    (namespaces['mathml'], 'mn'),
+    (namespaces['mathml'], 'mo'),
+    (namespaces['mathml'], 'mover'),
+    (namespaces['mathml'], 'mpadded'),
+    (namespaces['mathml'], 'mphantom'),
+    (namespaces['mathml'], 'mprescripts'),
+    (namespaces['mathml'], 'mroot'),
+    (namespaces['mathml'], 'mrow'),
+    (namespaces['mathml'], 'mspace'),
+    (namespaces['mathml'], 'msqrt'),
+    (namespaces['mathml'], 'mstyle'),
+    (namespaces['mathml'], 'msub'),
+    (namespaces['mathml'], 'msubsup'),
+    (namespaces['mathml'], 'msup'),
+    (namespaces['mathml'], 'mtable'),
+    (namespaces['mathml'], 'mtd'),
+    (namespaces['mathml'], 'mtext'),
+    (namespaces['mathml'], 'mtr'),
+    (namespaces['mathml'], 'munder'),
+    (namespaces['mathml'], 'munderover'),
+    (namespaces['mathml'], 'none'),
+    (namespaces['svg'], 'a'),
+    (namespaces['svg'], 'animate'),
+    (namespaces['svg'], 'animateColor'),
+    (namespaces['svg'], 'animateMotion'),
+    (namespaces['svg'], 'animateTransform'),
+    (namespaces['svg'], 'clipPath'),
+    (namespaces['svg'], 'circle'),
+    (namespaces['svg'], 'defs'),
+    (namespaces['svg'], 'desc'),
+    (namespaces['svg'], 'ellipse'),
+    (namespaces['svg'], 'font-face'),
+    (namespaces['svg'], 'font-face-name'),
+    (namespaces['svg'], 'font-face-src'),
+    (namespaces['svg'], 'g'),
+    (namespaces['svg'], 'glyph'),
+    (namespaces['svg'], 'hkern'),
+    (namespaces['svg'], 'linearGradient'),
+    (namespaces['svg'], 'line'),
+    (namespaces['svg'], 'marker'),
+    (namespaces['svg'], 'metadata'),
+    (namespaces['svg'], 'missing-glyph'),
+    (namespaces['svg'], 'mpath'),
+    (namespaces['svg'], 'path'),
+    (namespaces['svg'], 'polygon'),
+    (namespaces['svg'], 'polyline'),
+    (namespaces['svg'], 'radialGradient'),
+    (namespaces['svg'], 'rect'),
+    (namespaces['svg'], 'set'),
+    (namespaces['svg'], 'stop'),
+    (namespaces['svg'], 'svg'),
+    (namespaces['svg'], 'switch'),
+    (namespaces['svg'], 'text'),
+    (namespaces['svg'], 'title'),
+    (namespaces['svg'], 'tspan'),
+    (namespaces['svg'], 'use'),
+))
+
+allowed_attributes = frozenset((
+    # HTML attributes
+    (None, 'abbr'),
+    (None, 'accept'),
+    (None, 'accept-charset'),
+    (None, 'accesskey'),
+    (None, 'action'),
+    (None, 'align'),
+    (None, 'alt'),
+    (None, 'autocomplete'),
+    (None, 'autofocus'),
+    (None, 'axis'),
+    (None, 'background'),
+    (None, 'balance'),
+    (None, 'bgcolor'),
+    (None, 'bgproperties'),
+    (None, 'border'),
+    (None, 'bordercolor'),
+    (None, 'bordercolordark'),
+    (None, 'bordercolorlight'),
+    (None, 'bottompadding'),
+    (None, 'cellpadding'),
+    (None, 'cellspacing'),
+    (None, 'ch'),
+    (None, 'challenge'),
+    (None, 'char'),
+    (None, 'charoff'),
+    (None, 'choff'),
+    (None, 'charset'),
+    (None, 'checked'),
+    (None, 'cite'),
+    (None, 'class'),
+    (None, 'clear'),
+    (None, 'color'),
+    (None, 'cols'),
+    (None, 'colspan'),
+    (None, 'compact'),
+    (None, 'contenteditable'),
+    (None, 'controls'),
+    (None, 'coords'),
+    (None, 'data'),
+    (None, 'datafld'),
+    (None, 'datapagesize'),
+    (None, 'datasrc'),
+    (None, 'datetime'),
+    (None, 'default'),
+    (None, 'delay'),
+    (None, 'dir'),
+    (None, 'disabled'),
+    (None, 'draggable'),
+    (None, 'dynsrc'),
+    (None, 'enctype'),
+    (None, 'end'),
+    (None, 'face'),
+    (None, 'for'),
+    (None, 'form'),
+    (None, 'frame'),
+    (None, 'galleryimg'),
+    (None, 'gutter'),
+    (None, 'headers'),
+    (None, 'height'),
+    (None, 'hidefocus'),
+    (None, 'hidden'),
+    (None, 'high'),
+    (None, 'href'),
+    (None, 'hreflang'),
+    (None, 'hspace'),
+    (None, 'icon'),
+    (None, 'id'),
+    (None, 'inputmode'),
+    (None, 'ismap'),
+    (None, 'keytype'),
+    (None, 'label'),
+    (None, 'leftspacing'),
+    (None, 'lang'),
+    (None, 'list'),
+    (None, 'longdesc'),
+    (None, 'loop'),
+    (None, 'loopcount'),
+    (None, 'loopend'),
+    (None, 'loopstart'),
+    (None, 'low'),
+    (None, 'lowsrc'),
+    (None, 'max'),
+    (None, 'maxlength'),
+    (None, 'media'),
+    (None, 'method'),
+    (None, 'min'),
+    (None, 'multiple'),
+    (None, 'name'),
+    (None, 'nohref'),
+    (None, 'noshade'),
+    (None, 'nowrap'),
+    (None, 'open'),
+    (None, 'optimum'),
+    (None, 'pattern'),
+    (None, 'ping'),
+    (None, 'point-size'),
+    (None, 'poster'),
+    (None, 'pqg'),
+    (None, 'preload'),
+    (None, 'prompt'),
+    (None, 'radiogroup'),
+    (None, 'readonly'),
+    (None, 'rel'),
+    (None, 'repeat-max'),
+    (None, 'repeat-min'),
+    (None, 'replace'),
+    (None, 'required'),
+    (None, 'rev'),
+    (None, 'rightspacing'),
+    (None, 'rows'),
+    (None, 'rowspan'),
+    (None, 'rules'),
+    (None, 'scope'),
+    (None, 'selected'),
+    (None, 'shape'),
+    (None, 'size'),
+    (None, 'span'),
+    (None, 'src'),
+    (None, 'start'),
+    (None, 'step'),
+    (None, 'style'),
+    (None, 'summary'),
+    (None, 'suppress'),
+    (None, 'tabindex'),
+    (None, 'target'),
+    (None, 'template'),
+    (None, 'title'),
+    (None, 'toppadding'),
+    (None, 'type'),
+    (None, 'unselectable'),
+    (None, 'usemap'),
+    (None, 'urn'),
+    (None, 'valign'),
+    (None, 'value'),
+    (None, 'variable'),
+    (None, 'volume'),
+    (None, 'vspace'),
+    (None, 'vrml'),
+    (None, 'width'),
+    (None, 'wrap'),
+    (namespaces['xml'], 'lang'),
+    # MathML attributes
+    (None, 'actiontype'),
+    (None, 'align'),
+    (None, 'columnalign'),
+    (None, 'columnalign'),
+    (None, 'columnalign'),
+    (None, 'columnlines'),
+    (None, 'columnspacing'),
+    (None, 'columnspan'),
+    (None, 'depth'),
+    (None, 'display'),
+    (None, 'displaystyle'),
+    (None, 'equalcolumns'),
+    (None, 'equalrows'),
+    (None, 'fence'),
+    (None, 'fontstyle'),
+    (None, 'fontweight'),
+    (None, 'frame'),
+    (None, 'height'),
+    (None, 'linethickness'),
+    (None, 'lspace'),
+    (None, 'mathbackground'),
+    (None, 'mathcolor'),
+    (None, 'mathvariant'),
+    (None, 'mathvariant'),
+    (None, 'maxsize'),
+    (None, 'minsize'),
+    (None, 'other'),
+    (None, 'rowalign'),
+    (None, 'rowalign'),
+    (None, 'rowalign'),
+    (None, 'rowlines'),
+    (None, 'rowspacing'),
+    (None, 'rowspan'),
+    (None, 'rspace'),
+    (None, 'scriptlevel'),
+    (None, 'selection'),
+    (None, 'separator'),
+    (None, 'stretchy'),
+    (None, 'width'),
+    (None, 'width'),
+    (namespaces['xlink'], 'href'),
+    (namespaces['xlink'], 'show'),
+    (namespaces['xlink'], 'type'),
+    # SVG attributes
+    (None, 'accent-height'),
+    (None, 'accumulate'),
+    (None, 'additive'),
+    (None, 'alphabetic'),
+    (None, 'arabic-form'),
+    (None, 'ascent'),
+    (None, 'attributeName'),
+    (None, 'attributeType'),
+    (None, 'baseProfile'),
+    (None, 'bbox'),
+    (None, 'begin'),
+    (None, 'by'),
+    (None, 'calcMode'),
+    (None, 'cap-height'),
+    (None, 'class'),
+    (None, 'clip-path'),
+    (None, 'color'),
+    (None, 'color-rendering'),
+    (None, 'content'),
+    (None, 'cx'),
+    (None, 'cy'),
+    (None, 'd'),
+    (None, 'dx'),
+    (None, 'dy'),
+    (None, 'descent'),
+    (None, 'display'),
+    (None, 'dur'),
+    (None, 'end'),
+    (None, 'fill'),
+    (None, 'fill-opacity'),
+    (None, 'fill-rule'),
+    (None, 'font-family'),
+    (None, 'font-size'),
+    (None, 'font-stretch'),
+    (None, 'font-style'),
+    (None, 'font-variant'),
+    (None, 'font-weight'),
+    (None, 'from'),
+    (None, 'fx'),
+    (None, 'fy'),
+    (None, 'g1'),
+    (None, 'g2'),
+    (None, 'glyph-name'),
+    (None, 'gradientUnits'),
+    (None, 'hanging'),
+    (None, 'height'),
+    (None, 'horiz-adv-x'),
+    (None, 'horiz-origin-x'),
+    (None, 'id'),
+    (None, 'ideographic'),
+    (None, 'k'),
+    (None, 'keyPoints'),
+    (None, 'keySplines'),
+    (None, 'keyTimes'),
+    (None, 'lang'),
+    (None, 'marker-end'),
+    (None, 'marker-mid'),
+    (None, 'marker-start'),
+    (None, 'markerHeight'),
+    (None, 'markerUnits'),
+    (None, 'markerWidth'),
+    (None, 'mathematical'),
+    (None, 'max'),
+    (None, 'min'),
+    (None, 'name'),
+    (None, 'offset'),
+    (None, 'opacity'),
+    (None, 'orient'),
+    (None, 'origin'),
+    (None, 'overline-position'),
+    (None, 'overline-thickness'),
+    (None, 'panose-1'),
+    (None, 'path'),
+    (None, 'pathLength'),
+    (None, 'points'),
+    (None, 'preserveAspectRatio'),
+    (None, 'r'),
+    (None, 'refX'),
+    (None, 'refY'),
+    (None, 'repeatCount'),
+    (None, 'repeatDur'),
+    (None, 'requiredExtensions'),
+    (None, 'requiredFeatures'),
+    (None, 'restart'),
+    (None, 'rotate'),
+    (None, 'rx'),
+    (None, 'ry'),
+    (None, 'slope'),
+    (None, 'stemh'),
+    (None, 'stemv'),
+    (None, 'stop-color'),
+    (None, 'stop-opacity'),
+    (None, 'strikethrough-position'),
+    (None, 'strikethrough-thickness'),
+    (None, 'stroke'),
+    (None, 'stroke-dasharray'),
+    (None, 'stroke-dashoffset'),
+    (None, 'stroke-linecap'),
+    (None, 'stroke-linejoin'),
+    (None, 'stroke-miterlimit'),
+    (None, 'stroke-opacity'),
+    (None, 'stroke-width'),
+    (None, 'systemLanguage'),
+    (None, 'target'),
+    (None, 'text-anchor'),
+    (None, 'to'),
+    (None, 'transform'),
+    (None, 'type'),
+    (None, 'u1'),
+    (None, 'u2'),
+    (None, 'underline-position'),
+    (None, 'underline-thickness'),
+    (None, 'unicode'),
+    (None, 'unicode-range'),
+    (None, 'units-per-em'),
+    (None, 'values'),
+    (None, 'version'),
+    (None, 'viewBox'),
+    (None, 'visibility'),
+    (None, 'width'),
+    (None, 'widths'),
+    (None, 'x'),
+    (None, 'x-height'),
+    (None, 'x1'),
+    (None, 'x2'),
+    (namespaces['xlink'], 'actuate'),
+    (namespaces['xlink'], 'arcrole'),
+    (namespaces['xlink'], 'href'),
+    (namespaces['xlink'], 'role'),
+    (namespaces['xlink'], 'show'),
+    (namespaces['xlink'], 'title'),
+    (namespaces['xlink'], 'type'),
+    (namespaces['xml'], 'base'),
+    (namespaces['xml'], 'lang'),
+    (namespaces['xml'], 'space'),
+    (None, 'y'),
+    (None, 'y1'),
+    (None, 'y2'),
+    (None, 'zoomAndPan'),
+))
+
+attr_val_is_uri = frozenset((
+    (None, 'href'),
+    (None, 'src'),
+    (None, 'cite'),
+    (None, 'action'),
+    (None, 'longdesc'),
+    (None, 'poster'),
+    (None, 'background'),
+    (None, 'datasrc'),
+    (None, 'dynsrc'),
+    (None, 'lowsrc'),
+    (None, 'ping'),
+    (namespaces['xlink'], 'href'),
+    (namespaces['xml'], 'base'),
+))
+
+svg_attr_val_allows_ref = frozenset((
+    (None, 'clip-path'),
+    (None, 'color-profile'),
+    (None, 'cursor'),
+    (None, 'fill'),
+    (None, 'filter'),
+    (None, 'marker'),
+    (None, 'marker-start'),
+    (None, 'marker-mid'),
+    (None, 'marker-end'),
+    (None, 'mask'),
+    (None, 'stroke'),
+))
+
+svg_allow_local_href = frozenset((
+    (None, 'altGlyph'),
+    (None, 'animate'),
+    (None, 'animateColor'),
+    (None, 'animateMotion'),
+    (None, 'animateTransform'),
+    (None, 'cursor'),
+    (None, 'feImage'),
+    (None, 'filter'),
+    (None, 'linearGradient'),
+    (None, 'pattern'),
+    (None, 'radialGradient'),
+    (None, 'textpath'),
+    (None, 'tref'),
+    (None, 'set'),
+    (None, 'use')
+))
+
+allowed_css_properties = frozenset((
+    'azimuth',
+    'background-color',
+    'border-bottom-color',
+    'border-collapse',
+    'border-color',
+    'border-left-color',
+    'border-right-color',
+    'border-top-color',
+    'clear',
+    'color',
+    'cursor',
+    'direction',
+    'display',
+    'elevation',
+    'float',
+    'font',
+    'font-family',
+    'font-size',
+    'font-style',
+    'font-variant',
+    'font-weight',
+    'height',
+    'letter-spacing',
+    'line-height',
+    'overflow',
+    'pause',
+    'pause-after',
+    'pause-before',
+    'pitch',
+    'pitch-range',
+    'richness',
+    'speak',
+    'speak-header',
+    'speak-numeral',
+    'speak-punctuation',
+    'speech-rate',
+    'stress',
+    'text-align',
+    'text-decoration',
+    'text-indent',
+    'unicode-bidi',
+    'vertical-align',
+    'voice-family',
+    'volume',
+    'white-space',
+    'width',
+))
+
+allowed_css_keywords = frozenset((
+    'auto',
+    'aqua',
+    'black',
+    'block',
+    'blue',
+    'bold',
+    'both',
+    'bottom',
+    'brown',
+    'center',
+    'collapse',
+    'dashed',
+    'dotted',
+    'fuchsia',
+    'gray',
+    'green',
+    '!important',
+    'italic',
+    'left',
+    'lime',
+    'maroon',
+    'medium',
+    'none',
+    'navy',
+    'normal',
+    'nowrap',
+    'olive',
+    'pointer',
+    'purple',
+    'red',
+    'right',
+    'solid',
+    'silver',
+    'teal',
+    'top',
+    'transparent',
+    'underline',
+    'white',
+    'yellow',
+))
+
+allowed_svg_properties = frozenset((
+    'fill',
+    'fill-opacity',
+    'fill-rule',
+    'stroke',
+    'stroke-width',
+    'stroke-linecap',
+    'stroke-linejoin',
+    'stroke-opacity',
+))
+
+allowed_protocols = frozenset((
+    'ed2k',
+    'ftp',
+    'http',
+    'https',
+    'irc',
+    'mailto',
+    'news',
+    'gopher',
+    'nntp',
+    'telnet',
+    'webcal',
+    'xmpp',
+    'callto',
+    'feed',
+    'urn',
+    'aim',
+    'rsync',
+    'tag',
+    'ssh',
+    'sftp',
+    'rtsp',
+    'afs',
+    'data',
+))
+
+allowed_content_types = frozenset((
+    'image/png',
+    'image/jpeg',
+    'image/gif',
+    'image/webp',
+    'image/bmp',
+    'text/plain',
+))
+
+
+data_content_type = re.compile(r'''
+                                ^
+                                # Match a content type <application>/<type>
+                                (?P<content_type>[-a-zA-Z0-9.]+/[-a-zA-Z0-9.]+)
+                                # Match any character set and encoding
+                                (?:(?:;charset=(?:[-a-zA-Z0-9]+)(?:;(?:base64))?)
+                                  |(?:;(?:base64))?(?:;charset=(?:[-a-zA-Z0-9]+))?)
+                                # Assume the rest is data
+                                ,.*
+                                $
+                                ''',
+                               re.VERBOSE)
+
+
+class Filter(base.Filter):
+    """Sanitizes token stream of XHTML+MathML+SVG and of inline style attributes"""
+    def __init__(self,
+                 source,
+                 allowed_elements=allowed_elements,
+                 allowed_attributes=allowed_attributes,
+                 allowed_css_properties=allowed_css_properties,
+                 allowed_css_keywords=allowed_css_keywords,
+                 allowed_svg_properties=allowed_svg_properties,
+                 allowed_protocols=allowed_protocols,
+                 allowed_content_types=allowed_content_types,
+                 attr_val_is_uri=attr_val_is_uri,
+                 svg_attr_val_allows_ref=svg_attr_val_allows_ref,
+                 svg_allow_local_href=svg_allow_local_href):
+        """Creates a Filter
+
+        :arg allowed_elements: set of elements to allow--everything else will
+            be escaped
+
+        :arg allowed_attributes: set of attributes to allow in
+            elements--everything else will be stripped
+
+        :arg allowed_css_properties: set of CSS properties to allow--everything
+            else will be stripped
+
+        :arg allowed_css_keywords: set of CSS keywords to allow--everything
+            else will be stripped
+
+        :arg allowed_svg_properties: set of SVG properties to allow--everything
+            else will be removed
+
+        :arg allowed_protocols: set of allowed protocols for URIs
+
+        :arg allowed_content_types: set of allowed content types for ``data`` URIs.
+
+        :arg attr_val_is_uri: set of attributes that have URI values--values
+            that have a scheme not listed in ``allowed_protocols`` are removed
+
+        :arg svg_attr_val_allows_ref: set of SVG attributes that can have
+            references
+
+        :arg svg_allow_local_href: set of SVG elements that can have local
+            hrefs--these are removed
+
+        """
+        super(Filter, self).__init__(source)
+        self.allowed_elements = allowed_elements
+        self.allowed_attributes = allowed_attributes
+        self.allowed_css_properties = allowed_css_properties
+        self.allowed_css_keywords = allowed_css_keywords
+        self.allowed_svg_properties = allowed_svg_properties
+        self.allowed_protocols = allowed_protocols
+        self.allowed_content_types = allowed_content_types
+        self.attr_val_is_uri = attr_val_is_uri
+        self.svg_attr_val_allows_ref = svg_attr_val_allows_ref
+        self.svg_allow_local_href = svg_allow_local_href
+
+    def __iter__(self):
+        for token in base.Filter.__iter__(self):
+            token = self.sanitize_token(token)
+            if token:
+                yield token
+
+    # Sanitize the +html+, escaping all elements not in ALLOWED_ELEMENTS, and
+    # stripping out all attributes not in ALLOWED_ATTRIBUTES. Style attributes
+    # are parsed, and a restricted set, specified by ALLOWED_CSS_PROPERTIES and
+    # ALLOWED_CSS_KEYWORDS, are allowed through. attributes in ATTR_VAL_IS_URI
+    # are scanned, and only URI schemes specified in ALLOWED_PROTOCOLS are
+    # allowed.
+    #
+    #   sanitize_html('<script> do_nasty_stuff() </script>')
+    #    => &lt;script> do_nasty_stuff() &lt;/script>
+    #   sanitize_html('<a href="javascript: sucker();">Click here for $100</a>')
+    #    => <a>Click here for $100</a>
+    def sanitize_token(self, token):
+
+        # accommodate filters which use token_type differently
+        token_type = token["type"]
+        if token_type in ("StartTag", "EndTag", "EmptyTag"):
+            name = token["name"]
+            namespace = token["namespace"]
+            if ((namespace, name) in self.allowed_elements or
+                (namespace is None and
+                 (namespaces["html"], name) in self.allowed_elements)):
+                return self.allowed_token(token)
+            else:
+                return self.disallowed_token(token)
+        elif token_type == "Comment":
+            pass
+        else:
+            return token
+
+    def allowed_token(self, token):
+        if "data" in token:
+            attrs = token["data"]
+            attr_names = set(attrs.keys())
+
+            # Remove forbidden attributes
+            for to_remove in (attr_names - self.allowed_attributes):
+                del token["data"][to_remove]
+                attr_names.remove(to_remove)
+
+            # Remove attributes with disallowed URL values
+            for attr in (attr_names & self.attr_val_is_uri):
+                assert attr in attrs
+                # I don't have a clue where this regexp comes from or why it matches those
+                # characters, nor why we call unescape. I just know it's always been here.
+                # Should you be worried by this comment in a sanitizer? Yes. On the other hand, all
+                # this will do is remove *more* than it otherwise would.
+                val_unescaped = re.sub("[`\x00-\x20\x7f-\xa0\\s]+", '',
+                                       unescape(attrs[attr])).lower()
+                # remove replacement characters from unescaped characters
+                val_unescaped = val_unescaped.replace("\ufffd", "")
+                try:
+                    uri = urlparse.urlparse(val_unescaped)
+                except ValueError:
+                    uri = None
+                    del attrs[attr]
+                if uri and uri.scheme:
+                    if uri.scheme not in self.allowed_protocols:
+                        del attrs[attr]
+                    if uri.scheme == 'data':
+                        m = data_content_type.match(uri.path)
+                        if not m:
+                            del attrs[attr]
+                        elif m.group('content_type') not in self.allowed_content_types:
+                            del attrs[attr]
+
+            for attr in self.svg_attr_val_allows_ref:
+                if attr in attrs:
+                    attrs[attr] = re.sub(r'url\s*\(\s*[^#\s][^)]+?\)',
+                                         ' ',
+                                         unescape(attrs[attr]))
+            if (token["name"] in self.svg_allow_local_href and
+                (namespaces['xlink'], 'href') in attrs and re.search(r'^\s*[^#\s].*',
+                                                                     attrs[(namespaces['xlink'], 'href')])):
+                del attrs[(namespaces['xlink'], 'href')]
+            if (None, 'style') in attrs:
+                attrs[(None, 'style')] = self.sanitize_css(attrs[(None, 'style')])
+            token["data"] = attrs
+        return token
+
+    def disallowed_token(self, token):
+        token_type = token["type"]
+        if token_type == "EndTag":
+            token["data"] = "</%s>" % token["name"]
+        elif token["data"]:
+            assert token_type in ("StartTag", "EmptyTag")
+            attrs = []
+            for (ns, name), v in token["data"].items():
+                attrs.append(' %s="%s"' % (name if ns is None else "%s:%s" % (prefixes[ns], name), escape(v)))
+            token["data"] = "<%s%s>" % (token["name"], ''.join(attrs))
+        else:
+            token["data"] = "<%s>" % token["name"]
+        if token.get("selfClosing"):
+            token["data"] = token["data"][:-1] + "/>"
+
+        token["type"] = "Characters"
+
+        del token["name"]
+        return token
+
+    def sanitize_css(self, style):
+        # disallow urls
+        style = re.compile(r'url\s*\(\s*[^\s)]+?\s*\)\s*').sub(' ', style)
+
+        # gauntlet
+        if not re.match(r"""^([:,;#%.\sa-zA-Z0-9!]|\w-\w|'[\s\w]+'|"[\s\w]+"|\([\d,\s]+\))*$""", style):
+            return ''
+        if not re.match(r"^\s*([-\w]+\s*:[^:;]*(;\s*|$))*$", style):
+            return ''
+
+        clean = []
+        for prop, value in re.findall(r"([-\w]+)\s*:\s*([^:;]*)", style):
+            if not value:
+                continue
+            if prop.lower() in self.allowed_css_properties:
+                clean.append(prop + ': ' + value + ';')
+            elif prop.split('-')[0].lower() in ['background', 'border', 'margin',
+                                                'padding']:
+                for keyword in value.split():
+                    if keyword not in self.allowed_css_keywords and \
+                            not re.match(r"^(#[0-9a-fA-F]+|rgb\(\d+%?,\d*%?,?\d*%?\)?|\d{0,2}\.?\d{0,2}(cm|em|ex|in|mm|pc|pt|px|%|,|\))?)$", keyword):  # noqa
+                        break
+                else:
+                    clean.append(prop + ': ' + value + ';')
+            elif prop.lower() in self.allowed_svg_properties:
+                clean.append(prop + ': ' + value + ';')
+
+        return ' '.join(clean)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/whitespace.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/whitespace.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d12584b45995d35110f75af00193fdad0fa10f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/filters/whitespace.py
@@ -0,0 +1,38 @@
+from __future__ import absolute_import, division, unicode_literals
+
+import re
+
+from . import base
+from ..constants import rcdataElements, spaceCharacters
+spaceCharacters = "".join(spaceCharacters)
+
+SPACES_REGEX = re.compile("[%s]+" % spaceCharacters)
+
+
+class Filter(base.Filter):
+    """Collapses whitespace except in pre, textarea, and script elements"""
+    spacePreserveElements = frozenset(["pre", "textarea"] + list(rcdataElements))
+
+    def __iter__(self):
+        preserve = 0
+        for token in base.Filter.__iter__(self):
+            type = token["type"]
+            if type == "StartTag" \
+                    and (preserve or token["name"] in self.spacePreserveElements):
+                preserve += 1
+
+            elif type == "EndTag" and preserve:
+                preserve -= 1
+
+            elif not preserve and type == "SpaceCharacters" and token["data"]:
+                # Test on token["data"] above to not introduce spaces where there were not
+                token["data"] = " "
+
+            elif not preserve and type == "Characters":
+                token["data"] = collapse_spaces(token["data"])
+
+            yield token
+
+
+def collapse_spaces(text):
+    return SPACES_REGEX.sub(' ', text)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/html5parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/html5parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d39b9d41da7686748f347e5a8a5e79540dd7332
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/html5parser.py
@@ -0,0 +1,2791 @@
+from __future__ import absolute_import, division, unicode_literals
+from six import with_metaclass, viewkeys
+
+import types
+from collections import OrderedDict
+
+from . import _inputstream
+from . import _tokenizer
+
+from . import treebuilders
+from .treebuilders.base import Marker
+
+from . import _utils
+from .constants import (
+    spaceCharacters, asciiUpper2Lower,
+    specialElements, headingElements, cdataElements, rcdataElements,
+    tokenTypes, tagTokenTypes,
+    namespaces,
+    htmlIntegrationPointElements, mathmlTextIntegrationPointElements,
+    adjustForeignAttributes as adjustForeignAttributesMap,
+    adjustMathMLAttributes, adjustSVGAttributes,
+    E,
+    _ReparseException
+)
+
+
+def parse(doc, treebuilder="etree", namespaceHTMLElements=True, **kwargs):
+    """Parse an HTML document as a string or file-like object into a tree
+
+    :arg doc: the document to parse as a string or file-like object
+
+    :arg treebuilder: the treebuilder to use when parsing
+
+    :arg namespaceHTMLElements: whether or not to namespace HTML elements
+
+    :returns: parsed tree
+
+    Example:
+
+    >>> from html5lib.html5parser import parse
+    >>> parse('<html><body><p>This is a doc</p></body></html>')
+    <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>
+
+    """
+    tb = treebuilders.getTreeBuilder(treebuilder)
+    p = HTMLParser(tb, namespaceHTMLElements=namespaceHTMLElements)
+    return p.parse(doc, **kwargs)
+
+
+def parseFragment(doc, container="div", treebuilder="etree", namespaceHTMLElements=True, **kwargs):
+    """Parse an HTML fragment as a string or file-like object into a tree
+
+    :arg doc: the fragment to parse as a string or file-like object
+
+    :arg container: the container context to parse the fragment in
+
+    :arg treebuilder: the treebuilder to use when parsing
+
+    :arg namespaceHTMLElements: whether or not to namespace HTML elements
+
+    :returns: parsed tree
+
+    Example:
+
+    >>> from html5lib.html5libparser import parseFragment
+    >>> parseFragment('<b>this is a fragment</b>')
+    <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>
+
+    """
+    tb = treebuilders.getTreeBuilder(treebuilder)
+    p = HTMLParser(tb, namespaceHTMLElements=namespaceHTMLElements)
+    return p.parseFragment(doc, container=container, **kwargs)
+
+
+def method_decorator_metaclass(function):
+    class Decorated(type):
+        def __new__(meta, classname, bases, classDict):
+            for attributeName, attribute in classDict.items():
+                if isinstance(attribute, types.FunctionType):
+                    attribute = function(attribute)
+
+                classDict[attributeName] = attribute
+            return type.__new__(meta, classname, bases, classDict)
+    return Decorated
+
+
+class HTMLParser(object):
+    """HTML parser
+
+    Generates a tree structure from a stream of (possibly malformed) HTML.
+
+    """
+
+    def __init__(self, tree=None, strict=False, namespaceHTMLElements=True, debug=False):
+        """
+        :arg tree: a treebuilder class controlling the type of tree that will be
+            returned. Built in treebuilders can be accessed through
+            html5lib.treebuilders.getTreeBuilder(treeType)
+
+        :arg strict: raise an exception when a parse error is encountered
+
+        :arg namespaceHTMLElements: whether or not to namespace HTML elements
+
+        :arg debug: whether or not to enable debug mode which logs things
+
+        Example:
+
+        >>> from html5lib.html5parser import HTMLParser
+        >>> parser = HTMLParser()                     # generates parser with etree builder
+        >>> parser = HTMLParser('lxml', strict=True)  # generates parser with lxml builder which is strict
+
+        """
+
+        # Raise an exception on the first error encountered
+        self.strict = strict
+
+        if tree is None:
+            tree = treebuilders.getTreeBuilder("etree")
+        self.tree = tree(namespaceHTMLElements)
+        self.errors = []
+
+        self.phases = dict([(name, cls(self, self.tree)) for name, cls in
+                            getPhases(debug).items()])
+
+    def _parse(self, stream, innerHTML=False, container="div", scripting=False, **kwargs):
+
+        self.innerHTMLMode = innerHTML
+        self.container = container
+        self.scripting = scripting
+        self.tokenizer = _tokenizer.HTMLTokenizer(stream, parser=self, **kwargs)
+        self.reset()
+
+        try:
+            self.mainLoop()
+        except _ReparseException:
+            self.reset()
+            self.mainLoop()
+
+    def reset(self):
+        self.tree.reset()
+        self.firstStartTag = False
+        self.errors = []
+        self.log = []  # only used with debug mode
+        # "quirks" / "limited quirks" / "no quirks"
+        self.compatMode = "no quirks"
+
+        if self.innerHTMLMode:
+            self.innerHTML = self.container.lower()
+
+            if self.innerHTML in cdataElements:
+                self.tokenizer.state = self.tokenizer.rcdataState
+            elif self.innerHTML in rcdataElements:
+                self.tokenizer.state = self.tokenizer.rawtextState
+            elif self.innerHTML == 'plaintext':
+                self.tokenizer.state = self.tokenizer.plaintextState
+            else:
+                # state already is data state
+                # self.tokenizer.state = self.tokenizer.dataState
+                pass
+            self.phase = self.phases["beforeHtml"]
+            self.phase.insertHtmlElement()
+            self.resetInsertionMode()
+        else:
+            self.innerHTML = False  # pylint:disable=redefined-variable-type
+            self.phase = self.phases["initial"]
+
+        self.lastPhase = None
+
+        self.beforeRCDataPhase = None
+
+        self.framesetOK = True
+
+    @property
+    def documentEncoding(self):
+        """Name of the character encoding that was used to decode the input stream, or
+        :obj:`None` if that is not determined yet
+
+        """
+        if not hasattr(self, 'tokenizer'):
+            return None
+        return self.tokenizer.stream.charEncoding[0].name
+
+    def isHTMLIntegrationPoint(self, element):
+        if (element.name == "annotation-xml" and
+                element.namespace == namespaces["mathml"]):
+            return ("encoding" in element.attributes and
+                    element.attributes["encoding"].translate(
+                        asciiUpper2Lower) in
+                    ("text/html", "application/xhtml+xml"))
+        else:
+            return (element.namespace, element.name) in htmlIntegrationPointElements
+
+    def isMathMLTextIntegrationPoint(self, element):
+        return (element.namespace, element.name) in mathmlTextIntegrationPointElements
+
+    def mainLoop(self):
+        CharactersToken = tokenTypes["Characters"]
+        SpaceCharactersToken = tokenTypes["SpaceCharacters"]
+        StartTagToken = tokenTypes["StartTag"]
+        EndTagToken = tokenTypes["EndTag"]
+        CommentToken = tokenTypes["Comment"]
+        DoctypeToken = tokenTypes["Doctype"]
+        ParseErrorToken = tokenTypes["ParseError"]
+
+        for token in self.normalizedTokens():
+            prev_token = None
+            new_token = token
+            while new_token is not None:
+                prev_token = new_token
+                currentNode = self.tree.openElements[-1] if self.tree.openElements else None
+                currentNodeNamespace = currentNode.namespace if currentNode else None
+                currentNodeName = currentNode.name if currentNode else None
+
+                type = new_token["type"]
+
+                if type == ParseErrorToken:
+                    self.parseError(new_token["data"], new_token.get("datavars", {}))
+                    new_token = None
+                else:
+                    if (len(self.tree.openElements) == 0 or
+                        currentNodeNamespace == self.tree.defaultNamespace or
+                        (self.isMathMLTextIntegrationPoint(currentNode) and
+                         ((type == StartTagToken and
+                           token["name"] not in frozenset(["mglyph", "malignmark"])) or
+                          type in (CharactersToken, SpaceCharactersToken))) or
+                        (currentNodeNamespace == namespaces["mathml"] and
+                         currentNodeName == "annotation-xml" and
+                         type == StartTagToken and
+                         token["name"] == "svg") or
+                        (self.isHTMLIntegrationPoint(currentNode) and
+                         type in (StartTagToken, CharactersToken, SpaceCharactersToken))):
+                        phase = self.phase
+                    else:
+                        phase = self.phases["inForeignContent"]
+
+                    if type == CharactersToken:
+                        new_token = phase.processCharacters(new_token)
+                    elif type == SpaceCharactersToken:
+                        new_token = phase.processSpaceCharacters(new_token)
+                    elif type == StartTagToken:
+                        new_token = phase.processStartTag(new_token)
+                    elif type == EndTagToken:
+                        new_token = phase.processEndTag(new_token)
+                    elif type == CommentToken:
+                        new_token = phase.processComment(new_token)
+                    elif type == DoctypeToken:
+                        new_token = phase.processDoctype(new_token)
+
+            if (type == StartTagToken and prev_token["selfClosing"] and
+                    not prev_token["selfClosingAcknowledged"]):
+                self.parseError("non-void-element-with-trailing-solidus",
+                                {"name": prev_token["name"]})
+
+        # When the loop finishes it's EOF
+        reprocess = True
+        phases = []
+        while reprocess:
+            phases.append(self.phase)
+            reprocess = self.phase.processEOF()
+            if reprocess:
+                assert self.phase not in phases
+
+    def normalizedTokens(self):
+        for token in self.tokenizer:
+            yield self.normalizeToken(token)
+
+    def parse(self, stream, *args, **kwargs):
+        """Parse a HTML document into a well-formed tree
+
+        :arg stream: a file-like object or string containing the HTML to be parsed
+
+            The optional encoding parameter must be a string that indicates
+            the encoding.  If specified, that encoding will be used,
+            regardless of any BOM or later declaration (such as in a meta
+            element).
+
+        :arg scripting: treat noscript elements as if JavaScript was turned on
+
+        :returns: parsed tree
+
+        Example:
+
+        >>> from html5lib.html5parser import HTMLParser
+        >>> parser = HTMLParser()
+        >>> parser.parse('<html><body><p>This is a doc</p></body></html>')
+        <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>
+
+        """
+        self._parse(stream, False, None, *args, **kwargs)
+        return self.tree.getDocument()
+
+    def parseFragment(self, stream, *args, **kwargs):
+        """Parse a HTML fragment into a well-formed tree fragment
+
+        :arg container: name of the element we're setting the innerHTML
+            property if set to None, default to 'div'
+
+        :arg stream: a file-like object or string containing the HTML to be parsed
+
+            The optional encoding parameter must be a string that indicates
+            the encoding.  If specified, that encoding will be used,
+            regardless of any BOM or later declaration (such as in a meta
+            element)
+
+        :arg scripting: treat noscript elements as if JavaScript was turned on
+
+        :returns: parsed tree
+
+        Example:
+
+        >>> from html5lib.html5libparser import HTMLParser
+        >>> parser = HTMLParser()
+        >>> parser.parseFragment('<b>this is a fragment</b>')
+        <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>
+
+        """
+        self._parse(stream, True, *args, **kwargs)
+        return self.tree.getFragment()
+
+    def parseError(self, errorcode="XXX-undefined-error", datavars=None):
+        # XXX The idea is to make errorcode mandatory.
+        if datavars is None:
+            datavars = {}
+        self.errors.append((self.tokenizer.stream.position(), errorcode, datavars))
+        if self.strict:
+            raise ParseError(E[errorcode] % datavars)
+
+    def normalizeToken(self, token):
+        # HTML5 specific normalizations to the token stream
+        if token["type"] == tokenTypes["StartTag"]:
+            raw = token["data"]
+            token["data"] = OrderedDict(raw)
+            if len(raw) > len(token["data"]):
+                # we had some duplicated attribute, fix so first wins
+                token["data"].update(raw[::-1])
+
+        return token
+
+    def adjustMathMLAttributes(self, token):
+        adjust_attributes(token, adjustMathMLAttributes)
+
+    def adjustSVGAttributes(self, token):
+        adjust_attributes(token, adjustSVGAttributes)
+
+    def adjustForeignAttributes(self, token):
+        adjust_attributes(token, adjustForeignAttributesMap)
+
+    def reparseTokenNormal(self, token):
+        # pylint:disable=unused-argument
+        self.parser.phase()
+
+    def resetInsertionMode(self):
+        # The name of this method is mostly historical. (It's also used in the
+        # specification.)
+        last = False
+        newModes = {
+            "select": "inSelect",
+            "td": "inCell",
+            "th": "inCell",
+            "tr": "inRow",
+            "tbody": "inTableBody",
+            "thead": "inTableBody",
+            "tfoot": "inTableBody",
+            "caption": "inCaption",
+            "colgroup": "inColumnGroup",
+            "table": "inTable",
+            "head": "inBody",
+            "body": "inBody",
+            "frameset": "inFrameset",
+            "html": "beforeHead"
+        }
+        for node in self.tree.openElements[::-1]:
+            nodeName = node.name
+            new_phase = None
+            if node == self.tree.openElements[0]:
+                assert self.innerHTML
+                last = True
+                nodeName = self.innerHTML
+            # Check for conditions that should only happen in the innerHTML
+            # case
+            if nodeName in ("select", "colgroup", "head", "html"):
+                assert self.innerHTML
+
+            if not last and node.namespace != self.tree.defaultNamespace:
+                continue
+
+            if nodeName in newModes:
+                new_phase = self.phases[newModes[nodeName]]
+                break
+            elif last:
+                new_phase = self.phases["inBody"]
+                break
+
+        self.phase = new_phase
+
+    def parseRCDataRawtext(self, token, contentType):
+        # Generic RCDATA/RAWTEXT Parsing algorithm
+        assert contentType in ("RAWTEXT", "RCDATA")
+
+        self.tree.insertElement(token)
+
+        if contentType == "RAWTEXT":
+            self.tokenizer.state = self.tokenizer.rawtextState
+        else:
+            self.tokenizer.state = self.tokenizer.rcdataState
+
+        self.originalPhase = self.phase
+
+        self.phase = self.phases["text"]
+
+
+@_utils.memoize
+def getPhases(debug):
+    def log(function):
+        """Logger that records which phase processes each token"""
+        type_names = dict((value, key) for key, value in
+                          tokenTypes.items())
+
+        def wrapped(self, *args, **kwargs):
+            if function.__name__.startswith("process") and len(args) > 0:
+                token = args[0]
+                try:
+                    info = {"type": type_names[token['type']]}
+                except:
+                    raise
+                if token['type'] in tagTokenTypes:
+                    info["name"] = token['name']
+
+                self.parser.log.append((self.parser.tokenizer.state.__name__,
+                                        self.parser.phase.__class__.__name__,
+                                        self.__class__.__name__,
+                                        function.__name__,
+                                        info))
+                return function(self, *args, **kwargs)
+            else:
+                return function(self, *args, **kwargs)
+        return wrapped
+
+    def getMetaclass(use_metaclass, metaclass_func):
+        if use_metaclass:
+            return method_decorator_metaclass(metaclass_func)
+        else:
+            return type
+
+    # pylint:disable=unused-argument
+    class Phase(with_metaclass(getMetaclass(debug, log))):
+        """Base class for helper object that implements each phase of processing
+        """
+
+        def __init__(self, parser, tree):
+            self.parser = parser
+            self.tree = tree
+
+        def processEOF(self):
+            raise NotImplementedError
+
+        def processComment(self, token):
+            # For most phases the following is correct. Where it's not it will be
+            # overridden.
+            self.tree.insertComment(token, self.tree.openElements[-1])
+
+        def processDoctype(self, token):
+            self.parser.parseError("unexpected-doctype")
+
+        def processCharacters(self, token):
+            self.tree.insertText(token["data"])
+
+        def processSpaceCharacters(self, token):
+            self.tree.insertText(token["data"])
+
+        def processStartTag(self, token):
+            return self.startTagHandler[token["name"]](token)
+
+        def startTagHtml(self, token):
+            if not self.parser.firstStartTag and token["name"] == "html":
+                self.parser.parseError("non-html-root")
+            # XXX Need a check here to see if the first start tag token emitted is
+            # this token... If it's not, invoke self.parser.parseError().
+            for attr, value in token["data"].items():
+                if attr not in self.tree.openElements[0].attributes:
+                    self.tree.openElements[0].attributes[attr] = value
+            self.parser.firstStartTag = False
+
+        def processEndTag(self, token):
+            return self.endTagHandler[token["name"]](token)
+
+    class InitialPhase(Phase):
+        def processSpaceCharacters(self, token):
+            pass
+
+        def processComment(self, token):
+            self.tree.insertComment(token, self.tree.document)
+
+        def processDoctype(self, token):
+            name = token["name"]
+            publicId = token["publicId"]
+            systemId = token["systemId"]
+            correct = token["correct"]
+
+            if (name != "html" or publicId is not None or
+                    systemId is not None and systemId != "about:legacy-compat"):
+                self.parser.parseError("unknown-doctype")
+
+            if publicId is None:
+                publicId = ""
+
+            self.tree.insertDoctype(token)
+
+            if publicId != "":
+                publicId = publicId.translate(asciiUpper2Lower)
+
+            if (not correct or token["name"] != "html" or
+                    publicId.startswith(
+                        ("+//silmaril//dtd html pro v0r11 19970101//",
+                         "-//advasoft ltd//dtd html 3.0 aswedit + extensions//",
+                         "-//as//dtd html 3.0 aswedit + extensions//",
+                         "-//ietf//dtd html 2.0 level 1//",
+                         "-//ietf//dtd html 2.0 level 2//",
+                         "-//ietf//dtd html 2.0 strict level 1//",
+                         "-//ietf//dtd html 2.0 strict level 2//",
+                         "-//ietf//dtd html 2.0 strict//",
+                         "-//ietf//dtd html 2.0//",
+                         "-//ietf//dtd html 2.1e//",
+                         "-//ietf//dtd html 3.0//",
+                         "-//ietf//dtd html 3.2 final//",
+                         "-//ietf//dtd html 3.2//",
+                         "-//ietf//dtd html 3//",
+                         "-//ietf//dtd html level 0//",
+                         "-//ietf//dtd html level 1//",
+                         "-//ietf//dtd html level 2//",
+                         "-//ietf//dtd html level 3//",
+                         "-//ietf//dtd html strict level 0//",
+                         "-//ietf//dtd html strict level 1//",
+                         "-//ietf//dtd html strict level 2//",
+                         "-//ietf//dtd html strict level 3//",
+                         "-//ietf//dtd html strict//",
+                         "-//ietf//dtd html//",
+                         "-//metrius//dtd metrius presentational//",
+                         "-//microsoft//dtd internet explorer 2.0 html strict//",
+                         "-//microsoft//dtd internet explorer 2.0 html//",
+                         "-//microsoft//dtd internet explorer 2.0 tables//",
+                         "-//microsoft//dtd internet explorer 3.0 html strict//",
+                         "-//microsoft//dtd internet explorer 3.0 html//",
+                         "-//microsoft//dtd internet explorer 3.0 tables//",
+                         "-//netscape comm. corp.//dtd html//",
+                         "-//netscape comm. corp.//dtd strict html//",
+                         "-//o'reilly and associates//dtd html 2.0//",
+                         "-//o'reilly and associates//dtd html extended 1.0//",
+                         "-//o'reilly and associates//dtd html extended relaxed 1.0//",
+                         "-//softquad software//dtd hotmetal pro 6.0::19990601::extensions to html 4.0//",
+                         "-//softquad//dtd hotmetal pro 4.0::19971010::extensions to html 4.0//",
+                         "-//spyglass//dtd html 2.0 extended//",
+                         "-//sq//dtd html 2.0 hotmetal + extensions//",
+                         "-//sun microsystems corp.//dtd hotjava html//",
+                         "-//sun microsystems corp.//dtd hotjava strict html//",
+                         "-//w3c//dtd html 3 1995-03-24//",
+                         "-//w3c//dtd html 3.2 draft//",
+                         "-//w3c//dtd html 3.2 final//",
+                         "-//w3c//dtd html 3.2//",
+                         "-//w3c//dtd html 3.2s draft//",
+                         "-//w3c//dtd html 4.0 frameset//",
+                         "-//w3c//dtd html 4.0 transitional//",
+                         "-//w3c//dtd html experimental 19960712//",
+                         "-//w3c//dtd html experimental 970421//",
+                         "-//w3c//dtd w3 html//",
+                         "-//w3o//dtd w3 html 3.0//",
+                         "-//webtechs//dtd mozilla html 2.0//",
+                         "-//webtechs//dtd mozilla html//")) or
+                    publicId in ("-//w3o//dtd w3 html strict 3.0//en//",
+                                 "-/w3c/dtd html 4.0 transitional/en",
+                                 "html") or
+                    publicId.startswith(
+                        ("-//w3c//dtd html 4.01 frameset//",
+                         "-//w3c//dtd html 4.01 transitional//")) and
+                    systemId is None or
+                    systemId and systemId.lower() == "http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd"):
+                self.parser.compatMode = "quirks"
+            elif (publicId.startswith(
+                    ("-//w3c//dtd xhtml 1.0 frameset//",
+                     "-//w3c//dtd xhtml 1.0 transitional//")) or
+                  publicId.startswith(
+                      ("-//w3c//dtd html 4.01 frameset//",
+                       "-//w3c//dtd html 4.01 transitional//")) and
+                  systemId is not None):
+                self.parser.compatMode = "limited quirks"
+
+            self.parser.phase = self.parser.phases["beforeHtml"]
+
+        def anythingElse(self):
+            self.parser.compatMode = "quirks"
+            self.parser.phase = self.parser.phases["beforeHtml"]
+
+        def processCharacters(self, token):
+            self.parser.parseError("expected-doctype-but-got-chars")
+            self.anythingElse()
+            return token
+
+        def processStartTag(self, token):
+            self.parser.parseError("expected-doctype-but-got-start-tag",
+                                   {"name": token["name"]})
+            self.anythingElse()
+            return token
+
+        def processEndTag(self, token):
+            self.parser.parseError("expected-doctype-but-got-end-tag",
+                                   {"name": token["name"]})
+            self.anythingElse()
+            return token
+
+        def processEOF(self):
+            self.parser.parseError("expected-doctype-but-got-eof")
+            self.anythingElse()
+            return True
+
+    class BeforeHtmlPhase(Phase):
+        # helper methods
+        def insertHtmlElement(self):
+            self.tree.insertRoot(impliedTagToken("html", "StartTag"))
+            self.parser.phase = self.parser.phases["beforeHead"]
+
+        # other
+        def processEOF(self):
+            self.insertHtmlElement()
+            return True
+
+        def processComment(self, token):
+            self.tree.insertComment(token, self.tree.document)
+
+        def processSpaceCharacters(self, token):
+            pass
+
+        def processCharacters(self, token):
+            self.insertHtmlElement()
+            return token
+
+        def processStartTag(self, token):
+            if token["name"] == "html":
+                self.parser.firstStartTag = True
+            self.insertHtmlElement()
+            return token
+
+        def processEndTag(self, token):
+            if token["name"] not in ("head", "body", "html", "br"):
+                self.parser.parseError("unexpected-end-tag-before-html",
+                                       {"name": token["name"]})
+            else:
+                self.insertHtmlElement()
+                return token
+
+    class BeforeHeadPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("head", self.startTagHead)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                (("head", "body", "html", "br"), self.endTagImplyHead)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            self.startTagHead(impliedTagToken("head", "StartTag"))
+            return True
+
+        def processSpaceCharacters(self, token):
+            pass
+
+        def processCharacters(self, token):
+            self.startTagHead(impliedTagToken("head", "StartTag"))
+            return token
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagHead(self, token):
+            self.tree.insertElement(token)
+            self.tree.headPointer = self.tree.openElements[-1]
+            self.parser.phase = self.parser.phases["inHead"]
+
+        def startTagOther(self, token):
+            self.startTagHead(impliedTagToken("head", "StartTag"))
+            return token
+
+        def endTagImplyHead(self, token):
+            self.startTagHead(impliedTagToken("head", "StartTag"))
+            return token
+
+        def endTagOther(self, token):
+            self.parser.parseError("end-tag-after-implied-root",
+                                   {"name": token["name"]})
+
+    class InHeadPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("title", self.startTagTitle),
+                (("noframes", "style"), self.startTagNoFramesStyle),
+                ("noscript", self.startTagNoscript),
+                ("script", self.startTagScript),
+                (("base", "basefont", "bgsound", "command", "link"),
+                 self.startTagBaseLinkCommand),
+                ("meta", self.startTagMeta),
+                ("head", self.startTagHead)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("head", self.endTagHead),
+                (("br", "html", "body"), self.endTagHtmlBodyBr)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # the real thing
+        def processEOF(self):
+            self.anythingElse()
+            return True
+
+        def processCharacters(self, token):
+            self.anythingElse()
+            return token
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagHead(self, token):
+            self.parser.parseError("two-heads-are-not-better-than-one")
+
+        def startTagBaseLinkCommand(self, token):
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+
+        def startTagMeta(self, token):
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+
+            attributes = token["data"]
+            if self.parser.tokenizer.stream.charEncoding[1] == "tentative":
+                if "charset" in attributes:
+                    self.parser.tokenizer.stream.changeEncoding(attributes["charset"])
+                elif ("content" in attributes and
+                      "http-equiv" in attributes and
+                      attributes["http-equiv"].lower() == "content-type"):
+                    # Encoding it as UTF-8 here is a hack, as really we should pass
+                    # the abstract Unicode string, and just use the
+                    # ContentAttrParser on that, but using UTF-8 allows all chars
+                    # to be encoded and as a ASCII-superset works.
+                    data = _inputstream.EncodingBytes(attributes["content"].encode("utf-8"))
+                    parser = _inputstream.ContentAttrParser(data)
+                    codec = parser.parse()
+                    self.parser.tokenizer.stream.changeEncoding(codec)
+
+        def startTagTitle(self, token):
+            self.parser.parseRCDataRawtext(token, "RCDATA")
+
+        def startTagNoFramesStyle(self, token):
+            # Need to decide whether to implement the scripting-disabled case
+            self.parser.parseRCDataRawtext(token, "RAWTEXT")
+
+        def startTagNoscript(self, token):
+            if self.parser.scripting:
+                self.parser.parseRCDataRawtext(token, "RAWTEXT")
+            else:
+                self.tree.insertElement(token)
+                self.parser.phase = self.parser.phases["inHeadNoscript"]
+
+        def startTagScript(self, token):
+            self.tree.insertElement(token)
+            self.parser.tokenizer.state = self.parser.tokenizer.scriptDataState
+            self.parser.originalPhase = self.parser.phase
+            self.parser.phase = self.parser.phases["text"]
+
+        def startTagOther(self, token):
+            self.anythingElse()
+            return token
+
+        def endTagHead(self, token):
+            node = self.parser.tree.openElements.pop()
+            assert node.name == "head", "Expected head got %s" % node.name
+            self.parser.phase = self.parser.phases["afterHead"]
+
+        def endTagHtmlBodyBr(self, token):
+            self.anythingElse()
+            return token
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def anythingElse(self):
+            self.endTagHead(impliedTagToken("head"))
+
+    class InHeadNoscriptPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                (("basefont", "bgsound", "link", "meta", "noframes", "style"), self.startTagBaseLinkCommand),
+                (("head", "noscript"), self.startTagHeadNoscript),
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("noscript", self.endTagNoscript),
+                ("br", self.endTagBr),
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            self.parser.parseError("eof-in-head-noscript")
+            self.anythingElse()
+            return True
+
+        def processComment(self, token):
+            return self.parser.phases["inHead"].processComment(token)
+
+        def processCharacters(self, token):
+            self.parser.parseError("char-in-head-noscript")
+            self.anythingElse()
+            return token
+
+        def processSpaceCharacters(self, token):
+            return self.parser.phases["inHead"].processSpaceCharacters(token)
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagBaseLinkCommand(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagHeadNoscript(self, token):
+            self.parser.parseError("unexpected-start-tag", {"name": token["name"]})
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-inhead-noscript-tag", {"name": token["name"]})
+            self.anythingElse()
+            return token
+
+        def endTagNoscript(self, token):
+            node = self.parser.tree.openElements.pop()
+            assert node.name == "noscript", "Expected noscript got %s" % node.name
+            self.parser.phase = self.parser.phases["inHead"]
+
+        def endTagBr(self, token):
+            self.parser.parseError("unexpected-inhead-noscript-tag", {"name": token["name"]})
+            self.anythingElse()
+            return token
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def anythingElse(self):
+            # Caller must raise parse error first!
+            self.endTagNoscript(impliedTagToken("noscript"))
+
+    class AfterHeadPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("body", self.startTagBody),
+                ("frameset", self.startTagFrameset),
+                (("base", "basefont", "bgsound", "link", "meta", "noframes", "script",
+                  "style", "title"),
+                 self.startTagFromHead),
+                ("head", self.startTagHead)
+            ])
+            self.startTagHandler.default = self.startTagOther
+            self.endTagHandler = _utils.MethodDispatcher([(("body", "html", "br"),
+                                                           self.endTagHtmlBodyBr)])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            self.anythingElse()
+            return True
+
+        def processCharacters(self, token):
+            self.anythingElse()
+            return token
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagBody(self, token):
+            self.parser.framesetOK = False
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inBody"]
+
+        def startTagFrameset(self, token):
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inFrameset"]
+
+        def startTagFromHead(self, token):
+            self.parser.parseError("unexpected-start-tag-out-of-my-head",
+                                   {"name": token["name"]})
+            self.tree.openElements.append(self.tree.headPointer)
+            self.parser.phases["inHead"].processStartTag(token)
+            for node in self.tree.openElements[::-1]:
+                if node.name == "head":
+                    self.tree.openElements.remove(node)
+                    break
+
+        def startTagHead(self, token):
+            self.parser.parseError("unexpected-start-tag", {"name": token["name"]})
+
+        def startTagOther(self, token):
+            self.anythingElse()
+            return token
+
+        def endTagHtmlBodyBr(self, token):
+            self.anythingElse()
+            return token
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def anythingElse(self):
+            self.tree.insertElement(impliedTagToken("body", "StartTag"))
+            self.parser.phase = self.parser.phases["inBody"]
+            self.parser.framesetOK = True
+
+    class InBodyPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#parsing-main-inbody
+        # the really-really-really-very crazy mode
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            # Set this to the default handler
+            self.processSpaceCharacters = self.processSpaceCharactersNonPre
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                (("base", "basefont", "bgsound", "command", "link", "meta",
+                  "script", "style", "title"),
+                 self.startTagProcessInHead),
+                ("body", self.startTagBody),
+                ("frameset", self.startTagFrameset),
+                (("address", "article", "aside", "blockquote", "center", "details",
+                  "dir", "div", "dl", "fieldset", "figcaption", "figure",
+                  "footer", "header", "hgroup", "main", "menu", "nav", "ol", "p",
+                  "section", "summary", "ul"),
+                 self.startTagCloseP),
+                (headingElements, self.startTagHeading),
+                (("pre", "listing"), self.startTagPreListing),
+                ("form", self.startTagForm),
+                (("li", "dd", "dt"), self.startTagListItem),
+                ("plaintext", self.startTagPlaintext),
+                ("a", self.startTagA),
+                (("b", "big", "code", "em", "font", "i", "s", "small", "strike",
+                  "strong", "tt", "u"), self.startTagFormatting),
+                ("nobr", self.startTagNobr),
+                ("button", self.startTagButton),
+                (("applet", "marquee", "object"), self.startTagAppletMarqueeObject),
+                ("xmp", self.startTagXmp),
+                ("table", self.startTagTable),
+                (("area", "br", "embed", "img", "keygen", "wbr"),
+                 self.startTagVoidFormatting),
+                (("param", "source", "track"), self.startTagParamSource),
+                ("input", self.startTagInput),
+                ("hr", self.startTagHr),
+                ("image", self.startTagImage),
+                ("isindex", self.startTagIsIndex),
+                ("textarea", self.startTagTextarea),
+                ("iframe", self.startTagIFrame),
+                ("noscript", self.startTagNoscript),
+                (("noembed", "noframes"), self.startTagRawtext),
+                ("select", self.startTagSelect),
+                (("rp", "rt"), self.startTagRpRt),
+                (("option", "optgroup"), self.startTagOpt),
+                (("math"), self.startTagMath),
+                (("svg"), self.startTagSvg),
+                (("caption", "col", "colgroup", "frame", "head",
+                  "tbody", "td", "tfoot", "th", "thead",
+                  "tr"), self.startTagMisplaced)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("body", self.endTagBody),
+                ("html", self.endTagHtml),
+                (("address", "article", "aside", "blockquote", "button", "center",
+                  "details", "dialog", "dir", "div", "dl", "fieldset", "figcaption", "figure",
+                  "footer", "header", "hgroup", "listing", "main", "menu", "nav", "ol", "pre",
+                  "section", "summary", "ul"), self.endTagBlock),
+                ("form", self.endTagForm),
+                ("p", self.endTagP),
+                (("dd", "dt", "li"), self.endTagListItem),
+                (headingElements, self.endTagHeading),
+                (("a", "b", "big", "code", "em", "font", "i", "nobr", "s", "small",
+                  "strike", "strong", "tt", "u"), self.endTagFormatting),
+                (("applet", "marquee", "object"), self.endTagAppletMarqueeObject),
+                ("br", self.endTagBr),
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def isMatchingFormattingElement(self, node1, node2):
+            return (node1.name == node2.name and
+                    node1.namespace == node2.namespace and
+                    node1.attributes == node2.attributes)
+
+        # helper
+        def addFormattingElement(self, token):
+            self.tree.insertElement(token)
+            element = self.tree.openElements[-1]
+
+            matchingElements = []
+            for node in self.tree.activeFormattingElements[::-1]:
+                if node is Marker:
+                    break
+                elif self.isMatchingFormattingElement(node, element):
+                    matchingElements.append(node)
+
+            assert len(matchingElements) <= 3
+            if len(matchingElements) == 3:
+                self.tree.activeFormattingElements.remove(matchingElements[-1])
+            self.tree.activeFormattingElements.append(element)
+
+        # the real deal
+        def processEOF(self):
+            allowed_elements = frozenset(("dd", "dt", "li", "p", "tbody", "td",
+                                          "tfoot", "th", "thead", "tr", "body",
+                                          "html"))
+            for node in self.tree.openElements[::-1]:
+                if node.name not in allowed_elements:
+                    self.parser.parseError("expected-closing-tag-but-got-eof")
+                    break
+            # Stop parsing
+
+        def processSpaceCharactersDropNewline(self, token):
+            # Sometimes (start of <pre>, <listing>, and <textarea> blocks) we
+            # want to drop leading newlines
+            data = token["data"]
+            self.processSpaceCharacters = self.processSpaceCharactersNonPre
+            if (data.startswith("\n") and
+                self.tree.openElements[-1].name in ("pre", "listing", "textarea") and
+                    not self.tree.openElements[-1].hasContent()):
+                data = data[1:]
+            if data:
+                self.tree.reconstructActiveFormattingElements()
+                self.tree.insertText(data)
+
+        def processCharacters(self, token):
+            if token["data"] == "\u0000":
+                # The tokenizer should always emit null on its own
+                return
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertText(token["data"])
+            # This must be bad for performance
+            if (self.parser.framesetOK and
+                any([char not in spaceCharacters
+                     for char in token["data"]])):
+                self.parser.framesetOK = False
+
+        def processSpaceCharactersNonPre(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertText(token["data"])
+
+        def startTagProcessInHead(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagBody(self, token):
+            self.parser.parseError("unexpected-start-tag", {"name": "body"})
+            if (len(self.tree.openElements) == 1 or
+                    self.tree.openElements[1].name != "body"):
+                assert self.parser.innerHTML
+            else:
+                self.parser.framesetOK = False
+                for attr, value in token["data"].items():
+                    if attr not in self.tree.openElements[1].attributes:
+                        self.tree.openElements[1].attributes[attr] = value
+
+        def startTagFrameset(self, token):
+            self.parser.parseError("unexpected-start-tag", {"name": "frameset"})
+            if (len(self.tree.openElements) == 1 or self.tree.openElements[1].name != "body"):
+                assert self.parser.innerHTML
+            elif not self.parser.framesetOK:
+                pass
+            else:
+                if self.tree.openElements[1].parent:
+                    self.tree.openElements[1].parent.removeChild(self.tree.openElements[1])
+                while self.tree.openElements[-1].name != "html":
+                    self.tree.openElements.pop()
+                self.tree.insertElement(token)
+                self.parser.phase = self.parser.phases["inFrameset"]
+
+        def startTagCloseP(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            self.tree.insertElement(token)
+
+        def startTagPreListing(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            self.tree.insertElement(token)
+            self.parser.framesetOK = False
+            self.processSpaceCharacters = self.processSpaceCharactersDropNewline
+
+        def startTagForm(self, token):
+            if self.tree.formPointer:
+                self.parser.parseError("unexpected-start-tag", {"name": "form"})
+            else:
+                if self.tree.elementInScope("p", variant="button"):
+                    self.endTagP(impliedTagToken("p"))
+                self.tree.insertElement(token)
+                self.tree.formPointer = self.tree.openElements[-1]
+
+        def startTagListItem(self, token):
+            self.parser.framesetOK = False
+
+            stopNamesMap = {"li": ["li"],
+                            "dt": ["dt", "dd"],
+                            "dd": ["dt", "dd"]}
+            stopNames = stopNamesMap[token["name"]]
+            for node in reversed(self.tree.openElements):
+                if node.name in stopNames:
+                    self.parser.phase.processEndTag(
+                        impliedTagToken(node.name, "EndTag"))
+                    break
+                if (node.nameTuple in specialElements and
+                        node.name not in ("address", "div", "p")):
+                    break
+
+            if self.tree.elementInScope("p", variant="button"):
+                self.parser.phase.processEndTag(
+                    impliedTagToken("p", "EndTag"))
+
+            self.tree.insertElement(token)
+
+        def startTagPlaintext(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            self.tree.insertElement(token)
+            self.parser.tokenizer.state = self.parser.tokenizer.plaintextState
+
+        def startTagHeading(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            if self.tree.openElements[-1].name in headingElements:
+                self.parser.parseError("unexpected-start-tag", {"name": token["name"]})
+                self.tree.openElements.pop()
+            self.tree.insertElement(token)
+
+        def startTagA(self, token):
+            afeAElement = self.tree.elementInActiveFormattingElements("a")
+            if afeAElement:
+                self.parser.parseError("unexpected-start-tag-implies-end-tag",
+                                       {"startName": "a", "endName": "a"})
+                self.endTagFormatting(impliedTagToken("a"))
+                if afeAElement in self.tree.openElements:
+                    self.tree.openElements.remove(afeAElement)
+                if afeAElement in self.tree.activeFormattingElements:
+                    self.tree.activeFormattingElements.remove(afeAElement)
+            self.tree.reconstructActiveFormattingElements()
+            self.addFormattingElement(token)
+
+        def startTagFormatting(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.addFormattingElement(token)
+
+        def startTagNobr(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            if self.tree.elementInScope("nobr"):
+                self.parser.parseError("unexpected-start-tag-implies-end-tag",
+                                       {"startName": "nobr", "endName": "nobr"})
+                self.processEndTag(impliedTagToken("nobr"))
+                # XXX Need tests that trigger the following
+                self.tree.reconstructActiveFormattingElements()
+            self.addFormattingElement(token)
+
+        def startTagButton(self, token):
+            if self.tree.elementInScope("button"):
+                self.parser.parseError("unexpected-start-tag-implies-end-tag",
+                                       {"startName": "button", "endName": "button"})
+                self.processEndTag(impliedTagToken("button"))
+                return token
+            else:
+                self.tree.reconstructActiveFormattingElements()
+                self.tree.insertElement(token)
+                self.parser.framesetOK = False
+
+        def startTagAppletMarqueeObject(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertElement(token)
+            self.tree.activeFormattingElements.append(Marker)
+            self.parser.framesetOK = False
+
+        def startTagXmp(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            self.tree.reconstructActiveFormattingElements()
+            self.parser.framesetOK = False
+            self.parser.parseRCDataRawtext(token, "RAWTEXT")
+
+        def startTagTable(self, token):
+            if self.parser.compatMode != "quirks":
+                if self.tree.elementInScope("p", variant="button"):
+                    self.processEndTag(impliedTagToken("p"))
+            self.tree.insertElement(token)
+            self.parser.framesetOK = False
+            self.parser.phase = self.parser.phases["inTable"]
+
+        def startTagVoidFormatting(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+            self.parser.framesetOK = False
+
+        def startTagInput(self, token):
+            framesetOK = self.parser.framesetOK
+            self.startTagVoidFormatting(token)
+            if ("type" in token["data"] and
+                    token["data"]["type"].translate(asciiUpper2Lower) == "hidden"):
+                # input type=hidden doesn't change framesetOK
+                self.parser.framesetOK = framesetOK
+
+        def startTagParamSource(self, token):
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+
+        def startTagHr(self, token):
+            if self.tree.elementInScope("p", variant="button"):
+                self.endTagP(impliedTagToken("p"))
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+            self.parser.framesetOK = False
+
+        def startTagImage(self, token):
+            # No really...
+            self.parser.parseError("unexpected-start-tag-treated-as",
+                                   {"originalName": "image", "newName": "img"})
+            self.processStartTag(impliedTagToken("img", "StartTag",
+                                                 attributes=token["data"],
+                                                 selfClosing=token["selfClosing"]))
+
+        def startTagIsIndex(self, token):
+            self.parser.parseError("deprecated-tag", {"name": "isindex"})
+            if self.tree.formPointer:
+                return
+            form_attrs = {}
+            if "action" in token["data"]:
+                form_attrs["action"] = token["data"]["action"]
+            self.processStartTag(impliedTagToken("form", "StartTag",
+                                                 attributes=form_attrs))
+            self.processStartTag(impliedTagToken("hr", "StartTag"))
+            self.processStartTag(impliedTagToken("label", "StartTag"))
+            # XXX Localization ...
+            if "prompt" in token["data"]:
+                prompt = token["data"]["prompt"]
+            else:
+                prompt = "This is a searchable index. Enter search keywords: "
+            self.processCharacters(
+                {"type": tokenTypes["Characters"], "data": prompt})
+            attributes = token["data"].copy()
+            if "action" in attributes:
+                del attributes["action"]
+            if "prompt" in attributes:
+                del attributes["prompt"]
+            attributes["name"] = "isindex"
+            self.processStartTag(impliedTagToken("input", "StartTag",
+                                                 attributes=attributes,
+                                                 selfClosing=token["selfClosing"]))
+            self.processEndTag(impliedTagToken("label"))
+            self.processStartTag(impliedTagToken("hr", "StartTag"))
+            self.processEndTag(impliedTagToken("form"))
+
+        def startTagTextarea(self, token):
+            self.tree.insertElement(token)
+            self.parser.tokenizer.state = self.parser.tokenizer.rcdataState
+            self.processSpaceCharacters = self.processSpaceCharactersDropNewline
+            self.parser.framesetOK = False
+
+        def startTagIFrame(self, token):
+            self.parser.framesetOK = False
+            self.startTagRawtext(token)
+
+        def startTagNoscript(self, token):
+            if self.parser.scripting:
+                self.startTagRawtext(token)
+            else:
+                self.startTagOther(token)
+
+        def startTagRawtext(self, token):
+            """iframe, noembed noframes, noscript(if scripting enabled)"""
+            self.parser.parseRCDataRawtext(token, "RAWTEXT")
+
+        def startTagOpt(self, token):
+            if self.tree.openElements[-1].name == "option":
+                self.parser.phase.processEndTag(impliedTagToken("option"))
+            self.tree.reconstructActiveFormattingElements()
+            self.parser.tree.insertElement(token)
+
+        def startTagSelect(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertElement(token)
+            self.parser.framesetOK = False
+            if self.parser.phase in (self.parser.phases["inTable"],
+                                     self.parser.phases["inCaption"],
+                                     self.parser.phases["inColumnGroup"],
+                                     self.parser.phases["inTableBody"],
+                                     self.parser.phases["inRow"],
+                                     self.parser.phases["inCell"]):
+                self.parser.phase = self.parser.phases["inSelectInTable"]
+            else:
+                self.parser.phase = self.parser.phases["inSelect"]
+
+        def startTagRpRt(self, token):
+            if self.tree.elementInScope("ruby"):
+                self.tree.generateImpliedEndTags()
+                if self.tree.openElements[-1].name != "ruby":
+                    self.parser.parseError()
+            self.tree.insertElement(token)
+
+        def startTagMath(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.parser.adjustMathMLAttributes(token)
+            self.parser.adjustForeignAttributes(token)
+            token["namespace"] = namespaces["mathml"]
+            self.tree.insertElement(token)
+            # Need to get the parse error right for the case where the token
+            # has a namespace not equal to the xmlns attribute
+            if token["selfClosing"]:
+                self.tree.openElements.pop()
+                token["selfClosingAcknowledged"] = True
+
+        def startTagSvg(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.parser.adjustSVGAttributes(token)
+            self.parser.adjustForeignAttributes(token)
+            token["namespace"] = namespaces["svg"]
+            self.tree.insertElement(token)
+            # Need to get the parse error right for the case where the token
+            # has a namespace not equal to the xmlns attribute
+            if token["selfClosing"]:
+                self.tree.openElements.pop()
+                token["selfClosingAcknowledged"] = True
+
+        def startTagMisplaced(self, token):
+            """ Elements that should be children of other elements that have a
+            different insertion mode; here they are ignored
+            "caption", "col", "colgroup", "frame", "frameset", "head",
+            "option", "optgroup", "tbody", "td", "tfoot", "th", "thead",
+            "tr", "noscript"
+            """
+            self.parser.parseError("unexpected-start-tag-ignored", {"name": token["name"]})
+
+        def startTagOther(self, token):
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertElement(token)
+
+        def endTagP(self, token):
+            if not self.tree.elementInScope("p", variant="button"):
+                self.startTagCloseP(impliedTagToken("p", "StartTag"))
+                self.parser.parseError("unexpected-end-tag", {"name": "p"})
+                self.endTagP(impliedTagToken("p", "EndTag"))
+            else:
+                self.tree.generateImpliedEndTags("p")
+                if self.tree.openElements[-1].name != "p":
+                    self.parser.parseError("unexpected-end-tag", {"name": "p"})
+                node = self.tree.openElements.pop()
+                while node.name != "p":
+                    node = self.tree.openElements.pop()
+
+        def endTagBody(self, token):
+            if not self.tree.elementInScope("body"):
+                self.parser.parseError()
+                return
+            elif self.tree.openElements[-1].name != "body":
+                for node in self.tree.openElements[2:]:
+                    if node.name not in frozenset(("dd", "dt", "li", "optgroup",
+                                                   "option", "p", "rp", "rt",
+                                                   "tbody", "td", "tfoot",
+                                                   "th", "thead", "tr", "body",
+                                                   "html")):
+                        # Not sure this is the correct name for the parse error
+                        self.parser.parseError(
+                            "expected-one-end-tag-but-got-another",
+                            {"gotName": "body", "expectedName": node.name})
+                        break
+            self.parser.phase = self.parser.phases["afterBody"]
+
+        def endTagHtml(self, token):
+            # We repeat the test for the body end tag token being ignored here
+            if self.tree.elementInScope("body"):
+                self.endTagBody(impliedTagToken("body"))
+                return token
+
+        def endTagBlock(self, token):
+            # Put us back in the right whitespace handling mode
+            if token["name"] == "pre":
+                self.processSpaceCharacters = self.processSpaceCharactersNonPre
+            inScope = self.tree.elementInScope(token["name"])
+            if inScope:
+                self.tree.generateImpliedEndTags()
+            if self.tree.openElements[-1].name != token["name"]:
+                self.parser.parseError("end-tag-too-early", {"name": token["name"]})
+            if inScope:
+                node = self.tree.openElements.pop()
+                while node.name != token["name"]:
+                    node = self.tree.openElements.pop()
+
+        def endTagForm(self, token):
+            node = self.tree.formPointer
+            self.tree.formPointer = None
+            if node is None or not self.tree.elementInScope(node):
+                self.parser.parseError("unexpected-end-tag",
+                                       {"name": "form"})
+            else:
+                self.tree.generateImpliedEndTags()
+                if self.tree.openElements[-1] != node:
+                    self.parser.parseError("end-tag-too-early-ignored",
+                                           {"name": "form"})
+                self.tree.openElements.remove(node)
+
+        def endTagListItem(self, token):
+            if token["name"] == "li":
+                variant = "list"
+            else:
+                variant = None
+            if not self.tree.elementInScope(token["name"], variant=variant):
+                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+            else:
+                self.tree.generateImpliedEndTags(exclude=token["name"])
+                if self.tree.openElements[-1].name != token["name"]:
+                    self.parser.parseError(
+                        "end-tag-too-early",
+                        {"name": token["name"]})
+                node = self.tree.openElements.pop()
+                while node.name != token["name"]:
+                    node = self.tree.openElements.pop()
+
+        def endTagHeading(self, token):
+            for item in headingElements:
+                if self.tree.elementInScope(item):
+                    self.tree.generateImpliedEndTags()
+                    break
+            if self.tree.openElements[-1].name != token["name"]:
+                self.parser.parseError("end-tag-too-early", {"name": token["name"]})
+
+            for item in headingElements:
+                if self.tree.elementInScope(item):
+                    item = self.tree.openElements.pop()
+                    while item.name not in headingElements:
+                        item = self.tree.openElements.pop()
+                    break
+
+        def endTagFormatting(self, token):
+            """The much-feared adoption agency algorithm"""
+            # http://svn.whatwg.org/webapps/complete.html#adoptionAgency revision 7867
+            # XXX Better parseError messages appreciated.
+
+            # Step 1
+            outerLoopCounter = 0
+
+            # Step 2
+            while outerLoopCounter < 8:
+
+                # Step 3
+                outerLoopCounter += 1
+
+                # Step 4:
+
+                # Let the formatting element be the last element in
+                # the list of active formatting elements that:
+                # - is between the end of the list and the last scope
+                # marker in the list, if any, or the start of the list
+                # otherwise, and
+                # - has the same tag name as the token.
+                formattingElement = self.tree.elementInActiveFormattingElements(
+                    token["name"])
+                if (not formattingElement or
+                    (formattingElement in self.tree.openElements and
+                     not self.tree.elementInScope(formattingElement.name))):
+                    # If there is no such node, then abort these steps
+                    # and instead act as described in the "any other
+                    # end tag" entry below.
+                    self.endTagOther(token)
+                    return
+
+                # Otherwise, if there is such a node, but that node is
+                # not in the stack of open elements, then this is a
+                # parse error; remove the element from the list, and
+                # abort these steps.
+                elif formattingElement not in self.tree.openElements:
+                    self.parser.parseError("adoption-agency-1.2", {"name": token["name"]})
+                    self.tree.activeFormattingElements.remove(formattingElement)
+                    return
+
+                # Otherwise, if there is such a node, and that node is
+                # also in the stack of open elements, but the element
+                # is not in scope, then this is a parse error; ignore
+                # the token, and abort these steps.
+                elif not self.tree.elementInScope(formattingElement.name):
+                    self.parser.parseError("adoption-agency-4.4", {"name": token["name"]})
+                    return
+
+                # Otherwise, there is a formatting element and that
+                # element is in the stack and is in scope. If the
+                # element is not the current node, this is a parse
+                # error. In any case, proceed with the algorithm as
+                # written in the following steps.
+                else:
+                    if formattingElement != self.tree.openElements[-1]:
+                        self.parser.parseError("adoption-agency-1.3", {"name": token["name"]})
+
+                # Step 5:
+
+                # Let the furthest block be the topmost node in the
+                # stack of open elements that is lower in the stack
+                # than the formatting element, and is an element in
+                # the special category. There might not be one.
+                afeIndex = self.tree.openElements.index(formattingElement)
+                furthestBlock = None
+                for element in self.tree.openElements[afeIndex:]:
+                    if element.nameTuple in specialElements:
+                        furthestBlock = element
+                        break
+
+                # Step 6:
+
+                # If there is no furthest block, then the UA must
+                # first pop all the nodes from the bottom of the stack
+                # of open elements, from the current node up to and
+                # including the formatting element, then remove the
+                # formatting element from the list of active
+                # formatting elements, and finally abort these steps.
+                if furthestBlock is None:
+                    element = self.tree.openElements.pop()
+                    while element != formattingElement:
+                        element = self.tree.openElements.pop()
+                    self.tree.activeFormattingElements.remove(element)
+                    return
+
+                # Step 7
+                commonAncestor = self.tree.openElements[afeIndex - 1]
+
+                # Step 8:
+                # The bookmark is supposed to help us identify where to reinsert
+                # nodes in step 15. We have to ensure that we reinsert nodes after
+                # the node before the active formatting element. Note the bookmark
+                # can move in step 9.7
+                bookmark = self.tree.activeFormattingElements.index(formattingElement)
+
+                # Step 9
+                lastNode = node = furthestBlock
+                innerLoopCounter = 0
+
+                index = self.tree.openElements.index(node)
+                while innerLoopCounter < 3:
+                    innerLoopCounter += 1
+                    # Node is element before node in open elements
+                    index -= 1
+                    node = self.tree.openElements[index]
+                    if node not in self.tree.activeFormattingElements:
+                        self.tree.openElements.remove(node)
+                        continue
+                    # Step 9.6
+                    if node == formattingElement:
+                        break
+                    # Step 9.7
+                    if lastNode == furthestBlock:
+                        bookmark = self.tree.activeFormattingElements.index(node) + 1
+                    # Step 9.8
+                    clone = node.cloneNode()
+                    # Replace node with clone
+                    self.tree.activeFormattingElements[
+                        self.tree.activeFormattingElements.index(node)] = clone
+                    self.tree.openElements[
+                        self.tree.openElements.index(node)] = clone
+                    node = clone
+                    # Step 9.9
+                    # Remove lastNode from its parents, if any
+                    if lastNode.parent:
+                        lastNode.parent.removeChild(lastNode)
+                    node.appendChild(lastNode)
+                    # Step 9.10
+                    lastNode = node
+
+                # Step 10
+                # Foster parent lastNode if commonAncestor is a
+                # table, tbody, tfoot, thead, or tr we need to foster
+                # parent the lastNode
+                if lastNode.parent:
+                    lastNode.parent.removeChild(lastNode)
+
+                if commonAncestor.name in frozenset(("table", "tbody", "tfoot", "thead", "tr")):
+                    parent, insertBefore = self.tree.getTableMisnestedNodePosition()
+                    parent.insertBefore(lastNode, insertBefore)
+                else:
+                    commonAncestor.appendChild(lastNode)
+
+                # Step 11
+                clone = formattingElement.cloneNode()
+
+                # Step 12
+                furthestBlock.reparentChildren(clone)
+
+                # Step 13
+                furthestBlock.appendChild(clone)
+
+                # Step 14
+                self.tree.activeFormattingElements.remove(formattingElement)
+                self.tree.activeFormattingElements.insert(bookmark, clone)
+
+                # Step 15
+                self.tree.openElements.remove(formattingElement)
+                self.tree.openElements.insert(
+                    self.tree.openElements.index(furthestBlock) + 1, clone)
+
+        def endTagAppletMarqueeObject(self, token):
+            if self.tree.elementInScope(token["name"]):
+                self.tree.generateImpliedEndTags()
+            if self.tree.openElements[-1].name != token["name"]:
+                self.parser.parseError("end-tag-too-early", {"name": token["name"]})
+
+            if self.tree.elementInScope(token["name"]):
+                element = self.tree.openElements.pop()
+                while element.name != token["name"]:
+                    element = self.tree.openElements.pop()
+                self.tree.clearActiveFormattingElements()
+
+        def endTagBr(self, token):
+            self.parser.parseError("unexpected-end-tag-treated-as",
+                                   {"originalName": "br", "newName": "br element"})
+            self.tree.reconstructActiveFormattingElements()
+            self.tree.insertElement(impliedTagToken("br", "StartTag"))
+            self.tree.openElements.pop()
+
+        def endTagOther(self, token):
+            for node in self.tree.openElements[::-1]:
+                if node.name == token["name"]:
+                    self.tree.generateImpliedEndTags(exclude=token["name"])
+                    if self.tree.openElements[-1].name != token["name"]:
+                        self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+                    while self.tree.openElements.pop() != node:
+                        pass
+                    break
+                else:
+                    if node.nameTuple in specialElements:
+                        self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+                        break
+
+    class TextPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.startTagHandler = _utils.MethodDispatcher([])
+            self.startTagHandler.default = self.startTagOther
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("script", self.endTagScript)])
+            self.endTagHandler.default = self.endTagOther
+
+        def processCharacters(self, token):
+            self.tree.insertText(token["data"])
+
+        def processEOF(self):
+            self.parser.parseError("expected-named-closing-tag-but-got-eof",
+                                   {"name": self.tree.openElements[-1].name})
+            self.tree.openElements.pop()
+            self.parser.phase = self.parser.originalPhase
+            return True
+
+        def startTagOther(self, token):
+            assert False, "Tried to process start tag %s in RCDATA/RAWTEXT mode" % token['name']
+
+        def endTagScript(self, token):
+            node = self.tree.openElements.pop()
+            assert node.name == "script"
+            self.parser.phase = self.parser.originalPhase
+            # The rest of this method is all stuff that only happens if
+            # document.write works
+
+        def endTagOther(self, token):
+            self.tree.openElements.pop()
+            self.parser.phase = self.parser.originalPhase
+
+    class InTablePhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-table
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("caption", self.startTagCaption),
+                ("colgroup", self.startTagColgroup),
+                ("col", self.startTagCol),
+                (("tbody", "tfoot", "thead"), self.startTagRowGroup),
+                (("td", "th", "tr"), self.startTagImplyTbody),
+                ("table", self.startTagTable),
+                (("style", "script"), self.startTagStyleScript),
+                ("input", self.startTagInput),
+                ("form", self.startTagForm)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("table", self.endTagTable),
+                (("body", "caption", "col", "colgroup", "html", "tbody", "td",
+                  "tfoot", "th", "thead", "tr"), self.endTagIgnore)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # helper methods
+        def clearStackToTableContext(self):
+            # "clear the stack back to a table context"
+            while self.tree.openElements[-1].name not in ("table", "html"):
+                # self.parser.parseError("unexpected-implied-end-tag-in-table",
+                #  {"name":  self.tree.openElements[-1].name})
+                self.tree.openElements.pop()
+            # When the current node is <html> it's an innerHTML case
+
+        # processing methods
+        def processEOF(self):
+            if self.tree.openElements[-1].name != "html":
+                self.parser.parseError("eof-in-table")
+            else:
+                assert self.parser.innerHTML
+            # Stop parsing
+
+        def processSpaceCharacters(self, token):
+            originalPhase = self.parser.phase
+            self.parser.phase = self.parser.phases["inTableText"]
+            self.parser.phase.originalPhase = originalPhase
+            self.parser.phase.processSpaceCharacters(token)
+
+        def processCharacters(self, token):
+            originalPhase = self.parser.phase
+            self.parser.phase = self.parser.phases["inTableText"]
+            self.parser.phase.originalPhase = originalPhase
+            self.parser.phase.processCharacters(token)
+
+        def insertText(self, token):
+            # If we get here there must be at least one non-whitespace character
+            # Do the table magic!
+            self.tree.insertFromTable = True
+            self.parser.phases["inBody"].processCharacters(token)
+            self.tree.insertFromTable = False
+
+        def startTagCaption(self, token):
+            self.clearStackToTableContext()
+            self.tree.activeFormattingElements.append(Marker)
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inCaption"]
+
+        def startTagColgroup(self, token):
+            self.clearStackToTableContext()
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inColumnGroup"]
+
+        def startTagCol(self, token):
+            self.startTagColgroup(impliedTagToken("colgroup", "StartTag"))
+            return token
+
+        def startTagRowGroup(self, token):
+            self.clearStackToTableContext()
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inTableBody"]
+
+        def startTagImplyTbody(self, token):
+            self.startTagRowGroup(impliedTagToken("tbody", "StartTag"))
+            return token
+
+        def startTagTable(self, token):
+            self.parser.parseError("unexpected-start-tag-implies-end-tag",
+                                   {"startName": "table", "endName": "table"})
+            self.parser.phase.processEndTag(impliedTagToken("table"))
+            if not self.parser.innerHTML:
+                return token
+
+        def startTagStyleScript(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagInput(self, token):
+            if ("type" in token["data"] and
+                    token["data"]["type"].translate(asciiUpper2Lower) == "hidden"):
+                self.parser.parseError("unexpected-hidden-input-in-table")
+                self.tree.insertElement(token)
+                # XXX associate with form
+                self.tree.openElements.pop()
+            else:
+                self.startTagOther(token)
+
+        def startTagForm(self, token):
+            self.parser.parseError("unexpected-form-in-table")
+            if self.tree.formPointer is None:
+                self.tree.insertElement(token)
+                self.tree.formPointer = self.tree.openElements[-1]
+                self.tree.openElements.pop()
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-start-tag-implies-table-voodoo", {"name": token["name"]})
+            # Do the table magic!
+            self.tree.insertFromTable = True
+            self.parser.phases["inBody"].processStartTag(token)
+            self.tree.insertFromTable = False
+
+        def endTagTable(self, token):
+            if self.tree.elementInScope("table", variant="table"):
+                self.tree.generateImpliedEndTags()
+                if self.tree.openElements[-1].name != "table":
+                    self.parser.parseError("end-tag-too-early-named",
+                                           {"gotName": "table",
+                                            "expectedName": self.tree.openElements[-1].name})
+                while self.tree.openElements[-1].name != "table":
+                    self.tree.openElements.pop()
+                self.tree.openElements.pop()
+                self.parser.resetInsertionMode()
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def endTagIgnore(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag-implies-table-voodoo", {"name": token["name"]})
+            # Do the table magic!
+            self.tree.insertFromTable = True
+            self.parser.phases["inBody"].processEndTag(token)
+            self.tree.insertFromTable = False
+
+    class InTableTextPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.originalPhase = None
+            self.characterTokens = []
+
+        def flushCharacters(self):
+            data = "".join([item["data"] for item in self.characterTokens])
+            if any([item not in spaceCharacters for item in data]):
+                token = {"type": tokenTypes["Characters"], "data": data}
+                self.parser.phases["inTable"].insertText(token)
+            elif data:
+                self.tree.insertText(data)
+            self.characterTokens = []
+
+        def processComment(self, token):
+            self.flushCharacters()
+            self.parser.phase = self.originalPhase
+            return token
+
+        def processEOF(self):
+            self.flushCharacters()
+            self.parser.phase = self.originalPhase
+            return True
+
+        def processCharacters(self, token):
+            if token["data"] == "\u0000":
+                return
+            self.characterTokens.append(token)
+
+        def processSpaceCharacters(self, token):
+            # pretty sure we should never reach here
+            self.characterTokens.append(token)
+    #        assert False
+
+        def processStartTag(self, token):
+            self.flushCharacters()
+            self.parser.phase = self.originalPhase
+            return token
+
+        def processEndTag(self, token):
+            self.flushCharacters()
+            self.parser.phase = self.originalPhase
+            return token
+
+    class InCaptionPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-caption
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                (("caption", "col", "colgroup", "tbody", "td", "tfoot", "th",
+                  "thead", "tr"), self.startTagTableElement)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("caption", self.endTagCaption),
+                ("table", self.endTagTable),
+                (("body", "col", "colgroup", "html", "tbody", "td", "tfoot", "th",
+                  "thead", "tr"), self.endTagIgnore)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def ignoreEndTagCaption(self):
+            return not self.tree.elementInScope("caption", variant="table")
+
+        def processEOF(self):
+            self.parser.phases["inBody"].processEOF()
+
+        def processCharacters(self, token):
+            return self.parser.phases["inBody"].processCharacters(token)
+
+        def startTagTableElement(self, token):
+            self.parser.parseError()
+            # XXX Have to duplicate logic here to find out if the tag is ignored
+            ignoreEndTag = self.ignoreEndTagCaption()
+            self.parser.phase.processEndTag(impliedTagToken("caption"))
+            if not ignoreEndTag:
+                return token
+
+        def startTagOther(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def endTagCaption(self, token):
+            if not self.ignoreEndTagCaption():
+                # AT this code is quite similar to endTagTable in "InTable"
+                self.tree.generateImpliedEndTags()
+                if self.tree.openElements[-1].name != "caption":
+                    self.parser.parseError("expected-one-end-tag-but-got-another",
+                                           {"gotName": "caption",
+                                            "expectedName": self.tree.openElements[-1].name})
+                while self.tree.openElements[-1].name != "caption":
+                    self.tree.openElements.pop()
+                self.tree.openElements.pop()
+                self.tree.clearActiveFormattingElements()
+                self.parser.phase = self.parser.phases["inTable"]
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def endTagTable(self, token):
+            self.parser.parseError()
+            ignoreEndTag = self.ignoreEndTagCaption()
+            self.parser.phase.processEndTag(impliedTagToken("caption"))
+            if not ignoreEndTag:
+                return token
+
+        def endTagIgnore(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def endTagOther(self, token):
+            return self.parser.phases["inBody"].processEndTag(token)
+
+    class InColumnGroupPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-column
+
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("col", self.startTagCol)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("colgroup", self.endTagColgroup),
+                ("col", self.endTagCol)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def ignoreEndTagColgroup(self):
+            return self.tree.openElements[-1].name == "html"
+
+        def processEOF(self):
+            if self.tree.openElements[-1].name == "html":
+                assert self.parser.innerHTML
+                return
+            else:
+                ignoreEndTag = self.ignoreEndTagColgroup()
+                self.endTagColgroup(impliedTagToken("colgroup"))
+                if not ignoreEndTag:
+                    return True
+
+        def processCharacters(self, token):
+            ignoreEndTag = self.ignoreEndTagColgroup()
+            self.endTagColgroup(impliedTagToken("colgroup"))
+            if not ignoreEndTag:
+                return token
+
+        def startTagCol(self, token):
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+            token["selfClosingAcknowledged"] = True
+
+        def startTagOther(self, token):
+            ignoreEndTag = self.ignoreEndTagColgroup()
+            self.endTagColgroup(impliedTagToken("colgroup"))
+            if not ignoreEndTag:
+                return token
+
+        def endTagColgroup(self, token):
+            if self.ignoreEndTagColgroup():
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+            else:
+                self.tree.openElements.pop()
+                self.parser.phase = self.parser.phases["inTable"]
+
+        def endTagCol(self, token):
+            self.parser.parseError("no-end-tag", {"name": "col"})
+
+        def endTagOther(self, token):
+            ignoreEndTag = self.ignoreEndTagColgroup()
+            self.endTagColgroup(impliedTagToken("colgroup"))
+            if not ignoreEndTag:
+                return token
+
+    class InTableBodyPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-table0
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("tr", self.startTagTr),
+                (("td", "th"), self.startTagTableCell),
+                (("caption", "col", "colgroup", "tbody", "tfoot", "thead"),
+                 self.startTagTableOther)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                (("tbody", "tfoot", "thead"), self.endTagTableRowGroup),
+                ("table", self.endTagTable),
+                (("body", "caption", "col", "colgroup", "html", "td", "th",
+                  "tr"), self.endTagIgnore)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # helper methods
+        def clearStackToTableBodyContext(self):
+            while self.tree.openElements[-1].name not in ("tbody", "tfoot",
+                                                          "thead", "html"):
+                # self.parser.parseError("unexpected-implied-end-tag-in-table",
+                #  {"name": self.tree.openElements[-1].name})
+                self.tree.openElements.pop()
+            if self.tree.openElements[-1].name == "html":
+                assert self.parser.innerHTML
+
+        # the rest
+        def processEOF(self):
+            self.parser.phases["inTable"].processEOF()
+
+        def processSpaceCharacters(self, token):
+            return self.parser.phases["inTable"].processSpaceCharacters(token)
+
+        def processCharacters(self, token):
+            return self.parser.phases["inTable"].processCharacters(token)
+
+        def startTagTr(self, token):
+            self.clearStackToTableBodyContext()
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inRow"]
+
+        def startTagTableCell(self, token):
+            self.parser.parseError("unexpected-cell-in-table-body",
+                                   {"name": token["name"]})
+            self.startTagTr(impliedTagToken("tr", "StartTag"))
+            return token
+
+        def startTagTableOther(self, token):
+            # XXX AT Any ideas on how to share this with endTagTable?
+            if (self.tree.elementInScope("tbody", variant="table") or
+                self.tree.elementInScope("thead", variant="table") or
+                    self.tree.elementInScope("tfoot", variant="table")):
+                self.clearStackToTableBodyContext()
+                self.endTagTableRowGroup(
+                    impliedTagToken(self.tree.openElements[-1].name))
+                return token
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def startTagOther(self, token):
+            return self.parser.phases["inTable"].processStartTag(token)
+
+        def endTagTableRowGroup(self, token):
+            if self.tree.elementInScope(token["name"], variant="table"):
+                self.clearStackToTableBodyContext()
+                self.tree.openElements.pop()
+                self.parser.phase = self.parser.phases["inTable"]
+            else:
+                self.parser.parseError("unexpected-end-tag-in-table-body",
+                                       {"name": token["name"]})
+
+        def endTagTable(self, token):
+            if (self.tree.elementInScope("tbody", variant="table") or
+                self.tree.elementInScope("thead", variant="table") or
+                    self.tree.elementInScope("tfoot", variant="table")):
+                self.clearStackToTableBodyContext()
+                self.endTagTableRowGroup(
+                    impliedTagToken(self.tree.openElements[-1].name))
+                return token
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def endTagIgnore(self, token):
+            self.parser.parseError("unexpected-end-tag-in-table-body",
+                                   {"name": token["name"]})
+
+        def endTagOther(self, token):
+            return self.parser.phases["inTable"].processEndTag(token)
+
+    class InRowPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-row
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                (("td", "th"), self.startTagTableCell),
+                (("caption", "col", "colgroup", "tbody", "tfoot", "thead",
+                  "tr"), self.startTagTableOther)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("tr", self.endTagTr),
+                ("table", self.endTagTable),
+                (("tbody", "tfoot", "thead"), self.endTagTableRowGroup),
+                (("body", "caption", "col", "colgroup", "html", "td", "th"),
+                 self.endTagIgnore)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # helper methods (XXX unify this with other table helper methods)
+        def clearStackToTableRowContext(self):
+            while self.tree.openElements[-1].name not in ("tr", "html"):
+                self.parser.parseError("unexpected-implied-end-tag-in-table-row",
+                                       {"name": self.tree.openElements[-1].name})
+                self.tree.openElements.pop()
+
+        def ignoreEndTagTr(self):
+            return not self.tree.elementInScope("tr", variant="table")
+
+        # the rest
+        def processEOF(self):
+            self.parser.phases["inTable"].processEOF()
+
+        def processSpaceCharacters(self, token):
+            return self.parser.phases["inTable"].processSpaceCharacters(token)
+
+        def processCharacters(self, token):
+            return self.parser.phases["inTable"].processCharacters(token)
+
+        def startTagTableCell(self, token):
+            self.clearStackToTableRowContext()
+            self.tree.insertElement(token)
+            self.parser.phase = self.parser.phases["inCell"]
+            self.tree.activeFormattingElements.append(Marker)
+
+        def startTagTableOther(self, token):
+            ignoreEndTag = self.ignoreEndTagTr()
+            self.endTagTr(impliedTagToken("tr"))
+            # XXX how are we sure it's always ignored in the innerHTML case?
+            if not ignoreEndTag:
+                return token
+
+        def startTagOther(self, token):
+            return self.parser.phases["inTable"].processStartTag(token)
+
+        def endTagTr(self, token):
+            if not self.ignoreEndTagTr():
+                self.clearStackToTableRowContext()
+                self.tree.openElements.pop()
+                self.parser.phase = self.parser.phases["inTableBody"]
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def endTagTable(self, token):
+            ignoreEndTag = self.ignoreEndTagTr()
+            self.endTagTr(impliedTagToken("tr"))
+            # Reprocess the current tag if the tr end tag was not ignored
+            # XXX how are we sure it's always ignored in the innerHTML case?
+            if not ignoreEndTag:
+                return token
+
+        def endTagTableRowGroup(self, token):
+            if self.tree.elementInScope(token["name"], variant="table"):
+                self.endTagTr(impliedTagToken("tr"))
+                return token
+            else:
+                self.parser.parseError()
+
+        def endTagIgnore(self, token):
+            self.parser.parseError("unexpected-end-tag-in-table-row",
+                                   {"name": token["name"]})
+
+        def endTagOther(self, token):
+            return self.parser.phases["inTable"].processEndTag(token)
+
+    class InCellPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-cell
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                (("caption", "col", "colgroup", "tbody", "td", "tfoot", "th",
+                  "thead", "tr"), self.startTagTableOther)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                (("td", "th"), self.endTagTableCell),
+                (("body", "caption", "col", "colgroup", "html"), self.endTagIgnore),
+                (("table", "tbody", "tfoot", "thead", "tr"), self.endTagImply)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # helper
+        def closeCell(self):
+            if self.tree.elementInScope("td", variant="table"):
+                self.endTagTableCell(impliedTagToken("td"))
+            elif self.tree.elementInScope("th", variant="table"):
+                self.endTagTableCell(impliedTagToken("th"))
+
+        # the rest
+        def processEOF(self):
+            self.parser.phases["inBody"].processEOF()
+
+        def processCharacters(self, token):
+            return self.parser.phases["inBody"].processCharacters(token)
+
+        def startTagTableOther(self, token):
+            if (self.tree.elementInScope("td", variant="table") or
+                    self.tree.elementInScope("th", variant="table")):
+                self.closeCell()
+                return token
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def startTagOther(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def endTagTableCell(self, token):
+            if self.tree.elementInScope(token["name"], variant="table"):
+                self.tree.generateImpliedEndTags(token["name"])
+                if self.tree.openElements[-1].name != token["name"]:
+                    self.parser.parseError("unexpected-cell-end-tag",
+                                           {"name": token["name"]})
+                    while True:
+                        node = self.tree.openElements.pop()
+                        if node.name == token["name"]:
+                            break
+                else:
+                    self.tree.openElements.pop()
+                self.tree.clearActiveFormattingElements()
+                self.parser.phase = self.parser.phases["inRow"]
+            else:
+                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def endTagIgnore(self, token):
+            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+        def endTagImply(self, token):
+            if self.tree.elementInScope(token["name"], variant="table"):
+                self.closeCell()
+                return token
+            else:
+                # sometimes innerHTML case
+                self.parser.parseError()
+
+        def endTagOther(self, token):
+            return self.parser.phases["inBody"].processEndTag(token)
+
+    class InSelectPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("option", self.startTagOption),
+                ("optgroup", self.startTagOptgroup),
+                ("select", self.startTagSelect),
+                (("input", "keygen", "textarea"), self.startTagInput),
+                ("script", self.startTagScript)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("option", self.endTagOption),
+                ("optgroup", self.endTagOptgroup),
+                ("select", self.endTagSelect)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-select
+        def processEOF(self):
+            if self.tree.openElements[-1].name != "html":
+                self.parser.parseError("eof-in-select")
+            else:
+                assert self.parser.innerHTML
+
+        def processCharacters(self, token):
+            if token["data"] == "\u0000":
+                return
+            self.tree.insertText(token["data"])
+
+        def startTagOption(self, token):
+            # We need to imply </option> if <option> is the current node.
+            if self.tree.openElements[-1].name == "option":
+                self.tree.openElements.pop()
+            self.tree.insertElement(token)
+
+        def startTagOptgroup(self, token):
+            if self.tree.openElements[-1].name == "option":
+                self.tree.openElements.pop()
+            if self.tree.openElements[-1].name == "optgroup":
+                self.tree.openElements.pop()
+            self.tree.insertElement(token)
+
+        def startTagSelect(self, token):
+            self.parser.parseError("unexpected-select-in-select")
+            self.endTagSelect(impliedTagToken("select"))
+
+        def startTagInput(self, token):
+            self.parser.parseError("unexpected-input-in-select")
+            if self.tree.elementInScope("select", variant="select"):
+                self.endTagSelect(impliedTagToken("select"))
+                return token
+            else:
+                assert self.parser.innerHTML
+
+        def startTagScript(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-start-tag-in-select",
+                                   {"name": token["name"]})
+
+        def endTagOption(self, token):
+            if self.tree.openElements[-1].name == "option":
+                self.tree.openElements.pop()
+            else:
+                self.parser.parseError("unexpected-end-tag-in-select",
+                                       {"name": "option"})
+
+        def endTagOptgroup(self, token):
+            # </optgroup> implicitly closes <option>
+            if (self.tree.openElements[-1].name == "option" and
+                    self.tree.openElements[-2].name == "optgroup"):
+                self.tree.openElements.pop()
+            # It also closes </optgroup>
+            if self.tree.openElements[-1].name == "optgroup":
+                self.tree.openElements.pop()
+            # But nothing else
+            else:
+                self.parser.parseError("unexpected-end-tag-in-select",
+                                       {"name": "optgroup"})
+
+        def endTagSelect(self, token):
+            if self.tree.elementInScope("select", variant="select"):
+                node = self.tree.openElements.pop()
+                while node.name != "select":
+                    node = self.tree.openElements.pop()
+                self.parser.resetInsertionMode()
+            else:
+                # innerHTML case
+                assert self.parser.innerHTML
+                self.parser.parseError()
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag-in-select",
+                                   {"name": token["name"]})
+
+    class InSelectInTablePhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                (("caption", "table", "tbody", "tfoot", "thead", "tr", "td", "th"),
+                 self.startTagTable)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                (("caption", "table", "tbody", "tfoot", "thead", "tr", "td", "th"),
+                 self.endTagTable)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            self.parser.phases["inSelect"].processEOF()
+
+        def processCharacters(self, token):
+            return self.parser.phases["inSelect"].processCharacters(token)
+
+        def startTagTable(self, token):
+            self.parser.parseError("unexpected-table-element-start-tag-in-select-in-table", {"name": token["name"]})
+            self.endTagOther(impliedTagToken("select"))
+            return token
+
+        def startTagOther(self, token):
+            return self.parser.phases["inSelect"].processStartTag(token)
+
+        def endTagTable(self, token):
+            self.parser.parseError("unexpected-table-element-end-tag-in-select-in-table", {"name": token["name"]})
+            if self.tree.elementInScope(token["name"], variant="table"):
+                self.endTagOther(impliedTagToken("select"))
+                return token
+
+        def endTagOther(self, token):
+            return self.parser.phases["inSelect"].processEndTag(token)
+
+    class InForeignContentPhase(Phase):
+        breakoutElements = frozenset(["b", "big", "blockquote", "body", "br",
+                                      "center", "code", "dd", "div", "dl", "dt",
+                                      "em", "embed", "h1", "h2", "h3",
+                                      "h4", "h5", "h6", "head", "hr", "i", "img",
+                                      "li", "listing", "menu", "meta", "nobr",
+                                      "ol", "p", "pre", "ruby", "s", "small",
+                                      "span", "strong", "strike", "sub", "sup",
+                                      "table", "tt", "u", "ul", "var"])
+
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+        def adjustSVGTagNames(self, token):
+            replacements = {"altglyph": "altGlyph",
+                            "altglyphdef": "altGlyphDef",
+                            "altglyphitem": "altGlyphItem",
+                            "animatecolor": "animateColor",
+                            "animatemotion": "animateMotion",
+                            "animatetransform": "animateTransform",
+                            "clippath": "clipPath",
+                            "feblend": "feBlend",
+                            "fecolormatrix": "feColorMatrix",
+                            "fecomponenttransfer": "feComponentTransfer",
+                            "fecomposite": "feComposite",
+                            "feconvolvematrix": "feConvolveMatrix",
+                            "fediffuselighting": "feDiffuseLighting",
+                            "fedisplacementmap": "feDisplacementMap",
+                            "fedistantlight": "feDistantLight",
+                            "feflood": "feFlood",
+                            "fefunca": "feFuncA",
+                            "fefuncb": "feFuncB",
+                            "fefuncg": "feFuncG",
+                            "fefuncr": "feFuncR",
+                            "fegaussianblur": "feGaussianBlur",
+                            "feimage": "feImage",
+                            "femerge": "feMerge",
+                            "femergenode": "feMergeNode",
+                            "femorphology": "feMorphology",
+                            "feoffset": "feOffset",
+                            "fepointlight": "fePointLight",
+                            "fespecularlighting": "feSpecularLighting",
+                            "fespotlight": "feSpotLight",
+                            "fetile": "feTile",
+                            "feturbulence": "feTurbulence",
+                            "foreignobject": "foreignObject",
+                            "glyphref": "glyphRef",
+                            "lineargradient": "linearGradient",
+                            "radialgradient": "radialGradient",
+                            "textpath": "textPath"}
+
+            if token["name"] in replacements:
+                token["name"] = replacements[token["name"]]
+
+        def processCharacters(self, token):
+            if token["data"] == "\u0000":
+                token["data"] = "\uFFFD"
+            elif (self.parser.framesetOK and
+                  any(char not in spaceCharacters for char in token["data"])):
+                self.parser.framesetOK = False
+            Phase.processCharacters(self, token)
+
+        def processStartTag(self, token):
+            currentNode = self.tree.openElements[-1]
+            if (token["name"] in self.breakoutElements or
+                (token["name"] == "font" and
+                 set(token["data"].keys()) & set(["color", "face", "size"]))):
+                self.parser.parseError("unexpected-html-element-in-foreign-content",
+                                       {"name": token["name"]})
+                while (self.tree.openElements[-1].namespace !=
+                       self.tree.defaultNamespace and
+                       not self.parser.isHTMLIntegrationPoint(self.tree.openElements[-1]) and
+                       not self.parser.isMathMLTextIntegrationPoint(self.tree.openElements[-1])):
+                    self.tree.openElements.pop()
+                return token
+
+            else:
+                if currentNode.namespace == namespaces["mathml"]:
+                    self.parser.adjustMathMLAttributes(token)
+                elif currentNode.namespace == namespaces["svg"]:
+                    self.adjustSVGTagNames(token)
+                    self.parser.adjustSVGAttributes(token)
+                self.parser.adjustForeignAttributes(token)
+                token["namespace"] = currentNode.namespace
+                self.tree.insertElement(token)
+                if token["selfClosing"]:
+                    self.tree.openElements.pop()
+                    token["selfClosingAcknowledged"] = True
+
+        def processEndTag(self, token):
+            nodeIndex = len(self.tree.openElements) - 1
+            node = self.tree.openElements[-1]
+            if node.name.translate(asciiUpper2Lower) != token["name"]:
+                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
+
+            while True:
+                if node.name.translate(asciiUpper2Lower) == token["name"]:
+                    # XXX this isn't in the spec but it seems necessary
+                    if self.parser.phase == self.parser.phases["inTableText"]:
+                        self.parser.phase.flushCharacters()
+                        self.parser.phase = self.parser.phase.originalPhase
+                    while self.tree.openElements.pop() != node:
+                        assert self.tree.openElements
+                    new_token = None
+                    break
+                nodeIndex -= 1
+
+                node = self.tree.openElements[nodeIndex]
+                if node.namespace != self.tree.defaultNamespace:
+                    continue
+                else:
+                    new_token = self.parser.phase.processEndTag(token)
+                    break
+            return new_token
+
+    class AfterBodyPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([("html", self.endTagHtml)])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            # Stop parsing
+            pass
+
+        def processComment(self, token):
+            # This is needed because data is to be appended to the <html> element
+            # here and not to whatever is currently open.
+            self.tree.insertComment(token, self.tree.openElements[0])
+
+        def processCharacters(self, token):
+            self.parser.parseError("unexpected-char-after-body")
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-start-tag-after-body",
+                                   {"name": token["name"]})
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+        def endTagHtml(self, name):
+            if self.parser.innerHTML:
+                self.parser.parseError("unexpected-end-tag-after-body-innerhtml")
+            else:
+                self.parser.phase = self.parser.phases["afterAfterBody"]
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag-after-body",
+                                   {"name": token["name"]})
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+    class InFramesetPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#in-frameset
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("frameset", self.startTagFrameset),
+                ("frame", self.startTagFrame),
+                ("noframes", self.startTagNoframes)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("frameset", self.endTagFrameset)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            if self.tree.openElements[-1].name != "html":
+                self.parser.parseError("eof-in-frameset")
+            else:
+                assert self.parser.innerHTML
+
+        def processCharacters(self, token):
+            self.parser.parseError("unexpected-char-in-frameset")
+
+        def startTagFrameset(self, token):
+            self.tree.insertElement(token)
+
+        def startTagFrame(self, token):
+            self.tree.insertElement(token)
+            self.tree.openElements.pop()
+
+        def startTagNoframes(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-start-tag-in-frameset",
+                                   {"name": token["name"]})
+
+        def endTagFrameset(self, token):
+            if self.tree.openElements[-1].name == "html":
+                # innerHTML case
+                self.parser.parseError("unexpected-frameset-in-frameset-innerhtml")
+            else:
+                self.tree.openElements.pop()
+            if (not self.parser.innerHTML and
+                    self.tree.openElements[-1].name != "frameset"):
+                # If we're not in innerHTML mode and the current node is not a
+                # "frameset" element (anymore) then switch.
+                self.parser.phase = self.parser.phases["afterFrameset"]
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag-in-frameset",
+                                   {"name": token["name"]})
+
+    class AfterFramesetPhase(Phase):
+        # http://www.whatwg.org/specs/web-apps/current-work/#after3
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("noframes", self.startTagNoframes)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+            self.endTagHandler = _utils.MethodDispatcher([
+                ("html", self.endTagHtml)
+            ])
+            self.endTagHandler.default = self.endTagOther
+
+        def processEOF(self):
+            # Stop parsing
+            pass
+
+        def processCharacters(self, token):
+            self.parser.parseError("unexpected-char-after-frameset")
+
+        def startTagNoframes(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("unexpected-start-tag-after-frameset",
+                                   {"name": token["name"]})
+
+        def endTagHtml(self, token):
+            self.parser.phase = self.parser.phases["afterAfterFrameset"]
+
+        def endTagOther(self, token):
+            self.parser.parseError("unexpected-end-tag-after-frameset",
+                                   {"name": token["name"]})
+
+    class AfterAfterBodyPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+        def processEOF(self):
+            pass
+
+        def processComment(self, token):
+            self.tree.insertComment(token, self.tree.document)
+
+        def processSpaceCharacters(self, token):
+            return self.parser.phases["inBody"].processSpaceCharacters(token)
+
+        def processCharacters(self, token):
+            self.parser.parseError("expected-eof-but-got-char")
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("expected-eof-but-got-start-tag",
+                                   {"name": token["name"]})
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+        def processEndTag(self, token):
+            self.parser.parseError("expected-eof-but-got-end-tag",
+                                   {"name": token["name"]})
+            self.parser.phase = self.parser.phases["inBody"]
+            return token
+
+    class AfterAfterFramesetPhase(Phase):
+        def __init__(self, parser, tree):
+            Phase.__init__(self, parser, tree)
+
+            self.startTagHandler = _utils.MethodDispatcher([
+                ("html", self.startTagHtml),
+                ("noframes", self.startTagNoFrames)
+            ])
+            self.startTagHandler.default = self.startTagOther
+
+        def processEOF(self):
+            pass
+
+        def processComment(self, token):
+            self.tree.insertComment(token, self.tree.document)
+
+        def processSpaceCharacters(self, token):
+            return self.parser.phases["inBody"].processSpaceCharacters(token)
+
+        def processCharacters(self, token):
+            self.parser.parseError("expected-eof-but-got-char")
+
+        def startTagHtml(self, token):
+            return self.parser.phases["inBody"].processStartTag(token)
+
+        def startTagNoFrames(self, token):
+            return self.parser.phases["inHead"].processStartTag(token)
+
+        def startTagOther(self, token):
+            self.parser.parseError("expected-eof-but-got-start-tag",
+                                   {"name": token["name"]})
+
+        def processEndTag(self, token):
+            self.parser.parseError("expected-eof-but-got-end-tag",
+                                   {"name": token["name"]})
+    # pylint:enable=unused-argument
+
+    return {
+        "initial": InitialPhase,
+        "beforeHtml": BeforeHtmlPhase,
+        "beforeHead": BeforeHeadPhase,
+        "inHead": InHeadPhase,
+        "inHeadNoscript": InHeadNoscriptPhase,
+        "afterHead": AfterHeadPhase,
+        "inBody": InBodyPhase,
+        "text": TextPhase,
+        "inTable": InTablePhase,
+        "inTableText": InTableTextPhase,
+        "inCaption": InCaptionPhase,
+        "inColumnGroup": InColumnGroupPhase,
+        "inTableBody": InTableBodyPhase,
+        "inRow": InRowPhase,
+        "inCell": InCellPhase,
+        "inSelect": InSelectPhase,
+        "inSelectInTable": InSelectInTablePhase,
+        "inForeignContent": InForeignContentPhase,
+        "afterBody": AfterBodyPhase,
+        "inFrameset": InFramesetPhase,
+        "afterFrameset": AfterFramesetPhase,
+        "afterAfterBody": AfterAfterBodyPhase,
+        "afterAfterFrameset": AfterAfterFramesetPhase,
+        # XXX after after frameset
+    }
+
+
+def adjust_attributes(token, replacements):
+    needs_adjustment = viewkeys(token['data']) & viewkeys(replacements)
+    if needs_adjustment:
+        token['data'] = OrderedDict((replacements.get(k, k), v)
+                                    for k, v in token['data'].items())
+
+
+def impliedTagToken(name, type="EndTag", attributes=None,
+                    selfClosing=False):
+    if attributes is None:
+        attributes = {}
+    return {"type": tokenTypes[type], "name": name, "data": attributes,
+            "selfClosing": selfClosing}
+
+
+class ParseError(Exception):
+    """Error in parsed document"""
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/serializer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6b7105d48096c42e9c4a4a5fa16f5474da5f060
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/serializer.py
@@ -0,0 +1,409 @@
+from __future__ import absolute_import, division, unicode_literals
+from six import text_type
+
+import re
+
+from codecs import register_error, xmlcharrefreplace_errors
+
+from .constants import voidElements, booleanAttributes, spaceCharacters
+from .constants import rcdataElements, entities, xmlEntities
+from . import treewalkers, _utils
+from xml.sax.saxutils import escape
+
+_quoteAttributeSpecChars = "".join(spaceCharacters) + "\"'=<>`"
+_quoteAttributeSpec = re.compile("[" + _quoteAttributeSpecChars + "]")
+_quoteAttributeLegacy = re.compile("[" + _quoteAttributeSpecChars +
+                                   "\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n"
+                                   "\x0b\x0c\r\x0e\x0f\x10\x11\x12\x13\x14\x15"
+                                   "\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f"
+                                   "\x20\x2f\x60\xa0\u1680\u180e\u180f\u2000"
+                                   "\u2001\u2002\u2003\u2004\u2005\u2006\u2007"
+                                   "\u2008\u2009\u200a\u2028\u2029\u202f\u205f"
+                                   "\u3000]")
+
+
+_encode_entity_map = {}
+_is_ucs4 = len("\U0010FFFF") == 1
+for k, v in list(entities.items()):
+    # skip multi-character entities
+    if ((_is_ucs4 and len(v) > 1) or
+            (not _is_ucs4 and len(v) > 2)):
+        continue
+    if v != "&":
+        if len(v) == 2:
+            v = _utils.surrogatePairToCodepoint(v)
+        else:
+            v = ord(v)
+        if v not in _encode_entity_map or k.islower():
+            # prefer &lt; over &LT; and similarly for &amp;, &gt;, etc.
+            _encode_entity_map[v] = k
+
+
+def htmlentityreplace_errors(exc):
+    if isinstance(exc, (UnicodeEncodeError, UnicodeTranslateError)):
+        res = []
+        codepoints = []
+        skip = False
+        for i, c in enumerate(exc.object[exc.start:exc.end]):
+            if skip:
+                skip = False
+                continue
+            index = i + exc.start
+            if _utils.isSurrogatePair(exc.object[index:min([exc.end, index + 2])]):
+                codepoint = _utils.surrogatePairToCodepoint(exc.object[index:index + 2])
+                skip = True
+            else:
+                codepoint = ord(c)
+            codepoints.append(codepoint)
+        for cp in codepoints:
+            e = _encode_entity_map.get(cp)
+            if e:
+                res.append("&")
+                res.append(e)
+                if not e.endswith(";"):
+                    res.append(";")
+            else:
+                res.append("&#x%s;" % (hex(cp)[2:]))
+        return ("".join(res), exc.end)
+    else:
+        return xmlcharrefreplace_errors(exc)
+
+
+register_error("htmlentityreplace", htmlentityreplace_errors)
+
+
+def serialize(input, tree="etree", encoding=None, **serializer_opts):
+    """Serializes the input token stream using the specified treewalker
+
+    :arg input: the token stream to serialize
+
+    :arg tree: the treewalker to use
+
+    :arg encoding: the encoding to use
+
+    :arg serializer_opts: any options to pass to the
+        :py:class:`html5lib.serializer.HTMLSerializer` that gets created
+
+    :returns: the tree serialized as a string
+
+    Example:
+
+    >>> from html5lib.html5parser import parse
+    >>> from html5lib.serializer import serialize
+    >>> token_stream = parse('<html><body><p>Hi!</p></body></html>')
+    >>> serialize(token_stream, omit_optional_tags=False)
+    '<html><head></head><body><p>Hi!</p></body></html>'
+
+    """
+    # XXX: Should we cache this?
+    walker = treewalkers.getTreeWalker(tree)
+    s = HTMLSerializer(**serializer_opts)
+    return s.render(walker(input), encoding)
+
+
+class HTMLSerializer(object):
+
+    # attribute quoting options
+    quote_attr_values = "legacy"  # be secure by default
+    quote_char = '"'
+    use_best_quote_char = True
+
+    # tag syntax options
+    omit_optional_tags = True
+    minimize_boolean_attributes = True
+    use_trailing_solidus = False
+    space_before_trailing_solidus = True
+
+    # escaping options
+    escape_lt_in_attrs = False
+    escape_rcdata = False
+    resolve_entities = True
+
+    # miscellaneous options
+    alphabetical_attributes = False
+    inject_meta_charset = True
+    strip_whitespace = False
+    sanitize = False
+
+    options = ("quote_attr_values", "quote_char", "use_best_quote_char",
+               "omit_optional_tags", "minimize_boolean_attributes",
+               "use_trailing_solidus", "space_before_trailing_solidus",
+               "escape_lt_in_attrs", "escape_rcdata", "resolve_entities",
+               "alphabetical_attributes", "inject_meta_charset",
+               "strip_whitespace", "sanitize")
+
+    def __init__(self, **kwargs):
+        """Initialize HTMLSerializer
+
+        :arg inject_meta_charset: Whether or not to inject the meta charset.
+
+            Defaults to ``True``.
+
+        :arg quote_attr_values: Whether to quote attribute values that don't
+            require quoting per legacy browser behavior (``"legacy"``), when
+            required by the standard (``"spec"``), or always (``"always"``).
+
+            Defaults to ``"legacy"``.
+
+        :arg quote_char: Use given quote character for attribute quoting.
+
+            Defaults to ``"`` which will use double quotes unless attribute
+            value contains a double quote, in which case single quotes are
+            used.
+
+        :arg escape_lt_in_attrs: Whether or not to escape ``<`` in attribute
+            values.
+
+            Defaults to ``False``.
+
+        :arg escape_rcdata: Whether to escape characters that need to be
+            escaped within normal elements within rcdata elements such as
+            style.
+
+            Defaults to ``False``.
+
+        :arg resolve_entities: Whether to resolve named character entities that
+            appear in the source tree. The XML predefined entities &lt; &gt;
+            &amp; &quot; &apos; are unaffected by this setting.
+
+            Defaults to ``True``.
+
+        :arg strip_whitespace: Whether to remove semantically meaningless
+            whitespace. (This compresses all whitespace to a single space
+            except within ``pre``.)
+
+            Defaults to ``False``.
+
+        :arg minimize_boolean_attributes: Shortens boolean attributes to give
+            just the attribute value, for example::
+
+              <input disabled="disabled">
+
+            becomes::
+
+              <input disabled>
+
+            Defaults to ``True``.
+
+        :arg use_trailing_solidus: Includes a close-tag slash at the end of the
+            start tag of void elements (empty elements whose end tag is
+            forbidden). E.g. ``<hr/>``.
+
+            Defaults to ``False``.
+
+        :arg space_before_trailing_solidus: Places a space immediately before
+            the closing slash in a tag using a trailing solidus. E.g.
+            ``<hr />``. Requires ``use_trailing_solidus=True``.
+
+            Defaults to ``True``.
+
+        :arg sanitize: Strip all unsafe or unknown constructs from output.
+            See :py:class:`html5lib.filters.sanitizer.Filter`.
+
+            Defaults to ``False``.
+
+        :arg omit_optional_tags: Omit start/end tags that are optional.
+
+            Defaults to ``True``.
+
+        :arg alphabetical_attributes: Reorder attributes to be in alphabetical order.
+
+            Defaults to ``False``.
+
+        """
+        unexpected_args = frozenset(kwargs) - frozenset(self.options)
+        if len(unexpected_args) > 0:
+            raise TypeError("__init__() got an unexpected keyword argument '%s'" % next(iter(unexpected_args)))
+        if 'quote_char' in kwargs:
+            self.use_best_quote_char = False
+        for attr in self.options:
+            setattr(self, attr, kwargs.get(attr, getattr(self, attr)))
+        self.errors = []
+        self.strict = False
+
+    def encode(self, string):
+        assert(isinstance(string, text_type))
+        if self.encoding:
+            return string.encode(self.encoding, "htmlentityreplace")
+        else:
+            return string
+
+    def encodeStrict(self, string):
+        assert(isinstance(string, text_type))
+        if self.encoding:
+            return string.encode(self.encoding, "strict")
+        else:
+            return string
+
+    def serialize(self, treewalker, encoding=None):
+        # pylint:disable=too-many-nested-blocks
+        self.encoding = encoding
+        in_cdata = False
+        self.errors = []
+
+        if encoding and self.inject_meta_charset:
+            from .filters.inject_meta_charset import Filter
+            treewalker = Filter(treewalker, encoding)
+        # Alphabetical attributes is here under the assumption that none of
+        # the later filters add or change order of attributes; it needs to be
+        # before the sanitizer so escaped elements come out correctly
+        if self.alphabetical_attributes:
+            from .filters.alphabeticalattributes import Filter
+            treewalker = Filter(treewalker)
+        # WhitespaceFilter should be used before OptionalTagFilter
+        # for maximum efficiently of this latter filter
+        if self.strip_whitespace:
+            from .filters.whitespace import Filter
+            treewalker = Filter(treewalker)
+        if self.sanitize:
+            from .filters.sanitizer import Filter
+            treewalker = Filter(treewalker)
+        if self.omit_optional_tags:
+            from .filters.optionaltags import Filter
+            treewalker = Filter(treewalker)
+
+        for token in treewalker:
+            type = token["type"]
+            if type == "Doctype":
+                doctype = "<!DOCTYPE %s" % token["name"]
+
+                if token["publicId"]:
+                    doctype += ' PUBLIC "%s"' % token["publicId"]
+                elif token["systemId"]:
+                    doctype += " SYSTEM"
+                if token["systemId"]:
+                    if token["systemId"].find('"') >= 0:
+                        if token["systemId"].find("'") >= 0:
+                            self.serializeError("System identifer contains both single and double quote characters")
+                        quote_char = "'"
+                    else:
+                        quote_char = '"'
+                    doctype += " %s%s%s" % (quote_char, token["systemId"], quote_char)
+
+                doctype += ">"
+                yield self.encodeStrict(doctype)
+
+            elif type in ("Characters", "SpaceCharacters"):
+                if type == "SpaceCharacters" or in_cdata:
+                    if in_cdata and token["data"].find("</") >= 0:
+                        self.serializeError("Unexpected </ in CDATA")
+                    yield self.encode(token["data"])
+                else:
+                    yield self.encode(escape(token["data"]))
+
+            elif type in ("StartTag", "EmptyTag"):
+                name = token["name"]
+                yield self.encodeStrict("<%s" % name)
+                if name in rcdataElements and not self.escape_rcdata:
+                    in_cdata = True
+                elif in_cdata:
+                    self.serializeError("Unexpected child element of a CDATA element")
+                for (_, attr_name), attr_value in token["data"].items():
+                    # TODO: Add namespace support here
+                    k = attr_name
+                    v = attr_value
+                    yield self.encodeStrict(' ')
+
+                    yield self.encodeStrict(k)
+                    if not self.minimize_boolean_attributes or \
+                        (k not in booleanAttributes.get(name, tuple()) and
+                         k not in booleanAttributes.get("", tuple())):
+                        yield self.encodeStrict("=")
+                        if self.quote_attr_values == "always" or len(v) == 0:
+                            quote_attr = True
+                        elif self.quote_attr_values == "spec":
+                            quote_attr = _quoteAttributeSpec.search(v) is not None
+                        elif self.quote_attr_values == "legacy":
+                            quote_attr = _quoteAttributeLegacy.search(v) is not None
+                        else:
+                            raise ValueError("quote_attr_values must be one of: "
+                                             "'always', 'spec', or 'legacy'")
+                        v = v.replace("&", "&amp;")
+                        if self.escape_lt_in_attrs:
+                            v = v.replace("<", "&lt;")
+                        if quote_attr:
+                            quote_char = self.quote_char
+                            if self.use_best_quote_char:
+                                if "'" in v and '"' not in v:
+                                    quote_char = '"'
+                                elif '"' in v and "'" not in v:
+                                    quote_char = "'"
+                            if quote_char == "'":
+                                v = v.replace("'", "&#39;")
+                            else:
+                                v = v.replace('"', "&quot;")
+                            yield self.encodeStrict(quote_char)
+                            yield self.encode(v)
+                            yield self.encodeStrict(quote_char)
+                        else:
+                            yield self.encode(v)
+                if name in voidElements and self.use_trailing_solidus:
+                    if self.space_before_trailing_solidus:
+                        yield self.encodeStrict(" /")
+                    else:
+                        yield self.encodeStrict("/")
+                yield self.encode(">")
+
+            elif type == "EndTag":
+                name = token["name"]
+                if name in rcdataElements:
+                    in_cdata = False
+                elif in_cdata:
+                    self.serializeError("Unexpected child element of a CDATA element")
+                yield self.encodeStrict("</%s>" % name)
+
+            elif type == "Comment":
+                data = token["data"]
+                if data.find("--") >= 0:
+                    self.serializeError("Comment contains --")
+                yield self.encodeStrict("<!--%s-->" % token["data"])
+
+            elif type == "Entity":
+                name = token["name"]
+                key = name + ";"
+                if key not in entities:
+                    self.serializeError("Entity %s not recognized" % name)
+                if self.resolve_entities and key not in xmlEntities:
+                    data = entities[key]
+                else:
+                    data = "&%s;" % name
+                yield self.encodeStrict(data)
+
+            else:
+                self.serializeError(token["data"])
+
+    def render(self, treewalker, encoding=None):
+        """Serializes the stream from the treewalker into a string
+
+        :arg treewalker: the treewalker to serialize
+
+        :arg encoding: the string encoding to use
+
+        :returns: the serialized tree
+
+        Example:
+
+        >>> from html5lib import parse, getTreeWalker
+        >>> from html5lib.serializer import HTMLSerializer
+        >>> token_stream = parse('<html><body>Hi!</body></html>')
+        >>> walker = getTreeWalker('etree')
+        >>> serializer = HTMLSerializer(omit_optional_tags=False)
+        >>> serializer.render(walker(token_stream))
+        '<html><head></head><body>Hi!</body></html>'
+
+        """
+        if encoding:
+            return b"".join(list(self.serialize(treewalker, encoding)))
+        else:
+            return "".join(list(self.serialize(treewalker)))
+
+    def serializeError(self, data="XXX ERROR MESSAGE NEEDED"):
+        # XXX The idea is to make data mandatory.
+        self.errors.append(data)
+        if self.strict:
+            raise SerializeError
+
+
+class SerializeError(Exception):
+    """Error in serialized tree"""
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dfeb0ba5e1c367c3723049b955bc9cdec23d0378
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/__init__.py
@@ -0,0 +1,30 @@
+"""Tree adapters let you convert from one tree structure to another
+
+Example:
+
+.. code-block:: python
+
+   import html5lib
+   from html5lib.treeadapters import genshi
+
+   doc = '<html><body>Hi!</body></html>'
+   treebuilder = html5lib.getTreeBuilder('etree')
+   parser = html5lib.HTMLParser(tree=treebuilder)
+   tree = parser.parse(doc)
+   TreeWalker = html5lib.getTreeWalker('etree')
+
+   genshi_tree = genshi.to_genshi(TreeWalker(tree))
+
+"""
+from __future__ import absolute_import, division, unicode_literals
+
+from . import sax
+
+__all__ = ["sax"]
+
+try:
+    from . import genshi  # noqa
+except ImportError:
+    pass
+else:
+    __all__.append("genshi")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/genshi.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/genshi.py
new file mode 100644
index 0000000000000000000000000000000000000000..61d5fb6ac42ca4152f056d996af0cb0b0d2ddc35
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/genshi.py
@@ -0,0 +1,54 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from genshi.core import QName, Attrs
+from genshi.core import START, END, TEXT, COMMENT, DOCTYPE
+
+
+def to_genshi(walker):
+    """Convert a tree to a genshi tree
+
+    :arg walker: the treewalker to use to walk the tree to convert it
+
+    :returns: generator of genshi nodes
+
+    """
+    text = []
+    for token in walker:
+        type = token["type"]
+        if type in ("Characters", "SpaceCharacters"):
+            text.append(token["data"])
+        elif text:
+            yield TEXT, "".join(text), (None, -1, -1)
+            text = []
+
+        if type in ("StartTag", "EmptyTag"):
+            if token["namespace"]:
+                name = "{%s}%s" % (token["namespace"], token["name"])
+            else:
+                name = token["name"]
+            attrs = Attrs([(QName("{%s}%s" % attr if attr[0] is not None else attr[1]), value)
+                           for attr, value in token["data"].items()])
+            yield (START, (QName(name), attrs), (None, -1, -1))
+            if type == "EmptyTag":
+                type = "EndTag"
+
+        if type == "EndTag":
+            if token["namespace"]:
+                name = "{%s}%s" % (token["namespace"], token["name"])
+            else:
+                name = token["name"]
+
+            yield END, QName(name), (None, -1, -1)
+
+        elif type == "Comment":
+            yield COMMENT, token["data"], (None, -1, -1)
+
+        elif type == "Doctype":
+            yield DOCTYPE, (token["name"], token["publicId"],
+                            token["systemId"]), (None, -1, -1)
+
+        else:
+            pass  # FIXME: What to do?
+
+    if text:
+        yield TEXT, "".join(text), (None, -1, -1)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/sax.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/sax.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4ccea5a25653dd9e4c1bcf1047f407184562a1b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treeadapters/sax.py
@@ -0,0 +1,50 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from xml.sax.xmlreader import AttributesNSImpl
+
+from ..constants import adjustForeignAttributes, unadjustForeignAttributes
+
+prefix_mapping = {}
+for prefix, localName, namespace in adjustForeignAttributes.values():
+    if prefix is not None:
+        prefix_mapping[prefix] = namespace
+
+
+def to_sax(walker, handler):
+    """Call SAX-like content handler based on treewalker walker
+
+    :arg walker: the treewalker to use to walk the tree to convert it
+
+    :arg handler: SAX handler to use
+
+    """
+    handler.startDocument()
+    for prefix, namespace in prefix_mapping.items():
+        handler.startPrefixMapping(prefix, namespace)
+
+    for token in walker:
+        type = token["type"]
+        if type == "Doctype":
+            continue
+        elif type in ("StartTag", "EmptyTag"):
+            attrs = AttributesNSImpl(token["data"],
+                                     unadjustForeignAttributes)
+            handler.startElementNS((token["namespace"], token["name"]),
+                                   token["name"],
+                                   attrs)
+            if type == "EmptyTag":
+                handler.endElementNS((token["namespace"], token["name"]),
+                                     token["name"])
+        elif type == "EndTag":
+            handler.endElementNS((token["namespace"], token["name"]),
+                                 token["name"])
+        elif type in ("Characters", "SpaceCharacters"):
+            handler.characters(token["data"])
+        elif type == "Comment":
+            pass
+        else:
+            assert False, "Unknown token type"
+
+    for prefix, namespace in prefix_mapping.items():
+        handler.endPrefixMapping(prefix)
+    handler.endDocument()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d44447eaf5a3912ea699e6d895d51f9b0782cfba
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/__init__.py
@@ -0,0 +1,88 @@
+"""A collection of modules for building different kinds of trees from HTML
+documents.
+
+To create a treebuilder for a new type of tree, you need to do
+implement several things:
+
+1. A set of classes for various types of elements: Document, Doctype, Comment,
+   Element. These must implement the interface of ``base.treebuilders.Node``
+   (although comment nodes have a different signature for their constructor,
+   see ``treebuilders.etree.Comment``) Textual content may also be implemented
+   as another node type, or not, as your tree implementation requires.
+
+2. A treebuilder object (called ``TreeBuilder`` by convention) that inherits
+   from ``treebuilders.base.TreeBuilder``. This has 4 required attributes:
+
+   * ``documentClass`` - the class to use for the bottommost node of a document
+   * ``elementClass`` - the class to use for HTML Elements
+   * ``commentClass`` - the class to use for comments
+   * ``doctypeClass`` - the class to use for doctypes
+
+   It also has one required method:
+
+   * ``getDocument`` - Returns the root node of the complete document tree
+
+3. If you wish to run the unit tests, you must also create a ``testSerializer``
+   method on your treebuilder which accepts a node and returns a string
+   containing Node and its children serialized according to the format used in
+   the unittests
+
+"""
+
+from __future__ import absolute_import, division, unicode_literals
+
+from .._utils import default_etree
+
+treeBuilderCache = {}
+
+
+def getTreeBuilder(treeType, implementation=None, **kwargs):
+    """Get a TreeBuilder class for various types of trees with built-in support
+
+    :arg treeType: the name of the tree type required (case-insensitive). Supported
+        values are:
+
+        * "dom" - A generic builder for DOM implementations, defaulting to a
+          xml.dom.minidom based implementation.
+        * "etree" - A generic builder for tree implementations exposing an
+          ElementTree-like interface, defaulting to xml.etree.cElementTree if
+          available and xml.etree.ElementTree if not.
+        * "lxml" - A etree-based builder for lxml.etree, handling limitations
+          of lxml's implementation.
+
+    :arg implementation: (Currently applies to the "etree" and "dom" tree
+        types). A module implementing the tree type e.g. xml.etree.ElementTree
+        or xml.etree.cElementTree.
+
+    :arg kwargs: Any additional options to pass to the TreeBuilder when
+        creating it.
+
+    Example:
+
+    >>> from html5lib.treebuilders import getTreeBuilder
+    >>> builder = getTreeBuilder('etree')
+
+    """
+
+    treeType = treeType.lower()
+    if treeType not in treeBuilderCache:
+        if treeType == "dom":
+            from . import dom
+            # Come up with a sane default (pref. from the stdlib)
+            if implementation is None:
+                from xml.dom import minidom
+                implementation = minidom
+            # NEVER cache here, caching is done in the dom submodule
+            return dom.getDomModule(implementation, **kwargs).TreeBuilder
+        elif treeType == "lxml":
+            from . import etree_lxml
+            treeBuilderCache[treeType] = etree_lxml.TreeBuilder
+        elif treeType == "etree":
+            from . import etree
+            if implementation is None:
+                implementation = default_etree
+            # NEVER cache here, caching is done in the etree submodule
+            return etree.getETreeModule(implementation, **kwargs).TreeBuilder
+        else:
+            raise ValueError("""Unrecognised treebuilder "%s" """ % treeType)
+    return treeBuilderCache.get(treeType)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..05d97eccc898dd6445de75a192e4664d7e0bb300
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/base.py
@@ -0,0 +1,417 @@
+from __future__ import absolute_import, division, unicode_literals
+from six import text_type
+
+from ..constants import scopingElements, tableInsertModeElements, namespaces
+
+# The scope markers are inserted when entering object elements,
+# marquees, table cells, and table captions, and are used to prevent formatting
+# from "leaking" into tables, object elements, and marquees.
+Marker = None
+
+listElementsMap = {
+    None: (frozenset(scopingElements), False),
+    "button": (frozenset(scopingElements | set([(namespaces["html"], "button")])), False),
+    "list": (frozenset(scopingElements | set([(namespaces["html"], "ol"),
+                                              (namespaces["html"], "ul")])), False),
+    "table": (frozenset([(namespaces["html"], "html"),
+                         (namespaces["html"], "table")]), False),
+    "select": (frozenset([(namespaces["html"], "optgroup"),
+                          (namespaces["html"], "option")]), True)
+}
+
+
+class Node(object):
+    """Represents an item in the tree"""
+    def __init__(self, name):
+        """Creates a Node
+
+        :arg name: The tag name associated with the node
+
+        """
+        # The tag name assocaited with the node
+        self.name = name
+        # The parent of the current node (or None for the document node)
+        self.parent = None
+        # The value of the current node (applies to text nodes and comments)
+        self.value = None
+        # A dict holding name -> value pairs for attributes of the node
+        self.attributes = {}
+        # A list of child nodes of the current node. This must include all
+        # elements but not necessarily other node types.
+        self.childNodes = []
+        # A list of miscellaneous flags that can be set on the node.
+        self._flags = []
+
+    def __str__(self):
+        attributesStr = " ".join(["%s=\"%s\"" % (name, value)
+                                  for name, value in
+                                  self.attributes.items()])
+        if attributesStr:
+            return "<%s %s>" % (self.name, attributesStr)
+        else:
+            return "<%s>" % (self.name)
+
+    def __repr__(self):
+        return "<%s>" % (self.name)
+
+    def appendChild(self, node):
+        """Insert node as a child of the current node
+
+        :arg node: the node to insert
+
+        """
+        raise NotImplementedError
+
+    def insertText(self, data, insertBefore=None):
+        """Insert data as text in the current node, positioned before the
+        start of node insertBefore or to the end of the node's text.
+
+        :arg data: the data to insert
+
+        :arg insertBefore: True if you want to insert the text before the node
+            and False if you want to insert it after the node
+
+        """
+        raise NotImplementedError
+
+    def insertBefore(self, node, refNode):
+        """Insert node as a child of the current node, before refNode in the
+        list of child nodes. Raises ValueError if refNode is not a child of
+        the current node
+
+        :arg node: the node to insert
+
+        :arg refNode: the child node to insert the node before
+
+        """
+        raise NotImplementedError
+
+    def removeChild(self, node):
+        """Remove node from the children of the current node
+
+        :arg node: the child node to remove
+
+        """
+        raise NotImplementedError
+
+    def reparentChildren(self, newParent):
+        """Move all the children of the current node to newParent.
+        This is needed so that trees that don't store text as nodes move the
+        text in the correct way
+
+        :arg newParent: the node to move all this node's children to
+
+        """
+        # XXX - should this method be made more general?
+        for child in self.childNodes:
+            newParent.appendChild(child)
+        self.childNodes = []
+
+    def cloneNode(self):
+        """Return a shallow copy of the current node i.e. a node with the same
+        name and attributes but with no parent or child nodes
+        """
+        raise NotImplementedError
+
+    def hasContent(self):
+        """Return true if the node has children or text, false otherwise
+        """
+        raise NotImplementedError
+
+
+class ActiveFormattingElements(list):
+    def append(self, node):
+        equalCount = 0
+        if node != Marker:
+            for element in self[::-1]:
+                if element == Marker:
+                    break
+                if self.nodesEqual(element, node):
+                    equalCount += 1
+                if equalCount == 3:
+                    self.remove(element)
+                    break
+        list.append(self, node)
+
+    def nodesEqual(self, node1, node2):
+        if not node1.nameTuple == node2.nameTuple:
+            return False
+
+        if not node1.attributes == node2.attributes:
+            return False
+
+        return True
+
+
+class TreeBuilder(object):
+    """Base treebuilder implementation
+
+    * documentClass - the class to use for the bottommost node of a document
+    * elementClass - the class to use for HTML Elements
+    * commentClass - the class to use for comments
+    * doctypeClass - the class to use for doctypes
+
+    """
+    # pylint:disable=not-callable
+
+    # Document class
+    documentClass = None
+
+    # The class to use for creating a node
+    elementClass = None
+
+    # The class to use for creating comments
+    commentClass = None
+
+    # The class to use for creating doctypes
+    doctypeClass = None
+
+    # Fragment class
+    fragmentClass = None
+
+    def __init__(self, namespaceHTMLElements):
+        """Create a TreeBuilder
+
+        :arg namespaceHTMLElements: whether or not to namespace HTML elements
+
+        """
+        if namespaceHTMLElements:
+            self.defaultNamespace = "http://www.w3.org/1999/xhtml"
+        else:
+            self.defaultNamespace = None
+        self.reset()
+
+    def reset(self):
+        self.openElements = []
+        self.activeFormattingElements = ActiveFormattingElements()
+
+        # XXX - rename these to headElement, formElement
+        self.headPointer = None
+        self.formPointer = None
+
+        self.insertFromTable = False
+
+        self.document = self.documentClass()
+
+    def elementInScope(self, target, variant=None):
+
+        # If we pass a node in we match that. if we pass a string
+        # match any node with that name
+        exactNode = hasattr(target, "nameTuple")
+        if not exactNode:
+            if isinstance(target, text_type):
+                target = (namespaces["html"], target)
+            assert isinstance(target, tuple)
+
+        listElements, invert = listElementsMap[variant]
+
+        for node in reversed(self.openElements):
+            if exactNode and node == target:
+                return True
+            elif not exactNode and node.nameTuple == target:
+                return True
+            elif (invert ^ (node.nameTuple in listElements)):
+                return False
+
+        assert False  # We should never reach this point
+
+    def reconstructActiveFormattingElements(self):
+        # Within this algorithm the order of steps described in the
+        # specification is not quite the same as the order of steps in the
+        # code. It should still do the same though.
+
+        # Step 1: stop the algorithm when there's nothing to do.
+        if not self.activeFormattingElements:
+            return
+
+        # Step 2 and step 3: we start with the last element. So i is -1.
+        i = len(self.activeFormattingElements) - 1
+        entry = self.activeFormattingElements[i]
+        if entry == Marker or entry in self.openElements:
+            return
+
+        # Step 6
+        while entry != Marker and entry not in self.openElements:
+            if i == 0:
+                # This will be reset to 0 below
+                i = -1
+                break
+            i -= 1
+            # Step 5: let entry be one earlier in the list.
+            entry = self.activeFormattingElements[i]
+
+        while True:
+            # Step 7
+            i += 1
+
+            # Step 8
+            entry = self.activeFormattingElements[i]
+            clone = entry.cloneNode()  # Mainly to get a new copy of the attributes
+
+            # Step 9
+            element = self.insertElement({"type": "StartTag",
+                                          "name": clone.name,
+                                          "namespace": clone.namespace,
+                                          "data": clone.attributes})
+
+            # Step 10
+            self.activeFormattingElements[i] = element
+
+            # Step 11
+            if element == self.activeFormattingElements[-1]:
+                break
+
+    def clearActiveFormattingElements(self):
+        entry = self.activeFormattingElements.pop()
+        while self.activeFormattingElements and entry != Marker:
+            entry = self.activeFormattingElements.pop()
+
+    def elementInActiveFormattingElements(self, name):
+        """Check if an element exists between the end of the active
+        formatting elements and the last marker. If it does, return it, else
+        return false"""
+
+        for item in self.activeFormattingElements[::-1]:
+            # Check for Marker first because if it's a Marker it doesn't have a
+            # name attribute.
+            if item == Marker:
+                break
+            elif item.name == name:
+                return item
+        return False
+
+    def insertRoot(self, token):
+        element = self.createElement(token)
+        self.openElements.append(element)
+        self.document.appendChild(element)
+
+    def insertDoctype(self, token):
+        name = token["name"]
+        publicId = token["publicId"]
+        systemId = token["systemId"]
+
+        doctype = self.doctypeClass(name, publicId, systemId)
+        self.document.appendChild(doctype)
+
+    def insertComment(self, token, parent=None):
+        if parent is None:
+            parent = self.openElements[-1]
+        parent.appendChild(self.commentClass(token["data"]))
+
+    def createElement(self, token):
+        """Create an element but don't insert it anywhere"""
+        name = token["name"]
+        namespace = token.get("namespace", self.defaultNamespace)
+        element = self.elementClass(name, namespace)
+        element.attributes = token["data"]
+        return element
+
+    def _getInsertFromTable(self):
+        return self._insertFromTable
+
+    def _setInsertFromTable(self, value):
+        """Switch the function used to insert an element from the
+        normal one to the misnested table one and back again"""
+        self._insertFromTable = value
+        if value:
+            self.insertElement = self.insertElementTable
+        else:
+            self.insertElement = self.insertElementNormal
+
+    insertFromTable = property(_getInsertFromTable, _setInsertFromTable)
+
+    def insertElementNormal(self, token):
+        name = token["name"]
+        assert isinstance(name, text_type), "Element %s not unicode" % name
+        namespace = token.get("namespace", self.defaultNamespace)
+        element = self.elementClass(name, namespace)
+        element.attributes = token["data"]
+        self.openElements[-1].appendChild(element)
+        self.openElements.append(element)
+        return element
+
+    def insertElementTable(self, token):
+        """Create an element and insert it into the tree"""
+        element = self.createElement(token)
+        if self.openElements[-1].name not in tableInsertModeElements:
+            return self.insertElementNormal(token)
+        else:
+            # We should be in the InTable mode. This means we want to do
+            # special magic element rearranging
+            parent, insertBefore = self.getTableMisnestedNodePosition()
+            if insertBefore is None:
+                parent.appendChild(element)
+            else:
+                parent.insertBefore(element, insertBefore)
+            self.openElements.append(element)
+        return element
+
+    def insertText(self, data, parent=None):
+        """Insert text data."""
+        if parent is None:
+            parent = self.openElements[-1]
+
+        if (not self.insertFromTable or (self.insertFromTable and
+                                         self.openElements[-1].name
+                                         not in tableInsertModeElements)):
+            parent.insertText(data)
+        else:
+            # We should be in the InTable mode. This means we want to do
+            # special magic element rearranging
+            parent, insertBefore = self.getTableMisnestedNodePosition()
+            parent.insertText(data, insertBefore)
+
+    def getTableMisnestedNodePosition(self):
+        """Get the foster parent element, and sibling to insert before
+        (or None) when inserting a misnested table node"""
+        # The foster parent element is the one which comes before the most
+        # recently opened table element
+        # XXX - this is really inelegant
+        lastTable = None
+        fosterParent = None
+        insertBefore = None
+        for elm in self.openElements[::-1]:
+            if elm.name == "table":
+                lastTable = elm
+                break
+        if lastTable:
+            # XXX - we should really check that this parent is actually a
+            # node here
+            if lastTable.parent:
+                fosterParent = lastTable.parent
+                insertBefore = lastTable
+            else:
+                fosterParent = self.openElements[
+                    self.openElements.index(lastTable) - 1]
+        else:
+            fosterParent = self.openElements[0]
+        return fosterParent, insertBefore
+
+    def generateImpliedEndTags(self, exclude=None):
+        name = self.openElements[-1].name
+        # XXX td, th and tr are not actually needed
+        if (name in frozenset(("dd", "dt", "li", "option", "optgroup", "p", "rp", "rt")) and
+                name != exclude):
+            self.openElements.pop()
+            # XXX This is not entirely what the specification says. We should
+            # investigate it more closely.
+            self.generateImpliedEndTags(exclude)
+
+    def getDocument(self):
+        """Return the final tree"""
+        return self.document
+
+    def getFragment(self):
+        """Return the final fragment"""
+        # assert self.innerHTML
+        fragment = self.fragmentClass()
+        self.openElements[0].reparentChildren(fragment)
+        return fragment
+
+    def testSerializer(self, node):
+        """Serialize the subtree of node in the format required by unit tests
+
+        :arg node: the node from which to start serializing
+
+        """
+        raise NotImplementedError
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/dom.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/dom.py
new file mode 100644
index 0000000000000000000000000000000000000000..dcfac220bfaf9906b1f57ee747baff2a627cfa58
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/dom.py
@@ -0,0 +1,236 @@
+from __future__ import absolute_import, division, unicode_literals
+
+
+from collections import MutableMapping
+from xml.dom import minidom, Node
+import weakref
+
+from . import base
+from .. import constants
+from ..constants import namespaces
+from .._utils import moduleFactoryFactory
+
+
+def getDomBuilder(DomImplementation):
+    Dom = DomImplementation
+
+    class AttrList(MutableMapping):
+        def __init__(self, element):
+            self.element = element
+
+        def __iter__(self):
+            return iter(self.element.attributes.keys())
+
+        def __setitem__(self, name, value):
+            if isinstance(name, tuple):
+                raise NotImplementedError
+            else:
+                attr = self.element.ownerDocument.createAttribute(name)
+                attr.value = value
+                self.element.attributes[name] = attr
+
+        def __len__(self):
+            return len(self.element.attributes)
+
+        def items(self):
+            return list(self.element.attributes.items())
+
+        def values(self):
+            return list(self.element.attributes.values())
+
+        def __getitem__(self, name):
+            if isinstance(name, tuple):
+                raise NotImplementedError
+            else:
+                return self.element.attributes[name].value
+
+        def __delitem__(self, name):
+            if isinstance(name, tuple):
+                raise NotImplementedError
+            else:
+                del self.element.attributes[name]
+
+    class NodeBuilder(base.Node):
+        def __init__(self, element):
+            base.Node.__init__(self, element.nodeName)
+            self.element = element
+
+        namespace = property(lambda self: hasattr(self.element, "namespaceURI") and
+                             self.element.namespaceURI or None)
+
+        def appendChild(self, node):
+            node.parent = self
+            self.element.appendChild(node.element)
+
+        def insertText(self, data, insertBefore=None):
+            text = self.element.ownerDocument.createTextNode(data)
+            if insertBefore:
+                self.element.insertBefore(text, insertBefore.element)
+            else:
+                self.element.appendChild(text)
+
+        def insertBefore(self, node, refNode):
+            self.element.insertBefore(node.element, refNode.element)
+            node.parent = self
+
+        def removeChild(self, node):
+            if node.element.parentNode == self.element:
+                self.element.removeChild(node.element)
+            node.parent = None
+
+        def reparentChildren(self, newParent):
+            while self.element.hasChildNodes():
+                child = self.element.firstChild
+                self.element.removeChild(child)
+                newParent.element.appendChild(child)
+            self.childNodes = []
+
+        def getAttributes(self):
+            return AttrList(self.element)
+
+        def setAttributes(self, attributes):
+            if attributes:
+                for name, value in list(attributes.items()):
+                    if isinstance(name, tuple):
+                        if name[0] is not None:
+                            qualifiedName = (name[0] + ":" + name[1])
+                        else:
+                            qualifiedName = name[1]
+                        self.element.setAttributeNS(name[2], qualifiedName,
+                                                    value)
+                    else:
+                        self.element.setAttribute(
+                            name, value)
+        attributes = property(getAttributes, setAttributes)
+
+        def cloneNode(self):
+            return NodeBuilder(self.element.cloneNode(False))
+
+        def hasContent(self):
+            return self.element.hasChildNodes()
+
+        def getNameTuple(self):
+            if self.namespace is None:
+                return namespaces["html"], self.name
+            else:
+                return self.namespace, self.name
+
+        nameTuple = property(getNameTuple)
+
+    class TreeBuilder(base.TreeBuilder):  # pylint:disable=unused-variable
+        def documentClass(self):
+            self.dom = Dom.getDOMImplementation().createDocument(None, None, None)
+            return weakref.proxy(self)
+
+        def insertDoctype(self, token):
+            name = token["name"]
+            publicId = token["publicId"]
+            systemId = token["systemId"]
+
+            domimpl = Dom.getDOMImplementation()
+            doctype = domimpl.createDocumentType(name, publicId, systemId)
+            self.document.appendChild(NodeBuilder(doctype))
+            if Dom == minidom:
+                doctype.ownerDocument = self.dom
+
+        def elementClass(self, name, namespace=None):
+            if namespace is None and self.defaultNamespace is None:
+                node = self.dom.createElement(name)
+            else:
+                node = self.dom.createElementNS(namespace, name)
+
+            return NodeBuilder(node)
+
+        def commentClass(self, data):
+            return NodeBuilder(self.dom.createComment(data))
+
+        def fragmentClass(self):
+            return NodeBuilder(self.dom.createDocumentFragment())
+
+        def appendChild(self, node):
+            self.dom.appendChild(node.element)
+
+        def testSerializer(self, element):
+            return testSerializer(element)
+
+        def getDocument(self):
+            return self.dom
+
+        def getFragment(self):
+            return base.TreeBuilder.getFragment(self).element
+
+        def insertText(self, data, parent=None):
+            data = data
+            if parent != self:
+                base.TreeBuilder.insertText(self, data, parent)
+            else:
+                # HACK: allow text nodes as children of the document node
+                if hasattr(self.dom, '_child_node_types'):
+                    # pylint:disable=protected-access
+                    if Node.TEXT_NODE not in self.dom._child_node_types:
+                        self.dom._child_node_types = list(self.dom._child_node_types)
+                        self.dom._child_node_types.append(Node.TEXT_NODE)
+                self.dom.appendChild(self.dom.createTextNode(data))
+
+        implementation = DomImplementation
+        name = None
+
+    def testSerializer(element):
+        element.normalize()
+        rv = []
+
+        def serializeElement(element, indent=0):
+            if element.nodeType == Node.DOCUMENT_TYPE_NODE:
+                if element.name:
+                    if element.publicId or element.systemId:
+                        publicId = element.publicId or ""
+                        systemId = element.systemId or ""
+                        rv.append("""|%s<!DOCTYPE %s "%s" "%s">""" %
+                                  (' ' * indent, element.name, publicId, systemId))
+                    else:
+                        rv.append("|%s<!DOCTYPE %s>" % (' ' * indent, element.name))
+                else:
+                    rv.append("|%s<!DOCTYPE >" % (' ' * indent,))
+            elif element.nodeType == Node.DOCUMENT_NODE:
+                rv.append("#document")
+            elif element.nodeType == Node.DOCUMENT_FRAGMENT_NODE:
+                rv.append("#document-fragment")
+            elif element.nodeType == Node.COMMENT_NODE:
+                rv.append("|%s<!-- %s -->" % (' ' * indent, element.nodeValue))
+            elif element.nodeType == Node.TEXT_NODE:
+                rv.append("|%s\"%s\"" % (' ' * indent, element.nodeValue))
+            else:
+                if (hasattr(element, "namespaceURI") and
+                        element.namespaceURI is not None):
+                    name = "%s %s" % (constants.prefixes[element.namespaceURI],
+                                      element.nodeName)
+                else:
+                    name = element.nodeName
+                rv.append("|%s<%s>" % (' ' * indent, name))
+                if element.hasAttributes():
+                    attributes = []
+                    for i in range(len(element.attributes)):
+                        attr = element.attributes.item(i)
+                        name = attr.nodeName
+                        value = attr.value
+                        ns = attr.namespaceURI
+                        if ns:
+                            name = "%s %s" % (constants.prefixes[ns], attr.localName)
+                        else:
+                            name = attr.nodeName
+                        attributes.append((name, value))
+
+                    for name, value in sorted(attributes):
+                        rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))
+            indent += 2
+            for child in element.childNodes:
+                serializeElement(child, indent)
+        serializeElement(element, 0)
+
+        return "\n".join(rv)
+
+    return locals()
+
+
+# The actual means to get a module!
+getDomModule = moduleFactoryFactory(getDomBuilder)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb1d4aef503692d57516bb8f5426a872fe89287d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree.py
@@ -0,0 +1,340 @@
+from __future__ import absolute_import, division, unicode_literals
+# pylint:disable=protected-access
+
+from six import text_type
+
+import re
+
+from . import base
+from .. import _ihatexml
+from .. import constants
+from ..constants import namespaces
+from .._utils import moduleFactoryFactory
+
+tag_regexp = re.compile("{([^}]*)}(.*)")
+
+
+def getETreeBuilder(ElementTreeImplementation, fullTree=False):
+    ElementTree = ElementTreeImplementation
+    ElementTreeCommentType = ElementTree.Comment("asd").tag
+
+    class Element(base.Node):
+        def __init__(self, name, namespace=None):
+            self._name = name
+            self._namespace = namespace
+            self._element = ElementTree.Element(self._getETreeTag(name,
+                                                                  namespace))
+            if namespace is None:
+                self.nameTuple = namespaces["html"], self._name
+            else:
+                self.nameTuple = self._namespace, self._name
+            self.parent = None
+            self._childNodes = []
+            self._flags = []
+
+        def _getETreeTag(self, name, namespace):
+            if namespace is None:
+                etree_tag = name
+            else:
+                etree_tag = "{%s}%s" % (namespace, name)
+            return etree_tag
+
+        def _setName(self, name):
+            self._name = name
+            self._element.tag = self._getETreeTag(self._name, self._namespace)
+
+        def _getName(self):
+            return self._name
+
+        name = property(_getName, _setName)
+
+        def _setNamespace(self, namespace):
+            self._namespace = namespace
+            self._element.tag = self._getETreeTag(self._name, self._namespace)
+
+        def _getNamespace(self):
+            return self._namespace
+
+        namespace = property(_getNamespace, _setNamespace)
+
+        def _getAttributes(self):
+            return self._element.attrib
+
+        def _setAttributes(self, attributes):
+            # Delete existing attributes first
+            # XXX - there may be a better way to do this...
+            for key in list(self._element.attrib.keys()):
+                del self._element.attrib[key]
+            for key, value in attributes.items():
+                if isinstance(key, tuple):
+                    name = "{%s}%s" % (key[2], key[1])
+                else:
+                    name = key
+                self._element.set(name, value)
+
+        attributes = property(_getAttributes, _setAttributes)
+
+        def _getChildNodes(self):
+            return self._childNodes
+
+        def _setChildNodes(self, value):
+            del self._element[:]
+            self._childNodes = []
+            for element in value:
+                self.insertChild(element)
+
+        childNodes = property(_getChildNodes, _setChildNodes)
+
+        def hasContent(self):
+            """Return true if the node has children or text"""
+            return bool(self._element.text or len(self._element))
+
+        def appendChild(self, node):
+            self._childNodes.append(node)
+            self._element.append(node._element)
+            node.parent = self
+
+        def insertBefore(self, node, refNode):
+            index = list(self._element).index(refNode._element)
+            self._element.insert(index, node._element)
+            node.parent = self
+
+        def removeChild(self, node):
+            self._childNodes.remove(node)
+            self._element.remove(node._element)
+            node.parent = None
+
+        def insertText(self, data, insertBefore=None):
+            if not(len(self._element)):
+                if not self._element.text:
+                    self._element.text = ""
+                self._element.text += data
+            elif insertBefore is None:
+                # Insert the text as the tail of the last child element
+                if not self._element[-1].tail:
+                    self._element[-1].tail = ""
+                self._element[-1].tail += data
+            else:
+                # Insert the text before the specified node
+                children = list(self._element)
+                index = children.index(insertBefore._element)
+                if index > 0:
+                    if not self._element[index - 1].tail:
+                        self._element[index - 1].tail = ""
+                    self._element[index - 1].tail += data
+                else:
+                    if not self._element.text:
+                        self._element.text = ""
+                    self._element.text += data
+
+        def cloneNode(self):
+            element = type(self)(self.name, self.namespace)
+            for name, value in self.attributes.items():
+                element.attributes[name] = value
+            return element
+
+        def reparentChildren(self, newParent):
+            if newParent.childNodes:
+                newParent.childNodes[-1]._element.tail += self._element.text
+            else:
+                if not newParent._element.text:
+                    newParent._element.text = ""
+                if self._element.text is not None:
+                    newParent._element.text += self._element.text
+            self._element.text = ""
+            base.Node.reparentChildren(self, newParent)
+
+    class Comment(Element):
+        def __init__(self, data):
+            # Use the superclass constructor to set all properties on the
+            # wrapper element
+            self._element = ElementTree.Comment(data)
+            self.parent = None
+            self._childNodes = []
+            self._flags = []
+
+        def _getData(self):
+            return self._element.text
+
+        def _setData(self, value):
+            self._element.text = value
+
+        data = property(_getData, _setData)
+
+    class DocumentType(Element):
+        def __init__(self, name, publicId, systemId):
+            Element.__init__(self, "<!DOCTYPE>")
+            self._element.text = name
+            self.publicId = publicId
+            self.systemId = systemId
+
+        def _getPublicId(self):
+            return self._element.get("publicId", "")
+
+        def _setPublicId(self, value):
+            if value is not None:
+                self._element.set("publicId", value)
+
+        publicId = property(_getPublicId, _setPublicId)
+
+        def _getSystemId(self):
+            return self._element.get("systemId", "")
+
+        def _setSystemId(self, value):
+            if value is not None:
+                self._element.set("systemId", value)
+
+        systemId = property(_getSystemId, _setSystemId)
+
+    class Document(Element):
+        def __init__(self):
+            Element.__init__(self, "DOCUMENT_ROOT")
+
+    class DocumentFragment(Element):
+        def __init__(self):
+            Element.__init__(self, "DOCUMENT_FRAGMENT")
+
+    def testSerializer(element):
+        rv = []
+
+        def serializeElement(element, indent=0):
+            if not(hasattr(element, "tag")):
+                element = element.getroot()
+            if element.tag == "<!DOCTYPE>":
+                if element.get("publicId") or element.get("systemId"):
+                    publicId = element.get("publicId") or ""
+                    systemId = element.get("systemId") or ""
+                    rv.append("""<!DOCTYPE %s "%s" "%s">""" %
+                              (element.text, publicId, systemId))
+                else:
+                    rv.append("<!DOCTYPE %s>" % (element.text,))
+            elif element.tag == "DOCUMENT_ROOT":
+                rv.append("#document")
+                if element.text is not None:
+                    rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
+                if element.tail is not None:
+                    raise TypeError("Document node cannot have tail")
+                if hasattr(element, "attrib") and len(element.attrib):
+                    raise TypeError("Document node cannot have attributes")
+            elif element.tag == ElementTreeCommentType:
+                rv.append("|%s<!-- %s -->" % (' ' * indent, element.text))
+            else:
+                assert isinstance(element.tag, text_type), \
+                    "Expected unicode, got %s, %s" % (type(element.tag), element.tag)
+                nsmatch = tag_regexp.match(element.tag)
+
+                if nsmatch is None:
+                    name = element.tag
+                else:
+                    ns, name = nsmatch.groups()
+                    prefix = constants.prefixes[ns]
+                    name = "%s %s" % (prefix, name)
+                rv.append("|%s<%s>" % (' ' * indent, name))
+
+                if hasattr(element, "attrib"):
+                    attributes = []
+                    for name, value in element.attrib.items():
+                        nsmatch = tag_regexp.match(name)
+                        if nsmatch is not None:
+                            ns, name = nsmatch.groups()
+                            prefix = constants.prefixes[ns]
+                            attr_string = "%s %s" % (prefix, name)
+                        else:
+                            attr_string = name
+                        attributes.append((attr_string, value))
+
+                    for name, value in sorted(attributes):
+                        rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))
+                if element.text:
+                    rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
+            indent += 2
+            for child in element:
+                serializeElement(child, indent)
+            if element.tail:
+                rv.append("|%s\"%s\"" % (' ' * (indent - 2), element.tail))
+        serializeElement(element, 0)
+
+        return "\n".join(rv)
+
+    def tostring(element):  # pylint:disable=unused-variable
+        """Serialize an element and its child nodes to a string"""
+        rv = []
+        filter = _ihatexml.InfosetFilter()
+
+        def serializeElement(element):
+            if isinstance(element, ElementTree.ElementTree):
+                element = element.getroot()
+
+            if element.tag == "<!DOCTYPE>":
+                if element.get("publicId") or element.get("systemId"):
+                    publicId = element.get("publicId") or ""
+                    systemId = element.get("systemId") or ""
+                    rv.append("""<!DOCTYPE %s PUBLIC "%s" "%s">""" %
+                              (element.text, publicId, systemId))
+                else:
+                    rv.append("<!DOCTYPE %s>" % (element.text,))
+            elif element.tag == "DOCUMENT_ROOT":
+                if element.text is not None:
+                    rv.append(element.text)
+                if element.tail is not None:
+                    raise TypeError("Document node cannot have tail")
+                if hasattr(element, "attrib") and len(element.attrib):
+                    raise TypeError("Document node cannot have attributes")
+
+                for child in element:
+                    serializeElement(child)
+
+            elif element.tag == ElementTreeCommentType:
+                rv.append("<!--%s-->" % (element.text,))
+            else:
+                # This is assumed to be an ordinary element
+                if not element.attrib:
+                    rv.append("<%s>" % (filter.fromXmlName(element.tag),))
+                else:
+                    attr = " ".join(["%s=\"%s\"" % (
+                        filter.fromXmlName(name), value)
+                        for name, value in element.attrib.items()])
+                    rv.append("<%s %s>" % (element.tag, attr))
+                if element.text:
+                    rv.append(element.text)
+
+                for child in element:
+                    serializeElement(child)
+
+                rv.append("</%s>" % (element.tag,))
+
+            if element.tail:
+                rv.append(element.tail)
+
+        serializeElement(element)
+
+        return "".join(rv)
+
+    class TreeBuilder(base.TreeBuilder):  # pylint:disable=unused-variable
+        documentClass = Document
+        doctypeClass = DocumentType
+        elementClass = Element
+        commentClass = Comment
+        fragmentClass = DocumentFragment
+        implementation = ElementTreeImplementation
+
+        def testSerializer(self, element):
+            return testSerializer(element)
+
+        def getDocument(self):
+            if fullTree:
+                return self.document._element
+            else:
+                if self.defaultNamespace is not None:
+                    return self.document._element.find(
+                        "{%s}html" % self.defaultNamespace)
+                else:
+                    return self.document._element.find("html")
+
+        def getFragment(self):
+            return base.TreeBuilder.getFragment(self)._element
+
+    return locals()
+
+
+getETreeModule = moduleFactoryFactory(getETreeBuilder)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree_lxml.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree_lxml.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca12a99cccf98a1be4bc463bce29c402ff634e62
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treebuilders/etree_lxml.py
@@ -0,0 +1,366 @@
+"""Module for supporting the lxml.etree library. The idea here is to use as much
+of the native library as possible, without using fragile hacks like custom element
+names that break between releases. The downside of this is that we cannot represent
+all possible trees; specifically the following are known to cause problems:
+
+Text or comments as siblings of the root element
+Docypes with no name
+
+When any of these things occur, we emit a DataLossWarning
+"""
+
+from __future__ import absolute_import, division, unicode_literals
+# pylint:disable=protected-access
+
+import warnings
+import re
+import sys
+
+from . import base
+from ..constants import DataLossWarning
+from .. import constants
+from . import etree as etree_builders
+from .. import _ihatexml
+
+import lxml.etree as etree
+
+
+fullTree = True
+tag_regexp = re.compile("{([^}]*)}(.*)")
+
+comment_type = etree.Comment("asd").tag
+
+
+class DocumentType(object):
+    def __init__(self, name, publicId, systemId):
+        self.name = name
+        self.publicId = publicId
+        self.systemId = systemId
+
+
+class Document(object):
+    def __init__(self):
+        self._elementTree = None
+        self._childNodes = []
+
+    def appendChild(self, element):
+        self._elementTree.getroot().addnext(element._element)
+
+    def _getChildNodes(self):
+        return self._childNodes
+
+    childNodes = property(_getChildNodes)
+
+
+def testSerializer(element):
+    rv = []
+    infosetFilter = _ihatexml.InfosetFilter(preventDoubleDashComments=True)
+
+    def serializeElement(element, indent=0):
+        if not hasattr(element, "tag"):
+            if hasattr(element, "getroot"):
+                # Full tree case
+                rv.append("#document")
+                if element.docinfo.internalDTD:
+                    if not (element.docinfo.public_id or
+                            element.docinfo.system_url):
+                        dtd_str = "<!DOCTYPE %s>" % element.docinfo.root_name
+                    else:
+                        dtd_str = """<!DOCTYPE %s "%s" "%s">""" % (
+                            element.docinfo.root_name,
+                            element.docinfo.public_id,
+                            element.docinfo.system_url)
+                    rv.append("|%s%s" % (' ' * (indent + 2), dtd_str))
+                next_element = element.getroot()
+                while next_element.getprevious() is not None:
+                    next_element = next_element.getprevious()
+                while next_element is not None:
+                    serializeElement(next_element, indent + 2)
+                    next_element = next_element.getnext()
+            elif isinstance(element, str) or isinstance(element, bytes):
+                # Text in a fragment
+                assert isinstance(element, str) or sys.version_info[0] == 2
+                rv.append("|%s\"%s\"" % (' ' * indent, element))
+            else:
+                # Fragment case
+                rv.append("#document-fragment")
+                for next_element in element:
+                    serializeElement(next_element, indent + 2)
+        elif element.tag == comment_type:
+            rv.append("|%s<!-- %s -->" % (' ' * indent, element.text))
+            if hasattr(element, "tail") and element.tail:
+                rv.append("|%s\"%s\"" % (' ' * indent, element.tail))
+        else:
+            assert isinstance(element, etree._Element)
+            nsmatch = etree_builders.tag_regexp.match(element.tag)
+            if nsmatch is not None:
+                ns = nsmatch.group(1)
+                tag = nsmatch.group(2)
+                prefix = constants.prefixes[ns]
+                rv.append("|%s<%s %s>" % (' ' * indent, prefix,
+                                          infosetFilter.fromXmlName(tag)))
+            else:
+                rv.append("|%s<%s>" % (' ' * indent,
+                                       infosetFilter.fromXmlName(element.tag)))
+
+            if hasattr(element, "attrib"):
+                attributes = []
+                for name, value in element.attrib.items():
+                    nsmatch = tag_regexp.match(name)
+                    if nsmatch is not None:
+                        ns, name = nsmatch.groups()
+                        name = infosetFilter.fromXmlName(name)
+                        prefix = constants.prefixes[ns]
+                        attr_string = "%s %s" % (prefix, name)
+                    else:
+                        attr_string = infosetFilter.fromXmlName(name)
+                    attributes.append((attr_string, value))
+
+                for name, value in sorted(attributes):
+                    rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))
+
+            if element.text:
+                rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
+            indent += 2
+            for child in element:
+                serializeElement(child, indent)
+            if hasattr(element, "tail") and element.tail:
+                rv.append("|%s\"%s\"" % (' ' * (indent - 2), element.tail))
+    serializeElement(element, 0)
+
+    return "\n".join(rv)
+
+
+def tostring(element):
+    """Serialize an element and its child nodes to a string"""
+    rv = []
+
+    def serializeElement(element):
+        if not hasattr(element, "tag"):
+            if element.docinfo.internalDTD:
+                if element.docinfo.doctype:
+                    dtd_str = element.docinfo.doctype
+                else:
+                    dtd_str = "<!DOCTYPE %s>" % element.docinfo.root_name
+                rv.append(dtd_str)
+            serializeElement(element.getroot())
+
+        elif element.tag == comment_type:
+            rv.append("<!--%s-->" % (element.text,))
+
+        else:
+            # This is assumed to be an ordinary element
+            if not element.attrib:
+                rv.append("<%s>" % (element.tag,))
+            else:
+                attr = " ".join(["%s=\"%s\"" % (name, value)
+                                 for name, value in element.attrib.items()])
+                rv.append("<%s %s>" % (element.tag, attr))
+            if element.text:
+                rv.append(element.text)
+
+            for child in element:
+                serializeElement(child)
+
+            rv.append("</%s>" % (element.tag,))
+
+        if hasattr(element, "tail") and element.tail:
+            rv.append(element.tail)
+
+    serializeElement(element)
+
+    return "".join(rv)
+
+
+class TreeBuilder(base.TreeBuilder):
+    documentClass = Document
+    doctypeClass = DocumentType
+    elementClass = None
+    commentClass = None
+    fragmentClass = Document
+    implementation = etree
+
+    def __init__(self, namespaceHTMLElements, fullTree=False):
+        builder = etree_builders.getETreeModule(etree, fullTree=fullTree)
+        infosetFilter = self.infosetFilter = _ihatexml.InfosetFilter(preventDoubleDashComments=True)
+        self.namespaceHTMLElements = namespaceHTMLElements
+
+        class Attributes(dict):
+            def __init__(self, element, value=None):
+                if value is None:
+                    value = {}
+                self._element = element
+                dict.__init__(self, value)  # pylint:disable=non-parent-init-called
+                for key, value in self.items():
+                    if isinstance(key, tuple):
+                        name = "{%s}%s" % (key[2], infosetFilter.coerceAttribute(key[1]))
+                    else:
+                        name = infosetFilter.coerceAttribute(key)
+                    self._element._element.attrib[name] = value
+
+            def __setitem__(self, key, value):
+                dict.__setitem__(self, key, value)
+                if isinstance(key, tuple):
+                    name = "{%s}%s" % (key[2], infosetFilter.coerceAttribute(key[1]))
+                else:
+                    name = infosetFilter.coerceAttribute(key)
+                self._element._element.attrib[name] = value
+
+        class Element(builder.Element):
+            def __init__(self, name, namespace):
+                name = infosetFilter.coerceElement(name)
+                builder.Element.__init__(self, name, namespace=namespace)
+                self._attributes = Attributes(self)
+
+            def _setName(self, name):
+                self._name = infosetFilter.coerceElement(name)
+                self._element.tag = self._getETreeTag(
+                    self._name, self._namespace)
+
+            def _getName(self):
+                return infosetFilter.fromXmlName(self._name)
+
+            name = property(_getName, _setName)
+
+            def _getAttributes(self):
+                return self._attributes
+
+            def _setAttributes(self, attributes):
+                self._attributes = Attributes(self, attributes)
+
+            attributes = property(_getAttributes, _setAttributes)
+
+            def insertText(self, data, insertBefore=None):
+                data = infosetFilter.coerceCharacters(data)
+                builder.Element.insertText(self, data, insertBefore)
+
+            def appendChild(self, child):
+                builder.Element.appendChild(self, child)
+
+        class Comment(builder.Comment):
+            def __init__(self, data):
+                data = infosetFilter.coerceComment(data)
+                builder.Comment.__init__(self, data)
+
+            def _setData(self, data):
+                data = infosetFilter.coerceComment(data)
+                self._element.text = data
+
+            def _getData(self):
+                return self._element.text
+
+            data = property(_getData, _setData)
+
+        self.elementClass = Element
+        self.commentClass = Comment
+        # self.fragmentClass = builder.DocumentFragment
+        base.TreeBuilder.__init__(self, namespaceHTMLElements)
+
+    def reset(self):
+        base.TreeBuilder.reset(self)
+        self.insertComment = self.insertCommentInitial
+        self.initial_comments = []
+        self.doctype = None
+
+    def testSerializer(self, element):
+        return testSerializer(element)
+
+    def getDocument(self):
+        if fullTree:
+            return self.document._elementTree
+        else:
+            return self.document._elementTree.getroot()
+
+    def getFragment(self):
+        fragment = []
+        element = self.openElements[0]._element
+        if element.text:
+            fragment.append(element.text)
+        fragment.extend(list(element))
+        if element.tail:
+            fragment.append(element.tail)
+        return fragment
+
+    def insertDoctype(self, token):
+        name = token["name"]
+        publicId = token["publicId"]
+        systemId = token["systemId"]
+
+        if not name:
+            warnings.warn("lxml cannot represent empty doctype", DataLossWarning)
+            self.doctype = None
+        else:
+            coercedName = self.infosetFilter.coerceElement(name)
+            if coercedName != name:
+                warnings.warn("lxml cannot represent non-xml doctype", DataLossWarning)
+
+            doctype = self.doctypeClass(coercedName, publicId, systemId)
+            self.doctype = doctype
+
+    def insertCommentInitial(self, data, parent=None):
+        assert parent is None or parent is self.document
+        assert self.document._elementTree is None
+        self.initial_comments.append(data)
+
+    def insertCommentMain(self, data, parent=None):
+        if (parent == self.document and
+                self.document._elementTree.getroot()[-1].tag == comment_type):
+            warnings.warn("lxml cannot represent adjacent comments beyond the root elements", DataLossWarning)
+        super(TreeBuilder, self).insertComment(data, parent)
+
+    def insertRoot(self, token):
+        # Because of the way libxml2 works, it doesn't seem to be possible to
+        # alter information like the doctype after the tree has been parsed.
+        # Therefore we need to use the built-in parser to create our initial
+        # tree, after which we can add elements like normal
+        docStr = ""
+        if self.doctype:
+            assert self.doctype.name
+            docStr += "<!DOCTYPE %s" % self.doctype.name
+            if (self.doctype.publicId is not None or
+                    self.doctype.systemId is not None):
+                docStr += (' PUBLIC "%s" ' %
+                           (self.infosetFilter.coercePubid(self.doctype.publicId or "")))
+                if self.doctype.systemId:
+                    sysid = self.doctype.systemId
+                    if sysid.find("'") >= 0 and sysid.find('"') >= 0:
+                        warnings.warn("DOCTYPE system cannot contain single and double quotes", DataLossWarning)
+                        sysid = sysid.replace("'", 'U00027')
+                    if sysid.find("'") >= 0:
+                        docStr += '"%s"' % sysid
+                    else:
+                        docStr += "'%s'" % sysid
+                else:
+                    docStr += "''"
+            docStr += ">"
+            if self.doctype.name != token["name"]:
+                warnings.warn("lxml cannot represent doctype with a different name to the root element", DataLossWarning)
+        docStr += "<THIS_SHOULD_NEVER_APPEAR_PUBLICLY/>"
+        root = etree.fromstring(docStr)
+
+        # Append the initial comments:
+        for comment_token in self.initial_comments:
+            comment = self.commentClass(comment_token["data"])
+            root.addprevious(comment._element)
+
+        # Create the root document and add the ElementTree to it
+        self.document = self.documentClass()
+        self.document._elementTree = root.getroottree()
+
+        # Give the root element the right name
+        name = token["name"]
+        namespace = token.get("namespace", self.defaultNamespace)
+        if namespace is None:
+            etree_tag = name
+        else:
+            etree_tag = "{%s}%s" % (namespace, name)
+        root.tag = etree_tag
+
+        # Add the root element to the internal child/open data structures
+        root_element = self.elementClass(name, namespace)
+        root_element._element = root
+        self.document._childNodes.append(root_element)
+        self.openElements.append(root_element)
+
+        # Reset to the default insert comment function
+        self.insertComment = self.insertCommentMain
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9bec2076f3f60e644cdd3265d8e113ca17149dfd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/__init__.py
@@ -0,0 +1,154 @@
+"""A collection of modules for iterating through different kinds of
+tree, generating tokens identical to those produced by the tokenizer
+module.
+
+To create a tree walker for a new type of tree, you need to do
+implement a tree walker object (called TreeWalker by convention) that
+implements a 'serialize' method taking a tree as sole argument and
+returning an iterator generating tokens.
+"""
+
+from __future__ import absolute_import, division, unicode_literals
+
+from .. import constants
+from .._utils import default_etree
+
+__all__ = ["getTreeWalker", "pprint"]
+
+treeWalkerCache = {}
+
+
+def getTreeWalker(treeType, implementation=None, **kwargs):
+    """Get a TreeWalker class for various types of tree with built-in support
+
+    :arg str treeType: the name of the tree type required (case-insensitive).
+        Supported values are:
+
+        * "dom": The xml.dom.minidom DOM implementation
+        * "etree": A generic walker for tree implementations exposing an
+          elementtree-like interface (known to work with ElementTree,
+          cElementTree and lxml.etree).
+        * "lxml": Optimized walker for lxml.etree
+        * "genshi": a Genshi stream
+
+    :arg implementation: A module implementing the tree type e.g.
+        xml.etree.ElementTree or cElementTree (Currently applies to the "etree"
+        tree type only).
+
+    :arg kwargs: keyword arguments passed to the etree walker--for other
+        walkers, this has no effect
+
+    :returns: a TreeWalker class
+
+    """
+
+    treeType = treeType.lower()
+    if treeType not in treeWalkerCache:
+        if treeType == "dom":
+            from . import dom
+            treeWalkerCache[treeType] = dom.TreeWalker
+        elif treeType == "genshi":
+            from . import genshi
+            treeWalkerCache[treeType] = genshi.TreeWalker
+        elif treeType == "lxml":
+            from . import etree_lxml
+            treeWalkerCache[treeType] = etree_lxml.TreeWalker
+        elif treeType == "etree":
+            from . import etree
+            if implementation is None:
+                implementation = default_etree
+            # XXX: NEVER cache here, caching is done in the etree submodule
+            return etree.getETreeModule(implementation, **kwargs).TreeWalker
+    return treeWalkerCache.get(treeType)
+
+
+def concatenateCharacterTokens(tokens):
+    pendingCharacters = []
+    for token in tokens:
+        type = token["type"]
+        if type in ("Characters", "SpaceCharacters"):
+            pendingCharacters.append(token["data"])
+        else:
+            if pendingCharacters:
+                yield {"type": "Characters", "data": "".join(pendingCharacters)}
+                pendingCharacters = []
+            yield token
+    if pendingCharacters:
+        yield {"type": "Characters", "data": "".join(pendingCharacters)}
+
+
+def pprint(walker):
+    """Pretty printer for tree walkers
+
+    Takes a TreeWalker instance and pretty prints the output of walking the tree.
+
+    :arg walker: a TreeWalker instance
+
+    """
+    output = []
+    indent = 0
+    for token in concatenateCharacterTokens(walker):
+        type = token["type"]
+        if type in ("StartTag", "EmptyTag"):
+            # tag name
+            if token["namespace"] and token["namespace"] != constants.namespaces["html"]:
+                if token["namespace"] in constants.prefixes:
+                    ns = constants.prefixes[token["namespace"]]
+                else:
+                    ns = token["namespace"]
+                name = "%s %s" % (ns, token["name"])
+            else:
+                name = token["name"]
+            output.append("%s<%s>" % (" " * indent, name))
+            indent += 2
+            # attributes (sorted for consistent ordering)
+            attrs = token["data"]
+            for (namespace, localname), value in sorted(attrs.items()):
+                if namespace:
+                    if namespace in constants.prefixes:
+                        ns = constants.prefixes[namespace]
+                    else:
+                        ns = namespace
+                    name = "%s %s" % (ns, localname)
+                else:
+                    name = localname
+                output.append("%s%s=\"%s\"" % (" " * indent, name, value))
+            # self-closing
+            if type == "EmptyTag":
+                indent -= 2
+
+        elif type == "EndTag":
+            indent -= 2
+
+        elif type == "Comment":
+            output.append("%s<!-- %s -->" % (" " * indent, token["data"]))
+
+        elif type == "Doctype":
+            if token["name"]:
+                if token["publicId"]:
+                    output.append("""%s<!DOCTYPE %s "%s" "%s">""" %
+                                  (" " * indent,
+                                   token["name"],
+                                   token["publicId"],
+                                   token["systemId"] if token["systemId"] else ""))
+                elif token["systemId"]:
+                    output.append("""%s<!DOCTYPE %s "" "%s">""" %
+                                  (" " * indent,
+                                   token["name"],
+                                   token["systemId"]))
+                else:
+                    output.append("%s<!DOCTYPE %s>" % (" " * indent,
+                                                       token["name"]))
+            else:
+                output.append("%s<!DOCTYPE >" % (" " * indent,))
+
+        elif type == "Characters":
+            output.append("%s\"%s\"" % (" " * indent, token["data"]))
+
+        elif type == "SpaceCharacters":
+            assert False, "concatenateCharacterTokens should have got rid of all Space tokens"
+
+        else:
+            raise ValueError("Unknown token type, %s" % type)
+
+    return "\n".join(output)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..80c474c4e939c149a22e811a5a1a5419313b7cc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/base.py
@@ -0,0 +1,252 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from xml.dom import Node
+from ..constants import namespaces, voidElements, spaceCharacters
+
+__all__ = ["DOCUMENT", "DOCTYPE", "TEXT", "ELEMENT", "COMMENT", "ENTITY", "UNKNOWN",
+           "TreeWalker", "NonRecursiveTreeWalker"]
+
+DOCUMENT = Node.DOCUMENT_NODE
+DOCTYPE = Node.DOCUMENT_TYPE_NODE
+TEXT = Node.TEXT_NODE
+ELEMENT = Node.ELEMENT_NODE
+COMMENT = Node.COMMENT_NODE
+ENTITY = Node.ENTITY_NODE
+UNKNOWN = "<#UNKNOWN#>"
+
+spaceCharacters = "".join(spaceCharacters)
+
+
+class TreeWalker(object):
+    """Walks a tree yielding tokens
+
+    Tokens are dicts that all have a ``type`` field specifying the type of the
+    token.
+
+    """
+    def __init__(self, tree):
+        """Creates a TreeWalker
+
+        :arg tree: the tree to walk
+
+        """
+        self.tree = tree
+
+    def __iter__(self):
+        raise NotImplementedError
+
+    def error(self, msg):
+        """Generates an error token with the given message
+
+        :arg msg: the error message
+
+        :returns: SerializeError token
+
+        """
+        return {"type": "SerializeError", "data": msg}
+
+    def emptyTag(self, namespace, name, attrs, hasChildren=False):
+        """Generates an EmptyTag token
+
+        :arg namespace: the namespace of the token--can be ``None``
+
+        :arg name: the name of the element
+
+        :arg attrs: the attributes of the element as a dict
+
+        :arg hasChildren: whether or not to yield a SerializationError because
+            this tag shouldn't have children
+
+        :returns: EmptyTag token
+
+        """
+        yield {"type": "EmptyTag", "name": name,
+               "namespace": namespace,
+               "data": attrs}
+        if hasChildren:
+            yield self.error("Void element has children")
+
+    def startTag(self, namespace, name, attrs):
+        """Generates a StartTag token
+
+        :arg namespace: the namespace of the token--can be ``None``
+
+        :arg name: the name of the element
+
+        :arg attrs: the attributes of the element as a dict
+
+        :returns: StartTag token
+
+        """
+        return {"type": "StartTag",
+                "name": name,
+                "namespace": namespace,
+                "data": attrs}
+
+    def endTag(self, namespace, name):
+        """Generates an EndTag token
+
+        :arg namespace: the namespace of the token--can be ``None``
+
+        :arg name: the name of the element
+
+        :returns: EndTag token
+
+        """
+        return {"type": "EndTag",
+                "name": name,
+                "namespace": namespace}
+
+    def text(self, data):
+        """Generates SpaceCharacters and Characters tokens
+
+        Depending on what's in the data, this generates one or more
+        ``SpaceCharacters`` and ``Characters`` tokens.
+
+        For example:
+
+            >>> from html5lib.treewalkers.base import TreeWalker
+            >>> # Give it an empty tree just so it instantiates
+            >>> walker = TreeWalker([])
+            >>> list(walker.text(''))
+            []
+            >>> list(walker.text('  '))
+            [{u'data': '  ', u'type': u'SpaceCharacters'}]
+            >>> list(walker.text(' abc '))  # doctest: +NORMALIZE_WHITESPACE
+            [{u'data': ' ', u'type': u'SpaceCharacters'},
+            {u'data': u'abc', u'type': u'Characters'},
+            {u'data': u' ', u'type': u'SpaceCharacters'}]
+
+        :arg data: the text data
+
+        :returns: one or more ``SpaceCharacters`` and ``Characters`` tokens
+
+        """
+        data = data
+        middle = data.lstrip(spaceCharacters)
+        left = data[:len(data) - len(middle)]
+        if left:
+            yield {"type": "SpaceCharacters", "data": left}
+        data = middle
+        middle = data.rstrip(spaceCharacters)
+        right = data[len(middle):]
+        if middle:
+            yield {"type": "Characters", "data": middle}
+        if right:
+            yield {"type": "SpaceCharacters", "data": right}
+
+    def comment(self, data):
+        """Generates a Comment token
+
+        :arg data: the comment
+
+        :returns: Comment token
+
+        """
+        return {"type": "Comment", "data": data}
+
+    def doctype(self, name, publicId=None, systemId=None):
+        """Generates a Doctype token
+
+        :arg name:
+
+        :arg publicId:
+
+        :arg systemId:
+
+        :returns: the Doctype token
+
+        """
+        return {"type": "Doctype",
+                "name": name,
+                "publicId": publicId,
+                "systemId": systemId}
+
+    def entity(self, name):
+        """Generates an Entity token
+
+        :arg name: the entity name
+
+        :returns: an Entity token
+
+        """
+        return {"type": "Entity", "name": name}
+
+    def unknown(self, nodeType):
+        """Handles unknown node types"""
+        return self.error("Unknown node type: " + nodeType)
+
+
+class NonRecursiveTreeWalker(TreeWalker):
+    def getNodeDetails(self, node):
+        raise NotImplementedError
+
+    def getFirstChild(self, node):
+        raise NotImplementedError
+
+    def getNextSibling(self, node):
+        raise NotImplementedError
+
+    def getParentNode(self, node):
+        raise NotImplementedError
+
+    def __iter__(self):
+        currentNode = self.tree
+        while currentNode is not None:
+            details = self.getNodeDetails(currentNode)
+            type, details = details[0], details[1:]
+            hasChildren = False
+
+            if type == DOCTYPE:
+                yield self.doctype(*details)
+
+            elif type == TEXT:
+                for token in self.text(*details):
+                    yield token
+
+            elif type == ELEMENT:
+                namespace, name, attributes, hasChildren = details
+                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
+                    for token in self.emptyTag(namespace, name, attributes,
+                                               hasChildren):
+                        yield token
+                    hasChildren = False
+                else:
+                    yield self.startTag(namespace, name, attributes)
+
+            elif type == COMMENT:
+                yield self.comment(details[0])
+
+            elif type == ENTITY:
+                yield self.entity(details[0])
+
+            elif type == DOCUMENT:
+                hasChildren = True
+
+            else:
+                yield self.unknown(details[0])
+
+            if hasChildren:
+                firstChild = self.getFirstChild(currentNode)
+            else:
+                firstChild = None
+
+            if firstChild is not None:
+                currentNode = firstChild
+            else:
+                while currentNode is not None:
+                    details = self.getNodeDetails(currentNode)
+                    type, details = details[0], details[1:]
+                    if type == ELEMENT:
+                        namespace, name, attributes, hasChildren = details
+                        if (namespace and namespace != namespaces["html"]) or name not in voidElements:
+                            yield self.endTag(namespace, name)
+                    if self.tree is currentNode:
+                        currentNode = None
+                        break
+                    nextSibling = self.getNextSibling(currentNode)
+                    if nextSibling is not None:
+                        currentNode = nextSibling
+                        break
+                    else:
+                        currentNode = self.getParentNode(currentNode)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/dom.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/dom.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0c89b001fd3b60511734c31e452c1d2053468d0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/dom.py
@@ -0,0 +1,43 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from xml.dom import Node
+
+from . import base
+
+
+class TreeWalker(base.NonRecursiveTreeWalker):
+    def getNodeDetails(self, node):
+        if node.nodeType == Node.DOCUMENT_TYPE_NODE:
+            return base.DOCTYPE, node.name, node.publicId, node.systemId
+
+        elif node.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
+            return base.TEXT, node.nodeValue
+
+        elif node.nodeType == Node.ELEMENT_NODE:
+            attrs = {}
+            for attr in list(node.attributes.keys()):
+                attr = node.getAttributeNode(attr)
+                if attr.namespaceURI:
+                    attrs[(attr.namespaceURI, attr.localName)] = attr.value
+                else:
+                    attrs[(None, attr.name)] = attr.value
+            return (base.ELEMENT, node.namespaceURI, node.nodeName,
+                    attrs, node.hasChildNodes())
+
+        elif node.nodeType == Node.COMMENT_NODE:
+            return base.COMMENT, node.nodeValue
+
+        elif node.nodeType in (Node.DOCUMENT_NODE, Node.DOCUMENT_FRAGMENT_NODE):
+            return (base.DOCUMENT,)
+
+        else:
+            return base.UNKNOWN, node.nodeType
+
+    def getFirstChild(self, node):
+        return node.firstChild
+
+    def getNextSibling(self, node):
+        return node.nextSibling
+
+    def getParentNode(self, node):
+        return node.parentNode
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree.py
new file mode 100644
index 0000000000000000000000000000000000000000..d15a7eebfe8cdb4539d25eacad2ad17a73788054
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree.py
@@ -0,0 +1,130 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from collections import OrderedDict
+import re
+
+from six import string_types
+
+from . import base
+from .._utils import moduleFactoryFactory
+
+tag_regexp = re.compile("{([^}]*)}(.*)")
+
+
+def getETreeBuilder(ElementTreeImplementation):
+    ElementTree = ElementTreeImplementation
+    ElementTreeCommentType = ElementTree.Comment("asd").tag
+
+    class TreeWalker(base.NonRecursiveTreeWalker):  # pylint:disable=unused-variable
+        """Given the particular ElementTree representation, this implementation,
+        to avoid using recursion, returns "nodes" as tuples with the following
+        content:
+
+        1. The current element
+
+        2. The index of the element relative to its parent
+
+        3. A stack of ancestor elements
+
+        4. A flag "text", "tail" or None to indicate if the current node is a
+           text node; either the text or tail of the current element (1)
+        """
+        def getNodeDetails(self, node):
+            if isinstance(node, tuple):  # It might be the root Element
+                elt, _, _, flag = node
+                if flag in ("text", "tail"):
+                    return base.TEXT, getattr(elt, flag)
+                else:
+                    node = elt
+
+            if not(hasattr(node, "tag")):
+                node = node.getroot()
+
+            if node.tag in ("DOCUMENT_ROOT", "DOCUMENT_FRAGMENT"):
+                return (base.DOCUMENT,)
+
+            elif node.tag == "<!DOCTYPE>":
+                return (base.DOCTYPE, node.text,
+                        node.get("publicId"), node.get("systemId"))
+
+            elif node.tag == ElementTreeCommentType:
+                return base.COMMENT, node.text
+
+            else:
+                assert isinstance(node.tag, string_types), type(node.tag)
+                # This is assumed to be an ordinary element
+                match = tag_regexp.match(node.tag)
+                if match:
+                    namespace, tag = match.groups()
+                else:
+                    namespace = None
+                    tag = node.tag
+                attrs = OrderedDict()
+                for name, value in list(node.attrib.items()):
+                    match = tag_regexp.match(name)
+                    if match:
+                        attrs[(match.group(1), match.group(2))] = value
+                    else:
+                        attrs[(None, name)] = value
+                return (base.ELEMENT, namespace, tag,
+                        attrs, len(node) or node.text)
+
+        def getFirstChild(self, node):
+            if isinstance(node, tuple):
+                element, key, parents, flag = node
+            else:
+                element, key, parents, flag = node, None, [], None
+
+            if flag in ("text", "tail"):
+                return None
+            else:
+                if element.text:
+                    return element, key, parents, "text"
+                elif len(element):
+                    parents.append(element)
+                    return element[0], 0, parents, None
+                else:
+                    return None
+
+        def getNextSibling(self, node):
+            if isinstance(node, tuple):
+                element, key, parents, flag = node
+            else:
+                return None
+
+            if flag == "text":
+                if len(element):
+                    parents.append(element)
+                    return element[0], 0, parents, None
+                else:
+                    return None
+            else:
+                if element.tail and flag != "tail":
+                    return element, key, parents, "tail"
+                elif key < len(parents[-1]) - 1:
+                    return parents[-1][key + 1], key + 1, parents, None
+                else:
+                    return None
+
+        def getParentNode(self, node):
+            if isinstance(node, tuple):
+                element, key, parents, flag = node
+            else:
+                return None
+
+            if flag == "text":
+                if not parents:
+                    return element
+                else:
+                    return element, key, parents, None
+            else:
+                parent = parents.pop()
+                if not parents:
+                    return parent
+                else:
+                    assert list(parents[-1]).count(parent) == 1
+                    return parent, list(parents[-1]).index(parent), parents, None
+
+    return locals()
+
+getETreeModule = moduleFactoryFactory(getETreeBuilder)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree_lxml.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree_lxml.py
new file mode 100644
index 0000000000000000000000000000000000000000..fb2363112b1ea39d4789ef9f1589385f69854ab5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/etree_lxml.py
@@ -0,0 +1,213 @@
+from __future__ import absolute_import, division, unicode_literals
+from six import text_type
+
+from lxml import etree
+from ..treebuilders.etree import tag_regexp
+
+from . import base
+
+from .. import _ihatexml
+
+
+def ensure_str(s):
+    if s is None:
+        return None
+    elif isinstance(s, text_type):
+        return s
+    else:
+        return s.decode("ascii", "strict")
+
+
+class Root(object):
+    def __init__(self, et):
+        self.elementtree = et
+        self.children = []
+
+        try:
+            if et.docinfo.internalDTD:
+                self.children.append(Doctype(self,
+                                             ensure_str(et.docinfo.root_name),
+                                             ensure_str(et.docinfo.public_id),
+                                             ensure_str(et.docinfo.system_url)))
+        except AttributeError:
+            pass
+
+        try:
+            node = et.getroot()
+        except AttributeError:
+            node = et
+
+        while node.getprevious() is not None:
+            node = node.getprevious()
+        while node is not None:
+            self.children.append(node)
+            node = node.getnext()
+
+        self.text = None
+        self.tail = None
+
+    def __getitem__(self, key):
+        return self.children[key]
+
+    def getnext(self):
+        return None
+
+    def __len__(self):
+        return 1
+
+
+class Doctype(object):
+    def __init__(self, root_node, name, public_id, system_id):
+        self.root_node = root_node
+        self.name = name
+        self.public_id = public_id
+        self.system_id = system_id
+
+        self.text = None
+        self.tail = None
+
+    def getnext(self):
+        return self.root_node.children[1]
+
+
+class FragmentRoot(Root):
+    def __init__(self, children):
+        self.children = [FragmentWrapper(self, child) for child in children]
+        self.text = self.tail = None
+
+    def getnext(self):
+        return None
+
+
+class FragmentWrapper(object):
+    def __init__(self, fragment_root, obj):
+        self.root_node = fragment_root
+        self.obj = obj
+        if hasattr(self.obj, 'text'):
+            self.text = ensure_str(self.obj.text)
+        else:
+            self.text = None
+        if hasattr(self.obj, 'tail'):
+            self.tail = ensure_str(self.obj.tail)
+        else:
+            self.tail = None
+
+    def __getattr__(self, name):
+        return getattr(self.obj, name)
+
+    def getnext(self):
+        siblings = self.root_node.children
+        idx = siblings.index(self)
+        if idx < len(siblings) - 1:
+            return siblings[idx + 1]
+        else:
+            return None
+
+    def __getitem__(self, key):
+        return self.obj[key]
+
+    def __bool__(self):
+        return bool(self.obj)
+
+    def getparent(self):
+        return None
+
+    def __str__(self):
+        return str(self.obj)
+
+    def __unicode__(self):
+        return str(self.obj)
+
+    def __len__(self):
+        return len(self.obj)
+
+
+class TreeWalker(base.NonRecursiveTreeWalker):
+    def __init__(self, tree):
+        # pylint:disable=redefined-variable-type
+        if isinstance(tree, list):
+            self.fragmentChildren = set(tree)
+            tree = FragmentRoot(tree)
+        else:
+            self.fragmentChildren = set()
+            tree = Root(tree)
+        base.NonRecursiveTreeWalker.__init__(self, tree)
+        self.filter = _ihatexml.InfosetFilter()
+
+    def getNodeDetails(self, node):
+        if isinstance(node, tuple):  # Text node
+            node, key = node
+            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
+            return base.TEXT, ensure_str(getattr(node, key))
+
+        elif isinstance(node, Root):
+            return (base.DOCUMENT,)
+
+        elif isinstance(node, Doctype):
+            return base.DOCTYPE, node.name, node.public_id, node.system_id
+
+        elif isinstance(node, FragmentWrapper) and not hasattr(node, "tag"):
+            return base.TEXT, ensure_str(node.obj)
+
+        elif node.tag == etree.Comment:
+            return base.COMMENT, ensure_str(node.text)
+
+        elif node.tag == etree.Entity:
+            return base.ENTITY, ensure_str(node.text)[1:-1]  # strip &;
+
+        else:
+            # This is assumed to be an ordinary element
+            match = tag_regexp.match(ensure_str(node.tag))
+            if match:
+                namespace, tag = match.groups()
+            else:
+                namespace = None
+                tag = ensure_str(node.tag)
+            attrs = {}
+            for name, value in list(node.attrib.items()):
+                name = ensure_str(name)
+                value = ensure_str(value)
+                match = tag_regexp.match(name)
+                if match:
+                    attrs[(match.group(1), match.group(2))] = value
+                else:
+                    attrs[(None, name)] = value
+            return (base.ELEMENT, namespace, self.filter.fromXmlName(tag),
+                    attrs, len(node) > 0 or node.text)
+
+    def getFirstChild(self, node):
+        assert not isinstance(node, tuple), "Text nodes have no children"
+
+        assert len(node) or node.text, "Node has no children"
+        if node.text:
+            return (node, "text")
+        else:
+            return node[0]
+
+    def getNextSibling(self, node):
+        if isinstance(node, tuple):  # Text node
+            node, key = node
+            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
+            if key == "text":
+                # XXX: we cannot use a "bool(node) and node[0] or None" construct here
+                # because node[0] might evaluate to False if it has no child element
+                if len(node):
+                    return node[0]
+                else:
+                    return None
+            else:  # tail
+                return node.getnext()
+
+        return (node, "tail") if node.tail else node.getnext()
+
+    def getParentNode(self, node):
+        if isinstance(node, tuple):  # Text node
+            node, key = node
+            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
+            if key == "text":
+                return node
+            # else: fallback to "normal" processing
+        elif node in self.fragmentChildren:
+            return None
+
+        return node.getparent()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/genshi.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/genshi.py
new file mode 100644
index 0000000000000000000000000000000000000000..7483be27d4d24f845e56b6954ee63eec730c00aa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/html5lib/treewalkers/genshi.py
@@ -0,0 +1,69 @@
+from __future__ import absolute_import, division, unicode_literals
+
+from genshi.core import QName
+from genshi.core import START, END, XML_NAMESPACE, DOCTYPE, TEXT
+from genshi.core import START_NS, END_NS, START_CDATA, END_CDATA, PI, COMMENT
+
+from . import base
+
+from ..constants import voidElements, namespaces
+
+
+class TreeWalker(base.TreeWalker):
+    def __iter__(self):
+        # Buffer the events so we can pass in the following one
+        previous = None
+        for event in self.tree:
+            if previous is not None:
+                for token in self.tokens(previous, event):
+                    yield token
+            previous = event
+
+        # Don't forget the final event!
+        if previous is not None:
+            for token in self.tokens(previous, None):
+                yield token
+
+    def tokens(self, event, next):
+        kind, data, _ = event
+        if kind == START:
+            tag, attribs = data
+            name = tag.localname
+            namespace = tag.namespace
+            converted_attribs = {}
+            for k, v in attribs:
+                if isinstance(k, QName):
+                    converted_attribs[(k.namespace, k.localname)] = v
+                else:
+                    converted_attribs[(None, k)] = v
+
+            if namespace == namespaces["html"] and name in voidElements:
+                for token in self.emptyTag(namespace, name, converted_attribs,
+                                           not next or next[0] != END or
+                                           next[1] != tag):
+                    yield token
+            else:
+                yield self.startTag(namespace, name, converted_attribs)
+
+        elif kind == END:
+            name = data.localname
+            namespace = data.namespace
+            if namespace != namespaces["html"] or name not in voidElements:
+                yield self.endTag(namespace, name)
+
+        elif kind == COMMENT:
+            yield self.comment(data)
+
+        elif kind == TEXT:
+            for token in self.text(data):
+                yield token
+
+        elif kind == DOCTYPE:
+            yield self.doctype(*data)
+
+        elif kind in (XML_NAMESPACE, DOCTYPE, START_NS, END_NS,
+                      START_CDATA, END_CDATA, PI):
+            pass
+
+        else:
+            yield self.unknown(kind)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..30fde02b1b68876ed651d70f42d4ea8dae7d4b72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/METADATA
@@ -0,0 +1,239 @@
+Metadata-Version: 2.1
+Name: idna
+Version: 2.8
+Summary: Internationalized Domain Names in Applications (IDNA)
+Home-page: https://github.com/kjd/idna
+Author: Kim Davies
+Author-email: kim@cynosure.com.au
+License: BSD-like
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Internet :: Name Service (DNS)
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+
+Internationalized Domain Names in Applications (IDNA)
+=====================================================
+
+Support for the Internationalised Domain Names in Applications
+(IDNA) protocol as specified in `RFC 5891 <http://tools.ietf.org/html/rfc5891>`_.
+This is the latest version of the protocol and is sometimes referred to as
+“IDNA 2008”.
+
+This library also provides support for Unicode Technical Standard 46,
+`Unicode IDNA Compatibility Processing <http://unicode.org/reports/tr46/>`_.
+
+This acts as a suitable replacement for the “encodings.idna” module that
+comes with the Python standard library, but only supports the
+old, deprecated IDNA specification (`RFC 3490 <http://tools.ietf.org/html/rfc3490>`_).
+
+Basic functions are simply executed:
+
+.. code-block:: pycon
+
+    # Python 3
+    >>> import idna
+    >>> idna.encode('ドメイン.テスト')
+    b'xn--eckwd4c7c.xn--zckzah'
+    >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))
+    ドメイン.テスト
+
+    # Python 2
+    >>> import idna
+    >>> idna.encode(u'ドメイン.テスト')
+    'xn--eckwd4c7c.xn--zckzah'
+    >>> print idna.decode('xn--eckwd4c7c.xn--zckzah')
+    ドメイン.テスト
+
+Packages
+--------
+
+The latest tagged release version is published in the PyPI repository:
+
+.. image:: https://badge.fury.io/py/idna.svg
+   :target: http://badge.fury.io/py/idna
+
+
+Installation
+------------
+
+To install this library, you can use pip:
+
+.. code-block:: bash
+
+    $ pip install idna
+
+Alternatively, you can install the package using the bundled setup script:
+
+.. code-block:: bash
+
+    $ python setup.py install
+
+This library works with Python 2.7 and Python 3.4 or later.
+
+
+Usage
+-----
+
+For typical usage, the ``encode`` and ``decode`` functions will take a domain
+name argument and perform a conversion to A-labels or U-labels respectively.
+
+.. code-block:: pycon
+
+    # Python 3
+    >>> import idna
+    >>> idna.encode('ドメイン.テスト')
+    b'xn--eckwd4c7c.xn--zckzah'
+    >>> print(idna.decode('xn--eckwd4c7c.xn--zckzah'))
+    ドメイン.テスト
+
+You may use the codec encoding and decoding methods using the
+``idna.codec`` module:
+
+.. code-block:: pycon
+
+    # Python 2
+    >>> import idna.codec
+    >>> print u'домена.испытание'.encode('idna')
+    xn--80ahd1agd.xn--80akhbyknj4f
+    >>> print 'xn--80ahd1agd.xn--80akhbyknj4f'.decode('idna')
+    домена.испытание
+
+Conversions can be applied at a per-label basis using the ``ulabel`` or ``alabel``
+functions if necessary:
+
+.. code-block:: pycon
+
+    # Python 2
+    >>> idna.alabel(u'测试')
+    'xn--0zwm56d'
+
+Compatibility Mapping (UTS #46)
++++++++++++++++++++++++++++++++
+
+As described in `RFC 5895 <http://tools.ietf.org/html/rfc5895>`_, the IDNA
+specification no longer normalizes input from different potential ways a user
+may input a domain name. This functionality, known as a “mapping”, is now
+considered by the specification to be a local user-interface issue distinct
+from IDNA conversion functionality.
+
+This library provides one such mapping, that was developed by the Unicode
+Consortium. Known as `Unicode IDNA Compatibility Processing <http://unicode.org/reports/tr46/>`_,
+it provides for both a regular mapping for typical applications, as well as
+a transitional mapping to help migrate from older IDNA 2003 applications.
+
+For example, “Königsgäßchen” is not a permissible label as *LATIN CAPITAL
+LETTER K* is not allowed (nor are capital letters in general). UTS 46 will
+convert this into lower case prior to applying the IDNA conversion.
+
+.. code-block:: pycon
+
+    # Python 3
+    >>> import idna
+    >>> idna.encode(u'Königsgäßchen')
+    ...
+    idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of 'Königsgäßchen' not allowed
+    >>> idna.encode('Königsgäßchen', uts46=True)
+    b'xn--knigsgchen-b4a3dun'
+    >>> print(idna.decode('xn--knigsgchen-b4a3dun'))
+    königsgäßchen
+
+Transitional processing provides conversions to help transition from the older
+2003 standard to the current standard. For example, in the original IDNA
+specification, the *LATIN SMALL LETTER SHARP S* (ß) was converted into two
+*LATIN SMALL LETTER S* (ss), whereas in the current IDNA specification this
+conversion is not performed.
+
+.. code-block:: pycon
+
+    # Python 2
+    >>> idna.encode(u'Königsgäßchen', uts46=True, transitional=True)
+    'xn--knigsgsschen-lcb0w'
+
+Implementors should use transitional processing with caution, only in rare
+cases where conversion from legacy labels to current labels must be performed
+(i.e. IDNA implementations that pre-date 2008). For typical applications
+that just need to convert labels, transitional processing is unlikely to be
+beneficial and could produce unexpected incompatible results.
+
+``encodings.idna`` Compatibility
+++++++++++++++++++++++++++++++++
+
+Function calls from the Python built-in ``encodings.idna`` module are
+mapped to their IDNA 2008 equivalents using the ``idna.compat`` module.
+Simply substitute the ``import`` clause in your code to refer to the
+new module name.
+
+Exceptions
+----------
+
+All errors raised during the conversion following the specification should
+raise an exception derived from the ``idna.IDNAError`` base class.
+
+More specific exceptions that may be generated as ``idna.IDNABidiError``
+when the error reflects an illegal combination of left-to-right and right-to-left
+characters in a label; ``idna.InvalidCodepoint`` when a specific codepoint is
+an illegal character in an IDN label (i.e. INVALID); and ``idna.InvalidCodepointContext``
+when the codepoint is illegal based on its positional context (i.e. it is CONTEXTO
+or CONTEXTJ but the contextual requirements are not satisfied.)
+
+Building and Diagnostics
+------------------------
+
+The IDNA and UTS 46 functionality relies upon pre-calculated lookup tables for
+performance. These tables are derived from computing against eligibility criteria
+in the respective standards. These tables are computed using the command-line
+script ``tools/idna-data``.
+
+This tool will fetch relevant tables from the Unicode Consortium and perform the
+required calculations to identify eligibility. It has three main modes:
+
+* ``idna-data make-libdata``. Generates ``idnadata.py`` and ``uts46data.py``,
+  the pre-calculated lookup tables using for IDNA and UTS 46 conversions. Implementors
+  who wish to track this library against a different Unicode version may use this tool
+  to manually generate a different version of the ``idnadata.py`` and ``uts46data.py``
+  files.
+
+* ``idna-data make-table``. Generate a table of the IDNA disposition
+  (e.g. PVALID, CONTEXTJ, CONTEXTO) in the format found in Appendix B.1 of RFC
+  5892 and the pre-computed tables published by `IANA <http://iana.org/>`_.
+
+* ``idna-data U+0061``. Prints debugging output on the various properties
+  associated with an individual Unicode codepoint (in this case, U+0061), that are
+  used to assess the IDNA and UTS 46 status of a codepoint. This is helpful in debugging
+  or analysis.
+
+The tool accepts a number of arguments, described using ``idna-data -h``. Most notably,
+the ``--version`` argument allows the specification of the version of Unicode to use
+in computing the table data. For example, ``idna-data --version 9.0.0 make-libdata``
+will generate library data against Unicode 9.0.0.
+
+Note that this script requires Python 3, but all generated library data will work
+in Python 2.7.
+
+
+Testing
+-------
+
+The library has a test suite based on each rule of the IDNA specification, as
+well as tests that are provided as part of the Unicode Technical Standard 46,
+`Unicode IDNA Compatibility Processing <http://unicode.org/reports/tr46/>`_.
+
+The tests are run automatically on each commit at Travis CI:
+
+.. image:: https://travis-ci.org/kjd/idna.svg?branch=master
+   :target: https://travis-ci.org/kjd/idna
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..7c0fb481225fde6fc72c6f37adcc6c2c23ac0583
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/RECORD
@@ -0,0 +1,26 @@
+idna/__init__.py,sha256=9Nt7xpyet3DmOrPUGooDdAwmHZZu1qUAy2EaJ93kGiQ,58
+idna/codec.py,sha256=lvYb7yu7PhAqFaAIAdWcwgaWI2UmgseUua-1c0AsG0A,3299
+idna/compat.py,sha256=R-h29D-6mrnJzbXxymrWUW7iZUvy-26TQwZ0ij57i4U,232
+idna/core.py,sha256=JDCZZ_PLESqIgEbU8mPyoEufWwoOiIqygA17-QZIe3s,11733
+idna/idnadata.py,sha256=HXaPFw6_YAJ0qppACPu0YLAULtRs3QovRM_CCZHGdY0,40899
+idna/intranges.py,sha256=TY1lpxZIQWEP6tNqjZkFA5hgoMWOj1OBmnUG8ihT87E,1749
+idna/package_data.py,sha256=kIzeKKXEouXLR4srqwf9Q3zv-NffKSOz5aSDOJARPB0,21
+idna/uts46data.py,sha256=oLyNZ1pBaiBlj9zFzLFRd_P7J8MkRcgDisjExZR_4MY,198292
+idna-2.8.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+idna-2.8.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+idna-2.8.dist-info/METADATA,sha256=X4QsM_BLMPhl4gC8SEnXjvl5-gj7hvwAl7UCyR418so,8862
+idna-2.8.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+idna-2.8.dist-info/top_level.txt,sha256=jSag9sEDqvSPftxOQy-ABfGV_RSy7oFh4zZJpODV8k0,5
+idna-2.8.dist-info/RECORD,,
+idna-2.8.dist-info/INSTALLER,,
+idna/__init__.cpython-38.pyc,,
+idna/core.cpython-38.pyc,,
+idna/codec.cpython-38.pyc,,
+idna/uts46data.cpython-38.pyc,,
+idna-2.8.dist-info/__pycache__,,
+idna/intranges.cpython-38.pyc,,
+idna/__pycache__,,
+idna/idnadata.cpython-38.pyc,,
+idna-2.8.virtualenv,,
+idna/package_data.cpython-38.pyc,,
+idna/compat.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c40472e6fc2723c6dfeb7c305fcf6763edeedf2c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.dist-info/top_level.txt
@@ -0,0 +1 @@
+idna
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna-2.8.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..847bf9354781fddc44ed2f47055a67c025972fd4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/__init__.py
@@ -0,0 +1,2 @@
+from .package_data import __version__
+from .core import *
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/codec.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/codec.py
new file mode 100644
index 0000000000000000000000000000000000000000..98c65ead146e42b359a11703d719bafe916b1ad7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/codec.py
@@ -0,0 +1,118 @@
+from .core import encode, decode, alabel, ulabel, IDNAError
+import codecs
+import re
+
+_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')
+
+class Codec(codecs.Codec):
+
+    def encode(self, data, errors='strict'):
+
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return "", 0
+
+        return encode(data), len(data)
+
+    def decode(self, data, errors='strict'):
+
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return u"", 0
+
+        return decode(data), len(data)
+
+class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
+    def _buffer_encode(self, data, errors, final):
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return ("", 0)
+
+        labels = _unicode_dots_re.split(data)
+        trailing_dot = u''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = '.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = '.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(alabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        # Join with U+002E
+        result = ".".join(result) + trailing_dot
+        size += len(trailing_dot)
+        return (result, size)
+
+class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
+    def _buffer_decode(self, data, errors, final):
+        if errors != 'strict':
+            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))
+
+        if not data:
+            return (u"", 0)
+
+        # IDNA allows decoding to operate on Unicode strings, too.
+        if isinstance(data, unicode):
+            labels = _unicode_dots_re.split(data)
+        else:
+            # Must be ASCII string
+            data = str(data)
+            unicode(data, "ascii")
+            labels = data.split(".")
+
+        trailing_dot = u''
+        if labels:
+            if not labels[-1]:
+                trailing_dot = u'.'
+                del labels[-1]
+            elif not final:
+                # Keep potentially unfinished label until the next call
+                del labels[-1]
+                if labels:
+                    trailing_dot = u'.'
+
+        result = []
+        size = 0
+        for label in labels:
+            result.append(ulabel(label))
+            if size:
+                size += 1
+            size += len(label)
+
+        result = u".".join(result) + trailing_dot
+        size += len(trailing_dot)
+        return (result, size)
+
+
+class StreamWriter(Codec, codecs.StreamWriter):
+    pass
+
+class StreamReader(Codec, codecs.StreamReader):
+    pass
+
+def getregentry():
+    return codecs.CodecInfo(
+        name='idna',
+        encode=Codec().encode,
+        decode=Codec().decode,
+        incrementalencoder=IncrementalEncoder,
+        incrementaldecoder=IncrementalDecoder,
+        streamwriter=StreamWriter,
+        streamreader=StreamReader,
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d47f336dbc55ca7141150c14ec1a7924dd0e854
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/compat.py
@@ -0,0 +1,12 @@
+from .core import *
+from .codec import *
+
+def ToASCII(label):
+    return encode(label)
+
+def ToUnicode(label):
+    return decode(label)
+
+def nameprep(s):
+    raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol")
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/core.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..104624ad2ddd7b18e255a74dcaa099a84223d959
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/core.py
@@ -0,0 +1,396 @@
+from . import idnadata
+import bisect
+import unicodedata
+import re
+import sys
+from .intranges import intranges_contain
+
+_virama_combining_class = 9
+_alabel_prefix = b'xn--'
+_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')
+
+if sys.version_info[0] == 3:
+    unicode = str
+    unichr = chr
+
+class IDNAError(UnicodeError):
+    """ Base exception for all IDNA-encoding related problems """
+    pass
+
+
+class IDNABidiError(IDNAError):
+    """ Exception when bidirectional requirements are not satisfied """
+    pass
+
+
+class InvalidCodepoint(IDNAError):
+    """ Exception when a disallowed or unallocated codepoint is used """
+    pass
+
+
+class InvalidCodepointContext(IDNAError):
+    """ Exception when the codepoint is not valid in the context it is used """
+    pass
+
+
+def _combining_class(cp):
+    v = unicodedata.combining(unichr(cp))
+    if v == 0:
+        if not unicodedata.name(unichr(cp)):
+            raise ValueError("Unknown character in unicodedata")
+    return v
+
+def _is_script(cp, script):
+    return intranges_contain(ord(cp), idnadata.scripts[script])
+
+def _punycode(s):
+    return s.encode('punycode')
+
+def _unot(s):
+    return 'U+{0:04X}'.format(s)
+
+
+def valid_label_length(label):
+
+    if len(label) > 63:
+        return False
+    return True
+
+
+def valid_string_length(label, trailing_dot):
+
+    if len(label) > (254 if trailing_dot else 253):
+        return False
+    return True
+
+
+def check_bidi(label, check_ltr=False):
+
+    # Bidi rules should only be applied if string contains RTL characters
+    bidi_label = False
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+        if direction == '':
+            # String likely comes from a newer version of Unicode
+            raise IDNABidiError('Unknown directionality in label {0} at position {1}'.format(repr(label), idx))
+        if direction in ['R', 'AL', 'AN']:
+            bidi_label = True
+    if not bidi_label and not check_ltr:
+        return True
+
+    # Bidi rule 1
+    direction = unicodedata.bidirectional(label[0])
+    if direction in ['R', 'AL']:
+        rtl = True
+    elif direction == 'L':
+        rtl = False
+    else:
+        raise IDNABidiError('First codepoint in label {0} must be directionality L, R or AL'.format(repr(label)))
+
+    valid_ending = False
+    number_type = False
+    for (idx, cp) in enumerate(label, 1):
+        direction = unicodedata.bidirectional(cp)
+
+        if rtl:
+            # Bidi rule 2
+            if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {0} in a right-to-left label'.format(idx))
+            # Bidi rule 3
+            if direction in ['R', 'AL', 'EN', 'AN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+            # Bidi rule 4
+            if direction in ['AN', 'EN']:
+                if not number_type:
+                    number_type = direction
+                else:
+                    if number_type != direction:
+                        raise IDNABidiError('Can not mix numeral types in a right-to-left label')
+        else:
+            # Bidi rule 5
+            if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
+                raise IDNABidiError('Invalid direction for codepoint at position {0} in a left-to-right label'.format(idx))
+            # Bidi rule 6
+            if direction in ['L', 'EN']:
+                valid_ending = True
+            elif direction != 'NSM':
+                valid_ending = False
+
+    if not valid_ending:
+        raise IDNABidiError('Label ends with illegal codepoint directionality')
+
+    return True
+
+
+def check_initial_combiner(label):
+
+    if unicodedata.category(label[0])[0] == 'M':
+        raise IDNAError('Label begins with an illegal combining character')
+    return True
+
+
+def check_hyphen_ok(label):
+
+    if label[2:4] == '--':
+        raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')
+    if label[0] == '-' or label[-1] == '-':
+        raise IDNAError('Label must not start or end with a hyphen')
+    return True
+
+
+def check_nfc(label):
+
+    if unicodedata.normalize('NFC', label) != label:
+        raise IDNAError('Label must be in Normalization Form C')
+
+
+def valid_contextj(label, pos):
+
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x200c:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+
+        ok = False
+        for i in range(pos-1, -1, -1):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            if joining_type in [ord('L'), ord('D')]:
+                ok = True
+                break
+
+        if not ok:
+            return False
+
+        ok = False
+        for i in range(pos+1, len(label)):
+            joining_type = idnadata.joining_types.get(ord(label[i]))
+            if joining_type == ord('T'):
+                continue
+            if joining_type in [ord('R'), ord('D')]:
+                ok = True
+                break
+        return ok
+
+    if cp_value == 0x200d:
+
+        if pos > 0:
+            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
+                return True
+        return False
+
+    else:
+
+        return False
+
+
+def valid_contexto(label, pos, exception=False):
+
+    cp_value = ord(label[pos])
+
+    if cp_value == 0x00b7:
+        if 0 < pos < len(label)-1:
+            if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:
+                return True
+        return False
+
+    elif cp_value == 0x0375:
+        if pos < len(label)-1 and len(label) > 1:
+            return _is_script(label[pos + 1], 'Greek')
+        return False
+
+    elif cp_value == 0x05f3 or cp_value == 0x05f4:
+        if pos > 0:
+            return _is_script(label[pos - 1], 'Hebrew')
+        return False
+
+    elif cp_value == 0x30fb:
+        for cp in label:
+            if cp == u'\u30fb':
+                continue
+            if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):
+                return True
+        return False
+
+    elif 0x660 <= cp_value <= 0x669:
+        for cp in label:
+            if 0x6f0 <= ord(cp) <= 0x06f9:
+                return False
+        return True
+
+    elif 0x6f0 <= cp_value <= 0x6f9:
+        for cp in label:
+            if 0x660 <= ord(cp) <= 0x0669:
+                return False
+        return True
+
+
+def check_label(label):
+
+    if isinstance(label, (bytes, bytearray)):
+        label = label.decode('utf-8')
+    if len(label) == 0:
+        raise IDNAError('Empty Label')
+
+    check_nfc(label)
+    check_hyphen_ok(label)
+    check_initial_combiner(label)
+
+    for (pos, cp) in enumerate(label):
+        cp_value = ord(cp)
+        if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
+            continue
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
+            try:
+                if not valid_contextj(label, pos):
+                    raise InvalidCodepointContext('Joiner {0} not allowed at position {1} in {2}'.format(
+                        _unot(cp_value), pos+1, repr(label)))
+            except ValueError:
+                raise IDNAError('Unknown codepoint adjacent to joiner {0} at position {1} in {2}'.format(
+                    _unot(cp_value), pos+1, repr(label)))
+        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
+            if not valid_contexto(label, pos):
+                raise InvalidCodepointContext('Codepoint {0} not allowed at position {1} in {2}'.format(_unot(cp_value), pos+1, repr(label)))
+        else:
+            raise InvalidCodepoint('Codepoint {0} at position {1} of {2} not allowed'.format(_unot(cp_value), pos+1, repr(label)))
+
+    check_bidi(label)
+
+
+def alabel(label):
+
+    try:
+        label = label.encode('ascii')
+        ulabel(label)
+        if not valid_label_length(label):
+            raise IDNAError('Label too long')
+        return label
+    except UnicodeEncodeError:
+        pass
+
+    if not label:
+        raise IDNAError('No Input')
+
+    label = unicode(label)
+    check_label(label)
+    label = _punycode(label)
+    label = _alabel_prefix + label
+
+    if not valid_label_length(label):
+        raise IDNAError('Label too long')
+
+    return label
+
+
+def ulabel(label):
+
+    if not isinstance(label, (bytes, bytearray)):
+        try:
+            label = label.encode('ascii')
+        except UnicodeEncodeError:
+            check_label(label)
+            return label
+
+    label = label.lower()
+    if label.startswith(_alabel_prefix):
+        label = label[len(_alabel_prefix):]
+    else:
+        check_label(label)
+        return label.decode('ascii')
+
+    label = label.decode('punycode')
+    check_label(label)
+    return label
+
+
+def uts46_remap(domain, std3_rules=True, transitional=False):
+    """Re-map the characters in the string according to UTS46 processing."""
+    from .uts46data import uts46data
+    output = u""
+    try:
+        for pos, char in enumerate(domain):
+            code_point = ord(char)
+            uts46row = uts46data[code_point if code_point < 256 else
+                bisect.bisect_left(uts46data, (code_point, "Z")) - 1]
+            status = uts46row[1]
+            replacement = uts46row[2] if len(uts46row) == 3 else None
+            if (status == "V" or
+                    (status == "D" and not transitional) or
+                    (status == "3" and not std3_rules and replacement is None)):
+                output += char
+            elif replacement is not None and (status == "M" or
+                    (status == "3" and not std3_rules) or
+                    (status == "D" and transitional)):
+                output += replacement
+            elif status != "I":
+                raise IndexError()
+        return unicodedata.normalize("NFC", output)
+    except IndexError:
+        raise InvalidCodepoint(
+            "Codepoint {0} not allowed at position {1} in {2}".format(
+            _unot(code_point), pos + 1, repr(domain)))
+
+
+def encode(s, strict=False, uts46=False, std3_rules=False, transitional=False):
+
+    if isinstance(s, (bytes, bytearray)):
+        s = s.decode("ascii")
+    if uts46:
+        s = uts46_remap(s, std3_rules, transitional)
+    trailing_dot = False
+    result = []
+    if strict:
+        labels = s.split('.')
+    else:
+        labels = _unicode_dots_re.split(s)
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if labels[-1] == '':
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = alabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append(b'')
+    s = b'.'.join(result)
+    if not valid_string_length(s, trailing_dot):
+        raise IDNAError('Domain too long')
+    return s
+
+
+def decode(s, strict=False, uts46=False, std3_rules=False):
+
+    if isinstance(s, (bytes, bytearray)):
+        s = s.decode("ascii")
+    if uts46:
+        s = uts46_remap(s, std3_rules, False)
+    trailing_dot = False
+    result = []
+    if not strict:
+        labels = _unicode_dots_re.split(s)
+    else:
+        labels = s.split(u'.')
+    if not labels or labels == ['']:
+        raise IDNAError('Empty domain')
+    if not labels[-1]:
+        del labels[-1]
+        trailing_dot = True
+    for label in labels:
+        s = ulabel(label)
+        if s:
+            result.append(s)
+        else:
+            raise IDNAError('Empty label')
+    if trailing_dot:
+        result.append(u'')
+    return u'.'.join(result)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/idnadata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/idnadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..a80c959d2a7127633cd696f86844d1f356a0bc83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/idnadata.py
@@ -0,0 +1,1979 @@
+# This file is automatically generated by tools/idna-data
+
+__version__ = "11.0.0"
+scripts = {
+    'Greek': (
+        0x37000000374,
+        0x37500000378,
+        0x37a0000037e,
+        0x37f00000380,
+        0x38400000385,
+        0x38600000387,
+        0x3880000038b,
+        0x38c0000038d,
+        0x38e000003a2,
+        0x3a3000003e2,
+        0x3f000000400,
+        0x1d2600001d2b,
+        0x1d5d00001d62,
+        0x1d6600001d6b,
+        0x1dbf00001dc0,
+        0x1f0000001f16,
+        0x1f1800001f1e,
+        0x1f2000001f46,
+        0x1f4800001f4e,
+        0x1f5000001f58,
+        0x1f5900001f5a,
+        0x1f5b00001f5c,
+        0x1f5d00001f5e,
+        0x1f5f00001f7e,
+        0x1f8000001fb5,
+        0x1fb600001fc5,
+        0x1fc600001fd4,
+        0x1fd600001fdc,
+        0x1fdd00001ff0,
+        0x1ff200001ff5,
+        0x1ff600001fff,
+        0x212600002127,
+        0xab650000ab66,
+        0x101400001018f,
+        0x101a0000101a1,
+        0x1d2000001d246,
+    ),
+    'Han': (
+        0x2e8000002e9a,
+        0x2e9b00002ef4,
+        0x2f0000002fd6,
+        0x300500003006,
+        0x300700003008,
+        0x30210000302a,
+        0x30380000303c,
+        0x340000004db6,
+        0x4e0000009ff0,
+        0xf9000000fa6e,
+        0xfa700000fada,
+        0x200000002a6d7,
+        0x2a7000002b735,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+        0x2f8000002fa1e,
+    ),
+    'Hebrew': (
+        0x591000005c8,
+        0x5d0000005eb,
+        0x5ef000005f5,
+        0xfb1d0000fb37,
+        0xfb380000fb3d,
+        0xfb3e0000fb3f,
+        0xfb400000fb42,
+        0xfb430000fb45,
+        0xfb460000fb50,
+    ),
+    'Hiragana': (
+        0x304100003097,
+        0x309d000030a0,
+        0x1b0010001b11f,
+        0x1f2000001f201,
+    ),
+    'Katakana': (
+        0x30a1000030fb,
+        0x30fd00003100,
+        0x31f000003200,
+        0x32d0000032ff,
+        0x330000003358,
+        0xff660000ff70,
+        0xff710000ff9e,
+        0x1b0000001b001,
+    ),
+}
+joining_types = {
+    0x600: 85,
+    0x601: 85,
+    0x602: 85,
+    0x603: 85,
+    0x604: 85,
+    0x605: 85,
+    0x608: 85,
+    0x60b: 85,
+    0x620: 68,
+    0x621: 85,
+    0x622: 82,
+    0x623: 82,
+    0x624: 82,
+    0x625: 82,
+    0x626: 68,
+    0x627: 82,
+    0x628: 68,
+    0x629: 82,
+    0x62a: 68,
+    0x62b: 68,
+    0x62c: 68,
+    0x62d: 68,
+    0x62e: 68,
+    0x62f: 82,
+    0x630: 82,
+    0x631: 82,
+    0x632: 82,
+    0x633: 68,
+    0x634: 68,
+    0x635: 68,
+    0x636: 68,
+    0x637: 68,
+    0x638: 68,
+    0x639: 68,
+    0x63a: 68,
+    0x63b: 68,
+    0x63c: 68,
+    0x63d: 68,
+    0x63e: 68,
+    0x63f: 68,
+    0x640: 67,
+    0x641: 68,
+    0x642: 68,
+    0x643: 68,
+    0x644: 68,
+    0x645: 68,
+    0x646: 68,
+    0x647: 68,
+    0x648: 82,
+    0x649: 68,
+    0x64a: 68,
+    0x66e: 68,
+    0x66f: 68,
+    0x671: 82,
+    0x672: 82,
+    0x673: 82,
+    0x674: 85,
+    0x675: 82,
+    0x676: 82,
+    0x677: 82,
+    0x678: 68,
+    0x679: 68,
+    0x67a: 68,
+    0x67b: 68,
+    0x67c: 68,
+    0x67d: 68,
+    0x67e: 68,
+    0x67f: 68,
+    0x680: 68,
+    0x681: 68,
+    0x682: 68,
+    0x683: 68,
+    0x684: 68,
+    0x685: 68,
+    0x686: 68,
+    0x687: 68,
+    0x688: 82,
+    0x689: 82,
+    0x68a: 82,
+    0x68b: 82,
+    0x68c: 82,
+    0x68d: 82,
+    0x68e: 82,
+    0x68f: 82,
+    0x690: 82,
+    0x691: 82,
+    0x692: 82,
+    0x693: 82,
+    0x694: 82,
+    0x695: 82,
+    0x696: 82,
+    0x697: 82,
+    0x698: 82,
+    0x699: 82,
+    0x69a: 68,
+    0x69b: 68,
+    0x69c: 68,
+    0x69d: 68,
+    0x69e: 68,
+    0x69f: 68,
+    0x6a0: 68,
+    0x6a1: 68,
+    0x6a2: 68,
+    0x6a3: 68,
+    0x6a4: 68,
+    0x6a5: 68,
+    0x6a6: 68,
+    0x6a7: 68,
+    0x6a8: 68,
+    0x6a9: 68,
+    0x6aa: 68,
+    0x6ab: 68,
+    0x6ac: 68,
+    0x6ad: 68,
+    0x6ae: 68,
+    0x6af: 68,
+    0x6b0: 68,
+    0x6b1: 68,
+    0x6b2: 68,
+    0x6b3: 68,
+    0x6b4: 68,
+    0x6b5: 68,
+    0x6b6: 68,
+    0x6b7: 68,
+    0x6b8: 68,
+    0x6b9: 68,
+    0x6ba: 68,
+    0x6bb: 68,
+    0x6bc: 68,
+    0x6bd: 68,
+    0x6be: 68,
+    0x6bf: 68,
+    0x6c0: 82,
+    0x6c1: 68,
+    0x6c2: 68,
+    0x6c3: 82,
+    0x6c4: 82,
+    0x6c5: 82,
+    0x6c6: 82,
+    0x6c7: 82,
+    0x6c8: 82,
+    0x6c9: 82,
+    0x6ca: 82,
+    0x6cb: 82,
+    0x6cc: 68,
+    0x6cd: 82,
+    0x6ce: 68,
+    0x6cf: 82,
+    0x6d0: 68,
+    0x6d1: 68,
+    0x6d2: 82,
+    0x6d3: 82,
+    0x6d5: 82,
+    0x6dd: 85,
+    0x6ee: 82,
+    0x6ef: 82,
+    0x6fa: 68,
+    0x6fb: 68,
+    0x6fc: 68,
+    0x6ff: 68,
+    0x70f: 84,
+    0x710: 82,
+    0x712: 68,
+    0x713: 68,
+    0x714: 68,
+    0x715: 82,
+    0x716: 82,
+    0x717: 82,
+    0x718: 82,
+    0x719: 82,
+    0x71a: 68,
+    0x71b: 68,
+    0x71c: 68,
+    0x71d: 68,
+    0x71e: 82,
+    0x71f: 68,
+    0x720: 68,
+    0x721: 68,
+    0x722: 68,
+    0x723: 68,
+    0x724: 68,
+    0x725: 68,
+    0x726: 68,
+    0x727: 68,
+    0x728: 82,
+    0x729: 68,
+    0x72a: 82,
+    0x72b: 68,
+    0x72c: 82,
+    0x72d: 68,
+    0x72e: 68,
+    0x72f: 82,
+    0x74d: 82,
+    0x74e: 68,
+    0x74f: 68,
+    0x750: 68,
+    0x751: 68,
+    0x752: 68,
+    0x753: 68,
+    0x754: 68,
+    0x755: 68,
+    0x756: 68,
+    0x757: 68,
+    0x758: 68,
+    0x759: 82,
+    0x75a: 82,
+    0x75b: 82,
+    0x75c: 68,
+    0x75d: 68,
+    0x75e: 68,
+    0x75f: 68,
+    0x760: 68,
+    0x761: 68,
+    0x762: 68,
+    0x763: 68,
+    0x764: 68,
+    0x765: 68,
+    0x766: 68,
+    0x767: 68,
+    0x768: 68,
+    0x769: 68,
+    0x76a: 68,
+    0x76b: 82,
+    0x76c: 82,
+    0x76d: 68,
+    0x76e: 68,
+    0x76f: 68,
+    0x770: 68,
+    0x771: 82,
+    0x772: 68,
+    0x773: 82,
+    0x774: 82,
+    0x775: 68,
+    0x776: 68,
+    0x777: 68,
+    0x778: 82,
+    0x779: 82,
+    0x77a: 68,
+    0x77b: 68,
+    0x77c: 68,
+    0x77d: 68,
+    0x77e: 68,
+    0x77f: 68,
+    0x7ca: 68,
+    0x7cb: 68,
+    0x7cc: 68,
+    0x7cd: 68,
+    0x7ce: 68,
+    0x7cf: 68,
+    0x7d0: 68,
+    0x7d1: 68,
+    0x7d2: 68,
+    0x7d3: 68,
+    0x7d4: 68,
+    0x7d5: 68,
+    0x7d6: 68,
+    0x7d7: 68,
+    0x7d8: 68,
+    0x7d9: 68,
+    0x7da: 68,
+    0x7db: 68,
+    0x7dc: 68,
+    0x7dd: 68,
+    0x7de: 68,
+    0x7df: 68,
+    0x7e0: 68,
+    0x7e1: 68,
+    0x7e2: 68,
+    0x7e3: 68,
+    0x7e4: 68,
+    0x7e5: 68,
+    0x7e6: 68,
+    0x7e7: 68,
+    0x7e8: 68,
+    0x7e9: 68,
+    0x7ea: 68,
+    0x7fa: 67,
+    0x840: 82,
+    0x841: 68,
+    0x842: 68,
+    0x843: 68,
+    0x844: 68,
+    0x845: 68,
+    0x846: 82,
+    0x847: 82,
+    0x848: 68,
+    0x849: 82,
+    0x84a: 68,
+    0x84b: 68,
+    0x84c: 68,
+    0x84d: 68,
+    0x84e: 68,
+    0x84f: 68,
+    0x850: 68,
+    0x851: 68,
+    0x852: 68,
+    0x853: 68,
+    0x854: 82,
+    0x855: 68,
+    0x856: 85,
+    0x857: 85,
+    0x858: 85,
+    0x860: 68,
+    0x861: 85,
+    0x862: 68,
+    0x863: 68,
+    0x864: 68,
+    0x865: 68,
+    0x866: 85,
+    0x867: 82,
+    0x868: 68,
+    0x869: 82,
+    0x86a: 82,
+    0x8a0: 68,
+    0x8a1: 68,
+    0x8a2: 68,
+    0x8a3: 68,
+    0x8a4: 68,
+    0x8a5: 68,
+    0x8a6: 68,
+    0x8a7: 68,
+    0x8a8: 68,
+    0x8a9: 68,
+    0x8aa: 82,
+    0x8ab: 82,
+    0x8ac: 82,
+    0x8ad: 85,
+    0x8ae: 82,
+    0x8af: 68,
+    0x8b0: 68,
+    0x8b1: 82,
+    0x8b2: 82,
+    0x8b3: 68,
+    0x8b4: 68,
+    0x8b6: 68,
+    0x8b7: 68,
+    0x8b8: 68,
+    0x8b9: 82,
+    0x8ba: 68,
+    0x8bb: 68,
+    0x8bc: 68,
+    0x8bd: 68,
+    0x8e2: 85,
+    0x1806: 85,
+    0x1807: 68,
+    0x180a: 67,
+    0x180e: 85,
+    0x1820: 68,
+    0x1821: 68,
+    0x1822: 68,
+    0x1823: 68,
+    0x1824: 68,
+    0x1825: 68,
+    0x1826: 68,
+    0x1827: 68,
+    0x1828: 68,
+    0x1829: 68,
+    0x182a: 68,
+    0x182b: 68,
+    0x182c: 68,
+    0x182d: 68,
+    0x182e: 68,
+    0x182f: 68,
+    0x1830: 68,
+    0x1831: 68,
+    0x1832: 68,
+    0x1833: 68,
+    0x1834: 68,
+    0x1835: 68,
+    0x1836: 68,
+    0x1837: 68,
+    0x1838: 68,
+    0x1839: 68,
+    0x183a: 68,
+    0x183b: 68,
+    0x183c: 68,
+    0x183d: 68,
+    0x183e: 68,
+    0x183f: 68,
+    0x1840: 68,
+    0x1841: 68,
+    0x1842: 68,
+    0x1843: 68,
+    0x1844: 68,
+    0x1845: 68,
+    0x1846: 68,
+    0x1847: 68,
+    0x1848: 68,
+    0x1849: 68,
+    0x184a: 68,
+    0x184b: 68,
+    0x184c: 68,
+    0x184d: 68,
+    0x184e: 68,
+    0x184f: 68,
+    0x1850: 68,
+    0x1851: 68,
+    0x1852: 68,
+    0x1853: 68,
+    0x1854: 68,
+    0x1855: 68,
+    0x1856: 68,
+    0x1857: 68,
+    0x1858: 68,
+    0x1859: 68,
+    0x185a: 68,
+    0x185b: 68,
+    0x185c: 68,
+    0x185d: 68,
+    0x185e: 68,
+    0x185f: 68,
+    0x1860: 68,
+    0x1861: 68,
+    0x1862: 68,
+    0x1863: 68,
+    0x1864: 68,
+    0x1865: 68,
+    0x1866: 68,
+    0x1867: 68,
+    0x1868: 68,
+    0x1869: 68,
+    0x186a: 68,
+    0x186b: 68,
+    0x186c: 68,
+    0x186d: 68,
+    0x186e: 68,
+    0x186f: 68,
+    0x1870: 68,
+    0x1871: 68,
+    0x1872: 68,
+    0x1873: 68,
+    0x1874: 68,
+    0x1875: 68,
+    0x1876: 68,
+    0x1877: 68,
+    0x1878: 68,
+    0x1880: 85,
+    0x1881: 85,
+    0x1882: 85,
+    0x1883: 85,
+    0x1884: 85,
+    0x1885: 84,
+    0x1886: 84,
+    0x1887: 68,
+    0x1888: 68,
+    0x1889: 68,
+    0x188a: 68,
+    0x188b: 68,
+    0x188c: 68,
+    0x188d: 68,
+    0x188e: 68,
+    0x188f: 68,
+    0x1890: 68,
+    0x1891: 68,
+    0x1892: 68,
+    0x1893: 68,
+    0x1894: 68,
+    0x1895: 68,
+    0x1896: 68,
+    0x1897: 68,
+    0x1898: 68,
+    0x1899: 68,
+    0x189a: 68,
+    0x189b: 68,
+    0x189c: 68,
+    0x189d: 68,
+    0x189e: 68,
+    0x189f: 68,
+    0x18a0: 68,
+    0x18a1: 68,
+    0x18a2: 68,
+    0x18a3: 68,
+    0x18a4: 68,
+    0x18a5: 68,
+    0x18a6: 68,
+    0x18a7: 68,
+    0x18a8: 68,
+    0x18aa: 68,
+    0x200c: 85,
+    0x200d: 67,
+    0x202f: 85,
+    0x2066: 85,
+    0x2067: 85,
+    0x2068: 85,
+    0x2069: 85,
+    0xa840: 68,
+    0xa841: 68,
+    0xa842: 68,
+    0xa843: 68,
+    0xa844: 68,
+    0xa845: 68,
+    0xa846: 68,
+    0xa847: 68,
+    0xa848: 68,
+    0xa849: 68,
+    0xa84a: 68,
+    0xa84b: 68,
+    0xa84c: 68,
+    0xa84d: 68,
+    0xa84e: 68,
+    0xa84f: 68,
+    0xa850: 68,
+    0xa851: 68,
+    0xa852: 68,
+    0xa853: 68,
+    0xa854: 68,
+    0xa855: 68,
+    0xa856: 68,
+    0xa857: 68,
+    0xa858: 68,
+    0xa859: 68,
+    0xa85a: 68,
+    0xa85b: 68,
+    0xa85c: 68,
+    0xa85d: 68,
+    0xa85e: 68,
+    0xa85f: 68,
+    0xa860: 68,
+    0xa861: 68,
+    0xa862: 68,
+    0xa863: 68,
+    0xa864: 68,
+    0xa865: 68,
+    0xa866: 68,
+    0xa867: 68,
+    0xa868: 68,
+    0xa869: 68,
+    0xa86a: 68,
+    0xa86b: 68,
+    0xa86c: 68,
+    0xa86d: 68,
+    0xa86e: 68,
+    0xa86f: 68,
+    0xa870: 68,
+    0xa871: 68,
+    0xa872: 76,
+    0xa873: 85,
+    0x10ac0: 68,
+    0x10ac1: 68,
+    0x10ac2: 68,
+    0x10ac3: 68,
+    0x10ac4: 68,
+    0x10ac5: 82,
+    0x10ac6: 85,
+    0x10ac7: 82,
+    0x10ac8: 85,
+    0x10ac9: 82,
+    0x10aca: 82,
+    0x10acb: 85,
+    0x10acc: 85,
+    0x10acd: 76,
+    0x10ace: 82,
+    0x10acf: 82,
+    0x10ad0: 82,
+    0x10ad1: 82,
+    0x10ad2: 82,
+    0x10ad3: 68,
+    0x10ad4: 68,
+    0x10ad5: 68,
+    0x10ad6: 68,
+    0x10ad7: 76,
+    0x10ad8: 68,
+    0x10ad9: 68,
+    0x10ada: 68,
+    0x10adb: 68,
+    0x10adc: 68,
+    0x10add: 82,
+    0x10ade: 68,
+    0x10adf: 68,
+    0x10ae0: 68,
+    0x10ae1: 82,
+    0x10ae2: 85,
+    0x10ae3: 85,
+    0x10ae4: 82,
+    0x10aeb: 68,
+    0x10aec: 68,
+    0x10aed: 68,
+    0x10aee: 68,
+    0x10aef: 82,
+    0x10b80: 68,
+    0x10b81: 82,
+    0x10b82: 68,
+    0x10b83: 82,
+    0x10b84: 82,
+    0x10b85: 82,
+    0x10b86: 68,
+    0x10b87: 68,
+    0x10b88: 68,
+    0x10b89: 82,
+    0x10b8a: 68,
+    0x10b8b: 68,
+    0x10b8c: 82,
+    0x10b8d: 68,
+    0x10b8e: 82,
+    0x10b8f: 82,
+    0x10b90: 68,
+    0x10b91: 82,
+    0x10ba9: 82,
+    0x10baa: 82,
+    0x10bab: 82,
+    0x10bac: 82,
+    0x10bad: 68,
+    0x10bae: 68,
+    0x10baf: 85,
+    0x10d00: 76,
+    0x10d01: 68,
+    0x10d02: 68,
+    0x10d03: 68,
+    0x10d04: 68,
+    0x10d05: 68,
+    0x10d06: 68,
+    0x10d07: 68,
+    0x10d08: 68,
+    0x10d09: 68,
+    0x10d0a: 68,
+    0x10d0b: 68,
+    0x10d0c: 68,
+    0x10d0d: 68,
+    0x10d0e: 68,
+    0x10d0f: 68,
+    0x10d10: 68,
+    0x10d11: 68,
+    0x10d12: 68,
+    0x10d13: 68,
+    0x10d14: 68,
+    0x10d15: 68,
+    0x10d16: 68,
+    0x10d17: 68,
+    0x10d18: 68,
+    0x10d19: 68,
+    0x10d1a: 68,
+    0x10d1b: 68,
+    0x10d1c: 68,
+    0x10d1d: 68,
+    0x10d1e: 68,
+    0x10d1f: 68,
+    0x10d20: 68,
+    0x10d21: 68,
+    0x10d22: 82,
+    0x10d23: 68,
+    0x10f30: 68,
+    0x10f31: 68,
+    0x10f32: 68,
+    0x10f33: 82,
+    0x10f34: 68,
+    0x10f35: 68,
+    0x10f36: 68,
+    0x10f37: 68,
+    0x10f38: 68,
+    0x10f39: 68,
+    0x10f3a: 68,
+    0x10f3b: 68,
+    0x10f3c: 68,
+    0x10f3d: 68,
+    0x10f3e: 68,
+    0x10f3f: 68,
+    0x10f40: 68,
+    0x10f41: 68,
+    0x10f42: 68,
+    0x10f43: 68,
+    0x10f44: 68,
+    0x10f45: 85,
+    0x10f51: 68,
+    0x10f52: 68,
+    0x10f53: 68,
+    0x10f54: 82,
+    0x110bd: 85,
+    0x110cd: 85,
+    0x1e900: 68,
+    0x1e901: 68,
+    0x1e902: 68,
+    0x1e903: 68,
+    0x1e904: 68,
+    0x1e905: 68,
+    0x1e906: 68,
+    0x1e907: 68,
+    0x1e908: 68,
+    0x1e909: 68,
+    0x1e90a: 68,
+    0x1e90b: 68,
+    0x1e90c: 68,
+    0x1e90d: 68,
+    0x1e90e: 68,
+    0x1e90f: 68,
+    0x1e910: 68,
+    0x1e911: 68,
+    0x1e912: 68,
+    0x1e913: 68,
+    0x1e914: 68,
+    0x1e915: 68,
+    0x1e916: 68,
+    0x1e917: 68,
+    0x1e918: 68,
+    0x1e919: 68,
+    0x1e91a: 68,
+    0x1e91b: 68,
+    0x1e91c: 68,
+    0x1e91d: 68,
+    0x1e91e: 68,
+    0x1e91f: 68,
+    0x1e920: 68,
+    0x1e921: 68,
+    0x1e922: 68,
+    0x1e923: 68,
+    0x1e924: 68,
+    0x1e925: 68,
+    0x1e926: 68,
+    0x1e927: 68,
+    0x1e928: 68,
+    0x1e929: 68,
+    0x1e92a: 68,
+    0x1e92b: 68,
+    0x1e92c: 68,
+    0x1e92d: 68,
+    0x1e92e: 68,
+    0x1e92f: 68,
+    0x1e930: 68,
+    0x1e931: 68,
+    0x1e932: 68,
+    0x1e933: 68,
+    0x1e934: 68,
+    0x1e935: 68,
+    0x1e936: 68,
+    0x1e937: 68,
+    0x1e938: 68,
+    0x1e939: 68,
+    0x1e93a: 68,
+    0x1e93b: 68,
+    0x1e93c: 68,
+    0x1e93d: 68,
+    0x1e93e: 68,
+    0x1e93f: 68,
+    0x1e940: 68,
+    0x1e941: 68,
+    0x1e942: 68,
+    0x1e943: 68,
+}
+codepoint_classes = {
+    'PVALID': (
+        0x2d0000002e,
+        0x300000003a,
+        0x610000007b,
+        0xdf000000f7,
+        0xf800000100,
+        0x10100000102,
+        0x10300000104,
+        0x10500000106,
+        0x10700000108,
+        0x1090000010a,
+        0x10b0000010c,
+        0x10d0000010e,
+        0x10f00000110,
+        0x11100000112,
+        0x11300000114,
+        0x11500000116,
+        0x11700000118,
+        0x1190000011a,
+        0x11b0000011c,
+        0x11d0000011e,
+        0x11f00000120,
+        0x12100000122,
+        0x12300000124,
+        0x12500000126,
+        0x12700000128,
+        0x1290000012a,
+        0x12b0000012c,
+        0x12d0000012e,
+        0x12f00000130,
+        0x13100000132,
+        0x13500000136,
+        0x13700000139,
+        0x13a0000013b,
+        0x13c0000013d,
+        0x13e0000013f,
+        0x14200000143,
+        0x14400000145,
+        0x14600000147,
+        0x14800000149,
+        0x14b0000014c,
+        0x14d0000014e,
+        0x14f00000150,
+        0x15100000152,
+        0x15300000154,
+        0x15500000156,
+        0x15700000158,
+        0x1590000015a,
+        0x15b0000015c,
+        0x15d0000015e,
+        0x15f00000160,
+        0x16100000162,
+        0x16300000164,
+        0x16500000166,
+        0x16700000168,
+        0x1690000016a,
+        0x16b0000016c,
+        0x16d0000016e,
+        0x16f00000170,
+        0x17100000172,
+        0x17300000174,
+        0x17500000176,
+        0x17700000178,
+        0x17a0000017b,
+        0x17c0000017d,
+        0x17e0000017f,
+        0x18000000181,
+        0x18300000184,
+        0x18500000186,
+        0x18800000189,
+        0x18c0000018e,
+        0x19200000193,
+        0x19500000196,
+        0x1990000019c,
+        0x19e0000019f,
+        0x1a1000001a2,
+        0x1a3000001a4,
+        0x1a5000001a6,
+        0x1a8000001a9,
+        0x1aa000001ac,
+        0x1ad000001ae,
+        0x1b0000001b1,
+        0x1b4000001b5,
+        0x1b6000001b7,
+        0x1b9000001bc,
+        0x1bd000001c4,
+        0x1ce000001cf,
+        0x1d0000001d1,
+        0x1d2000001d3,
+        0x1d4000001d5,
+        0x1d6000001d7,
+        0x1d8000001d9,
+        0x1da000001db,
+        0x1dc000001de,
+        0x1df000001e0,
+        0x1e1000001e2,
+        0x1e3000001e4,
+        0x1e5000001e6,
+        0x1e7000001e8,
+        0x1e9000001ea,
+        0x1eb000001ec,
+        0x1ed000001ee,
+        0x1ef000001f1,
+        0x1f5000001f6,
+        0x1f9000001fa,
+        0x1fb000001fc,
+        0x1fd000001fe,
+        0x1ff00000200,
+        0x20100000202,
+        0x20300000204,
+        0x20500000206,
+        0x20700000208,
+        0x2090000020a,
+        0x20b0000020c,
+        0x20d0000020e,
+        0x20f00000210,
+        0x21100000212,
+        0x21300000214,
+        0x21500000216,
+        0x21700000218,
+        0x2190000021a,
+        0x21b0000021c,
+        0x21d0000021e,
+        0x21f00000220,
+        0x22100000222,
+        0x22300000224,
+        0x22500000226,
+        0x22700000228,
+        0x2290000022a,
+        0x22b0000022c,
+        0x22d0000022e,
+        0x22f00000230,
+        0x23100000232,
+        0x2330000023a,
+        0x23c0000023d,
+        0x23f00000241,
+        0x24200000243,
+        0x24700000248,
+        0x2490000024a,
+        0x24b0000024c,
+        0x24d0000024e,
+        0x24f000002b0,
+        0x2b9000002c2,
+        0x2c6000002d2,
+        0x2ec000002ed,
+        0x2ee000002ef,
+        0x30000000340,
+        0x34200000343,
+        0x3460000034f,
+        0x35000000370,
+        0x37100000372,
+        0x37300000374,
+        0x37700000378,
+        0x37b0000037e,
+        0x39000000391,
+        0x3ac000003cf,
+        0x3d7000003d8,
+        0x3d9000003da,
+        0x3db000003dc,
+        0x3dd000003de,
+        0x3df000003e0,
+        0x3e1000003e2,
+        0x3e3000003e4,
+        0x3e5000003e6,
+        0x3e7000003e8,
+        0x3e9000003ea,
+        0x3eb000003ec,
+        0x3ed000003ee,
+        0x3ef000003f0,
+        0x3f3000003f4,
+        0x3f8000003f9,
+        0x3fb000003fd,
+        0x43000000460,
+        0x46100000462,
+        0x46300000464,
+        0x46500000466,
+        0x46700000468,
+        0x4690000046a,
+        0x46b0000046c,
+        0x46d0000046e,
+        0x46f00000470,
+        0x47100000472,
+        0x47300000474,
+        0x47500000476,
+        0x47700000478,
+        0x4790000047a,
+        0x47b0000047c,
+        0x47d0000047e,
+        0x47f00000480,
+        0x48100000482,
+        0x48300000488,
+        0x48b0000048c,
+        0x48d0000048e,
+        0x48f00000490,
+        0x49100000492,
+        0x49300000494,
+        0x49500000496,
+        0x49700000498,
+        0x4990000049a,
+        0x49b0000049c,
+        0x49d0000049e,
+        0x49f000004a0,
+        0x4a1000004a2,
+        0x4a3000004a4,
+        0x4a5000004a6,
+        0x4a7000004a8,
+        0x4a9000004aa,
+        0x4ab000004ac,
+        0x4ad000004ae,
+        0x4af000004b0,
+        0x4b1000004b2,
+        0x4b3000004b4,
+        0x4b5000004b6,
+        0x4b7000004b8,
+        0x4b9000004ba,
+        0x4bb000004bc,
+        0x4bd000004be,
+        0x4bf000004c0,
+        0x4c2000004c3,
+        0x4c4000004c5,
+        0x4c6000004c7,
+        0x4c8000004c9,
+        0x4ca000004cb,
+        0x4cc000004cd,
+        0x4ce000004d0,
+        0x4d1000004d2,
+        0x4d3000004d4,
+        0x4d5000004d6,
+        0x4d7000004d8,
+        0x4d9000004da,
+        0x4db000004dc,
+        0x4dd000004de,
+        0x4df000004e0,
+        0x4e1000004e2,
+        0x4e3000004e4,
+        0x4e5000004e6,
+        0x4e7000004e8,
+        0x4e9000004ea,
+        0x4eb000004ec,
+        0x4ed000004ee,
+        0x4ef000004f0,
+        0x4f1000004f2,
+        0x4f3000004f4,
+        0x4f5000004f6,
+        0x4f7000004f8,
+        0x4f9000004fa,
+        0x4fb000004fc,
+        0x4fd000004fe,
+        0x4ff00000500,
+        0x50100000502,
+        0x50300000504,
+        0x50500000506,
+        0x50700000508,
+        0x5090000050a,
+        0x50b0000050c,
+        0x50d0000050e,
+        0x50f00000510,
+        0x51100000512,
+        0x51300000514,
+        0x51500000516,
+        0x51700000518,
+        0x5190000051a,
+        0x51b0000051c,
+        0x51d0000051e,
+        0x51f00000520,
+        0x52100000522,
+        0x52300000524,
+        0x52500000526,
+        0x52700000528,
+        0x5290000052a,
+        0x52b0000052c,
+        0x52d0000052e,
+        0x52f00000530,
+        0x5590000055a,
+        0x56000000587,
+        0x58800000589,
+        0x591000005be,
+        0x5bf000005c0,
+        0x5c1000005c3,
+        0x5c4000005c6,
+        0x5c7000005c8,
+        0x5d0000005eb,
+        0x5ef000005f3,
+        0x6100000061b,
+        0x62000000640,
+        0x64100000660,
+        0x66e00000675,
+        0x679000006d4,
+        0x6d5000006dd,
+        0x6df000006e9,
+        0x6ea000006f0,
+        0x6fa00000700,
+        0x7100000074b,
+        0x74d000007b2,
+        0x7c0000007f6,
+        0x7fd000007fe,
+        0x8000000082e,
+        0x8400000085c,
+        0x8600000086b,
+        0x8a0000008b5,
+        0x8b6000008be,
+        0x8d3000008e2,
+        0x8e300000958,
+        0x96000000964,
+        0x96600000970,
+        0x97100000984,
+        0x9850000098d,
+        0x98f00000991,
+        0x993000009a9,
+        0x9aa000009b1,
+        0x9b2000009b3,
+        0x9b6000009ba,
+        0x9bc000009c5,
+        0x9c7000009c9,
+        0x9cb000009cf,
+        0x9d7000009d8,
+        0x9e0000009e4,
+        0x9e6000009f2,
+        0x9fc000009fd,
+        0x9fe000009ff,
+        0xa0100000a04,
+        0xa0500000a0b,
+        0xa0f00000a11,
+        0xa1300000a29,
+        0xa2a00000a31,
+        0xa3200000a33,
+        0xa3500000a36,
+        0xa3800000a3a,
+        0xa3c00000a3d,
+        0xa3e00000a43,
+        0xa4700000a49,
+        0xa4b00000a4e,
+        0xa5100000a52,
+        0xa5c00000a5d,
+        0xa6600000a76,
+        0xa8100000a84,
+        0xa8500000a8e,
+        0xa8f00000a92,
+        0xa9300000aa9,
+        0xaaa00000ab1,
+        0xab200000ab4,
+        0xab500000aba,
+        0xabc00000ac6,
+        0xac700000aca,
+        0xacb00000ace,
+        0xad000000ad1,
+        0xae000000ae4,
+        0xae600000af0,
+        0xaf900000b00,
+        0xb0100000b04,
+        0xb0500000b0d,
+        0xb0f00000b11,
+        0xb1300000b29,
+        0xb2a00000b31,
+        0xb3200000b34,
+        0xb3500000b3a,
+        0xb3c00000b45,
+        0xb4700000b49,
+        0xb4b00000b4e,
+        0xb5600000b58,
+        0xb5f00000b64,
+        0xb6600000b70,
+        0xb7100000b72,
+        0xb8200000b84,
+        0xb8500000b8b,
+        0xb8e00000b91,
+        0xb9200000b96,
+        0xb9900000b9b,
+        0xb9c00000b9d,
+        0xb9e00000ba0,
+        0xba300000ba5,
+        0xba800000bab,
+        0xbae00000bba,
+        0xbbe00000bc3,
+        0xbc600000bc9,
+        0xbca00000bce,
+        0xbd000000bd1,
+        0xbd700000bd8,
+        0xbe600000bf0,
+        0xc0000000c0d,
+        0xc0e00000c11,
+        0xc1200000c29,
+        0xc2a00000c3a,
+        0xc3d00000c45,
+        0xc4600000c49,
+        0xc4a00000c4e,
+        0xc5500000c57,
+        0xc5800000c5b,
+        0xc6000000c64,
+        0xc6600000c70,
+        0xc8000000c84,
+        0xc8500000c8d,
+        0xc8e00000c91,
+        0xc9200000ca9,
+        0xcaa00000cb4,
+        0xcb500000cba,
+        0xcbc00000cc5,
+        0xcc600000cc9,
+        0xcca00000cce,
+        0xcd500000cd7,
+        0xcde00000cdf,
+        0xce000000ce4,
+        0xce600000cf0,
+        0xcf100000cf3,
+        0xd0000000d04,
+        0xd0500000d0d,
+        0xd0e00000d11,
+        0xd1200000d45,
+        0xd4600000d49,
+        0xd4a00000d4f,
+        0xd5400000d58,
+        0xd5f00000d64,
+        0xd6600000d70,
+        0xd7a00000d80,
+        0xd8200000d84,
+        0xd8500000d97,
+        0xd9a00000db2,
+        0xdb300000dbc,
+        0xdbd00000dbe,
+        0xdc000000dc7,
+        0xdca00000dcb,
+        0xdcf00000dd5,
+        0xdd600000dd7,
+        0xdd800000de0,
+        0xde600000df0,
+        0xdf200000df4,
+        0xe0100000e33,
+        0xe3400000e3b,
+        0xe4000000e4f,
+        0xe5000000e5a,
+        0xe8100000e83,
+        0xe8400000e85,
+        0xe8700000e89,
+        0xe8a00000e8b,
+        0xe8d00000e8e,
+        0xe9400000e98,
+        0xe9900000ea0,
+        0xea100000ea4,
+        0xea500000ea6,
+        0xea700000ea8,
+        0xeaa00000eac,
+        0xead00000eb3,
+        0xeb400000eba,
+        0xebb00000ebe,
+        0xec000000ec5,
+        0xec600000ec7,
+        0xec800000ece,
+        0xed000000eda,
+        0xede00000ee0,
+        0xf0000000f01,
+        0xf0b00000f0c,
+        0xf1800000f1a,
+        0xf2000000f2a,
+        0xf3500000f36,
+        0xf3700000f38,
+        0xf3900000f3a,
+        0xf3e00000f43,
+        0xf4400000f48,
+        0xf4900000f4d,
+        0xf4e00000f52,
+        0xf5300000f57,
+        0xf5800000f5c,
+        0xf5d00000f69,
+        0xf6a00000f6d,
+        0xf7100000f73,
+        0xf7400000f75,
+        0xf7a00000f81,
+        0xf8200000f85,
+        0xf8600000f93,
+        0xf9400000f98,
+        0xf9900000f9d,
+        0xf9e00000fa2,
+        0xfa300000fa7,
+        0xfa800000fac,
+        0xfad00000fb9,
+        0xfba00000fbd,
+        0xfc600000fc7,
+        0x10000000104a,
+        0x10500000109e,
+        0x10d0000010fb,
+        0x10fd00001100,
+        0x120000001249,
+        0x124a0000124e,
+        0x125000001257,
+        0x125800001259,
+        0x125a0000125e,
+        0x126000001289,
+        0x128a0000128e,
+        0x1290000012b1,
+        0x12b2000012b6,
+        0x12b8000012bf,
+        0x12c0000012c1,
+        0x12c2000012c6,
+        0x12c8000012d7,
+        0x12d800001311,
+        0x131200001316,
+        0x13180000135b,
+        0x135d00001360,
+        0x138000001390,
+        0x13a0000013f6,
+        0x14010000166d,
+        0x166f00001680,
+        0x16810000169b,
+        0x16a0000016eb,
+        0x16f1000016f9,
+        0x17000000170d,
+        0x170e00001715,
+        0x172000001735,
+        0x174000001754,
+        0x17600000176d,
+        0x176e00001771,
+        0x177200001774,
+        0x1780000017b4,
+        0x17b6000017d4,
+        0x17d7000017d8,
+        0x17dc000017de,
+        0x17e0000017ea,
+        0x18100000181a,
+        0x182000001879,
+        0x1880000018ab,
+        0x18b0000018f6,
+        0x19000000191f,
+        0x19200000192c,
+        0x19300000193c,
+        0x19460000196e,
+        0x197000001975,
+        0x1980000019ac,
+        0x19b0000019ca,
+        0x19d0000019da,
+        0x1a0000001a1c,
+        0x1a2000001a5f,
+        0x1a6000001a7d,
+        0x1a7f00001a8a,
+        0x1a9000001a9a,
+        0x1aa700001aa8,
+        0x1ab000001abe,
+        0x1b0000001b4c,
+        0x1b5000001b5a,
+        0x1b6b00001b74,
+        0x1b8000001bf4,
+        0x1c0000001c38,
+        0x1c4000001c4a,
+        0x1c4d00001c7e,
+        0x1cd000001cd3,
+        0x1cd400001cfa,
+        0x1d0000001d2c,
+        0x1d2f00001d30,
+        0x1d3b00001d3c,
+        0x1d4e00001d4f,
+        0x1d6b00001d78,
+        0x1d7900001d9b,
+        0x1dc000001dfa,
+        0x1dfb00001e00,
+        0x1e0100001e02,
+        0x1e0300001e04,
+        0x1e0500001e06,
+        0x1e0700001e08,
+        0x1e0900001e0a,
+        0x1e0b00001e0c,
+        0x1e0d00001e0e,
+        0x1e0f00001e10,
+        0x1e1100001e12,
+        0x1e1300001e14,
+        0x1e1500001e16,
+        0x1e1700001e18,
+        0x1e1900001e1a,
+        0x1e1b00001e1c,
+        0x1e1d00001e1e,
+        0x1e1f00001e20,
+        0x1e2100001e22,
+        0x1e2300001e24,
+        0x1e2500001e26,
+        0x1e2700001e28,
+        0x1e2900001e2a,
+        0x1e2b00001e2c,
+        0x1e2d00001e2e,
+        0x1e2f00001e30,
+        0x1e3100001e32,
+        0x1e3300001e34,
+        0x1e3500001e36,
+        0x1e3700001e38,
+        0x1e3900001e3a,
+        0x1e3b00001e3c,
+        0x1e3d00001e3e,
+        0x1e3f00001e40,
+        0x1e4100001e42,
+        0x1e4300001e44,
+        0x1e4500001e46,
+        0x1e4700001e48,
+        0x1e4900001e4a,
+        0x1e4b00001e4c,
+        0x1e4d00001e4e,
+        0x1e4f00001e50,
+        0x1e5100001e52,
+        0x1e5300001e54,
+        0x1e5500001e56,
+        0x1e5700001e58,
+        0x1e5900001e5a,
+        0x1e5b00001e5c,
+        0x1e5d00001e5e,
+        0x1e5f00001e60,
+        0x1e6100001e62,
+        0x1e6300001e64,
+        0x1e6500001e66,
+        0x1e6700001e68,
+        0x1e6900001e6a,
+        0x1e6b00001e6c,
+        0x1e6d00001e6e,
+        0x1e6f00001e70,
+        0x1e7100001e72,
+        0x1e7300001e74,
+        0x1e7500001e76,
+        0x1e7700001e78,
+        0x1e7900001e7a,
+        0x1e7b00001e7c,
+        0x1e7d00001e7e,
+        0x1e7f00001e80,
+        0x1e8100001e82,
+        0x1e8300001e84,
+        0x1e8500001e86,
+        0x1e8700001e88,
+        0x1e8900001e8a,
+        0x1e8b00001e8c,
+        0x1e8d00001e8e,
+        0x1e8f00001e90,
+        0x1e9100001e92,
+        0x1e9300001e94,
+        0x1e9500001e9a,
+        0x1e9c00001e9e,
+        0x1e9f00001ea0,
+        0x1ea100001ea2,
+        0x1ea300001ea4,
+        0x1ea500001ea6,
+        0x1ea700001ea8,
+        0x1ea900001eaa,
+        0x1eab00001eac,
+        0x1ead00001eae,
+        0x1eaf00001eb0,
+        0x1eb100001eb2,
+        0x1eb300001eb4,
+        0x1eb500001eb6,
+        0x1eb700001eb8,
+        0x1eb900001eba,
+        0x1ebb00001ebc,
+        0x1ebd00001ebe,
+        0x1ebf00001ec0,
+        0x1ec100001ec2,
+        0x1ec300001ec4,
+        0x1ec500001ec6,
+        0x1ec700001ec8,
+        0x1ec900001eca,
+        0x1ecb00001ecc,
+        0x1ecd00001ece,
+        0x1ecf00001ed0,
+        0x1ed100001ed2,
+        0x1ed300001ed4,
+        0x1ed500001ed6,
+        0x1ed700001ed8,
+        0x1ed900001eda,
+        0x1edb00001edc,
+        0x1edd00001ede,
+        0x1edf00001ee0,
+        0x1ee100001ee2,
+        0x1ee300001ee4,
+        0x1ee500001ee6,
+        0x1ee700001ee8,
+        0x1ee900001eea,
+        0x1eeb00001eec,
+        0x1eed00001eee,
+        0x1eef00001ef0,
+        0x1ef100001ef2,
+        0x1ef300001ef4,
+        0x1ef500001ef6,
+        0x1ef700001ef8,
+        0x1ef900001efa,
+        0x1efb00001efc,
+        0x1efd00001efe,
+        0x1eff00001f08,
+        0x1f1000001f16,
+        0x1f2000001f28,
+        0x1f3000001f38,
+        0x1f4000001f46,
+        0x1f5000001f58,
+        0x1f6000001f68,
+        0x1f7000001f71,
+        0x1f7200001f73,
+        0x1f7400001f75,
+        0x1f7600001f77,
+        0x1f7800001f79,
+        0x1f7a00001f7b,
+        0x1f7c00001f7d,
+        0x1fb000001fb2,
+        0x1fb600001fb7,
+        0x1fc600001fc7,
+        0x1fd000001fd3,
+        0x1fd600001fd8,
+        0x1fe000001fe3,
+        0x1fe400001fe8,
+        0x1ff600001ff7,
+        0x214e0000214f,
+        0x218400002185,
+        0x2c3000002c5f,
+        0x2c6100002c62,
+        0x2c6500002c67,
+        0x2c6800002c69,
+        0x2c6a00002c6b,
+        0x2c6c00002c6d,
+        0x2c7100002c72,
+        0x2c7300002c75,
+        0x2c7600002c7c,
+        0x2c8100002c82,
+        0x2c8300002c84,
+        0x2c8500002c86,
+        0x2c8700002c88,
+        0x2c8900002c8a,
+        0x2c8b00002c8c,
+        0x2c8d00002c8e,
+        0x2c8f00002c90,
+        0x2c9100002c92,
+        0x2c9300002c94,
+        0x2c9500002c96,
+        0x2c9700002c98,
+        0x2c9900002c9a,
+        0x2c9b00002c9c,
+        0x2c9d00002c9e,
+        0x2c9f00002ca0,
+        0x2ca100002ca2,
+        0x2ca300002ca4,
+        0x2ca500002ca6,
+        0x2ca700002ca8,
+        0x2ca900002caa,
+        0x2cab00002cac,
+        0x2cad00002cae,
+        0x2caf00002cb0,
+        0x2cb100002cb2,
+        0x2cb300002cb4,
+        0x2cb500002cb6,
+        0x2cb700002cb8,
+        0x2cb900002cba,
+        0x2cbb00002cbc,
+        0x2cbd00002cbe,
+        0x2cbf00002cc0,
+        0x2cc100002cc2,
+        0x2cc300002cc4,
+        0x2cc500002cc6,
+        0x2cc700002cc8,
+        0x2cc900002cca,
+        0x2ccb00002ccc,
+        0x2ccd00002cce,
+        0x2ccf00002cd0,
+        0x2cd100002cd2,
+        0x2cd300002cd4,
+        0x2cd500002cd6,
+        0x2cd700002cd8,
+        0x2cd900002cda,
+        0x2cdb00002cdc,
+        0x2cdd00002cde,
+        0x2cdf00002ce0,
+        0x2ce100002ce2,
+        0x2ce300002ce5,
+        0x2cec00002ced,
+        0x2cee00002cf2,
+        0x2cf300002cf4,
+        0x2d0000002d26,
+        0x2d2700002d28,
+        0x2d2d00002d2e,
+        0x2d3000002d68,
+        0x2d7f00002d97,
+        0x2da000002da7,
+        0x2da800002daf,
+        0x2db000002db7,
+        0x2db800002dbf,
+        0x2dc000002dc7,
+        0x2dc800002dcf,
+        0x2dd000002dd7,
+        0x2dd800002ddf,
+        0x2de000002e00,
+        0x2e2f00002e30,
+        0x300500003008,
+        0x302a0000302e,
+        0x303c0000303d,
+        0x304100003097,
+        0x30990000309b,
+        0x309d0000309f,
+        0x30a1000030fb,
+        0x30fc000030ff,
+        0x310500003130,
+        0x31a0000031bb,
+        0x31f000003200,
+        0x340000004db6,
+        0x4e0000009ff0,
+        0xa0000000a48d,
+        0xa4d00000a4fe,
+        0xa5000000a60d,
+        0xa6100000a62c,
+        0xa6410000a642,
+        0xa6430000a644,
+        0xa6450000a646,
+        0xa6470000a648,
+        0xa6490000a64a,
+        0xa64b0000a64c,
+        0xa64d0000a64e,
+        0xa64f0000a650,
+        0xa6510000a652,
+        0xa6530000a654,
+        0xa6550000a656,
+        0xa6570000a658,
+        0xa6590000a65a,
+        0xa65b0000a65c,
+        0xa65d0000a65e,
+        0xa65f0000a660,
+        0xa6610000a662,
+        0xa6630000a664,
+        0xa6650000a666,
+        0xa6670000a668,
+        0xa6690000a66a,
+        0xa66b0000a66c,
+        0xa66d0000a670,
+        0xa6740000a67e,
+        0xa67f0000a680,
+        0xa6810000a682,
+        0xa6830000a684,
+        0xa6850000a686,
+        0xa6870000a688,
+        0xa6890000a68a,
+        0xa68b0000a68c,
+        0xa68d0000a68e,
+        0xa68f0000a690,
+        0xa6910000a692,
+        0xa6930000a694,
+        0xa6950000a696,
+        0xa6970000a698,
+        0xa6990000a69a,
+        0xa69b0000a69c,
+        0xa69e0000a6e6,
+        0xa6f00000a6f2,
+        0xa7170000a720,
+        0xa7230000a724,
+        0xa7250000a726,
+        0xa7270000a728,
+        0xa7290000a72a,
+        0xa72b0000a72c,
+        0xa72d0000a72e,
+        0xa72f0000a732,
+        0xa7330000a734,
+        0xa7350000a736,
+        0xa7370000a738,
+        0xa7390000a73a,
+        0xa73b0000a73c,
+        0xa73d0000a73e,
+        0xa73f0000a740,
+        0xa7410000a742,
+        0xa7430000a744,
+        0xa7450000a746,
+        0xa7470000a748,
+        0xa7490000a74a,
+        0xa74b0000a74c,
+        0xa74d0000a74e,
+        0xa74f0000a750,
+        0xa7510000a752,
+        0xa7530000a754,
+        0xa7550000a756,
+        0xa7570000a758,
+        0xa7590000a75a,
+        0xa75b0000a75c,
+        0xa75d0000a75e,
+        0xa75f0000a760,
+        0xa7610000a762,
+        0xa7630000a764,
+        0xa7650000a766,
+        0xa7670000a768,
+        0xa7690000a76a,
+        0xa76b0000a76c,
+        0xa76d0000a76e,
+        0xa76f0000a770,
+        0xa7710000a779,
+        0xa77a0000a77b,
+        0xa77c0000a77d,
+        0xa77f0000a780,
+        0xa7810000a782,
+        0xa7830000a784,
+        0xa7850000a786,
+        0xa7870000a789,
+        0xa78c0000a78d,
+        0xa78e0000a790,
+        0xa7910000a792,
+        0xa7930000a796,
+        0xa7970000a798,
+        0xa7990000a79a,
+        0xa79b0000a79c,
+        0xa79d0000a79e,
+        0xa79f0000a7a0,
+        0xa7a10000a7a2,
+        0xa7a30000a7a4,
+        0xa7a50000a7a6,
+        0xa7a70000a7a8,
+        0xa7a90000a7aa,
+        0xa7af0000a7b0,
+        0xa7b50000a7b6,
+        0xa7b70000a7b8,
+        0xa7b90000a7ba,
+        0xa7f70000a7f8,
+        0xa7fa0000a828,
+        0xa8400000a874,
+        0xa8800000a8c6,
+        0xa8d00000a8da,
+        0xa8e00000a8f8,
+        0xa8fb0000a8fc,
+        0xa8fd0000a92e,
+        0xa9300000a954,
+        0xa9800000a9c1,
+        0xa9cf0000a9da,
+        0xa9e00000a9ff,
+        0xaa000000aa37,
+        0xaa400000aa4e,
+        0xaa500000aa5a,
+        0xaa600000aa77,
+        0xaa7a0000aac3,
+        0xaadb0000aade,
+        0xaae00000aaf0,
+        0xaaf20000aaf7,
+        0xab010000ab07,
+        0xab090000ab0f,
+        0xab110000ab17,
+        0xab200000ab27,
+        0xab280000ab2f,
+        0xab300000ab5b,
+        0xab600000ab66,
+        0xabc00000abeb,
+        0xabec0000abee,
+        0xabf00000abfa,
+        0xac000000d7a4,
+        0xfa0e0000fa10,
+        0xfa110000fa12,
+        0xfa130000fa15,
+        0xfa1f0000fa20,
+        0xfa210000fa22,
+        0xfa230000fa25,
+        0xfa270000fa2a,
+        0xfb1e0000fb1f,
+        0xfe200000fe30,
+        0xfe730000fe74,
+        0x100000001000c,
+        0x1000d00010027,
+        0x100280001003b,
+        0x1003c0001003e,
+        0x1003f0001004e,
+        0x100500001005e,
+        0x10080000100fb,
+        0x101fd000101fe,
+        0x102800001029d,
+        0x102a0000102d1,
+        0x102e0000102e1,
+        0x1030000010320,
+        0x1032d00010341,
+        0x103420001034a,
+        0x103500001037b,
+        0x103800001039e,
+        0x103a0000103c4,
+        0x103c8000103d0,
+        0x104280001049e,
+        0x104a0000104aa,
+        0x104d8000104fc,
+        0x1050000010528,
+        0x1053000010564,
+        0x1060000010737,
+        0x1074000010756,
+        0x1076000010768,
+        0x1080000010806,
+        0x1080800010809,
+        0x1080a00010836,
+        0x1083700010839,
+        0x1083c0001083d,
+        0x1083f00010856,
+        0x1086000010877,
+        0x108800001089f,
+        0x108e0000108f3,
+        0x108f4000108f6,
+        0x1090000010916,
+        0x109200001093a,
+        0x10980000109b8,
+        0x109be000109c0,
+        0x10a0000010a04,
+        0x10a0500010a07,
+        0x10a0c00010a14,
+        0x10a1500010a18,
+        0x10a1900010a36,
+        0x10a3800010a3b,
+        0x10a3f00010a40,
+        0x10a6000010a7d,
+        0x10a8000010a9d,
+        0x10ac000010ac8,
+        0x10ac900010ae7,
+        0x10b0000010b36,
+        0x10b4000010b56,
+        0x10b6000010b73,
+        0x10b8000010b92,
+        0x10c0000010c49,
+        0x10cc000010cf3,
+        0x10d0000010d28,
+        0x10d3000010d3a,
+        0x10f0000010f1d,
+        0x10f2700010f28,
+        0x10f3000010f51,
+        0x1100000011047,
+        0x1106600011070,
+        0x1107f000110bb,
+        0x110d0000110e9,
+        0x110f0000110fa,
+        0x1110000011135,
+        0x1113600011140,
+        0x1114400011147,
+        0x1115000011174,
+        0x1117600011177,
+        0x11180000111c5,
+        0x111c9000111cd,
+        0x111d0000111db,
+        0x111dc000111dd,
+        0x1120000011212,
+        0x1121300011238,
+        0x1123e0001123f,
+        0x1128000011287,
+        0x1128800011289,
+        0x1128a0001128e,
+        0x1128f0001129e,
+        0x1129f000112a9,
+        0x112b0000112eb,
+        0x112f0000112fa,
+        0x1130000011304,
+        0x113050001130d,
+        0x1130f00011311,
+        0x1131300011329,
+        0x1132a00011331,
+        0x1133200011334,
+        0x113350001133a,
+        0x1133b00011345,
+        0x1134700011349,
+        0x1134b0001134e,
+        0x1135000011351,
+        0x1135700011358,
+        0x1135d00011364,
+        0x113660001136d,
+        0x1137000011375,
+        0x114000001144b,
+        0x114500001145a,
+        0x1145e0001145f,
+        0x11480000114c6,
+        0x114c7000114c8,
+        0x114d0000114da,
+        0x11580000115b6,
+        0x115b8000115c1,
+        0x115d8000115de,
+        0x1160000011641,
+        0x1164400011645,
+        0x116500001165a,
+        0x11680000116b8,
+        0x116c0000116ca,
+        0x117000001171b,
+        0x1171d0001172c,
+        0x117300001173a,
+        0x118000001183b,
+        0x118c0000118ea,
+        0x118ff00011900,
+        0x11a0000011a3f,
+        0x11a4700011a48,
+        0x11a5000011a84,
+        0x11a8600011a9a,
+        0x11a9d00011a9e,
+        0x11ac000011af9,
+        0x11c0000011c09,
+        0x11c0a00011c37,
+        0x11c3800011c41,
+        0x11c5000011c5a,
+        0x11c7200011c90,
+        0x11c9200011ca8,
+        0x11ca900011cb7,
+        0x11d0000011d07,
+        0x11d0800011d0a,
+        0x11d0b00011d37,
+        0x11d3a00011d3b,
+        0x11d3c00011d3e,
+        0x11d3f00011d48,
+        0x11d5000011d5a,
+        0x11d6000011d66,
+        0x11d6700011d69,
+        0x11d6a00011d8f,
+        0x11d9000011d92,
+        0x11d9300011d99,
+        0x11da000011daa,
+        0x11ee000011ef7,
+        0x120000001239a,
+        0x1248000012544,
+        0x130000001342f,
+        0x1440000014647,
+        0x1680000016a39,
+        0x16a4000016a5f,
+        0x16a6000016a6a,
+        0x16ad000016aee,
+        0x16af000016af5,
+        0x16b0000016b37,
+        0x16b4000016b44,
+        0x16b5000016b5a,
+        0x16b6300016b78,
+        0x16b7d00016b90,
+        0x16e6000016e80,
+        0x16f0000016f45,
+        0x16f5000016f7f,
+        0x16f8f00016fa0,
+        0x16fe000016fe2,
+        0x17000000187f2,
+        0x1880000018af3,
+        0x1b0000001b11f,
+        0x1b1700001b2fc,
+        0x1bc000001bc6b,
+        0x1bc700001bc7d,
+        0x1bc800001bc89,
+        0x1bc900001bc9a,
+        0x1bc9d0001bc9f,
+        0x1da000001da37,
+        0x1da3b0001da6d,
+        0x1da750001da76,
+        0x1da840001da85,
+        0x1da9b0001daa0,
+        0x1daa10001dab0,
+        0x1e0000001e007,
+        0x1e0080001e019,
+        0x1e01b0001e022,
+        0x1e0230001e025,
+        0x1e0260001e02b,
+        0x1e8000001e8c5,
+        0x1e8d00001e8d7,
+        0x1e9220001e94b,
+        0x1e9500001e95a,
+        0x200000002a6d7,
+        0x2a7000002b735,
+        0x2b7400002b81e,
+        0x2b8200002cea2,
+        0x2ceb00002ebe1,
+    ),
+    'CONTEXTJ': (
+        0x200c0000200e,
+    ),
+    'CONTEXTO': (
+        0xb7000000b8,
+        0x37500000376,
+        0x5f3000005f5,
+        0x6600000066a,
+        0x6f0000006fa,
+        0x30fb000030fc,
+    ),
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/intranges.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/intranges.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa8a735662d0afc1950ba75bc57e99e8480dac88
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/intranges.py
@@ -0,0 +1,53 @@
+"""
+Given a list of integers, made up of (hopefully) a small number of long runs
+of consecutive integers, compute a representation of the form
+((start1, end1), (start2, end2) ...). Then answer the question "was x present
+in the original list?" in time O(log(# runs)).
+"""
+
+import bisect
+
+def intranges_from_list(list_):
+    """Represent a list of integers as a sequence of ranges:
+    ((start_0, end_0), (start_1, end_1), ...), such that the original
+    integers are exactly those x such that start_i <= x < end_i for some i.
+
+    Ranges are encoded as single integers (start << 32 | end), not as tuples.
+    """
+
+    sorted_list = sorted(list_)
+    ranges = []
+    last_write = -1
+    for i in range(len(sorted_list)):
+        if i+1 < len(sorted_list):
+            if sorted_list[i] == sorted_list[i+1]-1:
+                continue
+        current_range = sorted_list[last_write+1:i+1]
+        ranges.append(_encode_range(current_range[0], current_range[-1] + 1))
+        last_write = i
+
+    return tuple(ranges)
+
+def _encode_range(start, end):
+    return (start << 32) | end
+
+def _decode_range(r):
+    return (r >> 32), (r & ((1 << 32) - 1))
+
+
+def intranges_contain(int_, ranges):
+    """Determine if `int_` falls into one of the ranges in `ranges`."""
+    tuple_ = _encode_range(int_, 0)
+    pos = bisect.bisect_left(ranges, tuple_)
+    # we could be immediately ahead of a tuple (start, end)
+    # with start < int_ <= end
+    if pos > 0:
+        left, right = _decode_range(ranges[pos-1])
+        if left <= int_ < right:
+            return True
+    # or we could be immediately behind a tuple (int_, end)
+    if pos < len(ranges):
+        left, _ = _decode_range(ranges[pos])
+        if left == int_:
+            return True
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/package_data.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/package_data.py
new file mode 100644
index 0000000000000000000000000000000000000000..257e8989393055bec9bf86010828fb8bab7a9645
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/package_data.py
@@ -0,0 +1,2 @@
+__version__ = '2.8'
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/uts46data.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/uts46data.py
new file mode 100644
index 0000000000000000000000000000000000000000..a68ed4c0ec3d3a5ffd400dbe8ffb0ec470eb2b66
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/idna/uts46data.py
@@ -0,0 +1,8205 @@
+# This file is automatically generated by tools/idna-data
+# vim: set fileencoding=utf-8 :
+
+"""IDNA Mapping Table from UTS46."""
+
+
+__version__ = "11.0.0"
+def _seg_0():
+    return [
+    (0x0, '3'),
+    (0x1, '3'),
+    (0x2, '3'),
+    (0x3, '3'),
+    (0x4, '3'),
+    (0x5, '3'),
+    (0x6, '3'),
+    (0x7, '3'),
+    (0x8, '3'),
+    (0x9, '3'),
+    (0xA, '3'),
+    (0xB, '3'),
+    (0xC, '3'),
+    (0xD, '3'),
+    (0xE, '3'),
+    (0xF, '3'),
+    (0x10, '3'),
+    (0x11, '3'),
+    (0x12, '3'),
+    (0x13, '3'),
+    (0x14, '3'),
+    (0x15, '3'),
+    (0x16, '3'),
+    (0x17, '3'),
+    (0x18, '3'),
+    (0x19, '3'),
+    (0x1A, '3'),
+    (0x1B, '3'),
+    (0x1C, '3'),
+    (0x1D, '3'),
+    (0x1E, '3'),
+    (0x1F, '3'),
+    (0x20, '3'),
+    (0x21, '3'),
+    (0x22, '3'),
+    (0x23, '3'),
+    (0x24, '3'),
+    (0x25, '3'),
+    (0x26, '3'),
+    (0x27, '3'),
+    (0x28, '3'),
+    (0x29, '3'),
+    (0x2A, '3'),
+    (0x2B, '3'),
+    (0x2C, '3'),
+    (0x2D, 'V'),
+    (0x2E, 'V'),
+    (0x2F, '3'),
+    (0x30, 'V'),
+    (0x31, 'V'),
+    (0x32, 'V'),
+    (0x33, 'V'),
+    (0x34, 'V'),
+    (0x35, 'V'),
+    (0x36, 'V'),
+    (0x37, 'V'),
+    (0x38, 'V'),
+    (0x39, 'V'),
+    (0x3A, '3'),
+    (0x3B, '3'),
+    (0x3C, '3'),
+    (0x3D, '3'),
+    (0x3E, '3'),
+    (0x3F, '3'),
+    (0x40, '3'),
+    (0x41, 'M', u'a'),
+    (0x42, 'M', u'b'),
+    (0x43, 'M', u'c'),
+    (0x44, 'M', u'd'),
+    (0x45, 'M', u'e'),
+    (0x46, 'M', u'f'),
+    (0x47, 'M', u'g'),
+    (0x48, 'M', u'h'),
+    (0x49, 'M', u'i'),
+    (0x4A, 'M', u'j'),
+    (0x4B, 'M', u'k'),
+    (0x4C, 'M', u'l'),
+    (0x4D, 'M', u'm'),
+    (0x4E, 'M', u'n'),
+    (0x4F, 'M', u'o'),
+    (0x50, 'M', u'p'),
+    (0x51, 'M', u'q'),
+    (0x52, 'M', u'r'),
+    (0x53, 'M', u's'),
+    (0x54, 'M', u't'),
+    (0x55, 'M', u'u'),
+    (0x56, 'M', u'v'),
+    (0x57, 'M', u'w'),
+    (0x58, 'M', u'x'),
+    (0x59, 'M', u'y'),
+    (0x5A, 'M', u'z'),
+    (0x5B, '3'),
+    (0x5C, '3'),
+    (0x5D, '3'),
+    (0x5E, '3'),
+    (0x5F, '3'),
+    (0x60, '3'),
+    (0x61, 'V'),
+    (0x62, 'V'),
+    (0x63, 'V'),
+    ]
+
+def _seg_1():
+    return [
+    (0x64, 'V'),
+    (0x65, 'V'),
+    (0x66, 'V'),
+    (0x67, 'V'),
+    (0x68, 'V'),
+    (0x69, 'V'),
+    (0x6A, 'V'),
+    (0x6B, 'V'),
+    (0x6C, 'V'),
+    (0x6D, 'V'),
+    (0x6E, 'V'),
+    (0x6F, 'V'),
+    (0x70, 'V'),
+    (0x71, 'V'),
+    (0x72, 'V'),
+    (0x73, 'V'),
+    (0x74, 'V'),
+    (0x75, 'V'),
+    (0x76, 'V'),
+    (0x77, 'V'),
+    (0x78, 'V'),
+    (0x79, 'V'),
+    (0x7A, 'V'),
+    (0x7B, '3'),
+    (0x7C, '3'),
+    (0x7D, '3'),
+    (0x7E, '3'),
+    (0x7F, '3'),
+    (0x80, 'X'),
+    (0x81, 'X'),
+    (0x82, 'X'),
+    (0x83, 'X'),
+    (0x84, 'X'),
+    (0x85, 'X'),
+    (0x86, 'X'),
+    (0x87, 'X'),
+    (0x88, 'X'),
+    (0x89, 'X'),
+    (0x8A, 'X'),
+    (0x8B, 'X'),
+    (0x8C, 'X'),
+    (0x8D, 'X'),
+    (0x8E, 'X'),
+    (0x8F, 'X'),
+    (0x90, 'X'),
+    (0x91, 'X'),
+    (0x92, 'X'),
+    (0x93, 'X'),
+    (0x94, 'X'),
+    (0x95, 'X'),
+    (0x96, 'X'),
+    (0x97, 'X'),
+    (0x98, 'X'),
+    (0x99, 'X'),
+    (0x9A, 'X'),
+    (0x9B, 'X'),
+    (0x9C, 'X'),
+    (0x9D, 'X'),
+    (0x9E, 'X'),
+    (0x9F, 'X'),
+    (0xA0, '3', u' '),
+    (0xA1, 'V'),
+    (0xA2, 'V'),
+    (0xA3, 'V'),
+    (0xA4, 'V'),
+    (0xA5, 'V'),
+    (0xA6, 'V'),
+    (0xA7, 'V'),
+    (0xA8, '3', u' ̈'),
+    (0xA9, 'V'),
+    (0xAA, 'M', u'a'),
+    (0xAB, 'V'),
+    (0xAC, 'V'),
+    (0xAD, 'I'),
+    (0xAE, 'V'),
+    (0xAF, '3', u' ̄'),
+    (0xB0, 'V'),
+    (0xB1, 'V'),
+    (0xB2, 'M', u'2'),
+    (0xB3, 'M', u'3'),
+    (0xB4, '3', u' ́'),
+    (0xB5, 'M', u'μ'),
+    (0xB6, 'V'),
+    (0xB7, 'V'),
+    (0xB8, '3', u' ̧'),
+    (0xB9, 'M', u'1'),
+    (0xBA, 'M', u'o'),
+    (0xBB, 'V'),
+    (0xBC, 'M', u'1⁄4'),
+    (0xBD, 'M', u'1⁄2'),
+    (0xBE, 'M', u'3⁄4'),
+    (0xBF, 'V'),
+    (0xC0, 'M', u'à'),
+    (0xC1, 'M', u'á'),
+    (0xC2, 'M', u'â'),
+    (0xC3, 'M', u'ã'),
+    (0xC4, 'M', u'ä'),
+    (0xC5, 'M', u'å'),
+    (0xC6, 'M', u'æ'),
+    (0xC7, 'M', u'ç'),
+    ]
+
+def _seg_2():
+    return [
+    (0xC8, 'M', u'è'),
+    (0xC9, 'M', u'é'),
+    (0xCA, 'M', u'ê'),
+    (0xCB, 'M', u'ë'),
+    (0xCC, 'M', u'ì'),
+    (0xCD, 'M', u'í'),
+    (0xCE, 'M', u'î'),
+    (0xCF, 'M', u'ï'),
+    (0xD0, 'M', u'ð'),
+    (0xD1, 'M', u'ñ'),
+    (0xD2, 'M', u'ò'),
+    (0xD3, 'M', u'ó'),
+    (0xD4, 'M', u'ô'),
+    (0xD5, 'M', u'õ'),
+    (0xD6, 'M', u'ö'),
+    (0xD7, 'V'),
+    (0xD8, 'M', u'ø'),
+    (0xD9, 'M', u'ù'),
+    (0xDA, 'M', u'ú'),
+    (0xDB, 'M', u'û'),
+    (0xDC, 'M', u'ü'),
+    (0xDD, 'M', u'ý'),
+    (0xDE, 'M', u'þ'),
+    (0xDF, 'D', u'ss'),
+    (0xE0, 'V'),
+    (0xE1, 'V'),
+    (0xE2, 'V'),
+    (0xE3, 'V'),
+    (0xE4, 'V'),
+    (0xE5, 'V'),
+    (0xE6, 'V'),
+    (0xE7, 'V'),
+    (0xE8, 'V'),
+    (0xE9, 'V'),
+    (0xEA, 'V'),
+    (0xEB, 'V'),
+    (0xEC, 'V'),
+    (0xED, 'V'),
+    (0xEE, 'V'),
+    (0xEF, 'V'),
+    (0xF0, 'V'),
+    (0xF1, 'V'),
+    (0xF2, 'V'),
+    (0xF3, 'V'),
+    (0xF4, 'V'),
+    (0xF5, 'V'),
+    (0xF6, 'V'),
+    (0xF7, 'V'),
+    (0xF8, 'V'),
+    (0xF9, 'V'),
+    (0xFA, 'V'),
+    (0xFB, 'V'),
+    (0xFC, 'V'),
+    (0xFD, 'V'),
+    (0xFE, 'V'),
+    (0xFF, 'V'),
+    (0x100, 'M', u'ā'),
+    (0x101, 'V'),
+    (0x102, 'M', u'ă'),
+    (0x103, 'V'),
+    (0x104, 'M', u'ą'),
+    (0x105, 'V'),
+    (0x106, 'M', u'ć'),
+    (0x107, 'V'),
+    (0x108, 'M', u'ĉ'),
+    (0x109, 'V'),
+    (0x10A, 'M', u'ċ'),
+    (0x10B, 'V'),
+    (0x10C, 'M', u'č'),
+    (0x10D, 'V'),
+    (0x10E, 'M', u'ď'),
+    (0x10F, 'V'),
+    (0x110, 'M', u'đ'),
+    (0x111, 'V'),
+    (0x112, 'M', u'ē'),
+    (0x113, 'V'),
+    (0x114, 'M', u'ĕ'),
+    (0x115, 'V'),
+    (0x116, 'M', u'ė'),
+    (0x117, 'V'),
+    (0x118, 'M', u'ę'),
+    (0x119, 'V'),
+    (0x11A, 'M', u'ě'),
+    (0x11B, 'V'),
+    (0x11C, 'M', u'ĝ'),
+    (0x11D, 'V'),
+    (0x11E, 'M', u'ğ'),
+    (0x11F, 'V'),
+    (0x120, 'M', u'ġ'),
+    (0x121, 'V'),
+    (0x122, 'M', u'ģ'),
+    (0x123, 'V'),
+    (0x124, 'M', u'ĥ'),
+    (0x125, 'V'),
+    (0x126, 'M', u'ħ'),
+    (0x127, 'V'),
+    (0x128, 'M', u'ĩ'),
+    (0x129, 'V'),
+    (0x12A, 'M', u'ī'),
+    (0x12B, 'V'),
+    ]
+
+def _seg_3():
+    return [
+    (0x12C, 'M', u'ĭ'),
+    (0x12D, 'V'),
+    (0x12E, 'M', u'į'),
+    (0x12F, 'V'),
+    (0x130, 'M', u'i̇'),
+    (0x131, 'V'),
+    (0x132, 'M', u'ij'),
+    (0x134, 'M', u'ĵ'),
+    (0x135, 'V'),
+    (0x136, 'M', u'ķ'),
+    (0x137, 'V'),
+    (0x139, 'M', u'ĺ'),
+    (0x13A, 'V'),
+    (0x13B, 'M', u'ļ'),
+    (0x13C, 'V'),
+    (0x13D, 'M', u'ľ'),
+    (0x13E, 'V'),
+    (0x13F, 'M', u'l·'),
+    (0x141, 'M', u'ł'),
+    (0x142, 'V'),
+    (0x143, 'M', u'ń'),
+    (0x144, 'V'),
+    (0x145, 'M', u'ņ'),
+    (0x146, 'V'),
+    (0x147, 'M', u'ň'),
+    (0x148, 'V'),
+    (0x149, 'M', u'ʼn'),
+    (0x14A, 'M', u'ŋ'),
+    (0x14B, 'V'),
+    (0x14C, 'M', u'ō'),
+    (0x14D, 'V'),
+    (0x14E, 'M', u'ŏ'),
+    (0x14F, 'V'),
+    (0x150, 'M', u'ő'),
+    (0x151, 'V'),
+    (0x152, 'M', u'œ'),
+    (0x153, 'V'),
+    (0x154, 'M', u'ŕ'),
+    (0x155, 'V'),
+    (0x156, 'M', u'ŗ'),
+    (0x157, 'V'),
+    (0x158, 'M', u'ř'),
+    (0x159, 'V'),
+    (0x15A, 'M', u'ś'),
+    (0x15B, 'V'),
+    (0x15C, 'M', u'ŝ'),
+    (0x15D, 'V'),
+    (0x15E, 'M', u'ş'),
+    (0x15F, 'V'),
+    (0x160, 'M', u'š'),
+    (0x161, 'V'),
+    (0x162, 'M', u'ţ'),
+    (0x163, 'V'),
+    (0x164, 'M', u'ť'),
+    (0x165, 'V'),
+    (0x166, 'M', u'ŧ'),
+    (0x167, 'V'),
+    (0x168, 'M', u'ũ'),
+    (0x169, 'V'),
+    (0x16A, 'M', u'ū'),
+    (0x16B, 'V'),
+    (0x16C, 'M', u'ŭ'),
+    (0x16D, 'V'),
+    (0x16E, 'M', u'ů'),
+    (0x16F, 'V'),
+    (0x170, 'M', u'ű'),
+    (0x171, 'V'),
+    (0x172, 'M', u'ų'),
+    (0x173, 'V'),
+    (0x174, 'M', u'ŵ'),
+    (0x175, 'V'),
+    (0x176, 'M', u'ŷ'),
+    (0x177, 'V'),
+    (0x178, 'M', u'ÿ'),
+    (0x179, 'M', u'ź'),
+    (0x17A, 'V'),
+    (0x17B, 'M', u'ż'),
+    (0x17C, 'V'),
+    (0x17D, 'M', u'ž'),
+    (0x17E, 'V'),
+    (0x17F, 'M', u's'),
+    (0x180, 'V'),
+    (0x181, 'M', u'ɓ'),
+    (0x182, 'M', u'ƃ'),
+    (0x183, 'V'),
+    (0x184, 'M', u'ƅ'),
+    (0x185, 'V'),
+    (0x186, 'M', u'ɔ'),
+    (0x187, 'M', u'ƈ'),
+    (0x188, 'V'),
+    (0x189, 'M', u'ɖ'),
+    (0x18A, 'M', u'ɗ'),
+    (0x18B, 'M', u'ƌ'),
+    (0x18C, 'V'),
+    (0x18E, 'M', u'ǝ'),
+    (0x18F, 'M', u'ə'),
+    (0x190, 'M', u'ɛ'),
+    (0x191, 'M', u'ƒ'),
+    (0x192, 'V'),
+    (0x193, 'M', u'ɠ'),
+    ]
+
+def _seg_4():
+    return [
+    (0x194, 'M', u'ɣ'),
+    (0x195, 'V'),
+    (0x196, 'M', u'ɩ'),
+    (0x197, 'M', u'ɨ'),
+    (0x198, 'M', u'ƙ'),
+    (0x199, 'V'),
+    (0x19C, 'M', u'ɯ'),
+    (0x19D, 'M', u'ɲ'),
+    (0x19E, 'V'),
+    (0x19F, 'M', u'ɵ'),
+    (0x1A0, 'M', u'ơ'),
+    (0x1A1, 'V'),
+    (0x1A2, 'M', u'ƣ'),
+    (0x1A3, 'V'),
+    (0x1A4, 'M', u'ƥ'),
+    (0x1A5, 'V'),
+    (0x1A6, 'M', u'ʀ'),
+    (0x1A7, 'M', u'ƨ'),
+    (0x1A8, 'V'),
+    (0x1A9, 'M', u'ʃ'),
+    (0x1AA, 'V'),
+    (0x1AC, 'M', u'ƭ'),
+    (0x1AD, 'V'),
+    (0x1AE, 'M', u'ʈ'),
+    (0x1AF, 'M', u'ư'),
+    (0x1B0, 'V'),
+    (0x1B1, 'M', u'ʊ'),
+    (0x1B2, 'M', u'ʋ'),
+    (0x1B3, 'M', u'ƴ'),
+    (0x1B4, 'V'),
+    (0x1B5, 'M', u'ƶ'),
+    (0x1B6, 'V'),
+    (0x1B7, 'M', u'ʒ'),
+    (0x1B8, 'M', u'ƹ'),
+    (0x1B9, 'V'),
+    (0x1BC, 'M', u'ƽ'),
+    (0x1BD, 'V'),
+    (0x1C4, 'M', u'dž'),
+    (0x1C7, 'M', u'lj'),
+    (0x1CA, 'M', u'nj'),
+    (0x1CD, 'M', u'ǎ'),
+    (0x1CE, 'V'),
+    (0x1CF, 'M', u'ǐ'),
+    (0x1D0, 'V'),
+    (0x1D1, 'M', u'ǒ'),
+    (0x1D2, 'V'),
+    (0x1D3, 'M', u'ǔ'),
+    (0x1D4, 'V'),
+    (0x1D5, 'M', u'ǖ'),
+    (0x1D6, 'V'),
+    (0x1D7, 'M', u'ǘ'),
+    (0x1D8, 'V'),
+    (0x1D9, 'M', u'ǚ'),
+    (0x1DA, 'V'),
+    (0x1DB, 'M', u'ǜ'),
+    (0x1DC, 'V'),
+    (0x1DE, 'M', u'ǟ'),
+    (0x1DF, 'V'),
+    (0x1E0, 'M', u'ǡ'),
+    (0x1E1, 'V'),
+    (0x1E2, 'M', u'ǣ'),
+    (0x1E3, 'V'),
+    (0x1E4, 'M', u'ǥ'),
+    (0x1E5, 'V'),
+    (0x1E6, 'M', u'ǧ'),
+    (0x1E7, 'V'),
+    (0x1E8, 'M', u'ǩ'),
+    (0x1E9, 'V'),
+    (0x1EA, 'M', u'ǫ'),
+    (0x1EB, 'V'),
+    (0x1EC, 'M', u'ǭ'),
+    (0x1ED, 'V'),
+    (0x1EE, 'M', u'ǯ'),
+    (0x1EF, 'V'),
+    (0x1F1, 'M', u'dz'),
+    (0x1F4, 'M', u'ǵ'),
+    (0x1F5, 'V'),
+    (0x1F6, 'M', u'ƕ'),
+    (0x1F7, 'M', u'ƿ'),
+    (0x1F8, 'M', u'ǹ'),
+    (0x1F9, 'V'),
+    (0x1FA, 'M', u'ǻ'),
+    (0x1FB, 'V'),
+    (0x1FC, 'M', u'ǽ'),
+    (0x1FD, 'V'),
+    (0x1FE, 'M', u'ǿ'),
+    (0x1FF, 'V'),
+    (0x200, 'M', u'ȁ'),
+    (0x201, 'V'),
+    (0x202, 'M', u'ȃ'),
+    (0x203, 'V'),
+    (0x204, 'M', u'ȅ'),
+    (0x205, 'V'),
+    (0x206, 'M', u'ȇ'),
+    (0x207, 'V'),
+    (0x208, 'M', u'ȉ'),
+    (0x209, 'V'),
+    (0x20A, 'M', u'ȋ'),
+    (0x20B, 'V'),
+    (0x20C, 'M', u'ȍ'),
+    ]
+
+def _seg_5():
+    return [
+    (0x20D, 'V'),
+    (0x20E, 'M', u'ȏ'),
+    (0x20F, 'V'),
+    (0x210, 'M', u'ȑ'),
+    (0x211, 'V'),
+    (0x212, 'M', u'ȓ'),
+    (0x213, 'V'),
+    (0x214, 'M', u'ȕ'),
+    (0x215, 'V'),
+    (0x216, 'M', u'ȗ'),
+    (0x217, 'V'),
+    (0x218, 'M', u'ș'),
+    (0x219, 'V'),
+    (0x21A, 'M', u'ț'),
+    (0x21B, 'V'),
+    (0x21C, 'M', u'ȝ'),
+    (0x21D, 'V'),
+    (0x21E, 'M', u'ȟ'),
+    (0x21F, 'V'),
+    (0x220, 'M', u'ƞ'),
+    (0x221, 'V'),
+    (0x222, 'M', u'ȣ'),
+    (0x223, 'V'),
+    (0x224, 'M', u'ȥ'),
+    (0x225, 'V'),
+    (0x226, 'M', u'ȧ'),
+    (0x227, 'V'),
+    (0x228, 'M', u'ȩ'),
+    (0x229, 'V'),
+    (0x22A, 'M', u'ȫ'),
+    (0x22B, 'V'),
+    (0x22C, 'M', u'ȭ'),
+    (0x22D, 'V'),
+    (0x22E, 'M', u'ȯ'),
+    (0x22F, 'V'),
+    (0x230, 'M', u'ȱ'),
+    (0x231, 'V'),
+    (0x232, 'M', u'ȳ'),
+    (0x233, 'V'),
+    (0x23A, 'M', u'ⱥ'),
+    (0x23B, 'M', u'ȼ'),
+    (0x23C, 'V'),
+    (0x23D, 'M', u'ƚ'),
+    (0x23E, 'M', u'ⱦ'),
+    (0x23F, 'V'),
+    (0x241, 'M', u'ɂ'),
+    (0x242, 'V'),
+    (0x243, 'M', u'ƀ'),
+    (0x244, 'M', u'ʉ'),
+    (0x245, 'M', u'ʌ'),
+    (0x246, 'M', u'ɇ'),
+    (0x247, 'V'),
+    (0x248, 'M', u'ɉ'),
+    (0x249, 'V'),
+    (0x24A, 'M', u'ɋ'),
+    (0x24B, 'V'),
+    (0x24C, 'M', u'ɍ'),
+    (0x24D, 'V'),
+    (0x24E, 'M', u'ɏ'),
+    (0x24F, 'V'),
+    (0x2B0, 'M', u'h'),
+    (0x2B1, 'M', u'ɦ'),
+    (0x2B2, 'M', u'j'),
+    (0x2B3, 'M', u'r'),
+    (0x2B4, 'M', u'ɹ'),
+    (0x2B5, 'M', u'ɻ'),
+    (0x2B6, 'M', u'ʁ'),
+    (0x2B7, 'M', u'w'),
+    (0x2B8, 'M', u'y'),
+    (0x2B9, 'V'),
+    (0x2D8, '3', u' ̆'),
+    (0x2D9, '3', u' ̇'),
+    (0x2DA, '3', u' ̊'),
+    (0x2DB, '3', u' ̨'),
+    (0x2DC, '3', u' ̃'),
+    (0x2DD, '3', u' ̋'),
+    (0x2DE, 'V'),
+    (0x2E0, 'M', u'ɣ'),
+    (0x2E1, 'M', u'l'),
+    (0x2E2, 'M', u's'),
+    (0x2E3, 'M', u'x'),
+    (0x2E4, 'M', u'ʕ'),
+    (0x2E5, 'V'),
+    (0x340, 'M', u'̀'),
+    (0x341, 'M', u'́'),
+    (0x342, 'V'),
+    (0x343, 'M', u'̓'),
+    (0x344, 'M', u'̈́'),
+    (0x345, 'M', u'ι'),
+    (0x346, 'V'),
+    (0x34F, 'I'),
+    (0x350, 'V'),
+    (0x370, 'M', u'ͱ'),
+    (0x371, 'V'),
+    (0x372, 'M', u'ͳ'),
+    (0x373, 'V'),
+    (0x374, 'M', u'ʹ'),
+    (0x375, 'V'),
+    (0x376, 'M', u'ͷ'),
+    (0x377, 'V'),
+    ]
+
+def _seg_6():
+    return [
+    (0x378, 'X'),
+    (0x37A, '3', u' ι'),
+    (0x37B, 'V'),
+    (0x37E, '3', u';'),
+    (0x37F, 'M', u'ϳ'),
+    (0x380, 'X'),
+    (0x384, '3', u' ́'),
+    (0x385, '3', u' ̈́'),
+    (0x386, 'M', u'ά'),
+    (0x387, 'M', u'·'),
+    (0x388, 'M', u'έ'),
+    (0x389, 'M', u'ή'),
+    (0x38A, 'M', u'ί'),
+    (0x38B, 'X'),
+    (0x38C, 'M', u'ό'),
+    (0x38D, 'X'),
+    (0x38E, 'M', u'ύ'),
+    (0x38F, 'M', u'ώ'),
+    (0x390, 'V'),
+    (0x391, 'M', u'α'),
+    (0x392, 'M', u'β'),
+    (0x393, 'M', u'γ'),
+    (0x394, 'M', u'δ'),
+    (0x395, 'M', u'ε'),
+    (0x396, 'M', u'ζ'),
+    (0x397, 'M', u'η'),
+    (0x398, 'M', u'θ'),
+    (0x399, 'M', u'ι'),
+    (0x39A, 'M', u'κ'),
+    (0x39B, 'M', u'λ'),
+    (0x39C, 'M', u'μ'),
+    (0x39D, 'M', u'ν'),
+    (0x39E, 'M', u'ξ'),
+    (0x39F, 'M', u'ο'),
+    (0x3A0, 'M', u'π'),
+    (0x3A1, 'M', u'ρ'),
+    (0x3A2, 'X'),
+    (0x3A3, 'M', u'σ'),
+    (0x3A4, 'M', u'τ'),
+    (0x3A5, 'M', u'υ'),
+    (0x3A6, 'M', u'φ'),
+    (0x3A7, 'M', u'χ'),
+    (0x3A8, 'M', u'ψ'),
+    (0x3A9, 'M', u'ω'),
+    (0x3AA, 'M', u'ϊ'),
+    (0x3AB, 'M', u'ϋ'),
+    (0x3AC, 'V'),
+    (0x3C2, 'D', u'σ'),
+    (0x3C3, 'V'),
+    (0x3CF, 'M', u'ϗ'),
+    (0x3D0, 'M', u'β'),
+    (0x3D1, 'M', u'θ'),
+    (0x3D2, 'M', u'υ'),
+    (0x3D3, 'M', u'ύ'),
+    (0x3D4, 'M', u'ϋ'),
+    (0x3D5, 'M', u'φ'),
+    (0x3D6, 'M', u'π'),
+    (0x3D7, 'V'),
+    (0x3D8, 'M', u'ϙ'),
+    (0x3D9, 'V'),
+    (0x3DA, 'M', u'ϛ'),
+    (0x3DB, 'V'),
+    (0x3DC, 'M', u'ϝ'),
+    (0x3DD, 'V'),
+    (0x3DE, 'M', u'ϟ'),
+    (0x3DF, 'V'),
+    (0x3E0, 'M', u'ϡ'),
+    (0x3E1, 'V'),
+    (0x3E2, 'M', u'ϣ'),
+    (0x3E3, 'V'),
+    (0x3E4, 'M', u'ϥ'),
+    (0x3E5, 'V'),
+    (0x3E6, 'M', u'ϧ'),
+    (0x3E7, 'V'),
+    (0x3E8, 'M', u'ϩ'),
+    (0x3E9, 'V'),
+    (0x3EA, 'M', u'ϫ'),
+    (0x3EB, 'V'),
+    (0x3EC, 'M', u'ϭ'),
+    (0x3ED, 'V'),
+    (0x3EE, 'M', u'ϯ'),
+    (0x3EF, 'V'),
+    (0x3F0, 'M', u'κ'),
+    (0x3F1, 'M', u'ρ'),
+    (0x3F2, 'M', u'σ'),
+    (0x3F3, 'V'),
+    (0x3F4, 'M', u'θ'),
+    (0x3F5, 'M', u'ε'),
+    (0x3F6, 'V'),
+    (0x3F7, 'M', u'ϸ'),
+    (0x3F8, 'V'),
+    (0x3F9, 'M', u'σ'),
+    (0x3FA, 'M', u'ϻ'),
+    (0x3FB, 'V'),
+    (0x3FD, 'M', u'ͻ'),
+    (0x3FE, 'M', u'ͼ'),
+    (0x3FF, 'M', u'ͽ'),
+    (0x400, 'M', u'ѐ'),
+    (0x401, 'M', u'ё'),
+    (0x402, 'M', u'ђ'),
+    ]
+
+def _seg_7():
+    return [
+    (0x403, 'M', u'ѓ'),
+    (0x404, 'M', u'є'),
+    (0x405, 'M', u'ѕ'),
+    (0x406, 'M', u'і'),
+    (0x407, 'M', u'ї'),
+    (0x408, 'M', u'ј'),
+    (0x409, 'M', u'љ'),
+    (0x40A, 'M', u'њ'),
+    (0x40B, 'M', u'ћ'),
+    (0x40C, 'M', u'ќ'),
+    (0x40D, 'M', u'ѝ'),
+    (0x40E, 'M', u'ў'),
+    (0x40F, 'M', u'џ'),
+    (0x410, 'M', u'а'),
+    (0x411, 'M', u'б'),
+    (0x412, 'M', u'в'),
+    (0x413, 'M', u'г'),
+    (0x414, 'M', u'д'),
+    (0x415, 'M', u'е'),
+    (0x416, 'M', u'ж'),
+    (0x417, 'M', u'з'),
+    (0x418, 'M', u'и'),
+    (0x419, 'M', u'й'),
+    (0x41A, 'M', u'к'),
+    (0x41B, 'M', u'л'),
+    (0x41C, 'M', u'м'),
+    (0x41D, 'M', u'н'),
+    (0x41E, 'M', u'о'),
+    (0x41F, 'M', u'п'),
+    (0x420, 'M', u'р'),
+    (0x421, 'M', u'с'),
+    (0x422, 'M', u'т'),
+    (0x423, 'M', u'у'),
+    (0x424, 'M', u'ф'),
+    (0x425, 'M', u'х'),
+    (0x426, 'M', u'ц'),
+    (0x427, 'M', u'ч'),
+    (0x428, 'M', u'ш'),
+    (0x429, 'M', u'щ'),
+    (0x42A, 'M', u'ъ'),
+    (0x42B, 'M', u'ы'),
+    (0x42C, 'M', u'ь'),
+    (0x42D, 'M', u'э'),
+    (0x42E, 'M', u'ю'),
+    (0x42F, 'M', u'я'),
+    (0x430, 'V'),
+    (0x460, 'M', u'ѡ'),
+    (0x461, 'V'),
+    (0x462, 'M', u'ѣ'),
+    (0x463, 'V'),
+    (0x464, 'M', u'ѥ'),
+    (0x465, 'V'),
+    (0x466, 'M', u'ѧ'),
+    (0x467, 'V'),
+    (0x468, 'M', u'ѩ'),
+    (0x469, 'V'),
+    (0x46A, 'M', u'ѫ'),
+    (0x46B, 'V'),
+    (0x46C, 'M', u'ѭ'),
+    (0x46D, 'V'),
+    (0x46E, 'M', u'ѯ'),
+    (0x46F, 'V'),
+    (0x470, 'M', u'ѱ'),
+    (0x471, 'V'),
+    (0x472, 'M', u'ѳ'),
+    (0x473, 'V'),
+    (0x474, 'M', u'ѵ'),
+    (0x475, 'V'),
+    (0x476, 'M', u'ѷ'),
+    (0x477, 'V'),
+    (0x478, 'M', u'ѹ'),
+    (0x479, 'V'),
+    (0x47A, 'M', u'ѻ'),
+    (0x47B, 'V'),
+    (0x47C, 'M', u'ѽ'),
+    (0x47D, 'V'),
+    (0x47E, 'M', u'ѿ'),
+    (0x47F, 'V'),
+    (0x480, 'M', u'ҁ'),
+    (0x481, 'V'),
+    (0x48A, 'M', u'ҋ'),
+    (0x48B, 'V'),
+    (0x48C, 'M', u'ҍ'),
+    (0x48D, 'V'),
+    (0x48E, 'M', u'ҏ'),
+    (0x48F, 'V'),
+    (0x490, 'M', u'ґ'),
+    (0x491, 'V'),
+    (0x492, 'M', u'ғ'),
+    (0x493, 'V'),
+    (0x494, 'M', u'ҕ'),
+    (0x495, 'V'),
+    (0x496, 'M', u'җ'),
+    (0x497, 'V'),
+    (0x498, 'M', u'ҙ'),
+    (0x499, 'V'),
+    (0x49A, 'M', u'қ'),
+    (0x49B, 'V'),
+    (0x49C, 'M', u'ҝ'),
+    (0x49D, 'V'),
+    ]
+
+def _seg_8():
+    return [
+    (0x49E, 'M', u'ҟ'),
+    (0x49F, 'V'),
+    (0x4A0, 'M', u'ҡ'),
+    (0x4A1, 'V'),
+    (0x4A2, 'M', u'ң'),
+    (0x4A3, 'V'),
+    (0x4A4, 'M', u'ҥ'),
+    (0x4A5, 'V'),
+    (0x4A6, 'M', u'ҧ'),
+    (0x4A7, 'V'),
+    (0x4A8, 'M', u'ҩ'),
+    (0x4A9, 'V'),
+    (0x4AA, 'M', u'ҫ'),
+    (0x4AB, 'V'),
+    (0x4AC, 'M', u'ҭ'),
+    (0x4AD, 'V'),
+    (0x4AE, 'M', u'ү'),
+    (0x4AF, 'V'),
+    (0x4B0, 'M', u'ұ'),
+    (0x4B1, 'V'),
+    (0x4B2, 'M', u'ҳ'),
+    (0x4B3, 'V'),
+    (0x4B4, 'M', u'ҵ'),
+    (0x4B5, 'V'),
+    (0x4B6, 'M', u'ҷ'),
+    (0x4B7, 'V'),
+    (0x4B8, 'M', u'ҹ'),
+    (0x4B9, 'V'),
+    (0x4BA, 'M', u'һ'),
+    (0x4BB, 'V'),
+    (0x4BC, 'M', u'ҽ'),
+    (0x4BD, 'V'),
+    (0x4BE, 'M', u'ҿ'),
+    (0x4BF, 'V'),
+    (0x4C0, 'X'),
+    (0x4C1, 'M', u'ӂ'),
+    (0x4C2, 'V'),
+    (0x4C3, 'M', u'ӄ'),
+    (0x4C4, 'V'),
+    (0x4C5, 'M', u'ӆ'),
+    (0x4C6, 'V'),
+    (0x4C7, 'M', u'ӈ'),
+    (0x4C8, 'V'),
+    (0x4C9, 'M', u'ӊ'),
+    (0x4CA, 'V'),
+    (0x4CB, 'M', u'ӌ'),
+    (0x4CC, 'V'),
+    (0x4CD, 'M', u'ӎ'),
+    (0x4CE, 'V'),
+    (0x4D0, 'M', u'ӑ'),
+    (0x4D1, 'V'),
+    (0x4D2, 'M', u'ӓ'),
+    (0x4D3, 'V'),
+    (0x4D4, 'M', u'ӕ'),
+    (0x4D5, 'V'),
+    (0x4D6, 'M', u'ӗ'),
+    (0x4D7, 'V'),
+    (0x4D8, 'M', u'ә'),
+    (0x4D9, 'V'),
+    (0x4DA, 'M', u'ӛ'),
+    (0x4DB, 'V'),
+    (0x4DC, 'M', u'ӝ'),
+    (0x4DD, 'V'),
+    (0x4DE, 'M', u'ӟ'),
+    (0x4DF, 'V'),
+    (0x4E0, 'M', u'ӡ'),
+    (0x4E1, 'V'),
+    (0x4E2, 'M', u'ӣ'),
+    (0x4E3, 'V'),
+    (0x4E4, 'M', u'ӥ'),
+    (0x4E5, 'V'),
+    (0x4E6, 'M', u'ӧ'),
+    (0x4E7, 'V'),
+    (0x4E8, 'M', u'ө'),
+    (0x4E9, 'V'),
+    (0x4EA, 'M', u'ӫ'),
+    (0x4EB, 'V'),
+    (0x4EC, 'M', u'ӭ'),
+    (0x4ED, 'V'),
+    (0x4EE, 'M', u'ӯ'),
+    (0x4EF, 'V'),
+    (0x4F0, 'M', u'ӱ'),
+    (0x4F1, 'V'),
+    (0x4F2, 'M', u'ӳ'),
+    (0x4F3, 'V'),
+    (0x4F4, 'M', u'ӵ'),
+    (0x4F5, 'V'),
+    (0x4F6, 'M', u'ӷ'),
+    (0x4F7, 'V'),
+    (0x4F8, 'M', u'ӹ'),
+    (0x4F9, 'V'),
+    (0x4FA, 'M', u'ӻ'),
+    (0x4FB, 'V'),
+    (0x4FC, 'M', u'ӽ'),
+    (0x4FD, 'V'),
+    (0x4FE, 'M', u'ӿ'),
+    (0x4FF, 'V'),
+    (0x500, 'M', u'ԁ'),
+    (0x501, 'V'),
+    (0x502, 'M', u'ԃ'),
+    ]
+
+def _seg_9():
+    return [
+    (0x503, 'V'),
+    (0x504, 'M', u'ԅ'),
+    (0x505, 'V'),
+    (0x506, 'M', u'ԇ'),
+    (0x507, 'V'),
+    (0x508, 'M', u'ԉ'),
+    (0x509, 'V'),
+    (0x50A, 'M', u'ԋ'),
+    (0x50B, 'V'),
+    (0x50C, 'M', u'ԍ'),
+    (0x50D, 'V'),
+    (0x50E, 'M', u'ԏ'),
+    (0x50F, 'V'),
+    (0x510, 'M', u'ԑ'),
+    (0x511, 'V'),
+    (0x512, 'M', u'ԓ'),
+    (0x513, 'V'),
+    (0x514, 'M', u'ԕ'),
+    (0x515, 'V'),
+    (0x516, 'M', u'ԗ'),
+    (0x517, 'V'),
+    (0x518, 'M', u'ԙ'),
+    (0x519, 'V'),
+    (0x51A, 'M', u'ԛ'),
+    (0x51B, 'V'),
+    (0x51C, 'M', u'ԝ'),
+    (0x51D, 'V'),
+    (0x51E, 'M', u'ԟ'),
+    (0x51F, 'V'),
+    (0x520, 'M', u'ԡ'),
+    (0x521, 'V'),
+    (0x522, 'M', u'ԣ'),
+    (0x523, 'V'),
+    (0x524, 'M', u'ԥ'),
+    (0x525, 'V'),
+    (0x526, 'M', u'ԧ'),
+    (0x527, 'V'),
+    (0x528, 'M', u'ԩ'),
+    (0x529, 'V'),
+    (0x52A, 'M', u'ԫ'),
+    (0x52B, 'V'),
+    (0x52C, 'M', u'ԭ'),
+    (0x52D, 'V'),
+    (0x52E, 'M', u'ԯ'),
+    (0x52F, 'V'),
+    (0x530, 'X'),
+    (0x531, 'M', u'ա'),
+    (0x532, 'M', u'բ'),
+    (0x533, 'M', u'գ'),
+    (0x534, 'M', u'դ'),
+    (0x535, 'M', u'ե'),
+    (0x536, 'M', u'զ'),
+    (0x537, 'M', u'է'),
+    (0x538, 'M', u'ը'),
+    (0x539, 'M', u'թ'),
+    (0x53A, 'M', u'ժ'),
+    (0x53B, 'M', u'ի'),
+    (0x53C, 'M', u'լ'),
+    (0x53D, 'M', u'խ'),
+    (0x53E, 'M', u'ծ'),
+    (0x53F, 'M', u'կ'),
+    (0x540, 'M', u'հ'),
+    (0x541, 'M', u'ձ'),
+    (0x542, 'M', u'ղ'),
+    (0x543, 'M', u'ճ'),
+    (0x544, 'M', u'մ'),
+    (0x545, 'M', u'յ'),
+    (0x546, 'M', u'ն'),
+    (0x547, 'M', u'շ'),
+    (0x548, 'M', u'ո'),
+    (0x549, 'M', u'չ'),
+    (0x54A, 'M', u'պ'),
+    (0x54B, 'M', u'ջ'),
+    (0x54C, 'M', u'ռ'),
+    (0x54D, 'M', u'ս'),
+    (0x54E, 'M', u'վ'),
+    (0x54F, 'M', u'տ'),
+    (0x550, 'M', u'ր'),
+    (0x551, 'M', u'ց'),
+    (0x552, 'M', u'ւ'),
+    (0x553, 'M', u'փ'),
+    (0x554, 'M', u'ք'),
+    (0x555, 'M', u'օ'),
+    (0x556, 'M', u'ֆ'),
+    (0x557, 'X'),
+    (0x559, 'V'),
+    (0x587, 'M', u'եւ'),
+    (0x588, 'V'),
+    (0x58B, 'X'),
+    (0x58D, 'V'),
+    (0x590, 'X'),
+    (0x591, 'V'),
+    (0x5C8, 'X'),
+    (0x5D0, 'V'),
+    (0x5EB, 'X'),
+    (0x5EF, 'V'),
+    (0x5F5, 'X'),
+    (0x606, 'V'),
+    (0x61C, 'X'),
+    (0x61E, 'V'),
+    ]
+
+def _seg_10():
+    return [
+    (0x675, 'M', u'اٴ'),
+    (0x676, 'M', u'وٴ'),
+    (0x677, 'M', u'ۇٴ'),
+    (0x678, 'M', u'يٴ'),
+    (0x679, 'V'),
+    (0x6DD, 'X'),
+    (0x6DE, 'V'),
+    (0x70E, 'X'),
+    (0x710, 'V'),
+    (0x74B, 'X'),
+    (0x74D, 'V'),
+    (0x7B2, 'X'),
+    (0x7C0, 'V'),
+    (0x7FB, 'X'),
+    (0x7FD, 'V'),
+    (0x82E, 'X'),
+    (0x830, 'V'),
+    (0x83F, 'X'),
+    (0x840, 'V'),
+    (0x85C, 'X'),
+    (0x85E, 'V'),
+    (0x85F, 'X'),
+    (0x860, 'V'),
+    (0x86B, 'X'),
+    (0x8A0, 'V'),
+    (0x8B5, 'X'),
+    (0x8B6, 'V'),
+    (0x8BE, 'X'),
+    (0x8D3, 'V'),
+    (0x8E2, 'X'),
+    (0x8E3, 'V'),
+    (0x958, 'M', u'क़'),
+    (0x959, 'M', u'ख़'),
+    (0x95A, 'M', u'ग़'),
+    (0x95B, 'M', u'ज़'),
+    (0x95C, 'M', u'ड़'),
+    (0x95D, 'M', u'ढ़'),
+    (0x95E, 'M', u'फ़'),
+    (0x95F, 'M', u'य़'),
+    (0x960, 'V'),
+    (0x984, 'X'),
+    (0x985, 'V'),
+    (0x98D, 'X'),
+    (0x98F, 'V'),
+    (0x991, 'X'),
+    (0x993, 'V'),
+    (0x9A9, 'X'),
+    (0x9AA, 'V'),
+    (0x9B1, 'X'),
+    (0x9B2, 'V'),
+    (0x9B3, 'X'),
+    (0x9B6, 'V'),
+    (0x9BA, 'X'),
+    (0x9BC, 'V'),
+    (0x9C5, 'X'),
+    (0x9C7, 'V'),
+    (0x9C9, 'X'),
+    (0x9CB, 'V'),
+    (0x9CF, 'X'),
+    (0x9D7, 'V'),
+    (0x9D8, 'X'),
+    (0x9DC, 'M', u'ড়'),
+    (0x9DD, 'M', u'ঢ়'),
+    (0x9DE, 'X'),
+    (0x9DF, 'M', u'য়'),
+    (0x9E0, 'V'),
+    (0x9E4, 'X'),
+    (0x9E6, 'V'),
+    (0x9FF, 'X'),
+    (0xA01, 'V'),
+    (0xA04, 'X'),
+    (0xA05, 'V'),
+    (0xA0B, 'X'),
+    (0xA0F, 'V'),
+    (0xA11, 'X'),
+    (0xA13, 'V'),
+    (0xA29, 'X'),
+    (0xA2A, 'V'),
+    (0xA31, 'X'),
+    (0xA32, 'V'),
+    (0xA33, 'M', u'ਲ਼'),
+    (0xA34, 'X'),
+    (0xA35, 'V'),
+    (0xA36, 'M', u'ਸ਼'),
+    (0xA37, 'X'),
+    (0xA38, 'V'),
+    (0xA3A, 'X'),
+    (0xA3C, 'V'),
+    (0xA3D, 'X'),
+    (0xA3E, 'V'),
+    (0xA43, 'X'),
+    (0xA47, 'V'),
+    (0xA49, 'X'),
+    (0xA4B, 'V'),
+    (0xA4E, 'X'),
+    (0xA51, 'V'),
+    (0xA52, 'X'),
+    (0xA59, 'M', u'ਖ਼'),
+    (0xA5A, 'M', u'ਗ਼'),
+    (0xA5B, 'M', u'ਜ਼'),
+    ]
+
+def _seg_11():
+    return [
+    (0xA5C, 'V'),
+    (0xA5D, 'X'),
+    (0xA5E, 'M', u'ਫ਼'),
+    (0xA5F, 'X'),
+    (0xA66, 'V'),
+    (0xA77, 'X'),
+    (0xA81, 'V'),
+    (0xA84, 'X'),
+    (0xA85, 'V'),
+    (0xA8E, 'X'),
+    (0xA8F, 'V'),
+    (0xA92, 'X'),
+    (0xA93, 'V'),
+    (0xAA9, 'X'),
+    (0xAAA, 'V'),
+    (0xAB1, 'X'),
+    (0xAB2, 'V'),
+    (0xAB4, 'X'),
+    (0xAB5, 'V'),
+    (0xABA, 'X'),
+    (0xABC, 'V'),
+    (0xAC6, 'X'),
+    (0xAC7, 'V'),
+    (0xACA, 'X'),
+    (0xACB, 'V'),
+    (0xACE, 'X'),
+    (0xAD0, 'V'),
+    (0xAD1, 'X'),
+    (0xAE0, 'V'),
+    (0xAE4, 'X'),
+    (0xAE6, 'V'),
+    (0xAF2, 'X'),
+    (0xAF9, 'V'),
+    (0xB00, 'X'),
+    (0xB01, 'V'),
+    (0xB04, 'X'),
+    (0xB05, 'V'),
+    (0xB0D, 'X'),
+    (0xB0F, 'V'),
+    (0xB11, 'X'),
+    (0xB13, 'V'),
+    (0xB29, 'X'),
+    (0xB2A, 'V'),
+    (0xB31, 'X'),
+    (0xB32, 'V'),
+    (0xB34, 'X'),
+    (0xB35, 'V'),
+    (0xB3A, 'X'),
+    (0xB3C, 'V'),
+    (0xB45, 'X'),
+    (0xB47, 'V'),
+    (0xB49, 'X'),
+    (0xB4B, 'V'),
+    (0xB4E, 'X'),
+    (0xB56, 'V'),
+    (0xB58, 'X'),
+    (0xB5C, 'M', u'ଡ଼'),
+    (0xB5D, 'M', u'ଢ଼'),
+    (0xB5E, 'X'),
+    (0xB5F, 'V'),
+    (0xB64, 'X'),
+    (0xB66, 'V'),
+    (0xB78, 'X'),
+    (0xB82, 'V'),
+    (0xB84, 'X'),
+    (0xB85, 'V'),
+    (0xB8B, 'X'),
+    (0xB8E, 'V'),
+    (0xB91, 'X'),
+    (0xB92, 'V'),
+    (0xB96, 'X'),
+    (0xB99, 'V'),
+    (0xB9B, 'X'),
+    (0xB9C, 'V'),
+    (0xB9D, 'X'),
+    (0xB9E, 'V'),
+    (0xBA0, 'X'),
+    (0xBA3, 'V'),
+    (0xBA5, 'X'),
+    (0xBA8, 'V'),
+    (0xBAB, 'X'),
+    (0xBAE, 'V'),
+    (0xBBA, 'X'),
+    (0xBBE, 'V'),
+    (0xBC3, 'X'),
+    (0xBC6, 'V'),
+    (0xBC9, 'X'),
+    (0xBCA, 'V'),
+    (0xBCE, 'X'),
+    (0xBD0, 'V'),
+    (0xBD1, 'X'),
+    (0xBD7, 'V'),
+    (0xBD8, 'X'),
+    (0xBE6, 'V'),
+    (0xBFB, 'X'),
+    (0xC00, 'V'),
+    (0xC0D, 'X'),
+    (0xC0E, 'V'),
+    (0xC11, 'X'),
+    (0xC12, 'V'),
+    ]
+
+def _seg_12():
+    return [
+    (0xC29, 'X'),
+    (0xC2A, 'V'),
+    (0xC3A, 'X'),
+    (0xC3D, 'V'),
+    (0xC45, 'X'),
+    (0xC46, 'V'),
+    (0xC49, 'X'),
+    (0xC4A, 'V'),
+    (0xC4E, 'X'),
+    (0xC55, 'V'),
+    (0xC57, 'X'),
+    (0xC58, 'V'),
+    (0xC5B, 'X'),
+    (0xC60, 'V'),
+    (0xC64, 'X'),
+    (0xC66, 'V'),
+    (0xC70, 'X'),
+    (0xC78, 'V'),
+    (0xC8D, 'X'),
+    (0xC8E, 'V'),
+    (0xC91, 'X'),
+    (0xC92, 'V'),
+    (0xCA9, 'X'),
+    (0xCAA, 'V'),
+    (0xCB4, 'X'),
+    (0xCB5, 'V'),
+    (0xCBA, 'X'),
+    (0xCBC, 'V'),
+    (0xCC5, 'X'),
+    (0xCC6, 'V'),
+    (0xCC9, 'X'),
+    (0xCCA, 'V'),
+    (0xCCE, 'X'),
+    (0xCD5, 'V'),
+    (0xCD7, 'X'),
+    (0xCDE, 'V'),
+    (0xCDF, 'X'),
+    (0xCE0, 'V'),
+    (0xCE4, 'X'),
+    (0xCE6, 'V'),
+    (0xCF0, 'X'),
+    (0xCF1, 'V'),
+    (0xCF3, 'X'),
+    (0xD00, 'V'),
+    (0xD04, 'X'),
+    (0xD05, 'V'),
+    (0xD0D, 'X'),
+    (0xD0E, 'V'),
+    (0xD11, 'X'),
+    (0xD12, 'V'),
+    (0xD45, 'X'),
+    (0xD46, 'V'),
+    (0xD49, 'X'),
+    (0xD4A, 'V'),
+    (0xD50, 'X'),
+    (0xD54, 'V'),
+    (0xD64, 'X'),
+    (0xD66, 'V'),
+    (0xD80, 'X'),
+    (0xD82, 'V'),
+    (0xD84, 'X'),
+    (0xD85, 'V'),
+    (0xD97, 'X'),
+    (0xD9A, 'V'),
+    (0xDB2, 'X'),
+    (0xDB3, 'V'),
+    (0xDBC, 'X'),
+    (0xDBD, 'V'),
+    (0xDBE, 'X'),
+    (0xDC0, 'V'),
+    (0xDC7, 'X'),
+    (0xDCA, 'V'),
+    (0xDCB, 'X'),
+    (0xDCF, 'V'),
+    (0xDD5, 'X'),
+    (0xDD6, 'V'),
+    (0xDD7, 'X'),
+    (0xDD8, 'V'),
+    (0xDE0, 'X'),
+    (0xDE6, 'V'),
+    (0xDF0, 'X'),
+    (0xDF2, 'V'),
+    (0xDF5, 'X'),
+    (0xE01, 'V'),
+    (0xE33, 'M', u'ํา'),
+    (0xE34, 'V'),
+    (0xE3B, 'X'),
+    (0xE3F, 'V'),
+    (0xE5C, 'X'),
+    (0xE81, 'V'),
+    (0xE83, 'X'),
+    (0xE84, 'V'),
+    (0xE85, 'X'),
+    (0xE87, 'V'),
+    (0xE89, 'X'),
+    (0xE8A, 'V'),
+    (0xE8B, 'X'),
+    (0xE8D, 'V'),
+    (0xE8E, 'X'),
+    (0xE94, 'V'),
+    ]
+
+def _seg_13():
+    return [
+    (0xE98, 'X'),
+    (0xE99, 'V'),
+    (0xEA0, 'X'),
+    (0xEA1, 'V'),
+    (0xEA4, 'X'),
+    (0xEA5, 'V'),
+    (0xEA6, 'X'),
+    (0xEA7, 'V'),
+    (0xEA8, 'X'),
+    (0xEAA, 'V'),
+    (0xEAC, 'X'),
+    (0xEAD, 'V'),
+    (0xEB3, 'M', u'ໍາ'),
+    (0xEB4, 'V'),
+    (0xEBA, 'X'),
+    (0xEBB, 'V'),
+    (0xEBE, 'X'),
+    (0xEC0, 'V'),
+    (0xEC5, 'X'),
+    (0xEC6, 'V'),
+    (0xEC7, 'X'),
+    (0xEC8, 'V'),
+    (0xECE, 'X'),
+    (0xED0, 'V'),
+    (0xEDA, 'X'),
+    (0xEDC, 'M', u'ຫນ'),
+    (0xEDD, 'M', u'ຫມ'),
+    (0xEDE, 'V'),
+    (0xEE0, 'X'),
+    (0xF00, 'V'),
+    (0xF0C, 'M', u'་'),
+    (0xF0D, 'V'),
+    (0xF43, 'M', u'གྷ'),
+    (0xF44, 'V'),
+    (0xF48, 'X'),
+    (0xF49, 'V'),
+    (0xF4D, 'M', u'ཌྷ'),
+    (0xF4E, 'V'),
+    (0xF52, 'M', u'དྷ'),
+    (0xF53, 'V'),
+    (0xF57, 'M', u'བྷ'),
+    (0xF58, 'V'),
+    (0xF5C, 'M', u'ཛྷ'),
+    (0xF5D, 'V'),
+    (0xF69, 'M', u'ཀྵ'),
+    (0xF6A, 'V'),
+    (0xF6D, 'X'),
+    (0xF71, 'V'),
+    (0xF73, 'M', u'ཱི'),
+    (0xF74, 'V'),
+    (0xF75, 'M', u'ཱུ'),
+    (0xF76, 'M', u'ྲྀ'),
+    (0xF77, 'M', u'ྲཱྀ'),
+    (0xF78, 'M', u'ླྀ'),
+    (0xF79, 'M', u'ླཱྀ'),
+    (0xF7A, 'V'),
+    (0xF81, 'M', u'ཱྀ'),
+    (0xF82, 'V'),
+    (0xF93, 'M', u'ྒྷ'),
+    (0xF94, 'V'),
+    (0xF98, 'X'),
+    (0xF99, 'V'),
+    (0xF9D, 'M', u'ྜྷ'),
+    (0xF9E, 'V'),
+    (0xFA2, 'M', u'ྡྷ'),
+    (0xFA3, 'V'),
+    (0xFA7, 'M', u'ྦྷ'),
+    (0xFA8, 'V'),
+    (0xFAC, 'M', u'ྫྷ'),
+    (0xFAD, 'V'),
+    (0xFB9, 'M', u'ྐྵ'),
+    (0xFBA, 'V'),
+    (0xFBD, 'X'),
+    (0xFBE, 'V'),
+    (0xFCD, 'X'),
+    (0xFCE, 'V'),
+    (0xFDB, 'X'),
+    (0x1000, 'V'),
+    (0x10A0, 'X'),
+    (0x10C7, 'M', u'ⴧ'),
+    (0x10C8, 'X'),
+    (0x10CD, 'M', u'ⴭ'),
+    (0x10CE, 'X'),
+    (0x10D0, 'V'),
+    (0x10FC, 'M', u'ნ'),
+    (0x10FD, 'V'),
+    (0x115F, 'X'),
+    (0x1161, 'V'),
+    (0x1249, 'X'),
+    (0x124A, 'V'),
+    (0x124E, 'X'),
+    (0x1250, 'V'),
+    (0x1257, 'X'),
+    (0x1258, 'V'),
+    (0x1259, 'X'),
+    (0x125A, 'V'),
+    (0x125E, 'X'),
+    (0x1260, 'V'),
+    (0x1289, 'X'),
+    (0x128A, 'V'),
+    ]
+
+def _seg_14():
+    return [
+    (0x128E, 'X'),
+    (0x1290, 'V'),
+    (0x12B1, 'X'),
+    (0x12B2, 'V'),
+    (0x12B6, 'X'),
+    (0x12B8, 'V'),
+    (0x12BF, 'X'),
+    (0x12C0, 'V'),
+    (0x12C1, 'X'),
+    (0x12C2, 'V'),
+    (0x12C6, 'X'),
+    (0x12C8, 'V'),
+    (0x12D7, 'X'),
+    (0x12D8, 'V'),
+    (0x1311, 'X'),
+    (0x1312, 'V'),
+    (0x1316, 'X'),
+    (0x1318, 'V'),
+    (0x135B, 'X'),
+    (0x135D, 'V'),
+    (0x137D, 'X'),
+    (0x1380, 'V'),
+    (0x139A, 'X'),
+    (0x13A0, 'V'),
+    (0x13F6, 'X'),
+    (0x13F8, 'M', u'Ᏸ'),
+    (0x13F9, 'M', u'Ᏹ'),
+    (0x13FA, 'M', u'Ᏺ'),
+    (0x13FB, 'M', u'Ᏻ'),
+    (0x13FC, 'M', u'Ᏼ'),
+    (0x13FD, 'M', u'Ᏽ'),
+    (0x13FE, 'X'),
+    (0x1400, 'V'),
+    (0x1680, 'X'),
+    (0x1681, 'V'),
+    (0x169D, 'X'),
+    (0x16A0, 'V'),
+    (0x16F9, 'X'),
+    (0x1700, 'V'),
+    (0x170D, 'X'),
+    (0x170E, 'V'),
+    (0x1715, 'X'),
+    (0x1720, 'V'),
+    (0x1737, 'X'),
+    (0x1740, 'V'),
+    (0x1754, 'X'),
+    (0x1760, 'V'),
+    (0x176D, 'X'),
+    (0x176E, 'V'),
+    (0x1771, 'X'),
+    (0x1772, 'V'),
+    (0x1774, 'X'),
+    (0x1780, 'V'),
+    (0x17B4, 'X'),
+    (0x17B6, 'V'),
+    (0x17DE, 'X'),
+    (0x17E0, 'V'),
+    (0x17EA, 'X'),
+    (0x17F0, 'V'),
+    (0x17FA, 'X'),
+    (0x1800, 'V'),
+    (0x1806, 'X'),
+    (0x1807, 'V'),
+    (0x180B, 'I'),
+    (0x180E, 'X'),
+    (0x1810, 'V'),
+    (0x181A, 'X'),
+    (0x1820, 'V'),
+    (0x1879, 'X'),
+    (0x1880, 'V'),
+    (0x18AB, 'X'),
+    (0x18B0, 'V'),
+    (0x18F6, 'X'),
+    (0x1900, 'V'),
+    (0x191F, 'X'),
+    (0x1920, 'V'),
+    (0x192C, 'X'),
+    (0x1930, 'V'),
+    (0x193C, 'X'),
+    (0x1940, 'V'),
+    (0x1941, 'X'),
+    (0x1944, 'V'),
+    (0x196E, 'X'),
+    (0x1970, 'V'),
+    (0x1975, 'X'),
+    (0x1980, 'V'),
+    (0x19AC, 'X'),
+    (0x19B0, 'V'),
+    (0x19CA, 'X'),
+    (0x19D0, 'V'),
+    (0x19DB, 'X'),
+    (0x19DE, 'V'),
+    (0x1A1C, 'X'),
+    (0x1A1E, 'V'),
+    (0x1A5F, 'X'),
+    (0x1A60, 'V'),
+    (0x1A7D, 'X'),
+    (0x1A7F, 'V'),
+    (0x1A8A, 'X'),
+    (0x1A90, 'V'),
+    ]
+
+def _seg_15():
+    return [
+    (0x1A9A, 'X'),
+    (0x1AA0, 'V'),
+    (0x1AAE, 'X'),
+    (0x1AB0, 'V'),
+    (0x1ABF, 'X'),
+    (0x1B00, 'V'),
+    (0x1B4C, 'X'),
+    (0x1B50, 'V'),
+    (0x1B7D, 'X'),
+    (0x1B80, 'V'),
+    (0x1BF4, 'X'),
+    (0x1BFC, 'V'),
+    (0x1C38, 'X'),
+    (0x1C3B, 'V'),
+    (0x1C4A, 'X'),
+    (0x1C4D, 'V'),
+    (0x1C80, 'M', u'в'),
+    (0x1C81, 'M', u'д'),
+    (0x1C82, 'M', u'о'),
+    (0x1C83, 'M', u'с'),
+    (0x1C84, 'M', u'т'),
+    (0x1C86, 'M', u'ъ'),
+    (0x1C87, 'M', u'ѣ'),
+    (0x1C88, 'M', u'ꙋ'),
+    (0x1C89, 'X'),
+    (0x1CC0, 'V'),
+    (0x1CC8, 'X'),
+    (0x1CD0, 'V'),
+    (0x1CFA, 'X'),
+    (0x1D00, 'V'),
+    (0x1D2C, 'M', u'a'),
+    (0x1D2D, 'M', u'æ'),
+    (0x1D2E, 'M', u'b'),
+    (0x1D2F, 'V'),
+    (0x1D30, 'M', u'd'),
+    (0x1D31, 'M', u'e'),
+    (0x1D32, 'M', u'ǝ'),
+    (0x1D33, 'M', u'g'),
+    (0x1D34, 'M', u'h'),
+    (0x1D35, 'M', u'i'),
+    (0x1D36, 'M', u'j'),
+    (0x1D37, 'M', u'k'),
+    (0x1D38, 'M', u'l'),
+    (0x1D39, 'M', u'm'),
+    (0x1D3A, 'M', u'n'),
+    (0x1D3B, 'V'),
+    (0x1D3C, 'M', u'o'),
+    (0x1D3D, 'M', u'ȣ'),
+    (0x1D3E, 'M', u'p'),
+    (0x1D3F, 'M', u'r'),
+    (0x1D40, 'M', u't'),
+    (0x1D41, 'M', u'u'),
+    (0x1D42, 'M', u'w'),
+    (0x1D43, 'M', u'a'),
+    (0x1D44, 'M', u'ɐ'),
+    (0x1D45, 'M', u'ɑ'),
+    (0x1D46, 'M', u'ᴂ'),
+    (0x1D47, 'M', u'b'),
+    (0x1D48, 'M', u'd'),
+    (0x1D49, 'M', u'e'),
+    (0x1D4A, 'M', u'ə'),
+    (0x1D4B, 'M', u'ɛ'),
+    (0x1D4C, 'M', u'ɜ'),
+    (0x1D4D, 'M', u'g'),
+    (0x1D4E, 'V'),
+    (0x1D4F, 'M', u'k'),
+    (0x1D50, 'M', u'm'),
+    (0x1D51, 'M', u'ŋ'),
+    (0x1D52, 'M', u'o'),
+    (0x1D53, 'M', u'ɔ'),
+    (0x1D54, 'M', u'ᴖ'),
+    (0x1D55, 'M', u'ᴗ'),
+    (0x1D56, 'M', u'p'),
+    (0x1D57, 'M', u't'),
+    (0x1D58, 'M', u'u'),
+    (0x1D59, 'M', u'ᴝ'),
+    (0x1D5A, 'M', u'ɯ'),
+    (0x1D5B, 'M', u'v'),
+    (0x1D5C, 'M', u'ᴥ'),
+    (0x1D5D, 'M', u'β'),
+    (0x1D5E, 'M', u'γ'),
+    (0x1D5F, 'M', u'δ'),
+    (0x1D60, 'M', u'φ'),
+    (0x1D61, 'M', u'χ'),
+    (0x1D62, 'M', u'i'),
+    (0x1D63, 'M', u'r'),
+    (0x1D64, 'M', u'u'),
+    (0x1D65, 'M', u'v'),
+    (0x1D66, 'M', u'β'),
+    (0x1D67, 'M', u'γ'),
+    (0x1D68, 'M', u'ρ'),
+    (0x1D69, 'M', u'φ'),
+    (0x1D6A, 'M', u'χ'),
+    (0x1D6B, 'V'),
+    (0x1D78, 'M', u'н'),
+    (0x1D79, 'V'),
+    (0x1D9B, 'M', u'ɒ'),
+    (0x1D9C, 'M', u'c'),
+    (0x1D9D, 'M', u'ɕ'),
+    (0x1D9E, 'M', u'ð'),
+    ]
+
+def _seg_16():
+    return [
+    (0x1D9F, 'M', u'ɜ'),
+    (0x1DA0, 'M', u'f'),
+    (0x1DA1, 'M', u'ɟ'),
+    (0x1DA2, 'M', u'ɡ'),
+    (0x1DA3, 'M', u'ɥ'),
+    (0x1DA4, 'M', u'ɨ'),
+    (0x1DA5, 'M', u'ɩ'),
+    (0x1DA6, 'M', u'ɪ'),
+    (0x1DA7, 'M', u'ᵻ'),
+    (0x1DA8, 'M', u'ʝ'),
+    (0x1DA9, 'M', u'ɭ'),
+    (0x1DAA, 'M', u'ᶅ'),
+    (0x1DAB, 'M', u'ʟ'),
+    (0x1DAC, 'M', u'ɱ'),
+    (0x1DAD, 'M', u'ɰ'),
+    (0x1DAE, 'M', u'ɲ'),
+    (0x1DAF, 'M', u'ɳ'),
+    (0x1DB0, 'M', u'ɴ'),
+    (0x1DB1, 'M', u'ɵ'),
+    (0x1DB2, 'M', u'ɸ'),
+    (0x1DB3, 'M', u'ʂ'),
+    (0x1DB4, 'M', u'ʃ'),
+    (0x1DB5, 'M', u'ƫ'),
+    (0x1DB6, 'M', u'ʉ'),
+    (0x1DB7, 'M', u'ʊ'),
+    (0x1DB8, 'M', u'ᴜ'),
+    (0x1DB9, 'M', u'ʋ'),
+    (0x1DBA, 'M', u'ʌ'),
+    (0x1DBB, 'M', u'z'),
+    (0x1DBC, 'M', u'ʐ'),
+    (0x1DBD, 'M', u'ʑ'),
+    (0x1DBE, 'M', u'ʒ'),
+    (0x1DBF, 'M', u'θ'),
+    (0x1DC0, 'V'),
+    (0x1DFA, 'X'),
+    (0x1DFB, 'V'),
+    (0x1E00, 'M', u'ḁ'),
+    (0x1E01, 'V'),
+    (0x1E02, 'M', u'ḃ'),
+    (0x1E03, 'V'),
+    (0x1E04, 'M', u'ḅ'),
+    (0x1E05, 'V'),
+    (0x1E06, 'M', u'ḇ'),
+    (0x1E07, 'V'),
+    (0x1E08, 'M', u'ḉ'),
+    (0x1E09, 'V'),
+    (0x1E0A, 'M', u'ḋ'),
+    (0x1E0B, 'V'),
+    (0x1E0C, 'M', u'ḍ'),
+    (0x1E0D, 'V'),
+    (0x1E0E, 'M', u'ḏ'),
+    (0x1E0F, 'V'),
+    (0x1E10, 'M', u'ḑ'),
+    (0x1E11, 'V'),
+    (0x1E12, 'M', u'ḓ'),
+    (0x1E13, 'V'),
+    (0x1E14, 'M', u'ḕ'),
+    (0x1E15, 'V'),
+    (0x1E16, 'M', u'ḗ'),
+    (0x1E17, 'V'),
+    (0x1E18, 'M', u'ḙ'),
+    (0x1E19, 'V'),
+    (0x1E1A, 'M', u'ḛ'),
+    (0x1E1B, 'V'),
+    (0x1E1C, 'M', u'ḝ'),
+    (0x1E1D, 'V'),
+    (0x1E1E, 'M', u'ḟ'),
+    (0x1E1F, 'V'),
+    (0x1E20, 'M', u'ḡ'),
+    (0x1E21, 'V'),
+    (0x1E22, 'M', u'ḣ'),
+    (0x1E23, 'V'),
+    (0x1E24, 'M', u'ḥ'),
+    (0x1E25, 'V'),
+    (0x1E26, 'M', u'ḧ'),
+    (0x1E27, 'V'),
+    (0x1E28, 'M', u'ḩ'),
+    (0x1E29, 'V'),
+    (0x1E2A, 'M', u'ḫ'),
+    (0x1E2B, 'V'),
+    (0x1E2C, 'M', u'ḭ'),
+    (0x1E2D, 'V'),
+    (0x1E2E, 'M', u'ḯ'),
+    (0x1E2F, 'V'),
+    (0x1E30, 'M', u'ḱ'),
+    (0x1E31, 'V'),
+    (0x1E32, 'M', u'ḳ'),
+    (0x1E33, 'V'),
+    (0x1E34, 'M', u'ḵ'),
+    (0x1E35, 'V'),
+    (0x1E36, 'M', u'ḷ'),
+    (0x1E37, 'V'),
+    (0x1E38, 'M', u'ḹ'),
+    (0x1E39, 'V'),
+    (0x1E3A, 'M', u'ḻ'),
+    (0x1E3B, 'V'),
+    (0x1E3C, 'M', u'ḽ'),
+    (0x1E3D, 'V'),
+    (0x1E3E, 'M', u'ḿ'),
+    (0x1E3F, 'V'),
+    ]
+
+def _seg_17():
+    return [
+    (0x1E40, 'M', u'ṁ'),
+    (0x1E41, 'V'),
+    (0x1E42, 'M', u'ṃ'),
+    (0x1E43, 'V'),
+    (0x1E44, 'M', u'ṅ'),
+    (0x1E45, 'V'),
+    (0x1E46, 'M', u'ṇ'),
+    (0x1E47, 'V'),
+    (0x1E48, 'M', u'ṉ'),
+    (0x1E49, 'V'),
+    (0x1E4A, 'M', u'ṋ'),
+    (0x1E4B, 'V'),
+    (0x1E4C, 'M', u'ṍ'),
+    (0x1E4D, 'V'),
+    (0x1E4E, 'M', u'ṏ'),
+    (0x1E4F, 'V'),
+    (0x1E50, 'M', u'ṑ'),
+    (0x1E51, 'V'),
+    (0x1E52, 'M', u'ṓ'),
+    (0x1E53, 'V'),
+    (0x1E54, 'M', u'ṕ'),
+    (0x1E55, 'V'),
+    (0x1E56, 'M', u'ṗ'),
+    (0x1E57, 'V'),
+    (0x1E58, 'M', u'ṙ'),
+    (0x1E59, 'V'),
+    (0x1E5A, 'M', u'ṛ'),
+    (0x1E5B, 'V'),
+    (0x1E5C, 'M', u'ṝ'),
+    (0x1E5D, 'V'),
+    (0x1E5E, 'M', u'ṟ'),
+    (0x1E5F, 'V'),
+    (0x1E60, 'M', u'ṡ'),
+    (0x1E61, 'V'),
+    (0x1E62, 'M', u'ṣ'),
+    (0x1E63, 'V'),
+    (0x1E64, 'M', u'ṥ'),
+    (0x1E65, 'V'),
+    (0x1E66, 'M', u'ṧ'),
+    (0x1E67, 'V'),
+    (0x1E68, 'M', u'ṩ'),
+    (0x1E69, 'V'),
+    (0x1E6A, 'M', u'ṫ'),
+    (0x1E6B, 'V'),
+    (0x1E6C, 'M', u'ṭ'),
+    (0x1E6D, 'V'),
+    (0x1E6E, 'M', u'ṯ'),
+    (0x1E6F, 'V'),
+    (0x1E70, 'M', u'ṱ'),
+    (0x1E71, 'V'),
+    (0x1E72, 'M', u'ṳ'),
+    (0x1E73, 'V'),
+    (0x1E74, 'M', u'ṵ'),
+    (0x1E75, 'V'),
+    (0x1E76, 'M', u'ṷ'),
+    (0x1E77, 'V'),
+    (0x1E78, 'M', u'ṹ'),
+    (0x1E79, 'V'),
+    (0x1E7A, 'M', u'ṻ'),
+    (0x1E7B, 'V'),
+    (0x1E7C, 'M', u'ṽ'),
+    (0x1E7D, 'V'),
+    (0x1E7E, 'M', u'ṿ'),
+    (0x1E7F, 'V'),
+    (0x1E80, 'M', u'ẁ'),
+    (0x1E81, 'V'),
+    (0x1E82, 'M', u'ẃ'),
+    (0x1E83, 'V'),
+    (0x1E84, 'M', u'ẅ'),
+    (0x1E85, 'V'),
+    (0x1E86, 'M', u'ẇ'),
+    (0x1E87, 'V'),
+    (0x1E88, 'M', u'ẉ'),
+    (0x1E89, 'V'),
+    (0x1E8A, 'M', u'ẋ'),
+    (0x1E8B, 'V'),
+    (0x1E8C, 'M', u'ẍ'),
+    (0x1E8D, 'V'),
+    (0x1E8E, 'M', u'ẏ'),
+    (0x1E8F, 'V'),
+    (0x1E90, 'M', u'ẑ'),
+    (0x1E91, 'V'),
+    (0x1E92, 'M', u'ẓ'),
+    (0x1E93, 'V'),
+    (0x1E94, 'M', u'ẕ'),
+    (0x1E95, 'V'),
+    (0x1E9A, 'M', u'aʾ'),
+    (0x1E9B, 'M', u'ṡ'),
+    (0x1E9C, 'V'),
+    (0x1E9E, 'M', u'ss'),
+    (0x1E9F, 'V'),
+    (0x1EA0, 'M', u'ạ'),
+    (0x1EA1, 'V'),
+    (0x1EA2, 'M', u'ả'),
+    (0x1EA3, 'V'),
+    (0x1EA4, 'M', u'ấ'),
+    (0x1EA5, 'V'),
+    (0x1EA6, 'M', u'ầ'),
+    (0x1EA7, 'V'),
+    (0x1EA8, 'M', u'ẩ'),
+    ]
+
+def _seg_18():
+    return [
+    (0x1EA9, 'V'),
+    (0x1EAA, 'M', u'ẫ'),
+    (0x1EAB, 'V'),
+    (0x1EAC, 'M', u'ậ'),
+    (0x1EAD, 'V'),
+    (0x1EAE, 'M', u'ắ'),
+    (0x1EAF, 'V'),
+    (0x1EB0, 'M', u'ằ'),
+    (0x1EB1, 'V'),
+    (0x1EB2, 'M', u'ẳ'),
+    (0x1EB3, 'V'),
+    (0x1EB4, 'M', u'ẵ'),
+    (0x1EB5, 'V'),
+    (0x1EB6, 'M', u'ặ'),
+    (0x1EB7, 'V'),
+    (0x1EB8, 'M', u'ẹ'),
+    (0x1EB9, 'V'),
+    (0x1EBA, 'M', u'ẻ'),
+    (0x1EBB, 'V'),
+    (0x1EBC, 'M', u'ẽ'),
+    (0x1EBD, 'V'),
+    (0x1EBE, 'M', u'ế'),
+    (0x1EBF, 'V'),
+    (0x1EC0, 'M', u'ề'),
+    (0x1EC1, 'V'),
+    (0x1EC2, 'M', u'ể'),
+    (0x1EC3, 'V'),
+    (0x1EC4, 'M', u'ễ'),
+    (0x1EC5, 'V'),
+    (0x1EC6, 'M', u'ệ'),
+    (0x1EC7, 'V'),
+    (0x1EC8, 'M', u'ỉ'),
+    (0x1EC9, 'V'),
+    (0x1ECA, 'M', u'ị'),
+    (0x1ECB, 'V'),
+    (0x1ECC, 'M', u'ọ'),
+    (0x1ECD, 'V'),
+    (0x1ECE, 'M', u'ỏ'),
+    (0x1ECF, 'V'),
+    (0x1ED0, 'M', u'ố'),
+    (0x1ED1, 'V'),
+    (0x1ED2, 'M', u'ồ'),
+    (0x1ED3, 'V'),
+    (0x1ED4, 'M', u'ổ'),
+    (0x1ED5, 'V'),
+    (0x1ED6, 'M', u'ỗ'),
+    (0x1ED7, 'V'),
+    (0x1ED8, 'M', u'ộ'),
+    (0x1ED9, 'V'),
+    (0x1EDA, 'M', u'ớ'),
+    (0x1EDB, 'V'),
+    (0x1EDC, 'M', u'ờ'),
+    (0x1EDD, 'V'),
+    (0x1EDE, 'M', u'ở'),
+    (0x1EDF, 'V'),
+    (0x1EE0, 'M', u'ỡ'),
+    (0x1EE1, 'V'),
+    (0x1EE2, 'M', u'ợ'),
+    (0x1EE3, 'V'),
+    (0x1EE4, 'M', u'ụ'),
+    (0x1EE5, 'V'),
+    (0x1EE6, 'M', u'ủ'),
+    (0x1EE7, 'V'),
+    (0x1EE8, 'M', u'ứ'),
+    (0x1EE9, 'V'),
+    (0x1EEA, 'M', u'ừ'),
+    (0x1EEB, 'V'),
+    (0x1EEC, 'M', u'ử'),
+    (0x1EED, 'V'),
+    (0x1EEE, 'M', u'ữ'),
+    (0x1EEF, 'V'),
+    (0x1EF0, 'M', u'ự'),
+    (0x1EF1, 'V'),
+    (0x1EF2, 'M', u'ỳ'),
+    (0x1EF3, 'V'),
+    (0x1EF4, 'M', u'ỵ'),
+    (0x1EF5, 'V'),
+    (0x1EF6, 'M', u'ỷ'),
+    (0x1EF7, 'V'),
+    (0x1EF8, 'M', u'ỹ'),
+    (0x1EF9, 'V'),
+    (0x1EFA, 'M', u'ỻ'),
+    (0x1EFB, 'V'),
+    (0x1EFC, 'M', u'ỽ'),
+    (0x1EFD, 'V'),
+    (0x1EFE, 'M', u'ỿ'),
+    (0x1EFF, 'V'),
+    (0x1F08, 'M', u'ἀ'),
+    (0x1F09, 'M', u'ἁ'),
+    (0x1F0A, 'M', u'ἂ'),
+    (0x1F0B, 'M', u'ἃ'),
+    (0x1F0C, 'M', u'ἄ'),
+    (0x1F0D, 'M', u'ἅ'),
+    (0x1F0E, 'M', u'ἆ'),
+    (0x1F0F, 'M', u'ἇ'),
+    (0x1F10, 'V'),
+    (0x1F16, 'X'),
+    (0x1F18, 'M', u'ἐ'),
+    (0x1F19, 'M', u'ἑ'),
+    (0x1F1A, 'M', u'ἒ'),
+    ]
+
+def _seg_19():
+    return [
+    (0x1F1B, 'M', u'ἓ'),
+    (0x1F1C, 'M', u'ἔ'),
+    (0x1F1D, 'M', u'ἕ'),
+    (0x1F1E, 'X'),
+    (0x1F20, 'V'),
+    (0x1F28, 'M', u'ἠ'),
+    (0x1F29, 'M', u'ἡ'),
+    (0x1F2A, 'M', u'ἢ'),
+    (0x1F2B, 'M', u'ἣ'),
+    (0x1F2C, 'M', u'ἤ'),
+    (0x1F2D, 'M', u'ἥ'),
+    (0x1F2E, 'M', u'ἦ'),
+    (0x1F2F, 'M', u'ἧ'),
+    (0x1F30, 'V'),
+    (0x1F38, 'M', u'ἰ'),
+    (0x1F39, 'M', u'ἱ'),
+    (0x1F3A, 'M', u'ἲ'),
+    (0x1F3B, 'M', u'ἳ'),
+    (0x1F3C, 'M', u'ἴ'),
+    (0x1F3D, 'M', u'ἵ'),
+    (0x1F3E, 'M', u'ἶ'),
+    (0x1F3F, 'M', u'ἷ'),
+    (0x1F40, 'V'),
+    (0x1F46, 'X'),
+    (0x1F48, 'M', u'ὀ'),
+    (0x1F49, 'M', u'ὁ'),
+    (0x1F4A, 'M', u'ὂ'),
+    (0x1F4B, 'M', u'ὃ'),
+    (0x1F4C, 'M', u'ὄ'),
+    (0x1F4D, 'M', u'ὅ'),
+    (0x1F4E, 'X'),
+    (0x1F50, 'V'),
+    (0x1F58, 'X'),
+    (0x1F59, 'M', u'ὑ'),
+    (0x1F5A, 'X'),
+    (0x1F5B, 'M', u'ὓ'),
+    (0x1F5C, 'X'),
+    (0x1F5D, 'M', u'ὕ'),
+    (0x1F5E, 'X'),
+    (0x1F5F, 'M', u'ὗ'),
+    (0x1F60, 'V'),
+    (0x1F68, 'M', u'ὠ'),
+    (0x1F69, 'M', u'ὡ'),
+    (0x1F6A, 'M', u'ὢ'),
+    (0x1F6B, 'M', u'ὣ'),
+    (0x1F6C, 'M', u'ὤ'),
+    (0x1F6D, 'M', u'ὥ'),
+    (0x1F6E, 'M', u'ὦ'),
+    (0x1F6F, 'M', u'ὧ'),
+    (0x1F70, 'V'),
+    (0x1F71, 'M', u'ά'),
+    (0x1F72, 'V'),
+    (0x1F73, 'M', u'έ'),
+    (0x1F74, 'V'),
+    (0x1F75, 'M', u'ή'),
+    (0x1F76, 'V'),
+    (0x1F77, 'M', u'ί'),
+    (0x1F78, 'V'),
+    (0x1F79, 'M', u'ό'),
+    (0x1F7A, 'V'),
+    (0x1F7B, 'M', u'ύ'),
+    (0x1F7C, 'V'),
+    (0x1F7D, 'M', u'ώ'),
+    (0x1F7E, 'X'),
+    (0x1F80, 'M', u'ἀι'),
+    (0x1F81, 'M', u'ἁι'),
+    (0x1F82, 'M', u'ἂι'),
+    (0x1F83, 'M', u'ἃι'),
+    (0x1F84, 'M', u'ἄι'),
+    (0x1F85, 'M', u'ἅι'),
+    (0x1F86, 'M', u'ἆι'),
+    (0x1F87, 'M', u'ἇι'),
+    (0x1F88, 'M', u'ἀι'),
+    (0x1F89, 'M', u'ἁι'),
+    (0x1F8A, 'M', u'ἂι'),
+    (0x1F8B, 'M', u'ἃι'),
+    (0x1F8C, 'M', u'ἄι'),
+    (0x1F8D, 'M', u'ἅι'),
+    (0x1F8E, 'M', u'ἆι'),
+    (0x1F8F, 'M', u'ἇι'),
+    (0x1F90, 'M', u'ἠι'),
+    (0x1F91, 'M', u'ἡι'),
+    (0x1F92, 'M', u'ἢι'),
+    (0x1F93, 'M', u'ἣι'),
+    (0x1F94, 'M', u'ἤι'),
+    (0x1F95, 'M', u'ἥι'),
+    (0x1F96, 'M', u'ἦι'),
+    (0x1F97, 'M', u'ἧι'),
+    (0x1F98, 'M', u'ἠι'),
+    (0x1F99, 'M', u'ἡι'),
+    (0x1F9A, 'M', u'ἢι'),
+    (0x1F9B, 'M', u'ἣι'),
+    (0x1F9C, 'M', u'ἤι'),
+    (0x1F9D, 'M', u'ἥι'),
+    (0x1F9E, 'M', u'ἦι'),
+    (0x1F9F, 'M', u'ἧι'),
+    (0x1FA0, 'M', u'ὠι'),
+    (0x1FA1, 'M', u'ὡι'),
+    (0x1FA2, 'M', u'ὢι'),
+    (0x1FA3, 'M', u'ὣι'),
+    ]
+
+def _seg_20():
+    return [
+    (0x1FA4, 'M', u'ὤι'),
+    (0x1FA5, 'M', u'ὥι'),
+    (0x1FA6, 'M', u'ὦι'),
+    (0x1FA7, 'M', u'ὧι'),
+    (0x1FA8, 'M', u'ὠι'),
+    (0x1FA9, 'M', u'ὡι'),
+    (0x1FAA, 'M', u'ὢι'),
+    (0x1FAB, 'M', u'ὣι'),
+    (0x1FAC, 'M', u'ὤι'),
+    (0x1FAD, 'M', u'ὥι'),
+    (0x1FAE, 'M', u'ὦι'),
+    (0x1FAF, 'M', u'ὧι'),
+    (0x1FB0, 'V'),
+    (0x1FB2, 'M', u'ὰι'),
+    (0x1FB3, 'M', u'αι'),
+    (0x1FB4, 'M', u'άι'),
+    (0x1FB5, 'X'),
+    (0x1FB6, 'V'),
+    (0x1FB7, 'M', u'ᾶι'),
+    (0x1FB8, 'M', u'ᾰ'),
+    (0x1FB9, 'M', u'ᾱ'),
+    (0x1FBA, 'M', u'ὰ'),
+    (0x1FBB, 'M', u'ά'),
+    (0x1FBC, 'M', u'αι'),
+    (0x1FBD, '3', u' ̓'),
+    (0x1FBE, 'M', u'ι'),
+    (0x1FBF, '3', u' ̓'),
+    (0x1FC0, '3', u' ͂'),
+    (0x1FC1, '3', u' ̈͂'),
+    (0x1FC2, 'M', u'ὴι'),
+    (0x1FC3, 'M', u'ηι'),
+    (0x1FC4, 'M', u'ήι'),
+    (0x1FC5, 'X'),
+    (0x1FC6, 'V'),
+    (0x1FC7, 'M', u'ῆι'),
+    (0x1FC8, 'M', u'ὲ'),
+    (0x1FC9, 'M', u'έ'),
+    (0x1FCA, 'M', u'ὴ'),
+    (0x1FCB, 'M', u'ή'),
+    (0x1FCC, 'M', u'ηι'),
+    (0x1FCD, '3', u' ̓̀'),
+    (0x1FCE, '3', u' ̓́'),
+    (0x1FCF, '3', u' ̓͂'),
+    (0x1FD0, 'V'),
+    (0x1FD3, 'M', u'ΐ'),
+    (0x1FD4, 'X'),
+    (0x1FD6, 'V'),
+    (0x1FD8, 'M', u'ῐ'),
+    (0x1FD9, 'M', u'ῑ'),
+    (0x1FDA, 'M', u'ὶ'),
+    (0x1FDB, 'M', u'ί'),
+    (0x1FDC, 'X'),
+    (0x1FDD, '3', u' ̔̀'),
+    (0x1FDE, '3', u' ̔́'),
+    (0x1FDF, '3', u' ̔͂'),
+    (0x1FE0, 'V'),
+    (0x1FE3, 'M', u'ΰ'),
+    (0x1FE4, 'V'),
+    (0x1FE8, 'M', u'ῠ'),
+    (0x1FE9, 'M', u'ῡ'),
+    (0x1FEA, 'M', u'ὺ'),
+    (0x1FEB, 'M', u'ύ'),
+    (0x1FEC, 'M', u'ῥ'),
+    (0x1FED, '3', u' ̈̀'),
+    (0x1FEE, '3', u' ̈́'),
+    (0x1FEF, '3', u'`'),
+    (0x1FF0, 'X'),
+    (0x1FF2, 'M', u'ὼι'),
+    (0x1FF3, 'M', u'ωι'),
+    (0x1FF4, 'M', u'ώι'),
+    (0x1FF5, 'X'),
+    (0x1FF6, 'V'),
+    (0x1FF7, 'M', u'ῶι'),
+    (0x1FF8, 'M', u'ὸ'),
+    (0x1FF9, 'M', u'ό'),
+    (0x1FFA, 'M', u'ὼ'),
+    (0x1FFB, 'M', u'ώ'),
+    (0x1FFC, 'M', u'ωι'),
+    (0x1FFD, '3', u' ́'),
+    (0x1FFE, '3', u' ̔'),
+    (0x1FFF, 'X'),
+    (0x2000, '3', u' '),
+    (0x200B, 'I'),
+    (0x200C, 'D', u''),
+    (0x200E, 'X'),
+    (0x2010, 'V'),
+    (0x2011, 'M', u'‐'),
+    (0x2012, 'V'),
+    (0x2017, '3', u' ̳'),
+    (0x2018, 'V'),
+    (0x2024, 'X'),
+    (0x2027, 'V'),
+    (0x2028, 'X'),
+    (0x202F, '3', u' '),
+    (0x2030, 'V'),
+    (0x2033, 'M', u'′′'),
+    (0x2034, 'M', u'′′′'),
+    (0x2035, 'V'),
+    (0x2036, 'M', u'‵‵'),
+    (0x2037, 'M', u'‵‵‵'),
+    ]
+
+def _seg_21():
+    return [
+    (0x2038, 'V'),
+    (0x203C, '3', u'!!'),
+    (0x203D, 'V'),
+    (0x203E, '3', u' ̅'),
+    (0x203F, 'V'),
+    (0x2047, '3', u'??'),
+    (0x2048, '3', u'?!'),
+    (0x2049, '3', u'!?'),
+    (0x204A, 'V'),
+    (0x2057, 'M', u'′′′′'),
+    (0x2058, 'V'),
+    (0x205F, '3', u' '),
+    (0x2060, 'I'),
+    (0x2061, 'X'),
+    (0x2064, 'I'),
+    (0x2065, 'X'),
+    (0x2070, 'M', u'0'),
+    (0x2071, 'M', u'i'),
+    (0x2072, 'X'),
+    (0x2074, 'M', u'4'),
+    (0x2075, 'M', u'5'),
+    (0x2076, 'M', u'6'),
+    (0x2077, 'M', u'7'),
+    (0x2078, 'M', u'8'),
+    (0x2079, 'M', u'9'),
+    (0x207A, '3', u'+'),
+    (0x207B, 'M', u'−'),
+    (0x207C, '3', u'='),
+    (0x207D, '3', u'('),
+    (0x207E, '3', u')'),
+    (0x207F, 'M', u'n'),
+    (0x2080, 'M', u'0'),
+    (0x2081, 'M', u'1'),
+    (0x2082, 'M', u'2'),
+    (0x2083, 'M', u'3'),
+    (0x2084, 'M', u'4'),
+    (0x2085, 'M', u'5'),
+    (0x2086, 'M', u'6'),
+    (0x2087, 'M', u'7'),
+    (0x2088, 'M', u'8'),
+    (0x2089, 'M', u'9'),
+    (0x208A, '3', u'+'),
+    (0x208B, 'M', u'−'),
+    (0x208C, '3', u'='),
+    (0x208D, '3', u'('),
+    (0x208E, '3', u')'),
+    (0x208F, 'X'),
+    (0x2090, 'M', u'a'),
+    (0x2091, 'M', u'e'),
+    (0x2092, 'M', u'o'),
+    (0x2093, 'M', u'x'),
+    (0x2094, 'M', u'ə'),
+    (0x2095, 'M', u'h'),
+    (0x2096, 'M', u'k'),
+    (0x2097, 'M', u'l'),
+    (0x2098, 'M', u'm'),
+    (0x2099, 'M', u'n'),
+    (0x209A, 'M', u'p'),
+    (0x209B, 'M', u's'),
+    (0x209C, 'M', u't'),
+    (0x209D, 'X'),
+    (0x20A0, 'V'),
+    (0x20A8, 'M', u'rs'),
+    (0x20A9, 'V'),
+    (0x20C0, 'X'),
+    (0x20D0, 'V'),
+    (0x20F1, 'X'),
+    (0x2100, '3', u'a/c'),
+    (0x2101, '3', u'a/s'),
+    (0x2102, 'M', u'c'),
+    (0x2103, 'M', u'°c'),
+    (0x2104, 'V'),
+    (0x2105, '3', u'c/o'),
+    (0x2106, '3', u'c/u'),
+    (0x2107, 'M', u'ɛ'),
+    (0x2108, 'V'),
+    (0x2109, 'M', u'°f'),
+    (0x210A, 'M', u'g'),
+    (0x210B, 'M', u'h'),
+    (0x210F, 'M', u'ħ'),
+    (0x2110, 'M', u'i'),
+    (0x2112, 'M', u'l'),
+    (0x2114, 'V'),
+    (0x2115, 'M', u'n'),
+    (0x2116, 'M', u'no'),
+    (0x2117, 'V'),
+    (0x2119, 'M', u'p'),
+    (0x211A, 'M', u'q'),
+    (0x211B, 'M', u'r'),
+    (0x211E, 'V'),
+    (0x2120, 'M', u'sm'),
+    (0x2121, 'M', u'tel'),
+    (0x2122, 'M', u'tm'),
+    (0x2123, 'V'),
+    (0x2124, 'M', u'z'),
+    (0x2125, 'V'),
+    (0x2126, 'M', u'ω'),
+    (0x2127, 'V'),
+    (0x2128, 'M', u'z'),
+    (0x2129, 'V'),
+    ]
+
+def _seg_22():
+    return [
+    (0x212A, 'M', u'k'),
+    (0x212B, 'M', u'å'),
+    (0x212C, 'M', u'b'),
+    (0x212D, 'M', u'c'),
+    (0x212E, 'V'),
+    (0x212F, 'M', u'e'),
+    (0x2131, 'M', u'f'),
+    (0x2132, 'X'),
+    (0x2133, 'M', u'm'),
+    (0x2134, 'M', u'o'),
+    (0x2135, 'M', u'א'),
+    (0x2136, 'M', u'ב'),
+    (0x2137, 'M', u'ג'),
+    (0x2138, 'M', u'ד'),
+    (0x2139, 'M', u'i'),
+    (0x213A, 'V'),
+    (0x213B, 'M', u'fax'),
+    (0x213C, 'M', u'π'),
+    (0x213D, 'M', u'γ'),
+    (0x213F, 'M', u'π'),
+    (0x2140, 'M', u'∑'),
+    (0x2141, 'V'),
+    (0x2145, 'M', u'd'),
+    (0x2147, 'M', u'e'),
+    (0x2148, 'M', u'i'),
+    (0x2149, 'M', u'j'),
+    (0x214A, 'V'),
+    (0x2150, 'M', u'1⁄7'),
+    (0x2151, 'M', u'1⁄9'),
+    (0x2152, 'M', u'1⁄10'),
+    (0x2153, 'M', u'1⁄3'),
+    (0x2154, 'M', u'2⁄3'),
+    (0x2155, 'M', u'1⁄5'),
+    (0x2156, 'M', u'2⁄5'),
+    (0x2157, 'M', u'3⁄5'),
+    (0x2158, 'M', u'4⁄5'),
+    (0x2159, 'M', u'1⁄6'),
+    (0x215A, 'M', u'5⁄6'),
+    (0x215B, 'M', u'1⁄8'),
+    (0x215C, 'M', u'3⁄8'),
+    (0x215D, 'M', u'5⁄8'),
+    (0x215E, 'M', u'7⁄8'),
+    (0x215F, 'M', u'1⁄'),
+    (0x2160, 'M', u'i'),
+    (0x2161, 'M', u'ii'),
+    (0x2162, 'M', u'iii'),
+    (0x2163, 'M', u'iv'),
+    (0x2164, 'M', u'v'),
+    (0x2165, 'M', u'vi'),
+    (0x2166, 'M', u'vii'),
+    (0x2167, 'M', u'viii'),
+    (0x2168, 'M', u'ix'),
+    (0x2169, 'M', u'x'),
+    (0x216A, 'M', u'xi'),
+    (0x216B, 'M', u'xii'),
+    (0x216C, 'M', u'l'),
+    (0x216D, 'M', u'c'),
+    (0x216E, 'M', u'd'),
+    (0x216F, 'M', u'm'),
+    (0x2170, 'M', u'i'),
+    (0x2171, 'M', u'ii'),
+    (0x2172, 'M', u'iii'),
+    (0x2173, 'M', u'iv'),
+    (0x2174, 'M', u'v'),
+    (0x2175, 'M', u'vi'),
+    (0x2176, 'M', u'vii'),
+    (0x2177, 'M', u'viii'),
+    (0x2178, 'M', u'ix'),
+    (0x2179, 'M', u'x'),
+    (0x217A, 'M', u'xi'),
+    (0x217B, 'M', u'xii'),
+    (0x217C, 'M', u'l'),
+    (0x217D, 'M', u'c'),
+    (0x217E, 'M', u'd'),
+    (0x217F, 'M', u'm'),
+    (0x2180, 'V'),
+    (0x2183, 'X'),
+    (0x2184, 'V'),
+    (0x2189, 'M', u'0⁄3'),
+    (0x218A, 'V'),
+    (0x218C, 'X'),
+    (0x2190, 'V'),
+    (0x222C, 'M', u'∫∫'),
+    (0x222D, 'M', u'∫∫∫'),
+    (0x222E, 'V'),
+    (0x222F, 'M', u'∮∮'),
+    (0x2230, 'M', u'∮∮∮'),
+    (0x2231, 'V'),
+    (0x2260, '3'),
+    (0x2261, 'V'),
+    (0x226E, '3'),
+    (0x2270, 'V'),
+    (0x2329, 'M', u'〈'),
+    (0x232A, 'M', u'〉'),
+    (0x232B, 'V'),
+    (0x2427, 'X'),
+    (0x2440, 'V'),
+    (0x244B, 'X'),
+    (0x2460, 'M', u'1'),
+    (0x2461, 'M', u'2'),
+    ]
+
+def _seg_23():
+    return [
+    (0x2462, 'M', u'3'),
+    (0x2463, 'M', u'4'),
+    (0x2464, 'M', u'5'),
+    (0x2465, 'M', u'6'),
+    (0x2466, 'M', u'7'),
+    (0x2467, 'M', u'8'),
+    (0x2468, 'M', u'9'),
+    (0x2469, 'M', u'10'),
+    (0x246A, 'M', u'11'),
+    (0x246B, 'M', u'12'),
+    (0x246C, 'M', u'13'),
+    (0x246D, 'M', u'14'),
+    (0x246E, 'M', u'15'),
+    (0x246F, 'M', u'16'),
+    (0x2470, 'M', u'17'),
+    (0x2471, 'M', u'18'),
+    (0x2472, 'M', u'19'),
+    (0x2473, 'M', u'20'),
+    (0x2474, '3', u'(1)'),
+    (0x2475, '3', u'(2)'),
+    (0x2476, '3', u'(3)'),
+    (0x2477, '3', u'(4)'),
+    (0x2478, '3', u'(5)'),
+    (0x2479, '3', u'(6)'),
+    (0x247A, '3', u'(7)'),
+    (0x247B, '3', u'(8)'),
+    (0x247C, '3', u'(9)'),
+    (0x247D, '3', u'(10)'),
+    (0x247E, '3', u'(11)'),
+    (0x247F, '3', u'(12)'),
+    (0x2480, '3', u'(13)'),
+    (0x2481, '3', u'(14)'),
+    (0x2482, '3', u'(15)'),
+    (0x2483, '3', u'(16)'),
+    (0x2484, '3', u'(17)'),
+    (0x2485, '3', u'(18)'),
+    (0x2486, '3', u'(19)'),
+    (0x2487, '3', u'(20)'),
+    (0x2488, 'X'),
+    (0x249C, '3', u'(a)'),
+    (0x249D, '3', u'(b)'),
+    (0x249E, '3', u'(c)'),
+    (0x249F, '3', u'(d)'),
+    (0x24A0, '3', u'(e)'),
+    (0x24A1, '3', u'(f)'),
+    (0x24A2, '3', u'(g)'),
+    (0x24A3, '3', u'(h)'),
+    (0x24A4, '3', u'(i)'),
+    (0x24A5, '3', u'(j)'),
+    (0x24A6, '3', u'(k)'),
+    (0x24A7, '3', u'(l)'),
+    (0x24A8, '3', u'(m)'),
+    (0x24A9, '3', u'(n)'),
+    (0x24AA, '3', u'(o)'),
+    (0x24AB, '3', u'(p)'),
+    (0x24AC, '3', u'(q)'),
+    (0x24AD, '3', u'(r)'),
+    (0x24AE, '3', u'(s)'),
+    (0x24AF, '3', u'(t)'),
+    (0x24B0, '3', u'(u)'),
+    (0x24B1, '3', u'(v)'),
+    (0x24B2, '3', u'(w)'),
+    (0x24B3, '3', u'(x)'),
+    (0x24B4, '3', u'(y)'),
+    (0x24B5, '3', u'(z)'),
+    (0x24B6, 'M', u'a'),
+    (0x24B7, 'M', u'b'),
+    (0x24B8, 'M', u'c'),
+    (0x24B9, 'M', u'd'),
+    (0x24BA, 'M', u'e'),
+    (0x24BB, 'M', u'f'),
+    (0x24BC, 'M', u'g'),
+    (0x24BD, 'M', u'h'),
+    (0x24BE, 'M', u'i'),
+    (0x24BF, 'M', u'j'),
+    (0x24C0, 'M', u'k'),
+    (0x24C1, 'M', u'l'),
+    (0x24C2, 'M', u'm'),
+    (0x24C3, 'M', u'n'),
+    (0x24C4, 'M', u'o'),
+    (0x24C5, 'M', u'p'),
+    (0x24C6, 'M', u'q'),
+    (0x24C7, 'M', u'r'),
+    (0x24C8, 'M', u's'),
+    (0x24C9, 'M', u't'),
+    (0x24CA, 'M', u'u'),
+    (0x24CB, 'M', u'v'),
+    (0x24CC, 'M', u'w'),
+    (0x24CD, 'M', u'x'),
+    (0x24CE, 'M', u'y'),
+    (0x24CF, 'M', u'z'),
+    (0x24D0, 'M', u'a'),
+    (0x24D1, 'M', u'b'),
+    (0x24D2, 'M', u'c'),
+    (0x24D3, 'M', u'd'),
+    (0x24D4, 'M', u'e'),
+    (0x24D5, 'M', u'f'),
+    (0x24D6, 'M', u'g'),
+    (0x24D7, 'M', u'h'),
+    (0x24D8, 'M', u'i'),
+    ]
+
+def _seg_24():
+    return [
+    (0x24D9, 'M', u'j'),
+    (0x24DA, 'M', u'k'),
+    (0x24DB, 'M', u'l'),
+    (0x24DC, 'M', u'm'),
+    (0x24DD, 'M', u'n'),
+    (0x24DE, 'M', u'o'),
+    (0x24DF, 'M', u'p'),
+    (0x24E0, 'M', u'q'),
+    (0x24E1, 'M', u'r'),
+    (0x24E2, 'M', u's'),
+    (0x24E3, 'M', u't'),
+    (0x24E4, 'M', u'u'),
+    (0x24E5, 'M', u'v'),
+    (0x24E6, 'M', u'w'),
+    (0x24E7, 'M', u'x'),
+    (0x24E8, 'M', u'y'),
+    (0x24E9, 'M', u'z'),
+    (0x24EA, 'M', u'0'),
+    (0x24EB, 'V'),
+    (0x2A0C, 'M', u'∫∫∫∫'),
+    (0x2A0D, 'V'),
+    (0x2A74, '3', u'::='),
+    (0x2A75, '3', u'=='),
+    (0x2A76, '3', u'==='),
+    (0x2A77, 'V'),
+    (0x2ADC, 'M', u'⫝̸'),
+    (0x2ADD, 'V'),
+    (0x2B74, 'X'),
+    (0x2B76, 'V'),
+    (0x2B96, 'X'),
+    (0x2B98, 'V'),
+    (0x2BC9, 'X'),
+    (0x2BCA, 'V'),
+    (0x2BFF, 'X'),
+    (0x2C00, 'M', u'ⰰ'),
+    (0x2C01, 'M', u'ⰱ'),
+    (0x2C02, 'M', u'ⰲ'),
+    (0x2C03, 'M', u'ⰳ'),
+    (0x2C04, 'M', u'ⰴ'),
+    (0x2C05, 'M', u'ⰵ'),
+    (0x2C06, 'M', u'ⰶ'),
+    (0x2C07, 'M', u'ⰷ'),
+    (0x2C08, 'M', u'ⰸ'),
+    (0x2C09, 'M', u'ⰹ'),
+    (0x2C0A, 'M', u'ⰺ'),
+    (0x2C0B, 'M', u'ⰻ'),
+    (0x2C0C, 'M', u'ⰼ'),
+    (0x2C0D, 'M', u'ⰽ'),
+    (0x2C0E, 'M', u'ⰾ'),
+    (0x2C0F, 'M', u'ⰿ'),
+    (0x2C10, 'M', u'ⱀ'),
+    (0x2C11, 'M', u'ⱁ'),
+    (0x2C12, 'M', u'ⱂ'),
+    (0x2C13, 'M', u'ⱃ'),
+    (0x2C14, 'M', u'ⱄ'),
+    (0x2C15, 'M', u'ⱅ'),
+    (0x2C16, 'M', u'ⱆ'),
+    (0x2C17, 'M', u'ⱇ'),
+    (0x2C18, 'M', u'ⱈ'),
+    (0x2C19, 'M', u'ⱉ'),
+    (0x2C1A, 'M', u'ⱊ'),
+    (0x2C1B, 'M', u'ⱋ'),
+    (0x2C1C, 'M', u'ⱌ'),
+    (0x2C1D, 'M', u'ⱍ'),
+    (0x2C1E, 'M', u'ⱎ'),
+    (0x2C1F, 'M', u'ⱏ'),
+    (0x2C20, 'M', u'ⱐ'),
+    (0x2C21, 'M', u'ⱑ'),
+    (0x2C22, 'M', u'ⱒ'),
+    (0x2C23, 'M', u'ⱓ'),
+    (0x2C24, 'M', u'ⱔ'),
+    (0x2C25, 'M', u'ⱕ'),
+    (0x2C26, 'M', u'ⱖ'),
+    (0x2C27, 'M', u'ⱗ'),
+    (0x2C28, 'M', u'ⱘ'),
+    (0x2C29, 'M', u'ⱙ'),
+    (0x2C2A, 'M', u'ⱚ'),
+    (0x2C2B, 'M', u'ⱛ'),
+    (0x2C2C, 'M', u'ⱜ'),
+    (0x2C2D, 'M', u'ⱝ'),
+    (0x2C2E, 'M', u'ⱞ'),
+    (0x2C2F, 'X'),
+    (0x2C30, 'V'),
+    (0x2C5F, 'X'),
+    (0x2C60, 'M', u'ⱡ'),
+    (0x2C61, 'V'),
+    (0x2C62, 'M', u'ɫ'),
+    (0x2C63, 'M', u'ᵽ'),
+    (0x2C64, 'M', u'ɽ'),
+    (0x2C65, 'V'),
+    (0x2C67, 'M', u'ⱨ'),
+    (0x2C68, 'V'),
+    (0x2C69, 'M', u'ⱪ'),
+    (0x2C6A, 'V'),
+    (0x2C6B, 'M', u'ⱬ'),
+    (0x2C6C, 'V'),
+    (0x2C6D, 'M', u'ɑ'),
+    (0x2C6E, 'M', u'ɱ'),
+    (0x2C6F, 'M', u'ɐ'),
+    (0x2C70, 'M', u'ɒ'),
+    ]
+
+def _seg_25():
+    return [
+    (0x2C71, 'V'),
+    (0x2C72, 'M', u'ⱳ'),
+    (0x2C73, 'V'),
+    (0x2C75, 'M', u'ⱶ'),
+    (0x2C76, 'V'),
+    (0x2C7C, 'M', u'j'),
+    (0x2C7D, 'M', u'v'),
+    (0x2C7E, 'M', u'ȿ'),
+    (0x2C7F, 'M', u'ɀ'),
+    (0x2C80, 'M', u'ⲁ'),
+    (0x2C81, 'V'),
+    (0x2C82, 'M', u'ⲃ'),
+    (0x2C83, 'V'),
+    (0x2C84, 'M', u'ⲅ'),
+    (0x2C85, 'V'),
+    (0x2C86, 'M', u'ⲇ'),
+    (0x2C87, 'V'),
+    (0x2C88, 'M', u'ⲉ'),
+    (0x2C89, 'V'),
+    (0x2C8A, 'M', u'ⲋ'),
+    (0x2C8B, 'V'),
+    (0x2C8C, 'M', u'ⲍ'),
+    (0x2C8D, 'V'),
+    (0x2C8E, 'M', u'ⲏ'),
+    (0x2C8F, 'V'),
+    (0x2C90, 'M', u'ⲑ'),
+    (0x2C91, 'V'),
+    (0x2C92, 'M', u'ⲓ'),
+    (0x2C93, 'V'),
+    (0x2C94, 'M', u'ⲕ'),
+    (0x2C95, 'V'),
+    (0x2C96, 'M', u'ⲗ'),
+    (0x2C97, 'V'),
+    (0x2C98, 'M', u'ⲙ'),
+    (0x2C99, 'V'),
+    (0x2C9A, 'M', u'ⲛ'),
+    (0x2C9B, 'V'),
+    (0x2C9C, 'M', u'ⲝ'),
+    (0x2C9D, 'V'),
+    (0x2C9E, 'M', u'ⲟ'),
+    (0x2C9F, 'V'),
+    (0x2CA0, 'M', u'ⲡ'),
+    (0x2CA1, 'V'),
+    (0x2CA2, 'M', u'ⲣ'),
+    (0x2CA3, 'V'),
+    (0x2CA4, 'M', u'ⲥ'),
+    (0x2CA5, 'V'),
+    (0x2CA6, 'M', u'ⲧ'),
+    (0x2CA7, 'V'),
+    (0x2CA8, 'M', u'ⲩ'),
+    (0x2CA9, 'V'),
+    (0x2CAA, 'M', u'ⲫ'),
+    (0x2CAB, 'V'),
+    (0x2CAC, 'M', u'ⲭ'),
+    (0x2CAD, 'V'),
+    (0x2CAE, 'M', u'ⲯ'),
+    (0x2CAF, 'V'),
+    (0x2CB0, 'M', u'ⲱ'),
+    (0x2CB1, 'V'),
+    (0x2CB2, 'M', u'ⲳ'),
+    (0x2CB3, 'V'),
+    (0x2CB4, 'M', u'ⲵ'),
+    (0x2CB5, 'V'),
+    (0x2CB6, 'M', u'ⲷ'),
+    (0x2CB7, 'V'),
+    (0x2CB8, 'M', u'ⲹ'),
+    (0x2CB9, 'V'),
+    (0x2CBA, 'M', u'ⲻ'),
+    (0x2CBB, 'V'),
+    (0x2CBC, 'M', u'ⲽ'),
+    (0x2CBD, 'V'),
+    (0x2CBE, 'M', u'ⲿ'),
+    (0x2CBF, 'V'),
+    (0x2CC0, 'M', u'ⳁ'),
+    (0x2CC1, 'V'),
+    (0x2CC2, 'M', u'ⳃ'),
+    (0x2CC3, 'V'),
+    (0x2CC4, 'M', u'ⳅ'),
+    (0x2CC5, 'V'),
+    (0x2CC6, 'M', u'ⳇ'),
+    (0x2CC7, 'V'),
+    (0x2CC8, 'M', u'ⳉ'),
+    (0x2CC9, 'V'),
+    (0x2CCA, 'M', u'ⳋ'),
+    (0x2CCB, 'V'),
+    (0x2CCC, 'M', u'ⳍ'),
+    (0x2CCD, 'V'),
+    (0x2CCE, 'M', u'ⳏ'),
+    (0x2CCF, 'V'),
+    (0x2CD0, 'M', u'ⳑ'),
+    (0x2CD1, 'V'),
+    (0x2CD2, 'M', u'ⳓ'),
+    (0x2CD3, 'V'),
+    (0x2CD4, 'M', u'ⳕ'),
+    (0x2CD5, 'V'),
+    (0x2CD6, 'M', u'ⳗ'),
+    (0x2CD7, 'V'),
+    (0x2CD8, 'M', u'ⳙ'),
+    (0x2CD9, 'V'),
+    (0x2CDA, 'M', u'ⳛ'),
+    ]
+
+def _seg_26():
+    return [
+    (0x2CDB, 'V'),
+    (0x2CDC, 'M', u'ⳝ'),
+    (0x2CDD, 'V'),
+    (0x2CDE, 'M', u'ⳟ'),
+    (0x2CDF, 'V'),
+    (0x2CE0, 'M', u'ⳡ'),
+    (0x2CE1, 'V'),
+    (0x2CE2, 'M', u'ⳣ'),
+    (0x2CE3, 'V'),
+    (0x2CEB, 'M', u'ⳬ'),
+    (0x2CEC, 'V'),
+    (0x2CED, 'M', u'ⳮ'),
+    (0x2CEE, 'V'),
+    (0x2CF2, 'M', u'ⳳ'),
+    (0x2CF3, 'V'),
+    (0x2CF4, 'X'),
+    (0x2CF9, 'V'),
+    (0x2D26, 'X'),
+    (0x2D27, 'V'),
+    (0x2D28, 'X'),
+    (0x2D2D, 'V'),
+    (0x2D2E, 'X'),
+    (0x2D30, 'V'),
+    (0x2D68, 'X'),
+    (0x2D6F, 'M', u'ⵡ'),
+    (0x2D70, 'V'),
+    (0x2D71, 'X'),
+    (0x2D7F, 'V'),
+    (0x2D97, 'X'),
+    (0x2DA0, 'V'),
+    (0x2DA7, 'X'),
+    (0x2DA8, 'V'),
+    (0x2DAF, 'X'),
+    (0x2DB0, 'V'),
+    (0x2DB7, 'X'),
+    (0x2DB8, 'V'),
+    (0x2DBF, 'X'),
+    (0x2DC0, 'V'),
+    (0x2DC7, 'X'),
+    (0x2DC8, 'V'),
+    (0x2DCF, 'X'),
+    (0x2DD0, 'V'),
+    (0x2DD7, 'X'),
+    (0x2DD8, 'V'),
+    (0x2DDF, 'X'),
+    (0x2DE0, 'V'),
+    (0x2E4F, 'X'),
+    (0x2E80, 'V'),
+    (0x2E9A, 'X'),
+    (0x2E9B, 'V'),
+    (0x2E9F, 'M', u'母'),
+    (0x2EA0, 'V'),
+    (0x2EF3, 'M', u'龟'),
+    (0x2EF4, 'X'),
+    (0x2F00, 'M', u'一'),
+    (0x2F01, 'M', u'丨'),
+    (0x2F02, 'M', u'丶'),
+    (0x2F03, 'M', u'丿'),
+    (0x2F04, 'M', u'乙'),
+    (0x2F05, 'M', u'亅'),
+    (0x2F06, 'M', u'二'),
+    (0x2F07, 'M', u'亠'),
+    (0x2F08, 'M', u'人'),
+    (0x2F09, 'M', u'儿'),
+    (0x2F0A, 'M', u'入'),
+    (0x2F0B, 'M', u'八'),
+    (0x2F0C, 'M', u'冂'),
+    (0x2F0D, 'M', u'冖'),
+    (0x2F0E, 'M', u'冫'),
+    (0x2F0F, 'M', u'几'),
+    (0x2F10, 'M', u'凵'),
+    (0x2F11, 'M', u'刀'),
+    (0x2F12, 'M', u'力'),
+    (0x2F13, 'M', u'勹'),
+    (0x2F14, 'M', u'匕'),
+    (0x2F15, 'M', u'匚'),
+    (0x2F16, 'M', u'匸'),
+    (0x2F17, 'M', u'十'),
+    (0x2F18, 'M', u'卜'),
+    (0x2F19, 'M', u'卩'),
+    (0x2F1A, 'M', u'厂'),
+    (0x2F1B, 'M', u'厶'),
+    (0x2F1C, 'M', u'又'),
+    (0x2F1D, 'M', u'口'),
+    (0x2F1E, 'M', u'囗'),
+    (0x2F1F, 'M', u'土'),
+    (0x2F20, 'M', u'士'),
+    (0x2F21, 'M', u'夂'),
+    (0x2F22, 'M', u'夊'),
+    (0x2F23, 'M', u'夕'),
+    (0x2F24, 'M', u'大'),
+    (0x2F25, 'M', u'女'),
+    (0x2F26, 'M', u'子'),
+    (0x2F27, 'M', u'宀'),
+    (0x2F28, 'M', u'寸'),
+    (0x2F29, 'M', u'小'),
+    (0x2F2A, 'M', u'尢'),
+    (0x2F2B, 'M', u'尸'),
+    (0x2F2C, 'M', u'屮'),
+    (0x2F2D, 'M', u'山'),
+    ]
+
+def _seg_27():
+    return [
+    (0x2F2E, 'M', u'巛'),
+    (0x2F2F, 'M', u'工'),
+    (0x2F30, 'M', u'己'),
+    (0x2F31, 'M', u'巾'),
+    (0x2F32, 'M', u'干'),
+    (0x2F33, 'M', u'幺'),
+    (0x2F34, 'M', u'广'),
+    (0x2F35, 'M', u'廴'),
+    (0x2F36, 'M', u'廾'),
+    (0x2F37, 'M', u'弋'),
+    (0x2F38, 'M', u'弓'),
+    (0x2F39, 'M', u'彐'),
+    (0x2F3A, 'M', u'彡'),
+    (0x2F3B, 'M', u'彳'),
+    (0x2F3C, 'M', u'心'),
+    (0x2F3D, 'M', u'戈'),
+    (0x2F3E, 'M', u'戶'),
+    (0x2F3F, 'M', u'手'),
+    (0x2F40, 'M', u'支'),
+    (0x2F41, 'M', u'攴'),
+    (0x2F42, 'M', u'文'),
+    (0x2F43, 'M', u'斗'),
+    (0x2F44, 'M', u'斤'),
+    (0x2F45, 'M', u'方'),
+    (0x2F46, 'M', u'无'),
+    (0x2F47, 'M', u'日'),
+    (0x2F48, 'M', u'曰'),
+    (0x2F49, 'M', u'月'),
+    (0x2F4A, 'M', u'木'),
+    (0x2F4B, 'M', u'欠'),
+    (0x2F4C, 'M', u'止'),
+    (0x2F4D, 'M', u'歹'),
+    (0x2F4E, 'M', u'殳'),
+    (0x2F4F, 'M', u'毋'),
+    (0x2F50, 'M', u'比'),
+    (0x2F51, 'M', u'毛'),
+    (0x2F52, 'M', u'氏'),
+    (0x2F53, 'M', u'气'),
+    (0x2F54, 'M', u'水'),
+    (0x2F55, 'M', u'火'),
+    (0x2F56, 'M', u'爪'),
+    (0x2F57, 'M', u'父'),
+    (0x2F58, 'M', u'爻'),
+    (0x2F59, 'M', u'爿'),
+    (0x2F5A, 'M', u'片'),
+    (0x2F5B, 'M', u'牙'),
+    (0x2F5C, 'M', u'牛'),
+    (0x2F5D, 'M', u'犬'),
+    (0x2F5E, 'M', u'玄'),
+    (0x2F5F, 'M', u'玉'),
+    (0x2F60, 'M', u'瓜'),
+    (0x2F61, 'M', u'瓦'),
+    (0x2F62, 'M', u'甘'),
+    (0x2F63, 'M', u'生'),
+    (0x2F64, 'M', u'用'),
+    (0x2F65, 'M', u'田'),
+    (0x2F66, 'M', u'疋'),
+    (0x2F67, 'M', u'疒'),
+    (0x2F68, 'M', u'癶'),
+    (0x2F69, 'M', u'白'),
+    (0x2F6A, 'M', u'皮'),
+    (0x2F6B, 'M', u'皿'),
+    (0x2F6C, 'M', u'目'),
+    (0x2F6D, 'M', u'矛'),
+    (0x2F6E, 'M', u'矢'),
+    (0x2F6F, 'M', u'石'),
+    (0x2F70, 'M', u'示'),
+    (0x2F71, 'M', u'禸'),
+    (0x2F72, 'M', u'禾'),
+    (0x2F73, 'M', u'穴'),
+    (0x2F74, 'M', u'立'),
+    (0x2F75, 'M', u'竹'),
+    (0x2F76, 'M', u'米'),
+    (0x2F77, 'M', u'糸'),
+    (0x2F78, 'M', u'缶'),
+    (0x2F79, 'M', u'网'),
+    (0x2F7A, 'M', u'羊'),
+    (0x2F7B, 'M', u'羽'),
+    (0x2F7C, 'M', u'老'),
+    (0x2F7D, 'M', u'而'),
+    (0x2F7E, 'M', u'耒'),
+    (0x2F7F, 'M', u'耳'),
+    (0x2F80, 'M', u'聿'),
+    (0x2F81, 'M', u'肉'),
+    (0x2F82, 'M', u'臣'),
+    (0x2F83, 'M', u'自'),
+    (0x2F84, 'M', u'至'),
+    (0x2F85, 'M', u'臼'),
+    (0x2F86, 'M', u'舌'),
+    (0x2F87, 'M', u'舛'),
+    (0x2F88, 'M', u'舟'),
+    (0x2F89, 'M', u'艮'),
+    (0x2F8A, 'M', u'色'),
+    (0x2F8B, 'M', u'艸'),
+    (0x2F8C, 'M', u'虍'),
+    (0x2F8D, 'M', u'虫'),
+    (0x2F8E, 'M', u'血'),
+    (0x2F8F, 'M', u'行'),
+    (0x2F90, 'M', u'衣'),
+    (0x2F91, 'M', u'襾'),
+    ]
+
+def _seg_28():
+    return [
+    (0x2F92, 'M', u'見'),
+    (0x2F93, 'M', u'角'),
+    (0x2F94, 'M', u'言'),
+    (0x2F95, 'M', u'谷'),
+    (0x2F96, 'M', u'豆'),
+    (0x2F97, 'M', u'豕'),
+    (0x2F98, 'M', u'豸'),
+    (0x2F99, 'M', u'貝'),
+    (0x2F9A, 'M', u'赤'),
+    (0x2F9B, 'M', u'走'),
+    (0x2F9C, 'M', u'足'),
+    (0x2F9D, 'M', u'身'),
+    (0x2F9E, 'M', u'車'),
+    (0x2F9F, 'M', u'辛'),
+    (0x2FA0, 'M', u'辰'),
+    (0x2FA1, 'M', u'辵'),
+    (0x2FA2, 'M', u'邑'),
+    (0x2FA3, 'M', u'酉'),
+    (0x2FA4, 'M', u'釆'),
+    (0x2FA5, 'M', u'里'),
+    (0x2FA6, 'M', u'金'),
+    (0x2FA7, 'M', u'長'),
+    (0x2FA8, 'M', u'門'),
+    (0x2FA9, 'M', u'阜'),
+    (0x2FAA, 'M', u'隶'),
+    (0x2FAB, 'M', u'隹'),
+    (0x2FAC, 'M', u'雨'),
+    (0x2FAD, 'M', u'靑'),
+    (0x2FAE, 'M', u'非'),
+    (0x2FAF, 'M', u'面'),
+    (0x2FB0, 'M', u'革'),
+    (0x2FB1, 'M', u'韋'),
+    (0x2FB2, 'M', u'韭'),
+    (0x2FB3, 'M', u'音'),
+    (0x2FB4, 'M', u'頁'),
+    (0x2FB5, 'M', u'風'),
+    (0x2FB6, 'M', u'飛'),
+    (0x2FB7, 'M', u'食'),
+    (0x2FB8, 'M', u'首'),
+    (0x2FB9, 'M', u'香'),
+    (0x2FBA, 'M', u'馬'),
+    (0x2FBB, 'M', u'骨'),
+    (0x2FBC, 'M', u'高'),
+    (0x2FBD, 'M', u'髟'),
+    (0x2FBE, 'M', u'鬥'),
+    (0x2FBF, 'M', u'鬯'),
+    (0x2FC0, 'M', u'鬲'),
+    (0x2FC1, 'M', u'鬼'),
+    (0x2FC2, 'M', u'魚'),
+    (0x2FC3, 'M', u'鳥'),
+    (0x2FC4, 'M', u'鹵'),
+    (0x2FC5, 'M', u'鹿'),
+    (0x2FC6, 'M', u'麥'),
+    (0x2FC7, 'M', u'麻'),
+    (0x2FC8, 'M', u'黃'),
+    (0x2FC9, 'M', u'黍'),
+    (0x2FCA, 'M', u'黑'),
+    (0x2FCB, 'M', u'黹'),
+    (0x2FCC, 'M', u'黽'),
+    (0x2FCD, 'M', u'鼎'),
+    (0x2FCE, 'M', u'鼓'),
+    (0x2FCF, 'M', u'鼠'),
+    (0x2FD0, 'M', u'鼻'),
+    (0x2FD1, 'M', u'齊'),
+    (0x2FD2, 'M', u'齒'),
+    (0x2FD3, 'M', u'龍'),
+    (0x2FD4, 'M', u'龜'),
+    (0x2FD5, 'M', u'龠'),
+    (0x2FD6, 'X'),
+    (0x3000, '3', u' '),
+    (0x3001, 'V'),
+    (0x3002, 'M', u'.'),
+    (0x3003, 'V'),
+    (0x3036, 'M', u'〒'),
+    (0x3037, 'V'),
+    (0x3038, 'M', u'十'),
+    (0x3039, 'M', u'卄'),
+    (0x303A, 'M', u'卅'),
+    (0x303B, 'V'),
+    (0x3040, 'X'),
+    (0x3041, 'V'),
+    (0x3097, 'X'),
+    (0x3099, 'V'),
+    (0x309B, '3', u' ゙'),
+    (0x309C, '3', u' ゚'),
+    (0x309D, 'V'),
+    (0x309F, 'M', u'より'),
+    (0x30A0, 'V'),
+    (0x30FF, 'M', u'コト'),
+    (0x3100, 'X'),
+    (0x3105, 'V'),
+    (0x3130, 'X'),
+    (0x3131, 'M', u'ᄀ'),
+    (0x3132, 'M', u'ᄁ'),
+    (0x3133, 'M', u'ᆪ'),
+    (0x3134, 'M', u'ᄂ'),
+    (0x3135, 'M', u'ᆬ'),
+    (0x3136, 'M', u'ᆭ'),
+    (0x3137, 'M', u'ᄃ'),
+    (0x3138, 'M', u'ᄄ'),
+    ]
+
+def _seg_29():
+    return [
+    (0x3139, 'M', u'ᄅ'),
+    (0x313A, 'M', u'ᆰ'),
+    (0x313B, 'M', u'ᆱ'),
+    (0x313C, 'M', u'ᆲ'),
+    (0x313D, 'M', u'ᆳ'),
+    (0x313E, 'M', u'ᆴ'),
+    (0x313F, 'M', u'ᆵ'),
+    (0x3140, 'M', u'ᄚ'),
+    (0x3141, 'M', u'ᄆ'),
+    (0x3142, 'M', u'ᄇ'),
+    (0x3143, 'M', u'ᄈ'),
+    (0x3144, 'M', u'ᄡ'),
+    (0x3145, 'M', u'ᄉ'),
+    (0x3146, 'M', u'ᄊ'),
+    (0x3147, 'M', u'ᄋ'),
+    (0x3148, 'M', u'ᄌ'),
+    (0x3149, 'M', u'ᄍ'),
+    (0x314A, 'M', u'ᄎ'),
+    (0x314B, 'M', u'ᄏ'),
+    (0x314C, 'M', u'ᄐ'),
+    (0x314D, 'M', u'ᄑ'),
+    (0x314E, 'M', u'ᄒ'),
+    (0x314F, 'M', u'ᅡ'),
+    (0x3150, 'M', u'ᅢ'),
+    (0x3151, 'M', u'ᅣ'),
+    (0x3152, 'M', u'ᅤ'),
+    (0x3153, 'M', u'ᅥ'),
+    (0x3154, 'M', u'ᅦ'),
+    (0x3155, 'M', u'ᅧ'),
+    (0x3156, 'M', u'ᅨ'),
+    (0x3157, 'M', u'ᅩ'),
+    (0x3158, 'M', u'ᅪ'),
+    (0x3159, 'M', u'ᅫ'),
+    (0x315A, 'M', u'ᅬ'),
+    (0x315B, 'M', u'ᅭ'),
+    (0x315C, 'M', u'ᅮ'),
+    (0x315D, 'M', u'ᅯ'),
+    (0x315E, 'M', u'ᅰ'),
+    (0x315F, 'M', u'ᅱ'),
+    (0x3160, 'M', u'ᅲ'),
+    (0x3161, 'M', u'ᅳ'),
+    (0x3162, 'M', u'ᅴ'),
+    (0x3163, 'M', u'ᅵ'),
+    (0x3164, 'X'),
+    (0x3165, 'M', u'ᄔ'),
+    (0x3166, 'M', u'ᄕ'),
+    (0x3167, 'M', u'ᇇ'),
+    (0x3168, 'M', u'ᇈ'),
+    (0x3169, 'M', u'ᇌ'),
+    (0x316A, 'M', u'ᇎ'),
+    (0x316B, 'M', u'ᇓ'),
+    (0x316C, 'M', u'ᇗ'),
+    (0x316D, 'M', u'ᇙ'),
+    (0x316E, 'M', u'ᄜ'),
+    (0x316F, 'M', u'ᇝ'),
+    (0x3170, 'M', u'ᇟ'),
+    (0x3171, 'M', u'ᄝ'),
+    (0x3172, 'M', u'ᄞ'),
+    (0x3173, 'M', u'ᄠ'),
+    (0x3174, 'M', u'ᄢ'),
+    (0x3175, 'M', u'ᄣ'),
+    (0x3176, 'M', u'ᄧ'),
+    (0x3177, 'M', u'ᄩ'),
+    (0x3178, 'M', u'ᄫ'),
+    (0x3179, 'M', u'ᄬ'),
+    (0x317A, 'M', u'ᄭ'),
+    (0x317B, 'M', u'ᄮ'),
+    (0x317C, 'M', u'ᄯ'),
+    (0x317D, 'M', u'ᄲ'),
+    (0x317E, 'M', u'ᄶ'),
+    (0x317F, 'M', u'ᅀ'),
+    (0x3180, 'M', u'ᅇ'),
+    (0x3181, 'M', u'ᅌ'),
+    (0x3182, 'M', u'ᇱ'),
+    (0x3183, 'M', u'ᇲ'),
+    (0x3184, 'M', u'ᅗ'),
+    (0x3185, 'M', u'ᅘ'),
+    (0x3186, 'M', u'ᅙ'),
+    (0x3187, 'M', u'ᆄ'),
+    (0x3188, 'M', u'ᆅ'),
+    (0x3189, 'M', u'ᆈ'),
+    (0x318A, 'M', u'ᆑ'),
+    (0x318B, 'M', u'ᆒ'),
+    (0x318C, 'M', u'ᆔ'),
+    (0x318D, 'M', u'ᆞ'),
+    (0x318E, 'M', u'ᆡ'),
+    (0x318F, 'X'),
+    (0x3190, 'V'),
+    (0x3192, 'M', u'一'),
+    (0x3193, 'M', u'二'),
+    (0x3194, 'M', u'三'),
+    (0x3195, 'M', u'四'),
+    (0x3196, 'M', u'上'),
+    (0x3197, 'M', u'中'),
+    (0x3198, 'M', u'下'),
+    (0x3199, 'M', u'甲'),
+    (0x319A, 'M', u'乙'),
+    (0x319B, 'M', u'丙'),
+    (0x319C, 'M', u'丁'),
+    (0x319D, 'M', u'天'),
+    ]
+
+def _seg_30():
+    return [
+    (0x319E, 'M', u'地'),
+    (0x319F, 'M', u'人'),
+    (0x31A0, 'V'),
+    (0x31BB, 'X'),
+    (0x31C0, 'V'),
+    (0x31E4, 'X'),
+    (0x31F0, 'V'),
+    (0x3200, '3', u'(ᄀ)'),
+    (0x3201, '3', u'(ᄂ)'),
+    (0x3202, '3', u'(ᄃ)'),
+    (0x3203, '3', u'(ᄅ)'),
+    (0x3204, '3', u'(ᄆ)'),
+    (0x3205, '3', u'(ᄇ)'),
+    (0x3206, '3', u'(ᄉ)'),
+    (0x3207, '3', u'(ᄋ)'),
+    (0x3208, '3', u'(ᄌ)'),
+    (0x3209, '3', u'(ᄎ)'),
+    (0x320A, '3', u'(ᄏ)'),
+    (0x320B, '3', u'(ᄐ)'),
+    (0x320C, '3', u'(ᄑ)'),
+    (0x320D, '3', u'(ᄒ)'),
+    (0x320E, '3', u'(가)'),
+    (0x320F, '3', u'(나)'),
+    (0x3210, '3', u'(다)'),
+    (0x3211, '3', u'(라)'),
+    (0x3212, '3', u'(마)'),
+    (0x3213, '3', u'(바)'),
+    (0x3214, '3', u'(사)'),
+    (0x3215, '3', u'(아)'),
+    (0x3216, '3', u'(자)'),
+    (0x3217, '3', u'(차)'),
+    (0x3218, '3', u'(카)'),
+    (0x3219, '3', u'(타)'),
+    (0x321A, '3', u'(파)'),
+    (0x321B, '3', u'(하)'),
+    (0x321C, '3', u'(주)'),
+    (0x321D, '3', u'(오전)'),
+    (0x321E, '3', u'(오후)'),
+    (0x321F, 'X'),
+    (0x3220, '3', u'(一)'),
+    (0x3221, '3', u'(二)'),
+    (0x3222, '3', u'(三)'),
+    (0x3223, '3', u'(四)'),
+    (0x3224, '3', u'(五)'),
+    (0x3225, '3', u'(六)'),
+    (0x3226, '3', u'(七)'),
+    (0x3227, '3', u'(八)'),
+    (0x3228, '3', u'(九)'),
+    (0x3229, '3', u'(十)'),
+    (0x322A, '3', u'(月)'),
+    (0x322B, '3', u'(火)'),
+    (0x322C, '3', u'(水)'),
+    (0x322D, '3', u'(木)'),
+    (0x322E, '3', u'(金)'),
+    (0x322F, '3', u'(土)'),
+    (0x3230, '3', u'(日)'),
+    (0x3231, '3', u'(株)'),
+    (0x3232, '3', u'(有)'),
+    (0x3233, '3', u'(社)'),
+    (0x3234, '3', u'(名)'),
+    (0x3235, '3', u'(特)'),
+    (0x3236, '3', u'(財)'),
+    (0x3237, '3', u'(祝)'),
+    (0x3238, '3', u'(労)'),
+    (0x3239, '3', u'(代)'),
+    (0x323A, '3', u'(呼)'),
+    (0x323B, '3', u'(学)'),
+    (0x323C, '3', u'(監)'),
+    (0x323D, '3', u'(企)'),
+    (0x323E, '3', u'(資)'),
+    (0x323F, '3', u'(協)'),
+    (0x3240, '3', u'(祭)'),
+    (0x3241, '3', u'(休)'),
+    (0x3242, '3', u'(自)'),
+    (0x3243, '3', u'(至)'),
+    (0x3244, 'M', u'問'),
+    (0x3245, 'M', u'幼'),
+    (0x3246, 'M', u'文'),
+    (0x3247, 'M', u'箏'),
+    (0x3248, 'V'),
+    (0x3250, 'M', u'pte'),
+    (0x3251, 'M', u'21'),
+    (0x3252, 'M', u'22'),
+    (0x3253, 'M', u'23'),
+    (0x3254, 'M', u'24'),
+    (0x3255, 'M', u'25'),
+    (0x3256, 'M', u'26'),
+    (0x3257, 'M', u'27'),
+    (0x3258, 'M', u'28'),
+    (0x3259, 'M', u'29'),
+    (0x325A, 'M', u'30'),
+    (0x325B, 'M', u'31'),
+    (0x325C, 'M', u'32'),
+    (0x325D, 'M', u'33'),
+    (0x325E, 'M', u'34'),
+    (0x325F, 'M', u'35'),
+    (0x3260, 'M', u'ᄀ'),
+    (0x3261, 'M', u'ᄂ'),
+    (0x3262, 'M', u'ᄃ'),
+    (0x3263, 'M', u'ᄅ'),
+    ]
+
+def _seg_31():
+    return [
+    (0x3264, 'M', u'ᄆ'),
+    (0x3265, 'M', u'ᄇ'),
+    (0x3266, 'M', u'ᄉ'),
+    (0x3267, 'M', u'ᄋ'),
+    (0x3268, 'M', u'ᄌ'),
+    (0x3269, 'M', u'ᄎ'),
+    (0x326A, 'M', u'ᄏ'),
+    (0x326B, 'M', u'ᄐ'),
+    (0x326C, 'M', u'ᄑ'),
+    (0x326D, 'M', u'ᄒ'),
+    (0x326E, 'M', u'가'),
+    (0x326F, 'M', u'나'),
+    (0x3270, 'M', u'다'),
+    (0x3271, 'M', u'라'),
+    (0x3272, 'M', u'마'),
+    (0x3273, 'M', u'바'),
+    (0x3274, 'M', u'사'),
+    (0x3275, 'M', u'아'),
+    (0x3276, 'M', u'자'),
+    (0x3277, 'M', u'차'),
+    (0x3278, 'M', u'카'),
+    (0x3279, 'M', u'타'),
+    (0x327A, 'M', u'파'),
+    (0x327B, 'M', u'하'),
+    (0x327C, 'M', u'참고'),
+    (0x327D, 'M', u'주의'),
+    (0x327E, 'M', u'우'),
+    (0x327F, 'V'),
+    (0x3280, 'M', u'一'),
+    (0x3281, 'M', u'二'),
+    (0x3282, 'M', u'三'),
+    (0x3283, 'M', u'四'),
+    (0x3284, 'M', u'五'),
+    (0x3285, 'M', u'六'),
+    (0x3286, 'M', u'七'),
+    (0x3287, 'M', u'八'),
+    (0x3288, 'M', u'九'),
+    (0x3289, 'M', u'十'),
+    (0x328A, 'M', u'月'),
+    (0x328B, 'M', u'火'),
+    (0x328C, 'M', u'水'),
+    (0x328D, 'M', u'木'),
+    (0x328E, 'M', u'金'),
+    (0x328F, 'M', u'土'),
+    (0x3290, 'M', u'日'),
+    (0x3291, 'M', u'株'),
+    (0x3292, 'M', u'有'),
+    (0x3293, 'M', u'社'),
+    (0x3294, 'M', u'名'),
+    (0x3295, 'M', u'特'),
+    (0x3296, 'M', u'財'),
+    (0x3297, 'M', u'祝'),
+    (0x3298, 'M', u'労'),
+    (0x3299, 'M', u'秘'),
+    (0x329A, 'M', u'男'),
+    (0x329B, 'M', u'女'),
+    (0x329C, 'M', u'適'),
+    (0x329D, 'M', u'優'),
+    (0x329E, 'M', u'印'),
+    (0x329F, 'M', u'注'),
+    (0x32A0, 'M', u'項'),
+    (0x32A1, 'M', u'休'),
+    (0x32A2, 'M', u'写'),
+    (0x32A3, 'M', u'正'),
+    (0x32A4, 'M', u'上'),
+    (0x32A5, 'M', u'中'),
+    (0x32A6, 'M', u'下'),
+    (0x32A7, 'M', u'左'),
+    (0x32A8, 'M', u'右'),
+    (0x32A9, 'M', u'医'),
+    (0x32AA, 'M', u'宗'),
+    (0x32AB, 'M', u'学'),
+    (0x32AC, 'M', u'監'),
+    (0x32AD, 'M', u'企'),
+    (0x32AE, 'M', u'資'),
+    (0x32AF, 'M', u'協'),
+    (0x32B0, 'M', u'夜'),
+    (0x32B1, 'M', u'36'),
+    (0x32B2, 'M', u'37'),
+    (0x32B3, 'M', u'38'),
+    (0x32B4, 'M', u'39'),
+    (0x32B5, 'M', u'40'),
+    (0x32B6, 'M', u'41'),
+    (0x32B7, 'M', u'42'),
+    (0x32B8, 'M', u'43'),
+    (0x32B9, 'M', u'44'),
+    (0x32BA, 'M', u'45'),
+    (0x32BB, 'M', u'46'),
+    (0x32BC, 'M', u'47'),
+    (0x32BD, 'M', u'48'),
+    (0x32BE, 'M', u'49'),
+    (0x32BF, 'M', u'50'),
+    (0x32C0, 'M', u'1月'),
+    (0x32C1, 'M', u'2月'),
+    (0x32C2, 'M', u'3月'),
+    (0x32C3, 'M', u'4月'),
+    (0x32C4, 'M', u'5月'),
+    (0x32C5, 'M', u'6月'),
+    (0x32C6, 'M', u'7月'),
+    (0x32C7, 'M', u'8月'),
+    ]
+
+def _seg_32():
+    return [
+    (0x32C8, 'M', u'9月'),
+    (0x32C9, 'M', u'10月'),
+    (0x32CA, 'M', u'11月'),
+    (0x32CB, 'M', u'12月'),
+    (0x32CC, 'M', u'hg'),
+    (0x32CD, 'M', u'erg'),
+    (0x32CE, 'M', u'ev'),
+    (0x32CF, 'M', u'ltd'),
+    (0x32D0, 'M', u'ア'),
+    (0x32D1, 'M', u'イ'),
+    (0x32D2, 'M', u'ウ'),
+    (0x32D3, 'M', u'エ'),
+    (0x32D4, 'M', u'オ'),
+    (0x32D5, 'M', u'カ'),
+    (0x32D6, 'M', u'キ'),
+    (0x32D7, 'M', u'ク'),
+    (0x32D8, 'M', u'ケ'),
+    (0x32D9, 'M', u'コ'),
+    (0x32DA, 'M', u'サ'),
+    (0x32DB, 'M', u'シ'),
+    (0x32DC, 'M', u'ス'),
+    (0x32DD, 'M', u'セ'),
+    (0x32DE, 'M', u'ソ'),
+    (0x32DF, 'M', u'タ'),
+    (0x32E0, 'M', u'チ'),
+    (0x32E1, 'M', u'ツ'),
+    (0x32E2, 'M', u'テ'),
+    (0x32E3, 'M', u'ト'),
+    (0x32E4, 'M', u'ナ'),
+    (0x32E5, 'M', u'ニ'),
+    (0x32E6, 'M', u'ヌ'),
+    (0x32E7, 'M', u'ネ'),
+    (0x32E8, 'M', u'ノ'),
+    (0x32E9, 'M', u'ハ'),
+    (0x32EA, 'M', u'ヒ'),
+    (0x32EB, 'M', u'フ'),
+    (0x32EC, 'M', u'ヘ'),
+    (0x32ED, 'M', u'ホ'),
+    (0x32EE, 'M', u'マ'),
+    (0x32EF, 'M', u'ミ'),
+    (0x32F0, 'M', u'ム'),
+    (0x32F1, 'M', u'メ'),
+    (0x32F2, 'M', u'モ'),
+    (0x32F3, 'M', u'ヤ'),
+    (0x32F4, 'M', u'ユ'),
+    (0x32F5, 'M', u'ヨ'),
+    (0x32F6, 'M', u'ラ'),
+    (0x32F7, 'M', u'リ'),
+    (0x32F8, 'M', u'ル'),
+    (0x32F9, 'M', u'レ'),
+    (0x32FA, 'M', u'ロ'),
+    (0x32FB, 'M', u'ワ'),
+    (0x32FC, 'M', u'ヰ'),
+    (0x32FD, 'M', u'ヱ'),
+    (0x32FE, 'M', u'ヲ'),
+    (0x32FF, 'X'),
+    (0x3300, 'M', u'アパート'),
+    (0x3301, 'M', u'アルファ'),
+    (0x3302, 'M', u'アンペア'),
+    (0x3303, 'M', u'アール'),
+    (0x3304, 'M', u'イニング'),
+    (0x3305, 'M', u'インチ'),
+    (0x3306, 'M', u'ウォン'),
+    (0x3307, 'M', u'エスクード'),
+    (0x3308, 'M', u'エーカー'),
+    (0x3309, 'M', u'オンス'),
+    (0x330A, 'M', u'オーム'),
+    (0x330B, 'M', u'カイリ'),
+    (0x330C, 'M', u'カラット'),
+    (0x330D, 'M', u'カロリー'),
+    (0x330E, 'M', u'ガロン'),
+    (0x330F, 'M', u'ガンマ'),
+    (0x3310, 'M', u'ギガ'),
+    (0x3311, 'M', u'ギニー'),
+    (0x3312, 'M', u'キュリー'),
+    (0x3313, 'M', u'ギルダー'),
+    (0x3314, 'M', u'キロ'),
+    (0x3315, 'M', u'キログラム'),
+    (0x3316, 'M', u'キロメートル'),
+    (0x3317, 'M', u'キロワット'),
+    (0x3318, 'M', u'グラム'),
+    (0x3319, 'M', u'グラムトン'),
+    (0x331A, 'M', u'クルゼイロ'),
+    (0x331B, 'M', u'クローネ'),
+    (0x331C, 'M', u'ケース'),
+    (0x331D, 'M', u'コルナ'),
+    (0x331E, 'M', u'コーポ'),
+    (0x331F, 'M', u'サイクル'),
+    (0x3320, 'M', u'サンチーム'),
+    (0x3321, 'M', u'シリング'),
+    (0x3322, 'M', u'センチ'),
+    (0x3323, 'M', u'セント'),
+    (0x3324, 'M', u'ダース'),
+    (0x3325, 'M', u'デシ'),
+    (0x3326, 'M', u'ドル'),
+    (0x3327, 'M', u'トン'),
+    (0x3328, 'M', u'ナノ'),
+    (0x3329, 'M', u'ノット'),
+    (0x332A, 'M', u'ハイツ'),
+    (0x332B, 'M', u'パーセント'),
+    ]
+
+def _seg_33():
+    return [
+    (0x332C, 'M', u'パーツ'),
+    (0x332D, 'M', u'バーレル'),
+    (0x332E, 'M', u'ピアストル'),
+    (0x332F, 'M', u'ピクル'),
+    (0x3330, 'M', u'ピコ'),
+    (0x3331, 'M', u'ビル'),
+    (0x3332, 'M', u'ファラッド'),
+    (0x3333, 'M', u'フィート'),
+    (0x3334, 'M', u'ブッシェル'),
+    (0x3335, 'M', u'フラン'),
+    (0x3336, 'M', u'ヘクタール'),
+    (0x3337, 'M', u'ペソ'),
+    (0x3338, 'M', u'ペニヒ'),
+    (0x3339, 'M', u'ヘルツ'),
+    (0x333A, 'M', u'ペンス'),
+    (0x333B, 'M', u'ページ'),
+    (0x333C, 'M', u'ベータ'),
+    (0x333D, 'M', u'ポイント'),
+    (0x333E, 'M', u'ボルト'),
+    (0x333F, 'M', u'ホン'),
+    (0x3340, 'M', u'ポンド'),
+    (0x3341, 'M', u'ホール'),
+    (0x3342, 'M', u'ホーン'),
+    (0x3343, 'M', u'マイクロ'),
+    (0x3344, 'M', u'マイル'),
+    (0x3345, 'M', u'マッハ'),
+    (0x3346, 'M', u'マルク'),
+    (0x3347, 'M', u'マンション'),
+    (0x3348, 'M', u'ミクロン'),
+    (0x3349, 'M', u'ミリ'),
+    (0x334A, 'M', u'ミリバール'),
+    (0x334B, 'M', u'メガ'),
+    (0x334C, 'M', u'メガトン'),
+    (0x334D, 'M', u'メートル'),
+    (0x334E, 'M', u'ヤード'),
+    (0x334F, 'M', u'ヤール'),
+    (0x3350, 'M', u'ユアン'),
+    (0x3351, 'M', u'リットル'),
+    (0x3352, 'M', u'リラ'),
+    (0x3353, 'M', u'ルピー'),
+    (0x3354, 'M', u'ルーブル'),
+    (0x3355, 'M', u'レム'),
+    (0x3356, 'M', u'レントゲン'),
+    (0x3357, 'M', u'ワット'),
+    (0x3358, 'M', u'0点'),
+    (0x3359, 'M', u'1点'),
+    (0x335A, 'M', u'2点'),
+    (0x335B, 'M', u'3点'),
+    (0x335C, 'M', u'4点'),
+    (0x335D, 'M', u'5点'),
+    (0x335E, 'M', u'6点'),
+    (0x335F, 'M', u'7点'),
+    (0x3360, 'M', u'8点'),
+    (0x3361, 'M', u'9点'),
+    (0x3362, 'M', u'10点'),
+    (0x3363, 'M', u'11点'),
+    (0x3364, 'M', u'12点'),
+    (0x3365, 'M', u'13点'),
+    (0x3366, 'M', u'14点'),
+    (0x3367, 'M', u'15点'),
+    (0x3368, 'M', u'16点'),
+    (0x3369, 'M', u'17点'),
+    (0x336A, 'M', u'18点'),
+    (0x336B, 'M', u'19点'),
+    (0x336C, 'M', u'20点'),
+    (0x336D, 'M', u'21点'),
+    (0x336E, 'M', u'22点'),
+    (0x336F, 'M', u'23点'),
+    (0x3370, 'M', u'24点'),
+    (0x3371, 'M', u'hpa'),
+    (0x3372, 'M', u'da'),
+    (0x3373, 'M', u'au'),
+    (0x3374, 'M', u'bar'),
+    (0x3375, 'M', u'ov'),
+    (0x3376, 'M', u'pc'),
+    (0x3377, 'M', u'dm'),
+    (0x3378, 'M', u'dm2'),
+    (0x3379, 'M', u'dm3'),
+    (0x337A, 'M', u'iu'),
+    (0x337B, 'M', u'平成'),
+    (0x337C, 'M', u'昭和'),
+    (0x337D, 'M', u'大正'),
+    (0x337E, 'M', u'明治'),
+    (0x337F, 'M', u'株式会社'),
+    (0x3380, 'M', u'pa'),
+    (0x3381, 'M', u'na'),
+    (0x3382, 'M', u'μa'),
+    (0x3383, 'M', u'ma'),
+    (0x3384, 'M', u'ka'),
+    (0x3385, 'M', u'kb'),
+    (0x3386, 'M', u'mb'),
+    (0x3387, 'M', u'gb'),
+    (0x3388, 'M', u'cal'),
+    (0x3389, 'M', u'kcal'),
+    (0x338A, 'M', u'pf'),
+    (0x338B, 'M', u'nf'),
+    (0x338C, 'M', u'μf'),
+    (0x338D, 'M', u'μg'),
+    (0x338E, 'M', u'mg'),
+    (0x338F, 'M', u'kg'),
+    ]
+
+def _seg_34():
+    return [
+    (0x3390, 'M', u'hz'),
+    (0x3391, 'M', u'khz'),
+    (0x3392, 'M', u'mhz'),
+    (0x3393, 'M', u'ghz'),
+    (0x3394, 'M', u'thz'),
+    (0x3395, 'M', u'μl'),
+    (0x3396, 'M', u'ml'),
+    (0x3397, 'M', u'dl'),
+    (0x3398, 'M', u'kl'),
+    (0x3399, 'M', u'fm'),
+    (0x339A, 'M', u'nm'),
+    (0x339B, 'M', u'μm'),
+    (0x339C, 'M', u'mm'),
+    (0x339D, 'M', u'cm'),
+    (0x339E, 'M', u'km'),
+    (0x339F, 'M', u'mm2'),
+    (0x33A0, 'M', u'cm2'),
+    (0x33A1, 'M', u'm2'),
+    (0x33A2, 'M', u'km2'),
+    (0x33A3, 'M', u'mm3'),
+    (0x33A4, 'M', u'cm3'),
+    (0x33A5, 'M', u'm3'),
+    (0x33A6, 'M', u'km3'),
+    (0x33A7, 'M', u'm∕s'),
+    (0x33A8, 'M', u'm∕s2'),
+    (0x33A9, 'M', u'pa'),
+    (0x33AA, 'M', u'kpa'),
+    (0x33AB, 'M', u'mpa'),
+    (0x33AC, 'M', u'gpa'),
+    (0x33AD, 'M', u'rad'),
+    (0x33AE, 'M', u'rad∕s'),
+    (0x33AF, 'M', u'rad∕s2'),
+    (0x33B0, 'M', u'ps'),
+    (0x33B1, 'M', u'ns'),
+    (0x33B2, 'M', u'μs'),
+    (0x33B3, 'M', u'ms'),
+    (0x33B4, 'M', u'pv'),
+    (0x33B5, 'M', u'nv'),
+    (0x33B6, 'M', u'μv'),
+    (0x33B7, 'M', u'mv'),
+    (0x33B8, 'M', u'kv'),
+    (0x33B9, 'M', u'mv'),
+    (0x33BA, 'M', u'pw'),
+    (0x33BB, 'M', u'nw'),
+    (0x33BC, 'M', u'μw'),
+    (0x33BD, 'M', u'mw'),
+    (0x33BE, 'M', u'kw'),
+    (0x33BF, 'M', u'mw'),
+    (0x33C0, 'M', u'kω'),
+    (0x33C1, 'M', u'mω'),
+    (0x33C2, 'X'),
+    (0x33C3, 'M', u'bq'),
+    (0x33C4, 'M', u'cc'),
+    (0x33C5, 'M', u'cd'),
+    (0x33C6, 'M', u'c∕kg'),
+    (0x33C7, 'X'),
+    (0x33C8, 'M', u'db'),
+    (0x33C9, 'M', u'gy'),
+    (0x33CA, 'M', u'ha'),
+    (0x33CB, 'M', u'hp'),
+    (0x33CC, 'M', u'in'),
+    (0x33CD, 'M', u'kk'),
+    (0x33CE, 'M', u'km'),
+    (0x33CF, 'M', u'kt'),
+    (0x33D0, 'M', u'lm'),
+    (0x33D1, 'M', u'ln'),
+    (0x33D2, 'M', u'log'),
+    (0x33D3, 'M', u'lx'),
+    (0x33D4, 'M', u'mb'),
+    (0x33D5, 'M', u'mil'),
+    (0x33D6, 'M', u'mol'),
+    (0x33D7, 'M', u'ph'),
+    (0x33D8, 'X'),
+    (0x33D9, 'M', u'ppm'),
+    (0x33DA, 'M', u'pr'),
+    (0x33DB, 'M', u'sr'),
+    (0x33DC, 'M', u'sv'),
+    (0x33DD, 'M', u'wb'),
+    (0x33DE, 'M', u'v∕m'),
+    (0x33DF, 'M', u'a∕m'),
+    (0x33E0, 'M', u'1日'),
+    (0x33E1, 'M', u'2日'),
+    (0x33E2, 'M', u'3日'),
+    (0x33E3, 'M', u'4日'),
+    (0x33E4, 'M', u'5日'),
+    (0x33E5, 'M', u'6日'),
+    (0x33E6, 'M', u'7日'),
+    (0x33E7, 'M', u'8日'),
+    (0x33E8, 'M', u'9日'),
+    (0x33E9, 'M', u'10日'),
+    (0x33EA, 'M', u'11日'),
+    (0x33EB, 'M', u'12日'),
+    (0x33EC, 'M', u'13日'),
+    (0x33ED, 'M', u'14日'),
+    (0x33EE, 'M', u'15日'),
+    (0x33EF, 'M', u'16日'),
+    (0x33F0, 'M', u'17日'),
+    (0x33F1, 'M', u'18日'),
+    (0x33F2, 'M', u'19日'),
+    (0x33F3, 'M', u'20日'),
+    ]
+
+def _seg_35():
+    return [
+    (0x33F4, 'M', u'21日'),
+    (0x33F5, 'M', u'22日'),
+    (0x33F6, 'M', u'23日'),
+    (0x33F7, 'M', u'24日'),
+    (0x33F8, 'M', u'25日'),
+    (0x33F9, 'M', u'26日'),
+    (0x33FA, 'M', u'27日'),
+    (0x33FB, 'M', u'28日'),
+    (0x33FC, 'M', u'29日'),
+    (0x33FD, 'M', u'30日'),
+    (0x33FE, 'M', u'31日'),
+    (0x33FF, 'M', u'gal'),
+    (0x3400, 'V'),
+    (0x4DB6, 'X'),
+    (0x4DC0, 'V'),
+    (0x9FF0, 'X'),
+    (0xA000, 'V'),
+    (0xA48D, 'X'),
+    (0xA490, 'V'),
+    (0xA4C7, 'X'),
+    (0xA4D0, 'V'),
+    (0xA62C, 'X'),
+    (0xA640, 'M', u'ꙁ'),
+    (0xA641, 'V'),
+    (0xA642, 'M', u'ꙃ'),
+    (0xA643, 'V'),
+    (0xA644, 'M', u'ꙅ'),
+    (0xA645, 'V'),
+    (0xA646, 'M', u'ꙇ'),
+    (0xA647, 'V'),
+    (0xA648, 'M', u'ꙉ'),
+    (0xA649, 'V'),
+    (0xA64A, 'M', u'ꙋ'),
+    (0xA64B, 'V'),
+    (0xA64C, 'M', u'ꙍ'),
+    (0xA64D, 'V'),
+    (0xA64E, 'M', u'ꙏ'),
+    (0xA64F, 'V'),
+    (0xA650, 'M', u'ꙑ'),
+    (0xA651, 'V'),
+    (0xA652, 'M', u'ꙓ'),
+    (0xA653, 'V'),
+    (0xA654, 'M', u'ꙕ'),
+    (0xA655, 'V'),
+    (0xA656, 'M', u'ꙗ'),
+    (0xA657, 'V'),
+    (0xA658, 'M', u'ꙙ'),
+    (0xA659, 'V'),
+    (0xA65A, 'M', u'ꙛ'),
+    (0xA65B, 'V'),
+    (0xA65C, 'M', u'ꙝ'),
+    (0xA65D, 'V'),
+    (0xA65E, 'M', u'ꙟ'),
+    (0xA65F, 'V'),
+    (0xA660, 'M', u'ꙡ'),
+    (0xA661, 'V'),
+    (0xA662, 'M', u'ꙣ'),
+    (0xA663, 'V'),
+    (0xA664, 'M', u'ꙥ'),
+    (0xA665, 'V'),
+    (0xA666, 'M', u'ꙧ'),
+    (0xA667, 'V'),
+    (0xA668, 'M', u'ꙩ'),
+    (0xA669, 'V'),
+    (0xA66A, 'M', u'ꙫ'),
+    (0xA66B, 'V'),
+    (0xA66C, 'M', u'ꙭ'),
+    (0xA66D, 'V'),
+    (0xA680, 'M', u'ꚁ'),
+    (0xA681, 'V'),
+    (0xA682, 'M', u'ꚃ'),
+    (0xA683, 'V'),
+    (0xA684, 'M', u'ꚅ'),
+    (0xA685, 'V'),
+    (0xA686, 'M', u'ꚇ'),
+    (0xA687, 'V'),
+    (0xA688, 'M', u'ꚉ'),
+    (0xA689, 'V'),
+    (0xA68A, 'M', u'ꚋ'),
+    (0xA68B, 'V'),
+    (0xA68C, 'M', u'ꚍ'),
+    (0xA68D, 'V'),
+    (0xA68E, 'M', u'ꚏ'),
+    (0xA68F, 'V'),
+    (0xA690, 'M', u'ꚑ'),
+    (0xA691, 'V'),
+    (0xA692, 'M', u'ꚓ'),
+    (0xA693, 'V'),
+    (0xA694, 'M', u'ꚕ'),
+    (0xA695, 'V'),
+    (0xA696, 'M', u'ꚗ'),
+    (0xA697, 'V'),
+    (0xA698, 'M', u'ꚙ'),
+    (0xA699, 'V'),
+    (0xA69A, 'M', u'ꚛ'),
+    (0xA69B, 'V'),
+    (0xA69C, 'M', u'ъ'),
+    (0xA69D, 'M', u'ь'),
+    (0xA69E, 'V'),
+    (0xA6F8, 'X'),
+    ]
+
+def _seg_36():
+    return [
+    (0xA700, 'V'),
+    (0xA722, 'M', u'ꜣ'),
+    (0xA723, 'V'),
+    (0xA724, 'M', u'ꜥ'),
+    (0xA725, 'V'),
+    (0xA726, 'M', u'ꜧ'),
+    (0xA727, 'V'),
+    (0xA728, 'M', u'ꜩ'),
+    (0xA729, 'V'),
+    (0xA72A, 'M', u'ꜫ'),
+    (0xA72B, 'V'),
+    (0xA72C, 'M', u'ꜭ'),
+    (0xA72D, 'V'),
+    (0xA72E, 'M', u'ꜯ'),
+    (0xA72F, 'V'),
+    (0xA732, 'M', u'ꜳ'),
+    (0xA733, 'V'),
+    (0xA734, 'M', u'ꜵ'),
+    (0xA735, 'V'),
+    (0xA736, 'M', u'ꜷ'),
+    (0xA737, 'V'),
+    (0xA738, 'M', u'ꜹ'),
+    (0xA739, 'V'),
+    (0xA73A, 'M', u'ꜻ'),
+    (0xA73B, 'V'),
+    (0xA73C, 'M', u'ꜽ'),
+    (0xA73D, 'V'),
+    (0xA73E, 'M', u'ꜿ'),
+    (0xA73F, 'V'),
+    (0xA740, 'M', u'ꝁ'),
+    (0xA741, 'V'),
+    (0xA742, 'M', u'ꝃ'),
+    (0xA743, 'V'),
+    (0xA744, 'M', u'ꝅ'),
+    (0xA745, 'V'),
+    (0xA746, 'M', u'ꝇ'),
+    (0xA747, 'V'),
+    (0xA748, 'M', u'ꝉ'),
+    (0xA749, 'V'),
+    (0xA74A, 'M', u'ꝋ'),
+    (0xA74B, 'V'),
+    (0xA74C, 'M', u'ꝍ'),
+    (0xA74D, 'V'),
+    (0xA74E, 'M', u'ꝏ'),
+    (0xA74F, 'V'),
+    (0xA750, 'M', u'ꝑ'),
+    (0xA751, 'V'),
+    (0xA752, 'M', u'ꝓ'),
+    (0xA753, 'V'),
+    (0xA754, 'M', u'ꝕ'),
+    (0xA755, 'V'),
+    (0xA756, 'M', u'ꝗ'),
+    (0xA757, 'V'),
+    (0xA758, 'M', u'ꝙ'),
+    (0xA759, 'V'),
+    (0xA75A, 'M', u'ꝛ'),
+    (0xA75B, 'V'),
+    (0xA75C, 'M', u'ꝝ'),
+    (0xA75D, 'V'),
+    (0xA75E, 'M', u'ꝟ'),
+    (0xA75F, 'V'),
+    (0xA760, 'M', u'ꝡ'),
+    (0xA761, 'V'),
+    (0xA762, 'M', u'ꝣ'),
+    (0xA763, 'V'),
+    (0xA764, 'M', u'ꝥ'),
+    (0xA765, 'V'),
+    (0xA766, 'M', u'ꝧ'),
+    (0xA767, 'V'),
+    (0xA768, 'M', u'ꝩ'),
+    (0xA769, 'V'),
+    (0xA76A, 'M', u'ꝫ'),
+    (0xA76B, 'V'),
+    (0xA76C, 'M', u'ꝭ'),
+    (0xA76D, 'V'),
+    (0xA76E, 'M', u'ꝯ'),
+    (0xA76F, 'V'),
+    (0xA770, 'M', u'ꝯ'),
+    (0xA771, 'V'),
+    (0xA779, 'M', u'ꝺ'),
+    (0xA77A, 'V'),
+    (0xA77B, 'M', u'ꝼ'),
+    (0xA77C, 'V'),
+    (0xA77D, 'M', u'ᵹ'),
+    (0xA77E, 'M', u'ꝿ'),
+    (0xA77F, 'V'),
+    (0xA780, 'M', u'ꞁ'),
+    (0xA781, 'V'),
+    (0xA782, 'M', u'ꞃ'),
+    (0xA783, 'V'),
+    (0xA784, 'M', u'ꞅ'),
+    (0xA785, 'V'),
+    (0xA786, 'M', u'ꞇ'),
+    (0xA787, 'V'),
+    (0xA78B, 'M', u'ꞌ'),
+    (0xA78C, 'V'),
+    (0xA78D, 'M', u'ɥ'),
+    (0xA78E, 'V'),
+    (0xA790, 'M', u'ꞑ'),
+    (0xA791, 'V'),
+    ]
+
+def _seg_37():
+    return [
+    (0xA792, 'M', u'ꞓ'),
+    (0xA793, 'V'),
+    (0xA796, 'M', u'ꞗ'),
+    (0xA797, 'V'),
+    (0xA798, 'M', u'ꞙ'),
+    (0xA799, 'V'),
+    (0xA79A, 'M', u'ꞛ'),
+    (0xA79B, 'V'),
+    (0xA79C, 'M', u'ꞝ'),
+    (0xA79D, 'V'),
+    (0xA79E, 'M', u'ꞟ'),
+    (0xA79F, 'V'),
+    (0xA7A0, 'M', u'ꞡ'),
+    (0xA7A1, 'V'),
+    (0xA7A2, 'M', u'ꞣ'),
+    (0xA7A3, 'V'),
+    (0xA7A4, 'M', u'ꞥ'),
+    (0xA7A5, 'V'),
+    (0xA7A6, 'M', u'ꞧ'),
+    (0xA7A7, 'V'),
+    (0xA7A8, 'M', u'ꞩ'),
+    (0xA7A9, 'V'),
+    (0xA7AA, 'M', u'ɦ'),
+    (0xA7AB, 'M', u'ɜ'),
+    (0xA7AC, 'M', u'ɡ'),
+    (0xA7AD, 'M', u'ɬ'),
+    (0xA7AE, 'M', u'ɪ'),
+    (0xA7AF, 'V'),
+    (0xA7B0, 'M', u'ʞ'),
+    (0xA7B1, 'M', u'ʇ'),
+    (0xA7B2, 'M', u'ʝ'),
+    (0xA7B3, 'M', u'ꭓ'),
+    (0xA7B4, 'M', u'ꞵ'),
+    (0xA7B5, 'V'),
+    (0xA7B6, 'M', u'ꞷ'),
+    (0xA7B7, 'V'),
+    (0xA7B8, 'X'),
+    (0xA7B9, 'V'),
+    (0xA7BA, 'X'),
+    (0xA7F7, 'V'),
+    (0xA7F8, 'M', u'ħ'),
+    (0xA7F9, 'M', u'œ'),
+    (0xA7FA, 'V'),
+    (0xA82C, 'X'),
+    (0xA830, 'V'),
+    (0xA83A, 'X'),
+    (0xA840, 'V'),
+    (0xA878, 'X'),
+    (0xA880, 'V'),
+    (0xA8C6, 'X'),
+    (0xA8CE, 'V'),
+    (0xA8DA, 'X'),
+    (0xA8E0, 'V'),
+    (0xA954, 'X'),
+    (0xA95F, 'V'),
+    (0xA97D, 'X'),
+    (0xA980, 'V'),
+    (0xA9CE, 'X'),
+    (0xA9CF, 'V'),
+    (0xA9DA, 'X'),
+    (0xA9DE, 'V'),
+    (0xA9FF, 'X'),
+    (0xAA00, 'V'),
+    (0xAA37, 'X'),
+    (0xAA40, 'V'),
+    (0xAA4E, 'X'),
+    (0xAA50, 'V'),
+    (0xAA5A, 'X'),
+    (0xAA5C, 'V'),
+    (0xAAC3, 'X'),
+    (0xAADB, 'V'),
+    (0xAAF7, 'X'),
+    (0xAB01, 'V'),
+    (0xAB07, 'X'),
+    (0xAB09, 'V'),
+    (0xAB0F, 'X'),
+    (0xAB11, 'V'),
+    (0xAB17, 'X'),
+    (0xAB20, 'V'),
+    (0xAB27, 'X'),
+    (0xAB28, 'V'),
+    (0xAB2F, 'X'),
+    (0xAB30, 'V'),
+    (0xAB5C, 'M', u'ꜧ'),
+    (0xAB5D, 'M', u'ꬷ'),
+    (0xAB5E, 'M', u'ɫ'),
+    (0xAB5F, 'M', u'ꭒ'),
+    (0xAB60, 'V'),
+    (0xAB66, 'X'),
+    (0xAB70, 'M', u'Ꭰ'),
+    (0xAB71, 'M', u'Ꭱ'),
+    (0xAB72, 'M', u'Ꭲ'),
+    (0xAB73, 'M', u'Ꭳ'),
+    (0xAB74, 'M', u'Ꭴ'),
+    (0xAB75, 'M', u'Ꭵ'),
+    (0xAB76, 'M', u'Ꭶ'),
+    (0xAB77, 'M', u'Ꭷ'),
+    (0xAB78, 'M', u'Ꭸ'),
+    (0xAB79, 'M', u'Ꭹ'),
+    (0xAB7A, 'M', u'Ꭺ'),
+    ]
+
+def _seg_38():
+    return [
+    (0xAB7B, 'M', u'Ꭻ'),
+    (0xAB7C, 'M', u'Ꭼ'),
+    (0xAB7D, 'M', u'Ꭽ'),
+    (0xAB7E, 'M', u'Ꭾ'),
+    (0xAB7F, 'M', u'Ꭿ'),
+    (0xAB80, 'M', u'Ꮀ'),
+    (0xAB81, 'M', u'Ꮁ'),
+    (0xAB82, 'M', u'Ꮂ'),
+    (0xAB83, 'M', u'Ꮃ'),
+    (0xAB84, 'M', u'Ꮄ'),
+    (0xAB85, 'M', u'Ꮅ'),
+    (0xAB86, 'M', u'Ꮆ'),
+    (0xAB87, 'M', u'Ꮇ'),
+    (0xAB88, 'M', u'Ꮈ'),
+    (0xAB89, 'M', u'Ꮉ'),
+    (0xAB8A, 'M', u'Ꮊ'),
+    (0xAB8B, 'M', u'Ꮋ'),
+    (0xAB8C, 'M', u'Ꮌ'),
+    (0xAB8D, 'M', u'Ꮍ'),
+    (0xAB8E, 'M', u'Ꮎ'),
+    (0xAB8F, 'M', u'Ꮏ'),
+    (0xAB90, 'M', u'Ꮐ'),
+    (0xAB91, 'M', u'Ꮑ'),
+    (0xAB92, 'M', u'Ꮒ'),
+    (0xAB93, 'M', u'Ꮓ'),
+    (0xAB94, 'M', u'Ꮔ'),
+    (0xAB95, 'M', u'Ꮕ'),
+    (0xAB96, 'M', u'Ꮖ'),
+    (0xAB97, 'M', u'Ꮗ'),
+    (0xAB98, 'M', u'Ꮘ'),
+    (0xAB99, 'M', u'Ꮙ'),
+    (0xAB9A, 'M', u'Ꮚ'),
+    (0xAB9B, 'M', u'Ꮛ'),
+    (0xAB9C, 'M', u'Ꮜ'),
+    (0xAB9D, 'M', u'Ꮝ'),
+    (0xAB9E, 'M', u'Ꮞ'),
+    (0xAB9F, 'M', u'Ꮟ'),
+    (0xABA0, 'M', u'Ꮠ'),
+    (0xABA1, 'M', u'Ꮡ'),
+    (0xABA2, 'M', u'Ꮢ'),
+    (0xABA3, 'M', u'Ꮣ'),
+    (0xABA4, 'M', u'Ꮤ'),
+    (0xABA5, 'M', u'Ꮥ'),
+    (0xABA6, 'M', u'Ꮦ'),
+    (0xABA7, 'M', u'Ꮧ'),
+    (0xABA8, 'M', u'Ꮨ'),
+    (0xABA9, 'M', u'Ꮩ'),
+    (0xABAA, 'M', u'Ꮪ'),
+    (0xABAB, 'M', u'Ꮫ'),
+    (0xABAC, 'M', u'Ꮬ'),
+    (0xABAD, 'M', u'Ꮭ'),
+    (0xABAE, 'M', u'Ꮮ'),
+    (0xABAF, 'M', u'Ꮯ'),
+    (0xABB0, 'M', u'Ꮰ'),
+    (0xABB1, 'M', u'Ꮱ'),
+    (0xABB2, 'M', u'Ꮲ'),
+    (0xABB3, 'M', u'Ꮳ'),
+    (0xABB4, 'M', u'Ꮴ'),
+    (0xABB5, 'M', u'Ꮵ'),
+    (0xABB6, 'M', u'Ꮶ'),
+    (0xABB7, 'M', u'Ꮷ'),
+    (0xABB8, 'M', u'Ꮸ'),
+    (0xABB9, 'M', u'Ꮹ'),
+    (0xABBA, 'M', u'Ꮺ'),
+    (0xABBB, 'M', u'Ꮻ'),
+    (0xABBC, 'M', u'Ꮼ'),
+    (0xABBD, 'M', u'Ꮽ'),
+    (0xABBE, 'M', u'Ꮾ'),
+    (0xABBF, 'M', u'Ꮿ'),
+    (0xABC0, 'V'),
+    (0xABEE, 'X'),
+    (0xABF0, 'V'),
+    (0xABFA, 'X'),
+    (0xAC00, 'V'),
+    (0xD7A4, 'X'),
+    (0xD7B0, 'V'),
+    (0xD7C7, 'X'),
+    (0xD7CB, 'V'),
+    (0xD7FC, 'X'),
+    (0xF900, 'M', u'豈'),
+    (0xF901, 'M', u'更'),
+    (0xF902, 'M', u'車'),
+    (0xF903, 'M', u'賈'),
+    (0xF904, 'M', u'滑'),
+    (0xF905, 'M', u'串'),
+    (0xF906, 'M', u'句'),
+    (0xF907, 'M', u'龜'),
+    (0xF909, 'M', u'契'),
+    (0xF90A, 'M', u'金'),
+    (0xF90B, 'M', u'喇'),
+    (0xF90C, 'M', u'奈'),
+    (0xF90D, 'M', u'懶'),
+    (0xF90E, 'M', u'癩'),
+    (0xF90F, 'M', u'羅'),
+    (0xF910, 'M', u'蘿'),
+    (0xF911, 'M', u'螺'),
+    (0xF912, 'M', u'裸'),
+    (0xF913, 'M', u'邏'),
+    (0xF914, 'M', u'樂'),
+    (0xF915, 'M', u'洛'),
+    ]
+
+def _seg_39():
+    return [
+    (0xF916, 'M', u'烙'),
+    (0xF917, 'M', u'珞'),
+    (0xF918, 'M', u'落'),
+    (0xF919, 'M', u'酪'),
+    (0xF91A, 'M', u'駱'),
+    (0xF91B, 'M', u'亂'),
+    (0xF91C, 'M', u'卵'),
+    (0xF91D, 'M', u'欄'),
+    (0xF91E, 'M', u'爛'),
+    (0xF91F, 'M', u'蘭'),
+    (0xF920, 'M', u'鸞'),
+    (0xF921, 'M', u'嵐'),
+    (0xF922, 'M', u'濫'),
+    (0xF923, 'M', u'藍'),
+    (0xF924, 'M', u'襤'),
+    (0xF925, 'M', u'拉'),
+    (0xF926, 'M', u'臘'),
+    (0xF927, 'M', u'蠟'),
+    (0xF928, 'M', u'廊'),
+    (0xF929, 'M', u'朗'),
+    (0xF92A, 'M', u'浪'),
+    (0xF92B, 'M', u'狼'),
+    (0xF92C, 'M', u'郎'),
+    (0xF92D, 'M', u'來'),
+    (0xF92E, 'M', u'冷'),
+    (0xF92F, 'M', u'勞'),
+    (0xF930, 'M', u'擄'),
+    (0xF931, 'M', u'櫓'),
+    (0xF932, 'M', u'爐'),
+    (0xF933, 'M', u'盧'),
+    (0xF934, 'M', u'老'),
+    (0xF935, 'M', u'蘆'),
+    (0xF936, 'M', u'虜'),
+    (0xF937, 'M', u'路'),
+    (0xF938, 'M', u'露'),
+    (0xF939, 'M', u'魯'),
+    (0xF93A, 'M', u'鷺'),
+    (0xF93B, 'M', u'碌'),
+    (0xF93C, 'M', u'祿'),
+    (0xF93D, 'M', u'綠'),
+    (0xF93E, 'M', u'菉'),
+    (0xF93F, 'M', u'錄'),
+    (0xF940, 'M', u'鹿'),
+    (0xF941, 'M', u'論'),
+    (0xF942, 'M', u'壟'),
+    (0xF943, 'M', u'弄'),
+    (0xF944, 'M', u'籠'),
+    (0xF945, 'M', u'聾'),
+    (0xF946, 'M', u'牢'),
+    (0xF947, 'M', u'磊'),
+    (0xF948, 'M', u'賂'),
+    (0xF949, 'M', u'雷'),
+    (0xF94A, 'M', u'壘'),
+    (0xF94B, 'M', u'屢'),
+    (0xF94C, 'M', u'樓'),
+    (0xF94D, 'M', u'淚'),
+    (0xF94E, 'M', u'漏'),
+    (0xF94F, 'M', u'累'),
+    (0xF950, 'M', u'縷'),
+    (0xF951, 'M', u'陋'),
+    (0xF952, 'M', u'勒'),
+    (0xF953, 'M', u'肋'),
+    (0xF954, 'M', u'凜'),
+    (0xF955, 'M', u'凌'),
+    (0xF956, 'M', u'稜'),
+    (0xF957, 'M', u'綾'),
+    (0xF958, 'M', u'菱'),
+    (0xF959, 'M', u'陵'),
+    (0xF95A, 'M', u'讀'),
+    (0xF95B, 'M', u'拏'),
+    (0xF95C, 'M', u'樂'),
+    (0xF95D, 'M', u'諾'),
+    (0xF95E, 'M', u'丹'),
+    (0xF95F, 'M', u'寧'),
+    (0xF960, 'M', u'怒'),
+    (0xF961, 'M', u'率'),
+    (0xF962, 'M', u'異'),
+    (0xF963, 'M', u'北'),
+    (0xF964, 'M', u'磻'),
+    (0xF965, 'M', u'便'),
+    (0xF966, 'M', u'復'),
+    (0xF967, 'M', u'不'),
+    (0xF968, 'M', u'泌'),
+    (0xF969, 'M', u'數'),
+    (0xF96A, 'M', u'索'),
+    (0xF96B, 'M', u'參'),
+    (0xF96C, 'M', u'塞'),
+    (0xF96D, 'M', u'省'),
+    (0xF96E, 'M', u'葉'),
+    (0xF96F, 'M', u'說'),
+    (0xF970, 'M', u'殺'),
+    (0xF971, 'M', u'辰'),
+    (0xF972, 'M', u'沈'),
+    (0xF973, 'M', u'拾'),
+    (0xF974, 'M', u'若'),
+    (0xF975, 'M', u'掠'),
+    (0xF976, 'M', u'略'),
+    (0xF977, 'M', u'亮'),
+    (0xF978, 'M', u'兩'),
+    (0xF979, 'M', u'凉'),
+    ]
+
+def _seg_40():
+    return [
+    (0xF97A, 'M', u'梁'),
+    (0xF97B, 'M', u'糧'),
+    (0xF97C, 'M', u'良'),
+    (0xF97D, 'M', u'諒'),
+    (0xF97E, 'M', u'量'),
+    (0xF97F, 'M', u'勵'),
+    (0xF980, 'M', u'呂'),
+    (0xF981, 'M', u'女'),
+    (0xF982, 'M', u'廬'),
+    (0xF983, 'M', u'旅'),
+    (0xF984, 'M', u'濾'),
+    (0xF985, 'M', u'礪'),
+    (0xF986, 'M', u'閭'),
+    (0xF987, 'M', u'驪'),
+    (0xF988, 'M', u'麗'),
+    (0xF989, 'M', u'黎'),
+    (0xF98A, 'M', u'力'),
+    (0xF98B, 'M', u'曆'),
+    (0xF98C, 'M', u'歷'),
+    (0xF98D, 'M', u'轢'),
+    (0xF98E, 'M', u'年'),
+    (0xF98F, 'M', u'憐'),
+    (0xF990, 'M', u'戀'),
+    (0xF991, 'M', u'撚'),
+    (0xF992, 'M', u'漣'),
+    (0xF993, 'M', u'煉'),
+    (0xF994, 'M', u'璉'),
+    (0xF995, 'M', u'秊'),
+    (0xF996, 'M', u'練'),
+    (0xF997, 'M', u'聯'),
+    (0xF998, 'M', u'輦'),
+    (0xF999, 'M', u'蓮'),
+    (0xF99A, 'M', u'連'),
+    (0xF99B, 'M', u'鍊'),
+    (0xF99C, 'M', u'列'),
+    (0xF99D, 'M', u'劣'),
+    (0xF99E, 'M', u'咽'),
+    (0xF99F, 'M', u'烈'),
+    (0xF9A0, 'M', u'裂'),
+    (0xF9A1, 'M', u'說'),
+    (0xF9A2, 'M', u'廉'),
+    (0xF9A3, 'M', u'念'),
+    (0xF9A4, 'M', u'捻'),
+    (0xF9A5, 'M', u'殮'),
+    (0xF9A6, 'M', u'簾'),
+    (0xF9A7, 'M', u'獵'),
+    (0xF9A8, 'M', u'令'),
+    (0xF9A9, 'M', u'囹'),
+    (0xF9AA, 'M', u'寧'),
+    (0xF9AB, 'M', u'嶺'),
+    (0xF9AC, 'M', u'怜'),
+    (0xF9AD, 'M', u'玲'),
+    (0xF9AE, 'M', u'瑩'),
+    (0xF9AF, 'M', u'羚'),
+    (0xF9B0, 'M', u'聆'),
+    (0xF9B1, 'M', u'鈴'),
+    (0xF9B2, 'M', u'零'),
+    (0xF9B3, 'M', u'靈'),
+    (0xF9B4, 'M', u'領'),
+    (0xF9B5, 'M', u'例'),
+    (0xF9B6, 'M', u'禮'),
+    (0xF9B7, 'M', u'醴'),
+    (0xF9B8, 'M', u'隸'),
+    (0xF9B9, 'M', u'惡'),
+    (0xF9BA, 'M', u'了'),
+    (0xF9BB, 'M', u'僚'),
+    (0xF9BC, 'M', u'寮'),
+    (0xF9BD, 'M', u'尿'),
+    (0xF9BE, 'M', u'料'),
+    (0xF9BF, 'M', u'樂'),
+    (0xF9C0, 'M', u'燎'),
+    (0xF9C1, 'M', u'療'),
+    (0xF9C2, 'M', u'蓼'),
+    (0xF9C3, 'M', u'遼'),
+    (0xF9C4, 'M', u'龍'),
+    (0xF9C5, 'M', u'暈'),
+    (0xF9C6, 'M', u'阮'),
+    (0xF9C7, 'M', u'劉'),
+    (0xF9C8, 'M', u'杻'),
+    (0xF9C9, 'M', u'柳'),
+    (0xF9CA, 'M', u'流'),
+    (0xF9CB, 'M', u'溜'),
+    (0xF9CC, 'M', u'琉'),
+    (0xF9CD, 'M', u'留'),
+    (0xF9CE, 'M', u'硫'),
+    (0xF9CF, 'M', u'紐'),
+    (0xF9D0, 'M', u'類'),
+    (0xF9D1, 'M', u'六'),
+    (0xF9D2, 'M', u'戮'),
+    (0xF9D3, 'M', u'陸'),
+    (0xF9D4, 'M', u'倫'),
+    (0xF9D5, 'M', u'崙'),
+    (0xF9D6, 'M', u'淪'),
+    (0xF9D7, 'M', u'輪'),
+    (0xF9D8, 'M', u'律'),
+    (0xF9D9, 'M', u'慄'),
+    (0xF9DA, 'M', u'栗'),
+    (0xF9DB, 'M', u'率'),
+    (0xF9DC, 'M', u'隆'),
+    (0xF9DD, 'M', u'利'),
+    ]
+
+def _seg_41():
+    return [
+    (0xF9DE, 'M', u'吏'),
+    (0xF9DF, 'M', u'履'),
+    (0xF9E0, 'M', u'易'),
+    (0xF9E1, 'M', u'李'),
+    (0xF9E2, 'M', u'梨'),
+    (0xF9E3, 'M', u'泥'),
+    (0xF9E4, 'M', u'理'),
+    (0xF9E5, 'M', u'痢'),
+    (0xF9E6, 'M', u'罹'),
+    (0xF9E7, 'M', u'裏'),
+    (0xF9E8, 'M', u'裡'),
+    (0xF9E9, 'M', u'里'),
+    (0xF9EA, 'M', u'離'),
+    (0xF9EB, 'M', u'匿'),
+    (0xF9EC, 'M', u'溺'),
+    (0xF9ED, 'M', u'吝'),
+    (0xF9EE, 'M', u'燐'),
+    (0xF9EF, 'M', u'璘'),
+    (0xF9F0, 'M', u'藺'),
+    (0xF9F1, 'M', u'隣'),
+    (0xF9F2, 'M', u'鱗'),
+    (0xF9F3, 'M', u'麟'),
+    (0xF9F4, 'M', u'林'),
+    (0xF9F5, 'M', u'淋'),
+    (0xF9F6, 'M', u'臨'),
+    (0xF9F7, 'M', u'立'),
+    (0xF9F8, 'M', u'笠'),
+    (0xF9F9, 'M', u'粒'),
+    (0xF9FA, 'M', u'狀'),
+    (0xF9FB, 'M', u'炙'),
+    (0xF9FC, 'M', u'識'),
+    (0xF9FD, 'M', u'什'),
+    (0xF9FE, 'M', u'茶'),
+    (0xF9FF, 'M', u'刺'),
+    (0xFA00, 'M', u'切'),
+    (0xFA01, 'M', u'度'),
+    (0xFA02, 'M', u'拓'),
+    (0xFA03, 'M', u'糖'),
+    (0xFA04, 'M', u'宅'),
+    (0xFA05, 'M', u'洞'),
+    (0xFA06, 'M', u'暴'),
+    (0xFA07, 'M', u'輻'),
+    (0xFA08, 'M', u'行'),
+    (0xFA09, 'M', u'降'),
+    (0xFA0A, 'M', u'見'),
+    (0xFA0B, 'M', u'廓'),
+    (0xFA0C, 'M', u'兀'),
+    (0xFA0D, 'M', u'嗀'),
+    (0xFA0E, 'V'),
+    (0xFA10, 'M', u'塚'),
+    (0xFA11, 'V'),
+    (0xFA12, 'M', u'晴'),
+    (0xFA13, 'V'),
+    (0xFA15, 'M', u'凞'),
+    (0xFA16, 'M', u'猪'),
+    (0xFA17, 'M', u'益'),
+    (0xFA18, 'M', u'礼'),
+    (0xFA19, 'M', u'神'),
+    (0xFA1A, 'M', u'祥'),
+    (0xFA1B, 'M', u'福'),
+    (0xFA1C, 'M', u'靖'),
+    (0xFA1D, 'M', u'精'),
+    (0xFA1E, 'M', u'羽'),
+    (0xFA1F, 'V'),
+    (0xFA20, 'M', u'蘒'),
+    (0xFA21, 'V'),
+    (0xFA22, 'M', u'諸'),
+    (0xFA23, 'V'),
+    (0xFA25, 'M', u'逸'),
+    (0xFA26, 'M', u'都'),
+    (0xFA27, 'V'),
+    (0xFA2A, 'M', u'飯'),
+    (0xFA2B, 'M', u'飼'),
+    (0xFA2C, 'M', u'館'),
+    (0xFA2D, 'M', u'鶴'),
+    (0xFA2E, 'M', u'郞'),
+    (0xFA2F, 'M', u'隷'),
+    (0xFA30, 'M', u'侮'),
+    (0xFA31, 'M', u'僧'),
+    (0xFA32, 'M', u'免'),
+    (0xFA33, 'M', u'勉'),
+    (0xFA34, 'M', u'勤'),
+    (0xFA35, 'M', u'卑'),
+    (0xFA36, 'M', u'喝'),
+    (0xFA37, 'M', u'嘆'),
+    (0xFA38, 'M', u'器'),
+    (0xFA39, 'M', u'塀'),
+    (0xFA3A, 'M', u'墨'),
+    (0xFA3B, 'M', u'層'),
+    (0xFA3C, 'M', u'屮'),
+    (0xFA3D, 'M', u'悔'),
+    (0xFA3E, 'M', u'慨'),
+    (0xFA3F, 'M', u'憎'),
+    (0xFA40, 'M', u'懲'),
+    (0xFA41, 'M', u'敏'),
+    (0xFA42, 'M', u'既'),
+    (0xFA43, 'M', u'暑'),
+    (0xFA44, 'M', u'梅'),
+    (0xFA45, 'M', u'海'),
+    (0xFA46, 'M', u'渚'),
+    ]
+
+def _seg_42():
+    return [
+    (0xFA47, 'M', u'漢'),
+    (0xFA48, 'M', u'煮'),
+    (0xFA49, 'M', u'爫'),
+    (0xFA4A, 'M', u'琢'),
+    (0xFA4B, 'M', u'碑'),
+    (0xFA4C, 'M', u'社'),
+    (0xFA4D, 'M', u'祉'),
+    (0xFA4E, 'M', u'祈'),
+    (0xFA4F, 'M', u'祐'),
+    (0xFA50, 'M', u'祖'),
+    (0xFA51, 'M', u'祝'),
+    (0xFA52, 'M', u'禍'),
+    (0xFA53, 'M', u'禎'),
+    (0xFA54, 'M', u'穀'),
+    (0xFA55, 'M', u'突'),
+    (0xFA56, 'M', u'節'),
+    (0xFA57, 'M', u'練'),
+    (0xFA58, 'M', u'縉'),
+    (0xFA59, 'M', u'繁'),
+    (0xFA5A, 'M', u'署'),
+    (0xFA5B, 'M', u'者'),
+    (0xFA5C, 'M', u'臭'),
+    (0xFA5D, 'M', u'艹'),
+    (0xFA5F, 'M', u'著'),
+    (0xFA60, 'M', u'褐'),
+    (0xFA61, 'M', u'視'),
+    (0xFA62, 'M', u'謁'),
+    (0xFA63, 'M', u'謹'),
+    (0xFA64, 'M', u'賓'),
+    (0xFA65, 'M', u'贈'),
+    (0xFA66, 'M', u'辶'),
+    (0xFA67, 'M', u'逸'),
+    (0xFA68, 'M', u'難'),
+    (0xFA69, 'M', u'響'),
+    (0xFA6A, 'M', u'頻'),
+    (0xFA6B, 'M', u'恵'),
+    (0xFA6C, 'M', u'𤋮'),
+    (0xFA6D, 'M', u'舘'),
+    (0xFA6E, 'X'),
+    (0xFA70, 'M', u'並'),
+    (0xFA71, 'M', u'况'),
+    (0xFA72, 'M', u'全'),
+    (0xFA73, 'M', u'侀'),
+    (0xFA74, 'M', u'充'),
+    (0xFA75, 'M', u'冀'),
+    (0xFA76, 'M', u'勇'),
+    (0xFA77, 'M', u'勺'),
+    (0xFA78, 'M', u'喝'),
+    (0xFA79, 'M', u'啕'),
+    (0xFA7A, 'M', u'喙'),
+    (0xFA7B, 'M', u'嗢'),
+    (0xFA7C, 'M', u'塚'),
+    (0xFA7D, 'M', u'墳'),
+    (0xFA7E, 'M', u'奄'),
+    (0xFA7F, 'M', u'奔'),
+    (0xFA80, 'M', u'婢'),
+    (0xFA81, 'M', u'嬨'),
+    (0xFA82, 'M', u'廒'),
+    (0xFA83, 'M', u'廙'),
+    (0xFA84, 'M', u'彩'),
+    (0xFA85, 'M', u'徭'),
+    (0xFA86, 'M', u'惘'),
+    (0xFA87, 'M', u'慎'),
+    (0xFA88, 'M', u'愈'),
+    (0xFA89, 'M', u'憎'),
+    (0xFA8A, 'M', u'慠'),
+    (0xFA8B, 'M', u'懲'),
+    (0xFA8C, 'M', u'戴'),
+    (0xFA8D, 'M', u'揄'),
+    (0xFA8E, 'M', u'搜'),
+    (0xFA8F, 'M', u'摒'),
+    (0xFA90, 'M', u'敖'),
+    (0xFA91, 'M', u'晴'),
+    (0xFA92, 'M', u'朗'),
+    (0xFA93, 'M', u'望'),
+    (0xFA94, 'M', u'杖'),
+    (0xFA95, 'M', u'歹'),
+    (0xFA96, 'M', u'殺'),
+    (0xFA97, 'M', u'流'),
+    (0xFA98, 'M', u'滛'),
+    (0xFA99, 'M', u'滋'),
+    (0xFA9A, 'M', u'漢'),
+    (0xFA9B, 'M', u'瀞'),
+    (0xFA9C, 'M', u'煮'),
+    (0xFA9D, 'M', u'瞧'),
+    (0xFA9E, 'M', u'爵'),
+    (0xFA9F, 'M', u'犯'),
+    (0xFAA0, 'M', u'猪'),
+    (0xFAA1, 'M', u'瑱'),
+    (0xFAA2, 'M', u'甆'),
+    (0xFAA3, 'M', u'画'),
+    (0xFAA4, 'M', u'瘝'),
+    (0xFAA5, 'M', u'瘟'),
+    (0xFAA6, 'M', u'益'),
+    (0xFAA7, 'M', u'盛'),
+    (0xFAA8, 'M', u'直'),
+    (0xFAA9, 'M', u'睊'),
+    (0xFAAA, 'M', u'着'),
+    (0xFAAB, 'M', u'磌'),
+    (0xFAAC, 'M', u'窱'),
+    ]
+
+def _seg_43():
+    return [
+    (0xFAAD, 'M', u'節'),
+    (0xFAAE, 'M', u'类'),
+    (0xFAAF, 'M', u'絛'),
+    (0xFAB0, 'M', u'練'),
+    (0xFAB1, 'M', u'缾'),
+    (0xFAB2, 'M', u'者'),
+    (0xFAB3, 'M', u'荒'),
+    (0xFAB4, 'M', u'華'),
+    (0xFAB5, 'M', u'蝹'),
+    (0xFAB6, 'M', u'襁'),
+    (0xFAB7, 'M', u'覆'),
+    (0xFAB8, 'M', u'視'),
+    (0xFAB9, 'M', u'調'),
+    (0xFABA, 'M', u'諸'),
+    (0xFABB, 'M', u'請'),
+    (0xFABC, 'M', u'謁'),
+    (0xFABD, 'M', u'諾'),
+    (0xFABE, 'M', u'諭'),
+    (0xFABF, 'M', u'謹'),
+    (0xFAC0, 'M', u'變'),
+    (0xFAC1, 'M', u'贈'),
+    (0xFAC2, 'M', u'輸'),
+    (0xFAC3, 'M', u'遲'),
+    (0xFAC4, 'M', u'醙'),
+    (0xFAC5, 'M', u'鉶'),
+    (0xFAC6, 'M', u'陼'),
+    (0xFAC7, 'M', u'難'),
+    (0xFAC8, 'M', u'靖'),
+    (0xFAC9, 'M', u'韛'),
+    (0xFACA, 'M', u'響'),
+    (0xFACB, 'M', u'頋'),
+    (0xFACC, 'M', u'頻'),
+    (0xFACD, 'M', u'鬒'),
+    (0xFACE, 'M', u'龜'),
+    (0xFACF, 'M', u'𢡊'),
+    (0xFAD0, 'M', u'𢡄'),
+    (0xFAD1, 'M', u'𣏕'),
+    (0xFAD2, 'M', u'㮝'),
+    (0xFAD3, 'M', u'䀘'),
+    (0xFAD4, 'M', u'䀹'),
+    (0xFAD5, 'M', u'𥉉'),
+    (0xFAD6, 'M', u'𥳐'),
+    (0xFAD7, 'M', u'𧻓'),
+    (0xFAD8, 'M', u'齃'),
+    (0xFAD9, 'M', u'龎'),
+    (0xFADA, 'X'),
+    (0xFB00, 'M', u'ff'),
+    (0xFB01, 'M', u'fi'),
+    (0xFB02, 'M', u'fl'),
+    (0xFB03, 'M', u'ffi'),
+    (0xFB04, 'M', u'ffl'),
+    (0xFB05, 'M', u'st'),
+    (0xFB07, 'X'),
+    (0xFB13, 'M', u'մն'),
+    (0xFB14, 'M', u'մե'),
+    (0xFB15, 'M', u'մի'),
+    (0xFB16, 'M', u'վն'),
+    (0xFB17, 'M', u'մխ'),
+    (0xFB18, 'X'),
+    (0xFB1D, 'M', u'יִ'),
+    (0xFB1E, 'V'),
+    (0xFB1F, 'M', u'ײַ'),
+    (0xFB20, 'M', u'ע'),
+    (0xFB21, 'M', u'א'),
+    (0xFB22, 'M', u'ד'),
+    (0xFB23, 'M', u'ה'),
+    (0xFB24, 'M', u'כ'),
+    (0xFB25, 'M', u'ל'),
+    (0xFB26, 'M', u'ם'),
+    (0xFB27, 'M', u'ר'),
+    (0xFB28, 'M', u'ת'),
+    (0xFB29, '3', u'+'),
+    (0xFB2A, 'M', u'שׁ'),
+    (0xFB2B, 'M', u'שׂ'),
+    (0xFB2C, 'M', u'שּׁ'),
+    (0xFB2D, 'M', u'שּׂ'),
+    (0xFB2E, 'M', u'אַ'),
+    (0xFB2F, 'M', u'אָ'),
+    (0xFB30, 'M', u'אּ'),
+    (0xFB31, 'M', u'בּ'),
+    (0xFB32, 'M', u'גּ'),
+    (0xFB33, 'M', u'דּ'),
+    (0xFB34, 'M', u'הּ'),
+    (0xFB35, 'M', u'וּ'),
+    (0xFB36, 'M', u'זּ'),
+    (0xFB37, 'X'),
+    (0xFB38, 'M', u'טּ'),
+    (0xFB39, 'M', u'יּ'),
+    (0xFB3A, 'M', u'ךּ'),
+    (0xFB3B, 'M', u'כּ'),
+    (0xFB3C, 'M', u'לּ'),
+    (0xFB3D, 'X'),
+    (0xFB3E, 'M', u'מּ'),
+    (0xFB3F, 'X'),
+    (0xFB40, 'M', u'נּ'),
+    (0xFB41, 'M', u'סּ'),
+    (0xFB42, 'X'),
+    (0xFB43, 'M', u'ףּ'),
+    (0xFB44, 'M', u'פּ'),
+    (0xFB45, 'X'),
+    ]
+
+def _seg_44():
+    return [
+    (0xFB46, 'M', u'צּ'),
+    (0xFB47, 'M', u'קּ'),
+    (0xFB48, 'M', u'רּ'),
+    (0xFB49, 'M', u'שּ'),
+    (0xFB4A, 'M', u'תּ'),
+    (0xFB4B, 'M', u'וֹ'),
+    (0xFB4C, 'M', u'בֿ'),
+    (0xFB4D, 'M', u'כֿ'),
+    (0xFB4E, 'M', u'פֿ'),
+    (0xFB4F, 'M', u'אל'),
+    (0xFB50, 'M', u'ٱ'),
+    (0xFB52, 'M', u'ٻ'),
+    (0xFB56, 'M', u'پ'),
+    (0xFB5A, 'M', u'ڀ'),
+    (0xFB5E, 'M', u'ٺ'),
+    (0xFB62, 'M', u'ٿ'),
+    (0xFB66, 'M', u'ٹ'),
+    (0xFB6A, 'M', u'ڤ'),
+    (0xFB6E, 'M', u'ڦ'),
+    (0xFB72, 'M', u'ڄ'),
+    (0xFB76, 'M', u'ڃ'),
+    (0xFB7A, 'M', u'چ'),
+    (0xFB7E, 'M', u'ڇ'),
+    (0xFB82, 'M', u'ڍ'),
+    (0xFB84, 'M', u'ڌ'),
+    (0xFB86, 'M', u'ڎ'),
+    (0xFB88, 'M', u'ڈ'),
+    (0xFB8A, 'M', u'ژ'),
+    (0xFB8C, 'M', u'ڑ'),
+    (0xFB8E, 'M', u'ک'),
+    (0xFB92, 'M', u'گ'),
+    (0xFB96, 'M', u'ڳ'),
+    (0xFB9A, 'M', u'ڱ'),
+    (0xFB9E, 'M', u'ں'),
+    (0xFBA0, 'M', u'ڻ'),
+    (0xFBA4, 'M', u'ۀ'),
+    (0xFBA6, 'M', u'ہ'),
+    (0xFBAA, 'M', u'ھ'),
+    (0xFBAE, 'M', u'ے'),
+    (0xFBB0, 'M', u'ۓ'),
+    (0xFBB2, 'V'),
+    (0xFBC2, 'X'),
+    (0xFBD3, 'M', u'ڭ'),
+    (0xFBD7, 'M', u'ۇ'),
+    (0xFBD9, 'M', u'ۆ'),
+    (0xFBDB, 'M', u'ۈ'),
+    (0xFBDD, 'M', u'ۇٴ'),
+    (0xFBDE, 'M', u'ۋ'),
+    (0xFBE0, 'M', u'ۅ'),
+    (0xFBE2, 'M', u'ۉ'),
+    (0xFBE4, 'M', u'ې'),
+    (0xFBE8, 'M', u'ى'),
+    (0xFBEA, 'M', u'ئا'),
+    (0xFBEC, 'M', u'ئە'),
+    (0xFBEE, 'M', u'ئو'),
+    (0xFBF0, 'M', u'ئۇ'),
+    (0xFBF2, 'M', u'ئۆ'),
+    (0xFBF4, 'M', u'ئۈ'),
+    (0xFBF6, 'M', u'ئې'),
+    (0xFBF9, 'M', u'ئى'),
+    (0xFBFC, 'M', u'ی'),
+    (0xFC00, 'M', u'ئج'),
+    (0xFC01, 'M', u'ئح'),
+    (0xFC02, 'M', u'ئم'),
+    (0xFC03, 'M', u'ئى'),
+    (0xFC04, 'M', u'ئي'),
+    (0xFC05, 'M', u'بج'),
+    (0xFC06, 'M', u'بح'),
+    (0xFC07, 'M', u'بخ'),
+    (0xFC08, 'M', u'بم'),
+    (0xFC09, 'M', u'بى'),
+    (0xFC0A, 'M', u'بي'),
+    (0xFC0B, 'M', u'تج'),
+    (0xFC0C, 'M', u'تح'),
+    (0xFC0D, 'M', u'تخ'),
+    (0xFC0E, 'M', u'تم'),
+    (0xFC0F, 'M', u'تى'),
+    (0xFC10, 'M', u'تي'),
+    (0xFC11, 'M', u'ثج'),
+    (0xFC12, 'M', u'ثم'),
+    (0xFC13, 'M', u'ثى'),
+    (0xFC14, 'M', u'ثي'),
+    (0xFC15, 'M', u'جح'),
+    (0xFC16, 'M', u'جم'),
+    (0xFC17, 'M', u'حج'),
+    (0xFC18, 'M', u'حم'),
+    (0xFC19, 'M', u'خج'),
+    (0xFC1A, 'M', u'خح'),
+    (0xFC1B, 'M', u'خم'),
+    (0xFC1C, 'M', u'سج'),
+    (0xFC1D, 'M', u'سح'),
+    (0xFC1E, 'M', u'سخ'),
+    (0xFC1F, 'M', u'سم'),
+    (0xFC20, 'M', u'صح'),
+    (0xFC21, 'M', u'صم'),
+    (0xFC22, 'M', u'ضج'),
+    (0xFC23, 'M', u'ضح'),
+    (0xFC24, 'M', u'ضخ'),
+    (0xFC25, 'M', u'ضم'),
+    (0xFC26, 'M', u'طح'),
+    ]
+
+def _seg_45():
+    return [
+    (0xFC27, 'M', u'طم'),
+    (0xFC28, 'M', u'ظم'),
+    (0xFC29, 'M', u'عج'),
+    (0xFC2A, 'M', u'عم'),
+    (0xFC2B, 'M', u'غج'),
+    (0xFC2C, 'M', u'غم'),
+    (0xFC2D, 'M', u'فج'),
+    (0xFC2E, 'M', u'فح'),
+    (0xFC2F, 'M', u'فخ'),
+    (0xFC30, 'M', u'فم'),
+    (0xFC31, 'M', u'فى'),
+    (0xFC32, 'M', u'في'),
+    (0xFC33, 'M', u'قح'),
+    (0xFC34, 'M', u'قم'),
+    (0xFC35, 'M', u'قى'),
+    (0xFC36, 'M', u'قي'),
+    (0xFC37, 'M', u'كا'),
+    (0xFC38, 'M', u'كج'),
+    (0xFC39, 'M', u'كح'),
+    (0xFC3A, 'M', u'كخ'),
+    (0xFC3B, 'M', u'كل'),
+    (0xFC3C, 'M', u'كم'),
+    (0xFC3D, 'M', u'كى'),
+    (0xFC3E, 'M', u'كي'),
+    (0xFC3F, 'M', u'لج'),
+    (0xFC40, 'M', u'لح'),
+    (0xFC41, 'M', u'لخ'),
+    (0xFC42, 'M', u'لم'),
+    (0xFC43, 'M', u'لى'),
+    (0xFC44, 'M', u'لي'),
+    (0xFC45, 'M', u'مج'),
+    (0xFC46, 'M', u'مح'),
+    (0xFC47, 'M', u'مخ'),
+    (0xFC48, 'M', u'مم'),
+    (0xFC49, 'M', u'مى'),
+    (0xFC4A, 'M', u'مي'),
+    (0xFC4B, 'M', u'نج'),
+    (0xFC4C, 'M', u'نح'),
+    (0xFC4D, 'M', u'نخ'),
+    (0xFC4E, 'M', u'نم'),
+    (0xFC4F, 'M', u'نى'),
+    (0xFC50, 'M', u'ني'),
+    (0xFC51, 'M', u'هج'),
+    (0xFC52, 'M', u'هم'),
+    (0xFC53, 'M', u'هى'),
+    (0xFC54, 'M', u'هي'),
+    (0xFC55, 'M', u'يج'),
+    (0xFC56, 'M', u'يح'),
+    (0xFC57, 'M', u'يخ'),
+    (0xFC58, 'M', u'يم'),
+    (0xFC59, 'M', u'يى'),
+    (0xFC5A, 'M', u'يي'),
+    (0xFC5B, 'M', u'ذٰ'),
+    (0xFC5C, 'M', u'رٰ'),
+    (0xFC5D, 'M', u'ىٰ'),
+    (0xFC5E, '3', u' ٌّ'),
+    (0xFC5F, '3', u' ٍّ'),
+    (0xFC60, '3', u' َّ'),
+    (0xFC61, '3', u' ُّ'),
+    (0xFC62, '3', u' ِّ'),
+    (0xFC63, '3', u' ّٰ'),
+    (0xFC64, 'M', u'ئر'),
+    (0xFC65, 'M', u'ئز'),
+    (0xFC66, 'M', u'ئم'),
+    (0xFC67, 'M', u'ئن'),
+    (0xFC68, 'M', u'ئى'),
+    (0xFC69, 'M', u'ئي'),
+    (0xFC6A, 'M', u'بر'),
+    (0xFC6B, 'M', u'بز'),
+    (0xFC6C, 'M', u'بم'),
+    (0xFC6D, 'M', u'بن'),
+    (0xFC6E, 'M', u'بى'),
+    (0xFC6F, 'M', u'بي'),
+    (0xFC70, 'M', u'تر'),
+    (0xFC71, 'M', u'تز'),
+    (0xFC72, 'M', u'تم'),
+    (0xFC73, 'M', u'تن'),
+    (0xFC74, 'M', u'تى'),
+    (0xFC75, 'M', u'تي'),
+    (0xFC76, 'M', u'ثر'),
+    (0xFC77, 'M', u'ثز'),
+    (0xFC78, 'M', u'ثم'),
+    (0xFC79, 'M', u'ثن'),
+    (0xFC7A, 'M', u'ثى'),
+    (0xFC7B, 'M', u'ثي'),
+    (0xFC7C, 'M', u'فى'),
+    (0xFC7D, 'M', u'في'),
+    (0xFC7E, 'M', u'قى'),
+    (0xFC7F, 'M', u'قي'),
+    (0xFC80, 'M', u'كا'),
+    (0xFC81, 'M', u'كل'),
+    (0xFC82, 'M', u'كم'),
+    (0xFC83, 'M', u'كى'),
+    (0xFC84, 'M', u'كي'),
+    (0xFC85, 'M', u'لم'),
+    (0xFC86, 'M', u'لى'),
+    (0xFC87, 'M', u'لي'),
+    (0xFC88, 'M', u'ما'),
+    (0xFC89, 'M', u'مم'),
+    (0xFC8A, 'M', u'نر'),
+    ]
+
+def _seg_46():
+    return [
+    (0xFC8B, 'M', u'نز'),
+    (0xFC8C, 'M', u'نم'),
+    (0xFC8D, 'M', u'نن'),
+    (0xFC8E, 'M', u'نى'),
+    (0xFC8F, 'M', u'ني'),
+    (0xFC90, 'M', u'ىٰ'),
+    (0xFC91, 'M', u'ير'),
+    (0xFC92, 'M', u'يز'),
+    (0xFC93, 'M', u'يم'),
+    (0xFC94, 'M', u'ين'),
+    (0xFC95, 'M', u'يى'),
+    (0xFC96, 'M', u'يي'),
+    (0xFC97, 'M', u'ئج'),
+    (0xFC98, 'M', u'ئح'),
+    (0xFC99, 'M', u'ئخ'),
+    (0xFC9A, 'M', u'ئم'),
+    (0xFC9B, 'M', u'ئه'),
+    (0xFC9C, 'M', u'بج'),
+    (0xFC9D, 'M', u'بح'),
+    (0xFC9E, 'M', u'بخ'),
+    (0xFC9F, 'M', u'بم'),
+    (0xFCA0, 'M', u'به'),
+    (0xFCA1, 'M', u'تج'),
+    (0xFCA2, 'M', u'تح'),
+    (0xFCA3, 'M', u'تخ'),
+    (0xFCA4, 'M', u'تم'),
+    (0xFCA5, 'M', u'ته'),
+    (0xFCA6, 'M', u'ثم'),
+    (0xFCA7, 'M', u'جح'),
+    (0xFCA8, 'M', u'جم'),
+    (0xFCA9, 'M', u'حج'),
+    (0xFCAA, 'M', u'حم'),
+    (0xFCAB, 'M', u'خج'),
+    (0xFCAC, 'M', u'خم'),
+    (0xFCAD, 'M', u'سج'),
+    (0xFCAE, 'M', u'سح'),
+    (0xFCAF, 'M', u'سخ'),
+    (0xFCB0, 'M', u'سم'),
+    (0xFCB1, 'M', u'صح'),
+    (0xFCB2, 'M', u'صخ'),
+    (0xFCB3, 'M', u'صم'),
+    (0xFCB4, 'M', u'ضج'),
+    (0xFCB5, 'M', u'ضح'),
+    (0xFCB6, 'M', u'ضخ'),
+    (0xFCB7, 'M', u'ضم'),
+    (0xFCB8, 'M', u'طح'),
+    (0xFCB9, 'M', u'ظم'),
+    (0xFCBA, 'M', u'عج'),
+    (0xFCBB, 'M', u'عم'),
+    (0xFCBC, 'M', u'غج'),
+    (0xFCBD, 'M', u'غم'),
+    (0xFCBE, 'M', u'فج'),
+    (0xFCBF, 'M', u'فح'),
+    (0xFCC0, 'M', u'فخ'),
+    (0xFCC1, 'M', u'فم'),
+    (0xFCC2, 'M', u'قح'),
+    (0xFCC3, 'M', u'قم'),
+    (0xFCC4, 'M', u'كج'),
+    (0xFCC5, 'M', u'كح'),
+    (0xFCC6, 'M', u'كخ'),
+    (0xFCC7, 'M', u'كل'),
+    (0xFCC8, 'M', u'كم'),
+    (0xFCC9, 'M', u'لج'),
+    (0xFCCA, 'M', u'لح'),
+    (0xFCCB, 'M', u'لخ'),
+    (0xFCCC, 'M', u'لم'),
+    (0xFCCD, 'M', u'له'),
+    (0xFCCE, 'M', u'مج'),
+    (0xFCCF, 'M', u'مح'),
+    (0xFCD0, 'M', u'مخ'),
+    (0xFCD1, 'M', u'مم'),
+    (0xFCD2, 'M', u'نج'),
+    (0xFCD3, 'M', u'نح'),
+    (0xFCD4, 'M', u'نخ'),
+    (0xFCD5, 'M', u'نم'),
+    (0xFCD6, 'M', u'نه'),
+    (0xFCD7, 'M', u'هج'),
+    (0xFCD8, 'M', u'هم'),
+    (0xFCD9, 'M', u'هٰ'),
+    (0xFCDA, 'M', u'يج'),
+    (0xFCDB, 'M', u'يح'),
+    (0xFCDC, 'M', u'يخ'),
+    (0xFCDD, 'M', u'يم'),
+    (0xFCDE, 'M', u'يه'),
+    (0xFCDF, 'M', u'ئم'),
+    (0xFCE0, 'M', u'ئه'),
+    (0xFCE1, 'M', u'بم'),
+    (0xFCE2, 'M', u'به'),
+    (0xFCE3, 'M', u'تم'),
+    (0xFCE4, 'M', u'ته'),
+    (0xFCE5, 'M', u'ثم'),
+    (0xFCE6, 'M', u'ثه'),
+    (0xFCE7, 'M', u'سم'),
+    (0xFCE8, 'M', u'سه'),
+    (0xFCE9, 'M', u'شم'),
+    (0xFCEA, 'M', u'شه'),
+    (0xFCEB, 'M', u'كل'),
+    (0xFCEC, 'M', u'كم'),
+    (0xFCED, 'M', u'لم'),
+    (0xFCEE, 'M', u'نم'),
+    ]
+
+def _seg_47():
+    return [
+    (0xFCEF, 'M', u'نه'),
+    (0xFCF0, 'M', u'يم'),
+    (0xFCF1, 'M', u'يه'),
+    (0xFCF2, 'M', u'ـَّ'),
+    (0xFCF3, 'M', u'ـُّ'),
+    (0xFCF4, 'M', u'ـِّ'),
+    (0xFCF5, 'M', u'طى'),
+    (0xFCF6, 'M', u'طي'),
+    (0xFCF7, 'M', u'عى'),
+    (0xFCF8, 'M', u'عي'),
+    (0xFCF9, 'M', u'غى'),
+    (0xFCFA, 'M', u'غي'),
+    (0xFCFB, 'M', u'سى'),
+    (0xFCFC, 'M', u'سي'),
+    (0xFCFD, 'M', u'شى'),
+    (0xFCFE, 'M', u'شي'),
+    (0xFCFF, 'M', u'حى'),
+    (0xFD00, 'M', u'حي'),
+    (0xFD01, 'M', u'جى'),
+    (0xFD02, 'M', u'جي'),
+    (0xFD03, 'M', u'خى'),
+    (0xFD04, 'M', u'خي'),
+    (0xFD05, 'M', u'صى'),
+    (0xFD06, 'M', u'صي'),
+    (0xFD07, 'M', u'ضى'),
+    (0xFD08, 'M', u'ضي'),
+    (0xFD09, 'M', u'شج'),
+    (0xFD0A, 'M', u'شح'),
+    (0xFD0B, 'M', u'شخ'),
+    (0xFD0C, 'M', u'شم'),
+    (0xFD0D, 'M', u'شر'),
+    (0xFD0E, 'M', u'سر'),
+    (0xFD0F, 'M', u'صر'),
+    (0xFD10, 'M', u'ضر'),
+    (0xFD11, 'M', u'طى'),
+    (0xFD12, 'M', u'طي'),
+    (0xFD13, 'M', u'عى'),
+    (0xFD14, 'M', u'عي'),
+    (0xFD15, 'M', u'غى'),
+    (0xFD16, 'M', u'غي'),
+    (0xFD17, 'M', u'سى'),
+    (0xFD18, 'M', u'سي'),
+    (0xFD19, 'M', u'شى'),
+    (0xFD1A, 'M', u'شي'),
+    (0xFD1B, 'M', u'حى'),
+    (0xFD1C, 'M', u'حي'),
+    (0xFD1D, 'M', u'جى'),
+    (0xFD1E, 'M', u'جي'),
+    (0xFD1F, 'M', u'خى'),
+    (0xFD20, 'M', u'خي'),
+    (0xFD21, 'M', u'صى'),
+    (0xFD22, 'M', u'صي'),
+    (0xFD23, 'M', u'ضى'),
+    (0xFD24, 'M', u'ضي'),
+    (0xFD25, 'M', u'شج'),
+    (0xFD26, 'M', u'شح'),
+    (0xFD27, 'M', u'شخ'),
+    (0xFD28, 'M', u'شم'),
+    (0xFD29, 'M', u'شر'),
+    (0xFD2A, 'M', u'سر'),
+    (0xFD2B, 'M', u'صر'),
+    (0xFD2C, 'M', u'ضر'),
+    (0xFD2D, 'M', u'شج'),
+    (0xFD2E, 'M', u'شح'),
+    (0xFD2F, 'M', u'شخ'),
+    (0xFD30, 'M', u'شم'),
+    (0xFD31, 'M', u'سه'),
+    (0xFD32, 'M', u'شه'),
+    (0xFD33, 'M', u'طم'),
+    (0xFD34, 'M', u'سج'),
+    (0xFD35, 'M', u'سح'),
+    (0xFD36, 'M', u'سخ'),
+    (0xFD37, 'M', u'شج'),
+    (0xFD38, 'M', u'شح'),
+    (0xFD39, 'M', u'شخ'),
+    (0xFD3A, 'M', u'طم'),
+    (0xFD3B, 'M', u'ظم'),
+    (0xFD3C, 'M', u'اً'),
+    (0xFD3E, 'V'),
+    (0xFD40, 'X'),
+    (0xFD50, 'M', u'تجم'),
+    (0xFD51, 'M', u'تحج'),
+    (0xFD53, 'M', u'تحم'),
+    (0xFD54, 'M', u'تخم'),
+    (0xFD55, 'M', u'تمج'),
+    (0xFD56, 'M', u'تمح'),
+    (0xFD57, 'M', u'تمخ'),
+    (0xFD58, 'M', u'جمح'),
+    (0xFD5A, 'M', u'حمي'),
+    (0xFD5B, 'M', u'حمى'),
+    (0xFD5C, 'M', u'سحج'),
+    (0xFD5D, 'M', u'سجح'),
+    (0xFD5E, 'M', u'سجى'),
+    (0xFD5F, 'M', u'سمح'),
+    (0xFD61, 'M', u'سمج'),
+    (0xFD62, 'M', u'سمم'),
+    (0xFD64, 'M', u'صحح'),
+    (0xFD66, 'M', u'صمم'),
+    (0xFD67, 'M', u'شحم'),
+    (0xFD69, 'M', u'شجي'),
+    ]
+
+def _seg_48():
+    return [
+    (0xFD6A, 'M', u'شمخ'),
+    (0xFD6C, 'M', u'شمم'),
+    (0xFD6E, 'M', u'ضحى'),
+    (0xFD6F, 'M', u'ضخم'),
+    (0xFD71, 'M', u'طمح'),
+    (0xFD73, 'M', u'طمم'),
+    (0xFD74, 'M', u'طمي'),
+    (0xFD75, 'M', u'عجم'),
+    (0xFD76, 'M', u'عمم'),
+    (0xFD78, 'M', u'عمى'),
+    (0xFD79, 'M', u'غمم'),
+    (0xFD7A, 'M', u'غمي'),
+    (0xFD7B, 'M', u'غمى'),
+    (0xFD7C, 'M', u'فخم'),
+    (0xFD7E, 'M', u'قمح'),
+    (0xFD7F, 'M', u'قمم'),
+    (0xFD80, 'M', u'لحم'),
+    (0xFD81, 'M', u'لحي'),
+    (0xFD82, 'M', u'لحى'),
+    (0xFD83, 'M', u'لجج'),
+    (0xFD85, 'M', u'لخم'),
+    (0xFD87, 'M', u'لمح'),
+    (0xFD89, 'M', u'محج'),
+    (0xFD8A, 'M', u'محم'),
+    (0xFD8B, 'M', u'محي'),
+    (0xFD8C, 'M', u'مجح'),
+    (0xFD8D, 'M', u'مجم'),
+    (0xFD8E, 'M', u'مخج'),
+    (0xFD8F, 'M', u'مخم'),
+    (0xFD90, 'X'),
+    (0xFD92, 'M', u'مجخ'),
+    (0xFD93, 'M', u'همج'),
+    (0xFD94, 'M', u'همم'),
+    (0xFD95, 'M', u'نحم'),
+    (0xFD96, 'M', u'نحى'),
+    (0xFD97, 'M', u'نجم'),
+    (0xFD99, 'M', u'نجى'),
+    (0xFD9A, 'M', u'نمي'),
+    (0xFD9B, 'M', u'نمى'),
+    (0xFD9C, 'M', u'يمم'),
+    (0xFD9E, 'M', u'بخي'),
+    (0xFD9F, 'M', u'تجي'),
+    (0xFDA0, 'M', u'تجى'),
+    (0xFDA1, 'M', u'تخي'),
+    (0xFDA2, 'M', u'تخى'),
+    (0xFDA3, 'M', u'تمي'),
+    (0xFDA4, 'M', u'تمى'),
+    (0xFDA5, 'M', u'جمي'),
+    (0xFDA6, 'M', u'جحى'),
+    (0xFDA7, 'M', u'جمى'),
+    (0xFDA8, 'M', u'سخى'),
+    (0xFDA9, 'M', u'صحي'),
+    (0xFDAA, 'M', u'شحي'),
+    (0xFDAB, 'M', u'ضحي'),
+    (0xFDAC, 'M', u'لجي'),
+    (0xFDAD, 'M', u'لمي'),
+    (0xFDAE, 'M', u'يحي'),
+    (0xFDAF, 'M', u'يجي'),
+    (0xFDB0, 'M', u'يمي'),
+    (0xFDB1, 'M', u'ممي'),
+    (0xFDB2, 'M', u'قمي'),
+    (0xFDB3, 'M', u'نحي'),
+    (0xFDB4, 'M', u'قمح'),
+    (0xFDB5, 'M', u'لحم'),
+    (0xFDB6, 'M', u'عمي'),
+    (0xFDB7, 'M', u'كمي'),
+    (0xFDB8, 'M', u'نجح'),
+    (0xFDB9, 'M', u'مخي'),
+    (0xFDBA, 'M', u'لجم'),
+    (0xFDBB, 'M', u'كمم'),
+    (0xFDBC, 'M', u'لجم'),
+    (0xFDBD, 'M', u'نجح'),
+    (0xFDBE, 'M', u'جحي'),
+    (0xFDBF, 'M', u'حجي'),
+    (0xFDC0, 'M', u'مجي'),
+    (0xFDC1, 'M', u'فمي'),
+    (0xFDC2, 'M', u'بحي'),
+    (0xFDC3, 'M', u'كمم'),
+    (0xFDC4, 'M', u'عجم'),
+    (0xFDC5, 'M', u'صمم'),
+    (0xFDC6, 'M', u'سخي'),
+    (0xFDC7, 'M', u'نجي'),
+    (0xFDC8, 'X'),
+    (0xFDF0, 'M', u'صلے'),
+    (0xFDF1, 'M', u'قلے'),
+    (0xFDF2, 'M', u'الله'),
+    (0xFDF3, 'M', u'اكبر'),
+    (0xFDF4, 'M', u'محمد'),
+    (0xFDF5, 'M', u'صلعم'),
+    (0xFDF6, 'M', u'رسول'),
+    (0xFDF7, 'M', u'عليه'),
+    (0xFDF8, 'M', u'وسلم'),
+    (0xFDF9, 'M', u'صلى'),
+    (0xFDFA, '3', u'صلى الله عليه وسلم'),
+    (0xFDFB, '3', u'جل جلاله'),
+    (0xFDFC, 'M', u'ریال'),
+    (0xFDFD, 'V'),
+    (0xFDFE, 'X'),
+    (0xFE00, 'I'),
+    (0xFE10, '3', u','),
+    ]
+
+def _seg_49():
+    return [
+    (0xFE11, 'M', u'、'),
+    (0xFE12, 'X'),
+    (0xFE13, '3', u':'),
+    (0xFE14, '3', u';'),
+    (0xFE15, '3', u'!'),
+    (0xFE16, '3', u'?'),
+    (0xFE17, 'M', u'〖'),
+    (0xFE18, 'M', u'〗'),
+    (0xFE19, 'X'),
+    (0xFE20, 'V'),
+    (0xFE30, 'X'),
+    (0xFE31, 'M', u'—'),
+    (0xFE32, 'M', u'–'),
+    (0xFE33, '3', u'_'),
+    (0xFE35, '3', u'('),
+    (0xFE36, '3', u')'),
+    (0xFE37, '3', u'{'),
+    (0xFE38, '3', u'}'),
+    (0xFE39, 'M', u'〔'),
+    (0xFE3A, 'M', u'〕'),
+    (0xFE3B, 'M', u'【'),
+    (0xFE3C, 'M', u'】'),
+    (0xFE3D, 'M', u'《'),
+    (0xFE3E, 'M', u'》'),
+    (0xFE3F, 'M', u'〈'),
+    (0xFE40, 'M', u'〉'),
+    (0xFE41, 'M', u'「'),
+    (0xFE42, 'M', u'」'),
+    (0xFE43, 'M', u'『'),
+    (0xFE44, 'M', u'』'),
+    (0xFE45, 'V'),
+    (0xFE47, '3', u'['),
+    (0xFE48, '3', u']'),
+    (0xFE49, '3', u' ̅'),
+    (0xFE4D, '3', u'_'),
+    (0xFE50, '3', u','),
+    (0xFE51, 'M', u'、'),
+    (0xFE52, 'X'),
+    (0xFE54, '3', u';'),
+    (0xFE55, '3', u':'),
+    (0xFE56, '3', u'?'),
+    (0xFE57, '3', u'!'),
+    (0xFE58, 'M', u'—'),
+    (0xFE59, '3', u'('),
+    (0xFE5A, '3', u')'),
+    (0xFE5B, '3', u'{'),
+    (0xFE5C, '3', u'}'),
+    (0xFE5D, 'M', u'〔'),
+    (0xFE5E, 'M', u'〕'),
+    (0xFE5F, '3', u'#'),
+    (0xFE60, '3', u'&'),
+    (0xFE61, '3', u'*'),
+    (0xFE62, '3', u'+'),
+    (0xFE63, 'M', u'-'),
+    (0xFE64, '3', u'<'),
+    (0xFE65, '3', u'>'),
+    (0xFE66, '3', u'='),
+    (0xFE67, 'X'),
+    (0xFE68, '3', u'\\'),
+    (0xFE69, '3', u'$'),
+    (0xFE6A, '3', u'%'),
+    (0xFE6B, '3', u'@'),
+    (0xFE6C, 'X'),
+    (0xFE70, '3', u' ً'),
+    (0xFE71, 'M', u'ـً'),
+    (0xFE72, '3', u' ٌ'),
+    (0xFE73, 'V'),
+    (0xFE74, '3', u' ٍ'),
+    (0xFE75, 'X'),
+    (0xFE76, '3', u' َ'),
+    (0xFE77, 'M', u'ـَ'),
+    (0xFE78, '3', u' ُ'),
+    (0xFE79, 'M', u'ـُ'),
+    (0xFE7A, '3', u' ِ'),
+    (0xFE7B, 'M', u'ـِ'),
+    (0xFE7C, '3', u' ّ'),
+    (0xFE7D, 'M', u'ـّ'),
+    (0xFE7E, '3', u' ْ'),
+    (0xFE7F, 'M', u'ـْ'),
+    (0xFE80, 'M', u'ء'),
+    (0xFE81, 'M', u'آ'),
+    (0xFE83, 'M', u'أ'),
+    (0xFE85, 'M', u'ؤ'),
+    (0xFE87, 'M', u'إ'),
+    (0xFE89, 'M', u'ئ'),
+    (0xFE8D, 'M', u'ا'),
+    (0xFE8F, 'M', u'ب'),
+    (0xFE93, 'M', u'ة'),
+    (0xFE95, 'M', u'ت'),
+    (0xFE99, 'M', u'ث'),
+    (0xFE9D, 'M', u'ج'),
+    (0xFEA1, 'M', u'ح'),
+    (0xFEA5, 'M', u'خ'),
+    (0xFEA9, 'M', u'د'),
+    (0xFEAB, 'M', u'ذ'),
+    (0xFEAD, 'M', u'ر'),
+    (0xFEAF, 'M', u'ز'),
+    (0xFEB1, 'M', u'س'),
+    (0xFEB5, 'M', u'ش'),
+    (0xFEB9, 'M', u'ص'),
+    ]
+
+def _seg_50():
+    return [
+    (0xFEBD, 'M', u'ض'),
+    (0xFEC1, 'M', u'ط'),
+    (0xFEC5, 'M', u'ظ'),
+    (0xFEC9, 'M', u'ع'),
+    (0xFECD, 'M', u'غ'),
+    (0xFED1, 'M', u'ف'),
+    (0xFED5, 'M', u'ق'),
+    (0xFED9, 'M', u'ك'),
+    (0xFEDD, 'M', u'ل'),
+    (0xFEE1, 'M', u'م'),
+    (0xFEE5, 'M', u'ن'),
+    (0xFEE9, 'M', u'ه'),
+    (0xFEED, 'M', u'و'),
+    (0xFEEF, 'M', u'ى'),
+    (0xFEF1, 'M', u'ي'),
+    (0xFEF5, 'M', u'لآ'),
+    (0xFEF7, 'M', u'لأ'),
+    (0xFEF9, 'M', u'لإ'),
+    (0xFEFB, 'M', u'لا'),
+    (0xFEFD, 'X'),
+    (0xFEFF, 'I'),
+    (0xFF00, 'X'),
+    (0xFF01, '3', u'!'),
+    (0xFF02, '3', u'"'),
+    (0xFF03, '3', u'#'),
+    (0xFF04, '3', u'$'),
+    (0xFF05, '3', u'%'),
+    (0xFF06, '3', u'&'),
+    (0xFF07, '3', u'\''),
+    (0xFF08, '3', u'('),
+    (0xFF09, '3', u')'),
+    (0xFF0A, '3', u'*'),
+    (0xFF0B, '3', u'+'),
+    (0xFF0C, '3', u','),
+    (0xFF0D, 'M', u'-'),
+    (0xFF0E, 'M', u'.'),
+    (0xFF0F, '3', u'/'),
+    (0xFF10, 'M', u'0'),
+    (0xFF11, 'M', u'1'),
+    (0xFF12, 'M', u'2'),
+    (0xFF13, 'M', u'3'),
+    (0xFF14, 'M', u'4'),
+    (0xFF15, 'M', u'5'),
+    (0xFF16, 'M', u'6'),
+    (0xFF17, 'M', u'7'),
+    (0xFF18, 'M', u'8'),
+    (0xFF19, 'M', u'9'),
+    (0xFF1A, '3', u':'),
+    (0xFF1B, '3', u';'),
+    (0xFF1C, '3', u'<'),
+    (0xFF1D, '3', u'='),
+    (0xFF1E, '3', u'>'),
+    (0xFF1F, '3', u'?'),
+    (0xFF20, '3', u'@'),
+    (0xFF21, 'M', u'a'),
+    (0xFF22, 'M', u'b'),
+    (0xFF23, 'M', u'c'),
+    (0xFF24, 'M', u'd'),
+    (0xFF25, 'M', u'e'),
+    (0xFF26, 'M', u'f'),
+    (0xFF27, 'M', u'g'),
+    (0xFF28, 'M', u'h'),
+    (0xFF29, 'M', u'i'),
+    (0xFF2A, 'M', u'j'),
+    (0xFF2B, 'M', u'k'),
+    (0xFF2C, 'M', u'l'),
+    (0xFF2D, 'M', u'm'),
+    (0xFF2E, 'M', u'n'),
+    (0xFF2F, 'M', u'o'),
+    (0xFF30, 'M', u'p'),
+    (0xFF31, 'M', u'q'),
+    (0xFF32, 'M', u'r'),
+    (0xFF33, 'M', u's'),
+    (0xFF34, 'M', u't'),
+    (0xFF35, 'M', u'u'),
+    (0xFF36, 'M', u'v'),
+    (0xFF37, 'M', u'w'),
+    (0xFF38, 'M', u'x'),
+    (0xFF39, 'M', u'y'),
+    (0xFF3A, 'M', u'z'),
+    (0xFF3B, '3', u'['),
+    (0xFF3C, '3', u'\\'),
+    (0xFF3D, '3', u']'),
+    (0xFF3E, '3', u'^'),
+    (0xFF3F, '3', u'_'),
+    (0xFF40, '3', u'`'),
+    (0xFF41, 'M', u'a'),
+    (0xFF42, 'M', u'b'),
+    (0xFF43, 'M', u'c'),
+    (0xFF44, 'M', u'd'),
+    (0xFF45, 'M', u'e'),
+    (0xFF46, 'M', u'f'),
+    (0xFF47, 'M', u'g'),
+    (0xFF48, 'M', u'h'),
+    (0xFF49, 'M', u'i'),
+    (0xFF4A, 'M', u'j'),
+    (0xFF4B, 'M', u'k'),
+    (0xFF4C, 'M', u'l'),
+    (0xFF4D, 'M', u'm'),
+    (0xFF4E, 'M', u'n'),
+    ]
+
+def _seg_51():
+    return [
+    (0xFF4F, 'M', u'o'),
+    (0xFF50, 'M', u'p'),
+    (0xFF51, 'M', u'q'),
+    (0xFF52, 'M', u'r'),
+    (0xFF53, 'M', u's'),
+    (0xFF54, 'M', u't'),
+    (0xFF55, 'M', u'u'),
+    (0xFF56, 'M', u'v'),
+    (0xFF57, 'M', u'w'),
+    (0xFF58, 'M', u'x'),
+    (0xFF59, 'M', u'y'),
+    (0xFF5A, 'M', u'z'),
+    (0xFF5B, '3', u'{'),
+    (0xFF5C, '3', u'|'),
+    (0xFF5D, '3', u'}'),
+    (0xFF5E, '3', u'~'),
+    (0xFF5F, 'M', u'⦅'),
+    (0xFF60, 'M', u'⦆'),
+    (0xFF61, 'M', u'.'),
+    (0xFF62, 'M', u'「'),
+    (0xFF63, 'M', u'」'),
+    (0xFF64, 'M', u'、'),
+    (0xFF65, 'M', u'・'),
+    (0xFF66, 'M', u'ヲ'),
+    (0xFF67, 'M', u'ァ'),
+    (0xFF68, 'M', u'ィ'),
+    (0xFF69, 'M', u'ゥ'),
+    (0xFF6A, 'M', u'ェ'),
+    (0xFF6B, 'M', u'ォ'),
+    (0xFF6C, 'M', u'ャ'),
+    (0xFF6D, 'M', u'ュ'),
+    (0xFF6E, 'M', u'ョ'),
+    (0xFF6F, 'M', u'ッ'),
+    (0xFF70, 'M', u'ー'),
+    (0xFF71, 'M', u'ア'),
+    (0xFF72, 'M', u'イ'),
+    (0xFF73, 'M', u'ウ'),
+    (0xFF74, 'M', u'エ'),
+    (0xFF75, 'M', u'オ'),
+    (0xFF76, 'M', u'カ'),
+    (0xFF77, 'M', u'キ'),
+    (0xFF78, 'M', u'ク'),
+    (0xFF79, 'M', u'ケ'),
+    (0xFF7A, 'M', u'コ'),
+    (0xFF7B, 'M', u'サ'),
+    (0xFF7C, 'M', u'シ'),
+    (0xFF7D, 'M', u'ス'),
+    (0xFF7E, 'M', u'セ'),
+    (0xFF7F, 'M', u'ソ'),
+    (0xFF80, 'M', u'タ'),
+    (0xFF81, 'M', u'チ'),
+    (0xFF82, 'M', u'ツ'),
+    (0xFF83, 'M', u'テ'),
+    (0xFF84, 'M', u'ト'),
+    (0xFF85, 'M', u'ナ'),
+    (0xFF86, 'M', u'ニ'),
+    (0xFF87, 'M', u'ヌ'),
+    (0xFF88, 'M', u'ネ'),
+    (0xFF89, 'M', u'ノ'),
+    (0xFF8A, 'M', u'ハ'),
+    (0xFF8B, 'M', u'ヒ'),
+    (0xFF8C, 'M', u'フ'),
+    (0xFF8D, 'M', u'ヘ'),
+    (0xFF8E, 'M', u'ホ'),
+    (0xFF8F, 'M', u'マ'),
+    (0xFF90, 'M', u'ミ'),
+    (0xFF91, 'M', u'ム'),
+    (0xFF92, 'M', u'メ'),
+    (0xFF93, 'M', u'モ'),
+    (0xFF94, 'M', u'ヤ'),
+    (0xFF95, 'M', u'ユ'),
+    (0xFF96, 'M', u'ヨ'),
+    (0xFF97, 'M', u'ラ'),
+    (0xFF98, 'M', u'リ'),
+    (0xFF99, 'M', u'ル'),
+    (0xFF9A, 'M', u'レ'),
+    (0xFF9B, 'M', u'ロ'),
+    (0xFF9C, 'M', u'ワ'),
+    (0xFF9D, 'M', u'ン'),
+    (0xFF9E, 'M', u'゙'),
+    (0xFF9F, 'M', u'゚'),
+    (0xFFA0, 'X'),
+    (0xFFA1, 'M', u'ᄀ'),
+    (0xFFA2, 'M', u'ᄁ'),
+    (0xFFA3, 'M', u'ᆪ'),
+    (0xFFA4, 'M', u'ᄂ'),
+    (0xFFA5, 'M', u'ᆬ'),
+    (0xFFA6, 'M', u'ᆭ'),
+    (0xFFA7, 'M', u'ᄃ'),
+    (0xFFA8, 'M', u'ᄄ'),
+    (0xFFA9, 'M', u'ᄅ'),
+    (0xFFAA, 'M', u'ᆰ'),
+    (0xFFAB, 'M', u'ᆱ'),
+    (0xFFAC, 'M', u'ᆲ'),
+    (0xFFAD, 'M', u'ᆳ'),
+    (0xFFAE, 'M', u'ᆴ'),
+    (0xFFAF, 'M', u'ᆵ'),
+    (0xFFB0, 'M', u'ᄚ'),
+    (0xFFB1, 'M', u'ᄆ'),
+    (0xFFB2, 'M', u'ᄇ'),
+    ]
+
+def _seg_52():
+    return [
+    (0xFFB3, 'M', u'ᄈ'),
+    (0xFFB4, 'M', u'ᄡ'),
+    (0xFFB5, 'M', u'ᄉ'),
+    (0xFFB6, 'M', u'ᄊ'),
+    (0xFFB7, 'M', u'ᄋ'),
+    (0xFFB8, 'M', u'ᄌ'),
+    (0xFFB9, 'M', u'ᄍ'),
+    (0xFFBA, 'M', u'ᄎ'),
+    (0xFFBB, 'M', u'ᄏ'),
+    (0xFFBC, 'M', u'ᄐ'),
+    (0xFFBD, 'M', u'ᄑ'),
+    (0xFFBE, 'M', u'ᄒ'),
+    (0xFFBF, 'X'),
+    (0xFFC2, 'M', u'ᅡ'),
+    (0xFFC3, 'M', u'ᅢ'),
+    (0xFFC4, 'M', u'ᅣ'),
+    (0xFFC5, 'M', u'ᅤ'),
+    (0xFFC6, 'M', u'ᅥ'),
+    (0xFFC7, 'M', u'ᅦ'),
+    (0xFFC8, 'X'),
+    (0xFFCA, 'M', u'ᅧ'),
+    (0xFFCB, 'M', u'ᅨ'),
+    (0xFFCC, 'M', u'ᅩ'),
+    (0xFFCD, 'M', u'ᅪ'),
+    (0xFFCE, 'M', u'ᅫ'),
+    (0xFFCF, 'M', u'ᅬ'),
+    (0xFFD0, 'X'),
+    (0xFFD2, 'M', u'ᅭ'),
+    (0xFFD3, 'M', u'ᅮ'),
+    (0xFFD4, 'M', u'ᅯ'),
+    (0xFFD5, 'M', u'ᅰ'),
+    (0xFFD6, 'M', u'ᅱ'),
+    (0xFFD7, 'M', u'ᅲ'),
+    (0xFFD8, 'X'),
+    (0xFFDA, 'M', u'ᅳ'),
+    (0xFFDB, 'M', u'ᅴ'),
+    (0xFFDC, 'M', u'ᅵ'),
+    (0xFFDD, 'X'),
+    (0xFFE0, 'M', u'¢'),
+    (0xFFE1, 'M', u'£'),
+    (0xFFE2, 'M', u'¬'),
+    (0xFFE3, '3', u' ̄'),
+    (0xFFE4, 'M', u'¦'),
+    (0xFFE5, 'M', u'¥'),
+    (0xFFE6, 'M', u'₩'),
+    (0xFFE7, 'X'),
+    (0xFFE8, 'M', u'│'),
+    (0xFFE9, 'M', u'←'),
+    (0xFFEA, 'M', u'↑'),
+    (0xFFEB, 'M', u'→'),
+    (0xFFEC, 'M', u'↓'),
+    (0xFFED, 'M', u'■'),
+    (0xFFEE, 'M', u'○'),
+    (0xFFEF, 'X'),
+    (0x10000, 'V'),
+    (0x1000C, 'X'),
+    (0x1000D, 'V'),
+    (0x10027, 'X'),
+    (0x10028, 'V'),
+    (0x1003B, 'X'),
+    (0x1003C, 'V'),
+    (0x1003E, 'X'),
+    (0x1003F, 'V'),
+    (0x1004E, 'X'),
+    (0x10050, 'V'),
+    (0x1005E, 'X'),
+    (0x10080, 'V'),
+    (0x100FB, 'X'),
+    (0x10100, 'V'),
+    (0x10103, 'X'),
+    (0x10107, 'V'),
+    (0x10134, 'X'),
+    (0x10137, 'V'),
+    (0x1018F, 'X'),
+    (0x10190, 'V'),
+    (0x1019C, 'X'),
+    (0x101A0, 'V'),
+    (0x101A1, 'X'),
+    (0x101D0, 'V'),
+    (0x101FE, 'X'),
+    (0x10280, 'V'),
+    (0x1029D, 'X'),
+    (0x102A0, 'V'),
+    (0x102D1, 'X'),
+    (0x102E0, 'V'),
+    (0x102FC, 'X'),
+    (0x10300, 'V'),
+    (0x10324, 'X'),
+    (0x1032D, 'V'),
+    (0x1034B, 'X'),
+    (0x10350, 'V'),
+    (0x1037B, 'X'),
+    (0x10380, 'V'),
+    (0x1039E, 'X'),
+    (0x1039F, 'V'),
+    (0x103C4, 'X'),
+    (0x103C8, 'V'),
+    (0x103D6, 'X'),
+    (0x10400, 'M', u'𐐨'),
+    (0x10401, 'M', u'𐐩'),
+    ]
+
+def _seg_53():
+    return [
+    (0x10402, 'M', u'𐐪'),
+    (0x10403, 'M', u'𐐫'),
+    (0x10404, 'M', u'𐐬'),
+    (0x10405, 'M', u'𐐭'),
+    (0x10406, 'M', u'𐐮'),
+    (0x10407, 'M', u'𐐯'),
+    (0x10408, 'M', u'𐐰'),
+    (0x10409, 'M', u'𐐱'),
+    (0x1040A, 'M', u'𐐲'),
+    (0x1040B, 'M', u'𐐳'),
+    (0x1040C, 'M', u'𐐴'),
+    (0x1040D, 'M', u'𐐵'),
+    (0x1040E, 'M', u'𐐶'),
+    (0x1040F, 'M', u'𐐷'),
+    (0x10410, 'M', u'𐐸'),
+    (0x10411, 'M', u'𐐹'),
+    (0x10412, 'M', u'𐐺'),
+    (0x10413, 'M', u'𐐻'),
+    (0x10414, 'M', u'𐐼'),
+    (0x10415, 'M', u'𐐽'),
+    (0x10416, 'M', u'𐐾'),
+    (0x10417, 'M', u'𐐿'),
+    (0x10418, 'M', u'𐑀'),
+    (0x10419, 'M', u'𐑁'),
+    (0x1041A, 'M', u'𐑂'),
+    (0x1041B, 'M', u'𐑃'),
+    (0x1041C, 'M', u'𐑄'),
+    (0x1041D, 'M', u'𐑅'),
+    (0x1041E, 'M', u'𐑆'),
+    (0x1041F, 'M', u'𐑇'),
+    (0x10420, 'M', u'𐑈'),
+    (0x10421, 'M', u'𐑉'),
+    (0x10422, 'M', u'𐑊'),
+    (0x10423, 'M', u'𐑋'),
+    (0x10424, 'M', u'𐑌'),
+    (0x10425, 'M', u'𐑍'),
+    (0x10426, 'M', u'𐑎'),
+    (0x10427, 'M', u'𐑏'),
+    (0x10428, 'V'),
+    (0x1049E, 'X'),
+    (0x104A0, 'V'),
+    (0x104AA, 'X'),
+    (0x104B0, 'M', u'𐓘'),
+    (0x104B1, 'M', u'𐓙'),
+    (0x104B2, 'M', u'𐓚'),
+    (0x104B3, 'M', u'𐓛'),
+    (0x104B4, 'M', u'𐓜'),
+    (0x104B5, 'M', u'𐓝'),
+    (0x104B6, 'M', u'𐓞'),
+    (0x104B7, 'M', u'𐓟'),
+    (0x104B8, 'M', u'𐓠'),
+    (0x104B9, 'M', u'𐓡'),
+    (0x104BA, 'M', u'𐓢'),
+    (0x104BB, 'M', u'𐓣'),
+    (0x104BC, 'M', u'𐓤'),
+    (0x104BD, 'M', u'𐓥'),
+    (0x104BE, 'M', u'𐓦'),
+    (0x104BF, 'M', u'𐓧'),
+    (0x104C0, 'M', u'𐓨'),
+    (0x104C1, 'M', u'𐓩'),
+    (0x104C2, 'M', u'𐓪'),
+    (0x104C3, 'M', u'𐓫'),
+    (0x104C4, 'M', u'𐓬'),
+    (0x104C5, 'M', u'𐓭'),
+    (0x104C6, 'M', u'𐓮'),
+    (0x104C7, 'M', u'𐓯'),
+    (0x104C8, 'M', u'𐓰'),
+    (0x104C9, 'M', u'𐓱'),
+    (0x104CA, 'M', u'𐓲'),
+    (0x104CB, 'M', u'𐓳'),
+    (0x104CC, 'M', u'𐓴'),
+    (0x104CD, 'M', u'𐓵'),
+    (0x104CE, 'M', u'𐓶'),
+    (0x104CF, 'M', u'𐓷'),
+    (0x104D0, 'M', u'𐓸'),
+    (0x104D1, 'M', u'𐓹'),
+    (0x104D2, 'M', u'𐓺'),
+    (0x104D3, 'M', u'𐓻'),
+    (0x104D4, 'X'),
+    (0x104D8, 'V'),
+    (0x104FC, 'X'),
+    (0x10500, 'V'),
+    (0x10528, 'X'),
+    (0x10530, 'V'),
+    (0x10564, 'X'),
+    (0x1056F, 'V'),
+    (0x10570, 'X'),
+    (0x10600, 'V'),
+    (0x10737, 'X'),
+    (0x10740, 'V'),
+    (0x10756, 'X'),
+    (0x10760, 'V'),
+    (0x10768, 'X'),
+    (0x10800, 'V'),
+    (0x10806, 'X'),
+    (0x10808, 'V'),
+    (0x10809, 'X'),
+    (0x1080A, 'V'),
+    (0x10836, 'X'),
+    (0x10837, 'V'),
+    ]
+
+def _seg_54():
+    return [
+    (0x10839, 'X'),
+    (0x1083C, 'V'),
+    (0x1083D, 'X'),
+    (0x1083F, 'V'),
+    (0x10856, 'X'),
+    (0x10857, 'V'),
+    (0x1089F, 'X'),
+    (0x108A7, 'V'),
+    (0x108B0, 'X'),
+    (0x108E0, 'V'),
+    (0x108F3, 'X'),
+    (0x108F4, 'V'),
+    (0x108F6, 'X'),
+    (0x108FB, 'V'),
+    (0x1091C, 'X'),
+    (0x1091F, 'V'),
+    (0x1093A, 'X'),
+    (0x1093F, 'V'),
+    (0x10940, 'X'),
+    (0x10980, 'V'),
+    (0x109B8, 'X'),
+    (0x109BC, 'V'),
+    (0x109D0, 'X'),
+    (0x109D2, 'V'),
+    (0x10A04, 'X'),
+    (0x10A05, 'V'),
+    (0x10A07, 'X'),
+    (0x10A0C, 'V'),
+    (0x10A14, 'X'),
+    (0x10A15, 'V'),
+    (0x10A18, 'X'),
+    (0x10A19, 'V'),
+    (0x10A36, 'X'),
+    (0x10A38, 'V'),
+    (0x10A3B, 'X'),
+    (0x10A3F, 'V'),
+    (0x10A49, 'X'),
+    (0x10A50, 'V'),
+    (0x10A59, 'X'),
+    (0x10A60, 'V'),
+    (0x10AA0, 'X'),
+    (0x10AC0, 'V'),
+    (0x10AE7, 'X'),
+    (0x10AEB, 'V'),
+    (0x10AF7, 'X'),
+    (0x10B00, 'V'),
+    (0x10B36, 'X'),
+    (0x10B39, 'V'),
+    (0x10B56, 'X'),
+    (0x10B58, 'V'),
+    (0x10B73, 'X'),
+    (0x10B78, 'V'),
+    (0x10B92, 'X'),
+    (0x10B99, 'V'),
+    (0x10B9D, 'X'),
+    (0x10BA9, 'V'),
+    (0x10BB0, 'X'),
+    (0x10C00, 'V'),
+    (0x10C49, 'X'),
+    (0x10C80, 'M', u'𐳀'),
+    (0x10C81, 'M', u'𐳁'),
+    (0x10C82, 'M', u'𐳂'),
+    (0x10C83, 'M', u'𐳃'),
+    (0x10C84, 'M', u'𐳄'),
+    (0x10C85, 'M', u'𐳅'),
+    (0x10C86, 'M', u'𐳆'),
+    (0x10C87, 'M', u'𐳇'),
+    (0x10C88, 'M', u'𐳈'),
+    (0x10C89, 'M', u'𐳉'),
+    (0x10C8A, 'M', u'𐳊'),
+    (0x10C8B, 'M', u'𐳋'),
+    (0x10C8C, 'M', u'𐳌'),
+    (0x10C8D, 'M', u'𐳍'),
+    (0x10C8E, 'M', u'𐳎'),
+    (0x10C8F, 'M', u'𐳏'),
+    (0x10C90, 'M', u'𐳐'),
+    (0x10C91, 'M', u'𐳑'),
+    (0x10C92, 'M', u'𐳒'),
+    (0x10C93, 'M', u'𐳓'),
+    (0x10C94, 'M', u'𐳔'),
+    (0x10C95, 'M', u'𐳕'),
+    (0x10C96, 'M', u'𐳖'),
+    (0x10C97, 'M', u'𐳗'),
+    (0x10C98, 'M', u'𐳘'),
+    (0x10C99, 'M', u'𐳙'),
+    (0x10C9A, 'M', u'𐳚'),
+    (0x10C9B, 'M', u'𐳛'),
+    (0x10C9C, 'M', u'𐳜'),
+    (0x10C9D, 'M', u'𐳝'),
+    (0x10C9E, 'M', u'𐳞'),
+    (0x10C9F, 'M', u'𐳟'),
+    (0x10CA0, 'M', u'𐳠'),
+    (0x10CA1, 'M', u'𐳡'),
+    (0x10CA2, 'M', u'𐳢'),
+    (0x10CA3, 'M', u'𐳣'),
+    (0x10CA4, 'M', u'𐳤'),
+    (0x10CA5, 'M', u'𐳥'),
+    (0x10CA6, 'M', u'𐳦'),
+    (0x10CA7, 'M', u'𐳧'),
+    (0x10CA8, 'M', u'𐳨'),
+    ]
+
+def _seg_55():
+    return [
+    (0x10CA9, 'M', u'𐳩'),
+    (0x10CAA, 'M', u'𐳪'),
+    (0x10CAB, 'M', u'𐳫'),
+    (0x10CAC, 'M', u'𐳬'),
+    (0x10CAD, 'M', u'𐳭'),
+    (0x10CAE, 'M', u'𐳮'),
+    (0x10CAF, 'M', u'𐳯'),
+    (0x10CB0, 'M', u'𐳰'),
+    (0x10CB1, 'M', u'𐳱'),
+    (0x10CB2, 'M', u'𐳲'),
+    (0x10CB3, 'X'),
+    (0x10CC0, 'V'),
+    (0x10CF3, 'X'),
+    (0x10CFA, 'V'),
+    (0x10D28, 'X'),
+    (0x10D30, 'V'),
+    (0x10D3A, 'X'),
+    (0x10E60, 'V'),
+    (0x10E7F, 'X'),
+    (0x10F00, 'V'),
+    (0x10F28, 'X'),
+    (0x10F30, 'V'),
+    (0x10F5A, 'X'),
+    (0x11000, 'V'),
+    (0x1104E, 'X'),
+    (0x11052, 'V'),
+    (0x11070, 'X'),
+    (0x1107F, 'V'),
+    (0x110BD, 'X'),
+    (0x110BE, 'V'),
+    (0x110C2, 'X'),
+    (0x110D0, 'V'),
+    (0x110E9, 'X'),
+    (0x110F0, 'V'),
+    (0x110FA, 'X'),
+    (0x11100, 'V'),
+    (0x11135, 'X'),
+    (0x11136, 'V'),
+    (0x11147, 'X'),
+    (0x11150, 'V'),
+    (0x11177, 'X'),
+    (0x11180, 'V'),
+    (0x111CE, 'X'),
+    (0x111D0, 'V'),
+    (0x111E0, 'X'),
+    (0x111E1, 'V'),
+    (0x111F5, 'X'),
+    (0x11200, 'V'),
+    (0x11212, 'X'),
+    (0x11213, 'V'),
+    (0x1123F, 'X'),
+    (0x11280, 'V'),
+    (0x11287, 'X'),
+    (0x11288, 'V'),
+    (0x11289, 'X'),
+    (0x1128A, 'V'),
+    (0x1128E, 'X'),
+    (0x1128F, 'V'),
+    (0x1129E, 'X'),
+    (0x1129F, 'V'),
+    (0x112AA, 'X'),
+    (0x112B0, 'V'),
+    (0x112EB, 'X'),
+    (0x112F0, 'V'),
+    (0x112FA, 'X'),
+    (0x11300, 'V'),
+    (0x11304, 'X'),
+    (0x11305, 'V'),
+    (0x1130D, 'X'),
+    (0x1130F, 'V'),
+    (0x11311, 'X'),
+    (0x11313, 'V'),
+    (0x11329, 'X'),
+    (0x1132A, 'V'),
+    (0x11331, 'X'),
+    (0x11332, 'V'),
+    (0x11334, 'X'),
+    (0x11335, 'V'),
+    (0x1133A, 'X'),
+    (0x1133B, 'V'),
+    (0x11345, 'X'),
+    (0x11347, 'V'),
+    (0x11349, 'X'),
+    (0x1134B, 'V'),
+    (0x1134E, 'X'),
+    (0x11350, 'V'),
+    (0x11351, 'X'),
+    (0x11357, 'V'),
+    (0x11358, 'X'),
+    (0x1135D, 'V'),
+    (0x11364, 'X'),
+    (0x11366, 'V'),
+    (0x1136D, 'X'),
+    (0x11370, 'V'),
+    (0x11375, 'X'),
+    (0x11400, 'V'),
+    (0x1145A, 'X'),
+    (0x1145B, 'V'),
+    (0x1145C, 'X'),
+    (0x1145D, 'V'),
+    ]
+
+def _seg_56():
+    return [
+    (0x1145F, 'X'),
+    (0x11480, 'V'),
+    (0x114C8, 'X'),
+    (0x114D0, 'V'),
+    (0x114DA, 'X'),
+    (0x11580, 'V'),
+    (0x115B6, 'X'),
+    (0x115B8, 'V'),
+    (0x115DE, 'X'),
+    (0x11600, 'V'),
+    (0x11645, 'X'),
+    (0x11650, 'V'),
+    (0x1165A, 'X'),
+    (0x11660, 'V'),
+    (0x1166D, 'X'),
+    (0x11680, 'V'),
+    (0x116B8, 'X'),
+    (0x116C0, 'V'),
+    (0x116CA, 'X'),
+    (0x11700, 'V'),
+    (0x1171B, 'X'),
+    (0x1171D, 'V'),
+    (0x1172C, 'X'),
+    (0x11730, 'V'),
+    (0x11740, 'X'),
+    (0x11800, 'V'),
+    (0x1183C, 'X'),
+    (0x118A0, 'M', u'𑣀'),
+    (0x118A1, 'M', u'𑣁'),
+    (0x118A2, 'M', u'𑣂'),
+    (0x118A3, 'M', u'𑣃'),
+    (0x118A4, 'M', u'𑣄'),
+    (0x118A5, 'M', u'𑣅'),
+    (0x118A6, 'M', u'𑣆'),
+    (0x118A7, 'M', u'𑣇'),
+    (0x118A8, 'M', u'𑣈'),
+    (0x118A9, 'M', u'𑣉'),
+    (0x118AA, 'M', u'𑣊'),
+    (0x118AB, 'M', u'𑣋'),
+    (0x118AC, 'M', u'𑣌'),
+    (0x118AD, 'M', u'𑣍'),
+    (0x118AE, 'M', u'𑣎'),
+    (0x118AF, 'M', u'𑣏'),
+    (0x118B0, 'M', u'𑣐'),
+    (0x118B1, 'M', u'𑣑'),
+    (0x118B2, 'M', u'𑣒'),
+    (0x118B3, 'M', u'𑣓'),
+    (0x118B4, 'M', u'𑣔'),
+    (0x118B5, 'M', u'𑣕'),
+    (0x118B6, 'M', u'𑣖'),
+    (0x118B7, 'M', u'𑣗'),
+    (0x118B8, 'M', u'𑣘'),
+    (0x118B9, 'M', u'𑣙'),
+    (0x118BA, 'M', u'𑣚'),
+    (0x118BB, 'M', u'𑣛'),
+    (0x118BC, 'M', u'𑣜'),
+    (0x118BD, 'M', u'𑣝'),
+    (0x118BE, 'M', u'𑣞'),
+    (0x118BF, 'M', u'𑣟'),
+    (0x118C0, 'V'),
+    (0x118F3, 'X'),
+    (0x118FF, 'V'),
+    (0x11900, 'X'),
+    (0x11A00, 'V'),
+    (0x11A48, 'X'),
+    (0x11A50, 'V'),
+    (0x11A84, 'X'),
+    (0x11A86, 'V'),
+    (0x11AA3, 'X'),
+    (0x11AC0, 'V'),
+    (0x11AF9, 'X'),
+    (0x11C00, 'V'),
+    (0x11C09, 'X'),
+    (0x11C0A, 'V'),
+    (0x11C37, 'X'),
+    (0x11C38, 'V'),
+    (0x11C46, 'X'),
+    (0x11C50, 'V'),
+    (0x11C6D, 'X'),
+    (0x11C70, 'V'),
+    (0x11C90, 'X'),
+    (0x11C92, 'V'),
+    (0x11CA8, 'X'),
+    (0x11CA9, 'V'),
+    (0x11CB7, 'X'),
+    (0x11D00, 'V'),
+    (0x11D07, 'X'),
+    (0x11D08, 'V'),
+    (0x11D0A, 'X'),
+    (0x11D0B, 'V'),
+    (0x11D37, 'X'),
+    (0x11D3A, 'V'),
+    (0x11D3B, 'X'),
+    (0x11D3C, 'V'),
+    (0x11D3E, 'X'),
+    (0x11D3F, 'V'),
+    (0x11D48, 'X'),
+    (0x11D50, 'V'),
+    (0x11D5A, 'X'),
+    (0x11D60, 'V'),
+    ]
+
+def _seg_57():
+    return [
+    (0x11D66, 'X'),
+    (0x11D67, 'V'),
+    (0x11D69, 'X'),
+    (0x11D6A, 'V'),
+    (0x11D8F, 'X'),
+    (0x11D90, 'V'),
+    (0x11D92, 'X'),
+    (0x11D93, 'V'),
+    (0x11D99, 'X'),
+    (0x11DA0, 'V'),
+    (0x11DAA, 'X'),
+    (0x11EE0, 'V'),
+    (0x11EF9, 'X'),
+    (0x12000, 'V'),
+    (0x1239A, 'X'),
+    (0x12400, 'V'),
+    (0x1246F, 'X'),
+    (0x12470, 'V'),
+    (0x12475, 'X'),
+    (0x12480, 'V'),
+    (0x12544, 'X'),
+    (0x13000, 'V'),
+    (0x1342F, 'X'),
+    (0x14400, 'V'),
+    (0x14647, 'X'),
+    (0x16800, 'V'),
+    (0x16A39, 'X'),
+    (0x16A40, 'V'),
+    (0x16A5F, 'X'),
+    (0x16A60, 'V'),
+    (0x16A6A, 'X'),
+    (0x16A6E, 'V'),
+    (0x16A70, 'X'),
+    (0x16AD0, 'V'),
+    (0x16AEE, 'X'),
+    (0x16AF0, 'V'),
+    (0x16AF6, 'X'),
+    (0x16B00, 'V'),
+    (0x16B46, 'X'),
+    (0x16B50, 'V'),
+    (0x16B5A, 'X'),
+    (0x16B5B, 'V'),
+    (0x16B62, 'X'),
+    (0x16B63, 'V'),
+    (0x16B78, 'X'),
+    (0x16B7D, 'V'),
+    (0x16B90, 'X'),
+    (0x16E60, 'V'),
+    (0x16E9B, 'X'),
+    (0x16F00, 'V'),
+    (0x16F45, 'X'),
+    (0x16F50, 'V'),
+    (0x16F7F, 'X'),
+    (0x16F8F, 'V'),
+    (0x16FA0, 'X'),
+    (0x16FE0, 'V'),
+    (0x16FE2, 'X'),
+    (0x17000, 'V'),
+    (0x187F2, 'X'),
+    (0x18800, 'V'),
+    (0x18AF3, 'X'),
+    (0x1B000, 'V'),
+    (0x1B11F, 'X'),
+    (0x1B170, 'V'),
+    (0x1B2FC, 'X'),
+    (0x1BC00, 'V'),
+    (0x1BC6B, 'X'),
+    (0x1BC70, 'V'),
+    (0x1BC7D, 'X'),
+    (0x1BC80, 'V'),
+    (0x1BC89, 'X'),
+    (0x1BC90, 'V'),
+    (0x1BC9A, 'X'),
+    (0x1BC9C, 'V'),
+    (0x1BCA0, 'I'),
+    (0x1BCA4, 'X'),
+    (0x1D000, 'V'),
+    (0x1D0F6, 'X'),
+    (0x1D100, 'V'),
+    (0x1D127, 'X'),
+    (0x1D129, 'V'),
+    (0x1D15E, 'M', u'𝅗𝅥'),
+    (0x1D15F, 'M', u'𝅘𝅥'),
+    (0x1D160, 'M', u'𝅘𝅥𝅮'),
+    (0x1D161, 'M', u'𝅘𝅥𝅯'),
+    (0x1D162, 'M', u'𝅘𝅥𝅰'),
+    (0x1D163, 'M', u'𝅘𝅥𝅱'),
+    (0x1D164, 'M', u'𝅘𝅥𝅲'),
+    (0x1D165, 'V'),
+    (0x1D173, 'X'),
+    (0x1D17B, 'V'),
+    (0x1D1BB, 'M', u'𝆹𝅥'),
+    (0x1D1BC, 'M', u'𝆺𝅥'),
+    (0x1D1BD, 'M', u'𝆹𝅥𝅮'),
+    (0x1D1BE, 'M', u'𝆺𝅥𝅮'),
+    (0x1D1BF, 'M', u'𝆹𝅥𝅯'),
+    (0x1D1C0, 'M', u'𝆺𝅥𝅯'),
+    (0x1D1C1, 'V'),
+    (0x1D1E9, 'X'),
+    (0x1D200, 'V'),
+    ]
+
+def _seg_58():
+    return [
+    (0x1D246, 'X'),
+    (0x1D2E0, 'V'),
+    (0x1D2F4, 'X'),
+    (0x1D300, 'V'),
+    (0x1D357, 'X'),
+    (0x1D360, 'V'),
+    (0x1D379, 'X'),
+    (0x1D400, 'M', u'a'),
+    (0x1D401, 'M', u'b'),
+    (0x1D402, 'M', u'c'),
+    (0x1D403, 'M', u'd'),
+    (0x1D404, 'M', u'e'),
+    (0x1D405, 'M', u'f'),
+    (0x1D406, 'M', u'g'),
+    (0x1D407, 'M', u'h'),
+    (0x1D408, 'M', u'i'),
+    (0x1D409, 'M', u'j'),
+    (0x1D40A, 'M', u'k'),
+    (0x1D40B, 'M', u'l'),
+    (0x1D40C, 'M', u'm'),
+    (0x1D40D, 'M', u'n'),
+    (0x1D40E, 'M', u'o'),
+    (0x1D40F, 'M', u'p'),
+    (0x1D410, 'M', u'q'),
+    (0x1D411, 'M', u'r'),
+    (0x1D412, 'M', u's'),
+    (0x1D413, 'M', u't'),
+    (0x1D414, 'M', u'u'),
+    (0x1D415, 'M', u'v'),
+    (0x1D416, 'M', u'w'),
+    (0x1D417, 'M', u'x'),
+    (0x1D418, 'M', u'y'),
+    (0x1D419, 'M', u'z'),
+    (0x1D41A, 'M', u'a'),
+    (0x1D41B, 'M', u'b'),
+    (0x1D41C, 'M', u'c'),
+    (0x1D41D, 'M', u'd'),
+    (0x1D41E, 'M', u'e'),
+    (0x1D41F, 'M', u'f'),
+    (0x1D420, 'M', u'g'),
+    (0x1D421, 'M', u'h'),
+    (0x1D422, 'M', u'i'),
+    (0x1D423, 'M', u'j'),
+    (0x1D424, 'M', u'k'),
+    (0x1D425, 'M', u'l'),
+    (0x1D426, 'M', u'm'),
+    (0x1D427, 'M', u'n'),
+    (0x1D428, 'M', u'o'),
+    (0x1D429, 'M', u'p'),
+    (0x1D42A, 'M', u'q'),
+    (0x1D42B, 'M', u'r'),
+    (0x1D42C, 'M', u's'),
+    (0x1D42D, 'M', u't'),
+    (0x1D42E, 'M', u'u'),
+    (0x1D42F, 'M', u'v'),
+    (0x1D430, 'M', u'w'),
+    (0x1D431, 'M', u'x'),
+    (0x1D432, 'M', u'y'),
+    (0x1D433, 'M', u'z'),
+    (0x1D434, 'M', u'a'),
+    (0x1D435, 'M', u'b'),
+    (0x1D436, 'M', u'c'),
+    (0x1D437, 'M', u'd'),
+    (0x1D438, 'M', u'e'),
+    (0x1D439, 'M', u'f'),
+    (0x1D43A, 'M', u'g'),
+    (0x1D43B, 'M', u'h'),
+    (0x1D43C, 'M', u'i'),
+    (0x1D43D, 'M', u'j'),
+    (0x1D43E, 'M', u'k'),
+    (0x1D43F, 'M', u'l'),
+    (0x1D440, 'M', u'm'),
+    (0x1D441, 'M', u'n'),
+    (0x1D442, 'M', u'o'),
+    (0x1D443, 'M', u'p'),
+    (0x1D444, 'M', u'q'),
+    (0x1D445, 'M', u'r'),
+    (0x1D446, 'M', u's'),
+    (0x1D447, 'M', u't'),
+    (0x1D448, 'M', u'u'),
+    (0x1D449, 'M', u'v'),
+    (0x1D44A, 'M', u'w'),
+    (0x1D44B, 'M', u'x'),
+    (0x1D44C, 'M', u'y'),
+    (0x1D44D, 'M', u'z'),
+    (0x1D44E, 'M', u'a'),
+    (0x1D44F, 'M', u'b'),
+    (0x1D450, 'M', u'c'),
+    (0x1D451, 'M', u'd'),
+    (0x1D452, 'M', u'e'),
+    (0x1D453, 'M', u'f'),
+    (0x1D454, 'M', u'g'),
+    (0x1D455, 'X'),
+    (0x1D456, 'M', u'i'),
+    (0x1D457, 'M', u'j'),
+    (0x1D458, 'M', u'k'),
+    (0x1D459, 'M', u'l'),
+    (0x1D45A, 'M', u'm'),
+    (0x1D45B, 'M', u'n'),
+    (0x1D45C, 'M', u'o'),
+    ]
+
+def _seg_59():
+    return [
+    (0x1D45D, 'M', u'p'),
+    (0x1D45E, 'M', u'q'),
+    (0x1D45F, 'M', u'r'),
+    (0x1D460, 'M', u's'),
+    (0x1D461, 'M', u't'),
+    (0x1D462, 'M', u'u'),
+    (0x1D463, 'M', u'v'),
+    (0x1D464, 'M', u'w'),
+    (0x1D465, 'M', u'x'),
+    (0x1D466, 'M', u'y'),
+    (0x1D467, 'M', u'z'),
+    (0x1D468, 'M', u'a'),
+    (0x1D469, 'M', u'b'),
+    (0x1D46A, 'M', u'c'),
+    (0x1D46B, 'M', u'd'),
+    (0x1D46C, 'M', u'e'),
+    (0x1D46D, 'M', u'f'),
+    (0x1D46E, 'M', u'g'),
+    (0x1D46F, 'M', u'h'),
+    (0x1D470, 'M', u'i'),
+    (0x1D471, 'M', u'j'),
+    (0x1D472, 'M', u'k'),
+    (0x1D473, 'M', u'l'),
+    (0x1D474, 'M', u'm'),
+    (0x1D475, 'M', u'n'),
+    (0x1D476, 'M', u'o'),
+    (0x1D477, 'M', u'p'),
+    (0x1D478, 'M', u'q'),
+    (0x1D479, 'M', u'r'),
+    (0x1D47A, 'M', u's'),
+    (0x1D47B, 'M', u't'),
+    (0x1D47C, 'M', u'u'),
+    (0x1D47D, 'M', u'v'),
+    (0x1D47E, 'M', u'w'),
+    (0x1D47F, 'M', u'x'),
+    (0x1D480, 'M', u'y'),
+    (0x1D481, 'M', u'z'),
+    (0x1D482, 'M', u'a'),
+    (0x1D483, 'M', u'b'),
+    (0x1D484, 'M', u'c'),
+    (0x1D485, 'M', u'd'),
+    (0x1D486, 'M', u'e'),
+    (0x1D487, 'M', u'f'),
+    (0x1D488, 'M', u'g'),
+    (0x1D489, 'M', u'h'),
+    (0x1D48A, 'M', u'i'),
+    (0x1D48B, 'M', u'j'),
+    (0x1D48C, 'M', u'k'),
+    (0x1D48D, 'M', u'l'),
+    (0x1D48E, 'M', u'm'),
+    (0x1D48F, 'M', u'n'),
+    (0x1D490, 'M', u'o'),
+    (0x1D491, 'M', u'p'),
+    (0x1D492, 'M', u'q'),
+    (0x1D493, 'M', u'r'),
+    (0x1D494, 'M', u's'),
+    (0x1D495, 'M', u't'),
+    (0x1D496, 'M', u'u'),
+    (0x1D497, 'M', u'v'),
+    (0x1D498, 'M', u'w'),
+    (0x1D499, 'M', u'x'),
+    (0x1D49A, 'M', u'y'),
+    (0x1D49B, 'M', u'z'),
+    (0x1D49C, 'M', u'a'),
+    (0x1D49D, 'X'),
+    (0x1D49E, 'M', u'c'),
+    (0x1D49F, 'M', u'd'),
+    (0x1D4A0, 'X'),
+    (0x1D4A2, 'M', u'g'),
+    (0x1D4A3, 'X'),
+    (0x1D4A5, 'M', u'j'),
+    (0x1D4A6, 'M', u'k'),
+    (0x1D4A7, 'X'),
+    (0x1D4A9, 'M', u'n'),
+    (0x1D4AA, 'M', u'o'),
+    (0x1D4AB, 'M', u'p'),
+    (0x1D4AC, 'M', u'q'),
+    (0x1D4AD, 'X'),
+    (0x1D4AE, 'M', u's'),
+    (0x1D4AF, 'M', u't'),
+    (0x1D4B0, 'M', u'u'),
+    (0x1D4B1, 'M', u'v'),
+    (0x1D4B2, 'M', u'w'),
+    (0x1D4B3, 'M', u'x'),
+    (0x1D4B4, 'M', u'y'),
+    (0x1D4B5, 'M', u'z'),
+    (0x1D4B6, 'M', u'a'),
+    (0x1D4B7, 'M', u'b'),
+    (0x1D4B8, 'M', u'c'),
+    (0x1D4B9, 'M', u'd'),
+    (0x1D4BA, 'X'),
+    (0x1D4BB, 'M', u'f'),
+    (0x1D4BC, 'X'),
+    (0x1D4BD, 'M', u'h'),
+    (0x1D4BE, 'M', u'i'),
+    (0x1D4BF, 'M', u'j'),
+    (0x1D4C0, 'M', u'k'),
+    (0x1D4C1, 'M', u'l'),
+    (0x1D4C2, 'M', u'm'),
+    (0x1D4C3, 'M', u'n'),
+    ]
+
+def _seg_60():
+    return [
+    (0x1D4C4, 'X'),
+    (0x1D4C5, 'M', u'p'),
+    (0x1D4C6, 'M', u'q'),
+    (0x1D4C7, 'M', u'r'),
+    (0x1D4C8, 'M', u's'),
+    (0x1D4C9, 'M', u't'),
+    (0x1D4CA, 'M', u'u'),
+    (0x1D4CB, 'M', u'v'),
+    (0x1D4CC, 'M', u'w'),
+    (0x1D4CD, 'M', u'x'),
+    (0x1D4CE, 'M', u'y'),
+    (0x1D4CF, 'M', u'z'),
+    (0x1D4D0, 'M', u'a'),
+    (0x1D4D1, 'M', u'b'),
+    (0x1D4D2, 'M', u'c'),
+    (0x1D4D3, 'M', u'd'),
+    (0x1D4D4, 'M', u'e'),
+    (0x1D4D5, 'M', u'f'),
+    (0x1D4D6, 'M', u'g'),
+    (0x1D4D7, 'M', u'h'),
+    (0x1D4D8, 'M', u'i'),
+    (0x1D4D9, 'M', u'j'),
+    (0x1D4DA, 'M', u'k'),
+    (0x1D4DB, 'M', u'l'),
+    (0x1D4DC, 'M', u'm'),
+    (0x1D4DD, 'M', u'n'),
+    (0x1D4DE, 'M', u'o'),
+    (0x1D4DF, 'M', u'p'),
+    (0x1D4E0, 'M', u'q'),
+    (0x1D4E1, 'M', u'r'),
+    (0x1D4E2, 'M', u's'),
+    (0x1D4E3, 'M', u't'),
+    (0x1D4E4, 'M', u'u'),
+    (0x1D4E5, 'M', u'v'),
+    (0x1D4E6, 'M', u'w'),
+    (0x1D4E7, 'M', u'x'),
+    (0x1D4E8, 'M', u'y'),
+    (0x1D4E9, 'M', u'z'),
+    (0x1D4EA, 'M', u'a'),
+    (0x1D4EB, 'M', u'b'),
+    (0x1D4EC, 'M', u'c'),
+    (0x1D4ED, 'M', u'd'),
+    (0x1D4EE, 'M', u'e'),
+    (0x1D4EF, 'M', u'f'),
+    (0x1D4F0, 'M', u'g'),
+    (0x1D4F1, 'M', u'h'),
+    (0x1D4F2, 'M', u'i'),
+    (0x1D4F3, 'M', u'j'),
+    (0x1D4F4, 'M', u'k'),
+    (0x1D4F5, 'M', u'l'),
+    (0x1D4F6, 'M', u'm'),
+    (0x1D4F7, 'M', u'n'),
+    (0x1D4F8, 'M', u'o'),
+    (0x1D4F9, 'M', u'p'),
+    (0x1D4FA, 'M', u'q'),
+    (0x1D4FB, 'M', u'r'),
+    (0x1D4FC, 'M', u's'),
+    (0x1D4FD, 'M', u't'),
+    (0x1D4FE, 'M', u'u'),
+    (0x1D4FF, 'M', u'v'),
+    (0x1D500, 'M', u'w'),
+    (0x1D501, 'M', u'x'),
+    (0x1D502, 'M', u'y'),
+    (0x1D503, 'M', u'z'),
+    (0x1D504, 'M', u'a'),
+    (0x1D505, 'M', u'b'),
+    (0x1D506, 'X'),
+    (0x1D507, 'M', u'd'),
+    (0x1D508, 'M', u'e'),
+    (0x1D509, 'M', u'f'),
+    (0x1D50A, 'M', u'g'),
+    (0x1D50B, 'X'),
+    (0x1D50D, 'M', u'j'),
+    (0x1D50E, 'M', u'k'),
+    (0x1D50F, 'M', u'l'),
+    (0x1D510, 'M', u'm'),
+    (0x1D511, 'M', u'n'),
+    (0x1D512, 'M', u'o'),
+    (0x1D513, 'M', u'p'),
+    (0x1D514, 'M', u'q'),
+    (0x1D515, 'X'),
+    (0x1D516, 'M', u's'),
+    (0x1D517, 'M', u't'),
+    (0x1D518, 'M', u'u'),
+    (0x1D519, 'M', u'v'),
+    (0x1D51A, 'M', u'w'),
+    (0x1D51B, 'M', u'x'),
+    (0x1D51C, 'M', u'y'),
+    (0x1D51D, 'X'),
+    (0x1D51E, 'M', u'a'),
+    (0x1D51F, 'M', u'b'),
+    (0x1D520, 'M', u'c'),
+    (0x1D521, 'M', u'd'),
+    (0x1D522, 'M', u'e'),
+    (0x1D523, 'M', u'f'),
+    (0x1D524, 'M', u'g'),
+    (0x1D525, 'M', u'h'),
+    (0x1D526, 'M', u'i'),
+    (0x1D527, 'M', u'j'),
+    (0x1D528, 'M', u'k'),
+    ]
+
+def _seg_61():
+    return [
+    (0x1D529, 'M', u'l'),
+    (0x1D52A, 'M', u'm'),
+    (0x1D52B, 'M', u'n'),
+    (0x1D52C, 'M', u'o'),
+    (0x1D52D, 'M', u'p'),
+    (0x1D52E, 'M', u'q'),
+    (0x1D52F, 'M', u'r'),
+    (0x1D530, 'M', u's'),
+    (0x1D531, 'M', u't'),
+    (0x1D532, 'M', u'u'),
+    (0x1D533, 'M', u'v'),
+    (0x1D534, 'M', u'w'),
+    (0x1D535, 'M', u'x'),
+    (0x1D536, 'M', u'y'),
+    (0x1D537, 'M', u'z'),
+    (0x1D538, 'M', u'a'),
+    (0x1D539, 'M', u'b'),
+    (0x1D53A, 'X'),
+    (0x1D53B, 'M', u'd'),
+    (0x1D53C, 'M', u'e'),
+    (0x1D53D, 'M', u'f'),
+    (0x1D53E, 'M', u'g'),
+    (0x1D53F, 'X'),
+    (0x1D540, 'M', u'i'),
+    (0x1D541, 'M', u'j'),
+    (0x1D542, 'M', u'k'),
+    (0x1D543, 'M', u'l'),
+    (0x1D544, 'M', u'm'),
+    (0x1D545, 'X'),
+    (0x1D546, 'M', u'o'),
+    (0x1D547, 'X'),
+    (0x1D54A, 'M', u's'),
+    (0x1D54B, 'M', u't'),
+    (0x1D54C, 'M', u'u'),
+    (0x1D54D, 'M', u'v'),
+    (0x1D54E, 'M', u'w'),
+    (0x1D54F, 'M', u'x'),
+    (0x1D550, 'M', u'y'),
+    (0x1D551, 'X'),
+    (0x1D552, 'M', u'a'),
+    (0x1D553, 'M', u'b'),
+    (0x1D554, 'M', u'c'),
+    (0x1D555, 'M', u'd'),
+    (0x1D556, 'M', u'e'),
+    (0x1D557, 'M', u'f'),
+    (0x1D558, 'M', u'g'),
+    (0x1D559, 'M', u'h'),
+    (0x1D55A, 'M', u'i'),
+    (0x1D55B, 'M', u'j'),
+    (0x1D55C, 'M', u'k'),
+    (0x1D55D, 'M', u'l'),
+    (0x1D55E, 'M', u'm'),
+    (0x1D55F, 'M', u'n'),
+    (0x1D560, 'M', u'o'),
+    (0x1D561, 'M', u'p'),
+    (0x1D562, 'M', u'q'),
+    (0x1D563, 'M', u'r'),
+    (0x1D564, 'M', u's'),
+    (0x1D565, 'M', u't'),
+    (0x1D566, 'M', u'u'),
+    (0x1D567, 'M', u'v'),
+    (0x1D568, 'M', u'w'),
+    (0x1D569, 'M', u'x'),
+    (0x1D56A, 'M', u'y'),
+    (0x1D56B, 'M', u'z'),
+    (0x1D56C, 'M', u'a'),
+    (0x1D56D, 'M', u'b'),
+    (0x1D56E, 'M', u'c'),
+    (0x1D56F, 'M', u'd'),
+    (0x1D570, 'M', u'e'),
+    (0x1D571, 'M', u'f'),
+    (0x1D572, 'M', u'g'),
+    (0x1D573, 'M', u'h'),
+    (0x1D574, 'M', u'i'),
+    (0x1D575, 'M', u'j'),
+    (0x1D576, 'M', u'k'),
+    (0x1D577, 'M', u'l'),
+    (0x1D578, 'M', u'm'),
+    (0x1D579, 'M', u'n'),
+    (0x1D57A, 'M', u'o'),
+    (0x1D57B, 'M', u'p'),
+    (0x1D57C, 'M', u'q'),
+    (0x1D57D, 'M', u'r'),
+    (0x1D57E, 'M', u's'),
+    (0x1D57F, 'M', u't'),
+    (0x1D580, 'M', u'u'),
+    (0x1D581, 'M', u'v'),
+    (0x1D582, 'M', u'w'),
+    (0x1D583, 'M', u'x'),
+    (0x1D584, 'M', u'y'),
+    (0x1D585, 'M', u'z'),
+    (0x1D586, 'M', u'a'),
+    (0x1D587, 'M', u'b'),
+    (0x1D588, 'M', u'c'),
+    (0x1D589, 'M', u'd'),
+    (0x1D58A, 'M', u'e'),
+    (0x1D58B, 'M', u'f'),
+    (0x1D58C, 'M', u'g'),
+    (0x1D58D, 'M', u'h'),
+    (0x1D58E, 'M', u'i'),
+    ]
+
+def _seg_62():
+    return [
+    (0x1D58F, 'M', u'j'),
+    (0x1D590, 'M', u'k'),
+    (0x1D591, 'M', u'l'),
+    (0x1D592, 'M', u'm'),
+    (0x1D593, 'M', u'n'),
+    (0x1D594, 'M', u'o'),
+    (0x1D595, 'M', u'p'),
+    (0x1D596, 'M', u'q'),
+    (0x1D597, 'M', u'r'),
+    (0x1D598, 'M', u's'),
+    (0x1D599, 'M', u't'),
+    (0x1D59A, 'M', u'u'),
+    (0x1D59B, 'M', u'v'),
+    (0x1D59C, 'M', u'w'),
+    (0x1D59D, 'M', u'x'),
+    (0x1D59E, 'M', u'y'),
+    (0x1D59F, 'M', u'z'),
+    (0x1D5A0, 'M', u'a'),
+    (0x1D5A1, 'M', u'b'),
+    (0x1D5A2, 'M', u'c'),
+    (0x1D5A3, 'M', u'd'),
+    (0x1D5A4, 'M', u'e'),
+    (0x1D5A5, 'M', u'f'),
+    (0x1D5A6, 'M', u'g'),
+    (0x1D5A7, 'M', u'h'),
+    (0x1D5A8, 'M', u'i'),
+    (0x1D5A9, 'M', u'j'),
+    (0x1D5AA, 'M', u'k'),
+    (0x1D5AB, 'M', u'l'),
+    (0x1D5AC, 'M', u'm'),
+    (0x1D5AD, 'M', u'n'),
+    (0x1D5AE, 'M', u'o'),
+    (0x1D5AF, 'M', u'p'),
+    (0x1D5B0, 'M', u'q'),
+    (0x1D5B1, 'M', u'r'),
+    (0x1D5B2, 'M', u's'),
+    (0x1D5B3, 'M', u't'),
+    (0x1D5B4, 'M', u'u'),
+    (0x1D5B5, 'M', u'v'),
+    (0x1D5B6, 'M', u'w'),
+    (0x1D5B7, 'M', u'x'),
+    (0x1D5B8, 'M', u'y'),
+    (0x1D5B9, 'M', u'z'),
+    (0x1D5BA, 'M', u'a'),
+    (0x1D5BB, 'M', u'b'),
+    (0x1D5BC, 'M', u'c'),
+    (0x1D5BD, 'M', u'd'),
+    (0x1D5BE, 'M', u'e'),
+    (0x1D5BF, 'M', u'f'),
+    (0x1D5C0, 'M', u'g'),
+    (0x1D5C1, 'M', u'h'),
+    (0x1D5C2, 'M', u'i'),
+    (0x1D5C3, 'M', u'j'),
+    (0x1D5C4, 'M', u'k'),
+    (0x1D5C5, 'M', u'l'),
+    (0x1D5C6, 'M', u'm'),
+    (0x1D5C7, 'M', u'n'),
+    (0x1D5C8, 'M', u'o'),
+    (0x1D5C9, 'M', u'p'),
+    (0x1D5CA, 'M', u'q'),
+    (0x1D5CB, 'M', u'r'),
+    (0x1D5CC, 'M', u's'),
+    (0x1D5CD, 'M', u't'),
+    (0x1D5CE, 'M', u'u'),
+    (0x1D5CF, 'M', u'v'),
+    (0x1D5D0, 'M', u'w'),
+    (0x1D5D1, 'M', u'x'),
+    (0x1D5D2, 'M', u'y'),
+    (0x1D5D3, 'M', u'z'),
+    (0x1D5D4, 'M', u'a'),
+    (0x1D5D5, 'M', u'b'),
+    (0x1D5D6, 'M', u'c'),
+    (0x1D5D7, 'M', u'd'),
+    (0x1D5D8, 'M', u'e'),
+    (0x1D5D9, 'M', u'f'),
+    (0x1D5DA, 'M', u'g'),
+    (0x1D5DB, 'M', u'h'),
+    (0x1D5DC, 'M', u'i'),
+    (0x1D5DD, 'M', u'j'),
+    (0x1D5DE, 'M', u'k'),
+    (0x1D5DF, 'M', u'l'),
+    (0x1D5E0, 'M', u'm'),
+    (0x1D5E1, 'M', u'n'),
+    (0x1D5E2, 'M', u'o'),
+    (0x1D5E3, 'M', u'p'),
+    (0x1D5E4, 'M', u'q'),
+    (0x1D5E5, 'M', u'r'),
+    (0x1D5E6, 'M', u's'),
+    (0x1D5E7, 'M', u't'),
+    (0x1D5E8, 'M', u'u'),
+    (0x1D5E9, 'M', u'v'),
+    (0x1D5EA, 'M', u'w'),
+    (0x1D5EB, 'M', u'x'),
+    (0x1D5EC, 'M', u'y'),
+    (0x1D5ED, 'M', u'z'),
+    (0x1D5EE, 'M', u'a'),
+    (0x1D5EF, 'M', u'b'),
+    (0x1D5F0, 'M', u'c'),
+    (0x1D5F1, 'M', u'd'),
+    (0x1D5F2, 'M', u'e'),
+    ]
+
+def _seg_63():
+    return [
+    (0x1D5F3, 'M', u'f'),
+    (0x1D5F4, 'M', u'g'),
+    (0x1D5F5, 'M', u'h'),
+    (0x1D5F6, 'M', u'i'),
+    (0x1D5F7, 'M', u'j'),
+    (0x1D5F8, 'M', u'k'),
+    (0x1D5F9, 'M', u'l'),
+    (0x1D5FA, 'M', u'm'),
+    (0x1D5FB, 'M', u'n'),
+    (0x1D5FC, 'M', u'o'),
+    (0x1D5FD, 'M', u'p'),
+    (0x1D5FE, 'M', u'q'),
+    (0x1D5FF, 'M', u'r'),
+    (0x1D600, 'M', u's'),
+    (0x1D601, 'M', u't'),
+    (0x1D602, 'M', u'u'),
+    (0x1D603, 'M', u'v'),
+    (0x1D604, 'M', u'w'),
+    (0x1D605, 'M', u'x'),
+    (0x1D606, 'M', u'y'),
+    (0x1D607, 'M', u'z'),
+    (0x1D608, 'M', u'a'),
+    (0x1D609, 'M', u'b'),
+    (0x1D60A, 'M', u'c'),
+    (0x1D60B, 'M', u'd'),
+    (0x1D60C, 'M', u'e'),
+    (0x1D60D, 'M', u'f'),
+    (0x1D60E, 'M', u'g'),
+    (0x1D60F, 'M', u'h'),
+    (0x1D610, 'M', u'i'),
+    (0x1D611, 'M', u'j'),
+    (0x1D612, 'M', u'k'),
+    (0x1D613, 'M', u'l'),
+    (0x1D614, 'M', u'm'),
+    (0x1D615, 'M', u'n'),
+    (0x1D616, 'M', u'o'),
+    (0x1D617, 'M', u'p'),
+    (0x1D618, 'M', u'q'),
+    (0x1D619, 'M', u'r'),
+    (0x1D61A, 'M', u's'),
+    (0x1D61B, 'M', u't'),
+    (0x1D61C, 'M', u'u'),
+    (0x1D61D, 'M', u'v'),
+    (0x1D61E, 'M', u'w'),
+    (0x1D61F, 'M', u'x'),
+    (0x1D620, 'M', u'y'),
+    (0x1D621, 'M', u'z'),
+    (0x1D622, 'M', u'a'),
+    (0x1D623, 'M', u'b'),
+    (0x1D624, 'M', u'c'),
+    (0x1D625, 'M', u'd'),
+    (0x1D626, 'M', u'e'),
+    (0x1D627, 'M', u'f'),
+    (0x1D628, 'M', u'g'),
+    (0x1D629, 'M', u'h'),
+    (0x1D62A, 'M', u'i'),
+    (0x1D62B, 'M', u'j'),
+    (0x1D62C, 'M', u'k'),
+    (0x1D62D, 'M', u'l'),
+    (0x1D62E, 'M', u'm'),
+    (0x1D62F, 'M', u'n'),
+    (0x1D630, 'M', u'o'),
+    (0x1D631, 'M', u'p'),
+    (0x1D632, 'M', u'q'),
+    (0x1D633, 'M', u'r'),
+    (0x1D634, 'M', u's'),
+    (0x1D635, 'M', u't'),
+    (0x1D636, 'M', u'u'),
+    (0x1D637, 'M', u'v'),
+    (0x1D638, 'M', u'w'),
+    (0x1D639, 'M', u'x'),
+    (0x1D63A, 'M', u'y'),
+    (0x1D63B, 'M', u'z'),
+    (0x1D63C, 'M', u'a'),
+    (0x1D63D, 'M', u'b'),
+    (0x1D63E, 'M', u'c'),
+    (0x1D63F, 'M', u'd'),
+    (0x1D640, 'M', u'e'),
+    (0x1D641, 'M', u'f'),
+    (0x1D642, 'M', u'g'),
+    (0x1D643, 'M', u'h'),
+    (0x1D644, 'M', u'i'),
+    (0x1D645, 'M', u'j'),
+    (0x1D646, 'M', u'k'),
+    (0x1D647, 'M', u'l'),
+    (0x1D648, 'M', u'm'),
+    (0x1D649, 'M', u'n'),
+    (0x1D64A, 'M', u'o'),
+    (0x1D64B, 'M', u'p'),
+    (0x1D64C, 'M', u'q'),
+    (0x1D64D, 'M', u'r'),
+    (0x1D64E, 'M', u's'),
+    (0x1D64F, 'M', u't'),
+    (0x1D650, 'M', u'u'),
+    (0x1D651, 'M', u'v'),
+    (0x1D652, 'M', u'w'),
+    (0x1D653, 'M', u'x'),
+    (0x1D654, 'M', u'y'),
+    (0x1D655, 'M', u'z'),
+    (0x1D656, 'M', u'a'),
+    ]
+
+def _seg_64():
+    return [
+    (0x1D657, 'M', u'b'),
+    (0x1D658, 'M', u'c'),
+    (0x1D659, 'M', u'd'),
+    (0x1D65A, 'M', u'e'),
+    (0x1D65B, 'M', u'f'),
+    (0x1D65C, 'M', u'g'),
+    (0x1D65D, 'M', u'h'),
+    (0x1D65E, 'M', u'i'),
+    (0x1D65F, 'M', u'j'),
+    (0x1D660, 'M', u'k'),
+    (0x1D661, 'M', u'l'),
+    (0x1D662, 'M', u'm'),
+    (0x1D663, 'M', u'n'),
+    (0x1D664, 'M', u'o'),
+    (0x1D665, 'M', u'p'),
+    (0x1D666, 'M', u'q'),
+    (0x1D667, 'M', u'r'),
+    (0x1D668, 'M', u's'),
+    (0x1D669, 'M', u't'),
+    (0x1D66A, 'M', u'u'),
+    (0x1D66B, 'M', u'v'),
+    (0x1D66C, 'M', u'w'),
+    (0x1D66D, 'M', u'x'),
+    (0x1D66E, 'M', u'y'),
+    (0x1D66F, 'M', u'z'),
+    (0x1D670, 'M', u'a'),
+    (0x1D671, 'M', u'b'),
+    (0x1D672, 'M', u'c'),
+    (0x1D673, 'M', u'd'),
+    (0x1D674, 'M', u'e'),
+    (0x1D675, 'M', u'f'),
+    (0x1D676, 'M', u'g'),
+    (0x1D677, 'M', u'h'),
+    (0x1D678, 'M', u'i'),
+    (0x1D679, 'M', u'j'),
+    (0x1D67A, 'M', u'k'),
+    (0x1D67B, 'M', u'l'),
+    (0x1D67C, 'M', u'm'),
+    (0x1D67D, 'M', u'n'),
+    (0x1D67E, 'M', u'o'),
+    (0x1D67F, 'M', u'p'),
+    (0x1D680, 'M', u'q'),
+    (0x1D681, 'M', u'r'),
+    (0x1D682, 'M', u's'),
+    (0x1D683, 'M', u't'),
+    (0x1D684, 'M', u'u'),
+    (0x1D685, 'M', u'v'),
+    (0x1D686, 'M', u'w'),
+    (0x1D687, 'M', u'x'),
+    (0x1D688, 'M', u'y'),
+    (0x1D689, 'M', u'z'),
+    (0x1D68A, 'M', u'a'),
+    (0x1D68B, 'M', u'b'),
+    (0x1D68C, 'M', u'c'),
+    (0x1D68D, 'M', u'd'),
+    (0x1D68E, 'M', u'e'),
+    (0x1D68F, 'M', u'f'),
+    (0x1D690, 'M', u'g'),
+    (0x1D691, 'M', u'h'),
+    (0x1D692, 'M', u'i'),
+    (0x1D693, 'M', u'j'),
+    (0x1D694, 'M', u'k'),
+    (0x1D695, 'M', u'l'),
+    (0x1D696, 'M', u'm'),
+    (0x1D697, 'M', u'n'),
+    (0x1D698, 'M', u'o'),
+    (0x1D699, 'M', u'p'),
+    (0x1D69A, 'M', u'q'),
+    (0x1D69B, 'M', u'r'),
+    (0x1D69C, 'M', u's'),
+    (0x1D69D, 'M', u't'),
+    (0x1D69E, 'M', u'u'),
+    (0x1D69F, 'M', u'v'),
+    (0x1D6A0, 'M', u'w'),
+    (0x1D6A1, 'M', u'x'),
+    (0x1D6A2, 'M', u'y'),
+    (0x1D6A3, 'M', u'z'),
+    (0x1D6A4, 'M', u'ı'),
+    (0x1D6A5, 'M', u'ȷ'),
+    (0x1D6A6, 'X'),
+    (0x1D6A8, 'M', u'α'),
+    (0x1D6A9, 'M', u'β'),
+    (0x1D6AA, 'M', u'γ'),
+    (0x1D6AB, 'M', u'δ'),
+    (0x1D6AC, 'M', u'ε'),
+    (0x1D6AD, 'M', u'ζ'),
+    (0x1D6AE, 'M', u'η'),
+    (0x1D6AF, 'M', u'θ'),
+    (0x1D6B0, 'M', u'ι'),
+    (0x1D6B1, 'M', u'κ'),
+    (0x1D6B2, 'M', u'λ'),
+    (0x1D6B3, 'M', u'μ'),
+    (0x1D6B4, 'M', u'ν'),
+    (0x1D6B5, 'M', u'ξ'),
+    (0x1D6B6, 'M', u'ο'),
+    (0x1D6B7, 'M', u'π'),
+    (0x1D6B8, 'M', u'ρ'),
+    (0x1D6B9, 'M', u'θ'),
+    (0x1D6BA, 'M', u'σ'),
+    (0x1D6BB, 'M', u'τ'),
+    ]
+
+def _seg_65():
+    return [
+    (0x1D6BC, 'M', u'υ'),
+    (0x1D6BD, 'M', u'φ'),
+    (0x1D6BE, 'M', u'χ'),
+    (0x1D6BF, 'M', u'ψ'),
+    (0x1D6C0, 'M', u'ω'),
+    (0x1D6C1, 'M', u'∇'),
+    (0x1D6C2, 'M', u'α'),
+    (0x1D6C3, 'M', u'β'),
+    (0x1D6C4, 'M', u'γ'),
+    (0x1D6C5, 'M', u'δ'),
+    (0x1D6C6, 'M', u'ε'),
+    (0x1D6C7, 'M', u'ζ'),
+    (0x1D6C8, 'M', u'η'),
+    (0x1D6C9, 'M', u'θ'),
+    (0x1D6CA, 'M', u'ι'),
+    (0x1D6CB, 'M', u'κ'),
+    (0x1D6CC, 'M', u'λ'),
+    (0x1D6CD, 'M', u'μ'),
+    (0x1D6CE, 'M', u'ν'),
+    (0x1D6CF, 'M', u'ξ'),
+    (0x1D6D0, 'M', u'ο'),
+    (0x1D6D1, 'M', u'π'),
+    (0x1D6D2, 'M', u'ρ'),
+    (0x1D6D3, 'M', u'σ'),
+    (0x1D6D5, 'M', u'τ'),
+    (0x1D6D6, 'M', u'υ'),
+    (0x1D6D7, 'M', u'φ'),
+    (0x1D6D8, 'M', u'χ'),
+    (0x1D6D9, 'M', u'ψ'),
+    (0x1D6DA, 'M', u'ω'),
+    (0x1D6DB, 'M', u'∂'),
+    (0x1D6DC, 'M', u'ε'),
+    (0x1D6DD, 'M', u'θ'),
+    (0x1D6DE, 'M', u'κ'),
+    (0x1D6DF, 'M', u'φ'),
+    (0x1D6E0, 'M', u'ρ'),
+    (0x1D6E1, 'M', u'π'),
+    (0x1D6E2, 'M', u'α'),
+    (0x1D6E3, 'M', u'β'),
+    (0x1D6E4, 'M', u'γ'),
+    (0x1D6E5, 'M', u'δ'),
+    (0x1D6E6, 'M', u'ε'),
+    (0x1D6E7, 'M', u'ζ'),
+    (0x1D6E8, 'M', u'η'),
+    (0x1D6E9, 'M', u'θ'),
+    (0x1D6EA, 'M', u'ι'),
+    (0x1D6EB, 'M', u'κ'),
+    (0x1D6EC, 'M', u'λ'),
+    (0x1D6ED, 'M', u'μ'),
+    (0x1D6EE, 'M', u'ν'),
+    (0x1D6EF, 'M', u'ξ'),
+    (0x1D6F0, 'M', u'ο'),
+    (0x1D6F1, 'M', u'π'),
+    (0x1D6F2, 'M', u'ρ'),
+    (0x1D6F3, 'M', u'θ'),
+    (0x1D6F4, 'M', u'σ'),
+    (0x1D6F5, 'M', u'τ'),
+    (0x1D6F6, 'M', u'υ'),
+    (0x1D6F7, 'M', u'φ'),
+    (0x1D6F8, 'M', u'χ'),
+    (0x1D6F9, 'M', u'ψ'),
+    (0x1D6FA, 'M', u'ω'),
+    (0x1D6FB, 'M', u'∇'),
+    (0x1D6FC, 'M', u'α'),
+    (0x1D6FD, 'M', u'β'),
+    (0x1D6FE, 'M', u'γ'),
+    (0x1D6FF, 'M', u'δ'),
+    (0x1D700, 'M', u'ε'),
+    (0x1D701, 'M', u'ζ'),
+    (0x1D702, 'M', u'η'),
+    (0x1D703, 'M', u'θ'),
+    (0x1D704, 'M', u'ι'),
+    (0x1D705, 'M', u'κ'),
+    (0x1D706, 'M', u'λ'),
+    (0x1D707, 'M', u'μ'),
+    (0x1D708, 'M', u'ν'),
+    (0x1D709, 'M', u'ξ'),
+    (0x1D70A, 'M', u'ο'),
+    (0x1D70B, 'M', u'π'),
+    (0x1D70C, 'M', u'ρ'),
+    (0x1D70D, 'M', u'σ'),
+    (0x1D70F, 'M', u'τ'),
+    (0x1D710, 'M', u'υ'),
+    (0x1D711, 'M', u'φ'),
+    (0x1D712, 'M', u'χ'),
+    (0x1D713, 'M', u'ψ'),
+    (0x1D714, 'M', u'ω'),
+    (0x1D715, 'M', u'∂'),
+    (0x1D716, 'M', u'ε'),
+    (0x1D717, 'M', u'θ'),
+    (0x1D718, 'M', u'κ'),
+    (0x1D719, 'M', u'φ'),
+    (0x1D71A, 'M', u'ρ'),
+    (0x1D71B, 'M', u'π'),
+    (0x1D71C, 'M', u'α'),
+    (0x1D71D, 'M', u'β'),
+    (0x1D71E, 'M', u'γ'),
+    (0x1D71F, 'M', u'δ'),
+    (0x1D720, 'M', u'ε'),
+    (0x1D721, 'M', u'ζ'),
+    ]
+
+def _seg_66():
+    return [
+    (0x1D722, 'M', u'η'),
+    (0x1D723, 'M', u'θ'),
+    (0x1D724, 'M', u'ι'),
+    (0x1D725, 'M', u'κ'),
+    (0x1D726, 'M', u'λ'),
+    (0x1D727, 'M', u'μ'),
+    (0x1D728, 'M', u'ν'),
+    (0x1D729, 'M', u'ξ'),
+    (0x1D72A, 'M', u'ο'),
+    (0x1D72B, 'M', u'π'),
+    (0x1D72C, 'M', u'ρ'),
+    (0x1D72D, 'M', u'θ'),
+    (0x1D72E, 'M', u'σ'),
+    (0x1D72F, 'M', u'τ'),
+    (0x1D730, 'M', u'υ'),
+    (0x1D731, 'M', u'φ'),
+    (0x1D732, 'M', u'χ'),
+    (0x1D733, 'M', u'ψ'),
+    (0x1D734, 'M', u'ω'),
+    (0x1D735, 'M', u'∇'),
+    (0x1D736, 'M', u'α'),
+    (0x1D737, 'M', u'β'),
+    (0x1D738, 'M', u'γ'),
+    (0x1D739, 'M', u'δ'),
+    (0x1D73A, 'M', u'ε'),
+    (0x1D73B, 'M', u'ζ'),
+    (0x1D73C, 'M', u'η'),
+    (0x1D73D, 'M', u'θ'),
+    (0x1D73E, 'M', u'ι'),
+    (0x1D73F, 'M', u'κ'),
+    (0x1D740, 'M', u'λ'),
+    (0x1D741, 'M', u'μ'),
+    (0x1D742, 'M', u'ν'),
+    (0x1D743, 'M', u'ξ'),
+    (0x1D744, 'M', u'ο'),
+    (0x1D745, 'M', u'π'),
+    (0x1D746, 'M', u'ρ'),
+    (0x1D747, 'M', u'σ'),
+    (0x1D749, 'M', u'τ'),
+    (0x1D74A, 'M', u'υ'),
+    (0x1D74B, 'M', u'φ'),
+    (0x1D74C, 'M', u'χ'),
+    (0x1D74D, 'M', u'ψ'),
+    (0x1D74E, 'M', u'ω'),
+    (0x1D74F, 'M', u'∂'),
+    (0x1D750, 'M', u'ε'),
+    (0x1D751, 'M', u'θ'),
+    (0x1D752, 'M', u'κ'),
+    (0x1D753, 'M', u'φ'),
+    (0x1D754, 'M', u'ρ'),
+    (0x1D755, 'M', u'π'),
+    (0x1D756, 'M', u'α'),
+    (0x1D757, 'M', u'β'),
+    (0x1D758, 'M', u'γ'),
+    (0x1D759, 'M', u'δ'),
+    (0x1D75A, 'M', u'ε'),
+    (0x1D75B, 'M', u'ζ'),
+    (0x1D75C, 'M', u'η'),
+    (0x1D75D, 'M', u'θ'),
+    (0x1D75E, 'M', u'ι'),
+    (0x1D75F, 'M', u'κ'),
+    (0x1D760, 'M', u'λ'),
+    (0x1D761, 'M', u'μ'),
+    (0x1D762, 'M', u'ν'),
+    (0x1D763, 'M', u'ξ'),
+    (0x1D764, 'M', u'ο'),
+    (0x1D765, 'M', u'π'),
+    (0x1D766, 'M', u'ρ'),
+    (0x1D767, 'M', u'θ'),
+    (0x1D768, 'M', u'σ'),
+    (0x1D769, 'M', u'τ'),
+    (0x1D76A, 'M', u'υ'),
+    (0x1D76B, 'M', u'φ'),
+    (0x1D76C, 'M', u'χ'),
+    (0x1D76D, 'M', u'ψ'),
+    (0x1D76E, 'M', u'ω'),
+    (0x1D76F, 'M', u'∇'),
+    (0x1D770, 'M', u'α'),
+    (0x1D771, 'M', u'β'),
+    (0x1D772, 'M', u'γ'),
+    (0x1D773, 'M', u'δ'),
+    (0x1D774, 'M', u'ε'),
+    (0x1D775, 'M', u'ζ'),
+    (0x1D776, 'M', u'η'),
+    (0x1D777, 'M', u'θ'),
+    (0x1D778, 'M', u'ι'),
+    (0x1D779, 'M', u'κ'),
+    (0x1D77A, 'M', u'λ'),
+    (0x1D77B, 'M', u'μ'),
+    (0x1D77C, 'M', u'ν'),
+    (0x1D77D, 'M', u'ξ'),
+    (0x1D77E, 'M', u'ο'),
+    (0x1D77F, 'M', u'π'),
+    (0x1D780, 'M', u'ρ'),
+    (0x1D781, 'M', u'σ'),
+    (0x1D783, 'M', u'τ'),
+    (0x1D784, 'M', u'υ'),
+    (0x1D785, 'M', u'φ'),
+    (0x1D786, 'M', u'χ'),
+    (0x1D787, 'M', u'ψ'),
+    ]
+
+def _seg_67():
+    return [
+    (0x1D788, 'M', u'ω'),
+    (0x1D789, 'M', u'∂'),
+    (0x1D78A, 'M', u'ε'),
+    (0x1D78B, 'M', u'θ'),
+    (0x1D78C, 'M', u'κ'),
+    (0x1D78D, 'M', u'φ'),
+    (0x1D78E, 'M', u'ρ'),
+    (0x1D78F, 'M', u'π'),
+    (0x1D790, 'M', u'α'),
+    (0x1D791, 'M', u'β'),
+    (0x1D792, 'M', u'γ'),
+    (0x1D793, 'M', u'δ'),
+    (0x1D794, 'M', u'ε'),
+    (0x1D795, 'M', u'ζ'),
+    (0x1D796, 'M', u'η'),
+    (0x1D797, 'M', u'θ'),
+    (0x1D798, 'M', u'ι'),
+    (0x1D799, 'M', u'κ'),
+    (0x1D79A, 'M', u'λ'),
+    (0x1D79B, 'M', u'μ'),
+    (0x1D79C, 'M', u'ν'),
+    (0x1D79D, 'M', u'ξ'),
+    (0x1D79E, 'M', u'ο'),
+    (0x1D79F, 'M', u'π'),
+    (0x1D7A0, 'M', u'ρ'),
+    (0x1D7A1, 'M', u'θ'),
+    (0x1D7A2, 'M', u'σ'),
+    (0x1D7A3, 'M', u'τ'),
+    (0x1D7A4, 'M', u'υ'),
+    (0x1D7A5, 'M', u'φ'),
+    (0x1D7A6, 'M', u'χ'),
+    (0x1D7A7, 'M', u'ψ'),
+    (0x1D7A8, 'M', u'ω'),
+    (0x1D7A9, 'M', u'∇'),
+    (0x1D7AA, 'M', u'α'),
+    (0x1D7AB, 'M', u'β'),
+    (0x1D7AC, 'M', u'γ'),
+    (0x1D7AD, 'M', u'δ'),
+    (0x1D7AE, 'M', u'ε'),
+    (0x1D7AF, 'M', u'ζ'),
+    (0x1D7B0, 'M', u'η'),
+    (0x1D7B1, 'M', u'θ'),
+    (0x1D7B2, 'M', u'ι'),
+    (0x1D7B3, 'M', u'κ'),
+    (0x1D7B4, 'M', u'λ'),
+    (0x1D7B5, 'M', u'μ'),
+    (0x1D7B6, 'M', u'ν'),
+    (0x1D7B7, 'M', u'ξ'),
+    (0x1D7B8, 'M', u'ο'),
+    (0x1D7B9, 'M', u'π'),
+    (0x1D7BA, 'M', u'ρ'),
+    (0x1D7BB, 'M', u'σ'),
+    (0x1D7BD, 'M', u'τ'),
+    (0x1D7BE, 'M', u'υ'),
+    (0x1D7BF, 'M', u'φ'),
+    (0x1D7C0, 'M', u'χ'),
+    (0x1D7C1, 'M', u'ψ'),
+    (0x1D7C2, 'M', u'ω'),
+    (0x1D7C3, 'M', u'∂'),
+    (0x1D7C4, 'M', u'ε'),
+    (0x1D7C5, 'M', u'θ'),
+    (0x1D7C6, 'M', u'κ'),
+    (0x1D7C7, 'M', u'φ'),
+    (0x1D7C8, 'M', u'ρ'),
+    (0x1D7C9, 'M', u'π'),
+    (0x1D7CA, 'M', u'ϝ'),
+    (0x1D7CC, 'X'),
+    (0x1D7CE, 'M', u'0'),
+    (0x1D7CF, 'M', u'1'),
+    (0x1D7D0, 'M', u'2'),
+    (0x1D7D1, 'M', u'3'),
+    (0x1D7D2, 'M', u'4'),
+    (0x1D7D3, 'M', u'5'),
+    (0x1D7D4, 'M', u'6'),
+    (0x1D7D5, 'M', u'7'),
+    (0x1D7D6, 'M', u'8'),
+    (0x1D7D7, 'M', u'9'),
+    (0x1D7D8, 'M', u'0'),
+    (0x1D7D9, 'M', u'1'),
+    (0x1D7DA, 'M', u'2'),
+    (0x1D7DB, 'M', u'3'),
+    (0x1D7DC, 'M', u'4'),
+    (0x1D7DD, 'M', u'5'),
+    (0x1D7DE, 'M', u'6'),
+    (0x1D7DF, 'M', u'7'),
+    (0x1D7E0, 'M', u'8'),
+    (0x1D7E1, 'M', u'9'),
+    (0x1D7E2, 'M', u'0'),
+    (0x1D7E3, 'M', u'1'),
+    (0x1D7E4, 'M', u'2'),
+    (0x1D7E5, 'M', u'3'),
+    (0x1D7E6, 'M', u'4'),
+    (0x1D7E7, 'M', u'5'),
+    (0x1D7E8, 'M', u'6'),
+    (0x1D7E9, 'M', u'7'),
+    (0x1D7EA, 'M', u'8'),
+    (0x1D7EB, 'M', u'9'),
+    (0x1D7EC, 'M', u'0'),
+    (0x1D7ED, 'M', u'1'),
+    (0x1D7EE, 'M', u'2'),
+    ]
+
+def _seg_68():
+    return [
+    (0x1D7EF, 'M', u'3'),
+    (0x1D7F0, 'M', u'4'),
+    (0x1D7F1, 'M', u'5'),
+    (0x1D7F2, 'M', u'6'),
+    (0x1D7F3, 'M', u'7'),
+    (0x1D7F4, 'M', u'8'),
+    (0x1D7F5, 'M', u'9'),
+    (0x1D7F6, 'M', u'0'),
+    (0x1D7F7, 'M', u'1'),
+    (0x1D7F8, 'M', u'2'),
+    (0x1D7F9, 'M', u'3'),
+    (0x1D7FA, 'M', u'4'),
+    (0x1D7FB, 'M', u'5'),
+    (0x1D7FC, 'M', u'6'),
+    (0x1D7FD, 'M', u'7'),
+    (0x1D7FE, 'M', u'8'),
+    (0x1D7FF, 'M', u'9'),
+    (0x1D800, 'V'),
+    (0x1DA8C, 'X'),
+    (0x1DA9B, 'V'),
+    (0x1DAA0, 'X'),
+    (0x1DAA1, 'V'),
+    (0x1DAB0, 'X'),
+    (0x1E000, 'V'),
+    (0x1E007, 'X'),
+    (0x1E008, 'V'),
+    (0x1E019, 'X'),
+    (0x1E01B, 'V'),
+    (0x1E022, 'X'),
+    (0x1E023, 'V'),
+    (0x1E025, 'X'),
+    (0x1E026, 'V'),
+    (0x1E02B, 'X'),
+    (0x1E800, 'V'),
+    (0x1E8C5, 'X'),
+    (0x1E8C7, 'V'),
+    (0x1E8D7, 'X'),
+    (0x1E900, 'M', u'𞤢'),
+    (0x1E901, 'M', u'𞤣'),
+    (0x1E902, 'M', u'𞤤'),
+    (0x1E903, 'M', u'𞤥'),
+    (0x1E904, 'M', u'𞤦'),
+    (0x1E905, 'M', u'𞤧'),
+    (0x1E906, 'M', u'𞤨'),
+    (0x1E907, 'M', u'𞤩'),
+    (0x1E908, 'M', u'𞤪'),
+    (0x1E909, 'M', u'𞤫'),
+    (0x1E90A, 'M', u'𞤬'),
+    (0x1E90B, 'M', u'𞤭'),
+    (0x1E90C, 'M', u'𞤮'),
+    (0x1E90D, 'M', u'𞤯'),
+    (0x1E90E, 'M', u'𞤰'),
+    (0x1E90F, 'M', u'𞤱'),
+    (0x1E910, 'M', u'𞤲'),
+    (0x1E911, 'M', u'𞤳'),
+    (0x1E912, 'M', u'𞤴'),
+    (0x1E913, 'M', u'𞤵'),
+    (0x1E914, 'M', u'𞤶'),
+    (0x1E915, 'M', u'𞤷'),
+    (0x1E916, 'M', u'𞤸'),
+    (0x1E917, 'M', u'𞤹'),
+    (0x1E918, 'M', u'𞤺'),
+    (0x1E919, 'M', u'𞤻'),
+    (0x1E91A, 'M', u'𞤼'),
+    (0x1E91B, 'M', u'𞤽'),
+    (0x1E91C, 'M', u'𞤾'),
+    (0x1E91D, 'M', u'𞤿'),
+    (0x1E91E, 'M', u'𞥀'),
+    (0x1E91F, 'M', u'𞥁'),
+    (0x1E920, 'M', u'𞥂'),
+    (0x1E921, 'M', u'𞥃'),
+    (0x1E922, 'V'),
+    (0x1E94B, 'X'),
+    (0x1E950, 'V'),
+    (0x1E95A, 'X'),
+    (0x1E95E, 'V'),
+    (0x1E960, 'X'),
+    (0x1EC71, 'V'),
+    (0x1ECB5, 'X'),
+    (0x1EE00, 'M', u'ا'),
+    (0x1EE01, 'M', u'ب'),
+    (0x1EE02, 'M', u'ج'),
+    (0x1EE03, 'M', u'د'),
+    (0x1EE04, 'X'),
+    (0x1EE05, 'M', u'و'),
+    (0x1EE06, 'M', u'ز'),
+    (0x1EE07, 'M', u'ح'),
+    (0x1EE08, 'M', u'ط'),
+    (0x1EE09, 'M', u'ي'),
+    (0x1EE0A, 'M', u'ك'),
+    (0x1EE0B, 'M', u'ل'),
+    (0x1EE0C, 'M', u'م'),
+    (0x1EE0D, 'M', u'ن'),
+    (0x1EE0E, 'M', u'س'),
+    (0x1EE0F, 'M', u'ع'),
+    (0x1EE10, 'M', u'ف'),
+    (0x1EE11, 'M', u'ص'),
+    (0x1EE12, 'M', u'ق'),
+    (0x1EE13, 'M', u'ر'),
+    (0x1EE14, 'M', u'ش'),
+    ]
+
+def _seg_69():
+    return [
+    (0x1EE15, 'M', u'ت'),
+    (0x1EE16, 'M', u'ث'),
+    (0x1EE17, 'M', u'خ'),
+    (0x1EE18, 'M', u'ذ'),
+    (0x1EE19, 'M', u'ض'),
+    (0x1EE1A, 'M', u'ظ'),
+    (0x1EE1B, 'M', u'غ'),
+    (0x1EE1C, 'M', u'ٮ'),
+    (0x1EE1D, 'M', u'ں'),
+    (0x1EE1E, 'M', u'ڡ'),
+    (0x1EE1F, 'M', u'ٯ'),
+    (0x1EE20, 'X'),
+    (0x1EE21, 'M', u'ب'),
+    (0x1EE22, 'M', u'ج'),
+    (0x1EE23, 'X'),
+    (0x1EE24, 'M', u'ه'),
+    (0x1EE25, 'X'),
+    (0x1EE27, 'M', u'ح'),
+    (0x1EE28, 'X'),
+    (0x1EE29, 'M', u'ي'),
+    (0x1EE2A, 'M', u'ك'),
+    (0x1EE2B, 'M', u'ل'),
+    (0x1EE2C, 'M', u'م'),
+    (0x1EE2D, 'M', u'ن'),
+    (0x1EE2E, 'M', u'س'),
+    (0x1EE2F, 'M', u'ع'),
+    (0x1EE30, 'M', u'ف'),
+    (0x1EE31, 'M', u'ص'),
+    (0x1EE32, 'M', u'ق'),
+    (0x1EE33, 'X'),
+    (0x1EE34, 'M', u'ش'),
+    (0x1EE35, 'M', u'ت'),
+    (0x1EE36, 'M', u'ث'),
+    (0x1EE37, 'M', u'خ'),
+    (0x1EE38, 'X'),
+    (0x1EE39, 'M', u'ض'),
+    (0x1EE3A, 'X'),
+    (0x1EE3B, 'M', u'غ'),
+    (0x1EE3C, 'X'),
+    (0x1EE42, 'M', u'ج'),
+    (0x1EE43, 'X'),
+    (0x1EE47, 'M', u'ح'),
+    (0x1EE48, 'X'),
+    (0x1EE49, 'M', u'ي'),
+    (0x1EE4A, 'X'),
+    (0x1EE4B, 'M', u'ل'),
+    (0x1EE4C, 'X'),
+    (0x1EE4D, 'M', u'ن'),
+    (0x1EE4E, 'M', u'س'),
+    (0x1EE4F, 'M', u'ع'),
+    (0x1EE50, 'X'),
+    (0x1EE51, 'M', u'ص'),
+    (0x1EE52, 'M', u'ق'),
+    (0x1EE53, 'X'),
+    (0x1EE54, 'M', u'ش'),
+    (0x1EE55, 'X'),
+    (0x1EE57, 'M', u'خ'),
+    (0x1EE58, 'X'),
+    (0x1EE59, 'M', u'ض'),
+    (0x1EE5A, 'X'),
+    (0x1EE5B, 'M', u'غ'),
+    (0x1EE5C, 'X'),
+    (0x1EE5D, 'M', u'ں'),
+    (0x1EE5E, 'X'),
+    (0x1EE5F, 'M', u'ٯ'),
+    (0x1EE60, 'X'),
+    (0x1EE61, 'M', u'ب'),
+    (0x1EE62, 'M', u'ج'),
+    (0x1EE63, 'X'),
+    (0x1EE64, 'M', u'ه'),
+    (0x1EE65, 'X'),
+    (0x1EE67, 'M', u'ح'),
+    (0x1EE68, 'M', u'ط'),
+    (0x1EE69, 'M', u'ي'),
+    (0x1EE6A, 'M', u'ك'),
+    (0x1EE6B, 'X'),
+    (0x1EE6C, 'M', u'م'),
+    (0x1EE6D, 'M', u'ن'),
+    (0x1EE6E, 'M', u'س'),
+    (0x1EE6F, 'M', u'ع'),
+    (0x1EE70, 'M', u'ف'),
+    (0x1EE71, 'M', u'ص'),
+    (0x1EE72, 'M', u'ق'),
+    (0x1EE73, 'X'),
+    (0x1EE74, 'M', u'ش'),
+    (0x1EE75, 'M', u'ت'),
+    (0x1EE76, 'M', u'ث'),
+    (0x1EE77, 'M', u'خ'),
+    (0x1EE78, 'X'),
+    (0x1EE79, 'M', u'ض'),
+    (0x1EE7A, 'M', u'ظ'),
+    (0x1EE7B, 'M', u'غ'),
+    (0x1EE7C, 'M', u'ٮ'),
+    (0x1EE7D, 'X'),
+    (0x1EE7E, 'M', u'ڡ'),
+    (0x1EE7F, 'X'),
+    (0x1EE80, 'M', u'ا'),
+    (0x1EE81, 'M', u'ب'),
+    (0x1EE82, 'M', u'ج'),
+    (0x1EE83, 'M', u'د'),
+    ]
+
+def _seg_70():
+    return [
+    (0x1EE84, 'M', u'ه'),
+    (0x1EE85, 'M', u'و'),
+    (0x1EE86, 'M', u'ز'),
+    (0x1EE87, 'M', u'ح'),
+    (0x1EE88, 'M', u'ط'),
+    (0x1EE89, 'M', u'ي'),
+    (0x1EE8A, 'X'),
+    (0x1EE8B, 'M', u'ل'),
+    (0x1EE8C, 'M', u'م'),
+    (0x1EE8D, 'M', u'ن'),
+    (0x1EE8E, 'M', u'س'),
+    (0x1EE8F, 'M', u'ع'),
+    (0x1EE90, 'M', u'ف'),
+    (0x1EE91, 'M', u'ص'),
+    (0x1EE92, 'M', u'ق'),
+    (0x1EE93, 'M', u'ر'),
+    (0x1EE94, 'M', u'ش'),
+    (0x1EE95, 'M', u'ت'),
+    (0x1EE96, 'M', u'ث'),
+    (0x1EE97, 'M', u'خ'),
+    (0x1EE98, 'M', u'ذ'),
+    (0x1EE99, 'M', u'ض'),
+    (0x1EE9A, 'M', u'ظ'),
+    (0x1EE9B, 'M', u'غ'),
+    (0x1EE9C, 'X'),
+    (0x1EEA1, 'M', u'ب'),
+    (0x1EEA2, 'M', u'ج'),
+    (0x1EEA3, 'M', u'د'),
+    (0x1EEA4, 'X'),
+    (0x1EEA5, 'M', u'و'),
+    (0x1EEA6, 'M', u'ز'),
+    (0x1EEA7, 'M', u'ح'),
+    (0x1EEA8, 'M', u'ط'),
+    (0x1EEA9, 'M', u'ي'),
+    (0x1EEAA, 'X'),
+    (0x1EEAB, 'M', u'ل'),
+    (0x1EEAC, 'M', u'م'),
+    (0x1EEAD, 'M', u'ن'),
+    (0x1EEAE, 'M', u'س'),
+    (0x1EEAF, 'M', u'ع'),
+    (0x1EEB0, 'M', u'ف'),
+    (0x1EEB1, 'M', u'ص'),
+    (0x1EEB2, 'M', u'ق'),
+    (0x1EEB3, 'M', u'ر'),
+    (0x1EEB4, 'M', u'ش'),
+    (0x1EEB5, 'M', u'ت'),
+    (0x1EEB6, 'M', u'ث'),
+    (0x1EEB7, 'M', u'خ'),
+    (0x1EEB8, 'M', u'ذ'),
+    (0x1EEB9, 'M', u'ض'),
+    (0x1EEBA, 'M', u'ظ'),
+    (0x1EEBB, 'M', u'غ'),
+    (0x1EEBC, 'X'),
+    (0x1EEF0, 'V'),
+    (0x1EEF2, 'X'),
+    (0x1F000, 'V'),
+    (0x1F02C, 'X'),
+    (0x1F030, 'V'),
+    (0x1F094, 'X'),
+    (0x1F0A0, 'V'),
+    (0x1F0AF, 'X'),
+    (0x1F0B1, 'V'),
+    (0x1F0C0, 'X'),
+    (0x1F0C1, 'V'),
+    (0x1F0D0, 'X'),
+    (0x1F0D1, 'V'),
+    (0x1F0F6, 'X'),
+    (0x1F101, '3', u'0,'),
+    (0x1F102, '3', u'1,'),
+    (0x1F103, '3', u'2,'),
+    (0x1F104, '3', u'3,'),
+    (0x1F105, '3', u'4,'),
+    (0x1F106, '3', u'5,'),
+    (0x1F107, '3', u'6,'),
+    (0x1F108, '3', u'7,'),
+    (0x1F109, '3', u'8,'),
+    (0x1F10A, '3', u'9,'),
+    (0x1F10B, 'V'),
+    (0x1F10D, 'X'),
+    (0x1F110, '3', u'(a)'),
+    (0x1F111, '3', u'(b)'),
+    (0x1F112, '3', u'(c)'),
+    (0x1F113, '3', u'(d)'),
+    (0x1F114, '3', u'(e)'),
+    (0x1F115, '3', u'(f)'),
+    (0x1F116, '3', u'(g)'),
+    (0x1F117, '3', u'(h)'),
+    (0x1F118, '3', u'(i)'),
+    (0x1F119, '3', u'(j)'),
+    (0x1F11A, '3', u'(k)'),
+    (0x1F11B, '3', u'(l)'),
+    (0x1F11C, '3', u'(m)'),
+    (0x1F11D, '3', u'(n)'),
+    (0x1F11E, '3', u'(o)'),
+    (0x1F11F, '3', u'(p)'),
+    (0x1F120, '3', u'(q)'),
+    (0x1F121, '3', u'(r)'),
+    (0x1F122, '3', u'(s)'),
+    (0x1F123, '3', u'(t)'),
+    (0x1F124, '3', u'(u)'),
+    ]
+
+def _seg_71():
+    return [
+    (0x1F125, '3', u'(v)'),
+    (0x1F126, '3', u'(w)'),
+    (0x1F127, '3', u'(x)'),
+    (0x1F128, '3', u'(y)'),
+    (0x1F129, '3', u'(z)'),
+    (0x1F12A, 'M', u'〔s〕'),
+    (0x1F12B, 'M', u'c'),
+    (0x1F12C, 'M', u'r'),
+    (0x1F12D, 'M', u'cd'),
+    (0x1F12E, 'M', u'wz'),
+    (0x1F12F, 'V'),
+    (0x1F130, 'M', u'a'),
+    (0x1F131, 'M', u'b'),
+    (0x1F132, 'M', u'c'),
+    (0x1F133, 'M', u'd'),
+    (0x1F134, 'M', u'e'),
+    (0x1F135, 'M', u'f'),
+    (0x1F136, 'M', u'g'),
+    (0x1F137, 'M', u'h'),
+    (0x1F138, 'M', u'i'),
+    (0x1F139, 'M', u'j'),
+    (0x1F13A, 'M', u'k'),
+    (0x1F13B, 'M', u'l'),
+    (0x1F13C, 'M', u'm'),
+    (0x1F13D, 'M', u'n'),
+    (0x1F13E, 'M', u'o'),
+    (0x1F13F, 'M', u'p'),
+    (0x1F140, 'M', u'q'),
+    (0x1F141, 'M', u'r'),
+    (0x1F142, 'M', u's'),
+    (0x1F143, 'M', u't'),
+    (0x1F144, 'M', u'u'),
+    (0x1F145, 'M', u'v'),
+    (0x1F146, 'M', u'w'),
+    (0x1F147, 'M', u'x'),
+    (0x1F148, 'M', u'y'),
+    (0x1F149, 'M', u'z'),
+    (0x1F14A, 'M', u'hv'),
+    (0x1F14B, 'M', u'mv'),
+    (0x1F14C, 'M', u'sd'),
+    (0x1F14D, 'M', u'ss'),
+    (0x1F14E, 'M', u'ppv'),
+    (0x1F14F, 'M', u'wc'),
+    (0x1F150, 'V'),
+    (0x1F16A, 'M', u'mc'),
+    (0x1F16B, 'M', u'md'),
+    (0x1F16C, 'X'),
+    (0x1F170, 'V'),
+    (0x1F190, 'M', u'dj'),
+    (0x1F191, 'V'),
+    (0x1F1AD, 'X'),
+    (0x1F1E6, 'V'),
+    (0x1F200, 'M', u'ほか'),
+    (0x1F201, 'M', u'ココ'),
+    (0x1F202, 'M', u'サ'),
+    (0x1F203, 'X'),
+    (0x1F210, 'M', u'手'),
+    (0x1F211, 'M', u'字'),
+    (0x1F212, 'M', u'双'),
+    (0x1F213, 'M', u'デ'),
+    (0x1F214, 'M', u'二'),
+    (0x1F215, 'M', u'多'),
+    (0x1F216, 'M', u'解'),
+    (0x1F217, 'M', u'天'),
+    (0x1F218, 'M', u'交'),
+    (0x1F219, 'M', u'映'),
+    (0x1F21A, 'M', u'無'),
+    (0x1F21B, 'M', u'料'),
+    (0x1F21C, 'M', u'前'),
+    (0x1F21D, 'M', u'後'),
+    (0x1F21E, 'M', u'再'),
+    (0x1F21F, 'M', u'新'),
+    (0x1F220, 'M', u'初'),
+    (0x1F221, 'M', u'終'),
+    (0x1F222, 'M', u'生'),
+    (0x1F223, 'M', u'販'),
+    (0x1F224, 'M', u'声'),
+    (0x1F225, 'M', u'吹'),
+    (0x1F226, 'M', u'演'),
+    (0x1F227, 'M', u'投'),
+    (0x1F228, 'M', u'捕'),
+    (0x1F229, 'M', u'一'),
+    (0x1F22A, 'M', u'三'),
+    (0x1F22B, 'M', u'遊'),
+    (0x1F22C, 'M', u'左'),
+    (0x1F22D, 'M', u'中'),
+    (0x1F22E, 'M', u'右'),
+    (0x1F22F, 'M', u'指'),
+    (0x1F230, 'M', u'走'),
+    (0x1F231, 'M', u'打'),
+    (0x1F232, 'M', u'禁'),
+    (0x1F233, 'M', u'空'),
+    (0x1F234, 'M', u'合'),
+    (0x1F235, 'M', u'満'),
+    (0x1F236, 'M', u'有'),
+    (0x1F237, 'M', u'月'),
+    (0x1F238, 'M', u'申'),
+    (0x1F239, 'M', u'割'),
+    (0x1F23A, 'M', u'営'),
+    (0x1F23B, 'M', u'配'),
+    ]
+
+def _seg_72():
+    return [
+    (0x1F23C, 'X'),
+    (0x1F240, 'M', u'〔本〕'),
+    (0x1F241, 'M', u'〔三〕'),
+    (0x1F242, 'M', u'〔二〕'),
+    (0x1F243, 'M', u'〔安〕'),
+    (0x1F244, 'M', u'〔点〕'),
+    (0x1F245, 'M', u'〔打〕'),
+    (0x1F246, 'M', u'〔盗〕'),
+    (0x1F247, 'M', u'〔勝〕'),
+    (0x1F248, 'M', u'〔敗〕'),
+    (0x1F249, 'X'),
+    (0x1F250, 'M', u'得'),
+    (0x1F251, 'M', u'可'),
+    (0x1F252, 'X'),
+    (0x1F260, 'V'),
+    (0x1F266, 'X'),
+    (0x1F300, 'V'),
+    (0x1F6D5, 'X'),
+    (0x1F6E0, 'V'),
+    (0x1F6ED, 'X'),
+    (0x1F6F0, 'V'),
+    (0x1F6FA, 'X'),
+    (0x1F700, 'V'),
+    (0x1F774, 'X'),
+    (0x1F780, 'V'),
+    (0x1F7D9, 'X'),
+    (0x1F800, 'V'),
+    (0x1F80C, 'X'),
+    (0x1F810, 'V'),
+    (0x1F848, 'X'),
+    (0x1F850, 'V'),
+    (0x1F85A, 'X'),
+    (0x1F860, 'V'),
+    (0x1F888, 'X'),
+    (0x1F890, 'V'),
+    (0x1F8AE, 'X'),
+    (0x1F900, 'V'),
+    (0x1F90C, 'X'),
+    (0x1F910, 'V'),
+    (0x1F93F, 'X'),
+    (0x1F940, 'V'),
+    (0x1F971, 'X'),
+    (0x1F973, 'V'),
+    (0x1F977, 'X'),
+    (0x1F97A, 'V'),
+    (0x1F97B, 'X'),
+    (0x1F97C, 'V'),
+    (0x1F9A3, 'X'),
+    (0x1F9B0, 'V'),
+    (0x1F9BA, 'X'),
+    (0x1F9C0, 'V'),
+    (0x1F9C3, 'X'),
+    (0x1F9D0, 'V'),
+    (0x1FA00, 'X'),
+    (0x1FA60, 'V'),
+    (0x1FA6E, 'X'),
+    (0x20000, 'V'),
+    (0x2A6D7, 'X'),
+    (0x2A700, 'V'),
+    (0x2B735, 'X'),
+    (0x2B740, 'V'),
+    (0x2B81E, 'X'),
+    (0x2B820, 'V'),
+    (0x2CEA2, 'X'),
+    (0x2CEB0, 'V'),
+    (0x2EBE1, 'X'),
+    (0x2F800, 'M', u'丽'),
+    (0x2F801, 'M', u'丸'),
+    (0x2F802, 'M', u'乁'),
+    (0x2F803, 'M', u'𠄢'),
+    (0x2F804, 'M', u'你'),
+    (0x2F805, 'M', u'侮'),
+    (0x2F806, 'M', u'侻'),
+    (0x2F807, 'M', u'倂'),
+    (0x2F808, 'M', u'偺'),
+    (0x2F809, 'M', u'備'),
+    (0x2F80A, 'M', u'僧'),
+    (0x2F80B, 'M', u'像'),
+    (0x2F80C, 'M', u'㒞'),
+    (0x2F80D, 'M', u'𠘺'),
+    (0x2F80E, 'M', u'免'),
+    (0x2F80F, 'M', u'兔'),
+    (0x2F810, 'M', u'兤'),
+    (0x2F811, 'M', u'具'),
+    (0x2F812, 'M', u'𠔜'),
+    (0x2F813, 'M', u'㒹'),
+    (0x2F814, 'M', u'內'),
+    (0x2F815, 'M', u'再'),
+    (0x2F816, 'M', u'𠕋'),
+    (0x2F817, 'M', u'冗'),
+    (0x2F818, 'M', u'冤'),
+    (0x2F819, 'M', u'仌'),
+    (0x2F81A, 'M', u'冬'),
+    (0x2F81B, 'M', u'况'),
+    (0x2F81C, 'M', u'𩇟'),
+    (0x2F81D, 'M', u'凵'),
+    (0x2F81E, 'M', u'刃'),
+    (0x2F81F, 'M', u'㓟'),
+    (0x2F820, 'M', u'刻'),
+    (0x2F821, 'M', u'剆'),
+    ]
+
+def _seg_73():
+    return [
+    (0x2F822, 'M', u'割'),
+    (0x2F823, 'M', u'剷'),
+    (0x2F824, 'M', u'㔕'),
+    (0x2F825, 'M', u'勇'),
+    (0x2F826, 'M', u'勉'),
+    (0x2F827, 'M', u'勤'),
+    (0x2F828, 'M', u'勺'),
+    (0x2F829, 'M', u'包'),
+    (0x2F82A, 'M', u'匆'),
+    (0x2F82B, 'M', u'北'),
+    (0x2F82C, 'M', u'卉'),
+    (0x2F82D, 'M', u'卑'),
+    (0x2F82E, 'M', u'博'),
+    (0x2F82F, 'M', u'即'),
+    (0x2F830, 'M', u'卽'),
+    (0x2F831, 'M', u'卿'),
+    (0x2F834, 'M', u'𠨬'),
+    (0x2F835, 'M', u'灰'),
+    (0x2F836, 'M', u'及'),
+    (0x2F837, 'M', u'叟'),
+    (0x2F838, 'M', u'𠭣'),
+    (0x2F839, 'M', u'叫'),
+    (0x2F83A, 'M', u'叱'),
+    (0x2F83B, 'M', u'吆'),
+    (0x2F83C, 'M', u'咞'),
+    (0x2F83D, 'M', u'吸'),
+    (0x2F83E, 'M', u'呈'),
+    (0x2F83F, 'M', u'周'),
+    (0x2F840, 'M', u'咢'),
+    (0x2F841, 'M', u'哶'),
+    (0x2F842, 'M', u'唐'),
+    (0x2F843, 'M', u'啓'),
+    (0x2F844, 'M', u'啣'),
+    (0x2F845, 'M', u'善'),
+    (0x2F847, 'M', u'喙'),
+    (0x2F848, 'M', u'喫'),
+    (0x2F849, 'M', u'喳'),
+    (0x2F84A, 'M', u'嗂'),
+    (0x2F84B, 'M', u'圖'),
+    (0x2F84C, 'M', u'嘆'),
+    (0x2F84D, 'M', u'圗'),
+    (0x2F84E, 'M', u'噑'),
+    (0x2F84F, 'M', u'噴'),
+    (0x2F850, 'M', u'切'),
+    (0x2F851, 'M', u'壮'),
+    (0x2F852, 'M', u'城'),
+    (0x2F853, 'M', u'埴'),
+    (0x2F854, 'M', u'堍'),
+    (0x2F855, 'M', u'型'),
+    (0x2F856, 'M', u'堲'),
+    (0x2F857, 'M', u'報'),
+    (0x2F858, 'M', u'墬'),
+    (0x2F859, 'M', u'𡓤'),
+    (0x2F85A, 'M', u'売'),
+    (0x2F85B, 'M', u'壷'),
+    (0x2F85C, 'M', u'夆'),
+    (0x2F85D, 'M', u'多'),
+    (0x2F85E, 'M', u'夢'),
+    (0x2F85F, 'M', u'奢'),
+    (0x2F860, 'M', u'𡚨'),
+    (0x2F861, 'M', u'𡛪'),
+    (0x2F862, 'M', u'姬'),
+    (0x2F863, 'M', u'娛'),
+    (0x2F864, 'M', u'娧'),
+    (0x2F865, 'M', u'姘'),
+    (0x2F866, 'M', u'婦'),
+    (0x2F867, 'M', u'㛮'),
+    (0x2F868, 'X'),
+    (0x2F869, 'M', u'嬈'),
+    (0x2F86A, 'M', u'嬾'),
+    (0x2F86C, 'M', u'𡧈'),
+    (0x2F86D, 'M', u'寃'),
+    (0x2F86E, 'M', u'寘'),
+    (0x2F86F, 'M', u'寧'),
+    (0x2F870, 'M', u'寳'),
+    (0x2F871, 'M', u'𡬘'),
+    (0x2F872, 'M', u'寿'),
+    (0x2F873, 'M', u'将'),
+    (0x2F874, 'X'),
+    (0x2F875, 'M', u'尢'),
+    (0x2F876, 'M', u'㞁'),
+    (0x2F877, 'M', u'屠'),
+    (0x2F878, 'M', u'屮'),
+    (0x2F879, 'M', u'峀'),
+    (0x2F87A, 'M', u'岍'),
+    (0x2F87B, 'M', u'𡷤'),
+    (0x2F87C, 'M', u'嵃'),
+    (0x2F87D, 'M', u'𡷦'),
+    (0x2F87E, 'M', u'嵮'),
+    (0x2F87F, 'M', u'嵫'),
+    (0x2F880, 'M', u'嵼'),
+    (0x2F881, 'M', u'巡'),
+    (0x2F882, 'M', u'巢'),
+    (0x2F883, 'M', u'㠯'),
+    (0x2F884, 'M', u'巽'),
+    (0x2F885, 'M', u'帨'),
+    (0x2F886, 'M', u'帽'),
+    (0x2F887, 'M', u'幩'),
+    (0x2F888, 'M', u'㡢'),
+    (0x2F889, 'M', u'𢆃'),
+    ]
+
+def _seg_74():
+    return [
+    (0x2F88A, 'M', u'㡼'),
+    (0x2F88B, 'M', u'庰'),
+    (0x2F88C, 'M', u'庳'),
+    (0x2F88D, 'M', u'庶'),
+    (0x2F88E, 'M', u'廊'),
+    (0x2F88F, 'M', u'𪎒'),
+    (0x2F890, 'M', u'廾'),
+    (0x2F891, 'M', u'𢌱'),
+    (0x2F893, 'M', u'舁'),
+    (0x2F894, 'M', u'弢'),
+    (0x2F896, 'M', u'㣇'),
+    (0x2F897, 'M', u'𣊸'),
+    (0x2F898, 'M', u'𦇚'),
+    (0x2F899, 'M', u'形'),
+    (0x2F89A, 'M', u'彫'),
+    (0x2F89B, 'M', u'㣣'),
+    (0x2F89C, 'M', u'徚'),
+    (0x2F89D, 'M', u'忍'),
+    (0x2F89E, 'M', u'志'),
+    (0x2F89F, 'M', u'忹'),
+    (0x2F8A0, 'M', u'悁'),
+    (0x2F8A1, 'M', u'㤺'),
+    (0x2F8A2, 'M', u'㤜'),
+    (0x2F8A3, 'M', u'悔'),
+    (0x2F8A4, 'M', u'𢛔'),
+    (0x2F8A5, 'M', u'惇'),
+    (0x2F8A6, 'M', u'慈'),
+    (0x2F8A7, 'M', u'慌'),
+    (0x2F8A8, 'M', u'慎'),
+    (0x2F8A9, 'M', u'慌'),
+    (0x2F8AA, 'M', u'慺'),
+    (0x2F8AB, 'M', u'憎'),
+    (0x2F8AC, 'M', u'憲'),
+    (0x2F8AD, 'M', u'憤'),
+    (0x2F8AE, 'M', u'憯'),
+    (0x2F8AF, 'M', u'懞'),
+    (0x2F8B0, 'M', u'懲'),
+    (0x2F8B1, 'M', u'懶'),
+    (0x2F8B2, 'M', u'成'),
+    (0x2F8B3, 'M', u'戛'),
+    (0x2F8B4, 'M', u'扝'),
+    (0x2F8B5, 'M', u'抱'),
+    (0x2F8B6, 'M', u'拔'),
+    (0x2F8B7, 'M', u'捐'),
+    (0x2F8B8, 'M', u'𢬌'),
+    (0x2F8B9, 'M', u'挽'),
+    (0x2F8BA, 'M', u'拼'),
+    (0x2F8BB, 'M', u'捨'),
+    (0x2F8BC, 'M', u'掃'),
+    (0x2F8BD, 'M', u'揤'),
+    (0x2F8BE, 'M', u'𢯱'),
+    (0x2F8BF, 'M', u'搢'),
+    (0x2F8C0, 'M', u'揅'),
+    (0x2F8C1, 'M', u'掩'),
+    (0x2F8C2, 'M', u'㨮'),
+    (0x2F8C3, 'M', u'摩'),
+    (0x2F8C4, 'M', u'摾'),
+    (0x2F8C5, 'M', u'撝'),
+    (0x2F8C6, 'M', u'摷'),
+    (0x2F8C7, 'M', u'㩬'),
+    (0x2F8C8, 'M', u'敏'),
+    (0x2F8C9, 'M', u'敬'),
+    (0x2F8CA, 'M', u'𣀊'),
+    (0x2F8CB, 'M', u'旣'),
+    (0x2F8CC, 'M', u'書'),
+    (0x2F8CD, 'M', u'晉'),
+    (0x2F8CE, 'M', u'㬙'),
+    (0x2F8CF, 'M', u'暑'),
+    (0x2F8D0, 'M', u'㬈'),
+    (0x2F8D1, 'M', u'㫤'),
+    (0x2F8D2, 'M', u'冒'),
+    (0x2F8D3, 'M', u'冕'),
+    (0x2F8D4, 'M', u'最'),
+    (0x2F8D5, 'M', u'暜'),
+    (0x2F8D6, 'M', u'肭'),
+    (0x2F8D7, 'M', u'䏙'),
+    (0x2F8D8, 'M', u'朗'),
+    (0x2F8D9, 'M', u'望'),
+    (0x2F8DA, 'M', u'朡'),
+    (0x2F8DB, 'M', u'杞'),
+    (0x2F8DC, 'M', u'杓'),
+    (0x2F8DD, 'M', u'𣏃'),
+    (0x2F8DE, 'M', u'㭉'),
+    (0x2F8DF, 'M', u'柺'),
+    (0x2F8E0, 'M', u'枅'),
+    (0x2F8E1, 'M', u'桒'),
+    (0x2F8E2, 'M', u'梅'),
+    (0x2F8E3, 'M', u'𣑭'),
+    (0x2F8E4, 'M', u'梎'),
+    (0x2F8E5, 'M', u'栟'),
+    (0x2F8E6, 'M', u'椔'),
+    (0x2F8E7, 'M', u'㮝'),
+    (0x2F8E8, 'M', u'楂'),
+    (0x2F8E9, 'M', u'榣'),
+    (0x2F8EA, 'M', u'槪'),
+    (0x2F8EB, 'M', u'檨'),
+    (0x2F8EC, 'M', u'𣚣'),
+    (0x2F8ED, 'M', u'櫛'),
+    (0x2F8EE, 'M', u'㰘'),
+    (0x2F8EF, 'M', u'次'),
+    ]
+
+def _seg_75():
+    return [
+    (0x2F8F0, 'M', u'𣢧'),
+    (0x2F8F1, 'M', u'歔'),
+    (0x2F8F2, 'M', u'㱎'),
+    (0x2F8F3, 'M', u'歲'),
+    (0x2F8F4, 'M', u'殟'),
+    (0x2F8F5, 'M', u'殺'),
+    (0x2F8F6, 'M', u'殻'),
+    (0x2F8F7, 'M', u'𣪍'),
+    (0x2F8F8, 'M', u'𡴋'),
+    (0x2F8F9, 'M', u'𣫺'),
+    (0x2F8FA, 'M', u'汎'),
+    (0x2F8FB, 'M', u'𣲼'),
+    (0x2F8FC, 'M', u'沿'),
+    (0x2F8FD, 'M', u'泍'),
+    (0x2F8FE, 'M', u'汧'),
+    (0x2F8FF, 'M', u'洖'),
+    (0x2F900, 'M', u'派'),
+    (0x2F901, 'M', u'海'),
+    (0x2F902, 'M', u'流'),
+    (0x2F903, 'M', u'浩'),
+    (0x2F904, 'M', u'浸'),
+    (0x2F905, 'M', u'涅'),
+    (0x2F906, 'M', u'𣴞'),
+    (0x2F907, 'M', u'洴'),
+    (0x2F908, 'M', u'港'),
+    (0x2F909, 'M', u'湮'),
+    (0x2F90A, 'M', u'㴳'),
+    (0x2F90B, 'M', u'滋'),
+    (0x2F90C, 'M', u'滇'),
+    (0x2F90D, 'M', u'𣻑'),
+    (0x2F90E, 'M', u'淹'),
+    (0x2F90F, 'M', u'潮'),
+    (0x2F910, 'M', u'𣽞'),
+    (0x2F911, 'M', u'𣾎'),
+    (0x2F912, 'M', u'濆'),
+    (0x2F913, 'M', u'瀹'),
+    (0x2F914, 'M', u'瀞'),
+    (0x2F915, 'M', u'瀛'),
+    (0x2F916, 'M', u'㶖'),
+    (0x2F917, 'M', u'灊'),
+    (0x2F918, 'M', u'災'),
+    (0x2F919, 'M', u'灷'),
+    (0x2F91A, 'M', u'炭'),
+    (0x2F91B, 'M', u'𠔥'),
+    (0x2F91C, 'M', u'煅'),
+    (0x2F91D, 'M', u'𤉣'),
+    (0x2F91E, 'M', u'熜'),
+    (0x2F91F, 'X'),
+    (0x2F920, 'M', u'爨'),
+    (0x2F921, 'M', u'爵'),
+    (0x2F922, 'M', u'牐'),
+    (0x2F923, 'M', u'𤘈'),
+    (0x2F924, 'M', u'犀'),
+    (0x2F925, 'M', u'犕'),
+    (0x2F926, 'M', u'𤜵'),
+    (0x2F927, 'M', u'𤠔'),
+    (0x2F928, 'M', u'獺'),
+    (0x2F929, 'M', u'王'),
+    (0x2F92A, 'M', u'㺬'),
+    (0x2F92B, 'M', u'玥'),
+    (0x2F92C, 'M', u'㺸'),
+    (0x2F92E, 'M', u'瑇'),
+    (0x2F92F, 'M', u'瑜'),
+    (0x2F930, 'M', u'瑱'),
+    (0x2F931, 'M', u'璅'),
+    (0x2F932, 'M', u'瓊'),
+    (0x2F933, 'M', u'㼛'),
+    (0x2F934, 'M', u'甤'),
+    (0x2F935, 'M', u'𤰶'),
+    (0x2F936, 'M', u'甾'),
+    (0x2F937, 'M', u'𤲒'),
+    (0x2F938, 'M', u'異'),
+    (0x2F939, 'M', u'𢆟'),
+    (0x2F93A, 'M', u'瘐'),
+    (0x2F93B, 'M', u'𤾡'),
+    (0x2F93C, 'M', u'𤾸'),
+    (0x2F93D, 'M', u'𥁄'),
+    (0x2F93E, 'M', u'㿼'),
+    (0x2F93F, 'M', u'䀈'),
+    (0x2F940, 'M', u'直'),
+    (0x2F941, 'M', u'𥃳'),
+    (0x2F942, 'M', u'𥃲'),
+    (0x2F943, 'M', u'𥄙'),
+    (0x2F944, 'M', u'𥄳'),
+    (0x2F945, 'M', u'眞'),
+    (0x2F946, 'M', u'真'),
+    (0x2F948, 'M', u'睊'),
+    (0x2F949, 'M', u'䀹'),
+    (0x2F94A, 'M', u'瞋'),
+    (0x2F94B, 'M', u'䁆'),
+    (0x2F94C, 'M', u'䂖'),
+    (0x2F94D, 'M', u'𥐝'),
+    (0x2F94E, 'M', u'硎'),
+    (0x2F94F, 'M', u'碌'),
+    (0x2F950, 'M', u'磌'),
+    (0x2F951, 'M', u'䃣'),
+    (0x2F952, 'M', u'𥘦'),
+    (0x2F953, 'M', u'祖'),
+    (0x2F954, 'M', u'𥚚'),
+    (0x2F955, 'M', u'𥛅'),
+    ]
+
+def _seg_76():
+    return [
+    (0x2F956, 'M', u'福'),
+    (0x2F957, 'M', u'秫'),
+    (0x2F958, 'M', u'䄯'),
+    (0x2F959, 'M', u'穀'),
+    (0x2F95A, 'M', u'穊'),
+    (0x2F95B, 'M', u'穏'),
+    (0x2F95C, 'M', u'𥥼'),
+    (0x2F95D, 'M', u'𥪧'),
+    (0x2F95F, 'X'),
+    (0x2F960, 'M', u'䈂'),
+    (0x2F961, 'M', u'𥮫'),
+    (0x2F962, 'M', u'篆'),
+    (0x2F963, 'M', u'築'),
+    (0x2F964, 'M', u'䈧'),
+    (0x2F965, 'M', u'𥲀'),
+    (0x2F966, 'M', u'糒'),
+    (0x2F967, 'M', u'䊠'),
+    (0x2F968, 'M', u'糨'),
+    (0x2F969, 'M', u'糣'),
+    (0x2F96A, 'M', u'紀'),
+    (0x2F96B, 'M', u'𥾆'),
+    (0x2F96C, 'M', u'絣'),
+    (0x2F96D, 'M', u'䌁'),
+    (0x2F96E, 'M', u'緇'),
+    (0x2F96F, 'M', u'縂'),
+    (0x2F970, 'M', u'繅'),
+    (0x2F971, 'M', u'䌴'),
+    (0x2F972, 'M', u'𦈨'),
+    (0x2F973, 'M', u'𦉇'),
+    (0x2F974, 'M', u'䍙'),
+    (0x2F975, 'M', u'𦋙'),
+    (0x2F976, 'M', u'罺'),
+    (0x2F977, 'M', u'𦌾'),
+    (0x2F978, 'M', u'羕'),
+    (0x2F979, 'M', u'翺'),
+    (0x2F97A, 'M', u'者'),
+    (0x2F97B, 'M', u'𦓚'),
+    (0x2F97C, 'M', u'𦔣'),
+    (0x2F97D, 'M', u'聠'),
+    (0x2F97E, 'M', u'𦖨'),
+    (0x2F97F, 'M', u'聰'),
+    (0x2F980, 'M', u'𣍟'),
+    (0x2F981, 'M', u'䏕'),
+    (0x2F982, 'M', u'育'),
+    (0x2F983, 'M', u'脃'),
+    (0x2F984, 'M', u'䐋'),
+    (0x2F985, 'M', u'脾'),
+    (0x2F986, 'M', u'媵'),
+    (0x2F987, 'M', u'𦞧'),
+    (0x2F988, 'M', u'𦞵'),
+    (0x2F989, 'M', u'𣎓'),
+    (0x2F98A, 'M', u'𣎜'),
+    (0x2F98B, 'M', u'舁'),
+    (0x2F98C, 'M', u'舄'),
+    (0x2F98D, 'M', u'辞'),
+    (0x2F98E, 'M', u'䑫'),
+    (0x2F98F, 'M', u'芑'),
+    (0x2F990, 'M', u'芋'),
+    (0x2F991, 'M', u'芝'),
+    (0x2F992, 'M', u'劳'),
+    (0x2F993, 'M', u'花'),
+    (0x2F994, 'M', u'芳'),
+    (0x2F995, 'M', u'芽'),
+    (0x2F996, 'M', u'苦'),
+    (0x2F997, 'M', u'𦬼'),
+    (0x2F998, 'M', u'若'),
+    (0x2F999, 'M', u'茝'),
+    (0x2F99A, 'M', u'荣'),
+    (0x2F99B, 'M', u'莭'),
+    (0x2F99C, 'M', u'茣'),
+    (0x2F99D, 'M', u'莽'),
+    (0x2F99E, 'M', u'菧'),
+    (0x2F99F, 'M', u'著'),
+    (0x2F9A0, 'M', u'荓'),
+    (0x2F9A1, 'M', u'菊'),
+    (0x2F9A2, 'M', u'菌'),
+    (0x2F9A3, 'M', u'菜'),
+    (0x2F9A4, 'M', u'𦰶'),
+    (0x2F9A5, 'M', u'𦵫'),
+    (0x2F9A6, 'M', u'𦳕'),
+    (0x2F9A7, 'M', u'䔫'),
+    (0x2F9A8, 'M', u'蓱'),
+    (0x2F9A9, 'M', u'蓳'),
+    (0x2F9AA, 'M', u'蔖'),
+    (0x2F9AB, 'M', u'𧏊'),
+    (0x2F9AC, 'M', u'蕤'),
+    (0x2F9AD, 'M', u'𦼬'),
+    (0x2F9AE, 'M', u'䕝'),
+    (0x2F9AF, 'M', u'䕡'),
+    (0x2F9B0, 'M', u'𦾱'),
+    (0x2F9B1, 'M', u'𧃒'),
+    (0x2F9B2, 'M', u'䕫'),
+    (0x2F9B3, 'M', u'虐'),
+    (0x2F9B4, 'M', u'虜'),
+    (0x2F9B5, 'M', u'虧'),
+    (0x2F9B6, 'M', u'虩'),
+    (0x2F9B7, 'M', u'蚩'),
+    (0x2F9B8, 'M', u'蚈'),
+    (0x2F9B9, 'M', u'蜎'),
+    (0x2F9BA, 'M', u'蛢'),
+    ]
+
+def _seg_77():
+    return [
+    (0x2F9BB, 'M', u'蝹'),
+    (0x2F9BC, 'M', u'蜨'),
+    (0x2F9BD, 'M', u'蝫'),
+    (0x2F9BE, 'M', u'螆'),
+    (0x2F9BF, 'X'),
+    (0x2F9C0, 'M', u'蟡'),
+    (0x2F9C1, 'M', u'蠁'),
+    (0x2F9C2, 'M', u'䗹'),
+    (0x2F9C3, 'M', u'衠'),
+    (0x2F9C4, 'M', u'衣'),
+    (0x2F9C5, 'M', u'𧙧'),
+    (0x2F9C6, 'M', u'裗'),
+    (0x2F9C7, 'M', u'裞'),
+    (0x2F9C8, 'M', u'䘵'),
+    (0x2F9C9, 'M', u'裺'),
+    (0x2F9CA, 'M', u'㒻'),
+    (0x2F9CB, 'M', u'𧢮'),
+    (0x2F9CC, 'M', u'𧥦'),
+    (0x2F9CD, 'M', u'䚾'),
+    (0x2F9CE, 'M', u'䛇'),
+    (0x2F9CF, 'M', u'誠'),
+    (0x2F9D0, 'M', u'諭'),
+    (0x2F9D1, 'M', u'變'),
+    (0x2F9D2, 'M', u'豕'),
+    (0x2F9D3, 'M', u'𧲨'),
+    (0x2F9D4, 'M', u'貫'),
+    (0x2F9D5, 'M', u'賁'),
+    (0x2F9D6, 'M', u'贛'),
+    (0x2F9D7, 'M', u'起'),
+    (0x2F9D8, 'M', u'𧼯'),
+    (0x2F9D9, 'M', u'𠠄'),
+    (0x2F9DA, 'M', u'跋'),
+    (0x2F9DB, 'M', u'趼'),
+    (0x2F9DC, 'M', u'跰'),
+    (0x2F9DD, 'M', u'𠣞'),
+    (0x2F9DE, 'M', u'軔'),
+    (0x2F9DF, 'M', u'輸'),
+    (0x2F9E0, 'M', u'𨗒'),
+    (0x2F9E1, 'M', u'𨗭'),
+    (0x2F9E2, 'M', u'邔'),
+    (0x2F9E3, 'M', u'郱'),
+    (0x2F9E4, 'M', u'鄑'),
+    (0x2F9E5, 'M', u'𨜮'),
+    (0x2F9E6, 'M', u'鄛'),
+    (0x2F9E7, 'M', u'鈸'),
+    (0x2F9E8, 'M', u'鋗'),
+    (0x2F9E9, 'M', u'鋘'),
+    (0x2F9EA, 'M', u'鉼'),
+    (0x2F9EB, 'M', u'鏹'),
+    (0x2F9EC, 'M', u'鐕'),
+    (0x2F9ED, 'M', u'𨯺'),
+    (0x2F9EE, 'M', u'開'),
+    (0x2F9EF, 'M', u'䦕'),
+    (0x2F9F0, 'M', u'閷'),
+    (0x2F9F1, 'M', u'𨵷'),
+    (0x2F9F2, 'M', u'䧦'),
+    (0x2F9F3, 'M', u'雃'),
+    (0x2F9F4, 'M', u'嶲'),
+    (0x2F9F5, 'M', u'霣'),
+    (0x2F9F6, 'M', u'𩅅'),
+    (0x2F9F7, 'M', u'𩈚'),
+    (0x2F9F8, 'M', u'䩮'),
+    (0x2F9F9, 'M', u'䩶'),
+    (0x2F9FA, 'M', u'韠'),
+    (0x2F9FB, 'M', u'𩐊'),
+    (0x2F9FC, 'M', u'䪲'),
+    (0x2F9FD, 'M', u'𩒖'),
+    (0x2F9FE, 'M', u'頋'),
+    (0x2FA00, 'M', u'頩'),
+    (0x2FA01, 'M', u'𩖶'),
+    (0x2FA02, 'M', u'飢'),
+    (0x2FA03, 'M', u'䬳'),
+    (0x2FA04, 'M', u'餩'),
+    (0x2FA05, 'M', u'馧'),
+    (0x2FA06, 'M', u'駂'),
+    (0x2FA07, 'M', u'駾'),
+    (0x2FA08, 'M', u'䯎'),
+    (0x2FA09, 'M', u'𩬰'),
+    (0x2FA0A, 'M', u'鬒'),
+    (0x2FA0B, 'M', u'鱀'),
+    (0x2FA0C, 'M', u'鳽'),
+    (0x2FA0D, 'M', u'䳎'),
+    (0x2FA0E, 'M', u'䳭'),
+    (0x2FA0F, 'M', u'鵧'),
+    (0x2FA10, 'M', u'𪃎'),
+    (0x2FA11, 'M', u'䳸'),
+    (0x2FA12, 'M', u'𪄅'),
+    (0x2FA13, 'M', u'𪈎'),
+    (0x2FA14, 'M', u'𪊑'),
+    (0x2FA15, 'M', u'麻'),
+    (0x2FA16, 'M', u'䵖'),
+    (0x2FA17, 'M', u'黹'),
+    (0x2FA18, 'M', u'黾'),
+    (0x2FA19, 'M', u'鼅'),
+    (0x2FA1A, 'M', u'鼏'),
+    (0x2FA1B, 'M', u'鼖'),
+    (0x2FA1C, 'M', u'鼻'),
+    (0x2FA1D, 'M', u'𪘀'),
+    (0x2FA1E, 'X'),
+    (0xE0100, 'I'),
+    ]
+
+def _seg_78():
+    return [
+    (0xE01F0, 'X'),
+    ]
+
+uts46data = tuple(
+    _seg_0()
+    + _seg_1()
+    + _seg_2()
+    + _seg_3()
+    + _seg_4()
+    + _seg_5()
+    + _seg_6()
+    + _seg_7()
+    + _seg_8()
+    + _seg_9()
+    + _seg_10()
+    + _seg_11()
+    + _seg_12()
+    + _seg_13()
+    + _seg_14()
+    + _seg_15()
+    + _seg_16()
+    + _seg_17()
+    + _seg_18()
+    + _seg_19()
+    + _seg_20()
+    + _seg_21()
+    + _seg_22()
+    + _seg_23()
+    + _seg_24()
+    + _seg_25()
+    + _seg_26()
+    + _seg_27()
+    + _seg_28()
+    + _seg_29()
+    + _seg_30()
+    + _seg_31()
+    + _seg_32()
+    + _seg_33()
+    + _seg_34()
+    + _seg_35()
+    + _seg_36()
+    + _seg_37()
+    + _seg_38()
+    + _seg_39()
+    + _seg_40()
+    + _seg_41()
+    + _seg_42()
+    + _seg_43()
+    + _seg_44()
+    + _seg_45()
+    + _seg_46()
+    + _seg_47()
+    + _seg_48()
+    + _seg_49()
+    + _seg_50()
+    + _seg_51()
+    + _seg_52()
+    + _seg_53()
+    + _seg_54()
+    + _seg_55()
+    + _seg_56()
+    + _seg_57()
+    + _seg_58()
+    + _seg_59()
+    + _seg_60()
+    + _seg_61()
+    + _seg_62()
+    + _seg_63()
+    + _seg_64()
+    + _seg_65()
+    + _seg_66()
+    + _seg_67()
+    + _seg_68()
+    + _seg_69()
+    + _seg_70()
+    + _seg_71()
+    + _seg_72()
+    + _seg_73()
+    + _seg_74()
+    + _seg_75()
+    + _seg_76()
+    + _seg_77()
+    + _seg_78()
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..091c48c98bd273c2c87a02e6d651860f39687e9e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/METADATA
@@ -0,0 +1,25 @@
+Metadata-Version: 2.1
+Name: ipaddr
+Version: 2.2.0
+Summary: Google's IP address manipulation library
+Home-page: https://github.com/google/ipaddr-py
+Maintainer: Google
+Maintainer-email: ipaddr-py-dev@googlegroups.com
+License: Apache License, Version 2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Networking
+
+ipaddr.py is a library for working with IP addresses, both IPv4 and IPv6.
+
+It has been superseded by ipaddress from the Python 3 standard library, and its
+Python 2 backport.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..20af1079cead7529b1d6f70aac4040b71bf75d36
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/RECORD
@@ -0,0 +1,11 @@
+ipaddr.py,sha256=aLFbxT8MRuz4d9-SaD7OTxc0ylKlB3kYWvrJcGA043M,61975
+ipaddr-2.2.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+ipaddr-2.2.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+ipaddr-2.2.0.dist-info/METADATA,sha256=TCevnZVDMwlDom7QNVkWG9x1E0ty20sgdOTWF6Zi7wc,864
+ipaddr-2.2.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+ipaddr-2.2.0.dist-info/top_level.txt,sha256=xD6Kh91SkaBL5Ll6W3OsU3tsyOHTt2hK5KvfeIX3T3Q,7
+ipaddr-2.2.0.dist-info/RECORD,,
+ipaddr-2.2.0.dist-info/INSTALLER,,
+ipaddr-2.2.0.dist-info/__pycache__,,
+ipaddr-2.2.0.virtualenv,,
+ipaddr.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..95b8fc57e8052e78ac6aa3a3264b70ed44166dbd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+ipaddr
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr-2.2.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d1f58c896972de2203e78eac1869f1c145a0f6c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/ipaddr.py
@@ -0,0 +1,1928 @@
+#!/usr/bin/python
+#
+# Copyright 2007 Google Inc.
+#  Licensed to PSF under a Contributor Agreement.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied. See the License for the specific language governing
+# permissions and limitations under the License.
+
+"""A fast, lightweight IPv4/IPv6 manipulation library in Python.
+
+This library is used to create/poke/manipulate IPv4 and IPv6 addresses
+and networks.
+
+"""
+
+__version__ = '2.2.0'
+
+import struct
+import sys
+
+if sys.version_info > (3,):
+    long = int
+    xrange = range
+
+IPV4LENGTH = 32
+IPV6LENGTH = 128
+
+
+class AddressValueError(ValueError):
+    """A Value Error related to the address."""
+
+
+class NetmaskValueError(ValueError):
+    """A Value Error related to the netmask."""
+
+
+def IPAddress(address, version=None):
+    """Take an IP string/int and return an object of the correct type.
+
+    Args:
+        address: A string or integer, the IP address.  Either IPv4 or
+          IPv6 addresses may be supplied; integers less than 2**32 will
+          be considered to be IPv4 by default.
+        version: An Integer, 4 or 6. If set, don't try to automatically
+          determine what the IP address type is. important for things
+          like IPAddress(1), which could be IPv4, '0.0.0.1',  or IPv6,
+          '::1'.
+
+    Returns:
+        An IPv4Address or IPv6Address object.
+
+    Raises:
+        ValueError: if the string passed isn't either a v4 or a v6
+          address.
+
+    """
+    if version:
+        if version == 4:
+            return IPv4Address(address)
+        elif version == 6:
+            return IPv6Address(address)
+
+    try:
+        return IPv4Address(address)
+    except (AddressValueError, NetmaskValueError):
+        pass
+
+    try:
+        return IPv6Address(address)
+    except (AddressValueError, NetmaskValueError):
+        pass
+
+    raise ValueError('%r does not appear to be an IPv4 or IPv6 address' %
+                     address)
+
+
+def IPNetwork(address, version=None, strict=False):
+    """Take an IP string/int and return an object of the correct type.
+
+    Args:
+        address: A string or integer, the IP address.  Either IPv4 or
+          IPv6 addresses may be supplied; integers less than 2**32 will
+          be considered to be IPv4 by default.
+        version: An Integer, if set, don't try to automatically
+          determine what the IP address type is. important for things
+          like IPNetwork(1), which could be IPv4, '0.0.0.1/32', or IPv6,
+          '::1/128'.
+
+    Returns:
+        An IPv4Network or IPv6Network object.
+
+    Raises:
+        ValueError: if the string passed isn't either a v4 or a v6
+          address. Or if a strict network was requested and a strict
+          network wasn't given.
+
+    """
+    if version:
+        if version == 4:
+            return IPv4Network(address, strict)
+        elif version == 6:
+            return IPv6Network(address, strict)
+
+    try:
+        return IPv4Network(address, strict)
+    except (AddressValueError, NetmaskValueError):
+        pass
+
+    try:
+        return IPv6Network(address, strict)
+    except (AddressValueError, NetmaskValueError):
+        pass
+
+    raise ValueError('%r does not appear to be an IPv4 or IPv6 network' %
+                     address)
+
+
+def v4_int_to_packed(address):
+    """The binary representation of this address.
+
+    Args:
+        address: An integer representation of an IPv4 IP address.
+
+    Returns:
+        The binary representation of this address.
+
+    Raises:
+        ValueError: If the integer is too large to be an IPv4 IP
+          address.
+    """
+    if address > _BaseV4._ALL_ONES:
+        raise ValueError('Address too large for IPv4')
+    return Bytes(struct.pack('!I', address))
+
+
+def v6_int_to_packed(address):
+    """The binary representation of this address.
+
+    Args:
+        address: An integer representation of an IPv6 IP address.
+
+    Returns:
+        The binary representation of this address.
+    """
+    return Bytes(struct.pack('!QQ', address >> 64, address & (2**64 - 1)))
+
+
+def _find_address_range(addresses):
+    """Find a sequence of addresses.
+
+    Args:
+        addresses: a list of IPv4 or IPv6 addresses.
+
+    Returns:
+        A tuple containing the first and last IP addresses in the sequence,
+        and the index of the last IP address in the sequence.
+
+    """
+    first = last = addresses[0]
+    last_index = 0
+    for ip in addresses[1:]:
+        if ip._ip == last._ip + 1:
+            last = ip
+            last_index += 1
+        else:
+            break
+    return (first, last, last_index)
+
+def _get_prefix_length(number1, number2, bits):
+    """Get the number of leading bits that are same for two numbers.
+
+    Args:
+        number1: an integer.
+        number2: another integer.
+        bits: the maximum number of bits to compare.
+
+    Returns:
+        The number of leading bits that are the same for two numbers.
+
+    """
+    for i in range(bits):
+        if number1 >> i == number2 >> i:
+            return bits - i
+    return 0
+
+def _count_righthand_zero_bits(number, bits):
+    """Count the number of zero bits on the right hand side.
+
+    Args:
+        number: an integer.
+        bits: maximum number of bits to count.
+
+    Returns:
+        The number of zero bits on the right hand side of the number.
+
+    """
+    if number == 0:
+        return bits
+    for i in range(bits):
+        if (number >> i) % 2:
+            return i
+
+def summarize_address_range(first, last):
+    """Summarize a network range given the first and last IP addresses.
+
+    Example:
+        >>> summarize_address_range(IPv4Address('1.1.1.0'),
+            IPv4Address('1.1.1.130'))
+        [IPv4Network('1.1.1.0/25'), IPv4Network('1.1.1.128/31'),
+        IPv4Network('1.1.1.130/32')]
+
+    Args:
+        first: the first IPv4Address or IPv6Address in the range.
+        last: the last IPv4Address or IPv6Address in the range.
+
+    Returns:
+        The address range collapsed to a list of IPv4Network's or
+        IPv6Network's.
+
+    Raise:
+        TypeError:
+            If the first and last objects are not IP addresses.
+            If the first and last objects are not the same version.
+        ValueError:
+            If the last object is not greater than the first.
+            If the version is not 4 or 6.
+
+    """
+    if not (isinstance(first, _BaseIP) and isinstance(last, _BaseIP)):
+        raise TypeError('first and last must be IP addresses, not networks')
+    if first.version != last.version:
+        raise TypeError("%s and %s are not of the same version" % (
+                str(first), str(last)))
+    if first > last:
+        raise ValueError('last IP address must be greater than first')
+
+    networks = []
+
+    if first.version == 4:
+        ip = IPv4Network
+    elif first.version == 6:
+        ip = IPv6Network
+    else:
+        raise ValueError('unknown IP version')
+
+    ip_bits = first._max_prefixlen
+    first_int = first._ip
+    last_int = last._ip
+    while first_int <= last_int:
+        nbits = _count_righthand_zero_bits(first_int, ip_bits)
+        current = None
+        while nbits >= 0:
+            addend = 2**nbits - 1
+            current = first_int + addend
+            nbits -= 1
+            if current <= last_int:
+                break
+        prefix = _get_prefix_length(first_int, current, ip_bits)
+        net = ip('%s/%d' % (str(first), prefix))
+        networks.append(net)
+        if current == ip._ALL_ONES:
+            break
+        first_int = current + 1
+        first = IPAddress(first_int, version=first._version)
+    return networks
+
+def _collapse_address_list_recursive(addresses):
+    """Loops through the addresses, collapsing concurrent netblocks.
+
+    Example:
+
+        ip1 = IPv4Network('1.1.0.0/24')
+        ip2 = IPv4Network('1.1.1.0/24')
+        ip3 = IPv4Network('1.1.2.0/24')
+        ip4 = IPv4Network('1.1.3.0/24')
+        ip5 = IPv4Network('1.1.4.0/24')
+        ip6 = IPv4Network('1.1.0.1/22')
+
+        _collapse_address_list_recursive([ip1, ip2, ip3, ip4, ip5, ip6]) ->
+          [IPv4Network('1.1.0.0/22'), IPv4Network('1.1.4.0/24')]
+
+        This shouldn't be called directly; it is called via
+          collapse_address_list([]).
+
+    Args:
+        addresses: A list of IPv4Network's or IPv6Network's
+
+    Returns:
+        A list of IPv4Network's or IPv6Network's depending on what we were
+        passed.
+
+    """
+    ret_array = []
+    optimized = False
+
+    for cur_addr in addresses:
+        if not ret_array:
+            ret_array.append(cur_addr)
+            continue
+        if cur_addr in ret_array[-1]:
+            optimized = True
+        elif cur_addr == ret_array[-1].supernet().subnet()[1]:
+            ret_array.append(ret_array.pop().supernet())
+            optimized = True
+        else:
+            ret_array.append(cur_addr)
+
+    if optimized:
+        return _collapse_address_list_recursive(ret_array)
+
+    return ret_array
+
+
+def collapse_address_list(addresses):
+    """Collapse a list of IP objects.
+
+    Example:
+        collapse_address_list([IPv4('1.1.0.0/24'), IPv4('1.1.1.0/24')]) ->
+          [IPv4('1.1.0.0/23')]
+
+    Args:
+        addresses: A list of IPv4Network or IPv6Network objects.
+
+    Returns:
+        A list of IPv4Network or IPv6Network objects depending on what we
+        were passed.
+
+    Raises:
+        TypeError: If passed a list of mixed version objects.
+
+    """
+    i = 0
+    addrs = []
+    ips = []
+    nets = []
+
+    # split IP addresses and networks
+    for ip in addresses:
+        if isinstance(ip, _BaseIP):
+            if ips and ips[-1]._version != ip._version:
+                raise TypeError("%s and %s are not of the same version" % (
+                        str(ip), str(ips[-1])))
+            ips.append(ip)
+        elif ip._prefixlen == ip._max_prefixlen:
+            if ips and ips[-1]._version != ip._version:
+                raise TypeError("%s and %s are not of the same version" % (
+                        str(ip), str(ips[-1])))
+            ips.append(ip.ip)
+        else:
+            if nets and nets[-1]._version != ip._version:
+                raise TypeError("%s and %s are not of the same version" % (
+                        str(ip), str(nets[-1])))
+            nets.append(ip)
+
+    # sort and dedup
+    ips = sorted(set(ips))
+    nets = sorted(set(nets))
+
+    while i < len(ips):
+        (first, last, last_index) = _find_address_range(ips[i:])
+        i += last_index + 1
+        addrs.extend(summarize_address_range(first, last))
+
+    return _collapse_address_list_recursive(sorted(
+        addrs + nets, key=_BaseNet._get_networks_key))
+
+# backwards compatibility
+CollapseAddrList = collapse_address_list
+
+# We need to distinguish between the string and packed-bytes representations
+# of an IP address.  For example, b'0::1' is the IPv4 address 48.58.58.49,
+# while '0::1' is an IPv6 address.
+#
+# In Python 3, the native 'bytes' type already provides this functionality,
+# so we use it directly.  For earlier implementations where bytes is not a
+# distinct type, we create a subclass of str to serve as a tag.
+#
+# Usage example (Python 2):
+#   ip = ipaddr.IPAddress(ipaddr.Bytes('xxxx'))
+#
+# Usage example (Python 3):
+#   ip = ipaddr.IPAddress(b'xxxx')
+try:
+    if bytes is str:
+        raise TypeError("bytes is not a distinct type")
+    Bytes = bytes
+except (NameError, TypeError):
+    class Bytes(str):
+        def __repr__(self):
+            return 'Bytes(%s)' % str.__repr__(self)
+
+def get_mixed_type_key(obj):
+    """Return a key suitable for sorting between networks and addresses.
+
+    Address and Network objects are not sortable by default; they're
+    fundamentally different so the expression
+
+        IPv4Address('1.1.1.1') <= IPv4Network('1.1.1.1/24')
+
+    doesn't make any sense.  There are some times however, where you may wish
+    to have ipaddr sort these for you anyway. If you need to do this, you
+    can use this function as the key= argument to sorted().
+
+    Args:
+      obj: either a Network or Address object.
+    Returns:
+      appropriate key.
+
+    """
+    if isinstance(obj, _BaseNet):
+        return obj._get_networks_key()
+    elif isinstance(obj, _BaseIP):
+        return obj._get_address_key()
+    return NotImplemented
+
+class _IPAddrBase(object):
+
+    """The mother class."""
+
+    def __index__(self):
+        return self._ip
+
+    def __int__(self):
+        return self._ip
+
+    def __hex__(self):
+        return hex(self._ip)
+
+    @property
+    def exploded(self):
+        """Return the longhand version of the IP address as a string."""
+        return self._explode_shorthand_ip_string()
+
+    @property
+    def compressed(self):
+        """Return the shorthand version of the IP address as a string."""
+        return str(self)
+
+
+class _BaseIP(_IPAddrBase):
+
+    """A generic IP object.
+
+    This IP class contains the version independent methods which are
+    used by single IP addresses.
+
+    """
+
+    def __eq__(self, other):
+        try:
+            return (self._ip == other._ip
+                    and self._version == other._version)
+        except AttributeError:
+            return NotImplemented
+
+    def __ne__(self, other):
+        eq = self.__eq__(other)
+        if eq is NotImplemented:
+            return NotImplemented
+        return not eq
+
+    def __le__(self, other):
+        gt = self.__gt__(other)
+        if gt is NotImplemented:
+            return NotImplemented
+        return not gt
+
+    def __ge__(self, other):
+        lt = self.__lt__(other)
+        if lt is NotImplemented:
+            return NotImplemented
+        return not lt
+
+    def __lt__(self, other):
+        if self._version != other._version:
+            raise TypeError('%s and %s are not of the same version' % (
+                    str(self), str(other)))
+        if not isinstance(other, _BaseIP):
+            raise TypeError('%s and %s are not of the same type' % (
+                    str(self), str(other)))
+        if self._ip != other._ip:
+            return self._ip < other._ip
+        return False
+
+    def __gt__(self, other):
+        if self._version != other._version:
+            raise TypeError('%s and %s are not of the same version' % (
+                    str(self), str(other)))
+        if not isinstance(other, _BaseIP):
+            raise TypeError('%s and %s are not of the same type' % (
+                    str(self), str(other)))
+        if self._ip != other._ip:
+            return self._ip > other._ip
+        return False
+
+    # Shorthand for Integer addition and subtraction. This is not
+    # meant to ever support addition/subtraction of addresses.
+    def __add__(self, other):
+        if not isinstance(other, int):
+            return NotImplemented
+        return IPAddress(int(self) + other, version=self._version)
+
+    def __sub__(self, other):
+        if not isinstance(other, int):
+            return NotImplemented
+        return IPAddress(int(self) - other, version=self._version)
+
+    def __repr__(self):
+        return '%s(%r)' % (self.__class__.__name__, str(self))
+
+    def __str__(self):
+        return  '%s' % self._string_from_ip_int(self._ip)
+
+    def __hash__(self):
+        return hash(hex(long(self._ip)))
+
+    def _get_address_key(self):
+        return (self._version, self)
+
+    @property
+    def version(self):
+        raise NotImplementedError('BaseIP has no version')
+
+
+class _BaseNet(_IPAddrBase):
+
+    """A generic IP object.
+
+    This IP class contains the version independent methods which are
+    used by networks.
+
+    """
+
+    def __init__(self, address):
+        self._cache = {}
+
+    def __repr__(self):
+        return '%s(%r)' % (self.__class__.__name__, str(self))
+
+    def iterhosts(self):
+        """Generate Iterator over usable hosts in a network.
+
+           This is like __iter__ except it doesn't return the network
+           or broadcast addresses.
+
+        """
+        cur = int(self.network) + 1
+        bcast = int(self.broadcast) - 1
+        while cur <= bcast:
+            cur += 1
+            yield IPAddress(cur - 1, version=self._version)
+
+    def __iter__(self):
+        cur = int(self.network)
+        bcast = int(self.broadcast)
+        while cur <= bcast:
+            cur += 1
+            yield IPAddress(cur - 1, version=self._version)
+
+    def __getitem__(self, n):
+        network = int(self.network)
+        broadcast = int(self.broadcast)
+        if n >= 0:
+            if network + n > broadcast:
+                raise IndexError
+            return IPAddress(network + n, version=self._version)
+        else:
+            n += 1
+            if broadcast + n < network:
+                raise IndexError
+            return IPAddress(broadcast + n, version=self._version)
+
+    def __lt__(self, other):
+        if self._version != other._version:
+            raise TypeError('%s and %s are not of the same version' % (
+                    str(self), str(other)))
+        if not isinstance(other, _BaseNet):
+            raise TypeError('%s and %s are not of the same type' % (
+                    str(self), str(other)))
+        if self.network != other.network:
+            return self.network < other.network
+        if self.netmask != other.netmask:
+            return self.netmask < other.netmask
+        return False
+
+    def __gt__(self, other):
+        if self._version != other._version:
+            raise TypeError('%s and %s are not of the same version' % (
+                    str(self), str(other)))
+        if not isinstance(other, _BaseNet):
+            raise TypeError('%s and %s are not of the same type' % (
+                    str(self), str(other)))
+        if self.network != other.network:
+            return self.network > other.network
+        if self.netmask != other.netmask:
+            return self.netmask > other.netmask
+        return False
+
+    def __le__(self, other):
+        gt = self.__gt__(other)
+        if gt is NotImplemented:
+            return NotImplemented
+        return not gt
+
+    def __ge__(self, other):
+        lt = self.__lt__(other)
+        if lt is NotImplemented:
+            return NotImplemented
+        return not lt
+
+    def __eq__(self, other):
+        try:
+            return (self._version == other._version
+                    and self.network == other.network
+                    and int(self.netmask) == int(other.netmask))
+        except AttributeError:
+            if isinstance(other, _BaseIP):
+                return (self._version == other._version
+                        and self._ip == other._ip)
+
+    def __ne__(self, other):
+        eq = self.__eq__(other)
+        if eq is NotImplemented:
+            return NotImplemented
+        return not eq
+
+    def __str__(self):
+        return  '%s/%s' % (str(self.ip),
+                           str(self._prefixlen))
+
+    def __hash__(self):
+        return hash(int(self.network) ^ int(self.netmask))
+
+    def __contains__(self, other):
+        # always false if one is v4 and the other is v6.
+        if self._version != other._version:
+          return False
+        # dealing with another network.
+        if isinstance(other, _BaseNet):
+            return (self.network <= other.network and
+                    self.broadcast >= other.broadcast)
+        # dealing with another address
+        else:
+            return (int(self.network) <= int(other._ip) <=
+                    int(self.broadcast))
+
+    def overlaps(self, other):
+        """Tell if self is partly contained in other."""
+        return self.network in other or self.broadcast in other or (
+            other.network in self or other.broadcast in self)
+
+    @property
+    def network(self):
+        x = self._cache.get('network')
+        if x is None:
+            x = IPAddress(self._ip & int(self.netmask), version=self._version)
+            self._cache['network'] = x
+        return x
+
+    @property
+    def broadcast(self):
+        x = self._cache.get('broadcast')
+        if x is None:
+            x = IPAddress(self._ip | int(self.hostmask), version=self._version)
+            self._cache['broadcast'] = x
+        return x
+
+    @property
+    def hostmask(self):
+        x = self._cache.get('hostmask')
+        if x is None:
+            x = IPAddress(int(self.netmask) ^ self._ALL_ONES,
+                          version=self._version)
+            self._cache['hostmask'] = x
+        return x
+
+    @property
+    def with_prefixlen(self):
+        return '%s/%d' % (str(self.ip), self._prefixlen)
+
+    @property
+    def with_netmask(self):
+        return '%s/%s' % (str(self.ip), str(self.netmask))
+
+    @property
+    def with_hostmask(self):
+        return '%s/%s' % (str(self.ip), str(self.hostmask))
+
+    @property
+    def numhosts(self):
+        """Number of hosts in the current subnet."""
+        return int(self.broadcast) - int(self.network) + 1
+
+    @property
+    def version(self):
+        raise NotImplementedError('BaseNet has no version')
+
+    @property
+    def prefixlen(self):
+        return self._prefixlen
+
+    def address_exclude(self, other):
+        """Remove an address from a larger block.
+
+        For example:
+
+            addr1 = IPNetwork('10.1.1.0/24')
+            addr2 = IPNetwork('10.1.1.0/26')
+            addr1.address_exclude(addr2) =
+                [IPNetwork('10.1.1.64/26'), IPNetwork('10.1.1.128/25')]
+
+        or IPv6:
+
+            addr1 = IPNetwork('::1/32')
+            addr2 = IPNetwork('::1/128')
+            addr1.address_exclude(addr2) = [IPNetwork('::0/128'),
+                IPNetwork('::2/127'),
+                IPNetwork('::4/126'),
+                IPNetwork('::8/125'),
+                ...
+                IPNetwork('0:0:8000::/33')]
+
+        Args:
+            other: An IPvXNetwork object of the same type.
+
+        Returns:
+            A sorted list of IPvXNetwork objects addresses which is self
+            minus other.
+
+        Raises:
+            TypeError: If self and other are of difffering address
+              versions, or if other is not a network object.
+            ValueError: If other is not completely contained by self.
+
+        """
+        if not self._version == other._version:
+            raise TypeError("%s and %s are not of the same version" % (
+                str(self), str(other)))
+
+        if not isinstance(other, _BaseNet):
+            raise TypeError("%s is not a network object" % str(other))
+
+        if other not in self:
+            raise ValueError('%s not contained in %s' % (str(other),
+                                                         str(self)))
+        if other == self:
+            return []
+
+        ret_addrs = []
+
+        # Make sure we're comparing the network of other.
+        other = IPNetwork('%s/%s' % (str(other.network), str(other.prefixlen)),
+                   version=other._version)
+
+        s1, s2 = self.subnet()
+        while s1 != other and s2 != other:
+            if other in s1:
+                ret_addrs.append(s2)
+                s1, s2 = s1.subnet()
+            elif other in s2:
+                ret_addrs.append(s1)
+                s1, s2 = s2.subnet()
+            else:
+                # If we got here, there's a bug somewhere.
+                assert True == False, ('Error performing exclusion: '
+                                       's1: %s s2: %s other: %s' %
+                                       (str(s1), str(s2), str(other)))
+        if s1 == other:
+            ret_addrs.append(s2)
+        elif s2 == other:
+            ret_addrs.append(s1)
+        else:
+            # If we got here, there's a bug somewhere.
+            assert True == False, ('Error performing exclusion: '
+                                   's1: %s s2: %s other: %s' %
+                                   (str(s1), str(s2), str(other)))
+
+        return sorted(ret_addrs, key=_BaseNet._get_networks_key)
+
+    def compare_networks(self, other):
+        """Compare two IP objects.
+
+        This is only concerned about the comparison of the integer
+        representation of the network addresses.  This means that the
+        host bits aren't considered at all in this method.  If you want
+        to compare host bits, you can easily enough do a
+        'HostA._ip < HostB._ip'
+
+        Args:
+            other: An IP object.
+
+        Returns:
+            If the IP versions of self and other are the same, returns:
+
+            -1 if self < other:
+              eg: IPv4('1.1.1.0/24') < IPv4('1.1.2.0/24')
+              IPv6('1080::200C:417A') < IPv6('1080::200B:417B')
+            0 if self == other
+              eg: IPv4('1.1.1.1/24') == IPv4('1.1.1.2/24')
+              IPv6('1080::200C:417A/96') == IPv6('1080::200C:417B/96')
+            1 if self > other
+              eg: IPv4('1.1.1.0/24') > IPv4('1.1.0.0/24')
+              IPv6('1080::1:200C:417A/112') >
+              IPv6('1080::0:200C:417A/112')
+
+            If the IP versions of self and other are different, returns:
+
+            -1 if self._version < other._version
+              eg: IPv4('10.0.0.1/24') < IPv6('::1/128')
+            1 if self._version > other._version
+              eg: IPv6('::1/128') > IPv4('255.255.255.0/24')
+
+        """
+        if self._version < other._version:
+            return -1
+        if self._version > other._version:
+            return 1
+        # self._version == other._version below here:
+        if self.network < other.network:
+            return -1
+        if self.network > other.network:
+            return 1
+        # self.network == other.network below here:
+        if self.netmask < other.netmask:
+            return -1
+        if self.netmask > other.netmask:
+            return 1
+        # self.network == other.network and self.netmask == other.netmask
+        return 0
+
+    def _get_networks_key(self):
+        """Network-only key function.
+
+        Returns an object that identifies this address' network and
+        netmask. This function is a suitable "key" argument for sorted()
+        and list.sort().
+
+        """
+        return (self._version, self.network, self.netmask)
+
+    def _ip_int_from_prefix(self, prefixlen):
+        """Turn the prefix length into a bitwise netmask.
+
+        Args:
+            prefixlen: An integer, the prefix length.
+
+        Returns:
+            An integer.
+
+        """
+        return self._ALL_ONES ^ (self._ALL_ONES >> prefixlen)
+
+    def _prefix_from_ip_int(self, ip_int):
+        """Return prefix length from a bitwise netmask.
+
+        Args:
+            ip_int: An integer, the netmask in expanded bitwise format.
+
+        Returns:
+            An integer, the prefix length.
+
+        Raises:
+            NetmaskValueError: If the input is not a valid netmask.
+
+        """
+        prefixlen = self._max_prefixlen
+        while prefixlen:
+            if ip_int & 1:
+                break
+            ip_int >>= 1
+            prefixlen -= 1
+
+        if ip_int == (1 << prefixlen) - 1:
+            return prefixlen
+        else:
+            raise NetmaskValueError('Bit pattern does not match /1*0*/')
+
+    def _prefix_from_prefix_int(self, prefixlen):
+        """Validate and return a prefix length integer.
+
+        Args:
+            prefixlen: An integer containing the prefix length.
+
+        Returns:
+            The input, possibly converted from long to int.
+
+        Raises:
+            NetmaskValueError: If the input is not an integer, or out of range.
+        """
+        if not isinstance(prefixlen, (int, long)):
+            raise NetmaskValueError('%r is not an integer' % prefixlen)
+        prefixlen = int(prefixlen)
+        if not (0 <= prefixlen <= self._max_prefixlen):
+            raise NetmaskValueError('%d is not a valid prefix length' %
+                                    prefixlen)
+        return prefixlen
+
+    def _prefix_from_prefix_string(self, prefixlen_str):
+        """Turn a prefix length string into an integer.
+
+        Args:
+            prefixlen_str: A decimal string containing the prefix length.
+
+        Returns:
+            The prefix length as an integer.
+
+        Raises:
+            NetmaskValueError: If the input is malformed or out of range.
+
+        """
+        try:
+            if not _BaseV4._DECIMAL_DIGITS.issuperset(prefixlen_str):
+                raise ValueError
+            prefixlen = int(prefixlen_str)
+        except ValueError:
+            raise NetmaskValueError('%s is not a valid prefix length' %
+                                    prefixlen_str)
+        return self._prefix_from_prefix_int(prefixlen)
+
+    def _prefix_from_ip_string(self, ip_str):
+        """Turn a netmask/hostmask string into a prefix length.
+
+        Args:
+            ip_str: A netmask or hostmask, formatted as an IP address.
+
+        Returns:
+            The prefix length as an integer.
+
+        Raises:
+            NetmaskValueError: If the input is not a netmask or hostmask.
+
+        """
+        # Parse the netmask/hostmask like an IP address.
+        try:
+            ip_int = self._ip_int_from_string(ip_str)
+        except AddressValueError:
+            raise NetmaskValueError('%s is not a valid netmask' % ip_str)
+
+        # Try matching a netmask (this would be /1*0*/ as a bitwise regexp).
+        # Note that the two ambiguous cases (all-ones and all-zeroes) are
+        # treated as netmasks.
+        try:
+            return self._prefix_from_ip_int(ip_int)
+        except NetmaskValueError:
+            pass
+
+        # Invert the bits, and try matching a /0+1+/ hostmask instead.
+        ip_int ^= self._ALL_ONES
+        try:
+            return self._prefix_from_ip_int(ip_int)
+        except NetmaskValueError:
+            raise NetmaskValueError('%s is not a valid netmask' % ip_str)
+
+    def iter_subnets(self, prefixlen_diff=1, new_prefix=None):
+        """The subnets which join to make the current subnet.
+
+        In the case that self contains only one IP
+        (self._prefixlen == 32 for IPv4 or self._prefixlen == 128
+        for IPv6), return a list with just ourself.
+
+        Args:
+            prefixlen_diff: An integer, the amount the prefix length
+              should be increased by. This should not be set if
+              new_prefix is also set.
+            new_prefix: The desired new prefix length. This must be a
+              larger number (smaller prefix) than the existing prefix.
+              This should not be set if prefixlen_diff is also set.
+
+        Returns:
+            An iterator of IPv(4|6) objects.
+
+        Raises:
+            ValueError: The prefixlen_diff is too small or too large.
+                OR
+            prefixlen_diff and new_prefix are both set or new_prefix
+              is a smaller number than the current prefix (smaller
+              number means a larger network)
+
+        """
+        if self._prefixlen == self._max_prefixlen:
+            yield self
+            return
+
+        if new_prefix is not None:
+            if new_prefix < self._prefixlen:
+                raise ValueError('new prefix must be longer')
+            if prefixlen_diff != 1:
+                raise ValueError('cannot set prefixlen_diff and new_prefix')
+            prefixlen_diff = new_prefix - self._prefixlen
+
+        if prefixlen_diff < 0:
+            raise ValueError('prefix length diff must be > 0')
+        new_prefixlen = self._prefixlen + prefixlen_diff
+
+        if new_prefixlen > self._max_prefixlen:
+            raise ValueError(
+                'prefix length diff %d is invalid for netblock %s' % (
+                    new_prefixlen, str(self)))
+
+        first = IPNetwork('%s/%s' % (str(self.network),
+                                     str(self._prefixlen + prefixlen_diff)),
+                         version=self._version)
+
+        yield first
+        current = first
+        while True:
+            broadcast = current.broadcast
+            if broadcast == self.broadcast:
+                return
+            new_addr = IPAddress(int(broadcast) + 1, version=self._version)
+            current = IPNetwork('%s/%s' % (str(new_addr), str(new_prefixlen)),
+                                version=self._version)
+
+            yield current
+
+    def masked(self):
+        """Return the network object with the host bits masked out."""
+        return IPNetwork('%s/%d' % (self.network, self._prefixlen),
+                         version=self._version)
+
+    def subnet(self, prefixlen_diff=1, new_prefix=None):
+        """Return a list of subnets, rather than an iterator."""
+        return list(self.iter_subnets(prefixlen_diff, new_prefix))
+
+    def supernet(self, prefixlen_diff=1, new_prefix=None):
+        """The supernet containing the current network.
+
+        Args:
+            prefixlen_diff: An integer, the amount the prefix length of
+              the network should be decreased by.  For example, given a
+              /24 network and a prefixlen_diff of 3, a supernet with a
+              /21 netmask is returned.
+
+        Returns:
+            An IPv4 network object.
+
+        Raises:
+            ValueError: If self.prefixlen - prefixlen_diff < 0. I.e., you have a
+              negative prefix length.
+                OR
+            If prefixlen_diff and new_prefix are both set or new_prefix is a
+              larger number than the current prefix (larger number means a
+              smaller network)
+
+        """
+        if self._prefixlen == 0:
+            return self
+
+        if new_prefix is not None:
+            if new_prefix > self._prefixlen:
+                raise ValueError('new prefix must be shorter')
+            if prefixlen_diff != 1:
+                raise ValueError('cannot set prefixlen_diff and new_prefix')
+            prefixlen_diff = self._prefixlen - new_prefix
+
+
+        if self.prefixlen - prefixlen_diff < 0:
+            raise ValueError(
+                'current prefixlen is %d, cannot have a prefixlen_diff of %d' %
+                (self.prefixlen, prefixlen_diff))
+        return IPNetwork('%s/%s' % (str(self.network),
+                                    str(self.prefixlen - prefixlen_diff)),
+                         version=self._version)
+
+    # backwards compatibility
+    Subnet = subnet
+    Supernet = supernet
+    AddressExclude = address_exclude
+    CompareNetworks = compare_networks
+    Contains = __contains__
+
+
+class _BaseV4(object):
+
+    """Base IPv4 object.
+
+    The following methods are used by IPv4 objects in both single IP
+    addresses and networks.
+
+    """
+
+    # Equivalent to 255.255.255.255 or 32 bits of 1's.
+    _ALL_ONES = (2**IPV4LENGTH) - 1
+    _DECIMAL_DIGITS = frozenset('0123456789')
+
+    def __init__(self, address):
+        self._version = 4
+        self._max_prefixlen = IPV4LENGTH
+
+    def _explode_shorthand_ip_string(self):
+        return str(self)
+
+    def _ip_int_from_string(self, ip_str):
+        """Turn the given IP string into an integer for comparison.
+
+        Args:
+            ip_str: A string, the IP ip_str.
+
+        Returns:
+            The IP ip_str as an integer.
+
+        Raises:
+            AddressValueError: if ip_str isn't a valid IPv4 Address.
+
+        """
+        octets = ip_str.split('.')
+        if len(octets) != 4:
+            raise AddressValueError(ip_str)
+
+        packed_ip = 0
+        for oc in octets:
+            try:
+                packed_ip = (packed_ip << 8) | self._parse_octet(oc)
+            except ValueError:
+                raise AddressValueError(ip_str)
+        return packed_ip
+
+    def _parse_octet(self, octet_str):
+        """Convert a decimal octet into an integer.
+
+        Args:
+            octet_str: A string, the number to parse.
+
+        Returns:
+            The octet as an integer.
+
+        Raises:
+            ValueError: if the octet isn't strictly a decimal from [0..255].
+
+        """
+        # Whitelist the characters, since int() allows a lot of bizarre stuff.
+        if not self._DECIMAL_DIGITS.issuperset(octet_str):
+            raise ValueError
+        octet_int = int(octet_str, 10)
+        # Disallow leading zeroes, because no clear standard exists on
+        # whether these should be interpreted as decimal or octal.
+        if octet_int > 255 or (octet_str[0] == '0' and len(octet_str) > 1):
+            raise ValueError
+        return octet_int
+
+    def _string_from_ip_int(self, ip_int):
+        """Turns a 32-bit integer into dotted decimal notation.
+
+        Args:
+            ip_int: An integer, the IP address.
+
+        Returns:
+            The IP address as a string in dotted decimal notation.
+
+        """
+        octets = []
+        for _ in xrange(4):
+            octets.insert(0, str(ip_int & 0xFF))
+            ip_int >>= 8
+        return '.'.join(octets)
+
+    @property
+    def max_prefixlen(self):
+        return self._max_prefixlen
+
+    @property
+    def packed(self):
+        """The binary representation of this address."""
+        return v4_int_to_packed(self._ip)
+
+    @property
+    def version(self):
+        return self._version
+
+    @property
+    def is_reserved(self):
+       """Test if the address is otherwise IETF reserved.
+
+        Returns:
+            A boolean, True if the address is within the
+            reserved IPv4 Network range.
+
+       """
+       return self in IPv4Network('240.0.0.0/4')
+
+    @property
+    def is_private(self):
+        """Test if this address is allocated for private networks.
+
+        Returns:
+            A boolean, True if the address is reserved per RFC 1918.
+
+        """
+        return (self in IPv4Network('10.0.0.0/8') or
+                self in IPv4Network('172.16.0.0/12') or
+                self in IPv4Network('192.168.0.0/16'))
+
+    @property
+    def is_multicast(self):
+        """Test if the address is reserved for multicast use.
+
+        Returns:
+            A boolean, True if the address is multicast.
+            See RFC 3171 for details.
+
+        """
+        return self in IPv4Network('224.0.0.0/4')
+
+    @property
+    def is_unspecified(self):
+        """Test if the address is unspecified.
+
+        Returns:
+            A boolean, True if this is the unspecified address as defined in
+            RFC 5735 3.
+
+        """
+        return self in IPv4Network('0.0.0.0')
+
+    @property
+    def is_loopback(self):
+        """Test if the address is a loopback address.
+
+        Returns:
+            A boolean, True if the address is a loopback per RFC 3330.
+
+        """
+        return self in IPv4Network('127.0.0.0/8')
+
+    @property
+    def is_link_local(self):
+        """Test if the address is reserved for link-local.
+
+        Returns:
+            A boolean, True if the address is link-local per RFC 3927.
+
+        """
+        return self in IPv4Network('169.254.0.0/16')
+
+
+class IPv4Address(_BaseV4, _BaseIP):
+
+    """Represent and manipulate single IPv4 Addresses."""
+
+    def __init__(self, address):
+
+        """
+        Args:
+            address: A string or integer representing the IP
+              '192.168.1.1'
+
+              Additionally, an integer can be passed, so
+              IPv4Address('192.168.1.1') == IPv4Address(3232235777).
+              or, more generally
+              IPv4Address(int(IPv4Address('192.168.1.1'))) ==
+                IPv4Address('192.168.1.1')
+
+        Raises:
+            AddressValueError: If ipaddr isn't a valid IPv4 address.
+
+        """
+        _BaseV4.__init__(self, address)
+
+        # Efficient copy constructor.
+        if isinstance(address, IPv4Address):
+            self._ip = address._ip
+            return
+
+        # Efficient constructor from integer.
+        if isinstance(address, (int, long)):
+            self._ip = address
+            if address < 0 or address > self._ALL_ONES:
+                raise AddressValueError(address)
+            return
+
+        # Constructing from a packed address
+        if isinstance(address, Bytes):
+            try:
+                self._ip, = struct.unpack('!I', address)
+            except struct.error:
+                raise AddressValueError(address)  # Wrong length.
+            return
+
+        # Assume input argument to be string or any object representation
+        # which converts into a formatted IP string.
+        addr_str = str(address)
+        self._ip = self._ip_int_from_string(addr_str)
+
+
+class IPv4Network(_BaseV4, _BaseNet):
+
+    """This class represents and manipulates 32-bit IPv4 networks.
+
+    Attributes: [examples for IPv4Network('1.2.3.4/27')]
+        ._ip: 16909060
+        .ip: IPv4Address('1.2.3.4')
+        .network: IPv4Address('1.2.3.0')
+        .hostmask: IPv4Address('0.0.0.31')
+        .broadcast: IPv4Address('1.2.3.31')
+        .netmask: IPv4Address('255.255.255.224')
+        .prefixlen: 27
+
+    """
+
+    def __init__(self, address, strict=False):
+        """Instantiate a new IPv4 network object.
+
+        Args:
+            address: The IPv4 network as a string, 2-tuple, or any format
+              supported by the IPv4Address constructor.
+
+              Strings typically use CIDR format, such as '192.0.2.0/24'.
+              If a dotted-quad is provided after the '/', it is treated as
+              a netmask if it starts with a nonzero bit (e.g. 255.0.0.0 == /8)
+              or a hostmask if it starts with a zero bit
+              (e.g. /0.0.0.255 == /8), with the single exception of an all-zero
+              mask which is treated as /0.
+
+              The 2-tuple format consists of an (ip, prefixlen), where ip is any
+              format recognized by the IPv4Address constructor, and prefixlen is
+              an integer from 0 through 32.
+
+              A plain IPv4 address (in any format) will be forwarded to the
+              IPv4Address constructor, with an implied prefixlen of 32.
+
+              For example, the following inputs are equivalent:
+                IPv4Network('192.0.2.1/32')
+                IPv4Network('192.0.2.1/255.255.255.255')
+                IPv4Network('192.0.2.1')
+                IPv4Network(0xc0000201)
+                IPv4Network(IPv4Address('192.0.2.1'))
+                IPv4Network(('192.0.2.1', 32))
+                IPv4Network((0xc0000201, 32))
+                IPv4Network((IPv4Address('192.0.2.1'), 32))
+
+            strict: A boolean. If true, ensure that we have been passed
+              A true network address, eg, 192.168.1.0/24 and not an
+              IP address on a network, eg, 192.168.1.1/24.
+
+        Raises:
+            AddressValueError: If ipaddr isn't a valid IPv4 address.
+            NetmaskValueError: If the netmask isn't valid for
+              an IPv4 address.
+            ValueError: If strict was True and a network address was not
+              supplied.
+
+        """
+        _BaseNet.__init__(self, address)
+        _BaseV4.__init__(self, address)
+
+        # Constructing from a single IP address.
+        if isinstance(address, (int, long, Bytes, IPv4Address)):
+            self.ip = IPv4Address(address)
+            self._ip = self.ip._ip
+            self._prefixlen = self._max_prefixlen
+            self.netmask = IPv4Address(self._ALL_ONES)
+            return
+
+        # Constructing from an (ip, prefixlen) tuple.
+        if isinstance(address, tuple):
+            try:
+                ip, prefixlen = address
+            except ValueError:
+                raise AddressValueError(address)
+            self.ip = IPv4Address(ip)
+            self._ip = self.ip._ip
+            self._prefixlen = self._prefix_from_prefix_int(prefixlen)
+
+        else:
+            # Assume input argument to be string or any object representation
+            # which converts into a formatted IP prefix string.
+            addr = str(address).split('/')
+
+            if len(addr) > 2:
+                raise AddressValueError(address)
+
+            self._ip = self._ip_int_from_string(addr[0])
+            self.ip = IPv4Address(self._ip)
+
+            if len(addr) == 2:
+                try:
+                    # Check for a netmask in prefix length form.
+                    self._prefixlen = self._prefix_from_prefix_string(addr[1])
+                except NetmaskValueError:
+                    # Check for a netmask or hostmask in dotted-quad form.
+                    # This may raise NetmaskValueError.
+                    self._prefixlen = self._prefix_from_ip_string(addr[1])
+            else:
+                self._prefixlen = self._max_prefixlen
+
+        self.netmask = IPv4Address(self._ip_int_from_prefix(self._prefixlen))
+
+        if strict:
+            if self.ip != self.network:
+                raise ValueError('%s has host bits set' % self.ip)
+        if self._prefixlen == (self._max_prefixlen - 1):
+            self.iterhosts = self.__iter__
+
+    # backwards compatibility
+    IsRFC1918 = lambda self: self.is_private
+    IsMulticast = lambda self: self.is_multicast
+    IsLoopback = lambda self: self.is_loopback
+    IsLinkLocal = lambda self: self.is_link_local
+
+
+class _BaseV6(object):
+
+    """Base IPv6 object.
+
+    The following methods are used by IPv6 objects in both single IP
+    addresses and networks.
+
+    """
+
+    _ALL_ONES = (2**IPV6LENGTH) - 1
+    _HEXTET_COUNT = 8
+    _HEX_DIGITS = frozenset('0123456789ABCDEFabcdef')
+
+    def __init__(self, address):
+        self._version = 6
+        self._max_prefixlen = IPV6LENGTH
+
+    def _ip_int_from_string(self, ip_str):
+        """Turn an IPv6 ip_str into an integer.
+
+        Args:
+            ip_str: A string, the IPv6 ip_str.
+
+        Returns:
+            A long, the IPv6 ip_str.
+
+        Raises:
+            AddressValueError: if ip_str isn't a valid IPv6 Address.
+
+        """
+        parts = ip_str.split(':')
+
+        # An IPv6 address needs at least 2 colons (3 parts).
+        if len(parts) < 3:
+            raise AddressValueError(ip_str)
+
+        # If the address has an IPv4-style suffix, convert it to hexadecimal.
+        if '.' in parts[-1]:
+            ipv4_int = IPv4Address(parts.pop())._ip
+            parts.append('%x' % ((ipv4_int >> 16) & 0xFFFF))
+            parts.append('%x' % (ipv4_int & 0xFFFF))
+
+        # An IPv6 address can't have more than 8 colons (9 parts).
+        if len(parts) > self._HEXTET_COUNT + 1:
+            raise AddressValueError(ip_str)
+
+        # Disregarding the endpoints, find '::' with nothing in between.
+        # This indicates that a run of zeroes has been skipped.
+        try:
+            skip_index, = (
+                [i for i in xrange(1, len(parts) - 1) if not parts[i]] or
+                [None])
+        except ValueError:
+            # Can't have more than one '::'
+            raise AddressValueError(ip_str)
+
+        # parts_hi is the number of parts to copy from above/before the '::'
+        # parts_lo is the number of parts to copy from below/after the '::'
+        if skip_index is not None:
+            # If we found a '::', then check if it also covers the endpoints.
+            parts_hi = skip_index
+            parts_lo = len(parts) - skip_index - 1
+            if not parts[0]:
+                parts_hi -= 1
+                if parts_hi:
+                    raise AddressValueError(ip_str)  # ^: requires ^::
+            if not parts[-1]:
+                parts_lo -= 1
+                if parts_lo:
+                    raise AddressValueError(ip_str)  # :$ requires ::$
+            parts_skipped = self._HEXTET_COUNT - (parts_hi + parts_lo)
+            if parts_skipped < 1:
+                raise AddressValueError(ip_str)
+        else:
+            # Otherwise, allocate the entire address to parts_hi.  The endpoints
+            # could still be empty, but _parse_hextet() will check for that.
+            if len(parts) != self._HEXTET_COUNT:
+                raise AddressValueError(ip_str)
+            parts_hi = len(parts)
+            parts_lo = 0
+            parts_skipped = 0
+
+        try:
+            # Now, parse the hextets into a 128-bit integer.
+            ip_int = long(0)
+            for i in xrange(parts_hi):
+                ip_int <<= 16
+                ip_int |= self._parse_hextet(parts[i])
+            ip_int <<= 16 * parts_skipped
+            for i in xrange(-parts_lo, 0):
+                ip_int <<= 16
+                ip_int |= self._parse_hextet(parts[i])
+            return ip_int
+        except ValueError:
+            raise AddressValueError(ip_str)
+
+    def _parse_hextet(self, hextet_str):
+        """Convert an IPv6 hextet string into an integer.
+
+        Args:
+            hextet_str: A string, the number to parse.
+
+        Returns:
+            The hextet as an integer.
+
+        Raises:
+            ValueError: if the input isn't strictly a hex number from [0..FFFF].
+
+        """
+        # Whitelist the characters, since int() allows a lot of bizarre stuff.
+        if not self._HEX_DIGITS.issuperset(hextet_str):
+            raise ValueError
+        if len(hextet_str) > 4:
+          raise ValueError
+        hextet_int = int(hextet_str, 16)
+        if hextet_int > 0xFFFF:
+            raise ValueError
+        return hextet_int
+
+    def _compress_hextets(self, hextets):
+        """Compresses a list of hextets.
+
+        Compresses a list of strings, replacing the longest continuous
+        sequence of "0" in the list with "" and adding empty strings at
+        the beginning or at the end of the string such that subsequently
+        calling ":".join(hextets) will produce the compressed version of
+        the IPv6 address.
+
+        Args:
+            hextets: A list of strings, the hextets to compress.
+
+        Returns:
+            A list of strings.
+
+        """
+        best_doublecolon_start = -1
+        best_doublecolon_len = 0
+        doublecolon_start = -1
+        doublecolon_len = 0
+        for index in range(len(hextets)):
+            if hextets[index] == '0':
+                doublecolon_len += 1
+                if doublecolon_start == -1:
+                    # Start of a sequence of zeros.
+                    doublecolon_start = index
+                if doublecolon_len > best_doublecolon_len:
+                    # This is the longest sequence of zeros so far.
+                    best_doublecolon_len = doublecolon_len
+                    best_doublecolon_start = doublecolon_start
+            else:
+                doublecolon_len = 0
+                doublecolon_start = -1
+
+        if best_doublecolon_len > 1:
+            best_doublecolon_end = (best_doublecolon_start +
+                                    best_doublecolon_len)
+            # For zeros at the end of the address.
+            if best_doublecolon_end == len(hextets):
+                hextets += ['']
+            hextets[best_doublecolon_start:best_doublecolon_end] = ['']
+            # For zeros at the beginning of the address.
+            if best_doublecolon_start == 0:
+                hextets = [''] + hextets
+
+        return hextets
+
+    def _string_from_ip_int(self, ip_int=None):
+        """Turns a 128-bit integer into hexadecimal notation.
+
+        Args:
+            ip_int: An integer, the IP address.
+
+        Returns:
+            A string, the hexadecimal representation of the address.
+
+        Raises:
+            ValueError: The address is bigger than 128 bits of all ones.
+
+        """
+        if not ip_int and ip_int != 0:
+            ip_int = int(self._ip)
+
+        if ip_int > self._ALL_ONES:
+            raise ValueError('IPv6 address is too large')
+
+        hex_str = '%032x' % ip_int
+        hextets = []
+        for x in range(0, 32, 4):
+            hextets.append('%x' % int(hex_str[x:x+4], 16))
+
+        hextets = self._compress_hextets(hextets)
+        return ':'.join(hextets)
+
+    def _explode_shorthand_ip_string(self):
+        """Expand a shortened IPv6 address.
+
+        Args:
+            ip_str: A string, the IPv6 address.
+
+        Returns:
+            A string, the expanded IPv6 address.
+
+        """
+        if isinstance(self, _BaseNet):
+            ip_str = str(self.ip)
+        else:
+            ip_str = str(self)
+
+        ip_int = self._ip_int_from_string(ip_str)
+        parts = []
+        for i in xrange(self._HEXTET_COUNT):
+            parts.append('%04x' % (ip_int & 0xFFFF))
+            ip_int >>= 16
+        parts.reverse()
+        if isinstance(self, _BaseNet):
+            return '%s/%d' % (':'.join(parts), self.prefixlen)
+        return ':'.join(parts)
+
+    @property
+    def max_prefixlen(self):
+        return self._max_prefixlen
+
+    @property
+    def packed(self):
+        """The binary representation of this address."""
+        return v6_int_to_packed(self._ip)
+
+    @property
+    def version(self):
+        return self._version
+
+    @property
+    def is_multicast(self):
+        """Test if the address is reserved for multicast use.
+
+        Returns:
+            A boolean, True if the address is a multicast address.
+            See RFC 2373 2.7 for details.
+
+        """
+        return self in IPv6Network('ff00::/8')
+
+    @property
+    def is_reserved(self):
+        """Test if the address is otherwise IETF reserved.
+
+        Returns:
+            A boolean, True if the address is within one of the
+            reserved IPv6 Network ranges.
+
+        """
+        return (self in IPv6Network('::/8') or
+                self in IPv6Network('100::/8') or
+                self in IPv6Network('200::/7') or
+                self in IPv6Network('400::/6') or
+                self in IPv6Network('800::/5') or
+                self in IPv6Network('1000::/4') or
+                self in IPv6Network('4000::/3') or
+                self in IPv6Network('6000::/3') or
+                self in IPv6Network('8000::/3') or
+                self in IPv6Network('A000::/3') or
+                self in IPv6Network('C000::/3') or
+                self in IPv6Network('E000::/4') or
+                self in IPv6Network('F000::/5') or
+                self in IPv6Network('F800::/6') or
+                self in IPv6Network('FE00::/9'))
+
+    @property
+    def is_unspecified(self):
+        """Test if the address is unspecified.
+
+        Returns:
+            A boolean, True if this is the unspecified address as defined in
+            RFC 2373 2.5.2.
+
+        """
+        return self._ip == 0 and getattr(self, '_prefixlen', 128) == 128
+
+    @property
+    def is_loopback(self):
+        """Test if the address is a loopback address.
+
+        Returns:
+            A boolean, True if the address is a loopback address as defined in
+            RFC 2373 2.5.3.
+
+        """
+        return self._ip == 1 and getattr(self, '_prefixlen', 128) == 128
+
+    @property
+    def is_link_local(self):
+        """Test if the address is reserved for link-local.
+
+        Returns:
+            A boolean, True if the address is reserved per RFC 4291.
+
+        """
+        return self in IPv6Network('fe80::/10')
+
+    @property
+    def is_site_local(self):
+        """Test if the address is reserved for site-local.
+
+        Note that the site-local address space has been deprecated by RFC 3879.
+        Use is_private to test if this address is in the space of unique local
+        addresses as defined by RFC 4193.
+
+        Returns:
+            A boolean, True if the address is reserved per RFC 3513 2.5.6.
+
+        """
+        return self in IPv6Network('fec0::/10')
+
+    @property
+    def is_private(self):
+        """Test if this address is allocated for private networks.
+
+        Returns:
+            A boolean, True if the address is reserved per RFC 4193.
+
+        """
+        return self in IPv6Network('fc00::/7')
+
+    @property
+    def ipv4_mapped(self):
+        """Return the IPv4 mapped address.
+
+        Returns:
+            If the IPv6 address is a v4 mapped address, return the
+            IPv4 mapped address. Return None otherwise.
+
+        """
+        if (self._ip >> 32) != 0xFFFF:
+            return None
+        return IPv4Address(self._ip & 0xFFFFFFFF)
+
+    @property
+    def teredo(self):
+        """Tuple of embedded teredo IPs.
+
+        Returns:
+            Tuple of the (server, client) IPs or None if the address
+            doesn't appear to be a teredo address (doesn't start with
+            2001::/32)
+
+        """
+        if (self._ip >> 96) != 0x20010000:
+            return None
+        return (IPv4Address((self._ip >> 64) & 0xFFFFFFFF),
+                IPv4Address(~self._ip & 0xFFFFFFFF))
+
+    @property
+    def sixtofour(self):
+        """Return the IPv4 6to4 embedded address.
+
+        Returns:
+            The IPv4 6to4-embedded address if present or None if the
+            address doesn't appear to contain a 6to4 embedded address.
+
+        """
+        if (self._ip >> 112) != 0x2002:
+            return None
+        return IPv4Address((self._ip >> 80) & 0xFFFFFFFF)
+
+
+class IPv6Address(_BaseV6, _BaseIP):
+
+    """Represent and manipulate single IPv6 Addresses.
+    """
+
+    def __init__(self, address):
+        """Instantiate a new IPv6 address object.
+
+        Args:
+            address: A string or integer representing the IP
+
+              Additionally, an integer can be passed, so
+              IPv6Address('2001:4860::') ==
+                IPv6Address(42541956101370907050197289607612071936L).
+              or, more generally
+              IPv6Address(IPv6Address('2001:4860::')._ip) ==
+                IPv6Address('2001:4860::')
+
+        Raises:
+            AddressValueError: If address isn't a valid IPv6 address.
+
+        """
+        _BaseV6.__init__(self, address)
+
+        # Efficient copy constructor.
+        if isinstance(address, IPv6Address):
+            self._ip = address._ip
+            return
+
+        # Efficient constructor from integer.
+        if isinstance(address, (int, long)):
+            self._ip = address
+            if address < 0 or address > self._ALL_ONES:
+                raise AddressValueError(address)
+            return
+
+        # Constructing from a packed address
+        if isinstance(address, Bytes):
+            try:
+                hi, lo = struct.unpack('!QQ', address)
+            except struct.error:
+                raise AddressValueError(address)  # Wrong length.
+            self._ip = (hi << 64) | lo
+            return
+
+        # Assume input argument to be string or any object representation
+        # which converts into a formatted IP string.
+        addr_str = str(address)
+        self._ip = self._ip_int_from_string(addr_str)
+
+
+class IPv6Network(_BaseV6, _BaseNet):
+
+    """This class represents and manipulates 128-bit IPv6 networks.
+
+    Attributes: [examples for IPv6('2001:658:22A:CAFE:200::1/64')]
+        .ip: IPv6Address('2001:658:22a:cafe:200::1')
+        .network: IPv6Address('2001:658:22a:cafe::')
+        .hostmask: IPv6Address('::ffff:ffff:ffff:ffff')
+        .broadcast: IPv6Address('2001:658:22a:cafe:ffff:ffff:ffff:ffff')
+        .netmask: IPv6Address('ffff:ffff:ffff:ffff::')
+        .prefixlen: 64
+
+    """
+
+
+    def __init__(self, address, strict=False):
+        """Instantiate a new IPv6 network object.
+
+        Args:
+            address: The IPv6 network as a string, 2-tuple, or any format
+              supported by the IPv6Address constructor.
+
+              Strings should be in CIDR format, such as '2001:db8::/32'.
+
+              The 2-tuple format consists of an (ip, prefixlen), where ip is any
+              format recognized by the IPv6Address constructor, and prefixlen is
+              an integer from 0 through 128.
+
+              A plain IPv6 address (in any format) will be forwarded to the
+              IPv6Address constructor, with an implied prefixlen of 128.
+
+              For example, the following inputs are equivalent:
+                IPv6Network('2001:db8::/128')
+                IPv6Network('2001:db8:0:0:0:0:0:0/128')
+                IPv6Network('2001:db8::')
+                IPv6Network(0x20010db8 << 96)
+                IPv6Network(IPv6Address('2001:db8::'))
+                IPv6Network(('2001:db8::', 128))
+                IPv6Network((0x20010db8 << 96, 128))
+                IPv6Network((IPv6Address('2001:db8::'), 128))
+
+            strict: A boolean. If true, ensure that we have been passed
+              A true network address, eg, 2001:db8::/32 and not an
+              IP address on a network, eg, 2001:db8::1/32.
+
+        Raises:
+            AddressValueError: If address isn't a valid IPv6 address.
+            NetmaskValueError: If the netmask isn't valid for
+              an IPv6 address.
+            ValueError: If strict was True and a network address was not
+              supplied.
+
+        """
+        _BaseNet.__init__(self, address)
+        _BaseV6.__init__(self, address)
+
+        # Constructing from a single IP address.
+        if isinstance(address, (int, long, Bytes, IPv6Address)):
+            self.ip = IPv6Address(address)
+            self._ip = self.ip._ip
+            self._prefixlen = self._max_prefixlen
+            self.netmask = IPv6Address(self._ALL_ONES)
+            return
+
+        # Constructing from an (ip, prefixlen) tuple.
+        if isinstance(address, tuple):
+            try:
+                ip, prefixlen = address
+            except ValueError:
+                raise AddressValueError(address)
+            self.ip = IPv6Address(ip)
+            self._ip = self.ip._ip
+            self._prefixlen = self._prefix_from_prefix_int(prefixlen)
+
+        else:
+            # Assume input argument to be string or any object representation
+            # which converts into a formatted IP prefix string.
+            addr = str(address).split('/')
+
+            if len(addr) > 2:
+                raise AddressValueError(address)
+
+            self._ip = self._ip_int_from_string(addr[0])
+            self.ip = IPv6Address(self._ip)
+
+            if len(addr) == 2:
+                # This may raise NetmaskValueError
+                self._prefixlen = self._prefix_from_prefix_string(addr[1])
+            else:
+                self._prefixlen = self._max_prefixlen
+
+        self.netmask = IPv6Address(self._ip_int_from_prefix(self._prefixlen))
+
+        if strict:
+            if self.ip != self.network:
+                raise ValueError('%s has host bits set' %
+                                 self.ip)
+        if self._prefixlen == (self._max_prefixlen - 1):
+            self.iterhosts = self.__iter__
+
+    @property
+    def with_netmask(self):
+        return self.with_prefixlen
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1229ba4275a0549e01dd6e7b10e1ccf17f17389f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/__init__.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+"""Jinja is a template engine written in pure Python. It provides a
+non-XML syntax that supports inline expressions and an optional
+sandboxed environment.
+"""
+from markupsafe import escape
+from markupsafe import Markup
+
+from .bccache import BytecodeCache
+from .bccache import FileSystemBytecodeCache
+from .bccache import MemcachedBytecodeCache
+from .environment import Environment
+from .environment import Template
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateError
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .filters import contextfilter
+from .filters import environmentfilter
+from .filters import evalcontextfilter
+from .loaders import BaseLoader
+from .loaders import ChoiceLoader
+from .loaders import DictLoader
+from .loaders import FileSystemLoader
+from .loaders import FunctionLoader
+from .loaders import ModuleLoader
+from .loaders import PackageLoader
+from .loaders import PrefixLoader
+from .runtime import ChainableUndefined
+from .runtime import DebugUndefined
+from .runtime import make_logging_undefined
+from .runtime import StrictUndefined
+from .runtime import Undefined
+from .utils import clear_caches
+from .utils import contextfunction
+from .utils import environmentfunction
+from .utils import evalcontextfunction
+from .utils import is_undefined
+from .utils import select_autoescape
+
+__version__ = "2.11.2"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f044954a02933bcec2277fcdd575821bc18a99a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_compat.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+# flake8: noqa
+import marshal
+import sys
+
+PY2 = sys.version_info[0] == 2
+PYPY = hasattr(sys, "pypy_translation_info")
+_identity = lambda x: x
+
+if not PY2:
+    unichr = chr
+    range_type = range
+    text_type = str
+    string_types = (str,)
+    integer_types = (int,)
+
+    iterkeys = lambda d: iter(d.keys())
+    itervalues = lambda d: iter(d.values())
+    iteritems = lambda d: iter(d.items())
+
+    import pickle
+    from io import BytesIO, StringIO
+
+    NativeStringIO = StringIO
+
+    def reraise(tp, value, tb=None):
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+
+    ifilter = filter
+    imap = map
+    izip = zip
+    intern = sys.intern
+
+    implements_iterator = _identity
+    implements_to_string = _identity
+    encode_filename = _identity
+
+    marshal_dump = marshal.dump
+    marshal_load = marshal.load
+
+else:
+    unichr = unichr
+    text_type = unicode
+    range_type = xrange
+    string_types = (str, unicode)
+    integer_types = (int, long)
+
+    iterkeys = lambda d: d.iterkeys()
+    itervalues = lambda d: d.itervalues()
+    iteritems = lambda d: d.iteritems()
+
+    import cPickle as pickle
+    from cStringIO import StringIO as BytesIO, StringIO
+
+    NativeStringIO = BytesIO
+
+    exec("def reraise(tp, value, tb=None):\n raise tp, value, tb")
+
+    from itertools import imap, izip, ifilter
+
+    intern = intern
+
+    def implements_iterator(cls):
+        cls.next = cls.__next__
+        del cls.__next__
+        return cls
+
+    def implements_to_string(cls):
+        cls.__unicode__ = cls.__str__
+        cls.__str__ = lambda x: x.__unicode__().encode("utf-8")
+        return cls
+
+    def encode_filename(filename):
+        if isinstance(filename, unicode):
+            return filename.encode("utf-8")
+        return filename
+
+    def marshal_dump(code, f):
+        if isinstance(f, file):
+            marshal.dump(code, f)
+        else:
+            f.write(marshal.dumps(code))
+
+    def marshal_load(f):
+        if isinstance(f, file):
+            return marshal.load(f)
+        return marshal.loads(f.read())
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a
+    # dummy metaclass for one level of class instantiation that replaces
+    # itself with the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+try:
+    from urllib.parse import quote_from_bytes as url_quote
+except ImportError:
+    from urllib import quote as url_quote
+
+
+try:
+    from collections import abc
+except ImportError:
+    import collections as abc
+
+
+try:
+    from os import fspath
+except ImportError:
+    try:
+        from pathlib import PurePath
+    except ImportError:
+        PurePath = None
+
+    def fspath(path):
+        if hasattr(path, "__fspath__"):
+            return path.__fspath__()
+
+        # Python 3.5 doesn't have __fspath__ yet, use str.
+        if PurePath is not None and isinstance(path, PurePath):
+            return str(path)
+
+        return path
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_identifier.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_identifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..224d5449d138e75f4f3c25d70cb8f1ea54ccd047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/_identifier.py
@@ -0,0 +1,6 @@
+import re
+
+# generated by scripts/generate_identifier_pattern.py
+pattern = re.compile(
+    r"[\w·̀-ͯ·҃-֑҇-ׇֽֿׁׂׅׄؐ-ًؚ-ٰٟۖ-ۜ۟-۪ۤۧۨ-ܑۭܰ-݊ަ-ް߫-߳ࠖ-࠙ࠛ-ࠣࠥ-ࠧࠩ-࡙࠭-࡛ࣔ-ࣣ࣡-ःऺ-़ा-ॏ॑-ॗॢॣঁ-ঃ়া-ৄেৈো-্ৗৢৣਁ-ਃ਼ਾ-ੂੇੈੋ-੍ੑੰੱੵઁ-ઃ઼ા-ૅે-ૉો-્ૢૣଁ-ଃ଼ା-ୄେୈୋ-୍ୖୗୢୣஂா-ூெ-ைொ-்ௗఀ-ఃా-ౄె-ైొ-్ౕౖౢౣಁ-ಃ಼ಾ-ೄೆ-ೈೊ-್ೕೖೢೣഁ-ഃാ-ൄെ-ൈൊ-്ൗൢൣංඃ්ා-ුූෘ-ෟෲෳัิ-ฺ็-๎ັິ-ູົຼ່-ໍ༹༘༙༵༷༾༿ཱ-྄྆྇ྍ-ྗྙ-ྼ࿆ါ-ှၖ-ၙၞ-ၠၢ-ၤၧ-ၭၱ-ၴႂ-ႍႏႚ-ႝ፝-፟ᜒ-᜔ᜲ-᜴ᝒᝓᝲᝳ឴-៓៝᠋-᠍ᢅᢆᢩᤠ-ᤫᤰ-᤻ᨗ-ᨛᩕ-ᩞ᩠-᩿᩼᪰-᪽ᬀ-ᬄ᬴-᭄᭫-᭳ᮀ-ᮂᮡ-ᮭ᯦-᯳ᰤ-᰷᳐-᳔᳒-᳨᳭ᳲ-᳴᳸᳹᷀-᷵᷻-᷿‿⁀⁔⃐-⃥⃜⃡-⃰℘℮⳯-⵿⳱ⷠ-〪ⷿ-゙゚〯꙯ꙴ-꙽ꚞꚟ꛰꛱ꠂ꠆ꠋꠣ-ꠧꢀꢁꢴ-ꣅ꣠-꣱ꤦ-꤭ꥇ-꥓ꦀ-ꦃ꦳-꧀ꧥꨩ-ꨶꩃꩌꩍꩻ-ꩽꪰꪲ-ꪴꪷꪸꪾ꪿꫁ꫫ-ꫯꫵ꫶ꯣ-ꯪ꯬꯭ﬞ︀-️︠-︯︳︴﹍-﹏＿𐇽𐋠𐍶-𐍺𐨁-𐨃𐨅𐨆𐨌-𐨏𐨸-𐨿𐨺𐫦𐫥𑀀-𑀂𑀸-𑁆𑁿-𑂂𑂰-𑂺𑄀-𑄂𑄧-𑅳𑄴𑆀-𑆂𑆳-𑇊𑇀-𑇌𑈬-𑈷𑈾𑋟-𑋪𑌀-𑌃𑌼𑌾-𑍄𑍇𑍈𑍋-𑍍𑍗𑍢𑍣𑍦-𑍬𑍰-𑍴𑐵-𑑆𑒰-𑓃𑖯-𑖵𑖸-𑗀𑗜𑗝𑘰-𑙀𑚫-𑚷𑜝-𑜫𑰯-𑰶𑰸-𑰿𑲒-𑲧𑲩-𑲶𖫰-𖫴𖬰-𖬶𖽑-𖽾𖾏-𖾒𛲝𛲞𝅥-𝅩𝅭-𝅲𝅻-𝆂𝆅-𝆋𝆪-𝆭𝉂-𝉄𝨀-𝨶𝨻-𝩬𝩵𝪄𝪛-𝪟𝪡-𝪯𞀀-𞀆𞀈-𞀘𞀛-𞀡𞀣𞀤𞀦-𞣐𞀪-𞣖𞥄-𞥊󠄀-󠇯]+"  # noqa: B950
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncfilters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncfilters.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d98dbcc00de104a584b0707df8f0d4e8bbe1376
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncfilters.py
@@ -0,0 +1,158 @@
+from functools import wraps
+
+from . import filters
+from .asyncsupport import auto_aiter
+from .asyncsupport import auto_await
+
+
+async def auto_to_seq(value):
+    seq = []
+    if hasattr(value, "__aiter__"):
+        async for item in value:
+            seq.append(item)
+    else:
+        for item in value:
+            seq.append(item)
+    return seq
+
+
+async def async_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = filters.prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        async for item in auto_aiter(seq):
+            if func(item):
+                yield item
+
+
+def dualfilter(normal_filter, async_filter):
+    wrap_evalctx = False
+    if getattr(normal_filter, "environmentfilter", False) is True:
+
+        def is_async(args):
+            return args[0].is_async
+
+        wrap_evalctx = False
+    else:
+        has_evalctxfilter = getattr(normal_filter, "evalcontextfilter", False) is True
+        has_ctxfilter = getattr(normal_filter, "contextfilter", False) is True
+        wrap_evalctx = not has_evalctxfilter and not has_ctxfilter
+
+        def is_async(args):
+            return args[0].environment.is_async
+
+    @wraps(normal_filter)
+    def wrapper(*args, **kwargs):
+        b = is_async(args)
+        if wrap_evalctx:
+            args = args[1:]
+        if b:
+            return async_filter(*args, **kwargs)
+        return normal_filter(*args, **kwargs)
+
+    if wrap_evalctx:
+        wrapper.evalcontextfilter = True
+
+    wrapper.asyncfiltervariant = True
+
+    return wrapper
+
+
+def asyncfiltervariant(original):
+    def decorator(f):
+        return dualfilter(original, f)
+
+    return decorator
+
+
+@asyncfiltervariant(filters.do_first)
+async def do_first(environment, seq):
+    try:
+        return await auto_aiter(seq).__anext__()
+    except StopAsyncIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@asyncfiltervariant(filters.do_groupby)
+async def do_groupby(environment, value, attribute):
+    expr = filters.make_attrgetter(environment, attribute)
+    return [
+        filters._GroupTuple(key, await auto_to_seq(values))
+        for key, values in filters.groupby(
+            sorted(await auto_to_seq(value), key=expr), expr
+        )
+    ]
+
+
+@asyncfiltervariant(filters.do_join)
+async def do_join(eval_ctx, value, d=u"", attribute=None):
+    return filters.do_join(eval_ctx, await auto_to_seq(value), d, attribute)
+
+
+@asyncfiltervariant(filters.do_list)
+async def do_list(value):
+    return await auto_to_seq(value)
+
+
+@asyncfiltervariant(filters.do_reject)
+async def do_reject(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@asyncfiltervariant(filters.do_rejectattr)
+async def do_rejectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@asyncfiltervariant(filters.do_select)
+async def do_select(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@asyncfiltervariant(filters.do_selectattr)
+async def do_selectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@asyncfiltervariant(filters.do_map)
+async def do_map(*args, **kwargs):
+    seq, func = filters.prepare_map(args, kwargs)
+    if seq:
+        async for item in auto_aiter(seq):
+            yield await auto_await(func(item))
+
+
+@asyncfiltervariant(filters.do_sum)
+async def do_sum(environment, iterable, attribute=None, start=0):
+    rv = start
+    if attribute is not None:
+        func = filters.make_attrgetter(environment, attribute)
+    else:
+
+        def func(x):
+            return x
+
+    async for item in auto_aiter(iterable):
+        rv += func(item)
+    return rv
+
+
+@asyncfiltervariant(filters.do_slice)
+async def do_slice(value, slices, fill_with=None):
+    return filters.do_slice(await auto_to_seq(value), slices, fill_with)
+
+
+ASYNC_FILTERS = {
+    "first": do_first,
+    "groupby": do_groupby,
+    "join": do_join,
+    "list": do_list,
+    # we intentionally do not support do_last because that would be
+    # ridiculous
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "map": do_map,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "sum": do_sum,
+    "slice": do_slice,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncsupport.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncsupport.py
new file mode 100644
index 0000000000000000000000000000000000000000..78ba3739d8dee1e644f96e32f833279d941c3f65
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/asyncsupport.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""The code for async support. Importing this patches Jinja on supported
+Python versions.
+"""
+import asyncio
+import inspect
+from functools import update_wrapper
+
+from markupsafe import Markup
+
+from .environment import TemplateModule
+from .runtime import LoopContext
+from .utils import concat
+from .utils import internalcode
+from .utils import missing
+
+
+async def concat_async(async_gen):
+    rv = []
+
+    async def collect():
+        async for event in async_gen:
+            rv.append(event)
+
+    await collect()
+    return concat(rv)
+
+
+async def generate_async(self, *args, **kwargs):
+    vars = dict(*args, **kwargs)
+    try:
+        async for event in self.root_render_func(self.new_context(vars)):
+            yield event
+    except Exception:
+        yield self.environment.handle_exception()
+
+
+def wrap_generate_func(original_generate):
+    def _convert_generator(self, loop, args, kwargs):
+        async_gen = self.generate_async(*args, **kwargs)
+        try:
+            while 1:
+                yield loop.run_until_complete(async_gen.__anext__())
+        except StopAsyncIteration:
+            pass
+
+    def generate(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_generate(self, *args, **kwargs)
+        return _convert_generator(self, asyncio.get_event_loop(), args, kwargs)
+
+    return update_wrapper(generate, original_generate)
+
+
+async def render_async(self, *args, **kwargs):
+    if not self.environment.is_async:
+        raise RuntimeError("The environment was not created with async mode enabled.")
+
+    vars = dict(*args, **kwargs)
+    ctx = self.new_context(vars)
+
+    try:
+        return await concat_async(self.root_render_func(ctx))
+    except Exception:
+        return self.environment.handle_exception()
+
+
+def wrap_render_func(original_render):
+    def render(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_render(self, *args, **kwargs)
+        loop = asyncio.get_event_loop()
+        return loop.run_until_complete(self.render_async(*args, **kwargs))
+
+    return update_wrapper(render, original_render)
+
+
+def wrap_block_reference_call(original_call):
+    @internalcode
+    async def async_call(self):
+        rv = await concat_async(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def __call__(self):
+        if not self._context.environment.is_async:
+            return original_call(self)
+        return async_call(self)
+
+    return update_wrapper(__call__, original_call)
+
+
+def wrap_macro_invoke(original_invoke):
+    @internalcode
+    async def async_invoke(self, arguments, autoescape):
+        rv = await self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def _invoke(self, arguments, autoescape):
+        if not self._environment.is_async:
+            return original_invoke(self, arguments, autoescape)
+        return async_invoke(self, arguments, autoescape)
+
+    return update_wrapper(_invoke, original_invoke)
+
+
+@internalcode
+async def get_default_module_async(self):
+    if self._module is not None:
+        return self._module
+    self._module = rv = await self.make_module_async()
+    return rv
+
+
+def wrap_default_module(original_default_module):
+    @internalcode
+    def _get_default_module(self):
+        if self.environment.is_async:
+            raise RuntimeError("Template module attribute is unavailable in async mode")
+        return original_default_module(self)
+
+    return _get_default_module
+
+
+async def make_module_async(self, vars=None, shared=False, locals=None):
+    context = self.new_context(vars, shared, locals)
+    body_stream = []
+    async for item in self.root_render_func(context):
+        body_stream.append(item)
+    return TemplateModule(self, context, body_stream)
+
+
+def patch_template():
+    from . import Template
+
+    Template.generate = wrap_generate_func(Template.generate)
+    Template.generate_async = update_wrapper(generate_async, Template.generate_async)
+    Template.render_async = update_wrapper(render_async, Template.render_async)
+    Template.render = wrap_render_func(Template.render)
+    Template._get_default_module = wrap_default_module(Template._get_default_module)
+    Template._get_default_module_async = get_default_module_async
+    Template.make_module_async = update_wrapper(
+        make_module_async, Template.make_module_async
+    )
+
+
+def patch_runtime():
+    from .runtime import BlockReference, Macro
+
+    BlockReference.__call__ = wrap_block_reference_call(BlockReference.__call__)
+    Macro._invoke = wrap_macro_invoke(Macro._invoke)
+
+
+def patch_filters():
+    from .filters import FILTERS
+    from .asyncfilters import ASYNC_FILTERS
+
+    FILTERS.update(ASYNC_FILTERS)
+
+
+def patch_all():
+    patch_template()
+    patch_runtime()
+    patch_filters()
+
+
+async def auto_await(value):
+    if inspect.isawaitable(value):
+        return await value
+    return value
+
+
+async def auto_aiter(iterable):
+    if hasattr(iterable, "__aiter__"):
+        async for item in iterable:
+            yield item
+        return
+    for item in iterable:
+        yield item
+
+
+class AsyncLoopContext(LoopContext):
+    _to_iterator = staticmethod(auto_aiter)
+
+    @property
+    async def length(self):
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = [x async for x in self._iterator]
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    @property
+    async def revindex0(self):
+        return await self.length - self.index
+
+    @property
+    async def revindex(self):
+        return await self.length - self.index0
+
+    async def _peek_next(self):
+        if self._after is not missing:
+            return self._after
+
+        try:
+            self._after = await self._iterator.__anext__()
+        except StopAsyncIteration:
+            self._after = missing
+
+        return self._after
+
+    @property
+    async def last(self):
+        return await self._peek_next() is missing
+
+    @property
+    async def nextitem(self):
+        rv = await self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def __aiter__(self):
+        return self
+
+    async def __anext__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = await self._iterator.__anext__()
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+
+async def make_async_loop_context(iterable, undefined, recurse=None, depth0=0):
+    import warnings
+
+    warnings.warn(
+        "This template must be recompiled with at least Jinja 2.11, or"
+        " it will fail in 3.0.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return AsyncLoopContext(iterable, undefined, recurse, depth0)
+
+
+patch_all()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/bccache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/bccache.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c0661030f7af4b2b186b1726341c910194b7cbd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/bccache.py
@@ -0,0 +1,350 @@
+# -*- coding: utf-8 -*-
+"""The optional bytecode cache system. This is useful if you have very
+complex template situations and the compilation of all those templates
+slows down your application too much.
+
+Situations where this is useful are often forking web applications that
+are initialized on the first request.
+"""
+import errno
+import fnmatch
+import os
+import stat
+import sys
+import tempfile
+from hashlib import sha1
+from os import listdir
+from os import path
+
+from ._compat import BytesIO
+from ._compat import marshal_dump
+from ._compat import marshal_load
+from ._compat import pickle
+from ._compat import text_type
+from .utils import open_if_exists
+
+bc_version = 4
+# Magic bytes to identify Jinja bytecode cache files. Contains the
+# Python major and minor version to avoid loading incompatible bytecode
+# if a project upgrades its Python version.
+bc_magic = (
+    b"j2"
+    + pickle.dumps(bc_version, 2)
+    + pickle.dumps((sys.version_info[0] << 24) | sys.version_info[1], 2)
+)
+
+
+class Bucket(object):
+    """Buckets are used to store the bytecode for one template.  It's created
+    and initialized by the bytecode cache and passed to the loading functions.
+
+    The buckets get an internal checksum from the cache assigned and use this
+    to automatically reject outdated cache material.  Individual bytecode
+    cache subclasses don't have to care about cache invalidation.
+    """
+
+    def __init__(self, environment, key, checksum):
+        self.environment = environment
+        self.key = key
+        self.checksum = checksum
+        self.reset()
+
+    def reset(self):
+        """Resets the bucket (unloads the bytecode)."""
+        self.code = None
+
+    def load_bytecode(self, f):
+        """Loads bytecode from a file or file like object."""
+        # make sure the magic header is correct
+        magic = f.read(len(bc_magic))
+        if magic != bc_magic:
+            self.reset()
+            return
+        # the source code of the file changed, we need to reload
+        checksum = pickle.load(f)
+        if self.checksum != checksum:
+            self.reset()
+            return
+        # if marshal_load fails then we need to reload
+        try:
+            self.code = marshal_load(f)
+        except (EOFError, ValueError, TypeError):
+            self.reset()
+            return
+
+    def write_bytecode(self, f):
+        """Dump the bytecode into the file or file like object passed."""
+        if self.code is None:
+            raise TypeError("can't write empty bucket")
+        f.write(bc_magic)
+        pickle.dump(self.checksum, f, 2)
+        marshal_dump(self.code, f)
+
+    def bytecode_from_string(self, string):
+        """Load bytecode from a string."""
+        self.load_bytecode(BytesIO(string))
+
+    def bytecode_to_string(self):
+        """Return the bytecode as string."""
+        out = BytesIO()
+        self.write_bytecode(out)
+        return out.getvalue()
+
+
+class BytecodeCache(object):
+    """To implement your own bytecode cache you have to subclass this class
+    and override :meth:`load_bytecode` and :meth:`dump_bytecode`.  Both of
+    these methods are passed a :class:`~jinja2.bccache.Bucket`.
+
+    A very basic bytecode cache that saves the bytecode on the file system::
+
+        from os import path
+
+        class MyCache(BytecodeCache):
+
+            def __init__(self, directory):
+                self.directory = directory
+
+            def load_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                if path.exists(filename):
+                    with open(filename, 'rb') as f:
+                        bucket.load_bytecode(f)
+
+            def dump_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                with open(filename, 'wb') as f:
+                    bucket.write_bytecode(f)
+
+    A more advanced version of a filesystem based bytecode cache is part of
+    Jinja.
+    """
+
+    def load_bytecode(self, bucket):
+        """Subclasses have to override this method to load bytecode into a
+        bucket.  If they are not able to find code in the cache for the
+        bucket, it must not do anything.
+        """
+        raise NotImplementedError()
+
+    def dump_bytecode(self, bucket):
+        """Subclasses have to override this method to write the bytecode
+        from a bucket back to the cache.  If it unable to do so it must not
+        fail silently but raise an exception.
+        """
+        raise NotImplementedError()
+
+    def clear(self):
+        """Clears the cache.  This method is not used by Jinja but should be
+        implemented to allow applications to clear the bytecode cache used
+        by a particular environment.
+        """
+
+    def get_cache_key(self, name, filename=None):
+        """Returns the unique hash key for this template name."""
+        hash = sha1(name.encode("utf-8"))
+        if filename is not None:
+            filename = "|" + filename
+            if isinstance(filename, text_type):
+                filename = filename.encode("utf-8")
+            hash.update(filename)
+        return hash.hexdigest()
+
+    def get_source_checksum(self, source):
+        """Returns a checksum for the source."""
+        return sha1(source.encode("utf-8")).hexdigest()
+
+    def get_bucket(self, environment, name, filename, source):
+        """Return a cache bucket for the given template.  All arguments are
+        mandatory but filename may be `None`.
+        """
+        key = self.get_cache_key(name, filename)
+        checksum = self.get_source_checksum(source)
+        bucket = Bucket(environment, key, checksum)
+        self.load_bytecode(bucket)
+        return bucket
+
+    def set_bucket(self, bucket):
+        """Put the bucket into the cache."""
+        self.dump_bytecode(bucket)
+
+
+class FileSystemBytecodeCache(BytecodeCache):
+    """A bytecode cache that stores bytecode on the filesystem.  It accepts
+    two arguments: The directory where the cache items are stored and a
+    pattern string that is used to build the filename.
+
+    If no directory is specified a default cache directory is selected.  On
+    Windows the user's temp directory is used, on UNIX systems a directory
+    is created for the user in the system temp directory.
+
+    The pattern can be used to have multiple separate caches operate on the
+    same directory.  The default pattern is ``'__jinja2_%s.cache'``.  ``%s``
+    is replaced with the cache key.
+
+    >>> bcc = FileSystemBytecodeCache('/tmp/jinja_cache', '%s.cache')
+
+    This bytecode cache supports clearing of the cache using the clear method.
+    """
+
+    def __init__(self, directory=None, pattern="__jinja2_%s.cache"):
+        if directory is None:
+            directory = self._get_default_cache_dir()
+        self.directory = directory
+        self.pattern = pattern
+
+    def _get_default_cache_dir(self):
+        def _unsafe_dir():
+            raise RuntimeError(
+                "Cannot determine safe temp directory.  You "
+                "need to explicitly provide one."
+            )
+
+        tmpdir = tempfile.gettempdir()
+
+        # On windows the temporary directory is used specific unless
+        # explicitly forced otherwise.  We can just use that.
+        if os.name == "nt":
+            return tmpdir
+        if not hasattr(os, "getuid"):
+            _unsafe_dir()
+
+        dirname = "_jinja2-cache-%d" % os.getuid()
+        actual_dir = os.path.join(tmpdir, dirname)
+
+        try:
+            os.mkdir(actual_dir, stat.S_IRWXU)
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+        try:
+            os.chmod(actual_dir, stat.S_IRWXU)
+            actual_dir_stat = os.lstat(actual_dir)
+            if (
+                actual_dir_stat.st_uid != os.getuid()
+                or not stat.S_ISDIR(actual_dir_stat.st_mode)
+                or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+            ):
+                _unsafe_dir()
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+
+        actual_dir_stat = os.lstat(actual_dir)
+        if (
+            actual_dir_stat.st_uid != os.getuid()
+            or not stat.S_ISDIR(actual_dir_stat.st_mode)
+            or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+        ):
+            _unsafe_dir()
+
+        return actual_dir
+
+    def _get_cache_filename(self, bucket):
+        return path.join(self.directory, self.pattern % bucket.key)
+
+    def load_bytecode(self, bucket):
+        f = open_if_exists(self._get_cache_filename(bucket), "rb")
+        if f is not None:
+            try:
+                bucket.load_bytecode(f)
+            finally:
+                f.close()
+
+    def dump_bytecode(self, bucket):
+        f = open(self._get_cache_filename(bucket), "wb")
+        try:
+            bucket.write_bytecode(f)
+        finally:
+            f.close()
+
+    def clear(self):
+        # imported lazily here because google app-engine doesn't support
+        # write access on the file system and the function does not exist
+        # normally.
+        from os import remove
+
+        files = fnmatch.filter(listdir(self.directory), self.pattern % "*")
+        for filename in files:
+            try:
+                remove(path.join(self.directory, filename))
+            except OSError:
+                pass
+
+
+class MemcachedBytecodeCache(BytecodeCache):
+    """This class implements a bytecode cache that uses a memcache cache for
+    storing the information.  It does not enforce a specific memcache library
+    (tummy's memcache or cmemcache) but will accept any class that provides
+    the minimal interface required.
+
+    Libraries compatible with this class:
+
+    -   `cachelib <https://github.com/pallets/cachelib>`_
+    -   `python-memcached <https://pypi.org/project/python-memcached/>`_
+
+    (Unfortunately the django cache interface is not compatible because it
+    does not support storing binary data, only unicode.  You can however pass
+    the underlying cache client to the bytecode cache which is available
+    as `django.core.cache.cache._client`.)
+
+    The minimal interface for the client passed to the constructor is this:
+
+    .. class:: MinimalClientInterface
+
+        .. method:: set(key, value[, timeout])
+
+            Stores the bytecode in the cache.  `value` is a string and
+            `timeout` the timeout of the key.  If timeout is not provided
+            a default timeout or no timeout should be assumed, if it's
+            provided it's an integer with the number of seconds the cache
+            item should exist.
+
+        .. method:: get(key)
+
+            Returns the value for the cache key.  If the item does not
+            exist in the cache the return value must be `None`.
+
+    The other arguments to the constructor are the prefix for all keys that
+    is added before the actual cache key and the timeout for the bytecode in
+    the cache system.  We recommend a high (or no) timeout.
+
+    This bytecode cache does not support clearing of used items in the cache.
+    The clear method is a no-operation function.
+
+    .. versionadded:: 2.7
+       Added support for ignoring memcache errors through the
+       `ignore_memcache_errors` parameter.
+    """
+
+    def __init__(
+        self,
+        client,
+        prefix="jinja2/bytecode/",
+        timeout=None,
+        ignore_memcache_errors=True,
+    ):
+        self.client = client
+        self.prefix = prefix
+        self.timeout = timeout
+        self.ignore_memcache_errors = ignore_memcache_errors
+
+    def load_bytecode(self, bucket):
+        try:
+            code = self.client.get(self.prefix + bucket.key)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
+            code = None
+        if code is not None:
+            bucket.bytecode_from_string(code)
+
+    def dump_bytecode(self, bucket):
+        args = (self.prefix + bucket.key, bucket.bytecode_to_string())
+        if self.timeout is not None:
+            args += (self.timeout,)
+        try:
+            self.client.set(*args)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/compiler.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..63297b42c30f17b0c0ae08547047d070e7a53d3c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/compiler.py
@@ -0,0 +1,1843 @@
+# -*- coding: utf-8 -*-
+"""Compiles nodes from the parser into Python code."""
+from collections import namedtuple
+from functools import update_wrapper
+from itertools import chain
+from keyword import iskeyword as is_python_keyword
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import izip
+from ._compat import NativeStringIO
+from ._compat import range_type
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import TemplateAssertionError
+from .idtracking import Symbols
+from .idtracking import VAR_LOAD_ALIAS
+from .idtracking import VAR_LOAD_PARAMETER
+from .idtracking import VAR_LOAD_RESOLVE
+from .idtracking import VAR_LOAD_UNDEFINED
+from .nodes import EvalContext
+from .optimizer import Optimizer
+from .utils import concat
+from .visitor import NodeVisitor
+
+operators = {
+    "eq": "==",
+    "ne": "!=",
+    "gt": ">",
+    "gteq": ">=",
+    "lt": "<",
+    "lteq": "<=",
+    "in": "in",
+    "notin": "not in",
+}
+
+# what method to iterate over items do we want to use for dict iteration
+# in generated code?  on 2.x let's go with iteritems, on 3.x with items
+if hasattr(dict, "iteritems"):
+    dict_item_iter = "iteritems"
+else:
+    dict_item_iter = "items"
+
+code_features = ["division"]
+
+# does this python version support generator stops? (PEP 0479)
+try:
+    exec("from __future__ import generator_stop")
+    code_features.append("generator_stop")
+except SyntaxError:
+    pass
+
+# does this python version support yield from?
+try:
+    exec("def f(): yield from x()")
+except SyntaxError:
+    supports_yield_from = False
+else:
+    supports_yield_from = True
+
+
+def optimizeconst(f):
+    def new_func(self, node, frame, **kwargs):
+        # Only optimize if the frame is not volatile
+        if self.optimized and not frame.eval_ctx.volatile:
+            new_node = self.optimizer.visit(node, frame.eval_ctx)
+            if new_node != node:
+                return self.visit(new_node, frame)
+        return f(self, node, frame, **kwargs)
+
+    return update_wrapper(new_func, f)
+
+
+def generate(
+    node, environment, name, filename, stream=None, defer_init=False, optimized=True
+):
+    """Generate the python source for a node tree."""
+    if not isinstance(node, nodes.Template):
+        raise TypeError("Can't compile non template nodes")
+    generator = environment.code_generator_class(
+        environment, name, filename, stream, defer_init, optimized
+    )
+    generator.visit(node)
+    if stream is None:
+        return generator.stream.getvalue()
+
+
+def has_safe_repr(value):
+    """Does the node have a safe representation?"""
+    if value is None or value is NotImplemented or value is Ellipsis:
+        return True
+    if type(value) in (bool, int, float, complex, range_type, Markup) + string_types:
+        return True
+    if type(value) in (tuple, list, set, frozenset):
+        for item in value:
+            if not has_safe_repr(item):
+                return False
+        return True
+    elif type(value) is dict:
+        for key, value in iteritems(value):
+            if not has_safe_repr(key):
+                return False
+            if not has_safe_repr(value):
+                return False
+        return True
+    return False
+
+
+def find_undeclared(nodes, names):
+    """Check if the names passed are accessed undeclared.  The return value
+    is a set of all the undeclared names from the sequence of names found.
+    """
+    visitor = UndeclaredNameVisitor(names)
+    try:
+        for node in nodes:
+            visitor.visit(node)
+    except VisitorExit:
+        pass
+    return visitor.undeclared
+
+
+class MacroRef(object):
+    def __init__(self, node):
+        self.node = node
+        self.accesses_caller = False
+        self.accesses_kwargs = False
+        self.accesses_varargs = False
+
+
+class Frame(object):
+    """Holds compile time information for us."""
+
+    def __init__(self, eval_ctx, parent=None, level=None):
+        self.eval_ctx = eval_ctx
+        self.symbols = Symbols(parent and parent.symbols or None, level=level)
+
+        # a toplevel frame is the root + soft frames such as if conditions.
+        self.toplevel = False
+
+        # the root frame is basically just the outermost frame, so no if
+        # conditions.  This information is used to optimize inheritance
+        # situations.
+        self.rootlevel = False
+
+        # in some dynamic inheritance situations the compiler needs to add
+        # write tests around output statements.
+        self.require_output_check = parent and parent.require_output_check
+
+        # inside some tags we are using a buffer rather than yield statements.
+        # this for example affects {% filter %} or {% macro %}.  If a frame
+        # is buffered this variable points to the name of the list used as
+        # buffer.
+        self.buffer = None
+
+        # the name of the block we're in, otherwise None.
+        self.block = parent and parent.block or None
+
+        # the parent of this frame
+        self.parent = parent
+
+        if parent is not None:
+            self.buffer = parent.buffer
+
+    def copy(self):
+        """Create a copy of the current one."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.symbols = self.symbols.copy()
+        return rv
+
+    def inner(self, isolated=False):
+        """Return an inner frame."""
+        if isolated:
+            return Frame(self.eval_ctx, level=self.symbols.level + 1)
+        return Frame(self.eval_ctx, self)
+
+    def soft(self):
+        """Return a soft frame.  A soft frame may not be modified as
+        standalone thing as it shares the resources with the frame it
+        was created of, but it's not a rootlevel frame any longer.
+
+        This is only used to implement if-statements.
+        """
+        rv = self.copy()
+        rv.rootlevel = False
+        return rv
+
+    __copy__ = copy
+
+
+class VisitorExit(RuntimeError):
+    """Exception used by the `UndeclaredNameVisitor` to signal a stop."""
+
+
+class DependencyFinderVisitor(NodeVisitor):
+    """A visitor that collects filter and test calls."""
+
+    def __init__(self):
+        self.filters = set()
+        self.tests = set()
+
+    def visit_Filter(self, node):
+        self.generic_visit(node)
+        self.filters.add(node.name)
+
+    def visit_Test(self, node):
+        self.generic_visit(node)
+        self.tests.add(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting at blocks."""
+
+
+class UndeclaredNameVisitor(NodeVisitor):
+    """A visitor that checks if a name is accessed without being
+    declared.  This is different from the frame visitor as it will
+    not stop at closure frames.
+    """
+
+    def __init__(self, names):
+        self.names = set(names)
+        self.undeclared = set()
+
+    def visit_Name(self, node):
+        if node.ctx == "load" and node.name in self.names:
+            self.undeclared.add(node.name)
+            if self.undeclared == self.names:
+                raise VisitorExit()
+        else:
+            self.names.discard(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting a blocks."""
+
+
+class CompilerExit(Exception):
+    """Raised if the compiler encountered a situation where it just
+    doesn't make sense to further process the code.  Any block that
+    raises such an exception is not further processed.
+    """
+
+
+class CodeGenerator(NodeVisitor):
+    def __init__(
+        self, environment, name, filename, stream=None, defer_init=False, optimized=True
+    ):
+        if stream is None:
+            stream = NativeStringIO()
+        self.environment = environment
+        self.name = name
+        self.filename = filename
+        self.stream = stream
+        self.created_block_context = False
+        self.defer_init = defer_init
+        self.optimized = optimized
+        if optimized:
+            self.optimizer = Optimizer(environment)
+
+        # aliases for imports
+        self.import_aliases = {}
+
+        # a registry for all blocks.  Because blocks are moved out
+        # into the global python scope they are registered here
+        self.blocks = {}
+
+        # the number of extends statements so far
+        self.extends_so_far = 0
+
+        # some templates have a rootlevel extends.  In this case we
+        # can safely assume that we're a child template and do some
+        # more optimizations.
+        self.has_known_extends = False
+
+        # the current line number
+        self.code_lineno = 1
+
+        # registry of all filters and tests (global, not block local)
+        self.tests = {}
+        self.filters = {}
+
+        # the debug information
+        self.debug_info = []
+        self._write_debug_info = None
+
+        # the number of new lines before the next write()
+        self._new_lines = 0
+
+        # the line number of the last written statement
+        self._last_line = 0
+
+        # true if nothing was written so far.
+        self._first_write = True
+
+        # used by the `temporary_identifier` method to get new
+        # unique, temporary identifier
+        self._last_identifier = 0
+
+        # the current indentation
+        self._indentation = 0
+
+        # Tracks toplevel assignments
+        self._assign_stack = []
+
+        # Tracks parameter definition blocks
+        self._param_def_block = []
+
+        # Tracks the current context.
+        self._context_reference_stack = ["context"]
+
+    # -- Various compilation helpers
+
+    def fail(self, msg, lineno):
+        """Fail with a :exc:`TemplateAssertionError`."""
+        raise TemplateAssertionError(msg, lineno, self.name, self.filename)
+
+    def temporary_identifier(self):
+        """Get a new unique identifier."""
+        self._last_identifier += 1
+        return "t_%d" % self._last_identifier
+
+    def buffer(self, frame):
+        """Enable buffering for the frame from that point onwards."""
+        frame.buffer = self.temporary_identifier()
+        self.writeline("%s = []" % frame.buffer)
+
+    def return_buffer_contents(self, frame, force_unescaped=False):
+        """Return the buffer contents of the frame."""
+        if not force_unescaped:
+            if frame.eval_ctx.volatile:
+                self.writeline("if context.eval_ctx.autoescape:")
+                self.indent()
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                self.outdent()
+                self.writeline("else:")
+                self.indent()
+                self.writeline("return concat(%s)" % frame.buffer)
+                self.outdent()
+                return
+            elif frame.eval_ctx.autoescape:
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                return
+        self.writeline("return concat(%s)" % frame.buffer)
+
+    def indent(self):
+        """Indent by one."""
+        self._indentation += 1
+
+    def outdent(self, step=1):
+        """Outdent by step."""
+        self._indentation -= step
+
+    def start_write(self, frame, node=None):
+        """Yield or write into the frame buffer."""
+        if frame.buffer is None:
+            self.writeline("yield ", node)
+        else:
+            self.writeline("%s.append(" % frame.buffer, node)
+
+    def end_write(self, frame):
+        """End the writing process started by `start_write`."""
+        if frame.buffer is not None:
+            self.write(")")
+
+    def simple_write(self, s, frame, node=None):
+        """Simple shortcut for start_write + write + end_write."""
+        self.start_write(frame, node)
+        self.write(s)
+        self.end_write(frame)
+
+    def blockvisit(self, nodes, frame):
+        """Visit a list of nodes as block in a frame.  If the current frame
+        is no buffer a dummy ``if 0: yield None`` is written automatically.
+        """
+        try:
+            self.writeline("pass")
+            for node in nodes:
+                self.visit(node, frame)
+        except CompilerExit:
+            pass
+
+    def write(self, x):
+        """Write a string into the output stream."""
+        if self._new_lines:
+            if not self._first_write:
+                self.stream.write("\n" * self._new_lines)
+                self.code_lineno += self._new_lines
+                if self._write_debug_info is not None:
+                    self.debug_info.append((self._write_debug_info, self.code_lineno))
+                    self._write_debug_info = None
+            self._first_write = False
+            self.stream.write("    " * self._indentation)
+            self._new_lines = 0
+        self.stream.write(x)
+
+    def writeline(self, x, node=None, extra=0):
+        """Combination of newline and write."""
+        self.newline(node, extra)
+        self.write(x)
+
+    def newline(self, node=None, extra=0):
+        """Add one or more newlines before the next write."""
+        self._new_lines = max(self._new_lines, 1 + extra)
+        if node is not None and node.lineno != self._last_line:
+            self._write_debug_info = node.lineno
+            self._last_line = node.lineno
+
+    def signature(self, node, frame, extra_kwargs=None):
+        """Writes a function call to the stream for the current node.
+        A leading comma is added automatically.  The extra keyword
+        arguments may not include python keywords otherwise a syntax
+        error could occur.  The extra keyword arguments should be given
+        as python dict.
+        """
+        # if any of the given keyword arguments is a python keyword
+        # we have to make sure that no invalid call is created.
+        kwarg_workaround = False
+        for kwarg in chain((x.key for x in node.kwargs), extra_kwargs or ()):
+            if is_python_keyword(kwarg):
+                kwarg_workaround = True
+                break
+
+        for arg in node.args:
+            self.write(", ")
+            self.visit(arg, frame)
+
+        if not kwarg_workaround:
+            for kwarg in node.kwargs:
+                self.write(", ")
+                self.visit(kwarg, frame)
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write(", %s=%s" % (key, value))
+        if node.dyn_args:
+            self.write(", *")
+            self.visit(node.dyn_args, frame)
+
+        if kwarg_workaround:
+            if node.dyn_kwargs is not None:
+                self.write(", **dict({")
+            else:
+                self.write(", **{")
+            for kwarg in node.kwargs:
+                self.write("%r: " % kwarg.key)
+                self.visit(kwarg.value, frame)
+                self.write(", ")
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write("%r: %s, " % (key, value))
+            if node.dyn_kwargs is not None:
+                self.write("}, **")
+                self.visit(node.dyn_kwargs, frame)
+                self.write(")")
+            else:
+                self.write("}")
+
+        elif node.dyn_kwargs is not None:
+            self.write(", **")
+            self.visit(node.dyn_kwargs, frame)
+
+    def pull_dependencies(self, nodes):
+        """Pull all the dependencies."""
+        visitor = DependencyFinderVisitor()
+        for node in nodes:
+            visitor.visit(node)
+        for dependency in "filters", "tests":
+            mapping = getattr(self, dependency)
+            for name in getattr(visitor, dependency):
+                if name not in mapping:
+                    mapping[name] = self.temporary_identifier()
+                self.writeline(
+                    "%s = environment.%s[%r]" % (mapping[name], dependency, name)
+                )
+
+    def enter_frame(self, frame):
+        undefs = []
+        for target, (action, param) in iteritems(frame.symbols.loads):
+            if action == VAR_LOAD_PARAMETER:
+                pass
+            elif action == VAR_LOAD_RESOLVE:
+                self.writeline("%s = %s(%r)" % (target, self.get_resolve_func(), param))
+            elif action == VAR_LOAD_ALIAS:
+                self.writeline("%s = %s" % (target, param))
+            elif action == VAR_LOAD_UNDEFINED:
+                undefs.append(target)
+            else:
+                raise NotImplementedError("unknown load instruction")
+        if undefs:
+            self.writeline("%s = missing" % " = ".join(undefs))
+
+    def leave_frame(self, frame, with_python_scope=False):
+        if not with_python_scope:
+            undefs = []
+            for target, _ in iteritems(frame.symbols.loads):
+                undefs.append(target)
+            if undefs:
+                self.writeline("%s = missing" % " = ".join(undefs))
+
+    def func(self, name):
+        if self.environment.is_async:
+            return "async def %s" % name
+        return "def %s" % name
+
+    def macro_body(self, node, frame):
+        """Dump the function def of a macro or call block."""
+        frame = frame.inner()
+        frame.symbols.analyze_node(node)
+        macro_ref = MacroRef(node)
+
+        explicit_caller = None
+        skip_special_params = set()
+        args = []
+        for idx, arg in enumerate(node.args):
+            if arg.name == "caller":
+                explicit_caller = idx
+            if arg.name in ("kwargs", "varargs"):
+                skip_special_params.add(arg.name)
+            args.append(frame.symbols.ref(arg.name))
+
+        undeclared = find_undeclared(node.body, ("caller", "kwargs", "varargs"))
+
+        if "caller" in undeclared:
+            # In older Jinja versions there was a bug that allowed caller
+            # to retain the special behavior even if it was mentioned in
+            # the argument list.  However thankfully this was only really
+            # working if it was the last argument.  So we are explicitly
+            # checking this now and error out if it is anywhere else in
+            # the argument list.
+            if explicit_caller is not None:
+                try:
+                    node.defaults[explicit_caller - len(node.args)]
+                except IndexError:
+                    self.fail(
+                        "When defining macros or call blocks the "
+                        'special "caller" argument must be omitted '
+                        "or be given a default.",
+                        node.lineno,
+                    )
+            else:
+                args.append(frame.symbols.declare_parameter("caller"))
+            macro_ref.accesses_caller = True
+        if "kwargs" in undeclared and "kwargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("kwargs"))
+            macro_ref.accesses_kwargs = True
+        if "varargs" in undeclared and "varargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("varargs"))
+            macro_ref.accesses_varargs = True
+
+        # macros are delayed, they never require output checks
+        frame.require_output_check = False
+        frame.symbols.analyze_node(node)
+        self.writeline("%s(%s):" % (self.func("macro"), ", ".join(args)), node)
+        self.indent()
+
+        self.buffer(frame)
+        self.enter_frame(frame)
+
+        self.push_parameter_definitions(frame)
+        for idx, arg in enumerate(node.args):
+            ref = frame.symbols.ref(arg.name)
+            self.writeline("if %s is missing:" % ref)
+            self.indent()
+            try:
+                default = node.defaults[idx - len(node.args)]
+            except IndexError:
+                self.writeline(
+                    "%s = undefined(%r, name=%r)"
+                    % (ref, "parameter %r was not provided" % arg.name, arg.name)
+                )
+            else:
+                self.writeline("%s = " % ref)
+                self.visit(default, frame)
+            self.mark_parameter_stored(ref)
+            self.outdent()
+        self.pop_parameter_definitions()
+
+        self.blockvisit(node.body, frame)
+        self.return_buffer_contents(frame, force_unescaped=True)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        return frame, macro_ref
+
+    def macro_def(self, macro_ref, frame):
+        """Dump the macro definition for the def created by macro_body."""
+        arg_tuple = ", ".join(repr(x.name) for x in macro_ref.node.args)
+        name = getattr(macro_ref.node, "name", None)
+        if len(macro_ref.node.args) == 1:
+            arg_tuple += ","
+        self.write(
+            "Macro(environment, macro, %r, (%s), %r, %r, %r, "
+            "context.eval_ctx.autoescape)"
+            % (
+                name,
+                arg_tuple,
+                macro_ref.accesses_kwargs,
+                macro_ref.accesses_varargs,
+                macro_ref.accesses_caller,
+            )
+        )
+
+    def position(self, node):
+        """Return a human readable position for the node."""
+        rv = "line %d" % node.lineno
+        if self.name is not None:
+            rv += " in " + repr(self.name)
+        return rv
+
+    def dump_local_context(self, frame):
+        return "{%s}" % ", ".join(
+            "%r: %s" % (name, target)
+            for name, target in iteritems(frame.symbols.dump_stores())
+        )
+
+    def write_commons(self):
+        """Writes a common preamble that is used by root and block functions.
+        Primarily this sets up common local helpers and enforces a generator
+        through a dead branch.
+        """
+        self.writeline("resolve = context.resolve_or_missing")
+        self.writeline("undefined = environment.undefined")
+        # always use the standard Undefined class for the implicit else of
+        # conditional expressions
+        self.writeline("cond_expr_undefined = Undefined")
+        self.writeline("if 0: yield None")
+
+    def push_parameter_definitions(self, frame):
+        """Pushes all parameter targets from the given frame into a local
+        stack that permits tracking of yet to be assigned parameters.  In
+        particular this enables the optimization from `visit_Name` to skip
+        undefined expressions for parameters in macros as macros can reference
+        otherwise unbound parameters.
+        """
+        self._param_def_block.append(frame.symbols.dump_param_targets())
+
+    def pop_parameter_definitions(self):
+        """Pops the current parameter definitions set."""
+        self._param_def_block.pop()
+
+    def mark_parameter_stored(self, target):
+        """Marks a parameter in the current parameter definitions as stored.
+        This will skip the enforced undefined checks.
+        """
+        if self._param_def_block:
+            self._param_def_block[-1].discard(target)
+
+    def push_context_reference(self, target):
+        self._context_reference_stack.append(target)
+
+    def pop_context_reference(self):
+        self._context_reference_stack.pop()
+
+    def get_context_ref(self):
+        return self._context_reference_stack[-1]
+
+    def get_resolve_func(self):
+        target = self._context_reference_stack[-1]
+        if target == "context":
+            return "resolve"
+        return "%s.resolve" % target
+
+    def derive_context(self, frame):
+        return "%s.derived(%s)" % (
+            self.get_context_ref(),
+            self.dump_local_context(frame),
+        )
+
+    def parameter_is_undeclared(self, target):
+        """Checks if a given target is an undeclared parameter."""
+        if not self._param_def_block:
+            return False
+        return target in self._param_def_block[-1]
+
+    def push_assign_tracking(self):
+        """Pushes a new layer for assignment tracking."""
+        self._assign_stack.append(set())
+
+    def pop_assign_tracking(self, frame):
+        """Pops the topmost level for assignment tracking and updates the
+        context variables if necessary.
+        """
+        vars = self._assign_stack.pop()
+        if not frame.toplevel or not vars:
+            return
+        public_names = [x for x in vars if x[:1] != "_"]
+        if len(vars) == 1:
+            name = next(iter(vars))
+            ref = frame.symbols.ref(name)
+            self.writeline("context.vars[%r] = %s" % (name, ref))
+        else:
+            self.writeline("context.vars.update({")
+            for idx, name in enumerate(vars):
+                if idx:
+                    self.write(", ")
+                ref = frame.symbols.ref(name)
+                self.write("%r: %s" % (name, ref))
+            self.write("})")
+        if public_names:
+            if len(public_names) == 1:
+                self.writeline("context.exported_vars.add(%r)" % public_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.update((%s))"
+                    % ", ".join(imap(repr, public_names))
+                )
+
+    # -- Statement Visitors
+
+    def visit_Template(self, node, frame=None):
+        assert frame is None, "no root frame allowed"
+        eval_ctx = EvalContext(self.environment, self.name)
+
+        from .runtime import exported
+
+        self.writeline("from __future__ import %s" % ", ".join(code_features))
+        self.writeline("from jinja2.runtime import " + ", ".join(exported))
+
+        if self.environment.is_async:
+            self.writeline(
+                "from jinja2.asyncsupport import auto_await, "
+                "auto_aiter, AsyncLoopContext"
+            )
+
+        # if we want a deferred initialization we cannot move the
+        # environment into a local name
+        envenv = not self.defer_init and ", environment=environment" or ""
+
+        # do we have an extends tag at all?  If not, we can save some
+        # overhead by just not processing any inheritance code.
+        have_extends = node.find(nodes.Extends) is not None
+
+        # find all blocks
+        for block in node.find_all(nodes.Block):
+            if block.name in self.blocks:
+                self.fail("block %r defined twice" % block.name, block.lineno)
+            self.blocks[block.name] = block
+
+        # find all imports and import them
+        for import_ in node.find_all(nodes.ImportedName):
+            if import_.importname not in self.import_aliases:
+                imp = import_.importname
+                self.import_aliases[imp] = alias = self.temporary_identifier()
+                if "." in imp:
+                    module, obj = imp.rsplit(".", 1)
+                    self.writeline("from %s import %s as %s" % (module, obj, alias))
+                else:
+                    self.writeline("import %s as %s" % (imp, alias))
+
+        # add the load name
+        self.writeline("name = %r" % self.name)
+
+        # generate the root render function.
+        self.writeline(
+            "%s(context, missing=missing%s):" % (self.func("root"), envenv), extra=1
+        )
+        self.indent()
+        self.write_commons()
+
+        # process the root
+        frame = Frame(eval_ctx)
+        if "self" in find_undeclared(node.body, ("self",)):
+            ref = frame.symbols.declare_parameter("self")
+            self.writeline("%s = TemplateReference(context)" % ref)
+        frame.symbols.analyze_node(node)
+        frame.toplevel = frame.rootlevel = True
+        frame.require_output_check = have_extends and not self.has_known_extends
+        if have_extends:
+            self.writeline("parent_template = None")
+        self.enter_frame(frame)
+        self.pull_dependencies(node.body)
+        self.blockvisit(node.body, frame)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        # make sure that the parent root is called.
+        if have_extends:
+            if not self.has_known_extends:
+                self.indent()
+                self.writeline("if parent_template is not None:")
+            self.indent()
+            if supports_yield_from and not self.environment.is_async:
+                self.writeline("yield from parent_template.root_render_func(context)")
+            else:
+                self.writeline(
+                    "%sfor event in parent_template."
+                    "root_render_func(context):"
+                    % (self.environment.is_async and "async " or "")
+                )
+                self.indent()
+                self.writeline("yield event")
+                self.outdent()
+            self.outdent(1 + (not self.has_known_extends))
+
+        # at this point we now have the blocks collected and can visit them too.
+        for name, block in iteritems(self.blocks):
+            self.writeline(
+                "%s(context, missing=missing%s):"
+                % (self.func("block_" + name), envenv),
+                block,
+                1,
+            )
+            self.indent()
+            self.write_commons()
+            # It's important that we do not make this frame a child of the
+            # toplevel template.  This would cause a variety of
+            # interesting issues with identifier tracking.
+            block_frame = Frame(eval_ctx)
+            undeclared = find_undeclared(block.body, ("self", "super"))
+            if "self" in undeclared:
+                ref = block_frame.symbols.declare_parameter("self")
+                self.writeline("%s = TemplateReference(context)" % ref)
+            if "super" in undeclared:
+                ref = block_frame.symbols.declare_parameter("super")
+                self.writeline("%s = context.super(%r, block_%s)" % (ref, name, name))
+            block_frame.symbols.analyze_node(block)
+            block_frame.block = name
+            self.enter_frame(block_frame)
+            self.pull_dependencies(block.body)
+            self.blockvisit(block.body, block_frame)
+            self.leave_frame(block_frame, with_python_scope=True)
+            self.outdent()
+
+        self.writeline(
+            "blocks = {%s}" % ", ".join("%r: block_%s" % (x, x) for x in self.blocks),
+            extra=1,
+        )
+
+        # add a function that returns the debug info
+        self.writeline(
+            "debug_info = %r" % "&".join("%s=%s" % x for x in self.debug_info)
+        )
+
+    def visit_Block(self, node, frame):
+        """Call a block and register it for the template."""
+        level = 0
+        if frame.toplevel:
+            # if we know that we are a child template, there is no need to
+            # check if we are one
+            if self.has_known_extends:
+                return
+            if self.extends_so_far > 0:
+                self.writeline("if parent_template is None:")
+                self.indent()
+                level += 1
+
+        if node.scoped:
+            context = self.derive_context(frame)
+        else:
+            context = self.get_context_ref()
+
+        if (
+            supports_yield_from
+            and not self.environment.is_async
+            and frame.buffer is None
+        ):
+            self.writeline(
+                "yield from context.blocks[%r][0](%s)" % (node.name, context), node
+            )
+        else:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in context.blocks[%r][0](%s):" % (loop, node.name, context),
+                node,
+            )
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        self.outdent(level)
+
+    def visit_Extends(self, node, frame):
+        """Calls the extender."""
+        if not frame.toplevel:
+            self.fail("cannot use extend from a non top-level scope", node.lineno)
+
+        # if the number of extends statements in general is zero so
+        # far, we don't have to add a check if something extended
+        # the template before this one.
+        if self.extends_so_far > 0:
+
+            # if we have a known extends we just add a template runtime
+            # error into the generated code.  We could catch that at compile
+            # time too, but i welcome it not to confuse users by throwing the
+            # same error at different times just "because we can".
+            if not self.has_known_extends:
+                self.writeline("if parent_template is not None:")
+                self.indent()
+            self.writeline("raise TemplateRuntimeError(%r)" % "extended multiple times")
+
+            # if we have a known extends already we don't need that code here
+            # as we know that the template execution will end here.
+            if self.has_known_extends:
+                raise CompilerExit()
+            else:
+                self.outdent()
+
+        self.writeline("parent_template = environment.get_template(", node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        self.writeline(
+            "for name, parent_block in parent_template.blocks.%s():" % dict_item_iter
+        )
+        self.indent()
+        self.writeline("context.blocks.setdefault(name, []).append(parent_block)")
+        self.outdent()
+
+        # if this extends statement was in the root level we can take
+        # advantage of that information and simplify the generated code
+        # in the top level from this point onwards
+        if frame.rootlevel:
+            self.has_known_extends = True
+
+        # and now we have one more
+        self.extends_so_far += 1
+
+    def visit_Include(self, node, frame):
+        """Handles includes."""
+        if node.ignore_missing:
+            self.writeline("try:")
+            self.indent()
+
+        func_name = "get_or_select_template"
+        if isinstance(node.template, nodes.Const):
+            if isinstance(node.template.value, string_types):
+                func_name = "get_template"
+            elif isinstance(node.template.value, (tuple, list)):
+                func_name = "select_template"
+        elif isinstance(node.template, (nodes.Tuple, nodes.List)):
+            func_name = "select_template"
+
+        self.writeline("template = environment.%s(" % func_name, node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        if node.ignore_missing:
+            self.outdent()
+            self.writeline("except TemplateNotFound:")
+            self.indent()
+            self.writeline("pass")
+            self.outdent()
+            self.writeline("else:")
+            self.indent()
+
+        skip_event_yield = False
+        if node.with_context:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in template.root_render_func("
+                "template.new_context(context.get_all(), True, "
+                "%s)):" % (loop, self.dump_local_context(frame))
+            )
+        elif self.environment.is_async:
+            self.writeline(
+                "for event in (await "
+                "template._get_default_module_async())"
+                "._body_stream:"
+            )
+        else:
+            if supports_yield_from:
+                self.writeline("yield from template._get_default_module()._body_stream")
+                skip_event_yield = True
+            else:
+                self.writeline(
+                    "for event in template._get_default_module()._body_stream:"
+                )
+
+        if not skip_event_yield:
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        if node.ignore_missing:
+            self.outdent()
+
+    def visit_Import(self, node, frame):
+        """Visit regular imports."""
+        self.writeline("%s = " % frame.symbols.ref(node.target), node)
+        if frame.toplevel:
+            self.write("context.vars[%r] = " % node.target)
+        if self.environment.is_async:
+            self.write("await ")
+        self.write("environment.get_template(")
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+        if frame.toplevel and not node.target.startswith("_"):
+            self.writeline("context.exported_vars.discard(%r)" % node.target)
+
+    def visit_FromImport(self, node, frame):
+        """Visit named imports."""
+        self.newline(node)
+        self.write(
+            "included_template = %senvironment.get_template("
+            % (self.environment.is_async and "await " or "")
+        )
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+
+        var_names = []
+        discarded_names = []
+        for name in node.names:
+            if isinstance(name, tuple):
+                name, alias = name
+            else:
+                alias = name
+            self.writeline(
+                "%s = getattr(included_template, "
+                "%r, missing)" % (frame.symbols.ref(alias), name)
+            )
+            self.writeline("if %s is missing:" % frame.symbols.ref(alias))
+            self.indent()
+            self.writeline(
+                "%s = undefined(%r %% "
+                "included_template.__name__, "
+                "name=%r)"
+                % (
+                    frame.symbols.ref(alias),
+                    "the template %%r (imported on %s) does "
+                    "not export the requested name %s"
+                    % (self.position(node), repr(name)),
+                    name,
+                )
+            )
+            self.outdent()
+            if frame.toplevel:
+                var_names.append(alias)
+                if not alias.startswith("_"):
+                    discarded_names.append(alias)
+
+        if var_names:
+            if len(var_names) == 1:
+                name = var_names[0]
+                self.writeline(
+                    "context.vars[%r] = %s" % (name, frame.symbols.ref(name))
+                )
+            else:
+                self.writeline(
+                    "context.vars.update({%s})"
+                    % ", ".join(
+                        "%r: %s" % (name, frame.symbols.ref(name)) for name in var_names
+                    )
+                )
+        if discarded_names:
+            if len(discarded_names) == 1:
+                self.writeline("context.exported_vars.discard(%r)" % discarded_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.difference_"
+                    "update((%s))" % ", ".join(imap(repr, discarded_names))
+                )
+
+    def visit_For(self, node, frame):
+        loop_frame = frame.inner()
+        test_frame = frame.inner()
+        else_frame = frame.inner()
+
+        # try to figure out if we have an extended loop.  An extended loop
+        # is necessary if the loop is in recursive mode if the special loop
+        # variable is accessed in the body.
+        extended_loop = node.recursive or "loop" in find_undeclared(
+            node.iter_child_nodes(only=("body",)), ("loop",)
+        )
+
+        loop_ref = None
+        if extended_loop:
+            loop_ref = loop_frame.symbols.declare_parameter("loop")
+
+        loop_frame.symbols.analyze_node(node, for_branch="body")
+        if node.else_:
+            else_frame.symbols.analyze_node(node, for_branch="else")
+
+        if node.test:
+            loop_filter_func = self.temporary_identifier()
+            test_frame.symbols.analyze_node(node, for_branch="test")
+            self.writeline("%s(fiter):" % self.func(loop_filter_func), node.test)
+            self.indent()
+            self.enter_frame(test_frame)
+            self.writeline(self.environment.is_async and "async for " or "for ")
+            self.visit(node.target, loop_frame)
+            self.write(" in ")
+            self.write(self.environment.is_async and "auto_aiter(fiter)" or "fiter")
+            self.write(":")
+            self.indent()
+            self.writeline("if ", node.test)
+            self.visit(node.test, test_frame)
+            self.write(":")
+            self.indent()
+            self.writeline("yield ")
+            self.visit(node.target, loop_frame)
+            self.outdent(3)
+            self.leave_frame(test_frame, with_python_scope=True)
+
+        # if we don't have an recursive loop we have to find the shadowed
+        # variables at that point.  Because loops can be nested but the loop
+        # variable is a special one we have to enforce aliasing for it.
+        if node.recursive:
+            self.writeline(
+                "%s(reciter, loop_render_func, depth=0):" % self.func("loop"), node
+            )
+            self.indent()
+            self.buffer(loop_frame)
+
+            # Use the same buffer for the else frame
+            else_frame.buffer = loop_frame.buffer
+
+        # make sure the loop variable is a special one and raise a template
+        # assertion error if a loop tries to write to loop
+        if extended_loop:
+            self.writeline("%s = missing" % loop_ref)
+
+        for name in node.find_all(nodes.Name):
+            if name.ctx == "store" and name.name == "loop":
+                self.fail(
+                    "Can't assign to special loop variable in for-loop target",
+                    name.lineno,
+                )
+
+        if node.else_:
+            iteration_indicator = self.temporary_identifier()
+            self.writeline("%s = 1" % iteration_indicator)
+
+        self.writeline(self.environment.is_async and "async for " or "for ", node)
+        self.visit(node.target, loop_frame)
+        if extended_loop:
+            if self.environment.is_async:
+                self.write(", %s in AsyncLoopContext(" % loop_ref)
+            else:
+                self.write(", %s in LoopContext(" % loop_ref)
+        else:
+            self.write(" in ")
+
+        if node.test:
+            self.write("%s(" % loop_filter_func)
+        if node.recursive:
+            self.write("reciter")
+        else:
+            if self.environment.is_async and not extended_loop:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async and not extended_loop:
+                self.write(")")
+        if node.test:
+            self.write(")")
+
+        if node.recursive:
+            self.write(", undefined, loop_render_func, depth):")
+        else:
+            self.write(extended_loop and ", undefined):" or ":")
+
+        self.indent()
+        self.enter_frame(loop_frame)
+
+        self.blockvisit(node.body, loop_frame)
+        if node.else_:
+            self.writeline("%s = 0" % iteration_indicator)
+        self.outdent()
+        self.leave_frame(
+            loop_frame, with_python_scope=node.recursive and not node.else_
+        )
+
+        if node.else_:
+            self.writeline("if %s:" % iteration_indicator)
+            self.indent()
+            self.enter_frame(else_frame)
+            self.blockvisit(node.else_, else_frame)
+            self.leave_frame(else_frame)
+            self.outdent()
+
+        # if the node was recursive we have to return the buffer contents
+        # and start the iteration code
+        if node.recursive:
+            self.return_buffer_contents(loop_frame)
+            self.outdent()
+            self.start_write(frame, node)
+            if self.environment.is_async:
+                self.write("await ")
+            self.write("loop(")
+            if self.environment.is_async:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async:
+                self.write(")")
+            self.write(", loop)")
+            self.end_write(frame)
+
+    def visit_If(self, node, frame):
+        if_frame = frame.soft()
+        self.writeline("if ", node)
+        self.visit(node.test, if_frame)
+        self.write(":")
+        self.indent()
+        self.blockvisit(node.body, if_frame)
+        self.outdent()
+        for elif_ in node.elif_:
+            self.writeline("elif ", elif_)
+            self.visit(elif_.test, if_frame)
+            self.write(":")
+            self.indent()
+            self.blockvisit(elif_.body, if_frame)
+            self.outdent()
+        if node.else_:
+            self.writeline("else:")
+            self.indent()
+            self.blockvisit(node.else_, if_frame)
+            self.outdent()
+
+    def visit_Macro(self, node, frame):
+        macro_frame, macro_ref = self.macro_body(node, frame)
+        self.newline()
+        if frame.toplevel:
+            if not node.name.startswith("_"):
+                self.write("context.exported_vars.add(%r)" % node.name)
+            self.writeline("context.vars[%r] = " % node.name)
+        self.write("%s = " % frame.symbols.ref(node.name))
+        self.macro_def(macro_ref, macro_frame)
+
+    def visit_CallBlock(self, node, frame):
+        call_frame, macro_ref = self.macro_body(node, frame)
+        self.writeline("caller = ")
+        self.macro_def(macro_ref, call_frame)
+        self.start_write(frame, node)
+        self.visit_Call(node.call, frame, forward_caller=True)
+        self.end_write(frame)
+
+    def visit_FilterBlock(self, node, frame):
+        filter_frame = frame.inner()
+        filter_frame.symbols.analyze_node(node)
+        self.enter_frame(filter_frame)
+        self.buffer(filter_frame)
+        self.blockvisit(node.body, filter_frame)
+        self.start_write(frame, node)
+        self.visit_Filter(node.filter, filter_frame)
+        self.end_write(frame)
+        self.leave_frame(filter_frame)
+
+    def visit_With(self, node, frame):
+        with_frame = frame.inner()
+        with_frame.symbols.analyze_node(node)
+        self.enter_frame(with_frame)
+        for target, expr in izip(node.targets, node.values):
+            self.newline()
+            self.visit(target, with_frame)
+            self.write(" = ")
+            self.visit(expr, frame)
+        self.blockvisit(node.body, with_frame)
+        self.leave_frame(with_frame)
+
+    def visit_ExprStmt(self, node, frame):
+        self.newline(node)
+        self.visit(node.node, frame)
+
+    _FinalizeInfo = namedtuple("_FinalizeInfo", ("const", "src"))
+    #: The default finalize function if the environment isn't configured
+    #: with one. Or if the environment has one, this is called on that
+    #: function's output for constants.
+    _default_finalize = text_type
+    _finalize = None
+
+    def _make_finalize(self):
+        """Build the finalize function to be used on constants and at
+        runtime. Cached so it's only created once for all output nodes.
+
+        Returns a ``namedtuple`` with the following attributes:
+
+        ``const``
+            A function to finalize constant data at compile time.
+
+        ``src``
+            Source code to output around nodes to be evaluated at
+            runtime.
+        """
+        if self._finalize is not None:
+            return self._finalize
+
+        finalize = default = self._default_finalize
+        src = None
+
+        if self.environment.finalize:
+            src = "environment.finalize("
+            env_finalize = self.environment.finalize
+
+            def finalize(value):
+                return default(env_finalize(value))
+
+            if getattr(env_finalize, "contextfunction", False) is True:
+                src += "context, "
+                finalize = None  # noqa: F811
+            elif getattr(env_finalize, "evalcontextfunction", False) is True:
+                src += "context.eval_ctx, "
+                finalize = None
+            elif getattr(env_finalize, "environmentfunction", False) is True:
+                src += "environment, "
+
+                def finalize(value):
+                    return default(env_finalize(self.environment, value))
+
+        self._finalize = self._FinalizeInfo(finalize, src)
+        return self._finalize
+
+    def _output_const_repr(self, group):
+        """Given a group of constant values converted from ``Output``
+        child nodes, produce a string to write to the template module
+        source.
+        """
+        return repr(concat(group))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        """Try to optimize a child of an ``Output`` node by trying to
+        convert it to constant, finalized data at compile time.
+
+        If :exc:`Impossible` is raised, the node is not constant and
+        will be evaluated at runtime. Any other exception will also be
+        evaluated at runtime for easier debugging.
+        """
+        const = node.as_const(frame.eval_ctx)
+
+        if frame.eval_ctx.autoescape:
+            const = escape(const)
+
+        # Template data doesn't go through finalize.
+        if isinstance(node, nodes.TemplateData):
+            return text_type(const)
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        """Output extra source code before visiting a child of an
+        ``Output`` node.
+        """
+        if frame.eval_ctx.volatile:
+            self.write("(escape if context.eval_ctx.autoescape else to_string)(")
+        elif frame.eval_ctx.autoescape:
+            self.write("escape(")
+        else:
+            self.write("to_string(")
+
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        """Output extra source code after visiting a child of an
+        ``Output`` node.
+        """
+        self.write(")")
+
+        if finalize.src is not None:
+            self.write(")")
+
+    def visit_Output(self, node, frame):
+        # If an extends is active, don't render outside a block.
+        if frame.require_output_check:
+            # A top-level extends is known to exist at compile time.
+            if self.has_known_extends:
+                return
+
+            self.writeline("if parent_template is None:")
+            self.indent()
+
+        finalize = self._make_finalize()
+        body = []
+
+        # Evaluate constants at compile time if possible. Each item in
+        # body will be either a list of static data or a node to be
+        # evaluated at runtime.
+        for child in node.nodes:
+            try:
+                if not (
+                    # If the finalize function requires runtime context,
+                    # constants can't be evaluated at compile time.
+                    finalize.const
+                    # Unless it's basic template data that won't be
+                    # finalized anyway.
+                    or isinstance(child, nodes.TemplateData)
+                ):
+                    raise nodes.Impossible()
+
+                const = self._output_child_to_const(child, frame, finalize)
+            except (nodes.Impossible, Exception):
+                # The node was not constant and needs to be evaluated at
+                # runtime. Or another error was raised, which is easier
+                # to debug at runtime.
+                body.append(child)
+                continue
+
+            if body and isinstance(body[-1], list):
+                body[-1].append(const)
+            else:
+                body.append([const])
+
+        if frame.buffer is not None:
+            if len(body) == 1:
+                self.writeline("%s.append(" % frame.buffer)
+            else:
+                self.writeline("%s.extend((" % frame.buffer)
+
+            self.indent()
+
+        for item in body:
+            if isinstance(item, list):
+                # A group of constant data to join and output.
+                val = self._output_const_repr(item)
+
+                if frame.buffer is None:
+                    self.writeline("yield " + val)
+                else:
+                    self.writeline(val + ",")
+            else:
+                if frame.buffer is None:
+                    self.writeline("yield ", item)
+                else:
+                    self.newline(item)
+
+                # A node to be evaluated at runtime.
+                self._output_child_pre(item, frame, finalize)
+                self.visit(item, frame)
+                self._output_child_post(item, frame, finalize)
+
+                if frame.buffer is not None:
+                    self.write(",")
+
+        if frame.buffer is not None:
+            self.outdent()
+            self.writeline(")" if len(body) == 1 else "))")
+
+        if frame.require_output_check:
+            self.outdent()
+
+    def visit_Assign(self, node, frame):
+        self.push_assign_tracking()
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = ")
+        self.visit(node.node, frame)
+        self.pop_assign_tracking(frame)
+
+    def visit_AssignBlock(self, node, frame):
+        self.push_assign_tracking()
+        block_frame = frame.inner()
+        # This is a special case.  Since a set block always captures we
+        # will disable output checks.  This way one can use set blocks
+        # toplevel even in extended templates.
+        block_frame.require_output_check = False
+        block_frame.symbols.analyze_node(node)
+        self.enter_frame(block_frame)
+        self.buffer(block_frame)
+        self.blockvisit(node.body, block_frame)
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = (Markup if context.eval_ctx.autoescape else identity)(")
+        if node.filter is not None:
+            self.visit_Filter(node.filter, block_frame)
+        else:
+            self.write("concat(%s)" % block_frame.buffer)
+        self.write(")")
+        self.pop_assign_tracking(frame)
+        self.leave_frame(block_frame)
+
+    # -- Expression Visitors
+
+    def visit_Name(self, node, frame):
+        if node.ctx == "store" and frame.toplevel:
+            if self._assign_stack:
+                self._assign_stack[-1].add(node.name)
+        ref = frame.symbols.ref(node.name)
+
+        # If we are looking up a variable we might have to deal with the
+        # case where it's undefined.  We can skip that case if the load
+        # instruction indicates a parameter which are always defined.
+        if node.ctx == "load":
+            load = frame.symbols.find_load(ref)
+            if not (
+                load is not None
+                and load[0] == VAR_LOAD_PARAMETER
+                and not self.parameter_is_undeclared(ref)
+            ):
+                self.write(
+                    "(undefined(name=%r) if %s is missing else %s)"
+                    % (node.name, ref, ref)
+                )
+                return
+
+        self.write(ref)
+
+    def visit_NSRef(self, node, frame):
+        # NSRefs can only be used to store values; since they use the normal
+        # `foo.bar` notation they will be parsed as a normal attribute access
+        # when used anywhere but in a `set` context
+        ref = frame.symbols.ref(node.name)
+        self.writeline("if not isinstance(%s, Namespace):" % ref)
+        self.indent()
+        self.writeline(
+            "raise TemplateRuntimeError(%r)"
+            % "cannot assign attribute on non-namespace object"
+        )
+        self.outdent()
+        self.writeline("%s[%r]" % (ref, node.attr))
+
+    def visit_Const(self, node, frame):
+        val = node.as_const(frame.eval_ctx)
+        if isinstance(val, float):
+            self.write(str(val))
+        else:
+            self.write(repr(val))
+
+    def visit_TemplateData(self, node, frame):
+        try:
+            self.write(repr(node.as_const(frame.eval_ctx)))
+        except nodes.Impossible:
+            self.write(
+                "(Markup if context.eval_ctx.autoescape else identity)(%r)" % node.data
+            )
+
+    def visit_Tuple(self, node, frame):
+        self.write("(")
+        idx = -1
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write(idx == 0 and ",)" or ")")
+
+    def visit_List(self, node, frame):
+        self.write("[")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write("]")
+
+    def visit_Dict(self, node, frame):
+        self.write("{")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item.key, frame)
+            self.write(": ")
+            self.visit(item.value, frame)
+        self.write("}")
+
+    def binop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_binops
+            ):
+                self.write("environment.call_binop(context, %r, " % operator)
+                self.visit(node.left, frame)
+                self.write(", ")
+                self.visit(node.right, frame)
+            else:
+                self.write("(")
+                self.visit(node.left, frame)
+                self.write(" %s " % operator)
+                self.visit(node.right, frame)
+            self.write(")")
+
+        return visitor
+
+    def uaop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_unops
+            ):
+                self.write("environment.call_unop(context, %r, " % operator)
+                self.visit(node.node, frame)
+            else:
+                self.write("(" + operator)
+                self.visit(node.node, frame)
+            self.write(")")
+
+        return visitor
+
+    visit_Add = binop("+")
+    visit_Sub = binop("-")
+    visit_Mul = binop("*")
+    visit_Div = binop("/")
+    visit_FloorDiv = binop("//")
+    visit_Pow = binop("**")
+    visit_Mod = binop("%")
+    visit_And = binop("and", interceptable=False)
+    visit_Or = binop("or", interceptable=False)
+    visit_Pos = uaop("+")
+    visit_Neg = uaop("-")
+    visit_Not = uaop("not ", interceptable=False)
+    del binop, uaop
+
+    @optimizeconst
+    def visit_Concat(self, node, frame):
+        if frame.eval_ctx.volatile:
+            func_name = "(context.eval_ctx.volatile and markup_join or unicode_join)"
+        elif frame.eval_ctx.autoescape:
+            func_name = "markup_join"
+        else:
+            func_name = "unicode_join"
+        self.write("%s((" % func_name)
+        for arg in node.nodes:
+            self.visit(arg, frame)
+            self.write(", ")
+        self.write("))")
+
+    @optimizeconst
+    def visit_Compare(self, node, frame):
+        self.write("(")
+        self.visit(node.expr, frame)
+        for op in node.ops:
+            self.visit(op, frame)
+        self.write(")")
+
+    def visit_Operand(self, node, frame):
+        self.write(" %s " % operators[node.op])
+        self.visit(node.expr, frame)
+
+    @optimizeconst
+    def visit_Getattr(self, node, frame):
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+
+        self.write("environment.getattr(")
+        self.visit(node.node, frame)
+        self.write(", %r)" % node.attr)
+
+        if self.environment.is_async:
+            self.write("))")
+
+    @optimizeconst
+    def visit_Getitem(self, node, frame):
+        # slices bypass the environment getitem method.
+        if isinstance(node.arg, nodes.Slice):
+            self.visit(node.node, frame)
+            self.write("[")
+            self.visit(node.arg, frame)
+            self.write("]")
+        else:
+            if self.environment.is_async:
+                self.write("(await auto_await(")
+
+            self.write("environment.getitem(")
+            self.visit(node.node, frame)
+            self.write(", ")
+            self.visit(node.arg, frame)
+            self.write(")")
+
+            if self.environment.is_async:
+                self.write("))")
+
+    def visit_Slice(self, node, frame):
+        if node.start is not None:
+            self.visit(node.start, frame)
+        self.write(":")
+        if node.stop is not None:
+            self.visit(node.stop, frame)
+        if node.step is not None:
+            self.write(":")
+            self.visit(node.step, frame)
+
+    @optimizeconst
+    def visit_Filter(self, node, frame):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        self.write(self.filters[node.name] + "(")
+        func = self.environment.filters.get(node.name)
+        if func is None:
+            self.fail("no filter named %r" % node.name, node.lineno)
+        if getattr(func, "contextfilter", False) is True:
+            self.write("context, ")
+        elif getattr(func, "evalcontextfilter", False) is True:
+            self.write("context.eval_ctx, ")
+        elif getattr(func, "environmentfilter", False) is True:
+            self.write("environment, ")
+
+        # if the filter node is None we are inside a filter block
+        # and want to write to the current buffer
+        if node.node is not None:
+            self.visit(node.node, frame)
+        elif frame.eval_ctx.volatile:
+            self.write(
+                "(context.eval_ctx.autoescape and"
+                " Markup(concat(%s)) or concat(%s))" % (frame.buffer, frame.buffer)
+            )
+        elif frame.eval_ctx.autoescape:
+            self.write("Markup(concat(%s))" % frame.buffer)
+        else:
+            self.write("concat(%s)" % frame.buffer)
+        self.signature(node, frame)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    @optimizeconst
+    def visit_Test(self, node, frame):
+        self.write(self.tests[node.name] + "(")
+        if node.name not in self.environment.tests:
+            self.fail("no test named %r" % node.name, node.lineno)
+        self.visit(node.node, frame)
+        self.signature(node, frame)
+        self.write(")")
+
+    @optimizeconst
+    def visit_CondExpr(self, node, frame):
+        def write_expr2():
+            if node.expr2 is not None:
+                return self.visit(node.expr2, frame)
+            self.write(
+                "cond_expr_undefined(%r)"
+                % (
+                    "the inline if-"
+                    "expression on %s evaluated to false and "
+                    "no else section was defined." % self.position(node)
+                )
+            )
+
+        self.write("(")
+        self.visit(node.expr1, frame)
+        self.write(" if ")
+        self.visit(node.test, frame)
+        self.write(" else ")
+        write_expr2()
+        self.write(")")
+
+    @optimizeconst
+    def visit_Call(self, node, frame, forward_caller=False):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        if self.environment.sandboxed:
+            self.write("environment.call(context, ")
+        else:
+            self.write("context.call(")
+        self.visit(node.node, frame)
+        extra_kwargs = forward_caller and {"caller": "caller"} or None
+        self.signature(node, frame, extra_kwargs)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    def visit_Keyword(self, node, frame):
+        self.write(node.key + "=")
+        self.visit(node.value, frame)
+
+    # -- Unused nodes for extensions
+
+    def visit_MarkSafe(self, node, frame):
+        self.write("Markup(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_MarkSafeIfAutoescape(self, node, frame):
+        self.write("(context.eval_ctx.autoescape and Markup or identity)(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_EnvironmentAttribute(self, node, frame):
+        self.write("environment." + node.name)
+
+    def visit_ExtensionAttribute(self, node, frame):
+        self.write("environment.extensions[%r].%s" % (node.identifier, node.name))
+
+    def visit_ImportedName(self, node, frame):
+        self.write(self.import_aliases[node.importname])
+
+    def visit_InternalName(self, node, frame):
+        self.write(node.name)
+
+    def visit_ContextReference(self, node, frame):
+        self.write("context")
+
+    def visit_DerivedContextReference(self, node, frame):
+        self.write(self.derive_context(frame))
+
+    def visit_Continue(self, node, frame):
+        self.writeline("continue", node)
+
+    def visit_Break(self, node, frame):
+        self.writeline("break", node)
+
+    def visit_Scope(self, node, frame):
+        scope_frame = frame.inner()
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+
+    def visit_OverlayScope(self, node, frame):
+        ctx = self.temporary_identifier()
+        self.writeline("%s = %s" % (ctx, self.derive_context(frame)))
+        self.writeline("%s.vars = " % ctx)
+        self.visit(node.context, frame)
+        self.push_context_reference(ctx)
+
+        scope_frame = frame.inner(isolated=True)
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+        self.pop_context_reference()
+
+    def visit_EvalContextModifier(self, node, frame):
+        for keyword in node.options:
+            self.writeline("context.eval_ctx.%s = " % keyword.key)
+            self.visit(keyword.value, frame)
+            try:
+                val = keyword.value.as_const(frame.eval_ctx)
+            except nodes.Impossible:
+                frame.eval_ctx.volatile = True
+            else:
+                setattr(frame.eval_ctx, keyword.key, val)
+
+    def visit_ScopedEvalContextModifier(self, node, frame):
+        old_ctx_name = self.temporary_identifier()
+        saved_ctx = frame.eval_ctx.save()
+        self.writeline("%s = context.eval_ctx.save()" % old_ctx_name)
+        self.visit_EvalContextModifier(node, frame)
+        for child in node.body:
+            self.visit(child, frame)
+        frame.eval_ctx.revert(saved_ctx)
+        self.writeline("context.eval_ctx.revert(%s)" % old_ctx_name)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/constants.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf7f2ca721789052f1e227c5e3432e7712134c55
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/constants.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+#: list of lorem ipsum words used by the lipsum() helper function
+LOREM_IPSUM_WORDS = u"""\
+a ac accumsan ad adipiscing aenean aliquam aliquet amet ante aptent arcu at
+auctor augue bibendum blandit class commodo condimentum congue consectetuer
+consequat conubia convallis cras cubilia cum curabitur curae cursus dapibus
+diam dictum dictumst dignissim dis dolor donec dui duis egestas eget eleifend
+elementum elit enim erat eros est et etiam eu euismod facilisi facilisis fames
+faucibus felis fermentum feugiat fringilla fusce gravida habitant habitasse hac
+hendrerit hymenaeos iaculis id imperdiet in inceptos integer interdum ipsum
+justo lacinia lacus laoreet lectus leo libero ligula litora lobortis lorem
+luctus maecenas magna magnis malesuada massa mattis mauris metus mi molestie
+mollis montes morbi mus nam nascetur natoque nec neque netus nibh nisi nisl non
+nonummy nostra nulla nullam nunc odio orci ornare parturient pede pellentesque
+penatibus per pharetra phasellus placerat platea porta porttitor posuere
+potenti praesent pretium primis proin pulvinar purus quam quis quisque rhoncus
+ridiculus risus rutrum sagittis sapien scelerisque sed sem semper senectus sit
+sociis sociosqu sodales sollicitudin suscipit suspendisse taciti tellus tempor
+tempus tincidunt torquent tortor tristique turpis ullamcorper ultrices
+ultricies urna ut varius vehicula vel velit venenatis vestibulum vitae vivamus
+viverra volutpat vulputate"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d8aec31d05dab0b01b192b9dfe74f2656dc3077
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/debug.py
@@ -0,0 +1,268 @@
+import sys
+from types import CodeType
+
+from . import TemplateSyntaxError
+from ._compat import PYPY
+from .utils import internal_code
+from .utils import missing
+
+
+def rewrite_traceback_stack(source=None):
+    """Rewrite the current exception to replace any tracebacks from
+    within compiled template code with tracebacks that look like they
+    came from the template source.
+
+    This must be called within an ``except`` block.
+
+    :param exc_info: A :meth:`sys.exc_info` tuple. If not provided,
+        the current ``exc_info`` is used.
+    :param source: For ``TemplateSyntaxError``, the original source if
+        known.
+    :return: A :meth:`sys.exc_info` tuple that can be re-raised.
+    """
+    exc_type, exc_value, tb = sys.exc_info()
+
+    if isinstance(exc_value, TemplateSyntaxError) and not exc_value.translated:
+        exc_value.translated = True
+        exc_value.source = source
+
+        try:
+            # Remove the old traceback on Python 3, otherwise the frames
+            # from the compiler still show up.
+            exc_value.with_traceback(None)
+        except AttributeError:
+            pass
+
+        # Outside of runtime, so the frame isn't executing template
+        # code, but it still needs to point at the template.
+        tb = fake_traceback(
+            exc_value, None, exc_value.filename or "<unknown>", exc_value.lineno
+        )
+    else:
+        # Skip the frame for the render function.
+        tb = tb.tb_next
+
+    stack = []
+
+    # Build the stack of traceback object, replacing any in template
+    # code with the source file and line information.
+    while tb is not None:
+        # Skip frames decorated with @internalcode. These are internal
+        # calls that aren't useful in template debugging output.
+        if tb.tb_frame.f_code in internal_code:
+            tb = tb.tb_next
+            continue
+
+        template = tb.tb_frame.f_globals.get("__jinja_template__")
+
+        if template is not None:
+            lineno = template.get_corresponding_lineno(tb.tb_lineno)
+            fake_tb = fake_traceback(exc_value, tb, template.filename, lineno)
+            stack.append(fake_tb)
+        else:
+            stack.append(tb)
+
+        tb = tb.tb_next
+
+    tb_next = None
+
+    # Assign tb_next in reverse to avoid circular references.
+    for tb in reversed(stack):
+        tb_next = tb_set_next(tb, tb_next)
+
+    return exc_type, exc_value, tb_next
+
+
+def fake_traceback(exc_value, tb, filename, lineno):
+    """Produce a new traceback object that looks like it came from the
+    template source instead of the compiled code. The filename, line
+    number, and location name will point to the template, and the local
+    variables will be the current template context.
+
+    :param exc_value: The original exception to be re-raised to create
+        the new traceback.
+    :param tb: The original traceback to get the local variables and
+        code info from.
+    :param filename: The template filename.
+    :param lineno: The line number in the template source.
+    """
+    if tb is not None:
+        # Replace the real locals with the context that would be
+        # available at that point in the template.
+        locals = get_template_locals(tb.tb_frame.f_locals)
+        locals.pop("__jinja_exception__", None)
+    else:
+        locals = {}
+
+    globals = {
+        "__name__": filename,
+        "__file__": filename,
+        "__jinja_exception__": exc_value,
+    }
+    # Raise an exception at the correct line number.
+    code = compile("\n" * (lineno - 1) + "raise __jinja_exception__", filename, "exec")
+
+    # Build a new code object that points to the template file and
+    # replaces the location with a block name.
+    try:
+        location = "template"
+
+        if tb is not None:
+            function = tb.tb_frame.f_code.co_name
+
+            if function == "root":
+                location = "top-level template code"
+            elif function.startswith("block_"):
+                location = 'block "%s"' % function[6:]
+
+        # Collect arguments for the new code object. CodeType only
+        # accepts positional arguments, and arguments were inserted in
+        # new Python versions.
+        code_args = []
+
+        for attr in (
+            "argcount",
+            "posonlyargcount",  # Python 3.8
+            "kwonlyargcount",  # Python 3
+            "nlocals",
+            "stacksize",
+            "flags",
+            "code",  # codestring
+            "consts",  # constants
+            "names",
+            "varnames",
+            ("filename", filename),
+            ("name", location),
+            "firstlineno",
+            "lnotab",
+            "freevars",
+            "cellvars",
+        ):
+            if isinstance(attr, tuple):
+                # Replace with given value.
+                code_args.append(attr[1])
+                continue
+
+            try:
+                # Copy original value if it exists.
+                code_args.append(getattr(code, "co_" + attr))
+            except AttributeError:
+                # Some arguments were added later.
+                continue
+
+        code = CodeType(*code_args)
+    except Exception:
+        # Some environments such as Google App Engine don't support
+        # modifying code objects.
+        pass
+
+    # Execute the new code, which is guaranteed to raise, and return
+    # the new traceback without this frame.
+    try:
+        exec(code, globals, locals)
+    except BaseException:
+        return sys.exc_info()[2].tb_next
+
+
+def get_template_locals(real_locals):
+    """Based on the runtime locals, get the context that would be
+    available at that point in the template.
+    """
+    # Start with the current template context.
+    ctx = real_locals.get("context")
+
+    if ctx:
+        data = ctx.get_all().copy()
+    else:
+        data = {}
+
+    # Might be in a derived context that only sets local variables
+    # rather than pushing a context. Local variables follow the scheme
+    # l_depth_name. Find the highest-depth local that has a value for
+    # each name.
+    local_overrides = {}
+
+    for name, value in real_locals.items():
+        if not name.startswith("l_") or value is missing:
+            # Not a template variable, or no longer relevant.
+            continue
+
+        try:
+            _, depth, name = name.split("_", 2)
+            depth = int(depth)
+        except ValueError:
+            continue
+
+        cur_depth = local_overrides.get(name, (-1,))[0]
+
+        if cur_depth < depth:
+            local_overrides[name] = (depth, value)
+
+    # Modify the context with any derived context.
+    for name, (_, value) in local_overrides.items():
+        if value is missing:
+            data.pop(name, None)
+        else:
+            data[name] = value
+
+    return data
+
+
+if sys.version_info >= (3, 7):
+    # tb_next is directly assignable as of Python 3.7
+    def tb_set_next(tb, tb_next):
+        tb.tb_next = tb_next
+        return tb
+
+
+elif PYPY:
+    # PyPy might have special support, and won't work with ctypes.
+    try:
+        import tputil
+    except ImportError:
+        # Without tproxy support, use the original traceback.
+        def tb_set_next(tb, tb_next):
+            return tb
+
+    else:
+        # With tproxy support, create a proxy around the traceback that
+        # returns the new tb_next.
+        def tb_set_next(tb, tb_next):
+            def controller(op):
+                if op.opname == "__getattribute__" and op.args[0] == "tb_next":
+                    return tb_next
+
+                return op.delegate()
+
+            return tputil.make_proxy(controller, obj=tb)
+
+
+else:
+    # Use ctypes to assign tb_next at the C level since it's read-only
+    # from Python.
+    import ctypes
+
+    class _CTraceback(ctypes.Structure):
+        _fields_ = [
+            # Extra PyObject slots when compiled with Py_TRACE_REFS.
+            ("PyObject_HEAD", ctypes.c_byte * object().__sizeof__()),
+            # Only care about tb_next as an object, not a traceback.
+            ("tb_next", ctypes.py_object),
+        ]
+
+    def tb_set_next(tb, tb_next):
+        c_tb = _CTraceback.from_address(id(tb))
+
+        # Clear out the old tb_next.
+        if tb.tb_next is not None:
+            c_tb_next = ctypes.py_object(tb.tb_next)
+            c_tb.tb_next = ctypes.py_object()
+            ctypes.pythonapi.Py_DecRef(c_tb_next)
+
+        # Assign the new tb_next.
+        if tb_next is not None:
+            c_tb_next = ctypes.py_object(tb_next)
+            ctypes.pythonapi.Py_IncRef(c_tb_next)
+            c_tb.tb_next = c_tb_next
+
+        return tb
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/defaults.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e0e7d771076a8fe0dc71584018338d2caa35fb5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/defaults.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+from ._compat import range_type
+from .filters import FILTERS as DEFAULT_FILTERS  # noqa: F401
+from .tests import TESTS as DEFAULT_TESTS  # noqa: F401
+from .utils import Cycler
+from .utils import generate_lorem_ipsum
+from .utils import Joiner
+from .utils import Namespace
+
+# defaults for the parser / lexer
+BLOCK_START_STRING = "{%"
+BLOCK_END_STRING = "%}"
+VARIABLE_START_STRING = "{{"
+VARIABLE_END_STRING = "}}"
+COMMENT_START_STRING = "{#"
+COMMENT_END_STRING = "#}"
+LINE_STATEMENT_PREFIX = None
+LINE_COMMENT_PREFIX = None
+TRIM_BLOCKS = False
+LSTRIP_BLOCKS = False
+NEWLINE_SEQUENCE = "\n"
+KEEP_TRAILING_NEWLINE = False
+
+# default filters, tests and namespace
+
+DEFAULT_NAMESPACE = {
+    "range": range_type,
+    "dict": dict,
+    "lipsum": generate_lorem_ipsum,
+    "cycler": Cycler,
+    "joiner": Joiner,
+    "namespace": Namespace,
+}
+
+# default policies
+DEFAULT_POLICIES = {
+    "compiler.ascii_str": True,
+    "urlize.rel": "noopener",
+    "urlize.target": None,
+    "truncate.leeway": 5,
+    "json.dumps_function": None,
+    "json.dumps_kwargs": {"sort_keys": True},
+    "ext.i18n.trimmed": False,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/environment.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/environment.py
new file mode 100644
index 0000000000000000000000000000000000000000..8430390eeab412b7f3b92d88a4bdecbe1de5f538
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/environment.py
@@ -0,0 +1,1362 @@
+# -*- coding: utf-8 -*-
+"""Classes for managing templates and their runtime and compile time
+options.
+"""
+import os
+import sys
+import weakref
+from functools import partial
+from functools import reduce
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import encode_filename
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import PYPY
+from ._compat import reraise
+from ._compat import string_types
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import generate
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import DEFAULT_FILTERS
+from .defaults import DEFAULT_NAMESPACE
+from .defaults import DEFAULT_POLICIES
+from .defaults import DEFAULT_TESTS
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .lexer import get_lexer
+from .lexer import TokenStream
+from .nodes import EvalContext
+from .parser import Parser
+from .runtime import Context
+from .runtime import new_context
+from .runtime import Undefined
+from .utils import concat
+from .utils import consume
+from .utils import have_async_gen
+from .utils import import_string
+from .utils import internalcode
+from .utils import LRUCache
+from .utils import missing
+
+# for direct template usage we have up to ten living environments
+_spontaneous_environments = LRUCache(10)
+
+
+def get_spontaneous_environment(cls, *args):
+    """Return a new spontaneous environment. A spontaneous environment
+    is used for templates created directly rather than through an
+    existing environment.
+
+    :param cls: Environment class to create.
+    :param args: Positional arguments passed to environment.
+    """
+    key = (cls, args)
+
+    try:
+        return _spontaneous_environments[key]
+    except KeyError:
+        _spontaneous_environments[key] = env = cls(*args)
+        env.shared = True
+        return env
+
+
+def create_cache(size):
+    """Return the cache class for the given size."""
+    if size == 0:
+        return None
+    if size < 0:
+        return {}
+    return LRUCache(size)
+
+
+def copy_cache(cache):
+    """Create an empty copy of the given cache."""
+    if cache is None:
+        return None
+    elif type(cache) is dict:
+        return {}
+    return LRUCache(cache.capacity)
+
+
+def load_extensions(environment, extensions):
+    """Load the extensions from the list and bind it to the environment.
+    Returns a dict of instantiated environments.
+    """
+    result = {}
+    for extension in extensions:
+        if isinstance(extension, string_types):
+            extension = import_string(extension)
+        result[extension.identifier] = extension(environment)
+    return result
+
+
+def fail_for_missing_callable(string, name):
+    msg = string % name
+    if isinstance(name, Undefined):
+        try:
+            name._fail_with_undefined_error()
+        except Exception as e:
+            msg = "%s (%s; did you forget to quote the callable name?)" % (msg, e)
+    raise TemplateRuntimeError(msg)
+
+
+def _environment_sanity_check(environment):
+    """Perform a sanity check on the environment."""
+    assert issubclass(
+        environment.undefined, Undefined
+    ), "undefined must be a subclass of undefined because filters depend on it."
+    assert (
+        environment.block_start_string
+        != environment.variable_start_string
+        != environment.comment_start_string
+    ), "block, variable and comment start strings must be different"
+    assert environment.newline_sequence in (
+        "\r",
+        "\r\n",
+        "\n",
+    ), "newline_sequence set to unknown line ending string."
+    return environment
+
+
+class Environment(object):
+    r"""The core component of Jinja is the `Environment`.  It contains
+    important shared variables like configuration, filters, tests,
+    globals and others.  Instances of this class may be modified if
+    they are not shared and if no template was loaded so far.
+    Modifications on environments after the first template was loaded
+    will lead to surprising effects and undefined behavior.
+
+    Here are the possible initialization parameters:
+
+        `block_start_string`
+            The string marking the beginning of a block.  Defaults to ``'{%'``.
+
+        `block_end_string`
+            The string marking the end of a block.  Defaults to ``'%}'``.
+
+        `variable_start_string`
+            The string marking the beginning of a print statement.
+            Defaults to ``'{{'``.
+
+        `variable_end_string`
+            The string marking the end of a print statement.  Defaults to
+            ``'}}'``.
+
+        `comment_start_string`
+            The string marking the beginning of a comment.  Defaults to ``'{#'``.
+
+        `comment_end_string`
+            The string marking the end of a comment.  Defaults to ``'#}'``.
+
+        `line_statement_prefix`
+            If given and a string, this will be used as prefix for line based
+            statements.  See also :ref:`line-statements`.
+
+        `line_comment_prefix`
+            If given and a string, this will be used as prefix for line based
+            comments.  See also :ref:`line-statements`.
+
+            .. versionadded:: 2.2
+
+        `trim_blocks`
+            If this is set to ``True`` the first newline after a block is
+            removed (block, not variable tag!).  Defaults to `False`.
+
+        `lstrip_blocks`
+            If this is set to ``True`` leading spaces and tabs are stripped
+            from the start of a line to a block.  Defaults to `False`.
+
+        `newline_sequence`
+            The sequence that starts a newline.  Must be one of ``'\r'``,
+            ``'\n'`` or ``'\r\n'``.  The default is ``'\n'`` which is a
+            useful default for Linux and OS X systems as well as web
+            applications.
+
+        `keep_trailing_newline`
+            Preserve the trailing newline when rendering templates.
+            The default is ``False``, which causes a single newline,
+            if present, to be stripped from the end of the template.
+
+            .. versionadded:: 2.7
+
+        `extensions`
+            List of Jinja extensions to use.  This can either be import paths
+            as strings or extension classes.  For more information have a
+            look at :ref:`the extensions documentation <jinja-extensions>`.
+
+        `optimized`
+            should the optimizer be enabled?  Default is ``True``.
+
+        `undefined`
+            :class:`Undefined` or a subclass of it that is used to represent
+            undefined values in the template.
+
+        `finalize`
+            A callable that can be used to process the result of a variable
+            expression before it is output.  For example one can convert
+            ``None`` implicitly into an empty string here.
+
+        `autoescape`
+            If set to ``True`` the XML/HTML autoescaping feature is enabled by
+            default.  For more details about autoescaping see
+            :class:`~markupsafe.Markup`.  As of Jinja 2.4 this can also
+            be a callable that is passed the template name and has to
+            return ``True`` or ``False`` depending on autoescape should be
+            enabled by default.
+
+            .. versionchanged:: 2.4
+               `autoescape` can now be a function
+
+        `loader`
+            The template loader for this environment.
+
+        `cache_size`
+            The size of the cache.  Per default this is ``400`` which means
+            that if more than 400 templates are loaded the loader will clean
+            out the least recently used template.  If the cache size is set to
+            ``0`` templates are recompiled all the time, if the cache size is
+            ``-1`` the cache will not be cleaned.
+
+            .. versionchanged:: 2.8
+               The cache size was increased to 400 from a low 50.
+
+        `auto_reload`
+            Some loaders load templates from locations where the template
+            sources may change (ie: file system or database).  If
+            ``auto_reload`` is set to ``True`` (default) every time a template is
+            requested the loader checks if the source changed and if yes, it
+            will reload the template.  For higher performance it's possible to
+            disable that.
+
+        `bytecode_cache`
+            If set to a bytecode cache object, this object will provide a
+            cache for the internal Jinja bytecode so that templates don't
+            have to be parsed if they were not changed.
+
+            See :ref:`bytecode-cache` for more information.
+
+        `enable_async`
+            If set to true this enables async template execution which allows
+            you to take advantage of newer Python features.  This requires
+            Python 3.6 or later.
+    """
+
+    #: if this environment is sandboxed.  Modifying this variable won't make
+    #: the environment sandboxed though.  For a real sandboxed environment
+    #: have a look at jinja2.sandbox.  This flag alone controls the code
+    #: generation by the compiler.
+    sandboxed = False
+
+    #: True if the environment is just an overlay
+    overlayed = False
+
+    #: the environment this environment is linked to if it is an overlay
+    linked_to = None
+
+    #: shared environments have this set to `True`.  A shared environment
+    #: must not be modified
+    shared = False
+
+    #: the class that is used for code generation.  See
+    #: :class:`~jinja2.compiler.CodeGenerator` for more information.
+    code_generator_class = CodeGenerator
+
+    #: the context class thatis used for templates.  See
+    #: :class:`~jinja2.runtime.Context` for more information.
+    context_class = Context
+
+    def __init__(
+        self,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        loader=None,
+        cache_size=400,
+        auto_reload=True,
+        bytecode_cache=None,
+        enable_async=False,
+    ):
+        # !!Important notice!!
+        #   The constructor accepts quite a few arguments that should be
+        #   passed by keyword rather than position.  However it's important to
+        #   not change the order of arguments because it's used at least
+        #   internally in those cases:
+        #       -   spontaneous environments (i18n extension and Template)
+        #       -   unittests
+        #   If parameter changes are required only add parameters at the end
+        #   and don't change the arguments (or the defaults!) of the arguments
+        #   existing already.
+
+        # lexer / parser information
+        self.block_start_string = block_start_string
+        self.block_end_string = block_end_string
+        self.variable_start_string = variable_start_string
+        self.variable_end_string = variable_end_string
+        self.comment_start_string = comment_start_string
+        self.comment_end_string = comment_end_string
+        self.line_statement_prefix = line_statement_prefix
+        self.line_comment_prefix = line_comment_prefix
+        self.trim_blocks = trim_blocks
+        self.lstrip_blocks = lstrip_blocks
+        self.newline_sequence = newline_sequence
+        self.keep_trailing_newline = keep_trailing_newline
+
+        # runtime information
+        self.undefined = undefined
+        self.optimized = optimized
+        self.finalize = finalize
+        self.autoescape = autoescape
+
+        # defaults
+        self.filters = DEFAULT_FILTERS.copy()
+        self.tests = DEFAULT_TESTS.copy()
+        self.globals = DEFAULT_NAMESPACE.copy()
+
+        # set the loader provided
+        self.loader = loader
+        self.cache = create_cache(cache_size)
+        self.bytecode_cache = bytecode_cache
+        self.auto_reload = auto_reload
+
+        # configurable policies
+        self.policies = DEFAULT_POLICIES.copy()
+
+        # load extensions
+        self.extensions = load_extensions(self, extensions)
+
+        self.enable_async = enable_async
+        self.is_async = self.enable_async and have_async_gen
+        if self.is_async:
+            # runs patch_all() to enable async support
+            from . import asyncsupport  # noqa: F401
+
+        _environment_sanity_check(self)
+
+    def add_extension(self, extension):
+        """Adds an extension after the environment was created.
+
+        .. versionadded:: 2.5
+        """
+        self.extensions.update(load_extensions(self, [extension]))
+
+    def extend(self, **attributes):
+        """Add the items to the instance of the environment if they do not exist
+        yet.  This is used by :ref:`extensions <writing-extensions>` to register
+        callbacks and configuration values without breaking inheritance.
+        """
+        for key, value in iteritems(attributes):
+            if not hasattr(self, key):
+                setattr(self, key, value)
+
+    def overlay(
+        self,
+        block_start_string=missing,
+        block_end_string=missing,
+        variable_start_string=missing,
+        variable_end_string=missing,
+        comment_start_string=missing,
+        comment_end_string=missing,
+        line_statement_prefix=missing,
+        line_comment_prefix=missing,
+        trim_blocks=missing,
+        lstrip_blocks=missing,
+        extensions=missing,
+        optimized=missing,
+        undefined=missing,
+        finalize=missing,
+        autoescape=missing,
+        loader=missing,
+        cache_size=missing,
+        auto_reload=missing,
+        bytecode_cache=missing,
+    ):
+        """Create a new overlay environment that shares all the data with the
+        current environment except for cache and the overridden attributes.
+        Extensions cannot be removed for an overlayed environment.  An overlayed
+        environment automatically gets all the extensions of the environment it
+        is linked to plus optional extra extensions.
+
+        Creating overlays should happen after the initial environment was set
+        up completely.  Not all attributes are truly linked, some are just
+        copied over so modifications on the original environment may not shine
+        through.
+        """
+        args = dict(locals())
+        del args["self"], args["cache_size"], args["extensions"]
+
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.overlayed = True
+        rv.linked_to = self
+
+        for key, value in iteritems(args):
+            if value is not missing:
+                setattr(rv, key, value)
+
+        if cache_size is not missing:
+            rv.cache = create_cache(cache_size)
+        else:
+            rv.cache = copy_cache(self.cache)
+
+        rv.extensions = {}
+        for key, value in iteritems(self.extensions):
+            rv.extensions[key] = value.bind(rv)
+        if extensions is not missing:
+            rv.extensions.update(load_extensions(rv, extensions))
+
+        return _environment_sanity_check(rv)
+
+    lexer = property(get_lexer, doc="The lexer for this environment.")
+
+    def iter_extensions(self):
+        """Iterates over the extensions by priority."""
+        return iter(sorted(self.extensions.values(), key=lambda x: x.priority))
+
+    def getitem(self, obj, argument):
+        """Get an item or attribute of an object but prefer the item."""
+        try:
+            return obj[argument]
+        except (AttributeError, TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        return getattr(obj, attr)
+                    except AttributeError:
+                        pass
+            return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Get an item or attribute of an object but prefer the attribute.
+        Unlike :meth:`getitem` the attribute *must* be a bytestring.
+        """
+        try:
+            return getattr(obj, attribute)
+        except AttributeError:
+            pass
+        try:
+            return obj[attribute]
+        except (TypeError, LookupError, AttributeError):
+            return self.undefined(obj=obj, name=attribute)
+
+    def call_filter(
+        self, name, value, args=None, kwargs=None, context=None, eval_ctx=None
+    ):
+        """Invokes a filter on a value the same way the compiler does it.
+
+        Note that on Python 3 this might return a coroutine in case the
+        filter is running from an environment in async mode and the filter
+        supports async execution.  It's your responsibility to await this
+        if needed.
+
+        .. versionadded:: 2.7
+        """
+        func = self.filters.get(name)
+        if func is None:
+            fail_for_missing_callable("no filter named %r", name)
+        args = [value] + list(args or ())
+        if getattr(func, "contextfilter", False) is True:
+            if context is None:
+                raise TemplateRuntimeError(
+                    "Attempted to invoke context filter without context"
+                )
+            args.insert(0, context)
+        elif getattr(func, "evalcontextfilter", False) is True:
+            if eval_ctx is None:
+                if context is not None:
+                    eval_ctx = context.eval_ctx
+                else:
+                    eval_ctx = EvalContext(self)
+            args.insert(0, eval_ctx)
+        elif getattr(func, "environmentfilter", False) is True:
+            args.insert(0, self)
+        return func(*args, **(kwargs or {}))
+
+    def call_test(self, name, value, args=None, kwargs=None):
+        """Invokes a test on a value the same way the compiler does it.
+
+        .. versionadded:: 2.7
+        """
+        func = self.tests.get(name)
+        if func is None:
+            fail_for_missing_callable("no test named %r", name)
+        return func(value, *(args or ()), **(kwargs or {}))
+
+    @internalcode
+    def parse(self, source, name=None, filename=None):
+        """Parse the sourcecode and return the abstract syntax tree.  This
+        tree of nodes is used by the compiler to convert the template into
+        executable source- or bytecode.  This is useful for debugging or to
+        extract information from templates.
+
+        If you are :ref:`developing Jinja extensions <writing-extensions>`
+        this gives you a good overview of the node tree generated.
+        """
+        try:
+            return self._parse(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def _parse(self, source, name, filename):
+        """Internal parsing function used by `parse` and `compile`."""
+        return Parser(self, source, name, encode_filename(filename)).parse()
+
+    def lex(self, source, name=None, filename=None):
+        """Lex the given sourcecode and return a generator that yields
+        tokens as tuples in the form ``(lineno, token_type, value)``.
+        This can be useful for :ref:`extension development <writing-extensions>`
+        and debugging templates.
+
+        This does not perform preprocessing.  If you want the preprocessing
+        of the extensions to be applied you have to filter source through
+        the :meth:`preprocess` method.
+        """
+        source = text_type(source)
+        try:
+            return self.lexer.tokeniter(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def preprocess(self, source, name=None, filename=None):
+        """Preprocesses the source with all extensions.  This is automatically
+        called for all parsing and compiling methods but *not* for :meth:`lex`
+        because there you usually only want the actual source tokenized.
+        """
+        return reduce(
+            lambda s, e: e.preprocess(s, name, filename),
+            self.iter_extensions(),
+            text_type(source),
+        )
+
+    def _tokenize(self, source, name, filename=None, state=None):
+        """Called by the parser to do the preprocessing and filtering
+        for all the extensions.  Returns a :class:`~jinja2.lexer.TokenStream`.
+        """
+        source = self.preprocess(source, name, filename)
+        stream = self.lexer.tokenize(source, name, filename, state)
+        for ext in self.iter_extensions():
+            stream = ext.filter_stream(stream)
+            if not isinstance(stream, TokenStream):
+                stream = TokenStream(stream, name, filename)
+        return stream
+
+    def _generate(self, source, name, filename, defer_init=False):
+        """Internal hook that can be overridden to hook a different generate
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return generate(
+            source,
+            self,
+            name,
+            filename,
+            defer_init=defer_init,
+            optimized=self.optimized,
+        )
+
+    def _compile(self, source, filename):
+        """Internal hook that can be overridden to hook a different compile
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return compile(source, filename, "exec")
+
+    @internalcode
+    def compile(self, source, name=None, filename=None, raw=False, defer_init=False):
+        """Compile a node or template source code.  The `name` parameter is
+        the load name of the template after it was joined using
+        :meth:`join_path` if necessary, not the filename on the file system.
+        the `filename` parameter is the estimated filename of the template on
+        the file system.  If the template came from a database or memory this
+        can be omitted.
+
+        The return value of this method is a python code object.  If the `raw`
+        parameter is `True` the return value will be a string with python
+        code equivalent to the bytecode returned otherwise.  This method is
+        mainly used internally.
+
+        `defer_init` is use internally to aid the module code generator.  This
+        causes the generated code to be able to import without the global
+        environment variable to be set.
+
+        .. versionadded:: 2.4
+           `defer_init` parameter added.
+        """
+        source_hint = None
+        try:
+            if isinstance(source, string_types):
+                source_hint = source
+                source = self._parse(source, name, filename)
+            source = self._generate(source, name, filename, defer_init=defer_init)
+            if raw:
+                return source
+            if filename is None:
+                filename = "<template>"
+            else:
+                filename = encode_filename(filename)
+            return self._compile(source, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source_hint)
+
+    def compile_expression(self, source, undefined_to_none=True):
+        """A handy helper method that returns a callable that accepts keyword
+        arguments that appear as variables in the expression.  If called it
+        returns the result of the expression.
+
+        This is useful if applications want to use the same rules as Jinja
+        in template "configuration files" or similar situations.
+
+        Example usage:
+
+        >>> env = Environment()
+        >>> expr = env.compile_expression('foo == 42')
+        >>> expr(foo=23)
+        False
+        >>> expr(foo=42)
+        True
+
+        Per default the return value is converted to `None` if the
+        expression returns an undefined value.  This can be changed
+        by setting `undefined_to_none` to `False`.
+
+        >>> env.compile_expression('var')() is None
+        True
+        >>> env.compile_expression('var', undefined_to_none=False)()
+        Undefined
+
+        .. versionadded:: 2.1
+        """
+        parser = Parser(self, source, state="variable")
+        try:
+            expr = parser.parse_expression()
+            if not parser.stream.eos:
+                raise TemplateSyntaxError(
+                    "chunk after expression", parser.stream.current.lineno, None, None
+                )
+            expr.set_environment(self)
+        except TemplateSyntaxError:
+            if sys.exc_info() is not None:
+                self.handle_exception(source=source)
+
+        body = [nodes.Assign(nodes.Name("result", "store"), expr, lineno=1)]
+        template = self.from_string(nodes.Template(body, lineno=1))
+        return TemplateExpression(template, undefined_to_none)
+
+    def compile_templates(
+        self,
+        target,
+        extensions=None,
+        filter_func=None,
+        zip="deflated",
+        log_function=None,
+        ignore_errors=True,
+        py_compile=False,
+    ):
+        """Finds all the templates the loader can find, compiles them
+        and stores them in `target`.  If `zip` is `None`, instead of in a
+        zipfile, the templates will be stored in a directory.
+        By default a deflate zip algorithm is used. To switch to
+        the stored algorithm, `zip` can be set to ``'stored'``.
+
+        `extensions` and `filter_func` are passed to :meth:`list_templates`.
+        Each template returned will be compiled to the target folder or
+        zipfile.
+
+        By default template compilation errors are ignored.  In case a
+        log function is provided, errors are logged.  If you want template
+        syntax errors to abort the compilation you can set `ignore_errors`
+        to `False` and you will get an exception on syntax errors.
+
+        If `py_compile` is set to `True` .pyc files will be written to the
+        target instead of standard .py files.  This flag does not do anything
+        on pypy and Python 3 where pyc files are not picked up by itself and
+        don't give much benefit.
+
+        .. versionadded:: 2.4
+        """
+        from .loaders import ModuleLoader
+
+        if log_function is None:
+
+            def log_function(x):
+                pass
+
+        if py_compile:
+            if not PY2 or PYPY:
+                import warnings
+
+                warnings.warn(
+                    "'py_compile=True' has no effect on PyPy or Python"
+                    " 3 and will be removed in version 3.0",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                py_compile = False
+            else:
+                import imp
+                import marshal
+
+                py_header = imp.get_magic() + u"\xff\xff\xff\xff".encode("iso-8859-15")
+
+                # Python 3.3 added a source filesize to the header
+                if sys.version_info >= (3, 3):
+                    py_header += u"\x00\x00\x00\x00".encode("iso-8859-15")
+
+        def write_file(filename, data):
+            if zip:
+                info = ZipInfo(filename)
+                info.external_attr = 0o755 << 16
+                zip_file.writestr(info, data)
+            else:
+                if isinstance(data, text_type):
+                    data = data.encode("utf8")
+
+                with open(os.path.join(target, filename), "wb") as f:
+                    f.write(data)
+
+        if zip is not None:
+            from zipfile import ZipFile, ZipInfo, ZIP_DEFLATED, ZIP_STORED
+
+            zip_file = ZipFile(
+                target, "w", dict(deflated=ZIP_DEFLATED, stored=ZIP_STORED)[zip]
+            )
+            log_function('Compiling into Zip archive "%s"' % target)
+        else:
+            if not os.path.isdir(target):
+                os.makedirs(target)
+            log_function('Compiling into folder "%s"' % target)
+
+        try:
+            for name in self.list_templates(extensions, filter_func):
+                source, filename, _ = self.loader.get_source(self, name)
+                try:
+                    code = self.compile(source, name, filename, True, True)
+                except TemplateSyntaxError as e:
+                    if not ignore_errors:
+                        raise
+                    log_function('Could not compile "%s": %s' % (name, e))
+                    continue
+
+                filename = ModuleLoader.get_module_filename(name)
+
+                if py_compile:
+                    c = self._compile(code, encode_filename(filename))
+                    write_file(filename + "c", py_header + marshal.dumps(c))
+                    log_function('Byte-compiled "%s" as %s' % (name, filename + "c"))
+                else:
+                    write_file(filename, code)
+                    log_function('Compiled "%s" as %s' % (name, filename))
+        finally:
+            if zip:
+                zip_file.close()
+
+        log_function("Finished compiling templates")
+
+    def list_templates(self, extensions=None, filter_func=None):
+        """Returns a list of templates for this environment.  This requires
+        that the loader supports the loader's
+        :meth:`~BaseLoader.list_templates` method.
+
+        If there are other files in the template folder besides the
+        actual templates, the returned list can be filtered.  There are two
+        ways: either `extensions` is set to a list of file extensions for
+        templates, or a `filter_func` can be provided which is a callable that
+        is passed a template name and should return `True` if it should end up
+        in the result list.
+
+        If the loader does not support that, a :exc:`TypeError` is raised.
+
+        .. versionadded:: 2.4
+        """
+        names = self.loader.list_templates()
+
+        if extensions is not None:
+            if filter_func is not None:
+                raise TypeError(
+                    "either extensions or filter_func can be passed, but not both"
+                )
+
+            def filter_func(x):
+                return "." in x and x.rsplit(".", 1)[1] in extensions
+
+        if filter_func is not None:
+            names = [name for name in names if filter_func(name)]
+
+        return names
+
+    def handle_exception(self, source=None):
+        """Exception handling helper.  This is used internally to either raise
+        rewritten exceptions or return a rendered traceback for the template.
+        """
+        from .debug import rewrite_traceback_stack
+
+        reraise(*rewrite_traceback_stack(source=source))
+
+    def join_path(self, template, parent):
+        """Join a template with the parent.  By default all the lookups are
+        relative to the loader root so this method returns the `template`
+        parameter unchanged, but if the paths should be relative to the
+        parent template, this function can be used to calculate the real
+        template name.
+
+        Subclasses may override this method and implement template path
+        joining here.
+        """
+        return template
+
+    @internalcode
+    def _load_template(self, name, globals):
+        if self.loader is None:
+            raise TypeError("no loader for this environment specified")
+        cache_key = (weakref.ref(self.loader), name)
+        if self.cache is not None:
+            template = self.cache.get(cache_key)
+            if template is not None and (
+                not self.auto_reload or template.is_up_to_date
+            ):
+                return template
+        template = self.loader.load(self, name, globals)
+        if self.cache is not None:
+            self.cache[cache_key] = template
+        return template
+
+    @internalcode
+    def get_template(self, name, parent=None, globals=None):
+        """Load a template from the loader.  If a loader is configured this
+        method asks the loader for the template and returns a :class:`Template`.
+        If the `parent` parameter is not `None`, :meth:`join_path` is called
+        to get the real template name before loading.
+
+        The `globals` parameter can be used to provide template wide globals.
+        These variables are available in the context at render time.
+
+        If the template does not exist a :exc:`TemplateNotFound` exception is
+        raised.
+
+        .. versionchanged:: 2.4
+           If `name` is a :class:`Template` object it is returned from the
+           function unchanged.
+        """
+        if isinstance(name, Template):
+            return name
+        if parent is not None:
+            name = self.join_path(name, parent)
+        return self._load_template(name, self.make_globals(globals))
+
+    @internalcode
+    def select_template(self, names, parent=None, globals=None):
+        """Works like :meth:`get_template` but tries a number of templates
+        before it fails.  If it cannot find any of the templates, it will
+        raise a :exc:`TemplatesNotFound` exception.
+
+        .. versionchanged:: 2.11
+            If names is :class:`Undefined`, an :exc:`UndefinedError` is
+            raised instead. If no templates were found and names
+            contains :class:`Undefined`, the message is more helpful.
+
+        .. versionchanged:: 2.4
+           If `names` contains a :class:`Template` object it is returned
+           from the function unchanged.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(names, Undefined):
+            names._fail_with_undefined_error()
+
+        if not names:
+            raise TemplatesNotFound(
+                message=u"Tried to select from an empty list " u"of templates."
+            )
+        globals = self.make_globals(globals)
+        for name in names:
+            if isinstance(name, Template):
+                return name
+            if parent is not None:
+                name = self.join_path(name, parent)
+            try:
+                return self._load_template(name, globals)
+            except (TemplateNotFound, UndefinedError):
+                pass
+        raise TemplatesNotFound(names)
+
+    @internalcode
+    def get_or_select_template(self, template_name_or_list, parent=None, globals=None):
+        """Does a typecheck and dispatches to :meth:`select_template`
+        if an iterable of template names is given, otherwise to
+        :meth:`get_template`.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(template_name_or_list, (string_types, Undefined)):
+            return self.get_template(template_name_or_list, parent, globals)
+        elif isinstance(template_name_or_list, Template):
+            return template_name_or_list
+        return self.select_template(template_name_or_list, parent, globals)
+
+    def from_string(self, source, globals=None, template_class=None):
+        """Load a template from a string.  This parses the source given and
+        returns a :class:`Template` object.
+        """
+        globals = self.make_globals(globals)
+        cls = template_class or self.template_class
+        return cls.from_code(self, self.compile(source), globals, None)
+
+    def make_globals(self, d):
+        """Return a dict for the globals."""
+        if not d:
+            return self.globals
+        return dict(self.globals, **d)
+
+
+class Template(object):
+    """The central template object.  This class represents a compiled template
+    and is used to evaluate it.
+
+    Normally the template object is generated from an :class:`Environment` but
+    it also has a constructor that makes it possible to create a template
+    instance directly using the constructor.  It takes the same arguments as
+    the environment constructor but it's not possible to specify a loader.
+
+    Every template object has a few methods and members that are guaranteed
+    to exist.  However it's important that a template object should be
+    considered immutable.  Modifications on the object are not supported.
+
+    Template objects created from the constructor rather than an environment
+    do have an `environment` attribute that points to a temporary environment
+    that is probably shared with other templates created with the constructor
+    and compatible settings.
+
+    >>> template = Template('Hello {{ name }}!')
+    >>> template.render(name='John Doe') == u'Hello John Doe!'
+    True
+    >>> stream = template.stream(name='John Doe')
+    >>> next(stream) == u'Hello John Doe!'
+    True
+    >>> next(stream)
+    Traceback (most recent call last):
+        ...
+    StopIteration
+    """
+
+    #: Type of environment to create when creating a template directly
+    #: rather than through an existing environment.
+    environment_class = Environment
+
+    def __new__(
+        cls,
+        source,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        enable_async=False,
+    ):
+        env = get_spontaneous_environment(
+            cls.environment_class,
+            block_start_string,
+            block_end_string,
+            variable_start_string,
+            variable_end_string,
+            comment_start_string,
+            comment_end_string,
+            line_statement_prefix,
+            line_comment_prefix,
+            trim_blocks,
+            lstrip_blocks,
+            newline_sequence,
+            keep_trailing_newline,
+            frozenset(extensions),
+            optimized,
+            undefined,
+            finalize,
+            autoescape,
+            None,
+            0,
+            False,
+            None,
+            enable_async,
+        )
+        return env.from_string(source, template_class=cls)
+
+    @classmethod
+    def from_code(cls, environment, code, globals, uptodate=None):
+        """Creates a template object from compiled code and the globals.  This
+        is used by the loaders and environment to create a template object.
+        """
+        namespace = {"environment": environment, "__file__": code.co_filename}
+        exec(code, namespace)
+        rv = cls._from_namespace(environment, namespace, globals)
+        rv._uptodate = uptodate
+        return rv
+
+    @classmethod
+    def from_module_dict(cls, environment, module_dict, globals):
+        """Creates a template object from a module.  This is used by the
+        module loader to create a template object.
+
+        .. versionadded:: 2.4
+        """
+        return cls._from_namespace(environment, module_dict, globals)
+
+    @classmethod
+    def _from_namespace(cls, environment, namespace, globals):
+        t = object.__new__(cls)
+        t.environment = environment
+        t.globals = globals
+        t.name = namespace["name"]
+        t.filename = namespace["__file__"]
+        t.blocks = namespace["blocks"]
+
+        # render function and module
+        t.root_render_func = namespace["root"]
+        t._module = None
+
+        # debug and loader helpers
+        t._debug_info = namespace["debug_info"]
+        t._uptodate = None
+
+        # store the reference
+        namespace["environment"] = environment
+        namespace["__jinja_template__"] = t
+
+        return t
+
+    def render(self, *args, **kwargs):
+        """This method accepts the same arguments as the `dict` constructor:
+        A dict, a dict subclass or some keyword arguments.  If no arguments
+        are given the context will be empty.  These two calls do the same::
+
+            template.render(knights='that say nih')
+            template.render({'knights': 'that say nih'})
+
+        This will return the rendered template as unicode string.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            return concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            self.environment.handle_exception()
+
+    def render_async(self, *args, **kwargs):
+        """This works similar to :meth:`render` but returns a coroutine
+        that when awaited returns the entire rendered template string.  This
+        requires the async feature to be enabled.
+
+        Example usage::
+
+            await template.render_async(knights='that say nih; asynchronously')
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def stream(self, *args, **kwargs):
+        """Works exactly like :meth:`generate` but returns a
+        :class:`TemplateStream`.
+        """
+        return TemplateStream(self.generate(*args, **kwargs))
+
+    def generate(self, *args, **kwargs):
+        """For very large templates it can be useful to not render the whole
+        template at once but evaluate each statement after another and yield
+        piece for piece.  This method basically does exactly that and returns
+        a generator that yields one item after another as unicode strings.
+
+        It accepts the same arguments as :meth:`render`.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            for event in self.root_render_func(self.new_context(vars)):
+                yield event
+        except Exception:
+            yield self.environment.handle_exception()
+
+    def generate_async(self, *args, **kwargs):
+        """An async version of :meth:`generate`.  Works very similarly but
+        returns an async iterator instead.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def new_context(self, vars=None, shared=False, locals=None):
+        """Create a new :class:`Context` for this template.  The vars
+        provided will be passed to the template.  Per default the globals
+        are added to the context.  If shared is set to `True` the data
+        is passed as is to the context without adding the globals.
+
+        `locals` can be a dict of local variables for internal usage.
+        """
+        return new_context(
+            self.environment, self.name, self.blocks, vars, shared, self.globals, locals
+        )
+
+    def make_module(self, vars=None, shared=False, locals=None):
+        """This method works like the :attr:`module` attribute when called
+        without arguments but it will evaluate the template on every call
+        rather than caching it.  It's also possible to provide
+        a dict which is then used as context.  The arguments are the same
+        as for the :meth:`new_context` method.
+        """
+        return TemplateModule(self, self.new_context(vars, shared, locals))
+
+    def make_module_async(self, vars=None, shared=False, locals=None):
+        """As template module creation can invoke template code for
+        asynchronous executions this method must be used instead of the
+        normal :meth:`make_module` one.  Likewise the module attribute
+        becomes unavailable in async mode.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    @internalcode
+    def _get_default_module(self):
+        if self._module is not None:
+            return self._module
+        self._module = rv = self.make_module()
+        return rv
+
+    @property
+    def module(self):
+        """The template as module.  This is used for imports in the
+        template runtime but is also useful if one wants to access
+        exported template variables from the Python layer:
+
+        >>> t = Template('{% macro foo() %}42{% endmacro %}23')
+        >>> str(t.module)
+        '23'
+        >>> t.module.foo() == u'42'
+        True
+
+        This attribute is not available if async mode is enabled.
+        """
+        return self._get_default_module()
+
+    def get_corresponding_lineno(self, lineno):
+        """Return the source line number of a line number in the
+        generated bytecode as they are not in sync.
+        """
+        for template_line, code_line in reversed(self.debug_info):
+            if code_line <= lineno:
+                return template_line
+        return 1
+
+    @property
+    def is_up_to_date(self):
+        """If this variable is `False` there is a newer version available."""
+        if self._uptodate is None:
+            return True
+        return self._uptodate()
+
+    @property
+    def debug_info(self):
+        """The debug info mapping."""
+        if self._debug_info:
+            return [tuple(map(int, x.split("="))) for x in self._debug_info.split("&")]
+        return []
+
+    def __repr__(self):
+        if self.name is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.name)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+@implements_to_string
+class TemplateModule(object):
+    """Represents an imported template.  All the exported names of the
+    template are available as attributes on this object.  Additionally
+    converting it into an unicode- or bytestrings renders the contents.
+    """
+
+    def __init__(self, template, context, body_stream=None):
+        if body_stream is None:
+            if context.environment.is_async:
+                raise RuntimeError(
+                    "Async mode requires a body stream "
+                    "to be passed to a template module.  Use "
+                    "the async methods of the API you are "
+                    "using."
+                )
+            body_stream = list(template.root_render_func(context))
+        self._body_stream = body_stream
+        self.__dict__.update(context.get_exported())
+        self.__name__ = template.name
+
+    def __html__(self):
+        return Markup(concat(self._body_stream))
+
+    def __str__(self):
+        return concat(self._body_stream)
+
+    def __repr__(self):
+        if self.__name__ is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.__name__)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+class TemplateExpression(object):
+    """The :meth:`jinja2.Environment.compile_expression` method returns an
+    instance of this object.  It encapsulates the expression-like access
+    to the template with an expression it wraps.
+    """
+
+    def __init__(self, template, undefined_to_none):
+        self._template = template
+        self._undefined_to_none = undefined_to_none
+
+    def __call__(self, *args, **kwargs):
+        context = self._template.new_context(dict(*args, **kwargs))
+        consume(self._template.root_render_func(context))
+        rv = context.vars["result"]
+        if self._undefined_to_none and isinstance(rv, Undefined):
+            rv = None
+        return rv
+
+
+@implements_iterator
+class TemplateStream(object):
+    """A template stream works pretty much like an ordinary python generator
+    but it can buffer multiple items to reduce the number of total iterations.
+    Per default the output is unbuffered which means that for every unbuffered
+    instruction in the template one unicode string is yielded.
+
+    If buffering is enabled with a buffer size of 5, five items are combined
+    into a new unicode string.  This is mainly useful if you are streaming
+    big templates to a client via WSGI which flushes after each iteration.
+    """
+
+    def __init__(self, gen):
+        self._gen = gen
+        self.disable_buffering()
+
+    def dump(self, fp, encoding=None, errors="strict"):
+        """Dump the complete stream into a file or file-like object.
+        Per default unicode strings are written, if you want to encode
+        before writing specify an `encoding`.
+
+        Example usage::
+
+            Template('Hello {{ name }}!').stream(name='foo').dump('hello.html')
+        """
+        close = False
+        if isinstance(fp, string_types):
+            if encoding is None:
+                encoding = "utf-8"
+            fp = open(fp, "wb")
+            close = True
+        try:
+            if encoding is not None:
+                iterable = (x.encode(encoding, errors) for x in self)
+            else:
+                iterable = self
+            if hasattr(fp, "writelines"):
+                fp.writelines(iterable)
+            else:
+                for item in iterable:
+                    fp.write(item)
+        finally:
+            if close:
+                fp.close()
+
+    def disable_buffering(self):
+        """Disable the output buffering."""
+        self._next = partial(next, self._gen)
+        self.buffered = False
+
+    def _buffered_generator(self, size):
+        buf = []
+        c_size = 0
+        push = buf.append
+
+        while 1:
+            try:
+                while c_size < size:
+                    c = next(self._gen)
+                    push(c)
+                    if c:
+                        c_size += 1
+            except StopIteration:
+                if not c_size:
+                    return
+            yield concat(buf)
+            del buf[:]
+            c_size = 0
+
+    def enable_buffering(self, size=5):
+        """Enable buffering.  Buffer `size` items before yielding them."""
+        if size <= 1:
+            raise ValueError("buffer size too small")
+
+        self.buffered = True
+        self._next = partial(next, self._buffered_generator(size))
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        return self._next()
+
+
+# hook in default template class.  if anyone reads this comment: ignore that
+# it's possible to use custom templates ;-)
+Environment.template_class = Template
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..0bf2003e30e2a24a54640359bb04f3e98b26e3f6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/exceptions.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+from ._compat import imap
+from ._compat import implements_to_string
+from ._compat import PY2
+from ._compat import text_type
+
+
+class TemplateError(Exception):
+    """Baseclass for all template errors."""
+
+    if PY2:
+
+        def __init__(self, message=None):
+            if message is not None:
+                message = text_type(message).encode("utf-8")
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message.decode("utf-8", "replace")
+
+        def __unicode__(self):
+            return self.message or u""
+
+    else:
+
+        def __init__(self, message=None):
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message
+
+
+@implements_to_string
+class TemplateNotFound(IOError, LookupError, TemplateError):
+    """Raised if a template does not exist.
+
+    .. versionchanged:: 2.11
+        If the given name is :class:`Undefined` and no message was
+        provided, an :exc:`UndefinedError` is raised.
+    """
+
+    # looks weird, but removes the warning descriptor that just
+    # bogusly warns us about message being deprecated
+    message = None
+
+    def __init__(self, name, message=None):
+        IOError.__init__(self, name)
+
+        if message is None:
+            from .runtime import Undefined
+
+            if isinstance(name, Undefined):
+                name._fail_with_undefined_error()
+
+            message = name
+
+        self.message = message
+        self.name = name
+        self.templates = [name]
+
+    def __str__(self):
+        return self.message
+
+
+class TemplatesNotFound(TemplateNotFound):
+    """Like :class:`TemplateNotFound` but raised if multiple templates
+    are selected.  This is a subclass of :class:`TemplateNotFound`
+    exception, so just catching the base exception will catch both.
+
+    .. versionchanged:: 2.11
+        If a name in the list of names is :class:`Undefined`, a message
+        about it being undefined is shown rather than the empty string.
+
+    .. versionadded:: 2.2
+    """
+
+    def __init__(self, names=(), message=None):
+        if message is None:
+            from .runtime import Undefined
+
+            parts = []
+
+            for name in names:
+                if isinstance(name, Undefined):
+                    parts.append(name._undefined_message)
+                else:
+                    parts.append(name)
+
+            message = u"none of the templates given were found: " + u", ".join(
+                imap(text_type, parts)
+            )
+        TemplateNotFound.__init__(self, names and names[-1] or None, message)
+        self.templates = list(names)
+
+
+@implements_to_string
+class TemplateSyntaxError(TemplateError):
+    """Raised to tell the user that there is a problem with the template."""
+
+    def __init__(self, message, lineno, name=None, filename=None):
+        TemplateError.__init__(self, message)
+        self.lineno = lineno
+        self.name = name
+        self.filename = filename
+        self.source = None
+
+        # this is set to True if the debug.translate_syntax_error
+        # function translated the syntax error into a new traceback
+        self.translated = False
+
+    def __str__(self):
+        # for translated errors we only return the message
+        if self.translated:
+            return self.message
+
+        # otherwise attach some stuff
+        location = "line %d" % self.lineno
+        name = self.filename or self.name
+        if name:
+            location = 'File "%s", %s' % (name, location)
+        lines = [self.message, "  " + location]
+
+        # if the source is set, add the line to the output
+        if self.source is not None:
+            try:
+                line = self.source.splitlines()[self.lineno - 1]
+            except IndexError:
+                line = None
+            if line:
+                lines.append("    " + line.strip())
+
+        return u"\n".join(lines)
+
+    def __reduce__(self):
+        # https://bugs.python.org/issue1692335 Exceptions that take
+        # multiple required arguments have problems with pickling.
+        # Without this, raises TypeError: __init__() missing 1 required
+        # positional argument: 'lineno'
+        return self.__class__, (self.message, self.lineno, self.name, self.filename)
+
+
+class TemplateAssertionError(TemplateSyntaxError):
+    """Like a template syntax error, but covers cases where something in the
+    template caused an error at compile time that wasn't necessarily caused
+    by a syntax error.  However it's a direct subclass of
+    :exc:`TemplateSyntaxError` and has the same attributes.
+    """
+
+
+class TemplateRuntimeError(TemplateError):
+    """A generic runtime error in the template engine.  Under some situations
+    Jinja may raise this exception.
+    """
+
+
+class UndefinedError(TemplateRuntimeError):
+    """Raised if a template tries to operate on :class:`Undefined`."""
+
+
+class SecurityError(TemplateRuntimeError):
+    """Raised if a template tries to do something insecure if the
+    sandbox is enabled.
+    """
+
+
+class FilterArgumentError(TemplateRuntimeError):
+    """This error is raised if a filter was called with inappropriate
+    arguments
+    """
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/ext.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..9141be4dace15919a68c09ffbd5f96923224f09a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/ext.py
@@ -0,0 +1,704 @@
+# -*- coding: utf-8 -*-
+"""Extension API for adding custom tags and behavior."""
+import pprint
+import re
+from sys import version_info
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import with_metaclass
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .environment import Environment
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .nodes import ContextReference
+from .runtime import concat
+from .utils import contextfunction
+from .utils import import_string
+
+# the only real useful gettext functions for a Jinja template.  Note
+# that ugettext must be assigned to gettext as Jinja doesn't support
+# non unicode strings.
+GETTEXT_FUNCTIONS = ("_", "gettext", "ngettext")
+
+_ws_re = re.compile(r"\s*\n\s*")
+
+
+class ExtensionRegistry(type):
+    """Gives the extension an unique identifier."""
+
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        rv.identifier = rv.__module__ + "." + rv.__name__
+        return rv
+
+
+class Extension(with_metaclass(ExtensionRegistry, object)):
+    """Extensions can be used to add extra functionality to the Jinja template
+    system at the parser level.  Custom extensions are bound to an environment
+    but may not store environment specific data on `self`.  The reason for
+    this is that an extension can be bound to another environment (for
+    overlays) by creating a copy and reassigning the `environment` attribute.
+
+    As extensions are created by the environment they cannot accept any
+    arguments for configuration.  One may want to work around that by using
+    a factory function, but that is not possible as extensions are identified
+    by their import name.  The correct way to configure the extension is
+    storing the configuration values on the environment.  Because this way the
+    environment ends up acting as central configuration storage the
+    attributes may clash which is why extensions have to ensure that the names
+    they choose for configuration are not too generic.  ``prefix`` for example
+    is a terrible name, ``fragment_cache_prefix`` on the other hand is a good
+    name as includes the name of the extension (fragment cache).
+    """
+
+    #: if this extension parses this is the list of tags it's listening to.
+    tags = set()
+
+    #: the priority of that extension.  This is especially useful for
+    #: extensions that preprocess values.  A lower value means higher
+    #: priority.
+    #:
+    #: .. versionadded:: 2.4
+    priority = 100
+
+    def __init__(self, environment):
+        self.environment = environment
+
+    def bind(self, environment):
+        """Create a copy of this extension bound to another environment."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.environment = environment
+        return rv
+
+    def preprocess(self, source, name, filename=None):
+        """This method is called before the actual lexing and can be used to
+        preprocess the source.  The `filename` is optional.  The return value
+        must be the preprocessed source.
+        """
+        return source
+
+    def filter_stream(self, stream):
+        """It's passed a :class:`~jinja2.lexer.TokenStream` that can be used
+        to filter tokens returned.  This method has to return an iterable of
+        :class:`~jinja2.lexer.Token`\\s, but it doesn't have to return a
+        :class:`~jinja2.lexer.TokenStream`.
+        """
+        return stream
+
+    def parse(self, parser):
+        """If any of the :attr:`tags` matched this method is called with the
+        parser as first argument.  The token the parser stream is pointing at
+        is the name token that matched.  This method has to return one or a
+        list of multiple nodes.
+        """
+        raise NotImplementedError()
+
+    def attr(self, name, lineno=None):
+        """Return an attribute node for the current extension.  This is useful
+        to pass constants on extensions to generated template code.
+
+        ::
+
+            self.attr('_my_attribute', lineno=lineno)
+        """
+        return nodes.ExtensionAttribute(self.identifier, name, lineno=lineno)
+
+    def call_method(
+        self, name, args=None, kwargs=None, dyn_args=None, dyn_kwargs=None, lineno=None
+    ):
+        """Call a method of the extension.  This is a shortcut for
+        :meth:`attr` + :class:`jinja2.nodes.Call`.
+        """
+        if args is None:
+            args = []
+        if kwargs is None:
+            kwargs = []
+        return nodes.Call(
+            self.attr(name, lineno=lineno),
+            args,
+            kwargs,
+            dyn_args,
+            dyn_kwargs,
+            lineno=lineno,
+        )
+
+
+@contextfunction
+def _gettext_alias(__context, *args, **kwargs):
+    return __context.call(__context.resolve("gettext"), *args, **kwargs)
+
+
+def _make_new_gettext(func):
+    @contextfunction
+    def gettext(__context, __string, **variables):
+        rv = __context.call(func, __string)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, even if there are no
+        # variables. This makes translation strings more consistent
+        # and predictable. This requires escaping
+        return rv % variables
+
+    return gettext
+
+
+def _make_new_ngettext(func):
+    @contextfunction
+    def ngettext(__context, __singular, __plural, __num, **variables):
+        variables.setdefault("num", __num)
+        rv = __context.call(func, __singular, __plural, __num)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables
+
+    return ngettext
+
+
+class InternationalizationExtension(Extension):
+    """This extension adds gettext support to Jinja."""
+
+    tags = {"trans"}
+
+    # TODO: the i18n extension is currently reevaluating values in a few
+    # situations.  Take this example:
+    #   {% trans count=something() %}{{ count }} foo{% pluralize
+    #     %}{{ count }} fooss{% endtrans %}
+    # something is called twice here.  One time for the gettext value and
+    # the other time for the n-parameter of the ngettext function.
+
+    def __init__(self, environment):
+        Extension.__init__(self, environment)
+        environment.globals["_"] = _gettext_alias
+        environment.extend(
+            install_gettext_translations=self._install,
+            install_null_translations=self._install_null,
+            install_gettext_callables=self._install_callables,
+            uninstall_gettext_translations=self._uninstall,
+            extract_translations=self._extract,
+            newstyle_gettext=False,
+        )
+
+    def _install(self, translations, newstyle=None):
+        gettext = getattr(translations, "ugettext", None)
+        if gettext is None:
+            gettext = translations.gettext
+        ngettext = getattr(translations, "ungettext", None)
+        if ngettext is None:
+            ngettext = translations.ngettext
+        self._install_callables(gettext, ngettext, newstyle)
+
+    def _install_null(self, newstyle=None):
+        self._install_callables(
+            lambda x: x, lambda s, p, n: (n != 1 and (p,) or (s,))[0], newstyle
+        )
+
+    def _install_callables(self, gettext, ngettext, newstyle=None):
+        if newstyle is not None:
+            self.environment.newstyle_gettext = newstyle
+        if self.environment.newstyle_gettext:
+            gettext = _make_new_gettext(gettext)
+            ngettext = _make_new_ngettext(ngettext)
+        self.environment.globals.update(gettext=gettext, ngettext=ngettext)
+
+    def _uninstall(self, translations):
+        for key in "gettext", "ngettext":
+            self.environment.globals.pop(key, None)
+
+    def _extract(self, source, gettext_functions=GETTEXT_FUNCTIONS):
+        if isinstance(source, string_types):
+            source = self.environment.parse(source)
+        return extract_from_ast(source, gettext_functions)
+
+    def parse(self, parser):
+        """Parse a translatable tag."""
+        lineno = next(parser.stream).lineno
+        num_called_num = False
+
+        # find all the variables referenced.  Additionally a variable can be
+        # defined in the body of the trans block too, but this is checked at
+        # a later state.
+        plural_expr = None
+        plural_expr_assignment = None
+        variables = {}
+        trimmed = None
+        while parser.stream.current.type != "block_end":
+            if variables:
+                parser.stream.expect("comma")
+
+            # skip colon for python compatibility
+            if parser.stream.skip_if("colon"):
+                break
+
+            name = parser.stream.expect("name")
+            if name.value in variables:
+                parser.fail(
+                    "translatable variable %r defined twice." % name.value,
+                    name.lineno,
+                    exc=TemplateAssertionError,
+                )
+
+            # expressions
+            if parser.stream.current.type == "assign":
+                next(parser.stream)
+                variables[name.value] = var = parser.parse_expression()
+            elif trimmed is None and name.value in ("trimmed", "notrimmed"):
+                trimmed = name.value == "trimmed"
+                continue
+            else:
+                variables[name.value] = var = nodes.Name(name.value, "load")
+
+            if plural_expr is None:
+                if isinstance(var, nodes.Call):
+                    plural_expr = nodes.Name("_trans", "load")
+                    variables[name.value] = plural_expr
+                    plural_expr_assignment = nodes.Assign(
+                        nodes.Name("_trans", "store"), var
+                    )
+                else:
+                    plural_expr = var
+                num_called_num = name.value == "num"
+
+        parser.stream.expect("block_end")
+
+        plural = None
+        have_plural = False
+        referenced = set()
+
+        # now parse until endtrans or pluralize
+        singular_names, singular = self._parse_block(parser, True)
+        if singular_names:
+            referenced.update(singular_names)
+            if plural_expr is None:
+                plural_expr = nodes.Name(singular_names[0], "load")
+                num_called_num = singular_names[0] == "num"
+
+        # if we have a pluralize block, we parse that too
+        if parser.stream.current.test("name:pluralize"):
+            have_plural = True
+            next(parser.stream)
+            if parser.stream.current.type != "block_end":
+                name = parser.stream.expect("name")
+                if name.value not in variables:
+                    parser.fail(
+                        "unknown variable %r for pluralization" % name.value,
+                        name.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                plural_expr = variables[name.value]
+                num_called_num = name.value == "num"
+            parser.stream.expect("block_end")
+            plural_names, plural = self._parse_block(parser, False)
+            next(parser.stream)
+            referenced.update(plural_names)
+        else:
+            next(parser.stream)
+
+        # register free names as simple name expressions
+        for var in referenced:
+            if var not in variables:
+                variables[var] = nodes.Name(var, "load")
+
+        if not have_plural:
+            plural_expr = None
+        elif plural_expr is None:
+            parser.fail("pluralize without variables", lineno)
+
+        if trimmed is None:
+            trimmed = self.environment.policies["ext.i18n.trimmed"]
+        if trimmed:
+            singular = self._trim_whitespace(singular)
+            if plural:
+                plural = self._trim_whitespace(plural)
+
+        node = self._make_node(
+            singular,
+            plural,
+            variables,
+            plural_expr,
+            bool(referenced),
+            num_called_num and have_plural,
+        )
+        node.set_lineno(lineno)
+        if plural_expr_assignment is not None:
+            return [plural_expr_assignment, node]
+        else:
+            return node
+
+    def _trim_whitespace(self, string, _ws_re=_ws_re):
+        return _ws_re.sub(" ", string.strip())
+
+    def _parse_block(self, parser, allow_pluralize):
+        """Parse until the next block tag with a given name."""
+        referenced = []
+        buf = []
+        while 1:
+            if parser.stream.current.type == "data":
+                buf.append(parser.stream.current.value.replace("%", "%%"))
+                next(parser.stream)
+            elif parser.stream.current.type == "variable_begin":
+                next(parser.stream)
+                name = parser.stream.expect("name").value
+                referenced.append(name)
+                buf.append("%%(%s)s" % name)
+                parser.stream.expect("variable_end")
+            elif parser.stream.current.type == "block_begin":
+                next(parser.stream)
+                if parser.stream.current.test("name:endtrans"):
+                    break
+                elif parser.stream.current.test("name:pluralize"):
+                    if allow_pluralize:
+                        break
+                    parser.fail(
+                        "a translatable section can have only one pluralize section"
+                    )
+                parser.fail(
+                    "control structures in translatable sections are not allowed"
+                )
+            elif parser.stream.eos:
+                parser.fail("unclosed translation block")
+            else:
+                raise RuntimeError("internal parser error")
+
+        return referenced, concat(buf)
+
+    def _make_node(
+        self, singular, plural, variables, plural_expr, vars_referenced, num_called_num
+    ):
+        """Generates a useful node from the data provided."""
+        # no variables referenced?  no need to escape for old style
+        # gettext invocations only if there are vars.
+        if not vars_referenced and not self.environment.newstyle_gettext:
+            singular = singular.replace("%%", "%")
+            if plural:
+                plural = plural.replace("%%", "%")
+
+        # singular only:
+        if plural_expr is None:
+            gettext = nodes.Name("gettext", "load")
+            node = nodes.Call(gettext, [nodes.Const(singular)], [], None, None)
+
+        # singular and plural
+        else:
+            ngettext = nodes.Name("ngettext", "load")
+            node = nodes.Call(
+                ngettext,
+                [nodes.Const(singular), nodes.Const(plural), plural_expr],
+                [],
+                None,
+                None,
+            )
+
+        # in case newstyle gettext is used, the method is powerful
+        # enough to handle the variable expansion and autoescape
+        # handling itself
+        if self.environment.newstyle_gettext:
+            for key, value in iteritems(variables):
+                # the function adds that later anyways in case num was
+                # called num, so just skip it.
+                if num_called_num and key == "num":
+                    continue
+                node.kwargs.append(nodes.Keyword(key, value))
+
+        # otherwise do that here
+        else:
+            # mark the return value as safe if we are in an
+            # environment with autoescaping turned on
+            node = nodes.MarkSafeIfAutoescape(node)
+            if variables:
+                node = nodes.Mod(
+                    node,
+                    nodes.Dict(
+                        [
+                            nodes.Pair(nodes.Const(key), value)
+                            for key, value in variables.items()
+                        ]
+                    ),
+                )
+        return nodes.Output([node])
+
+
+class ExprStmtExtension(Extension):
+    """Adds a `do` tag to Jinja that works like the print statement just
+    that it doesn't print the return value.
+    """
+
+    tags = set(["do"])
+
+    def parse(self, parser):
+        node = nodes.ExprStmt(lineno=next(parser.stream).lineno)
+        node.node = parser.parse_tuple()
+        return node
+
+
+class LoopControlExtension(Extension):
+    """Adds break and continue to the template engine."""
+
+    tags = set(["break", "continue"])
+
+    def parse(self, parser):
+        token = next(parser.stream)
+        if token.value == "break":
+            return nodes.Break(lineno=token.lineno)
+        return nodes.Continue(lineno=token.lineno)
+
+
+class WithExtension(Extension):
+    pass
+
+
+class AutoEscapeExtension(Extension):
+    pass
+
+
+class DebugExtension(Extension):
+    """A ``{% debug %}`` tag that dumps the available variables,
+    filters, and tests.
+
+    .. code-block:: html+jinja
+
+        <pre>{% debug %}</pre>
+
+    .. code-block:: text
+
+        {'context': {'cycler': <class 'jinja2.utils.Cycler'>,
+                     ...,
+                     'namespace': <class 'jinja2.utils.Namespace'>},
+         'filters': ['abs', 'attr', 'batch', 'capitalize', 'center', 'count', 'd',
+                     ..., 'urlencode', 'urlize', 'wordcount', 'wordwrap', 'xmlattr'],
+         'tests': ['!=', '<', '<=', '==', '>', '>=', 'callable', 'defined',
+                   ..., 'odd', 'sameas', 'sequence', 'string', 'undefined', 'upper']}
+
+    .. versionadded:: 2.11.0
+    """
+
+    tags = {"debug"}
+
+    def parse(self, parser):
+        lineno = parser.stream.expect("name:debug").lineno
+        context = ContextReference()
+        result = self.call_method("_render", [context], lineno=lineno)
+        return nodes.Output([result], lineno=lineno)
+
+    def _render(self, context):
+        result = {
+            "context": context.get_all(),
+            "filters": sorted(self.environment.filters.keys()),
+            "tests": sorted(self.environment.tests.keys()),
+        }
+
+        # Set the depth since the intent is to show the top few names.
+        if version_info[:2] >= (3, 4):
+            return pprint.pformat(result, depth=3, compact=True)
+        else:
+            return pprint.pformat(result, depth=3)
+
+
+def extract_from_ast(node, gettext_functions=GETTEXT_FUNCTIONS, babel_style=True):
+    """Extract localizable strings from the given template node.  Per
+    default this function returns matches in babel style that means non string
+    parameters as well as keyword arguments are returned as `None`.  This
+    allows Babel to figure out what you really meant if you are using
+    gettext functions that allow keyword arguments for placeholder expansion.
+    If you don't want that behavior set the `babel_style` parameter to `False`
+    which causes only strings to be returned and parameters are always stored
+    in tuples.  As a consequence invalid gettext calls (calls without a single
+    string parameter or string parameters after non-string parameters) are
+    skipped.
+
+    This example explains the behavior:
+
+    >>> from jinja2 import Environment
+    >>> env = Environment()
+    >>> node = env.parse('{{ (_("foo"), _(), ngettext("foo", "bar", 42)) }}')
+    >>> list(extract_from_ast(node))
+    [(1, '_', 'foo'), (1, '_', ()), (1, 'ngettext', ('foo', 'bar', None))]
+    >>> list(extract_from_ast(node, babel_style=False))
+    [(1, '_', ('foo',)), (1, 'ngettext', ('foo', 'bar'))]
+
+    For every string found this function yields a ``(lineno, function,
+    message)`` tuple, where:
+
+    * ``lineno`` is the number of the line on which the string was found,
+    * ``function`` is the name of the ``gettext`` function used (if the
+      string was extracted from embedded Python code), and
+    *  ``message`` is the string itself (a ``unicode`` object, or a tuple
+       of ``unicode`` objects for functions with multiple string arguments).
+
+    This extraction function operates on the AST and is because of that unable
+    to extract any comments.  For comment support you have to use the babel
+    extraction interface or extract comments yourself.
+    """
+    for node in node.find_all(nodes.Call):
+        if (
+            not isinstance(node.node, nodes.Name)
+            or node.node.name not in gettext_functions
+        ):
+            continue
+
+        strings = []
+        for arg in node.args:
+            if isinstance(arg, nodes.Const) and isinstance(arg.value, string_types):
+                strings.append(arg.value)
+            else:
+                strings.append(None)
+
+        for _ in node.kwargs:
+            strings.append(None)
+        if node.dyn_args is not None:
+            strings.append(None)
+        if node.dyn_kwargs is not None:
+            strings.append(None)
+
+        if not babel_style:
+            strings = tuple(x for x in strings if x is not None)
+            if not strings:
+                continue
+        else:
+            if len(strings) == 1:
+                strings = strings[0]
+            else:
+                strings = tuple(strings)
+        yield node.lineno, node.node.name, strings
+
+
+class _CommentFinder(object):
+    """Helper class to find comments in a token stream.  Can only
+    find comments for gettext calls forwards.  Once the comment
+    from line 4 is found, a comment for line 1 will not return a
+    usable value.
+    """
+
+    def __init__(self, tokens, comment_tags):
+        self.tokens = tokens
+        self.comment_tags = comment_tags
+        self.offset = 0
+        self.last_lineno = 0
+
+    def find_backwards(self, offset):
+        try:
+            for _, token_type, token_value in reversed(
+                self.tokens[self.offset : offset]
+            ):
+                if token_type in ("comment", "linecomment"):
+                    try:
+                        prefix, comment = token_value.split(None, 1)
+                    except ValueError:
+                        continue
+                    if prefix in self.comment_tags:
+                        return [comment.rstrip()]
+            return []
+        finally:
+            self.offset = offset
+
+    def find_comments(self, lineno):
+        if not self.comment_tags or self.last_lineno > lineno:
+            return []
+        for idx, (token_lineno, _, _) in enumerate(self.tokens[self.offset :]):
+            if token_lineno > lineno:
+                return self.find_backwards(self.offset + idx)
+        return self.find_backwards(len(self.tokens))
+
+
+def babel_extract(fileobj, keywords, comment_tags, options):
+    """Babel extraction method for Jinja templates.
+
+    .. versionchanged:: 2.3
+       Basic support for translation comments was added.  If `comment_tags`
+       is now set to a list of keywords for extraction, the extractor will
+       try to find the best preceding comment that begins with one of the
+       keywords.  For best results, make sure to not have more than one
+       gettext call in one line of code and the matching comment in the
+       same line or the line before.
+
+    .. versionchanged:: 2.5.1
+       The `newstyle_gettext` flag can be set to `True` to enable newstyle
+       gettext calls.
+
+    .. versionchanged:: 2.7
+       A `silent` option can now be provided.  If set to `False` template
+       syntax errors are propagated instead of being ignored.
+
+    :param fileobj: the file-like object the messages should be extracted from
+    :param keywords: a list of keywords (i.e. function names) that should be
+                     recognized as translation functions
+    :param comment_tags: a list of translator tags to search for and include
+                         in the results.
+    :param options: a dictionary of additional options (optional)
+    :return: an iterator over ``(lineno, funcname, message, comments)`` tuples.
+             (comments will be empty currently)
+    """
+    extensions = set()
+    for extension in options.get("extensions", "").split(","):
+        extension = extension.strip()
+        if not extension:
+            continue
+        extensions.add(import_string(extension))
+    if InternationalizationExtension not in extensions:
+        extensions.add(InternationalizationExtension)
+
+    def getbool(options, key, default=False):
+        return options.get(key, str(default)).lower() in ("1", "on", "yes", "true")
+
+    silent = getbool(options, "silent", True)
+    environment = Environment(
+        options.get("block_start_string", BLOCK_START_STRING),
+        options.get("block_end_string", BLOCK_END_STRING),
+        options.get("variable_start_string", VARIABLE_START_STRING),
+        options.get("variable_end_string", VARIABLE_END_STRING),
+        options.get("comment_start_string", COMMENT_START_STRING),
+        options.get("comment_end_string", COMMENT_END_STRING),
+        options.get("line_statement_prefix") or LINE_STATEMENT_PREFIX,
+        options.get("line_comment_prefix") or LINE_COMMENT_PREFIX,
+        getbool(options, "trim_blocks", TRIM_BLOCKS),
+        getbool(options, "lstrip_blocks", LSTRIP_BLOCKS),
+        NEWLINE_SEQUENCE,
+        getbool(options, "keep_trailing_newline", KEEP_TRAILING_NEWLINE),
+        frozenset(extensions),
+        cache_size=0,
+        auto_reload=False,
+    )
+
+    if getbool(options, "trimmed"):
+        environment.policies["ext.i18n.trimmed"] = True
+    if getbool(options, "newstyle_gettext"):
+        environment.newstyle_gettext = True
+
+    source = fileobj.read().decode(options.get("encoding", "utf-8"))
+    try:
+        node = environment.parse(source)
+        tokens = list(environment.lex(environment.preprocess(source)))
+    except TemplateSyntaxError:
+        if not silent:
+            raise
+        # skip templates with syntax errors
+        return
+
+    finder = _CommentFinder(tokens, comment_tags)
+    for lineno, func, message in extract_from_ast(node, keywords):
+        yield lineno, func, message, finder.find_comments(lineno)
+
+
+#: nicer import names
+i18n = InternationalizationExtension
+do = ExprStmtExtension
+loopcontrols = LoopControlExtension
+with_ = WithExtension
+autoescape = AutoEscapeExtension
+debug = DebugExtension
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/filters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..974156735123b88ed996997cf18e2db03bc3c7be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/filters.py
@@ -0,0 +1,1382 @@
+# -*- coding: utf-8 -*-
+"""Built-in template filters used with the ``|`` operator."""
+import math
+import random
+import re
+import warnings
+from collections import namedtuple
+from itertools import chain
+from itertools import groupby
+
+from markupsafe import escape
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import FilterArgumentError
+from .runtime import Undefined
+from .utils import htmlsafe_json_dumps
+from .utils import pformat
+from .utils import unicode_urlencode
+from .utils import urlize
+
+_word_re = re.compile(r"\w+", re.UNICODE)
+_word_beginning_split_re = re.compile(r"([-\s\(\{\[\<]+)", re.UNICODE)
+
+
+def contextfilter(f):
+    """Decorator for marking context dependent filters. The current
+    :class:`Context` will be passed as first argument.
+    """
+    f.contextfilter = True
+    return f
+
+
+def evalcontextfilter(f):
+    """Decorator for marking eval-context dependent filters.  An eval
+    context object is passed as first argument.  For more information
+    about the eval context, see :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfilter = True
+    return f
+
+
+def environmentfilter(f):
+    """Decorator for marking environment dependent filters.  The current
+    :class:`Environment` is passed to the filter as first argument.
+    """
+    f.environmentfilter = True
+    return f
+
+
+def ignore_case(value):
+    """For use as a postprocessor for :func:`make_attrgetter`. Converts strings
+    to lowercase and returns other types as-is."""
+    return value.lower() if isinstance(value, string_types) else value
+
+
+def make_attrgetter(environment, attribute, postprocess=None, default=None):
+    """Returns a callable that looks up the given attribute from a
+    passed object with the rules of the environment.  Dots are allowed
+    to access attributes of attributes.  Integer parts in paths are
+    looked up as integers.
+    """
+    attribute = _prepare_attribute_parts(attribute)
+
+    def attrgetter(item):
+        for part in attribute:
+            item = environment.getitem(item, part)
+
+            if default and isinstance(item, Undefined):
+                item = default
+
+        if postprocess is not None:
+            item = postprocess(item)
+
+        return item
+
+    return attrgetter
+
+
+def make_multi_attrgetter(environment, attribute, postprocess=None):
+    """Returns a callable that looks up the given comma separated
+    attributes from a passed object with the rules of the environment.
+    Dots are allowed to access attributes of each attribute.  Integer
+    parts in paths are looked up as integers.
+
+    The value returned by the returned callable is a list of extracted
+    attribute values.
+
+    Examples of attribute: "attr1,attr2", "attr1.inner1.0,attr2.inner2.0", etc.
+    """
+    attribute_parts = (
+        attribute.split(",") if isinstance(attribute, string_types) else [attribute]
+    )
+    attribute = [
+        _prepare_attribute_parts(attribute_part) for attribute_part in attribute_parts
+    ]
+
+    def attrgetter(item):
+        items = [None] * len(attribute)
+        for i, attribute_part in enumerate(attribute):
+            item_i = item
+            for part in attribute_part:
+                item_i = environment.getitem(item_i, part)
+
+            if postprocess is not None:
+                item_i = postprocess(item_i)
+
+            items[i] = item_i
+        return items
+
+    return attrgetter
+
+
+def _prepare_attribute_parts(attr):
+    if attr is None:
+        return []
+    elif isinstance(attr, string_types):
+        return [int(x) if x.isdigit() else x for x in attr.split(".")]
+    else:
+        return [attr]
+
+
+def do_forceescape(value):
+    """Enforce HTML escaping.  This will probably double escape variables."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return escape(text_type(value))
+
+
+def do_urlencode(value):
+    """Quote data for use in a URL path or query using UTF-8.
+
+    Basic wrapper around :func:`urllib.parse.quote` when given a
+    string, or :func:`urllib.parse.urlencode` for a dict or iterable.
+
+    :param value: Data to quote. A string will be quoted directly. A
+        dict or iterable of ``(key, value)`` pairs will be joined as a
+        query string.
+
+    When given a string, "/" is not quoted. HTTP servers treat "/" and
+    "%2F" equivalently in paths. If you need quoted slashes, use the
+    ``|replace("/", "%2F")`` filter.
+
+    .. versionadded:: 2.7
+    """
+    if isinstance(value, string_types) or not isinstance(value, abc.Iterable):
+        return unicode_urlencode(value)
+
+    if isinstance(value, dict):
+        items = iteritems(value)
+    else:
+        items = iter(value)
+
+    return u"&".join(
+        "%s=%s" % (unicode_urlencode(k, for_qs=True), unicode_urlencode(v, for_qs=True))
+        for k, v in items
+    )
+
+
+@evalcontextfilter
+def do_replace(eval_ctx, s, old, new, count=None):
+    """Return a copy of the value with all occurrences of a substring
+    replaced with a new one. The first argument is the substring
+    that should be replaced, the second is the replacement string.
+    If the optional third argument ``count`` is given, only the first
+    ``count`` occurrences are replaced:
+
+    .. sourcecode:: jinja
+
+        {{ "Hello World"|replace("Hello", "Goodbye") }}
+            -> Goodbye World
+
+        {{ "aaaaargh"|replace("a", "d'oh, ", 2) }}
+            -> d'oh, d'oh, aaargh
+    """
+    if count is None:
+        count = -1
+    if not eval_ctx.autoescape:
+        return text_type(s).replace(text_type(old), text_type(new), count)
+    if (
+        hasattr(old, "__html__")
+        or hasattr(new, "__html__")
+        and not hasattr(s, "__html__")
+    ):
+        s = escape(s)
+    else:
+        s = soft_unicode(s)
+    return s.replace(soft_unicode(old), soft_unicode(new), count)
+
+
+def do_upper(s):
+    """Convert a value to uppercase."""
+    return soft_unicode(s).upper()
+
+
+def do_lower(s):
+    """Convert a value to lowercase."""
+    return soft_unicode(s).lower()
+
+
+@evalcontextfilter
+def do_xmlattr(_eval_ctx, d, autospace=True):
+    """Create an SGML/XML attribute string based on the items in a dict.
+    All values that are neither `none` nor `undefined` are automatically
+    escaped:
+
+    .. sourcecode:: html+jinja
+
+        <ul{{ {'class': 'my_list', 'missing': none,
+                'id': 'list-%d'|format(variable)}|xmlattr }}>
+        ...
+        </ul>
+
+    Results in something like this:
+
+    .. sourcecode:: html
+
+        <ul class="my_list" id="list-42">
+        ...
+        </ul>
+
+    As you can see it automatically prepends a space in front of the item
+    if the filter returned something unless the second parameter is false.
+    """
+    rv = u" ".join(
+        u'%s="%s"' % (escape(key), escape(value))
+        for key, value in iteritems(d)
+        if value is not None and not isinstance(value, Undefined)
+    )
+    if autospace and rv:
+        rv = u" " + rv
+    if _eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_capitalize(s):
+    """Capitalize a value. The first character will be uppercase, all others
+    lowercase.
+    """
+    return soft_unicode(s).capitalize()
+
+
+def do_title(s):
+    """Return a titlecased version of the value. I.e. words will start with
+    uppercase letters, all remaining characters are lowercase.
+    """
+    return "".join(
+        [
+            item[0].upper() + item[1:].lower()
+            for item in _word_beginning_split_re.split(soft_unicode(s))
+            if item
+        ]
+    )
+
+
+def do_dictsort(value, case_sensitive=False, by="key", reverse=False):
+    """Sort a dict and yield (key, value) pairs. Because python dicts are
+    unsorted you may want to use this function to order them by either
+    key or value:
+
+    .. sourcecode:: jinja
+
+        {% for item in mydict|dictsort %}
+            sort the dict by key, case insensitive
+
+        {% for item in mydict|dictsort(reverse=true) %}
+            sort the dict by key, case insensitive, reverse order
+
+        {% for item in mydict|dictsort(true) %}
+            sort the dict by key, case sensitive
+
+        {% for item in mydict|dictsort(false, 'value') %}
+            sort the dict by value, case insensitive
+    """
+    if by == "key":
+        pos = 0
+    elif by == "value":
+        pos = 1
+    else:
+        raise FilterArgumentError('You can only sort by either "key" or "value"')
+
+    def sort_func(item):
+        value = item[pos]
+
+        if not case_sensitive:
+            value = ignore_case(value)
+
+        return value
+
+    return sorted(value.items(), key=sort_func, reverse=reverse)
+
+
+@environmentfilter
+def do_sort(environment, value, reverse=False, case_sensitive=False, attribute=None):
+    """Sort an iterable using Python's :func:`sorted`.
+
+    .. sourcecode:: jinja
+
+        {% for city in cities|sort %}
+            ...
+        {% endfor %}
+
+    :param reverse: Sort descending instead of ascending.
+    :param case_sensitive: When sorting strings, sort upper and lower
+        case separately.
+    :param attribute: When sorting objects or dicts, an attribute or
+        key to sort by. Can use dot notation like ``"address.city"``.
+        Can be a list of attributes like ``"age,name"``.
+
+    The sort is stable, it does not change the relative order of
+    elements that compare equal. This makes it is possible to chain
+    sorts on different attributes and ordering.
+
+    .. sourcecode:: jinja
+
+        {% for user in users|sort(attribute="name")
+            |sort(reverse=true, attribute="age") %}
+            ...
+        {% endfor %}
+
+    As a shortcut to chaining when the direction is the same for all
+    attributes, pass a comma separate list of attributes.
+
+    .. sourcecode:: jinja
+
+        {% for user users|sort(attribute="age,name") %}
+            ...
+        {% endfor %}
+
+    .. versionchanged:: 2.11.0
+        The ``attribute`` parameter can be a comma separated list of
+        attributes, e.g. ``"age,name"``.
+
+    .. versionchanged:: 2.6
+       The ``attribute`` parameter was added.
+    """
+    key_func = make_multi_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return sorted(value, key=key_func, reverse=reverse)
+
+
+@environmentfilter
+def do_unique(environment, value, case_sensitive=False, attribute=None):
+    """Returns a list of unique items from the given iterable.
+
+    .. sourcecode:: jinja
+
+        {{ ['foo', 'bar', 'foobar', 'FooBar']|unique|list }}
+            -> ['foo', 'bar', 'foobar']
+
+    The unique items are yielded in the same order as their first occurrence in
+    the iterable passed to the filter.
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Filter objects with unique values for this attribute.
+    """
+    getter = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    seen = set()
+
+    for item in value:
+        key = getter(item)
+
+        if key not in seen:
+            seen.add(key)
+            yield item
+
+
+def _min_or_max(environment, value, func, case_sensitive, attribute):
+    it = iter(value)
+
+    try:
+        first = next(it)
+    except StopIteration:
+        return environment.undefined("No aggregated item, sequence was empty.")
+
+    key_func = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return func(chain([first], it), key=key_func)
+
+
+@environmentfilter
+def do_min(environment, value, case_sensitive=False, attribute=None):
+    """Return the smallest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|min }}
+            -> 1
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the min value of this attribute.
+    """
+    return _min_or_max(environment, value, min, case_sensitive, attribute)
+
+
+@environmentfilter
+def do_max(environment, value, case_sensitive=False, attribute=None):
+    """Return the largest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|max }}
+            -> 3
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the max value of this attribute.
+    """
+    return _min_or_max(environment, value, max, case_sensitive, attribute)
+
+
+def do_default(value, default_value=u"", boolean=False):
+    """If the value is undefined it will return the passed default value,
+    otherwise the value of the variable:
+
+    .. sourcecode:: jinja
+
+        {{ my_variable|default('my_variable is not defined') }}
+
+    This will output the value of ``my_variable`` if the variable was
+    defined, otherwise ``'my_variable is not defined'``. If you want
+    to use default with variables that evaluate to false you have to
+    set the second parameter to `true`:
+
+    .. sourcecode:: jinja
+
+        {{ ''|default('the string was empty', true) }}
+
+    .. versionchanged:: 2.11
+       It's now possible to configure the :class:`~jinja2.Environment` with
+       :class:`~jinja2.ChainableUndefined` to make the `default` filter work
+       on nested elements and attributes that may contain undefined values
+       in the chain without getting an :exc:`~jinja2.UndefinedError`.
+    """
+    if isinstance(value, Undefined) or (boolean and not value):
+        return default_value
+    return value
+
+
+@evalcontextfilter
+def do_join(eval_ctx, value, d=u"", attribute=None):
+    """Return a string which is the concatenation of the strings in the
+    sequence. The separator between elements is an empty string per
+    default, you can define it with the optional parameter:
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|join('|') }}
+            -> 1|2|3
+
+        {{ [1, 2, 3]|join }}
+            -> 123
+
+    It is also possible to join certain attributes of an object:
+
+    .. sourcecode:: jinja
+
+        {{ users|join(', ', attribute='username') }}
+
+    .. versionadded:: 2.6
+       The `attribute` parameter was added.
+    """
+    if attribute is not None:
+        value = imap(make_attrgetter(eval_ctx.environment, attribute), value)
+
+    # no automatic escaping?  joining is a lot easier then
+    if not eval_ctx.autoescape:
+        return text_type(d).join(imap(text_type, value))
+
+    # if the delimiter doesn't have an html representation we check
+    # if any of the items has.  If yes we do a coercion to Markup
+    if not hasattr(d, "__html__"):
+        value = list(value)
+        do_escape = False
+        for idx, item in enumerate(value):
+            if hasattr(item, "__html__"):
+                do_escape = True
+            else:
+                value[idx] = text_type(item)
+        if do_escape:
+            d = escape(d)
+        else:
+            d = text_type(d)
+        return d.join(value)
+
+    # no html involved, to normal joining
+    return soft_unicode(d).join(imap(soft_unicode, value))
+
+
+def do_center(value, width=80):
+    """Centers the value in a field of a given width."""
+    return text_type(value).center(width)
+
+
+@environmentfilter
+def do_first(environment, seq):
+    """Return the first item of a sequence."""
+    try:
+        return next(iter(seq))
+    except StopIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@environmentfilter
+def do_last(environment, seq):
+    """
+    Return the last item of a sequence.
+
+    Note: Does not work with generators. You may want to explicitly
+    convert it to a list:
+
+    .. sourcecode:: jinja
+
+        {{ data | selectattr('name', '==', 'Jinja') | list | last }}
+    """
+    try:
+        return next(iter(reversed(seq)))
+    except StopIteration:
+        return environment.undefined("No last item, sequence was empty.")
+
+
+@contextfilter
+def do_random(context, seq):
+    """Return a random item from the sequence."""
+    try:
+        return random.choice(seq)
+    except IndexError:
+        return context.environment.undefined("No random item, sequence was empty.")
+
+
+def do_filesizeformat(value, binary=False):
+    """Format the value like a 'human-readable' file size (i.e. 13 kB,
+    4.1 MB, 102 Bytes, etc).  Per default decimal prefixes are used (Mega,
+    Giga, etc.), if the second parameter is set to `True` the binary
+    prefixes are used (Mebi, Gibi).
+    """
+    bytes = float(value)
+    base = binary and 1024 or 1000
+    prefixes = [
+        (binary and "KiB" or "kB"),
+        (binary and "MiB" or "MB"),
+        (binary and "GiB" or "GB"),
+        (binary and "TiB" or "TB"),
+        (binary and "PiB" or "PB"),
+        (binary and "EiB" or "EB"),
+        (binary and "ZiB" or "ZB"),
+        (binary and "YiB" or "YB"),
+    ]
+    if bytes == 1:
+        return "1 Byte"
+    elif bytes < base:
+        return "%d Bytes" % bytes
+    else:
+        for i, prefix in enumerate(prefixes):
+            unit = base ** (i + 2)
+            if bytes < unit:
+                return "%.1f %s" % ((base * bytes / unit), prefix)
+        return "%.1f %s" % ((base * bytes / unit), prefix)
+
+
+def do_pprint(value, verbose=False):
+    """Pretty print a variable. Useful for debugging.
+
+    With Jinja 1.2 onwards you can pass it a parameter.  If this parameter
+    is truthy the output will be more verbose (this requires `pretty`)
+    """
+    return pformat(value, verbose=verbose)
+
+
+@evalcontextfilter
+def do_urlize(
+    eval_ctx, value, trim_url_limit=None, nofollow=False, target=None, rel=None
+):
+    """Converts URLs in plain text into clickable links.
+
+    If you pass the filter an additional integer it will shorten the urls
+    to that number. Also a third argument exists that makes the urls
+    "nofollow":
+
+    .. sourcecode:: jinja
+
+        {{ mytext|urlize(40, true) }}
+            links are shortened to 40 chars and defined with rel="nofollow"
+
+    If *target* is specified, the ``target`` attribute will be added to the
+    ``<a>`` tag:
+
+    .. sourcecode:: jinja
+
+       {{ mytext|urlize(40, target='_blank') }}
+
+    .. versionchanged:: 2.8+
+       The *target* parameter was added.
+    """
+    policies = eval_ctx.environment.policies
+    rel = set((rel or "").split() or [])
+    if nofollow:
+        rel.add("nofollow")
+    rel.update((policies["urlize.rel"] or "").split())
+    if target is None:
+        target = policies["urlize.target"]
+    rel = " ".join(sorted(rel)) or None
+    rv = urlize(value, trim_url_limit, rel=rel, target=target)
+    if eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_indent(s, width=4, first=False, blank=False, indentfirst=None):
+    """Return a copy of the string with each line indented by 4 spaces. The
+    first line and blank lines are not indented by default.
+
+    :param width: Number of spaces to indent by.
+    :param first: Don't skip indenting the first line.
+    :param blank: Don't skip indenting empty lines.
+
+    .. versionchanged:: 2.10
+        Blank lines are not indented by default.
+
+        Rename the ``indentfirst`` argument to ``first``.
+    """
+    if indentfirst is not None:
+        warnings.warn(
+            "The 'indentfirst' argument is renamed to 'first' and will"
+            " be removed in version 3.0.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        first = indentfirst
+
+    indention = u" " * width
+    newline = u"\n"
+
+    if isinstance(s, Markup):
+        indention = Markup(indention)
+        newline = Markup(newline)
+
+    s += newline  # this quirk is necessary for splitlines method
+
+    if blank:
+        rv = (newline + indention).join(s.splitlines())
+    else:
+        lines = s.splitlines()
+        rv = lines.pop(0)
+
+        if lines:
+            rv += newline + newline.join(
+                indention + line if line else line for line in lines
+            )
+
+    if first:
+        rv = indention + rv
+
+    return rv
+
+
+@environmentfilter
+def do_truncate(env, s, length=255, killwords=False, end="...", leeway=None):
+    """Return a truncated copy of the string. The length is specified
+    with the first parameter which defaults to ``255``. If the second
+    parameter is ``true`` the filter will cut the text at length. Otherwise
+    it will discard the last word. If the text was in fact
+    truncated it will append an ellipsis sign (``"..."``). If you want a
+    different ellipsis sign than ``"..."`` you can specify it using the
+    third parameter. Strings that only exceed the length by the tolerance
+    margin given in the fourth parameter will not be truncated.
+
+    .. sourcecode:: jinja
+
+        {{ "foo bar baz qux"|truncate(9) }}
+            -> "foo..."
+        {{ "foo bar baz qux"|truncate(9, True) }}
+            -> "foo ba..."
+        {{ "foo bar baz qux"|truncate(11) }}
+            -> "foo bar baz qux"
+        {{ "foo bar baz qux"|truncate(11, False, '...', 0) }}
+            -> "foo bar..."
+
+    The default leeway on newer Jinja versions is 5 and was 0 before but
+    can be reconfigured globally.
+    """
+    if leeway is None:
+        leeway = env.policies["truncate.leeway"]
+    assert length >= len(end), "expected length >= %s, got %s" % (len(end), length)
+    assert leeway >= 0, "expected leeway >= 0, got %s" % leeway
+    if len(s) <= length + leeway:
+        return s
+    if killwords:
+        return s[: length - len(end)] + end
+    result = s[: length - len(end)].rsplit(" ", 1)[0]
+    return result + end
+
+
+@environmentfilter
+def do_wordwrap(
+    environment,
+    s,
+    width=79,
+    break_long_words=True,
+    wrapstring=None,
+    break_on_hyphens=True,
+):
+    """Wrap a string to the given width. Existing newlines are treated
+    as paragraphs to be wrapped separately.
+
+    :param s: Original text to wrap.
+    :param width: Maximum length of wrapped lines.
+    :param break_long_words: If a word is longer than ``width``, break
+        it across lines.
+    :param break_on_hyphens: If a word contains hyphens, it may be split
+        across lines.
+    :param wrapstring: String to join each wrapped line. Defaults to
+        :attr:`Environment.newline_sequence`.
+
+    .. versionchanged:: 2.11
+        Existing newlines are treated as paragraphs wrapped separately.
+
+    .. versionchanged:: 2.11
+        Added the ``break_on_hyphens`` parameter.
+
+    .. versionchanged:: 2.7
+        Added the ``wrapstring`` parameter.
+    """
+
+    import textwrap
+
+    if not wrapstring:
+        wrapstring = environment.newline_sequence
+
+    # textwrap.wrap doesn't consider existing newlines when wrapping.
+    # If the string has a newline before width, wrap will still insert
+    # a newline at width, resulting in a short line. Instead, split and
+    # wrap each paragraph individually.
+    return wrapstring.join(
+        [
+            wrapstring.join(
+                textwrap.wrap(
+                    line,
+                    width=width,
+                    expand_tabs=False,
+                    replace_whitespace=False,
+                    break_long_words=break_long_words,
+                    break_on_hyphens=break_on_hyphens,
+                )
+            )
+            for line in s.splitlines()
+        ]
+    )
+
+
+def do_wordcount(s):
+    """Count the words in that string."""
+    return len(_word_re.findall(soft_unicode(s)))
+
+
+def do_int(value, default=0, base=10):
+    """Convert the value into an integer. If the
+    conversion doesn't work it will return ``0``. You can
+    override this default using the first parameter. You
+    can also override the default base (10) in the second
+    parameter, which handles input with prefixes such as
+    0b, 0o and 0x for bases 2, 8 and 16 respectively.
+    The base is ignored for decimal numbers and non-string values.
+    """
+    try:
+        if isinstance(value, string_types):
+            return int(value, base)
+        return int(value)
+    except (TypeError, ValueError):
+        # this quirk is necessary so that "42.23"|int gives 42.
+        try:
+            return int(float(value))
+        except (TypeError, ValueError):
+            return default
+
+
+def do_float(value, default=0.0):
+    """Convert the value into a floating point number. If the
+    conversion doesn't work it will return ``0.0``. You can
+    override this default using the first parameter.
+    """
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default
+
+
+def do_format(value, *args, **kwargs):
+    """Apply the given values to a `printf-style`_ format string, like
+    ``string % values``.
+
+    .. sourcecode:: jinja
+
+        {{ "%s, %s!"|format(greeting, name) }}
+        Hello, World!
+
+    In most cases it should be more convenient and efficient to use the
+    ``%`` operator or :meth:`str.format`.
+
+    .. code-block:: text
+
+        {{ "%s, %s!" % (greeting, name) }}
+        {{ "{}, {}!".format(greeting, name) }}
+
+    .. _printf-style: https://docs.python.org/library/stdtypes.html
+        #printf-style-string-formatting
+    """
+    if args and kwargs:
+        raise FilterArgumentError(
+            "can't handle positional and keyword arguments at the same time"
+        )
+    return soft_unicode(value) % (kwargs or args)
+
+
+def do_trim(value, chars=None):
+    """Strip leading and trailing characters, by default whitespace."""
+    return soft_unicode(value).strip(chars)
+
+
+def do_striptags(value):
+    """Strip SGML/XML tags and replace adjacent whitespace by one space."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return Markup(text_type(value)).striptags()
+
+
+def do_slice(value, slices, fill_with=None):
+    """Slice an iterator and return a list of lists containing
+    those items. Useful if you want to create a div containing
+    three ul tags that represent columns:
+
+    .. sourcecode:: html+jinja
+
+        <div class="columnwrapper">
+          {%- for column in items|slice(3) %}
+            <ul class="column-{{ loop.index }}">
+            {%- for item in column %}
+              <li>{{ item }}</li>
+            {%- endfor %}
+            </ul>
+          {%- endfor %}
+        </div>
+
+    If you pass it a second argument it's used to fill missing
+    values on the last iteration.
+    """
+    seq = list(value)
+    length = len(seq)
+    items_per_slice = length // slices
+    slices_with_extra = length % slices
+    offset = 0
+    for slice_number in range(slices):
+        start = offset + slice_number * items_per_slice
+        if slice_number < slices_with_extra:
+            offset += 1
+        end = offset + (slice_number + 1) * items_per_slice
+        tmp = seq[start:end]
+        if fill_with is not None and slice_number >= slices_with_extra:
+            tmp.append(fill_with)
+        yield tmp
+
+
+def do_batch(value, linecount, fill_with=None):
+    """
+    A filter that batches items. It works pretty much like `slice`
+    just the other way round. It returns a list of lists with the
+    given number of items. If you provide a second parameter this
+    is used to fill up missing items. See this example:
+
+    .. sourcecode:: html+jinja
+
+        <table>
+        {%- for row in items|batch(3, '&nbsp;') %}
+          <tr>
+          {%- for column in row %}
+            <td>{{ column }}</td>
+          {%- endfor %}
+          </tr>
+        {%- endfor %}
+        </table>
+    """
+    tmp = []
+    for item in value:
+        if len(tmp) == linecount:
+            yield tmp
+            tmp = []
+        tmp.append(item)
+    if tmp:
+        if fill_with is not None and len(tmp) < linecount:
+            tmp += [fill_with] * (linecount - len(tmp))
+        yield tmp
+
+
+def do_round(value, precision=0, method="common"):
+    """Round the number to a given precision. The first
+    parameter specifies the precision (default is ``0``), the
+    second the rounding method:
+
+    - ``'common'`` rounds either up or down
+    - ``'ceil'`` always rounds up
+    - ``'floor'`` always rounds down
+
+    If you don't specify a method ``'common'`` is used.
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round }}
+            -> 43.0
+        {{ 42.55|round(1, 'floor') }}
+            -> 42.5
+
+    Note that even if rounded to 0 precision, a float is returned.  If
+    you need a real integer, pipe it through `int`:
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round|int }}
+            -> 43
+    """
+    if method not in {"common", "ceil", "floor"}:
+        raise FilterArgumentError("method must be common, ceil or floor")
+    if method == "common":
+        return round(value, precision)
+    func = getattr(math, method)
+    return func(value * (10 ** precision)) / (10 ** precision)
+
+
+# Use a regular tuple repr here.  This is what we did in the past and we
+# really want to hide this custom type as much as possible.  In particular
+# we do not want to accidentally expose an auto generated repr in case
+# people start to print this out in comments or something similar for
+# debugging.
+_GroupTuple = namedtuple("_GroupTuple", ["grouper", "list"])
+_GroupTuple.__repr__ = tuple.__repr__
+_GroupTuple.__str__ = tuple.__str__
+
+
+@environmentfilter
+def do_groupby(environment, value, attribute):
+    """Group a sequence of objects by an attribute using Python's
+    :func:`itertools.groupby`. The attribute can use dot notation for
+    nested access, like ``"address.city"``. Unlike Python's ``groupby``,
+    the values are sorted first so only one group is returned for each
+    unique value.
+
+    For example, a list of ``User`` objects with a ``city`` attribute
+    can be rendered in groups. In this example, ``grouper`` refers to
+    the ``city`` value of the group.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for city, items in users|groupby("city") %}
+          <li>{{ city }}
+            <ul>{% for user in items %}
+              <li>{{ user.name }}
+            {% endfor %}</ul>
+          </li>
+        {% endfor %}</ul>
+
+    ``groupby`` yields namedtuples of ``(grouper, list)``, which
+    can be used instead of the tuple unpacking above. ``grouper`` is the
+    value of the attribute, and ``list`` is the items with that value.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for group in users|groupby("city") %}
+          <li>{{ group.grouper }}: {{ group.list|join(", ") }}
+        {% endfor %}</ul>
+
+    .. versionchanged:: 2.6
+        The attribute supports dot notation for nested access.
+    """
+    expr = make_attrgetter(environment, attribute)
+    return [
+        _GroupTuple(key, list(values))
+        for key, values in groupby(sorted(value, key=expr), expr)
+    ]
+
+
+@environmentfilter
+def do_sum(environment, iterable, attribute=None, start=0):
+    """Returns the sum of a sequence of numbers plus the value of parameter
+    'start' (which defaults to 0).  When the sequence is empty it returns
+    start.
+
+    It is also possible to sum up only certain attributes:
+
+    .. sourcecode:: jinja
+
+        Total: {{ items|sum(attribute='price') }}
+
+    .. versionchanged:: 2.6
+       The `attribute` parameter was added to allow suming up over
+       attributes.  Also the `start` parameter was moved on to the right.
+    """
+    if attribute is not None:
+        iterable = imap(make_attrgetter(environment, attribute), iterable)
+    return sum(iterable, start)
+
+
+def do_list(value):
+    """Convert the value into a list.  If it was a string the returned list
+    will be a list of characters.
+    """
+    return list(value)
+
+
+def do_mark_safe(value):
+    """Mark the value as safe which means that in an environment with automatic
+    escaping enabled this variable will not be escaped.
+    """
+    return Markup(value)
+
+
+def do_mark_unsafe(value):
+    """Mark a value as unsafe.  This is the reverse operation for :func:`safe`."""
+    return text_type(value)
+
+
+def do_reverse(value):
+    """Reverse the object or return an iterator that iterates over it the other
+    way round.
+    """
+    if isinstance(value, string_types):
+        return value[::-1]
+    try:
+        return reversed(value)
+    except TypeError:
+        try:
+            rv = list(value)
+            rv.reverse()
+            return rv
+        except TypeError:
+            raise FilterArgumentError("argument must be iterable")
+
+
+@environmentfilter
+def do_attr(environment, obj, name):
+    """Get an attribute of an object.  ``foo|attr("bar")`` works like
+    ``foo.bar`` just that always an attribute is returned and items are not
+    looked up.
+
+    See :ref:`Notes on subscriptions <notes-on-subscriptions>` for more details.
+    """
+    try:
+        name = str(name)
+    except UnicodeError:
+        pass
+    else:
+        try:
+            value = getattr(obj, name)
+        except AttributeError:
+            pass
+        else:
+            if environment.sandboxed and not environment.is_safe_attribute(
+                obj, name, value
+            ):
+                return environment.unsafe_undefined(obj, name)
+            return value
+    return environment.undefined(obj=obj, name=name)
+
+
+@contextfilter
+def do_map(*args, **kwargs):
+    """Applies a filter on a sequence of objects or looks up an attribute.
+    This is useful when dealing with lists of objects but you are really
+    only interested in a certain value of it.
+
+    The basic usage is mapping on an attribute.  Imagine you have a list
+    of users but you are only interested in a list of usernames:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ users|map(attribute='username')|join(', ') }}
+
+    You can specify a ``default`` value to use if an object in the list
+    does not have the given attribute.
+
+    .. sourcecode:: jinja
+
+        {{ users|map(attribute="username", default="Anonymous")|join(", ") }}
+
+    Alternatively you can let it invoke a filter by passing the name of the
+    filter and the arguments afterwards.  A good example would be applying a
+    text conversion filter on a sequence:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ titles|map('lower')|join(', ') }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u.username for u in users)
+        (u.username or "Anonymous" for u in users)
+        (do_lower(x) for x in titles)
+
+    .. versionchanged:: 2.11.0
+        Added the ``default`` parameter.
+
+    .. versionadded:: 2.7
+    """
+    seq, func = prepare_map(args, kwargs)
+    if seq:
+        for item in seq:
+            yield func(item)
+
+
+@contextfilter
+def do_select(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and only selecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|select("odd") }}
+        {{ numbers|select("odd") }}
+        {{ numbers|select("divisibleby", 3) }}
+        {{ numbers|select("lessthan", 42) }}
+        {{ strings|select("equalto", "mystring") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if test_odd(n))
+        (n for n in numbers if test_divisibleby(n, 3))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@contextfilter
+def do_reject(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and rejecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|reject("odd") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if not test_odd(n))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@contextfilter
+def do_selectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and only selecting the objects with the
+    test succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ users|selectattr("is_active") }}
+        {{ users|selectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if user.is_active)
+        (u for user in users if test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@contextfilter
+def do_rejectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and rejecting the objects with the test
+    succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    .. sourcecode:: jinja
+
+        {{ users|rejectattr("is_active") }}
+        {{ users|rejectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if not user.is_active)
+        (u for user in users if not test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@evalcontextfilter
+def do_tojson(eval_ctx, value, indent=None):
+    """Dumps a structure to JSON so that it's safe to use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+
+    The indent parameter can be used to enable pretty printing.  Set it to
+    the number of spaces that the structures should be indented with.
+
+    Note that this filter is for use in HTML contexts only.
+
+    .. versionadded:: 2.9
+    """
+    policies = eval_ctx.environment.policies
+    dumper = policies["json.dumps_function"]
+    options = policies["json.dumps_kwargs"]
+    if indent is not None:
+        options = dict(options)
+        options["indent"] = indent
+    return htmlsafe_json_dumps(value, dumper=dumper, **options)
+
+
+def prepare_map(args, kwargs):
+    context = args[0]
+    seq = args[1]
+    default = None
+
+    if len(args) == 2 and "attribute" in kwargs:
+        attribute = kwargs.pop("attribute")
+        default = kwargs.pop("default", None)
+        if kwargs:
+            raise FilterArgumentError(
+                "Unexpected keyword argument %r" % next(iter(kwargs))
+            )
+        func = make_attrgetter(context.environment, attribute, default=default)
+    else:
+        try:
+            name = args[2]
+            args = args[3:]
+        except LookupError:
+            raise FilterArgumentError("map requires a filter argument")
+
+        def func(item):
+            return context.environment.call_filter(
+                name, item, args, kwargs, context=context
+            )
+
+    return seq, func
+
+
+def prepare_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    context = args[0]
+    seq = args[1]
+    if lookup_attr:
+        try:
+            attr = args[2]
+        except LookupError:
+            raise FilterArgumentError("Missing parameter for attribute name")
+        transfunc = make_attrgetter(context.environment, attr)
+        off = 1
+    else:
+        off = 0
+
+        def transfunc(x):
+            return x
+
+    try:
+        name = args[2 + off]
+        args = args[3 + off :]
+
+        def func(item):
+            return context.environment.call_test(name, item, args, kwargs)
+
+    except LookupError:
+        func = bool
+
+    return seq, lambda item: modfunc(func(transfunc(item)))
+
+
+def select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        for item in seq:
+            if func(item):
+                yield item
+
+
+FILTERS = {
+    "abs": abs,
+    "attr": do_attr,
+    "batch": do_batch,
+    "capitalize": do_capitalize,
+    "center": do_center,
+    "count": len,
+    "d": do_default,
+    "default": do_default,
+    "dictsort": do_dictsort,
+    "e": escape,
+    "escape": escape,
+    "filesizeformat": do_filesizeformat,
+    "first": do_first,
+    "float": do_float,
+    "forceescape": do_forceescape,
+    "format": do_format,
+    "groupby": do_groupby,
+    "indent": do_indent,
+    "int": do_int,
+    "join": do_join,
+    "last": do_last,
+    "length": len,
+    "list": do_list,
+    "lower": do_lower,
+    "map": do_map,
+    "min": do_min,
+    "max": do_max,
+    "pprint": do_pprint,
+    "random": do_random,
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "replace": do_replace,
+    "reverse": do_reverse,
+    "round": do_round,
+    "safe": do_mark_safe,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "slice": do_slice,
+    "sort": do_sort,
+    "string": soft_unicode,
+    "striptags": do_striptags,
+    "sum": do_sum,
+    "title": do_title,
+    "trim": do_trim,
+    "truncate": do_truncate,
+    "unique": do_unique,
+    "upper": do_upper,
+    "urlencode": do_urlencode,
+    "urlize": do_urlize,
+    "wordcount": do_wordcount,
+    "wordwrap": do_wordwrap,
+    "xmlattr": do_xmlattr,
+    "tojson": do_tojson,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/idtracking.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/idtracking.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a0d838017c938fa7a2c4279c4e8edc125608aaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/idtracking.py
@@ -0,0 +1,290 @@
+from ._compat import iteritems
+from .visitor import NodeVisitor
+
+VAR_LOAD_PARAMETER = "param"
+VAR_LOAD_RESOLVE = "resolve"
+VAR_LOAD_ALIAS = "alias"
+VAR_LOAD_UNDEFINED = "undefined"
+
+
+def find_symbols(nodes, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    visitor = FrameSymbolVisitor(sym)
+    for node in nodes:
+        visitor.visit(node)
+    return sym
+
+
+def symbols_for_node(node, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    sym.analyze_node(node)
+    return sym
+
+
+class Symbols(object):
+    def __init__(self, parent=None, level=None):
+        if level is None:
+            if parent is None:
+                level = 0
+            else:
+                level = parent.level + 1
+        self.level = level
+        self.parent = parent
+        self.refs = {}
+        self.loads = {}
+        self.stores = set()
+
+    def analyze_node(self, node, **kwargs):
+        visitor = RootVisitor(self)
+        visitor.visit(node, **kwargs)
+
+    def _define_ref(self, name, load=None):
+        ident = "l_%d_%s" % (self.level, name)
+        self.refs[name] = ident
+        if load is not None:
+            self.loads[ident] = load
+        return ident
+
+    def find_load(self, target):
+        if target in self.loads:
+            return self.loads[target]
+        if self.parent is not None:
+            return self.parent.find_load(target)
+
+    def find_ref(self, name):
+        if name in self.refs:
+            return self.refs[name]
+        if self.parent is not None:
+            return self.parent.find_ref(name)
+
+    def ref(self, name):
+        rv = self.find_ref(name)
+        if rv is None:
+            raise AssertionError(
+                "Tried to resolve a name to a reference that "
+                "was unknown to the frame (%r)" % name
+            )
+        return rv
+
+    def copy(self):
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.refs = self.refs.copy()
+        rv.loads = self.loads.copy()
+        rv.stores = self.stores.copy()
+        return rv
+
+    def store(self, name):
+        self.stores.add(name)
+
+        # If we have not see the name referenced yet, we need to figure
+        # out what to set it to.
+        if name not in self.refs:
+            # If there is a parent scope we check if the name has a
+            # reference there.  If it does it means we might have to alias
+            # to a variable there.
+            if self.parent is not None:
+                outer_ref = self.parent.find_ref(name)
+                if outer_ref is not None:
+                    self._define_ref(name, load=(VAR_LOAD_ALIAS, outer_ref))
+                    return
+
+            # Otherwise we can just set it to undefined.
+            self._define_ref(name, load=(VAR_LOAD_UNDEFINED, None))
+
+    def declare_parameter(self, name):
+        self.stores.add(name)
+        return self._define_ref(name, load=(VAR_LOAD_PARAMETER, None))
+
+    def load(self, name):
+        target = self.find_ref(name)
+        if target is None:
+            self._define_ref(name, load=(VAR_LOAD_RESOLVE, name))
+
+    def branch_update(self, branch_symbols):
+        stores = {}
+        for branch in branch_symbols:
+            for target in branch.stores:
+                if target in self.stores:
+                    continue
+                stores[target] = stores.get(target, 0) + 1
+
+        for sym in branch_symbols:
+            self.refs.update(sym.refs)
+            self.loads.update(sym.loads)
+            self.stores.update(sym.stores)
+
+        for name, branch_count in iteritems(stores):
+            if branch_count == len(branch_symbols):
+                continue
+            target = self.find_ref(name)
+            assert target is not None, "should not happen"
+
+            if self.parent is not None:
+                outer_target = self.parent.find_ref(name)
+                if outer_target is not None:
+                    self.loads[target] = (VAR_LOAD_ALIAS, outer_target)
+                    continue
+            self.loads[target] = (VAR_LOAD_RESOLVE, name)
+
+    def dump_stores(self):
+        rv = {}
+        node = self
+        while node is not None:
+            for name in node.stores:
+                if name not in rv:
+                    rv[name] = self.find_ref(name)
+            node = node.parent
+        return rv
+
+    def dump_param_targets(self):
+        rv = set()
+        node = self
+        while node is not None:
+            for target, (instr, _) in iteritems(self.loads):
+                if instr == VAR_LOAD_PARAMETER:
+                    rv.add(target)
+            node = node.parent
+        return rv
+
+
+class RootVisitor(NodeVisitor):
+    def __init__(self, symbols):
+        self.sym_visitor = FrameSymbolVisitor(symbols)
+
+    def _simple_visit(self, node, **kwargs):
+        for child in node.iter_child_nodes():
+            self.sym_visitor.visit(child)
+
+    visit_Template = (
+        visit_Block
+    ) = (
+        visit_Macro
+    ) = (
+        visit_FilterBlock
+    ) = visit_Scope = visit_If = visit_ScopedEvalContextModifier = _simple_visit
+
+    def visit_AssignBlock(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_CallBlock(self, node, **kwargs):
+        for child in node.iter_child_nodes(exclude=("call",)):
+            self.sym_visitor.visit(child)
+
+    def visit_OverlayScope(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_For(self, node, for_branch="body", **kwargs):
+        if for_branch == "body":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            branch = node.body
+        elif for_branch == "else":
+            branch = node.else_
+        elif for_branch == "test":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            if node.test is not None:
+                self.sym_visitor.visit(node.test)
+            return
+        else:
+            raise RuntimeError("Unknown for branch")
+        for item in branch or ():
+            self.sym_visitor.visit(item)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.targets:
+            self.sym_visitor.visit(target)
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def generic_visit(self, node, *args, **kwargs):
+        raise NotImplementedError(
+            "Cannot find symbols for %r" % node.__class__.__name__
+        )
+
+
+class FrameSymbolVisitor(NodeVisitor):
+    """A visitor for `Frame.inspect`."""
+
+    def __init__(self, symbols):
+        self.symbols = symbols
+
+    def visit_Name(self, node, store_as_param=False, **kwargs):
+        """All assignments to names go through this function."""
+        if store_as_param or node.ctx == "param":
+            self.symbols.declare_parameter(node.name)
+        elif node.ctx == "store":
+            self.symbols.store(node.name)
+        elif node.ctx == "load":
+            self.symbols.load(node.name)
+
+    def visit_NSRef(self, node, **kwargs):
+        self.symbols.load(node.name)
+
+    def visit_If(self, node, **kwargs):
+        self.visit(node.test, **kwargs)
+
+        original_symbols = self.symbols
+
+        def inner_visit(nodes):
+            self.symbols = rv = original_symbols.copy()
+            for subnode in nodes:
+                self.visit(subnode, **kwargs)
+            self.symbols = original_symbols
+            return rv
+
+        body_symbols = inner_visit(node.body)
+        elif_symbols = inner_visit(node.elif_)
+        else_symbols = inner_visit(node.else_ or ())
+
+        self.symbols.branch_update([body_symbols, elif_symbols, else_symbols])
+
+    def visit_Macro(self, node, **kwargs):
+        self.symbols.store(node.name)
+
+    def visit_Import(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        self.symbols.store(node.target)
+
+    def visit_FromImport(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        for name in node.names:
+            if isinstance(name, tuple):
+                self.symbols.store(name[1])
+            else:
+                self.symbols.store(name)
+
+    def visit_Assign(self, node, **kwargs):
+        """Visit assignments in the correct order."""
+        self.visit(node.node, **kwargs)
+        self.visit(node.target, **kwargs)
+
+    def visit_For(self, node, **kwargs):
+        """Visiting stops at for blocks.  However the block sequence
+        is visited as part of the outer scope.
+        """
+        self.visit(node.iter, **kwargs)
+
+    def visit_CallBlock(self, node, **kwargs):
+        self.visit(node.call, **kwargs)
+
+    def visit_FilterBlock(self, node, **kwargs):
+        self.visit(node.filter, **kwargs)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.values:
+            self.visit(target)
+
+    def visit_AssignBlock(self, node, **kwargs):
+        """Stop visiting at block assigns."""
+        self.visit(node.target, **kwargs)
+
+    def visit_Scope(self, node, **kwargs):
+        """Stop visiting at scopes."""
+
+    def visit_Block(self, node, **kwargs):
+        """Stop visiting at blocks."""
+
+    def visit_OverlayScope(self, node, **kwargs):
+        """Do not visit into overlay scopes."""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/lexer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/lexer.py
new file mode 100644
index 0000000000000000000000000000000000000000..552356a12d1d812397bc5b4f0491a1c115c3797a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/lexer.py
@@ -0,0 +1,848 @@
+# -*- coding: utf-8 -*-
+"""Implements a Jinja / Python combination lexer. The ``Lexer`` class
+is used to do some preprocessing. It filters out invalid operators like
+the bitshift operators we don't allow in templates. It separates
+template code and python code in expressions.
+"""
+import re
+from ast import literal_eval
+from collections import deque
+from operator import itemgetter
+
+from ._compat import implements_iterator
+from ._compat import intern
+from ._compat import iteritems
+from ._compat import text_type
+from .exceptions import TemplateSyntaxError
+from .utils import LRUCache
+
+# cache for the lexers. Exists in order to be able to have multiple
+# environments with the same lexer
+_lexer_cache = LRUCache(50)
+
+# static regular expressions
+whitespace_re = re.compile(r"\s+", re.U)
+newline_re = re.compile(r"(\r\n|\r|\n)")
+string_re = re.compile(
+    r"('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S
+)
+integer_re = re.compile(r"(\d+_)*\d+")
+float_re = re.compile(
+    r"""
+    (?<!\.)  # doesn't start with a .
+    (\d+_)*\d+  # digits, possibly _ separated
+    (
+        (\.(\d+_)*\d+)?  # optional fractional part
+        e[+\-]?(\d+_)*\d+  # exponent part
+    |
+        \.(\d+_)*\d+  # required fractional part
+    )
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+
+try:
+    # check if this Python supports Unicode identifiers
+    compile("föö", "<unknown>", "eval")
+except SyntaxError:
+    # Python 2, no Unicode support, use ASCII identifiers
+    name_re = re.compile(r"[a-zA-Z_][a-zA-Z0-9_]*")
+    check_ident = False
+else:
+    # Unicode support, import generated re pattern and set flag to use
+    # str.isidentifier to validate during lexing.
+    from ._identifier import pattern as name_re
+
+    check_ident = True
+
+# internal the tokens and keep references to them
+TOKEN_ADD = intern("add")
+TOKEN_ASSIGN = intern("assign")
+TOKEN_COLON = intern("colon")
+TOKEN_COMMA = intern("comma")
+TOKEN_DIV = intern("div")
+TOKEN_DOT = intern("dot")
+TOKEN_EQ = intern("eq")
+TOKEN_FLOORDIV = intern("floordiv")
+TOKEN_GT = intern("gt")
+TOKEN_GTEQ = intern("gteq")
+TOKEN_LBRACE = intern("lbrace")
+TOKEN_LBRACKET = intern("lbracket")
+TOKEN_LPAREN = intern("lparen")
+TOKEN_LT = intern("lt")
+TOKEN_LTEQ = intern("lteq")
+TOKEN_MOD = intern("mod")
+TOKEN_MUL = intern("mul")
+TOKEN_NE = intern("ne")
+TOKEN_PIPE = intern("pipe")
+TOKEN_POW = intern("pow")
+TOKEN_RBRACE = intern("rbrace")
+TOKEN_RBRACKET = intern("rbracket")
+TOKEN_RPAREN = intern("rparen")
+TOKEN_SEMICOLON = intern("semicolon")
+TOKEN_SUB = intern("sub")
+TOKEN_TILDE = intern("tilde")
+TOKEN_WHITESPACE = intern("whitespace")
+TOKEN_FLOAT = intern("float")
+TOKEN_INTEGER = intern("integer")
+TOKEN_NAME = intern("name")
+TOKEN_STRING = intern("string")
+TOKEN_OPERATOR = intern("operator")
+TOKEN_BLOCK_BEGIN = intern("block_begin")
+TOKEN_BLOCK_END = intern("block_end")
+TOKEN_VARIABLE_BEGIN = intern("variable_begin")
+TOKEN_VARIABLE_END = intern("variable_end")
+TOKEN_RAW_BEGIN = intern("raw_begin")
+TOKEN_RAW_END = intern("raw_end")
+TOKEN_COMMENT_BEGIN = intern("comment_begin")
+TOKEN_COMMENT_END = intern("comment_end")
+TOKEN_COMMENT = intern("comment")
+TOKEN_LINESTATEMENT_BEGIN = intern("linestatement_begin")
+TOKEN_LINESTATEMENT_END = intern("linestatement_end")
+TOKEN_LINECOMMENT_BEGIN = intern("linecomment_begin")
+TOKEN_LINECOMMENT_END = intern("linecomment_end")
+TOKEN_LINECOMMENT = intern("linecomment")
+TOKEN_DATA = intern("data")
+TOKEN_INITIAL = intern("initial")
+TOKEN_EOF = intern("eof")
+
+# bind operators to token types
+operators = {
+    "+": TOKEN_ADD,
+    "-": TOKEN_SUB,
+    "/": TOKEN_DIV,
+    "//": TOKEN_FLOORDIV,
+    "*": TOKEN_MUL,
+    "%": TOKEN_MOD,
+    "**": TOKEN_POW,
+    "~": TOKEN_TILDE,
+    "[": TOKEN_LBRACKET,
+    "]": TOKEN_RBRACKET,
+    "(": TOKEN_LPAREN,
+    ")": TOKEN_RPAREN,
+    "{": TOKEN_LBRACE,
+    "}": TOKEN_RBRACE,
+    "==": TOKEN_EQ,
+    "!=": TOKEN_NE,
+    ">": TOKEN_GT,
+    ">=": TOKEN_GTEQ,
+    "<": TOKEN_LT,
+    "<=": TOKEN_LTEQ,
+    "=": TOKEN_ASSIGN,
+    ".": TOKEN_DOT,
+    ":": TOKEN_COLON,
+    "|": TOKEN_PIPE,
+    ",": TOKEN_COMMA,
+    ";": TOKEN_SEMICOLON,
+}
+
+reverse_operators = dict([(v, k) for k, v in iteritems(operators)])
+assert len(operators) == len(reverse_operators), "operators dropped"
+operator_re = re.compile(
+    "(%s)" % "|".join(re.escape(x) for x in sorted(operators, key=lambda x: -len(x)))
+)
+
+ignored_tokens = frozenset(
+    [
+        TOKEN_COMMENT_BEGIN,
+        TOKEN_COMMENT,
+        TOKEN_COMMENT_END,
+        TOKEN_WHITESPACE,
+        TOKEN_LINECOMMENT_BEGIN,
+        TOKEN_LINECOMMENT_END,
+        TOKEN_LINECOMMENT,
+    ]
+)
+ignore_if_empty = frozenset(
+    [TOKEN_WHITESPACE, TOKEN_DATA, TOKEN_COMMENT, TOKEN_LINECOMMENT]
+)
+
+
+def _describe_token_type(token_type):
+    if token_type in reverse_operators:
+        return reverse_operators[token_type]
+    return {
+        TOKEN_COMMENT_BEGIN: "begin of comment",
+        TOKEN_COMMENT_END: "end of comment",
+        TOKEN_COMMENT: "comment",
+        TOKEN_LINECOMMENT: "comment",
+        TOKEN_BLOCK_BEGIN: "begin of statement block",
+        TOKEN_BLOCK_END: "end of statement block",
+        TOKEN_VARIABLE_BEGIN: "begin of print statement",
+        TOKEN_VARIABLE_END: "end of print statement",
+        TOKEN_LINESTATEMENT_BEGIN: "begin of line statement",
+        TOKEN_LINESTATEMENT_END: "end of line statement",
+        TOKEN_DATA: "template data / text",
+        TOKEN_EOF: "end of template",
+    }.get(token_type, token_type)
+
+
+def describe_token(token):
+    """Returns a description of the token."""
+    if token.type == TOKEN_NAME:
+        return token.value
+    return _describe_token_type(token.type)
+
+
+def describe_token_expr(expr):
+    """Like `describe_token` but for token expressions."""
+    if ":" in expr:
+        type, value = expr.split(":", 1)
+        if type == TOKEN_NAME:
+            return value
+    else:
+        type = expr
+    return _describe_token_type(type)
+
+
+def count_newlines(value):
+    """Count the number of newline characters in the string.  This is
+    useful for extensions that filter a stream.
+    """
+    return len(newline_re.findall(value))
+
+
+def compile_rules(environment):
+    """Compiles all the rules from the environment into a list of rules."""
+    e = re.escape
+    rules = [
+        (
+            len(environment.comment_start_string),
+            TOKEN_COMMENT_BEGIN,
+            e(environment.comment_start_string),
+        ),
+        (
+            len(environment.block_start_string),
+            TOKEN_BLOCK_BEGIN,
+            e(environment.block_start_string),
+        ),
+        (
+            len(environment.variable_start_string),
+            TOKEN_VARIABLE_BEGIN,
+            e(environment.variable_start_string),
+        ),
+    ]
+
+    if environment.line_statement_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_statement_prefix),
+                TOKEN_LINESTATEMENT_BEGIN,
+                r"^[ \t\v]*" + e(environment.line_statement_prefix),
+            )
+        )
+    if environment.line_comment_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_comment_prefix),
+                TOKEN_LINECOMMENT_BEGIN,
+                r"(?:^|(?<=\S))[^\S\r\n]*" + e(environment.line_comment_prefix),
+            )
+        )
+
+    return [x[1:] for x in sorted(rules, reverse=True)]
+
+
+class Failure(object):
+    """Class that raises a `TemplateSyntaxError` if called.
+    Used by the `Lexer` to specify known errors.
+    """
+
+    def __init__(self, message, cls=TemplateSyntaxError):
+        self.message = message
+        self.error_class = cls
+
+    def __call__(self, lineno, filename):
+        raise self.error_class(self.message, lineno, filename)
+
+
+class Token(tuple):
+    """Token class."""
+
+    __slots__ = ()
+    lineno, type, value = (property(itemgetter(x)) for x in range(3))
+
+    def __new__(cls, lineno, type, value):
+        return tuple.__new__(cls, (lineno, intern(str(type)), value))
+
+    def __str__(self):
+        if self.type in reverse_operators:
+            return reverse_operators[self.type]
+        elif self.type == "name":
+            return self.value
+        return self.type
+
+    def test(self, expr):
+        """Test a token against a token expression.  This can either be a
+        token type or ``'token_type:token_value'``.  This can only test
+        against string values and types.
+        """
+        # here we do a regular string equality check as test_any is usually
+        # passed an iterable of not interned strings.
+        if self.type == expr:
+            return True
+        elif ":" in expr:
+            return expr.split(":", 1) == [self.type, self.value]
+        return False
+
+    def test_any(self, *iterable):
+        """Test against multiple token expressions."""
+        for expr in iterable:
+            if self.test(expr):
+                return True
+        return False
+
+    def __repr__(self):
+        return "Token(%r, %r, %r)" % (self.lineno, self.type, self.value)
+
+
+@implements_iterator
+class TokenStreamIterator(object):
+    """The iterator for tokenstreams.  Iterate over the stream
+    until the eof token is reached.
+    """
+
+    def __init__(self, stream):
+        self.stream = stream
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        token = self.stream.current
+        if token.type is TOKEN_EOF:
+            self.stream.close()
+            raise StopIteration()
+        next(self.stream)
+        return token
+
+
+@implements_iterator
+class TokenStream(object):
+    """A token stream is an iterable that yields :class:`Token`\\s.  The
+    parser however does not iterate over it but calls :meth:`next` to go
+    one token ahead.  The current active token is stored as :attr:`current`.
+    """
+
+    def __init__(self, generator, name, filename):
+        self._iter = iter(generator)
+        self._pushed = deque()
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.current = Token(1, TOKEN_INITIAL, "")
+        next(self)
+
+    def __iter__(self):
+        return TokenStreamIterator(self)
+
+    def __bool__(self):
+        return bool(self._pushed) or self.current.type is not TOKEN_EOF
+
+    __nonzero__ = __bool__  # py2
+
+    @property
+    def eos(self):
+        """Are we at the end of the stream?"""
+        return not self
+
+    def push(self, token):
+        """Push a token back to the stream."""
+        self._pushed.append(token)
+
+    def look(self):
+        """Look at the next token."""
+        old_token = next(self)
+        result = self.current
+        self.push(result)
+        self.current = old_token
+        return result
+
+    def skip(self, n=1):
+        """Got n tokens ahead."""
+        for _ in range(n):
+            next(self)
+
+    def next_if(self, expr):
+        """Perform the token test and return the token if it matched.
+        Otherwise the return value is `None`.
+        """
+        if self.current.test(expr):
+            return next(self)
+
+    def skip_if(self, expr):
+        """Like :meth:`next_if` but only returns `True` or `False`."""
+        return self.next_if(expr) is not None
+
+    def __next__(self):
+        """Go one token ahead and return the old one.
+
+        Use the built-in :func:`next` instead of calling this directly.
+        """
+        rv = self.current
+        if self._pushed:
+            self.current = self._pushed.popleft()
+        elif self.current.type is not TOKEN_EOF:
+            try:
+                self.current = next(self._iter)
+            except StopIteration:
+                self.close()
+        return rv
+
+    def close(self):
+        """Close the stream."""
+        self.current = Token(self.current.lineno, TOKEN_EOF, "")
+        self._iter = None
+        self.closed = True
+
+    def expect(self, expr):
+        """Expect a given token type and return it.  This accepts the same
+        argument as :meth:`jinja2.lexer.Token.test`.
+        """
+        if not self.current.test(expr):
+            expr = describe_token_expr(expr)
+            if self.current.type is TOKEN_EOF:
+                raise TemplateSyntaxError(
+                    "unexpected end of template, expected %r." % expr,
+                    self.current.lineno,
+                    self.name,
+                    self.filename,
+                )
+            raise TemplateSyntaxError(
+                "expected token %r, got %r" % (expr, describe_token(self.current)),
+                self.current.lineno,
+                self.name,
+                self.filename,
+            )
+        try:
+            return self.current
+        finally:
+            next(self)
+
+
+def get_lexer(environment):
+    """Return a lexer which is probably cached."""
+    key = (
+        environment.block_start_string,
+        environment.block_end_string,
+        environment.variable_start_string,
+        environment.variable_end_string,
+        environment.comment_start_string,
+        environment.comment_end_string,
+        environment.line_statement_prefix,
+        environment.line_comment_prefix,
+        environment.trim_blocks,
+        environment.lstrip_blocks,
+        environment.newline_sequence,
+        environment.keep_trailing_newline,
+    )
+    lexer = _lexer_cache.get(key)
+    if lexer is None:
+        lexer = Lexer(environment)
+        _lexer_cache[key] = lexer
+    return lexer
+
+
+class OptionalLStrip(tuple):
+    """A special tuple for marking a point in the state that can have
+    lstrip applied.
+    """
+
+    __slots__ = ()
+
+    # Even though it looks like a no-op, creating instances fails
+    # without this.
+    def __new__(cls, *members, **kwargs):
+        return super(OptionalLStrip, cls).__new__(cls, members)
+
+
+class Lexer(object):
+    """Class that implements a lexer for a given environment. Automatically
+    created by the environment class, usually you don't have to do that.
+
+    Note that the lexer is not automatically bound to an environment.
+    Multiple environments can share the same lexer.
+    """
+
+    def __init__(self, environment):
+        # shortcuts
+        e = re.escape
+
+        def c(x):
+            return re.compile(x, re.M | re.S)
+
+        # lexing rules for tags
+        tag_rules = [
+            (whitespace_re, TOKEN_WHITESPACE, None),
+            (float_re, TOKEN_FLOAT, None),
+            (integer_re, TOKEN_INTEGER, None),
+            (name_re, TOKEN_NAME, None),
+            (string_re, TOKEN_STRING, None),
+            (operator_re, TOKEN_OPERATOR, None),
+        ]
+
+        # assemble the root lexing rule. because "|" is ungreedy
+        # we have to sort by length so that the lexer continues working
+        # as expected when we have parsing rules like <% for block and
+        # <%= for variables. (if someone wants asp like syntax)
+        # variables are just part of the rules if variable processing
+        # is required.
+        root_tag_rules = compile_rules(environment)
+
+        # block suffix if trimming is enabled
+        block_suffix_re = environment.trim_blocks and "\\n?" or ""
+
+        # If lstrip is enabled, it should not be applied if there is any
+        # non-whitespace between the newline and block.
+        self.lstrip_unless_re = c(r"[^ \t]") if environment.lstrip_blocks else None
+
+        self.newline_sequence = environment.newline_sequence
+        self.keep_trailing_newline = environment.keep_trailing_newline
+
+        # global lexing rules
+        self.rules = {
+            "root": [
+                # directives
+                (
+                    c(
+                        "(.*?)(?:%s)"
+                        % "|".join(
+                            [
+                                r"(?P<raw_begin>%s(\-|\+|)\s*raw\s*(?:\-%s\s*|%s))"
+                                % (
+                                    e(environment.block_start_string),
+                                    e(environment.block_end_string),
+                                    e(environment.block_end_string),
+                                )
+                            ]
+                            + [
+                                r"(?P<%s>%s(\-|\+|))" % (n, r)
+                                for n, r in root_tag_rules
+                            ]
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, "#bygroup"),
+                    "#bygroup",
+                ),
+                # data
+                (c(".+"), TOKEN_DATA, None),
+            ],
+            # comments
+            TOKEN_COMMENT_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:\-%s\s*|%s)%s)"
+                        % (
+                            e(environment.comment_end_string),
+                            e(environment.comment_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    (TOKEN_COMMENT, TOKEN_COMMENT_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of comment tag"),), None),
+            ],
+            # blocks
+            TOKEN_BLOCK_BEGIN: [
+                (
+                    c(
+                        r"(?:\-%s\s*|%s)%s"
+                        % (
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    TOKEN_BLOCK_END,
+                    "#pop",
+                ),
+            ]
+            + tag_rules,
+            # variables
+            TOKEN_VARIABLE_BEGIN: [
+                (
+                    c(
+                        r"\-%s\s*|%s"
+                        % (
+                            e(environment.variable_end_string),
+                            e(environment.variable_end_string),
+                        )
+                    ),
+                    TOKEN_VARIABLE_END,
+                    "#pop",
+                )
+            ]
+            + tag_rules,
+            # raw block
+            TOKEN_RAW_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:%s(\-|\+|))\s*endraw\s*(?:\-%s\s*|%s%s))"
+                        % (
+                            e(environment.block_start_string),
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, TOKEN_RAW_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of raw directive"),), None),
+            ],
+            # line statements
+            TOKEN_LINESTATEMENT_BEGIN: [
+                (c(r"\s*(\n|$)"), TOKEN_LINESTATEMENT_END, "#pop")
+            ]
+            + tag_rules,
+            # line comments
+            TOKEN_LINECOMMENT_BEGIN: [
+                (
+                    c(r"(.*?)()(?=\n|$)"),
+                    (TOKEN_LINECOMMENT, TOKEN_LINECOMMENT_END),
+                    "#pop",
+                )
+            ],
+        }
+
+    def _normalize_newlines(self, value):
+        """Called for strings and template data to normalize it to unicode."""
+        return newline_re.sub(self.newline_sequence, value)
+
+    def tokenize(self, source, name=None, filename=None, state=None):
+        """Calls tokeniter + tokenize and wraps it in a token stream."""
+        stream = self.tokeniter(source, name, filename, state)
+        return TokenStream(self.wrap(stream, name, filename), name, filename)
+
+    def wrap(self, stream, name=None, filename=None):
+        """This is called with the stream as returned by `tokenize` and wraps
+        every token in a :class:`Token` and converts the value.
+        """
+        for lineno, token, value in stream:
+            if token in ignored_tokens:
+                continue
+            elif token == TOKEN_LINESTATEMENT_BEGIN:
+                token = TOKEN_BLOCK_BEGIN
+            elif token == TOKEN_LINESTATEMENT_END:
+                token = TOKEN_BLOCK_END
+            # we are not interested in those tokens in the parser
+            elif token in (TOKEN_RAW_BEGIN, TOKEN_RAW_END):
+                continue
+            elif token == TOKEN_DATA:
+                value = self._normalize_newlines(value)
+            elif token == "keyword":
+                token = value
+            elif token == TOKEN_NAME:
+                value = str(value)
+                if check_ident and not value.isidentifier():
+                    raise TemplateSyntaxError(
+                        "Invalid character in identifier", lineno, name, filename
+                    )
+            elif token == TOKEN_STRING:
+                # try to unescape string
+                try:
+                    value = (
+                        self._normalize_newlines(value[1:-1])
+                        .encode("ascii", "backslashreplace")
+                        .decode("unicode-escape")
+                    )
+                except Exception as e:
+                    msg = str(e).split(":")[-1].strip()
+                    raise TemplateSyntaxError(msg, lineno, name, filename)
+            elif token == TOKEN_INTEGER:
+                value = int(value.replace("_", ""))
+            elif token == TOKEN_FLOAT:
+                # remove all "_" first to support more Python versions
+                value = literal_eval(value.replace("_", ""))
+            elif token == TOKEN_OPERATOR:
+                token = operators[value]
+            yield Token(lineno, token, value)
+
+    def tokeniter(self, source, name, filename=None, state=None):
+        """This method tokenizes the text and returns the tokens in a
+        generator.  Use this method if you just want to tokenize a template.
+        """
+        source = text_type(source)
+        lines = source.splitlines()
+        if self.keep_trailing_newline and source:
+            for newline in ("\r\n", "\r", "\n"):
+                if source.endswith(newline):
+                    lines.append("")
+                    break
+        source = "\n".join(lines)
+        pos = 0
+        lineno = 1
+        stack = ["root"]
+        if state is not None and state != "root":
+            assert state in ("variable", "block"), "invalid state"
+            stack.append(state + "_begin")
+        statetokens = self.rules[stack[-1]]
+        source_length = len(source)
+        balancing_stack = []
+        lstrip_unless_re = self.lstrip_unless_re
+        newlines_stripped = 0
+        line_starting = True
+
+        while 1:
+            # tokenizer loop
+            for regex, tokens, new_state in statetokens:
+                m = regex.match(source, pos)
+                # if no match we try again with the next rule
+                if m is None:
+                    continue
+
+                # we only match blocks and variables if braces / parentheses
+                # are balanced. continue parsing with the lower rule which
+                # is the operator rule. do this only if the end tags look
+                # like operators
+                if balancing_stack and tokens in (
+                    TOKEN_VARIABLE_END,
+                    TOKEN_BLOCK_END,
+                    TOKEN_LINESTATEMENT_END,
+                ):
+                    continue
+
+                # tuples support more options
+                if isinstance(tokens, tuple):
+                    groups = m.groups()
+
+                    if isinstance(tokens, OptionalLStrip):
+                        # Rule supports lstrip. Match will look like
+                        # text, block type, whitespace control, type, control, ...
+                        text = groups[0]
+
+                        # Skipping the text and first type, every other group is the
+                        # whitespace control for each type. One of the groups will be
+                        # -, +, or empty string instead of None.
+                        strip_sign = next(g for g in groups[2::2] if g is not None)
+
+                        if strip_sign == "-":
+                            # Strip all whitespace between the text and the tag.
+                            stripped = text.rstrip()
+                            newlines_stripped = text[len(stripped) :].count("\n")
+                            groups = (stripped,) + groups[1:]
+                        elif (
+                            # Not marked for preserving whitespace.
+                            strip_sign != "+"
+                            # lstrip is enabled.
+                            and lstrip_unless_re is not None
+                            # Not a variable expression.
+                            and not m.groupdict().get(TOKEN_VARIABLE_BEGIN)
+                        ):
+                            # The start of text between the last newline and the tag.
+                            l_pos = text.rfind("\n") + 1
+                            if l_pos > 0 or line_starting:
+                                # If there's only whitespace between the newline and the
+                                # tag, strip it.
+                                if not lstrip_unless_re.search(text, l_pos):
+                                    groups = (text[:l_pos],) + groups[1:]
+
+                    for idx, token in enumerate(tokens):
+                        # failure group
+                        if token.__class__ is Failure:
+                            raise token(lineno, filename)
+                        # bygroup is a bit more complex, in that case we
+                        # yield for the current token the first named
+                        # group that matched
+                        elif token == "#bygroup":
+                            for key, value in iteritems(m.groupdict()):
+                                if value is not None:
+                                    yield lineno, key, value
+                                    lineno += value.count("\n")
+                                    break
+                            else:
+                                raise RuntimeError(
+                                    "%r wanted to resolve "
+                                    "the token dynamically"
+                                    " but no group matched" % regex
+                                )
+                        # normal group
+                        else:
+                            data = groups[idx]
+                            if data or token not in ignore_if_empty:
+                                yield lineno, token, data
+                            lineno += data.count("\n") + newlines_stripped
+                            newlines_stripped = 0
+
+                # strings as token just are yielded as it.
+                else:
+                    data = m.group()
+                    # update brace/parentheses balance
+                    if tokens == TOKEN_OPERATOR:
+                        if data == "{":
+                            balancing_stack.append("}")
+                        elif data == "(":
+                            balancing_stack.append(")")
+                        elif data == "[":
+                            balancing_stack.append("]")
+                        elif data in ("}", ")", "]"):
+                            if not balancing_stack:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s'" % data, lineno, name, filename
+                                )
+                            expected_op = balancing_stack.pop()
+                            if expected_op != data:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s', "
+                                    "expected '%s'" % (data, expected_op),
+                                    lineno,
+                                    name,
+                                    filename,
+                                )
+                    # yield items
+                    if data or tokens not in ignore_if_empty:
+                        yield lineno, tokens, data
+                    lineno += data.count("\n")
+
+                line_starting = m.group()[-1:] == "\n"
+
+                # fetch new position into new variable so that we can check
+                # if there is a internal parsing error which would result
+                # in an infinite loop
+                pos2 = m.end()
+
+                # handle state changes
+                if new_state is not None:
+                    # remove the uppermost state
+                    if new_state == "#pop":
+                        stack.pop()
+                    # resolve the new state by group checking
+                    elif new_state == "#bygroup":
+                        for key, value in iteritems(m.groupdict()):
+                            if value is not None:
+                                stack.append(key)
+                                break
+                        else:
+                            raise RuntimeError(
+                                "%r wanted to resolve the "
+                                "new state dynamically but"
+                                " no group matched" % regex
+                            )
+                    # direct state name given
+                    else:
+                        stack.append(new_state)
+                    statetokens = self.rules[stack[-1]]
+                # we are still at the same position and no stack change.
+                # this means a loop without break condition, avoid that and
+                # raise error
+                elif pos2 == pos:
+                    raise RuntimeError(
+                        "%r yielded empty string without stack change" % regex
+                    )
+                # publish new function and start again
+                pos = pos2
+                break
+            # if loop terminated without break we haven't found a single match
+            # either we are at the end of the file or we have a problem
+            else:
+                # end of text
+                if pos >= source_length:
+                    return
+                # something went wrong
+                raise TemplateSyntaxError(
+                    "unexpected char %r at %d" % (source[pos], pos),
+                    lineno,
+                    name,
+                    filename,
+                )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/loaders.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/loaders.py
new file mode 100644
index 0000000000000000000000000000000000000000..457c4b59a72173f726a6aa9e980d2d321ce1e183
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/loaders.py
@@ -0,0 +1,504 @@
+# -*- coding: utf-8 -*-
+"""API and implementations for loading templates from different data
+sources.
+"""
+import os
+import sys
+import weakref
+from hashlib import sha1
+from os import path
+from types import ModuleType
+
+from ._compat import abc
+from ._compat import fspath
+from ._compat import iteritems
+from ._compat import string_types
+from .exceptions import TemplateNotFound
+from .utils import internalcode
+from .utils import open_if_exists
+
+
+def split_template_path(template):
+    """Split a path into segments and perform a sanity check.  If it detects
+    '..' in the path it will raise a `TemplateNotFound` error.
+    """
+    pieces = []
+    for piece in template.split("/"):
+        if (
+            path.sep in piece
+            or (path.altsep and path.altsep in piece)
+            or piece == path.pardir
+        ):
+            raise TemplateNotFound(template)
+        elif piece and piece != ".":
+            pieces.append(piece)
+    return pieces
+
+
+class BaseLoader(object):
+    """Baseclass for all loaders.  Subclass this and override `get_source` to
+    implement a custom loading mechanism.  The environment provides a
+    `get_template` method that calls the loader's `load` method to get the
+    :class:`Template` object.
+
+    A very basic example for a loader that looks up templates on the file
+    system could look like this::
+
+        from jinja2 import BaseLoader, TemplateNotFound
+        from os.path import join, exists, getmtime
+
+        class MyLoader(BaseLoader):
+
+            def __init__(self, path):
+                self.path = path
+
+            def get_source(self, environment, template):
+                path = join(self.path, template)
+                if not exists(path):
+                    raise TemplateNotFound(template)
+                mtime = getmtime(path)
+                with file(path) as f:
+                    source = f.read().decode('utf-8')
+                return source, path, lambda: mtime == getmtime(path)
+    """
+
+    #: if set to `False` it indicates that the loader cannot provide access
+    #: to the source of templates.
+    #:
+    #: .. versionadded:: 2.4
+    has_source_access = True
+
+    def get_source(self, environment, template):
+        """Get the template source, filename and reload helper for a template.
+        It's passed the environment and template name and has to return a
+        tuple in the form ``(source, filename, uptodate)`` or raise a
+        `TemplateNotFound` error if it can't locate the template.
+
+        The source part of the returned tuple must be the source of the
+        template as unicode string or a ASCII bytestring.  The filename should
+        be the name of the file on the filesystem if it was loaded from there,
+        otherwise `None`.  The filename is used by python for the tracebacks
+        if no loader extension is used.
+
+        The last item in the tuple is the `uptodate` function.  If auto
+        reloading is enabled it's always called to check if the template
+        changed.  No arguments are passed so the function must store the
+        old state somewhere (for example in a closure).  If it returns `False`
+        the template will be reloaded.
+        """
+        if not self.has_source_access:
+            raise RuntimeError(
+                "%s cannot provide access to the source" % self.__class__.__name__
+            )
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        """Iterates over all templates.  If the loader does not support that
+        it should raise a :exc:`TypeError` which is the default behavior.
+        """
+        raise TypeError("this loader cannot iterate over all templates")
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        """Loads a template.  This method looks up the template in the cache
+        or loads one by calling :meth:`get_source`.  Subclasses should not
+        override this method as loaders working on collections of other
+        loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
+        will not call this method but `get_source` directly.
+        """
+        code = None
+        if globals is None:
+            globals = {}
+
+        # first we try to get the source for this template together
+        # with the filename and the uptodate function.
+        source, filename, uptodate = self.get_source(environment, name)
+
+        # try to load the code from the bytecode cache if there is a
+        # bytecode cache configured.
+        bcc = environment.bytecode_cache
+        if bcc is not None:
+            bucket = bcc.get_bucket(environment, name, filename, source)
+            code = bucket.code
+
+        # if we don't have code so far (not cached, no longer up to
+        # date) etc. we compile the template
+        if code is None:
+            code = environment.compile(source, name, filename)
+
+        # if the bytecode cache is available and the bucket doesn't
+        # have a code so far, we give the bucket the new code and put
+        # it back to the bytecode cache.
+        if bcc is not None and bucket.code is None:
+            bucket.code = code
+            bcc.set_bucket(bucket)
+
+        return environment.template_class.from_code(
+            environment, code, globals, uptodate
+        )
+
+
+class FileSystemLoader(BaseLoader):
+    """Loads templates from the file system.  This loader can find templates
+    in folders on the file system and is the preferred way to load them.
+
+    The loader takes the path to the templates as string, or if multiple
+    locations are wanted a list of them which is then looked up in the
+    given order::
+
+    >>> loader = FileSystemLoader('/path/to/templates')
+    >>> loader = FileSystemLoader(['/path/to/templates', '/other/path'])
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.
+
+    To follow symbolic links, set the *followlinks* parameter to ``True``::
+
+    >>> loader = FileSystemLoader('/path/to/templates', followlinks=True)
+
+    .. versionchanged:: 2.8
+       The ``followlinks`` parameter was added.
+    """
+
+    def __init__(self, searchpath, encoding="utf-8", followlinks=False):
+        if not isinstance(searchpath, abc.Iterable) or isinstance(
+            searchpath, string_types
+        ):
+            searchpath = [searchpath]
+
+        # In Python 3.5, os.path.join doesn't support Path. This can be
+        # simplified to list(searchpath) when Python 3.5 is dropped.
+        self.searchpath = [fspath(p) for p in searchpath]
+
+        self.encoding = encoding
+        self.followlinks = followlinks
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        for searchpath in self.searchpath:
+            filename = path.join(searchpath, *pieces)
+            f = open_if_exists(filename)
+            if f is None:
+                continue
+            try:
+                contents = f.read().decode(self.encoding)
+            finally:
+                f.close()
+
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+            return contents, filename, uptodate
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        found = set()
+        for searchpath in self.searchpath:
+            walk_dir = os.walk(searchpath, followlinks=self.followlinks)
+            for dirpath, _, filenames in walk_dir:
+                for filename in filenames:
+                    template = (
+                        os.path.join(dirpath, filename)[len(searchpath) :]
+                        .strip(os.path.sep)
+                        .replace(os.path.sep, "/")
+                    )
+                    if template[:2] == "./":
+                        template = template[2:]
+                    if template not in found:
+                        found.add(template)
+        return sorted(found)
+
+
+class PackageLoader(BaseLoader):
+    """Load templates from python eggs or packages.  It is constructed with
+    the name of the python package and the path to the templates in that
+    package::
+
+        loader = PackageLoader('mypackage', 'views')
+
+    If the package path is not given, ``'templates'`` is assumed.
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.  Due to the nature
+    of eggs it's only possible to reload templates if the package was loaded
+    from the file system and not a zip file.
+    """
+
+    def __init__(self, package_name, package_path="templates", encoding="utf-8"):
+        from pkg_resources import DefaultProvider
+        from pkg_resources import get_provider
+        from pkg_resources import ResourceManager
+
+        provider = get_provider(package_name)
+        self.encoding = encoding
+        self.manager = ResourceManager()
+        self.filesystem_bound = isinstance(provider, DefaultProvider)
+        self.provider = provider
+        self.package_path = package_path
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        p = "/".join((self.package_path,) + tuple(pieces))
+
+        if not self.provider.has_resource(p):
+            raise TemplateNotFound(template)
+
+        filename = uptodate = None
+
+        if self.filesystem_bound:
+            filename = self.provider.get_resource_filename(self.manager, p)
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+        source = self.provider.get_resource_string(self.manager, p)
+        return source.decode(self.encoding), filename, uptodate
+
+    def list_templates(self):
+        path = self.package_path
+
+        if path[:2] == "./":
+            path = path[2:]
+        elif path == ".":
+            path = ""
+
+        offset = len(path)
+        results = []
+
+        def _walk(path):
+            for filename in self.provider.resource_listdir(path):
+                fullname = path + "/" + filename
+
+                if self.provider.resource_isdir(fullname):
+                    _walk(fullname)
+                else:
+                    results.append(fullname[offset:].lstrip("/"))
+
+        _walk(path)
+        results.sort()
+        return results
+
+
+class DictLoader(BaseLoader):
+    """Loads a template from a python dict.  It's passed a dict of unicode
+    strings bound to template names.  This loader is useful for unittesting:
+
+    >>> loader = DictLoader({'index.html': 'source here'})
+
+    Because auto reloading is rarely useful this is disabled per default.
+    """
+
+    def __init__(self, mapping):
+        self.mapping = mapping
+
+    def get_source(self, environment, template):
+        if template in self.mapping:
+            source = self.mapping[template]
+            return source, None, lambda: source == self.mapping.get(template)
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        return sorted(self.mapping)
+
+
+class FunctionLoader(BaseLoader):
+    """A loader that is passed a function which does the loading.  The
+    function receives the name of the template and has to return either
+    an unicode string with the template source, a tuple in the form ``(source,
+    filename, uptodatefunc)`` or `None` if the template does not exist.
+
+    >>> def load_template(name):
+    ...     if name == 'index.html':
+    ...         return '...'
+    ...
+    >>> loader = FunctionLoader(load_template)
+
+    The `uptodatefunc` is a function that is called if autoreload is enabled
+    and has to return `True` if the template is still up to date.  For more
+    details have a look at :meth:`BaseLoader.get_source` which has the same
+    return value.
+    """
+
+    def __init__(self, load_func):
+        self.load_func = load_func
+
+    def get_source(self, environment, template):
+        rv = self.load_func(template)
+        if rv is None:
+            raise TemplateNotFound(template)
+        elif isinstance(rv, string_types):
+            return rv, None, None
+        return rv
+
+
+class PrefixLoader(BaseLoader):
+    """A loader that is passed a dict of loaders where each loader is bound
+    to a prefix.  The prefix is delimited from the template by a slash per
+    default, which can be changed by setting the `delimiter` argument to
+    something else::
+
+        loader = PrefixLoader({
+            'app1':     PackageLoader('mypackage.app1'),
+            'app2':     PackageLoader('mypackage.app2')
+        })
+
+    By loading ``'app1/index.html'`` the file from the app1 package is loaded,
+    by loading ``'app2/index.html'`` the file from the second.
+    """
+
+    def __init__(self, mapping, delimiter="/"):
+        self.mapping = mapping
+        self.delimiter = delimiter
+
+    def get_loader(self, template):
+        try:
+            prefix, name = template.split(self.delimiter, 1)
+            loader = self.mapping[prefix]
+        except (ValueError, KeyError):
+            raise TemplateNotFound(template)
+        return loader, name
+
+    def get_source(self, environment, template):
+        loader, name = self.get_loader(template)
+        try:
+            return loader.get_source(environment, name)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        loader, local_name = self.get_loader(name)
+        try:
+            return loader.load(environment, local_name, globals)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(name)
+
+    def list_templates(self):
+        result = []
+        for prefix, loader in iteritems(self.mapping):
+            for template in loader.list_templates():
+                result.append(prefix + self.delimiter + template)
+        return result
+
+
+class ChoiceLoader(BaseLoader):
+    """This loader works like the `PrefixLoader` just that no prefix is
+    specified.  If a template could not be found by one loader the next one
+    is tried.
+
+    >>> loader = ChoiceLoader([
+    ...     FileSystemLoader('/path/to/user/templates'),
+    ...     FileSystemLoader('/path/to/system/templates')
+    ... ])
+
+    This is useful if you want to allow users to override builtin templates
+    from a different location.
+    """
+
+    def __init__(self, loaders):
+        self.loaders = loaders
+
+    def get_source(self, environment, template):
+        for loader in self.loaders:
+            try:
+                return loader.get_source(environment, template)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        for loader in self.loaders:
+            try:
+                return loader.load(environment, name, globals)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(name)
+
+    def list_templates(self):
+        found = set()
+        for loader in self.loaders:
+            found.update(loader.list_templates())
+        return sorted(found)
+
+
+class _TemplateModule(ModuleType):
+    """Like a normal module but with support for weak references"""
+
+
+class ModuleLoader(BaseLoader):
+    """This loader loads templates from precompiled templates.
+
+    Example usage:
+
+    >>> loader = ChoiceLoader([
+    ...     ModuleLoader('/path/to/compiled/templates'),
+    ...     FileSystemLoader('/path/to/templates')
+    ... ])
+
+    Templates can be precompiled with :meth:`Environment.compile_templates`.
+    """
+
+    has_source_access = False
+
+    def __init__(self, path):
+        package_name = "_jinja2_module_templates_%x" % id(self)
+
+        # create a fake module that looks for the templates in the
+        # path given.
+        mod = _TemplateModule(package_name)
+
+        if not isinstance(path, abc.Iterable) or isinstance(path, string_types):
+            path = [path]
+
+        mod.__path__ = [fspath(p) for p in path]
+
+        sys.modules[package_name] = weakref.proxy(
+            mod, lambda x: sys.modules.pop(package_name, None)
+        )
+
+        # the only strong reference, the sys.modules entry is weak
+        # so that the garbage collector can remove it once the
+        # loader that created it goes out of business.
+        self.module = mod
+        self.package_name = package_name
+
+    @staticmethod
+    def get_template_key(name):
+        return "tmpl_" + sha1(name.encode("utf-8")).hexdigest()
+
+    @staticmethod
+    def get_module_filename(name):
+        return ModuleLoader.get_template_key(name) + ".py"
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        key = self.get_template_key(name)
+        module = "%s.%s" % (self.package_name, key)
+        mod = getattr(self.module, module, None)
+        if mod is None:
+            try:
+                mod = __import__(module, None, None, ["root"])
+            except ImportError:
+                raise TemplateNotFound(name)
+
+            # remove the entry from sys.modules, we only want the attribute
+            # on the module object we have stored on the loader.
+            sys.modules.pop(module, None)
+
+        return environment.template_class.from_module_dict(
+            environment, mod.__dict__, globals
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/meta.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..3795aace59da12815544dfcd5bb9973e196f7a43
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/meta.py
@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*-
+"""Functions that expose information about templates that might be
+interesting for introspection.
+"""
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from .compiler import CodeGenerator
+
+
+class TrackingCodeGenerator(CodeGenerator):
+    """We abuse the code generator for introspection."""
+
+    def __init__(self, environment):
+        CodeGenerator.__init__(self, environment, "<introspection>", "<introspection>")
+        self.undeclared_identifiers = set()
+
+    def write(self, x):
+        """Don't write."""
+
+    def enter_frame(self, frame):
+        """Remember all undeclared identifiers."""
+        CodeGenerator.enter_frame(self, frame)
+        for _, (action, param) in iteritems(frame.symbols.loads):
+            if action == "resolve" and param not in self.environment.globals:
+                self.undeclared_identifiers.add(param)
+
+
+def find_undeclared_variables(ast):
+    """Returns a set of all variables in the AST that will be looked up from
+    the context at runtime.  Because at compile time it's not known which
+    variables will be used depending on the path the execution takes at
+    runtime, all variables are returned.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% set foo = 42 %}{{ bar + foo }}')
+    >>> meta.find_undeclared_variables(ast) == set(['bar'])
+    True
+
+    .. admonition:: Implementation
+
+       Internally the code generator is used for finding undeclared variables.
+       This is good to know because the code generator might raise a
+       :exc:`TemplateAssertionError` during compilation and as a matter of
+       fact this function can currently raise that exception as well.
+    """
+    codegen = TrackingCodeGenerator(ast.environment)
+    codegen.visit(ast)
+    return codegen.undeclared_identifiers
+
+
+def find_referenced_templates(ast):
+    """Finds all the referenced templates from the AST.  This will return an
+    iterator over all the hardcoded template extensions, inclusions and
+    imports.  If dynamic inheritance or inclusion is used, `None` will be
+    yielded.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% extends "layout.html" %}{% include helper %}')
+    >>> list(meta.find_referenced_templates(ast))
+    ['layout.html', None]
+
+    This function is useful for dependency tracking.  For example if you want
+    to rebuild parts of the website after a layout template has changed.
+    """
+    for node in ast.find_all(
+        (nodes.Extends, nodes.FromImport, nodes.Import, nodes.Include)
+    ):
+        if not isinstance(node.template, nodes.Const):
+            # a tuple with some non consts in there
+            if isinstance(node.template, (nodes.Tuple, nodes.List)):
+                for template_name in node.template.items:
+                    # something const, only yield the strings and ignore
+                    # non-string consts that really just make no sense
+                    if isinstance(template_name, nodes.Const):
+                        if isinstance(template_name.value, string_types):
+                            yield template_name.value
+                    # something dynamic in there
+                    else:
+                        yield None
+            # something dynamic we don't know about here
+            else:
+                yield None
+            continue
+        # constant is a basestring, direct template name
+        if isinstance(node.template.value, string_types):
+            yield node.template.value
+        # a tuple or list (latter *should* not happen) made of consts,
+        # yield the consts that are strings.  We could warn here for
+        # non string values
+        elif isinstance(node, nodes.Include) and isinstance(
+            node.template.value, (tuple, list)
+        ):
+            for template_name in node.template.value:
+                if isinstance(template_name, string_types):
+                    yield template_name
+        # something else we don't care about, we could warn here
+        else:
+            yield None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nativetypes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nativetypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9ead4e2bbf09b881993b4c7112d83c684604c5c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nativetypes.py
@@ -0,0 +1,94 @@
+from ast import literal_eval
+from itertools import chain
+from itertools import islice
+
+from . import nodes
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import has_safe_repr
+from .environment import Environment
+from .environment import Template
+
+
+def native_concat(nodes):
+    """Return a native Python type from the list of compiled nodes. If
+    the result is a single node, its value is returned. Otherwise, the
+    nodes are concatenated as strings. If the result can be parsed with
+    :func:`ast.literal_eval`, the parsed value is returned. Otherwise,
+    the string is returned.
+
+    :param nodes: Iterable of nodes to concatenate.
+    """
+    head = list(islice(nodes, 2))
+
+    if not head:
+        return None
+
+    if len(head) == 1:
+        raw = head[0]
+    else:
+        raw = u"".join([text_type(v) for v in chain(head, nodes)])
+
+    try:
+        return literal_eval(raw)
+    except (ValueError, SyntaxError, MemoryError):
+        return raw
+
+
+class NativeCodeGenerator(CodeGenerator):
+    """A code generator which renders Python types by not adding
+    ``to_string()`` around output nodes.
+    """
+
+    @staticmethod
+    def _default_finalize(value):
+        return value
+
+    def _output_const_repr(self, group):
+        return repr(u"".join([text_type(v) for v in group]))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        const = node.as_const(frame.eval_ctx)
+
+        if not has_safe_repr(const):
+            raise nodes.Impossible()
+
+        if isinstance(node, nodes.TemplateData):
+            return const
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(")")
+
+
+class NativeEnvironment(Environment):
+    """An environment that renders templates to native Python types."""
+
+    code_generator_class = NativeCodeGenerator
+
+
+class NativeTemplate(Template):
+    environment_class = NativeEnvironment
+
+    def render(self, *args, **kwargs):
+        """Render the template to produce a native Python type. If the
+        result is a single node, its value is returned. Otherwise, the
+        nodes are concatenated as strings. If the result can be parsed
+        with :func:`ast.literal_eval`, the parsed value is returned.
+        Otherwise, the string is returned.
+        """
+        vars = dict(*args, **kwargs)
+
+        try:
+            return native_concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            return self.environment.handle_exception()
+
+
+NativeEnvironment.template_class = NativeTemplate
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nodes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..95bd614a140a8cd8da3642831650215c7e8ac105
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/nodes.py
@@ -0,0 +1,1088 @@
+# -*- coding: utf-8 -*-
+"""AST nodes generated by the parser for the compiler. Also provides
+some node tree helper functions used by the parser and compiler in order
+to normalize nodes.
+"""
+import operator
+from collections import deque
+
+from markupsafe import Markup
+
+from ._compat import izip
+from ._compat import PY2
+from ._compat import text_type
+from ._compat import with_metaclass
+
+_binop_to_func = {
+    "*": operator.mul,
+    "/": operator.truediv,
+    "//": operator.floordiv,
+    "**": operator.pow,
+    "%": operator.mod,
+    "+": operator.add,
+    "-": operator.sub,
+}
+
+_uaop_to_func = {"not": operator.not_, "+": operator.pos, "-": operator.neg}
+
+_cmpop_to_func = {
+    "eq": operator.eq,
+    "ne": operator.ne,
+    "gt": operator.gt,
+    "gteq": operator.ge,
+    "lt": operator.lt,
+    "lteq": operator.le,
+    "in": lambda a, b: a in b,
+    "notin": lambda a, b: a not in b,
+}
+
+
+class Impossible(Exception):
+    """Raised if the node could not perform a requested action."""
+
+
+class NodeType(type):
+    """A metaclass for nodes that handles the field and attribute
+    inheritance.  fields and attributes from the parent class are
+    automatically forwarded to the child."""
+
+    def __new__(mcs, name, bases, d):
+        for attr in "fields", "attributes":
+            storage = []
+            storage.extend(getattr(bases[0], attr, ()))
+            storage.extend(d.get(attr, ()))
+            assert len(bases) == 1, "multiple inheritance not allowed"
+            assert len(storage) == len(set(storage)), "layout conflict"
+            d[attr] = tuple(storage)
+        d.setdefault("abstract", False)
+        return type.__new__(mcs, name, bases, d)
+
+
+class EvalContext(object):
+    """Holds evaluation time information.  Custom attributes can be attached
+    to it in extensions.
+    """
+
+    def __init__(self, environment, template_name=None):
+        self.environment = environment
+        if callable(environment.autoescape):
+            self.autoescape = environment.autoescape(template_name)
+        else:
+            self.autoescape = environment.autoescape
+        self.volatile = False
+
+    def save(self):
+        return self.__dict__.copy()
+
+    def revert(self, old):
+        self.__dict__.clear()
+        self.__dict__.update(old)
+
+
+def get_eval_context(node, ctx):
+    if ctx is None:
+        if node.environment is None:
+            raise RuntimeError(
+                "if no eval context is passed, the "
+                "node must have an attached "
+                "environment."
+            )
+        return EvalContext(node.environment)
+    return ctx
+
+
+class Node(with_metaclass(NodeType, object)):
+    """Baseclass for all Jinja nodes.  There are a number of nodes available
+    of different types.  There are four major types:
+
+    -   :class:`Stmt`: statements
+    -   :class:`Expr`: expressions
+    -   :class:`Helper`: helper nodes
+    -   :class:`Template`: the outermost wrapper node
+
+    All nodes have fields and attributes.  Fields may be other nodes, lists,
+    or arbitrary values.  Fields are passed to the constructor as regular
+    positional arguments, attributes as keyword arguments.  Each node has
+    two attributes: `lineno` (the line number of the node) and `environment`.
+    The `environment` attribute is set at the end of the parsing process for
+    all nodes automatically.
+    """
+
+    fields = ()
+    attributes = ("lineno", "environment")
+    abstract = True
+
+    def __init__(self, *fields, **attributes):
+        if self.abstract:
+            raise TypeError("abstract nodes are not instantiable")
+        if fields:
+            if len(fields) != len(self.fields):
+                if not self.fields:
+                    raise TypeError("%r takes 0 arguments" % self.__class__.__name__)
+                raise TypeError(
+                    "%r takes 0 or %d argument%s"
+                    % (
+                        self.__class__.__name__,
+                        len(self.fields),
+                        len(self.fields) != 1 and "s" or "",
+                    )
+                )
+            for name, arg in izip(self.fields, fields):
+                setattr(self, name, arg)
+        for attr in self.attributes:
+            setattr(self, attr, attributes.pop(attr, None))
+        if attributes:
+            raise TypeError("unknown attribute %r" % next(iter(attributes)))
+
+    def iter_fields(self, exclude=None, only=None):
+        """This method iterates over all fields that are defined and yields
+        ``(key, value)`` tuples.  Per default all fields are returned, but
+        it's possible to limit that to some fields by providing the `only`
+        parameter or to exclude some using the `exclude` parameter.  Both
+        should be sets or tuples of field names.
+        """
+        for name in self.fields:
+            if (
+                (exclude is only is None)
+                or (exclude is not None and name not in exclude)
+                or (only is not None and name in only)
+            ):
+                try:
+                    yield name, getattr(self, name)
+                except AttributeError:
+                    pass
+
+    def iter_child_nodes(self, exclude=None, only=None):
+        """Iterates over all direct child nodes of the node.  This iterates
+        over all fields and yields the values of they are nodes.  If the value
+        of a field is a list all the nodes in that list are returned.
+        """
+        for _, item in self.iter_fields(exclude, only):
+            if isinstance(item, list):
+                for n in item:
+                    if isinstance(n, Node):
+                        yield n
+            elif isinstance(item, Node):
+                yield item
+
+    def find(self, node_type):
+        """Find the first node of a given type.  If no such node exists the
+        return value is `None`.
+        """
+        for result in self.find_all(node_type):
+            return result
+
+    def find_all(self, node_type):
+        """Find all the nodes of a given type.  If the type is a tuple,
+        the check is performed for any of the tuple items.
+        """
+        for child in self.iter_child_nodes():
+            if isinstance(child, node_type):
+                yield child
+            for result in child.find_all(node_type):
+                yield result
+
+    def set_ctx(self, ctx):
+        """Reset the context of a node and all child nodes.  Per default the
+        parser will all generate nodes that have a 'load' context as it's the
+        most common one.  This method is used in the parser to set assignment
+        targets and other nodes to a store context.
+        """
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "ctx" in node.fields:
+                node.ctx = ctx
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_lineno(self, lineno, override=False):
+        """Set the line numbers of the node and children."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "lineno" in node.attributes:
+                if node.lineno is None or override:
+                    node.lineno = lineno
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_environment(self, environment):
+        """Set the environment for all nodes."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            node.environment = environment
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def __eq__(self, other):
+        return type(self) is type(other) and tuple(self.iter_fields()) == tuple(
+            other.iter_fields()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    # Restore Python 2 hashing behavior on Python 3
+    __hash__ = object.__hash__
+
+    def __repr__(self):
+        return "%s(%s)" % (
+            self.__class__.__name__,
+            ", ".join("%s=%r" % (arg, getattr(self, arg, None)) for arg in self.fields),
+        )
+
+    def dump(self):
+        def _dump(node):
+            if not isinstance(node, Node):
+                buf.append(repr(node))
+                return
+
+            buf.append("nodes.%s(" % node.__class__.__name__)
+            if not node.fields:
+                buf.append(")")
+                return
+            for idx, field in enumerate(node.fields):
+                if idx:
+                    buf.append(", ")
+                value = getattr(node, field)
+                if isinstance(value, list):
+                    buf.append("[")
+                    for idx, item in enumerate(value):
+                        if idx:
+                            buf.append(", ")
+                        _dump(item)
+                    buf.append("]")
+                else:
+                    _dump(value)
+            buf.append(")")
+
+        buf = []
+        _dump(self)
+        return "".join(buf)
+
+
+class Stmt(Node):
+    """Base node for all statements."""
+
+    abstract = True
+
+
+class Helper(Node):
+    """Nodes that exist in a specific context only."""
+
+    abstract = True
+
+
+class Template(Node):
+    """Node that represents a template.  This must be the outermost node that
+    is passed to the compiler.
+    """
+
+    fields = ("body",)
+
+
+class Output(Stmt):
+    """A node that holds multiple expressions which are then printed out.
+    This is used both for the `print` statement and the regular template data.
+    """
+
+    fields = ("nodes",)
+
+
+class Extends(Stmt):
+    """Represents an extends statement."""
+
+    fields = ("template",)
+
+
+class For(Stmt):
+    """The for loop.  `target` is the target for the iteration (usually a
+    :class:`Name` or :class:`Tuple`), `iter` the iterable.  `body` is a list
+    of nodes that are used as loop-body, and `else_` a list of nodes for the
+    `else` block.  If no else node exists it has to be an empty list.
+
+    For filtered nodes an expression can be stored as `test`, otherwise `None`.
+    """
+
+    fields = ("target", "iter", "body", "else_", "test", "recursive")
+
+
+class If(Stmt):
+    """If `test` is true, `body` is rendered, else `else_`."""
+
+    fields = ("test", "body", "elif_", "else_")
+
+
+class Macro(Stmt):
+    """A macro definition.  `name` is the name of the macro, `args` a list of
+    arguments and `defaults` a list of defaults if there are any.  `body` is
+    a list of nodes for the macro body.
+    """
+
+    fields = ("name", "args", "defaults", "body")
+
+
+class CallBlock(Stmt):
+    """Like a macro without a name but a call instead.  `call` is called with
+    the unnamed macro as `caller` argument this node holds.
+    """
+
+    fields = ("call", "args", "defaults", "body")
+
+
+class FilterBlock(Stmt):
+    """Node for filter sections."""
+
+    fields = ("body", "filter")
+
+
+class With(Stmt):
+    """Specific node for with statements.  In older versions of Jinja the
+    with statement was implemented on the base of the `Scope` node instead.
+
+    .. versionadded:: 2.9.3
+    """
+
+    fields = ("targets", "values", "body")
+
+
+class Block(Stmt):
+    """A node that represents a block."""
+
+    fields = ("name", "body", "scoped")
+
+
+class Include(Stmt):
+    """A node that represents the include tag."""
+
+    fields = ("template", "with_context", "ignore_missing")
+
+
+class Import(Stmt):
+    """A node that represents the import tag."""
+
+    fields = ("template", "target", "with_context")
+
+
+class FromImport(Stmt):
+    """A node that represents the from import tag.  It's important to not
+    pass unsafe names to the name attribute.  The compiler translates the
+    attribute lookups directly into getattr calls and does *not* use the
+    subscript callback of the interface.  As exported variables may not
+    start with double underscores (which the parser asserts) this is not a
+    problem for regular Jinja code, but if this node is used in an extension
+    extra care must be taken.
+
+    The list of names may contain tuples if aliases are wanted.
+    """
+
+    fields = ("template", "names", "with_context")
+
+
+class ExprStmt(Stmt):
+    """A statement that evaluates an expression and discards the result."""
+
+    fields = ("node",)
+
+
+class Assign(Stmt):
+    """Assigns an expression to a target."""
+
+    fields = ("target", "node")
+
+
+class AssignBlock(Stmt):
+    """Assigns a block to a target."""
+
+    fields = ("target", "filter", "body")
+
+
+class Expr(Node):
+    """Baseclass for all expressions."""
+
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        """Return the value of the expression as constant or raise
+        :exc:`Impossible` if this was not possible.
+
+        An :class:`EvalContext` can be provided, if none is given
+        a default context is created which requires the nodes to have
+        an attached environment.
+
+        .. versionchanged:: 2.4
+           the `eval_ctx` parameter was added.
+        """
+        raise Impossible()
+
+    def can_assign(self):
+        """Check if it's possible to assign something to this node."""
+        return False
+
+
+class BinExpr(Expr):
+    """Baseclass for all binary expressions."""
+
+    fields = ("left", "right")
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_binops
+        ):
+            raise Impossible()
+        f = _binop_to_func[self.operator]
+        try:
+            return f(self.left.as_const(eval_ctx), self.right.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class UnaryExpr(Expr):
+    """Baseclass for all unary expressions."""
+
+    fields = ("node",)
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_unops
+        ):
+            raise Impossible()
+        f = _uaop_to_func[self.operator]
+        try:
+            return f(self.node.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class Name(Expr):
+    """Looks up a name or stores a value in a name.
+    The `ctx` of the node can be one of the following values:
+
+    -   `store`: store a value in the name
+    -   `load`: load that name
+    -   `param`: like `store` but if the name was defined as function parameter.
+    """
+
+    fields = ("name", "ctx")
+
+    def can_assign(self):
+        return self.name not in ("true", "false", "none", "True", "False", "None")
+
+
+class NSRef(Expr):
+    """Reference to a namespace value assignment"""
+
+    fields = ("name", "attr")
+
+    def can_assign(self):
+        # We don't need any special checks here; NSRef assignments have a
+        # runtime check to ensure the target is a namespace object which will
+        # have been checked already as it is created using a normal assignment
+        # which goes through a `Name` node.
+        return True
+
+
+class Literal(Expr):
+    """Baseclass for literals."""
+
+    abstract = True
+
+
+class Const(Literal):
+    """All constant values.  The parser will return this node for simple
+    constants such as ``42`` or ``"foo"`` but it can be used to store more
+    complex values such as lists too.  Only constants with a safe
+    representation (objects where ``eval(repr(x)) == x`` is true).
+    """
+
+    fields = ("value",)
+
+    def as_const(self, eval_ctx=None):
+        rv = self.value
+        if (
+            PY2
+            and type(rv) is text_type
+            and self.environment.policies["compiler.ascii_str"]
+        ):
+            try:
+                rv = rv.encode("ascii")
+            except UnicodeError:
+                pass
+        return rv
+
+    @classmethod
+    def from_untrusted(cls, value, lineno=None, environment=None):
+        """Return a const object if the value is representable as
+        constant value in the generated code, otherwise it will raise
+        an `Impossible` exception.
+        """
+        from .compiler import has_safe_repr
+
+        if not has_safe_repr(value):
+            raise Impossible()
+        return cls(value, lineno=lineno, environment=environment)
+
+
+class TemplateData(Literal):
+    """A constant template string."""
+
+    fields = ("data",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        if eval_ctx.autoescape:
+            return Markup(self.data)
+        return self.data
+
+
+class Tuple(Literal):
+    """For loop unpacking and some other things like multiple arguments
+    for subscripts.  Like for :class:`Name` `ctx` specifies if the tuple
+    is used for loading the names or storing.
+    """
+
+    fields = ("items", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return tuple(x.as_const(eval_ctx) for x in self.items)
+
+    def can_assign(self):
+        for item in self.items:
+            if not item.can_assign():
+                return False
+        return True
+
+
+class List(Literal):
+    """Any list literal such as ``[1, 2, 3]``"""
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return [x.as_const(eval_ctx) for x in self.items]
+
+
+class Dict(Literal):
+    """Any dict literal such as ``{1: 2, 3: 4}``.  The items must be a list of
+    :class:`Pair` nodes.
+    """
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return dict(x.as_const(eval_ctx) for x in self.items)
+
+
+class Pair(Helper):
+    """A key, value pair for dicts."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key.as_const(eval_ctx), self.value.as_const(eval_ctx)
+
+
+class Keyword(Helper):
+    """A key, value pair for keyword arguments where key is a string."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key, self.value.as_const(eval_ctx)
+
+
+class CondExpr(Expr):
+    """A conditional expression (inline if expression).  (``{{
+    foo if bar else baz }}``)
+    """
+
+    fields = ("test", "expr1", "expr2")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.test.as_const(eval_ctx):
+            return self.expr1.as_const(eval_ctx)
+
+        # if we evaluate to an undefined object, we better do that at runtime
+        if self.expr2 is None:
+            raise Impossible()
+
+        return self.expr2.as_const(eval_ctx)
+
+
+def args_as_const(node, eval_ctx):
+    args = [x.as_const(eval_ctx) for x in node.args]
+    kwargs = dict(x.as_const(eval_ctx) for x in node.kwargs)
+
+    if node.dyn_args is not None:
+        try:
+            args.extend(node.dyn_args.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    if node.dyn_kwargs is not None:
+        try:
+            kwargs.update(node.dyn_kwargs.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    return args, kwargs
+
+
+class Filter(Expr):
+    """This node applies a filter on an expression.  `name` is the name of
+    the filter, the rest of the fields are the same as for :class:`Call`.
+
+    If the `node` of a filter is `None` the contents of the last buffer are
+    filtered.  Buffers are created by macros and filter blocks.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        if eval_ctx.volatile or self.node is None:
+            raise Impossible()
+
+        # we have to be careful here because we call filter_ below.
+        # if this variable would be called filter, 2to3 would wrap the
+        # call in a list because it is assuming we are talking about the
+        # builtin filter function here which no longer returns a list in
+        # python 3.  because of that, do not rename filter_ to filter!
+        filter_ = self.environment.filters.get(self.name)
+
+        if filter_ is None or getattr(filter_, "contextfilter", False) is True:
+            raise Impossible()
+
+        # We cannot constant handle async filters, so we need to make sure
+        # to not go down this path.
+        if eval_ctx.environment.is_async and getattr(
+            filter_, "asyncfiltervariant", False
+        ):
+            raise Impossible()
+
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        if getattr(filter_, "evalcontextfilter", False) is True:
+            args.insert(0, eval_ctx)
+        elif getattr(filter_, "environmentfilter", False) is True:
+            args.insert(0, self.environment)
+
+        try:
+            return filter_(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Test(Expr):
+    """Applies a test on an expression.  `name` is the name of the test, the
+    rest of the fields are the same as for :class:`Call`.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        test = self.environment.tests.get(self.name)
+
+        if test is None:
+            raise Impossible()
+
+        eval_ctx = get_eval_context(self, eval_ctx)
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        try:
+            return test(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Call(Expr):
+    """Calls an expression.  `args` is a list of arguments, `kwargs` a list
+    of keyword arguments (list of :class:`Keyword` nodes), and `dyn_args`
+    and `dyn_kwargs` has to be either `None` or a node that is used as
+    node for dynamic positional (``*args``) or keyword (``**kwargs``)
+    arguments.
+    """
+
+    fields = ("node", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+
+class Getitem(Expr):
+    """Get an attribute or item from an expression and prefer the item."""
+
+    fields = ("node", "arg", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            return self.environment.getitem(
+                self.node.as_const(eval_ctx), self.arg.as_const(eval_ctx)
+            )
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Getattr(Expr):
+    """Get an attribute or item from an expression that is a ascii-only
+    bytestring and prefer the attribute.
+    """
+
+    fields = ("node", "attr", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            eval_ctx = get_eval_context(self, eval_ctx)
+            return self.environment.getattr(self.node.as_const(eval_ctx), self.attr)
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Slice(Expr):
+    """Represents a slice object.  This must only be used as argument for
+    :class:`Subscript`.
+    """
+
+    fields = ("start", "stop", "step")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        def const(obj):
+            if obj is None:
+                return None
+            return obj.as_const(eval_ctx)
+
+        return slice(const(self.start), const(self.stop), const(self.step))
+
+
+class Concat(Expr):
+    """Concatenates the list of expressions provided after converting them to
+    unicode.
+    """
+
+    fields = ("nodes",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return "".join(text_type(x.as_const(eval_ctx)) for x in self.nodes)
+
+
+class Compare(Expr):
+    """Compares an expression with some other expressions.  `ops` must be a
+    list of :class:`Operand`\\s.
+    """
+
+    fields = ("expr", "ops")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        result = value = self.expr.as_const(eval_ctx)
+
+        try:
+            for op in self.ops:
+                new_value = op.expr.as_const(eval_ctx)
+                result = _cmpop_to_func[op.op](value, new_value)
+
+                if not result:
+                    return False
+
+                value = new_value
+        except Exception:
+            raise Impossible()
+
+        return result
+
+
+class Operand(Helper):
+    """Holds an operator and an expression."""
+
+    fields = ("op", "expr")
+
+
+if __debug__:
+    Operand.__doc__ += "\nThe following operators are available: " + ", ".join(
+        sorted(
+            "``%s``" % x
+            for x in set(_binop_to_func) | set(_uaop_to_func) | set(_cmpop_to_func)
+        )
+    )
+
+
+class Mul(BinExpr):
+    """Multiplies the left with the right node."""
+
+    operator = "*"
+
+
+class Div(BinExpr):
+    """Divides the left by the right node."""
+
+    operator = "/"
+
+
+class FloorDiv(BinExpr):
+    """Divides the left by the right node and truncates conver the
+    result into an integer by truncating.
+    """
+
+    operator = "//"
+
+
+class Add(BinExpr):
+    """Add the left to the right node."""
+
+    operator = "+"
+
+
+class Sub(BinExpr):
+    """Subtract the right from the left node."""
+
+    operator = "-"
+
+
+class Mod(BinExpr):
+    """Left modulo right."""
+
+    operator = "%"
+
+
+class Pow(BinExpr):
+    """Left to the power of right."""
+
+    operator = "**"
+
+
+class And(BinExpr):
+    """Short circuited AND."""
+
+    operator = "and"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) and self.right.as_const(eval_ctx)
+
+
+class Or(BinExpr):
+    """Short circuited OR."""
+
+    operator = "or"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) or self.right.as_const(eval_ctx)
+
+
+class Not(UnaryExpr):
+    """Negate the expression."""
+
+    operator = "not"
+
+
+class Neg(UnaryExpr):
+    """Make the expression negative."""
+
+    operator = "-"
+
+
+class Pos(UnaryExpr):
+    """Make the expression positive (noop for most expressions)"""
+
+    operator = "+"
+
+
+# Helpers for extensions
+
+
+class EnvironmentAttribute(Expr):
+    """Loads an attribute from the environment object.  This is useful for
+    extensions that want to call a callback stored on the environment.
+    """
+
+    fields = ("name",)
+
+
+class ExtensionAttribute(Expr):
+    """Returns the attribute of an extension bound to the environment.
+    The identifier is the identifier of the :class:`Extension`.
+
+    This node is usually constructed by calling the
+    :meth:`~jinja2.ext.Extension.attr` method on an extension.
+    """
+
+    fields = ("identifier", "name")
+
+
+class ImportedName(Expr):
+    """If created with an import name the import name is returned on node
+    access.  For example ``ImportedName('cgi.escape')`` returns the `escape`
+    function from the cgi module on evaluation.  Imports are optimized by the
+    compiler so there is no need to assign them to local variables.
+    """
+
+    fields = ("importname",)
+
+
+class InternalName(Expr):
+    """An internal name in the compiler.  You cannot create these nodes
+    yourself but the parser provides a
+    :meth:`~jinja2.parser.Parser.free_identifier` method that creates
+    a new identifier for you.  This identifier is not available from the
+    template and is not threated specially by the compiler.
+    """
+
+    fields = ("name",)
+
+    def __init__(self):
+        raise TypeError(
+            "Can't create internal names.  Use the "
+            "`free_identifier` method on a parser."
+        )
+
+
+class MarkSafe(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`)."""
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return Markup(self.expr.as_const(eval_ctx))
+
+
+class MarkSafeIfAutoescape(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`) but
+    only if autoescaping is active.
+
+    .. versionadded:: 2.5
+    """
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        expr = self.expr.as_const(eval_ctx)
+        if eval_ctx.autoescape:
+            return Markup(expr)
+        return expr
+
+
+class ContextReference(Expr):
+    """Returns the current template context.  It can be used like a
+    :class:`Name` node, with a ``'load'`` ctx and will return the
+    current :class:`~jinja2.runtime.Context` object.
+
+    Here an example that assigns the current template name to a
+    variable named `foo`::
+
+        Assign(Name('foo', ctx='store'),
+               Getattr(ContextReference(), 'name'))
+
+    This is basically equivalent to using the
+    :func:`~jinja2.contextfunction` decorator when using the
+    high-level API, which causes a reference to the context to be passed
+    as the first argument to a function.
+    """
+
+
+class DerivedContextReference(Expr):
+    """Return the current template context including locals. Behaves
+    exactly like :class:`ContextReference`, but includes local
+    variables, such as from a ``for`` loop.
+
+    .. versionadded:: 2.11
+    """
+
+
+class Continue(Stmt):
+    """Continue a loop."""
+
+
+class Break(Stmt):
+    """Break a loop."""
+
+
+class Scope(Stmt):
+    """An artificial scope."""
+
+    fields = ("body",)
+
+
+class OverlayScope(Stmt):
+    """An overlay scope for extensions.  This is a largely unoptimized scope
+    that however can be used to introduce completely arbitrary variables into
+    a sub scope from a dictionary or dictionary like object.  The `context`
+    field has to evaluate to a dictionary object.
+
+    Example usage::
+
+        OverlayScope(context=self.call_method('get_context'),
+                     body=[...])
+
+    .. versionadded:: 2.10
+    """
+
+    fields = ("context", "body")
+
+
+class EvalContextModifier(Stmt):
+    """Modifies the eval context.  For each option that should be modified,
+    a :class:`Keyword` has to be added to the :attr:`options` list.
+
+    Example to change the `autoescape` setting::
+
+        EvalContextModifier(options=[Keyword('autoescape', Const(True))])
+    """
+
+    fields = ("options",)
+
+
+class ScopedEvalContextModifier(EvalContextModifier):
+    """Modifies the eval context and reverts it later.  Works exactly like
+    :class:`EvalContextModifier` but will only modify the
+    :class:`~jinja2.nodes.EvalContext` for nodes in the :attr:`body`.
+    """
+
+    fields = ("body",)
+
+
+# make sure nobody creates custom nodes
+def _failing_new(*args, **kwargs):
+    raise TypeError("can't create custom node types")
+
+
+NodeType.__new__ = staticmethod(_failing_new)
+del _failing_new
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/optimizer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/optimizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bc78c4524ab59dd7218cfe5f23b5de29a4a170c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/optimizer.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""The optimizer tries to constant fold expressions and modify the AST
+in place so that it should be faster to evaluate.
+
+Because the AST does not contain all the scoping information and the
+compiler has to find that out, we cannot do all the optimizations we
+want. For example, loop unrolling doesn't work because unrolled loops
+would have a different scope. The solution would be a second syntax tree
+that stored the scoping rules.
+"""
+from . import nodes
+from .visitor import NodeTransformer
+
+
+def optimize(node, environment):
+    """The context hint can be used to perform an static optimization
+    based on the context given."""
+    optimizer = Optimizer(environment)
+    return optimizer.visit(node)
+
+
+class Optimizer(NodeTransformer):
+    def __init__(self, environment):
+        self.environment = environment
+
+    def generic_visit(self, node, *args, **kwargs):
+        node = super(Optimizer, self).generic_visit(node, *args, **kwargs)
+
+        # Do constant folding. Some other nodes besides Expr have
+        # as_const, but folding them causes errors later on.
+        if isinstance(node, nodes.Expr):
+            try:
+                return nodes.Const.from_untrusted(
+                    node.as_const(args[0] if args else None),
+                    lineno=node.lineno,
+                    environment=self.environment,
+                )
+            except nodes.Impossible:
+                pass
+
+        return node
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5881066f7461b01291067f19c356d39dc75d38b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/parser.py
@@ -0,0 +1,939 @@
+# -*- coding: utf-8 -*-
+"""Parse tokens from the lexer into nodes for the compiler."""
+from . import nodes
+from ._compat import imap
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .lexer import describe_token
+from .lexer import describe_token_expr
+
+_statement_keywords = frozenset(
+    [
+        "for",
+        "if",
+        "block",
+        "extends",
+        "print",
+        "macro",
+        "include",
+        "from",
+        "import",
+        "set",
+        "with",
+        "autoescape",
+    ]
+)
+_compare_operators = frozenset(["eq", "ne", "lt", "lteq", "gt", "gteq"])
+
+_math_nodes = {
+    "add": nodes.Add,
+    "sub": nodes.Sub,
+    "mul": nodes.Mul,
+    "div": nodes.Div,
+    "floordiv": nodes.FloorDiv,
+    "mod": nodes.Mod,
+}
+
+
+class Parser(object):
+    """This is the central parsing class Jinja uses.  It's passed to
+    extensions and can be used to parse expressions or statements.
+    """
+
+    def __init__(self, environment, source, name=None, filename=None, state=None):
+        self.environment = environment
+        self.stream = environment._tokenize(source, name, filename, state)
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.extensions = {}
+        for extension in environment.iter_extensions():
+            for tag in extension.tags:
+                self.extensions[tag] = extension.parse
+        self._last_identifier = 0
+        self._tag_stack = []
+        self._end_token_stack = []
+
+    def fail(self, msg, lineno=None, exc=TemplateSyntaxError):
+        """Convenience method that raises `exc` with the message, passed
+        line number or last line number as well as the current name and
+        filename.
+        """
+        if lineno is None:
+            lineno = self.stream.current.lineno
+        raise exc(msg, lineno, self.name, self.filename)
+
+    def _fail_ut_eof(self, name, end_token_stack, lineno):
+        expected = []
+        for exprs in end_token_stack:
+            expected.extend(imap(describe_token_expr, exprs))
+        if end_token_stack:
+            currently_looking = " or ".join(
+                "'%s'" % describe_token_expr(expr) for expr in end_token_stack[-1]
+            )
+        else:
+            currently_looking = None
+
+        if name is None:
+            message = ["Unexpected end of template."]
+        else:
+            message = ["Encountered unknown tag '%s'." % name]
+
+        if currently_looking:
+            if name is not None and name in expected:
+                message.append(
+                    "You probably made a nesting mistake. Jinja "
+                    "is expecting this tag, but currently looking "
+                    "for %s." % currently_looking
+                )
+            else:
+                message.append(
+                    "Jinja was looking for the following tags: "
+                    "%s." % currently_looking
+                )
+
+        if self._tag_stack:
+            message.append(
+                "The innermost block that needs to be "
+                "closed is '%s'." % self._tag_stack[-1]
+            )
+
+        self.fail(" ".join(message), lineno)
+
+    def fail_unknown_tag(self, name, lineno=None):
+        """Called if the parser encounters an unknown tag.  Tries to fail
+        with a human readable error message that could help to identify
+        the problem.
+        """
+        return self._fail_ut_eof(name, self._end_token_stack, lineno)
+
+    def fail_eof(self, end_tokens=None, lineno=None):
+        """Like fail_unknown_tag but for end of template situations."""
+        stack = list(self._end_token_stack)
+        if end_tokens is not None:
+            stack.append(end_tokens)
+        return self._fail_ut_eof(None, stack, lineno)
+
+    def is_tuple_end(self, extra_end_rules=None):
+        """Are we at the end of a tuple?"""
+        if self.stream.current.type in ("variable_end", "block_end", "rparen"):
+            return True
+        elif extra_end_rules is not None:
+            return self.stream.current.test_any(extra_end_rules)
+        return False
+
+    def free_identifier(self, lineno=None):
+        """Return a new free identifier as :class:`~jinja2.nodes.InternalName`."""
+        self._last_identifier += 1
+        rv = object.__new__(nodes.InternalName)
+        nodes.Node.__init__(rv, "fi%d" % self._last_identifier, lineno=lineno)
+        return rv
+
+    def parse_statement(self):
+        """Parse a single statement."""
+        token = self.stream.current
+        if token.type != "name":
+            self.fail("tag name expected", token.lineno)
+        self._tag_stack.append(token.value)
+        pop_tag = True
+        try:
+            if token.value in _statement_keywords:
+                return getattr(self, "parse_" + self.stream.current.value)()
+            if token.value == "call":
+                return self.parse_call_block()
+            if token.value == "filter":
+                return self.parse_filter_block()
+            ext = self.extensions.get(token.value)
+            if ext is not None:
+                return ext(self)
+
+            # did not work out, remove the token we pushed by accident
+            # from the stack so that the unknown tag fail function can
+            # produce a proper error message.
+            self._tag_stack.pop()
+            pop_tag = False
+            self.fail_unknown_tag(token.value, token.lineno)
+        finally:
+            if pop_tag:
+                self._tag_stack.pop()
+
+    def parse_statements(self, end_tokens, drop_needle=False):
+        """Parse multiple statements into a list until one of the end tokens
+        is reached.  This is used to parse the body of statements as it also
+        parses template data if appropriate.  The parser checks first if the
+        current token is a colon and skips it if there is one.  Then it checks
+        for the block end and parses until if one of the `end_tokens` is
+        reached.  Per default the active token in the stream at the end of
+        the call is the matched end token.  If this is not wanted `drop_needle`
+        can be set to `True` and the end token is removed.
+        """
+        # the first token may be a colon for python compatibility
+        self.stream.skip_if("colon")
+
+        # in the future it would be possible to add whole code sections
+        # by adding some sort of end of statement token and parsing those here.
+        self.stream.expect("block_end")
+        result = self.subparse(end_tokens)
+
+        # we reached the end of the template too early, the subparser
+        # does not check for this, so we do that now
+        if self.stream.current.type == "eof":
+            self.fail_eof(end_tokens)
+
+        if drop_needle:
+            next(self.stream)
+        return result
+
+    def parse_set(self):
+        """Parse an assign statement."""
+        lineno = next(self.stream).lineno
+        target = self.parse_assign_target(with_namespace=True)
+        if self.stream.skip_if("assign"):
+            expr = self.parse_tuple()
+            return nodes.Assign(target, expr, lineno=lineno)
+        filter_node = self.parse_filter(None)
+        body = self.parse_statements(("name:endset",), drop_needle=True)
+        return nodes.AssignBlock(target, filter_node, body, lineno=lineno)
+
+    def parse_for(self):
+        """Parse a for loop."""
+        lineno = self.stream.expect("name:for").lineno
+        target = self.parse_assign_target(extra_end_rules=("name:in",))
+        self.stream.expect("name:in")
+        iter = self.parse_tuple(
+            with_condexpr=False, extra_end_rules=("name:recursive",)
+        )
+        test = None
+        if self.stream.skip_if("name:if"):
+            test = self.parse_expression()
+        recursive = self.stream.skip_if("name:recursive")
+        body = self.parse_statements(("name:endfor", "name:else"))
+        if next(self.stream).value == "endfor":
+            else_ = []
+        else:
+            else_ = self.parse_statements(("name:endfor",), drop_needle=True)
+        return nodes.For(target, iter, body, else_, test, recursive, lineno=lineno)
+
+    def parse_if(self):
+        """Parse an if construct."""
+        node = result = nodes.If(lineno=self.stream.expect("name:if").lineno)
+        while 1:
+            node.test = self.parse_tuple(with_condexpr=False)
+            node.body = self.parse_statements(("name:elif", "name:else", "name:endif"))
+            node.elif_ = []
+            node.else_ = []
+            token = next(self.stream)
+            if token.test("name:elif"):
+                node = nodes.If(lineno=self.stream.current.lineno)
+                result.elif_.append(node)
+                continue
+            elif token.test("name:else"):
+                result.else_ = self.parse_statements(("name:endif",), drop_needle=True)
+            break
+        return result
+
+    def parse_with(self):
+        node = nodes.With(lineno=next(self.stream).lineno)
+        targets = []
+        values = []
+        while self.stream.current.type != "block_end":
+            if targets:
+                self.stream.expect("comma")
+            target = self.parse_assign_target()
+            target.set_ctx("param")
+            targets.append(target)
+            self.stream.expect("assign")
+            values.append(self.parse_expression())
+        node.targets = targets
+        node.values = values
+        node.body = self.parse_statements(("name:endwith",), drop_needle=True)
+        return node
+
+    def parse_autoescape(self):
+        node = nodes.ScopedEvalContextModifier(lineno=next(self.stream).lineno)
+        node.options = [nodes.Keyword("autoescape", self.parse_expression())]
+        node.body = self.parse_statements(("name:endautoescape",), drop_needle=True)
+        return nodes.Scope([node])
+
+    def parse_block(self):
+        node = nodes.Block(lineno=next(self.stream).lineno)
+        node.name = self.stream.expect("name").value
+        node.scoped = self.stream.skip_if("name:scoped")
+
+        # common problem people encounter when switching from django
+        # to jinja.  we do not support hyphens in block names, so let's
+        # raise a nicer error message in that case.
+        if self.stream.current.type == "sub":
+            self.fail(
+                "Block names in Jinja have to be valid Python "
+                "identifiers and may not contain hyphens, use an "
+                "underscore instead."
+            )
+
+        node.body = self.parse_statements(("name:endblock",), drop_needle=True)
+        self.stream.skip_if("name:" + node.name)
+        return node
+
+    def parse_extends(self):
+        node = nodes.Extends(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        return node
+
+    def parse_import_context(self, node, default):
+        if self.stream.current.test_any(
+            "name:with", "name:without"
+        ) and self.stream.look().test("name:context"):
+            node.with_context = next(self.stream).value == "with"
+            self.stream.skip()
+        else:
+            node.with_context = default
+        return node
+
+    def parse_include(self):
+        node = nodes.Include(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        if self.stream.current.test("name:ignore") and self.stream.look().test(
+            "name:missing"
+        ):
+            node.ignore_missing = True
+            self.stream.skip(2)
+        else:
+            node.ignore_missing = False
+        return self.parse_import_context(node, True)
+
+    def parse_import(self):
+        node = nodes.Import(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:as")
+        node.target = self.parse_assign_target(name_only=True).name
+        return self.parse_import_context(node, False)
+
+    def parse_from(self):
+        node = nodes.FromImport(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:import")
+        node.names = []
+
+        def parse_context():
+            if self.stream.current.value in (
+                "with",
+                "without",
+            ) and self.stream.look().test("name:context"):
+                node.with_context = next(self.stream).value == "with"
+                self.stream.skip()
+                return True
+            return False
+
+        while 1:
+            if node.names:
+                self.stream.expect("comma")
+            if self.stream.current.type == "name":
+                if parse_context():
+                    break
+                target = self.parse_assign_target(name_only=True)
+                if target.name.startswith("_"):
+                    self.fail(
+                        "names starting with an underline can not be imported",
+                        target.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                if self.stream.skip_if("name:as"):
+                    alias = self.parse_assign_target(name_only=True)
+                    node.names.append((target.name, alias.name))
+                else:
+                    node.names.append(target.name)
+                if parse_context() or self.stream.current.type != "comma":
+                    break
+            else:
+                self.stream.expect("name")
+        if not hasattr(node, "with_context"):
+            node.with_context = False
+        return node
+
+    def parse_signature(self, node):
+        node.args = args = []
+        node.defaults = defaults = []
+        self.stream.expect("lparen")
+        while self.stream.current.type != "rparen":
+            if args:
+                self.stream.expect("comma")
+            arg = self.parse_assign_target(name_only=True)
+            arg.set_ctx("param")
+            if self.stream.skip_if("assign"):
+                defaults.append(self.parse_expression())
+            elif defaults:
+                self.fail("non-default argument follows default argument")
+            args.append(arg)
+        self.stream.expect("rparen")
+
+    def parse_call_block(self):
+        node = nodes.CallBlock(lineno=next(self.stream).lineno)
+        if self.stream.current.type == "lparen":
+            self.parse_signature(node)
+        else:
+            node.args = []
+            node.defaults = []
+
+        node.call = self.parse_expression()
+        if not isinstance(node.call, nodes.Call):
+            self.fail("expected call", node.lineno)
+        node.body = self.parse_statements(("name:endcall",), drop_needle=True)
+        return node
+
+    def parse_filter_block(self):
+        node = nodes.FilterBlock(lineno=next(self.stream).lineno)
+        node.filter = self.parse_filter(None, start_inline=True)
+        node.body = self.parse_statements(("name:endfilter",), drop_needle=True)
+        return node
+
+    def parse_macro(self):
+        node = nodes.Macro(lineno=next(self.stream).lineno)
+        node.name = self.parse_assign_target(name_only=True).name
+        self.parse_signature(node)
+        node.body = self.parse_statements(("name:endmacro",), drop_needle=True)
+        return node
+
+    def parse_print(self):
+        node = nodes.Output(lineno=next(self.stream).lineno)
+        node.nodes = []
+        while self.stream.current.type != "block_end":
+            if node.nodes:
+                self.stream.expect("comma")
+            node.nodes.append(self.parse_expression())
+        return node
+
+    def parse_assign_target(
+        self,
+        with_tuple=True,
+        name_only=False,
+        extra_end_rules=None,
+        with_namespace=False,
+    ):
+        """Parse an assignment target.  As Jinja allows assignments to
+        tuples, this function can parse all allowed assignment targets.  Per
+        default assignments to tuples are parsed, that can be disable however
+        by setting `with_tuple` to `False`.  If only assignments to names are
+        wanted `name_only` can be set to `True`.  The `extra_end_rules`
+        parameter is forwarded to the tuple parsing function.  If
+        `with_namespace` is enabled, a namespace assignment may be parsed.
+        """
+        if with_namespace and self.stream.look().type == "dot":
+            token = self.stream.expect("name")
+            next(self.stream)  # dot
+            attr = self.stream.expect("name")
+            target = nodes.NSRef(token.value, attr.value, lineno=token.lineno)
+        elif name_only:
+            token = self.stream.expect("name")
+            target = nodes.Name(token.value, "store", lineno=token.lineno)
+        else:
+            if with_tuple:
+                target = self.parse_tuple(
+                    simplified=True, extra_end_rules=extra_end_rules
+                )
+            else:
+                target = self.parse_primary()
+            target.set_ctx("store")
+        if not target.can_assign():
+            self.fail(
+                "can't assign to %r" % target.__class__.__name__.lower(), target.lineno
+            )
+        return target
+
+    def parse_expression(self, with_condexpr=True):
+        """Parse an expression.  Per default all expressions are parsed, if
+        the optional `with_condexpr` parameter is set to `False` conditional
+        expressions are not parsed.
+        """
+        if with_condexpr:
+            return self.parse_condexpr()
+        return self.parse_or()
+
+    def parse_condexpr(self):
+        lineno = self.stream.current.lineno
+        expr1 = self.parse_or()
+        while self.stream.skip_if("name:if"):
+            expr2 = self.parse_or()
+            if self.stream.skip_if("name:else"):
+                expr3 = self.parse_condexpr()
+            else:
+                expr3 = None
+            expr1 = nodes.CondExpr(expr2, expr1, expr3, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return expr1
+
+    def parse_or(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_and()
+        while self.stream.skip_if("name:or"):
+            right = self.parse_and()
+            left = nodes.Or(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_and(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_not()
+        while self.stream.skip_if("name:and"):
+            right = self.parse_not()
+            left = nodes.And(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_not(self):
+        if self.stream.current.test("name:not"):
+            lineno = next(self.stream).lineno
+            return nodes.Not(self.parse_not(), lineno=lineno)
+        return self.parse_compare()
+
+    def parse_compare(self):
+        lineno = self.stream.current.lineno
+        expr = self.parse_math1()
+        ops = []
+        while 1:
+            token_type = self.stream.current.type
+            if token_type in _compare_operators:
+                next(self.stream)
+                ops.append(nodes.Operand(token_type, self.parse_math1()))
+            elif self.stream.skip_if("name:in"):
+                ops.append(nodes.Operand("in", self.parse_math1()))
+            elif self.stream.current.test("name:not") and self.stream.look().test(
+                "name:in"
+            ):
+                self.stream.skip(2)
+                ops.append(nodes.Operand("notin", self.parse_math1()))
+            else:
+                break
+            lineno = self.stream.current.lineno
+        if not ops:
+            return expr
+        return nodes.Compare(expr, ops, lineno=lineno)
+
+    def parse_math1(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_concat()
+        while self.stream.current.type in ("add", "sub"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_concat()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_concat(self):
+        lineno = self.stream.current.lineno
+        args = [self.parse_math2()]
+        while self.stream.current.type == "tilde":
+            next(self.stream)
+            args.append(self.parse_math2())
+        if len(args) == 1:
+            return args[0]
+        return nodes.Concat(args, lineno=lineno)
+
+    def parse_math2(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_pow()
+        while self.stream.current.type in ("mul", "div", "floordiv", "mod"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_pow()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_pow(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_unary()
+        while self.stream.current.type == "pow":
+            next(self.stream)
+            right = self.parse_unary()
+            left = nodes.Pow(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_unary(self, with_filter=True):
+        token_type = self.stream.current.type
+        lineno = self.stream.current.lineno
+        if token_type == "sub":
+            next(self.stream)
+            node = nodes.Neg(self.parse_unary(False), lineno=lineno)
+        elif token_type == "add":
+            next(self.stream)
+            node = nodes.Pos(self.parse_unary(False), lineno=lineno)
+        else:
+            node = self.parse_primary()
+        node = self.parse_postfix(node)
+        if with_filter:
+            node = self.parse_filter_expr(node)
+        return node
+
+    def parse_primary(self):
+        token = self.stream.current
+        if token.type == "name":
+            if token.value in ("true", "false", "True", "False"):
+                node = nodes.Const(token.value in ("true", "True"), lineno=token.lineno)
+            elif token.value in ("none", "None"):
+                node = nodes.Const(None, lineno=token.lineno)
+            else:
+                node = nodes.Name(token.value, "load", lineno=token.lineno)
+            next(self.stream)
+        elif token.type == "string":
+            next(self.stream)
+            buf = [token.value]
+            lineno = token.lineno
+            while self.stream.current.type == "string":
+                buf.append(self.stream.current.value)
+                next(self.stream)
+            node = nodes.Const("".join(buf), lineno=lineno)
+        elif token.type in ("integer", "float"):
+            next(self.stream)
+            node = nodes.Const(token.value, lineno=token.lineno)
+        elif token.type == "lparen":
+            next(self.stream)
+            node = self.parse_tuple(explicit_parentheses=True)
+            self.stream.expect("rparen")
+        elif token.type == "lbracket":
+            node = self.parse_list()
+        elif token.type == "lbrace":
+            node = self.parse_dict()
+        else:
+            self.fail("unexpected '%s'" % describe_token(token), token.lineno)
+        return node
+
+    def parse_tuple(
+        self,
+        simplified=False,
+        with_condexpr=True,
+        extra_end_rules=None,
+        explicit_parentheses=False,
+    ):
+        """Works like `parse_expression` but if multiple expressions are
+        delimited by a comma a :class:`~jinja2.nodes.Tuple` node is created.
+        This method could also return a regular expression instead of a tuple
+        if no commas where found.
+
+        The default parsing mode is a full tuple.  If `simplified` is `True`
+        only names and literals are parsed.  The `no_condexpr` parameter is
+        forwarded to :meth:`parse_expression`.
+
+        Because tuples do not require delimiters and may end in a bogus comma
+        an extra hint is needed that marks the end of a tuple.  For example
+        for loops support tuples between `for` and `in`.  In that case the
+        `extra_end_rules` is set to ``['name:in']``.
+
+        `explicit_parentheses` is true if the parsing was triggered by an
+        expression in parentheses.  This is used to figure out if an empty
+        tuple is a valid expression or not.
+        """
+        lineno = self.stream.current.lineno
+        if simplified:
+            parse = self.parse_primary
+        elif with_condexpr:
+            parse = self.parse_expression
+        else:
+
+            def parse():
+                return self.parse_expression(with_condexpr=False)
+
+        args = []
+        is_tuple = False
+        while 1:
+            if args:
+                self.stream.expect("comma")
+            if self.is_tuple_end(extra_end_rules):
+                break
+            args.append(parse())
+            if self.stream.current.type == "comma":
+                is_tuple = True
+            else:
+                break
+            lineno = self.stream.current.lineno
+
+        if not is_tuple:
+            if args:
+                return args[0]
+
+            # if we don't have explicit parentheses, an empty tuple is
+            # not a valid expression.  This would mean nothing (literally
+            # nothing) in the spot of an expression would be an empty
+            # tuple.
+            if not explicit_parentheses:
+                self.fail(
+                    "Expected an expression, got '%s'"
+                    % describe_token(self.stream.current)
+                )
+
+        return nodes.Tuple(args, "load", lineno=lineno)
+
+    def parse_list(self):
+        token = self.stream.expect("lbracket")
+        items = []
+        while self.stream.current.type != "rbracket":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbracket":
+                break
+            items.append(self.parse_expression())
+        self.stream.expect("rbracket")
+        return nodes.List(items, lineno=token.lineno)
+
+    def parse_dict(self):
+        token = self.stream.expect("lbrace")
+        items = []
+        while self.stream.current.type != "rbrace":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbrace":
+                break
+            key = self.parse_expression()
+            self.stream.expect("colon")
+            value = self.parse_expression()
+            items.append(nodes.Pair(key, value, lineno=key.lineno))
+        self.stream.expect("rbrace")
+        return nodes.Dict(items, lineno=token.lineno)
+
+    def parse_postfix(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "dot" or token_type == "lbracket":
+                node = self.parse_subscript(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_filter_expr(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "pipe":
+                node = self.parse_filter(node)
+            elif token_type == "name" and self.stream.current.value == "is":
+                node = self.parse_test(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_subscript(self, node):
+        token = next(self.stream)
+        if token.type == "dot":
+            attr_token = self.stream.current
+            next(self.stream)
+            if attr_token.type == "name":
+                return nodes.Getattr(
+                    node, attr_token.value, "load", lineno=token.lineno
+                )
+            elif attr_token.type != "integer":
+                self.fail("expected name or number", attr_token.lineno)
+            arg = nodes.Const(attr_token.value, lineno=attr_token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        if token.type == "lbracket":
+            args = []
+            while self.stream.current.type != "rbracket":
+                if args:
+                    self.stream.expect("comma")
+                args.append(self.parse_subscribed())
+            self.stream.expect("rbracket")
+            if len(args) == 1:
+                arg = args[0]
+            else:
+                arg = nodes.Tuple(args, "load", lineno=token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        self.fail("expected subscript expression", token.lineno)
+
+    def parse_subscribed(self):
+        lineno = self.stream.current.lineno
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            args = [None]
+        else:
+            node = self.parse_expression()
+            if self.stream.current.type != "colon":
+                return node
+            next(self.stream)
+            args = [node]
+
+        if self.stream.current.type == "colon":
+            args.append(None)
+        elif self.stream.current.type not in ("rbracket", "comma"):
+            args.append(self.parse_expression())
+        else:
+            args.append(None)
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            if self.stream.current.type not in ("rbracket", "comma"):
+                args.append(self.parse_expression())
+            else:
+                args.append(None)
+        else:
+            args.append(None)
+
+        return nodes.Slice(lineno=lineno, *args)
+
+    def parse_call(self, node):
+        token = self.stream.expect("lparen")
+        args = []
+        kwargs = []
+        dyn_args = dyn_kwargs = None
+        require_comma = False
+
+        def ensure(expr):
+            if not expr:
+                self.fail("invalid syntax for function call expression", token.lineno)
+
+        while self.stream.current.type != "rparen":
+            if require_comma:
+                self.stream.expect("comma")
+                # support for trailing comma
+                if self.stream.current.type == "rparen":
+                    break
+            if self.stream.current.type == "mul":
+                ensure(dyn_args is None and dyn_kwargs is None)
+                next(self.stream)
+                dyn_args = self.parse_expression()
+            elif self.stream.current.type == "pow":
+                ensure(dyn_kwargs is None)
+                next(self.stream)
+                dyn_kwargs = self.parse_expression()
+            else:
+                if (
+                    self.stream.current.type == "name"
+                    and self.stream.look().type == "assign"
+                ):
+                    # Parsing a kwarg
+                    ensure(dyn_kwargs is None)
+                    key = self.stream.current.value
+                    self.stream.skip(2)
+                    value = self.parse_expression()
+                    kwargs.append(nodes.Keyword(key, value, lineno=value.lineno))
+                else:
+                    # Parsing an arg
+                    ensure(dyn_args is None and dyn_kwargs is None and not kwargs)
+                    args.append(self.parse_expression())
+
+            require_comma = True
+        self.stream.expect("rparen")
+
+        if node is None:
+            return args, kwargs, dyn_args, dyn_kwargs
+        return nodes.Call(node, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno)
+
+    def parse_filter(self, node, start_inline=False):
+        while self.stream.current.type == "pipe" or start_inline:
+            if not start_inline:
+                next(self.stream)
+            token = self.stream.expect("name")
+            name = token.value
+            while self.stream.current.type == "dot":
+                next(self.stream)
+                name += "." + self.stream.expect("name").value
+            if self.stream.current.type == "lparen":
+                args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+            else:
+                args = []
+                kwargs = []
+                dyn_args = dyn_kwargs = None
+            node = nodes.Filter(
+                node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+            )
+            start_inline = False
+        return node
+
+    def parse_test(self, node):
+        token = next(self.stream)
+        if self.stream.current.test("name:not"):
+            next(self.stream)
+            negated = True
+        else:
+            negated = False
+        name = self.stream.expect("name").value
+        while self.stream.current.type == "dot":
+            next(self.stream)
+            name += "." + self.stream.expect("name").value
+        dyn_args = dyn_kwargs = None
+        kwargs = []
+        if self.stream.current.type == "lparen":
+            args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+        elif self.stream.current.type in (
+            "name",
+            "string",
+            "integer",
+            "float",
+            "lparen",
+            "lbracket",
+            "lbrace",
+        ) and not self.stream.current.test_any("name:else", "name:or", "name:and"):
+            if self.stream.current.test("name:is"):
+                self.fail("You cannot chain multiple tests with is")
+            arg_node = self.parse_primary()
+            arg_node = self.parse_postfix(arg_node)
+            args = [arg_node]
+        else:
+            args = []
+        node = nodes.Test(
+            node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+        )
+        if negated:
+            node = nodes.Not(node, lineno=token.lineno)
+        return node
+
+    def subparse(self, end_tokens=None):
+        body = []
+        data_buffer = []
+        add_data = data_buffer.append
+
+        if end_tokens is not None:
+            self._end_token_stack.append(end_tokens)
+
+        def flush_data():
+            if data_buffer:
+                lineno = data_buffer[0].lineno
+                body.append(nodes.Output(data_buffer[:], lineno=lineno))
+                del data_buffer[:]
+
+        try:
+            while self.stream:
+                token = self.stream.current
+                if token.type == "data":
+                    if token.value:
+                        add_data(nodes.TemplateData(token.value, lineno=token.lineno))
+                    next(self.stream)
+                elif token.type == "variable_begin":
+                    next(self.stream)
+                    add_data(self.parse_tuple(with_condexpr=True))
+                    self.stream.expect("variable_end")
+                elif token.type == "block_begin":
+                    flush_data()
+                    next(self.stream)
+                    if end_tokens is not None and self.stream.current.test_any(
+                        *end_tokens
+                    ):
+                        return body
+                    rv = self.parse_statement()
+                    if isinstance(rv, list):
+                        body.extend(rv)
+                    else:
+                        body.append(rv)
+                    self.stream.expect("block_end")
+                else:
+                    raise AssertionError("internal parsing error")
+
+            flush_data()
+        finally:
+            if end_tokens is not None:
+                self._end_token_stack.pop()
+
+        return body
+
+    def parse(self):
+        """Parse the whole template into a `Template` node."""
+        result = nodes.Template(self.subparse(), lineno=1)
+        result.set_environment(self.environment)
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/runtime.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/runtime.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ad79686242d35b2ce587ac8267259621d4769e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/runtime.py
@@ -0,0 +1,1011 @@
+# -*- coding: utf-8 -*-
+"""The runtime functions and state used by compiled templates."""
+import sys
+from itertools import chain
+from types import MethodType
+
+from markupsafe import escape  # noqa: F401
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import with_metaclass
+from .exceptions import TemplateNotFound  # noqa: F401
+from .exceptions import TemplateRuntimeError  # noqa: F401
+from .exceptions import UndefinedError
+from .nodes import EvalContext
+from .utils import concat
+from .utils import evalcontextfunction
+from .utils import internalcode
+from .utils import missing
+from .utils import Namespace  # noqa: F401
+from .utils import object_type_repr
+
+# these variables are exported to the template runtime
+exported = [
+    "LoopContext",
+    "TemplateReference",
+    "Macro",
+    "Markup",
+    "TemplateRuntimeError",
+    "missing",
+    "concat",
+    "escape",
+    "markup_join",
+    "unicode_join",
+    "to_string",
+    "identity",
+    "TemplateNotFound",
+    "Namespace",
+    "Undefined",
+]
+
+#: the name of the function that is used to convert something into
+#: a string.  We can just use the text type here.
+to_string = text_type
+
+
+def identity(x):
+    """Returns its argument. Useful for certain things in the
+    environment.
+    """
+    return x
+
+
+def markup_join(seq):
+    """Concatenation that escapes if necessary and converts to unicode."""
+    buf = []
+    iterator = imap(soft_unicode, seq)
+    for arg in iterator:
+        buf.append(arg)
+        if hasattr(arg, "__html__"):
+            return Markup(u"").join(chain(buf, iterator))
+    return concat(buf)
+
+
+def unicode_join(seq):
+    """Simple args to unicode conversion and concatenation."""
+    return concat(imap(text_type, seq))
+
+
+def new_context(
+    environment,
+    template_name,
+    blocks,
+    vars=None,
+    shared=None,
+    globals=None,
+    locals=None,
+):
+    """Internal helper for context creation."""
+    if vars is None:
+        vars = {}
+    if shared:
+        parent = vars
+    else:
+        parent = dict(globals or (), **vars)
+    if locals:
+        # if the parent is shared a copy should be created because
+        # we don't want to modify the dict passed
+        if shared:
+            parent = dict(parent)
+        for key, value in iteritems(locals):
+            if value is not missing:
+                parent[key] = value
+    return environment.context_class(environment, parent, template_name, blocks)
+
+
+class TemplateReference(object):
+    """The `self` in templates."""
+
+    def __init__(self, context):
+        self.__context = context
+
+    def __getitem__(self, name):
+        blocks = self.__context.blocks[name]
+        return BlockReference(name, self.__context, blocks, 0)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self.__context.name)
+
+
+def _get_func(x):
+    return getattr(x, "__func__", x)
+
+
+class ContextMeta(type):
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        if bases == ():
+            return rv
+
+        resolve = _get_func(rv.resolve)
+        default_resolve = _get_func(Context.resolve)
+        resolve_or_missing = _get_func(rv.resolve_or_missing)
+        default_resolve_or_missing = _get_func(Context.resolve_or_missing)
+
+        # If we have a changed resolve but no changed default or missing
+        # resolve we invert the call logic.
+        if (
+            resolve is not default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._legacy_resolve_mode = True
+        elif (
+            resolve is default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._fast_resolve_mode = True
+
+        return rv
+
+
+def resolve_or_missing(context, key, missing=missing):
+    if key in context.vars:
+        return context.vars[key]
+    if key in context.parent:
+        return context.parent[key]
+    return missing
+
+
+class Context(with_metaclass(ContextMeta)):
+    """The template context holds the variables of a template.  It stores the
+    values passed to the template and also the names the template exports.
+    Creating instances is neither supported nor useful as it's created
+    automatically at various stages of the template evaluation and should not
+    be created by hand.
+
+    The context is immutable.  Modifications on :attr:`parent` **must not**
+    happen and modifications on :attr:`vars` are allowed from generated
+    template code only.  Template filters and global functions marked as
+    :func:`contextfunction`\\s get the active context passed as first argument
+    and are allowed to access the context read-only.
+
+    The template context supports read only dict operations (`get`,
+    `keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`,
+    `__getitem__`, `__contains__`).  Additionally there is a :meth:`resolve`
+    method that doesn't fail with a `KeyError` but returns an
+    :class:`Undefined` object for missing variables.
+    """
+
+    # XXX: we want to eventually make this be a deprecation warning and
+    # remove it.
+    _legacy_resolve_mode = False
+    _fast_resolve_mode = False
+
+    def __init__(self, environment, parent, name, blocks):
+        self.parent = parent
+        self.vars = {}
+        self.environment = environment
+        self.eval_ctx = EvalContext(self.environment, name)
+        self.exported_vars = set()
+        self.name = name
+
+        # create the initial mapping of blocks.  Whenever template inheritance
+        # takes place the runtime will update this mapping with the new blocks
+        # from the template.
+        self.blocks = dict((k, [v]) for k, v in iteritems(blocks))
+
+        # In case we detect the fast resolve mode we can set up an alias
+        # here that bypasses the legacy code logic.
+        if self._fast_resolve_mode:
+            self.resolve_or_missing = MethodType(resolve_or_missing, self)
+
+    def super(self, name, current):
+        """Render a parent block."""
+        try:
+            blocks = self.blocks[name]
+            index = blocks.index(current) + 1
+            blocks[index]
+        except LookupError:
+            return self.environment.undefined(
+                "there is no parent block called %r." % name, name="super"
+            )
+        return BlockReference(name, self, blocks, index)
+
+    def get(self, key, default=None):
+        """Returns an item from the template context, if it doesn't exist
+        `default` is returned.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def resolve(self, key):
+        """Looks up a variable like `__getitem__` or `get` but returns an
+        :class:`Undefined` object with the name of the name looked up.
+        """
+        if self._legacy_resolve_mode:
+            rv = resolve_or_missing(self, key)
+        else:
+            rv = self.resolve_or_missing(key)
+        if rv is missing:
+            return self.environment.undefined(name=key)
+        return rv
+
+    def resolve_or_missing(self, key):
+        """Resolves a variable like :meth:`resolve` but returns the
+        special `missing` value if it cannot be found.
+        """
+        if self._legacy_resolve_mode:
+            rv = self.resolve(key)
+            if isinstance(rv, Undefined):
+                rv = missing
+            return rv
+        return resolve_or_missing(self, key)
+
+    def get_exported(self):
+        """Get a new dict with the exported variables."""
+        return dict((k, self.vars[k]) for k in self.exported_vars)
+
+    def get_all(self):
+        """Return the complete context as dict including the exported
+        variables.  For optimizations reasons this might not return an
+        actual copy so be careful with using it.
+        """
+        if not self.vars:
+            return self.parent
+        if not self.parent:
+            return self.vars
+        return dict(self.parent, **self.vars)
+
+    @internalcode
+    def call(__self, __obj, *args, **kwargs):  # noqa: B902
+        """Call the callable with the arguments and keyword arguments
+        provided but inject the active context or environment as first
+        argument if the callable is a :func:`contextfunction` or
+        :func:`environmentfunction`.
+        """
+        if __debug__:
+            __traceback_hide__ = True  # noqa
+
+        # Allow callable classes to take a context
+        if hasattr(__obj, "__call__"):  # noqa: B004
+            fn = __obj.__call__
+            for fn_type in (
+                "contextfunction",
+                "evalcontextfunction",
+                "environmentfunction",
+            ):
+                if hasattr(fn, fn_type):
+                    __obj = fn
+                    break
+
+        if callable(__obj):
+            if getattr(__obj, "contextfunction", False) is True:
+                args = (__self,) + args
+            elif getattr(__obj, "evalcontextfunction", False) is True:
+                args = (__self.eval_ctx,) + args
+            elif getattr(__obj, "environmentfunction", False) is True:
+                args = (__self.environment,) + args
+        try:
+            return __obj(*args, **kwargs)
+        except StopIteration:
+            return __self.environment.undefined(
+                "value was undefined because "
+                "a callable raised a "
+                "StopIteration exception"
+            )
+
+    def derived(self, locals=None):
+        """Internal helper function to create a derived context.  This is
+        used in situations where the system needs a new context in the same
+        template that is independent.
+        """
+        context = new_context(
+            self.environment, self.name, {}, self.get_all(), True, None, locals
+        )
+        context.eval_ctx = self.eval_ctx
+        context.blocks.update((k, list(v)) for k, v in iteritems(self.blocks))
+        return context
+
+    def _all(meth):  # noqa: B902
+        def proxy(self):
+            return getattr(self.get_all(), meth)()
+
+        proxy.__doc__ = getattr(dict, meth).__doc__
+        proxy.__name__ = meth
+        return proxy
+
+    keys = _all("keys")
+    values = _all("values")
+    items = _all("items")
+
+    # not available on python 3
+    if PY2:
+        iterkeys = _all("iterkeys")
+        itervalues = _all("itervalues")
+        iteritems = _all("iteritems")
+    del _all
+
+    def __contains__(self, name):
+        return name in self.vars or name in self.parent
+
+    def __getitem__(self, key):
+        """Lookup a variable or raise `KeyError` if the variable is
+        undefined.
+        """
+        item = self.resolve_or_missing(key)
+        if item is missing:
+            raise KeyError(key)
+        return item
+
+    def __repr__(self):
+        return "<%s %s of %r>" % (
+            self.__class__.__name__,
+            repr(self.get_all()),
+            self.name,
+        )
+
+
+abc.Mapping.register(Context)
+
+
+class BlockReference(object):
+    """One block on a template reference."""
+
+    def __init__(self, name, context, stack, depth):
+        self.name = name
+        self._context = context
+        self._stack = stack
+        self._depth = depth
+
+    @property
+    def super(self):
+        """Super the block."""
+        if self._depth + 1 >= len(self._stack):
+            return self._context.environment.undefined(
+                "there is no parent block called %r." % self.name, name="super"
+            )
+        return BlockReference(self.name, self._context, self._stack, self._depth + 1)
+
+    @internalcode
+    def __call__(self):
+        rv = concat(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+
+@implements_iterator
+class LoopContext:
+    """A wrapper iterable for dynamic ``for`` loops, with information
+    about the loop and iteration.
+    """
+
+    #: Current iteration of the loop, starting at 0.
+    index0 = -1
+
+    _length = None
+    _after = missing
+    _current = missing
+    _before = missing
+    _last_changed_value = missing
+
+    def __init__(self, iterable, undefined, recurse=None, depth0=0):
+        """
+        :param iterable: Iterable to wrap.
+        :param undefined: :class:`Undefined` class to use for next and
+            previous items.
+        :param recurse: The function to render the loop body when the
+            loop is marked recursive.
+        :param depth0: Incremented when looping recursively.
+        """
+        self._iterable = iterable
+        self._iterator = self._to_iterator(iterable)
+        self._undefined = undefined
+        self._recurse = recurse
+        #: How many levels deep a recursive loop currently is, starting at 0.
+        self.depth0 = depth0
+
+    @staticmethod
+    def _to_iterator(iterable):
+        return iter(iterable)
+
+    @property
+    def length(self):
+        """Length of the iterable.
+
+        If the iterable is a generator or otherwise does not have a
+        size, it is eagerly evaluated to get a size.
+        """
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = list(self._iterator)
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    def __len__(self):
+        return self.length
+
+    @property
+    def depth(self):
+        """How many levels deep a recursive loop currently is, starting at 1."""
+        return self.depth0 + 1
+
+    @property
+    def index(self):
+        """Current iteration of the loop, starting at 1."""
+        return self.index0 + 1
+
+    @property
+    def revindex0(self):
+        """Number of iterations from the end of the loop, ending at 0.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index
+
+    @property
+    def revindex(self):
+        """Number of iterations from the end of the loop, ending at 1.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index0
+
+    @property
+    def first(self):
+        """Whether this is the first iteration of the loop."""
+        return self.index0 == 0
+
+    def _peek_next(self):
+        """Return the next element in the iterable, or :data:`missing`
+        if the iterable is exhausted. Only peeks one item ahead, caching
+        the result in :attr:`_last` for use in subsequent checks. The
+        cache is reset when :meth:`__next__` is called.
+        """
+        if self._after is not missing:
+            return self._after
+
+        self._after = next(self._iterator, missing)
+        return self._after
+
+    @property
+    def last(self):
+        """Whether this is the last iteration of the loop.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        return self._peek_next() is missing
+
+    @property
+    def previtem(self):
+        """The item in the previous iteration. Undefined during the
+        first iteration.
+        """
+        if self.first:
+            return self._undefined("there is no previous item")
+
+        return self._before
+
+    @property
+    def nextitem(self):
+        """The item in the next iteration. Undefined during the last
+        iteration.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        rv = self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def cycle(self, *args):
+        """Return a value from the given args, cycling through based on
+        the current :attr:`index0`.
+
+        :param args: One or more values to cycle through.
+        """
+        if not args:
+            raise TypeError("no items for cycling given")
+
+        return args[self.index0 % len(args)]
+
+    def changed(self, *value):
+        """Return ``True`` if previously called with a different value
+        (including when called for the first time).
+
+        :param value: One or more values to compare to the last call.
+        """
+        if self._last_changed_value != value:
+            self._last_changed_value = value
+            return True
+
+        return False
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = next(self._iterator)
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+    @internalcode
+    def __call__(self, iterable):
+        """When iterating over nested data, render the body of the loop
+        recursively with the given inner iterable data.
+
+        The loop must have the ``recursive`` marker for this to work.
+        """
+        if self._recurse is None:
+            raise TypeError(
+                "The loop must have the 'recursive' marker to be called recursively."
+            )
+
+        return self._recurse(iterable, self._recurse, depth=self.depth)
+
+    def __repr__(self):
+        return "<%s %d/%d>" % (self.__class__.__name__, self.index, self.length)
+
+
+class Macro(object):
+    """Wraps a macro function."""
+
+    def __init__(
+        self,
+        environment,
+        func,
+        name,
+        arguments,
+        catch_kwargs,
+        catch_varargs,
+        caller,
+        default_autoescape=None,
+    ):
+        self._environment = environment
+        self._func = func
+        self._argument_count = len(arguments)
+        self.name = name
+        self.arguments = arguments
+        self.catch_kwargs = catch_kwargs
+        self.catch_varargs = catch_varargs
+        self.caller = caller
+        self.explicit_caller = "caller" in arguments
+        if default_autoescape is None:
+            default_autoescape = environment.autoescape
+        self._default_autoescape = default_autoescape
+
+    @internalcode
+    @evalcontextfunction
+    def __call__(self, *args, **kwargs):
+        # This requires a bit of explanation,  In the past we used to
+        # decide largely based on compile-time information if a macro is
+        # safe or unsafe.  While there was a volatile mode it was largely
+        # unused for deciding on escaping.  This turns out to be
+        # problematic for macros because whether a macro is safe depends not
+        # on the escape mode when it was defined, but rather when it was used.
+        #
+        # Because however we export macros from the module system and
+        # there are historic callers that do not pass an eval context (and
+        # will continue to not pass one), we need to perform an instance
+        # check here.
+        #
+        # This is considered safe because an eval context is not a valid
+        # argument to callables otherwise anyway.  Worst case here is
+        # that if no eval context is passed we fall back to the compile
+        # time autoescape flag.
+        if args and isinstance(args[0], EvalContext):
+            autoescape = args[0].autoescape
+            args = args[1:]
+        else:
+            autoescape = self._default_autoescape
+
+        # try to consume the positional arguments
+        arguments = list(args[: self._argument_count])
+        off = len(arguments)
+
+        # For information why this is necessary refer to the handling
+        # of caller in the `macro_body` handler in the compiler.
+        found_caller = False
+
+        # if the number of arguments consumed is not the number of
+        # arguments expected we start filling in keyword arguments
+        # and defaults.
+        if off != self._argument_count:
+            for name in self.arguments[len(arguments) :]:
+                try:
+                    value = kwargs.pop(name)
+                except KeyError:
+                    value = missing
+                if name == "caller":
+                    found_caller = True
+                arguments.append(value)
+        else:
+            found_caller = self.explicit_caller
+
+        # it's important that the order of these arguments does not change
+        # if not also changed in the compiler's `function_scoping` method.
+        # the order is caller, keyword arguments, positional arguments!
+        if self.caller and not found_caller:
+            caller = kwargs.pop("caller", None)
+            if caller is None:
+                caller = self._environment.undefined("No caller defined", name="caller")
+            arguments.append(caller)
+
+        if self.catch_kwargs:
+            arguments.append(kwargs)
+        elif kwargs:
+            if "caller" in kwargs:
+                raise TypeError(
+                    "macro %r was invoked with two values for "
+                    "the special caller argument.  This is "
+                    "most likely a bug." % self.name
+                )
+            raise TypeError(
+                "macro %r takes no keyword argument %r"
+                % (self.name, next(iter(kwargs)))
+            )
+        if self.catch_varargs:
+            arguments.append(args[self._argument_count :])
+        elif len(args) > self._argument_count:
+            raise TypeError(
+                "macro %r takes not more than %d argument(s)"
+                % (self.name, len(self.arguments))
+            )
+
+        return self._invoke(arguments, autoescape)
+
+    def _invoke(self, arguments, autoescape):
+        """This method is being swapped out by the async implementation."""
+        rv = self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    def __repr__(self):
+        return "<%s %s>" % (
+            self.__class__.__name__,
+            self.name is None and "anonymous" or repr(self.name),
+        )
+
+
+@implements_to_string
+class Undefined(object):
+    """The default undefined type.  This undefined type can be printed and
+    iterated over, but every other access will raise an :exc:`UndefinedError`:
+
+    >>> foo = Undefined(name='foo')
+    >>> str(foo)
+    ''
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = (
+        "_undefined_hint",
+        "_undefined_obj",
+        "_undefined_name",
+        "_undefined_exception",
+    )
+
+    def __init__(self, hint=None, obj=missing, name=None, exc=UndefinedError):
+        self._undefined_hint = hint
+        self._undefined_obj = obj
+        self._undefined_name = name
+        self._undefined_exception = exc
+
+    @property
+    def _undefined_message(self):
+        """Build a message about the undefined value based on how it was
+        accessed.
+        """
+        if self._undefined_hint:
+            return self._undefined_hint
+
+        if self._undefined_obj is missing:
+            return "%r is undefined" % self._undefined_name
+
+        if not isinstance(self._undefined_name, string_types):
+            return "%s has no element %r" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+
+        return "%r has no attribute %r" % (
+            object_type_repr(self._undefined_obj),
+            self._undefined_name,
+        )
+
+    @internalcode
+    def _fail_with_undefined_error(self, *args, **kwargs):
+        """Raise an :exc:`UndefinedError` when operations are performed
+        on the undefined value.
+        """
+        raise self._undefined_exception(self._undefined_message)
+
+    @internalcode
+    def __getattr__(self, name):
+        if name[:2] == "__":
+            raise AttributeError(name)
+        return self._fail_with_undefined_error()
+
+    __add__ = (
+        __radd__
+    ) = (
+        __mul__
+    ) = (
+        __rmul__
+    ) = (
+        __div__
+    ) = (
+        __rdiv__
+    ) = (
+        __truediv__
+    ) = (
+        __rtruediv__
+    ) = (
+        __floordiv__
+    ) = (
+        __rfloordiv__
+    ) = (
+        __mod__
+    ) = (
+        __rmod__
+    ) = (
+        __pos__
+    ) = (
+        __neg__
+    ) = (
+        __call__
+    ) = (
+        __getitem__
+    ) = (
+        __lt__
+    ) = (
+        __le__
+    ) = (
+        __gt__
+    ) = (
+        __ge__
+    ) = (
+        __int__
+    ) = (
+        __float__
+    ) = (
+        __complex__
+    ) = __pow__ = __rpow__ = __sub__ = __rsub__ = _fail_with_undefined_error
+
+    def __eq__(self, other):
+        return type(self) is type(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __hash__(self):
+        return id(type(self))
+
+    def __str__(self):
+        return u""
+
+    def __len__(self):
+        return 0
+
+    def __iter__(self):
+        if 0:
+            yield None
+
+    def __nonzero__(self):
+        return False
+
+    __bool__ = __nonzero__
+
+    def __repr__(self):
+        return "Undefined"
+
+
+def make_logging_undefined(logger=None, base=None):
+    """Given a logger object this returns a new undefined class that will
+    log certain failures.  It will log iterations and printing.  If no
+    logger is given a default logger is created.
+
+    Example::
+
+        logger = logging.getLogger(__name__)
+        LoggingUndefined = make_logging_undefined(
+            logger=logger,
+            base=Undefined
+        )
+
+    .. versionadded:: 2.8
+
+    :param logger: the logger to use.  If not provided, a default logger
+                   is created.
+    :param base: the base class to add logging functionality to.  This
+                 defaults to :class:`Undefined`.
+    """
+    if logger is None:
+        import logging
+
+        logger = logging.getLogger(__name__)
+        logger.addHandler(logging.StreamHandler(sys.stderr))
+    if base is None:
+        base = Undefined
+
+    def _log_message(undef):
+        if undef._undefined_hint is None:
+            if undef._undefined_obj is missing:
+                hint = "%s is undefined" % undef._undefined_name
+            elif not isinstance(undef._undefined_name, string_types):
+                hint = "%s has no element %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+            else:
+                hint = "%s has no attribute %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+        else:
+            hint = undef._undefined_hint
+        logger.warning("Template variable warning: %s", hint)
+
+    class LoggingUndefined(base):
+        def _fail_with_undefined_error(self, *args, **kwargs):
+            try:
+                return base._fail_with_undefined_error(self, *args, **kwargs)
+            except self._undefined_exception as e:
+                logger.error("Template variable error: %s", str(e))
+                raise e
+
+        def __str__(self):
+            rv = base.__str__(self)
+            _log_message(self)
+            return rv
+
+        def __iter__(self):
+            rv = base.__iter__(self)
+            _log_message(self)
+            return rv
+
+        if PY2:
+
+            def __nonzero__(self):
+                rv = base.__nonzero__(self)
+                _log_message(self)
+                return rv
+
+            def __unicode__(self):
+                rv = base.__unicode__(self)
+                _log_message(self)
+                return rv
+
+        else:
+
+            def __bool__(self):
+                rv = base.__bool__(self)
+                _log_message(self)
+                return rv
+
+    return LoggingUndefined
+
+
+# No @implements_to_string decorator here because __str__
+# is not overwritten from Undefined in this class.
+# This would cause a recursion error in Python 2.
+class ChainableUndefined(Undefined):
+    """An undefined that is chainable, where both ``__getattr__`` and
+    ``__getitem__`` return itself rather than raising an
+    :exc:`UndefinedError`.
+
+    >>> foo = ChainableUndefined(name='foo')
+    >>> str(foo.bar['baz'])
+    ''
+    >>> foo.bar['baz'] + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+
+    .. versionadded:: 2.11.0
+    """
+
+    __slots__ = ()
+
+    def __html__(self):
+        return self.__str__()
+
+    def __getattr__(self, _):
+        return self
+
+    __getitem__ = __getattr__
+
+
+@implements_to_string
+class DebugUndefined(Undefined):
+    """An undefined that returns the debug info when printed.
+
+    >>> foo = DebugUndefined(name='foo')
+    >>> str(foo)
+    '{{ foo }}'
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+
+    def __str__(self):
+        if self._undefined_hint is None:
+            if self._undefined_obj is missing:
+                return u"{{ %s }}" % self._undefined_name
+            return "{{ no such element: %s[%r] }}" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+        return u"{{ undefined value printed: %s }}" % self._undefined_hint
+
+
+@implements_to_string
+class StrictUndefined(Undefined):
+    """An undefined that barks on print and iteration as well as boolean
+    tests and all kinds of comparisons.  In other words: you can do nothing
+    with it except checking if it's defined using the `defined` test.
+
+    >>> foo = StrictUndefined(name='foo')
+    >>> str(foo)
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> not foo
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+    __iter__ = (
+        __str__
+    ) = (
+        __len__
+    ) = (
+        __nonzero__
+    ) = __eq__ = __ne__ = __bool__ = __hash__ = Undefined._fail_with_undefined_error
+
+
+# remove remaining slots attributes, after the metaclass did the magic they
+# are unneeded and irritating as they contain wrong data for the subclasses.
+del (
+    Undefined.__slots__,
+    ChainableUndefined.__slots__,
+    DebugUndefined.__slots__,
+    StrictUndefined.__slots__,
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/sandbox.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/sandbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..cfd7993aee3358d332495cbcbcc46336a191006f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/sandbox.py
@@ -0,0 +1,510 @@
+# -*- coding: utf-8 -*-
+"""A sandbox layer that ensures unsafe operations cannot be performed.
+Useful when the template itself comes from an untrusted source.
+"""
+import operator
+import types
+import warnings
+from collections import deque
+from string import Formatter
+
+from markupsafe import EscapeFormatter
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import PY2
+from ._compat import range_type
+from ._compat import string_types
+from .environment import Environment
+from .exceptions import SecurityError
+
+#: maximum number of items a range may produce
+MAX_RANGE = 100000
+
+#: attributes of function objects that are considered unsafe.
+if PY2:
+    UNSAFE_FUNCTION_ATTRIBUTES = {
+        "func_closure",
+        "func_code",
+        "func_dict",
+        "func_defaults",
+        "func_globals",
+    }
+else:
+    # On versions > python 2 the special attributes on functions are gone,
+    # but they remain on methods and generators for whatever reason.
+    UNSAFE_FUNCTION_ATTRIBUTES = set()
+
+#: unsafe method attributes.  function attributes are unsafe for methods too
+UNSAFE_METHOD_ATTRIBUTES = {"im_class", "im_func", "im_self"}
+
+#: unsafe generator attributes.
+UNSAFE_GENERATOR_ATTRIBUTES = {"gi_frame", "gi_code"}
+
+#: unsafe attributes on coroutines
+UNSAFE_COROUTINE_ATTRIBUTES = {"cr_frame", "cr_code"}
+
+#: unsafe attributes on async generators
+UNSAFE_ASYNC_GENERATOR_ATTRIBUTES = {"ag_code", "ag_frame"}
+
+# make sure we don't warn in python 2.6 about stuff we don't care about
+warnings.filterwarnings(
+    "ignore", "the sets module", DeprecationWarning, module=__name__
+)
+
+_mutable_set_types = (set,)
+_mutable_mapping_types = (dict,)
+_mutable_sequence_types = (list,)
+
+# on python 2.x we can register the user collection types
+try:
+    from UserDict import UserDict, DictMixin
+    from UserList import UserList
+
+    _mutable_mapping_types += (UserDict, DictMixin)
+    _mutable_set_types += (UserList,)
+except ImportError:
+    pass
+
+# if sets is still available, register the mutable set from there as well
+try:
+    from sets import Set
+
+    _mutable_set_types += (Set,)
+except ImportError:
+    pass
+
+#: register Python 2.6 abstract base classes
+_mutable_set_types += (abc.MutableSet,)
+_mutable_mapping_types += (abc.MutableMapping,)
+_mutable_sequence_types += (abc.MutableSequence,)
+
+_mutable_spec = (
+    (
+        _mutable_set_types,
+        frozenset(
+            [
+                "add",
+                "clear",
+                "difference_update",
+                "discard",
+                "pop",
+                "remove",
+                "symmetric_difference_update",
+                "update",
+            ]
+        ),
+    ),
+    (
+        _mutable_mapping_types,
+        frozenset(["clear", "pop", "popitem", "setdefault", "update"]),
+    ),
+    (
+        _mutable_sequence_types,
+        frozenset(["append", "reverse", "insert", "sort", "extend", "remove"]),
+    ),
+    (
+        deque,
+        frozenset(
+            [
+                "append",
+                "appendleft",
+                "clear",
+                "extend",
+                "extendleft",
+                "pop",
+                "popleft",
+                "remove",
+                "rotate",
+            ]
+        ),
+    ),
+)
+
+
+class _MagicFormatMapping(abc.Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See https://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+def inspect_format_method(callable):
+    if not isinstance(
+        callable, (types.MethodType, types.BuiltinMethodType)
+    ) or callable.__name__ not in ("format", "format_map"):
+        return None
+    obj = callable.__self__
+    if isinstance(obj, string_types):
+        return obj
+
+
+def safe_range(*args):
+    """A range that can't generate ranges with a length of more than
+    MAX_RANGE items.
+    """
+    rng = range_type(*args)
+
+    if len(rng) > MAX_RANGE:
+        raise OverflowError(
+            "Range too big. The sandbox blocks ranges larger than"
+            " MAX_RANGE (%d)." % MAX_RANGE
+        )
+
+    return rng
+
+
+def unsafe(f):
+    """Marks a function or method as unsafe.
+
+    ::
+
+        @unsafe
+        def delete(self):
+            pass
+    """
+    f.unsafe_callable = True
+    return f
+
+
+def is_internal_attribute(obj, attr):
+    """Test if the attribute given is an internal python attribute.  For
+    example this function returns `True` for the `func_code` attribute of
+    python objects.  This is useful if the environment method
+    :meth:`~SandboxedEnvironment.is_safe_attribute` is overridden.
+
+    >>> from jinja2.sandbox import is_internal_attribute
+    >>> is_internal_attribute(str, "mro")
+    True
+    >>> is_internal_attribute(str, "upper")
+    False
+    """
+    if isinstance(obj, types.FunctionType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES:
+            return True
+    elif isinstance(obj, types.MethodType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES or attr in UNSAFE_METHOD_ATTRIBUTES:
+            return True
+    elif isinstance(obj, type):
+        if attr == "mro":
+            return True
+    elif isinstance(obj, (types.CodeType, types.TracebackType, types.FrameType)):
+        return True
+    elif isinstance(obj, types.GeneratorType):
+        if attr in UNSAFE_GENERATOR_ATTRIBUTES:
+            return True
+    elif hasattr(types, "CoroutineType") and isinstance(obj, types.CoroutineType):
+        if attr in UNSAFE_COROUTINE_ATTRIBUTES:
+            return True
+    elif hasattr(types, "AsyncGeneratorType") and isinstance(
+        obj, types.AsyncGeneratorType
+    ):
+        if attr in UNSAFE_ASYNC_GENERATOR_ATTRIBUTES:
+            return True
+    return attr.startswith("__")
+
+
+def modifies_known_mutable(obj, attr):
+    """This function checks if an attribute on a builtin mutable object
+    (list, dict, set or deque) would modify it if called.  It also supports
+    the "user"-versions of the objects (`sets.Set`, `UserDict.*` etc.) and
+    with Python 2.6 onwards the abstract base classes `MutableSet`,
+    `MutableMapping`, and `MutableSequence`.
+
+    >>> modifies_known_mutable({}, "clear")
+    True
+    >>> modifies_known_mutable({}, "keys")
+    False
+    >>> modifies_known_mutable([], "append")
+    True
+    >>> modifies_known_mutable([], "index")
+    False
+
+    If called with an unsupported object (such as unicode) `False` is
+    returned.
+
+    >>> modifies_known_mutable("foo", "upper")
+    False
+    """
+    for typespec, unsafe in _mutable_spec:
+        if isinstance(obj, typespec):
+            return attr in unsafe
+    return False
+
+
+class SandboxedEnvironment(Environment):
+    """The sandboxed environment.  It works like the regular environment but
+    tells the compiler to generate sandboxed code.  Additionally subclasses of
+    this environment may override the methods that tell the runtime what
+    attributes or functions are safe to access.
+
+    If the template tries to access insecure code a :exc:`SecurityError` is
+    raised.  However also other exceptions may occur during the rendering so
+    the caller has to ensure that all exceptions are caught.
+    """
+
+    sandboxed = True
+
+    #: default callback table for the binary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`binop_table`
+    default_binop_table = {
+        "+": operator.add,
+        "-": operator.sub,
+        "*": operator.mul,
+        "/": operator.truediv,
+        "//": operator.floordiv,
+        "**": operator.pow,
+        "%": operator.mod,
+    }
+
+    #: default callback table for the unary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`unop_table`
+    default_unop_table = {"+": operator.pos, "-": operator.neg}
+
+    #: a set of binary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_binop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`binop_table`.
+    #:
+    #: The following binary operators are interceptable:
+    #: ``//``, ``%``, ``+``, ``*``, ``-``, ``/``, and ``**``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_binops = frozenset()
+
+    #: a set of unary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_unop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`unop_table`.
+    #:
+    #: The following unary operators are interceptable: ``+``, ``-``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_unops = frozenset()
+
+    def intercept_unop(self, operator):
+        """Called during template compilation with the name of a unary
+        operator to check if it should be intercepted at runtime.  If this
+        method returns `True`, :meth:`call_unop` is executed for this unary
+        operator.  The default implementation of :meth:`call_unop` will use
+        the :attr:`unop_table` dictionary to perform the operator with the
+        same logic as the builtin one.
+
+        The following unary operators are interceptable: ``+`` and ``-``
+
+        Intercepted calls are always slower than the native operator call,
+        so make sure only to intercept the ones you are interested in.
+
+        .. versionadded:: 2.6
+        """
+        return False
+
+    def __init__(self, *args, **kwargs):
+        Environment.__init__(self, *args, **kwargs)
+        self.globals["range"] = safe_range
+        self.binop_table = self.default_binop_table.copy()
+        self.unop_table = self.default_unop_table.copy()
+
+    def is_safe_attribute(self, obj, attr, value):
+        """The sandboxed environment will call this method to check if the
+        attribute of an object is safe to access.  Per default all attributes
+        starting with an underscore are considered private as well as the
+        special attributes of internal python objects as returned by the
+        :func:`is_internal_attribute` function.
+        """
+        return not (attr.startswith("_") or is_internal_attribute(obj, attr))
+
+    def is_safe_callable(self, obj):
+        """Check if an object is safely callable.  Per default a function is
+        considered safe unless the `unsafe_callable` attribute exists and is
+        True.  Override this method to alter the behavior, but this won't
+        affect the `unsafe` decorator from this module.
+        """
+        return not (
+            getattr(obj, "unsafe_callable", False) or getattr(obj, "alters_data", False)
+        )
+
+    def call_binop(self, context, operator, left, right):
+        """For intercepted binary operator calls (:meth:`intercepted_binops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.binop_table[operator](left, right)
+
+    def call_unop(self, context, operator, arg):
+        """For intercepted unary operator calls (:meth:`intercepted_unops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.unop_table[operator](arg)
+
+    def getitem(self, obj, argument):
+        """Subscribe an object from sandboxed code."""
+        try:
+            return obj[argument]
+        except (TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        value = getattr(obj, attr)
+                    except AttributeError:
+                        pass
+                    else:
+                        if self.is_safe_attribute(obj, argument, value):
+                            return value
+                        return self.unsafe_undefined(obj, argument)
+        return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Subscribe an object from sandboxed code and prefer the
+        attribute.  The attribute passed *must* be a bytestring.
+        """
+        try:
+            value = getattr(obj, attribute)
+        except AttributeError:
+            try:
+                return obj[attribute]
+            except (TypeError, LookupError):
+                pass
+        else:
+            if self.is_safe_attribute(obj, attribute, value):
+                return value
+            return self.unsafe_undefined(obj, attribute)
+        return self.undefined(obj=obj, name=attribute)
+
+    def unsafe_undefined(self, obj, attribute):
+        """Return an undefined object for unsafe attributes."""
+        return self.undefined(
+            "access to attribute %r of %r "
+            "object is unsafe." % (attribute, obj.__class__.__name__),
+            name=attribute,
+            obj=obj,
+            exc=SecurityError,
+        )
+
+    def format_string(self, s, args, kwargs, format_func=None):
+        """If a format call is detected, then this is routed through this
+        method so that our safety sandbox can be used for it.
+        """
+        if isinstance(s, Markup):
+            formatter = SandboxedEscapeFormatter(self, s.escape)
+        else:
+            formatter = SandboxedFormatter(self)
+
+        if format_func is not None and format_func.__name__ == "format_map":
+            if len(args) != 1 or kwargs:
+                raise TypeError(
+                    "format_map() takes exactly one argument %d given"
+                    % (len(args) + (kwargs is not None))
+                )
+
+            kwargs = args[0]
+            args = None
+
+        kwargs = _MagicFormatMapping(args, kwargs)
+        rv = formatter.vformat(s, args, kwargs)
+        return type(s)(rv)
+
+    def call(__self, __context, __obj, *args, **kwargs):  # noqa: B902
+        """Call an object from sandboxed code."""
+        fmt = inspect_format_method(__obj)
+        if fmt is not None:
+            return __self.format_string(fmt, args, kwargs, __obj)
+
+        # the double prefixes are to avoid double keyword argument
+        # errors when proxying the call.
+        if not __self.is_safe_callable(__obj):
+            raise SecurityError("%r is not safely callable" % (__obj,))
+        return __context.call(__obj, *args, **kwargs)
+
+
+class ImmutableSandboxedEnvironment(SandboxedEnvironment):
+    """Works exactly like the regular `SandboxedEnvironment` but does not
+    permit modifications on the builtin mutable objects `list`, `set`, and
+    `dict` by using the :func:`modifies_known_mutable` function.
+    """
+
+    def is_safe_attribute(self, obj, attr, value):
+        if not SandboxedEnvironment.is_safe_attribute(self, obj, attr, value):
+            return False
+        return not modifies_known_mutable(obj, attr)
+
+
+# This really is not a public API apparently.
+try:
+    from _string import formatter_field_name_split
+except ImportError:
+
+    def formatter_field_name_split(field_name):
+        return field_name._formatter_field_name_split()
+
+
+class SandboxedFormatterMixin(object):
+    def __init__(self, env):
+        self._env = env
+
+    def get_field(self, field_name, args, kwargs):
+        first, rest = formatter_field_name_split(field_name)
+        obj = self.get_value(first, args, kwargs)
+        for is_attr, i in rest:
+            if is_attr:
+                obj = self._env.getattr(obj, i)
+            else:
+                obj = self._env.getitem(obj, i)
+        return obj, first
+
+
+class SandboxedFormatter(SandboxedFormatterMixin, Formatter):
+    def __init__(self, env):
+        SandboxedFormatterMixin.__init__(self, env)
+        Formatter.__init__(self)
+
+
+class SandboxedEscapeFormatter(SandboxedFormatterMixin, EscapeFormatter):
+    def __init__(self, env, escape):
+        SandboxedFormatterMixin.__init__(self, env)
+        EscapeFormatter.__init__(self, escape)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/tests.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/tests.py
new file mode 100644
index 0000000000000000000000000000000000000000..fabd4ce51b6a049955d903762986974f59c625d0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/tests.py
@@ -0,0 +1,215 @@
+# -*- coding: utf-8 -*-
+"""Built-in template tests used with the ``is`` operator."""
+import decimal
+import operator
+import re
+
+from ._compat import abc
+from ._compat import integer_types
+from ._compat import string_types
+from ._compat import text_type
+from .runtime import Undefined
+
+number_re = re.compile(r"^-?\d+(\.\d+)?$")
+regex_type = type(number_re)
+test_callable = callable
+
+
+def test_odd(value):
+    """Return true if the variable is odd."""
+    return value % 2 == 1
+
+
+def test_even(value):
+    """Return true if the variable is even."""
+    return value % 2 == 0
+
+
+def test_divisibleby(value, num):
+    """Check if a variable is divisible by a number."""
+    return value % num == 0
+
+
+def test_defined(value):
+    """Return true if the variable is defined:
+
+    .. sourcecode:: jinja
+
+        {% if variable is defined %}
+            value of variable: {{ variable }}
+        {% else %}
+            variable is not defined
+        {% endif %}
+
+    See the :func:`default` filter for a simple way to set undefined
+    variables.
+    """
+    return not isinstance(value, Undefined)
+
+
+def test_undefined(value):
+    """Like :func:`defined` but the other way round."""
+    return isinstance(value, Undefined)
+
+
+def test_none(value):
+    """Return true if the variable is none."""
+    return value is None
+
+
+def test_boolean(value):
+    """Return true if the object is a boolean value.
+
+    .. versionadded:: 2.11
+    """
+    return value is True or value is False
+
+
+def test_false(value):
+    """Return true if the object is False.
+
+    .. versionadded:: 2.11
+    """
+    return value is False
+
+
+def test_true(value):
+    """Return true if the object is True.
+
+    .. versionadded:: 2.11
+    """
+    return value is True
+
+
+# NOTE: The existing 'number' test matches booleans and floats
+def test_integer(value):
+    """Return true if the object is an integer.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, integer_types) and value is not True and value is not False
+
+
+# NOTE: The existing 'number' test matches booleans and integers
+def test_float(value):
+    """Return true if the object is a float.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, float)
+
+
+def test_lower(value):
+    """Return true if the variable is lowercased."""
+    return text_type(value).islower()
+
+
+def test_upper(value):
+    """Return true if the variable is uppercased."""
+    return text_type(value).isupper()
+
+
+def test_string(value):
+    """Return true if the object is a string."""
+    return isinstance(value, string_types)
+
+
+def test_mapping(value):
+    """Return true if the object is a mapping (dict etc.).
+
+    .. versionadded:: 2.6
+    """
+    return isinstance(value, abc.Mapping)
+
+
+def test_number(value):
+    """Return true if the variable is a number."""
+    return isinstance(value, integer_types + (float, complex, decimal.Decimal))
+
+
+def test_sequence(value):
+    """Return true if the variable is a sequence. Sequences are variables
+    that are iterable.
+    """
+    try:
+        len(value)
+        value.__getitem__
+    except Exception:
+        return False
+    return True
+
+
+def test_sameas(value, other):
+    """Check if an object points to the same memory address than another
+    object:
+
+    .. sourcecode:: jinja
+
+        {% if foo.attribute is sameas false %}
+            the foo attribute really is the `False` singleton
+        {% endif %}
+    """
+    return value is other
+
+
+def test_iterable(value):
+    """Check if it's possible to iterate over an object."""
+    try:
+        iter(value)
+    except TypeError:
+        return False
+    return True
+
+
+def test_escaped(value):
+    """Check if the value is escaped."""
+    return hasattr(value, "__html__")
+
+
+def test_in(value, seq):
+    """Check if value is in seq.
+
+    .. versionadded:: 2.10
+    """
+    return value in seq
+
+
+TESTS = {
+    "odd": test_odd,
+    "even": test_even,
+    "divisibleby": test_divisibleby,
+    "defined": test_defined,
+    "undefined": test_undefined,
+    "none": test_none,
+    "boolean": test_boolean,
+    "false": test_false,
+    "true": test_true,
+    "integer": test_integer,
+    "float": test_float,
+    "lower": test_lower,
+    "upper": test_upper,
+    "string": test_string,
+    "mapping": test_mapping,
+    "number": test_number,
+    "sequence": test_sequence,
+    "iterable": test_iterable,
+    "callable": test_callable,
+    "sameas": test_sameas,
+    "escaped": test_escaped,
+    "in": test_in,
+    "==": operator.eq,
+    "eq": operator.eq,
+    "equalto": operator.eq,
+    "!=": operator.ne,
+    "ne": operator.ne,
+    ">": operator.gt,
+    "gt": operator.gt,
+    "greaterthan": operator.gt,
+    "ge": operator.ge,
+    ">=": operator.ge,
+    "<": operator.lt,
+    "lt": operator.lt,
+    "lessthan": operator.lt,
+    "<=": operator.le,
+    "le": operator.le,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b422ba9686fa5f3224564c7af4db7f4ce7ca3368
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/utils.py
@@ -0,0 +1,732 @@
+# -*- coding: utf-8 -*-
+import json
+import os
+import re
+import warnings
+from collections import deque
+from random import choice
+from random import randrange
+from threading import Lock
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import url_quote
+
+_word_split_re = re.compile(r"(\s+)")
+_punctuation_re = re.compile(
+    "^(?P<lead>(?:%s)*)(?P<middle>.*?)(?P<trail>(?:%s)*)$"
+    % (
+        "|".join(map(re.escape, ("(", "<", "&lt;"))),
+        "|".join(map(re.escape, (".", ",", ")", ">", "\n", "&gt;"))),
+    )
+)
+_simple_email_re = re.compile(r"^\S+@[a-zA-Z0-9._-]+\.[a-zA-Z0-9._-]+$")
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^;]+);")
+_letters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
+_digits = "0123456789"
+
+# special singleton representing missing values for the runtime
+missing = type("MissingType", (), {"__repr__": lambda x: "missing"})()
+
+# internal code
+internal_code = set()
+
+concat = u"".join
+
+_slash_escape = "\\/" not in json.dumps("/")
+
+
+def contextfunction(f):
+    """This decorator can be used to mark a function or method context callable.
+    A context callable is passed the active :class:`Context` as first argument when
+    called from the template.  This is useful if a function wants to get access
+    to the context or functions provided on the context object.  For example
+    a function that returns a sorted list of template variables the current
+    template exports could look like this::
+
+        @contextfunction
+        def get_exported_names(context):
+            return sorted(context.exported_vars)
+    """
+    f.contextfunction = True
+    return f
+
+
+def evalcontextfunction(f):
+    """This decorator can be used to mark a function or method as an eval
+    context callable.  This is similar to the :func:`contextfunction`
+    but instead of passing the context, an evaluation context object is
+    passed.  For more information about the eval context, see
+    :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfunction = True
+    return f
+
+
+def environmentfunction(f):
+    """This decorator can be used to mark a function or method as environment
+    callable.  This decorator works exactly like the :func:`contextfunction`
+    decorator just that the first argument is the active :class:`Environment`
+    and not context.
+    """
+    f.environmentfunction = True
+    return f
+
+
+def internalcode(f):
+    """Marks the function as internally used"""
+    internal_code.add(f.__code__)
+    return f
+
+
+def is_undefined(obj):
+    """Check if the object passed is undefined.  This does nothing more than
+    performing an instance check against :class:`Undefined` but looks nicer.
+    This can be used for custom filters or tests that want to react to
+    undefined variables.  For example a custom default filter can look like
+    this::
+
+        def default(var, default=''):
+            if is_undefined(var):
+                return default
+            return var
+    """
+    from .runtime import Undefined
+
+    return isinstance(obj, Undefined)
+
+
+def consume(iterable):
+    """Consumes an iterable without doing anything with it."""
+    for _ in iterable:
+        pass
+
+
+def clear_caches():
+    """Jinja keeps internal caches for environments and lexers.  These are
+    used so that Jinja doesn't have to recreate environments and lexers all
+    the time.  Normally you don't have to care about that but if you are
+    measuring memory consumption you may want to clean the caches.
+    """
+    from .environment import _spontaneous_environments
+    from .lexer import _lexer_cache
+
+    _spontaneous_environments.clear()
+    _lexer_cache.clear()
+
+
+def import_string(import_name, silent=False):
+    """Imports an object based on a string.  This is useful if you want to
+    use import paths as endpoints or something similar.  An import path can
+    be specified either in dotted notation (``xml.sax.saxutils.escape``)
+    or with a colon as object delimiter (``xml.sax.saxutils:escape``).
+
+    If the `silent` is True the return value will be `None` if the import
+    fails.
+
+    :return: imported object
+    """
+    try:
+        if ":" in import_name:
+            module, obj = import_name.split(":", 1)
+        elif "." in import_name:
+            module, _, obj = import_name.rpartition(".")
+        else:
+            return __import__(import_name)
+        return getattr(__import__(module, None, None, [obj]), obj)
+    except (ImportError, AttributeError):
+        if not silent:
+            raise
+
+
+def open_if_exists(filename, mode="rb"):
+    """Returns a file descriptor for the filename if that file exists,
+    otherwise ``None``.
+    """
+    if not os.path.isfile(filename):
+        return None
+
+    return open(filename, mode)
+
+
+def object_type_repr(obj):
+    """Returns the name of the object's type.  For some recognized
+    singletons the name of the object is returned instead. (For
+    example for `None` and `Ellipsis`).
+    """
+    if obj is None:
+        return "None"
+    elif obj is Ellipsis:
+        return "Ellipsis"
+
+    cls = type(obj)
+
+    # __builtin__ in 2.x, builtins in 3.x
+    if cls.__module__ in ("__builtin__", "builtins"):
+        name = cls.__name__
+    else:
+        name = cls.__module__ + "." + cls.__name__
+
+    return "%s object" % name
+
+
+def pformat(obj, verbose=False):
+    """Prettyprint an object.  Either use the `pretty` library or the
+    builtin `pprint`.
+    """
+    try:
+        from pretty import pretty
+
+        return pretty(obj, verbose=verbose)
+    except ImportError:
+        from pprint import pformat
+
+        return pformat(obj)
+
+
+def urlize(text, trim_url_limit=None, rel=None, target=None):
+    """Converts any URLs in text into clickable links. Works on http://,
+    https:// and www. links. Links can have trailing punctuation (periods,
+    commas, close-parens) and leading punctuation (opening parens) and
+    it'll still do the right thing.
+
+    If trim_url_limit is not None, the URLs in link text will be limited
+    to trim_url_limit characters.
+
+    If nofollow is True, the URLs in link text will get a rel="nofollow"
+    attribute.
+
+    If target is not None, a target attribute will be added to the link.
+    """
+    trim_url = (
+        lambda x, limit=trim_url_limit: limit is not None
+        and (x[:limit] + (len(x) >= limit and "..." or ""))
+        or x
+    )
+    words = _word_split_re.split(text_type(escape(text)))
+    rel_attr = rel and ' rel="%s"' % text_type(escape(rel)) or ""
+    target_attr = target and ' target="%s"' % escape(target) or ""
+
+    for i, word in enumerate(words):
+        match = _punctuation_re.match(word)
+        if match:
+            lead, middle, trail = match.groups()
+            if middle.startswith("www.") or (
+                "@" not in middle
+                and not middle.startswith("http://")
+                and not middle.startswith("https://")
+                and len(middle) > 0
+                and middle[0] in _letters + _digits
+                and (
+                    middle.endswith(".org")
+                    or middle.endswith(".net")
+                    or middle.endswith(".com")
+                )
+            ):
+                middle = '<a href="http://%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if middle.startswith("http://") or middle.startswith("https://"):
+                middle = '<a href="%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if (
+                "@" in middle
+                and not middle.startswith("www.")
+                and ":" not in middle
+                and _simple_email_re.match(middle)
+            ):
+                middle = '<a href="mailto:%s">%s</a>' % (middle, middle)
+            if lead + middle + trail != word:
+                words[i] = lead + middle + trail
+    return u"".join(words)
+
+
+def generate_lorem_ipsum(n=5, html=True, min=20, max=100):
+    """Generate some lorem ipsum for the template."""
+    from .constants import LOREM_IPSUM_WORDS
+
+    words = LOREM_IPSUM_WORDS.split()
+    result = []
+
+    for _ in range(n):
+        next_capitalized = True
+        last_comma = last_fullstop = 0
+        word = None
+        last = None
+        p = []
+
+        # each paragraph contains out of 20 to 100 words.
+        for idx, _ in enumerate(range(randrange(min, max))):
+            while True:
+                word = choice(words)
+                if word != last:
+                    last = word
+                    break
+            if next_capitalized:
+                word = word.capitalize()
+                next_capitalized = False
+            # add commas
+            if idx - randrange(3, 8) > last_comma:
+                last_comma = idx
+                last_fullstop += 2
+                word += ","
+            # add end of sentences
+            if idx - randrange(10, 20) > last_fullstop:
+                last_comma = last_fullstop = idx
+                word += "."
+                next_capitalized = True
+            p.append(word)
+
+        # ensure that the paragraph ends with a dot.
+        p = u" ".join(p)
+        if p.endswith(","):
+            p = p[:-1] + "."
+        elif not p.endswith("."):
+            p += "."
+        result.append(p)
+
+    if not html:
+        return u"\n\n".join(result)
+    return Markup(u"\n".join(u"<p>%s</p>" % escape(x) for x in result))
+
+
+def unicode_urlencode(obj, charset="utf-8", for_qs=False):
+    """Quote a string for use in a URL using the given charset.
+
+    This function is misnamed, it is a wrapper around
+    :func:`urllib.parse.quote`.
+
+    :param obj: String or bytes to quote. Other types are converted to
+        string then encoded to bytes using the given charset.
+    :param charset: Encode text to bytes using this charset.
+    :param for_qs: Quote "/" and use "+" for spaces.
+    """
+    if not isinstance(obj, string_types):
+        obj = text_type(obj)
+
+    if isinstance(obj, text_type):
+        obj = obj.encode(charset)
+
+    safe = b"" if for_qs else b"/"
+    rv = url_quote(obj, safe)
+
+    if not isinstance(rv, text_type):
+        rv = rv.decode("utf-8")
+
+    if for_qs:
+        rv = rv.replace("%20", "+")
+
+    return rv
+
+
+class LRUCache(object):
+    """A simple LRU Cache implementation."""
+
+    # this is fast for small capacities (something below 1000) but doesn't
+    # scale.  But as long as it's only used as storage for templates this
+    # won't do any harm.
+
+    def __init__(self, capacity):
+        self.capacity = capacity
+        self._mapping = {}
+        self._queue = deque()
+        self._postinit()
+
+    def _postinit(self):
+        # alias all queue methods for faster lookup
+        self._popleft = self._queue.popleft
+        self._pop = self._queue.pop
+        self._remove = self._queue.remove
+        self._wlock = Lock()
+        self._append = self._queue.append
+
+    def __getstate__(self):
+        return {
+            "capacity": self.capacity,
+            "_mapping": self._mapping,
+            "_queue": self._queue,
+        }
+
+    def __setstate__(self, d):
+        self.__dict__.update(d)
+        self._postinit()
+
+    def __getnewargs__(self):
+        return (self.capacity,)
+
+    def copy(self):
+        """Return a shallow copy of the instance."""
+        rv = self.__class__(self.capacity)
+        rv._mapping.update(self._mapping)
+        rv._queue.extend(self._queue)
+        return rv
+
+    def get(self, key, default=None):
+        """Return an item from the cache dict or `default`"""
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def setdefault(self, key, default=None):
+        """Set `default` if the key is not in the cache otherwise
+        leave unchanged. Return the value of this key.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            self[key] = default
+            return default
+
+    def clear(self):
+        """Clear the cache."""
+        self._wlock.acquire()
+        try:
+            self._mapping.clear()
+            self._queue.clear()
+        finally:
+            self._wlock.release()
+
+    def __contains__(self, key):
+        """Check if a key exists in this cache."""
+        return key in self._mapping
+
+    def __len__(self):
+        """Return the current size of the cache."""
+        return len(self._mapping)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self._mapping)
+
+    def __getitem__(self, key):
+        """Get an item from the cache. Moves the item up so that it has the
+        highest priority then.
+
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            rv = self._mapping[key]
+            if self._queue[-1] != key:
+                try:
+                    self._remove(key)
+                except ValueError:
+                    # if something removed the key from the container
+                    # when we read, ignore the ValueError that we would
+                    # get otherwise.
+                    pass
+                self._append(key)
+            return rv
+        finally:
+            self._wlock.release()
+
+    def __setitem__(self, key, value):
+        """Sets the value for an item. Moves the item up so that it
+        has the highest priority then.
+        """
+        self._wlock.acquire()
+        try:
+            if key in self._mapping:
+                self._remove(key)
+            elif len(self._mapping) == self.capacity:
+                del self._mapping[self._popleft()]
+            self._append(key)
+            self._mapping[key] = value
+        finally:
+            self._wlock.release()
+
+    def __delitem__(self, key):
+        """Remove an item from the cache dict.
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            del self._mapping[key]
+            try:
+                self._remove(key)
+            except ValueError:
+                pass
+        finally:
+            self._wlock.release()
+
+    def items(self):
+        """Return a list of items."""
+        result = [(key, self._mapping[key]) for key in list(self._queue)]
+        result.reverse()
+        return result
+
+    def iteritems(self):
+        """Iterate over all items."""
+        warnings.warn(
+            "'iteritems()' will be removed in version 3.0. Use"
+            " 'iter(cache.items())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.items())
+
+    def values(self):
+        """Return a list of all values."""
+        return [x[1] for x in self.items()]
+
+    def itervalue(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalue()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def itervalues(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalues()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def keys(self):
+        """Return a list of all keys ordered by most recent usage."""
+        return list(self)
+
+    def iterkeys(self):
+        """Iterate over all keys in the cache dict, ordered by
+        the most recent usage.
+        """
+        warnings.warn(
+            "'iterkeys()' will be removed in version 3.0. Use"
+            " 'iter(cache.keys())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self)
+
+    def __iter__(self):
+        return reversed(tuple(self._queue))
+
+    def __reversed__(self):
+        """Iterate over the keys in the cache dict, oldest items
+        coming first.
+        """
+        return iter(tuple(self._queue))
+
+    __copy__ = copy
+
+
+abc.MutableMapping.register(LRUCache)
+
+
+def select_autoescape(
+    enabled_extensions=("html", "htm", "xml"),
+    disabled_extensions=(),
+    default_for_string=True,
+    default=False,
+):
+    """Intelligently sets the initial value of autoescaping based on the
+    filename of the template.  This is the recommended way to configure
+    autoescaping if you do not want to write a custom function yourself.
+
+    If you want to enable it for all templates created from strings or
+    for all templates with `.html` and `.xml` extensions::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            enabled_extensions=('html', 'xml'),
+            default_for_string=True,
+        ))
+
+    Example configuration to turn it on at all times except if the template
+    ends with `.txt`::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            disabled_extensions=('txt',),
+            default_for_string=True,
+            default=True,
+        ))
+
+    The `enabled_extensions` is an iterable of all the extensions that
+    autoescaping should be enabled for.  Likewise `disabled_extensions` is
+    a list of all templates it should be disabled for.  If a template is
+    loaded from a string then the default from `default_for_string` is used.
+    If nothing matches then the initial value of autoescaping is set to the
+    value of `default`.
+
+    For security reasons this function operates case insensitive.
+
+    .. versionadded:: 2.9
+    """
+    enabled_patterns = tuple("." + x.lstrip(".").lower() for x in enabled_extensions)
+    disabled_patterns = tuple("." + x.lstrip(".").lower() for x in disabled_extensions)
+
+    def autoescape(template_name):
+        if template_name is None:
+            return default_for_string
+        template_name = template_name.lower()
+        if template_name.endswith(enabled_patterns):
+            return True
+        if template_name.endswith(disabled_patterns):
+            return False
+        return default
+
+    return autoescape
+
+
+def htmlsafe_json_dumps(obj, dumper=None, **kwargs):
+    """Works exactly like :func:`dumps` but is safe for use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+    """
+    if dumper is None:
+        dumper = json.dumps
+    rv = (
+        dumper(obj, **kwargs)
+        .replace(u"<", u"\\u003c")
+        .replace(u">", u"\\u003e")
+        .replace(u"&", u"\\u0026")
+        .replace(u"'", u"\\u0027")
+    )
+    return Markup(rv)
+
+
+class Cycler(object):
+    """Cycle through values by yield them one at a time, then restarting
+    once the end is reached. Available as ``cycler`` in templates.
+
+    Similar to ``loop.cycle``, but can be used outside loops or across
+    multiple loops. For example, render a list of folders and files in a
+    list, alternating giving them "odd" and "even" classes.
+
+    .. code-block:: html+jinja
+
+        {% set row_class = cycler("odd", "even") %}
+        <ul class="browser">
+        {% for folder in folders %}
+          <li class="folder {{ row_class.next() }}">{{ folder }}
+        {% endfor %}
+        {% for file in files %}
+          <li class="file {{ row_class.next() }}">{{ file }}
+        {% endfor %}
+        </ul>
+
+    :param items: Each positional argument will be yielded in the order
+        given for each cycle.
+
+    .. versionadded:: 2.1
+    """
+
+    def __init__(self, *items):
+        if not items:
+            raise RuntimeError("at least one item has to be provided")
+        self.items = items
+        self.pos = 0
+
+    def reset(self):
+        """Resets the current item to the first item."""
+        self.pos = 0
+
+    @property
+    def current(self):
+        """Return the current item. Equivalent to the item that will be
+        returned next time :meth:`next` is called.
+        """
+        return self.items[self.pos]
+
+    def next(self):
+        """Return the current item, then advance :attr:`current` to the
+        next item.
+        """
+        rv = self.current
+        self.pos = (self.pos + 1) % len(self.items)
+        return rv
+
+    __next__ = next
+
+
+class Joiner(object):
+    """A joining helper for templates."""
+
+    def __init__(self, sep=u", "):
+        self.sep = sep
+        self.used = False
+
+    def __call__(self):
+        if not self.used:
+            self.used = True
+            return u""
+        return self.sep
+
+
+class Namespace(object):
+    """A namespace object that can hold arbitrary attributes.  It may be
+    initialized from a dictionary or with keyword arguments."""
+
+    def __init__(*args, **kwargs):  # noqa: B902
+        self, args = args[0], args[1:]
+        self.__attrs = dict(*args, **kwargs)
+
+    def __getattribute__(self, name):
+        # __class__ is needed for the awaitable check in async mode
+        if name in {"_Namespace__attrs", "__class__"}:
+            return object.__getattribute__(self, name)
+        try:
+            return self.__attrs[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setitem__(self, name, value):
+        self.__attrs[name] = value
+
+    def __repr__(self):
+        return "<Namespace %r>" % self.__attrs
+
+
+# does this python version support async for in and async generators?
+try:
+    exec("async def _():\n async for _ in ():\n  yield _")
+    have_async_gen = True
+except SyntaxError:
+    have_async_gen = False
+
+
+def soft_unicode(s):
+    from markupsafe import soft_unicode
+
+    warnings.warn(
+        "'jinja2.utils.soft_unicode' will be removed in version 3.0."
+        " Use 'markupsafe.soft_unicode' instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return soft_unicode(s)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/visitor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/visitor.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1365bf10e5346a60df625faa5e118d4086b1395
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jinja2/visitor.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""API for traversing the AST nodes. Implemented by the compiler and
+meta introspection.
+"""
+from .nodes import Node
+
+
+class NodeVisitor(object):
+    """Walks the abstract syntax tree and call visitor functions for every
+    node found.  The visitor functions may return values which will be
+    forwarded by the `visit` method.
+
+    Per default the visitor functions for the nodes are ``'visit_'`` +
+    class name of the node.  So a `TryFinally` node visit function would
+    be `visit_TryFinally`.  This behavior can be changed by overriding
+    the `get_visitor` function.  If no visitor function exists for a node
+    (return value `None`) the `generic_visit` visitor is used instead.
+    """
+
+    def get_visitor(self, node):
+        """Return the visitor function for this node or `None` if no visitor
+        exists for this node.  In that case the generic visit function is
+        used instead.
+        """
+        method = "visit_" + node.__class__.__name__
+        return getattr(self, method, None)
+
+    def visit(self, node, *args, **kwargs):
+        """Visit a node."""
+        f = self.get_visitor(node)
+        if f is not None:
+            return f(node, *args, **kwargs)
+        return self.generic_visit(node, *args, **kwargs)
+
+    def generic_visit(self, node, *args, **kwargs):
+        """Called if no explicit visitor function exists for a node."""
+        for node in node.iter_child_nodes():
+            self.visit(node, *args, **kwargs)
+
+
+class NodeTransformer(NodeVisitor):
+    """Walks the abstract syntax tree and allows modifications of nodes.
+
+    The `NodeTransformer` will walk the AST and use the return value of the
+    visitor functions to replace or remove the old node.  If the return
+    value of the visitor function is `None` the node will be removed
+    from the previous location otherwise it's replaced with the return
+    value.  The return value may be the original node in which case no
+    replacement takes place.
+    """
+
+    def generic_visit(self, node, *args, **kwargs):
+        for field, old_value in node.iter_fields():
+            if isinstance(old_value, list):
+                new_values = []
+                for value in old_value:
+                    if isinstance(value, Node):
+                        value = self.visit(value, *args, **kwargs)
+                        if value is None:
+                            continue
+                        elif not isinstance(value, Node):
+                            new_values.extend(value)
+                            continue
+                    new_values.append(value)
+                old_value[:] = new_values
+            elif isinstance(old_value, Node):
+                new_node = self.visit(old_value, *args, **kwargs)
+                if new_node is None:
+                    delattr(node, field)
+                else:
+                    setattr(node, field, new_node)
+        return node
+
+    def visit_list(self, node, *args, **kwargs):
+        """As transformers may return lists in some places this method
+        can be used to enforce a list as return value.
+        """
+        rv = self.visit(node, *args, **kwargs)
+        if not isinstance(rv, list):
+            rv = [rv]
+        return rv
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/COPYING b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/COPYING
new file mode 100644
index 0000000000000000000000000000000000000000..af9cfbdb134f42e5205ecbad597421d778826481
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/COPYING
@@ -0,0 +1,19 @@
+Copyright (c) 2013 Julian Berman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..aef9b18d58623e8122fdf9061db5f56e2cdd4189
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/METADATA
@@ -0,0 +1,224 @@
+Metadata-Version: 2.1
+Name: jsonschema
+Version: 3.2.0
+Summary: An implementation of JSON Schema validation for Python
+Home-page: https://github.com/Julian/jsonschema
+Author: Julian Berman
+Author-email: Julian@GrayVines.com
+License: UNKNOWN
+Project-URL: Docs, https://python-jsonschema.readthedocs.io/en/latest/
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Dist: attrs (>=17.4.0)
+Requires-Dist: pyrsistent (>=0.14.0)
+Requires-Dist: setuptools
+Requires-Dist: six (>=1.11.0)
+Requires-Dist: functools32 ; python_version < "3"
+Requires-Dist: importlib-metadata ; python_version < "3.8"
+Provides-Extra: format
+Requires-Dist: idna ; extra == 'format'
+Requires-Dist: jsonpointer (>1.13) ; extra == 'format'
+Requires-Dist: rfc3987 ; extra == 'format'
+Requires-Dist: strict-rfc3339 ; extra == 'format'
+Requires-Dist: webcolors ; extra == 'format'
+Provides-Extra: format_nongpl
+Requires-Dist: idna ; extra == 'format_nongpl'
+Requires-Dist: jsonpointer (>1.13) ; extra == 'format_nongpl'
+Requires-Dist: webcolors ; extra == 'format_nongpl'
+Requires-Dist: rfc3986-validator (>0.1.0) ; extra == 'format_nongpl'
+Requires-Dist: rfc3339-validator ; extra == 'format_nongpl'
+
+==========
+jsonschema
+==========
+
+|PyPI| |Pythons| |Travis| |AppVeyor| |Codecov| |ReadTheDocs|
+
+.. |PyPI| image:: https://img.shields.io/pypi/v/jsonschema.svg
+   :alt: PyPI version
+   :target: https://pypi.org/project/jsonschema/
+
+.. |Pythons| image:: https://img.shields.io/pypi/pyversions/jsonschema.svg
+   :alt: Supported Python versions
+   :target: https://pypi.org/project/jsonschema/
+
+.. |Travis| image:: https://travis-ci.com/Julian/jsonschema.svg?branch=master
+   :alt: Travis build status
+   :target: https://travis-ci.com/Julian/jsonschema
+
+.. |AppVeyor| image:: https://ci.appveyor.com/api/projects/status/adtt0aiaihy6muyn/branch/master?svg=true
+   :alt: AppVeyor build status
+   :target: https://ci.appveyor.com/project/Julian/jsonschema
+
+.. |Codecov| image:: https://codecov.io/gh/Julian/jsonschema/branch/master/graph/badge.svg
+   :alt: Codecov Code coverage
+   :target: https://codecov.io/gh/Julian/jsonschema
+
+.. |ReadTheDocs| image:: https://readthedocs.org/projects/python-jsonschema/badge/?version=stable&style=flat
+   :alt: ReadTheDocs status
+   :target: https://python-jsonschema.readthedocs.io/en/stable/
+
+
+``jsonschema`` is an implementation of `JSON Schema <https://json-schema.org>`_
+for Python (supporting 2.7+ including Python 3).
+
+.. code-block:: python
+
+    >>> from jsonschema import validate
+
+    >>> # A sample schema, like what we'd get from json.load()
+    >>> schema = {
+    ...     "type" : "object",
+    ...     "properties" : {
+    ...         "price" : {"type" : "number"},
+    ...         "name" : {"type" : "string"},
+    ...     },
+    ... }
+
+    >>> # If no exception is raised by validate(), the instance is valid.
+    >>> validate(instance={"name" : "Eggs", "price" : 34.99}, schema=schema)
+
+    >>> validate(
+    ...     instance={"name" : "Eggs", "price" : "Invalid"}, schema=schema,
+    ... )                                   # doctest: +IGNORE_EXCEPTION_DETAIL
+    Traceback (most recent call last):
+        ...
+    ValidationError: 'Invalid' is not of type 'number'
+
+It can also be used from console:
+
+.. code-block:: bash
+
+    $ jsonschema -i sample.json sample.schema
+
+Features
+--------
+
+* Full support for
+  `Draft 7 <https://python-jsonschema.readthedocs.io/en/latest/validate/#jsonschema.Draft7Validator>`_,
+  `Draft 6 <https://python-jsonschema.readthedocs.io/en/latest/validate/#jsonschema.Draft6Validator>`_,
+  `Draft 4 <https://python-jsonschema.readthedocs.io/en/latest/validate/#jsonschema.Draft4Validator>`_
+  and
+  `Draft 3 <https://python-jsonschema.readthedocs.io/en/latest/validate/#jsonschema.Draft3Validator>`_
+
+* `Lazy validation <https://python-jsonschema.readthedocs.io/en/latest/validate/#jsonschema.IValidator.iter_errors>`_
+  that can iteratively report *all* validation errors.
+
+* `Programmatic querying <https://python-jsonschema.readthedocs.io/en/latest/errors/>`_
+  of which properties or items failed validation.
+
+
+Installation
+------------
+
+``jsonschema`` is available on `PyPI <https://pypi.org/project/jsonschema/>`_. You can install using `pip <https://pip.pypa.io/en/stable/>`_:
+
+.. code-block:: bash
+
+    $ pip install jsonschema
+
+
+Demo
+----
+
+Try ``jsonschema`` interactively in this online demo:
+
+.. image:: https://user-images.githubusercontent.com/1155573/56745335-8b158a00-6750-11e9-8776-83fa675939c4.png
+    :target: https://notebooks.ai/demo/gh/Julian/jsonschema
+    :alt: Open Live Demo
+
+
+Online demo Notebook will look similar to this:
+
+
+.. image:: https://user-images.githubusercontent.com/1155573/56820861-5c1c1880-6823-11e9-802a-ce01c5ec574f.gif
+    :alt: Open Live Demo
+    :width: 480 px
+
+
+Release Notes
+-------------
+
+v3.1 brings support for ECMA 262 dialect regular expressions
+throughout schemas, as recommended by the specification. Big
+thanks to @Zac-HD for authoring support in a new `js-regex
+<https://pypi.org/project/js-regex/>`_ library.
+
+
+Running the Test Suite
+----------------------
+
+If you have ``tox`` installed (perhaps via ``pip install tox`` or your
+package manager), running ``tox`` in the directory of your source
+checkout will run ``jsonschema``'s test suite on all of the versions
+of Python ``jsonschema`` supports. If you don't have all of the
+versions that ``jsonschema`` is tested under, you'll likely want to run
+using ``tox``'s ``--skip-missing-interpreters`` option.
+
+Of course you're also free to just run the tests on a single version with your
+favorite test runner. The tests live in the ``jsonschema.tests`` package.
+
+
+Benchmarks
+----------
+
+``jsonschema``'s benchmarks make use of `pyperf
+<https://pyperf.readthedocs.io>`_.
+
+Running them can be done via ``tox -e perf``, or by invoking the ``pyperf``
+commands externally (after ensuring that both it and ``jsonschema`` itself are
+installed)::
+
+    $ python -m pyperf jsonschema/benchmarks/test_suite.py --hist --output results.json
+
+To compare to a previous run, use::
+
+    $ python -m pyperf compare_to --table reference.json results.json
+
+See the ``pyperf`` documentation for more details.
+
+
+Community
+---------
+
+There's a `mailing list <https://groups.google.com/forum/#!forum/jsonschema>`_
+for this implementation on Google Groups.
+
+Please join, and feel free to send questions there.
+
+
+Contributing
+------------
+
+I'm Julian Berman.
+
+``jsonschema`` is on `GitHub <https://github.com/Julian/jsonschema>`_.
+
+Get in touch, via GitHub or otherwise, if you've got something to contribute,
+it'd be most welcome!
+
+You can also generally find me on Freenode (nick: ``tos9``) in various
+channels, including ``#python``.
+
+If you feel overwhelmingly grateful, you can also woo me with beer money
+via Google Pay with the email in my GitHub profile.
+
+And for companies who appreciate ``jsonschema`` and its continued support
+and growth, ``jsonschema`` is also now supportable via `TideLift
+<https://tidelift.com/subscription/pkg/pypi-jsonschema?utm_source=pypi-j
+sonschema&utm_medium=referral&utm_campaign=readme>`_.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..caadceadb8161fd96bb7f1bc75f9fb2041aa253e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/RECORD
@@ -0,0 +1,60 @@
+../../../bin/jsonschema,sha256=4vsGAZe3D5TQYLjQNB2i8hDYoJ05TwlOIEQEGCxX1wM,292
+jsonschema-3.2.0.dist-info/COPYING,sha256=T5KgFaE8TRoEC-8BiqE0MLTxvHO0Gxa7hGw0Z2bedDk,1057
+jsonschema-3.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+jsonschema-3.2.0.dist-info/METADATA,sha256=os_TL7tiSfPYDMKYoAqoNsw_yMkDJmCL2bqhp-csNR0,7760
+jsonschema-3.2.0.dist-info/RECORD,,
+jsonschema-3.2.0.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110
+jsonschema-3.2.0.dist-info/entry_points.txt,sha256=KaVUBBSLyzi5naUkVg-r3q6T_igdLgaHY6Mm3oLX73s,52
+jsonschema-3.2.0.dist-info/top_level.txt,sha256=jGoNS61vDONU8U7p0Taf-y_8JVG1Z2CJ5Eif6zMN_cw,11
+jsonschema/__init__.py,sha256=dHAr_pQLbbDFoRnbVMrQVztVUvnBFgFlm7bU82pMvOk,934
+jsonschema/__main__.py,sha256=in4bbzfixCAyGe3RhBwhQVZnGkruszNedcbmwxGyJgc,39
+jsonschema/__pycache__/__init__.cpython-38.pyc,,
+jsonschema/__pycache__/__main__.cpython-38.pyc,,
+jsonschema/__pycache__/_format.cpython-38.pyc,,
+jsonschema/__pycache__/_legacy_validators.cpython-38.pyc,,
+jsonschema/__pycache__/_reflect.cpython-38.pyc,,
+jsonschema/__pycache__/_types.cpython-38.pyc,,
+jsonschema/__pycache__/_utils.cpython-38.pyc,,
+jsonschema/__pycache__/_validators.cpython-38.pyc,,
+jsonschema/__pycache__/cli.cpython-38.pyc,,
+jsonschema/__pycache__/compat.cpython-38.pyc,,
+jsonschema/__pycache__/exceptions.cpython-38.pyc,,
+jsonschema/__pycache__/validators.cpython-38.pyc,,
+jsonschema/_format.py,sha256=vwD1v7S8BmJvSF5y0o6dbPgjAyzt07PZpyO3pvNVVgQ,11691
+jsonschema/_legacy_validators.py,sha256=kYcYiHfRV-aQtIQv2qe_71L3QFs3LiJ3v69ifteAN4E,4584
+jsonschema/_reflect.py,sha256=gggQrcrf5FRoyhgdE6ggJ4n2FQHEzWS4CS-cm9bYcqI,5023
+jsonschema/_types.py,sha256=t2naRRhuTKIUIB0GMR9kOp2la2aVqeT2tFlVAobndmg,4490
+jsonschema/_utils.py,sha256=ezZJMQ0eU4oPvkTmZi6g5vsCtIFRhb8vN4Y9S4uQwW8,5168
+jsonschema/_validators.py,sha256=UDYawpxK8f_rIeEBXZtwr0tlxi3OH1Zt2ca0zAxjNdk,11703
+jsonschema/benchmarks/__init__.py,sha256=A0sQrxDBVHSyQ-8ru3L11hMXf3q9gVuB9x_YgHb4R9M,70
+jsonschema/benchmarks/__pycache__/__init__.cpython-38.pyc,,
+jsonschema/benchmarks/__pycache__/issue232.cpython-38.pyc,,
+jsonschema/benchmarks/__pycache__/json_schema_test_suite.cpython-38.pyc,,
+jsonschema/benchmarks/issue232.py,sha256=-azAUmrP75f0uj0x2zEdBc3-DhQw3XX9UQVDCyhBKRk,541
+jsonschema/benchmarks/json_schema_test_suite.py,sha256=okRE6ACue2C0Hd1dMhnpZ0bc3AoZdDd8cw2lwTnbzwU,343
+jsonschema/cli.py,sha256=3Vc8ptc2GD7zDxK2F-kamqmrE9f35a2KVDGR1p1acUU,2310
+jsonschema/compat.py,sha256=37gSA8MmAR65zlqzsSEB-0ObZk_I2TF7z1kp9zmkskg,1353
+jsonschema/exceptions.py,sha256=ukWIE7aEES8Kh0UaUP9turpUkV2ZzXEN8CwfRObzlMA,10450
+jsonschema/schemas/draft3.json,sha256=PdtCu2s06Va3hV9cX5A5-rvye50SVF__NrvxG0vuzz0,4564
+jsonschema/schemas/draft4.json,sha256=ODL-0W3kv7MmqL3tm3GJguuVxN1QNO1GtBcpWE3ok98,5399
+jsonschema/schemas/draft6.json,sha256=wp386fVINcOgbAOzxdXsDtp3cGVo-cTffPvHVmpRAG0,4437
+jsonschema/schemas/draft7.json,sha256=PVOSCIJhYGxVm2A_OFMpyfGrRbXWZ-uZBodFOwVdQF4,4819
+jsonschema/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jsonschema/tests/__pycache__/__init__.cpython-38.pyc,,
+jsonschema/tests/__pycache__/_helpers.cpython-38.pyc,,
+jsonschema/tests/__pycache__/_suite.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_cli.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_exceptions.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_format.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_jsonschema_test_suite.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_types.cpython-38.pyc,,
+jsonschema/tests/__pycache__/test_validators.cpython-38.pyc,,
+jsonschema/tests/_helpers.py,sha256=3c-b9CK0cdGfhtuUhzM1AjtqPtR2VFvfcKC6G2g0a-0,157
+jsonschema/tests/_suite.py,sha256=6lxDHOyjJfCjdn9vfOLcUpXtNl0vLIljrinSFi1tRhc,6728
+jsonschema/tests/test_cli.py,sha256=djw7ZD6zm5_8FgsAr9XyYk4zErIEoPRs8SzBe5nYcWY,4727
+jsonschema/tests/test_exceptions.py,sha256=zw9bd_al5zOzAm8nJ0IqeymiweH6i8k1AN3CB7t618A,15348
+jsonschema/tests/test_format.py,sha256=ob0QDop_nwRwiLs1P6sGsf6ZITik00CWhe1pL8JRiA0,2982
+jsonschema/tests/test_jsonschema_test_suite.py,sha256=8uiplgvQq5yFvtvWxbyqyr7HMYRCx6jNE3OiU-u8AEk,8464
+jsonschema/tests/test_types.py,sha256=lntWPZ86fwo_aNKbfCueX5R2xdwrYYN7Zo5C0-ppk-0,5902
+jsonschema/tests/test_validators.py,sha256=R_zhsDKG5r66LE1OVlzdcPyKRWKgc07e6NVWxQkrRiQ,60394
+jsonschema/validators.py,sha256=RIZTQyZxhWwsyIIRFQGEjLzq38LlyzzzdYUl9jxzV0M,29400
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..8b701e93c23159bc1f4145f779049ce0a6a6cf77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.33.6)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c627b310cd0369f4824e434fac41d0e5797ed1a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+jsonschema = jsonschema.cli:main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d89304b1a89d0f441beaefdc5ae5de22c95f06a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema-3.2.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+jsonschema
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b630cdfbbee08e6a5398ae199f625bc4b272095
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__init__.py
@@ -0,0 +1,34 @@
+"""
+An implementation of JSON Schema for Python
+
+The main functionality is provided by the validator classes for each of the
+supported JSON Schema versions.
+
+Most commonly, `validate` is the quickest way to simply validate a given
+instance under a schema, and will create a validator for you.
+"""
+
+from jsonschema.exceptions import (
+    ErrorTree, FormatError, RefResolutionError, SchemaError, ValidationError
+)
+from jsonschema._format import (
+    FormatChecker,
+    draft3_format_checker,
+    draft4_format_checker,
+    draft6_format_checker,
+    draft7_format_checker,
+)
+from jsonschema._types import TypeChecker
+from jsonschema.validators import (
+    Draft3Validator,
+    Draft4Validator,
+    Draft6Validator,
+    Draft7Validator,
+    RefResolver,
+    validate,
+)
+try:
+    from importlib import metadata
+except ImportError: # for Python<3.8
+    import importlib_metadata as metadata
+__version__ = metadata.version("jsonschema")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__main__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..82c29fd39e7b68fa8893d69f70b73476750694f1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/__main__.py
@@ -0,0 +1,2 @@
+from jsonschema.cli import main
+main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_format.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..281a7cfcffe9c39758b2146ae13e26f8e52298c3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_format.py
@@ -0,0 +1,425 @@
+import datetime
+import re
+import socket
+import struct
+
+from jsonschema.compat import str_types
+from jsonschema.exceptions import FormatError
+
+
+class FormatChecker(object):
+    """
+    A ``format`` property checker.
+
+    JSON Schema does not mandate that the ``format`` property actually do any
+    validation. If validation is desired however, instances of this class can
+    be hooked into validators to enable format validation.
+
+    `FormatChecker` objects always return ``True`` when asked about
+    formats that they do not know how to validate.
+
+    To check a custom format using a function that takes an instance and
+    returns a ``bool``, use the `FormatChecker.checks` or
+    `FormatChecker.cls_checks` decorators.
+
+    Arguments:
+
+        formats (~collections.Iterable):
+
+            The known formats to validate. This argument can be used to
+            limit which formats will be used during validation.
+    """
+
+    checkers = {}
+
+    def __init__(self, formats=None):
+        if formats is None:
+            self.checkers = self.checkers.copy()
+        else:
+            self.checkers = dict((k, self.checkers[k]) for k in formats)
+
+    def __repr__(self):
+        return "<FormatChecker checkers={}>".format(sorted(self.checkers))
+
+    def checks(self, format, raises=()):
+        """
+        Register a decorated function as validating a new format.
+
+        Arguments:
+
+            format (str):
+
+                The format that the decorated function will check.
+
+            raises (Exception):
+
+                The exception(s) raised by the decorated function when an
+                invalid instance is found.
+
+                The exception object will be accessible as the
+                `jsonschema.exceptions.ValidationError.cause` attribute of the
+                resulting validation error.
+        """
+
+        def _checks(func):
+            self.checkers[format] = (func, raises)
+            return func
+        return _checks
+
+    cls_checks = classmethod(checks)
+
+    def check(self, instance, format):
+        """
+        Check whether the instance conforms to the given format.
+
+        Arguments:
+
+            instance (*any primitive type*, i.e. str, number, bool):
+
+                The instance to check
+
+            format (str):
+
+                The format that instance should conform to
+
+
+        Raises:
+
+            FormatError: if the instance does not conform to ``format``
+        """
+
+        if format not in self.checkers:
+            return
+
+        func, raises = self.checkers[format]
+        result, cause = None, None
+        try:
+            result = func(instance)
+        except raises as e:
+            cause = e
+        if not result:
+            raise FormatError(
+                "%r is not a %r" % (instance, format), cause=cause,
+            )
+
+    def conforms(self, instance, format):
+        """
+        Check whether the instance conforms to the given format.
+
+        Arguments:
+
+            instance (*any primitive type*, i.e. str, number, bool):
+
+                The instance to check
+
+            format (str):
+
+                The format that instance should conform to
+
+        Returns:
+
+            bool: whether it conformed
+        """
+
+        try:
+            self.check(instance, format)
+        except FormatError:
+            return False
+        else:
+            return True
+
+
+draft3_format_checker = FormatChecker()
+draft4_format_checker = FormatChecker()
+draft6_format_checker = FormatChecker()
+draft7_format_checker = FormatChecker()
+
+
+_draft_checkers = dict(
+    draft3=draft3_format_checker,
+    draft4=draft4_format_checker,
+    draft6=draft6_format_checker,
+    draft7=draft7_format_checker,
+)
+
+
+def _checks_drafts(
+    name=None,
+    draft3=None,
+    draft4=None,
+    draft6=None,
+    draft7=None,
+    raises=(),
+):
+    draft3 = draft3 or name
+    draft4 = draft4 or name
+    draft6 = draft6 or name
+    draft7 = draft7 or name
+
+    def wrap(func):
+        if draft3:
+            func = _draft_checkers["draft3"].checks(draft3, raises)(func)
+        if draft4:
+            func = _draft_checkers["draft4"].checks(draft4, raises)(func)
+        if draft6:
+            func = _draft_checkers["draft6"].checks(draft6, raises)(func)
+        if draft7:
+            func = _draft_checkers["draft7"].checks(draft7, raises)(func)
+
+        # Oy. This is bad global state, but relied upon for now, until
+        # deprecation. See https://github.com/Julian/jsonschema/issues/519
+        # and test_format_checkers_come_with_defaults
+        FormatChecker.cls_checks(draft7 or draft6 or draft4 or draft3, raises)(
+            func,
+        )
+        return func
+    return wrap
+
+
+@_checks_drafts(name="idn-email")
+@_checks_drafts(name="email")
+def is_email(instance):
+    if not isinstance(instance, str_types):
+        return True
+    return "@" in instance
+
+
+_ipv4_re = re.compile(r"^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$")
+
+
+@_checks_drafts(
+    draft3="ip-address", draft4="ipv4", draft6="ipv4", draft7="ipv4",
+)
+def is_ipv4(instance):
+    if not isinstance(instance, str_types):
+        return True
+    if not _ipv4_re.match(instance):
+        return False
+    return all(0 <= int(component) <= 255 for component in instance.split("."))
+
+
+if hasattr(socket, "inet_pton"):
+    # FIXME: Really this only should raise struct.error, but see the sadness
+    #        that is https://twistedmatrix.com/trac/ticket/9409
+    @_checks_drafts(
+        name="ipv6", raises=(socket.error, struct.error, ValueError),
+    )
+    def is_ipv6(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return socket.inet_pton(socket.AF_INET6, instance)
+
+
+_host_name_re = re.compile(r"^[A-Za-z0-9][A-Za-z0-9\.\-]{1,255}$")
+
+
+@_checks_drafts(
+    draft3="host-name",
+    draft4="hostname",
+    draft6="hostname",
+    draft7="hostname",
+)
+def is_host_name(instance):
+    if not isinstance(instance, str_types):
+        return True
+    if not _host_name_re.match(instance):
+        return False
+    components = instance.split(".")
+    for component in components:
+        if len(component) > 63:
+            return False
+    return True
+
+
+try:
+    # The built-in `idna` codec only implements RFC 3890, so we go elsewhere.
+    import idna
+except ImportError:
+    pass
+else:
+    @_checks_drafts(draft7="idn-hostname", raises=idna.IDNAError)
+    def is_idn_host_name(instance):
+        if not isinstance(instance, str_types):
+            return True
+        idna.encode(instance)
+        return True
+
+
+try:
+    import rfc3987
+except ImportError:
+    try:
+        from rfc3986_validator import validate_rfc3986
+    except ImportError:
+        pass
+    else:
+        @_checks_drafts(name="uri")
+        def is_uri(instance):
+            if not isinstance(instance, str_types):
+                return True
+            return validate_rfc3986(instance, rule="URI")
+
+        @_checks_drafts(
+            draft6="uri-reference",
+            draft7="uri-reference",
+            raises=ValueError,
+        )
+        def is_uri_reference(instance):
+            if not isinstance(instance, str_types):
+                return True
+            return validate_rfc3986(instance, rule="URI_reference")
+
+else:
+    @_checks_drafts(draft7="iri", raises=ValueError)
+    def is_iri(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return rfc3987.parse(instance, rule="IRI")
+
+    @_checks_drafts(draft7="iri-reference", raises=ValueError)
+    def is_iri_reference(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return rfc3987.parse(instance, rule="IRI_reference")
+
+    @_checks_drafts(name="uri", raises=ValueError)
+    def is_uri(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return rfc3987.parse(instance, rule="URI")
+
+    @_checks_drafts(
+        draft6="uri-reference",
+        draft7="uri-reference",
+        raises=ValueError,
+    )
+    def is_uri_reference(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return rfc3987.parse(instance, rule="URI_reference")
+
+
+try:
+    from strict_rfc3339 import validate_rfc3339
+except ImportError:
+    try:
+        from rfc3339_validator import validate_rfc3339
+    except ImportError:
+        validate_rfc3339 = None
+
+if validate_rfc3339:
+    @_checks_drafts(name="date-time")
+    def is_datetime(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return validate_rfc3339(instance)
+
+    @_checks_drafts(draft7="time")
+    def is_time(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return is_datetime("1970-01-01T" + instance)
+
+
+@_checks_drafts(name="regex", raises=re.error)
+def is_regex(instance):
+    if not isinstance(instance, str_types):
+        return True
+    return re.compile(instance)
+
+
+@_checks_drafts(draft3="date", draft7="date", raises=ValueError)
+def is_date(instance):
+    if not isinstance(instance, str_types):
+        return True
+    return datetime.datetime.strptime(instance, "%Y-%m-%d")
+
+
+@_checks_drafts(draft3="time", raises=ValueError)
+def is_draft3_time(instance):
+    if not isinstance(instance, str_types):
+        return True
+    return datetime.datetime.strptime(instance, "%H:%M:%S")
+
+
+try:
+    import webcolors
+except ImportError:
+    pass
+else:
+    def is_css_color_code(instance):
+        return webcolors.normalize_hex(instance)
+
+    @_checks_drafts(draft3="color", raises=(ValueError, TypeError))
+    def is_css21_color(instance):
+        if (
+            not isinstance(instance, str_types) or
+            instance.lower() in webcolors.css21_names_to_hex
+        ):
+            return True
+        return is_css_color_code(instance)
+
+    def is_css3_color(instance):
+        if instance.lower() in webcolors.css3_names_to_hex:
+            return True
+        return is_css_color_code(instance)
+
+
+try:
+    import jsonpointer
+except ImportError:
+    pass
+else:
+    @_checks_drafts(
+        draft6="json-pointer",
+        draft7="json-pointer",
+        raises=jsonpointer.JsonPointerException,
+    )
+    def is_json_pointer(instance):
+        if not isinstance(instance, str_types):
+            return True
+        return jsonpointer.JsonPointer(instance)
+
+    # TODO: I don't want to maintain this, so it
+    #       needs to go either into jsonpointer (pending
+    #       https://github.com/stefankoegl/python-json-pointer/issues/34) or
+    #       into a new external library.
+    @_checks_drafts(
+        draft7="relative-json-pointer",
+        raises=jsonpointer.JsonPointerException,
+    )
+    def is_relative_json_pointer(instance):
+        # Definition taken from:
+        # https://tools.ietf.org/html/draft-handrews-relative-json-pointer-01#section-3
+        if not isinstance(instance, str_types):
+            return True
+        non_negative_integer, rest = [], ""
+        for i, character in enumerate(instance):
+            if character.isdigit():
+                non_negative_integer.append(character)
+                continue
+
+            if not non_negative_integer:
+                return False
+
+            rest = instance[i:]
+            break
+        return (rest == "#") or jsonpointer.JsonPointer(rest)
+
+
+try:
+    import uritemplate.exceptions
+except ImportError:
+    pass
+else:
+    @_checks_drafts(
+        draft6="uri-template",
+        draft7="uri-template",
+        raises=uritemplate.exceptions.InvalidTemplate,
+    )
+    def is_uri_template(
+        instance,
+        template_validator=uritemplate.Validator().force_balanced_braces(),
+    ):
+        template = uritemplate.URITemplate(instance)
+        return template_validator.validate(template)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_legacy_validators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_legacy_validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..264ff7d713509af92df168ed4593edfeb1100d19
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_legacy_validators.py
@@ -0,0 +1,141 @@
+from jsonschema import _utils
+from jsonschema.compat import iteritems
+from jsonschema.exceptions import ValidationError
+
+
+def dependencies_draft3(validator, dependencies, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in iteritems(dependencies):
+        if property not in instance:
+            continue
+
+        if validator.is_type(dependency, "object"):
+            for error in validator.descend(
+                instance, dependency, schema_path=property,
+            ):
+                yield error
+        elif validator.is_type(dependency, "string"):
+            if dependency not in instance:
+                yield ValidationError(
+                    "%r is a dependency of %r" % (dependency, property)
+                )
+        else:
+            for each in dependency:
+                if each not in instance:
+                    message = "%r is a dependency of %r"
+                    yield ValidationError(message % (each, property))
+
+
+def disallow_draft3(validator, disallow, instance, schema):
+    for disallowed in _utils.ensure_list(disallow):
+        if validator.is_valid(instance, {"type": [disallowed]}):
+            yield ValidationError(
+                "%r is disallowed for %r" % (disallowed, instance)
+            )
+
+
+def extends_draft3(validator, extends, instance, schema):
+    if validator.is_type(extends, "object"):
+        for error in validator.descend(instance, extends):
+            yield error
+        return
+    for index, subschema in enumerate(extends):
+        for error in validator.descend(instance, subschema, schema_path=index):
+            yield error
+
+
+def items_draft3_draft4(validator, items, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if validator.is_type(items, "object"):
+        for index, item in enumerate(instance):
+            for error in validator.descend(item, items, path=index):
+                yield error
+    else:
+        for (index, item), subschema in zip(enumerate(instance), items):
+            for error in validator.descend(
+                item, subschema, path=index, schema_path=index,
+            ):
+                yield error
+
+
+def minimum_draft3_draft4(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if schema.get("exclusiveMinimum", False):
+        failed = instance <= minimum
+        cmp = "less than or equal to"
+    else:
+        failed = instance < minimum
+        cmp = "less than"
+
+    if failed:
+        yield ValidationError(
+            "%r is %s the minimum of %r" % (instance, cmp, minimum)
+        )
+
+
+def maximum_draft3_draft4(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if schema.get("exclusiveMaximum", False):
+        failed = instance >= maximum
+        cmp = "greater than or equal to"
+    else:
+        failed = instance > maximum
+        cmp = "greater than"
+
+    if failed:
+        yield ValidationError(
+            "%r is %s the maximum of %r" % (instance, cmp, maximum)
+        )
+
+
+def properties_draft3(validator, properties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, subschema in iteritems(properties):
+        if property in instance:
+            for error in validator.descend(
+                instance[property],
+                subschema,
+                path=property,
+                schema_path=property,
+            ):
+                yield error
+        elif subschema.get("required", False):
+            error = ValidationError("%r is a required property" % property)
+            error._set(
+                validator="required",
+                validator_value=subschema["required"],
+                instance=instance,
+                schema=schema,
+            )
+            error.path.appendleft(property)
+            error.schema_path.extend([property, "required"])
+            yield error
+
+
+def type_draft3(validator, types, instance, schema):
+    types = _utils.ensure_list(types)
+
+    all_errors = []
+    for index, type in enumerate(types):
+        if validator.is_type(type, "object"):
+            errors = list(validator.descend(instance, type, schema_path=index))
+            if not errors:
+                return
+            all_errors.extend(errors)
+        else:
+            if validator.is_type(instance, type):
+                return
+    else:
+        yield ValidationError(
+            _utils.types_msg(instance, types), context=all_errors,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_reflect.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_reflect.py
new file mode 100644
index 0000000000000000000000000000000000000000..d09e38fbdcf6b24ddc7a8a0fa9cfb30d01807467
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_reflect.py
@@ -0,0 +1,155 @@
+# -*- test-case-name: twisted.test.test_reflect -*-
+# Copyright (c) Twisted Matrix Laboratories.
+# See LICENSE for details.
+
+"""
+Standardized versions of various cool and/or strange things that you can do
+with Python's reflection capabilities.
+"""
+
+import sys
+
+from jsonschema.compat import PY3
+
+
+class _NoModuleFound(Exception):
+    """
+    No module was found because none exists.
+    """
+
+
+
+class InvalidName(ValueError):
+    """
+    The given name is not a dot-separated list of Python objects.
+    """
+
+
+
+class ModuleNotFound(InvalidName):
+    """
+    The module associated with the given name doesn't exist and it can't be
+    imported.
+    """
+
+
+
+class ObjectNotFound(InvalidName):
+    """
+    The object associated with the given name doesn't exist and it can't be
+    imported.
+    """
+
+
+
+if PY3:
+    def reraise(exception, traceback):
+        raise exception.with_traceback(traceback)
+else:
+    exec("""def reraise(exception, traceback):
+        raise exception.__class__, exception, traceback""")
+
+reraise.__doc__ = """
+Re-raise an exception, with an optional traceback, in a way that is compatible
+with both Python 2 and Python 3.
+
+Note that on Python 3, re-raised exceptions will be mutated, with their
+C{__traceback__} attribute being set.
+
+@param exception: The exception instance.
+@param traceback: The traceback to use, or C{None} indicating a new traceback.
+"""
+
+
+def _importAndCheckStack(importName):
+    """
+    Import the given name as a module, then walk the stack to determine whether
+    the failure was the module not existing, or some code in the module (for
+    example a dependent import) failing.  This can be helpful to determine
+    whether any actual application code was run.  For example, to distiguish
+    administrative error (entering the wrong module name), from programmer
+    error (writing buggy code in a module that fails to import).
+
+    @param importName: The name of the module to import.
+    @type importName: C{str}
+    @raise Exception: if something bad happens.  This can be any type of
+        exception, since nobody knows what loading some arbitrary code might
+        do.
+    @raise _NoModuleFound: if no module was found.
+    """
+    try:
+        return __import__(importName)
+    except ImportError:
+        excType, excValue, excTraceback = sys.exc_info()
+        while excTraceback:
+            execName = excTraceback.tb_frame.f_globals["__name__"]
+            # in Python 2 execName is None when an ImportError is encountered,
+            # where in Python 3 execName is equal to the importName.
+            if execName is None or execName == importName:
+                reraise(excValue, excTraceback)
+            excTraceback = excTraceback.tb_next
+        raise _NoModuleFound()
+
+
+
+def namedAny(name):
+    """
+    Retrieve a Python object by its fully qualified name from the global Python
+    module namespace.  The first part of the name, that describes a module,
+    will be discovered and imported.  Each subsequent part of the name is
+    treated as the name of an attribute of the object specified by all of the
+    name which came before it.  For example, the fully-qualified name of this
+    object is 'twisted.python.reflect.namedAny'.
+
+    @type name: L{str}
+    @param name: The name of the object to return.
+
+    @raise InvalidName: If the name is an empty string, starts or ends with
+        a '.', or is otherwise syntactically incorrect.
+
+    @raise ModuleNotFound: If the name is syntactically correct but the
+        module it specifies cannot be imported because it does not appear to
+        exist.
+
+    @raise ObjectNotFound: If the name is syntactically correct, includes at
+        least one '.', but the module it specifies cannot be imported because
+        it does not appear to exist.
+
+    @raise AttributeError: If an attribute of an object along the way cannot be
+        accessed, or a module along the way is not found.
+
+    @return: the Python object identified by 'name'.
+    """
+    if not name:
+        raise InvalidName('Empty module name')
+
+    names = name.split('.')
+
+    # if the name starts or ends with a '.' or contains '..', the __import__
+    # will raise an 'Empty module name' error. This will provide a better error
+    # message.
+    if '' in names:
+        raise InvalidName(
+            "name must be a string giving a '.'-separated list of Python "
+            "identifiers, not %r" % (name,))
+
+    topLevelPackage = None
+    moduleNames = names[:]
+    while not topLevelPackage:
+        if moduleNames:
+            trialname = '.'.join(moduleNames)
+            try:
+                topLevelPackage = _importAndCheckStack(trialname)
+            except _NoModuleFound:
+                moduleNames.pop()
+        else:
+            if len(names) == 1:
+                raise ModuleNotFound("No module named %r" % (name,))
+            else:
+                raise ObjectNotFound('%r does not name an object' % (name,))
+
+    obj = topLevelPackage
+    for n in names[1:]:
+        obj = getattr(obj, n)
+
+    return obj
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_types.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..a71a4e34bdccdcc047bc1c6cf05e54857be4fe72
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_types.py
@@ -0,0 +1,188 @@
+import numbers
+
+from pyrsistent import pmap
+import attr
+
+from jsonschema.compat import int_types, str_types
+from jsonschema.exceptions import UndefinedTypeCheck
+
+
+def is_array(checker, instance):
+    return isinstance(instance, list)
+
+
+def is_bool(checker, instance):
+    return isinstance(instance, bool)
+
+
+def is_integer(checker, instance):
+    # bool inherits from int, so ensure bools aren't reported as ints
+    if isinstance(instance, bool):
+        return False
+    return isinstance(instance, int_types)
+
+
+def is_null(checker, instance):
+    return instance is None
+
+
+def is_number(checker, instance):
+    # bool inherits from int, so ensure bools aren't reported as ints
+    if isinstance(instance, bool):
+        return False
+    return isinstance(instance, numbers.Number)
+
+
+def is_object(checker, instance):
+    return isinstance(instance, dict)
+
+
+def is_string(checker, instance):
+    return isinstance(instance, str_types)
+
+
+def is_any(checker, instance):
+    return True
+
+
+@attr.s(frozen=True)
+class TypeChecker(object):
+    """
+    A ``type`` property checker.
+
+    A `TypeChecker` performs type checking for an `IValidator`. Type
+    checks to perform are updated using `TypeChecker.redefine` or
+    `TypeChecker.redefine_many` and removed via `TypeChecker.remove`.
+    Each of these return a new `TypeChecker` object.
+
+    Arguments:
+
+        type_checkers (dict):
+
+            The initial mapping of types to their checking functions.
+    """
+    _type_checkers = attr.ib(default=pmap(), converter=pmap)
+
+    def is_type(self, instance, type):
+        """
+        Check if the instance is of the appropriate type.
+
+        Arguments:
+
+            instance (object):
+
+                The instance to check
+
+            type (str):
+
+                The name of the type that is expected.
+
+        Returns:
+
+            bool: Whether it conformed.
+
+
+        Raises:
+
+            `jsonschema.exceptions.UndefinedTypeCheck`:
+                if type is unknown to this object.
+        """
+        try:
+            fn = self._type_checkers[type]
+        except KeyError:
+            raise UndefinedTypeCheck(type)
+
+        return fn(self, instance)
+
+    def redefine(self, type, fn):
+        """
+        Produce a new checker with the given type redefined.
+
+        Arguments:
+
+            type (str):
+
+                The name of the type to check.
+
+            fn (collections.Callable):
+
+                A function taking exactly two parameters - the type
+                checker calling the function and the instance to check.
+                The function should return true if instance is of this
+                type and false otherwise.
+
+        Returns:
+
+            A new `TypeChecker` instance.
+        """
+        return self.redefine_many({type: fn})
+
+    def redefine_many(self, definitions=()):
+        """
+        Produce a new checker with the given types redefined.
+
+        Arguments:
+
+            definitions (dict):
+
+                A dictionary mapping types to their checking functions.
+
+        Returns:
+
+            A new `TypeChecker` instance.
+        """
+        return attr.evolve(
+            self, type_checkers=self._type_checkers.update(definitions),
+        )
+
+    def remove(self, *types):
+        """
+        Produce a new checker with the given types forgotten.
+
+        Arguments:
+
+            types (~collections.Iterable):
+
+                the names of the types to remove.
+
+        Returns:
+
+            A new `TypeChecker` instance
+
+        Raises:
+
+            `jsonschema.exceptions.UndefinedTypeCheck`:
+
+                if any given type is unknown to this object
+        """
+
+        checkers = self._type_checkers
+        for each in types:
+            try:
+                checkers = checkers.remove(each)
+            except KeyError:
+                raise UndefinedTypeCheck(each)
+        return attr.evolve(self, type_checkers=checkers)
+
+
+draft3_type_checker = TypeChecker(
+    {
+        u"any": is_any,
+        u"array": is_array,
+        u"boolean": is_bool,
+        u"integer": is_integer,
+        u"object": is_object,
+        u"null": is_null,
+        u"number": is_number,
+        u"string": is_string,
+    },
+)
+draft4_type_checker = draft3_type_checker.remove(u"any")
+draft6_type_checker = draft4_type_checker.redefine(
+    u"integer",
+    lambda checker, instance: (
+        is_integer(checker, instance) or
+        isinstance(instance, float) and instance.is_integer()
+    ),
+)
+draft7_type_checker = draft6_type_checker
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..ceb880198d140c88b96cead0956c4b8a752e8d4f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_utils.py
@@ -0,0 +1,212 @@
+import itertools
+import json
+import pkgutil
+import re
+
+from jsonschema.compat import MutableMapping, str_types, urlsplit
+
+
+class URIDict(MutableMapping):
+    """
+    Dictionary which uses normalized URIs as keys.
+    """
+
+    def normalize(self, uri):
+        return urlsplit(uri).geturl()
+
+    def __init__(self, *args, **kwargs):
+        self.store = dict()
+        self.store.update(*args, **kwargs)
+
+    def __getitem__(self, uri):
+        return self.store[self.normalize(uri)]
+
+    def __setitem__(self, uri, value):
+        self.store[self.normalize(uri)] = value
+
+    def __delitem__(self, uri):
+        del self.store[self.normalize(uri)]
+
+    def __iter__(self):
+        return iter(self.store)
+
+    def __len__(self):
+        return len(self.store)
+
+    def __repr__(self):
+        return repr(self.store)
+
+
+class Unset(object):
+    """
+    An as-of-yet unset attribute or unprovided default parameter.
+    """
+
+    def __repr__(self):
+        return "<unset>"
+
+
+def load_schema(name):
+    """
+    Load a schema from ./schemas/``name``.json and return it.
+    """
+
+    data = pkgutil.get_data("jsonschema", "schemas/{0}.json".format(name))
+    return json.loads(data.decode("utf-8"))
+
+
+def indent(string, times=1):
+    """
+    A dumb version of `textwrap.indent` from Python 3.3.
+    """
+
+    return "\n".join(" " * (4 * times) + line for line in string.splitlines())
+
+
+def format_as_index(indices):
+    """
+    Construct a single string containing indexing operations for the indices.
+
+    For example, [1, 2, "foo"] -> [1][2]["foo"]
+
+    Arguments:
+
+        indices (sequence):
+
+            The indices to format.
+    """
+
+    if not indices:
+        return ""
+    return "[%s]" % "][".join(repr(index) for index in indices)
+
+
+def find_additional_properties(instance, schema):
+    """
+    Return the set of additional properties for the given ``instance``.
+
+    Weeds out properties that should have been validated by ``properties`` and
+    / or ``patternProperties``.
+
+    Assumes ``instance`` is dict-like already.
+    """
+
+    properties = schema.get("properties", {})
+    patterns = "|".join(schema.get("patternProperties", {}))
+    for property in instance:
+        if property not in properties:
+            if patterns and re.search(patterns, property):
+                continue
+            yield property
+
+
+def extras_msg(extras):
+    """
+    Create an error message for extra items or properties.
+    """
+
+    if len(extras) == 1:
+        verb = "was"
+    else:
+        verb = "were"
+    return ", ".join(repr(extra) for extra in extras), verb
+
+
+def types_msg(instance, types):
+    """
+    Create an error message for a failure to match the given types.
+
+    If the ``instance`` is an object and contains a ``name`` property, it will
+    be considered to be a description of that object and used as its type.
+
+    Otherwise the message is simply the reprs of the given ``types``.
+    """
+
+    reprs = []
+    for type in types:
+        try:
+            reprs.append(repr(type["name"]))
+        except Exception:
+            reprs.append(repr(type))
+    return "%r is not of type %s" % (instance, ", ".join(reprs))
+
+
+def flatten(suitable_for_isinstance):
+    """
+    isinstance() can accept a bunch of really annoying different types:
+        * a single type
+        * a tuple of types
+        * an arbitrary nested tree of tuples
+
+    Return a flattened tuple of the given argument.
+    """
+
+    types = set()
+
+    if not isinstance(suitable_for_isinstance, tuple):
+        suitable_for_isinstance = (suitable_for_isinstance,)
+    for thing in suitable_for_isinstance:
+        if isinstance(thing, tuple):
+            types.update(flatten(thing))
+        else:
+            types.add(thing)
+    return tuple(types)
+
+
+def ensure_list(thing):
+    """
+    Wrap ``thing`` in a list if it's a single str.
+
+    Otherwise, return it unchanged.
+    """
+
+    if isinstance(thing, str_types):
+        return [thing]
+    return thing
+
+
+def equal(one, two):
+    """
+    Check if two things are equal, but evade booleans and ints being equal.
+    """
+    return unbool(one) == unbool(two)
+
+
+def unbool(element, true=object(), false=object()):
+    """
+    A hack to make True and 1 and False and 0 unique for ``uniq``.
+    """
+
+    if element is True:
+        return true
+    elif element is False:
+        return false
+    return element
+
+
+def uniq(container):
+    """
+    Check if all of a container's elements are unique.
+
+    Successively tries first to rely that the elements are hashable, then
+    falls back on them being sortable, and finally falls back on brute
+    force.
+    """
+
+    try:
+        return len(set(unbool(i) for i in container)) == len(container)
+    except TypeError:
+        try:
+            sort = sorted(unbool(i) for i in container)
+            sliced = itertools.islice(sort, 1, None)
+            for i, j in zip(sort, sliced):
+                if i == j:
+                    return False
+        except (NotImplementedError, TypeError):
+            seen = []
+            for e in container:
+                e = unbool(e)
+                if e in seen:
+                    return False
+                seen.append(e)
+    return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_validators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..179fec09a94af03c28b7b25642621d19b4efc8c6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/_validators.py
@@ -0,0 +1,373 @@
+import re
+
+from jsonschema._utils import (
+    ensure_list,
+    equal,
+    extras_msg,
+    find_additional_properties,
+    types_msg,
+    unbool,
+    uniq,
+)
+from jsonschema.exceptions import FormatError, ValidationError
+from jsonschema.compat import iteritems
+
+
+def patternProperties(validator, patternProperties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for pattern, subschema in iteritems(patternProperties):
+        for k, v in iteritems(instance):
+            if re.search(pattern, k):
+                for error in validator.descend(
+                    v, subschema, path=k, schema_path=pattern,
+                ):
+                    yield error
+
+
+def propertyNames(validator, propertyNames, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property in instance:
+        for error in validator.descend(
+            instance=property,
+            schema=propertyNames,
+        ):
+            yield error
+
+
+def additionalProperties(validator, aP, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    extras = set(find_additional_properties(instance, schema))
+
+    if validator.is_type(aP, "object"):
+        for extra in extras:
+            for error in validator.descend(instance[extra], aP, path=extra):
+                yield error
+    elif not aP and extras:
+        if "patternProperties" in schema:
+            patterns = sorted(schema["patternProperties"])
+            if len(extras) == 1:
+                verb = "does"
+            else:
+                verb = "do"
+            error = "%s %s not match any of the regexes: %s" % (
+                ", ".join(map(repr, sorted(extras))),
+                verb,
+                ", ".join(map(repr, patterns)),
+            )
+            yield ValidationError(error)
+        else:
+            error = "Additional properties are not allowed (%s %s unexpected)"
+            yield ValidationError(error % extras_msg(extras))
+
+
+def items(validator, items, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if validator.is_type(items, "array"):
+        for (index, item), subschema in zip(enumerate(instance), items):
+            for error in validator.descend(
+                item, subschema, path=index, schema_path=index,
+            ):
+                yield error
+    else:
+        for index, item in enumerate(instance):
+            for error in validator.descend(item, items, path=index):
+                yield error
+
+
+def additionalItems(validator, aI, instance, schema):
+    if (
+        not validator.is_type(instance, "array") or
+        validator.is_type(schema.get("items", {}), "object")
+    ):
+        return
+
+    len_items = len(schema.get("items", []))
+    if validator.is_type(aI, "object"):
+        for index, item in enumerate(instance[len_items:], start=len_items):
+            for error in validator.descend(item, aI, path=index):
+                yield error
+    elif not aI and len(instance) > len(schema.get("items", [])):
+        error = "Additional items are not allowed (%s %s unexpected)"
+        yield ValidationError(
+            error %
+            extras_msg(instance[len(schema.get("items", [])):])
+        )
+
+
+def const(validator, const, instance, schema):
+    if not equal(instance, const):
+        yield ValidationError("%r was expected" % (const,))
+
+
+def contains(validator, contains, instance, schema):
+    if not validator.is_type(instance, "array"):
+        return
+
+    if not any(validator.is_valid(element, contains) for element in instance):
+        yield ValidationError(
+            "None of %r are valid under the given schema" % (instance,)
+        )
+
+
+def exclusiveMinimum(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance <= minimum:
+        yield ValidationError(
+            "%r is less than or equal to the minimum of %r" % (
+                instance, minimum,
+            ),
+        )
+
+
+def exclusiveMaximum(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance >= maximum:
+        yield ValidationError(
+            "%r is greater than or equal to the maximum of %r" % (
+                instance, maximum,
+            ),
+        )
+
+
+def minimum(validator, minimum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance < minimum:
+        yield ValidationError(
+            "%r is less than the minimum of %r" % (instance, minimum)
+        )
+
+
+def maximum(validator, maximum, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if instance > maximum:
+        yield ValidationError(
+            "%r is greater than the maximum of %r" % (instance, maximum)
+        )
+
+
+def multipleOf(validator, dB, instance, schema):
+    if not validator.is_type(instance, "number"):
+        return
+
+    if isinstance(dB, float):
+        quotient = instance / dB
+        failed = int(quotient) != quotient
+    else:
+        failed = instance % dB
+
+    if failed:
+        yield ValidationError("%r is not a multiple of %r" % (instance, dB))
+
+
+def minItems(validator, mI, instance, schema):
+    if validator.is_type(instance, "array") and len(instance) < mI:
+        yield ValidationError("%r is too short" % (instance,))
+
+
+def maxItems(validator, mI, instance, schema):
+    if validator.is_type(instance, "array") and len(instance) > mI:
+        yield ValidationError("%r is too long" % (instance,))
+
+
+def uniqueItems(validator, uI, instance, schema):
+    if (
+        uI and
+        validator.is_type(instance, "array") and
+        not uniq(instance)
+    ):
+        yield ValidationError("%r has non-unique elements" % (instance,))
+
+
+def pattern(validator, patrn, instance, schema):
+    if (
+        validator.is_type(instance, "string") and
+        not re.search(patrn, instance)
+    ):
+        yield ValidationError("%r does not match %r" % (instance, patrn))
+
+
+def format(validator, format, instance, schema):
+    if validator.format_checker is not None:
+        try:
+            validator.format_checker.check(instance, format)
+        except FormatError as error:
+            yield ValidationError(error.message, cause=error.cause)
+
+
+def minLength(validator, mL, instance, schema):
+    if validator.is_type(instance, "string") and len(instance) < mL:
+        yield ValidationError("%r is too short" % (instance,))
+
+
+def maxLength(validator, mL, instance, schema):
+    if validator.is_type(instance, "string") and len(instance) > mL:
+        yield ValidationError("%r is too long" % (instance,))
+
+
+def dependencies(validator, dependencies, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, dependency in iteritems(dependencies):
+        if property not in instance:
+            continue
+
+        if validator.is_type(dependency, "array"):
+            for each in dependency:
+                if each not in instance:
+                    message = "%r is a dependency of %r"
+                    yield ValidationError(message % (each, property))
+        else:
+            for error in validator.descend(
+                instance, dependency, schema_path=property,
+            ):
+                yield error
+
+
+def enum(validator, enums, instance, schema):
+    if instance == 0 or instance == 1:
+        unbooled = unbool(instance)
+        if all(unbooled != unbool(each) for each in enums):
+            yield ValidationError("%r is not one of %r" % (instance, enums))
+    elif instance not in enums:
+        yield ValidationError("%r is not one of %r" % (instance, enums))
+
+
+def ref(validator, ref, instance, schema):
+    resolve = getattr(validator.resolver, "resolve", None)
+    if resolve is None:
+        with validator.resolver.resolving(ref) as resolved:
+            for error in validator.descend(instance, resolved):
+                yield error
+    else:
+        scope, resolved = validator.resolver.resolve(ref)
+        validator.resolver.push_scope(scope)
+
+        try:
+            for error in validator.descend(instance, resolved):
+                yield error
+        finally:
+            validator.resolver.pop_scope()
+
+
+def type(validator, types, instance, schema):
+    types = ensure_list(types)
+
+    if not any(validator.is_type(instance, type) for type in types):
+        yield ValidationError(types_msg(instance, types))
+
+
+def properties(validator, properties, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+
+    for property, subschema in iteritems(properties):
+        if property in instance:
+            for error in validator.descend(
+                instance[property],
+                subschema,
+                path=property,
+                schema_path=property,
+            ):
+                yield error
+
+
+def required(validator, required, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    for property in required:
+        if property not in instance:
+            yield ValidationError("%r is a required property" % property)
+
+
+def minProperties(validator, mP, instance, schema):
+    if validator.is_type(instance, "object") and len(instance) < mP:
+        yield ValidationError(
+            "%r does not have enough properties" % (instance,)
+        )
+
+
+def maxProperties(validator, mP, instance, schema):
+    if not validator.is_type(instance, "object"):
+        return
+    if validator.is_type(instance, "object") and len(instance) > mP:
+        yield ValidationError("%r has too many properties" % (instance,))
+
+
+def allOf(validator, allOf, instance, schema):
+    for index, subschema in enumerate(allOf):
+        for error in validator.descend(instance, subschema, schema_path=index):
+            yield error
+
+
+def anyOf(validator, anyOf, instance, schema):
+    all_errors = []
+    for index, subschema in enumerate(anyOf):
+        errs = list(validator.descend(instance, subschema, schema_path=index))
+        if not errs:
+            break
+        all_errors.extend(errs)
+    else:
+        yield ValidationError(
+            "%r is not valid under any of the given schemas" % (instance,),
+            context=all_errors,
+        )
+
+
+def oneOf(validator, oneOf, instance, schema):
+    subschemas = enumerate(oneOf)
+    all_errors = []
+    for index, subschema in subschemas:
+        errs = list(validator.descend(instance, subschema, schema_path=index))
+        if not errs:
+            first_valid = subschema
+            break
+        all_errors.extend(errs)
+    else:
+        yield ValidationError(
+            "%r is not valid under any of the given schemas" % (instance,),
+            context=all_errors,
+        )
+
+    more_valid = [s for i, s in subschemas if validator.is_valid(instance, s)]
+    if more_valid:
+        more_valid.append(first_valid)
+        reprs = ", ".join(repr(schema) for schema in more_valid)
+        yield ValidationError(
+            "%r is valid under each of %s" % (instance, reprs)
+        )
+
+
+def not_(validator, not_schema, instance, schema):
+    if validator.is_valid(instance, not_schema):
+        yield ValidationError(
+            "%r is not allowed for %r" % (not_schema, instance)
+        )
+
+
+def if_(validator, if_schema, instance, schema):
+    if validator.is_valid(instance, if_schema):
+        if u"then" in schema:
+            then = schema[u"then"]
+            for error in validator.descend(instance, then, schema_path="then"):
+                yield error
+    elif u"else" in schema:
+        else_ = schema[u"else"]
+        for error in validator.descend(instance, else_, schema_path="else"):
+            yield error
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e3dcc689930da95198c251ce806637d6413c8b1e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/__init__.py
@@ -0,0 +1,5 @@
+"""
+Benchmarks for validation.
+
+This package is *not* public API.
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/issue232.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/issue232.py
new file mode 100644
index 0000000000000000000000000000000000000000..65e3aedf79432a36126428f4ecb0cb0dc0c7dd18
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/issue232.py
@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+"""
+A performance benchmark using the example from issue #232.
+
+See https://github.com/Julian/jsonschema/pull/232.
+"""
+from twisted.python.filepath import FilePath
+from pyperf import Runner
+from pyrsistent import m
+
+from jsonschema.tests._suite import Version
+import jsonschema
+
+
+issue232 = Version(
+    path=FilePath(__file__).sibling("issue232"),
+    remotes=m(),
+    name="issue232",
+)
+
+
+if __name__ == "__main__":
+    issue232.benchmark(
+        runner=Runner(),
+        Validator=jsonschema.Draft4Validator,
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/json_schema_test_suite.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/json_schema_test_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..5add5051df1fdf59e34ba2af597c79ac8a128d1f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/benchmarks/json_schema_test_suite.py
@@ -0,0 +1,14 @@
+#!/usr/bin/env python
+"""
+A performance benchmark using the official test suite.
+
+This benchmarks jsonschema using every valid example in the
+JSON-Schema-Test-Suite. It will take some time to complete.
+"""
+from pyperf import Runner
+
+from jsonschema.tests._suite import Suite
+
+
+if __name__ == "__main__":
+    Suite().benchmark(runner=Runner())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/cli.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab3335b27c55d9ae746f3abb5f6551485858f2c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/cli.py
@@ -0,0 +1,90 @@
+"""
+The ``jsonschema`` command line.
+"""
+from __future__ import absolute_import
+import argparse
+import json
+import sys
+
+from jsonschema import __version__
+from jsonschema._reflect import namedAny
+from jsonschema.validators import validator_for
+
+
+def _namedAnyWithDefault(name):
+    if "." not in name:
+        name = "jsonschema." + name
+    return namedAny(name)
+
+
+def _json_file(path):
+    with open(path) as file:
+        return json.load(file)
+
+
+parser = argparse.ArgumentParser(
+    description="JSON Schema Validation CLI",
+)
+parser.add_argument(
+    "-i", "--instance",
+    action="append",
+    dest="instances",
+    type=_json_file,
+    help=(
+        "a path to a JSON instance (i.e. filename.json) "
+        "to validate (may be specified multiple times)"
+    ),
+)
+parser.add_argument(
+    "-F", "--error-format",
+    default="{error.instance}: {error.message}\n",
+    help=(
+        "the format to use for each error output message, specified in "
+        "a form suitable for passing to str.format, which will be called "
+        "with 'error' for each error"
+    ),
+)
+parser.add_argument(
+    "-V", "--validator",
+    type=_namedAnyWithDefault,
+    help=(
+        "the fully qualified object name of a validator to use, or, for "
+        "validators that are registered with jsonschema, simply the name "
+        "of the class."
+    ),
+)
+parser.add_argument(
+    "--version",
+    action="version",
+    version=__version__,
+)
+parser.add_argument(
+    "schema",
+    help="the JSON Schema to validate with (i.e. schema.json)",
+    type=_json_file,
+)
+
+
+def parse_args(args):
+    arguments = vars(parser.parse_args(args=args or ["--help"]))
+    if arguments["validator"] is None:
+        arguments["validator"] = validator_for(arguments["schema"])
+    return arguments
+
+
+def main(args=sys.argv[1:]):
+    sys.exit(run(arguments=parse_args(args=args)))
+
+
+def run(arguments, stdout=sys.stdout, stderr=sys.stderr):
+    error_format = arguments["error_format"]
+    validator = arguments["validator"](schema=arguments["schema"])
+
+    validator.check_schema(arguments["schema"])
+
+    errored = False
+    for instance in arguments["instances"] or ():
+        for error in validator.iter_errors(instance):
+            stderr.write(error_format.format(error=error))
+            errored = True
+    return errored
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..47e09804551688c92888f5588e7ff9089fcd0cbd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/compat.py
@@ -0,0 +1,55 @@
+"""
+Python 2/3 compatibility helpers.
+
+Note: This module is *not* public API.
+"""
+import contextlib
+import operator
+import sys
+
+
+try:
+    from collections.abc import MutableMapping, Sequence  # noqa
+except ImportError:
+    from collections import MutableMapping, Sequence  # noqa
+
+PY3 = sys.version_info[0] >= 3
+
+if PY3:
+    zip = zip
+    from functools import lru_cache
+    from io import StringIO as NativeIO
+    from urllib.parse import (
+        unquote, urljoin, urlunsplit, SplitResult, urlsplit
+    )
+    from urllib.request import pathname2url, urlopen
+    str_types = str,
+    int_types = int,
+    iteritems = operator.methodcaller("items")
+else:
+    from itertools import izip as zip  # noqa
+    from io import BytesIO as NativeIO
+    from urlparse import urljoin, urlunsplit, SplitResult, urlsplit
+    from urllib import pathname2url, unquote  # noqa
+    import urllib2  # noqa
+    def urlopen(*args, **kwargs):
+        return contextlib.closing(urllib2.urlopen(*args, **kwargs))
+
+    str_types = basestring
+    int_types = int, long
+    iteritems = operator.methodcaller("iteritems")
+
+    from functools32 import lru_cache
+
+
+def urldefrag(url):
+    if "#" in url:
+        s, n, p, q, frag = urlsplit(url)
+        defrag = urlunsplit((s, n, p, q, ""))
+    else:
+        defrag = url
+        frag = ""
+    return defrag, frag
+
+
+# flake8: noqa
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..691dcffe6c786722db9658b27d8cea1aa1827927
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/exceptions.py
@@ -0,0 +1,374 @@
+"""
+Validation errors, and some surrounding helpers.
+"""
+from collections import defaultdict, deque
+import itertools
+import pprint
+import textwrap
+
+import attr
+
+from jsonschema import _utils
+from jsonschema.compat import PY3, iteritems
+
+
+WEAK_MATCHES = frozenset(["anyOf", "oneOf"])
+STRONG_MATCHES = frozenset()
+
+_unset = _utils.Unset()
+
+
+class _Error(Exception):
+    def __init__(
+        self,
+        message,
+        validator=_unset,
+        path=(),
+        cause=None,
+        context=(),
+        validator_value=_unset,
+        instance=_unset,
+        schema=_unset,
+        schema_path=(),
+        parent=None,
+    ):
+        super(_Error, self).__init__(
+            message,
+            validator,
+            path,
+            cause,
+            context,
+            validator_value,
+            instance,
+            schema,
+            schema_path,
+            parent,
+        )
+        self.message = message
+        self.path = self.relative_path = deque(path)
+        self.schema_path = self.relative_schema_path = deque(schema_path)
+        self.context = list(context)
+        self.cause = self.__cause__ = cause
+        self.validator = validator
+        self.validator_value = validator_value
+        self.instance = instance
+        self.schema = schema
+        self.parent = parent
+
+        for error in context:
+            error.parent = self
+
+    def __repr__(self):
+        return "<%s: %r>" % (self.__class__.__name__, self.message)
+
+    def __unicode__(self):
+        essential_for_verbose = (
+            self.validator, self.validator_value, self.instance, self.schema,
+        )
+        if any(m is _unset for m in essential_for_verbose):
+            return self.message
+
+        pschema = pprint.pformat(self.schema, width=72)
+        pinstance = pprint.pformat(self.instance, width=72)
+        return self.message + textwrap.dedent("""
+
+            Failed validating %r in %s%s:
+            %s
+
+            On %s%s:
+            %s
+            """.rstrip()
+        ) % (
+            self.validator,
+            self._word_for_schema_in_error_message,
+            _utils.format_as_index(list(self.relative_schema_path)[:-1]),
+            _utils.indent(pschema),
+            self._word_for_instance_in_error_message,
+            _utils.format_as_index(self.relative_path),
+            _utils.indent(pinstance),
+        )
+
+    if PY3:
+        __str__ = __unicode__
+    else:
+        def __str__(self):
+            return unicode(self).encode("utf-8")
+
+    @classmethod
+    def create_from(cls, other):
+        return cls(**other._contents())
+
+    @property
+    def absolute_path(self):
+        parent = self.parent
+        if parent is None:
+            return self.relative_path
+
+        path = deque(self.relative_path)
+        path.extendleft(reversed(parent.absolute_path))
+        return path
+
+    @property
+    def absolute_schema_path(self):
+        parent = self.parent
+        if parent is None:
+            return self.relative_schema_path
+
+        path = deque(self.relative_schema_path)
+        path.extendleft(reversed(parent.absolute_schema_path))
+        return path
+
+    def _set(self, **kwargs):
+        for k, v in iteritems(kwargs):
+            if getattr(self, k) is _unset:
+                setattr(self, k, v)
+
+    def _contents(self):
+        attrs = (
+            "message", "cause", "context", "validator", "validator_value",
+            "path", "schema_path", "instance", "schema", "parent",
+        )
+        return dict((attr, getattr(self, attr)) for attr in attrs)
+
+
+class ValidationError(_Error):
+    """
+    An instance was invalid under a provided schema.
+    """
+
+    _word_for_schema_in_error_message = "schema"
+    _word_for_instance_in_error_message = "instance"
+
+
+class SchemaError(_Error):
+    """
+    A schema was invalid under its corresponding metaschema.
+    """
+
+    _word_for_schema_in_error_message = "metaschema"
+    _word_for_instance_in_error_message = "schema"
+
+
+@attr.s(hash=True)
+class RefResolutionError(Exception):
+    """
+    A ref could not be resolved.
+    """
+
+    _cause = attr.ib()
+
+    def __str__(self):
+        return str(self._cause)
+
+
+class UndefinedTypeCheck(Exception):
+    """
+    A type checker was asked to check a type it did not have registered.
+    """
+
+    def __init__(self, type):
+        self.type = type
+
+    def __unicode__(self):
+        return "Type %r is unknown to this type checker" % self.type
+
+    if PY3:
+        __str__ = __unicode__
+    else:
+        def __str__(self):
+            return unicode(self).encode("utf-8")
+
+
+class UnknownType(Exception):
+    """
+    A validator was asked to validate an instance against an unknown type.
+    """
+
+    def __init__(self, type, instance, schema):
+        self.type = type
+        self.instance = instance
+        self.schema = schema
+
+    def __unicode__(self):
+        pschema = pprint.pformat(self.schema, width=72)
+        pinstance = pprint.pformat(self.instance, width=72)
+        return textwrap.dedent("""
+            Unknown type %r for validator with schema:
+            %s
+
+            While checking instance:
+            %s
+            """.rstrip()
+        ) % (self.type, _utils.indent(pschema), _utils.indent(pinstance))
+
+    if PY3:
+        __str__ = __unicode__
+    else:
+        def __str__(self):
+            return unicode(self).encode("utf-8")
+
+
+class FormatError(Exception):
+    """
+    Validating a format failed.
+    """
+
+    def __init__(self, message, cause=None):
+        super(FormatError, self).__init__(message, cause)
+        self.message = message
+        self.cause = self.__cause__ = cause
+
+    def __unicode__(self):
+        return self.message
+
+    if PY3:
+        __str__ = __unicode__
+    else:
+        def __str__(self):
+            return self.message.encode("utf-8")
+
+
+class ErrorTree(object):
+    """
+    ErrorTrees make it easier to check which validations failed.
+    """
+
+    _instance = _unset
+
+    def __init__(self, errors=()):
+        self.errors = {}
+        self._contents = defaultdict(self.__class__)
+
+        for error in errors:
+            container = self
+            for element in error.path:
+                container = container[element]
+            container.errors[error.validator] = error
+
+            container._instance = error.instance
+
+    def __contains__(self, index):
+        """
+        Check whether ``instance[index]`` has any errors.
+        """
+
+        return index in self._contents
+
+    def __getitem__(self, index):
+        """
+        Retrieve the child tree one level down at the given ``index``.
+
+        If the index is not in the instance that this tree corresponds to and
+        is not known by this tree, whatever error would be raised by
+        ``instance.__getitem__`` will be propagated (usually this is some
+        subclass of `exceptions.LookupError`.
+        """
+
+        if self._instance is not _unset and index not in self:
+            self._instance[index]
+        return self._contents[index]
+
+    def __setitem__(self, index, value):
+        """
+        Add an error to the tree at the given ``index``.
+        """
+        self._contents[index] = value
+
+    def __iter__(self):
+        """
+        Iterate (non-recursively) over the indices in the instance with errors.
+        """
+
+        return iter(self._contents)
+
+    def __len__(self):
+        """
+        Return the `total_errors`.
+        """
+        return self.total_errors
+
+    def __repr__(self):
+        return "<%s (%s total errors)>" % (self.__class__.__name__, len(self))
+
+    @property
+    def total_errors(self):
+        """
+        The total number of errors in the entire tree, including children.
+        """
+
+        child_errors = sum(len(tree) for _, tree in iteritems(self._contents))
+        return len(self.errors) + child_errors
+
+
+def by_relevance(weak=WEAK_MATCHES, strong=STRONG_MATCHES):
+    """
+    Create a key function that can be used to sort errors by relevance.
+
+    Arguments:
+        weak (set):
+            a collection of validator names to consider to be "weak".
+            If there are two errors at the same level of the instance
+            and one is in the set of weak validator names, the other
+            error will take priority. By default, :validator:`anyOf` and
+            :validator:`oneOf` are considered weak validators and will
+            be superseded by other same-level validation errors.
+
+        strong (set):
+            a collection of validator names to consider to be "strong"
+    """
+    def relevance(error):
+        validator = error.validator
+        return -len(error.path), validator not in weak, validator in strong
+    return relevance
+
+
+relevance = by_relevance()
+
+
+def best_match(errors, key=relevance):
+    """
+    Try to find an error that appears to be the best match among given errors.
+
+    In general, errors that are higher up in the instance (i.e. for which
+    `ValidationError.path` is shorter) are considered better matches,
+    since they indicate "more" is wrong with the instance.
+
+    If the resulting match is either :validator:`oneOf` or :validator:`anyOf`,
+    the *opposite* assumption is made -- i.e. the deepest error is picked,
+    since these validators only need to match once, and any other errors may
+    not be relevant.
+
+    Arguments:
+        errors (collections.Iterable):
+
+            the errors to select from. Do not provide a mixture of
+            errors from different validation attempts (i.e. from
+            different instances or schemas), since it won't produce
+            sensical output.
+
+        key (collections.Callable):
+
+            the key to use when sorting errors. See `relevance` and
+            transitively `by_relevance` for more details (the default is
+            to sort with the defaults of that function). Changing the
+            default is only useful if you want to change the function
+            that rates errors but still want the error context descent
+            done by this function.
+
+    Returns:
+        the best matching error, or ``None`` if the iterable was empty
+
+    .. note::
+
+        This function is a heuristic. Its return value may change for a given
+        set of inputs from version to version if better heuristics are added.
+    """
+    errors = iter(errors)
+    best = next(errors, None)
+    if best is None:
+        return
+    best = max(itertools.chain([best], errors), key=key)
+
+    while best.context:
+        best = min(best.context, key=key)
+    return best
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft3.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft3.json
new file mode 100644
index 0000000000000000000000000000000000000000..f8a09c563b4c9a9d32995d2b1722e4e611b36dd9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft3.json
@@ -0,0 +1,199 @@
+{
+    "$schema": "http://json-schema.org/draft-03/schema#",
+    "dependencies": {
+        "exclusiveMaximum": "maximum",
+        "exclusiveMinimum": "minimum"
+    },
+    "id": "http://json-schema.org/draft-03/schema#",
+    "properties": {
+        "$ref": {
+            "format": "uri",
+            "type": "string"
+        },
+        "$schema": {
+            "format": "uri",
+            "type": "string"
+        },
+        "additionalItems": {
+            "default": {},
+            "type": [
+                {
+                    "$ref": "#"
+                },
+                "boolean"
+            ]
+        },
+        "additionalProperties": {
+            "default": {},
+            "type": [
+                {
+                    "$ref": "#"
+                },
+                "boolean"
+            ]
+        },
+        "default": {
+            "type": "any"
+        },
+        "dependencies": {
+            "additionalProperties": {
+                "items": {
+                    "type": "string"
+                },
+                "type": [
+                    "string",
+                    "array",
+                    {
+                        "$ref": "#"
+                    }
+                ]
+            },
+            "default": {},
+            "type": [
+                "string",
+                "array",
+                "object"
+            ]
+        },
+        "description": {
+            "type": "string"
+        },
+        "disallow": {
+            "items": {
+                "type": [
+                    "string",
+                    {
+                        "$ref": "#"
+                    }
+                ]
+            },
+            "type": [
+                "string",
+                "array"
+            ],
+            "uniqueItems": true
+        },
+        "divisibleBy": {
+            "default": 1,
+            "exclusiveMinimum": true,
+            "minimum": 0,
+            "type": "number"
+        },
+        "enum": {
+            "type": "array"
+        },
+        "exclusiveMaximum": {
+            "default": false,
+            "type": "boolean"
+        },
+        "exclusiveMinimum": {
+            "default": false,
+            "type": "boolean"
+        },
+        "extends": {
+            "default": {},
+            "items": {
+                "$ref": "#"
+            },
+            "type": [
+                {
+                    "$ref": "#"
+                },
+                "array"
+            ]
+        },
+        "format": {
+            "type": "string"
+        },
+        "id": {
+            "format": "uri",
+            "type": "string"
+        },
+        "items": {
+            "default": {},
+            "items": {
+                "$ref": "#"
+            },
+            "type": [
+                {
+                    "$ref": "#"
+                },
+                "array"
+            ]
+        },
+        "maxDecimal": {
+            "minimum": 0,
+            "type": "number"
+        },
+        "maxItems": {
+            "minimum": 0,
+            "type": "integer"
+        },
+        "maxLength": {
+            "type": "integer"
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "minItems": {
+            "default": 0,
+            "minimum": 0,
+            "type": "integer"
+        },
+        "minLength": {
+            "default": 0,
+            "minimum": 0,
+            "type": "integer"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "pattern": {
+            "format": "regex",
+            "type": "string"
+        },
+        "patternProperties": {
+            "additionalProperties": {
+                "$ref": "#"
+            },
+            "default": {},
+            "type": "object"
+        },
+        "properties": {
+            "additionalProperties": {
+                "$ref": "#",
+                "type": "object"
+            },
+            "default": {},
+            "type": "object"
+        },
+        "required": {
+            "default": false,
+            "type": "boolean"
+        },
+        "title": {
+            "type": "string"
+        },
+        "type": {
+            "default": "any",
+            "items": {
+                "type": [
+                    "string",
+                    {
+                        "$ref": "#"
+                    }
+                ]
+            },
+            "type": [
+                "string",
+                "array"
+            ],
+            "uniqueItems": true
+        },
+        "uniqueItems": {
+            "default": false,
+            "type": "boolean"
+        }
+    },
+    "type": "object"
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft4.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft4.json
new file mode 100644
index 0000000000000000000000000000000000000000..9b666cff88acfbd904086bfb7798a370dae3f25a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft4.json
@@ -0,0 +1,222 @@
+{
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "default": {},
+    "definitions": {
+        "positiveInteger": {
+            "minimum": 0,
+            "type": "integer"
+        },
+        "positiveIntegerDefault0": {
+            "allOf": [
+                {
+                    "$ref": "#/definitions/positiveInteger"
+                },
+                {
+                    "default": 0
+                }
+            ]
+        },
+        "schemaArray": {
+            "items": {
+                "$ref": "#"
+            },
+            "minItems": 1,
+            "type": "array"
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "items": {
+                "type": "string"
+            },
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+        }
+    },
+    "dependencies": {
+        "exclusiveMaximum": [
+            "maximum"
+        ],
+        "exclusiveMinimum": [
+            "minimum"
+        ]
+    },
+    "description": "Core schema meta-schema",
+    "id": "http://json-schema.org/draft-04/schema#",
+    "properties": {
+        "$schema": {
+            "format": "uri",
+            "type": "string"
+        },
+        "additionalItems": {
+            "anyOf": [
+                {
+                    "type": "boolean"
+                },
+                {
+                    "$ref": "#"
+                }
+            ],
+            "default": {}
+        },
+        "additionalProperties": {
+            "anyOf": [
+                {
+                    "type": "boolean"
+                },
+                {
+                    "$ref": "#"
+                }
+            ],
+            "default": {}
+        },
+        "allOf": {
+            "$ref": "#/definitions/schemaArray"
+        },
+        "anyOf": {
+            "$ref": "#/definitions/schemaArray"
+        },
+        "default": {},
+        "definitions": {
+            "additionalProperties": {
+                "$ref": "#"
+            },
+            "default": {},
+            "type": "object"
+        },
+        "dependencies": {
+            "additionalProperties": {
+                "anyOf": [
+                    {
+                        "$ref": "#"
+                    },
+                    {
+                        "$ref": "#/definitions/stringArray"
+                    }
+                ]
+            },
+            "type": "object"
+        },
+        "description": {
+            "type": "string"
+        },
+        "enum": {
+            "type": "array"
+        },
+        "exclusiveMaximum": {
+            "default": false,
+            "type": "boolean"
+        },
+        "exclusiveMinimum": {
+            "default": false,
+            "type": "boolean"
+        },
+        "format": {
+            "type": "string"
+        },
+        "id": {
+            "format": "uri",
+            "type": "string"
+        },
+        "items": {
+            "anyOf": [
+                {
+                    "$ref": "#"
+                },
+                {
+                    "$ref": "#/definitions/schemaArray"
+                }
+            ],
+            "default": {}
+        },
+        "maxItems": {
+            "$ref": "#/definitions/positiveInteger"
+        },
+        "maxLength": {
+            "$ref": "#/definitions/positiveInteger"
+        },
+        "maxProperties": {
+            "$ref": "#/definitions/positiveInteger"
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "minItems": {
+            "$ref": "#/definitions/positiveIntegerDefault0"
+        },
+        "minLength": {
+            "$ref": "#/definitions/positiveIntegerDefault0"
+        },
+        "minProperties": {
+            "$ref": "#/definitions/positiveIntegerDefault0"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "multipleOf": {
+            "exclusiveMinimum": true,
+            "minimum": 0,
+            "type": "number"
+        },
+        "not": {
+            "$ref": "#"
+        },
+        "oneOf": {
+            "$ref": "#/definitions/schemaArray"
+        },
+        "pattern": {
+            "format": "regex",
+            "type": "string"
+        },
+        "patternProperties": {
+            "additionalProperties": {
+                "$ref": "#"
+            },
+            "default": {},
+            "type": "object"
+        },
+        "properties": {
+            "additionalProperties": {
+                "$ref": "#"
+            },
+            "default": {},
+            "type": "object"
+        },
+        "required": {
+            "$ref": "#/definitions/stringArray"
+        },
+        "title": {
+            "type": "string"
+        },
+        "type": {
+            "anyOf": [
+                {
+                    "$ref": "#/definitions/simpleTypes"
+                },
+                {
+                    "items": {
+                        "$ref": "#/definitions/simpleTypes"
+                    },
+                    "minItems": 1,
+                    "type": "array",
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "uniqueItems": {
+            "default": false,
+            "type": "boolean"
+        }
+    },
+    "type": "object"
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft6.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft6.json
new file mode 100644
index 0000000000000000000000000000000000000000..a0d2bf7896c2619ae657cd3b3266660156021706
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft6.json
@@ -0,0 +1,153 @@
+{
+    "$schema": "http://json-schema.org/draft-06/schema#",
+    "$id": "http://json-schema.org/draft-06/schema#",
+    "title": "Core schema meta-schema",
+    "definitions": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#" }
+        },
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "allOf": [
+                { "$ref": "#/definitions/nonNegativeInteger" },
+                { "default": 0 }
+            ]
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    },
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$schema": {
+            "type": "string",
+            "format": "uri"
+        },
+        "$ref": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": {},
+        "examples": {
+            "type": "array",
+            "items": {}
+        },
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minLength": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "additionalItems": { "$ref": "#" },
+        "items": {
+            "anyOf": [
+                { "$ref": "#" },
+                { "$ref": "#/definitions/schemaArray" }
+            ],
+            "default": {}
+        },
+        "maxItems": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minItems": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "contains": { "$ref": "#" },
+        "maxProperties": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/definitions/stringArray" },
+        "additionalProperties": { "$ref": "#" },
+        "definitions": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependencies": {
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$ref": "#" },
+                    { "$ref": "#/definitions/stringArray" }
+                ]
+            }
+        },
+        "propertyNames": { "$ref": "#" },
+        "const": {},
+        "enum": {
+            "type": "array"
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/definitions/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "format": { "type": "string" },
+        "allOf": { "$ref": "#/definitions/schemaArray" },
+        "anyOf": { "$ref": "#/definitions/schemaArray" },
+        "oneOf": { "$ref": "#/definitions/schemaArray" },
+        "not": { "$ref": "#" }
+    },
+    "default": {}
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft7.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft7.json
new file mode 100644
index 0000000000000000000000000000000000000000..746cde9690134529bdcde889f72c7ad5259f24ad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/schemas/draft7.json
@@ -0,0 +1,166 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "http://json-schema.org/draft-07/schema#",
+    "title": "Core schema meta-schema",
+    "definitions": {
+        "schemaArray": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#" }
+        },
+        "nonNegativeInteger": {
+            "type": "integer",
+            "minimum": 0
+        },
+        "nonNegativeIntegerDefault0": {
+            "allOf": [
+                { "$ref": "#/definitions/nonNegativeInteger" },
+                { "default": 0 }
+            ]
+        },
+        "simpleTypes": {
+            "enum": [
+                "array",
+                "boolean",
+                "integer",
+                "null",
+                "number",
+                "object",
+                "string"
+            ]
+        },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "default": []
+        }
+    },
+    "type": ["object", "boolean"],
+    "properties": {
+        "$id": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$schema": {
+            "type": "string",
+            "format": "uri"
+        },
+        "$ref": {
+            "type": "string",
+            "format": "uri-reference"
+        },
+        "$comment": {
+            "type": "string"
+        },
+        "title": {
+            "type": "string"
+        },
+        "description": {
+            "type": "string"
+        },
+        "default": true,
+        "readOnly": {
+            "type": "boolean",
+            "default": false
+        },
+        "examples": {
+            "type": "array",
+            "items": true
+        },
+        "multipleOf": {
+            "type": "number",
+            "exclusiveMinimum": 0
+        },
+        "maximum": {
+            "type": "number"
+        },
+        "exclusiveMaximum": {
+            "type": "number"
+        },
+        "minimum": {
+            "type": "number"
+        },
+        "exclusiveMinimum": {
+            "type": "number"
+        },
+        "maxLength": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minLength": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "pattern": {
+            "type": "string",
+            "format": "regex"
+        },
+        "additionalItems": { "$ref": "#" },
+        "items": {
+            "anyOf": [
+                { "$ref": "#" },
+                { "$ref": "#/definitions/schemaArray" }
+            ],
+            "default": true
+        },
+        "maxItems": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minItems": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "uniqueItems": {
+            "type": "boolean",
+            "default": false
+        },
+        "contains": { "$ref": "#" },
+        "maxProperties": { "$ref": "#/definitions/nonNegativeInteger" },
+        "minProperties": { "$ref": "#/definitions/nonNegativeIntegerDefault0" },
+        "required": { "$ref": "#/definitions/stringArray" },
+        "additionalProperties": { "$ref": "#" },
+        "definitions": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "properties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "default": {}
+        },
+        "patternProperties": {
+            "type": "object",
+            "additionalProperties": { "$ref": "#" },
+            "propertyNames": { "format": "regex" },
+            "default": {}
+        },
+        "dependencies": {
+            "type": "object",
+            "additionalProperties": {
+                "anyOf": [
+                    { "$ref": "#" },
+                    { "$ref": "#/definitions/stringArray" }
+                ]
+            }
+        },
+        "propertyNames": { "$ref": "#" },
+        "const": true,
+        "enum": {
+            "type": "array",
+            "items": true
+        },
+        "type": {
+            "anyOf": [
+                { "$ref": "#/definitions/simpleTypes" },
+                {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/simpleTypes" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                }
+            ]
+        },
+        "format": { "type": "string" },
+        "contentMediaType": { "type": "string" },
+        "contentEncoding": { "type": "string" },
+        "if": {"$ref": "#"},
+        "then": {"$ref": "#"},
+        "else": {"$ref": "#"},
+        "allOf": { "$ref": "#/definitions/schemaArray" },
+        "anyOf": { "$ref": "#/definitions/schemaArray" },
+        "oneOf": { "$ref": "#/definitions/schemaArray" },
+        "not": { "$ref": "#" }
+    },
+    "default": true
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..70f291fe2ab20f7dd7d2039095ef05c47dc0a5d8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_helpers.py
@@ -0,0 +1,5 @@
+def bug(issue=None):
+    message = "A known bug."
+    if issue is not None:
+        message += " See issue #{issue}.".format(issue=issue)
+    return message
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_suite.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..b68a7b668c94f4fce221ebeaec1f6661ef54e03d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/_suite.py
@@ -0,0 +1,239 @@
+"""
+Python representations of the JSON Schema Test Suite tests.
+"""
+
+from functools import partial
+import json
+import os
+import re
+import subprocess
+import sys
+import unittest
+
+from twisted.python.filepath import FilePath
+import attr
+
+from jsonschema.compat import PY3
+from jsonschema.validators import validators
+import jsonschema
+
+
+def _find_suite():
+    root = os.environ.get("JSON_SCHEMA_TEST_SUITE")
+    if root is not None:
+        return FilePath(root)
+
+    root = FilePath(jsonschema.__file__).parent().sibling("json")
+    if not root.isdir():  # pragma: no cover
+        raise ValueError(
+            (
+                "Can't find the JSON-Schema-Test-Suite directory. "
+                "Set the 'JSON_SCHEMA_TEST_SUITE' environment "
+                "variable or run the tests from alongside a checkout "
+                "of the suite."
+            ),
+        )
+    return root
+
+
+@attr.s(hash=True)
+class Suite(object):
+
+    _root = attr.ib(default=attr.Factory(_find_suite))
+
+    def _remotes(self):
+        jsonschema_suite = self._root.descendant(["bin", "jsonschema_suite"])
+        remotes = subprocess.check_output(
+            [sys.executable, jsonschema_suite.path, "remotes"],
+        )
+        return {
+            "http://localhost:1234/" + name: schema
+            for name, schema in json.loads(remotes.decode("utf-8")).items()
+        }
+
+    def benchmark(self, runner):  # pragma: no cover
+        for name in validators:
+            self.version(name=name).benchmark(runner=runner)
+
+    def version(self, name):
+        return Version(
+            name=name,
+            path=self._root.descendant(["tests", name]),
+            remotes=self._remotes(),
+        )
+
+
+@attr.s(hash=True)
+class Version(object):
+
+    _path = attr.ib()
+    _remotes = attr.ib()
+
+    name = attr.ib()
+
+    def benchmark(self, runner, **kwargs):  # pragma: no cover
+        for suite in self.tests():
+            for test in suite:
+                runner.bench_func(
+                    test.fully_qualified_name,
+                    partial(test.validate_ignoring_errors, **kwargs),
+                )
+
+    def tests(self):
+        return (
+            test
+            for child in self._path.globChildren("*.json")
+            for test in self._tests_in(
+                subject=child.basename()[:-5],
+                path=child,
+            )
+        )
+
+    def format_tests(self):
+        path = self._path.descendant(["optional", "format"])
+        return (
+            test
+            for child in path.globChildren("*.json")
+            for test in self._tests_in(
+                subject=child.basename()[:-5],
+                path=child,
+            )
+        )
+
+    def tests_of(self, name):
+        return self._tests_in(
+            subject=name,
+            path=self._path.child(name + ".json"),
+        )
+
+    def optional_tests_of(self, name):
+        return self._tests_in(
+            subject=name,
+            path=self._path.descendant(["optional", name + ".json"]),
+        )
+
+    def to_unittest_testcase(self, *suites, **kwargs):
+        name = kwargs.pop("name", "Test" + self.name.title())
+        methods = {
+            test.method_name: test.to_unittest_method(**kwargs)
+            for suite in suites
+            for tests in suite
+            for test in tests
+        }
+        cls = type(name, (unittest.TestCase,), methods)
+
+        try:
+            cls.__module__ = _someone_save_us_the_module_of_the_caller()
+        except Exception:  # pragma: no cover
+            # We're doing crazy things, so if they go wrong, like a function
+            # behaving differently on some other interpreter, just make them
+            # not happen.
+            pass
+
+        return cls
+
+    def _tests_in(self, subject, path):
+        for each in json.loads(path.getContent().decode("utf-8")):
+            yield (
+                _Test(
+                    version=self,
+                    subject=subject,
+                    case_description=each["description"],
+                    schema=each["schema"],
+                    remotes=self._remotes,
+                    **test
+                ) for test in each["tests"]
+            )
+
+
+@attr.s(hash=True, repr=False)
+class _Test(object):
+
+    version = attr.ib()
+
+    subject = attr.ib()
+    case_description = attr.ib()
+    description = attr.ib()
+
+    data = attr.ib()
+    schema = attr.ib(repr=False)
+
+    valid = attr.ib()
+
+    _remotes = attr.ib()
+
+    def __repr__(self):  # pragma: no cover
+        return "<Test {}>".format(self.fully_qualified_name)
+
+    @property
+    def fully_qualified_name(self):  # pragma: no cover
+        return " > ".join(
+            [
+                self.version.name,
+                self.subject,
+                self.case_description,
+                self.description,
+            ]
+        )
+
+    @property
+    def method_name(self):
+        delimiters = r"[\W\- ]+"
+        name = "test_%s_%s_%s" % (
+            re.sub(delimiters, "_", self.subject),
+            re.sub(delimiters, "_", self.case_description),
+            re.sub(delimiters, "_", self.description),
+        )
+
+        if not PY3:  # pragma: no cover
+            name = name.encode("utf-8")
+        return name
+
+    def to_unittest_method(self, skip=lambda test: None, **kwargs):
+        if self.valid:
+            def fn(this):
+                self.validate(**kwargs)
+        else:
+            def fn(this):
+                with this.assertRaises(jsonschema.ValidationError):
+                    self.validate(**kwargs)
+
+        fn.__name__ = self.method_name
+        reason = skip(self)
+        return unittest.skipIf(reason is not None, reason)(fn)
+
+    def validate(self, Validator, **kwargs):
+        resolver = jsonschema.RefResolver.from_schema(
+            schema=self.schema,
+            store=self._remotes,
+            id_of=Validator.ID_OF,
+        )
+        jsonschema.validate(
+            instance=self.data,
+            schema=self.schema,
+            cls=Validator,
+            resolver=resolver,
+            **kwargs
+        )
+
+    def validate_ignoring_errors(self, Validator):  # pragma: no cover
+        try:
+            self.validate(Validator=Validator)
+        except jsonschema.ValidationError:
+            pass
+
+
+def _someone_save_us_the_module_of_the_caller():
+    """
+    The FQON of the module 2nd stack frames up from here.
+
+    This is intended to allow us to dynamicallly return test case classes that
+    are indistinguishable from being defined in the module that wants them.
+
+    Otherwise, trial will mis-print the FQON, and copy pasting it won't re-run
+    the class that really is running.
+
+    Save us all, this is all so so so so so terrible.
+    """
+
+    return sys._getframe(2).f_globals["__name__"]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_cli.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed820ba3f83ff4147d3e4bd81f28449a14772461
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_cli.py
@@ -0,0 +1,151 @@
+from unittest import TestCase
+import json
+import subprocess
+import sys
+
+from jsonschema import Draft4Validator, ValidationError, cli, __version__
+from jsonschema.compat import NativeIO
+from jsonschema.exceptions import SchemaError
+
+
+def fake_validator(*errors):
+    errors = list(reversed(errors))
+
+    class FakeValidator(object):
+        def __init__(self, *args, **kwargs):
+            pass
+
+        def iter_errors(self, instance):
+            if errors:
+                return errors.pop()
+            return []
+
+        def check_schema(self, schema):
+            pass
+
+    return FakeValidator
+
+
+class TestParser(TestCase):
+
+    FakeValidator = fake_validator()
+    instance_file = "foo.json"
+    schema_file = "schema.json"
+
+    def setUp(self):
+        cli.open = self.fake_open
+        self.addCleanup(delattr, cli, "open")
+
+    def fake_open(self, path):
+        if path == self.instance_file:
+            contents = ""
+        elif path == self.schema_file:
+            contents = {}
+        else:  # pragma: no cover
+            self.fail("What is {!r}".format(path))
+        return NativeIO(json.dumps(contents))
+
+    def test_find_validator_by_fully_qualified_object_name(self):
+        arguments = cli.parse_args(
+            [
+                "--validator",
+                "jsonschema.tests.test_cli.TestParser.FakeValidator",
+                "--instance", self.instance_file,
+                self.schema_file,
+            ]
+        )
+        self.assertIs(arguments["validator"], self.FakeValidator)
+
+    def test_find_validator_in_jsonschema(self):
+        arguments = cli.parse_args(
+            [
+                "--validator", "Draft4Validator",
+                "--instance", self.instance_file,
+                self.schema_file,
+            ]
+        )
+        self.assertIs(arguments["validator"], Draft4Validator)
+
+
+class TestCLI(TestCase):
+    def test_draft3_schema_draft4_validator(self):
+        stdout, stderr = NativeIO(), NativeIO()
+        with self.assertRaises(SchemaError):
+            cli.run(
+                {
+                    "validator": Draft4Validator,
+                    "schema": {
+                        "anyOf": [
+                            {"minimum": 20},
+                            {"type": "string"},
+                            {"required": True},
+                        ],
+                    },
+                    "instances": [1],
+                    "error_format": "{error.message}",
+                },
+                stdout=stdout,
+                stderr=stderr,
+            )
+
+    def test_successful_validation(self):
+        stdout, stderr = NativeIO(), NativeIO()
+        exit_code = cli.run(
+            {
+                "validator": fake_validator(),
+                "schema": {},
+                "instances": [1],
+                "error_format": "{error.message}",
+            },
+            stdout=stdout,
+            stderr=stderr,
+        )
+        self.assertFalse(stdout.getvalue())
+        self.assertFalse(stderr.getvalue())
+        self.assertEqual(exit_code, 0)
+
+    def test_unsuccessful_validation(self):
+        error = ValidationError("I am an error!", instance=1)
+        stdout, stderr = NativeIO(), NativeIO()
+        exit_code = cli.run(
+            {
+                "validator": fake_validator([error]),
+                "schema": {},
+                "instances": [1],
+                "error_format": "{error.instance} - {error.message}",
+            },
+            stdout=stdout,
+            stderr=stderr,
+        )
+        self.assertFalse(stdout.getvalue())
+        self.assertEqual(stderr.getvalue(), "1 - I am an error!")
+        self.assertEqual(exit_code, 1)
+
+    def test_unsuccessful_validation_multiple_instances(self):
+        first_errors = [
+            ValidationError("9", instance=1),
+            ValidationError("8", instance=1),
+        ]
+        second_errors = [ValidationError("7", instance=2)]
+        stdout, stderr = NativeIO(), NativeIO()
+        exit_code = cli.run(
+            {
+                "validator": fake_validator(first_errors, second_errors),
+                "schema": {},
+                "instances": [1, 2],
+                "error_format": "{error.instance} - {error.message}\t",
+            },
+            stdout=stdout,
+            stderr=stderr,
+        )
+        self.assertFalse(stdout.getvalue())
+        self.assertEqual(stderr.getvalue(), "1 - 9\t1 - 8\t2 - 7\t")
+        self.assertEqual(exit_code, 1)
+
+    def test_version(self):
+        version = subprocess.check_output(
+            [sys.executable, "-m", "jsonschema", "--version"],
+            stderr=subprocess.STDOUT,
+        )
+        version = version.decode("utf-8").strip()
+        self.assertEqual(version, __version__)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..eae00d76d77dd10a69c248ee8450429574a91b18
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_exceptions.py
@@ -0,0 +1,462 @@
+from unittest import TestCase
+import textwrap
+
+from jsonschema import Draft4Validator, exceptions
+from jsonschema.compat import PY3
+
+
+class TestBestMatch(TestCase):
+    def best_match(self, errors):
+        errors = list(errors)
+        best = exceptions.best_match(errors)
+        reversed_best = exceptions.best_match(reversed(errors))
+        msg = "Didn't return a consistent best match!\nGot: {0}\n\nThen: {1}"
+        self.assertEqual(
+            best._contents(), reversed_best._contents(),
+            msg=msg.format(best, reversed_best),
+        )
+        return best
+
+    def test_shallower_errors_are_better_matches(self):
+        validator = Draft4Validator(
+            {
+                "properties": {
+                    "foo": {
+                        "minProperties": 2,
+                        "properties": {"bar": {"type": "object"}},
+                    },
+                },
+            },
+        )
+        best = self.best_match(validator.iter_errors({"foo": {"bar": []}}))
+        self.assertEqual(best.validator, "minProperties")
+
+    def test_oneOf_and_anyOf_are_weak_matches(self):
+        """
+        A property you *must* match is probably better than one you have to
+        match a part of.
+        """
+
+        validator = Draft4Validator(
+            {
+                "minProperties": 2,
+                "anyOf": [{"type": "string"}, {"type": "number"}],
+                "oneOf": [{"type": "string"}, {"type": "number"}],
+            }
+        )
+        best = self.best_match(validator.iter_errors({}))
+        self.assertEqual(best.validator, "minProperties")
+
+    def test_if_the_most_relevant_error_is_anyOf_it_is_traversed(self):
+        """
+        If the most relevant error is an anyOf, then we traverse its context
+        and select the otherwise *least* relevant error, since in this case
+        that means the most specific, deep, error inside the instance.
+
+        I.e. since only one of the schemas must match, we look for the most
+        relevant one.
+        """
+
+        validator = Draft4Validator(
+            {
+                "properties": {
+                    "foo": {
+                        "anyOf": [
+                            {"type": "string"},
+                            {"properties": {"bar": {"type": "array"}}},
+                        ],
+                    },
+                },
+            },
+        )
+        best = self.best_match(validator.iter_errors({"foo": {"bar": 12}}))
+        self.assertEqual(best.validator_value, "array")
+
+    def test_if_the_most_relevant_error_is_oneOf_it_is_traversed(self):
+        """
+        If the most relevant error is an oneOf, then we traverse its context
+        and select the otherwise *least* relevant error, since in this case
+        that means the most specific, deep, error inside the instance.
+
+        I.e. since only one of the schemas must match, we look for the most
+        relevant one.
+        """
+
+        validator = Draft4Validator(
+            {
+                "properties": {
+                    "foo": {
+                        "oneOf": [
+                            {"type": "string"},
+                            {"properties": {"bar": {"type": "array"}}},
+                        ],
+                    },
+                },
+            },
+        )
+        best = self.best_match(validator.iter_errors({"foo": {"bar": 12}}))
+        self.assertEqual(best.validator_value, "array")
+
+    def test_if_the_most_relevant_error_is_allOf_it_is_traversed(self):
+        """
+        Now, if the error is allOf, we traverse but select the *most* relevant
+        error from the context, because all schemas here must match anyways.
+        """
+
+        validator = Draft4Validator(
+            {
+                "properties": {
+                    "foo": {
+                        "allOf": [
+                            {"type": "string"},
+                            {"properties": {"bar": {"type": "array"}}},
+                        ],
+                    },
+                },
+            },
+        )
+        best = self.best_match(validator.iter_errors({"foo": {"bar": 12}}))
+        self.assertEqual(best.validator_value, "string")
+
+    def test_nested_context_for_oneOf(self):
+        validator = Draft4Validator(
+            {
+                "properties": {
+                    "foo": {
+                        "oneOf": [
+                            {"type": "string"},
+                            {
+                                "oneOf": [
+                                    {"type": "string"},
+                                    {
+                                        "properties": {
+                                            "bar": {"type": "array"},
+                                        },
+                                    },
+                                ],
+                            },
+                        ],
+                    },
+                },
+            },
+        )
+        best = self.best_match(validator.iter_errors({"foo": {"bar": 12}}))
+        self.assertEqual(best.validator_value, "array")
+
+    def test_one_error(self):
+        validator = Draft4Validator({"minProperties": 2})
+        error, = validator.iter_errors({})
+        self.assertEqual(
+            exceptions.best_match(validator.iter_errors({})).validator,
+            "minProperties",
+        )
+
+    def test_no_errors(self):
+        validator = Draft4Validator({})
+        self.assertIsNone(exceptions.best_match(validator.iter_errors({})))
+
+
+class TestByRelevance(TestCase):
+    def test_short_paths_are_better_matches(self):
+        shallow = exceptions.ValidationError("Oh no!", path=["baz"])
+        deep = exceptions.ValidationError("Oh yes!", path=["foo", "bar"])
+        match = max([shallow, deep], key=exceptions.relevance)
+        self.assertIs(match, shallow)
+
+        match = max([deep, shallow], key=exceptions.relevance)
+        self.assertIs(match, shallow)
+
+    def test_global_errors_are_even_better_matches(self):
+        shallow = exceptions.ValidationError("Oh no!", path=[])
+        deep = exceptions.ValidationError("Oh yes!", path=["foo"])
+
+        errors = sorted([shallow, deep], key=exceptions.relevance)
+        self.assertEqual(
+            [list(error.path) for error in errors],
+            [["foo"], []],
+        )
+
+        errors = sorted([deep, shallow], key=exceptions.relevance)
+        self.assertEqual(
+            [list(error.path) for error in errors],
+            [["foo"], []],
+        )
+
+    def test_weak_validators_are_lower_priority(self):
+        weak = exceptions.ValidationError("Oh no!", path=[], validator="a")
+        normal = exceptions.ValidationError("Oh yes!", path=[], validator="b")
+
+        best_match = exceptions.by_relevance(weak="a")
+
+        match = max([weak, normal], key=best_match)
+        self.assertIs(match, normal)
+
+        match = max([normal, weak], key=best_match)
+        self.assertIs(match, normal)
+
+    def test_strong_validators_are_higher_priority(self):
+        weak = exceptions.ValidationError("Oh no!", path=[], validator="a")
+        normal = exceptions.ValidationError("Oh yes!", path=[], validator="b")
+        strong = exceptions.ValidationError("Oh fine!", path=[], validator="c")
+
+        best_match = exceptions.by_relevance(weak="a", strong="c")
+
+        match = max([weak, normal, strong], key=best_match)
+        self.assertIs(match, strong)
+
+        match = max([strong, normal, weak], key=best_match)
+        self.assertIs(match, strong)
+
+
+class TestErrorTree(TestCase):
+    def test_it_knows_how_many_total_errors_it_contains(self):
+        # FIXME: https://github.com/Julian/jsonschema/issues/442
+        errors = [
+            exceptions.ValidationError("Something", validator=i)
+            for i in range(8)
+        ]
+        tree = exceptions.ErrorTree(errors)
+        self.assertEqual(tree.total_errors, 8)
+
+    def test_it_contains_an_item_if_the_item_had_an_error(self):
+        errors = [exceptions.ValidationError("a message", path=["bar"])]
+        tree = exceptions.ErrorTree(errors)
+        self.assertIn("bar", tree)
+
+    def test_it_does_not_contain_an_item_if_the_item_had_no_error(self):
+        errors = [exceptions.ValidationError("a message", path=["bar"])]
+        tree = exceptions.ErrorTree(errors)
+        self.assertNotIn("foo", tree)
+
+    def test_validators_that_failed_appear_in_errors_dict(self):
+        error = exceptions.ValidationError("a message", validator="foo")
+        tree = exceptions.ErrorTree([error])
+        self.assertEqual(tree.errors, {"foo": error})
+
+    def test_it_creates_a_child_tree_for_each_nested_path(self):
+        errors = [
+            exceptions.ValidationError("a bar message", path=["bar"]),
+            exceptions.ValidationError("a bar -> 0 message", path=["bar", 0]),
+        ]
+        tree = exceptions.ErrorTree(errors)
+        self.assertIn(0, tree["bar"])
+        self.assertNotIn(1, tree["bar"])
+
+    def test_children_have_their_errors_dicts_built(self):
+        e1, e2 = (
+            exceptions.ValidationError("1", validator="foo", path=["bar", 0]),
+            exceptions.ValidationError("2", validator="quux", path=["bar", 0]),
+        )
+        tree = exceptions.ErrorTree([e1, e2])
+        self.assertEqual(tree["bar"][0].errors, {"foo": e1, "quux": e2})
+
+    def test_multiple_errors_with_instance(self):
+        e1, e2 = (
+            exceptions.ValidationError(
+                "1",
+                validator="foo",
+                path=["bar", "bar2"],
+                instance="i1"),
+            exceptions.ValidationError(
+                "2",
+                validator="quux",
+                path=["foobar", 2],
+                instance="i2"),
+        )
+        exceptions.ErrorTree([e1, e2])
+
+    def test_it_does_not_contain_subtrees_that_are_not_in_the_instance(self):
+        error = exceptions.ValidationError("123", validator="foo", instance=[])
+        tree = exceptions.ErrorTree([error])
+
+        with self.assertRaises(IndexError):
+            tree[0]
+
+    def test_if_its_in_the_tree_anyhow_it_does_not_raise_an_error(self):
+        """
+        If a validator is dumb (like :validator:`required` in draft 3) and
+        refers to a path that isn't in the instance, the tree still properly
+        returns a subtree for that path.
+        """
+
+        error = exceptions.ValidationError(
+            "a message", validator="foo", instance={}, path=["foo"],
+        )
+        tree = exceptions.ErrorTree([error])
+        self.assertIsInstance(tree["foo"], exceptions.ErrorTree)
+
+
+class TestErrorInitReprStr(TestCase):
+    def make_error(self, **kwargs):
+        defaults = dict(
+            message=u"hello",
+            validator=u"type",
+            validator_value=u"string",
+            instance=5,
+            schema={u"type": u"string"},
+        )
+        defaults.update(kwargs)
+        return exceptions.ValidationError(**defaults)
+
+    def assertShows(self, expected, **kwargs):
+        if PY3:  # pragma: no cover
+            expected = expected.replace("u'", "'")
+        expected = textwrap.dedent(expected).rstrip("\n")
+
+        error = self.make_error(**kwargs)
+        message_line, _, rest = str(error).partition("\n")
+        self.assertEqual(message_line, error.message)
+        self.assertEqual(rest, expected)
+
+    def test_it_calls_super_and_sets_args(self):
+        error = self.make_error()
+        self.assertGreater(len(error.args), 1)
+
+    def test_repr(self):
+        self.assertEqual(
+            repr(exceptions.ValidationError(message="Hello!")),
+            "<ValidationError: %r>" % "Hello!",
+        )
+
+    def test_unset_error(self):
+        error = exceptions.ValidationError("message")
+        self.assertEqual(str(error), "message")
+
+        kwargs = {
+            "validator": "type",
+            "validator_value": "string",
+            "instance": 5,
+            "schema": {"type": "string"},
+        }
+        # Just the message should show if any of the attributes are unset
+        for attr in kwargs:
+            k = dict(kwargs)
+            del k[attr]
+            error = exceptions.ValidationError("message", **k)
+            self.assertEqual(str(error), "message")
+
+    def test_empty_paths(self):
+        self.assertShows(
+            """
+            Failed validating u'type' in schema:
+                {u'type': u'string'}
+
+            On instance:
+                5
+            """,
+            path=[],
+            schema_path=[],
+        )
+
+    def test_one_item_paths(self):
+        self.assertShows(
+            """
+            Failed validating u'type' in schema:
+                {u'type': u'string'}
+
+            On instance[0]:
+                5
+            """,
+            path=[0],
+            schema_path=["items"],
+        )
+
+    def test_multiple_item_paths(self):
+        self.assertShows(
+            """
+            Failed validating u'type' in schema[u'items'][0]:
+                {u'type': u'string'}
+
+            On instance[0][u'a']:
+                5
+            """,
+            path=[0, u"a"],
+            schema_path=[u"items", 0, 1],
+        )
+
+    def test_uses_pprint(self):
+        self.assertShows(
+            """
+            Failed validating u'maxLength' in schema:
+                {0: 0,
+                 1: 1,
+                 2: 2,
+                 3: 3,
+                 4: 4,
+                 5: 5,
+                 6: 6,
+                 7: 7,
+                 8: 8,
+                 9: 9,
+                 10: 10,
+                 11: 11,
+                 12: 12,
+                 13: 13,
+                 14: 14,
+                 15: 15,
+                 16: 16,
+                 17: 17,
+                 18: 18,
+                 19: 19}
+
+            On instance:
+                [0,
+                 1,
+                 2,
+                 3,
+                 4,
+                 5,
+                 6,
+                 7,
+                 8,
+                 9,
+                 10,
+                 11,
+                 12,
+                 13,
+                 14,
+                 15,
+                 16,
+                 17,
+                 18,
+                 19,
+                 20,
+                 21,
+                 22,
+                 23,
+                 24]
+            """,
+            instance=list(range(25)),
+            schema=dict(zip(range(20), range(20))),
+            validator=u"maxLength",
+        )
+
+    def test_str_works_with_instances_having_overriden_eq_operator(self):
+        """
+        Check for https://github.com/Julian/jsonschema/issues/164 which
+        rendered exceptions unusable when a `ValidationError` involved
+        instances with an `__eq__` method that returned truthy values.
+        """
+
+        class DontEQMeBro(object):
+            def __eq__(this, other):  # pragma: no cover
+                self.fail("Don't!")
+
+            def __ne__(this, other):  # pragma: no cover
+                self.fail("Don't!")
+
+        instance = DontEQMeBro()
+        error = exceptions.ValidationError(
+            "a message",
+            validator="foo",
+            instance=instance,
+            validator_value="some",
+            schema="schema",
+        )
+        self.assertIn(repr(instance), str(error))
+
+
+class TestHashable(TestCase):
+    def test_hashable(self):
+        set([exceptions.ValidationError("")])
+        set([exceptions.SchemaError("")])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_format.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_format.py
new file mode 100644
index 0000000000000000000000000000000000000000..254985f6156ad56a52b9a5aae10e6ce1ce0e27b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_format.py
@@ -0,0 +1,89 @@
+"""
+Tests for the parts of jsonschema related to the :validator:`format` property.
+"""
+
+from unittest import TestCase
+
+from jsonschema import FormatError, ValidationError, FormatChecker
+from jsonschema.validators import Draft4Validator
+
+
+BOOM = ValueError("Boom!")
+BANG = ZeroDivisionError("Bang!")
+
+
+def boom(thing):
+    if thing == "bang":
+        raise BANG
+    raise BOOM
+
+
+class TestFormatChecker(TestCase):
+    def test_it_can_validate_no_formats(self):
+        checker = FormatChecker(formats=())
+        self.assertFalse(checker.checkers)
+
+    def test_it_raises_a_key_error_for_unknown_formats(self):
+        with self.assertRaises(KeyError):
+            FormatChecker(formats=["o noes"])
+
+    def test_it_can_register_cls_checkers(self):
+        original = dict(FormatChecker.checkers)
+        self.addCleanup(FormatChecker.checkers.pop, "boom")
+        FormatChecker.cls_checks("boom")(boom)
+        self.assertEqual(
+            FormatChecker.checkers,
+            dict(original, boom=(boom, ())),
+        )
+
+    def test_it_can_register_checkers(self):
+        checker = FormatChecker()
+        checker.checks("boom")(boom)
+        self.assertEqual(
+            checker.checkers,
+            dict(FormatChecker.checkers, boom=(boom, ()))
+        )
+
+    def test_it_catches_registered_errors(self):
+        checker = FormatChecker()
+        checker.checks("boom", raises=type(BOOM))(boom)
+
+        with self.assertRaises(FormatError) as cm:
+            checker.check(instance=12, format="boom")
+
+        self.assertIs(cm.exception.cause, BOOM)
+        self.assertIs(cm.exception.__cause__, BOOM)
+
+        # Unregistered errors should not be caught
+        with self.assertRaises(type(BANG)):
+            checker.check(instance="bang", format="boom")
+
+    def test_format_error_causes_become_validation_error_causes(self):
+        checker = FormatChecker()
+        checker.checks("boom", raises=ValueError)(boom)
+        validator = Draft4Validator({"format": "boom"}, format_checker=checker)
+
+        with self.assertRaises(ValidationError) as cm:
+            validator.validate("BOOM")
+
+        self.assertIs(cm.exception.cause, BOOM)
+        self.assertIs(cm.exception.__cause__, BOOM)
+
+    def test_format_checkers_come_with_defaults(self):
+        # This is bad :/ but relied upon.
+        # The docs for quite awhile recommended people do things like
+        # validate(..., format_checker=FormatChecker())
+        # We should change that, but we can't without deprecation...
+        checker = FormatChecker()
+        with self.assertRaises(FormatError):
+            checker.check(instance="not-an-ipv4", format="ipv4")
+
+    def test_repr(self):
+        checker = FormatChecker(formats=())
+        checker.checks("foo")(lambda thing: True)
+        checker.checks("bar")(lambda thing: True)
+        checker.checks("baz")(lambda thing: True)
+        self.assertEqual(
+            repr(checker),
+            "<FormatChecker checkers=['bar', 'baz', 'foo']>",
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_jsonschema_test_suite.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_jsonschema_test_suite.py
new file mode 100644
index 0000000000000000000000000000000000000000..ebccf29735a557e8aa0a8f953aaab38f6a907f4d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_jsonschema_test_suite.py
@@ -0,0 +1,277 @@
+"""
+Test runner for the JSON Schema official test suite
+
+Tests comprehensive correctness of each draft's validator.
+
+See https://github.com/json-schema-org/JSON-Schema-Test-Suite for details.
+"""
+
+import sys
+import warnings
+
+from jsonschema import (
+    Draft3Validator,
+    Draft4Validator,
+    Draft6Validator,
+    Draft7Validator,
+    draft3_format_checker,
+    draft4_format_checker,
+    draft6_format_checker,
+    draft7_format_checker,
+)
+from jsonschema.tests._helpers import bug
+from jsonschema.tests._suite import Suite
+from jsonschema.validators import _DEPRECATED_DEFAULT_TYPES, create
+
+
+SUITE = Suite()
+DRAFT3 = SUITE.version(name="draft3")
+DRAFT4 = SUITE.version(name="draft4")
+DRAFT6 = SUITE.version(name="draft6")
+DRAFT7 = SUITE.version(name="draft7")
+
+
+def skip(message, **kwargs):
+    def skipper(test):
+        if all(value == getattr(test, attr) for attr, value in kwargs.items()):
+            return message
+    return skipper
+
+
+def missing_format(checker):
+    def missing_format(test):
+        schema = test.schema
+        if schema is True or schema is False or "format" not in schema:
+            return
+
+        if schema["format"] not in checker.checkers:
+            return "Format checker {0!r} not found.".format(schema["format"])
+    return missing_format
+
+
+is_narrow_build = sys.maxunicode == 2 ** 16 - 1
+if is_narrow_build:  # pragma: no cover
+    message = "Not running surrogate Unicode case, this Python is narrow."
+
+    def narrow_unicode_build(test):  # pragma: no cover
+        return skip(
+            message=message,
+            description="one supplementary Unicode code point is not long enough",
+        )(test) or skip(
+            message=message,
+            description="two supplementary Unicode code points is long enough",
+        )(test)
+else:
+    def narrow_unicode_build(test):  # pragma: no cover
+        return
+
+
+TestDraft3 = DRAFT3.to_unittest_testcase(
+    DRAFT3.tests(),
+    DRAFT3.optional_tests_of(name="bignum"),
+    DRAFT3.optional_tests_of(name="format"),
+    DRAFT3.optional_tests_of(name="zeroTerminatedFloats"),
+    Validator=Draft3Validator,
+    format_checker=draft3_format_checker,
+    skip=lambda test: (
+        narrow_unicode_build(test)
+        or missing_format(draft3_format_checker)(test)
+        or skip(
+            message="Upstream bug in strict_rfc3339",
+            subject="format",
+            description="case-insensitive T and Z",
+        )(test)
+    ),
+)
+
+
+TestDraft4 = DRAFT4.to_unittest_testcase(
+    DRAFT4.tests(),
+    DRAFT4.optional_tests_of(name="bignum"),
+    DRAFT4.optional_tests_of(name="format"),
+    DRAFT4.optional_tests_of(name="zeroTerminatedFloats"),
+    Validator=Draft4Validator,
+    format_checker=draft4_format_checker,
+    skip=lambda test: (
+        narrow_unicode_build(test)
+        or missing_format(draft4_format_checker)(test)
+        or skip(
+            message=bug(),
+            subject="ref",
+            case_description="Recursive references between schemas",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description="Location-independent identifier",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with absolute URI"
+            ),
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with base URI change in subschema"
+            ),
+        )(test)
+        or skip(
+            message=bug(),
+            subject="refRemote",
+            case_description="base URI change - change folder in subschema",
+        )(test)
+        or skip(
+            message="Upstream bug in strict_rfc3339",
+            subject="format",
+            description="case-insensitive T and Z",
+        )(test)
+    ),
+)
+
+
+TestDraft6 = DRAFT6.to_unittest_testcase(
+    DRAFT6.tests(),
+    DRAFT6.optional_tests_of(name="bignum"),
+    DRAFT6.optional_tests_of(name="format"),
+    DRAFT6.optional_tests_of(name="zeroTerminatedFloats"),
+    Validator=Draft6Validator,
+    format_checker=draft6_format_checker,
+    skip=lambda test: (
+        narrow_unicode_build(test)
+        or missing_format(draft6_format_checker)(test)
+        or skip(
+            message=bug(),
+            subject="ref",
+            case_description="Recursive references between schemas",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description="Location-independent identifier",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with absolute URI"
+            ),
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with base URI change in subschema"
+            ),
+        )(test)
+        or skip(
+            message=bug(),
+            subject="refRemote",
+            case_description="base URI change - change folder in subschema",
+        )(test)
+        or skip(
+            message="Upstream bug in strict_rfc3339",
+            subject="format",
+            description="case-insensitive T and Z",
+        )(test)
+    ),
+)
+
+
+TestDraft7 = DRAFT7.to_unittest_testcase(
+    DRAFT7.tests(),
+    DRAFT7.format_tests(),
+    DRAFT7.optional_tests_of(name="bignum"),
+    DRAFT7.optional_tests_of(name="content"),
+    DRAFT7.optional_tests_of(name="zeroTerminatedFloats"),
+    Validator=Draft7Validator,
+    format_checker=draft7_format_checker,
+    skip=lambda test: (
+        narrow_unicode_build(test)
+        or missing_format(draft7_format_checker)(test)
+        or skip(
+            message=bug(),
+            subject="ref",
+            case_description="Recursive references between schemas",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description="Location-independent identifier",
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with absolute URI"
+            ),
+        )(test)
+        or skip(
+            message=bug(371),
+            subject="ref",
+            case_description=(
+                "Location-independent identifier with base URI change in subschema"
+            ),
+        )(test)
+        or skip(
+            message=bug(),
+            subject="refRemote",
+            case_description="base URI change - change folder in subschema",
+        )(test)
+        or skip(
+            message="Upstream bug in strict_rfc3339",
+            subject="date-time",
+            description="case-insensitive T and Z",
+        )(test)
+        or skip(
+            message=bug(593),
+            subject="content",
+            case_description=(
+                "validation of string-encoded content based on media type"
+            ),
+        )(test)
+        or skip(
+            message=bug(593),
+            subject="content",
+            case_description="validation of binary string-encoding",
+        )(test)
+        or skip(
+            message=bug(593),
+            subject="content",
+            case_description=(
+                "validation of binary-encoded media type documents"
+            ),
+        )(test)
+    ),
+)
+
+
+with warnings.catch_warnings():
+    warnings.simplefilter("ignore", DeprecationWarning)
+
+    TestDraft3LegacyTypeCheck = DRAFT3.to_unittest_testcase(
+        # Interestingly the any part couldn't really be done w/the old API.
+        (
+            (test for test in each if test.schema != {"type": "any"})
+            for each in DRAFT3.tests_of(name="type")
+        ),
+        name="TestDraft3LegacyTypeCheck",
+        Validator=create(
+            meta_schema=Draft3Validator.META_SCHEMA,
+            validators=Draft3Validator.VALIDATORS,
+            default_types=_DEPRECATED_DEFAULT_TYPES,
+        ),
+    )
+
+    TestDraft4LegacyTypeCheck = DRAFT4.to_unittest_testcase(
+        DRAFT4.tests_of(name="type"),
+        name="TestDraft4LegacyTypeCheck",
+        Validator=create(
+            meta_schema=Draft4Validator.META_SCHEMA,
+            validators=Draft4Validator.VALIDATORS,
+            default_types=_DEPRECATED_DEFAULT_TYPES,
+        ),
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_types.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..2280cc395b22faf60cae59ea1ad1591f614ae5a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_types.py
@@ -0,0 +1,190 @@
+"""
+Tests on the new type interface. The actual correctness of the type checking
+is handled in test_jsonschema_test_suite; these tests check that TypeChecker
+functions correctly and can facilitate extensions to type checking
+"""
+from collections import namedtuple
+from unittest import TestCase
+
+from jsonschema import ValidationError, _validators
+from jsonschema._types import TypeChecker
+from jsonschema.exceptions import UndefinedTypeCheck
+from jsonschema.validators import Draft4Validator, extend
+
+
+def equals_2(checker, instance):
+    return instance == 2
+
+
+def is_namedtuple(instance):
+    return isinstance(instance, tuple) and getattr(instance, "_fields", None)
+
+
+def is_object_or_named_tuple(checker, instance):
+    if Draft4Validator.TYPE_CHECKER.is_type(instance, "object"):
+        return True
+    return is_namedtuple(instance)
+
+
+def coerce_named_tuple(fn):
+    def coerced(validator, value, instance, schema):
+        if is_namedtuple(instance):
+            instance = instance._asdict()
+        return fn(validator, value, instance, schema)
+    return coerced
+
+
+required = coerce_named_tuple(_validators.required)
+properties = coerce_named_tuple(_validators.properties)
+
+
+class TestTypeChecker(TestCase):
+    def test_is_type(self):
+        checker = TypeChecker({"two": equals_2})
+        self.assertEqual(
+            (
+                checker.is_type(instance=2, type="two"),
+                checker.is_type(instance="bar", type="two"),
+            ),
+            (True, False),
+        )
+
+    def test_is_unknown_type(self):
+        with self.assertRaises(UndefinedTypeCheck) as context:
+            TypeChecker().is_type(4, "foobar")
+        self.assertIn("foobar", str(context.exception))
+
+    def test_checks_can_be_added_at_init(self):
+        checker = TypeChecker({"two": equals_2})
+        self.assertEqual(checker, TypeChecker().redefine("two", equals_2))
+
+    def test_redefine_existing_type(self):
+        self.assertEqual(
+            TypeChecker().redefine("two", object()).redefine("two", equals_2),
+            TypeChecker().redefine("two", equals_2),
+        )
+
+    def test_remove(self):
+        self.assertEqual(
+            TypeChecker({"two": equals_2}).remove("two"),
+            TypeChecker(),
+        )
+
+    def test_remove_unknown_type(self):
+        with self.assertRaises(UndefinedTypeCheck) as context:
+            TypeChecker().remove("foobar")
+        self.assertIn("foobar", str(context.exception))
+
+    def test_redefine_many(self):
+        self.assertEqual(
+            TypeChecker().redefine_many({"foo": int, "bar": str}),
+            TypeChecker().redefine("foo", int).redefine("bar", str),
+        )
+
+    def test_remove_multiple(self):
+        self.assertEqual(
+            TypeChecker({"foo": int, "bar": str}).remove("foo", "bar"),
+            TypeChecker(),
+        )
+
+    def test_type_check_can_raise_key_error(self):
+        """
+        Make sure no one writes:
+
+            try:
+                self._type_checkers[type](...)
+            except KeyError:
+
+        ignoring the fact that the function itself can raise that.
+        """
+
+        error = KeyError("Stuff")
+
+        def raises_keyerror(checker, instance):
+            raise error
+
+        with self.assertRaises(KeyError) as context:
+            TypeChecker({"foo": raises_keyerror}).is_type(4, "foo")
+
+        self.assertIs(context.exception, error)
+
+
+class TestCustomTypes(TestCase):
+    def test_simple_type_can_be_extended(self):
+        def int_or_str_int(checker, instance):
+            if not isinstance(instance, (int, str)):
+                return False
+            try:
+                int(instance)
+            except ValueError:
+                return False
+            return True
+
+        CustomValidator = extend(
+            Draft4Validator,
+            type_checker=Draft4Validator.TYPE_CHECKER.redefine(
+                "integer", int_or_str_int,
+            ),
+        )
+        validator = CustomValidator({"type": "integer"})
+
+        validator.validate(4)
+        validator.validate("4")
+
+        with self.assertRaises(ValidationError):
+            validator.validate(4.4)
+
+    def test_object_can_be_extended(self):
+        schema = {"type": "object"}
+
+        Point = namedtuple("Point", ["x", "y"])
+
+        type_checker = Draft4Validator.TYPE_CHECKER.redefine(
+            u"object", is_object_or_named_tuple,
+        )
+
+        CustomValidator = extend(Draft4Validator, type_checker=type_checker)
+        validator = CustomValidator(schema)
+
+        validator.validate(Point(x=4, y=5))
+
+    def test_object_extensions_require_custom_validators(self):
+        schema = {"type": "object", "required": ["x"]}
+
+        type_checker = Draft4Validator.TYPE_CHECKER.redefine(
+            u"object", is_object_or_named_tuple,
+        )
+
+        CustomValidator = extend(Draft4Validator, type_checker=type_checker)
+        validator = CustomValidator(schema)
+
+        Point = namedtuple("Point", ["x", "y"])
+        # Cannot handle required
+        with self.assertRaises(ValidationError):
+            validator.validate(Point(x=4, y=5))
+
+    def test_object_extensions_can_handle_custom_validators(self):
+        schema = {
+            "type": "object",
+            "required": ["x"],
+            "properties": {"x": {"type": "integer"}},
+        }
+
+        type_checker = Draft4Validator.TYPE_CHECKER.redefine(
+            u"object", is_object_or_named_tuple,
+        )
+
+        CustomValidator = extend(
+            Draft4Validator,
+            type_checker=type_checker,
+            validators={"required": required, "properties": properties},
+        )
+
+        validator = CustomValidator(schema)
+
+        Point = namedtuple("Point", ["x", "y"])
+        # Can now process required and properties
+        validator.validate(Point(x=4, y=5))
+
+        with self.assertRaises(ValidationError):
+            validator.validate(Point(x="not an integer", y=5))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_validators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..07be4f08bc2e4ff09c4b60affbc7e6b78ecd508a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/tests/test_validators.py
@@ -0,0 +1,1762 @@
+from collections import deque
+from contextlib import contextmanager
+from decimal import Decimal
+from io import BytesIO
+from unittest import TestCase
+import json
+import os
+import sys
+import tempfile
+import unittest
+
+from twisted.trial.unittest import SynchronousTestCase
+import attr
+
+from jsonschema import FormatChecker, TypeChecker, exceptions, validators
+from jsonschema.compat import PY3, pathname2url
+from jsonschema.tests._helpers import bug
+
+
+def startswith(validator, startswith, instance, schema):
+    if not instance.startswith(startswith):
+        yield exceptions.ValidationError(u"Whoops!")
+
+
+class TestCreateAndExtend(SynchronousTestCase):
+    def setUp(self):
+        self.addCleanup(
+            self.assertEqual,
+            validators.meta_schemas,
+            dict(validators.meta_schemas),
+        )
+
+        self.meta_schema = {u"$id": "some://meta/schema"}
+        self.validators = {u"startswith": startswith}
+        self.type_checker = TypeChecker()
+        self.Validator = validators.create(
+            meta_schema=self.meta_schema,
+            validators=self.validators,
+            type_checker=self.type_checker,
+        )
+
+    def test_attrs(self):
+        self.assertEqual(
+            (
+                self.Validator.VALIDATORS,
+                self.Validator.META_SCHEMA,
+                self.Validator.TYPE_CHECKER,
+            ), (
+                self.validators,
+                self.meta_schema,
+                self.type_checker,
+            ),
+        )
+
+    def test_init(self):
+        schema = {u"startswith": u"foo"}
+        self.assertEqual(self.Validator(schema).schema, schema)
+
+    def test_iter_errors(self):
+        schema = {u"startswith": u"hel"}
+        iter_errors = self.Validator(schema).iter_errors
+
+        errors = list(iter_errors(u"hello"))
+        self.assertEqual(errors, [])
+
+        expected_error = exceptions.ValidationError(
+            u"Whoops!",
+            instance=u"goodbye",
+            schema=schema,
+            validator=u"startswith",
+            validator_value=u"hel",
+            schema_path=deque([u"startswith"]),
+        )
+
+        errors = list(iter_errors(u"goodbye"))
+        self.assertEqual(len(errors), 1)
+        self.assertEqual(errors[0]._contents(), expected_error._contents())
+
+    def test_if_a_version_is_provided_it_is_registered(self):
+        Validator = validators.create(
+            meta_schema={u"$id": "something"},
+            version="my version",
+        )
+        self.addCleanup(validators.meta_schemas.pop, "something")
+        self.assertEqual(Validator.__name__, "MyVersionValidator")
+
+    def test_if_a_version_is_not_provided_it_is_not_registered(self):
+        original = dict(validators.meta_schemas)
+        validators.create(meta_schema={u"id": "id"})
+        self.assertEqual(validators.meta_schemas, original)
+
+    def test_validates_registers_meta_schema_id(self):
+        meta_schema_key = "meta schema id"
+        my_meta_schema = {u"id": meta_schema_key}
+
+        validators.create(
+            meta_schema=my_meta_schema,
+            version="my version",
+            id_of=lambda s: s.get("id", ""),
+        )
+        self.addCleanup(validators.meta_schemas.pop, meta_schema_key)
+
+        self.assertIn(meta_schema_key, validators.meta_schemas)
+
+    def test_validates_registers_meta_schema_draft6_id(self):
+        meta_schema_key = "meta schema $id"
+        my_meta_schema = {u"$id": meta_schema_key}
+
+        validators.create(
+            meta_schema=my_meta_schema,
+            version="my version",
+        )
+        self.addCleanup(validators.meta_schemas.pop, meta_schema_key)
+
+        self.assertIn(meta_schema_key, validators.meta_schemas)
+
+    def test_create_default_types(self):
+        Validator = validators.create(meta_schema={}, validators=())
+        self.assertTrue(
+            all(
+                Validator({}).is_type(instance=instance, type=type)
+                for type, instance in [
+                    (u"array", []),
+                    (u"boolean", True),
+                    (u"integer", 12),
+                    (u"null", None),
+                    (u"number", 12.0),
+                    (u"object", {}),
+                    (u"string", u"foo"),
+                ]
+            ),
+        )
+
+    def test_extend(self):
+        original = dict(self.Validator.VALIDATORS)
+        new = object()
+
+        Extended = validators.extend(
+            self.Validator,
+            validators={u"new": new},
+        )
+        self.assertEqual(
+            (
+                Extended.VALIDATORS,
+                Extended.META_SCHEMA,
+                Extended.TYPE_CHECKER,
+                self.Validator.VALIDATORS,
+            ), (
+                dict(original, new=new),
+                self.Validator.META_SCHEMA,
+                self.Validator.TYPE_CHECKER,
+                original,
+            ),
+        )
+
+    def test_extend_idof(self):
+        """
+        Extending a validator preserves its notion of schema IDs.
+        """
+        def id_of(schema):
+            return schema.get(u"__test__", self.Validator.ID_OF(schema))
+        correct_id = "the://correct/id/"
+        meta_schema = {
+            u"$id": "the://wrong/id/",
+            u"__test__": correct_id,
+        }
+        Original = validators.create(
+            meta_schema=meta_schema,
+            validators=self.validators,
+            type_checker=self.type_checker,
+            id_of=id_of,
+        )
+        self.assertEqual(Original.ID_OF(Original.META_SCHEMA), correct_id)
+
+        Derived = validators.extend(Original)
+        self.assertEqual(Derived.ID_OF(Derived.META_SCHEMA), correct_id)
+
+
+class TestLegacyTypeChecking(SynchronousTestCase):
+    def test_create_default_types(self):
+        Validator = validators.create(meta_schema={}, validators=())
+        self.assertEqual(
+            set(Validator.DEFAULT_TYPES), {
+                u"array",
+                u"boolean",
+                u"integer",
+                u"null",
+                u"number",
+                u"object", u"string",
+            },
+        )
+        self.flushWarnings()
+
+    def test_extend(self):
+        Validator = validators.create(meta_schema={}, validators=())
+        original = dict(Validator.VALIDATORS)
+        new = object()
+
+        Extended = validators.extend(
+            Validator,
+            validators={u"new": new},
+        )
+        self.assertEqual(
+            (
+                Extended.VALIDATORS,
+                Extended.META_SCHEMA,
+                Extended.TYPE_CHECKER,
+                Validator.VALIDATORS,
+
+                Extended.DEFAULT_TYPES,
+                Extended({}).DEFAULT_TYPES,
+                self.flushWarnings()[0]["message"],
+            ), (
+                dict(original, new=new),
+                Validator.META_SCHEMA,
+                Validator.TYPE_CHECKER,
+                original,
+
+                Validator.DEFAULT_TYPES,
+                Validator.DEFAULT_TYPES,
+                self.flushWarnings()[0]["message"],
+            ),
+        )
+
+    def test_types_redefines_the_validators_type_checker(self):
+        schema = {"type": "string"}
+        self.assertFalse(validators.Draft7Validator(schema).is_valid(12))
+
+        validator = validators.Draft7Validator(
+            schema,
+            types={"string": (str, int)},
+        )
+        self.assertTrue(validator.is_valid(12))
+        self.flushWarnings()
+
+    def test_providing_default_types_warns(self):
+        self.assertWarns(
+            category=DeprecationWarning,
+            message=(
+                "The default_types argument is deprecated. "
+                "Use the type_checker argument instead."
+            ),
+            # https://tm.tl/9363 :'(
+            filename=sys.modules[self.assertWarns.__module__].__file__,
+
+            f=validators.create,
+            meta_schema={},
+            validators={},
+            default_types={"foo": object},
+        )
+
+    def test_cannot_ask_for_default_types_with_non_default_type_checker(self):
+        """
+        We raise an error when you ask a validator with non-default
+        type checker for its DEFAULT_TYPES.
+
+        The type checker argument is new, so no one but this library
+        itself should be trying to use it, and doing so while then
+        asking for DEFAULT_TYPES makes no sense (not to mention is
+        deprecated), since type checkers are not strictly about Python
+        type.
+        """
+        Validator = validators.create(
+            meta_schema={},
+            validators={},
+            type_checker=TypeChecker(),
+        )
+        with self.assertRaises(validators._DontDoThat) as e:
+            Validator.DEFAULT_TYPES
+
+        self.assertIn(
+            "DEFAULT_TYPES cannot be used on Validators using TypeCheckers",
+            str(e.exception),
+        )
+        with self.assertRaises(validators._DontDoThat):
+            Validator({}).DEFAULT_TYPES
+
+        self.assertFalse(self.flushWarnings())
+
+    def test_providing_explicit_type_checker_does_not_warn(self):
+        Validator = validators.create(
+            meta_schema={},
+            validators={},
+            type_checker=TypeChecker(),
+        )
+        self.assertFalse(self.flushWarnings())
+
+        Validator({})
+        self.assertFalse(self.flushWarnings())
+
+    def test_providing_neither_does_not_warn(self):
+        Validator = validators.create(meta_schema={}, validators={})
+        self.assertFalse(self.flushWarnings())
+
+        Validator({})
+        self.assertFalse(self.flushWarnings())
+
+    def test_providing_default_types_with_type_checker_errors(self):
+        with self.assertRaises(TypeError) as e:
+            validators.create(
+                meta_schema={},
+                validators={},
+                default_types={"foo": object},
+                type_checker=TypeChecker(),
+            )
+
+        self.assertIn(
+            "Do not specify default_types when providing a type checker",
+            str(e.exception),
+        )
+        self.assertFalse(self.flushWarnings())
+
+    def test_extending_a_legacy_validator_with_a_type_checker_errors(self):
+        Validator = validators.create(
+            meta_schema={},
+            validators={},
+            default_types={u"array": list}
+        )
+        with self.assertRaises(TypeError) as e:
+            validators.extend(
+                Validator,
+                validators={},
+                type_checker=TypeChecker(),
+            )
+
+        self.assertIn(
+            (
+                "Cannot extend a validator created with default_types "
+                "with a type_checker. Update the validator to use a "
+                "type_checker when created."
+            ),
+            str(e.exception),
+        )
+        self.flushWarnings()
+
+    def test_extending_a_legacy_validator_does_not_rewarn(self):
+        Validator = validators.create(meta_schema={}, default_types={})
+        self.assertTrue(self.flushWarnings())
+
+        validators.extend(Validator)
+        self.assertFalse(self.flushWarnings())
+
+    def test_accessing_default_types_warns(self):
+        Validator = validators.create(meta_schema={}, validators={})
+        self.assertFalse(self.flushWarnings())
+
+        self.assertWarns(
+            DeprecationWarning,
+            (
+                "The DEFAULT_TYPES attribute is deprecated. "
+                "See the type checker attached to this validator instead."
+            ),
+            # https://tm.tl/9363 :'(
+            sys.modules[self.assertWarns.__module__].__file__,
+
+            getattr,
+            Validator,
+            "DEFAULT_TYPES",
+        )
+
+    def test_accessing_default_types_on_the_instance_warns(self):
+        Validator = validators.create(meta_schema={}, validators={})
+        self.assertFalse(self.flushWarnings())
+
+        self.assertWarns(
+            DeprecationWarning,
+            (
+                "The DEFAULT_TYPES attribute is deprecated. "
+                "See the type checker attached to this validator instead."
+            ),
+            # https://tm.tl/9363 :'(
+            sys.modules[self.assertWarns.__module__].__file__,
+
+            getattr,
+            Validator({}),
+            "DEFAULT_TYPES",
+        )
+
+    def test_providing_types_to_init_warns(self):
+        Validator = validators.create(meta_schema={}, validators={})
+        self.assertFalse(self.flushWarnings())
+
+        self.assertWarns(
+            category=DeprecationWarning,
+            message=(
+                "The types argument is deprecated. "
+                "Provide a type_checker to jsonschema.validators.extend "
+                "instead."
+            ),
+            # https://tm.tl/9363 :'(
+            filename=sys.modules[self.assertWarns.__module__].__file__,
+
+            f=Validator,
+            schema={},
+            types={"bar": object},
+        )
+
+
+class TestIterErrors(TestCase):
+    def setUp(self):
+        self.validator = validators.Draft3Validator({})
+
+    def test_iter_errors(self):
+        instance = [1, 2]
+        schema = {
+            u"disallow": u"array",
+            u"enum": [["a", "b", "c"], ["d", "e", "f"]],
+            u"minItems": 3,
+        }
+
+        got = (e.message for e in self.validator.iter_errors(instance, schema))
+        expected = [
+            "%r is disallowed for [1, 2]" % (schema["disallow"],),
+            "[1, 2] is too short",
+            "[1, 2] is not one of %r" % (schema["enum"],),
+        ]
+        self.assertEqual(sorted(got), sorted(expected))
+
+    def test_iter_errors_multiple_failures_one_validator(self):
+        instance = {"foo": 2, "bar": [1], "baz": 15, "quux": "spam"}
+        schema = {
+            u"properties": {
+                "foo": {u"type": "string"},
+                "bar": {u"minItems": 2},
+                "baz": {u"maximum": 10, u"enum": [2, 4, 6, 8]},
+            },
+        }
+
+        errors = list(self.validator.iter_errors(instance, schema))
+        self.assertEqual(len(errors), 4)
+
+
+class TestValidationErrorMessages(TestCase):
+    def message_for(self, instance, schema, *args, **kwargs):
+        kwargs.setdefault("cls", validators.Draft3Validator)
+        with self.assertRaises(exceptions.ValidationError) as e:
+            validators.validate(instance, schema, *args, **kwargs)
+        return e.exception.message
+
+    def test_single_type_failure(self):
+        message = self.message_for(instance=1, schema={u"type": u"string"})
+        self.assertEqual(message, "1 is not of type %r" % u"string")
+
+    def test_single_type_list_failure(self):
+        message = self.message_for(instance=1, schema={u"type": [u"string"]})
+        self.assertEqual(message, "1 is not of type %r" % u"string")
+
+    def test_multiple_type_failure(self):
+        types = u"string", u"object"
+        message = self.message_for(instance=1, schema={u"type": list(types)})
+        self.assertEqual(message, "1 is not of type %r, %r" % types)
+
+    def test_object_without_title_type_failure(self):
+        type = {u"type": [{u"minimum": 3}]}
+        message = self.message_for(instance=1, schema={u"type": [type]})
+        self.assertEqual(message, "1 is less than the minimum of 3")
+
+    def test_object_with_named_type_failure(self):
+        schema = {u"type": [{u"name": "Foo", u"minimum": 3}]}
+        message = self.message_for(instance=1, schema=schema)
+        self.assertEqual(message, "1 is less than the minimum of 3")
+
+    def test_minimum(self):
+        message = self.message_for(instance=1, schema={"minimum": 2})
+        self.assertEqual(message, "1 is less than the minimum of 2")
+
+    def test_maximum(self):
+        message = self.message_for(instance=1, schema={"maximum": 0})
+        self.assertEqual(message, "1 is greater than the maximum of 0")
+
+    def test_dependencies_single_element(self):
+        depend, on = "bar", "foo"
+        schema = {u"dependencies": {depend: on}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(message, "%r is a dependency of %r" % (on, depend))
+
+    def test_dependencies_list_draft3(self):
+        depend, on = "bar", "foo"
+        schema = {u"dependencies": {depend: [on]}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft3Validator,
+        )
+        self.assertEqual(message, "%r is a dependency of %r" % (on, depend))
+
+    def test_dependencies_list_draft7(self):
+        depend, on = "bar", "foo"
+        schema = {u"dependencies": {depend: [on]}}
+        message = self.message_for(
+            instance={"bar": 2},
+            schema=schema,
+            cls=validators.Draft7Validator,
+        )
+        self.assertEqual(message, "%r is a dependency of %r" % (on, depend))
+
+    def test_additionalItems_single_failure(self):
+        message = self.message_for(
+            instance=[2],
+            schema={u"items": [], u"additionalItems": False},
+        )
+        self.assertIn("(2 was unexpected)", message)
+
+    def test_additionalItems_multiple_failures(self):
+        message = self.message_for(
+            instance=[1, 2, 3],
+            schema={u"items": [], u"additionalItems": False}
+        )
+        self.assertIn("(1, 2, 3 were unexpected)", message)
+
+    def test_additionalProperties_single_failure(self):
+        additional = "foo"
+        schema = {u"additionalProperties": False}
+        message = self.message_for(instance={additional: 2}, schema=schema)
+        self.assertIn("(%r was unexpected)" % (additional,), message)
+
+    def test_additionalProperties_multiple_failures(self):
+        schema = {u"additionalProperties": False}
+        message = self.message_for(
+            instance=dict.fromkeys(["foo", "bar"]),
+            schema=schema,
+        )
+
+        self.assertIn(repr("foo"), message)
+        self.assertIn(repr("bar"), message)
+        self.assertIn("were unexpected)", message)
+
+    def test_const(self):
+        schema = {u"const": 12}
+        message = self.message_for(
+            instance={"foo": "bar"},
+            schema=schema,
+            cls=validators.Draft6Validator,
+        )
+        self.assertIn("12 was expected", message)
+
+    def test_contains(self):
+        schema = {u"contains": {u"const": 12}}
+        message = self.message_for(
+            instance=[2, {}, []],
+            schema=schema,
+            cls=validators.Draft6Validator,
+        )
+        self.assertIn(
+            "None of [2, {}, []] are valid under the given schema",
+            message,
+        )
+
+    def test_invalid_format_default_message(self):
+        checker = FormatChecker(formats=())
+        checker.checks(u"thing")(lambda value: False)
+
+        schema = {u"format": u"thing"}
+        message = self.message_for(
+            instance="bla",
+            schema=schema,
+            format_checker=checker,
+        )
+
+        self.assertIn(repr("bla"), message)
+        self.assertIn(repr("thing"), message)
+        self.assertIn("is not a", message)
+
+    def test_additionalProperties_false_patternProperties(self):
+        schema = {u"type": u"object",
+                  u"additionalProperties": False,
+                  u"patternProperties": {
+                      u"^abc$": {u"type": u"string"},
+                      u"^def$": {u"type": u"string"},
+                  }}
+        message = self.message_for(
+            instance={u"zebra": 123},
+            schema=schema,
+            cls=validators.Draft4Validator,
+        )
+        self.assertEqual(
+            message,
+            "{} does not match any of the regexes: {}, {}".format(
+                repr(u"zebra"), repr(u"^abc$"), repr(u"^def$"),
+            ),
+        )
+        message = self.message_for(
+            instance={u"zebra": 123, u"fish": 456},
+            schema=schema,
+            cls=validators.Draft4Validator,
+        )
+        self.assertEqual(
+            message,
+            "{}, {} do not match any of the regexes: {}, {}".format(
+                repr(u"fish"), repr(u"zebra"), repr(u"^abc$"), repr(u"^def$")
+            ),
+        )
+
+    def test_False_schema(self):
+        message = self.message_for(
+            instance="something",
+            schema=False,
+            cls=validators.Draft7Validator,
+        )
+        self.assertIn("False schema does not allow 'something'", message)
+
+
+class TestValidationErrorDetails(TestCase):
+    # TODO: These really need unit tests for each individual validator, rather
+    #       than just these higher level tests.
+    def test_anyOf(self):
+        instance = 5
+        schema = {
+            "anyOf": [
+                {"minimum": 20},
+                {"type": "string"},
+            ],
+        }
+
+        validator = validators.Draft4Validator(schema)
+        errors = list(validator.iter_errors(instance))
+        self.assertEqual(len(errors), 1)
+        e = errors[0]
+
+        self.assertEqual(e.validator, "anyOf")
+        self.assertEqual(e.validator_value, schema["anyOf"])
+        self.assertEqual(e.instance, instance)
+        self.assertEqual(e.schema, schema)
+        self.assertIsNone(e.parent)
+
+        self.assertEqual(e.path, deque([]))
+        self.assertEqual(e.relative_path, deque([]))
+        self.assertEqual(e.absolute_path, deque([]))
+
+        self.assertEqual(e.schema_path, deque(["anyOf"]))
+        self.assertEqual(e.relative_schema_path, deque(["anyOf"]))
+        self.assertEqual(e.absolute_schema_path, deque(["anyOf"]))
+
+        self.assertEqual(len(e.context), 2)
+
+        e1, e2 = sorted_errors(e.context)
+
+        self.assertEqual(e1.validator, "minimum")
+        self.assertEqual(e1.validator_value, schema["anyOf"][0]["minimum"])
+        self.assertEqual(e1.instance, instance)
+        self.assertEqual(e1.schema, schema["anyOf"][0])
+        self.assertIs(e1.parent, e)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e1.absolute_path, deque([]))
+        self.assertEqual(e1.relative_path, deque([]))
+
+        self.assertEqual(e1.schema_path, deque([0, "minimum"]))
+        self.assertEqual(e1.relative_schema_path, deque([0, "minimum"]))
+        self.assertEqual(
+            e1.absolute_schema_path, deque(["anyOf", 0, "minimum"]),
+        )
+
+        self.assertFalse(e1.context)
+
+        self.assertEqual(e2.validator, "type")
+        self.assertEqual(e2.validator_value, schema["anyOf"][1]["type"])
+        self.assertEqual(e2.instance, instance)
+        self.assertEqual(e2.schema, schema["anyOf"][1])
+        self.assertIs(e2.parent, e)
+
+        self.assertEqual(e2.path, deque([]))
+        self.assertEqual(e2.relative_path, deque([]))
+        self.assertEqual(e2.absolute_path, deque([]))
+
+        self.assertEqual(e2.schema_path, deque([1, "type"]))
+        self.assertEqual(e2.relative_schema_path, deque([1, "type"]))
+        self.assertEqual(e2.absolute_schema_path, deque(["anyOf", 1, "type"]))
+
+        self.assertEqual(len(e2.context), 0)
+
+    def test_type(self):
+        instance = {"foo": 1}
+        schema = {
+            "type": [
+                {"type": "integer"},
+                {
+                    "type": "object",
+                    "properties": {"foo": {"enum": [2]}},
+                },
+            ],
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = list(validator.iter_errors(instance))
+        self.assertEqual(len(errors), 1)
+        e = errors[0]
+
+        self.assertEqual(e.validator, "type")
+        self.assertEqual(e.validator_value, schema["type"])
+        self.assertEqual(e.instance, instance)
+        self.assertEqual(e.schema, schema)
+        self.assertIsNone(e.parent)
+
+        self.assertEqual(e.path, deque([]))
+        self.assertEqual(e.relative_path, deque([]))
+        self.assertEqual(e.absolute_path, deque([]))
+
+        self.assertEqual(e.schema_path, deque(["type"]))
+        self.assertEqual(e.relative_schema_path, deque(["type"]))
+        self.assertEqual(e.absolute_schema_path, deque(["type"]))
+
+        self.assertEqual(len(e.context), 2)
+
+        e1, e2 = sorted_errors(e.context)
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e1.validator_value, schema["type"][0]["type"])
+        self.assertEqual(e1.instance, instance)
+        self.assertEqual(e1.schema, schema["type"][0])
+        self.assertIs(e1.parent, e)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e1.relative_path, deque([]))
+        self.assertEqual(e1.absolute_path, deque([]))
+
+        self.assertEqual(e1.schema_path, deque([0, "type"]))
+        self.assertEqual(e1.relative_schema_path, deque([0, "type"]))
+        self.assertEqual(e1.absolute_schema_path, deque(["type", 0, "type"]))
+
+        self.assertFalse(e1.context)
+
+        self.assertEqual(e2.validator, "enum")
+        self.assertEqual(e2.validator_value, [2])
+        self.assertEqual(e2.instance, 1)
+        self.assertEqual(e2.schema, {u"enum": [2]})
+        self.assertIs(e2.parent, e)
+
+        self.assertEqual(e2.path, deque(["foo"]))
+        self.assertEqual(e2.relative_path, deque(["foo"]))
+        self.assertEqual(e2.absolute_path, deque(["foo"]))
+
+        self.assertEqual(
+            e2.schema_path, deque([1, "properties", "foo", "enum"]),
+        )
+        self.assertEqual(
+            e2.relative_schema_path, deque([1, "properties", "foo", "enum"]),
+        )
+        self.assertEqual(
+            e2.absolute_schema_path,
+            deque(["type", 1, "properties", "foo", "enum"]),
+        )
+
+        self.assertFalse(e2.context)
+
+    def test_single_nesting(self):
+        instance = {"foo": 2, "bar": [1], "baz": 15, "quux": "spam"}
+        schema = {
+            "properties": {
+                "foo": {"type": "string"},
+                "bar": {"minItems": 2},
+                "baz": {"maximum": 10, "enum": [2, 4, 6, 8]},
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2, e3, e4 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["baz"]))
+        self.assertEqual(e3.path, deque(["baz"]))
+        self.assertEqual(e4.path, deque(["foo"]))
+
+        self.assertEqual(e1.relative_path, deque(["bar"]))
+        self.assertEqual(e2.relative_path, deque(["baz"]))
+        self.assertEqual(e3.relative_path, deque(["baz"]))
+        self.assertEqual(e4.relative_path, deque(["foo"]))
+
+        self.assertEqual(e1.absolute_path, deque(["bar"]))
+        self.assertEqual(e2.absolute_path, deque(["baz"]))
+        self.assertEqual(e3.absolute_path, deque(["baz"]))
+        self.assertEqual(e4.absolute_path, deque(["foo"]))
+
+        self.assertEqual(e1.validator, "minItems")
+        self.assertEqual(e2.validator, "enum")
+        self.assertEqual(e3.validator, "maximum")
+        self.assertEqual(e4.validator, "type")
+
+    def test_multiple_nesting(self):
+        instance = [1, {"foo": 2, "bar": {"baz": [1]}}, "quux"]
+        schema = {
+            "type": "string",
+            "items": {
+                "type": ["string", "object"],
+                "properties": {
+                    "foo": {"enum": [1, 3]},
+                    "bar": {
+                        "type": "array",
+                        "properties": {
+                            "bar": {"required": True},
+                            "baz": {"minItems": 2},
+                        },
+                    },
+                },
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2, e3, e4, e5, e6 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([]))
+        self.assertEqual(e2.path, deque([0]))
+        self.assertEqual(e3.path, deque([1, "bar"]))
+        self.assertEqual(e4.path, deque([1, "bar", "bar"]))
+        self.assertEqual(e5.path, deque([1, "bar", "baz"]))
+        self.assertEqual(e6.path, deque([1, "foo"]))
+
+        self.assertEqual(e1.schema_path, deque(["type"]))
+        self.assertEqual(e2.schema_path, deque(["items", "type"]))
+        self.assertEqual(
+            list(e3.schema_path), ["items", "properties", "bar", "type"],
+        )
+        self.assertEqual(
+            list(e4.schema_path),
+            ["items", "properties", "bar", "properties", "bar", "required"],
+        )
+        self.assertEqual(
+            list(e5.schema_path),
+            ["items", "properties", "bar", "properties", "baz", "minItems"]
+        )
+        self.assertEqual(
+            list(e6.schema_path), ["items", "properties", "foo", "enum"],
+        )
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "type")
+        self.assertEqual(e3.validator, "type")
+        self.assertEqual(e4.validator, "required")
+        self.assertEqual(e5.validator, "minItems")
+        self.assertEqual(e6.validator, "enum")
+
+    def test_recursive(self):
+        schema = {
+            "definitions": {
+                "node": {
+                    "anyOf": [{
+                        "type": "object",
+                        "required": ["name", "children"],
+                        "properties": {
+                            "name": {
+                                "type": "string",
+                            },
+                            "children": {
+                                "type": "object",
+                                "patternProperties": {
+                                    "^.*$": {
+                                        "$ref": "#/definitions/node",
+                                    },
+                                },
+                            },
+                        },
+                    }],
+                },
+            },
+            "type": "object",
+            "required": ["root"],
+            "properties": {"root": {"$ref": "#/definitions/node"}},
+        }
+
+        instance = {
+            "root": {
+                "name": "root",
+                "children": {
+                    "a": {
+                        "name": "a",
+                        "children": {
+                            "ab": {
+                                "name": "ab",
+                                # missing "children"
+                            },
+                        },
+                    },
+                },
+            },
+        }
+        validator = validators.Draft4Validator(schema)
+
+        e, = validator.iter_errors(instance)
+        self.assertEqual(e.absolute_path, deque(["root"]))
+        self.assertEqual(
+            e.absolute_schema_path, deque(["properties", "root", "anyOf"]),
+        )
+
+        e1, = e.context
+        self.assertEqual(e1.absolute_path, deque(["root", "children", "a"]))
+        self.assertEqual(
+            e1.absolute_schema_path, deque(
+                [
+                    "properties",
+                    "root",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                ],
+            ),
+        )
+
+        e2, = e1.context
+        self.assertEqual(
+            e2.absolute_path, deque(
+                ["root", "children", "a", "children", "ab"],
+            ),
+        )
+        self.assertEqual(
+            e2.absolute_schema_path, deque(
+                [
+                    "properties",
+                    "root",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                    0,
+                    "properties",
+                    "children",
+                    "patternProperties",
+                    "^.*$",
+                    "anyOf",
+                ],
+            ),
+        )
+
+    def test_additionalProperties(self):
+        instance = {"bar": "bar", "foo": 2}
+        schema = {"additionalProperties": {"type": "integer", "minimum": 5}}
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["foo"]))
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_patternProperties(self):
+        instance = {"bar": 1, "foo": 2}
+        schema = {
+            "patternProperties": {
+                "bar": {"type": "string"},
+                "foo": {"minimum": 5},
+            },
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque(["bar"]))
+        self.assertEqual(e2.path, deque(["foo"]))
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_additionalItems(self):
+        instance = ["foo", 1]
+        schema = {
+            "items": [],
+            "additionalItems": {"type": "integer", "minimum": 5},
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([0]))
+        self.assertEqual(e2.path, deque([1]))
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_additionalItems_with_items(self):
+        instance = ["foo", "bar", 1]
+        schema = {
+            "items": [{}],
+            "additionalItems": {"type": "integer", "minimum": 5},
+        }
+
+        validator = validators.Draft3Validator(schema)
+        errors = validator.iter_errors(instance)
+        e1, e2 = sorted_errors(errors)
+
+        self.assertEqual(e1.path, deque([1]))
+        self.assertEqual(e2.path, deque([2]))
+
+        self.assertEqual(e1.validator, "type")
+        self.assertEqual(e2.validator, "minimum")
+
+    def test_propertyNames(self):
+        instance = {"foo": 12}
+        schema = {"propertyNames": {"not": {"const": "foo"}}}
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(instance)
+
+        self.assertEqual(error.validator, "not")
+        self.assertEqual(
+            error.message,
+            "%r is not allowed for %r" % ({"const": "foo"}, "foo"),
+        )
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.schema_path, deque(["propertyNames", "not"]))
+
+    def test_if_then(self):
+        schema = {
+            "if": {"const": 12},
+            "then": {"const": 13},
+        }
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(12)
+
+        self.assertEqual(error.validator, "const")
+        self.assertEqual(error.message, "13 was expected")
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.schema_path, deque(["if", "then", "const"]))
+
+    def test_if_else(self):
+        schema = {
+            "if": {"const": 12},
+            "else": {"const": 13},
+        }
+
+        validator = validators.Draft7Validator(schema)
+        error, = validator.iter_errors(15)
+
+        self.assertEqual(error.validator, "const")
+        self.assertEqual(error.message, "13 was expected")
+        self.assertEqual(error.path, deque([]))
+        self.assertEqual(error.schema_path, deque(["if", "else", "const"]))
+
+    def test_boolean_schema_False(self):
+        validator = validators.Draft7Validator(False)
+        error, = validator.iter_errors(12)
+
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.schema,
+                error.schema_path,
+            ),
+            (
+                "False schema does not allow 12",
+                None,
+                None,
+                12,
+                False,
+                deque([]),
+            ),
+        )
+
+    def test_ref(self):
+        ref, schema = "someRef", {"additionalProperties": {"type": "integer"}}
+        validator = validators.Draft7Validator(
+            {"$ref": ref},
+            resolver=validators.RefResolver("", {}, store={ref: schema}),
+        )
+        error, = validator.iter_errors({"foo": "notAnInteger"})
+
+        self.assertEqual(
+            (
+                error.message,
+                error.validator,
+                error.validator_value,
+                error.instance,
+                error.absolute_path,
+                error.schema,
+                error.schema_path,
+            ),
+            (
+                "'notAnInteger' is not of type 'integer'",
+                "type",
+                "integer",
+                "notAnInteger",
+                deque(["foo"]),
+                {"type": "integer"},
+                deque(["additionalProperties", "type"]),
+            ),
+        )
+
+
+class MetaSchemaTestsMixin(object):
+    # TODO: These all belong upstream
+    def test_invalid_properties(self):
+        with self.assertRaises(exceptions.SchemaError):
+            self.Validator.check_schema({"properties": {"test": object()}})
+
+    def test_minItems_invalid_string(self):
+        with self.assertRaises(exceptions.SchemaError):
+            # needs to be an integer
+            self.Validator.check_schema({"minItems": "1"})
+
+    def test_enum_allows_empty_arrays(self):
+        """
+        Technically, all the spec says is they SHOULD have elements, not MUST.
+
+        See https://github.com/Julian/jsonschema/issues/529.
+        """
+        self.Validator.check_schema({"enum": []})
+
+    def test_enum_allows_non_unique_items(self):
+        """
+        Technically, all the spec says is they SHOULD be unique, not MUST.
+
+        See https://github.com/Julian/jsonschema/issues/529.
+        """
+        self.Validator.check_schema({"enum": [12, 12]})
+
+
+class ValidatorTestMixin(MetaSchemaTestsMixin, object):
+    def test_valid_instances_are_valid(self):
+        schema, instance = self.valid
+        self.assertTrue(self.Validator(schema).is_valid(instance))
+
+    def test_invalid_instances_are_not_valid(self):
+        schema, instance = self.invalid
+        self.assertFalse(self.Validator(schema).is_valid(instance))
+
+    def test_non_existent_properties_are_ignored(self):
+        self.Validator({object(): object()}).validate(instance=object())
+
+    def test_it_creates_a_ref_resolver_if_not_provided(self):
+        self.assertIsInstance(
+            self.Validator({}).resolver,
+            validators.RefResolver,
+        )
+
+    def test_it_delegates_to_a_ref_resolver(self):
+        ref, schema = "someCoolRef", {"type": "integer"}
+        resolver = validators.RefResolver("", {}, store={ref: schema})
+        validator = self.Validator({"$ref": ref}, resolver=resolver)
+
+        with self.assertRaises(exceptions.ValidationError):
+            validator.validate(None)
+
+    def test_it_delegates_to_a_legacy_ref_resolver(self):
+        """
+        Legacy RefResolvers support only the context manager form of
+        resolution.
+        """
+
+        class LegacyRefResolver(object):
+            @contextmanager
+            def resolving(this, ref):
+                self.assertEqual(ref, "the ref")
+                yield {"type": "integer"}
+
+        resolver = LegacyRefResolver()
+        schema = {"$ref": "the ref"}
+
+        with self.assertRaises(exceptions.ValidationError):
+            self.Validator(schema, resolver=resolver).validate(None)
+
+    def test_is_type_is_true_for_valid_type(self):
+        self.assertTrue(self.Validator({}).is_type("foo", "string"))
+
+    def test_is_type_is_false_for_invalid_type(self):
+        self.assertFalse(self.Validator({}).is_type("foo", "array"))
+
+    def test_is_type_evades_bool_inheriting_from_int(self):
+        self.assertFalse(self.Validator({}).is_type(True, "integer"))
+        self.assertFalse(self.Validator({}).is_type(True, "number"))
+
+    @unittest.skipIf(PY3, "In Python 3 json.load always produces unicode")
+    def test_string_a_bytestring_is_a_string(self):
+        self.Validator({"type": "string"}).validate(b"foo")
+
+    def test_patterns_can_be_native_strings(self):
+        """
+        See https://github.com/Julian/jsonschema/issues/611.
+        """
+        self.Validator({"pattern": "foo"}).validate("foo")
+
+    def test_it_can_validate_with_decimals(self):
+        schema = {"items": {"type": "number"}}
+        Validator = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "number",
+                lambda checker, thing: isinstance(
+                    thing, (int, float, Decimal),
+                ) and not isinstance(thing, bool),
+            )
+        )
+
+        validator = Validator(schema)
+        validator.validate([1, 1.1, Decimal(1) / Decimal(8)])
+
+        invalid = ["foo", {}, [], True, None]
+        self.assertEqual(
+            [error.instance for error in validator.iter_errors(invalid)],
+            invalid,
+        )
+
+    def test_it_returns_true_for_formats_it_does_not_know_about(self):
+        validator = self.Validator(
+            {"format": "carrot"}, format_checker=FormatChecker(),
+        )
+        validator.validate("bugs")
+
+    def test_it_does_not_validate_formats_by_default(self):
+        validator = self.Validator({})
+        self.assertIsNone(validator.format_checker)
+
+    def test_it_validates_formats_if_a_checker_is_provided(self):
+        checker = FormatChecker()
+        bad = ValueError("Bad!")
+
+        @checker.checks("foo", raises=ValueError)
+        def check(value):
+            if value == "good":
+                return True
+            elif value == "bad":
+                raise bad
+            else:  # pragma: no cover
+                self.fail("What is {}? [Baby Don't Hurt Me]".format(value))
+
+        validator = self.Validator(
+            {"format": "foo"}, format_checker=checker,
+        )
+
+        validator.validate("good")
+        with self.assertRaises(exceptions.ValidationError) as cm:
+            validator.validate("bad")
+
+        # Make sure original cause is attached
+        self.assertIs(cm.exception.cause, bad)
+
+    def test_non_string_custom_type(self):
+        non_string_type = object()
+        schema = {"type": [non_string_type]}
+        Crazy = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                non_string_type,
+                lambda checker, thing: isinstance(thing, int),
+            )
+        )
+        Crazy(schema).validate(15)
+
+    def test_it_properly_formats_tuples_in_errors(self):
+        """
+        A tuple instance properly formats validation errors for uniqueItems.
+
+        See https://github.com/Julian/jsonschema/pull/224
+        """
+        TupleValidator = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "array",
+                lambda checker, thing: isinstance(thing, tuple),
+            )
+        )
+        with self.assertRaises(exceptions.ValidationError) as e:
+            TupleValidator({"uniqueItems": True}).validate((1, 1))
+        self.assertIn("(1, 1) has non-unique elements", str(e.exception))
+
+
+class AntiDraft6LeakMixin(object):
+    """
+    Make sure functionality from draft 6 doesn't leak backwards in time.
+    """
+
+    def test_True_is_not_a_schema(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            self.Validator.check_schema(True)
+        self.assertIn("True is not of type", str(e.exception))
+
+    def test_False_is_not_a_schema(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            self.Validator.check_schema(False)
+        self.assertIn("False is not of type", str(e.exception))
+
+    @unittest.skip(bug(523))
+    def test_True_is_not_a_schema_even_if_you_forget_to_check(self):
+        resolver = validators.RefResolver("", {})
+        with self.assertRaises(Exception) as e:
+            self.Validator(True, resolver=resolver).validate(12)
+        self.assertNotIsInstance(e.exception, exceptions.ValidationError)
+
+    @unittest.skip(bug(523))
+    def test_False_is_not_a_schema_even_if_you_forget_to_check(self):
+        resolver = validators.RefResolver("", {})
+        with self.assertRaises(Exception) as e:
+            self.Validator(False, resolver=resolver).validate(12)
+        self.assertNotIsInstance(e.exception, exceptions.ValidationError)
+
+
+class TestDraft3Validator(AntiDraft6LeakMixin, ValidatorTestMixin, TestCase):
+    Validator = validators.Draft3Validator
+    valid = {}, {}
+    invalid = {"type": "integer"}, "foo"
+
+    def test_any_type_is_valid_for_type_any(self):
+        validator = self.Validator({"type": "any"})
+        validator.validate(object())
+
+    def test_any_type_is_redefinable(self):
+        """
+        Sigh, because why not.
+        """
+        Crazy = validators.extend(
+            self.Validator,
+            type_checker=self.Validator.TYPE_CHECKER.redefine(
+                "any", lambda checker, thing: isinstance(thing, int),
+            )
+        )
+        validator = Crazy({"type": "any"})
+        validator.validate(12)
+        with self.assertRaises(exceptions.ValidationError):
+            validator.validate("foo")
+
+    def test_is_type_is_true_for_any_type(self):
+        self.assertTrue(self.Validator({}).is_valid(object(), {"type": "any"}))
+
+    def test_is_type_does_not_evade_bool_if_it_is_being_tested(self):
+        self.assertTrue(self.Validator({}).is_type(True, "boolean"))
+        self.assertTrue(self.Validator({}).is_valid(True, {"type": "any"}))
+
+
+class TestDraft4Validator(AntiDraft6LeakMixin, ValidatorTestMixin, TestCase):
+    Validator = validators.Draft4Validator
+    valid = {}, {}
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft6Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft6Validator
+    valid = {}, {}
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestDraft7Validator(ValidatorTestMixin, TestCase):
+    Validator = validators.Draft7Validator
+    valid = {}, {}
+    invalid = {"type": "integer"}, "foo"
+
+
+class TestValidatorFor(SynchronousTestCase):
+    def test_draft_3(self):
+        schema = {"$schema": "http://json-schema.org/draft-03/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft3Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-03/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft3Validator,
+        )
+
+    def test_draft_4(self):
+        schema = {"$schema": "http://json-schema.org/draft-04/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft4Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-04/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft4Validator,
+        )
+
+    def test_draft_6(self):
+        schema = {"$schema": "http://json-schema.org/draft-06/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft6Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-06/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft6Validator,
+        )
+
+    def test_draft_7(self):
+        schema = {"$schema": "http://json-schema.org/draft-07/schema"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft7Validator,
+        )
+
+        schema = {"$schema": "http://json-schema.org/draft-07/schema#"}
+        self.assertIs(
+            validators.validator_for(schema),
+            validators.Draft7Validator,
+        )
+
+    def test_True(self):
+        self.assertIs(
+            validators.validator_for(True),
+            validators._LATEST_VERSION,
+        )
+
+    def test_False(self):
+        self.assertIs(
+            validators.validator_for(False),
+            validators._LATEST_VERSION,
+        )
+
+    def test_custom_validator(self):
+        Validator = validators.create(
+            meta_schema={"id": "meta schema id"},
+            version="12",
+            id_of=lambda s: s.get("id", ""),
+        )
+        schema = {"$schema": "meta schema id"}
+        self.assertIs(
+            validators.validator_for(schema),
+            Validator,
+        )
+
+    def test_custom_validator_draft6(self):
+        Validator = validators.create(
+            meta_schema={"$id": "meta schema $id"},
+            version="13",
+        )
+        schema = {"$schema": "meta schema $id"}
+        self.assertIs(
+            validators.validator_for(schema),
+            Validator,
+        )
+
+    def test_validator_for_jsonschema_default(self):
+        self.assertIs(validators.validator_for({}), validators._LATEST_VERSION)
+
+    def test_validator_for_custom_default(self):
+        self.assertIs(validators.validator_for({}, default=None), None)
+
+    def test_warns_if_meta_schema_specified_was_not_found(self):
+        self.assertWarns(
+            category=DeprecationWarning,
+            message=(
+                "The metaschema specified by $schema was not found. "
+                "Using the latest draft to validate, but this will raise "
+                "an error in the future."
+            ),
+            # https://tm.tl/9363 :'(
+            filename=sys.modules[self.assertWarns.__module__].__file__,
+
+            f=validators.validator_for,
+            schema={u"$schema": "unknownSchema"},
+            default={},
+        )
+
+    def test_does_not_warn_if_meta_schema_is_unspecified(self):
+        validators.validator_for(schema={}, default={}),
+        self.assertFalse(self.flushWarnings())
+
+
+class TestValidate(SynchronousTestCase):
+    def assertUses(self, schema, Validator):
+        result = []
+        self.patch(Validator, "check_schema", result.append)
+        validators.validate({}, schema)
+        self.assertEqual(result, [schema])
+
+    def test_draft3_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-03/schema#"},
+            Validator=validators.Draft3Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-03/schema"},
+            Validator=validators.Draft3Validator,
+        )
+
+    def test_draft4_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-04/schema#"},
+            Validator=validators.Draft4Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-04/schema"},
+            Validator=validators.Draft4Validator,
+        )
+
+    def test_draft6_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-06/schema#"},
+            Validator=validators.Draft6Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-06/schema"},
+            Validator=validators.Draft6Validator,
+        )
+
+    def test_draft7_validator_is_chosen(self):
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-07/schema#"},
+            Validator=validators.Draft7Validator,
+        )
+        # Make sure it works without the empty fragment
+        self.assertUses(
+            schema={"$schema": "http://json-schema.org/draft-07/schema"},
+            Validator=validators.Draft7Validator,
+        )
+
+    def test_draft7_validator_is_the_default(self):
+        self.assertUses(schema={}, Validator=validators.Draft7Validator)
+
+    def test_validation_error_message(self):
+        with self.assertRaises(exceptions.ValidationError) as e:
+            validators.validate(12, {"type": "string"})
+        self.assertRegexpMatches(
+            str(e.exception),
+            "(?s)Failed validating u?'.*' in schema.*On instance",
+        )
+
+    def test_schema_error_message(self):
+        with self.assertRaises(exceptions.SchemaError) as e:
+            validators.validate(12, {"type": 12})
+        self.assertRegexpMatches(
+            str(e.exception),
+            "(?s)Failed validating u?'.*' in metaschema.*On schema",
+        )
+
+    def test_it_uses_best_match(self):
+        # This is a schema that best_match will recurse into
+        schema = {"oneOf": [{"type": "string"}, {"type": "array"}]}
+        with self.assertRaises(exceptions.ValidationError) as e:
+            validators.validate(12, schema)
+        self.assertIn("12 is not of type", str(e.exception))
+
+
+class TestRefResolver(SynchronousTestCase):
+
+    base_uri = ""
+    stored_uri = "foo://stored"
+    stored_schema = {"stored": "schema"}
+
+    def setUp(self):
+        self.referrer = {}
+        self.store = {self.stored_uri: self.stored_schema}
+        self.resolver = validators.RefResolver(
+            self.base_uri, self.referrer, self.store,
+        )
+
+    def test_it_does_not_retrieve_schema_urls_from_the_network(self):
+        ref = validators.Draft3Validator.META_SCHEMA["id"]
+        self.patch(
+            self.resolver,
+            "resolve_remote",
+            lambda *args, **kwargs: self.fail("Should not have been called!"),
+        )
+        with self.resolver.resolving(ref) as resolved:
+            pass
+        self.assertEqual(resolved, validators.Draft3Validator.META_SCHEMA)
+
+    def test_it_resolves_local_refs(self):
+        ref = "#/properties/foo"
+        self.referrer["properties"] = {"foo": object()}
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, self.referrer["properties"]["foo"])
+
+    def test_it_resolves_local_refs_with_id(self):
+        schema = {"id": "http://bar/schema#", "a": {"foo": "bar"}}
+        resolver = validators.RefResolver.from_schema(
+            schema,
+            id_of=lambda schema: schema.get(u"id", u""),
+        )
+        with resolver.resolving("#/a") as resolved:
+            self.assertEqual(resolved, schema["a"])
+        with resolver.resolving("http://bar/schema#/a") as resolved:
+            self.assertEqual(resolved, schema["a"])
+
+    def test_it_retrieves_stored_refs(self):
+        with self.resolver.resolving(self.stored_uri) as resolved:
+            self.assertIs(resolved, self.stored_schema)
+
+        self.resolver.store["cached_ref"] = {"foo": 12}
+        with self.resolver.resolving("cached_ref#/foo") as resolved:
+            self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_unstored_refs_via_requests(self):
+        ref = "http://bar#baz"
+        schema = {"baz": 12}
+
+        if "requests" in sys.modules:
+            self.addCleanup(
+                sys.modules.__setitem__, "requests", sys.modules["requests"],
+            )
+        sys.modules["requests"] = ReallyFakeRequests({"http://bar": schema})
+
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_unstored_refs_via_urlopen(self):
+        ref = "http://bar#baz"
+        schema = {"baz": 12}
+
+        if "requests" in sys.modules:
+            self.addCleanup(
+                sys.modules.__setitem__, "requests", sys.modules["requests"],
+            )
+        sys.modules["requests"] = None
+
+        @contextmanager
+        def fake_urlopen(url):
+            self.assertEqual(url, "http://bar")
+            yield BytesIO(json.dumps(schema).encode("utf8"))
+
+        self.addCleanup(setattr, validators, "urlopen", validators.urlopen)
+        validators.urlopen = fake_urlopen
+
+        with self.resolver.resolving(ref) as resolved:
+            pass
+        self.assertEqual(resolved, 12)
+
+    def test_it_retrieves_local_refs_via_urlopen(self):
+        with tempfile.NamedTemporaryFile(delete=False, mode="wt") as tempf:
+            self.addCleanup(os.remove, tempf.name)
+            json.dump({"foo": "bar"}, tempf)
+
+        ref = "file://{}#foo".format(pathname2url(tempf.name))
+        with self.resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, "bar")
+
+    def test_it_can_construct_a_base_uri_from_a_schema(self):
+        schema = {"id": "foo"}
+        resolver = validators.RefResolver.from_schema(
+            schema,
+            id_of=lambda schema: schema.get(u"id", u""),
+        )
+        self.assertEqual(resolver.base_uri, "foo")
+        self.assertEqual(resolver.resolution_scope, "foo")
+        with resolver.resolving("") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("#") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("foo") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("foo#") as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_it_can_construct_a_base_uri_from_a_schema_without_id(self):
+        schema = {}
+        resolver = validators.RefResolver.from_schema(schema)
+        self.assertEqual(resolver.base_uri, "")
+        self.assertEqual(resolver.resolution_scope, "")
+        with resolver.resolving("") as resolved:
+            self.assertEqual(resolved, schema)
+        with resolver.resolving("#") as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_custom_uri_scheme_handlers(self):
+        def handler(url):
+            self.assertEqual(url, ref)
+            return schema
+
+        schema = {"foo": "bar"}
+        ref = "foo://bar"
+        resolver = validators.RefResolver("", {}, handlers={"foo": handler})
+        with resolver.resolving(ref) as resolved:
+            self.assertEqual(resolved, schema)
+
+    def test_cache_remote_on(self):
+        response = [object()]
+
+        def handler(url):
+            try:
+                return response.pop()
+            except IndexError:  # pragma: no cover
+                self.fail("Response must not have been cached!")
+
+        ref = "foo://bar"
+        resolver = validators.RefResolver(
+            "", {}, cache_remote=True, handlers={"foo": handler},
+        )
+        with resolver.resolving(ref):
+            pass
+        with resolver.resolving(ref):
+            pass
+
+    def test_cache_remote_off(self):
+        response = [object()]
+
+        def handler(url):
+            try:
+                return response.pop()
+            except IndexError:  # pragma: no cover
+                self.fail("Handler called twice!")
+
+        ref = "foo://bar"
+        resolver = validators.RefResolver(
+            "", {}, cache_remote=False, handlers={"foo": handler},
+        )
+        with resolver.resolving(ref):
+            pass
+
+    def test_if_you_give_it_junk_you_get_a_resolution_error(self):
+        error = ValueError("Oh no! What's this?")
+
+        def handler(url):
+            raise error
+
+        ref = "foo://bar"
+        resolver = validators.RefResolver("", {}, handlers={"foo": handler})
+        with self.assertRaises(exceptions.RefResolutionError) as err:
+            with resolver.resolving(ref):
+                self.fail("Shouldn't get this far!")  # pragma: no cover
+        self.assertEqual(err.exception, exceptions.RefResolutionError(error))
+
+    def test_helpful_error_message_on_failed_pop_scope(self):
+        resolver = validators.RefResolver("", {})
+        resolver.pop_scope()
+        with self.assertRaises(exceptions.RefResolutionError) as exc:
+            resolver.pop_scope()
+        self.assertIn("Failed to pop the scope", str(exc.exception))
+
+
+def sorted_errors(errors):
+    def key(error):
+        return (
+            [str(e) for e in error.path],
+            [str(e) for e in error.schema_path],
+        )
+    return sorted(errors, key=key)
+
+
+@attr.s
+class ReallyFakeRequests(object):
+
+    _responses = attr.ib()
+
+    def get(self, url):
+        response = self._responses.get(url)
+        if url is None:  # pragma: no cover
+            raise ValueError("Unknown URL: " + repr(url))
+        return _ReallyFakeJSONResponse(json.dumps(response))
+
+
+@attr.s
+class _ReallyFakeJSONResponse(object):
+
+    _response = attr.ib()
+
+    def json(self):
+        return json.loads(self._response)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/validators.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/validators.py
new file mode 100644
index 0000000000000000000000000000000000000000..1dc420c70d2558f9a2805f0ddb8c0f1cb9d5cf93
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/jsonschema/validators.py
@@ -0,0 +1,970 @@
+"""
+Creation and extension of validators, with implementations for existing drafts.
+"""
+from __future__ import division
+
+from warnings import warn
+import contextlib
+import json
+import numbers
+
+from six import add_metaclass
+
+from jsonschema import (
+    _legacy_validators,
+    _types,
+    _utils,
+    _validators,
+    exceptions,
+)
+from jsonschema.compat import (
+    Sequence,
+    int_types,
+    iteritems,
+    lru_cache,
+    str_types,
+    unquote,
+    urldefrag,
+    urljoin,
+    urlopen,
+    urlsplit,
+)
+
+# Sigh. https://gitlab.com/pycqa/flake8/issues/280
+#       https://github.com/pyga/ebb-lint/issues/7
+# Imported for backwards compatibility.
+from jsonschema.exceptions import ErrorTree
+ErrorTree
+
+
+class _DontDoThat(Exception):
+    """
+    Raised when a Validators with non-default type checker is misused.
+
+    Asking one for DEFAULT_TYPES doesn't make sense, since type checkers
+    exist for the unrepresentable cases where DEFAULT_TYPES can't
+    represent the type relationship.
+    """
+
+    def __str__(self):
+        return "DEFAULT_TYPES cannot be used on Validators using TypeCheckers"
+
+
+validators = {}
+meta_schemas = _utils.URIDict()
+
+
+def _generate_legacy_type_checks(types=()):
+    """
+    Generate newer-style type checks out of JSON-type-name-to-type mappings.
+
+    Arguments:
+
+        types (dict):
+
+            A mapping of type names to their Python types
+
+    Returns:
+
+        A dictionary of definitions to pass to `TypeChecker`
+    """
+    types = dict(types)
+
+    def gen_type_check(pytypes):
+        pytypes = _utils.flatten(pytypes)
+
+        def type_check(checker, instance):
+            if isinstance(instance, bool):
+                if bool not in pytypes:
+                    return False
+            return isinstance(instance, pytypes)
+
+        return type_check
+
+    definitions = {}
+    for typename, pytypes in iteritems(types):
+        definitions[typename] = gen_type_check(pytypes)
+
+    return definitions
+
+
+_DEPRECATED_DEFAULT_TYPES = {
+    u"array": list,
+    u"boolean": bool,
+    u"integer": int_types,
+    u"null": type(None),
+    u"number": numbers.Number,
+    u"object": dict,
+    u"string": str_types,
+}
+_TYPE_CHECKER_FOR_DEPRECATED_DEFAULT_TYPES = _types.TypeChecker(
+    type_checkers=_generate_legacy_type_checks(_DEPRECATED_DEFAULT_TYPES),
+)
+
+
+def validates(version):
+    """
+    Register the decorated validator for a ``version`` of the specification.
+
+    Registered validators and their meta schemas will be considered when
+    parsing ``$schema`` properties' URIs.
+
+    Arguments:
+
+        version (str):
+
+            An identifier to use as the version's name
+
+    Returns:
+
+        collections.Callable:
+
+            a class decorator to decorate the validator with the version
+    """
+
+    def _validates(cls):
+        validators[version] = cls
+        meta_schema_id = cls.ID_OF(cls.META_SCHEMA)
+        if meta_schema_id:
+            meta_schemas[meta_schema_id] = cls
+        return cls
+    return _validates
+
+
+def _DEFAULT_TYPES(self):
+    if self._CREATED_WITH_DEFAULT_TYPES is None:
+        raise _DontDoThat()
+
+    warn(
+        (
+            "The DEFAULT_TYPES attribute is deprecated. "
+            "See the type checker attached to this validator instead."
+        ),
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return self._DEFAULT_TYPES
+
+
+class _DefaultTypesDeprecatingMetaClass(type):
+    DEFAULT_TYPES = property(_DEFAULT_TYPES)
+
+
+def _id_of(schema):
+    if schema is True or schema is False:
+        return u""
+    return schema.get(u"$id", u"")
+
+
+def create(
+    meta_schema,
+    validators=(),
+    version=None,
+    default_types=None,
+    type_checker=None,
+    id_of=_id_of,
+):
+    """
+    Create a new validator class.
+
+    Arguments:
+
+        meta_schema (collections.Mapping):
+
+            the meta schema for the new validator class
+
+        validators (collections.Mapping):
+
+            a mapping from names to callables, where each callable will
+            validate the schema property with the given name.
+
+            Each callable should take 4 arguments:
+
+                1. a validator instance,
+                2. the value of the property being validated within the
+                   instance
+                3. the instance
+                4. the schema
+
+        version (str):
+
+            an identifier for the version that this validator class will
+            validate. If provided, the returned validator class will
+            have its ``__name__`` set to include the version, and also
+            will have `jsonschema.validators.validates` automatically
+            called for the given version.
+
+        type_checker (jsonschema.TypeChecker):
+
+            a type checker, used when applying the :validator:`type` validator.
+
+            If unprovided, a `jsonschema.TypeChecker` will be created
+            with a set of default types typical of JSON Schema drafts.
+
+        default_types (collections.Mapping):
+
+            .. deprecated:: 3.0.0
+
+                Please use the type_checker argument instead.
+
+            If set, it provides mappings of JSON types to Python types
+            that will be converted to functions and redefined in this
+            object's `jsonschema.TypeChecker`.
+
+        id_of (collections.Callable):
+
+            A function that given a schema, returns its ID.
+
+    Returns:
+
+        a new `jsonschema.IValidator` class
+    """
+
+    if default_types is not None:
+        if type_checker is not None:
+            raise TypeError(
+                "Do not specify default_types when providing a type checker.",
+            )
+        _created_with_default_types = True
+        warn(
+            (
+                "The default_types argument is deprecated. "
+                "Use the type_checker argument instead."
+            ),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        type_checker = _types.TypeChecker(
+            type_checkers=_generate_legacy_type_checks(default_types),
+        )
+    else:
+        default_types = _DEPRECATED_DEFAULT_TYPES
+        if type_checker is None:
+            _created_with_default_types = False
+            type_checker = _TYPE_CHECKER_FOR_DEPRECATED_DEFAULT_TYPES
+        elif type_checker is _TYPE_CHECKER_FOR_DEPRECATED_DEFAULT_TYPES:
+            _created_with_default_types = False
+        else:
+            _created_with_default_types = None
+
+    @add_metaclass(_DefaultTypesDeprecatingMetaClass)
+    class Validator(object):
+
+        VALIDATORS = dict(validators)
+        META_SCHEMA = dict(meta_schema)
+        TYPE_CHECKER = type_checker
+        ID_OF = staticmethod(id_of)
+
+        DEFAULT_TYPES = property(_DEFAULT_TYPES)
+        _DEFAULT_TYPES = dict(default_types)
+        _CREATED_WITH_DEFAULT_TYPES = _created_with_default_types
+
+        def __init__(
+            self,
+            schema,
+            types=(),
+            resolver=None,
+            format_checker=None,
+        ):
+            if types:
+                warn(
+                    (
+                        "The types argument is deprecated. Provide "
+                        "a type_checker to jsonschema.validators.extend "
+                        "instead."
+                    ),
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+
+                self.TYPE_CHECKER = self.TYPE_CHECKER.redefine_many(
+                    _generate_legacy_type_checks(types),
+                )
+
+            if resolver is None:
+                resolver = RefResolver.from_schema(schema, id_of=id_of)
+
+            self.resolver = resolver
+            self.format_checker = format_checker
+            self.schema = schema
+
+        @classmethod
+        def check_schema(cls, schema):
+            for error in cls(cls.META_SCHEMA).iter_errors(schema):
+                raise exceptions.SchemaError.create_from(error)
+
+        def iter_errors(self, instance, _schema=None):
+            if _schema is None:
+                _schema = self.schema
+
+            if _schema is True:
+                return
+            elif _schema is False:
+                yield exceptions.ValidationError(
+                    "False schema does not allow %r" % (instance,),
+                    validator=None,
+                    validator_value=None,
+                    instance=instance,
+                    schema=_schema,
+                )
+                return
+
+            scope = id_of(_schema)
+            if scope:
+                self.resolver.push_scope(scope)
+            try:
+                ref = _schema.get(u"$ref")
+                if ref is not None:
+                    validators = [(u"$ref", ref)]
+                else:
+                    validators = iteritems(_schema)
+
+                for k, v in validators:
+                    validator = self.VALIDATORS.get(k)
+                    if validator is None:
+                        continue
+
+                    errors = validator(self, v, instance, _schema) or ()
+                    for error in errors:
+                        # set details if not already set by the called fn
+                        error._set(
+                            validator=k,
+                            validator_value=v,
+                            instance=instance,
+                            schema=_schema,
+                        )
+                        if k != u"$ref":
+                            error.schema_path.appendleft(k)
+                        yield error
+            finally:
+                if scope:
+                    self.resolver.pop_scope()
+
+        def descend(self, instance, schema, path=None, schema_path=None):
+            for error in self.iter_errors(instance, schema):
+                if path is not None:
+                    error.path.appendleft(path)
+                if schema_path is not None:
+                    error.schema_path.appendleft(schema_path)
+                yield error
+
+        def validate(self, *args, **kwargs):
+            for error in self.iter_errors(*args, **kwargs):
+                raise error
+
+        def is_type(self, instance, type):
+            try:
+                return self.TYPE_CHECKER.is_type(instance, type)
+            except exceptions.UndefinedTypeCheck:
+                raise exceptions.UnknownType(type, instance, self.schema)
+
+        def is_valid(self, instance, _schema=None):
+            error = next(self.iter_errors(instance, _schema), None)
+            return error is None
+
+    if version is not None:
+        Validator = validates(version)(Validator)
+        Validator.__name__ = version.title().replace(" ", "") + "Validator"
+
+    return Validator
+
+
+def extend(validator, validators=(), version=None, type_checker=None):
+    """
+    Create a new validator class by extending an existing one.
+
+    Arguments:
+
+        validator (jsonschema.IValidator):
+
+            an existing validator class
+
+        validators (collections.Mapping):
+
+            a mapping of new validator callables to extend with, whose
+            structure is as in `create`.
+
+            .. note::
+
+                Any validator callables with the same name as an
+                existing one will (silently) replace the old validator
+                callable entirely, effectively overriding any validation
+                done in the "parent" validator class.
+
+                If you wish to instead extend the behavior of a parent's
+                validator callable, delegate and call it directly in
+                the new validator function by retrieving it using
+                ``OldValidator.VALIDATORS["validator_name"]``.
+
+        version (str):
+
+            a version for the new validator class
+
+        type_checker (jsonschema.TypeChecker):
+
+            a type checker, used when applying the :validator:`type` validator.
+
+            If unprovided, the type checker of the extended
+            `jsonschema.IValidator` will be carried along.`
+
+    Returns:
+
+        a new `jsonschema.IValidator` class extending the one provided
+
+    .. note:: Meta Schemas
+
+        The new validator class will have its parent's meta schema.
+
+        If you wish to change or extend the meta schema in the new
+        validator class, modify ``META_SCHEMA`` directly on the returned
+        class. Note that no implicit copying is done, so a copy should
+        likely be made before modifying it, in order to not affect the
+        old validator.
+    """
+
+    all_validators = dict(validator.VALIDATORS)
+    all_validators.update(validators)
+
+    if type_checker is None:
+        type_checker = validator.TYPE_CHECKER
+    elif validator._CREATED_WITH_DEFAULT_TYPES:
+        raise TypeError(
+            "Cannot extend a validator created with default_types "
+            "with a type_checker. Update the validator to use a "
+            "type_checker when created."
+        )
+    return create(
+        meta_schema=validator.META_SCHEMA,
+        validators=all_validators,
+        version=version,
+        type_checker=type_checker,
+        id_of=validator.ID_OF,
+    )
+
+
+Draft3Validator = create(
+    meta_schema=_utils.load_schema("draft3"),
+    validators={
+        u"$ref": _validators.ref,
+        u"additionalItems": _validators.additionalItems,
+        u"additionalProperties": _validators.additionalProperties,
+        u"dependencies": _legacy_validators.dependencies_draft3,
+        u"disallow": _legacy_validators.disallow_draft3,
+        u"divisibleBy": _validators.multipleOf,
+        u"enum": _validators.enum,
+        u"extends": _legacy_validators.extends_draft3,
+        u"format": _validators.format,
+        u"items": _legacy_validators.items_draft3_draft4,
+        u"maxItems": _validators.maxItems,
+        u"maxLength": _validators.maxLength,
+        u"maximum": _legacy_validators.maximum_draft3_draft4,
+        u"minItems": _validators.minItems,
+        u"minLength": _validators.minLength,
+        u"minimum": _legacy_validators.minimum_draft3_draft4,
+        u"pattern": _validators.pattern,
+        u"patternProperties": _validators.patternProperties,
+        u"properties": _legacy_validators.properties_draft3,
+        u"type": _legacy_validators.type_draft3,
+        u"uniqueItems": _validators.uniqueItems,
+    },
+    type_checker=_types.draft3_type_checker,
+    version="draft3",
+    id_of=lambda schema: schema.get(u"id", ""),
+)
+
+Draft4Validator = create(
+    meta_schema=_utils.load_schema("draft4"),
+    validators={
+        u"$ref": _validators.ref,
+        u"additionalItems": _validators.additionalItems,
+        u"additionalProperties": _validators.additionalProperties,
+        u"allOf": _validators.allOf,
+        u"anyOf": _validators.anyOf,
+        u"dependencies": _validators.dependencies,
+        u"enum": _validators.enum,
+        u"format": _validators.format,
+        u"items": _legacy_validators.items_draft3_draft4,
+        u"maxItems": _validators.maxItems,
+        u"maxLength": _validators.maxLength,
+        u"maxProperties": _validators.maxProperties,
+        u"maximum": _legacy_validators.maximum_draft3_draft4,
+        u"minItems": _validators.minItems,
+        u"minLength": _validators.minLength,
+        u"minProperties": _validators.minProperties,
+        u"minimum": _legacy_validators.minimum_draft3_draft4,
+        u"multipleOf": _validators.multipleOf,
+        u"not": _validators.not_,
+        u"oneOf": _validators.oneOf,
+        u"pattern": _validators.pattern,
+        u"patternProperties": _validators.patternProperties,
+        u"properties": _validators.properties,
+        u"required": _validators.required,
+        u"type": _validators.type,
+        u"uniqueItems": _validators.uniqueItems,
+    },
+    type_checker=_types.draft4_type_checker,
+    version="draft4",
+    id_of=lambda schema: schema.get(u"id", ""),
+)
+
+Draft6Validator = create(
+    meta_schema=_utils.load_schema("draft6"),
+    validators={
+        u"$ref": _validators.ref,
+        u"additionalItems": _validators.additionalItems,
+        u"additionalProperties": _validators.additionalProperties,
+        u"allOf": _validators.allOf,
+        u"anyOf": _validators.anyOf,
+        u"const": _validators.const,
+        u"contains": _validators.contains,
+        u"dependencies": _validators.dependencies,
+        u"enum": _validators.enum,
+        u"exclusiveMaximum": _validators.exclusiveMaximum,
+        u"exclusiveMinimum": _validators.exclusiveMinimum,
+        u"format": _validators.format,
+        u"items": _validators.items,
+        u"maxItems": _validators.maxItems,
+        u"maxLength": _validators.maxLength,
+        u"maxProperties": _validators.maxProperties,
+        u"maximum": _validators.maximum,
+        u"minItems": _validators.minItems,
+        u"minLength": _validators.minLength,
+        u"minProperties": _validators.minProperties,
+        u"minimum": _validators.minimum,
+        u"multipleOf": _validators.multipleOf,
+        u"not": _validators.not_,
+        u"oneOf": _validators.oneOf,
+        u"pattern": _validators.pattern,
+        u"patternProperties": _validators.patternProperties,
+        u"properties": _validators.properties,
+        u"propertyNames": _validators.propertyNames,
+        u"required": _validators.required,
+        u"type": _validators.type,
+        u"uniqueItems": _validators.uniqueItems,
+    },
+    type_checker=_types.draft6_type_checker,
+    version="draft6",
+)
+
+Draft7Validator = create(
+    meta_schema=_utils.load_schema("draft7"),
+    validators={
+        u"$ref": _validators.ref,
+        u"additionalItems": _validators.additionalItems,
+        u"additionalProperties": _validators.additionalProperties,
+        u"allOf": _validators.allOf,
+        u"anyOf": _validators.anyOf,
+        u"const": _validators.const,
+        u"contains": _validators.contains,
+        u"dependencies": _validators.dependencies,
+        u"enum": _validators.enum,
+        u"exclusiveMaximum": _validators.exclusiveMaximum,
+        u"exclusiveMinimum": _validators.exclusiveMinimum,
+        u"format": _validators.format,
+        u"if": _validators.if_,
+        u"items": _validators.items,
+        u"maxItems": _validators.maxItems,
+        u"maxLength": _validators.maxLength,
+        u"maxProperties": _validators.maxProperties,
+        u"maximum": _validators.maximum,
+        u"minItems": _validators.minItems,
+        u"minLength": _validators.minLength,
+        u"minProperties": _validators.minProperties,
+        u"minimum": _validators.minimum,
+        u"multipleOf": _validators.multipleOf,
+        u"oneOf": _validators.oneOf,
+        u"not": _validators.not_,
+        u"pattern": _validators.pattern,
+        u"patternProperties": _validators.patternProperties,
+        u"properties": _validators.properties,
+        u"propertyNames": _validators.propertyNames,
+        u"required": _validators.required,
+        u"type": _validators.type,
+        u"uniqueItems": _validators.uniqueItems,
+    },
+    type_checker=_types.draft7_type_checker,
+    version="draft7",
+)
+
+_LATEST_VERSION = Draft7Validator
+
+
+class RefResolver(object):
+    """
+    Resolve JSON References.
+
+    Arguments:
+
+        base_uri (str):
+
+            The URI of the referring document
+
+        referrer:
+
+            The actual referring document
+
+        store (dict):
+
+            A mapping from URIs to documents to cache
+
+        cache_remote (bool):
+
+            Whether remote refs should be cached after first resolution
+
+        handlers (dict):
+
+            A mapping from URI schemes to functions that should be used
+            to retrieve them
+
+        urljoin_cache (:func:`functools.lru_cache`):
+
+            A cache that will be used for caching the results of joining
+            the resolution scope to subscopes.
+
+        remote_cache (:func:`functools.lru_cache`):
+
+            A cache that will be used for caching the results of
+            resolved remote URLs.
+
+    Attributes:
+
+        cache_remote (bool):
+
+            Whether remote refs should be cached after first resolution
+    """
+
+    def __init__(
+        self,
+        base_uri,
+        referrer,
+        store=(),
+        cache_remote=True,
+        handlers=(),
+        urljoin_cache=None,
+        remote_cache=None,
+    ):
+        if urljoin_cache is None:
+            urljoin_cache = lru_cache(1024)(urljoin)
+        if remote_cache is None:
+            remote_cache = lru_cache(1024)(self.resolve_from_url)
+
+        self.referrer = referrer
+        self.cache_remote = cache_remote
+        self.handlers = dict(handlers)
+
+        self._scopes_stack = [base_uri]
+        self.store = _utils.URIDict(
+            (id, validator.META_SCHEMA)
+            for id, validator in iteritems(meta_schemas)
+        )
+        self.store.update(store)
+        self.store[base_uri] = referrer
+
+        self._urljoin_cache = urljoin_cache
+        self._remote_cache = remote_cache
+
+    @classmethod
+    def from_schema(cls, schema, id_of=_id_of, *args, **kwargs):
+        """
+        Construct a resolver from a JSON schema object.
+
+        Arguments:
+
+            schema:
+
+                the referring schema
+
+        Returns:
+
+            `RefResolver`
+        """
+
+        return cls(base_uri=id_of(schema), referrer=schema, *args, **kwargs)
+
+    def push_scope(self, scope):
+        """
+        Enter a given sub-scope.
+
+        Treats further dereferences as being performed underneath the
+        given scope.
+        """
+        self._scopes_stack.append(
+            self._urljoin_cache(self.resolution_scope, scope),
+        )
+
+    def pop_scope(self):
+        """
+        Exit the most recent entered scope.
+
+        Treats further dereferences as being performed underneath the
+        original scope.
+
+        Don't call this method more times than `push_scope` has been
+        called.
+        """
+        try:
+            self._scopes_stack.pop()
+        except IndexError:
+            raise exceptions.RefResolutionError(
+                "Failed to pop the scope from an empty stack. "
+                "`pop_scope()` should only be called once for every "
+                "`push_scope()`"
+            )
+
+    @property
+    def resolution_scope(self):
+        """
+        Retrieve the current resolution scope.
+        """
+        return self._scopes_stack[-1]
+
+    @property
+    def base_uri(self):
+        """
+        Retrieve the current base URI, not including any fragment.
+        """
+        uri, _ = urldefrag(self.resolution_scope)
+        return uri
+
+    @contextlib.contextmanager
+    def in_scope(self, scope):
+        """
+        Temporarily enter the given scope for the duration of the context.
+        """
+        self.push_scope(scope)
+        try:
+            yield
+        finally:
+            self.pop_scope()
+
+    @contextlib.contextmanager
+    def resolving(self, ref):
+        """
+        Resolve the given ``ref`` and enter its resolution scope.
+
+        Exits the scope on exit of this context manager.
+
+        Arguments:
+
+            ref (str):
+
+                The reference to resolve
+        """
+
+        url, resolved = self.resolve(ref)
+        self.push_scope(url)
+        try:
+            yield resolved
+        finally:
+            self.pop_scope()
+
+    def resolve(self, ref):
+        """
+        Resolve the given reference.
+        """
+        url = self._urljoin_cache(self.resolution_scope, ref)
+        return url, self._remote_cache(url)
+
+    def resolve_from_url(self, url):
+        """
+        Resolve the given remote URL.
+        """
+        url, fragment = urldefrag(url)
+        try:
+            document = self.store[url]
+        except KeyError:
+            try:
+                document = self.resolve_remote(url)
+            except Exception as exc:
+                raise exceptions.RefResolutionError(exc)
+
+        return self.resolve_fragment(document, fragment)
+
+    def resolve_fragment(self, document, fragment):
+        """
+        Resolve a ``fragment`` within the referenced ``document``.
+
+        Arguments:
+
+            document:
+
+                The referent document
+
+            fragment (str):
+
+                a URI fragment to resolve within it
+        """
+
+        fragment = fragment.lstrip(u"/")
+        parts = unquote(fragment).split(u"/") if fragment else []
+
+        for part in parts:
+            part = part.replace(u"~1", u"/").replace(u"~0", u"~")
+
+            if isinstance(document, Sequence):
+                # Array indexes should be turned into integers
+                try:
+                    part = int(part)
+                except ValueError:
+                    pass
+            try:
+                document = document[part]
+            except (TypeError, LookupError):
+                raise exceptions.RefResolutionError(
+                    "Unresolvable JSON pointer: %r" % fragment
+                )
+
+        return document
+
+    def resolve_remote(self, uri):
+        """
+        Resolve a remote ``uri``.
+
+        If called directly, does not check the store first, but after
+        retrieving the document at the specified URI it will be saved in
+        the store if :attr:`cache_remote` is True.
+
+        .. note::
+
+            If the requests_ library is present, ``jsonschema`` will use it to
+            request the remote ``uri``, so that the correct encoding is
+            detected and used.
+
+            If it isn't, or if the scheme of the ``uri`` is not ``http`` or
+            ``https``, UTF-8 is assumed.
+
+        Arguments:
+
+            uri (str):
+
+                The URI to resolve
+
+        Returns:
+
+            The retrieved document
+
+        .. _requests: https://pypi.org/project/requests/
+        """
+        try:
+            import requests
+        except ImportError:
+            requests = None
+
+        scheme = urlsplit(uri).scheme
+
+        if scheme in self.handlers:
+            result = self.handlers[scheme](uri)
+        elif scheme in [u"http", u"https"] and requests:
+            # Requests has support for detecting the correct encoding of
+            # json over http
+            result = requests.get(uri).json()
+        else:
+            # Otherwise, pass off to urllib and assume utf-8
+            with urlopen(uri) as url:
+                result = json.loads(url.read().decode("utf-8"))
+
+        if self.cache_remote:
+            self.store[uri] = result
+        return result
+
+
+def validate(instance, schema, cls=None, *args, **kwargs):
+    """
+    Validate an instance under the given schema.
+
+        >>> validate([2, 3, 4], {"maxItems": 2})
+        Traceback (most recent call last):
+            ...
+        ValidationError: [2, 3, 4] is too long
+
+    :func:`validate` will first verify that the provided schema is
+    itself valid, since not doing so can lead to less obvious error
+    messages and fail in less obvious or consistent ways.
+
+    If you know you have a valid schema already, especially if you
+    intend to validate multiple instances with the same schema, you
+    likely would prefer using the `IValidator.validate` method directly
+    on a specific validator (e.g. ``Draft7Validator.validate``).
+
+
+    Arguments:
+
+        instance:
+
+            The instance to validate
+
+        schema:
+
+            The schema to validate with
+
+        cls (IValidator):
+
+            The class that will be used to validate the instance.
+
+    If the ``cls`` argument is not provided, two things will happen
+    in accordance with the specification. First, if the schema has a
+    :validator:`$schema` property containing a known meta-schema [#]_
+    then the proper validator will be used. The specification recommends
+    that all schemas contain :validator:`$schema` properties for this
+    reason. If no :validator:`$schema` property is found, the default
+    validator class is the latest released draft.
+
+    Any other provided positional and keyword arguments will be passed
+    on when instantiating the ``cls``.
+
+    Raises:
+
+        `jsonschema.exceptions.ValidationError` if the instance
+            is invalid
+
+        `jsonschema.exceptions.SchemaError` if the schema itself
+            is invalid
+
+    .. rubric:: Footnotes
+    .. [#] known by a validator registered with
+        `jsonschema.validators.validates`
+    """
+    if cls is None:
+        cls = validator_for(schema)
+
+    cls.check_schema(schema)
+    validator = cls(schema, *args, **kwargs)
+    error = exceptions.best_match(validator.iter_errors(instance))
+    if error is not None:
+        raise error
+
+
+def validator_for(schema, default=_LATEST_VERSION):
+    """
+    Retrieve the validator class appropriate for validating the given schema.
+
+    Uses the :validator:`$schema` property that should be present in the
+    given schema to look up the appropriate validator class.
+
+    Arguments:
+
+        schema (collections.Mapping or bool):
+
+            the schema to look at
+
+        default:
+
+            the default to return if the appropriate validator class
+            cannot be determined.
+
+            If unprovided, the default is to return the latest supported
+            draft.
+    """
+    if schema is True or schema is False or u"$schema" not in schema:
+        return default
+    if schema[u"$schema"] not in meta_schemas:
+        warn(
+            (
+                "The metaschema specified by $schema was not found. "
+                "Using the latest draft to validate, but this will raise "
+                "an error in the future."
+            ),
+            DeprecationWarning,
+            stacklevel=2,
+        )
+    return meta_schemas.get(schema[u"$schema"], _LATEST_VERSION)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..7097847e04b6b840ecb8ddf0a383b2066d24e4a8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/METADATA
@@ -0,0 +1,58 @@
+Metadata-Version: 2.1
+Name: lockfile
+Version: 0.12.2
+Summary: Platform-independent file locking module
+Home-page: http://launchpad.net/pylockfile
+Author: OpenStack
+Author-email: openstack-dev@lists.openstack.org
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows NT/2000
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+
+Note: This package is **deprecated**. It is highly preferred that instead of
+using this code base that instead `fasteners`_ or `oslo.concurrency`_ is
+used instead. For any questions or comments or further help needed
+please email `openstack-dev`_ and prefix your email subject
+with ``[oslo][pylockfile]`` (for a faster response).
+
+The lockfile package exports a LockFile class which provides a simple API for
+locking files.  Unlike the Windows msvcrt.locking function, the fcntl.lockf
+and flock functions, and the deprecated posixfile module, the API is
+identical across both Unix (including Linux and Mac) and Windows platforms.
+The lock mechanism relies on the atomic nature of the link (on Unix) and
+mkdir (on Windows) system calls.  An implementation based on SQLite is also
+provided, more as a demonstration of the possibilities it provides than as
+production-quality code.
+
+Note: In version 0.9 the API changed in two significant ways:
+
+ * It changed from a module defining several classes to a package containing
+   several modules, each defining a single class.
+
+ * Where classes had been named SomethingFileLock before the last two words
+   have been reversed, so that class is now SomethingLockFile.
+
+The previous module-level definitions of LinkFileLock, MkdirFileLock and
+SQLiteFileLock will be retained until the 1.0 release.
+
+To install:
+
+    python setup.py install
+
+* Documentation: http://docs.openstack.org/developer/pylockfile
+* Source: http://git.openstack.org/cgit/openstack/pylockfile
+* Bugs: http://bugs.launchpad.net/pylockfile
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c6cfb077e2bd929f46daded575fc8d97262099f8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/RECORD
@@ -0,0 +1,23 @@
+lockfile/__init__.py,sha256=4q4v9CodOUWdpaOuzROpZkppdqze2MLM2jAQPSdJvOw,9342
+lockfile/linklockfile.py,sha256=C7OH3H4GdK68u4FQgp8fkP2kO4fyUTSyj3X6blgfobc,2652
+lockfile/mkdirlockfile.py,sha256=e3qgIL-etZMLsS-3ft19iW_8IQ360HNkGOqE3yBKsUw,3096
+lockfile/pidlockfile.py,sha256=ukH9uk6NFuxyVmG5QiWw4iKq3fT7MjqUguX95avYPIY,6090
+lockfile/sqlitelockfile.py,sha256=o2TMkMRY0iwn-iL1XMRRIFStMUkS4i3ajceeYNntKFg,5506
+lockfile/symlinklockfile.py,sha256=ABwXXmvTHvCl5viPblShL3PG-gGsLiT1roAMfDRwhi8,2616
+lockfile-0.12.2.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+lockfile-0.12.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+lockfile-0.12.2.dist-info/METADATA,sha256=N7YwOVJYQKl5t5n94Uu7oUmbiefluUDz4M3m7fRx3e4,2405
+lockfile-0.12.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+lockfile-0.12.2.dist-info/pbr.json,sha256=4aAg5-11k9KOvFsLsdVv3x1Lb3n-C2lNuhpISm39OIY,46
+lockfile-0.12.2.dist-info/top_level.txt,sha256=PQq-Po-WMcEqQullMaagcnpHUvsVUI6_MNygWWB_SY0,9
+lockfile-0.12.2.dist-info/RECORD,,
+lockfile/symlinklockfile.cpython-38.pyc,,
+lockfile/__init__.cpython-38.pyc,,
+lockfile-0.12.2.virtualenv,,
+lockfile/sqlitelockfile.cpython-38.pyc,,
+lockfile/__pycache__,,
+lockfile-0.12.2.dist-info/INSTALLER,,
+lockfile/mkdirlockfile.cpython-38.pyc,,
+lockfile/linklockfile.cpython-38.pyc,,
+lockfile-0.12.2.dist-info/__pycache__,,
+lockfile/pidlockfile.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/pbr.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/pbr.json
new file mode 100644
index 0000000000000000000000000000000000000000..56252f0674fd49e6627a6097f42a172356dcbbc0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/pbr.json
@@ -0,0 +1 @@
+{"git_version": "c8798ce", "is_release": true}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..5a13159a8094e9fbce99a6fdc018d1a8a4d295a8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+lockfile
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile-0.12.2.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4b1436a7f15fb9c3e2ae96ad7da6ce7e17ef3d8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/__init__.py
@@ -0,0 +1,347 @@
+# -*- coding: utf-8 -*-
+
+"""
+lockfile.py - Platform-independent advisory file locks.
+
+Requires Python 2.5 unless you apply 2.4.diff
+Locking is done on a per-thread basis instead of a per-process basis.
+
+Usage:
+
+>>> lock = LockFile('somefile')
+>>> try:
+...     lock.acquire()
+... except AlreadyLocked:
+...     print('somefile', "is locked already.")
+... except LockFailed:
+...     print('somefile', "can't be locked.")
+... else:
+...     print("got lock")
+got lock
+>>> lock.is_locked()
+True
+>>> lock.release()
+
+>>> lock = LockFile('somefile')
+>>> lock.is_locked()
+False
+>>> with lock:
+...    lock.is_locked()
+True
+>>> lock.is_locked()
+False
+
+>>> lock = LockFile('somefile')
+>>> # It is okay to lock twice from the same thread...
+>>> with lock:
+...     lock.acquire()
+...
+>>> # Though no counter is kept, so you can't unlock multiple times...
+>>> lock.is_locked()
+False
+
+Exceptions:
+
+    Error - base class for other exceptions
+        LockError - base class for all locking exceptions
+            AlreadyLocked - Another thread or process already holds the lock
+            LockFailed - Lock failed for some other reason
+        UnlockError - base class for all unlocking exceptions
+            AlreadyUnlocked - File was not locked.
+            NotMyLock - File was locked but not by the current thread/process
+"""
+
+from __future__ import absolute_import
+
+import functools
+import os
+import socket
+import threading
+import warnings
+
+# Work with PEP8 and non-PEP8 versions of threading module.
+if not hasattr(threading, "current_thread"):
+    threading.current_thread = threading.currentThread
+if not hasattr(threading.Thread, "get_name"):
+    threading.Thread.get_name = threading.Thread.getName
+
+__all__ = ['Error', 'LockError', 'LockTimeout', 'AlreadyLocked',
+           'LockFailed', 'UnlockError', 'NotLocked', 'NotMyLock',
+           'LinkFileLock', 'MkdirFileLock', 'SQLiteFileLock',
+           'LockBase', 'locked']
+
+
+class Error(Exception):
+    """
+    Base class for other exceptions.
+
+    >>> try:
+    ...   raise Error
+    ... except Exception:
+    ...   pass
+    """
+    pass
+
+
+class LockError(Error):
+    """
+    Base class for error arising from attempts to acquire the lock.
+
+    >>> try:
+    ...   raise LockError
+    ... except Error:
+    ...   pass
+    """
+    pass
+
+
+class LockTimeout(LockError):
+    """Raised when lock creation fails within a user-defined period of time.
+
+    >>> try:
+    ...   raise LockTimeout
+    ... except LockError:
+    ...   pass
+    """
+    pass
+
+
+class AlreadyLocked(LockError):
+    """Some other thread/process is locking the file.
+
+    >>> try:
+    ...   raise AlreadyLocked
+    ... except LockError:
+    ...   pass
+    """
+    pass
+
+
+class LockFailed(LockError):
+    """Lock file creation failed for some other reason.
+
+    >>> try:
+    ...   raise LockFailed
+    ... except LockError:
+    ...   pass
+    """
+    pass
+
+
+class UnlockError(Error):
+    """
+    Base class for errors arising from attempts to release the lock.
+
+    >>> try:
+    ...   raise UnlockError
+    ... except Error:
+    ...   pass
+    """
+    pass
+
+
+class NotLocked(UnlockError):
+    """Raised when an attempt is made to unlock an unlocked file.
+
+    >>> try:
+    ...   raise NotLocked
+    ... except UnlockError:
+    ...   pass
+    """
+    pass
+
+
+class NotMyLock(UnlockError):
+    """Raised when an attempt is made to unlock a file someone else locked.
+
+    >>> try:
+    ...   raise NotMyLock
+    ... except UnlockError:
+    ...   pass
+    """
+    pass
+
+
+class _SharedBase(object):
+    def __init__(self, path):
+        self.path = path
+
+    def acquire(self, timeout=None):
+        """
+        Acquire the lock.
+
+        * If timeout is omitted (or None), wait forever trying to lock the
+          file.
+
+        * If timeout > 0, try to acquire the lock for that many seconds.  If
+          the lock period expires and the file is still locked, raise
+          LockTimeout.
+
+        * If timeout <= 0, raise AlreadyLocked immediately if the file is
+          already locked.
+        """
+        raise NotImplemented("implement in subclass")
+
+    def release(self):
+        """
+        Release the lock.
+
+        If the file is not locked, raise NotLocked.
+        """
+        raise NotImplemented("implement in subclass")
+
+    def __enter__(self):
+        """
+        Context manager support.
+        """
+        self.acquire()
+        return self
+
+    def __exit__(self, *_exc):
+        """
+        Context manager support.
+        """
+        self.release()
+
+    def __repr__(self):
+        return "<%s: %r>" % (self.__class__.__name__, self.path)
+
+
+class LockBase(_SharedBase):
+    """Base class for platform-specific lock classes."""
+    def __init__(self, path, threaded=True, timeout=None):
+        """
+        >>> lock = LockBase('somefile')
+        >>> lock = LockBase('somefile', threaded=False)
+        """
+        super(LockBase, self).__init__(path)
+        self.lock_file = os.path.abspath(path) + ".lock"
+        self.hostname = socket.gethostname()
+        self.pid = os.getpid()
+        if threaded:
+            t = threading.current_thread()
+            # Thread objects in Python 2.4 and earlier do not have ident
+            # attrs.  Worm around that.
+            ident = getattr(t, "ident", hash(t))
+            self.tname = "-%x" % (ident & 0xffffffff)
+        else:
+            self.tname = ""
+        dirname = os.path.dirname(self.lock_file)
+
+        # unique name is mostly about the current process, but must
+        # also contain the path -- otherwise, two adjacent locked
+        # files conflict (one file gets locked, creating lock-file and
+        # unique file, the other one gets locked, creating lock-file
+        # and overwriting the already existing lock-file, then one
+        # gets unlocked, deleting both lock-file and unique file,
+        # finally the last lock errors out upon releasing.
+        self.unique_name = os.path.join(dirname,
+                                        "%s%s.%s%s" % (self.hostname,
+                                                       self.tname,
+                                                       self.pid,
+                                                       hash(self.path)))
+        self.timeout = timeout
+
+    def is_locked(self):
+        """
+        Tell whether or not the file is locked.
+        """
+        raise NotImplemented("implement in subclass")
+
+    def i_am_locking(self):
+        """
+        Return True if this object is locking the file.
+        """
+        raise NotImplemented("implement in subclass")
+
+    def break_lock(self):
+        """
+        Remove a lock.  Useful if a locking thread failed to unlock.
+        """
+        raise NotImplemented("implement in subclass")
+
+    def __repr__(self):
+        return "<%s: %r -- %r>" % (self.__class__.__name__, self.unique_name,
+                                   self.path)
+
+
+def _fl_helper(cls, mod, *args, **kwds):
+    warnings.warn("Import from %s module instead of lockfile package" % mod,
+                  DeprecationWarning, stacklevel=2)
+    # This is a bit funky, but it's only for awhile.  The way the unit tests
+    # are constructed this function winds up as an unbound method, so it
+    # actually takes three args, not two.  We want to toss out self.
+    if not isinstance(args[0], str):
+        # We are testing, avoid the first arg
+        args = args[1:]
+    if len(args) == 1 and not kwds:
+        kwds["threaded"] = True
+    return cls(*args, **kwds)
+
+
+def LinkFileLock(*args, **kwds):
+    """Factory function provided for backwards compatibility.
+
+    Do not use in new code.  Instead, import LinkLockFile from the
+    lockfile.linklockfile module.
+    """
+    from . import linklockfile
+    return _fl_helper(linklockfile.LinkLockFile, "lockfile.linklockfile",
+                      *args, **kwds)
+
+
+def MkdirFileLock(*args, **kwds):
+    """Factory function provided for backwards compatibility.
+
+    Do not use in new code.  Instead, import MkdirLockFile from the
+    lockfile.mkdirlockfile module.
+    """
+    from . import mkdirlockfile
+    return _fl_helper(mkdirlockfile.MkdirLockFile, "lockfile.mkdirlockfile",
+                      *args, **kwds)
+
+
+def SQLiteFileLock(*args, **kwds):
+    """Factory function provided for backwards compatibility.
+
+    Do not use in new code.  Instead, import SQLiteLockFile from the
+    lockfile.mkdirlockfile module.
+    """
+    from . import sqlitelockfile
+    return _fl_helper(sqlitelockfile.SQLiteLockFile, "lockfile.sqlitelockfile",
+                      *args, **kwds)
+
+
+def locked(path, timeout=None):
+    """Decorator which enables locks for decorated function.
+
+    Arguments:
+     - path: path for lockfile.
+     - timeout (optional): Timeout for acquiring lock.
+
+     Usage:
+         @locked('/var/run/myname', timeout=0)
+         def myname(...):
+             ...
+    """
+    def decor(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            lock = FileLock(path, timeout=timeout)
+            lock.acquire()
+            try:
+                return func(*args, **kwargs)
+            finally:
+                lock.release()
+        return wrapper
+    return decor
+
+
+if hasattr(os, "link"):
+    from . import linklockfile as _llf
+    LockFile = _llf.LinkLockFile
+else:
+    from . import mkdirlockfile as _mlf
+    LockFile = _mlf.MkdirLockFile
+
+FileLock = LockFile
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/linklockfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/linklockfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ca9be0423591e61b3382b559473fcc56363cc46
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/linklockfile.py
@@ -0,0 +1,73 @@
+from __future__ import absolute_import
+
+import time
+import os
+
+from . import (LockBase, LockFailed, NotLocked, NotMyLock, LockTimeout,
+               AlreadyLocked)
+
+
+class LinkLockFile(LockBase):
+    """Lock access to a file using atomic property of link(2).
+
+    >>> lock = LinkLockFile('somefile')
+    >>> lock = LinkLockFile('somefile', threaded=False)
+    """
+
+    def acquire(self, timeout=None):
+        try:
+            open(self.unique_name, "wb").close()
+        except IOError:
+            raise LockFailed("failed to create %s" % self.unique_name)
+
+        timeout = timeout if timeout is not None else self.timeout
+        end_time = time.time()
+        if timeout is not None and timeout > 0:
+            end_time += timeout
+
+        while True:
+            # Try and create a hard link to it.
+            try:
+                os.link(self.unique_name, self.lock_file)
+            except OSError:
+                # Link creation failed.  Maybe we've double-locked?
+                nlinks = os.stat(self.unique_name).st_nlink
+                if nlinks == 2:
+                    # The original link plus the one I created == 2.  We're
+                    # good to go.
+                    return
+                else:
+                    # Otherwise the lock creation failed.
+                    if timeout is not None and time.time() > end_time:
+                        os.unlink(self.unique_name)
+                        if timeout > 0:
+                            raise LockTimeout("Timeout waiting to acquire"
+                                              " lock for %s" %
+                                              self.path)
+                        else:
+                            raise AlreadyLocked("%s is already locked" %
+                                                self.path)
+                    time.sleep(timeout is not None and timeout / 10 or 0.1)
+            else:
+                # Link creation succeeded.  We're good to go.
+                return
+
+    def release(self):
+        if not self.is_locked():
+            raise NotLocked("%s is not locked" % self.path)
+        elif not os.path.exists(self.unique_name):
+            raise NotMyLock("%s is locked, but not by me" % self.path)
+        os.unlink(self.unique_name)
+        os.unlink(self.lock_file)
+
+    def is_locked(self):
+        return os.path.exists(self.lock_file)
+
+    def i_am_locking(self):
+        return (self.is_locked() and
+                os.path.exists(self.unique_name) and
+                os.stat(self.unique_name).st_nlink == 2)
+
+    def break_lock(self):
+        if os.path.exists(self.lock_file):
+            os.unlink(self.lock_file)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/mkdirlockfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/mkdirlockfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..05a8c96ca517271bbd4953d0cf83dc4173521b2e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/mkdirlockfile.py
@@ -0,0 +1,84 @@
+from __future__ import absolute_import, division
+
+import time
+import os
+import sys
+import errno
+
+from . import (LockBase, LockFailed, NotLocked, NotMyLock, LockTimeout,
+               AlreadyLocked)
+
+
+class MkdirLockFile(LockBase):
+    """Lock file by creating a directory."""
+    def __init__(self, path, threaded=True, timeout=None):
+        """
+        >>> lock = MkdirLockFile('somefile')
+        >>> lock = MkdirLockFile('somefile', threaded=False)
+        """
+        LockBase.__init__(self, path, threaded, timeout)
+        # Lock file itself is a directory.  Place the unique file name into
+        # it.
+        self.unique_name = os.path.join(self.lock_file,
+                                        "%s.%s%s" % (self.hostname,
+                                                     self.tname,
+                                                     self.pid))
+
+    def acquire(self, timeout=None):
+        timeout = timeout if timeout is not None else self.timeout
+        end_time = time.time()
+        if timeout is not None and timeout > 0:
+            end_time += timeout
+
+        if timeout is None:
+            wait = 0.1
+        else:
+            wait = max(0, timeout / 10)
+
+        while True:
+            try:
+                os.mkdir(self.lock_file)
+            except OSError:
+                err = sys.exc_info()[1]
+                if err.errno == errno.EEXIST:
+                    # Already locked.
+                    if os.path.exists(self.unique_name):
+                        # Already locked by me.
+                        return
+                    if timeout is not None and time.time() > end_time:
+                        if timeout > 0:
+                            raise LockTimeout("Timeout waiting to acquire"
+                                              " lock for %s" %
+                                              self.path)
+                        else:
+                            # Someone else has the lock.
+                            raise AlreadyLocked("%s is already locked" %
+                                                self.path)
+                    time.sleep(wait)
+                else:
+                    # Couldn't create the lock for some other reason
+                    raise LockFailed("failed to create %s" % self.lock_file)
+            else:
+                open(self.unique_name, "wb").close()
+                return
+
+    def release(self):
+        if not self.is_locked():
+            raise NotLocked("%s is not locked" % self.path)
+        elif not os.path.exists(self.unique_name):
+            raise NotMyLock("%s is locked, but not by me" % self.path)
+        os.unlink(self.unique_name)
+        os.rmdir(self.lock_file)
+
+    def is_locked(self):
+        return os.path.exists(self.lock_file)
+
+    def i_am_locking(self):
+        return (self.is_locked() and
+                os.path.exists(self.unique_name))
+
+    def break_lock(self):
+        if os.path.exists(self.lock_file):
+            for name in os.listdir(self.lock_file):
+                os.unlink(os.path.join(self.lock_file, name))
+            os.rmdir(self.lock_file)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/pidlockfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/pidlockfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..069e85b15bdfcb4fd7042222516fbfb046db06c9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/pidlockfile.py
@@ -0,0 +1,190 @@
+# -*- coding: utf-8 -*-
+
+# pidlockfile.py
+#
+# Copyright © 2008–2009 Ben Finney <ben+python@benfinney.id.au>
+#
+# This is free software: you may copy, modify, and/or distribute this work
+# under the terms of the Python Software Foundation License, version 2 or
+# later as published by the Python Software Foundation.
+# No warranty expressed or implied. See the file LICENSE.PSF-2 for details.
+
+""" Lockfile behaviour implemented via Unix PID files.
+    """
+
+from __future__ import absolute_import
+
+import errno
+import os
+import time
+
+from . import (LockBase, AlreadyLocked, LockFailed, NotLocked, NotMyLock,
+               LockTimeout)
+
+
+class PIDLockFile(LockBase):
+    """ Lockfile implemented as a Unix PID file.
+
+    The lock file is a normal file named by the attribute `path`.
+    A lock's PID file contains a single line of text, containing
+    the process ID (PID) of the process that acquired the lock.
+
+    >>> lock = PIDLockFile('somefile')
+    >>> lock = PIDLockFile('somefile')
+    """
+
+    def __init__(self, path, threaded=False, timeout=None):
+        # pid lockfiles don't support threaded operation, so always force
+        # False as the threaded arg.
+        LockBase.__init__(self, path, False, timeout)
+        self.unique_name = self.path
+
+    def read_pid(self):
+        """ Get the PID from the lock file.
+            """
+        return read_pid_from_pidfile(self.path)
+
+    def is_locked(self):
+        """ Test if the lock is currently held.
+
+            The lock is held if the PID file for this lock exists.
+
+            """
+        return os.path.exists(self.path)
+
+    def i_am_locking(self):
+        """ Test if the lock is held by the current process.
+
+        Returns ``True`` if the current process ID matches the
+        number stored in the PID file.
+        """
+        return self.is_locked() and os.getpid() == self.read_pid()
+
+    def acquire(self, timeout=None):
+        """ Acquire the lock.
+
+        Creates the PID file for this lock, or raises an error if
+        the lock could not be acquired.
+        """
+
+        timeout = timeout if timeout is not None else self.timeout
+        end_time = time.time()
+        if timeout is not None and timeout > 0:
+            end_time += timeout
+
+        while True:
+            try:
+                write_pid_to_pidfile(self.path)
+            except OSError as exc:
+                if exc.errno == errno.EEXIST:
+                    # The lock creation failed.  Maybe sleep a bit.
+                    if time.time() > end_time:
+                        if timeout is not None and timeout > 0:
+                            raise LockTimeout("Timeout waiting to acquire"
+                                              " lock for %s" %
+                                              self.path)
+                        else:
+                            raise AlreadyLocked("%s is already locked" %
+                                                self.path)
+                    time.sleep(timeout is not None and timeout / 10 or 0.1)
+                else:
+                    raise LockFailed("failed to create %s" % self.path)
+            else:
+                return
+
+    def release(self):
+        """ Release the lock.
+
+            Removes the PID file to release the lock, or raises an
+            error if the current process does not hold the lock.
+
+            """
+        if not self.is_locked():
+            raise NotLocked("%s is not locked" % self.path)
+        if not self.i_am_locking():
+            raise NotMyLock("%s is locked, but not by me" % self.path)
+        remove_existing_pidfile(self.path)
+
+    def break_lock(self):
+        """ Break an existing lock.
+
+            Removes the PID file if it already exists, otherwise does
+            nothing.
+
+            """
+        remove_existing_pidfile(self.path)
+
+
+def read_pid_from_pidfile(pidfile_path):
+    """ Read the PID recorded in the named PID file.
+
+        Read and return the numeric PID recorded as text in the named
+        PID file. If the PID file cannot be read, or if the content is
+        not a valid PID, return ``None``.
+
+        """
+    pid = None
+    try:
+        pidfile = open(pidfile_path, 'r')
+    except IOError:
+        pass
+    else:
+        # According to the FHS 2.3 section on PID files in /var/run:
+        #
+        #   The file must consist of the process identifier in
+        #   ASCII-encoded decimal, followed by a newline character.
+        #
+        #   Programs that read PID files should be somewhat flexible
+        #   in what they accept; i.e., they should ignore extra
+        #   whitespace, leading zeroes, absence of the trailing
+        #   newline, or additional lines in the PID file.
+
+        line = pidfile.readline().strip()
+        try:
+            pid = int(line)
+        except ValueError:
+            pass
+        pidfile.close()
+
+    return pid
+
+
+def write_pid_to_pidfile(pidfile_path):
+    """ Write the PID in the named PID file.
+
+        Get the numeric process ID (“PID”) of the current process
+        and write it to the named file as a line of text.
+
+        """
+    open_flags = (os.O_CREAT | os.O_EXCL | os.O_WRONLY)
+    open_mode = 0o644
+    pidfile_fd = os.open(pidfile_path, open_flags, open_mode)
+    pidfile = os.fdopen(pidfile_fd, 'w')
+
+    # According to the FHS 2.3 section on PID files in /var/run:
+    #
+    #   The file must consist of the process identifier in
+    #   ASCII-encoded decimal, followed by a newline character. For
+    #   example, if crond was process number 25, /var/run/crond.pid
+    #   would contain three characters: two, five, and newline.
+
+    pid = os.getpid()
+    pidfile.write("%s\n" % pid)
+    pidfile.close()
+
+
+def remove_existing_pidfile(pidfile_path):
+    """ Remove the named PID file if it exists.
+
+        Removing a PID file that doesn't already exist puts us in the
+        desired state, so we ignore the condition if the file does not
+        exist.
+
+        """
+    try:
+        os.remove(pidfile_path)
+    except OSError as exc:
+        if exc.errno == errno.ENOENT:
+            pass
+        else:
+            raise
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/sqlitelockfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/sqlitelockfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..f997e2444e75b176761965bbf3e1f82c5c3ad0e2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/sqlitelockfile.py
@@ -0,0 +1,156 @@
+from __future__ import absolute_import, division
+
+import time
+import os
+
+try:
+    unicode
+except NameError:
+    unicode = str
+
+from . import LockBase, NotLocked, NotMyLock, LockTimeout, AlreadyLocked
+
+
+class SQLiteLockFile(LockBase):
+    "Demonstrate SQL-based locking."
+
+    testdb = None
+
+    def __init__(self, path, threaded=True, timeout=None):
+        """
+        >>> lock = SQLiteLockFile('somefile')
+        >>> lock = SQLiteLockFile('somefile', threaded=False)
+        """
+        LockBase.__init__(self, path, threaded, timeout)
+        self.lock_file = unicode(self.lock_file)
+        self.unique_name = unicode(self.unique_name)
+
+        if SQLiteLockFile.testdb is None:
+            import tempfile
+            _fd, testdb = tempfile.mkstemp()
+            os.close(_fd)
+            os.unlink(testdb)
+            del _fd, tempfile
+            SQLiteLockFile.testdb = testdb
+
+        import sqlite3
+        self.connection = sqlite3.connect(SQLiteLockFile.testdb)
+
+        c = self.connection.cursor()
+        try:
+            c.execute("create table locks"
+                      "("
+                      "   lock_file varchar(32),"
+                      "   unique_name varchar(32)"
+                      ")")
+        except sqlite3.OperationalError:
+            pass
+        else:
+            self.connection.commit()
+            import atexit
+            atexit.register(os.unlink, SQLiteLockFile.testdb)
+
+    def acquire(self, timeout=None):
+        timeout = timeout if timeout is not None else self.timeout
+        end_time = time.time()
+        if timeout is not None and timeout > 0:
+            end_time += timeout
+
+        if timeout is None:
+            wait = 0.1
+        elif timeout <= 0:
+            wait = 0
+        else:
+            wait = timeout / 10
+
+        cursor = self.connection.cursor()
+
+        while True:
+            if not self.is_locked():
+                # Not locked.  Try to lock it.
+                cursor.execute("insert into locks"
+                               "  (lock_file, unique_name)"
+                               "  values"
+                               "  (?, ?)",
+                               (self.lock_file, self.unique_name))
+                self.connection.commit()
+
+                # Check to see if we are the only lock holder.
+                cursor.execute("select * from locks"
+                               "  where unique_name = ?",
+                               (self.unique_name,))
+                rows = cursor.fetchall()
+                if len(rows) > 1:
+                    # Nope.  Someone else got there.  Remove our lock.
+                    cursor.execute("delete from locks"
+                                   "  where unique_name = ?",
+                                   (self.unique_name,))
+                    self.connection.commit()
+                else:
+                    # Yup.  We're done, so go home.
+                    return
+            else:
+                # Check to see if we are the only lock holder.
+                cursor.execute("select * from locks"
+                               "  where unique_name = ?",
+                               (self.unique_name,))
+                rows = cursor.fetchall()
+                if len(rows) == 1:
+                    # We're the locker, so go home.
+                    return
+
+            # Maybe we should wait a bit longer.
+            if timeout is not None and time.time() > end_time:
+                if timeout > 0:
+                    # No more waiting.
+                    raise LockTimeout("Timeout waiting to acquire"
+                                      " lock for %s" %
+                                      self.path)
+                else:
+                    # Someone else has the lock and we are impatient..
+                    raise AlreadyLocked("%s is already locked" % self.path)
+
+            # Well, okay.  We'll give it a bit longer.
+            time.sleep(wait)
+
+    def release(self):
+        if not self.is_locked():
+            raise NotLocked("%s is not locked" % self.path)
+        if not self.i_am_locking():
+            raise NotMyLock("%s is locked, but not by me (by %s)" %
+                            (self.unique_name, self._who_is_locking()))
+        cursor = self.connection.cursor()
+        cursor.execute("delete from locks"
+                       "  where unique_name = ?",
+                       (self.unique_name,))
+        self.connection.commit()
+
+    def _who_is_locking(self):
+        cursor = self.connection.cursor()
+        cursor.execute("select unique_name from locks"
+                       "  where lock_file = ?",
+                       (self.lock_file,))
+        return cursor.fetchone()[0]
+
+    def is_locked(self):
+        cursor = self.connection.cursor()
+        cursor.execute("select * from locks"
+                       "  where lock_file = ?",
+                       (self.lock_file,))
+        rows = cursor.fetchall()
+        return not not rows
+
+    def i_am_locking(self):
+        cursor = self.connection.cursor()
+        cursor.execute("select * from locks"
+                       "  where lock_file = ?"
+                       "    and unique_name = ?",
+                       (self.lock_file, self.unique_name))
+        return not not cursor.fetchall()
+
+    def break_lock(self):
+        cursor = self.connection.cursor()
+        cursor.execute("delete from locks"
+                       "  where lock_file = ?",
+                       (self.lock_file,))
+        self.connection.commit()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/symlinklockfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/symlinklockfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..23b41f582b9f8d40a1375b47ed1fb25da12d0c3b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/lockfile/symlinklockfile.py
@@ -0,0 +1,70 @@
+from __future__ import absolute_import
+
+import os
+import time
+
+from . import (LockBase, NotLocked, NotMyLock, LockTimeout,
+               AlreadyLocked)
+
+
+class SymlinkLockFile(LockBase):
+    """Lock access to a file using symlink(2)."""
+
+    def __init__(self, path, threaded=True, timeout=None):
+        # super(SymlinkLockFile).__init(...)
+        LockBase.__init__(self, path, threaded, timeout)
+        # split it back!
+        self.unique_name = os.path.split(self.unique_name)[1]
+
+    def acquire(self, timeout=None):
+        # Hopefully unnecessary for symlink.
+        # try:
+        #     open(self.unique_name, "wb").close()
+        # except IOError:
+        #     raise LockFailed("failed to create %s" % self.unique_name)
+        timeout = timeout if timeout is not None else self.timeout
+        end_time = time.time()
+        if timeout is not None and timeout > 0:
+            end_time += timeout
+
+        while True:
+            # Try and create a symbolic link to it.
+            try:
+                os.symlink(self.unique_name, self.lock_file)
+            except OSError:
+                # Link creation failed.  Maybe we've double-locked?
+                if self.i_am_locking():
+                    # Linked to out unique name. Proceed.
+                    return
+                else:
+                    # Otherwise the lock creation failed.
+                    if timeout is not None and time.time() > end_time:
+                        if timeout > 0:
+                            raise LockTimeout("Timeout waiting to acquire"
+                                              " lock for %s" %
+                                              self.path)
+                        else:
+                            raise AlreadyLocked("%s is already locked" %
+                                                self.path)
+                    time.sleep(timeout / 10 if timeout is not None else 0.1)
+            else:
+                # Link creation succeeded.  We're good to go.
+                return
+
+    def release(self):
+        if not self.is_locked():
+            raise NotLocked("%s is not locked" % self.path)
+        elif not self.i_am_locking():
+            raise NotMyLock("%s is locked, but not by me" % self.path)
+        os.unlink(self.lock_file)
+
+    def is_locked(self):
+        return os.path.islink(self.lock_file)
+
+    def i_am_locking(self):
+        return (os.path.islink(self.lock_file)
+                and os.readlink(self.lock_file) == self.unique_name)
+
+    def break_lock(self):
+        if os.path.islink(self.lock_file):  # exists && link
+            os.unlink(self.lock_file)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/AUTHORS.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/AUTHORS.rst
new file mode 100644
index 0000000000000000000000000000000000000000..442654bcc4b42708ace8e3c97f40287dfa08149a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/AUTHORS.rst
@@ -0,0 +1,8 @@
+=======
+Credits
+=======
+
+Development Lead
+----------------
+
+* Juju UI Team <juju-gui@list.ubuntu.com>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..341c30bda4457610db4829294e5d7e526d4c835b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/LICENSE
@@ -0,0 +1,166 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..ee8a18e6f44d71b145abb5362057c36dc0c2bd7e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/METADATA
@@ -0,0 +1,67 @@
+Metadata-Version: 2.1
+Name: macaroonbakery
+Version: 1.3.1
+Summary: A Python library port for bakery, higher level operation to work with macaroons
+Home-page: https://github.com/go-macaroon-bakery/py-macaroon-bakery
+Author: Juju UI Team
+Author-email: juju-gui@lists.ubuntu.com
+License: LGPL3
+Keywords: macaroon cookie
+Platform: UNKNOWN
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Requires-Dist: PyNaCl (<2.0,>=1.1.2)
+Requires-Dist: protobuf (<4.0,>=3.0.0)
+Requires-Dist: pyRFC3339 (<2.0,>=1.0)
+Requires-Dist: pymacaroons (<1.0,>=0.12.0)
+Requires-Dist: requests (<3.0,>=2.18.1)
+Requires-Dist: six (<2.0,>=1.11.0)
+Requires-Dist: cryptography (==1.3.2) ; python_full_version < "2.7.9"
+Requires-Dist: ndg-httpsclient (==0.3.3) ; python_full_version < "2.7.9"
+Requires-Dist: pyOpenSSL (==16.0.0) ; python_full_version < "2.7.9"
+Requires-Dist: pyasn1 (==0.1.9) ; python_full_version < "2.7.9"
+Requires-Dist: ipaddress ; python_version < "3"
+
+===============
+Macaroon Bakery
+===============
+
+A Python library for working with macaroons.
+
+
+Installation
+------------
+The easiest way to install macaroonbakery is via pip::
+
+    $ pip install macaroonbakery
+
+macaroonbakery was developed around pymacaroons. On ubuntu, you
+can get libsodium from a ppa::
+
+	$ sudo add-apt-repository ppa:yellow/ppa -y
+	$ apt-get install libsodium13
+
+Usage
+-----
+Interacting with a protected url, you can use the BakeryAuth provided to deal
+with the macaroon bakery
+
+    >>> from macaroonbakery import httpbakery
+    >>> jar = requests.cookies.RequestsCookieJar()
+    >>> resp = requests.get('some protected url',
+                            cookies=jar,
+                            auth=httpbakery.BakeryAuth(cookies=jar))
+    >>> resp.raise_for_status()
+
+
+You can use any cookie storage you'd like so next subsequent calls the macaroon
+saved in the cookie jar will be directly used and will not require
+any other authentication (for example, cookielib.FileCookieJar).
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..81eae03711c7cb3fab6150785316c1536664fd7b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/RECORD
@@ -0,0 +1,119 @@
+macaroonbakery-1.3.1.dist-info/AUTHORS.rst,sha256=eVJm411P91r-ZohGgS3aUNlWM37d47uTf195ei2V7dc,102
+macaroonbakery-1.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+macaroonbakery-1.3.1.dist-info/LICENSE,sha256=l2KK_rxg8Cb1wrJddJHEalxO5h9pPnz6B_vSwDYFl5s,7652
+macaroonbakery-1.3.1.dist-info/METADATA,sha256=HZ2E228UTvyhAdtrijS6DcJrS-Hp4lVUKU0ujEyIbRk,2310
+macaroonbakery-1.3.1.dist-info/RECORD,,
+macaroonbakery-1.3.1.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+macaroonbakery-1.3.1.dist-info/top_level.txt,sha256=_P49YoJqU60YW1SEOBj_PaHLeFxmQFyaGCDWMlYC2Q8,15
+macaroonbakery/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+macaroonbakery/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/_utils/__init__.py,sha256=N8q1KiQ4EoCb31w0chilX4eGY8CoNLYfybbrNjrR20k,4976
+macaroonbakery/_utils/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/bakery/__init__.py,sha256=sC3L860cAp01Wb2iIyhvMva3xNmnWwOipnv_dyo6nqI,2684
+macaroonbakery/bakery/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_authorizer.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_bakery.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_checker.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_codec.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_discharge.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_error.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_identity.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_keys.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_macaroon.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_oven.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_store.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_third_party.cpython-38.pyc,,
+macaroonbakery/bakery/__pycache__/_versions.cpython-38.pyc,,
+macaroonbakery/bakery/_authorizer.py,sha256=8xgpgtVfIjjN-pEKXWKiTycIyF8IADrTkV_HtH-tjMk,4111
+macaroonbakery/bakery/_bakery.py,sha256=sTOuJaxkkhGTQcFtcTLF3SiYLuXrZUv_e2yZLxGqXT0,3205
+macaroonbakery/bakery/_checker.py,sha256=80twm8PJ78z6qs-ttxLwEXzi5W9frlRxi0o10C04OF4,16727
+macaroonbakery/bakery/_codec.py,sha256=W00iHo2_bp0w1hlk7EhrqzBTk02gpUP1pGRE9U0Eqwo,10449
+macaroonbakery/bakery/_discharge.py,sha256=VWtGx6fpwQb9J3xIY3rf5BXzlfBhCvHU3mtcy4zw1VE,9375
+macaroonbakery/bakery/_error.py,sha256=2ETL7c98D9_kbEZhvQQRt5rUYG6eylaMaabJb9OsDOg,2319
+macaroonbakery/bakery/_identity.py,sha256=KX6oAAZJdaGIHWTUxh0buq1FFhlynQWerRvsQ4AHwoE,4147
+macaroonbakery/bakery/_internal/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+macaroonbakery/bakery/_internal/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/bakery/_internal/__pycache__/id_pb2.cpython-38.pyc,,
+macaroonbakery/bakery/_internal/id_pb2.py,sha256=2k2jaiZNdXlwTV-Tern6FqAzV52-NDt9bjKlSrUg8Bk,4160
+macaroonbakery/bakery/_keys.py,sha256=6SKTREoPXzOJKUc-tfiphCtLXce6IpP7Nj-9AdkmNe0,2935
+macaroonbakery/bakery/_macaroon.py,sha256=YF3G7ZWpMHey-Q5tgC9TxkKdaF0pCsYJrFrS-2ZAdmo,15545
+macaroonbakery/bakery/_oven.py,sha256=I367L9kt3L6uFxA2tNTO4eBi7WMAVYvy93FghizRvgQ,10637
+macaroonbakery/bakery/_store.py,sha256=CkJZLXHUfGRAxwEQ3Ke5HVhJDgaFUDFb_10J8MjuLkU,2294
+macaroonbakery/bakery/_third_party.py,sha256=pyhb7B7yrobVENw-iOTanlI7En8giOE4EObtEcwJgy4,2061
+macaroonbakery/bakery/_versions.py,sha256=9eDrzD7UuB7fylp_RY-j5WHX4ms3cJFzLgP4LMqwgZU,176
+macaroonbakery/checkers/__init__.py,sha256=E-teYk5vGst_LWlklTQGeTwLuoBPEi2AMo5uwCjgHa8,1602
+macaroonbakery/checkers/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_auth_context.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_caveat.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_checkers.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_conditions.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_declared.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_namespace.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_operation.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_time.cpython-38.pyc,,
+macaroonbakery/checkers/__pycache__/_utils.cpython-38.pyc,,
+macaroonbakery/checkers/_auth_context.py,sha256=S_25gqGE1FqMRjniRwSe-Fn4AE2An-TQqyFVs79W1iQ,1755
+macaroonbakery/checkers/_caveat.py,sha256=_uH2atljoAjex11SRuxDK4hN8Z98DjAqQ7cY3w-Q8Bo,4210
+macaroonbakery/checkers/_checkers.py,sha256=Qu9n9Fdxdubl3qwvvQMqZ51MzWnqSjJzk1DSElsky78,8210
+macaroonbakery/checkers/_conditions.py,sha256=8_FL_pyB9NyNYXCWJGdHJl5UvrEIMm7wKLaHfgf8reY,515
+macaroonbakery/checkers/_declared.py,sha256=t8JK5ZyLNfguFdI3AmehXqO13VLBB0qZS2DaA6XTaKI,2851
+macaroonbakery/checkers/_namespace.py,sha256=VcB212blQHGofOKv1dT54PPkVaefvQeR0UiH8LBGZ3U,5461
+macaroonbakery/checkers/_operation.py,sha256=AdUuMKdkv9_-BKHIFGNv7-guQzomv5YAKmRU19gGUoA,586
+macaroonbakery/checkers/_time.py,sha256=XDSEl9z-XtuPsP4pgMoK0XSKNJLoyULN6TD66udKLrI,2179
+macaroonbakery/checkers/_utils.py,sha256=J56dqvsjOp1xOUPKSpcBUwewfBJqs5WP6Cs7O2EoNPo,377
+macaroonbakery/httpbakery/__init__.py,sha256=aIQKXxUtCRwVIZuof5Qb0preGjCEvdLlN78I56MAdDM,1252
+macaroonbakery/httpbakery/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_browser.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_client.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_discharge.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_error.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_interactor.cpython-38.pyc,,
+macaroonbakery/httpbakery/__pycache__/_keyring.cpython-38.pyc,,
+macaroonbakery/httpbakery/_browser.py,sha256=w70EfpolT5Qef0PKJfrtPOkJhhDZ63KPOQaT4DbR2x0,3563
+macaroonbakery/httpbakery/_client.py,sha256=EDlz1d0K1gEFimhn--1Jn-PnvQSZhktn9XCycBm45NI,15492
+macaroonbakery/httpbakery/_discharge.py,sha256=SWibeYTU-cOg9h3B1hr34vTn-7G8JuAH0zeggkmAHkU,1162
+macaroonbakery/httpbakery/_error.py,sha256=mW4_addZ9E38nTbXPFzfHHVNm8nYAIizfxT1NBd3Wa0,8215
+macaroonbakery/httpbakery/_interactor.py,sha256=WjC1qKQGvbbGGqbynBAjBibH-V7CG9_fxEfYBVX5-y4,2899
+macaroonbakery/httpbakery/_keyring.py,sha256=G6fnCaABs9yVkCeFfJg8JE_Z2B_32JpdGPIBOEKsoBc,2300
+macaroonbakery/httpbakery/agent/__init__.py,sha256=N2xwDaocuUc-eKPAhzwTCOjy-ATvbawesUpwO6H6uoc,366
+macaroonbakery/httpbakery/agent/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/httpbakery/agent/__pycache__/_agent.cpython-38.pyc,,
+macaroonbakery/httpbakery/agent/_agent.py,sha256=Y7EbBck07Fv3W_vDvjrfmonaOAmm9nVxw9EY_xPQlGc,6977
+macaroonbakery/tests/__init__.py,sha256=ls4kXCqBc3sUD351GwL36l2wUiJxM440yTjLrlJoiNw,91
+macaroonbakery/tests/__pycache__/__init__.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/common.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_agent.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_authorizer.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_bakery.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_checker.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_checkers.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_client.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_codec.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_discharge.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_discharge_all.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_httpbakery.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_keyring.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_macaroon.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_namespace.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_oven.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_store.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_time.cpython-38.pyc,,
+macaroonbakery/tests/__pycache__/test_utils.cpython-38.pyc,,
+macaroonbakery/tests/common.py,sha256=Am8h0H78K3jtakuwiaM9FosdrRZklZEydOdPcw2vC8s,3276
+macaroonbakery/tests/test_agent.py,sha256=5sTIC9o8B5AL_-BPCi9_RwfBvAalTpklHxOiViQRSOE,15700
+macaroonbakery/tests/test_authorizer.py,sha256=bPLsK5o6vCM0RPdUYNuXS2y_Vhrd8e93tMvpKr6CFjM,4906
+macaroonbakery/tests/test_bakery.py,sha256=qHBd0tx0CNOlQhj66RypRNOZbQ-ob3LnjTUboAIVfYE,9725
+macaroonbakery/tests/test_checker.py,sha256=bYKCHeuttFVM3UT8yePGaBS3O2gYmliKBOnrUzqlbPY,36605
+macaroonbakery/tests/test_checkers.py,sha256=fWo7nfyoTYGhxsxo9ExK-ApcfeornVZ0T1xOkXp3syY,15651
+macaroonbakery/tests/test_client.py,sha256=vX63QP7oXXh3yaTbTXsv67BbXkJewywdMJXYzcQ95Mc,25861
+macaroonbakery/tests/test_codec.py,sha256=CXLpapSwc1AfiJQ16LS2Hqj8VFB9V6NLJgY2LaAVi9g,7746
+macaroonbakery/tests/test_discharge.py,sha256=sI1PP2yosx83wKl_Hab_5W2Ok6tvro0WRc5lKu60WGU,21569
+macaroonbakery/tests/test_discharge_all.py,sha256=2hRe_1xLAQEta1tiGV7yhTNsnvQGpb1SqqYPRj9s5Sk,5859
+macaroonbakery/tests/test_httpbakery.py,sha256=TFPOAa-35Vrn0MLEvitmllmbiFtMhqGDgmgH9QCa3d4,1292
+macaroonbakery/tests/test_keyring.py,sha256=OcYodIQpDRGCsGgg9-41egqxAgJM5IVJeEbEgY0Egw8,3529
+macaroonbakery/tests/test_macaroon.py,sha256=PAsO7uyB8XHftr7xQ2gc1cQV6UGG7-LT34V74Z5Bb8o,8430
+macaroonbakery/tests/test_namespace.py,sha256=QUIQct0WlKeTDaxK5oTyB1fRpc5VYXwIe6LQwuypRYs,1919
+macaroonbakery/tests/test_oven.py,sha256=H1CXuEKzCZiLk_5lYeCzjVT1aau3xfqbwn-3AV0XB_4,5148
+macaroonbakery/tests/test_store.py,sha256=__nEJfAvrBXCbZJ1EAu4lS8kPitrvEh-ZEAUZxYaubQ,546
+macaroonbakery/tests/test_time.py,sha256=MszgXpPqh7qihd8Sxu3I1FsHU_0i5lM1fmvb5JHlUsM,4766
+macaroonbakery/tests/test_utils.py,sha256=cFi0R2GOMZEJ4o2ioN_quZAeoqioAt688hS0dSbHKRA,3442
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..57bab63436f231ea54be5155a252796b2f2e49c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery-1.3.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+macaroonbakery
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/_utils/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/_utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..977cdbed2778c39cb86bafebff9b6ee5c43a0c9e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/_utils/__init__.py
@@ -0,0 +1,180 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+import binascii
+import ipaddress
+import json
+import webbrowser
+from datetime import datetime
+
+import six
+from pymacaroons import Macaroon
+from pymacaroons.serializers import json_serializer
+
+import six.moves.http_cookiejar as http_cookiejar
+from six.moves.urllib.parse import urlparse
+
+
+def to_bytes(s):
+    '''Return s as a bytes type, using utf-8 encoding if necessary.
+    @param s string or bytes
+    @return bytes
+    '''
+    if isinstance(s, six.binary_type):
+        return s
+    if isinstance(s, six.string_types):
+        return s.encode('utf-8')
+    raise TypeError('want string or bytes, got {}', type(s))
+
+
+def macaroon_from_dict(json_macaroon):
+    '''Return a pymacaroons.Macaroon object from the given
+    JSON-deserialized dict.
+
+    @param JSON-encoded macaroon as dict
+    @return the deserialized macaroon object.
+    '''
+    return Macaroon.deserialize(json.dumps(json_macaroon),
+                                json_serializer.JsonSerializer())
+
+
+def macaroon_to_dict(macaroon):
+    '''Turn macaroon into JSON-serializable dict object
+    @param pymacaroons.Macaroon.
+    '''
+    return json.loads(macaroon.serialize(json_serializer.JsonSerializer()))
+
+
+def macaroon_to_json_string(macaroon):
+    '''Serialize macaroon object to a JSON-encoded string.
+
+    @param macaroon object to be serialized.
+    @return a string serialization form of the macaroon.
+    '''
+    return macaroon.serialize(json_serializer.JsonSerializer())
+
+
+def _add_base64_padding(b):
+    '''Add padding to base64 encoded bytes.
+
+    pymacaroons does not give padded base64 bytes from serialization.
+
+    @param bytes b to be padded.
+    @return a padded bytes.
+    '''
+    return b + b'=' * (-len(b) % 4)
+
+
+def _remove_base64_padding(b):
+    '''Remove padding from base64 encoded bytes.
+
+    pymacaroons does not give padded base64 bytes from serialization.
+
+    @param bytes b to be padded.
+    @return a padded bytes.
+    '''
+    return b.rstrip(b'=')
+
+
+def b64decode(s):
+    '''Base64 decodes a base64-encoded string in URL-safe
+    or normal format, with or without padding.
+    The argument may be string or bytes.
+
+    @param s bytes decode
+    @return bytes decoded
+    @raises ValueError on failure
+    '''
+    # add padding if necessary.
+    s = to_bytes(s)
+    if not s.endswith(b'='):
+        s = s + b'=' * (-len(s) % 4)
+    try:
+        if '_' or '-' in s:
+            return base64.urlsafe_b64decode(s)
+        else:
+            return base64.b64decode(s)
+    except (TypeError, binascii.Error) as e:
+        raise ValueError(str(e))
+
+
+def raw_urlsafe_b64encode(b):
+    '''Base64 encode using URL-safe encoding with padding removed.
+
+    @param b bytes to decode
+    @return bytes decoded
+    '''
+    b = to_bytes(b)
+    b = base64.urlsafe_b64encode(b)
+    b = b.rstrip(b'=')  # strip padding
+    return b
+
+
+def visit_page_with_browser(visit_url):
+    '''Open a browser so the user can validate its identity.
+
+    @param visit_url: where to prove your identity.
+    '''
+    webbrowser.open(visit_url, new=1)
+    print('Opening an authorization web page in your browser.')
+    print('If it does not open, please open this URL:\n', visit_url, '\n')
+
+
+def cookie(
+        url,
+        name,
+        value,
+        expires=None):
+    '''Return a new Cookie using a slightly more
+    friendly API than that provided by six.moves.http_cookiejar
+
+    @param name The cookie name {str}
+    @param value The cookie value {str}
+    @param url The URL path of the cookie {str}
+    @param expires The expiry time of the cookie {datetime}. If provided,
+        it must be a naive timestamp in UTC.
+    '''
+    u = urlparse(url)
+    domain = u.hostname
+    if '.' not in domain and not _is_ip_addr(domain):
+        domain += ".local"
+    port = str(u.port) if u.port is not None else None
+    secure = u.scheme == 'https'
+    if expires is not None:
+        if expires.tzinfo is not None:
+            raise ValueError('Cookie expiration must be a naive datetime')
+        expires = (expires - datetime(1970, 1, 1)).total_seconds()
+    return http_cookiejar.Cookie(
+        version=0,
+        name=name,
+        value=value,
+        port=port,
+        port_specified=port is not None,
+        domain=domain,
+        domain_specified=True,
+        domain_initial_dot=False,
+        path=u.path,
+        path_specified=True,
+        secure=secure,
+        expires=expires,
+        discard=False,
+        comment=None,
+        comment_url=None,
+        rest=None,
+        rfc2109=False,
+    )
+
+
+def _is_ip_addr(h):
+    if six.PY2:
+        # the python2.7 backport of ipaddr needs a bytestring passed in
+        try:
+            h = h.decode('ascii')
+        except UnicodeDecodeError:
+            # If there are non-ascii chars it's not an address anyway
+            return False
+    try:
+        ipaddress.ip_address(h)
+    except ValueError:
+        return False
+    return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b973e904c68adbb1439091f963705e1b0a93572
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/__init__.py
@@ -0,0 +1,141 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+from ._versions import (
+    VERSION_0,
+    VERSION_1,
+    VERSION_2,
+    VERSION_3,
+    LATEST_VERSION,
+)
+from ._authorizer import (
+    ACLAuthorizer,
+    Authorizer,
+    AuthorizerFunc,
+    ClosedAuthorizer,
+    EVERYONE,
+)
+from ._codec import (
+    decode_caveat,
+    encode_caveat,
+    encode_uvarint,
+)
+from ._checker import (
+    AuthChecker,
+    AuthInfo,
+    Checker,
+    LOGIN_OP,
+    Op,
+)
+from ._error import (
+    AuthInitError,
+    CaveatNotRecognizedError,
+    DischargeRequiredError,
+    IdentityError,
+    PermissionDenied,
+    ThirdPartyCaveatCheckFailed,
+    ThirdPartyInfoNotFound,
+    VerificationError,
+)
+from ._identity import (
+    ACLIdentity,
+    Identity,
+    IdentityClient,
+    NoIdentities,
+    SimpleIdentity,
+)
+from ._keys import (
+    generate_key,
+    PrivateKey,
+    PublicKey,
+)
+from ._store import (
+    MemoryOpsStore,
+    MemoryKeyStore,
+)
+from ._third_party import (
+    ThirdPartyCaveatInfo,
+    ThirdPartyInfo,
+    legacy_namespace,
+)
+from ._macaroon import (
+    Macaroon,
+    MacaroonJSONDecoder,
+    MacaroonJSONEncoder,
+    ThirdPartyLocator,
+    ThirdPartyStore,
+    macaroon_version,
+)
+from ._discharge import (
+    ThirdPartyCaveatChecker,
+    discharge,
+    discharge_all,
+    local_third_party_caveat,
+)
+from ._oven import (
+    Oven,
+    canonical_ops,
+)
+from ._bakery import Bakery
+from macaroonbakery._utils import (
+    b64decode,
+    macaroon_to_dict,
+)
+
+__all__ = [
+    'ACLAuthorizer',
+    'ACLIdentity',
+    'AuthChecker',
+    'AuthInfo',
+    'AuthInitError',
+    'Authorizer',
+    'AuthorizerFunc',
+    'VERSION_0',
+    'VERSION_1',
+    'VERSION_2',
+    'VERSION_3',
+    'Bakery',
+    'CaveatNotRecognizedError',
+    'Checker',
+    'ClosedAuthorizer',
+    'DischargeRequiredError',
+    'EVERYONE',
+    'Identity',
+    'IdentityClient',
+    'IdentityError',
+    'LATEST_VERSION',
+    'LOGIN_OP',
+    'Macaroon',
+    'MacaroonJSONDecoder',
+    'MacaroonJSONEncoder',
+    'MemoryKeyStore',
+    'MemoryOpsStore',
+    'NoIdentities',
+    'Op',
+    'Oven',
+    'PermissionDenied',
+    'PrivateKey',
+    'PublicKey',
+    'SimpleIdentity',
+    'ThirdPartyCaveatCheckFailed',
+    'ThirdPartyCaveatChecker',
+    'ThirdPartyCaveatInfo',
+    'ThirdPartyInfo',
+    'ThirdPartyInfoNotFound',
+    'ThirdPartyLocator',
+    'ThirdPartyStore',
+    'VERSION',
+    'VerificationError',
+    'b64decode',
+    'canonical_ops',
+    'decode_caveat',
+    'discharge',
+    'discharge_all',
+    'encode_caveat',
+    'encode_uvarint',
+    'generate_key',
+    'legacy_namespace',
+    'local_third_party_caveat',
+    'macaroon_to_dict',
+    'macaroon_version',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_authorizer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_authorizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..f900430f38f2dd3b6ef33622e6c41f2d96b73cc6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_authorizer.py
@@ -0,0 +1,106 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+
+from ._identity import ACLIdentity
+
+# EVERYONE is recognized by ACLAuthorizer as the name of a
+# group that has everyone in it.
+EVERYONE = 'everyone'
+
+
+class Authorizer(object):
+    ''' Used to check whether a given user is allowed to perform a set of
+    operations.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def authorize(self, ctx, id, ops):
+        ''' Checks whether the given identity (which will be None when there is
+        no authenticated user) is allowed to perform the given operations.
+        It should raise an exception only when the authorization cannot be
+        determined, not when the user has been denied access.
+
+        On success, each element of allowed holds whether the respective
+        element of ops has been allowed, and caveats holds any additional
+        third party caveats that apply.
+        If allowed is shorter then ops, the additional elements are assumed to
+        be False.
+        ctx(AuthContext) is the context of the authorization request.
+        :return: a list of boolean and a list of caveats
+        '''
+        raise NotImplementedError('authorize method must be defined in '
+                                  'subclass')
+
+
+class AuthorizerFunc(Authorizer):
+    ''' Implements a simplified version of Authorizer that operates on a single
+    operation at a time.
+    '''
+    def __init__(self, f):
+        '''
+        :param f: a function that takes an identity that operates on a single
+        operation at a time. Will return if this op is allowed as a boolean and
+        and a list of caveat that holds any additional third party caveats
+        that apply.
+        '''
+        self._f = f
+
+    def authorize(self, ctx, identity, ops):
+        '''Implements Authorizer.authorize by calling f with the given identity
+        for each operation.
+        '''
+        allowed = []
+        caveats = []
+        for op in ops:
+            ok, fcaveats = self._f(ctx, identity, op)
+            allowed.append(ok)
+            if fcaveats is not None:
+                caveats.extend(fcaveats)
+        return allowed, caveats
+
+
+class ACLAuthorizer(Authorizer):
+    ''' ACLAuthorizer is an Authorizer implementation that will check access
+    control list (ACL) membership of users. It uses get_acl to find out
+    the ACLs that apply to the requested operations and will authorize an
+    operation if an ACL contains the group "everyone" or if the identity is
+    an instance of ACLIdentity and its allow method returns True for the ACL.
+    '''
+    def __init__(self, get_acl, allow_public=False):
+        '''
+        :param get_acl get_acl will be called with an auth context and an Op.
+        It should return the ACL that applies (an array of string ids).
+        If an entity cannot be found or the action is not recognised,
+        get_acl should return an empty list but no error.
+        :param allow_public: boolean, If True and an ACL contains "everyone",
+        then authorization will be granted even if there is no logged in user.
+        '''
+        self._allow_public = allow_public
+        self._get_acl = get_acl
+
+    def authorize(self, ctx, identity, ops):
+        '''Implements Authorizer.authorize by calling identity.allow to
+        determine whether the identity is a member of the ACLs associated with
+        the given operations.
+        '''
+        if len(ops) == 0:
+            # Anyone is allowed to do nothing.
+            return [], []
+        allowed = [False] * len(ops)
+        has_allow = isinstance(identity, ACLIdentity)
+        for i, op in enumerate(ops):
+            acl = self._get_acl(ctx, op)
+            if has_allow:
+                allowed[i] = identity.allow(ctx, acl)
+            else:
+                allowed[i] = self._allow_public and EVERYONE in acl
+        return allowed, []
+
+
+class ClosedAuthorizer(Authorizer):
+    ''' An Authorizer implementation that will never authorize anything.
+    '''
+    def authorize(self, ctx, id, ops):
+        return [False] * len(ops), []
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_bakery.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_bakery.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fac9cea5c69654ff00bc425c7aac05cc952060b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_bakery.py
@@ -0,0 +1,72 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+from ._authorizer import ClosedAuthorizer
+from ._checker import Checker
+import macaroonbakery.checkers as checkers
+from ._oven import Oven
+
+
+class Bakery(object):
+    '''Convenience class that contains both an Oven and a Checker.
+    '''
+    def __init__(self, location=None, locator=None, ops_store=None, key=None,
+                 identity_client=None, checker=None, root_key_store=None,
+                 authorizer=ClosedAuthorizer()):
+        '''Returns a new Bakery instance which combines an Oven with a
+        Checker for the convenience of callers that wish to use both
+        together.
+        @param checker holds the checker used to check first party caveats.
+        If this is None, it will use checkers.Checker(None).
+        @param root_key_store holds the root key store to use.
+        If you need to use a different root key store for different operations,
+        you'll need to pass a root_key_store_for_ops value to Oven directly.
+        @param root_key_store If this is None, it will use MemoryKeyStore().
+        Note that that is almost certain insufficient for production services
+        that are spread across multiple instances or that need
+        to persist keys across restarts.
+        @param locator is used to find out information on third parties when
+        adding third party caveats. If this is None, no non-local third
+        party caveats can be added.
+        @param key holds the private key of the oven. If this is None,
+        no third party caveats may be added.
+        @param identity_client holds the identity implementation to use for
+        authentication. If this is None, no authentication will be possible.
+        @param authorizer is used to check whether an authenticated user is
+        allowed to perform operations. If it is None, it will use
+        a ClosedAuthorizer.
+        The identity parameter passed to authorizer.allow will
+        always have been obtained from a call to
+        IdentityClient.declared_identity.
+        @param ops_store used to persistently store the association of
+        multi-op entities with their associated operations
+        when oven.macaroon is called with multiple operations.
+        @param location holds the location to use when creating new macaroons.
+        '''
+
+        if checker is None:
+            checker = checkers.Checker()
+        root_keystore_for_ops = None
+        if root_key_store is not None:
+            def root_keystore_for_ops(ops):
+                return root_key_store
+
+        oven = Oven(key=key,
+                    location=location,
+                    locator=locator,
+                    namespace=checker.namespace(),
+                    root_keystore_for_ops=root_keystore_for_ops,
+                    ops_store=ops_store)
+        self._oven = oven
+
+        self._checker = Checker(checker=checker, authorizer=authorizer,
+                                identity_client=identity_client,
+                                macaroon_opstore=oven)
+
+    @property
+    def oven(self):
+        return self._oven
+
+    @property
+    def checker(self):
+        return self._checker
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_checker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_checker.py
new file mode 100644
index 0000000000000000000000000000000000000000..88560cc7a020384e733ad6340010ed7e20e072b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_checker.py
@@ -0,0 +1,418 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from collections import namedtuple
+from threading import Lock
+
+from ._authorizer import ClosedAuthorizer
+from ._identity import NoIdentities
+from ._error import (
+    AuthInitError,
+    VerificationError,
+    IdentityError,
+    DischargeRequiredError,
+    PermissionDenied,
+)
+import macaroonbakery.checkers as checkers
+import pyrfc3339
+
+
+class Op(namedtuple('Op', 'entity, action')):
+    ''' Op holds an entity and action to be authorized on that entity.
+    entity string holds the name of the entity to be authorized.
+
+    @param entity should not contain spaces and should
+    not start with the prefix "login" or "multi-" (conventionally,
+    entity names will be prefixed with the entity type followed
+    by a hyphen.
+    @param action string holds the action to perform on the entity,
+    such as "read" or "delete". It is up to the service using a checker
+    to define a set of operations and keep them consistent over time.
+    '''
+
+
+# LOGIN_OP represents a login (authentication) operation.
+# A macaroon that is associated with this operation generally
+# carries authentication information with it.
+LOGIN_OP = Op(entity='login', action='login')
+
+
+class Checker(object):
+    '''Checker implements an authentication and authorization checker.
+
+    It uses macaroons as authorization tokens but it is not itself responsible
+    for creating the macaroons
+    See the Oven type (TODO) for one way of doing that.
+    '''
+    def __init__(self, checker=checkers.Checker(),
+                 authorizer=ClosedAuthorizer(),
+                 identity_client=None,
+                 macaroon_opstore=None):
+        '''
+        :param checker: a first party checker implementing a
+        :param authorizer (Authorizer): used to check whether an authenticated
+        user is allowed to perform operations.
+        The identity parameter passed to authorizer.allow will always have been
+        obtained from a call to identity_client.declared_identity.
+        :param identity_client (IdentityClient) used for interactions with the
+        external identity service used for authentication.
+        If this is None, no authentication will be possible.
+        :param macaroon_opstore (object with new_macaroon and macaroon_ops
+        method): used to retrieve macaroon root keys and other associated
+        information.
+        '''
+        self._first_party_caveat_checker = checker
+        self._authorizer = authorizer
+        if identity_client is None:
+            identity_client = NoIdentities()
+        self._identity_client = identity_client
+        self._macaroon_opstore = macaroon_opstore
+
+    def auth(self, mss):
+        ''' Returns a new AuthChecker instance using the given macaroons to
+        inform authorization decisions.
+        @param mss: a list of macaroon lists.
+        '''
+        return AuthChecker(parent=self,
+                           macaroons=mss)
+
+    def namespace(self):
+        ''' Returns the namespace of the first party checker.
+        '''
+        return self._first_party_caveat_checker.namespace()
+
+
+class AuthChecker(object):
+    '''Authorizes operations with respect to a user's request.
+
+    The identity is authenticated only once, the first time any method
+    of the AuthChecker is called, using the context passed in then.
+
+    To find out any declared identity without requiring a login,
+    use allow(ctx); to require authentication but no additional operations,
+    use allow(ctx, LOGIN_OP).
+    '''
+    def __init__(self, parent, macaroons):
+        '''
+
+        :param parent (Checker): used to check first party caveats.
+        :param macaroons: a list of py macaroons
+        '''
+        self._macaroons = macaroons
+        self._init_errors = []
+        self._executed = False
+        self._identity = None
+        self._identity_caveats = []
+        self.parent = parent
+        self._conditions = None
+        self._mutex = Lock()
+
+    def _init(self, ctx):
+        with self._mutex:
+            if not self._executed:
+                self._init_once(ctx)
+                self._executed = True
+
+    def _init_once(self, ctx):
+        self._auth_indexes = {}
+        self._conditions = [None] * len(self._macaroons)
+        for i, ms in enumerate(self._macaroons):
+            try:
+                ops, conditions = self.parent._macaroon_opstore.macaroon_ops(ms)
+            except VerificationError as e:
+                self._init_errors.append(str(e))
+                continue
+            except Exception as exc:
+                raise AuthInitError(str(exc))
+
+            # It's a valid macaroon (in principle - we haven't checked first
+            # party caveats).
+            self._conditions[i] = conditions
+            is_login = False
+            for op in ops:
+                if op == LOGIN_OP:
+                    # Don't associate the macaroon with the login operation
+                    # until we've verified that it is valid below
+                    is_login = True
+                else:
+                    if op not in self._auth_indexes:
+                        self._auth_indexes[op] = []
+                    self._auth_indexes[op].append(i)
+            if not is_login:
+                continue
+            # It's a login macaroon. Check the conditions now -
+            # all calls want to see the same authentication
+            # information so that callers have a consistent idea of
+            # the client's identity.
+            #
+            # If the conditions fail, we won't use the macaroon for
+            # identity, but we can still potentially use it for its
+            # other operations if the conditions succeed for those.
+            declared, err = self._check_conditions(ctx, LOGIN_OP, conditions)
+            if err is not None:
+                self._init_errors.append('cannot authorize login macaroon: ' + err)
+                continue
+            if self._identity is not None:
+                # We've already found a login macaroon so ignore this one
+                # for the purposes of identity.
+                continue
+
+            try:
+                identity = self.parent._identity_client.declared_identity(
+                    ctx, declared)
+            except IdentityError as exc:
+                self._init_errors.append(
+                    'cannot decode declared identity: {}'.format(exc.args[0]))
+                continue
+            if LOGIN_OP not in self._auth_indexes:
+                self._auth_indexes[LOGIN_OP] = []
+            self._auth_indexes[LOGIN_OP].append(i)
+            self._identity = identity
+
+        if self._identity is None:
+            # No identity yet, so try to get one based on the context.
+            try:
+                identity, cavs = self.parent.\
+                    _identity_client.identity_from_context(ctx)
+            except IdentityError:
+                self._init_errors.append('could not determine identity')
+            if cavs is None:
+                cavs = []
+            self._identity, self._identity_caveats = identity, cavs
+        return None
+
+    def allow(self, ctx, ops):
+        ''' Checks that the authorizer's request is authorized to
+        perform all the given operations. Note that allow does not check
+        first party caveats - if there is more than one macaroon that may
+        authorize the request, it will choose the first one that does
+        regardless.
+
+        If all the operations are allowed, an AuthInfo is returned holding
+        details of the decision and any first party caveats that must be
+        checked before actually executing any operation.
+
+        If operations include LOGIN_OP, the request should contain an
+        authentication macaroon proving the client's identity. Once an
+        authentication macaroon is chosen, it will be used for all other
+        authorization requests.
+
+        If an operation was not allowed, an exception will be raised which may
+        be:
+
+        - DischargeRequiredError holding the operations that remain to
+        be authorized in order to allow authorization to proceed
+        - PermissionDenied when no operations can be authorized and there's
+        no third party to discharge macaroons for.
+
+        @param ctx AuthContext
+        @param ops an array of Op
+        :return: an AuthInfo object.
+        '''
+        auth_info, _ = self.allow_any(ctx, ops)
+        return auth_info
+
+    def allow_any(self, ctx, ops):
+        ''' like allow except that it will authorize as many of the
+        operations as possible without requiring any to be authorized. If all
+        the operations succeeded, the array will be nil.
+
+        If any the operations failed, the returned error will be the same
+        that allow would return and each element in the returned slice will
+        hold whether its respective operation was allowed.
+
+        If all the operations succeeded, the returned slice will be None.
+
+        The returned AuthInfo will always be non-None.
+
+        The LOGIN_OP operation is treated specially - it is always required if
+        present in ops.
+        @param ctx AuthContext
+        @param ops an array of Op
+        :return: an AuthInfo object and the auth used as an array of int.
+        '''
+        authed, used = self._allow_any(ctx, ops)
+        return self._new_auth_info(used), authed
+
+    def _new_auth_info(self, used):
+        info = AuthInfo(identity=self._identity, macaroons=[])
+        for i, is_used in enumerate(used):
+            if is_used:
+                info.macaroons.append(self._macaroons[i])
+        return info
+
+    def _allow_any(self, ctx, ops):
+        self._init(ctx)
+        used = [False] * len(self._macaroons)
+        authed = [False] * len(ops)
+        num_authed = 0
+        errors = []
+        for i, op in enumerate(ops):
+            for mindex in self._auth_indexes.get(op, []):
+                _, err = self._check_conditions(ctx, op,
+                                                self._conditions[mindex])
+                if err is not None:
+                    errors.append(err)
+                    continue
+                authed[i] = True
+                num_authed += 1
+                used[mindex] = True
+                # Use the first authorized macaroon only.
+                break
+            if op == LOGIN_OP and not authed[i] and self._identity is not None:
+                # Allow LOGIN_OP when there's an authenticated user even
+                # when there's no macaroon that specifically authorizes it.
+                authed[i] = True
+        if self._identity is not None:
+            # We've authenticated as a user, so even if the operations didn't
+            # specifically require it, we add the login macaroon
+            # to the macaroons used.
+            # Note that the LOGIN_OP conditions have already been checked
+            # successfully in initOnceFunc so no need to check again.
+            # Note also that there may not be any macaroons if the
+            # identity client decided on an identity even with no
+            # macaroons.
+            for i in self._auth_indexes.get(LOGIN_OP, []):
+                used[i] = True
+        if num_authed == len(ops):
+            # All operations allowed.
+            return authed, used
+        # There are some unauthorized operations.
+        need = []
+        need_index = [0] * (len(ops) - num_authed)
+        for i, ok in enumerate(authed):
+            if not ok:
+                need_index[len(need)] = i
+                need.append(ops[i])
+
+        # Try to authorize the operations
+        # even if we haven't got an authenticated user.
+        oks, caveats = self.parent._authorizer.authorize(
+            ctx, self._identity, need)
+        still_need = []
+        for i, _ in enumerate(need):
+            if i < len(oks) and oks[i]:
+                authed[need_index[i]] = True
+            else:
+                still_need.append(ops[need_index[i]])
+        if len(still_need) == 0 and len(caveats) == 0:
+            # No more ops need to be authenticated and
+            # no caveats to be discharged.
+            return authed, used
+        if self._identity is None and len(self._identity_caveats) > 0:
+            raise DischargeRequiredError(
+                msg='authentication required',
+                ops=[LOGIN_OP],
+                cavs=self._identity_caveats)
+        if caveats is None or len(caveats) == 0:
+            all_errors = []
+            all_errors.extend(self._init_errors)
+            all_errors.extend(errors)
+            err = ''
+            if len(all_errors) > 0:
+                err = all_errors[0]
+            raise PermissionDenied(err)
+        raise DischargeRequiredError(
+            msg='some operations have extra caveats', ops=ops, cavs=caveats)
+
+    def allow_capability(self, ctx, ops):
+        '''Checks that the user is allowed to perform all the
+        given operations. If not, a discharge error will be raised.
+        If allow_capability succeeds, it returns a list of first party caveat
+        conditions that must be applied to any macaroon granting capability
+        to execute the operations. Those caveat conditions will not
+        include any declarations contained in login macaroons - the
+        caller must be careful not to mint a macaroon associated
+        with the LOGIN_OP operation unless they add the expected
+        declaration caveat too - in general, clients should not create
+        capabilities that grant LOGIN_OP rights.
+
+        The operations must include at least one non-LOGIN_OP operation.
+        '''
+        nops = 0
+        for op in ops:
+            if op != LOGIN_OP:
+                nops += 1
+        if nops == 0:
+            raise ValueError('no non-login operations required in capability')
+
+        _, used = self._allow_any(ctx, ops)
+        squasher = _CaveatSquasher()
+        for i, is_used in enumerate(used):
+            if not is_used:
+                continue
+            for cond in self._conditions[i]:
+                squasher.add(cond)
+        return squasher.final()
+
+    def _check_conditions(self, ctx, op, conds):
+        declared = checkers.infer_declared_from_conditions(
+            conds,
+            self.parent.namespace())
+        ctx = checkers.context_with_operations(ctx, [op.action])
+        ctx = checkers.context_with_declared(ctx, declared)
+        for cond in conds:
+            err = self.parent._first_party_caveat_checker.\
+                check_first_party_caveat(ctx, cond)
+            if err is not None:
+                return None, err
+        return declared, None
+
+
+class AuthInfo(namedtuple('AuthInfo', 'identity macaroons')):
+    '''AuthInfo information about an authorization decision.
+
+    @param identity: holds information on the authenticated user as
+    returned identity_client. It may be None after a successful
+    authorization if LOGIN_OP access was not required.
+
+    @param macaroons: holds all the macaroons that were used for the
+    authorization. Macaroons that were invalid or unnecessary are
+    not included.
+    '''
+
+
+class _CaveatSquasher(object):
+    ''' Rationalizes first party caveats created for a capability by:
+        - including only the earliest time-before caveat.
+        - excluding allow and deny caveats (operations are checked by
+        virtue of the operations associated with the macaroon).
+        - removing declared caveats.
+        - removing duplicates.
+    '''
+    def __init__(self, expiry=None, conds=None):
+        self._expiry = expiry
+        if conds is None:
+            conds = []
+        self._conds = conds
+
+    def add(self, cond):
+        if self._add(cond):
+            self._conds.append(cond)
+
+    def _add(self, cond):
+        try:
+            cond, args = checkers.parse_caveat(cond)
+        except ValueError:
+            # Be safe - if we can't parse the caveat, just leave it there.
+            return True
+
+        if cond == checkers.COND_TIME_BEFORE:
+            try:
+                et = pyrfc3339.parse(args, utc=True).replace(tzinfo=None)
+            except ValueError:
+                # Again, if it doesn't seem valid, leave it alone.
+                return True
+            if self._expiry is None or et <= self._expiry:
+                self._expiry = et
+            return False
+        elif cond in [checkers.COND_ALLOW,
+                      checkers.COND_DENY, checkers.COND_DECLARED]:
+            return False
+        return True
+
+    def final(self):
+        if self._expiry is not None:
+            self._conds.append(
+                checkers.time_before_caveat(self._expiry).condition)
+        # Make deterministic and eliminate duplicates.
+        return sorted(set(self._conds))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_codec.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_codec.py
new file mode 100644
index 0000000000000000000000000000000000000000..903e6049b6729c50c1ff18b7becd550c8e193cab
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_codec.py
@@ -0,0 +1,301 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+import json
+
+from ._versions import (VERSION_1, VERSION_2, VERSION_3)
+from ._third_party import legacy_namespace, ThirdPartyCaveatInfo
+from ._keys import PublicKey
+from ._error import VerificationError
+import macaroonbakery.checkers as checkers
+import nacl.public
+import six
+
+_PUBLIC_KEY_PREFIX_LEN = 4
+_KEY_LEN = 32
+# version3CaveatMinLen holds an underestimate of the
+# minimum length of a version 3 caveat.
+_VERSION3_CAVEAT_MIN_LEN = 1 + 4 + 32 + 24 + 16 + 1
+
+
+def encode_caveat(condition, root_key, third_party_info, key, ns):
+    '''Encrypt a third-party caveat.
+
+    The third_party_info key holds information about the
+    third party we're encrypting the caveat for; the key is the
+    public/private key pair of the party that's adding the caveat.
+
+    The caveat will be encoded according to the version information
+    found in third_party_info.
+
+    @param condition string
+    @param root_key bytes
+    @param third_party_info object
+    @param key nacl key
+    @param ns not used yet
+    @return bytes
+    '''
+    if third_party_info.version == VERSION_1:
+        return _encode_caveat_v1(condition, root_key,
+                                 third_party_info.public_key, key)
+    if (third_party_info.version == VERSION_2 or
+            third_party_info.version == VERSION_3):
+        return _encode_caveat_v2_v3(third_party_info.version, condition,
+                                    root_key, third_party_info.public_key,
+                                    key, ns)
+    raise NotImplementedError('only bakery v1, v2, v3 supported')
+
+
+def _encode_caveat_v1(condition, root_key, third_party_pub_key, key):
+    '''Create a JSON-encoded third-party caveat.
+
+    The third_party_pub_key key represents the PublicKey of the third party
+    we're encrypting the caveat for; the key is the public/private key pair of
+    the party that's adding the caveat.
+
+    @param condition string
+    @param root_key bytes
+    @param third_party_pub_key (PublicKey)
+    @param key (PrivateKey)
+    @return a base64 encoded bytes
+    '''
+    plain_data = json.dumps({
+        'RootKey': base64.b64encode(root_key).decode('ascii'),
+        'Condition': condition
+    })
+    box = nacl.public.Box(key.key, third_party_pub_key.key)
+
+    encrypted = box.encrypt(six.b(plain_data))
+    nonce = encrypted[0:nacl.public.Box.NONCE_SIZE]
+    encrypted = encrypted[nacl.public.Box.NONCE_SIZE:]
+    return base64.b64encode(six.b(json.dumps({
+        'ThirdPartyPublicKey': str(third_party_pub_key),
+        'FirstPartyPublicKey': str(key.public_key),
+        'Nonce': base64.b64encode(nonce).decode('ascii'),
+        'Id': base64.b64encode(encrypted).decode('ascii')
+    })))
+
+
+def _encode_caveat_v2_v3(version, condition, root_key, third_party_pub_key,
+                         key, ns):
+    '''Create a version 2 or version 3 third-party caveat.
+
+    The format has the following packed binary fields (note
+    that all fields up to and including the nonce are the same
+    as the v2 format):
+
+        version 2 or 3 [1 byte]
+        first 4 bytes of third-party Curve25519 public key [4 bytes]
+        first-party Curve25519 public key [32 bytes]
+        nonce [24 bytes]
+        encrypted secret part [rest of message]
+
+    The encrypted part encrypts the following fields
+    with box.Seal:
+
+        version 2 or 3 [1 byte]
+        length of root key [n: uvarint]
+        root key [n bytes]
+        length of encoded namespace [n: uvarint] (Version 3 only)
+        encoded namespace [n bytes] (Version 3 only)
+        condition [rest of encrypted part]
+    '''
+    ns_data = bytearray()
+    if version >= VERSION_3:
+        ns_data = ns.serialize_text()
+    data = bytearray()
+    data.append(version)
+    data.extend(third_party_pub_key.serialize(raw=True)[:_PUBLIC_KEY_PREFIX_LEN])
+    data.extend(key.public_key.serialize(raw=True)[:])
+    secret = _encode_secret_part_v2_v3(version, condition, root_key, ns_data)
+    box = nacl.public.Box(key.key, third_party_pub_key.key)
+    encrypted = box.encrypt(secret)
+    nonce = encrypted[0:nacl.public.Box.NONCE_SIZE]
+    encrypted = encrypted[nacl.public.Box.NONCE_SIZE:]
+    data.extend(nonce[:])
+    data.extend(encrypted)
+    return bytes(data)
+
+
+def _encode_secret_part_v2_v3(version, condition, root_key, ns):
+    '''Creates a version 2 or version 3 secret part of the third party
+    caveat. The returned data is not encrypted.
+
+    The format has the following packed binary fields:
+    version 2 or 3 [1 byte]
+    root key length [n: uvarint]
+    root key [n bytes]
+    namespace length [n: uvarint] (v3 only)
+    namespace [n bytes] (v3 only)
+    predicate [rest of message]
+    '''
+    data = bytearray()
+    data.append(version)
+    encode_uvarint(len(root_key), data)
+    data.extend(root_key)
+    if version >= VERSION_3:
+        encode_uvarint(len(ns), data)
+        data.extend(ns)
+    data.extend(condition.encode('utf-8'))
+    return bytes(data)
+
+
+def decode_caveat(key, caveat):
+    '''Decode caveat by decrypting the encrypted part using key.
+
+    @param key the nacl private key to decode.
+    @param caveat bytes.
+    @return ThirdPartyCaveatInfo
+    '''
+    if len(caveat) == 0:
+        raise VerificationError('empty third party caveat')
+
+    first = caveat[:1]
+    if first == b'e':
+        # 'e' will be the first byte if the caveatid is a base64
+        # encoded JSON object.
+        return _decode_caveat_v1(key, caveat)
+    first_as_int = six.byte2int(first)
+    if (first_as_int == VERSION_2 or
+            first_as_int == VERSION_3):
+        if (len(caveat) < _VERSION3_CAVEAT_MIN_LEN
+                and first_as_int == VERSION_3):
+            # If it has the version 3 caveat tag and it's too short, it's
+            # almost certainly an id, not an encrypted payload.
+            raise VerificationError(
+                'caveat id payload not provided for caveat id {}'.format(
+                    caveat))
+        return _decode_caveat_v2_v3(first_as_int, key, caveat)
+    raise VerificationError('unknown version for caveat')
+
+
+def _decode_caveat_v1(key, caveat):
+    '''Decode a base64 encoded JSON id.
+
+    @param key the nacl private key to decode.
+    @param caveat a base64 encoded JSON string.
+    '''
+
+    data = base64.b64decode(caveat).decode('utf-8')
+    wrapper = json.loads(data)
+    tp_public_key = nacl.public.PublicKey(
+        base64.b64decode(wrapper['ThirdPartyPublicKey']))
+    if key.public_key.key != tp_public_key:
+        raise Exception('public key mismatch')  # TODO
+
+    if wrapper.get('FirstPartyPublicKey', None) is None:
+        raise Exception('target service public key not specified')
+
+    # The encrypted string is base64 encoded in the JSON representation.
+    secret = base64.b64decode(wrapper.get('Id'))
+    nonce = base64.b64decode(wrapper.get('Nonce'))
+
+    fp_public_key = nacl.public.PublicKey(base64.b64decode(
+        wrapper.get('FirstPartyPublicKey')))
+
+    box = nacl.public.Box(key.key, fp_public_key)
+    c = box.decrypt(secret, nonce)
+    record = json.loads(c.decode('utf-8'))
+    fp_key = nacl.public.PublicKey(
+        base64.b64decode(wrapper.get('FirstPartyPublicKey')))
+    return ThirdPartyCaveatInfo(
+        condition=record.get('Condition'),
+        first_party_public_key=PublicKey(fp_key),
+        third_party_key_pair=key,
+        root_key=base64.b64decode(record.get('RootKey')),
+        caveat=caveat,
+        id=None,
+        version=VERSION_1,
+        namespace=legacy_namespace()
+    )
+
+
+def _decode_caveat_v2_v3(version, key, caveat):
+    '''Decodes a version 2 or version 3 caveat.
+    '''
+    if (len(caveat) < 1 + _PUBLIC_KEY_PREFIX_LEN +
+            _KEY_LEN + nacl.public.Box.NONCE_SIZE + 16):
+        raise VerificationError('caveat id too short')
+    original_caveat = caveat
+    caveat = caveat[1:]  # skip version (already checked)
+
+    pk_prefix = caveat[:_PUBLIC_KEY_PREFIX_LEN]
+    caveat = caveat[_PUBLIC_KEY_PREFIX_LEN:]
+    if key.public_key.serialize(raw=True)[:_PUBLIC_KEY_PREFIX_LEN] != pk_prefix:
+        raise VerificationError('public key mismatch')
+
+    first_party_pub = caveat[:_KEY_LEN]
+    caveat = caveat[_KEY_LEN:]
+    nonce = caveat[:nacl.public.Box.NONCE_SIZE]
+    caveat = caveat[nacl.public.Box.NONCE_SIZE:]
+    fp_public_key = nacl.public.PublicKey(first_party_pub)
+    box = nacl.public.Box(key.key, fp_public_key)
+    data = box.decrypt(caveat, nonce)
+    root_key, condition, ns = _decode_secret_part_v2_v3(version, data)
+    return ThirdPartyCaveatInfo(
+        condition=condition.decode('utf-8'),
+        first_party_public_key=PublicKey(fp_public_key),
+        third_party_key_pair=key,
+        root_key=root_key,
+        caveat=original_caveat,
+        version=version,
+        id=None,
+        namespace=ns
+    )
+
+
+def _decode_secret_part_v2_v3(version, data):
+    if len(data) < 1:
+        raise VerificationError('secret part too short')
+    got_version = six.byte2int(data[:1])
+    data = data[1:]
+    if version != got_version:
+        raise VerificationError(
+            'unexpected secret part version, got {} want {}'.format(
+                got_version, version))
+    root_key_length, read = decode_uvarint(data)
+    data = data[read:]
+    root_key = data[:root_key_length]
+    data = data[root_key_length:]
+    if version >= VERSION_3:
+        namespace_length, read = decode_uvarint(data)
+        data = data[read:]
+        ns_data = data[:namespace_length]
+        data = data[namespace_length:]
+        ns = checkers.deserialize_namespace(ns_data)
+    else:
+        ns = legacy_namespace()
+    return root_key, data, ns
+
+
+def encode_uvarint(n, data):
+    '''encodes integer into variable-length format into data.'''
+    if n < 0:
+        raise ValueError('only support positive integer')
+    while True:
+        this_byte = n & 127
+        n >>= 7
+        if n == 0:
+            data.append(this_byte)
+            break
+        data.append(this_byte | 128)
+
+
+def decode_uvarint(data):
+    '''Decode a variable-length integer.
+
+    Reads a sequence of unsigned integer byte and decodes them into an integer
+    in variable-length format and returns it and the length read.
+    '''
+    n = 0
+    shift = 0
+    length = 0
+    for b in data:
+        if not isinstance(b, int):
+            b = six.byte2int(b)
+        n |= (b & 0x7f) << shift
+        length += 1
+        if (b & 0x80) == 0:
+            break
+        shift += 7
+    return n, length
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_discharge.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_discharge.py
new file mode 100644
index 0000000000000000000000000000000000000000..32284b7777c29f5ee0bb882ce69490577c775c83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_discharge.py
@@ -0,0 +1,244 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+from collections import namedtuple
+
+from ._error import (
+    ThirdPartyCaveatCheckFailed,
+    CaveatNotRecognizedError,
+    VerificationError,
+)
+from ._codec import decode_caveat
+from ._macaroon import (
+    Macaroon,
+    ThirdPartyLocator,
+)
+from ._versions import VERSION_2
+from ._third_party import ThirdPartyCaveatInfo
+
+import macaroonbakery.checkers as checkers
+
+emptyContext = checkers.AuthContext()
+
+
+def discharge_all(m, get_discharge, local_key=None):
+    '''Gathers discharge macaroons for all the third party caveats in m
+    (and any subsequent caveats required by those) using get_discharge to
+    acquire each discharge macaroon.
+    The local_key parameter may optionally hold the key of the client, in
+    which case it will be used to discharge any third party caveats with the
+    special location "local". In this case, the caveat itself must be "true".
+    This can be used be a server to ask a client to prove ownership of the
+    private key.
+    It returns a list of macaroon with m as the first element, followed by all
+    the discharge macaroons.
+    All the discharge macaroons will be bound to the primary macaroon.
+
+    The get_discharge function is passed a context (AuthContext),
+    the caveat(pymacaroons.Caveat) to be discharged and encrypted_caveat (bytes) will be
+    passed the external caveat payload found in m, if any.
+    It should return a bakery.Macaroon object holding the discharge
+    macaroon for the third party caveat.
+    '''
+    primary = m.macaroon
+    discharges = [primary]
+
+    # cav holds the macaroon caveat that needs discharge.
+    # encrypted_caveat (bytes) holds encrypted caveat if it was held
+    # externally.
+    _NeedCaveat = namedtuple('_NeedCaveat', 'cav encrypted_caveat')
+    need = []
+
+    def add_caveats(m):
+        for cav in m.macaroon.caveats:
+            if cav.location is None or cav.location == '':
+                continue
+            encrypted_caveat = m.caveat_data.get(cav.caveat_id, None)
+            need.append(
+                _NeedCaveat(cav=cav,
+                            encrypted_caveat=encrypted_caveat))
+    add_caveats(m)
+    while len(need) > 0:
+        cav = need[0]
+        need = need[1:]
+        if cav.cav.location == 'local':
+            if local_key is None:
+                raise ThirdPartyCaveatCheckFailed(
+                    'found local third party caveat but no private key provided',
+                )
+            # TODO use a small caveat id.
+            dm = discharge(ctx=emptyContext,
+                           key=local_key,
+                           checker=_LocalDischargeChecker(),
+                           caveat=cav.encrypted_caveat,
+                           id=cav.cav.caveat_id_bytes,
+                           locator=_EmptyLocator())
+        else:
+            dm = get_discharge(cav.cav, cav.encrypted_caveat)
+        # It doesn't matter that we're invalidating dm here because we're
+        # about to throw it away.
+        discharge_m = dm.macaroon
+        m = primary.prepare_for_request(discharge_m)
+        discharges.append(m)
+        add_caveats(dm)
+    return discharges
+
+
+class ThirdPartyCaveatChecker(object):
+    ''' Defines an abstract class that's used to check third party caveats.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def check_third_party_caveat(self, ctx, info):
+        ''' If the caveat is valid, it returns optionally a slice of
+        extra caveats that will be added to the discharge macaroon.
+        If the caveat kind was not recognised, the checker should
+        raise a CaveatNotRecognized exception; if the check failed,
+        it should raise a ThirdPartyCaveatCheckFailed exception.
+        :param ctx (AuthContext)
+        :param info (ThirdPartyCaveatInfo) holds the information decoded from
+        a third party caveat id
+        :return: An array of extra caveats to be added to the discharge
+        macaroon.
+        '''
+        raise NotImplementedError('check_third_party_caveat method must be '
+                                  'defined in subclass')
+
+
+class _LocalDischargeChecker(ThirdPartyCaveatChecker):
+    def check_third_party_caveat(self, ctx, info):
+        if info.condition != 'true':
+            raise CaveatNotRecognizedError()
+        return []
+
+
+def discharge(ctx, id, caveat, key, checker, locator):
+    ''' Creates a macaroon to discharge a third party caveat.
+
+    The given parameters specify the caveat and how it should be checked.
+    The condition implicit in the caveat is checked for validity using checker.
+    If it is valid, a new macaroon is returned which discharges the caveat.
+    The macaroon is created with a version derived from the version that was
+    used to encode the id.
+
+    :param id: (bytes) holds the id to give to the discharge macaroon.
+    If Caveat is empty, then the id also holds the encrypted third party
+    caveat.
+    :param caveat: (bytes) holds the encrypted third party caveat.
+    If this is None, id will be used.
+    :param key: holds the key to use to decrypt the third party caveat
+    information and to encrypt any additional third party caveats returned by
+    the caveat checker.
+    :param checker: used to check the third party caveat, and may also return
+    further caveats to be added to the discharge macaroon.
+    :param locator: used to information on third parties referred to by third
+    party caveats returned by the Checker.
+    '''
+    caveat_id_prefix = []
+    if caveat is None:
+        # The caveat information is encoded in the id itself.
+        caveat = id
+    else:
+        # We've been given an explicit id, so when extra third party
+        # caveats are added, use that id as the prefix
+        # for any more ids.
+        caveat_id_prefix = id
+    cav_info = decode_caveat(key, caveat)
+    cav_info = ThirdPartyCaveatInfo(
+        condition=cav_info.condition,
+        first_party_public_key=cav_info.first_party_public_key,
+        third_party_key_pair=cav_info.third_party_key_pair,
+        root_key=cav_info.root_key,
+        caveat=cav_info.caveat,
+        version=cav_info.version,
+        id=id,
+        namespace=cav_info.namespace
+    )
+    # Note that we don't check the error - we allow the
+    # third party checker to see even caveats that we can't
+    # understand.
+    try:
+        cond, arg = checkers.parse_caveat(cav_info.condition)
+    except ValueError as exc:
+        raise VerificationError(exc.args[0])
+
+    if cond == checkers.COND_NEED_DECLARED:
+        cav_info = cav_info._replace(condition=arg)
+        caveats = _check_need_declared(ctx, cav_info, checker)
+    else:
+        caveats = checker.check_third_party_caveat(ctx, cav_info)
+
+    # Note that the discharge macaroon does not need to
+    # be stored persistently. Indeed, it would be a problem if
+    # we did, because then the macaroon could potentially be used
+    # for normal authorization with the third party.
+    m = Macaroon(
+        cav_info.root_key,
+        id,
+        '',
+        cav_info.version,
+        cav_info.namespace,
+    )
+    m._caveat_id_prefix = caveat_id_prefix
+    if caveats is not None:
+        for cav in caveats:
+            m.add_caveat(cav, key, locator)
+    return m
+
+
+def _check_need_declared(ctx, cav_info, checker):
+    arg = cav_info.condition
+    i = arg.find(' ')
+    if i <= 0:
+        raise VerificationError(
+            'need-declared caveat requires an argument, got %q'.format(arg),
+        )
+    need_declared = arg[0:i].split(',')
+    for d in need_declared:
+        if d == '':
+            raise VerificationError('need-declared caveat with empty required attribute')
+    if len(need_declared) == 0:
+        raise VerificationError('need-declared caveat with no required attributes')
+    cav_info = cav_info._replace(condition=arg[i + 1:])
+    caveats = checker.check_third_party_caveat(ctx, cav_info)
+    declared = {}
+    for cav in caveats:
+        if cav.location is not None and cav.location != '':
+            continue
+        # Note that we ignore the error. We allow the service to
+        # generate caveats that we don't understand here.
+        try:
+            cond, arg = checkers.parse_caveat(cav.condition)
+        except ValueError:
+            continue
+        if cond != checkers.COND_DECLARED:
+            continue
+        parts = arg.split()
+        if len(parts) != 2:
+            raise VerificationError('declared caveat has no value')
+        declared[parts[0]] = True
+    # Add empty declarations for everything mentioned in need-declared
+    # that was not actually declared.
+    for d in need_declared:
+        if not declared.get(d, False):
+            caveats.append(checkers.declared_caveat(d, ''))
+    return caveats
+
+
+class _EmptyLocator(ThirdPartyLocator):
+    def third_party_info(self, loc):
+        return None
+
+
+def local_third_party_caveat(key, version):
+    ''' Returns a third-party caveat that, when added to a macaroon with
+    add_caveat, results in a caveat with the location "local", encrypted with
+    the given PublicKey.
+    This can be automatically discharged by discharge_all passing a local key.
+    '''
+    if version >= VERSION_2:
+        loc = 'local {} {}'.format(version, key)
+    else:
+        loc = 'local {}'.format(key)
+    return checkers.Caveat(location=loc, condition='')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_error.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_error.py
new file mode 100644
index 0000000000000000000000000000000000000000..b4035696eb863d3c0db871e1b1f476143dd86d80
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_error.py
@@ -0,0 +1,77 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+
+class DischargeRequiredError(Exception):
+    ''' Raised by checker when authorization has failed and a discharged
+    macaroon might fix it.
+
+    A caller should grant the user the ability to authorize by minting a
+    macaroon associated with Ops (see MacaroonStore.MacaroonIdInfo for
+    how the associated operations are retrieved) and adding Caveats. If
+    the user succeeds in discharging the caveats, the authorization will
+    be granted.
+    '''
+    def __init__(self, msg, ops, cavs):
+        '''
+        :param msg: holds some reason why the authorization was denied.
+        :param ops: holds all the operations that were not authorized.
+        If ops contains a single LOGIN_OP member, the macaroon
+        should be treated as an login token. Login tokens (also
+        known as authentication macaroons) usually have a longer
+        life span than other macaroons.
+        :param cavs: holds the caveats that must be added to macaroons that
+        authorize the above operations.
+        '''
+        super(DischargeRequiredError, self).__init__(msg)
+        self._ops = ops
+        self._cavs = cavs
+
+    def ops(self):
+        return self._ops
+
+    def cavs(self):
+        return self._cavs
+
+
+class PermissionDenied(Exception):
+    '''Raised from AuthChecker when permission has been denied.
+    '''
+    pass
+
+
+class CaveatNotRecognizedError(Exception):
+    '''Containing the cause of errors returned from caveat checkers when the
+    caveat was not recognized.
+    '''
+    pass
+
+
+class VerificationError(Exception):
+    '''Raised to signify that an error is because of a verification failure
+    rather than because verification could not be done.'''
+    pass
+
+
+class AuthInitError(Exception):
+    '''Raised if AuthChecker cannot be initialized properly.'''
+    pass
+
+
+class IdentityError(Exception):
+    ''' Raised from IdentityClient.declared_identity when an error occurs.
+    '''
+    pass
+
+
+class ThirdPartyCaveatCheckFailed(Exception):
+    ''' Raised from ThirdPartyCaveatChecker.check_third_party when check fails.
+    '''
+    pass
+
+
+class ThirdPartyInfoNotFound(Exception):
+    ''' Raised from implementation of ThirdPartyLocator.third_party_info when
+    the info cannot be found.
+    '''
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_identity.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_identity.py
new file mode 100644
index 0000000000000000000000000000000000000000..4389cd99ced072c3319848423b9c9c5d6dff2eb6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_identity.py
@@ -0,0 +1,126 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+
+from ._error import IdentityError
+
+
+class Identity(object):
+    ''' Holds identity information declared in a first party caveat added when
+    discharging a third party caveat.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def id(self):
+        ''' Returns the id of the user.
+
+        May be an opaque blob with no human meaning. An id is only considered
+        to be unique with a given domain.
+        :return string
+        '''
+        raise NotImplementedError('id method must be defined in subclass')
+
+    @abc.abstractmethod
+    def domain(self):
+        '''Return the domain of the user.
+
+        This will be empty if the user was authenticated
+        directly with the identity provider.
+        :return string
+        '''
+        raise NotImplementedError('domain method must be defined in subclass')
+
+
+class ACLIdentity(Identity):
+    ''' ACLIdentity may be implemented by Identity implementations
+    to report group membership information.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def allow(self, ctx, acls):
+        ''' reports whether the user should be allowed to access
+        any of the users or groups in the given acl list.
+        :param ctx(AuthContext) is the context of the authorization request.
+        :param acls array of string acl
+        :return boolean
+        '''
+        raise NotImplementedError('allow method must be defined in subclass')
+
+
+class SimpleIdentity(ACLIdentity):
+    ''' A simple form of identity where the user is represented by a string.
+    '''
+    def __init__(self, user):
+        self._identity = user
+
+    def domain(self):
+        ''' A simple identity has no domain.
+        '''
+        return ''
+
+    def id(self):
+        '''Return the user name as the id.
+        '''
+        return self._identity
+
+    def allow(self, ctx, acls):
+        '''Allow access to any ACL members that was equal to the user name.
+
+        That is, some user u is considered a member of group u and no other.
+        '''
+        for acl in acls:
+            if self._identity == acl:
+                return True
+        return False
+
+
+class IdentityClient(object):
+    ''' Represents an abstract identity manager. User identities can be based
+    on local informaton (for example HTTP basic auth) or by reference to an
+    external trusted third party (an identity manager).
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def identity_from_context(self, ctx):
+        ''' Returns the identity based on information in the context.
+
+        If it cannot determine the identity based on the context, then it
+        should return a set of caveats containing a third party caveat that,
+        when discharged, can be used to obtain the identity with
+        declared_identity.
+
+        It should only raise an error if it cannot check the identity
+        (for example because of a database access error) - it's
+        OK to return all zero values when there's
+        no identity found and no third party to address caveats to.
+        @param ctx an AuthContext
+        :return: an Identity and array of caveats
+        '''
+        raise NotImplementedError('identity_from_context method must be '
+                                  'defined in subclass')
+
+    @abc.abstractmethod
+    def declared_identity(self, ctx, declared):
+        '''Parses the identity declaration from the given declared attributes.
+
+        TODO take the set of first party caveat conditions instead?
+        @param ctx (AuthContext)
+        @param declared (dict of string/string)
+        :return: an Identity
+        '''
+        raise NotImplementedError('declared_identity method must be '
+                                  'defined in subclass')
+
+
+class NoIdentities(IdentityClient):
+    ''' Defines the null identity provider - it never returns any identities.
+    '''
+
+    def identity_from_context(self, ctx):
+        return None, None
+
+    def declared_identity(self, ctx, declared):
+        raise IdentityError('no identity declared or possible')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_internal/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_internal/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_internal/id_pb2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_internal/id_pb2.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fd54c03ce579b4e15b85a80b9f3aab44ae046a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_internal/id_pb2.py
@@ -0,0 +1,132 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: macaroonbakery/internal/id.proto
+
+import sys
+_b=sys.version_info[0]<3 and (lambda x:x) or (lambda x:x.encode('latin1'))
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from google.protobuf import reflection as _reflection
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf import descriptor_pb2
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor.FileDescriptor(
+  name='macaroonbakery/internal/id.proto',
+  package='',
+  syntax='proto3',
+  serialized_pb=_b('\n macaroonbakery/internal/id.proto\"@\n\nMacaroonId\x12\r\n\x05nonce\x18\x01 \x01(\x0c\x12\x11\n\tstorageId\x18\x02 \x01(\x0c\x12\x10\n\x03ops\x18\x03 \x03(\x0b\x32\x03.Op\"%\n\x02Op\x12\x0e\n\x06\x65ntity\x18\x01 \x01(\t\x12\x0f\n\x07\x61\x63tions\x18\x02 \x03(\tB\x0cZ\nmacaroonpbb\x06proto3')
+)
+
+
+
+
+_MACAROONID = _descriptor.Descriptor(
+  name='MacaroonId',
+  full_name='MacaroonId',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='nonce', full_name='MacaroonId.nonce', index=0,
+      number=1, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=_b(""),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      options=None),
+    _descriptor.FieldDescriptor(
+      name='storageId', full_name='MacaroonId.storageId', index=1,
+      number=2, type=12, cpp_type=9, label=1,
+      has_default_value=False, default_value=_b(""),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      options=None),
+    _descriptor.FieldDescriptor(
+      name='ops', full_name='MacaroonId.ops', index=2,
+      number=3, type=11, cpp_type=10, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      options=None),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=36,
+  serialized_end=100,
+)
+
+
+_OP = _descriptor.Descriptor(
+  name='Op',
+  full_name='Op',
+  filename=None,
+  file=DESCRIPTOR,
+  containing_type=None,
+  fields=[
+    _descriptor.FieldDescriptor(
+      name='entity', full_name='Op.entity', index=0,
+      number=1, type=9, cpp_type=9, label=1,
+      has_default_value=False, default_value=_b("").decode('utf-8'),
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      options=None),
+    _descriptor.FieldDescriptor(
+      name='actions', full_name='Op.actions', index=1,
+      number=2, type=9, cpp_type=9, label=3,
+      has_default_value=False, default_value=[],
+      message_type=None, enum_type=None, containing_type=None,
+      is_extension=False, extension_scope=None,
+      options=None),
+  ],
+  extensions=[
+  ],
+  nested_types=[],
+  enum_types=[
+  ],
+  options=None,
+  is_extendable=False,
+  syntax='proto3',
+  extension_ranges=[],
+  oneofs=[
+  ],
+  serialized_start=102,
+  serialized_end=139,
+)
+
+_MACAROONID.fields_by_name['ops'].message_type = _OP
+DESCRIPTOR.message_types_by_name['MacaroonId'] = _MACAROONID
+DESCRIPTOR.message_types_by_name['Op'] = _OP
+_sym_db.RegisterFileDescriptor(DESCRIPTOR)
+
+MacaroonId = _reflection.GeneratedProtocolMessageType('MacaroonId', (_message.Message,), dict(
+  DESCRIPTOR = _MACAROONID,
+  __module__ = 'macaroonbakery.internal.id_pb2'
+  # @@protoc_insertion_point(class_scope:MacaroonId)
+  ))
+_sym_db.RegisterMessage(MacaroonId)
+
+Op = _reflection.GeneratedProtocolMessageType('Op', (_message.Message,), dict(
+  DESCRIPTOR = _OP,
+  __module__ = 'macaroonbakery.internal.id_pb2'
+  # @@protoc_insertion_point(class_scope:Op)
+  ))
+_sym_db.RegisterMessage(Op)
+
+
+DESCRIPTOR.has_options = True
+DESCRIPTOR._options = _descriptor._ParseOptions(descriptor_pb2.FileOptions(), _b('Z\nmacaroonpb'))
+# @@protoc_insertion_point(module_scope)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_keys.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_keys.py
new file mode 100644
index 0000000000000000000000000000000000000000..1da5f0561786e7ca63eb408c249560055050c048
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_keys.py
@@ -0,0 +1,100 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+import nacl.public
+
+
+class PrivateKey(object):
+    ''' A private key used by the bakery to encrypt and decrypt
+    third party caveats.
+    Internally, it is a 256-bit Ed25519 private key.
+    '''
+    def __init__(self, key):
+        self._key = key
+
+    @property
+    def key(self):
+        ''' Internal nacl key representation.
+        '''
+        return self._key
+
+    @property
+    def public_key(self):
+        '''
+        :return: the PublicKey associated with the private key.
+        '''
+        return PublicKey(self._key.public_key)
+
+    @classmethod
+    def deserialize(cls, serialized):
+        ''' Create a PrivateKey from a base64 encoded bytes.
+        :return: a PrivateKey
+        '''
+        return PrivateKey(
+            nacl.public.PrivateKey(serialized,
+                                   encoder=nacl.encoding.Base64Encoder))
+
+    def serialize(self, raw=False):
+        '''Encode the private part of the key in a base64 format by default,
+        but when raw is True it will return hex encoded bytes.
+        @return: bytes
+        '''
+        if raw:
+            return self._key.encode()
+        return self._key.encode(nacl.encoding.Base64Encoder)
+
+    def __str__(self):
+        '''Return the private part of the key key as a base64-encoded string'''
+        return self.serialize().decode('utf-8')
+
+    def __eq__(self, other):
+        return self.key == other.key
+
+
+class PublicKey(object):
+    ''' A public key used by the bakery to encrypt third party caveats.
+
+    Every discharger is associated with a public key which is used to
+    encrypt third party caveat ids addressed to that discharger.
+    Internally, it is a 256 bit Ed25519 public key.
+    '''
+    def __init__(self, key):
+        self._key = key
+
+    @property
+    def key(self):
+        ''' Internal nacl key representation.
+        '''
+        return self._key
+
+    def serialize(self, raw=False):
+        '''Encode the private part of the key in a base64 format by default,
+        but when raw is True it will return hex encoded bytes.
+        @return: bytes
+        '''
+        if raw:
+            return self._key.encode()
+        return self._key.encode(nacl.encoding.Base64Encoder)
+
+    def __str__(self):
+        '''Return the key as a base64-encoded string'''
+        return self.serialize().decode('utf-8')
+
+    @classmethod
+    def deserialize(cls, serialized):
+        ''' Create a PublicKey from a base64 encoded bytes.
+        :return: a PublicKey
+        '''
+        return PublicKey(
+            nacl.public.PublicKey(serialized,
+                                  encoder=nacl.encoding.Base64Encoder))
+
+    def __eq__(self, other):
+        return self.key == other.key
+
+
+def generate_key():
+    '''GenerateKey generates a new PrivateKey.
+    :return: a PrivateKey
+    '''
+    return PrivateKey(nacl.public.PrivateKey.generate())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_macaroon.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_macaroon.py
new file mode 100644
index 0000000000000000000000000000000000000000..1438ab107e136489ea3e95f8447099d7a4ffbfaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_macaroon.py
@@ -0,0 +1,430 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+import base64
+import json
+import logging
+import os
+
+import macaroonbakery.checkers as checkers
+import pymacaroons
+from macaroonbakery._utils import b64decode
+from pymacaroons.serializers import json_serializer
+from ._versions import (
+    LATEST_VERSION,
+    VERSION_0,
+    VERSION_1,
+    VERSION_2,
+    VERSION_3,
+)
+from ._error import (
+    ThirdPartyInfoNotFound,
+)
+from ._codec import (
+    encode_uvarint,
+    encode_caveat,
+)
+from ._keys import PublicKey
+from ._third_party import (
+    legacy_namespace,
+    ThirdPartyInfo,
+)
+
+log = logging.getLogger(__name__)
+
+
+class Macaroon(object):
+    '''Represent an undischarged macaroon along with its first
+    party caveat namespace and associated third party caveat information
+    which should be passed to the third party when discharging a caveat.
+    '''
+
+    def __init__(self, root_key, id, location=None,
+                 version=LATEST_VERSION, namespace=None):
+        '''Creates a new macaroon with the given root key, id and location.
+
+        If the version is more than the latest known version,
+        the latest known version will be used. The namespace should hold the
+        namespace of the service that is creating the macaroon.
+        @param root_key bytes or string
+        @param id bytes or string
+        @param location bytes or string
+        @param version the bakery version.
+        @param namespace is that of the service creating it
+        '''
+        if version > LATEST_VERSION:
+            log.info('use last known version:{} instead of: {}'.format(
+                LATEST_VERSION, version
+            ))
+            version = LATEST_VERSION
+        # m holds the underlying macaroon.
+        self._macaroon = pymacaroons.Macaroon(
+            location=location, key=root_key, identifier=id,
+            version=macaroon_version(version))
+        # version holds the version of the macaroon.
+        self._version = version
+        self._caveat_data = {}
+        if namespace is None:
+            namespace = checkers.Namespace()
+        self._namespace = namespace
+        self._caveat_id_prefix = bytearray()
+
+    @property
+    def macaroon(self):
+        ''' Return the underlying macaroon.
+        '''
+        return self._macaroon
+
+    @property
+    def version(self):
+        return self._version
+
+    @property
+    def namespace(self):
+        return self._namespace
+
+    @property
+    def caveat_data(self):
+        return self._caveat_data
+
+    def add_caveat(self, cav, key=None, loc=None):
+        '''Add a caveat to the macaroon.
+
+        It encrypts it using the given key pair
+        and by looking up the location using the given locator.
+        As a special case, if the caveat's Location field has the prefix
+        "local " the caveat is added as a client self-discharge caveat using
+        the public key base64-encoded in the rest of the location. In this
+        case, the Condition field must be empty. The resulting third-party
+        caveat will encode the condition "true" encrypted with that public
+        key.
+
+        @param cav the checkers.Caveat to be added.
+        @param key the public key to encrypt third party caveat.
+        @param loc locator to find information on third parties when adding
+        third party caveats. It is expected to have a third_party_info method
+        that will be called with a location string and should return a
+        ThirdPartyInfo instance holding the requested information.
+        '''
+        if cav.location is None:
+            self._macaroon.add_first_party_caveat(
+                self.namespace.resolve_caveat(cav).condition)
+            return
+        if key is None:
+            raise ValueError(
+                'no private key to encrypt third party caveat')
+        local_info = _parse_local_location(cav.location)
+        if local_info is not None:
+            if cav.condition:
+                raise ValueError(
+                    'cannot specify caveat condition in '
+                    'local third-party caveat')
+            info = local_info
+            cav = checkers.Caveat(location='local', condition='true')
+        else:
+            if loc is None:
+                raise ValueError(
+                    'no locator when adding third party caveat')
+            info = loc.third_party_info(cav.location)
+
+        root_key = os.urandom(24)
+
+        # Use the least supported version to encode the caveat.
+        if self._version < info.version:
+            info = ThirdPartyInfo(
+                version=self._version,
+                public_key=info.public_key,
+            )
+
+        caveat_info = encode_caveat(
+            cav.condition, root_key, info, key, self._namespace)
+        if info.version < VERSION_3:
+            # We're encoding for an earlier client or third party which does
+            # not understand bundled caveat info, so use the encoded
+            # caveat information as the caveat id.
+            id = caveat_info
+        else:
+            id = self._new_caveat_id(self._caveat_id_prefix)
+            self._caveat_data[id] = caveat_info
+
+        self._macaroon.add_third_party_caveat(cav.location, root_key, id)
+
+    def add_caveats(self, cavs, key, loc):
+        '''Add an array of caveats to the macaroon.
+
+        This method does not mutate the current object.
+        @param cavs arrary of caveats.
+        @param key the PublicKey to encrypt third party caveat.
+        @param loc locator to find the location object that has a method
+        third_party_info.
+        '''
+        if cavs is None:
+            return
+        for cav in cavs:
+            self.add_caveat(cav, key, loc)
+
+    def serialize_json(self):
+        '''Return a string holding the macaroon data in JSON format.
+        @return a string holding the macaroon data in JSON format
+        '''
+        return json.dumps(self.to_dict())
+
+    def to_dict(self):
+        '''Return a dict representation of the macaroon data in JSON format.
+        @return a dict
+        '''
+        if self.version < VERSION_3:
+            if len(self._caveat_data) > 0:
+                raise ValueError('cannot serialize pre-version3 macaroon with '
+                                 'external caveat data')
+            return json.loads(self._macaroon.serialize(
+                json_serializer.JsonSerializer()))
+        serialized = {
+            'm': json.loads(self._macaroon.serialize(
+                json_serializer.JsonSerializer())),
+            'v': self._version,
+        }
+        if self._namespace is not None:
+            serialized['ns'] = self._namespace.serialize_text().decode('utf-8')
+        caveat_data = {}
+        for id in self._caveat_data:
+            key = base64.b64encode(id).decode('utf-8')
+            value = base64.b64encode(self._caveat_data[id]).decode('utf-8')
+            caveat_data[key] = value
+        if len(caveat_data) > 0:
+            serialized['cdata'] = caveat_data
+        return serialized
+
+    @classmethod
+    def from_dict(cls, json_dict):
+        '''Return a macaroon obtained from the given dictionary as
+        deserialized from JSON.
+        @param json_dict The deserialized JSON object.
+        '''
+        json_macaroon = json_dict.get('m')
+        if json_macaroon is None:
+            # Try the v1 format if we don't have a macaroon field.
+            m = pymacaroons.Macaroon.deserialize(
+                json.dumps(json_dict), json_serializer.JsonSerializer())
+            macaroon = Macaroon(root_key=None, id=None,
+                                namespace=legacy_namespace(),
+                                version=_bakery_version(m.version))
+            macaroon._macaroon = m
+            return macaroon
+
+        version = json_dict.get('v', None)
+        if version is None:
+            raise ValueError('no version specified')
+        if (version < VERSION_3 or
+                version > LATEST_VERSION):
+            raise ValueError('unknown bakery version {}'.format(version))
+        m = pymacaroons.Macaroon.deserialize(json.dumps(json_macaroon),
+                                             json_serializer.JsonSerializer())
+        if m.version != macaroon_version(version):
+            raise ValueError(
+                'underlying macaroon has inconsistent version; '
+                'got {} want {}'.format(m.version, macaroon_version(version)))
+        namespace = checkers.deserialize_namespace(json_dict.get('ns'))
+        cdata = json_dict.get('cdata', {})
+        caveat_data = {}
+        for id64 in cdata:
+            id = b64decode(id64)
+            data = b64decode(cdata[id64])
+            caveat_data[id] = data
+        macaroon = Macaroon(root_key=None, id=None,
+                            namespace=namespace,
+                            version=version)
+        macaroon._caveat_data = caveat_data
+        macaroon._macaroon = m
+        return macaroon
+
+    @classmethod
+    def deserialize_json(cls, serialized_json):
+        '''Return a macaroon deserialized from a string
+        @param serialized_json The string to decode {str}
+        @return {Macaroon}
+        '''
+        serialized = json.loads(serialized_json)
+        return Macaroon.from_dict(serialized)
+
+    def _new_caveat_id(self, base):
+        '''Return a third party caveat id
+
+        This does not duplicate any third party caveat ids already inside
+        macaroon. If base is non-empty, it is used as the id prefix.
+
+        @param base bytes
+        @return bytes
+        '''
+        id = bytearray()
+        if len(base) > 0:
+            id.extend(base)
+        else:
+            # Add a version byte to the caveat id. Technically
+            # this is unnecessary as the caveat-decoding logic
+            # that looks at versions should never see this id,
+            # but if the caveat payload isn't provided with the
+            # payload, having this version gives a strong indication
+            # that the payload has been omitted so we can produce
+            # a better error for the user.
+            id.append(VERSION_3)
+
+        # Iterate through integers looking for one that isn't already used,
+        # starting from n so that if everyone is using this same algorithm,
+        # we'll only perform one iteration.
+        i = len(self._caveat_data)
+        caveats = self._macaroon.caveats
+        while True:
+            # We append a varint to the end of the id and assume that
+            # any client that's created the id that we're using as a base
+            # is using similar conventions - in the worst case they might
+            # end up with a duplicate third party caveat id and thus create
+            # a macaroon that cannot be discharged.
+            temp = id[:]
+            encode_uvarint(i, temp)
+            found = False
+            for cav in caveats:
+                if (cav.verification_key_id is not None
+                        and cav.caveat_id == temp):
+                    found = True
+                    break
+            if not found:
+                return bytes(temp)
+            i += 1
+
+    def first_party_caveats(self):
+        '''Return the first party caveats from this macaroon.
+
+        @return the first party caveats from this macaroon as pymacaroons
+        caveats.
+        '''
+        return self._macaroon.first_party_caveats()
+
+    def third_party_caveats(self):
+        '''Return the third party caveats.
+
+        @return the third party caveats as pymacaroons caveats.
+        '''
+        return self._macaroon.third_party_caveats()
+
+    def copy(self):
+        ''' Returns a copy of the macaroon. Note that the the new
+        macaroon's namespace still points to the same underlying Namespace -
+        copying the macaroon does not make a copy of the namespace.
+        :return a Macaroon
+        '''
+        m1 = Macaroon(None, None, version=self._version,
+                      namespace=self._namespace)
+        m1._macaroon = self._macaroon.copy()
+        m1._caveat_data = self._caveat_data.copy()
+        return m1
+
+
+def macaroon_version(bakery_version):
+    '''Return the macaroon version given the bakery version.
+
+    @param bakery_version the bakery version
+    @return macaroon_version the derived macaroon version
+    '''
+    if bakery_version in [VERSION_0, VERSION_1]:
+        return pymacaroons.MACAROON_V1
+    return pymacaroons.MACAROON_V2
+
+
+class ThirdPartyLocator(object):
+    '''Used to find information on third party discharge services.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def third_party_info(self, loc):
+        '''Return information on the third party at the given location.
+        @param loc string
+        @return: a ThirdPartyInfo
+        @raise: ThirdPartyInfoNotFound
+        '''
+        raise NotImplementedError('third_party_info method must be defined in '
+                                  'subclass')
+
+
+class ThirdPartyStore(ThirdPartyLocator):
+    ''' Implements a simple in memory ThirdPartyLocator.
+    '''
+    def __init__(self):
+        self._store = {}
+
+    def third_party_info(self, loc):
+        info = self._store.get(loc.rstrip('/'))
+        if info is None:
+            raise ThirdPartyInfoNotFound(
+                'cannot retrieve the info for location {}'.format(loc))
+        return info
+
+    def add_info(self, loc, info):
+        '''Associates the given information with the given location.
+        It will ignore any trailing slash.
+        @param loc the location as string
+        @param info (ThirdPartyInfo) to store for this location.
+        '''
+        self._store[loc.rstrip('/')] = info
+
+
+def _parse_local_location(loc):
+    '''Parse a local caveat location as generated by LocalThirdPartyCaveat.
+
+    This is of the form:
+
+        local <version> <pubkey>
+
+    where <version> is the bakery version of the client that we're
+    adding the local caveat for.
+
+    It returns None if the location does not represent a local
+    caveat location.
+    @return a ThirdPartyInfo.
+    '''
+    if not (loc.startswith('local ')):
+        return None
+    v = VERSION_1
+    fields = loc.split()
+    fields = fields[1:]  # Skip 'local'
+    if len(fields) == 2:
+        try:
+            v = int(fields[0])
+        except ValueError:
+            return None
+        fields = fields[1:]
+    if len(fields) == 1:
+        key = PublicKey.deserialize(fields[0])
+        return ThirdPartyInfo(public_key=key, version=v)
+    return None
+
+
+def _bakery_version(v):
+    # bakery_version returns a bakery version that corresponds to
+    # the macaroon version v. It is necessarily approximate because
+    # several bakery versions can correspond to a single macaroon
+    # version, so it's only of use when decoding legacy formats
+    #
+    # It will raise a ValueError if it doesn't recognize the version.
+    if v == pymacaroons.MACAROON_V1:
+        # Use version 1 because we don't know of any existing
+        # version 0 clients.
+        return VERSION_1
+    elif v == pymacaroons.MACAROON_V2:
+        # Note that this could also correspond to Version 3, but
+        # this logic is explicitly for legacy versions.
+        return VERSION_2
+    else:
+        raise ValueError('unknown macaroon version when deserializing legacy '
+                         'bakery macaroon; got {}'.format(v))
+
+
+class MacaroonJSONEncoder(json.JSONEncoder):
+    def encode(self, m):
+        return m.serialize_json()
+
+
+class MacaroonJSONDecoder(json.JSONDecoder):
+    def decode(self, s, _w=json.decoder.WHITESPACE.match):
+        return Macaroon.deserialize_json(s)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_oven.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_oven.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0a2a234113e848cd481bd2a91bc12f02e8025c6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_oven.py
@@ -0,0 +1,289 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+import base64
+import hashlib
+import itertools
+import os
+
+import google
+from ._checker import (Op, LOGIN_OP)
+from ._store import MemoryKeyStore
+from ._error import VerificationError
+from ._versions import (
+    VERSION_2,
+    VERSION_3,
+    LATEST_VERSION,
+)
+from ._macaroon import (
+    Macaroon,
+    macaroon_version,
+)
+
+import macaroonbakery.checkers as checkers
+import six
+from macaroonbakery._utils import (
+    raw_urlsafe_b64encode,
+    b64decode,
+)
+from ._internal import id_pb2
+from pymacaroons import MACAROON_V2, Verifier
+
+
+class Oven:
+    ''' Oven bakes macaroons. They emerge sweet and delicious and ready for use
+    in a Checker.
+
+    All macaroons are associated with one or more operations (see
+    the Op type) which define the capabilities of the macaroon.
+
+    There is one special operation, "login" (defined by LOGIN_OP) which grants
+    the capability to speak for a particular user.
+    The login capability will never be mixed with other capabilities.
+
+    It is up to the caller to decide on semantics for other operations.
+    '''
+
+    def __init__(self, key=None, location=None, locator=None, namespace=None,
+                 root_keystore_for_ops=None, ops_store=None):
+        '''
+        @param namespace holds the namespace to use when adding first party
+        caveats.
+        @param root_keystore_for_ops a function that will give the macaroon
+        storage to be used for root keys associated with macaroons created
+        with macaroon.
+        @param ops_store object is used to persistently store the association
+        of multi-op entities with their associated operations when macaroon is
+        called with multiple operations.
+        When this is in use, operation entities with the prefix "multi-" are
+        reserved - a "multi-"-prefixed entity represents a set of operations
+        stored in the OpsStore.
+        @param key holds the private nacl key pair used to encrypt third party
+        caveats. If it is None, no third party caveats can be created.
+        @param location string holds the location that will be associated with
+        new macaroons (as returned by Macaroon.Location).
+        @param locator is used to find out information on third parties when
+        adding third party caveats. If this is None, no non-local third
+        party caveats can be added.
+        '''
+        self.key = key
+        self.location = location
+        self.locator = locator
+        if namespace is None:
+            namespace = checkers.Checker().namespace()
+        self.namespace = namespace
+        self.ops_store = ops_store
+        self.root_keystore_for_ops = root_keystore_for_ops
+        if root_keystore_for_ops is None:
+            my_store = MemoryKeyStore()
+            self.root_keystore_for_ops = lambda x: my_store
+
+    def macaroon(self, version, expiry, caveats, ops):
+        ''' Takes a macaroon with the given version from the oven,
+        associates it with the given operations and attaches the given caveats.
+        There must be at least one operation specified.
+        The macaroon will expire at the given time - a time_before first party
+        caveat will be added with that time.
+
+        @return: a new Macaroon object.
+        '''
+        if len(ops) == 0:
+            raise ValueError('cannot mint a macaroon associated '
+                             'with no operations')
+
+        ops = canonical_ops(ops)
+        root_key, storage_id = self.root_keystore_for_ops(ops).root_key()
+
+        id = self._new_macaroon_id(storage_id, expiry, ops)
+
+        id_bytes = six.int2byte(LATEST_VERSION) + \
+            id.SerializeToString()
+
+        if macaroon_version(version) < MACAROON_V2:
+            # The old macaroon format required valid text for the macaroon id,
+            # so base64-encode it.
+            id_bytes = raw_urlsafe_b64encode(id_bytes)
+
+        m = Macaroon(
+            root_key,
+            id_bytes,
+            self.location,
+            version,
+            self.namespace,
+        )
+        m.add_caveat(checkers.time_before_caveat(expiry), self.key,
+                     self.locator)
+        m.add_caveats(caveats, self.key, self.locator)
+        return m
+
+    def _new_macaroon_id(self, storage_id, expiry, ops):
+        nonce = os.urandom(16)
+        if len(ops) == 1 or self.ops_store is None:
+            return id_pb2.MacaroonId(
+                nonce=nonce,
+                storageId=storage_id,
+                ops=_macaroon_id_ops(ops))
+        # We've got several operations and a multi-op store, so use the store.
+        # TODO use the store only if the encoded macaroon id exceeds some size?
+        entity = self.ops_entity(ops)
+        self.ops_store.put_ops(entity, expiry, ops)
+        return id_pb2.MacaroonId(
+            nonce=nonce,
+            storageId=storage_id,
+            ops=[id_pb2.Op(entity=entity, actions=['*'])])
+
+    def ops_entity(self, ops):
+        ''' Returns a new multi-op entity name string that represents
+        all the given operations and caveats. It returns the same value
+        regardless of the ordering of the operations. It assumes that the
+        operations have been canonicalized and that there's at least one
+        operation.
+
+        :param ops:
+        :return: string that represents all the given operations and caveats.
+        '''
+        # Hash the operations, removing duplicates as we go.
+        hash_entity = hashlib.sha256()
+        for op in ops:
+            hash_entity.update('{}\n{}\n'.format(
+                op.action, op.entity).encode())
+        hash_encoded = base64.urlsafe_b64encode(hash_entity.digest())
+        return 'multi-' + hash_encoded.decode('utf-8').rstrip('=')
+
+    def macaroon_ops(self, macaroons):
+        ''' This method makes the oven satisfy the MacaroonOpStore protocol
+        required by the Checker class.
+
+        For macaroons minted with previous bakery versions, it always
+        returns a single LoginOp operation.
+
+        :param macaroons:
+        :return:
+        '''
+        if len(macaroons) == 0:
+            raise ValueError('no macaroons provided')
+
+        storage_id, ops = _decode_macaroon_id(macaroons[0].identifier_bytes)
+        root_key = self.root_keystore_for_ops(ops).get(storage_id)
+        if root_key is None:
+            raise VerificationError(
+                'macaroon key not found in storage')
+        v = Verifier()
+        conditions = []
+
+        def validator(condition):
+            # Verify the macaroon's signature only. Don't check any of the
+            # caveats yet but save them so that we can return them.
+            conditions.append(condition)
+            return True
+        v.satisfy_general(validator)
+        try:
+            v.verify(macaroons[0], root_key, macaroons[1:])
+        except Exception as exc:
+            # Unfortunately pymacaroons doesn't control
+            # the set of exceptions that can be raised here.
+            # Possible candidates are:
+            # pymacaroons.exceptions.MacaroonUnmetCaveatException
+            # pymacaroons.exceptions.MacaroonInvalidSignatureException
+            # ValueError
+            # nacl.exceptions.CryptoError
+            #
+            # There may be others too, so just catch everything.
+            raise six.raise_from(
+                VerificationError('verification failed: {}'.format(str(exc))),
+                exc,
+            )
+
+        if (self.ops_store is not None
+            and len(ops) == 1
+                and ops[0].entity.startswith('multi-')):
+            # It's a multi-op entity, so retrieve the actual operations
+            # it's associated with.
+            ops = self.ops_store.get_ops(ops[0].entity)
+
+        return ops, conditions
+
+
+def _decode_macaroon_id(id):
+    storage_id = b''
+    base64_decoded = False
+    first = id[:1]
+    if first == b'A':
+        # The first byte is not a version number and it's 'A', which is the
+        # base64 encoding of the top 6 bits (all zero) of the version number 2
+        # or 3, so we assume that it's the base64 encoding of a new-style
+        # macaroon id, so we base64 decode it.
+        #
+        # Note that old-style ids always start with an ASCII character >= 4
+        # (> 32 in fact) so this logic won't be triggered for those.
+        try:
+            dec = b64decode(id.decode('utf-8'))
+            # Set the id only on success.
+            id = dec
+            base64_decoded = True
+        except:
+            # if it's a bad encoding, we'll get an error which is fine
+            pass
+
+    # Trim any extraneous information from the id before retrieving
+    # it from storage, including the UUID that's added when
+    # creating macaroons to make all macaroons unique even if
+    # they're using the same root key.
+    first = six.byte2int(id[:1])
+    if first == VERSION_2:
+        # Skip the UUID at the start of the id.
+        storage_id = id[1 + 16:]
+    if first == VERSION_3:
+        try:
+            id1 = id_pb2.MacaroonId.FromString(id[1:])
+        except google.protobuf.message.DecodeError:
+            raise VerificationError(
+                'no operations found in macaroon')
+        if len(id1.ops) == 0 or len(id1.ops[0].actions) == 0:
+            raise VerificationError(
+                'no operations found in macaroon')
+
+        ops = []
+        for op in id1.ops:
+            for action in op.actions:
+                ops.append(Op(op.entity, action))
+        return id1.storageId, ops
+
+    if not base64_decoded and _is_lower_case_hex_char(first):
+        # It's an old-style id, probably with a hyphenated UUID.
+        # so trim that off.
+        last = id.rfind(b'-')
+        if last >= 0:
+            storage_id = id[0:last]
+    return storage_id, [LOGIN_OP]
+
+
+def _is_lower_case_hex_char(b):
+    if ord('0') <= b <= ord('9'):
+        return True
+    if ord('a') <= b <= ord('f'):
+        return True
+    return False
+
+
+def canonical_ops(ops):
+    ''' Returns the given operations array sorted with duplicates removed.
+
+    @param ops checker.Ops
+    @return: checker.Ops
+    '''
+    new_ops = sorted(set(ops), key=lambda x: (x.entity, x.action))
+    return new_ops
+
+
+def _macaroon_id_ops(ops):
+    '''Return operations suitable for serializing as part of a MacaroonId.
+
+    It assumes that ops has been canonicalized and that there's at least
+    one operation.
+    '''
+    id_ops = []
+    for entity, entity_ops in itertools.groupby(ops, lambda x: x.entity):
+        actions = map(lambda x: x.action, entity_ops)
+        id_ops.append(id_pb2.Op(entity=entity, actions=actions))
+    return id_ops
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_store.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_store.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae5f7a7ab17201426dedd838242eeba1867384d2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_store.py
@@ -0,0 +1,77 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+import os
+
+
+class MemoryOpsStore:
+    ''' A multi-op store that stores the operations in memory.
+    '''
+    def __init__(self):
+        self._store = {}
+
+    def put_ops(self, key, time, ops):
+        ''' Put an ops only if not already there, otherwise it's a no op.
+        '''
+        if self._store.get(key) is None:
+            self._store[key] = ops
+
+    def get_ops(self, key):
+        ''' Returns ops from the key if found otherwise raises a KeyError.
+        '''
+        ops = self._store.get(key)
+        if ops is None:
+            raise KeyError(
+                'cannot get operations for {}'.format(key))
+        return ops
+
+
+class RootKeyStore(object):
+    ''' Defines a store for macaroon root keys.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def get(self, id):
+        ''' Returns the root key for the given id.
+        If the item is not there, it returns None.
+        @param id: bytes
+        @return: bytes
+        '''
+        raise NotImplementedError('get method must be defined in '
+                                  'subclass')
+
+    @abc.abstractmethod
+    def root_key(self):
+        ''' Returns the root key to be used for making a new macaroon, and an
+        id that can be used to look it up later with the get method.
+        Note that the root keys should remain available for as long as the
+        macaroons using them are valid.
+        Note that there is no need for it to return a new root key for every
+        call - keys may be reused, although some key cycling is over time is
+        advisable.
+        @return: bytes
+        '''
+
+
+class MemoryKeyStore(RootKeyStore):
+    ''' MemoryKeyStore returns an implementation of
+    Store that generates a single key and always
+    returns that from root_key. The same id ("0") is always
+    used.
+    '''
+    def __init__(self, key=None):
+        ''' If the key is not specified a random key will be generated.
+        @param key: bytes
+        '''
+        if key is None:
+            key = os.urandom(24)
+        self._key = key
+
+    def get(self, id):
+        if id != b'0':
+            return None
+        return self._key
+
+    def root_key(self):
+        return self._key, b'0'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_third_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_third_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..91eacaf359189b3b986f71190d6f8bc59172e054
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_third_party.py
@@ -0,0 +1,57 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from collections import namedtuple
+
+import macaroonbakery.checkers as checkers
+
+
+def legacy_namespace():
+    ''' Standard namespace for pre-version3 macaroons.
+    '''
+    ns = checkers.Namespace(None)
+    ns.register(checkers.STD_NAMESPACE, '')
+    return ns
+
+
+class ThirdPartyCaveatInfo(namedtuple(
+    'ThirdPartyCaveatInfo',
+    'condition, first_party_public_key, third_party_key_pair, root_key, '
+        'caveat, version, id, namespace')):
+    '''ThirdPartyCaveatInfo holds the information decoded from
+    a third party caveat id.
+
+    @param condition holds the third party condition to be discharged.
+    This is the only field that most third party dischargers will
+    need to consider. {str}
+
+    @param first_party_public_key holds the public key of the party
+    that created the third party caveat. {PublicKey}
+
+    @param third_party_key_pair holds the nacl private used to decrypt
+    the caveat - the key pair of the discharging service. {PrivateKey}
+
+    @param root_key holds the secret root key encoded by the caveat. {bytes}
+
+    @param caveat holds the full caveat id from
+    which all the other fields are derived. {bytes}
+
+    @param version holds the version that was used to encode
+    the caveat id. {number}
+
+    @param id holds the id of the third party caveat (the id that the
+    discharge macaroon should be given). This will differ from Caveat
+    when the caveat information is encoded separately. {bytes}
+
+    @param namespace object that holds the namespace of the first party
+    that created the macaroon, as encoded by the party that added the
+    third party caveat. {checkers.Namespace}
+    '''
+
+
+class ThirdPartyInfo(namedtuple('ThirdPartyInfo', 'version, public_key')):
+    ''' ThirdPartyInfo holds information on a given third party
+    discharge service.
+    @param version The latest bakery protocol version supported
+    by the discharger {number}
+    @param public_key Public key of the third party {PublicKey}
+    '''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_versions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_versions.py
new file mode 100644
index 0000000000000000000000000000000000000000..7446d31faf2cf18eed404f1360231d9fd3165457
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/bakery/_versions.py
@@ -0,0 +1,9 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+
+VERSION_0 = 0
+VERSION_1 = 1
+VERSION_2 = 2
+VERSION_3 = 3
+LATEST_VERSION = VERSION_3
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3ea4664acde87aa7f8e9d9d9ec89975be7cbd02
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/__init__.py
@@ -0,0 +1,82 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from ._conditions import (
+    STD_NAMESPACE,
+    COND_DECLARED,
+    COND_TIME_BEFORE,
+    COND_ERROR,
+    COND_ALLOW,
+    COND_DENY,
+    COND_NEED_DECLARED,
+)
+from ._caveat import (
+    allow_caveat,
+    deny_caveat,
+    declared_caveat,
+    parse_caveat,
+    time_before_caveat,
+    Caveat,
+)
+from ._declared import (
+    context_with_declared,
+    infer_declared,
+    infer_declared_from_conditions,
+    need_declared_caveat,
+)
+from ._operation import (
+    context_with_operations,
+)
+from ._namespace import (
+    Namespace,
+    deserialize_namespace
+)
+from ._time import (
+    context_with_clock,
+    expiry_time,
+    macaroons_expiry_time,
+)
+from ._checkers import (
+    Checker,
+    CheckerInfo,
+    RegisterError,
+)
+from ._auth_context import (
+    AuthContext,
+    ContextKey,
+)
+
+from ._utils import (
+    condition_with_prefix,
+)
+
+__all__ = [
+    'AuthContext',
+    'Caveat',
+    'Checker',
+    'CheckerInfo',
+    'COND_ALLOW',
+    'COND_DECLARED',
+    'COND_DENY',
+    'COND_ERROR',
+    'COND_NEED_DECLARED',
+    'COND_TIME_BEFORE',
+    'ContextKey',
+    'STD_NAMESPACE',
+    'Namespace',
+    'RegisterError',
+    'allow_caveat',
+    'condition_with_prefix',
+    'context_with_declared',
+    'context_with_operations',
+    'context_with_clock',
+    'declared_caveat',
+    'deny_caveat',
+    'deserialize_namespace',
+    'expiry_time',
+    'infer_declared',
+    'infer_declared_from_conditions',
+    'macaroons_expiry_time',
+    'need_declared_caveat',
+    'parse_caveat',
+    'time_before_caveat',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_auth_context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_auth_context.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ca5168469858eba47bc72e13748fcbdd8085338
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_auth_context.py
@@ -0,0 +1,61 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+try:
+    from collections.abc import Mapping
+except ImportError:
+    from collections import Mapping
+
+
+class AuthContext(Mapping):
+    ''' Holds a set of keys and values relevant to authorization.
+
+    It is passed as an argument to authorization checkers, so that the checkers
+    can access information about the context of the authorization request.
+    It is immutable - values can only be added by copying the whole thing.
+    '''
+    def __init__(self, somedict=None):
+        if somedict is None:
+            somedict = {}
+        self._dict = dict(somedict)
+        self._hash = None
+
+    def with_value(self, key, val):
+        ''' Return a copy of the AuthContext object with the given key and
+        value added.
+        '''
+        new_dict = dict(self._dict)
+        new_dict[key] = val
+        return AuthContext(new_dict)
+
+    def __getitem__(self, key):
+        return self._dict[key]
+
+    def __len__(self):
+        return len(self._dict)
+
+    def __iter__(self):
+        return iter(self._dict)
+
+    def __hash__(self):
+        if self._hash is None:
+            self._hash = hash(frozenset(self._dict.items()))
+        return self._hash
+
+    def __eq__(self, other):
+        return self._dict == other._dict
+
+
+class ContextKey(object):
+    '''Provides a unique key suitable for use as a key into AuthContext.'''
+
+    def __init__(self, name):
+        '''Creates a context key using the given name. The name is
+     only for informational purposes.
+     '''
+        self._name = name
+
+    def __str__(self):
+        return '%s#%#x' % (self._name, id(self))
+
+    def __repr__(self):
+        return 'context_key(%r, %#x)' % (self._name, id(self))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_caveat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_caveat.py
new file mode 100644
index 0000000000000000000000000000000000000000..5732f43e63cc378190709d0fa59ed1002bbd050e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_caveat.py
@@ -0,0 +1,128 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import collections
+
+import pyrfc3339
+from ._conditions import (
+    COND_ALLOW,
+    COND_DECLARED,
+    COND_DENY,
+    COND_ERROR,
+    COND_TIME_BEFORE,
+    STD_NAMESPACE,
+)
+
+
+class Caveat(collections.namedtuple('Caveat', 'condition location namespace')):
+    '''Represents a condition that must be true for a check to complete
+    successfully.
+
+    If location is provided, the caveat must be discharged by
+    a third party at the given location (a URL string).
+
+    The namespace parameter holds the namespace URI string of the
+    condition - if it is provided, it will be converted to a namespace prefix
+    before adding to the macaroon.
+    '''
+    __slots__ = ()
+
+    def __new__(cls, condition, location=None, namespace=None):
+        return super(Caveat, cls).__new__(cls, condition, location, namespace)
+
+
+def declared_caveat(key, value):
+    '''Returns a "declared" caveat asserting that the given key is
+    set to the given value.
+
+    If a macaroon has exactly one first party caveat asserting the value of a
+    particular key, then infer_declared will be able to infer the value, and
+    then the check will allow the declared value if it has the value
+    specified here.
+
+    If the key is empty or contains a space, it will return an error caveat.
+    '''
+    if key.find(' ') >= 0 or key == '':
+        return error_caveat('invalid caveat \'declared\' key "{}"'.format(key))
+    return _first_party(COND_DECLARED, key + ' ' + value)
+
+
+def error_caveat(f):
+    '''Returns a caveat that will never be satisfied, holding f as the text of
+    the caveat.
+
+    This should only be used for highly unusual conditions that are never
+    expected to happen in practice, such as a malformed key that is
+    conventionally passed as a constant. It's not a panic but you should
+    only use it in cases where a panic might possibly be appropriate.
+
+    This mechanism means that caveats can be created without error
+    checking and a later systematic check at a higher level (in the
+    bakery package) can produce an error instead.
+    '''
+    return _first_party(COND_ERROR, f)
+
+
+def allow_caveat(ops):
+    ''' Returns a caveat that will deny attempts to use the macaroon to perform
+    any operation other than those listed. Operations must not contain a space.
+    '''
+    if ops is None or len(ops) == 0:
+        return error_caveat('no operations allowed')
+    return _operation_caveat(COND_ALLOW, ops)
+
+
+def deny_caveat(ops):
+    '''Returns a caveat that will deny attempts to use the macaroon to perform
+    any of the listed operations. Operations must not contain a space.
+    '''
+    return _operation_caveat(COND_DENY, ops)
+
+
+def _operation_caveat(cond, ops):
+    ''' Helper for allow_caveat and deny_caveat.
+
+    It checks that all operation names are valid before creating the caveat.
+    '''
+    for op in ops:
+        if op.find(' ') != -1:
+            return error_caveat('invalid operation name "{}"'.format(op))
+    return _first_party(cond, ' '.join(ops))
+
+
+def time_before_caveat(t):
+    '''Return a caveat that specifies that the time that it is checked at
+    should be before t.
+    :param t is a a UTC date in - use datetime.utcnow, not datetime.now
+    '''
+
+    return _first_party(COND_TIME_BEFORE,
+                        pyrfc3339.generate(t, accept_naive=True,
+                                           microseconds=True))
+
+
+def parse_caveat(cav):
+    ''' Parses a caveat into an identifier, identifying the checker that should
+    be used, and the argument to the checker (the rest of the string).
+
+    The identifier is taken from all the characters before the first
+    space character.
+    :return two string, identifier and arg
+    '''
+    if cav == '':
+        raise ValueError('empty caveat')
+    try:
+        i = cav.index(' ')
+    except ValueError:
+        return cav, ''
+    if i == 0:
+        raise ValueError('caveat starts with space character')
+    return cav[0:i], cav[i + 1:]
+
+
+def _first_party(name, arg):
+    condition = name
+    if arg != '':
+        condition += ' ' + arg
+
+    return Caveat(condition=condition,
+                  namespace=STD_NAMESPACE)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_checkers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_checkers.py
new file mode 100644
index 0000000000000000000000000000000000000000..11a41b9959233d89b46627c4d131cd82729fb21c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_checkers.py
@@ -0,0 +1,249 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+from collections import namedtuple
+from datetime import datetime
+
+import pyrfc3339
+from ._caveat import parse_caveat
+from ._conditions import (
+    COND_ALLOW,
+    COND_DECLARED,
+    COND_DENY,
+    COND_ERROR,
+    COND_TIME_BEFORE,
+    STD_NAMESPACE,
+)
+from ._declared import DECLARED_KEY
+from ._namespace import Namespace
+from ._operation import OP_KEY
+from ._time import TIME_KEY
+from ._utils import condition_with_prefix
+
+
+class RegisterError(Exception):
+    '''Raised when a condition cannot be registered with a Checker.'''
+    pass
+
+
+class FirstPartyCaveatChecker(object):
+    '''Used to check first party caveats for validity with respect to
+    information in the provided context.
+
+    If the caveat kind was not recognised, the checker should return
+    ErrCaveatNotRecognized.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def check_first_party_caveat(self, ctx, caveat):
+        '''	Checks that the given caveat condition is valid with respect to
+        the given context information.
+        :param ctx: an Auth context
+        :param caveat a string
+        '''
+        raise NotImplementedError('check_first_party_caveat method must be '
+                                  'defined in subclass')
+
+    def namespace(self):
+        '''	Returns the namespace associated with the caveat checker.
+        '''
+        raise NotImplementedError('namespace method must be '
+                                  'defined in subclass')
+
+
+class Checker(FirstPartyCaveatChecker):
+    ''' Holds a set of checkers for first party caveats.
+    '''
+
+    def __init__(self, namespace=None, include_std_checkers=True):
+        if namespace is None:
+            namespace = Namespace()
+        self._namespace = namespace
+        self._checkers = {}
+        if include_std_checkers:
+            self.register_std()
+
+    def check_first_party_caveat(self, ctx, cav):
+        ''' Checks the caveat against all registered caveat conditions.
+        :return: error message string if any or None
+        '''
+        try:
+            cond, arg = parse_caveat(cav)
+        except ValueError as ex:
+            # If we can't parse it, perhaps it's in some other format,
+            # return a not-recognised error.
+            return 'cannot parse caveat "{}": {}'.format(cav, ex.args[0])
+        checker = self._checkers.get(cond)
+        if checker is None:
+            return 'caveat "{}" not satisfied: caveat not recognized'.format(
+                cav)
+        err = checker.check(ctx, cond, arg)
+        if err is not None:
+            return 'caveat "{}" not satisfied: {}'.format(cav, err)
+
+    def namespace(self):
+        ''' Returns the namespace associated with the Checker.
+        '''
+        return self._namespace
+
+    def info(self):
+        ''' Returns information on all the registered checkers.
+
+        Sorted by namespace and then name
+        :returns a list of CheckerInfo
+        '''
+        return sorted(self._checkers.values(), key=lambda x: (x.ns, x.name))
+
+    def register(self, cond, uri, check):
+        ''' Registers the given condition(string) in the given namespace
+        uri (string) to be checked with the given check function.
+        The check function checks a caveat by passing an auth context, a cond
+        parameter(string) that holds the caveat condition including any
+        namespace prefix and an arg parameter(string) that hold any additional
+        caveat argument text. It will return any error as string otherwise
+        None.
+
+        It will raise a ValueError if the namespace is not registered or
+        if the condition has already been registered.
+        '''
+        if check is None:
+            raise RegisterError(
+                'no check function registered for namespace {} when '
+                'registering condition {}'.format(uri, cond))
+
+        prefix = self._namespace.resolve(uri)
+        if prefix is None:
+            raise RegisterError('no prefix registered for namespace {} when '
+                                'registering condition {}'.format(uri, cond))
+
+        if prefix == '' and cond.find(':') >= 0:
+            raise RegisterError(
+                'caveat condition {} in namespace {} contains a colon but its'
+                ' prefix is empty'.format(cond, uri))
+
+        full_cond = condition_with_prefix(prefix, cond)
+        info = self._checkers.get(full_cond)
+        if info is not None:
+            raise RegisterError(
+                'checker for {} (namespace {}) already registered in '
+                'namespace {}'.format(full_cond, uri, info.ns))
+        self._checkers[full_cond] = CheckerInfo(
+            check=check,
+            ns=uri,
+            name=cond,
+            prefix=prefix)
+
+    def register_std(self):
+        ''' Registers all the standard checkers in the given checker.
+
+        If not present already, the standard checkers schema (STD_NAMESPACE) is
+        added to the checker's namespace with an empty prefix.
+        '''
+        self._namespace.register(STD_NAMESPACE, '')
+        for cond in _ALL_CHECKERS:
+            self.register(cond, STD_NAMESPACE, _ALL_CHECKERS[cond])
+
+
+class CheckerInfo(namedtuple('CheckInfo', 'prefix name ns check')):
+    '''CheckerInfo holds information on a registered checker.
+    '''
+    __slots__ = ()
+
+    def __new__(cls, prefix, name, ns, check=None):
+        '''
+        :param check holds the actual checker function which takes an auth
+        context and a condition and arg string as arguments.
+        :param prefix holds the prefix for the checker condition as string.
+        :param name holds the name of the checker condition as string.
+        :param ns holds the namespace URI for the checker's schema as
+        Namespace.
+        '''
+        return super(CheckerInfo, cls).__new__(cls, prefix, name, ns, check)
+
+
+def _check_time_before(ctx, cond, arg):
+    clock = ctx.get(TIME_KEY)
+    if clock is None:
+        now = datetime.utcnow()
+    else:
+        now = clock.utcnow()
+
+    try:
+        # Note: pyrfc3339 returns a datetime with a timezone, which
+        # we need to remove before we can compare it with the naive
+        # datetime object returned by datetime.utcnow.
+        expiry = pyrfc3339.parse(arg, utc=True).replace(tzinfo=None)
+        if now >= expiry:
+            return 'macaroon has expired'
+    except ValueError:
+        return 'cannot parse "{}" as RFC 3339'.format(arg)
+    return None
+
+
+def _check_declared(ctx, cond, arg):
+    parts = arg.split(' ', 1)
+    if len(parts) != 2:
+        return 'declared caveat has no value'
+    attrs = ctx.get(DECLARED_KEY, {})
+    val = attrs.get(parts[0])
+    if val is None:
+        return 'got {}=null, expected "{}"'.format(parts[0], parts[1])
+
+    if val != parts[1]:
+        return 'got {}="{}", expected "{}"'.format(parts[0], val, parts[1])
+    return None
+
+
+def _check_error(ctx, cond, arg):
+    return 'bad caveat'
+
+
+def _check_allow(ctx, cond, arg):
+    return _check_operations(ctx, True, arg)
+
+
+def _check_deny(ctx, cond, arg):
+    return _check_operations(ctx, False, arg)
+
+
+def _check_operations(ctx, need_ops, arg):
+    ''' Checks an allow or a deny caveat. The need_ops parameter specifies
+    whether we require all the operations in the caveat to be declared in
+    the context.
+    '''
+    ctx_ops = ctx.get(OP_KEY, [])
+    if len(ctx_ops) == 0:
+        if need_ops:
+            f = arg.split()
+            if len(f) == 0:
+                return 'no operations allowed'
+            return '{} not allowed'.format(f[0])
+        return None
+
+    fields = arg.split()
+    for op in ctx_ops:
+        err = _check_op(op, need_ops, fields)
+        if err is not None:
+            return err
+    return None
+
+
+def _check_op(ctx_op, need_op, fields):
+    found = False
+    for op in fields:
+        if op == ctx_op:
+            found = True
+            break
+    if found != need_op:
+        return '{} not allowed'.format(ctx_op)
+    return None
+
+
+_ALL_CHECKERS = {
+    COND_TIME_BEFORE: _check_time_before,
+    COND_DECLARED: _check_declared,
+    COND_ERROR: _check_error,
+    COND_ALLOW: _check_allow,
+    COND_DENY: _check_deny,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_conditions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_conditions.py
new file mode 100644
index 0000000000000000000000000000000000000000..74e863e85134186406324c4fa9972c70f3af8dd1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_conditions.py
@@ -0,0 +1,17 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+# StdNamespace holds the URI of the standard checkers schema.
+STD_NAMESPACE = 'std'
+
+# Constants for all the standard caveat conditions.
+# First and third party caveat conditions are both defined here,
+# even though notionally they exist in separate name spaces.
+COND_DECLARED = 'declared'
+COND_TIME_BEFORE = 'time-before'
+COND_ERROR = 'error'
+COND_ALLOW = 'allow'
+COND_DENY = 'deny'
+
+
+COND_NEED_DECLARED = 'need-declared'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_declared.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_declared.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae4f95bfc88c6d677c132f2db3296046b101528f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_declared.py
@@ -0,0 +1,84 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from ._auth_context import ContextKey
+from ._caveat import Caveat, error_caveat, parse_caveat
+from ._conditions import (
+    COND_DECLARED,
+    COND_NEED_DECLARED,
+    STD_NAMESPACE,
+)
+from ._namespace import Namespace
+
+DECLARED_KEY = ContextKey('declared-key')
+
+
+def infer_declared(ms, namespace=None):
+    '''Retrieves any declared information from the given macaroons and returns
+    it as a key-value map.
+    Information is declared with a first party caveat as created by
+    declared_caveat.
+
+    If there are two caveats that declare the same key with different values,
+    the information is omitted from the map. When the caveats are later
+    checked, this will cause the check to fail.
+    namespace is the Namespace used to retrieve the prefix associated to the
+    uri, if None it will use the STD_NAMESPACE only.
+    '''
+    conditions = []
+    for m in ms:
+        for cav in m.caveats:
+            if cav.location is None or cav.location == '':
+                conditions.append(cav.caveat_id_bytes.decode('utf-8'))
+    return infer_declared_from_conditions(conditions, namespace)
+
+
+def infer_declared_from_conditions(conds, namespace=None):
+    ''' like infer_declared except that it is passed a set of first party
+    caveat conditions as a list of string rather than a set of macaroons.
+    '''
+    conflicts = []
+    # If we can't resolve that standard namespace, then we'll look for
+    # just bare "declared" caveats which will work OK for legacy
+    # macaroons with no namespace.
+    if namespace is None:
+        namespace = Namespace()
+    prefix = namespace.resolve(STD_NAMESPACE)
+    if prefix is None:
+        prefix = ''
+    declared_cond = prefix + COND_DECLARED
+
+    info = {}
+    for cond in conds:
+        try:
+            name, rest = parse_caveat(cond)
+        except ValueError:
+            name, rest = '', ''
+        if name != declared_cond:
+            continue
+        parts = rest.split(' ', 1)
+        if len(parts) != 2:
+            continue
+        key, val = parts[0], parts[1]
+        old_val = info.get(key)
+        if old_val is not None and old_val != val:
+            conflicts.append(key)
+            continue
+        info[key] = val
+    for key in set(conflicts):
+        del info[key]
+    return info
+
+
+def context_with_declared(ctx, declared):
+    ''' Returns a context with attached declared information,
+    as returned from infer_declared.
+    '''
+    return ctx.with_value(DECLARED_KEY, declared)
+
+
+def need_declared_caveat(cav, keys):
+    if cav.location == '':
+        return error_caveat('need-declared caveat is not third-party')
+    return Caveat(location=cav.location,
+                  condition=(COND_NEED_DECLARED + ' ' + ','.join(keys)
+                             + ' ' + cav.condition))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_namespace.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_namespace.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c3b1e389ad00e6f806e4d722f6280f08d8f65b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_namespace.py
@@ -0,0 +1,165 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import collections
+
+from ._caveat import error_caveat
+from ._utils import condition_with_prefix
+
+
+class Namespace:
+    '''Holds maps from schema URIs to prefixes.
+
+    prefixes that are used to encode them in first party
+    caveats. Several different URIs may map to the same
+    prefix - this is usual when several different backwardly
+    compatible schema versions are registered.
+    '''
+
+    def __init__(self, uri_to_prefix=None):
+        self._uri_to_prefix = {}
+        if uri_to_prefix is not None:
+            for k in uri_to_prefix:
+                self.register(k, uri_to_prefix[k])
+
+    def __str__(self):
+        '''Returns the namespace representation as returned by serialize
+        :return: str
+        '''
+        return self.serialize_text().decode('utf-8')
+
+    def __eq__(self, other):
+        return self._uri_to_prefix == other._uri_to_prefix
+
+    def serialize_text(self):
+        '''Returns a serialized form of the Namepace.
+
+        All the elements in the namespace are sorted by
+        URI, joined to the associated prefix with a colon and
+        separated with spaces.
+        :return: bytes
+        '''
+        if self._uri_to_prefix is None or len(self._uri_to_prefix) == 0:
+            return b''
+        od = collections.OrderedDict(sorted(self._uri_to_prefix.items()))
+        data = []
+        for uri in od:
+            data.append(uri + ':' + od[uri])
+        return ' '.join(data).encode('utf-8')
+
+    def register(self, uri, prefix):
+        '''Registers the given URI and associates it with the given prefix.
+
+        If the URI has already been registered, this is a no-op.
+
+        :param uri: string
+        :param prefix: string
+        '''
+        if not is_valid_schema_uri(uri):
+            raise KeyError(
+                'cannot register invalid URI {} (prefix {})'.format(
+                    uri, prefix))
+        if not is_valid_prefix(prefix):
+            raise ValueError(
+                'cannot register invalid prefix %q for URI %q'.format(
+                    prefix, uri))
+        if self._uri_to_prefix.get(uri) is None:
+            self._uri_to_prefix[uri] = prefix
+
+    def resolve(self, uri):
+        ''' Returns the prefix associated to the uri.
+
+        returns None if not found.
+        :param uri: string
+        :return: string
+        '''
+        return self._uri_to_prefix.get(uri)
+
+    def resolve_caveat(self, cav):
+        ''' Resolves the given caveat(string) by using resolve to map from its
+        schema namespace to the appropriate prefix.
+        If there is no registered prefix for the namespace, it returns an error
+        caveat.
+        If cav.namespace is empty or cav.location is non-empty, it returns cav
+        unchanged.
+
+        It does not mutate ns and may be called concurrently with other
+        non-mutating Namespace methods.
+        :return: Caveat object
+        '''
+        # TODO: If a namespace isn't registered, try to resolve it by
+        # resolving it to the latest compatible version that is
+        # registered.
+        if cav.namespace == '' or cav.location != '':
+            return cav
+
+        prefix = self.resolve(cav.namespace)
+        if prefix is None:
+            err_cav = error_caveat(
+                'caveat {} in unregistered namespace {}'.format(
+                    cav.condition, cav.namespace))
+            if err_cav.namespace != cav.namespace:
+                prefix = self.resolve(err_cav.namespace)
+                if prefix is None:
+                    prefix = ''
+            cav = err_cav
+        if prefix != '':
+            cav.condition = condition_with_prefix(prefix, cav.condition)
+        cav.namespace = ''
+        return cav
+
+
+def is_valid_schema_uri(uri):
+    '''Reports if uri is suitable for use as a namespace schema URI.
+
+    It must be non-empty and it must not contain white space.
+
+    :param uri string
+    :return bool
+    '''
+    if len(uri) <= 0:
+        return False
+    return uri.find(' ') == -1
+
+
+def is_valid_prefix(prefix):
+    '''Reports if prefix is valid.
+
+    It must not contain white space or semi-colon.
+    :param prefix string
+    :return bool
+    '''
+    return prefix.find(' ') == -1 and prefix.find(':') == -1
+
+
+def deserialize_namespace(data):
+    ''' Deserialize a Namespace object.
+
+    :param data: bytes or str
+    :return: namespace
+    '''
+    if isinstance(data, bytes):
+        data = data.decode('utf-8')
+    kvs = data.split()
+    uri_to_prefix = {}
+    for kv in kvs:
+        i = kv.rfind(':')
+        if i == -1:
+            raise ValueError('no colon in namespace '
+                             'field {}'.format(repr(kv)))
+        uri, prefix = kv[0:i], kv[i + 1:]
+        if not is_valid_schema_uri(uri):
+            # Currently this can't happen because the only invalid URIs
+            # are those which contain a space
+            raise ValueError(
+                'invalid URI {} in namespace '
+                'field {}'.format(repr(uri), repr(kv)))
+        if not is_valid_prefix(prefix):
+            raise ValueError(
+                'invalid prefix {} in namespace field'
+                ' {}'.format(repr(prefix), repr(kv)))
+        if uri in uri_to_prefix:
+            raise ValueError(
+                'duplicate URI {} in '
+                'namespace {}'.format(repr(uri), repr(data)))
+        uri_to_prefix[uri] = prefix
+    return Namespace(uri_to_prefix)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_operation.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_operation.py
new file mode 100644
index 0000000000000000000000000000000000000000..56b267a2930cba79cc2c321583308e8d21930713
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_operation.py
@@ -0,0 +1,17 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from ._auth_context import ContextKey
+
+OP_KEY = ContextKey('op-key')
+
+
+def context_with_operations(ctx, ops):
+    ''' Returns a context(AuthContext) which is associated with all the given
+    operations (list of string). It will be based on the auth context
+    passed in as ctx.
+
+    An allow caveat will succeed only if one of the allowed operations is in
+    ops; a deny caveat will succeed only if none of the denied operations are
+    in ops.
+    '''
+    return ctx.with_value(OP_KEY, ops)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_time.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_time.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ae1d894b2b6c40e6e3026d88c5000476c2cabfa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_time.py
@@ -0,0 +1,67 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+import pyrfc3339
+from ._auth_context import ContextKey
+from ._caveat import parse_caveat
+from ._conditions import COND_TIME_BEFORE, STD_NAMESPACE
+from ._utils import condition_with_prefix
+
+TIME_KEY = ContextKey('time-key')
+
+
+def context_with_clock(ctx, clock):
+    ''' Returns a copy of ctx with a key added that associates it with the
+    given clock implementation, which will be used by the time-before checker
+    to determine the current time.
+    The clock should have a utcnow method that returns the current time
+    as a datetime value in UTC.
+    '''
+    if clock is None:
+        return ctx
+    return ctx.with_value(TIME_KEY, clock)
+
+
+def macaroons_expiry_time(ns, ms):
+    ''' Returns the minimum time of any time-before caveats found in the given
+    macaroons or None if no such caveats were found.
+    :param ns: a Namespace, used to resolve caveats.
+    :param ms: a list of pymacaroons.Macaroon
+    :return: datetime.DateTime or None.
+    '''
+    t = None
+    for m in ms:
+        et = expiry_time(ns, m.caveats)
+        if et is not None and (t is None or et < t):
+            t = et
+    return t
+
+
+def expiry_time(ns, cavs):
+    ''' Returns the minimum time of any time-before caveats found
+    in the given list or None if no such caveats were found.
+
+    The ns parameter is
+    :param ns: used to determine the standard namespace prefix - if
+    the standard namespace is not found, the empty prefix is assumed.
+    :param cavs: a list of pymacaroons.Caveat
+    :return: datetime.DateTime or None.
+    '''
+    prefix = ns.resolve(STD_NAMESPACE)
+    time_before_cond = condition_with_prefix(
+        prefix, COND_TIME_BEFORE)
+    t = None
+    for cav in cavs:
+        if not cav.first_party():
+            continue
+        cav = cav.caveat_id_bytes.decode('utf-8')
+        name, rest = parse_caveat(cav)
+        if name != time_before_cond:
+            continue
+        try:
+            et = pyrfc3339.parse(rest, utc=True).replace(tzinfo=None)
+            if t is None or et < t:
+                t = et
+        except ValueError:
+            continue
+    return t
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..925e8c78684f3c6a1448ee7cd2c58d2a00951dda
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/checkers/_utils.py
@@ -0,0 +1,13 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+
+def condition_with_prefix(prefix, condition):
+    '''Returns the given string prefixed by the given prefix.
+
+    If the prefix is non-empty, a colon is used to separate them.
+    '''
+    if prefix == '' or prefix is None:
+        return condition
+
+    return prefix + ':' + condition
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..07a805b3f0637b0173e0bd49b5f0ad47c3633783
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/__init__.py
@@ -0,0 +1,55 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from ._client import (
+    BakeryException,
+    Client,
+    extract_macaroons,
+)
+from ._error import (
+    BAKERY_PROTOCOL_HEADER,
+    DischargeError,
+    ERR_DISCHARGE_REQUIRED,
+    ERR_INTERACTION_REQUIRED,
+    Error,
+    ErrorInfo,
+    InteractionError,
+    InteractionMethodNotFound,
+    discharge_required_response,
+    request_version,
+)
+from ._keyring import ThirdPartyLocator
+from ._interactor import (
+    DischargeToken,
+    Interactor,
+    LegacyInteractor,
+    WEB_BROWSER_INTERACTION_KIND,
+)
+from ._browser import (
+    WebBrowserInteractionInfo,
+    WebBrowserInteractor,
+)
+from ._discharge import discharge
+
+__all__ = [
+    'BAKERY_PROTOCOL_HEADER',
+    'BakeryException',
+    'Client',
+    'DischargeError',
+    'DischargeToken',
+    'ERR_DISCHARGE_REQUIRED',
+    'ERR_INTERACTION_REQUIRED',
+    'Error',
+    'ErrorInfo',
+    'InteractionError',
+    'InteractionMethodNotFound',
+    'Interactor',
+    'LegacyInteractor',
+    'ThirdPartyLocator',
+    'WEB_BROWSER_INTERACTION_KIND',
+    'WebBrowserInteractionInfo',
+    'WebBrowserInteractor',
+    'discharge',
+    'discharge_required_response',
+    'extract_macaroons',
+    'request_version',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_browser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_browser.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8a5586240f373438f4e66f26621808a7f588fb9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_browser.py
@@ -0,0 +1,90 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+from collections import namedtuple
+
+import requests
+from ._error import InteractionError
+from ._interactor import (
+    WEB_BROWSER_INTERACTION_KIND,
+    DischargeToken,
+    Interactor,
+    LegacyInteractor,
+)
+from macaroonbakery._utils import visit_page_with_browser
+
+from six.moves.urllib.parse import urljoin
+
+
+class WebBrowserInteractor(Interactor, LegacyInteractor):
+    ''' Handles web-browser-based interaction-required errors by opening a
+    web browser to allow the user to prove their credentials interactively.
+    '''
+    def __init__(self, open=visit_page_with_browser):
+        '''Create a WebBrowserInteractor that uses the given function
+        to open a browser window. The open function is expected to take
+        a single argument of string type, the URL to open.
+        '''
+        self._open_web_browser = open
+
+    def kind(self):
+        return WEB_BROWSER_INTERACTION_KIND
+
+    def legacy_interact(self, ctx, location, visit_url):
+        '''Implement LegacyInteractor.legacy_interact by opening the
+        web browser window'''
+        self._open_web_browser(visit_url)
+
+    def interact(self, ctx, location, ir_err):
+        '''Implement Interactor.interact by opening the browser window
+        and waiting for the discharge token'''
+        p = ir_err.interaction_method(self.kind(), WebBrowserInteractionInfo)
+        if not location.endswith('/'):
+            location += '/'
+        visit_url = urljoin(location, p.visit_url)
+        wait_token_url = urljoin(location, p.wait_token_url)
+        self._open_web_browser(visit_url)
+        return self._wait_for_token(ctx, wait_token_url)
+
+    def _wait_for_token(self, ctx, wait_token_url):
+        ''' Returns a token from a the wait token URL
+        @param wait_token_url URL to wait for (string)
+        :return DischargeToken
+        '''
+        resp = requests.get(wait_token_url)
+        if resp.status_code != 200:
+            raise InteractionError('cannot get {}'.format(wait_token_url))
+        json_resp = resp.json()
+        kind = json_resp.get('kind')
+        if kind is None:
+            raise InteractionError(
+                'cannot get kind token from {}'.format(wait_token_url))
+        token_val = json_resp.get('token')
+        if token_val is None:
+            token_val = json_resp.get('token64')
+            if token_val is None:
+                raise InteractionError(
+                    'cannot get token from {}'.format(wait_token_url))
+            token_val = base64.b64decode(token_val)
+        return DischargeToken(kind=kind, value=token_val)
+
+
+class WebBrowserInteractionInfo(namedtuple('WebBrowserInteractionInfo',
+                                           'visit_url, wait_token_url')):
+    ''' holds the information expected in the browser-window interaction
+    entry in an interaction-required error.
+
+    :param visit_url holds the URL to be visited in a web browser.
+    :param wait_token_url holds a URL that will block on GET until the browser
+    interaction has completed.
+    '''
+    @classmethod
+    def from_dict(cls, info_dict):
+        '''Create a new instance of WebBrowserInteractionInfo, as expected
+        by the Error.interaction_method method.
+        @param info_dict The deserialized JSON object
+        @return a new WebBrowserInteractionInfo object.
+        '''
+        return WebBrowserInteractionInfo(
+            visit_url=info_dict.get('VisitURL'),
+            wait_token_url=info_dict.get('WaitTokenURL'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_client.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_client.py
new file mode 100644
index 0000000000000000000000000000000000000000..326c33d09cbbb9b9246947edb02d95027d71f2ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_client.py
@@ -0,0 +1,402 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+import json
+import logging
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import macaroonbakery._utils as utils
+from ._browser import WebBrowserInteractor
+from ._error import (
+    BAKERY_PROTOCOL_HEADER,
+    ERR_DISCHARGE_REQUIRED,
+    ERR_INTERACTION_REQUIRED,
+    DischargeError,
+    Error,
+    InteractionError,
+    InteractionMethodNotFound,
+)
+from ._interactor import (
+    WEB_BROWSER_INTERACTION_KIND,
+    LegacyInteractor,
+)
+
+import requests
+from six.moves.http_cookies import SimpleCookie
+from six.moves.urllib.parse import urljoin
+
+TIME_OUT = 30
+MAX_DISCHARGE_RETRIES = 3
+
+log = logging.getLogger('httpbakery')
+
+
+class BakeryException(requests.RequestException):
+    '''Raised when some errors happen using the httpbakery
+    authorizer'''
+
+
+class Client:
+    '''Client holds the context for making HTTP requests with macaroons.
+    To make a request, use the auth method to obtain
+    an HTTP authorizer suitable for passing as the auth parameter
+    to a requests method. Note that the same cookie jar
+    should be passed to requests as is used to initialize
+    the client.
+    For example:
+        import macaroonbakery.httpbakery
+        client = httpbakery.Client()
+        resp = requests.get('some protected url',
+                            cookies=client.cookies,
+                            auth=client.auth())
+    @param interaction_methods A list of Interactor implementations.
+    @param key The private key of the client {bakery.PrivateKey}
+    @param cookies storage for the cookies {CookieJar}. It should be the
+    same as in the requests cookies. If not provided, one
+    will be created.
+    '''
+    def __init__(self, interaction_methods=None, key=None, cookies=None):
+        if interaction_methods is None:
+            interaction_methods = [WebBrowserInteractor()]
+        if cookies is None:
+            cookies = requests.cookies.RequestsCookieJar()
+        self._interaction_methods = interaction_methods
+        self.key = key
+        self.cookies = cookies
+
+    def auth(self):
+        '''Return an authorizer object suitable for passing
+        to requests methods that accept one.
+        If a request returns a discharge-required error,
+        the authorizer will acquire discharge macaroons
+        and retry the request.
+        '''
+        return _BakeryAuth(self)
+
+    def request(self, method, url, **kwargs):
+        '''Use the requests library to make a request.
+        Using this method is like doing:
+
+            requests.request(method, url, auth=client.auth())
+        '''
+        # TODO should we raise an exception if auth or cookies are explicitly
+        # mentioned in kwargs?
+        kwargs['auth'] = self.auth()
+        kwargs['cookies'] = self.cookies
+        return requests.request(method=method, url=url, **kwargs)
+
+    def handle_error(self, error, url):
+        '''Try to resolve the given error, which should be a response
+        to the given URL, by discharging any macaroon contained in
+        it. That is, if error.code is ERR_DISCHARGE_REQUIRED
+        then it will try to discharge err.info.macaroon. If the discharge
+        succeeds, the discharged macaroon will be saved to the client's cookie
+        jar, otherwise an exception will be raised.
+        '''
+        if error.info is None or error.info.macaroon is None:
+            raise BakeryException('unable to read info in discharge error '
+                                  'response')
+
+        discharges = bakery.discharge_all(
+            error.info.macaroon,
+            self.acquire_discharge,
+            self.key,
+        )
+        macaroons = '[' + ','.join(map(utils.macaroon_to_json_string,
+                                       discharges)) + ']'
+        all_macaroons = base64.urlsafe_b64encode(utils.to_bytes(macaroons))
+
+        full_path = urljoin(url, error.info.macaroon_path)
+        if error.info.cookie_name_suffix is not None:
+            name = 'macaroon-' + error.info.cookie_name_suffix
+        else:
+            name = 'macaroon-auth'
+        expires = checkers.macaroons_expiry_time(checkers.Namespace(), discharges)
+        self.cookies.set_cookie(utils.cookie(
+            name=name,
+            value=all_macaroons.decode('ascii'),
+            url=full_path,
+            expires=expires,
+        ))
+
+    def acquire_discharge(self, cav, payload):
+        ''' Request a discharge macaroon from the caveat location
+        as an HTTP URL.
+        @param cav Third party {pymacaroons.Caveat} to be discharged.
+        @param payload External caveat data {bytes}.
+        @return The acquired macaroon {macaroonbakery.Macaroon}
+        '''
+        resp = self._acquire_discharge_with_token(cav, payload, None)
+        # TODO Fabrice what is the other http response possible ??
+        if resp.status_code == 200:
+            return bakery.Macaroon.from_dict(resp.json().get('Macaroon'))
+        cause = Error.from_dict(resp.json())
+        if cause.code != ERR_INTERACTION_REQUIRED:
+            raise DischargeError(cause.message)
+        if cause.info is None:
+            raise DischargeError(
+                'interaction-required response with no info: {}'.format(
+                    resp.json())
+            )
+        loc = cav.location
+        if not loc.endswith('/'):
+            loc = loc + '/'
+        token, m = self._interact(loc, cause, payload)
+        if m is not None:
+            # We've acquired the macaroon directly via legacy interaction.
+            return m
+        # Try to acquire the discharge again, but this time with
+        # the token acquired by the interaction method.
+        resp = self._acquire_discharge_with_token(cav, payload, token)
+        if resp.status_code == 200:
+            return bakery.Macaroon.from_dict(resp.json().get('Macaroon'))
+        else:
+            raise DischargeError(
+                'discharge failed with code {}'.format(resp.status_code))
+
+    def _acquire_discharge_with_token(self, cav, payload, token):
+        req = {}
+        _add_json_binary_field(cav.caveat_id_bytes, req, 'id')
+        if token is not None:
+            _add_json_binary_field(token.value, req, 'token')
+            req['token-kind'] = token.kind
+        if payload is not None:
+            req['caveat64'] = base64.urlsafe_b64encode(payload).rstrip(
+                b'=').decode('utf-8')
+        loc = cav.location
+        if not loc.endswith('/'):
+            loc += '/'
+        target = urljoin(loc, 'discharge')
+        headers = {
+            BAKERY_PROTOCOL_HEADER: str(bakery.LATEST_VERSION)
+        }
+        return self.request('POST', target, data=req, headers=headers)
+
+    def _interact(self, location, error_info, payload):
+        '''Gathers a macaroon by directing the user to interact with a
+        web page. The error_info argument holds the interaction-required
+        error response.
+        @return DischargeToken, bakery.Macaroon
+        '''
+        if (self._interaction_methods is None or
+                len(self._interaction_methods) == 0):
+            raise InteractionError('interaction required but not possible')
+        # TODO(rogpeppe) make the robust against a wider range of error info.
+        if error_info.info.interaction_methods is None and \
+                error_info.info.visit_url is not None:
+            # It's an old-style error; deal with it differently.
+            return None, self._legacy_interact(location, error_info)
+        for interactor in self._interaction_methods:
+            found = error_info.info.interaction_methods.get(interactor.kind())
+            if found is None:
+                continue
+            try:
+                token = interactor.interact(self, location, error_info)
+            except InteractionMethodNotFound:
+                continue
+            if token is None:
+                raise InteractionError('interaction method returned an empty '
+                                       'token')
+            return token, None
+
+        raise InteractionError('no supported interaction method')
+
+    def _legacy_interact(self, location, error_info):
+        visit_url = urljoin(location, error_info.info.visit_url)
+        wait_url = urljoin(location, error_info.info.wait_url)
+        method_urls = {
+            "interactive": visit_url
+        }
+        if (len(self._interaction_methods) > 1 or
+                self._interaction_methods[0].kind() !=
+                WEB_BROWSER_INTERACTION_KIND):
+            # We have several possible methods or we only support a non-window
+            # method, so we need to fetch the possible methods supported by
+            # the discharger.
+            method_urls = _legacy_get_interaction_methods(visit_url)
+        for interactor in self._interaction_methods:
+            kind = interactor.kind()
+            if kind == WEB_BROWSER_INTERACTION_KIND:
+                # This is the old name for browser-window interaction.
+                kind = "interactive"
+
+            if not isinstance(interactor, LegacyInteractor):
+                # Legacy interaction mode isn't supported.
+                continue
+
+            visit_url = method_urls.get(kind)
+            if visit_url is None:
+                continue
+
+            visit_url = urljoin(location, visit_url)
+            interactor.legacy_interact(self, location, visit_url)
+            return _wait_for_macaroon(wait_url)
+
+        raise InteractionError('no methods supported; supported [{}]; provided [{}]'.format(
+            ' '.join([x.kind() for x in self._interaction_methods]),
+            ' '.join(method_urls.keys()),
+        ))
+
+
+class _BakeryAuth:
+    '''_BakeryAuth implements an authorizer as required
+    by the requests HTTP client.
+    '''
+    def __init__(self, client):
+        '''
+        @param interaction_methods A list of Interactor implementations.
+        @param key The private key of the client (macaroonbakery.PrivateKey)
+        @param cookies storage for the cookies {CookieJar}. It should be the
+        same as in the requests cookies.
+        '''
+        self._client = client
+
+    def __call__(self, req):
+        req.headers[BAKERY_PROTOCOL_HEADER] = str(bakery.LATEST_VERSION)
+        hook = _prepare_discharge_hook(req.copy(), self._client)
+        req.register_hook(event='response', hook=hook)
+        return req
+
+
+def _prepare_discharge_hook(req, client):
+    ''' Return the hook function (called when the response is received.)
+
+    This allows us to intercept the response and do any necessary
+    macaroon discharge before returning.
+    '''
+    class Retry:
+        # Define a local class so that we can use its class variable as
+        # mutable state accessed by the closures below.
+        count = 0
+
+    def hook(response, *args, **kwargs):
+        ''' Requests hooks system, this is the hook for the response.
+        '''
+        status_code = response.status_code
+
+        if status_code != 407 and status_code != 401:
+            return response
+        if (status_code == 401 and response.headers.get('WWW-Authenticate') !=
+                'Macaroon'):
+            return response
+
+        if response.headers.get('Content-Type') != 'application/json':
+            return response
+        errorJSON = response.json()
+        if errorJSON.get('Code') != ERR_DISCHARGE_REQUIRED:
+            return response
+        error = Error.from_dict(errorJSON)
+        Retry.count += 1
+        if Retry.count >= MAX_DISCHARGE_RETRIES:
+            raise BakeryException('too many ({}) discharge requests'.format(
+                Retry.count)
+            )
+        client.handle_error(error, req.url)
+        req.headers.pop('Cookie', None)
+        req.prepare_cookies(client.cookies)
+        req.headers[BAKERY_PROTOCOL_HEADER] = \
+            str(bakery.LATEST_VERSION)
+        with requests.Session() as s:
+            settings = s.merge_environment_settings(
+                req.url, {}, None, None, None)
+            return s.send(req, **settings)
+    return hook
+
+
+def extract_macaroons(headers_or_request):
+    ''' Returns an array of any macaroons found in the given slice of cookies.
+    If the argument implements a get_header method, that will be used
+    instead of the get method to retrieve headers.
+    @param headers_or_request: dict of headers or a
+    urllib.request.Request-like object.
+    @return: A list of list of mpy macaroons
+    '''
+    def get_header(key, default=None):
+        try:
+            return headers_or_request.get_header(key, default)
+        except AttributeError:
+            return headers_or_request.get(key, default)
+
+    mss = []
+
+    def add_macaroon(data):
+        try:
+            data = utils.b64decode(data)
+            data_as_objs = json.loads(data.decode('utf-8'))
+        except ValueError:
+            return
+        ms = [utils.macaroon_from_dict(x) for x in data_as_objs]
+        mss.append(ms)
+
+    cookie_header = get_header('Cookie')
+    if cookie_header is not None:
+        cs = SimpleCookie()
+        # The cookie might be a unicode object, so convert it
+        # to ASCII. This may cause an exception under Python 2.
+        # TODO is that a problem?
+        cs.load(str(cookie_header))
+        for c in cs:
+            if c.startswith('macaroon-'):
+                add_macaroon(cs[c].value)
+    # Python doesn't make it easy to have multiple values for a
+    # key, so split the header instead, which is necessary
+    # for HTTP1.1 compatibility anyway (see RFC 7230, section 3.2.2)
+    macaroon_header = get_header('Macaroons')
+    if macaroon_header is not None:
+        for h in macaroon_header.split(','):
+            add_macaroon(h)
+    return mss
+
+
+def _add_json_binary_field(b, serialized, field):
+    '''' Set the given field to the given val (bytes) in the serialized
+    dictionary.
+    If the value isn't valid utf-8, we base64 encode it and use field+"64"
+    as the field name.
+    '''
+    try:
+        val = b.decode('utf-8')
+        serialized[field] = val
+    except UnicodeDecodeError:
+        val = base64.b64encode(b).decode('utf-8')
+        serialized[field + '64'] = val
+
+
+def _wait_for_macaroon(wait_url):
+    ''' Returns a macaroon from a legacy wait endpoint.
+    '''
+    headers = {
+        BAKERY_PROTOCOL_HEADER: str(bakery.LATEST_VERSION)
+    }
+    resp = requests.get(url=wait_url, headers=headers)
+    if resp.status_code != 200:
+        raise InteractionError('cannot get {}'.format(wait_url))
+
+    return bakery.Macaroon.from_dict(resp.json().get('Macaroon'))
+
+
+def _legacy_get_interaction_methods(u):
+    ''' Queries a URL as found in an ErrInteractionRequired VisitURL field to
+    find available interaction methods.
+    It does this by sending a GET request to the URL with the Accept
+    header set to "application/json" and parsing the resulting
+    response as a dict.
+    '''
+    headers = {
+        BAKERY_PROTOCOL_HEADER: str(bakery.LATEST_VERSION),
+        'Accept': 'application/json'
+    }
+    resp = requests.get(url=u, headers=headers)
+    method_urls = {}
+    if resp.status_code == 200:
+        json_resp = resp.json()
+        for m in json_resp:
+            method_urls[m] = urljoin(u, json_resp[m])
+
+    if method_urls.get('interactive') is None:
+        # There's no "interactive" method returned, but we know
+        # the server does actually support it, because all dischargers
+        # are required to, so fill it in with the original URL.
+        method_urls['interactive'] = u
+    return method_urls
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_discharge.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_discharge.py
new file mode 100644
index 0000000000000000000000000000000000000000..1873850bf47d13c495c9a714efd7222d304d6103
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_discharge.py
@@ -0,0 +1,37 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import macaroonbakery.bakery as bakery
+import macaroonbakery._utils as utils
+
+
+def discharge(ctx, content, key, locator, checker):
+    '''Handles a discharge request as received by the /discharge
+    endpoint.
+    @param ctx The context passed to the checker {checkers.AuthContext}
+    @param content URL and form parameters {dict}
+    @param locator Locator used to add third party caveats returned by
+    the checker {macaroonbakery.ThirdPartyLocator}
+    @param checker {macaroonbakery.ThirdPartyCaveatChecker} Used to check third
+    party caveats.
+    @return The discharge macaroon {macaroonbakery.Macaroon}
+    '''
+    id = content.get('id')
+    if id is not None:
+        id = id.encode('utf-8')
+    else:
+        id = content.get('id64')
+        if id is not None:
+            id = utils.b64decode(id)
+
+    caveat = content.get('caveat64')
+    if caveat is not None:
+        caveat = utils.b64decode(caveat)
+
+    return bakery.discharge(
+        ctx,
+        id=id,
+        caveat=caveat,
+        key=key,
+        checker=checker,
+        locator=locator,
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_error.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_error.py
new file mode 100644
index 0000000000000000000000000000000000000000..0ef7e7b7edd12b421360f51ec62e0268f017c00a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_error.py
@@ -0,0 +1,207 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import json
+from collections import namedtuple
+
+import macaroonbakery.bakery as bakery
+
+ERR_INTERACTION_REQUIRED = 'interaction required'
+ERR_DISCHARGE_REQUIRED = 'macaroon discharge required'
+
+
+class InteractionMethodNotFound(Exception):
+    '''This is thrown by client-side interaction methods when
+    they find that a given interaction isn't supported by the
+    client for a location'''
+    pass
+
+
+class DischargeError(Exception):
+    '''This is thrown by Client when a third party has refused a discharge'''
+    def __init__(self, msg):
+        super(DischargeError, self).__init__(
+            'third party refused dischargex: {}'.format(msg))
+
+
+class InteractionError(Exception):
+    '''This is thrown by Client when it fails to deal with an
+    interaction-required error
+    '''
+    def __init__(self, msg):
+        super(InteractionError, self).__init__(
+            'cannot start interactive session: {}'.format(msg))
+
+
+def discharge_required_response(macaroon, path, cookie_suffix_name,
+                                message=None):
+    ''' Get response content and headers from a discharge macaroons error.
+
+    @param macaroon may hold a macaroon that, when discharged, may
+    allow access to a service.
+    @param path holds the URL path to be associated with the macaroon.
+    The macaroon is potentially valid for all URLs under the given path.
+    @param cookie_suffix_name holds the desired cookie name suffix to be
+    associated with the macaroon. The actual name used will be
+    ("macaroon-" + CookieName). Clients may ignore this field -
+    older clients will always use ("macaroon-" + macaroon.signature() in hex)
+    @return content(bytes) and the headers to set on the response(dict).
+    '''
+    if message is None:
+        message = 'discharge required'
+    content = json.dumps(
+        {
+            'Code': 'macaroon discharge required',
+            'Message': message,
+            'Info': {
+                'Macaroon': macaroon.to_dict(),
+                'MacaroonPath': path,
+                'CookieNameSuffix': cookie_suffix_name
+            },
+        }
+    ).encode('utf-8')
+    return content, {
+        'WWW-Authenticate': 'Macaroon',
+        'Content-Type': 'application/json'
+    }
+
+# BAKERY_PROTOCOL_HEADER is the header that HTTP clients should set
+# to determine the bakery protocol version. If it is 0 or missing,
+# a discharge-required error response will be returned with HTTP status 407;
+# if it is greater than 0, the response will have status 401 with the
+# WWW-Authenticate header set to "Macaroon".
+BAKERY_PROTOCOL_HEADER = 'Bakery-Protocol-Version'
+
+
+def request_version(req_headers):
+    ''' Determines the bakery protocol version from a client request.
+    If the protocol cannot be determined, or is invalid, the original version
+    of the protocol is used. If a later version is found, the latest known
+    version is used, which is OK because versions are backwardly compatible.
+
+    @param req_headers: the request headers as a dict.
+    @return: bakery protocol version (for example macaroonbakery.VERSION_1)
+    '''
+    vs = req_headers.get(BAKERY_PROTOCOL_HEADER)
+    if vs is None:
+        # No header - use backward compatibility mode.
+        return bakery.VERSION_1
+    try:
+        x = int(vs)
+    except ValueError:
+        # Badly formed header - use backward compatibility mode.
+        return bakery.VERSION_1
+    if x > bakery.LATEST_VERSION:
+        # Later version than we know about - use the
+        # latest version that we can.
+        return bakery.LATEST_VERSION
+    return x
+
+
+class Error(namedtuple('Error', 'code, message, version, info')):
+    '''This class defines an error value as returned from
+    an httpbakery API.
+    '''
+    @classmethod
+    def from_dict(cls, serialized):
+        '''Create an error from a JSON-deserialized object
+        @param serialized the object holding the serialized error {dict}
+        '''
+        # Some servers return lower case field names for message and code.
+        # The Go client is tolerant of this, so be similarly tolerant here.
+        def field(name):
+            return serialized.get(name) or serialized.get(name.lower())
+        return Error(
+            code=field('Code'),
+            message=field('Message'),
+            info=ErrorInfo.from_dict(field('Info')),
+            version=bakery.LATEST_VERSION,
+        )
+
+    def interaction_method(self, kind, x):
+        ''' Checks whether the error is an InteractionRequired error
+        that implements the method with the given name, and JSON-unmarshals the
+        method-specific data into x by calling its from_dict method
+        with the deserialized JSON object.
+        @param kind The interaction method kind (string).
+        @param x A class with a class method from_dict that returns a new
+        instance of the interaction info for the given kind.
+        @return The result of x.from_dict.
+        '''
+        if self.info is None or self.code != ERR_INTERACTION_REQUIRED:
+            raise InteractionError(
+                'not an interaction-required error (code {})'.format(
+                    self.code)
+            )
+        entry = self.info.interaction_methods.get(kind)
+        if entry is None:
+            raise InteractionMethodNotFound(
+                'interaction method {} not found'.format(kind)
+            )
+        return x.from_dict(entry)
+
+
+class ErrorInfo(
+    namedtuple('ErrorInfo', 'macaroon, macaroon_path, cookie_name_suffix, '
+                            'interaction_methods, visit_url, wait_url')):
+    '''  Holds additional information provided
+    by an error.
+
+    @param macaroon may hold a macaroon that, when
+    discharged, may allow access to a service.
+    This field is associated with the ERR_DISCHARGE_REQUIRED
+    error code.
+
+    @param macaroon_path holds the URL path to be associated
+    with the macaroon. The macaroon is potentially
+    valid for all URLs under the given path.
+    If it is empty, the macaroon will be associated with
+    the original URL from which the error was returned.
+
+    @param cookie_name_suffix holds the desired cookie name suffix to be
+    associated with the macaroon. The actual name used will be
+    ("macaroon-" + cookie_name_suffix). Clients may ignore this field -
+    older clients will always use ("macaroon-" +
+    macaroon.signature() in hex).
+
+    @param visit_url holds a URL that the client should visit
+    in a web browser to authenticate themselves.
+
+    @param wait_url holds a URL that the client should visit
+    to acquire the discharge macaroon. A GET on
+    this URL will block until the client has authenticated,
+    and then it will return the discharge macaroon.
+    '''
+
+    __slots__ = ()
+
+    @classmethod
+    def from_dict(cls, serialized):
+        '''Create a new ErrorInfo object from a JSON deserialized
+        dictionary
+        @param serialized The JSON object {dict}
+        @return ErrorInfo object
+        '''
+        if serialized is None:
+            return None
+        macaroon = serialized.get('Macaroon')
+        if macaroon is not None:
+            macaroon = bakery.Macaroon.from_dict(macaroon)
+        path = serialized.get('MacaroonPath')
+        cookie_name_suffix = serialized.get('CookieNameSuffix')
+        visit_url = serialized.get('VisitURL')
+        wait_url = serialized.get('WaitURL')
+        interaction_methods = serialized.get('InteractionMethods')
+        return ErrorInfo(macaroon=macaroon, macaroon_path=path,
+                         cookie_name_suffix=cookie_name_suffix,
+                         visit_url=visit_url, wait_url=wait_url,
+                         interaction_methods=interaction_methods)
+
+    def __new__(cls, macaroon=None, macaroon_path=None,
+                cookie_name_suffix=None, interaction_methods=None,
+                visit_url=None, wait_url=None):
+        '''Override the __new__ method so that we can
+        have optional arguments, which namedtuple doesn't
+        allow'''
+        return super(ErrorInfo, cls).__new__(
+            cls, macaroon, macaroon_path, cookie_name_suffix,
+            interaction_methods, visit_url, wait_url)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_interactor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_interactor.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fba4ef5649d40ca89d7560a80a28c6d5fc322be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_interactor.py
@@ -0,0 +1,70 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import abc
+from collections import namedtuple
+
+WEB_BROWSER_INTERACTION_KIND = 'browser-window'
+
+
+class Interactor(object):
+    ''' Represents a way of persuading a discharger that it should grant a
+    discharge macaroon.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def kind(self):
+        '''Returns the interaction method name. This corresponds to the key in
+        the Error.interaction_methods type.
+        @return {str}
+        '''
+        raise NotImplementedError('kind method must be defined in subclass')
+
+    def interact(self, client, location, interaction_required_err):
+        ''' Performs the interaction, and returns a token that can be
+        used to acquire the discharge macaroon. The location provides
+        the third party caveat location to make it possible to use
+        relative URLs. The client holds the client being used to do the current
+        request.
+
+        If the given interaction isn't supported by the client for
+        the given location, it may raise an InteractionMethodNotFound
+        which will cause the interactor to be ignored that time.
+        @param client The client being used for the current request {Client}
+        @param location Third party caveat location {str}
+        @param interaction_required_err The error causing the interaction to
+        take place {Error}
+        @return {DischargeToken} The discharge token.
+        '''
+        raise NotImplementedError('interact method must be defined in subclass')
+
+
+class LegacyInteractor(object):
+    ''' May optionally be implemented by Interactor implementations that
+    implement the legacy interaction-required error protocols.
+    '''
+    __metaclass__ = abc.ABCMeta
+
+    @abc.abstractmethod
+    def legacy_interact(self, client, location, visit_url):
+        ''' Implements the "visit" half of a legacy discharge
+        interaction. The "wait" half will be implemented by httpbakery.
+        The location is the location specified by the third party
+        caveat. The client holds the client being used to do the current
+        request.
+        @param client The client being used for the current request {Client}
+        @param location Third party caveat location {str}
+        @param visit_url The visit_url field from the error {str}
+        @return None
+        '''
+        raise NotImplementedError('legacy_interact method must be defined in subclass')
+
+
+class DischargeToken(namedtuple('DischargeToken', 'kind, value')):
+    ''' Holds a token that is intended to persuade a discharger to discharge
+    a third party caveat.
+    @param kind holds the kind of the token. By convention this
+    matches the name of the interaction method used to
+    obtain the token, but that's not required {str}
+    @param value holds the token data. {bytes}
+    '''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_keyring.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_keyring.py
new file mode 100644
index 0000000000000000000000000000000000000000..8d9ab43e20fe4967ed10a90cbf9e480a163911a9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/_keyring.py
@@ -0,0 +1,60 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import macaroonbakery.bakery as bakery
+import requests
+from ._error import BAKERY_PROTOCOL_HEADER
+
+from six.moves.urllib.parse import urlparse
+
+
+class ThirdPartyLocator(bakery.ThirdPartyLocator):
+    ''' Implements macaroonbakery.ThirdPartyLocator by first looking in the
+    backing cache and, if that fails, making an HTTP request to find the
+    information associated with the given discharge location.
+    '''
+
+    def __init__(self, allow_insecure=False):
+        '''
+        @param url: the url to retrieve public_key
+        @param allow_insecure: By default it refuses to use insecure URLs.
+        '''
+        self._allow_insecure = allow_insecure
+        self._cache = {}
+
+    def third_party_info(self, loc):
+        u = urlparse(loc)
+        if u.scheme != 'https' and not self._allow_insecure:
+            raise bakery.ThirdPartyInfoNotFound(
+                'untrusted discharge URL {}'.format(loc))
+        loc = loc.rstrip('/')
+        info = self._cache.get(loc)
+        if info is not None:
+            return info
+        url_endpoint = '/discharge/info'
+        headers = {
+            BAKERY_PROTOCOL_HEADER: str(bakery.LATEST_VERSION)
+        }
+        resp = requests.get(url=loc + url_endpoint, headers=headers)
+        status_code = resp.status_code
+        if status_code == 404:
+            url_endpoint = '/publickey'
+            resp = requests.get(url=loc + url_endpoint, headers=headers)
+            status_code = resp.status_code
+        if status_code != 200:
+            raise bakery.ThirdPartyInfoNotFound(
+                'unable to get info from {}'.format(url_endpoint))
+        json_resp = resp.json()
+        if json_resp is None:
+            raise bakery.ThirdPartyInfoNotFound(
+                'no response from /discharge/info')
+        pk = json_resp.get('PublicKey')
+        if pk is None:
+            raise bakery.ThirdPartyInfoNotFound(
+                'no public key found in /discharge/info')
+        idm_pk = bakery.PublicKey.deserialize(pk)
+        version = json_resp.get('Version', bakery.VERSION_1)
+        self._cache[loc] = bakery.ThirdPartyInfo(
+            version=version,
+            public_key=idm_pk
+        )
+        return self._cache.get(loc)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c0a752310c09b9e454c0752957db039bcbed4e68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/__init__.py
@@ -0,0 +1,19 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+from ._agent import (
+    load_auth_info,
+    read_auth_info,
+    Agent,
+    AgentInteractor,
+    AgentFileFormatError,
+    AuthInfo,
+)
+__all__ = [
+    'Agent',
+    'AgentFileFormatError',
+    'AgentInteractor',
+    'AuthInfo',
+    'load_auth_info',
+    'read_auth_info',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/_agent.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/_agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..618097cb30bab37f88470f98873f5fdb5a53ee08
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/httpbakery/agent/_agent.py
@@ -0,0 +1,185 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import copy
+import json
+import logging
+from collections import namedtuple
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.httpbakery as httpbakery
+import macaroonbakery._utils as utils
+import requests.cookies
+
+from six.moves.urllib.parse import urljoin
+
+log = logging.getLogger(__name__)
+
+
+class AgentFileFormatError(Exception):
+    ''' AgentFileFormatError is the exception raised when an agent file has a
+        bad structure.
+    '''
+    pass
+
+
+def load_auth_info(filename):
+    '''Loads agent authentication information from the specified file.
+    The returned information is suitable for passing as an argument
+    to the AgentInteractor constructor.
+    @param filename The name of the file to open (str)
+    @return AuthInfo The authentication information
+    @raises AgentFileFormatError when the file format is bad.
+    '''
+    with open(filename) as f:
+        return read_auth_info(f.read())
+
+
+def read_auth_info(agent_file_content):
+    '''Loads agent authentication information from the
+    specified content string, as read from an agents file.
+    The returned information is suitable for passing as an argument
+    to the AgentInteractor constructor.
+    @param agent_file_content The agent file content (str)
+    @return AuthInfo The authentication information
+    @raises AgentFileFormatError when the file format is bad.
+    '''
+    try:
+        data = json.loads(agent_file_content)
+        return AuthInfo(
+            key=bakery.PrivateKey.deserialize(data['key']['private']),
+            agents=list(
+                Agent(url=a['url'], username=a['username'])
+                for a in data.get('agents', [])
+            ),
+        )
+    except (
+        KeyError,
+        ValueError,
+        TypeError,
+    ) as e:
+        raise AgentFileFormatError('invalid agent file', e)
+
+
+class InteractionInfo(object):
+    '''Holds the information expected in the agent interaction entry in an
+    interaction-required error.
+    '''
+    def __init__(self, login_url):
+        self._login_url = login_url
+
+    @property
+    def login_url(self):
+        ''' Return the URL from which to acquire a macaroon that can be used
+        to complete the agent login. To acquire the macaroon, make a POST
+        request to the URL with user and public-key parameters.
+        :return string
+        '''
+        return self._login_url
+
+    @classmethod
+    def from_dict(cls, json_dict):
+        '''Return an InteractionInfo obtained from the given dictionary as
+        deserialized from JSON.
+        @param json_dict The deserialized JSON object.
+        '''
+        return InteractionInfo(json_dict.get('login-url'))
+
+
+class AgentInteractor(httpbakery.Interactor, httpbakery.LegacyInteractor):
+    ''' Interactor that performs interaction using the agent login protocol.
+    '''
+    def __init__(self, auth_info):
+        self._auth_info = auth_info
+
+    def kind(self):
+        '''Implement Interactor.kind by returning the agent kind'''
+        return 'agent'
+
+    def interact(self, client, location, interaction_required_err):
+        '''Implement Interactor.interact by obtaining obtaining
+        a macaroon from the discharger, discharging it with the
+        local private key using the discharged macaroon as
+        a discharge token'''
+        p = interaction_required_err.interaction_method('agent',
+                                                        InteractionInfo)
+        if p.login_url is None or p.login_url == '':
+            raise httpbakery.InteractionError(
+                'no login-url field found in agent interaction method')
+        agent = self._find_agent(location)
+        if not location.endswith('/'):
+            location += '/'
+        login_url = urljoin(location, p.login_url)
+        resp = requests.get(
+            login_url, params={
+                'username': agent.username,
+                'public-key': str(self._auth_info.key.public_key)},
+            auth=client.auth())
+        if resp.status_code != 200:
+            raise httpbakery.InteractionError(
+                'cannot acquire agent macaroon: {} {}'.format(
+                    resp.status_code, resp.text)
+            )
+        m = resp.json().get('macaroon')
+        if m is None:
+            raise httpbakery.InteractionError('no macaroon in response')
+        m = bakery.Macaroon.from_dict(m)
+        ms = bakery.discharge_all(m, None, self._auth_info.key)
+        b = bytearray()
+        for m in ms:
+            b.extend(utils.b64decode(m.serialize()))
+        return httpbakery.DischargeToken(kind='agent', value=bytes(b))
+
+    def _find_agent(self, location):
+        ''' Finds an appropriate agent entry for the given location.
+        :return Agent
+        '''
+        for a in self._auth_info.agents:
+            # Don't worry about trailing slashes
+            if a.url.rstrip('/') == location.rstrip('/'):
+                return a
+        raise httpbakery.InteractionMethodNotFound(
+            'cannot find username for discharge location {}'.format(location))
+
+    def legacy_interact(self, client, location, visit_url):
+        '''Implement LegacyInteractor.legacy_interact by obtaining
+        the discharge macaroon using the client's private key
+        '''
+        agent = self._find_agent(location)
+        # Shallow-copy the client so that we don't unexpectedly side-effect
+        # it by changing the key. Another possibility might be to
+        # set up agent authentication differently, in such a way that
+        # we're sure that client.key is the same as self._auth_info.key.
+        client = copy.copy(client)
+        client.key = self._auth_info.key
+        resp = client.request(
+            method='POST',
+            url=visit_url,
+            json={
+                'username': agent.username,
+                'public_key': str(self._auth_info.key.public_key),
+            },
+        )
+        if resp.status_code != 200:
+            raise httpbakery.InteractionError(
+                'cannot acquire agent macaroon from {}: {} (response body: {!r})'.format(visit_url, resp.status_code, resp.text))
+        if not resp.json().get('agent_login', False):
+            raise httpbakery.InteractionError('agent login failed')
+
+
+class Agent(namedtuple('Agent', 'url, username')):
+    ''' Represents an agent that can be used for agent authentication.
+    @param url(string) holds the URL of the discharger that knows about
+    the agent.
+    @param username holds the username agent (string).
+    '''
+
+
+class AuthInfo(namedtuple('AuthInfo', 'key, agents')):
+    ''' Holds the agent information required to set up agent authentication
+    information.
+
+    It holds the agent's private key and information about the username
+    associated with each known agent-authentication server.
+    @param key the agent's private key (bakery.PrivateKey).
+    @param agents information about the known agents (list of Agent).
+    '''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..46812ee3bdef976af898f29d2c99337fc3788ea0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/__init__.py
@@ -0,0 +1,2 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/common.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/common.py
new file mode 100644
index 0000000000000000000000000000000000000000..aacdaf35d3ded866686c3727a368f16663ca1b37
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/common.py
@@ -0,0 +1,119 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from datetime import datetime, timedelta
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+
+
+class _StoppedClock(object):
+    def __init__(self, t):
+        self.t = t
+
+    def utcnow(self):
+        return self.t
+
+
+epoch = datetime(year=1900, month=11, day=17, hour=19, minute=00, second=13)
+ages = epoch + timedelta(days=1)
+
+test_context = checkers.context_with_clock(checkers.AuthContext(),
+                                           _StoppedClock(epoch))
+
+
+def test_checker():
+    c = checkers.Checker()
+    c.namespace().register('testns', '')
+    c.register('str', 'testns', str_check)
+    c.register('true', 'testns', true_check)
+    return c
+
+
+_str_key = checkers.ContextKey('str_check')
+
+
+def str_context(s):
+    return test_context.with_value(_str_key, s)
+
+
+def str_check(ctx, cond, args):
+    expect = ctx[_str_key]
+    if args != expect:
+        return '{} doesn\'t match {}'.format(cond, expect)
+    return None
+
+
+def true_check(ctx, cond, args):
+    # Always succeeds.
+    return None
+
+
+class OneIdentity(bakery.IdentityClient):
+    '''An IdentityClient implementation that always returns a single identity
+    from declared_identity, allowing allow(LOGIN_OP) to work even when there
+    are no declaration caveats (this is mostly to support the legacy tests
+    which do their own checking of declaration caveats).
+    '''
+
+    def identity_from_context(self, ctx):
+        return None, None
+
+    def declared_identity(self, ctx, declared):
+        return _NoOne()
+
+
+class _NoOne(object):
+    def id(self):
+        return 'noone'
+
+    def domain(self):
+        return ''
+
+
+class ThirdPartyStrcmpChecker(bakery.ThirdPartyCaveatChecker):
+    def __init__(self, str):
+        self.str = str
+
+    def check_third_party_caveat(self, ctx, cav_info):
+        condition = cav_info.condition
+        if isinstance(cav_info.condition, bytes):
+            condition = cav_info.condition.decode('utf-8')
+        if condition != self.str:
+            raise bakery.ThirdPartyCaveatCheckFailed(
+                '{} doesn\'t match {}'.format(repr(condition), repr(self.str)))
+        return []
+
+
+class ThirdPartyCheckerWithCaveats(bakery.ThirdPartyCaveatChecker):
+    def __init__(self, cavs=None):
+        if cavs is None:
+            cavs = []
+        self.cavs = cavs
+
+    def check_third_party_caveat(self, ctx, cav_info):
+        return self.cavs
+
+
+class ThirdPartyCaveatCheckerEmpty(bakery.ThirdPartyCaveatChecker):
+    def check_third_party_caveat(self, ctx, cav_info):
+        return []
+
+
+def new_bakery(location, locator=None):
+    # Returns a new Bakery instance using a new
+    # key pair, and registers the key with the given locator if provided.
+    #
+    # It uses test_checker to check first party caveats.
+    key = bakery.generate_key()
+    if locator is not None:
+        locator.add_info(location,
+                         bakery.ThirdPartyInfo(
+                             public_key=key.public_key,
+                             version=bakery.LATEST_VERSION))
+    return bakery.Bakery(
+        key=key,
+        checker=test_checker(),
+        location=location,
+        identity_client=OneIdentity(),
+        locator=locator,
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_agent.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..d670485b69b71991f4c40392a1a78a7de11a04a1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_agent.py
@@ -0,0 +1,419 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import json
+import logging
+import os
+import tempfile
+from datetime import datetime, timedelta
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import macaroonbakery.httpbakery as httpbakery
+import macaroonbakery.httpbakery.agent as agent
+import requests.cookies
+
+from httmock import HTTMock, response, urlmatch
+from six.moves.urllib.parse import parse_qs, urlparse
+
+log = logging.getLogger(__name__)
+
+PRIVATE_KEY = 'CqoSgj06Zcgb4/S6RT4DpTjLAfKoznEY3JsShSjKJEU='
+PUBLIC_KEY = 'YAhRSsth3a36mRYqQGQaLiS4QJax0p356nd+B8x7UQE='
+
+
+class TestAgents(TestCase):
+    def setUp(self):
+        fd, filename = tempfile.mkstemp()
+        with os.fdopen(fd, 'w') as f:
+            f.write(agent_file)
+        self.agent_filename = filename
+        fd, filename = tempfile.mkstemp()
+        with os.fdopen(fd, 'w') as f:
+            f.write(bad_key_agent_file)
+        self.bad_key_agent_filename = filename
+        fd, filename = tempfile.mkstemp()
+        with os.fdopen(fd, 'w') as f:
+            f.write(no_username_agent_file)
+        self.no_username_agent_filename = filename
+
+    def tearDown(self):
+        os.remove(self.agent_filename)
+        os.remove(self.bad_key_agent_filename)
+        os.remove(self.no_username_agent_filename)
+
+    def test_load_auth_info(self):
+        auth_info = agent.load_auth_info(self.agent_filename)
+        self.assertEqual(str(auth_info.key), PRIVATE_KEY)
+        self.assertEqual(str(auth_info.key.public_key), PUBLIC_KEY)
+        self.assertEqual(auth_info.agents, [
+            agent.Agent(url='https://1.example.com/', username='user-1'),
+            agent.Agent(url='https://2.example.com/discharger', username='user-2'),
+            agent.Agent(url='http://0.3.2.1', username='test-user'),
+        ])
+
+    def test_invalid_agent_json(self):
+        with self.assertRaises(agent.AgentFileFormatError):
+            agent.read_auth_info('}')
+
+    def test_invalid_read_auth_info_arg(self):
+        with self.assertRaises(agent.AgentFileFormatError):
+            agent.read_auth_info(0)
+
+    def test_load_auth_info_with_bad_key(self):
+        with self.assertRaises(agent.AgentFileFormatError):
+            agent.load_auth_info(self.bad_key_agent_filename)
+
+    def test_load_auth_info_with_no_username(self):
+        with self.assertRaises(agent.AgentFileFormatError):
+            agent.load_auth_info(self.no_username_agent_filename)
+
+    def test_agent_login(self):
+        discharge_key = bakery.generate_key()
+
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def third_party_info(self, loc):
+                if loc == 'http://0.3.2.1':
+                    return bakery.ThirdPartyInfo(
+                        public_key=discharge_key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+        d = _DischargerLocator()
+        server_key = bakery.generate_key()
+        server_bakery = bakery.Bakery(key=server_key, locator=d)
+
+        @urlmatch(path='.*/here')
+        def server_get(url, request):
+            ctx = checkers.AuthContext()
+            test_ops = [bakery.Op(entity='test-op', action='read')]
+            auth_checker = server_bakery.checker.auth(
+                httpbakery.extract_macaroons(request.headers))
+            try:
+                auth_checker.allow(ctx, test_ops)
+                resp = response(status_code=200,
+                                content='done')
+            except bakery.PermissionDenied:
+                caveats = [
+                    checkers.Caveat(location='http://0.3.2.1',
+                                    condition='is-ok')
+                ]
+                m = server_bakery.oven.macaroon(
+                    version=bakery.LATEST_VERSION,
+                    expiry=datetime.utcnow() + timedelta(days=1),
+                    caveats=caveats, ops=test_ops)
+                content, headers = httpbakery.discharge_required_response(
+                    m, '/',
+                    'test',
+                    'message')
+                resp = response(status_code=401,
+                                content=content,
+                                headers=headers)
+            return request.hooks['response'][0](resp)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            if qs.get('token64') is None:
+                return response(
+                    status_code=401,
+                    content={
+                        'Code': httpbakery.ERR_INTERACTION_REQUIRED,
+                        'Message': 'interaction required',
+                        'Info': {
+                            'InteractionMethods': {
+                                'agent': {'login-url': '/login'},
+                            },
+                        },
+                    },
+                    headers={'Content-Type': 'application/json'})
+            else:
+                qs = parse_qs(request.body)
+                content = {q: qs[q][0] for q in qs}
+                m = httpbakery.discharge(checkers.AuthContext(), content,
+                                         discharge_key, None, alwaysOK3rd)
+                return {
+                    'status_code': 200,
+                    'content': {
+                        'Macaroon': m.to_dict()
+                    }
+                }
+
+        auth_info = agent.load_auth_info(self.agent_filename)
+
+        @urlmatch(path='.*/login')
+        def login(url, request):
+            qs = parse_qs(urlparse(request.url).query)
+            self.assertEqual(request.method, 'GET')
+            self.assertEqual(
+                qs, {'username': ['test-user'], 'public-key': [PUBLIC_KEY]})
+            b = bakery.Bakery(key=discharge_key)
+            m = b.oven.macaroon(
+                version=bakery.LATEST_VERSION,
+                expiry=datetime.utcnow() + timedelta(days=1),
+                caveats=[bakery.local_third_party_caveat(
+                    PUBLIC_KEY,
+                    version=httpbakery.request_version(request.headers))],
+                ops=[bakery.Op(entity='agent', action='login')])
+            return {
+                'status_code': 200,
+                'content': {
+                    'macaroon': m.to_dict()
+                }
+            }
+
+        with HTTMock(server_get), \
+                HTTMock(discharge), \
+                HTTMock(login):
+            client = httpbakery.Client(interaction_methods=[
+                agent.AgentInteractor(auth_info),
+            ])
+            resp = requests.get(
+                'http://0.1.2.3/here',
+                cookies=client.cookies,
+                auth=client.auth())
+        self.assertEqual(resp.content, b'done')
+
+    def test_agent_legacy(self):
+        discharge_key = bakery.generate_key()
+
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def third_party_info(self, loc):
+                if loc == 'http://0.3.2.1':
+                    return bakery.ThirdPartyInfo(
+                        public_key=discharge_key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+        d = _DischargerLocator()
+        server_key = bakery.generate_key()
+        server_bakery = bakery.Bakery(key=server_key, locator=d)
+
+        @urlmatch(path='.*/here')
+        def server_get(url, request):
+            ctx = checkers.AuthContext()
+            test_ops = [bakery.Op(entity='test-op', action='read')]
+            auth_checker = server_bakery.checker.auth(
+                httpbakery.extract_macaroons(request.headers))
+            try:
+                auth_checker.allow(ctx, test_ops)
+                resp = response(status_code=200,
+                                content='done')
+            except bakery.PermissionDenied:
+                caveats = [
+                    checkers.Caveat(location='http://0.3.2.1',
+                                    condition='is-ok')
+                ]
+                m = server_bakery.oven.macaroon(
+                    version=bakery.LATEST_VERSION,
+                    expiry=datetime.utcnow() + timedelta(days=1),
+                    caveats=caveats, ops=test_ops)
+                content, headers = httpbakery.discharge_required_response(
+                    m, '/',
+                    'test',
+                    'message')
+                resp = response(
+                    status_code=401,
+                    content=content,
+                    headers=headers,
+                )
+            return request.hooks['response'][0](resp)
+
+        class InfoStorage:
+            info = None
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            if qs.get('caveat64') is not None:
+                content = {q: qs[q][0] for q in qs}
+
+                class InteractionRequiredError(Exception):
+                    def __init__(self, error):
+                        self.error = error
+
+                class CheckerInError(bakery.ThirdPartyCaveatChecker):
+                    def check_third_party_caveat(self, ctx, info):
+                        InfoStorage.info = info
+                        raise InteractionRequiredError(
+                            httpbakery.Error(
+                                code=httpbakery.ERR_INTERACTION_REQUIRED,
+                                version=httpbakery.request_version(
+                                    request.headers),
+                                message='interaction required',
+                                info=httpbakery.ErrorInfo(
+                                    wait_url='http://0.3.2.1/wait?'
+                                             'dischargeid=1',
+                                    visit_url='http://0.3.2.1/visit?'
+                                              'dischargeid=1'
+                                ),
+                            ),
+                        )
+                try:
+                    httpbakery.discharge(
+                        checkers.AuthContext(), content,
+                        discharge_key, None, CheckerInError())
+                except InteractionRequiredError as exc:
+                    return response(
+                        status_code=401,
+                        content={
+                            'Code': exc.error.code,
+                            'Message': exc.error.message,
+                            'Info': {
+                                'WaitURL': exc.error.info.wait_url,
+                                'VisitURL': exc.error.info.visit_url,
+                            },
+                        },
+                        headers={'Content-Type': 'application/json'})
+
+        key = bakery.generate_key()
+
+        @urlmatch(path='.*/visit')
+        def visit(url, request):
+            if request.headers.get('Accept') == 'application/json':
+                return {
+                    'status_code': 200,
+                    'content': {
+                        'agent': '/agent-visit',
+                    }
+                }
+            raise Exception('unexpected call to visit without Accept header')
+
+        @urlmatch(path='.*/agent-visit')
+        def agent_visit(url, request):
+            if request.method != "POST":
+                raise Exception('unexpected method')
+            log.info('agent_visit url {}'.format(url))
+            body = json.loads(request.body.decode('utf-8'))
+            if body['username'] != 'test-user':
+                raise Exception('unexpected username in body {!r}'.format(request.body))
+            public_key = bakery.PublicKey.deserialize(body['public_key'])
+            ms = httpbakery.extract_macaroons(request.headers)
+            if len(ms) == 0:
+                b = bakery.Bakery(key=discharge_key)
+                m = b.oven.macaroon(
+                    version=bakery.LATEST_VERSION,
+                    expiry=datetime.utcnow() + timedelta(days=1),
+                    caveats=[bakery.local_third_party_caveat(
+                        public_key,
+                        version=httpbakery.request_version(request.headers))],
+                    ops=[bakery.Op(entity='agent', action='login')])
+                content, headers = httpbakery.discharge_required_response(
+                    m, '/',
+                    'test',
+                    'message')
+                resp = response(status_code=401,
+                                content=content,
+                                headers=headers)
+                return request.hooks['response'][0](resp)
+
+            return {
+                'status_code': 200,
+                'content': {
+                    'agent_login': True
+                }
+            }
+
+        @urlmatch(path='.*/wait$')
+        def wait(url, request):
+            class EmptyChecker(bakery.ThirdPartyCaveatChecker):
+                def check_third_party_caveat(self, ctx, info):
+                    return []
+            if InfoStorage.info is None:
+                self.fail('visit url has not been visited')
+            m = bakery.discharge(
+                checkers.AuthContext(),
+                InfoStorage.info.id,
+                InfoStorage.info.caveat,
+                discharge_key,
+                EmptyChecker(),
+                _DischargerLocator(),
+            )
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        with HTTMock(server_get), \
+                HTTMock(discharge), \
+                HTTMock(visit), \
+                HTTMock(wait), \
+                HTTMock(agent_visit):
+            client = httpbakery.Client(interaction_methods=[
+                agent.AgentInteractor(
+                    agent.AuthInfo(
+                        key=key,
+                        agents=[agent.Agent(username='test-user',
+                                            url=u'http://0.3.2.1')],
+                    ),
+                ),
+            ])
+            resp = requests.get(
+                'http://0.1.2.3/here',
+                cookies=client.cookies,
+                auth=client.auth(),
+            )
+        self.assertEqual(resp.content, b'done')
+
+
+agent_file = '''
+{
+  "key": {
+    "public": "YAhRSsth3a36mRYqQGQaLiS4QJax0p356nd+B8x7UQE=",
+    "private": "CqoSgj06Zcgb4/S6RT4DpTjLAfKoznEY3JsShSjKJEU="
+    },
+  "agents": [{
+    "url": "https://1.example.com/",
+    "username": "user-1"
+    }, {
+    "url": "https://2.example.com/discharger",
+    "username": "user-2"
+  }, {
+    "url": "http://0.3.2.1",
+    "username": "test-user"
+  }]
+}
+'''
+
+bad_key_agent_file = '''
+{
+  "key": {
+    "public": "YAhRSsth3a36mRYqQGQaLiS4QJax0p356nd+B8x7UQE=",
+    "private": "CqoSgj06Zcgb4/S6RT4DpTjLAfKoznEY3JsShSjKJE=="
+    },
+  "agents": [{
+    "url": "https://1.example.com/",
+    "username": "user-1"
+    }, {
+    "url": "https://2.example.com/discharger",
+    "username": "user-2"
+  }]
+}
+'''
+
+
+no_username_agent_file = '''
+{
+  "key": {
+    "public": "YAhRSsth3a36mRYqQGQaLiS4QJax0p356nd+B8x7UQE=",
+    "private": "CqoSgj06Zcgb4/S6RT4DpTjLAfKoznEY3JsShSjKJEU="
+    },
+  "agents": [{
+    "url": "https://1.example.com/"
+    }, {
+    "url": "https://2.example.com/discharger",
+    "username": "user-2"
+  }]
+}
+'''
+
+
+class ThirdPartyCaveatCheckerF(bakery.ThirdPartyCaveatChecker):
+    def __init__(self, check):
+        self._check = check
+
+    def check_third_party_caveat(self, ctx, info):
+        cond, arg = checkers.parse_caveat(info.condition)
+        return self._check(cond, arg)
+
+alwaysOK3rd = ThirdPartyCaveatCheckerF(lambda cond, arg: [])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_authorizer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_authorizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5539b7f41a93e4af4a6d1253ef660442306b24b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_authorizer.py
@@ -0,0 +1,136 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+
+
+class TestAuthorizer(TestCase):
+    def test_authorize_func(self):
+        def f(ctx, identity, op):
+            self.assertEqual(identity.id(), 'bob')
+            if op.entity == 'a':
+                return False, None
+            elif op.entity == 'b':
+                return True, None
+            elif op.entity == 'c':
+                return True, [checkers.Caveat(location='somewhere',
+                                              condition='c')]
+            elif op.entity == 'd':
+                return True, [checkers.Caveat(location='somewhere',
+                                              condition='d')]
+            else:
+                self.fail('unexpected entity: ' + op.Entity)
+
+        ops = [bakery.Op('a', 'x'), bakery.Op('b', 'x'),
+               bakery.Op('c', 'x'), bakery.Op('d', 'x')]
+        allowed, caveats = bakery.AuthorizerFunc(f).authorize(
+            checkers.AuthContext(),
+            bakery.SimpleIdentity('bob'),
+            ops
+        )
+        self.assertEqual(allowed, [False, True, True, True])
+        self.assertEqual(caveats, [
+            checkers.Caveat(location='somewhere', condition='c'),
+            checkers.Caveat(location='somewhere', condition='d')
+        ])
+
+    def test_acl_authorizer(self):
+        ctx = checkers.AuthContext()
+        tests = [
+            ('no ops, no problem',
+             bakery.ACLAuthorizer(allow_public=True, get_acl=lambda x, y: []),
+             None,
+             [],
+             []),
+            ('identity that does not implement ACLIdentity; '
+             'user should be denied except for everyone group',
+             bakery.ACLAuthorizer(
+                 allow_public=True,
+                 get_acl=lambda ctx, op: [bakery.EVERYONE] if op.entity == 'a' else ['alice'],
+             ),
+             SimplestIdentity('bob'),
+             [bakery.Op(entity='a', action='a'),
+              bakery.Op(entity='b', action='b')],
+             [True, False]),
+            ('identity that does not implement ACLIdentity with user == Id; '
+             'user should be denied except for everyone group',
+             bakery.ACLAuthorizer(
+                 allow_public=True,
+                 get_acl=lambda ctx, op: [bakery.EVERYONE] if op.entity == 'a' else ['bob'],
+             ),
+             SimplestIdentity('bob'),
+             [bakery.Op(entity='a', action='a'),
+              bakery.Op(entity='b', action='b')],
+             [True, False]),
+            ('permission denied for everyone without AllowPublic',
+             bakery.ACLAuthorizer(
+                 allow_public=False,
+                 get_acl=lambda x, y: [bakery.EVERYONE],
+             ),
+             SimplestIdentity('bob'),
+             [bakery.Op(entity='a', action='a')],
+             [False]),
+            ('permission granted to anyone with no identity with AllowPublic',
+             bakery.ACLAuthorizer(
+                 allow_public=True,
+                 get_acl=lambda x, y: [bakery.EVERYONE],
+             ),
+             None,
+             [bakery.Op(entity='a', action='a')],
+             [True])
+        ]
+        for test in tests:
+            allowed, caveats = test[1].authorize(ctx, test[2], test[3])
+            self.assertEqual(len(caveats), 0)
+            self.assertEqual(allowed, test[4])
+
+    def test_context_wired_properly(self):
+        ctx = checkers.AuthContext({'a': 'aval'})
+
+        class Visited:
+            in_f = False
+            in_allow = False
+            in_get_acl = False
+
+        def f(ctx, identity, op):
+            self.assertEqual(ctx.get('a'), 'aval')
+            Visited.in_f = True
+            return False, None
+
+        bakery.AuthorizerFunc(f).authorize(
+            ctx, bakery.SimpleIdentity('bob'), ['op1']
+        )
+        self.assertTrue(Visited.in_f)
+
+        class TestIdentity(SimplestIdentity, bakery.ACLIdentity):
+            def allow(other, ctx, acls):
+                self.assertEqual(ctx.get('a'), 'aval')
+                Visited.in_allow = True
+                return False
+
+        def get_acl(ctx, acl):
+            self.assertEqual(ctx.get('a'), 'aval')
+            Visited.in_get_acl = True
+            return []
+
+        bakery.ACLAuthorizer(
+            allow_public=False,
+            get_acl=get_acl,
+        ).authorize(ctx, TestIdentity('bob'), ['op1'])
+        self.assertTrue(Visited.in_get_acl)
+        self.assertTrue(Visited.in_allow)
+
+
+class SimplestIdentity(bakery.Identity):
+    # SimplestIdentity implements Identity for a string. Unlike
+    # SimpleIdentity, it does not implement ACLIdentity.
+    def __init__(self, user):
+        self._identity = user
+
+    def domain(self):
+        return ''
+
+    def id(self):
+        return self._identity
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_bakery.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_bakery.py
new file mode 100644
index 0000000000000000000000000000000000000000..d242b2aeabfe4f2212bf585ef82647e7c1c24932
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_bakery.py
@@ -0,0 +1,286 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from unittest import TestCase
+
+import macaroonbakery.httpbakery as httpbakery
+import requests
+from mock import patch
+
+from httmock import HTTMock, response, urlmatch
+
+ID_PATH = 'http://example.com/someprotecteurl'
+
+json_macaroon = {
+    u'identifier': u'macaroon-identifier',
+    u'caveats': [
+        {
+            u'cl': u'http://example.com/identity/v1/discharger',
+            u'vid': u'zgtQa88oS9UF45DlJniRaAUT4qqHhLxQzCeUU9N2O1Uu-'
+                    u'yhFulgGbSA0zDGdkrq8YNQAxGiARA_-AGxyoh25kiTycb8u47pD',
+            u'cid': u'eyJUaGlyZFBhcnR5UHV'
+        }, {
+            u'cid': u'allow read-no-terms write'
+        }, {
+            u'cid': u'time-before 2158-07-19T14:29:14.312669464Z'
+        }],
+    u'location': u'charmstore',
+    u'signature': u'52d17cb11f5c84d58441bc0ffd7cc396'
+                  u'5115374ce2fa473ecf06265b5d4d9e81'
+}
+
+discharge_token = [{
+    u'identifier': u'token-identifier===',
+    u'caveats': [{
+        u'cid': u'declared username someone'
+    }, {
+        u'cid': u'time-before 2158-08-15T15:55:52.428319076Z'
+    }, {
+        u'cid': u'origin '
+    }],
+    u'location': u'https://example.com/identity',
+    u'signature': u'5ae0e7a2abf806bdd92f510fcd3'
+                  u'198f520691259abe76ffae5623dae048769ef'
+}]
+
+discharged_macaroon = {
+    u'identifier': u'discharged-identifier=',
+    u'caveats': [{
+        u'cid': u'declared uuid a1130b10-3deb-59b7-baf0-c2a3f83e7382'
+    }, {
+        u'cid': u'declared username someone'
+    }, {
+        u'cid': u'time-before 2158-07-19T15:55:52.432439055Z'
+    }],
+    u'location': u'',
+    u'signature': u'3513db5503ab17f9576760cd28'
+                  u'ce658ce8bf6b43038255969fc3c1cd8b172345'
+}
+
+
+@urlmatch(path='.*/someprotecteurl')
+def first_407_then_200(url, request):
+    if request.headers.get('cookie', '').startswith('macaroon-'):
+        return {
+            'status_code': 200,
+            'content': {
+                'Value': 'some value'
+            }
+        }
+    else:
+        resp = response(status_code=407,
+                        content={
+                            'Info': {
+                                'Macaroon': json_macaroon,
+                                'MacaroonPath': '/',
+                                'CookieNameSuffix': 'test'
+                            },
+                            'Message': 'verification failed: no macaroon '
+                                       'cookies in request',
+                            'Code': 'macaroon discharge required'
+                        },
+                        headers={'Content-Type': 'application/json'})
+        return request.hooks['response'][0](resp)
+
+
+@urlmatch(netloc='example.com:8000', path='.*/someprotecteurl')
+def first_407_then_200_with_port(url, request):
+    if request.headers.get('cookie', '').startswith('macaroon-'):
+        return {
+            'status_code': 200,
+            'content': {
+                'Value': 'some value'
+            }
+        }
+    else:
+        resp = response(status_code=407,
+                        content={
+                            'Info': {
+                                'Macaroon': json_macaroon,
+                                'MacaroonPath': '/',
+                                'CookieNameSuffix': 'test'
+                            },
+                            'Message': 'verification failed: no macaroon '
+                                       'cookies in request',
+                            'Code': 'macaroon discharge required'
+                        },
+                        headers={'Content-Type': 'application/json'},
+                        request=request)
+        return request.hooks['response'][0](resp)
+
+
+@urlmatch(path='.*/someprotecteurl')
+def valid_200(url, request):
+    return {
+        'status_code': 200,
+        'content': {
+            'Value': 'some value'
+        }
+    }
+
+
+@urlmatch(path='.*/discharge')
+def discharge_200(url, request):
+    return {
+        'status_code': 200,
+        'content': {
+            'Macaroon': discharged_macaroon
+        }
+    }
+
+
+@urlmatch(path='.*/discharge')
+def discharge_401(url, request):
+    return {
+        'status_code': 401,
+        'content': {
+            'Code': 'interaction required',
+            'Info': {
+                'VisitURL': 'http://example.com/visit',
+                'WaitURL': 'http://example.com/wait'
+            }
+        },
+        'headers': {
+            'WWW-Authenticate': 'Macaroon'
+        }
+    }
+
+
+@urlmatch(path='.*/visit')
+def visit_200(url, request):
+    return {
+        'status_code': 200,
+        'content': {
+            'interactive': '/visit'
+        }
+    }
+
+
+@urlmatch(path='.*/wait')
+def wait_after_401(url, request):
+    if request.url != 'http://example.com/wait':
+        return {'status_code': 500}
+
+    return {
+        'status_code': 200,
+        'content': {
+            'DischargeToken': discharge_token,
+            'Macaroon': discharged_macaroon
+        }
+    }
+
+
+@urlmatch(path='.*/wait')
+def wait_on_error(url, request):
+    return {
+        'status_code': 500,
+        'content': {
+            'DischargeToken': discharge_token,
+            'Macaroon': discharged_macaroon
+        }
+    }
+
+
+class TestBakery(TestCase):
+
+    def assert_cookie_security(self, cookies, name, secure):
+        for cookie in cookies:
+            if cookie.name == name:
+                assert cookie.secure == secure
+                break
+        else:
+            assert False, 'no cookie named {} found in jar'.format(name)
+
+    def test_discharge(self):
+        client = httpbakery.Client()
+        with HTTMock(first_407_then_200), HTTMock(discharge_200):
+                resp = requests.get(ID_PATH,
+                                    cookies=client.cookies,
+                                    auth=client.auth())
+        resp.raise_for_status()
+        assert 'macaroon-test' in client.cookies.keys()
+        self.assert_cookie_security(client.cookies, 'macaroon-test',
+                                    secure=False)
+
+    @patch('webbrowser.open')
+    def test_407_then_401_on_discharge(self, mock_open):
+        client = httpbakery.Client()
+        with HTTMock(first_407_then_200), HTTMock(discharge_401), \
+                HTTMock(wait_after_401):
+                resp = requests.get(
+                    ID_PATH,
+                    cookies=client.cookies,
+                    auth=client.auth(),
+                )
+                resp.raise_for_status()
+        mock_open.assert_called_once_with(u'http://example.com/visit', new=1)
+        assert 'macaroon-test' in client.cookies.keys()
+
+    @patch('webbrowser.open')
+    def test_407_then_error_on_wait(self, mock_open):
+        client = httpbakery.Client()
+        with HTTMock(first_407_then_200), HTTMock(discharge_401),\
+                HTTMock(wait_on_error):
+            with self.assertRaises(httpbakery.InteractionError) as exc:
+                requests.get(
+                    ID_PATH,
+                    cookies=client.cookies,
+                    auth=client.auth(),
+                )
+        self.assertEqual(str(exc.exception),
+                         'cannot start interactive session: cannot get '
+                         'http://example.com/wait')
+        mock_open.assert_called_once_with(u'http://example.com/visit', new=1)
+
+    def test_407_then_no_interaction_methods(self):
+        client = httpbakery.Client(interaction_methods=[])
+        with HTTMock(first_407_then_200), HTTMock(discharge_401):
+            with self.assertRaises(httpbakery.InteractionError) as exc:
+                requests.get(
+                    ID_PATH,
+                    cookies=client.cookies,
+                    auth=client.auth(),
+                )
+        self.assertEqual(str(exc.exception),
+                         'cannot start interactive session: interaction '
+                         'required but not possible')
+
+    def test_407_then_unknown_interaction_methods(self):
+        class UnknownInteractor(httpbakery.Interactor):
+            def kind(self):
+                return 'unknown'
+        client = httpbakery.Client(interaction_methods=[UnknownInteractor()])
+        with HTTMock(first_407_then_200), HTTMock(discharge_401),\
+                HTTMock(visit_200):
+            with self.assertRaises(httpbakery.InteractionError) as exc:
+                requests.get(
+                    ID_PATH,
+                    cookies=client.cookies,
+                    auth=client.auth(),
+                )
+        self.assertEqual(
+            str(exc.exception),
+            'cannot start interactive session: no methods supported; '
+            'supported [unknown]; provided [interactive]'
+        )
+
+    def test_cookie_with_port(self):
+        client = httpbakery.Client()
+        with HTTMock(first_407_then_200_with_port):
+            with HTTMock(discharge_200):
+                resp = requests.get('http://example.com:8000/someprotecteurl',
+                                    cookies=client.cookies,
+                                    auth=client.auth())
+        resp.raise_for_status()
+        assert 'macaroon-test' in client.cookies.keys()
+
+    def test_secure_cookie_for_https(self):
+        client = httpbakery.Client()
+        with HTTMock(first_407_then_200_with_port), HTTMock(discharge_200):
+                resp = requests.get(
+                    'https://example.com:8000/someprotecteurl',
+                    cookies=client.cookies,
+                    auth=client.auth())
+        resp.raise_for_status()
+        assert 'macaroon-test' in client.cookies.keys()
+        self.assert_cookie_security(client.cookies, 'macaroon-test',
+                                    secure=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checker.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b61768afb84214d94d56de655af210e6543095b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checker.py
@@ -0,0 +1,946 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+import json
+from collections import namedtuple
+from datetime import timedelta
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import pymacaroons
+from macaroonbakery.tests.common import epoch, test_checker, test_context
+from pymacaroons.verifier import FirstPartyCaveatVerifierDelegate, Verifier
+
+
+class TestChecker(TestCase):
+    def setUp(self):
+        self._discharges = []
+
+    def test_authorize_with_open_access_and_no_macaroons(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer(
+            {bakery.Op(entity='something', action='read'):
+                {bakery.EVERYONE}})
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+        auth_info = client.do(test_context, ts, [
+            bakery.Op(entity='something', action='read'),
+        ])
+        self.assertEqual(len(self._discharges), 0)
+        self.assertIsNotNone(auth_info)
+        self.assertIsNone(auth_info.identity)
+        self.assertEqual(len(auth_info.macaroons), 0)
+
+    def test_authorization_denied(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = bakery.ClosedAuthorizer()
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        with self.assertRaises(bakery.PermissionDenied):
+            client.do(ctx, ts, [bakery.Op(entity='something', action='read')])
+
+    def test_authorize_with_authentication_required(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer(
+            {bakery.Op(entity='something', action='read'): {'bob'}})
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        auth_info = client.do(ctx, ts, [bakery.Op(entity='something',
+                                                  action='read')])
+        self.assertEqual(self._discharges,
+                         [_DischargeRecord(location='ids', user='bob')])
+        self.assertIsNotNone(auth_info)
+        self.assertEqual(auth_info.identity.id(), 'bob')
+        self.assertEqual(len(auth_info.macaroons), 1)
+
+    def test_authorize_multiple_ops(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer(
+            {
+                bakery.Op(entity='something', action='read'): {'bob'},
+                bakery.Op(entity='otherthing', action='read'): {'bob'}
+            }
+        )
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        client.do(ctx, ts, [
+            bakery.Op(entity='something', action='read'),
+            bakery.Op(entity='otherthing', action='read')
+        ])
+        self.assertEqual(self._discharges,
+                         [_DischargeRecord(location='ids', user='bob')])
+
+    def test_capability(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer(
+            {bakery.Op(entity='something', action='read'): {'bob'}})
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m = client.discharged_capability(
+            ctx, ts, [bakery.Op(entity='something', action='read')])
+        # Check that we can exercise the capability directly on the service
+        # with no discharging required.
+        auth_info = ts.do(test_context, [m], [
+            bakery.Op(entity='something', action='read'),
+        ])
+        self.assertIsNotNone(auth_info)
+        self.assertIsNone(auth_info.identity)
+        self.assertEqual(len(auth_info.macaroons), 1)
+        self.assertEqual(auth_info.macaroons[0][0].identifier_bytes,
+                         m[0].identifier_bytes)
+
+    def test_capability_multiple_entities(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'bob'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+            bakery.Op(entity='e3', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m = client.discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+        self.assertEqual(self._discharges,
+                         [_DischargeRecord(location='ids', user='bob')])
+
+        # Check that we can exercise the capability directly on the service
+        # with no discharging required.
+        ts.do(test_context, [m], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+
+        # Check that we can exercise the capability to act on a subset of
+        # the operations.
+        ts.do(test_context, [m], [
+            bakery.Op(entity='e2', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+        ts.do(test_context, [m],
+              [bakery.Op(entity='e3', action='read')])
+
+    def test_multiple_capabilities(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'alice'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire two capabilities as different users and check
+        # that we can combine them together to do both operations
+        # at once.
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        m1 = _Client(locator).discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+        ])
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m2 = _Client(locator).discharged_capability(ctx, ts,
+                                                    [bakery.Op(
+                                                        entity='e2',
+                                                        action='read')])
+        self.assertEqual(self._discharges, [
+            _DischargeRecord(location='ids', user='alice'),
+            _DischargeRecord(location='ids', user='bob'),
+        ])
+        auth_info = ts.do(test_context, [m1, m2], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+        self.assertIsNotNone(auth_info)
+        self.assertIsNone(auth_info.identity)
+        self.assertEqual(len(auth_info.macaroons), 2)
+        self.assertEqual(auth_info.macaroons[0][0].identifier_bytes,
+                         m1[0].identifier_bytes)
+        self.assertEqual(auth_info.macaroons[1][0].identifier_bytes,
+                         m2[0].identifier_bytes)
+
+    def test_combine_capabilities(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'alice'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+            bakery.Op(entity='e3', action='read'): {'bob', 'alice'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire two capabilities as different users and check
+        # that we can combine them together into a single capability
+        # capable of both operations.
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        m1 = _Client(locator).discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m2 = _Client(locator).discharged_capability(
+            ctx, ts, [bakery.Op(entity='e2', action='read')])
+
+        m = ts.capability(test_context, [m1, m2], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+        ts.do(test_context, [[m.macaroon]], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+            bakery.Op(entity='e3', action='read'),
+        ])
+
+    def test_partially_authorized_request(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'alice'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire a capability for e1 but rely on authentication to
+        # authorize e2.
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        m = _Client(locator).discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+        ])
+        client = _Client(locator)
+        client.add_macaroon(ts, 'authz', m)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        client.discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+
+    def test_auth_with_third_party_caveats(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+
+        # We make an authorizer that requires a third party discharge
+        # when authorizing.
+        def authorize_with_tp_discharge(ctx, id, op):
+            if (id is not None and id.id() == 'bob' and
+                    op == bakery.Op(entity='something', action='read')):
+                return True, [checkers.Caveat(condition='question',
+                                              location='other third party')]
+            return False, None
+
+        auth = bakery.AuthorizerFunc(authorize_with_tp_discharge)
+        ts = _Service('myservice', auth, ids, locator)
+
+        class _LocalDischargeChecker(bakery.ThirdPartyCaveatChecker):
+            def check_third_party_caveat(_, ctx, info):
+                if info.condition != 'question':
+                    raise ValueError('third party condition not recognized')
+                self._discharges.append(_DischargeRecord(
+                    location='other third party',
+                    user=ctx.get(_DISCHARGE_USER_KEY)
+                ))
+                return []
+
+        locator['other third party'] = _Discharger(
+            key=bakery.generate_key(),
+            checker=_LocalDischargeChecker(),
+            locator=locator,
+        )
+        client = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        client.do(ctx, ts, [bakery.Op(entity='something', action='read')])
+        self.assertEqual(self._discharges, [
+            _DischargeRecord(location='ids', user='bob'),
+            _DischargeRecord(location='other third party', user='bob')
+        ])
+
+    def test_capability_combines_first_party_caveats(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'alice'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire two capabilities as different users, add some first party
+        # caveats that we can combine them together into a single capability
+        # capable of both operations.
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        m1 = _Client(locator).capability(
+            ctx, ts, [bakery.Op(entity='e1', action='read')])
+        m1.macaroon.add_first_party_caveat('true 1')
+        m1.macaroon.add_first_party_caveat('true 2')
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m2 = _Client(locator).capability(
+            ctx, ts, [bakery.Op(entity='e2', action='read')])
+        m2.macaroon.add_first_party_caveat('true 3')
+        m2.macaroon.add_first_party_caveat('true 4')
+
+        client = _Client(locator)
+        client.add_macaroon(ts, 'authz1', [m1.macaroon])
+        client.add_macaroon(ts, 'authz2', [m2.macaroon])
+
+        m = client.capability(test_context, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+        self.assertEqual(_macaroon_conditions(m.macaroon.caveats, False), [
+            'true 1',
+            'true 2',
+            'true 3',
+            'true 4',
+        ])
+
+    def test_first_party_caveat_squashing(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'alice'},
+            bakery.Op(entity='e2', action='read'): {'alice'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+        tests = [
+            ('duplicates removed', [
+                checkers.Caveat(condition='true 1', namespace='testns'),
+                checkers.Caveat(condition='true 2', namespace='testns'),
+                checkers.Caveat(condition='true 1', namespace='testns'),
+                checkers.Caveat(condition='true 1', namespace='testns'),
+                checkers.Caveat(condition='true 3', namespace='testns'),
+            ], [
+                checkers.Caveat(condition='true 1', namespace='testns'),
+                checkers.Caveat(condition='true 2', namespace='testns'),
+                checkers.Caveat(condition='true 3', namespace='testns'),
+            ]), ('earliest time before', [
+                checkers.time_before_caveat(epoch + timedelta(days=1)),
+                checkers.Caveat(condition='true 1', namespace='testns'),
+                checkers.time_before_caveat(
+                    epoch + timedelta(days=0, hours=1)),
+                checkers.time_before_caveat(epoch + timedelta(
+                    days=0, hours=0, minutes=5)),
+            ], [
+                checkers.time_before_caveat(epoch + timedelta(
+                    days=0, hours=0, minutes=5)),
+                checkers.Caveat(condition='true 1', namespace='testns'),
+            ]), ('operations and declared caveats removed', [
+                checkers.deny_caveat(['foo']),
+                checkers.allow_caveat(['read', 'write']),
+                checkers.declared_caveat('username', 'bob'),
+                checkers.Caveat(condition='true 1', namespace='testns'),
+            ], [
+                checkers.Caveat(condition='true 1', namespace='testns'),
+            ])
+        ]
+        for test in tests:
+            print(test[0])
+
+            # Make a first macaroon with all the required first party caveats.
+            ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+            m1 = _Client(locator).capability(
+                ctx, ts, [bakery.Op(entity='e1', action='read')])
+            m1.add_caveats(test[1], None, None)
+
+            # Make a second macaroon that's not used to check that it's
+            # caveats are not added.
+            m2 = _Client(locator).capability(
+                ctx, ts, [bakery.Op(entity='e1', action='read')])
+            m2.add_caveat(checkers.Caveat(
+                condition='true notused', namespace='testns'), None, None)
+            client = _Client(locator)
+            client.add_macaroon(ts, 'authz1', [m1.macaroon])
+            client.add_macaroon(ts, 'authz2', [m2.macaroon])
+
+            m3 = client.capability(
+                test_context, ts, [bakery.Op(entity='e1', action='read')])
+            self.assertEqual(
+                _macaroon_conditions(m3.macaroon.caveats, False),
+                _resolve_caveats(m3.namespace, test[2]))
+
+    def test_login_only(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = bakery.ClosedAuthorizer()
+        ts = _Service('myservice', auth, ids, locator)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        auth_info = _Client(locator).do(ctx, ts, [bakery.LOGIN_OP])
+        self.assertIsNotNone(auth_info)
+        self.assertEqual(auth_info.identity.id(), 'bob')
+
+    def test_allow_any(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer(
+            {
+                bakery.Op(entity='e1', action='read'): {'alice'},
+                bakery.Op(entity='e2', action='read'): {'bob'},
+            })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire a capability for e1 but rely on authentication to
+        # authorize e2.
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        m = _Client(locator).discharged_capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+        ])
+
+        client = _Client(locator)
+        client.add_macaroon(ts, 'authz', m)
+
+        self._discharges = []
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        with self.assertRaises(_DischargeRequiredError):
+            client.do_any(
+                ctx, ts, [
+                    bakery.LOGIN_OP,
+                    bakery.Op(entity='e1', action='read'),
+                    bakery.Op(entity='e1', action='read')
+                ]
+            )
+            self.assertEqual(len(self._discharges), 0)
+
+        # Log in as bob.
+        _, err = client.do(ctx, ts, [bakery.LOGIN_OP])
+
+        # All the previous actions should now be allowed.
+        auth_info, allowed = client.do_any(ctx, ts, [
+            bakery.LOGIN_OP,
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e1', action='read'),
+        ])
+        self.assertEqual(auth_info.identity.id(), 'bob')
+        self.assertEqual(len(auth_info.macaroons), 2)
+        self.assertEqual(allowed, [True, True, True])
+
+    def test_auth_with_identity_from_context(self):
+        locator = _DischargerLocator()
+        ids = _BasicAuthIdService()
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'sherlock'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Check that we can perform the ops with basic auth in the
+        # context.
+        ctx = _context_with_basic_auth(test_context, 'sherlock', 'holmes')
+        auth_info = _Client(locator).do(
+            ctx, ts, [bakery.Op(entity='e1', action='read')])
+        self.assertEqual(auth_info.identity.id(), 'sherlock')
+        self.assertEqual(len(auth_info.macaroons), 0)
+
+    def test_auth_login_op_with_identity_from_context(self):
+        locator = _DischargerLocator()
+        ids = _BasicAuthIdService()
+        ts = _Service('myservice', bakery.ClosedAuthorizer(), ids, locator)
+
+        # Check that we can use LoginOp
+        # when auth isn't granted through macaroons.
+        ctx = _context_with_basic_auth(test_context, 'sherlock', 'holmes')
+        auth_info = _Client(locator).do(ctx, ts, [bakery.LOGIN_OP])
+        self.assertEqual(auth_info.identity.id(), 'sherlock')
+        self.assertEqual(len(auth_info.macaroons), 0)
+
+    def test_operation_allow_caveat(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'bob'},
+            bakery.Op(entity='e1', action='write'): {'bob'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m = client.capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e1', action='write'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+
+        # Sanity check that we can do a write.
+        ts.do(test_context, [[m.macaroon]],
+              [bakery.Op(entity='e1', action='write')])
+
+        m.add_caveat(checkers.allow_caveat(['read']), None, None)
+
+        # A read operation should work.
+        ts.do(test_context, [[m.macaroon]], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+
+        # A write operation should fail
+        # even though the original macaroon allowed it.
+        with self.assertRaises(_DischargeRequiredError):
+            ts.do(test_context, [[m.macaroon]], [
+                bakery.Op(entity='e1', action='write'),
+            ])
+
+    def test_operation_deny_caveat(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = _OpAuthorizer({
+            bakery.Op(entity='e1', action='read'): {'bob'},
+            bakery.Op(entity='e1', action='write'): {'bob'},
+            bakery.Op(entity='e2', action='read'): {'bob'},
+        })
+        ts = _Service('myservice', auth, ids, locator)
+        client = _Client(locator)
+
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        m = client.capability(ctx, ts, [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e1', action='write'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+
+        # Sanity check that we can do a write.
+        ts.do(test_context, [[m.macaroon]], [
+              bakery.Op(entity='e1', action='write')])
+
+        m.add_caveat(checkers.deny_caveat(['write']), None, None)
+
+        # A read operation should work.
+        ts.do(test_context, [[m.macaroon]], [
+            bakery.Op(entity='e1', action='read'),
+            bakery.Op(entity='e2', action='read'),
+        ])
+
+        # A write operation should fail
+        # even though the original macaroon allowed it.
+        with self.assertRaises(_DischargeRequiredError):
+            ts.do(test_context, [[m.macaroon]], [
+                  bakery.Op(entity='e1', action='write')])
+
+    def test_duplicate_login_macaroons(self):
+        locator = _DischargerLocator()
+        ids = _IdService('ids', locator, self)
+        auth = bakery.ClosedAuthorizer()
+        ts = _Service('myservice', auth, ids, locator)
+
+        # Acquire a login macaroon for bob.
+        client1 = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'bob')
+        auth_info = client1.do(ctx, ts, [bakery.LOGIN_OP])
+        self.assertEqual(auth_info.identity.id(), 'bob')
+
+        # Acquire a login macaroon for alice.
+        client2 = _Client(locator)
+        ctx = test_context.with_value(_DISCHARGE_USER_KEY, 'alice')
+        auth_info = client2.do(ctx, ts, [bakery.LOGIN_OP])
+        self.assertEqual(auth_info.identity.id(), 'alice')
+
+        # Combine the two login macaroons into one client.
+        client3 = _Client(locator)
+        client3.add_macaroon(ts, '1.bob',
+                             client1._macaroons[ts.name()]['authn'])
+        client3.add_macaroon(ts, '2.alice',
+                             client2._macaroons[ts.name()]['authn'])
+
+        # We should authenticate as bob (because macaroons are presented
+        # ordered by "cookie" name)
+        auth_info = client3.do(test_context, ts, [bakery.LOGIN_OP])
+        self.assertEqual(auth_info.identity.id(), 'bob')
+        self.assertEqual(len(auth_info.macaroons), 1)
+
+        # Try them the other way around and we should authenticate as alice.
+        client3 = _Client(locator)
+        client3.add_macaroon(ts, '1.alice',
+                             client2._macaroons[ts.name()]['authn'])
+        client3.add_macaroon(ts, '2.bob',
+                             client1._macaroons[ts.name()]['authn'])
+
+        auth_info = client3.do(test_context, ts, [bakery.LOGIN_OP])
+        self.assertEqual(auth_info.identity.id(), 'alice')
+        self.assertEqual(len(auth_info.macaroons), 1)
+
+    def test_macaroon_ops_fatal_error(self):
+        # When we get a non-VerificationError error from the
+        # opstore, we don't do any more verification.
+        checker = bakery.Checker(
+            macaroon_opstore=_MacaroonStoreWithError())
+        m = pymacaroons.Macaroon(version=pymacaroons.MACAROON_V2)
+        with self.assertRaises(bakery.AuthInitError):
+            checker.auth([m]).allow(test_context, [bakery.LOGIN_OP])
+
+
+class _DischargerLocator(bakery.ThirdPartyLocator):
+    def __init__(self, dischargers=None):
+        if dischargers is None:
+            dischargers = {}
+        self._dischargers = dischargers
+
+    def third_party_info(self, loc):
+        d = self._dischargers.get(loc)
+        if d is None:
+            return None
+        return bakery.ThirdPartyInfo(
+            public_key=d._key.public_key,
+            version=bakery.LATEST_VERSION,
+        )
+
+    def __setitem__(self, key, item):
+        self._dischargers[key] = item
+
+    def __getitem__(self, key):
+        return self._dischargers[key]
+
+    def get(self, key):
+        return self._dischargers.get(key)
+
+
+class _IdService(bakery.IdentityClient,
+                 bakery.ThirdPartyCaveatChecker):
+    def __init__(self, location, locator, test_class):
+        self._location = location
+        self._test = test_class
+        key = bakery.generate_key()
+        self._discharger = _Discharger(key=key, checker=self, locator=locator)
+        locator[location] = self._discharger
+
+    def check_third_party_caveat(self, ctx, info):
+        if info.condition != 'is-authenticated-user':
+            raise bakery.CaveatNotRecognizedError(
+                'third party condition not recognized')
+
+        username = ctx.get(_DISCHARGE_USER_KEY, '')
+        if username == '':
+            raise bakery.ThirdPartyCaveatCheckFailed('no current user')
+        self._test._discharges.append(
+            _DischargeRecord(location=self._location, user=username))
+        return [checkers.declared_caveat('username', username)]
+
+    def identity_from_context(self, ctx):
+        return None, [checkers.Caveat(location=self._location,
+                                      condition='is-authenticated-user')]
+
+    def declared_identity(self, ctx, declared):
+        user = declared.get('username')
+        if user is None:
+            raise bakery.IdentityError('no username declared')
+        return bakery.SimpleIdentity(user)
+
+
+_DISCHARGE_USER_KEY = checkers.ContextKey('user-key')
+
+_DischargeRecord = namedtuple('_DISCHARGE_RECORD', ['location', 'user'])
+
+
+class _Discharger(object):
+    ''' utility class that has a discharge function with the same signature of
+    get_discharge for discharge_all.
+    '''
+
+    def __init__(self, key, locator, checker):
+        self._key = key
+        self._locator = locator
+        self._checker = checker
+
+    def discharge(self, ctx, cav, payload):
+        return bakery.discharge(
+            ctx,
+            key=self._key,
+            id=cav.caveat_id,
+            caveat=payload,
+            checker=self._checker,
+            locator=self._locator,
+        )
+
+
+class _OpAuthorizer(bakery.Authorizer):
+    '''Implements bakery.Authorizer by looking the operation
+    up in the given map. If the username is in the associated list
+    or the list contains "everyone", authorization is granted.
+    '''
+
+    def __init__(self, auth=None):
+        if auth is None:
+            auth = {}
+        self._auth = auth
+
+    def authorize(self, ctx, id, ops):
+        return bakery.ACLAuthorizer(
+            allow_public=True,
+            get_acl=lambda ctx, op: self._auth.get(op, [])).authorize(
+            ctx, id, ops)
+
+
+class _MacaroonStore(object):
+    ''' Stores root keys in memory and puts all operations in the macaroon id.
+    '''
+
+    def __init__(self, key, locator):
+        self._root_key_store = bakery.MemoryKeyStore()
+        self._key = key
+        self._locator = locator
+
+    def new_macaroon(self, caveats, namespace, ops):
+        root_key, id = self._root_key_store.root_key()
+        m_id = {'id': base64.urlsafe_b64encode(id).decode('utf-8'), 'ops': ops}
+        data = json.dumps(m_id)
+        m = bakery.Macaroon(
+            root_key=root_key, id=data, location='',
+            version=bakery.LATEST_VERSION,
+            namespace=namespace)
+        m.add_caveats(caveats, self._key, self._locator)
+        return m
+
+    def macaroon_ops(self, ms):
+        if len(ms) == 0:
+            raise ValueError('no macaroons provided')
+
+        m_id = json.loads(ms[0].identifier_bytes.decode('utf-8'))
+        root_key = self._root_key_store.get(
+            base64.urlsafe_b64decode(m_id['id'].encode('utf-8')))
+
+        v = Verifier()
+
+        class NoValidationOnFirstPartyCaveat(FirstPartyCaveatVerifierDelegate):
+            def verify_first_party_caveat(self, verifier, caveat, signature):
+                return True
+
+        v.first_party_caveat_verifier_delegate = \
+            NoValidationOnFirstPartyCaveat()
+        ok = v.verify(macaroon=ms[0], key=root_key,
+                      discharge_macaroons=ms[1:])
+        if not ok:
+            raise bakery.VerificationError('invalid signature')
+        conditions = []
+        for m in ms:
+            cavs = m.first_party_caveats()
+            for cav in cavs:
+                conditions.append(cav.caveat_id_bytes.decode('utf-8'))
+        ops = []
+        for op in m_id['ops']:
+            ops.append(bakery.Op(entity=op[0], action=op[1]))
+        return ops, conditions
+
+
+class _Service(object):
+    '''Represents a service that requires authorization.
+
+    Clients can make requests to the service to perform operations
+    and may receive a macaroon to discharge if the authorization
+    process requires it.
+    '''
+
+    def __init__(self, name, auth, idm, locator):
+        self._name = name
+        self._store = _MacaroonStore(bakery.generate_key(), locator)
+        self._checker = bakery.Checker(
+            checker=test_checker(),
+            authorizer=auth,
+            identity_client=idm,
+            macaroon_opstore=self._store)
+
+    def name(self):
+        return self._name
+
+    def do(self, ctx, ms, ops):
+        try:
+            authInfo = self._checker.auth(ms).allow(ctx, ops)
+        except bakery.DischargeRequiredError as exc:
+            self._discharge_required_error(exc)
+        return authInfo
+
+    def do_any(self, ctx, ms, ops):
+        # makes a request to the service to perform any of the given
+        # operations. It reports which operations have succeeded.
+        try:
+            authInfo, allowed = self._checker.auth(ms).allow_any(ctx, ops)
+            return authInfo, allowed
+        except bakery.DischargeRequiredError as exc:
+            self._discharge_required_error(exc)
+
+    def capability(self, ctx, ms, ops):
+        try:
+            conds = self._checker.auth(ms).allow_capability(ctx, ops)
+        except bakery.DischargeRequiredError as exc:
+            self._discharge_required_error(exc)
+
+        m = self._store.new_macaroon(None, self._checker.namespace(), ops)
+        for cond in conds:
+            m.macaroon.add_first_party_caveat(cond)
+        return m
+
+    def _discharge_required_error(self, err):
+        m = self._store.new_macaroon(err.cavs(), self._checker.namespace(),
+                                     err.ops())
+        name = 'authz'
+        if len(err.ops()) == 1 and err.ops()[0] == bakery.LOGIN_OP:
+            name = 'authn'
+        raise _DischargeRequiredError(name=name, m=m)
+
+
+class _DischargeRequiredError(Exception):
+    def __init__(self, name, m):
+        Exception.__init__(self, 'discharge required')
+        self._name = name
+        self._m = m
+
+    def m(self):
+        return self._m
+
+    def name(self):
+        return self._name
+
+
+class _Client(object):
+    max_retries = 3
+
+    def __init__(self, dischargers):
+        self._key = bakery.generate_key()
+        self._macaroons = {}
+        self._dischargers = dischargers
+
+    def do(self, ctx, svc, ops):
+        class _AuthInfo:
+            authInfo = None
+
+        def svc_do(ms):
+            _AuthInfo.authInfo = svc.do(ctx, ms, ops)
+
+        self._do_func(ctx, svc, svc_do)
+        return _AuthInfo.authInfo
+
+    def do_any(self, ctx, svc, ops):
+        return svc.do_any(ctx, self._request_macaroons(svc), ops)
+
+    def capability(self, ctx, svc, ops):
+        # capability returns a capability macaroon for the given operations.
+
+        class _M:
+            m = None
+
+        def svc_capability(ms):
+            _M.m = svc.capability(ctx, ms, ops)
+            return
+
+        self._do_func(ctx, svc, svc_capability)
+        return _M.m
+
+    def discharged_capability(self, ctx, svc, ops):
+        m = self.capability(ctx, svc, ops)
+        return self._discharge_all(ctx, m)
+
+    def _do_func(self, ctx, svc, f):
+        for i in range(0, self.max_retries):
+            try:
+                f(self._request_macaroons(svc))
+                return
+            except _DischargeRequiredError as exc:
+                ms = self._discharge_all(ctx, exc.m())
+                self.add_macaroon(svc, exc.name(), ms)
+        raise ValueError('discharge failed too many times')
+
+    def _clear_macaroons(self, svc):
+        if svc is None:
+            self._macaroons = {}
+            return
+        if svc.name() in self._macaroons:
+            del self._macaroons[svc.name()]
+
+    def add_macaroon(self, svc, name, m):
+        if svc.name() not in self._macaroons:
+            self._macaroons[svc.name()] = {}
+        self._macaroons[svc.name()][name] = m
+
+    def _request_macaroons(self, svc):
+        mmap = self._macaroons.get(svc.name(), [])
+        # Put all the macaroons in the slice ordered by key
+        # so that we have deterministic behaviour in the tests.
+        names = []
+        for name in mmap:
+            names.append(name)
+        names = sorted(names)
+        ms = [None] * len(names)
+        for i, name in enumerate(names):
+            ms[i] = mmap[name]
+        return ms
+
+    def _discharge_all(self, ctx, m):
+        def get_discharge(cav, payload):
+            d = self._dischargers.get(cav.location)
+            if d is None:
+                raise ValueError('third party discharger '
+                                 '{} not found'.format(cav.location))
+            return d.discharge(ctx, cav, payload)
+
+        return bakery.discharge_all(m, get_discharge)
+
+
+class _BasicAuthIdService(bakery.IdentityClient):
+    def identity_from_context(self, ctx):
+        user, pwd = _basic_auth_from_context(ctx)
+        if user != 'sherlock' or pwd != 'holmes':
+            return None, None
+        return bakery.SimpleIdentity(user), None
+
+    def declared_identity(self, ctx, declared):
+        raise bakery.IdentityError('no identity declarations in basic auth'
+                                   ' id service')
+
+
+_BASIC_AUTH_KEY = checkers.ContextKey('user-key')
+
+
+class _BasicAuth(object):
+    def __init__(self, user, password):
+        self.user = user
+        self.password = password
+
+
+def _context_with_basic_auth(ctx, user, password):
+    return ctx.with_value(_BASIC_AUTH_KEY, _BasicAuth(user, password))
+
+
+def _basic_auth_from_context(ctx):
+    auth = ctx.get(_BASIC_AUTH_KEY, _BasicAuth('', ''))
+    return auth.user, auth.password
+
+
+def _macaroon_conditions(caveats, allow_third):
+    conds = [''] * len(caveats)
+    for i, cav in enumerate(caveats):
+        if cav.location is not None and cav.location != '':
+            if not allow_third:
+                raise ValueError('found unexpected third party caveat:'
+                                 ' {}'.format(cav.location))
+            continue
+        conds[i] = cav.caveat_id.decode('utf-8')
+    return conds
+
+
+def _resolve_caveats(ns, caveats):
+    conds = [''] * len(caveats)
+    for i, cav in enumerate(caveats):
+        if cav.location is not None and cav.location != '':
+            raise ValueError('found unexpected third party caveat')
+        conds[i] = ns.resolve_caveat(cav).condition
+    return conds
+
+
+class _MacaroonStoreWithError(object):
+    def new_macaroon(self, caveats, ns, ops):
+        raise ValueError('some error')
+
+    def macaroon_ops(self, ms):
+        raise ValueError('some error')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checkers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checkers.py
new file mode 100644
index 0000000000000000000000000000000000000000..2628153910b1696d729b8c11321409d158d93f31
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_checkers.py
@@ -0,0 +1,354 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from datetime import datetime, timedelta
+from unittest import TestCase
+
+import macaroonbakery.checkers as checkers
+import six
+from pymacaroons import MACAROON_V2, Macaroon
+
+# A frozen time for the tests.
+NOW = datetime(
+    year=2006, month=1, day=2, hour=15, minute=4, second=5, microsecond=123)
+
+
+class TestClock():
+    def utcnow(self):
+        return NOW
+
+
+class TestCheckers(TestCase):
+    def test_checkers(self):
+
+        tests = [
+            ('nothing in context, no extra checkers', [
+                ('something',
+                 'caveat "something" not satisfied: caveat not recognized'),
+                ('', 'cannot parse caveat "": empty caveat'),
+                (' hello', 'cannot parse caveat " hello": caveat starts with'
+                           ' space character'),
+            ], None),
+            ('one failed caveat', [
+                ('t:a aval', None),
+                ('t:b bval', None),
+                ('t:a wrong', 'caveat "t:a wrong" not satisfied: wrong arg'),
+            ], None),
+            ('time from clock', [
+                (checkers.time_before_caveat(
+                    datetime.utcnow() +
+                    timedelta(0, 1)).condition,
+                 None),
+                (checkers.time_before_caveat(NOW).condition,
+                 'caveat "time-before 2006-01-02T15:04:05.000123Z" '
+                 'not satisfied: macaroon has expired'),
+                (checkers.time_before_caveat(NOW - timedelta(0, 1)).condition,
+                 'caveat "time-before 2006-01-02T15:04:04.000123Z" '
+                 'not satisfied: macaroon has expired'),
+                ('time-before bad-date',
+                 'caveat "time-before bad-date" not satisfied: '
+                 'cannot parse "bad-date" as RFC 3339'),
+                (checkers.time_before_caveat(NOW).condition + " ",
+                 'caveat "time-before 2006-01-02T15:04:05.000123Z " '
+                 'not satisfied: '
+                 'cannot parse "2006-01-02T15:04:05.000123Z " as RFC 3339'),
+            ], lambda x: checkers.context_with_clock(ctx, TestClock())),
+            ('real time', [
+                (checkers.time_before_caveat(datetime(
+                    year=2010, month=1, day=1)).condition,
+                 'caveat "time-before 2010-01-01T00:00:00.000000Z" not '
+                 'satisfied: macaroon has expired'),
+                (checkers.time_before_caveat(datetime(
+                    year=3000, month=1, day=1)).condition, None),
+            ], None),
+            ('declared, no entries', [
+                (checkers.declared_caveat('a', 'aval').condition,
+                 'caveat "declared a aval" not satisfied: got a=null, '
+                 'expected "aval"'),
+                (checkers.COND_DECLARED, 'caveat "declared" not satisfied: '
+                                         'declared caveat has no value'),
+            ], None),
+            ('declared, some entries', [
+                (checkers.declared_caveat('a', 'aval').condition, None),
+                (checkers.declared_caveat('b', 'bval').condition, None),
+                (checkers.declared_caveat('spc', ' a b').condition, None),
+                (checkers.declared_caveat('a', 'bval').condition,
+                 'caveat "declared a bval" not satisfied: '
+                 'got a="aval", expected "bval"'),
+                (checkers.declared_caveat('a', ' aval').condition,
+                 'caveat "declared a  aval" not satisfied: '
+                 'got a="aval", expected " aval"'),
+                (checkers.declared_caveat('spc', 'a b').condition,
+                 'caveat "declared spc a b" not satisfied: '
+                 'got spc=" a b", expected "a b"'),
+                (checkers.declared_caveat('', 'a b').condition,
+                 'caveat "error invalid caveat \'declared\' key """ '
+                 'not satisfied: bad caveat'),
+                (checkers.declared_caveat('a b', 'a b').condition,
+                 'caveat "error invalid caveat \'declared\' key "a b"" '
+                 'not satisfied: bad caveat'),
+            ], lambda x: checkers.context_with_declared(x, {
+                'a': 'aval',
+                'b': 'bval',
+                'spc': ' a b'})),
+        ]
+        checker = checkers.Checker()
+        checker.namespace().register('testns', 't')
+        checker.register('a', 'testns', arg_checker(self, 't:a', 'aval'))
+        checker.register('b', 'testns', arg_checker(self, 't:b', 'bval'))
+        ctx = checkers.AuthContext()
+        for test in tests:
+            print(test[0])
+            if test[2] is not None:
+                ctx1 = test[2](ctx)
+            else:
+                ctx1 = ctx
+            for check in test[1]:
+                err = checker.check_first_party_caveat(ctx1, check[0])
+                if check[1] is not None:
+                    self.assertEqual(err, check[1])
+                else:
+                    self.assertIsNone(err)
+
+    def test_infer_declared(self):
+        tests = [
+            ('no macaroons', [], {}, None),
+            ('single macaroon with one declaration', [
+                [checkers.Caveat(condition='declared foo bar')]
+            ], {'foo': 'bar'}, None),
+            ('only one argument to declared', [
+                [checkers.Caveat(condition='declared foo')]
+            ], {}, None),
+            ('spaces in value', [
+                [checkers.Caveat(condition='declared foo bar bloggs')]
+            ], {'foo': 'bar bloggs'}, None),
+            ('attribute with declared prefix', [
+                [checkers.Caveat(condition='declaredccf foo')]
+            ], {}, None),
+            ('several macaroons with different declares', [
+                [
+                    checkers.declared_caveat('a', 'aval'),
+                    checkers.declared_caveat('b', 'bval')
+                ], [
+                    checkers.declared_caveat('c', 'cval'),
+                    checkers.declared_caveat('d', 'dval')
+                ]
+            ], {'a': 'aval', 'b': 'bval', 'c': 'cval', 'd': 'dval'}, None),
+            ('duplicate values', [
+                [
+                    checkers.declared_caveat('a', 'aval'),
+                    checkers.declared_caveat('a', 'aval'),
+                    checkers.declared_caveat('b', 'bval')
+                ], [
+                    checkers.declared_caveat('a', 'aval'),
+                    checkers.declared_caveat('b', 'bval'),
+                    checkers.declared_caveat('c', 'cval'),
+                    checkers.declared_caveat('d', 'dval')
+                ]
+            ], {'a': 'aval', 'b': 'bval', 'c': 'cval', 'd': 'dval'}, None),
+            ('conflicting values', [
+                [
+                    checkers.declared_caveat('a', 'aval'),
+                    checkers.declared_caveat('a', 'conflict'),
+                    checkers.declared_caveat('b', 'bval')
+                ], [
+                    checkers.declared_caveat('a', 'conflict'),
+                    checkers.declared_caveat('b', 'another conflict'),
+                    checkers.declared_caveat('c', 'cval'),
+                    checkers.declared_caveat('d', 'dval')
+                ]
+            ], {'c': 'cval', 'd': 'dval'}, None),
+            ('third party caveats ignored', [
+                [checkers.Caveat(condition='declared a no conflict',
+                                 location='location')],
+                [checkers.declared_caveat('a', 'aval')]
+            ], {'a': 'aval'}, None),
+            ('unparseable caveats ignored', [
+                [checkers.Caveat(condition=' bad')],
+                [checkers.declared_caveat('a', 'aval')]
+            ], {'a': 'aval'}, None),
+            ('infer with namespace', [
+                [
+                    checkers.declared_caveat('a', 'aval'),
+                    caveat_with_ns(checkers.declared_caveat('a', 'aval'),
+                                   'testns'),
+                ]
+            ], {'a': 'aval'}, None),
+        ]
+        for test in tests:
+            uri_to_prefix = test[3]
+            if uri_to_prefix is None:
+                uri_to_prefix = {checkers.STD_NAMESPACE: ''}
+            ns = checkers.Namespace(uri_to_prefix)
+            print(test[0])
+            ms = []
+            for i, caveats in enumerate(test[1]):
+                m = Macaroon(key=None, identifier=six.int2byte(i), location='',
+                             version=MACAROON_V2)
+                for cav in caveats:
+                    cav = ns.resolve_caveat(cav)
+                    if cav.location == '':
+                        m.add_first_party_caveat(cav.condition)
+                    else:
+                        m.add_third_party_caveat(cav.location, None,
+                                                 cav.condition)
+                ms.append(m)
+            self.assertEqual(checkers.infer_declared(ms), test[2])
+
+    def test_operations_checker(self):
+        tests = [
+            ('all allowed', checkers.allow_caveat(
+                ['op1', 'op2', 'op4', 'op3']),
+             ['op1', 'op3', 'op2'], None),
+            ('none denied', checkers.deny_caveat(['op1', 'op2']),
+             ['op3', 'op4'], None),
+            ('one not allowed', checkers.allow_caveat(['op1', 'op2']),
+             ['op1', 'op3'],
+             'caveat "allow op1 op2" not satisfied: op3 not allowed'),
+            ('one not denied', checkers.deny_caveat(['op1', 'op2']),
+             ['op4', 'op5', 'op2'],
+             'caveat "deny op1 op2" not satisfied: op2 not allowed'),
+            ('no operations, allow caveat', checkers.allow_caveat(['op1']),
+             [],
+             'caveat "allow op1" not satisfied: op1 not allowed'),
+            ('no operations, deny caveat', checkers.deny_caveat(['op1']),
+             [], None),
+            ('no operations, empty allow caveat', checkers.Caveat(
+                condition=checkers.COND_ALLOW),
+             [], 'caveat "allow" not satisfied: no operations allowed'),
+        ]
+        checker = checkers.Checker()
+        for test in tests:
+            print(test[0])
+            ctx = checkers.context_with_operations(checkers.AuthContext(),
+                                                   test[2])
+            err = checker.check_first_party_caveat(ctx, test[1].condition)
+            if test[3] is None:
+                self.assertIsNone(err)
+                continue
+            self.assertEqual(err, test[3])
+
+    def test_operation_error_caveat(self):
+        tests = [
+            ('empty allow', checkers.allow_caveat(None),
+             'error no operations allowed'),
+            ('allow: invalid operation name',
+             checkers.allow_caveat(['op1', 'operation number 2']),
+             'error invalid operation name "operation number 2"'),
+            ('deny: invalid operation name',
+             checkers.deny_caveat(['op1', 'operation number 2']),
+             'error invalid operation name "operation number 2"')
+        ]
+        for test in tests:
+            print(test[0])
+            self.assertEqual(test[1].condition, test[2])
+
+    def test_register_none_func_raise_exception(self):
+        checker = checkers.Checker()
+        with self.assertRaises(checkers.RegisterError) as ctx:
+            checker.register('x', checkers.STD_NAMESPACE, None)
+        self.assertEqual(ctx.exception.args[0],
+                         'no check function registered for namespace std when '
+                         'registering condition x')
+
+    def test_register_no_registered_ns_exception(self):
+        checker = checkers.Checker()
+        with self.assertRaises(checkers.RegisterError) as ctx:
+            checker.register('x', 'testns', lambda x: None)
+        self.assertEqual(ctx.exception.args[0],
+                         'no prefix registered for namespace testns when '
+                         'registering condition x')
+
+    def test_register_empty_prefix_condition_with_colon(self):
+        checker = checkers.Checker()
+        checker.namespace().register('testns', '')
+        with self.assertRaises(checkers.RegisterError) as ctx:
+            checker.register('x:y', 'testns', lambda x: None)
+        self.assertEqual(ctx.exception.args[0],
+                         'caveat condition x:y in namespace testns contains a '
+                         'colon but its prefix is empty')
+
+    def test_register_twice_same_namespace(self):
+        checker = checkers.Checker()
+        checker.namespace().register('testns', '')
+        checker.register('x', 'testns', lambda x: None)
+        with self.assertRaises(checkers.RegisterError) as ctx:
+            checker.register('x', 'testns', lambda x: None)
+        self.assertEqual(ctx.exception.args[0],
+                         'checker for x (namespace testns) already registered'
+                         ' in namespace testns')
+
+    def test_register_twice_different_namespace(self):
+        checker = checkers.Checker()
+        checker.namespace().register('testns', '')
+        checker.namespace().register('otherns', '')
+        checker.register('x', 'testns', lambda x: None)
+        with self.assertRaises(checkers.RegisterError) as ctx:
+            checker.register('x', 'otherns', lambda x: None)
+        self.assertEqual(ctx.exception.args[0],
+                         'checker for x (namespace otherns) already registered'
+                         ' in namespace testns')
+
+    def test_checker_info(self):
+        checker = checkers.Checker(include_std_checkers=False)
+        checker.namespace().register('one', 't')
+        checker.namespace().register('two', 't')
+        checker.namespace().register('three', '')
+        checker.namespace().register('four', 's')
+
+        class Called(object):
+            val = ''
+
+        def register(name, ns):
+            def func(ctx, cond, arg):
+                Called.val = name + ' ' + ns
+                return None
+
+            checker.register(name, ns, func)
+
+        register('x', 'one')
+        register('y', 'one')
+        register('z', 'two')
+        register('a', 'two')
+        register('something', 'three')
+        register('other', 'three')
+        register('xxx', 'four')
+
+        expect = [
+            checkers.CheckerInfo(ns='four', name='xxx', prefix='s'),
+            checkers.CheckerInfo(ns='one', name='x', prefix='t'),
+            checkers.CheckerInfo(ns='one', name='y', prefix='t'),
+            checkers.CheckerInfo(ns='three', name='other', prefix=''),
+            checkers.CheckerInfo(ns='three', name='something', prefix=''),
+            checkers.CheckerInfo(ns='two', name='a', prefix='t'),
+            checkers.CheckerInfo(ns='two', name='z', prefix='t'),
+        ]
+        infos = checker.info()
+        self.assertEqual(len(infos), len(expect))
+        new_infos = []
+        for i, info in enumerate(infos):
+            Called.val = ''
+            info.check(None, '', '')
+            self.assertEqual(Called.val, expect[i].name + ' '
+                             + expect[i].ns)
+            new_infos.append(checkers.CheckerInfo(ns=info.ns, name=info.name,
+                                                  prefix=info.prefix))
+        self.assertEqual(new_infos, expect)
+
+
+def caveat_with_ns(cav, ns):
+    return checkers.Caveat(location=cav.location, condition=cav.condition,
+                           namespace=ns)
+
+
+def arg_checker(test, expect_cond, check_arg):
+    ''' Returns a checker function that checks that the caveat condition is
+    check_arg.
+    '''
+
+    def func(ctx, cond, arg):
+        test.assertEqual(cond, expect_cond)
+        if arg != check_arg:
+            return 'wrong arg'
+        return None
+
+    return func
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_client.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_client.py
new file mode 100644
index 0000000000000000000000000000000000000000..6437a5412de036f519219228c1e343cb9c74284a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_client.py
@@ -0,0 +1,682 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+import datetime
+import json
+import threading
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import macaroonbakery.httpbakery as httpbakery
+import pymacaroons
+import requests
+import macaroonbakery._utils as utils
+
+from fixtures import (
+    EnvironmentVariable,
+    TestWithFixtures,
+)
+from httmock import HTTMock, urlmatch
+from six.moves.urllib.parse import parse_qs
+from six.moves.urllib.request import Request
+
+try:
+    from BaseHTTPServer import HTTPServer, BaseHTTPRequestHandler
+except ImportError:
+    from http.server import HTTPServer, BaseHTTPRequestHandler
+
+AGES = datetime.datetime.utcnow() + datetime.timedelta(days=1)
+TEST_OP = bakery.Op(entity='test', action='test')
+
+
+class TestClient(TestWithFixtures):
+    def setUp(self):
+        super(TestClient, self).setUp()
+        # http_proxy would cause requests to talk to the proxy, which is
+        # unlikely to know how to talk to the test server.
+        self.useFixture(EnvironmentVariable('http_proxy'))
+        self.useFixture(EnvironmentVariable('HTTP_PROXY'))
+
+    def test_single_service_first_party(self):
+        b = new_bakery('loc', None, None)
+
+        def handler(*args):
+            GetHandler(b, None, None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            srv_macaroon = b.oven.macaroon(
+                version=bakery.LATEST_VERSION, expiry=AGES,
+                caveats=None, ops=[TEST_OP])
+            self.assertEquals(srv_macaroon.macaroon.location, 'loc')
+            client = httpbakery.Client()
+            client.cookies.set_cookie(requests.cookies.create_cookie(
+                'macaroon-test', base64.b64encode(json.dumps([
+                    srv_macaroon.to_dict().get('m')
+                ]).encode('utf-8')).decode('utf-8')
+            ))
+            resp = requests.get(
+                url='http://' + httpd.server_address[0] + ':' +
+                    str(httpd.server_address[1]),
+                cookies=client.cookies, auth=client.auth())
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_single_service_third_party(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            self.assertEqual(url.path, '/discharge')
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            m = httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                     alwaysOK3rd)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            server_url = 'http://' + httpd.server_address[0] + ':' + str(httpd.server_address[1])
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                resp = requests.get(
+                    url=server_url,
+                    cookies=client.cookies,
+                    auth=client.auth())
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_single_service_third_party_with_path(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4/some/path':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            self.assertEqual(url.path, '/some/path/discharge')
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            m = httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                     alwaysOK3rd)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4/some/path', None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            server_url = 'http://' + httpd.server_address[0] + ':' + str(httpd.server_address[1])
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                resp = requests.get(
+                    url=server_url,
+                    cookies=client.cookies,
+                    auth=client.auth())
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_single_service_third_party_version_1_caveat(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.VERSION_1,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            m = httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                     alwaysOK3rd)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            server_url = 'http://' + httpd.server_address[0] + ':' + str(httpd.server_address[1])
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                resp = requests.get(
+                    url=server_url,
+                    cookies=client.cookies,
+                    auth=client.auth())
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_cookie_domain_host_not_fqdn(self):
+        # See
+        # https://github.com/go-macaroon-bakery/py-macaroon-bakery/issues/53
+
+        b = new_bakery('loc', None, None)
+
+        def handler(*args):
+            GetHandler(b, None, None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            srv_macaroon = b.oven.macaroon(
+                version=bakery.LATEST_VERSION, expiry=AGES,
+                caveats=None, ops=[TEST_OP])
+            self.assertEquals(srv_macaroon.macaroon.location, 'loc')
+            client = httpbakery.Client()
+            # Note: by using "localhost" instead of the presumably numeric address held
+            # in httpd.server_address, we're triggering the no-FQDN logic in the cookie
+            # code.
+            resp = requests.get(
+                url='http://localhost:' + str(httpd.server_address[1]),
+                cookies=client.cookies, auth=client.auth())
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        except httpbakery.BakeryException:
+            pass  # interacion required exception is expected
+        finally:
+            httpd.shutdown()
+
+        # the cookie has the .local domain appended
+        [cookie] = client.cookies
+        self.assertEqual(cookie.name, 'macaroon-test')
+        self.assertEqual(cookie.domain, 'localhost.local')
+
+    def test_single_party_with_header(self):
+        b = new_bakery('loc', None, None)
+
+        def handler(*args):
+            GetHandler(b, None, None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            srv_macaroon = b.oven.macaroon(
+                version=bakery.LATEST_VERSION,
+                expiry=AGES, caveats=None, ops=[TEST_OP])
+            self.assertEquals(srv_macaroon.macaroon.location, 'loc')
+            headers = {
+                'Macaroons': base64.b64encode(json.dumps([
+                    srv_macaroon.to_dict().get('m')
+                ]).encode('utf-8'))
+            }
+            resp = requests.get(
+                url='http://' + httpd.server_address[0] + ':' +
+                    str(httpd.server_address[1]),
+                headers=headers)
+            resp.raise_for_status()
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_expiry_cookie_is_set(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            m = httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                     alwaysOK3rd)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        ages = datetime.datetime.utcnow() + datetime.timedelta(days=1)
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, ages, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                resp = requests.get(
+                    url='http://' + httpd.server_address[0] + ':' +
+                        str(httpd.server_address[1]),
+                    cookies=client.cookies,
+                    auth=client.auth())
+            resp.raise_for_status()
+            m = bakery.Macaroon.from_dict(json.loads(
+                base64.b64decode(client.cookies.get('macaroon-test')).decode('utf-8'))[0])
+            t = checkers.macaroons_expiry_time(
+                checkers.Namespace(), [m.macaroon])
+            self.assertEquals(ages, t)
+            self.assertEquals(resp.text, 'done')
+        finally:
+            httpd.shutdown()
+
+    def test_expiry_cookie_set_in_past(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            m = httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                     alwaysOK3rd)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': m.to_dict()
+                }
+            }
+
+        ages = datetime.datetime.utcnow() - datetime.timedelta(days=1)
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, ages, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                with self.assertRaises(httpbakery.BakeryException) as ctx:
+                    requests.get(
+                        url='http://' + httpd.server_address[0] + ':' +
+                            str(httpd.server_address[1]),
+                        cookies=client.cookies,
+                        auth=client.auth())
+            self.assertEqual(ctx.exception.args[0],
+                             'too many (3) discharge requests')
+        finally:
+            httpd.shutdown()
+
+    def test_too_many_discharge(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            wrong_macaroon = bakery.Macaroon(
+                root_key=b'some key', id=b'xxx',
+                location='some other location',
+                version=bakery.VERSION_0)
+            return {
+                'status_code': 200,
+                'content': {
+                    'Macaroon': wrong_macaroon.to_dict()
+                }
+            }
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                with self.assertRaises(httpbakery.BakeryException) as ctx:
+                    requests.get(
+                        url='http://' + httpd.server_address[0] + ':' +
+                            str(httpd.server_address[1]),
+                        cookies=client.cookies,
+                        auth=client.auth())
+            self.assertEqual(ctx.exception.args[0],
+                             'too many (3) discharge requests')
+        finally:
+            httpd.shutdown()
+
+    def test_third_party_discharge_refused(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+
+        def check(cond, arg):
+            raise bakery.ThirdPartyCaveatCheckFailed('boo! cond' + cond)
+
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            qs = parse_qs(request.body)
+            content = {q: qs[q][0] for q in qs}
+            httpbakery.discharge(checkers.AuthContext(), content, d.key, d,
+                                 ThirdPartyCaveatCheckerF(check))
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, AGES, *args)
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+            client = httpbakery.Client()
+            with HTTMock(discharge):
+                with self.assertRaises(bakery.ThirdPartyCaveatCheckFailed):
+                    requests.get(
+                        url='http://' + httpd.server_address[0] + ':' +
+                            str(httpd.server_address[1]),
+                        cookies=client.cookies,
+                        auth=client.auth())
+        finally:
+            httpd.shutdown()
+
+    def test_discharge_with_interaction_required_error(self):
+        class _DischargerLocator(bakery.ThirdPartyLocator):
+            def __init__(self):
+                self.key = bakery.generate_key()
+
+            def third_party_info(self, loc):
+                if loc == 'http://1.2.3.4':
+                    return bakery.ThirdPartyInfo(
+                        public_key=self.key.public_key,
+                        version=bakery.LATEST_VERSION,
+                    )
+        d = _DischargerLocator()
+        b = new_bakery('loc', d, None)
+
+        @urlmatch(path='.*/discharge')
+        def discharge(url, request):
+            return {
+                'status_code': 401,
+                'content': {
+                    'Code': httpbakery.ERR_INTERACTION_REQUIRED,
+                    'Message': 'interaction required',
+                    'Info': {
+                        'WaitURL': 'http://0.1.2.3/',
+                        'VisitURL': 'http://0.1.2.3/',
+                    },
+                }
+            }
+
+        def handler(*args):
+            GetHandler(b, 'http://1.2.3.4', None, None, None, AGES, *args)
+
+        try:
+            httpd = HTTPServer(('', 0), handler)
+            thread = threading.Thread(target=httpd.serve_forever)
+            thread.start()
+
+            class MyInteractor(httpbakery.LegacyInteractor):
+                def legacy_interact(self, ctx, location, visit_url):
+                    raise httpbakery.InteractionError('cannot visit')
+
+                def interact(self, ctx, location, interaction_required_err):
+                    pass
+
+                def kind(self):
+                    return httpbakery.WEB_BROWSER_INTERACTION_KIND
+
+            client = httpbakery.Client(interaction_methods=[MyInteractor()])
+
+            with HTTMock(discharge):
+                with self.assertRaises(httpbakery.InteractionError):
+                    requests.get(
+                        'http://' + httpd.server_address[0] + ':' + str(
+                            httpd.server_address[1]),
+                        cookies=client.cookies,
+                        auth=client.auth())
+        finally:
+            httpd.shutdown()
+
+    def test_extract_macaroons_from_request(self):
+        def encode_macaroon(m):
+            macaroons = '[' + utils.macaroon_to_json_string(m) + ']'
+            return base64.urlsafe_b64encode(utils.to_bytes(macaroons)).decode('ascii')
+
+        req = Request('http://example.com')
+        m1 = pymacaroons.Macaroon(version=pymacaroons.MACAROON_V2, identifier='one')
+        req.add_header('Macaroons', encode_macaroon(m1))
+        m2 = pymacaroons.Macaroon(version=pymacaroons.MACAROON_V2, identifier='two')
+        jar = requests.cookies.RequestsCookieJar()
+        jar.set_cookie(utils.cookie(
+            name='macaroon-auth',
+            value=encode_macaroon(m2),
+            url='http://example.com',
+        ))
+        jar.set_cookie(utils.cookie(
+            name='macaroon-empty',
+            value='',
+            url='http://example.com',
+        ))
+        jar.add_cookie_header(req)
+
+        macaroons = httpbakery.extract_macaroons(req)
+        self.assertEquals(len(macaroons), 2)
+        macaroons.sort(key=lambda ms: ms[0].identifier)
+        self.assertEquals(macaroons[0][0].identifier, m1.identifier)
+        self.assertEquals(macaroons[1][0].identifier, m2.identifier)
+
+    def test_handle_error_cookie_path(self):
+        macaroon = bakery.Macaroon(
+            root_key=b'some key', id=b'xxx',
+            location='some location',
+            version=bakery.VERSION_0)
+        info = {
+            'Macaroon': macaroon.to_dict(),
+            'MacaroonPath': '.',
+            'CookieNameSuffix': 'test'
+        }
+        error = httpbakery.Error(
+            code=407,
+            message='error',
+            version=bakery.LATEST_VERSION,
+            info=httpbakery.ErrorInfo.from_dict(info))
+        client = httpbakery.Client()
+        client.handle_error(error, 'http://example.com/some/path')
+        [cookie] = client.cookies
+        self.assertEqual(cookie.path, "/some/")
+
+
+class GetHandler(BaseHTTPRequestHandler):
+    '''A mock HTTP server that serves a GET request'''
+    def __init__(self, bakery, auth_location, mutate_error,
+                 caveats, version, expiry, *args):
+        '''
+        @param bakery used to check incoming requests and macaroons
+        for discharge-required errors.
+        @param auth_location holds the location of any 3rd party
+        authorizer. If this is not None, a 3rd party caveat will be
+        added addressed to this location.
+        @param mutate_error if non None, will be called with any
+        discharge-required error before responding to the client.
+        @param caveats called to get caveats to add to the returned
+        macaroon.
+        @param version holds the version of the bakery that the
+        server will purport to serve.
+        @param expiry holds the expiry for the macaroon that will be created
+        in _write_discharge_error
+        '''
+        self._bakery = bakery
+        self._auth_location = auth_location
+        self._mutate_error = mutate_error
+        self._caveats = caveats
+        self._server_version = version
+        self._expiry = expiry
+        BaseHTTPRequestHandler.__init__(self, *args)
+
+    def do_GET(self):
+        '''do_GET implements a handler for the HTTP GET method'''
+        ctx = checkers.AuthContext()
+        auth_checker = self._bakery.checker.auth(
+            httpbakery.extract_macaroons(self.headers))
+        try:
+            auth_checker.allow(ctx, [TEST_OP])
+        except (bakery.PermissionDenied,
+                bakery.VerificationError) as exc:
+            return self._write_discharge_error(exc)
+        self.send_response(200)
+        self.end_headers()
+        content_len = int(self.headers.get('content-length', 0))
+        content = 'done'
+        if self.path != '/no-body'and content_len > 0:
+            body = self.rfile.read(content_len)
+            content = content + ' ' + body
+        self.wfile.write(content.encode('utf-8'))
+        return
+
+    def _write_discharge_error(self, exc):
+        version = httpbakery.request_version(self.headers)
+        if version < bakery.LATEST_VERSION:
+            self._server_version = version
+
+        caveats = []
+        if self._auth_location != '':
+            caveats = [
+                checkers.Caveat(location=self._auth_location,
+                                condition='is-ok')
+            ]
+        if self._caveats is not None:
+            caveats.extend(self._caveats)
+
+        m = self._bakery.oven.macaroon(
+            version=bakery.LATEST_VERSION, expiry=self._expiry,
+            caveats=caveats, ops=[TEST_OP])
+
+        content, headers = httpbakery.discharge_required_response(
+            m, '/', 'test', exc.args[0])
+        self.send_response(401)
+        for h in headers:
+            self.send_header(h, headers[h])
+        self.send_header('Connection', 'close')
+        self.end_headers()
+        self.wfile.write(content)
+
+
+def new_bakery(location, locator, checker):
+    '''Return a new bakery instance.
+    @param location Location of the bakery {str}.
+    @param locator Locator for third parties {ThirdPartyLocator or None}
+    @param checker Caveat checker {FirstPartyCaveatChecker or None}
+    @return {Bakery}
+    '''
+    if checker is None:
+        c = checkers.Checker()
+        c.namespace().register('testns', '')
+        c.register('is', 'testns', check_is_something)
+        checker = c
+    key = bakery.generate_key()
+    return bakery.Bakery(
+        location=location,
+        locator=locator,
+        key=key,
+        checker=checker,
+    )
+
+
+def is_something_caveat():
+    return checkers.Caveat(condition='is something', namespace='testns')
+
+
+def check_is_something(ctx, cond, arg):
+    if arg != 'something':
+        return '{} doesn\'t match "something"'.format(arg)
+    return None
+
+
+class ThirdPartyCaveatCheckerF(bakery.ThirdPartyCaveatChecker):
+    def __init__(self, check):
+        self._check = check
+
+    def check_third_party_caveat(self, ctx, info):
+        cond, arg = checkers.parse_caveat(info.condition)
+        return self._check(cond, arg)
+
+alwaysOK3rd = ThirdPartyCaveatCheckerF(lambda cond, arg: [])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_codec.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_codec.py
new file mode 100644
index 0000000000000000000000000000000000000000..d82a79432d8d626e1a833c42cf65b21476c4b169
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_codec.py
@@ -0,0 +1,196 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import base64
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import nacl.public
+import six
+from macaroonbakery.bakery import _codec as codec
+
+
+class TestCodec(TestCase):
+    def setUp(self):
+        self.fp_key = bakery.generate_key()
+        self.tp_key = bakery.generate_key()
+
+    def test_v1_round_trip(self):
+        tp_info = bakery.ThirdPartyInfo(
+            version=bakery.VERSION_1,
+            public_key=self.tp_key.public_key)
+        cid = bakery.encode_caveat(
+            'is-authenticated-user',
+            b'a random string',
+            tp_info,
+            self.fp_key,
+            None)
+        res = bakery.decode_caveat(self.tp_key, cid)
+        self.assertEquals(res, bakery.ThirdPartyCaveatInfo(
+            first_party_public_key=self.fp_key.public_key,
+            root_key=b'a random string',
+            condition='is-authenticated-user',
+            caveat=cid,
+            third_party_key_pair=self.tp_key,
+            version=bakery.VERSION_1,
+            id=None,
+            namespace=bakery.legacy_namespace()
+        ))
+
+    def test_v2_round_trip(self):
+        tp_info = bakery.ThirdPartyInfo(
+            version=bakery.VERSION_2,
+            public_key=self.tp_key.public_key)
+        cid = bakery.encode_caveat(
+            'is-authenticated-user',
+            b'a random string',
+            tp_info,
+            self.fp_key,
+            None)
+        res = bakery.decode_caveat(self.tp_key, cid)
+        self.assertEquals(res, bakery.ThirdPartyCaveatInfo(
+            first_party_public_key=self.fp_key.public_key,
+            root_key=b'a random string',
+            condition='is-authenticated-user',
+            caveat=cid,
+            third_party_key_pair=self.tp_key,
+            version=bakery.VERSION_2,
+            id=None,
+            namespace=bakery.legacy_namespace()
+        ))
+
+    def test_v3_round_trip(self):
+        tp_info = bakery.ThirdPartyInfo(
+            version=bakery.VERSION_3,
+            public_key=self.tp_key.public_key)
+        ns = checkers.Namespace()
+        ns.register('testns', 'x')
+        cid = bakery.encode_caveat(
+            'is-authenticated-user',
+            b'a random string',
+            tp_info,
+            self.fp_key,
+            ns)
+        res = bakery.decode_caveat(self.tp_key, cid)
+        self.assertEquals(res, bakery.ThirdPartyCaveatInfo(
+            first_party_public_key=self.fp_key.public_key,
+            root_key=b'a random string',
+            condition='is-authenticated-user',
+            caveat=cid,
+            third_party_key_pair=self.tp_key,
+            version=bakery.VERSION_3,
+            id=None,
+            namespace=ns
+        ))
+
+    def test_empty_caveat_id(self):
+        with self.assertRaises(bakery.VerificationError) as context:
+            bakery.decode_caveat(self.tp_key, b'')
+        self.assertTrue('empty third party caveat' in str(context.exception))
+
+    def test_decode_caveat_v1_from_go(self):
+        tp_key = bakery.PrivateKey(
+            nacl.public.PrivateKey(base64.b64decode(
+                'TSpvLpQkRj+T3JXnsW2n43n5zP/0X4zn0RvDiWC3IJ0=')))
+        fp_key = bakery.PrivateKey(
+            nacl.public.PrivateKey(base64.b64decode(
+                'KXpsoJ9ujZYi/O2Cca6kaWh65MSawzy79LWkrjOfzcs=')))
+        root_key = base64.b64decode('vDxEmWZEkgiNEFlJ+8ruXe3qDSLf1H+o')
+        # This caveat has been generated from the go code
+        # to check the compatibilty
+
+        encrypted_cav = six.b(
+            'eyJUaGlyZFBhcnR5UHVibGljS2V5IjoiOFA3R1ZZc3BlWlN4c'
+            '3hFdmJsSVFFSTFqdTBTSWl0WlIrRFdhWE40cmxocz0iLCJGaX'
+            'JzdFBhcnR5UHVibGljS2V5IjoiSDlqSFJqSUxidXppa1VKd2o'
+            '5VGtDWk9qeW5oVmtTdHVsaUFRT2d6Y0NoZz0iLCJOb25jZSI6'
+            'Ii9lWTRTTWR6TGFxbDlsRFc3bHUyZTZuSzJnVG9veVl0IiwiS'
+            'WQiOiJra0ZuOGJEaEt4RUxtUjd0NkJxTU0vdHhMMFVqaEZjR1'
+            'BORldUUExGdjVla1dWUjA4Uk1sbGJhc3c4VGdFbkhzM0laeVo'
+            '0V2lEOHhRUWdjU3ljOHY4eUt4dEhxejVEczJOYmh1ZDJhUFdt'
+            'UTVMcVlNWitmZ2FNaTAxdE9DIn0=')
+        cav = bakery.decode_caveat(tp_key, encrypted_cav)
+        self.assertEquals(cav, bakery.ThirdPartyCaveatInfo(
+            condition='caveat condition',
+            first_party_public_key=fp_key.public_key,
+            third_party_key_pair=tp_key,
+            root_key=root_key,
+            caveat=encrypted_cav,
+            version=bakery.VERSION_1,
+            id=None,
+            namespace=bakery.legacy_namespace()
+        ))
+
+    def test_decode_caveat_v2_from_go(self):
+        tp_key = bakery.PrivateKey(nacl.public.PrivateKey(
+            base64.b64decode(
+                'TSpvLpQkRj+T3JXnsW2n43n5zP/0X4zn0RvDiWC3IJ0=')))
+        fp_key = bakery.PrivateKey(
+            nacl.public.PrivateKey(base64.b64decode(
+                'KXpsoJ9ujZYi/O2Cca6kaWh65MSawzy79LWkrjOfzcs=')))
+        root_key = base64.b64decode('wh0HSM65wWHOIxoGjgJJOFvQKn2jJFhC')
+        # This caveat has been generated from the go code
+        # to check the compatibilty
+        encrypted_cav = bakery.b64decode(
+            'AvD-xlUf2MdGMgtu7OKRQnCP1OQJk6PKeFWRK26WIBA6DNwKGIHq9xGcHS9IZ'
+            'Lh0cL6D9qpeKI0mXmCPfnwRQDuVYC8y5gVWd-oCGZaj5TGtk3byp2Vnw6ojmt'
+            'sULDhY59YA_J_Y0ATkERO5T9ajoRWBxU2OXBoX6bImXA',
+        )
+        cav = bakery.decode_caveat(tp_key, encrypted_cav)
+        self.assertEqual(cav, bakery.ThirdPartyCaveatInfo(
+            condition='third party condition',
+            first_party_public_key=fp_key.public_key,
+            third_party_key_pair=tp_key,
+            root_key=root_key,
+            caveat=encrypted_cav,
+            version=bakery.VERSION_2,
+            id=None,
+            namespace=bakery.legacy_namespace()
+        ))
+
+    def test_decode_caveat_v3_from_go(self):
+        tp_key = bakery.PrivateKey(
+            nacl.public.PrivateKey(base64.b64decode(
+                'TSpvLpQkRj+T3JXnsW2n43n5zP/0X4zn0RvDiWC3IJ0=')))
+        fp_key = bakery.PrivateKey(nacl.public.PrivateKey(
+            base64.b64decode(
+                'KXpsoJ9ujZYi/O2Cca6kaWh65MSawzy79LWkrjOfzcs=')))
+        root_key = base64.b64decode(b'oqOXI3/Mz/pKjCuFOt2eYxb7ndLq66GY')
+        # This caveat has been generated from the go code
+        # to check the compatibilty
+        encrypted_cav = bakery.b64decode(
+            'A_D-xlUf2MdGMgtu7OKRQnCP1OQJk6PKeFWRK26WIBA6DNwKGNLeFSkD2M-8A'
+            'EYvmgVH95GWu7T7caKxKhhOQFcEKgnXKJvYXxz1zin4cZc4Q6C7gVqA-J4_j3'
+            '1LX4VKxymqG62UGPo78wOv0_fKjr3OI6PPJOYOQgBMclemlRF2',
+        )
+        cav = bakery.decode_caveat(tp_key, encrypted_cav)
+        self.assertEquals(cav, bakery.ThirdPartyCaveatInfo(
+            condition='third party condition',
+            first_party_public_key=fp_key.public_key,
+            third_party_key_pair=tp_key,
+            root_key=root_key,
+            caveat=encrypted_cav,
+            version=bakery.VERSION_3,
+            id=None,
+            namespace=bakery.legacy_namespace()
+        ))
+
+    def test_encode_decode_varint(self):
+        tests = [
+            (12, [12]),
+            (127, [127]),
+            (128, [128, 1]),
+            (129, [129, 1]),
+            (1234567, [135, 173, 75]),
+            (12131231231312, [208, 218, 233, 173, 136, 225, 2])
+        ]
+        for test in tests:
+            data = bytearray()
+            expected = bytearray()
+            bakery.encode_uvarint(test[0], data)
+            for v in test[1]:
+                expected.append(v)
+            self.assertEquals(data, expected)
+            val = codec.decode_uvarint(bytes(data))
+            self.assertEquals(test[0], val[0])
+            self.assertEquals(len(test[1]), val[1])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge.py
new file mode 100644
index 0000000000000000000000000000000000000000..5360317f9ef8368aa4a41e3af1b2bae4ba4d5c7f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge.py
@@ -0,0 +1,517 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import os
+import unittest
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+from macaroonbakery.tests import common
+from pymacaroons import MACAROON_V1, Macaroon
+
+
+class TestDischarge(unittest.TestCase):
+    def test_single_service_first_party(self):
+        ''' Creates a single service with a macaroon with one first party
+        caveat.
+        It creates a request with this macaroon and checks that the service
+        can verify this macaroon as valid.
+        '''
+        oc = common.new_bakery('bakerytest')
+        primary = oc.oven.macaroon(bakery.LATEST_VERSION,
+                                   common.ages, None,
+                                   [bakery.LOGIN_OP])
+        self.assertEqual(primary.macaroon.location, 'bakerytest')
+        primary.add_caveat(checkers.Caveat(condition='str something',
+                                           namespace='testns'),
+                           oc.oven.key, oc.oven.locator)
+        oc.checker.auth([[primary.macaroon]]).allow(
+            common.str_context('something'), [bakery.LOGIN_OP])
+
+    def test_macaroon_paper_fig6(self):
+        ''' Implements an example flow as described in the macaroons paper:
+        http://theory.stanford.edu/~ataly/Papers/macaroons.pdf
+        There are three services, ts, fs, bs:
+        ts is a store service which has deligated authority to a forum
+        service fs.
+        The forum service wants to require its users to be logged into to an
+        authentication service bs.
+
+        The client obtains a macaroon from fs (minted by ts, with a third party
+         caveat addressed to bs).
+        The client obtains a discharge macaroon from bs to satisfy this caveat.
+        The target service verifies the original macaroon it delegated to fs
+        No direct contact between bs and ts is required
+        '''
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+        ts = common.new_bakery('ts-loc', locator)
+        fs = common.new_bakery('fs-loc', locator)
+
+        # ts creates a macaroon.
+        ts_macaroon = ts.oven.macaroon(bakery.LATEST_VERSION,
+                                       common.ages,
+                                       None, [bakery.LOGIN_OP])
+
+        # ts somehow sends the macaroon to fs which adds a third party caveat
+        # to be discharged by bs.
+        ts_macaroon.add_caveat(checkers.Caveat(location='bs-loc',
+                                               condition='user==bob'),
+                               fs.oven.key, fs.oven.locator)
+
+        # client asks for a discharge macaroon for each third party caveat
+        def get_discharge(cav, payload):
+            self.assertEqual(cav.location, 'bs-loc')
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                bs.oven.key,
+                common.ThirdPartyStrcmpChecker('user==bob'),
+                bs.oven.locator,
+            )
+
+        d = bakery.discharge_all(ts_macaroon, get_discharge)
+
+        ts.checker.auth([d]).allow(common.test_context,
+                                   [bakery.LOGIN_OP])
+
+    def test_discharge_with_version1_macaroon(self):
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+        ts = common.new_bakery('ts-loc', locator)
+
+        # ts creates a old-version macaroon.
+        ts_macaroon = ts.oven.macaroon(bakery.VERSION_1, common.ages,
+                                       None, [bakery.LOGIN_OP])
+        ts_macaroon.add_caveat(checkers.Caveat(condition='something',
+                                               location='bs-loc'),
+                               ts.oven.key, ts.oven.locator)
+
+        # client asks for a discharge macaroon for each third party caveat
+
+        def get_discharge(cav, payload):
+            # Make sure that the caveat id really is old-style.
+            try:
+                cav.caveat_id_bytes.decode('utf-8')
+            except UnicodeDecodeError:
+                self.fail('caveat id is not utf-8')
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                bs.oven.key,
+                common.ThirdPartyStrcmpChecker('something'),
+                bs.oven.locator,
+            )
+
+        d = bakery.discharge_all(ts_macaroon, get_discharge)
+
+        ts.checker.auth([d]).allow(common.test_context,
+                                   [bakery.LOGIN_OP])
+
+        for m in d:
+            self.assertEqual(m.version, MACAROON_V1)
+
+    def test_version1_macaroon_id(self):
+        # In the version 1 bakery, macaroon ids were hex-encoded with a
+        # hyphenated UUID suffix.
+        root_key_store = bakery.MemoryKeyStore()
+        b = bakery.Bakery(
+            root_key_store=root_key_store,
+            identity_client=common.OneIdentity(),
+        )
+        key, id = root_key_store.root_key()
+        root_key_store.get(id)
+        m = Macaroon(key=key, version=MACAROON_V1, location='',
+                     identifier=id + b'-deadl00f')
+        b.checker.auth([[m]]).allow(common.test_context,
+                                    [bakery.LOGIN_OP])
+
+    def test_macaroon_paper_fig6_fails_without_discharges(self):
+        ''' Runs a similar test as test_macaroon_paper_fig6 without the client
+        discharging the third party caveats.
+        '''
+        locator = bakery.ThirdPartyStore()
+        ts = common.new_bakery('ts-loc', locator)
+        fs = common.new_bakery('fs-loc', locator)
+        common.new_bakery('as-loc', locator)
+
+        # ts creates a macaroon.
+        ts_macaroon = ts.oven.macaroon(bakery.LATEST_VERSION,
+                                       common.ages, None,
+                                       [bakery.LOGIN_OP])
+
+        # ts somehow sends the macaroon to fs which adds a third party
+        # caveat to be discharged by as.
+        ts_macaroon.add_caveat(checkers.Caveat(location='as-loc',
+                                               condition='user==bob'),
+                               fs.oven.key, fs.oven.locator)
+
+        # client makes request to ts
+        try:
+            ts.checker.auth([[ts_macaroon.macaroon]]).allow(
+                common.test_context,
+                bakery.LOGIN_OP
+            )
+            self.fail('macaroon unmet should be raised')
+        except bakery.PermissionDenied:
+            pass
+
+    def test_macaroon_paper_fig6_fails_with_binding_on_tampered_sig(self):
+        ''' Runs a similar test as test_macaroon_paper_fig6 with the discharge
+        macaroon binding being done on a tampered signature.
+        '''
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+        ts = common.new_bakery('ts-loc', locator)
+
+        # ts creates a macaroon.
+        ts_macaroon = ts.oven.macaroon(bakery.LATEST_VERSION,
+                                       common.ages, None,
+                                       [bakery.LOGIN_OP])
+        # ts somehow sends the macaroon to fs which adds a third party caveat
+        # to be discharged by as.
+        ts_macaroon.add_caveat(checkers.Caveat(condition='user==bob',
+                                               location='bs-loc'),
+                               ts.oven.key, ts.oven.locator)
+
+        # client asks for a discharge macaroon for each third party caveat
+        def get_discharge(cav, payload):
+            self.assertEqual(cav.location, 'bs-loc')
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                bs.oven.key,
+                common.ThirdPartyStrcmpChecker('user==bob'),
+                bs.oven.locator,
+            )
+
+        d = bakery.discharge_all(ts_macaroon, get_discharge)
+        # client has all the discharge macaroons. For each discharge macaroon
+        # bind it to our ts_macaroon and add it to our request.
+        tampered_macaroon = Macaroon()
+        for i, dm in enumerate(d[1:]):
+            d[i + 1] = tampered_macaroon.prepare_for_request(dm)
+
+        # client makes request to ts.
+        with self.assertRaises(bakery.PermissionDenied) as exc:
+            ts.checker.auth([d]).allow(common.test_context,
+                                       bakery.LOGIN_OP)
+        self.assertEqual('verification failed: Signatures do not match',
+                         exc.exception.args[0])
+
+    def test_need_declared(self):
+        locator = bakery.ThirdPartyStore()
+        first_party = common.new_bakery('first', locator)
+        third_party = common.new_bakery('third', locator)
+
+        # firstParty mints a macaroon with a third-party caveat addressed
+        # to thirdParty with a need-declared caveat.
+        m = first_party.oven.macaroon(
+            bakery.LATEST_VERSION, common.ages, [
+                checkers.need_declared_caveat(
+                    checkers.Caveat(location='third', condition='something'),
+                    ['foo', 'bar']
+                )
+            ], [bakery.LOGIN_OP])
+
+        # The client asks for a discharge macaroon for each third party caveat.
+        def get_discharge(cav, payload):
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key,
+                common.ThirdPartyStrcmpChecker('something'),
+                third_party.oven.locator,
+            )
+
+        d = bakery.discharge_all(m, get_discharge)
+
+        # The required declared attributes should have been added
+        # to the discharge macaroons.
+        declared = checkers.infer_declared(d, first_party.checker.namespace())
+        self.assertEqual(declared, {
+            'foo': '',
+            'bar': '',
+        })
+
+        # Make sure the macaroons actually check out correctly
+        # when provided with the declared checker.
+        ctx = checkers.context_with_declared(common.test_context, declared)
+        first_party.checker.auth([d]).allow(ctx, [bakery.LOGIN_OP])
+
+        # Try again when the third party does add a required declaration.
+
+        # The client asks for a discharge macaroon for each third party caveat.
+        def get_discharge(cav, payload):
+            checker = common.ThirdPartyCheckerWithCaveats([
+                checkers.declared_caveat('foo', 'a'),
+                checkers.declared_caveat('arble', 'b')
+            ])
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key,
+                checker,
+                third_party.oven.locator,
+            )
+
+        d = bakery.discharge_all(m, get_discharge)
+
+        # One attribute should have been added, the other was already there.
+        declared = checkers.infer_declared(d, first_party.checker.namespace())
+        self.assertEqual(declared, {
+            'foo': 'a',
+            'bar': '',
+            'arble': 'b',
+        })
+
+        ctx = checkers.context_with_declared(common.test_context, declared)
+        first_party.checker.auth([d]).allow(ctx, [bakery.LOGIN_OP])
+
+        # Try again, but this time pretend a client is sneakily trying
+        # to add another 'declared' attribute to alter the declarations.
+
+        def get_discharge(cav, payload):
+            checker = common.ThirdPartyCheckerWithCaveats([
+                checkers.declared_caveat('foo', 'a'),
+                checkers.declared_caveat('arble', 'b'),
+            ])
+
+            # Sneaky client adds a first party caveat.
+            m = bakery.discharge(
+                common.test_context, cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key, checker,
+                third_party.oven.locator,
+            )
+            m.add_caveat(checkers.declared_caveat('foo', 'c'), None, None)
+            return m
+
+        d = bakery.discharge_all(m, get_discharge)
+
+        declared = checkers.infer_declared(d, first_party.checker.namespace())
+        self.assertEqual(declared, {
+            'bar': '',
+            'arble': 'b',
+        })
+
+        with self.assertRaises(bakery.PermissionDenied) as exc:
+            first_party.checker.auth([d]).allow(common.test_context,
+                                                bakery.LOGIN_OP)
+        self.assertEqual('cannot authorize login macaroon: caveat '
+                         '"declared foo a" not satisfied: got foo=null, '
+                         'expected "a"', exc.exception.args[0])
+
+    def test_discharge_two_need_declared(self):
+        locator = bakery.ThirdPartyStore()
+        first_party = common.new_bakery('first', locator)
+        third_party = common.new_bakery('third', locator)
+
+        # first_party mints a macaroon with two third party caveats
+        # with overlapping attributes.
+        m = first_party.oven.macaroon(
+            bakery.LATEST_VERSION,
+            common.ages, [
+                checkers.need_declared_caveat(
+                    checkers.Caveat(location='third', condition='x'),
+                    ['foo', 'bar']),
+                checkers.need_declared_caveat(
+                    checkers.Caveat(location='third', condition='y'),
+                    ['bar', 'baz']),
+            ], [bakery.LOGIN_OP])
+
+        # The client asks for a discharge macaroon for each third party caveat.
+        # Since no declarations are added by the discharger,
+
+        def get_discharge(cav, payload):
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key,
+                common.ThirdPartyCaveatCheckerEmpty(),
+                third_party.oven.locator,
+            )
+
+        d = bakery.discharge_all(m, get_discharge)
+        declared = checkers.infer_declared(d, first_party.checker.namespace())
+        self.assertEqual(declared, {
+            'foo': '',
+            'bar': '',
+            'baz': '',
+        })
+        ctx = checkers.context_with_declared(common.test_context, declared)
+        first_party.checker.auth([d]).allow(ctx, [bakery.LOGIN_OP])
+
+        # If they return conflicting values, the discharge fails.
+        # The client asks for a discharge macaroon for each third party caveat.
+        # Since no declarations are added by the discharger,
+        class ThirdPartyCaveatCheckerF(bakery.ThirdPartyCaveatChecker):
+            def check_third_party_caveat(self, ctx, cav_info):
+                if cav_info.condition == 'x':
+                    return [checkers.declared_caveat('foo', 'fooval1')]
+                if cav_info.condition == 'y':
+                    return [
+                        checkers.declared_caveat('foo', 'fooval2'),
+                        checkers.declared_caveat('baz', 'bazval')
+                    ]
+                raise bakery.ThirdPartyCaveatCheckFailed('not matched')
+
+        def get_discharge(cav, payload):
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key,
+                ThirdPartyCaveatCheckerF(),
+                third_party.oven.locator,
+            )
+
+        d = bakery.discharge_all(m, get_discharge)
+
+        declared = checkers.infer_declared(d, first_party.checker.namespace())
+        self.assertEqual(declared, {
+            'bar': '',
+            'baz': 'bazval',
+        })
+        with self.assertRaises(bakery.PermissionDenied) as exc:
+            first_party.checker.auth([d]).allow(common.test_context,
+                                                bakery.LOGIN_OP)
+        self.assertEqual('cannot authorize login macaroon: caveat "declared '
+                         'foo fooval1" not satisfied: got foo=null, expected '
+                         '"fooval1"', exc.exception.args[0])
+
+    def test_discharge_macaroon_cannot_be_used_as_normal_macaroon(self):
+        locator = bakery.ThirdPartyStore()
+        first_party = common.new_bakery('first', locator)
+        third_party = common.new_bakery('third', locator)
+
+        # First party mints a macaroon with a 3rd party caveat.
+        m = first_party.oven.macaroon(bakery.LATEST_VERSION,
+                                      common.ages, [
+                                          checkers.Caveat(location='third',
+                                                          condition='true')],
+                                      [bakery.LOGIN_OP])
+
+        # Acquire the discharge macaroon, but don't bind it to the original.
+        class M:
+            unbound = None
+
+        def get_discharge(cav, payload):
+            m = bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                third_party.oven.key,
+                common.ThirdPartyStrcmpChecker('true'),
+                third_party.oven.locator,
+            )
+            M.unbound = m.macaroon.copy()
+            return m
+
+        bakery.discharge_all(m, get_discharge)
+        self.assertIsNotNone(M.unbound)
+
+        # Make sure it cannot be used as a normal macaroon in the third party.
+        with self.assertRaises(bakery.PermissionDenied) as exc:
+            third_party.checker.auth([[M.unbound]]).allow(
+                common.test_context, [bakery.LOGIN_OP])
+        self.assertEqual('no operations found in macaroon',
+                         exc.exception.args[0])
+
+    def test_third_party_discharge_macaroon_ids_are_small(self):
+        locator = bakery.ThirdPartyStore()
+        bakeries = {
+            'ts-loc': common.new_bakery('ts-loc', locator),
+            'as1-loc': common.new_bakery('as1-loc', locator),
+            'as2-loc': common.new_bakery('as2-loc', locator),
+        }
+        ts = bakeries['ts-loc']
+
+        ts_macaroon = ts.oven.macaroon(bakery.LATEST_VERSION,
+                                       common.ages,
+                                       None, [bakery.LOGIN_OP])
+        ts_macaroon.add_caveat(checkers.Caveat(condition='something',
+                                               location='as1-loc'),
+                               ts.oven.key, ts.oven.locator)
+
+        class ThirdPartyCaveatCheckerF(bakery.ThirdPartyCaveatChecker):
+            def __init__(self, loc):
+                self._loc = loc
+
+            def check_third_party_caveat(self, ctx, info):
+                if self._loc == 'as1-loc':
+                    return [checkers.Caveat(condition='something',
+                                            location='as2-loc')]
+                if self._loc == 'as2-loc':
+                    return []
+                raise bakery.ThirdPartyCaveatCheckFailed(
+                    'unknown location {}'.format(self._loc))
+
+        def get_discharge(cav, payload):
+            oven = bakeries[cav.location].oven
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                oven.key,
+                ThirdPartyCaveatCheckerF(cav.location),
+                oven.locator,
+            )
+
+        d = bakery.discharge_all(ts_macaroon, get_discharge)
+        ts.checker.auth([d]).allow(common.test_context,
+                                   [bakery.LOGIN_OP])
+
+        for i, m in enumerate(d):
+            for j, cav in enumerate(m.caveats):
+                if (cav.verification_key_id is not None and
+                        len(cav.caveat_id) > 3):
+                    self.fail('caveat id on caveat {} of macaroon {} '
+                              'is too big ({})'.format(j, i, cav.id))
+
+    def test_third_party_discharge_macaroon_wrong_root_key_and_third_party_caveat(self):
+
+        root_keys = bakery.MemoryKeyStore()
+        ts = bakery.Bakery(
+            key=bakery.generate_key(),
+            checker=common.test_checker(),
+            root_key_store=root_keys,
+            identity_client=common.OneIdentity(),
+        )
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+
+        # ts creates a macaroon with a third party caveat addressed to bs.
+        ts_macaroon = ts.oven.macaroon(bakery.LATEST_VERSION,
+                                       common.ages,
+                                       None, [bakery.LOGIN_OP])
+        ts_macaroon.add_caveat(
+            checkers.Caveat(location='bs-loc', condition='true'),
+            ts.oven.key, locator,
+        )
+
+        def get_discharge(cav, payload):
+            return bakery.discharge(
+                common.test_context,
+                cav.caveat_id_bytes,
+                payload,
+                bs.oven.key,
+                common.ThirdPartyStrcmpChecker('true'),
+                bs.oven.locator,
+            )
+
+        d = bakery.discharge_all(ts_macaroon, get_discharge)
+
+        # The authorization should succeed at first.
+        ts.checker.auth([d]).allow(common.test_context, [bakery.LOGIN_OP])
+        # Corrupt the root key and try again.
+        # We should get a DischargeRequiredError because the verification has failed.
+        root_keys._key = os.urandom(24)
+        with self.assertRaises(bakery.PermissionDenied) as err:
+            ts.checker.auth([d]).allow(common.test_context, [bakery.LOGIN_OP])
+        self.assertEqual(str(err.exception), 'verification failed: Decryption failed. Ciphertext failed verification')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge_all.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge_all.py
new file mode 100644
index 0000000000000000000000000000000000000000..cab8a072e3cc8484c9e1fa86a6fd8d18df5f073b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_discharge_all.py
@@ -0,0 +1,164 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import unittest
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+from macaroonbakery.tests import common
+from pymacaroons.verifier import Verifier
+
+
+def always_ok(predicate):
+    return True
+
+
+class TestDischargeAll(unittest.TestCase):
+    def test_discharge_all_no_discharges(self):
+        root_key = b'root key'
+        m = bakery.Macaroon(
+            root_key=root_key, id=b'id0', location='loc0',
+            version=bakery.LATEST_VERSION,
+            namespace=common.test_checker().namespace())
+        ms = bakery.discharge_all(m, no_discharge(self))
+        self.assertEqual(len(ms), 1)
+        self.assertEqual(ms[0], m.macaroon)
+        v = Verifier()
+        v.satisfy_general(always_ok)
+        v.verify(m.macaroon, root_key, None)
+
+    def test_discharge_all_many_discharges(self):
+        root_key = b'root key'
+        m0 = bakery.Macaroon(
+            root_key=root_key, id=b'id0', location='loc0',
+            version=bakery.LATEST_VERSION)
+
+        class State(object):
+            total_required = 40
+            id = 1
+
+        def add_caveats(m):
+            for i in range(0, 1):
+                if State.total_required == 0:
+                    break
+                cid = 'id{}'.format(State.id)
+                m.macaroon.add_third_party_caveat(
+                    location='somewhere',
+                    key='root key {}'.format(cid).encode('utf-8'),
+                    key_id=cid.encode('utf-8'))
+                State.id += 1
+                State.total_required -= 1
+
+        add_caveats(m0)
+
+        def get_discharge(cav, payload):
+            self.assertEqual(payload, None)
+            m = bakery.Macaroon(
+                root_key='root key {}'.format(
+                    cav.caveat_id.decode('utf-8')).encode('utf-8'),
+                id=cav.caveat_id, location='',
+                version=bakery.LATEST_VERSION)
+
+            add_caveats(m)
+            return m
+
+        ms = bakery.discharge_all(m0, get_discharge)
+
+        self.assertEqual(len(ms), 41)
+
+        v = Verifier()
+        v.satisfy_general(always_ok)
+        v.verify(ms[0], root_key, ms[1:])
+
+    def test_discharge_all_many_discharges_with_real_third_party_caveats(self):
+        # This is the same flow as TestDischargeAllManyDischarges except that
+        # we're using actual third party caveats as added by
+        # Macaroon.add_caveat and we use a larger number of caveats
+        # so that caveat ids will need to get larger.
+        locator = bakery.ThirdPartyStore()
+        bakeries = {}
+        total_discharges_required = 40
+
+        class M:
+            bakery_id = 0
+            still_required = total_discharges_required
+
+        def add_bakery():
+            M.bakery_id += 1
+            loc = 'loc{}'.format(M.bakery_id)
+            bakeries[loc] = common.new_bakery(loc, locator)
+            return loc
+
+        ts = common.new_bakery('ts-loc', locator)
+
+        def checker(_, ci):
+            caveats = []
+            if ci.condition != 'something':
+                self.fail('unexpected condition')
+            for i in range(0, 2):
+                if M.still_required <= 0:
+                    break
+                caveats.append(checkers.Caveat(location=add_bakery(),
+                                               condition='something'))
+                M.still_required -= 1
+            return caveats
+
+        root_key = b'root key'
+        m0 = bakery.Macaroon(
+            root_key=root_key, id=b'id0', location='ts-loc',
+            version=bakery.LATEST_VERSION)
+
+        m0.add_caveat(checkers. Caveat(location=add_bakery(),
+                                       condition='something'),
+                      ts.oven.key, locator)
+
+        # We've added a caveat (the first) so one less caveat is required.
+        M.still_required -= 1
+
+        class ThirdPartyCaveatCheckerF(bakery.ThirdPartyCaveatChecker):
+            def check_third_party_caveat(self, ctx, info):
+                return checker(ctx, info)
+
+        def get_discharge(cav, payload):
+            return bakery.discharge(
+                common.test_context, cav.caveat_id, payload,
+                bakeries[cav.location].oven.key,
+                ThirdPartyCaveatCheckerF(), locator)
+
+        ms = bakery.discharge_all(m0, get_discharge)
+
+        self.assertEqual(len(ms), total_discharges_required + 1)
+
+        v = Verifier()
+        v.satisfy_general(always_ok)
+        v.verify(ms[0], root_key, ms[1:])
+
+    def test_discharge_all_local_discharge(self):
+        oc = common.new_bakery('ts', None)
+        client_key = bakery.generate_key()
+        m = oc.oven.macaroon(bakery.LATEST_VERSION, common.ages,
+                             [
+                                 bakery.local_third_party_caveat(
+                                     client_key.public_key,
+                                     bakery.LATEST_VERSION)
+                             ], [bakery.LOGIN_OP])
+        ms = bakery.discharge_all(m, no_discharge(self), client_key)
+        oc.checker.auth([ms]).allow(common.test_context,
+                                    [bakery.LOGIN_OP])
+
+    def test_discharge_all_local_discharge_version1(self):
+        oc = common.new_bakery('ts', None)
+        client_key = bakery.generate_key()
+        m = oc.oven.macaroon(bakery.VERSION_1, common.ages, [
+            bakery.local_third_party_caveat(
+                client_key.public_key, bakery.VERSION_1)
+        ], [bakery.LOGIN_OP])
+        ms = bakery.discharge_all(m, no_discharge(self), client_key)
+        oc.checker.auth([ms]).allow(common.test_context,
+                                    [bakery.LOGIN_OP])
+
+
+def no_discharge(test):
+    def get_discharge(cav, payload):
+        test.fail("get_discharge called unexpectedly")
+
+    return get_discharge
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_httpbakery.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_httpbakery.py
new file mode 100644
index 0000000000000000000000000000000000000000..c372f13b052bb70ee9ef724a505e2dbe56726f08
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_httpbakery.py
@@ -0,0 +1,44 @@
+from unittest import TestCase
+
+import macaroonbakery.httpbakery as httpbakery
+import macaroonbakery.bakery as bakery
+
+
+class TestWebBrowserInteractionInfo(TestCase):
+
+    def test_from_dict(self):
+        info_dict = {
+            'VisitURL': 'https://example.com/visit',
+            'WaitTokenURL': 'https://example.com/wait'}
+        interaction_info = httpbakery.WebBrowserInteractionInfo.from_dict(info_dict)
+        self.assertEqual(
+            interaction_info.visit_url, 'https://example.com/visit')
+        self.assertEqual(
+            interaction_info.wait_token_url, 'https://example.com/wait')
+
+
+class TestError(TestCase):
+
+    def test_from_dict_upper_case_fields(self):
+        err = httpbakery.Error.from_dict({
+            'Message': 'm',
+            'Code': 'c',
+        })
+        self.assertEqual(err, httpbakery.Error(
+            code='c',
+            message='m',
+            info=None,
+            version=bakery.LATEST_VERSION,
+        ))
+
+    def test_from_dict_lower_case_fields(self):
+        err = httpbakery.Error.from_dict({
+            'message': 'm',
+            'code': 'c',
+        })
+        self.assertEqual(err, httpbakery.Error(
+            code='c',
+            message='m',
+            info=None,
+            version=bakery.LATEST_VERSION,
+        ))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_keyring.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_keyring.py
new file mode 100644
index 0000000000000000000000000000000000000000..35031450656a81ab5d85775b2d511290fe1e605a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_keyring.py
@@ -0,0 +1,111 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import unittest
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.httpbakery as httpbakery
+
+from httmock import HTTMock, urlmatch
+
+
+class TestKeyRing(unittest.TestCase):
+
+    def test_cache_fetch(self):
+        key = bakery.generate_key()
+
+        @urlmatch(path='.*/discharge/info')
+        def discharge_info(url, request):
+            return {
+                'status_code': 200,
+                'content': {
+                    'Version': bakery.LATEST_VERSION,
+                    'PublicKey': str(key.public_key),
+                }
+            }
+
+        expectInfo = bakery.ThirdPartyInfo(
+            public_key=key.public_key,
+            version=bakery.LATEST_VERSION
+        )
+        kr = httpbakery.ThirdPartyLocator(allow_insecure=True)
+        with HTTMock(discharge_info):
+            info = kr.third_party_info('http://0.1.2.3/')
+        self.assertEqual(info, expectInfo)
+
+    def test_cache_norefetch(self):
+        key = bakery.generate_key()
+
+        @urlmatch(path='.*/discharge/info')
+        def discharge_info(url, request):
+            return {
+                'status_code': 200,
+                'content': {
+                    'Version': bakery.LATEST_VERSION,
+                    'PublicKey': str(key.public_key),
+                }
+            }
+
+        expectInfo = bakery.ThirdPartyInfo(
+            public_key=key.public_key,
+            version=bakery.LATEST_VERSION
+        )
+        kr = httpbakery.ThirdPartyLocator(allow_insecure=True)
+        with HTTMock(discharge_info):
+            info = kr.third_party_info('http://0.1.2.3/')
+        self.assertEqual(info, expectInfo)
+        info = kr.third_party_info('http://0.1.2.3/')
+        self.assertEqual(info, expectInfo)
+
+    def test_cache_fetch_no_version(self):
+        key = bakery.generate_key()
+
+        @urlmatch(path='.*/discharge/info')
+        def discharge_info(url, request):
+            return {
+                'status_code': 200,
+                'content': {
+                    'PublicKey': str(key.public_key),
+                }
+            }
+
+        expectInfo = bakery.ThirdPartyInfo(
+            public_key=key.public_key,
+            version=bakery.VERSION_1
+        )
+        kr = httpbakery.ThirdPartyLocator(allow_insecure=True)
+        with HTTMock(discharge_info):
+            info = kr.third_party_info('http://0.1.2.3/')
+        self.assertEqual(info, expectInfo)
+
+    def test_allow_insecure(self):
+        kr = httpbakery.ThirdPartyLocator()
+        with self.assertRaises(bakery.ThirdPartyInfoNotFound):
+            kr.third_party_info('http://0.1.2.3/')
+
+    def test_fallback(self):
+        key = bakery.generate_key()
+
+        @urlmatch(path='.*/discharge/info')
+        def discharge_info(url, request):
+            return {
+                'status_code': 404,
+            }
+
+        @urlmatch(path='.*/publickey')
+        def public_key(url, request):
+            return {
+                'status_code': 200,
+                'content': {
+                    'PublicKey': str(key.public_key),
+                }
+            }
+
+        expectInfo = bakery.ThirdPartyInfo(
+            public_key=key.public_key,
+            version=bakery.VERSION_1
+        )
+        kr = httpbakery.ThirdPartyLocator(allow_insecure=True)
+        with HTTMock(discharge_info):
+            with HTTMock(public_key):
+                info = kr.third_party_info('http://0.1.2.3/')
+        self.assertEqual(info, expectInfo)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_macaroon.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_macaroon.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcbbf80158a79f83667a1ad52b4f02d9cfdf81cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_macaroon.py
@@ -0,0 +1,201 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import json
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import macaroonbakery.checkers as checkers
+import pymacaroons
+import six
+from macaroonbakery.tests import common
+from pymacaroons import serializers
+
+
+class TestMacaroon(TestCase):
+    def test_new_macaroon(self):
+        m = bakery.Macaroon(
+            b'rootkey',
+            b'some id',
+            'here',
+            bakery.LATEST_VERSION)
+        self.assertIsNotNone(m)
+        self.assertEquals(m._macaroon.identifier, b'some id')
+        self.assertEquals(m._macaroon.location, 'here')
+        self.assertEquals(m.version, bakery.LATEST_VERSION)
+
+    def test_add_first_party_caveat(self):
+        m = bakery.Macaroon('rootkey', 'some id', 'here',
+                            bakery.LATEST_VERSION)
+        m.add_caveat(checkers.Caveat('test_condition'))
+        caveats = m.first_party_caveats()
+        self.assertEquals(len(caveats), 1)
+        self.assertEquals(caveats[0].caveat_id, b'test_condition')
+
+    def test_add_third_party_caveat(self):
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+
+        lbv = six.int2byte(bakery.LATEST_VERSION)
+        tests = [
+            ('no existing id', b'', [], lbv + six.int2byte(0)),
+            ('several existing ids', b'', [
+                lbv + six.int2byte(0),
+                lbv + six.int2byte(1),
+                lbv + six.int2byte(2)
+            ], lbv + six.int2byte(3)),
+            ('with base id', lbv + six.int2byte(0), [lbv + six.int2byte(0)],
+             lbv + six.int2byte(0) + six.int2byte(0)),
+            ('with base id and existing id', lbv + six.int2byte(0), [
+                lbv + six.int2byte(0) + six.int2byte(0)
+            ], lbv + six.int2byte(0) + six.int2byte(1))
+        ]
+
+        for test in tests:
+            print('test ', test[0])
+            m = bakery.Macaroon(
+                root_key=b'root key', id=b'id',
+                location='location',
+                version=bakery.LATEST_VERSION)
+            for id in test[2]:
+                m.macaroon.add_third_party_caveat(key=None, key_id=id,
+                                                  location='')
+                m._caveat_id_prefix = test[1]
+            m.add_caveat(checkers.Caveat(location='bs-loc',
+                                         condition='something'),
+                         bs.oven.key, locator)
+            self.assertEqual(m.macaroon.caveats[len(test[2])].caveat_id,
+                             test[3])
+
+    def test_marshal_json_latest_version(self):
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+        ns = checkers.Namespace({
+            'testns': 'x',
+            'otherns': 'y',
+        })
+        m = bakery.Macaroon(
+            root_key=b'root key', id=b'id',
+            location='location',
+            version=bakery.LATEST_VERSION,
+            namespace=ns)
+        m.add_caveat(checkers.Caveat(location='bs-loc', condition='something'),
+                     bs.oven.key, locator)
+        data = m.serialize_json()
+        m1 = bakery.Macaroon.deserialize_json(data)
+        # Just check the signature and version - we're not interested in fully
+        # checking the macaroon marshaling here.
+        self.assertEqual(m1.macaroon.signature, m.macaroon.signature)
+        self.assertEqual(m1.macaroon.version, m.macaroon.version)
+        self.assertEqual(len(m1.macaroon.caveats), 1)
+        self.assertEqual(m1.namespace, m.namespace)
+        self.assertEqual(m1._caveat_data, m._caveat_data)
+
+        # test with the encoder, decoder
+        data = json.dumps(m, cls=bakery.MacaroonJSONEncoder)
+        m1 = json.loads(data, cls=bakery.MacaroonJSONDecoder)
+        self.assertEqual(m1.macaroon.signature, m.macaroon.signature)
+        self.assertEqual(m1.macaroon.version, m.macaroon.version)
+        self.assertEqual(len(m1.macaroon.caveats), 1)
+        self.assertEqual(m1.namespace, m.namespace)
+        self.assertEqual(m1._caveat_data, m._caveat_data)
+
+    def test_json_version1(self):
+        self._test_json_with_version(bakery.VERSION_1)
+
+    def test_json_version2(self):
+        self._test_json_with_version(bakery.VERSION_2)
+
+    def _test_json_with_version(self, version):
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery('bs-loc', locator)
+
+        ns = checkers.Namespace({
+            'testns': 'x',
+        })
+
+        m = bakery.Macaroon(
+            root_key=b'root key', id=b'id',
+            location='location', version=version,
+            namespace=ns)
+        m.add_caveat(checkers.Caveat(location='bs-loc', condition='something'),
+                     bs.oven.key, locator)
+
+        # Sanity check that no external caveat data has been added.
+        self.assertEqual(len(m._caveat_data), 0)
+
+        data = json.dumps(m, cls=bakery.MacaroonJSONEncoder)
+        m1 = json.loads(data, cls=bakery.MacaroonJSONDecoder)
+
+        # Just check the signature and version - we're not interested in fully
+        # checking the macaroon marshaling here.
+        self.assertEqual(m1.macaroon.signature, m.macaroon.signature)
+        self.assertEqual(m1.macaroon.version,
+                         bakery.macaroon_version(version))
+        self.assertEqual(len(m1.macaroon.caveats), 1)
+
+        # Namespace information has been thrown away.
+        self.assertEqual(m1.namespace, bakery.legacy_namespace())
+
+        self.assertEqual(len(m1._caveat_data), 0)
+
+    def test_json_unknown_version(self):
+        m = pymacaroons.Macaroon(version=pymacaroons.MACAROON_V2)
+        with self.assertRaises(ValueError) as exc:
+            json.loads(json.dumps({
+                'm': m.serialize(serializer=serializers.JsonSerializer()),
+                'v': bakery.LATEST_VERSION + 1
+            }), cls=bakery.MacaroonJSONDecoder)
+        self.assertEqual('unknown bakery version 4', exc.exception.args[0])
+
+    def test_json_inconsistent_version(self):
+        m = pymacaroons.Macaroon(version=pymacaroons.MACAROON_V1)
+        with self.assertRaises(ValueError) as exc:
+            json.loads(json.dumps({
+                'm': json.loads(m.serialize(
+                    serializer=serializers.JsonSerializer())),
+                'v': bakery.LATEST_VERSION
+            }), cls=bakery.MacaroonJSONDecoder)
+        self.assertEqual('underlying macaroon has inconsistent version; '
+                         'got 1 want 2', exc.exception.args[0])
+
+    def test_clone(self):
+        locator = bakery.ThirdPartyStore()
+        bs = common.new_bakery("bs-loc", locator)
+        ns = checkers.Namespace({
+            "testns": "x",
+        })
+        m = bakery.Macaroon(
+            root_key=b'root key', id=b'id',
+            location='location',
+            version=bakery.LATEST_VERSION,
+            namespace=ns)
+        m.add_caveat(checkers.Caveat(location='bs-loc', condition='something'),
+                     bs.oven.key, locator)
+        m1 = m.copy()
+        self.assertEqual(len(m.macaroon.caveats), 1)
+        self.assertEqual(len(m1.macaroon.caveats), 1)
+        self.assertEqual(m._caveat_data, m1._caveat_data)
+        m.add_caveat(checkers.Caveat(location='bs-loc', condition='something'),
+                     bs.oven.key, locator)
+        self.assertEqual(len(m.macaroon.caveats), 2)
+        self.assertEqual(len(m1.macaroon.caveats), 1)
+        self.assertNotEqual(m._caveat_data, m1._caveat_data)
+
+    def test_json_deserialize_from_go(self):
+        ns = checkers.Namespace()
+        ns.register("someuri", "x")
+        m = bakery.Macaroon(
+            root_key=b'rootkey', id=b'some id', location='here',
+            version=bakery.LATEST_VERSION, namespace=ns)
+        m.add_caveat(checkers.Caveat(condition='something',
+                                     namespace='someuri'))
+        data = '{"m":{"c":[{"i":"x:something"}],"l":"here","i":"some id",' \
+               '"s64":"c8edRIupArSrY-WZfa62pgZFD8VjDgqho9U2PlADe-E"},"v":3,' \
+               '"ns":"someuri:x"}'
+        m_go = bakery.Macaroon.deserialize_json(data)
+
+        self.assertEqual(m.macaroon.signature_bytes,
+                         m_go.macaroon.signature_bytes)
+        self.assertEqual(m.macaroon.version, m_go.macaroon.version)
+        self.assertEqual(len(m_go.macaroon.caveats), 1)
+        self.assertEqual(m.namespace, m_go.namespace)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_namespace.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_namespace.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a821e5eb41326f355442595bb5794fbfdffa412
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_namespace.py
@@ -0,0 +1,59 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from unittest import TestCase
+
+import macaroonbakery.checkers as checkers
+
+
+class TestNamespace(TestCase):
+    def test_serialize(self):
+        tests = [
+            ('empty namespace', None, b''),
+            ('standard namespace', {'std': ''}, b'std:'),
+            ('several elements', {
+                'std': '',
+                'http://blah.blah': 'blah',
+                'one': 'two',
+                'foo.com/x.v0.1': 'z',
+            }, b'foo.com/x.v0.1:z http://blah.blah:blah one:two std:'),
+            ('sort by URI not by field', {
+                'a': 'one',
+                'a1': 'two',
+            }, b'a:one a1:two')
+        ]
+        for test in tests:
+            ns = checkers.Namespace(test[1])
+            data = ns.serialize_text()
+            self.assertEquals(data, test[2])
+            self.assertEquals(str(ns), test[2].decode('utf-8'))
+
+        # Check that it can be deserialize to the same thing:
+        ns1 = checkers.deserialize_namespace(data)
+        self.assertEquals(ns1, ns)
+
+    # TODO(rogpeppe) add resolve tests
+
+    def test_register(self):
+        ns = checkers.Namespace(None)
+        ns.register('testns', 't')
+        prefix = ns.resolve('testns')
+        self.assertEquals(prefix, 't')
+
+        ns.register('other', 'o')
+        prefix = ns.resolve('other')
+        self.assertEquals(prefix, 'o')
+
+        # If we re-register the same URL, it does nothing.
+        ns.register('other', 'p')
+        prefix = ns.resolve('other')
+        self.assertEquals(prefix, 'o')
+
+    def test_register_bad_uri(self):
+        ns = checkers.Namespace(None)
+        with self.assertRaises(KeyError):
+            ns.register('', 'x')
+
+    def test_register_bad_prefix(self):
+        ns = checkers.Namespace(None)
+        with self.assertRaises(ValueError):
+            ns.register('std', 'x:1')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_oven.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_oven.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c2976794d2b0d2859397424d47f7349d2df9194
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_oven.py
@@ -0,0 +1,124 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+import copy
+from datetime import datetime, timedelta
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+
+EPOCH = datetime(1900, 11, 17, 19, 00, 13, 0, None)
+AGES = EPOCH + timedelta(days=10)
+
+
+class TestOven(TestCase):
+    def test_canonical_ops(self):
+        canonical_ops_tests = (
+            ('empty array', [], []),
+            ('one element', [bakery.Op('a', 'a')],
+             [bakery.Op('a', 'a')]),
+            ('all in order',
+             [bakery.Op('a', 'a'), bakery.Op('a', 'b'),
+              bakery.Op('c', 'c')],
+             [bakery.Op('a', 'a'), bakery.Op('a', 'b'),
+              bakery.Op('c', 'c')]),
+            ('out of order',
+             [bakery.Op('c', 'c'), bakery.Op('a', 'b'),
+              bakery.Op('a', 'a')],
+             [bakery.Op('a', 'a'), bakery.Op('a', 'b'),
+              bakery.Op('c', 'c')]),
+            ('with duplicates',
+             [bakery.Op('c', 'c'), bakery.Op('a', 'b'),
+              bakery.Op('a', 'a'), bakery.Op('c', 'a'),
+              bakery.Op('c', 'b'), bakery.Op('c', 'c'),
+              bakery.Op('a', 'a')],
+             [bakery.Op('a', 'a'), bakery.Op('a', 'b'),
+              bakery.Op('c', 'a'), bakery.Op('c', 'b'),
+              bakery.Op('c', 'c')]),
+            ('make sure we\'ve got the fields right',
+             [bakery.Op(entity='read', action='two'),
+              bakery.Op(entity='read', action='one'),
+              bakery.Op(entity='write', action='one')],
+             [bakery.Op(entity='read', action='one'),
+              bakery.Op(entity='read', action='two'),
+              bakery.Op(entity='write', action='one')])
+        )
+        for about, ops, expected in canonical_ops_tests:
+            new_ops = copy.copy(ops)
+            canonical_ops = bakery.canonical_ops(new_ops)
+            self.assertEquals(canonical_ops, expected)
+            # Verify that the original array isn't changed.
+            self.assertEquals(new_ops, ops)
+
+    def test_multiple_ops(self):
+        test_oven = bakery.Oven(
+            ops_store=bakery.MemoryOpsStore())
+        ops = [bakery.Op('one', 'read'),
+               bakery.Op('one', 'write'),
+               bakery.Op('two', 'read')]
+        m = test_oven.macaroon(bakery.LATEST_VERSION, AGES,
+                               None, ops)
+        got_ops, conds = test_oven.macaroon_ops([m.macaroon])
+        self.assertEquals(len(conds), 1)  # time-before caveat.
+        self.assertEquals(bakery.canonical_ops(got_ops), ops)
+
+    def test_multiple_ops_in_id(self):
+        test_oven = bakery.Oven()
+        ops = [bakery.Op('one', 'read'),
+               bakery.Op('one', 'write'),
+               bakery.Op('two', 'read')]
+        m = test_oven.macaroon(bakery.LATEST_VERSION, AGES,
+                               None, ops)
+        got_ops, conds = test_oven.macaroon_ops([m.macaroon])
+        self.assertEquals(len(conds), 1)  # time-before caveat.
+        self.assertEquals(bakery.canonical_ops(got_ops), ops)
+
+    def test_multiple_ops_in_id_with_version1(self):
+        test_oven = bakery.Oven()
+        ops = [bakery.Op('one', 'read'),
+               bakery.Op('one', 'write'),
+               bakery.Op('two', 'read')]
+        m = test_oven.macaroon(bakery.VERSION_1, AGES, None, ops)
+        got_ops, conds = test_oven.macaroon_ops([m.macaroon])
+        self.assertEquals(len(conds), 1)  # time-before caveat.
+        self.assertEquals(bakery.canonical_ops(got_ops), ops)
+
+    def test_huge_number_of_ops_gives_small_macaroon(self):
+        test_oven = bakery.Oven(
+            ops_store=bakery.MemoryOpsStore())
+        ops = []
+        for i in range(30000):
+            ops.append(bakery.Op(entity='entity' + str(i),
+                                 action='action' + str(i)))
+
+        m = test_oven.macaroon(bakery.LATEST_VERSION, AGES,
+                               None, ops)
+        got_ops, conds = test_oven.macaroon_ops([m.macaroon])
+        self.assertEquals(len(conds), 1)  # time-before caveat.
+        self.assertEquals(bakery.canonical_ops(got_ops),
+                          bakery.canonical_ops(ops))
+
+        data = m.serialize_json()
+        self.assertLess(len(data), 300)
+
+    def test_ops_stored_only_once(self):
+        st = bakery.MemoryOpsStore()
+        test_oven = bakery.Oven(ops_store=st)
+
+        ops = [bakery.Op('one', 'read'),
+               bakery.Op('one', 'write'),
+               bakery.Op('two', 'read')]
+
+        m = test_oven.macaroon(bakery.LATEST_VERSION, AGES,
+                               None, ops)
+        got_ops, conds = test_oven.macaroon_ops([m.macaroon])
+        self.assertEquals(bakery.canonical_ops(got_ops),
+                          bakery.canonical_ops(ops))
+
+        # Make another macaroon containing the same ops in a different order.
+        ops = [bakery.Op('one', 'write'),
+               bakery.Op('one', 'read'),
+               bakery.Op('one', 'read'),
+               bakery.Op('two', 'read')]
+        test_oven.macaroon(bakery.LATEST_VERSION, AGES, None,
+                           ops)
+        self.assertEquals(len(st._store), 1)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_store.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_store.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a54f5912c34a99d9473ff9101fa35c1c2a89959
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_store.py
@@ -0,0 +1,21 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+
+
+class TestOven(TestCase):
+    def test_mem_store(self):
+        st = bakery.MemoryKeyStore()
+
+        key, id = st.root_key()
+        self.assertEqual(len(key), 24)
+        self.assertEqual(id.decode('utf-8'), '0')
+
+        key1, id1 = st.root_key()
+        self.assertEqual(key1, key)
+        self.assertEqual(id1, id)
+
+        key2 = st.get(id)
+        self.assertEqual(key2, key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_time.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_time.py
new file mode 100644
index 0000000000000000000000000000000000000000..2685e56d9cd48af009fa913b38f9d64dd2690f5d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_time.py
@@ -0,0 +1,136 @@
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+from collections import namedtuple
+from datetime import timedelta
+from unittest import TestCase
+
+import macaroonbakery.checkers as checkers
+import pymacaroons
+import pyrfc3339
+from pymacaroons import Macaroon
+
+t1 = pyrfc3339.parse('2017-10-26T16:19:47.441402074Z', produce_naive=True)
+t2 = t1 + timedelta(hours=1)
+t3 = t2 + timedelta(hours=1)
+
+
+def fpcaveat(s):
+    return pymacaroons.Caveat(caveat_id=s.encode('utf-8'))
+
+
+class TestExpireTime(TestCase):
+    def test_expire_time(self):
+        ExpireTest = namedtuple('ExpireTest', 'about caveats expectTime')
+        tests = [
+            ExpireTest(
+                about='no caveats',
+                caveats=[],
+                expectTime=None,
+            ),
+            ExpireTest(
+                about='single time-before caveat',
+                caveats=[
+                    fpcaveat(checkers.time_before_caveat(t1).condition),
+                ],
+                expectTime=t1,
+            ),
+            ExpireTest(
+                about='multiple time-before caveat',
+                caveats=[
+                    fpcaveat(checkers.time_before_caveat(t2).condition),
+                    fpcaveat(checkers.time_before_caveat(t1).condition),
+                ],
+                expectTime=t1,
+            ),
+            ExpireTest(
+                about='mixed caveats',
+                caveats=[
+                    fpcaveat(checkers.time_before_caveat(t1).condition),
+                    fpcaveat('allow bar'),
+                    fpcaveat(checkers.time_before_caveat(t2).condition),
+                    fpcaveat('deny foo'),
+                ],
+                expectTime=t1,
+            ),
+            ExpireTest(
+                about='mixed caveats',
+                caveats=[
+                    fpcaveat(checkers.COND_TIME_BEFORE + ' tomorrow'),
+                ],
+                expectTime=None,
+            ),
+        ]
+        for test in tests:
+            print('test ', test.about)
+            t = checkers.expiry_time(checkers.Namespace(), test.caveats)
+            self.assertEqual(t, test.expectTime)
+
+    def test_macaroons_expire_time(self):
+        ExpireTest = namedtuple('ExpireTest', 'about macaroons expectTime')
+        tests = [
+            ExpireTest(
+                about='no macaroons',
+                macaroons=[newMacaroon()],
+                expectTime=None,
+            ),
+            ExpireTest(
+                about='single macaroon without caveats',
+                macaroons=[newMacaroon()],
+                expectTime=None,
+            ),
+            ExpireTest(
+                about='multiple macaroon without caveats',
+                macaroons=[newMacaroon()],
+                expectTime=None,
+            ),
+            ExpireTest(
+                about='single macaroon with time-before caveat',
+                macaroons=[
+                    newMacaroon([checkers.time_before_caveat(t1).condition]),
+                ],
+                expectTime=t1,
+            ),
+            ExpireTest(
+                about='single macaroon with multiple time-before caveats',
+                macaroons=[
+                    newMacaroon([
+                        checkers.time_before_caveat(t2).condition,
+                        checkers.time_before_caveat(t1).condition,
+                    ]),
+                ],
+                expectTime=t1,
+            ),
+            ExpireTest(
+                about='multiple macaroons with multiple time-before caveats',
+                macaroons=[
+                    newMacaroon([
+                        checkers.time_before_caveat(t3).condition,
+                        checkers.time_before_caveat(t1).condition,
+                    ]),
+                    newMacaroon([
+                        checkers.time_before_caveat(t3).condition,
+                        checkers.time_before_caveat(t1).condition,
+                    ]),
+                ],
+                expectTime=t1,
+            ),
+        ]
+        for test in tests:
+            print('test ', test.about)
+            t = checkers.macaroons_expiry_time(checkers.Namespace(),
+                                               test.macaroons)
+            self.assertEqual(t, test.expectTime)
+
+    def test_macaroons_expire_time_skips_third_party(self):
+        m1 = newMacaroon([checkers.time_before_caveat(t1).condition])
+        m2 = newMacaroon()
+        m2.add_third_party_caveat('https://example.com', 'a-key', '123')
+        t = checkers.macaroons_expiry_time(checkers.Namespace(), [m1, m2])
+        self.assertEqual(t1, t)
+
+
+def newMacaroon(conds=[]):
+    m = Macaroon(key='key', version=2)
+    for cond in conds:
+        m.add_first_party_caveat(cond)
+    return m
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ed3e8180e9ef18eb9a45c779f1252416afdfb7d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/macaroonbakery/tests/test_utils.py
@@ -0,0 +1,96 @@
+#  -*- coding: utf-8 -*-
+
+# Copyright 2017 Canonical Ltd.
+# Licensed under the LGPLv3, see LICENCE file for details.
+
+import json
+from datetime import datetime
+from unittest import TestCase
+
+import macaroonbakery.bakery as bakery
+import pymacaroons
+from macaroonbakery._utils import cookie
+from pymacaroons.serializers import json_serializer
+
+
+class CookieTest(TestCase):
+
+    def test_cookie_expires_naive(self):
+        timestamp = datetime.utcnow()
+        c = cookie('http://example.com', 'test', 'value', expires=timestamp)
+        self.assertEqual(
+            c.expires, int((timestamp - datetime(1970, 1, 1)).total_seconds()))
+
+    def test_cookie_expires_with_timezone(self):
+        from datetime import tzinfo
+        timestamp = datetime.utcnow().replace(tzinfo=tzinfo())
+        self.assertRaises(
+            ValueError, cookie, 'http://example.com', 'test', 'value',
+            expires=timestamp)
+
+    def test_cookie_with_hostname_not_fqdn(self):
+        c = cookie('http://myhost', 'test', 'value')
+        self.assertEqual(c.domain, 'myhost.local')
+
+    def test_cookie_with_hostname_ipv4(self):
+        c = cookie('http://1.2.3.4', 'test', 'value')
+        self.assertEqual(c.domain, '1.2.3.4')
+
+    def test_cookie_with_hostname_ipv6(self):
+        c = cookie('http://[dead::beef]', 'test', 'value')
+        self.assertEqual(c.domain, 'dead::beef')
+
+    def test_cookie_with_hostname_like_ipv4(self):
+        c = cookie('http://1.2.3.4.com', 'test', 'value')
+        self.assertEqual(c.domain, '1.2.3.4.com')
+
+    def test_cookie_with_hostname_not_ascii(self):
+        c = cookie('http://κουλουράκι', 'test', 'value')
+        self.assertEqual(c.domain, 'κουλουράκι.local')
+
+
+class TestB64Decode(TestCase):
+    def test_decode(self):
+        test_cases = [{
+            'about': 'empty string',
+            'input': '',
+            'expect': '',
+        }, {
+            'about': 'standard encoding, padded',
+            'input': 'Z29+IQ==',
+            'expect': 'go~!',
+        }, {
+            'about': 'URL encoding, padded',
+            'input': 'Z29-IQ==',
+            'expect': 'go~!',
+        }, {
+            'about': 'standard encoding, not padded',
+            'input': 'Z29+IQ',
+            'expect': 'go~!',
+        }, {
+            'about': 'URL encoding, not padded',
+            'input': 'Z29-IQ',
+            'expect': 'go~!',
+        }, {
+            'about': 'standard encoding, not enough much padding',
+            'input': 'Z29+IQ=',
+            'expect_error': 'illegal base64 data at input byte 8',
+        }]
+        for test in test_cases:
+            if test.get('expect_error'):
+                with self.assertRaises(ValueError, msg=test['about']) as e:
+                    bakery.b64decode(test['input'])
+                self.assertEqual(str(e.exception), 'Incorrect padding')
+            else:
+                self.assertEqual(bakery.b64decode(test['input']), test['expect'].encode('utf-8'), msg=test['about'])
+
+
+class MacaroonToDictTest(TestCase):
+    def test_macaroon_to_dict(self):
+        m = pymacaroons.Macaroon(
+            key=b'rootkey', identifier=b'some id', location='here', version=2)
+        as_dict = bakery.macaroon_to_dict(m)
+        data = json.dumps(as_dict)
+        m1 = pymacaroons.Macaroon.deserialize(data, json_serializer.JsonSerializer())
+        self.assertEqual(m1.signature, m.signature)
+        pymacaroons.Verifier().verify(m1, b'rootkey')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..da05ed328a476bdcea7c0bd4d335d9e721cbab77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/__init__.py
@@ -0,0 +1,327 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe
+~~~~~~~~~~
+
+Implements an escape function and a Markup string to replace HTML
+special characters with safe representations.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import re
+import string
+
+from ._compat import int_types
+from ._compat import iteritems
+from ._compat import Mapping
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import unichr
+
+__version__ = "1.1.1"
+
+__all__ = ["Markup", "soft_unicode", "escape", "escape_silent"]
+
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^& ;]+);")
+
+
+class Markup(text_type):
+    """A string that is ready to be safely inserted into an HTML or XML
+    document, either because it was escaped or because it was marked
+    safe.
+
+    Passing an object to the constructor converts it to text and wraps
+    it to mark it safe without escaping. To escape the text, use the
+    :meth:`escape` class method instead.
+
+    >>> Markup('Hello, <em>World</em>!')
+    Markup('Hello, <em>World</em>!')
+    >>> Markup(42)
+    Markup('42')
+    >>> Markup.escape('Hello, <em>World</em>!')
+    Markup('Hello &lt;em&gt;World&lt;/em&gt;!')
+
+    This implements the ``__html__()`` interface that some frameworks
+    use. Passing an object that implements ``__html__()`` will wrap the
+    output of that method, marking it safe.
+
+    >>> class Foo:
+    ...     def __html__(self):
+    ...         return '<a href="/foo">foo</a>'
+    ...
+    >>> Markup(Foo())
+    Markup('<a href="/foo">foo</a>')
+
+    This is a subclass of the text type (``str`` in Python 3,
+    ``unicode`` in Python 2). It has the same methods as that type, but
+    all methods escape their arguments and return a ``Markup`` instance.
+
+    >>> Markup('<em>%s</em>') % 'foo & bar'
+    Markup('<em>foo &amp; bar</em>')
+    >>> Markup('<em>Hello</em> ') + '<foo>'
+    Markup('<em>Hello</em> &lt;foo&gt;')
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, base=u"", encoding=None, errors="strict"):
+        if hasattr(base, "__html__"):
+            base = base.__html__()
+        if encoding is None:
+            return text_type.__new__(cls, base)
+        return text_type.__new__(cls, base, encoding, errors)
+
+    def __html__(self):
+        return self
+
+    def __add__(self, other):
+        if isinstance(other, string_types) or hasattr(other, "__html__"):
+            return self.__class__(super(Markup, self).__add__(self.escape(other)))
+        return NotImplemented
+
+    def __radd__(self, other):
+        if hasattr(other, "__html__") or isinstance(other, string_types):
+            return self.escape(other).__add__(self)
+        return NotImplemented
+
+    def __mul__(self, num):
+        if isinstance(num, int_types):
+            return self.__class__(text_type.__mul__(self, num))
+        return NotImplemented
+
+    __rmul__ = __mul__
+
+    def __mod__(self, arg):
+        if isinstance(arg, tuple):
+            arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
+        else:
+            arg = _MarkupEscapeHelper(arg, self.escape)
+        return self.__class__(text_type.__mod__(self, arg))
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, text_type.__repr__(self))
+
+    def join(self, seq):
+        return self.__class__(text_type.join(self, map(self.escape, seq)))
+
+    join.__doc__ = text_type.join.__doc__
+
+    def split(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.split(self, *args, **kwargs)))
+
+    split.__doc__ = text_type.split.__doc__
+
+    def rsplit(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.rsplit(self, *args, **kwargs)))
+
+    rsplit.__doc__ = text_type.rsplit.__doc__
+
+    def splitlines(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.splitlines(self, *args, **kwargs)))
+
+    splitlines.__doc__ = text_type.splitlines.__doc__
+
+    def unescape(self):
+        """Convert escaped markup back into a text string. This replaces
+        HTML entities with the characters they represent.
+
+        >>> Markup('Main &raquo; <em>About</em>').unescape()
+        'Main » <em>About</em>'
+        """
+        from ._constants import HTML_ENTITIES
+
+        def handle_match(m):
+            name = m.group(1)
+            if name in HTML_ENTITIES:
+                return unichr(HTML_ENTITIES[name])
+            try:
+                if name[:2] in ("#x", "#X"):
+                    return unichr(int(name[2:], 16))
+                elif name.startswith("#"):
+                    return unichr(int(name[1:]))
+            except ValueError:
+                pass
+            # Don't modify unexpected input.
+            return m.group()
+
+        return _entity_re.sub(handle_match, text_type(self))
+
+    def striptags(self):
+        """:meth:`unescape` the markup, remove tags, and normalize
+        whitespace to single spaces.
+
+        >>> Markup('Main &raquo;\t<em>About</em>').striptags()
+        'Main » About'
+        """
+        stripped = u" ".join(_striptags_re.sub("", self).split())
+        return Markup(stripped).unescape()
+
+    @classmethod
+    def escape(cls, s):
+        """Escape a string. Calls :func:`escape` and ensures that for
+        subclasses the correct type is returned.
+        """
+        rv = escape(s)
+        if rv.__class__ is not cls:
+            return cls(rv)
+        return rv
+
+    def make_simple_escaping_wrapper(name):  # noqa: B902
+        orig = getattr(text_type, name)
+
+        def func(self, *args, **kwargs):
+            args = _escape_argspec(list(args), enumerate(args), self.escape)
+            _escape_argspec(kwargs, iteritems(kwargs), self.escape)
+            return self.__class__(orig(self, *args, **kwargs))
+
+        func.__name__ = orig.__name__
+        func.__doc__ = orig.__doc__
+        return func
+
+    for method in (
+        "__getitem__",
+        "capitalize",
+        "title",
+        "lower",
+        "upper",
+        "replace",
+        "ljust",
+        "rjust",
+        "lstrip",
+        "rstrip",
+        "center",
+        "strip",
+        "translate",
+        "expandtabs",
+        "swapcase",
+        "zfill",
+    ):
+        locals()[method] = make_simple_escaping_wrapper(method)
+
+    def partition(self, sep):
+        return tuple(map(self.__class__, text_type.partition(self, self.escape(sep))))
+
+    def rpartition(self, sep):
+        return tuple(map(self.__class__, text_type.rpartition(self, self.escape(sep))))
+
+    def format(self, *args, **kwargs):
+        formatter = EscapeFormatter(self.escape)
+        kwargs = _MagicFormatMapping(args, kwargs)
+        return self.__class__(formatter.vformat(self, args, kwargs))
+
+    def __html_format__(self, format_spec):
+        if format_spec:
+            raise ValueError("Unsupported format specification " "for Markup.")
+        return self
+
+    # not in python 3
+    if hasattr(text_type, "__getslice__"):
+        __getslice__ = make_simple_escaping_wrapper("__getslice__")
+
+    del method, make_simple_escaping_wrapper
+
+
+class _MagicFormatMapping(Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See http://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+if hasattr(text_type, "format"):
+
+    class EscapeFormatter(string.Formatter):
+        def __init__(self, escape):
+            self.escape = escape
+
+        def format_field(self, value, format_spec):
+            if hasattr(value, "__html_format__"):
+                rv = value.__html_format__(format_spec)
+            elif hasattr(value, "__html__"):
+                if format_spec:
+                    raise ValueError(
+                        "Format specifier {0} given, but {1} does not"
+                        " define __html_format__. A class that defines"
+                        " __html__ must define __html_format__ to work"
+                        " with format specifiers.".format(format_spec, type(value))
+                    )
+                rv = value.__html__()
+            else:
+                # We need to make sure the format spec is unicode here as
+                # otherwise the wrong callback methods are invoked.  For
+                # instance a byte string there would invoke __str__ and
+                # not __unicode__.
+                rv = string.Formatter.format_field(self, value, text_type(format_spec))
+            return text_type(self.escape(rv))
+
+
+def _escape_argspec(obj, iterable, escape):
+    """Helper for various string-wrapped functions."""
+    for key, value in iterable:
+        if hasattr(value, "__html__") or isinstance(value, string_types):
+            obj[key] = escape(value)
+    return obj
+
+
+class _MarkupEscapeHelper(object):
+    """Helper for Markup.__mod__"""
+
+    def __init__(self, obj, escape):
+        self.obj = obj
+        self.escape = escape
+
+    def __getitem__(self, item):
+        return _MarkupEscapeHelper(self.obj[item], self.escape)
+
+    def __str__(self):
+        return text_type(self.escape(self.obj))
+
+    __unicode__ = __str__
+
+    def __repr__(self):
+        return str(self.escape(repr(self.obj)))
+
+    def __int__(self):
+        return int(self.obj)
+
+    def __float__(self):
+        return float(self.obj)
+
+
+# we have to import it down here as the speedups and native
+# modules imports the markup type which is define above.
+try:
+    from ._speedups import escape, escape_silent, soft_unicode
+except ImportError:
+    from ._native import escape, escape_silent, soft_unicode
+
+if not PY2:
+    soft_str = soft_unicode
+    __all__.append("soft_str")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc05090f9e88da2c16a75844bcb6d5043025581b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_compat.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._compat
+~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import sys
+
+PY2 = sys.version_info[0] == 2
+
+if not PY2:
+    text_type = str
+    string_types = (str,)
+    unichr = chr
+    int_types = (int,)
+
+    def iteritems(x):
+        return iter(x.items())
+
+    from collections.abc import Mapping
+
+else:
+    text_type = unicode
+    string_types = (str, unicode)
+    unichr = unichr
+    int_types = (int, long)
+
+    def iteritems(x):
+        return x.iteritems()
+
+    from collections import Mapping
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_constants.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c57c2d29452a94c22708e1b749f0b7e8c14bf1b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_constants.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._constants
+~~~~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+
+HTML_ENTITIES = {
+    "AElig": 198,
+    "Aacute": 193,
+    "Acirc": 194,
+    "Agrave": 192,
+    "Alpha": 913,
+    "Aring": 197,
+    "Atilde": 195,
+    "Auml": 196,
+    "Beta": 914,
+    "Ccedil": 199,
+    "Chi": 935,
+    "Dagger": 8225,
+    "Delta": 916,
+    "ETH": 208,
+    "Eacute": 201,
+    "Ecirc": 202,
+    "Egrave": 200,
+    "Epsilon": 917,
+    "Eta": 919,
+    "Euml": 203,
+    "Gamma": 915,
+    "Iacute": 205,
+    "Icirc": 206,
+    "Igrave": 204,
+    "Iota": 921,
+    "Iuml": 207,
+    "Kappa": 922,
+    "Lambda": 923,
+    "Mu": 924,
+    "Ntilde": 209,
+    "Nu": 925,
+    "OElig": 338,
+    "Oacute": 211,
+    "Ocirc": 212,
+    "Ograve": 210,
+    "Omega": 937,
+    "Omicron": 927,
+    "Oslash": 216,
+    "Otilde": 213,
+    "Ouml": 214,
+    "Phi": 934,
+    "Pi": 928,
+    "Prime": 8243,
+    "Psi": 936,
+    "Rho": 929,
+    "Scaron": 352,
+    "Sigma": 931,
+    "THORN": 222,
+    "Tau": 932,
+    "Theta": 920,
+    "Uacute": 218,
+    "Ucirc": 219,
+    "Ugrave": 217,
+    "Upsilon": 933,
+    "Uuml": 220,
+    "Xi": 926,
+    "Yacute": 221,
+    "Yuml": 376,
+    "Zeta": 918,
+    "aacute": 225,
+    "acirc": 226,
+    "acute": 180,
+    "aelig": 230,
+    "agrave": 224,
+    "alefsym": 8501,
+    "alpha": 945,
+    "amp": 38,
+    "and": 8743,
+    "ang": 8736,
+    "apos": 39,
+    "aring": 229,
+    "asymp": 8776,
+    "atilde": 227,
+    "auml": 228,
+    "bdquo": 8222,
+    "beta": 946,
+    "brvbar": 166,
+    "bull": 8226,
+    "cap": 8745,
+    "ccedil": 231,
+    "cedil": 184,
+    "cent": 162,
+    "chi": 967,
+    "circ": 710,
+    "clubs": 9827,
+    "cong": 8773,
+    "copy": 169,
+    "crarr": 8629,
+    "cup": 8746,
+    "curren": 164,
+    "dArr": 8659,
+    "dagger": 8224,
+    "darr": 8595,
+    "deg": 176,
+    "delta": 948,
+    "diams": 9830,
+    "divide": 247,
+    "eacute": 233,
+    "ecirc": 234,
+    "egrave": 232,
+    "empty": 8709,
+    "emsp": 8195,
+    "ensp": 8194,
+    "epsilon": 949,
+    "equiv": 8801,
+    "eta": 951,
+    "eth": 240,
+    "euml": 235,
+    "euro": 8364,
+    "exist": 8707,
+    "fnof": 402,
+    "forall": 8704,
+    "frac12": 189,
+    "frac14": 188,
+    "frac34": 190,
+    "frasl": 8260,
+    "gamma": 947,
+    "ge": 8805,
+    "gt": 62,
+    "hArr": 8660,
+    "harr": 8596,
+    "hearts": 9829,
+    "hellip": 8230,
+    "iacute": 237,
+    "icirc": 238,
+    "iexcl": 161,
+    "igrave": 236,
+    "image": 8465,
+    "infin": 8734,
+    "int": 8747,
+    "iota": 953,
+    "iquest": 191,
+    "isin": 8712,
+    "iuml": 239,
+    "kappa": 954,
+    "lArr": 8656,
+    "lambda": 955,
+    "lang": 9001,
+    "laquo": 171,
+    "larr": 8592,
+    "lceil": 8968,
+    "ldquo": 8220,
+    "le": 8804,
+    "lfloor": 8970,
+    "lowast": 8727,
+    "loz": 9674,
+    "lrm": 8206,
+    "lsaquo": 8249,
+    "lsquo": 8216,
+    "lt": 60,
+    "macr": 175,
+    "mdash": 8212,
+    "micro": 181,
+    "middot": 183,
+    "minus": 8722,
+    "mu": 956,
+    "nabla": 8711,
+    "nbsp": 160,
+    "ndash": 8211,
+    "ne": 8800,
+    "ni": 8715,
+    "not": 172,
+    "notin": 8713,
+    "nsub": 8836,
+    "ntilde": 241,
+    "nu": 957,
+    "oacute": 243,
+    "ocirc": 244,
+    "oelig": 339,
+    "ograve": 242,
+    "oline": 8254,
+    "omega": 969,
+    "omicron": 959,
+    "oplus": 8853,
+    "or": 8744,
+    "ordf": 170,
+    "ordm": 186,
+    "oslash": 248,
+    "otilde": 245,
+    "otimes": 8855,
+    "ouml": 246,
+    "para": 182,
+    "part": 8706,
+    "permil": 8240,
+    "perp": 8869,
+    "phi": 966,
+    "pi": 960,
+    "piv": 982,
+    "plusmn": 177,
+    "pound": 163,
+    "prime": 8242,
+    "prod": 8719,
+    "prop": 8733,
+    "psi": 968,
+    "quot": 34,
+    "rArr": 8658,
+    "radic": 8730,
+    "rang": 9002,
+    "raquo": 187,
+    "rarr": 8594,
+    "rceil": 8969,
+    "rdquo": 8221,
+    "real": 8476,
+    "reg": 174,
+    "rfloor": 8971,
+    "rho": 961,
+    "rlm": 8207,
+    "rsaquo": 8250,
+    "rsquo": 8217,
+    "sbquo": 8218,
+    "scaron": 353,
+    "sdot": 8901,
+    "sect": 167,
+    "shy": 173,
+    "sigma": 963,
+    "sigmaf": 962,
+    "sim": 8764,
+    "spades": 9824,
+    "sub": 8834,
+    "sube": 8838,
+    "sum": 8721,
+    "sup": 8835,
+    "sup1": 185,
+    "sup2": 178,
+    "sup3": 179,
+    "supe": 8839,
+    "szlig": 223,
+    "tau": 964,
+    "there4": 8756,
+    "theta": 952,
+    "thetasym": 977,
+    "thinsp": 8201,
+    "thorn": 254,
+    "tilde": 732,
+    "times": 215,
+    "trade": 8482,
+    "uArr": 8657,
+    "uacute": 250,
+    "uarr": 8593,
+    "ucirc": 251,
+    "ugrave": 249,
+    "uml": 168,
+    "upsih": 978,
+    "upsilon": 965,
+    "uuml": 252,
+    "weierp": 8472,
+    "xi": 958,
+    "yacute": 253,
+    "yen": 165,
+    "yuml": 255,
+    "zeta": 950,
+    "zwj": 8205,
+    "zwnj": 8204,
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_native.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_native.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd08752cd8940f01f85e51a6477cf72b3e5e517e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_native.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._native
+~~~~~~~~~~~~~~~~~~
+
+Native Python implementation used when the C module is not compiled.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+from . import Markup
+from ._compat import text_type
+
+
+def escape(s):
+    """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
+    the string with HTML-safe sequences. Use this if you need to display
+    text that might contain such characters in HTML.
+
+    If the object has an ``__html__`` method, it is called and the
+    return value is assumed to already be safe for HTML.
+
+    :param s: An object to be converted to a string and escaped.
+    :return: A :class:`Markup` string with the escaped text.
+    """
+    if hasattr(s, "__html__"):
+        return Markup(s.__html__())
+    return Markup(
+        text_type(s)
+        .replace("&", "&amp;")
+        .replace(">", "&gt;")
+        .replace("<", "&lt;")
+        .replace("'", "&#39;")
+        .replace('"', "&#34;")
+    )
+
+
+def escape_silent(s):
+    """Like :func:`escape` but treats ``None`` as the empty string.
+    Useful with optional values, as otherwise you get the string
+    ``'None'`` when the value is ``None``.
+
+    >>> escape(None)
+    Markup('None')
+    >>> escape_silent(None)
+    Markup('')
+    """
+    if s is None:
+        return Markup()
+    return escape(s)
+
+
+def soft_unicode(s):
+    """Convert an object to a string if it isn't already. This preserves
+    a :class:`Markup` string rather than converting it back to a basic
+    string, so it will still be marked as safe and won't be escaped
+    again.
+
+    >>> value = escape('<User 1>')
+    >>> value
+    Markup('&lt;User 1&gt;')
+    >>> escape(str(value))
+    Markup('&amp;lt;User 1&amp;gt;')
+    >>> escape(soft_unicode(value))
+    Markup('&lt;User 1&gt;')
+    """
+    if not isinstance(s, text_type):
+        s = text_type(s)
+    return s
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.c b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.c
new file mode 100644
index 0000000000000000000000000000000000000000..12d2c4a7d8352f6bf1deb19790453eb529827a78
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.c
@@ -0,0 +1,423 @@
+/**
+ * markupsafe._speedups
+ * ~~~~~~~~~~~~~~~~~~~~
+ *
+ * C implementation of escaping for better performance. Used instead of
+ * the native Python implementation when compiled.
+ *
+ * :copyright: 2010 Pallets
+ * :license: BSD-3-Clause
+ */
+#include <Python.h>
+
+#if PY_MAJOR_VERSION < 3
+#define ESCAPED_CHARS_TABLE_SIZE 63
+#define UNICHR(x) (PyUnicode_AS_UNICODE((PyUnicodeObject*)PyUnicode_DecodeASCII(x, strlen(x), NULL)));
+
+static Py_ssize_t escaped_chars_delta_len[ESCAPED_CHARS_TABLE_SIZE];
+static Py_UNICODE *escaped_chars_repl[ESCAPED_CHARS_TABLE_SIZE];
+#endif
+
+static PyObject* markup;
+
+static int
+init_constants(void)
+{
+	PyObject *module;
+
+#if PY_MAJOR_VERSION < 3
+	/* mapping of characters to replace */
+	escaped_chars_repl['"'] = UNICHR("&#34;");
+	escaped_chars_repl['\''] = UNICHR("&#39;");
+	escaped_chars_repl['&'] = UNICHR("&amp;");
+	escaped_chars_repl['<'] = UNICHR("&lt;");
+	escaped_chars_repl['>'] = UNICHR("&gt;");
+
+	/* lengths of those characters when replaced - 1 */
+	memset(escaped_chars_delta_len, 0, sizeof (escaped_chars_delta_len));
+	escaped_chars_delta_len['"'] = escaped_chars_delta_len['\''] = \
+		escaped_chars_delta_len['&'] = 4;
+	escaped_chars_delta_len['<'] = escaped_chars_delta_len['>'] = 3;
+#endif
+
+	/* import markup type so that we can mark the return value */
+	module = PyImport_ImportModule("markupsafe");
+	if (!module)
+		return 0;
+	markup = PyObject_GetAttrString(module, "Markup");
+	Py_DECREF(module);
+
+	return 1;
+}
+
+#if PY_MAJOR_VERSION < 3
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	PyUnicodeObject *out;
+	Py_UNICODE *inp = PyUnicode_AS_UNICODE(in);
+	const Py_UNICODE *inp_end = PyUnicode_AS_UNICODE(in) + PyUnicode_GET_SIZE(in);
+	Py_UNICODE *next_escp;
+	Py_UNICODE *outp;
+	Py_ssize_t delta=0, erepl=0, delta_len=0;
+
+	/* First we need to figure out how long the escaped string will be */
+	while (*(inp) || inp < inp_end) {
+		if (*inp < ESCAPED_CHARS_TABLE_SIZE) {
+			delta += escaped_chars_delta_len[*inp];
+			erepl += !!escaped_chars_delta_len[*inp];
+		}
+		++inp;
+	}
+
+	/* Do we need to escape anything at all? */
+	if (!erepl) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = (PyUnicodeObject*)PyUnicode_FromUnicode(NULL, PyUnicode_GET_SIZE(in) + delta);
+	if (!out)
+		return NULL;
+
+	outp = PyUnicode_AS_UNICODE(out);
+	inp = PyUnicode_AS_UNICODE(in);
+	while (erepl-- > 0) {
+		/* look for the next substitution */
+		next_escp = inp;
+		while (next_escp < inp_end) {
+			if (*next_escp < ESCAPED_CHARS_TABLE_SIZE &&
+			    (delta_len = escaped_chars_delta_len[*next_escp])) {
+				++delta_len;
+				break;
+			}
+			++next_escp;
+		}
+
+		if (next_escp > inp) {
+			/* copy unescaped chars between inp and next_escp */
+			Py_UNICODE_COPY(outp, inp, next_escp-inp);
+			outp += next_escp - inp;
+		}
+
+		/* escape 'next_escp' */
+		Py_UNICODE_COPY(outp, escaped_chars_repl[*next_escp], delta_len);
+		outp += delta_len;
+
+		inp = next_escp + 1;
+	}
+	if (inp < inp_end)
+		Py_UNICODE_COPY(outp, inp, PyUnicode_GET_SIZE(in) - (inp - PyUnicode_AS_UNICODE(in)));
+
+	return (PyObject*)out;
+}
+#else /* PY_MAJOR_VERSION < 3 */
+
+#define GET_DELTA(inp, inp_end, delta) \
+	while (inp < inp_end) {	 \
+		switch (*inp++) {	   \
+		case '"':			   \
+		case '\'':			  \
+		case '&':			   \
+			delta += 4;		 \
+			break;			  \
+		case '<':			   \
+		case '>':			   \
+			delta += 3;		 \
+			break;			  \
+		}					   \
+	}
+
+#define DO_ESCAPE(inp, inp_end, outp) \
+	{  \
+		Py_ssize_t ncopy = 0;  \
+		while (inp < inp_end) {  \
+			switch (*inp) {  \
+			case '"':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '4';  \
+				*outp++ = ';';  \
+				break;  \
+			case '\'':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '9';  \
+				*outp++ = ';';  \
+				break;  \
+			case '&':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'a';  \
+				*outp++ = 'm';  \
+				*outp++ = 'p';  \
+				*outp++ = ';';  \
+				break;  \
+			case '<':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'l';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			case '>':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'g';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			default:  \
+				ncopy++; \
+			}  \
+            inp++; \
+		}  \
+		memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+	}
+
+static PyObject*
+escape_unicode_kind1(PyUnicodeObject *in)
+{
+	Py_UCS1 *inp = PyUnicode_1BYTE_DATA(in);
+	Py_UCS1 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS1 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta,
+						PyUnicode_IS_ASCII(in) ? 127 : 255);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_1BYTE_DATA(in);
+	outp = PyUnicode_1BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode_kind2(PyUnicodeObject *in)
+{
+	Py_UCS2 *inp = PyUnicode_2BYTE_DATA(in);
+	Py_UCS2 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS2 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 65535);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_2BYTE_DATA(in);
+	outp = PyUnicode_2BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+
+static PyObject*
+escape_unicode_kind4(PyUnicodeObject *in)
+{
+	Py_UCS4 *inp = PyUnicode_4BYTE_DATA(in);
+	Py_UCS4 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS4 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 1114111);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_4BYTE_DATA(in);
+	outp = PyUnicode_4BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	if (PyUnicode_READY(in))
+		return NULL;
+
+	switch (PyUnicode_KIND(in)) {
+	case PyUnicode_1BYTE_KIND:
+		return escape_unicode_kind1(in);
+	case PyUnicode_2BYTE_KIND:
+		return escape_unicode_kind2(in);
+	case PyUnicode_4BYTE_KIND:
+		return escape_unicode_kind4(in);
+	}
+	assert(0);  /* shouldn't happen */
+	return NULL;
+}
+#endif /* PY_MAJOR_VERSION < 3 */
+
+static PyObject*
+escape(PyObject *self, PyObject *text)
+{
+	static PyObject *id_html;
+	PyObject *s = NULL, *rv = NULL, *html;
+
+	if (id_html == NULL) {
+#if PY_MAJOR_VERSION < 3
+		id_html = PyString_InternFromString("__html__");
+#else
+		id_html = PyUnicode_InternFromString("__html__");
+#endif
+		if (id_html == NULL) {
+			return NULL;
+		}
+	}
+
+	/* we don't have to escape integers, bools or floats */
+	if (PyLong_CheckExact(text) ||
+#if PY_MAJOR_VERSION < 3
+	    PyInt_CheckExact(text) ||
+#endif
+	    PyFloat_CheckExact(text) || PyBool_Check(text) ||
+	    text == Py_None)
+		return PyObject_CallFunctionObjArgs(markup, text, NULL);
+
+	/* if the object has an __html__ method that performs the escaping */
+	html = PyObject_GetAttr(text ,id_html);
+	if (html) {
+		s = PyObject_CallObject(html, NULL);
+		Py_DECREF(html);
+		if (s == NULL) {
+			return NULL;
+		}
+		/* Convert to Markup object */
+		rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+		Py_DECREF(s);
+		return rv;
+	}
+
+	/* otherwise make the object unicode if it isn't, then escape */
+	PyErr_Clear();
+	if (!PyUnicode_Check(text)) {
+#if PY_MAJOR_VERSION < 3
+		PyObject *unicode = PyObject_Unicode(text);
+#else
+		PyObject *unicode = PyObject_Str(text);
+#endif
+		if (!unicode)
+			return NULL;
+		s = escape_unicode((PyUnicodeObject*)unicode);
+		Py_DECREF(unicode);
+	}
+	else
+		s = escape_unicode((PyUnicodeObject*)text);
+
+	/* convert the unicode string into a markup object. */
+	rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+	Py_DECREF(s);
+	return rv;
+}
+
+
+static PyObject*
+escape_silent(PyObject *self, PyObject *text)
+{
+	if (text != Py_None)
+		return escape(self, text);
+	return PyObject_CallFunctionObjArgs(markup, NULL);
+}
+
+
+static PyObject*
+soft_unicode(PyObject *self, PyObject *s)
+{
+	if (!PyUnicode_Check(s))
+#if PY_MAJOR_VERSION < 3
+		return PyObject_Unicode(s);
+#else
+		return PyObject_Str(s);
+#endif
+	Py_INCREF(s);
+	return s;
+}
+
+
+static PyMethodDef module_methods[] = {
+	{"escape", (PyCFunction)escape, METH_O,
+	 "escape(s) -> markup\n\n"
+	 "Convert the characters &, <, >, ', and \" in string s to HTML-safe\n"
+	 "sequences.  Use this if you need to display text that might contain\n"
+	 "such characters in HTML.  Marks return value as markup string."},
+	{"escape_silent", (PyCFunction)escape_silent, METH_O,
+	 "escape_silent(s) -> markup\n\n"
+	 "Like escape but converts None to an empty string."},
+	{"soft_unicode", (PyCFunction)soft_unicode, METH_O,
+	 "soft_unicode(object) -> string\n\n"
+         "Make a string unicode if it isn't already.  That way a markup\n"
+         "string is not converted back to unicode."},
+	{NULL, NULL, 0, NULL}		/* Sentinel */
+};
+
+
+#if PY_MAJOR_VERSION < 3
+
+#ifndef PyMODINIT_FUNC	/* declarations for DLL import/export */
+#define PyMODINIT_FUNC void
+#endif
+PyMODINIT_FUNC
+init_speedups(void)
+{
+	if (!init_constants())
+		return;
+
+	Py_InitModule3("markupsafe._speedups", module_methods, "");
+}
+
+#else /* Python 3.x module initialization */
+
+static struct PyModuleDef module_definition = {
+        PyModuleDef_HEAD_INIT,
+	"markupsafe._speedups",
+	NULL,
+	-1,
+	module_methods,
+	NULL,
+	NULL,
+	NULL,
+	NULL
+};
+
+PyMODINIT_FUNC
+PyInit__speedups(void)
+{
+	if (!init_constants())
+		return NULL;
+
+	return PyModule_Create(&module_definition);
+}
+
+#endif
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..8a6da23c833c24ed7d0dae6896c707de86852812
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..864b2d7ee610e872fae66ff823d5b691bc3277c1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/METADATA
@@ -0,0 +1,362 @@
+Metadata-Version: 2.1
+Name: msgpack
+Version: 0.6.2
+Summary: MessagePack (de)serializer.
+Home-page: https://msgpack.org/
+Author: INADA Naoki
+Author-email: songofacandy@gmail.com
+License: Apache 2.0
+Project-URL: Documentation, https://msgpack-python.readthedocs.io/
+Project-URL: Source, https://github.com/msgpack/msgpack-python
+Project-URL: Tracker, https://github.com/msgpack/msgpack-python/issues
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Description-Content-Type: text/x-rst
+
+======================
+MessagePack for Python
+======================
+
+.. image:: https://travis-ci.org/msgpack/msgpack-python.svg?branch=master
+   :target: https://travis-ci.org/msgpack/msgpack-python
+   :alt: Build Status
+
+.. image:: https://readthedocs.org/projects/msgpack-python/badge/?version=latest
+   :target: https://msgpack-python.readthedocs.io/en/latest/?badge=latest
+   :alt: Documentation Status
+
+
+What's this
+-----------
+
+`MessagePack <https://msgpack.org/>`_ is an efficient binary serialization format.
+It lets you exchange data among multiple languages like JSON.
+But it's faster and smaller.
+This package provides CPython bindings for reading and writing MessagePack data.
+
+
+Very important notes for existing users
+---------------------------------------
+
+PyPI package name
+^^^^^^^^^^^^^^^^^
+
+TL;DR: When upgrading from msgpack-0.4 or earlier, don't do `pip install -U msgpack-python`.
+Do `pip uninstall msgpack-python; pip install msgpack` instead.
+
+Package name on PyPI was changed to msgpack from 0.5.
+I upload transitional package (msgpack-python 0.5 which depending on msgpack)
+for smooth transition from msgpack-python to msgpack.
+
+Sadly, this doesn't work for upgrade install.  After `pip install -U msgpack-python`,
+msgpack is removed and `import msgpack` fail.
+
+
+Deprecating encoding option
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+encoding and unicode_errors options are deprecated.
+
+In case of packer, use UTF-8 always.  Storing other than UTF-8 is not recommended.
+
+For backward compatibility, you can use ``use_bin_type=False`` and pack ``bytes``
+object into msgpack raw type.
+
+In case of unpacker, there is new ``raw`` option.  It is ``True`` by default
+for backward compatibility, but it is changed to ``False`` in near future.
+You can use ``raw=False`` instead of ``encoding='utf-8'``.
+
+Planned backward incompatible changes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When msgpack 1.0, I planning these breaking changes:
+
+* packer and unpacker: Remove ``encoding`` and ``unicode_errors`` option.
+* packer: Change default of ``use_bin_type`` option from False to True.
+* unpacker: Change default of ``raw`` option from True to False.
+* unpacker: Reduce all ``max_xxx_len`` options for typical usage.
+* unpacker: Remove ``write_bytes`` option from all methods.
+
+To avoid these breaking changes breaks your application, please:
+
+* Don't use deprecated options.
+* Pass ``use_bin_type`` and ``raw`` options explicitly.
+* If your application handle large (>1MB) data, specify ``max_xxx_len`` options too.
+
+
+Install
+-------
+
+::
+
+   $ pip install msgpack
+
+PyPy
+^^^^
+
+msgpack provides a pure Python implementation.  PyPy can use this.
+
+Windows
+^^^^^^^
+
+When you can't use a binary distribution, you need to install Visual Studio
+or Windows SDK on Windows.
+Without extension, using pure Python implementation on CPython runs slowly.
+
+For Python 2.7, `Microsoft Visual C++ Compiler for Python 2.7 <https://www.microsoft.com/en-us/download/details.aspx?id=44266>`_
+is recommended solution.
+
+For Python 3.5, `Microsoft Visual Studio 2015 <https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx>`_
+Community Edition or Express Edition can be used to build extension module.
+
+
+How to use
+----------
+
+One-shot pack & unpack
+^^^^^^^^^^^^^^^^^^^^^^
+
+Use ``packb`` for packing and ``unpackb`` for unpacking.
+msgpack provides ``dumps`` and ``loads`` as an alias for compatibility with
+``json`` and ``pickle``.
+
+``pack`` and ``dump`` packs to a file-like object.
+``unpack`` and ``load`` unpacks from a file-like object.
+
+.. code-block:: pycon
+
+   >>> import msgpack
+   >>> msgpack.packb([1, 2, 3], use_bin_type=True)
+   '\x93\x01\x02\x03'
+   >>> msgpack.unpackb(_, raw=False)
+   [1, 2, 3]
+
+``unpack`` unpacks msgpack's array to Python's list, but can also unpack to tuple:
+
+.. code-block:: pycon
+
+   >>> msgpack.unpackb(b'\x93\x01\x02\x03', use_list=False, raw=False)
+   (1, 2, 3)
+
+You should always specify the ``use_list`` keyword argument for backward compatibility.
+See performance issues relating to `use_list option`_ below.
+
+Read the docstring for other options.
+
+
+Streaming unpacking
+^^^^^^^^^^^^^^^^^^^
+
+``Unpacker`` is a "streaming unpacker". It unpacks multiple objects from one
+stream (or from bytes provided through its ``feed`` method).
+
+.. code-block:: python
+
+   import msgpack
+   from io import BytesIO
+
+   buf = BytesIO()
+   for i in range(100):
+      buf.write(msgpack.packb(i, use_bin_type=True))
+
+   buf.seek(0)
+
+   unpacker = msgpack.Unpacker(buf, raw=False)
+   for unpacked in unpacker:
+       print(unpacked)
+
+
+Packing/unpacking of custom data type
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+It is also possible to pack/unpack custom data types. Here is an example for
+``datetime.datetime``.
+
+.. code-block:: python
+
+    import datetime
+    import msgpack
+
+    useful_dict = {
+        "id": 1,
+        "created": datetime.datetime.now(),
+    }
+
+    def decode_datetime(obj):
+        if b'__datetime__' in obj:
+            obj = datetime.datetime.strptime(obj["as_str"], "%Y%m%dT%H:%M:%S.%f")
+        return obj
+
+    def encode_datetime(obj):
+        if isinstance(obj, datetime.datetime):
+            return {'__datetime__': True, 'as_str': obj.strftime("%Y%m%dT%H:%M:%S.%f")}
+        return obj
+
+
+    packed_dict = msgpack.packb(useful_dict, default=encode_datetime, use_bin_type=True)
+    this_dict_again = msgpack.unpackb(packed_dict, object_hook=decode_datetime, raw=False)
+
+``Unpacker``'s ``object_hook`` callback receives a dict; the
+``object_pairs_hook`` callback may instead be used to receive a list of
+key-value pairs.
+
+
+Extended types
+^^^^^^^^^^^^^^
+
+It is also possible to pack/unpack custom data types using the **ext** type.
+
+.. code-block:: pycon
+
+    >>> import msgpack
+    >>> import array
+    >>> def default(obj):
+    ...     if isinstance(obj, array.array) and obj.typecode == 'd':
+    ...         return msgpack.ExtType(42, obj.tostring())
+    ...     raise TypeError("Unknown type: %r" % (obj,))
+    ...
+    >>> def ext_hook(code, data):
+    ...     if code == 42:
+    ...         a = array.array('d')
+    ...         a.fromstring(data)
+    ...         return a
+    ...     return ExtType(code, data)
+    ...
+    >>> data = array.array('d', [1.2, 3.4])
+    >>> packed = msgpack.packb(data, default=default, use_bin_type=True)
+    >>> unpacked = msgpack.unpackb(packed, ext_hook=ext_hook, raw=False)
+    >>> data == unpacked
+    True
+
+
+Advanced unpacking control
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+As an alternative to iteration, ``Unpacker`` objects provide ``unpack``,
+``skip``, ``read_array_header`` and ``read_map_header`` methods. The former two
+read an entire message from the stream, respectively de-serialising and returning
+the result, or ignoring it. The latter two methods return the number of elements
+in the upcoming container, so that each element in an array, or key-value pair
+in a map, can be unpacked or skipped individually.
+
+Each of these methods may optionally write the packed data it reads to a
+callback function:
+
+.. code-block:: python
+
+    from io import BytesIO
+
+    def distribute(unpacker, get_worker):
+        nelems = unpacker.read_map_header()
+        for i in range(nelems):
+            # Select a worker for the given key
+            key = unpacker.unpack()
+            worker = get_worker(key)
+
+            # Send the value as a packed message to worker
+            bytestream = BytesIO()
+            unpacker.skip(bytestream.write)
+            worker.send(bytestream.getvalue())
+
+
+Notes
+-----
+
+string and binary type
+^^^^^^^^^^^^^^^^^^^^^^
+
+Early versions of msgpack didn't distinguish string and binary types (like Python 1).
+The type for representing both string and binary types was named **raw**.
+
+For backward compatibility reasons, msgpack-python will still default all
+strings to byte strings, unless you specify the ``use_bin_type=True`` option in
+the packer. If you do so, it will use a non-standard type called **bin** to
+serialize byte arrays, and **raw** becomes to mean **str**. If you want to
+distinguish **bin** and **raw** in the unpacker, specify ``raw=False``.
+
+Note that Python 2 defaults to byte-arrays over Unicode strings:
+
+.. code-block:: pycon
+
+    >>> import msgpack
+    >>> msgpack.unpackb(msgpack.packb([b'spam', u'eggs']))
+    ['spam', 'eggs']
+    >>> msgpack.unpackb(msgpack.packb([b'spam', u'eggs'], use_bin_type=True),
+                        raw=False)
+    ['spam', u'eggs']
+
+This is the same code in Python 3 (same behaviour, but Python 3 has a
+different default):
+
+.. code-block:: pycon
+
+    >>> import msgpack
+    >>> msgpack.unpackb(msgpack.packb([b'spam', u'eggs']))
+    [b'spam', b'eggs']
+    >>> msgpack.unpackb(msgpack.packb([b'spam', u'eggs'], use_bin_type=True),
+                        raw=False)
+    [b'spam', 'eggs']
+
+
+ext type
+^^^^^^^^
+
+To use the **ext** type, pass ``msgpack.ExtType`` object to packer.
+
+.. code-block:: pycon
+
+    >>> import msgpack
+    >>> packed = msgpack.packb(msgpack.ExtType(42, b'xyzzy'))
+    >>> msgpack.unpackb(packed)
+    ExtType(code=42, data='xyzzy')
+
+You can use it with ``default`` and ``ext_hook``. See below.
+
+
+Note about performance
+----------------------
+
+GC
+^^
+
+CPython's GC starts when growing allocated object.
+This means unpacking may cause useless GC.
+You can use ``gc.disable()`` when unpacking large message.
+
+use_list option
+^^^^^^^^^^^^^^^
+
+List is the default sequence type of Python.
+But tuple is lighter than list.
+You can use ``use_list=False`` while unpacking when performance is important.
+
+Python's dict can't use list as key and MessagePack allows array for key of mapping.
+``use_list=False`` allows unpacking such message.
+Another way to unpacking such object is using ``object_pairs_hook``.
+
+
+Development
+-----------
+
+Test
+^^^^
+
+MessagePack uses `pytest` for testing.
+Run test with following command:
+
+    $ make test
+
+
+..
+    vim: filetype=rst
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..2fb12f5cb14eb09e58fa8afaeb26bf467228eb56
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/RECORD
@@ -0,0 +1,19 @@
+msgpack/__init__.py,sha256=LnKzG5v0RyZgs7KlY2-SZYDBn-toylovXxKiXR6C-IQ,1535
+msgpack/_cmsgpack.cpython-38-x86_64-linux-gnu.so,sha256=jGeCQXkis3UmFaoz99cBkapiin3ShFeg86LUE_Gr3KE,163216
+msgpack/_version.py,sha256=72BxB5FMl1q3Nz1hteHINzHhrFpXQ9nNtULaK52NLk8,20
+msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081
+msgpack/fallback.py,sha256=vXo6S67Dmil9mz0PRBCLDu6znpv6CGKt9WPCEsdZx2A,37454
+msgpack-0.6.2.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+msgpack-0.6.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+msgpack-0.6.2.dist-info/METADATA,sha256=XqJQhIgvItD8TV_f6nnk3-HmYNQYGpO2497tnwqJskU,10833
+msgpack-0.6.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+msgpack-0.6.2.dist-info/top_level.txt,sha256=2tykSY1pXdiA2xYTDR6jPw0qI5ZGxRihyhf4S5hZyXk,8
+msgpack-0.6.2.dist-info/RECORD,,
+msgpack-0.6.2.dist-info/__pycache__,,
+msgpack/__pycache__,,
+msgpack/_version.cpython-38.pyc,,
+msgpack-0.6.2.dist-info/INSTALLER,,
+msgpack/fallback.cpython-38.pyc,,
+msgpack/exceptions.cpython-38.pyc,,
+msgpack-0.6.2.virtualenv,,
+msgpack/__init__.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3aae276bcd9d36403f6ea98de540624ae6b974cf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+msgpack
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack-0.6.2.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4ad9c1a5e1350ecdd950ddfb9e01f5dbb66c279f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/__init__.py
@@ -0,0 +1,65 @@
+# coding: utf-8
+from ._version import version
+from .exceptions import *
+
+from collections import namedtuple
+
+
+class ExtType(namedtuple('ExtType', 'code data')):
+    """ExtType represents ext type in msgpack."""
+    def __new__(cls, code, data):
+        if not isinstance(code, int):
+            raise TypeError("code must be int")
+        if not isinstance(data, bytes):
+            raise TypeError("data must be bytes")
+        if not 0 <= code <= 127:
+            raise ValueError("code must be 0~127")
+        return super(ExtType, cls).__new__(cls, code, data)
+
+
+import os
+if os.environ.get('MSGPACK_PUREPYTHON'):
+    from .fallback import Packer, unpackb, Unpacker
+else:
+    try:
+        from ._cmsgpack import Packer, unpackb, Unpacker
+    except ImportError:
+        from .fallback import Packer, unpackb, Unpacker
+
+
+def pack(o, stream, **kwargs):
+    """
+    Pack object `o` and write it to `stream`
+
+    See :class:`Packer` for options.
+    """
+    packer = Packer(**kwargs)
+    stream.write(packer.pack(o))
+
+
+def packb(o, **kwargs):
+    """
+    Pack object `o` and return packed bytes
+
+    See :class:`Packer` for options.
+    """
+    return Packer(**kwargs).pack(o)
+
+
+def unpack(stream, **kwargs):
+    """
+    Unpack an object from `stream`.
+
+    Raises `ExtraData` when `stream` contains extra bytes.
+    See :class:`Unpacker` for options.
+    """
+    data = stream.read()
+    return unpackb(data, **kwargs)
+
+
+# alias for compatibility to simplejson/marshal/pickle.
+load = unpack
+loads = unpackb
+
+dump = pack
+dumps = packb
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_cmsgpack.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_cmsgpack.cpython-38-x86_64-linux-gnu.so
new file mode 100644
index 0000000000000000000000000000000000000000..e06daf8313b3da4ad0281c6e4d6b03ebf970dd37
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_cmsgpack.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e73a00f631386ab8e3b0ed83f9f786f3c353554
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/_version.py
@@ -0,0 +1 @@
+version = (0, 6, 2)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d6d2615cfdd0b914d064cdf7eecd45761e4bcaf6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/exceptions.py
@@ -0,0 +1,48 @@
+class UnpackException(Exception):
+    """Base class for some exceptions raised while unpacking.
+
+    NOTE: unpack may raise exception other than subclass of
+    UnpackException.  If you want to catch all error, catch
+    Exception instead.
+    """
+
+
+class BufferFull(UnpackException):
+    pass
+
+
+class OutOfData(UnpackException):
+    pass
+
+
+class FormatError(ValueError, UnpackException):
+    """Invalid msgpack format"""
+
+
+class StackError(ValueError, UnpackException):
+    """Too nested"""
+
+
+# Deprecated.  Use ValueError instead
+UnpackValueError = ValueError
+
+
+class ExtraData(UnpackValueError):
+    """ExtraData is raised when there is trailing data.
+
+    This exception is raised while only one-shot (not streaming)
+    unpack.
+    """
+
+    def __init__(self, unpacked, extra):
+        self.unpacked = unpacked
+        self.extra = extra
+
+    def __str__(self):
+        return "unpack(b) received extra data."
+
+
+# Deprecated.  Use Exception instead to catch all exception during packing.
+PackException = Exception
+PackValueError = ValueError
+PackOverflowError = OverflowError
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/fallback.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/fallback.py
new file mode 100644
index 0000000000000000000000000000000000000000..3836e830b8f510c7a83efa96b98219503d05e235
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/msgpack/fallback.py
@@ -0,0 +1,1027 @@
+"""Fallback pure Python implementation of msgpack"""
+
+import sys
+import struct
+import warnings
+
+
+if sys.version_info[0] == 2:
+    PY2 = True
+    int_types = (int, long)
+    def dict_iteritems(d):
+        return d.iteritems()
+else:
+    PY2 = False
+    int_types = int
+    unicode = str
+    xrange = range
+    def dict_iteritems(d):
+        return d.items()
+
+if sys.version_info < (3, 5):
+    # Ugly hack...
+    RecursionError = RuntimeError
+
+    def _is_recursionerror(e):
+        return len(e.args) == 1 and isinstance(e.args[0], str) and \
+            e.args[0].startswith('maximum recursion depth exceeded')
+else:
+    def _is_recursionerror(e):
+        return True
+
+if hasattr(sys, 'pypy_version_info'):
+    # cStringIO is slow on PyPy, StringIO is faster.  However: PyPy's own
+    # StringBuilder is fastest.
+    from __pypy__ import newlist_hint
+    try:
+        from __pypy__.builders import BytesBuilder as StringBuilder
+    except ImportError:
+        from __pypy__.builders import StringBuilder
+    USING_STRINGBUILDER = True
+    class StringIO(object):
+        def __init__(self, s=b''):
+            if s:
+                self.builder = StringBuilder(len(s))
+                self.builder.append(s)
+            else:
+                self.builder = StringBuilder()
+        def write(self, s):
+            if isinstance(s, memoryview):
+                s = s.tobytes()
+            elif isinstance(s, bytearray):
+                s = bytes(s)
+            self.builder.append(s)
+        def getvalue(self):
+            return self.builder.build()
+else:
+    USING_STRINGBUILDER = False
+    from io import BytesIO as StringIO
+    newlist_hint = lambda size: []
+
+
+from .exceptions import (
+    BufferFull,
+    OutOfData,
+    ExtraData,
+    FormatError,
+    StackError,
+)
+
+from . import ExtType
+
+
+EX_SKIP                 = 0
+EX_CONSTRUCT            = 1
+EX_READ_ARRAY_HEADER    = 2
+EX_READ_MAP_HEADER      = 3
+
+TYPE_IMMEDIATE          = 0
+TYPE_ARRAY              = 1
+TYPE_MAP                = 2
+TYPE_RAW                = 3
+TYPE_BIN                = 4
+TYPE_EXT                = 5
+
+DEFAULT_RECURSE_LIMIT = 511
+
+
+def _check_type_strict(obj, t, type=type, tuple=tuple):
+    if type(t) is tuple:
+        return type(obj) in t
+    else:
+        return type(obj) is t
+
+
+def _get_data_from_buffer(obj):
+    try:
+        view = memoryview(obj)
+    except TypeError:
+        # try to use legacy buffer protocol if 2.7, otherwise re-raise
+        if PY2:
+            view = memoryview(buffer(obj))
+            warnings.warn("using old buffer interface to unpack %s; "
+                          "this leads to unpacking errors if slicing is used and "
+                          "will be removed in a future version" % type(obj),
+                          RuntimeWarning, stacklevel=3)
+        else:
+            raise
+    if view.itemsize != 1:
+        raise ValueError("cannot unpack from multi-byte object")
+    return view
+
+
+def unpack(stream, **kwargs):
+    warnings.warn(
+        "Direct calling implementation's unpack() is deprecated, Use msgpack.unpack() or unpackb() instead.",
+        DeprecationWarning, stacklevel=2)
+    data = stream.read()
+    return unpackb(data, **kwargs)
+
+
+def unpackb(packed, **kwargs):
+    """
+    Unpack an object from `packed`.
+
+    Raises ``ExtraData`` when *packed* contains extra bytes.
+    Raises ``ValueError`` when *packed* is incomplete.
+    Raises ``FormatError`` when *packed* is not valid msgpack.
+    Raises ``StackError`` when *packed* contains too nested.
+    Other exceptions can be raised during unpacking.
+
+    See :class:`Unpacker` for options.
+    """
+    unpacker = Unpacker(None, max_buffer_size=len(packed), **kwargs)
+    unpacker.feed(packed)
+    try:
+        ret = unpacker._unpack()
+    except OutOfData:
+        raise ValueError("Unpack failed: incomplete input")
+    except RecursionError as e:
+        if _is_recursionerror(e):
+            raise StackError
+        raise
+    if unpacker._got_extradata():
+        raise ExtraData(ret, unpacker._get_extradata())
+    return ret
+
+
+if sys.version_info < (2, 7, 6):
+    def _unpack_from(f, b, o=0):
+        """Explicit typcast for legacy struct.unpack_from"""
+        return struct.unpack_from(f, bytes(b), o)
+else:
+    _unpack_from = struct.unpack_from
+
+
+class Unpacker(object):
+    """Streaming unpacker.
+
+    arguments:
+
+    :param file_like:
+        File-like object having `.read(n)` method.
+        If specified, unpacker reads serialized data from it and :meth:`feed()` is not usable.
+
+    :param int read_size:
+        Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`)
+
+    :param bool use_list:
+        If true, unpack msgpack array to Python list.
+        Otherwise, unpack to Python tuple. (default: True)
+
+    :param bool raw:
+        If true, unpack msgpack raw to Python bytes (default).
+        Otherwise, unpack to Python str (or unicode on Python 2) by decoding
+        with UTF-8 encoding (recommended).
+        Currently, the default is true, but it will be changed to false in
+        near future.  So you must specify it explicitly for keeping backward
+        compatibility.
+
+        *encoding* option which is deprecated overrides this option.
+
+    :param bool strict_map_key:
+        If true, only str or bytes are accepted for map (dict) keys.
+        It's False by default for backward-compatibility.
+        But it will be True from msgpack 1.0.
+
+    :param callable object_hook:
+        When specified, it should be callable.
+        Unpacker calls it with a dict argument after unpacking msgpack map.
+        (See also simplejson)
+
+    :param callable object_pairs_hook:
+        When specified, it should be callable.
+        Unpacker calls it with a list of key-value pairs after unpacking msgpack map.
+        (See also simplejson)
+
+    :param str encoding:
+        Encoding used for decoding msgpack raw.
+        If it is None (default), msgpack raw is deserialized to Python bytes.
+
+    :param str unicode_errors:
+        (deprecated) Used for decoding msgpack raw with *encoding*.
+        (default: `'strict'`)
+
+    :param int max_buffer_size:
+        Limits size of data waiting unpacked.  0 means system's INT_MAX (default).
+        Raises `BufferFull` exception when it is insufficient.
+        You should set this parameter when unpacking data from untrusted source.
+
+    :param int max_str_len:
+        Deprecated, use *max_buffer_size* instead.
+        Limits max length of str. (default: max_buffer_size or 1024*1024)
+
+    :param int max_bin_len:
+        Deprecated, use *max_buffer_size* instead.
+        Limits max length of bin. (default: max_buffer_size or 1024*1024)
+
+    :param int max_array_len:
+        Limits max length of array.
+        (default: max_buffer_size or 128*1024)
+
+    :param int max_map_len:
+        Limits max length of map.
+        (default: max_buffer_size//2 or 32*1024)
+
+    :param int max_ext_len:
+        Deprecated, use *max_buffer_size* instead.
+        Limits max size of ext type.  (default: max_buffer_size or 1024*1024)
+
+    Example of streaming deserialize from file-like object::
+
+        unpacker = Unpacker(file_like, raw=False, max_buffer_size=10*1024*1024)
+        for o in unpacker:
+            process(o)
+
+    Example of streaming deserialize from socket::
+
+        unpacker = Unpacker(raw=False, max_buffer_size=10*1024*1024)
+        while True:
+            buf = sock.recv(1024**2)
+            if not buf:
+                break
+            unpacker.feed(buf)
+            for o in unpacker:
+                process(o)
+
+    Raises ``ExtraData`` when *packed* contains extra bytes.
+    Raises ``OutOfData`` when *packed* is incomplete.
+    Raises ``FormatError`` when *packed* is not valid msgpack.
+    Raises ``StackError`` when *packed* contains too nested.
+    Other exceptions can be raised during unpacking.
+    """
+
+    def __init__(self, file_like=None, read_size=0, use_list=True, raw=True, strict_map_key=False,
+                 object_hook=None, object_pairs_hook=None, list_hook=None,
+                 encoding=None, unicode_errors=None, max_buffer_size=0,
+                 ext_hook=ExtType,
+                 max_str_len=-1,
+                 max_bin_len=-1,
+                 max_array_len=-1,
+                 max_map_len=-1,
+                 max_ext_len=-1):
+        if encoding is not None:
+            warnings.warn(
+                "encoding is deprecated, Use raw=False instead.",
+                DeprecationWarning, stacklevel=2)
+
+        if unicode_errors is None:
+            unicode_errors = 'strict'
+
+        if file_like is None:
+            self._feeding = True
+        else:
+            if not callable(file_like.read):
+                raise TypeError("`file_like.read` must be callable")
+            self.file_like = file_like
+            self._feeding = False
+
+        #: array of bytes fed.
+        self._buffer = bytearray()
+        #: Which position we currently reads
+        self._buff_i = 0
+
+        # When Unpacker is used as an iterable, between the calls to next(),
+        # the buffer is not "consumed" completely, for efficiency sake.
+        # Instead, it is done sloppily.  To make sure we raise BufferFull at
+        # the correct moments, we have to keep track of how sloppy we were.
+        # Furthermore, when the buffer is incomplete (that is: in the case
+        # we raise an OutOfData) we need to rollback the buffer to the correct
+        # state, which _buf_checkpoint records.
+        self._buf_checkpoint = 0
+
+        if max_str_len == -1:
+            max_str_len = max_buffer_size or 1024*1024
+        if max_bin_len == -1:
+            max_bin_len = max_buffer_size or 1024*1024
+        if max_array_len == -1:
+            max_array_len = max_buffer_size or 128*1024
+        if max_map_len == -1:
+            max_map_len = max_buffer_size//2 or 32*1024
+        if max_ext_len == -1:
+            max_ext_len = max_buffer_size or 1024*1024
+
+        self._max_buffer_size = max_buffer_size or 2**31-1
+        if read_size > self._max_buffer_size:
+            raise ValueError("read_size must be smaller than max_buffer_size")
+        self._read_size = read_size or min(self._max_buffer_size, 16*1024)
+        self._raw = bool(raw)
+        self._strict_map_key = bool(strict_map_key)
+        self._encoding = encoding
+        self._unicode_errors = unicode_errors
+        self._use_list = use_list
+        self._list_hook = list_hook
+        self._object_hook = object_hook
+        self._object_pairs_hook = object_pairs_hook
+        self._ext_hook = ext_hook
+        self._max_str_len = max_str_len
+        self._max_bin_len = max_bin_len
+        self._max_array_len = max_array_len
+        self._max_map_len = max_map_len
+        self._max_ext_len = max_ext_len
+        self._stream_offset = 0
+
+        if list_hook is not None and not callable(list_hook):
+            raise TypeError('`list_hook` is not callable')
+        if object_hook is not None and not callable(object_hook):
+            raise TypeError('`object_hook` is not callable')
+        if object_pairs_hook is not None and not callable(object_pairs_hook):
+            raise TypeError('`object_pairs_hook` is not callable')
+        if object_hook is not None and object_pairs_hook is not None:
+            raise TypeError("object_pairs_hook and object_hook are mutually "
+                            "exclusive")
+        if not callable(ext_hook):
+            raise TypeError("`ext_hook` is not callable")
+
+    def feed(self, next_bytes):
+        assert self._feeding
+        view = _get_data_from_buffer(next_bytes)
+        if (len(self._buffer) - self._buff_i + len(view) > self._max_buffer_size):
+            raise BufferFull
+
+        # Strip buffer before checkpoint before reading file.
+        if self._buf_checkpoint > 0:
+            del self._buffer[:self._buf_checkpoint]
+            self._buff_i -= self._buf_checkpoint
+            self._buf_checkpoint = 0
+
+        # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython
+        self._buffer.extend(view)
+
+    def _consume(self):
+        """ Gets rid of the used parts of the buffer. """
+        self._stream_offset += self._buff_i - self._buf_checkpoint
+        self._buf_checkpoint = self._buff_i
+
+    def _got_extradata(self):
+        return self._buff_i < len(self._buffer)
+
+    def _get_extradata(self):
+        return self._buffer[self._buff_i:]
+
+    def read_bytes(self, n):
+        return self._read(n)
+
+    def _read(self, n):
+        # (int) -> bytearray
+        self._reserve(n)
+        i = self._buff_i
+        self._buff_i = i+n
+        return self._buffer[i:i+n]
+
+    def _reserve(self, n):
+        remain_bytes = len(self._buffer) - self._buff_i - n
+
+        # Fast path: buffer has n bytes already
+        if remain_bytes >= 0:
+            return
+
+        if self._feeding:
+            self._buff_i = self._buf_checkpoint
+            raise OutOfData
+
+        # Strip buffer before checkpoint before reading file.
+        if self._buf_checkpoint > 0:
+            del self._buffer[:self._buf_checkpoint]
+            self._buff_i -= self._buf_checkpoint
+            self._buf_checkpoint = 0
+
+        # Read from file
+        remain_bytes = -remain_bytes
+        while remain_bytes > 0:
+            to_read_bytes = max(self._read_size, remain_bytes)
+            read_data = self.file_like.read(to_read_bytes)
+            if not read_data:
+                break
+            assert isinstance(read_data, bytes)
+            self._buffer += read_data
+            remain_bytes -= len(read_data)
+
+        if len(self._buffer) < n + self._buff_i:
+            self._buff_i = 0  # rollback
+            raise OutOfData
+
+    def _read_header(self, execute=EX_CONSTRUCT):
+        typ = TYPE_IMMEDIATE
+        n = 0
+        obj = None
+        self._reserve(1)
+        b = self._buffer[self._buff_i]
+        self._buff_i += 1
+        if b & 0b10000000 == 0:
+            obj = b
+        elif b & 0b11100000 == 0b11100000:
+            obj = -1 - (b ^ 0xff)
+        elif b & 0b11100000 == 0b10100000:
+            n = b & 0b00011111
+            typ = TYPE_RAW
+            if n > self._max_str_len:
+                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
+            obj = self._read(n)
+        elif b & 0b11110000 == 0b10010000:
+            n = b & 0b00001111
+            typ = TYPE_ARRAY
+            if n > self._max_array_len:
+                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
+        elif b & 0b11110000 == 0b10000000:
+            n = b & 0b00001111
+            typ = TYPE_MAP
+            if n > self._max_map_len:
+                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
+        elif b == 0xc0:
+            obj = None
+        elif b == 0xc2:
+            obj = False
+        elif b == 0xc3:
+            obj = True
+        elif b == 0xc4:
+            typ = TYPE_BIN
+            self._reserve(1)
+            n = self._buffer[self._buff_i]
+            self._buff_i += 1
+            if n > self._max_bin_len:
+                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
+            obj = self._read(n)
+        elif b == 0xc5:
+            typ = TYPE_BIN
+            self._reserve(2)
+            n = _unpack_from(">H", self._buffer, self._buff_i)[0]
+            self._buff_i += 2
+            if n > self._max_bin_len:
+                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
+            obj = self._read(n)
+        elif b == 0xc6:
+            typ = TYPE_BIN
+            self._reserve(4)
+            n = _unpack_from(">I", self._buffer, self._buff_i)[0]
+            self._buff_i += 4
+            if n > self._max_bin_len:
+                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
+            obj = self._read(n)
+        elif b == 0xc7:  # ext 8
+            typ = TYPE_EXT
+            self._reserve(2)
+            L, n = _unpack_from('Bb', self._buffer, self._buff_i)
+            self._buff_i += 2
+            if L > self._max_ext_len:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
+            obj = self._read(L)
+        elif b == 0xc8:  # ext 16
+            typ = TYPE_EXT
+            self._reserve(3)
+            L, n = _unpack_from('>Hb', self._buffer, self._buff_i)
+            self._buff_i += 3
+            if L > self._max_ext_len:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
+            obj = self._read(L)
+        elif b == 0xc9:  # ext 32
+            typ = TYPE_EXT
+            self._reserve(5)
+            L, n = _unpack_from('>Ib', self._buffer, self._buff_i)
+            self._buff_i += 5
+            if L > self._max_ext_len:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
+            obj = self._read(L)
+        elif b == 0xca:
+            self._reserve(4)
+            obj = _unpack_from(">f", self._buffer, self._buff_i)[0]
+            self._buff_i += 4
+        elif b == 0xcb:
+            self._reserve(8)
+            obj = _unpack_from(">d", self._buffer, self._buff_i)[0]
+            self._buff_i += 8
+        elif b == 0xcc:
+            self._reserve(1)
+            obj = self._buffer[self._buff_i]
+            self._buff_i += 1
+        elif b == 0xcd:
+            self._reserve(2)
+            obj = _unpack_from(">H", self._buffer, self._buff_i)[0]
+            self._buff_i += 2
+        elif b == 0xce:
+            self._reserve(4)
+            obj = _unpack_from(">I", self._buffer, self._buff_i)[0]
+            self._buff_i += 4
+        elif b == 0xcf:
+            self._reserve(8)
+            obj = _unpack_from(">Q", self._buffer, self._buff_i)[0]
+            self._buff_i += 8
+        elif b == 0xd0:
+            self._reserve(1)
+            obj = _unpack_from("b", self._buffer, self._buff_i)[0]
+            self._buff_i += 1
+        elif b == 0xd1:
+            self._reserve(2)
+            obj = _unpack_from(">h", self._buffer, self._buff_i)[0]
+            self._buff_i += 2
+        elif b == 0xd2:
+            self._reserve(4)
+            obj = _unpack_from(">i", self._buffer, self._buff_i)[0]
+            self._buff_i += 4
+        elif b == 0xd3:
+            self._reserve(8)
+            obj = _unpack_from(">q", self._buffer, self._buff_i)[0]
+            self._buff_i += 8
+        elif b == 0xd4:  # fixext 1
+            typ = TYPE_EXT
+            if self._max_ext_len < 1:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (1, self._max_ext_len))
+            self._reserve(2)
+            n, obj = _unpack_from("b1s", self._buffer, self._buff_i)
+            self._buff_i += 2
+        elif b == 0xd5:  # fixext 2
+            typ = TYPE_EXT
+            if self._max_ext_len < 2:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (2, self._max_ext_len))
+            self._reserve(3)
+            n, obj = _unpack_from("b2s", self._buffer, self._buff_i)
+            self._buff_i += 3
+        elif b == 0xd6:  # fixext 4
+            typ = TYPE_EXT
+            if self._max_ext_len < 4:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (4, self._max_ext_len))
+            self._reserve(5)
+            n, obj = _unpack_from("b4s", self._buffer, self._buff_i)
+            self._buff_i += 5
+        elif b == 0xd7:  # fixext 8
+            typ = TYPE_EXT
+            if self._max_ext_len < 8:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (8, self._max_ext_len))
+            self._reserve(9)
+            n, obj = _unpack_from("b8s", self._buffer, self._buff_i)
+            self._buff_i += 9
+        elif b == 0xd8:  # fixext 16
+            typ = TYPE_EXT
+            if self._max_ext_len < 16:
+                raise ValueError("%s exceeds max_ext_len(%s)" % (16, self._max_ext_len))
+            self._reserve(17)
+            n, obj = _unpack_from("b16s", self._buffer, self._buff_i)
+            self._buff_i += 17
+        elif b == 0xd9:
+            typ = TYPE_RAW
+            self._reserve(1)
+            n = self._buffer[self._buff_i]
+            self._buff_i += 1
+            if n > self._max_str_len:
+                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
+            obj = self._read(n)
+        elif b == 0xda:
+            typ = TYPE_RAW
+            self._reserve(2)
+            n, = _unpack_from(">H", self._buffer, self._buff_i)
+            self._buff_i += 2
+            if n > self._max_str_len:
+                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
+            obj = self._read(n)
+        elif b == 0xdb:
+            typ = TYPE_RAW
+            self._reserve(4)
+            n, = _unpack_from(">I", self._buffer, self._buff_i)
+            self._buff_i += 4
+            if n > self._max_str_len:
+                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
+            obj = self._read(n)
+        elif b == 0xdc:
+            typ = TYPE_ARRAY
+            self._reserve(2)
+            n, = _unpack_from(">H", self._buffer, self._buff_i)
+            self._buff_i += 2
+            if n > self._max_array_len:
+                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
+        elif b == 0xdd:
+            typ = TYPE_ARRAY
+            self._reserve(4)
+            n, = _unpack_from(">I", self._buffer, self._buff_i)
+            self._buff_i += 4
+            if n > self._max_array_len:
+                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
+        elif b == 0xde:
+            self._reserve(2)
+            n, = _unpack_from(">H", self._buffer, self._buff_i)
+            self._buff_i += 2
+            if n > self._max_map_len:
+                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
+            typ = TYPE_MAP
+        elif b == 0xdf:
+            self._reserve(4)
+            n, = _unpack_from(">I", self._buffer, self._buff_i)
+            self._buff_i += 4
+            if n > self._max_map_len:
+                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
+            typ = TYPE_MAP
+        else:
+            raise FormatError("Unknown header: 0x%x" % b)
+        return typ, n, obj
+
+    def _unpack(self, execute=EX_CONSTRUCT):
+        typ, n, obj = self._read_header(execute)
+
+        if execute == EX_READ_ARRAY_HEADER:
+            if typ != TYPE_ARRAY:
+                raise ValueError("Expected array")
+            return n
+        if execute == EX_READ_MAP_HEADER:
+            if typ != TYPE_MAP:
+                raise ValueError("Expected map")
+            return n
+        # TODO should we eliminate the recursion?
+        if typ == TYPE_ARRAY:
+            if execute == EX_SKIP:
+                for i in xrange(n):
+                    # TODO check whether we need to call `list_hook`
+                    self._unpack(EX_SKIP)
+                return
+            ret = newlist_hint(n)
+            for i in xrange(n):
+                ret.append(self._unpack(EX_CONSTRUCT))
+            if self._list_hook is not None:
+                ret = self._list_hook(ret)
+            # TODO is the interaction between `list_hook` and `use_list` ok?
+            return ret if self._use_list else tuple(ret)
+        if typ == TYPE_MAP:
+            if execute == EX_SKIP:
+                for i in xrange(n):
+                    # TODO check whether we need to call hooks
+                    self._unpack(EX_SKIP)
+                    self._unpack(EX_SKIP)
+                return
+            if self._object_pairs_hook is not None:
+                ret = self._object_pairs_hook(
+                    (self._unpack(EX_CONSTRUCT),
+                     self._unpack(EX_CONSTRUCT))
+                    for _ in xrange(n))
+            else:
+                ret = {}
+                for _ in xrange(n):
+                    key = self._unpack(EX_CONSTRUCT)
+                    if self._strict_map_key and type(key) not in (unicode, bytes):
+                        raise ValueError("%s is not allowed for map key" % str(type(key)))
+                    ret[key] = self._unpack(EX_CONSTRUCT)
+                if self._object_hook is not None:
+                    ret = self._object_hook(ret)
+            return ret
+        if execute == EX_SKIP:
+            return
+        if typ == TYPE_RAW:
+            if self._encoding is not None:
+                obj = obj.decode(self._encoding, self._unicode_errors)
+            elif self._raw:
+                obj = bytes(obj)
+            else:
+                obj = obj.decode('utf_8')
+            return obj
+        if typ == TYPE_EXT:
+            return self._ext_hook(n, bytes(obj))
+        if typ == TYPE_BIN:
+            return bytes(obj)
+        assert typ == TYPE_IMMEDIATE
+        return obj
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        try:
+            ret = self._unpack(EX_CONSTRUCT)
+            self._consume()
+            return ret
+        except OutOfData:
+            self._consume()
+            raise StopIteration
+        except RecursionError:
+            raise StackError
+
+    next = __next__
+
+    def skip(self):
+        self._unpack(EX_SKIP)
+        self._consume()
+
+    def unpack(self):
+        try:
+            ret = self._unpack(EX_CONSTRUCT)
+        except RecursionError:
+            raise StackError
+        self._consume()
+        return ret
+
+    def read_array_header(self):
+        ret = self._unpack(EX_READ_ARRAY_HEADER)
+        self._consume()
+        return ret
+
+    def read_map_header(self):
+        ret = self._unpack(EX_READ_MAP_HEADER)
+        self._consume()
+        return ret
+
+    def tell(self):
+        return self._stream_offset
+
+
+class Packer(object):
+    """
+    MessagePack Packer
+
+    usage:
+
+        packer = Packer()
+        astream.write(packer.pack(a))
+        astream.write(packer.pack(b))
+
+    Packer's constructor has some keyword arguments:
+
+    :param callable default:
+        Convert user type to builtin type that Packer supports.
+        See also simplejson's document.
+
+    :param bool use_single_float:
+        Use single precision float type for float. (default: False)
+
+    :param bool autoreset:
+        Reset buffer after each pack and return its content as `bytes`. (default: True).
+        If set this to false, use `bytes()` to get content and `.reset()` to clear buffer.
+
+    :param bool use_bin_type:
+        Use bin type introduced in msgpack spec 2.0 for bytes.
+        It also enables str8 type for unicode.
+
+    :param bool strict_types:
+        If set to true, types will be checked to be exact. Derived classes
+        from serializeable types will not be serialized and will be
+        treated as unsupported type and forwarded to default.
+        Additionally tuples will not be serialized as lists.
+        This is useful when trying to implement accurate serialization
+        for python types.
+
+    :param str encoding:
+        (deprecated) Convert unicode to bytes with this encoding. (default: 'utf-8')
+
+    :param str unicode_errors:
+        Error handler for encoding unicode. (default: 'strict')
+    """
+    def __init__(self, default=None, encoding=None, unicode_errors=None,
+                 use_single_float=False, autoreset=True, use_bin_type=False,
+                 strict_types=False):
+        if encoding is None:
+            encoding = 'utf_8'
+        else:
+            warnings.warn(
+                "encoding is deprecated, Use raw=False instead.",
+                DeprecationWarning, stacklevel=2)
+
+        if unicode_errors is None:
+            unicode_errors = 'strict'
+
+        self._strict_types = strict_types
+        self._use_float = use_single_float
+        self._autoreset = autoreset
+        self._use_bin_type = use_bin_type
+        self._encoding = encoding
+        self._unicode_errors = unicode_errors
+        self._buffer = StringIO()
+        if default is not None:
+            if not callable(default):
+                raise TypeError("default must be callable")
+        self._default = default
+
+    def _pack(self, obj, nest_limit=DEFAULT_RECURSE_LIMIT,
+              check=isinstance, check_type_strict=_check_type_strict):
+        default_used = False
+        if self._strict_types:
+            check = check_type_strict
+            list_types = list
+        else:
+            list_types = (list, tuple)
+        while True:
+            if nest_limit < 0:
+                raise ValueError("recursion limit exceeded")
+            if obj is None:
+                return self._buffer.write(b"\xc0")
+            if check(obj, bool):
+                if obj:
+                    return self._buffer.write(b"\xc3")
+                return self._buffer.write(b"\xc2")
+            if check(obj, int_types):
+                if 0 <= obj < 0x80:
+                    return self._buffer.write(struct.pack("B", obj))
+                if -0x20 <= obj < 0:
+                    return self._buffer.write(struct.pack("b", obj))
+                if 0x80 <= obj <= 0xff:
+                    return self._buffer.write(struct.pack("BB", 0xcc, obj))
+                if -0x80 <= obj < 0:
+                    return self._buffer.write(struct.pack(">Bb", 0xd0, obj))
+                if 0xff < obj <= 0xffff:
+                    return self._buffer.write(struct.pack(">BH", 0xcd, obj))
+                if -0x8000 <= obj < -0x80:
+                    return self._buffer.write(struct.pack(">Bh", 0xd1, obj))
+                if 0xffff < obj <= 0xffffffff:
+                    return self._buffer.write(struct.pack(">BI", 0xce, obj))
+                if -0x80000000 <= obj < -0x8000:
+                    return self._buffer.write(struct.pack(">Bi", 0xd2, obj))
+                if 0xffffffff < obj <= 0xffffffffffffffff:
+                    return self._buffer.write(struct.pack(">BQ", 0xcf, obj))
+                if -0x8000000000000000 <= obj < -0x80000000:
+                    return self._buffer.write(struct.pack(">Bq", 0xd3, obj))
+                if not default_used and self._default is not None:
+                    obj = self._default(obj)
+                    default_used = True
+                    continue
+                raise OverflowError("Integer value out of range")
+            if check(obj, (bytes, bytearray)):
+                n = len(obj)
+                if n >= 2**32:
+                    raise ValueError("%s is too large" % type(obj).__name__)
+                self._pack_bin_header(n)
+                return self._buffer.write(obj)
+            if check(obj, unicode):
+                if self._encoding is None:
+                    raise TypeError(
+                        "Can't encode unicode string: "
+                        "no encoding is specified")
+                obj = obj.encode(self._encoding, self._unicode_errors)
+                n = len(obj)
+                if n >= 2**32:
+                    raise ValueError("String is too large")
+                self._pack_raw_header(n)
+                return self._buffer.write(obj)
+            if check(obj, memoryview):
+                n = len(obj) * obj.itemsize
+                if n >= 2**32:
+                    raise ValueError("Memoryview is too large")
+                self._pack_bin_header(n)
+                return self._buffer.write(obj)
+            if check(obj, float):
+                if self._use_float:
+                    return self._buffer.write(struct.pack(">Bf", 0xca, obj))
+                return self._buffer.write(struct.pack(">Bd", 0xcb, obj))
+            if check(obj, ExtType):
+                code = obj.code
+                data = obj.data
+                assert isinstance(code, int)
+                assert isinstance(data, bytes)
+                L = len(data)
+                if L == 1:
+                    self._buffer.write(b'\xd4')
+                elif L == 2:
+                    self._buffer.write(b'\xd5')
+                elif L == 4:
+                    self._buffer.write(b'\xd6')
+                elif L == 8:
+                    self._buffer.write(b'\xd7')
+                elif L == 16:
+                    self._buffer.write(b'\xd8')
+                elif L <= 0xff:
+                    self._buffer.write(struct.pack(">BB", 0xc7, L))
+                elif L <= 0xffff:
+                    self._buffer.write(struct.pack(">BH", 0xc8, L))
+                else:
+                    self._buffer.write(struct.pack(">BI", 0xc9, L))
+                self._buffer.write(struct.pack("b", code))
+                self._buffer.write(data)
+                return
+            if check(obj, list_types):
+                n = len(obj)
+                self._pack_array_header(n)
+                for i in xrange(n):
+                    self._pack(obj[i], nest_limit - 1)
+                return
+            if check(obj, dict):
+                return self._pack_map_pairs(len(obj), dict_iteritems(obj),
+                                               nest_limit - 1)
+            if not default_used and self._default is not None:
+                obj = self._default(obj)
+                default_used = 1
+                continue
+            raise TypeError("Cannot serialize %r" % (obj, ))
+
+    def pack(self, obj):
+        try:
+            self._pack(obj)
+        except:
+            self._buffer = StringIO()  # force reset
+            raise
+        if self._autoreset:
+            ret = self._buffer.getvalue()
+            self._buffer = StringIO()
+            return ret
+
+    def pack_map_pairs(self, pairs):
+        self._pack_map_pairs(len(pairs), pairs)
+        if self._autoreset:
+            ret = self._buffer.getvalue()
+            self._buffer = StringIO()
+            return ret
+
+    def pack_array_header(self, n):
+        if n >= 2**32:
+            raise ValueError
+        self._pack_array_header(n)
+        if self._autoreset:
+            ret = self._buffer.getvalue()
+            self._buffer = StringIO()
+            return ret
+
+    def pack_map_header(self, n):
+        if n >= 2**32:
+            raise ValueError
+        self._pack_map_header(n)
+        if self._autoreset:
+            ret = self._buffer.getvalue()
+            self._buffer = StringIO()
+            return ret
+
+    def pack_ext_type(self, typecode, data):
+        if not isinstance(typecode, int):
+            raise TypeError("typecode must have int type.")
+        if not 0 <= typecode <= 127:
+            raise ValueError("typecode should be 0-127")
+        if not isinstance(data, bytes):
+            raise TypeError("data must have bytes type")
+        L = len(data)
+        if L > 0xffffffff:
+            raise ValueError("Too large data")
+        if L == 1:
+            self._buffer.write(b'\xd4')
+        elif L == 2:
+            self._buffer.write(b'\xd5')
+        elif L == 4:
+            self._buffer.write(b'\xd6')
+        elif L == 8:
+            self._buffer.write(b'\xd7')
+        elif L == 16:
+            self._buffer.write(b'\xd8')
+        elif L <= 0xff:
+            self._buffer.write(b'\xc7' + struct.pack('B', L))
+        elif L <= 0xffff:
+            self._buffer.write(b'\xc8' + struct.pack('>H', L))
+        else:
+            self._buffer.write(b'\xc9' + struct.pack('>I', L))
+        self._buffer.write(struct.pack('B', typecode))
+        self._buffer.write(data)
+
+    def _pack_array_header(self, n):
+        if n <= 0x0f:
+            return self._buffer.write(struct.pack('B', 0x90 + n))
+        if n <= 0xffff:
+            return self._buffer.write(struct.pack(">BH", 0xdc, n))
+        if n <= 0xffffffff:
+            return self._buffer.write(struct.pack(">BI", 0xdd, n))
+        raise ValueError("Array is too large")
+
+    def _pack_map_header(self, n):
+        if n <= 0x0f:
+            return self._buffer.write(struct.pack('B', 0x80 + n))
+        if n <= 0xffff:
+            return self._buffer.write(struct.pack(">BH", 0xde, n))
+        if n <= 0xffffffff:
+            return self._buffer.write(struct.pack(">BI", 0xdf, n))
+        raise ValueError("Dict is too large")
+
+    def _pack_map_pairs(self, n, pairs, nest_limit=DEFAULT_RECURSE_LIMIT):
+        self._pack_map_header(n)
+        for (k, v) in pairs:
+            self._pack(k, nest_limit - 1)
+            self._pack(v, nest_limit - 1)
+
+    def _pack_raw_header(self, n):
+        if n <= 0x1f:
+            self._buffer.write(struct.pack('B', 0xa0 + n))
+        elif self._use_bin_type and n <= 0xff:
+            self._buffer.write(struct.pack('>BB', 0xd9, n))
+        elif n <= 0xffff:
+            self._buffer.write(struct.pack(">BH", 0xda, n))
+        elif n <= 0xffffffff:
+            self._buffer.write(struct.pack(">BI", 0xdb, n))
+        else:
+            raise ValueError('Raw is too large')
+
+    def _pack_bin_header(self, n):
+        if not self._use_bin_type:
+            return self._pack_raw_header(n)
+        elif n <= 0xff:
+            return self._buffer.write(struct.pack('>BB', 0xc4, n))
+        elif n <= 0xffff:
+            return self._buffer.write(struct.pack(">BH", 0xc5, n))
+        elif n <= 0xffffffff:
+            return self._buffer.write(struct.pack(">BI", 0xc6, n))
+        else:
+            raise ValueError('Bin is too large')
+
+    def bytes(self):
+        """Return internal buffer contents as bytes object"""
+        return self._buffer.getvalue()
+
+    def reset(self):
+        """Reset internal buffer.
+
+        This method is usaful only when autoreset=False.
+        """
+        self._buffer = StringIO()
+
+    def getbuffer(self):
+        """Return view of internal buffer."""
+        if USING_STRINGBUILDER or PY2:
+            return memoryview(self.bytes())
+        else:
+            return self._buffer.getbuffer()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..08dc92a6f4c634888bcde2cca215421dd7f72192
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/__init__.py
@@ -0,0 +1,33 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+__all__ = [
+    "__title__", "__summary__", "__uri__", "__version__", "__author__",
+    "__email__", "__license__", "__copyright__",
+]
+
+__title__ = "PyNaCl"
+__summary__ = ("Python binding to the Networking and Cryptography (NaCl) "
+               "library")
+__uri__ = "https://github.com/pyca/pynacl/"
+
+__version__ = "1.4.0"
+
+__author__ = "The PyNaCl developers"
+__email__ = "cryptography-dev@python.org"
+
+__license__ = "Apache License 2.0"
+__copyright__ = "Copyright 2013-2018 {0}".format(__author__)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/_sodium.abi3.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/_sodium.abi3.so
new file mode 100755
index 0000000000000000000000000000000000000000..6648972ed3df09c130e8f506baee739eacd54152
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/_sodium.abi3.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c3590302ee541cf9177fa3c4e1f19c955a7bfeb4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/__init__.py
@@ -0,0 +1,423 @@
+# Copyright 2013-2019 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl.bindings.crypto_aead import (
+    crypto_aead_chacha20poly1305_ABYTES,
+    crypto_aead_chacha20poly1305_KEYBYTES,
+    crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX,
+    crypto_aead_chacha20poly1305_NPUBBYTES,
+    crypto_aead_chacha20poly1305_NSECBYTES,
+    crypto_aead_chacha20poly1305_decrypt,
+    crypto_aead_chacha20poly1305_encrypt,
+    crypto_aead_chacha20poly1305_ietf_ABYTES,
+    crypto_aead_chacha20poly1305_ietf_KEYBYTES,
+    crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX,
+    crypto_aead_chacha20poly1305_ietf_NPUBBYTES,
+    crypto_aead_chacha20poly1305_ietf_NSECBYTES,
+    crypto_aead_chacha20poly1305_ietf_decrypt,
+    crypto_aead_chacha20poly1305_ietf_encrypt,
+    crypto_aead_xchacha20poly1305_ietf_ABYTES,
+    crypto_aead_xchacha20poly1305_ietf_KEYBYTES,
+    crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX,
+    crypto_aead_xchacha20poly1305_ietf_NPUBBYTES,
+    crypto_aead_xchacha20poly1305_ietf_NSECBYTES,
+    crypto_aead_xchacha20poly1305_ietf_decrypt,
+    crypto_aead_xchacha20poly1305_ietf_encrypt,
+)
+from nacl.bindings.crypto_box import (
+    crypto_box, crypto_box_BEFORENMBYTES, crypto_box_BOXZEROBYTES,
+    crypto_box_NONCEBYTES, crypto_box_PUBLICKEYBYTES, crypto_box_SEALBYTES,
+    crypto_box_SECRETKEYBYTES, crypto_box_SEEDBYTES, crypto_box_ZEROBYTES,
+    crypto_box_afternm, crypto_box_beforenm, crypto_box_keypair,
+    crypto_box_open, crypto_box_open_afternm, crypto_box_seal,
+    crypto_box_seal_open, crypto_box_seed_keypair,
+)
+from nacl.bindings.crypto_core import (
+    crypto_core_ed25519_BYTES, crypto_core_ed25519_NONREDUCEDSCALARBYTES,
+    crypto_core_ed25519_SCALARBYTES, crypto_core_ed25519_add,
+    crypto_core_ed25519_is_valid_point, crypto_core_ed25519_scalar_add,
+    crypto_core_ed25519_scalar_complement, crypto_core_ed25519_scalar_invert,
+    crypto_core_ed25519_scalar_mul, crypto_core_ed25519_scalar_negate,
+    crypto_core_ed25519_scalar_reduce, crypto_core_ed25519_scalar_sub,
+    crypto_core_ed25519_sub, has_crypto_core_ed25519
+)
+from nacl.bindings.crypto_generichash import (
+    crypto_generichash_BYTES, crypto_generichash_BYTES_MAX,
+    crypto_generichash_BYTES_MIN, crypto_generichash_KEYBYTES,
+    crypto_generichash_KEYBYTES_MAX, crypto_generichash_KEYBYTES_MIN,
+    crypto_generichash_PERSONALBYTES, crypto_generichash_SALTBYTES,
+    crypto_generichash_STATEBYTES,
+    generichash_blake2b_final as crypto_generichash_blake2b_final,
+    generichash_blake2b_init as crypto_generichash_blake2b_init,
+    generichash_blake2b_salt_personal as
+    crypto_generichash_blake2b_salt_personal,
+    generichash_blake2b_update as crypto_generichash_blake2b_update
+)
+from nacl.bindings.crypto_hash import (
+    crypto_hash, crypto_hash_BYTES, crypto_hash_sha256,
+    crypto_hash_sha256_BYTES, crypto_hash_sha512, crypto_hash_sha512_BYTES,
+)
+from nacl.bindings.crypto_kx import (
+    crypto_kx_PUBLIC_KEY_BYTES,
+    crypto_kx_SECRET_KEY_BYTES,
+    crypto_kx_SEED_BYTES,
+    crypto_kx_SESSION_KEY_BYTES,
+    crypto_kx_client_session_keys,
+    crypto_kx_keypair,
+    crypto_kx_seed_keypair,
+    crypto_kx_server_session_keys,
+)
+from nacl.bindings.crypto_pwhash import (
+    crypto_pwhash_ALG_ARGON2I13,
+    crypto_pwhash_ALG_ARGON2ID13,
+    crypto_pwhash_ALG_DEFAULT,
+    crypto_pwhash_BYTES_MAX,
+    crypto_pwhash_BYTES_MIN,
+    crypto_pwhash_PASSWD_MAX,
+    crypto_pwhash_PASSWD_MIN,
+    crypto_pwhash_SALTBYTES,
+    crypto_pwhash_STRBYTES,
+    crypto_pwhash_alg,
+    crypto_pwhash_argon2i_MEMLIMIT_INTERACTIVE,
+    crypto_pwhash_argon2i_MEMLIMIT_MAX,
+    crypto_pwhash_argon2i_MEMLIMIT_MIN,
+    crypto_pwhash_argon2i_MEMLIMIT_MODERATE,
+    crypto_pwhash_argon2i_MEMLIMIT_SENSITIVE,
+    crypto_pwhash_argon2i_OPSLIMIT_INTERACTIVE,
+    crypto_pwhash_argon2i_OPSLIMIT_MAX,
+    crypto_pwhash_argon2i_OPSLIMIT_MIN,
+    crypto_pwhash_argon2i_OPSLIMIT_MODERATE,
+    crypto_pwhash_argon2i_OPSLIMIT_SENSITIVE,
+    crypto_pwhash_argon2i_STRPREFIX,
+    crypto_pwhash_argon2id_MEMLIMIT_INTERACTIVE,
+    crypto_pwhash_argon2id_MEMLIMIT_MAX,
+    crypto_pwhash_argon2id_MEMLIMIT_MIN,
+    crypto_pwhash_argon2id_MEMLIMIT_MODERATE,
+    crypto_pwhash_argon2id_MEMLIMIT_SENSITIVE,
+    crypto_pwhash_argon2id_OPSLIMIT_INTERACTIVE,
+    crypto_pwhash_argon2id_OPSLIMIT_MAX,
+    crypto_pwhash_argon2id_OPSLIMIT_MIN,
+    crypto_pwhash_argon2id_OPSLIMIT_MODERATE,
+    crypto_pwhash_argon2id_OPSLIMIT_SENSITIVE,
+    crypto_pwhash_argon2id_STRPREFIX,
+    crypto_pwhash_scryptsalsa208sha256_BYTES_MAX,
+    crypto_pwhash_scryptsalsa208sha256_BYTES_MIN,
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE,
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MAX,
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MIN,
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE,
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE,
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MAX,
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MIN,
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE,
+    crypto_pwhash_scryptsalsa208sha256_PASSWD_MAX,
+    crypto_pwhash_scryptsalsa208sha256_PASSWD_MIN,
+    crypto_pwhash_scryptsalsa208sha256_SALTBYTES,
+    crypto_pwhash_scryptsalsa208sha256_STRBYTES,
+    crypto_pwhash_scryptsalsa208sha256_STRPREFIX,
+    crypto_pwhash_scryptsalsa208sha256_ll,
+    crypto_pwhash_scryptsalsa208sha256_str,
+    crypto_pwhash_scryptsalsa208sha256_str_verify,
+    crypto_pwhash_str_alg,
+    crypto_pwhash_str_verify,
+    has_crypto_pwhash_scryptsalsa208sha256,
+    nacl_bindings_pick_scrypt_params,
+)
+from nacl.bindings.crypto_scalarmult import (
+    crypto_scalarmult, crypto_scalarmult_BYTES, crypto_scalarmult_SCALARBYTES,
+    crypto_scalarmult_base, crypto_scalarmult_ed25519,
+    crypto_scalarmult_ed25519_BYTES, crypto_scalarmult_ed25519_SCALARBYTES,
+    crypto_scalarmult_ed25519_base, crypto_scalarmult_ed25519_base_noclamp,
+    crypto_scalarmult_ed25519_noclamp, has_crypto_scalarmult_ed25519
+)
+from nacl.bindings.crypto_secretbox import (
+    crypto_secretbox, crypto_secretbox_BOXZEROBYTES, crypto_secretbox_KEYBYTES,
+    crypto_secretbox_MACBYTES, crypto_secretbox_MESSAGEBYTES_MAX,
+    crypto_secretbox_NONCEBYTES, crypto_secretbox_ZEROBYTES,
+    crypto_secretbox_open
+)
+from nacl.bindings.crypto_secretstream import (
+    crypto_secretstream_xchacha20poly1305_ABYTES,
+    crypto_secretstream_xchacha20poly1305_HEADERBYTES,
+    crypto_secretstream_xchacha20poly1305_KEYBYTES,
+    crypto_secretstream_xchacha20poly1305_STATEBYTES,
+    crypto_secretstream_xchacha20poly1305_TAG_FINAL,
+    crypto_secretstream_xchacha20poly1305_TAG_MESSAGE,
+    crypto_secretstream_xchacha20poly1305_TAG_PUSH,
+    crypto_secretstream_xchacha20poly1305_TAG_REKEY,
+    crypto_secretstream_xchacha20poly1305_init_pull,
+    crypto_secretstream_xchacha20poly1305_init_push,
+    crypto_secretstream_xchacha20poly1305_keygen,
+    crypto_secretstream_xchacha20poly1305_pull,
+    crypto_secretstream_xchacha20poly1305_push,
+    crypto_secretstream_xchacha20poly1305_rekey,
+    crypto_secretstream_xchacha20poly1305_state,
+)
+from nacl.bindings.crypto_shorthash import (
+    BYTES as crypto_shorthash_siphash24_BYTES,
+    KEYBYTES as crypto_shorthash_siphash24_KEYBYTES,
+    XBYTES as crypto_shorthash_siphashx24_BYTES,
+    XKEYBYTES as crypto_shorthash_siphashx24_KEYBYTES,
+    crypto_shorthash_siphash24,
+    crypto_shorthash_siphashx24,
+    has_crypto_shorthash_siphashx24
+)
+from nacl.bindings.crypto_sign import (
+    crypto_sign, crypto_sign_BYTES, crypto_sign_PUBLICKEYBYTES,
+    crypto_sign_SECRETKEYBYTES, crypto_sign_SEEDBYTES,
+    crypto_sign_ed25519_pk_to_curve25519, crypto_sign_ed25519_sk_to_curve25519,
+    crypto_sign_ed25519_sk_to_pk, crypto_sign_ed25519_sk_to_seed,
+    crypto_sign_ed25519ph_STATEBYTES, crypto_sign_ed25519ph_final_create,
+    crypto_sign_ed25519ph_final_verify, crypto_sign_ed25519ph_state,
+    crypto_sign_ed25519ph_update, crypto_sign_keypair, crypto_sign_open,
+    crypto_sign_seed_keypair,
+)
+from nacl.bindings.randombytes import (
+    randombytes,
+    randombytes_buf_deterministic
+)
+from nacl.bindings.sodium_core import sodium_init
+from nacl.bindings.utils import (
+    sodium_add, sodium_increment, sodium_memcmp, sodium_pad, sodium_unpad,
+)
+
+
+__all__ = [
+    "crypto_aead_chacha20poly1305_ABYTES",
+    "crypto_aead_chacha20poly1305_KEYBYTES",
+    "crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX",
+    "crypto_aead_chacha20poly1305_NPUBBYTES",
+    "crypto_aead_chacha20poly1305_NSECBYTES",
+    "crypto_aead_chacha20poly1305_decrypt",
+    "crypto_aead_chacha20poly1305_encrypt",
+    "crypto_aead_chacha20poly1305_ietf_ABYTES",
+    "crypto_aead_chacha20poly1305_ietf_KEYBYTES",
+    "crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX",
+    "crypto_aead_chacha20poly1305_ietf_NPUBBYTES",
+    "crypto_aead_chacha20poly1305_ietf_NSECBYTES",
+    "crypto_aead_chacha20poly1305_ietf_decrypt",
+    "crypto_aead_chacha20poly1305_ietf_encrypt",
+    "crypto_aead_xchacha20poly1305_ietf_ABYTES",
+    "crypto_aead_xchacha20poly1305_ietf_KEYBYTES",
+    "crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX",
+    "crypto_aead_xchacha20poly1305_ietf_NPUBBYTES",
+    "crypto_aead_xchacha20poly1305_ietf_NSECBYTES",
+    "crypto_aead_xchacha20poly1305_ietf_decrypt",
+    "crypto_aead_xchacha20poly1305_ietf_encrypt",
+
+    "crypto_box_SECRETKEYBYTES",
+    "crypto_box_PUBLICKEYBYTES",
+    "crypto_box_SEEDBYTES",
+    "crypto_box_NONCEBYTES",
+    "crypto_box_ZEROBYTES",
+    "crypto_box_BOXZEROBYTES",
+    "crypto_box_BEFORENMBYTES",
+    "crypto_box_SEALBYTES",
+    "crypto_box_keypair",
+    "crypto_box",
+    "crypto_box_open",
+    "crypto_box_beforenm",
+    "crypto_box_afternm",
+    "crypto_box_open_afternm",
+    "crypto_box_seal",
+    "crypto_box_seal_open",
+    "crypto_box_seed_keypair",
+
+    "has_crypto_core_ed25519",
+    "crypto_core_ed25519_BYTES",
+    "crypto_core_ed25519_UNIFORMBYTES",
+    "crypto_core_ed25519_SCALARBYTES",
+    "crypto_core_ed25519_NONREDUCEDSCALARBYTES",
+    "crypto_core_ed25519_add",
+    "crypto_core_ed25519_from_uniform",
+    "crypto_core_ed25519_is_valid_point",
+    "crypto_core_ed25519_sub",
+    "crypto_core_ed25519_scalar_invert",
+    "crypto_core_ed25519_scalar_negate",
+    "crypto_core_ed25519_scalar_complement",
+    "crypto_core_ed25519_scalar_add",
+    "crypto_core_ed25519_scalar_sub",
+    "crypto_core_ed25519_scalar_mul",
+    "crypto_core_ed25519_scalar_reduce",
+
+    "crypto_hash_BYTES",
+    "crypto_hash_sha256_BYTES",
+    "crypto_hash_sha512_BYTES",
+    "crypto_hash",
+    "crypto_hash_sha256",
+    "crypto_hash_sha512",
+
+    "crypto_generichash_BYTES",
+    "crypto_generichash_BYTES_MIN",
+    "crypto_generichash_BYTES_MAX",
+    "crypto_generichash_KEYBYTES",
+    "crypto_generichash_KEYBYTES_MIN",
+    "crypto_generichash_KEYBYTES_MAX",
+    "crypto_generichash_SALTBYTES",
+    "crypto_generichash_PERSONALBYTES",
+    "crypto_generichash_STATEBYTES",
+    "crypto_generichash_blake2b_salt_personal",
+    "crypto_generichash_blake2b_init",
+    "crypto_generichash_blake2b_update",
+    "crypto_generichash_blake2b_final",
+
+    "crypto_kx_keypair",
+    "crypto_kx_seed_keypair",
+    "crypto_kx_client_session_keys",
+    "crypto_kx_server_session_keys",
+    "crypto_kx_PUBLIC_KEY_BYTES",
+    "crypto_kx_SECRET_KEY_BYTES",
+    "crypto_kx_SEED_BYTES",
+    "crypto_kx_SESSION_KEY_BYTES",
+
+    "has_crypto_scalarmult_ed25519",
+    "crypto_scalarmult_BYTES",
+    "crypto_scalarmult_SCALARBYTES",
+    "crypto_scalarmult",
+    "crypto_scalarmult_base",
+    "crypto_scalarmult_ed25519_BYTES",
+    "crypto_scalarmult_ed25519_SCALARBYTES",
+    "crypto_scalarmult_ed25519",
+    "crypto_scalarmult_ed25519_base",
+    "crypto_scalarmult_ed25519_noclamp",
+    "crypto_scalarmult_ed25519_base_noclamp",
+
+    "crypto_secretbox_KEYBYTES",
+    "crypto_secretbox_NONCEBYTES",
+    "crypto_secretbox_ZEROBYTES",
+    "crypto_secretbox_BOXZEROBYTES",
+    "crypto_secretbox_MACBYTES",
+    "crypto_secretbox_MESSAGEBYTES_MAX",
+    "crypto_secretbox",
+    "crypto_secretbox_open",
+
+    "crypto_secretstream_xchacha20poly1305_ABYTES",
+    "crypto_secretstream_xchacha20poly1305_HEADERBYTES",
+    "crypto_secretstream_xchacha20poly1305_KEYBYTES",
+    "crypto_secretstream_xchacha20poly1305_STATEBYTES",
+    "crypto_secretstream_xchacha20poly1305_TAG_FINAL",
+    "crypto_secretstream_xchacha20poly1305_TAG_MESSAGE",
+    "crypto_secretstream_xchacha20poly1305_TAG_PUSH",
+    "crypto_secretstream_xchacha20poly1305_TAG_REKEY",
+    "crypto_secretstream_xchacha20poly1305_init_pull",
+    "crypto_secretstream_xchacha20poly1305_init_push",
+    "crypto_secretstream_xchacha20poly1305_keygen",
+    "crypto_secretstream_xchacha20poly1305_pull",
+    "crypto_secretstream_xchacha20poly1305_push",
+    "crypto_secretstream_xchacha20poly1305_rekey",
+    "crypto_secretstream_xchacha20poly1305_state",
+
+    "has_crypto_shorthash_siphashx24",
+    "crypto_shorthash_siphash24_BYTES",
+    "crypto_shorthash_siphash24_KEYBYTES",
+    "crypto_shorthash_siphash24",
+    "crypto_shorthash_siphashx24_BYTES",
+    "crypto_shorthash_siphashx24_KEYBYTES",
+    "crypto_shorthash_siphashx24",
+
+    "crypto_sign_BYTES",
+    "crypto_sign_SEEDBYTES",
+    "crypto_sign_PUBLICKEYBYTES",
+    "crypto_sign_SECRETKEYBYTES",
+    "crypto_sign_keypair",
+    "crypto_sign_seed_keypair",
+    "crypto_sign",
+    "crypto_sign_open",
+    "crypto_sign_ed25519_pk_to_curve25519",
+    "crypto_sign_ed25519_sk_to_curve25519",
+    "crypto_sign_ed25519_sk_to_pk",
+    "crypto_sign_ed25519_sk_to_seed",
+    "crypto_sign_ed25519ph_STATEBYTES",
+    "crypto_sign_ed25519ph_final_create",
+    "crypto_sign_ed25519ph_final_verify",
+    "crypto_sign_ed25519ph_state",
+    "crypto_sign_ed25519ph_update",
+
+    "crypto_pwhash_ALG_ARGON2I13",
+    "crypto_pwhash_ALG_ARGON2ID13",
+    "crypto_pwhash_ALG_DEFAULT",
+    "crypto_pwhash_BYTES_MAX",
+    "crypto_pwhash_BYTES_MIN",
+    "crypto_pwhash_PASSWD_MAX",
+    "crypto_pwhash_PASSWD_MIN",
+    "crypto_pwhash_SALTBYTES",
+    "crypto_pwhash_STRBYTES",
+
+    "crypto_pwhash_alg",
+    "crypto_pwhash_argon2i_MEMLIMIT_MIN",
+    "crypto_pwhash_argon2i_MEMLIMIT_MAX",
+    "crypto_pwhash_argon2i_MEMLIMIT_INTERACTIVE",
+    "crypto_pwhash_argon2i_MEMLIMIT_MODERATE",
+    "crypto_pwhash_argon2i_MEMLIMIT_SENSITIVE",
+    "crypto_pwhash_argon2i_OPSLIMIT_MIN",
+    "crypto_pwhash_argon2i_OPSLIMIT_MAX",
+    "crypto_pwhash_argon2i_OPSLIMIT_INTERACTIVE",
+    "crypto_pwhash_argon2i_OPSLIMIT_MODERATE",
+    "crypto_pwhash_argon2i_OPSLIMIT_SENSITIVE",
+    "crypto_pwhash_argon2i_STRPREFIX",
+
+    "crypto_pwhash_argon2id_MEMLIMIT_MIN",
+    "crypto_pwhash_argon2id_MEMLIMIT_MAX",
+    "crypto_pwhash_argon2id_MEMLIMIT_INTERACTIVE",
+    "crypto_pwhash_argon2id_MEMLIMIT_MODERATE",
+    "crypto_pwhash_argon2id_OPSLIMIT_MIN",
+    "crypto_pwhash_argon2id_OPSLIMIT_MAX",
+    "crypto_pwhash_argon2id_MEMLIMIT_SENSITIVE",
+    "crypto_pwhash_argon2id_OPSLIMIT_INTERACTIVE",
+    "crypto_pwhash_argon2id_OPSLIMIT_MODERATE",
+    "crypto_pwhash_argon2id_OPSLIMIT_SENSITIVE",
+    "crypto_pwhash_argon2id_STRPREFIX",
+
+    "crypto_pwhash_str_alg",
+    "crypto_pwhash_str_verify",
+
+    "has_crypto_pwhash_scryptsalsa208sha256",
+    "crypto_pwhash_scryptsalsa208sha256_BYTES_MAX",
+    "crypto_pwhash_scryptsalsa208sha256_BYTES_MIN",
+    "crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE",
+    "crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MAX",
+    "crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MIN",
+    "crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE",
+    "crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE",
+    "crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MAX",
+    "crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MIN",
+    "crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE",
+    "crypto_pwhash_scryptsalsa208sha256_PASSWD_MAX",
+    "crypto_pwhash_scryptsalsa208sha256_PASSWD_MIN",
+    "crypto_pwhash_scryptsalsa208sha256_SALTBYTES",
+    "crypto_pwhash_scryptsalsa208sha256_STRBYTES",
+    "crypto_pwhash_scryptsalsa208sha256_STRPREFIX",
+    "crypto_pwhash_scryptsalsa208sha256_ll",
+    "crypto_pwhash_scryptsalsa208sha256_str",
+    "crypto_pwhash_scryptsalsa208sha256_str_verify",
+    "nacl_bindings_pick_scrypt_params",
+
+    "randombytes",
+    "randombytes_buf_deterministic",
+
+    "sodium_init",
+
+    "sodium_add",
+    "sodium_increment",
+
+    "sodium_memcmp",
+    "sodium_pad",
+    "sodium_unpad",
+]
+
+
+# Initialize Sodium
+sodium_init()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_aead.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_aead.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c5d662912f125773c2ee29a5d711c884f07294e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_aead.py
@@ -0,0 +1,485 @@
+# Copyright 2017 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+"""
+Implementations of authenticated encription with associated data (*AEAD*)
+constructions building on the chacha20 stream cipher and the poly1305
+authenticator
+"""
+
+crypto_aead_chacha20poly1305_ietf_KEYBYTES = \
+    lib.crypto_aead_chacha20poly1305_ietf_keybytes()
+crypto_aead_chacha20poly1305_ietf_NSECBYTES = \
+    lib.crypto_aead_chacha20poly1305_ietf_nsecbytes()
+crypto_aead_chacha20poly1305_ietf_NPUBBYTES = \
+    lib.crypto_aead_chacha20poly1305_ietf_npubbytes()
+crypto_aead_chacha20poly1305_ietf_ABYTES = \
+    lib.crypto_aead_chacha20poly1305_ietf_abytes()
+crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX = \
+    lib.crypto_aead_chacha20poly1305_ietf_messagebytes_max()
+_aead_chacha20poly1305_ietf_CRYPTBYTES_MAX = \
+    crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX + \
+    crypto_aead_chacha20poly1305_ietf_ABYTES
+
+crypto_aead_chacha20poly1305_KEYBYTES = \
+    lib.crypto_aead_chacha20poly1305_keybytes()
+crypto_aead_chacha20poly1305_NSECBYTES = \
+    lib.crypto_aead_chacha20poly1305_nsecbytes()
+crypto_aead_chacha20poly1305_NPUBBYTES = \
+    lib.crypto_aead_chacha20poly1305_npubbytes()
+crypto_aead_chacha20poly1305_ABYTES = \
+    lib.crypto_aead_chacha20poly1305_abytes()
+crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX = \
+    lib.crypto_aead_chacha20poly1305_messagebytes_max()
+_aead_chacha20poly1305_CRYPTBYTES_MAX = \
+    crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX + \
+    crypto_aead_chacha20poly1305_ABYTES
+
+crypto_aead_xchacha20poly1305_ietf_KEYBYTES = \
+    lib.crypto_aead_xchacha20poly1305_ietf_keybytes()
+crypto_aead_xchacha20poly1305_ietf_NSECBYTES = \
+    lib.crypto_aead_xchacha20poly1305_ietf_nsecbytes()
+crypto_aead_xchacha20poly1305_ietf_NPUBBYTES = \
+    lib.crypto_aead_xchacha20poly1305_ietf_npubbytes()
+crypto_aead_xchacha20poly1305_ietf_ABYTES = \
+    lib.crypto_aead_xchacha20poly1305_ietf_abytes()
+crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX = \
+    lib.crypto_aead_xchacha20poly1305_ietf_messagebytes_max()
+_aead_xchacha20poly1305_ietf_CRYPTBYTES_MAX = \
+    crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX + \
+    crypto_aead_xchacha20poly1305_ietf_ABYTES
+
+
+def crypto_aead_chacha20poly1305_ietf_encrypt(message, aad, nonce, key):
+    """
+    Encrypt the given ``message`` using the IETF ratified chacha20poly1305
+    construction described in RFC7539.
+
+    :param message:
+    :type message: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: authenticated ciphertext
+    :rtype: bytes
+    """
+    ensure(isinstance(message, bytes), 'Input message type must be bytes',
+           raising=exc.TypeError)
+
+    mlen = len(message)
+
+    ensure(mlen <= crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX,
+           'Message must be at most {0} bytes long'.format(
+               crypto_aead_chacha20poly1305_ietf_MESSAGEBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_chacha20poly1305_ietf_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_ietf_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_chacha20poly1305_ietf_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_ietf_KEYBYTES),
+           raising=exc.TypeError)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    mxout = mlen + crypto_aead_chacha20poly1305_ietf_ABYTES
+
+    clen = ffi.new("unsigned long long *")
+
+    ciphertext = ffi.new("unsigned char[]", mxout)
+
+    res = lib.crypto_aead_chacha20poly1305_ietf_encrypt(ciphertext,
+                                                        clen,
+                                                        message,
+                                                        mlen,
+                                                        _aad,
+                                                        aalen,
+                                                        ffi.NULL,
+                                                        nonce,
+                                                        key)
+
+    ensure(res == 0, "Encryption failed.", raising=exc.CryptoError)
+    return ffi.buffer(ciphertext, clen[0])[:]
+
+
+def crypto_aead_chacha20poly1305_ietf_decrypt(ciphertext, aad, nonce, key):
+    """
+    Decrypt the given ``ciphertext`` using the IETF ratified chacha20poly1305
+    construction described in RFC7539.
+
+    :param ciphertext:
+    :type ciphertext: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: message
+    :rtype: bytes
+    """
+    ensure(isinstance(ciphertext, bytes),
+           'Input ciphertext type must be bytes',
+           raising=exc.TypeError)
+
+    clen = len(ciphertext)
+
+    ensure(clen <= _aead_chacha20poly1305_ietf_CRYPTBYTES_MAX,
+           'Ciphertext must be at most {0} bytes long'.format(
+               _aead_chacha20poly1305_ietf_CRYPTBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_chacha20poly1305_ietf_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_ietf_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_chacha20poly1305_ietf_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_ietf_KEYBYTES),
+           raising=exc.TypeError)
+
+    mxout = clen - crypto_aead_chacha20poly1305_ietf_ABYTES
+
+    mlen = ffi.new("unsigned long long *")
+    message = ffi.new("unsigned char[]", mxout)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    res = lib.crypto_aead_chacha20poly1305_ietf_decrypt(message,
+                                                        mlen,
+                                                        ffi.NULL,
+                                                        ciphertext,
+                                                        clen,
+                                                        _aad,
+                                                        aalen,
+                                                        nonce,
+                                                        key)
+
+    ensure(res == 0, "Decryption failed.", raising=exc.CryptoError)
+
+    return ffi.buffer(message, mlen[0])[:]
+
+
+def crypto_aead_chacha20poly1305_encrypt(message, aad, nonce, key):
+    """
+    Encrypt the given ``message`` using the "legacy" construction
+    described in draft-agl-tls-chacha20poly1305.
+
+    :param message:
+    :type message: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: authenticated ciphertext
+    :rtype: bytes
+    """
+    ensure(isinstance(message, bytes), 'Input message type must be bytes',
+           raising=exc.TypeError)
+
+    mlen = len(message)
+
+    ensure(mlen <= crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX,
+           'Message must be at most {0} bytes long'.format(
+               crypto_aead_chacha20poly1305_MESSAGEBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_chacha20poly1305_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_chacha20poly1305_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_KEYBYTES),
+           raising=exc.TypeError)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    mlen = len(message)
+    mxout = mlen + crypto_aead_chacha20poly1305_ietf_ABYTES
+
+    clen = ffi.new("unsigned long long *")
+
+    ciphertext = ffi.new("unsigned char[]", mxout)
+
+    res = lib.crypto_aead_chacha20poly1305_encrypt(ciphertext,
+                                                   clen,
+                                                   message,
+                                                   mlen,
+                                                   _aad,
+                                                   aalen,
+                                                   ffi.NULL,
+                                                   nonce,
+                                                   key)
+
+    ensure(res == 0, "Encryption failed.", raising=exc.CryptoError)
+    return ffi.buffer(ciphertext, clen[0])[:]
+
+
+def crypto_aead_chacha20poly1305_decrypt(ciphertext, aad, nonce, key):
+    """
+    Decrypt the given ``ciphertext`` using the "legacy" construction
+    described in draft-agl-tls-chacha20poly1305.
+
+    :param ciphertext: authenticated ciphertext
+    :type ciphertext: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: message
+    :rtype: bytes
+    """
+    ensure(isinstance(ciphertext, bytes),
+           'Input ciphertext type must be bytes',
+           raising=exc.TypeError)
+
+    clen = len(ciphertext)
+
+    ensure(clen <= _aead_chacha20poly1305_CRYPTBYTES_MAX,
+           'Ciphertext must be at most {0} bytes long'.format(
+               _aead_chacha20poly1305_CRYPTBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_chacha20poly1305_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_chacha20poly1305_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_chacha20poly1305_KEYBYTES),
+           raising=exc.TypeError)
+
+    mxout = clen - crypto_aead_chacha20poly1305_ABYTES
+
+    mlen = ffi.new("unsigned long long *")
+    message = ffi.new("unsigned char[]", mxout)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    res = lib.crypto_aead_chacha20poly1305_decrypt(message,
+                                                   mlen,
+                                                   ffi.NULL,
+                                                   ciphertext,
+                                                   clen,
+                                                   _aad,
+                                                   aalen,
+                                                   nonce,
+                                                   key)
+
+    ensure(res == 0, "Decryption failed.", raising=exc.CryptoError)
+
+    return ffi.buffer(message, mlen[0])[:]
+
+
+def crypto_aead_xchacha20poly1305_ietf_encrypt(message, aad, nonce, key):
+    """
+    Encrypt the given ``message`` using the long-nonces xchacha20poly1305
+    construction.
+
+    :param message:
+    :type message: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: authenticated ciphertext
+    :rtype: bytes
+    """
+    ensure(isinstance(message, bytes), 'Input message type must be bytes',
+           raising=exc.TypeError)
+
+    mlen = len(message)
+
+    ensure(mlen <= crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX,
+           'Message must be at most {0} bytes long'.format(
+               crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_xchacha20poly1305_ietf_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_xchacha20poly1305_ietf_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_xchacha20poly1305_ietf_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_xchacha20poly1305_ietf_KEYBYTES),
+           raising=exc.TypeError)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    mlen = len(message)
+    mxout = mlen + crypto_aead_xchacha20poly1305_ietf_ABYTES
+
+    clen = ffi.new("unsigned long long *")
+
+    ciphertext = ffi.new("unsigned char[]", mxout)
+
+    res = lib.crypto_aead_xchacha20poly1305_ietf_encrypt(ciphertext,
+                                                         clen,
+                                                         message,
+                                                         mlen,
+                                                         _aad,
+                                                         aalen,
+                                                         ffi.NULL,
+                                                         nonce,
+                                                         key)
+
+    ensure(res == 0, "Encryption failed.", raising=exc.CryptoError)
+    return ffi.buffer(ciphertext, clen[0])[:]
+
+
+def crypto_aead_xchacha20poly1305_ietf_decrypt(ciphertext, aad, nonce, key):
+    """
+    Decrypt the given ``ciphertext`` using the long-nonces xchacha20poly1305
+    construction.
+
+    :param ciphertext: authenticated ciphertext
+    :type ciphertext: bytes
+    :param aad:
+    :type aad: bytes
+    :param nonce:
+    :type nonce: bytes
+    :param key:
+    :type key: bytes
+    :return: message
+    :rtype: bytes
+    """
+    ensure(isinstance(ciphertext, bytes),
+           'Input ciphertext type must be bytes',
+           raising=exc.TypeError)
+
+    clen = len(ciphertext)
+
+    ensure(clen <= _aead_xchacha20poly1305_ietf_CRYPTBYTES_MAX,
+           'Ciphertext must be at most {0} bytes long'.format(
+               _aead_xchacha20poly1305_ietf_CRYPTBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(isinstance(aad, bytes) or (aad is None),
+           'Additional data must be bytes or None',
+           raising=exc.TypeError)
+
+    ensure(isinstance(nonce, bytes) and
+           len(nonce) == crypto_aead_xchacha20poly1305_ietf_NPUBBYTES,
+           'Nonce must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_xchacha20poly1305_ietf_NPUBBYTES),
+           raising=exc.TypeError)
+
+    ensure(isinstance(key, bytes) and
+           len(key) == crypto_aead_xchacha20poly1305_ietf_KEYBYTES,
+           'Key must be a {0} bytes long bytes sequence'.format(
+               crypto_aead_xchacha20poly1305_ietf_KEYBYTES),
+           raising=exc.TypeError)
+
+    mxout = clen - crypto_aead_xchacha20poly1305_ietf_ABYTES
+    mlen = ffi.new("unsigned long long *")
+    message = ffi.new("unsigned char[]", mxout)
+
+    if aad:
+        _aad = aad
+        aalen = len(aad)
+    else:
+        _aad = ffi.NULL
+        aalen = 0
+
+    res = lib.crypto_aead_xchacha20poly1305_ietf_decrypt(message,
+                                                         mlen,
+                                                         ffi.NULL,
+                                                         ciphertext,
+                                                         clen,
+                                                         _aad,
+                                                         aalen,
+                                                         nonce,
+                                                         key)
+
+    ensure(res == 0, "Decryption failed.", raising=exc.CryptoError)
+
+    return ffi.buffer(message, mlen[0])[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_box.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_box.py
new file mode 100644
index 0000000000000000000000000000000000000000..4097c0eaa8f2a59c5cd479696ed473777d2478e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_box.py
@@ -0,0 +1,320 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+__all__ = ["crypto_box_keypair", "crypto_box"]
+
+
+crypto_box_SECRETKEYBYTES = lib.crypto_box_secretkeybytes()
+crypto_box_PUBLICKEYBYTES = lib.crypto_box_publickeybytes()
+crypto_box_SEEDBYTES = lib.crypto_box_seedbytes()
+crypto_box_NONCEBYTES = lib.crypto_box_noncebytes()
+crypto_box_ZEROBYTES = lib.crypto_box_zerobytes()
+crypto_box_BOXZEROBYTES = lib.crypto_box_boxzerobytes()
+crypto_box_BEFORENMBYTES = lib.crypto_box_beforenmbytes()
+crypto_box_SEALBYTES = lib.crypto_box_sealbytes()
+
+
+def crypto_box_keypair():
+    """
+    Returns a randomly generated public and secret key.
+
+    :rtype: (bytes(public_key), bytes(secret_key))
+    """
+    pk = ffi.new("unsigned char[]", crypto_box_PUBLICKEYBYTES)
+    sk = ffi.new("unsigned char[]", crypto_box_SECRETKEYBYTES)
+
+    rc = lib.crypto_box_keypair(pk, sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return (
+        ffi.buffer(pk, crypto_box_PUBLICKEYBYTES)[:],
+        ffi.buffer(sk, crypto_box_SECRETKEYBYTES)[:],
+    )
+
+
+def crypto_box_seed_keypair(seed):
+    """
+    Returns a (public, secret) keypair deterministically generated
+    from an input ``seed``.
+
+    .. warning:: The seed **must** be high-entropy; therefore,
+        its generator **must** be a cryptographic quality
+        random function like, for example, :func:`~nacl.utils.random`.
+
+    .. warning:: The seed **must** be protected and remain secret.
+        Anyone who knows the seed is really in possession of
+        the corresponding PrivateKey.
+
+
+    :param seed: bytes
+    :rtype: (bytes(public_key), bytes(secret_key))
+    """
+    ensure(isinstance(seed, bytes),
+           "seed must be bytes",
+           raising=TypeError)
+
+    if len(seed) != crypto_box_SEEDBYTES:
+        raise exc.ValueError("Invalid seed")
+
+    pk = ffi.new("unsigned char[]", crypto_box_PUBLICKEYBYTES)
+    sk = ffi.new("unsigned char[]", crypto_box_SECRETKEYBYTES)
+
+    rc = lib.crypto_box_seed_keypair(pk, sk, seed)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return (
+        ffi.buffer(pk, crypto_box_PUBLICKEYBYTES)[:],
+        ffi.buffer(sk, crypto_box_SECRETKEYBYTES)[:],
+    )
+
+
+def crypto_box(message, nonce, pk, sk):
+    """
+    Encrypts and returns a message ``message`` using the secret key ``sk``,
+    public key ``pk``, and the nonce ``nonce``.
+
+    :param message: bytes
+    :param nonce: bytes
+    :param pk: bytes
+    :param sk: bytes
+    :rtype: bytes
+    """
+    if len(nonce) != crypto_box_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce size")
+
+    if len(pk) != crypto_box_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid public key")
+
+    if len(sk) != crypto_box_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    padded = (b"\x00" * crypto_box_ZEROBYTES) + message
+    ciphertext = ffi.new("unsigned char[]", len(padded))
+
+    rc = lib.crypto_box(ciphertext, padded, len(padded), nonce, pk, sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(ciphertext, len(padded))[crypto_box_BOXZEROBYTES:]
+
+
+def crypto_box_open(ciphertext, nonce, pk, sk):
+    """
+    Decrypts and returns an encrypted message ``ciphertext``, using the secret
+    key ``sk``, public key ``pk``, and the nonce ``nonce``.
+
+    :param ciphertext: bytes
+    :param nonce: bytes
+    :param pk: bytes
+    :param sk: bytes
+    :rtype: bytes
+    """
+    if len(nonce) != crypto_box_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce size")
+
+    if len(pk) != crypto_box_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid public key")
+
+    if len(sk) != crypto_box_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    padded = (b"\x00" * crypto_box_BOXZEROBYTES) + ciphertext
+    plaintext = ffi.new("unsigned char[]", len(padded))
+
+    res = lib.crypto_box_open(plaintext, padded, len(padded), nonce, pk, sk)
+    ensure(res == 0, "An error occurred trying to decrypt the message",
+           raising=exc.CryptoError)
+
+    return ffi.buffer(plaintext, len(padded))[crypto_box_ZEROBYTES:]
+
+
+def crypto_box_beforenm(pk, sk):
+    """
+    Computes and returns the shared key for the public key ``pk`` and the
+    secret key ``sk``. This can be used to speed up operations where the same
+    set of keys is going to be used multiple times.
+
+    :param pk: bytes
+    :param sk: bytes
+    :rtype: bytes
+    """
+    if len(pk) != crypto_box_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid public key")
+
+    if len(sk) != crypto_box_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    k = ffi.new("unsigned char[]", crypto_box_BEFORENMBYTES)
+
+    rc = lib.crypto_box_beforenm(k, pk, sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(k, crypto_box_BEFORENMBYTES)[:]
+
+
+def crypto_box_afternm(message, nonce, k):
+    """
+    Encrypts and returns the message ``message`` using the shared key ``k`` and
+    the nonce ``nonce``.
+
+    :param message: bytes
+    :param nonce: bytes
+    :param k: bytes
+    :rtype: bytes
+    """
+    if len(nonce) != crypto_box_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce")
+
+    if len(k) != crypto_box_BEFORENMBYTES:
+        raise exc.ValueError("Invalid shared key")
+
+    padded = b"\x00" * crypto_box_ZEROBYTES + message
+    ciphertext = ffi.new("unsigned char[]", len(padded))
+
+    rc = lib.crypto_box_afternm(ciphertext, padded, len(padded), nonce, k)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(ciphertext, len(padded))[crypto_box_BOXZEROBYTES:]
+
+
+def crypto_box_open_afternm(ciphertext, nonce, k):
+    """
+    Decrypts and returns the encrypted message ``ciphertext``, using the shared
+    key ``k`` and the nonce ``nonce``.
+
+    :param ciphertext: bytes
+    :param nonce: bytes
+    :param k: bytes
+    :rtype: bytes
+    """
+    if len(nonce) != crypto_box_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce")
+
+    if len(k) != crypto_box_BEFORENMBYTES:
+        raise exc.ValueError("Invalid shared key")
+
+    padded = (b"\x00" * crypto_box_BOXZEROBYTES) + ciphertext
+    plaintext = ffi.new("unsigned char[]", len(padded))
+
+    res = lib.crypto_box_open_afternm(
+        plaintext, padded, len(padded), nonce, k)
+    ensure(res == 0, "An error occurred trying to decrypt the message",
+           raising=exc.CryptoError)
+
+    return ffi.buffer(plaintext, len(padded))[crypto_box_ZEROBYTES:]
+
+
+def crypto_box_seal(message, pk):
+    """
+    Encrypts and returns a message ``message`` using an ephemeral secret key
+    and the public key ``pk``.
+    The ephemeral public key, which is embedded in the sealed box, is also
+    used, in combination with ``pk``, to derive the nonce needed for the
+    underlying box construct.
+
+    :param message: bytes
+    :param pk: bytes
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+    ensure(isinstance(message, bytes),
+           "input message must be bytes",
+           raising=TypeError)
+
+    ensure(isinstance(pk, bytes),
+           "public key must be bytes",
+           raising=TypeError)
+
+    if len(pk) != crypto_box_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid public key")
+
+    _mlen = len(message)
+    _clen = crypto_box_SEALBYTES + _mlen
+
+    ciphertext = ffi.new("unsigned char[]", _clen)
+
+    rc = lib.crypto_box_seal(ciphertext, message, _mlen, pk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(ciphertext, _clen)[:]
+
+
+def crypto_box_seal_open(ciphertext, pk, sk):
+    """
+    Decrypts and returns an encrypted message ``ciphertext``, using the
+    recipent's secret key ``sk`` and the sender's ephemeral public key
+    embedded in the sealed box. The box contruct nonce is derived from
+    the recipient's public key ``pk`` and the sender's public key.
+
+    :param ciphertext: bytes
+    :param pk: bytes
+    :param sk: bytes
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+    ensure(isinstance(ciphertext, bytes),
+           "input ciphertext must be bytes",
+           raising=TypeError)
+
+    ensure(isinstance(pk, bytes),
+           "public key must be bytes",
+           raising=TypeError)
+
+    ensure(isinstance(sk, bytes),
+           "secret key must be bytes",
+           raising=TypeError)
+
+    if len(pk) != crypto_box_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid public key")
+
+    if len(sk) != crypto_box_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    _clen = len(ciphertext)
+
+    ensure(_clen >= crypto_box_SEALBYTES,
+           ("Input cyphertext must be "
+            "at least {} long").format(crypto_box_SEALBYTES),
+           raising=exc.TypeError)
+
+    _mlen = _clen - crypto_box_SEALBYTES
+
+    # zero-length malloc results are implementation.dependent
+    plaintext = ffi.new("unsigned char[]", max(1, _mlen))
+
+    res = lib.crypto_box_seal_open(plaintext, ciphertext, _clen, pk, sk)
+    ensure(res == 0, "An error occurred trying to decrypt the message",
+           raising=exc.CryptoError)
+
+    return ffi.buffer(plaintext, _mlen)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_core.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_core.py
new file mode 100644
index 0000000000000000000000000000000000000000..63693e6d4498915afcb4bf8cacc60bfddce604ad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_core.py
@@ -0,0 +1,368 @@
+# Copyright 2018 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+has_crypto_core_ed25519 = bool(lib.PYNACL_HAS_CRYPTO_CORE_ED25519)
+
+crypto_core_ed25519_BYTES = 0
+crypto_core_ed25519_SCALARBYTES = 0
+crypto_core_ed25519_NONREDUCEDSCALARBYTES = 0
+
+if has_crypto_core_ed25519:
+    crypto_core_ed25519_BYTES = lib.crypto_core_ed25519_bytes()
+    crypto_core_ed25519_SCALARBYTES = \
+        lib.crypto_core_ed25519_scalarbytes()
+    crypto_core_ed25519_NONREDUCEDSCALARBYTES = \
+        lib.crypto_core_ed25519_nonreducedscalarbytes()
+
+
+def crypto_core_ed25519_is_valid_point(p):
+    """
+    Check if ``p`` represents a point on the edwards25519 curve, in canonical
+    form, on the main subgroup, and that the point doesn't have a small order.
+
+    :param p: a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type p: bytes
+    :return: point validity
+    :rtype: bool
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and len(p) == crypto_core_ed25519_BYTES,
+           'Point must be a crypto_core_ed25519_BYTES long bytes sequence',
+           raising=exc.TypeError)
+
+    rc = lib.crypto_core_ed25519_is_valid_point(p)
+    return rc == 1
+
+
+def crypto_core_ed25519_add(p, q):
+    """
+    Add two points on the edwards25519 curve.
+
+    :param p: a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type p: bytes
+    :param q: a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type q: bytes
+    :return: a point on the edwards25519 curve represented as
+             a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and isinstance(q, bytes) and
+           len(p) == crypto_core_ed25519_BYTES and
+           len(q) == crypto_core_ed25519_BYTES,
+           'Each point must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_BYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_BYTES)
+
+    rc = lib.crypto_core_ed25519_add(r, p, q)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(r, crypto_core_ed25519_BYTES)[:]
+
+
+def crypto_core_ed25519_sub(p, q):
+    """
+    Subtract a point from another on the edwards25519 curve.
+
+    :param p: a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type p: bytes
+    :param q: a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type q: bytes
+    :return: a point on the edwards25519 curve represented as
+             a :py:data:`.crypto_core_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and isinstance(q, bytes) and
+           len(p) == crypto_core_ed25519_BYTES and
+           len(q) == crypto_core_ed25519_BYTES,
+           'Each point must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_BYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_BYTES)
+
+    rc = lib.crypto_core_ed25519_sub(r, p, q)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(r, crypto_core_ed25519_BYTES)[:]
+
+
+def crypto_core_ed25519_scalar_invert(s):
+    """
+    Return the multiplicative inverse of integer ``s`` modulo ``L``,
+    i.e an integer ``i`` such that ``s * i = 1 (mod L)``, where ``L``
+    is the order of the main subgroup.
+
+    Raises a ``exc.RuntimeError`` if ``s`` is the integer zero.
+
+    :param s: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type s: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(s, bytes) and
+           len(s) == crypto_core_ed25519_SCALARBYTES,
+           'Integer s must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    rc = lib.crypto_core_ed25519_scalar_invert(r, s)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_negate(s):
+    """
+    Return the integer ``n`` such that ``s + n = 0 (mod L)``, where ``L``
+    is the order of the main subgroup.
+
+    :param s: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type s: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(s, bytes) and
+           len(s) == crypto_core_ed25519_SCALARBYTES,
+           'Integer s must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_negate(r, s)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_complement(s):
+    """
+    Return the complement of integer ``s`` modulo ``L``, i.e. an integer
+    ``c`` such that ``s + c = 1 (mod L)``, where ``L`` is the order of
+    the main subgroup.
+
+    :param s: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type s: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(s, bytes) and
+           len(s) == crypto_core_ed25519_SCALARBYTES,
+           'Integer s must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_complement(r, s)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_add(p, q):
+    """
+    Add integers ``p`` and ``q`` modulo ``L``, where ``L`` is the order of
+    the main subgroup.
+
+    :param p: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type p: bytes
+    :param q: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type q: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and isinstance(q, bytes) and
+           len(p) == crypto_core_ed25519_SCALARBYTES and
+           len(q) == crypto_core_ed25519_SCALARBYTES,
+           'Each integer must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_add(r, p, q)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_sub(p, q):
+    """
+    Subtract integers ``p`` and ``q`` modulo ``L``, where ``L`` is the
+    order of the main subgroup.
+
+    :param p: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type p: bytes
+    :param q: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type q: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and isinstance(q, bytes) and
+           len(p) == crypto_core_ed25519_SCALARBYTES and
+           len(q) == crypto_core_ed25519_SCALARBYTES,
+           'Each integer must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_sub(r, p, q)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_mul(p, q):
+    """
+    Multiply integers ``p`` and ``q`` modulo ``L``, where ``L`` is the
+    order of the main subgroup.
+
+    :param p: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type p: bytes
+    :param q: a :py:data:`.crypto_core_ed25519_SCALARBYTES`
+              long bytes sequence representing an integer
+    :type q: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(p, bytes) and isinstance(q, bytes) and
+           len(p) == crypto_core_ed25519_SCALARBYTES and
+           len(q) == crypto_core_ed25519_SCALARBYTES,
+           'Each integer must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_mul(r, p, q)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
+
+
+def crypto_core_ed25519_scalar_reduce(s):
+    """
+    Reduce integer ``s`` to ``s`` modulo ``L``, where ``L`` is the order
+    of the main subgroup.
+
+    :param s: a :py:data:`.crypto_core_ed25519_NONREDUCEDSCALARBYTES`
+              long bytes sequence representing an integer
+    :type s: bytes
+    :return: an integer represented as a
+              :py:data:`.crypto_core_ed25519_SCALARBYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_core_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(s, bytes) and
+           len(s) == crypto_core_ed25519_NONREDUCEDSCALARBYTES,
+           'Integer s must be a {} long bytes sequence'.format(
+           'crypto_core_ed25519_NONREDUCEDSCALARBYTES'),
+           raising=exc.TypeError)
+
+    r = ffi.new("unsigned char[]", crypto_core_ed25519_SCALARBYTES)
+
+    lib.crypto_core_ed25519_scalar_reduce(r, s)
+
+    return ffi.buffer(r, crypto_core_ed25519_SCALARBYTES)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_generichash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_generichash.py
new file mode 100644
index 0000000000000000000000000000000000000000..4cc0e5a6d8abc65fc859c0b624d6f4494f1f9745
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_generichash.py
@@ -0,0 +1,242 @@
+# Copyright 2013-2019 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from six import integer_types
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+crypto_generichash_BYTES = lib.crypto_generichash_blake2b_bytes()
+crypto_generichash_BYTES_MIN = lib.crypto_generichash_blake2b_bytes_min()
+crypto_generichash_BYTES_MAX = lib.crypto_generichash_blake2b_bytes_max()
+crypto_generichash_KEYBYTES = lib.crypto_generichash_blake2b_keybytes()
+crypto_generichash_KEYBYTES_MIN = lib.crypto_generichash_blake2b_keybytes_min()
+crypto_generichash_KEYBYTES_MAX = lib.crypto_generichash_blake2b_keybytes_max()
+crypto_generichash_SALTBYTES = lib.crypto_generichash_blake2b_saltbytes()
+crypto_generichash_PERSONALBYTES = \
+    lib.crypto_generichash_blake2b_personalbytes()
+crypto_generichash_STATEBYTES = lib.crypto_generichash_statebytes()
+
+_OVERLONG = '{0} length greater than {1} bytes'
+_TOOBIG = '{0} greater than {1}'
+
+
+def _checkparams(digest_size, key, salt, person):
+    """Check hash paramters"""
+    ensure(isinstance(key, bytes),
+           'Key must be a bytes sequence',
+           raising=exc.TypeError)
+
+    ensure(isinstance(salt, bytes),
+           'Salt must be a bytes sequence',
+           raising=exc.TypeError)
+
+    ensure(isinstance(person, bytes),
+           'Person must be a bytes sequence',
+           raising=exc.TypeError)
+
+    ensure(isinstance(digest_size, integer_types),
+           'Digest size must be an integer number',
+           raising=exc.TypeError)
+
+    ensure(digest_size <= crypto_generichash_BYTES_MAX,
+           _TOOBIG.format("Digest_size", crypto_generichash_BYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(len(key) <= crypto_generichash_KEYBYTES_MAX,
+           _OVERLONG.format("Key", crypto_generichash_KEYBYTES_MAX),
+           raising=exc.ValueError)
+
+    ensure(len(salt) <= crypto_generichash_SALTBYTES,
+           _OVERLONG.format("Salt", crypto_generichash_SALTBYTES),
+           raising=exc.ValueError)
+
+    ensure(len(person) <= crypto_generichash_PERSONALBYTES,
+           _OVERLONG.format("Person", crypto_generichash_PERSONALBYTES),
+           raising=exc.ValueError)
+
+
+def generichash_blake2b_salt_personal(data,
+                                      digest_size=crypto_generichash_BYTES,
+                                      key=b'', salt=b'', person=b''):
+    """One shot hash interface
+
+    :param data: the input data to the hash function
+    :param digest_size: must be at most
+                        :py:data:`.crypto_generichash_BYTES_MAX`;
+                        the default digest size is
+                        :py:data:`.crypto_generichash_BYTES`
+    :type digest_size: int
+    :param key: must be at most
+                :py:data:`.crypto_generichash_KEYBYTES_MAX` long
+    :type key: bytes
+    :param salt: must be at most
+                 :py:data:`.crypto_generichash_SALTBYTES` long;
+                 will be zero-padded if needed
+    :type salt: bytes
+    :param person: must be at most
+                   :py:data:`.crypto_generichash_PERSONALBYTES` long:
+                   will be zero-padded if needed
+    :type person: bytes
+    :return: digest_size long digest
+    :rtype: bytes
+    """
+
+    _checkparams(digest_size, key, salt, person)
+
+    ensure(isinstance(data, bytes),
+           'Input data must be a bytes sequence',
+           raising=exc.TypeError)
+
+    digest = ffi.new("unsigned char[]", digest_size)
+
+    # both _salt and _personal must be zero-padded to the correct length
+    _salt = ffi.new("unsigned char []", crypto_generichash_SALTBYTES)
+    _person = ffi.new("unsigned char []", crypto_generichash_PERSONALBYTES)
+
+    ffi.memmove(_salt, salt, len(salt))
+    ffi.memmove(_person, person, len(person))
+
+    rc = lib.crypto_generichash_blake2b_salt_personal(digest, digest_size,
+                                                      data, len(data),
+                                                      key, len(key),
+                                                      _salt, _person)
+    ensure(rc == 0, 'Unexpected failure',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(digest, digest_size)[:]
+
+
+class Blake2State(object):
+    """
+    Python-level wrapper for the crypto_generichash_blake2b state buffer
+    """
+    __slots__ = ['_statebuf', 'digest_size']
+
+    def __init__(self, digest_size):
+        self._statebuf = ffi.new("unsigned char[]",
+                                 crypto_generichash_STATEBYTES)
+        self.digest_size = digest_size
+
+    def __reduce__(self):
+        """
+        Raise the same exception as hashlib's blake implementation
+        on copy.copy()
+        """
+        raise TypeError("can't pickle {} objects".format(
+            self.__class__.__name__))
+
+    def copy(self):
+        _st = self.__class__(self.digest_size)
+        ffi.memmove(_st._statebuf,
+                    self._statebuf, crypto_generichash_STATEBYTES)
+        return _st
+
+
+def generichash_blake2b_init(key=b'', salt=b'',
+                             person=b'',
+                             digest_size=crypto_generichash_BYTES):
+    """
+    Create a new initialized blake2b hash state
+
+    :param key: must be at most
+                :py:data:`.crypto_generichash_KEYBYTES_MAX` long
+    :type key: bytes
+    :param salt: must be at most
+                 :py:data:`.crypto_generichash_SALTBYTES` long;
+                 will be zero-padded if needed
+    :type salt: bytes
+    :param person: must be at most
+                   :py:data:`.crypto_generichash_PERSONALBYTES` long:
+                   will be zero-padded if needed
+    :type person: bytes
+    :param digest_size: must be at most
+                        :py:data:`.crypto_generichash_BYTES_MAX`;
+                        the default digest size is
+                        :py:data:`.crypto_generichash_BYTES`
+    :type digest_size: int
+    :return: a initialized :py:class:`.Blake2State`
+    :rtype: object
+    """
+
+    _checkparams(digest_size, key, salt, person)
+
+    state = Blake2State(digest_size)
+
+    # both _salt and _personal must be zero-padded to the correct length
+    _salt = ffi.new("unsigned char []", crypto_generichash_SALTBYTES)
+    _person = ffi.new("unsigned char []", crypto_generichash_PERSONALBYTES)
+
+    ffi.memmove(_salt, salt, len(salt))
+    ffi.memmove(_person, person, len(person))
+
+    rc = lib.crypto_generichash_blake2b_init_salt_personal(state._statebuf,
+                                                           key, len(key),
+                                                           digest_size,
+                                                           _salt, _person)
+    ensure(rc == 0, 'Unexpected failure',
+           raising=exc.RuntimeError)
+
+    return state
+
+
+def generichash_blake2b_update(state, data):
+    """Update the blake2b hash state
+
+    :param state: a initialized Blake2bState object as returned from
+                     :py:func:`.crypto_generichash_blake2b_init`
+    :type state: :py:class:`.Blake2State`
+    :param data:
+    :type data: bytes
+    """
+
+    ensure(isinstance(state, Blake2State),
+           'State must be a Blake2State object',
+           raising=exc.TypeError)
+
+    ensure(isinstance(data, bytes),
+           'Input data must be a bytes sequence',
+           raising=exc.TypeError)
+
+    rc = lib.crypto_generichash_blake2b_update(state._statebuf,
+                                               data, len(data))
+    ensure(rc == 0, 'Unexpected failure',
+           raising=exc.RuntimeError)
+
+
+def generichash_blake2b_final(state):
+    """Finalize the blake2b hash state and return the digest.
+
+    :param state: a initialized Blake2bState object as returned from
+                     :py:func:`.crypto_generichash_blake2b_init`
+    :type state: :py:class:`.Blake2State`
+    :return: the blake2 digest of the passed-in data stream
+    :rtype: bytes
+    """
+
+    ensure(isinstance(state, Blake2State),
+           'State must be a Blake2State object',
+           raising=exc.TypeError)
+
+    _digest = ffi.new("unsigned char[]", crypto_generichash_BYTES_MAX)
+    rc = lib.crypto_generichash_blake2b_final(state._statebuf,
+                                              _digest, state.digest_size)
+
+    ensure(rc == 0, 'Unexpected failure',
+           raising=exc.RuntimeError)
+    return ffi.buffer(_digest, state.digest_size)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_hash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_hash.py
new file mode 100644
index 0000000000000000000000000000000000000000..10add229de8596f2366bdf7f914db7184b212e60
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_hash.py
@@ -0,0 +1,70 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+# crypto_hash_BYTES = lib.crypto_hash_bytes()
+crypto_hash_BYTES = lib.crypto_hash_sha512_bytes()
+crypto_hash_sha256_BYTES = lib.crypto_hash_sha256_bytes()
+crypto_hash_sha512_BYTES = lib.crypto_hash_sha512_bytes()
+
+
+def crypto_hash(message):
+    """
+    Hashes and returns the message ``message``.
+
+    :param message: bytes
+    :rtype: bytes
+    """
+    digest = ffi.new("unsigned char[]", crypto_hash_BYTES)
+    rc = lib.crypto_hash(digest, message, len(message))
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+    return ffi.buffer(digest, crypto_hash_BYTES)[:]
+
+
+def crypto_hash_sha256(message):
+    """
+    Hashes and returns the message ``message``.
+
+    :param message: bytes
+    :rtype: bytes
+    """
+    digest = ffi.new("unsigned char[]", crypto_hash_sha256_BYTES)
+    rc = lib.crypto_hash_sha256(digest, message, len(message))
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+    return ffi.buffer(digest, crypto_hash_sha256_BYTES)[:]
+
+
+def crypto_hash_sha512(message):
+    """
+    Hashes and returns the message ``message``.
+
+    :param message: bytes
+    :rtype: bytes
+    """
+    digest = ffi.new("unsigned char[]", crypto_hash_sha512_BYTES)
+    rc = lib.crypto_hash_sha512(digest, message, len(message))
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+    return ffi.buffer(digest, crypto_hash_sha512_BYTES)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_kx.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_kx.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fadb6a2fa6bd9e70a0bac02ac66ba449518f262
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_kx.py
@@ -0,0 +1,167 @@
+# Copyright 2018 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+__all__ = ["crypto_kx_keypair",
+           "crypto_kx_client_session_keys",
+           "crypto_kx_server_session_keys",
+           "crypto_kx_PUBLIC_KEY_BYTES",
+           "crypto_kx_SECRET_KEY_BYTES",
+           "crypto_kx_SEED_BYTES",
+           "crypto_kx_SESSION_KEY_BYTES"]
+
+"""
+Implementations of client, server key exchange
+"""
+crypto_kx_PUBLIC_KEY_BYTES = lib.crypto_kx_publickeybytes()
+crypto_kx_SECRET_KEY_BYTES = lib.crypto_kx_secretkeybytes()
+crypto_kx_SEED_BYTES = lib.crypto_kx_seedbytes()
+crypto_kx_SESSION_KEY_BYTES = lib.crypto_kx_sessionkeybytes()
+
+
+def crypto_kx_keypair():
+    """
+    Generate a keypair.
+    This is a duplicate crypto_box_keypair, but
+    is included for api consistency.
+    :return: (public_key, secret_key)
+    :rtype: (bytes, bytes)
+    """
+    public_key = ffi.new("unsigned char[]", crypto_kx_PUBLIC_KEY_BYTES)
+    secret_key = ffi.new("unsigned char[]", crypto_kx_SECRET_KEY_BYTES)
+    res = lib.crypto_kx_keypair(public_key, secret_key)
+    ensure(res == 0, "Key generation failed.", raising=exc.CryptoError)
+
+    return (ffi.buffer(public_key, crypto_kx_PUBLIC_KEY_BYTES)[:],
+            ffi.buffer(secret_key, crypto_kx_SECRET_KEY_BYTES)[:])
+
+
+def crypto_kx_seed_keypair(seed):
+    """
+    Generate a keypair with a given seed.
+    This is functionally the same as crypto_box_seed_keypair, however
+    it uses the blake2b hash primitive instead of sha512.
+    It is included mainly for api consistency when using crypto_kx.
+    :param seed: random seed
+    :type seed: bytes
+    :return: (public_key, secret_key)
+    :rtype: (bytes, bytes)
+    """
+    public_key = ffi.new("unsigned char[]", crypto_kx_PUBLIC_KEY_BYTES)
+    secret_key = ffi.new("unsigned char[]", crypto_kx_SECRET_KEY_BYTES)
+    ensure(isinstance(seed, bytes) and
+           len(seed) == crypto_kx_SEED_BYTES,
+           'Seed must be a {0} byte long bytes sequence'.format(
+               crypto_kx_SEED_BYTES),
+           raising=exc.TypeError)
+    res = lib.crypto_kx_seed_keypair(public_key, secret_key, seed)
+    ensure(res == 0, "Key generation failed.", raising=exc.CryptoError)
+
+    return (ffi.buffer(public_key, crypto_kx_PUBLIC_KEY_BYTES)[:],
+            ffi.buffer(secret_key, crypto_kx_SECRET_KEY_BYTES)[:])
+
+
+def crypto_kx_client_session_keys(client_public_key,
+                                  client_secret_key,
+                                  server_public_key):
+    """
+    Generate session keys for the client.
+    :param client_public_key:
+    :type client_public_key: bytes
+    :param client_secret_key:
+    :type client_secret_key: bytes
+    :param server_public_key:
+    :type server_public_key: bytes
+    :return: (rx_key, tx_key)
+    :rtype: (bytes, bytes)
+    """
+    ensure(isinstance(client_public_key, bytes) and
+           len(client_public_key) == crypto_kx_PUBLIC_KEY_BYTES,
+           'Client public key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+    ensure(isinstance(client_secret_key, bytes) and
+           len(client_secret_key) == crypto_kx_SECRET_KEY_BYTES,
+           'Client secret key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+    ensure(isinstance(server_public_key, bytes) and
+           len(server_public_key) == crypto_kx_PUBLIC_KEY_BYTES,
+           'Server public key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+
+    rx_key = ffi.new("unsigned char[]", crypto_kx_SESSION_KEY_BYTES)
+    tx_key = ffi.new("unsigned char[]", crypto_kx_SESSION_KEY_BYTES)
+    res = lib.crypto_kx_client_session_keys(rx_key,
+                                            tx_key,
+                                            client_public_key,
+                                            client_secret_key,
+                                            server_public_key)
+    ensure(res == 0,
+           "Client session key generation failed.",
+           raising=exc.CryptoError)
+
+    return (ffi.buffer(rx_key, crypto_kx_SESSION_KEY_BYTES)[:],
+            ffi.buffer(tx_key, crypto_kx_SESSION_KEY_BYTES)[:])
+
+
+def crypto_kx_server_session_keys(server_public_key,
+                                  server_secret_key,
+                                  client_public_key):
+    """
+    Generate session keys for the server.
+    :param server_public_key:
+    :type server_public_key: bytes
+    :param server_secret_key:
+    :type server_secret_key: bytes
+    :param client_public_key:
+    :type client_public_key: bytes
+    :return: (rx_key, tx_key)
+    :rtype: (bytes, bytes)
+    """
+    ensure(isinstance(server_public_key, bytes) and
+           len(server_public_key) == crypto_kx_PUBLIC_KEY_BYTES,
+           'Server public key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+    ensure(isinstance(server_secret_key, bytes) and
+           len(server_secret_key) == crypto_kx_SECRET_KEY_BYTES,
+           'Server secret key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+    ensure(isinstance(client_public_key, bytes) and
+           len(client_public_key) == crypto_kx_PUBLIC_KEY_BYTES,
+           'Client public key must be a {0} bytes long bytes sequence'.format(
+               crypto_kx_PUBLIC_KEY_BYTES),
+           raising=exc.TypeError)
+
+    rx_key = ffi.new("unsigned char[]", crypto_kx_SESSION_KEY_BYTES)
+    tx_key = ffi.new("unsigned char[]", crypto_kx_SESSION_KEY_BYTES)
+    res = lib.crypto_kx_server_session_keys(rx_key,
+                                            tx_key,
+                                            server_public_key,
+                                            server_secret_key,
+                                            client_public_key)
+    ensure(res == 0,
+           "Server session key generation failed.",
+           raising=exc.CryptoError)
+
+    return (ffi.buffer(rx_key, crypto_kx_SESSION_KEY_BYTES)[:],
+            ffi.buffer(tx_key, crypto_kx_SESSION_KEY_BYTES)[:])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_pwhash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_pwhash.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a8ad47d21a3e651800f768e3d99bdb222d755dd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_pwhash.py
@@ -0,0 +1,507 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+from six import integer_types
+
+import nacl.exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+has_crypto_pwhash_scryptsalsa208sha256 = \
+    bool(lib.PYNACL_HAS_CRYPTO_PWHASH_SCRYPTSALSA208SHA256)
+
+crypto_pwhash_scryptsalsa208sha256_STRPREFIX = b''
+crypto_pwhash_scryptsalsa208sha256_SALTBYTES = 0
+crypto_pwhash_scryptsalsa208sha256_STRBYTES = 0
+crypto_pwhash_scryptsalsa208sha256_PASSWD_MIN = 0
+crypto_pwhash_scryptsalsa208sha256_PASSWD_MAX = 0
+crypto_pwhash_scryptsalsa208sha256_BYTES_MIN = 0
+crypto_pwhash_scryptsalsa208sha256_BYTES_MAX = 0
+crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MIN = 0
+crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MAX = 0
+crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MIN = 0
+crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MAX = 0
+crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE = 0
+crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE = 0
+crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE = 0
+crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE = 0
+
+if has_crypto_pwhash_scryptsalsa208sha256:
+    crypto_pwhash_scryptsalsa208sha256_STRPREFIX = \
+        ffi.string(ffi.cast("char *",
+                            lib.crypto_pwhash_scryptsalsa208sha256_strprefix()
+                            )
+                   )[:]
+    crypto_pwhash_scryptsalsa208sha256_SALTBYTES = \
+        lib.crypto_pwhash_scryptsalsa208sha256_saltbytes()
+    crypto_pwhash_scryptsalsa208sha256_STRBYTES = \
+        lib.crypto_pwhash_scryptsalsa208sha256_strbytes()
+    crypto_pwhash_scryptsalsa208sha256_PASSWD_MIN = \
+        lib.crypto_pwhash_scryptsalsa208sha256_passwd_min()
+    crypto_pwhash_scryptsalsa208sha256_PASSWD_MAX = \
+        lib.crypto_pwhash_scryptsalsa208sha256_passwd_max()
+    crypto_pwhash_scryptsalsa208sha256_BYTES_MIN = \
+        lib.crypto_pwhash_scryptsalsa208sha256_bytes_min()
+    crypto_pwhash_scryptsalsa208sha256_BYTES_MAX = \
+        lib.crypto_pwhash_scryptsalsa208sha256_bytes_max()
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MIN = \
+        lib.crypto_pwhash_scryptsalsa208sha256_memlimit_min()
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MAX = \
+        lib.crypto_pwhash_scryptsalsa208sha256_memlimit_max()
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MIN = \
+        lib.crypto_pwhash_scryptsalsa208sha256_opslimit_min()
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MAX = \
+        lib.crypto_pwhash_scryptsalsa208sha256_opslimit_max()
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE = \
+        lib.crypto_pwhash_scryptsalsa208sha256_opslimit_interactive()
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE = \
+        lib.crypto_pwhash_scryptsalsa208sha256_memlimit_interactive()
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE = \
+        lib.crypto_pwhash_scryptsalsa208sha256_opslimit_sensitive()
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE = \
+        lib.crypto_pwhash_scryptsalsa208sha256_memlimit_sensitive()
+
+crypto_pwhash_ALG_ARGON2I13 = lib.crypto_pwhash_alg_argon2i13()
+crypto_pwhash_ALG_ARGON2ID13 = lib.crypto_pwhash_alg_argon2id13()
+crypto_pwhash_ALG_DEFAULT = lib.crypto_pwhash_alg_default()
+
+crypto_pwhash_SALTBYTES = lib.crypto_pwhash_saltbytes()
+crypto_pwhash_STRBYTES = lib.crypto_pwhash_strbytes()
+
+crypto_pwhash_PASSWD_MIN = lib.crypto_pwhash_passwd_min()
+crypto_pwhash_PASSWD_MAX = lib.crypto_pwhash_passwd_max()
+crypto_pwhash_BYTES_MIN = lib.crypto_pwhash_bytes_min()
+crypto_pwhash_BYTES_MAX = lib.crypto_pwhash_bytes_max()
+
+crypto_pwhash_argon2i_STRPREFIX = \
+    ffi.string(ffi.cast("char *",
+                        lib.crypto_pwhash_argon2i_strprefix()
+                        )
+               )[:]
+crypto_pwhash_argon2i_MEMLIMIT_MIN = \
+    lib.crypto_pwhash_argon2i_memlimit_min()
+crypto_pwhash_argon2i_MEMLIMIT_MAX = \
+    lib.crypto_pwhash_argon2i_memlimit_max()
+crypto_pwhash_argon2i_OPSLIMIT_MIN = \
+    lib.crypto_pwhash_argon2i_opslimit_min()
+crypto_pwhash_argon2i_OPSLIMIT_MAX = \
+    lib.crypto_pwhash_argon2i_opslimit_max()
+crypto_pwhash_argon2i_OPSLIMIT_INTERACTIVE = \
+    lib.crypto_pwhash_argon2i_opslimit_interactive()
+crypto_pwhash_argon2i_MEMLIMIT_INTERACTIVE = \
+    lib.crypto_pwhash_argon2i_memlimit_interactive()
+crypto_pwhash_argon2i_OPSLIMIT_MODERATE = \
+    lib.crypto_pwhash_argon2i_opslimit_moderate()
+crypto_pwhash_argon2i_MEMLIMIT_MODERATE = \
+    lib.crypto_pwhash_argon2i_memlimit_moderate()
+crypto_pwhash_argon2i_OPSLIMIT_SENSITIVE = \
+    lib.crypto_pwhash_argon2i_opslimit_sensitive()
+crypto_pwhash_argon2i_MEMLIMIT_SENSITIVE = \
+    lib.crypto_pwhash_argon2i_memlimit_sensitive()
+
+crypto_pwhash_argon2id_STRPREFIX = \
+    ffi.string(ffi.cast("char *",
+                        lib.crypto_pwhash_argon2id_strprefix()
+                        )
+               )[:]
+crypto_pwhash_argon2id_MEMLIMIT_MIN = \
+    lib.crypto_pwhash_argon2id_memlimit_min()
+crypto_pwhash_argon2id_MEMLIMIT_MAX = \
+    lib.crypto_pwhash_argon2id_memlimit_max()
+crypto_pwhash_argon2id_OPSLIMIT_MIN = \
+    lib.crypto_pwhash_argon2id_opslimit_min()
+crypto_pwhash_argon2id_OPSLIMIT_MAX = \
+    lib.crypto_pwhash_argon2id_opslimit_max()
+crypto_pwhash_argon2id_OPSLIMIT_INTERACTIVE = \
+    lib.crypto_pwhash_argon2id_opslimit_interactive()
+crypto_pwhash_argon2id_MEMLIMIT_INTERACTIVE = \
+    lib.crypto_pwhash_argon2id_memlimit_interactive()
+crypto_pwhash_argon2id_OPSLIMIT_MODERATE = \
+    lib.crypto_pwhash_argon2id_opslimit_moderate()
+crypto_pwhash_argon2id_MEMLIMIT_MODERATE = \
+    lib.crypto_pwhash_argon2id_memlimit_moderate()
+crypto_pwhash_argon2id_OPSLIMIT_SENSITIVE = \
+    lib.crypto_pwhash_argon2id_opslimit_sensitive()
+crypto_pwhash_argon2id_MEMLIMIT_SENSITIVE = \
+    lib.crypto_pwhash_argon2id_memlimit_sensitive()
+
+SCRYPT_OPSLIMIT_INTERACTIVE = \
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE
+SCRYPT_MEMLIMIT_INTERACTIVE = \
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE
+SCRYPT_OPSLIMIT_SENSITIVE = \
+    crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE
+SCRYPT_MEMLIMIT_SENSITIVE = \
+    crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE
+SCRYPT_SALTBYTES = \
+    crypto_pwhash_scryptsalsa208sha256_SALTBYTES
+SCRYPT_STRBYTES = \
+    crypto_pwhash_scryptsalsa208sha256_STRBYTES
+
+SCRYPT_PR_MAX = ((1 << 30) - 1)
+LOG2_UINT64_MAX = 63
+UINT64_MAX = (1 << 64) - 1
+SCRYPT_MAX_MEM = 32 * (1024 * 1024)
+
+
+def _check_memory_occupation(n, r, p, maxmem=SCRYPT_MAX_MEM):
+    ensure(r != 0, 'Invalid block size',
+           raising=exc.ValueError)
+
+    ensure(p != 0, 'Invalid parallelization factor',
+           raising=exc.ValueError)
+
+    ensure((n & (n - 1)) == 0, 'Cost factor must be a power of 2',
+           raising=exc.ValueError)
+
+    ensure(n > 1, 'Cost factor must be at least 2',
+           raising=exc.ValueError)
+
+    ensure(p <= SCRYPT_PR_MAX / r,
+           'p*r is greater than {0}'.format(SCRYPT_PR_MAX),
+           raising=exc.ValueError)
+
+    ensure(n < (1 << (16 * r)),
+           raising=exc.ValueError)
+
+    Blen = p * 128 * r
+
+    i = UINT64_MAX / 128
+
+    ensure(n + 2 <= i / r,
+           raising=exc.ValueError)
+
+    Vlen = 32 * r * (n + 2) * 4
+
+    ensure(Blen <= UINT64_MAX - Vlen,
+           raising=exc.ValueError)
+
+    ensure(Blen <= sys.maxsize - Vlen,
+           raising=exc.ValueError)
+
+    ensure(Blen + Vlen <= maxmem,
+           'Memory limit would be exceeded with the choosen n, r, p',
+           raising=exc.ValueError)
+
+
+def nacl_bindings_pick_scrypt_params(opslimit, memlimit):
+    """Python implementation of libsodium's pickparams"""
+
+    if opslimit < 32768:
+        opslimit = 32768
+
+    r = 8
+
+    if opslimit < (memlimit // 32):
+        p = 1
+        maxn = opslimit // (4 * r)
+        for n_log2 in range(1, 63):  # pragma: no branch
+            if (2 ** n_log2) > (maxn // 2):
+                break
+    else:
+        maxn = memlimit // (r * 128)
+        for n_log2 in range(1, 63):  # pragma: no branch
+            if (2 ** n_log2) > maxn // 2:
+                break
+
+        maxrp = (opslimit // 4) // (2 ** n_log2)
+
+        if maxrp > 0x3fffffff:  # pragma: no cover
+            maxrp = 0x3fffffff
+
+        p = maxrp // r
+
+    return n_log2, r, p
+
+
+def crypto_pwhash_scryptsalsa208sha256_ll(passwd, salt, n, r, p, dklen=64,
+                                          maxmem=SCRYPT_MAX_MEM):
+    """
+    Derive a cryptographic key using the ``passwd`` and ``salt``
+    given as input.
+
+    The work factor can be tuned by by picking different
+    values for the parameters
+
+    :param bytes passwd:
+    :param bytes salt:
+    :param bytes salt: *must* be *exactly* :py:const:`.SALTBYTES` long
+    :param int dklen:
+    :param int opslimit:
+    :param int n:
+    :param int r: block size,
+    :param int p: the parallelism factor
+    :param int maxmem: the maximum available memory available for scrypt's
+                       operations
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_pwhash_scryptsalsa208sha256,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(n, integer_types),
+           raising=TypeError)
+    ensure(isinstance(r, integer_types),
+           raising=TypeError)
+    ensure(isinstance(p, integer_types),
+           raising=TypeError)
+
+    ensure(isinstance(passwd, bytes),
+           raising=TypeError)
+    ensure(isinstance(salt, bytes),
+           raising=TypeError)
+
+    _check_memory_occupation(n, r, p, maxmem)
+
+    buf = ffi.new("uint8_t[]", dklen)
+
+    ret = lib.crypto_pwhash_scryptsalsa208sha256_ll(passwd, len(passwd),
+                                                    salt, len(salt),
+                                                    n, r, p,
+                                                    buf, dklen)
+
+    ensure(ret == 0, 'Unexpected failure in key derivation',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(ffi.cast("char *", buf), dklen)[:]
+
+
+def crypto_pwhash_scryptsalsa208sha256_str(
+        passwd, opslimit=SCRYPT_OPSLIMIT_INTERACTIVE,
+        memlimit=SCRYPT_MEMLIMIT_INTERACTIVE):
+    """
+    Derive a cryptographic key using the ``passwd`` and ``salt``
+    given as input, returning a string representation which includes
+    the salt and the tuning parameters.
+
+    The returned string can be directly stored as a password hash.
+
+    See :py:func:`.crypto_pwhash_scryptsalsa208sha256` for a short
+    discussion about ``opslimit`` and ``memlimit`` values.
+
+    :param bytes passwd:
+    :param int opslimit:
+    :param int memlimit:
+    :return: serialized key hash, including salt and tuning parameters
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_pwhash_scryptsalsa208sha256,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    buf = ffi.new("char[]", SCRYPT_STRBYTES)
+
+    ret = lib.crypto_pwhash_scryptsalsa208sha256_str(buf, passwd,
+                                                     len(passwd),
+                                                     opslimit,
+                                                     memlimit)
+
+    ensure(ret == 0, 'Unexpected failure in password hashing',
+           raising=exc.RuntimeError)
+
+    return ffi.string(buf)
+
+
+def crypto_pwhash_scryptsalsa208sha256_str_verify(passwd_hash, passwd):
+    """
+    Verifies the ``passwd`` against the ``passwd_hash`` that was generated.
+    Returns True or False depending on the success
+
+    :param passwd_hash: bytes
+    :param passwd: bytes
+    :rtype: boolean
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_pwhash_scryptsalsa208sha256,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(len(passwd_hash) == SCRYPT_STRBYTES - 1, 'Invalid password hash',
+           raising=exc.ValueError)
+
+    ret = lib.crypto_pwhash_scryptsalsa208sha256_str_verify(passwd_hash,
+                                                            passwd,
+                                                            len(passwd))
+    ensure(ret == 0,
+           "Wrong password",
+           raising=exc.InvalidkeyError)
+    # all went well, therefore:
+    return True
+
+
+def _check_argon2_limits_alg(opslimit, memlimit, alg):
+
+    if (alg == crypto_pwhash_ALG_ARGON2I13):
+        if memlimit < crypto_pwhash_argon2i_MEMLIMIT_MIN:
+            raise exc.ValueError('memlimit must be at least {0} bytes'.format(
+                                 crypto_pwhash_argon2i_MEMLIMIT_MIN))
+        elif memlimit > crypto_pwhash_argon2i_MEMLIMIT_MAX:
+            raise exc.ValueError('memlimit must be at most {0} bytes'.format(
+                                 crypto_pwhash_argon2i_MEMLIMIT_MAX))
+        if opslimit < crypto_pwhash_argon2i_OPSLIMIT_MIN:
+            raise exc.ValueError('opslimit must be at least {0}'.format(
+                crypto_pwhash_argon2i_OPSLIMIT_MIN))
+        elif opslimit > crypto_pwhash_argon2i_OPSLIMIT_MAX:
+            raise exc.ValueError('opslimit must be at most {0}'.format(
+                crypto_pwhash_argon2i_OPSLIMIT_MAX))
+
+    elif (alg == crypto_pwhash_ALG_ARGON2ID13):
+        if memlimit < crypto_pwhash_argon2id_MEMLIMIT_MIN:
+            raise exc.ValueError('memlimit must be at least {0} bytes'.format(
+                                 crypto_pwhash_argon2id_MEMLIMIT_MIN))
+        elif memlimit > crypto_pwhash_argon2id_MEMLIMIT_MAX:
+            raise exc.ValueError('memlimit must be at most {0} bytes'.format(
+                                 crypto_pwhash_argon2id_MEMLIMIT_MAX))
+        if opslimit < crypto_pwhash_argon2id_OPSLIMIT_MIN:
+            raise exc.ValueError('opslimit must be at least {0}'.format(
+                crypto_pwhash_argon2id_OPSLIMIT_MIN))
+        elif opslimit > crypto_pwhash_argon2id_OPSLIMIT_MAX:
+            raise exc.ValueError('opslimit must be at most {0}'.format(
+                crypto_pwhash_argon2id_OPSLIMIT_MAX))
+    else:
+        raise exc.TypeError('Unsupported algorithm')
+
+
+def crypto_pwhash_alg(outlen, passwd, salt, opslimit, memlimit, alg):
+    """
+    Derive a raw cryptographic key using the ``passwd`` and the ``salt``
+    given as input to the ``alg`` algorithm.
+
+    :param outlen: the length of the derived key
+    :type outlen: int
+    :param passwd: The input password
+    :type passwd: bytes
+    :param opslimit: computational cost
+    :type opslimit: int
+    :param memlimit: memory cost
+    :type memlimit: int
+    :param alg: algorithm identifier
+    :type alg: int
+    :return: derived key
+    :rtype: bytes
+    """
+    ensure(isinstance(outlen, integer_types),
+           raising=exc.TypeError)
+    ensure(isinstance(opslimit, integer_types),
+           raising=exc.TypeError)
+    ensure(isinstance(memlimit, integer_types),
+           raising=exc.TypeError)
+    ensure(isinstance(alg, integer_types),
+           raising=exc.TypeError)
+    ensure(isinstance(passwd, bytes),
+           raising=exc.TypeError)
+
+    if len(salt) != crypto_pwhash_SALTBYTES:
+        raise exc.ValueError("salt must be exactly {0} bytes long".format(
+            crypto_pwhash_SALTBYTES))
+
+    if outlen < crypto_pwhash_BYTES_MIN:
+        raise exc.ValueError(
+            'derived key must be at least {0} bytes long'.format(
+                crypto_pwhash_BYTES_MIN))
+
+    elif outlen > crypto_pwhash_BYTES_MAX:
+        raise exc.ValueError(
+            'derived key must be at most {0} bytes long'.format(
+                crypto_pwhash_BYTES_MAX))
+
+    _check_argon2_limits_alg(opslimit, memlimit, alg)
+
+    outbuf = ffi.new("unsigned char[]", outlen)
+
+    ret = lib.crypto_pwhash(outbuf, outlen, passwd, len(passwd),
+                            salt, opslimit, memlimit, alg)
+
+    ensure(ret == 0, 'Unexpected failure in key derivation',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(outbuf, outlen)[:]
+
+
+def crypto_pwhash_str_alg(passwd, opslimit, memlimit, alg):
+    """
+    Derive a cryptographic key using the ``passwd`` given as input
+    and a random ``salt``, returning a string representation which
+    includes the salt, the tuning parameters and the used algorithm.
+
+    :param passwd: The input password
+    :type passwd: bytes
+    :param opslimit: computational cost
+    :type opslimit: int
+    :param memlimit: memory cost
+    :type memlimit: int
+    :param alg: The algorithm to use
+    :type alg: int
+    :return: serialized derived key and parameters
+    :rtype: bytes
+    """
+    ensure(isinstance(opslimit, integer_types),
+           raising=TypeError)
+    ensure(isinstance(memlimit, integer_types),
+           raising=TypeError)
+    ensure(isinstance(passwd, bytes),
+           raising=TypeError)
+
+    _check_argon2_limits_alg(opslimit, memlimit, alg)
+
+    outbuf = ffi.new("char[]", 128)
+
+    ret = lib.crypto_pwhash_str_alg(outbuf, passwd, len(passwd),
+                                    opslimit, memlimit, alg)
+
+    ensure(ret == 0, 'Unexpected failure in key derivation',
+           raising=exc.RuntimeError)
+
+    return ffi.string(outbuf)
+
+
+def crypto_pwhash_str_verify(passwd_hash, passwd):
+    """
+    Verifies the ``passwd`` against a given password hash.
+
+    Returns True on success, raises InvalidkeyError on failure
+    :param passwd_hash: saved password hash
+    :type passwd_hash: bytes
+    :param passwd: password to be checked
+    :type passwd: bytes
+    :return: success
+    :rtype: boolean
+    """
+    ensure(isinstance(passwd_hash, bytes),
+           raising=TypeError)
+    ensure(isinstance(passwd, bytes),
+           raising=TypeError)
+    ensure(len(passwd_hash) <= 127,
+           "Hash must be at most 127 bytes long",
+           raising=exc.ValueError)
+
+    ret = lib.crypto_pwhash_str_verify(passwd_hash, passwd, len(passwd))
+
+    ensure(ret == 0,
+           "Wrong password",
+           raising=exc.InvalidkeyError)
+    # all went well, therefore:
+    return True
+
+
+crypto_pwhash_argon2i_str_verify = crypto_pwhash_str_verify
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_scalarmult.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_scalarmult.py
new file mode 100644
index 0000000000000000000000000000000000000000..da7ca6f3ab31ddf728fe7320df80e6d9669c356a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_scalarmult.py
@@ -0,0 +1,230 @@
+# Copyright 2013-2018 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+has_crypto_scalarmult_ed25519 = \
+    bool(lib.PYNACL_HAS_CRYPTO_SCALARMULT_ED25519)
+
+crypto_scalarmult_BYTES = lib.crypto_scalarmult_bytes()
+crypto_scalarmult_SCALARBYTES = lib.crypto_scalarmult_scalarbytes()
+
+crypto_scalarmult_ed25519_BYTES = 0
+crypto_scalarmult_ed25519_SCALARBYTES = 0
+
+if has_crypto_scalarmult_ed25519:
+    crypto_scalarmult_ed25519_BYTES = \
+        lib.crypto_scalarmult_ed25519_bytes()
+    crypto_scalarmult_ed25519_SCALARBYTES = \
+        lib.crypto_scalarmult_ed25519_scalarbytes()
+
+
+def crypto_scalarmult_base(n):
+    """
+    Computes and returns the scalar product of a standard group element and an
+    integer ``n``.
+
+    :param n: bytes
+    :rtype: bytes
+    """
+    q = ffi.new("unsigned char[]", crypto_scalarmult_BYTES)
+
+    rc = lib.crypto_scalarmult_base(q, n)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_SCALARBYTES)[:]
+
+
+def crypto_scalarmult(n, p):
+    """
+    Computes and returns the scalar product of the given group element and an
+    integer ``n``.
+
+    :param p: bytes
+    :param n: bytes
+    :rtype: bytes
+    """
+    q = ffi.new("unsigned char[]", crypto_scalarmult_BYTES)
+
+    rc = lib.crypto_scalarmult(q, n, p)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_SCALARBYTES)[:]
+
+
+def crypto_scalarmult_ed25519_base(n):
+    """
+    Computes and returns the scalar product of a standard group element and an
+    integer ``n`` on the edwards25519 curve.
+
+    :param n: a :py:data:`.crypto_scalarmult_ed25519_SCALARBYTES` long bytes
+              sequence representing a scalar
+    :type n: bytes
+    :return: a point on the edwards25519 curve, represented as a
+             :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_scalarmult_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(n, bytes) and
+           len(n) == crypto_scalarmult_ed25519_SCALARBYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    q = ffi.new("unsigned char[]", crypto_scalarmult_ed25519_BYTES)
+
+    rc = lib.crypto_scalarmult_ed25519_base(q, n)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_ed25519_BYTES)[:]
+
+
+def crypto_scalarmult_ed25519_base_noclamp(n):
+    """
+    Computes and returns the scalar product of a standard group element and an
+    integer ``n`` on the edwards25519 curve. The integer ``n`` is not clamped.
+
+    :param n: a :py:data:`.crypto_scalarmult_ed25519_SCALARBYTES` long bytes
+              sequence representing a scalar
+    :type n: bytes
+    :return: a point on the edwards25519 curve, represented as a
+             :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_scalarmult_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(n, bytes) and
+           len(n) == crypto_scalarmult_ed25519_SCALARBYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    q = ffi.new("unsigned char[]", crypto_scalarmult_ed25519_BYTES)
+
+    rc = lib.crypto_scalarmult_ed25519_base_noclamp(q, n)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_ed25519_BYTES)[:]
+
+
+def crypto_scalarmult_ed25519(n, p):
+    """
+    Computes and returns the scalar product of a *clamped* integer ``n``
+    and the given group element on the edwards25519 curve.
+    The scalar is clamped, as done in the public key generation case,
+    by setting to zero the bits in position [0, 1, 2, 255] and setting
+    to one the bit in position 254.
+
+    :param n: a :py:data:`.crypto_scalarmult_ed25519_SCALARBYTES` long bytes
+              sequence representing a scalar
+    :type n: bytes
+    :param p: a :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type p: bytes
+    :return: a point on the edwards25519 curve, represented as a
+             :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_scalarmult_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(n, bytes) and
+           len(n) == crypto_scalarmult_ed25519_SCALARBYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    ensure(isinstance(p, bytes) and
+           len(p) == crypto_scalarmult_ed25519_BYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_BYTES'),
+           raising=exc.TypeError)
+
+    q = ffi.new("unsigned char[]", crypto_scalarmult_ed25519_BYTES)
+
+    rc = lib.crypto_scalarmult_ed25519(q, n, p)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_ed25519_BYTES)[:]
+
+
+def crypto_scalarmult_ed25519_noclamp(n, p):
+    """
+    Computes and returns the scalar product of an integer ``n``
+    and the given group element on the edwards25519 curve. The integer
+    ``n`` is not clamped.
+
+    :param n: a :py:data:`.crypto_scalarmult_ed25519_SCALARBYTES` long bytes
+              sequence representing a scalar
+    :type n: bytes
+    :param p: a :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+              representing a point on the edwards25519 curve
+    :type p: bytes
+    :return: a point on the edwards25519 curve, represented as a
+             :py:data:`.crypto_scalarmult_ed25519_BYTES` long bytes sequence
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_scalarmult_ed25519,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(isinstance(n, bytes) and
+           len(n) == crypto_scalarmult_ed25519_SCALARBYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_SCALARBYTES'),
+           raising=exc.TypeError)
+
+    ensure(isinstance(p, bytes) and
+           len(p) == crypto_scalarmult_ed25519_BYTES,
+           'Input must be a {} long bytes sequence'.format(
+           'crypto_scalarmult_ed25519_BYTES'),
+           raising=exc.TypeError)
+
+    q = ffi.new("unsigned char[]", crypto_scalarmult_ed25519_BYTES)
+
+    rc = lib.crypto_scalarmult_ed25519_noclamp(q, n, p)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(q, crypto_scalarmult_ed25519_BYTES)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretbox.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..5323b26c8e4abff174fa1f4db5eafefb0a6e9c8d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretbox.py
@@ -0,0 +1,81 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+crypto_secretbox_KEYBYTES = lib.crypto_secretbox_keybytes()
+crypto_secretbox_NONCEBYTES = lib.crypto_secretbox_noncebytes()
+crypto_secretbox_ZEROBYTES = lib.crypto_secretbox_zerobytes()
+crypto_secretbox_BOXZEROBYTES = lib.crypto_secretbox_boxzerobytes()
+crypto_secretbox_MACBYTES = lib.crypto_secretbox_macbytes()
+crypto_secretbox_MESSAGEBYTES_MAX = lib.crypto_secretbox_messagebytes_max()
+
+
+def crypto_secretbox(message, nonce, key):
+    """
+    Encrypts and returns the message ``message`` with the secret ``key`` and
+    the nonce ``nonce``.
+
+    :param message: bytes
+    :param nonce: bytes
+    :param key: bytes
+    :rtype: bytes
+    """
+    if len(key) != crypto_secretbox_KEYBYTES:
+        raise exc.ValueError("Invalid key")
+
+    if len(nonce) != crypto_secretbox_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce")
+
+    padded = b"\x00" * crypto_secretbox_ZEROBYTES + message
+    ciphertext = ffi.new("unsigned char[]", len(padded))
+
+    res = lib.crypto_secretbox(ciphertext, padded, len(padded), nonce, key)
+    ensure(res == 0, "Encryption failed", raising=exc.CryptoError)
+
+    ciphertext = ffi.buffer(ciphertext, len(padded))
+    return ciphertext[crypto_secretbox_BOXZEROBYTES:]
+
+
+def crypto_secretbox_open(ciphertext, nonce, key):
+    """
+    Decrypt and returns the encrypted message ``ciphertext`` with the secret
+    ``key`` and the nonce ``nonce``.
+
+    :param ciphertext: bytes
+    :param nonce: bytes
+    :param key: bytes
+    :rtype: bytes
+    """
+    if len(key) != crypto_secretbox_KEYBYTES:
+        raise exc.ValueError("Invalid key")
+
+    if len(nonce) != crypto_secretbox_NONCEBYTES:
+        raise exc.ValueError("Invalid nonce")
+
+    padded = b"\x00" * crypto_secretbox_BOXZEROBYTES + ciphertext
+    plaintext = ffi.new("unsigned char[]", len(padded))
+
+    res = lib.crypto_secretbox_open(
+        plaintext, padded, len(padded), nonce, key)
+    ensure(res == 0, "Decryption failed. Ciphertext failed verification",
+           raising=exc.CryptoError)
+
+    plaintext = ffi.buffer(plaintext, len(padded))
+    return plaintext[crypto_secretbox_ZEROBYTES:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretstream.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretstream.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e5b32e76f48a34ec21b7f0b7bd6acda3868d369
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_secretstream.py
@@ -0,0 +1,323 @@
+# Copyright 2013-2018 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+crypto_secretstream_xchacha20poly1305_ABYTES = \
+    lib.crypto_secretstream_xchacha20poly1305_abytes()
+crypto_secretstream_xchacha20poly1305_HEADERBYTES = \
+    lib.crypto_secretstream_xchacha20poly1305_headerbytes()
+crypto_secretstream_xchacha20poly1305_KEYBYTES = \
+    lib.crypto_secretstream_xchacha20poly1305_keybytes()
+crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX = \
+    lib.crypto_secretstream_xchacha20poly1305_messagebytes_max()
+crypto_secretstream_xchacha20poly1305_STATEBYTES = \
+    lib.crypto_secretstream_xchacha20poly1305_statebytes()
+
+
+crypto_secretstream_xchacha20poly1305_TAG_MESSAGE = \
+    lib.crypto_secretstream_xchacha20poly1305_tag_message()
+crypto_secretstream_xchacha20poly1305_TAG_PUSH = \
+    lib.crypto_secretstream_xchacha20poly1305_tag_push()
+crypto_secretstream_xchacha20poly1305_TAG_REKEY = \
+    lib.crypto_secretstream_xchacha20poly1305_tag_rekey()
+crypto_secretstream_xchacha20poly1305_TAG_FINAL = \
+    lib.crypto_secretstream_xchacha20poly1305_tag_final()
+
+
+def crypto_secretstream_xchacha20poly1305_keygen():
+    """
+    Generate a key for use with
+    :func:`.crypto_secretstream_xchacha20poly1305_init_push`.
+
+    """
+    keybuf = ffi.new(
+        "unsigned char[]",
+        crypto_secretstream_xchacha20poly1305_KEYBYTES,
+    )
+    lib.crypto_secretstream_xchacha20poly1305_keygen(keybuf)
+    return ffi.buffer(keybuf)[:]
+
+
+class crypto_secretstream_xchacha20poly1305_state(object):
+    """
+    An object wrapping the crypto_secretstream_xchacha20poly1305 state.
+
+    """
+    __slots__ = ['statebuf', 'rawbuf', 'tagbuf']
+
+    def __init__(self):
+        """ Initialize a clean state object."""
+        self.statebuf = ffi.new(
+            "unsigned char[]",
+            crypto_secretstream_xchacha20poly1305_STATEBYTES,
+        )
+
+        self.rawbuf = None
+        self.tagbuf = None
+
+
+def crypto_secretstream_xchacha20poly1305_init_push(state, key):
+    """
+    Initialize a crypto_secretstream_xchacha20poly1305 encryption buffer.
+
+    :param state: a secretstream state object
+    :type state: crypto_secretstream_xchacha20poly1305_state
+    :param key: must be
+                :data:`.crypto_secretstream_xchacha20poly1305_KEYBYTES` long
+    :type key: bytes
+    :return: header
+    :rtype: bytes
+
+    """
+    ensure(
+        isinstance(state, crypto_secretstream_xchacha20poly1305_state),
+        'State must be a crypto_secretstream_xchacha20poly1305_state object',
+        raising=exc.TypeError,
+    )
+    ensure(
+        isinstance(key, bytes),
+        'Key must be a bytes sequence',
+        raising=exc.TypeError,
+    )
+    ensure(
+        len(key) == crypto_secretstream_xchacha20poly1305_KEYBYTES,
+        'Invalid key length',
+        raising=exc.ValueError,
+    )
+
+    headerbuf = ffi.new(
+        "unsigned char []",
+        crypto_secretstream_xchacha20poly1305_HEADERBYTES,
+    )
+
+    rc = lib.crypto_secretstream_xchacha20poly1305_init_push(
+        state.statebuf, headerbuf, key)
+    ensure(rc == 0, 'Unexpected failure', raising=exc.RuntimeError)
+
+    return ffi.buffer(headerbuf)[:]
+
+
+def crypto_secretstream_xchacha20poly1305_push(
+    state,
+    m,
+    ad=None,
+    tag=crypto_secretstream_xchacha20poly1305_TAG_MESSAGE,
+):
+    """
+    Add an encrypted message to the secret stream.
+
+    :param state: a secretstream state object
+    :type state: crypto_secretstream_xchacha20poly1305_state
+    :param m: the message to encrypt, the maximum length of an individual
+              message is
+              :data:`.crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX`.
+    :type m: bytes
+    :param ad: additional data to include in the authentication tag
+    :type ad: bytes or None
+    :param tag: the message tag, usually
+                :data:`.crypto_secretstream_xchacha20poly1305_TAG_MESSAGE` or
+                :data:`.crypto_secretstream_xchacha20poly1305_TAG_FINAL`.
+    :type tag: int
+    :return: ciphertext
+    :rtype: bytes
+
+    """
+    ensure(
+        isinstance(state, crypto_secretstream_xchacha20poly1305_state),
+        'State must be a crypto_secretstream_xchacha20poly1305_state object',
+        raising=exc.TypeError,
+    )
+    ensure(isinstance(m, bytes), 'Message is not bytes', raising=exc.TypeError)
+    ensure(
+        len(m) <= crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX,
+        'Message is too long',
+        raising=exc.ValueError,
+    )
+    ensure(
+        ad is None or isinstance(ad, bytes),
+        'Additional data must be bytes or None',
+        raising=exc.TypeError,
+    )
+
+    clen = len(m) + crypto_secretstream_xchacha20poly1305_ABYTES
+    if state.rawbuf is None or len(state.rawbuf) < clen:
+        state.rawbuf = ffi.new('unsigned char[]', clen)
+
+    if ad is None:
+        ad = ffi.NULL
+        adlen = 0
+    else:
+        adlen = len(ad)
+
+    rc = lib.crypto_secretstream_xchacha20poly1305_push(
+        state.statebuf,
+        state.rawbuf, ffi.NULL,
+        m, len(m),
+        ad, adlen,
+        tag,
+    )
+    ensure(rc == 0, 'Unexpected failure', raising=exc.RuntimeError)
+
+    return ffi.buffer(state.rawbuf, clen)[:]
+
+
+def crypto_secretstream_xchacha20poly1305_init_pull(state, header, key):
+    """
+    Initialize a crypto_secretstream_xchacha20poly1305 decryption buffer.
+
+    :param state: a secretstream state object
+    :type state: crypto_secretstream_xchacha20poly1305_state
+    :param header: must be
+                :data:`.crypto_secretstream_xchacha20poly1305_HEADERBYTES` long
+    :type header: bytes
+    :param key: must be
+                :data:`.crypto_secretstream_xchacha20poly1305_KEYBYTES` long
+    :type key: bytes
+
+    """
+    ensure(
+        isinstance(state, crypto_secretstream_xchacha20poly1305_state),
+        'State must be a crypto_secretstream_xchacha20poly1305_state object',
+        raising=exc.TypeError,
+    )
+    ensure(
+        isinstance(header, bytes),
+        'Header must be a bytes sequence',
+        raising=exc.TypeError,
+    )
+    ensure(
+        len(header) == crypto_secretstream_xchacha20poly1305_HEADERBYTES,
+        'Invalid header length',
+        raising=exc.ValueError,
+    )
+    ensure(
+        isinstance(key, bytes),
+        'Key must be a bytes sequence',
+        raising=exc.TypeError,
+    )
+    ensure(
+        len(key) == crypto_secretstream_xchacha20poly1305_KEYBYTES,
+        'Invalid key length',
+        raising=exc.ValueError,
+    )
+
+    if state.tagbuf is None:
+        state.tagbuf = ffi.new('unsigned char *')
+
+    rc = lib.crypto_secretstream_xchacha20poly1305_init_pull(
+        state.statebuf, header, key)
+    ensure(rc == 0, 'Unexpected failure', raising=exc.RuntimeError)
+
+
+def crypto_secretstream_xchacha20poly1305_pull(state, c, ad=None):
+    """
+    Read a decrypted message from the secret stream.
+
+    :param state: a secretstream state object
+    :type state: crypto_secretstream_xchacha20poly1305_state
+    :param c: the ciphertext to decrypt, the maximum length of an individual
+              ciphertext is
+              :data:`.crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX` +
+              :data:`.crypto_secretstream_xchacha20poly1305_ABYTES`.
+    :type c: bytes
+    :param ad: additional data to include in the authentication tag
+    :type ad: bytes or None
+    :return: (message, tag)
+    :rtype: (bytes, int)
+
+    """
+    ensure(
+        isinstance(state, crypto_secretstream_xchacha20poly1305_state),
+        'State must be a crypto_secretstream_xchacha20poly1305_state object',
+        raising=exc.TypeError,
+    )
+    ensure(
+        state.tagbuf is not None,
+        (
+            'State must be initialized using '
+            'crypto_secretstream_xchacha20poly1305_init_pull'
+        ),
+        raising=exc.ValueError,
+    )
+    ensure(
+        isinstance(c, bytes),
+        'Ciphertext is not bytes',
+        raising=exc.TypeError,
+    )
+    ensure(
+        len(c) >= crypto_secretstream_xchacha20poly1305_ABYTES,
+        'Ciphertext is too short',
+        raising=exc.ValueError,
+    )
+    ensure(
+        len(c) <= (
+            crypto_secretstream_xchacha20poly1305_MESSAGEBYTES_MAX +
+            crypto_secretstream_xchacha20poly1305_ABYTES
+        ),
+        'Ciphertext is too long',
+        raising=exc.ValueError,
+    )
+    ensure(
+        ad is None or isinstance(ad, bytes),
+        'Additional data must be bytes or None',
+        raising=exc.TypeError,
+    )
+
+    mlen = len(c) - crypto_secretstream_xchacha20poly1305_ABYTES
+    if state.rawbuf is None or len(state.rawbuf) < mlen:
+        state.rawbuf = ffi.new('unsigned char[]', mlen)
+
+    if ad is None:
+        ad = ffi.NULL
+        adlen = 0
+    else:
+        adlen = len(ad)
+
+    rc = lib.crypto_secretstream_xchacha20poly1305_pull(
+        state.statebuf,
+        state.rawbuf, ffi.NULL,
+        state.tagbuf,
+        c, len(c),
+        ad, adlen,
+    )
+    ensure(rc == 0, 'Unexpected failure', raising=exc.RuntimeError)
+
+    return (ffi.buffer(state.rawbuf, mlen)[:], int(state.tagbuf[0]))
+
+
+def crypto_secretstream_xchacha20poly1305_rekey(state):
+    """
+    Explicitly change the encryption key in the stream.
+
+    Normally the stream is re-keyed as needed or an explicit ``tag`` of
+    :data:`.crypto_secretstream_xchacha20poly1305_TAG_REKEY` is added to a
+    message to ensure forward secrecy, but this method can be used instead
+    if the re-keying is controlled without adding the tag.
+
+    :param state: a secretstream state object
+    :type state: crypto_secretstream_xchacha20poly1305_state
+
+    """
+    ensure(
+        isinstance(state, crypto_secretstream_xchacha20poly1305_state),
+        'State must be a crypto_secretstream_xchacha20poly1305_state object',
+        raising=exc.TypeError,
+    )
+    lib.crypto_secretstream_xchacha20poly1305_rekey(state.statebuf)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_shorthash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_shorthash.py
new file mode 100644
index 0000000000000000000000000000000000000000..38f2ef954349d226794072af0348bb14c7e8d763
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_shorthash.py
@@ -0,0 +1,77 @@
+# Copyright 2016 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import nacl.exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+has_crypto_shorthash_siphashx24 = \
+    bool(lib.PYNACL_HAS_CRYPTO_SHORTHASH_SIPHASHX24)
+
+BYTES = lib.crypto_shorthash_siphash24_bytes()
+KEYBYTES = lib.crypto_shorthash_siphash24_keybytes()
+
+XBYTES = 0
+XKEYBYTES = 0
+
+if has_crypto_shorthash_siphashx24:
+    XBYTES = lib.crypto_shorthash_siphashx24_bytes()
+    XKEYBYTES = lib.crypto_shorthash_siphashx24_keybytes()
+
+
+def crypto_shorthash_siphash24(data, key):
+    """Compute a fast, cryptographic quality, keyed hash of the input data
+
+    :param data:
+    :type data: bytes
+    :param key: len(key) must be equal to
+                :py:data:`.KEYBYTES` (16)
+    :type key: bytes
+    """
+    if len(key) != KEYBYTES:
+        raise exc.ValueError(
+            "Key length must be exactly {0} bytes".format(KEYBYTES))
+    digest = ffi.new("unsigned char[]", BYTES)
+    rc = lib.crypto_shorthash_siphash24(digest, data, len(data), key)
+
+    ensure(rc == 0, raising=exc.RuntimeError)
+    return ffi.buffer(digest, BYTES)[:]
+
+
+def crypto_shorthash_siphashx24(data, key):
+    """Compute a fast, cryptographic quality, keyed hash of the input data
+
+    :param data:
+    :type data: bytes
+    :param key: len(key) must be equal to
+                :py:data:`.XKEYBYTES` (16)
+    :type key: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+    """
+    ensure(has_crypto_shorthash_siphashx24,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    if len(key) != XKEYBYTES:
+        raise exc.ValueError(
+            "Key length must be exactly {0} bytes".format(XKEYBYTES))
+    digest = ffi.new("unsigned char[]", XBYTES)
+    rc = lib.crypto_shorthash_siphashx24(digest, data, len(data), key)
+
+    ensure(rc == 0, raising=exc.RuntimeError)
+    return ffi.buffer(digest, XBYTES)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_sign.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_sign.py
new file mode 100644
index 0000000000000000000000000000000000000000..6390dbd2591ca4c9d0712c3459454606809703b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/crypto_sign.py
@@ -0,0 +1,319 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+crypto_sign_BYTES = lib.crypto_sign_bytes()
+# crypto_sign_SEEDBYTES = lib.crypto_sign_seedbytes()
+crypto_sign_SEEDBYTES = lib.crypto_sign_secretkeybytes() // 2
+crypto_sign_PUBLICKEYBYTES = lib.crypto_sign_publickeybytes()
+crypto_sign_SECRETKEYBYTES = lib.crypto_sign_secretkeybytes()
+
+crypto_sign_curve25519_BYTES = lib.crypto_box_secretkeybytes()
+
+crypto_sign_ed25519ph_STATEBYTES = lib.crypto_sign_ed25519ph_statebytes()
+
+
+def crypto_sign_keypair():
+    """
+    Returns a randomly generated public key and secret key.
+
+    :rtype: (bytes(public_key), bytes(secret_key))
+    """
+    pk = ffi.new("unsigned char[]", crypto_sign_PUBLICKEYBYTES)
+    sk = ffi.new("unsigned char[]", crypto_sign_SECRETKEYBYTES)
+
+    rc = lib.crypto_sign_keypair(pk, sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return (
+        ffi.buffer(pk, crypto_sign_PUBLICKEYBYTES)[:],
+        ffi.buffer(sk, crypto_sign_SECRETKEYBYTES)[:],
+    )
+
+
+def crypto_sign_seed_keypair(seed):
+    """
+    Computes and returns the public key and secret key using the seed ``seed``.
+
+    :param seed: bytes
+    :rtype: (bytes(public_key), bytes(secret_key))
+    """
+    if len(seed) != crypto_sign_SEEDBYTES:
+        raise exc.ValueError("Invalid seed")
+
+    pk = ffi.new("unsigned char[]", crypto_sign_PUBLICKEYBYTES)
+    sk = ffi.new("unsigned char[]", crypto_sign_SECRETKEYBYTES)
+
+    rc = lib.crypto_sign_seed_keypair(pk, sk, seed)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return (
+        ffi.buffer(pk, crypto_sign_PUBLICKEYBYTES)[:],
+        ffi.buffer(sk, crypto_sign_SECRETKEYBYTES)[:],
+    )
+
+
+def crypto_sign(message, sk):
+    """
+    Signs the message ``message`` using the secret key ``sk`` and returns the
+    signed message.
+
+    :param message: bytes
+    :param sk: bytes
+    :rtype: bytes
+    """
+    signed = ffi.new("unsigned char[]", len(message) + crypto_sign_BYTES)
+    signed_len = ffi.new("unsigned long long *")
+
+    rc = lib.crypto_sign(signed, signed_len, message, len(message), sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(signed, signed_len[0])[:]
+
+
+def crypto_sign_open(signed, pk):
+    """
+    Verifies the signature of the signed message ``signed`` using the public
+    key ``pk`` and returns the unsigned message.
+
+    :param signed: bytes
+    :param pk: bytes
+    :rtype: bytes
+    """
+    message = ffi.new("unsigned char[]", len(signed))
+    message_len = ffi.new("unsigned long long *")
+
+    if lib.crypto_sign_open(
+            message, message_len, signed, len(signed), pk) != 0:
+        raise exc.BadSignatureError("Signature was forged or corrupt")
+
+    return ffi.buffer(message, message_len[0])[:]
+
+
+def crypto_sign_ed25519_pk_to_curve25519(public_key_bytes):
+    """
+    Converts a public Ed25519 key (encoded as bytes ``public_key_bytes``) to
+    a public Curve25519 key as bytes.
+
+    Raises a ValueError if ``public_key_bytes`` is not of length
+    ``crypto_sign_PUBLICKEYBYTES``
+
+    :param public_key_bytes: bytes
+    :rtype: bytes
+    """
+    if len(public_key_bytes) != crypto_sign_PUBLICKEYBYTES:
+        raise exc.ValueError("Invalid curve public key")
+
+    curve_public_key_len = crypto_sign_curve25519_BYTES
+    curve_public_key = ffi.new("unsigned char[]", curve_public_key_len)
+
+    rc = lib.crypto_sign_ed25519_pk_to_curve25519(curve_public_key,
+                                                  public_key_bytes)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(curve_public_key, curve_public_key_len)[:]
+
+
+def crypto_sign_ed25519_sk_to_curve25519(secret_key_bytes):
+    """
+    Converts a secret Ed25519 key (encoded as bytes ``secret_key_bytes``) to
+    a secret Curve25519 key as bytes.
+
+    Raises a ValueError if ``secret_key_bytes``is not of length
+    ``crypto_sign_SECRETKEYBYTES``
+
+    :param secret_key_bytes: bytes
+    :rtype: bytes
+    """
+    if len(secret_key_bytes) != crypto_sign_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid curve secret key")
+
+    curve_secret_key_len = crypto_sign_curve25519_BYTES
+    curve_secret_key = ffi.new("unsigned char[]", curve_secret_key_len)
+
+    rc = lib.crypto_sign_ed25519_sk_to_curve25519(curve_secret_key,
+                                                  secret_key_bytes)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(curve_secret_key, curve_secret_key_len)[:]
+
+
+def crypto_sign_ed25519_sk_to_pk(secret_key_bytes):
+    """
+    Extract the public Ed25519 key from a secret Ed25519 key (encoded
+    as bytes ``secret_key_bytes``).
+
+    Raises a ValueError if ``secret_key_bytes``is not of length
+    ``crypto_sign_SECRETKEYBYTES``
+
+    :param secret_key_bytes: bytes
+    :rtype: bytes
+    """
+    if len(secret_key_bytes) != crypto_sign_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    return secret_key_bytes[crypto_sign_SEEDBYTES:]
+
+
+def crypto_sign_ed25519_sk_to_seed(secret_key_bytes):
+    """
+    Extract the seed from a secret Ed25519 key (encoded
+    as bytes ``secret_key_bytes``).
+
+    Raises a ValueError if ``secret_key_bytes``is not of length
+    ``crypto_sign_SECRETKEYBYTES``
+
+    :param secret_key_bytes: bytes
+    :rtype: bytes
+    """
+    if len(secret_key_bytes) != crypto_sign_SECRETKEYBYTES:
+        raise exc.ValueError("Invalid secret key")
+
+    return secret_key_bytes[:crypto_sign_SEEDBYTES]
+
+
+class crypto_sign_ed25519ph_state(object):
+    """
+    State object wrapping the sha-512 state used in ed25519ph computation
+    """
+    __slots__ = ['state']
+
+    def __init__(self):
+        self.state = ffi.new('unsigned char[]',
+                             crypto_sign_ed25519ph_STATEBYTES)
+
+        rc = lib.crypto_sign_ed25519ph_init(self.state)
+
+        ensure(rc == 0,
+               'Unexpected library error',
+               raising=exc.RuntimeError)
+
+
+def crypto_sign_ed25519ph_update(edph, pmsg):
+    """
+    Update the hash state wrapped in edph
+
+    :param edph: the ed25519ph state being updated
+    :type edph: crypto_sign_ed25519ph_state
+    :param pmsg: the partial message
+    :type pmsg: bytes
+    :rtype: None
+    """
+    ensure(isinstance(edph, crypto_sign_ed25519ph_state),
+           'edph parameter must be a ed25519ph_state object',
+           raising=exc.TypeError)
+    ensure(isinstance(pmsg, bytes),
+           'pmsg parameter must be a bytes object',
+           raising=exc.TypeError)
+    rc = lib.crypto_sign_ed25519ph_update(edph.state,
+                                          pmsg,
+                                          len(pmsg))
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+
+def crypto_sign_ed25519ph_final_create(edph,
+                                       sk):
+    """
+    Create a signature for the data hashed in edph
+    using the secret key sk
+
+    :param edph: the ed25519ph state for the data
+                 being signed
+    :type edph: crypto_sign_ed25519ph_state
+    :param sk: the ed25519 secret part of the signing key
+    :type sk: bytes
+    :return: ed25519ph signature
+    :rtype: bytes
+    """
+    ensure(isinstance(edph, crypto_sign_ed25519ph_state),
+           'edph parameter must be a ed25519ph_state object',
+           raising=exc.TypeError)
+    ensure(isinstance(sk, bytes),
+           'secret key parameter must be a bytes object',
+           raising=exc.TypeError)
+    ensure(len(sk) == crypto_sign_SECRETKEYBYTES,
+           ('secret key must be {0} '
+            'bytes long').format(crypto_sign_SECRETKEYBYTES),
+           raising=exc.TypeError)
+    signature = ffi.new("unsigned char[]", crypto_sign_BYTES)
+    rc = lib.crypto_sign_ed25519ph_final_create(edph.state,
+                                                signature,
+                                                ffi.NULL,
+                                                sk)
+    ensure(rc == 0,
+           'Unexpected library error',
+           raising=exc.RuntimeError)
+
+    return ffi.buffer(signature, crypto_sign_BYTES)[:]
+
+
+def crypto_sign_ed25519ph_final_verify(edph,
+                                       signature,
+                                       pk):
+    """
+    Verify a prehashed signature using the public key pk
+
+    :param edph: the ed25519ph state for the data
+                 being verified
+    :type edph: crypto_sign_ed25519ph_state
+    :param signature: the signature being verified
+    :type signature: bytes
+    :param pk: the ed25519 public part of the signing key
+    :type pk: bytes
+    :return: True if the signature is valid
+    :rtype: boolean
+    :raises exc.BadSignatureError: if the signature is not valid
+    """
+    ensure(isinstance(edph, crypto_sign_ed25519ph_state),
+           'edph parameter must be a ed25519ph_state object',
+           raising=exc.TypeError)
+    ensure(isinstance(signature, bytes),
+           'signature parameter must be a bytes object',
+           raising=exc.TypeError)
+    ensure(len(signature) == crypto_sign_BYTES,
+           ('signature must be {0} '
+            'bytes long').format(crypto_sign_BYTES),
+           raising=exc.TypeError)
+    ensure(isinstance(pk, bytes),
+           'public key parameter must be a bytes object',
+           raising=exc.TypeError)
+    ensure(len(pk) == crypto_sign_PUBLICKEYBYTES,
+           ('public key must be {0} '
+            'bytes long').format(crypto_sign_PUBLICKEYBYTES),
+           raising=exc.TypeError)
+    rc = lib.crypto_sign_ed25519ph_final_verify(edph.state,
+                                                signature,
+                                                pk)
+    if rc != 0:
+        raise exc.BadSignatureError("Signature was forged or corrupt")
+
+    return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/randombytes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/randombytes.py
new file mode 100644
index 0000000000000000000000000000000000000000..def5019be611b2c38a4fe2090b5227e58220ca7d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/randombytes.py
@@ -0,0 +1,51 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+
+randombytes_SEEDBYTES = lib.randombytes_seedbytes()
+
+
+def randombytes(size):
+    """
+    Returns ``size`` number of random bytes from a cryptographically secure
+    random source.
+
+    :param size: int
+    :rtype: bytes
+    """
+    buf = ffi.new("unsigned char[]", size)
+    lib.randombytes(buf, size)
+    return ffi.buffer(buf, size)[:]
+
+
+def randombytes_buf_deterministic(size, seed):
+    """
+    Returns ``size`` number of deterministically generated pseudorandom bytes
+    from a seed
+
+    :param size: int
+    :param seed: bytes
+    :rtype: bytes
+    """
+    if len(seed) != randombytes_SEEDBYTES:
+        raise exc.TypeError("Deterministic random bytes must be generated "
+                            "from 32 bytes")
+
+    buf = ffi.new("unsigned char[]", size)
+    lib.randombytes_buf_deterministic(buf, size, seed)
+    return ffi.buffer(buf, size)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/sodium_core.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/sodium_core.py
new file mode 100644
index 0000000000000000000000000000000000000000..67ebb21f4f0472dcf5fe19a26ab983e74d87f626
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/sodium_core.py
@@ -0,0 +1,32 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import, division, print_function
+
+from nacl import exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+def _sodium_init():
+    ensure(lib.sodium_init() != -1,
+           "Could not initialize sodium",
+           raising=exc.RuntimeError)
+
+
+def sodium_init():
+    """
+    Initializes sodium, picking the best implementations available for this
+    machine.
+    """
+    ffi.init_once(_sodium_init, "libsodium")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..84f0a5104311ca86e2f59290d3319127de9979a9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/bindings/utils.py
@@ -0,0 +1,154 @@
+# Copyright 2013-2017 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import, division, print_function
+
+from six import integer_types
+
+import nacl.exceptions as exc
+from nacl._sodium import ffi, lib
+from nacl.exceptions import ensure
+
+
+def sodium_memcmp(inp1, inp2):
+    """
+    Compare contents of two memory regions in constant time
+    """
+    ensure(isinstance(inp1, bytes),
+           raising=exc.TypeError)
+    ensure(isinstance(inp2, bytes),
+           raising=exc.TypeError)
+
+    ln = max(len(inp1), len(inp2))
+
+    buf1 = ffi.new("char []", ln)
+    buf2 = ffi.new("char []", ln)
+
+    ffi.memmove(buf1, inp1, len(inp1))
+    ffi.memmove(buf2, inp2, len(inp2))
+
+    eqL = len(inp1) == len(inp2)
+    eqC = lib.sodium_memcmp(buf1, buf2, ln) == 0
+
+    return eqL and eqC
+
+
+def sodium_pad(s, blocksize):
+    """
+    Pad the input bytearray ``s`` to a multiple of ``blocksize``
+    using the ISO/IEC 7816-4 algorithm
+
+    :param s: input bytes string
+    :type s: bytes
+    :param blocksize:
+    :type blocksize: int
+    :return: padded string
+    :rtype: bytes
+    """
+    ensure(isinstance(s, bytes),
+           raising=exc.TypeError)
+    ensure(isinstance(blocksize, integer_types),
+           raising=exc.TypeError)
+    if blocksize <= 0:
+        raise exc.ValueError
+    s_len = len(s)
+    m_len = s_len + blocksize
+    buf = ffi.new("unsigned char []", m_len)
+    p_len = ffi.new("size_t []", 1)
+    ffi.memmove(buf, s, s_len)
+    rc = lib.sodium_pad(p_len, buf, s_len, blocksize, m_len)
+    ensure(rc == 0, "Padding failure", raising=exc.CryptoError)
+    return ffi.buffer(buf, p_len[0])[:]
+
+
+def sodium_unpad(s, blocksize):
+    """
+    Remove ISO/IEC 7816-4 padding from the input byte array ``s``
+
+    :param s: input bytes string
+    :type s: bytes
+    :param blocksize:
+    :type blocksize: int
+    :return: unpadded string
+    :rtype: bytes
+    """
+    ensure(isinstance(s, bytes),
+           raising=exc.TypeError)
+    ensure(isinstance(blocksize, integer_types),
+           raising=exc.TypeError)
+    s_len = len(s)
+    u_len = ffi.new("size_t []", 1)
+    rc = lib.sodium_unpad(u_len, s, s_len, blocksize)
+    if rc != 0:
+        raise exc.CryptoError("Unpadding failure")
+    return s[:u_len[0]]
+
+
+def sodium_increment(inp):
+    """
+    Increment the value of a byte-sequence interpreted
+    as the little-endian representation of a unsigned big integer.
+
+    :param inp: input bytes buffer
+    :type inp: bytes
+    :return: a byte-sequence representing, as a little-endian
+             unsigned big integer, the value ``to_int(inp)``
+             incremented by one.
+    :rtype: bytes
+
+    """
+    ensure(isinstance(inp, bytes),
+           raising=exc.TypeError)
+
+    ln = len(inp)
+    buf = ffi.new("unsigned char []", ln)
+
+    ffi.memmove(buf, inp, ln)
+
+    lib.sodium_increment(buf, ln)
+
+    return ffi.buffer(buf, ln)[:]
+
+
+def sodium_add(a, b):
+    """
+    Given a couple of *same-sized* byte sequences, interpreted as the
+    little-endian representation of two unsigned integers, compute
+    the modular addition of the represented values, in constant time for
+    a given common length of the byte sequences.
+
+    :param a: input bytes buffer
+    :type a: bytes
+    :param b: input bytes buffer
+    :type b: bytes
+    :return: a byte-sequence representing, as a little-endian big integer,
+             the integer value of ``(to_int(a) + to_int(b)) mod 2^(8*len(a))``
+    :rtype: bytes
+    """
+    ensure(isinstance(a, bytes),
+           raising=exc.TypeError)
+    ensure(isinstance(b, bytes),
+           raising=exc.TypeError)
+    ln = len(a)
+    ensure(len(b) == ln,
+           raising=exc.TypeError)
+
+    buf_a = ffi.new("unsigned char []", ln)
+    buf_b = ffi.new("unsigned char []", ln)
+
+    ffi.memmove(buf_a, a, ln)
+    ffi.memmove(buf_b, b, ln)
+
+    lib.sodium_add(buf_a, buf_b, ln)
+
+    return ffi.buffer(buf_a, ln)[:]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/encoding.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c771ac802b1a3d28e7fa0f4dc66858b5280919c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/encoding.py
@@ -0,0 +1,90 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import base64
+import binascii
+
+
+class RawEncoder(object):
+
+    @staticmethod
+    def encode(data):
+        return data
+
+    @staticmethod
+    def decode(data):
+        return data
+
+
+class HexEncoder(object):
+
+    @staticmethod
+    def encode(data):
+        return binascii.hexlify(data)
+
+    @staticmethod
+    def decode(data):
+        return binascii.unhexlify(data)
+
+
+class Base16Encoder(object):
+
+    @staticmethod
+    def encode(data):
+        return base64.b16encode(data)
+
+    @staticmethod
+    def decode(data):
+        return base64.b16decode(data)
+
+
+class Base32Encoder(object):
+
+    @staticmethod
+    def encode(data):
+        return base64.b32encode(data)
+
+    @staticmethod
+    def decode(data):
+        return base64.b32decode(data)
+
+
+class Base64Encoder(object):
+
+    @staticmethod
+    def encode(data):
+        return base64.b64encode(data)
+
+    @staticmethod
+    def decode(data):
+        return base64.b64decode(data)
+
+
+class URLSafeBase64Encoder(object):
+
+    @staticmethod
+    def encode(data):
+        return base64.urlsafe_b64encode(data)
+
+    @staticmethod
+    def decode(data):
+        return base64.urlsafe_b64decode(data)
+
+
+class Encodable(object):
+
+    def encode(self, encoder=RawEncoder):
+        return encoder.encode(bytes(self))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..57d28063c733cbaf8bc44e56d13f22b066ffc1d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/exceptions.py
@@ -0,0 +1,81 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+
+class CryptoError(Exception):
+    """
+    Base exception for all nacl related errors
+    """
+
+
+class BadSignatureError(CryptoError):
+    """
+    Raised when the signature was forged or otherwise corrupt.
+    """
+
+
+class RuntimeError(RuntimeError, CryptoError):
+    pass
+
+
+class AssertionError(AssertionError, CryptoError):
+    pass
+
+
+class TypeError(TypeError, CryptoError):
+    pass
+
+
+class ValueError(ValueError, CryptoError):
+    pass
+
+
+class InvalidkeyError(CryptoError):
+    pass
+
+
+class CryptPrefixError(InvalidkeyError):
+    pass
+
+
+class UnavailableError(RuntimeError):
+    """
+    is a subclass of :class:`~nacl.exceptions.RuntimeError`, raised when
+    trying to call functions not available in a minimal build of
+    libsodium.
+    """
+    pass
+
+
+def ensure(cond, *args, **kwds):
+    """
+    Return if a condition is true, otherwise raise a caller-configurable
+    :py:class:`Exception`
+    :param bool cond: the condition to be checked
+    :param sequence args: the arguments to be passed to the exception's
+                          constructor
+    The only accepted named parameter is `raising` used to configure the
+    exception to be raised if `cond` is not `True`
+    """
+    _CHK_UNEXP = 'check_condition() got an unexpected keyword argument {0}'
+
+    raising = kwds.pop('raising', AssertionError)
+    if kwds:
+        raise TypeError(_CHK_UNEXP.format(repr(kwds.popitem()[0])))
+
+    if cond is True:
+        return
+    raise raising(*args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hash.py
new file mode 100644
index 0000000000000000000000000000000000000000..c5e4e7e7755fba51a36b60ced5ac4a3eb9a7005f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hash.py
@@ -0,0 +1,165 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+The :mod:`nacl.hash` module exposes one-shot interfaces
+for libsodium selected hash primitives and the constants needed
+for their usage.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+import nacl.bindings
+import nacl.encoding
+
+
+BLAKE2B_BYTES = nacl.bindings.crypto_generichash_BYTES
+"""Default digest size for :func:`blake2b` hash"""
+BLAKE2B_BYTES_MIN = nacl.bindings.crypto_generichash_BYTES_MIN
+"""Minimum allowed digest size for :func:`blake2b` hash"""
+BLAKE2B_BYTES_MAX = nacl.bindings.crypto_generichash_BYTES_MAX
+"""Maximum allowed digest size for :func:`blake2b` hash"""
+BLAKE2B_KEYBYTES = nacl.bindings.crypto_generichash_KEYBYTES
+"""Default size of the ``key`` byte array for :func:`blake2b` hash"""
+BLAKE2B_KEYBYTES_MIN = nacl.bindings.crypto_generichash_KEYBYTES_MIN
+"""Minimum allowed size of the ``key`` byte array for :func:`blake2b` hash"""
+BLAKE2B_KEYBYTES_MAX = nacl.bindings.crypto_generichash_KEYBYTES_MAX
+"""Maximum allowed size of the ``key`` byte array for :func:`blake2b` hash"""
+BLAKE2B_SALTBYTES = nacl.bindings.crypto_generichash_SALTBYTES
+"""Maximum allowed length of the ``salt`` byte array for
+:func:`blake2b` hash"""
+BLAKE2B_PERSONALBYTES = nacl.bindings.crypto_generichash_PERSONALBYTES
+"""Maximum allowed length of the ``personalization``
+byte array for :func:`blake2b` hash"""
+
+SIPHASH_BYTES = nacl.bindings.crypto_shorthash_siphash24_BYTES
+"""Size of the :func:`siphash24` digest"""
+SIPHASH_KEYBYTES = nacl.bindings.crypto_shorthash_siphash24_KEYBYTES
+"""Size of the secret ``key`` used by the :func:`siphash24` MAC"""
+
+SIPHASHX_AVAILABLE = nacl.bindings.has_crypto_shorthash_siphashx24
+"""``True`` if :func:`siphashx24` is available to be called"""
+
+SIPHASHX_BYTES = nacl.bindings.crypto_shorthash_siphashx24_BYTES
+"""Size of the :func:`siphashx24` digest"""
+SIPHASHX_KEYBYTES = nacl.bindings.crypto_shorthash_siphashx24_KEYBYTES
+"""Size of the secret ``key`` used by the :func:`siphashx24` MAC"""
+
+_b2b_hash = nacl.bindings.crypto_generichash_blake2b_salt_personal
+_sip_hash = nacl.bindings.crypto_shorthash_siphash24
+_sip_hashx = nacl.bindings.crypto_shorthash_siphashx24
+
+
+def sha256(message, encoder=nacl.encoding.HexEncoder):
+    """
+    Hashes ``message`` with SHA256.
+
+    :param message: The message to hash.
+    :type message: bytes
+    :param encoder: A class that is able to encode the hashed message.
+    :returns: The hashed message.
+    :rtype: bytes
+    """
+    return encoder.encode(nacl.bindings.crypto_hash_sha256(message))
+
+
+def sha512(message, encoder=nacl.encoding.HexEncoder):
+    """
+    Hashes ``message`` with SHA512.
+
+    :param message: The message to hash.
+    :type message: bytes
+    :param encoder: A class that is able to encode the hashed message.
+    :returns: The hashed message.
+    :rtype: bytes
+    """
+    return encoder.encode(nacl.bindings.crypto_hash_sha512(message))
+
+
+def blake2b(data, digest_size=BLAKE2B_BYTES, key=b'',
+            salt=b'', person=b'',
+            encoder=nacl.encoding.HexEncoder):
+    """
+    Hashes ``data`` with blake2b.
+
+    :param data: the digest input byte sequence
+    :type data: bytes
+    :param digest_size: the requested digest size; must be at most
+                        :const:`BLAKE2B_BYTES_MAX`;
+                        the default digest size is
+                        :const:`BLAKE2B_BYTES`
+    :type digest_size: int
+    :param key: the key to be set for keyed MAC/PRF usage; if set, the key
+                must be at most :data:`~nacl.hash.BLAKE2B_KEYBYTES_MAX` long
+    :type key: bytes
+    :param salt: an initialization salt at most
+                 :const:`BLAKE2B_SALTBYTES` long;
+                 it will be zero-padded if needed
+    :type salt: bytes
+    :param person: a personalization string at most
+                   :const:`BLAKE2B_PERSONALBYTES` long;
+                   it will be zero-padded if needed
+    :type person: bytes
+    :param encoder: the encoder to use on returned digest
+    :type encoder: class
+    :returns: The hashed message.
+    :rtype: bytes
+    """
+
+    digest = _b2b_hash(data, digest_size=digest_size, key=key,
+                       salt=salt, person=person)
+    return encoder.encode(digest)
+
+
+generichash = blake2b
+
+
+def siphash24(message, key=b'', encoder=nacl.encoding.HexEncoder):
+    """
+    Computes a keyed MAC of ``message`` using the short-input-optimized
+    siphash-2-4 construction.
+
+    :param message: The message to hash.
+    :type message: bytes
+    :param key: the message authentication key for the siphash MAC construct
+    :type key: bytes(:const:`SIPHASH_KEYBYTES`)
+    :param encoder: A class that is able to encode the hashed message.
+    :returns: The hashed message.
+    :rtype: bytes(:const:`SIPHASH_BYTES`)
+    """
+    digest = _sip_hash(message, key)
+    return encoder.encode(digest)
+
+
+shorthash = siphash24
+
+
+def siphashx24(message, key=b'', encoder=nacl.encoding.HexEncoder):
+    """
+    Computes a keyed MAC of ``message`` using the 128 bit variant of the
+    siphash-2-4 construction.
+
+    :param message: The message to hash.
+    :type message: bytes
+    :param key: the message authentication key for the siphash MAC construct
+    :type key: bytes(:const:`SIPHASHX_KEYBYTES`)
+    :param encoder: A class that is able to encode the hashed message.
+    :returns: The hashed message.
+    :rtype: bytes(:const:`SIPHASHX_BYTES`)
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+
+    .. versionadded:: 1.2
+    """
+    digest = _sip_hashx(message, key)
+    return encoder.encode(digest)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hashlib.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hashlib.py
new file mode 100644
index 0000000000000000000000000000000000000000..6ee3aa30f0525d3012ce9770c39eb0f43383dc9b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/hashlib.py
@@ -0,0 +1,126 @@
+# Copyright 2016-2019 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import binascii
+
+import nacl.bindings
+from nacl.utils import bytes_as_string
+
+BYTES = nacl.bindings.crypto_generichash_BYTES
+BYTES_MIN = nacl.bindings.crypto_generichash_BYTES_MIN
+BYTES_MAX = nacl.bindings.crypto_generichash_BYTES_MAX
+KEYBYTES = nacl.bindings.crypto_generichash_KEYBYTES
+KEYBYTES_MIN = nacl.bindings.crypto_generichash_KEYBYTES_MIN
+KEYBYTES_MAX = nacl.bindings.crypto_generichash_KEYBYTES_MAX
+SALTBYTES = nacl.bindings.crypto_generichash_SALTBYTES
+PERSONALBYTES = nacl.bindings.crypto_generichash_PERSONALBYTES
+
+SCRYPT_AVAILABLE = nacl.bindings.has_crypto_pwhash_scryptsalsa208sha256
+
+_b2b_init = nacl.bindings.crypto_generichash_blake2b_init
+_b2b_final = nacl.bindings.crypto_generichash_blake2b_final
+_b2b_update = nacl.bindings.crypto_generichash_blake2b_update
+
+
+class blake2b(object):
+    """
+    :py:mod:`hashlib` API compatible blake2b algorithm implementation
+    """
+    MAX_DIGEST_SIZE = BYTES
+    MAX_KEY_SIZE = KEYBYTES_MAX
+    PERSON_SIZE = PERSONALBYTES
+    SALT_SIZE = SALTBYTES
+
+    def __init__(self, data=b'', digest_size=BYTES, key=b'',
+                 salt=b'', person=b''):
+        """
+        :py:class:`.blake2b` algorithm initializer
+
+        :param data:
+        :type data: bytes
+        :param int digest_size: the requested digest size; must be
+                                at most :py:attr:`.MAX_DIGEST_SIZE`;
+                                the default digest size is :py:data:`.BYTES`
+        :param key: the key to be set for keyed MAC/PRF usage; if set,
+                    the key must be at most :py:data:`.KEYBYTES_MAX` long
+        :type key: bytes
+        :param salt: a initialization salt at most
+                     :py:attr:`.SALT_SIZE` long; it will be zero-padded
+                     if needed
+        :type salt: bytes
+        :param person: a personalization string at most
+                       :py:attr:`.PERSONAL_SIZE` long; it will be zero-padded
+                       if needed
+        :type person: bytes
+        """
+
+        self._state = _b2b_init(key=key, salt=salt, person=person,
+                                digest_size=digest_size)
+        self._digest_size = digest_size
+
+        if data:
+            self.update(data)
+
+    @property
+    def digest_size(self):
+        return self._digest_size
+
+    @property
+    def block_size(self):
+        return 128
+
+    @property
+    def name(self):
+        return 'blake2b'
+
+    def update(self, data):
+        _b2b_update(self._state, data)
+
+    def digest(self):
+        _st = self._state.copy()
+        return _b2b_final(_st)
+
+    def hexdigest(self):
+        return bytes_as_string(binascii.hexlify(self.digest()))
+
+    def copy(self):
+        _cp = type(self)(digest_size=self.digest_size)
+        _st = self._state.copy()
+        _cp._state = _st
+        return _cp
+
+    def __reduce__(self):
+        """
+        Raise the same exception as hashlib's blake implementation
+        on copy.copy()
+        """
+        raise TypeError("can't pickle {} objects".format(
+            self.__class__.__name__))
+
+
+def scrypt(password, salt='', n=2**20, r=8, p=1,
+           maxmem=2**25, dklen=64):
+    """
+    Derive a cryptographic key using the scrypt KDF.
+
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+
+    Implements the same signature as the ``hashlib.scrypt`` implemented
+    in cpython version 3.6
+    """
+    return nacl.bindings.crypto_pwhash_scryptsalsa208sha256_ll(
+        password, salt, n, r, p, maxmem=maxmem, dklen=dklen)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/public.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/public.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa11b700e787fc89fba87b66be6a83f1bd33c434
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/public.py
@@ -0,0 +1,364 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import nacl.bindings
+from nacl import encoding
+from nacl import exceptions as exc
+from nacl.utils import EncryptedMessage, StringFixer, random
+
+
+class PublicKey(encoding.Encodable, StringFixer, object):
+    """
+    The public key counterpart to an Curve25519 :class:`nacl.public.PrivateKey`
+    for encrypting messages.
+
+    :param public_key: [:class:`bytes`] Encoded Curve25519 public key
+    :param encoder: A class that is able to decode the `public_key`
+
+    :cvar SIZE: The size that the public key is required to be
+    """
+
+    SIZE = nacl.bindings.crypto_box_PUBLICKEYBYTES
+
+    def __init__(self, public_key, encoder=encoding.RawEncoder):
+        self._public_key = encoder.decode(public_key)
+        if not isinstance(self._public_key, bytes):
+            raise exc.TypeError("PublicKey must be created from 32 bytes")
+
+        if len(self._public_key) != self.SIZE:
+            raise exc.ValueError(
+                "The public key must be exactly {0} bytes long".format(
+                    self.SIZE
+                )
+            )
+
+    def __bytes__(self):
+        return self._public_key
+
+    def __hash__(self):
+        return hash(bytes(self))
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        return nacl.bindings.sodium_memcmp(bytes(self), bytes(other))
+
+    def __ne__(self, other):
+        return not (self == other)
+
+
+class PrivateKey(encoding.Encodable, StringFixer, object):
+    """
+    Private key for decrypting messages using the Curve25519 algorithm.
+
+    .. warning:: This **must** be protected and remain secret. Anyone who
+        knows the value of your :class:`~nacl.public.PrivateKey` can decrypt
+        any message encrypted by the corresponding
+        :class:`~nacl.public.PublicKey`
+
+    :param private_key: The private key used to decrypt messages
+    :param encoder: The encoder class used to decode the given keys
+
+    :cvar SIZE: The size that the private key is required to be
+    :cvar SEED_SIZE: The size that the seed used to generate the
+                     private key is required to be
+    """
+
+    SIZE = nacl.bindings.crypto_box_SECRETKEYBYTES
+    SEED_SIZE = nacl.bindings.crypto_box_SEEDBYTES
+
+    def __init__(self, private_key, encoder=encoding.RawEncoder):
+        # Decode the secret_key
+        private_key = encoder.decode(private_key)
+        # verify the given secret key type and size are correct
+        if not (isinstance(private_key, bytes) and
+                len(private_key) == self.SIZE):
+            raise exc.TypeError(("PrivateKey must be created from a {0} "
+                                 "bytes long raw secret key").format(self.SIZE)
+                                )
+
+        raw_public_key = nacl.bindings.crypto_scalarmult_base(private_key)
+
+        self._private_key = private_key
+        self.public_key = PublicKey(raw_public_key)
+
+    @classmethod
+    def from_seed(cls, seed, encoder=encoding.RawEncoder):
+        """
+        Generate a PrivateKey using a deterministic construction
+        starting from a caller-provided seed
+
+        .. warning:: The seed **must** be high-entropy; therefore,
+            its generator **must** be a cryptographic quality
+            random function like, for example, :func:`~nacl.utils.random`.
+
+        .. warning:: The seed **must** be protected and remain secret.
+            Anyone who knows the seed is really in possession of
+            the corresponding PrivateKey.
+
+        :param seed: The seed used to generate the private key
+        :rtype: :class:`~nacl.public.PrivateKey`
+        """
+        # decode the seed
+        seed = encoder.decode(seed)
+        # Verify the given seed type and size are correct
+        if not (isinstance(seed, bytes) and len(seed) == cls.SEED_SIZE):
+            raise exc.TypeError(("PrivateKey seed must be a {0} bytes long "
+                                 "binary sequence").format(cls.SEED_SIZE)
+                                )
+        # generate a raw keypair from the given seed
+        raw_pk, raw_sk = nacl.bindings.crypto_box_seed_keypair(seed)
+        # construct a instance from the raw secret key
+        return cls(raw_sk)
+
+    def __bytes__(self):
+        return self._private_key
+
+    def __hash__(self):
+        return hash((type(self), bytes(self.public_key)))
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        return self.public_key == other.public_key
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    @classmethod
+    def generate(cls):
+        """
+        Generates a random :class:`~nacl.public.PrivateKey` object
+
+        :rtype: :class:`~nacl.public.PrivateKey`
+        """
+        return cls(random(PrivateKey.SIZE), encoder=encoding.RawEncoder)
+
+
+class Box(encoding.Encodable, StringFixer, object):
+    """
+    The Box class boxes and unboxes messages between a pair of keys
+
+    The ciphertexts generated by :class:`~nacl.public.Box` include a 16
+    byte authenticator which is checked as part of the decryption. An invalid
+    authenticator will cause the decrypt function to raise an exception. The
+    authenticator is not a signature. Once you've decrypted the message you've
+    demonstrated the ability to create arbitrary valid message, so messages you
+    send are repudiable. For non-repudiable messages, sign them after
+    encryption.
+
+    :param private_key: :class:`~nacl.public.PrivateKey` used to encrypt and
+        decrypt messages
+    :param public_key: :class:`~nacl.public.PublicKey` used to encrypt and
+        decrypt messages
+
+    :cvar NONCE_SIZE: The size that the nonce is required to be.
+    """
+
+    NONCE_SIZE = nacl.bindings.crypto_box_NONCEBYTES
+
+    def __init__(self, private_key, public_key):
+        if private_key and public_key:
+            if ((not isinstance(private_key, PrivateKey) or
+                 not isinstance(public_key, PublicKey))):
+                raise exc.TypeError("Box must be created from "
+                                    "a PrivateKey and a PublicKey")
+            self._shared_key = nacl.bindings.crypto_box_beforenm(
+                public_key.encode(encoder=encoding.RawEncoder),
+                private_key.encode(encoder=encoding.RawEncoder),
+            )
+        else:
+            self._shared_key = None
+
+    def __bytes__(self):
+        return self._shared_key
+
+    @classmethod
+    def decode(cls, encoded, encoder=encoding.RawEncoder):
+        # Create an empty box
+        box = cls(None, None)
+
+        # Assign our decoded value to the shared key of the box
+        box._shared_key = encoder.decode(encoded)
+
+        return box
+
+    def encrypt(self, plaintext, nonce=None, encoder=encoding.RawEncoder):
+        """
+        Encrypts the plaintext message using the given `nonce` (or generates
+        one randomly if omitted) and returns the ciphertext encoded with the
+        encoder.
+
+        .. warning:: It is **VITALLY** important that the nonce is a nonce,
+            i.e. it is a number used only once for any given key. If you fail
+            to do this, you compromise the privacy of the messages encrypted.
+
+        :param plaintext: [:class:`bytes`] The plaintext message to encrypt
+        :param nonce: [:class:`bytes`] The nonce to use in the encryption
+        :param encoder: The encoder to use to encode the ciphertext
+        :rtype: [:class:`nacl.utils.EncryptedMessage`]
+        """
+        if nonce is None:
+            nonce = random(self.NONCE_SIZE)
+
+        if len(nonce) != self.NONCE_SIZE:
+            raise exc.ValueError("The nonce must be exactly %s bytes long" %
+                                 self.NONCE_SIZE)
+
+        ciphertext = nacl.bindings.crypto_box_afternm(
+            plaintext,
+            nonce,
+            self._shared_key,
+        )
+
+        encoded_nonce = encoder.encode(nonce)
+        encoded_ciphertext = encoder.encode(ciphertext)
+
+        return EncryptedMessage._from_parts(
+            encoded_nonce,
+            encoded_ciphertext,
+            encoder.encode(nonce + ciphertext),
+        )
+
+    def decrypt(self, ciphertext, nonce=None, encoder=encoding.RawEncoder):
+        """
+        Decrypts the ciphertext using the `nonce` (explicitly, when passed as a
+        parameter or implicitly, when omitted, as part of the ciphertext) and
+        returns the plaintext message.
+
+        :param ciphertext: [:class:`bytes`] The encrypted message to decrypt
+        :param nonce: [:class:`bytes`] The nonce used when encrypting the
+            ciphertext
+        :param encoder: The encoder used to decode the ciphertext.
+        :rtype: [:class:`bytes`]
+        """
+        # Decode our ciphertext
+        ciphertext = encoder.decode(ciphertext)
+
+        if nonce is None:
+            # If we were given the nonce and ciphertext combined, split them.
+            nonce = ciphertext[:self.NONCE_SIZE]
+            ciphertext = ciphertext[self.NONCE_SIZE:]
+
+        if len(nonce) != self.NONCE_SIZE:
+            raise exc.ValueError("The nonce must be exactly %s bytes long" %
+                                 self.NONCE_SIZE)
+
+        plaintext = nacl.bindings.crypto_box_open_afternm(
+            ciphertext,
+            nonce,
+            self._shared_key,
+        )
+
+        return plaintext
+
+    def shared_key(self):
+        """
+        Returns the Curve25519 shared secret, that can then be used as a key in
+        other symmetric ciphers.
+
+        .. warning:: It is **VITALLY** important that you use a nonce with your
+            symmetric cipher. If you fail to do this, you compromise the
+            privacy of the messages encrypted. Ensure that the key length of
+            your cipher is 32 bytes.
+        :rtype: [:class:`bytes`]
+        """
+
+        return self._shared_key
+
+
+class SealedBox(encoding.Encodable, StringFixer, object):
+    """
+    The SealedBox class boxes and unboxes messages addressed to
+    a specified key-pair by using ephemeral sender's keypairs,
+    whose private part will be discarded just after encrypting
+    a single plaintext message.
+
+    The ciphertexts generated by :class:`~nacl.public.SecretBox` include
+    the public part of the ephemeral key before the :class:`~nacl.public.Box`
+    ciphertext.
+
+    :param public_key: :class:`~nacl.public.PublicKey` used to encrypt
+        messages and derive nonces
+    :param private_key: :class:`~nacl.public.PrivateKey` used to decrypt
+        messages
+
+    .. versionadded:: 1.2
+    """
+
+    def __init__(self, recipient_key):
+
+        if isinstance(recipient_key, PublicKey):
+            self._public_key = recipient_key.encode(
+                encoder=encoding.RawEncoder)
+            self._private_key = None
+        elif isinstance(recipient_key, PrivateKey):
+            self._private_key = recipient_key.encode(
+                encoder=encoding.RawEncoder)
+            self._public_key = recipient_key.public_key.encode(
+                encoder=encoding.RawEncoder)
+        else:
+            raise exc.TypeError("SealedBox must be created from "
+                                "a PublicKey or a PrivateKey")
+
+    def __bytes__(self):
+        return self._public_key
+
+    def encrypt(self, plaintext, encoder=encoding.RawEncoder):
+        """
+        Encrypts the plaintext message using a random-generated ephemeral
+        keypair and returns a "composed ciphertext", containing both
+        the public part of the keypair and the ciphertext proper,
+        encoded with the encoder.
+
+        The private part of the ephemeral key-pair will be scrubbed before
+        returning the ciphertext, therefore, the sender will not be able to
+        decrypt the generated ciphertext.
+
+        :param plaintext: [:class:`bytes`] The plaintext message to encrypt
+        :param encoder: The encoder to use to encode the ciphertext
+        :return bytes: encoded ciphertext
+        """
+
+        ciphertext = nacl.bindings.crypto_box_seal(
+            plaintext,
+            self._public_key
+        )
+
+        encoded_ciphertext = encoder.encode(ciphertext)
+
+        return encoded_ciphertext
+
+    def decrypt(self, ciphertext, encoder=encoding.RawEncoder):
+        """
+        Decrypts the ciphertext using the ephemeral public key enclosed
+        in the ciphertext and the SealedBox private key, returning
+        the plaintext message.
+
+        :param ciphertext: [:class:`bytes`] The encrypted message to decrypt
+        :param encoder: The encoder used to decode the ciphertext.
+        :return bytes: The original plaintext
+        """
+        # Decode our ciphertext
+        ciphertext = encoder.decode(ciphertext)
+
+        plaintext = nacl.bindings.crypto_box_seal_open(
+            ciphertext,
+            self._public_key,
+            self._private_key,
+        )
+
+        return plaintext
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ea4cd9157404c34a0cbd659a40541e2e2bfc6a5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/__init__.py
@@ -0,0 +1,75 @@
+# Copyright 2017 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import
+
+from nacl.exceptions import CryptPrefixError
+
+from . import _argon2, argon2i, argon2id, scrypt
+
+STRPREFIX = argon2id.STRPREFIX
+
+PWHASH_SIZE = argon2id.PWHASH_SIZE
+
+assert _argon2.ALG_ARGON2_DEFAULT == _argon2.ALG_ARGON2ID13
+# since version 1.0.15 of libsodium
+
+PASSWD_MIN = argon2id.PASSWD_MIN
+PASSWD_MAX = argon2id.PASSWD_MAX
+MEMLIMIT_MAX = argon2id.MEMLIMIT_MAX
+MEMLIMIT_MIN = argon2id.MEMLIMIT_MIN
+OPSLIMIT_MAX = argon2id.OPSLIMIT_MAX
+OPSLIMIT_MIN = argon2id.OPSLIMIT_MIN
+OPSLIMIT_INTERACTIVE = argon2id.OPSLIMIT_INTERACTIVE
+MEMLIMIT_INTERACTIVE = argon2id.MEMLIMIT_INTERACTIVE
+OPSLIMIT_MODERATE = argon2id.OPSLIMIT_MODERATE
+MEMLIMIT_MODERATE = argon2id.MEMLIMIT_MODERATE
+OPSLIMIT_SENSITIVE = argon2id.OPSLIMIT_SENSITIVE
+MEMLIMIT_SENSITIVE = argon2id.MEMLIMIT_SENSITIVE
+
+str = argon2id.str
+
+assert argon2i.ALG != argon2id.ALG
+
+SCRYPT_SALTBYTES = scrypt.SALTBYTES
+SCRYPT_PWHASH_SIZE = scrypt.PWHASH_SIZE
+SCRYPT_OPSLIMIT_INTERACTIVE = scrypt.OPSLIMIT_INTERACTIVE
+SCRYPT_MEMLIMIT_INTERACTIVE = scrypt.MEMLIMIT_INTERACTIVE
+SCRYPT_OPSLIMIT_SENSITIVE = scrypt.OPSLIMIT_SENSITIVE
+SCRYPT_MEMLIMIT_SENSITIVE = scrypt.MEMLIMIT_SENSITIVE
+
+
+kdf_scryptsalsa208sha256 = scrypt.kdf
+scryptsalsa208sha256_str = scrypt.str
+verify_scryptsalsa208sha256 = scrypt.verify
+
+
+def verify(password_hash, password):
+    """
+    Takes a modular crypt encoded stored password hash derived using one
+    of the algorithms supported by `libsodium` and checks if the user provided
+    password will hash to the same string when using the parameters saved
+    in the stored hash
+    """
+    if password_hash.startswith(argon2id.STRPREFIX):
+        return argon2id.verify(password_hash, password)
+    elif password_hash.startswith(argon2i.STRPREFIX):
+        return argon2id.verify(password_hash, password)
+    elif scrypt.AVAILABLE and password_hash.startswith(scrypt.STRPREFIX):
+        return scrypt.verify(password_hash, password)
+    else:
+        raise(CryptPrefixError("given password_hash is not "
+                               "in a supported format"
+                               )
+              )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/_argon2.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/_argon2.py
new file mode 100644
index 0000000000000000000000000000000000000000..2299daa80486ccdb2c4edee45162a59444ef022a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/_argon2.py
@@ -0,0 +1,52 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import
+from __future__ import division
+
+import nacl.bindings
+
+_argon2_strbytes_plus_one = nacl.bindings.crypto_pwhash_STRBYTES
+
+PWHASH_SIZE = _argon2_strbytes_plus_one - 1
+SALTBYTES = nacl.bindings.crypto_pwhash_SALTBYTES
+
+PASSWD_MIN = nacl.bindings.crypto_pwhash_PASSWD_MIN
+PASSWD_MAX = nacl.bindings.crypto_pwhash_PASSWD_MAX
+
+PWHASH_SIZE = _argon2_strbytes_plus_one - 1
+
+BYTES_MAX = nacl.bindings.crypto_pwhash_BYTES_MAX
+BYTES_MIN = nacl.bindings.crypto_pwhash_BYTES_MIN
+
+ALG_ARGON2I13 = nacl.bindings.crypto_pwhash_ALG_ARGON2I13
+ALG_ARGON2ID13 = nacl.bindings.crypto_pwhash_ALG_ARGON2ID13
+ALG_ARGON2_DEFAULT = nacl.bindings.crypto_pwhash_ALG_DEFAULT
+
+
+def verify(password_hash, password):
+    """
+    Takes a modular crypt encoded argon2i or argon2id stored password hash
+    and checks if the user provided password will hash to the same string
+    when using the stored parameters
+
+    :param password_hash: password hash serialized in modular crypt() format
+    :type password_hash: bytes
+    :param password: user provided password
+    :type password: bytes
+    :rtype: boolean
+
+    .. versionadded:: 1.2
+    """
+    return nacl.bindings.crypto_pwhash_str_verify(password_hash,
+                                                  password)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2i.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2i.py
new file mode 100644
index 0000000000000000000000000000000000000000..441b9f95b4600a29d9d318729c69e5098fe1ae3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2i.py
@@ -0,0 +1,135 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import
+from __future__ import division
+
+import nacl.bindings
+import nacl.encoding
+
+from . import _argon2
+
+ALG = _argon2.ALG_ARGON2I13
+STRPREFIX = nacl.bindings.crypto_pwhash_argon2i_STRPREFIX
+
+SALTBYTES = _argon2.SALTBYTES
+
+PASSWD_MIN = _argon2.PASSWD_MIN
+PASSWD_MAX = _argon2.PASSWD_MAX
+
+PWHASH_SIZE = _argon2.PWHASH_SIZE
+
+BYTES_MIN = _argon2.BYTES_MIN
+BYTES_MAX = _argon2.BYTES_MAX
+
+verify = _argon2.verify
+
+MEMLIMIT_MAX = nacl.bindings.crypto_pwhash_argon2i_MEMLIMIT_MAX
+MEMLIMIT_MIN = nacl.bindings.crypto_pwhash_argon2i_MEMLIMIT_MIN
+OPSLIMIT_MAX = nacl.bindings.crypto_pwhash_argon2i_OPSLIMIT_MAX
+OPSLIMIT_MIN = nacl.bindings.crypto_pwhash_argon2i_OPSLIMIT_MIN
+
+OPSLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_argon2i_OPSLIMIT_INTERACTIVE
+MEMLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_argon2i_MEMLIMIT_INTERACTIVE
+OPSLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_argon2i_OPSLIMIT_SENSITIVE
+MEMLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_argon2i_MEMLIMIT_SENSITIVE
+
+OPSLIMIT_MODERATE = \
+    nacl.bindings.crypto_pwhash_argon2i_OPSLIMIT_MODERATE
+MEMLIMIT_MODERATE = \
+    nacl.bindings.crypto_pwhash_argon2i_MEMLIMIT_MODERATE
+
+
+def kdf(size, password, salt,
+        opslimit=OPSLIMIT_SENSITIVE,
+        memlimit=MEMLIMIT_SENSITIVE,
+        encoder=nacl.encoding.RawEncoder):
+    """
+    Derive a ``size`` bytes long key from a caller-supplied
+    ``password`` and ``salt`` pair using the argon2i
+    memory-hard construct.
+
+    the enclosing module provides the constants
+
+        - :py:const:`.OPSLIMIT_INTERACTIVE`
+        - :py:const:`.MEMLIMIT_INTERACTIVE`
+        - :py:const:`.OPSLIMIT_MODERATE`
+        - :py:const:`.MEMLIMIT_MODERATE`
+        - :py:const:`.OPSLIMIT_SENSITIVE`
+        - :py:const:`.MEMLIMIT_SENSITIVE`
+
+    as a guidance for correct settings.
+
+    :param size: derived key size, must be between
+                 :py:const:`.BYTES_MIN` and
+                 :py:const:`.BYTES_MAX`
+    :type size: int
+    :param password: password used to seed the key derivation procedure;
+                     it length must be between
+                     :py:const:`.PASSWD_MIN` and
+                     :py:const:`.PASSWD_MAX`
+    :type password: bytes
+    :param salt: **RANDOM** salt used in the key derivation procedure;
+                 its length must be exactly :py:const:`.SALTBYTES`
+    :type salt: bytes
+    :param opslimit: the time component (operation count)
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.OPSLIMIT_MIN` and
+                     :py:const:`.OPSLIMIT_MAX`
+    :type opslimit: int
+    :param memlimit: the memory occupation component
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.MEMLIMIT_MIN` and
+                     :py:const:`.MEMLIMIT_MAX`
+    :type memlimit: int
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+
+    return encoder.encode(
+        nacl.bindings.crypto_pwhash_alg(size, password, salt,
+                                        opslimit, memlimit,
+                                        ALG)
+    )
+
+
+def str(password,
+        opslimit=OPSLIMIT_INTERACTIVE,
+        memlimit=MEMLIMIT_INTERACTIVE):
+    """
+    Hashes a password with a random salt, using the memory-hard
+    argon2i construct and returning an ascii string that has all
+    the needed info to check against a future password
+
+
+    The default settings for opslimit and memlimit are those deemed
+    correct for the interactive user login case.
+
+    :param bytes password:
+    :param int opslimit:
+    :param int memlimit:
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+    return nacl.bindings.crypto_pwhash_str_alg(password,
+                                               opslimit,
+                                               memlimit,
+                                               ALG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2id.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2id.py
new file mode 100644
index 0000000000000000000000000000000000000000..b9a2b4cf3584d9ac01b30a24fa4b949eede1c5e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/argon2id.py
@@ -0,0 +1,134 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import
+from __future__ import division
+
+import nacl.bindings
+import nacl.encoding
+
+from . import _argon2
+
+ALG = _argon2.ALG_ARGON2ID13
+STRPREFIX = nacl.bindings.crypto_pwhash_argon2id_STRPREFIX
+
+SALTBYTES = _argon2.SALTBYTES
+
+PASSWD_MIN = _argon2.PASSWD_MIN
+PASSWD_MAX = _argon2.PASSWD_MAX
+
+PWHASH_SIZE = _argon2.PWHASH_SIZE
+
+BYTES_MIN = _argon2.BYTES_MIN
+BYTES_MAX = _argon2.BYTES_MAX
+
+verify = _argon2.verify
+
+MEMLIMIT_MIN = nacl.bindings.crypto_pwhash_argon2id_MEMLIMIT_MIN
+MEMLIMIT_MAX = nacl.bindings.crypto_pwhash_argon2id_MEMLIMIT_MAX
+OPSLIMIT_MIN = nacl.bindings.crypto_pwhash_argon2id_OPSLIMIT_MIN
+OPSLIMIT_MAX = nacl.bindings.crypto_pwhash_argon2id_OPSLIMIT_MAX
+
+OPSLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_argon2id_OPSLIMIT_INTERACTIVE
+MEMLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_argon2id_MEMLIMIT_INTERACTIVE
+OPSLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_argon2id_OPSLIMIT_SENSITIVE
+MEMLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_argon2id_MEMLIMIT_SENSITIVE
+
+OPSLIMIT_MODERATE = \
+    nacl.bindings.crypto_pwhash_argon2id_OPSLIMIT_MODERATE
+MEMLIMIT_MODERATE = \
+    nacl.bindings.crypto_pwhash_argon2id_MEMLIMIT_MODERATE
+
+
+def kdf(size, password, salt,
+        opslimit=OPSLIMIT_SENSITIVE,
+        memlimit=MEMLIMIT_SENSITIVE,
+        encoder=nacl.encoding.RawEncoder):
+    """
+    Derive a ``size`` bytes long key from a caller-supplied
+    ``password`` and ``salt`` pair using the argon2i
+    memory-hard construct.
+
+    the enclosing module provides the constants
+
+        - :py:const:`.OPSLIMIT_INTERACTIVE`
+        - :py:const:`.MEMLIMIT_INTERACTIVE`
+        - :py:const:`.OPSLIMIT_MODERATE`
+        - :py:const:`.MEMLIMIT_MODERATE`
+        - :py:const:`.OPSLIMIT_SENSITIVE`
+        - :py:const:`.MEMLIMIT_SENSITIVE`
+
+    as a guidance for correct settings.
+
+    :param size: derived key size, must be between
+                 :py:const:`.BYTES_MIN` and
+                 :py:const:`.BYTES_MAX`
+    :type size: int
+    :param password: password used to seed the key derivation procedure;
+                     it length must be between
+                     :py:const:`.PASSWD_MIN` and
+                     :py:const:`.PASSWD_MAX`
+    :type password: bytes
+    :param salt: **RANDOM** salt used in the key derivation procedure;
+                 its length must be exactly :py:const:`.SALTBYTES`
+    :type salt: bytes
+    :param opslimit: the time component (operation count)
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.OPSLIMIT_MIN` and
+                     :py:const:`.OPSLIMIT_MAX`
+    :type opslimit: int
+    :param memlimit: the memory occupation component
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.MEMLIMIT_MIN` and
+                     :py:const:`.MEMLIMIT_MAX`
+    :type memlimit: int
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+
+    return encoder.encode(
+        nacl.bindings.crypto_pwhash_alg(size, password, salt,
+                                        opslimit, memlimit,
+                                        ALG)
+    )
+
+
+def str(password,
+        opslimit=OPSLIMIT_INTERACTIVE,
+        memlimit=MEMLIMIT_INTERACTIVE):
+    """
+    Hashes a password with a random salt, using the memory-hard
+    argon2id construct and returning an ascii string that has all
+    the needed info to check against a future password
+
+    The default settings for opslimit and memlimit are those deemed
+    correct for the interactive user login case.
+
+    :param bytes password:
+    :param int opslimit:
+    :param int memlimit:
+    :rtype: bytes
+
+    .. versionadded:: 1.2
+    """
+    return nacl.bindings.crypto_pwhash_str_alg(password,
+                                               opslimit,
+                                               memlimit,
+                                               ALG)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/scrypt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/scrypt.py
new file mode 100644
index 0000000000000000000000000000000000000000..13541e8af7ba215725e1dd75f0332141a1ddb330
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/pwhash/scrypt.py
@@ -0,0 +1,185 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from __future__ import absolute_import
+from __future__ import division
+
+import nacl.bindings
+import nacl.encoding
+from nacl import exceptions as exc
+from nacl.exceptions import ensure
+
+_strbytes_plus_one = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_STRBYTES
+
+AVAILABLE = nacl.bindings.has_crypto_pwhash_scryptsalsa208sha256
+
+STRPREFIX = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_STRPREFIX
+
+SALTBYTES = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_SALTBYTES
+
+PASSWD_MIN = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_PASSWD_MIN
+PASSWD_MAX = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_PASSWD_MAX
+
+PWHASH_SIZE = _strbytes_plus_one - 1
+
+BYTES_MIN = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_BYTES_MIN
+BYTES_MAX = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_BYTES_MAX
+
+MEMLIMIT_MIN = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MIN
+MEMLIMIT_MAX = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_MAX
+OPSLIMIT_MIN = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MIN
+OPSLIMIT_MAX = nacl.bindings.crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_MAX
+
+OPSLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_INTERACTIVE
+MEMLIMIT_INTERACTIVE = \
+    nacl.bindings.crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_INTERACTIVE
+OPSLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_scryptsalsa208sha256_OPSLIMIT_SENSITIVE
+MEMLIMIT_SENSITIVE = \
+    nacl.bindings.crypto_pwhash_scryptsalsa208sha256_MEMLIMIT_SENSITIVE
+
+OPSLIMIT_MODERATE = 8 * OPSLIMIT_INTERACTIVE
+MEMLIMIT_MODERATE = 8 * MEMLIMIT_INTERACTIVE
+
+
+def kdf(size, password, salt,
+        opslimit=OPSLIMIT_SENSITIVE,
+        memlimit=MEMLIMIT_SENSITIVE,
+        encoder=nacl.encoding.RawEncoder):
+    """
+    Derive a ``size`` bytes long key from a caller-supplied
+    ``password`` and ``salt`` pair using the scryptsalsa208sha256
+    memory-hard construct.
+
+
+    the enclosing module provides the constants
+
+        - :py:const:`.OPSLIMIT_INTERACTIVE`
+        - :py:const:`.MEMLIMIT_INTERACTIVE`
+        - :py:const:`.OPSLIMIT_SENSITIVE`
+        - :py:const:`.MEMLIMIT_SENSITIVE`
+        - :py:const:`.OPSLIMIT_MODERATE`
+        - :py:const:`.MEMLIMIT_MODERATE`
+
+    as a guidance for correct settings respectively for the
+    interactive login and the long term key protecting sensitive data
+    use cases.
+
+    :param size: derived key size, must be between
+                 :py:const:`.BYTES_MIN` and
+                 :py:const:`.BYTES_MAX`
+    :type size: int
+    :param password: password used to seed the key derivation procedure;
+                     it length must be between
+                     :py:const:`.PASSWD_MIN` and
+                     :py:const:`.PASSWD_MAX`
+    :type password: bytes
+    :param salt: **RANDOM** salt used in the key derivation procedure;
+                 its length must be exactly :py:const:`.SALTBYTES`
+    :type salt: bytes
+    :param opslimit: the time component (operation count)
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.OPSLIMIT_MIN` and
+                     :py:const:`.OPSLIMIT_MAX`
+    :type opslimit: int
+    :param memlimit: the memory occupation component
+                     of the key derivation procedure's computational cost;
+                     it must be between
+                     :py:const:`.MEMLIMIT_MIN` and
+                     :py:const:`.MEMLIMIT_MAX`
+    :type memlimit: int
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+
+    .. versionadded:: 1.2
+    """
+    ensure(AVAILABLE,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(
+        len(salt) == SALTBYTES,
+        "The salt must be exactly %s, not %s bytes long" % (
+            SALTBYTES,
+            len(salt)
+        ),
+        raising=exc.ValueError
+    )
+
+    n_log2, r, p = nacl.bindings.nacl_bindings_pick_scrypt_params(opslimit,
+                                                                  memlimit)
+    maxmem = memlimit + (2 ** 16)
+
+    return encoder.encode(
+        nacl.bindings.crypto_pwhash_scryptsalsa208sha256_ll(
+            password, salt, 2 ** n_log2, r, p, maxmem=maxmem, dklen=size)
+    )
+
+
+def str(password,
+        opslimit=OPSLIMIT_INTERACTIVE,
+        memlimit=MEMLIMIT_INTERACTIVE):
+    """
+    Hashes a password with a random salt, using the memory-hard
+    scryptsalsa208sha256 construct and returning an ascii string
+    that has all the needed info to check against a future password
+
+    The default settings for opslimit and memlimit are those deemed
+    correct for the interactive user login case.
+
+    :param bytes password:
+    :param int opslimit:
+    :param int memlimit:
+    :rtype: bytes
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+
+    .. versionadded:: 1.2
+    """
+    ensure(AVAILABLE,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    return nacl.bindings.crypto_pwhash_scryptsalsa208sha256_str(password,
+                                                                opslimit,
+                                                                memlimit)
+
+
+def verify(password_hash, password):
+    """
+    Takes the output of scryptsalsa208sha256 and compares it against
+    a user provided password to see if they are the same
+
+    :param password_hash: bytes
+    :param password: bytes
+    :rtype: boolean
+    :raises nacl.exceptions.UnavailableError: If called when using a
+        minimal build of libsodium.
+
+    .. versionadded:: 1.2
+    """
+    ensure(AVAILABLE,
+           'Not available in minimal build',
+           raising=exc.UnavailableError)
+
+    ensure(len(password_hash) == PWHASH_SIZE,
+           "The password hash must be exactly %s bytes long" %
+           nacl.bindings.crypto_pwhash_scryptsalsa208sha256_STRBYTES,
+           raising=exc.ValueError)
+
+    return nacl.bindings.crypto_pwhash_scryptsalsa208sha256_str_verify(
+        password_hash, password
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/secret.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/secret.py
new file mode 100644
index 0000000000000000000000000000000000000000..87772f59a6cd94ee4df074f6b09bc32da2e41f26
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/secret.py
@@ -0,0 +1,133 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import nacl.bindings
+from nacl import encoding
+from nacl import exceptions as exc
+from nacl.utils import EncryptedMessage, StringFixer, random
+
+
+class SecretBox(encoding.Encodable, StringFixer, object):
+    """
+    The SecretBox class encrypts and decrypts messages using the given secret
+    key.
+
+    The ciphertexts generated by :class:`~nacl.secret.Secretbox` include a 16
+    byte authenticator which is checked as part of the decryption. An invalid
+    authenticator will cause the decrypt function to raise an exception. The
+    authenticator is not a signature. Once you've decrypted the message you've
+    demonstrated the ability to create arbitrary valid message, so messages you
+    send are repudiable. For non-repudiable messages, sign them after
+    encryption.
+
+    :param key: The secret key used to encrypt and decrypt messages
+    :param encoder: The encoder class used to decode the given key
+
+    :cvar KEY_SIZE: The size that the key is required to be.
+    :cvar NONCE_SIZE: The size that the nonce is required to be.
+    :cvar MACBYTES: The size of the authentication MAC tag in bytes.
+    :cvar MESSAGEBYTES_MAX: The maximum size of a message which can be
+                            safely encrypted with a single key/nonce
+                            pair.
+    """
+
+    KEY_SIZE = nacl.bindings.crypto_secretbox_KEYBYTES
+    NONCE_SIZE = nacl.bindings.crypto_secretbox_NONCEBYTES
+    MACBYTES = nacl.bindings.crypto_secretbox_MACBYTES
+    MESSAGEBYTES_MAX = nacl.bindings.crypto_secretbox_MESSAGEBYTES_MAX
+
+    def __init__(self, key, encoder=encoding.RawEncoder):
+        key = encoder.decode(key)
+        if not isinstance(key, bytes):
+            raise exc.TypeError("SecretBox must be created from 32 bytes")
+
+        if len(key) != self.KEY_SIZE:
+            raise exc.ValueError(
+                "The key must be exactly %s bytes long" %
+                self.KEY_SIZE,
+            )
+
+        self._key = key
+
+    def __bytes__(self):
+        return self._key
+
+    def encrypt(self, plaintext, nonce=None, encoder=encoding.RawEncoder):
+        """
+        Encrypts the plaintext message using the given `nonce` (or generates
+        one randomly if omitted) and returns the ciphertext encoded with the
+        encoder.
+
+        .. warning:: It is **VITALLY** important that the nonce is a nonce,
+            i.e. it is a number used only once for any given key. If you fail
+            to do this, you compromise the privacy of the messages encrypted.
+            Give your nonces a different prefix, or have one side use an odd
+            counter and one an even counter. Just make sure they are different.
+
+        :param plaintext: [:class:`bytes`] The plaintext message to encrypt
+        :param nonce: [:class:`bytes`] The nonce to use in the encryption
+        :param encoder: The encoder to use to encode the ciphertext
+        :rtype: [:class:`nacl.utils.EncryptedMessage`]
+        """
+        if nonce is None:
+            nonce = random(self.NONCE_SIZE)
+
+        if len(nonce) != self.NONCE_SIZE:
+            raise exc.ValueError(
+                "The nonce must be exactly %s bytes long" % self.NONCE_SIZE,
+            )
+
+        ciphertext = nacl.bindings.crypto_secretbox(plaintext,
+                                                    nonce, self._key)
+
+        encoded_nonce = encoder.encode(nonce)
+        encoded_ciphertext = encoder.encode(ciphertext)
+
+        return EncryptedMessage._from_parts(
+            encoded_nonce,
+            encoded_ciphertext,
+            encoder.encode(nonce + ciphertext),
+        )
+
+    def decrypt(self, ciphertext, nonce=None, encoder=encoding.RawEncoder):
+        """
+        Decrypts the ciphertext using the `nonce` (explicitly, when passed as a
+        parameter or implicitly, when omitted, as part of the ciphertext) and
+        returns the plaintext message.
+
+        :param ciphertext: [:class:`bytes`] The encrypted message to decrypt
+        :param nonce: [:class:`bytes`] The nonce used when encrypting the
+            ciphertext
+        :param encoder: The encoder used to decode the ciphertext.
+        :rtype: [:class:`bytes`]
+        """
+        # Decode our ciphertext
+        ciphertext = encoder.decode(ciphertext)
+
+        if nonce is None:
+            # If we were given the nonce and ciphertext combined, split them.
+            nonce = ciphertext[:self.NONCE_SIZE]
+            ciphertext = ciphertext[self.NONCE_SIZE:]
+
+        if len(nonce) != self.NONCE_SIZE:
+            raise exc.ValueError(
+                "The nonce must be exactly %s bytes long" % self.NONCE_SIZE,
+            )
+
+        plaintext = nacl.bindings.crypto_secretbox_open(ciphertext,
+                                                        nonce, self._key)
+
+        return plaintext
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/signing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/signing.py
new file mode 100644
index 0000000000000000000000000000000000000000..497fd335226ee213f6defa6383fd99d16f468de7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/signing.py
@@ -0,0 +1,216 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import nacl.bindings
+from nacl import encoding
+from nacl import exceptions as exc
+from nacl.public import (PrivateKey as _Curve25519_PrivateKey,
+                         PublicKey as _Curve25519_PublicKey)
+from nacl.utils import StringFixer, random
+
+
+class SignedMessage(bytes):
+    """
+    A bytes subclass that holds a messaged that has been signed by a
+    :class:`SigningKey`.
+    """
+
+    @classmethod
+    def _from_parts(cls, signature, message, combined):
+        obj = cls(combined)
+        obj._signature = signature
+        obj._message = message
+        return obj
+
+    @property
+    def signature(self):
+        """
+        The signature contained within the :class:`SignedMessage`.
+        """
+        return self._signature
+
+    @property
+    def message(self):
+        """
+        The message contained within the :class:`SignedMessage`.
+        """
+        return self._message
+
+
+class VerifyKey(encoding.Encodable, StringFixer, object):
+    """
+    The public key counterpart to an Ed25519 SigningKey for producing digital
+    signatures.
+
+    :param key: [:class:`bytes`] Serialized Ed25519 public key
+    :param encoder: A class that is able to decode the `key`
+    """
+
+    def __init__(self, key, encoder=encoding.RawEncoder):
+        # Decode the key
+        key = encoder.decode(key)
+        if not isinstance(key, bytes):
+            raise exc.TypeError("VerifyKey must be created from 32 bytes")
+
+        if len(key) != nacl.bindings.crypto_sign_PUBLICKEYBYTES:
+            raise exc.ValueError(
+                "The key must be exactly %s bytes long" %
+                nacl.bindings.crypto_sign_PUBLICKEYBYTES,
+            )
+
+        self._key = key
+
+    def __bytes__(self):
+        return self._key
+
+    def __hash__(self):
+        return hash(bytes(self))
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        return nacl.bindings.sodium_memcmp(bytes(self), bytes(other))
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def verify(self, smessage, signature=None, encoder=encoding.RawEncoder):
+        """
+        Verifies the signature of a signed message, returning the message
+        if it has not been tampered with else raising
+        :class:`~nacl.signing.BadSignatureError`.
+
+        :param smessage: [:class:`bytes`] Either the original messaged or a
+            signature and message concated together.
+        :param signature: [:class:`bytes`] If an unsigned message is given for
+            smessage then the detached signature must be provided.
+        :param encoder: A class that is able to decode the secret message and
+            signature.
+        :rtype: :class:`bytes`
+        """
+        if signature is not None:
+            # If we were given the message and signature separately, combine
+            #   them.
+            smessage = signature + encoder.decode(smessage)
+        else:
+            # Decode the signed message
+            smessage = encoder.decode(smessage)
+
+        return nacl.bindings.crypto_sign_open(smessage, self._key)
+
+    def to_curve25519_public_key(self):
+        """
+        Converts a :class:`~nacl.signing.VerifyKey` to a
+        :class:`~nacl.public.PublicKey`
+
+        :rtype: :class:`~nacl.public.PublicKey`
+        """
+        raw_pk = nacl.bindings.crypto_sign_ed25519_pk_to_curve25519(self._key)
+        return _Curve25519_PublicKey(raw_pk)
+
+
+class SigningKey(encoding.Encodable, StringFixer, object):
+    """
+    Private key for producing digital signatures using the Ed25519 algorithm.
+
+    Signing keys are produced from a 32-byte (256-bit) random seed value. This
+    value can be passed into the :class:`~nacl.signing.SigningKey` as a
+    :func:`bytes` whose length is 32.
+
+    .. warning:: This **must** be protected and remain secret. Anyone who knows
+        the value of your :class:`~nacl.signing.SigningKey` or it's seed can
+        masquerade as you.
+
+    :param seed: [:class:`bytes`] Random 32-byte value (i.e. private key)
+    :param encoder: A class that is able to decode the seed
+
+    :ivar: verify_key: [:class:`~nacl.signing.VerifyKey`] The verify
+        (i.e. public) key that corresponds with this signing key.
+    """
+
+    def __init__(self, seed, encoder=encoding.RawEncoder):
+        # Decode the seed
+        seed = encoder.decode(seed)
+        if not isinstance(seed, bytes):
+            raise exc.TypeError(
+                "SigningKey must be created from a 32 byte seed")
+
+        # Verify that our seed is the proper size
+        if len(seed) != nacl.bindings.crypto_sign_SEEDBYTES:
+            raise exc.ValueError(
+                "The seed must be exactly %d bytes long" %
+                nacl.bindings.crypto_sign_SEEDBYTES
+            )
+
+        public_key, secret_key = nacl.bindings.crypto_sign_seed_keypair(seed)
+
+        self._seed = seed
+        self._signing_key = secret_key
+        self.verify_key = VerifyKey(public_key)
+
+    def __bytes__(self):
+        return self._seed
+
+    def __hash__(self):
+        return hash(bytes(self))
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            return False
+        return nacl.bindings.sodium_memcmp(bytes(self), bytes(other))
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    @classmethod
+    def generate(cls):
+        """
+        Generates a random :class:`~nacl.signing.SigningKey` object.
+
+        :rtype: :class:`~nacl.signing.SigningKey`
+        """
+        return cls(
+            random(nacl.bindings.crypto_sign_SEEDBYTES),
+            encoder=encoding.RawEncoder,
+        )
+
+    def sign(self, message, encoder=encoding.RawEncoder):
+        """
+        Sign a message using this key.
+
+        :param message: [:class:`bytes`] The data to be signed.
+        :param encoder: A class that is used to encode the signed message.
+        :rtype: :class:`~nacl.signing.SignedMessage`
+        """
+        raw_signed = nacl.bindings.crypto_sign(message, self._signing_key)
+
+        crypto_sign_BYTES = nacl.bindings.crypto_sign_BYTES
+        signature = encoder.encode(raw_signed[:crypto_sign_BYTES])
+        message = encoder.encode(raw_signed[crypto_sign_BYTES:])
+        signed = encoder.encode(raw_signed)
+
+        return SignedMessage._from_parts(signature, message, signed)
+
+    def to_curve25519_private_key(self):
+        """
+        Converts a :class:`~nacl.signing.SigningKey` to a
+        :class:`~nacl.public.PrivateKey`
+
+        :rtype: :class:`~nacl.public.PrivateKey`
+        """
+        sk = self._signing_key
+        raw_private = nacl.bindings.crypto_sign_ed25519_sk_to_curve25519(sk)
+        return _Curve25519_PrivateKey(raw_private)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..23d62ff3d5a46d77a5bda6a4b58d4d1a137f22a8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/nacl/utils.py
@@ -0,0 +1,85 @@
+# Copyright 2013 Donald Stufft and individual contributors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import absolute_import, division, print_function
+
+import os
+
+import six
+
+import nacl.bindings
+from nacl import encoding
+
+
+class EncryptedMessage(bytes):
+    """
+    A bytes subclass that holds a messaged that has been encrypted by a
+    :class:`SecretBox`.
+    """
+
+    @classmethod
+    def _from_parts(cls, nonce, ciphertext, combined):
+        obj = cls(combined)
+        obj._nonce = nonce
+        obj._ciphertext = ciphertext
+        return obj
+
+    @property
+    def nonce(self):
+        """
+        The nonce used during the encryption of the :class:`EncryptedMessage`.
+        """
+        return self._nonce
+
+    @property
+    def ciphertext(self):
+        """
+        The ciphertext contained within the :class:`EncryptedMessage`.
+        """
+        return self._ciphertext
+
+
+class StringFixer(object):
+
+    def __str__(self):
+        if six.PY3:
+            return str(self.__bytes__())
+        else:
+            return self.__bytes__()
+
+
+def bytes_as_string(bytes_in):
+    if six.PY3:
+        return bytes_in.decode('ascii')
+    else:
+        return bytes_in
+
+
+def random(size=32):
+    return os.urandom(size)
+
+
+def randombytes_deterministic(size, seed, encoder=encoding.RawEncoder):
+    """
+    Returns ``size`` number of deterministically generated pseudorandom bytes
+    from a seed
+
+    :param size: int
+    :param seed: bytes
+    :param encoder: The encoder class used to encode the produced bytes
+    :rtype: bytes
+    """
+    raw_data = nacl.bindings.randombytes_buf_deterministic(size, seed)
+
+    return encoder.encode(raw_data)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..ed72f8361a9a6564a6414987dd54b879420064ad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/METADATA
@@ -0,0 +1,362 @@
+Metadata-Version: 2.1
+Name: packaging
+Version: 20.3
+Summary: Core utilities for Python packages
+Home-page: https://github.com/pypa/packaging
+Author: Donald Stufft and individual contributors
+Author-email: donald@stufft.io
+License: BSD or Apache License, Version 2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Description-Content-Type: text/x-rst
+
+packaging
+=========
+
+Core utilities for Python packages.
+
+The ``packaging`` project includes the following: version handling, specifiers,
+markers, requirements, tags, utilities.
+
+Documentation
+-------------
+
+The `documentation`_ provides information and the API for the following:
+
+- Version Handling
+- Specifiers
+- Markers
+- Requirements
+- Tags
+- Utilities
+
+Installation
+------------
+
+Use ``pip`` to install these utilities::
+
+    pip install packaging
+
+Discussion
+----------
+
+If you run into bugs, you can file them in our `issue tracker`_.
+
+You can also join ``#pypa`` on Freenode to ask questions or get involved.
+
+
+.. _`documentation`: https://packaging.pypa.io/
+.. _`issue tracker`: https://github.com/pypa/packaging/issues
+
+
+Code of Conduct
+---------------
+
+Everyone interacting in the packaging project's codebases, issue trackers, chat
+rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
+
+.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
+
+Contributing
+------------
+
+The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as
+well as how to report a potential security issue. The documentation for this
+project also covers information about `project development`_ and `security`_.
+
+.. _`project development`: https://packaging.pypa.io/en/latest/development/
+.. _`security`: https://packaging.pypa.io/en/latest/security/
+
+Project History
+---------------
+
+Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for
+recent changes and project history.
+
+.. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/
+
+Changelog
+---------
+
+20.3 - 2020-03-05
+~~~~~~~~~~~~~~~~~
+
+* Fix changelog for 20.2.
+
+20.2 - 2020-03-05
+~~~~~~~~~~~~~~~~~
+
+* Fix a bug that caused a 32-bit OS that runs on a 64-bit ARM CPU (e.g. ARM-v8,
+  aarch64), to report the wrong bitness.
+
+20.1 - 2020-01-24
+~~~~~~~~~~~~~~~~~~~
+
+* Fix a bug caused by reuse of an exhausted iterator. (`#257 <https://github.com/pypa/packaging/issues/257>`__)
+
+20.0 - 2020-01-06
+~~~~~~~~~~~~~~~~~
+
+* Add type hints (`#191 <https://github.com/pypa/packaging/issues/191>`__)
+
+* Add proper trove classifiers for PyPy support (`#198 <https://github.com/pypa/packaging/issues/198>`__)
+
+* Scale back depending on ``ctypes`` for manylinux support detection (`#171 <https://github.com/pypa/packaging/issues/171>`__)
+
+* Use ``sys.implementation.name`` where appropriate for ``packaging.tags`` (`#193 <https://github.com/pypa/packaging/issues/193>`__)
+
+* Expand upon the API provded by ``packaging.tags``: ``interpreter_name()``, ``mac_platforms()``, ``compatible_tags()``, ``cpython_tags()``, ``generic_tags()`` (`#187 <https://github.com/pypa/packaging/issues/187>`__)
+
+* Officially support Python 3.8 (`#232 <https://github.com/pypa/packaging/issues/232>`__)
+
+* Add ``major``, ``minor``, and ``micro`` aliases to ``packaging.version.Version`` (`#226 <https://github.com/pypa/packaging/issues/226>`__)
+
+* Properly mark ``packaging`` has being fully typed by adding a `py.typed` file (`#226 <https://github.com/pypa/packaging/issues/226>`__)
+
+19.2 - 2019-09-18
+~~~~~~~~~~~~~~~~~
+
+* Remove dependency on ``attrs`` (`#178 <https://github.com/pypa/packaging/issues/178>`__, `#179 <https://github.com/pypa/packaging/issues/179>`__)
+
+* Use appropriate fallbacks for CPython ABI tag (`#181 <https://github.com/pypa/packaging/issues/181>`__, `#185 <https://github.com/pypa/packaging/issues/185>`__)
+
+* Add manylinux2014 support (`#186 <https://github.com/pypa/packaging/issues/186>`__)
+
+* Improve ABI detection (`#181 <https://github.com/pypa/packaging/issues/181>`__)
+
+* Properly handle debug wheels for Python 3.8 (`#172 <https://github.com/pypa/packaging/issues/172>`__)
+
+* Improve detection of debug builds on Windows (`#194 <https://github.com/pypa/packaging/issues/194>`__)
+
+19.1 - 2019-07-30
+~~~~~~~~~~~~~~~~~
+
+* Add the ``packaging.tags`` module. (`#156 <https://github.com/pypa/packaging/issues/156>`__)
+
+* Correctly handle two-digit versions in ``python_version`` (`#119 <https://github.com/pypa/packaging/issues/119>`__)
+
+
+19.0 - 2019-01-20
+~~~~~~~~~~~~~~~~~
+
+* Fix string representation of PEP 508 direct URL requirements with markers.
+
+* Better handling of file URLs
+
+  This allows for using ``file:///absolute/path``, which was previously
+  prevented due to the missing ``netloc``.
+
+  This allows for all file URLs that ``urlunparse`` turns back into the
+  original URL to be valid.
+
+
+18.0 - 2018-09-26
+~~~~~~~~~~~~~~~~~
+
+* Improve error messages when invalid requirements are given. (`#129 <https://github.com/pypa/packaging/issues/129>`__)
+
+
+17.1 - 2017-02-28
+~~~~~~~~~~~~~~~~~
+
+* Fix ``utils.canonicalize_version`` when supplying non PEP 440 versions.
+
+
+17.0 - 2017-02-28
+~~~~~~~~~~~~~~~~~
+
+* Drop support for python 2.6, 3.2, and 3.3.
+
+* Define minimal pyparsing version to 2.0.2 (`#91 <https://github.com/pypa/packaging/issues/91>`__).
+
+* Add ``epoch``, ``release``, ``pre``, ``dev``, and ``post`` attributes to
+  ``Version`` and ``LegacyVersion`` (`#34 <https://github.com/pypa/packaging/issues/34>`__).
+
+* Add ``Version().is_devrelease`` and ``LegacyVersion().is_devrelease`` to
+  make it easy to determine if a release is a development release.
+
+* Add ``utils.canonicalize_version`` to canonicalize version strings or
+  ``Version`` instances (`#121 <https://github.com/pypa/packaging/issues/121>`__).
+
+
+16.8 - 2016-10-29
+~~~~~~~~~~~~~~~~~
+
+* Fix markers that utilize ``in`` so that they render correctly.
+
+* Fix an erroneous test on Python RC releases.
+
+
+16.7 - 2016-04-23
+~~~~~~~~~~~~~~~~~
+
+* Add support for the deprecated ``python_implementation`` marker which was
+  an undocumented setuptools marker in addition to the newer markers.
+
+
+16.6 - 2016-03-29
+~~~~~~~~~~~~~~~~~
+
+* Add support for the deprecated, PEP 345 environment markers in addition to
+  the newer markers.
+
+
+16.5 - 2016-02-26
+~~~~~~~~~~~~~~~~~
+
+* Fix a regression in parsing requirements with whitespaces between the comma
+  separators.
+
+
+16.4 - 2016-02-22
+~~~~~~~~~~~~~~~~~
+
+* Fix a regression in parsing requirements like ``foo (==4)``.
+
+
+16.3 - 2016-02-21
+~~~~~~~~~~~~~~~~~
+
+* Fix a bug where ``packaging.requirements:Requirement`` was overly strict when
+  matching legacy requirements.
+
+
+16.2 - 2016-02-09
+~~~~~~~~~~~~~~~~~
+
+* Add a function that implements the name canonicalization from PEP 503.
+
+
+16.1 - 2016-02-07
+~~~~~~~~~~~~~~~~~
+
+* Implement requirement specifiers from PEP 508.
+
+
+16.0 - 2016-01-19
+~~~~~~~~~~~~~~~~~
+
+* Relicense so that packaging is available under *either* the Apache License,
+  Version 2.0 or a 2 Clause BSD license.
+
+* Support installation of packaging when only distutils is available.
+
+* Fix ``==`` comparison when there is a prefix and a local version in play.
+  (`#41 <https://github.com/pypa/packaging/issues/41>`__).
+
+* Implement environment markers from PEP 508.
+
+
+15.3 - 2015-08-01
+~~~~~~~~~~~~~~~~~
+
+* Normalize post-release spellings for rev/r prefixes. `#35 <https://github.com/pypa/packaging/issues/35>`__
+
+
+15.2 - 2015-05-13
+~~~~~~~~~~~~~~~~~
+
+* Fix an error where the arbitary specifier (``===``) was not correctly
+  allowing pre-releases when it was being used.
+
+* Expose the specifier and version parts through properties on the
+  ``Specifier`` classes.
+
+* Allow iterating over the ``SpecifierSet`` to get access to all of the
+  ``Specifier`` instances.
+
+* Allow testing if a version is contained within a specifier via the ``in``
+  operator.
+
+
+15.1 - 2015-04-13
+~~~~~~~~~~~~~~~~~
+
+* Fix a logic error that was causing inconsistent answers about whether or not
+  a pre-release was contained within a ``SpecifierSet`` or not.
+
+
+15.0 - 2015-01-02
+~~~~~~~~~~~~~~~~~
+
+* Add ``Version().is_postrelease`` and ``LegacyVersion().is_postrelease`` to
+  make it easy to determine if a release is a post release.
+
+* Add ``Version().base_version`` and ``LegacyVersion().base_version`` to make
+  it easy to get the public version without any pre or post release markers.
+
+* Support the update to PEP 440 which removed the implied ``!=V.*`` when using
+  either ``>V`` or ``<V`` and which instead special cased the handling of
+  pre-releases, post-releases, and local versions when using ``>V`` or ``<V``.
+
+
+14.5 - 2014-12-17
+~~~~~~~~~~~~~~~~~
+
+* Normalize release candidates as ``rc`` instead of ``c``.
+
+* Expose the ``VERSION_PATTERN`` constant, a regular expression matching
+  a valid version.
+
+
+14.4 - 2014-12-15
+~~~~~~~~~~~~~~~~~
+
+* Ensure that versions are normalized before comparison when used in a
+  specifier with a less than (``<``) or greater than (``>``) operator.
+
+
+14.3 - 2014-11-19
+~~~~~~~~~~~~~~~~~
+
+* **BACKWARDS INCOMPATIBLE** Refactor specifier support so that it can sanely
+  handle legacy specifiers as well as PEP 440 specifiers.
+
+* **BACKWARDS INCOMPATIBLE** Move the specifier support out of
+  ``packaging.version`` into ``packaging.specifiers``.
+
+
+14.2 - 2014-09-10
+~~~~~~~~~~~~~~~~~
+
+* Add prerelease support to ``Specifier``.
+* Remove the ability to do ``item in Specifier()`` and replace it with
+  ``Specifier().contains(item)`` in order to allow flags that signal if a
+  prerelease should be accepted or not.
+* Add a method ``Specifier().filter()`` which will take an iterable and returns
+  an iterable with items that do not match the specifier filtered out.
+
+
+14.1 - 2014-09-08
+~~~~~~~~~~~~~~~~~
+
+* Allow ``LegacyVersion`` and ``Version`` to be sorted together.
+* Add ``packaging.version.parse()`` to enable easily parsing a version string
+  as either a ``Version`` or a ``LegacyVersion`` depending on it's PEP 440
+  validity.
+
+
+14.0 - 2014-09-05
+~~~~~~~~~~~~~~~~~
+
+* Initial release.
+
+
+.. _`master`: https://github.com/pypa/packaging/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..177a520f47bf3c5d1fcca639ec5dbd335f348aa8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/RECORD
@@ -0,0 +1,33 @@
+packaging/__about__.py,sha256=y-K51xPSysxvOfTjAb074yqOZfDeX5qSID0ZEbEb9cE,744
+packaging/__init__.py,sha256=6enbp5XgRfjBjsI9-bn00HjHf5TH21PDMOKkJW8xw-w,562
+packaging/_compat.py,sha256=Z-PwchK0cREbaRGF5MZP8LEv8JkC-qydn2FRrtjeixk,1138
+packaging/_structures.py,sha256=ozkCX8Q8f2qE1Eic3YiQ4buDVfgz2iYevY9e7R2y3iY,2022
+packaging/_typing.py,sha256=bmvfRSqh5zzL6KjhW57nQIqG6YGJZk6XXZovGG4U4J4,1437
+packaging/markers.py,sha256=CkMzNWbaDNPxMsWK-JtwBkDFmBfp5gmfxtWN16yZgB8,9465
+packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+packaging/requirements.py,sha256=9ZvGd-VcgPPoewo821s7UmtmlBMRX3v4irHJDhOESBw,4865
+packaging/specifiers.py,sha256=Nz8bnFp53cQInmRGZy50QXlIi2tkDXMfRuGyGps2IRE,31314
+packaging/tags.py,sha256=SCrw-jC3h0ymam6QXDX5ZqgvRcMNq_cQD55gFnT56Xg,23704
+packaging/utils.py,sha256=v5Wk8B7gUL13Rzed6NNhCZlutPQT7jNV-7hr-WOtacU,1700
+packaging/version.py,sha256=qRdNN0_XuPFOJ3fut8ehzxJrNYtBzqF8ZtagEvgNUUM,15480
+packaging-20.3.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+packaging-20.3.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+packaging-20.3.dist-info/METADATA,sha256=mtw74vHJ3mDe6fbm9j_2rPlNb6rci2tJnyhVi5WRmvE,10809
+packaging-20.3.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+packaging-20.3.dist-info/top_level.txt,sha256=zFdHrhWnPslzsiP455HutQsqPB6v0KCtNUMtUtrefDw,10
+packaging-20.3.dist-info/RECORD,,
+packaging/_structures.cpython-38.pyc,,
+packaging/utils.cpython-38.pyc,,
+packaging/markers.cpython-38.pyc,,
+packaging/_typing.cpython-38.pyc,,
+packaging/_compat.cpython-38.pyc,,
+packaging/__pycache__,,
+packaging/version.cpython-38.pyc,,
+packaging-20.3.dist-info/INSTALLER,,
+packaging-20.3.virtualenv,,
+packaging/__init__.cpython-38.pyc,,
+packaging/tags.cpython-38.pyc,,
+packaging/requirements.cpython-38.pyc,,
+packaging/__about__.cpython-38.pyc,,
+packaging/specifiers.cpython-38.pyc,,
+packaging-20.3.dist-info/__pycache__,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..748809f75c471b0336136cdfe160463a52952339
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+packaging
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging-20.3.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__about__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__about__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5161d141be74b128228263c01b4c7d98de4c27e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__about__.py
@@ -0,0 +1,27 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+__all__ = [
+    "__title__",
+    "__summary__",
+    "__uri__",
+    "__version__",
+    "__author__",
+    "__email__",
+    "__license__",
+    "__copyright__",
+]
+
+__title__ = "packaging"
+__summary__ = "Core utilities for Python packages"
+__uri__ = "https://github.com/pypa/packaging"
+
+__version__ = "20.3"
+
+__author__ = "Donald Stufft and individual contributors"
+__email__ = "donald@stufft.io"
+
+__license__ = "BSD or Apache License, Version 2.0"
+__copyright__ = "Copyright 2014-2019 %s" % __author__
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0cf67df5245be16a020ca048832e180f7ce8661
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/__init__.py
@@ -0,0 +1,26 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+from .__about__ import (
+    __author__,
+    __copyright__,
+    __email__,
+    __license__,
+    __summary__,
+    __title__,
+    __uri__,
+    __version__,
+)
+
+__all__ = [
+    "__title__",
+    "__summary__",
+    "__uri__",
+    "__version__",
+    "__author__",
+    "__email__",
+    "__license__",
+    "__copyright__",
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..a145f7eeb3972375d152026255fb1256d81bb024
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_compat.py
@@ -0,0 +1,38 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+from ._typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import Any, Dict, Tuple, Type
+
+
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+
+# flake8: noqa
+
+if PY3:
+    string_types = (str,)
+else:
+    string_types = (basestring,)
+
+
+def with_metaclass(meta, *bases):
+    # type: (Type[Any], Tuple[Type[Any], ...]) -> Any
+    """
+    Create a base class with a metaclass.
+    """
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(meta):  # type: ignore
+        def __new__(cls, name, this_bases, d):
+            # type: (Type[Any], str, Tuple[Any], Dict[Any, Any]) -> Any
+            return meta(name, bases, d)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_structures.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_structures.py
new file mode 100644
index 0000000000000000000000000000000000000000..800d5c5588c99dc216cdea5084da440efb641945
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_structures.py
@@ -0,0 +1,86 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+
+class InfinityType(object):
+    def __repr__(self):
+        # type: () -> str
+        return "Infinity"
+
+    def __hash__(self):
+        # type: () -> int
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        # type: (object) -> bool
+        return False
+
+    def __le__(self, other):
+        # type: (object) -> bool
+        return False
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        # type: (object) -> bool
+        return True
+
+    def __ge__(self, other):
+        # type: (object) -> bool
+        return True
+
+    def __neg__(self):
+        # type: (object) -> NegativeInfinityType
+        return NegativeInfinity
+
+
+Infinity = InfinityType()
+
+
+class NegativeInfinityType(object):
+    def __repr__(self):
+        # type: () -> str
+        return "-Infinity"
+
+    def __hash__(self):
+        # type: () -> int
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        # type: (object) -> bool
+        return True
+
+    def __le__(self, other):
+        # type: (object) -> bool
+        return True
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        # type: (object) -> bool
+        return False
+
+    def __ge__(self, other):
+        # type: (object) -> bool
+        return False
+
+    def __neg__(self):
+        # type: (object) -> InfinityType
+        return Infinity
+
+
+NegativeInfinity = NegativeInfinityType()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_typing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_typing.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc6dfce7ad17810882d1edb9712a249b5d1a765f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/_typing.py
@@ -0,0 +1,39 @@
+"""For neatly implementing static typing in packaging.
+
+`mypy` - the static type analysis tool we use - uses the `typing` module, which
+provides core functionality fundamental to mypy's functioning.
+
+Generally, `typing` would be imported at runtime and used in that fashion -
+it acts as a no-op at runtime and does not have any run-time overhead by
+design.
+
+As it turns out, `typing` is not vendorable - it uses separate sources for
+Python 2/Python 3. Thus, this codebase can not expect it to be present.
+To work around this, mypy allows the typing import to be behind a False-y
+optional to prevent it from running at runtime and type-comments can be used
+to remove the need for the types to be accessible directly during runtime.
+
+This module provides the False-y guard in a nicely named fashion so that a
+curious maintainer can reach here to read this.
+
+In packaging, all static-typing related imports should be guarded as follows:
+
+    from packaging._typing import MYPY_CHECK_RUNNING
+
+    if MYPY_CHECK_RUNNING:
+        from typing import ...
+
+Ref: https://github.com/python/mypy/issues/3216
+"""
+
+MYPY_CHECK_RUNNING = False
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    import typing
+
+    cast = typing.cast
+else:
+    # typing's cast() is needed at runtime, but we don't want to import typing.
+    # Thus, we use a dummy no-op version, which we tell mypy to ignore.
+    def cast(type_, value):  # type: ignore
+        return value
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/markers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/markers.py
new file mode 100644
index 0000000000000000000000000000000000000000..f017471139bf08adbeac1a65d2488ac8be971889
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/markers.py
@@ -0,0 +1,328 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import operator
+import os
+import platform
+import sys
+
+from pyparsing import ParseException, ParseResults, stringStart, stringEnd
+from pyparsing import ZeroOrMore, Group, Forward, QuotedString
+from pyparsing import Literal as L  # noqa
+
+from ._compat import string_types
+from ._typing import MYPY_CHECK_RUNNING
+from .specifiers import Specifier, InvalidSpecifier
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import Any, Callable, Dict, List, Optional, Tuple, Union
+
+    Operator = Callable[[str, str], bool]
+
+
+__all__ = [
+    "InvalidMarker",
+    "UndefinedComparison",
+    "UndefinedEnvironmentName",
+    "Marker",
+    "default_environment",
+]
+
+
+class InvalidMarker(ValueError):
+    """
+    An invalid marker was found, users should refer to PEP 508.
+    """
+
+
+class UndefinedComparison(ValueError):
+    """
+    An invalid operation was attempted on a value that doesn't support it.
+    """
+
+
+class UndefinedEnvironmentName(ValueError):
+    """
+    A name was attempted to be used that does not exist inside of the
+    environment.
+    """
+
+
+class Node(object):
+    def __init__(self, value):
+        # type: (Any) -> None
+        self.value = value
+
+    def __str__(self):
+        # type: () -> str
+        return str(self.value)
+
+    def __repr__(self):
+        # type: () -> str
+        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))
+
+    def serialize(self):
+        # type: () -> str
+        raise NotImplementedError
+
+
+class Variable(Node):
+    def serialize(self):
+        # type: () -> str
+        return str(self)
+
+
+class Value(Node):
+    def serialize(self):
+        # type: () -> str
+        return '"{0}"'.format(self)
+
+
+class Op(Node):
+    def serialize(self):
+        # type: () -> str
+        return str(self)
+
+
+VARIABLE = (
+    L("implementation_version")
+    | L("platform_python_implementation")
+    | L("implementation_name")
+    | L("python_full_version")
+    | L("platform_release")
+    | L("platform_version")
+    | L("platform_machine")
+    | L("platform_system")
+    | L("python_version")
+    | L("sys_platform")
+    | L("os_name")
+    | L("os.name")  # PEP-345
+    | L("sys.platform")  # PEP-345
+    | L("platform.version")  # PEP-345
+    | L("platform.machine")  # PEP-345
+    | L("platform.python_implementation")  # PEP-345
+    | L("python_implementation")  # undocumented setuptools legacy
+    | L("extra")  # PEP-508
+)
+ALIASES = {
+    "os.name": "os_name",
+    "sys.platform": "sys_platform",
+    "platform.version": "platform_version",
+    "platform.machine": "platform_machine",
+    "platform.python_implementation": "platform_python_implementation",
+    "python_implementation": "platform_python_implementation",
+}
+VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))
+
+VERSION_CMP = (
+    L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<")
+)
+
+MARKER_OP = VERSION_CMP | L("not in") | L("in")
+MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))
+
+MARKER_VALUE = QuotedString("'") | QuotedString('"')
+MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))
+
+BOOLOP = L("and") | L("or")
+
+MARKER_VAR = VARIABLE | MARKER_VALUE
+
+MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
+MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))
+
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+
+MARKER_EXPR = Forward()
+MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
+MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)
+
+MARKER = stringStart + MARKER_EXPR + stringEnd
+
+
+def _coerce_parse_result(results):
+    # type: (Union[ParseResults, List[Any]]) -> List[Any]
+    if isinstance(results, ParseResults):
+        return [_coerce_parse_result(i) for i in results]
+    else:
+        return results
+
+
+def _format_marker(marker, first=True):
+    # type: (Union[List[str], Tuple[Node, ...], str], Optional[bool]) -> str
+
+    assert isinstance(marker, (list, tuple, string_types))
+
+    # Sometimes we have a structure like [[...]] which is a single item list
+    # where the single item is itself it's own list. In that case we want skip
+    # the rest of this function so that we don't get extraneous () on the
+    # outside.
+    if (
+        isinstance(marker, list)
+        and len(marker) == 1
+        and isinstance(marker[0], (list, tuple))
+    ):
+        return _format_marker(marker[0])
+
+    if isinstance(marker, list):
+        inner = (_format_marker(m, first=False) for m in marker)
+        if first:
+            return " ".join(inner)
+        else:
+            return "(" + " ".join(inner) + ")"
+    elif isinstance(marker, tuple):
+        return " ".join([m.serialize() for m in marker])
+    else:
+        return marker
+
+
+_operators = {
+    "in": lambda lhs, rhs: lhs in rhs,
+    "not in": lambda lhs, rhs: lhs not in rhs,
+    "<": operator.lt,
+    "<=": operator.le,
+    "==": operator.eq,
+    "!=": operator.ne,
+    ">=": operator.ge,
+    ">": operator.gt,
+}  # type: Dict[str, Operator]
+
+
+def _eval_op(lhs, op, rhs):
+    # type: (str, Op, str) -> bool
+    try:
+        spec = Specifier("".join([op.serialize(), rhs]))
+    except InvalidSpecifier:
+        pass
+    else:
+        return spec.contains(lhs)
+
+    oper = _operators.get(op.serialize())  # type: Optional[Operator]
+    if oper is None:
+        raise UndefinedComparison(
+            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
+        )
+
+    return oper(lhs, rhs)
+
+
+class Undefined(object):
+    pass
+
+
+_undefined = Undefined()
+
+
+def _get_env(environment, name):
+    # type: (Dict[str, str], str) -> str
+    value = environment.get(name, _undefined)  # type: Union[str, Undefined]
+
+    if isinstance(value, Undefined):
+        raise UndefinedEnvironmentName(
+            "{0!r} does not exist in evaluation environment.".format(name)
+        )
+
+    return value
+
+
+def _evaluate_markers(markers, environment):
+    # type: (List[Any], Dict[str, str]) -> bool
+    groups = [[]]  # type: List[List[bool]]
+
+    for marker in markers:
+        assert isinstance(marker, (list, tuple, string_types))
+
+        if isinstance(marker, list):
+            groups[-1].append(_evaluate_markers(marker, environment))
+        elif isinstance(marker, tuple):
+            lhs, op, rhs = marker
+
+            if isinstance(lhs, Variable):
+                lhs_value = _get_env(environment, lhs.value)
+                rhs_value = rhs.value
+            else:
+                lhs_value = lhs.value
+                rhs_value = _get_env(environment, rhs.value)
+
+            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
+        else:
+            assert marker in ["and", "or"]
+            if marker == "or":
+                groups.append([])
+
+    return any(all(item) for item in groups)
+
+
+def format_full_version(info):
+    # type: (sys._version_info) -> str
+    version = "{0.major}.{0.minor}.{0.micro}".format(info)
+    kind = info.releaselevel
+    if kind != "final":
+        version += kind[0] + str(info.serial)
+    return version
+
+
+def default_environment():
+    # type: () -> Dict[str, str]
+    if hasattr(sys, "implementation"):
+        # Ignoring the `sys.implementation` reference for type checking due to
+        # mypy not liking that the attribute doesn't exist in Python 2.7 when
+        # run with the `--py27` flag.
+        iver = format_full_version(sys.implementation.version)  # type: ignore
+        implementation_name = sys.implementation.name  # type: ignore
+    else:
+        iver = "0"
+        implementation_name = ""
+
+    return {
+        "implementation_name": implementation_name,
+        "implementation_version": iver,
+        "os_name": os.name,
+        "platform_machine": platform.machine(),
+        "platform_release": platform.release(),
+        "platform_system": platform.system(),
+        "platform_version": platform.version(),
+        "python_full_version": platform.python_version(),
+        "platform_python_implementation": platform.python_implementation(),
+        "python_version": ".".join(platform.python_version_tuple()[:2]),
+        "sys_platform": sys.platform,
+    }
+
+
+class Marker(object):
+    def __init__(self, marker):
+        # type: (str) -> None
+        try:
+            self._markers = _coerce_parse_result(MARKER.parseString(marker))
+        except ParseException as e:
+            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
+                marker, marker[e.loc : e.loc + 8]
+            )
+            raise InvalidMarker(err_str)
+
+    def __str__(self):
+        # type: () -> str
+        return _format_marker(self._markers)
+
+    def __repr__(self):
+        # type: () -> str
+        return "<Marker({0!r})>".format(str(self))
+
+    def evaluate(self, environment=None):
+        # type: (Optional[Dict[str, str]]) -> bool
+        """Evaluate a marker.
+
+        Return the boolean from evaluating the given marker against the
+        environment. environment is an optional argument to override all or
+        part of the determined environment.
+
+        The environment is determined from the current Python process.
+        """
+        current_environment = default_environment()
+        if environment is not None:
+            current_environment.update(environment)
+
+        return _evaluate_markers(self._markers, current_environment)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/py.typed b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/requirements.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/requirements.py
new file mode 100644
index 0000000000000000000000000000000000000000..1b547927df7cdabd33c49b2ce29e557d240e6272
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/requirements.py
@@ -0,0 +1,145 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import string
+import re
+
+from pyparsing import stringStart, stringEnd, originalTextFor, ParseException
+from pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
+from pyparsing import Literal as L  # noqa
+from six.moves.urllib import parse as urlparse
+
+from ._typing import MYPY_CHECK_RUNNING
+from .markers import MARKER_EXPR, Marker
+from .specifiers import LegacySpecifier, Specifier, SpecifierSet
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import List
+
+
+class InvalidRequirement(ValueError):
+    """
+    An invalid requirement was found, users should refer to PEP 508.
+    """
+
+
+ALPHANUM = Word(string.ascii_letters + string.digits)
+
+LBRACKET = L("[").suppress()
+RBRACKET = L("]").suppress()
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+COMMA = L(",").suppress()
+SEMICOLON = L(";").suppress()
+AT = L("@").suppress()
+
+PUNCTUATION = Word("-_.")
+IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
+IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))
+
+NAME = IDENTIFIER("name")
+EXTRA = IDENTIFIER
+
+URI = Regex(r"[^ ]+")("url")
+URL = AT + URI
+
+EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
+EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")
+
+VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
+VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)
+
+VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
+VERSION_MANY = Combine(
+    VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False
+)("_raw_spec")
+_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
+_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "")
+
+VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
+VERSION_SPEC.setParseAction(lambda s, l, t: t[1])
+
+MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
+MARKER_EXPR.setParseAction(
+    lambda s, l, t: Marker(s[t._original_start : t._original_end])
+)
+MARKER_SEPARATOR = SEMICOLON
+MARKER = MARKER_SEPARATOR + MARKER_EXPR
+
+VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
+URL_AND_MARKER = URL + Optional(MARKER)
+
+NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)
+
+REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
+# pyparsing isn't thread safe during initialization, so we do it eagerly, see
+# issue #104
+REQUIREMENT.parseString("x[]")
+
+
+class Requirement(object):
+    """Parse a requirement.
+
+    Parse a given requirement string into its parts, such as name, specifier,
+    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
+    string.
+    """
+
+    # TODO: Can we test whether something is contained within a requirement?
+    #       If so how do we do that? Do we need to test against the _name_ of
+    #       the thing as well as the version? What about the markers?
+    # TODO: Can we normalize the name and extra name?
+
+    def __init__(self, requirement_string):
+        # type: (str) -> None
+        try:
+            req = REQUIREMENT.parseString(requirement_string)
+        except ParseException as e:
+            raise InvalidRequirement(
+                'Parse error at "{0!r}": {1}'.format(
+                    requirement_string[e.loc : e.loc + 8], e.msg
+                )
+            )
+
+        self.name = req.name
+        if req.url:
+            parsed_url = urlparse.urlparse(req.url)
+            if parsed_url.scheme == "file":
+                if urlparse.urlunparse(parsed_url) != req.url:
+                    raise InvalidRequirement("Invalid URL given")
+            elif not (parsed_url.scheme and parsed_url.netloc) or (
+                not parsed_url.scheme and not parsed_url.netloc
+            ):
+                raise InvalidRequirement("Invalid URL: {0}".format(req.url))
+            self.url = req.url
+        else:
+            self.url = None
+        self.extras = set(req.extras.asList() if req.extras else [])
+        self.specifier = SpecifierSet(req.specifier)
+        self.marker = req.marker if req.marker else None
+
+    def __str__(self):
+        # type: () -> str
+        parts = [self.name]  # type: List[str]
+
+        if self.extras:
+            parts.append("[{0}]".format(",".join(sorted(self.extras))))
+
+        if self.specifier:
+            parts.append(str(self.specifier))
+
+        if self.url:
+            parts.append("@ {0}".format(self.url))
+            if self.marker:
+                parts.append(" ")
+
+        if self.marker:
+            parts.append("; {0}".format(self.marker))
+
+        return "".join(parts)
+
+    def __repr__(self):
+        # type: () -> str
+        return "<Requirement({0!r})>".format(str(self))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/specifiers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/specifiers.py
new file mode 100644
index 0000000000000000000000000000000000000000..94987486d4b47275fb32b97a5dcb11b76742c73b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/specifiers.py
@@ -0,0 +1,849 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import abc
+import functools
+import itertools
+import re
+
+from ._compat import string_types, with_metaclass
+from ._typing import MYPY_CHECK_RUNNING
+from .version import Version, LegacyVersion, parse
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import (
+        List,
+        Dict,
+        Union,
+        Iterable,
+        Iterator,
+        Optional,
+        Callable,
+        Tuple,
+        FrozenSet,
+    )
+
+    ParsedVersion = Union[Version, LegacyVersion]
+    UnparsedVersion = Union[Version, LegacyVersion, str]
+    CallableOperator = Callable[[ParsedVersion, str], bool]
+
+
+class InvalidSpecifier(ValueError):
+    """
+    An invalid specifier was found, users should refer to PEP 440.
+    """
+
+
+class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):  # type: ignore
+    @abc.abstractmethod
+    def __str__(self):
+        # type: () -> str
+        """
+        Returns the str representation of this Specifier like object. This
+        should be representative of the Specifier itself.
+        """
+
+    @abc.abstractmethod
+    def __hash__(self):
+        # type: () -> int
+        """
+        Returns a hash value for this Specifier like object.
+        """
+
+    @abc.abstractmethod
+    def __eq__(self, other):
+        # type: (object) -> bool
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are equal.
+        """
+
+    @abc.abstractmethod
+    def __ne__(self, other):
+        # type: (object) -> bool
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are not equal.
+        """
+
+    @abc.abstractproperty
+    def prereleases(self):
+        # type: () -> Optional[bool]
+        """
+        Returns whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @prereleases.setter
+    def prereleases(self, value):
+        # type: (bool) -> None
+        """
+        Sets whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @abc.abstractmethod
+    def contains(self, item, prereleases=None):
+        # type: (str, Optional[bool]) -> bool
+        """
+        Determines if the given item is contained within this specifier.
+        """
+
+    @abc.abstractmethod
+    def filter(self, iterable, prereleases=None):
+        # type: (Iterable[UnparsedVersion], Optional[bool]) -> Iterable[UnparsedVersion]
+        """
+        Takes an iterable of items and filters them so that only items which
+        are contained within this specifier are allowed in it.
+        """
+
+
+class _IndividualSpecifier(BaseSpecifier):
+
+    _operators = {}  # type: Dict[str, str]
+
+    def __init__(self, spec="", prereleases=None):
+        # type: (str, Optional[bool]) -> None
+        match = self._regex.search(spec)
+        if not match:
+            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))
+
+        self._spec = (
+            match.group("operator").strip(),
+            match.group("version").strip(),
+        )  # type: Tuple[str, str]
+
+        # Store whether or not this Specifier should accept prereleases
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        # type: () -> str
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<{0}({1!r}{2})>".format(self.__class__.__name__, str(self), pre)
+
+    def __str__(self):
+        # type: () -> str
+        return "{0}{1}".format(*self._spec)
+
+    def __hash__(self):
+        # type: () -> int
+        return hash(self._spec)
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(str(other))
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec == other._spec
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(str(other))
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec != other._spec
+
+    def _get_operator(self, op):
+        # type: (str) -> CallableOperator
+        operator_callable = getattr(
+            self, "_compare_{0}".format(self._operators[op])
+        )  # type: CallableOperator
+        return operator_callable
+
+    def _coerce_version(self, version):
+        # type: (UnparsedVersion) -> ParsedVersion
+        if not isinstance(version, (LegacyVersion, Version)):
+            version = parse(version)
+        return version
+
+    @property
+    def operator(self):
+        # type: () -> str
+        return self._spec[0]
+
+    @property
+    def version(self):
+        # type: () -> str
+        return self._spec[1]
+
+    @property
+    def prereleases(self):
+        # type: () -> Optional[bool]
+        return self._prereleases
+
+    @prereleases.setter
+    def prereleases(self, value):
+        # type: (bool) -> None
+        self._prereleases = value
+
+    def __contains__(self, item):
+        # type: (str) -> bool
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # type: (UnparsedVersion, Optional[bool]) -> bool
+
+        # Determine if prereleases are to be allowed or not.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # Normalize item to a Version or LegacyVersion, this allows us to have
+        # a shortcut for ``"2.0" in Specifier(">=2")
+        normalized_item = self._coerce_version(item)
+
+        # Determine if we should be supporting prereleases in this specifier
+        # or not, if we do not support prereleases than we can short circuit
+        # logic if this version is a prereleases.
+        if normalized_item.is_prerelease and not prereleases:
+            return False
+
+        # Actually do the comparison to determine if this item is contained
+        # within this Specifier or not.
+        operator_callable = self._get_operator(self.operator)  # type: CallableOperator
+        return operator_callable(normalized_item, self.version)
+
+    def filter(self, iterable, prereleases=None):
+        # type: (Iterable[UnparsedVersion], Optional[bool]) -> Iterable[UnparsedVersion]
+
+        yielded = False
+        found_prereleases = []
+
+        kw = {"prereleases": prereleases if prereleases is not None else True}
+
+        # Attempt to iterate over all the values in the iterable and if any of
+        # them match, yield them.
+        for version in iterable:
+            parsed_version = self._coerce_version(version)
+
+            if self.contains(parsed_version, **kw):
+                # If our version is a prerelease, and we were not set to allow
+                # prereleases, then we'll store it for later incase nothing
+                # else matches this specifier.
+                if parsed_version.is_prerelease and not (
+                    prereleases or self.prereleases
+                ):
+                    found_prereleases.append(version)
+                # Either this is not a prerelease, or we should have been
+                # accepting prereleases from the beginning.
+                else:
+                    yielded = True
+                    yield version
+
+        # Now that we've iterated over everything, determine if we've yielded
+        # any values, and if we have not and we have any prereleases stored up
+        # then we will go ahead and yield the prereleases.
+        if not yielded and found_prereleases:
+            for version in found_prereleases:
+                yield version
+
+
+class LegacySpecifier(_IndividualSpecifier):
+
+    _regex_str = r"""
+        (?P<operator>(==|!=|<=|>=|<|>))
+        \s*
+        (?P<version>
+            [^,;\s)]* # Since this is a "legacy" specifier, and the version
+                      # string can be just about anything, we match everything
+                      # except for whitespace, a semi-colon for marker support,
+                      # a closing paren since versions can be enclosed in
+                      # them, and a comma since it's a version separator.
+        )
+        """
+
+    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+    }
+
+    def _coerce_version(self, version):
+        # type: (Union[ParsedVersion, str]) -> LegacyVersion
+        if not isinstance(version, LegacyVersion):
+            version = LegacyVersion(str(version))
+        return version
+
+    def _compare_equal(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective == self._coerce_version(spec)
+
+    def _compare_not_equal(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective != self._coerce_version(spec)
+
+    def _compare_less_than_equal(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective <= self._coerce_version(spec)
+
+    def _compare_greater_than_equal(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective >= self._coerce_version(spec)
+
+    def _compare_less_than(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective < self._coerce_version(spec)
+
+    def _compare_greater_than(self, prospective, spec):
+        # type: (LegacyVersion, str) -> bool
+        return prospective > self._coerce_version(spec)
+
+
+def _require_version_compare(
+    fn  # type: (Callable[[Specifier, ParsedVersion, str], bool])
+):
+    # type: (...) -> Callable[[Specifier, ParsedVersion, str], bool]
+    @functools.wraps(fn)
+    def wrapped(self, prospective, spec):
+        # type: (Specifier, ParsedVersion, str) -> bool
+        if not isinstance(prospective, Version):
+            return False
+        return fn(self, prospective, spec)
+
+    return wrapped
+
+
+class Specifier(_IndividualSpecifier):
+
+    _regex_str = r"""
+        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
+        (?P<version>
+            (?:
+                # The identity operators allow for an escape hatch that will
+                # do an exact string match of the version you wish to install.
+                # This will not be parsed by PEP 440 and we cannot determine
+                # any semantic meaning from it. This operator is discouraged
+                # but included entirely as an escape hatch.
+                (?<====)  # Only match for the identity operator
+                \s*
+                [^\s]*    # We just match everything, except for whitespace
+                          # since we are only testing for strict identity.
+            )
+            |
+            (?:
+                # The (non)equality operators allow for wild card and local
+                # versions to be specified so we have to define these two
+                # operators separately to enable that.
+                (?<===|!=)            # Only match for equals and not equals
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+
+                # You cannot use a wild card and a dev or local version
+                # together so group them with a | and make them optional.
+                (?:
+                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
+                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
+                    |
+                    \.\*  # Wild card syntax of .*
+                )?
+            )
+            |
+            (?:
+                # The compatible operator requires at least two digits in the
+                # release segment.
+                (?<=~=)               # Only match for the compatible operator
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+            |
+            (?:
+                # All other operators only allow a sub set of what the
+                # (non)equality operators do. Specifically they do not allow
+                # local versions to be specified nor do they allow the prefix
+                # matching wild cards.
+                (?<!==|!=|~=)         # We have special cases for these
+                                      # operators so we want to make sure they
+                                      # don't match here.
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+        )
+        """
+
+    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "~=": "compatible",
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+        "===": "arbitrary",
+    }
+
+    @_require_version_compare
+    def _compare_compatible(self, prospective, spec):
+        # type: (ParsedVersion, str) -> bool
+
+        # Compatible releases have an equivalent combination of >= and ==. That
+        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
+        # implement this in terms of the other specifiers instead of
+        # implementing it ourselves. The only thing we need to do is construct
+        # the other specifiers.
+
+        # We want everything but the last item in the version, but we want to
+        # ignore post and dev releases and we want to treat the pre-release as
+        # it's own separate segment.
+        prefix = ".".join(
+            list(
+                itertools.takewhile(
+                    lambda x: (not x.startswith("post") and not x.startswith("dev")),
+                    _version_split(spec),
+                )
+            )[:-1]
+        )
+
+        # Add the prefix notation to the end of our string
+        prefix += ".*"
+
+        return self._get_operator(">=")(prospective, spec) and self._get_operator("==")(
+            prospective, prefix
+        )
+
+    @_require_version_compare
+    def _compare_equal(self, prospective, spec):
+        # type: (ParsedVersion, str) -> bool
+
+        # We need special logic to handle prefix matching
+        if spec.endswith(".*"):
+            # In the case of prefix matching we want to ignore local segment.
+            prospective = Version(prospective.public)
+            # Split the spec out by dots, and pretend that there is an implicit
+            # dot in between a release segment and a pre-release segment.
+            split_spec = _version_split(spec[:-2])  # Remove the trailing .*
+
+            # Split the prospective version out by dots, and pretend that there
+            # is an implicit dot in between a release segment and a pre-release
+            # segment.
+            split_prospective = _version_split(str(prospective))
+
+            # Shorten the prospective version to be the same length as the spec
+            # so that we can determine if the specifier is a prefix of the
+            # prospective version or not.
+            shortened_prospective = split_prospective[: len(split_spec)]
+
+            # Pad out our two sides with zeros so that they both equal the same
+            # length.
+            padded_spec, padded_prospective = _pad_version(
+                split_spec, shortened_prospective
+            )
+
+            return padded_prospective == padded_spec
+        else:
+            # Convert our spec string into a Version
+            spec_version = Version(spec)
+
+            # If the specifier does not have a local segment, then we want to
+            # act as if the prospective version also does not have a local
+            # segment.
+            if not spec_version.local:
+                prospective = Version(prospective.public)
+
+            return prospective == spec_version
+
+    @_require_version_compare
+    def _compare_not_equal(self, prospective, spec):
+        # type: (ParsedVersion, str) -> bool
+        return not self._compare_equal(prospective, spec)
+
+    @_require_version_compare
+    def _compare_less_than_equal(self, prospective, spec):
+        # type: (ParsedVersion, str) -> bool
+        return prospective <= Version(spec)
+
+    @_require_version_compare
+    def _compare_greater_than_equal(self, prospective, spec):
+        # type: (ParsedVersion, str) -> bool
+        return prospective >= Version(spec)
+
+    @_require_version_compare
+    def _compare_less_than(self, prospective, spec_str):
+        # type: (ParsedVersion, str) -> bool
+
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec_str)
+
+        # Check to see if the prospective version is less than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective < spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a pre-release version, that we do not accept pre-release
+        # versions for the version mentioned in the specifier (e.g. <3.1 should
+        # not match 3.1.dev0, but should match 3.0.dev0).
+        if not spec.is_prerelease and prospective.is_prerelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # less than the spec version *and* it's not a pre-release of the same
+        # version in the spec.
+        return True
+
+    @_require_version_compare
+    def _compare_greater_than(self, prospective, spec_str):
+        # type: (ParsedVersion, str) -> bool
+
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec_str)
+
+        # Check to see if the prospective version is greater than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective > spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a post-release version, that we do not accept
+        # post-release versions for the version mentioned in the specifier
+        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
+        if not spec.is_postrelease and prospective.is_postrelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # Ensure that we do not allow a local version of the version mentioned
+        # in the specifier, which is technically greater than, to match.
+        if prospective.local is not None:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # greater than the spec version *and* it's not a pre-release of the
+        # same version in the spec.
+        return True
+
+    def _compare_arbitrary(self, prospective, spec):
+        # type: (Version, str) -> bool
+        return str(prospective).lower() == str(spec).lower()
+
+    @property
+    def prereleases(self):
+        # type: () -> bool
+
+        # If there is an explicit prereleases set for this, then we'll just
+        # blindly use that.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # Look at all of our specifiers and determine if they are inclusive
+        # operators, and if they are if they are including an explicit
+        # prerelease.
+        operator, version = self._spec
+        if operator in ["==", ">=", "<=", "~=", "==="]:
+            # The == specifier can include a trailing .*, if it does we
+            # want to remove before parsing.
+            if operator == "==" and version.endswith(".*"):
+                version = version[:-2]
+
+            # Parse the version, and if it is a pre-release than this
+            # specifier allows pre-releases.
+            if parse(version).is_prerelease:
+                return True
+
+        return False
+
+    @prereleases.setter
+    def prereleases(self, value):
+        # type: (bool) -> None
+        self._prereleases = value
+
+
+_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
+
+
+def _version_split(version):
+    # type: (str) -> List[str]
+    result = []  # type: List[str]
+    for item in version.split("."):
+        match = _prefix_regex.search(item)
+        if match:
+            result.extend(match.groups())
+        else:
+            result.append(item)
+    return result
+
+
+def _pad_version(left, right):
+    # type: (List[str], List[str]) -> Tuple[List[str], List[str]]
+    left_split, right_split = [], []
+
+    # Get the release segment of our versions
+    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
+    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))
+
+    # Get the rest of our versions
+    left_split.append(left[len(left_split[0]) :])
+    right_split.append(right[len(right_split[0]) :])
+
+    # Insert our padding
+    left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0])))
+    right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0])))
+
+    return (list(itertools.chain(*left_split)), list(itertools.chain(*right_split)))
+
+
+class SpecifierSet(BaseSpecifier):
+    def __init__(self, specifiers="", prereleases=None):
+        # type: (str, Optional[bool]) -> None
+
+        # Split on , to break each individual specifier into it's own item, and
+        # strip each item to remove leading/trailing whitespace.
+        split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
+
+        # Parsed each individual specifier, attempting first to make it a
+        # Specifier and falling back to a LegacySpecifier.
+        parsed = set()
+        for specifier in split_specifiers:
+            try:
+                parsed.add(Specifier(specifier))
+            except InvalidSpecifier:
+                parsed.add(LegacySpecifier(specifier))
+
+        # Turn our parsed specifiers into a frozen set and save them for later.
+        self._specs = frozenset(parsed)
+
+        # Store our prereleases value so we can use it later to determine if
+        # we accept prereleases or not.
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        # type: () -> str
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)
+
+    def __str__(self):
+        # type: () -> str
+        return ",".join(sorted(str(s) for s in self._specs))
+
+    def __hash__(self):
+        # type: () -> int
+        return hash(self._specs)
+
+    def __and__(self, other):
+        # type: (Union[SpecifierSet, str]) -> SpecifierSet
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        specifier = SpecifierSet()
+        specifier._specs = frozenset(self._specs | other._specs)
+
+        if self._prereleases is None and other._prereleases is not None:
+            specifier._prereleases = other._prereleases
+        elif self._prereleases is not None and other._prereleases is None:
+            specifier._prereleases = self._prereleases
+        elif self._prereleases == other._prereleases:
+            specifier._prereleases = self._prereleases
+        else:
+            raise ValueError(
+                "Cannot combine SpecifierSets with True and False prerelease "
+                "overrides."
+            )
+
+        return specifier
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        if isinstance(other, (string_types, _IndividualSpecifier)):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs == other._specs
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        if isinstance(other, (string_types, _IndividualSpecifier)):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs != other._specs
+
+    def __len__(self):
+        # type: () -> int
+        return len(self._specs)
+
+    def __iter__(self):
+        # type: () -> Iterator[FrozenSet[_IndividualSpecifier]]
+        return iter(self._specs)
+
+    @property
+    def prereleases(self):
+        # type: () -> Optional[bool]
+
+        # If we have been given an explicit prerelease modifier, then we'll
+        # pass that through here.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # If we don't have any specifiers, and we don't have a forced value,
+        # then we'll just return None since we don't know if this should have
+        # pre-releases or not.
+        if not self._specs:
+            return None
+
+        # Otherwise we'll see if any of the given specifiers accept
+        # prereleases, if any of them do we'll return True, otherwise False.
+        return any(s.prereleases for s in self._specs)
+
+    @prereleases.setter
+    def prereleases(self, value):
+        # type: (bool) -> None
+        self._prereleases = value
+
+    def __contains__(self, item):
+        # type: (Union[ParsedVersion, str]) -> bool
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # type: (Union[ParsedVersion, str], Optional[bool]) -> bool
+
+        # Ensure that our item is a Version or LegacyVersion instance.
+        if not isinstance(item, (LegacyVersion, Version)):
+            item = parse(item)
+
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # We can determine if we're going to allow pre-releases by looking to
+        # see if any of the underlying items supports them. If none of them do
+        # and this item is a pre-release then we do not allow it and we can
+        # short circuit that here.
+        # Note: This means that 1.0.dev1 would not be contained in something
+        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
+        if not prereleases and item.is_prerelease:
+            return False
+
+        # We simply dispatch to the underlying specs here to make sure that the
+        # given version is contained within all of them.
+        # Note: This use of all() here means that an empty set of specifiers
+        #       will always return True, this is an explicit design decision.
+        return all(s.contains(item, prereleases=prereleases) for s in self._specs)
+
+    def filter(
+        self,
+        iterable,  # type: Iterable[Union[ParsedVersion, str]]
+        prereleases=None,  # type: Optional[bool]
+    ):
+        # type: (...) -> Iterable[Union[ParsedVersion, str]]
+
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # If we have any specifiers, then we want to wrap our iterable in the
+        # filter method for each one, this will act as a logical AND amongst
+        # each specifier.
+        if self._specs:
+            for spec in self._specs:
+                iterable = spec.filter(iterable, prereleases=bool(prereleases))
+            return iterable
+        # If we do not have any specifiers, then we need to have a rough filter
+        # which will filter out any pre-releases, unless there are no final
+        # releases, and which will filter out LegacyVersion in general.
+        else:
+            filtered = []  # type: List[Union[ParsedVersion, str]]
+            found_prereleases = []  # type: List[Union[ParsedVersion, str]]
+
+            for item in iterable:
+                # Ensure that we some kind of Version class for this item.
+                if not isinstance(item, (LegacyVersion, Version)):
+                    parsed_version = parse(item)
+                else:
+                    parsed_version = item
+
+                # Filter out any item which is parsed as a LegacyVersion
+                if isinstance(parsed_version, LegacyVersion):
+                    continue
+
+                # Store any item which is a pre-release for later unless we've
+                # already found a final version or we are accepting prereleases
+                if parsed_version.is_prerelease and not prereleases:
+                    if not filtered:
+                        found_prereleases.append(item)
+                else:
+                    filtered.append(item)
+
+            # If we've found no items except for pre-releases, then we'll go
+            # ahead and use the pre-releases
+            if not filtered and found_prereleases and prereleases is None:
+                return found_prereleases
+
+            return filtered
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/tags.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/tags.py
new file mode 100644
index 0000000000000000000000000000000000000000..300faab847616e48be1883babffeb39197aee1a6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/tags.py
@@ -0,0 +1,739 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+
+from __future__ import absolute_import
+
+import distutils.util
+
+try:
+    from importlib.machinery import EXTENSION_SUFFIXES
+except ImportError:  # pragma: no cover
+    import imp
+
+    EXTENSION_SUFFIXES = [x[0] for x in imp.get_suffixes()]
+    del imp
+import logging
+import os
+import platform
+import re
+import struct
+import sys
+import sysconfig
+import warnings
+
+from ._typing import MYPY_CHECK_RUNNING, cast
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import (
+        Dict,
+        FrozenSet,
+        IO,
+        Iterable,
+        Iterator,
+        List,
+        Optional,
+        Sequence,
+        Tuple,
+        Union,
+    )
+
+    PythonVersion = Sequence[int]
+    MacVersion = Tuple[int, int]
+    GlibcVersion = Tuple[int, int]
+
+
+logger = logging.getLogger(__name__)
+
+INTERPRETER_SHORT_NAMES = {
+    "python": "py",  # Generic.
+    "cpython": "cp",
+    "pypy": "pp",
+    "ironpython": "ip",
+    "jython": "jy",
+}  # type: Dict[str, str]
+
+
+_32_BIT_INTERPRETER = sys.maxsize <= 2 ** 32
+
+
+class Tag(object):
+
+    __slots__ = ["_interpreter", "_abi", "_platform"]
+
+    def __init__(self, interpreter, abi, platform):
+        # type: (str, str, str) -> None
+        self._interpreter = interpreter.lower()
+        self._abi = abi.lower()
+        self._platform = platform.lower()
+
+    @property
+    def interpreter(self):
+        # type: () -> str
+        return self._interpreter
+
+    @property
+    def abi(self):
+        # type: () -> str
+        return self._abi
+
+    @property
+    def platform(self):
+        # type: () -> str
+        return self._platform
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        if not isinstance(other, Tag):
+            return NotImplemented
+
+        return (
+            (self.platform == other.platform)
+            and (self.abi == other.abi)
+            and (self.interpreter == other.interpreter)
+        )
+
+    def __hash__(self):
+        # type: () -> int
+        return hash((self._interpreter, self._abi, self._platform))
+
+    def __str__(self):
+        # type: () -> str
+        return "{}-{}-{}".format(self._interpreter, self._abi, self._platform)
+
+    def __repr__(self):
+        # type: () -> str
+        return "<{self} @ {self_id}>".format(self=self, self_id=id(self))
+
+
+def parse_tag(tag):
+    # type: (str) -> FrozenSet[Tag]
+    tags = set()
+    interpreters, abis, platforms = tag.split("-")
+    for interpreter in interpreters.split("."):
+        for abi in abis.split("."):
+            for platform_ in platforms.split("."):
+                tags.add(Tag(interpreter, abi, platform_))
+    return frozenset(tags)
+
+
+def _warn_keyword_parameter(func_name, kwargs):
+    # type: (str, Dict[str, bool]) -> bool
+    """
+    Backwards-compatibility with Python 2.7 to allow treating 'warn' as keyword-only.
+    """
+    if not kwargs:
+        return False
+    elif len(kwargs) > 1 or "warn" not in kwargs:
+        kwargs.pop("warn", None)
+        arg = next(iter(kwargs.keys()))
+        raise TypeError(
+            "{}() got an unexpected keyword argument {!r}".format(func_name, arg)
+        )
+    return kwargs["warn"]
+
+
+def _get_config_var(name, warn=False):
+    # type: (str, bool) -> Union[int, str, None]
+    value = sysconfig.get_config_var(name)
+    if value is None and warn:
+        logger.debug(
+            "Config variable '%s' is unset, Python ABI tag may be incorrect", name
+        )
+    return value
+
+
+def _normalize_string(string):
+    # type: (str) -> str
+    return string.replace(".", "_").replace("-", "_")
+
+
+def _abi3_applies(python_version):
+    # type: (PythonVersion) -> bool
+    """
+    Determine if the Python version supports abi3.
+
+    PEP 384 was first implemented in Python 3.2.
+    """
+    return len(python_version) > 1 and tuple(python_version) >= (3, 2)
+
+
+def _cpython_abis(py_version, warn=False):
+    # type: (PythonVersion, bool) -> List[str]
+    py_version = tuple(py_version)  # To allow for version comparison.
+    abis = []
+    version = _version_nodot(py_version[:2])
+    debug = pymalloc = ucs4 = ""
+    with_debug = _get_config_var("Py_DEBUG", warn)
+    has_refcount = hasattr(sys, "gettotalrefcount")
+    # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled
+    # extension modules is the best option.
+    # https://github.com/pypa/pip/issues/3383#issuecomment-173267692
+    has_ext = "_d.pyd" in EXTENSION_SUFFIXES
+    if with_debug or (with_debug is None and (has_refcount or has_ext)):
+        debug = "d"
+    if py_version < (3, 8):
+        with_pymalloc = _get_config_var("WITH_PYMALLOC", warn)
+        if with_pymalloc or with_pymalloc is None:
+            pymalloc = "m"
+        if py_version < (3, 3):
+            unicode_size = _get_config_var("Py_UNICODE_SIZE", warn)
+            if unicode_size == 4 or (
+                unicode_size is None and sys.maxunicode == 0x10FFFF
+            ):
+                ucs4 = "u"
+    elif debug:
+        # Debug builds can also load "normal" extension modules.
+        # We can also assume no UCS-4 or pymalloc requirement.
+        abis.append("cp{version}".format(version=version))
+    abis.insert(
+        0,
+        "cp{version}{debug}{pymalloc}{ucs4}".format(
+            version=version, debug=debug, pymalloc=pymalloc, ucs4=ucs4
+        ),
+    )
+    return abis
+
+
+def cpython_tags(
+    python_version=None,  # type: Optional[PythonVersion]
+    abis=None,  # type: Optional[Iterable[str]]
+    platforms=None,  # type: Optional[Iterable[str]]
+    **kwargs  # type: bool
+):
+    # type: (...) -> Iterator[Tag]
+    """
+    Yields the tags for a CPython interpreter.
+
+    The tags consist of:
+    - cp<python_version>-<abi>-<platform>
+    - cp<python_version>-abi3-<platform>
+    - cp<python_version>-none-<platform>
+    - cp<less than python_version>-abi3-<platform>  # Older Python versions down to 3.2.
+
+    If python_version only specifies a major version then user-provided ABIs and
+    the 'none' ABItag will be used.
+
+    If 'abi3' or 'none' are specified in 'abis' then they will be yielded at
+    their normal position and not at the beginning.
+    """
+    warn = _warn_keyword_parameter("cpython_tags", kwargs)
+    if not python_version:
+        python_version = sys.version_info[:2]
+
+    interpreter = "cp{}".format(_version_nodot(python_version[:2]))
+
+    if abis is None:
+        if len(python_version) > 1:
+            abis = _cpython_abis(python_version, warn)
+        else:
+            abis = []
+    abis = list(abis)
+    # 'abi3' and 'none' are explicitly handled later.
+    for explicit_abi in ("abi3", "none"):
+        try:
+            abis.remove(explicit_abi)
+        except ValueError:
+            pass
+
+    platforms = list(platforms or _platform_tags())
+    for abi in abis:
+        for platform_ in platforms:
+            yield Tag(interpreter, abi, platform_)
+    if _abi3_applies(python_version):
+        for tag in (Tag(interpreter, "abi3", platform_) for platform_ in platforms):
+            yield tag
+    for tag in (Tag(interpreter, "none", platform_) for platform_ in platforms):
+        yield tag
+
+    if _abi3_applies(python_version):
+        for minor_version in range(python_version[1] - 1, 1, -1):
+            for platform_ in platforms:
+                interpreter = "cp{version}".format(
+                    version=_version_nodot((python_version[0], minor_version))
+                )
+                yield Tag(interpreter, "abi3", platform_)
+
+
+def _generic_abi():
+    # type: () -> Iterator[str]
+    abi = sysconfig.get_config_var("SOABI")
+    if abi:
+        yield _normalize_string(abi)
+
+
+def generic_tags(
+    interpreter=None,  # type: Optional[str]
+    abis=None,  # type: Optional[Iterable[str]]
+    platforms=None,  # type: Optional[Iterable[str]]
+    **kwargs  # type: bool
+):
+    # type: (...) -> Iterator[Tag]
+    """
+    Yields the tags for a generic interpreter.
+
+    The tags consist of:
+    - <interpreter>-<abi>-<platform>
+
+    The "none" ABI will be added if it was not explicitly provided.
+    """
+    warn = _warn_keyword_parameter("generic_tags", kwargs)
+    if not interpreter:
+        interp_name = interpreter_name()
+        interp_version = interpreter_version(warn=warn)
+        interpreter = "".join([interp_name, interp_version])
+    if abis is None:
+        abis = _generic_abi()
+    platforms = list(platforms or _platform_tags())
+    abis = list(abis)
+    if "none" not in abis:
+        abis.append("none")
+    for abi in abis:
+        for platform_ in platforms:
+            yield Tag(interpreter, abi, platform_)
+
+
+def _py_interpreter_range(py_version):
+    # type: (PythonVersion) -> Iterator[str]
+    """
+    Yields Python versions in descending order.
+
+    After the latest version, the major-only version will be yielded, and then
+    all previous versions of that major version.
+    """
+    if len(py_version) > 1:
+        yield "py{version}".format(version=_version_nodot(py_version[:2]))
+    yield "py{major}".format(major=py_version[0])
+    if len(py_version) > 1:
+        for minor in range(py_version[1] - 1, -1, -1):
+            yield "py{version}".format(version=_version_nodot((py_version[0], minor)))
+
+
+def compatible_tags(
+    python_version=None,  # type: Optional[PythonVersion]
+    interpreter=None,  # type: Optional[str]
+    platforms=None,  # type: Optional[Iterable[str]]
+):
+    # type: (...) -> Iterator[Tag]
+    """
+    Yields the sequence of tags that are compatible with a specific version of Python.
+
+    The tags consist of:
+    - py*-none-<platform>
+    - <interpreter>-none-any  # ... if `interpreter` is provided.
+    - py*-none-any
+    """
+    if not python_version:
+        python_version = sys.version_info[:2]
+    platforms = list(platforms or _platform_tags())
+    for version in _py_interpreter_range(python_version):
+        for platform_ in platforms:
+            yield Tag(version, "none", platform_)
+    if interpreter:
+        yield Tag(interpreter, "none", "any")
+    for version in _py_interpreter_range(python_version):
+        yield Tag(version, "none", "any")
+
+
+def _mac_arch(arch, is_32bit=_32_BIT_INTERPRETER):
+    # type: (str, bool) -> str
+    if not is_32bit:
+        return arch
+
+    if arch.startswith("ppc"):
+        return "ppc"
+
+    return "i386"
+
+
+def _mac_binary_formats(version, cpu_arch):
+    # type: (MacVersion, str) -> List[str]
+    formats = [cpu_arch]
+    if cpu_arch == "x86_64":
+        if version < (10, 4):
+            return []
+        formats.extend(["intel", "fat64", "fat32"])
+
+    elif cpu_arch == "i386":
+        if version < (10, 4):
+            return []
+        formats.extend(["intel", "fat32", "fat"])
+
+    elif cpu_arch == "ppc64":
+        # TODO: Need to care about 32-bit PPC for ppc64 through 10.2?
+        if version > (10, 5) or version < (10, 4):
+            return []
+        formats.append("fat64")
+
+    elif cpu_arch == "ppc":
+        if version > (10, 6):
+            return []
+        formats.extend(["fat32", "fat"])
+
+    formats.append("universal")
+    return formats
+
+
+def mac_platforms(version=None, arch=None):
+    # type: (Optional[MacVersion], Optional[str]) -> Iterator[str]
+    """
+    Yields the platform tags for a macOS system.
+
+    The `version` parameter is a two-item tuple specifying the macOS version to
+    generate platform tags for. The `arch` parameter is the CPU architecture to
+    generate platform tags for. Both parameters default to the appropriate value
+    for the current system.
+    """
+    version_str, _, cpu_arch = platform.mac_ver()  # type: ignore
+    if version is None:
+        version = cast("MacVersion", tuple(map(int, version_str.split(".")[:2])))
+    else:
+        version = version
+    if arch is None:
+        arch = _mac_arch(cpu_arch)
+    else:
+        arch = arch
+    for minor_version in range(version[1], -1, -1):
+        compat_version = version[0], minor_version
+        binary_formats = _mac_binary_formats(compat_version, arch)
+        for binary_format in binary_formats:
+            yield "macosx_{major}_{minor}_{binary_format}".format(
+                major=compat_version[0],
+                minor=compat_version[1],
+                binary_format=binary_format,
+            )
+
+
+# From PEP 513.
+def _is_manylinux_compatible(name, glibc_version):
+    # type: (str, GlibcVersion) -> bool
+    # Check for presence of _manylinux module.
+    try:
+        import _manylinux  # noqa
+
+        return bool(getattr(_manylinux, name + "_compatible"))
+    except (ImportError, AttributeError):
+        # Fall through to heuristic check below.
+        pass
+
+    return _have_compatible_glibc(*glibc_version)
+
+
+def _glibc_version_string():
+    # type: () -> Optional[str]
+    # Returns glibc version string, or None if not using glibc.
+    return _glibc_version_string_confstr() or _glibc_version_string_ctypes()
+
+
+def _glibc_version_string_confstr():
+    # type: () -> Optional[str]
+    """
+    Primary implementation of glibc_version_string using os.confstr.
+    """
+    # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely
+    # to be broken or missing. This strategy is used in the standard library
+    # platform module.
+    # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183
+    try:
+        # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17".
+        version_string = os.confstr(  # type: ignore[attr-defined] # noqa: F821
+            "CS_GNU_LIBC_VERSION"
+        )
+        assert version_string is not None
+        _, version = version_string.split()  # type: Tuple[str, str]
+    except (AssertionError, AttributeError, OSError, ValueError):
+        # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)...
+        return None
+    return version
+
+
+def _glibc_version_string_ctypes():
+    # type: () -> Optional[str]
+    """
+    Fallback implementation of glibc_version_string using ctypes.
+    """
+    try:
+        import ctypes
+    except ImportError:
+        return None
+
+    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
+    # manpage says, "If filename is NULL, then the returned handle is for the
+    # main program". This way we can let the linker do the work to figure out
+    # which libc our process is actually using.
+    #
+    # Note: typeshed is wrong here so we are ignoring this line.
+    process_namespace = ctypes.CDLL(None)  # type: ignore
+    try:
+        gnu_get_libc_version = process_namespace.gnu_get_libc_version
+    except AttributeError:
+        # Symbol doesn't exist -> therefore, we are not linked to
+        # glibc.
+        return None
+
+    # Call gnu_get_libc_version, which returns a string like "2.5"
+    gnu_get_libc_version.restype = ctypes.c_char_p
+    version_str = gnu_get_libc_version()  # type: str
+    # py2 / py3 compatibility:
+    if not isinstance(version_str, str):
+        version_str = version_str.decode("ascii")
+
+    return version_str
+
+
+# Separated out from have_compatible_glibc for easier unit testing.
+def _check_glibc_version(version_str, required_major, minimum_minor):
+    # type: (str, int, int) -> bool
+    # Parse string and check against requested version.
+    #
+    # We use a regexp instead of str.split because we want to discard any
+    # random junk that might come after the minor version -- this might happen
+    # in patched/forked versions of glibc (e.g. Linaro's version of glibc
+    # uses version strings like "2.20-2014.11"). See gh-3588.
+    m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
+    if not m:
+        warnings.warn(
+            "Expected glibc version with 2 components major.minor,"
+            " got: %s" % version_str,
+            RuntimeWarning,
+        )
+        return False
+    return (
+        int(m.group("major")) == required_major
+        and int(m.group("minor")) >= minimum_minor
+    )
+
+
+def _have_compatible_glibc(required_major, minimum_minor):
+    # type: (int, int) -> bool
+    version_str = _glibc_version_string()
+    if version_str is None:
+        return False
+    return _check_glibc_version(version_str, required_major, minimum_minor)
+
+
+# Python does not provide platform information at sufficient granularity to
+# identify the architecture of the running executable in some cases, so we
+# determine it dynamically by reading the information from the running
+# process. This only applies on Linux, which uses the ELF format.
+class _ELFFileHeader(object):
+    # https://en.wikipedia.org/wiki/Executable_and_Linkable_Format#File_header
+    class _InvalidELFFileHeader(ValueError):
+        """
+        An invalid ELF file header was found.
+        """
+
+    ELF_MAGIC_NUMBER = 0x7F454C46
+    ELFCLASS32 = 1
+    ELFCLASS64 = 2
+    ELFDATA2LSB = 1
+    ELFDATA2MSB = 2
+    EM_386 = 3
+    EM_S390 = 22
+    EM_ARM = 40
+    EM_X86_64 = 62
+    EF_ARM_ABIMASK = 0xFF000000
+    EF_ARM_ABI_VER5 = 0x05000000
+    EF_ARM_ABI_FLOAT_HARD = 0x00000400
+
+    def __init__(self, file):
+        # type: (IO[bytes]) -> None
+        def unpack(fmt):
+            # type: (str) -> int
+            try:
+                result, = struct.unpack(
+                    fmt, file.read(struct.calcsize(fmt))
+                )  # type: (int, )
+            except struct.error:
+                raise _ELFFileHeader._InvalidELFFileHeader()
+            return result
+
+        self.e_ident_magic = unpack(">I")
+        if self.e_ident_magic != self.ELF_MAGIC_NUMBER:
+            raise _ELFFileHeader._InvalidELFFileHeader()
+        self.e_ident_class = unpack("B")
+        if self.e_ident_class not in {self.ELFCLASS32, self.ELFCLASS64}:
+            raise _ELFFileHeader._InvalidELFFileHeader()
+        self.e_ident_data = unpack("B")
+        if self.e_ident_data not in {self.ELFDATA2LSB, self.ELFDATA2MSB}:
+            raise _ELFFileHeader._InvalidELFFileHeader()
+        self.e_ident_version = unpack("B")
+        self.e_ident_osabi = unpack("B")
+        self.e_ident_abiversion = unpack("B")
+        self.e_ident_pad = file.read(7)
+        format_h = "<H" if self.e_ident_data == self.ELFDATA2LSB else ">H"
+        format_i = "<I" if self.e_ident_data == self.ELFDATA2LSB else ">I"
+        format_q = "<Q" if self.e_ident_data == self.ELFDATA2LSB else ">Q"
+        format_p = format_i if self.e_ident_class == self.ELFCLASS32 else format_q
+        self.e_type = unpack(format_h)
+        self.e_machine = unpack(format_h)
+        self.e_version = unpack(format_i)
+        self.e_entry = unpack(format_p)
+        self.e_phoff = unpack(format_p)
+        self.e_shoff = unpack(format_p)
+        self.e_flags = unpack(format_i)
+        self.e_ehsize = unpack(format_h)
+        self.e_phentsize = unpack(format_h)
+        self.e_phnum = unpack(format_h)
+        self.e_shentsize = unpack(format_h)
+        self.e_shnum = unpack(format_h)
+        self.e_shstrndx = unpack(format_h)
+
+
+def _get_elf_header():
+    # type: () -> Optional[_ELFFileHeader]
+    try:
+        with open(sys.executable, "rb") as f:
+            elf_header = _ELFFileHeader(f)
+    except (IOError, OSError, TypeError, _ELFFileHeader._InvalidELFFileHeader):
+        return None
+    return elf_header
+
+
+def _is_linux_armhf():
+    # type: () -> bool
+    # hard-float ABI can be detected from the ELF header of the running
+    # process
+    # https://static.docs.arm.com/ihi0044/g/aaelf32.pdf
+    elf_header = _get_elf_header()
+    if elf_header is None:
+        return False
+    result = elf_header.e_ident_class == elf_header.ELFCLASS32
+    result &= elf_header.e_ident_data == elf_header.ELFDATA2LSB
+    result &= elf_header.e_machine == elf_header.EM_ARM
+    result &= (
+        elf_header.e_flags & elf_header.EF_ARM_ABIMASK
+    ) == elf_header.EF_ARM_ABI_VER5
+    result &= (
+        elf_header.e_flags & elf_header.EF_ARM_ABI_FLOAT_HARD
+    ) == elf_header.EF_ARM_ABI_FLOAT_HARD
+    return result
+
+
+def _is_linux_i686():
+    # type: () -> bool
+    elf_header = _get_elf_header()
+    if elf_header is None:
+        return False
+    result = elf_header.e_ident_class == elf_header.ELFCLASS32
+    result &= elf_header.e_ident_data == elf_header.ELFDATA2LSB
+    result &= elf_header.e_machine == elf_header.EM_386
+    return result
+
+
+def _have_compatible_manylinux_abi(arch):
+    # type: (str) -> bool
+    if arch == "armv7l":
+        return _is_linux_armhf()
+    if arch == "i686":
+        return _is_linux_i686()
+    return True
+
+
+def _linux_platforms(is_32bit=_32_BIT_INTERPRETER):
+    # type: (bool) -> Iterator[str]
+    linux = _normalize_string(distutils.util.get_platform())
+    if is_32bit:
+        if linux == "linux_x86_64":
+            linux = "linux_i686"
+        elif linux == "linux_aarch64":
+            linux = "linux_armv7l"
+    manylinux_support = []
+    _, arch = linux.split("_", 1)
+    if _have_compatible_manylinux_abi(arch):
+        if arch in {"x86_64", "i686", "aarch64", "armv7l", "ppc64", "ppc64le", "s390x"}:
+            manylinux_support.append(
+                ("manylinux2014", (2, 17))
+            )  # CentOS 7 w/ glibc 2.17 (PEP 599)
+        if arch in {"x86_64", "i686"}:
+            manylinux_support.append(
+                ("manylinux2010", (2, 12))
+            )  # CentOS 6 w/ glibc 2.12 (PEP 571)
+            manylinux_support.append(
+                ("manylinux1", (2, 5))
+            )  # CentOS 5 w/ glibc 2.5 (PEP 513)
+    manylinux_support_iter = iter(manylinux_support)
+    for name, glibc_version in manylinux_support_iter:
+        if _is_manylinux_compatible(name, glibc_version):
+            yield linux.replace("linux", name)
+            break
+    # Support for a later manylinux implies support for an earlier version.
+    for name, _ in manylinux_support_iter:
+        yield linux.replace("linux", name)
+    yield linux
+
+
+def _generic_platforms():
+    # type: () -> Iterator[str]
+    yield _normalize_string(distutils.util.get_platform())
+
+
+def _platform_tags():
+    # type: () -> Iterator[str]
+    """
+    Provides the platform tags for this installation.
+    """
+    if platform.system() == "Darwin":
+        return mac_platforms()
+    elif platform.system() == "Linux":
+        return _linux_platforms()
+    else:
+        return _generic_platforms()
+
+
+def interpreter_name():
+    # type: () -> str
+    """
+    Returns the name of the running interpreter.
+    """
+    try:
+        name = sys.implementation.name  # type: ignore
+    except AttributeError:  # pragma: no cover
+        # Python 2.7 compatibility.
+        name = platform.python_implementation().lower()
+    return INTERPRETER_SHORT_NAMES.get(name) or name
+
+
+def interpreter_version(**kwargs):
+    # type: (bool) -> str
+    """
+    Returns the version of the running interpreter.
+    """
+    warn = _warn_keyword_parameter("interpreter_version", kwargs)
+    version = _get_config_var("py_version_nodot", warn=warn)
+    if version:
+        version = str(version)
+    else:
+        version = _version_nodot(sys.version_info[:2])
+    return version
+
+
+def _version_nodot(version):
+    # type: (PythonVersion) -> str
+    if any(v >= 10 for v in version):
+        sep = "_"
+    else:
+        sep = ""
+    return sep.join(map(str, version))
+
+
+def sys_tags(**kwargs):
+    # type: (bool) -> Iterator[Tag]
+    """
+    Returns the sequence of tag triples for the running interpreter.
+
+    The order of the sequence corresponds to priority order for the
+    interpreter, from most to least important.
+    """
+    warn = _warn_keyword_parameter("sys_tags", kwargs)
+
+    interp_name = interpreter_name()
+    if interp_name == "cp":
+        for tag in cpython_tags(warn=warn):
+            yield tag
+    else:
+        for tag in generic_tags():
+            yield tag
+
+    for tag in compatible_tags():
+        yield tag
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..44f1bf987325b92c5c2353fa236d1c7ae6c9cfb6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/utils.py
@@ -0,0 +1,62 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import re
+
+from ._typing import MYPY_CHECK_RUNNING
+from .version import InvalidVersion, Version
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import Union
+
+_canonicalize_regex = re.compile(r"[-_.]+")
+
+
+def canonicalize_name(name):
+    # type: (str) -> str
+    # This is taken from PEP 503.
+    return _canonicalize_regex.sub("-", name).lower()
+
+
+def canonicalize_version(_version):
+    # type: (str) -> Union[Version, str]
+    """
+    This is very similar to Version.__str__, but has one subtle difference
+    with the way it handles the release segment.
+    """
+
+    try:
+        version = Version(_version)
+    except InvalidVersion:
+        # Legacy versions cannot be normalized
+        return _version
+
+    parts = []
+
+    # Epoch
+    if version.epoch != 0:
+        parts.append("{0}!".format(version.epoch))
+
+    # Release segment
+    # NB: This strips trailing '.0's to normalize
+    parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in version.release)))
+
+    # Pre-release
+    if version.pre is not None:
+        parts.append("".join(str(x) for x in version.pre))
+
+    # Post-release
+    if version.post is not None:
+        parts.append(".post{0}".format(version.post))
+
+    # Development release
+    if version.dev is not None:
+        parts.append(".dev{0}".format(version.dev))
+
+    # Local version segment
+    if version.local is not None:
+        parts.append("+{0}".format(version.local))
+
+    return "".join(parts)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..f39a2a12a1b428d2cac999932643c1f1976cce6c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/packaging/version.py
@@ -0,0 +1,535 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import collections
+import itertools
+import re
+
+from ._structures import Infinity, NegativeInfinity
+from ._typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:  # pragma: no cover
+    from typing import Callable, Iterator, List, Optional, SupportsInt, Tuple, Union
+
+    from ._structures import InfinityType, NegativeInfinityType
+
+    InfiniteTypes = Union[InfinityType, NegativeInfinityType]
+    PrePostDevType = Union[InfiniteTypes, Tuple[str, int]]
+    SubLocalType = Union[InfiniteTypes, int, str]
+    LocalType = Union[
+        NegativeInfinityType,
+        Tuple[
+            Union[
+                SubLocalType,
+                Tuple[SubLocalType, str],
+                Tuple[NegativeInfinityType, SubLocalType],
+            ],
+            ...,
+        ],
+    ]
+    CmpKey = Tuple[
+        int, Tuple[int, ...], PrePostDevType, PrePostDevType, PrePostDevType, LocalType
+    ]
+    LegacyCmpKey = Tuple[int, Tuple[str, ...]]
+    VersionComparisonMethod = Callable[
+        [Union[CmpKey, LegacyCmpKey], Union[CmpKey, LegacyCmpKey]], bool
+    ]
+
+__all__ = ["parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"]
+
+
+_Version = collections.namedtuple(
+    "_Version", ["epoch", "release", "dev", "pre", "post", "local"]
+)
+
+
+def parse(version):
+    # type: (str) -> Union[LegacyVersion, Version]
+    """
+    Parse the given version string and return either a :class:`Version` object
+    or a :class:`LegacyVersion` object depending on if the given version is
+    a valid PEP 440 version or a legacy version.
+    """
+    try:
+        return Version(version)
+    except InvalidVersion:
+        return LegacyVersion(version)
+
+
+class InvalidVersion(ValueError):
+    """
+    An invalid version was found, users should refer to PEP 440.
+    """
+
+
+class _BaseVersion(object):
+    _key = None  # type: Union[CmpKey, LegacyCmpKey]
+
+    def __hash__(self):
+        # type: () -> int
+        return hash(self._key)
+
+    def __lt__(self, other):
+        # type: (_BaseVersion) -> bool
+        return self._compare(other, lambda s, o: s < o)
+
+    def __le__(self, other):
+        # type: (_BaseVersion) -> bool
+        return self._compare(other, lambda s, o: s <= o)
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        return self._compare(other, lambda s, o: s == o)
+
+    def __ge__(self, other):
+        # type: (_BaseVersion) -> bool
+        return self._compare(other, lambda s, o: s >= o)
+
+    def __gt__(self, other):
+        # type: (_BaseVersion) -> bool
+        return self._compare(other, lambda s, o: s > o)
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        return self._compare(other, lambda s, o: s != o)
+
+    def _compare(self, other, method):
+        # type: (object, VersionComparisonMethod) -> Union[bool, NotImplemented]
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return method(self._key, other._key)
+
+
+class LegacyVersion(_BaseVersion):
+    def __init__(self, version):
+        # type: (str) -> None
+        self._version = str(version)
+        self._key = _legacy_cmpkey(self._version)
+
+    def __str__(self):
+        # type: () -> str
+        return self._version
+
+    def __repr__(self):
+        # type: () -> str
+        return "<LegacyVersion({0})>".format(repr(str(self)))
+
+    @property
+    def public(self):
+        # type: () -> str
+        return self._version
+
+    @property
+    def base_version(self):
+        # type: () -> str
+        return self._version
+
+    @property
+    def epoch(self):
+        # type: () -> int
+        return -1
+
+    @property
+    def release(self):
+        # type: () -> None
+        return None
+
+    @property
+    def pre(self):
+        # type: () -> None
+        return None
+
+    @property
+    def post(self):
+        # type: () -> None
+        return None
+
+    @property
+    def dev(self):
+        # type: () -> None
+        return None
+
+    @property
+    def local(self):
+        # type: () -> None
+        return None
+
+    @property
+    def is_prerelease(self):
+        # type: () -> bool
+        return False
+
+    @property
+    def is_postrelease(self):
+        # type: () -> bool
+        return False
+
+    @property
+    def is_devrelease(self):
+        # type: () -> bool
+        return False
+
+
+_legacy_version_component_re = re.compile(r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE)
+
+_legacy_version_replacement_map = {
+    "pre": "c",
+    "preview": "c",
+    "-": "final-",
+    "rc": "c",
+    "dev": "@",
+}
+
+
+def _parse_version_parts(s):
+    # type: (str) -> Iterator[str]
+    for part in _legacy_version_component_re.split(s):
+        part = _legacy_version_replacement_map.get(part, part)
+
+        if not part or part == ".":
+            continue
+
+        if part[:1] in "0123456789":
+            # pad for numeric comparison
+            yield part.zfill(8)
+        else:
+            yield "*" + part
+
+    # ensure that alpha/beta/candidate are before final
+    yield "*final"
+
+
+def _legacy_cmpkey(version):
+    # type: (str) -> LegacyCmpKey
+
+    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
+    # greater than or equal to 0. This will effectively put the LegacyVersion,
+    # which uses the defacto standard originally implemented by setuptools,
+    # as before all PEP 440 versions.
+    epoch = -1
+
+    # This scheme is taken from pkg_resources.parse_version setuptools prior to
+    # it's adoption of the packaging library.
+    parts = []  # type: List[str]
+    for part in _parse_version_parts(version.lower()):
+        if part.startswith("*"):
+            # remove "-" before a prerelease tag
+            if part < "*final":
+                while parts and parts[-1] == "*final-":
+                    parts.pop()
+
+            # remove trailing zeros from each series of numeric parts
+            while parts and parts[-1] == "00000000":
+                parts.pop()
+
+        parts.append(part)
+
+    return epoch, tuple(parts)
+
+
+# Deliberately not anchored to the start and end of the string, to make it
+# easier for 3rd party code to reuse
+VERSION_PATTERN = r"""
+    v?
+    (?:
+        (?:(?P<epoch>[0-9]+)!)?                           # epoch
+        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P<pre>                                          # pre-release
+            [-_\.]?
+            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
+            [-_\.]?
+            (?P<pre_n>[0-9]+)?
+        )?
+        (?P<post>                                         # post release
+            (?:-(?P<post_n1>[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?P<post_l>post|rev|r)
+                [-_\.]?
+                (?P<post_n2>[0-9]+)?
+            )
+        )?
+        (?P<dev>                                          # dev release
+            [-_\.]?
+            (?P<dev_l>dev)
+            [-_\.]?
+            (?P<dev_n>[0-9]+)?
+        )?
+    )
+    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+
+class Version(_BaseVersion):
+
+    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    def __init__(self, version):
+        # type: (str) -> None
+
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion("Invalid version: '{0}'".format(version))
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self):
+        # type: () -> str
+        return "<Version({0})>".format(repr(str(self)))
+
+    def __str__(self):
+        # type: () -> str
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(".post{0}".format(self.post))
+
+        # Development release
+        if self.dev is not None:
+            parts.append(".dev{0}".format(self.dev))
+
+        # Local version segment
+        if self.local is not None:
+            parts.append("+{0}".format(self.local))
+
+        return "".join(parts)
+
+    @property
+    def epoch(self):
+        # type: () -> int
+        _epoch = self._version.epoch  # type: int
+        return _epoch
+
+    @property
+    def release(self):
+        # type: () -> Tuple[int, ...]
+        _release = self._version.release  # type: Tuple[int, ...]
+        return _release
+
+    @property
+    def pre(self):
+        # type: () -> Optional[Tuple[str, int]]
+        _pre = self._version.pre  # type: Optional[Tuple[str, int]]
+        return _pre
+
+    @property
+    def post(self):
+        # type: () -> Optional[Tuple[str, int]]
+        return self._version.post[1] if self._version.post else None
+
+    @property
+    def dev(self):
+        # type: () -> Optional[Tuple[str, int]]
+        return self._version.dev[1] if self._version.dev else None
+
+    @property
+    def local(self):
+        # type: () -> Optional[str]
+        if self._version.local:
+            return ".".join(str(x) for x in self._version.local)
+        else:
+            return None
+
+    @property
+    def public(self):
+        # type: () -> str
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self):
+        # type: () -> str
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @property
+    def is_prerelease(self):
+        # type: () -> bool
+        return self.dev is not None or self.pre is not None
+
+    @property
+    def is_postrelease(self):
+        # type: () -> bool
+        return self.post is not None
+
+    @property
+    def is_devrelease(self):
+        # type: () -> bool
+        return self.dev is not None
+
+    @property
+    def major(self):
+        # type: () -> int
+        return self.release[0] if len(self.release) >= 1 else 0
+
+    @property
+    def minor(self):
+        # type: () -> int
+        return self.release[1] if len(self.release) >= 2 else 0
+
+    @property
+    def micro(self):
+        # type: () -> int
+        return self.release[2] if len(self.release) >= 3 else 0
+
+
+def _parse_letter_version(
+    letter,  # type: str
+    number,  # type: Union[str, bytes, SupportsInt]
+):
+    # type: (...) -> Optional[Tuple[str, int]]
+
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+    return None
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local):
+    # type: (str) -> Optional[LocalType]
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+    return None
+
+
+def _cmpkey(
+    epoch,  # type: int
+    release,  # type: Tuple[int, ...]
+    pre,  # type: Optional[Tuple[str, int]]
+    post,  # type: Optional[Tuple[str, int]]
+    dev,  # type: Optional[Tuple[str, int]]
+    local,  # type: Optional[Tuple[SubLocalType]]
+):
+    # type: (...) -> CmpKey
+
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    _release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        _pre = NegativeInfinity  # type: PrePostDevType
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        _pre = Infinity
+    else:
+        _pre = pre
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        _post = NegativeInfinity  # type: PrePostDevType
+
+    else:
+        _post = post
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        _dev = Infinity  # type: PrePostDevType
+
+    else:
+        _dev = dev
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        _local = NegativeInfinity  # type: LocalType
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        _local = tuple(
+            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
+        )
+
+    return epoch, _release, _pre, _post, _dev, _local
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..ff686a7bbc3ded05dc4119741ed03cde68d27ede
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/METADATA
@@ -0,0 +1,15 @@
+Metadata-Version: 2.1
+Name: pep517
+Version: 0.8.2
+Summary: Wrappers to build Python packages using PEP 517 hooks
+Home-page: https://github.com/pypa/pep517
+Author: Thomas Kluyver
+Author-email: thomas@kluyver.me.uk
+License: UNKNOWN
+Platform: UNKNOWN
+Requires-Dist: importlib-metadata ; python_version<'3.8'
+Requires-Dist: zipp ; python_version<'3.8'
+
+UNKNOWN
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..3fb47ac774648b25bc7921105f88206ae2e9bb9b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/RECORD
@@ -0,0 +1,30 @@
+pep517/__init__.py,sha256=r5uA106NGJa3slspaD2m32aFpFUiZX-mZ9vIlzAEOp4,84
+pep517/_in_process.py,sha256=XrKOTURJdia5R7i3i_OQmS89LASFXE3HQXfX63qZBIE,8438
+pep517/build.py,sha256=WqM0-X4KyzY566qxGf3FeaYc1hw95H7YP0ElZ1zuTb0,3318
+pep517/check.py,sha256=ST02kRWBrRMOxgnRm9clw18Q2X7sJGaD4j3h6GmBhJ8,5949
+pep517/colorlog.py,sha256=Tk9AuYm_cLF3BKTBoSTJt9bRryn0aFojIQOwbfVUTxQ,4098
+pep517/compat.py,sha256=M-5s4VNp8rjyT76ZZ_ibnPD44DYVzSQlyCEHayjtDPw,780
+pep517/dirtools.py,sha256=2mkAkAL0mRz_elYFjRKuekTJVipH1zTn4tbf1EDev84,1129
+pep517/envbuild.py,sha256=K4dIGAbkXf3RoQX_9RFpZvMvPrVSHtcbH7o9VSrNnlM,6024
+pep517/meta.py,sha256=8mnM5lDnT4zXQpBTliJbRGfesH7iioHwozbDxALPS9Y,2463
+pep517/wrappers.py,sha256=yFU4Lp7TIYbmuVOTY-pXnlyGZ3F_grIi-JlLkpGN8Gk,10783
+pep517-0.8.2.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+pep517-0.8.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+pep517-0.8.2.dist-info/METADATA,sha256=Xxce86Wgsm-skBKT8CNYe018PehMglWPR2Jf4OUlSuk,359
+pep517-0.8.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pep517-0.8.2.dist-info/top_level.txt,sha256=x64nqdNQXcG05gK3p6UhgIg2F4KPPmqhcIN2XVqWXHM,7
+pep517-0.8.2.dist-info/RECORD,,
+pep517/dirtools.cpython-38.pyc,,
+pep517/envbuild.cpython-38.pyc,,
+pep517/wrappers.cpython-38.pyc,,
+pep517-0.8.2.dist-info/__pycache__,,
+pep517/check.cpython-38.pyc,,
+pep517/__pycache__,,
+pep517/colorlog.cpython-38.pyc,,
+pep517-0.8.2.virtualenv,,
+pep517/build.cpython-38.pyc,,
+pep517/compat.cpython-38.pyc,,
+pep517/_in_process.cpython-38.pyc,,
+pep517/meta.cpython-38.pyc,,
+pep517-0.8.2.dist-info/INSTALLER,,
+pep517/__init__.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..71573db631234e1797f6a1fbf453358f3ed6ed74
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+pep517
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517-0.8.2.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7355b68a2402f132a4c51e7b2bd09f3d64f0fd2c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/__init__.py
@@ -0,0 +1,4 @@
+"""Wrappers to build Python packages using PEP 517 hooks
+"""
+
+__version__ = '0.8.2'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/_in_process.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/_in_process.py
new file mode 100644
index 0000000000000000000000000000000000000000..a536b03e6bbea0e63459d2f7b71f027ec6c7a150
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/_in_process.py
@@ -0,0 +1,280 @@
+"""This is invoked in a subprocess to call the build backend hooks.
+
+It expects:
+- Command line args: hook_name, control_dir
+- Environment variables:
+      PEP517_BUILD_BACKEND=entry.point:spec
+      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
+- control_dir/input.json:
+  - {"kwargs": {...}}
+
+Results:
+- control_dir/output.json
+  - {"return_val": ...}
+"""
+from glob import glob
+from importlib import import_module
+import json
+import os
+import os.path
+from os.path import join as pjoin
+import re
+import shutil
+import sys
+import traceback
+
+# This file is run as a script, and `import compat` is not zip-safe, so we
+# include write_json() and read_json() from compat.py.
+#
+# Handle reading and writing JSON in UTF-8, on Python 3 and 2.
+
+if sys.version_info[0] >= 3:
+    # Python 3
+    def write_json(obj, path, **kwargs):
+        with open(path, 'w', encoding='utf-8') as f:
+            json.dump(obj, f, **kwargs)
+
+    def read_json(path):
+        with open(path, 'r', encoding='utf-8') as f:
+            return json.load(f)
+
+else:
+    # Python 2
+    def write_json(obj, path, **kwargs):
+        with open(path, 'wb') as f:
+            json.dump(obj, f, encoding='utf-8', **kwargs)
+
+    def read_json(path):
+        with open(path, 'rb') as f:
+            return json.load(f)
+
+
+class BackendUnavailable(Exception):
+    """Raised if we cannot import the backend"""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+class BackendInvalid(Exception):
+    """Raised if the backend is invalid"""
+    def __init__(self, message):
+        self.message = message
+
+
+class HookMissing(Exception):
+    """Raised if a hook is missing and we are not executing the fallback"""
+
+
+def contained_in(filename, directory):
+    """Test if a file is located within the given directory."""
+    filename = os.path.normcase(os.path.abspath(filename))
+    directory = os.path.normcase(os.path.abspath(directory))
+    return os.path.commonprefix([filename, directory]) == directory
+
+
+def _build_backend():
+    """Find and load the build backend"""
+    # Add in-tree backend directories to the front of sys.path.
+    backend_path = os.environ.get('PEP517_BACKEND_PATH')
+    if backend_path:
+        extra_pathitems = backend_path.split(os.pathsep)
+        sys.path[:0] = extra_pathitems
+
+    ep = os.environ['PEP517_BUILD_BACKEND']
+    mod_path, _, obj_path = ep.partition(':')
+    try:
+        obj = import_module(mod_path)
+    except ImportError:
+        raise BackendUnavailable(traceback.format_exc())
+
+    if backend_path:
+        if not any(
+            contained_in(obj.__file__, path)
+            for path in extra_pathitems
+        ):
+            raise BackendInvalid("Backend was not loaded from backend-path")
+
+    if obj_path:
+        for path_part in obj_path.split('.'):
+            obj = getattr(obj, path_part)
+    return obj
+
+
+def get_requires_for_build_wheel(config_settings):
+    """Invoke the optional get_requires_for_build_wheel hook
+
+    Returns [] if the hook is not defined.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.get_requires_for_build_wheel
+    except AttributeError:
+        return []
+    else:
+        return hook(config_settings)
+
+
+def prepare_metadata_for_build_wheel(
+        metadata_directory, config_settings, _allow_fallback):
+    """Invoke optional prepare_metadata_for_build_wheel
+
+    Implements a fallback by building a wheel if the hook isn't defined,
+    unless _allow_fallback is False in which case HookMissing is raised.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.prepare_metadata_for_build_wheel
+    except AttributeError:
+        if not _allow_fallback:
+            raise HookMissing()
+        return _get_wheel_metadata_from_wheel(backend, metadata_directory,
+                                              config_settings)
+    else:
+        return hook(metadata_directory, config_settings)
+
+
+WHEEL_BUILT_MARKER = 'PEP517_ALREADY_BUILT_WHEEL'
+
+
+def _dist_info_files(whl_zip):
+    """Identify the .dist-info folder inside a wheel ZipFile."""
+    res = []
+    for path in whl_zip.namelist():
+        m = re.match(r'[^/\\]+-[^/\\]+\.dist-info/', path)
+        if m:
+            res.append(path)
+    if res:
+        return res
+    raise Exception("No .dist-info folder found in wheel")
+
+
+def _get_wheel_metadata_from_wheel(
+        backend, metadata_directory, config_settings):
+    """Build a wheel and extract the metadata from it.
+
+    Fallback for when the build backend does not
+    define the 'get_wheel_metadata' hook.
+    """
+    from zipfile import ZipFile
+    whl_basename = backend.build_wheel(metadata_directory, config_settings)
+    with open(os.path.join(metadata_directory, WHEEL_BUILT_MARKER), 'wb'):
+        pass  # Touch marker file
+
+    whl_file = os.path.join(metadata_directory, whl_basename)
+    with ZipFile(whl_file) as zipf:
+        dist_info = _dist_info_files(zipf)
+        zipf.extractall(path=metadata_directory, members=dist_info)
+    return dist_info[0].split('/')[0]
+
+
+def _find_already_built_wheel(metadata_directory):
+    """Check for a wheel already built during the get_wheel_metadata hook.
+    """
+    if not metadata_directory:
+        return None
+    metadata_parent = os.path.dirname(metadata_directory)
+    if not os.path.isfile(pjoin(metadata_parent, WHEEL_BUILT_MARKER)):
+        return None
+
+    whl_files = glob(os.path.join(metadata_parent, '*.whl'))
+    if not whl_files:
+        print('Found wheel built marker, but no .whl files')
+        return None
+    if len(whl_files) > 1:
+        print('Found multiple .whl files; unspecified behaviour. '
+              'Will call build_wheel.')
+        return None
+
+    # Exactly one .whl file
+    return whl_files[0]
+
+
+def build_wheel(wheel_directory, config_settings, metadata_directory=None):
+    """Invoke the mandatory build_wheel hook.
+
+    If a wheel was already built in the
+    prepare_metadata_for_build_wheel fallback, this
+    will copy it rather than rebuilding the wheel.
+    """
+    prebuilt_whl = _find_already_built_wheel(metadata_directory)
+    if prebuilt_whl:
+        shutil.copy2(prebuilt_whl, wheel_directory)
+        return os.path.basename(prebuilt_whl)
+
+    return _build_backend().build_wheel(wheel_directory, config_settings,
+                                        metadata_directory)
+
+
+def get_requires_for_build_sdist(config_settings):
+    """Invoke the optional get_requires_for_build_wheel hook
+
+    Returns [] if the hook is not defined.
+    """
+    backend = _build_backend()
+    try:
+        hook = backend.get_requires_for_build_sdist
+    except AttributeError:
+        return []
+    else:
+        return hook(config_settings)
+
+
+class _DummyException(Exception):
+    """Nothing should ever raise this exception"""
+
+
+class GotUnsupportedOperation(Exception):
+    """For internal use when backend raises UnsupportedOperation"""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+def build_sdist(sdist_directory, config_settings):
+    """Invoke the mandatory build_sdist hook."""
+    backend = _build_backend()
+    try:
+        return backend.build_sdist(sdist_directory, config_settings)
+    except getattr(backend, 'UnsupportedOperation', _DummyException):
+        raise GotUnsupportedOperation(traceback.format_exc())
+
+
+HOOK_NAMES = {
+    'get_requires_for_build_wheel',
+    'prepare_metadata_for_build_wheel',
+    'build_wheel',
+    'get_requires_for_build_sdist',
+    'build_sdist',
+}
+
+
+def main():
+    if len(sys.argv) < 3:
+        sys.exit("Needs args: hook_name, control_dir")
+    hook_name = sys.argv[1]
+    control_dir = sys.argv[2]
+    if hook_name not in HOOK_NAMES:
+        sys.exit("Unknown hook: %s" % hook_name)
+    hook = globals()[hook_name]
+
+    hook_input = read_json(pjoin(control_dir, 'input.json'))
+
+    json_out = {'unsupported': False, 'return_val': None}
+    try:
+        json_out['return_val'] = hook(**hook_input['kwargs'])
+    except BackendUnavailable as e:
+        json_out['no_backend'] = True
+        json_out['traceback'] = e.traceback
+    except BackendInvalid as e:
+        json_out['backend_invalid'] = True
+        json_out['backend_error'] = e.message
+    except GotUnsupportedOperation as e:
+        json_out['unsupported'] = True
+        json_out['traceback'] = e.traceback
+    except HookMissing:
+        json_out['hook_missing'] = True
+
+    write_json(json_out, pjoin(control_dir, 'output.json'), indent=2)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/build.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/build.py
new file mode 100644
index 0000000000000000000000000000000000000000..7618c78c19b585066855085efb5917e865d88229
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/build.py
@@ -0,0 +1,124 @@
+"""Build a project using PEP 517 hooks.
+"""
+import argparse
+import logging
+import os
+import toml
+import shutil
+
+from .envbuild import BuildEnvironment
+from .wrappers import Pep517HookCaller
+from .dirtools import tempdir, mkdir_p
+from .compat import FileNotFoundError
+
+log = logging.getLogger(__name__)
+
+
+def validate_system(system):
+    """
+    Ensure build system has the requisite fields.
+    """
+    required = {'requires', 'build-backend'}
+    if not (required <= set(system)):
+        message = "Missing required fields: {missing}".format(
+            missing=required-set(system),
+        )
+        raise ValueError(message)
+
+
+def load_system(source_dir):
+    """
+    Load the build system from a source dir (pyproject.toml).
+    """
+    pyproject = os.path.join(source_dir, 'pyproject.toml')
+    with open(pyproject) as f:
+        pyproject_data = toml.load(f)
+    return pyproject_data['build-system']
+
+
+def compat_system(source_dir):
+    """
+    Given a source dir, attempt to get a build system backend
+    and requirements from pyproject.toml. Fallback to
+    setuptools but only if the file was not found or a build
+    system was not indicated.
+    """
+    try:
+        system = load_system(source_dir)
+    except (FileNotFoundError, KeyError):
+        system = {}
+    system.setdefault(
+        'build-backend',
+        'setuptools.build_meta:__legacy__',
+    )
+    system.setdefault('requires', ['setuptools', 'wheel'])
+    return system
+
+
+def _do_build(hooks, env, dist, dest):
+    get_requires_name = 'get_requires_for_build_{dist}'.format(**locals())
+    get_requires = getattr(hooks, get_requires_name)
+    reqs = get_requires({})
+    log.info('Got build requires: %s', reqs)
+
+    env.pip_install(reqs)
+    log.info('Installed dynamic build dependencies')
+
+    with tempdir() as td:
+        log.info('Trying to build %s in %s', dist, td)
+        build_name = 'build_{dist}'.format(**locals())
+        build = getattr(hooks, build_name)
+        filename = build(td, {})
+        source = os.path.join(td, filename)
+        shutil.move(source, os.path.join(dest, os.path.basename(filename)))
+
+
+def build(source_dir, dist, dest=None, system=None):
+    system = system or load_system(source_dir)
+    dest = os.path.join(source_dir, dest or 'dist')
+    mkdir_p(dest)
+
+    validate_system(system)
+    hooks = Pep517HookCaller(
+        source_dir, system['build-backend'], system.get('backend-path')
+    )
+
+    with BuildEnvironment() as env:
+        env.pip_install(system['requires'])
+        _do_build(hooks, env, dist, dest)
+
+
+parser = argparse.ArgumentParser()
+parser.add_argument(
+    'source_dir',
+    help="A directory containing pyproject.toml",
+)
+parser.add_argument(
+    '--binary', '-b',
+    action='store_true',
+    default=False,
+)
+parser.add_argument(
+    '--source', '-s',
+    action='store_true',
+    default=False,
+)
+parser.add_argument(
+    '--out-dir', '-o',
+    help="Destination in which to save the builds relative to source dir",
+)
+
+
+def main(args):
+    # determine which dists to build
+    dists = list(filter(None, (
+        'sdist' if args.source or not args.binary else None,
+        'wheel' if args.binary or not args.source else None,
+    )))
+
+    for dist in dists:
+        build(args.source_dir, dist, args.out_dir)
+
+
+if __name__ == '__main__':
+    main(parser.parse_args())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/check.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/check.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e0c0682096ea95b3dd3ae3e555a5982e9f1bdad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/check.py
@@ -0,0 +1,203 @@
+"""Check a project and backend by attempting to build using PEP 517 hooks.
+"""
+import argparse
+import logging
+import os
+from os.path import isfile, join as pjoin
+from toml import TomlDecodeError, load as toml_load
+import shutil
+from subprocess import CalledProcessError
+import sys
+import tarfile
+from tempfile import mkdtemp
+import zipfile
+
+from .colorlog import enable_colourful_output
+from .envbuild import BuildEnvironment
+from .wrappers import Pep517HookCaller
+
+log = logging.getLogger(__name__)
+
+
+def check_build_sdist(hooks, build_sys_requires):
+    with BuildEnvironment() as env:
+        try:
+            env.pip_install(build_sys_requires)
+            log.info('Installed static build dependencies')
+        except CalledProcessError:
+            log.error('Failed to install static build dependencies')
+            return False
+
+        try:
+            reqs = hooks.get_requires_for_build_sdist({})
+            log.info('Got build requires: %s', reqs)
+        except Exception:
+            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
+            return False
+
+        try:
+            env.pip_install(reqs)
+            log.info('Installed dynamic build dependencies')
+        except CalledProcessError:
+            log.error('Failed to install dynamic build dependencies')
+            return False
+
+        td = mkdtemp()
+        log.info('Trying to build sdist in %s', td)
+        try:
+            try:
+                filename = hooks.build_sdist(td, {})
+                log.info('build_sdist returned %r', filename)
+            except Exception:
+                log.info('Failure in build_sdist', exc_info=True)
+                return False
+
+            if not filename.endswith('.tar.gz'):
+                log.error(
+                    "Filename %s doesn't have .tar.gz extension", filename)
+                return False
+
+            path = pjoin(td, filename)
+            if isfile(path):
+                log.info("Output file %s exists", path)
+            else:
+                log.error("Output file %s does not exist", path)
+                return False
+
+            if tarfile.is_tarfile(path):
+                log.info("Output file is a tar file")
+            else:
+                log.error("Output file is not a tar file")
+                return False
+
+        finally:
+            shutil.rmtree(td)
+
+        return True
+
+
+def check_build_wheel(hooks, build_sys_requires):
+    with BuildEnvironment() as env:
+        try:
+            env.pip_install(build_sys_requires)
+            log.info('Installed static build dependencies')
+        except CalledProcessError:
+            log.error('Failed to install static build dependencies')
+            return False
+
+        try:
+            reqs = hooks.get_requires_for_build_wheel({})
+            log.info('Got build requires: %s', reqs)
+        except Exception:
+            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
+            return False
+
+        try:
+            env.pip_install(reqs)
+            log.info('Installed dynamic build dependencies')
+        except CalledProcessError:
+            log.error('Failed to install dynamic build dependencies')
+            return False
+
+        td = mkdtemp()
+        log.info('Trying to build wheel in %s', td)
+        try:
+            try:
+                filename = hooks.build_wheel(td, {})
+                log.info('build_wheel returned %r', filename)
+            except Exception:
+                log.info('Failure in build_wheel', exc_info=True)
+                return False
+
+            if not filename.endswith('.whl'):
+                log.error("Filename %s doesn't have .whl extension", filename)
+                return False
+
+            path = pjoin(td, filename)
+            if isfile(path):
+                log.info("Output file %s exists", path)
+            else:
+                log.error("Output file %s does not exist", path)
+                return False
+
+            if zipfile.is_zipfile(path):
+                log.info("Output file is a zip file")
+            else:
+                log.error("Output file is not a zip file")
+                return False
+
+        finally:
+            shutil.rmtree(td)
+
+        return True
+
+
+def check(source_dir):
+    pyproject = pjoin(source_dir, 'pyproject.toml')
+    if isfile(pyproject):
+        log.info('Found pyproject.toml')
+    else:
+        log.error('Missing pyproject.toml')
+        return False
+
+    try:
+        with open(pyproject) as f:
+            pyproject_data = toml_load(f)
+        # Ensure the mandatory data can be loaded
+        buildsys = pyproject_data['build-system']
+        requires = buildsys['requires']
+        backend = buildsys['build-backend']
+        backend_path = buildsys.get('backend-path')
+        log.info('Loaded pyproject.toml')
+    except (TomlDecodeError, KeyError):
+        log.error("Invalid pyproject.toml", exc_info=True)
+        return False
+
+    hooks = Pep517HookCaller(source_dir, backend, backend_path)
+
+    sdist_ok = check_build_sdist(hooks, requires)
+    wheel_ok = check_build_wheel(hooks, requires)
+
+    if not sdist_ok:
+        log.warning('Sdist checks failed; scroll up to see')
+    if not wheel_ok:
+        log.warning('Wheel checks failed')
+
+    return sdist_ok
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser()
+    ap.add_argument(
+        'source_dir',
+        help="A directory containing pyproject.toml")
+    args = ap.parse_args(argv)
+
+    enable_colourful_output()
+
+    ok = check(args.source_dir)
+
+    if ok:
+        print(ansi('Checks passed', 'green'))
+    else:
+        print(ansi('Checks failed', 'red'))
+        sys.exit(1)
+
+
+ansi_codes = {
+    'reset': '\x1b[0m',
+    'bold': '\x1b[1m',
+    'red': '\x1b[31m',
+    'green': '\x1b[32m',
+}
+
+
+def ansi(s, attr):
+    if os.name != 'nt' and sys.stdout.isatty():
+        return ansi_codes[attr] + str(s) + ansi_codes['reset']
+    else:
+        return str(s)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/colorlog.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/colorlog.py
new file mode 100644
index 0000000000000000000000000000000000000000..69c8a59d3d4e038450aa37ec5b801914b817e675
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/colorlog.py
@@ -0,0 +1,115 @@
+"""Nicer log formatting with colours.
+
+Code copied from Tornado, Apache licensed.
+"""
+# Copyright 2012 Facebook
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+import logging
+import sys
+
+try:
+    import curses
+except ImportError:
+    curses = None
+
+
+def _stderr_supports_color():
+    color = False
+    if curses and hasattr(sys.stderr, 'isatty') and sys.stderr.isatty():
+        try:
+            curses.setupterm()
+            if curses.tigetnum("colors") > 0:
+                color = True
+        except Exception:
+            pass
+    return color
+
+
+class LogFormatter(logging.Formatter):
+    """Log formatter with colour support
+    """
+    DEFAULT_COLORS = {
+        logging.INFO: 2,  # Green
+        logging.WARNING: 3,  # Yellow
+        logging.ERROR: 1,  # Red
+        logging.CRITICAL: 1,
+    }
+
+    def __init__(self, color=True, datefmt=None):
+        r"""
+        :arg bool color: Enables color support.
+        :arg string fmt: Log message format.
+        It will be applied to the attributes dict of log records. The
+        text between ``%(color)s`` and ``%(end_color)s`` will be colored
+        depending on the level if color support is on.
+        :arg dict colors: color mappings from logging level to terminal color
+        code
+        :arg string datefmt: Datetime format.
+        Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``.
+        .. versionchanged:: 3.2
+        Added ``fmt`` and ``datefmt`` arguments.
+        """
+        logging.Formatter.__init__(self, datefmt=datefmt)
+        self._colors = {}
+        if color and _stderr_supports_color():
+            # The curses module has some str/bytes confusion in
+            # python3. Until version 3.2.3, most methods return
+            # bytes, but only accept strings. In addition, we want to
+            # output these strings with the logging module, which
+            # works with unicode strings. The explicit calls to
+            # unicode() below are harmless in python2 but will do the
+            # right conversion in python 3.
+            fg_color = (curses.tigetstr("setaf") or
+                        curses.tigetstr("setf") or "")
+            if (3, 0) < sys.version_info < (3, 2, 3):
+                fg_color = str(fg_color, "ascii")
+
+            for levelno, code in self.DEFAULT_COLORS.items():
+                self._colors[levelno] = str(
+                    curses.tparm(fg_color, code), "ascii")
+            self._normal = str(curses.tigetstr("sgr0"), "ascii")
+
+            scr = curses.initscr()
+            self.termwidth = scr.getmaxyx()[1]
+            curses.endwin()
+        else:
+            self._normal = ''
+            # Default width is usually 80, but too wide is
+            # worse than too narrow
+            self.termwidth = 70
+
+    def formatMessage(self, record):
+        mlen = len(record.message)
+        right_text = '{initial}-{name}'.format(initial=record.levelname[0],
+                                               name=record.name)
+        if mlen + len(right_text) < self.termwidth:
+            space = ' ' * (self.termwidth - (mlen + len(right_text)))
+        else:
+            space = '  '
+
+        if record.levelno in self._colors:
+            start_color = self._colors[record.levelno]
+            end_color = self._normal
+        else:
+            start_color = end_color = ''
+
+        return record.message + space + start_color + right_text + end_color
+
+
+def enable_colourful_output(level=logging.INFO):
+    handler = logging.StreamHandler()
+    handler.setFormatter(LogFormatter())
+    logging.root.addHandler(handler)
+    logging.root.setLevel(level)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..8432acb7324db7c3f26c764a584012849b6c88bb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/compat.py
@@ -0,0 +1,34 @@
+"""Python 2/3 compatibility"""
+import json
+import sys
+
+
+# Handle reading and writing JSON in UTF-8, on Python 3 and 2.
+
+if sys.version_info[0] >= 3:
+    # Python 3
+    def write_json(obj, path, **kwargs):
+        with open(path, 'w', encoding='utf-8') as f:
+            json.dump(obj, f, **kwargs)
+
+    def read_json(path):
+        with open(path, 'r', encoding='utf-8') as f:
+            return json.load(f)
+
+else:
+    # Python 2
+    def write_json(obj, path, **kwargs):
+        with open(path, 'wb') as f:
+            json.dump(obj, f, encoding='utf-8', **kwargs)
+
+    def read_json(path):
+        with open(path, 'rb') as f:
+            return json.load(f)
+
+
+# FileNotFoundError
+
+try:
+    FileNotFoundError = FileNotFoundError
+except NameError:
+    FileNotFoundError = IOError
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/dirtools.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/dirtools.py
new file mode 100644
index 0000000000000000000000000000000000000000..58c6ca0c56bcafe43497f4a598977b27cb5e7d23
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/dirtools.py
@@ -0,0 +1,44 @@
+import os
+import io
+import contextlib
+import tempfile
+import shutil
+import errno
+import zipfile
+
+
+@contextlib.contextmanager
+def tempdir():
+    """Create a temporary directory in a context manager."""
+    td = tempfile.mkdtemp()
+    try:
+        yield td
+    finally:
+        shutil.rmtree(td)
+
+
+def mkdir_p(*args, **kwargs):
+    """Like `mkdir`, but does not raise an exception if the
+    directory already exists.
+    """
+    try:
+        return os.mkdir(*args, **kwargs)
+    except OSError as exc:
+        if exc.errno != errno.EEXIST:
+            raise
+
+
+def dir_to_zipfile(root):
+    """Construct an in-memory zip file for a directory."""
+    buffer = io.BytesIO()
+    zip_file = zipfile.ZipFile(buffer, 'w')
+    for root, dirs, files in os.walk(root):
+        for path in dirs:
+            fs_path = os.path.join(root, path)
+            rel_path = os.path.relpath(fs_path, root)
+            zip_file.writestr(rel_path + '/', '')
+        for path in files:
+            fs_path = os.path.join(root, path)
+            rel_path = os.path.relpath(fs_path, root)
+            zip_file.write(fs_path, rel_path)
+    return zip_file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/envbuild.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/envbuild.py
new file mode 100644
index 0000000000000000000000000000000000000000..cacd2b12c010cc61b6fb2af4d336994ee2f1f384
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/envbuild.py
@@ -0,0 +1,167 @@
+"""Build wheels/sdists by installing build deps to a temporary environment.
+"""
+
+import os
+import logging
+import toml
+import shutil
+from subprocess import check_call
+import sys
+from sysconfig import get_paths
+from tempfile import mkdtemp
+
+from .wrappers import Pep517HookCaller, LoggerWrapper
+
+log = logging.getLogger(__name__)
+
+
+def _load_pyproject(source_dir):
+    with open(os.path.join(source_dir, 'pyproject.toml')) as f:
+        pyproject_data = toml.load(f)
+    buildsys = pyproject_data['build-system']
+    return (
+        buildsys['requires'],
+        buildsys['build-backend'],
+        buildsys.get('backend-path'),
+    )
+
+
+class BuildEnvironment(object):
+    """Context manager to install build deps in a simple temporary environment
+
+    Based on code I wrote for pip, which is MIT licensed.
+    """
+    # Copyright (c) 2008-2016 The pip developers (see AUTHORS.txt file)
+    #
+    # Permission is hereby granted, free of charge, to any person obtaining
+    # a copy of this software and associated documentation files (the
+    # "Software"), to deal in the Software without restriction, including
+    # without limitation the rights to use, copy, modify, merge, publish,
+    # distribute, sublicense, and/or sell copies of the Software, and to
+    # permit persons to whom the Software is furnished to do so, subject to
+    # the following conditions:
+    #
+    # The above copyright notice and this permission notice shall be
+    # included in all copies or substantial portions of the Software.
+    #
+    # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+    # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+    # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+    path = None
+
+    def __init__(self, cleanup=True):
+        self._cleanup = cleanup
+
+    def __enter__(self):
+        self.path = mkdtemp(prefix='pep517-build-env-')
+        log.info('Temporary build environment: %s', self.path)
+
+        self.save_path = os.environ.get('PATH', None)
+        self.save_pythonpath = os.environ.get('PYTHONPATH', None)
+
+        install_scheme = 'nt' if (os.name == 'nt') else 'posix_prefix'
+        install_dirs = get_paths(install_scheme, vars={
+            'base': self.path,
+            'platbase': self.path,
+        })
+
+        scripts = install_dirs['scripts']
+        if self.save_path:
+            os.environ['PATH'] = scripts + os.pathsep + self.save_path
+        else:
+            os.environ['PATH'] = scripts + os.pathsep + os.defpath
+
+        if install_dirs['purelib'] == install_dirs['platlib']:
+            lib_dirs = install_dirs['purelib']
+        else:
+            lib_dirs = install_dirs['purelib'] + os.pathsep + \
+                install_dirs['platlib']
+        if self.save_pythonpath:
+            os.environ['PYTHONPATH'] = lib_dirs + os.pathsep + \
+                self.save_pythonpath
+        else:
+            os.environ['PYTHONPATH'] = lib_dirs
+
+        return self
+
+    def pip_install(self, reqs):
+        """Install dependencies into this env by calling pip in a subprocess"""
+        if not reqs:
+            return
+        log.info('Calling pip to install %s', reqs)
+        cmd = [
+            sys.executable, '-m', 'pip', 'install', '--ignore-installed',
+            '--prefix', self.path] + list(reqs)
+        check_call(
+            cmd,
+            stdout=LoggerWrapper(log, logging.INFO),
+            stderr=LoggerWrapper(log, logging.ERROR),
+        )
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        needs_cleanup = (
+            self._cleanup and
+            self.path is not None and
+            os.path.isdir(self.path)
+        )
+        if needs_cleanup:
+            shutil.rmtree(self.path)
+
+        if self.save_path is None:
+            os.environ.pop('PATH', None)
+        else:
+            os.environ['PATH'] = self.save_path
+
+        if self.save_pythonpath is None:
+            os.environ.pop('PYTHONPATH', None)
+        else:
+            os.environ['PYTHONPATH'] = self.save_pythonpath
+
+
+def build_wheel(source_dir, wheel_dir, config_settings=None):
+    """Build a wheel from a source directory using PEP 517 hooks.
+
+    :param str source_dir: Source directory containing pyproject.toml
+    :param str wheel_dir: Target directory to create wheel in
+    :param dict config_settings: Options to pass to build backend
+
+    This is a blocking function which will run pip in a subprocess to install
+    build requirements.
+    """
+    if config_settings is None:
+        config_settings = {}
+    requires, backend, backend_path = _load_pyproject(source_dir)
+    hooks = Pep517HookCaller(source_dir, backend, backend_path)
+
+    with BuildEnvironment() as env:
+        env.pip_install(requires)
+        reqs = hooks.get_requires_for_build_wheel(config_settings)
+        env.pip_install(reqs)
+        return hooks.build_wheel(wheel_dir, config_settings)
+
+
+def build_sdist(source_dir, sdist_dir, config_settings=None):
+    """Build an sdist from a source directory using PEP 517 hooks.
+
+    :param str source_dir: Source directory containing pyproject.toml
+    :param str sdist_dir: Target directory to place sdist in
+    :param dict config_settings: Options to pass to build backend
+
+    This is a blocking function which will run pip in a subprocess to install
+    build requirements.
+    """
+    if config_settings is None:
+        config_settings = {}
+    requires, backend, backend_path = _load_pyproject(source_dir)
+    hooks = Pep517HookCaller(source_dir, backend, backend_path)
+
+    with BuildEnvironment() as env:
+        env.pip_install(requires)
+        reqs = hooks.get_requires_for_build_sdist(config_settings)
+        env.pip_install(reqs)
+        return hooks.build_sdist(sdist_dir, config_settings)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/meta.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..d525de5c6c8791def8dbb2f460027e200c934874
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/meta.py
@@ -0,0 +1,92 @@
+"""Build metadata for a project using PEP 517 hooks.
+"""
+import argparse
+import logging
+import os
+import shutil
+import functools
+
+try:
+    import importlib.metadata as imp_meta
+except ImportError:
+    import importlib_metadata as imp_meta
+
+try:
+    from zipfile import Path
+except ImportError:
+    from zipp import Path
+
+from .envbuild import BuildEnvironment
+from .wrappers import Pep517HookCaller, quiet_subprocess_runner
+from .dirtools import tempdir, mkdir_p, dir_to_zipfile
+from .build import validate_system, load_system, compat_system
+
+log = logging.getLogger(__name__)
+
+
+def _prep_meta(hooks, env, dest):
+    reqs = hooks.get_requires_for_build_wheel({})
+    log.info('Got build requires: %s', reqs)
+
+    env.pip_install(reqs)
+    log.info('Installed dynamic build dependencies')
+
+    with tempdir() as td:
+        log.info('Trying to build metadata in %s', td)
+        filename = hooks.prepare_metadata_for_build_wheel(td, {})
+        source = os.path.join(td, filename)
+        shutil.move(source, os.path.join(dest, os.path.basename(filename)))
+
+
+def build(source_dir='.', dest=None, system=None):
+    system = system or load_system(source_dir)
+    dest = os.path.join(source_dir, dest or 'dist')
+    mkdir_p(dest)
+    validate_system(system)
+    hooks = Pep517HookCaller(
+        source_dir, system['build-backend'], system.get('backend-path')
+    )
+
+    with hooks.subprocess_runner(quiet_subprocess_runner):
+        with BuildEnvironment() as env:
+            env.pip_install(system['requires'])
+            _prep_meta(hooks, env, dest)
+
+
+def build_as_zip(builder=build):
+    with tempdir() as out_dir:
+        builder(dest=out_dir)
+        return dir_to_zipfile(out_dir)
+
+
+def load(root):
+    """
+    Given a source directory (root) of a package,
+    return an importlib.metadata.Distribution object
+    with metadata build from that package.
+    """
+    root = os.path.expanduser(root)
+    system = compat_system(root)
+    builder = functools.partial(build, source_dir=root, system=system)
+    path = Path(build_as_zip(builder))
+    return imp_meta.PathDistribution(path)
+
+
+parser = argparse.ArgumentParser()
+parser.add_argument(
+    'source_dir',
+    help="A directory containing pyproject.toml",
+)
+parser.add_argument(
+    '--out-dir', '-o',
+    help="Destination in which to save the builds relative to source dir",
+)
+
+
+def main():
+    args = parser.parse_args()
+    build(args.source_dir, args.out_dir)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/wrappers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/wrappers.py
new file mode 100644
index 0000000000000000000000000000000000000000..00a3d1a789ffee002efec8592600ad9afa1b9171
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pep517/wrappers.py
@@ -0,0 +1,308 @@
+import threading
+from contextlib import contextmanager
+import os
+from os.path import dirname, abspath, join as pjoin
+import shutil
+from subprocess import check_call, check_output, STDOUT
+import sys
+from tempfile import mkdtemp
+
+from . import compat
+
+
+try:
+    import importlib.resources as resources
+
+    def _in_proc_script_path():
+        return resources.path(__package__, '_in_process.py')
+except ImportError:
+    @contextmanager
+    def _in_proc_script_path():
+        yield pjoin(dirname(abspath(__file__)), '_in_process.py')
+
+
+@contextmanager
+def tempdir():
+    td = mkdtemp()
+    try:
+        yield td
+    finally:
+        shutil.rmtree(td)
+
+
+class BackendUnavailable(Exception):
+    """Will be raised if the backend cannot be imported in the hook process."""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+class BackendInvalid(Exception):
+    """Will be raised if the backend is invalid."""
+    def __init__(self, backend_name, backend_path, message):
+        self.backend_name = backend_name
+        self.backend_path = backend_path
+        self.message = message
+
+
+class HookMissing(Exception):
+    """Will be raised on missing hooks."""
+    def __init__(self, hook_name):
+        super(HookMissing, self).__init__(hook_name)
+        self.hook_name = hook_name
+
+
+class UnsupportedOperation(Exception):
+    """May be raised by build_sdist if the backend indicates that it can't."""
+    def __init__(self, traceback):
+        self.traceback = traceback
+
+
+def default_subprocess_runner(cmd, cwd=None, extra_environ=None):
+    """The default method of calling the wrapper subprocess."""
+    env = os.environ.copy()
+    if extra_environ:
+        env.update(extra_environ)
+
+    check_call(cmd, cwd=cwd, env=env)
+
+
+def quiet_subprocess_runner(cmd, cwd=None, extra_environ=None):
+    """A method of calling the wrapper subprocess while suppressing output."""
+    env = os.environ.copy()
+    if extra_environ:
+        env.update(extra_environ)
+
+    check_output(cmd, cwd=cwd, env=env, stderr=STDOUT)
+
+
+def norm_and_check(source_tree, requested):
+    """Normalise and check a backend path.
+
+    Ensure that the requested backend path is specified as a relative path,
+    and resolves to a location under the given source tree.
+
+    Return an absolute version of the requested path.
+    """
+    if os.path.isabs(requested):
+        raise ValueError("paths must be relative")
+
+    abs_source = os.path.abspath(source_tree)
+    abs_requested = os.path.normpath(os.path.join(abs_source, requested))
+    # We have to use commonprefix for Python 2.7 compatibility. So we
+    # normalise case to avoid problems because commonprefix is a character
+    # based comparison :-(
+    norm_source = os.path.normcase(abs_source)
+    norm_requested = os.path.normcase(abs_requested)
+    if os.path.commonprefix([norm_source, norm_requested]) != norm_source:
+        raise ValueError("paths must be inside source tree")
+
+    return abs_requested
+
+
+class Pep517HookCaller(object):
+    """A wrapper around a source directory to be built with a PEP 517 backend.
+
+    source_dir : The path to the source directory, containing pyproject.toml.
+    build_backend : The build backend spec, as per PEP 517, from
+        pyproject.toml.
+    backend_path : The backend path, as per PEP 517, from pyproject.toml.
+    runner : A callable that invokes the wrapper subprocess.
+
+    The 'runner', if provided, must expect the following:
+        cmd : a list of strings representing the command and arguments to
+            execute, as would be passed to e.g. 'subprocess.check_call'.
+        cwd : a string representing the working directory that must be
+            used for the subprocess. Corresponds to the provided source_dir.
+        extra_environ : a dict mapping environment variable names to values
+            which must be set for the subprocess execution.
+    """
+    def __init__(
+            self,
+            source_dir,
+            build_backend,
+            backend_path=None,
+            runner=None,
+    ):
+        if runner is None:
+            runner = default_subprocess_runner
+
+        self.source_dir = abspath(source_dir)
+        self.build_backend = build_backend
+        if backend_path:
+            backend_path = [
+                norm_and_check(self.source_dir, p) for p in backend_path
+            ]
+        self.backend_path = backend_path
+        self._subprocess_runner = runner
+
+    @contextmanager
+    def subprocess_runner(self, runner):
+        """A context manager for temporarily overriding the default subprocess
+        runner.
+        """
+        prev = self._subprocess_runner
+        self._subprocess_runner = runner
+        try:
+            yield
+        finally:
+            self._subprocess_runner = prev
+
+    def get_requires_for_build_wheel(self, config_settings=None):
+        """Identify packages required for building a wheel
+
+        Returns a list of dependency specifications, e.g.:
+            ["wheel >= 0.25", "setuptools"]
+
+        This does not include requirements specified in pyproject.toml.
+        It returns the result of calling the equivalently named hook in a
+        subprocess.
+        """
+        return self._call_hook('get_requires_for_build_wheel', {
+            'config_settings': config_settings
+        })
+
+    def prepare_metadata_for_build_wheel(
+            self, metadata_directory, config_settings=None,
+            _allow_fallback=True):
+        """Prepare a *.dist-info folder with metadata for this project.
+
+        Returns the name of the newly created folder.
+
+        If the build backend defines a hook with this name, it will be called
+        in a subprocess. If not, the backend will be asked to build a wheel,
+        and the dist-info extracted from that (unless _allow_fallback is
+        False).
+        """
+        return self._call_hook('prepare_metadata_for_build_wheel', {
+            'metadata_directory': abspath(metadata_directory),
+            'config_settings': config_settings,
+            '_allow_fallback': _allow_fallback,
+        })
+
+    def build_wheel(
+            self, wheel_directory, config_settings=None,
+            metadata_directory=None):
+        """Build a wheel from this project.
+
+        Returns the name of the newly created file.
+
+        In general, this will call the 'build_wheel' hook in the backend.
+        However, if that was previously called by
+        'prepare_metadata_for_build_wheel', and the same metadata_directory is
+        used, the previously built wheel will be copied to wheel_directory.
+        """
+        if metadata_directory is not None:
+            metadata_directory = abspath(metadata_directory)
+        return self._call_hook('build_wheel', {
+            'wheel_directory': abspath(wheel_directory),
+            'config_settings': config_settings,
+            'metadata_directory': metadata_directory,
+        })
+
+    def get_requires_for_build_sdist(self, config_settings=None):
+        """Identify packages required for building a wheel
+
+        Returns a list of dependency specifications, e.g.:
+            ["setuptools >= 26"]
+
+        This does not include requirements specified in pyproject.toml.
+        It returns the result of calling the equivalently named hook in a
+        subprocess.
+        """
+        return self._call_hook('get_requires_for_build_sdist', {
+            'config_settings': config_settings
+        })
+
+    def build_sdist(self, sdist_directory, config_settings=None):
+        """Build an sdist from this project.
+
+        Returns the name of the newly created file.
+
+        This calls the 'build_sdist' backend hook in a subprocess.
+        """
+        return self._call_hook('build_sdist', {
+            'sdist_directory': abspath(sdist_directory),
+            'config_settings': config_settings,
+        })
+
+    def _call_hook(self, hook_name, kwargs):
+        # On Python 2, pytoml returns Unicode values (which is correct) but the
+        # environment passed to check_call needs to contain string values. We
+        # convert here by encoding using ASCII (the backend can only contain
+        # letters, digits and _, . and : characters, and will be used as a
+        # Python identifier, so non-ASCII content is wrong on Python 2 in
+        # any case).
+        # For backend_path, we use sys.getfilesystemencoding.
+        if sys.version_info[0] == 2:
+            build_backend = self.build_backend.encode('ASCII')
+        else:
+            build_backend = self.build_backend
+        extra_environ = {'PEP517_BUILD_BACKEND': build_backend}
+
+        if self.backend_path:
+            backend_path = os.pathsep.join(self.backend_path)
+            if sys.version_info[0] == 2:
+                backend_path = backend_path.encode(sys.getfilesystemencoding())
+            extra_environ['PEP517_BACKEND_PATH'] = backend_path
+
+        with tempdir() as td:
+            hook_input = {'kwargs': kwargs}
+            compat.write_json(hook_input, pjoin(td, 'input.json'),
+                              indent=2)
+
+            # Run the hook in a subprocess
+            with _in_proc_script_path() as script:
+                self._subprocess_runner(
+                    [sys.executable, str(script), hook_name, td],
+                    cwd=self.source_dir,
+                    extra_environ=extra_environ
+                )
+
+            data = compat.read_json(pjoin(td, 'output.json'))
+            if data.get('unsupported'):
+                raise UnsupportedOperation(data.get('traceback', ''))
+            if data.get('no_backend'):
+                raise BackendUnavailable(data.get('traceback', ''))
+            if data.get('backend_invalid'):
+                raise BackendInvalid(
+                    backend_name=self.build_backend,
+                    backend_path=self.backend_path,
+                    message=data.get('backend_error', '')
+                )
+            if data.get('hook_missing'):
+                raise HookMissing(hook_name)
+            return data['return_val']
+
+
+class LoggerWrapper(threading.Thread):
+    """
+    Read messages from a pipe and redirect them
+    to a logger (see python's logging module).
+    """
+
+    def __init__(self, logger, level):
+        threading.Thread.__init__(self)
+        self.daemon = True
+
+        self.logger = logger
+        self.level = level
+
+        # create the pipe and reader
+        self.fd_read, self.fd_write = os.pipe()
+        self.reader = os.fdopen(self.fd_read)
+
+        self.start()
+
+    def fileno(self):
+        return self.fd_write
+
+    @staticmethod
+    def remove_newline(msg):
+        return msg[:-1] if msg.endswith(os.linesep) else msg
+
+    def run(self):
+        for line in self.reader:
+            self._write(self.remove_newline(line))
+
+    def _write(self, message):
+        self.logger.log(self.level, message)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..5183c4e68338e1f31d47c924c974b5d85f917770
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/METADATA
@@ -0,0 +1,84 @@
+Metadata-Version: 2.1
+Name: pip
+Version: 20.0.2
+Summary: The PyPA recommended tool for installing Python packages.
+Home-page: https://pip.pypa.io/
+Author: The pip developers
+Author-email: pypa-dev@groups.google.com
+License: MIT
+Project-URL: Documentation, https://pip.pypa.io
+Project-URL: Source, https://github.com/pypa/pip
+Keywords: distutils easy_install egg setuptools wheel virtualenv
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*
+
+pip - The Python Package Installer
+==================================
+
+.. image:: https://img.shields.io/pypi/v/pip.svg
+   :target: https://pypi.org/project/pip/
+
+.. image:: https://readthedocs.org/projects/pip/badge/?version=latest
+   :target: https://pip.pypa.io/en/latest
+
+pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes.
+
+Please take a look at our documentation for how to install and use pip:
+
+* `Installation`_
+* `Usage`_
+
+Updates are released regularly, with a new version every 3 months. More details can be found in our documentation:
+
+* `Release notes`_
+* `Release process`_
+
+If you find bugs, need help, or want to talk to the developers please use our mailing lists or chat rooms:
+
+* `Issue tracking`_
+* `Discourse channel`_
+* `User IRC`_
+
+If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms:
+
+* `GitHub page`_
+* `Dev documentation`_
+* `Dev mailing list`_
+* `Dev IRC`_
+
+Code of Conduct
+---------------
+
+Everyone interacting in the pip project's codebases, issue trackers, chat
+rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
+
+.. _package installer: https://packaging.python.org/guides/tool-recommendations/
+.. _Python Package Index: https://pypi.org
+.. _Installation: https://pip.pypa.io/en/stable/installing.html
+.. _Usage: https://pip.pypa.io/en/stable/
+.. _Release notes: https://pip.pypa.io/en/stable/news.html
+.. _Release process: https://pip.pypa.io/en/latest/development/release-process/
+.. _GitHub page: https://github.com/pypa/pip
+.. _Dev documentation: https://pip.pypa.io/en/latest/development
+.. _Issue tracking: https://github.com/pypa/pip/issues
+.. _Discourse channel: https://discuss.python.org/c/packaging
+.. _Dev mailing list: https://groups.google.com/forum/#!forum/pypa-dev
+.. _User IRC: https://webchat.freenode.net/?channels=%23pypa
+.. _Dev IRC: https://webchat.freenode.net/?channels=%23pypa-dev
+.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..894e7f3511b570f482bedab9ce6a90f2cec988c5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/RECORD
@@ -0,0 +1,264 @@
+pip/__init__.py,sha256=U1AM82iShMaw90K6Yq0Q2-AZ1EsOcqQLQRB-rxwFtII,455
+pip/__main__.py,sha256=NM95x7KuQr-lwPoTjAC0d_QzLJsJjpmAoxZg0mP8s98,632
+pip/_internal/__init__.py,sha256=j5fiII6yCeZjpW7_7wAVRMM4DwE-gyARGVU4yAADDeE,517
+pip/_internal/build_env.py,sha256=--aNgzIdYrCOclHMwoAdpclCpfdFE_jooRuCy5gczwg,7532
+pip/_internal/cache.py,sha256=16GrnDRLBQNlfKWIuIF6Sa-EFS78kez_w1WEjT3ykTI,11605
+pip/_internal/configuration.py,sha256=MgKrLFBJBkF3t2VJM4tvlnEspfSuS4scp_LhHWh53nY,14222
+pip/_internal/exceptions.py,sha256=6YRuwXAK6F1iyUWKIkCIpWWN2khkAn1sZOgrFA9S8Ro,10247
+pip/_internal/legacy_resolve.py,sha256=L7R72I7CjVgJlPTggmA1j4b-H8NmxNu_dKVhrpGXGps,16277
+pip/_internal/locations.py,sha256=VifFEqhc7FWFV8QGoEM3CpECRY8Doq7kTytytxsEgx0,6734
+pip/_internal/main.py,sha256=IVBnUQ-FG7DK6617uEXRB5_QJqspAsBFmTmTesYkbdQ,437
+pip/_internal/pep425tags.py,sha256=SlIQokevkoKnXhoK3PZvXiDoj8hFKoJ7thDifDtga3k,5490
+pip/_internal/pyproject.py,sha256=kB966ZCSxiZQRa3W2RXN9as5pRuKW6Elnb4xdqDxASg,7404
+pip/_internal/self_outdated_check.py,sha256=3KO1pTJUuYaiV9X0t87I9PimkGL82HbhLWbocqKZpBU,8009
+pip/_internal/wheel_builder.py,sha256=gr9jE14W5ZuYblpldo-tpRuyG0e0AVmHLttImuAvXlE,9441
+pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132
+pip/_internal/cli/autocompletion.py,sha256=ekGNtcDI0p7rFVc-7s4T9Tbss4Jgb7vsB649XJIblRg,6547
+pip/_internal/cli/base_command.py,sha256=v6yl5XNRqye8BT9ep8wvpMu6lylP_Hu6D95r_HqbpbQ,7948
+pip/_internal/cli/cmdoptions.py,sha256=f1TVHuu_fR3lLlMo6b367H_GsWFv26tLI9cAS-kZfE0,28114
+pip/_internal/cli/command_context.py,sha256=ygMVoTy2jpNilKT-6416gFSQpaBtrKRBbVbi2fy__EU,975
+pip/_internal/cli/main.py,sha256=8iq3bHe5lxJTB2EvKOqZ38NS0MmoS79_S1kgj4QuH8A,2610
+pip/_internal/cli/main_parser.py,sha256=W9OWeryh7ZkqELohaFh0Ko9sB98ZkSeDmnYbOZ1imBc,2819
+pip/_internal/cli/parser.py,sha256=O9djTuYQuSfObiY-NU6p4MJCfWsRUnDpE2YGA_fwols,9487
+pip/_internal/cli/req_command.py,sha256=pAUAglpTn0mUA6lRs7KN71yOm1KDabD0ySVTQTqWTSA,12463
+pip/_internal/cli/status_codes.py,sha256=F6uDG6Gj7RNKQJUDnd87QKqI16Us-t-B0wPF_4QMpWc,156
+pip/_internal/commands/__init__.py,sha256=uTSj58QlrSKeXqCUSdL-eAf_APzx5BHy1ABxb0j5ZNE,3714
+pip/_internal/commands/check.py,sha256=mgLNYT3bd6Kmynwh4zzcBmVlFZ-urMo40jTgk6U405E,1505
+pip/_internal/commands/completion.py,sha256=UFQvq0Q4_B96z1bvnQyMOq82aPSu05RejbLmqeTZjC0,2975
+pip/_internal/commands/configuration.py,sha256=6riioZjMhsNSEct7dE-X8SobGodk3WERKJvuyjBje4Q,7226
+pip/_internal/commands/debug.py,sha256=a8llax2hRkxgK-tvwdJgaCaZCYPIx0fDvrlMDoYr8bQ,4209
+pip/_internal/commands/download.py,sha256=zX_0-IeFb4C8dxSmGHxk-6H5kehtyTSsdWpjNpAhSww,5007
+pip/_internal/commands/freeze.py,sha256=QS-4ib8jbKJ2wrDaDbTuyaB3Y_iJ5CQC2gAVHuAv9QU,3481
+pip/_internal/commands/hash.py,sha256=47teimfAPhpkaVbSDaafck51BT3XXYuL83lAqc5lOcE,1735
+pip/_internal/commands/help.py,sha256=Nhecq--ydFn80Gm1Zvbf9943EcRJfO0TnXUhsF0RO7s,1181
+pip/_internal/commands/install.py,sha256=T4P3J1rw7CQrZX4OUamtcoWMkTrJBfUe6gWpTfZW1bQ,27286
+pip/_internal/commands/list.py,sha256=2l0JiqHxjxDHNTCb2HZOjwwdo4duS1R0MsqZb6HSMKk,10660
+pip/_internal/commands/search.py,sha256=7Il8nKZ9mM7qF5jlnBoPvSIFY9f-0-5IbYoX3miTuZY,5148
+pip/_internal/commands/show.py,sha256=Vzsj2oX0JBl94MPyF3LV8YoMcigl8B2UsMM8zp0pH2s,6792
+pip/_internal/commands/uninstall.py,sha256=8mldFbrQecSoWDZRqxBgJkrlvx6Y9Iy7cs-2BIgtXt4,2983
+pip/_internal/commands/wheel.py,sha256=TMU5ZhjLo7BIZQApGPsYfoCsbGTnvP-N9jkgPJXhj1Y,7170
+pip/_internal/distributions/__init__.py,sha256=ECBUW5Gtu9TjJwyFLvim-i6kUMYVuikNh9I5asL6tbA,959
+pip/_internal/distributions/base.py,sha256=ruprpM_L2T2HNi3KLUHlbHimZ1sWVw-3Q0Lb8O7TDAI,1425
+pip/_internal/distributions/installed.py,sha256=YqlkBKr6TVP1MAYS6SG8ojud21wVOYLMZ8jMLJe9MSU,760
+pip/_internal/distributions/sdist.py,sha256=D4XTMlCwgPlK69l62GLYkNSVTVe99fR5iAcVt2EbGok,4086
+pip/_internal/distributions/wheel.py,sha256=95uD-TfaYoq3KiKBdzk9YMN4RRqJ28LNoSTS2K46gek,1294
+pip/_internal/index/__init__.py,sha256=vpt-JeTZefh8a-FC22ZeBSXFVbuBcXSGiILhQZJaNpQ,30
+pip/_internal/index/collector.py,sha256=YS7Ix4oylU7ZbPTPFugh-244GSRqMvdHsGUG6nmz2gE,17892
+pip/_internal/index/package_finder.py,sha256=2Rg75AOpLj8BN1jyL8EI-Iw-Hv6ibJkrYVARCht3bX8,37542
+pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63
+pip/_internal/models/candidate.py,sha256=Y58Bcm6oXUj0iS-yhmerlGo5CQJI2p0Ww9h6hR9zQDw,1150
+pip/_internal/models/format_control.py,sha256=ICzVjjGwfZYdX-eLLKHjMHLutEJlAGpfj09OG_eMqac,2673
+pip/_internal/models/index.py,sha256=K59A8-hVhBM20Xkahr4dTwP7OjkJyEqXH11UwHFVgqM,1060
+pip/_internal/models/link.py,sha256=y0H2ZOk0P6d1lfGUL2Pl09xFgZcRt5HwN2LElMifOpI,6827
+pip/_internal/models/scheme.py,sha256=vvhBrrno7eVDXcdKHiZWwxhPHf4VG5uSCEkC0QDR2RU,679
+pip/_internal/models/search_scope.py,sha256=2LXbU4wV8LwqdtXQXNXFYKv-IxiDI_QwSz9ZgbwtAfk,3898
+pip/_internal/models/selection_prefs.py,sha256=rPeif2KKjhTPXeMoQYffjqh10oWpXhdkxRDaPT1HO8k,1908
+pip/_internal/models/target_python.py,sha256=c-cFi6zCuo5HYbXNS3rVVpKRaHVh5yQlYEjEW23SidQ,3799
+pip/_internal/models/wheel.py,sha256=6KLuLKH5b0C5goWQXGSISRaq2UZtkHUEAU1y1Zsrwms,2766
+pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50
+pip/_internal/network/auth.py,sha256=K3G1ukKb3PiH8w_UnpXTz8qQsTULO-qdbfOE9zTo1fE,11119
+pip/_internal/network/cache.py,sha256=51CExcRkXWrgMZ7WsrZ6cmijKfViD5tVgKbBvJHO1IE,2394
+pip/_internal/network/download.py,sha256=3D9vdJmVwmCUMxzC-TaVI_GvVOpQna3BLEYNPCSx3Fc,6260
+pip/_internal/network/session.py,sha256=u1IXQfv21R1xv86ulyiB58-be4sYm90eFB0Wp8fVMYw,14702
+pip/_internal/network/utils.py,sha256=iiixo1OeaQ3niUWiBjg59PN6f1w7vvTww1vFriTD_IU,1959
+pip/_internal/network/xmlrpc.py,sha256=AL115M3vFJ8xiHVJneb8Hi0ZFeRvdPhblC89w25OG5s,1597
+pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pip/_internal/operations/check.py,sha256=a6uHG0daoWpmSPCdL7iYJaGQYZ-CRvPvTnCv2PnIIs0,5353
+pip/_internal/operations/freeze.py,sha256=td4BeRnW10EXFTZrx6VgygO3CrjqD5B9f0BGzjQm-Ew,10180
+pip/_internal/operations/prepare.py,sha256=ro2teBlbBpkRJhBKraP9CoJgVLpueSk62ziWhRToXww,20942
+pip/_internal/operations/build/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pip/_internal/operations/build/metadata.py,sha256=yHMi5gHYXcXyHcvUPWHdO-UyOo3McFWljn_nHfM1O9c,1307
+pip/_internal/operations/build/metadata_legacy.py,sha256=4n6N7BTysqVmEpITzT2UVClyt0Peij_Im8Qm965IWB4,3957
+pip/_internal/operations/build/wheel.py,sha256=ntltdNP6D2Tpr4V0agssu6rE0F9LaBpJkYT6zSdhEbw,1469
+pip/_internal/operations/build/wheel_legacy.py,sha256=DYSxQKutwSZnmNvWkwsl2HzE2XQBxV0i0wTphjtUe90,3349
+pip/_internal/operations/install/__init__.py,sha256=mX7hyD2GNBO2mFGokDQ30r_GXv7Y_PLdtxcUv144e-s,51
+pip/_internal/operations/install/editable_legacy.py,sha256=rJ_xs2qtDUjpY2-n6eYlVyZiNoKbOtZXZrYrcnIELt4,1488
+pip/_internal/operations/install/legacy.py,sha256=eBV8gHbO9sBlBc-4nuR3Sd2nikHgEcnC9khfeLiypio,4566
+pip/_internal/operations/install/wheel.py,sha256=xdCjH6uIUyg39Pf8tUaMFUN4a7eozJAFMb_wKcgQlsY,23012
+pip/_internal/req/__init__.py,sha256=UVaYPlHZVGRBQQPjvGC_6jJDQtewXm0ws-8Lxhg_TiY,2671
+pip/_internal/req/constructors.py,sha256=w5-kWWVCqlSqcIBitw86yq7XGMPpKrHDfQZSE2mJ_xc,14388
+pip/_internal/req/req_file.py,sha256=ECqRUicCw5Y08R1YynZAAp8dSKQhDXoc1Q-mY3a9b6I,18485
+pip/_internal/req/req_install.py,sha256=wjsIr4lDpbVSLqANKJI9mXwRVHaRxcnj8q30UiHoLRA,30442
+pip/_internal/req/req_set.py,sha256=GsrKmupRKhNMhjkofVfCEHEHfgEvYBxClaQH5xLBQHg,8066
+pip/_internal/req/req_tracker.py,sha256=27fvVG8Y2MJS1KpU2rBMnQyUEMHG4lkHT_bzbzQK-c0,4723
+pip/_internal/req/req_uninstall.py,sha256=DWnOsuyYGju6-sylyoCm7GtUNevn9qMAVhjAGLcdXUE,23609
+pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pip/_internal/utils/appdirs.py,sha256=frpKbfJiyKLgpPDYNDrPtkfaZ0akY9SyB7ryPV29sMg,1144
+pip/_internal/utils/compat.py,sha256=D7FKGLBdQwWH-dHIGaoWMawDZWBYApvtJVL1kFPJ930,8869
+pip/_internal/utils/deprecation.py,sha256=pBnNogoA4UGTxa_JDnPXBRRYpKMbExAhXpBwAwklOBs,3318
+pip/_internal/utils/distutils_args.py,sha256=a56mblNxk9BGifbpEETG61mmBrqhjtjRkJ4HYn-oOEE,1350
+pip/_internal/utils/encoding.py,sha256=hxZz0t3Whw3d4MHQEiofxalTlfKwxFdLc8fpeGfhKo8,1320
+pip/_internal/utils/entrypoints.py,sha256=vHcNpnksCv6mllihU6hfifdsKPEjwcaJ1aLIXEaynaU,1152
+pip/_internal/utils/filesystem.py,sha256=PXa3vMcz4mbEKtkD0joFI8pBwddLQxhfPFOkVH5xjfE,5255
+pip/_internal/utils/filetypes.py,sha256=R2FwzoeX7b-rZALOXx5cuO8VPPMhUQ4ne7wm3n3IcWA,571
+pip/_internal/utils/glibc.py,sha256=LOeNGgawCKS-4ke9fii78fwXD73dtNav3uxz1Bf-Ab8,3297
+pip/_internal/utils/hashes.py,sha256=my-wSnAWEDvl_8rQaOQcVIWjwh1-f_QiEvGy9TPf53U,3942
+pip/_internal/utils/inject_securetransport.py,sha256=M17ZlFVY66ApgeASVjKKLKNz0LAfk-SyU0HZ4ZB6MmI,810
+pip/_internal/utils/logging.py,sha256=aJL7NldPhS5KGFof6Qt3o3MG5cjm5TOoo7bGRu9_wsg,13033
+pip/_internal/utils/marker_files.py,sha256=CO5djQlrPIozJpJybViH_insoAaBGY1aqEt6-cC-iW0,741
+pip/_internal/utils/misc.py,sha256=uIb58Hiu_g2HRORo2aMcgnW_7R5d-5wUAuoW0fA2ZME,26085
+pip/_internal/utils/models.py,sha256=IA0hw_T4awQzui0kqfIEASm5yLtgZAB08ag59Nip5G8,1148
+pip/_internal/utils/packaging.py,sha256=VtiwcAAL7LBi7tGL2je7LeW4bE11KMHGCsJ1NZY5XtM,3035
+pip/_internal/utils/pkg_resources.py,sha256=ZX-k7V5q_aNWyDse92nN7orN1aCpRLsaxzpkBZ1XKzU,1254
+pip/_internal/utils/setuptools_build.py,sha256=DouaVolV9olDDFIIN9IszaL-FHdNaZt10ufOZFH9ZAU,5070
+pip/_internal/utils/subprocess.py,sha256=Ph3x5eHQBxFotyGhpZN8asSMBud-BBkmgaNfARG-di8,9922
+pip/_internal/utils/temp_dir.py,sha256=87Ib8aNic_hoSDEmUYJHTQIn5-prL2AYL5u_yZ3s4sI,7768
+pip/_internal/utils/typing.py,sha256=xkYwOeHlf4zsHXBDC4310HtEqwhQcYXFPq2h35Tcrl0,1401
+pip/_internal/utils/ui.py,sha256=0FNxXlGtbpPtTviv2oXS9t8bQG_NBdfUgP4GbubhS9U,13911
+pip/_internal/utils/unpacking.py,sha256=M944JTSiapBOSKLWu7lbawpVHSE7flfzZTEr3TAG7v8,9438
+pip/_internal/utils/urls.py,sha256=aNV9wq5ClUmrz6sG-al7hEWJ4ToitOy7l82CmFGFNW8,1481
+pip/_internal/utils/virtualenv.py,sha256=Q3S1WPlI7JWpGOT2jUVJ8l2chm_k7VPJ9cHA_cUluEU,3396
+pip/_internal/utils/wheel.py,sha256=grTRwZtMQwApwbbSPmRVLtac6FKy6SVKeCXNkWyyePA,7302
+pip/_internal/vcs/__init__.py,sha256=viJxJRqRE_mVScum85bgQIXAd6o0ozFt18VpC-qIJrM,617
+pip/_internal/vcs/bazaar.py,sha256=84q1-kj1_nJ9AMzMu8RmMp-riRZu81M7K9kowcYgi3U,3957
+pip/_internal/vcs/git.py,sha256=X0j5jv_x3ZnM_NP09B1ZDxW-PAmfHzqOqX7Wf5XW--0,14058
+pip/_internal/vcs/mercurial.py,sha256=2mg7BdYI_Fe00fF6omaNccFQLPHBsDBG5CAEzvqn5sA,5110
+pip/_internal/vcs/subversion.py,sha256=Fpwy71AmuqXnoKi6h1SrXRtPjEMn8fieuM1O4j01IBg,12292
+pip/_internal/vcs/versioncontrol.py,sha256=nqoaM1_rzx24WnHtihXA8RcPpnUae0sV2sR_LS_5HFA,22600
+pip/_vendor/__init__.py,sha256=v3ZUr2bBNfKRfNOPnrjq2aU7ZjgGiamksWvYlJM5nco,4894
+pip-20.0.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+pip-20.0.2.dist-info/METADATA,sha256=MSgjT2JTt8usp4Hopp5AGEmc-7sKR2Jd7HTMJqCoRhw,3352
+pip-20.0.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pip-20.0.2.dist-info/entry_points.txt,sha256=HtfDOwpUlr9s73jqLQ6wF9V0_0qvUXJwCBz7Vwx0Ue0,125
+pip-20.0.2.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pip-20.0.2.dist-info/RECORD,,
+pip/_internal/operations/freeze.cpython-38.pyc,,
+pip/_internal/commands/wheel.cpython-38.pyc,,
+pip/_internal/utils/logging.cpython-38.pyc,,
+pip/_internal/pep425tags.cpython-38.pyc,,
+pip/_internal/utils/hashes.cpython-38.pyc,,
+pip/_internal/build_env.cpython-38.pyc,,
+../../../bin/pip3,,
+../../../bin/pip,,
+pip/_internal/cli/__init__.cpython-38.pyc,,
+pip/_internal/pyproject.cpython-38.pyc,,
+pip/_internal/commands/configuration.cpython-38.pyc,,
+pip/_internal/utils/compat.cpython-38.pyc,,
+pip/_internal/models/__pycache__,,
+pip/_internal/utils/__init__.cpython-38.pyc,,
+pip/_internal/utils/typing.cpython-38.pyc,,
+pip/_internal/commands/freeze.cpython-38.pyc,,
+pip/_internal/utils/wheel.cpython-38.pyc,,
+pip/_internal/req/__pycache__,,
+pip/_internal/models/scheme.cpython-38.pyc,,
+pip/_internal/operations/prepare.cpython-38.pyc,,
+pip/_vendor/__init__.cpython-38.pyc,,
+pip/_internal/main.cpython-38.pyc,,
+pip/_internal/__init__.cpython-38.pyc,,
+pip/_internal/cli/status_codes.cpython-38.pyc,,
+pip/_internal/vcs/versioncontrol.cpython-38.pyc,,
+pip/_internal/distributions/sdist.cpython-38.pyc,,
+pip/_internal/operations/build/__pycache__,,
+pip/_internal/models/target_python.cpython-38.pyc,,
+pip/_internal/utils/filesystem.cpython-38.pyc,,
+pip/_internal/operations/install/__pycache__,,
+pip/_internal/distributions/__pycache__,,
+pip/_internal/commands/list.cpython-38.pyc,,
+pip/_internal/cli/command_context.cpython-38.pyc,,
+pip/_internal/cli/main_parser.cpython-38.pyc,,
+pip/_internal/configuration.cpython-38.pyc,,
+pip/_internal/locations.cpython-38.pyc,,
+pip/_internal/commands/completion.cpython-38.pyc,,
+pip/_internal/utils/temp_dir.cpython-38.pyc,,
+pip/__init__.cpython-38.pyc,,
+pip/_internal/vcs/__pycache__,,
+pip/_internal/cli/main.cpython-38.pyc,,
+pip/_internal/utils/entrypoints.cpython-38.pyc,,
+pip/_internal/network/__pycache__,,
+pip/_internal/commands/debug.cpython-38.pyc,,
+pip/_internal/commands/install.cpython-38.pyc,,
+pip/_internal/operations/install/__init__.cpython-38.pyc,,
+pip/_internal/network/utils.cpython-38.pyc,,
+pip/_internal/commands/show.cpython-38.pyc,,
+pip/_internal/operations/install/wheel.cpython-38.pyc,,
+pip/_internal/index/__pycache__,,
+pip/_internal/utils/appdirs.cpython-38.pyc,,
+../../../bin/pip-3.8,,
+pip/_internal/req/req_file.cpython-38.pyc,,
+pip/_internal/operations/__pycache__,,
+pip/_internal/commands/search.cpython-38.pyc,,
+pip/_internal/vcs/git.cpython-38.pyc,,
+pip/_internal/network/download.cpython-38.pyc,,
+pip/__main__.cpython-38.pyc,,
+pip-20.0.2.virtualenv,,
+pip/_internal/models/format_control.cpython-38.pyc,,
+pip/_internal/network/xmlrpc.cpython-38.pyc,,
+pip/_internal/models/link.cpython-38.pyc,,
+../../../bin/pip3.8,,
+pip/_internal/models/__init__.cpython-38.pyc,,
+pip/_internal/utils/virtualenv.cpython-38.pyc,,
+pip/_internal/vcs/subversion.cpython-38.pyc,,
+pip/_internal/network/auth.cpython-38.pyc,,
+pip/_internal/models/wheel.cpython-38.pyc,,
+pip/_internal/network/cache.cpython-38.pyc,,
+pip/_internal/operations/check.cpython-38.pyc,,
+pip/_internal/utils/ui.cpython-38.pyc,,
+pip/_internal/req/__init__.cpython-38.pyc,,
+pip/_internal/operations/build/wheel_legacy.cpython-38.pyc,,
+pip/_internal/utils/distutils_args.cpython-38.pyc,,
+pip/_internal/commands/__pycache__,,
+pip/_internal/req/req_uninstall.cpython-38.pyc,,
+pip-20.0.2.dist-info/__pycache__,,
+pip/_internal/self_outdated_check.cpython-38.pyc,,
+pip/_internal/utils/glibc.cpython-38.pyc,,
+pip/_internal/cli/parser.cpython-38.pyc,,
+pip/_internal/models/index.cpython-38.pyc,,
+pip/_internal/operations/install/legacy.cpython-38.pyc,,
+pip/_internal/utils/misc.cpython-38.pyc,,
+pip/_internal/legacy_resolve.cpython-38.pyc,,
+pip/_internal/req/req_install.cpython-38.pyc,,
+pip/_internal/operations/build/__init__.cpython-38.pyc,,
+pip/_internal/commands/uninstall.cpython-38.pyc,,
+pip/_internal/req/req_tracker.cpython-38.pyc,,
+pip/_internal/wheel_builder.cpython-38.pyc,,
+pip/_internal/operations/build/metadata.cpython-38.pyc,,
+pip/_internal/distributions/__init__.cpython-38.pyc,,
+pip/_internal/operations/build/wheel.cpython-38.pyc,,
+pip/_internal/exceptions.cpython-38.pyc,,
+pip/_internal/cli/__pycache__,,
+pip/_internal/network/session.cpython-38.pyc,,
+pip/_internal/distributions/wheel.cpython-38.pyc,,
+pip/_internal/commands/download.cpython-38.pyc,,
+pip/_internal/commands/check.cpython-38.pyc,,
+pip/_internal/utils/__pycache__,,
+pip/_internal/commands/hash.cpython-38.pyc,,
+pip/_internal/models/search_scope.cpython-38.pyc,,
+pip/_internal/commands/help.cpython-38.pyc,,
+pip/_internal/vcs/mercurial.cpython-38.pyc,,
+pip/_internal/utils/models.cpython-38.pyc,,
+pip/_vendor/__pycache__,,
+pip/_internal/utils/packaging.cpython-38.pyc,,
+pip/_internal/utils/filetypes.cpython-38.pyc,,
+pip/_internal/vcs/__init__.cpython-38.pyc,,
+pip/_internal/distributions/base.cpython-38.pyc,,
+pip/_internal/models/candidate.cpython-38.pyc,,
+pip/_internal/__pycache__,,
+pip/_internal/operations/install/editable_legacy.cpython-38.pyc,,
+pip/_internal/utils/encoding.cpython-38.pyc,,
+pip/_internal/cli/base_command.cpython-38.pyc,,
+pip/_internal/network/__init__.cpython-38.pyc,,
+pip/_internal/cli/autocompletion.cpython-38.pyc,,
+pip/_internal/models/selection_prefs.cpython-38.pyc,,
+pip/_internal/utils/setuptools_build.cpython-38.pyc,,
+pip/_internal/index/__init__.cpython-38.pyc,,
+pip/_internal/cli/req_command.cpython-38.pyc,,
+pip/_internal/utils/pkg_resources.cpython-38.pyc,,
+pip/_internal/vcs/bazaar.cpython-38.pyc,,
+pip/_internal/req/constructors.cpython-38.pyc,,
+pip/_internal/operations/__init__.cpython-38.pyc,,
+pip/_internal/utils/marker_files.cpython-38.pyc,,
+pip/_internal/utils/urls.cpython-38.pyc,,
+pip/__pycache__,,
+pip/_internal/cli/cmdoptions.cpython-38.pyc,,
+pip/_internal/utils/inject_securetransport.cpython-38.pyc,,
+pip/_internal/utils/deprecation.cpython-38.pyc,,
+pip/_internal/utils/unpacking.cpython-38.pyc,,
+pip-20.0.2.dist-info/INSTALLER,,
+pip/_internal/cache.cpython-38.pyc,,
+pip/_internal/distributions/installed.cpython-38.pyc,,
+pip/_internal/index/collector.cpython-38.pyc,,
+pip/_internal/operations/build/metadata_legacy.cpython-38.pyc,,
+pip/_internal/req/req_set.cpython-38.pyc,,
+pip/_internal/utils/subprocess.cpython-38.pyc,,
+pip/_internal/commands/__init__.cpython-38.pyc,,
+pip/_internal/index/package_finder.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d48bd8a85e683c7a9607f3f418f50d11445bdf40
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/entry_points.txt
@@ -0,0 +1,5 @@
+[console_scripts]
+pip = pip._internal.cli.main:main
+pip3 = pip._internal.cli.main:main
+pip3.8 = pip._internal.cli.main:main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip-20.0.2.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..827a4e20a7b0a7824ae863f97f0b0c1c38408030
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__init__.py
@@ -0,0 +1,18 @@
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional
+
+
+__version__ = "20.0.2"
+
+
+def main(args=None):
+    # type: (Optional[List[str]]) -> int
+    """This is an internal API only meant for use by pip's own console scripts.
+
+    For additional details, see https://github.com/pypa/pip/issues/7498.
+    """
+    from pip._internal.utils.entrypoints import _wrapper
+
+    return _wrapper(args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__main__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e83b9e056b321828cbc8990f719ebb4a729c9bea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/__main__.py
@@ -0,0 +1,19 @@
+from __future__ import absolute_import
+
+import os
+import sys
+
+# If we are running from a wheel, add the wheel to sys.path
+# This allows the usage python pip-*.whl/pip install pip-*.whl
+if __package__ == '':
+    # __file__ is pip-*.whl/pip/__main__.py
+    # first dirname call strips of '/__main__.py', second strips off '/pip'
+    # Resulting path is the name of the wheel itself
+    # Add that to sys.path so we can import pip
+    path = os.path.dirname(os.path.dirname(__file__))
+    sys.path.insert(0, path)
+
+from pip._internal.cli.main import main as _main  # isort:skip # noqa
+
+if __name__ == '__main__':
+    sys.exit(_main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3aa8a4693ff0893a87364964f06bad8075e4834b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/__init__.py
@@ -0,0 +1,18 @@
+#!/usr/bin/env python
+import pip._internal.utils.inject_securetransport  # noqa
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, List
+
+
+def main(args=None):
+    # type: (Optional[List[str]]) -> int
+    """This is preserved for old console scripts that may still be referencing
+    it.
+
+    For additional details, see https://github.com/pypa/pip/issues/7498.
+    """
+    from pip._internal.utils.entrypoints import _wrapper
+
+    return _wrapper(args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/build_env.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/build_env.py
new file mode 100644
index 0000000000000000000000000000000000000000..f55f0e6b8d9e73ff9b751ce2f0c2513123d17100
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/build_env.py
@@ -0,0 +1,221 @@
+"""Build Environment used for isolation during sdist building
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+import logging
+import os
+import sys
+import textwrap
+from collections import OrderedDict
+from distutils.sysconfig import get_python_lib
+from sysconfig import get_paths
+
+from pip._vendor.pkg_resources import Requirement, VersionConflict, WorkingSet
+
+from pip import __file__ as pip_location
+from pip._internal.utils.subprocess import call_subprocess
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.ui import open_spinner
+
+if MYPY_CHECK_RUNNING:
+    from typing import Tuple, Set, Iterable, Optional, List
+    from pip._internal.index.package_finder import PackageFinder
+
+logger = logging.getLogger(__name__)
+
+
+class _Prefix:
+
+    def __init__(self, path):
+        # type: (str) -> None
+        self.path = path
+        self.setup = False
+        self.bin_dir = get_paths(
+            'nt' if os.name == 'nt' else 'posix_prefix',
+            vars={'base': path, 'platbase': path}
+        )['scripts']
+        # Note: prefer distutils' sysconfig to get the
+        # library paths so PyPy is correctly supported.
+        purelib = get_python_lib(plat_specific=False, prefix=path)
+        platlib = get_python_lib(plat_specific=True, prefix=path)
+        if purelib == platlib:
+            self.lib_dirs = [purelib]
+        else:
+            self.lib_dirs = [purelib, platlib]
+
+
+class BuildEnvironment(object):
+    """Creates and manages an isolated environment to install build deps
+    """
+
+    def __init__(self):
+        # type: () -> None
+        self._temp_dir = TempDirectory(kind="build-env")
+
+        self._prefixes = OrderedDict((
+            (name, _Prefix(os.path.join(self._temp_dir.path, name)))
+            for name in ('normal', 'overlay')
+        ))
+
+        self._bin_dirs = []  # type: List[str]
+        self._lib_dirs = []  # type: List[str]
+        for prefix in reversed(list(self._prefixes.values())):
+            self._bin_dirs.append(prefix.bin_dir)
+            self._lib_dirs.extend(prefix.lib_dirs)
+
+        # Customize site to:
+        # - ensure .pth files are honored
+        # - prevent access to system site packages
+        system_sites = {
+            os.path.normcase(site) for site in (
+                get_python_lib(plat_specific=False),
+                get_python_lib(plat_specific=True),
+            )
+        }
+        self._site_dir = os.path.join(self._temp_dir.path, 'site')
+        if not os.path.exists(self._site_dir):
+            os.mkdir(self._site_dir)
+        with open(os.path.join(self._site_dir, 'sitecustomize.py'), 'w') as fp:
+            fp.write(textwrap.dedent(
+                '''
+                import os, site, sys
+
+                # First, drop system-sites related paths.
+                original_sys_path = sys.path[:]
+                known_paths = set()
+                for path in {system_sites!r}:
+                    site.addsitedir(path, known_paths=known_paths)
+                system_paths = set(
+                    os.path.normcase(path)
+                    for path in sys.path[len(original_sys_path):]
+                )
+                original_sys_path = [
+                    path for path in original_sys_path
+                    if os.path.normcase(path) not in system_paths
+                ]
+                sys.path = original_sys_path
+
+                # Second, add lib directories.
+                # ensuring .pth file are processed.
+                for path in {lib_dirs!r}:
+                    assert not path in sys.path
+                    site.addsitedir(path)
+                '''
+            ).format(system_sites=system_sites, lib_dirs=self._lib_dirs))
+
+    def __enter__(self):
+        self._save_env = {
+            name: os.environ.get(name, None)
+            for name in ('PATH', 'PYTHONNOUSERSITE', 'PYTHONPATH')
+        }
+
+        path = self._bin_dirs[:]
+        old_path = self._save_env['PATH']
+        if old_path:
+            path.extend(old_path.split(os.pathsep))
+
+        pythonpath = [self._site_dir]
+
+        os.environ.update({
+            'PATH': os.pathsep.join(path),
+            'PYTHONNOUSERSITE': '1',
+            'PYTHONPATH': os.pathsep.join(pythonpath),
+        })
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        for varname, old_value in self._save_env.items():
+            if old_value is None:
+                os.environ.pop(varname, None)
+            else:
+                os.environ[varname] = old_value
+
+    def cleanup(self):
+        # type: () -> None
+        self._temp_dir.cleanup()
+
+    def check_requirements(self, reqs):
+        # type: (Iterable[str]) -> Tuple[Set[Tuple[str, str]], Set[str]]
+        """Return 2 sets:
+            - conflicting requirements: set of (installed, wanted) reqs tuples
+            - missing requirements: set of reqs
+        """
+        missing = set()
+        conflicting = set()
+        if reqs:
+            ws = WorkingSet(self._lib_dirs)
+            for req in reqs:
+                try:
+                    if ws.find(Requirement.parse(req)) is None:
+                        missing.add(req)
+                except VersionConflict as e:
+                    conflicting.add((str(e.args[0].as_requirement()),
+                                     str(e.args[1])))
+        return conflicting, missing
+
+    def install_requirements(
+        self,
+        finder,  # type: PackageFinder
+        requirements,  # type: Iterable[str]
+        prefix_as_string,  # type: str
+        message  # type: Optional[str]
+    ):
+        # type: (...) -> None
+        prefix = self._prefixes[prefix_as_string]
+        assert not prefix.setup
+        prefix.setup = True
+        if not requirements:
+            return
+        args = [
+            sys.executable, os.path.dirname(pip_location), 'install',
+            '--ignore-installed', '--no-user', '--prefix', prefix.path,
+            '--no-warn-script-location',
+        ]  # type: List[str]
+        if logger.getEffectiveLevel() <= logging.DEBUG:
+            args.append('-v')
+        for format_control in ('no_binary', 'only_binary'):
+            formats = getattr(finder.format_control, format_control)
+            args.extend(('--' + format_control.replace('_', '-'),
+                         ','.join(sorted(formats or {':none:'}))))
+
+        index_urls = finder.index_urls
+        if index_urls:
+            args.extend(['-i', index_urls[0]])
+            for extra_index in index_urls[1:]:
+                args.extend(['--extra-index-url', extra_index])
+        else:
+            args.append('--no-index')
+        for link in finder.find_links:
+            args.extend(['--find-links', link])
+
+        for host in finder.trusted_hosts:
+            args.extend(['--trusted-host', host])
+        if finder.allow_all_prereleases:
+            args.append('--pre')
+        args.append('--')
+        args.extend(requirements)
+        with open_spinner(message) as spinner:
+            call_subprocess(args, spinner=spinner)
+
+
+class NoOpBuildEnvironment(BuildEnvironment):
+    """A no-op drop-in replacement for BuildEnvironment
+    """
+
+    def __init__(self):
+        pass
+
+    def __enter__(self):
+        pass
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass
+
+    def cleanup(self):
+        pass
+
+    def install_requirements(self, finder, requirements, prefix, message):
+        raise NotImplementedError()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..abecd78f8d988dd5856855aff3a89ab270ca73a9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cache.py
@@ -0,0 +1,329 @@
+"""Cache Management
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import hashlib
+import json
+import logging
+import os
+
+from pip._vendor.packaging.tags import interpreter_name, interpreter_version
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.exceptions import InvalidWheelFilename
+from pip._internal.models.link import Link
+from pip._internal.models.wheel import Wheel
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Set, List, Any, Dict
+
+    from pip._vendor.packaging.tags import Tag
+
+    from pip._internal.models.format_control import FormatControl
+
+logger = logging.getLogger(__name__)
+
+
+def _hash_dict(d):
+    # type: (Dict[str, str]) -> str
+    """Return a stable sha224 of a dictionary."""
+    s = json.dumps(d, sort_keys=True, separators=(",", ":"), ensure_ascii=True)
+    return hashlib.sha224(s.encode("ascii")).hexdigest()
+
+
+class Cache(object):
+    """An abstract class - provides cache directories for data from links
+
+
+        :param cache_dir: The root of the cache.
+        :param format_control: An object of FormatControl class to limit
+            binaries being read from the cache.
+        :param allowed_formats: which formats of files the cache should store.
+            ('binary' and 'source' are the only allowed values)
+    """
+
+    def __init__(self, cache_dir, format_control, allowed_formats):
+        # type: (str, FormatControl, Set[str]) -> None
+        super(Cache, self).__init__()
+        assert not cache_dir or os.path.isabs(cache_dir)
+        self.cache_dir = cache_dir or None
+        self.format_control = format_control
+        self.allowed_formats = allowed_formats
+
+        _valid_formats = {"source", "binary"}
+        assert self.allowed_formats.union(_valid_formats) == _valid_formats
+
+    def _get_cache_path_parts_legacy(self, link):
+        # type: (Link) -> List[str]
+        """Get parts of part that must be os.path.joined with cache_dir
+
+        Legacy cache key (pip < 20) for compatibility with older caches.
+        """
+
+        # We want to generate an url to use as our cache key, we don't want to
+        # just re-use the URL because it might have other items in the fragment
+        # and we don't care about those.
+        key_parts = [link.url_without_fragment]
+        if link.hash_name is not None and link.hash is not None:
+            key_parts.append("=".join([link.hash_name, link.hash]))
+        key_url = "#".join(key_parts)
+
+        # Encode our key url with sha224, we'll use this because it has similar
+        # security properties to sha256, but with a shorter total output (and
+        # thus less secure). However the differences don't make a lot of
+        # difference for our use case here.
+        hashed = hashlib.sha224(key_url.encode()).hexdigest()
+
+        # We want to nest the directories some to prevent having a ton of top
+        # level directories where we might run out of sub directories on some
+        # FS.
+        parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]]
+
+        return parts
+
+    def _get_cache_path_parts(self, link):
+        # type: (Link) -> List[str]
+        """Get parts of part that must be os.path.joined with cache_dir
+        """
+
+        # We want to generate an url to use as our cache key, we don't want to
+        # just re-use the URL because it might have other items in the fragment
+        # and we don't care about those.
+        key_parts = {"url": link.url_without_fragment}
+        if link.hash_name is not None and link.hash is not None:
+            key_parts[link.hash_name] = link.hash
+        if link.subdirectory_fragment:
+            key_parts["subdirectory"] = link.subdirectory_fragment
+
+        # Include interpreter name, major and minor version in cache key
+        # to cope with ill-behaved sdists that build a different wheel
+        # depending on the python version their setup.py is being run on,
+        # and don't encode the difference in compatibility tags.
+        # https://github.com/pypa/pip/issues/7296
+        key_parts["interpreter_name"] = interpreter_name()
+        key_parts["interpreter_version"] = interpreter_version()
+
+        # Encode our key url with sha224, we'll use this because it has similar
+        # security properties to sha256, but with a shorter total output (and
+        # thus less secure). However the differences don't make a lot of
+        # difference for our use case here.
+        hashed = _hash_dict(key_parts)
+
+        # We want to nest the directories some to prevent having a ton of top
+        # level directories where we might run out of sub directories on some
+        # FS.
+        parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]]
+
+        return parts
+
+    def _get_candidates(self, link, canonical_package_name):
+        # type: (Link, Optional[str]) -> List[Any]
+        can_not_cache = (
+            not self.cache_dir or
+            not canonical_package_name or
+            not link
+        )
+        if can_not_cache:
+            return []
+
+        formats = self.format_control.get_allowed_formats(
+            canonical_package_name
+        )
+        if not self.allowed_formats.intersection(formats):
+            return []
+
+        candidates = []
+        path = self.get_path_for_link(link)
+        if os.path.isdir(path):
+            for candidate in os.listdir(path):
+                candidates.append((candidate, path))
+        # TODO remove legacy path lookup in pip>=21
+        legacy_path = self.get_path_for_link_legacy(link)
+        if os.path.isdir(legacy_path):
+            for candidate in os.listdir(legacy_path):
+                candidates.append((candidate, legacy_path))
+        return candidates
+
+    def get_path_for_link_legacy(self, link):
+        # type: (Link) -> str
+        raise NotImplementedError()
+
+    def get_path_for_link(self, link):
+        # type: (Link) -> str
+        """Return a directory to store cached items in for link.
+        """
+        raise NotImplementedError()
+
+    def get(
+        self,
+        link,            # type: Link
+        package_name,    # type: Optional[str]
+        supported_tags,  # type: List[Tag]
+    ):
+        # type: (...) -> Link
+        """Returns a link to a cached item if it exists, otherwise returns the
+        passed link.
+        """
+        raise NotImplementedError()
+
+    def cleanup(self):
+        # type: () -> None
+        pass
+
+
+class SimpleWheelCache(Cache):
+    """A cache of wheels for future installs.
+    """
+
+    def __init__(self, cache_dir, format_control):
+        # type: (str, FormatControl) -> None
+        super(SimpleWheelCache, self).__init__(
+            cache_dir, format_control, {"binary"}
+        )
+
+    def get_path_for_link_legacy(self, link):
+        # type: (Link) -> str
+        parts = self._get_cache_path_parts_legacy(link)
+        return os.path.join(self.cache_dir, "wheels", *parts)
+
+    def get_path_for_link(self, link):
+        # type: (Link) -> str
+        """Return a directory to store cached wheels for link
+
+        Because there are M wheels for any one sdist, we provide a directory
+        to cache them in, and then consult that directory when looking up
+        cache hits.
+
+        We only insert things into the cache if they have plausible version
+        numbers, so that we don't contaminate the cache with things that were
+        not unique. E.g. ./package might have dozens of installs done for it
+        and build a version of 0.0...and if we built and cached a wheel, we'd
+        end up using the same wheel even if the source has been edited.
+
+        :param link: The link of the sdist for which this will cache wheels.
+        """
+        parts = self._get_cache_path_parts(link)
+
+        # Store wheels within the root cache_dir
+        return os.path.join(self.cache_dir, "wheels", *parts)
+
+    def get(
+        self,
+        link,            # type: Link
+        package_name,    # type: Optional[str]
+        supported_tags,  # type: List[Tag]
+    ):
+        # type: (...) -> Link
+        candidates = []
+
+        if not package_name:
+            return link
+
+        canonical_package_name = canonicalize_name(package_name)
+        for wheel_name, wheel_dir in self._get_candidates(
+            link, canonical_package_name
+        ):
+            try:
+                wheel = Wheel(wheel_name)
+            except InvalidWheelFilename:
+                continue
+            if canonicalize_name(wheel.name) != canonical_package_name:
+                logger.debug(
+                    "Ignoring cached wheel {} for {} as it "
+                    "does not match the expected distribution name {}.".format(
+                        wheel_name, link, package_name
+                    )
+                )
+                continue
+            if not wheel.supported(supported_tags):
+                # Built for a different python/arch/etc
+                continue
+            candidates.append(
+                (
+                    wheel.support_index_min(supported_tags),
+                    wheel_name,
+                    wheel_dir,
+                )
+            )
+
+        if not candidates:
+            return link
+
+        _, wheel_name, wheel_dir = min(candidates)
+        return Link(path_to_url(os.path.join(wheel_dir, wheel_name)))
+
+
+class EphemWheelCache(SimpleWheelCache):
+    """A SimpleWheelCache that creates it's own temporary cache directory
+    """
+
+    def __init__(self, format_control):
+        # type: (FormatControl) -> None
+        self._temp_dir = TempDirectory(kind="ephem-wheel-cache")
+
+        super(EphemWheelCache, self).__init__(
+            self._temp_dir.path, format_control
+        )
+
+    def cleanup(self):
+        # type: () -> None
+        self._temp_dir.cleanup()
+
+
+class WheelCache(Cache):
+    """Wraps EphemWheelCache and SimpleWheelCache into a single Cache
+
+    This Cache allows for gracefully degradation, using the ephem wheel cache
+    when a certain link is not found in the simple wheel cache first.
+    """
+
+    def __init__(self, cache_dir, format_control):
+        # type: (str, FormatControl) -> None
+        super(WheelCache, self).__init__(
+            cache_dir, format_control, {'binary'}
+        )
+        self._wheel_cache = SimpleWheelCache(cache_dir, format_control)
+        self._ephem_cache = EphemWheelCache(format_control)
+
+    def get_path_for_link_legacy(self, link):
+        # type: (Link) -> str
+        return self._wheel_cache.get_path_for_link_legacy(link)
+
+    def get_path_for_link(self, link):
+        # type: (Link) -> str
+        return self._wheel_cache.get_path_for_link(link)
+
+    def get_ephem_path_for_link(self, link):
+        # type: (Link) -> str
+        return self._ephem_cache.get_path_for_link(link)
+
+    def get(
+        self,
+        link,            # type: Link
+        package_name,    # type: Optional[str]
+        supported_tags,  # type: List[Tag]
+    ):
+        # type: (...) -> Link
+        retval = self._wheel_cache.get(
+            link=link,
+            package_name=package_name,
+            supported_tags=supported_tags,
+        )
+        if retval is not link:
+            return retval
+
+        return self._ephem_cache.get(
+            link=link,
+            package_name=package_name,
+            supported_tags=supported_tags,
+        )
+
+    def cleanup(self):
+        # type: () -> None
+        self._wheel_cache.cleanup()
+        self._ephem_cache.cleanup()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e589bb917e23823e25f9fff7e0849c4d6d4a62bc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/__init__.py
@@ -0,0 +1,4 @@
+"""Subpackage containing all of pip's command line interface related code
+"""
+
+# This file intentionally does not import submodules
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py
new file mode 100644
index 0000000000000000000000000000000000000000..329de602513d7bb868799a49d36d3f081a79e441
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py
@@ -0,0 +1,164 @@
+"""Logic that powers autocompletion installed by ``pip completion``.
+"""
+
+import optparse
+import os
+import sys
+from itertools import chain
+
+from pip._internal.cli.main_parser import create_main_parser
+from pip._internal.commands import commands_dict, create_command
+from pip._internal.utils.misc import get_installed_distributions
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Iterable, List, Optional
+
+
+def autocomplete():
+    # type: () -> None
+    """Entry Point for completion of main and subcommand options.
+    """
+    # Don't complete if user hasn't sourced bash_completion file.
+    if 'PIP_AUTO_COMPLETE' not in os.environ:
+        return
+    cwords = os.environ['COMP_WORDS'].split()[1:]
+    cword = int(os.environ['COMP_CWORD'])
+    try:
+        current = cwords[cword - 1]
+    except IndexError:
+        current = ''
+
+    parser = create_main_parser()
+    subcommands = list(commands_dict)
+    options = []
+
+    # subcommand
+    subcommand_name = None  # type: Optional[str]
+    for word in cwords:
+        if word in subcommands:
+            subcommand_name = word
+            break
+    # subcommand options
+    if subcommand_name is not None:
+        # special case: 'help' subcommand has no options
+        if subcommand_name == 'help':
+            sys.exit(1)
+        # special case: list locally installed dists for show and uninstall
+        should_list_installed = (
+            subcommand_name in ['show', 'uninstall'] and
+            not current.startswith('-')
+        )
+        if should_list_installed:
+            installed = []
+            lc = current.lower()
+            for dist in get_installed_distributions(local_only=True):
+                if dist.key.startswith(lc) and dist.key not in cwords[1:]:
+                    installed.append(dist.key)
+            # if there are no dists installed, fall back to option completion
+            if installed:
+                for dist in installed:
+                    print(dist)
+                sys.exit(1)
+
+        subcommand = create_command(subcommand_name)
+
+        for opt in subcommand.parser.option_list_all:
+            if opt.help != optparse.SUPPRESS_HELP:
+                for opt_str in opt._long_opts + opt._short_opts:
+                    options.append((opt_str, opt.nargs))
+
+        # filter out previously specified options from available options
+        prev_opts = [x.split('=')[0] for x in cwords[1:cword - 1]]
+        options = [(x, v) for (x, v) in options if x not in prev_opts]
+        # filter options by current input
+        options = [(k, v) for k, v in options if k.startswith(current)]
+        # get completion type given cwords and available subcommand options
+        completion_type = get_path_completion_type(
+            cwords, cword, subcommand.parser.option_list_all,
+        )
+        # get completion files and directories if ``completion_type`` is
+        # ``<file>``, ``<dir>`` or ``<path>``
+        if completion_type:
+            paths = auto_complete_paths(current, completion_type)
+            options = [(path, 0) for path in paths]
+        for option in options:
+            opt_label = option[0]
+            # append '=' to options which require args
+            if option[1] and option[0][:2] == "--":
+                opt_label += '='
+            print(opt_label)
+    else:
+        # show main parser options only when necessary
+
+        opts = [i.option_list for i in parser.option_groups]
+        opts.append(parser.option_list)
+        flattened_opts = chain.from_iterable(opts)
+        if current.startswith('-'):
+            for opt in flattened_opts:
+                if opt.help != optparse.SUPPRESS_HELP:
+                    subcommands += opt._long_opts + opt._short_opts
+        else:
+            # get completion type given cwords and all available options
+            completion_type = get_path_completion_type(cwords, cword,
+                                                       flattened_opts)
+            if completion_type:
+                subcommands = list(auto_complete_paths(current,
+                                                       completion_type))
+
+        print(' '.join([x for x in subcommands if x.startswith(current)]))
+    sys.exit(1)
+
+
+def get_path_completion_type(cwords, cword, opts):
+    # type: (List[str], int, Iterable[Any]) -> Optional[str]
+    """Get the type of path completion (``file``, ``dir``, ``path`` or None)
+
+    :param cwords: same as the environmental variable ``COMP_WORDS``
+    :param cword: same as the environmental variable ``COMP_CWORD``
+    :param opts: The available options to check
+    :return: path completion type (``file``, ``dir``, ``path`` or None)
+    """
+    if cword < 2 or not cwords[cword - 2].startswith('-'):
+        return None
+    for opt in opts:
+        if opt.help == optparse.SUPPRESS_HELP:
+            continue
+        for o in str(opt).split('/'):
+            if cwords[cword - 2].split('=')[0] == o:
+                if not opt.metavar or any(
+                        x in ('path', 'file', 'dir')
+                        for x in opt.metavar.split('/')):
+                    return opt.metavar
+    return None
+
+
+def auto_complete_paths(current, completion_type):
+    # type: (str, str) -> Iterable[str]
+    """If ``completion_type`` is ``file`` or ``path``, list all regular files
+    and directories starting with ``current``; otherwise only list directories
+    starting with ``current``.
+
+    :param current: The word to be completed
+    :param completion_type: path completion type(`file`, `path` or `dir`)i
+    :return: A generator of regular files and/or directories
+    """
+    directory, filename = os.path.split(current)
+    current_path = os.path.abspath(directory)
+    # Don't complete paths if they can't be accessed
+    if not os.access(current_path, os.R_OK):
+        return
+    filename = os.path.normcase(filename)
+    # list all files that start with ``filename``
+    file_list = (x for x in os.listdir(current_path)
+                 if os.path.normcase(x).startswith(filename))
+    for f in file_list:
+        opt = os.path.join(current_path, f)
+        comp_file = os.path.normcase(os.path.join(directory, f))
+        # complete regular files when there is not ``<dir>`` after option
+        # complete directories when there is ``<file>``, ``<path>`` or
+        # ``<dir>``after option
+        if completion_type != 'dir' and os.path.isfile(opt):
+            yield comp_file
+        elif os.path.isdir(opt):
+            yield os.path.join(comp_file, '')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py
new file mode 100644
index 0000000000000000000000000000000000000000..628faa3eee0e441b8fed0eea9c6e4b74222ebb3f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/base_command.py
@@ -0,0 +1,226 @@
+"""Base Command class, and related routines"""
+
+from __future__ import absolute_import, print_function
+
+import logging
+import logging.config
+import optparse
+import os
+import platform
+import sys
+import traceback
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.command_context import CommandContextMixIn
+from pip._internal.cli.parser import (
+    ConfigOptionParser,
+    UpdatingDefaultsHelpFormatter,
+)
+from pip._internal.cli.status_codes import (
+    ERROR,
+    PREVIOUS_BUILD_DIR_ERROR,
+    SUCCESS,
+    UNKNOWN_ERROR,
+    VIRTUALENV_NOT_FOUND,
+)
+from pip._internal.exceptions import (
+    BadCommand,
+    CommandError,
+    InstallationError,
+    PreviousBuildDirError,
+    UninstallationError,
+)
+from pip._internal.utils.deprecation import deprecated
+from pip._internal.utils.filesystem import check_path_owner
+from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging
+from pip._internal.utils.misc import get_prog, normalize_path
+from pip._internal.utils.temp_dir import global_tempdir_manager
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.virtualenv import running_under_virtualenv
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Tuple, Any
+    from optparse import Values
+
+__all__ = ['Command']
+
+logger = logging.getLogger(__name__)
+
+
+class Command(CommandContextMixIn):
+    usage = None  # type: str
+    ignore_require_venv = False  # type: bool
+
+    def __init__(self, name, summary, isolated=False):
+        # type: (str, str, bool) -> None
+        super(Command, self).__init__()
+        parser_kw = {
+            'usage': self.usage,
+            'prog': '%s %s' % (get_prog(), name),
+            'formatter': UpdatingDefaultsHelpFormatter(),
+            'add_help_option': False,
+            'name': name,
+            'description': self.__doc__,
+            'isolated': isolated,
+        }
+
+        self.name = name
+        self.summary = summary
+        self.parser = ConfigOptionParser(**parser_kw)
+
+        # Commands should add options to this option group
+        optgroup_name = '%s Options' % self.name.capitalize()
+        self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name)
+
+        # Add the general options
+        gen_opts = cmdoptions.make_option_group(
+            cmdoptions.general_group,
+            self.parser,
+        )
+        self.parser.add_option_group(gen_opts)
+
+    def handle_pip_version_check(self, options):
+        # type: (Values) -> None
+        """
+        This is a no-op so that commands by default do not do the pip version
+        check.
+        """
+        # Make sure we do the pip version check if the index_group options
+        # are present.
+        assert not hasattr(options, 'no_index')
+
+    def run(self, options, args):
+        # type: (Values, List[Any]) -> Any
+        raise NotImplementedError
+
+    def parse_args(self, args):
+        # type: (List[str]) -> Tuple[Any, Any]
+        # factored out for testability
+        return self.parser.parse_args(args)
+
+    def main(self, args):
+        # type: (List[str]) -> int
+        try:
+            with self.main_context():
+                return self._main(args)
+        finally:
+            logging.shutdown()
+
+    def _main(self, args):
+        # type: (List[str]) -> int
+        # Intentionally set as early as possible so globally-managed temporary
+        # directories are available to the rest of the code.
+        self.enter_context(global_tempdir_manager())
+
+        options, args = self.parse_args(args)
+
+        # Set verbosity so that it can be used elsewhere.
+        self.verbosity = options.verbose - options.quiet
+
+        level_number = setup_logging(
+            verbosity=self.verbosity,
+            no_color=options.no_color,
+            user_log_file=options.log,
+        )
+
+        if (
+            sys.version_info[:2] == (2, 7) and
+            not options.no_python_version_warning
+        ):
+            message = (
+                "A future version of pip will drop support for Python 2.7. "
+                "More details about Python 2 support in pip, can be found at "
+                "https://pip.pypa.io/en/latest/development/release-process/#python-2-support"  # noqa
+            )
+            if platform.python_implementation() == "CPython":
+                message = (
+                    "Python 2.7 reached the end of its life on January "
+                    "1st, 2020. Please upgrade your Python as Python 2.7 "
+                    "is no longer maintained. "
+                ) + message
+            deprecated(message, replacement=None, gone_in=None)
+
+        if options.skip_requirements_regex:
+            deprecated(
+                "--skip-requirements-regex is unsupported and will be removed",
+                replacement=(
+                    "manage requirements/constraints files explicitly, "
+                    "possibly generating them from metadata"
+                ),
+                gone_in="20.1",
+                issue=7297,
+            )
+
+        # TODO: Try to get these passing down from the command?
+        #       without resorting to os.environ to hold these.
+        #       This also affects isolated builds and it should.
+
+        if options.no_input:
+            os.environ['PIP_NO_INPUT'] = '1'
+
+        if options.exists_action:
+            os.environ['PIP_EXISTS_ACTION'] = ' '.join(options.exists_action)
+
+        if options.require_venv and not self.ignore_require_venv:
+            # If a venv is required check if it can really be found
+            if not running_under_virtualenv():
+                logger.critical(
+                    'Could not find an activated virtualenv (required).'
+                )
+                sys.exit(VIRTUALENV_NOT_FOUND)
+
+        if options.cache_dir:
+            options.cache_dir = normalize_path(options.cache_dir)
+            if not check_path_owner(options.cache_dir):
+                logger.warning(
+                    "The directory '%s' or its parent directory is not owned "
+                    "or is not writable by the current user. The cache "
+                    "has been disabled. Check the permissions and owner of "
+                    "that directory. If executing pip with sudo, you may want "
+                    "sudo's -H flag.",
+                    options.cache_dir,
+                )
+                options.cache_dir = None
+
+        try:
+            status = self.run(options, args)
+            # FIXME: all commands should return an exit status
+            # and when it is done, isinstance is not needed anymore
+            if isinstance(status, int):
+                return status
+        except PreviousBuildDirError as exc:
+            logger.critical(str(exc))
+            logger.debug('Exception information:', exc_info=True)
+
+            return PREVIOUS_BUILD_DIR_ERROR
+        except (InstallationError, UninstallationError, BadCommand) as exc:
+            logger.critical(str(exc))
+            logger.debug('Exception information:', exc_info=True)
+
+            return ERROR
+        except CommandError as exc:
+            logger.critical('%s', exc)
+            logger.debug('Exception information:', exc_info=True)
+
+            return ERROR
+        except BrokenStdoutLoggingError:
+            # Bypass our logger and write any remaining messages to stderr
+            # because stdout no longer works.
+            print('ERROR: Pipe to stdout was broken', file=sys.stderr)
+            if level_number <= logging.DEBUG:
+                traceback.print_exc(file=sys.stderr)
+
+            return ERROR
+        except KeyboardInterrupt:
+            logger.critical('Operation cancelled by user')
+            logger.debug('Exception information:', exc_info=True)
+
+            return ERROR
+        except BaseException:
+            logger.critical('Exception:', exc_info=True)
+
+            return UNKNOWN_ERROR
+        finally:
+            self.handle_pip_version_check(options)
+
+        return SUCCESS
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..447f3191887dba6e1893c93a0c5ee77de88f1074
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py
@@ -0,0 +1,957 @@
+"""
+shared options and groups
+
+The principle here is to define options once, but *not* instantiate them
+globally. One reason being that options with action='append' can carry state
+between parses. pip parses general options twice internally, and shouldn't
+pass on state. To be consistent, all options will follow this design.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import textwrap
+import warnings
+from distutils.util import strtobool
+from functools import partial
+from optparse import SUPPRESS_HELP, Option, OptionGroup
+from textwrap import dedent
+
+from pip._internal.exceptions import CommandError
+from pip._internal.locations import USER_CACHE_DIR, get_src_prefix
+from pip._internal.models.format_control import FormatControl
+from pip._internal.models.index import PyPI
+from pip._internal.models.target_python import TargetPython
+from pip._internal.utils.hashes import STRONG_HASHES
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.ui import BAR_TYPES
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Callable, Dict, Optional, Tuple
+    from optparse import OptionParser, Values
+    from pip._internal.cli.parser import ConfigOptionParser
+
+logger = logging.getLogger(__name__)
+
+
+def raise_option_error(parser, option, msg):
+    # type: (OptionParser, Option, str) -> None
+    """
+    Raise an option parsing error using parser.error().
+
+    Args:
+      parser: an OptionParser instance.
+      option: an Option instance.
+      msg: the error text.
+    """
+    msg = '{} error: {}'.format(option, msg)
+    msg = textwrap.fill(' '.join(msg.split()))
+    parser.error(msg)
+
+
+def make_option_group(group, parser):
+    # type: (Dict[str, Any], ConfigOptionParser) -> OptionGroup
+    """
+    Return an OptionGroup object
+    group  -- assumed to be dict with 'name' and 'options' keys
+    parser -- an optparse Parser
+    """
+    option_group = OptionGroup(parser, group['name'])
+    for option in group['options']:
+        option_group.add_option(option())
+    return option_group
+
+
+def check_install_build_global(options, check_options=None):
+    # type: (Values, Optional[Values]) -> None
+    """Disable wheels if per-setup.py call options are set.
+
+    :param options: The OptionParser options to update.
+    :param check_options: The options to check, if not supplied defaults to
+        options.
+    """
+    if check_options is None:
+        check_options = options
+
+    def getname(n):
+        # type: (str) -> Optional[Any]
+        return getattr(check_options, n, None)
+    names = ["build_options", "global_options", "install_options"]
+    if any(map(getname, names)):
+        control = options.format_control
+        control.disallow_binaries()
+        warnings.warn(
+            'Disabling all use of wheels due to the use of --build-option '
+            '/ --global-option / --install-option.', stacklevel=2,
+        )
+
+
+def check_dist_restriction(options, check_target=False):
+    # type: (Values, bool) -> None
+    """Function for determining if custom platform options are allowed.
+
+    :param options: The OptionParser options.
+    :param check_target: Whether or not to check if --target is being used.
+    """
+    dist_restriction_set = any([
+        options.python_version,
+        options.platform,
+        options.abi,
+        options.implementation,
+    ])
+
+    binary_only = FormatControl(set(), {':all:'})
+    sdist_dependencies_allowed = (
+        options.format_control != binary_only and
+        not options.ignore_dependencies
+    )
+
+    # Installations or downloads using dist restrictions must not combine
+    # source distributions and dist-specific wheels, as they are not
+    # guaranteed to be locally compatible.
+    if dist_restriction_set and sdist_dependencies_allowed:
+        raise CommandError(
+            "When restricting platform and interpreter constraints using "
+            "--python-version, --platform, --abi, or --implementation, "
+            "either --no-deps must be set, or --only-binary=:all: must be "
+            "set and --no-binary must not be set (or must be set to "
+            ":none:)."
+        )
+
+    if check_target:
+        if dist_restriction_set and not options.target_dir:
+            raise CommandError(
+                "Can not use any platform or abi specific options unless "
+                "installing via '--target'"
+            )
+
+
+def _path_option_check(option, opt, value):
+    # type: (Option, str, str) -> str
+    return os.path.expanduser(value)
+
+
+class PipOption(Option):
+    TYPES = Option.TYPES + ("path",)
+    TYPE_CHECKER = Option.TYPE_CHECKER.copy()
+    TYPE_CHECKER["path"] = _path_option_check
+
+
+###########
+# options #
+###########
+
+help_ = partial(
+    Option,
+    '-h', '--help',
+    dest='help',
+    action='help',
+    help='Show help.',
+)  # type: Callable[..., Option]
+
+isolated_mode = partial(
+    Option,
+    "--isolated",
+    dest="isolated_mode",
+    action="store_true",
+    default=False,
+    help=(
+        "Run pip in an isolated mode, ignoring environment variables and user "
+        "configuration."
+    ),
+)  # type: Callable[..., Option]
+
+require_virtualenv = partial(
+    Option,
+    # Run only if inside a virtualenv, bail if not.
+    '--require-virtualenv', '--require-venv',
+    dest='require_venv',
+    action='store_true',
+    default=False,
+    help=SUPPRESS_HELP
+)  # type: Callable[..., Option]
+
+verbose = partial(
+    Option,
+    '-v', '--verbose',
+    dest='verbose',
+    action='count',
+    default=0,
+    help='Give more output. Option is additive, and can be used up to 3 times.'
+)  # type: Callable[..., Option]
+
+no_color = partial(
+    Option,
+    '--no-color',
+    dest='no_color',
+    action='store_true',
+    default=False,
+    help="Suppress colored output",
+)  # type: Callable[..., Option]
+
+version = partial(
+    Option,
+    '-V', '--version',
+    dest='version',
+    action='store_true',
+    help='Show version and exit.',
+)  # type: Callable[..., Option]
+
+quiet = partial(
+    Option,
+    '-q', '--quiet',
+    dest='quiet',
+    action='count',
+    default=0,
+    help=(
+        'Give less output. Option is additive, and can be used up to 3'
+        ' times (corresponding to WARNING, ERROR, and CRITICAL logging'
+        ' levels).'
+    ),
+)  # type: Callable[..., Option]
+
+progress_bar = partial(
+    Option,
+    '--progress-bar',
+    dest='progress_bar',
+    type='choice',
+    choices=list(BAR_TYPES.keys()),
+    default='on',
+    help=(
+        'Specify type of progress to be displayed [' +
+        '|'.join(BAR_TYPES.keys()) + '] (default: %default)'
+    ),
+)  # type: Callable[..., Option]
+
+log = partial(
+    PipOption,
+    "--log", "--log-file", "--local-log",
+    dest="log",
+    metavar="path",
+    type="path",
+    help="Path to a verbose appending log."
+)  # type: Callable[..., Option]
+
+no_input = partial(
+    Option,
+    # Don't ask for input
+    '--no-input',
+    dest='no_input',
+    action='store_true',
+    default=False,
+    help=SUPPRESS_HELP
+)  # type: Callable[..., Option]
+
+proxy = partial(
+    Option,
+    '--proxy',
+    dest='proxy',
+    type='str',
+    default='',
+    help="Specify a proxy in the form [user:passwd@]proxy.server:port."
+)  # type: Callable[..., Option]
+
+retries = partial(
+    Option,
+    '--retries',
+    dest='retries',
+    type='int',
+    default=5,
+    help="Maximum number of retries each connection should attempt "
+         "(default %default times).",
+)  # type: Callable[..., Option]
+
+timeout = partial(
+    Option,
+    '--timeout', '--default-timeout',
+    metavar='sec',
+    dest='timeout',
+    type='float',
+    default=15,
+    help='Set the socket timeout (default %default seconds).',
+)  # type: Callable[..., Option]
+
+skip_requirements_regex = partial(
+    Option,
+    # A regex to be used to skip requirements
+    '--skip-requirements-regex',
+    dest='skip_requirements_regex',
+    type='str',
+    default='',
+    help=SUPPRESS_HELP,
+)  # type: Callable[..., Option]
+
+
+def exists_action():
+    # type: () -> Option
+    return Option(
+        # Option when path already exist
+        '--exists-action',
+        dest='exists_action',
+        type='choice',
+        choices=['s', 'i', 'w', 'b', 'a'],
+        default=[],
+        action='append',
+        metavar='action',
+        help="Default action when a path already exists: "
+             "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.",
+    )
+
+
+cert = partial(
+    PipOption,
+    '--cert',
+    dest='cert',
+    type='path',
+    metavar='path',
+    help="Path to alternate CA bundle.",
+)  # type: Callable[..., Option]
+
+client_cert = partial(
+    PipOption,
+    '--client-cert',
+    dest='client_cert',
+    type='path',
+    default=None,
+    metavar='path',
+    help="Path to SSL client certificate, a single file containing the "
+         "private key and the certificate in PEM format.",
+)  # type: Callable[..., Option]
+
+index_url = partial(
+    Option,
+    '-i', '--index-url', '--pypi-url',
+    dest='index_url',
+    metavar='URL',
+    default=PyPI.simple_url,
+    help="Base URL of the Python Package Index (default %default). "
+         "This should point to a repository compliant with PEP 503 "
+         "(the simple repository API) or a local directory laid out "
+         "in the same format.",
+)  # type: Callable[..., Option]
+
+
+def extra_index_url():
+    # type: () -> Option
+    return Option(
+        '--extra-index-url',
+        dest='extra_index_urls',
+        metavar='URL',
+        action='append',
+        default=[],
+        help="Extra URLs of package indexes to use in addition to "
+             "--index-url. Should follow the same rules as "
+             "--index-url.",
+    )
+
+
+no_index = partial(
+    Option,
+    '--no-index',
+    dest='no_index',
+    action='store_true',
+    default=False,
+    help='Ignore package index (only looking at --find-links URLs instead).',
+)  # type: Callable[..., Option]
+
+
+def find_links():
+    # type: () -> Option
+    return Option(
+        '-f', '--find-links',
+        dest='find_links',
+        action='append',
+        default=[],
+        metavar='url',
+        help="If a url or path to an html file, then parse for links to "
+             "archives. If a local path or file:// url that's a directory, "
+             "then look for archives in the directory listing.",
+    )
+
+
+def trusted_host():
+    # type: () -> Option
+    return Option(
+        "--trusted-host",
+        dest="trusted_hosts",
+        action="append",
+        metavar="HOSTNAME",
+        default=[],
+        help="Mark this host or host:port pair as trusted, even though it "
+             "does not have valid or any HTTPS.",
+    )
+
+
+def constraints():
+    # type: () -> Option
+    return Option(
+        '-c', '--constraint',
+        dest='constraints',
+        action='append',
+        default=[],
+        metavar='file',
+        help='Constrain versions using the given constraints file. '
+        'This option can be used multiple times.'
+    )
+
+
+def requirements():
+    # type: () -> Option
+    return Option(
+        '-r', '--requirement',
+        dest='requirements',
+        action='append',
+        default=[],
+        metavar='file',
+        help='Install from the given requirements file. '
+        'This option can be used multiple times.'
+    )
+
+
+def editable():
+    # type: () -> Option
+    return Option(
+        '-e', '--editable',
+        dest='editables',
+        action='append',
+        default=[],
+        metavar='path/url',
+        help=('Install a project in editable mode (i.e. setuptools '
+              '"develop mode") from a local project path or a VCS url.'),
+    )
+
+
+def _handle_src(option, opt_str, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    value = os.path.abspath(value)
+    setattr(parser.values, option.dest, value)
+
+
+src = partial(
+    PipOption,
+    '--src', '--source', '--source-dir', '--source-directory',
+    dest='src_dir',
+    type='path',
+    metavar='dir',
+    default=get_src_prefix(),
+    action='callback',
+    callback=_handle_src,
+    help='Directory to check out editable projects into. '
+    'The default in a virtualenv is "<venv path>/src". '
+    'The default for global installs is "<current dir>/src".'
+)  # type: Callable[..., Option]
+
+
+def _get_format_control(values, option):
+    # type: (Values, Option) -> Any
+    """Get a format_control object."""
+    return getattr(values, option.dest)
+
+
+def _handle_no_binary(option, opt_str, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    existing = _get_format_control(parser.values, option)
+    FormatControl.handle_mutual_excludes(
+        value, existing.no_binary, existing.only_binary,
+    )
+
+
+def _handle_only_binary(option, opt_str, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    existing = _get_format_control(parser.values, option)
+    FormatControl.handle_mutual_excludes(
+        value, existing.only_binary, existing.no_binary,
+    )
+
+
+def no_binary():
+    # type: () -> Option
+    format_control = FormatControl(set(), set())
+    return Option(
+        "--no-binary", dest="format_control", action="callback",
+        callback=_handle_no_binary, type="str",
+        default=format_control,
+        help="Do not use binary packages. Can be supplied multiple times, and "
+             "each time adds to the existing value. Accepts either :all: to "
+             "disable all binary packages, :none: to empty the set, or one or "
+             "more package names with commas between them (no colons). Note "
+             "that some packages are tricky to compile and may fail to "
+             "install when this option is used on them.",
+    )
+
+
+def only_binary():
+    # type: () -> Option
+    format_control = FormatControl(set(), set())
+    return Option(
+        "--only-binary", dest="format_control", action="callback",
+        callback=_handle_only_binary, type="str",
+        default=format_control,
+        help="Do not use source packages. Can be supplied multiple times, and "
+             "each time adds to the existing value. Accepts either :all: to "
+             "disable all source packages, :none: to empty the set, or one or "
+             "more package names with commas between them. Packages without "
+             "binary distributions will fail to install when this option is "
+             "used on them.",
+    )
+
+
+platform = partial(
+    Option,
+    '--platform',
+    dest='platform',
+    metavar='platform',
+    default=None,
+    help=("Only use wheels compatible with <platform>. "
+          "Defaults to the platform of the running system."),
+)  # type: Callable[..., Option]
+
+
+# This was made a separate function for unit-testing purposes.
+def _convert_python_version(value):
+    # type: (str) -> Tuple[Tuple[int, ...], Optional[str]]
+    """
+    Convert a version string like "3", "37", or "3.7.3" into a tuple of ints.
+
+    :return: A 2-tuple (version_info, error_msg), where `error_msg` is
+        non-None if and only if there was a parsing error.
+    """
+    if not value:
+        # The empty string is the same as not providing a value.
+        return (None, None)
+
+    parts = value.split('.')
+    if len(parts) > 3:
+        return ((), 'at most three version parts are allowed')
+
+    if len(parts) == 1:
+        # Then we are in the case of "3" or "37".
+        value = parts[0]
+        if len(value) > 1:
+            parts = [value[0], value[1:]]
+
+    try:
+        version_info = tuple(int(part) for part in parts)
+    except ValueError:
+        return ((), 'each version part must be an integer')
+
+    return (version_info, None)
+
+
+def _handle_python_version(option, opt_str, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    """
+    Handle a provided --python-version value.
+    """
+    version_info, error_msg = _convert_python_version(value)
+    if error_msg is not None:
+        msg = (
+            'invalid --python-version value: {!r}: {}'.format(
+                value, error_msg,
+            )
+        )
+        raise_option_error(parser, option=option, msg=msg)
+
+    parser.values.python_version = version_info
+
+
+python_version = partial(
+    Option,
+    '--python-version',
+    dest='python_version',
+    metavar='python_version',
+    action='callback',
+    callback=_handle_python_version, type='str',
+    default=None,
+    help=dedent("""\
+    The Python interpreter version to use for wheel and "Requires-Python"
+    compatibility checks. Defaults to a version derived from the running
+    interpreter. The version can be specified using up to three dot-separated
+    integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor
+    version can also be given as a string without dots (e.g. "37" for 3.7.0).
+    """),
+)  # type: Callable[..., Option]
+
+
+implementation = partial(
+    Option,
+    '--implementation',
+    dest='implementation',
+    metavar='implementation',
+    default=None,
+    help=("Only use wheels compatible with Python "
+          "implementation <implementation>, e.g. 'pp', 'jy', 'cp', "
+          " or 'ip'. If not specified, then the current "
+          "interpreter implementation is used.  Use 'py' to force "
+          "implementation-agnostic wheels."),
+)  # type: Callable[..., Option]
+
+
+abi = partial(
+    Option,
+    '--abi',
+    dest='abi',
+    metavar='abi',
+    default=None,
+    help=("Only use wheels compatible with Python "
+          "abi <abi>, e.g. 'pypy_41'.  If not specified, then the "
+          "current interpreter abi tag is used.  Generally "
+          "you will need to specify --implementation, "
+          "--platform, and --python-version when using "
+          "this option."),
+)  # type: Callable[..., Option]
+
+
+def add_target_python_options(cmd_opts):
+    # type: (OptionGroup) -> None
+    cmd_opts.add_option(platform())
+    cmd_opts.add_option(python_version())
+    cmd_opts.add_option(implementation())
+    cmd_opts.add_option(abi())
+
+
+def make_target_python(options):
+    # type: (Values) -> TargetPython
+    target_python = TargetPython(
+        platform=options.platform,
+        py_version_info=options.python_version,
+        abi=options.abi,
+        implementation=options.implementation,
+    )
+
+    return target_python
+
+
+def prefer_binary():
+    # type: () -> Option
+    return Option(
+        "--prefer-binary",
+        dest="prefer_binary",
+        action="store_true",
+        default=False,
+        help="Prefer older binary packages over newer source packages."
+    )
+
+
+cache_dir = partial(
+    PipOption,
+    "--cache-dir",
+    dest="cache_dir",
+    default=USER_CACHE_DIR,
+    metavar="dir",
+    type='path',
+    help="Store the cache data in <dir>."
+)  # type: Callable[..., Option]
+
+
+def _handle_no_cache_dir(option, opt, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    """
+    Process a value provided for the --no-cache-dir option.
+
+    This is an optparse.Option callback for the --no-cache-dir option.
+    """
+    # The value argument will be None if --no-cache-dir is passed via the
+    # command-line, since the option doesn't accept arguments.  However,
+    # the value can be non-None if the option is triggered e.g. by an
+    # environment variable, like PIP_NO_CACHE_DIR=true.
+    if value is not None:
+        # Then parse the string value to get argument error-checking.
+        try:
+            strtobool(value)
+        except ValueError as exc:
+            raise_option_error(parser, option=option, msg=str(exc))
+
+    # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool()
+    # converted to 0 (like "false" or "no") caused cache_dir to be disabled
+    # rather than enabled (logic would say the latter).  Thus, we disable
+    # the cache directory not just on values that parse to True, but (for
+    # backwards compatibility reasons) also on values that parse to False.
+    # In other words, always set it to False if the option is provided in
+    # some (valid) form.
+    parser.values.cache_dir = False
+
+
+no_cache = partial(
+    Option,
+    "--no-cache-dir",
+    dest="cache_dir",
+    action="callback",
+    callback=_handle_no_cache_dir,
+    help="Disable the cache.",
+)  # type: Callable[..., Option]
+
+no_deps = partial(
+    Option,
+    '--no-deps', '--no-dependencies',
+    dest='ignore_dependencies',
+    action='store_true',
+    default=False,
+    help="Don't install package dependencies.",
+)  # type: Callable[..., Option]
+
+
+def _handle_build_dir(option, opt, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    if value:
+        value = os.path.abspath(value)
+    setattr(parser.values, option.dest, value)
+
+
+build_dir = partial(
+    PipOption,
+    '-b', '--build', '--build-dir', '--build-directory',
+    dest='build_dir',
+    type='path',
+    metavar='dir',
+    action='callback',
+    callback=_handle_build_dir,
+    help='Directory to unpack packages into and build in. Note that '
+         'an initial build still takes place in a temporary directory. '
+         'The location of temporary directories can be controlled by setting '
+         'the TMPDIR environment variable (TEMP on Windows) appropriately. '
+         'When passed, build directories are not cleaned in case of failures.'
+)  # type: Callable[..., Option]
+
+ignore_requires_python = partial(
+    Option,
+    '--ignore-requires-python',
+    dest='ignore_requires_python',
+    action='store_true',
+    help='Ignore the Requires-Python information.'
+)  # type: Callable[..., Option]
+
+no_build_isolation = partial(
+    Option,
+    '--no-build-isolation',
+    dest='build_isolation',
+    action='store_false',
+    default=True,
+    help='Disable isolation when building a modern source distribution. '
+         'Build dependencies specified by PEP 518 must be already installed '
+         'if this option is used.'
+)  # type: Callable[..., Option]
+
+
+def _handle_no_use_pep517(option, opt, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    """
+    Process a value provided for the --no-use-pep517 option.
+
+    This is an optparse.Option callback for the no_use_pep517 option.
+    """
+    # Since --no-use-pep517 doesn't accept arguments, the value argument
+    # will be None if --no-use-pep517 is passed via the command-line.
+    # However, the value can be non-None if the option is triggered e.g.
+    # by an environment variable, for example "PIP_NO_USE_PEP517=true".
+    if value is not None:
+        msg = """A value was passed for --no-use-pep517,
+        probably using either the PIP_NO_USE_PEP517 environment variable
+        or the "no-use-pep517" config file option. Use an appropriate value
+        of the PIP_USE_PEP517 environment variable or the "use-pep517"
+        config file option instead.
+        """
+        raise_option_error(parser, option=option, msg=msg)
+
+    # Otherwise, --no-use-pep517 was passed via the command-line.
+    parser.values.use_pep517 = False
+
+
+use_pep517 = partial(
+    Option,
+    '--use-pep517',
+    dest='use_pep517',
+    action='store_true',
+    default=None,
+    help='Use PEP 517 for building source distributions '
+         '(use --no-use-pep517 to force legacy behaviour).'
+)  # type: Any
+
+no_use_pep517 = partial(
+    Option,
+    '--no-use-pep517',
+    dest='use_pep517',
+    action='callback',
+    callback=_handle_no_use_pep517,
+    default=None,
+    help=SUPPRESS_HELP
+)  # type: Any
+
+install_options = partial(
+    Option,
+    '--install-option',
+    dest='install_options',
+    action='append',
+    metavar='options',
+    help="Extra arguments to be supplied to the setup.py install "
+         "command (use like --install-option=\"--install-scripts=/usr/local/"
+         "bin\"). Use multiple --install-option options to pass multiple "
+         "options to setup.py install. If you are using an option with a "
+         "directory path, be sure to use absolute path.",
+)  # type: Callable[..., Option]
+
+global_options = partial(
+    Option,
+    '--global-option',
+    dest='global_options',
+    action='append',
+    metavar='options',
+    help="Extra global options to be supplied to the setup.py "
+         "call before the install command.",
+)  # type: Callable[..., Option]
+
+no_clean = partial(
+    Option,
+    '--no-clean',
+    action='store_true',
+    default=False,
+    help="Don't clean up build directories."
+)  # type: Callable[..., Option]
+
+pre = partial(
+    Option,
+    '--pre',
+    action='store_true',
+    default=False,
+    help="Include pre-release and development versions. By default, "
+         "pip only finds stable versions.",
+)  # type: Callable[..., Option]
+
+disable_pip_version_check = partial(
+    Option,
+    "--disable-pip-version-check",
+    dest="disable_pip_version_check",
+    action="store_true",
+    default=True,
+    help="Don't periodically check PyPI to determine whether a new version "
+         "of pip is available for download. Implied with --no-index.",
+)  # type: Callable[..., Option]
+
+
+# Deprecated, Remove later
+always_unzip = partial(
+    Option,
+    '-Z', '--always-unzip',
+    dest='always_unzip',
+    action='store_true',
+    help=SUPPRESS_HELP,
+)  # type: Callable[..., Option]
+
+
+def _handle_merge_hash(option, opt_str, value, parser):
+    # type: (Option, str, str, OptionParser) -> None
+    """Given a value spelled "algo:digest", append the digest to a list
+    pointed to in a dict by the algo name."""
+    if not parser.values.hashes:
+        parser.values.hashes = {}
+    try:
+        algo, digest = value.split(':', 1)
+    except ValueError:
+        parser.error('Arguments to %s must be a hash name '
+                     'followed by a value, like --hash=sha256:abcde...' %
+                     opt_str)
+    if algo not in STRONG_HASHES:
+        parser.error('Allowed hash algorithms for %s are %s.' %
+                     (opt_str, ', '.join(STRONG_HASHES)))
+    parser.values.hashes.setdefault(algo, []).append(digest)
+
+
+hash = partial(
+    Option,
+    '--hash',
+    # Hash values eventually end up in InstallRequirement.hashes due to
+    # __dict__ copying in process_line().
+    dest='hashes',
+    action='callback',
+    callback=_handle_merge_hash,
+    type='string',
+    help="Verify that the package's archive matches this "
+         'hash before installing. Example: --hash=sha256:abcdef...',
+)  # type: Callable[..., Option]
+
+
+require_hashes = partial(
+    Option,
+    '--require-hashes',
+    dest='require_hashes',
+    action='store_true',
+    default=False,
+    help='Require a hash to check each requirement against, for '
+         'repeatable installs. This option is implied when any package in a '
+         'requirements file has a --hash option.',
+)  # type: Callable[..., Option]
+
+
+list_path = partial(
+    PipOption,
+    '--path',
+    dest='path',
+    type='path',
+    action='append',
+    help='Restrict to the specified installation path for listing '
+         'packages (can be used multiple times).'
+)  # type: Callable[..., Option]
+
+
+def check_list_path_option(options):
+    # type: (Values) -> None
+    if options.path and (options.user or options.local):
+        raise CommandError(
+            "Cannot combine '--path' with '--user' or '--local'"
+        )
+
+
+no_python_version_warning = partial(
+    Option,
+    '--no-python-version-warning',
+    dest='no_python_version_warning',
+    action='store_true',
+    default=False,
+    help='Silence deprecation warnings for upcoming unsupported Pythons.',
+)  # type: Callable[..., Option]
+
+
+##########
+# groups #
+##########
+
+general_group = {
+    'name': 'General Options',
+    'options': [
+        help_,
+        isolated_mode,
+        require_virtualenv,
+        verbose,
+        version,
+        quiet,
+        log,
+        no_input,
+        proxy,
+        retries,
+        timeout,
+        skip_requirements_regex,
+        exists_action,
+        trusted_host,
+        cert,
+        client_cert,
+        cache_dir,
+        no_cache,
+        disable_pip_version_check,
+        no_color,
+        no_python_version_warning,
+    ]
+}  # type: Dict[str, Any]
+
+index_group = {
+    'name': 'Package Index Options',
+    'options': [
+        index_url,
+        extra_index_url,
+        no_index,
+        find_links,
+    ]
+}  # type: Dict[str, Any]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1a64a776062a95258d3331cdec9b987e433ddf9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/command_context.py
@@ -0,0 +1,36 @@
+from contextlib import contextmanager
+
+from pip._vendor.contextlib2 import ExitStack
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Iterator, ContextManager, TypeVar
+
+    _T = TypeVar('_T', covariant=True)
+
+
+class CommandContextMixIn(object):
+    def __init__(self):
+        # type: () -> None
+        super(CommandContextMixIn, self).__init__()
+        self._in_main_context = False
+        self._main_context = ExitStack()
+
+    @contextmanager
+    def main_context(self):
+        # type: () -> Iterator[None]
+        assert not self._in_main_context
+
+        self._in_main_context = True
+        try:
+            with self._main_context:
+                yield
+        finally:
+            self._in_main_context = False
+
+    def enter_context(self, context_provider):
+        # type: (ContextManager[_T]) -> _T
+        assert self._in_main_context
+
+        return self._main_context.enter_context(context_provider)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..5e97a5103f6af5baded5758f0ee41eb1aa641cc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main.py
@@ -0,0 +1,75 @@
+"""Primary application entrypoint.
+"""
+from __future__ import absolute_import
+
+import locale
+import logging
+import os
+import sys
+
+from pip._internal.cli.autocompletion import autocomplete
+from pip._internal.cli.main_parser import parse_command
+from pip._internal.commands import create_command
+from pip._internal.exceptions import PipError
+from pip._internal.utils import deprecation
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional
+
+logger = logging.getLogger(__name__)
+
+
+# Do not import and use main() directly! Using it directly is actively
+# discouraged by pip's maintainers. The name, location and behavior of
+# this function is subject to change, so calling it directly is not
+# portable across different pip versions.
+
+# In addition, running pip in-process is unsupported and unsafe. This is
+# elaborated in detail at
+# https://pip.pypa.io/en/stable/user_guide/#using-pip-from-your-program.
+# That document also provides suggestions that should work for nearly
+# all users that are considering importing and using main() directly.
+
+# However, we know that certain users will still want to invoke pip
+# in-process. If you understand and accept the implications of using pip
+# in an unsupported manner, the best approach is to use runpy to avoid
+# depending on the exact location of this entry point.
+
+# The following example shows how to use runpy to invoke pip in that
+# case:
+#
+#     sys.argv = ["pip", your, args, here]
+#     runpy.run_module("pip", run_name="__main__")
+#
+# Note that this will exit the process after running, unlike a direct
+# call to main. As it is not safe to do any processing after calling
+# main, this should not be an issue in practice.
+
+def main(args=None):
+    # type: (Optional[List[str]]) -> int
+    if args is None:
+        args = sys.argv[1:]
+
+    # Configure our deprecation warnings to be sent through loggers
+    deprecation.install_warning_logger()
+
+    autocomplete()
+
+    try:
+        cmd_name, cmd_args = parse_command(args)
+    except PipError as exc:
+        sys.stderr.write("ERROR: %s" % exc)
+        sys.stderr.write(os.linesep)
+        sys.exit(1)
+
+    # Needed for locale.getpreferredencoding(False) to work
+    # in pip._internal.utils.encoding.auto_decode
+    try:
+        locale.setlocale(locale.LC_ALL, '')
+    except locale.Error as e:
+        # setlocale can apparently crash if locale are uninitialized
+        logger.debug("Ignoring error %s when setting locale", e)
+    command = create_command(cmd_name, isolated=("--isolated" in cmd_args))
+
+    return command.main(cmd_args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..a89821d44890ee9a89b186c66c9ce12d5ccc02dc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py
@@ -0,0 +1,99 @@
+"""A single place for constructing and exposing the main parser
+"""
+
+import os
+import sys
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.parser import (
+    ConfigOptionParser,
+    UpdatingDefaultsHelpFormatter,
+)
+from pip._internal.commands import commands_dict, get_similar_commands
+from pip._internal.exceptions import CommandError
+from pip._internal.utils.misc import get_pip_version, get_prog
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Tuple, List
+
+
+__all__ = ["create_main_parser", "parse_command"]
+
+
+def create_main_parser():
+    # type: () -> ConfigOptionParser
+    """Creates and returns the main parser for pip's CLI
+    """
+
+    parser_kw = {
+        'usage': '\n%prog <command> [options]',
+        'add_help_option': False,
+        'formatter': UpdatingDefaultsHelpFormatter(),
+        'name': 'global',
+        'prog': get_prog(),
+    }
+
+    parser = ConfigOptionParser(**parser_kw)
+    parser.disable_interspersed_args()
+
+    parser.version = get_pip_version()
+
+    # add the general options
+    gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser)
+    parser.add_option_group(gen_opts)
+
+    # so the help formatter knows
+    parser.main = True  # type: ignore
+
+    # create command listing for description
+    description = [''] + [
+        '%-27s %s' % (name, command_info.summary)
+        for name, command_info in commands_dict.items()
+    ]
+    parser.description = '\n'.join(description)
+
+    return parser
+
+
+def parse_command(args):
+    # type: (List[str]) -> Tuple[str, List[str]]
+    parser = create_main_parser()
+
+    # Note: parser calls disable_interspersed_args(), so the result of this
+    # call is to split the initial args into the general options before the
+    # subcommand and everything else.
+    # For example:
+    #  args: ['--timeout=5', 'install', '--user', 'INITools']
+    #  general_options: ['--timeout==5']
+    #  args_else: ['install', '--user', 'INITools']
+    general_options, args_else = parser.parse_args(args)
+
+    # --version
+    if general_options.version:
+        sys.stdout.write(parser.version)  # type: ignore
+        sys.stdout.write(os.linesep)
+        sys.exit()
+
+    # pip || pip help -> print_help()
+    if not args_else or (args_else[0] == 'help' and len(args_else) == 1):
+        parser.print_help()
+        sys.exit()
+
+    # the subcommand name
+    cmd_name = args_else[0]
+
+    if cmd_name not in commands_dict:
+        guess = get_similar_commands(cmd_name)
+
+        msg = ['unknown command "%s"' % cmd_name]
+        if guess:
+            msg.append('maybe you meant "%s"' % guess)
+
+        raise CommandError(' - '.join(msg))
+
+    # all the args without the subcommand
+    cmd_args = args[:]
+    cmd_args.remove(cmd_name)
+
+    return cmd_name, cmd_args
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..c99456bae88d0c73ab79a671b440993c8195568d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/parser.py
@@ -0,0 +1,265 @@
+"""Base option parser setup"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import optparse
+import sys
+import textwrap
+from distutils.util import strtobool
+
+from pip._vendor.six import string_types
+
+from pip._internal.cli.status_codes import UNKNOWN_ERROR
+from pip._internal.configuration import Configuration, ConfigurationError
+from pip._internal.utils.compat import get_terminal_size
+
+logger = logging.getLogger(__name__)
+
+
+class PrettyHelpFormatter(optparse.IndentedHelpFormatter):
+    """A prettier/less verbose help formatter for optparse."""
+
+    def __init__(self, *args, **kwargs):
+        # help position must be aligned with __init__.parseopts.description
+        kwargs['max_help_position'] = 30
+        kwargs['indent_increment'] = 1
+        kwargs['width'] = get_terminal_size()[0] - 2
+        optparse.IndentedHelpFormatter.__init__(self, *args, **kwargs)
+
+    def format_option_strings(self, option):
+        return self._format_option_strings(option, ' <%s>', ', ')
+
+    def _format_option_strings(self, option, mvarfmt=' <%s>', optsep=', '):
+        """
+        Return a comma-separated list of option strings and metavars.
+
+        :param option:  tuple of (short opt, long opt), e.g: ('-f', '--format')
+        :param mvarfmt: metavar format string - evaluated as mvarfmt % metavar
+        :param optsep:  separator
+        """
+        opts = []
+
+        if option._short_opts:
+            opts.append(option._short_opts[0])
+        if option._long_opts:
+            opts.append(option._long_opts[0])
+        if len(opts) > 1:
+            opts.insert(1, optsep)
+
+        if option.takes_value():
+            metavar = option.metavar or option.dest.lower()
+            opts.append(mvarfmt % metavar.lower())
+
+        return ''.join(opts)
+
+    def format_heading(self, heading):
+        if heading == 'Options':
+            return ''
+        return heading + ':\n'
+
+    def format_usage(self, usage):
+        """
+        Ensure there is only one newline between usage and the first heading
+        if there is no description.
+        """
+        msg = '\nUsage: %s\n' % self.indent_lines(textwrap.dedent(usage), "  ")
+        return msg
+
+    def format_description(self, description):
+        # leave full control over description to us
+        if description:
+            if hasattr(self.parser, 'main'):
+                label = 'Commands'
+            else:
+                label = 'Description'
+            # some doc strings have initial newlines, some don't
+            description = description.lstrip('\n')
+            # some doc strings have final newlines and spaces, some don't
+            description = description.rstrip()
+            # dedent, then reindent
+            description = self.indent_lines(textwrap.dedent(description), "  ")
+            description = '%s:\n%s\n' % (label, description)
+            return description
+        else:
+            return ''
+
+    def format_epilog(self, epilog):
+        # leave full control over epilog to us
+        if epilog:
+            return epilog
+        else:
+            return ''
+
+    def indent_lines(self, text, indent):
+        new_lines = [indent + line for line in text.split('\n')]
+        return "\n".join(new_lines)
+
+
+class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter):
+    """Custom help formatter for use in ConfigOptionParser.
+
+    This is updates the defaults before expanding them, allowing
+    them to show up correctly in the help listing.
+    """
+
+    def expand_default(self, option):
+        if self.parser is not None:
+            self.parser._update_defaults(self.parser.defaults)
+        return optparse.IndentedHelpFormatter.expand_default(self, option)
+
+
+class CustomOptionParser(optparse.OptionParser):
+
+    def insert_option_group(self, idx, *args, **kwargs):
+        """Insert an OptionGroup at a given position."""
+        group = self.add_option_group(*args, **kwargs)
+
+        self.option_groups.pop()
+        self.option_groups.insert(idx, group)
+
+        return group
+
+    @property
+    def option_list_all(self):
+        """Get a list of all options, including those in option groups."""
+        res = self.option_list[:]
+        for i in self.option_groups:
+            res.extend(i.option_list)
+
+        return res
+
+
+class ConfigOptionParser(CustomOptionParser):
+    """Custom option parser which updates its defaults by checking the
+    configuration files and environmental variables"""
+
+    def __init__(self, *args, **kwargs):
+        self.name = kwargs.pop('name')
+
+        isolated = kwargs.pop("isolated", False)
+        self.config = Configuration(isolated)
+
+        assert self.name
+        optparse.OptionParser.__init__(self, *args, **kwargs)
+
+    def check_default(self, option, key, val):
+        try:
+            return option.check_value(key, val)
+        except optparse.OptionValueError as exc:
+            print("An error occurred during configuration: %s" % exc)
+            sys.exit(3)
+
+    def _get_ordered_configuration_items(self):
+        # Configuration gives keys in an unordered manner. Order them.
+        override_order = ["global", self.name, ":env:"]
+
+        # Pool the options into different groups
+        section_items = {name: [] for name in override_order}
+        for section_key, val in self.config.items():
+            # ignore empty values
+            if not val:
+                logger.debug(
+                    "Ignoring configuration key '%s' as it's value is empty.",
+                    section_key
+                )
+                continue
+
+            section, key = section_key.split(".", 1)
+            if section in override_order:
+                section_items[section].append((key, val))
+
+        # Yield each group in their override order
+        for section in override_order:
+            for key, val in section_items[section]:
+                yield key, val
+
+    def _update_defaults(self, defaults):
+        """Updates the given defaults with values from the config files and
+        the environ. Does a little special handling for certain types of
+        options (lists)."""
+
+        # Accumulate complex default state.
+        self.values = optparse.Values(self.defaults)
+        late_eval = set()
+        # Then set the options with those values
+        for key, val in self._get_ordered_configuration_items():
+            # '--' because configuration supports only long names
+            option = self.get_option('--' + key)
+
+            # Ignore options not present in this parser. E.g. non-globals put
+            # in [global] by users that want them to apply to all applicable
+            # commands.
+            if option is None:
+                continue
+
+            if option.action in ('store_true', 'store_false', 'count'):
+                try:
+                    val = strtobool(val)
+                except ValueError:
+                    error_msg = invalid_config_error_message(
+                        option.action, key, val
+                    )
+                    self.error(error_msg)
+
+            elif option.action == 'append':
+                val = val.split()
+                val = [self.check_default(option, key, v) for v in val]
+            elif option.action == 'callback':
+                late_eval.add(option.dest)
+                opt_str = option.get_opt_string()
+                val = option.convert_value(opt_str, val)
+                # From take_action
+                args = option.callback_args or ()
+                kwargs = option.callback_kwargs or {}
+                option.callback(option, opt_str, val, self, *args, **kwargs)
+            else:
+                val = self.check_default(option, key, val)
+
+            defaults[option.dest] = val
+
+        for key in late_eval:
+            defaults[key] = getattr(self.values, key)
+        self.values = None
+        return defaults
+
+    def get_default_values(self):
+        """Overriding to make updating the defaults after instantiation of
+        the option parser possible, _update_defaults() does the dirty work."""
+        if not self.process_default_values:
+            # Old, pre-Optik 1.5 behaviour.
+            return optparse.Values(self.defaults)
+
+        # Load the configuration, or error out in case of an error
+        try:
+            self.config.load()
+        except ConfigurationError as err:
+            self.exit(UNKNOWN_ERROR, str(err))
+
+        defaults = self._update_defaults(self.defaults.copy())  # ours
+        for option in self._get_all_options():
+            default = defaults.get(option.dest)
+            if isinstance(default, string_types):
+                opt_str = option.get_opt_string()
+                defaults[option.dest] = option.check_value(opt_str, default)
+        return optparse.Values(defaults)
+
+    def error(self, msg):
+        self.print_usage(sys.stderr)
+        self.exit(UNKNOWN_ERROR, "%s\n" % msg)
+
+
+def invalid_config_error_message(action, key, val):
+    """Returns a better error message when invalid configuration option
+    is provided."""
+    if action in ('store_true', 'store_false'):
+        return ("{0} is not a valid value for {1} option, "
+                "please specify a boolean value like yes/no, "
+                "true/false or 1/0 instead.").format(val, key)
+
+    return ("{0} is not a valid value for {1} option, "
+            "please specify a numerical value like 1/0 "
+            "instead.").format(val, key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py
new file mode 100644
index 0000000000000000000000000000000000000000..9383b3b8dca756dea6a37b3f71cb3e556b60dfe9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/req_command.py
@@ -0,0 +1,333 @@
+"""Contains the Command base classes that depend on PipSession.
+
+The classes in this module are in a separate module so the commands not
+needing download / PackageFinder capability don't unnecessarily import the
+PackageFinder machinery and all its vendored dependencies, etc.
+"""
+
+import logging
+import os
+from functools import partial
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.command_context import CommandContextMixIn
+from pip._internal.exceptions import CommandError
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.legacy_resolve import Resolver
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.network.download import Downloader
+from pip._internal.network.session import PipSession
+from pip._internal.operations.prepare import RequirementPreparer
+from pip._internal.req.constructors import (
+    install_req_from_editable,
+    install_req_from_line,
+    install_req_from_req_string,
+)
+from pip._internal.req.req_file import parse_requirements
+from pip._internal.self_outdated_check import (
+    make_link_collector,
+    pip_self_version_check,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from optparse import Values
+    from typing import List, Optional, Tuple
+    from pip._internal.cache import WheelCache
+    from pip._internal.models.target_python import TargetPython
+    from pip._internal.req.req_set import RequirementSet
+    from pip._internal.req.req_tracker import RequirementTracker
+    from pip._internal.utils.temp_dir import TempDirectory
+
+logger = logging.getLogger(__name__)
+
+
+class SessionCommandMixin(CommandContextMixIn):
+
+    """
+    A class mixin for command classes needing _build_session().
+    """
+    def __init__(self):
+        # type: () -> None
+        super(SessionCommandMixin, self).__init__()
+        self._session = None  # Optional[PipSession]
+
+    @classmethod
+    def _get_index_urls(cls, options):
+        # type: (Values) -> Optional[List[str]]
+        """Return a list of index urls from user-provided options."""
+        index_urls = []
+        if not getattr(options, "no_index", False):
+            url = getattr(options, "index_url", None)
+            if url:
+                index_urls.append(url)
+        urls = getattr(options, "extra_index_urls", None)
+        if urls:
+            index_urls.extend(urls)
+        # Return None rather than an empty list
+        return index_urls or None
+
+    def get_default_session(self, options):
+        # type: (Values) -> PipSession
+        """Get a default-managed session."""
+        if self._session is None:
+            self._session = self.enter_context(self._build_session(options))
+            # there's no type annotation on requests.Session, so it's
+            # automatically ContextManager[Any] and self._session becomes Any,
+            # then https://github.com/python/mypy/issues/7696 kicks in
+            assert self._session is not None
+        return self._session
+
+    def _build_session(self, options, retries=None, timeout=None):
+        # type: (Values, Optional[int], Optional[int]) -> PipSession
+        assert not options.cache_dir or os.path.isabs(options.cache_dir)
+        session = PipSession(
+            cache=(
+                os.path.join(options.cache_dir, "http")
+                if options.cache_dir else None
+            ),
+            retries=retries if retries is not None else options.retries,
+            trusted_hosts=options.trusted_hosts,
+            index_urls=self._get_index_urls(options),
+        )
+
+        # Handle custom ca-bundles from the user
+        if options.cert:
+            session.verify = options.cert
+
+        # Handle SSL client certificate
+        if options.client_cert:
+            session.cert = options.client_cert
+
+        # Handle timeouts
+        if options.timeout or timeout:
+            session.timeout = (
+                timeout if timeout is not None else options.timeout
+            )
+
+        # Handle configured proxies
+        if options.proxy:
+            session.proxies = {
+                "http": options.proxy,
+                "https": options.proxy,
+            }
+
+        # Determine if we can prompt the user for authentication or not
+        session.auth.prompting = not options.no_input
+
+        return session
+
+
+class IndexGroupCommand(Command, SessionCommandMixin):
+
+    """
+    Abstract base class for commands with the index_group options.
+
+    This also corresponds to the commands that permit the pip version check.
+    """
+
+    def handle_pip_version_check(self, options):
+        # type: (Values) -> None
+        """
+        Do the pip version check if not disabled.
+
+        This overrides the default behavior of not doing the check.
+        """
+        # Make sure the index_group options are present.
+        assert hasattr(options, 'no_index')
+
+        if options.disable_pip_version_check or options.no_index:
+            return
+
+        # Otherwise, check if we're using the latest version of pip available.
+        session = self._build_session(
+            options,
+            retries=0,
+            timeout=min(5, options.timeout)
+        )
+        with session:
+            pip_self_version_check(session, options)
+
+
+class RequirementCommand(IndexGroupCommand):
+
+    @staticmethod
+    def make_requirement_preparer(
+        temp_build_dir,           # type: TempDirectory
+        options,                  # type: Values
+        req_tracker,              # type: RequirementTracker
+        session,                  # type: PipSession
+        finder,                   # type: PackageFinder
+        use_user_site,            # type: bool
+        download_dir=None,        # type: str
+        wheel_download_dir=None,  # type: str
+    ):
+        # type: (...) -> RequirementPreparer
+        """
+        Create a RequirementPreparer instance for the given parameters.
+        """
+        downloader = Downloader(session, progress_bar=options.progress_bar)
+
+        temp_build_dir_path = temp_build_dir.path
+        assert temp_build_dir_path is not None
+
+        return RequirementPreparer(
+            build_dir=temp_build_dir_path,
+            src_dir=options.src_dir,
+            download_dir=download_dir,
+            wheel_download_dir=wheel_download_dir,
+            build_isolation=options.build_isolation,
+            req_tracker=req_tracker,
+            downloader=downloader,
+            finder=finder,
+            require_hashes=options.require_hashes,
+            use_user_site=use_user_site,
+        )
+
+    @staticmethod
+    def make_resolver(
+        preparer,                            # type: RequirementPreparer
+        finder,                              # type: PackageFinder
+        options,                             # type: Values
+        wheel_cache=None,                    # type: Optional[WheelCache]
+        use_user_site=False,                 # type: bool
+        ignore_installed=True,               # type: bool
+        ignore_requires_python=False,        # type: bool
+        force_reinstall=False,               # type: bool
+        upgrade_strategy="to-satisfy-only",  # type: str
+        use_pep517=None,                     # type: Optional[bool]
+        py_version_info=None            # type: Optional[Tuple[int, ...]]
+    ):
+        # type: (...) -> Resolver
+        """
+        Create a Resolver instance for the given parameters.
+        """
+        make_install_req = partial(
+            install_req_from_req_string,
+            isolated=options.isolated_mode,
+            wheel_cache=wheel_cache,
+            use_pep517=use_pep517,
+        )
+        return Resolver(
+            preparer=preparer,
+            finder=finder,
+            make_install_req=make_install_req,
+            use_user_site=use_user_site,
+            ignore_dependencies=options.ignore_dependencies,
+            ignore_installed=ignore_installed,
+            ignore_requires_python=ignore_requires_python,
+            force_reinstall=force_reinstall,
+            upgrade_strategy=upgrade_strategy,
+            py_version_info=py_version_info,
+        )
+
+    def populate_requirement_set(
+        self,
+        requirement_set,  # type: RequirementSet
+        args,             # type: List[str]
+        options,          # type: Values
+        finder,           # type: PackageFinder
+        session,          # type: PipSession
+        wheel_cache,      # type: Optional[WheelCache]
+    ):
+        # type: (...) -> None
+        """
+        Marshal cmd line args into a requirement set.
+        """
+        for filename in options.constraints:
+            for req_to_add in parse_requirements(
+                    filename,
+                    constraint=True, finder=finder, options=options,
+                    session=session, wheel_cache=wheel_cache):
+                req_to_add.is_direct = True
+                requirement_set.add_requirement(req_to_add)
+
+        for req in args:
+            req_to_add = install_req_from_line(
+                req, None, isolated=options.isolated_mode,
+                use_pep517=options.use_pep517,
+                wheel_cache=wheel_cache
+            )
+            req_to_add.is_direct = True
+            requirement_set.add_requirement(req_to_add)
+
+        for req in options.editables:
+            req_to_add = install_req_from_editable(
+                req,
+                isolated=options.isolated_mode,
+                use_pep517=options.use_pep517,
+                wheel_cache=wheel_cache
+            )
+            req_to_add.is_direct = True
+            requirement_set.add_requirement(req_to_add)
+
+        # NOTE: options.require_hashes may be set if --require-hashes is True
+        for filename in options.requirements:
+            for req_to_add in parse_requirements(
+                    filename,
+                    finder=finder, options=options, session=session,
+                    wheel_cache=wheel_cache,
+                    use_pep517=options.use_pep517):
+                req_to_add.is_direct = True
+                requirement_set.add_requirement(req_to_add)
+
+        # If any requirement has hash options, enable hash checking.
+        requirements = (
+            requirement_set.unnamed_requirements +
+            list(requirement_set.requirements.values())
+        )
+        if any(req.has_hash_options for req in requirements):
+            options.require_hashes = True
+
+        if not (args or options.editables or options.requirements):
+            opts = {'name': self.name}
+            if options.find_links:
+                raise CommandError(
+                    'You must give at least one requirement to %(name)s '
+                    '(maybe you meant "pip %(name)s %(links)s"?)' %
+                    dict(opts, links=' '.join(options.find_links)))
+            else:
+                raise CommandError(
+                    'You must give at least one requirement to %(name)s '
+                    '(see "pip help %(name)s")' % opts)
+
+    @staticmethod
+    def trace_basic_info(finder):
+        # type: (PackageFinder) -> None
+        """
+        Trace basic information about the provided objects.
+        """
+        # Display where finder is looking for packages
+        search_scope = finder.search_scope
+        locations = search_scope.get_formatted_locations()
+        if locations:
+            logger.info(locations)
+
+    def _build_package_finder(
+        self,
+        options,               # type: Values
+        session,               # type: PipSession
+        target_python=None,    # type: Optional[TargetPython]
+        ignore_requires_python=None,  # type: Optional[bool]
+    ):
+        # type: (...) -> PackageFinder
+        """
+        Create a package finder appropriate to this requirement command.
+
+        :param ignore_requires_python: Whether to ignore incompatible
+            "Requires-Python" values in links. Defaults to False.
+        """
+        link_collector = make_link_collector(session, options=options)
+        selection_prefs = SelectionPreferences(
+            allow_yanked=True,
+            format_control=options.format_control,
+            allow_all_prereleases=options.pre,
+            prefer_binary=options.prefer_binary,
+            ignore_requires_python=ignore_requires_python,
+        )
+
+        return PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+            target_python=target_python,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py
new file mode 100644
index 0000000000000000000000000000000000000000..275360a3175abaeab86148d61b735904f96d72f6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py
@@ -0,0 +1,8 @@
+from __future__ import absolute_import
+
+SUCCESS = 0
+ERROR = 1
+UNKNOWN_ERROR = 2
+VIRTUALENV_NOT_FOUND = 3
+PREVIOUS_BUILD_DIR_ERROR = 4
+NO_MATCHES_FOUND = 23
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a311f8fc8930735a39eee61cf701db1f2a35daa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/__init__.py
@@ -0,0 +1,114 @@
+"""
+Package containing all pip commands
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import importlib
+from collections import OrderedDict, namedtuple
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any
+    from pip._internal.cli.base_command import Command
+
+
+CommandInfo = namedtuple('CommandInfo', 'module_path, class_name, summary')
+
+# The ordering matters for help display.
+#    Also, even though the module path starts with the same
+# "pip._internal.commands" prefix in each case, we include the full path
+# because it makes testing easier (specifically when modifying commands_dict
+# in test setup / teardown by adding info for a FakeCommand class defined
+# in a test-related module).
+#    Finally, we need to pass an iterable of pairs here rather than a dict
+# so that the ordering won't be lost when using Python 2.7.
+commands_dict = OrderedDict([
+    ('install', CommandInfo(
+        'pip._internal.commands.install', 'InstallCommand',
+        'Install packages.',
+    )),
+    ('download', CommandInfo(
+        'pip._internal.commands.download', 'DownloadCommand',
+        'Download packages.',
+    )),
+    ('uninstall', CommandInfo(
+        'pip._internal.commands.uninstall', 'UninstallCommand',
+        'Uninstall packages.',
+    )),
+    ('freeze', CommandInfo(
+        'pip._internal.commands.freeze', 'FreezeCommand',
+        'Output installed packages in requirements format.',
+    )),
+    ('list', CommandInfo(
+        'pip._internal.commands.list', 'ListCommand',
+        'List installed packages.',
+    )),
+    ('show', CommandInfo(
+        'pip._internal.commands.show', 'ShowCommand',
+        'Show information about installed packages.',
+    )),
+    ('check', CommandInfo(
+        'pip._internal.commands.check', 'CheckCommand',
+        'Verify installed packages have compatible dependencies.',
+    )),
+    ('config', CommandInfo(
+        'pip._internal.commands.configuration', 'ConfigurationCommand',
+        'Manage local and global configuration.',
+    )),
+    ('search', CommandInfo(
+        'pip._internal.commands.search', 'SearchCommand',
+        'Search PyPI for packages.',
+    )),
+    ('wheel', CommandInfo(
+        'pip._internal.commands.wheel', 'WheelCommand',
+        'Build wheels from your requirements.',
+    )),
+    ('hash', CommandInfo(
+        'pip._internal.commands.hash', 'HashCommand',
+        'Compute hashes of package archives.',
+    )),
+    ('completion', CommandInfo(
+        'pip._internal.commands.completion', 'CompletionCommand',
+        'A helper command used for command completion.',
+    )),
+    ('debug', CommandInfo(
+        'pip._internal.commands.debug', 'DebugCommand',
+        'Show information useful for debugging.',
+    )),
+    ('help', CommandInfo(
+        'pip._internal.commands.help', 'HelpCommand',
+        'Show help for commands.',
+    )),
+])  # type: OrderedDict[str, CommandInfo]
+
+
+def create_command(name, **kwargs):
+    # type: (str, **Any) -> Command
+    """
+    Create an instance of the Command class with the given name.
+    """
+    module_path, class_name, summary = commands_dict[name]
+    module = importlib.import_module(module_path)
+    command_class = getattr(module, class_name)
+    command = command_class(name=name, summary=summary, **kwargs)
+
+    return command
+
+
+def get_similar_commands(name):
+    """Command name auto-correct."""
+    from difflib import get_close_matches
+
+    name = name.lower()
+
+    close_commands = get_close_matches(name, commands_dict.keys())
+
+    if close_commands:
+        return close_commands[0]
+    else:
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py
new file mode 100644
index 0000000000000000000000000000000000000000..968944611ea7e284dac912c36d63816c7ca585b4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/check.py
@@ -0,0 +1,45 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import logging
+
+from pip._internal.cli.base_command import Command
+from pip._internal.operations.check import (
+    check_package_set,
+    create_package_set_from_installed,
+)
+from pip._internal.utils.misc import write_output
+
+logger = logging.getLogger(__name__)
+
+
+class CheckCommand(Command):
+    """Verify installed packages have compatible dependencies."""
+
+    usage = """
+      %prog [options]"""
+
+    def run(self, options, args):
+        package_set, parsing_probs = create_package_set_from_installed()
+        missing, conflicting = check_package_set(package_set)
+
+        for project_name in missing:
+            version = package_set[project_name].version
+            for dependency in missing[project_name]:
+                write_output(
+                    "%s %s requires %s, which is not installed.",
+                    project_name, version, dependency[0],
+                )
+
+        for project_name in conflicting:
+            version = package_set[project_name].version
+            for dep_name, dep_version, req in conflicting[project_name]:
+                write_output(
+                    "%s %s has requirement %s, but you have %s %s.",
+                    project_name, version, req, dep_name, dep_version,
+                )
+
+        if missing or conflicting or parsing_probs:
+            return 1
+        else:
+            write_output("No broken requirements found.")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py
new file mode 100644
index 0000000000000000000000000000000000000000..c532806e3866e652063c92226716c11edbf116b1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/completion.py
@@ -0,0 +1,96 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import sys
+import textwrap
+
+from pip._internal.cli.base_command import Command
+from pip._internal.utils.misc import get_prog
+
+BASE_COMPLETION = """
+# pip %(shell)s completion start%(script)s# pip %(shell)s completion end
+"""
+
+COMPLETION_SCRIPTS = {
+    'bash': """
+        _pip_completion()
+        {
+            COMPREPLY=( $( COMP_WORDS="${COMP_WORDS[*]}" \\
+                           COMP_CWORD=$COMP_CWORD \\
+                           PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) )
+        }
+        complete -o default -F _pip_completion %(prog)s
+    """,
+    'zsh': """
+        function _pip_completion {
+          local words cword
+          read -Ac words
+          read -cn cword
+          reply=( $( COMP_WORDS="$words[*]" \\
+                     COMP_CWORD=$(( cword-1 )) \\
+                     PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ))
+        }
+        compctl -K _pip_completion %(prog)s
+    """,
+    'fish': """
+        function __fish_complete_pip
+            set -lx COMP_WORDS (commandline -o) ""
+            set -lx COMP_CWORD ( \\
+                math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\
+            )
+            set -lx PIP_AUTO_COMPLETE 1
+            string split \\  -- (eval $COMP_WORDS[1])
+        end
+        complete -fa "(__fish_complete_pip)" -c %(prog)s
+    """,
+}
+
+
+class CompletionCommand(Command):
+    """A helper command to be used for command completion."""
+
+    ignore_require_venv = True
+
+    def __init__(self, *args, **kw):
+        super(CompletionCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+
+        cmd_opts.add_option(
+            '--bash', '-b',
+            action='store_const',
+            const='bash',
+            dest='shell',
+            help='Emit completion code for bash')
+        cmd_opts.add_option(
+            '--zsh', '-z',
+            action='store_const',
+            const='zsh',
+            dest='shell',
+            help='Emit completion code for zsh')
+        cmd_opts.add_option(
+            '--fish', '-f',
+            action='store_const',
+            const='fish',
+            dest='shell',
+            help='Emit completion code for fish')
+
+        self.parser.insert_option_group(0, cmd_opts)
+
+    def run(self, options, args):
+        """Prints the completion code of the given shell"""
+        shells = COMPLETION_SCRIPTS.keys()
+        shell_options = ['--' + shell for shell in sorted(shells)]
+        if options.shell in shells:
+            script = textwrap.dedent(
+                COMPLETION_SCRIPTS.get(options.shell, '') % {
+                    'prog': get_prog(),
+                }
+            )
+            print(BASE_COMPLETION % {'script': script, 'shell': options.shell})
+        else:
+            sys.stderr.write(
+                'ERROR: You must pass %s\n' % ' or '.join(shell_options)
+            )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py
new file mode 100644
index 0000000000000000000000000000000000000000..efcf5bb3699f9e9c3111adb6975dabaa8887b08f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/configuration.py
@@ -0,0 +1,233 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import logging
+import os
+import subprocess
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.configuration import (
+    Configuration,
+    get_configuration_files,
+    kinds,
+)
+from pip._internal.exceptions import PipError
+from pip._internal.utils.misc import get_prog, write_output
+
+logger = logging.getLogger(__name__)
+
+
+class ConfigurationCommand(Command):
+    """Manage local and global configuration.
+
+        Subcommands:
+
+        list: List the active configuration (or from the file specified)
+        edit: Edit the configuration file in an editor
+        get: Get the value associated with name
+        set: Set the name=value
+        unset: Unset the value associated with name
+
+        If none of --user, --global and --site are passed, a virtual
+        environment configuration file is used if one is active and the file
+        exists. Otherwise, all modifications happen on the to the user file by
+        default.
+    """
+
+    ignore_require_venv = True
+    usage = """
+        %prog [<file-option>] list
+        %prog [<file-option>] [--editor <editor-path>] edit
+
+        %prog [<file-option>] get name
+        %prog [<file-option>] set name value
+        %prog [<file-option>] unset name
+    """
+
+    def __init__(self, *args, **kwargs):
+        super(ConfigurationCommand, self).__init__(*args, **kwargs)
+
+        self.configuration = None
+
+        self.cmd_opts.add_option(
+            '--editor',
+            dest='editor',
+            action='store',
+            default=None,
+            help=(
+                'Editor to use to edit the file. Uses VISUAL or EDITOR '
+                'environment variables if not provided.'
+            )
+        )
+
+        self.cmd_opts.add_option(
+            '--global',
+            dest='global_file',
+            action='store_true',
+            default=False,
+            help='Use the system-wide configuration file only'
+        )
+
+        self.cmd_opts.add_option(
+            '--user',
+            dest='user_file',
+            action='store_true',
+            default=False,
+            help='Use the user configuration file only'
+        )
+
+        self.cmd_opts.add_option(
+            '--site',
+            dest='site_file',
+            action='store_true',
+            default=False,
+            help='Use the current environment configuration file only'
+        )
+
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        handlers = {
+            "list": self.list_values,
+            "edit": self.open_in_editor,
+            "get": self.get_name,
+            "set": self.set_name_value,
+            "unset": self.unset_name
+        }
+
+        # Determine action
+        if not args or args[0] not in handlers:
+            logger.error("Need an action ({}) to perform.".format(
+                ", ".join(sorted(handlers)))
+            )
+            return ERROR
+
+        action = args[0]
+
+        # Determine which configuration files are to be loaded
+        #    Depends on whether the command is modifying.
+        try:
+            load_only = self._determine_file(
+                options, need_value=(action in ["get", "set", "unset", "edit"])
+            )
+        except PipError as e:
+            logger.error(e.args[0])
+            return ERROR
+
+        # Load a new configuration
+        self.configuration = Configuration(
+            isolated=options.isolated_mode, load_only=load_only
+        )
+        self.configuration.load()
+
+        # Error handling happens here, not in the action-handlers.
+        try:
+            handlers[action](options, args[1:])
+        except PipError as e:
+            logger.error(e.args[0])
+            return ERROR
+
+        return SUCCESS
+
+    def _determine_file(self, options, need_value):
+        file_options = [key for key, value in (
+            (kinds.USER, options.user_file),
+            (kinds.GLOBAL, options.global_file),
+            (kinds.SITE, options.site_file),
+        ) if value]
+
+        if not file_options:
+            if not need_value:
+                return None
+            # Default to user, unless there's a site file.
+            elif any(
+                os.path.exists(site_config_file)
+                for site_config_file in get_configuration_files()[kinds.SITE]
+            ):
+                return kinds.SITE
+            else:
+                return kinds.USER
+        elif len(file_options) == 1:
+            return file_options[0]
+
+        raise PipError(
+            "Need exactly one file to operate upon "
+            "(--user, --site, --global) to perform."
+        )
+
+    def list_values(self, options, args):
+        self._get_n_args(args, "list", n=0)
+
+        for key, value in sorted(self.configuration.items()):
+            write_output("%s=%r", key, value)
+
+    def get_name(self, options, args):
+        key = self._get_n_args(args, "get [name]", n=1)
+        value = self.configuration.get_value(key)
+
+        write_output("%s", value)
+
+    def set_name_value(self, options, args):
+        key, value = self._get_n_args(args, "set [name] [value]", n=2)
+        self.configuration.set_value(key, value)
+
+        self._save_configuration()
+
+    def unset_name(self, options, args):
+        key = self._get_n_args(args, "unset [name]", n=1)
+        self.configuration.unset_value(key)
+
+        self._save_configuration()
+
+    def open_in_editor(self, options, args):
+        editor = self._determine_editor(options)
+
+        fname = self.configuration.get_file_to_edit()
+        if fname is None:
+            raise PipError("Could not determine appropriate file.")
+
+        try:
+            subprocess.check_call([editor, fname])
+        except subprocess.CalledProcessError as e:
+            raise PipError(
+                "Editor Subprocess exited with exit code {}"
+                .format(e.returncode)
+            )
+
+    def _get_n_args(self, args, example, n):
+        """Helper to make sure the command got the right number of arguments
+        """
+        if len(args) != n:
+            msg = (
+                'Got unexpected number of arguments, expected {}. '
+                '(example: "{} config {}")'
+            ).format(n, get_prog(), example)
+            raise PipError(msg)
+
+        if n == 1:
+            return args[0]
+        else:
+            return args
+
+    def _save_configuration(self):
+        # We successfully ran a modifying command. Need to save the
+        # configuration.
+        try:
+            self.configuration.save()
+        except Exception:
+            logger.error(
+                "Unable to save configuration. Please report this as a bug.",
+                exc_info=1
+            )
+            raise PipError("Internal Error.")
+
+    def _determine_editor(self, options):
+        if options.editor is not None:
+            return options.editor
+        elif "VISUAL" in os.environ:
+            return os.environ["VISUAL"]
+        elif "EDITOR" in os.environ:
+            return os.environ["EDITOR"]
+        else:
+            raise PipError("Could not determine editor to use.")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe93b3a3926653c481c77830a4775585d2c488bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/debug.py
@@ -0,0 +1,142 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import locale
+import logging
+import os
+import sys
+
+from pip._vendor.certifi import where
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.cmdoptions import make_target_python
+from pip._internal.cli.status_codes import SUCCESS
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import get_pip_version
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, List, Optional
+    from optparse import Values
+
+logger = logging.getLogger(__name__)
+
+
+def show_value(name, value):
+    # type: (str, Optional[str]) -> None
+    logger.info('{}: {}'.format(name, value))
+
+
+def show_sys_implementation():
+    # type: () -> None
+    logger.info('sys.implementation:')
+    if hasattr(sys, 'implementation'):
+        implementation = sys.implementation  # type: ignore
+        implementation_name = implementation.name
+    else:
+        implementation_name = ''
+
+    with indent_log():
+        show_value('name', implementation_name)
+
+
+def show_tags(options):
+    # type: (Values) -> None
+    tag_limit = 10
+
+    target_python = make_target_python(options)
+    tags = target_python.get_tags()
+
+    # Display the target options that were explicitly provided.
+    formatted_target = target_python.format_given()
+    suffix = ''
+    if formatted_target:
+        suffix = ' (target: {})'.format(formatted_target)
+
+    msg = 'Compatible tags: {}{}'.format(len(tags), suffix)
+    logger.info(msg)
+
+    if options.verbose < 1 and len(tags) > tag_limit:
+        tags_limited = True
+        tags = tags[:tag_limit]
+    else:
+        tags_limited = False
+
+    with indent_log():
+        for tag in tags:
+            logger.info(str(tag))
+
+        if tags_limited:
+            msg = (
+                '...\n'
+                '[First {tag_limit} tags shown. Pass --verbose to show all.]'
+            ).format(tag_limit=tag_limit)
+            logger.info(msg)
+
+
+def ca_bundle_info(config):
+    levels = set()
+    for key, value in config.items():
+        levels.add(key.split('.')[0])
+
+    if not levels:
+        return "Not specified"
+
+    levels_that_override_global = ['install', 'wheel', 'download']
+    global_overriding_level = [
+        level for level in levels if level in levels_that_override_global
+    ]
+    if not global_overriding_level:
+        return 'global'
+
+    levels.remove('global')
+    return ", ".join(levels)
+
+
+class DebugCommand(Command):
+    """
+    Display debug information.
+    """
+
+    usage = """
+      %prog <options>"""
+    ignore_require_venv = True
+
+    def __init__(self, *args, **kw):
+        super(DebugCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+        cmdoptions.add_target_python_options(cmd_opts)
+        self.parser.insert_option_group(0, cmd_opts)
+        self.parser.config.load()
+
+    def run(self, options, args):
+        # type: (Values, List[Any]) -> int
+        logger.warning(
+            "This command is only meant for debugging. "
+            "Do not use this with automation for parsing and getting these "
+            "details, since the output and options of this command may "
+            "change without notice."
+        )
+        show_value('pip version', get_pip_version())
+        show_value('sys.version', sys.version)
+        show_value('sys.executable', sys.executable)
+        show_value('sys.getdefaultencoding', sys.getdefaultencoding())
+        show_value('sys.getfilesystemencoding', sys.getfilesystemencoding())
+        show_value(
+            'locale.getpreferredencoding', locale.getpreferredencoding(),
+        )
+        show_value('sys.platform', sys.platform)
+        show_sys_implementation()
+
+        show_value("'cert' config value", ca_bundle_info(self.parser.config))
+        show_value("REQUESTS_CA_BUNDLE", os.environ.get('REQUESTS_CA_BUNDLE'))
+        show_value("CURL_CA_BUNDLE", os.environ.get('CURL_CA_BUNDLE'))
+        show_value("pip._vendor.certifi.where()", where())
+
+        show_tags(options)
+
+        return SUCCESS
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py
new file mode 100644
index 0000000000000000000000000000000000000000..24da3eb2a263217e068d815e73d0f78f64a89398
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/download.py
@@ -0,0 +1,147 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.cmdoptions import make_target_python
+from pip._internal.cli.req_command import RequirementCommand
+from pip._internal.req import RequirementSet
+from pip._internal.req.req_tracker import get_requirement_tracker
+from pip._internal.utils.misc import ensure_dir, normalize_path, write_output
+from pip._internal.utils.temp_dir import TempDirectory
+
+logger = logging.getLogger(__name__)
+
+
+class DownloadCommand(RequirementCommand):
+    """
+    Download packages from:
+
+    - PyPI (and other indexes) using requirement specifiers.
+    - VCS project urls.
+    - Local project directories.
+    - Local or remote source archives.
+
+    pip also supports downloading from "requirements files", which provide
+    an easy way to specify a whole environment to be downloaded.
+    """
+
+    usage = """
+      %prog [options] <requirement specifier> [package-index-options] ...
+      %prog [options] -r <requirements file> [package-index-options] ...
+      %prog [options] <vcs project url> ...
+      %prog [options] <local project path> ...
+      %prog [options] <archive url/path> ..."""
+
+    def __init__(self, *args, **kw):
+        super(DownloadCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+
+        cmd_opts.add_option(cmdoptions.constraints())
+        cmd_opts.add_option(cmdoptions.requirements())
+        cmd_opts.add_option(cmdoptions.build_dir())
+        cmd_opts.add_option(cmdoptions.no_deps())
+        cmd_opts.add_option(cmdoptions.global_options())
+        cmd_opts.add_option(cmdoptions.no_binary())
+        cmd_opts.add_option(cmdoptions.only_binary())
+        cmd_opts.add_option(cmdoptions.prefer_binary())
+        cmd_opts.add_option(cmdoptions.src())
+        cmd_opts.add_option(cmdoptions.pre())
+        cmd_opts.add_option(cmdoptions.no_clean())
+        cmd_opts.add_option(cmdoptions.require_hashes())
+        cmd_opts.add_option(cmdoptions.progress_bar())
+        cmd_opts.add_option(cmdoptions.no_build_isolation())
+        cmd_opts.add_option(cmdoptions.use_pep517())
+        cmd_opts.add_option(cmdoptions.no_use_pep517())
+
+        cmd_opts.add_option(
+            '-d', '--dest', '--destination-dir', '--destination-directory',
+            dest='download_dir',
+            metavar='dir',
+            default=os.curdir,
+            help=("Download packages into <dir>."),
+        )
+
+        cmdoptions.add_target_python_options(cmd_opts)
+
+        index_opts = cmdoptions.make_option_group(
+            cmdoptions.index_group,
+            self.parser,
+        )
+
+        self.parser.insert_option_group(0, index_opts)
+        self.parser.insert_option_group(0, cmd_opts)
+
+    def run(self, options, args):
+        options.ignore_installed = True
+        # editable doesn't really make sense for `pip download`, but the bowels
+        # of the RequirementSet code require that property.
+        options.editables = []
+
+        cmdoptions.check_dist_restriction(options)
+
+        options.download_dir = normalize_path(options.download_dir)
+
+        ensure_dir(options.download_dir)
+
+        session = self.get_default_session(options)
+
+        target_python = make_target_python(options)
+        finder = self._build_package_finder(
+            options=options,
+            session=session,
+            target_python=target_python,
+        )
+        build_delete = (not (options.no_clean or options.build_dir))
+
+        with get_requirement_tracker() as req_tracker, TempDirectory(
+            options.build_dir, delete=build_delete, kind="download"
+        ) as directory:
+
+            requirement_set = RequirementSet()
+            self.populate_requirement_set(
+                requirement_set,
+                args,
+                options,
+                finder,
+                session,
+                None
+            )
+
+            preparer = self.make_requirement_preparer(
+                temp_build_dir=directory,
+                options=options,
+                req_tracker=req_tracker,
+                session=session,
+                finder=finder,
+                download_dir=options.download_dir,
+                use_user_site=False,
+            )
+
+            resolver = self.make_resolver(
+                preparer=preparer,
+                finder=finder,
+                options=options,
+                py_version_info=options.python_version,
+            )
+
+            self.trace_basic_info(finder)
+
+            resolver.resolve(requirement_set)
+
+            downloaded = ' '.join([
+                req.name for req in requirement_set.successfully_downloaded
+            ])
+            if downloaded:
+                write_output('Successfully downloaded %s', downloaded)
+
+            # Clean up
+            if not options.no_clean:
+                requirement_set.cleanup_files()
+
+        return requirement_set
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py
new file mode 100644
index 0000000000000000000000000000000000000000..e96c0833f5f1e7f643a588cf6bf30e9ca2282bc5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/freeze.py
@@ -0,0 +1,103 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import sys
+
+from pip._internal.cache import WheelCache
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.base_command import Command
+from pip._internal.models.format_control import FormatControl
+from pip._internal.operations.freeze import freeze
+from pip._internal.utils.compat import stdlib_pkgs
+
+DEV_PKGS = {'pip', 'setuptools', 'distribute', 'wheel', 'pkg-resources'}
+
+
+class FreezeCommand(Command):
+    """
+    Output installed packages in requirements format.
+
+    packages are listed in a case-insensitive sorted order.
+    """
+
+    usage = """
+      %prog [options]"""
+    log_streams = ("ext://sys.stderr", "ext://sys.stderr")
+
+    def __init__(self, *args, **kw):
+        super(FreezeCommand, self).__init__(*args, **kw)
+
+        self.cmd_opts.add_option(
+            '-r', '--requirement',
+            dest='requirements',
+            action='append',
+            default=[],
+            metavar='file',
+            help="Use the order in the given requirements file and its "
+                 "comments when generating output. This option can be "
+                 "used multiple times.")
+        self.cmd_opts.add_option(
+            '-f', '--find-links',
+            dest='find_links',
+            action='append',
+            default=[],
+            metavar='URL',
+            help='URL for finding packages, which will be added to the '
+                 'output.')
+        self.cmd_opts.add_option(
+            '-l', '--local',
+            dest='local',
+            action='store_true',
+            default=False,
+            help='If in a virtualenv that has global access, do not output '
+                 'globally-installed packages.')
+        self.cmd_opts.add_option(
+            '--user',
+            dest='user',
+            action='store_true',
+            default=False,
+            help='Only output packages installed in user-site.')
+        self.cmd_opts.add_option(cmdoptions.list_path())
+        self.cmd_opts.add_option(
+            '--all',
+            dest='freeze_all',
+            action='store_true',
+            help='Do not skip these packages in the output:'
+                 ' %s' % ', '.join(DEV_PKGS))
+        self.cmd_opts.add_option(
+            '--exclude-editable',
+            dest='exclude_editable',
+            action='store_true',
+            help='Exclude editable package from output.')
+
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        format_control = FormatControl(set(), set())
+        wheel_cache = WheelCache(options.cache_dir, format_control)
+        skip = set(stdlib_pkgs)
+        if not options.freeze_all:
+            skip.update(DEV_PKGS)
+
+        cmdoptions.check_list_path_option(options)
+
+        freeze_kwargs = dict(
+            requirement=options.requirements,
+            find_links=options.find_links,
+            local_only=options.local,
+            user_only=options.user,
+            paths=options.path,
+            skip_regex=options.skip_requirements_regex,
+            isolated=options.isolated_mode,
+            wheel_cache=wheel_cache,
+            skip=skip,
+            exclude_editable=options.exclude_editable,
+        )
+
+        try:
+            for line in freeze(**freeze_kwargs):
+                sys.stdout.write(line + '\n')
+        finally:
+            wheel_cache.cleanup()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py
new file mode 100644
index 0000000000000000000000000000000000000000..1dc7fb0eac936b625c79d20a7ec8267179a15a29
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/hash.py
@@ -0,0 +1,58 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import hashlib
+import logging
+import sys
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import ERROR
+from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES
+from pip._internal.utils.misc import read_chunks, write_output
+
+logger = logging.getLogger(__name__)
+
+
+class HashCommand(Command):
+    """
+    Compute a hash of a local package archive.
+
+    These can be used with --hash in a requirements file to do repeatable
+    installs.
+    """
+
+    usage = '%prog [options] <file> ...'
+    ignore_require_venv = True
+
+    def __init__(self, *args, **kw):
+        super(HashCommand, self).__init__(*args, **kw)
+        self.cmd_opts.add_option(
+            '-a', '--algorithm',
+            dest='algorithm',
+            choices=STRONG_HASHES,
+            action='store',
+            default=FAVORITE_HASH,
+            help='The hash algorithm to use: one of %s' %
+                 ', '.join(STRONG_HASHES))
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        if not args:
+            self.parser.print_usage(sys.stderr)
+            return ERROR
+
+        algorithm = options.algorithm
+        for path in args:
+            write_output('%s:\n--hash=%s:%s',
+                         path, algorithm, _hash_of_file(path, algorithm))
+
+
+def _hash_of_file(path, algorithm):
+    """Return the hash digest of a file."""
+    with open(path, 'rb') as archive:
+        hash = hashlib.new(algorithm)
+        for chunk in read_chunks(archive):
+            hash.update(chunk)
+    return hash.hexdigest()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py
new file mode 100644
index 0000000000000000000000000000000000000000..75af999b41e676f3abca4e2278b06aa404a95479
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/help.py
@@ -0,0 +1,41 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import SUCCESS
+from pip._internal.exceptions import CommandError
+
+
+class HelpCommand(Command):
+    """Show help for commands"""
+
+    usage = """
+      %prog <command>"""
+    ignore_require_venv = True
+
+    def run(self, options, args):
+        from pip._internal.commands import (
+            commands_dict, create_command, get_similar_commands,
+        )
+
+        try:
+            # 'pip help' with no args is handled by pip.__init__.parseopt()
+            cmd_name = args[0]  # the command we need help for
+        except IndexError:
+            return SUCCESS
+
+        if cmd_name not in commands_dict:
+            guess = get_similar_commands(cmd_name)
+
+            msg = ['unknown command "%s"' % cmd_name]
+            if guess:
+                msg.append('maybe you meant "%s"' % guess)
+
+            raise CommandError(' - '.join(msg))
+
+        command = create_command(cmd_name)
+        command.parser.print_help()
+
+        return SUCCESS
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb2fb280c986a60fd57ec34af5185e423169722e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/install.py
@@ -0,0 +1,727 @@
+# The following comment should be removed at some point in the future.
+# It's included for now because without it InstallCommand.run() has a
+# couple errors where we have to know req.name is str rather than
+# Optional[str] for the InstallRequirement req.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import errno
+import logging
+import operator
+import os
+import shutil
+import site
+from optparse import SUPPRESS_HELP
+
+from pip._vendor import pkg_resources
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.cache import WheelCache
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.cmdoptions import make_target_python
+from pip._internal.cli.req_command import RequirementCommand
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.exceptions import (
+    CommandError,
+    InstallationError,
+    PreviousBuildDirError,
+)
+from pip._internal.locations import distutils_scheme
+from pip._internal.operations.check import check_install_conflicts
+from pip._internal.req import RequirementSet, install_given_reqs
+from pip._internal.req.req_tracker import get_requirement_tracker
+from pip._internal.utils.deprecation import deprecated
+from pip._internal.utils.distutils_args import parse_distutils_args
+from pip._internal.utils.filesystem import test_writable_dir
+from pip._internal.utils.misc import (
+    ensure_dir,
+    get_installed_version,
+    protect_pip_from_modification_on_windows,
+    write_output,
+)
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.virtualenv import virtualenv_no_global
+from pip._internal.wheel_builder import build, should_build_for_install_command
+
+if MYPY_CHECK_RUNNING:
+    from optparse import Values
+    from typing import Any, Iterable, List, Optional
+
+    from pip._internal.models.format_control import FormatControl
+    from pip._internal.req.req_install import InstallRequirement
+    from pip._internal.wheel_builder import BinaryAllowedPredicate
+
+from pip._internal.locations import running_under_virtualenv
+
+logger = logging.getLogger(__name__)
+
+
+def get_check_binary_allowed(format_control):
+    # type: (FormatControl) -> BinaryAllowedPredicate
+    def check_binary_allowed(req):
+        # type: (InstallRequirement) -> bool
+        if req.use_pep517:
+            return True
+        canonical_name = canonicalize_name(req.name)
+        allowed_formats = format_control.get_allowed_formats(canonical_name)
+        return "binary" in allowed_formats
+
+    return check_binary_allowed
+
+
+class InstallCommand(RequirementCommand):
+    """
+    Install packages from:
+
+    - PyPI (and other indexes) using requirement specifiers.
+    - VCS project urls.
+    - Local project directories.
+    - Local or remote source archives.
+
+    pip also supports installing from "requirements files", which provide
+    an easy way to specify a whole environment to be installed.
+    """
+
+    usage = """
+      %prog [options] <requirement specifier> [package-index-options] ...
+      %prog [options] -r <requirements file> [package-index-options] ...
+      %prog [options] [-e] <vcs project url> ...
+      %prog [options] [-e] <local project path> ...
+      %prog [options] <archive url/path> ..."""
+
+    def __init__(self, *args, **kw):
+        super(InstallCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+
+        cmd_opts.add_option(cmdoptions.requirements())
+        cmd_opts.add_option(cmdoptions.constraints())
+        cmd_opts.add_option(cmdoptions.no_deps())
+        cmd_opts.add_option(cmdoptions.pre())
+
+        cmd_opts.add_option(cmdoptions.editable())
+        cmd_opts.add_option(
+            '-t', '--target',
+            dest='target_dir',
+            metavar='dir',
+            default=None,
+            help='Install packages into <dir>. '
+                 'By default this will not replace existing files/folders in '
+                 '<dir>. Use --upgrade to replace existing packages in <dir> '
+                 'with new versions.'
+        )
+        cmdoptions.add_target_python_options(cmd_opts)
+
+        cmd_opts.add_option(
+            '--user',
+            dest='use_user_site',
+            action='store_true',
+            help="Install to the Python user install directory for your "
+                 "platform. Typically ~/.local/, or %APPDATA%\\Python on "
+                 "Windows. (See the Python documentation for site.USER_BASE "
+                 "for full details.)  On Debian systems, this is the "
+                 "default when running outside of a virtual environment "
+                 "and not as root.")
+
+        cmd_opts.add_option(
+            '--no-user',
+            dest='use_system_location',
+            action='store_true',
+            help=SUPPRESS_HELP)
+        cmd_opts.add_option(
+            '--root',
+            dest='root_path',
+            metavar='dir',
+            default=None,
+            help="Install everything relative to this alternate root "
+                 "directory.")
+        cmd_opts.add_option(
+            '--prefix',
+            dest='prefix_path',
+            metavar='dir',
+            default=None,
+            help="Installation prefix where lib, bin and other top-level "
+                 "folders are placed")
+
+        cmd_opts.add_option(
+            '--system',
+            dest='use_system_location',
+            action='store_true',
+            help="Install using the system scheme (overrides --user on "
+                 "Debian systems)")
+
+        cmd_opts.add_option(cmdoptions.build_dir())
+
+        cmd_opts.add_option(cmdoptions.src())
+
+        cmd_opts.add_option(
+            '-U', '--upgrade',
+            dest='upgrade',
+            action='store_true',
+            help='Upgrade all specified packages to the newest available '
+                 'version. The handling of dependencies depends on the '
+                 'upgrade-strategy used.'
+        )
+
+        cmd_opts.add_option(
+            '--upgrade-strategy',
+            dest='upgrade_strategy',
+            default='only-if-needed',
+            choices=['only-if-needed', 'eager'],
+            help='Determines how dependency upgrading should be handled '
+                 '[default: %default]. '
+                 '"eager" - dependencies are upgraded regardless of '
+                 'whether the currently installed version satisfies the '
+                 'requirements of the upgraded package(s). '
+                 '"only-if-needed" -  are upgraded only when they do not '
+                 'satisfy the requirements of the upgraded package(s).'
+        )
+
+        cmd_opts.add_option(
+            '--force-reinstall',
+            dest='force_reinstall',
+            action='store_true',
+            help='Reinstall all packages even if they are already '
+                 'up-to-date.')
+
+        cmd_opts.add_option(
+            '-I', '--ignore-installed',
+            dest='ignore_installed',
+            action='store_true',
+            help='Ignore the installed packages, overwriting them. '
+                 'This can break your system if the existing package '
+                 'is of a different version or was installed '
+                 'with a different package manager!'
+        )
+
+        cmd_opts.add_option(cmdoptions.ignore_requires_python())
+        cmd_opts.add_option(cmdoptions.no_build_isolation())
+        cmd_opts.add_option(cmdoptions.use_pep517())
+        cmd_opts.add_option(cmdoptions.no_use_pep517())
+
+        cmd_opts.add_option(cmdoptions.install_options())
+        cmd_opts.add_option(cmdoptions.global_options())
+
+        cmd_opts.add_option(
+            "--compile",
+            action="store_true",
+            dest="compile",
+            default=True,
+            help="Compile Python source files to bytecode",
+        )
+
+        cmd_opts.add_option(
+            "--no-compile",
+            action="store_false",
+            dest="compile",
+            help="Do not compile Python source files to bytecode",
+        )
+
+        cmd_opts.add_option(
+            "--no-warn-script-location",
+            action="store_false",
+            dest="warn_script_location",
+            default=True,
+            help="Do not warn when installing scripts outside PATH",
+        )
+        cmd_opts.add_option(
+            "--no-warn-conflicts",
+            action="store_false",
+            dest="warn_about_conflicts",
+            default=True,
+            help="Do not warn about broken dependencies",
+        )
+
+        cmd_opts.add_option(cmdoptions.no_binary())
+        cmd_opts.add_option(cmdoptions.only_binary())
+        cmd_opts.add_option(cmdoptions.prefer_binary())
+        cmd_opts.add_option(cmdoptions.no_clean())
+        cmd_opts.add_option(cmdoptions.require_hashes())
+        cmd_opts.add_option(cmdoptions.progress_bar())
+
+        index_opts = cmdoptions.make_option_group(
+            cmdoptions.index_group,
+            self.parser,
+        )
+
+        self.parser.insert_option_group(0, index_opts)
+        self.parser.insert_option_group(0, cmd_opts)
+
+    def run(self, options, args):
+        # type: (Values, List[Any]) -> int
+        cmdoptions.check_install_build_global(options)
+        upgrade_strategy = "to-satisfy-only"
+        if options.upgrade:
+            upgrade_strategy = options.upgrade_strategy
+
+        cmdoptions.check_dist_restriction(options, check_target=True)
+
+        if options.python_version:
+            python_versions = [options.python_version]
+        else:
+            python_versions = None
+
+        # compute install location defaults
+        if (not options.use_user_site and not options.prefix_path and not
+                options.target_dir and not options.use_system_location):
+            if not running_under_virtualenv() and os.geteuid() != 0:
+                options.use_user_site = True
+
+        if options.use_system_location:
+            options.use_user_site = False
+
+        options.src_dir = os.path.abspath(options.src_dir)
+        install_options = options.install_options or []
+
+        options.use_user_site = decide_user_install(
+            options.use_user_site,
+            prefix_path=options.prefix_path,
+            target_dir=options.target_dir,
+            root_path=options.root_path,
+            isolated_mode=options.isolated_mode,
+        )
+
+        target_temp_dir = None  # type: Optional[TempDirectory]
+        target_temp_dir_path = None  # type: Optional[str]
+        if options.target_dir:
+            options.ignore_installed = True
+            options.target_dir = os.path.abspath(options.target_dir)
+            if (os.path.exists(options.target_dir) and not
+                    os.path.isdir(options.target_dir)):
+                raise CommandError(
+                    "Target path exists but is not a directory, will not "
+                    "continue."
+                )
+
+            # Create a target directory for using with the target option
+            target_temp_dir = TempDirectory(kind="target")
+            target_temp_dir_path = target_temp_dir.path
+
+        global_options = options.global_options or []
+
+        session = self.get_default_session(options)
+
+        target_python = make_target_python(options)
+        finder = self._build_package_finder(
+            options=options,
+            session=session,
+            target_python=target_python,
+            ignore_requires_python=options.ignore_requires_python,
+        )
+        build_delete = (not (options.no_clean or options.build_dir))
+        wheel_cache = WheelCache(options.cache_dir, options.format_control)
+
+        with get_requirement_tracker() as req_tracker, TempDirectory(
+            options.build_dir, delete=build_delete, kind="install"
+        ) as directory:
+            requirement_set = RequirementSet(
+                check_supported_wheels=not options.target_dir,
+            )
+
+            try:
+                self.populate_requirement_set(
+                    requirement_set, args, options, finder, session,
+                    wheel_cache
+                )
+
+                warn_deprecated_install_options(
+                    requirement_set, options.install_options
+                )
+
+                preparer = self.make_requirement_preparer(
+                    temp_build_dir=directory,
+                    options=options,
+                    req_tracker=req_tracker,
+                    session=session,
+                    finder=finder,
+                    use_user_site=options.use_user_site,
+                )
+                resolver = self.make_resolver(
+                    preparer=preparer,
+                    finder=finder,
+                    options=options,
+                    wheel_cache=wheel_cache,
+                    use_user_site=options.use_user_site,
+                    ignore_installed=options.ignore_installed,
+                    ignore_requires_python=options.ignore_requires_python,
+                    force_reinstall=options.force_reinstall,
+                    upgrade_strategy=upgrade_strategy,
+                    use_pep517=options.use_pep517,
+                )
+
+                self.trace_basic_info(finder)
+
+                resolver.resolve(requirement_set)
+
+                try:
+                    pip_req = requirement_set.get_requirement("pip")
+                except KeyError:
+                    modifying_pip = None
+                else:
+                    # If we're not replacing an already installed pip,
+                    # we're not modifying it.
+                    modifying_pip = pip_req.satisfied_by is None
+                protect_pip_from_modification_on_windows(
+                    modifying_pip=modifying_pip
+                )
+
+                check_binary_allowed = get_check_binary_allowed(
+                    finder.format_control
+                )
+
+                reqs_to_build = [
+                    r for r in requirement_set.requirements.values()
+                    if should_build_for_install_command(
+                        r, check_binary_allowed
+                    )
+                ]
+
+                _, build_failures = build(
+                    reqs_to_build,
+                    wheel_cache=wheel_cache,
+                    build_options=[],
+                    global_options=[],
+                )
+
+                # If we're using PEP 517, we cannot do a direct install
+                # so we fail here.
+                # We don't care about failures building legacy
+                # requirements, as we'll fall through to a direct
+                # install for those.
+                pep517_build_failures = [
+                    r for r in build_failures if r.use_pep517
+                ]
+                if pep517_build_failures:
+                    raise InstallationError(
+                        "Could not build wheels for {} which use"
+                        " PEP 517 and cannot be installed directly".format(
+                            ", ".join(r.name for r in pep517_build_failures)))
+
+                to_install = resolver.get_installation_order(
+                    requirement_set
+                )
+
+                # Consistency Checking of the package set we're installing.
+                should_warn_about_conflicts = (
+                    not options.ignore_dependencies and
+                    options.warn_about_conflicts
+                )
+                if should_warn_about_conflicts:
+                    self._warn_about_conflicts(to_install)
+
+                # Don't warn about script install locations if
+                # --target has been specified
+                warn_script_location = options.warn_script_location
+                if options.target_dir:
+                    warn_script_location = False
+
+                installed = install_given_reqs(
+                    to_install,
+                    install_options,
+                    global_options,
+                    root=options.root_path,
+                    home=target_temp_dir_path,
+                    prefix=options.prefix_path,
+                    pycompile=options.compile,
+                    warn_script_location=warn_script_location,
+                    use_user_site=options.use_user_site,
+                )
+
+                lib_locations = get_lib_location_guesses(
+                    user=options.use_user_site,
+                    home=target_temp_dir_path,
+                    root=options.root_path,
+                    prefix=options.prefix_path,
+                    isolated=options.isolated_mode,
+                )
+                working_set = pkg_resources.WorkingSet(lib_locations)
+
+                installed.sort(key=operator.attrgetter('name'))
+                items = []
+                for result in installed:
+                    item = result.name
+                    try:
+                        installed_version = get_installed_version(
+                            result.name, working_set=working_set
+                        )
+                        if installed_version:
+                            item += '-' + installed_version
+                    except Exception:
+                        pass
+                    items.append(item)
+                installed_desc = ' '.join(items)
+                if installed_desc:
+                    write_output(
+                        'Successfully installed %s', installed_desc,
+                    )
+            except EnvironmentError as error:
+                show_traceback = (self.verbosity >= 1)
+
+                message = create_env_error_message(
+                    error, show_traceback, options.use_user_site,
+                )
+                logger.error(message, exc_info=show_traceback)
+
+                return ERROR
+            except PreviousBuildDirError:
+                options.no_clean = True
+                raise
+            finally:
+                # Clean up
+                if not options.no_clean:
+                    requirement_set.cleanup_files()
+                    wheel_cache.cleanup()
+
+        if options.target_dir:
+            self._handle_target_dir(
+                options.target_dir, target_temp_dir, options.upgrade
+            )
+
+        return SUCCESS
+
+    def _handle_target_dir(self, target_dir, target_temp_dir, upgrade):
+        ensure_dir(target_dir)
+
+        # Checking both purelib and platlib directories for installed
+        # packages to be moved to target directory
+        lib_dir_list = []
+
+        with target_temp_dir:
+            # Checking both purelib and platlib directories for installed
+            # packages to be moved to target directory
+            scheme = distutils_scheme('', home=target_temp_dir.path)
+            purelib_dir = scheme['purelib']
+            platlib_dir = scheme['platlib']
+            data_dir = scheme['data']
+
+            if os.path.exists(purelib_dir):
+                lib_dir_list.append(purelib_dir)
+            if os.path.exists(platlib_dir) and platlib_dir != purelib_dir:
+                lib_dir_list.append(platlib_dir)
+            if os.path.exists(data_dir):
+                lib_dir_list.append(data_dir)
+
+            for lib_dir in lib_dir_list:
+                for item in os.listdir(lib_dir):
+                    if lib_dir == data_dir:
+                        ddir = os.path.join(data_dir, item)
+                        if any(s.startswith(ddir) for s in lib_dir_list[:-1]):
+                            continue
+                    target_item_dir = os.path.join(target_dir, item)
+                    if os.path.exists(target_item_dir):
+                        if not upgrade:
+                            logger.warning(
+                                'Target directory %s already exists. Specify '
+                                '--upgrade to force replacement.',
+                                target_item_dir
+                            )
+                            continue
+                        if os.path.islink(target_item_dir):
+                            logger.warning(
+                                'Target directory %s already exists and is '
+                                'a link. Pip will not automatically replace '
+                                'links, please remove if replacement is '
+                                'desired.',
+                                target_item_dir
+                            )
+                            continue
+                        if os.path.isdir(target_item_dir):
+                            shutil.rmtree(target_item_dir)
+                        else:
+                            os.remove(target_item_dir)
+
+                    shutil.move(
+                        os.path.join(lib_dir, item),
+                        target_item_dir
+                    )
+
+    def _warn_about_conflicts(self, to_install):
+        try:
+            package_set, _dep_info = check_install_conflicts(to_install)
+        except Exception:
+            logger.error("Error checking for conflicts.", exc_info=True)
+            return
+        missing, conflicting = _dep_info
+
+        # NOTE: There is some duplication here from pip check
+        for project_name in missing:
+            version = package_set[project_name][0]
+            for dependency in missing[project_name]:
+                logger.critical(
+                    "%s %s requires %s, which is not installed.",
+                    project_name, version, dependency[1],
+                )
+
+        for project_name in conflicting:
+            version = package_set[project_name][0]
+            for dep_name, dep_version, req in conflicting[project_name]:
+                logger.critical(
+                    "%s %s has requirement %s, but you'll have %s %s which is "
+                    "incompatible.",
+                    project_name, version, req, dep_name, dep_version,
+                )
+
+
+def get_lib_location_guesses(*args, **kwargs):
+    scheme = distutils_scheme('', *args, **kwargs)
+    return [scheme['purelib'], scheme['platlib']]
+
+
+def site_packages_writable(**kwargs):
+    return all(
+        test_writable_dir(d) for d in set(get_lib_location_guesses(**kwargs))
+    )
+
+
+def decide_user_install(
+    use_user_site,  # type: Optional[bool]
+    prefix_path=None,  # type: Optional[str]
+    target_dir=None,  # type: Optional[str]
+    root_path=None,  # type: Optional[str]
+    isolated_mode=False,  # type: bool
+):
+    # type: (...) -> bool
+    """Determine whether to do a user install based on the input options.
+
+    If use_user_site is False, no additional checks are done.
+    If use_user_site is True, it is checked for compatibility with other
+    options.
+    If use_user_site is None, the default behaviour depends on the environment,
+    which is provided by the other arguments.
+    """
+    # In some cases (config from tox), use_user_site can be set to an integer
+    # rather than a bool, which 'use_user_site is False' wouldn't catch.
+    if (use_user_site is not None) and (not use_user_site):
+        logger.debug("Non-user install by explicit request")
+        return False
+
+    if use_user_site:
+        if prefix_path:
+            raise CommandError(
+                "Can not combine '--user' and '--prefix' as they imply "
+                "different installation locations"
+            )
+        if virtualenv_no_global():
+            raise InstallationError(
+                "Can not perform a '--user' install. User site-packages "
+                "are not visible in this virtualenv."
+            )
+        logger.debug("User install by explicit request")
+        return True
+
+    # If we are here, user installs have not been explicitly requested/avoided
+    assert use_user_site is None
+
+    # user install incompatible with --prefix/--target
+    if prefix_path or target_dir:
+        logger.debug("Non-user install due to --prefix or --target option")
+        return False
+
+    # If user installs are not enabled, choose a non-user install
+    if not site.ENABLE_USER_SITE:
+        logger.debug("Non-user install because user site-packages disabled")
+        return False
+
+    # If we have permission for a non-user install, do that,
+    # otherwise do a user install.
+    if site_packages_writable(root=root_path, isolated=isolated_mode):
+        logger.debug("Non-user install because site-packages writeable")
+        return False
+
+    logger.info("Defaulting to user installation because normal site-packages "
+                "is not writeable")
+    return True
+
+
+def warn_deprecated_install_options(requirement_set, options):
+    # type: (RequirementSet, Optional[List[str]]) -> None
+    """If any location-changing --install-option arguments were passed for
+    requirements or on the command-line, then show a deprecation warning.
+    """
+    def format_options(option_names):
+        # type: (Iterable[str]) -> List[str]
+        return ["--{}".format(name.replace("_", "-")) for name in option_names]
+
+    requirements = (
+        requirement_set.unnamed_requirements +
+        list(requirement_set.requirements.values())
+    )
+
+    offenders = []
+
+    for requirement in requirements:
+        install_options = requirement.options.get("install_options", [])
+        location_options = parse_distutils_args(install_options)
+        if location_options:
+            offenders.append(
+                "{!r} from {}".format(
+                    format_options(location_options.keys()), requirement
+                )
+            )
+
+    if options:
+        location_options = parse_distutils_args(options)
+        if location_options:
+            offenders.append(
+                "{!r} from command line".format(
+                    format_options(location_options.keys())
+                )
+            )
+
+    if not offenders:
+        return
+
+    deprecated(
+        reason=(
+            "Location-changing options found in --install-option: {}. "
+            "This configuration may cause unexpected behavior and is "
+            "unsupported.".format(
+                "; ".join(offenders)
+            )
+        ),
+        replacement=(
+            "using pip-level options like --user, --prefix, --root, and "
+            "--target"
+        ),
+        gone_in="20.2",
+        issue=7309,
+    )
+
+
+def create_env_error_message(error, show_traceback, using_user_site):
+    """Format an error message for an EnvironmentError
+
+    It may occur anytime during the execution of the install command.
+    """
+    parts = []
+
+    # Mention the error if we are not going to show a traceback
+    parts.append("Could not install packages due to an EnvironmentError")
+    if not show_traceback:
+        parts.append(": ")
+        parts.append(str(error))
+    else:
+        parts.append(".")
+
+    # Spilt the error indication from a helper message (if any)
+    parts[-1] += "\n"
+
+    # Suggest useful actions to the user:
+    #  (1) using user site-packages or (2) verifying the permissions
+    if error.errno == errno.EACCES:
+        user_option_part = "Consider using the `--user` option"
+        permissions_part = "Check the permissions"
+
+        if not using_user_site:
+            parts.extend([
+                user_option_part, " or ",
+                permissions_part.lower(),
+            ])
+        else:
+            parts.append(permissions_part)
+        parts.append(".\n")
+
+    return "".join(parts).strip() + "\n"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py
new file mode 100644
index 0000000000000000000000000000000000000000..d0062063e7be3e3fa1f09452e793eceafc1b2343
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/list.py
@@ -0,0 +1,315 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import json
+import logging
+
+from pip._vendor import six
+from pip._vendor.six.moves import zip_longest
+
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.req_command import IndexGroupCommand
+from pip._internal.exceptions import CommandError
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.self_outdated_check import make_link_collector
+from pip._internal.utils.misc import (
+    dist_is_editable,
+    get_installed_distributions,
+    write_output,
+)
+from pip._internal.utils.packaging import get_installer
+
+from pip._vendor.packaging.version import parse
+
+logger = logging.getLogger(__name__)
+
+
+class ListCommand(IndexGroupCommand):
+    """
+    List installed packages, including editables.
+
+    Packages are listed in a case-insensitive sorted order.
+    """
+
+    usage = """
+      %prog [options]"""
+
+    def __init__(self, *args, **kw):
+        super(ListCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+
+        cmd_opts.add_option(
+            '-o', '--outdated',
+            action='store_true',
+            default=False,
+            help='List outdated packages')
+        cmd_opts.add_option(
+            '-u', '--uptodate',
+            action='store_true',
+            default=False,
+            help='List uptodate packages')
+        cmd_opts.add_option(
+            '-e', '--editable',
+            action='store_true',
+            default=False,
+            help='List editable projects.')
+        cmd_opts.add_option(
+            '-l', '--local',
+            action='store_true',
+            default=False,
+            help=('If in a virtualenv that has global access, do not list '
+                  'globally-installed packages.'),
+        )
+        self.cmd_opts.add_option(
+            '--user',
+            dest='user',
+            action='store_true',
+            default=False,
+            help='Only output packages installed in user-site.')
+        cmd_opts.add_option(cmdoptions.list_path())
+        cmd_opts.add_option(
+            '--pre',
+            action='store_true',
+            default=False,
+            help=("Include pre-release and development versions. By default, "
+                  "pip only finds stable versions."),
+        )
+
+        cmd_opts.add_option(
+            '--format',
+            action='store',
+            dest='list_format',
+            default="columns",
+            choices=('columns', 'freeze', 'json'),
+            help="Select the output format among: columns (default), freeze, "
+                 "or json",
+        )
+
+        cmd_opts.add_option(
+            '--not-required',
+            action='store_true',
+            dest='not_required',
+            help="List packages that are not dependencies of "
+                 "installed packages.",
+        )
+
+        cmd_opts.add_option(
+            '--exclude-editable',
+            action='store_false',
+            dest='include_editable',
+            help='Exclude editable package from output.',
+        )
+        cmd_opts.add_option(
+            '--include-editable',
+            action='store_true',
+            dest='include_editable',
+            help='Include editable package from output.',
+            default=True,
+        )
+        index_opts = cmdoptions.make_option_group(
+            cmdoptions.index_group, self.parser
+        )
+
+        self.parser.insert_option_group(0, index_opts)
+        self.parser.insert_option_group(0, cmd_opts)
+
+    def _build_package_finder(self, options, session):
+        """
+        Create a package finder appropriate to this list command.
+        """
+        link_collector = make_link_collector(session, options=options)
+
+        # Pass allow_yanked=False to ignore yanked versions.
+        selection_prefs = SelectionPreferences(
+            allow_yanked=False,
+            allow_all_prereleases=options.pre,
+        )
+
+        return PackageFinder.create(
+            link_collector=link_collector,
+            selection_prefs=selection_prefs,
+        )
+
+    def run(self, options, args):
+        if options.outdated and options.uptodate:
+            raise CommandError(
+                "Options --outdated and --uptodate cannot be combined.")
+
+        cmdoptions.check_list_path_option(options)
+
+        packages = get_installed_distributions(
+            local_only=options.local,
+            user_only=options.user,
+            editables_only=options.editable,
+            include_editables=options.include_editable,
+            paths=options.path,
+        )
+
+        # get_not_required must be called firstly in order to find and
+        # filter out all dependencies correctly. Otherwise a package
+        # can't be identified as requirement because some parent packages
+        # could be filtered out before.
+        if options.not_required:
+            packages = self.get_not_required(packages, options)
+
+        if options.outdated:
+            packages = self.get_outdated(packages, options)
+        elif options.uptodate:
+            packages = self.get_uptodate(packages, options)
+
+        self.output_package_listing(packages, options)
+
+    def get_outdated(self, packages, options):
+        return [
+            dist for dist in self.iter_packages_latest_infos(packages, options)
+            if parse(str(dist.latest_version)) > parse(str(dist.parsed_version))
+        ]
+
+    def get_uptodate(self, packages, options):
+        return [
+            dist for dist in self.iter_packages_latest_infos(packages, options)
+            if parse(str(dist.latest_version)) == parse(str(dist.parsed_version))
+        ]
+
+    def get_not_required(self, packages, options):
+        dep_keys = set()
+        for dist in packages:
+            dep_keys.update(requirement.key for requirement in dist.requires())
+        return {pkg for pkg in packages if pkg.key not in dep_keys}
+
+    def iter_packages_latest_infos(self, packages, options):
+        with self._build_session(options) as session:
+            finder = self._build_package_finder(options, session)
+
+            for dist in packages:
+                typ = 'unknown'
+                all_candidates = finder.find_all_candidates(dist.key)
+                if not options.pre:
+                    # Remove prereleases
+                    all_candidates = [candidate for candidate in all_candidates
+                                      if not candidate.version.is_prerelease]
+
+                evaluator = finder.make_candidate_evaluator(
+                    project_name=dist.project_name,
+                )
+                best_candidate = evaluator.sort_best_candidate(all_candidates)
+                if best_candidate is None:
+                    continue
+
+                remote_version = best_candidate.version
+                if best_candidate.link.is_wheel:
+                    typ = 'wheel'
+                else:
+                    typ = 'sdist'
+                # This is dirty but makes the rest of the code much cleaner
+                dist.latest_version = remote_version
+                dist.latest_filetype = typ
+                yield dist
+
+    def output_package_listing(self, packages, options):
+        packages = sorted(
+            packages,
+            key=lambda dist: dist.project_name.lower(),
+        )
+        if options.list_format == 'columns' and packages:
+            data, header = format_for_columns(packages, options)
+            self.output_package_listing_columns(data, header)
+        elif options.list_format == 'freeze':
+            for dist in packages:
+                if options.verbose >= 1:
+                    write_output("%s==%s (%s)", dist.project_name,
+                                 dist.version, dist.location)
+                else:
+                    write_output("%s==%s", dist.project_name, dist.version)
+        elif options.list_format == 'json':
+            write_output(format_for_json(packages, options))
+
+    def output_package_listing_columns(self, data, header):
+        # insert the header first: we need to know the size of column names
+        if len(data) > 0:
+            data.insert(0, header)
+
+        pkg_strings, sizes = tabulate(data)
+
+        # Create and add a separator.
+        if len(data) > 0:
+            pkg_strings.insert(1, " ".join(map(lambda x: '-' * x, sizes)))
+
+        for val in pkg_strings:
+            write_output(val)
+
+
+def tabulate(vals):
+    # From pfmoore on GitHub:
+    # https://github.com/pypa/pip/issues/3651#issuecomment-216932564
+    assert len(vals) > 0
+
+    sizes = [0] * max(len(x) for x in vals)
+    for row in vals:
+        sizes = [max(s, len(str(c))) for s, c in zip_longest(sizes, row)]
+
+    result = []
+    for row in vals:
+        display = " ".join([str(c).ljust(s) if c is not None else ''
+                            for s, c in zip_longest(sizes, row)])
+        result.append(display)
+
+    return result, sizes
+
+
+def format_for_columns(pkgs, options):
+    """
+    Convert the package data into something usable
+    by output_package_listing_columns.
+    """
+    running_outdated = options.outdated
+    # Adjust the header for the `pip list --outdated` case.
+    if running_outdated:
+        header = ["Package", "Version", "Latest", "Type"]
+    else:
+        header = ["Package", "Version"]
+
+    data = []
+    if options.verbose >= 1 or any(dist_is_editable(x) for x in pkgs):
+        header.append("Location")
+    if options.verbose >= 1:
+        header.append("Installer")
+
+    for proj in pkgs:
+        # if we're working on the 'outdated' list, separate out the
+        # latest_version and type
+        row = [proj.project_name, proj.version]
+
+        if running_outdated:
+            row.append(proj.latest_version)
+            row.append(proj.latest_filetype)
+
+        if options.verbose >= 1 or dist_is_editable(proj):
+            row.append(proj.location)
+        if options.verbose >= 1:
+            row.append(get_installer(proj))
+
+        data.append(row)
+
+    return data, header
+
+
+def format_for_json(packages, options):
+    data = []
+    for dist in packages:
+        info = {
+            'name': dist.project_name,
+            'version': six.text_type(dist.version),
+        }
+        if options.verbose >= 1:
+            info['location'] = dist.location
+            info['installer'] = get_installer(dist)
+        if options.outdated:
+            info['latest_version'] = six.text_type(dist.latest_version)
+            info['latest_filetype'] = dist.latest_filetype
+        data.append(info)
+    return json.dumps(data)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e880eec2242a0aec7a2a6b53cde16fa106fd683
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/search.py
@@ -0,0 +1,145 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import sys
+import textwrap
+from collections import OrderedDict
+
+from pip._vendor import pkg_resources
+from pip._vendor.packaging.version import parse as parse_version
+# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is
+#       why we ignore the type on this import
+from pip._vendor.six.moves import xmlrpc_client  # type: ignore
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.req_command import SessionCommandMixin
+from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS
+from pip._internal.exceptions import CommandError
+from pip._internal.models.index import PyPI
+from pip._internal.network.xmlrpc import PipXmlrpcTransport
+from pip._internal.utils.compat import get_terminal_size
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import write_output
+
+logger = logging.getLogger(__name__)
+
+
+class SearchCommand(Command, SessionCommandMixin):
+    """Search for PyPI packages whose name or summary contains <query>."""
+
+    usage = """
+      %prog [options] <query>"""
+    ignore_require_venv = True
+
+    def __init__(self, *args, **kw):
+        super(SearchCommand, self).__init__(*args, **kw)
+        self.cmd_opts.add_option(
+            '-i', '--index',
+            dest='index',
+            metavar='URL',
+            default=PyPI.pypi_url,
+            help='Base URL of Python Package Index (default %default)')
+
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        if not args:
+            raise CommandError('Missing required argument (search query).')
+        query = args
+        pypi_hits = self.search(query, options)
+        hits = transform_hits(pypi_hits)
+
+        terminal_width = None
+        if sys.stdout.isatty():
+            terminal_width = get_terminal_size()[0]
+
+        print_results(hits, terminal_width=terminal_width)
+        if pypi_hits:
+            return SUCCESS
+        return NO_MATCHES_FOUND
+
+    def search(self, query, options):
+        index_url = options.index
+
+        session = self.get_default_session(options)
+
+        transport = PipXmlrpcTransport(index_url, session)
+        pypi = xmlrpc_client.ServerProxy(index_url, transport)
+        hits = pypi.search({'name': query, 'summary': query}, 'or')
+        return hits
+
+
+def transform_hits(hits):
+    """
+    The list from pypi is really a list of versions. We want a list of
+    packages with the list of versions stored inline. This converts the
+    list from pypi into one we can use.
+    """
+    packages = OrderedDict()
+    for hit in hits:
+        name = hit['name']
+        summary = hit['summary']
+        version = hit['version']
+
+        if name not in packages.keys():
+            packages[name] = {
+                'name': name,
+                'summary': summary,
+                'versions': [version],
+            }
+        else:
+            packages[name]['versions'].append(version)
+
+            # if this is the highest version, replace summary and score
+            if version == highest_version(packages[name]['versions']):
+                packages[name]['summary'] = summary
+
+    return list(packages.values())
+
+
+def print_results(hits, name_column_width=None, terminal_width=None):
+    if not hits:
+        return
+    if name_column_width is None:
+        name_column_width = max([
+            len(hit['name']) + len(highest_version(hit.get('versions', ['-'])))
+            for hit in hits
+        ]) + 4
+
+    installed_packages = [p.project_name for p in pkg_resources.working_set]
+    for hit in hits:
+        name = hit['name']
+        summary = hit['summary'] or ''
+        latest = highest_version(hit.get('versions', ['-']))
+        if terminal_width is not None:
+            target_width = terminal_width - name_column_width - 5
+            if target_width > 10:
+                # wrap and indent summary to fit terminal
+                summary = textwrap.wrap(summary, target_width)
+                summary = ('\n' + ' ' * (name_column_width + 3)).join(summary)
+
+        line = '%-*s - %s' % (name_column_width,
+                              '%s (%s)' % (name, latest), summary)
+        try:
+            write_output(line)
+            if name in installed_packages:
+                dist = pkg_resources.get_distribution(name)
+                with indent_log():
+                    if dist.version == latest:
+                        write_output('INSTALLED: %s (latest)', dist.version)
+                    else:
+                        write_output('INSTALLED: %s', dist.version)
+                        if parse_version(latest).pre:
+                            write_output('LATEST:    %s (pre-release; install'
+                                         ' with "pip install --pre")', latest)
+                        else:
+                            write_output('LATEST:    %s', latest)
+        except UnicodeEncodeError:
+            pass
+
+
+def highest_version(versions):
+    return max(versions, key=parse_version)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py
new file mode 100644
index 0000000000000000000000000000000000000000..a46b08eeb3d22852421b2b6c8b1b15ce12aaa9a3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/show.py
@@ -0,0 +1,180 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+from email.parser import FeedParser
+
+from pip._vendor import pkg_resources
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.status_codes import ERROR, SUCCESS
+from pip._internal.utils.misc import write_output
+
+logger = logging.getLogger(__name__)
+
+
+class ShowCommand(Command):
+    """
+    Show information about one or more installed packages.
+
+    The output is in RFC-compliant mail header format.
+    """
+
+    usage = """
+      %prog [options] <package> ..."""
+    ignore_require_venv = True
+
+    def __init__(self, *args, **kw):
+        super(ShowCommand, self).__init__(*args, **kw)
+        self.cmd_opts.add_option(
+            '-f', '--files',
+            dest='files',
+            action='store_true',
+            default=False,
+            help='Show the full list of installed files for each package.')
+
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        if not args:
+            logger.warning('ERROR: Please provide a package name or names.')
+            return ERROR
+        query = args
+
+        results = search_packages_info(query)
+        if not print_results(
+                results, list_files=options.files, verbose=options.verbose):
+            return ERROR
+        return SUCCESS
+
+
+def search_packages_info(query):
+    """
+    Gather details from installed distributions. Print distribution name,
+    version, location, and installed files. Installed files requires a
+    pip generated 'installed-files.txt' in the distributions '.egg-info'
+    directory.
+    """
+    installed = {}
+    for p in pkg_resources.working_set:
+        installed[canonicalize_name(p.project_name)] = p
+
+    query_names = [canonicalize_name(name) for name in query]
+    missing = sorted(
+        [name for name, pkg in zip(query, query_names) if pkg not in installed]
+    )
+    if missing:
+        logger.warning('Package(s) not found: %s', ', '.join(missing))
+
+    def get_requiring_packages(package_name):
+        canonical_name = canonicalize_name(package_name)
+        return [
+            pkg.project_name for pkg in pkg_resources.working_set
+            if canonical_name in
+               [canonicalize_name(required.name) for required in
+                pkg.requires()]
+        ]
+
+    for dist in [installed[pkg] for pkg in query_names if pkg in installed]:
+        package = {
+            'name': dist.project_name,
+            'version': dist.version,
+            'location': dist.location,
+            'requires': [dep.project_name for dep in dist.requires()],
+            'required_by': get_requiring_packages(dist.project_name)
+        }
+        file_list = None
+        metadata = None
+        if isinstance(dist, pkg_resources.DistInfoDistribution):
+            # RECORDs should be part of .dist-info metadatas
+            if dist.has_metadata('RECORD'):
+                lines = dist.get_metadata_lines('RECORD')
+                paths = [l.split(',')[0] for l in lines]
+                paths = [os.path.join(dist.location, p) for p in paths]
+                file_list = [os.path.relpath(p, dist.location) for p in paths]
+
+            if dist.has_metadata('METADATA'):
+                metadata = dist.get_metadata('METADATA')
+        else:
+            # Otherwise use pip's log for .egg-info's
+            if dist.has_metadata('installed-files.txt'):
+                paths = dist.get_metadata_lines('installed-files.txt')
+                paths = [os.path.join(dist.egg_info, p) for p in paths]
+                file_list = [os.path.relpath(p, dist.location) for p in paths]
+
+            if dist.has_metadata('PKG-INFO'):
+                metadata = dist.get_metadata('PKG-INFO')
+
+        if dist.has_metadata('entry_points.txt'):
+            entry_points = dist.get_metadata_lines('entry_points.txt')
+            package['entry_points'] = entry_points
+
+        if dist.has_metadata('INSTALLER'):
+            for line in dist.get_metadata_lines('INSTALLER'):
+                if line.strip():
+                    package['installer'] = line.strip()
+                    break
+
+        # @todo: Should pkg_resources.Distribution have a
+        # `get_pkg_info` method?
+        feed_parser = FeedParser()
+        feed_parser.feed(metadata)
+        pkg_info_dict = feed_parser.close()
+        for key in ('metadata-version', 'summary',
+                    'home-page', 'author', 'author-email', 'license'):
+            package[key] = pkg_info_dict.get(key)
+
+        # It looks like FeedParser cannot deal with repeated headers
+        classifiers = []
+        for line in metadata.splitlines():
+            if line.startswith('Classifier: '):
+                classifiers.append(line[len('Classifier: '):])
+        package['classifiers'] = classifiers
+
+        if file_list:
+            package['files'] = sorted(file_list)
+        yield package
+
+
+def print_results(distributions, list_files=False, verbose=False):
+    """
+    Print the informations from installed distributions found.
+    """
+    results_printed = False
+    for i, dist in enumerate(distributions):
+        results_printed = True
+        if i > 0:
+            write_output("---")
+
+        write_output("Name: %s", dist.get('name', ''))
+        write_output("Version: %s", dist.get('version', ''))
+        write_output("Summary: %s", dist.get('summary', ''))
+        write_output("Home-page: %s", dist.get('home-page', ''))
+        write_output("Author: %s", dist.get('author', ''))
+        write_output("Author-email: %s", dist.get('author-email', ''))
+        write_output("License: %s", dist.get('license', ''))
+        write_output("Location: %s", dist.get('location', ''))
+        write_output("Requires: %s", ', '.join(dist.get('requires', [])))
+        write_output("Required-by: %s", ', '.join(dist.get('required_by', [])))
+
+        if verbose:
+            write_output("Metadata-Version: %s",
+                         dist.get('metadata-version', ''))
+            write_output("Installer: %s", dist.get('installer', ''))
+            write_output("Classifiers:")
+            for classifier in dist.get('classifiers', []):
+                write_output("  %s", classifier)
+            write_output("Entry-points:")
+            for entry in dist.get('entry_points', []):
+                write_output("  %s", entry.strip())
+        if list_files:
+            write_output("Files:")
+            for line in dist.get('files', []):
+                write_output("  %s", line.strip())
+            if "files" not in dist:
+                write_output("Cannot locate installed-files.txt")
+    return results_printed
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py
new file mode 100644
index 0000000000000000000000000000000000000000..1bde414a6c1a5f4b9ef5b990f22b334a9b0a71b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/uninstall.py
@@ -0,0 +1,82 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.cli.base_command import Command
+from pip._internal.cli.req_command import SessionCommandMixin
+from pip._internal.exceptions import InstallationError
+from pip._internal.req import parse_requirements
+from pip._internal.req.constructors import install_req_from_line
+from pip._internal.utils.misc import protect_pip_from_modification_on_windows
+
+
+class UninstallCommand(Command, SessionCommandMixin):
+    """
+    Uninstall packages.
+
+    pip is able to uninstall most installed packages. Known exceptions are:
+
+    - Pure distutils packages installed with ``python setup.py install``, which
+      leave behind no metadata to determine what files were installed.
+    - Script wrappers installed by ``python setup.py develop``.
+    """
+
+    usage = """
+      %prog [options] <package> ...
+      %prog [options] -r <requirements file> ..."""
+
+    def __init__(self, *args, **kw):
+        super(UninstallCommand, self).__init__(*args, **kw)
+        self.cmd_opts.add_option(
+            '-r', '--requirement',
+            dest='requirements',
+            action='append',
+            default=[],
+            metavar='file',
+            help='Uninstall all the packages listed in the given requirements '
+                 'file.  This option can be used multiple times.',
+        )
+        self.cmd_opts.add_option(
+            '-y', '--yes',
+            dest='yes',
+            action='store_true',
+            help="Don't ask for confirmation of uninstall deletions.")
+
+        self.parser.insert_option_group(0, self.cmd_opts)
+
+    def run(self, options, args):
+        session = self.get_default_session(options)
+
+        reqs_to_uninstall = {}
+        for name in args:
+            req = install_req_from_line(
+                name, isolated=options.isolated_mode,
+            )
+            if req.name:
+                reqs_to_uninstall[canonicalize_name(req.name)] = req
+        for filename in options.requirements:
+            for req in parse_requirements(
+                    filename,
+                    options=options,
+                    session=session):
+                if req.name:
+                    reqs_to_uninstall[canonicalize_name(req.name)] = req
+        if not reqs_to_uninstall:
+            raise InstallationError(
+                'You must give at least one requirement to %(name)s (see '
+                '"pip help %(name)s")' % dict(name=self.name)
+            )
+
+        protect_pip_from_modification_on_windows(
+            modifying_pip="pip" in reqs_to_uninstall
+        )
+
+        for req in reqs_to_uninstall.values():
+            uninstall_pathset = req.uninstall(
+                auto_confirm=options.yes, verbose=self.verbosity > 0,
+            )
+            if uninstall_pathset:
+                uninstall_pathset.commit()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb44bcee45930d10654d5bdc6af5658aef01bc41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/commands/wheel.py
@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import shutil
+
+from pip._internal.cache import WheelCache
+from pip._internal.cli import cmdoptions
+from pip._internal.cli.req_command import RequirementCommand
+from pip._internal.exceptions import CommandError, PreviousBuildDirError
+from pip._internal.req import RequirementSet
+from pip._internal.req.req_tracker import get_requirement_tracker
+from pip._internal.utils.misc import ensure_dir, normalize_path
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.wheel_builder import build, should_build_for_wheel_command
+
+if MYPY_CHECK_RUNNING:
+    from optparse import Values
+    from typing import Any, List
+
+
+logger = logging.getLogger(__name__)
+
+
+class WheelCommand(RequirementCommand):
+    """
+    Build Wheel archives for your requirements and dependencies.
+
+    Wheel is a built-package format, and offers the advantage of not
+    recompiling your software during every install. For more details, see the
+    wheel docs: https://wheel.readthedocs.io/en/latest/
+
+    Requirements: setuptools>=0.8, and wheel.
+
+    'pip wheel' uses the bdist_wheel setuptools extension from the wheel
+    package to build individual wheels.
+
+    """
+
+    usage = """
+      %prog [options] <requirement specifier> ...
+      %prog [options] -r <requirements file> ...
+      %prog [options] [-e] <vcs project url> ...
+      %prog [options] [-e] <local project path> ...
+      %prog [options] <archive url/path> ..."""
+
+    def __init__(self, *args, **kw):
+        super(WheelCommand, self).__init__(*args, **kw)
+
+        cmd_opts = self.cmd_opts
+
+        cmd_opts.add_option(
+            '-w', '--wheel-dir',
+            dest='wheel_dir',
+            metavar='dir',
+            default=os.curdir,
+            help=("Build wheels into <dir>, where the default is the "
+                  "current working directory."),
+        )
+        cmd_opts.add_option(cmdoptions.no_binary())
+        cmd_opts.add_option(cmdoptions.only_binary())
+        cmd_opts.add_option(cmdoptions.prefer_binary())
+        cmd_opts.add_option(
+            '--build-option',
+            dest='build_options',
+            metavar='options',
+            action='append',
+            help="Extra arguments to be supplied to 'setup.py bdist_wheel'.",
+        )
+        cmd_opts.add_option(cmdoptions.no_build_isolation())
+        cmd_opts.add_option(cmdoptions.use_pep517())
+        cmd_opts.add_option(cmdoptions.no_use_pep517())
+        cmd_opts.add_option(cmdoptions.constraints())
+        cmd_opts.add_option(cmdoptions.editable())
+        cmd_opts.add_option(cmdoptions.requirements())
+        cmd_opts.add_option(cmdoptions.src())
+        cmd_opts.add_option(cmdoptions.ignore_requires_python())
+        cmd_opts.add_option(cmdoptions.no_deps())
+        cmd_opts.add_option(cmdoptions.build_dir())
+        cmd_opts.add_option(cmdoptions.progress_bar())
+
+        cmd_opts.add_option(
+            '--global-option',
+            dest='global_options',
+            action='append',
+            metavar='options',
+            help="Extra global options to be supplied to the setup.py "
+            "call before the 'bdist_wheel' command.")
+
+        cmd_opts.add_option(
+            '--pre',
+            action='store_true',
+            default=False,
+            help=("Include pre-release and development versions. By default, "
+                  "pip only finds stable versions."),
+        )
+
+        cmd_opts.add_option(cmdoptions.no_clean())
+        cmd_opts.add_option(cmdoptions.require_hashes())
+
+        index_opts = cmdoptions.make_option_group(
+            cmdoptions.index_group,
+            self.parser,
+        )
+
+        self.parser.insert_option_group(0, index_opts)
+        self.parser.insert_option_group(0, cmd_opts)
+
+    def run(self, options, args):
+        # type: (Values, List[Any]) -> None
+        cmdoptions.check_install_build_global(options)
+
+        session = self.get_default_session(options)
+
+        finder = self._build_package_finder(options, session)
+        build_delete = (not (options.no_clean or options.build_dir))
+        wheel_cache = WheelCache(options.cache_dir, options.format_control)
+
+        options.wheel_dir = normalize_path(options.wheel_dir)
+        ensure_dir(options.wheel_dir)
+
+        with get_requirement_tracker() as req_tracker, TempDirectory(
+            options.build_dir, delete=build_delete, kind="wheel"
+        ) as directory:
+
+            requirement_set = RequirementSet()
+
+            try:
+                self.populate_requirement_set(
+                    requirement_set, args, options, finder, session,
+                    wheel_cache
+                )
+
+                preparer = self.make_requirement_preparer(
+                    temp_build_dir=directory,
+                    options=options,
+                    req_tracker=req_tracker,
+                    session=session,
+                    finder=finder,
+                    wheel_download_dir=options.wheel_dir,
+                    use_user_site=False,
+                )
+
+                resolver = self.make_resolver(
+                    preparer=preparer,
+                    finder=finder,
+                    options=options,
+                    wheel_cache=wheel_cache,
+                    ignore_requires_python=options.ignore_requires_python,
+                    use_pep517=options.use_pep517,
+                )
+
+                self.trace_basic_info(finder)
+
+                resolver.resolve(requirement_set)
+
+                reqs_to_build = [
+                    r for r in requirement_set.requirements.values()
+                    if should_build_for_wheel_command(r)
+                ]
+
+                # build wheels
+                build_successes, build_failures = build(
+                    reqs_to_build,
+                    wheel_cache=wheel_cache,
+                    build_options=options.build_options or [],
+                    global_options=options.global_options or [],
+                )
+                for req in build_successes:
+                    assert req.link and req.link.is_wheel
+                    assert req.local_file_path
+                    # copy from cache to target directory
+                    try:
+                        shutil.copy(req.local_file_path, options.wheel_dir)
+                    except OSError as e:
+                        logger.warning(
+                            "Building wheel for %s failed: %s",
+                            req.name, e,
+                        )
+                        build_failures.append(req)
+                if len(build_failures) != 0:
+                    raise CommandError(
+                        "Failed to build one or more wheels"
+                    )
+            except PreviousBuildDirError:
+                options.no_clean = True
+                raise
+            finally:
+                if not options.no_clean:
+                    requirement_set.cleanup_files()
+                    wheel_cache.cleanup()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/configuration.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/configuration.py
new file mode 100644
index 0000000000000000000000000000000000000000..f09a1ae25c2b58ad5d15040efc4cbd99658e54b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/configuration.py
@@ -0,0 +1,422 @@
+"""Configuration management setup
+
+Some terminology:
+- name
+  As written in config files.
+- value
+  Value associated with a name
+- key
+  Name combined with it's section (section.name)
+- variant
+  A single word describing where the configuration key-value pair came from
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import locale
+import logging
+import os
+import sys
+
+from pip._vendor.six.moves import configparser
+
+from pip._internal.exceptions import (
+    ConfigurationError,
+    ConfigurationFileCouldNotBeLoaded,
+)
+from pip._internal.utils import appdirs
+from pip._internal.utils.compat import WINDOWS, expanduser
+from pip._internal.utils.misc import ensure_dir, enum
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Dict, Iterable, List, NewType, Optional, Tuple
+    )
+
+    RawConfigParser = configparser.RawConfigParser  # Shorthand
+    Kind = NewType("Kind", str)
+
+logger = logging.getLogger(__name__)
+
+
+# NOTE: Maybe use the optionx attribute to normalize keynames.
+def _normalize_name(name):
+    # type: (str) -> str
+    """Make a name consistent regardless of source (environment or file)
+    """
+    name = name.lower().replace('_', '-')
+    if name.startswith('--'):
+        name = name[2:]  # only prefer long opts
+    return name
+
+
+def _disassemble_key(name):
+    # type: (str) -> List[str]
+    if "." not in name:
+        error_message = (
+            "Key does not contain dot separated section and key. "
+            "Perhaps you wanted to use 'global.{}' instead?"
+        ).format(name)
+        raise ConfigurationError(error_message)
+    return name.split(".", 1)
+
+
+# The kinds of configurations there are.
+kinds = enum(
+    USER="user",        # User Specific
+    GLOBAL="global",    # System Wide
+    SITE="site",        # [Virtual] Environment Specific
+    ENV="env",          # from PIP_CONFIG_FILE
+    ENV_VAR="env-var",  # from Environment Variables
+)
+
+
+CONFIG_BASENAME = 'pip.ini' if WINDOWS else 'pip.conf'
+
+
+def get_configuration_files():
+    # type: () -> Dict[Kind, List[str]]
+    global_config_files = [
+        os.path.join(path, CONFIG_BASENAME)
+        for path in appdirs.site_config_dirs('pip')
+    ]
+
+    site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME)
+    legacy_config_file = os.path.join(
+        expanduser('~'),
+        'pip' if WINDOWS else '.pip',
+        CONFIG_BASENAME,
+    )
+    new_config_file = os.path.join(
+        appdirs.user_config_dir("pip"), CONFIG_BASENAME
+    )
+    return {
+        kinds.GLOBAL: global_config_files,
+        kinds.SITE: [site_config_file],
+        kinds.USER: [legacy_config_file, new_config_file],
+    }
+
+
+class Configuration(object):
+    """Handles management of configuration.
+
+    Provides an interface to accessing and managing configuration files.
+
+    This class converts provides an API that takes "section.key-name" style
+    keys and stores the value associated with it as "key-name" under the
+    section "section".
+
+    This allows for a clean interface wherein the both the section and the
+    key-name are preserved in an easy to manage form in the configuration files
+    and the data stored is also nice.
+    """
+
+    def __init__(self, isolated, load_only=None):
+        # type: (bool, Kind) -> None
+        super(Configuration, self).__init__()
+
+        _valid_load_only = [kinds.USER, kinds.GLOBAL, kinds.SITE, None]
+        if load_only not in _valid_load_only:
+            raise ConfigurationError(
+                "Got invalid value for load_only - should be one of {}".format(
+                    ", ".join(map(repr, _valid_load_only[:-1]))
+                )
+            )
+        self.isolated = isolated  # type: bool
+        self.load_only = load_only  # type: Optional[Kind]
+
+        # The order here determines the override order.
+        self._override_order = [
+            kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR
+        ]
+
+        self._ignore_env_names = ["version", "help"]
+
+        # Because we keep track of where we got the data from
+        self._parsers = {
+            variant: [] for variant in self._override_order
+        }  # type: Dict[Kind, List[Tuple[str, RawConfigParser]]]
+        self._config = {
+            variant: {} for variant in self._override_order
+        }  # type: Dict[Kind, Dict[str, Any]]
+        self._modified_parsers = []  # type: List[Tuple[str, RawConfigParser]]
+
+    def load(self):
+        # type: () -> None
+        """Loads configuration from configuration files and environment
+        """
+        self._load_config_files()
+        if not self.isolated:
+            self._load_environment_vars()
+
+    def get_file_to_edit(self):
+        # type: () -> Optional[str]
+        """Returns the file with highest priority in configuration
+        """
+        assert self.load_only is not None, \
+            "Need to be specified a file to be editing"
+
+        try:
+            return self._get_parser_to_modify()[0]
+        except IndexError:
+            return None
+
+    def items(self):
+        # type: () -> Iterable[Tuple[str, Any]]
+        """Returns key-value pairs like dict.items() representing the loaded
+        configuration
+        """
+        return self._dictionary.items()
+
+    def get_value(self, key):
+        # type: (str) -> Any
+        """Get a value from the configuration.
+        """
+        try:
+            return self._dictionary[key]
+        except KeyError:
+            raise ConfigurationError("No such key - {}".format(key))
+
+    def set_value(self, key, value):
+        # type: (str, Any) -> None
+        """Modify a value in the configuration.
+        """
+        self._ensure_have_load_only()
+
+        fname, parser = self._get_parser_to_modify()
+
+        if parser is not None:
+            section, name = _disassemble_key(key)
+
+            # Modify the parser and the configuration
+            if not parser.has_section(section):
+                parser.add_section(section)
+            parser.set(section, name, value)
+
+        self._config[self.load_only][key] = value
+        self._mark_as_modified(fname, parser)
+
+    def unset_value(self, key):
+        # type: (str) -> None
+        """Unset a value in the configuration.
+        """
+        self._ensure_have_load_only()
+
+        if key not in self._config[self.load_only]:
+            raise ConfigurationError("No such key - {}".format(key))
+
+        fname, parser = self._get_parser_to_modify()
+
+        if parser is not None:
+            section, name = _disassemble_key(key)
+
+            # Remove the key in the parser
+            modified_something = False
+            if parser.has_section(section):
+                # Returns whether the option was removed or not
+                modified_something = parser.remove_option(section, name)
+
+            if modified_something:
+                # name removed from parser, section may now be empty
+                section_iter = iter(parser.items(section))
+                try:
+                    val = next(section_iter)
+                except StopIteration:
+                    val = None
+
+                if val is None:
+                    parser.remove_section(section)
+
+                self._mark_as_modified(fname, parser)
+            else:
+                raise ConfigurationError(
+                    "Fatal Internal error [id=1]. Please report as a bug."
+                )
+
+        del self._config[self.load_only][key]
+
+    def save(self):
+        # type: () -> None
+        """Save the current in-memory state.
+        """
+        self._ensure_have_load_only()
+
+        for fname, parser in self._modified_parsers:
+            logger.info("Writing to %s", fname)
+
+            # Ensure directory exists.
+            ensure_dir(os.path.dirname(fname))
+
+            with open(fname, "w") as f:
+                parser.write(f)
+
+    #
+    # Private routines
+    #
+
+    def _ensure_have_load_only(self):
+        # type: () -> None
+        if self.load_only is None:
+            raise ConfigurationError("Needed a specific file to be modifying.")
+        logger.debug("Will be working with %s variant only", self.load_only)
+
+    @property
+    def _dictionary(self):
+        # type: () -> Dict[str, Any]
+        """A dictionary representing the loaded configuration.
+        """
+        # NOTE: Dictionaries are not populated if not loaded. So, conditionals
+        #       are not needed here.
+        retval = {}
+
+        for variant in self._override_order:
+            retval.update(self._config[variant])
+
+        return retval
+
+    def _load_config_files(self):
+        # type: () -> None
+        """Loads configuration from configuration files
+        """
+        config_files = dict(self._iter_config_files())
+        if config_files[kinds.ENV][0:1] == [os.devnull]:
+            logger.debug(
+                "Skipping loading configuration files due to "
+                "environment's PIP_CONFIG_FILE being os.devnull"
+            )
+            return
+
+        for variant, files in config_files.items():
+            for fname in files:
+                # If there's specific variant set in `load_only`, load only
+                # that variant, not the others.
+                if self.load_only is not None and variant != self.load_only:
+                    logger.debug(
+                        "Skipping file '%s' (variant: %s)", fname, variant
+                    )
+                    continue
+
+                parser = self._load_file(variant, fname)
+
+                # Keeping track of the parsers used
+                self._parsers[variant].append((fname, parser))
+
+    def _load_file(self, variant, fname):
+        # type: (Kind, str) -> RawConfigParser
+        logger.debug("For variant '%s', will try loading '%s'", variant, fname)
+        parser = self._construct_parser(fname)
+
+        for section in parser.sections():
+            items = parser.items(section)
+            self._config[variant].update(self._normalized_keys(section, items))
+
+        return parser
+
+    def _construct_parser(self, fname):
+        # type: (str) -> RawConfigParser
+        parser = configparser.RawConfigParser()
+        # If there is no such file, don't bother reading it but create the
+        # parser anyway, to hold the data.
+        # Doing this is useful when modifying and saving files, where we don't
+        # need to construct a parser.
+        if os.path.exists(fname):
+            try:
+                parser.read(fname)
+            except UnicodeDecodeError:
+                # See https://github.com/pypa/pip/issues/4963
+                raise ConfigurationFileCouldNotBeLoaded(
+                    reason="contains invalid {} characters".format(
+                        locale.getpreferredencoding(False)
+                    ),
+                    fname=fname,
+                )
+            except configparser.Error as error:
+                # See https://github.com/pypa/pip/issues/4893
+                raise ConfigurationFileCouldNotBeLoaded(error=error)
+        return parser
+
+    def _load_environment_vars(self):
+        # type: () -> None
+        """Loads configuration from environment variables
+        """
+        self._config[kinds.ENV_VAR].update(
+            self._normalized_keys(":env:", self._get_environ_vars())
+        )
+
+    def _normalized_keys(self, section, items):
+        # type: (str, Iterable[Tuple[str, Any]]) -> Dict[str, Any]
+        """Normalizes items to construct a dictionary with normalized keys.
+
+        This routine is where the names become keys and are made the same
+        regardless of source - configuration files or environment.
+        """
+        normalized = {}
+        for name, val in items:
+            key = section + "." + _normalize_name(name)
+            normalized[key] = val
+        return normalized
+
+    def _get_environ_vars(self):
+        # type: () -> Iterable[Tuple[str, str]]
+        """Returns a generator with all environmental vars with prefix PIP_"""
+        for key, val in os.environ.items():
+            should_be_yielded = (
+                key.startswith("PIP_") and
+                key[4:].lower() not in self._ignore_env_names
+            )
+            if should_be_yielded:
+                yield key[4:].lower(), val
+
+    # XXX: This is patched in the tests.
+    def _iter_config_files(self):
+        # type: () -> Iterable[Tuple[Kind, List[str]]]
+        """Yields variant and configuration files associated with it.
+
+        This should be treated like items of a dictionary.
+        """
+        # SMELL: Move the conditions out of this function
+
+        # environment variables have the lowest priority
+        config_file = os.environ.get('PIP_CONFIG_FILE', None)
+        if config_file is not None:
+            yield kinds.ENV, [config_file]
+        else:
+            yield kinds.ENV, []
+
+        config_files = get_configuration_files()
+
+        # at the base we have any global configuration
+        yield kinds.GLOBAL, config_files[kinds.GLOBAL]
+
+        # per-user configuration next
+        should_load_user_config = not self.isolated and not (
+            config_file and os.path.exists(config_file)
+        )
+        if should_load_user_config:
+            # The legacy config file is overridden by the new config file
+            yield kinds.USER, config_files[kinds.USER]
+
+        # finally virtualenv configuration first trumping others
+        yield kinds.SITE, config_files[kinds.SITE]
+
+    def _get_parser_to_modify(self):
+        # type: () -> Tuple[str, RawConfigParser]
+        # Determine which parser to modify
+        parsers = self._parsers[self.load_only]
+        if not parsers:
+            # This should not happen if everything works correctly.
+            raise ConfigurationError(
+                "Fatal Internal error [id=2]. Please report as a bug."
+            )
+
+        # Use the highest priority parser.
+        return parsers[-1]
+
+    # XXX: This is patched in the tests.
+    def _mark_as_modified(self, fname, parser):
+        # type: (str, RawConfigParser) -> None
+        file_parser_tuple = (fname, parser)
+        if file_parser_tuple not in self._modified_parsers:
+            self._modified_parsers.append(file_parser_tuple)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5c1afc5bc1ffd09c0ce46f4f2f700a1b996fe47
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py
@@ -0,0 +1,24 @@
+from pip._internal.distributions.sdist import SourceDistribution
+from pip._internal.distributions.wheel import WheelDistribution
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from pip._internal.distributions.base import AbstractDistribution
+    from pip._internal.req.req_install import InstallRequirement
+
+
+def make_distribution_for_install_requirement(install_req):
+    # type: (InstallRequirement) -> AbstractDistribution
+    """Returns a Distribution for the given InstallRequirement
+    """
+    # Editable requirements will always be source distributions. They use the
+    # legacy logic until we create a modern standard for them.
+    if install_req.editable:
+        return SourceDistribution(install_req)
+
+    # If it's a wheel, it's a WheelDistribution
+    if install_req.is_wheel:
+        return WheelDistribution(install_req)
+
+    # Otherwise, a SourceDistribution
+    return SourceDistribution(install_req)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/base.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/base.py
new file mode 100644
index 0000000000000000000000000000000000000000..b836b98d162abda775f4b0c2b132eac4cf58a22d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/base.py
@@ -0,0 +1,45 @@
+import abc
+
+from pip._vendor.six import add_metaclass
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional
+
+    from pip._vendor.pkg_resources import Distribution
+    from pip._internal.req import InstallRequirement
+    from pip._internal.index.package_finder import PackageFinder
+
+
+@add_metaclass(abc.ABCMeta)
+class AbstractDistribution(object):
+    """A base class for handling installable artifacts.
+
+    The requirements for anything installable are as follows:
+
+     - we must be able to determine the requirement name
+       (or we can't correctly handle the non-upgrade case).
+
+     - for packages with setup requirements, we must also be able
+       to determine their requirements without installing additional
+       packages (for the same reason as run-time dependencies)
+
+     - we must be able to create a Distribution object exposing the
+       above metadata.
+    """
+
+    def __init__(self, req):
+        # type: (InstallRequirement) -> None
+        super(AbstractDistribution, self).__init__()
+        self.req = req
+
+    @abc.abstractmethod
+    def get_pkg_resources_distribution(self):
+        # type: () -> Optional[Distribution]
+        raise NotImplementedError()
+
+    @abc.abstractmethod
+    def prepare_distribution_metadata(self, finder, build_isolation):
+        # type: (PackageFinder, bool) -> None
+        raise NotImplementedError()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d15bf42405e541b5154de307c54df47b9b7e2ec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/installed.py
@@ -0,0 +1,24 @@
+from pip._internal.distributions.base import AbstractDistribution
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional
+
+    from pip._vendor.pkg_resources import Distribution
+    from pip._internal.index.package_finder import PackageFinder
+
+
+class InstalledDistribution(AbstractDistribution):
+    """Represents an installed package.
+
+    This does not need any preparation as the required information has already
+    been computed.
+    """
+
+    def get_pkg_resources_distribution(self):
+        # type: () -> Optional[Distribution]
+        return self.req.satisfied_by
+
+    def prepare_distribution_metadata(self, finder, build_isolation):
+        # type: (PackageFinder, bool) -> None
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py
new file mode 100644
index 0000000000000000000000000000000000000000..be3d7d97a1cfe877ce549603ebe1e17c65d68803
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/sdist.py
@@ -0,0 +1,104 @@
+import logging
+
+from pip._internal.build_env import BuildEnvironment
+from pip._internal.distributions.base import AbstractDistribution
+from pip._internal.exceptions import InstallationError
+from pip._internal.utils.subprocess import runner_with_spinner_message
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Set, Tuple
+
+    from pip._vendor.pkg_resources import Distribution
+    from pip._internal.index.package_finder import PackageFinder
+
+
+logger = logging.getLogger(__name__)
+
+
+class SourceDistribution(AbstractDistribution):
+    """Represents a source distribution.
+
+    The preparation step for these needs metadata for the packages to be
+    generated, either using PEP 517 or using the legacy `setup.py egg_info`.
+    """
+
+    def get_pkg_resources_distribution(self):
+        # type: () -> Distribution
+        return self.req.get_dist()
+
+    def prepare_distribution_metadata(self, finder, build_isolation):
+        # type: (PackageFinder, bool) -> None
+        # Load pyproject.toml, to determine whether PEP 517 is to be used
+        self.req.load_pyproject_toml()
+
+        # Set up the build isolation, if this requirement should be isolated
+        should_isolate = self.req.use_pep517 and build_isolation
+        if should_isolate:
+            self._setup_isolation(finder)
+
+        self.req.prepare_metadata()
+
+    def _setup_isolation(self, finder):
+        # type: (PackageFinder) -> None
+        def _raise_conflicts(conflicting_with, conflicting_reqs):
+            # type: (str, Set[Tuple[str, str]]) -> None
+            format_string = (
+                "Some build dependencies for {requirement} "
+                "conflict with {conflicting_with}: {description}."
+            )
+            error_message = format_string.format(
+                requirement=self.req,
+                conflicting_with=conflicting_with,
+                description=', '.join(
+                    '{} is incompatible with {}'.format(installed, wanted)
+                    for installed, wanted in sorted(conflicting)
+                )
+            )
+            raise InstallationError(error_message)
+
+        # Isolate in a BuildEnvironment and install the build-time
+        # requirements.
+        pyproject_requires = self.req.pyproject_requires
+        assert pyproject_requires is not None
+
+        self.req.build_env = BuildEnvironment()
+        self.req.build_env.install_requirements(
+            finder, pyproject_requires, 'overlay',
+            "Installing build dependencies"
+        )
+        conflicting, missing = self.req.build_env.check_requirements(
+            self.req.requirements_to_check
+        )
+        if conflicting:
+            _raise_conflicts("PEP 517/518 supported requirements",
+                             conflicting)
+        if missing:
+            logger.warning(
+                "Missing build requirements in pyproject.toml for %s.",
+                self.req,
+            )
+            logger.warning(
+                "The project does not specify a build backend, and "
+                "pip cannot fall back to setuptools without %s.",
+                " and ".join(map(repr, sorted(missing)))
+            )
+        # Install any extra build dependencies that the backend requests.
+        # This must be done in a second pass, as the pyproject.toml
+        # dependencies must be installed before we can call the backend.
+        with self.req.build_env:
+            runner = runner_with_spinner_message(
+                "Getting requirements to build wheel"
+            )
+            backend = self.req.pep517_backend
+            assert backend is not None
+            with backend.subprocess_runner(runner):
+                reqs = backend.get_requires_for_build_wheel()
+
+        conflicting, missing = self.req.build_env.check_requirements(reqs)
+        if conflicting:
+            _raise_conflicts("the backend dependencies", conflicting)
+        self.req.build_env.install_requirements(
+            finder, missing, 'normal',
+            "Installing backend dependencies"
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf3482b151f08196c82e719a9c194dfc20e4182e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py
@@ -0,0 +1,36 @@
+from zipfile import ZipFile
+
+from pip._internal.distributions.base import AbstractDistribution
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.wheel import pkg_resources_distribution_for_wheel
+
+if MYPY_CHECK_RUNNING:
+    from pip._vendor.pkg_resources import Distribution
+    from pip._internal.index.package_finder import PackageFinder
+
+
+class WheelDistribution(AbstractDistribution):
+    """Represents a wheel distribution.
+
+    This does not need any preparation as wheels can be directly unpacked.
+    """
+
+    def get_pkg_resources_distribution(self):
+        # type: () -> Distribution
+        """Loads the metadata from the wheel file into memory and returns a
+        Distribution that uses it, not relying on the wheel file or
+        requirement.
+        """
+        # Set as part of preparation during download.
+        assert self.req.local_file_path
+        # Wheels are never unnamed.
+        assert self.req.name
+
+        with ZipFile(self.req.local_file_path, allowZip64=True) as z:
+            return pkg_resources_distribution_for_wheel(
+                z, self.req.name, self.req.local_file_path
+            )
+
+    def prepare_distribution_metadata(self, finder, build_isolation):
+        # type: (PackageFinder, bool) -> None
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..dddec789ef40daff2e23a8da45e1042fd210bdc7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/exceptions.py
@@ -0,0 +1,308 @@
+"""Exceptions used throughout package"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+from itertools import chain, groupby, repeat
+
+from pip._vendor.six import iteritems
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional
+    from pip._vendor.pkg_resources import Distribution
+    from pip._internal.req.req_install import InstallRequirement
+
+
+class PipError(Exception):
+    """Base pip exception"""
+
+
+class ConfigurationError(PipError):
+    """General exception in configuration"""
+
+
+class InstallationError(PipError):
+    """General exception during installation"""
+
+
+class UninstallationError(PipError):
+    """General exception during uninstallation"""
+
+
+class NoneMetadataError(PipError):
+    """
+    Raised when accessing "METADATA" or "PKG-INFO" metadata for a
+    pip._vendor.pkg_resources.Distribution object and
+    `dist.has_metadata('METADATA')` returns True but
+    `dist.get_metadata('METADATA')` returns None (and similarly for
+    "PKG-INFO").
+    """
+
+    def __init__(self, dist, metadata_name):
+        # type: (Distribution, str) -> None
+        """
+        :param dist: A Distribution object.
+        :param metadata_name: The name of the metadata being accessed
+            (can be "METADATA" or "PKG-INFO").
+        """
+        self.dist = dist
+        self.metadata_name = metadata_name
+
+    def __str__(self):
+        # type: () -> str
+        # Use `dist` in the error message because its stringification
+        # includes more information, like the version and location.
+        return (
+            'None {} metadata found for distribution: {}'.format(
+                self.metadata_name, self.dist,
+            )
+        )
+
+
+class DistributionNotFound(InstallationError):
+    """Raised when a distribution cannot be found to satisfy a requirement"""
+
+
+class RequirementsFileParseError(InstallationError):
+    """Raised when a general error occurs parsing a requirements file line."""
+
+
+class BestVersionAlreadyInstalled(PipError):
+    """Raised when the most up-to-date version of a package is already
+    installed."""
+
+
+class BadCommand(PipError):
+    """Raised when virtualenv or a command is not found"""
+
+
+class CommandError(PipError):
+    """Raised when there is an error in command-line arguments"""
+
+
+class PreviousBuildDirError(PipError):
+    """Raised when there's a previous conflicting build directory"""
+
+
+class InvalidWheelFilename(InstallationError):
+    """Invalid wheel filename."""
+
+
+class UnsupportedWheel(InstallationError):
+    """Unsupported wheel."""
+
+
+class HashErrors(InstallationError):
+    """Multiple HashError instances rolled into one for reporting"""
+
+    def __init__(self):
+        self.errors = []
+
+    def append(self, error):
+        self.errors.append(error)
+
+    def __str__(self):
+        lines = []
+        self.errors.sort(key=lambda e: e.order)
+        for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__):
+            lines.append(cls.head)
+            lines.extend(e.body() for e in errors_of_cls)
+        if lines:
+            return '\n'.join(lines)
+
+    def __nonzero__(self):
+        return bool(self.errors)
+
+    def __bool__(self):
+        return self.__nonzero__()
+
+
+class HashError(InstallationError):
+    """
+    A failure to verify a package against known-good hashes
+
+    :cvar order: An int sorting hash exception classes by difficulty of
+        recovery (lower being harder), so the user doesn't bother fretting
+        about unpinned packages when he has deeper issues, like VCS
+        dependencies, to deal with. Also keeps error reports in a
+        deterministic order.
+    :cvar head: A section heading for display above potentially many
+        exceptions of this kind
+    :ivar req: The InstallRequirement that triggered this error. This is
+        pasted on after the exception is instantiated, because it's not
+        typically available earlier.
+
+    """
+    req = None  # type: Optional[InstallRequirement]
+    head = ''
+
+    def body(self):
+        """Return a summary of me for display under the heading.
+
+        This default implementation simply prints a description of the
+        triggering requirement.
+
+        :param req: The InstallRequirement that provoked this error, with
+            populate_link() having already been called
+
+        """
+        return '    %s' % self._requirement_name()
+
+    def __str__(self):
+        return '%s\n%s' % (self.head, self.body())
+
+    def _requirement_name(self):
+        """Return a description of the requirement that triggered me.
+
+        This default implementation returns long description of the req, with
+        line numbers
+
+        """
+        return str(self.req) if self.req else 'unknown package'
+
+
+class VcsHashUnsupported(HashError):
+    """A hash was provided for a version-control-system-based requirement, but
+    we don't have a method for hashing those."""
+
+    order = 0
+    head = ("Can't verify hashes for these requirements because we don't "
+            "have a way to hash version control repositories:")
+
+
+class DirectoryUrlHashUnsupported(HashError):
+    """A hash was provided for a version-control-system-based requirement, but
+    we don't have a method for hashing those."""
+
+    order = 1
+    head = ("Can't verify hashes for these file:// requirements because they "
+            "point to directories:")
+
+
+class HashMissing(HashError):
+    """A hash was needed for a requirement but is absent."""
+
+    order = 2
+    head = ('Hashes are required in --require-hashes mode, but they are '
+            'missing from some requirements. Here is a list of those '
+            'requirements along with the hashes their downloaded archives '
+            'actually had. Add lines like these to your requirements files to '
+            'prevent tampering. (If you did not enable --require-hashes '
+            'manually, note that it turns on automatically when any package '
+            'has a hash.)')
+
+    def __init__(self, gotten_hash):
+        """
+        :param gotten_hash: The hash of the (possibly malicious) archive we
+            just downloaded
+        """
+        self.gotten_hash = gotten_hash
+
+    def body(self):
+        # Dodge circular import.
+        from pip._internal.utils.hashes import FAVORITE_HASH
+
+        package = None
+        if self.req:
+            # In the case of URL-based requirements, display the original URL
+            # seen in the requirements file rather than the package name,
+            # so the output can be directly copied into the requirements file.
+            package = (self.req.original_link if self.req.original_link
+                       # In case someone feeds something downright stupid
+                       # to InstallRequirement's constructor.
+                       else getattr(self.req, 'req', None))
+        return '    %s --hash=%s:%s' % (package or 'unknown package',
+                                        FAVORITE_HASH,
+                                        self.gotten_hash)
+
+
+class HashUnpinned(HashError):
+    """A requirement had a hash specified but was not pinned to a specific
+    version."""
+
+    order = 3
+    head = ('In --require-hashes mode, all requirements must have their '
+            'versions pinned with ==. These do not:')
+
+
+class HashMismatch(HashError):
+    """
+    Distribution file hash values don't match.
+
+    :ivar package_name: The name of the package that triggered the hash
+        mismatch. Feel free to write to this after the exception is raise to
+        improve its error message.
+
+    """
+    order = 4
+    head = ('THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS '
+            'FILE. If you have updated the package versions, please update '
+            'the hashes. Otherwise, examine the package contents carefully; '
+            'someone may have tampered with them.')
+
+    def __init__(self, allowed, gots):
+        """
+        :param allowed: A dict of algorithm names pointing to lists of allowed
+            hex digests
+        :param gots: A dict of algorithm names pointing to hashes we
+            actually got from the files under suspicion
+        """
+        self.allowed = allowed
+        self.gots = gots
+
+    def body(self):
+        return '    %s:\n%s' % (self._requirement_name(),
+                                self._hash_comparison())
+
+    def _hash_comparison(self):
+        """
+        Return a comparison of actual and expected hash values.
+
+        Example::
+
+               Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde
+                            or 123451234512345123451234512345123451234512345
+                    Got        bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef
+
+        """
+        def hash_then_or(hash_name):
+            # For now, all the decent hashes have 6-char names, so we can get
+            # away with hard-coding space literals.
+            return chain([hash_name], repeat('    or'))
+
+        lines = []
+        for hash_name, expecteds in iteritems(self.allowed):
+            prefix = hash_then_or(hash_name)
+            lines.extend(('        Expected %s %s' % (next(prefix), e))
+                         for e in expecteds)
+            lines.append('             Got        %s\n' %
+                         self.gots[hash_name].hexdigest())
+        return '\n'.join(lines)
+
+
+class UnsupportedPythonVersion(InstallationError):
+    """Unsupported python version according to Requires-Python package
+    metadata."""
+
+
+class ConfigurationFileCouldNotBeLoaded(ConfigurationError):
+    """When there are errors while loading a configuration file
+    """
+
+    def __init__(self, reason="could not be loaded", fname=None, error=None):
+        super(ConfigurationFileCouldNotBeLoaded, self).__init__(error)
+        self.reason = reason
+        self.fname = fname
+        self.error = error
+
+    def __str__(self):
+        if self.fname is not None:
+            message_part = " in {}.".format(self.fname)
+        else:
+            assert self.error is not None
+            message_part = ".\n{}\n".format(self.error.message)
+        return "Configuration file {}{}".format(self.reason, message_part)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a17b7b3b6ad49157ee41f3da304fec3d32342d3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/__init__.py
@@ -0,0 +1,2 @@
+"""Index interaction code
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/collector.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/collector.py
new file mode 100644
index 0000000000000000000000000000000000000000..8330793171a3946d2bdba22c81784711acfa5e75
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/collector.py
@@ -0,0 +1,544 @@
+"""
+The main purpose of this module is to expose LinkCollector.collect_links().
+"""
+
+import cgi
+import itertools
+import logging
+import mimetypes
+import os
+from collections import OrderedDict
+
+from pip._vendor import html5lib, requests
+from pip._vendor.distlib.compat import unescape
+from pip._vendor.requests.exceptions import HTTPError, RetryError, SSLError
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+from pip._vendor.six.moves.urllib import request as urllib_request
+
+from pip._internal.models.link import Link
+from pip._internal.utils.filetypes import ARCHIVE_EXTENSIONS
+from pip._internal.utils.misc import redact_auth_from_url
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url, url_to_path
+from pip._internal.vcs import is_url, vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Callable, Iterable, List, MutableMapping, Optional, Sequence, Tuple,
+        Union,
+    )
+    import xml.etree.ElementTree
+
+    from pip._vendor.requests import Response
+
+    from pip._internal.models.search_scope import SearchScope
+    from pip._internal.network.session import PipSession
+
+    HTMLElement = xml.etree.ElementTree.Element
+    ResponseHeaders = MutableMapping[str, str]
+
+
+logger = logging.getLogger(__name__)
+
+
+def _match_vcs_scheme(url):
+    # type: (str) -> Optional[str]
+    """Look for VCS schemes in the URL.
+
+    Returns the matched VCS scheme, or None if there's no match.
+    """
+    for scheme in vcs.schemes:
+        if url.lower().startswith(scheme) and url[len(scheme)] in '+:':
+            return scheme
+    return None
+
+
+def _is_url_like_archive(url):
+    # type: (str) -> bool
+    """Return whether the URL looks like an archive.
+    """
+    filename = Link(url).filename
+    for bad_ext in ARCHIVE_EXTENSIONS:
+        if filename.endswith(bad_ext):
+            return True
+    return False
+
+
+class _NotHTML(Exception):
+    def __init__(self, content_type, request_desc):
+        # type: (str, str) -> None
+        super(_NotHTML, self).__init__(content_type, request_desc)
+        self.content_type = content_type
+        self.request_desc = request_desc
+
+
+def _ensure_html_header(response):
+    # type: (Response) -> None
+    """Check the Content-Type header to ensure the response contains HTML.
+
+    Raises `_NotHTML` if the content type is not text/html.
+    """
+    content_type = response.headers.get("Content-Type", "")
+    if not content_type.lower().startswith("text/html"):
+        raise _NotHTML(content_type, response.request.method)
+
+
+class _NotHTTP(Exception):
+    pass
+
+
+def _ensure_html_response(url, session):
+    # type: (str, PipSession) -> None
+    """Send a HEAD request to the URL, and ensure the response contains HTML.
+
+    Raises `_NotHTTP` if the URL is not available for a HEAD request, or
+    `_NotHTML` if the content type is not text/html.
+    """
+    scheme, netloc, path, query, fragment = urllib_parse.urlsplit(url)
+    if scheme not in {'http', 'https'}:
+        raise _NotHTTP()
+
+    resp = session.head(url, allow_redirects=True)
+    resp.raise_for_status()
+
+    _ensure_html_header(resp)
+
+
+def _get_html_response(url, session):
+    # type: (str, PipSession) -> Response
+    """Access an HTML page with GET, and return the response.
+
+    This consists of three parts:
+
+    1. If the URL looks suspiciously like an archive, send a HEAD first to
+       check the Content-Type is HTML, to avoid downloading a large file.
+       Raise `_NotHTTP` if the content type cannot be determined, or
+       `_NotHTML` if it is not HTML.
+    2. Actually perform the request. Raise HTTP exceptions on network failures.
+    3. Check the Content-Type header to make sure we got HTML, and raise
+       `_NotHTML` otherwise.
+    """
+    if _is_url_like_archive(url):
+        _ensure_html_response(url, session=session)
+
+    logger.debug('Getting page %s', redact_auth_from_url(url))
+
+    resp = session.get(
+        url,
+        headers={
+            "Accept": "text/html",
+            # We don't want to blindly returned cached data for
+            # /simple/, because authors generally expecting that
+            # twine upload && pip install will function, but if
+            # they've done a pip install in the last ~10 minutes
+            # it won't. Thus by setting this to zero we will not
+            # blindly use any cached data, however the benefit of
+            # using max-age=0 instead of no-cache, is that we will
+            # still support conditional requests, so we will still
+            # minimize traffic sent in cases where the page hasn't
+            # changed at all, we will just always incur the round
+            # trip for the conditional GET now instead of only
+            # once per 10 minutes.
+            # For more information, please see pypa/pip#5670.
+            "Cache-Control": "max-age=0",
+        },
+    )
+    resp.raise_for_status()
+
+    # The check for archives above only works if the url ends with
+    # something that looks like an archive. However that is not a
+    # requirement of an url. Unless we issue a HEAD request on every
+    # url we cannot know ahead of time for sure if something is HTML
+    # or not. However we can check after we've downloaded it.
+    _ensure_html_header(resp)
+
+    return resp
+
+
+def _get_encoding_from_headers(headers):
+    # type: (ResponseHeaders) -> Optional[str]
+    """Determine if we have any encoding information in our headers.
+    """
+    if headers and "Content-Type" in headers:
+        content_type, params = cgi.parse_header(headers["Content-Type"])
+        if "charset" in params:
+            return params['charset']
+    return None
+
+
+def _determine_base_url(document, page_url):
+    # type: (HTMLElement, str) -> str
+    """Determine the HTML document's base URL.
+
+    This looks for a ``<base>`` tag in the HTML document. If present, its href
+    attribute denotes the base URL of anchor tags in the document. If there is
+    no such tag (or if it does not have a valid href attribute), the HTML
+    file's URL is used as the base URL.
+
+    :param document: An HTML document representation. The current
+        implementation expects the result of ``html5lib.parse()``.
+    :param page_url: The URL of the HTML document.
+    """
+    for base in document.findall(".//base"):
+        href = base.get("href")
+        if href is not None:
+            return href
+    return page_url
+
+
+def _clean_link(url):
+    # type: (str) -> str
+    """Makes sure a link is fully encoded.  That is, if a ' ' shows up in
+    the link, it will be rewritten to %20 (while not over-quoting
+    % or other characters)."""
+    # Split the URL into parts according to the general structure
+    # `scheme://netloc/path;parameters?query#fragment`. Note that the
+    # `netloc` can be empty and the URI will then refer to a local
+    # filesystem path.
+    result = urllib_parse.urlparse(url)
+    # In both cases below we unquote prior to quoting to make sure
+    # nothing is double quoted.
+    if result.netloc == "":
+        # On Windows the path part might contain a drive letter which
+        # should not be quoted. On Linux where drive letters do not
+        # exist, the colon should be quoted. We rely on urllib.request
+        # to do the right thing here.
+        path = urllib_request.pathname2url(
+            urllib_request.url2pathname(result.path))
+    else:
+        # In addition to the `/` character we protect `@` so that
+        # revision strings in VCS URLs are properly parsed.
+        path = urllib_parse.quote(urllib_parse.unquote(result.path), safe="/@")
+    return urllib_parse.urlunparse(result._replace(path=path))
+
+
+def _create_link_from_element(
+    anchor,    # type: HTMLElement
+    page_url,  # type: str
+    base_url,  # type: str
+):
+    # type: (...) -> Optional[Link]
+    """
+    Convert an anchor element in a simple repository page to a Link.
+    """
+    href = anchor.get("href")
+    if not href:
+        return None
+
+    url = _clean_link(urllib_parse.urljoin(base_url, href))
+    pyrequire = anchor.get('data-requires-python')
+    pyrequire = unescape(pyrequire) if pyrequire else None
+
+    yanked_reason = anchor.get('data-yanked')
+    if yanked_reason:
+        # This is a unicode string in Python 2 (and 3).
+        yanked_reason = unescape(yanked_reason)
+
+    link = Link(
+        url,
+        comes_from=page_url,
+        requires_python=pyrequire,
+        yanked_reason=yanked_reason,
+    )
+
+    return link
+
+
+def parse_links(page):
+    # type: (HTMLPage) -> Iterable[Link]
+    """
+    Parse an HTML document, and yield its anchor elements as Link objects.
+    """
+    document = html5lib.parse(
+        page.content,
+        transport_encoding=page.encoding,
+        namespaceHTMLElements=False,
+    )
+
+    url = page.url
+    base_url = _determine_base_url(document, url)
+    for anchor in document.findall(".//a"):
+        link = _create_link_from_element(
+            anchor,
+            page_url=url,
+            base_url=base_url,
+        )
+        if link is None:
+            continue
+        yield link
+
+
+class HTMLPage(object):
+    """Represents one page, along with its URL"""
+
+    def __init__(
+        self,
+        content,   # type: bytes
+        encoding,  # type: Optional[str]
+        url,       # type: str
+    ):
+        # type: (...) -> None
+        """
+        :param encoding: the encoding to decode the given content.
+        :param url: the URL from which the HTML was downloaded.
+        """
+        self.content = content
+        self.encoding = encoding
+        self.url = url
+
+    def __str__(self):
+        # type: () -> str
+        return redact_auth_from_url(self.url)
+
+
+def _handle_get_page_fail(
+    link,  # type: Link
+    reason,  # type: Union[str, Exception]
+    meth=None  # type: Optional[Callable[..., None]]
+):
+    # type: (...) -> None
+    if meth is None:
+        meth = logger.debug
+    meth("Could not fetch URL %s: %s - skipping", link, reason)
+
+
+def _make_html_page(response):
+    # type: (Response) -> HTMLPage
+    encoding = _get_encoding_from_headers(response.headers)
+    return HTMLPage(response.content, encoding=encoding, url=response.url)
+
+
+def _get_html_page(link, session=None):
+    # type: (Link, Optional[PipSession]) -> Optional[HTMLPage]
+    if session is None:
+        raise TypeError(
+            "_get_html_page() missing 1 required keyword argument: 'session'"
+        )
+
+    url = link.url.split('#', 1)[0]
+
+    # Check for VCS schemes that do not support lookup as web pages.
+    vcs_scheme = _match_vcs_scheme(url)
+    if vcs_scheme:
+        logger.debug('Cannot look at %s URL %s', vcs_scheme, link)
+        return None
+
+    # Tack index.html onto file:// URLs that point to directories
+    scheme, _, path, _, _, _ = urllib_parse.urlparse(url)
+    if (scheme == 'file' and os.path.isdir(urllib_request.url2pathname(path))):
+        # add trailing slash if not present so urljoin doesn't trim
+        # final segment
+        if not url.endswith('/'):
+            url += '/'
+        url = urllib_parse.urljoin(url, 'index.html')
+        logger.debug(' file: URL is directory, getting %s', url)
+
+    try:
+        resp = _get_html_response(url, session=session)
+    except _NotHTTP:
+        logger.debug(
+            'Skipping page %s because it looks like an archive, and cannot '
+            'be checked by HEAD.', link,
+        )
+    except _NotHTML as exc:
+        logger.debug(
+            'Skipping page %s because the %s request got Content-Type: %s',
+            link, exc.request_desc, exc.content_type,
+        )
+    except HTTPError as exc:
+        _handle_get_page_fail(link, exc)
+    except RetryError as exc:
+        _handle_get_page_fail(link, exc)
+    except SSLError as exc:
+        reason = "There was a problem confirming the ssl certificate: "
+        reason += str(exc)
+        _handle_get_page_fail(link, reason, meth=logger.info)
+    except requests.ConnectionError as exc:
+        _handle_get_page_fail(link, "connection error: %s" % exc)
+    except requests.Timeout:
+        _handle_get_page_fail(link, "timed out")
+    else:
+        return _make_html_page(resp)
+    return None
+
+
+def _remove_duplicate_links(links):
+    # type: (Iterable[Link]) -> List[Link]
+    """
+    Return a list of links, with duplicates removed and ordering preserved.
+    """
+    # We preserve the ordering when removing duplicates because we can.
+    return list(OrderedDict.fromkeys(links))
+
+
+def group_locations(locations, expand_dir=False):
+    # type: (Sequence[str], bool) -> Tuple[List[str], List[str]]
+    """
+    Divide a list of locations into two groups: "files" (archives) and "urls."
+
+    :return: A pair of lists (files, urls).
+    """
+    files = []
+    urls = []
+
+    # puts the url for the given file path into the appropriate list
+    def sort_path(path):
+        # type: (str) -> None
+        url = path_to_url(path)
+        if mimetypes.guess_type(url, strict=False)[0] == 'text/html':
+            urls.append(url)
+        else:
+            files.append(url)
+
+    for url in locations:
+
+        is_local_path = os.path.exists(url)
+        is_file_url = url.startswith('file:')
+
+        if is_local_path or is_file_url:
+            if is_local_path:
+                path = url
+            else:
+                path = url_to_path(url)
+            if os.path.isdir(path):
+                if expand_dir:
+                    path = os.path.realpath(path)
+                    for item in os.listdir(path):
+                        sort_path(os.path.join(path, item))
+                elif is_file_url:
+                    urls.append(url)
+                else:
+                    logger.warning(
+                        "Path '{0}' is ignored: "
+                        "it is a directory.".format(path),
+                    )
+            elif os.path.isfile(path):
+                sort_path(path)
+            else:
+                logger.warning(
+                    "Url '%s' is ignored: it is neither a file "
+                    "nor a directory.", url,
+                )
+        elif is_url(url):
+            # Only add url with clear scheme
+            urls.append(url)
+        else:
+            logger.warning(
+                "Url '%s' is ignored. It is either a non-existing "
+                "path or lacks a specific scheme.", url,
+            )
+
+    return files, urls
+
+
+class CollectedLinks(object):
+
+    """
+    Encapsulates the return value of a call to LinkCollector.collect_links().
+
+    The return value includes both URLs to project pages containing package
+    links, as well as individual package Link objects collected from other
+    sources.
+
+    This info is stored separately as:
+
+    (1) links from the configured file locations,
+    (2) links from the configured find_links, and
+    (3) urls to HTML project pages, as described by the PEP 503 simple
+        repository API.
+    """
+
+    def __init__(
+        self,
+        files,         # type: List[Link]
+        find_links,    # type: List[Link]
+        project_urls,  # type: List[Link]
+    ):
+        # type: (...) -> None
+        """
+        :param files: Links from file locations.
+        :param find_links: Links from find_links.
+        :param project_urls: URLs to HTML project pages, as described by
+            the PEP 503 simple repository API.
+        """
+        self.files = files
+        self.find_links = find_links
+        self.project_urls = project_urls
+
+
+class LinkCollector(object):
+
+    """
+    Responsible for collecting Link objects from all configured locations,
+    making network requests as needed.
+
+    The class's main method is its collect_links() method.
+    """
+
+    def __init__(
+        self,
+        session,       # type: PipSession
+        search_scope,  # type: SearchScope
+    ):
+        # type: (...) -> None
+        self.search_scope = search_scope
+        self.session = session
+
+    @property
+    def find_links(self):
+        # type: () -> List[str]
+        return self.search_scope.find_links
+
+    def fetch_page(self, location):
+        # type: (Link) -> Optional[HTMLPage]
+        """
+        Fetch an HTML page containing package links.
+        """
+        return _get_html_page(location, session=self.session)
+
+    def collect_links(self, project_name):
+        # type: (str) -> CollectedLinks
+        """Find all available links for the given project name.
+
+        :return: All the Link objects (unfiltered), as a CollectedLinks object.
+        """
+        search_scope = self.search_scope
+        index_locations = search_scope.get_index_urls_locations(project_name)
+        index_file_loc, index_url_loc = group_locations(index_locations)
+        fl_file_loc, fl_url_loc = group_locations(
+            self.find_links, expand_dir=True,
+        )
+
+        file_links = [
+            Link(url) for url in itertools.chain(index_file_loc, fl_file_loc)
+        ]
+
+        # We trust every directly linked archive in find_links
+        find_link_links = [Link(url, '-f') for url in self.find_links]
+
+        # We trust every url that the user has given us whether it was given
+        # via --index-url or --find-links.
+        # We want to filter out anything that does not have a secure origin.
+        url_locations = [
+            link for link in itertools.chain(
+                (Link(url) for url in index_url_loc),
+                (Link(url) for url in fl_url_loc),
+            )
+            if self.session.is_secure_origin(link)
+        ]
+
+        url_locations = _remove_duplicate_links(url_locations)
+        lines = [
+            '{} location(s) to search for versions of {}:'.format(
+                len(url_locations), project_name,
+            ),
+        ]
+        for link in url_locations:
+            lines.append('* {}'.format(link))
+        logger.debug('\n'.join(lines))
+
+        return CollectedLinks(
+            files=file_links,
+            find_links=find_link_links,
+            project_urls=url_locations,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py
new file mode 100644
index 0000000000000000000000000000000000000000..a74d78db5a6c1738d54e784840f97daddff18776
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/index/package_finder.py
@@ -0,0 +1,1013 @@
+"""Routines related to PyPI, indexes"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+import re
+
+from pip._vendor.packaging import specifiers
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.packaging.version import parse as parse_version
+
+from pip._internal.exceptions import (
+    BestVersionAlreadyInstalled,
+    DistributionNotFound,
+    InvalidWheelFilename,
+    UnsupportedWheel,
+)
+from pip._internal.index.collector import parse_links
+from pip._internal.models.candidate import InstallationCandidate
+from pip._internal.models.format_control import FormatControl
+from pip._internal.models.link import Link
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.models.target_python import TargetPython
+from pip._internal.models.wheel import Wheel
+from pip._internal.utils.filetypes import WHEEL_EXTENSION
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import build_netloc
+from pip._internal.utils.packaging import check_requires_python
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS
+from pip._internal.utils.urls import url_to_path
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        FrozenSet, Iterable, List, Optional, Set, Text, Tuple, Union,
+    )
+
+    from pip._vendor.packaging.tags import Tag
+    from pip._vendor.packaging.version import _BaseVersion
+
+    from pip._internal.index.collector import LinkCollector
+    from pip._internal.models.search_scope import SearchScope
+    from pip._internal.req import InstallRequirement
+    from pip._internal.utils.hashes import Hashes
+
+    BuildTag = Union[Tuple[()], Tuple[int, str]]
+    CandidateSortingKey = (
+        Tuple[int, int, int, _BaseVersion, BuildTag, Optional[int]]
+    )
+
+
+__all__ = ['FormatControl', 'BestCandidateResult', 'PackageFinder']
+
+
+logger = logging.getLogger(__name__)
+
+
+def _check_link_requires_python(
+    link,  # type: Link
+    version_info,  # type: Tuple[int, int, int]
+    ignore_requires_python=False,  # type: bool
+):
+    # type: (...) -> bool
+    """
+    Return whether the given Python version is compatible with a link's
+    "Requires-Python" value.
+
+    :param version_info: A 3-tuple of ints representing the Python
+        major-minor-micro version to check.
+    :param ignore_requires_python: Whether to ignore the "Requires-Python"
+        value if the given Python version isn't compatible.
+    """
+    try:
+        is_compatible = check_requires_python(
+            link.requires_python, version_info=version_info,
+        )
+    except specifiers.InvalidSpecifier:
+        logger.debug(
+            "Ignoring invalid Requires-Python (%r) for link: %s",
+            link.requires_python, link,
+        )
+    else:
+        if not is_compatible:
+            version = '.'.join(map(str, version_info))
+            if not ignore_requires_python:
+                logger.debug(
+                    'Link requires a different Python (%s not in: %r): %s',
+                    version, link.requires_python, link,
+                )
+                return False
+
+            logger.debug(
+                'Ignoring failed Requires-Python check (%s not in: %r) '
+                'for link: %s',
+                version, link.requires_python, link,
+            )
+
+    return True
+
+
+class LinkEvaluator(object):
+
+    """
+    Responsible for evaluating links for a particular project.
+    """
+
+    _py_version_re = re.compile(r'-py([123]\.?[0-9]?)$')
+
+    # Don't include an allow_yanked default value to make sure each call
+    # site considers whether yanked releases are allowed. This also causes
+    # that decision to be made explicit in the calling code, which helps
+    # people when reading the code.
+    def __init__(
+        self,
+        project_name,    # type: str
+        canonical_name,  # type: str
+        formats,         # type: FrozenSet[str]
+        target_python,   # type: TargetPython
+        allow_yanked,    # type: bool
+        ignore_requires_python=None,  # type: Optional[bool]
+    ):
+        # type: (...) -> None
+        """
+        :param project_name: The user supplied package name.
+        :param canonical_name: The canonical package name.
+        :param formats: The formats allowed for this package. Should be a set
+            with 'binary' or 'source' or both in it.
+        :param target_python: The target Python interpreter to use when
+            evaluating link compatibility. This is used, for example, to
+            check wheel compatibility, as well as when checking the Python
+            version, e.g. the Python version embedded in a link filename
+            (or egg fragment) and against an HTML link's optional PEP 503
+            "data-requires-python" attribute.
+        :param allow_yanked: Whether files marked as yanked (in the sense
+            of PEP 592) are permitted to be candidates for install.
+        :param ignore_requires_python: Whether to ignore incompatible
+            PEP 503 "data-requires-python" values in HTML links. Defaults
+            to False.
+        """
+        if ignore_requires_python is None:
+            ignore_requires_python = False
+
+        self._allow_yanked = allow_yanked
+        self._canonical_name = canonical_name
+        self._ignore_requires_python = ignore_requires_python
+        self._formats = formats
+        self._target_python = target_python
+
+        self.project_name = project_name
+
+    def evaluate_link(self, link):
+        # type: (Link) -> Tuple[bool, Optional[Text]]
+        """
+        Determine whether a link is a candidate for installation.
+
+        :return: A tuple (is_candidate, result), where `result` is (1) a
+            version string if `is_candidate` is True, and (2) if
+            `is_candidate` is False, an optional string to log the reason
+            the link fails to qualify.
+        """
+        version = None
+        if link.is_yanked and not self._allow_yanked:
+            reason = link.yanked_reason or '<none given>'
+            # Mark this as a unicode string to prevent "UnicodeEncodeError:
+            # 'ascii' codec can't encode character" in Python 2 when
+            # the reason contains non-ascii characters.
+            return (False, u'yanked for reason: {}'.format(reason))
+
+        if link.egg_fragment:
+            egg_info = link.egg_fragment
+            ext = link.ext
+        else:
+            egg_info, ext = link.splitext()
+            if not ext:
+                return (False, 'not a file')
+            if ext not in SUPPORTED_EXTENSIONS:
+                return (False, 'unsupported archive format: %s' % ext)
+            if "binary" not in self._formats and ext == WHEEL_EXTENSION:
+                reason = 'No binaries permitted for %s' % self.project_name
+                return (False, reason)
+            if "macosx10" in link.path and ext == '.zip':
+                return (False, 'macosx10 one')
+            if ext == WHEEL_EXTENSION:
+                try:
+                    wheel = Wheel(link.filename)
+                except InvalidWheelFilename:
+                    return (False, 'invalid wheel filename')
+                if canonicalize_name(wheel.name) != self._canonical_name:
+                    reason = 'wrong project name (not %s)' % self.project_name
+                    return (False, reason)
+
+                supported_tags = self._target_python.get_tags()
+                if not wheel.supported(supported_tags):
+                    # Include the wheel's tags in the reason string to
+                    # simplify troubleshooting compatibility issues.
+                    file_tags = wheel.get_formatted_file_tags()
+                    reason = (
+                        "none of the wheel's tags match: {}".format(
+                            ', '.join(file_tags)
+                        )
+                    )
+                    return (False, reason)
+
+                version = wheel.version
+
+        # This should be up by the self.ok_binary check, but see issue 2700.
+        if "source" not in self._formats and ext != WHEEL_EXTENSION:
+            return (False, 'No sources permitted for %s' % self.project_name)
+
+        if not version:
+            version = _extract_version_from_fragment(
+                egg_info, self._canonical_name,
+            )
+        if not version:
+            return (
+                False, 'Missing project version for %s' % self.project_name,
+            )
+
+        match = self._py_version_re.search(version)
+        if match:
+            version = version[:match.start()]
+            py_version = match.group(1)
+            if py_version != self._target_python.py_version:
+                return (False, 'Python version is incorrect')
+
+        supports_python = _check_link_requires_python(
+            link, version_info=self._target_python.py_version_info,
+            ignore_requires_python=self._ignore_requires_python,
+        )
+        if not supports_python:
+            # Return None for the reason text to suppress calling
+            # _log_skipped_link().
+            return (False, None)
+
+        logger.debug('Found link %s, version: %s', link, version)
+
+        return (True, version)
+
+
+def filter_unallowed_hashes(
+    candidates,    # type: List[InstallationCandidate]
+    hashes,        # type: Hashes
+    project_name,  # type: str
+):
+    # type: (...) -> List[InstallationCandidate]
+    """
+    Filter out candidates whose hashes aren't allowed, and return a new
+    list of candidates.
+
+    If at least one candidate has an allowed hash, then all candidates with
+    either an allowed hash or no hash specified are returned.  Otherwise,
+    the given candidates are returned.
+
+    Including the candidates with no hash specified when there is a match
+    allows a warning to be logged if there is a more preferred candidate
+    with no hash specified.  Returning all candidates in the case of no
+    matches lets pip report the hash of the candidate that would otherwise
+    have been installed (e.g. permitting the user to more easily update
+    their requirements file with the desired hash).
+    """
+    if not hashes:
+        logger.debug(
+            'Given no hashes to check %s links for project %r: '
+            'discarding no candidates',
+            len(candidates),
+            project_name,
+        )
+        # Make sure we're not returning back the given value.
+        return list(candidates)
+
+    matches_or_no_digest = []
+    # Collect the non-matches for logging purposes.
+    non_matches = []
+    match_count = 0
+    for candidate in candidates:
+        link = candidate.link
+        if not link.has_hash:
+            pass
+        elif link.is_hash_allowed(hashes=hashes):
+            match_count += 1
+        else:
+            non_matches.append(candidate)
+            continue
+
+        matches_or_no_digest.append(candidate)
+
+    if match_count:
+        filtered = matches_or_no_digest
+    else:
+        # Make sure we're not returning back the given value.
+        filtered = list(candidates)
+
+    if len(filtered) == len(candidates):
+        discard_message = 'discarding no candidates'
+    else:
+        discard_message = 'discarding {} non-matches:\n  {}'.format(
+            len(non_matches),
+            '\n  '.join(str(candidate.link) for candidate in non_matches)
+        )
+
+    logger.debug(
+        'Checked %s links for project %r against %s hashes '
+        '(%s matches, %s no digest): %s',
+        len(candidates),
+        project_name,
+        hashes.digest_count,
+        match_count,
+        len(matches_or_no_digest) - match_count,
+        discard_message
+    )
+
+    return filtered
+
+
+class CandidatePreferences(object):
+
+    """
+    Encapsulates some of the preferences for filtering and sorting
+    InstallationCandidate objects.
+    """
+
+    def __init__(
+        self,
+        prefer_binary=False,  # type: bool
+        allow_all_prereleases=False,  # type: bool
+    ):
+        # type: (...) -> None
+        """
+        :param allow_all_prereleases: Whether to allow all pre-releases.
+        """
+        self.allow_all_prereleases = allow_all_prereleases
+        self.prefer_binary = prefer_binary
+
+
+class BestCandidateResult(object):
+    """A collection of candidates, returned by `PackageFinder.find_best_candidate`.
+
+    This class is only intended to be instantiated by CandidateEvaluator's
+    `compute_best_candidate()` method.
+    """
+
+    def __init__(
+        self,
+        candidates,             # type: List[InstallationCandidate]
+        applicable_candidates,  # type: List[InstallationCandidate]
+        best_candidate,         # type: Optional[InstallationCandidate]
+    ):
+        # type: (...) -> None
+        """
+        :param candidates: A sequence of all available candidates found.
+        :param applicable_candidates: The applicable candidates.
+        :param best_candidate: The most preferred candidate found, or None
+            if no applicable candidates were found.
+        """
+        assert set(applicable_candidates) <= set(candidates)
+
+        if best_candidate is None:
+            assert not applicable_candidates
+        else:
+            assert best_candidate in applicable_candidates
+
+        self._applicable_candidates = applicable_candidates
+        self._candidates = candidates
+
+        self.best_candidate = best_candidate
+
+    def iter_all(self):
+        # type: () -> Iterable[InstallationCandidate]
+        """Iterate through all candidates.
+        """
+        return iter(self._candidates)
+
+    def iter_applicable(self):
+        # type: () -> Iterable[InstallationCandidate]
+        """Iterate through the applicable candidates.
+        """
+        return iter(self._applicable_candidates)
+
+
+class CandidateEvaluator(object):
+
+    """
+    Responsible for filtering and sorting candidates for installation based
+    on what tags are valid.
+    """
+
+    @classmethod
+    def create(
+        cls,
+        project_name,         # type: str
+        target_python=None,   # type: Optional[TargetPython]
+        prefer_binary=False,  # type: bool
+        allow_all_prereleases=False,  # type: bool
+        specifier=None,       # type: Optional[specifiers.BaseSpecifier]
+        hashes=None,          # type: Optional[Hashes]
+    ):
+        # type: (...) -> CandidateEvaluator
+        """Create a CandidateEvaluator object.
+
+        :param target_python: The target Python interpreter to use when
+            checking compatibility. If None (the default), a TargetPython
+            object will be constructed from the running Python.
+        :param specifier: An optional object implementing `filter`
+            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
+            versions.
+        :param hashes: An optional collection of allowed hashes.
+        """
+        if target_python is None:
+            target_python = TargetPython()
+        if specifier is None:
+            specifier = specifiers.SpecifierSet()
+
+        supported_tags = target_python.get_tags()
+
+        return cls(
+            project_name=project_name,
+            supported_tags=supported_tags,
+            specifier=specifier,
+            prefer_binary=prefer_binary,
+            allow_all_prereleases=allow_all_prereleases,
+            hashes=hashes,
+        )
+
+    def __init__(
+        self,
+        project_name,         # type: str
+        supported_tags,       # type: List[Tag]
+        specifier,            # type: specifiers.BaseSpecifier
+        prefer_binary=False,  # type: bool
+        allow_all_prereleases=False,  # type: bool
+        hashes=None,                  # type: Optional[Hashes]
+    ):
+        # type: (...) -> None
+        """
+        :param supported_tags: The PEP 425 tags supported by the target
+            Python in order of preference (most preferred first).
+        """
+        self._allow_all_prereleases = allow_all_prereleases
+        self._hashes = hashes
+        self._prefer_binary = prefer_binary
+        self._project_name = project_name
+        self._specifier = specifier
+        self._supported_tags = supported_tags
+
+    def get_applicable_candidates(
+        self,
+        candidates,  # type: List[InstallationCandidate]
+    ):
+        # type: (...) -> List[InstallationCandidate]
+        """
+        Return the applicable candidates from a list of candidates.
+        """
+        # Using None infers from the specifier instead.
+        allow_prereleases = self._allow_all_prereleases or None
+        specifier = self._specifier
+        versions = {
+            str(v) for v in specifier.filter(
+                # We turn the version object into a str here because otherwise
+                # when we're debundled but setuptools isn't, Python will see
+                # packaging.version.Version and
+                # pkg_resources._vendor.packaging.version.Version as different
+                # types. This way we'll use a str as a common data interchange
+                # format. If we stop using the pkg_resources provided specifier
+                # and start using our own, we can drop the cast to str().
+                (str(c.version) for c in candidates),
+                prereleases=allow_prereleases,
+            )
+        }
+
+        # Again, converting version to str to deal with debundling.
+        applicable_candidates = [
+            c for c in candidates if str(c.version) in versions
+        ]
+
+        filtered_applicable_candidates = filter_unallowed_hashes(
+            candidates=applicable_candidates,
+            hashes=self._hashes,
+            project_name=self._project_name,
+        )
+
+        return sorted(filtered_applicable_candidates, key=self._sort_key)
+
+    def _sort_key(self, candidate):
+        # type: (InstallationCandidate) -> CandidateSortingKey
+        """
+        Function to pass as the `key` argument to a call to sorted() to sort
+        InstallationCandidates by preference.
+
+        Returns a tuple such that tuples sorting as greater using Python's
+        default comparison operator are more preferred.
+
+        The preference is as follows:
+
+        First and foremost, candidates with allowed (matching) hashes are
+        always preferred over candidates without matching hashes. This is
+        because e.g. if the only candidate with an allowed hash is yanked,
+        we still want to use that candidate.
+
+        Second, excepting hash considerations, candidates that have been
+        yanked (in the sense of PEP 592) are always less preferred than
+        candidates that haven't been yanked. Then:
+
+        If not finding wheels, they are sorted by version only.
+        If finding wheels, then the sort order is by version, then:
+          1. existing installs
+          2. wheels ordered via Wheel.support_index_min(self._supported_tags)
+          3. source archives
+        If prefer_binary was set, then all wheels are sorted above sources.
+
+        Note: it was considered to embed this logic into the Link
+              comparison operators, but then different sdist links
+              with the same version, would have to be considered equal
+        """
+        valid_tags = self._supported_tags
+        support_num = len(valid_tags)
+        build_tag = ()  # type: BuildTag
+        binary_preference = 0
+        link = candidate.link
+        if link.is_wheel:
+            # can raise InvalidWheelFilename
+            wheel = Wheel(link.filename)
+            if not wheel.supported(valid_tags):
+                raise UnsupportedWheel(
+                    "%s is not a supported wheel for this platform. It "
+                    "can't be sorted." % wheel.filename
+                )
+            if self._prefer_binary:
+                binary_preference = 1
+            pri = -(wheel.support_index_min(valid_tags))
+            if wheel.build_tag is not None:
+                match = re.match(r'^(\d+)(.*)$', wheel.build_tag)
+                build_tag_groups = match.groups()
+                build_tag = (int(build_tag_groups[0]), build_tag_groups[1])
+        else:  # sdist
+            pri = -(support_num)
+        has_allowed_hash = int(link.is_hash_allowed(self._hashes))
+        yank_value = -1 * int(link.is_yanked)  # -1 for yanked.
+        return (
+            has_allowed_hash, yank_value, binary_preference, candidate.version,
+            build_tag, pri,
+        )
+
+    def sort_best_candidate(
+        self,
+        candidates,    # type: List[InstallationCandidate]
+    ):
+        # type: (...) -> Optional[InstallationCandidate]
+        """
+        Return the best candidate per the instance's sort order, or None if
+        no candidate is acceptable.
+        """
+        if not candidates:
+            return None
+
+        best_candidate = max(candidates, key=self._sort_key)
+
+        # Log a warning per PEP 592 if necessary before returning.
+        link = best_candidate.link
+        if link.is_yanked:
+            reason = link.yanked_reason or '<none given>'
+            msg = (
+                # Mark this as a unicode string to prevent
+                # "UnicodeEncodeError: 'ascii' codec can't encode character"
+                # in Python 2 when the reason contains non-ascii characters.
+                u'The candidate selected for download or install is a '
+                'yanked version: {candidate}\n'
+                'Reason for being yanked: {reason}'
+            ).format(candidate=best_candidate, reason=reason)
+            logger.warning(msg)
+
+        return best_candidate
+
+    def compute_best_candidate(
+        self,
+        candidates,      # type: List[InstallationCandidate]
+    ):
+        # type: (...) -> BestCandidateResult
+        """
+        Compute and return a `BestCandidateResult` instance.
+        """
+        applicable_candidates = self.get_applicable_candidates(candidates)
+
+        best_candidate = self.sort_best_candidate(applicable_candidates)
+
+        return BestCandidateResult(
+            candidates,
+            applicable_candidates=applicable_candidates,
+            best_candidate=best_candidate,
+        )
+
+
+class PackageFinder(object):
+    """This finds packages.
+
+    This is meant to match easy_install's technique for looking for
+    packages, by reading pages and looking for appropriate links.
+    """
+
+    def __init__(
+        self,
+        link_collector,       # type: LinkCollector
+        target_python,        # type: TargetPython
+        allow_yanked,         # type: bool
+        format_control=None,  # type: Optional[FormatControl]
+        candidate_prefs=None,         # type: CandidatePreferences
+        ignore_requires_python=None,  # type: Optional[bool]
+    ):
+        # type: (...) -> None
+        """
+        This constructor is primarily meant to be used by the create() class
+        method and from tests.
+
+        :param format_control: A FormatControl object, used to control
+            the selection of source packages / binary packages when consulting
+            the index and links.
+        :param candidate_prefs: Options to use when creating a
+            CandidateEvaluator object.
+        """
+        if candidate_prefs is None:
+            candidate_prefs = CandidatePreferences()
+
+        format_control = format_control or FormatControl(set(), set())
+
+        self._allow_yanked = allow_yanked
+        self._candidate_prefs = candidate_prefs
+        self._ignore_requires_python = ignore_requires_python
+        self._link_collector = link_collector
+        self._target_python = target_python
+
+        self.format_control = format_control
+
+        # These are boring links that have already been logged somehow.
+        self._logged_links = set()  # type: Set[Link]
+
+    # Don't include an allow_yanked default value to make sure each call
+    # site considers whether yanked releases are allowed. This also causes
+    # that decision to be made explicit in the calling code, which helps
+    # people when reading the code.
+    @classmethod
+    def create(
+        cls,
+        link_collector,      # type: LinkCollector
+        selection_prefs,     # type: SelectionPreferences
+        target_python=None,  # type: Optional[TargetPython]
+    ):
+        # type: (...) -> PackageFinder
+        """Create a PackageFinder.
+
+        :param selection_prefs: The candidate selection preferences, as a
+            SelectionPreferences object.
+        :param target_python: The target Python interpreter to use when
+            checking compatibility. If None (the default), a TargetPython
+            object will be constructed from the running Python.
+        """
+        if target_python is None:
+            target_python = TargetPython()
+
+        candidate_prefs = CandidatePreferences(
+            prefer_binary=selection_prefs.prefer_binary,
+            allow_all_prereleases=selection_prefs.allow_all_prereleases,
+        )
+
+        return cls(
+            candidate_prefs=candidate_prefs,
+            link_collector=link_collector,
+            target_python=target_python,
+            allow_yanked=selection_prefs.allow_yanked,
+            format_control=selection_prefs.format_control,
+            ignore_requires_python=selection_prefs.ignore_requires_python,
+        )
+
+    @property
+    def search_scope(self):
+        # type: () -> SearchScope
+        return self._link_collector.search_scope
+
+    @search_scope.setter
+    def search_scope(self, search_scope):
+        # type: (SearchScope) -> None
+        self._link_collector.search_scope = search_scope
+
+    @property
+    def find_links(self):
+        # type: () -> List[str]
+        return self._link_collector.find_links
+
+    @property
+    def index_urls(self):
+        # type: () -> List[str]
+        return self.search_scope.index_urls
+
+    @property
+    def trusted_hosts(self):
+        # type: () -> Iterable[str]
+        for host_port in self._link_collector.session.pip_trusted_origins:
+            yield build_netloc(*host_port)
+
+    @property
+    def allow_all_prereleases(self):
+        # type: () -> bool
+        return self._candidate_prefs.allow_all_prereleases
+
+    def set_allow_all_prereleases(self):
+        # type: () -> None
+        self._candidate_prefs.allow_all_prereleases = True
+
+    def make_link_evaluator(self, project_name):
+        # type: (str) -> LinkEvaluator
+        canonical_name = canonicalize_name(project_name)
+        formats = self.format_control.get_allowed_formats(canonical_name)
+
+        return LinkEvaluator(
+            project_name=project_name,
+            canonical_name=canonical_name,
+            formats=formats,
+            target_python=self._target_python,
+            allow_yanked=self._allow_yanked,
+            ignore_requires_python=self._ignore_requires_python,
+        )
+
+    def _sort_links(self, links):
+        # type: (Iterable[Link]) -> List[Link]
+        """
+        Returns elements of links in order, non-egg links first, egg links
+        second, while eliminating duplicates
+        """
+        eggs, no_eggs = [], []
+        seen = set()  # type: Set[Link]
+        for link in links:
+            if link not in seen:
+                seen.add(link)
+                if link.egg_fragment:
+                    eggs.append(link)
+                else:
+                    no_eggs.append(link)
+        return no_eggs + eggs
+
+    def _log_skipped_link(self, link, reason):
+        # type: (Link, Text) -> None
+        if link not in self._logged_links:
+            # Mark this as a unicode string to prevent "UnicodeEncodeError:
+            # 'ascii' codec can't encode character" in Python 2 when
+            # the reason contains non-ascii characters.
+            #   Also, put the link at the end so the reason is more visible
+            # and because the link string is usually very long.
+            logger.debug(u'Skipping link: %s: %s', reason, link)
+            self._logged_links.add(link)
+
+    def get_install_candidate(self, link_evaluator, link):
+        # type: (LinkEvaluator, Link) -> Optional[InstallationCandidate]
+        """
+        If the link is a candidate for install, convert it to an
+        InstallationCandidate and return it. Otherwise, return None.
+        """
+        is_candidate, result = link_evaluator.evaluate_link(link)
+        if not is_candidate:
+            if result:
+                self._log_skipped_link(link, reason=result)
+            return None
+
+        return InstallationCandidate(
+            name=link_evaluator.project_name,
+            link=link,
+            # Convert the Text result to str since InstallationCandidate
+            # accepts str.
+            version=str(result),
+        )
+
+    def evaluate_links(self, link_evaluator, links):
+        # type: (LinkEvaluator, Iterable[Link]) -> List[InstallationCandidate]
+        """
+        Convert links that are candidates to InstallationCandidate objects.
+        """
+        candidates = []
+        for link in self._sort_links(links):
+            candidate = self.get_install_candidate(link_evaluator, link)
+            if candidate is not None:
+                candidates.append(candidate)
+
+        return candidates
+
+    def process_project_url(self, project_url, link_evaluator):
+        # type: (Link, LinkEvaluator) -> List[InstallationCandidate]
+        logger.debug(
+            'Fetching project page and analyzing links: %s', project_url,
+        )
+        html_page = self._link_collector.fetch_page(project_url)
+        if html_page is None:
+            return []
+
+        page_links = list(parse_links(html_page))
+
+        with indent_log():
+            package_links = self.evaluate_links(
+                link_evaluator,
+                links=page_links,
+            )
+
+        return package_links
+
+    def find_all_candidates(self, project_name):
+        # type: (str) -> List[InstallationCandidate]
+        """Find all available InstallationCandidate for project_name
+
+        This checks index_urls and find_links.
+        All versions found are returned as an InstallationCandidate list.
+
+        See LinkEvaluator.evaluate_link() for details on which files
+        are accepted.
+        """
+        collected_links = self._link_collector.collect_links(project_name)
+
+        link_evaluator = self.make_link_evaluator(project_name)
+
+        find_links_versions = self.evaluate_links(
+            link_evaluator,
+            links=collected_links.find_links,
+        )
+
+        page_versions = []
+        for project_url in collected_links.project_urls:
+            package_links = self.process_project_url(
+                project_url, link_evaluator=link_evaluator,
+            )
+            page_versions.extend(package_links)
+
+        file_versions = self.evaluate_links(
+            link_evaluator,
+            links=collected_links.files,
+        )
+        if file_versions:
+            file_versions.sort(reverse=True)
+            logger.debug(
+                'Local files found: %s',
+                ', '.join([
+                    url_to_path(candidate.link.url)
+                    for candidate in file_versions
+                ])
+            )
+
+        # This is an intentional priority ordering
+        return file_versions + find_links_versions + page_versions
+
+    def make_candidate_evaluator(
+        self,
+        project_name,    # type: str
+        specifier=None,  # type: Optional[specifiers.BaseSpecifier]
+        hashes=None,     # type: Optional[Hashes]
+    ):
+        # type: (...) -> CandidateEvaluator
+        """Create a CandidateEvaluator object to use.
+        """
+        candidate_prefs = self._candidate_prefs
+        return CandidateEvaluator.create(
+            project_name=project_name,
+            target_python=self._target_python,
+            prefer_binary=candidate_prefs.prefer_binary,
+            allow_all_prereleases=candidate_prefs.allow_all_prereleases,
+            specifier=specifier,
+            hashes=hashes,
+        )
+
+    def find_best_candidate(
+        self,
+        project_name,       # type: str
+        specifier=None,     # type: Optional[specifiers.BaseSpecifier]
+        hashes=None,        # type: Optional[Hashes]
+    ):
+        # type: (...) -> BestCandidateResult
+        """Find matches for the given project and specifier.
+
+        :param specifier: An optional object implementing `filter`
+            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
+            versions.
+
+        :return: A `BestCandidateResult` instance.
+        """
+        candidates = self.find_all_candidates(project_name)
+        candidate_evaluator = self.make_candidate_evaluator(
+            project_name=project_name,
+            specifier=specifier,
+            hashes=hashes,
+        )
+        return candidate_evaluator.compute_best_candidate(candidates)
+
+    def find_requirement(self, req, upgrade):
+        # type: (InstallRequirement, bool) -> Optional[Link]
+        """Try to find a Link matching req
+
+        Expects req, an InstallRequirement and upgrade, a boolean
+        Returns a Link if found,
+        Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise
+        """
+        hashes = req.hashes(trust_internet=False)
+        best_candidate_result = self.find_best_candidate(
+            req.name, specifier=req.specifier, hashes=hashes,
+        )
+        best_candidate = best_candidate_result.best_candidate
+
+        installed_version = None    # type: Optional[_BaseVersion]
+        if req.satisfied_by is not None:
+            installed_version = parse_version(req.satisfied_by.version)
+
+        def _format_versions(cand_iter):
+            # type: (Iterable[InstallationCandidate]) -> str
+            # This repeated parse_version and str() conversion is needed to
+            # handle different vendoring sources from pip and pkg_resources.
+            # If we stop using the pkg_resources provided specifier and start
+            # using our own, we can drop the cast to str().
+            return ", ".join(sorted(
+                {str(c.version) for c in cand_iter},
+                key=parse_version,
+            )) or "none"
+
+        if installed_version is None and best_candidate is None:
+            logger.critical(
+                'Could not find a version that satisfies the requirement %s '
+                '(from versions: %s)',
+                req,
+                _format_versions(best_candidate_result.iter_all()),
+            )
+
+            raise DistributionNotFound(
+                'No matching distribution found for %s' % req
+            )
+
+        best_installed = False
+        if installed_version and (
+                best_candidate is None or
+                best_candidate.version <= installed_version):
+            best_installed = True
+
+        if not upgrade and installed_version is not None:
+            if best_installed:
+                logger.debug(
+                    'Existing installed version (%s) is most up-to-date and '
+                    'satisfies requirement',
+                    installed_version,
+                )
+            else:
+                logger.debug(
+                    'Existing installed version (%s) satisfies requirement '
+                    '(most up-to-date version is %s)',
+                    installed_version,
+                    best_candidate.version,
+                )
+            return None
+
+        if best_installed:
+            # We have an existing version, and its the best version
+            logger.debug(
+                'Installed version (%s) is most up-to-date (past versions: '
+                '%s)',
+                installed_version,
+                _format_versions(best_candidate_result.iter_applicable()),
+            )
+            raise BestVersionAlreadyInstalled
+
+        logger.debug(
+            'Using version %s (newest of versions: %s)',
+            best_candidate.version,
+            _format_versions(best_candidate_result.iter_applicable()),
+        )
+        return best_candidate.link
+
+
+def _find_name_version_sep(fragment, canonical_name):
+    # type: (str, str) -> int
+    """Find the separator's index based on the package's canonical name.
+
+    :param fragment: A <package>+<version> filename "fragment" (stem) or
+        egg fragment.
+    :param canonical_name: The package's canonical name.
+
+    This function is needed since the canonicalized name does not necessarily
+    have the same length as the egg info's name part. An example::
+
+    >>> fragment = 'foo__bar-1.0'
+    >>> canonical_name = 'foo-bar'
+    >>> _find_name_version_sep(fragment, canonical_name)
+    8
+    """
+    # Project name and version must be separated by one single dash. Find all
+    # occurrences of dashes; if the string in front of it matches the canonical
+    # name, this is the one separating the name and version parts.
+    for i, c in enumerate(fragment):
+        if c != "-":
+            continue
+        if canonicalize_name(fragment[:i]) == canonical_name:
+            return i
+    raise ValueError("{} does not match {}".format(fragment, canonical_name))
+
+
+def _extract_version_from_fragment(fragment, canonical_name):
+    # type: (str, str) -> Optional[str]
+    """Parse the version string from a <package>+<version> filename
+    "fragment" (stem) or egg fragment.
+
+    :param fragment: The string to parse. E.g. foo-2.1
+    :param canonical_name: The canonicalized name of the package this
+        belongs to.
+    """
+    try:
+        version_start = _find_name_version_sep(fragment, canonical_name) + 1
+    except ValueError:
+        return None
+    version = fragment[version_start:]
+    if not version:
+        return None
+    return version
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py
new file mode 100644
index 0000000000000000000000000000000000000000..ca269121b60c1b792fbc1a08000c4f2e4503e706
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py
@@ -0,0 +1,430 @@
+"""Dependency Resolution
+
+The dependency resolution in pip is performed as follows:
+
+for top-level requirements:
+    a. only one spec allowed per project, regardless of conflicts or not.
+       otherwise a "double requirement" exception is raised
+    b. they override sub-dependency requirements.
+for sub-dependencies
+    a. "first found, wins" (where the order is breadth first)
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+import logging
+import sys
+from collections import defaultdict
+from itertools import chain
+
+from pip._vendor.packaging import specifiers
+
+from pip._internal.exceptions import (
+    BestVersionAlreadyInstalled,
+    DistributionNotFound,
+    HashError,
+    HashErrors,
+    UnsupportedPythonVersion,
+)
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import dist_in_usersite, normalize_version_info
+from pip._internal.utils.packaging import (
+    check_requires_python,
+    get_requires_python,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Callable, DefaultDict, List, Optional, Set, Tuple
+    from pip._vendor import pkg_resources
+
+    from pip._internal.distributions import AbstractDistribution
+    from pip._internal.index.package_finder import PackageFinder
+    from pip._internal.operations.prepare import RequirementPreparer
+    from pip._internal.req.req_install import InstallRequirement
+    from pip._internal.req.req_set import RequirementSet
+
+    InstallRequirementProvider = Callable[
+        [str, InstallRequirement], InstallRequirement
+    ]
+    DiscoveredDependencies = DefaultDict[str, List[InstallRequirement]]
+
+logger = logging.getLogger(__name__)
+
+
+def _check_dist_requires_python(
+    dist,  # type: pkg_resources.Distribution
+    version_info,  # type: Tuple[int, int, int]
+    ignore_requires_python=False,  # type: bool
+):
+    # type: (...) -> None
+    """
+    Check whether the given Python version is compatible with a distribution's
+    "Requires-Python" value.
+
+    :param version_info: A 3-tuple of ints representing the Python
+        major-minor-micro version to check.
+    :param ignore_requires_python: Whether to ignore the "Requires-Python"
+        value if the given Python version isn't compatible.
+
+    :raises UnsupportedPythonVersion: When the given Python version isn't
+        compatible.
+    """
+    requires_python = get_requires_python(dist)
+    try:
+        is_compatible = check_requires_python(
+            requires_python, version_info=version_info,
+        )
+    except specifiers.InvalidSpecifier as exc:
+        logger.warning(
+            "Package %r has an invalid Requires-Python: %s",
+            dist.project_name, exc,
+        )
+        return
+
+    if is_compatible:
+        return
+
+    version = '.'.join(map(str, version_info))
+    if ignore_requires_python:
+        logger.debug(
+            'Ignoring failed Requires-Python check for package %r: '
+            '%s not in %r',
+            dist.project_name, version, requires_python,
+        )
+        return
+
+    raise UnsupportedPythonVersion(
+        'Package {!r} requires a different Python: {} not in {!r}'.format(
+            dist.project_name, version, requires_python,
+        ))
+
+
+class Resolver(object):
+    """Resolves which packages need to be installed/uninstalled to perform \
+    the requested operation without breaking the requirements of any package.
+    """
+
+    _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"}
+
+    def __init__(
+        self,
+        preparer,  # type: RequirementPreparer
+        finder,  # type: PackageFinder
+        make_install_req,  # type: InstallRequirementProvider
+        use_user_site,  # type: bool
+        ignore_dependencies,  # type: bool
+        ignore_installed,  # type: bool
+        ignore_requires_python,  # type: bool
+        force_reinstall,  # type: bool
+        upgrade_strategy,  # type: str
+        py_version_info=None,  # type: Optional[Tuple[int, ...]]
+    ):
+        # type: (...) -> None
+        super(Resolver, self).__init__()
+        assert upgrade_strategy in self._allowed_strategies
+
+        if py_version_info is None:
+            py_version_info = sys.version_info[:3]
+        else:
+            py_version_info = normalize_version_info(py_version_info)
+
+        self._py_version_info = py_version_info
+
+        self.preparer = preparer
+        self.finder = finder
+
+        self.upgrade_strategy = upgrade_strategy
+        self.force_reinstall = force_reinstall
+        self.ignore_dependencies = ignore_dependencies
+        self.ignore_installed = ignore_installed
+        self.ignore_requires_python = ignore_requires_python
+        self.use_user_site = use_user_site
+        self._make_install_req = make_install_req
+
+        self._discovered_dependencies = \
+            defaultdict(list)  # type: DiscoveredDependencies
+
+    def resolve(self, requirement_set):
+        # type: (RequirementSet) -> None
+        """Resolve what operations need to be done
+
+        As a side-effect of this method, the packages (and their dependencies)
+        are downloaded, unpacked and prepared for installation. This
+        preparation is done by ``pip.operations.prepare``.
+
+        Once PyPI has static dependency metadata available, it would be
+        possible to move the preparation to become a step separated from
+        dependency resolution.
+        """
+        # If any top-level requirement has a hash specified, enter
+        # hash-checking mode, which requires hashes from all.
+        root_reqs = (
+            requirement_set.unnamed_requirements +
+            list(requirement_set.requirements.values())
+        )
+
+        # Actually prepare the files, and collect any exceptions. Most hash
+        # exceptions cannot be checked ahead of time, because
+        # req.populate_link() needs to be called before we can make decisions
+        # based on link type.
+        discovered_reqs = []  # type: List[InstallRequirement]
+        hash_errors = HashErrors()
+        for req in chain(root_reqs, discovered_reqs):
+            try:
+                discovered_reqs.extend(self._resolve_one(requirement_set, req))
+            except HashError as exc:
+                exc.req = req
+                hash_errors.append(exc)
+
+        if hash_errors:
+            raise hash_errors
+
+    def _is_upgrade_allowed(self, req):
+        # type: (InstallRequirement) -> bool
+        if self.upgrade_strategy == "to-satisfy-only":
+            return False
+        elif self.upgrade_strategy == "eager":
+            return True
+        else:
+            assert self.upgrade_strategy == "only-if-needed"
+            return req.is_direct
+
+    def _set_req_to_reinstall(self, req):
+        # type: (InstallRequirement) -> None
+        """
+        Set a requirement to be installed.
+        """
+        # Don't uninstall the conflict if doing a user install and the
+        # conflict is not a user install.
+        if not self.use_user_site or dist_in_usersite(req.satisfied_by):
+            req.should_reinstall = True
+        req.satisfied_by = None
+
+    def _check_skip_installed(self, req_to_install):
+        # type: (InstallRequirement) -> Optional[str]
+        """Check if req_to_install should be skipped.
+
+        This will check if the req is installed, and whether we should upgrade
+        or reinstall it, taking into account all the relevant user options.
+
+        After calling this req_to_install will only have satisfied_by set to
+        None if the req_to_install is to be upgraded/reinstalled etc. Any
+        other value will be a dist recording the current thing installed that
+        satisfies the requirement.
+
+        Note that for vcs urls and the like we can't assess skipping in this
+        routine - we simply identify that we need to pull the thing down,
+        then later on it is pulled down and introspected to assess upgrade/
+        reinstalls etc.
+
+        :return: A text reason for why it was skipped, or None.
+        """
+        if self.ignore_installed:
+            return None
+
+        req_to_install.check_if_exists(self.use_user_site)
+        if not req_to_install.satisfied_by:
+            return None
+
+        if self.force_reinstall:
+            self._set_req_to_reinstall(req_to_install)
+            return None
+
+        if not self._is_upgrade_allowed(req_to_install):
+            if self.upgrade_strategy == "only-if-needed":
+                return 'already satisfied, skipping upgrade'
+            return 'already satisfied'
+
+        # Check for the possibility of an upgrade.  For link-based
+        # requirements we have to pull the tree down and inspect to assess
+        # the version #, so it's handled way down.
+        if not req_to_install.link:
+            try:
+                self.finder.find_requirement(req_to_install, upgrade=True)
+            except BestVersionAlreadyInstalled:
+                # Then the best version is installed.
+                return 'already up-to-date'
+            except DistributionNotFound:
+                # No distribution found, so we squash the error.  It will
+                # be raised later when we re-try later to do the install.
+                # Why don't we just raise here?
+                pass
+
+        self._set_req_to_reinstall(req_to_install)
+        return None
+
+    def _get_abstract_dist_for(self, req):
+        # type: (InstallRequirement) -> AbstractDistribution
+        """Takes a InstallRequirement and returns a single AbstractDist \
+        representing a prepared variant of the same.
+        """
+        if req.editable:
+            return self.preparer.prepare_editable_requirement(req)
+
+        # satisfied_by is only evaluated by calling _check_skip_installed,
+        # so it must be None here.
+        assert req.satisfied_by is None
+        skip_reason = self._check_skip_installed(req)
+
+        if req.satisfied_by:
+            return self.preparer.prepare_installed_requirement(
+                req, skip_reason
+            )
+
+        upgrade_allowed = self._is_upgrade_allowed(req)
+
+        # We eagerly populate the link, since that's our "legacy" behavior.
+        require_hashes = self.preparer.require_hashes
+        req.populate_link(self.finder, upgrade_allowed, require_hashes)
+        abstract_dist = self.preparer.prepare_linked_requirement(req)
+
+        # NOTE
+        # The following portion is for determining if a certain package is
+        # going to be re-installed/upgraded or not and reporting to the user.
+        # This should probably get cleaned up in a future refactor.
+
+        # req.req is only avail after unpack for URL
+        # pkgs repeat check_if_exists to uninstall-on-upgrade
+        # (#14)
+        if not self.ignore_installed:
+            req.check_if_exists(self.use_user_site)
+
+        if req.satisfied_by:
+            should_modify = (
+                self.upgrade_strategy != "to-satisfy-only" or
+                self.force_reinstall or
+                self.ignore_installed or
+                req.link.scheme == 'file'
+            )
+            if should_modify:
+                self._set_req_to_reinstall(req)
+            else:
+                logger.info(
+                    'Requirement already satisfied (use --upgrade to upgrade):'
+                    ' %s', req,
+                )
+
+        return abstract_dist
+
+    def _resolve_one(
+        self,
+        requirement_set,  # type: RequirementSet
+        req_to_install,  # type: InstallRequirement
+    ):
+        # type: (...) -> List[InstallRequirement]
+        """Prepare a single requirements file.
+
+        :return: A list of additional InstallRequirements to also install.
+        """
+        # Tell user what we are doing for this requirement:
+        # obtain (editable), skipping, processing (local url), collecting
+        # (remote url or package name)
+        if req_to_install.constraint or req_to_install.prepared:
+            return []
+
+        req_to_install.prepared = True
+
+        # register tmp src for cleanup in case something goes wrong
+        requirement_set.reqs_to_cleanup.append(req_to_install)
+
+        abstract_dist = self._get_abstract_dist_for(req_to_install)
+
+        # Parse and return dependencies
+        dist = abstract_dist.get_pkg_resources_distribution()
+        # This will raise UnsupportedPythonVersion if the given Python
+        # version isn't compatible with the distribution's Requires-Python.
+        _check_dist_requires_python(
+            dist, version_info=self._py_version_info,
+            ignore_requires_python=self.ignore_requires_python,
+        )
+
+        more_reqs = []  # type: List[InstallRequirement]
+
+        def add_req(subreq, extras_requested):
+            sub_install_req = self._make_install_req(
+                str(subreq),
+                req_to_install,
+            )
+            parent_req_name = req_to_install.name
+            to_scan_again, add_to_parent = requirement_set.add_requirement(
+                sub_install_req,
+                parent_req_name=parent_req_name,
+                extras_requested=extras_requested,
+            )
+            if parent_req_name and add_to_parent:
+                self._discovered_dependencies[parent_req_name].append(
+                    add_to_parent
+                )
+            more_reqs.extend(to_scan_again)
+
+        with indent_log():
+            # We add req_to_install before its dependencies, so that we
+            # can refer to it when adding dependencies.
+            if not requirement_set.has_requirement(req_to_install.name):
+                # 'unnamed' requirements will get added here
+                # 'unnamed' requirements can only come from being directly
+                # provided by the user.
+                assert req_to_install.is_direct
+                requirement_set.add_requirement(
+                    req_to_install, parent_req_name=None,
+                )
+
+            if not self.ignore_dependencies:
+                if req_to_install.extras:
+                    logger.debug(
+                        "Installing extra requirements: %r",
+                        ','.join(req_to_install.extras),
+                    )
+                missing_requested = sorted(
+                    set(req_to_install.extras) - set(dist.extras)
+                )
+                for missing in missing_requested:
+                    logger.warning(
+                        '%s does not provide the extra \'%s\'',
+                        dist, missing
+                    )
+
+                available_requested = sorted(
+                    set(dist.extras) & set(req_to_install.extras)
+                )
+                for subreq in dist.requires(available_requested):
+                    add_req(subreq, extras_requested=available_requested)
+
+            if not req_to_install.editable and not req_to_install.satisfied_by:
+                # XXX: --no-install leads this to report 'Successfully
+                # downloaded' for only non-editable reqs, even though we took
+                # action on them.
+                requirement_set.successfully_downloaded.append(req_to_install)
+
+        return more_reqs
+
+    def get_installation_order(self, req_set):
+        # type: (RequirementSet) -> List[InstallRequirement]
+        """Create the installation order.
+
+        The installation order is topological - requirements are installed
+        before the requiring thing. We break cycles at an arbitrary point,
+        and make no other guarantees.
+        """
+        # The current implementation, which we may change at any point
+        # installs the user specified things in the order given, except when
+        # dependencies must come earlier to achieve topological order.
+        order = []
+        ordered_reqs = set()  # type: Set[InstallRequirement]
+
+        def schedule(req):
+            if req.satisfied_by or req in ordered_reqs:
+                return
+            if req.constraint:
+                return
+            ordered_reqs.add(req)
+            for dep in self._discovered_dependencies[req.name]:
+                schedule(dep)
+            order.append(req)
+
+        for install_req in req_set.requirements.values():
+            schedule(install_req)
+        return order
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/locations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/locations.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c115531911af77f5eab69775c7cdd8e43b47e1d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/locations.py
@@ -0,0 +1,194 @@
+"""Locations where we look for configs, install stuff, etc"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import os
+import os.path
+import platform
+import site
+import sys
+import sysconfig
+from distutils import sysconfig as distutils_sysconfig
+from distutils.command.install import SCHEME_KEYS  # type: ignore
+from distutils.command.install import install as distutils_install_command
+
+from pip._internal.models.scheme import Scheme
+from pip._internal.utils import appdirs
+from pip._internal.utils.compat import WINDOWS
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast
+from pip._internal.utils.virtualenv import running_under_virtualenv
+
+if MYPY_CHECK_RUNNING:
+    from typing import Dict, List, Optional, Union
+
+    from distutils.cmd import Command as DistutilsCommand
+
+
+# Application Directories
+USER_CACHE_DIR = appdirs.user_cache_dir("pip")
+
+
+def get_major_minor_version():
+    # type: () -> str
+    """
+    Return the major-minor version of the current Python as a string, e.g.
+    "3.7" or "3.10".
+    """
+    return '{}.{}'.format(*sys.version_info)
+
+
+def get_src_prefix():
+    # type: () -> str
+    if running_under_virtualenv():
+        src_prefix = os.path.join(sys.prefix, 'src')
+    else:
+        # FIXME: keep src in cwd for now (it is not a temporary folder)
+        try:
+            src_prefix = os.path.join(os.getcwd(), 'src')
+        except OSError:
+            # In case the current working directory has been renamed or deleted
+            sys.exit(
+                "The folder you are executing pip from can no longer be found."
+            )
+
+    # under macOS + virtualenv sys.prefix is not properly resolved
+    # it is something like /path/to/python/bin/..
+    return os.path.abspath(src_prefix)
+
+
+# FIXME doesn't account for venv linked to global site-packages
+
+site_packages = sysconfig.get_path("purelib")  # type: Optional[str]
+
+# This is because of a bug in PyPy's sysconfig module, see
+# https://bitbucket.org/pypy/pypy/issues/2506/sysconfig-returns-incorrect-paths
+# for more information.
+if platform.python_implementation().lower() == "pypy":
+    site_packages = distutils_sysconfig.get_python_lib()
+try:
+    # Use getusersitepackages if this is present, as it ensures that the
+    # value is initialised properly.
+    user_site = site.getusersitepackages()
+except AttributeError:
+    user_site = site.USER_SITE
+
+if WINDOWS:
+    bin_py = os.path.join(sys.prefix, 'Scripts')
+    bin_user = os.path.join(user_site, 'Scripts')
+    # buildout uses 'bin' on Windows too?
+    if not os.path.exists(bin_py):
+        bin_py = os.path.join(sys.prefix, 'bin')
+        bin_user = os.path.join(user_site, 'bin')
+else:
+    bin_py = os.path.join(sys.prefix, 'bin')
+    bin_user = os.path.join(user_site, 'bin')
+
+    # Forcing to use /usr/local/bin for standard macOS framework installs
+    # Also log to ~/Library/Logs/ for use with the Console.app log viewer
+    if sys.platform[:6] == 'darwin' and sys.prefix[:16] == '/System/Library/':
+        bin_py = '/usr/local/bin'
+
+
+def distutils_scheme(
+    dist_name, user=False, home=None, root=None, isolated=False, prefix=None
+):
+    # type:(str, bool, str, str, bool, str) -> Dict[str, str]
+    """
+    Return a distutils install scheme
+    """
+    from distutils.dist import Distribution
+
+    dist_args = {'name': dist_name}  # type: Dict[str, Union[str, List[str]]]
+    if isolated:
+        dist_args["script_args"] = ["--no-user-cfg"]
+
+    d = Distribution(dist_args)
+    d.parse_config_files()
+    obj = None  # type: Optional[DistutilsCommand]
+    obj = d.get_command_obj('install', create=True)
+    assert obj is not None
+    i = cast(distutils_install_command, obj)
+    # NOTE: setting user or home has the side-effect of creating the home dir
+    # or user base for installations during finalize_options()
+    # ideally, we'd prefer a scheme class that has no side-effects.
+    assert not (user and prefix), "user={} prefix={}".format(user, prefix)
+    assert not (home and prefix), "home={} prefix={}".format(home, prefix)
+    i.user = user or i.user
+    if user or home:
+        i.prefix = ""
+    i.prefix = prefix or i.prefix
+    i.home = home or i.home
+    i.root = root or i.root
+    i.finalize_options()
+
+    scheme = {}
+    for key in SCHEME_KEYS:
+        scheme[key] = getattr(i, 'install_' + key)
+
+    # install_lib specified in setup.cfg should install *everything*
+    # into there (i.e. it takes precedence over both purelib and
+    # platlib).  Note, i.install_lib is *always* set after
+    # finalize_options(); we only want to override here if the user
+    # has explicitly requested it hence going back to the config
+    if 'install_lib' in d.get_option_dict('install'):
+        scheme.update(dict(purelib=i.install_lib, platlib=i.install_lib))
+
+    if running_under_virtualenv():
+        scheme['headers'] = os.path.join(
+            sys.prefix,
+            'include',
+            'site',
+            'python{}'.format(get_major_minor_version()),
+            dist_name,
+        )
+
+        if root is not None:
+            path_no_drive = os.path.splitdrive(
+                os.path.abspath(scheme["headers"]))[1]
+            scheme["headers"] = os.path.join(
+                root,
+                path_no_drive[1:],
+            )
+
+    return scheme
+
+
+def get_scheme(
+    dist_name,  # type: str
+    user=False,  # type: bool
+    home=None,  # type: Optional[str]
+    root=None,  # type: Optional[str]
+    isolated=False,  # type: bool
+    prefix=None,  # type: Optional[str]
+):
+    # type: (...) -> Scheme
+    """
+    Get the "scheme" corresponding to the input parameters. The distutils
+    documentation provides the context for the available schemes:
+    https://docs.python.org/3/install/index.html#alternate-installation
+
+    :param dist_name: the name of the package to retrieve the scheme for, used
+        in the headers scheme path
+    :param user: indicates to use the "user" scheme
+    :param home: indicates to use the "home" scheme and provides the base
+        directory for the same
+    :param root: root under which other directories are re-based
+    :param isolated: equivalent to --no-user-cfg, i.e. do not consider
+        ~/.pydistutils.cfg (posix) or ~/pydistutils.cfg (non-posix) for
+        scheme paths
+    :param prefix: indicates to use the "prefix" scheme and provides the
+        base directory for the same
+    """
+    scheme = distutils_scheme(
+        dist_name, user, home, root, isolated, prefix
+    )
+    return Scheme(
+        platlib=scheme["platlib"],
+        purelib=scheme["purelib"],
+        headers=scheme["headers"],
+        scripts=scheme["scripts"],
+        data=scheme["data"],
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/main.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..3208d5b8820eadf8a1ebe4851c984c6033c289bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/main.py
@@ -0,0 +1,16 @@
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, List
+
+
+def main(args=None):
+    # type: (Optional[List[str]]) -> int
+    """This is preserved for old console scripts that may still be referencing
+    it.
+
+    For additional details, see https://github.com/pypa/pip/issues/7498.
+    """
+    from pip._internal.utils.entrypoints import _wrapper
+
+    return _wrapper(args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7855226e4b500142deef8fb247cd33a9a991d122
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/__init__.py
@@ -0,0 +1,2 @@
+"""A package that contains models that represent entities.
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py
new file mode 100644
index 0000000000000000000000000000000000000000..1dc1a576eea788c23f5722bbb8e10ae950ef38bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/candidate.py
@@ -0,0 +1,36 @@
+from pip._vendor.packaging.version import parse as parse_version
+
+from pip._internal.utils.models import KeyBasedCompareMixin
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from pip._vendor.packaging.version import _BaseVersion
+    from pip._internal.models.link import Link
+
+
+class InstallationCandidate(KeyBasedCompareMixin):
+    """Represents a potential "candidate" for installation.
+    """
+
+    def __init__(self, name, version, link):
+        # type: (str, str, Link) -> None
+        self.name = name
+        self.version = parse_version(version)  # type: _BaseVersion
+        self.link = link
+
+        super(InstallationCandidate, self).__init__(
+            key=(self.name, self.version, self.link),
+            defining_class=InstallationCandidate
+        )
+
+    def __repr__(self):
+        # type: () -> str
+        return "<InstallationCandidate({!r}, {!r}, {!r})>".format(
+            self.name, self.version, self.link,
+        )
+
+    def __str__(self):
+        # type: () -> str
+        return '{!r} candidate (version {} at {})'.format(
+            self.name, self.version, self.link,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e13727ca006977f3fb2df30fd1a25bb1670cf3e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/format_control.py
@@ -0,0 +1,84 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal.exceptions import CommandError
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Set, FrozenSet
+
+
+class FormatControl(object):
+    """Helper for managing formats from which a package can be installed.
+    """
+
+    def __init__(self, no_binary=None, only_binary=None):
+        # type: (Optional[Set[str]], Optional[Set[str]]) -> None
+        if no_binary is None:
+            no_binary = set()
+        if only_binary is None:
+            only_binary = set()
+
+        self.no_binary = no_binary
+        self.only_binary = only_binary
+
+    def __eq__(self, other):
+        # type: (object) -> bool
+        return self.__dict__ == other.__dict__
+
+    def __ne__(self, other):
+        # type: (object) -> bool
+        return not self.__eq__(other)
+
+    def __repr__(self):
+        # type: () -> str
+        return "{}({}, {})".format(
+            self.__class__.__name__,
+            self.no_binary,
+            self.only_binary
+        )
+
+    @staticmethod
+    def handle_mutual_excludes(value, target, other):
+        # type: (str, Optional[Set[str]], Optional[Set[str]]) -> None
+        if value.startswith('-'):
+            raise CommandError(
+                "--no-binary / --only-binary option requires 1 argument."
+            )
+        new = value.split(',')
+        while ':all:' in new:
+            other.clear()
+            target.clear()
+            target.add(':all:')
+            del new[:new.index(':all:') + 1]
+            # Without a none, we want to discard everything as :all: covers it
+            if ':none:' not in new:
+                return
+        for name in new:
+            if name == ':none:':
+                target.clear()
+                continue
+            name = canonicalize_name(name)
+            other.discard(name)
+            target.add(name)
+
+    def get_allowed_formats(self, canonical_name):
+        # type: (str) -> FrozenSet[str]
+        result = {"binary", "source"}
+        if canonical_name in self.only_binary:
+            result.discard('source')
+        elif canonical_name in self.no_binary:
+            result.discard('binary')
+        elif ':all:' in self.only_binary:
+            result.discard('source')
+        elif ':all:' in self.no_binary:
+            result.discard('binary')
+        return frozenset(result)
+
+    def disallow_binaries(self):
+        # type: () -> None
+        self.handle_mutual_excludes(
+            ':all:', self.no_binary, self.only_binary,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/index.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/index.py
new file mode 100644
index 0000000000000000000000000000000000000000..ead1efbda761ebed373700ce9e69797838c2b9d9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/index.py
@@ -0,0 +1,31 @@
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+
+class PackageIndex(object):
+    """Represents a Package Index and provides easier access to endpoints
+    """
+
+    def __init__(self, url, file_storage_domain):
+        # type: (str, str) -> None
+        super(PackageIndex, self).__init__()
+        self.url = url
+        self.netloc = urllib_parse.urlsplit(url).netloc
+        self.simple_url = self._url_for_path('simple')
+        self.pypi_url = self._url_for_path('pypi')
+
+        # This is part of a temporary hack used to block installs of PyPI
+        # packages which depend on external urls only necessary until PyPI can
+        # block such packages themselves
+        self.file_storage_domain = file_storage_domain
+
+    def _url_for_path(self, path):
+        # type: (str) -> str
+        return urllib_parse.urljoin(self.url, path)
+
+
+PyPI = PackageIndex(
+    'https://pypi.org/', file_storage_domain='files.pythonhosted.org'
+)
+TestPyPI = PackageIndex(
+    'https://test.pypi.org/', file_storage_domain='test-files.pythonhosted.org'
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/link.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/link.py
new file mode 100644
index 0000000000000000000000000000000000000000..34fbcbfe7e4dcc6873288db8455890ce77405405
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/link.py
@@ -0,0 +1,227 @@
+import os
+import posixpath
+import re
+
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.utils.filetypes import WHEEL_EXTENSION
+from pip._internal.utils.misc import (
+    redact_auth_from_url,
+    split_auth_from_netloc,
+    splitext,
+)
+from pip._internal.utils.models import KeyBasedCompareMixin
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url, url_to_path
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Text, Tuple, Union
+    from pip._internal.index.collector import HTMLPage
+    from pip._internal.utils.hashes import Hashes
+
+
+class Link(KeyBasedCompareMixin):
+    """Represents a parsed link from a Package Index's simple URL
+    """
+
+    def __init__(
+        self,
+        url,                   # type: str
+        comes_from=None,       # type: Optional[Union[str, HTMLPage]]
+        requires_python=None,  # type: Optional[str]
+        yanked_reason=None,    # type: Optional[Text]
+    ):
+        # type: (...) -> None
+        """
+        :param url: url of the resource pointed to (href of the link)
+        :param comes_from: instance of HTMLPage where the link was found,
+            or string.
+        :param requires_python: String containing the `Requires-Python`
+            metadata field, specified in PEP 345. This may be specified by
+            a data-requires-python attribute in the HTML link tag, as
+            described in PEP 503.
+        :param yanked_reason: the reason the file has been yanked, if the
+            file has been yanked, or None if the file hasn't been yanked.
+            This is the value of the "data-yanked" attribute, if present, in
+            a simple repository HTML link. If the file has been yanked but
+            no reason was provided, this should be the empty string. See
+            PEP 592 for more information and the specification.
+        """
+
+        # url can be a UNC windows share
+        if url.startswith('\\\\'):
+            url = path_to_url(url)
+
+        self._parsed_url = urllib_parse.urlsplit(url)
+        # Store the url as a private attribute to prevent accidentally
+        # trying to set a new value.
+        self._url = url
+
+        self.comes_from = comes_from
+        self.requires_python = requires_python if requires_python else None
+        self.yanked_reason = yanked_reason
+
+        super(Link, self).__init__(key=url, defining_class=Link)
+
+    def __str__(self):
+        # type: () -> str
+        if self.requires_python:
+            rp = ' (requires-python:%s)' % self.requires_python
+        else:
+            rp = ''
+        if self.comes_from:
+            return '%s (from %s)%s' % (redact_auth_from_url(self._url),
+                                       self.comes_from, rp)
+        else:
+            return redact_auth_from_url(str(self._url))
+
+    def __repr__(self):
+        # type: () -> str
+        return '<Link %s>' % self
+
+    @property
+    def url(self):
+        # type: () -> str
+        return self._url
+
+    @property
+    def filename(self):
+        # type: () -> str
+        path = self.path.rstrip('/')
+        name = posixpath.basename(path)
+        if not name:
+            # Make sure we don't leak auth information if the netloc
+            # includes a username and password.
+            netloc, user_pass = split_auth_from_netloc(self.netloc)
+            return netloc
+
+        name = urllib_parse.unquote(name)
+        assert name, ('URL %r produced no filename' % self._url)
+        return name
+
+    @property
+    def file_path(self):
+        # type: () -> str
+        return url_to_path(self.url)
+
+    @property
+    def scheme(self):
+        # type: () -> str
+        return self._parsed_url.scheme
+
+    @property
+    def netloc(self):
+        # type: () -> str
+        """
+        This can contain auth information.
+        """
+        return self._parsed_url.netloc
+
+    @property
+    def path(self):
+        # type: () -> str
+        return urllib_parse.unquote(self._parsed_url.path)
+
+    def splitext(self):
+        # type: () -> Tuple[str, str]
+        return splitext(posixpath.basename(self.path.rstrip('/')))
+
+    @property
+    def ext(self):
+        # type: () -> str
+        return self.splitext()[1]
+
+    @property
+    def url_without_fragment(self):
+        # type: () -> str
+        scheme, netloc, path, query, fragment = self._parsed_url
+        return urllib_parse.urlunsplit((scheme, netloc, path, query, None))
+
+    _egg_fragment_re = re.compile(r'[#&]egg=([^&]*)')
+
+    @property
+    def egg_fragment(self):
+        # type: () -> Optional[str]
+        match = self._egg_fragment_re.search(self._url)
+        if not match:
+            return None
+        return match.group(1)
+
+    _subdirectory_fragment_re = re.compile(r'[#&]subdirectory=([^&]*)')
+
+    @property
+    def subdirectory_fragment(self):
+        # type: () -> Optional[str]
+        match = self._subdirectory_fragment_re.search(self._url)
+        if not match:
+            return None
+        return match.group(1)
+
+    _hash_re = re.compile(
+        r'(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)'
+    )
+
+    @property
+    def hash(self):
+        # type: () -> Optional[str]
+        match = self._hash_re.search(self._url)
+        if match:
+            return match.group(2)
+        return None
+
+    @property
+    def hash_name(self):
+        # type: () -> Optional[str]
+        match = self._hash_re.search(self._url)
+        if match:
+            return match.group(1)
+        return None
+
+    @property
+    def show_url(self):
+        # type: () -> str
+        return posixpath.basename(self._url.split('#', 1)[0].split('?', 1)[0])
+
+    @property
+    def is_file(self):
+        # type: () -> bool
+        return self.scheme == 'file'
+
+    def is_existing_dir(self):
+        # type: () -> bool
+        return self.is_file and os.path.isdir(self.file_path)
+
+    @property
+    def is_wheel(self):
+        # type: () -> bool
+        return self.ext == WHEEL_EXTENSION
+
+    @property
+    def is_vcs(self):
+        # type: () -> bool
+        from pip._internal.vcs import vcs
+
+        return self.scheme in vcs.all_schemes
+
+    @property
+    def is_yanked(self):
+        # type: () -> bool
+        return self.yanked_reason is not None
+
+    @property
+    def has_hash(self):
+        # type: () -> bool
+        return self.hash_name is not None
+
+    def is_hash_allowed(self, hashes):
+        # type: (Optional[Hashes]) -> bool
+        """
+        Return True if the link has a hash and it is allowed.
+        """
+        if hashes is None or not self.has_hash:
+            return False
+        # Assert non-None so mypy knows self.hash_name and self.hash are str.
+        assert self.hash_name is not None
+        assert self.hash is not None
+
+        return hashes.is_hash_allowed(self.hash_name, hex_digest=self.hash)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py
new file mode 100644
index 0000000000000000000000000000000000000000..af07b4078f997b5c6005c042ac178282c49fd5e7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/scheme.py
@@ -0,0 +1,25 @@
+"""
+For types associated with installation schemes.
+
+For a general overview of available schemes and their context, see
+https://docs.python.org/3/install/index.html#alternate-installation.
+"""
+
+
+class Scheme(object):
+    """A Scheme holds paths which are used as the base directories for
+    artifacts associated with a Python package.
+    """
+    def __init__(
+        self,
+        platlib,  # type: str
+        purelib,  # type: str
+        headers,  # type: str
+        scripts,  # type: str
+        data,  # type: str
+    ):
+        self.platlib = platlib
+        self.purelib = purelib
+        self.headers = headers
+        self.scripts = scripts
+        self.data = data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py
new file mode 100644
index 0000000000000000000000000000000000000000..138d1b6eedf8d5b58f25c821ac393408d1e73067
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/search_scope.py
@@ -0,0 +1,114 @@
+import itertools
+import logging
+import os
+import posixpath
+
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.models.index import PyPI
+from pip._internal.utils.compat import has_tls
+from pip._internal.utils.misc import normalize_path, redact_auth_from_url
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List
+
+
+logger = logging.getLogger(__name__)
+
+
+class SearchScope(object):
+
+    """
+    Encapsulates the locations that pip is configured to search.
+    """
+
+    @classmethod
+    def create(
+        cls,
+        find_links,  # type: List[str]
+        index_urls,  # type: List[str]
+    ):
+        # type: (...) -> SearchScope
+        """
+        Create a SearchScope object after normalizing the `find_links`.
+        """
+        # Build find_links. If an argument starts with ~, it may be
+        # a local file relative to a home directory. So try normalizing
+        # it and if it exists, use the normalized version.
+        # This is deliberately conservative - it might be fine just to
+        # blindly normalize anything starting with a ~...
+        built_find_links = []  # type: List[str]
+        for link in find_links:
+            if link.startswith('~'):
+                new_link = normalize_path(link)
+                if os.path.exists(new_link):
+                    link = new_link
+            built_find_links.append(link)
+
+        # If we don't have TLS enabled, then WARN if anyplace we're looking
+        # relies on TLS.
+        if not has_tls():
+            for link in itertools.chain(index_urls, built_find_links):
+                parsed = urllib_parse.urlparse(link)
+                if parsed.scheme == 'https':
+                    logger.warning(
+                        'pip is configured with locations that require '
+                        'TLS/SSL, however the ssl module in Python is not '
+                        'available.'
+                    )
+                    break
+
+        return cls(
+            find_links=built_find_links,
+            index_urls=index_urls,
+        )
+
+    def __init__(
+        self,
+        find_links,  # type: List[str]
+        index_urls,  # type: List[str]
+    ):
+        # type: (...) -> None
+        self.find_links = find_links
+        self.index_urls = index_urls
+
+    def get_formatted_locations(self):
+        # type: () -> str
+        lines = []
+        if self.index_urls and self.index_urls != [PyPI.simple_url]:
+            lines.append(
+                'Looking in indexes: {}'.format(', '.join(
+                    redact_auth_from_url(url) for url in self.index_urls))
+            )
+        if self.find_links:
+            lines.append(
+                'Looking in links: {}'.format(', '.join(
+                    redact_auth_from_url(url) for url in self.find_links))
+            )
+        return '\n'.join(lines)
+
+    def get_index_urls_locations(self, project_name):
+        # type: (str) -> List[str]
+        """Returns the locations found via self.index_urls
+
+        Checks the url_name on the main (first in the list) index and
+        use this url_name to produce all locations
+        """
+
+        def mkurl_pypi_url(url):
+            # type: (str) -> str
+            loc = posixpath.join(
+                url,
+                urllib_parse.quote(canonicalize_name(project_name)))
+            # For maximum compatibility with easy_install, ensure the path
+            # ends in a trailing slash.  Although this isn't in the spec
+            # (and PyPI can handle it without the slash) some other index
+            # implementations might break if they relied on easy_install's
+            # behavior.
+            if not loc.endswith('/'):
+                loc = loc + '/'
+            return loc
+
+        return [mkurl_pypi_url(url) for url in self.index_urls]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py
new file mode 100644
index 0000000000000000000000000000000000000000..f58fdce9cdfcb9320c09f0652ff20a9dc52f3701
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py
@@ -0,0 +1,47 @@
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional
+    from pip._internal.models.format_control import FormatControl
+
+
+class SelectionPreferences(object):
+
+    """
+    Encapsulates the candidate selection preferences for downloading
+    and installing files.
+    """
+
+    # Don't include an allow_yanked default value to make sure each call
+    # site considers whether yanked releases are allowed. This also causes
+    # that decision to be made explicit in the calling code, which helps
+    # people when reading the code.
+    def __init__(
+        self,
+        allow_yanked,  # type: bool
+        allow_all_prereleases=False,  # type: bool
+        format_control=None,          # type: Optional[FormatControl]
+        prefer_binary=False,          # type: bool
+        ignore_requires_python=None,  # type: Optional[bool]
+    ):
+        # type: (...) -> None
+        """Create a SelectionPreferences object.
+
+        :param allow_yanked: Whether files marked as yanked (in the sense
+            of PEP 592) are permitted to be candidates for install.
+        :param format_control: A FormatControl object or None. Used to control
+            the selection of source packages / binary packages when consulting
+            the index and links.
+        :param prefer_binary: Whether to prefer an old, but valid, binary
+            dist over a new source dist.
+        :param ignore_requires_python: Whether to ignore incompatible
+            "Requires-Python" values in links. Defaults to False.
+        """
+        if ignore_requires_python is None:
+            ignore_requires_python = False
+
+        self.allow_yanked = allow_yanked
+        self.allow_all_prereleases = allow_all_prereleases
+        self.format_control = format_control
+        self.prefer_binary = prefer_binary
+        self.ignore_requires_python = ignore_requires_python
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py
new file mode 100644
index 0000000000000000000000000000000000000000..97ae85a0945b88e63db603fbeb4d49bdc339fa6a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/target_python.py
@@ -0,0 +1,107 @@
+import sys
+
+from pip._internal.pep425tags import get_supported, version_info_to_nodot
+from pip._internal.utils.misc import normalize_version_info
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional, Tuple
+
+    from pip._vendor.packaging.tags import Tag
+
+
+class TargetPython(object):
+
+    """
+    Encapsulates the properties of a Python interpreter one is targeting
+    for a package install, download, etc.
+    """
+
+    def __init__(
+        self,
+        platform=None,  # type: Optional[str]
+        py_version_info=None,  # type: Optional[Tuple[int, ...]]
+        abi=None,  # type: Optional[str]
+        implementation=None,  # type: Optional[str]
+    ):
+        # type: (...) -> None
+        """
+        :param platform: A string or None. If None, searches for packages
+            that are supported by the current system. Otherwise, will find
+            packages that can be built on the platform passed in. These
+            packages will only be downloaded for distribution: they will
+            not be built locally.
+        :param py_version_info: An optional tuple of ints representing the
+            Python version information to use (e.g. `sys.version_info[:3]`).
+            This can have length 1, 2, or 3 when provided.
+        :param abi: A string or None. This is passed to pep425tags.py's
+            get_supported() function as is.
+        :param implementation: A string or None. This is passed to
+            pep425tags.py's get_supported() function as is.
+        """
+        # Store the given py_version_info for when we call get_supported().
+        self._given_py_version_info = py_version_info
+
+        if py_version_info is None:
+            py_version_info = sys.version_info[:3]
+        else:
+            py_version_info = normalize_version_info(py_version_info)
+
+        py_version = '.'.join(map(str, py_version_info[:2]))
+
+        self.abi = abi
+        self.implementation = implementation
+        self.platform = platform
+        self.py_version = py_version
+        self.py_version_info = py_version_info
+
+        # This is used to cache the return value of get_tags().
+        self._valid_tags = None  # type: Optional[List[Tag]]
+
+    def format_given(self):
+        # type: () -> str
+        """
+        Format the given, non-None attributes for display.
+        """
+        display_version = None
+        if self._given_py_version_info is not None:
+            display_version = '.'.join(
+                str(part) for part in self._given_py_version_info
+            )
+
+        key_values = [
+            ('platform', self.platform),
+            ('version_info', display_version),
+            ('abi', self.abi),
+            ('implementation', self.implementation),
+        ]
+        return ' '.join(
+            '{}={!r}'.format(key, value) for key, value in key_values
+            if value is not None
+        )
+
+    def get_tags(self):
+        # type: () -> List[Tag]
+        """
+        Return the supported PEP 425 tags to check wheel candidates against.
+
+        The tags are returned in order of preference (most preferred first).
+        """
+        if self._valid_tags is None:
+            # Pass versions=None if no py_version_info was given since
+            # versions=None uses special default logic.
+            py_version_info = self._given_py_version_info
+            if py_version_info is None:
+                version = None
+            else:
+                version = version_info_to_nodot(py_version_info)
+
+            tags = get_supported(
+                version=version,
+                platform=self.platform,
+                abi=self.abi,
+                impl=self.implementation,
+            )
+            self._valid_tags = tags
+
+        return self._valid_tags
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..f1e3f44c598a708322afd85d6da98e2179196b6a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/models/wheel.py
@@ -0,0 +1,78 @@
+"""Represents a wheel file and provides access to the various parts of the
+name that have meaning.
+"""
+import re
+
+from pip._vendor.packaging.tags import Tag
+
+from pip._internal.exceptions import InvalidWheelFilename
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List
+
+
+class Wheel(object):
+    """A wheel file"""
+
+    wheel_file_re = re.compile(
+        r"""^(?P<namever>(?P<name>.+?)-(?P<ver>.*?))
+        ((-(?P<build>\d[^-]*?))?-(?P<pyver>.+?)-(?P<abi>.+?)-(?P<plat>.+?)
+        \.whl|\.dist-info)$""",
+        re.VERBOSE
+    )
+
+    def __init__(self, filename):
+        # type: (str) -> None
+        """
+        :raises InvalidWheelFilename: when the filename is invalid for a wheel
+        """
+        wheel_info = self.wheel_file_re.match(filename)
+        if not wheel_info:
+            raise InvalidWheelFilename(
+                "%s is not a valid wheel filename." % filename
+            )
+        self.filename = filename
+        self.name = wheel_info.group('name').replace('_', '-')
+        # we'll assume "_" means "-" due to wheel naming scheme
+        # (https://github.com/pypa/pip/issues/1150)
+        self.version = wheel_info.group('ver').replace('_', '-')
+        self.build_tag = wheel_info.group('build')
+        self.pyversions = wheel_info.group('pyver').split('.')
+        self.abis = wheel_info.group('abi').split('.')
+        self.plats = wheel_info.group('plat').split('.')
+
+        # All the tag combinations from this file
+        self.file_tags = {
+            Tag(x, y, z) for x in self.pyversions
+            for y in self.abis for z in self.plats
+        }
+
+    def get_formatted_file_tags(self):
+        # type: () -> List[str]
+        """Return the wheel's tags as a sorted list of strings."""
+        return sorted(str(tag) for tag in self.file_tags)
+
+    def support_index_min(self, tags):
+        # type: (List[Tag]) -> int
+        """Return the lowest index that one of the wheel's file_tag combinations
+        achieves in the given list of supported tags.
+
+        For example, if there are 8 supported tags and one of the file tags
+        is first in the list, then return 0.
+
+        :param tags: the PEP 425 tags to check the wheel against, in order
+            with most preferred first.
+
+        :raises ValueError: If none of the wheel's file tags match one of
+            the supported tags.
+        """
+        return min(tags.index(tag) for tag in self.file_tags if tag in tags)
+
+    def supported(self, tags):
+        # type: (List[Tag]) -> bool
+        """Return whether the wheel is compatible with one of the given tags.
+
+        :param tags: the PEP 425 tags to check the wheel against.
+        """
+        return not self.file_tags.isdisjoint(tags)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b51bde91b2e5b4e557ed9b70fc113843cc3d49ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/__init__.py
@@ -0,0 +1,2 @@
+"""Contains purely network-related utilities.
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e1da54ca59d8d42b53b51f95b876b369f76b4a1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/auth.py
@@ -0,0 +1,298 @@
+"""Network Authentication Helpers
+
+Contains interface (MultiDomainBasicAuth) and associated glue code for
+providing credentials in the context of network requests.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import logging
+
+from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth
+from pip._vendor.requests.utils import get_netrc_auth
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.utils.misc import (
+    ask,
+    ask_input,
+    ask_password,
+    remove_auth_from_url,
+    split_auth_netloc_from_url,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from optparse import Values
+    from typing import Dict, Optional, Tuple
+
+    from pip._internal.vcs.versioncontrol import AuthInfo
+
+    Credentials = Tuple[str, str, str]
+
+logger = logging.getLogger(__name__)
+
+try:
+    import keyring  # noqa
+except ImportError:
+    keyring = None
+except Exception as exc:
+    logger.warning(
+        "Keyring is skipped due to an exception: %s", str(exc),
+    )
+    keyring = None
+
+
+def get_keyring_auth(url, username):
+    """Return the tuple auth for a given url from keyring."""
+    if not url or not keyring:
+        return None
+
+    try:
+        try:
+            get_credential = keyring.get_credential
+        except AttributeError:
+            pass
+        else:
+            logger.debug("Getting credentials from keyring for %s", url)
+            cred = get_credential(url, username)
+            if cred is not None:
+                return cred.username, cred.password
+            return None
+
+        if username:
+            logger.debug("Getting password from keyring for %s", url)
+            password = keyring.get_password(url, username)
+            if password:
+                return username, password
+
+    except Exception as exc:
+        logger.warning(
+            "Keyring is skipped due to an exception: %s", str(exc),
+        )
+
+
+class MultiDomainBasicAuth(AuthBase):
+
+    def __init__(self, prompting=True, index_urls=None):
+        # type: (bool, Optional[Values]) -> None
+        self.prompting = prompting
+        self.index_urls = index_urls
+        self.passwords = {}  # type: Dict[str, AuthInfo]
+        # When the user is prompted to enter credentials and keyring is
+        # available, we will offer to save them. If the user accepts,
+        # this value is set to the credentials they entered. After the
+        # request authenticates, the caller should call
+        # ``save_credentials`` to save these.
+        self._credentials_to_save = None  # type: Optional[Credentials]
+
+    def _get_index_url(self, url):
+        """Return the original index URL matching the requested URL.
+
+        Cached or dynamically generated credentials may work against
+        the original index URL rather than just the netloc.
+
+        The provided url should have had its username and password
+        removed already. If the original index url had credentials then
+        they will be included in the return value.
+
+        Returns None if no matching index was found, or if --no-index
+        was specified by the user.
+        """
+        if not url or not self.index_urls:
+            return None
+
+        for u in self.index_urls:
+            prefix = remove_auth_from_url(u).rstrip("/") + "/"
+            if url.startswith(prefix):
+                return u
+
+    def _get_new_credentials(self, original_url, allow_netrc=True,
+                             allow_keyring=True):
+        """Find and return credentials for the specified URL."""
+        # Split the credentials and netloc from the url.
+        url, netloc, url_user_password = split_auth_netloc_from_url(
+            original_url,
+        )
+
+        # Start with the credentials embedded in the url
+        username, password = url_user_password
+        if username is not None and password is not None:
+            logger.debug("Found credentials in url for %s", netloc)
+            return url_user_password
+
+        # Find a matching index url for this request
+        index_url = self._get_index_url(url)
+        if index_url:
+            # Split the credentials from the url.
+            index_info = split_auth_netloc_from_url(index_url)
+            if index_info:
+                index_url, _, index_url_user_password = index_info
+                logger.debug("Found index url %s", index_url)
+
+        # If an index URL was found, try its embedded credentials
+        if index_url and index_url_user_password[0] is not None:
+            username, password = index_url_user_password
+            if username is not None and password is not None:
+                logger.debug("Found credentials in index url for %s", netloc)
+                return index_url_user_password
+
+        # Get creds from netrc if we still don't have them
+        if allow_netrc:
+            netrc_auth = get_netrc_auth(original_url)
+            if netrc_auth:
+                logger.debug("Found credentials in netrc for %s", netloc)
+                return netrc_auth
+
+        # If we don't have a password and keyring is available, use it.
+        if allow_keyring:
+            # The index url is more specific than the netloc, so try it first
+            kr_auth = (
+                get_keyring_auth(index_url, username) or
+                get_keyring_auth(netloc, username)
+            )
+            if kr_auth:
+                logger.debug("Found credentials in keyring for %s", netloc)
+                return kr_auth
+
+        return username, password
+
+    def _get_url_and_credentials(self, original_url):
+        """Return the credentials to use for the provided URL.
+
+        If allowed, netrc and keyring may be used to obtain the
+        correct credentials.
+
+        Returns (url_without_credentials, username, password). Note
+        that even if the original URL contains credentials, this
+        function may return a different username and password.
+        """
+        url, netloc, _ = split_auth_netloc_from_url(original_url)
+
+        # Use any stored credentials that we have for this netloc
+        username, password = self.passwords.get(netloc, (None, None))
+
+        if username is None and password is None:
+            # No stored credentials. Acquire new credentials without prompting
+            # the user. (e.g. from netrc, keyring, or the URL itself)
+            username, password = self._get_new_credentials(original_url)
+
+        if username is not None or password is not None:
+            # Convert the username and password if they're None, so that
+            # this netloc will show up as "cached" in the conditional above.
+            # Further, HTTPBasicAuth doesn't accept None, so it makes sense to
+            # cache the value that is going to be used.
+            username = username or ""
+            password = password or ""
+
+            # Store any acquired credentials.
+            self.passwords[netloc] = (username, password)
+
+        assert (
+            # Credentials were found
+            (username is not None and password is not None) or
+            # Credentials were not found
+            (username is None and password is None)
+        ), "Could not load credentials from url: {}".format(original_url)
+
+        return url, username, password
+
+    def __call__(self, req):
+        # Get credentials for this request
+        url, username, password = self._get_url_and_credentials(req.url)
+
+        # Set the url of the request to the url without any credentials
+        req.url = url
+
+        if username is not None and password is not None:
+            # Send the basic auth with this request
+            req = HTTPBasicAuth(username, password)(req)
+
+        # Attach a hook to handle 401 responses
+        req.register_hook("response", self.handle_401)
+
+        return req
+
+    # Factored out to allow for easy patching in tests
+    def _prompt_for_password(self, netloc):
+        username = ask_input("User for %s: " % netloc)
+        if not username:
+            return None, None
+        auth = get_keyring_auth(netloc, username)
+        if auth:
+            return auth[0], auth[1], False
+        password = ask_password("Password: ")
+        return username, password, True
+
+    # Factored out to allow for easy patching in tests
+    def _should_save_password_to_keyring(self):
+        if not keyring:
+            return False
+        return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y"
+
+    def handle_401(self, resp, **kwargs):
+        # We only care about 401 responses, anything else we want to just
+        #   pass through the actual response
+        if resp.status_code != 401:
+            return resp
+
+        # We are not able to prompt the user so simply return the response
+        if not self.prompting:
+            return resp
+
+        parsed = urllib_parse.urlparse(resp.url)
+
+        # Prompt the user for a new username and password
+        username, password, save = self._prompt_for_password(parsed.netloc)
+
+        # Store the new username and password to use for future requests
+        self._credentials_to_save = None
+        if username is not None and password is not None:
+            self.passwords[parsed.netloc] = (username, password)
+
+            # Prompt to save the password to keyring
+            if save and self._should_save_password_to_keyring():
+                self._credentials_to_save = (parsed.netloc, username, password)
+
+        # Consume content and release the original connection to allow our new
+        #   request to reuse the same one.
+        resp.content
+        resp.raw.release_conn()
+
+        # Add our new username and password to the request
+        req = HTTPBasicAuth(username or "", password or "")(resp.request)
+        req.register_hook("response", self.warn_on_401)
+
+        # On successful request, save the credentials that were used to
+        # keyring. (Note that if the user responded "no" above, this member
+        # is not set and nothing will be saved.)
+        if self._credentials_to_save:
+            req.register_hook("response", self.save_credentials)
+
+        # Send our new request
+        new_resp = resp.connection.send(req, **kwargs)
+        new_resp.history.append(resp)
+
+        return new_resp
+
+    def warn_on_401(self, resp, **kwargs):
+        """Response callback to warn about incorrect credentials."""
+        if resp.status_code == 401:
+            logger.warning(
+                '401 Error, Credentials not correct for %s', resp.request.url,
+            )
+
+    def save_credentials(self, resp, **kwargs):
+        """Response callback to save credentials on success."""
+        assert keyring is not None, "should never reach here without keyring"
+        if not keyring:
+            return
+
+        creds = self._credentials_to_save
+        self._credentials_to_save = None
+        if creds and resp.status_code < 400:
+            try:
+                logger.info('Saving credentials to keyring')
+                keyring.set_password(*creds)
+            except Exception:
+                logger.exception('Failed to save credentials')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py
new file mode 100644
index 0000000000000000000000000000000000000000..c9386e173600d58dacda2061f49d747de386a50a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/cache.py
@@ -0,0 +1,81 @@
+"""HTTP cache implementation.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import os
+from contextlib import contextmanager
+
+from pip._vendor.cachecontrol.cache import BaseCache
+from pip._vendor.cachecontrol.caches import FileCache
+from pip._vendor.requests.models import Response
+
+from pip._internal.utils.filesystem import adjacent_tmp_file, replace
+from pip._internal.utils.misc import ensure_dir
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional
+
+
+def is_from_cache(response):
+    # type: (Response) -> bool
+    return getattr(response, "from_cache", False)
+
+
+@contextmanager
+def suppressed_cache_errors():
+    """If we can't access the cache then we can just skip caching and process
+    requests as if caching wasn't enabled.
+    """
+    try:
+        yield
+    except (OSError, IOError):
+        pass
+
+
+class SafeFileCache(BaseCache):
+    """
+    A file based cache which is safe to use even when the target directory may
+    not be accessible or writable.
+    """
+
+    def __init__(self, directory):
+        # type: (str) -> None
+        assert directory is not None, "Cache directory must not be None."
+        super(SafeFileCache, self).__init__()
+        self.directory = directory
+
+    def _get_cache_path(self, name):
+        # type: (str) -> str
+        # From cachecontrol.caches.file_cache.FileCache._fn, brought into our
+        # class for backwards-compatibility and to avoid using a non-public
+        # method.
+        hashed = FileCache.encode(name)
+        parts = list(hashed[:5]) + [hashed]
+        return os.path.join(self.directory, *parts)
+
+    def get(self, key):
+        # type: (str) -> Optional[bytes]
+        path = self._get_cache_path(key)
+        with suppressed_cache_errors():
+            with open(path, 'rb') as f:
+                return f.read()
+
+    def set(self, key, value):
+        # type: (str, bytes) -> None
+        path = self._get_cache_path(key)
+        with suppressed_cache_errors():
+            ensure_dir(os.path.dirname(path))
+
+            with adjacent_tmp_file(path) as f:
+                f.write(value)
+
+            replace(f.name, path)
+
+    def delete(self, key):
+        # type: (str) -> None
+        path = self._get_cache_path(key)
+        with suppressed_cache_errors():
+            os.remove(path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/download.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/download.py
new file mode 100644
index 0000000000000000000000000000000000000000..c90c4bf42cfe25c7c417c3776b7d5844417b9186
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/download.py
@@ -0,0 +1,200 @@
+"""Download files with progress indicators.
+"""
+import cgi
+import logging
+import mimetypes
+import os
+
+from pip._vendor import requests
+from pip._vendor.requests.models import CONTENT_CHUNK_SIZE
+
+from pip._internal.models.index import PyPI
+from pip._internal.network.cache import is_from_cache
+from pip._internal.network.utils import response_chunks
+from pip._internal.utils.misc import (
+    format_size,
+    redact_auth_from_url,
+    splitext,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.ui import DownloadProgressProvider
+
+if MYPY_CHECK_RUNNING:
+    from typing import Iterable, Optional
+
+    from pip._vendor.requests.models import Response
+
+    from pip._internal.models.link import Link
+    from pip._internal.network.session import PipSession
+
+logger = logging.getLogger(__name__)
+
+
+def _get_http_response_size(resp):
+    # type: (Response) -> Optional[int]
+    try:
+        return int(resp.headers['content-length'])
+    except (ValueError, KeyError, TypeError):
+        return None
+
+
+def _prepare_download(
+    resp,  # type: Response
+    link,  # type: Link
+    progress_bar  # type: str
+):
+    # type: (...) -> Iterable[bytes]
+    total_length = _get_http_response_size(resp)
+
+    if link.netloc == PyPI.file_storage_domain:
+        url = link.show_url
+    else:
+        url = link.url_without_fragment
+
+    logged_url = redact_auth_from_url(url)
+
+    if total_length:
+        logged_url = '{} ({})'.format(logged_url, format_size(total_length))
+
+    if is_from_cache(resp):
+        logger.info("Using cached %s", logged_url)
+    else:
+        logger.info("Downloading %s", logged_url)
+
+    if logger.getEffectiveLevel() > logging.INFO:
+        show_progress = False
+    elif is_from_cache(resp):
+        show_progress = False
+    elif not total_length:
+        show_progress = True
+    elif total_length > (40 * 1000):
+        show_progress = True
+    else:
+        show_progress = False
+
+    chunks = response_chunks(resp, CONTENT_CHUNK_SIZE)
+
+    if not show_progress:
+        return chunks
+
+    return DownloadProgressProvider(
+        progress_bar, max=total_length
+    )(chunks)
+
+
+def sanitize_content_filename(filename):
+    # type: (str) -> str
+    """
+    Sanitize the "filename" value from a Content-Disposition header.
+    """
+    return os.path.basename(filename)
+
+
+def parse_content_disposition(content_disposition, default_filename):
+    # type: (str, str) -> str
+    """
+    Parse the "filename" value from a Content-Disposition header, and
+    return the default filename if the result is empty.
+    """
+    _type, params = cgi.parse_header(content_disposition)
+    filename = params.get('filename')
+    if filename:
+        # We need to sanitize the filename to prevent directory traversal
+        # in case the filename contains ".." path parts.
+        filename = sanitize_content_filename(filename)
+    return filename or default_filename
+
+
+def _get_http_response_filename(resp, link):
+    # type: (Response, Link) -> str
+    """Get an ideal filename from the given HTTP response, falling back to
+    the link filename if not provided.
+    """
+    filename = link.filename  # fallback
+    # Have a look at the Content-Disposition header for a better guess
+    content_disposition = resp.headers.get('content-disposition')
+    if content_disposition:
+        filename = parse_content_disposition(content_disposition, filename)
+    ext = splitext(filename)[1]  # type: Optional[str]
+    if not ext:
+        ext = mimetypes.guess_extension(
+            resp.headers.get('content-type', '')
+        )
+        if ext:
+            filename += ext
+    if not ext and link.url != resp.url:
+        ext = os.path.splitext(resp.url)[1]
+        if ext:
+            filename += ext
+    return filename
+
+
+def _http_get_download(session, link):
+    # type: (PipSession, Link) -> Response
+    target_url = link.url.split('#', 1)[0]
+    resp = session.get(
+        target_url,
+        # We use Accept-Encoding: identity here because requests
+        # defaults to accepting compressed responses. This breaks in
+        # a variety of ways depending on how the server is configured.
+        # - Some servers will notice that the file isn't a compressible
+        #   file and will leave the file alone and with an empty
+        #   Content-Encoding
+        # - Some servers will notice that the file is already
+        #   compressed and will leave the file alone and will add a
+        #   Content-Encoding: gzip header
+        # - Some servers won't notice anything at all and will take
+        #   a file that's already been compressed and compress it again
+        #   and set the Content-Encoding: gzip header
+        # By setting this to request only the identity encoding We're
+        # hoping to eliminate the third case. Hopefully there does not
+        # exist a server which when given a file will notice it is
+        # already compressed and that you're not asking for a
+        # compressed file and will then decompress it before sending
+        # because if that's the case I don't think it'll ever be
+        # possible to make this work.
+        headers={"Accept-Encoding": "identity"},
+        stream=True,
+    )
+    resp.raise_for_status()
+    return resp
+
+
+class Download(object):
+    def __init__(
+        self,
+        response,  # type: Response
+        filename,  # type: str
+        chunks,  # type: Iterable[bytes]
+    ):
+        # type: (...) -> None
+        self.response = response
+        self.filename = filename
+        self.chunks = chunks
+
+
+class Downloader(object):
+    def __init__(
+        self,
+        session,  # type: PipSession
+        progress_bar,  # type: str
+    ):
+        # type: (...) -> None
+        self._session = session
+        self._progress_bar = progress_bar
+
+    def __call__(self, link):
+        # type: (Link) -> Download
+        try:
+            resp = _http_get_download(self._session, link)
+        except requests.HTTPError as e:
+            logger.critical(
+                "HTTP error %s while getting %s", e.response.status_code, link
+            )
+            raise
+
+        return Download(
+            resp,
+            _get_http_response_filename(resp, link),
+            _prepare_download(resp, link, self._progress_bar),
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/session.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/session.py
new file mode 100644
index 0000000000000000000000000000000000000000..f5eb15ef2f6245ee303b8f6297eb8c460945afca
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/session.py
@@ -0,0 +1,405 @@
+"""PipSession and supporting code, containing all pip-specific
+network request configuration and behavior.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import email.utils
+import json
+import logging
+import mimetypes
+import os
+import platform
+import sys
+import warnings
+
+from pip._vendor import requests, six, urllib3
+from pip._vendor.cachecontrol import CacheControlAdapter
+from pip._vendor.requests.adapters import BaseAdapter, HTTPAdapter
+from pip._vendor.requests.models import Response
+from pip._vendor.requests.structures import CaseInsensitiveDict
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+from pip._vendor.urllib3.exceptions import InsecureRequestWarning
+
+from pip import __version__
+from pip._internal.network.auth import MultiDomainBasicAuth
+from pip._internal.network.cache import SafeFileCache
+# Import ssl from compat so the initial import occurs in only one place.
+from pip._internal.utils.compat import has_tls, ipaddress
+from pip._internal.utils.glibc import libc_ver
+from pip._internal.utils.misc import (
+    build_url_from_netloc,
+    get_installed_version,
+    parse_netloc,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import url_to_path
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Iterator, List, Optional, Tuple, Union,
+    )
+
+    from pip._internal.models.link import Link
+
+    SecureOrigin = Tuple[str, str, Optional[Union[int, str]]]
+
+
+logger = logging.getLogger(__name__)
+
+
+# Ignore warning raised when using --trusted-host.
+warnings.filterwarnings("ignore", category=InsecureRequestWarning)
+
+
+SECURE_ORIGINS = [
+    # protocol, hostname, port
+    # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC)
+    ("https", "*", "*"),
+    ("*", "localhost", "*"),
+    ("*", "127.0.0.0/8", "*"),
+    ("*", "::1/128", "*"),
+    ("file", "*", None),
+    # ssh is always secure.
+    ("ssh", "*", "*"),
+]  # type: List[SecureOrigin]
+
+
+# These are environment variables present when running under various
+# CI systems.  For each variable, some CI systems that use the variable
+# are indicated.  The collection was chosen so that for each of a number
+# of popular systems, at least one of the environment variables is used.
+# This list is used to provide some indication of and lower bound for
+# CI traffic to PyPI.  Thus, it is okay if the list is not comprehensive.
+# For more background, see: https://github.com/pypa/pip/issues/5499
+CI_ENVIRONMENT_VARIABLES = (
+    # Azure Pipelines
+    'BUILD_BUILDID',
+    # Jenkins
+    'BUILD_ID',
+    # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI
+    'CI',
+    # Explicit environment variable.
+    'PIP_IS_CI',
+)
+
+
+def looks_like_ci():
+    # type: () -> bool
+    """
+    Return whether it looks like pip is running under CI.
+    """
+    # We don't use the method of checking for a tty (e.g. using isatty())
+    # because some CI systems mimic a tty (e.g. Travis CI).  Thus that
+    # method doesn't provide definitive information in either direction.
+    return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES)
+
+
+def user_agent():
+    """
+    Return a string representing the user agent.
+    """
+    data = {
+        "installer": {"name": "pip", "version": __version__},
+        "python": platform.python_version(),
+        "implementation": {
+            "name": platform.python_implementation(),
+        },
+    }
+
+    if data["implementation"]["name"] == 'CPython':
+        data["implementation"]["version"] = platform.python_version()
+    elif data["implementation"]["name"] == 'PyPy':
+        if sys.pypy_version_info.releaselevel == 'final':
+            pypy_version_info = sys.pypy_version_info[:3]
+        else:
+            pypy_version_info = sys.pypy_version_info
+        data["implementation"]["version"] = ".".join(
+            [str(x) for x in pypy_version_info]
+        )
+    elif data["implementation"]["name"] == 'Jython':
+        # Complete Guess
+        data["implementation"]["version"] = platform.python_version()
+    elif data["implementation"]["name"] == 'IronPython':
+        # Complete Guess
+        data["implementation"]["version"] = platform.python_version()
+
+    if sys.platform.startswith("linux"):
+        from pip._vendor import distro
+        distro_infos = dict(filter(
+            lambda x: x[1],
+            zip(["name", "version", "id"], distro.linux_distribution()),
+        ))
+        libc = dict(filter(
+            lambda x: x[1],
+            zip(["lib", "version"], libc_ver()),
+        ))
+        if libc:
+            distro_infos["libc"] = libc
+        if distro_infos:
+            data["distro"] = distro_infos
+
+    if sys.platform.startswith("darwin") and platform.mac_ver()[0]:
+        data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]}
+
+    if platform.system():
+        data.setdefault("system", {})["name"] = platform.system()
+
+    if platform.release():
+        data.setdefault("system", {})["release"] = platform.release()
+
+    if platform.machine():
+        data["cpu"] = platform.machine()
+
+    if has_tls():
+        import _ssl as ssl
+        data["openssl_version"] = ssl.OPENSSL_VERSION
+
+    setuptools_version = get_installed_version("setuptools")
+    if setuptools_version is not None:
+        data["setuptools_version"] = setuptools_version
+
+    # Use None rather than False so as not to give the impression that
+    # pip knows it is not being run under CI.  Rather, it is a null or
+    # inconclusive result.  Also, we include some value rather than no
+    # value to make it easier to know that the check has been run.
+    data["ci"] = True if looks_like_ci() else None
+
+    user_data = os.environ.get("PIP_USER_AGENT_USER_DATA")
+    if user_data is not None:
+        data["user_data"] = user_data
+
+    return "{data[installer][name]}/{data[installer][version]} {json}".format(
+        data=data,
+        json=json.dumps(data, separators=(",", ":"), sort_keys=True),
+    )
+
+
+class LocalFSAdapter(BaseAdapter):
+
+    def send(self, request, stream=None, timeout=None, verify=None, cert=None,
+             proxies=None):
+        pathname = url_to_path(request.url)
+
+        resp = Response()
+        resp.status_code = 200
+        resp.url = request.url
+
+        try:
+            stats = os.stat(pathname)
+        except OSError as exc:
+            resp.status_code = 404
+            resp.raw = exc
+        else:
+            modified = email.utils.formatdate(stats.st_mtime, usegmt=True)
+            content_type = mimetypes.guess_type(pathname)[0] or "text/plain"
+            resp.headers = CaseInsensitiveDict({
+                "Content-Type": content_type,
+                "Content-Length": stats.st_size,
+                "Last-Modified": modified,
+            })
+
+            resp.raw = open(pathname, "rb")
+            resp.close = resp.raw.close
+
+        return resp
+
+    def close(self):
+        pass
+
+
+class InsecureHTTPAdapter(HTTPAdapter):
+
+    def cert_verify(self, conn, url, verify, cert):
+        super(InsecureHTTPAdapter, self).cert_verify(
+            conn=conn, url=url, verify=False, cert=cert
+        )
+
+
+class PipSession(requests.Session):
+
+    timeout = None  # type: Optional[int]
+
+    def __init__(self, *args, **kwargs):
+        """
+        :param trusted_hosts: Domains not to emit warnings for when not using
+            HTTPS.
+        """
+        retries = kwargs.pop("retries", 0)
+        cache = kwargs.pop("cache", None)
+        trusted_hosts = kwargs.pop("trusted_hosts", [])  # type: List[str]
+        index_urls = kwargs.pop("index_urls", None)
+
+        super(PipSession, self).__init__(*args, **kwargs)
+
+        # Namespace the attribute with "pip_" just in case to prevent
+        # possible conflicts with the base class.
+        self.pip_trusted_origins = []  # type: List[Tuple[str, Optional[int]]]
+
+        # Attach our User Agent to the request
+        self.headers["User-Agent"] = user_agent()
+
+        # Attach our Authentication handler to the session
+        self.auth = MultiDomainBasicAuth(index_urls=index_urls)
+
+        # Create our urllib3.Retry instance which will allow us to customize
+        # how we handle retries.
+        retries = urllib3.Retry(
+            # Set the total number of retries that a particular request can
+            # have.
+            total=retries,
+
+            # A 503 error from PyPI typically means that the Fastly -> Origin
+            # connection got interrupted in some way. A 503 error in general
+            # is typically considered a transient error so we'll go ahead and
+            # retry it.
+            # A 500 may indicate transient error in Amazon S3
+            # A 520 or 527 - may indicate transient error in CloudFlare
+            status_forcelist=[500, 503, 520, 527],
+
+            # Add a small amount of back off between failed requests in
+            # order to prevent hammering the service.
+            backoff_factor=0.25,
+        )
+
+        # We want to _only_ cache responses on securely fetched origins. We do
+        # this because we can't validate the response of an insecurely fetched
+        # origin, and we don't want someone to be able to poison the cache and
+        # require manual eviction from the cache to fix it.
+        if cache:
+            secure_adapter = CacheControlAdapter(
+                cache=SafeFileCache(cache),
+                max_retries=retries,
+            )
+        else:
+            secure_adapter = HTTPAdapter(max_retries=retries)
+
+        # Our Insecure HTTPAdapter disables HTTPS validation. It does not
+        # support caching (see above) so we'll use it for all http:// URLs as
+        # well as any https:// host that we've marked as ignoring TLS errors
+        # for.
+        insecure_adapter = InsecureHTTPAdapter(max_retries=retries)
+        # Save this for later use in add_insecure_host().
+        self._insecure_adapter = insecure_adapter
+
+        self.mount("https://", secure_adapter)
+        self.mount("http://", insecure_adapter)
+
+        # Enable file:// urls
+        self.mount("file://", LocalFSAdapter())
+
+        for host in trusted_hosts:
+            self.add_trusted_host(host, suppress_logging=True)
+
+    def add_trusted_host(self, host, source=None, suppress_logging=False):
+        # type: (str, Optional[str], bool) -> None
+        """
+        :param host: It is okay to provide a host that has previously been
+            added.
+        :param source: An optional source string, for logging where the host
+            string came from.
+        """
+        if not suppress_logging:
+            msg = 'adding trusted host: {!r}'.format(host)
+            if source is not None:
+                msg += ' (from {})'.format(source)
+            logger.info(msg)
+
+        host_port = parse_netloc(host)
+        if host_port not in self.pip_trusted_origins:
+            self.pip_trusted_origins.append(host_port)
+
+        self.mount(build_url_from_netloc(host) + '/', self._insecure_adapter)
+        if not host_port[1]:
+            # Mount wildcard ports for the same host.
+            self.mount(
+                build_url_from_netloc(host) + ':',
+                self._insecure_adapter
+            )
+
+    def iter_secure_origins(self):
+        # type: () -> Iterator[SecureOrigin]
+        for secure_origin in SECURE_ORIGINS:
+            yield secure_origin
+        for host, port in self.pip_trusted_origins:
+            yield ('*', host, '*' if port is None else port)
+
+    def is_secure_origin(self, location):
+        # type: (Link) -> bool
+        # Determine if this url used a secure transport mechanism
+        parsed = urllib_parse.urlparse(str(location))
+        origin_protocol, origin_host, origin_port = (
+            parsed.scheme, parsed.hostname, parsed.port,
+        )
+
+        # The protocol to use to see if the protocol matches.
+        # Don't count the repository type as part of the protocol: in
+        # cases such as "git+ssh", only use "ssh". (I.e., Only verify against
+        # the last scheme.)
+        origin_protocol = origin_protocol.rsplit('+', 1)[-1]
+
+        # Determine if our origin is a secure origin by looking through our
+        # hardcoded list of secure origins, as well as any additional ones
+        # configured on this PackageFinder instance.
+        for secure_origin in self.iter_secure_origins():
+            secure_protocol, secure_host, secure_port = secure_origin
+            if origin_protocol != secure_protocol and secure_protocol != "*":
+                continue
+
+            try:
+                addr = ipaddress.ip_address(
+                    None
+                    if origin_host is None
+                    else six.ensure_text(origin_host)
+                )
+                network = ipaddress.ip_network(
+                    six.ensure_text(secure_host)
+                )
+            except ValueError:
+                # We don't have both a valid address or a valid network, so
+                # we'll check this origin against hostnames.
+                if (
+                    origin_host and
+                    origin_host.lower() != secure_host.lower() and
+                    secure_host != "*"
+                ):
+                    continue
+            else:
+                # We have a valid address and network, so see if the address
+                # is contained within the network.
+                if addr not in network:
+                    continue
+
+            # Check to see if the port matches.
+            if (
+                origin_port != secure_port and
+                secure_port != "*" and
+                secure_port is not None
+            ):
+                continue
+
+            # If we've gotten here, then this origin matches the current
+            # secure origin and we should return True
+            return True
+
+        # If we've gotten to this point, then the origin isn't secure and we
+        # will not accept it as a valid location to search. We will however
+        # log a warning that we are ignoring it.
+        logger.warning(
+            "The repository located at %s is not a trusted or secure host and "
+            "is being ignored. If this repository is available via HTTPS we "
+            "recommend you use HTTPS instead, otherwise you may silence "
+            "this warning and allow it anyway with '--trusted-host %s'.",
+            origin_host,
+            origin_host,
+        )
+
+        return False
+
+    def request(self, method, url, *args, **kwargs):
+        # Allow setting a default timeout on a session
+        kwargs.setdefault("timeout", self.timeout)
+
+        # Dispatch the actual request
+        return super(PipSession, self).request(method, url, *args, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..a19050b0f7082809f277bc74e516a9af8e537136
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/utils.py
@@ -0,0 +1,48 @@
+from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Iterator
+
+
+def response_chunks(response, chunk_size=CONTENT_CHUNK_SIZE):
+    # type: (Response, int) -> Iterator[bytes]
+    """Given a requests Response, provide the data chunks.
+    """
+    try:
+        # Special case for urllib3.
+        for chunk in response.raw.stream(
+            chunk_size,
+            # We use decode_content=False here because we don't
+            # want urllib3 to mess with the raw bytes we get
+            # from the server. If we decompress inside of
+            # urllib3 then we cannot verify the checksum
+            # because the checksum will be of the compressed
+            # file. This breakage will only occur if the
+            # server adds a Content-Encoding header, which
+            # depends on how the server was configured:
+            # - Some servers will notice that the file isn't a
+            #   compressible file and will leave the file alone
+            #   and with an empty Content-Encoding
+            # - Some servers will notice that the file is
+            #   already compressed and will leave the file
+            #   alone and will add a Content-Encoding: gzip
+            #   header
+            # - Some servers won't notice anything at all and
+            #   will take a file that's already been compressed
+            #   and compress it again and set the
+            #   Content-Encoding: gzip header
+            #
+            # By setting this not to decode automatically we
+            # hope to eliminate problems with the second case.
+            decode_content=False,
+        ):
+            yield chunk
+    except AttributeError:
+        # Standard file-like object.
+        while True:
+            chunk = response.raw.read(chunk_size)
+            if not chunk:
+                break
+            yield chunk
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py
new file mode 100644
index 0000000000000000000000000000000000000000..121edd93056f57c7717e6e48e2d7432cfc18ada4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.py
@@ -0,0 +1,44 @@
+"""xmlrpclib.Transport implementation
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import logging
+
+from pip._vendor import requests
+# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is
+#       why we ignore the type on this import
+from pip._vendor.six.moves import xmlrpc_client  # type: ignore
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+logger = logging.getLogger(__name__)
+
+
+class PipXmlrpcTransport(xmlrpc_client.Transport):
+    """Provide a `xmlrpclib.Transport` implementation via a `PipSession`
+    object.
+    """
+
+    def __init__(self, index_url, session, use_datetime=False):
+        xmlrpc_client.Transport.__init__(self, use_datetime)
+        index_parts = urllib_parse.urlparse(index_url)
+        self._scheme = index_parts.scheme
+        self._session = session
+
+    def request(self, host, handler, request_body, verbose=False):
+        parts = (self._scheme, host, handler, None, None, None)
+        url = urllib_parse.urlunparse(parts)
+        try:
+            headers = {'Content-Type': 'text/xml'}
+            response = self._session.post(url, data=request_body,
+                                          headers=headers, stream=True)
+            response.raise_for_status()
+            self.verbose = verbose
+            return self.parse_response(response.raw)
+        except requests.HTTPError as exc:
+            logger.critical(
+                "HTTP error %s while getting %s",
+                exc.response.status_code, url,
+            )
+            raise
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py
new file mode 100644
index 0000000000000000000000000000000000000000..b85a12306a4f9008ae072b5f2c88df5b9d1d3db3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/check.py
@@ -0,0 +1,163 @@
+"""Validation of dependencies of packages
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+import logging
+from collections import namedtuple
+
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.pkg_resources import RequirementParseError
+
+from pip._internal.distributions import (
+    make_distribution_for_install_requirement,
+)
+from pip._internal.utils.misc import get_installed_distributions
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+logger = logging.getLogger(__name__)
+
+if MYPY_CHECK_RUNNING:
+    from pip._internal.req.req_install import InstallRequirement
+    from typing import (
+        Any, Callable, Dict, Optional, Set, Tuple, List
+    )
+
+    # Shorthands
+    PackageSet = Dict[str, 'PackageDetails']
+    Missing = Tuple[str, Any]
+    Conflicting = Tuple[str, str, Any]
+
+    MissingDict = Dict[str, List[Missing]]
+    ConflictingDict = Dict[str, List[Conflicting]]
+    CheckResult = Tuple[MissingDict, ConflictingDict]
+
+PackageDetails = namedtuple('PackageDetails', ['version', 'requires'])
+
+
+def create_package_set_from_installed(**kwargs):
+    # type: (**Any) -> Tuple[PackageSet, bool]
+    """Converts a list of distributions into a PackageSet.
+    """
+    # Default to using all packages installed on the system
+    if kwargs == {}:
+        kwargs = {"local_only": False, "skip": ()}
+
+    package_set = {}
+    problems = False
+    for dist in get_installed_distributions(**kwargs):
+        name = canonicalize_name(dist.project_name)
+        try:
+            package_set[name] = PackageDetails(dist.version, dist.requires())
+        except RequirementParseError as e:
+            # Don't crash on broken metadata
+            logger.warning("Error parsing requirements for %s: %s", name, e)
+            problems = True
+    return package_set, problems
+
+
+def check_package_set(package_set, should_ignore=None):
+    # type: (PackageSet, Optional[Callable[[str], bool]]) -> CheckResult
+    """Check if a package set is consistent
+
+    If should_ignore is passed, it should be a callable that takes a
+    package name and returns a boolean.
+    """
+    if should_ignore is None:
+        def should_ignore(name):
+            return False
+
+    missing = {}
+    conflicting = {}
+
+    for package_name in package_set:
+        # Info about dependencies of package_name
+        missing_deps = set()  # type: Set[Missing]
+        conflicting_deps = set()  # type: Set[Conflicting]
+
+        if should_ignore(package_name):
+            continue
+
+        for req in package_set[package_name].requires:
+            name = canonicalize_name(req.project_name)  # type: str
+
+            # Check if it's missing
+            if name not in package_set:
+                missed = True
+                if req.marker is not None:
+                    missed = req.marker.evaluate()
+                if missed:
+                    missing_deps.add((name, req))
+                continue
+
+            # Check if there's a conflict
+            version = package_set[name].version  # type: str
+            if not req.specifier.contains(version, prereleases=True):
+                conflicting_deps.add((name, version, req))
+
+        if missing_deps:
+            missing[package_name] = sorted(missing_deps, key=str)
+        if conflicting_deps:
+            conflicting[package_name] = sorted(conflicting_deps, key=str)
+
+    return missing, conflicting
+
+
+def check_install_conflicts(to_install):
+    # type: (List[InstallRequirement]) -> Tuple[PackageSet, CheckResult]
+    """For checking if the dependency graph would be consistent after \
+    installing given requirements
+    """
+    # Start from the current state
+    package_set, _ = create_package_set_from_installed()
+    # Install packages
+    would_be_installed = _simulate_installation_of(to_install, package_set)
+
+    # Only warn about directly-dependent packages; create a whitelist of them
+    whitelist = _create_whitelist(would_be_installed, package_set)
+
+    return (
+        package_set,
+        check_package_set(
+            package_set, should_ignore=lambda name: name not in whitelist
+        )
+    )
+
+
+def _simulate_installation_of(to_install, package_set):
+    # type: (List[InstallRequirement], PackageSet) -> Set[str]
+    """Computes the version of packages after installing to_install.
+    """
+
+    # Keep track of packages that were installed
+    installed = set()
+
+    # Modify it as installing requirement_set would (assuming no errors)
+    for inst_req in to_install:
+        abstract_dist = make_distribution_for_install_requirement(inst_req)
+        dist = abstract_dist.get_pkg_resources_distribution()
+
+        name = canonicalize_name(dist.key)
+        package_set[name] = PackageDetails(dist.version, dist.requires())
+
+        installed.add(name)
+
+    return installed
+
+
+def _create_whitelist(would_be_installed, package_set):
+    # type: (Set[str], PackageSet) -> Set[str]
+    packages_affected = set(would_be_installed)
+
+    for package_name in package_set:
+        if package_name in packages_affected:
+            continue
+
+        for req in package_set[package_name].requires:
+            if canonicalize_name(req.name) in packages_affected:
+                packages_affected.add(package_name)
+                break
+
+    return packages_affected
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py
new file mode 100644
index 0000000000000000000000000000000000000000..36a5c339a2ab22debec595af17a520a803f2a783
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/freeze.py
@@ -0,0 +1,265 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import collections
+import logging
+import os
+import re
+
+from pip._vendor import six
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.pkg_resources import RequirementParseError
+
+from pip._internal.exceptions import BadCommand, InstallationError
+from pip._internal.req.constructors import (
+    install_req_from_editable,
+    install_req_from_line,
+)
+from pip._internal.req.req_file import COMMENT_RE
+from pip._internal.utils.misc import (
+    dist_is_editable,
+    get_installed_distributions,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Iterator, Optional, List, Container, Set, Dict, Tuple, Iterable, Union
+    )
+    from pip._internal.cache import WheelCache
+    from pip._vendor.pkg_resources import (
+        Distribution, Requirement
+    )
+
+    RequirementInfo = Tuple[Optional[Union[str, Requirement]], bool, List[str]]
+
+
+logger = logging.getLogger(__name__)
+
+
+def freeze(
+    requirement=None,  # type: Optional[List[str]]
+    find_links=None,  # type: Optional[List[str]]
+    local_only=None,  # type: Optional[bool]
+    user_only=None,  # type: Optional[bool]
+    paths=None,  # type: Optional[List[str]]
+    skip_regex=None,  # type: Optional[str]
+    isolated=False,  # type: bool
+    wheel_cache=None,  # type: Optional[WheelCache]
+    exclude_editable=False,  # type: bool
+    skip=()  # type: Container[str]
+):
+    # type: (...) -> Iterator[str]
+    find_links = find_links or []
+    skip_match = None
+
+    if skip_regex:
+        skip_match = re.compile(skip_regex).search
+
+    for link in find_links:
+        yield '-f %s' % link
+    installations = {}  # type: Dict[str, FrozenRequirement]
+    for dist in get_installed_distributions(local_only=local_only,
+                                            skip=(),
+                                            user_only=user_only,
+                                            paths=paths):
+        try:
+            req = FrozenRequirement.from_dist(dist)
+        except RequirementParseError as exc:
+            # We include dist rather than dist.project_name because the
+            # dist string includes more information, like the version and
+            # location. We also include the exception message to aid
+            # troubleshooting.
+            logger.warning(
+                'Could not generate requirement for distribution %r: %s',
+                dist, exc
+            )
+            continue
+        if exclude_editable and req.editable:
+            continue
+        installations[req.canonical_name] = req
+
+    if requirement:
+        # the options that don't get turned into an InstallRequirement
+        # should only be emitted once, even if the same option is in multiple
+        # requirements files, so we need to keep track of what has been emitted
+        # so that we don't emit it again if it's seen again
+        emitted_options = set()  # type: Set[str]
+        # keep track of which files a requirement is in so that we can
+        # give an accurate warning if a requirement appears multiple times.
+        req_files = collections.defaultdict(list)  # type: Dict[str, List[str]]
+        for req_file_path in requirement:
+            with open(req_file_path) as req_file:
+                for line in req_file:
+                    if (not line.strip() or
+                            line.strip().startswith('#') or
+                            (skip_match and skip_match(line)) or
+                            line.startswith((
+                                '-r', '--requirement',
+                                '-Z', '--always-unzip',
+                                '-f', '--find-links',
+                                '-i', '--index-url',
+                                '--pre',
+                                '--trusted-host',
+                                '--process-dependency-links',
+                                '--extra-index-url'))):
+                        line = line.rstrip()
+                        if line not in emitted_options:
+                            emitted_options.add(line)
+                            yield line
+                        continue
+
+                    if line.startswith('-e') or line.startswith('--editable'):
+                        if line.startswith('-e'):
+                            line = line[2:].strip()
+                        else:
+                            line = line[len('--editable'):].strip().lstrip('=')
+                        line_req = install_req_from_editable(
+                            line,
+                            isolated=isolated,
+                            wheel_cache=wheel_cache,
+                        )
+                    else:
+                        line_req = install_req_from_line(
+                            COMMENT_RE.sub('', line).strip(),
+                            isolated=isolated,
+                            wheel_cache=wheel_cache,
+                        )
+
+                    if not line_req.name:
+                        logger.info(
+                            "Skipping line in requirement file [%s] because "
+                            "it's not clear what it would install: %s",
+                            req_file_path, line.strip(),
+                        )
+                        logger.info(
+                            "  (add #egg=PackageName to the URL to avoid"
+                            " this warning)"
+                        )
+                    else:
+                        line_req_canonical_name = canonicalize_name(
+                            line_req.name)
+                        if line_req_canonical_name not in installations:
+                            # either it's not installed, or it is installed
+                            # but has been processed already
+                            if not req_files[line_req.name]:
+                                logger.warning(
+                                    "Requirement file [%s] contains %s, but "
+                                    "package %r is not installed",
+                                    req_file_path,
+                                    COMMENT_RE.sub('', line).strip(),
+                                    line_req.name
+                                )
+                            else:
+                                req_files[line_req.name].append(req_file_path)
+                        else:
+                            yield str(installations[
+                                line_req_canonical_name]).rstrip()
+                            del installations[line_req_canonical_name]
+                            req_files[line_req.name].append(req_file_path)
+
+        # Warn about requirements that were included multiple times (in a
+        # single requirements file or in different requirements files).
+        for name, files in six.iteritems(req_files):
+            if len(files) > 1:
+                logger.warning("Requirement %s included multiple times [%s]",
+                               name, ', '.join(sorted(set(files))))
+
+        yield(
+            '## The following requirements were added by '
+            'pip freeze:'
+        )
+    for installation in sorted(
+            installations.values(), key=lambda x: x.name.lower()):
+        if installation.canonical_name not in skip:
+            yield str(installation).rstrip()
+
+
+def get_requirement_info(dist):
+    # type: (Distribution) -> RequirementInfo
+    """
+    Compute and return values (req, editable, comments) for use in
+    FrozenRequirement.from_dist().
+    """
+    if not dist_is_editable(dist):
+        return (None, False, [])
+
+    location = os.path.normcase(os.path.abspath(dist.location))
+
+    from pip._internal.vcs import vcs, RemoteNotFoundError
+    vcs_backend = vcs.get_backend_for_dir(location)
+
+    if vcs_backend is None:
+        req = dist.as_requirement()
+        logger.debug(
+            'No VCS found for editable requirement "%s" in: %r', req,
+            location,
+        )
+        comments = [
+            '# Editable install with no version control ({})'.format(req)
+        ]
+        return (location, True, comments)
+
+    try:
+        req = vcs_backend.get_src_requirement(location, dist.project_name)
+    except RemoteNotFoundError:
+        req = dist.as_requirement()
+        comments = [
+            '# Editable {} install with no remote ({})'.format(
+                type(vcs_backend).__name__, req,
+            )
+        ]
+        return (location, True, comments)
+
+    except BadCommand:
+        logger.warning(
+            'cannot determine version of editable source in %s '
+            '(%s command not found in path)',
+            location,
+            vcs_backend.name,
+        )
+        return (None, True, [])
+
+    except InstallationError as exc:
+        logger.warning(
+            "Error when trying to get requirement for VCS system %s, "
+            "falling back to uneditable format", exc
+        )
+    else:
+        if req is not None:
+            return (req, True, [])
+
+    logger.warning(
+        'Could not determine repository location of %s', location
+    )
+    comments = ['## !! Could not determine repository location']
+
+    return (None, False, comments)
+
+
+class FrozenRequirement(object):
+    def __init__(self, name, req, editable, comments=()):
+        # type: (str, Union[str, Requirement], bool, Iterable[str]) -> None
+        self.name = name
+        self.canonical_name = canonicalize_name(name)
+        self.req = req
+        self.editable = editable
+        self.comments = comments
+
+    @classmethod
+    def from_dist(cls, dist):
+        # type: (Distribution) -> FrozenRequirement
+        req, editable, comments = get_requirement_info(dist)
+        if req is None:
+            req = dist.as_requirement()
+
+        return cls(dist.project_name, req, editable, comments=comments)
+
+    def __str__(self):
+        req = self.req
+        if self.editable:
+            req = '-e %s' % req
+        return '\n'.join(list(self.comments) + [str(req)]) + '\n'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..24d6a5dd31fe33b03f90ed0f9ee465253686900c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/__init__.py
@@ -0,0 +1,2 @@
+"""For modules related to installing packages.
+"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py
new file mode 100644
index 0000000000000000000000000000000000000000..a668a61dc60f50963186b5a358e1e581bb6bbf09
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/editable_legacy.py
@@ -0,0 +1,52 @@
+"""Legacy editable installation process, i.e. `setup.py develop`.
+"""
+import logging
+
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.setuptools_build import make_setuptools_develop_args
+from pip._internal.utils.subprocess import call_subprocess
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional, Sequence
+
+    from pip._internal.build_env import BuildEnvironment
+
+
+logger = logging.getLogger(__name__)
+
+
+def install_editable(
+    install_options,  # type: List[str]
+    global_options,  # type: Sequence[str]
+    prefix,  # type: Optional[str]
+    home,  # type: Optional[str]
+    use_user_site,  # type: bool
+    name,  # type: str
+    setup_py_path,  # type: str
+    isolated,  # type: bool
+    build_env,  # type: BuildEnvironment
+    unpacked_source_directory,  # type: str
+):
+    # type: (...) -> None
+    """Install a package in editable mode. Most arguments are pass-through
+    to setuptools.
+    """
+    logger.info('Running setup.py develop for %s', name)
+
+    args = make_setuptools_develop_args(
+        setup_py_path,
+        global_options=global_options,
+        install_options=install_options,
+        no_user_config=isolated,
+        prefix=prefix,
+        home=home,
+        use_user_site=use_user_site,
+    )
+
+    with indent_log():
+        with build_env:
+            call_subprocess(
+                args,
+                cwd=unpacked_source_directory,
+            )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py
new file mode 100644
index 0000000000000000000000000000000000000000..2d4adc4f62c81f0dcb2cd48c340102234052fac7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/legacy.py
@@ -0,0 +1,129 @@
+"""Legacy installation process, i.e. `setup.py install`.
+"""
+
+import logging
+import os
+from distutils.util import change_root
+
+from pip._internal.utils.deprecation import deprecated
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import ensure_dir
+from pip._internal.utils.setuptools_build import make_setuptools_install_args
+from pip._internal.utils.subprocess import runner_with_spinner_message
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional, Sequence
+
+    from pip._internal.models.scheme import Scheme
+    from pip._internal.req.req_install import InstallRequirement
+
+
+logger = logging.getLogger(__name__)
+
+
+def install(
+    install_req,  # type: InstallRequirement
+    install_options,  # type: List[str]
+    global_options,  # type: Sequence[str]
+    root,  # type: Optional[str]
+    home,  # type: Optional[str]
+    prefix,  # type: Optional[str]
+    use_user_site,  # type: bool
+    pycompile,  # type: bool
+    scheme,  # type: Scheme
+):
+    # type: (...) -> None
+    # Extend the list of global and install options passed on to
+    # the setup.py call with the ones from the requirements file.
+    # Options specified in requirements file override those
+    # specified on the command line, since the last option given
+    # to setup.py is the one that is used.
+    global_options = list(global_options) + \
+        install_req.options.get('global_options', [])
+    install_options = list(install_options) + \
+        install_req.options.get('install_options', [])
+
+    header_dir = scheme.headers
+
+    with TempDirectory(kind="record") as temp_dir:
+        record_filename = os.path.join(temp_dir.path, 'install-record.txt')
+        install_args = make_setuptools_install_args(
+            install_req.setup_py_path,
+            global_options=global_options,
+            install_options=install_options,
+            record_filename=record_filename,
+            root=root,
+            prefix=prefix,
+            header_dir=header_dir,
+            home=home,
+            use_user_site=use_user_site,
+            no_user_config=install_req.isolated,
+            pycompile=pycompile,
+        )
+
+        runner = runner_with_spinner_message(
+            "Running setup.py install for {}".format(install_req.name)
+        )
+        with indent_log(), install_req.build_env:
+            runner(
+                cmd=install_args,
+                cwd=install_req.unpacked_source_directory,
+            )
+
+        if not os.path.exists(record_filename):
+            logger.debug('Record file %s not found', record_filename)
+            return
+        install_req.install_succeeded = True
+
+        # We intentionally do not use any encoding to read the file because
+        # setuptools writes the file using distutils.file_util.write_file,
+        # which does not specify an encoding.
+        with open(record_filename) as f:
+            record_lines = f.read().splitlines()
+
+    def prepend_root(path):
+        # type: (str) -> str
+        if root is None or not os.path.isabs(path):
+            return path
+        else:
+            return change_root(root, path)
+
+    for line in record_lines:
+        directory = os.path.dirname(line)
+        if directory.endswith('.egg-info'):
+            egg_info_dir = prepend_root(directory)
+            break
+    else:
+        deprecated(
+            reason=(
+                "{} did not indicate that it installed an "
+                ".egg-info directory. Only setup.py projects "
+                "generating .egg-info directories are supported."
+            ).format(install_req),
+            replacement=(
+                "for maintainers: updating the setup.py of {0}. "
+                "For users: contact the maintainers of {0} to let "
+                "them know to update their setup.py.".format(
+                    install_req.name
+                )
+            ),
+            gone_in="20.2",
+            issue=6998,
+        )
+        # FIXME: put the record somewhere
+        return
+    new_lines = []
+    for line in record_lines:
+        filename = line.strip()
+        if os.path.isdir(filename):
+            filename += os.path.sep
+        new_lines.append(
+            os.path.relpath(prepend_root(filename), egg_info_dir)
+        )
+    new_lines.sort()
+    ensure_dir(egg_info_dir)
+    inst_files_path = os.path.join(egg_info_dir, 'installed-files.txt')
+    with open(inst_files_path, 'w') as f:
+        f.write('\n'.join(new_lines) + '\n')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..aac975c3ac8ebfed2f3d54e229a2d8d28d878865
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/install/wheel.py
@@ -0,0 +1,615 @@
+"""Support for installing and building the "wheel" binary package format.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import collections
+import compileall
+import csv
+import logging
+import os.path
+import re
+import shutil
+import stat
+import sys
+import warnings
+from base64 import urlsafe_b64encode
+from zipfile import ZipFile
+
+from pip._vendor import pkg_resources
+from pip._vendor.distlib.scripts import ScriptMaker
+from pip._vendor.distlib.util import get_export_entry
+from pip._vendor.six import StringIO
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.locations import get_major_minor_version
+from pip._internal.utils.misc import captured_stdout, ensure_dir, hash_file
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.unpacking import unpack_file
+from pip._internal.utils.wheel import parse_wheel
+
+if MYPY_CHECK_RUNNING:
+    from email.message import Message
+    from typing import (
+        Dict, List, Optional, Sequence, Tuple, IO, Text, Any,
+        Iterable, Callable, Set,
+    )
+
+    from pip._internal.models.scheme import Scheme
+
+    InstalledCSVRow = Tuple[str, ...]
+
+
+logger = logging.getLogger(__name__)
+
+
+def normpath(src, p):
+    # type: (str, str) -> str
+    return os.path.relpath(src, p).replace(os.path.sep, '/')
+
+
+def rehash(path, blocksize=1 << 20):
+    # type: (str, int) -> Tuple[str, str]
+    """Return (encoded_digest, length) for path using hashlib.sha256()"""
+    h, length = hash_file(path, blocksize)
+    digest = 'sha256=' + urlsafe_b64encode(
+        h.digest()
+    ).decode('latin1').rstrip('=')
+    # unicode/str python2 issues
+    return (digest, str(length))  # type: ignore
+
+
+def open_for_csv(name, mode):
+    # type: (str, Text) -> IO[Any]
+    if sys.version_info[0] < 3:
+        nl = {}  # type: Dict[str, Any]
+        bin = 'b'
+    else:
+        nl = {'newline': ''}  # type: Dict[str, Any]
+        bin = ''
+    return open(name, mode + bin, **nl)
+
+
+def fix_script(path):
+    # type: (str) -> Optional[bool]
+    """Replace #!python with #!/path/to/python
+    Return True if file was changed.
+    """
+    # XXX RECORD hashes will need to be updated
+    if os.path.isfile(path):
+        with open(path, 'rb') as script:
+            firstline = script.readline()
+            if not firstline.startswith(b'#!python'):
+                return False
+            exename = sys.executable.encode(sys.getfilesystemencoding())
+            firstline = b'#!' + exename + os.linesep.encode("ascii")
+            rest = script.read()
+        with open(path, 'wb') as script:
+            script.write(firstline)
+            script.write(rest)
+        return True
+    return None
+
+
+def wheel_root_is_purelib(metadata):
+    # type: (Message) -> bool
+    return metadata.get("Root-Is-Purelib", "").lower() == "true"
+
+
+def get_entrypoints(filename):
+    # type: (str) -> Tuple[Dict[str, str], Dict[str, str]]
+    if not os.path.exists(filename):
+        return {}, {}
+
+    # This is done because you can pass a string to entry_points wrappers which
+    # means that they may or may not be valid INI files. The attempt here is to
+    # strip leading and trailing whitespace in order to make them valid INI
+    # files.
+    with open(filename) as fp:
+        data = StringIO()
+        for line in fp:
+            data.write(line.strip())
+            data.write("\n")
+        data.seek(0)
+
+    # get the entry points and then the script names
+    entry_points = pkg_resources.EntryPoint.parse_map(data)
+    console = entry_points.get('console_scripts', {})
+    gui = entry_points.get('gui_scripts', {})
+
+    def _split_ep(s):
+        # type: (pkg_resources.EntryPoint) -> Tuple[str, str]
+        """get the string representation of EntryPoint,
+        remove space and split on '='
+        """
+        split_parts = str(s).replace(" ", "").split("=")
+        return split_parts[0], split_parts[1]
+
+    # convert the EntryPoint objects into strings with module:function
+    console = dict(_split_ep(v) for v in console.values())
+    gui = dict(_split_ep(v) for v in gui.values())
+    return console, gui
+
+
+def message_about_scripts_not_on_PATH(scripts):
+    # type: (Sequence[str]) -> Optional[str]
+    """Determine if any scripts are not on PATH and format a warning.
+    Returns a warning message if one or more scripts are not on PATH,
+    otherwise None.
+    """
+    if not scripts:
+        return None
+
+    # Group scripts by the path they were installed in
+    grouped_by_dir = collections.defaultdict(set)  # type: Dict[str, Set[str]]
+    for destfile in scripts:
+        parent_dir = os.path.dirname(destfile)
+        script_name = os.path.basename(destfile)
+        grouped_by_dir[parent_dir].add(script_name)
+
+    # We don't want to warn for directories that are on PATH.
+    not_warn_dirs = [
+        os.path.normcase(i).rstrip(os.sep) for i in
+        os.environ.get("PATH", "").split(os.pathsep)
+    ]
+    # If an executable sits with sys.executable, we don't warn for it.
+    #     This covers the case of venv invocations without activating the venv.
+    not_warn_dirs.append(os.path.normcase(os.path.dirname(sys.executable)))
+    warn_for = {
+        parent_dir: scripts for parent_dir, scripts in grouped_by_dir.items()
+        if os.path.normcase(parent_dir) not in not_warn_dirs
+    }  # type: Dict[str, Set[str]]
+    if not warn_for:
+        return None
+
+    # Format a message
+    msg_lines = []
+    for parent_dir, dir_scripts in warn_for.items():
+        sorted_scripts = sorted(dir_scripts)  # type: List[str]
+        if len(sorted_scripts) == 1:
+            start_text = "script {} is".format(sorted_scripts[0])
+        else:
+            start_text = "scripts {} are".format(
+                ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1]
+            )
+
+        msg_lines.append(
+            "The {} installed in '{}' which is not on PATH."
+            .format(start_text, parent_dir)
+        )
+
+    last_line_fmt = (
+        "Consider adding {} to PATH or, if you prefer "
+        "to suppress this warning, use --no-warn-script-location."
+    )
+    if len(msg_lines) == 1:
+        msg_lines.append(last_line_fmt.format("this directory"))
+    else:
+        msg_lines.append(last_line_fmt.format("these directories"))
+
+    # Add a note if any directory starts with ~
+    warn_for_tilde = any(
+        i[0] == "~" for i in os.environ.get("PATH", "").split(os.pathsep) if i
+    )
+    if warn_for_tilde:
+        tilde_warning_msg = (
+            "NOTE: The current PATH contains path(s) starting with `~`, "
+            "which may not be expanded by all applications."
+        )
+        msg_lines.append(tilde_warning_msg)
+
+    # Returns the formatted multiline message
+    return "\n".join(msg_lines)
+
+
+def sorted_outrows(outrows):
+    # type: (Iterable[InstalledCSVRow]) -> List[InstalledCSVRow]
+    """Return the given rows of a RECORD file in sorted order.
+
+    Each row is a 3-tuple (path, hash, size) and corresponds to a record of
+    a RECORD file (see PEP 376 and PEP 427 for details).  For the rows
+    passed to this function, the size can be an integer as an int or string,
+    or the empty string.
+    """
+    # Normally, there should only be one row per path, in which case the
+    # second and third elements don't come into play when sorting.
+    # However, in cases in the wild where a path might happen to occur twice,
+    # we don't want the sort operation to trigger an error (but still want
+    # determinism).  Since the third element can be an int or string, we
+    # coerce each element to a string to avoid a TypeError in this case.
+    # For additional background, see--
+    # https://github.com/pypa/pip/issues/5868
+    return sorted(outrows, key=lambda row: tuple(str(x) for x in row))
+
+
+def get_csv_rows_for_installed(
+    old_csv_rows,  # type: Iterable[List[str]]
+    installed,  # type: Dict[str, str]
+    changed,  # type: Set[str]
+    generated,  # type: List[str]
+    lib_dir,  # type: str
+):
+    # type: (...) -> List[InstalledCSVRow]
+    """
+    :param installed: A map from archive RECORD path to installation RECORD
+        path.
+    """
+    installed_rows = []  # type: List[InstalledCSVRow]
+    for row in old_csv_rows:
+        if len(row) > 3:
+            logger.warning(
+                'RECORD line has more than three elements: {}'.format(row)
+            )
+        # Make a copy because we are mutating the row.
+        row = list(row)
+        old_path = row[0]
+        new_path = installed.pop(old_path, old_path)
+        row[0] = new_path
+        if new_path in changed:
+            digest, length = rehash(new_path)
+            row[1] = digest
+            row[2] = length
+        installed_rows.append(tuple(row))
+    for f in generated:
+        digest, length = rehash(f)
+        installed_rows.append((normpath(f, lib_dir), digest, str(length)))
+    for f in installed:
+        installed_rows.append((installed[f], '', ''))
+    return installed_rows
+
+
+class MissingCallableSuffix(Exception):
+    pass
+
+
+def _raise_for_invalid_entrypoint(specification):
+    # type: (str) -> None
+    entry = get_export_entry(specification)
+    if entry is not None and entry.suffix is None:
+        raise MissingCallableSuffix(str(entry))
+
+
+class PipScriptMaker(ScriptMaker):
+    def make(self, specification, options=None):
+        # type: (str, Dict[str, Any]) -> List[str]
+        _raise_for_invalid_entrypoint(specification)
+        return super(PipScriptMaker, self).make(specification, options)
+
+
+def install_unpacked_wheel(
+    name,  # type: str
+    wheeldir,  # type: str
+    wheel_zip,  # type: ZipFile
+    scheme,  # type: Scheme
+    req_description,  # type: str
+    pycompile=True,  # type: bool
+    warn_script_location=True  # type: bool
+):
+    # type: (...) -> None
+    """Install a wheel.
+
+    :param name: Name of the project to install
+    :param wheeldir: Base directory of the unpacked wheel
+    :param wheel_zip: open ZipFile for wheel being installed
+    :param scheme: Distutils scheme dictating the install directories
+    :param req_description: String used in place of the requirement, for
+        logging
+    :param pycompile: Whether to byte-compile installed Python files
+    :param warn_script_location: Whether to check that scripts are installed
+        into a directory on PATH
+    :raises UnsupportedWheel:
+        * when the directory holds an unpacked wheel with incompatible
+          Wheel-Version
+        * when the .dist-info dir does not match the wheel
+    """
+    # TODO: Investigate and break this up.
+    # TODO: Look into moving this into a dedicated class for representing an
+    #       installation.
+
+    source = wheeldir.rstrip(os.path.sep) + os.path.sep
+
+    info_dir, metadata = parse_wheel(wheel_zip, name)
+
+    if wheel_root_is_purelib(metadata):
+        lib_dir = scheme.purelib
+    else:
+        lib_dir = scheme.platlib
+
+    subdirs = os.listdir(source)
+    data_dirs = [s for s in subdirs if s.endswith('.data')]
+
+    # Record details of the files moved
+    #   installed = files copied from the wheel to the destination
+    #   changed = files changed while installing (scripts #! line typically)
+    #   generated = files newly generated during the install (script wrappers)
+    installed = {}  # type: Dict[str, str]
+    changed = set()
+    generated = []  # type: List[str]
+
+    # Compile all of the pyc files that we're going to be installing
+    if pycompile:
+        with captured_stdout() as stdout:
+            with warnings.catch_warnings():
+                warnings.filterwarnings('ignore')
+                compileall.compile_dir(source, force=True, quiet=True)
+        logger.debug(stdout.getvalue())
+
+    def record_installed(srcfile, destfile, modified=False):
+        # type: (str, str, bool) -> None
+        """Map archive RECORD paths to installation RECORD paths."""
+        oldpath = normpath(srcfile, wheeldir)
+        newpath = normpath(destfile, lib_dir)
+        installed[oldpath] = newpath
+        if modified:
+            changed.add(destfile)
+
+    def clobber(
+            source,  # type: str
+            dest,  # type: str
+            is_base,  # type: bool
+            fixer=None,  # type: Optional[Callable[[str], Any]]
+            filter=None  # type: Optional[Callable[[str], bool]]
+    ):
+        # type: (...) -> None
+        ensure_dir(dest)  # common for the 'include' path
+
+        for dir, subdirs, files in os.walk(source):
+            basedir = dir[len(source):].lstrip(os.path.sep)
+            destdir = os.path.join(dest, basedir)
+            if is_base and basedir == '':
+                subdirs[:] = [s for s in subdirs if not s.endswith('.data')]
+            for f in files:
+                # Skip unwanted files
+                if filter and filter(f):
+                    continue
+                srcfile = os.path.join(dir, f)
+                destfile = os.path.join(dest, basedir, f)
+                # directory creation is lazy and after the file filtering above
+                # to ensure we don't install empty dirs; empty dirs can't be
+                # uninstalled.
+                ensure_dir(destdir)
+
+                # copyfile (called below) truncates the destination if it
+                # exists and then writes the new contents. This is fine in most
+                # cases, but can cause a segfault if pip has loaded a shared
+                # object (e.g. from pyopenssl through its vendored urllib3)
+                # Since the shared object is mmap'd an attempt to call a
+                # symbol in it will then cause a segfault. Unlinking the file
+                # allows writing of new contents while allowing the process to
+                # continue to use the old copy.
+                if os.path.exists(destfile):
+                    os.unlink(destfile)
+
+                # We use copyfile (not move, copy, or copy2) to be extra sure
+                # that we are not moving directories over (copyfile fails for
+                # directories) as well as to ensure that we are not copying
+                # over any metadata because we want more control over what
+                # metadata we actually copy over.
+                shutil.copyfile(srcfile, destfile)
+
+                # Copy over the metadata for the file, currently this only
+                # includes the atime and mtime.
+                st = os.stat(srcfile)
+                if hasattr(os, "utime"):
+                    os.utime(destfile, (st.st_atime, st.st_mtime))
+
+                # If our file is executable, then make our destination file
+                # executable.
+                if os.access(srcfile, os.X_OK):
+                    st = os.stat(srcfile)
+                    permissions = (
+                        st.st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH
+                    )
+                    os.chmod(destfile, permissions)
+
+                changed = False
+                if fixer:
+                    changed = fixer(destfile)
+                record_installed(srcfile, destfile, changed)
+
+    clobber(source, lib_dir, True)
+
+    dest_info_dir = os.path.join(lib_dir, info_dir)
+
+    # Get the defined entry points
+    ep_file = os.path.join(dest_info_dir, 'entry_points.txt')
+    console, gui = get_entrypoints(ep_file)
+
+    def is_entrypoint_wrapper(name):
+        # type: (str) -> bool
+        # EP, EP.exe and EP-script.py are scripts generated for
+        # entry point EP by setuptools
+        if name.lower().endswith('.exe'):
+            matchname = name[:-4]
+        elif name.lower().endswith('-script.py'):
+            matchname = name[:-10]
+        elif name.lower().endswith(".pya"):
+            matchname = name[:-4]
+        else:
+            matchname = name
+        # Ignore setuptools-generated scripts
+        return (matchname in console or matchname in gui)
+
+    for datadir in data_dirs:
+        fixer = None
+        filter = None
+        for subdir in os.listdir(os.path.join(wheeldir, datadir)):
+            fixer = None
+            if subdir == 'scripts':
+                fixer = fix_script
+                filter = is_entrypoint_wrapper
+            source = os.path.join(wheeldir, datadir, subdir)
+            dest = getattr(scheme, subdir)
+            clobber(source, dest, False, fixer=fixer, filter=filter)
+
+    maker = PipScriptMaker(None, scheme.scripts)
+
+    # Ensure old scripts are overwritten.
+    # See https://github.com/pypa/pip/issues/1800
+    maker.clobber = True
+
+    # Ensure we don't generate any variants for scripts because this is almost
+    # never what somebody wants.
+    # See https://bitbucket.org/pypa/distlib/issue/35/
+    maker.variants = {''}
+
+    # This is required because otherwise distlib creates scripts that are not
+    # executable.
+    # See https://bitbucket.org/pypa/distlib/issue/32/
+    maker.set_mode = True
+
+    scripts_to_generate = []
+
+    # Special case pip and setuptools to generate versioned wrappers
+    #
+    # The issue is that some projects (specifically, pip and setuptools) use
+    # code in setup.py to create "versioned" entry points - pip2.7 on Python
+    # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into
+    # the wheel metadata at build time, and so if the wheel is installed with
+    # a *different* version of Python the entry points will be wrong. The
+    # correct fix for this is to enhance the metadata to be able to describe
+    # such versioned entry points, but that won't happen till Metadata 2.0 is
+    # available.
+    # In the meantime, projects using versioned entry points will either have
+    # incorrect versioned entry points, or they will not be able to distribute
+    # "universal" wheels (i.e., they will need a wheel per Python version).
+    #
+    # Because setuptools and pip are bundled with _ensurepip and virtualenv,
+    # we need to use universal wheels. So, as a stopgap until Metadata 2.0, we
+    # override the versioned entry points in the wheel and generate the
+    # correct ones. This code is purely a short-term measure until Metadata 2.0
+    # is available.
+    #
+    # To add the level of hack in this section of code, in order to support
+    # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment
+    # variable which will control which version scripts get installed.
+    #
+    # ENSUREPIP_OPTIONS=altinstall
+    #   - Only pipX.Y and easy_install-X.Y will be generated and installed
+    # ENSUREPIP_OPTIONS=install
+    #   - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note
+    #     that this option is technically if ENSUREPIP_OPTIONS is set and is
+    #     not altinstall
+    # DEFAULT
+    #   - The default behavior is to install pip, pipX, pipX.Y, easy_install
+    #     and easy_install-X.Y.
+    pip_script = console.pop('pip', None)
+    if pip_script:
+        if "ENSUREPIP_OPTIONS" not in os.environ:
+            scripts_to_generate.append('pip = ' + pip_script)
+
+        if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall":
+            scripts_to_generate.append(
+                'pip%s = %s' % (sys.version_info[0], pip_script)
+            )
+
+        scripts_to_generate.append(
+            'pip%s = %s' % (get_major_minor_version(), pip_script)
+        )
+        # Delete any other versioned pip entry points
+        pip_ep = [k for k in console if re.match(r'pip(\d(\.\d)?)?$', k)]
+        for k in pip_ep:
+            del console[k]
+    easy_install_script = console.pop('easy_install', None)
+    if easy_install_script:
+        if "ENSUREPIP_OPTIONS" not in os.environ:
+            scripts_to_generate.append(
+                'easy_install = ' + easy_install_script
+            )
+
+        scripts_to_generate.append(
+            'easy_install-%s = %s' % (
+                get_major_minor_version(), easy_install_script
+            )
+        )
+        # Delete any other versioned easy_install entry points
+        easy_install_ep = [
+            k for k in console if re.match(r'easy_install(-\d\.\d)?$', k)
+        ]
+        for k in easy_install_ep:
+            del console[k]
+
+    # Generate the console and GUI entry points specified in the wheel
+    scripts_to_generate.extend(
+        '%s = %s' % kv for kv in console.items()
+    )
+
+    gui_scripts_to_generate = [
+        '%s = %s' % kv for kv in gui.items()
+    ]
+
+    generated_console_scripts = []  # type: List[str]
+
+    try:
+        generated_console_scripts = maker.make_multiple(scripts_to_generate)
+        generated.extend(generated_console_scripts)
+
+        generated.extend(
+            maker.make_multiple(gui_scripts_to_generate, {'gui': True})
+        )
+    except MissingCallableSuffix as e:
+        entry = e.args[0]
+        raise InstallationError(
+            "Invalid script entry point: {} for req: {} - A callable "
+            "suffix is required. Cf https://packaging.python.org/"
+            "specifications/entry-points/#use-for-scripts for more "
+            "information.".format(entry, req_description)
+        )
+
+    if warn_script_location:
+        msg = message_about_scripts_not_on_PATH(generated_console_scripts)
+        if msg is not None:
+            logger.warning(msg)
+
+    # Record pip as the installer
+    installer = os.path.join(dest_info_dir, 'INSTALLER')
+    temp_installer = os.path.join(dest_info_dir, 'INSTALLER.pip')
+    with open(temp_installer, 'wb') as installer_file:
+        installer_file.write(b'pip\n')
+    shutil.move(temp_installer, installer)
+    generated.append(installer)
+
+    # Record details of all files installed
+    record = os.path.join(dest_info_dir, 'RECORD')
+    temp_record = os.path.join(dest_info_dir, 'RECORD.pip')
+    with open_for_csv(record, 'r') as record_in:
+        with open_for_csv(temp_record, 'w+') as record_out:
+            reader = csv.reader(record_in)
+            outrows = get_csv_rows_for_installed(
+                reader, installed=installed, changed=changed,
+                generated=generated, lib_dir=lib_dir,
+            )
+            writer = csv.writer(record_out)
+            # Sort to simplify testing.
+            for row in sorted_outrows(outrows):
+                writer.writerow(row)
+    shutil.move(temp_record, record)
+
+
+def install_wheel(
+    name,  # type: str
+    wheel_path,  # type: str
+    scheme,  # type: Scheme
+    req_description,  # type: str
+    pycompile=True,  # type: bool
+    warn_script_location=True,  # type: bool
+    _temp_dir_for_testing=None,  # type: Optional[str]
+):
+    # type: (...) -> None
+    with TempDirectory(
+        path=_temp_dir_for_testing, kind="unpacked-wheel"
+    ) as unpacked_dir, ZipFile(wheel_path, allowZip64=True) as z:
+        unpack_file(wheel_path, unpacked_dir.path)
+        install_unpacked_wheel(
+            name=name,
+            wheeldir=unpacked_dir.path,
+            wheel_zip=z,
+            scheme=scheme,
+            req_description=req_description,
+            pycompile=pycompile,
+            warn_script_location=warn_script_location,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py
new file mode 100644
index 0000000000000000000000000000000000000000..0b61f20524d976cd2bdc2fbc0a7e32bf13729d41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/operations/prepare.py
@@ -0,0 +1,591 @@
+"""Prepares a distribution for installation
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import logging
+import mimetypes
+import os
+import shutil
+import sys
+
+from pip._vendor import requests
+from pip._vendor.six import PY2
+
+from pip._internal.distributions import (
+    make_distribution_for_install_requirement,
+)
+from pip._internal.distributions.installed import InstalledDistribution
+from pip._internal.exceptions import (
+    DirectoryUrlHashUnsupported,
+    HashMismatch,
+    HashUnpinned,
+    InstallationError,
+    PreviousBuildDirError,
+    VcsHashUnsupported,
+)
+from pip._internal.utils.filesystem import copy2_fixed
+from pip._internal.utils.hashes import MissingHashes
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.marker_files import write_delete_marker_file
+from pip._internal.utils.misc import (
+    ask_path_exists,
+    backup_dir,
+    display_path,
+    hide_url,
+    path_to_display,
+    rmtree,
+)
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.unpacking import unpack_file
+from pip._internal.vcs import vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Callable, List, Optional, Tuple,
+    )
+
+    from mypy_extensions import TypedDict
+
+    from pip._internal.distributions import AbstractDistribution
+    from pip._internal.index.package_finder import PackageFinder
+    from pip._internal.models.link import Link
+    from pip._internal.network.download import Downloader
+    from pip._internal.req.req_install import InstallRequirement
+    from pip._internal.req.req_tracker import RequirementTracker
+    from pip._internal.utils.hashes import Hashes
+
+    if PY2:
+        CopytreeKwargs = TypedDict(
+            'CopytreeKwargs',
+            {
+                'ignore': Callable[[str, List[str]], List[str]],
+                'symlinks': bool,
+            },
+            total=False,
+        )
+    else:
+        CopytreeKwargs = TypedDict(
+            'CopytreeKwargs',
+            {
+                'copy_function': Callable[[str, str], None],
+                'ignore': Callable[[str, List[str]], List[str]],
+                'ignore_dangling_symlinks': bool,
+                'symlinks': bool,
+            },
+            total=False,
+        )
+
+logger = logging.getLogger(__name__)
+
+
+def _get_prepared_distribution(
+        req,  # type: InstallRequirement
+        req_tracker,  # type: RequirementTracker
+        finder,  # type: PackageFinder
+        build_isolation  # type: bool
+):
+    # type: (...) -> AbstractDistribution
+    """Prepare a distribution for installation.
+    """
+    abstract_dist = make_distribution_for_install_requirement(req)
+    with req_tracker.track(req):
+        abstract_dist.prepare_distribution_metadata(finder, build_isolation)
+    return abstract_dist
+
+
+def unpack_vcs_link(link, location):
+    # type: (Link, str) -> None
+    vcs_backend = vcs.get_backend_for_scheme(link.scheme)
+    assert vcs_backend is not None
+    vcs_backend.unpack(location, url=hide_url(link.url))
+
+
+def _copy_file(filename, location, link):
+    # type: (str, str, Link) -> None
+    copy = True
+    download_location = os.path.join(location, link.filename)
+    if os.path.exists(download_location):
+        response = ask_path_exists(
+            'The file {} exists. (i)gnore, (w)ipe, (b)ackup, (a)abort'.format(
+                display_path(download_location)
+            ),
+            ('i', 'w', 'b', 'a'),
+        )
+        if response == 'i':
+            copy = False
+        elif response == 'w':
+            logger.warning('Deleting %s', display_path(download_location))
+            os.remove(download_location)
+        elif response == 'b':
+            dest_file = backup_dir(download_location)
+            logger.warning(
+                'Backing up %s to %s',
+                display_path(download_location),
+                display_path(dest_file),
+            )
+            shutil.move(download_location, dest_file)
+        elif response == 'a':
+            sys.exit(-1)
+    if copy:
+        shutil.copy(filename, download_location)
+        logger.info('Saved %s', display_path(download_location))
+
+
+def unpack_http_url(
+    link,  # type: Link
+    location,  # type: str
+    downloader,  # type: Downloader
+    download_dir=None,  # type: Optional[str]
+    hashes=None,  # type: Optional[Hashes]
+):
+    # type: (...) -> str
+    temp_dir = TempDirectory(kind="unpack", globally_managed=True)
+    # If a download dir is specified, is the file already downloaded there?
+    already_downloaded_path = None
+    if download_dir:
+        already_downloaded_path = _check_download_dir(
+            link, download_dir, hashes
+        )
+
+    if already_downloaded_path:
+        from_path = already_downloaded_path
+        content_type = mimetypes.guess_type(from_path)[0]
+    else:
+        # let's download to a tmp dir
+        from_path, content_type = _download_http_url(
+            link, downloader, temp_dir.path, hashes
+        )
+
+    # unpack the archive to the build dir location. even when only
+    # downloading archives, they have to be unpacked to parse dependencies
+    unpack_file(from_path, location, content_type)
+
+    return from_path
+
+
+def _copy2_ignoring_special_files(src, dest):
+    # type: (str, str) -> None
+    """Copying special files is not supported, but as a convenience to users
+    we skip errors copying them. This supports tools that may create e.g.
+    socket files in the project source directory.
+    """
+    try:
+        copy2_fixed(src, dest)
+    except shutil.SpecialFileError as e:
+        # SpecialFileError may be raised due to either the source or
+        # destination. If the destination was the cause then we would actually
+        # care, but since the destination directory is deleted prior to
+        # copy we ignore all of them assuming it is caused by the source.
+        logger.warning(
+            "Ignoring special file error '%s' encountered copying %s to %s.",
+            str(e),
+            path_to_display(src),
+            path_to_display(dest),
+        )
+
+
+def _copy_source_tree(source, target):
+    # type: (str, str) -> None
+    def ignore(d, names):
+        # type: (str, List[str]) -> List[str]
+        # Pulling in those directories can potentially be very slow,
+        # exclude the following directories if they appear in the top
+        # level dir (and only it).
+        # See discussion at https://github.com/pypa/pip/pull/6770
+        return ['.tox', '.nox'] if d == source else []
+
+    kwargs = dict(ignore=ignore, symlinks=True)  # type: CopytreeKwargs
+
+    if not PY2:
+        # Python 2 does not support copy_function, so we only ignore
+        # errors on special file copy in Python 3.
+        kwargs['copy_function'] = _copy2_ignoring_special_files
+
+    shutil.copytree(source, target, **kwargs)
+
+
+def unpack_file_url(
+    link,  # type: Link
+    location,  # type: str
+    download_dir=None,  # type: Optional[str]
+    hashes=None  # type: Optional[Hashes]
+):
+    # type: (...) -> Optional[str]
+    """Unpack link into location.
+    """
+    link_path = link.file_path
+    # If it's a url to a local directory
+    if link.is_existing_dir():
+        if os.path.isdir(location):
+            rmtree(location)
+        _copy_source_tree(link_path, location)
+        return None
+
+    # If a download dir is specified, is the file already there and valid?
+    already_downloaded_path = None
+    if download_dir:
+        already_downloaded_path = _check_download_dir(
+            link, download_dir, hashes
+        )
+
+    if already_downloaded_path:
+        from_path = already_downloaded_path
+    else:
+        from_path = link_path
+
+    # If --require-hashes is off, `hashes` is either empty, the
+    # link's embedded hash, or MissingHashes; it is required to
+    # match. If --require-hashes is on, we are satisfied by any
+    # hash in `hashes` matching: a URL-based or an option-based
+    # one; no internet-sourced hash will be in `hashes`.
+    if hashes:
+        hashes.check_against_path(from_path)
+
+    content_type = mimetypes.guess_type(from_path)[0]
+
+    # unpack the archive to the build dir location. even when only downloading
+    # archives, they have to be unpacked to parse dependencies
+    unpack_file(from_path, location, content_type)
+
+    return from_path
+
+
+def unpack_url(
+    link,  # type: Link
+    location,  # type: str
+    downloader,  # type: Downloader
+    download_dir=None,  # type: Optional[str]
+    hashes=None,  # type: Optional[Hashes]
+):
+    # type: (...) -> Optional[str]
+    """Unpack link into location, downloading if required.
+
+    :param hashes: A Hashes object, one of whose embedded hashes must match,
+        or HashMismatch will be raised. If the Hashes is empty, no matches are
+        required, and unhashable types of requirements (like VCS ones, which
+        would ordinarily raise HashUnsupported) are allowed.
+    """
+    # non-editable vcs urls
+    if link.is_vcs:
+        unpack_vcs_link(link, location)
+        return None
+
+    # file urls
+    elif link.is_file:
+        return unpack_file_url(link, location, download_dir, hashes=hashes)
+
+    # http urls
+    else:
+        return unpack_http_url(
+            link,
+            location,
+            downloader,
+            download_dir,
+            hashes=hashes,
+        )
+
+
+def _download_http_url(
+    link,  # type: Link
+    downloader,  # type: Downloader
+    temp_dir,  # type: str
+    hashes,  # type: Optional[Hashes]
+):
+    # type: (...) -> Tuple[str, str]
+    """Download link url into temp_dir using provided session"""
+    download = downloader(link)
+
+    file_path = os.path.join(temp_dir, download.filename)
+    with open(file_path, 'wb') as content_file:
+        for chunk in download.chunks:
+            content_file.write(chunk)
+
+    if hashes:
+        hashes.check_against_path(file_path)
+
+    return file_path, download.response.headers.get('content-type', '')
+
+
+def _check_download_dir(link, download_dir, hashes):
+    # type: (Link, str, Optional[Hashes]) -> Optional[str]
+    """ Check download_dir for previously downloaded file with correct hash
+        If a correct file is found return its path else None
+    """
+    download_path = os.path.join(download_dir, link.filename)
+
+    if not os.path.exists(download_path):
+        return None
+
+    # If already downloaded, does its hash match?
+    logger.info('File was already downloaded %s', download_path)
+    if hashes:
+        try:
+            hashes.check_against_path(download_path)
+        except HashMismatch:
+            logger.warning(
+                'Previously-downloaded file %s has bad hash. '
+                'Re-downloading.',
+                download_path
+            )
+            os.unlink(download_path)
+            return None
+    return download_path
+
+
+class RequirementPreparer(object):
+    """Prepares a Requirement
+    """
+
+    def __init__(
+        self,
+        build_dir,  # type: str
+        download_dir,  # type: Optional[str]
+        src_dir,  # type: str
+        wheel_download_dir,  # type: Optional[str]
+        build_isolation,  # type: bool
+        req_tracker,  # type: RequirementTracker
+        downloader,  # type: Downloader
+        finder,  # type: PackageFinder
+        require_hashes,  # type: bool
+        use_user_site,  # type: bool
+    ):
+        # type: (...) -> None
+        super(RequirementPreparer, self).__init__()
+
+        self.src_dir = src_dir
+        self.build_dir = build_dir
+        self.req_tracker = req_tracker
+        self.downloader = downloader
+        self.finder = finder
+
+        # Where still-packed archives should be written to. If None, they are
+        # not saved, and are deleted immediately after unpacking.
+        self.download_dir = download_dir
+
+        # Where still-packed .whl files should be written to. If None, they are
+        # written to the download_dir parameter. Separate to download_dir to
+        # permit only keeping wheel archives for pip wheel.
+        self.wheel_download_dir = wheel_download_dir
+
+        # NOTE
+        # download_dir and wheel_download_dir overlap semantically and may
+        # be combined if we're willing to have non-wheel archives present in
+        # the wheelhouse output by 'pip wheel'.
+
+        # Is build isolation allowed?
+        self.build_isolation = build_isolation
+
+        # Should hash-checking be required?
+        self.require_hashes = require_hashes
+
+        # Should install in user site-packages?
+        self.use_user_site = use_user_site
+
+    @property
+    def _download_should_save(self):
+        # type: () -> bool
+        if not self.download_dir:
+            return False
+
+        if os.path.exists(self.download_dir):
+            return True
+
+        logger.critical('Could not find download directory')
+        raise InstallationError(
+            "Could not find or access download directory '{}'"
+            .format(self.download_dir))
+
+    def prepare_linked_requirement(
+        self,
+        req,  # type: InstallRequirement
+    ):
+        # type: (...) -> AbstractDistribution
+        """Prepare a requirement that would be obtained from req.link
+        """
+        assert req.link
+        link = req.link
+
+        # TODO: Breakup into smaller functions
+        if link.scheme == 'file':
+            path = link.file_path
+            logger.info('Processing %s', display_path(path))
+        else:
+            logger.info('Collecting %s', req.req or req)
+
+        with indent_log():
+            # @@ if filesystem packages are not marked
+            # editable in a req, a non deterministic error
+            # occurs when the script attempts to unpack the
+            # build directory
+            # Since source_dir is only set for editable requirements.
+            assert req.source_dir is None
+            req.ensure_has_source_dir(self.build_dir)
+            # If a checkout exists, it's unwise to keep going.  version
+            # inconsistencies are logged later, but do not fail the
+            # installation.
+            # FIXME: this won't upgrade when there's an existing
+            # package unpacked in `req.source_dir`
+            if os.path.exists(os.path.join(req.source_dir, 'setup.py')):
+                raise PreviousBuildDirError(
+                    "pip can't proceed with requirements '{}' due to a"
+                    " pre-existing build directory ({}). This is "
+                    "likely due to a previous installation that failed"
+                    ". pip is being responsible and not assuming it "
+                    "can delete this. Please delete it and try again."
+                    .format(req, req.source_dir)
+                )
+
+            # Now that we have the real link, we can tell what kind of
+            # requirements we have and raise some more informative errors
+            # than otherwise. (For example, we can raise VcsHashUnsupported
+            # for a VCS URL rather than HashMissing.)
+            if self.require_hashes:
+                # We could check these first 2 conditions inside
+                # unpack_url and save repetition of conditions, but then
+                # we would report less-useful error messages for
+                # unhashable requirements, complaining that there's no
+                # hash provided.
+                if link.is_vcs:
+                    raise VcsHashUnsupported()
+                elif link.is_existing_dir():
+                    raise DirectoryUrlHashUnsupported()
+                if not req.original_link and not req.is_pinned:
+                    # Unpinned packages are asking for trouble when a new
+                    # version is uploaded. This isn't a security check, but
+                    # it saves users a surprising hash mismatch in the
+                    # future.
+                    #
+                    # file:/// URLs aren't pinnable, so don't complain
+                    # about them not being pinned.
+                    raise HashUnpinned()
+
+            hashes = req.hashes(trust_internet=not self.require_hashes)
+            if self.require_hashes and not hashes:
+                # Known-good hashes are missing for this requirement, so
+                # shim it with a facade object that will provoke hash
+                # computation and then raise a HashMissing exception
+                # showing the user what the hash should be.
+                hashes = MissingHashes()
+
+            download_dir = self.download_dir
+            if link.is_wheel and self.wheel_download_dir:
+                # when doing 'pip wheel` we download wheels to a
+                # dedicated dir.
+                download_dir = self.wheel_download_dir
+
+            try:
+                local_path = unpack_url(
+                    link, req.source_dir, self.downloader, download_dir,
+                    hashes=hashes,
+                )
+            except requests.HTTPError as exc:
+                logger.critical(
+                    'Could not install requirement %s because of error %s',
+                    req,
+                    exc,
+                )
+                raise InstallationError(
+                    'Could not install requirement {} because of HTTP '
+                    'error {} for URL {}'.format(req, exc, link)
+                )
+
+            # For use in later processing, preserve the file path on the
+            # requirement.
+            if local_path:
+                req.local_file_path = local_path
+
+            if link.is_wheel:
+                if download_dir:
+                    # When downloading, we only unpack wheels to get
+                    # metadata.
+                    autodelete_unpacked = True
+                else:
+                    # When installing a wheel, we use the unpacked
+                    # wheel.
+                    autodelete_unpacked = False
+            else:
+                # We always delete unpacked sdists after pip runs.
+                autodelete_unpacked = True
+            if autodelete_unpacked:
+                write_delete_marker_file(req.source_dir)
+
+            abstract_dist = _get_prepared_distribution(
+                req, self.req_tracker, self.finder, self.build_isolation,
+            )
+
+            if download_dir:
+                if link.is_existing_dir():
+                    logger.info('Link is a directory, ignoring download_dir')
+                elif local_path and not os.path.exists(
+                    os.path.join(download_dir, link.filename)
+                ):
+                    _copy_file(local_path, download_dir, link)
+
+            if self._download_should_save:
+                # Make a .zip of the source_dir we already created.
+                if link.is_vcs:
+                    req.archive(self.download_dir)
+        return abstract_dist
+
+    def prepare_editable_requirement(
+        self,
+        req,  # type: InstallRequirement
+    ):
+        # type: (...) -> AbstractDistribution
+        """Prepare an editable requirement
+        """
+        assert req.editable, "cannot prepare a non-editable req as editable"
+
+        logger.info('Obtaining %s', req)
+
+        with indent_log():
+            if self.require_hashes:
+                raise InstallationError(
+                    'The editable requirement {} cannot be installed when '
+                    'requiring hashes, because there is no single file to '
+                    'hash.'.format(req)
+                )
+            req.ensure_has_source_dir(self.src_dir)
+            req.update_editable(not self._download_should_save)
+
+            abstract_dist = _get_prepared_distribution(
+                req, self.req_tracker, self.finder, self.build_isolation,
+            )
+
+            if self._download_should_save:
+                req.archive(self.download_dir)
+            req.check_if_exists(self.use_user_site)
+
+        return abstract_dist
+
+    def prepare_installed_requirement(
+        self,
+        req,  # type: InstallRequirement
+        skip_reason  # type: str
+    ):
+        # type: (...) -> AbstractDistribution
+        """Prepare an already-installed requirement
+        """
+        assert req.satisfied_by, "req should have been satisfied but isn't"
+        assert skip_reason is not None, (
+            "did not get skip reason skipped but req.satisfied_by "
+            "is set to {}".format(req.satisfied_by)
+        )
+        logger.info(
+            'Requirement %s: %s (%s)',
+            skip_reason, req, req.satisfied_by.version
+        )
+        with indent_log():
+            if self.require_hashes:
+                logger.debug(
+                    'Since it is already installed, we are trusting this '
+                    'package without checking its hash. To ensure a '
+                    'completely repeatable environment, install into an '
+                    'empty virtualenv.'
+                )
+            abstract_dist = InstalledDistribution(req)
+
+        return abstract_dist
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2386ee75b893d3e52ac54cd8f35c785b47d5519
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pep425tags.py
@@ -0,0 +1,167 @@
+"""Generate and work with PEP 425 Compatibility Tags."""
+from __future__ import absolute_import
+
+import logging
+import re
+
+from pip._vendor.packaging.tags import (
+    Tag,
+    compatible_tags,
+    cpython_tags,
+    generic_tags,
+    interpreter_name,
+    interpreter_version,
+    mac_platforms,
+)
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional, Tuple
+
+    from pip._vendor.packaging.tags import PythonVersion
+
+logger = logging.getLogger(__name__)
+
+_osx_arch_pat = re.compile(r'(.+)_(\d+)_(\d+)_(.+)')
+
+
+def version_info_to_nodot(version_info):
+    # type: (Tuple[int, ...]) -> str
+    # Only use up to the first two numbers.
+    return ''.join(map(str, version_info[:2]))
+
+
+def _mac_platforms(arch):
+    # type: (str) -> List[str]
+    match = _osx_arch_pat.match(arch)
+    if match:
+        name, major, minor, actual_arch = match.groups()
+        mac_version = (int(major), int(minor))
+        arches = [
+            # Since we have always only checked that the platform starts
+            # with "macosx", for backwards-compatibility we extract the
+            # actual prefix provided by the user in case they provided
+            # something like "macosxcustom_". It may be good to remove
+            # this as undocumented or deprecate it in the future.
+            '{}_{}'.format(name, arch[len('macosx_'):])
+            for arch in mac_platforms(mac_version, actual_arch)
+        ]
+    else:
+        # arch pattern didn't match (?!)
+        arches = [arch]
+    return arches
+
+
+def _custom_manylinux_platforms(arch):
+    # type: (str) -> List[str]
+    arches = [arch]
+    arch_prefix, arch_sep, arch_suffix = arch.partition('_')
+    if arch_prefix == 'manylinux2014':
+        # manylinux1/manylinux2010 wheels run on most manylinux2014 systems
+        # with the exception of wheels depending on ncurses. PEP 599 states
+        # manylinux1/manylinux2010 wheels should be considered
+        # manylinux2014 wheels:
+        # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels
+        if arch_suffix in {'i686', 'x86_64'}:
+            arches.append('manylinux2010' + arch_sep + arch_suffix)
+            arches.append('manylinux1' + arch_sep + arch_suffix)
+    elif arch_prefix == 'manylinux2010':
+        # manylinux1 wheels run on most manylinux2010 systems with the
+        # exception of wheels depending on ncurses. PEP 571 states
+        # manylinux1 wheels should be considered manylinux2010 wheels:
+        # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels
+        arches.append('manylinux1' + arch_sep + arch_suffix)
+    return arches
+
+
+def _get_custom_platforms(arch):
+    # type: (str) -> List[str]
+    arch_prefix, arch_sep, arch_suffix = arch.partition('_')
+    if arch.startswith('macosx'):
+        arches = _mac_platforms(arch)
+    elif arch_prefix in ['manylinux2014', 'manylinux2010']:
+        arches = _custom_manylinux_platforms(arch)
+    else:
+        arches = [arch]
+    return arches
+
+
+def _get_python_version(version):
+    # type: (str) -> PythonVersion
+    if len(version) > 1:
+        return int(version[0]), int(version[1:])
+    else:
+        return (int(version[0]),)
+
+
+def _get_custom_interpreter(implementation=None, version=None):
+    # type: (Optional[str], Optional[str]) -> str
+    if implementation is None:
+        implementation = interpreter_name()
+    if version is None:
+        version = interpreter_version()
+    return "{}{}".format(implementation, version)
+
+
+def get_supported(
+    version=None,  # type: Optional[str]
+    platform=None,  # type: Optional[str]
+    impl=None,  # type: Optional[str]
+    abi=None  # type: Optional[str]
+):
+    # type: (...) -> List[Tag]
+    """Return a list of supported tags for each version specified in
+    `versions`.
+
+    :param version: a string version, of the form "33" or "32",
+        or None. The version will be assumed to support our ABI.
+    :param platform: specify the exact platform you want valid
+        tags for, or None. If None, use the local system platform.
+    :param impl: specify the exact implementation you want valid
+        tags for, or None. If None, use the local interpreter impl.
+    :param abi: specify the exact abi you want valid
+        tags for, or None. If None, use the local interpreter abi.
+    """
+    supported = []  # type: List[Tag]
+
+    python_version = None  # type: Optional[PythonVersion]
+    if version is not None:
+        python_version = _get_python_version(version)
+
+    interpreter = _get_custom_interpreter(impl, version)
+
+    abis = None  # type: Optional[List[str]]
+    if abi is not None:
+        abis = [abi]
+
+    platforms = None  # type: Optional[List[str]]
+    if platform is not None:
+        platforms = _get_custom_platforms(platform)
+
+    is_cpython = (impl or interpreter_name()) == "cp"
+    if is_cpython:
+        supported.extend(
+            cpython_tags(
+                python_version=python_version,
+                abis=abis,
+                platforms=platforms,
+            )
+        )
+    else:
+        supported.extend(
+            generic_tags(
+                interpreter=interpreter,
+                abis=abis,
+                platforms=platforms,
+            )
+        )
+    supported.extend(
+        compatible_tags(
+            python_version=python_version,
+            interpreter=interpreter,
+            platforms=platforms,
+        )
+    )
+
+    return supported
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf614fd6eaf109c1112783a1057b251967aa8261
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/pyproject.py
@@ -0,0 +1,196 @@
+from __future__ import absolute_import
+
+import io
+import os
+import sys
+from collections import namedtuple
+
+from pip._vendor import pytoml, six
+from pip._vendor.packaging.requirements import InvalidRequirement, Requirement
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Optional, List
+
+
+def _is_list_of_str(obj):
+    # type: (Any) -> bool
+    return (
+        isinstance(obj, list) and
+        all(isinstance(item, six.string_types) for item in obj)
+    )
+
+
+def make_pyproject_path(unpacked_source_directory):
+    # type: (str) -> str
+    path = os.path.join(unpacked_source_directory, 'pyproject.toml')
+
+    # Python2 __file__ should not be unicode
+    if six.PY2 and isinstance(path, six.text_type):
+        path = path.encode(sys.getfilesystemencoding())
+
+    return path
+
+
+BuildSystemDetails = namedtuple('BuildSystemDetails', [
+    'requires', 'backend', 'check', 'backend_path'
+])
+
+
+def load_pyproject_toml(
+    use_pep517,  # type: Optional[bool]
+    pyproject_toml,  # type: str
+    setup_py,  # type: str
+    req_name  # type: str
+):
+    # type: (...) -> Optional[BuildSystemDetails]
+    """Load the pyproject.toml file.
+
+    Parameters:
+        use_pep517 - Has the user requested PEP 517 processing? None
+                     means the user hasn't explicitly specified.
+        pyproject_toml - Location of the project's pyproject.toml file
+        setup_py - Location of the project's setup.py file
+        req_name - The name of the requirement we're processing (for
+                   error reporting)
+
+    Returns:
+        None if we should use the legacy code path, otherwise a tuple
+        (
+            requirements from pyproject.toml,
+            name of PEP 517 backend,
+            requirements we should check are installed after setting
+                up the build environment
+            directory paths to import the backend from (backend-path),
+                relative to the project root.
+        )
+    """
+    has_pyproject = os.path.isfile(pyproject_toml)
+    has_setup = os.path.isfile(setup_py)
+
+    if has_pyproject:
+        with io.open(pyproject_toml, encoding="utf-8") as f:
+            pp_toml = pytoml.load(f)
+        build_system = pp_toml.get("build-system")
+    else:
+        build_system = None
+
+    # The following cases must use PEP 517
+    # We check for use_pep517 being non-None and falsey because that means
+    # the user explicitly requested --no-use-pep517.  The value 0 as
+    # opposed to False can occur when the value is provided via an
+    # environment variable or config file option (due to the quirk of
+    # strtobool() returning an integer in pip's configuration code).
+    if has_pyproject and not has_setup:
+        if use_pep517 is not None and not use_pep517:
+            raise InstallationError(
+                "Disabling PEP 517 processing is invalid: "
+                "project does not have a setup.py"
+            )
+        use_pep517 = True
+    elif build_system and "build-backend" in build_system:
+        if use_pep517 is not None and not use_pep517:
+            raise InstallationError(
+                "Disabling PEP 517 processing is invalid: "
+                "project specifies a build backend of {} "
+                "in pyproject.toml".format(
+                    build_system["build-backend"]
+                )
+            )
+        use_pep517 = True
+
+    # If we haven't worked out whether to use PEP 517 yet,
+    # and the user hasn't explicitly stated a preference,
+    # we do so if the project has a pyproject.toml file.
+    elif use_pep517 is None:
+        use_pep517 = has_pyproject
+
+    # At this point, we know whether we're going to use PEP 517.
+    assert use_pep517 is not None
+
+    # If we're using the legacy code path, there is nothing further
+    # for us to do here.
+    if not use_pep517:
+        return None
+
+    if build_system is None:
+        # Either the user has a pyproject.toml with no build-system
+        # section, or the user has no pyproject.toml, but has opted in
+        # explicitly via --use-pep517.
+        # In the absence of any explicit backend specification, we
+        # assume the setuptools backend that most closely emulates the
+        # traditional direct setup.py execution, and require wheel and
+        # a version of setuptools that supports that backend.
+
+        build_system = {
+            "requires": ["setuptools>=40.8.0", "wheel"],
+            "build-backend": "setuptools.build_meta:__legacy__",
+        }
+
+    # If we're using PEP 517, we have build system information (either
+    # from pyproject.toml, or defaulted by the code above).
+    # Note that at this point, we do not know if the user has actually
+    # specified a backend, though.
+    assert build_system is not None
+
+    # Ensure that the build-system section in pyproject.toml conforms
+    # to PEP 518.
+    error_template = (
+        "{package} has a pyproject.toml file that does not comply "
+        "with PEP 518: {reason}"
+    )
+
+    # Specifying the build-system table but not the requires key is invalid
+    if "requires" not in build_system:
+        raise InstallationError(
+            error_template.format(package=req_name, reason=(
+                "it has a 'build-system' table but not "
+                "'build-system.requires' which is mandatory in the table"
+            ))
+        )
+
+    # Error out if requires is not a list of strings
+    requires = build_system["requires"]
+    if not _is_list_of_str(requires):
+        raise InstallationError(error_template.format(
+            package=req_name,
+            reason="'build-system.requires' is not a list of strings.",
+        ))
+
+    # Each requirement must be valid as per PEP 508
+    for requirement in requires:
+        try:
+            Requirement(requirement)
+        except InvalidRequirement:
+            raise InstallationError(
+                error_template.format(
+                    package=req_name,
+                    reason=(
+                        "'build-system.requires' contains an invalid "
+                        "requirement: {!r}".format(requirement)
+                    ),
+                )
+            )
+
+    backend = build_system.get("build-backend")
+    backend_path = build_system.get("backend-path", [])
+    check = []  # type: List[str]
+    if backend is None:
+        # If the user didn't specify a backend, we assume they want to use
+        # the setuptools backend. But we can't be sure they have included
+        # a version of setuptools which supplies the backend, or wheel
+        # (which is needed by the backend) in their requirements. So we
+        # make a note to check that those requirements are present once
+        # we have set up the environment.
+        # This is quite a lot of work to check for a very specific case. But
+        # the problem is, that case is potentially quite common - projects that
+        # adopted PEP 518 early for the ability to specify requirements to
+        # execute setup.py, but never considered needing to mention the build
+        # tools themselves. The original PEP 518 code had a similar check (but
+        # implemented in a different way).
+        backend = "setuptools.build_meta:__legacy__"
+        check = ["setuptools>=40.8.0", "wheel"]
+
+    return BuildSystemDetails(requires, backend, check, backend_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d2d027adeec4dbedaf62f95b070d7fd9f1fbbe60
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/__init__.py
@@ -0,0 +1,92 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+from .req_file import parse_requirements
+from .req_install import InstallRequirement
+from .req_set import RequirementSet
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, List, Sequence
+
+__all__ = [
+    "RequirementSet", "InstallRequirement",
+    "parse_requirements", "install_given_reqs",
+]
+
+logger = logging.getLogger(__name__)
+
+
+class InstallationResult(object):
+    def __init__(self, name):
+        # type: (str) -> None
+        self.name = name
+
+    def __repr__(self):
+        # type: () -> str
+        return "InstallationResult(name={!r})".format(self.name)
+
+
+def install_given_reqs(
+    to_install,  # type: List[InstallRequirement]
+    install_options,  # type: List[str]
+    global_options=(),  # type: Sequence[str]
+    *args,  # type: Any
+    **kwargs  # type: Any
+):
+    # type: (...) -> List[InstallationResult]
+    """
+    Install everything in the given list.
+
+    (to be called after having downloaded and unpacked the packages)
+    """
+
+    if to_install:
+        logger.info(
+            'Installing collected packages: %s',
+            ', '.join([req.name for req in to_install]),
+        )
+
+    installed = []
+
+    with indent_log():
+        for requirement in to_install:
+            if requirement.should_reinstall:
+                logger.info('Attempting uninstall: %s', requirement.name)
+                with indent_log():
+                    uninstalled_pathset = requirement.uninstall(
+                        auto_confirm=True
+                    )
+            try:
+                requirement.install(
+                    install_options,
+                    global_options,
+                    *args,
+                    **kwargs
+                )
+            except Exception:
+                should_rollback = (
+                    requirement.should_reinstall and
+                    not requirement.install_succeeded
+                )
+                # if install did not succeed, rollback previous uninstall
+                if should_rollback:
+                    uninstalled_pathset.rollback()
+                raise
+            else:
+                should_commit = (
+                    requirement.should_reinstall and
+                    requirement.install_succeeded
+                )
+                if should_commit:
+                    uninstalled_pathset.commit()
+
+            installed.append(InstallationResult(requirement.name))
+
+    return installed
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/constructors.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/constructors.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f3cd8a104c92d804f3086bb519a9ccf24cc46de
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/constructors.py
@@ -0,0 +1,436 @@
+"""Backing implementation for InstallRequirement's various constructors
+
+The idea here is that these formed a major chunk of InstallRequirement's size
+so, moving them and support code dedicated to them outside of that class
+helps creates for better understandability for the rest of the code.
+
+These are meant to be used elsewhere within pip to create instances of
+InstallRequirement.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import logging
+import os
+import re
+
+from pip._vendor.packaging.markers import Marker
+from pip._vendor.packaging.requirements import InvalidRequirement, Requirement
+from pip._vendor.packaging.specifiers import Specifier
+from pip._vendor.pkg_resources import RequirementParseError, parse_requirements
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.models.index import PyPI, TestPyPI
+from pip._internal.models.link import Link
+from pip._internal.models.wheel import Wheel
+from pip._internal.pyproject import make_pyproject_path
+from pip._internal.req.req_install import InstallRequirement
+from pip._internal.utils.filetypes import ARCHIVE_EXTENSIONS
+from pip._internal.utils.misc import is_installable_dir, splitext
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url
+from pip._internal.vcs import is_url, vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Dict, Optional, Set, Tuple, Union,
+    )
+    from pip._internal.cache import WheelCache
+
+
+__all__ = [
+    "install_req_from_editable", "install_req_from_line",
+    "parse_editable"
+]
+
+logger = logging.getLogger(__name__)
+operators = Specifier._operators.keys()
+
+
+def is_archive_file(name):
+    # type: (str) -> bool
+    """Return True if `name` is a considered as an archive file."""
+    ext = splitext(name)[1].lower()
+    if ext in ARCHIVE_EXTENSIONS:
+        return True
+    return False
+
+
+def _strip_extras(path):
+    # type: (str) -> Tuple[str, Optional[str]]
+    m = re.match(r'^(.+)(\[[^\]]+\])$', path)
+    extras = None
+    if m:
+        path_no_extras = m.group(1)
+        extras = m.group(2)
+    else:
+        path_no_extras = path
+
+    return path_no_extras, extras
+
+
+def convert_extras(extras):
+    # type: (Optional[str]) -> Set[str]
+    if not extras:
+        return set()
+    return Requirement("placeholder" + extras.lower()).extras
+
+
+def parse_editable(editable_req):
+    # type: (str) -> Tuple[Optional[str], str, Optional[Set[str]]]
+    """Parses an editable requirement into:
+        - a requirement name
+        - an URL
+        - extras
+        - editable options
+    Accepted requirements:
+        svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir
+        .[some_extra]
+    """
+
+    url = editable_req
+
+    # If a file path is specified with extras, strip off the extras.
+    url_no_extras, extras = _strip_extras(url)
+
+    if os.path.isdir(url_no_extras):
+        if not os.path.exists(os.path.join(url_no_extras, 'setup.py')):
+            msg = (
+                'File "setup.py" not found. Directory cannot be installed '
+                'in editable mode: {}'.format(os.path.abspath(url_no_extras))
+            )
+            pyproject_path = make_pyproject_path(url_no_extras)
+            if os.path.isfile(pyproject_path):
+                msg += (
+                    '\n(A "pyproject.toml" file was found, but editable '
+                    'mode currently requires a setup.py based build.)'
+                )
+            raise InstallationError(msg)
+
+        # Treating it as code that has already been checked out
+        url_no_extras = path_to_url(url_no_extras)
+
+    if url_no_extras.lower().startswith('file:'):
+        package_name = Link(url_no_extras).egg_fragment
+        if extras:
+            return (
+                package_name,
+                url_no_extras,
+                Requirement("placeholder" + extras.lower()).extras,
+            )
+        else:
+            return package_name, url_no_extras, None
+
+    for version_control in vcs:
+        if url.lower().startswith('%s:' % version_control):
+            url = '%s+%s' % (version_control, url)
+            break
+
+    if '+' not in url:
+        raise InstallationError(
+            '{} is not a valid editable requirement. '
+            'It should either be a path to a local project or a VCS URL '
+            '(beginning with svn+, git+, hg+, or bzr+).'.format(editable_req)
+        )
+
+    vc_type = url.split('+', 1)[0].lower()
+
+    if not vcs.get_backend(vc_type):
+        error_message = 'For --editable=%s only ' % editable_req + \
+            ', '.join([backend.name + '+URL' for backend in vcs.backends]) + \
+            ' is currently supported'
+        raise InstallationError(error_message)
+
+    package_name = Link(url).egg_fragment
+    if not package_name:
+        raise InstallationError(
+            "Could not detect requirement name for '%s', please specify one "
+            "with #egg=your_package_name" % editable_req
+        )
+    return package_name, url, None
+
+
+def deduce_helpful_msg(req):
+    # type: (str) -> str
+    """Returns helpful msg in case requirements file does not exist,
+    or cannot be parsed.
+
+    :params req: Requirements file path
+    """
+    msg = ""
+    if os.path.exists(req):
+        msg = " It does exist."
+        # Try to parse and check if it is a requirements file.
+        try:
+            with open(req, 'r') as fp:
+                # parse first line only
+                next(parse_requirements(fp.read()))
+                msg += " The argument you provided " + \
+                    "(%s) appears to be a" % (req) + \
+                    " requirements file. If that is the" + \
+                    " case, use the '-r' flag to install" + \
+                    " the packages specified within it."
+        except RequirementParseError:
+            logger.debug("Cannot parse '%s' as requirements \
+            file" % (req), exc_info=True)
+    else:
+        msg += " File '%s' does not exist." % (req)
+    return msg
+
+
+class RequirementParts(object):
+    def __init__(
+            self,
+            requirement,  # type: Optional[Requirement]
+            link,         # type: Optional[Link]
+            markers,      # type: Optional[Marker]
+            extras,       # type: Set[str]
+    ):
+        self.requirement = requirement
+        self.link = link
+        self.markers = markers
+        self.extras = extras
+
+
+def parse_req_from_editable(editable_req):
+    # type: (str) -> RequirementParts
+    name, url, extras_override = parse_editable(editable_req)
+
+    if name is not None:
+        try:
+            req = Requirement(name)
+        except InvalidRequirement:
+            raise InstallationError("Invalid requirement: '%s'" % name)
+    else:
+        req = None
+
+    link = Link(url)
+
+    return RequirementParts(req, link, None, extras_override)
+
+
+# ---- The actual constructors follow ----
+
+
+def install_req_from_editable(
+    editable_req,  # type: str
+    comes_from=None,  # type: Optional[str]
+    use_pep517=None,  # type: Optional[bool]
+    isolated=False,  # type: bool
+    options=None,  # type: Optional[Dict[str, Any]]
+    wheel_cache=None,  # type: Optional[WheelCache]
+    constraint=False  # type: bool
+):
+    # type: (...) -> InstallRequirement
+
+    parts = parse_req_from_editable(editable_req)
+
+    source_dir = parts.link.file_path if parts.link.scheme == 'file' else None
+
+    return InstallRequirement(
+        parts.requirement, comes_from, source_dir=source_dir,
+        editable=True,
+        link=parts.link,
+        constraint=constraint,
+        use_pep517=use_pep517,
+        isolated=isolated,
+        options=options if options else {},
+        wheel_cache=wheel_cache,
+        extras=parts.extras,
+    )
+
+
+def _looks_like_path(name):
+    # type: (str) -> bool
+    """Checks whether the string "looks like" a path on the filesystem.
+
+    This does not check whether the target actually exists, only judge from the
+    appearance.
+
+    Returns true if any of the following conditions is true:
+    * a path separator is found (either os.path.sep or os.path.altsep);
+    * a dot is found (which represents the current directory).
+    """
+    if os.path.sep in name:
+        return True
+    if os.path.altsep is not None and os.path.altsep in name:
+        return True
+    if name.startswith("."):
+        return True
+    return False
+
+
+def _get_url_from_path(path, name):
+    # type: (str, str) -> str
+    """
+    First, it checks whether a provided path is an installable directory
+    (e.g. it has a setup.py). If it is, returns the path.
+
+    If false, check if the path is an archive file (such as a .whl).
+    The function checks if the path is a file. If false, if the path has
+    an @, it will treat it as a PEP 440 URL requirement and return the path.
+    """
+    if _looks_like_path(name) and os.path.isdir(path):
+        if is_installable_dir(path):
+            return path_to_url(path)
+        raise InstallationError(
+            "Directory %r is not installable. Neither 'setup.py' "
+            "nor 'pyproject.toml' found." % name
+        )
+    if not is_archive_file(path):
+        return None
+    if os.path.isfile(path):
+        return path_to_url(path)
+    urlreq_parts = name.split('@', 1)
+    if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]):
+        # If the path contains '@' and the part before it does not look
+        # like a path, try to treat it as a PEP 440 URL req instead.
+        return None
+    logger.warning(
+        'Requirement %r looks like a filename, but the '
+        'file does not exist',
+        name
+    )
+    return path_to_url(path)
+
+
+def parse_req_from_line(name, line_source):
+    # type: (str, Optional[str]) -> RequirementParts
+    if is_url(name):
+        marker_sep = '; '
+    else:
+        marker_sep = ';'
+    if marker_sep in name:
+        name, markers_as_string = name.split(marker_sep, 1)
+        markers_as_string = markers_as_string.strip()
+        if not markers_as_string:
+            markers = None
+        else:
+            markers = Marker(markers_as_string)
+    else:
+        markers = None
+    name = name.strip()
+    req_as_string = None
+    path = os.path.normpath(os.path.abspath(name))
+    link = None
+    extras_as_string = None
+
+    if is_url(name):
+        link = Link(name)
+    else:
+        p, extras_as_string = _strip_extras(path)
+        url = _get_url_from_path(p, name)
+        if url is not None:
+            link = Link(url)
+
+    # it's a local file, dir, or url
+    if link:
+        # Handle relative file URLs
+        if link.scheme == 'file' and re.search(r'\.\./', link.url):
+            link = Link(
+                path_to_url(os.path.normpath(os.path.abspath(link.path))))
+        # wheel file
+        if link.is_wheel:
+            wheel = Wheel(link.filename)  # can raise InvalidWheelFilename
+            req_as_string = "%s==%s" % (wheel.name, wheel.version)
+        else:
+            # set the req to the egg fragment.  when it's not there, this
+            # will become an 'unnamed' requirement
+            req_as_string = link.egg_fragment
+
+    # a requirement specifier
+    else:
+        req_as_string = name
+
+    extras = convert_extras(extras_as_string)
+
+    def with_source(text):
+        # type: (str) -> str
+        if not line_source:
+            return text
+        return '{} (from {})'.format(text, line_source)
+
+    if req_as_string is not None:
+        try:
+            req = Requirement(req_as_string)
+        except InvalidRequirement:
+            if os.path.sep in req_as_string:
+                add_msg = "It looks like a path."
+                add_msg += deduce_helpful_msg(req_as_string)
+            elif ('=' in req_as_string and
+                  not any(op in req_as_string for op in operators)):
+                add_msg = "= is not a valid operator. Did you mean == ?"
+            else:
+                add_msg = ''
+            msg = with_source(
+                'Invalid requirement: {!r}'.format(req_as_string)
+            )
+            if add_msg:
+                msg += '\nHint: {}'.format(add_msg)
+            raise InstallationError(msg)
+    else:
+        req = None
+
+    return RequirementParts(req, link, markers, extras)
+
+
+def install_req_from_line(
+    name,  # type: str
+    comes_from=None,  # type: Optional[Union[str, InstallRequirement]]
+    use_pep517=None,  # type: Optional[bool]
+    isolated=False,  # type: bool
+    options=None,  # type: Optional[Dict[str, Any]]
+    wheel_cache=None,  # type: Optional[WheelCache]
+    constraint=False,  # type: bool
+    line_source=None,  # type: Optional[str]
+):
+    # type: (...) -> InstallRequirement
+    """Creates an InstallRequirement from a name, which might be a
+    requirement, directory containing 'setup.py', filename, or URL.
+
+    :param line_source: An optional string describing where the line is from,
+        for logging purposes in case of an error.
+    """
+    parts = parse_req_from_line(name, line_source)
+
+    return InstallRequirement(
+        parts.requirement, comes_from, link=parts.link, markers=parts.markers,
+        use_pep517=use_pep517, isolated=isolated,
+        options=options if options else {},
+        wheel_cache=wheel_cache,
+        constraint=constraint,
+        extras=parts.extras,
+    )
+
+
+def install_req_from_req_string(
+    req_string,  # type: str
+    comes_from=None,  # type: Optional[InstallRequirement]
+    isolated=False,  # type: bool
+    wheel_cache=None,  # type: Optional[WheelCache]
+    use_pep517=None  # type: Optional[bool]
+):
+    # type: (...) -> InstallRequirement
+    try:
+        req = Requirement(req_string)
+    except InvalidRequirement:
+        raise InstallationError("Invalid requirement: '%s'" % req_string)
+
+    domains_not_allowed = [
+        PyPI.file_storage_domain,
+        TestPyPI.file_storage_domain,
+    ]
+    if (req.url and comes_from and comes_from.link and
+            comes_from.link.netloc in domains_not_allowed):
+        # Explicitly disallow pypi packages that depend on external urls
+        raise InstallationError(
+            "Packages installed from PyPI cannot depend on packages "
+            "which are not also hosted on PyPI.\n"
+            "%s depends on %s " % (comes_from.name, req)
+        )
+
+    return InstallRequirement(
+        req, comes_from, isolated=isolated, wheel_cache=wheel_cache,
+        use_pep517=use_pep517
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py
new file mode 100644
index 0000000000000000000000000000000000000000..8c7810481ee6504faaf08a0b7d1e0790ad9cc089
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_file.py
@@ -0,0 +1,546 @@
+"""
+Requirements file parsing
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import optparse
+import os
+import re
+import shlex
+import sys
+
+from pip._vendor.six.moves import filterfalse
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.cli import cmdoptions
+from pip._internal.exceptions import (
+    InstallationError,
+    RequirementsFileParseError,
+)
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.req.constructors import (
+    install_req_from_editable,
+    install_req_from_line,
+)
+from pip._internal.utils.encoding import auto_decode
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import get_url_scheme
+
+if MYPY_CHECK_RUNNING:
+    from optparse import Values
+    from typing import (
+        Any, Callable, Iterator, List, NoReturn, Optional, Text, Tuple,
+    )
+
+    from pip._internal.req import InstallRequirement
+    from pip._internal.cache import WheelCache
+    from pip._internal.index.package_finder import PackageFinder
+    from pip._internal.network.session import PipSession
+
+    ReqFileLines = Iterator[Tuple[int, Text]]
+
+    LineParser = Callable[[Text], Tuple[str, Values]]
+
+
+__all__ = ['parse_requirements']
+
+SCHEME_RE = re.compile(r'^(http|https|file):', re.I)
+COMMENT_RE = re.compile(r'(^|\s+)#.*$')
+
+# Matches environment variable-style values in '${MY_VARIABLE_1}' with the
+# variable name consisting of only uppercase letters, digits or the '_'
+# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1,
+# 2013 Edition.
+ENV_VAR_RE = re.compile(r'(?P<var>\$\{(?P<name>[A-Z0-9_]+)\})')
+
+SUPPORTED_OPTIONS = [
+    cmdoptions.index_url,
+    cmdoptions.extra_index_url,
+    cmdoptions.no_index,
+    cmdoptions.constraints,
+    cmdoptions.requirements,
+    cmdoptions.editable,
+    cmdoptions.find_links,
+    cmdoptions.no_binary,
+    cmdoptions.only_binary,
+    cmdoptions.require_hashes,
+    cmdoptions.pre,
+    cmdoptions.trusted_host,
+    cmdoptions.always_unzip,  # Deprecated
+]  # type: List[Callable[..., optparse.Option]]
+
+# options to be passed to requirements
+SUPPORTED_OPTIONS_REQ = [
+    cmdoptions.install_options,
+    cmdoptions.global_options,
+    cmdoptions.hash,
+]  # type: List[Callable[..., optparse.Option]]
+
+# the 'dest' string values
+SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ]
+
+
+class ParsedLine(object):
+    def __init__(
+        self,
+        filename,  # type: str
+        lineno,  # type: int
+        comes_from,  # type: str
+        args,  # type: str
+        opts,  # type: Values
+        constraint,  # type: bool
+    ):
+        # type: (...) -> None
+        self.filename = filename
+        self.lineno = lineno
+        self.comes_from = comes_from
+        self.args = args
+        self.opts = opts
+        self.constraint = constraint
+
+
+def parse_requirements(
+    filename,  # type: str
+    session,  # type: PipSession
+    finder=None,  # type: Optional[PackageFinder]
+    comes_from=None,  # type: Optional[str]
+    options=None,  # type: Optional[optparse.Values]
+    constraint=False,  # type: bool
+    wheel_cache=None,  # type: Optional[WheelCache]
+    use_pep517=None  # type: Optional[bool]
+):
+    # type: (...) -> Iterator[InstallRequirement]
+    """Parse a requirements file and yield InstallRequirement instances.
+
+    :param filename:    Path or url of requirements file.
+    :param session:     PipSession instance.
+    :param finder:      Instance of pip.index.PackageFinder.
+    :param comes_from:  Origin description of requirements.
+    :param options:     cli options.
+    :param constraint:  If true, parsing a constraint file rather than
+        requirements file.
+    :param wheel_cache: Instance of pip.wheel.WheelCache
+    :param use_pep517:  Value of the --use-pep517 option.
+    """
+    skip_requirements_regex = (
+        options.skip_requirements_regex if options else None
+    )
+    line_parser = get_line_parser(finder)
+    parser = RequirementsFileParser(
+        session, line_parser, comes_from, skip_requirements_regex
+    )
+
+    for parsed_line in parser.parse(filename, constraint):
+        req = handle_line(
+            parsed_line, finder, options, session, wheel_cache, use_pep517
+        )
+        if req is not None:
+            yield req
+
+
+def preprocess(content, skip_requirements_regex):
+    # type: (Text, Optional[str]) -> ReqFileLines
+    """Split, filter, and join lines, and return a line iterator
+
+    :param content: the content of the requirements file
+    :param options: cli options
+    """
+    lines_enum = enumerate(content.splitlines(), start=1)  # type: ReqFileLines
+    lines_enum = join_lines(lines_enum)
+    lines_enum = ignore_comments(lines_enum)
+    if skip_requirements_regex:
+        lines_enum = skip_regex(lines_enum, skip_requirements_regex)
+    lines_enum = expand_env_variables(lines_enum)
+    return lines_enum
+
+
+def handle_line(
+    line,  # type: ParsedLine
+    finder=None,  # type: Optional[PackageFinder]
+    options=None,  # type: Optional[optparse.Values]
+    session=None,  # type: Optional[PipSession]
+    wheel_cache=None,  # type: Optional[WheelCache]
+    use_pep517=None,  # type: Optional[bool]
+):
+    # type: (...) -> Optional[InstallRequirement]
+    """Handle a single parsed requirements line; This can result in
+    creating/yielding requirements, or updating the finder.
+
+    For lines that contain requirements, the only options that have an effect
+    are from SUPPORTED_OPTIONS_REQ, and they are scoped to the
+    requirement. Other options from SUPPORTED_OPTIONS may be present, but are
+    ignored.
+
+    For lines that do not contain requirements, the only options that have an
+    effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may
+    be present, but are ignored. These lines may contain multiple options
+    (although our docs imply only one is supported), and all our parsed and
+    affect the finder.
+    """
+
+    # preserve for the nested code path
+    line_comes_from = '%s %s (line %s)' % (
+        '-c' if line.constraint else '-r', line.filename, line.lineno,
+    )
+
+    # return a line requirement
+    if line.args:
+        isolated = options.isolated_mode if options else False
+        if options:
+            cmdoptions.check_install_build_global(options, line.opts)
+        # get the options that apply to requirements
+        req_options = {}
+        for dest in SUPPORTED_OPTIONS_REQ_DEST:
+            if dest in line.opts.__dict__ and line.opts.__dict__[dest]:
+                req_options[dest] = line.opts.__dict__[dest]
+        line_source = 'line {} of {}'.format(line.lineno, line.filename)
+        return install_req_from_line(
+            line.args,
+            comes_from=line_comes_from,
+            use_pep517=use_pep517,
+            isolated=isolated,
+            options=req_options,
+            wheel_cache=wheel_cache,
+            constraint=line.constraint,
+            line_source=line_source,
+        )
+
+    # return an editable requirement
+    elif line.opts.editables:
+        isolated = options.isolated_mode if options else False
+        return install_req_from_editable(
+            line.opts.editables[0], comes_from=line_comes_from,
+            use_pep517=use_pep517,
+            constraint=line.constraint, isolated=isolated,
+            wheel_cache=wheel_cache
+        )
+
+    # percolate hash-checking option upward
+    elif line.opts.require_hashes:
+        options.require_hashes = line.opts.require_hashes
+
+    # set finder options
+    elif finder:
+        find_links = finder.find_links
+        index_urls = finder.index_urls
+        if line.opts.index_url:
+            index_urls = [line.opts.index_url]
+        if line.opts.no_index is True:
+            index_urls = []
+        if line.opts.extra_index_urls:
+            index_urls.extend(line.opts.extra_index_urls)
+        if line.opts.find_links:
+            # FIXME: it would be nice to keep track of the source
+            # of the find_links: support a find-links local path
+            # relative to a requirements file.
+            value = line.opts.find_links[0]
+            req_dir = os.path.dirname(os.path.abspath(line.filename))
+            relative_to_reqs_file = os.path.join(req_dir, value)
+            if os.path.exists(relative_to_reqs_file):
+                value = relative_to_reqs_file
+            find_links.append(value)
+
+        search_scope = SearchScope(
+            find_links=find_links,
+            index_urls=index_urls,
+        )
+        finder.search_scope = search_scope
+
+        if line.opts.pre:
+            finder.set_allow_all_prereleases()
+
+        if session:
+            for host in line.opts.trusted_hosts or []:
+                source = 'line {} of {}'.format(line.lineno, line.filename)
+                session.add_trusted_host(host, source=source)
+
+    return None
+
+
+class RequirementsFileParser(object):
+    def __init__(
+        self,
+        session,  # type: PipSession
+        line_parser,  # type: LineParser
+        comes_from,  # type: str
+        skip_requirements_regex,  # type: Optional[str]
+    ):
+        # type: (...) -> None
+        self._session = session
+        self._line_parser = line_parser
+        self._comes_from = comes_from
+        self._skip_requirements_regex = skip_requirements_regex
+
+    def parse(self, filename, constraint):
+        # type: (str, bool) -> Iterator[ParsedLine]
+        """Parse a given file, yielding parsed lines.
+        """
+        for line in self._parse_and_recurse(filename, constraint):
+            yield line
+
+    def _parse_and_recurse(self, filename, constraint):
+        # type: (str, bool) -> Iterator[ParsedLine]
+        for line in self._parse_file(filename, constraint):
+            if (
+                not line.args and
+                not line.opts.editables and
+                (line.opts.requirements or line.opts.constraints)
+            ):
+                # parse a nested requirements file
+                if line.opts.requirements:
+                    req_path = line.opts.requirements[0]
+                    nested_constraint = False
+                else:
+                    req_path = line.opts.constraints[0]
+                    nested_constraint = True
+
+                # original file is over http
+                if SCHEME_RE.search(filename):
+                    # do a url join so relative paths work
+                    req_path = urllib_parse.urljoin(filename, req_path)
+                # original file and nested file are paths
+                elif not SCHEME_RE.search(req_path):
+                    # do a join so relative paths work
+                    req_path = os.path.join(
+                        os.path.dirname(filename), req_path,
+                    )
+
+                for inner_line in self._parse_and_recurse(
+                    req_path, nested_constraint,
+                ):
+                    yield inner_line
+            else:
+                yield line
+
+    def _parse_file(self, filename, constraint):
+        # type: (str, bool) -> Iterator[ParsedLine]
+        _, content = get_file_content(
+            filename, self._session, comes_from=self._comes_from
+        )
+
+        lines_enum = preprocess(content, self._skip_requirements_regex)
+
+        for line_number, line in lines_enum:
+            try:
+                args_str, opts = self._line_parser(line)
+            except OptionParsingError as e:
+                # add offending line
+                msg = 'Invalid requirement: %s\n%s' % (line, e.msg)
+                raise RequirementsFileParseError(msg)
+
+            yield ParsedLine(
+                filename,
+                line_number,
+                self._comes_from,
+                args_str,
+                opts,
+                constraint,
+            )
+
+
+def get_line_parser(finder):
+    # type: (Optional[PackageFinder]) -> LineParser
+    def parse_line(line):
+        # type: (Text) -> Tuple[str, Values]
+        # Build new parser for each line since it accumulates appendable
+        # options.
+        parser = build_parser()
+        defaults = parser.get_default_values()
+        defaults.index_url = None
+        if finder:
+            defaults.format_control = finder.format_control
+
+        args_str, options_str = break_args_options(line)
+        # Prior to 2.7.3, shlex cannot deal with unicode entries
+        if sys.version_info < (2, 7, 3):
+            # https://github.com/python/mypy/issues/1174
+            options_str = options_str.encode('utf8')  # type: ignore
+
+        # https://github.com/python/mypy/issues/1174
+        opts, _ = parser.parse_args(
+            shlex.split(options_str), defaults)  # type: ignore
+
+        return args_str, opts
+
+    return parse_line
+
+
+def break_args_options(line):
+    # type: (Text) -> Tuple[str, Text]
+    """Break up the line into an args and options string.  We only want to shlex
+    (and then optparse) the options, not the args.  args can contain markers
+    which are corrupted by shlex.
+    """
+    tokens = line.split(' ')
+    args = []
+    options = tokens[:]
+    for token in tokens:
+        if token.startswith('-') or token.startswith('--'):
+            break
+        else:
+            args.append(token)
+            options.pop(0)
+    return ' '.join(args), ' '.join(options)  # type: ignore
+
+
+class OptionParsingError(Exception):
+    def __init__(self, msg):
+        # type: (str) -> None
+        self.msg = msg
+
+
+def build_parser():
+    # type: () -> optparse.OptionParser
+    """
+    Return a parser for parsing requirement lines
+    """
+    parser = optparse.OptionParser(add_help_option=False)
+
+    option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ
+    for option_factory in option_factories:
+        option = option_factory()
+        parser.add_option(option)
+
+    # By default optparse sys.exits on parsing errors. We want to wrap
+    # that in our own exception.
+    def parser_exit(self, msg):
+        # type: (Any, str) -> NoReturn
+        raise OptionParsingError(msg)
+    # NOTE: mypy disallows assigning to a method
+    #       https://github.com/python/mypy/issues/2427
+    parser.exit = parser_exit  # type: ignore
+
+    return parser
+
+
+def join_lines(lines_enum):
+    # type: (ReqFileLines) -> ReqFileLines
+    """Joins a line ending in '\' with the previous line (except when following
+    comments).  The joined line takes on the index of the first line.
+    """
+    primary_line_number = None
+    new_line = []  # type: List[Text]
+    for line_number, line in lines_enum:
+        if not line.endswith('\\') or COMMENT_RE.match(line):
+            if COMMENT_RE.match(line):
+                # this ensures comments are always matched later
+                line = ' ' + line
+            if new_line:
+                new_line.append(line)
+                yield primary_line_number, ''.join(new_line)
+                new_line = []
+            else:
+                yield line_number, line
+        else:
+            if not new_line:
+                primary_line_number = line_number
+            new_line.append(line.strip('\\'))
+
+    # last line contains \
+    if new_line:
+        yield primary_line_number, ''.join(new_line)
+
+    # TODO: handle space after '\'.
+
+
+def ignore_comments(lines_enum):
+    # type: (ReqFileLines) -> ReqFileLines
+    """
+    Strips comments and filter empty lines.
+    """
+    for line_number, line in lines_enum:
+        line = COMMENT_RE.sub('', line)
+        line = line.strip()
+        if line:
+            yield line_number, line
+
+
+def skip_regex(lines_enum, pattern):
+    # type: (ReqFileLines, str) -> ReqFileLines
+    """
+    Skip lines that match the provided pattern
+
+    Note: the regex pattern is only built once
+    """
+    matcher = re.compile(pattern)
+    lines_enum = filterfalse(lambda e: matcher.search(e[1]), lines_enum)
+    return lines_enum
+
+
+def expand_env_variables(lines_enum):
+    # type: (ReqFileLines) -> ReqFileLines
+    """Replace all environment variables that can be retrieved via `os.getenv`.
+
+    The only allowed format for environment variables defined in the
+    requirement file is `${MY_VARIABLE_1}` to ensure two things:
+
+    1. Strings that contain a `$` aren't accidentally (partially) expanded.
+    2. Ensure consistency across platforms for requirement files.
+
+    These points are the result of a discussion on the `github pull
+    request #3514 <https://github.com/pypa/pip/pull/3514>`_.
+
+    Valid characters in variable names follow the `POSIX standard
+    <http://pubs.opengroup.org/onlinepubs/9699919799/>`_ and are limited
+    to uppercase letter, digits and the `_` (underscore).
+    """
+    for line_number, line in lines_enum:
+        for env_var, var_name in ENV_VAR_RE.findall(line):
+            value = os.getenv(var_name)
+            if not value:
+                continue
+
+            line = line.replace(env_var, value)
+
+        yield line_number, line
+
+
+def get_file_content(url, session, comes_from=None):
+    # type: (str, PipSession, Optional[str]) -> Tuple[str, Text]
+    """Gets the content of a file; it may be a filename, file: URL, or
+    http: URL.  Returns (location, content).  Content is unicode.
+    Respects # -*- coding: declarations on the retrieved files.
+
+    :param url:         File path or url.
+    :param session:     PipSession instance.
+    :param comes_from:  Origin description of requirements.
+    """
+    scheme = get_url_scheme(url)
+
+    if scheme in ['http', 'https']:
+        # FIXME: catch some errors
+        resp = session.get(url)
+        resp.raise_for_status()
+        return resp.url, resp.text
+
+    elif scheme == 'file':
+        if comes_from and comes_from.startswith('http'):
+            raise InstallationError(
+                'Requirements file %s references URL %s, which is local'
+                % (comes_from, url))
+
+        path = url.split(':', 1)[1]
+        path = path.replace('\\', '/')
+        match = _url_slash_drive_re.match(path)
+        if match:
+            path = match.group(1) + ':' + path.split('|', 1)[1]
+        path = urllib_parse.unquote(path)
+        if path.startswith('/'):
+            path = '/' + path.lstrip('/')
+        url = path
+
+    try:
+        with open(url, 'rb') as f:
+            content = auto_decode(f.read())
+    except IOError as exc:
+        raise InstallationError(
+            'Could not open requirements file: %s' % str(exc)
+        )
+    return url, content
+
+
+_url_slash_drive_re = re.compile(r'/*([a-z])\|', re.I)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py
new file mode 100644
index 0000000000000000000000000000000000000000..22ac24b96d361e8202979e3cbb23309792f7e090
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_install.py
@@ -0,0 +1,830 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import shutil
+import sys
+import zipfile
+
+from pip._vendor import pkg_resources, six
+from pip._vendor.packaging.requirements import Requirement
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.packaging.version import Version
+from pip._vendor.packaging.version import parse as parse_version
+from pip._vendor.pep517.wrappers import Pep517HookCaller
+
+from pip._internal import pep425tags
+from pip._internal.build_env import NoOpBuildEnvironment
+from pip._internal.exceptions import InstallationError
+from pip._internal.locations import get_scheme
+from pip._internal.models.link import Link
+from pip._internal.operations.build.metadata import generate_metadata
+from pip._internal.operations.build.metadata_legacy import \
+    generate_metadata as generate_metadata_legacy
+from pip._internal.operations.install.editable_legacy import \
+    install_editable as install_editable_legacy
+from pip._internal.operations.install.legacy import install as install_legacy
+from pip._internal.operations.install.wheel import install_wheel
+from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path
+from pip._internal.req.req_uninstall import UninstallPathSet
+from pip._internal.utils.deprecation import deprecated
+from pip._internal.utils.hashes import Hashes
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.marker_files import (
+    PIP_DELETE_MARKER_FILENAME,
+    has_delete_marker_file,
+    write_delete_marker_file,
+)
+from pip._internal.utils.misc import (
+    ask_path_exists,
+    backup_dir,
+    display_path,
+    dist_in_site_packages,
+    dist_in_usersite,
+    get_installed_version,
+    hide_url,
+    redact_auth_from_url,
+    rmtree,
+)
+from pip._internal.utils.packaging import get_metadata
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.virtualenv import running_under_virtualenv
+from pip._internal.vcs import vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Dict, Iterable, List, Optional, Sequence, Union,
+    )
+    from pip._internal.build_env import BuildEnvironment
+    from pip._internal.cache import WheelCache
+    from pip._internal.index.package_finder import PackageFinder
+    from pip._vendor.pkg_resources import Distribution
+    from pip._vendor.packaging.specifiers import SpecifierSet
+    from pip._vendor.packaging.markers import Marker
+
+
+logger = logging.getLogger(__name__)
+
+
+def _get_dist(metadata_directory):
+    # type: (str) -> Distribution
+    """Return a pkg_resources.Distribution for the provided
+    metadata directory.
+    """
+    dist_dir = metadata_directory.rstrip(os.sep)
+
+    # Determine the correct Distribution object type.
+    if dist_dir.endswith(".egg-info"):
+        dist_cls = pkg_resources.Distribution
+    else:
+        assert dist_dir.endswith(".dist-info")
+        dist_cls = pkg_resources.DistInfoDistribution
+
+    # Build a PathMetadata object, from path to metadata. :wink:
+    base_dir, dist_dir_name = os.path.split(dist_dir)
+    dist_name = os.path.splitext(dist_dir_name)[0]
+    metadata = pkg_resources.PathMetadata(base_dir, dist_dir)
+
+    return dist_cls(
+        base_dir,
+        project_name=dist_name,
+        metadata=metadata,
+    )
+
+
+class InstallRequirement(object):
+    """
+    Represents something that may be installed later on, may have information
+    about where to fetch the relevant requirement and also contains logic for
+    installing the said requirement.
+    """
+
+    def __init__(
+        self,
+        req,  # type: Optional[Requirement]
+        comes_from,  # type: Optional[Union[str, InstallRequirement]]
+        source_dir=None,  # type: Optional[str]
+        editable=False,  # type: bool
+        link=None,  # type: Optional[Link]
+        markers=None,  # type: Optional[Marker]
+        use_pep517=None,  # type: Optional[bool]
+        isolated=False,  # type: bool
+        options=None,  # type: Optional[Dict[str, Any]]
+        wheel_cache=None,  # type: Optional[WheelCache]
+        constraint=False,  # type: bool
+        extras=()  # type: Iterable[str]
+    ):
+        # type: (...) -> None
+        assert req is None or isinstance(req, Requirement), req
+        self.req = req
+        self.comes_from = comes_from
+        self.constraint = constraint
+        if source_dir is None:
+            self.source_dir = None  # type: Optional[str]
+        else:
+            self.source_dir = os.path.normpath(os.path.abspath(source_dir))
+        self.editable = editable
+
+        self._wheel_cache = wheel_cache
+        if link is None and req and req.url:
+            # PEP 508 URL requirement
+            link = Link(req.url)
+        self.link = self.original_link = link
+        # Path to any downloaded or already-existing package.
+        self.local_file_path = None  # type: Optional[str]
+        if self.link and self.link.is_file:
+            self.local_file_path = self.link.file_path
+
+        if extras:
+            self.extras = extras
+        elif req:
+            self.extras = {
+                pkg_resources.safe_extra(extra) for extra in req.extras
+            }
+        else:
+            self.extras = set()
+        if markers is None and req:
+            markers = req.marker
+        self.markers = markers
+
+        # This holds the pkg_resources.Distribution object if this requirement
+        # is already available:
+        self.satisfied_by = None  # type: Optional[Distribution]
+        # Whether the installation process should try to uninstall an existing
+        # distribution before installing this requirement.
+        self.should_reinstall = False
+        # Temporary build location
+        self._temp_build_dir = None  # type: Optional[TempDirectory]
+        # Set to True after successful installation
+        self.install_succeeded = None  # type: Optional[bool]
+        self.options = options if options else {}
+        # Set to True after successful preparation of this requirement
+        self.prepared = False
+        self.is_direct = False
+
+        self.isolated = isolated
+        self.build_env = NoOpBuildEnvironment()  # type: BuildEnvironment
+
+        # For PEP 517, the directory where we request the project metadata
+        # gets stored. We need this to pass to build_wheel, so the backend
+        # can ensure that the wheel matches the metadata (see the PEP for
+        # details).
+        self.metadata_directory = None  # type: Optional[str]
+
+        # The static build requirements (from pyproject.toml)
+        self.pyproject_requires = None  # type: Optional[List[str]]
+
+        # Build requirements that we will check are available
+        self.requirements_to_check = []  # type: List[str]
+
+        # The PEP 517 backend we should use to build the project
+        self.pep517_backend = None  # type: Optional[Pep517HookCaller]
+
+        # Are we using PEP 517 for this requirement?
+        # After pyproject.toml has been loaded, the only valid values are True
+        # and False. Before loading, None is valid (meaning "use the default").
+        # Setting an explicit value before loading pyproject.toml is supported,
+        # but after loading this flag should be treated as read only.
+        self.use_pep517 = use_pep517
+
+    def __str__(self):
+        # type: () -> str
+        if self.req:
+            s = str(self.req)
+            if self.link:
+                s += ' from %s' % redact_auth_from_url(self.link.url)
+        elif self.link:
+            s = redact_auth_from_url(self.link.url)
+        else:
+            s = '<InstallRequirement>'
+        if self.satisfied_by is not None:
+            s += ' in %s' % display_path(self.satisfied_by.location)
+        if self.comes_from:
+            if isinstance(self.comes_from, six.string_types):
+                comes_from = self.comes_from  # type: Optional[str]
+            else:
+                comes_from = self.comes_from.from_path()
+            if comes_from:
+                s += ' (from %s)' % comes_from
+        return s
+
+    def __repr__(self):
+        # type: () -> str
+        return '<%s object: %s editable=%r>' % (
+            self.__class__.__name__, str(self), self.editable)
+
+    def format_debug(self):
+        # type: () -> str
+        """An un-tested helper for getting state, for debugging.
+        """
+        attributes = vars(self)
+        names = sorted(attributes)
+
+        state = (
+            "{}={!r}".format(attr, attributes[attr]) for attr in sorted(names)
+        )
+        return '<{name} object: {{{state}}}>'.format(
+            name=self.__class__.__name__,
+            state=", ".join(state),
+        )
+
+    def populate_link(self, finder, upgrade, require_hashes):
+        # type: (PackageFinder, bool, bool) -> None
+        """Ensure that if a link can be found for this, that it is found.
+
+        Note that self.link may still be None - if Upgrade is False and the
+        requirement is already installed.
+
+        If require_hashes is True, don't use the wheel cache, because cached
+        wheels, always built locally, have different hashes than the files
+        downloaded from the index server and thus throw false hash mismatches.
+        Furthermore, cached wheels at present have undeterministic contents due
+        to file modification times.
+        """
+        if self.link is None:
+            self.link = finder.find_requirement(self, upgrade)
+        if self._wheel_cache is not None and not require_hashes:
+            old_link = self.link
+            supported_tags = pep425tags.get_supported()
+            self.link = self._wheel_cache.get(
+                link=self.link,
+                package_name=self.name,
+                supported_tags=supported_tags,
+            )
+            if old_link != self.link:
+                logger.debug('Using cached wheel link: %s', self.link)
+
+    # Things that are valid for all kinds of requirements?
+    @property
+    def name(self):
+        # type: () -> Optional[str]
+        if self.req is None:
+            return None
+        return six.ensure_str(pkg_resources.safe_name(self.req.name))
+
+    @property
+    def specifier(self):
+        # type: () -> SpecifierSet
+        return self.req.specifier
+
+    @property
+    def is_pinned(self):
+        # type: () -> bool
+        """Return whether I am pinned to an exact version.
+
+        For example, some-package==1.2 is pinned; some-package>1.2 is not.
+        """
+        specifiers = self.specifier
+        return (len(specifiers) == 1 and
+                next(iter(specifiers)).operator in {'==', '==='})
+
+    @property
+    def installed_version(self):
+        # type: () -> Optional[str]
+        return get_installed_version(self.name)
+
+    def match_markers(self, extras_requested=None):
+        # type: (Optional[Iterable[str]]) -> bool
+        if not extras_requested:
+            # Provide an extra to safely evaluate the markers
+            # without matching any extra
+            extras_requested = ('',)
+        if self.markers is not None:
+            return any(
+                self.markers.evaluate({'extra': extra})
+                for extra in extras_requested)
+        else:
+            return True
+
+    @property
+    def has_hash_options(self):
+        # type: () -> bool
+        """Return whether any known-good hashes are specified as options.
+
+        These activate --require-hashes mode; hashes specified as part of a
+        URL do not.
+
+        """
+        return bool(self.options.get('hashes', {}))
+
+    def hashes(self, trust_internet=True):
+        # type: (bool) -> Hashes
+        """Return a hash-comparer that considers my option- and URL-based
+        hashes to be known-good.
+
+        Hashes in URLs--ones embedded in the requirements file, not ones
+        downloaded from an index server--are almost peers with ones from
+        flags. They satisfy --require-hashes (whether it was implicitly or
+        explicitly activated) but do not activate it. md5 and sha224 are not
+        allowed in flags, which should nudge people toward good algos. We
+        always OR all hashes together, even ones from URLs.
+
+        :param trust_internet: Whether to trust URL-based (#md5=...) hashes
+            downloaded from the internet, as by populate_link()
+
+        """
+        good_hashes = self.options.get('hashes', {}).copy()
+        link = self.link if trust_internet else self.original_link
+        if link and link.hash:
+            good_hashes.setdefault(link.hash_name, []).append(link.hash)
+        return Hashes(good_hashes)
+
+    def from_path(self):
+        # type: () -> Optional[str]
+        """Format a nice indicator to show where this "comes from"
+        """
+        if self.req is None:
+            return None
+        s = str(self.req)
+        if self.comes_from:
+            if isinstance(self.comes_from, six.string_types):
+                comes_from = self.comes_from
+            else:
+                comes_from = self.comes_from.from_path()
+            if comes_from:
+                s += '->' + comes_from
+        return s
+
+    def ensure_build_location(self, build_dir):
+        # type: (str) -> str
+        assert build_dir is not None
+        if self._temp_build_dir is not None:
+            assert self._temp_build_dir.path
+            return self._temp_build_dir.path
+        if self.req is None:
+            # Some systems have /tmp as a symlink which confuses custom
+            # builds (such as numpy). Thus, we ensure that the real path
+            # is returned.
+            self._temp_build_dir = TempDirectory(kind="req-build")
+
+            return self._temp_build_dir.path
+        if self.editable:
+            name = self.name.lower()
+        else:
+            name = self.name
+        # FIXME: Is there a better place to create the build_dir? (hg and bzr
+        # need this)
+        if not os.path.exists(build_dir):
+            logger.debug('Creating directory %s', build_dir)
+            os.makedirs(build_dir)
+            write_delete_marker_file(build_dir)
+        return os.path.join(build_dir, name)
+
+    def _set_requirement(self):
+        # type: () -> None
+        """Set requirement after generating metadata.
+        """
+        assert self.req is None
+        assert self.metadata is not None
+        assert self.source_dir is not None
+
+        # Construct a Requirement object from the generated metadata
+        if isinstance(parse_version(self.metadata["Version"]), Version):
+            op = "=="
+        else:
+            op = "==="
+
+        self.req = Requirement(
+            "".join([
+                self.metadata["Name"],
+                op,
+                self.metadata["Version"],
+            ])
+        )
+
+    def warn_on_mismatching_name(self):
+        # type: () -> None
+        metadata_name = canonicalize_name(self.metadata["Name"])
+        if canonicalize_name(self.req.name) == metadata_name:
+            # Everything is fine.
+            return
+
+        # If we're here, there's a mismatch. Log a warning about it.
+        logger.warning(
+            'Generating metadata for package %s '
+            'produced metadata for project name %s. Fix your '
+            '#egg=%s fragments.',
+            self.name, metadata_name, self.name
+        )
+        self.req = Requirement(metadata_name)
+
+    def remove_temporary_source(self):
+        # type: () -> None
+        """Remove the source files from this requirement, if they are marked
+        for deletion"""
+        if self.source_dir and has_delete_marker_file(self.source_dir):
+            logger.debug('Removing source in %s', self.source_dir)
+            rmtree(self.source_dir)
+        self.source_dir = None
+        if self._temp_build_dir:
+            self._temp_build_dir.cleanup()
+            self._temp_build_dir = None
+        self.build_env.cleanup()
+
+    def check_if_exists(self, use_user_site):
+        # type: (bool) -> None
+        """Find an installed distribution that satisfies or conflicts
+        with this requirement, and set self.satisfied_by or
+        self.should_reinstall appropriately.
+        """
+        if self.req is None:
+            return
+        # get_distribution() will resolve the entire list of requirements
+        # anyway, and we've already determined that we need the requirement
+        # in question, so strip the marker so that we don't try to
+        # evaluate it.
+        no_marker = Requirement(str(self.req))
+        no_marker.marker = None
+        try:
+            self.satisfied_by = pkg_resources.get_distribution(str(no_marker))
+        except pkg_resources.DistributionNotFound:
+            return
+        except pkg_resources.VersionConflict:
+            existing_dist = pkg_resources.get_distribution(
+                self.req.name
+            )
+            if use_user_site:
+                if dist_in_usersite(existing_dist):
+                    self.should_reinstall = True
+                elif (running_under_virtualenv() and
+                        dist_in_site_packages(existing_dist)):
+                    raise InstallationError(
+                        "Will not install to the user site because it will "
+                        "lack sys.path precedence to %s in %s" %
+                        (existing_dist.project_name, existing_dist.location)
+                    )
+            else:
+                self.should_reinstall = True
+        else:
+            if self.editable and self.satisfied_by:
+                self.should_reinstall = True
+                # when installing editables, nothing pre-existing should ever
+                # satisfy
+                self.satisfied_by = None
+
+    # Things valid for wheels
+    @property
+    def is_wheel(self):
+        # type: () -> bool
+        if not self.link:
+            return False
+        return self.link.is_wheel
+
+    # Things valid for sdists
+    @property
+    def unpacked_source_directory(self):
+        # type: () -> str
+        return os.path.join(
+            self.source_dir,
+            self.link and self.link.subdirectory_fragment or '')
+
+    @property
+    def setup_py_path(self):
+        # type: () -> str
+        assert self.source_dir, "No source dir for %s" % self
+        setup_py = os.path.join(self.unpacked_source_directory, 'setup.py')
+
+        # Python2 __file__ should not be unicode
+        if six.PY2 and isinstance(setup_py, six.text_type):
+            setup_py = setup_py.encode(sys.getfilesystemencoding())
+
+        return setup_py
+
+    @property
+    def pyproject_toml_path(self):
+        # type: () -> str
+        assert self.source_dir, "No source dir for %s" % self
+        return make_pyproject_path(self.unpacked_source_directory)
+
+    def load_pyproject_toml(self):
+        # type: () -> None
+        """Load the pyproject.toml file.
+
+        After calling this routine, all of the attributes related to PEP 517
+        processing for this requirement have been set. In particular, the
+        use_pep517 attribute can be used to determine whether we should
+        follow the PEP 517 or legacy (setup.py) code path.
+        """
+        pyproject_toml_data = load_pyproject_toml(
+            self.use_pep517,
+            self.pyproject_toml_path,
+            self.setup_py_path,
+            str(self)
+        )
+
+        if pyproject_toml_data is None:
+            self.use_pep517 = False
+            return
+
+        self.use_pep517 = True
+        requires, backend, check, backend_path = pyproject_toml_data
+        self.requirements_to_check = check
+        self.pyproject_requires = requires
+        self.pep517_backend = Pep517HookCaller(
+            self.unpacked_source_directory, backend, backend_path=backend_path,
+        )
+
+    def _generate_metadata(self):
+        # type: () -> str
+        """Invokes metadata generator functions, with the required arguments.
+        """
+        if not self.use_pep517:
+            assert self.unpacked_source_directory
+
+            return generate_metadata_legacy(
+                build_env=self.build_env,
+                setup_py_path=self.setup_py_path,
+                source_dir=self.unpacked_source_directory,
+                editable=self.editable,
+                isolated=self.isolated,
+                details=self.name or "from {}".format(self.link)
+            )
+
+        assert self.pep517_backend is not None
+
+        return generate_metadata(
+            build_env=self.build_env,
+            backend=self.pep517_backend,
+        )
+
+    def prepare_metadata(self):
+        # type: () -> None
+        """Ensure that project metadata is available.
+
+        Under PEP 517, call the backend hook to prepare the metadata.
+        Under legacy processing, call setup.py egg-info.
+        """
+        assert self.source_dir
+
+        with indent_log():
+            self.metadata_directory = self._generate_metadata()
+
+        # Act on the newly generated metadata, based on the name and version.
+        if not self.name:
+            self._set_requirement()
+        else:
+            self.warn_on_mismatching_name()
+
+        self.assert_source_matches_version()
+
+    @property
+    def metadata(self):
+        # type: () -> Any
+        if not hasattr(self, '_metadata'):
+            self._metadata = get_metadata(self.get_dist())
+
+        return self._metadata
+
+    def get_dist(self):
+        # type: () -> Distribution
+        return _get_dist(self.metadata_directory)
+
+    def assert_source_matches_version(self):
+        # type: () -> None
+        assert self.source_dir
+        version = self.metadata['version']
+        if self.req.specifier and version not in self.req.specifier:
+            logger.warning(
+                'Requested %s, but installing version %s',
+                self,
+                version,
+            )
+        else:
+            logger.debug(
+                'Source in %s has version %s, which satisfies requirement %s',
+                display_path(self.source_dir),
+                version,
+                self,
+            )
+
+    # For both source distributions and editables
+    def ensure_has_source_dir(self, parent_dir):
+        # type: (str) -> None
+        """Ensure that a source_dir is set.
+
+        This will create a temporary build dir if the name of the requirement
+        isn't known yet.
+
+        :param parent_dir: The ideal pip parent_dir for the source_dir.
+            Generally src_dir for editables and build_dir for sdists.
+        :return: self.source_dir
+        """
+        if self.source_dir is None:
+            self.source_dir = self.ensure_build_location(parent_dir)
+
+    # For editable installations
+    def update_editable(self, obtain=True):
+        # type: (bool) -> None
+        if not self.link:
+            logger.debug(
+                "Cannot update repository at %s; repository location is "
+                "unknown",
+                self.source_dir,
+            )
+            return
+        assert self.editable
+        assert self.source_dir
+        if self.link.scheme == 'file':
+            # Static paths don't get updated
+            return
+        assert '+' in self.link.url, "bad url: %r" % self.link.url
+        vc_type, url = self.link.url.split('+', 1)
+        vcs_backend = vcs.get_backend(vc_type)
+        if vcs_backend:
+            if not self.link.is_vcs:
+                reason = (
+                    "This form of VCS requirement is being deprecated: {}."
+                ).format(
+                    self.link.url
+                )
+                replacement = None
+                if self.link.url.startswith("git+git@"):
+                    replacement = (
+                        "git+https://git@example.com/..., "
+                        "git+ssh://git@example.com/..., "
+                        "or the insecure git+git://git@example.com/..."
+                    )
+                deprecated(reason, replacement, gone_in="21.0", issue=7554)
+            hidden_url = hide_url(self.link.url)
+            if obtain:
+                vcs_backend.obtain(self.source_dir, url=hidden_url)
+            else:
+                vcs_backend.export(self.source_dir, url=hidden_url)
+        else:
+            assert 0, (
+                'Unexpected version control type (in %s): %s'
+                % (self.link, vc_type))
+
+    # Top-level Actions
+    def uninstall(self, auto_confirm=False, verbose=False):
+        # type: (bool, bool) -> Optional[UninstallPathSet]
+        """
+        Uninstall the distribution currently satisfying this requirement.
+
+        Prompts before removing or modifying files unless
+        ``auto_confirm`` is True.
+
+        Refuses to delete or modify files outside of ``sys.prefix`` -
+        thus uninstallation within a virtual environment can only
+        modify that virtual environment, even if the virtualenv is
+        linked to global site-packages.
+
+        """
+        assert self.req
+        try:
+            dist = pkg_resources.get_distribution(self.req.name)
+        except pkg_resources.DistributionNotFound:
+            logger.warning("Skipping %s as it is not installed.", self.name)
+            return None
+        else:
+            logger.info('Found existing installation: %s', dist)
+
+        uninstalled_pathset = UninstallPathSet.from_dist(dist)
+        uninstalled_pathset.remove(auto_confirm, verbose)
+        return uninstalled_pathset
+
+    def _get_archive_name(self, path, parentdir, rootdir):
+        # type: (str, str, str) -> str
+
+        def _clean_zip_name(name, prefix):
+            # type: (str, str) -> str
+            assert name.startswith(prefix + os.path.sep), (
+                "name %r doesn't start with prefix %r" % (name, prefix)
+            )
+            name = name[len(prefix) + 1:]
+            name = name.replace(os.path.sep, '/')
+            return name
+
+        path = os.path.join(parentdir, path)
+        name = _clean_zip_name(path, rootdir)
+        return self.name + '/' + name
+
+    def archive(self, build_dir):
+        # type: (str) -> None
+        """Saves archive to provided build_dir.
+
+        Used for saving downloaded VCS requirements as part of `pip download`.
+        """
+        assert self.source_dir
+
+        create_archive = True
+        archive_name = '%s-%s.zip' % (self.name, self.metadata["version"])
+        archive_path = os.path.join(build_dir, archive_name)
+
+        if os.path.exists(archive_path):
+            response = ask_path_exists(
+                'The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)bort ' %
+                display_path(archive_path), ('i', 'w', 'b', 'a'))
+            if response == 'i':
+                create_archive = False
+            elif response == 'w':
+                logger.warning('Deleting %s', display_path(archive_path))
+                os.remove(archive_path)
+            elif response == 'b':
+                dest_file = backup_dir(archive_path)
+                logger.warning(
+                    'Backing up %s to %s',
+                    display_path(archive_path),
+                    display_path(dest_file),
+                )
+                shutil.move(archive_path, dest_file)
+            elif response == 'a':
+                sys.exit(-1)
+
+        if not create_archive:
+            return
+
+        zip_output = zipfile.ZipFile(
+            archive_path, 'w', zipfile.ZIP_DEFLATED, allowZip64=True,
+        )
+        with zip_output:
+            dir = os.path.normcase(
+                os.path.abspath(self.unpacked_source_directory)
+            )
+            for dirpath, dirnames, filenames in os.walk(dir):
+                if 'pip-egg-info' in dirnames:
+                    dirnames.remove('pip-egg-info')
+                for dirname in dirnames:
+                    dir_arcname = self._get_archive_name(
+                        dirname, parentdir=dirpath, rootdir=dir,
+                    )
+                    zipdir = zipfile.ZipInfo(dir_arcname + '/')
+                    zipdir.external_attr = 0x1ED << 16  # 0o755
+                    zip_output.writestr(zipdir, '')
+                for filename in filenames:
+                    if filename == PIP_DELETE_MARKER_FILENAME:
+                        continue
+                    file_arcname = self._get_archive_name(
+                        filename, parentdir=dirpath, rootdir=dir,
+                    )
+                    filename = os.path.join(dirpath, filename)
+                    zip_output.write(filename, file_arcname)
+
+        logger.info('Saved %s', display_path(archive_path))
+
+    def install(
+        self,
+        install_options,  # type: List[str]
+        global_options=None,  # type: Optional[Sequence[str]]
+        root=None,  # type: Optional[str]
+        home=None,  # type: Optional[str]
+        prefix=None,  # type: Optional[str]
+        warn_script_location=True,  # type: bool
+        use_user_site=False,  # type: bool
+        pycompile=True  # type: bool
+    ):
+        # type: (...) -> None
+        scheme = get_scheme(
+            self.name,
+            user=use_user_site,
+            home=home,
+            root=root,
+            isolated=self.isolated,
+            prefix=prefix,
+        )
+
+        global_options = global_options if global_options is not None else []
+        if self.editable:
+            install_editable_legacy(
+                install_options,
+                global_options,
+                prefix=prefix,
+                home=home,
+                use_user_site=use_user_site,
+                name=self.name,
+                setup_py_path=self.setup_py_path,
+                isolated=self.isolated,
+                build_env=self.build_env,
+                unpacked_source_directory=self.unpacked_source_directory,
+            )
+            self.install_succeeded = True
+            return
+
+        if self.is_wheel:
+            assert self.local_file_path
+            install_wheel(
+                self.name,
+                self.local_file_path,
+                scheme=scheme,
+                req_description=str(self.req),
+                pycompile=pycompile,
+                warn_script_location=warn_script_location,
+            )
+            self.install_succeeded = True
+            return
+
+        install_legacy(
+            self,
+            install_options=install_options,
+            global_options=global_options,
+            root=root,
+            home=home,
+            prefix=prefix,
+            use_user_site=use_user_site,
+            pycompile=pycompile,
+            scheme=scheme,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py
new file mode 100644
index 0000000000000000000000000000000000000000..087ac5925f52c99345cffe693d6a392e39bd70c4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_set.py
@@ -0,0 +1,209 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+from collections import OrderedDict
+
+from pip._vendor.packaging.utils import canonicalize_name
+
+from pip._internal import pep425tags
+from pip._internal.exceptions import InstallationError
+from pip._internal.models.wheel import Wheel
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Dict, Iterable, List, Optional, Tuple
+    from pip._internal.req.req_install import InstallRequirement
+
+
+logger = logging.getLogger(__name__)
+
+
+class RequirementSet(object):
+
+    def __init__(self, check_supported_wheels=True):
+        # type: (bool) -> None
+        """Create a RequirementSet.
+        """
+
+        self.requirements = OrderedDict()  # type: Dict[str, InstallRequirement]  # noqa: E501
+        self.check_supported_wheels = check_supported_wheels
+
+        self.unnamed_requirements = []  # type: List[InstallRequirement]
+        self.successfully_downloaded = []  # type: List[InstallRequirement]
+        self.reqs_to_cleanup = []  # type: List[InstallRequirement]
+
+    def __str__(self):
+        # type: () -> str
+        requirements = sorted(
+            (req for req in self.requirements.values() if not req.comes_from),
+            key=lambda req: canonicalize_name(req.name),
+        )
+        return ' '.join(str(req.req) for req in requirements)
+
+    def __repr__(self):
+        # type: () -> str
+        requirements = sorted(
+            self.requirements.values(),
+            key=lambda req: canonicalize_name(req.name),
+        )
+
+        format_string = '<{classname} object; {count} requirement(s): {reqs}>'
+        return format_string.format(
+            classname=self.__class__.__name__,
+            count=len(requirements),
+            reqs=', '.join(str(req.req) for req in requirements),
+        )
+
+    def add_unnamed_requirement(self, install_req):
+        # type: (InstallRequirement) -> None
+        assert not install_req.name
+        self.unnamed_requirements.append(install_req)
+
+    def add_named_requirement(self, install_req):
+        # type: (InstallRequirement) -> None
+        assert install_req.name
+
+        project_name = canonicalize_name(install_req.name)
+        self.requirements[project_name] = install_req
+
+    def add_requirement(
+        self,
+        install_req,  # type: InstallRequirement
+        parent_req_name=None,  # type: Optional[str]
+        extras_requested=None  # type: Optional[Iterable[str]]
+    ):
+        # type: (...) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]]  # noqa: E501
+        """Add install_req as a requirement to install.
+
+        :param parent_req_name: The name of the requirement that needed this
+            added. The name is used because when multiple unnamed requirements
+            resolve to the same name, we could otherwise end up with dependency
+            links that point outside the Requirements set. parent_req must
+            already be added. Note that None implies that this is a user
+            supplied requirement, vs an inferred one.
+        :param extras_requested: an iterable of extras used to evaluate the
+            environment markers.
+        :return: Additional requirements to scan. That is either [] if
+            the requirement is not applicable, or [install_req] if the
+            requirement is applicable and has just been added.
+        """
+        # If the markers do not match, ignore this requirement.
+        if not install_req.match_markers(extras_requested):
+            logger.info(
+                "Ignoring %s: markers '%s' don't match your environment",
+                install_req.name, install_req.markers,
+            )
+            return [], None
+
+        # If the wheel is not supported, raise an error.
+        # Should check this after filtering out based on environment markers to
+        # allow specifying different wheels based on the environment/OS, in a
+        # single requirements file.
+        if install_req.link and install_req.link.is_wheel:
+            wheel = Wheel(install_req.link.filename)
+            tags = pep425tags.get_supported()
+            if (self.check_supported_wheels and not wheel.supported(tags)):
+                raise InstallationError(
+                    "%s is not a supported wheel on this platform." %
+                    wheel.filename
+                )
+
+        # This next bit is really a sanity check.
+        assert install_req.is_direct == (parent_req_name is None), (
+            "a direct req shouldn't have a parent and also, "
+            "a non direct req should have a parent"
+        )
+
+        # Unnamed requirements are scanned again and the requirement won't be
+        # added as a dependency until after scanning.
+        if not install_req.name:
+            self.add_unnamed_requirement(install_req)
+            return [install_req], None
+
+        try:
+            existing_req = self.get_requirement(install_req.name)
+        except KeyError:
+            existing_req = None
+
+        has_conflicting_requirement = (
+            parent_req_name is None and
+            existing_req and
+            not existing_req.constraint and
+            existing_req.extras == install_req.extras and
+            existing_req.req.specifier != install_req.req.specifier
+        )
+        if has_conflicting_requirement:
+            raise InstallationError(
+                "Double requirement given: %s (already in %s, name=%r)"
+                % (install_req, existing_req, install_req.name)
+            )
+
+        # When no existing requirement exists, add the requirement as a
+        # dependency and it will be scanned again after.
+        if not existing_req:
+            self.add_named_requirement(install_req)
+            # We'd want to rescan this requirement later
+            return [install_req], install_req
+
+        # Assume there's no need to scan, and that we've already
+        # encountered this for scanning.
+        if install_req.constraint or not existing_req.constraint:
+            return [], existing_req
+
+        does_not_satisfy_constraint = (
+            install_req.link and
+            not (
+                existing_req.link and
+                install_req.link.path == existing_req.link.path
+            )
+        )
+        if does_not_satisfy_constraint:
+            self.reqs_to_cleanup.append(install_req)
+            raise InstallationError(
+                "Could not satisfy constraints for '%s': "
+                "installation from path or url cannot be "
+                "constrained to a version" % install_req.name,
+            )
+        # If we're now installing a constraint, mark the existing
+        # object for real installation.
+        existing_req.constraint = False
+        existing_req.extras = tuple(sorted(
+            set(existing_req.extras) | set(install_req.extras)
+        ))
+        logger.debug(
+            "Setting %s extras to: %s",
+            existing_req, existing_req.extras,
+        )
+        # Return the existing requirement for addition to the parent and
+        # scanning again.
+        return [existing_req], existing_req
+
+    def has_requirement(self, name):
+        # type: (str) -> bool
+        project_name = canonicalize_name(name)
+
+        return (
+            project_name in self.requirements and
+            not self.requirements[project_name].constraint
+        )
+
+    def get_requirement(self, name):
+        # type: (str) -> InstallRequirement
+        project_name = canonicalize_name(name)
+
+        if project_name in self.requirements:
+            return self.requirements[project_name]
+
+        raise KeyError("No project with the name %r" % name)
+
+    def cleanup_files(self):
+        # type: () -> None
+        """Clean up files, remove builds."""
+        logger.debug('Cleaning up...')
+        with indent_log():
+            for req in self.reqs_to_cleanup:
+                req.remove_temporary_source()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py
new file mode 100644
index 0000000000000000000000000000000000000000..84e0c0419fc7064b05b2de7507a38aeba3c2dfad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py
@@ -0,0 +1,150 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import contextlib
+import errno
+import hashlib
+import logging
+import os
+
+from pip._vendor import contextlib2
+
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from types import TracebackType
+    from typing import Dict, Iterator, Optional, Set, Type, Union
+    from pip._internal.req.req_install import InstallRequirement
+    from pip._internal.models.link import Link
+
+logger = logging.getLogger(__name__)
+
+
+@contextlib.contextmanager
+def update_env_context_manager(**changes):
+    # type: (str) -> Iterator[None]
+    target = os.environ
+
+    # Save values from the target and change them.
+    non_existent_marker = object()
+    saved_values = {}  # type: Dict[str, Union[object, str]]
+    for name, new_value in changes.items():
+        try:
+            saved_values[name] = target[name]
+        except KeyError:
+            saved_values[name] = non_existent_marker
+        target[name] = new_value
+
+    try:
+        yield
+    finally:
+        # Restore original values in the target.
+        for name, original_value in saved_values.items():
+            if original_value is non_existent_marker:
+                del target[name]
+            else:
+                assert isinstance(original_value, str)  # for mypy
+                target[name] = original_value
+
+
+@contextlib.contextmanager
+def get_requirement_tracker():
+    # type: () -> Iterator[RequirementTracker]
+    root = os.environ.get('PIP_REQ_TRACKER')
+    with contextlib2.ExitStack() as ctx:
+        if root is None:
+            root = ctx.enter_context(
+                TempDirectory(kind='req-tracker')
+            ).path
+            ctx.enter_context(update_env_context_manager(PIP_REQ_TRACKER=root))
+            logger.debug("Initialized build tracking at %s", root)
+
+        with RequirementTracker(root) as tracker:
+            yield tracker
+
+
+class RequirementTracker(object):
+
+    def __init__(self, root):
+        # type: (str) -> None
+        self._root = root
+        self._entries = set()  # type: Set[InstallRequirement]
+        logger.debug("Created build tracker: %s", self._root)
+
+    def __enter__(self):
+        # type: () -> RequirementTracker
+        logger.debug("Entered build tracker: %s", self._root)
+        return self
+
+    def __exit__(
+        self,
+        exc_type,  # type: Optional[Type[BaseException]]
+        exc_val,  # type: Optional[BaseException]
+        exc_tb  # type: Optional[TracebackType]
+    ):
+        # type: (...) -> None
+        self.cleanup()
+
+    def _entry_path(self, link):
+        # type: (Link) -> str
+        hashed = hashlib.sha224(link.url_without_fragment.encode()).hexdigest()
+        return os.path.join(self._root, hashed)
+
+    def add(self, req):
+        # type: (InstallRequirement) -> None
+        """Add an InstallRequirement to build tracking.
+        """
+
+        # Get the file to write information about this requirement.
+        entry_path = self._entry_path(req.link)
+
+        # Try reading from the file. If it exists and can be read from, a build
+        # is already in progress, so a LookupError is raised.
+        try:
+            with open(entry_path) as fp:
+                contents = fp.read()
+        except IOError as e:
+            # if the error is anything other than "file does not exist", raise.
+            if e.errno != errno.ENOENT:
+                raise
+        else:
+            message = '%s is already being built: %s' % (req.link, contents)
+            raise LookupError(message)
+
+        # If we're here, req should really not be building already.
+        assert req not in self._entries
+
+        # Start tracking this requirement.
+        with open(entry_path, 'w') as fp:
+            fp.write(str(req))
+        self._entries.add(req)
+
+        logger.debug('Added %s to build tracker %r', req, self._root)
+
+    def remove(self, req):
+        # type: (InstallRequirement) -> None
+        """Remove an InstallRequirement from build tracking.
+        """
+
+        # Delete the created file and the corresponding entries.
+        os.unlink(self._entry_path(req.link))
+        self._entries.remove(req)
+
+        logger.debug('Removed %s from build tracker %r', req, self._root)
+
+    def cleanup(self):
+        # type: () -> None
+        for req in set(self._entries):
+            self.remove(req)
+
+        logger.debug("Removed build tracker: %r", self._root)
+
+    @contextlib.contextmanager
+    def track(self, req):
+        # type: (InstallRequirement) -> Iterator[None]
+        self.add(req)
+        yield
+        self.remove(req)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py
new file mode 100644
index 0000000000000000000000000000000000000000..5971b130ec029478d59ea1761630605deb4a8b39
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py
@@ -0,0 +1,644 @@
+from __future__ import absolute_import
+
+import csv
+import functools
+import logging
+import os
+import sys
+import sysconfig
+
+from pip._vendor import pkg_resources
+
+from pip._internal.exceptions import UninstallationError
+from pip._internal.locations import bin_py, bin_user
+from pip._internal.utils.compat import WINDOWS, cache_from_source, uses_pycache
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import (
+    FakeFile,
+    ask,
+    dist_in_usersite,
+    dist_is_local,
+    egg_link_path,
+    is_local,
+    normalize_path,
+    renames,
+    rmtree,
+)
+from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Callable, Dict, Iterable, Iterator, List, Optional, Set, Tuple,
+    )
+    from pip._vendor.pkg_resources import Distribution
+
+logger = logging.getLogger(__name__)
+
+
+def _script_names(dist, script_name, is_gui):
+    # type: (Distribution, str, bool) -> List[str]
+    """Create the fully qualified name of the files created by
+    {console,gui}_scripts for the given ``dist``.
+    Returns the list of file names
+    """
+    if dist_in_usersite(dist):
+        bin_dir = bin_user
+    else:
+        bin_dir = bin_py
+    exe_name = os.path.join(bin_dir, script_name)
+    paths_to_remove = [exe_name]
+    if WINDOWS:
+        paths_to_remove.append(exe_name + '.exe')
+        paths_to_remove.append(exe_name + '.exe.manifest')
+        if is_gui:
+            paths_to_remove.append(exe_name + '-script.pyw')
+        else:
+            paths_to_remove.append(exe_name + '-script.py')
+    return paths_to_remove
+
+
+def _unique(fn):
+    # type: (Callable[..., Iterator[Any]]) -> Callable[..., Iterator[Any]]
+    @functools.wraps(fn)
+    def unique(*args, **kw):
+        # type: (Any, Any) -> Iterator[Any]
+        seen = set()  # type: Set[Any]
+        for item in fn(*args, **kw):
+            if item not in seen:
+                seen.add(item)
+                yield item
+    return unique
+
+
+@_unique
+def uninstallation_paths(dist):
+    # type: (Distribution) -> Iterator[str]
+    """
+    Yield all the uninstallation paths for dist based on RECORD-without-.py[co]
+
+    Yield paths to all the files in RECORD. For each .py file in RECORD, add
+    the .pyc and .pyo in the same directory.
+
+    UninstallPathSet.add() takes care of the __pycache__ .py[co].
+    """
+    r = csv.reader(FakeFile(dist.get_metadata_lines('RECORD')))
+    for row in r:
+        path = os.path.join(dist.location, row[0])
+        yield path
+        if path.endswith('.py'):
+            dn, fn = os.path.split(path)
+            base = fn[:-3]
+            path = os.path.join(dn, base + '.pyc')
+            yield path
+            path = os.path.join(dn, base + '.pyo')
+            yield path
+
+
+def compact(paths):
+    # type: (Iterable[str]) -> Set[str]
+    """Compact a path set to contain the minimal number of paths
+    necessary to contain all paths in the set. If /a/path/ and
+    /a/path/to/a/file.txt are both in the set, leave only the
+    shorter path."""
+
+    sep = os.path.sep
+    short_paths = set()  # type: Set[str]
+    for path in sorted(paths, key=len):
+        should_skip = any(
+            path.startswith(shortpath.rstrip("*")) and
+            path[len(shortpath.rstrip("*").rstrip(sep))] == sep
+            for shortpath in short_paths
+        )
+        if not should_skip:
+            short_paths.add(path)
+    return short_paths
+
+
+def compress_for_rename(paths):
+    # type: (Iterable[str]) -> Set[str]
+    """Returns a set containing the paths that need to be renamed.
+
+    This set may include directories when the original sequence of paths
+    included every file on disk.
+    """
+    case_map = dict((os.path.normcase(p), p) for p in paths)
+    remaining = set(case_map)
+    unchecked = sorted(set(os.path.split(p)[0]
+                           for p in case_map.values()), key=len)
+    wildcards = set()  # type: Set[str]
+
+    def norm_join(*a):
+        # type: (str) -> str
+        return os.path.normcase(os.path.join(*a))
+
+    for root in unchecked:
+        if any(os.path.normcase(root).startswith(w)
+               for w in wildcards):
+            # This directory has already been handled.
+            continue
+
+        all_files = set()  # type: Set[str]
+        all_subdirs = set()  # type: Set[str]
+        for dirname, subdirs, files in os.walk(root):
+            all_subdirs.update(norm_join(root, dirname, d)
+                               for d in subdirs)
+            all_files.update(norm_join(root, dirname, f)
+                             for f in files)
+        # If all the files we found are in our remaining set of files to
+        # remove, then remove them from the latter set and add a wildcard
+        # for the directory.
+        if not (all_files - remaining):
+            remaining.difference_update(all_files)
+            wildcards.add(root + os.sep)
+
+    return set(map(case_map.__getitem__, remaining)) | wildcards
+
+
+def compress_for_output_listing(paths):
+    # type: (Iterable[str]) -> Tuple[Set[str], Set[str]]
+    """Returns a tuple of 2 sets of which paths to display to user
+
+    The first set contains paths that would be deleted. Files of a package
+    are not added and the top-level directory of the package has a '*' added
+    at the end - to signify that all it's contents are removed.
+
+    The second set contains files that would have been skipped in the above
+    folders.
+    """
+
+    will_remove = set(paths)
+    will_skip = set()
+
+    # Determine folders and files
+    folders = set()
+    files = set()
+    for path in will_remove:
+        if path.endswith(".pyc"):
+            continue
+        if path.endswith("__init__.py") or ".dist-info" in path:
+            folders.add(os.path.dirname(path))
+        files.add(path)
+
+    # probably this one https://github.com/python/mypy/issues/390
+    _normcased_files = set(map(os.path.normcase, files))  # type: ignore
+
+    folders = compact(folders)
+
+    # This walks the tree using os.walk to not miss extra folders
+    # that might get added.
+    for folder in folders:
+        for dirpath, _, dirfiles in os.walk(folder):
+            for fname in dirfiles:
+                if fname.endswith(".pyc"):
+                    continue
+
+                file_ = os.path.join(dirpath, fname)
+                if (os.path.isfile(file_) and
+                        os.path.normcase(file_) not in _normcased_files):
+                    # We are skipping this file. Add it to the set.
+                    will_skip.add(file_)
+
+    will_remove = files | {
+        os.path.join(folder, "*") for folder in folders
+    }
+
+    return will_remove, will_skip
+
+
+class StashedUninstallPathSet(object):
+    """A set of file rename operations to stash files while
+    tentatively uninstalling them."""
+    def __init__(self):
+        # type: () -> None
+        # Mapping from source file root to [Adjacent]TempDirectory
+        # for files under that directory.
+        self._save_dirs = {}  # type: Dict[str, TempDirectory]
+        # (old path, new path) tuples for each move that may need
+        # to be undone.
+        self._moves = []  # type: List[Tuple[str, str]]
+
+    def _get_directory_stash(self, path):
+        # type: (str) -> str
+        """Stashes a directory.
+
+        Directories are stashed adjacent to their original location if
+        possible, or else moved/copied into the user's temp dir."""
+
+        try:
+            save_dir = AdjacentTempDirectory(path)  # type: TempDirectory
+        except OSError:
+            save_dir = TempDirectory(kind="uninstall")
+        self._save_dirs[os.path.normcase(path)] = save_dir
+
+        return save_dir.path
+
+    def _get_file_stash(self, path):
+        # type: (str) -> str
+        """Stashes a file.
+
+        If no root has been provided, one will be created for the directory
+        in the user's temp directory."""
+        path = os.path.normcase(path)
+        head, old_head = os.path.dirname(path), None
+        save_dir = None
+
+        while head != old_head:
+            try:
+                save_dir = self._save_dirs[head]
+                break
+            except KeyError:
+                pass
+            head, old_head = os.path.dirname(head), head
+        else:
+            # Did not find any suitable root
+            head = os.path.dirname(path)
+            save_dir = TempDirectory(kind='uninstall')
+            self._save_dirs[head] = save_dir
+
+        relpath = os.path.relpath(path, head)
+        if relpath and relpath != os.path.curdir:
+            return os.path.join(save_dir.path, relpath)
+        return save_dir.path
+
+    def stash(self, path):
+        # type: (str) -> str
+        """Stashes the directory or file and returns its new location.
+        Handle symlinks as files to avoid modifying the symlink targets.
+        """
+        path_is_dir = os.path.isdir(path) and not os.path.islink(path)
+        if path_is_dir:
+            new_path = self._get_directory_stash(path)
+        else:
+            new_path = self._get_file_stash(path)
+
+        self._moves.append((path, new_path))
+        if (path_is_dir and os.path.isdir(new_path)):
+            # If we're moving a directory, we need to
+            # remove the destination first or else it will be
+            # moved to inside the existing directory.
+            # We just created new_path ourselves, so it will
+            # be removable.
+            os.rmdir(new_path)
+        renames(path, new_path)
+        return new_path
+
+    def commit(self):
+        # type: () -> None
+        """Commits the uninstall by removing stashed files."""
+        for _, save_dir in self._save_dirs.items():
+            save_dir.cleanup()
+        self._moves = []
+        self._save_dirs = {}
+
+    def rollback(self):
+        # type: () -> None
+        """Undoes the uninstall by moving stashed files back."""
+        for p in self._moves:
+            logger.info("Moving to %s\n from %s", *p)
+
+        for new_path, path in self._moves:
+            try:
+                logger.debug('Replacing %s from %s', new_path, path)
+                if os.path.isfile(new_path) or os.path.islink(new_path):
+                    os.unlink(new_path)
+                elif os.path.isdir(new_path):
+                    rmtree(new_path)
+                renames(path, new_path)
+            except OSError as ex:
+                logger.error("Failed to restore %s", new_path)
+                logger.debug("Exception: %s", ex)
+
+        self.commit()
+
+    @property
+    def can_rollback(self):
+        # type: () -> bool
+        return bool(self._moves)
+
+
+class UninstallPathSet(object):
+    """A set of file paths to be removed in the uninstallation of a
+    requirement."""
+    def __init__(self, dist):
+        # type: (Distribution) -> None
+        self.paths = set()  # type: Set[str]
+        self._refuse = set()  # type: Set[str]
+        self.pth = {}  # type: Dict[str, UninstallPthEntries]
+        self.dist = dist
+        self._moved_paths = StashedUninstallPathSet()
+
+    def _permitted(self, path):
+        # type: (str) -> bool
+        """
+        Return True if the given path is one we are permitted to
+        remove/modify, False otherwise.
+
+        """
+        return is_local(path)
+
+    def add(self, path):
+        # type: (str) -> None
+        head, tail = os.path.split(path)
+
+        # we normalize the head to resolve parent directory symlinks, but not
+        # the tail, since we only want to uninstall symlinks, not their targets
+        path = os.path.join(normalize_path(head), os.path.normcase(tail))
+
+        if not os.path.exists(path):
+            return
+        if self._permitted(path):
+            self.paths.add(path)
+        else:
+            self._refuse.add(path)
+
+        # __pycache__ files can show up after 'installed-files.txt' is created,
+        # due to imports
+        if os.path.splitext(path)[1] == '.py' and uses_pycache:
+            self.add(cache_from_source(path))
+
+    def add_pth(self, pth_file, entry):
+        # type: (str, str) -> None
+        pth_file = normalize_path(pth_file)
+        if self._permitted(pth_file):
+            if pth_file not in self.pth:
+                self.pth[pth_file] = UninstallPthEntries(pth_file)
+            self.pth[pth_file].add(entry)
+        else:
+            self._refuse.add(pth_file)
+
+    def remove(self, auto_confirm=False, verbose=False):
+        # type: (bool, bool) -> None
+        """Remove paths in ``self.paths`` with confirmation (unless
+        ``auto_confirm`` is True)."""
+
+        if not self.paths:
+            logger.info(
+                "Can't uninstall '%s'. No files were found to uninstall.",
+                self.dist.project_name,
+            )
+            return
+
+        dist_name_version = (
+            self.dist.project_name + "-" + self.dist.version
+        )
+        logger.info('Uninstalling %s:', dist_name_version)
+
+        with indent_log():
+            if auto_confirm or self._allowed_to_proceed(verbose):
+                moved = self._moved_paths
+
+                for_rename = compress_for_rename(self.paths)
+
+                for path in sorted(compact(for_rename)):
+                    moved.stash(path)
+                    logger.debug('Removing file or directory %s', path)
+
+                for pth in self.pth.values():
+                    pth.remove()
+
+                logger.info('Successfully uninstalled %s', dist_name_version)
+
+    def _allowed_to_proceed(self, verbose):
+        # type: (bool) -> bool
+        """Display which files would be deleted and prompt for confirmation
+        """
+
+        def _display(msg, paths):
+            # type: (str, Iterable[str]) -> None
+            if not paths:
+                return
+
+            logger.info(msg)
+            with indent_log():
+                for path in sorted(compact(paths)):
+                    logger.info(path)
+
+        if not verbose:
+            will_remove, will_skip = compress_for_output_listing(self.paths)
+        else:
+            # In verbose mode, display all the files that are going to be
+            # deleted.
+            will_remove = set(self.paths)
+            will_skip = set()
+
+        _display('Would remove:', will_remove)
+        _display('Would not remove (might be manually added):', will_skip)
+        _display('Would not remove (outside of prefix):', self._refuse)
+        if verbose:
+            _display('Will actually move:', compress_for_rename(self.paths))
+
+        return ask('Proceed (y/n)? ', ('y', 'n')) == 'y'
+
+    def rollback(self):
+        # type: () -> None
+        """Rollback the changes previously made by remove()."""
+        if not self._moved_paths.can_rollback:
+            logger.error(
+                "Can't roll back %s; was not uninstalled",
+                self.dist.project_name,
+            )
+            return
+        logger.info('Rolling back uninstall of %s', self.dist.project_name)
+        self._moved_paths.rollback()
+        for pth in self.pth.values():
+            pth.rollback()
+
+    def commit(self):
+        # type: () -> None
+        """Remove temporary save dir: rollback will no longer be possible."""
+        self._moved_paths.commit()
+
+    @classmethod
+    def from_dist(cls, dist):
+        # type: (Distribution) -> UninstallPathSet
+        dist_path = normalize_path(dist.location)
+        if not dist_is_local(dist):
+            logger.info(
+                "Not uninstalling %s at %s, outside environment %s",
+                dist.key,
+                dist_path,
+                sys.prefix,
+            )
+            return cls(dist)
+
+        if dist_path in {p for p in {sysconfig.get_path("stdlib"),
+                                     sysconfig.get_path("platstdlib")}
+                         if p}:
+            logger.info(
+                "Not uninstalling %s at %s, as it is in the standard library.",
+                dist.key,
+                dist_path,
+            )
+            return cls(dist)
+
+        paths_to_remove = cls(dist)
+        develop_egg_link = egg_link_path(dist)
+        develop_egg_link_egg_info = '{}.egg-info'.format(
+            pkg_resources.to_filename(dist.project_name))
+        egg_info_exists = dist.egg_info and os.path.exists(dist.egg_info)
+        # Special case for distutils installed package
+        distutils_egg_info = getattr(dist._provider, 'path', None)
+
+        # Uninstall cases order do matter as in the case of 2 installs of the
+        # same package, pip needs to uninstall the currently detected version
+        if (egg_info_exists and dist.egg_info.endswith('.egg-info') and
+                not dist.egg_info.endswith(develop_egg_link_egg_info)):
+            # if dist.egg_info.endswith(develop_egg_link_egg_info), we
+            # are in fact in the develop_egg_link case
+            paths_to_remove.add(dist.egg_info)
+            if dist.has_metadata('installed-files.txt'):
+                for installed_file in dist.get_metadata(
+                        'installed-files.txt').splitlines():
+                    path = os.path.normpath(
+                        os.path.join(dist.egg_info, installed_file)
+                    )
+                    paths_to_remove.add(path)
+            # FIXME: need a test for this elif block
+            # occurs with --single-version-externally-managed/--record outside
+            # of pip
+            elif dist.has_metadata('top_level.txt'):
+                if dist.has_metadata('namespace_packages.txt'):
+                    namespaces = dist.get_metadata('namespace_packages.txt')
+                else:
+                    namespaces = []
+                for top_level_pkg in [
+                        p for p
+                        in dist.get_metadata('top_level.txt').splitlines()
+                        if p and p not in namespaces]:
+                    path = os.path.join(dist.location, top_level_pkg)
+                    paths_to_remove.add(path)
+                    paths_to_remove.add(path + '.py')
+                    paths_to_remove.add(path + '.pyc')
+                    paths_to_remove.add(path + '.pyo')
+
+        elif distutils_egg_info:
+            raise UninstallationError(
+                "Cannot uninstall {!r}. It is a distutils installed project "
+                "and thus we cannot accurately determine which files belong "
+                "to it which would lead to only a partial uninstall.".format(
+                    dist.project_name,
+                )
+            )
+
+        elif dist.location.endswith('.egg'):
+            # package installed by easy_install
+            # We cannot match on dist.egg_name because it can slightly vary
+            # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg
+            paths_to_remove.add(dist.location)
+            easy_install_egg = os.path.split(dist.location)[1]
+            easy_install_pth = os.path.join(os.path.dirname(dist.location),
+                                            'easy-install.pth')
+            paths_to_remove.add_pth(easy_install_pth, './' + easy_install_egg)
+
+        elif egg_info_exists and dist.egg_info.endswith('.dist-info'):
+            for path in uninstallation_paths(dist):
+                paths_to_remove.add(path)
+
+        elif develop_egg_link:
+            # develop egg
+            with open(develop_egg_link, 'r') as fh:
+                link_pointer = os.path.normcase(fh.readline().strip())
+            assert (link_pointer == dist.location), (
+                'Egg-link %s does not match installed location of %s '
+                '(at %s)' % (link_pointer, dist.project_name, dist.location)
+            )
+            paths_to_remove.add(develop_egg_link)
+            easy_install_pth = os.path.join(os.path.dirname(develop_egg_link),
+                                            'easy-install.pth')
+            paths_to_remove.add_pth(easy_install_pth, dist.location)
+
+        else:
+            logger.debug(
+                'Not sure how to uninstall: %s - Check: %s',
+                dist, dist.location,
+            )
+
+        # find distutils scripts= scripts
+        if dist.has_metadata('scripts') and dist.metadata_isdir('scripts'):
+            for script in dist.metadata_listdir('scripts'):
+                if dist_in_usersite(dist):
+                    bin_dir = bin_user
+                else:
+                    bin_dir = bin_py
+                paths_to_remove.add(os.path.join(bin_dir, script))
+                if WINDOWS:
+                    paths_to_remove.add(os.path.join(bin_dir, script) + '.bat')
+
+        # find console_scripts
+        _scripts_to_remove = []
+        console_scripts = dist.get_entry_map(group='console_scripts')
+        for name in console_scripts.keys():
+            _scripts_to_remove.extend(_script_names(dist, name, False))
+        # find gui_scripts
+        gui_scripts = dist.get_entry_map(group='gui_scripts')
+        for name in gui_scripts.keys():
+            _scripts_to_remove.extend(_script_names(dist, name, True))
+
+        for s in _scripts_to_remove:
+            paths_to_remove.add(s)
+
+        return paths_to_remove
+
+
+class UninstallPthEntries(object):
+    def __init__(self, pth_file):
+        # type: (str) -> None
+        if not os.path.isfile(pth_file):
+            raise UninstallationError(
+                "Cannot remove entries from nonexistent file %s" % pth_file
+            )
+        self.file = pth_file
+        self.entries = set()  # type: Set[str]
+        self._saved_lines = None  # type: Optional[List[bytes]]
+
+    def add(self, entry):
+        # type: (str) -> None
+        entry = os.path.normcase(entry)
+        # On Windows, os.path.normcase converts the entry to use
+        # backslashes.  This is correct for entries that describe absolute
+        # paths outside of site-packages, but all the others use forward
+        # slashes.
+        # os.path.splitdrive is used instead of os.path.isabs because isabs
+        # treats non-absolute paths with drive letter markings like c:foo\bar
+        # as absolute paths. It also does not recognize UNC paths if they don't
+        # have more than "\\sever\share". Valid examples: "\\server\share\" or
+        # "\\server\share\folder". Python 2.7.8+ support UNC in splitdrive.
+        if WINDOWS and not os.path.splitdrive(entry)[0]:
+            entry = entry.replace('\\', '/')
+        self.entries.add(entry)
+
+    def remove(self):
+        # type: () -> None
+        logger.debug('Removing pth entries from %s:', self.file)
+        with open(self.file, 'rb') as fh:
+            # windows uses '\r\n' with py3k, but uses '\n' with py2.x
+            lines = fh.readlines()
+            self._saved_lines = lines
+        if any(b'\r\n' in line for line in lines):
+            endline = '\r\n'
+        else:
+            endline = '\n'
+        # handle missing trailing newline
+        if lines and not lines[-1].endswith(endline.encode("utf-8")):
+            lines[-1] = lines[-1] + endline.encode("utf-8")
+        for entry in self.entries:
+            try:
+                logger.debug('Removing entry: %s', entry)
+                lines.remove((entry + endline).encode("utf-8"))
+            except ValueError:
+                pass
+        with open(self.file, 'wb') as fh:
+            fh.writelines(lines)
+
+    def rollback(self):
+        # type: () -> bool
+        if self._saved_lines is None:
+            logger.error(
+                'Cannot roll back changes to %s, none were made', self.file
+            )
+            return False
+        logger.debug('Rolling %s back to previous state', self.file)
+        with open(self.file, 'wb') as fh:
+            fh.writelines(self._saved_lines)
+        return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fc3c594acf96eb8dee7e69c9d835e16cd45cec3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py
@@ -0,0 +1,242 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import datetime
+import hashlib
+import json
+import logging
+import os.path
+import sys
+
+from pip._vendor import pkg_resources
+from pip._vendor.packaging import version as packaging_version
+from pip._vendor.six import ensure_binary
+
+from pip._internal.index.collector import LinkCollector
+from pip._internal.index.package_finder import PackageFinder
+from pip._internal.models.search_scope import SearchScope
+from pip._internal.models.selection_prefs import SelectionPreferences
+from pip._internal.utils.filesystem import (
+    adjacent_tmp_file,
+    check_path_owner,
+    replace,
+)
+from pip._internal.utils.misc import (
+    ensure_dir,
+    get_installed_version,
+    redact_auth_from_url,
+)
+from pip._internal.utils.packaging import get_installer
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    import optparse
+    from optparse import Values
+    from typing import Any, Dict, Text, Union
+
+    from pip._internal.network.session import PipSession
+
+
+SELFCHECK_DATE_FMT = "%Y-%m-%dT%H:%M:%SZ"
+
+
+logger = logging.getLogger(__name__)
+
+
+def make_link_collector(
+    session,  # type: PipSession
+    options,  # type: Values
+    suppress_no_index=False,  # type: bool
+):
+    # type: (...) -> LinkCollector
+    """
+    :param session: The Session to use to make requests.
+    :param suppress_no_index: Whether to ignore the --no-index option
+        when constructing the SearchScope object.
+    """
+    index_urls = [options.index_url] + options.extra_index_urls
+    if options.no_index and not suppress_no_index:
+        logger.debug(
+            'Ignoring indexes: %s',
+            ','.join(redact_auth_from_url(url) for url in index_urls),
+        )
+        index_urls = []
+
+    # Make sure find_links is a list before passing to create().
+    find_links = options.find_links or []
+
+    search_scope = SearchScope.create(
+        find_links=find_links, index_urls=index_urls,
+    )
+
+    link_collector = LinkCollector(session=session, search_scope=search_scope)
+
+    return link_collector
+
+
+def _get_statefile_name(key):
+    # type: (Union[str, Text]) -> str
+    key_bytes = ensure_binary(key)
+    name = hashlib.sha224(key_bytes).hexdigest()
+    return name
+
+
+class SelfCheckState(object):
+    def __init__(self, cache_dir):
+        # type: (str) -> None
+        self.state = {}  # type: Dict[str, Any]
+        self.statefile_path = None
+
+        # Try to load the existing state
+        if cache_dir:
+            self.statefile_path = os.path.join(
+                cache_dir, "selfcheck", _get_statefile_name(self.key)
+            )
+            try:
+                with open(self.statefile_path) as statefile:
+                    self.state = json.load(statefile)
+            except (IOError, ValueError, KeyError):
+                # Explicitly suppressing exceptions, since we don't want to
+                # error out if the cache file is invalid.
+                pass
+
+    @property
+    def key(self):
+        return sys.prefix
+
+    def save(self, pypi_version, current_time):
+        # type: (str, datetime.datetime) -> None
+        # If we do not have a path to cache in, don't bother saving.
+        if not self.statefile_path:
+            return
+
+        # Check to make sure that we own the directory
+        if not check_path_owner(os.path.dirname(self.statefile_path)):
+            return
+
+        # Now that we've ensured the directory is owned by this user, we'll go
+        # ahead and make sure that all our directories are created.
+        ensure_dir(os.path.dirname(self.statefile_path))
+
+        state = {
+            # Include the key so it's easy to tell which pip wrote the
+            # file.
+            "key": self.key,
+            "last_check": current_time.strftime(SELFCHECK_DATE_FMT),
+            "pypi_version": pypi_version,
+        }
+
+        text = json.dumps(state, sort_keys=True, separators=(",", ":"))
+
+        with adjacent_tmp_file(self.statefile_path) as f:
+            f.write(ensure_binary(text))
+
+        try:
+            # Since we have a prefix-specific state file, we can just
+            # overwrite whatever is there, no need to check.
+            replace(f.name, self.statefile_path)
+        except OSError:
+            # Best effort.
+            pass
+
+
+def was_installed_by_pip(pkg):
+    # type: (str) -> bool
+    """Checks whether pkg was installed by pip
+
+    This is used not to display the upgrade message when pip is in fact
+    installed by system package manager, such as dnf on Fedora.
+    """
+    try:
+        dist = pkg_resources.get_distribution(pkg)
+        return "pip" == get_installer(dist)
+    except pkg_resources.DistributionNotFound:
+        return False
+
+
+def pip_self_version_check(session, options):
+    # type: (PipSession, optparse.Values) -> None
+    """Check for an update for pip.
+
+    Limit the frequency of checks to once per week. State is stored either in
+    the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix
+    of the pip script path.
+    """
+    installed_version = get_installed_version("pip")
+    if not installed_version:
+        return
+
+    pip_version = packaging_version.parse(installed_version)
+    pypi_version = None
+
+    try:
+        state = SelfCheckState(cache_dir=options.cache_dir)
+
+        current_time = datetime.datetime.utcnow()
+        # Determine if we need to refresh the state
+        if "last_check" in state.state and "pypi_version" in state.state:
+            last_check = datetime.datetime.strptime(
+                state.state["last_check"],
+                SELFCHECK_DATE_FMT
+            )
+            if (current_time - last_check).total_seconds() < 7 * 24 * 60 * 60:
+                pypi_version = state.state["pypi_version"]
+
+        # Refresh the version if we need to or just see if we need to warn
+        if pypi_version is None:
+            # Lets use PackageFinder to see what the latest pip version is
+            link_collector = make_link_collector(
+                session,
+                options=options,
+                suppress_no_index=True,
+            )
+
+            # Pass allow_yanked=False so we don't suggest upgrading to a
+            # yanked version.
+            selection_prefs = SelectionPreferences(
+                allow_yanked=False,
+                allow_all_prereleases=False,  # Explicitly set to False
+            )
+
+            finder = PackageFinder.create(
+                link_collector=link_collector,
+                selection_prefs=selection_prefs,
+            )
+            best_candidate = finder.find_best_candidate("pip").best_candidate
+            if best_candidate is None:
+                return
+            pypi_version = str(best_candidate.version)
+
+            # save that we've performed a check
+            state.save(pypi_version, current_time)
+
+        remote_version = packaging_version.parse(pypi_version)
+
+        local_version_is_older = (
+            pip_version < remote_version and
+            pip_version.base_version != remote_version.base_version and
+            was_installed_by_pip('pip')
+        )
+
+        # Determine if our pypi_version is older
+        if not local_version_is_older:
+            return
+
+        # We cannot tell how the current pip is available in the current
+        # command context, so be pragmatic here and suggest the command
+        # that's always available. This does not accommodate spaces in
+        # `sys.executable`.
+        pip_cmd = "{} -m pip".format(sys.executable)
+        logger.warning(
+            "You are using pip version %s; however, version %s is "
+            "available.\nYou should consider upgrading via the "
+            "'%s install --upgrade pip' command.",
+            pip_version, pypi_version, pip_cmd
+        )
+    except Exception:
+        logger.debug(
+            "There was an error checking the latest version of pip",
+            exc_info=True,
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py
new file mode 100644
index 0000000000000000000000000000000000000000..251c5fd59a5c55536a55cdfdc5ae139d99098650
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py
@@ -0,0 +1,41 @@
+"""
+This code wraps the vendored appdirs module to so the return values are
+compatible for the current pip code base.
+
+The intention is to rewrite current usages gradually, keeping the tests pass,
+and eventually drop this after all usages are changed.
+"""
+
+from __future__ import absolute_import
+
+import os
+
+from pip._vendor import appdirs as _appdirs
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List
+
+
+def user_cache_dir(appname):
+    # type: (str) -> str
+    return _appdirs.user_cache_dir(appname, appauthor=False)
+
+
+def user_config_dir(appname, roaming=True):
+    # type: (str, bool) -> str
+    return _appdirs.user_config_dir(appname, appauthor=False, roaming=roaming)
+
+
+def user_data_dir(appname, roaming=False):
+    # type: (str, bool) -> str
+    return _appdirs.user_data_dir(appname, appauthor=False, roaming=roaming)
+
+
+def site_config_dirs(appname):
+    # type: (str) -> List[str]
+    dirval = _appdirs.site_config_dir(appname, appauthor=False, multipath=True)
+    if _appdirs.system not in ["win32", "darwin"]:
+        return dirval.split(os.pathsep)
+    return [dirval]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..6efa52ad2b8daece49acf69daa1196582220f4a3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/compat.py
@@ -0,0 +1,269 @@
+"""Stuff that differs in different Python versions and platform
+distributions."""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import, division
+
+import codecs
+import locale
+import logging
+import os
+import shutil
+import sys
+
+from pip._vendor.six import PY2, text_type
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Text, Tuple, Union
+
+try:
+    import ipaddress
+except ImportError:
+    try:
+        from pip._vendor import ipaddress  # type: ignore
+    except ImportError:
+        import ipaddr as ipaddress  # type: ignore
+        ipaddress.ip_address = ipaddress.IPAddress  # type: ignore
+        ipaddress.ip_network = ipaddress.IPNetwork  # type: ignore
+
+
+__all__ = [
+    "ipaddress", "uses_pycache", "console_to_str",
+    "get_path_uid", "stdlib_pkgs", "WINDOWS", "samefile", "get_terminal_size",
+]
+
+
+logger = logging.getLogger(__name__)
+
+if PY2:
+    import imp
+
+    try:
+        cache_from_source = imp.cache_from_source  # type: ignore
+    except AttributeError:
+        # does not use __pycache__
+        cache_from_source = None
+
+    uses_pycache = cache_from_source is not None
+else:
+    uses_pycache = True
+    from importlib.util import cache_from_source
+
+
+if PY2:
+    # In Python 2.7, backslashreplace exists
+    # but does not support use for decoding.
+    # We implement our own replace handler for this
+    # situation, so that we can consistently use
+    # backslash replacement for all versions.
+    def backslashreplace_decode_fn(err):
+        raw_bytes = (err.object[i] for i in range(err.start, err.end))
+        # Python 2 gave us characters - convert to numeric bytes
+        raw_bytes = (ord(b) for b in raw_bytes)
+        return u"".join(u"\\x%x" % c for c in raw_bytes), err.end
+    codecs.register_error(
+        "backslashreplace_decode",
+        backslashreplace_decode_fn,
+    )
+    backslashreplace_decode = "backslashreplace_decode"
+else:
+    backslashreplace_decode = "backslashreplace"
+
+
+def has_tls():
+    # type: () -> bool
+    try:
+        import _ssl  # noqa: F401  # ignore unused
+        return True
+    except ImportError:
+        pass
+
+    from pip._vendor.urllib3.util import IS_PYOPENSSL
+    return IS_PYOPENSSL
+
+
+def str_to_display(data, desc=None):
+    # type: (Union[bytes, Text], Optional[str]) -> Text
+    """
+    For display or logging purposes, convert a bytes object (or text) to
+    text (e.g. unicode in Python 2) safe for output.
+
+    :param desc: An optional phrase describing the input data, for use in
+        the log message if a warning is logged. Defaults to "Bytes object".
+
+    This function should never error out and so can take a best effort
+    approach. It is okay to be lossy if needed since the return value is
+    just for display.
+
+    We assume the data is in the locale preferred encoding. If it won't
+    decode properly, we warn the user but decode as best we can.
+
+    We also ensure that the output can be safely written to standard output
+    without encoding errors.
+    """
+    if isinstance(data, text_type):
+        return data
+
+    # Otherwise, data is a bytes object (str in Python 2).
+    # First, get the encoding we assume. This is the preferred
+    # encoding for the locale, unless that is not found, or
+    # it is ASCII, in which case assume UTF-8
+    encoding = locale.getpreferredencoding()
+    if (not encoding) or codecs.lookup(encoding).name == "ascii":
+        encoding = "utf-8"
+
+    # Now try to decode the data - if we fail, warn the user and
+    # decode with replacement.
+    try:
+        decoded_data = data.decode(encoding)
+    except UnicodeDecodeError:
+        if desc is None:
+            desc = 'Bytes object'
+        msg_format = '{} does not appear to be encoded as %s'.format(desc)
+        logger.warning(msg_format, encoding)
+        decoded_data = data.decode(encoding, errors=backslashreplace_decode)
+
+    # Make sure we can print the output, by encoding it to the output
+    # encoding with replacement of unencodable characters, and then
+    # decoding again.
+    # We use stderr's encoding because it's less likely to be
+    # redirected and if we don't find an encoding we skip this
+    # step (on the assumption that output is wrapped by something
+    # that won't fail).
+    # The double getattr is to deal with the possibility that we're
+    # being called in a situation where sys.__stderr__ doesn't exist,
+    # or doesn't have an encoding attribute. Neither of these cases
+    # should occur in normal pip use, but there's no harm in checking
+    # in case people use pip in (unsupported) unusual situations.
+    output_encoding = getattr(getattr(sys, "__stderr__", None),
+                              "encoding", None)
+
+    if output_encoding:
+        output_encoded = decoded_data.encode(
+            output_encoding,
+            errors="backslashreplace"
+        )
+        decoded_data = output_encoded.decode(output_encoding)
+
+    return decoded_data
+
+
+def console_to_str(data):
+    # type: (bytes) -> Text
+    """Return a string, safe for output, of subprocess output.
+    """
+    return str_to_display(data, desc='Subprocess output')
+
+
+def get_path_uid(path):
+    # type: (str) -> int
+    """
+    Return path's uid.
+
+    Does not follow symlinks:
+        https://github.com/pypa/pip/pull/935#discussion_r5307003
+
+    Placed this function in compat due to differences on AIX and
+    Jython, that should eventually go away.
+
+    :raises OSError: When path is a symlink or can't be read.
+    """
+    if hasattr(os, 'O_NOFOLLOW'):
+        fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW)
+        file_uid = os.fstat(fd).st_uid
+        os.close(fd)
+    else:  # AIX and Jython
+        # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW
+        if not os.path.islink(path):
+            # older versions of Jython don't have `os.fstat`
+            file_uid = os.stat(path).st_uid
+        else:
+            # raise OSError for parity with os.O_NOFOLLOW above
+            raise OSError(
+                "%s is a symlink; Will not return uid for symlinks" % path
+            )
+    return file_uid
+
+
+def expanduser(path):
+    # type: (str) -> str
+    """
+    Expand ~ and ~user constructions.
+
+    Includes a workaround for https://bugs.python.org/issue14768
+    """
+    expanded = os.path.expanduser(path)
+    if path.startswith('~/') and expanded.startswith('//'):
+        expanded = expanded[1:]
+    return expanded
+
+
+# packages in the stdlib that may have installation metadata, but should not be
+# considered 'installed'.  this theoretically could be determined based on
+# dist.location (py27:`sysconfig.get_paths()['stdlib']`,
+# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may
+# make this ineffective, so hard-coding
+stdlib_pkgs = {"python", "wsgiref", "argparse"}
+
+
+# windows detection, covers cpython and ironpython
+WINDOWS = (sys.platform.startswith("win") or
+           (sys.platform == 'cli' and os.name == 'nt'))
+
+
+def samefile(file1, file2):
+    # type: (str, str) -> bool
+    """Provide an alternative for os.path.samefile on Windows/Python2"""
+    if hasattr(os.path, 'samefile'):
+        return os.path.samefile(file1, file2)
+    else:
+        path1 = os.path.normcase(os.path.abspath(file1))
+        path2 = os.path.normcase(os.path.abspath(file2))
+        return path1 == path2
+
+
+if hasattr(shutil, 'get_terminal_size'):
+    def get_terminal_size():
+        # type: () -> Tuple[int, int]
+        """
+        Returns a tuple (x, y) representing the width(x) and the height(y)
+        in characters of the terminal window.
+        """
+        return tuple(shutil.get_terminal_size())  # type: ignore
+else:
+    def get_terminal_size():
+        # type: () -> Tuple[int, int]
+        """
+        Returns a tuple (x, y) representing the width(x) and the height(y)
+        in characters of the terminal window.
+        """
+        def ioctl_GWINSZ(fd):
+            try:
+                import fcntl
+                import termios
+                import struct
+                cr = struct.unpack_from(
+                    'hh',
+                    fcntl.ioctl(fd, termios.TIOCGWINSZ, '12345678')
+                )
+            except Exception:
+                return None
+            if cr == (0, 0):
+                return None
+            return cr
+        cr = ioctl_GWINSZ(0) or ioctl_GWINSZ(1) or ioctl_GWINSZ(2)
+        if not cr:
+            if sys.platform != "win32":
+                try:
+                    fd = os.open(os.ctermid(), os.O_RDONLY)
+                    cr = ioctl_GWINSZ(fd)
+                    os.close(fd)
+                except Exception:
+                    pass
+        if not cr:
+            cr = (os.environ.get('LINES', 25), os.environ.get('COLUMNS', 80))
+        return int(cr[1]), int(cr[0])
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f20cfd49d32f0bbab7b4719eb2dbdca971b751a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/deprecation.py
@@ -0,0 +1,104 @@
+"""
+A module that implements tooling to enable easy warnings about deprecations.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import warnings
+
+from pip._vendor.packaging.version import parse
+
+from pip import __version__ as current_version
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Optional
+
+
+DEPRECATION_MSG_PREFIX = "DEPRECATION: "
+
+
+class PipDeprecationWarning(Warning):
+    pass
+
+
+_original_showwarning = None  # type: Any
+
+
+# Warnings <-> Logging Integration
+def _showwarning(message, category, filename, lineno, file=None, line=None):
+    if file is not None:
+        if _original_showwarning is not None:
+            _original_showwarning(
+                message, category, filename, lineno, file, line,
+            )
+    elif issubclass(category, PipDeprecationWarning):
+        # We use a specially named logger which will handle all of the
+        # deprecation messages for pip.
+        logger = logging.getLogger("pip._internal.deprecations")
+        logger.warning(message)
+    else:
+        _original_showwarning(
+            message, category, filename, lineno, file, line,
+        )
+
+
+def install_warning_logger():
+    # type: () -> None
+    # Enable our Deprecation Warnings
+    warnings.simplefilter("default", PipDeprecationWarning, append=True)
+
+    global _original_showwarning
+
+    if _original_showwarning is None:
+        _original_showwarning = warnings.showwarning
+        warnings.showwarning = _showwarning
+
+
+def deprecated(reason, replacement, gone_in, issue=None):
+    # type: (str, Optional[str], Optional[str], Optional[int]) -> None
+    """Helper to deprecate existing functionality.
+
+    reason:
+        Textual reason shown to the user about why this functionality has
+        been deprecated.
+    replacement:
+        Textual suggestion shown to the user about what alternative
+        functionality they can use.
+    gone_in:
+        The version of pip does this functionality should get removed in.
+        Raises errors if pip's current version is greater than or equal to
+        this.
+    issue:
+        Issue number on the tracker that would serve as a useful place for
+        users to find related discussion and provide feedback.
+
+    Always pass replacement, gone_in and issue as keyword arguments for clarity
+    at the call site.
+    """
+
+    # Construct a nice message.
+    #   This is eagerly formatted as we want it to get logged as if someone
+    #   typed this entire message out.
+    sentences = [
+        (reason, DEPRECATION_MSG_PREFIX + "{}"),
+        (gone_in, "pip {} will remove support for this functionality."),
+        (replacement, "A possible replacement is {}."),
+        (issue, (
+            "You can find discussion regarding this at "
+            "https://github.com/pypa/pip/issues/{}."
+        )),
+    ]
+    message = " ".join(
+        template.format(val) for val, template in sentences if val is not None
+    )
+
+    # Raise as an error if it has to be removed.
+    if gone_in is not None and parse(current_version) >= parse(gone_in):
+        raise PipDeprecationWarning(message)
+
+    warnings.warn(message, category=PipDeprecationWarning, stacklevel=2)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py
new file mode 100644
index 0000000000000000000000000000000000000000..e38e402d7330778385f65a440b5b39f7bcbdedb3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/distutils_args.py
@@ -0,0 +1,48 @@
+from distutils.errors import DistutilsArgError
+from distutils.fancy_getopt import FancyGetopt
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Dict, List
+
+
+_options = [
+    ("exec-prefix=", None, ""),
+    ("home=", None, ""),
+    ("install-base=", None, ""),
+    ("install-data=", None, ""),
+    ("install-headers=", None, ""),
+    ("install-lib=", None, ""),
+    ("install-platlib=", None, ""),
+    ("install-purelib=", None, ""),
+    ("install-scripts=", None, ""),
+    ("prefix=", None, ""),
+    ("root=", None, ""),
+    ("user", None, ""),
+]
+
+
+# typeshed doesn't permit Tuple[str, None, str], see python/typeshed#3469.
+_distutils_getopt = FancyGetopt(_options)  # type: ignore
+
+
+def parse_distutils_args(args):
+    # type: (List[str]) -> Dict[str, str]
+    """Parse provided arguments, returning an object that has the
+    matched arguments.
+
+    Any unknown arguments are ignored.
+    """
+    result = {}
+    for arg in args:
+        try:
+            _, match = _distutils_getopt.getopt(args=[arg])
+        except DistutilsArgError:
+            # We don't care about any other options, which here may be
+            # considered unrecognized since our option list is not
+            # exhaustive.
+            pass
+        else:
+            result.update(match.__dict__)
+    return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py
new file mode 100644
index 0000000000000000000000000000000000000000..ab4d4b98e3e1bca6f28db1ae114e48933a36be4e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/encoding.py
@@ -0,0 +1,42 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import codecs
+import locale
+import re
+import sys
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Tuple, Text
+
+BOMS = [
+    (codecs.BOM_UTF8, 'utf-8'),
+    (codecs.BOM_UTF16, 'utf-16'),
+    (codecs.BOM_UTF16_BE, 'utf-16-be'),
+    (codecs.BOM_UTF16_LE, 'utf-16-le'),
+    (codecs.BOM_UTF32, 'utf-32'),
+    (codecs.BOM_UTF32_BE, 'utf-32-be'),
+    (codecs.BOM_UTF32_LE, 'utf-32-le'),
+]  # type: List[Tuple[bytes, Text]]
+
+ENCODING_RE = re.compile(br'coding[:=]\s*([-\w.]+)')
+
+
+def auto_decode(data):
+    # type: (bytes) -> Text
+    """Check a bytes string for a BOM to correctly detect the encoding
+
+    Fallback to locale.getpreferredencoding(False) like open() on Python3"""
+    for bom, encoding in BOMS:
+        if data.startswith(bom):
+            return data[len(bom):].decode(encoding)
+    # Lets check the first two lines as in PEP263
+    for line in data.split(b'\n')[:2]:
+        if line[0:1] == b'#' and ENCODING_RE.search(line):
+            encoding = ENCODING_RE.search(line).groups()[0].decode('ascii')
+            return data.decode(encoding)
+    return data.decode(
+        locale.getpreferredencoding(False) or sys.getdefaultencoding(),
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py
new file mode 100644
index 0000000000000000000000000000000000000000..befd01c890184c74534bfefa1abd2376f234ac42
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/entrypoints.py
@@ -0,0 +1,31 @@
+import sys
+
+from pip._internal.cli.main import main
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, List
+
+
+def _wrapper(args=None):
+    # type: (Optional[List[str]]) -> int
+    """Central wrapper for all old entrypoints.
+
+    Historically pip has had several entrypoints defined. Because of issues
+    arising from PATH, sys.path, multiple Pythons, their interactions, and most
+    of them having a pip installed, users suffer every time an entrypoint gets
+    moved.
+
+    To alleviate this pain, and provide a mechanism for warning users and
+    directing them to an appropriate place for help, we now define all of
+    our old entrypoints as wrappers for the current one.
+    """
+    sys.stderr.write(
+        "WARNING: pip is being invoked by an old script wrapper. This will "
+        "fail in a future version of pip.\n"
+        "Please see https://github.com/pypa/pip/issues/5599 for advice on "
+        "fixing the underlying issue.\n"
+        "To avoid this problem you can invoke Python with '-m pip' instead of "
+        "running pip directly.\n"
+    )
+    return main(args)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py
new file mode 100644
index 0000000000000000000000000000000000000000..6f1537e4032617d294b26db09db1d85af4ad0dc2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py
@@ -0,0 +1,171 @@
+import errno
+import os
+import os.path
+import random
+import shutil
+import stat
+import sys
+from contextlib import contextmanager
+from tempfile import NamedTemporaryFile
+
+# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is
+#       why we ignore the type on this import.
+from pip._vendor.retrying import retry  # type: ignore
+from pip._vendor.six import PY2
+
+from pip._internal.utils.compat import get_path_uid
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast
+
+if MYPY_CHECK_RUNNING:
+    from typing import BinaryIO, Iterator
+
+    class NamedTemporaryFileResult(BinaryIO):
+        @property
+        def file(self):
+            # type: () -> BinaryIO
+            pass
+
+
+def check_path_owner(path):
+    # type: (str) -> bool
+    # If we don't have a way to check the effective uid of this process, then
+    # we'll just assume that we own the directory.
+    if sys.platform == "win32" or not hasattr(os, "geteuid"):
+        return True
+
+    assert os.path.isabs(path)
+
+    previous = None
+    while path != previous:
+        if os.path.lexists(path):
+            # Check if path is writable by current user.
+            if os.geteuid() == 0:
+                # Special handling for root user in order to handle properly
+                # cases where users use sudo without -H flag.
+                try:
+                    path_uid = get_path_uid(path)
+                except OSError:
+                    return False
+                return path_uid == 0
+            else:
+                return os.access(path, os.W_OK)
+        else:
+            previous, path = path, os.path.dirname(path)
+    return False  # assume we don't own the path
+
+
+def copy2_fixed(src, dest):
+    # type: (str, str) -> None
+    """Wrap shutil.copy2() but map errors copying socket files to
+    SpecialFileError as expected.
+
+    See also https://bugs.python.org/issue37700.
+    """
+    try:
+        shutil.copy2(src, dest)
+    except (OSError, IOError):
+        for f in [src, dest]:
+            try:
+                is_socket_file = is_socket(f)
+            except OSError:
+                # An error has already occurred. Another error here is not
+                # a problem and we can ignore it.
+                pass
+            else:
+                if is_socket_file:
+                    raise shutil.SpecialFileError("`%s` is a socket" % f)
+
+        raise
+
+
+def is_socket(path):
+    # type: (str) -> bool
+    return stat.S_ISSOCK(os.lstat(path).st_mode)
+
+
+@contextmanager
+def adjacent_tmp_file(path):
+    # type: (str) -> Iterator[NamedTemporaryFileResult]
+    """Given a path to a file, open a temp file next to it securely and ensure
+    it is written to disk after the context reaches its end.
+    """
+    with NamedTemporaryFile(
+        delete=False,
+        dir=os.path.dirname(path),
+        prefix=os.path.basename(path),
+        suffix='.tmp',
+    ) as f:
+        result = cast('NamedTemporaryFileResult', f)
+        try:
+            yield result
+        finally:
+            result.file.flush()
+            os.fsync(result.file.fileno())
+
+
+_replace_retry = retry(stop_max_delay=1000, wait_fixed=250)
+
+if PY2:
+    @_replace_retry
+    def replace(src, dest):
+        # type: (str, str) -> None
+        try:
+            os.rename(src, dest)
+        except OSError:
+            os.remove(dest)
+            os.rename(src, dest)
+
+else:
+    replace = _replace_retry(os.replace)
+
+
+# test_writable_dir and _test_writable_dir_win are copied from Flit,
+# with the author's agreement to also place them under pip's license.
+def test_writable_dir(path):
+    # type: (str) -> bool
+    """Check if a directory is writable.
+
+    Uses os.access() on POSIX, tries creating files on Windows.
+    """
+    # If the directory doesn't exist, find the closest parent that does.
+    while not os.path.isdir(path):
+        parent = os.path.dirname(path)
+        if parent == path:
+            break  # Should never get here, but infinite loops are bad
+        path = parent
+
+    if os.name == 'posix':
+        return os.access(path, os.W_OK)
+
+    return _test_writable_dir_win(path)
+
+
+def _test_writable_dir_win(path):
+    # type: (str) -> bool
+    # os.access doesn't work on Windows: http://bugs.python.org/issue2528
+    # and we can't use tempfile: http://bugs.python.org/issue22107
+    basename = 'accesstest_deleteme_fishfingers_custard_'
+    alphabet = 'abcdefghijklmnopqrstuvwxyz0123456789'
+    for i in range(10):
+        name = basename + ''.join(random.choice(alphabet) for _ in range(6))
+        file = os.path.join(path, name)
+        try:
+            fd = os.open(file, os.O_RDWR | os.O_CREAT | os.O_EXCL)
+        except OSError as e:
+            if e.errno == errno.EEXIST:
+                continue
+            if e.errno == errno.EPERM:
+                # This could be because there's a directory with the same name.
+                # But it's highly unlikely there's a directory called that,
+                # so we'll assume it's because the parent dir is not writable.
+                return False
+            raise
+        else:
+            os.close(fd)
+            os.unlink(file)
+            return True
+
+    # This should never be reached
+    raise EnvironmentError(
+        'Unexpected condition testing for writable directory'
+    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..daa0ca771b77a32bf498d07803f5bffc34b1abf9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py
@@ -0,0 +1,16 @@
+"""Filetype information.
+"""
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Tuple
+
+WHEEL_EXTENSION = '.whl'
+BZ2_EXTENSIONS = ('.tar.bz2', '.tbz')  # type: Tuple[str, ...]
+XZ_EXTENSIONS = ('.tar.xz', '.txz', '.tlz',
+                 '.tar.lz', '.tar.lzma')  # type: Tuple[str, ...]
+ZIP_EXTENSIONS = ('.zip', WHEEL_EXTENSION)  # type: Tuple[str, ...]
+TAR_EXTENSIONS = ('.tar.gz', '.tgz', '.tar')  # type: Tuple[str, ...]
+ARCHIVE_EXTENSIONS = (
+    ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py
new file mode 100644
index 0000000000000000000000000000000000000000..361042441384693dbeeb9424c78dedf3bdbb8a3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/glibc.py
@@ -0,0 +1,98 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import os
+import sys
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Tuple
+
+
+def glibc_version_string():
+    # type: () -> Optional[str]
+    "Returns glibc version string, or None if not using glibc."
+    return glibc_version_string_confstr() or glibc_version_string_ctypes()
+
+
+def glibc_version_string_confstr():
+    # type: () -> Optional[str]
+    "Primary implementation of glibc_version_string using os.confstr."
+    # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely
+    # to be broken or missing. This strategy is used in the standard library
+    # platform module:
+    # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183
+    if sys.platform == "win32":
+        return None
+    try:
+        # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17":
+        _, version = os.confstr("CS_GNU_LIBC_VERSION").split()
+    except (AttributeError, OSError, ValueError):
+        # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)...
+        return None
+    return version
+
+
+def glibc_version_string_ctypes():
+    # type: () -> Optional[str]
+    "Fallback implementation of glibc_version_string using ctypes."
+
+    try:
+        import ctypes
+    except ImportError:
+        return None
+
+    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
+    # manpage says, "If filename is NULL, then the returned handle is for the
+    # main program". This way we can let the linker do the work to figure out
+    # which libc our process is actually using.
+    process_namespace = ctypes.CDLL(None)
+    try:
+        gnu_get_libc_version = process_namespace.gnu_get_libc_version
+    except AttributeError:
+        # Symbol doesn't exist -> therefore, we are not linked to
+        # glibc.
+        return None
+
+    # Call gnu_get_libc_version, which returns a string like "2.5"
+    gnu_get_libc_version.restype = ctypes.c_char_p
+    version_str = gnu_get_libc_version()
+    # py2 / py3 compatibility:
+    if not isinstance(version_str, str):
+        version_str = version_str.decode("ascii")
+
+    return version_str
+
+
+# platform.libc_ver regularly returns completely nonsensical glibc
+# versions. E.g. on my computer, platform says:
+#
+#   ~$ python2.7 -c 'import platform; print(platform.libc_ver())'
+#   ('glibc', '2.7')
+#   ~$ python3.5 -c 'import platform; print(platform.libc_ver())'
+#   ('glibc', '2.9')
+#
+# But the truth is:
+#
+#   ~$ ldd --version
+#   ldd (Debian GLIBC 2.22-11) 2.22
+#
+# This is unfortunate, because it means that the linehaul data on libc
+# versions that was generated by pip 8.1.2 and earlier is useless and
+# misleading. Solution: instead of using platform, use our code that actually
+# works.
+def libc_ver():
+    # type: () -> Tuple[str, str]
+    """Try to determine the glibc version
+
+    Returns a tuple of strings (lib, version) which default to empty strings
+    in case the lookup fails.
+    """
+    glibc_version = glibc_version_string()
+    if glibc_version is None:
+        return ("", "")
+    else:
+        return ("glibc", glibc_version)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c41551a25597aa646d480c7a896ab9f151fff96
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/hashes.py
@@ -0,0 +1,131 @@
+from __future__ import absolute_import
+
+import hashlib
+
+from pip._vendor.six import iteritems, iterkeys, itervalues
+
+from pip._internal.exceptions import (
+    HashMismatch,
+    HashMissing,
+    InstallationError,
+)
+from pip._internal.utils.misc import read_chunks
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Dict, List, BinaryIO, NoReturn, Iterator
+    )
+    from pip._vendor.six import PY3
+    if PY3:
+        from hashlib import _Hash
+    else:
+        from hashlib import _hash as _Hash
+
+
+# The recommended hash algo of the moment. Change this whenever the state of
+# the art changes; it won't hurt backward compatibility.
+FAVORITE_HASH = 'sha256'
+
+
+# Names of hashlib algorithms allowed by the --hash option and ``pip hash``
+# Currently, those are the ones at least as collision-resistant as sha256.
+STRONG_HASHES = ['sha256', 'sha384', 'sha512']
+
+
+class Hashes(object):
+    """A wrapper that builds multiple hashes at once and checks them against
+    known-good values
+
+    """
+    def __init__(self, hashes=None):
+        # type: (Dict[str, List[str]]) -> None
+        """
+        :param hashes: A dict of algorithm names pointing to lists of allowed
+            hex digests
+        """
+        self._allowed = {} if hashes is None else hashes
+
+    @property
+    def digest_count(self):
+        # type: () -> int
+        return sum(len(digests) for digests in self._allowed.values())
+
+    def is_hash_allowed(
+        self,
+        hash_name,   # type: str
+        hex_digest,  # type: str
+    ):
+        # type: (...) -> bool
+        """Return whether the given hex digest is allowed."""
+        return hex_digest in self._allowed.get(hash_name, [])
+
+    def check_against_chunks(self, chunks):
+        # type: (Iterator[bytes]) -> None
+        """Check good hashes against ones built from iterable of chunks of
+        data.
+
+        Raise HashMismatch if none match.
+
+        """
+        gots = {}
+        for hash_name in iterkeys(self._allowed):
+            try:
+                gots[hash_name] = hashlib.new(hash_name)
+            except (ValueError, TypeError):
+                raise InstallationError('Unknown hash name: %s' % hash_name)
+
+        for chunk in chunks:
+            for hash in itervalues(gots):
+                hash.update(chunk)
+
+        for hash_name, got in iteritems(gots):
+            if got.hexdigest() in self._allowed[hash_name]:
+                return
+        self._raise(gots)
+
+    def _raise(self, gots):
+        # type: (Dict[str, _Hash]) -> NoReturn
+        raise HashMismatch(self._allowed, gots)
+
+    def check_against_file(self, file):
+        # type: (BinaryIO) -> None
+        """Check good hashes against a file-like object
+
+        Raise HashMismatch if none match.
+
+        """
+        return self.check_against_chunks(read_chunks(file))
+
+    def check_against_path(self, path):
+        # type: (str) -> None
+        with open(path, 'rb') as file:
+            return self.check_against_file(file)
+
+    def __nonzero__(self):
+        # type: () -> bool
+        """Return whether I know any known-good hashes."""
+        return bool(self._allowed)
+
+    def __bool__(self):
+        # type: () -> bool
+        return self.__nonzero__()
+
+
+class MissingHashes(Hashes):
+    """A workalike for Hashes used when we're missing a hash for a requirement
+
+    It computes the actual hash of the requirement and raises a HashMissing
+    exception showing it to the user.
+
+    """
+    def __init__(self):
+        # type: () -> None
+        """Don't offer the ``hashes`` kwarg."""
+        # Pass our favorite hash in to generate a "gotten hash". With the
+        # empty list, it will never match, so an error will always raise.
+        super(MissingHashes, self).__init__(hashes={FAVORITE_HASH: []})
+
+    def _raise(self, gots):
+        # type: (Dict[str, _Hash]) -> NoReturn
+        raise HashMissing(gots[FAVORITE_HASH].hexdigest())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py
new file mode 100644
index 0000000000000000000000000000000000000000..5b93b1d6730518ec49afe78bdfbe74407825d8ee
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py
@@ -0,0 +1,36 @@
+"""A helper module that injects SecureTransport, on import.
+
+The import should be done as early as possible, to ensure all requests and
+sessions (or whatever) are created after injecting SecureTransport.
+
+Note that we only do the injection on macOS, when the linked OpenSSL is too
+old to handle TLSv1.2.
+"""
+
+import sys
+
+
+def inject_securetransport():
+    # type: () -> None
+    # Only relevant on macOS
+    if sys.platform != "darwin":
+        return
+
+    try:
+        import ssl
+    except ImportError:
+        return
+
+    # Checks for OpenSSL 1.0.1
+    if ssl.OPENSSL_VERSION_NUMBER >= 0x1000100f:
+        return
+
+    try:
+        from pip._vendor.urllib3.contrib import securetransport
+    except (ImportError, OSError):
+        return
+
+    securetransport.inject_into_urllib3()
+
+
+inject_securetransport()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py
new file mode 100644
index 0000000000000000000000000000000000000000..7767111a6ba90278807dac5efd7a3ab59cc92fe1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/logging.py
@@ -0,0 +1,398 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import contextlib
+import errno
+import logging
+import logging.handlers
+import os
+import sys
+from logging import Filter, getLogger
+
+from pip._vendor.six import PY2
+
+from pip._internal.utils.compat import WINDOWS
+from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX
+from pip._internal.utils.misc import ensure_dir
+
+try:
+    import threading
+except ImportError:
+    import dummy_threading as threading  # type: ignore
+
+
+try:
+    # Use "import as" and set colorama in the else clause to avoid mypy
+    # errors and get the following correct revealed type for colorama:
+    # `Union[_importlib_modulespec.ModuleType, None]`
+    # Otherwise, we get an error like the following in the except block:
+    #  > Incompatible types in assignment (expression has type "None",
+    #   variable has type Module)
+    # TODO: eliminate the need to use "import as" once mypy addresses some
+    #  of its issues with conditional imports. Here is an umbrella issue:
+    #  https://github.com/python/mypy/issues/1297
+    from pip._vendor import colorama as _colorama
+# Lots of different errors can come from this, including SystemError and
+# ImportError.
+except Exception:
+    colorama = None
+else:
+    # Import Fore explicitly rather than accessing below as colorama.Fore
+    # to avoid the following error running mypy:
+    # > Module has no attribute "Fore"
+    # TODO: eliminate the need to import Fore once mypy addresses some of its
+    #  issues with conditional imports. This particular case could be an
+    #  instance of the following issue (but also see the umbrella issue above):
+    #  https://github.com/python/mypy/issues/3500
+    from pip._vendor.colorama import Fore
+
+    colorama = _colorama
+
+
+_log_state = threading.local()
+_log_state.indentation = 0
+subprocess_logger = getLogger('pip.subprocessor')
+
+
+class BrokenStdoutLoggingError(Exception):
+    """
+    Raised if BrokenPipeError occurs for the stdout stream while logging.
+    """
+    pass
+
+
+# BrokenPipeError does not exist in Python 2 and, in addition, manifests
+# differently in Windows and non-Windows.
+if WINDOWS:
+    # In Windows, a broken pipe can show up as EINVAL rather than EPIPE:
+    # https://bugs.python.org/issue19612
+    # https://bugs.python.org/issue30418
+    if PY2:
+        def _is_broken_pipe_error(exc_class, exc):
+            """See the docstring for non-Windows Python 3 below."""
+            return (exc_class is IOError and
+                    exc.errno in (errno.EINVAL, errno.EPIPE))
+    else:
+        # In Windows, a broken pipe IOError became OSError in Python 3.
+        def _is_broken_pipe_error(exc_class, exc):
+            """See the docstring for non-Windows Python 3 below."""
+            return ((exc_class is BrokenPipeError) or  # noqa: F821
+                    (exc_class is OSError and
+                     exc.errno in (errno.EINVAL, errno.EPIPE)))
+elif PY2:
+    def _is_broken_pipe_error(exc_class, exc):
+        """See the docstring for non-Windows Python 3 below."""
+        return (exc_class is IOError and exc.errno == errno.EPIPE)
+else:
+    # Then we are in the non-Windows Python 3 case.
+    def _is_broken_pipe_error(exc_class, exc):
+        """
+        Return whether an exception is a broken pipe error.
+
+        Args:
+          exc_class: an exception class.
+          exc: an exception instance.
+        """
+        return (exc_class is BrokenPipeError)  # noqa: F821
+
+
+@contextlib.contextmanager
+def indent_log(num=2):
+    """
+    A context manager which will cause the log output to be indented for any
+    log messages emitted inside it.
+    """
+    _log_state.indentation += num
+    try:
+        yield
+    finally:
+        _log_state.indentation -= num
+
+
+def get_indentation():
+    return getattr(_log_state, 'indentation', 0)
+
+
+class IndentingFormatter(logging.Formatter):
+
+    def __init__(self, *args, **kwargs):
+        """
+        A logging.Formatter that obeys the indent_log() context manager.
+
+        :param add_timestamp: A bool indicating output lines should be prefixed
+            with their record's timestamp.
+        """
+        self.add_timestamp = kwargs.pop("add_timestamp", False)
+        super(IndentingFormatter, self).__init__(*args, **kwargs)
+
+    def get_message_start(self, formatted, levelno):
+        """
+        Return the start of the formatted log message (not counting the
+        prefix to add to each line).
+        """
+        if levelno < logging.WARNING:
+            return ''
+        if formatted.startswith(DEPRECATION_MSG_PREFIX):
+            # Then the message already has a prefix.  We don't want it to
+            # look like "WARNING: DEPRECATION: ...."
+            return ''
+        if levelno < logging.ERROR:
+            return 'WARNING: '
+
+        return 'ERROR: '
+
+    def format(self, record):
+        """
+        Calls the standard formatter, but will indent all of the log message
+        lines by our current indentation level.
+        """
+        formatted = super(IndentingFormatter, self).format(record)
+        message_start = self.get_message_start(formatted, record.levelno)
+        formatted = message_start + formatted
+
+        prefix = ''
+        if self.add_timestamp:
+            # TODO: Use Formatter.default_time_format after dropping PY2.
+            t = self.formatTime(record, "%Y-%m-%dT%H:%M:%S")
+            prefix = '%s,%03d ' % (t, record.msecs)
+        prefix += " " * get_indentation()
+        formatted = "".join([
+            prefix + line
+            for line in formatted.splitlines(True)
+        ])
+        return formatted
+
+
+def _color_wrap(*colors):
+    def wrapped(inp):
+        return "".join(list(colors) + [inp, colorama.Style.RESET_ALL])
+    return wrapped
+
+
+class ColorizedStreamHandler(logging.StreamHandler):
+
+    # Don't build up a list of colors if we don't have colorama
+    if colorama:
+        COLORS = [
+            # This needs to be in order from highest logging level to lowest.
+            (logging.ERROR, _color_wrap(Fore.RED)),
+            (logging.WARNING, _color_wrap(Fore.YELLOW)),
+        ]
+    else:
+        COLORS = []
+
+    def __init__(self, stream=None, no_color=None):
+        logging.StreamHandler.__init__(self, stream)
+        self._no_color = no_color
+
+        if WINDOWS and colorama:
+            self.stream = colorama.AnsiToWin32(self.stream)
+
+    def _using_stdout(self):
+        """
+        Return whether the handler is using sys.stdout.
+        """
+        if WINDOWS and colorama:
+            # Then self.stream is an AnsiToWin32 object.
+            return self.stream.wrapped is sys.stdout
+
+        return self.stream is sys.stdout
+
+    def should_color(self):
+        # Don't colorize things if we do not have colorama or if told not to
+        if not colorama or self._no_color:
+            return False
+
+        real_stream = (
+            self.stream if not isinstance(self.stream, colorama.AnsiToWin32)
+            else self.stream.wrapped
+        )
+
+        # If the stream is a tty we should color it
+        if hasattr(real_stream, "isatty") and real_stream.isatty():
+            return True
+
+        # If we have an ANSI term we should color it
+        if os.environ.get("TERM") == "ANSI":
+            return True
+
+        # If anything else we should not color it
+        return False
+
+    def format(self, record):
+        msg = logging.StreamHandler.format(self, record)
+
+        if self.should_color():
+            for level, color in self.COLORS:
+                if record.levelno >= level:
+                    msg = color(msg)
+                    break
+
+        return msg
+
+    # The logging module says handleError() can be customized.
+    def handleError(self, record):
+        exc_class, exc = sys.exc_info()[:2]
+        # If a broken pipe occurred while calling write() or flush() on the
+        # stdout stream in logging's Handler.emit(), then raise our special
+        # exception so we can handle it in main() instead of logging the
+        # broken pipe error and continuing.
+        if (exc_class and self._using_stdout() and
+                _is_broken_pipe_error(exc_class, exc)):
+            raise BrokenStdoutLoggingError()
+
+        return super(ColorizedStreamHandler, self).handleError(record)
+
+
+class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler):
+
+    def _open(self):
+        ensure_dir(os.path.dirname(self.baseFilename))
+        return logging.handlers.RotatingFileHandler._open(self)
+
+
+class MaxLevelFilter(Filter):
+
+    def __init__(self, level):
+        self.level = level
+
+    def filter(self, record):
+        return record.levelno < self.level
+
+
+class ExcludeLoggerFilter(Filter):
+
+    """
+    A logging Filter that excludes records from a logger (or its children).
+    """
+
+    def filter(self, record):
+        # The base Filter class allows only records from a logger (or its
+        # children).
+        return not super(ExcludeLoggerFilter, self).filter(record)
+
+
+def setup_logging(verbosity, no_color, user_log_file):
+    """Configures and sets up all of the logging
+
+    Returns the requested logging level, as its integer value.
+    """
+
+    # Determine the level to be logging at.
+    if verbosity >= 1:
+        level = "DEBUG"
+    elif verbosity == -1:
+        level = "WARNING"
+    elif verbosity == -2:
+        level = "ERROR"
+    elif verbosity <= -3:
+        level = "CRITICAL"
+    else:
+        level = "INFO"
+
+    level_number = getattr(logging, level)
+
+    # The "root" logger should match the "console" level *unless* we also need
+    # to log to a user log file.
+    include_user_log = user_log_file is not None
+    if include_user_log:
+        additional_log_file = user_log_file
+        root_level = "DEBUG"
+    else:
+        additional_log_file = "/dev/null"
+        root_level = level
+
+    # Disable any logging besides WARNING unless we have DEBUG level logging
+    # enabled for vendored libraries.
+    vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG"
+
+    # Shorthands for clarity
+    log_streams = {
+        "stdout": "ext://sys.stdout",
+        "stderr": "ext://sys.stderr",
+    }
+    handler_classes = {
+        "stream": "pip._internal.utils.logging.ColorizedStreamHandler",
+        "file": "pip._internal.utils.logging.BetterRotatingFileHandler",
+    }
+    handlers = ["console", "console_errors", "console_subprocess"] + (
+        ["user_log"] if include_user_log else []
+    )
+
+    logging.config.dictConfig({
+        "version": 1,
+        "disable_existing_loggers": False,
+        "filters": {
+            "exclude_warnings": {
+                "()": "pip._internal.utils.logging.MaxLevelFilter",
+                "level": logging.WARNING,
+            },
+            "restrict_to_subprocess": {
+                "()": "logging.Filter",
+                "name": subprocess_logger.name,
+            },
+            "exclude_subprocess": {
+                "()": "pip._internal.utils.logging.ExcludeLoggerFilter",
+                "name": subprocess_logger.name,
+            },
+        },
+        "formatters": {
+            "indent": {
+                "()": IndentingFormatter,
+                "format": "%(message)s",
+            },
+            "indent_with_timestamp": {
+                "()": IndentingFormatter,
+                "format": "%(message)s",
+                "add_timestamp": True,
+            },
+        },
+        "handlers": {
+            "console": {
+                "level": level,
+                "class": handler_classes["stream"],
+                "no_color": no_color,
+                "stream": log_streams["stdout"],
+                "filters": ["exclude_subprocess", "exclude_warnings"],
+                "formatter": "indent",
+            },
+            "console_errors": {
+                "level": "WARNING",
+                "class": handler_classes["stream"],
+                "no_color": no_color,
+                "stream": log_streams["stderr"],
+                "filters": ["exclude_subprocess"],
+                "formatter": "indent",
+            },
+            # A handler responsible for logging to the console messages
+            # from the "subprocessor" logger.
+            "console_subprocess": {
+                "level": level,
+                "class": handler_classes["stream"],
+                "no_color": no_color,
+                "stream": log_streams["stderr"],
+                "filters": ["restrict_to_subprocess"],
+                "formatter": "indent",
+            },
+            "user_log": {
+                "level": "DEBUG",
+                "class": handler_classes["file"],
+                "filename": additional_log_file,
+                "delay": True,
+                "formatter": "indent_with_timestamp",
+            },
+        },
+        "root": {
+            "level": root_level,
+            "handlers": handlers,
+        },
+        "loggers": {
+            "pip._vendor": {
+                "level": vendored_log_level
+            }
+        },
+    })
+
+    return level_number
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py
new file mode 100644
index 0000000000000000000000000000000000000000..42ea81405085a0000c587ad563fee30c7f37a026
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py
@@ -0,0 +1,25 @@
+import os.path
+
+DELETE_MARKER_MESSAGE = '''\
+This file is placed here by pip to indicate the source was put
+here by pip.
+
+Once this package is successfully installed this source code will be
+deleted (unless you remove this file).
+'''
+PIP_DELETE_MARKER_FILENAME = 'pip-delete-this-directory.txt'
+
+
+def has_delete_marker_file(directory):
+    # type: (str) -> bool
+    return os.path.exists(os.path.join(directory, PIP_DELETE_MARKER_FILENAME))
+
+
+def write_delete_marker_file(directory):
+    # type: (str) -> None
+    """
+    Write the pip delete marker file into this directory.
+    """
+    filepath = os.path.join(directory, PIP_DELETE_MARKER_FILENAME)
+    with open(filepath, 'w') as marker_fp:
+        marker_fp.write(DELETE_MARKER_MESSAGE)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py
new file mode 100644
index 0000000000000000000000000000000000000000..554af0bf7b9b8c03de1b2cd3f3eda09a31c60a41
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/misc.py
@@ -0,0 +1,904 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import contextlib
+import errno
+import getpass
+import hashlib
+import io
+import logging
+import os
+import posixpath
+import shutil
+import stat
+import sys
+from collections import deque
+
+from pip._vendor import pkg_resources
+# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is
+#       why we ignore the type on this import.
+from pip._vendor.retrying import retry  # type: ignore
+from pip._vendor.six import PY2, text_type
+from pip._vendor.six.moves import input
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+from pip._vendor.six.moves.urllib.parse import unquote as urllib_unquote
+
+from pip import __version__
+from pip._internal.exceptions import CommandError
+from pip._internal.locations import (
+    get_major_minor_version,
+    site_packages,
+    user_site,
+)
+from pip._internal.utils.compat import (
+    WINDOWS,
+    expanduser,
+    stdlib_pkgs,
+    str_to_display,
+)
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING, cast
+from pip._internal.utils.virtualenv import (
+    running_under_virtualenv,
+    virtualenv_no_global,
+)
+
+if PY2:
+    from io import BytesIO as StringIO
+else:
+    from io import StringIO
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, AnyStr, Container, Iterable, List, Optional, Text,
+        Tuple, Union,
+    )
+    from pip._vendor.pkg_resources import Distribution
+
+    VersionInfo = Tuple[int, int, int]
+
+
+__all__ = ['rmtree', 'display_path', 'backup_dir',
+           'ask', 'splitext',
+           'format_size', 'is_installable_dir',
+           'normalize_path',
+           'renames', 'get_prog',
+           'captured_stdout', 'ensure_dir',
+           'get_installed_version', 'remove_auth_from_url']
+
+
+logger = logging.getLogger(__name__)
+
+
+def get_pip_version():
+    # type: () -> str
+    pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..")
+    pip_pkg_dir = os.path.abspath(pip_pkg_dir)
+
+    return (
+        'pip {} from {} (python {})'.format(
+            __version__, pip_pkg_dir, get_major_minor_version(),
+        )
+    )
+
+
+def normalize_version_info(py_version_info):
+    # type: (Tuple[int, ...]) -> Tuple[int, int, int]
+    """
+    Convert a tuple of ints representing a Python version to one of length
+    three.
+
+    :param py_version_info: a tuple of ints representing a Python version,
+        or None to specify no version. The tuple can have any length.
+
+    :return: a tuple of length three if `py_version_info` is non-None.
+        Otherwise, return `py_version_info` unchanged (i.e. None).
+    """
+    if len(py_version_info) < 3:
+        py_version_info += (3 - len(py_version_info)) * (0,)
+    elif len(py_version_info) > 3:
+        py_version_info = py_version_info[:3]
+
+    return cast('VersionInfo', py_version_info)
+
+
+def ensure_dir(path):
+    # type: (AnyStr) -> None
+    """os.path.makedirs without EEXIST."""
+    try:
+        os.makedirs(path)
+    except OSError as e:
+        # Windows can raise spurious ENOTEMPTY errors. See #6426.
+        if e.errno != errno.EEXIST and e.errno != errno.ENOTEMPTY:
+            raise
+
+
+def get_prog():
+    # type: () -> str
+    try:
+        prog = os.path.basename(sys.argv[0])
+        if prog in ('__main__.py', '-c'):
+            return "%s -m pip" % sys.executable
+        else:
+            return prog
+    except (AttributeError, TypeError, IndexError):
+        pass
+    return 'pip'
+
+
+# Retry every half second for up to 3 seconds
+@retry(stop_max_delay=3000, wait_fixed=500)
+def rmtree(dir, ignore_errors=False):
+    # type: (str, bool) -> None
+    shutil.rmtree(dir, ignore_errors=ignore_errors,
+                  onerror=rmtree_errorhandler)
+
+
+def rmtree_errorhandler(func, path, exc_info):
+    """On Windows, the files in .svn are read-only, so when rmtree() tries to
+    remove them, an exception is thrown.  We catch that here, remove the
+    read-only attribute, and hopefully continue without problems."""
+    try:
+        has_attr_readonly = not (os.stat(path).st_mode & stat.S_IWRITE)
+    except (IOError, OSError):
+        # it's equivalent to os.path.exists
+        return
+
+    if has_attr_readonly:
+        # convert to read/write
+        os.chmod(path, stat.S_IWRITE)
+        # use the original function to repeat the operation
+        func(path)
+        return
+    else:
+        raise
+
+
+def path_to_display(path):
+    # type: (Optional[Union[str, Text]]) -> Optional[Text]
+    """
+    Convert a bytes (or text) path to text (unicode in Python 2) for display
+    and logging purposes.
+
+    This function should never error out. Also, this function is mainly needed
+    for Python 2 since in Python 3 str paths are already text.
+    """
+    if path is None:
+        return None
+    if isinstance(path, text_type):
+        return path
+    # Otherwise, path is a bytes object (str in Python 2).
+    try:
+        display_path = path.decode(sys.getfilesystemencoding(), 'strict')
+    except UnicodeDecodeError:
+        # Include the full bytes to make troubleshooting easier, even though
+        # it may not be very human readable.
+        if PY2:
+            # Convert the bytes to a readable str representation using
+            # repr(), and then convert the str to unicode.
+            #   Also, we add the prefix "b" to the repr() return value both
+            # to make the Python 2 output look like the Python 3 output, and
+            # to signal to the user that this is a bytes representation.
+            display_path = str_to_display('b{!r}'.format(path))
+        else:
+            # Silence the "F821 undefined name 'ascii'" flake8 error since
+            # in Python 3 ascii() is a built-in.
+            display_path = ascii(path)  # noqa: F821
+
+    return display_path
+
+
+def display_path(path):
+    # type: (Union[str, Text]) -> str
+    """Gives the display value for a given path, making it relative to cwd
+    if possible."""
+    path = os.path.normcase(os.path.abspath(path))
+    if sys.version_info[0] == 2:
+        path = path.decode(sys.getfilesystemencoding(), 'replace')
+        path = path.encode(sys.getdefaultencoding(), 'replace')
+    if path.startswith(os.getcwd() + os.path.sep):
+        path = '.' + path[len(os.getcwd()):]
+    return path
+
+
+def backup_dir(dir, ext='.bak'):
+    # type: (str, str) -> str
+    """Figure out the name of a directory to back up the given dir to
+    (adding .bak, .bak2, etc)"""
+    n = 1
+    extension = ext
+    while os.path.exists(dir + extension):
+        n += 1
+        extension = ext + str(n)
+    return dir + extension
+
+
+def ask_path_exists(message, options):
+    # type: (str, Iterable[str]) -> str
+    for action in os.environ.get('PIP_EXISTS_ACTION', '').split():
+        if action in options:
+            return action
+    return ask(message, options)
+
+
+def _check_no_input(message):
+    # type: (str) -> None
+    """Raise an error if no input is allowed."""
+    if os.environ.get('PIP_NO_INPUT'):
+        raise Exception(
+            'No input was expected ($PIP_NO_INPUT set); question: %s' %
+            message
+        )
+
+
+def ask(message, options):
+    # type: (str, Iterable[str]) -> str
+    """Ask the message interactively, with the given possible responses"""
+    while 1:
+        _check_no_input(message)
+        response = input(message)
+        response = response.strip().lower()
+        if response not in options:
+            print(
+                'Your response (%r) was not one of the expected responses: '
+                '%s' % (response, ', '.join(options))
+            )
+        else:
+            return response
+
+
+def ask_input(message):
+    # type: (str) -> str
+    """Ask for input interactively."""
+    _check_no_input(message)
+    return input(message)
+
+
+def ask_password(message):
+    # type: (str) -> str
+    """Ask for a password interactively."""
+    _check_no_input(message)
+    return getpass.getpass(message)
+
+
+def format_size(bytes):
+    # type: (float) -> str
+    if bytes > 1000 * 1000:
+        return '%.1f MB' % (bytes / 1000.0 / 1000)
+    elif bytes > 10 * 1000:
+        return '%i kB' % (bytes / 1000)
+    elif bytes > 1000:
+        return '%.1f kB' % (bytes / 1000.0)
+    else:
+        return '%i bytes' % bytes
+
+
+def is_installable_dir(path):
+    # type: (str) -> bool
+    """Is path is a directory containing setup.py or pyproject.toml?
+    """
+    if not os.path.isdir(path):
+        return False
+    setup_py = os.path.join(path, 'setup.py')
+    if os.path.isfile(setup_py):
+        return True
+    pyproject_toml = os.path.join(path, 'pyproject.toml')
+    if os.path.isfile(pyproject_toml):
+        return True
+    return False
+
+
+def read_chunks(file, size=io.DEFAULT_BUFFER_SIZE):
+    """Yield pieces of data from a file-like object until EOF."""
+    while True:
+        chunk = file.read(size)
+        if not chunk:
+            break
+        yield chunk
+
+
+def normalize_path(path, resolve_symlinks=True):
+    # type: (str, bool) -> str
+    """
+    Convert a path to its canonical, case-normalized, absolute version.
+
+    """
+    path = expanduser(path)
+    if resolve_symlinks:
+        path = os.path.realpath(path)
+    else:
+        path = os.path.abspath(path)
+    return os.path.normcase(path)
+
+
+def splitext(path):
+    # type: (str) -> Tuple[str, str]
+    """Like os.path.splitext, but take off .tar too"""
+    base, ext = posixpath.splitext(path)
+    if base.lower().endswith('.tar'):
+        ext = base[-4:] + ext
+        base = base[:-4]
+    return base, ext
+
+
+def renames(old, new):
+    # type: (str, str) -> None
+    """Like os.renames(), but handles renaming across devices."""
+    # Implementation borrowed from os.renames().
+    head, tail = os.path.split(new)
+    if head and tail and not os.path.exists(head):
+        os.makedirs(head)
+
+    shutil.move(old, new)
+
+    head, tail = os.path.split(old)
+    if head and tail:
+        try:
+            os.removedirs(head)
+        except OSError:
+            pass
+
+
+def is_local(path):
+    # type: (str) -> bool
+    """
+    Return True if this is a path pip is allowed to modify.
+
+    If we're in a virtualenv, sys.prefix points to the virtualenv's
+    prefix; only sys.prefix is considered local.
+
+    If we're not in a virtualenv, in general we can modify anything.
+    However, if the OS vendor has configured distutils to install
+    somewhere other than sys.prefix (which could be a subdirectory of
+    sys.prefix, e.g. /usr/local), we consider sys.prefix itself nonlocal
+    and the domain of the OS vendor. (In other words, everything _other
+    than_ sys.prefix is considered local.)
+
+    Caution: this function assumes the head of path has been normalized
+    with normalize_path.
+    """
+
+    path = normalize_path(path)
+    prefix = normalize_path(sys.prefix)
+
+    if running_under_virtualenv():
+        return path.startswith(normalize_path(sys.prefix))
+    else:
+        from pip._internal.locations import distutils_scheme
+        if path.startswith(prefix):
+            for local_path in distutils_scheme("").values():
+                if path.startswith(normalize_path(local_path)):
+                    return True
+            return False
+        else:
+            return True
+
+
+def dist_is_local(dist):
+    # type: (Distribution) -> bool
+    """
+    Return True if given Distribution object is installed somewhere pip
+    is allowed to modify.
+
+    """
+    return is_local(dist_location(dist))
+
+
+def dist_in_usersite(dist):
+    # type: (Distribution) -> bool
+    """
+    Return True if given Distribution is installed in user site.
+    """
+    return dist_location(dist).startswith(normalize_path(user_site))
+
+
+def dist_in_site_packages(dist):
+    # type: (Distribution) -> bool
+    """
+    Return True if given Distribution is installed in
+    sysconfig.get_python_lib().
+    """
+    return dist_location(dist).startswith(normalize_path(site_packages))
+
+
+def dist_is_editable(dist):
+    # type: (Distribution) -> bool
+    """
+    Return True if given Distribution is an editable install.
+    """
+    for path_item in sys.path:
+        egg_link = os.path.join(path_item, dist.project_name + '.egg-link')
+        if os.path.isfile(egg_link):
+            return True
+    return False
+
+
+def get_installed_distributions(
+        local_only=True,  # type: bool
+        skip=stdlib_pkgs,  # type: Container[str]
+        include_editables=True,  # type: bool
+        editables_only=False,  # type: bool
+        user_only=False,  # type: bool
+        paths=None  # type: Optional[List[str]]
+):
+    # type: (...) -> List[Distribution]
+    """
+    Return a list of installed Distribution objects.
+
+    If ``local_only`` is True (default), only return installations
+    local to the current virtualenv, if in a virtualenv.
+
+    ``skip`` argument is an iterable of lower-case project names to
+    ignore; defaults to stdlib_pkgs
+
+    If ``include_editables`` is False, don't report editables.
+
+    If ``editables_only`` is True , only report editables.
+
+    If ``user_only`` is True , only report installations in the user
+    site directory.
+
+    If ``paths`` is set, only report the distributions present at the
+    specified list of locations.
+    """
+    if paths:
+        working_set = pkg_resources.WorkingSet(paths)
+    else:
+        working_set = pkg_resources.working_set
+
+    if local_only:
+        local_test = dist_is_local
+    else:
+        def local_test(d):
+            return True
+
+    if include_editables:
+        def editable_test(d):
+            return True
+    else:
+        def editable_test(d):
+            return not dist_is_editable(d)
+
+    if editables_only:
+        def editables_only_test(d):
+            return dist_is_editable(d)
+    else:
+        def editables_only_test(d):
+            return True
+
+    if user_only:
+        user_test = dist_in_usersite
+    else:
+        def user_test(d):
+            return True
+
+    return [d for d in working_set
+            if local_test(d) and
+            d.key not in skip and
+            editable_test(d) and
+            editables_only_test(d) and
+            user_test(d)
+            ]
+
+
+def egg_link_path(dist):
+    # type: (Distribution) -> Optional[str]
+    """
+    Return the path for the .egg-link file if it exists, otherwise, None.
+
+    There's 3 scenarios:
+    1) not in a virtualenv
+       try to find in site.USER_SITE, then site_packages
+    2) in a no-global virtualenv
+       try to find in site_packages
+    3) in a yes-global virtualenv
+       try to find in site_packages, then site.USER_SITE
+       (don't look in global location)
+
+    For #1 and #3, there could be odd cases, where there's an egg-link in 2
+    locations.
+
+    This method will just return the first one found.
+    """
+    sites = []
+    if running_under_virtualenv():
+        sites.append(site_packages)
+        if not virtualenv_no_global() and user_site:
+            sites.append(user_site)
+    else:
+        if user_site:
+            sites.append(user_site)
+        sites.append(site_packages)
+
+    for site in sites:
+        egglink = os.path.join(site, dist.project_name) + '.egg-link'
+        if os.path.isfile(egglink):
+            return egglink
+    return None
+
+
+def dist_location(dist):
+    # type: (Distribution) -> str
+    """
+    Get the site-packages location of this distribution. Generally
+    this is dist.location, except in the case of develop-installed
+    packages, where dist.location is the source code location, and we
+    want to know where the egg-link file is.
+
+    The returned location is normalized (in particular, with symlinks removed).
+    """
+    egg_link = egg_link_path(dist)
+    if egg_link:
+        return normalize_path(egg_link)
+    return normalize_path(dist.location)
+
+
+def write_output(msg, *args):
+    # type: (str, str) -> None
+    logger.info(msg, *args)
+
+
+class FakeFile(object):
+    """Wrap a list of lines in an object with readline() to make
+    ConfigParser happy."""
+    def __init__(self, lines):
+        self._gen = (l for l in lines)
+
+    def readline(self):
+        try:
+            try:
+                return next(self._gen)
+            except NameError:
+                return self._gen.next()
+        except StopIteration:
+            return ''
+
+    def __iter__(self):
+        return self._gen
+
+
+class StreamWrapper(StringIO):
+
+    @classmethod
+    def from_stream(cls, orig_stream):
+        cls.orig_stream = orig_stream
+        return cls()
+
+    # compileall.compile_dir() needs stdout.encoding to print to stdout
+    @property
+    def encoding(self):
+        return self.orig_stream.encoding
+
+
+@contextlib.contextmanager
+def captured_output(stream_name):
+    """Return a context manager used by captured_stdout/stdin/stderr
+    that temporarily replaces the sys stream *stream_name* with a StringIO.
+
+    Taken from Lib/support/__init__.py in the CPython repo.
+    """
+    orig_stdout = getattr(sys, stream_name)
+    setattr(sys, stream_name, StreamWrapper.from_stream(orig_stdout))
+    try:
+        yield getattr(sys, stream_name)
+    finally:
+        setattr(sys, stream_name, orig_stdout)
+
+
+def captured_stdout():
+    """Capture the output of sys.stdout:
+
+       with captured_stdout() as stdout:
+           print('hello')
+       self.assertEqual(stdout.getvalue(), 'hello\n')
+
+    Taken from Lib/support/__init__.py in the CPython repo.
+    """
+    return captured_output('stdout')
+
+
+def captured_stderr():
+    """
+    See captured_stdout().
+    """
+    return captured_output('stderr')
+
+
+class cached_property(object):
+    """A property that is only computed once per instance and then replaces
+       itself with an ordinary attribute. Deleting the attribute resets the
+       property.
+
+       Source: https://github.com/bottlepy/bottle/blob/0.11.5/bottle.py#L175
+    """
+
+    def __init__(self, func):
+        self.__doc__ = getattr(func, '__doc__')
+        self.func = func
+
+    def __get__(self, obj, cls):
+        if obj is None:
+            # We're being accessed from the class itself, not from an object
+            return self
+        value = obj.__dict__[self.func.__name__] = self.func(obj)
+        return value
+
+
+def get_installed_version(dist_name, working_set=None):
+    """Get the installed version of dist_name avoiding pkg_resources cache"""
+    # Create a requirement that we'll look for inside of setuptools.
+    req = pkg_resources.Requirement.parse(dist_name)
+
+    if working_set is None:
+        # We want to avoid having this cached, so we need to construct a new
+        # working set each time.
+        working_set = pkg_resources.WorkingSet()
+
+    # Get the installed distribution from our working set
+    dist = working_set.find(req)
+
+    # Check to see if we got an installed distribution or not, if we did
+    # we want to return it's version.
+    return dist.version if dist else None
+
+
+def consume(iterator):
+    """Consume an iterable at C speed."""
+    deque(iterator, maxlen=0)
+
+
+# Simulates an enum
+def enum(*sequential, **named):
+    enums = dict(zip(sequential, range(len(sequential))), **named)
+    reverse = {value: key for key, value in enums.items()}
+    enums['reverse_mapping'] = reverse
+    return type('Enum', (), enums)
+
+
+def build_netloc(host, port):
+    # type: (str, Optional[int]) -> str
+    """
+    Build a netloc from a host-port pair
+    """
+    if port is None:
+        return host
+    if ':' in host:
+        # Only wrap host with square brackets when it is IPv6
+        host = '[{}]'.format(host)
+    return '{}:{}'.format(host, port)
+
+
+def build_url_from_netloc(netloc, scheme='https'):
+    # type: (str, str) -> str
+    """
+    Build a full URL from a netloc.
+    """
+    if netloc.count(':') >= 2 and '@' not in netloc and '[' not in netloc:
+        # It must be a bare IPv6 address, so wrap it with brackets.
+        netloc = '[{}]'.format(netloc)
+    return '{}://{}'.format(scheme, netloc)
+
+
+def parse_netloc(netloc):
+    # type: (str) -> Tuple[str, Optional[int]]
+    """
+    Return the host-port pair from a netloc.
+    """
+    url = build_url_from_netloc(netloc)
+    parsed = urllib_parse.urlparse(url)
+    return parsed.hostname, parsed.port
+
+
+def split_auth_from_netloc(netloc):
+    """
+    Parse out and remove the auth information from a netloc.
+
+    Returns: (netloc, (username, password)).
+    """
+    if '@' not in netloc:
+        return netloc, (None, None)
+
+    # Split from the right because that's how urllib.parse.urlsplit()
+    # behaves if more than one @ is present (which can be checked using
+    # the password attribute of urlsplit()'s return value).
+    auth, netloc = netloc.rsplit('@', 1)
+    if ':' in auth:
+        # Split from the left because that's how urllib.parse.urlsplit()
+        # behaves if more than one : is present (which again can be checked
+        # using the password attribute of the return value)
+        user_pass = auth.split(':', 1)
+    else:
+        user_pass = auth, None
+
+    user_pass = tuple(
+        None if x is None else urllib_unquote(x) for x in user_pass
+    )
+
+    return netloc, user_pass
+
+
+def redact_netloc(netloc):
+    # type: (str) -> str
+    """
+    Replace the sensitive data in a netloc with "****", if it exists.
+
+    For example:
+        - "user:pass@example.com" returns "user:****@example.com"
+        - "accesstoken@example.com" returns "****@example.com"
+    """
+    netloc, (user, password) = split_auth_from_netloc(netloc)
+    if user is None:
+        return netloc
+    if password is None:
+        user = '****'
+        password = ''
+    else:
+        user = urllib_parse.quote(user)
+        password = ':****'
+    return '{user}{password}@{netloc}'.format(user=user,
+                                              password=password,
+                                              netloc=netloc)
+
+
+def _transform_url(url, transform_netloc):
+    """Transform and replace netloc in a url.
+
+    transform_netloc is a function taking the netloc and returning a
+    tuple. The first element of this tuple is the new netloc. The
+    entire tuple is returned.
+
+    Returns a tuple containing the transformed url as item 0 and the
+    original tuple returned by transform_netloc as item 1.
+    """
+    purl = urllib_parse.urlsplit(url)
+    netloc_tuple = transform_netloc(purl.netloc)
+    # stripped url
+    url_pieces = (
+        purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment
+    )
+    surl = urllib_parse.urlunsplit(url_pieces)
+    return surl, netloc_tuple
+
+
+def _get_netloc(netloc):
+    return split_auth_from_netloc(netloc)
+
+
+def _redact_netloc(netloc):
+    return (redact_netloc(netloc),)
+
+
+def split_auth_netloc_from_url(url):
+    # type: (str) -> Tuple[str, str, Tuple[str, str]]
+    """
+    Parse a url into separate netloc, auth, and url with no auth.
+
+    Returns: (url_without_auth, netloc, (username, password))
+    """
+    url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc)
+    return url_without_auth, netloc, auth
+
+
+def remove_auth_from_url(url):
+    # type: (str) -> str
+    """Return a copy of url with 'username:password@' removed."""
+    # username/pass params are passed to subversion through flags
+    # and are not recognized in the url.
+    return _transform_url(url, _get_netloc)[0]
+
+
+def redact_auth_from_url(url):
+    # type: (str) -> str
+    """Replace the password in a given url with ****."""
+    return _transform_url(url, _redact_netloc)[0]
+
+
+class HiddenText(object):
+    def __init__(
+        self,
+        secret,    # type: str
+        redacted,  # type: str
+    ):
+        # type: (...) -> None
+        self.secret = secret
+        self.redacted = redacted
+
+    def __repr__(self):
+        # type: (...) -> str
+        return '<HiddenText {!r}>'.format(str(self))
+
+    def __str__(self):
+        # type: (...) -> str
+        return self.redacted
+
+    # This is useful for testing.
+    def __eq__(self, other):
+        # type: (Any) -> bool
+        if type(self) != type(other):
+            return False
+
+        # The string being used for redaction doesn't also have to match,
+        # just the raw, original string.
+        return (self.secret == other.secret)
+
+    # We need to provide an explicit __ne__ implementation for Python 2.
+    # TODO: remove this when we drop PY2 support.
+    def __ne__(self, other):
+        # type: (Any) -> bool
+        return not self == other
+
+
+def hide_value(value):
+    # type: (str) -> HiddenText
+    return HiddenText(value, redacted='****')
+
+
+def hide_url(url):
+    # type: (str) -> HiddenText
+    redacted = redact_auth_from_url(url)
+    return HiddenText(url, redacted=redacted)
+
+
+def protect_pip_from_modification_on_windows(modifying_pip):
+    # type: (bool) -> None
+    """Protection of pip.exe from modification on Windows
+
+    On Windows, any operation modifying pip should be run as:
+        python -m pip ...
+    """
+    pip_names = [
+        "pip.exe",
+        "pip{}.exe".format(sys.version_info[0]),
+        "pip{}.{}.exe".format(*sys.version_info[:2])
+    ]
+
+    # See https://github.com/pypa/pip/issues/1299 for more discussion
+    should_show_use_python_msg = (
+        modifying_pip and
+        WINDOWS and
+        os.path.basename(sys.argv[0]) in pip_names
+    )
+
+    if should_show_use_python_msg:
+        new_command = [
+            sys.executable, "-m", "pip"
+        ] + sys.argv[1:]
+        raise CommandError(
+            'To modify pip, please run the following command:\n{}'
+            .format(" ".join(new_command))
+        )
+
+
+def is_console_interactive():
+    # type: () -> bool
+    """Is this console interactive?
+    """
+    return sys.stdin is not None and sys.stdin.isatty()
+
+
+def hash_file(path, blocksize=1 << 20):
+    # type: (str, int) -> Tuple[Any, int]
+    """Return (hash, length) for path using hashlib.sha256()
+    """
+
+    h = hashlib.sha256()
+    length = 0
+    with open(path, 'rb') as f:
+        for block in read_chunks(f, size=blocksize):
+            length += len(block)
+            h.update(block)
+    return h, length
+
+
+def is_wheel_installed():
+    """
+    Return whether the wheel package is installed.
+    """
+    try:
+        import wheel  # noqa: F401
+    except ImportError:
+        return False
+
+    return True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..29e1441153b63446220a5e1867e691183e0d22d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/models.py
@@ -0,0 +1,42 @@
+"""Utilities for defining models
+"""
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+import operator
+
+
+class KeyBasedCompareMixin(object):
+    """Provides comparison capabilities that is based on a key
+    """
+
+    def __init__(self, key, defining_class):
+        self._compare_key = key
+        self._defining_class = defining_class
+
+    def __hash__(self):
+        return hash(self._compare_key)
+
+    def __lt__(self, other):
+        return self._compare(other, operator.__lt__)
+
+    def __le__(self, other):
+        return self._compare(other, operator.__le__)
+
+    def __gt__(self, other):
+        return self._compare(other, operator.__gt__)
+
+    def __ge__(self, other):
+        return self._compare(other, operator.__ge__)
+
+    def __eq__(self, other):
+        return self._compare(other, operator.__eq__)
+
+    def __ne__(self, other):
+        return self._compare(other, operator.__ne__)
+
+    def _compare(self, other, method):
+        if not isinstance(other, self._defining_class):
+            return NotImplemented
+
+        return method(self._compare_key, other._compare_key)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py
new file mode 100644
index 0000000000000000000000000000000000000000..68aa86edbf012c68ceadbe67e21e5d6c9ebbc0ab
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/packaging.py
@@ -0,0 +1,94 @@
+from __future__ import absolute_import
+
+import logging
+from email.parser import FeedParser
+
+from pip._vendor import pkg_resources
+from pip._vendor.packaging import specifiers, version
+
+from pip._internal.exceptions import NoneMetadataError
+from pip._internal.utils.misc import display_path
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Tuple
+    from email.message import Message
+    from pip._vendor.pkg_resources import Distribution
+
+
+logger = logging.getLogger(__name__)
+
+
+def check_requires_python(requires_python, version_info):
+    # type: (Optional[str], Tuple[int, ...]) -> bool
+    """
+    Check if the given Python version matches a "Requires-Python" specifier.
+
+    :param version_info: A 3-tuple of ints representing a Python
+        major-minor-micro version to check (e.g. `sys.version_info[:3]`).
+
+    :return: `True` if the given Python version satisfies the requirement.
+        Otherwise, return `False`.
+
+    :raises InvalidSpecifier: If `requires_python` has an invalid format.
+    """
+    if requires_python is None:
+        # The package provides no information
+        return True
+    requires_python_specifier = specifiers.SpecifierSet(requires_python)
+
+    python_version = version.parse('.'.join(map(str, version_info)))
+    return python_version in requires_python_specifier
+
+
+def get_metadata(dist):
+    # type: (Distribution) -> Message
+    """
+    :raises NoneMetadataError: if the distribution reports `has_metadata()`
+        True but `get_metadata()` returns None.
+    """
+    metadata_name = 'METADATA'
+    if (isinstance(dist, pkg_resources.DistInfoDistribution) and
+            dist.has_metadata(metadata_name)):
+        metadata = dist.get_metadata(metadata_name)
+    elif dist.has_metadata('PKG-INFO'):
+        metadata_name = 'PKG-INFO'
+        metadata = dist.get_metadata(metadata_name)
+    else:
+        logger.warning("No metadata found in %s", display_path(dist.location))
+        metadata = ''
+
+    if metadata is None:
+        raise NoneMetadataError(dist, metadata_name)
+
+    feed_parser = FeedParser()
+    # The following line errors out if with a "NoneType" TypeError if
+    # passed metadata=None.
+    feed_parser.feed(metadata)
+    return feed_parser.close()
+
+
+def get_requires_python(dist):
+    # type: (pkg_resources.Distribution) -> Optional[str]
+    """
+    Return the "Requires-Python" metadata for a distribution, or None
+    if not present.
+    """
+    pkg_info_dict = get_metadata(dist)
+    requires_python = pkg_info_dict.get('Requires-Python')
+
+    if requires_python is not None:
+        # Convert to a str to satisfy the type checker, since requires_python
+        # can be a Header object.
+        requires_python = str(requires_python)
+
+    return requires_python
+
+
+def get_installer(dist):
+    # type: (Distribution) -> str
+    if dist.has_metadata('INSTALLER'):
+        for line in dist.get_metadata_lines('INSTALLER'):
+            if line.strip():
+                return line.strip()
+    return ''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py
new file mode 100644
index 0000000000000000000000000000000000000000..0bc129acc6ab582eb087be7ee186c554dc5feba1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/pkg_resources.py
@@ -0,0 +1,44 @@
+from pip._vendor.pkg_resources import yield_lines
+from pip._vendor.six import ensure_str
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Dict, Iterable, List
+
+
+class DictMetadata(object):
+    """IMetadataProvider that reads metadata files from a dictionary.
+    """
+    def __init__(self, metadata):
+        # type: (Dict[str, bytes]) -> None
+        self._metadata = metadata
+
+    def has_metadata(self, name):
+        # type: (str) -> bool
+        return name in self._metadata
+
+    def get_metadata(self, name):
+        # type: (str) -> str
+        try:
+            return ensure_str(self._metadata[name])
+        except UnicodeDecodeError as e:
+            # Mirrors handling done in pkg_resources.NullProvider.
+            e.reason += " in {} file".format(name)
+            raise
+
+    def get_metadata_lines(self, name):
+        # type: (str) -> Iterable[str]
+        return yield_lines(self.get_metadata(name))
+
+    def metadata_isdir(self, name):
+        # type: (str) -> bool
+        return False
+
+    def metadata_listdir(self, name):
+        # type: (str) -> List[str]
+        return []
+
+    def run_script(self, script_name, namespace):
+        # type: (str, str) -> None
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py
new file mode 100644
index 0000000000000000000000000000000000000000..4147a650dca185dcd4491b805d0bdb0775eff924
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py
@@ -0,0 +1,181 @@
+import sys
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional, Sequence
+
+# Shim to wrap setup.py invocation with setuptools
+#
+# We set sys.argv[0] to the path to the underlying setup.py file so
+# setuptools / distutils don't take the path to the setup.py to be "-c" when
+# invoking via the shim.  This avoids e.g. the following manifest_maker
+# warning: "warning: manifest_maker: standard file '-c' not found".
+_SETUPTOOLS_SHIM = (
+    "import sys, setuptools, tokenize; sys.argv[0] = {0!r}; __file__={0!r};"
+    "f=getattr(tokenize, 'open', open)(__file__);"
+    "code=f.read().replace('\\r\\n', '\\n');"
+    "f.close();"
+    "exec(compile(code, __file__, 'exec'))"
+)
+
+
+def make_setuptools_shim_args(
+    setup_py_path,  # type: str
+    global_options=None,  # type: Sequence[str]
+    no_user_config=False,  # type: bool
+    unbuffered_output=False  # type: bool
+):
+    # type: (...) -> List[str]
+    """
+    Get setuptools command arguments with shim wrapped setup file invocation.
+
+    :param setup_py_path: The path to setup.py to be wrapped.
+    :param global_options: Additional global options.
+    :param no_user_config: If True, disables personal user configuration.
+    :param unbuffered_output: If True, adds the unbuffered switch to the
+     argument list.
+    """
+    args = [sys.executable]
+    if unbuffered_output:
+        args += ["-u"]
+    args += ["-c", _SETUPTOOLS_SHIM.format(setup_py_path)]
+    if global_options:
+        args += global_options
+    if no_user_config:
+        args += ["--no-user-cfg"]
+    return args
+
+
+def make_setuptools_bdist_wheel_args(
+    setup_py_path,  # type: str
+    global_options,  # type: Sequence[str]
+    build_options,  # type: Sequence[str]
+    destination_dir,  # type: str
+):
+    # type: (...) -> List[str]
+    # NOTE: Eventually, we'd want to also -S to the flags here, when we're
+    # isolating. Currently, it breaks Python in virtualenvs, because it
+    # relies on site.py to find parts of the standard library outside the
+    # virtualenv.
+    args = make_setuptools_shim_args(
+        setup_py_path,
+        global_options=global_options,
+        unbuffered_output=True
+    )
+    args += ["bdist_wheel", "-d", destination_dir]
+    args += build_options
+    return args
+
+
+def make_setuptools_clean_args(
+    setup_py_path,  # type: str
+    global_options,  # type: Sequence[str]
+):
+    # type: (...) -> List[str]
+    args = make_setuptools_shim_args(
+        setup_py_path,
+        global_options=global_options,
+        unbuffered_output=True
+    )
+    args += ["clean", "--all"]
+    return args
+
+
+def make_setuptools_develop_args(
+    setup_py_path,  # type: str
+    global_options,  # type: Sequence[str]
+    install_options,  # type: Sequence[str]
+    no_user_config,  # type: bool
+    prefix,  # type: Optional[str]
+    home,  # type: Optional[str]
+    use_user_site,  # type: bool
+):
+    # type: (...) -> List[str]
+    assert not (use_user_site and prefix)
+
+    args = make_setuptools_shim_args(
+        setup_py_path,
+        global_options=global_options,
+        no_user_config=no_user_config,
+    )
+
+    args += ["develop", "--no-deps"]
+
+    args += install_options
+
+    if prefix:
+        args += ["--prefix", prefix]
+    if home is not None:
+        args += ["--home", home]
+
+    if use_user_site:
+        args += ["--user", "--prefix="]
+
+    return args
+
+
+def make_setuptools_egg_info_args(
+    setup_py_path,  # type: str
+    egg_info_dir,  # type: Optional[str]
+    no_user_config,  # type: bool
+):
+    # type: (...) -> List[str]
+    args = make_setuptools_shim_args(setup_py_path)
+    if no_user_config:
+        args += ["--no-user-cfg"]
+
+    args += ["egg_info"]
+
+    if egg_info_dir:
+        args += ["--egg-base", egg_info_dir]
+
+    return args
+
+
+def make_setuptools_install_args(
+    setup_py_path,  # type: str
+    global_options,  # type: Sequence[str]
+    install_options,  # type: Sequence[str]
+    record_filename,  # type: str
+    root,  # type: Optional[str]
+    prefix,  # type: Optional[str]
+    header_dir,  # type: Optional[str]
+    home,  # type: Optional[str]
+    use_user_site,  # type: bool
+    no_user_config,  # type: bool
+    pycompile  # type: bool
+):
+    # type: (...) -> List[str]
+    assert not (use_user_site and prefix)
+    assert not (use_user_site and root)
+
+    args = make_setuptools_shim_args(
+        setup_py_path,
+        global_options=global_options,
+        no_user_config=no_user_config,
+        unbuffered_output=True
+    )
+    args += ["install", "--record", record_filename]
+    args += ["--single-version-externally-managed"]
+
+    if root is not None:
+        args += ["--root", root]
+    if prefix is not None:
+        args += ["--prefix", prefix]
+    if home is not None:
+        args += ["--home", home]
+    if use_user_site:
+        args += ["--user", "--prefix="]
+
+    if pycompile:
+        args += ["--compile"]
+    else:
+        args += ["--no-compile"]
+
+    if header_dir:
+        args += ["--install-headers", header_dir]
+
+    args += install_options
+
+    return args
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py
new file mode 100644
index 0000000000000000000000000000000000000000..ea0176d341ec037e72399b43709aaa837f9c4744
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py
@@ -0,0 +1,278 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import subprocess
+
+from pip._vendor.six.moves import shlex_quote
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.utils.compat import console_to_str, str_to_display
+from pip._internal.utils.logging import subprocess_logger
+from pip._internal.utils.misc import HiddenText, path_to_display
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.ui import open_spinner
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Callable, Iterable, List, Mapping, Optional, Text, Union,
+    )
+    from pip._internal.utils.ui import SpinnerInterface
+
+    CommandArgs = List[Union[str, HiddenText]]
+
+
+LOG_DIVIDER = '----------------------------------------'
+
+
+def make_command(*args):
+    # type: (Union[str, HiddenText, CommandArgs]) -> CommandArgs
+    """
+    Create a CommandArgs object.
+    """
+    command_args = []  # type: CommandArgs
+    for arg in args:
+        # Check for list instead of CommandArgs since CommandArgs is
+        # only known during type-checking.
+        if isinstance(arg, list):
+            command_args.extend(arg)
+        else:
+            # Otherwise, arg is str or HiddenText.
+            command_args.append(arg)
+
+    return command_args
+
+
+def format_command_args(args):
+    # type: (Union[List[str], CommandArgs]) -> str
+    """
+    Format command arguments for display.
+    """
+    # For HiddenText arguments, display the redacted form by calling str().
+    # Also, we don't apply str() to arguments that aren't HiddenText since
+    # this can trigger a UnicodeDecodeError in Python 2 if the argument
+    # has type unicode and includes a non-ascii character.  (The type
+    # checker doesn't ensure the annotations are correct in all cases.)
+    return ' '.join(
+        shlex_quote(str(arg)) if isinstance(arg, HiddenText)
+        else shlex_quote(arg) for arg in args
+    )
+
+
+def reveal_command_args(args):
+    # type: (Union[List[str], CommandArgs]) -> List[str]
+    """
+    Return the arguments in their raw, unredacted form.
+    """
+    return [
+        arg.secret if isinstance(arg, HiddenText) else arg for arg in args
+    ]
+
+
+def make_subprocess_output_error(
+    cmd_args,     # type: Union[List[str], CommandArgs]
+    cwd,          # type: Optional[str]
+    lines,        # type: List[Text]
+    exit_status,  # type: int
+):
+    # type: (...) -> Text
+    """
+    Create and return the error message to use to log a subprocess error
+    with command output.
+
+    :param lines: A list of lines, each ending with a newline.
+    """
+    command = format_command_args(cmd_args)
+    # Convert `command` and `cwd` to text (unicode in Python 2) so we can use
+    # them as arguments in the unicode format string below. This avoids
+    # "UnicodeDecodeError: 'ascii' codec can't decode byte ..." in Python 2
+    # if either contains a non-ascii character.
+    command_display = str_to_display(command, desc='command bytes')
+    cwd_display = path_to_display(cwd)
+
+    # We know the joined output value ends in a newline.
+    output = ''.join(lines)
+    msg = (
+        # Use a unicode string to avoid "UnicodeEncodeError: 'ascii'
+        # codec can't encode character ..." in Python 2 when a format
+        # argument (e.g. `output`) has a non-ascii character.
+        u'Command errored out with exit status {exit_status}:\n'
+        ' command: {command_display}\n'
+        '     cwd: {cwd_display}\n'
+        'Complete output ({line_count} lines):\n{output}{divider}'
+    ).format(
+        exit_status=exit_status,
+        command_display=command_display,
+        cwd_display=cwd_display,
+        line_count=len(lines),
+        output=output,
+        divider=LOG_DIVIDER,
+    )
+    return msg
+
+
+def call_subprocess(
+    cmd,  # type: Union[List[str], CommandArgs]
+    show_stdout=False,  # type: bool
+    cwd=None,  # type: Optional[str]
+    on_returncode='raise',  # type: str
+    extra_ok_returncodes=None,  # type: Optional[Iterable[int]]
+    command_desc=None,  # type: Optional[str]
+    extra_environ=None,  # type: Optional[Mapping[str, Any]]
+    unset_environ=None,  # type: Optional[Iterable[str]]
+    spinner=None,  # type: Optional[SpinnerInterface]
+    log_failed_cmd=True  # type: Optional[bool]
+):
+    # type: (...) -> Text
+    """
+    Args:
+      show_stdout: if true, use INFO to log the subprocess's stderr and
+        stdout streams.  Otherwise, use DEBUG.  Defaults to False.
+      extra_ok_returncodes: an iterable of integer return codes that are
+        acceptable, in addition to 0. Defaults to None, which means [].
+      unset_environ: an iterable of environment variable names to unset
+        prior to calling subprocess.Popen().
+      log_failed_cmd: if false, failed commands are not logged, only raised.
+    """
+    if extra_ok_returncodes is None:
+        extra_ok_returncodes = []
+    if unset_environ is None:
+        unset_environ = []
+    # Most places in pip use show_stdout=False. What this means is--
+    #
+    # - We connect the child's output (combined stderr and stdout) to a
+    #   single pipe, which we read.
+    # - We log this output to stderr at DEBUG level as it is received.
+    # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't
+    #   requested), then we show a spinner so the user can still see the
+    #   subprocess is in progress.
+    # - If the subprocess exits with an error, we log the output to stderr
+    #   at ERROR level if it hasn't already been displayed to the console
+    #   (e.g. if --verbose logging wasn't enabled).  This way we don't log
+    #   the output to the console twice.
+    #
+    # If show_stdout=True, then the above is still done, but with DEBUG
+    # replaced by INFO.
+    if show_stdout:
+        # Then log the subprocess output at INFO level.
+        log_subprocess = subprocess_logger.info
+        used_level = logging.INFO
+    else:
+        # Then log the subprocess output using DEBUG.  This also ensures
+        # it will be logged to the log file (aka user_log), if enabled.
+        log_subprocess = subprocess_logger.debug
+        used_level = logging.DEBUG
+
+    # Whether the subprocess will be visible in the console.
+    showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level
+
+    # Only use the spinner if we're not showing the subprocess output
+    # and we have a spinner.
+    use_spinner = not showing_subprocess and spinner is not None
+
+    if command_desc is None:
+        command_desc = format_command_args(cmd)
+
+    log_subprocess("Running command %s", command_desc)
+    env = os.environ.copy()
+    if extra_environ:
+        env.update(extra_environ)
+    for name in unset_environ:
+        env.pop(name, None)
+    try:
+        proc = subprocess.Popen(
+            # Convert HiddenText objects to the underlying str.
+            reveal_command_args(cmd),
+            stderr=subprocess.STDOUT, stdin=subprocess.PIPE,
+            stdout=subprocess.PIPE, cwd=cwd, env=env,
+        )
+        proc.stdin.close()
+    except Exception as exc:
+        if log_failed_cmd:
+            subprocess_logger.critical(
+                "Error %s while executing command %s", exc, command_desc,
+            )
+        raise
+    all_output = []
+    while True:
+        # The "line" value is a unicode string in Python 2.
+        line = console_to_str(proc.stdout.readline())
+        if not line:
+            break
+        line = line.rstrip()
+        all_output.append(line + '\n')
+
+        # Show the line immediately.
+        log_subprocess(line)
+        # Update the spinner.
+        if use_spinner:
+            spinner.spin()
+    try:
+        proc.wait()
+    finally:
+        if proc.stdout:
+            proc.stdout.close()
+    proc_had_error = (
+        proc.returncode and proc.returncode not in extra_ok_returncodes
+    )
+    if use_spinner:
+        if proc_had_error:
+            spinner.finish("error")
+        else:
+            spinner.finish("done")
+    if proc_had_error:
+        if on_returncode == 'raise':
+            if not showing_subprocess and log_failed_cmd:
+                # Then the subprocess streams haven't been logged to the
+                # console yet.
+                msg = make_subprocess_output_error(
+                    cmd_args=cmd,
+                    cwd=cwd,
+                    lines=all_output,
+                    exit_status=proc.returncode,
+                )
+                subprocess_logger.error(msg)
+            exc_msg = (
+                'Command errored out with exit status {}: {} '
+                'Check the logs for full command output.'
+            ).format(proc.returncode, command_desc)
+            raise InstallationError(exc_msg)
+        elif on_returncode == 'warn':
+            subprocess_logger.warning(
+                'Command "%s" had error code %s in %s',
+                command_desc, proc.returncode, cwd,
+            )
+        elif on_returncode == 'ignore':
+            pass
+        else:
+            raise ValueError('Invalid value: on_returncode=%s' %
+                             repr(on_returncode))
+    return ''.join(all_output)
+
+
+def runner_with_spinner_message(message):
+    # type: (str) -> Callable[..., None]
+    """Provide a subprocess_runner that shows a spinner message.
+
+    Intended for use with for pep517's Pep517HookCaller. Thus, the runner has
+    an API that matches what's expected by Pep517HookCaller.subprocess_runner.
+    """
+
+    def runner(
+        cmd,  # type: List[str]
+        cwd=None,  # type: Optional[str]
+        extra_environ=None  # type: Optional[Mapping[str, Any]]
+    ):
+        # type: (...) -> None
+        with open_spinner(message) as spinner:
+            call_subprocess(
+                cmd,
+                cwd=cwd,
+                extra_environ=extra_environ,
+                spinner=spinner,
+            )
+
+    return runner
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py
new file mode 100644
index 0000000000000000000000000000000000000000..65e41bc70e2d8184b8917b539726556c84f2c0df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.py
@@ -0,0 +1,250 @@
+from __future__ import absolute_import
+
+import errno
+import itertools
+import logging
+import os.path
+import tempfile
+from contextlib import contextmanager
+
+from pip._vendor.contextlib2 import ExitStack
+
+from pip._internal.utils.misc import rmtree
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Dict, Iterator, Optional, TypeVar
+
+    _T = TypeVar('_T', bound='TempDirectory')
+
+
+logger = logging.getLogger(__name__)
+
+
+_tempdir_manager = None  # type: Optional[ExitStack]
+
+
+@contextmanager
+def global_tempdir_manager():
+    # type: () -> Iterator[None]
+    global _tempdir_manager
+    with ExitStack() as stack:
+        old_tempdir_manager, _tempdir_manager = _tempdir_manager, stack
+        try:
+            yield
+        finally:
+            _tempdir_manager = old_tempdir_manager
+
+
+class TempDirectoryTypeRegistry(object):
+    """Manages temp directory behavior
+    """
+
+    def __init__(self):
+        # type: () -> None
+        self._should_delete = {}  # type: Dict[str, bool]
+
+    def set_delete(self, kind, value):
+        # type: (str, bool) -> None
+        """Indicate whether a TempDirectory of the given kind should be
+        auto-deleted.
+        """
+        self._should_delete[kind] = value
+
+    def get_delete(self, kind):
+        # type: (str) -> bool
+        """Get configured auto-delete flag for a given TempDirectory type,
+        default True.
+        """
+        return self._should_delete.get(kind, True)
+
+
+_tempdir_registry = None  # type: Optional[TempDirectoryTypeRegistry]
+
+
+@contextmanager
+def tempdir_registry():
+    # type: () -> Iterator[TempDirectoryTypeRegistry]
+    """Provides a scoped global tempdir registry that can be used to dictate
+    whether directories should be deleted.
+    """
+    global _tempdir_registry
+    old_tempdir_registry = _tempdir_registry
+    _tempdir_registry = TempDirectoryTypeRegistry()
+    try:
+        yield _tempdir_registry
+    finally:
+        _tempdir_registry = old_tempdir_registry
+
+
+class TempDirectory(object):
+    """Helper class that owns and cleans up a temporary directory.
+
+    This class can be used as a context manager or as an OO representation of a
+    temporary directory.
+
+    Attributes:
+        path
+            Location to the created temporary directory
+        delete
+            Whether the directory should be deleted when exiting
+            (when used as a contextmanager)
+
+    Methods:
+        cleanup()
+            Deletes the temporary directory
+
+    When used as a context manager, if the delete attribute is True, on
+    exiting the context the temporary directory is deleted.
+    """
+
+    def __init__(
+        self,
+        path=None,    # type: Optional[str]
+        delete=None,  # type: Optional[bool]
+        kind="temp",  # type: str
+        globally_managed=False,  # type: bool
+    ):
+        super(TempDirectory, self).__init__()
+
+        # If we were given an explicit directory, resolve delete option now.
+        # Otherwise we wait until cleanup and see what tempdir_registry says.
+        if path is not None and delete is None:
+            delete = False
+
+        if path is None:
+            path = self._create(kind)
+
+        self._path = path
+        self._deleted = False
+        self.delete = delete
+        self.kind = kind
+
+        if globally_managed:
+            assert _tempdir_manager is not None
+            _tempdir_manager.enter_context(self)
+
+    @property
+    def path(self):
+        # type: () -> str
+        assert not self._deleted, (
+            "Attempted to access deleted path: {}".format(self._path)
+        )
+        return self._path
+
+    def __repr__(self):
+        # type: () -> str
+        return "<{} {!r}>".format(self.__class__.__name__, self.path)
+
+    def __enter__(self):
+        # type: (_T) -> _T
+        return self
+
+    def __exit__(self, exc, value, tb):
+        # type: (Any, Any, Any) -> None
+        if self.delete is not None:
+            delete = self.delete
+        elif _tempdir_registry:
+            delete = _tempdir_registry.get_delete(self.kind)
+        else:
+            delete = True
+
+        if delete:
+            self.cleanup()
+
+    def _create(self, kind):
+        # type: (str) -> str
+        """Create a temporary directory and store its path in self.path
+        """
+        # We realpath here because some systems have their default tmpdir
+        # symlinked to another directory.  This tends to confuse build
+        # scripts, so we canonicalize the path by traversing potential
+        # symlinks here.
+        path = os.path.realpath(
+            tempfile.mkdtemp(prefix="pip-{}-".format(kind))
+        )
+        logger.debug("Created temporary directory: {}".format(path))
+        return path
+
+    def cleanup(self):
+        # type: () -> None
+        """Remove the temporary directory created and reset state
+        """
+        self._deleted = True
+        if os.path.exists(self._path):
+            rmtree(self._path)
+
+
+class AdjacentTempDirectory(TempDirectory):
+    """Helper class that creates a temporary directory adjacent to a real one.
+
+    Attributes:
+        original
+            The original directory to create a temp directory for.
+        path
+            After calling create() or entering, contains the full
+            path to the temporary directory.
+        delete
+            Whether the directory should be deleted when exiting
+            (when used as a contextmanager)
+
+    """
+    # The characters that may be used to name the temp directory
+    # We always prepend a ~ and then rotate through these until
+    # a usable name is found.
+    # pkg_resources raises a different error for .dist-info folder
+    # with leading '-' and invalid metadata
+    LEADING_CHARS = "-~.=%0123456789"
+
+    def __init__(self, original, delete=None):
+        # type: (str, Optional[bool]) -> None
+        self.original = original.rstrip('/\\')
+        super(AdjacentTempDirectory, self).__init__(delete=delete)
+
+    @classmethod
+    def _generate_names(cls, name):
+        # type: (str) -> Iterator[str]
+        """Generates a series of temporary names.
+
+        The algorithm replaces the leading characters in the name
+        with ones that are valid filesystem characters, but are not
+        valid package names (for both Python and pip definitions of
+        package).
+        """
+        for i in range(1, len(name)):
+            for candidate in itertools.combinations_with_replacement(
+                    cls.LEADING_CHARS, i - 1):
+                new_name = '~' + ''.join(candidate) + name[i:]
+                if new_name != name:
+                    yield new_name
+
+        # If we make it this far, we will have to make a longer name
+        for i in range(len(cls.LEADING_CHARS)):
+            for candidate in itertools.combinations_with_replacement(
+                    cls.LEADING_CHARS, i):
+                new_name = '~' + ''.join(candidate) + name
+                if new_name != name:
+                    yield new_name
+
+    def _create(self, kind):
+        # type: (str) -> str
+        root, name = os.path.split(self.original)
+        for candidate in self._generate_names(name):
+            path = os.path.join(root, candidate)
+            try:
+                os.mkdir(path)
+            except OSError as ex:
+                # Continue if the name exists already
+                if ex.errno != errno.EEXIST:
+                    raise
+            else:
+                path = os.path.realpath(path)
+                break
+        else:
+            # Final fallback on the default behavior.
+            path = os.path.realpath(
+                tempfile.mkdtemp(prefix="pip-{}-".format(kind))
+            )
+
+        logger.debug("Created temporary directory: {}".format(path))
+        return path
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py
new file mode 100644
index 0000000000000000000000000000000000000000..8505a29b15d5f8a3565a52796c4e39cc6b826ffc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/typing.py
@@ -0,0 +1,38 @@
+"""For neatly implementing static typing in pip.
+
+`mypy` - the static type analysis tool we use - uses the `typing` module, which
+provides core functionality fundamental to mypy's functioning.
+
+Generally, `typing` would be imported at runtime and used in that fashion -
+it acts as a no-op at runtime and does not have any run-time overhead by
+design.
+
+As it turns out, `typing` is not vendorable - it uses separate sources for
+Python 2/Python 3. Thus, this codebase can not expect it to be present.
+To work around this, mypy allows the typing import to be behind a False-y
+optional to prevent it from running at runtime and type-comments can be used
+to remove the need for the types to be accessible directly during runtime.
+
+This module provides the False-y guard in a nicely named fashion so that a
+curious maintainer can reach here to read this.
+
+In pip, all static-typing related imports should be guarded as follows:
+
+    from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+    if MYPY_CHECK_RUNNING:
+        from typing import ...
+
+Ref: https://github.com/python/mypy/issues/3216
+"""
+
+MYPY_CHECK_RUNNING = False
+
+
+if MYPY_CHECK_RUNNING:
+    from typing import cast
+else:
+    # typing's cast() is needed at runtime, but we don't want to import typing.
+    # Thus, we use a dummy no-op version, which we tell mypy to ignore.
+    def cast(type_, value):  # type: ignore
+        return value
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py
new file mode 100644
index 0000000000000000000000000000000000000000..87782aa641d5dfe4845f751c8fcc05658da91501
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/ui.py
@@ -0,0 +1,428 @@
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import, division
+
+import contextlib
+import itertools
+import logging
+import sys
+import time
+from signal import SIGINT, default_int_handler, signal
+
+from pip._vendor import six
+from pip._vendor.progress import HIDE_CURSOR, SHOW_CURSOR
+from pip._vendor.progress.bar import Bar, FillingCirclesBar, IncrementalBar
+from pip._vendor.progress.spinner import Spinner
+
+from pip._internal.utils.compat import WINDOWS
+from pip._internal.utils.logging import get_indentation
+from pip._internal.utils.misc import format_size
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Any, Iterator, IO
+
+try:
+    from pip._vendor import colorama
+# Lots of different errors can come from this, including SystemError and
+# ImportError.
+except Exception:
+    colorama = None
+
+logger = logging.getLogger(__name__)
+
+
+def _select_progress_class(preferred, fallback):
+    encoding = getattr(preferred.file, "encoding", None)
+
+    # If we don't know what encoding this file is in, then we'll just assume
+    # that it doesn't support unicode and use the ASCII bar.
+    if not encoding:
+        return fallback
+
+    # Collect all of the possible characters we want to use with the preferred
+    # bar.
+    characters = [
+        getattr(preferred, "empty_fill", six.text_type()),
+        getattr(preferred, "fill", six.text_type()),
+    ]
+    characters += list(getattr(preferred, "phases", []))
+
+    # Try to decode the characters we're using for the bar using the encoding
+    # of the given file, if this works then we'll assume that we can use the
+    # fancier bar and if not we'll fall back to the plaintext bar.
+    try:
+        six.text_type().join(characters).encode(encoding)
+    except UnicodeEncodeError:
+        return fallback
+    else:
+        return preferred
+
+
+_BaseBar = _select_progress_class(IncrementalBar, Bar)  # type: Any
+
+
+class InterruptibleMixin(object):
+    """
+    Helper to ensure that self.finish() gets called on keyboard interrupt.
+
+    This allows downloads to be interrupted without leaving temporary state
+    (like hidden cursors) behind.
+
+    This class is similar to the progress library's existing SigIntMixin
+    helper, but as of version 1.2, that helper has the following problems:
+
+    1. It calls sys.exit().
+    2. It discards the existing SIGINT handler completely.
+    3. It leaves its own handler in place even after an uninterrupted finish,
+       which will have unexpected delayed effects if the user triggers an
+       unrelated keyboard interrupt some time after a progress-displaying
+       download has already completed, for example.
+    """
+
+    def __init__(self, *args, **kwargs):
+        """
+        Save the original SIGINT handler for later.
+        """
+        super(InterruptibleMixin, self).__init__(*args, **kwargs)
+
+        self.original_handler = signal(SIGINT, self.handle_sigint)
+
+        # If signal() returns None, the previous handler was not installed from
+        # Python, and we cannot restore it. This probably should not happen,
+        # but if it does, we must restore something sensible instead, at least.
+        # The least bad option should be Python's default SIGINT handler, which
+        # just raises KeyboardInterrupt.
+        if self.original_handler is None:
+            self.original_handler = default_int_handler
+
+    def finish(self):
+        """
+        Restore the original SIGINT handler after finishing.
+
+        This should happen regardless of whether the progress display finishes
+        normally, or gets interrupted.
+        """
+        super(InterruptibleMixin, self).finish()
+        signal(SIGINT, self.original_handler)
+
+    def handle_sigint(self, signum, frame):
+        """
+        Call self.finish() before delegating to the original SIGINT handler.
+
+        This handler should only be in place while the progress display is
+        active.
+        """
+        self.finish()
+        self.original_handler(signum, frame)
+
+
+class SilentBar(Bar):
+
+    def update(self):
+        pass
+
+
+class BlueEmojiBar(IncrementalBar):
+
+    suffix = "%(percent)d%%"
+    bar_prefix = " "
+    bar_suffix = " "
+    phases = (u"\U0001F539", u"\U0001F537", u"\U0001F535")  # type: Any
+
+
+class DownloadProgressMixin(object):
+
+    def __init__(self, *args, **kwargs):
+        super(DownloadProgressMixin, self).__init__(*args, **kwargs)
+        self.message = (" " * (get_indentation() + 2)) + self.message
+
+    @property
+    def downloaded(self):
+        return format_size(self.index)
+
+    @property
+    def download_speed(self):
+        # Avoid zero division errors...
+        if self.avg == 0.0:
+            return "..."
+        return format_size(1 / self.avg) + "/s"
+
+    @property
+    def pretty_eta(self):
+        if self.eta:
+            return "eta %s" % self.eta_td
+        return ""
+
+    def iter(self, it):
+        for x in it:
+            yield x
+            self.next(len(x))
+        self.finish()
+
+
+class WindowsMixin(object):
+
+    def __init__(self, *args, **kwargs):
+        # The Windows terminal does not support the hide/show cursor ANSI codes
+        # even with colorama. So we'll ensure that hide_cursor is False on
+        # Windows.
+        # This call needs to go before the super() call, so that hide_cursor
+        # is set in time. The base progress bar class writes the "hide cursor"
+        # code to the terminal in its init, so if we don't set this soon
+        # enough, we get a "hide" with no corresponding "show"...
+        if WINDOWS and self.hide_cursor:
+            self.hide_cursor = False
+
+        super(WindowsMixin, self).__init__(*args, **kwargs)
+
+        # Check if we are running on Windows and we have the colorama module,
+        # if we do then wrap our file with it.
+        if WINDOWS and colorama:
+            self.file = colorama.AnsiToWin32(self.file)
+            # The progress code expects to be able to call self.file.isatty()
+            # but the colorama.AnsiToWin32() object doesn't have that, so we'll
+            # add it.
+            self.file.isatty = lambda: self.file.wrapped.isatty()
+            # The progress code expects to be able to call self.file.flush()
+            # but the colorama.AnsiToWin32() object doesn't have that, so we'll
+            # add it.
+            self.file.flush = lambda: self.file.wrapped.flush()
+
+
+class BaseDownloadProgressBar(WindowsMixin, InterruptibleMixin,
+                              DownloadProgressMixin):
+
+    file = sys.stdout
+    message = "%(percent)d%%"
+    suffix = "%(downloaded)s %(download_speed)s %(pretty_eta)s"
+
+# NOTE: The "type: ignore" comments on the following classes are there to
+#       work around https://github.com/python/typing/issues/241
+
+
+class DefaultDownloadProgressBar(BaseDownloadProgressBar,
+                                 _BaseBar):
+    pass
+
+
+class DownloadSilentBar(BaseDownloadProgressBar, SilentBar):  # type: ignore
+    pass
+
+
+class DownloadBar(BaseDownloadProgressBar,  # type: ignore
+                  Bar):
+    pass
+
+
+class DownloadFillingCirclesBar(BaseDownloadProgressBar,  # type: ignore
+                                FillingCirclesBar):
+    pass
+
+
+class DownloadBlueEmojiProgressBar(BaseDownloadProgressBar,  # type: ignore
+                                   BlueEmojiBar):
+    pass
+
+
+class DownloadProgressSpinner(WindowsMixin, InterruptibleMixin,
+                              DownloadProgressMixin, Spinner):
+
+    file = sys.stdout
+    suffix = "%(downloaded)s %(download_speed)s"
+
+    def next_phase(self):
+        if not hasattr(self, "_phaser"):
+            self._phaser = itertools.cycle(self.phases)
+        return next(self._phaser)
+
+    def update(self):
+        message = self.message % self
+        phase = self.next_phase()
+        suffix = self.suffix % self
+        line = ''.join([
+            message,
+            " " if message else "",
+            phase,
+            " " if suffix else "",
+            suffix,
+        ])
+
+        self.writeln(line)
+
+
+BAR_TYPES = {
+    "off": (DownloadSilentBar, DownloadSilentBar),
+    "on": (DefaultDownloadProgressBar, DownloadProgressSpinner),
+    "ascii": (DownloadBar, DownloadProgressSpinner),
+    "pretty": (DownloadFillingCirclesBar, DownloadProgressSpinner),
+    "emoji": (DownloadBlueEmojiProgressBar, DownloadProgressSpinner)
+}
+
+
+def DownloadProgressProvider(progress_bar, max=None):
+    if max is None or max == 0:
+        return BAR_TYPES[progress_bar][1]().iter
+    else:
+        return BAR_TYPES[progress_bar][0](max=max).iter
+
+
+################################################################
+# Generic "something is happening" spinners
+#
+# We don't even try using progress.spinner.Spinner here because it's actually
+# simpler to reimplement from scratch than to coerce their code into doing
+# what we need.
+################################################################
+
+@contextlib.contextmanager
+def hidden_cursor(file):
+    # type: (IO[Any]) -> Iterator[None]
+    # The Windows terminal does not support the hide/show cursor ANSI codes,
+    # even via colorama. So don't even try.
+    if WINDOWS:
+        yield
+    # We don't want to clutter the output with control characters if we're
+    # writing to a file, or if the user is running with --quiet.
+    # See https://github.com/pypa/pip/issues/3418
+    elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO:
+        yield
+    else:
+        file.write(HIDE_CURSOR)
+        try:
+            yield
+        finally:
+            file.write(SHOW_CURSOR)
+
+
+class RateLimiter(object):
+    def __init__(self, min_update_interval_seconds):
+        # type: (float) -> None
+        self._min_update_interval_seconds = min_update_interval_seconds
+        self._last_update = 0  # type: float
+
+    def ready(self):
+        # type: () -> bool
+        now = time.time()
+        delta = now - self._last_update
+        return delta >= self._min_update_interval_seconds
+
+    def reset(self):
+        # type: () -> None
+        self._last_update = time.time()
+
+
+class SpinnerInterface(object):
+    def spin(self):
+        # type: () -> None
+        raise NotImplementedError()
+
+    def finish(self, final_status):
+        # type: (str) -> None
+        raise NotImplementedError()
+
+
+class InteractiveSpinner(SpinnerInterface):
+    def __init__(self, message, file=None, spin_chars="-\\|/",
+                 # Empirically, 8 updates/second looks nice
+                 min_update_interval_seconds=0.125):
+        self._message = message
+        if file is None:
+            file = sys.stdout
+        self._file = file
+        self._rate_limiter = RateLimiter(min_update_interval_seconds)
+        self._finished = False
+
+        self._spin_cycle = itertools.cycle(spin_chars)
+
+        self._file.write(" " * get_indentation() + self._message + " ... ")
+        self._width = 0
+
+    def _write(self, status):
+        assert not self._finished
+        # Erase what we wrote before by backspacing to the beginning, writing
+        # spaces to overwrite the old text, and then backspacing again
+        backup = "\b" * self._width
+        self._file.write(backup + " " * self._width + backup)
+        # Now we have a blank slate to add our status
+        self._file.write(status)
+        self._width = len(status)
+        self._file.flush()
+        self._rate_limiter.reset()
+
+    def spin(self):
+        # type: () -> None
+        if self._finished:
+            return
+        if not self._rate_limiter.ready():
+            return
+        self._write(next(self._spin_cycle))
+
+    def finish(self, final_status):
+        # type: (str) -> None
+        if self._finished:
+            return
+        self._write(final_status)
+        self._file.write("\n")
+        self._file.flush()
+        self._finished = True
+
+
+# Used for dumb terminals, non-interactive installs (no tty), etc.
+# We still print updates occasionally (once every 60 seconds by default) to
+# act as a keep-alive for systems like Travis-CI that take lack-of-output as
+# an indication that a task has frozen.
+class NonInteractiveSpinner(SpinnerInterface):
+    def __init__(self, message, min_update_interval_seconds=60):
+        # type: (str, float) -> None
+        self._message = message
+        self._finished = False
+        self._rate_limiter = RateLimiter(min_update_interval_seconds)
+        self._update("started")
+
+    def _update(self, status):
+        assert not self._finished
+        self._rate_limiter.reset()
+        logger.info("%s: %s", self._message, status)
+
+    def spin(self):
+        # type: () -> None
+        if self._finished:
+            return
+        if not self._rate_limiter.ready():
+            return
+        self._update("still running...")
+
+    def finish(self, final_status):
+        # type: (str) -> None
+        if self._finished:
+            return
+        self._update("finished with status '%s'" % (final_status,))
+        self._finished = True
+
+
+@contextlib.contextmanager
+def open_spinner(message):
+    # type: (str) -> Iterator[SpinnerInterface]
+    # Interactive spinner goes directly to sys.stdout rather than being routed
+    # through the logging system, but it acts like it has level INFO,
+    # i.e. it's only displayed if we're at level INFO or better.
+    # Non-interactive spinner goes through the logging system, so it is always
+    # in sync with logging configuration.
+    if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO:
+        spinner = InteractiveSpinner(message)  # type: SpinnerInterface
+    else:
+        spinner = NonInteractiveSpinner(message)
+    try:
+        with hidden_cursor(sys.stdout):
+            yield spinner
+    except KeyboardInterrupt:
+        spinner.finish("canceled")
+        raise
+    except Exception:
+        spinner.finish("error")
+        raise
+    else:
+        spinner.finish("done")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py
new file mode 100644
index 0000000000000000000000000000000000000000..7252dc217bfaece6fedbaf835cecbb2a06cdcbb0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py
@@ -0,0 +1,272 @@
+"""Utilities related archives.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import shutil
+import stat
+import tarfile
+import zipfile
+
+from pip._internal.exceptions import InstallationError
+from pip._internal.utils.filetypes import (
+    BZ2_EXTENSIONS,
+    TAR_EXTENSIONS,
+    XZ_EXTENSIONS,
+    ZIP_EXTENSIONS,
+)
+from pip._internal.utils.misc import ensure_dir
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Iterable, List, Optional, Text, Union
+
+
+logger = logging.getLogger(__name__)
+
+
+SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS
+
+try:
+    import bz2  # noqa
+    SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS
+except ImportError:
+    logger.debug('bz2 module is not available')
+
+try:
+    # Only for Python 3.3+
+    import lzma  # noqa
+    SUPPORTED_EXTENSIONS += XZ_EXTENSIONS
+except ImportError:
+    logger.debug('lzma module is not available')
+
+
+def current_umask():
+    """Get the current umask which involves having to set it temporarily."""
+    mask = os.umask(0)
+    os.umask(mask)
+    return mask
+
+
+def split_leading_dir(path):
+    # type: (Union[str, Text]) -> List[Union[str, Text]]
+    path = path.lstrip('/').lstrip('\\')
+    if (
+        '/' in path and (
+            ('\\' in path and path.find('/') < path.find('\\')) or
+            '\\' not in path
+        )
+    ):
+        return path.split('/', 1)
+    elif '\\' in path:
+        return path.split('\\', 1)
+    else:
+        return [path, '']
+
+
+def has_leading_dir(paths):
+    # type: (Iterable[Union[str, Text]]) -> bool
+    """Returns true if all the paths have the same leading path name
+    (i.e., everything is in one subdirectory in an archive)"""
+    common_prefix = None
+    for path in paths:
+        prefix, rest = split_leading_dir(path)
+        if not prefix:
+            return False
+        elif common_prefix is None:
+            common_prefix = prefix
+        elif prefix != common_prefix:
+            return False
+    return True
+
+
+def is_within_directory(directory, target):
+    # type: ((Union[str, Text]), (Union[str, Text])) -> bool
+    """
+    Return true if the absolute path of target is within the directory
+    """
+    abs_directory = os.path.abspath(directory)
+    abs_target = os.path.abspath(target)
+
+    prefix = os.path.commonprefix([abs_directory, abs_target])
+    return prefix == abs_directory
+
+
+def unzip_file(filename, location, flatten=True):
+    # type: (str, str, bool) -> None
+    """
+    Unzip the file (with path `filename`) to the destination `location`.  All
+    files are written based on system defaults and umask (i.e. permissions are
+    not preserved), except that regular file members with any execute
+    permissions (user, group, or world) have "chmod +x" applied after being
+    written. Note that for windows, any execute changes using os.chmod are
+    no-ops per the python docs.
+    """
+    ensure_dir(location)
+    zipfp = open(filename, 'rb')
+    try:
+        zip = zipfile.ZipFile(zipfp, allowZip64=True)
+        leading = has_leading_dir(zip.namelist()) and flatten
+        for info in zip.infolist():
+            name = info.filename
+            fn = name
+            if leading:
+                fn = split_leading_dir(name)[1]
+            fn = os.path.join(location, fn)
+            dir = os.path.dirname(fn)
+            if not is_within_directory(location, fn):
+                message = (
+                    'The zip file ({}) has a file ({}) trying to install '
+                    'outside target directory ({})'
+                )
+                raise InstallationError(message.format(filename, fn, location))
+            if fn.endswith('/') or fn.endswith('\\'):
+                # A directory
+                ensure_dir(fn)
+            else:
+                ensure_dir(dir)
+                # Don't use read() to avoid allocating an arbitrarily large
+                # chunk of memory for the file's content
+                fp = zip.open(name)
+                try:
+                    with open(fn, 'wb') as destfp:
+                        shutil.copyfileobj(fp, destfp)
+                finally:
+                    fp.close()
+                    mode = info.external_attr >> 16
+                    # if mode and regular file and any execute permissions for
+                    # user/group/world?
+                    if mode and stat.S_ISREG(mode) and mode & 0o111:
+                        # make dest file have execute for user/group/world
+                        # (chmod +x) no-op on windows per python docs
+                        os.chmod(fn, (0o777 - current_umask() | 0o111))
+    finally:
+        zipfp.close()
+
+
+def untar_file(filename, location):
+    # type: (str, str) -> None
+    """
+    Untar the file (with path `filename`) to the destination `location`.
+    All files are written based on system defaults and umask (i.e. permissions
+    are not preserved), except that regular file members with any execute
+    permissions (user, group, or world) have "chmod +x" applied after being
+    written.  Note that for windows, any execute changes using os.chmod are
+    no-ops per the python docs.
+    """
+    ensure_dir(location)
+    if filename.lower().endswith('.gz') or filename.lower().endswith('.tgz'):
+        mode = 'r:gz'
+    elif filename.lower().endswith(BZ2_EXTENSIONS):
+        mode = 'r:bz2'
+    elif filename.lower().endswith(XZ_EXTENSIONS):
+        mode = 'r:xz'
+    elif filename.lower().endswith('.tar'):
+        mode = 'r'
+    else:
+        logger.warning(
+            'Cannot determine compression type for file %s', filename,
+        )
+        mode = 'r:*'
+    tar = tarfile.open(filename, mode)
+    try:
+        leading = has_leading_dir([
+            member.name for member in tar.getmembers()
+        ])
+        for member in tar.getmembers():
+            fn = member.name
+            if leading:
+                # https://github.com/python/mypy/issues/1174
+                fn = split_leading_dir(fn)[1]  # type: ignore
+            path = os.path.join(location, fn)
+            if not is_within_directory(location, path):
+                message = (
+                    'The tar file ({}) has a file ({}) trying to install '
+                    'outside target directory ({})'
+                )
+                raise InstallationError(
+                    message.format(filename, path, location)
+                )
+            if member.isdir():
+                ensure_dir(path)
+            elif member.issym():
+                try:
+                    # https://github.com/python/typeshed/issues/2673
+                    tar._extract_member(member, path)  # type: ignore
+                except Exception as exc:
+                    # Some corrupt tar files seem to produce this
+                    # (specifically bad symlinks)
+                    logger.warning(
+                        'In the tar file %s the member %s is invalid: %s',
+                        filename, member.name, exc,
+                    )
+                    continue
+            else:
+                try:
+                    fp = tar.extractfile(member)
+                except (KeyError, AttributeError) as exc:
+                    # Some corrupt tar files seem to produce this
+                    # (specifically bad symlinks)
+                    logger.warning(
+                        'In the tar file %s the member %s is invalid: %s',
+                        filename, member.name, exc,
+                    )
+                    continue
+                ensure_dir(os.path.dirname(path))
+                with open(path, 'wb') as destfp:
+                    shutil.copyfileobj(fp, destfp)
+                fp.close()
+                # Update the timestamp (useful for cython compiled files)
+                # https://github.com/python/typeshed/issues/2673
+                tar.utime(member, path)  # type: ignore
+                # member have any execute permissions for user/group/world?
+                if member.mode & 0o111:
+                    # make dest file have execute for user/group/world
+                    # no-op on windows per python docs
+                    os.chmod(path, (0o777 - current_umask() | 0o111))
+    finally:
+        tar.close()
+
+
+def unpack_file(
+        filename,  # type: str
+        location,  # type: str
+        content_type=None,  # type: Optional[str]
+):
+    # type: (...) -> None
+    filename = os.path.realpath(filename)
+    if (
+        content_type == 'application/zip' or
+        filename.lower().endswith(ZIP_EXTENSIONS) or
+        zipfile.is_zipfile(filename)
+    ):
+        unzip_file(
+            filename,
+            location,
+            flatten=not filename.endswith('.whl')
+        )
+    elif (
+        content_type == 'application/x-gzip' or
+        tarfile.is_tarfile(filename) or
+        filename.lower().endswith(
+            TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS
+        )
+    ):
+        untar_file(filename, location)
+    else:
+        # FIXME: handle?
+        # FIXME: magic signatures?
+        logger.critical(
+            'Cannot unpack file %s (downloaded from %s, content-type: %s); '
+            'cannot detect archive format',
+            filename, location, content_type,
+        )
+        raise InstallationError(
+            'Cannot determine archive format of {}'.format(location)
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ad40feb345423ea76d86cc0e4541e3de84bae34
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/urls.py
@@ -0,0 +1,54 @@
+import os
+import sys
+
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+from pip._vendor.six.moves.urllib import request as urllib_request
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Text, Union
+
+
+def get_url_scheme(url):
+    # type: (Union[str, Text]) -> Optional[Text]
+    if ':' not in url:
+        return None
+    return url.split(':', 1)[0].lower()
+
+
+def path_to_url(path):
+    # type: (Union[str, Text]) -> str
+    """
+    Convert a path to a file: URL.  The path will be made absolute and have
+    quoted path parts.
+    """
+    path = os.path.normpath(os.path.abspath(path))
+    url = urllib_parse.urljoin('file:', urllib_request.pathname2url(path))
+    return url
+
+
+def url_to_path(url):
+    # type: (str) -> str
+    """
+    Convert a file: URL to a path.
+    """
+    assert url.startswith('file:'), (
+        "You can only turn file: urls into filenames (not %r)" % url)
+
+    _, netloc, path, _, _ = urllib_parse.urlsplit(url)
+
+    if not netloc or netloc == 'localhost':
+        # According to RFC 8089, same as empty authority.
+        netloc = ''
+    elif sys.platform == 'win32':
+        # If we have a UNC path, prepend UNC share notation.
+        netloc = '\\\\' + netloc
+    else:
+        raise ValueError(
+            'non-local file URIs are not supported on this platform: %r'
+            % url
+        )
+
+    path = urllib_request.url2pathname(netloc + path)
+    return path
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py
new file mode 100644
index 0000000000000000000000000000000000000000..d81e6ac54bb13a898295923126a934b9ea76f641
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py
@@ -0,0 +1,115 @@
+from __future__ import absolute_import
+
+import logging
+import os
+import re
+import site
+import sys
+
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from typing import List, Optional
+
+logger = logging.getLogger(__name__)
+_INCLUDE_SYSTEM_SITE_PACKAGES_REGEX = re.compile(
+    r"include-system-site-packages\s*=\s*(?P<value>true|false)"
+)
+
+
+def _running_under_venv():
+    # type: () -> bool
+    """Checks if sys.base_prefix and sys.prefix match.
+
+    This handles PEP 405 compliant virtual environments.
+    """
+    return sys.prefix != getattr(sys, "base_prefix", sys.prefix)
+
+
+def _running_under_regular_virtualenv():
+    # type: () -> bool
+    """Checks if sys.real_prefix is set.
+
+    This handles virtual environments created with pypa's virtualenv.
+    """
+    # pypa/virtualenv case
+    return hasattr(sys, 'real_prefix')
+
+
+def running_under_virtualenv():
+    # type: () -> bool
+    """Return True if we're running inside a virtualenv, False otherwise.
+    """
+    return _running_under_venv() or _running_under_regular_virtualenv()
+
+
+def _get_pyvenv_cfg_lines():
+    # type: () -> Optional[List[str]]
+    """Reads {sys.prefix}/pyvenv.cfg and returns its contents as list of lines
+
+    Returns None, if it could not read/access the file.
+    """
+    pyvenv_cfg_file = os.path.join(sys.prefix, 'pyvenv.cfg')
+    try:
+        with open(pyvenv_cfg_file) as f:
+            return f.read().splitlines()  # avoids trailing newlines
+    except IOError:
+        return None
+
+
+def _no_global_under_venv():
+    # type: () -> bool
+    """Check `{sys.prefix}/pyvenv.cfg` for system site-packages inclusion
+
+    PEP 405 specifies that when system site-packages are not supposed to be
+    visible from a virtual environment, `pyvenv.cfg` must contain the following
+    line:
+
+        include-system-site-packages = false
+
+    Additionally, log a warning if accessing the file fails.
+    """
+    cfg_lines = _get_pyvenv_cfg_lines()
+    if cfg_lines is None:
+        # We're not in a "sane" venv, so assume there is no system
+        # site-packages access (since that's PEP 405's default state).
+        logger.warning(
+            "Could not access 'pyvenv.cfg' despite a virtual environment "
+            "being active. Assuming global site-packages is not accessible "
+            "in this environment."
+        )
+        return True
+
+    for line in cfg_lines:
+        match = _INCLUDE_SYSTEM_SITE_PACKAGES_REGEX.match(line)
+        if match is not None and match.group('value') == 'false':
+            return True
+    return False
+
+
+def _no_global_under_regular_virtualenv():
+    # type: () -> bool
+    """Check if "no-global-site-packages.txt" exists beside site.py
+
+    This mirrors logic in pypa/virtualenv for determining whether system
+    site-packages are visible in the virtual environment.
+    """
+    site_mod_dir = os.path.dirname(os.path.abspath(site.__file__))
+    no_global_site_packages_file = os.path.join(
+        site_mod_dir, 'no-global-site-packages.txt',
+    )
+    return os.path.exists(no_global_site_packages_file)
+
+
+def virtualenv_no_global():
+    # type: () -> bool
+    """Returns a boolean, whether running in venv with no system site-packages.
+    """
+
+    if _running_under_regular_virtualenv():
+        return _no_global_under_regular_virtualenv()
+
+    if _running_under_venv():
+        return _no_global_under_venv()
+
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..837e0afd7e5ca32666ffd0acdc33549d03626bcd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/utils/wheel.py
@@ -0,0 +1,225 @@
+"""Support functions for working with wheel files.
+"""
+
+from __future__ import absolute_import
+
+import logging
+from email.parser import Parser
+from zipfile import ZipFile
+
+from pip._vendor.packaging.utils import canonicalize_name
+from pip._vendor.pkg_resources import DistInfoDistribution
+from pip._vendor.six import PY2, ensure_str
+
+from pip._internal.exceptions import UnsupportedWheel
+from pip._internal.utils.pkg_resources import DictMetadata
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+
+if MYPY_CHECK_RUNNING:
+    from email.message import Message
+    from typing import Dict, Tuple
+
+    from pip._vendor.pkg_resources import Distribution
+
+if PY2:
+    from zipfile import BadZipfile as BadZipFile
+else:
+    from zipfile import BadZipFile
+
+
+VERSION_COMPATIBLE = (1, 0)
+
+
+logger = logging.getLogger(__name__)
+
+
+class WheelMetadata(DictMetadata):
+    """Metadata provider that maps metadata decoding exceptions to our
+    internal exception type.
+    """
+    def __init__(self, metadata, wheel_name):
+        # type: (Dict[str, bytes], str) -> None
+        super(WheelMetadata, self).__init__(metadata)
+        self._wheel_name = wheel_name
+
+    def get_metadata(self, name):
+        # type: (str) -> str
+        try:
+            return super(WheelMetadata, self).get_metadata(name)
+        except UnicodeDecodeError as e:
+            # Augment the default error with the origin of the file.
+            raise UnsupportedWheel(
+                "Error decoding metadata for {}: {}".format(
+                    self._wheel_name, e
+                )
+            )
+
+
+def pkg_resources_distribution_for_wheel(wheel_zip, name, location):
+    # type: (ZipFile, str, str) -> Distribution
+    """Get a pkg_resources distribution given a wheel.
+
+    :raises UnsupportedWheel: on any errors
+    """
+    info_dir, _ = parse_wheel(wheel_zip, name)
+
+    metadata_files = [
+        p for p in wheel_zip.namelist() if p.startswith("{}/".format(info_dir))
+    ]
+
+    metadata_text = {}  # type: Dict[str, bytes]
+    for path in metadata_files:
+        # If a flag is set, namelist entries may be unicode in Python 2.
+        # We coerce them to native str type to match the types used in the rest
+        # of the code. This cannot fail because unicode can always be encoded
+        # with UTF-8.
+        full_path = ensure_str(path)
+        _, metadata_name = full_path.split("/", 1)
+
+        try:
+            metadata_text[metadata_name] = read_wheel_metadata_file(
+                wheel_zip, full_path
+            )
+        except UnsupportedWheel as e:
+            raise UnsupportedWheel(
+                "{} has an invalid wheel, {}".format(name, str(e))
+            )
+
+    metadata = WheelMetadata(metadata_text, location)
+
+    return DistInfoDistribution(
+        location=location, metadata=metadata, project_name=name
+    )
+
+
+def parse_wheel(wheel_zip, name):
+    # type: (ZipFile, str) -> Tuple[str, Message]
+    """Extract information from the provided wheel, ensuring it meets basic
+    standards.
+
+    Returns the name of the .dist-info directory and the parsed WHEEL metadata.
+    """
+    try:
+        info_dir = wheel_dist_info_dir(wheel_zip, name)
+        metadata = wheel_metadata(wheel_zip, info_dir)
+        version = wheel_version(metadata)
+    except UnsupportedWheel as e:
+        raise UnsupportedWheel(
+            "{} has an invalid wheel, {}".format(name, str(e))
+        )
+
+    check_compatibility(version, name)
+
+    return info_dir, metadata
+
+
+def wheel_dist_info_dir(source, name):
+    # type: (ZipFile, str) -> str
+    """Returns the name of the contained .dist-info directory.
+
+    Raises AssertionError or UnsupportedWheel if not found, >1 found, or
+    it doesn't match the provided name.
+    """
+    # Zip file path separators must be /
+    subdirs = list(set(p.split("/")[0] for p in source.namelist()))
+
+    info_dirs = [s for s in subdirs if s.endswith('.dist-info')]
+
+    if not info_dirs:
+        raise UnsupportedWheel(".dist-info directory not found")
+
+    if len(info_dirs) > 1:
+        raise UnsupportedWheel(
+            "multiple .dist-info directories found: {}".format(
+                ", ".join(info_dirs)
+            )
+        )
+
+    info_dir = info_dirs[0]
+
+    info_dir_name = canonicalize_name(info_dir)
+    canonical_name = canonicalize_name(name)
+    if not info_dir_name.startswith(canonical_name):
+        raise UnsupportedWheel(
+            ".dist-info directory {!r} does not start with {!r}".format(
+                info_dir, canonical_name
+            )
+        )
+
+    # Zip file paths can be unicode or str depending on the zip entry flags,
+    # so normalize it.
+    return ensure_str(info_dir)
+
+
+def read_wheel_metadata_file(source, path):
+    # type: (ZipFile, str) -> bytes
+    try:
+        return source.read(path)
+        # BadZipFile for general corruption, KeyError for missing entry,
+        # and RuntimeError for password-protected files
+    except (BadZipFile, KeyError, RuntimeError) as e:
+        raise UnsupportedWheel(
+            "could not read {!r} file: {!r}".format(path, e)
+        )
+
+
+def wheel_metadata(source, dist_info_dir):
+    # type: (ZipFile, str) -> Message
+    """Return the WHEEL metadata of an extracted wheel, if possible.
+    Otherwise, raise UnsupportedWheel.
+    """
+    path = "{}/WHEEL".format(dist_info_dir)
+    # Zip file path separators must be /
+    wheel_contents = read_wheel_metadata_file(source, path)
+
+    try:
+        wheel_text = ensure_str(wheel_contents)
+    except UnicodeDecodeError as e:
+        raise UnsupportedWheel("error decoding {!r}: {!r}".format(path, e))
+
+    # FeedParser (used by Parser) does not raise any exceptions. The returned
+    # message may have .defects populated, but for backwards-compatibility we
+    # currently ignore them.
+    return Parser().parsestr(wheel_text)
+
+
+def wheel_version(wheel_data):
+    # type: (Message) -> Tuple[int, ...]
+    """Given WHEEL metadata, return the parsed Wheel-Version.
+    Otherwise, raise UnsupportedWheel.
+    """
+    version_text = wheel_data["Wheel-Version"]
+    if version_text is None:
+        raise UnsupportedWheel("WHEEL is missing Wheel-Version")
+
+    version = version_text.strip()
+
+    try:
+        return tuple(map(int, version.split('.')))
+    except ValueError:
+        raise UnsupportedWheel("invalid Wheel-Version: {!r}".format(version))
+
+
+def check_compatibility(version, name):
+    # type: (Tuple[int, ...], str) -> None
+    """Raises errors or warns if called with an incompatible Wheel-Version.
+
+    Pip should refuse to install a Wheel-Version that's a major series
+    ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
+    installing a version only minor version ahead (e.g 1.2 > 1.1).
+
+    version: a 2-tuple representing a Wheel-Version (Major, Minor)
+    name: name of wheel or package to raise exception about
+
+    :raises UnsupportedWheel: when an incompatible Wheel-Version is given
+    """
+    if version[0] > VERSION_COMPATIBLE[0]:
+        raise UnsupportedWheel(
+            "%s's Wheel-Version (%s) is not compatible with this version "
+            "of pip" % (name, '.'.join(map(str, version)))
+        )
+    elif version > VERSION_COMPATIBLE:
+        logger.warning(
+            'Installing from a newer Wheel-Version (%s)',
+            '.'.join(map(str, version)),
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2a4eb1375763fa3287d171a2a1b0766d1d9d1224
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py
@@ -0,0 +1,15 @@
+# Expose a limited set of classes and functions so callers outside of
+# the vcs package don't need to import deeper than `pip._internal.vcs`.
+# (The test directory and imports protected by MYPY_CHECK_RUNNING may
+# still need to import from a vcs sub-package.)
+# Import all vcs modules to register each VCS in the VcsSupport object.
+import pip._internal.vcs.bazaar
+import pip._internal.vcs.git
+import pip._internal.vcs.mercurial
+import pip._internal.vcs.subversion  # noqa: F401
+from pip._internal.vcs.versioncontrol import (  # noqa: F401
+    RemoteNotFoundError,
+    is_url,
+    make_vcs_requirement_url,
+    vcs,
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.py
new file mode 100644
index 0000000000000000000000000000000000000000..347c06f9dc7c882299bf1a829049849a06328fe5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.py
@@ -0,0 +1,120 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.utils.misc import display_path, rmtree
+from pip._internal.utils.subprocess import make_command
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url
+from pip._internal.vcs.versioncontrol import VersionControl, vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Tuple
+    from pip._internal.utils.misc import HiddenText
+    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions
+
+
+logger = logging.getLogger(__name__)
+
+
+class Bazaar(VersionControl):
+    name = 'bzr'
+    dirname = '.bzr'
+    repo_name = 'branch'
+    schemes = (
+        'bzr', 'bzr+http', 'bzr+https', 'bzr+ssh', 'bzr+sftp', 'bzr+ftp',
+        'bzr+lp',
+    )
+
+    def __init__(self, *args, **kwargs):
+        super(Bazaar, self).__init__(*args, **kwargs)
+        # This is only needed for python <2.7.5
+        # Register lp but do not expose as a scheme to support bzr+lp.
+        if getattr(urllib_parse, 'uses_fragment', None):
+            urllib_parse.uses_fragment.extend(['lp'])
+
+    @staticmethod
+    def get_base_rev_args(rev):
+        return ['-r', rev]
+
+    def export(self, location, url):
+        # type: (str, HiddenText) -> None
+        """
+        Export the Bazaar repository at the url to the destination location
+        """
+        # Remove the location to make sure Bazaar can export it correctly
+        if os.path.exists(location):
+            rmtree(location)
+
+        url, rev_options = self.get_url_rev_options(url)
+        self.run_command(
+            make_command('export', location, url, rev_options.to_args()),
+            show_stdout=False,
+        )
+
+    def fetch_new(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        rev_display = rev_options.to_display()
+        logger.info(
+            'Checking out %s%s to %s',
+            url,
+            rev_display,
+            display_path(dest),
+        )
+        cmd_args = (
+            make_command('branch', '-q', rev_options.to_args(), url, dest)
+        )
+        self.run_command(cmd_args)
+
+    def switch(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        self.run_command(make_command('switch', url), cwd=dest)
+
+    def update(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        cmd_args = make_command('pull', '-q', rev_options.to_args())
+        self.run_command(cmd_args, cwd=dest)
+
+    @classmethod
+    def get_url_rev_and_auth(cls, url):
+        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
+        # hotfix the URL scheme after removing bzr+ from bzr+ssh:// readd it
+        url, rev, user_pass = super(Bazaar, cls).get_url_rev_and_auth(url)
+        if url.startswith('ssh://'):
+            url = 'bzr+' + url
+        return url, rev, user_pass
+
+    @classmethod
+    def get_remote_url(cls, location):
+        urls = cls.run_command(['info'], show_stdout=False, cwd=location)
+        for line in urls.splitlines():
+            line = line.strip()
+            for x in ('checkout of branch: ',
+                      'parent branch: '):
+                if line.startswith(x):
+                    repo = line.split(x)[1]
+                    if cls._is_local_repository(repo):
+                        return path_to_url(repo)
+                    return repo
+        return None
+
+    @classmethod
+    def get_revision(cls, location):
+        revision = cls.run_command(
+            ['revno'], show_stdout=False, cwd=location,
+        )
+        return revision.splitlines()[-1]
+
+    @classmethod
+    def is_commit_id_equal(cls, dest, name):
+        """Always assume the versions don't match"""
+        return False
+
+
+vcs.register(Bazaar)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py
new file mode 100644
index 0000000000000000000000000000000000000000..7483303a94badbfb44d6565775804e27dc7d1030
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/git.py
@@ -0,0 +1,389 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os.path
+import re
+
+from pip._vendor.packaging.version import parse as parse_version
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+from pip._vendor.six.moves.urllib import request as urllib_request
+
+from pip._internal.exceptions import BadCommand
+from pip._internal.utils.misc import display_path, hide_url
+from pip._internal.utils.subprocess import make_command
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.vcs.versioncontrol import (
+    RemoteNotFoundError,
+    VersionControl,
+    find_path_to_setup_from_repo_root,
+    vcs,
+)
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Tuple
+    from pip._internal.utils.misc import HiddenText
+    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions
+
+
+urlsplit = urllib_parse.urlsplit
+urlunsplit = urllib_parse.urlunsplit
+
+
+logger = logging.getLogger(__name__)
+
+
+HASH_REGEX = re.compile('^[a-fA-F0-9]{40}$')
+
+
+def looks_like_hash(sha):
+    return bool(HASH_REGEX.match(sha))
+
+
+class Git(VersionControl):
+    name = 'git'
+    dirname = '.git'
+    repo_name = 'clone'
+    schemes = (
+        'git', 'git+http', 'git+https', 'git+ssh', 'git+git', 'git+file',
+    )
+    # Prevent the user's environment variables from interfering with pip:
+    # https://github.com/pypa/pip/issues/1130
+    unset_environ = ('GIT_DIR', 'GIT_WORK_TREE')
+    default_arg_rev = 'HEAD'
+
+    @staticmethod
+    def get_base_rev_args(rev):
+        return [rev]
+
+    def is_immutable_rev_checkout(self, url, dest):
+        # type: (str, str) -> bool
+        _, rev_options = self.get_url_rev_options(hide_url(url))
+        if not rev_options.rev:
+            return False
+        if not self.is_commit_id_equal(dest, rev_options.rev):
+            # the current commit is different from rev,
+            # which means rev was something else than a commit hash
+            return False
+        # return False in the rare case rev is both a commit hash
+        # and a tag or a branch; we don't want to cache in that case
+        # because that branch/tag could point to something else in the future
+        is_tag_or_branch = bool(
+            self.get_revision_sha(dest, rev_options.rev)[0]
+        )
+        return not is_tag_or_branch
+
+    def get_git_version(self):
+        VERSION_PFX = 'git version '
+        version = self.run_command(['version'], show_stdout=False)
+        if version.startswith(VERSION_PFX):
+            version = version[len(VERSION_PFX):].split()[0]
+        else:
+            version = ''
+        # get first 3 positions of the git version because
+        # on windows it is x.y.z.windows.t, and this parses as
+        # LegacyVersion which always smaller than a Version.
+        version = '.'.join(version.split('.')[:3])
+        return parse_version(version)
+
+    @classmethod
+    def get_current_branch(cls, location):
+        """
+        Return the current branch, or None if HEAD isn't at a branch
+        (e.g. detached HEAD).
+        """
+        # git-symbolic-ref exits with empty stdout if "HEAD" is a detached
+        # HEAD rather than a symbolic ref.  In addition, the -q causes the
+        # command to exit with status code 1 instead of 128 in this case
+        # and to suppress the message to stderr.
+        args = ['symbolic-ref', '-q', 'HEAD']
+        output = cls.run_command(
+            args, extra_ok_returncodes=(1, ), show_stdout=False, cwd=location,
+        )
+        ref = output.strip()
+
+        if ref.startswith('refs/heads/'):
+            return ref[len('refs/heads/'):]
+
+        return None
+
+    def export(self, location, url):
+        # type: (str, HiddenText) -> None
+        """Export the Git repository at the url to the destination location"""
+        if not location.endswith('/'):
+            location = location + '/'
+
+        with TempDirectory(kind="export") as temp_dir:
+            self.unpack(temp_dir.path, url=url)
+            self.run_command(
+                ['checkout-index', '-a', '-f', '--prefix', location],
+                show_stdout=False, cwd=temp_dir.path
+            )
+
+    @classmethod
+    def get_revision_sha(cls, dest, rev):
+        """
+        Return (sha_or_none, is_branch), where sha_or_none is a commit hash
+        if the revision names a remote branch or tag, otherwise None.
+
+        Args:
+          dest: the repository directory.
+          rev: the revision name.
+        """
+        # Pass rev to pre-filter the list.
+        output = cls.run_command(['show-ref', rev], cwd=dest,
+                                 show_stdout=False, on_returncode='ignore')
+        refs = {}
+        for line in output.strip().splitlines():
+            try:
+                sha, ref = line.split()
+            except ValueError:
+                # Include the offending line to simplify troubleshooting if
+                # this error ever occurs.
+                raise ValueError('unexpected show-ref line: {!r}'.format(line))
+
+            refs[ref] = sha
+
+        branch_ref = 'refs/remotes/origin/{}'.format(rev)
+        tag_ref = 'refs/tags/{}'.format(rev)
+
+        sha = refs.get(branch_ref)
+        if sha is not None:
+            return (sha, True)
+
+        sha = refs.get(tag_ref)
+
+        return (sha, False)
+
+    @classmethod
+    def resolve_revision(cls, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> RevOptions
+        """
+        Resolve a revision to a new RevOptions object with the SHA1 of the
+        branch, tag, or ref if found.
+
+        Args:
+          rev_options: a RevOptions object.
+        """
+        rev = rev_options.arg_rev
+        # The arg_rev property's implementation for Git ensures that the
+        # rev return value is always non-None.
+        assert rev is not None
+
+        sha, is_branch = cls.get_revision_sha(dest, rev)
+
+        if sha is not None:
+            rev_options = rev_options.make_new(sha)
+            rev_options.branch_name = rev if is_branch else None
+
+            return rev_options
+
+        # Do not show a warning for the common case of something that has
+        # the form of a Git commit hash.
+        if not looks_like_hash(rev):
+            logger.warning(
+                "Did not find branch or tag '%s', assuming revision or ref.",
+                rev,
+            )
+
+        if not rev.startswith('refs/'):
+            return rev_options
+
+        # If it looks like a ref, we have to fetch it explicitly.
+        cls.run_command(
+            make_command('fetch', '-q', url, rev_options.to_args()),
+            cwd=dest,
+        )
+        # Change the revision to the SHA of the ref we fetched
+        sha = cls.get_revision(dest, rev='FETCH_HEAD')
+        rev_options = rev_options.make_new(sha)
+
+        return rev_options
+
+    @classmethod
+    def is_commit_id_equal(cls, dest, name):
+        """
+        Return whether the current commit hash equals the given name.
+
+        Args:
+          dest: the repository directory.
+          name: a string name.
+        """
+        if not name:
+            # Then avoid an unnecessary subprocess call.
+            return False
+
+        return cls.get_revision(dest) == name
+
+    def fetch_new(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        rev_display = rev_options.to_display()
+        logger.info('Cloning %s%s to %s', url, rev_display, display_path(dest))
+        self.run_command(make_command('clone', '-q', url, dest))
+
+        if rev_options.rev:
+            # Then a specific revision was requested.
+            rev_options = self.resolve_revision(dest, url, rev_options)
+            branch_name = getattr(rev_options, 'branch_name', None)
+            if branch_name is None:
+                # Only do a checkout if the current commit id doesn't match
+                # the requested revision.
+                if not self.is_commit_id_equal(dest, rev_options.rev):
+                    cmd_args = make_command(
+                        'checkout', '-q', rev_options.to_args(),
+                    )
+                    self.run_command(cmd_args, cwd=dest)
+            elif self.get_current_branch(dest) != branch_name:
+                # Then a specific branch was requested, and that branch
+                # is not yet checked out.
+                track_branch = 'origin/{}'.format(branch_name)
+                cmd_args = [
+                    'checkout', '-b', branch_name, '--track', track_branch,
+                ]
+                self.run_command(cmd_args, cwd=dest)
+
+        #: repo may contain submodules
+        self.update_submodules(dest)
+
+    def switch(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        self.run_command(
+            make_command('config', 'remote.origin.url', url),
+            cwd=dest,
+        )
+        cmd_args = make_command('checkout', '-q', rev_options.to_args())
+        self.run_command(cmd_args, cwd=dest)
+
+        self.update_submodules(dest)
+
+    def update(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        # First fetch changes from the default remote
+        if self.get_git_version() >= parse_version('1.9.0'):
+            # fetch tags in addition to everything else
+            self.run_command(['fetch', '-q', '--tags'], cwd=dest)
+        else:
+            self.run_command(['fetch', '-q'], cwd=dest)
+        # Then reset to wanted revision (maybe even origin/master)
+        rev_options = self.resolve_revision(dest, url, rev_options)
+        cmd_args = make_command('reset', '--hard', '-q', rev_options.to_args())
+        self.run_command(cmd_args, cwd=dest)
+        #: update submodules
+        self.update_submodules(dest)
+
+    @classmethod
+    def get_remote_url(cls, location):
+        """
+        Return URL of the first remote encountered.
+
+        Raises RemoteNotFoundError if the repository does not have a remote
+        url configured.
+        """
+        # We need to pass 1 for extra_ok_returncodes since the command
+        # exits with return code 1 if there are no matching lines.
+        stdout = cls.run_command(
+            ['config', '--get-regexp', r'remote\..*\.url'],
+            extra_ok_returncodes=(1, ), show_stdout=False, cwd=location,
+        )
+        remotes = stdout.splitlines()
+        try:
+            found_remote = remotes[0]
+        except IndexError:
+            raise RemoteNotFoundError
+
+        for remote in remotes:
+            if remote.startswith('remote.origin.url '):
+                found_remote = remote
+                break
+        url = found_remote.split(' ')[1]
+        return url.strip()
+
+    @classmethod
+    def get_revision(cls, location, rev=None):
+        if rev is None:
+            rev = 'HEAD'
+        current_rev = cls.run_command(
+            ['rev-parse', rev], show_stdout=False, cwd=location,
+        )
+        return current_rev.strip()
+
+    @classmethod
+    def get_subdirectory(cls, location):
+        """
+        Return the path to setup.py, relative to the repo root.
+        Return None if setup.py is in the repo root.
+        """
+        # find the repo root
+        git_dir = cls.run_command(
+            ['rev-parse', '--git-dir'],
+            show_stdout=False, cwd=location).strip()
+        if not os.path.isabs(git_dir):
+            git_dir = os.path.join(location, git_dir)
+        repo_root = os.path.abspath(os.path.join(git_dir, '..'))
+        return find_path_to_setup_from_repo_root(location, repo_root)
+
+    @classmethod
+    def get_url_rev_and_auth(cls, url):
+        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
+        """
+        Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'.
+        That's required because although they use SSH they sometimes don't
+        work with a ssh:// scheme (e.g. GitHub). But we need a scheme for
+        parsing. Hence we remove it again afterwards and return it as a stub.
+        """
+        # Works around an apparent Git bug
+        # (see https://article.gmane.org/gmane.comp.version-control.git/146500)
+        scheme, netloc, path, query, fragment = urlsplit(url)
+        if scheme.endswith('file'):
+            initial_slashes = path[:-len(path.lstrip('/'))]
+            newpath = (
+                initial_slashes +
+                urllib_request.url2pathname(path)
+                .replace('\\', '/').lstrip('/')
+            )
+            url = urlunsplit((scheme, netloc, newpath, query, fragment))
+            after_plus = scheme.find('+') + 1
+            url = scheme[:after_plus] + urlunsplit(
+                (scheme[after_plus:], netloc, newpath, query, fragment),
+            )
+
+        if '://' not in url:
+            assert 'file:' not in url
+            url = url.replace('git+', 'git+ssh://')
+            url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url)
+            url = url.replace('ssh://', '')
+        else:
+            url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url)
+
+        return url, rev, user_pass
+
+    @classmethod
+    def update_submodules(cls, location):
+        if not os.path.exists(os.path.join(location, '.gitmodules')):
+            return
+        cls.run_command(
+            ['submodule', 'update', '--init', '--recursive', '-q'],
+            cwd=location,
+        )
+
+    @classmethod
+    def controls_location(cls, location):
+        if super(Git, cls).controls_location(location):
+            return True
+        try:
+            r = cls.run_command(['rev-parse'],
+                                cwd=location,
+                                show_stdout=False,
+                                on_returncode='ignore',
+                                log_failed_cmd=False)
+            return not r
+        except BadCommand:
+            logger.debug("could not determine if %s is under git control "
+                         "because git is not available", location)
+            return False
+
+
+vcs.register(Git)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9b58cfe9a4b7a437e0899945243f7e9be5215e9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py
@@ -0,0 +1,155 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+
+from pip._vendor.six.moves import configparser
+
+from pip._internal.exceptions import BadCommand, InstallationError
+from pip._internal.utils.misc import display_path
+from pip._internal.utils.subprocess import make_command
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url
+from pip._internal.vcs.versioncontrol import (
+    VersionControl,
+    find_path_to_setup_from_repo_root,
+    vcs,
+)
+
+if MYPY_CHECK_RUNNING:
+    from pip._internal.utils.misc import HiddenText
+    from pip._internal.vcs.versioncontrol import RevOptions
+
+
+logger = logging.getLogger(__name__)
+
+
+class Mercurial(VersionControl):
+    name = 'hg'
+    dirname = '.hg'
+    repo_name = 'clone'
+    schemes = (
+        'hg', 'hg+file', 'hg+http', 'hg+https', 'hg+ssh', 'hg+static-http',
+    )
+
+    @staticmethod
+    def get_base_rev_args(rev):
+        return [rev]
+
+    def export(self, location, url):
+        # type: (str, HiddenText) -> None
+        """Export the Hg repository at the url to the destination location"""
+        with TempDirectory(kind="export") as temp_dir:
+            self.unpack(temp_dir.path, url=url)
+
+            self.run_command(
+                ['archive', location], show_stdout=False, cwd=temp_dir.path
+            )
+
+    def fetch_new(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        rev_display = rev_options.to_display()
+        logger.info(
+            'Cloning hg %s%s to %s',
+            url,
+            rev_display,
+            display_path(dest),
+        )
+        self.run_command(make_command('clone', '--noupdate', '-q', url, dest))
+        self.run_command(
+            make_command('update', '-q', rev_options.to_args()),
+            cwd=dest,
+        )
+
+    def switch(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        repo_config = os.path.join(dest, self.dirname, 'hgrc')
+        config = configparser.RawConfigParser()
+        try:
+            config.read(repo_config)
+            config.set('paths', 'default', url.secret)
+            with open(repo_config, 'w') as config_file:
+                config.write(config_file)
+        except (OSError, configparser.NoSectionError) as exc:
+            logger.warning(
+                'Could not switch Mercurial repository to %s: %s', url, exc,
+            )
+        else:
+            cmd_args = make_command('update', '-q', rev_options.to_args())
+            self.run_command(cmd_args, cwd=dest)
+
+    def update(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        self.run_command(['pull', '-q'], cwd=dest)
+        cmd_args = make_command('update', '-q', rev_options.to_args())
+        self.run_command(cmd_args, cwd=dest)
+
+    @classmethod
+    def get_remote_url(cls, location):
+        url = cls.run_command(
+            ['showconfig', 'paths.default'],
+            show_stdout=False, cwd=location).strip()
+        if cls._is_local_repository(url):
+            url = path_to_url(url)
+        return url.strip()
+
+    @classmethod
+    def get_revision(cls, location):
+        """
+        Return the repository-local changeset revision number, as an integer.
+        """
+        current_revision = cls.run_command(
+            ['parents', '--template={rev}'],
+            show_stdout=False, cwd=location).strip()
+        return current_revision
+
+    @classmethod
+    def get_requirement_revision(cls, location):
+        """
+        Return the changeset identification hash, as a 40-character
+        hexadecimal string
+        """
+        current_rev_hash = cls.run_command(
+            ['parents', '--template={node}'],
+            show_stdout=False, cwd=location).strip()
+        return current_rev_hash
+
+    @classmethod
+    def is_commit_id_equal(cls, dest, name):
+        """Always assume the versions don't match"""
+        return False
+
+    @classmethod
+    def get_subdirectory(cls, location):
+        """
+        Return the path to setup.py, relative to the repo root.
+        Return None if setup.py is in the repo root.
+        """
+        # find the repo root
+        repo_root = cls.run_command(
+            ['root'], show_stdout=False, cwd=location).strip()
+        if not os.path.isabs(repo_root):
+            repo_root = os.path.abspath(os.path.join(location, repo_root))
+        return find_path_to_setup_from_repo_root(location, repo_root)
+
+    @classmethod
+    def controls_location(cls, location):
+        if super(Mercurial, cls).controls_location(location):
+            return True
+        try:
+            cls.run_command(
+                ['identify'],
+                cwd=location,
+                show_stdout=False,
+                on_returncode='raise',
+                log_failed_cmd=False)
+            return True
+        except (BadCommand, InstallationError):
+            return False
+
+
+vcs.register(Mercurial)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py
new file mode 100644
index 0000000000000000000000000000000000000000..6c76d1ad435ab4718c95a09aafa8a8e69a996452
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py
@@ -0,0 +1,333 @@
+# The following comment should be removed at some point in the future.
+# mypy: disallow-untyped-defs=False
+
+from __future__ import absolute_import
+
+import logging
+import os
+import re
+
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import (
+    display_path,
+    is_console_interactive,
+    rmtree,
+    split_auth_from_netloc,
+)
+from pip._internal.utils.subprocess import make_command
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.vcs.versioncontrol import VersionControl, vcs
+
+_svn_xml_url_re = re.compile('url="([^"]+)"')
+_svn_rev_re = re.compile(r'committed-rev="(\d+)"')
+_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"')
+_svn_info_xml_url_re = re.compile(r'<url>(.*)</url>')
+
+
+if MYPY_CHECK_RUNNING:
+    from typing import Optional, Tuple
+    from pip._internal.utils.subprocess import CommandArgs
+    from pip._internal.utils.misc import HiddenText
+    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions
+
+
+logger = logging.getLogger(__name__)
+
+
+class Subversion(VersionControl):
+    name = 'svn'
+    dirname = '.svn'
+    repo_name = 'checkout'
+    schemes = ('svn', 'svn+ssh', 'svn+http', 'svn+https', 'svn+svn')
+
+    @classmethod
+    def should_add_vcs_url_prefix(cls, remote_url):
+        return True
+
+    @staticmethod
+    def get_base_rev_args(rev):
+        return ['-r', rev]
+
+    @classmethod
+    def get_revision(cls, location):
+        """
+        Return the maximum revision for all files under a given location
+        """
+        # Note: taken from setuptools.command.egg_info
+        revision = 0
+
+        for base, dirs, files in os.walk(location):
+            if cls.dirname not in dirs:
+                dirs[:] = []
+                continue    # no sense walking uncontrolled subdirs
+            dirs.remove(cls.dirname)
+            entries_fn = os.path.join(base, cls.dirname, 'entries')
+            if not os.path.exists(entries_fn):
+                # FIXME: should we warn?
+                continue
+
+            dirurl, localrev = cls._get_svn_url_rev(base)
+
+            if base == location:
+                base = dirurl + '/'   # save the root url
+            elif not dirurl or not dirurl.startswith(base):
+                dirs[:] = []
+                continue    # not part of the same svn tree, skip it
+            revision = max(revision, localrev)
+        return revision
+
+    @classmethod
+    def get_netloc_and_auth(cls, netloc, scheme):
+        """
+        This override allows the auth information to be passed to svn via the
+        --username and --password options instead of via the URL.
+        """
+        if scheme == 'ssh':
+            # The --username and --password options can't be used for
+            # svn+ssh URLs, so keep the auth information in the URL.
+            return super(Subversion, cls).get_netloc_and_auth(netloc, scheme)
+
+        return split_auth_from_netloc(netloc)
+
+    @classmethod
+    def get_url_rev_and_auth(cls, url):
+        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
+        # hotfix the URL scheme after removing svn+ from svn+ssh:// readd it
+        url, rev, user_pass = super(Subversion, cls).get_url_rev_and_auth(url)
+        if url.startswith('ssh://'):
+            url = 'svn+' + url
+        return url, rev, user_pass
+
+    @staticmethod
+    def make_rev_args(username, password):
+        # type: (Optional[str], Optional[HiddenText]) -> CommandArgs
+        extra_args = []  # type: CommandArgs
+        if username:
+            extra_args += ['--username', username]
+        if password:
+            extra_args += ['--password', password]
+
+        return extra_args
+
+    @classmethod
+    def get_remote_url(cls, location):
+        # In cases where the source is in a subdirectory, not alongside
+        # setup.py we have to look up in the location until we find a real
+        # setup.py
+        orig_location = location
+        while not os.path.exists(os.path.join(location, 'setup.py')):
+            last_location = location
+            location = os.path.dirname(location)
+            if location == last_location:
+                # We've traversed up to the root of the filesystem without
+                # finding setup.py
+                logger.warning(
+                    "Could not find setup.py for directory %s (tried all "
+                    "parent directories)",
+                    orig_location,
+                )
+                return None
+
+        return cls._get_svn_url_rev(location)[0]
+
+    @classmethod
+    def _get_svn_url_rev(cls, location):
+        from pip._internal.exceptions import InstallationError
+
+        entries_path = os.path.join(location, cls.dirname, 'entries')
+        if os.path.exists(entries_path):
+            with open(entries_path) as f:
+                data = f.read()
+        else:  # subversion >= 1.7 does not have the 'entries' file
+            data = ''
+
+        if (data.startswith('8') or
+                data.startswith('9') or
+                data.startswith('10')):
+            data = list(map(str.splitlines, data.split('\n\x0c\n')))
+            del data[0][0]  # get rid of the '8'
+            url = data[0][3]
+            revs = [int(d[9]) for d in data if len(d) > 9 and d[9]] + [0]
+        elif data.startswith('<?xml'):
+            match = _svn_xml_url_re.search(data)
+            if not match:
+                raise ValueError('Badly formatted data: %r' % data)
+            url = match.group(1)    # get repository URL
+            revs = [int(m.group(1)) for m in _svn_rev_re.finditer(data)] + [0]
+        else:
+            try:
+                # subversion >= 1.7
+                # Note that using get_remote_call_options is not necessary here
+                # because `svn info` is being run against a local directory.
+                # We don't need to worry about making sure interactive mode
+                # is being used to prompt for passwords, because passwords
+                # are only potentially needed for remote server requests.
+                xml = cls.run_command(
+                    ['info', '--xml', location],
+                    show_stdout=False,
+                )
+                url = _svn_info_xml_url_re.search(xml).group(1)
+                revs = [
+                    int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml)
+                ]
+            except InstallationError:
+                url, revs = None, []
+
+        if revs:
+            rev = max(revs)
+        else:
+            rev = 0
+
+        return url, rev
+
+    @classmethod
+    def is_commit_id_equal(cls, dest, name):
+        """Always assume the versions don't match"""
+        return False
+
+    def __init__(self, use_interactive=None):
+        # type: (bool) -> None
+        if use_interactive is None:
+            use_interactive = is_console_interactive()
+        self.use_interactive = use_interactive
+
+        # This member is used to cache the fetched version of the current
+        # ``svn`` client.
+        # Special value definitions:
+        #   None: Not evaluated yet.
+        #   Empty tuple: Could not parse version.
+        self._vcs_version = None  # type: Optional[Tuple[int, ...]]
+
+        super(Subversion, self).__init__()
+
+    def call_vcs_version(self):
+        # type: () -> Tuple[int, ...]
+        """Query the version of the currently installed Subversion client.
+
+        :return: A tuple containing the parts of the version information or
+            ``()`` if the version returned from ``svn`` could not be parsed.
+        :raises: BadCommand: If ``svn`` is not installed.
+        """
+        # Example versions:
+        #   svn, version 1.10.3 (r1842928)
+        #      compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0
+        #   svn, version 1.7.14 (r1542130)
+        #      compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu
+        version_prefix = 'svn, version '
+        version = self.run_command(['--version'], show_stdout=False)
+        if not version.startswith(version_prefix):
+            return ()
+
+        version = version[len(version_prefix):].split()[0]
+        version_list = version.split('.')
+        try:
+            parsed_version = tuple(map(int, version_list))
+        except ValueError:
+            return ()
+
+        return parsed_version
+
+    def get_vcs_version(self):
+        # type: () -> Tuple[int, ...]
+        """Return the version of the currently installed Subversion client.
+
+        If the version of the Subversion client has already been queried,
+        a cached value will be used.
+
+        :return: A tuple containing the parts of the version information or
+            ``()`` if the version returned from ``svn`` could not be parsed.
+        :raises: BadCommand: If ``svn`` is not installed.
+        """
+        if self._vcs_version is not None:
+            # Use cached version, if available.
+            # If parsing the version failed previously (empty tuple),
+            # do not attempt to parse it again.
+            return self._vcs_version
+
+        vcs_version = self.call_vcs_version()
+        self._vcs_version = vcs_version
+        return vcs_version
+
+    def get_remote_call_options(self):
+        # type: () -> CommandArgs
+        """Return options to be used on calls to Subversion that contact the server.
+
+        These options are applicable for the following ``svn`` subcommands used
+        in this class.
+
+            - checkout
+            - export
+            - switch
+            - update
+
+        :return: A list of command line arguments to pass to ``svn``.
+        """
+        if not self.use_interactive:
+            # --non-interactive switch is available since Subversion 0.14.4.
+            # Subversion < 1.8 runs in interactive mode by default.
+            return ['--non-interactive']
+
+        svn_version = self.get_vcs_version()
+        # By default, Subversion >= 1.8 runs in non-interactive mode if
+        # stdin is not a TTY. Since that is how pip invokes SVN, in
+        # call_subprocess(), pip must pass --force-interactive to ensure
+        # the user can be prompted for a password, if required.
+        #   SVN added the --force-interactive option in SVN 1.8. Since
+        # e.g. RHEL/CentOS 7, which is supported until 2024, ships with
+        # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip
+        # can't safely add the option if the SVN version is < 1.8 (or unknown).
+        if svn_version >= (1, 8):
+            return ['--force-interactive']
+
+        return []
+
+    def export(self, location, url):
+        # type: (str, HiddenText) -> None
+        """Export the svn repository at the url to the destination location"""
+        url, rev_options = self.get_url_rev_options(url)
+
+        logger.info('Exporting svn repository %s to %s', url, location)
+        with indent_log():
+            if os.path.exists(location):
+                # Subversion doesn't like to check out over an existing
+                # directory --force fixes this, but was only added in svn 1.5
+                rmtree(location)
+            cmd_args = make_command(
+                'export', self.get_remote_call_options(),
+                rev_options.to_args(), url, location,
+            )
+            self.run_command(cmd_args, show_stdout=False)
+
+    def fetch_new(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        rev_display = rev_options.to_display()
+        logger.info(
+            'Checking out %s%s to %s',
+            url,
+            rev_display,
+            display_path(dest),
+        )
+        cmd_args = make_command(
+            'checkout', '-q', self.get_remote_call_options(),
+            rev_options.to_args(), url, dest,
+        )
+        self.run_command(cmd_args)
+
+    def switch(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        cmd_args = make_command(
+            'switch', self.get_remote_call_options(), rev_options.to_args(),
+            url, dest,
+        )
+        self.run_command(cmd_args)
+
+    def update(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        cmd_args = make_command(
+            'update', self.get_remote_call_options(), rev_options.to_args(),
+            dest,
+        )
+        self.run_command(cmd_args)
+
+
+vcs.register(Subversion)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py
new file mode 100644
index 0000000000000000000000000000000000000000..7cfd568829f27f188cf7a3cec86c3c840b8463cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py
@@ -0,0 +1,700 @@
+"""Handles all VCS (version control) support"""
+
+from __future__ import absolute_import
+
+import errno
+import logging
+import os
+import shutil
+import sys
+
+from pip._vendor import pkg_resources
+from pip._vendor.six.moves.urllib import parse as urllib_parse
+
+from pip._internal.exceptions import BadCommand
+from pip._internal.utils.compat import samefile
+from pip._internal.utils.misc import (
+    ask_path_exists,
+    backup_dir,
+    display_path,
+    hide_url,
+    hide_value,
+    rmtree,
+)
+from pip._internal.utils.subprocess import call_subprocess, make_command
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import get_url_scheme
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Dict, Iterable, Iterator, List, Mapping, Optional, Text, Tuple,
+        Type, Union
+    )
+    from pip._internal.utils.ui import SpinnerInterface
+    from pip._internal.utils.misc import HiddenText
+    from pip._internal.utils.subprocess import CommandArgs
+
+    AuthInfo = Tuple[Optional[str], Optional[str]]
+
+
+__all__ = ['vcs']
+
+
+logger = logging.getLogger(__name__)
+
+
+def is_url(name):
+    # type: (Union[str, Text]) -> bool
+    """
+    Return true if the name looks like a URL.
+    """
+    scheme = get_url_scheme(name)
+    if scheme is None:
+        return False
+    return scheme in ['http', 'https', 'file', 'ftp'] + vcs.all_schemes
+
+
+def make_vcs_requirement_url(repo_url, rev, project_name, subdir=None):
+    # type: (str, str, str, Optional[str]) -> str
+    """
+    Return the URL for a VCS requirement.
+
+    Args:
+      repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+").
+      project_name: the (unescaped) project name.
+    """
+    egg_project_name = pkg_resources.to_filename(project_name)
+    req = '{}@{}#egg={}'.format(repo_url, rev, egg_project_name)
+    if subdir:
+        req += '&subdirectory={}'.format(subdir)
+
+    return req
+
+
+def find_path_to_setup_from_repo_root(location, repo_root):
+    # type: (str, str) -> Optional[str]
+    """
+    Find the path to `setup.py` by searching up the filesystem from `location`.
+    Return the path to `setup.py` relative to `repo_root`.
+    Return None if `setup.py` is in `repo_root` or cannot be found.
+    """
+    # find setup.py
+    orig_location = location
+    while not os.path.exists(os.path.join(location, 'setup.py')):
+        last_location = location
+        location = os.path.dirname(location)
+        if location == last_location:
+            # We've traversed up to the root of the filesystem without
+            # finding setup.py
+            logger.warning(
+                "Could not find setup.py for directory %s (tried all "
+                "parent directories)",
+                orig_location,
+            )
+            return None
+
+    if samefile(repo_root, location):
+        return None
+
+    return os.path.relpath(location, repo_root)
+
+
+class RemoteNotFoundError(Exception):
+    pass
+
+
+class RevOptions(object):
+
+    """
+    Encapsulates a VCS-specific revision to install, along with any VCS
+    install options.
+
+    Instances of this class should be treated as if immutable.
+    """
+
+    def __init__(
+        self,
+        vc_class,  # type: Type[VersionControl]
+        rev=None,  # type: Optional[str]
+        extra_args=None,  # type: Optional[CommandArgs]
+    ):
+        # type: (...) -> None
+        """
+        Args:
+          vc_class: a VersionControl subclass.
+          rev: the name of the revision to install.
+          extra_args: a list of extra options.
+        """
+        if extra_args is None:
+            extra_args = []
+
+        self.extra_args = extra_args
+        self.rev = rev
+        self.vc_class = vc_class
+        self.branch_name = None  # type: Optional[str]
+
+    def __repr__(self):
+        # type: () -> str
+        return '<RevOptions {}: rev={!r}>'.format(self.vc_class.name, self.rev)
+
+    @property
+    def arg_rev(self):
+        # type: () -> Optional[str]
+        if self.rev is None:
+            return self.vc_class.default_arg_rev
+
+        return self.rev
+
+    def to_args(self):
+        # type: () -> CommandArgs
+        """
+        Return the VCS-specific command arguments.
+        """
+        args = []  # type: CommandArgs
+        rev = self.arg_rev
+        if rev is not None:
+            args += self.vc_class.get_base_rev_args(rev)
+        args += self.extra_args
+
+        return args
+
+    def to_display(self):
+        # type: () -> str
+        if not self.rev:
+            return ''
+
+        return ' (to revision {})'.format(self.rev)
+
+    def make_new(self, rev):
+        # type: (str) -> RevOptions
+        """
+        Make a copy of the current instance, but with a new rev.
+
+        Args:
+          rev: the name of the revision for the new object.
+        """
+        return self.vc_class.make_rev_options(rev, extra_args=self.extra_args)
+
+
+class VcsSupport(object):
+    _registry = {}  # type: Dict[str, VersionControl]
+    schemes = ['ssh', 'git', 'hg', 'bzr', 'sftp', 'svn']
+
+    def __init__(self):
+        # type: () -> None
+        # Register more schemes with urlparse for various version control
+        # systems
+        urllib_parse.uses_netloc.extend(self.schemes)
+        # Python >= 2.7.4, 3.3 doesn't have uses_fragment
+        if getattr(urllib_parse, 'uses_fragment', None):
+            urllib_parse.uses_fragment.extend(self.schemes)
+        super(VcsSupport, self).__init__()
+
+    def __iter__(self):
+        # type: () -> Iterator[str]
+        return self._registry.__iter__()
+
+    @property
+    def backends(self):
+        # type: () -> List[VersionControl]
+        return list(self._registry.values())
+
+    @property
+    def dirnames(self):
+        # type: () -> List[str]
+        return [backend.dirname for backend in self.backends]
+
+    @property
+    def all_schemes(self):
+        # type: () -> List[str]
+        schemes = []  # type: List[str]
+        for backend in self.backends:
+            schemes.extend(backend.schemes)
+        return schemes
+
+    def register(self, cls):
+        # type: (Type[VersionControl]) -> None
+        if not hasattr(cls, 'name'):
+            logger.warning('Cannot register VCS %s', cls.__name__)
+            return
+        if cls.name not in self._registry:
+            self._registry[cls.name] = cls()
+            logger.debug('Registered VCS backend: %s', cls.name)
+
+    def unregister(self, name):
+        # type: (str) -> None
+        if name in self._registry:
+            del self._registry[name]
+
+    def get_backend_for_dir(self, location):
+        # type: (str) -> Optional[VersionControl]
+        """
+        Return a VersionControl object if a repository of that type is found
+        at the given directory.
+        """
+        for vcs_backend in self._registry.values():
+            if vcs_backend.controls_location(location):
+                logger.debug('Determine that %s uses VCS: %s',
+                             location, vcs_backend.name)
+                return vcs_backend
+        return None
+
+    def get_backend_for_scheme(self, scheme):
+        # type: (str) -> Optional[VersionControl]
+        """
+        Return a VersionControl object or None.
+        """
+        for vcs_backend in self._registry.values():
+            if scheme in vcs_backend.schemes:
+                return vcs_backend
+        return None
+
+    def get_backend(self, name):
+        # type: (str) -> Optional[VersionControl]
+        """
+        Return a VersionControl object or None.
+        """
+        name = name.lower()
+        return self._registry.get(name)
+
+
+vcs = VcsSupport()
+
+
+class VersionControl(object):
+    name = ''
+    dirname = ''
+    repo_name = ''
+    # List of supported schemes for this Version Control
+    schemes = ()  # type: Tuple[str, ...]
+    # Iterable of environment variable names to pass to call_subprocess().
+    unset_environ = ()  # type: Tuple[str, ...]
+    default_arg_rev = None  # type: Optional[str]
+
+    @classmethod
+    def should_add_vcs_url_prefix(cls, remote_url):
+        # type: (str) -> bool
+        """
+        Return whether the vcs prefix (e.g. "git+") should be added to a
+        repository's remote url when used in a requirement.
+        """
+        return not remote_url.lower().startswith('{}:'.format(cls.name))
+
+    @classmethod
+    def get_subdirectory(cls, location):
+        # type: (str) -> Optional[str]
+        """
+        Return the path to setup.py, relative to the repo root.
+        Return None if setup.py is in the repo root.
+        """
+        return None
+
+    @classmethod
+    def get_requirement_revision(cls, repo_dir):
+        # type: (str) -> str
+        """
+        Return the revision string that should be used in a requirement.
+        """
+        return cls.get_revision(repo_dir)
+
+    @classmethod
+    def get_src_requirement(cls, repo_dir, project_name):
+        # type: (str, str) -> Optional[str]
+        """
+        Return the requirement string to use to redownload the files
+        currently at the given repository directory.
+
+        Args:
+          project_name: the (unescaped) project name.
+
+        The return value has a form similar to the following:
+
+            {repository_url}@{revision}#egg={project_name}
+        """
+        repo_url = cls.get_remote_url(repo_dir)
+        if repo_url is None:
+            return None
+
+        if cls.should_add_vcs_url_prefix(repo_url):
+            repo_url = '{}+{}'.format(cls.name, repo_url)
+
+        revision = cls.get_requirement_revision(repo_dir)
+        subdir = cls.get_subdirectory(repo_dir)
+        req = make_vcs_requirement_url(repo_url, revision, project_name,
+                                       subdir=subdir)
+
+        return req
+
+    @staticmethod
+    def get_base_rev_args(rev):
+        # type: (str) -> List[str]
+        """
+        Return the base revision arguments for a vcs command.
+
+        Args:
+          rev: the name of a revision to install.  Cannot be None.
+        """
+        raise NotImplementedError
+
+    def is_immutable_rev_checkout(self, url, dest):
+        # type: (str, str) -> bool
+        """
+        Return true if the commit hash checked out at dest matches
+        the revision in url.
+
+        Always return False, if the VCS does not support immutable commit
+        hashes.
+
+        This method does not check if there are local uncommitted changes
+        in dest after checkout, as pip currently has no use case for that.
+        """
+        return False
+
+    @classmethod
+    def make_rev_options(cls, rev=None, extra_args=None):
+        # type: (Optional[str], Optional[CommandArgs]) -> RevOptions
+        """
+        Return a RevOptions object.
+
+        Args:
+          rev: the name of a revision to install.
+          extra_args: a list of extra options.
+        """
+        return RevOptions(cls, rev, extra_args=extra_args)
+
+    @classmethod
+    def _is_local_repository(cls, repo):
+        # type: (str) -> bool
+        """
+           posix absolute paths start with os.path.sep,
+           win32 ones start with drive (like c:\\folder)
+        """
+        drive, tail = os.path.splitdrive(repo)
+        return repo.startswith(os.path.sep) or bool(drive)
+
+    def export(self, location, url):
+        # type: (str, HiddenText) -> None
+        """
+        Export the repository at the url to the destination location
+        i.e. only download the files, without vcs informations
+
+        :param url: the repository URL starting with a vcs prefix.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def get_netloc_and_auth(cls, netloc, scheme):
+        # type: (str, str) -> Tuple[str, Tuple[Optional[str], Optional[str]]]
+        """
+        Parse the repository URL's netloc, and return the new netloc to use
+        along with auth information.
+
+        Args:
+          netloc: the original repository URL netloc.
+          scheme: the repository URL's scheme without the vcs prefix.
+
+        This is mainly for the Subversion class to override, so that auth
+        information can be provided via the --username and --password options
+        instead of through the URL.  For other subclasses like Git without
+        such an option, auth information must stay in the URL.
+
+        Returns: (netloc, (username, password)).
+        """
+        return netloc, (None, None)
+
+    @classmethod
+    def get_url_rev_and_auth(cls, url):
+        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
+        """
+        Parse the repository URL to use, and return the URL, revision,
+        and auth info to use.
+
+        Returns: (url, rev, (username, password)).
+        """
+        scheme, netloc, path, query, frag = urllib_parse.urlsplit(url)
+        if '+' not in scheme:
+            raise ValueError(
+                "Sorry, {!r} is a malformed VCS url. "
+                "The format is <vcs>+<protocol>://<url>, "
+                "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp".format(url)
+            )
+        # Remove the vcs prefix.
+        scheme = scheme.split('+', 1)[1]
+        netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme)
+        rev = None
+        if '@' in path:
+            path, rev = path.rsplit('@', 1)
+        url = urllib_parse.urlunsplit((scheme, netloc, path, query, ''))
+        return url, rev, user_pass
+
+    @staticmethod
+    def make_rev_args(username, password):
+        # type: (Optional[str], Optional[HiddenText]) -> CommandArgs
+        """
+        Return the RevOptions "extra arguments" to use in obtain().
+        """
+        return []
+
+    def get_url_rev_options(self, url):
+        # type: (HiddenText) -> Tuple[HiddenText, RevOptions]
+        """
+        Return the URL and RevOptions object to use in obtain() and in
+        some cases export(), as a tuple (url, rev_options).
+        """
+        secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret)
+        username, secret_password = user_pass
+        password = None  # type: Optional[HiddenText]
+        if secret_password is not None:
+            password = hide_value(secret_password)
+        extra_args = self.make_rev_args(username, password)
+        rev_options = self.make_rev_options(rev, extra_args=extra_args)
+
+        return hide_url(secret_url), rev_options
+
+    @staticmethod
+    def normalize_url(url):
+        # type: (str) -> str
+        """
+        Normalize a URL for comparison by unquoting it and removing any
+        trailing slash.
+        """
+        return urllib_parse.unquote(url).rstrip('/')
+
+    @classmethod
+    def compare_urls(cls, url1, url2):
+        # type: (str, str) -> bool
+        """
+        Compare two repo URLs for identity, ignoring incidental differences.
+        """
+        return (cls.normalize_url(url1) == cls.normalize_url(url2))
+
+    def fetch_new(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        """
+        Fetch a revision from a repository, in the case that this is the
+        first fetch from the repository.
+
+        Args:
+          dest: the directory to fetch the repository to.
+          rev_options: a RevOptions object.
+        """
+        raise NotImplementedError
+
+    def switch(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        """
+        Switch the repo at ``dest`` to point to ``URL``.
+
+        Args:
+          rev_options: a RevOptions object.
+        """
+        raise NotImplementedError
+
+    def update(self, dest, url, rev_options):
+        # type: (str, HiddenText, RevOptions) -> None
+        """
+        Update an already-existing repo to the given ``rev_options``.
+
+        Args:
+          rev_options: a RevOptions object.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def is_commit_id_equal(cls, dest, name):
+        # type: (str, Optional[str]) -> bool
+        """
+        Return whether the id of the current commit equals the given name.
+
+        Args:
+          dest: the repository directory.
+          name: a string name.
+        """
+        raise NotImplementedError
+
+    def obtain(self, dest, url):
+        # type: (str, HiddenText) -> None
+        """
+        Install or update in editable mode the package represented by this
+        VersionControl object.
+
+        :param dest: the repository directory in which to install or update.
+        :param url: the repository URL starting with a vcs prefix.
+        """
+        url, rev_options = self.get_url_rev_options(url)
+
+        if not os.path.exists(dest):
+            self.fetch_new(dest, url, rev_options)
+            return
+
+        rev_display = rev_options.to_display()
+        if self.is_repository_directory(dest):
+            existing_url = self.get_remote_url(dest)
+            if self.compare_urls(existing_url, url.secret):
+                logger.debug(
+                    '%s in %s exists, and has correct URL (%s)',
+                    self.repo_name.title(),
+                    display_path(dest),
+                    url,
+                )
+                if not self.is_commit_id_equal(dest, rev_options.rev):
+                    logger.info(
+                        'Updating %s %s%s',
+                        display_path(dest),
+                        self.repo_name,
+                        rev_display,
+                    )
+                    self.update(dest, url, rev_options)
+                else:
+                    logger.info('Skipping because already up-to-date.')
+                return
+
+            logger.warning(
+                '%s %s in %s exists with URL %s',
+                self.name,
+                self.repo_name,
+                display_path(dest),
+                existing_url,
+            )
+            prompt = ('(s)witch, (i)gnore, (w)ipe, (b)ackup ',
+                      ('s', 'i', 'w', 'b'))
+        else:
+            logger.warning(
+                'Directory %s already exists, and is not a %s %s.',
+                dest,
+                self.name,
+                self.repo_name,
+            )
+            # https://github.com/python/mypy/issues/1174
+            prompt = ('(i)gnore, (w)ipe, (b)ackup ',  # type: ignore
+                      ('i', 'w', 'b'))
+
+        logger.warning(
+            'The plan is to install the %s repository %s',
+            self.name,
+            url,
+        )
+        response = ask_path_exists('What to do?  %s' % prompt[0], prompt[1])
+
+        if response == 'a':
+            sys.exit(-1)
+
+        if response == 'w':
+            logger.warning('Deleting %s', display_path(dest))
+            rmtree(dest)
+            self.fetch_new(dest, url, rev_options)
+            return
+
+        if response == 'b':
+            dest_dir = backup_dir(dest)
+            logger.warning(
+                'Backing up %s to %s', display_path(dest), dest_dir,
+            )
+            shutil.move(dest, dest_dir)
+            self.fetch_new(dest, url, rev_options)
+            return
+
+        # Do nothing if the response is "i".
+        if response == 's':
+            logger.info(
+                'Switching %s %s to %s%s',
+                self.repo_name,
+                display_path(dest),
+                url,
+                rev_display,
+            )
+            self.switch(dest, url, rev_options)
+
+    def unpack(self, location, url):
+        # type: (str, HiddenText) -> None
+        """
+        Clean up current location and download the url repository
+        (and vcs infos) into location
+
+        :param url: the repository URL starting with a vcs prefix.
+        """
+        if os.path.exists(location):
+            rmtree(location)
+        self.obtain(location, url=url)
+
+    @classmethod
+    def get_remote_url(cls, location):
+        # type: (str) -> str
+        """
+        Return the url used at location
+
+        Raises RemoteNotFoundError if the repository does not have a remote
+        url configured.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def get_revision(cls, location):
+        # type: (str) -> str
+        """
+        Return the current commit id of the files at the given location.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def run_command(
+        cls,
+        cmd,  # type: Union[List[str], CommandArgs]
+        show_stdout=True,  # type: bool
+        cwd=None,  # type: Optional[str]
+        on_returncode='raise',  # type: str
+        extra_ok_returncodes=None,  # type: Optional[Iterable[int]]
+        command_desc=None,  # type: Optional[str]
+        extra_environ=None,  # type: Optional[Mapping[str, Any]]
+        spinner=None,  # type: Optional[SpinnerInterface]
+        log_failed_cmd=True  # type: bool
+    ):
+        # type: (...) -> Text
+        """
+        Run a VCS subcommand
+        This is simply a wrapper around call_subprocess that adds the VCS
+        command name, and checks that the VCS is available
+        """
+        cmd = make_command(cls.name, *cmd)
+        try:
+            return call_subprocess(cmd, show_stdout, cwd,
+                                   on_returncode=on_returncode,
+                                   extra_ok_returncodes=extra_ok_returncodes,
+                                   command_desc=command_desc,
+                                   extra_environ=extra_environ,
+                                   unset_environ=cls.unset_environ,
+                                   spinner=spinner,
+                                   log_failed_cmd=log_failed_cmd)
+        except OSError as e:
+            # errno.ENOENT = no such file or directory
+            # In other words, the VCS executable isn't available
+            if e.errno == errno.ENOENT:
+                raise BadCommand(
+                    'Cannot find command %r - do you have '
+                    '%r installed and in your '
+                    'PATH?' % (cls.name, cls.name))
+            else:
+                raise  # re-raise exception if a different error occurred
+
+    @classmethod
+    def is_repository_directory(cls, path):
+        # type: (str) -> bool
+        """
+        Return whether a directory path is a repository directory.
+        """
+        logger.debug('Checking in %s for %s (%s)...',
+                     path, cls.dirname, cls.name)
+        return os.path.exists(os.path.join(path, cls.dirname))
+
+    @classmethod
+    def controls_location(cls, location):
+        # type: (str) -> bool
+        """
+        Check if a location is controlled by the vcs.
+        It is meant to be overridden to implement smarter detection
+        mechanisms for specific vcs.
+
+        This can do more than is_repository_directory() alone.  For example,
+        the Git override checks that Git is actually available.
+        """
+        return cls.is_repository_directory(location)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c7820d4f26560dff25801dd5034b355d2823795
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_internal/wheel_builder.py
@@ -0,0 +1,305 @@
+"""Orchestrator for building wheels from InstallRequirements.
+"""
+
+# The following comment should be removed at some point in the future.
+# mypy: strict-optional=False
+
+import logging
+import os.path
+import re
+import shutil
+
+from pip._internal.models.link import Link
+from pip._internal.operations.build.wheel import build_wheel_pep517
+from pip._internal.operations.build.wheel_legacy import build_wheel_legacy
+from pip._internal.utils.logging import indent_log
+from pip._internal.utils.misc import ensure_dir, hash_file, is_wheel_installed
+from pip._internal.utils.setuptools_build import make_setuptools_clean_args
+from pip._internal.utils.subprocess import call_subprocess
+from pip._internal.utils.temp_dir import TempDirectory
+from pip._internal.utils.typing import MYPY_CHECK_RUNNING
+from pip._internal.utils.urls import path_to_url
+from pip._internal.vcs import vcs
+
+if MYPY_CHECK_RUNNING:
+    from typing import (
+        Any, Callable, Iterable, List, Optional, Pattern, Tuple,
+    )
+
+    from pip._internal.cache import WheelCache
+    from pip._internal.req.req_install import InstallRequirement
+
+    BinaryAllowedPredicate = Callable[[InstallRequirement], bool]
+    BuildResult = Tuple[List[InstallRequirement], List[InstallRequirement]]
+
+logger = logging.getLogger(__name__)
+
+
+def _contains_egg_info(
+        s, _egg_info_re=re.compile(r'([a-z0-9_.]+)-([a-z0-9_.!+-]+)', re.I)):
+    # type: (str, Pattern[str]) -> bool
+    """Determine whether the string looks like an egg_info.
+
+    :param s: The string to parse. E.g. foo-2.1
+    """
+    return bool(_egg_info_re.search(s))
+
+
+def _should_build(
+    req,  # type: InstallRequirement
+    need_wheel,  # type: bool
+    check_binary_allowed,  # type: BinaryAllowedPredicate
+):
+    # type: (...) -> bool
+    """Return whether an InstallRequirement should be built into a wheel."""
+    if req.constraint:
+        # never build requirements that are merely constraints
+        return False
+    if req.is_wheel:
+        if need_wheel:
+            logger.info(
+                'Skipping %s, due to already being wheel.', req.name,
+            )
+        return False
+
+    if need_wheel:
+        # i.e. pip wheel, not pip install
+        return True
+
+    # From this point, this concerns the pip install command only
+    # (need_wheel=False).
+
+    if not req.use_pep517 and not is_wheel_installed():
+        # we don't build legacy requirements if wheel is not installed
+        return False
+
+    if req.editable or not req.source_dir:
+        return False
+
+    if not check_binary_allowed(req):
+        logger.info(
+            "Skipping wheel build for %s, due to binaries "
+            "being disabled for it.", req.name,
+        )
+        return False
+
+    return True
+
+
+def should_build_for_wheel_command(
+    req,  # type: InstallRequirement
+):
+    # type: (...) -> bool
+    return _should_build(
+        req, need_wheel=True, check_binary_allowed=_always_true
+    )
+
+
+def should_build_for_install_command(
+    req,  # type: InstallRequirement
+    check_binary_allowed,  # type: BinaryAllowedPredicate
+):
+    # type: (...) -> bool
+    return _should_build(
+        req, need_wheel=False, check_binary_allowed=check_binary_allowed
+    )
+
+
+def _should_cache(
+    req,  # type: InstallRequirement
+):
+    # type: (...) -> Optional[bool]
+    """
+    Return whether a built InstallRequirement can be stored in the persistent
+    wheel cache, assuming the wheel cache is available, and _should_build()
+    has determined a wheel needs to be built.
+    """
+    if not should_build_for_install_command(
+        req, check_binary_allowed=_always_true
+    ):
+        # never cache if pip install would not have built
+        # (editable mode, etc)
+        return False
+
+    if req.link and req.link.is_vcs:
+        # VCS checkout. Do not cache
+        # unless it points to an immutable commit hash.
+        assert not req.editable
+        assert req.source_dir
+        vcs_backend = vcs.get_backend_for_scheme(req.link.scheme)
+        assert vcs_backend
+        if vcs_backend.is_immutable_rev_checkout(req.link.url, req.source_dir):
+            return True
+        return False
+
+    base, ext = req.link.splitext()
+    if _contains_egg_info(base):
+        return True
+
+    # Otherwise, do not cache.
+    return False
+
+
+def _get_cache_dir(
+    req,  # type: InstallRequirement
+    wheel_cache,  # type: WheelCache
+):
+    # type: (...) -> str
+    """Return the persistent or temporary cache directory where the built
+    wheel need to be stored.
+    """
+    cache_available = bool(wheel_cache.cache_dir)
+    if cache_available and _should_cache(req):
+        cache_dir = wheel_cache.get_path_for_link(req.link)
+    else:
+        cache_dir = wheel_cache.get_ephem_path_for_link(req.link)
+    return cache_dir
+
+
+def _always_true(_):
+    # type: (Any) -> bool
+    return True
+
+
+def _build_one(
+    req,  # type: InstallRequirement
+    output_dir,  # type: str
+    build_options,  # type: List[str]
+    global_options,  # type: List[str]
+):
+    # type: (...) -> Optional[str]
+    """Build one wheel.
+
+    :return: The filename of the built wheel, or None if the build failed.
+    """
+    try:
+        ensure_dir(output_dir)
+    except OSError as e:
+        logger.warning(
+            "Building wheel for %s failed: %s",
+            req.name, e,
+        )
+        return None
+
+    # Install build deps into temporary directory (PEP 518)
+    with req.build_env:
+        return _build_one_inside_env(
+            req, output_dir, build_options, global_options
+        )
+
+
+def _build_one_inside_env(
+    req,  # type: InstallRequirement
+    output_dir,  # type: str
+    build_options,  # type: List[str]
+    global_options,  # type: List[str]
+):
+    # type: (...) -> Optional[str]
+    with TempDirectory(kind="wheel") as temp_dir:
+        if req.use_pep517:
+            wheel_path = build_wheel_pep517(
+                name=req.name,
+                backend=req.pep517_backend,
+                metadata_directory=req.metadata_directory,
+                build_options=build_options,
+                tempd=temp_dir.path,
+            )
+        else:
+            wheel_path = build_wheel_legacy(
+                name=req.name,
+                setup_py_path=req.setup_py_path,
+                source_dir=req.unpacked_source_directory,
+                global_options=global_options,
+                build_options=build_options,
+                tempd=temp_dir.path,
+            )
+
+        if wheel_path is not None:
+            wheel_name = os.path.basename(wheel_path)
+            dest_path = os.path.join(output_dir, wheel_name)
+            try:
+                wheel_hash, length = hash_file(wheel_path)
+                shutil.move(wheel_path, dest_path)
+                logger.info('Created wheel for %s: '
+                            'filename=%s size=%d sha256=%s',
+                            req.name, wheel_name, length,
+                            wheel_hash.hexdigest())
+                logger.info('Stored in directory: %s', output_dir)
+                return dest_path
+            except Exception as e:
+                logger.warning(
+                    "Building wheel for %s failed: %s",
+                    req.name, e,
+                )
+        # Ignore return, we can't do anything else useful.
+        if not req.use_pep517:
+            _clean_one_legacy(req, global_options)
+        return None
+
+
+def _clean_one_legacy(req, global_options):
+    # type: (InstallRequirement, List[str]) -> bool
+    clean_args = make_setuptools_clean_args(
+        req.setup_py_path,
+        global_options=global_options,
+    )
+
+    logger.info('Running setup.py clean for %s', req.name)
+    try:
+        call_subprocess(clean_args, cwd=req.source_dir)
+        return True
+    except Exception:
+        logger.error('Failed cleaning build dir for %s', req.name)
+        return False
+
+
+def build(
+    requirements,  # type: Iterable[InstallRequirement]
+    wheel_cache,  # type: WheelCache
+    build_options,  # type: List[str]
+    global_options,  # type: List[str]
+):
+    # type: (...) -> BuildResult
+    """Build wheels.
+
+    :return: The list of InstallRequirement that succeeded to build and
+        the list of InstallRequirement that failed to build.
+    """
+    if not requirements:
+        return [], []
+
+    # Build the wheels.
+    logger.info(
+        'Building wheels for collected packages: %s',
+        ', '.join(req.name for req in requirements),
+    )
+
+    with indent_log():
+        build_successes, build_failures = [], []
+        for req in requirements:
+            cache_dir = _get_cache_dir(req, wheel_cache)
+            wheel_file = _build_one(
+                req, cache_dir, build_options, global_options
+            )
+            if wheel_file:
+                # Update the link for this.
+                req.link = Link(path_to_url(wheel_file))
+                req.local_file_path = req.link.file_path
+                assert req.link.is_wheel
+                build_successes.append(req)
+            else:
+                build_failures.append(req)
+
+    # notify success/failure
+    if build_successes:
+        logger.info(
+            'Successfully built %s',
+            ' '.join([req.name for req in build_successes]),
+        )
+    if build_failures:
+        logger.info(
+            'Failed to build %s',
+            ' '.join([req.name for req in build_failures]),
+        )
+    # Return a list of requirements that failed to build
+    return build_successes, build_failures
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8b7ae6fb2bef6ae14c766c95423d4f4abf5d8fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pip/_vendor/__init__.py
@@ -0,0 +1,117 @@
+"""
+pip._vendor is for vendoring dependencies of pip to prevent needing pip to
+depend on something external.
+
+Files inside of pip._vendor should be considered immutable and should only be
+updated to versions from upstream.
+"""
+from __future__ import absolute_import
+
+import glob
+import os.path
+import sys
+
+# Downstream redistributors which have debundled our dependencies should also
+# patch this value to be true. This will trigger the additional patching
+# to cause things like "six" to be available as pip.
+DEBUNDLED = True
+
+# By default, look in this directory for a bunch of .whl files which we will
+# add to the beginning of sys.path before attempting to import anything. This
+# is done to support downstream re-distributors like Debian and Fedora who
+# wish to create their own Wheels for our dependencies to aid in debundling.
+prefix = sys.prefix
+if sys.prefix.startswith('/usr/lib/pypy'):
+    prefix = '/usr'
+WHEEL_DIR = os.path.abspath(os.path.join(prefix, 'share', 'python-wheels'))
+
+
+# Define a small helper function to alias our vendored modules to the real ones
+# if the vendored ones do not exist. This idea of this was taken from
+# https://github.com/kennethreitz/requests/pull/2567.
+def vendored(modulename):
+    vendored_name = "{0}.{1}".format(__name__, modulename)
+
+    try:
+        __import__(modulename, globals(), locals(), level=0)
+    except ImportError:
+        # We can just silently allow import failures to pass here. If we
+        # got to this point it means that ``import pip._vendor.whatever``
+        # failed and so did ``import whatever``. Since we're importing this
+        # upfront in an attempt to alias imports, not erroring here will
+        # just mean we get a regular import error whenever pip *actually*
+        # tries to import one of these modules to use it, which actually
+        # gives us a better error message than we would have otherwise
+        # gotten.
+        pass
+    else:
+        sys.modules[vendored_name] = sys.modules[modulename]
+        base, head = vendored_name.rsplit(".", 1)
+        setattr(sys.modules[base], head, sys.modules[modulename])
+
+
+# If we're operating in a debundled setup, then we want to go ahead and trigger
+# the aliasing of our vendored libraries as well as looking for wheels to add
+# to our sys.path. This will cause all of this code to be a no-op typically
+# however downstream redistributors can enable it in a consistent way across
+# all platforms.
+if DEBUNDLED:
+    # Actually look inside of WHEEL_DIR to find .whl files and add them to the
+    # front of our sys.path.
+    sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path
+
+    # Actually alias all of our vendored dependencies.
+    vendored("appdirs")
+    vendored("cachecontrol")
+    vendored("colorama")
+    vendored("contextlib2")
+    vendored("distlib")
+    vendored("distro")
+    vendored("html5lib")
+    vendored("six")
+    vendored("six.moves")
+    vendored("six.moves.urllib")
+    vendored("six.moves.urllib.parse")
+    vendored("packaging")
+    vendored("packaging.version")
+    vendored("packaging.specifiers")
+    vendored("pep517")
+    vendored("pkg_resources")
+    vendored("progress")
+    vendored("pytoml")
+    vendored("retrying")
+    vendored("requests")
+    vendored("requests.exceptions")
+    vendored("requests.packages")
+    vendored("requests.packages.urllib3")
+    vendored("requests.packages.urllib3._collections")
+    vendored("requests.packages.urllib3.connection")
+    vendored("requests.packages.urllib3.connectionpool")
+    vendored("requests.packages.urllib3.contrib")
+    vendored("requests.packages.urllib3.contrib.ntlmpool")
+    vendored("requests.packages.urllib3.contrib.pyopenssl")
+    vendored("requests.packages.urllib3.exceptions")
+    vendored("requests.packages.urllib3.fields")
+    vendored("requests.packages.urllib3.filepost")
+    vendored("requests.packages.urllib3.packages")
+    try:
+        vendored("requests.packages.urllib3.packages.ordered_dict")
+        vendored("requests.packages.urllib3.packages.six")
+    except ImportError:
+        # Debian already unbundles these from requests.
+        pass
+    vendored("requests.packages.urllib3.packages.ssl_match_hostname")
+    vendored("requests.packages.urllib3.packages.ssl_match_hostname."
+             "_implementation")
+    vendored("requests.packages.urllib3.poolmanager")
+    vendored("requests.packages.urllib3.request")
+    vendored("requests.packages.urllib3.response")
+    vendored("requests.packages.urllib3.util")
+    vendored("requests.packages.urllib3.util.connection")
+    vendored("requests.packages.urllib3.util.request")
+    vendored("requests.packages.urllib3.util.response")
+    vendored("requests.packages.urllib3.util.retry")
+    vendored("requests.packages.urllib3.util.ssl_")
+    vendored("requests.packages.urllib3.util.timeout")
+    vendored("requests.packages.urllib3.util.url")
+    vendored("urllib3")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..cf6c9302c5b0495077d258b68c77e2fe11f90f8f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/METADATA
@@ -0,0 +1,13 @@
+Metadata-Version: 2.1
+Name: pkg_resources
+Version: 0.0.0
+Summary: UNKNOWN
+Home-page: UNKNOWN
+Author: UNKNOWN
+Author-email: UNKNOWN
+License: UNKNOWN
+Platform: UNKNOWN
+
+UNKNOWN
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..066f14de90c0360adc3bff3292054dfd78cbb6e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/RECORD
@@ -0,0 +1,44 @@
+pkg_resources/__init__.py,sha256=0IssxXPnaDKpYZRra8Ime0JG4hwosQljItGD0bnIkGk,108349
+pkg_resources/py31compat.py,sha256=-WQ0e4c3RG_acdhwC3gLiXhP_lg4G5q7XYkZkQg0gxU,558
+pkg_resources/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkg_resources/_vendor/appdirs.py,sha256=MievUEuv3l_mQISH5SF0shDk_BNhHHzYiAPrT3ITN4I,24701
+pkg_resources/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055
+pkg_resources/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098
+pkg_resources/_vendor/packaging/__about__.py,sha256=zkcCPTN_6TcLW0Nrlg0176-R1QQ_WVPTm8sz1R4-HjM,720
+pkg_resources/_vendor/packaging/__init__.py,sha256=_vNac5TrzwsrzbOFIbF-5cHqc_Y2aPT2D7zrIR06BOo,513
+pkg_resources/_vendor/packaging/_compat.py,sha256=Vi_A0rAQeHbU-a9X0tt1yQm9RqkgQbDSxzRw8WlU9kA,860
+pkg_resources/_vendor/packaging/_structures.py,sha256=RImECJ4c_wTlaTYYwZYLHEiebDMaAJmK1oPARhw1T5o,1416
+pkg_resources/_vendor/packaging/markers.py,sha256=uEcBBtGvzqltgnArqb9c4RrcInXezDLos14zbBHhWJo,8248
+pkg_resources/_vendor/packaging/requirements.py,sha256=SikL2UynbsT0qtY9ltqngndha_sfo0w6XGFhAhoSoaQ,4355
+pkg_resources/_vendor/packaging/specifiers.py,sha256=SAMRerzO3fK2IkFZCaZkuwZaL_EGqHNOz4pni4vhnN0,28025
+pkg_resources/_vendor/packaging/utils.py,sha256=3m6WvPm6NNxE8rkTGmn0r75B_GZSGg7ikafxHsBN1WA,421
+pkg_resources/_vendor/packaging/version.py,sha256=OwGnxYfr2ghNzYx59qWIBkrK3SnB6n-Zfd1XaLpnnM0,11556
+pkg_resources/extern/__init__.py,sha256=cHiEfHuLmm6rs5Ve_ztBfMI7Lr31vss-D4wkqF5xzlI,2498
+pkg_resources-0.0.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+pkg_resources-0.0.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+pkg_resources-0.0.0.dist-info/METADATA,sha256=V9_WPOtD1FnuKrTGv6Ique7kAOn2lasvT8W0_iMCCCk,177
+pkg_resources-0.0.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pkg_resources-0.0.0.dist-info/RECORD,,
+pkg_resources-0.0.0.dist-info/INSTALLER,,
+pkg_resources/extern/__init__.cpython-38.pyc,,
+pkg_resources/_vendor/__pycache__,,
+pkg_resources/__init__.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/version.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/__pycache__,,
+pkg_resources/_vendor/six.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/utils.cpython-38.pyc,,
+pkg_resources/extern/__pycache__,,
+pkg_resources/__pycache__,,
+pkg_resources/_vendor/pyparsing.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/__about__.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/requirements.cpython-38.pyc,,
+pkg_resources-0.0.0.dist-info/__pycache__,,
+pkg_resources/_vendor/packaging/_compat.cpython-38.pyc,,
+pkg_resources/_vendor/__init__.cpython-38.pyc,,
+pkg_resources/py31compat.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/specifiers.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/_structures.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/markers.cpython-38.pyc,,
+pkg_resources/_vendor/appdirs.cpython-38.pyc,,
+pkg_resources/_vendor/packaging/__init__.cpython-38.pyc,,
+pkg_resources-0.0.0.virtualenv,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources-0.0.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f5aa64a6e10832f407601d668e4ef0d9d5d0aeb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/__init__.py
@@ -0,0 +1,3296 @@
+# coding: utf-8
+"""
+Package resource API
+--------------------
+
+A resource is a logical file contained within a package, or a logical
+subdirectory thereof.  The package resource API expects resource names
+to have their path parts separated with ``/``, *not* whatever the local
+path separator is.  Do not use os.path operations to manipulate resource
+names being passed into the API.
+
+The package resource API is designed to work with normal filesystem packages,
+.egg files, and unpacked .egg files.  It can also work in a limited way with
+.zip files and with custom PEP 302 loaders that support the ``get_data()``
+method.
+"""
+
+from __future__ import absolute_import
+
+import sys
+import os
+import io
+import time
+import re
+import types
+import zipfile
+import zipimport
+import warnings
+import stat
+import functools
+import pkgutil
+import operator
+import platform
+import collections
+import plistlib
+import email.parser
+import errno
+import tempfile
+import textwrap
+import itertools
+import inspect
+import ntpath
+import posixpath
+from pkgutil import get_importer
+
+try:
+    import _imp
+except ImportError:
+    # Python 3.2 compatibility
+    import imp as _imp
+
+try:
+    FileExistsError
+except NameError:
+    FileExistsError = OSError
+
+from pkg_resources.extern import six
+from pkg_resources.extern.six.moves import urllib, map, filter
+
+# capture these to bypass sandboxing
+from os import utime
+try:
+    from os import mkdir, rename, unlink
+    WRITE_SUPPORT = True
+except ImportError:
+    # no write support, probably under GAE
+    WRITE_SUPPORT = False
+
+from os import open as os_open
+from os.path import isdir, split
+
+try:
+    import importlib.machinery as importlib_machinery
+    # access attribute to force import under delayed import mechanisms.
+    importlib_machinery.__name__
+except ImportError:
+    importlib_machinery = None
+
+from . import py31compat
+from pkg_resources.extern import appdirs
+from pkg_resources.extern import packaging
+__import__('pkg_resources.extern.packaging.version')
+__import__('pkg_resources.extern.packaging.specifiers')
+__import__('pkg_resources.extern.packaging.requirements')
+__import__('pkg_resources.extern.packaging.markers')
+
+
+__metaclass__ = type
+
+
+if (3, 0) < sys.version_info < (3, 5):
+    raise RuntimeError("Python 3.5 or later is required")
+
+if six.PY2:
+    # Those builtin exceptions are only defined in Python 3
+    PermissionError = None
+    NotADirectoryError = None
+
+# declare some globals that will be defined later to
+# satisfy the linters.
+require = None
+working_set = None
+add_activation_listener = None
+resources_stream = None
+cleanup_resources = None
+resource_dir = None
+resource_stream = None
+set_extraction_path = None
+resource_isdir = None
+resource_string = None
+iter_entry_points = None
+resource_listdir = None
+resource_filename = None
+resource_exists = None
+_distribution_finders = None
+_namespace_handlers = None
+_namespace_packages = None
+
+
+class PEP440Warning(RuntimeWarning):
+    """
+    Used when there is an issue with a version or specifier not complying with
+    PEP 440.
+    """
+
+
+def parse_version(v):
+    try:
+        return packaging.version.Version(v)
+    except packaging.version.InvalidVersion:
+        return packaging.version.LegacyVersion(v)
+
+
+_state_vars = {}
+
+
+def _declare_state(vartype, **kw):
+    globals().update(kw)
+    _state_vars.update(dict.fromkeys(kw, vartype))
+
+
+def __getstate__():
+    state = {}
+    g = globals()
+    for k, v in _state_vars.items():
+        state[k] = g['_sget_' + v](g[k])
+    return state
+
+
+def __setstate__(state):
+    g = globals()
+    for k, v in state.items():
+        g['_sset_' + _state_vars[k]](k, g[k], v)
+    return state
+
+
+def _sget_dict(val):
+    return val.copy()
+
+
+def _sset_dict(key, ob, state):
+    ob.clear()
+    ob.update(state)
+
+
+def _sget_object(val):
+    return val.__getstate__()
+
+
+def _sset_object(key, ob, state):
+    ob.__setstate__(state)
+
+
+_sget_none = _sset_none = lambda *args: None
+
+
+def get_supported_platform():
+    """Return this platform's maximum compatible version.
+
+    distutils.util.get_platform() normally reports the minimum version
+    of Mac OS X that would be required to *use* extensions produced by
+    distutils.  But what we want when checking compatibility is to know the
+    version of Mac OS X that we are *running*.  To allow usage of packages that
+    explicitly require a newer version of Mac OS X, we must also know the
+    current version of the OS.
+
+    If this condition occurs for any other platform with a version in its
+    platform strings, this function should be extended accordingly.
+    """
+    plat = get_build_platform()
+    m = macosVersionString.match(plat)
+    if m is not None and sys.platform == "darwin":
+        try:
+            plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers()[:2]), m.group(3))
+        except ValueError:
+            # not Mac OS X
+            pass
+    return plat
+
+
+__all__ = [
+    # Basic resource access and distribution/entry point discovery
+    'require', 'run_script', 'get_provider', 'get_distribution',
+    'load_entry_point', 'get_entry_map', 'get_entry_info',
+    'iter_entry_points',
+    'resource_string', 'resource_stream', 'resource_filename',
+    'resource_listdir', 'resource_exists', 'resource_isdir',
+
+    # Environmental control
+    'declare_namespace', 'working_set', 'add_activation_listener',
+    'find_distributions', 'set_extraction_path', 'cleanup_resources',
+    'get_default_cache',
+
+    # Primary implementation classes
+    'Environment', 'WorkingSet', 'ResourceManager',
+    'Distribution', 'Requirement', 'EntryPoint',
+
+    # Exceptions
+    'ResolutionError', 'VersionConflict', 'DistributionNotFound',
+    'UnknownExtra', 'ExtractionError',
+
+    # Warnings
+    'PEP440Warning',
+
+    # Parsing functions and string utilities
+    'parse_requirements', 'parse_version', 'safe_name', 'safe_version',
+    'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections',
+    'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker',
+
+    # filesystem utilities
+    'ensure_directory', 'normalize_path',
+
+    # Distribution "precedence" constants
+    'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST',
+
+    # "Provider" interfaces, implementations, and registration/lookup APIs
+    'IMetadataProvider', 'IResourceProvider', 'FileMetadata',
+    'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider',
+    'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider',
+    'register_finder', 'register_namespace_handler', 'register_loader_type',
+    'fixup_namespace_packages', 'get_importer',
+
+    # Warnings
+    'PkgResourcesDeprecationWarning',
+
+    # Deprecated/backward compatibility only
+    'run_main', 'AvailableDistributions',
+]
+
+
+class ResolutionError(Exception):
+    """Abstract base for dependency resolution errors"""
+
+    def __repr__(self):
+        return self.__class__.__name__ + repr(self.args)
+
+
+class VersionConflict(ResolutionError):
+    """
+    An already-installed version conflicts with the requested version.
+
+    Should be initialized with the installed Distribution and the requested
+    Requirement.
+    """
+
+    _template = "{self.dist} is installed but {self.req} is required"
+
+    @property
+    def dist(self):
+        return self.args[0]
+
+    @property
+    def req(self):
+        return self.args[1]
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def with_context(self, required_by):
+        """
+        If required_by is non-empty, return a version of self that is a
+        ContextualVersionConflict.
+        """
+        if not required_by:
+            return self
+        args = self.args + (required_by,)
+        return ContextualVersionConflict(*args)
+
+
+class ContextualVersionConflict(VersionConflict):
+    """
+    A VersionConflict that accepts a third parameter, the set of the
+    requirements that required the installed Distribution.
+    """
+
+    _template = VersionConflict._template + ' by {self.required_by}'
+
+    @property
+    def required_by(self):
+        return self.args[2]
+
+
+class DistributionNotFound(ResolutionError):
+    """A requested distribution was not found"""
+
+    _template = ("The '{self.req}' distribution was not found "
+                 "and is required by {self.requirers_str}")
+
+    @property
+    def req(self):
+        return self.args[0]
+
+    @property
+    def requirers(self):
+        return self.args[1]
+
+    @property
+    def requirers_str(self):
+        if not self.requirers:
+            return 'the application'
+        return ', '.join(self.requirers)
+
+    def report(self):
+        return self._template.format(**locals())
+
+    def __str__(self):
+        return self.report()
+
+
+class UnknownExtra(ResolutionError):
+    """Distribution doesn't have an "extra feature" of the given name"""
+
+
+_provider_factories = {}
+
+PY_MAJOR = '{}.{}'.format(*sys.version_info)
+EGG_DIST = 3
+BINARY_DIST = 2
+SOURCE_DIST = 1
+CHECKOUT_DIST = 0
+DEVELOP_DIST = -1
+
+
+def register_loader_type(loader_type, provider_factory):
+    """Register `provider_factory` to make providers for `loader_type`
+
+    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
+    and `provider_factory` is a function that, passed a *module* object,
+    returns an ``IResourceProvider`` for that module.
+    """
+    _provider_factories[loader_type] = provider_factory
+
+
+def get_provider(moduleOrReq):
+    """Return an IResourceProvider for the named module or requirement"""
+    if isinstance(moduleOrReq, Requirement):
+        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
+    try:
+        module = sys.modules[moduleOrReq]
+    except KeyError:
+        __import__(moduleOrReq)
+        module = sys.modules[moduleOrReq]
+    loader = getattr(module, '__loader__', None)
+    return _find_adapter(_provider_factories, loader)(module)
+
+
+def _macosx_vers(_cache=[]):
+    if not _cache:
+        version = platform.mac_ver()[0]
+        # fallback for MacPorts
+        if version == '':
+            plist = '/System/Library/CoreServices/SystemVersion.plist'
+            if os.path.exists(plist):
+                if hasattr(plistlib, 'readPlist'):
+                    plist_content = plistlib.readPlist(plist)
+                    if 'ProductVersion' in plist_content:
+                        version = plist_content['ProductVersion']
+
+        _cache.append(version.split('.'))
+    return _cache[0]
+
+
+def _macosx_arch(machine):
+    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)
+
+
+def get_build_platform():
+    """Return this platform's string for platform-specific distributions
+
+    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
+    needs some hacks for Linux and Mac OS X.
+    """
+    from sysconfig import get_platform
+
+    plat = get_platform()
+    if sys.platform == "darwin" and not plat.startswith('macosx-'):
+        try:
+            version = _macosx_vers()
+            machine = os.uname()[4].replace(" ", "_")
+            return "macosx-%d.%d-%s" % (
+                int(version[0]), int(version[1]),
+                _macosx_arch(machine),
+            )
+        except ValueError:
+            # if someone is running a non-Mac darwin system, this will fall
+            # through to the default implementation
+            pass
+    return plat
+
+
+macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
+darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
+# XXX backward compat
+get_platform = get_build_platform
+
+
+def compatible_platforms(provided, required):
+    """Can code for the `provided` platform run on the `required` platform?
+
+    Returns true if either platform is ``None``, or the platforms are equal.
+
+    XXX Needs compatibility checks for Linux and other unixy OSes.
+    """
+    if provided is None or required is None or provided == required:
+        # easy case
+        return True
+
+    # Mac OS X special cases
+    reqMac = macosVersionString.match(required)
+    if reqMac:
+        provMac = macosVersionString.match(provided)
+
+        # is this a Mac package?
+        if not provMac:
+            # this is backwards compatibility for packages built before
+            # setuptools 0.6. All packages built after this point will
+            # use the new macosx designation.
+            provDarwin = darwinVersionString.match(provided)
+            if provDarwin:
+                dversion = int(provDarwin.group(1))
+                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
+                if dversion == 7 and macosversion >= "10.3" or \
+                        dversion == 8 and macosversion >= "10.4":
+                    return True
+            # egg isn't macosx or legacy darwin
+            return False
+
+        # are they the same major version and machine type?
+        if provMac.group(1) != reqMac.group(1) or \
+                provMac.group(3) != reqMac.group(3):
+            return False
+
+        # is the required OS major update >= the provided one?
+        if int(provMac.group(2)) > int(reqMac.group(2)):
+            return False
+
+        return True
+
+    # XXX Linux and other platforms' special cases should go here
+    return False
+
+
+def run_script(dist_spec, script_name):
+    """Locate distribution `dist_spec` and run its `script_name` script"""
+    ns = sys._getframe(1).f_globals
+    name = ns['__name__']
+    ns.clear()
+    ns['__name__'] = name
+    require(dist_spec)[0].run_script(script_name, ns)
+
+
+# backward compatibility
+run_main = run_script
+
+
+def get_distribution(dist):
+    """Return a current distribution object for a Requirement or string"""
+    if isinstance(dist, six.string_types):
+        dist = Requirement.parse(dist)
+    if isinstance(dist, Requirement):
+        dist = get_provider(dist)
+    if not isinstance(dist, Distribution):
+        raise TypeError("Expected string, Requirement, or Distribution", dist)
+    return dist
+
+
+def load_entry_point(dist, group, name):
+    """Return `name` entry point of `group` for `dist` or raise ImportError"""
+    return get_distribution(dist).load_entry_point(group, name)
+
+
+def get_entry_map(dist, group=None):
+    """Return the entry point map for `group`, or the full entry map"""
+    return get_distribution(dist).get_entry_map(group)
+
+
+def get_entry_info(dist, group, name):
+    """Return the EntryPoint object for `group`+`name`, or ``None``"""
+    return get_distribution(dist).get_entry_info(group, name)
+
+
+class IMetadataProvider:
+    def has_metadata(name):
+        """Does the package's distribution contain the named metadata?"""
+
+    def get_metadata(name):
+        """The named metadata resource as a string"""
+
+    def get_metadata_lines(name):
+        """Yield named metadata resource as list of non-blank non-comment lines
+
+       Leading and trailing whitespace is stripped from each line, and lines
+       with ``#`` as the first non-blank character are omitted."""
+
+    def metadata_isdir(name):
+        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""
+
+    def metadata_listdir(name):
+        """List of metadata names in the directory (like ``os.listdir()``)"""
+
+    def run_script(script_name, namespace):
+        """Execute the named script in the supplied namespace dictionary"""
+
+
+class IResourceProvider(IMetadataProvider):
+    """An object that provides access to package resources"""
+
+    def get_resource_filename(manager, resource_name):
+        """Return a true filesystem path for `resource_name`
+
+        `manager` must be an ``IResourceManager``"""
+
+    def get_resource_stream(manager, resource_name):
+        """Return a readable file-like object for `resource_name`
+
+        `manager` must be an ``IResourceManager``"""
+
+    def get_resource_string(manager, resource_name):
+        """Return a string containing the contents of `resource_name`
+
+        `manager` must be an ``IResourceManager``"""
+
+    def has_resource(resource_name):
+        """Does the package contain the named resource?"""
+
+    def resource_isdir(resource_name):
+        """Is the named resource a directory?  (like ``os.path.isdir()``)"""
+
+    def resource_listdir(resource_name):
+        """List of resource names in the directory (like ``os.listdir()``)"""
+
+
+class WorkingSet:
+    """A collection of active distributions on sys.path (or a similar list)"""
+
+    def __init__(self, entries=None):
+        """Create working set from list of path entries (default=sys.path)"""
+        self.entries = []
+        self.entry_keys = {}
+        self.by_key = {}
+        self.callbacks = []
+
+        if entries is None:
+            entries = sys.path
+
+        for entry in entries:
+            self.add_entry(entry)
+
+    @classmethod
+    def _build_master(cls):
+        """
+        Prepare the master working set.
+        """
+        ws = cls()
+        try:
+            from __main__ import __requires__
+        except ImportError:
+            # The main program does not list any requirements
+            return ws
+
+        # ensure the requirements are met
+        try:
+            ws.require(__requires__)
+        except VersionConflict:
+            return cls._build_from_requirements(__requires__)
+
+        return ws
+
+    @classmethod
+    def _build_from_requirements(cls, req_spec):
+        """
+        Build a working set from a requirement spec. Rewrites sys.path.
+        """
+        # try it without defaults already on sys.path
+        # by starting with an empty path
+        ws = cls([])
+        reqs = parse_requirements(req_spec)
+        dists = ws.resolve(reqs, Environment())
+        for dist in dists:
+            ws.add(dist)
+
+        # add any missing entries from sys.path
+        for entry in sys.path:
+            if entry not in ws.entries:
+                ws.add_entry(entry)
+
+        # then copy back to sys.path
+        sys.path[:] = ws.entries
+        return ws
+
+    def add_entry(self, entry):
+        """Add a path item to ``.entries``, finding any distributions on it
+
+        ``find_distributions(entry, True)`` is used to find distributions
+        corresponding to the path entry, and they are added.  `entry` is
+        always appended to ``.entries``, even if it is already present.
+        (This is because ``sys.path`` can contain the same value more than
+        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
+        equal ``sys.path``.)
+        """
+        self.entry_keys.setdefault(entry, [])
+        self.entries.append(entry)
+        for dist in find_distributions(entry, True):
+            self.add(dist, entry, False)
+
+    def __contains__(self, dist):
+        """True if `dist` is the active distribution for its project"""
+        return self.by_key.get(dist.key) == dist
+
+    def find(self, req):
+        """Find a distribution matching requirement `req`
+
+        If there is an active distribution for the requested project, this
+        returns it as long as it meets the version requirement specified by
+        `req`.  But, if there is an active distribution for the project and it
+        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
+        If there is no active distribution for the requested project, ``None``
+        is returned.
+        """
+        dist = self.by_key.get(req.key)
+        if dist is not None and dist not in req:
+            # XXX add more info
+            raise VersionConflict(dist, req)
+        return dist
+
+    def iter_entry_points(self, group, name=None):
+        """Yield entry point objects from `group` matching `name`
+
+        If `name` is None, yields all entry points in `group` from all
+        distributions in the working set, otherwise only ones matching
+        both `group` and `name` are yielded (in distribution order).
+        """
+        return (
+            entry
+            for dist in self
+            for entry in dist.get_entry_map(group).values()
+            if name is None or name == entry.name
+        )
+
+    def run_script(self, requires, script_name):
+        """Locate distribution for `requires` and run `script_name` script"""
+        ns = sys._getframe(1).f_globals
+        name = ns['__name__']
+        ns.clear()
+        ns['__name__'] = name
+        self.require(requires)[0].run_script(script_name, ns)
+
+    def __iter__(self):
+        """Yield distributions for non-duplicate projects in the working set
+
+        The yield order is the order in which the items' path entries were
+        added to the working set.
+        """
+        seen = {}
+        for item in self.entries:
+            if item not in self.entry_keys:
+                # workaround a cache issue
+                continue
+
+            for key in self.entry_keys[item]:
+                if key not in seen:
+                    seen[key] = 1
+                    yield self.by_key[key]
+
+    def add(self, dist, entry=None, insert=True, replace=False):
+        """Add `dist` to working set, associated with `entry`
+
+        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
+        On exit from this routine, `entry` is added to the end of the working
+        set's ``.entries`` (if it wasn't already present).
+
+        `dist` is only added to the working set if it's for a project that
+        doesn't already have a distribution in the set, unless `replace=True`.
+        If it's added, any callbacks registered with the ``subscribe()`` method
+        will be called.
+        """
+        if insert:
+            dist.insert_on(self.entries, entry, replace=replace)
+
+        if entry is None:
+            entry = dist.location
+        keys = self.entry_keys.setdefault(entry, [])
+        keys2 = self.entry_keys.setdefault(dist.location, [])
+        if not replace and dist.key in self.by_key:
+            # ignore hidden distros
+            return
+
+        self.by_key[dist.key] = dist
+        if dist.key not in keys:
+            keys.append(dist.key)
+        if dist.key not in keys2:
+            keys2.append(dist.key)
+        self._added_new(dist)
+
+    def resolve(self, requirements, env=None, installer=None,
+                replace_conflicting=False, extras=None):
+        """List all distributions needed to (recursively) meet `requirements`
+
+        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
+        if supplied, should be an ``Environment`` instance.  If
+        not supplied, it defaults to all distributions available within any
+        entry or distribution in the working set.  `installer`, if supplied,
+        will be invoked with each requirement that cannot be met by an
+        already-installed distribution; it should return a ``Distribution`` or
+        ``None``.
+
+        Unless `replace_conflicting=True`, raises a VersionConflict exception
+        if
+        any requirements are found on the path that have the correct name but
+        the wrong version.  Otherwise, if an `installer` is supplied it will be
+        invoked to obtain the correct version of the requirement and activate
+        it.
+
+        `extras` is a list of the extras to be used with these requirements.
+        This is important because extra requirements may look like `my_req;
+        extra = "my_extra"`, which would otherwise be interpreted as a purely
+        optional requirement.  Instead, we want to be able to assert that these
+        requirements are truly required.
+        """
+
+        # set up the stack
+        requirements = list(requirements)[::-1]
+        # set of processed requirements
+        processed = {}
+        # key -> dist
+        best = {}
+        to_activate = []
+
+        req_extras = _ReqExtras()
+
+        # Mapping of requirement to set of distributions that required it;
+        # useful for reporting info about conflicts.
+        required_by = collections.defaultdict(set)
+
+        while requirements:
+            # process dependencies breadth-first
+            req = requirements.pop(0)
+            if req in processed:
+                # Ignore cyclic or redundant dependencies
+                continue
+
+            if not req_extras.markers_pass(req, extras):
+                continue
+
+            dist = best.get(req.key)
+            if dist is None:
+                # Find the best distribution and add it to the map
+                dist = self.by_key.get(req.key)
+                if dist is None or (dist not in req and replace_conflicting):
+                    ws = self
+                    if env is None:
+                        if dist is None:
+                            env = Environment(self.entries)
+                        else:
+                            # Use an empty environment and workingset to avoid
+                            # any further conflicts with the conflicting
+                            # distribution
+                            env = Environment([])
+                            ws = WorkingSet([])
+                    dist = best[req.key] = env.best_match(
+                        req, ws, installer,
+                        replace_conflicting=replace_conflicting
+                    )
+                    if dist is None:
+                        requirers = required_by.get(req, None)
+                        raise DistributionNotFound(req, requirers)
+                to_activate.append(dist)
+            if dist not in req:
+                # Oops, the "best" so far conflicts with a dependency
+                dependent_req = required_by[req]
+                raise VersionConflict(dist, req).with_context(dependent_req)
+
+            # push the new requirements onto the stack
+            new_requirements = dist.requires(req.extras)[::-1]
+            requirements.extend(new_requirements)
+
+            # Register the new requirements needed by req
+            for new_requirement in new_requirements:
+                required_by[new_requirement].add(req.project_name)
+                req_extras[new_requirement] = req.extras
+
+            processed[req] = True
+
+        # return list of distros to activate
+        return to_activate
+
+    def find_plugins(
+            self, plugin_env, full_env=None, installer=None, fallback=True):
+        """Find all activatable distributions in `plugin_env`
+
+        Example usage::
+
+            distributions, errors = working_set.find_plugins(
+                Environment(plugin_dirlist)
+            )
+            # add plugins+libs to sys.path
+            map(working_set.add, distributions)
+            # display errors
+            print('Could not load', errors)
+
+        The `plugin_env` should be an ``Environment`` instance that contains
+        only distributions that are in the project's "plugin directory" or
+        directories. The `full_env`, if supplied, should be an ``Environment``
+        contains all currently-available distributions.  If `full_env` is not
+        supplied, one is created automatically from the ``WorkingSet`` this
+        method is called on, which will typically mean that every directory on
+        ``sys.path`` will be scanned for distributions.
+
+        `installer` is a standard installer callback as used by the
+        ``resolve()`` method. The `fallback` flag indicates whether we should
+        attempt to resolve older versions of a plugin if the newest version
+        cannot be resolved.
+
+        This method returns a 2-tuple: (`distributions`, `error_info`), where
+        `distributions` is a list of the distributions found in `plugin_env`
+        that were loadable, along with any other distributions that are needed
+        to resolve their dependencies.  `error_info` is a dictionary mapping
+        unloadable plugin distributions to an exception instance describing the
+        error that occurred. Usually this will be a ``DistributionNotFound`` or
+        ``VersionConflict`` instance.
+        """
+
+        plugin_projects = list(plugin_env)
+        # scan project names in alphabetic order
+        plugin_projects.sort()
+
+        error_info = {}
+        distributions = {}
+
+        if full_env is None:
+            env = Environment(self.entries)
+            env += plugin_env
+        else:
+            env = full_env + plugin_env
+
+        shadow_set = self.__class__([])
+        # put all our entries in shadow_set
+        list(map(shadow_set.add, self))
+
+        for project_name in plugin_projects:
+
+            for dist in plugin_env[project_name]:
+
+                req = [dist.as_requirement()]
+
+                try:
+                    resolvees = shadow_set.resolve(req, env, installer)
+
+                except ResolutionError as v:
+                    # save error info
+                    error_info[dist] = v
+                    if fallback:
+                        # try the next older version of project
+                        continue
+                    else:
+                        # give up on this project, keep going
+                        break
+
+                else:
+                    list(map(shadow_set.add, resolvees))
+                    distributions.update(dict.fromkeys(resolvees))
+
+                    # success, no need to try any more versions of this project
+                    break
+
+        distributions = list(distributions)
+        distributions.sort()
+
+        return distributions, error_info
+
+    def require(self, *requirements):
+        """Ensure that distributions matching `requirements` are activated
+
+        `requirements` must be a string or a (possibly-nested) sequence
+        thereof, specifying the distributions and versions required.  The
+        return value is a sequence of the distributions that needed to be
+        activated to fulfill the requirements; all relevant distributions are
+        included, even if they were already activated in this working set.
+        """
+        needed = self.resolve(parse_requirements(requirements))
+
+        for dist in needed:
+            self.add(dist)
+
+        return needed
+
+    def subscribe(self, callback, existing=True):
+        """Invoke `callback` for all distributions
+
+        If `existing=True` (default),
+        call on all existing ones, as well.
+        """
+        if callback in self.callbacks:
+            return
+        self.callbacks.append(callback)
+        if not existing:
+            return
+        for dist in self:
+            callback(dist)
+
+    def _added_new(self, dist):
+        for callback in self.callbacks:
+            callback(dist)
+
+    def __getstate__(self):
+        return (
+            self.entries[:], self.entry_keys.copy(), self.by_key.copy(),
+            self.callbacks[:]
+        )
+
+    def __setstate__(self, e_k_b_c):
+        entries, keys, by_key, callbacks = e_k_b_c
+        self.entries = entries[:]
+        self.entry_keys = keys.copy()
+        self.by_key = by_key.copy()
+        self.callbacks = callbacks[:]
+
+
+class _ReqExtras(dict):
+    """
+    Map each requirement to the extras that demanded it.
+    """
+
+    def markers_pass(self, req, extras=None):
+        """
+        Evaluate markers for req against each extra that
+        demanded it.
+
+        Return False if the req has a marker and fails
+        evaluation. Otherwise, return True.
+        """
+        extra_evals = (
+            req.marker.evaluate({'extra': extra})
+            for extra in self.get(req, ()) + (extras or (None,))
+        )
+        return not req.marker or any(extra_evals)
+
+
+class Environment:
+    """Searchable snapshot of distributions on a search path"""
+
+    def __init__(
+            self, search_path=None, platform=get_supported_platform(),
+            python=PY_MAJOR):
+        """Snapshot distributions available on a search path
+
+        Any distributions found on `search_path` are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.
+
+        `platform` is an optional string specifying the name of the platform
+        that platform-specific distributions must be compatible with.  If
+        unspecified, it defaults to the current platform.  `python` is an
+        optional string naming the desired version of Python (e.g. ``'3.6'``);
+        it defaults to the current version.
+
+        You may explicitly set `platform` (and/or `python`) to ``None`` if you
+        wish to map *all* distributions, not just those compatible with the
+        running platform or Python version.
+        """
+        self._distmap = {}
+        self.platform = platform
+        self.python = python
+        self.scan(search_path)
+
+    def can_add(self, dist):
+        """Is distribution `dist` acceptable for this environment?
+
+        The distribution must match the platform and python version
+        requirements specified when this environment was created, or False
+        is returned.
+        """
+        py_compat = (
+            self.python is None
+            or dist.py_version is None
+            or dist.py_version == self.python
+        )
+        return py_compat and compatible_platforms(dist.platform, self.platform)
+
+    def remove(self, dist):
+        """Remove `dist` from the environment"""
+        self._distmap[dist.key].remove(dist)
+
+    def scan(self, search_path=None):
+        """Scan `search_path` for distributions usable in this environment
+
+        Any distributions found are added to the environment.
+        `search_path` should be a sequence of ``sys.path`` items.  If not
+        supplied, ``sys.path`` is used.  Only distributions conforming to
+        the platform/python version defined at initialization are added.
+        """
+        if search_path is None:
+            search_path = sys.path
+
+        for item in search_path:
+            for dist in find_distributions(item):
+                self.add(dist)
+
+    def __getitem__(self, project_name):
+        """Return a newest-to-oldest list of distributions for `project_name`
+
+        Uses case-insensitive `project_name` comparison, assuming all the
+        project's distributions use their project's name converted to all
+        lowercase as their key.
+
+        """
+        distribution_key = project_name.lower()
+        return self._distmap.get(distribution_key, [])
+
+    def add(self, dist):
+        """Add `dist` if we ``can_add()`` it and it has not already been added
+        """
+        if self.can_add(dist) and dist.has_version():
+            dists = self._distmap.setdefault(dist.key, [])
+            if dist not in dists:
+                dists.append(dist)
+                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)
+
+    def best_match(
+            self, req, working_set, installer=None, replace_conflicting=False):
+        """Find distribution best matching `req` and usable on `working_set`
+
+        This calls the ``find(req)`` method of the `working_set` to see if a
+        suitable distribution is already active.  (This may raise
+        ``VersionConflict`` if an unsuitable version of the project is already
+        active in the specified `working_set`.)  If a suitable distribution
+        isn't active, this method returns the newest distribution in the
+        environment that meets the ``Requirement`` in `req`.  If no suitable
+        distribution is found, and `installer` is supplied, then the result of
+        calling the environment's ``obtain(req, installer)`` method will be
+        returned.
+        """
+        try:
+            dist = working_set.find(req)
+        except VersionConflict:
+            if not replace_conflicting:
+                raise
+            dist = None
+        if dist is not None:
+            return dist
+        for dist in self[req.key]:
+            if dist in req:
+                return dist
+        # try to download/install
+        return self.obtain(req, installer)
+
+    def obtain(self, requirement, installer=None):
+        """Obtain a distribution matching `requirement` (e.g. via download)
+
+        Obtain a distro that matches requirement (e.g. via download).  In the
+        base ``Environment`` class, this routine just returns
+        ``installer(requirement)``, unless `installer` is None, in which case
+        None is returned instead.  This method is a hook that allows subclasses
+        to attempt other ways of obtaining a distribution before falling back
+        to the `installer` argument."""
+        if installer is not None:
+            return installer(requirement)
+
+    def __iter__(self):
+        """Yield the unique project names of the available distributions"""
+        for key in self._distmap.keys():
+            if self[key]:
+                yield key
+
+    def __iadd__(self, other):
+        """In-place addition of a distribution or environment"""
+        if isinstance(other, Distribution):
+            self.add(other)
+        elif isinstance(other, Environment):
+            for project in other:
+                for dist in other[project]:
+                    self.add(dist)
+        else:
+            raise TypeError("Can't add %r to environment" % (other,))
+        return self
+
+    def __add__(self, other):
+        """Add an environment or distribution to an environment"""
+        new = self.__class__([], platform=None, python=None)
+        for env in self, other:
+            new += env
+        return new
+
+
+# XXX backward compatibility
+AvailableDistributions = Environment
+
+
+class ExtractionError(RuntimeError):
+    """An error occurred extracting a resource
+
+    The following attributes are available from instances of this exception:
+
+    manager
+        The resource manager that raised this exception
+
+    cache_path
+        The base directory for resource extraction
+
+    original_error
+        The exception instance that caused extraction to fail
+    """
+
+
+class ResourceManager:
+    """Manage resource extraction and packages"""
+    extraction_path = None
+
+    def __init__(self):
+        self.cached_files = {}
+
+    def resource_exists(self, package_or_requirement, resource_name):
+        """Does the named resource exist?"""
+        return get_provider(package_or_requirement).has_resource(resource_name)
+
+    def resource_isdir(self, package_or_requirement, resource_name):
+        """Is the named resource an existing directory?"""
+        return get_provider(package_or_requirement).resource_isdir(
+            resource_name
+        )
+
+    def resource_filename(self, package_or_requirement, resource_name):
+        """Return a true filesystem path for specified resource"""
+        return get_provider(package_or_requirement).get_resource_filename(
+            self, resource_name
+        )
+
+    def resource_stream(self, package_or_requirement, resource_name):
+        """Return a readable file-like object for specified resource"""
+        return get_provider(package_or_requirement).get_resource_stream(
+            self, resource_name
+        )
+
+    def resource_string(self, package_or_requirement, resource_name):
+        """Return specified resource as a string"""
+        return get_provider(package_or_requirement).get_resource_string(
+            self, resource_name
+        )
+
+    def resource_listdir(self, package_or_requirement, resource_name):
+        """List the contents of the named resource directory"""
+        return get_provider(package_or_requirement).resource_listdir(
+            resource_name
+        )
+
+    def extraction_error(self):
+        """Give an error message for problems extracting file(s)"""
+
+        old_exc = sys.exc_info()[1]
+        cache_path = self.extraction_path or get_default_cache()
+
+        tmpl = textwrap.dedent("""
+            Can't extract file(s) to egg cache
+
+            The following error occurred while trying to extract file(s)
+            to the Python egg cache:
+
+              {old_exc}
+
+            The Python egg cache directory is currently set to:
+
+              {cache_path}
+
+            Perhaps your account does not have write access to this directory?
+            You can change the cache directory by setting the PYTHON_EGG_CACHE
+            environment variable to point to an accessible directory.
+            """).lstrip()
+        err = ExtractionError(tmpl.format(**locals()))
+        err.manager = self
+        err.cache_path = cache_path
+        err.original_error = old_exc
+        raise err
+
+    def get_cache_path(self, archive_name, names=()):
+        """Return absolute location in cache for `archive_name` and `names`
+
+        The parent directory of the resulting path will be created if it does
+        not already exist.  `archive_name` should be the base filename of the
+        enclosing egg (which may not be the name of the enclosing zipfile!),
+        including its ".egg" extension.  `names`, if provided, should be a
+        sequence of path name parts "under" the egg's extraction location.
+
+        This method should only be called by resource providers that need to
+        obtain an extraction location, and only for names they intend to
+        extract, as it tracks the generated names for possible cleanup later.
+        """
+        extract_path = self.extraction_path or get_default_cache()
+        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
+        try:
+            _bypass_ensure_directory(target_path)
+        except Exception:
+            self.extraction_error()
+
+        self._warn_unsafe_extraction_path(extract_path)
+
+        self.cached_files[target_path] = 1
+        return target_path
+
+    @staticmethod
+    def _warn_unsafe_extraction_path(path):
+        """
+        If the default extraction path is overridden and set to an insecure
+        location, such as /tmp, it opens up an opportunity for an attacker to
+        replace an extracted file with an unauthorized payload. Warn the user
+        if a known insecure location is used.
+
+        See Distribute #375 for more details.
+        """
+        if os.name == 'nt' and not path.startswith(os.environ['windir']):
+            # On Windows, permissions are generally restrictive by default
+            #  and temp directories are not writable by other users, so
+            #  bypass the warning.
+            return
+        mode = os.stat(path).st_mode
+        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
+            msg = (
+                "%s is writable by group/others and vulnerable to attack "
+                "when "
+                "used with get_resource_filename. Consider a more secure "
+                "location (set with .set_extraction_path or the "
+                "PYTHON_EGG_CACHE environment variable)." % path
+            )
+            warnings.warn(msg, UserWarning)
+
+    def postprocess(self, tempname, filename):
+        """Perform any platform-specific postprocessing of `tempname`
+
+        This is where Mac header rewrites should be done; other platforms don't
+        have anything special they should do.
+
+        Resource providers should call this method ONLY after successfully
+        extracting a compressed resource.  They must NOT call it on resources
+        that are already in the filesystem.
+
+        `tempname` is the current (temporary) name of the file, and `filename`
+        is the name it will be renamed to by the caller after this routine
+        returns.
+        """
+
+        if os.name == 'posix':
+            # Make the resource executable
+            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
+            os.chmod(tempname, mode)
+
+    def set_extraction_path(self, path):
+        """Set the base path where resources will be extracted to, if needed.
+
+        If you do not call this routine before any extractions take place, the
+        path defaults to the return value of ``get_default_cache()``.  (Which
+        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
+        platform-specific fallbacks.  See that routine's documentation for more
+        details.)
+
+        Resources are extracted to subdirectories of this path based upon
+        information given by the ``IResourceProvider``.  You may set this to a
+        temporary directory, but then you must call ``cleanup_resources()`` to
+        delete the extracted files when done.  There is no guarantee that
+        ``cleanup_resources()`` will be able to remove all extracted files.
+
+        (Note: you may not change the extraction path for a given resource
+        manager once resources have been extracted, unless you first call
+        ``cleanup_resources()``.)
+        """
+        if self.cached_files:
+            raise ValueError(
+                "Can't change extraction path, files already extracted"
+            )
+
+        self.extraction_path = path
+
+    def cleanup_resources(self, force=False):
+        """
+        Delete all extracted resource files and directories, returning a list
+        of the file and directory names that could not be successfully removed.
+        This function does not have any concurrency protection, so it should
+        generally only be called when the extraction path is a temporary
+        directory exclusive to a single process.  This method is not
+        automatically called; you must call it explicitly or register it as an
+        ``atexit`` function if you wish to ensure cleanup of a temporary
+        directory used for extractions.
+        """
+        # XXX
+
+
+def get_default_cache():
+    """
+    Return the ``PYTHON_EGG_CACHE`` environment variable
+    or a platform-relevant user cache dir for an app
+    named "Python-Eggs".
+    """
+    return (
+        os.environ.get('PYTHON_EGG_CACHE')
+        or appdirs.user_cache_dir(appname='Python-Eggs')
+    )
+
+
+def safe_name(name):
+    """Convert an arbitrary string to a standard distribution name
+
+    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
+    """
+    return re.sub('[^A-Za-z0-9.]+', '-', name)
+
+
+def safe_version(version):
+    """
+    Convert an arbitrary string to a standard version string
+    """
+    try:
+        # normalize the version
+        return str(packaging.version.Version(version))
+    except packaging.version.InvalidVersion:
+        version = version.replace(' ', '.')
+        return re.sub('[^A-Za-z0-9.]+', '-', version)
+
+
+def safe_extra(extra):
+    """Convert an arbitrary string to a standard 'extra' name
+
+    Any runs of non-alphanumeric characters are replaced with a single '_',
+    and the result is always lowercased.
+    """
+    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()
+
+
+def to_filename(name):
+    """Convert a project or version name to its filename-escaped form
+
+    Any '-' characters are currently replaced with '_'.
+    """
+    return name.replace('-', '_')
+
+
+def invalid_marker(text):
+    """
+    Validate text as a PEP 508 environment marker; return an exception
+    if invalid or False otherwise.
+    """
+    try:
+        evaluate_marker(text)
+    except SyntaxError as e:
+        e.filename = None
+        e.lineno = None
+        return e
+    return False
+
+
+def evaluate_marker(text, extra=None):
+    """
+    Evaluate a PEP 508 environment marker.
+    Return a boolean indicating the marker result in this environment.
+    Raise SyntaxError if marker is invalid.
+
+    This implementation uses the 'pyparsing' module.
+    """
+    try:
+        marker = packaging.markers.Marker(text)
+        return marker.evaluate()
+    except packaging.markers.InvalidMarker as e:
+        raise SyntaxError(e)
+
+
+class NullProvider:
+    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""
+
+    egg_name = None
+    egg_info = None
+    loader = None
+
+    def __init__(self, module):
+        self.loader = getattr(module, '__loader__', None)
+        self.module_path = os.path.dirname(getattr(module, '__file__', ''))
+
+    def get_resource_filename(self, manager, resource_name):
+        return self._fn(self.module_path, resource_name)
+
+    def get_resource_stream(self, manager, resource_name):
+        return io.BytesIO(self.get_resource_string(manager, resource_name))
+
+    def get_resource_string(self, manager, resource_name):
+        return self._get(self._fn(self.module_path, resource_name))
+
+    def has_resource(self, resource_name):
+        return self._has(self._fn(self.module_path, resource_name))
+
+    def _get_metadata_path(self, name):
+        return self._fn(self.egg_info, name)
+
+    def has_metadata(self, name):
+        if not self.egg_info:
+            return self.egg_info
+
+        path = self._get_metadata_path(name)
+        return self._has(path)
+
+    def get_metadata(self, name):
+        if not self.egg_info:
+            return ""
+        path = self._get_metadata_path(name)
+        value = self._get(path)
+        if six.PY2:
+            return value
+        try:
+            return value.decode('utf-8')
+        except UnicodeDecodeError as exc:
+            # Include the path in the error message to simplify
+            # troubleshooting, and without changing the exception type.
+            exc.reason += ' in {} file at path: {}'.format(name, path)
+            raise
+
+    def get_metadata_lines(self, name):
+        return yield_lines(self.get_metadata(name))
+
+    def resource_isdir(self, resource_name):
+        return self._isdir(self._fn(self.module_path, resource_name))
+
+    def metadata_isdir(self, name):
+        return self.egg_info and self._isdir(self._fn(self.egg_info, name))
+
+    def resource_listdir(self, resource_name):
+        return self._listdir(self._fn(self.module_path, resource_name))
+
+    def metadata_listdir(self, name):
+        if self.egg_info:
+            return self._listdir(self._fn(self.egg_info, name))
+        return []
+
+    def run_script(self, script_name, namespace):
+        script = 'scripts/' + script_name
+        if not self.has_metadata(script):
+            raise ResolutionError(
+                "Script {script!r} not found in metadata at {self.egg_info!r}"
+                .format(**locals()),
+            )
+        script_text = self.get_metadata(script).replace('\r\n', '\n')
+        script_text = script_text.replace('\r', '\n')
+        script_filename = self._fn(self.egg_info, script)
+        namespace['__file__'] = script_filename
+        if os.path.exists(script_filename):
+            source = open(script_filename).read()
+            code = compile(source, script_filename, 'exec')
+            exec(code, namespace, namespace)
+        else:
+            from linecache import cache
+            cache[script_filename] = (
+                len(script_text), 0, script_text.split('\n'), script_filename
+            )
+            script_code = compile(script_text, script_filename, 'exec')
+            exec(script_code, namespace, namespace)
+
+    def _has(self, path):
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _isdir(self, path):
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _listdir(self, path):
+        raise NotImplementedError(
+            "Can't perform this operation for unregistered loader type"
+        )
+
+    def _fn(self, base, resource_name):
+        self._validate_resource_path(resource_name)
+        if resource_name:
+            return os.path.join(base, *resource_name.split('/'))
+        return base
+
+    @staticmethod
+    def _validate_resource_path(path):
+        """
+        Validate the resource paths according to the docs.
+        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access
+
+        >>> warned = getfixture('recwarn')
+        >>> warnings.simplefilter('always')
+        >>> vrp = NullProvider._validate_resource_path
+        >>> vrp('foo/bar.txt')
+        >>> bool(warned)
+        False
+        >>> vrp('../foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('/foo/bar.txt')
+        >>> bool(warned)
+        True
+        >>> vrp('foo/../../bar.txt')
+        >>> bool(warned)
+        True
+        >>> warned.clear()
+        >>> vrp('foo/f../bar.txt')
+        >>> bool(warned)
+        False
+
+        Windows path separators are straight-up disallowed.
+        >>> vrp(r'\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        >>> vrp(r'C:\\foo/bar.txt')
+        Traceback (most recent call last):
+        ...
+        ValueError: Use of .. or absolute path in a resource path \
+is not allowed.
+
+        Blank values are allowed
+
+        >>> vrp('')
+        >>> bool(warned)
+        False
+
+        Non-string values are not.
+
+        >>> vrp(None)
+        Traceback (most recent call last):
+        ...
+        AttributeError: ...
+        """
+        invalid = (
+            os.path.pardir in path.split(posixpath.sep) or
+            posixpath.isabs(path) or
+            ntpath.isabs(path)
+        )
+        if not invalid:
+            return
+
+        msg = "Use of .. or absolute path in a resource path is not allowed."
+
+        # Aggressively disallow Windows absolute paths
+        if ntpath.isabs(path) and not posixpath.isabs(path):
+            raise ValueError(msg)
+
+        # for compatibility, warn; in future
+        # raise ValueError(msg)
+        warnings.warn(
+            msg[:-1] + " and will raise exceptions in a future release.",
+            DeprecationWarning,
+            stacklevel=4,
+        )
+
+    def _get(self, path):
+        if hasattr(self.loader, 'get_data'):
+            return self.loader.get_data(path)
+        raise NotImplementedError(
+            "Can't perform this operation for loaders without 'get_data()'"
+        )
+
+
+register_loader_type(object, NullProvider)
+
+
+class EggProvider(NullProvider):
+    """Provider based on a virtual filesystem"""
+
+    def __init__(self, module):
+        NullProvider.__init__(self, module)
+        self._setup_prefix()
+
+    def _setup_prefix(self):
+        # we assume here that our metadata may be nested inside a "basket"
+        # of multiple eggs; that's why we use module_path instead of .archive
+        path = self.module_path
+        old = None
+        while path != old:
+            if _is_egg_path(path):
+                self.egg_name = os.path.basename(path)
+                self.egg_info = os.path.join(path, 'EGG-INFO')
+                self.egg_root = path
+                break
+            old = path
+            path, base = os.path.split(path)
+
+
+class DefaultProvider(EggProvider):
+    """Provides access to package resources in the filesystem"""
+
+    def _has(self, path):
+        return os.path.exists(path)
+
+    def _isdir(self, path):
+        return os.path.isdir(path)
+
+    def _listdir(self, path):
+        return os.listdir(path)
+
+    def get_resource_stream(self, manager, resource_name):
+        return open(self._fn(self.module_path, resource_name), 'rb')
+
+    def _get(self, path):
+        with open(path, 'rb') as stream:
+            return stream.read()
+
+    @classmethod
+    def _register(cls):
+        loader_names = 'SourceFileLoader', 'SourcelessFileLoader',
+        for name in loader_names:
+            loader_cls = getattr(importlib_machinery, name, type(None))
+            register_loader_type(loader_cls, cls)
+
+
+DefaultProvider._register()
+
+
+class EmptyProvider(NullProvider):
+    """Provider that returns nothing for all requests"""
+
+    module_path = None
+
+    _isdir = _has = lambda self, path: False
+
+    def _get(self, path):
+        return ''
+
+    def _listdir(self, path):
+        return []
+
+    def __init__(self):
+        pass
+
+
+empty_provider = EmptyProvider()
+
+
+class ZipManifests(dict):
+    """
+    zip manifest builder
+    """
+
+    @classmethod
+    def build(cls, path):
+        """
+        Build a dictionary similar to the zipimport directory
+        caches, except instead of tuples, store ZipInfo objects.
+
+        Use a platform-specific path separator (os.sep) for the path keys
+        for compatibility with pypy on Windows.
+        """
+        with zipfile.ZipFile(path) as zfile:
+            items = (
+                (
+                    name.replace('/', os.sep),
+                    zfile.getinfo(name),
+                )
+                for name in zfile.namelist()
+            )
+            return dict(items)
+
+    load = build
+
+
+class MemoizedZipManifests(ZipManifests):
+    """
+    Memoized zipfile manifests.
+    """
+    manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime')
+
+    def load(self, path):
+        """
+        Load a manifest at path or return a suitable manifest already loaded.
+        """
+        path = os.path.normpath(path)
+        mtime = os.stat(path).st_mtime
+
+        if path not in self or self[path].mtime != mtime:
+            manifest = self.build(path)
+            self[path] = self.manifest_mod(manifest, mtime)
+
+        return self[path].manifest
+
+
+class ZipProvider(EggProvider):
+    """Resource support for zips and eggs"""
+
+    eagers = None
+    _zip_manifests = MemoizedZipManifests()
+
+    def __init__(self, module):
+        EggProvider.__init__(self, module)
+        self.zip_pre = self.loader.archive + os.sep
+
+    def _zipinfo_name(self, fspath):
+        # Convert a virtual filename (full path to file) into a zipfile subpath
+        # usable with the zipimport directory cache for our target archive
+        fspath = fspath.rstrip(os.sep)
+        if fspath == self.loader.archive:
+            return ''
+        if fspath.startswith(self.zip_pre):
+            return fspath[len(self.zip_pre):]
+        raise AssertionError(
+            "%s is not a subpath of %s" % (fspath, self.zip_pre)
+        )
+
+    def _parts(self, zip_path):
+        # Convert a zipfile subpath into an egg-relative path part list.
+        # pseudo-fs path
+        fspath = self.zip_pre + zip_path
+        if fspath.startswith(self.egg_root + os.sep):
+            return fspath[len(self.egg_root) + 1:].split(os.sep)
+        raise AssertionError(
+            "%s is not a subpath of %s" % (fspath, self.egg_root)
+        )
+
+    @property
+    def zipinfo(self):
+        return self._zip_manifests.load(self.loader.archive)
+
+    def get_resource_filename(self, manager, resource_name):
+        if not self.egg_name:
+            raise NotImplementedError(
+                "resource_filename() only supported for .egg, not .zip"
+            )
+        # no need to lock for extraction, since we use temp names
+        zip_path = self._resource_to_zip(resource_name)
+        eagers = self._get_eager_resources()
+        if '/'.join(self._parts(zip_path)) in eagers:
+            for name in eagers:
+                self._extract_resource(manager, self._eager_to_zip(name))
+        return self._extract_resource(manager, zip_path)
+
+    @staticmethod
+    def _get_date_and_size(zip_stat):
+        size = zip_stat.file_size
+        # ymdhms+wday, yday, dst
+        date_time = zip_stat.date_time + (0, 0, -1)
+        # 1980 offset already done
+        timestamp = time.mktime(date_time)
+        return timestamp, size
+
+    def _extract_resource(self, manager, zip_path):
+
+        if zip_path in self._index():
+            for name in self._index()[zip_path]:
+                last = self._extract_resource(
+                    manager, os.path.join(zip_path, name)
+                )
+            # return the extracted directory name
+            return os.path.dirname(last)
+
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+
+        if not WRITE_SUPPORT:
+            raise IOError('"os.rename" and "os.unlink" are not supported '
+                          'on this platform')
+        try:
+
+            real_path = manager.get_cache_path(
+                self.egg_name, self._parts(zip_path)
+            )
+
+            if self._is_current(real_path, zip_path):
+                return real_path
+
+            outf, tmpnam = _mkstemp(
+                ".$extract",
+                dir=os.path.dirname(real_path),
+            )
+            os.write(outf, self.loader.get_data(zip_path))
+            os.close(outf)
+            utime(tmpnam, (timestamp, timestamp))
+            manager.postprocess(tmpnam, real_path)
+
+            try:
+                rename(tmpnam, real_path)
+
+            except os.error:
+                if os.path.isfile(real_path):
+                    if self._is_current(real_path, zip_path):
+                        # the file became current since it was checked above,
+                        #  so proceed.
+                        return real_path
+                    # Windows, del old file and retry
+                    elif os.name == 'nt':
+                        unlink(real_path)
+                        rename(tmpnam, real_path)
+                        return real_path
+                raise
+
+        except os.error:
+            # report a user-friendly error
+            manager.extraction_error()
+
+        return real_path
+
+    def _is_current(self, file_path, zip_path):
+        """
+        Return True if the file_path is current for this zip_path
+        """
+        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
+        if not os.path.isfile(file_path):
+            return False
+        stat = os.stat(file_path)
+        if stat.st_size != size or stat.st_mtime != timestamp:
+            return False
+        # check that the contents match
+        zip_contents = self.loader.get_data(zip_path)
+        with open(file_path, 'rb') as f:
+            file_contents = f.read()
+        return zip_contents == file_contents
+
+    def _get_eager_resources(self):
+        if self.eagers is None:
+            eagers = []
+            for name in ('native_libs.txt', 'eager_resources.txt'):
+                if self.has_metadata(name):
+                    eagers.extend(self.get_metadata_lines(name))
+            self.eagers = eagers
+        return self.eagers
+
+    def _index(self):
+        try:
+            return self._dirindex
+        except AttributeError:
+            ind = {}
+            for path in self.zipinfo:
+                parts = path.split(os.sep)
+                while parts:
+                    parent = os.sep.join(parts[:-1])
+                    if parent in ind:
+                        ind[parent].append(parts[-1])
+                        break
+                    else:
+                        ind[parent] = [parts.pop()]
+            self._dirindex = ind
+            return ind
+
+    def _has(self, fspath):
+        zip_path = self._zipinfo_name(fspath)
+        return zip_path in self.zipinfo or zip_path in self._index()
+
+    def _isdir(self, fspath):
+        return self._zipinfo_name(fspath) in self._index()
+
+    def _listdir(self, fspath):
+        return list(self._index().get(self._zipinfo_name(fspath), ()))
+
+    def _eager_to_zip(self, resource_name):
+        return self._zipinfo_name(self._fn(self.egg_root, resource_name))
+
+    def _resource_to_zip(self, resource_name):
+        return self._zipinfo_name(self._fn(self.module_path, resource_name))
+
+
+register_loader_type(zipimport.zipimporter, ZipProvider)
+
+
+class FileMetadata(EmptyProvider):
+    """Metadata handler for standalone PKG-INFO files
+
+    Usage::
+
+        metadata = FileMetadata("/path/to/PKG-INFO")
+
+    This provider rejects all data and metadata requests except for PKG-INFO,
+    which is treated as existing, and will be the contents of the file at
+    the provided location.
+    """
+
+    def __init__(self, path):
+        self.path = path
+
+    def _get_metadata_path(self, name):
+        return self.path
+
+    def has_metadata(self, name):
+        return name == 'PKG-INFO' and os.path.isfile(self.path)
+
+    def get_metadata(self, name):
+        if name != 'PKG-INFO':
+            raise KeyError("No metadata except PKG-INFO is available")
+
+        with io.open(self.path, encoding='utf-8', errors="replace") as f:
+            metadata = f.read()
+        self._warn_on_replacement(metadata)
+        return metadata
+
+    def _warn_on_replacement(self, metadata):
+        # Python 2.7 compat for: replacement_char = '�'
+        replacement_char = b'\xef\xbf\xbd'.decode('utf-8')
+        if replacement_char in metadata:
+            tmpl = "{self.path} could not be properly decoded in UTF-8"
+            msg = tmpl.format(**locals())
+            warnings.warn(msg)
+
+    def get_metadata_lines(self, name):
+        return yield_lines(self.get_metadata(name))
+
+
+class PathMetadata(DefaultProvider):
+    """Metadata provider for egg directories
+
+    Usage::
+
+        # Development eggs:
+
+        egg_info = "/path/to/PackageName.egg-info"
+        base_dir = os.path.dirname(egg_info)
+        metadata = PathMetadata(base_dir, egg_info)
+        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
+        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)
+
+        # Unpacked egg directories:
+
+        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
+        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
+        dist = Distribution.from_filename(egg_path, metadata=metadata)
+    """
+
+    def __init__(self, path, egg_info):
+        self.module_path = path
+        self.egg_info = egg_info
+
+
+class EggMetadata(ZipProvider):
+    """Metadata provider for .egg files"""
+
+    def __init__(self, importer):
+        """Create a metadata provider from a zipimporter"""
+
+        self.zip_pre = importer.archive + os.sep
+        self.loader = importer
+        if importer.prefix:
+            self.module_path = os.path.join(importer.archive, importer.prefix)
+        else:
+            self.module_path = importer.archive
+        self._setup_prefix()
+
+
+_declare_state('dict', _distribution_finders={})
+
+
+def register_finder(importer_type, distribution_finder):
+    """Register `distribution_finder` to find distributions in sys.path items
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `distribution_finder` is a callable that, passed a path
+    item and the importer instance, yields ``Distribution`` instances found on
+    that path item.  See ``pkg_resources.find_on_path`` for an example."""
+    _distribution_finders[importer_type] = distribution_finder
+
+
+def find_distributions(path_item, only=False):
+    """Yield distributions accessible via `path_item`"""
+    importer = get_importer(path_item)
+    finder = _find_adapter(_distribution_finders, importer)
+    return finder(importer, path_item, only)
+
+
+def find_eggs_in_zip(importer, path_item, only=False):
+    """
+    Find eggs in zip files; possibly multiple nested eggs.
+    """
+    if importer.archive.endswith('.whl'):
+        # wheels are not supported with this finder
+        # they don't have PKG-INFO metadata, and won't ever contain eggs
+        return
+    metadata = EggMetadata(importer)
+    if metadata.has_metadata('PKG-INFO'):
+        yield Distribution.from_filename(path_item, metadata=metadata)
+    if only:
+        # don't yield nested distros
+        return
+    for subitem in metadata.resource_listdir(''):
+        if _is_egg_path(subitem):
+            subpath = os.path.join(path_item, subitem)
+            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
+            for dist in dists:
+                yield dist
+        elif subitem.lower().endswith('.dist-info'):
+            subpath = os.path.join(path_item, subitem)
+            submeta = EggMetadata(zipimport.zipimporter(subpath))
+            submeta.egg_info = subpath
+            yield Distribution.from_location(path_item, subitem, submeta)
+
+
+register_finder(zipimport.zipimporter, find_eggs_in_zip)
+
+
+def find_nothing(importer, path_item, only=False):
+    return ()
+
+
+register_finder(object, find_nothing)
+
+
+def _by_version_descending(names):
+    """
+    Given a list of filenames, return them in descending order
+    by version number.
+
+    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
+    >>> _by_version_descending(names)
+    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
+    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
+    >>> _by_version_descending(names)
+    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
+    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
+    >>> _by_version_descending(names)
+    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
+    """
+    def _by_version(name):
+        """
+        Parse each component of the filename
+        """
+        name, ext = os.path.splitext(name)
+        parts = itertools.chain(name.split('-'), [ext])
+        return [packaging.version.parse(part) for part in parts]
+
+    return sorted(names, key=_by_version, reverse=True)
+
+
+def find_on_path(importer, path_item, only=False):
+    """Yield distributions accessible on a sys.path directory"""
+    path_item = _normalize_cached(path_item)
+
+    if _is_unpacked_egg(path_item):
+        yield Distribution.from_filename(
+            path_item, metadata=PathMetadata(
+                path_item, os.path.join(path_item, 'EGG-INFO')
+            )
+        )
+        return
+
+    entries = safe_listdir(path_item)
+
+    # for performance, before sorting by version,
+    # screen entries for only those that will yield
+    # distributions
+    filtered = (
+        entry
+        for entry in entries
+        if dist_factory(path_item, entry, only)
+    )
+
+    # scan for .egg and .egg-info in directory
+    path_item_entries = _by_version_descending(filtered)
+    for entry in path_item_entries:
+        fullpath = os.path.join(path_item, entry)
+        factory = dist_factory(path_item, entry, only)
+        for dist in factory(fullpath):
+            yield dist
+
+
+def dist_factory(path_item, entry, only):
+    """
+    Return a dist_factory for a path_item and entry
+    """
+    lower = entry.lower()
+    is_meta = any(map(lower.endswith, ('.egg-info', '.dist-info')))
+    return (
+        distributions_from_metadata
+        if is_meta else
+        find_distributions
+        if not only and _is_egg_path(entry) else
+        resolve_egg_link
+        if not only and lower.endswith('.egg-link') else
+        NoDists()
+    )
+
+
+class NoDists:
+    """
+    >>> bool(NoDists())
+    False
+
+    >>> list(NoDists()('anything'))
+    []
+    """
+    def __bool__(self):
+        return False
+    if six.PY2:
+        __nonzero__ = __bool__
+
+    def __call__(self, fullpath):
+        return iter(())
+
+
+def safe_listdir(path):
+    """
+    Attempt to list contents of path, but suppress some exceptions.
+    """
+    try:
+        return os.listdir(path)
+    except (PermissionError, NotADirectoryError):
+        pass
+    except OSError as e:
+        # Ignore the directory if does not exist, not a directory or
+        # permission denied
+        ignorable = (
+            e.errno in (errno.ENOTDIR, errno.EACCES, errno.ENOENT)
+            # Python 2 on Windows needs to be handled this way :(
+            or getattr(e, "winerror", None) == 267
+        )
+        if not ignorable:
+            raise
+    return ()
+
+
+def distributions_from_metadata(path):
+    root = os.path.dirname(path)
+    if os.path.isdir(path):
+        if len(os.listdir(path)) == 0:
+            # empty metadata dir; skip
+            return
+        metadata = PathMetadata(root, path)
+    else:
+        metadata = FileMetadata(path)
+    entry = os.path.basename(path)
+    yield Distribution.from_location(
+        root, entry, metadata, precedence=DEVELOP_DIST,
+    )
+
+
+def non_empty_lines(path):
+    """
+    Yield non-empty lines from file at path
+    """
+    with open(path) as f:
+        for line in f:
+            line = line.strip()
+            if line:
+                yield line
+
+
+def resolve_egg_link(path):
+    """
+    Given a path to an .egg-link, resolve distributions
+    present in the referenced path.
+    """
+    referenced_paths = non_empty_lines(path)
+    resolved_paths = (
+        os.path.join(os.path.dirname(path), ref)
+        for ref in referenced_paths
+    )
+    dist_groups = map(find_distributions, resolved_paths)
+    return next(dist_groups, ())
+
+
+register_finder(pkgutil.ImpImporter, find_on_path)
+
+if hasattr(importlib_machinery, 'FileFinder'):
+    register_finder(importlib_machinery.FileFinder, find_on_path)
+
+_declare_state('dict', _namespace_handlers={})
+_declare_state('dict', _namespace_packages={})
+
+
+def register_namespace_handler(importer_type, namespace_handler):
+    """Register `namespace_handler` to declare namespace packages
+
+    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
+    handler), and `namespace_handler` is a callable like this::
+
+        def namespace_handler(importer, path_entry, moduleName, module):
+            # return a path_entry to use for child packages
+
+    Namespace handlers are only called if the importer object has already
+    agreed that it can handle the relevant path item, and they should only
+    return a subpath if the module __path__ does not already contain an
+    equivalent subpath.  For an example namespace handler, see
+    ``pkg_resources.file_ns_handler``.
+    """
+    _namespace_handlers[importer_type] = namespace_handler
+
+
+def _handle_ns(packageName, path_item):
+    """Ensure that named package includes a subpath of path_item (if needed)"""
+
+    importer = get_importer(path_item)
+    if importer is None:
+        return None
+
+    # capture warnings due to #1111
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore")
+        loader = importer.find_module(packageName)
+
+    if loader is None:
+        return None
+    module = sys.modules.get(packageName)
+    if module is None:
+        module = sys.modules[packageName] = types.ModuleType(packageName)
+        module.__path__ = []
+        _set_parent_ns(packageName)
+    elif not hasattr(module, '__path__'):
+        raise TypeError("Not a package:", packageName)
+    handler = _find_adapter(_namespace_handlers, importer)
+    subpath = handler(importer, path_item, packageName, module)
+    if subpath is not None:
+        path = module.__path__
+        path.append(subpath)
+        loader.load_module(packageName)
+        _rebuild_mod_path(path, packageName, module)
+    return subpath
+
+
+def _rebuild_mod_path(orig_path, package_name, module):
+    """
+    Rebuild module.__path__ ensuring that all entries are ordered
+    corresponding to their sys.path order
+    """
+    sys_path = [_normalize_cached(p) for p in sys.path]
+
+    def safe_sys_path_index(entry):
+        """
+        Workaround for #520 and #513.
+        """
+        try:
+            return sys_path.index(entry)
+        except ValueError:
+            return float('inf')
+
+    def position_in_sys_path(path):
+        """
+        Return the ordinal of the path based on its position in sys.path
+        """
+        path_parts = path.split(os.sep)
+        module_parts = package_name.count('.') + 1
+        parts = path_parts[:-module_parts]
+        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))
+
+    new_path = sorted(orig_path, key=position_in_sys_path)
+    new_path = [_normalize_cached(p) for p in new_path]
+
+    if isinstance(module.__path__, list):
+        module.__path__[:] = new_path
+    else:
+        module.__path__ = new_path
+
+
+def declare_namespace(packageName):
+    """Declare that package 'packageName' is a namespace package"""
+
+    _imp.acquire_lock()
+    try:
+        if packageName in _namespace_packages:
+            return
+
+        path = sys.path
+        parent, _, _ = packageName.rpartition('.')
+
+        if parent:
+            declare_namespace(parent)
+            if parent not in _namespace_packages:
+                __import__(parent)
+            try:
+                path = sys.modules[parent].__path__
+            except AttributeError:
+                raise TypeError("Not a package:", parent)
+
+        # Track what packages are namespaces, so when new path items are added,
+        # they can be updated
+        _namespace_packages.setdefault(parent or None, []).append(packageName)
+        _namespace_packages.setdefault(packageName, [])
+
+        for path_item in path:
+            # Ensure all the parent's path items are reflected in the child,
+            # if they apply
+            _handle_ns(packageName, path_item)
+
+    finally:
+        _imp.release_lock()
+
+
+def fixup_namespace_packages(path_item, parent=None):
+    """Ensure that previously-declared namespace packages include path_item"""
+    _imp.acquire_lock()
+    try:
+        for package in _namespace_packages.get(parent, ()):
+            subpath = _handle_ns(package, path_item)
+            if subpath:
+                fixup_namespace_packages(subpath, package)
+    finally:
+        _imp.release_lock()
+
+
+def file_ns_handler(importer, path_item, packageName, module):
+    """Compute an ns-package subpath for a filesystem or zipfile importer"""
+
+    subpath = os.path.join(path_item, packageName.split('.')[-1])
+    normalized = _normalize_cached(subpath)
+    for item in module.__path__:
+        if _normalize_cached(item) == normalized:
+            break
+    else:
+        # Only return the path if it's not already there
+        return subpath
+
+
+register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
+register_namespace_handler(zipimport.zipimporter, file_ns_handler)
+
+if hasattr(importlib_machinery, 'FileFinder'):
+    register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler)
+
+
+def null_ns_handler(importer, path_item, packageName, module):
+    return None
+
+
+register_namespace_handler(object, null_ns_handler)
+
+
+def normalize_path(filename):
+    """Normalize a file/dir name for comparison purposes"""
+    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))
+
+
+def _cygwin_patch(filename):  # pragma: nocover
+    """
+    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
+    symlink components. Using
+    os.path.abspath() works around this limitation. A fix in os.getcwd()
+    would probably better, in Cygwin even more so, except
+    that this seems to be by design...
+    """
+    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename
+
+
+def _normalize_cached(filename, _cache={}):
+    try:
+        return _cache[filename]
+    except KeyError:
+        _cache[filename] = result = normalize_path(filename)
+        return result
+
+
+def _is_egg_path(path):
+    """
+    Determine if given path appears to be an egg.
+    """
+    return path.lower().endswith('.egg')
+
+
+def _is_unpacked_egg(path):
+    """
+    Determine if given path appears to be an unpacked egg.
+    """
+    return (
+        _is_egg_path(path) and
+        os.path.isfile(os.path.join(path, 'EGG-INFO', 'PKG-INFO'))
+    )
+
+
+def _set_parent_ns(packageName):
+    parts = packageName.split('.')
+    name = parts.pop()
+    if parts:
+        parent = '.'.join(parts)
+        setattr(sys.modules[parent], name, sys.modules[packageName])
+
+
+def yield_lines(strs):
+    """Yield non-empty/non-comment lines of a string or sequence"""
+    if isinstance(strs, six.string_types):
+        for s in strs.splitlines():
+            s = s.strip()
+            # skip blank lines/comments
+            if s and not s.startswith('#'):
+                yield s
+    else:
+        for ss in strs:
+            for s in yield_lines(ss):
+                yield s
+
+
+MODULE = re.compile(r"\w+(\.\w+)*$").match
+EGG_NAME = re.compile(
+    r"""
+    (?P<name>[^-]+) (
+        -(?P<ver>[^-]+) (
+            -py(?P<pyver>[^-]+) (
+                -(?P<plat>.+)
+            )?
+        )?
+    )?
+    """,
+    re.VERBOSE | re.IGNORECASE,
+).match
+
+
+class EntryPoint:
+    """Object representing an advertised importable object"""
+
+    def __init__(self, name, module_name, attrs=(), extras=(), dist=None):
+        if not MODULE(module_name):
+            raise ValueError("Invalid module name", module_name)
+        self.name = name
+        self.module_name = module_name
+        self.attrs = tuple(attrs)
+        self.extras = tuple(extras)
+        self.dist = dist
+
+    def __str__(self):
+        s = "%s = %s" % (self.name, self.module_name)
+        if self.attrs:
+            s += ':' + '.'.join(self.attrs)
+        if self.extras:
+            s += ' [%s]' % ','.join(self.extras)
+        return s
+
+    def __repr__(self):
+        return "EntryPoint.parse(%r)" % str(self)
+
+    def load(self, require=True, *args, **kwargs):
+        """
+        Require packages for this EntryPoint, then resolve it.
+        """
+        if not require or args or kwargs:
+            warnings.warn(
+                "Parameters to load are deprecated.  Call .resolve and "
+                ".require separately.",
+                PkgResourcesDeprecationWarning,
+                stacklevel=2,
+            )
+        if require:
+            self.require(*args, **kwargs)
+        return self.resolve()
+
+    def resolve(self):
+        """
+        Resolve the entry point from its module and attrs.
+        """
+        module = __import__(self.module_name, fromlist=['__name__'], level=0)
+        try:
+            return functools.reduce(getattr, self.attrs, module)
+        except AttributeError as exc:
+            raise ImportError(str(exc))
+
+    def require(self, env=None, installer=None):
+        if self.extras and not self.dist:
+            raise UnknownExtra("Can't require() without a distribution", self)
+
+        # Get the requirements for this entry point with all its extras and
+        # then resolve them. We have to pass `extras` along when resolving so
+        # that the working set knows what extras we want. Otherwise, for
+        # dist-info distributions, the working set will assume that the
+        # requirements for that extra are purely optional and skip over them.
+        reqs = self.dist.requires(self.extras)
+        items = working_set.resolve(reqs, env, installer, extras=self.extras)
+        list(map(working_set.add, items))
+
+    pattern = re.compile(
+        r'\s*'
+        r'(?P<name>.+?)\s*'
+        r'=\s*'
+        r'(?P<module>[\w.]+)\s*'
+        r'(:\s*(?P<attr>[\w.]+))?\s*'
+        r'(?P<extras>\[.*\])?\s*$'
+    )
+
+    @classmethod
+    def parse(cls, src, dist=None):
+        """Parse a single entry point from string `src`
+
+        Entry point syntax follows the form::
+
+            name = some.module:some.attr [extra1, extra2]
+
+        The entry name and module name are required, but the ``:attrs`` and
+        ``[extras]`` parts are optional
+        """
+        m = cls.pattern.match(src)
+        if not m:
+            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
+            raise ValueError(msg, src)
+        res = m.groupdict()
+        extras = cls._parse_extras(res['extras'])
+        attrs = res['attr'].split('.') if res['attr'] else ()
+        return cls(res['name'], res['module'], attrs, extras, dist)
+
+    @classmethod
+    def _parse_extras(cls, extras_spec):
+        if not extras_spec:
+            return ()
+        req = Requirement.parse('x' + extras_spec)
+        if req.specs:
+            raise ValueError()
+        return req.extras
+
+    @classmethod
+    def parse_group(cls, group, lines, dist=None):
+        """Parse an entry point group"""
+        if not MODULE(group):
+            raise ValueError("Invalid group name", group)
+        this = {}
+        for line in yield_lines(lines):
+            ep = cls.parse(line, dist)
+            if ep.name in this:
+                raise ValueError("Duplicate entry point", group, ep.name)
+            this[ep.name] = ep
+        return this
+
+    @classmethod
+    def parse_map(cls, data, dist=None):
+        """Parse a map of entry point groups"""
+        if isinstance(data, dict):
+            data = data.items()
+        else:
+            data = split_sections(data)
+        maps = {}
+        for group, lines in data:
+            if group is None:
+                if not lines:
+                    continue
+                raise ValueError("Entry points must be listed in groups")
+            group = group.strip()
+            if group in maps:
+                raise ValueError("Duplicate group name", group)
+            maps[group] = cls.parse_group(group, lines, dist)
+        return maps
+
+
+def _remove_md5_fragment(location):
+    if not location:
+        return ''
+    parsed = urllib.parse.urlparse(location)
+    if parsed[-1].startswith('md5='):
+        return urllib.parse.urlunparse(parsed[:-1] + ('',))
+    return location
+
+
+def _version_from_file(lines):
+    """
+    Given an iterable of lines from a Metadata file, return
+    the value of the Version field, if present, or None otherwise.
+    """
+    def is_version_line(line):
+        return line.lower().startswith('version:')
+    version_lines = filter(is_version_line, lines)
+    line = next(iter(version_lines), '')
+    _, _, value = line.partition(':')
+    return safe_version(value.strip()) or None
+
+
+class Distribution:
+    """Wrap an actual or potential sys.path entry w/metadata"""
+    PKG_INFO = 'PKG-INFO'
+
+    def __init__(
+            self, location=None, metadata=None, project_name=None,
+            version=None, py_version=PY_MAJOR, platform=None,
+            precedence=EGG_DIST):
+        self.project_name = safe_name(project_name or 'Unknown')
+        if version is not None:
+            self._version = safe_version(version)
+        self.py_version = py_version
+        self.platform = platform
+        self.location = location
+        self.precedence = precedence
+        self._provider = metadata or empty_provider
+
+    @classmethod
+    def from_location(cls, location, basename, metadata=None, **kw):
+        project_name, version, py_version, platform = [None] * 4
+        basename, ext = os.path.splitext(basename)
+        if ext.lower() in _distributionImpl:
+            cls = _distributionImpl[ext.lower()]
+
+            match = EGG_NAME(basename)
+            if match:
+                project_name, version, py_version, platform = match.group(
+                    'name', 'ver', 'pyver', 'plat'
+                )
+        return cls(
+            location, metadata, project_name=project_name, version=version,
+            py_version=py_version, platform=platform, **kw
+        )._reload_version()
+
+    def _reload_version(self):
+        return self
+
+    @property
+    def hashcmp(self):
+        return (
+            self.parsed_version,
+            self.precedence,
+            self.key,
+            _remove_md5_fragment(self.location),
+            self.py_version or '',
+            self.platform or '',
+        )
+
+    def __hash__(self):
+        return hash(self.hashcmp)
+
+    def __lt__(self, other):
+        return self.hashcmp < other.hashcmp
+
+    def __le__(self, other):
+        return self.hashcmp <= other.hashcmp
+
+    def __gt__(self, other):
+        return self.hashcmp > other.hashcmp
+
+    def __ge__(self, other):
+        return self.hashcmp >= other.hashcmp
+
+    def __eq__(self, other):
+        if not isinstance(other, self.__class__):
+            # It's not a Distribution, so they are not equal
+            return False
+        return self.hashcmp == other.hashcmp
+
+    def __ne__(self, other):
+        return not self == other
+
+    # These properties have to be lazy so that we don't have to load any
+    # metadata until/unless it's actually needed.  (i.e., some distributions
+    # may not know their name or version without loading PKG-INFO)
+
+    @property
+    def key(self):
+        try:
+            return self._key
+        except AttributeError:
+            self._key = key = self.project_name.lower()
+            return key
+
+    @property
+    def parsed_version(self):
+        if not hasattr(self, "_parsed_version"):
+            self._parsed_version = parse_version(self.version)
+
+        return self._parsed_version
+
+    def _warn_legacy_version(self):
+        LV = packaging.version.LegacyVersion
+        is_legacy = isinstance(self._parsed_version, LV)
+        if not is_legacy:
+            return
+
+        # While an empty version is technically a legacy version and
+        # is not a valid PEP 440 version, it's also unlikely to
+        # actually come from someone and instead it is more likely that
+        # it comes from setuptools attempting to parse a filename and
+        # including it in the list. So for that we'll gate this warning
+        # on if the version is anything at all or not.
+        if not self.version:
+            return
+
+        tmpl = textwrap.dedent("""
+            '{project_name} ({version})' is being parsed as a legacy,
+            non PEP 440,
+            version. You may find odd behavior and sort order.
+            In particular it will be sorted as less than 0.0. It
+            is recommended to migrate to PEP 440 compatible
+            versions.
+            """).strip().replace('\n', ' ')
+
+        warnings.warn(tmpl.format(**vars(self)), PEP440Warning)
+
+    @property
+    def version(self):
+        try:
+            return self._version
+        except AttributeError:
+            version = self._get_version()
+            if version is None:
+                path = self._get_metadata_path_for_display(self.PKG_INFO)
+                msg = (
+                    "Missing 'Version:' header and/or {} file at path: {}"
+                ).format(self.PKG_INFO, path)
+                raise ValueError(msg, self)
+
+            return version
+
+    @property
+    def _dep_map(self):
+        """
+        A map of extra to its list of (direct) requirements
+        for this distribution, including the null extra.
+        """
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._filter_extras(self._build_dep_map())
+        return self.__dep_map
+
+    @staticmethod
+    def _filter_extras(dm):
+        """
+        Given a mapping of extras to dependencies, strip off
+        environment markers and filter out any dependencies
+        not matching the markers.
+        """
+        for extra in list(filter(None, dm)):
+            new_extra = extra
+            reqs = dm.pop(extra)
+            new_extra, _, marker = extra.partition(':')
+            fails_marker = marker and (
+                invalid_marker(marker)
+                or not evaluate_marker(marker)
+            )
+            if fails_marker:
+                reqs = []
+            new_extra = safe_extra(new_extra) or None
+
+            dm.setdefault(new_extra, []).extend(reqs)
+        return dm
+
+    def _build_dep_map(self):
+        dm = {}
+        for name in 'requires.txt', 'depends.txt':
+            for extra, reqs in split_sections(self._get_metadata(name)):
+                dm.setdefault(extra, []).extend(parse_requirements(reqs))
+        return dm
+
+    def requires(self, extras=()):
+        """List of Requirements needed for this distro if `extras` are used"""
+        dm = self._dep_map
+        deps = []
+        deps.extend(dm.get(None, ()))
+        for ext in extras:
+            try:
+                deps.extend(dm[safe_extra(ext)])
+            except KeyError:
+                raise UnknownExtra(
+                    "%s has no such extra feature %r" % (self, ext)
+                )
+        return deps
+
+    def _get_metadata_path_for_display(self, name):
+        """
+        Return the path to the given metadata file, if available.
+        """
+        try:
+            # We need to access _get_metadata_path() on the provider object
+            # directly rather than through this class's __getattr__()
+            # since _get_metadata_path() is marked private.
+            path = self._provider._get_metadata_path(name)
+
+        # Handle exceptions e.g. in case the distribution's metadata
+        # provider doesn't support _get_metadata_path().
+        except Exception:
+            return '[could not detect]'
+
+        return path
+
+    def _get_metadata(self, name):
+        if self.has_metadata(name):
+            for line in self.get_metadata_lines(name):
+                yield line
+
+    def _get_version(self):
+        lines = self._get_metadata(self.PKG_INFO)
+        version = _version_from_file(lines)
+
+        return version
+
+    def activate(self, path=None, replace=False):
+        """Ensure distribution is importable on `path` (default=sys.path)"""
+        if path is None:
+            path = sys.path
+        self.insert_on(path, replace=replace)
+        if path is sys.path:
+            fixup_namespace_packages(self.location)
+            for pkg in self._get_metadata('namespace_packages.txt'):
+                if pkg in sys.modules:
+                    declare_namespace(pkg)
+
+    def egg_name(self):
+        """Return what this distribution's standard .egg filename should be"""
+        filename = "%s-%s-py%s" % (
+            to_filename(self.project_name), to_filename(self.version),
+            self.py_version or PY_MAJOR
+        )
+
+        if self.platform:
+            filename += '-' + self.platform
+        return filename
+
+    def __repr__(self):
+        if self.location:
+            return "%s (%s)" % (self, self.location)
+        else:
+            return str(self)
+
+    def __str__(self):
+        try:
+            version = getattr(self, 'version', None)
+        except ValueError:
+            version = None
+        version = version or "[unknown version]"
+        return "%s %s" % (self.project_name, version)
+
+    def __getattr__(self, attr):
+        """Delegate all unrecognized public attributes to .metadata provider"""
+        if attr.startswith('_'):
+            raise AttributeError(attr)
+        return getattr(self._provider, attr)
+
+    def __dir__(self):
+        return list(
+            set(super(Distribution, self).__dir__())
+            | set(
+                attr for attr in self._provider.__dir__()
+                if not attr.startswith('_')
+            )
+        )
+
+    if not hasattr(object, '__dir__'):
+        # python 2.7 not supported
+        del __dir__
+
+    @classmethod
+    def from_filename(cls, filename, metadata=None, **kw):
+        return cls.from_location(
+            _normalize_cached(filename), os.path.basename(filename), metadata,
+            **kw
+        )
+
+    def as_requirement(self):
+        """Return a ``Requirement`` that matches this distribution exactly"""
+        if isinstance(self.parsed_version, packaging.version.Version):
+            spec = "%s==%s" % (self.project_name, self.parsed_version)
+        else:
+            spec = "%s===%s" % (self.project_name, self.parsed_version)
+
+        return Requirement.parse(spec)
+
+    def load_entry_point(self, group, name):
+        """Return the `name` entry point of `group` or raise ImportError"""
+        ep = self.get_entry_info(group, name)
+        if ep is None:
+            raise ImportError("Entry point %r not found" % ((group, name),))
+        return ep.load()
+
+    def get_entry_map(self, group=None):
+        """Return the entry point map for `group`, or the full entry map"""
+        try:
+            ep_map = self._ep_map
+        except AttributeError:
+            ep_map = self._ep_map = EntryPoint.parse_map(
+                self._get_metadata('entry_points.txt'), self
+            )
+        if group is not None:
+            return ep_map.get(group, {})
+        return ep_map
+
+    def get_entry_info(self, group, name):
+        """Return the EntryPoint object for `group`+`name`, or ``None``"""
+        return self.get_entry_map(group).get(name)
+
+    def insert_on(self, path, loc=None, replace=False):
+        """Ensure self.location is on path
+
+        If replace=False (default):
+            - If location is already in path anywhere, do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent.
+              - Else: add to the end of path.
+        If replace=True:
+            - If location is already on path anywhere (not eggs)
+              or higher priority than its parent (eggs)
+              do nothing.
+            - Else:
+              - If it's an egg and its parent directory is on path,
+                insert just ahead of the parent,
+                removing any lower-priority entries.
+              - Else: add it to the front of path.
+        """
+
+        loc = loc or self.location
+        if not loc:
+            return
+
+        nloc = _normalize_cached(loc)
+        bdir = os.path.dirname(nloc)
+        npath = [(p and _normalize_cached(p) or p) for p in path]
+
+        for p, item in enumerate(npath):
+            if item == nloc:
+                if replace:
+                    break
+                else:
+                    # don't modify path (even removing duplicates) if
+                    # found and not replace
+                    return
+            elif item == bdir and self.precedence == EGG_DIST:
+                # if it's an .egg, give it precedence over its directory
+                # UNLESS it's already been added to sys.path and replace=False
+                if (not replace) and nloc in npath[p:]:
+                    return
+                if path is sys.path:
+                    self.check_version_conflict()
+                path.insert(p, loc)
+                npath.insert(p, nloc)
+                break
+        else:
+            if path is sys.path:
+                self.check_version_conflict()
+            if replace:
+                path.insert(0, loc)
+            else:
+                path.append(loc)
+            return
+
+        # p is the spot where we found or inserted loc; now remove duplicates
+        while True:
+            try:
+                np = npath.index(nloc, p + 1)
+            except ValueError:
+                break
+            else:
+                del npath[np], path[np]
+                # ha!
+                p = np
+
+        return
+
+    def check_version_conflict(self):
+        if self.key == 'setuptools':
+            # ignore the inevitable setuptools self-conflicts  :(
+            return
+
+        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
+        loc = normalize_path(self.location)
+        for modname in self._get_metadata('top_level.txt'):
+            if (modname not in sys.modules or modname in nsp
+                    or modname in _namespace_packages):
+                continue
+            if modname in ('pkg_resources', 'setuptools', 'site'):
+                continue
+            fn = getattr(sys.modules[modname], '__file__', None)
+            if fn and (normalize_path(fn).startswith(loc) or
+                       fn.startswith(self.location)):
+                continue
+            issue_warning(
+                "Module %s was already imported from %s, but %s is being added"
+                " to sys.path" % (modname, fn, self.location),
+            )
+
+    def has_version(self):
+        try:
+            self.version
+        except ValueError:
+            issue_warning("Unbuilt egg for " + repr(self))
+            return False
+        return True
+
+    def clone(self, **kw):
+        """Copy this distribution, substituting in any changed keyword args"""
+        names = 'project_name version py_version platform location precedence'
+        for attr in names.split():
+            kw.setdefault(attr, getattr(self, attr, None))
+        kw.setdefault('metadata', self._provider)
+        return self.__class__(**kw)
+
+    @property
+    def extras(self):
+        return [dep for dep in self._dep_map if dep]
+
+
+class EggInfoDistribution(Distribution):
+    def _reload_version(self):
+        """
+        Packages installed by distutils (e.g. numpy or scipy),
+        which uses an old safe_version, and so
+        their version numbers can get mangled when
+        converted to filenames (e.g., 1.11.0.dev0+2329eae to
+        1.11.0.dev0_2329eae). These distributions will not be
+        parsed properly
+        downstream by Distribution and safe_version, so
+        take an extra step and try to get the version number from
+        the metadata file itself instead of the filename.
+        """
+        md_version = self._get_version()
+        if md_version:
+            self._version = md_version
+        return self
+
+
+class DistInfoDistribution(Distribution):
+    """
+    Wrap an actual or potential sys.path entry
+    w/metadata, .dist-info style.
+    """
+    PKG_INFO = 'METADATA'
+    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")
+
+    @property
+    def _parsed_pkg_info(self):
+        """Parse and cache metadata"""
+        try:
+            return self._pkg_info
+        except AttributeError:
+            metadata = self.get_metadata(self.PKG_INFO)
+            self._pkg_info = email.parser.Parser().parsestr(metadata)
+            return self._pkg_info
+
+    @property
+    def _dep_map(self):
+        try:
+            return self.__dep_map
+        except AttributeError:
+            self.__dep_map = self._compute_dependencies()
+            return self.__dep_map
+
+    def _compute_dependencies(self):
+        """Recompute this distribution's dependencies."""
+        dm = self.__dep_map = {None: []}
+
+        reqs = []
+        # Including any condition expressions
+        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
+            reqs.extend(parse_requirements(req))
+
+        def reqs_for_extra(extra):
+            for req in reqs:
+                if not req.marker or req.marker.evaluate({'extra': extra}):
+                    yield req
+
+        common = frozenset(reqs_for_extra(None))
+        dm[None].extend(common)
+
+        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
+            s_extra = safe_extra(extra.strip())
+            dm[s_extra] = list(frozenset(reqs_for_extra(extra)) - common)
+
+        return dm
+
+
+_distributionImpl = {
+    '.egg': Distribution,
+    '.egg-info': EggInfoDistribution,
+    '.dist-info': DistInfoDistribution,
+}
+
+
+def issue_warning(*args, **kw):
+    level = 1
+    g = globals()
+    try:
+        # find the first stack frame that is *not* code in
+        # the pkg_resources module, to use for the warning
+        while sys._getframe(level).f_globals is g:
+            level += 1
+    except ValueError:
+        pass
+    warnings.warn(stacklevel=level + 1, *args, **kw)
+
+
+class RequirementParseError(ValueError):
+    def __str__(self):
+        return ' '.join(self.args)
+
+
+def parse_requirements(strs):
+    """Yield ``Requirement`` objects for each specification in `strs`
+
+    `strs` must be a string, or a (possibly-nested) iterable thereof.
+    """
+    # create a steppable iterator, so we can handle \-continuations
+    lines = iter(yield_lines(strs))
+
+    for line in lines:
+        # Drop comments -- a hash without a space may be in a URL.
+        if ' #' in line:
+            line = line[:line.find(' #')]
+        # If there is a line continuation, drop it, and append the next line.
+        if line.endswith('\\'):
+            line = line[:-2].strip()
+            try:
+                line += next(lines)
+            except StopIteration:
+                return
+        yield Requirement(line)
+
+
+class Requirement(packaging.requirements.Requirement):
+    def __init__(self, requirement_string):
+        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
+        try:
+            super(Requirement, self).__init__(requirement_string)
+        except packaging.requirements.InvalidRequirement as e:
+            raise RequirementParseError(str(e))
+        self.unsafe_name = self.name
+        project_name = safe_name(self.name)
+        self.project_name, self.key = project_name, project_name.lower()
+        self.specs = [
+            (spec.operator, spec.version) for spec in self.specifier]
+        self.extras = tuple(map(safe_extra, self.extras))
+        self.hashCmp = (
+            self.key,
+            self.url,
+            self.specifier,
+            frozenset(self.extras),
+            str(self.marker) if self.marker else None,
+        )
+        self.__hash = hash(self.hashCmp)
+
+    def __eq__(self, other):
+        return (
+            isinstance(other, Requirement) and
+            self.hashCmp == other.hashCmp
+        )
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __contains__(self, item):
+        if isinstance(item, Distribution):
+            if item.key != self.key:
+                return False
+
+            item = item.version
+
+        # Allow prereleases always in order to match the previous behavior of
+        # this method. In the future this should be smarter and follow PEP 440
+        # more accurately.
+        return self.specifier.contains(item, prereleases=True)
+
+    def __hash__(self):
+        return self.__hash
+
+    def __repr__(self):
+        return "Requirement.parse(%r)" % str(self)
+
+    @staticmethod
+    def parse(s):
+        req, = parse_requirements(s)
+        return req
+
+
+def _always_object(classes):
+    """
+    Ensure object appears in the mro even
+    for old-style classes.
+    """
+    if object not in classes:
+        return classes + (object,)
+    return classes
+
+
+def _find_adapter(registry, ob):
+    """Return an adapter factory for `ob` from `registry`"""
+    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
+    for t in types:
+        if t in registry:
+            return registry[t]
+
+
+def ensure_directory(path):
+    """Ensure that the parent directory of `path` exists"""
+    dirname = os.path.dirname(path)
+    py31compat.makedirs(dirname, exist_ok=True)
+
+
+def _bypass_ensure_directory(path):
+    """Sandbox-bypassing version of ensure_directory()"""
+    if not WRITE_SUPPORT:
+        raise IOError('"os.mkdir" not supported on this platform.')
+    dirname, filename = split(path)
+    if dirname and filename and not isdir(dirname):
+        _bypass_ensure_directory(dirname)
+        try:
+            mkdir(dirname, 0o755)
+        except FileExistsError:
+            pass
+
+
+def split_sections(s):
+    """Split a string or iterable thereof into (section, content) pairs
+
+    Each ``section`` is a stripped version of the section header ("[section]")
+    and each ``content`` is a list of stripped lines excluding blank lines and
+    comment-only lines.  If there are any such lines before the first section
+    header, they're returned in a first ``section`` of ``None``.
+    """
+    section = None
+    content = []
+    for line in yield_lines(s):
+        if line.startswith("["):
+            if line.endswith("]"):
+                if section or content:
+                    yield section, content
+                section = line[1:-1].strip()
+                content = []
+            else:
+                raise ValueError("Invalid section heading", line)
+        else:
+            content.append(line)
+
+    # wrap up last segment
+    yield section, content
+
+
+def _mkstemp(*args, **kw):
+    old_open = os.open
+    try:
+        # temporarily bypass sandboxing
+        os.open = os_open
+        return tempfile.mkstemp(*args, **kw)
+    finally:
+        # and then put it back
+        os.open = old_open
+
+
+# Silence the PEP440Warning by default, so that end users don't get hit by it
+# randomly just because they use pkg_resources. We want to append the rule
+# because we want earlier uses of filterwarnings to take precedence over this
+# one.
+warnings.filterwarnings("ignore", category=PEP440Warning, append=True)
+
+
+# from jaraco.functools 1.3
+def _call_aside(f, *args, **kwargs):
+    f(*args, **kwargs)
+    return f
+
+
+@_call_aside
+def _initialize(g=globals()):
+    "Set up global resource manager (deliberately not state-saved)"
+    manager = ResourceManager()
+    g['_manager'] = manager
+    g.update(
+        (name, getattr(manager, name))
+        for name in dir(manager)
+        if not name.startswith('_')
+    )
+
+
+@_call_aside
+def _initialize_master_working_set():
+    """
+    Prepare the master working set and make the ``require()``
+    API available.
+
+    This function has explicit effects on the global state
+    of pkg_resources. It is intended to be invoked once at
+    the initialization of this module.
+
+    Invocation by other packages is unsupported and done
+    at their own risk.
+    """
+    working_set = WorkingSet._build_master()
+    _declare_state('object', working_set=working_set)
+
+    require = working_set.require
+    iter_entry_points = working_set.iter_entry_points
+    add_activation_listener = working_set.subscribe
+    run_script = working_set.run_script
+    # backward compatibility
+    run_main = run_script
+    # Activate all distributions already on sys.path with replace=False and
+    # ensure that all distributions added to the working set in the future
+    # (e.g. by calling ``require()``) will get activated as well,
+    # with higher priority (replace=True).
+    tuple(
+        dist.activate(replace=False)
+        for dist in working_set
+    )
+    add_activation_listener(
+        lambda dist: dist.activate(replace=True),
+        existing=False,
+    )
+    working_set.entries = []
+    # match order
+    list(map(working_set.add_entry, sys.path))
+    globals().update(locals())
+
+class PkgResourcesDeprecationWarning(Warning):
+    """
+    Base class for warning about deprecations in ``pkg_resources``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py
new file mode 100644
index 0000000000000000000000000000000000000000..ae67001af8b661373edeee2eb327b9f63e630d62
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py
@@ -0,0 +1,608 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+# Copyright (c) 2005-2010 ActiveState Software Inc.
+# Copyright (c) 2013 Eddy Petrișor
+
+"""Utilities for determining application-specific dirs.
+
+See <http://github.com/ActiveState/appdirs> for details and usage.
+"""
+# Dev Notes:
+# - MSDN on where to store app data files:
+#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
+# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
+# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
+
+__version_info__ = (1, 4, 3)
+__version__ = '.'.join(map(str, __version_info__))
+
+
+import sys
+import os
+
+PY3 = sys.version_info[0] == 3
+
+if PY3:
+    unicode = str
+
+if sys.platform.startswith('java'):
+    import platform
+    os_name = platform.java_ver()[3][0]
+    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
+        system = 'win32'
+    elif os_name.startswith('Mac'): # "Mac OS X", etc.
+        system = 'darwin'
+    else: # "Linux", "SunOS", "FreeBSD", etc.
+        # Setting this to "linux2" is not ideal, but only Windows or Mac
+        # are actually checked for and the rest of the module expects
+        # *sys.platform* style strings.
+        system = 'linux2'
+else:
+    system = sys.platform
+
+
+
+def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user data directories are:
+        Mac OS X:               ~/Library/Application Support/<AppName>
+        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
+        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
+        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
+        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
+        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>
+
+    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
+    That means, by default "~/.local/share/<AppName>".
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
+        path = os.path.normpath(_get_win_folder(const))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+    elif system == 'darwin':
+        path = os.path.expanduser('~/Library/Application Support/')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
+    r"""Return full path to the user-shared data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "multipath" is an optional parameter only applicable to *nix
+            which indicates that the entire list of data dirs should be
+            returned. By default, the first item from XDG_DATA_DIRS is
+            returned, or '/usr/local/share/<AppName>',
+            if XDG_DATA_DIRS is not set
+
+    Typical site data directories are:
+        Mac OS X:   /Library/Application Support/<AppName>
+        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
+        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
+        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
+        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.
+
+    For Unix, this is using the $XDG_DATA_DIRS[0] default.
+
+    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+    elif system == 'darwin':
+        path = os.path.expanduser('/Library/Application Support')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        # XDG default for $XDG_DATA_DIRS
+        # only first, if multipath is False
+        path = os.getenv('XDG_DATA_DIRS',
+                         os.pathsep.join(['/usr/local/share', '/usr/share']))
+        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
+        if appname:
+            if version:
+                appname = os.path.join(appname, version)
+            pathlist = [os.sep.join([x, appname]) for x in pathlist]
+
+        if multipath:
+            path = os.pathsep.join(pathlist)
+        else:
+            path = pathlist[0]
+        return path
+
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific config dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user config directories are:
+        Mac OS X:               same as user_data_dir
+        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
+        Win *:                  same as user_data_dir
+
+    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
+    That means, by default "~/.config/<AppName>".
+    """
+    if system in ["win32", "darwin"]:
+        path = user_data_dir(appname, appauthor, None, roaming)
+    else:
+        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
+    r"""Return full path to the user-shared data dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "multipath" is an optional parameter only applicable to *nix
+            which indicates that the entire list of config dirs should be
+            returned. By default, the first item from XDG_CONFIG_DIRS is
+            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set
+
+    Typical site config directories are:
+        Mac OS X:   same as site_data_dir
+        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
+                    $XDG_CONFIG_DIRS
+        Win *:      same as site_data_dir
+        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
+
+    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False
+
+    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
+    """
+    if system in ["win32", "darwin"]:
+        path = site_data_dir(appname, appauthor)
+        if appname and version:
+            path = os.path.join(path, version)
+    else:
+        # XDG default for $XDG_CONFIG_DIRS
+        # only first, if multipath is False
+        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
+        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
+        if appname:
+            if version:
+                appname = os.path.join(appname, version)
+            pathlist = [os.sep.join([x, appname]) for x in pathlist]
+
+        if multipath:
+            path = os.pathsep.join(pathlist)
+        else:
+            path = pathlist[0]
+    return path
+
+
+def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
+    r"""Return full path to the user-specific cache dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "opinion" (boolean) can be False to disable the appending of
+            "Cache" to the base app data dir for Windows. See
+            discussion below.
+
+    Typical user cache directories are:
+        Mac OS X:   ~/Library/Caches/<AppName>
+        Unix:       ~/.cache/<AppName> (XDG default)
+        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
+        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache
+
+    On Windows the only suggestion in the MSDN docs is that local settings go in
+    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
+    app data dir (the default returned by `user_data_dir` above). Apps typically
+    put cache data somewhere *under* the given dir here. Some examples:
+        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
+        ...\Acme\SuperApp\Cache\1.0
+    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
+    This can be disabled with the `opinion=False` option.
+    """
+    if system == "win32":
+        if appauthor is None:
+            appauthor = appname
+        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
+        if appname:
+            if appauthor is not False:
+                path = os.path.join(path, appauthor, appname)
+            else:
+                path = os.path.join(path, appname)
+            if opinion:
+                path = os.path.join(path, "Cache")
+    elif system == 'darwin':
+        path = os.path.expanduser('~/Library/Caches')
+        if appname:
+            path = os.path.join(path, appname)
+    else:
+        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
+    r"""Return full path to the user-specific state dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "roaming" (boolean, default False) can be set True to use the Windows
+            roaming appdata directory. That means that for users on a Windows
+            network setup for roaming profiles, this user data will be
+            sync'd on login. See
+            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
+            for a discussion of issues.
+
+    Typical user state directories are:
+        Mac OS X:  same as user_data_dir
+        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
+        Win *:     same as user_data_dir
+
+    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
+    to extend the XDG spec and support $XDG_STATE_HOME.
+
+    That means, by default "~/.local/state/<AppName>".
+    """
+    if system in ["win32", "darwin"]:
+        path = user_data_dir(appname, appauthor, None, roaming)
+    else:
+        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
+        if appname:
+            path = os.path.join(path, appname)
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
+    r"""Return full path to the user-specific log dir for this application.
+
+        "appname" is the name of application.
+            If None, just the system directory is returned.
+        "appauthor" (only used on Windows) is the name of the
+            appauthor or distributing body for this application. Typically
+            it is the owning company name. This falls back to appname. You may
+            pass False to disable it.
+        "version" is an optional version path element to append to the
+            path. You might want to use this if you want multiple versions
+            of your app to be able to run independently. If used, this
+            would typically be "<major>.<minor>".
+            Only applied when appname is present.
+        "opinion" (boolean) can be False to disable the appending of
+            "Logs" to the base app data dir for Windows, and "log" to the
+            base cache dir for Unix. See discussion below.
+
+    Typical user log directories are:
+        Mac OS X:   ~/Library/Logs/<AppName>
+        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
+        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
+        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs
+
+    On Windows the only suggestion in the MSDN docs is that local settings
+    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
+    examples of what some windows apps use for a logs dir.)
+
+    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
+    value for Windows and appends "log" to the user cache dir for Unix.
+    This can be disabled with the `opinion=False` option.
+    """
+    if system == "darwin":
+        path = os.path.join(
+            os.path.expanduser('~/Library/Logs'),
+            appname)
+    elif system == "win32":
+        path = user_data_dir(appname, appauthor, version)
+        version = False
+        if opinion:
+            path = os.path.join(path, "Logs")
+    else:
+        path = user_cache_dir(appname, appauthor, version)
+        version = False
+        if opinion:
+            path = os.path.join(path, "log")
+    if appname and version:
+        path = os.path.join(path, version)
+    return path
+
+
+class AppDirs(object):
+    """Convenience wrapper for getting application dirs."""
+    def __init__(self, appname=None, appauthor=None, version=None,
+            roaming=False, multipath=False):
+        self.appname = appname
+        self.appauthor = appauthor
+        self.version = version
+        self.roaming = roaming
+        self.multipath = multipath
+
+    @property
+    def user_data_dir(self):
+        return user_data_dir(self.appname, self.appauthor,
+                             version=self.version, roaming=self.roaming)
+
+    @property
+    def site_data_dir(self):
+        return site_data_dir(self.appname, self.appauthor,
+                             version=self.version, multipath=self.multipath)
+
+    @property
+    def user_config_dir(self):
+        return user_config_dir(self.appname, self.appauthor,
+                               version=self.version, roaming=self.roaming)
+
+    @property
+    def site_config_dir(self):
+        return site_config_dir(self.appname, self.appauthor,
+                             version=self.version, multipath=self.multipath)
+
+    @property
+    def user_cache_dir(self):
+        return user_cache_dir(self.appname, self.appauthor,
+                              version=self.version)
+
+    @property
+    def user_state_dir(self):
+        return user_state_dir(self.appname, self.appauthor,
+                              version=self.version)
+
+    @property
+    def user_log_dir(self):
+        return user_log_dir(self.appname, self.appauthor,
+                            version=self.version)
+
+
+#---- internal support stuff
+
+def _get_win_folder_from_registry(csidl_name):
+    """This is a fallback technique at best. I'm not sure if using the
+    registry for this guarantees us the correct answer for all CSIDL_*
+    names.
+    """
+    if PY3:
+      import winreg as _winreg
+    else:
+      import _winreg
+
+    shell_folder_name = {
+        "CSIDL_APPDATA": "AppData",
+        "CSIDL_COMMON_APPDATA": "Common AppData",
+        "CSIDL_LOCAL_APPDATA": "Local AppData",
+    }[csidl_name]
+
+    key = _winreg.OpenKey(
+        _winreg.HKEY_CURRENT_USER,
+        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
+    )
+    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
+    return dir
+
+
+def _get_win_folder_with_pywin32(csidl_name):
+    from win32com.shell import shellcon, shell
+    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
+    # Try to make this a unicode path because SHGetFolderPath does
+    # not return unicode strings when there is unicode data in the
+    # path.
+    try:
+        dir = unicode(dir)
+
+        # Downgrade to short path name if have highbit chars. See
+        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+        has_high_char = False
+        for c in dir:
+            if ord(c) > 255:
+                has_high_char = True
+                break
+        if has_high_char:
+            try:
+                import win32api
+                dir = win32api.GetShortPathName(dir)
+            except ImportError:
+                pass
+    except UnicodeError:
+        pass
+    return dir
+
+
+def _get_win_folder_with_ctypes(csidl_name):
+    import ctypes
+
+    csidl_const = {
+        "CSIDL_APPDATA": 26,
+        "CSIDL_COMMON_APPDATA": 35,
+        "CSIDL_LOCAL_APPDATA": 28,
+    }[csidl_name]
+
+    buf = ctypes.create_unicode_buffer(1024)
+    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)
+
+    # Downgrade to short path name if have highbit chars. See
+    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+    has_high_char = False
+    for c in buf:
+        if ord(c) > 255:
+            has_high_char = True
+            break
+    if has_high_char:
+        buf2 = ctypes.create_unicode_buffer(1024)
+        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
+            buf = buf2
+
+    return buf.value
+
+def _get_win_folder_with_jna(csidl_name):
+    import array
+    from com.sun import jna
+    from com.sun.jna.platform import win32
+
+    buf_size = win32.WinDef.MAX_PATH * 2
+    buf = array.zeros('c', buf_size)
+    shell = win32.Shell32.INSTANCE
+    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
+    dir = jna.Native.toString(buf.tostring()).rstrip("\0")
+
+    # Downgrade to short path name if have highbit chars. See
+    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
+    has_high_char = False
+    for c in dir:
+        if ord(c) > 255:
+            has_high_char = True
+            break
+    if has_high_char:
+        buf = array.zeros('c', buf_size)
+        kernel = win32.Kernel32.INSTANCE
+        if kernel.GetShortPathName(dir, buf, buf_size):
+            dir = jna.Native.toString(buf.tostring()).rstrip("\0")
+
+    return dir
+
+if system == "win32":
+    try:
+        import win32com.shell
+        _get_win_folder = _get_win_folder_with_pywin32
+    except ImportError:
+        try:
+            from ctypes import windll
+            _get_win_folder = _get_win_folder_with_ctypes
+        except ImportError:
+            try:
+                import com.sun.jna
+                _get_win_folder = _get_win_folder_with_jna
+            except ImportError:
+                _get_win_folder = _get_win_folder_from_registry
+
+
+#---- self test code
+
+if __name__ == "__main__":
+    appname = "MyApp"
+    appauthor = "MyCompany"
+
+    props = ("user_data_dir",
+             "user_config_dir",
+             "user_cache_dir",
+             "user_state_dir",
+             "user_log_dir",
+             "site_data_dir",
+             "site_config_dir")
+
+    print("-- app dirs %s --" % __version__)
+
+    print("-- app dirs (with optional 'version')")
+    dirs = AppDirs(appname, appauthor, version="1.0")
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (without optional 'version')")
+    dirs = AppDirs(appname, appauthor)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (without optional 'appauthor')")
+    dirs = AppDirs(appname)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
+
+    print("\n-- app dirs (with disabled 'appauthor')")
+    dirs = AppDirs(appname, appauthor=False)
+    for prop in props:
+        print("%s: %s" % (prop, getattr(dirs, prop)))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py
new file mode 100644
index 0000000000000000000000000000000000000000..95d330ef823aa2e12f7846bc63c0955b25df6029
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py
@@ -0,0 +1,21 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+__all__ = [
+    "__title__", "__summary__", "__uri__", "__version__", "__author__",
+    "__email__", "__license__", "__copyright__",
+]
+
+__title__ = "packaging"
+__summary__ = "Core utilities for Python packages"
+__uri__ = "https://github.com/pypa/packaging"
+
+__version__ = "16.8"
+
+__author__ = "Donald Stufft and individual contributors"
+__email__ = "donald@stufft.io"
+
+__license__ = "BSD or Apache License, Version 2.0"
+__copyright__ = "Copyright 2014-2016 %s" % __author__
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ee6220203e5425f900fb5a43676c24ea377c2fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py
@@ -0,0 +1,14 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+from .__about__ import (
+    __author__, __copyright__, __email__, __license__, __summary__, __title__,
+    __uri__, __version__
+)
+
+__all__ = [
+    "__title__", "__summary__", "__uri__", "__version__", "__author__",
+    "__email__", "__license__", "__copyright__",
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..210bb80b7e7b64cb79f7e7cdf3e42819fe3471fe
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py
@@ -0,0 +1,30 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+
+# flake8: noqa
+
+if PY3:
+    string_types = str,
+else:
+    string_types = basestring,
+
+
+def with_metaclass(meta, *bases):
+    """
+    Create a base class with a metaclass.
+    """
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(meta):
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+    return type.__new__(metaclass, 'temporary_class', (), {})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py
new file mode 100644
index 0000000000000000000000000000000000000000..ccc27861c3a4d9efaa3db753c77c4515a627bd98
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py
@@ -0,0 +1,68 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+
+class Infinity(object):
+
+    def __repr__(self):
+        return "Infinity"
+
+    def __hash__(self):
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        return False
+
+    def __le__(self, other):
+        return False
+
+    def __eq__(self, other):
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        return True
+
+    def __ge__(self, other):
+        return True
+
+    def __neg__(self):
+        return NegativeInfinity
+
+Infinity = Infinity()
+
+
+class NegativeInfinity(object):
+
+    def __repr__(self):
+        return "-Infinity"
+
+    def __hash__(self):
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        return True
+
+    def __le__(self, other):
+        return True
+
+    def __eq__(self, other):
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        return False
+
+    def __ge__(self, other):
+        return False
+
+    def __neg__(self):
+        return Infinity
+
+NegativeInfinity = NegativeInfinity()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py
new file mode 100644
index 0000000000000000000000000000000000000000..892e578edd4b992cc2996c31d9deb13af73d62c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.py
@@ -0,0 +1,301 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import operator
+import os
+import platform
+import sys
+
+from pkg_resources.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd
+from pkg_resources.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString
+from pkg_resources.extern.pyparsing import Literal as L  # noqa
+
+from ._compat import string_types
+from .specifiers import Specifier, InvalidSpecifier
+
+
+__all__ = [
+    "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName",
+    "Marker", "default_environment",
+]
+
+
+class InvalidMarker(ValueError):
+    """
+    An invalid marker was found, users should refer to PEP 508.
+    """
+
+
+class UndefinedComparison(ValueError):
+    """
+    An invalid operation was attempted on a value that doesn't support it.
+    """
+
+
+class UndefinedEnvironmentName(ValueError):
+    """
+    A name was attempted to be used that does not exist inside of the
+    environment.
+    """
+
+
+class Node(object):
+
+    def __init__(self, value):
+        self.value = value
+
+    def __str__(self):
+        return str(self.value)
+
+    def __repr__(self):
+        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))
+
+    def serialize(self):
+        raise NotImplementedError
+
+
+class Variable(Node):
+
+    def serialize(self):
+        return str(self)
+
+
+class Value(Node):
+
+    def serialize(self):
+        return '"{0}"'.format(self)
+
+
+class Op(Node):
+
+    def serialize(self):
+        return str(self)
+
+
+VARIABLE = (
+    L("implementation_version") |
+    L("platform_python_implementation") |
+    L("implementation_name") |
+    L("python_full_version") |
+    L("platform_release") |
+    L("platform_version") |
+    L("platform_machine") |
+    L("platform_system") |
+    L("python_version") |
+    L("sys_platform") |
+    L("os_name") |
+    L("os.name") |  # PEP-345
+    L("sys.platform") |  # PEP-345
+    L("platform.version") |  # PEP-345
+    L("platform.machine") |  # PEP-345
+    L("platform.python_implementation") |  # PEP-345
+    L("python_implementation") |  # undocumented setuptools legacy
+    L("extra")
+)
+ALIASES = {
+    'os.name': 'os_name',
+    'sys.platform': 'sys_platform',
+    'platform.version': 'platform_version',
+    'platform.machine': 'platform_machine',
+    'platform.python_implementation': 'platform_python_implementation',
+    'python_implementation': 'platform_python_implementation'
+}
+VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))
+
+VERSION_CMP = (
+    L("===") |
+    L("==") |
+    L(">=") |
+    L("<=") |
+    L("!=") |
+    L("~=") |
+    L(">") |
+    L("<")
+)
+
+MARKER_OP = VERSION_CMP | L("not in") | L("in")
+MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))
+
+MARKER_VALUE = QuotedString("'") | QuotedString('"')
+MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))
+
+BOOLOP = L("and") | L("or")
+
+MARKER_VAR = VARIABLE | MARKER_VALUE
+
+MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
+MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))
+
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+
+MARKER_EXPR = Forward()
+MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
+MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)
+
+MARKER = stringStart + MARKER_EXPR + stringEnd
+
+
+def _coerce_parse_result(results):
+    if isinstance(results, ParseResults):
+        return [_coerce_parse_result(i) for i in results]
+    else:
+        return results
+
+
+def _format_marker(marker, first=True):
+    assert isinstance(marker, (list, tuple, string_types))
+
+    # Sometimes we have a structure like [[...]] which is a single item list
+    # where the single item is itself it's own list. In that case we want skip
+    # the rest of this function so that we don't get extraneous () on the
+    # outside.
+    if (isinstance(marker, list) and len(marker) == 1 and
+            isinstance(marker[0], (list, tuple))):
+        return _format_marker(marker[0])
+
+    if isinstance(marker, list):
+        inner = (_format_marker(m, first=False) for m in marker)
+        if first:
+            return " ".join(inner)
+        else:
+            return "(" + " ".join(inner) + ")"
+    elif isinstance(marker, tuple):
+        return " ".join([m.serialize() for m in marker])
+    else:
+        return marker
+
+
+_operators = {
+    "in": lambda lhs, rhs: lhs in rhs,
+    "not in": lambda lhs, rhs: lhs not in rhs,
+    "<": operator.lt,
+    "<=": operator.le,
+    "==": operator.eq,
+    "!=": operator.ne,
+    ">=": operator.ge,
+    ">": operator.gt,
+}
+
+
+def _eval_op(lhs, op, rhs):
+    try:
+        spec = Specifier("".join([op.serialize(), rhs]))
+    except InvalidSpecifier:
+        pass
+    else:
+        return spec.contains(lhs)
+
+    oper = _operators.get(op.serialize())
+    if oper is None:
+        raise UndefinedComparison(
+            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
+        )
+
+    return oper(lhs, rhs)
+
+
+_undefined = object()
+
+
+def _get_env(environment, name):
+    value = environment.get(name, _undefined)
+
+    if value is _undefined:
+        raise UndefinedEnvironmentName(
+            "{0!r} does not exist in evaluation environment.".format(name)
+        )
+
+    return value
+
+
+def _evaluate_markers(markers, environment):
+    groups = [[]]
+
+    for marker in markers:
+        assert isinstance(marker, (list, tuple, string_types))
+
+        if isinstance(marker, list):
+            groups[-1].append(_evaluate_markers(marker, environment))
+        elif isinstance(marker, tuple):
+            lhs, op, rhs = marker
+
+            if isinstance(lhs, Variable):
+                lhs_value = _get_env(environment, lhs.value)
+                rhs_value = rhs.value
+            else:
+                lhs_value = lhs.value
+                rhs_value = _get_env(environment, rhs.value)
+
+            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
+        else:
+            assert marker in ["and", "or"]
+            if marker == "or":
+                groups.append([])
+
+    return any(all(item) for item in groups)
+
+
+def format_full_version(info):
+    version = '{0.major}.{0.minor}.{0.micro}'.format(info)
+    kind = info.releaselevel
+    if kind != 'final':
+        version += kind[0] + str(info.serial)
+    return version
+
+
+def default_environment():
+    if hasattr(sys, 'implementation'):
+        iver = format_full_version(sys.implementation.version)
+        implementation_name = sys.implementation.name
+    else:
+        iver = '0'
+        implementation_name = ''
+
+    return {
+        "implementation_name": implementation_name,
+        "implementation_version": iver,
+        "os_name": os.name,
+        "platform_machine": platform.machine(),
+        "platform_release": platform.release(),
+        "platform_system": platform.system(),
+        "platform_version": platform.version(),
+        "python_full_version": platform.python_version(),
+        "platform_python_implementation": platform.python_implementation(),
+        "python_version": platform.python_version()[:3],
+        "sys_platform": sys.platform,
+    }
+
+
+class Marker(object):
+
+    def __init__(self, marker):
+        try:
+            self._markers = _coerce_parse_result(MARKER.parseString(marker))
+        except ParseException as e:
+            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
+                marker, marker[e.loc:e.loc + 8])
+            raise InvalidMarker(err_str)
+
+    def __str__(self):
+        return _format_marker(self._markers)
+
+    def __repr__(self):
+        return "<Marker({0!r})>".format(str(self))
+
+    def evaluate(self, environment=None):
+        """Evaluate a marker.
+
+        Return the boolean from evaluating the given marker against the
+        environment. environment is an optional argument to override all or
+        part of the determined environment.
+
+        The environment is determined from the current Python process.
+        """
+        current_environment = default_environment()
+        if environment is not None:
+            current_environment.update(environment)
+
+        return _evaluate_markers(self._markers, current_environment)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c8c4a3852fd37053fd552846aa7787805c30a48
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.py
@@ -0,0 +1,127 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import string
+import re
+
+from pkg_resources.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
+from pkg_resources.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
+from pkg_resources.extern.pyparsing import Literal as L  # noqa
+from pkg_resources.extern.six.moves.urllib import parse as urlparse
+
+from .markers import MARKER_EXPR, Marker
+from .specifiers import LegacySpecifier, Specifier, SpecifierSet
+
+
+class InvalidRequirement(ValueError):
+    """
+    An invalid requirement was found, users should refer to PEP 508.
+    """
+
+
+ALPHANUM = Word(string.ascii_letters + string.digits)
+
+LBRACKET = L("[").suppress()
+RBRACKET = L("]").suppress()
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+COMMA = L(",").suppress()
+SEMICOLON = L(";").suppress()
+AT = L("@").suppress()
+
+PUNCTUATION = Word("-_.")
+IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
+IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))
+
+NAME = IDENTIFIER("name")
+EXTRA = IDENTIFIER
+
+URI = Regex(r'[^ ]+')("url")
+URL = (AT + URI)
+
+EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
+EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")
+
+VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
+VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)
+
+VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
+VERSION_MANY = Combine(VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE),
+                       joinString=",", adjacent=False)("_raw_spec")
+_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
+_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or '')
+
+VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
+VERSION_SPEC.setParseAction(lambda s, l, t: t[1])
+
+MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
+MARKER_EXPR.setParseAction(
+    lambda s, l, t: Marker(s[t._original_start:t._original_end])
+)
+MARKER_SEPERATOR = SEMICOLON
+MARKER = MARKER_SEPERATOR + MARKER_EXPR
+
+VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
+URL_AND_MARKER = URL + Optional(MARKER)
+
+NAMED_REQUIREMENT = \
+    NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)
+
+REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
+
+
+class Requirement(object):
+    """Parse a requirement.
+
+    Parse a given requirement string into its parts, such as name, specifier,
+    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
+    string.
+    """
+
+    # TODO: Can we test whether something is contained within a requirement?
+    #       If so how do we do that? Do we need to test against the _name_ of
+    #       the thing as well as the version? What about the markers?
+    # TODO: Can we normalize the name and extra name?
+
+    def __init__(self, requirement_string):
+        try:
+            req = REQUIREMENT.parseString(requirement_string)
+        except ParseException as e:
+            raise InvalidRequirement(
+                "Invalid requirement, parse error at \"{0!r}\"".format(
+                    requirement_string[e.loc:e.loc + 8]))
+
+        self.name = req.name
+        if req.url:
+            parsed_url = urlparse.urlparse(req.url)
+            if not (parsed_url.scheme and parsed_url.netloc) or (
+                    not parsed_url.scheme and not parsed_url.netloc):
+                raise InvalidRequirement("Invalid URL given")
+            self.url = req.url
+        else:
+            self.url = None
+        self.extras = set(req.extras.asList() if req.extras else [])
+        self.specifier = SpecifierSet(req.specifier)
+        self.marker = req.marker if req.marker else None
+
+    def __str__(self):
+        parts = [self.name]
+
+        if self.extras:
+            parts.append("[{0}]".format(",".join(sorted(self.extras))))
+
+        if self.specifier:
+            parts.append(str(self.specifier))
+
+        if self.url:
+            parts.append("@ {0}".format(self.url))
+
+        if self.marker:
+            parts.append("; {0}".format(self.marker))
+
+        return "".join(parts)
+
+    def __repr__(self):
+        return "<Requirement({0!r})>".format(str(self))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py
new file mode 100644
index 0000000000000000000000000000000000000000..7f5a76cfd63f47dcce29b3ea82f59d10f4e8d771
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.py
@@ -0,0 +1,774 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import abc
+import functools
+import itertools
+import re
+
+from ._compat import string_types, with_metaclass
+from .version import Version, LegacyVersion, parse
+
+
+class InvalidSpecifier(ValueError):
+    """
+    An invalid specifier was found, users should refer to PEP 440.
+    """
+
+
+class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):
+
+    @abc.abstractmethod
+    def __str__(self):
+        """
+        Returns the str representation of this Specifier like object. This
+        should be representative of the Specifier itself.
+        """
+
+    @abc.abstractmethod
+    def __hash__(self):
+        """
+        Returns a hash value for this Specifier like object.
+        """
+
+    @abc.abstractmethod
+    def __eq__(self, other):
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are equal.
+        """
+
+    @abc.abstractmethod
+    def __ne__(self, other):
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are not equal.
+        """
+
+    @abc.abstractproperty
+    def prereleases(self):
+        """
+        Returns whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @prereleases.setter
+    def prereleases(self, value):
+        """
+        Sets whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @abc.abstractmethod
+    def contains(self, item, prereleases=None):
+        """
+        Determines if the given item is contained within this specifier.
+        """
+
+    @abc.abstractmethod
+    def filter(self, iterable, prereleases=None):
+        """
+        Takes an iterable of items and filters them so that only items which
+        are contained within this specifier are allowed in it.
+        """
+
+
+class _IndividualSpecifier(BaseSpecifier):
+
+    _operators = {}
+
+    def __init__(self, spec="", prereleases=None):
+        match = self._regex.search(spec)
+        if not match:
+            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))
+
+        self._spec = (
+            match.group("operator").strip(),
+            match.group("version").strip(),
+        )
+
+        # Store whether or not this Specifier should accept prereleases
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<{0}({1!r}{2})>".format(
+            self.__class__.__name__,
+            str(self),
+            pre,
+        )
+
+    def __str__(self):
+        return "{0}{1}".format(*self._spec)
+
+    def __hash__(self):
+        return hash(self._spec)
+
+    def __eq__(self, other):
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(other)
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec == other._spec
+
+    def __ne__(self, other):
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(other)
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec != other._spec
+
+    def _get_operator(self, op):
+        return getattr(self, "_compare_{0}".format(self._operators[op]))
+
+    def _coerce_version(self, version):
+        if not isinstance(version, (LegacyVersion, Version)):
+            version = parse(version)
+        return version
+
+    @property
+    def operator(self):
+        return self._spec[0]
+
+    @property
+    def version(self):
+        return self._spec[1]
+
+    @property
+    def prereleases(self):
+        return self._prereleases
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+    def __contains__(self, item):
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # Determine if prereleases are to be allowed or not.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # Normalize item to a Version or LegacyVersion, this allows us to have
+        # a shortcut for ``"2.0" in Specifier(">=2")
+        item = self._coerce_version(item)
+
+        # Determine if we should be supporting prereleases in this specifier
+        # or not, if we do not support prereleases than we can short circuit
+        # logic if this version is a prereleases.
+        if item.is_prerelease and not prereleases:
+            return False
+
+        # Actually do the comparison to determine if this item is contained
+        # within this Specifier or not.
+        return self._get_operator(self.operator)(item, self.version)
+
+    def filter(self, iterable, prereleases=None):
+        yielded = False
+        found_prereleases = []
+
+        kw = {"prereleases": prereleases if prereleases is not None else True}
+
+        # Attempt to iterate over all the values in the iterable and if any of
+        # them match, yield them.
+        for version in iterable:
+            parsed_version = self._coerce_version(version)
+
+            if self.contains(parsed_version, **kw):
+                # If our version is a prerelease, and we were not set to allow
+                # prereleases, then we'll store it for later incase nothing
+                # else matches this specifier.
+                if (parsed_version.is_prerelease and not
+                        (prereleases or self.prereleases)):
+                    found_prereleases.append(version)
+                # Either this is not a prerelease, or we should have been
+                # accepting prereleases from the begining.
+                else:
+                    yielded = True
+                    yield version
+
+        # Now that we've iterated over everything, determine if we've yielded
+        # any values, and if we have not and we have any prereleases stored up
+        # then we will go ahead and yield the prereleases.
+        if not yielded and found_prereleases:
+            for version in found_prereleases:
+                yield version
+
+
+class LegacySpecifier(_IndividualSpecifier):
+
+    _regex_str = (
+        r"""
+        (?P<operator>(==|!=|<=|>=|<|>))
+        \s*
+        (?P<version>
+            [^,;\s)]* # Since this is a "legacy" specifier, and the version
+                      # string can be just about anything, we match everything
+                      # except for whitespace, a semi-colon for marker support,
+                      # a closing paren since versions can be enclosed in
+                      # them, and a comma since it's a version separator.
+        )
+        """
+    )
+
+    _regex = re.compile(
+        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+    }
+
+    def _coerce_version(self, version):
+        if not isinstance(version, LegacyVersion):
+            version = LegacyVersion(str(version))
+        return version
+
+    def _compare_equal(self, prospective, spec):
+        return prospective == self._coerce_version(spec)
+
+    def _compare_not_equal(self, prospective, spec):
+        return prospective != self._coerce_version(spec)
+
+    def _compare_less_than_equal(self, prospective, spec):
+        return prospective <= self._coerce_version(spec)
+
+    def _compare_greater_than_equal(self, prospective, spec):
+        return prospective >= self._coerce_version(spec)
+
+    def _compare_less_than(self, prospective, spec):
+        return prospective < self._coerce_version(spec)
+
+    def _compare_greater_than(self, prospective, spec):
+        return prospective > self._coerce_version(spec)
+
+
+def _require_version_compare(fn):
+    @functools.wraps(fn)
+    def wrapped(self, prospective, spec):
+        if not isinstance(prospective, Version):
+            return False
+        return fn(self, prospective, spec)
+    return wrapped
+
+
+class Specifier(_IndividualSpecifier):
+
+    _regex_str = (
+        r"""
+        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
+        (?P<version>
+            (?:
+                # The identity operators allow for an escape hatch that will
+                # do an exact string match of the version you wish to install.
+                # This will not be parsed by PEP 440 and we cannot determine
+                # any semantic meaning from it. This operator is discouraged
+                # but included entirely as an escape hatch.
+                (?<====)  # Only match for the identity operator
+                \s*
+                [^\s]*    # We just match everything, except for whitespace
+                          # since we are only testing for strict identity.
+            )
+            |
+            (?:
+                # The (non)equality operators allow for wild card and local
+                # versions to be specified so we have to define these two
+                # operators separately to enable that.
+                (?<===|!=)            # Only match for equals and not equals
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+
+                # You cannot use a wild card and a dev or local version
+                # together so group them with a | and make them optional.
+                (?:
+                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
+                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
+                    |
+                    \.\*  # Wild card syntax of .*
+                )?
+            )
+            |
+            (?:
+                # The compatible operator requires at least two digits in the
+                # release segment.
+                (?<=~=)               # Only match for the compatible operator
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+            |
+            (?:
+                # All other operators only allow a sub set of what the
+                # (non)equality operators do. Specifically they do not allow
+                # local versions to be specified nor do they allow the prefix
+                # matching wild cards.
+                (?<!==|!=|~=)         # We have special cases for these
+                                      # operators so we want to make sure they
+                                      # don't match here.
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+        )
+        """
+    )
+
+    _regex = re.compile(
+        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "~=": "compatible",
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+        "===": "arbitrary",
+    }
+
+    @_require_version_compare
+    def _compare_compatible(self, prospective, spec):
+        # Compatible releases have an equivalent combination of >= and ==. That
+        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
+        # implement this in terms of the other specifiers instead of
+        # implementing it ourselves. The only thing we need to do is construct
+        # the other specifiers.
+
+        # We want everything but the last item in the version, but we want to
+        # ignore post and dev releases and we want to treat the pre-release as
+        # it's own separate segment.
+        prefix = ".".join(
+            list(
+                itertools.takewhile(
+                    lambda x: (not x.startswith("post") and not
+                               x.startswith("dev")),
+                    _version_split(spec),
+                )
+            )[:-1]
+        )
+
+        # Add the prefix notation to the end of our string
+        prefix += ".*"
+
+        return (self._get_operator(">=")(prospective, spec) and
+                self._get_operator("==")(prospective, prefix))
+
+    @_require_version_compare
+    def _compare_equal(self, prospective, spec):
+        # We need special logic to handle prefix matching
+        if spec.endswith(".*"):
+            # In the case of prefix matching we want to ignore local segment.
+            prospective = Version(prospective.public)
+            # Split the spec out by dots, and pretend that there is an implicit
+            # dot in between a release segment and a pre-release segment.
+            spec = _version_split(spec[:-2])  # Remove the trailing .*
+
+            # Split the prospective version out by dots, and pretend that there
+            # is an implicit dot in between a release segment and a pre-release
+            # segment.
+            prospective = _version_split(str(prospective))
+
+            # Shorten the prospective version to be the same length as the spec
+            # so that we can determine if the specifier is a prefix of the
+            # prospective version or not.
+            prospective = prospective[:len(spec)]
+
+            # Pad out our two sides with zeros so that they both equal the same
+            # length.
+            spec, prospective = _pad_version(spec, prospective)
+        else:
+            # Convert our spec string into a Version
+            spec = Version(spec)
+
+            # If the specifier does not have a local segment, then we want to
+            # act as if the prospective version also does not have a local
+            # segment.
+            if not spec.local:
+                prospective = Version(prospective.public)
+
+        return prospective == spec
+
+    @_require_version_compare
+    def _compare_not_equal(self, prospective, spec):
+        return not self._compare_equal(prospective, spec)
+
+    @_require_version_compare
+    def _compare_less_than_equal(self, prospective, spec):
+        return prospective <= Version(spec)
+
+    @_require_version_compare
+    def _compare_greater_than_equal(self, prospective, spec):
+        return prospective >= Version(spec)
+
+    @_require_version_compare
+    def _compare_less_than(self, prospective, spec):
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec)
+
+        # Check to see if the prospective version is less than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective < spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a pre-release version, that we do not accept pre-release
+        # versions for the version mentioned in the specifier (e.g. <3.1 should
+        # not match 3.1.dev0, but should match 3.0.dev0).
+        if not spec.is_prerelease and prospective.is_prerelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # less than the spec version *and* it's not a pre-release of the same
+        # version in the spec.
+        return True
+
+    @_require_version_compare
+    def _compare_greater_than(self, prospective, spec):
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec)
+
+        # Check to see if the prospective version is greater than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective > spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a post-release version, that we do not accept
+        # post-release versions for the version mentioned in the specifier
+        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
+        if not spec.is_postrelease and prospective.is_postrelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # Ensure that we do not allow a local version of the version mentioned
+        # in the specifier, which is techincally greater than, to match.
+        if prospective.local is not None:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # greater than the spec version *and* it's not a pre-release of the
+        # same version in the spec.
+        return True
+
+    def _compare_arbitrary(self, prospective, spec):
+        return str(prospective).lower() == str(spec).lower()
+
+    @property
+    def prereleases(self):
+        # If there is an explicit prereleases set for this, then we'll just
+        # blindly use that.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # Look at all of our specifiers and determine if they are inclusive
+        # operators, and if they are if they are including an explicit
+        # prerelease.
+        operator, version = self._spec
+        if operator in ["==", ">=", "<=", "~=", "==="]:
+            # The == specifier can include a trailing .*, if it does we
+            # want to remove before parsing.
+            if operator == "==" and version.endswith(".*"):
+                version = version[:-2]
+
+            # Parse the version, and if it is a pre-release than this
+            # specifier allows pre-releases.
+            if parse(version).is_prerelease:
+                return True
+
+        return False
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+
+_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
+
+
+def _version_split(version):
+    result = []
+    for item in version.split("."):
+        match = _prefix_regex.search(item)
+        if match:
+            result.extend(match.groups())
+        else:
+            result.append(item)
+    return result
+
+
+def _pad_version(left, right):
+    left_split, right_split = [], []
+
+    # Get the release segment of our versions
+    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
+    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))
+
+    # Get the rest of our versions
+    left_split.append(left[len(left_split[0]):])
+    right_split.append(right[len(right_split[0]):])
+
+    # Insert our padding
+    left_split.insert(
+        1,
+        ["0"] * max(0, len(right_split[0]) - len(left_split[0])),
+    )
+    right_split.insert(
+        1,
+        ["0"] * max(0, len(left_split[0]) - len(right_split[0])),
+    )
+
+    return (
+        list(itertools.chain(*left_split)),
+        list(itertools.chain(*right_split)),
+    )
+
+
+class SpecifierSet(BaseSpecifier):
+
+    def __init__(self, specifiers="", prereleases=None):
+        # Split on , to break each indidivual specifier into it's own item, and
+        # strip each item to remove leading/trailing whitespace.
+        specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
+
+        # Parsed each individual specifier, attempting first to make it a
+        # Specifier and falling back to a LegacySpecifier.
+        parsed = set()
+        for specifier in specifiers:
+            try:
+                parsed.add(Specifier(specifier))
+            except InvalidSpecifier:
+                parsed.add(LegacySpecifier(specifier))
+
+        # Turn our parsed specifiers into a frozen set and save them for later.
+        self._specs = frozenset(parsed)
+
+        # Store our prereleases value so we can use it later to determine if
+        # we accept prereleases or not.
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)
+
+    def __str__(self):
+        return ",".join(sorted(str(s) for s in self._specs))
+
+    def __hash__(self):
+        return hash(self._specs)
+
+    def __and__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        specifier = SpecifierSet()
+        specifier._specs = frozenset(self._specs | other._specs)
+
+        if self._prereleases is None and other._prereleases is not None:
+            specifier._prereleases = other._prereleases
+        elif self._prereleases is not None and other._prereleases is None:
+            specifier._prereleases = self._prereleases
+        elif self._prereleases == other._prereleases:
+            specifier._prereleases = self._prereleases
+        else:
+            raise ValueError(
+                "Cannot combine SpecifierSets with True and False prerelease "
+                "overrides."
+            )
+
+        return specifier
+
+    def __eq__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif isinstance(other, _IndividualSpecifier):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs == other._specs
+
+    def __ne__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif isinstance(other, _IndividualSpecifier):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs != other._specs
+
+    def __len__(self):
+        return len(self._specs)
+
+    def __iter__(self):
+        return iter(self._specs)
+
+    @property
+    def prereleases(self):
+        # If we have been given an explicit prerelease modifier, then we'll
+        # pass that through here.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # If we don't have any specifiers, and we don't have a forced value,
+        # then we'll just return None since we don't know if this should have
+        # pre-releases or not.
+        if not self._specs:
+            return None
+
+        # Otherwise we'll see if any of the given specifiers accept
+        # prereleases, if any of them do we'll return True, otherwise False.
+        return any(s.prereleases for s in self._specs)
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+    def __contains__(self, item):
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # Ensure that our item is a Version or LegacyVersion instance.
+        if not isinstance(item, (LegacyVersion, Version)):
+            item = parse(item)
+
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # We can determine if we're going to allow pre-releases by looking to
+        # see if any of the underlying items supports them. If none of them do
+        # and this item is a pre-release then we do not allow it and we can
+        # short circuit that here.
+        # Note: This means that 1.0.dev1 would not be contained in something
+        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
+        if not prereleases and item.is_prerelease:
+            return False
+
+        # We simply dispatch to the underlying specs here to make sure that the
+        # given version is contained within all of them.
+        # Note: This use of all() here means that an empty set of specifiers
+        #       will always return True, this is an explicit design decision.
+        return all(
+            s.contains(item, prereleases=prereleases)
+            for s in self._specs
+        )
+
+    def filter(self, iterable, prereleases=None):
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # If we have any specifiers, then we want to wrap our iterable in the
+        # filter method for each one, this will act as a logical AND amongst
+        # each specifier.
+        if self._specs:
+            for spec in self._specs:
+                iterable = spec.filter(iterable, prereleases=bool(prereleases))
+            return iterable
+        # If we do not have any specifiers, then we need to have a rough filter
+        # which will filter out any pre-releases, unless there are no final
+        # releases, and which will filter out LegacyVersion in general.
+        else:
+            filtered = []
+            found_prereleases = []
+
+            for item in iterable:
+                # Ensure that we some kind of Version class for this item.
+                if not isinstance(item, (LegacyVersion, Version)):
+                    parsed_version = parse(item)
+                else:
+                    parsed_version = item
+
+                # Filter out any item which is parsed as a LegacyVersion
+                if isinstance(parsed_version, LegacyVersion):
+                    continue
+
+                # Store any item which is a pre-release for later unless we've
+                # already found a final version or we are accepting prereleases
+                if parsed_version.is_prerelease and not prereleases:
+                    if not filtered:
+                        found_prereleases.append(item)
+                else:
+                    filtered.append(item)
+
+            # If we've found no items except for pre-releases, then we'll go
+            # ahead and use the pre-releases
+            if not filtered and found_prereleases and prereleases is None:
+                return found_prereleases
+
+            return filtered
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..942387cef5d75f299a769b1eb43b6c7679e7a3a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py
@@ -0,0 +1,14 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import re
+
+
+_canonicalize_regex = re.compile(r"[-_.]+")
+
+
+def canonicalize_name(name):
+    # This is taken from PEP 503.
+    return _canonicalize_regex.sub("-", name).lower()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..83b5ee8c5efadf22ce2f16ff08c8a8d75f1eb5df
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.py
@@ -0,0 +1,393 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import collections
+import itertools
+import re
+
+from ._structures import Infinity
+
+
+__all__ = [
+    "parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"
+]
+
+
+_Version = collections.namedtuple(
+    "_Version",
+    ["epoch", "release", "dev", "pre", "post", "local"],
+)
+
+
+def parse(version):
+    """
+    Parse the given version string and return either a :class:`Version` object
+    or a :class:`LegacyVersion` object depending on if the given version is
+    a valid PEP 440 version or a legacy version.
+    """
+    try:
+        return Version(version)
+    except InvalidVersion:
+        return LegacyVersion(version)
+
+
+class InvalidVersion(ValueError):
+    """
+    An invalid version was found, users should refer to PEP 440.
+    """
+
+
+class _BaseVersion(object):
+
+    def __hash__(self):
+        return hash(self._key)
+
+    def __lt__(self, other):
+        return self._compare(other, lambda s, o: s < o)
+
+    def __le__(self, other):
+        return self._compare(other, lambda s, o: s <= o)
+
+    def __eq__(self, other):
+        return self._compare(other, lambda s, o: s == o)
+
+    def __ge__(self, other):
+        return self._compare(other, lambda s, o: s >= o)
+
+    def __gt__(self, other):
+        return self._compare(other, lambda s, o: s > o)
+
+    def __ne__(self, other):
+        return self._compare(other, lambda s, o: s != o)
+
+    def _compare(self, other, method):
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return method(self._key, other._key)
+
+
+class LegacyVersion(_BaseVersion):
+
+    def __init__(self, version):
+        self._version = str(version)
+        self._key = _legacy_cmpkey(self._version)
+
+    def __str__(self):
+        return self._version
+
+    def __repr__(self):
+        return "<LegacyVersion({0})>".format(repr(str(self)))
+
+    @property
+    def public(self):
+        return self._version
+
+    @property
+    def base_version(self):
+        return self._version
+
+    @property
+    def local(self):
+        return None
+
+    @property
+    def is_prerelease(self):
+        return False
+
+    @property
+    def is_postrelease(self):
+        return False
+
+
+_legacy_version_component_re = re.compile(
+    r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE,
+)
+
+_legacy_version_replacement_map = {
+    "pre": "c", "preview": "c", "-": "final-", "rc": "c", "dev": "@",
+}
+
+
+def _parse_version_parts(s):
+    for part in _legacy_version_component_re.split(s):
+        part = _legacy_version_replacement_map.get(part, part)
+
+        if not part or part == ".":
+            continue
+
+        if part[:1] in "0123456789":
+            # pad for numeric comparison
+            yield part.zfill(8)
+        else:
+            yield "*" + part
+
+    # ensure that alpha/beta/candidate are before final
+    yield "*final"
+
+
+def _legacy_cmpkey(version):
+    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
+    # greater than or equal to 0. This will effectively put the LegacyVersion,
+    # which uses the defacto standard originally implemented by setuptools,
+    # as before all PEP 440 versions.
+    epoch = -1
+
+    # This scheme is taken from pkg_resources.parse_version setuptools prior to
+    # it's adoption of the packaging library.
+    parts = []
+    for part in _parse_version_parts(version.lower()):
+        if part.startswith("*"):
+            # remove "-" before a prerelease tag
+            if part < "*final":
+                while parts and parts[-1] == "*final-":
+                    parts.pop()
+
+            # remove trailing zeros from each series of numeric parts
+            while parts and parts[-1] == "00000000":
+                parts.pop()
+
+        parts.append(part)
+    parts = tuple(parts)
+
+    return epoch, parts
+
+# Deliberately not anchored to the start and end of the string, to make it
+# easier for 3rd party code to reuse
+VERSION_PATTERN = r"""
+    v?
+    (?:
+        (?:(?P<epoch>[0-9]+)!)?                           # epoch
+        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P<pre>                                          # pre-release
+            [-_\.]?
+            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
+            [-_\.]?
+            (?P<pre_n>[0-9]+)?
+        )?
+        (?P<post>                                         # post release
+            (?:-(?P<post_n1>[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?P<post_l>post|rev|r)
+                [-_\.]?
+                (?P<post_n2>[0-9]+)?
+            )
+        )?
+        (?P<dev>                                          # dev release
+            [-_\.]?
+            (?P<dev_l>dev)
+            [-_\.]?
+            (?P<dev_n>[0-9]+)?
+        )?
+    )
+    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+
+class Version(_BaseVersion):
+
+    _regex = re.compile(
+        r"^\s*" + VERSION_PATTERN + r"\s*$",
+        re.VERBOSE | re.IGNORECASE,
+    )
+
+    def __init__(self, version):
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion("Invalid version: '{0}'".format(version))
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(
+                match.group("pre_l"),
+                match.group("pre_n"),
+            ),
+            post=_parse_letter_version(
+                match.group("post_l"),
+                match.group("post_n1") or match.group("post_n2"),
+            ),
+            dev=_parse_letter_version(
+                match.group("dev_l"),
+                match.group("dev_n"),
+            ),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self):
+        return "<Version({0})>".format(repr(str(self)))
+
+    def __str__(self):
+        parts = []
+
+        # Epoch
+        if self._version.epoch != 0:
+            parts.append("{0}!".format(self._version.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self._version.release))
+
+        # Pre-release
+        if self._version.pre is not None:
+            parts.append("".join(str(x) for x in self._version.pre))
+
+        # Post-release
+        if self._version.post is not None:
+            parts.append(".post{0}".format(self._version.post[1]))
+
+        # Development release
+        if self._version.dev is not None:
+            parts.append(".dev{0}".format(self._version.dev[1]))
+
+        # Local version segment
+        if self._version.local is not None:
+            parts.append(
+                "+{0}".format(".".join(str(x) for x in self._version.local))
+            )
+
+        return "".join(parts)
+
+    @property
+    def public(self):
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self):
+        parts = []
+
+        # Epoch
+        if self._version.epoch != 0:
+            parts.append("{0}!".format(self._version.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self._version.release))
+
+        return "".join(parts)
+
+    @property
+    def local(self):
+        version_string = str(self)
+        if "+" in version_string:
+            return version_string.split("+", 1)[1]
+
+    @property
+    def is_prerelease(self):
+        return bool(self._version.dev or self._version.pre)
+
+    @property
+    def is_postrelease(self):
+        return bool(self._version.post)
+
+
+def _parse_letter_version(letter, number):
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+
+_local_version_seperators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local):
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_seperators.split(local)
+        )
+
+
+def _cmpkey(epoch, release, pre, post, dev, local):
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    release = tuple(
+        reversed(list(
+            itertools.dropwhile(
+                lambda x: x == 0,
+                reversed(release),
+            )
+        ))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        pre = -Infinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        pre = Infinity
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        post = -Infinity
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        dev = Infinity
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        local = -Infinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        local = tuple(
+            (i, "") if isinstance(i, int) else (-Infinity, i)
+            for i in local
+        )
+
+    return epoch, release, pre, post, dev, local
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf75e1e5fcbfe7eac41d2a9e446c5c980741087b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py
@@ -0,0 +1,5742 @@
+# module pyparsing.py
+#
+# Copyright (c) 2003-2018  Paul T. McGuire
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+__doc__ = \
+"""
+pyparsing module - Classes and methods to define and execute parsing grammars
+=============================================================================
+
+The pyparsing module is an alternative approach to creating and executing simple grammars,
+vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
+don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
+provides a library of classes that you use to construct the grammar directly in Python.
+
+Here is a program to parse "Hello, World!" (or any greeting of the form 
+C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
+(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
+L{Literal} expressions)::
+
+    from pyparsing import Word, alphas
+
+    # define grammar of a greeting
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+
+    hello = "Hello, World!"
+    print (hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the self-explanatory
+class names, and the use of '+', '|' and '^' operators.
+
+The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
+object with named attributes.
+
+The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
+ - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
+ - quoted strings
+ - embedded comments
+
+
+Getting Started -
+-----------------
+Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
+classes inherit from. Use the docstrings for examples of how to:
+ - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
+ - construct character word-group expressions using the L{Word} class
+ - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
+ - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
+ - associate names with your parsed results using L{ParserElement.setResultsName}
+ - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
+ - find more useful common expressions in the L{pyparsing_common} namespace class
+"""
+
+__version__ = "2.2.1"
+__versionTime__ = "18 Sep 2018 00:49 UTC"
+__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"
+
+import string
+from weakref import ref as wkref
+import copy
+import sys
+import warnings
+import re
+import sre_constants
+import collections
+import pprint
+import traceback
+import types
+from datetime import datetime
+
+try:
+    from _thread import RLock
+except ImportError:
+    from threading import RLock
+
+try:
+    # Python 3
+    from collections.abc import Iterable
+    from collections.abc import MutableMapping
+except ImportError:
+    # Python 2.7
+    from collections import Iterable
+    from collections import MutableMapping
+
+try:
+    from collections import OrderedDict as _OrderedDict
+except ImportError:
+    try:
+        from ordereddict import OrderedDict as _OrderedDict
+    except ImportError:
+        _OrderedDict = None
+
+#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )
+
+__all__ = [
+'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
+'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
+'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
+'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
+'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
+'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
+'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
+'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
+'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
+'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
+'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
+'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
+'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
+'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
+'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
+'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
+'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
+'CloseMatch', 'tokenMap', 'pyparsing_common',
+]
+
+system_version = tuple(sys.version_info)[:3]
+PY_3 = system_version[0] == 3
+if PY_3:
+    _MAX_INT = sys.maxsize
+    basestring = str
+    unichr = chr
+    _ustr = str
+
+    # build list of single arg builtins, that can be used as parse actions
+    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
+
+else:
+    _MAX_INT = sys.maxint
+    range = xrange
+
+    def _ustr(obj):
+        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
+           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
+           then < returns the unicode object | encodes it with the default encoding | ... >.
+        """
+        if isinstance(obj,unicode):
+            return obj
+
+        try:
+            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
+            # it won't break any existing code.
+            return str(obj)
+
+        except UnicodeEncodeError:
+            # Else encode it
+            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
+            xmlcharref = Regex(r'&#\d+;')
+            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
+            return xmlcharref.transformString(ret)
+
+    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
+    singleArgBuiltins = []
+    import __builtin__
+    for fname in "sum len sorted reversed list tuple set any all min max".split():
+        try:
+            singleArgBuiltins.append(getattr(__builtin__,fname))
+        except AttributeError:
+            continue
+            
+_generatorType = type((y for y in range(1)))
+ 
+def _xml_escape(data):
+    """Escape &, <, >, ", ', etc. in a string of data."""
+
+    # ampersand must be replaced first
+    from_symbols = '&><"\''
+    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
+    for from_,to_ in zip(from_symbols, to_symbols):
+        data = data.replace(from_, to_)
+    return data
+
+class _Constants(object):
+    pass
+
+alphas     = string.ascii_uppercase + string.ascii_lowercase
+nums       = "0123456789"
+hexnums    = nums + "ABCDEFabcdef"
+alphanums  = alphas + nums
+_bslash    = chr(92)
+printables = "".join(c for c in string.printable if c not in string.whitespace)
+
+class ParseBaseException(Exception):
+    """base exception class for all parsing runtime exceptions"""
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, pstr, loc=0, msg=None, elem=None ):
+        self.loc = loc
+        if msg is None:
+            self.msg = pstr
+            self.pstr = ""
+        else:
+            self.msg = msg
+            self.pstr = pstr
+        self.parserElement = elem
+        self.args = (pstr, loc, msg)
+
+    @classmethod
+    def _from_exception(cls, pe):
+        """
+        internal factory method to simplify creating one type of ParseException 
+        from another - avoids having __init__ signature conflicts among subclasses
+        """
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+
+    def __getattr__( self, aname ):
+        """supported attributes by name are:
+            - lineno - returns the line number of the exception text
+            - col - returns the column number of the exception text
+            - line - returns the line containing the exception text
+        """
+        if( aname == "lineno" ):
+            return lineno( self.loc, self.pstr )
+        elif( aname in ("col", "column") ):
+            return col( self.loc, self.pstr )
+        elif( aname == "line" ):
+            return line( self.loc, self.pstr )
+        else:
+            raise AttributeError(aname)
+
+    def __str__( self ):
+        return "%s (at char %d), (line:%d, col:%d)" % \
+                ( self.msg, self.loc, self.lineno, self.column )
+    def __repr__( self ):
+        return _ustr(self)
+    def markInputline( self, markerString = ">!<" ):
+        """Extracts the exception line from the input string, and marks
+           the location of the exception with a special symbol.
+        """
+        line_str = self.line
+        line_column = self.column - 1
+        if markerString:
+            line_str = "".join((line_str[:line_column],
+                                markerString, line_str[line_column:]))
+        return line_str.strip()
+    def __dir__(self):
+        return "lineno col line".split() + dir(type(self))
+
+class ParseException(ParseBaseException):
+    """
+    Exception thrown when parse expressions don't match class;
+    supported attributes by name are:
+     - lineno - returns the line number of the exception text
+     - col - returns the column number of the exception text
+     - line - returns the line containing the exception text
+        
+    Example::
+        try:
+            Word(nums).setName("integer").parseString("ABC")
+        except ParseException as pe:
+            print(pe)
+            print("column: {}".format(pe.col))
+            
+    prints::
+       Expected integer (at char 0), (line:1, col:1)
+        column: 1
+    """
+    pass
+
+class ParseFatalException(ParseBaseException):
+    """user-throwable exception thrown when inconsistent parse content
+       is found; stops all parsing immediately"""
+    pass
+
+class ParseSyntaxException(ParseFatalException):
+    """just like L{ParseFatalException}, but thrown internally when an
+       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
+       immediately because an unbacktrackable syntax error has been found"""
+    pass
+
+#~ class ReparseException(ParseBaseException):
+    #~ """Experimental class - parse actions can raise this exception to cause
+       #~ pyparsing to reparse the input string:
+        #~ - with a modified input string, and/or
+        #~ - with a modified start location
+       #~ Set the values of the ReparseException in the constructor, and raise the
+       #~ exception in a parse action to cause pyparsing to use the new string/location.
+       #~ Setting the values as None causes no change to be made.
+       #~ """
+    #~ def __init_( self, newstring, restartLoc ):
+        #~ self.newParseText = newstring
+        #~ self.reparseLoc = restartLoc
+
+class RecursiveGrammarException(Exception):
+    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
+    def __init__( self, parseElementList ):
+        self.parseElementTrace = parseElementList
+
+    def __str__( self ):
+        return "RecursiveGrammarException: %s" % self.parseElementTrace
+
+class _ParseResultsWithOffset(object):
+    def __init__(self,p1,p2):
+        self.tup = (p1,p2)
+    def __getitem__(self,i):
+        return self.tup[i]
+    def __repr__(self):
+        return repr(self.tup[0])
+    def setOffset(self,i):
+        self.tup = (self.tup[0],i)
+
+class ParseResults(object):
+    """
+    Structured parse results, to provide multiple means of access to the parsed data:
+       - as a list (C{len(results)})
+       - by list index (C{results[0], results[1]}, etc.)
+       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})
+
+    Example::
+        integer = Word(nums)
+        date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+        # equivalent form:
+        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+        # parseString returns a ParseResults object
+        result = date_str.parseString("1999/12/31")
+
+        def test(s, fn=repr):
+            print("%s -> %s" % (s, fn(eval(s))))
+        test("list(result)")
+        test("result[0]")
+        test("result['month']")
+        test("result.day")
+        test("'month' in result")
+        test("'minutes' in result")
+        test("result.dump()", str)
+    prints::
+        list(result) -> ['1999', '/', '12', '/', '31']
+        result[0] -> '1999'
+        result['month'] -> '12'
+        result.day -> '31'
+        'month' in result -> True
+        'minutes' in result -> False
+        result.dump() -> ['1999', '/', '12', '/', '31']
+        - day: 31
+        - month: 12
+        - year: 1999
+    """
+    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
+        if isinstance(toklist, cls):
+            return toklist
+        retobj = object.__new__(cls)
+        retobj.__doinit = True
+        return retobj
+
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
+        if self.__doinit:
+            self.__doinit = False
+            self.__name = None
+            self.__parent = None
+            self.__accumNames = {}
+            self.__asList = asList
+            self.__modal = modal
+            if toklist is None:
+                toklist = []
+            if isinstance(toklist, list):
+                self.__toklist = toklist[:]
+            elif isinstance(toklist, _generatorType):
+                self.__toklist = list(toklist)
+            else:
+                self.__toklist = [toklist]
+            self.__tokdict = dict()
+
+        if name is not None and name:
+            if not modal:
+                self.__accumNames[name] = 0
+            if isinstance(name,int):
+                name = _ustr(name) # will always return a str, but use _ustr for consistency
+            self.__name = name
+            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
+                if isinstance(toklist,basestring):
+                    toklist = [ toklist ]
+                if asList:
+                    if isinstance(toklist,ParseResults):
+                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
+                    else:
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
+                    self[name].__name = name
+                else:
+                    try:
+                        self[name] = toklist[0]
+                    except (KeyError,TypeError,IndexError):
+                        self[name] = toklist
+
+    def __getitem__( self, i ):
+        if isinstance( i, (int,slice) ):
+            return self.__toklist[i]
+        else:
+            if i not in self.__accumNames:
+                return self.__tokdict[i][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[i] ])
+
+    def __setitem__( self, k, v, isinstance=isinstance ):
+        if isinstance(v,_ParseResultsWithOffset):
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
+            sub = v[0]
+        elif isinstance(k,(int,slice)):
+            self.__toklist[k] = v
+            sub = v
+        else:
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
+            sub = v
+        if isinstance(sub,ParseResults):
+            sub.__parent = wkref(self)
+
+    def __delitem__( self, i ):
+        if isinstance(i,(int,slice)):
+            mylen = len( self.__toklist )
+            del self.__toklist[i]
+
+            # convert int to slice
+            if isinstance(i, int):
+                if i < 0:
+                    i += mylen
+                i = slice(i, i+1)
+            # get removed indices
+            removed = list(range(*i.indices(mylen)))
+            removed.reverse()
+            # fixup indices in token dictionary
+            for name,occurrences in self.__tokdict.items():
+                for j in removed:
+                    for k, (value, position) in enumerate(occurrences):
+                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
+        else:
+            del self.__tokdict[i]
+
+    def __contains__( self, k ):
+        return k in self.__tokdict
+
+    def __len__( self ): return len( self.__toklist )
+    def __bool__(self): return ( not not self.__toklist )
+    __nonzero__ = __bool__
+    def __iter__( self ): return iter( self.__toklist )
+    def __reversed__( self ): return iter( self.__toklist[::-1] )
+    def _iterkeys( self ):
+        if hasattr(self.__tokdict, "iterkeys"):
+            return self.__tokdict.iterkeys()
+        else:
+            return iter(self.__tokdict)
+
+    def _itervalues( self ):
+        return (self[k] for k in self._iterkeys())
+            
+    def _iteritems( self ):
+        return ((k, self[k]) for k in self._iterkeys())
+
+    if PY_3:
+        keys = _iterkeys       
+        """Returns an iterator of all named result keys (Python 3.x only)."""
+
+        values = _itervalues
+        """Returns an iterator of all named result values (Python 3.x only)."""
+
+        items = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""
+
+    else:
+        iterkeys = _iterkeys
+        """Returns an iterator of all named result keys (Python 2.x only)."""
+
+        itervalues = _itervalues
+        """Returns an iterator of all named result values (Python 2.x only)."""
+
+        iteritems = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""
+
+        def keys( self ):
+            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iterkeys())
+
+        def values( self ):
+            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.itervalues())
+                
+        def items( self ):
+            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iteritems())
+
+    def haskeys( self ):
+        """Since keys() returns an iterator, this method is helpful in bypassing
+           code that looks for the existence of any defined results names."""
+        return bool(self.__tokdict)
+        
+    def pop( self, *args, **kwargs):
+        """
+        Removes and returns item at specified index (default=C{last}).
+        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
+        argument or an integer argument, it will use C{list} semantics
+        and pop tokens from the list of parsed tokens. If passed a 
+        non-integer argument (most likely a string), it will use C{dict}
+        semantics and pop the corresponding value from any defined 
+        results names. A second default return value argument is 
+        supported, just as in C{dict.pop()}.
+
+        Example::
+            def remove_first(tokens):
+                tokens.pop(0)
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']
+
+            label = Word(alphas)
+            patt = label("LABEL") + OneOrMore(Word(nums))
+            print(patt.parseString("AAB 123 321").dump())
+
+            # Use pop() in a parse action to remove named result (note that corresponding value is not
+            # removed from list form of results)
+            def remove_LABEL(tokens):
+                tokens.pop("LABEL")
+                return tokens
+            patt.addParseAction(remove_LABEL)
+            print(patt.parseString("AAB 123 321").dump())
+        prints::
+            ['AAB', '123', '321']
+            - LABEL: AAB
+
+            ['AAB', '123', '321']
+        """
+        if not args:
+            args = [-1]
+        for k,v in kwargs.items():
+            if k == 'default':
+                args = (args[0], v)
+            else:
+                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
+        if (isinstance(args[0], int) or 
+                        len(args) == 1 or 
+                        args[0] in self):
+            index = args[0]
+            ret = self[index]
+            del self[index]
+            return ret
+        else:
+            defaultvalue = args[1]
+            return defaultvalue
+
+    def get(self, key, defaultValue=None):
+        """
+        Returns named result matching the given key, or if there is no
+        such name, then returns the given C{defaultValue} or C{None} if no
+        C{defaultValue} is specified.
+
+        Similar to C{dict.get()}.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            result = date_str.parseString("1999/12/31")
+            print(result.get("year")) # -> '1999'
+            print(result.get("hour", "not specified")) # -> 'not specified'
+            print(result.get("hour")) # -> None
+        """
+        if key in self:
+            return self[key]
+        else:
+            return defaultValue
+
+    def insert( self, index, insStr ):
+        """
+        Inserts new element at location index in the list of parsed tokens.
+        
+        Similar to C{list.insert()}.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to insert the parse location in the front of the parsed results
+            def insert_locn(locn, tokens):
+                tokens.insert(0, locn)
+            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
+        """
+        self.__toklist.insert(index, insStr)
+        # fixup indices in token dictionary
+        for name,occurrences in self.__tokdict.items():
+            for k, (value, position) in enumerate(occurrences):
+                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
+
+    def append( self, item ):
+        """
+        Add single element to end of ParseResults list of elements.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            
+            # use a parse action to compute the sum of the parsed integers, and add it to the end
+            def append_sum(tokens):
+                tokens.append(sum(map(int, tokens)))
+            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
+        """
+        self.__toklist.append(item)
+
+    def extend( self, itemseq ):
+        """
+        Add sequence of elements to end of ParseResults list of elements.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            
+            # use a parse action to append the reverse of the matched strings, to make a palindrome
+            def make_palindrome(tokens):
+                tokens.extend(reversed([t[::-1] for t in tokens]))
+                return ''.join(tokens)
+            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
+        """
+        if isinstance(itemseq, ParseResults):
+            self += itemseq
+        else:
+            self.__toklist.extend(itemseq)
+
+    def clear( self ):
+        """
+        Clear all elements and results names.
+        """
+        del self.__toklist[:]
+        self.__tokdict.clear()
+
+    def __getattr__( self, name ):
+        try:
+            return self[name]
+        except KeyError:
+            return ""
+            
+        if name in self.__tokdict:
+            if name not in self.__accumNames:
+                return self.__tokdict[name][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[name] ])
+        else:
+            return ""
+
+    def __add__( self, other ):
+        ret = self.copy()
+        ret += other
+        return ret
+
+    def __iadd__( self, other ):
+        if other.__tokdict:
+            offset = len(self.__toklist)
+            addoffset = lambda a: offset if a<0 else a+offset
+            otheritems = other.__tokdict.items()
+            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
+                                for (k,vlist) in otheritems for v in vlist]
+            for k,v in otherdictitems:
+                self[k] = v
+                if isinstance(v[0],ParseResults):
+                    v[0].__parent = wkref(self)
+            
+        self.__toklist += other.__toklist
+        self.__accumNames.update( other.__accumNames )
+        return self
+
+    def __radd__(self, other):
+        if isinstance(other,int) and other == 0:
+            # useful for merging many ParseResults using sum() builtin
+            return self.copy()
+        else:
+            # this may raise a TypeError - so be it
+            return other + self
+        
+    def __repr__( self ):
+        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )
+
+    def __str__( self ):
+        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
+
+    def _asStringList( self, sep='' ):
+        out = []
+        for item in self.__toklist:
+            if out and sep:
+                out.append(sep)
+            if isinstance( item, ParseResults ):
+                out += item._asStringList()
+            else:
+                out.append( _ustr(item) )
+        return out
+
+    def asList( self ):
+        """
+        Returns the parse results as a nested list of matching tokens, all converted to strings.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            result = patt.parseString("sldkj lsdkj sldkj")
+            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
+            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
+            
+            # Use asList() to create an actual list
+            result_list = result.asList()
+            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
+        """
+        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]
+
+    def asDict( self ):
+        """
+        Returns the named parse results as a nested dictionary.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
+            
+            result_dict = result.asDict()
+            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}
+
+            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
+            import json
+            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
+            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
+        """
+        if PY_3:
+            item_fn = self.items
+        else:
+            item_fn = self.iteritems
+            
+        def toItem(obj):
+            if isinstance(obj, ParseResults):
+                if obj.haskeys():
+                    return obj.asDict()
+                else:
+                    return [toItem(v) for v in obj]
+            else:
+                return obj
+                
+        return dict((k,toItem(v)) for k,v in item_fn())
+
+    def copy( self ):
+        """
+        Returns a new copy of a C{ParseResults} object.
+        """
+        ret = ParseResults( self.__toklist )
+        ret.__tokdict = self.__tokdict.copy()
+        ret.__parent = self.__parent
+        ret.__accumNames.update( self.__accumNames )
+        ret.__name = self.__name
+        return ret
+
+    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
+        """
+        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
+        """
+        nl = "\n"
+        out = []
+        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
+                                                            for v in vlist)
+        nextLevelIndent = indent + "  "
+
+        # collapse out indents if formatting is not desired
+        if not formatted:
+            indent = ""
+            nextLevelIndent = ""
+            nl = ""
+
+        selfTag = None
+        if doctag is not None:
+            selfTag = doctag
+        else:
+            if self.__name:
+                selfTag = self.__name
+
+        if not selfTag:
+            if namedItemsOnly:
+                return ""
+            else:
+                selfTag = "ITEM"
+
+        out += [ nl, indent, "<", selfTag, ">" ]
+
+        for i,res in enumerate(self.__toklist):
+            if isinstance(res,ParseResults):
+                if i in namedItems:
+                    out += [ res.asXML(namedItems[i],
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+                else:
+                    out += [ res.asXML(None,
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+            else:
+                # individual token, see if there is a name for it
+                resTag = None
+                if i in namedItems:
+                    resTag = namedItems[i]
+                if not resTag:
+                    if namedItemsOnly:
+                        continue
+                    else:
+                        resTag = "ITEM"
+                xmlBodyText = _xml_escape(_ustr(res))
+                out += [ nl, nextLevelIndent, "<", resTag, ">",
+                                                xmlBodyText,
+                                                "</", resTag, ">" ]
+
+        out += [ nl, indent, "</", selfTag, ">" ]
+        return "".join(out)
+
+    def __lookup(self,sub):
+        for k,vlist in self.__tokdict.items():
+            for v,loc in vlist:
+                if sub is v:
+                    return k
+        return None
+
+    def getName(self):
+        r"""
+        Returns the results name for this token expression. Useful when several 
+        different expressions might match at a particular location.
+
+        Example::
+            integer = Word(nums)
+            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
+            house_number_expr = Suppress('#') + Word(nums, alphanums)
+            user_data = (Group(house_number_expr)("house_number") 
+                        | Group(ssn_expr)("ssn")
+                        | Group(integer)("age"))
+            user_info = OneOrMore(user_data)
+            
+            result = user_info.parseString("22 111-22-3333 #221B")
+            for item in result:
+                print(item.getName(), ':', item[0])
+        prints::
+            age : 22
+            ssn : 111-22-3333
+            house_number : 221B
+        """
+        if self.__name:
+            return self.__name
+        elif self.__parent:
+            par = self.__parent()
+            if par:
+                return par.__lookup(self)
+            else:
+                return None
+        elif (len(self) == 1 and
+               len(self.__tokdict) == 1 and
+               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
+            return next(iter(self.__tokdict.keys()))
+        else:
+            return None
+
+    def dump(self, indent='', depth=0, full=True):
+        """
+        Diagnostic method for listing out the contents of a C{ParseResults}.
+        Accepts an optional C{indent} argument so that this string can be embedded
+        in a nested display of other data.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(result.dump())
+        prints::
+            ['12', '/', '31', '/', '1999']
+            - day: 1999
+            - month: 31
+            - year: 12
+        """
+        out = []
+        NL = '\n'
+        out.append( indent+_ustr(self.asList()) )
+        if full:
+            if self.haskeys():
+                items = sorted((str(k), v) for k,v in self.items())
+                for k,v in items:
+                    if out:
+                        out.append(NL)
+                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
+                    if isinstance(v,ParseResults):
+                        if v:
+                            out.append( v.dump(indent,depth+1) )
+                        else:
+                            out.append(_ustr(v))
+                    else:
+                        out.append(repr(v))
+            elif any(isinstance(vv,ParseResults) for vv in self):
+                v = self
+                for i,vv in enumerate(v):
+                    if isinstance(vv,ParseResults):
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
+                    else:
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
+            
+        return "".join(out)
+
+    def pprint(self, *args, **kwargs):
+        """
+        Pretty-printer for parsed results as a list, using the C{pprint} module.
+        Accepts additional positional or keyword args as defined for the 
+        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})
+
+        Example::
+            ident = Word(alphas, alphanums)
+            num = Word(nums)
+            func = Forward()
+            term = ident | num | Group('(' + func + ')')
+            func <<= ident + Group(Optional(delimitedList(term)))
+            result = func.parseString("fna a,b,(fnb c,d,200),100")
+            result.pprint(width=40)
+        prints::
+            ['fna',
+             ['a',
+              'b',
+              ['(', 'fnb', ['c', 'd', '200'], ')'],
+              '100']]
+        """
+        pprint.pprint(self.asList(), *args, **kwargs)
+
+    # add support for pickle protocol
+    def __getstate__(self):
+        return ( self.__toklist,
+                 ( self.__tokdict.copy(),
+                   self.__parent is not None and self.__parent() or None,
+                   self.__accumNames,
+                   self.__name ) )
+
+    def __setstate__(self,state):
+        self.__toklist = state[0]
+        (self.__tokdict,
+         par,
+         inAccumNames,
+         self.__name) = state[1]
+        self.__accumNames = {}
+        self.__accumNames.update(inAccumNames)
+        if par is not None:
+            self.__parent = wkref(par)
+        else:
+            self.__parent = None
+
+    def __getnewargs__(self):
+        return self.__toklist, self.__name, self.__asList, self.__modal
+
+    def __dir__(self):
+        return (dir(type(self)) + list(self.keys()))
+
+MutableMapping.register(ParseResults)
+
+def col (loc,strg):
+    """Returns current column within a string, counting newlines as line separators.
+   The first column is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
+   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    s = strg
+    return 1 if 0<loc<len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)
+
+def lineno(loc,strg):
+    """Returns current line number within a string, counting newlines as line separators.
+   The first line is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
+   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    return strg.count("\n",0,loc) + 1
+
+def line( loc, strg ):
+    """Returns the line of text containing loc within a string, counting newlines as line separators.
+       """
+    lastCR = strg.rfind("\n", 0, loc)
+    nextCR = strg.find("\n", loc)
+    if nextCR >= 0:
+        return strg[lastCR+1:nextCR]
+    else:
+        return strg[lastCR+1:]
+
+def _defaultStartDebugAction( instring, loc, expr ):
+    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))
+
+def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
+    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
+
+def _defaultExceptionDebugAction( instring, loc, expr, exc ):
+    print ("Exception raised:" + _ustr(exc))
+
+def nullDebugAction(*args):
+    """'Do-nothing' debug action, to suppress debugging output during parsing."""
+    pass
+
+# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
+#~ 'decorator to trim function calls to match the arity of the target'
+#~ def _trim_arity(func, maxargs=3):
+    #~ if func in singleArgBuiltins:
+        #~ return lambda s,l,t: func(t)
+    #~ limit = 0
+    #~ foundArity = False
+    #~ def wrapper(*args):
+        #~ nonlocal limit,foundArity
+        #~ while 1:
+            #~ try:
+                #~ ret = func(*args[limit:])
+                #~ foundArity = True
+                #~ return ret
+            #~ except TypeError:
+                #~ if limit == maxargs or foundArity:
+                    #~ raise
+                #~ limit += 1
+                #~ continue
+    #~ return wrapper
+
+# this version is Python 2.x-3.x cross-compatible
+'decorator to trim function calls to match the arity of the target'
+def _trim_arity(func, maxargs=2):
+    if func in singleArgBuiltins:
+        return lambda s,l,t: func(t)
+    limit = [0]
+    foundArity = [False]
+    
+    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
+    if system_version[:2] >= (3,5):
+        def extract_stack(limit=0):
+            # special handling for Python 3.5.0 - extra deep call stack by 1
+            offset = -3 if system_version == (3,5,0) else -2
+            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
+            return [frame_summary[:2]]
+        def extract_tb(tb, limit=0):
+            frames = traceback.extract_tb(tb, limit=limit)
+            frame_summary = frames[-1]
+            return [frame_summary[:2]]
+    else:
+        extract_stack = traceback.extract_stack
+        extract_tb = traceback.extract_tb
+    
+    # synthesize what would be returned by traceback.extract_stack at the call to 
+    # user's parse action 'func', so that we don't incur call penalty at parse time
+    
+    LINE_DIFF = 6
+    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
+    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
+    this_line = extract_stack(limit=2)[-1]
+    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)
+
+    def wrapper(*args):
+        while 1:
+            try:
+                ret = func(*args[limit[0]:])
+                foundArity[0] = True
+                return ret
+            except TypeError:
+                # re-raise TypeErrors if they did not come from our arity testing
+                if foundArity[0]:
+                    raise
+                else:
+                    try:
+                        tb = sys.exc_info()[-1]
+                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
+                            raise
+                    finally:
+                        del tb
+
+                if limit[0] <= maxargs:
+                    limit[0] += 1
+                    continue
+                raise
+
+    # copy func name to wrapper for sensible debug output
+    func_name = "<parse action>"
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    wrapper.__name__ = func_name
+
+    return wrapper
+
+class ParserElement(object):
+    """Abstract base level parser element class."""
+    DEFAULT_WHITE_CHARS = " \n\t\r"
+    verbose_stacktrace = False
+
+    @staticmethod
+    def setDefaultWhitespaceChars( chars ):
+        r"""
+        Overrides the default whitespace chars
+
+        Example::
+            # default whitespace chars are space, <TAB> and newline
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+            
+            # change to just treat newline as significant
+            ParserElement.setDefaultWhitespaceChars(" \t")
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
+        """
+        ParserElement.DEFAULT_WHITE_CHARS = chars
+
+    @staticmethod
+    def inlineLiteralsUsing(cls):
+        """
+        Set class to be used for inclusion of string literals into a parser.
+        
+        Example::
+            # default literal class used is Literal
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+
+            # change to Suppress
+            ParserElement.inlineLiteralsUsing(Suppress)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
+        """
+        ParserElement._literalStringClass = cls
+
+    def __init__( self, savelist=False ):
+        self.parseAction = list()
+        self.failAction = None
+        #~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
+        self.strRepr = None
+        self.resultsName = None
+        self.saveAsList = savelist
+        self.skipWhitespace = True
+        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        self.copyDefaultWhiteChars = True
+        self.mayReturnEmpty = False # used when checking for left-recursion
+        self.keepTabs = False
+        self.ignoreExprs = list()
+        self.debug = False
+        self.streamlined = False
+        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
+        self.errmsg = ""
+        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
+        self.debugActions = ( None, None, None ) #custom debug actions
+        self.re = None
+        self.callPreparse = True # used to avoid redundant calls to preParse
+        self.callDuringTry = False
+
+    def copy( self ):
+        """
+        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
+        for the same parsing pattern, using copies of the original parse element.
+        
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
+            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+            
+            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
+        prints::
+            [5120, 100, 655360, 268435456]
+        Equivalent form of C{expr.copy()} is just C{expr()}::
+            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+        """
+        cpy = copy.copy( self )
+        cpy.parseAction = self.parseAction[:]
+        cpy.ignoreExprs = self.ignoreExprs[:]
+        if self.copyDefaultWhiteChars:
+            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        return cpy
+
+    def setName( self, name ):
+        """
+        Define name for this expression, makes debugging and exception messages clearer.
+        
+        Example::
+            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
+            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+        """
+        self.name = name
+        self.errmsg = "Expected " + self.name
+        if hasattr(self,"exception"):
+            self.exception.msg = self.errmsg
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        """
+        Define name for referencing matching tokens as a nested attribute
+        of the returned parse results.
+        NOTE: this returns a *copy* of the original C{ParserElement} object;
+        this is so that the client can define a basic element, such as an
+        integer, and reference it in multiple places with different names.
+
+        You can also set results names using the abbreviated syntax,
+        C{expr("name")} in place of C{expr.setResultsName("name")} - 
+        see L{I{__call__}<__call__>}.
+
+        Example::
+            date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+
+            # equivalent form:
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+        """
+        newself = self.copy()
+        if name.endswith("*"):
+            name = name[:-1]
+            listAllMatches=True
+        newself.resultsName = name
+        newself.modalResults = not listAllMatches
+        return newself
+
+    def setBreak(self,breakFlag = True):
+        """Method to invoke the Python pdb debugger when this element is
+           about to be parsed. Set C{breakFlag} to True to enable, False to
+           disable.
+        """
+        if breakFlag:
+            _parseMethod = self._parse
+            def breaker(instring, loc, doActions=True, callPreParse=True):
+                import pdb
+                pdb.set_trace()
+                return _parseMethod( instring, loc, doActions, callPreParse )
+            breaker._originalParseMethod = _parseMethod
+            self._parse = breaker
+        else:
+            if hasattr(self._parse,"_originalParseMethod"):
+                self._parse = self._parse._originalParseMethod
+        return self
+
+    def setParseAction( self, *fns, **kwargs ):
+        """
+        Define one or more actions to perform when successfully matching parse element definition.
+        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
+        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
+         - s   = the original string being parsed (see note below)
+         - loc = the location of the matching substring
+         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
+        If the functions in fns modify the tokens, they can return them as the return
+        value from fn, and the modified list of tokens will replace the original.
+        Otherwise, fn does not need to return any value.
+
+        Optional keyword arguments:
+         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing
+
+        Note: the default parsing behavior is to expand tabs in the input string
+        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
+        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+        consistent view of the parsed string, the parse location, and line and column
+        positions within the parsed string.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer + '/' + integer + '/' + integer
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+            # use parse action to convert to ints at parse time
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            date_str = integer + '/' + integer + '/' + integer
+
+            # note that integer fields are now ints, not strings
+            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
+        """
+        self.parseAction = list(map(_trim_arity, list(fns)))
+        self.callDuringTry = kwargs.get("callDuringTry", False)
+        return self
+
+    def addParseAction( self, *fns, **kwargs ):
+        """
+        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
+        
+        See examples in L{I{copy}<copy>}.
+        """
+        self.parseAction += list(map(_trim_arity, list(fns)))
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def addCondition(self, *fns, **kwargs):
+        """Add a boolean predicate function to expression's list of parse actions. See 
+        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
+        functions passed to C{addCondition} need to return boolean success/fail of the condition.
+
+        Optional keyword arguments:
+         - message = define a custom message to be used in the raised exception
+         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
+         
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            year_int = integer.copy()
+            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
+            date_str = year_int + '/' + integer + '/' + integer
+
+            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
+        """
+        msg = kwargs.get("message", "failed user-defined condition")
+        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
+        for fn in fns:
+            def pa(s,l,t):
+                if not bool(_trim_arity(fn)(s,l,t)):
+                    raise exc_type(s,l,msg)
+            self.parseAction.append(pa)
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def setFailAction( self, fn ):
+        """Define action to perform if parsing fails at this expression.
+           Fail acton fn is a callable function that takes the arguments
+           C{fn(s,loc,expr,err)} where:
+            - s = string being parsed
+            - loc = location where expression match was attempted and failed
+            - expr = the parse expression that failed
+            - err = the exception thrown
+           The function returns no value.  It may throw C{L{ParseFatalException}}
+           if it is desired to stop parsing immediately."""
+        self.failAction = fn
+        return self
+
+    def _skipIgnorables( self, instring, loc ):
+        exprsFound = True
+        while exprsFound:
+            exprsFound = False
+            for e in self.ignoreExprs:
+                try:
+                    while 1:
+                        loc,dummy = e._parse( instring, loc )
+                        exprsFound = True
+                except ParseException:
+                    pass
+        return loc
+
+    def preParse( self, instring, loc ):
+        if self.ignoreExprs:
+            loc = self._skipIgnorables( instring, loc )
+
+        if self.skipWhitespace:
+            wt = self.whiteChars
+            instrlen = len(instring)
+            while loc < instrlen and instring[loc] in wt:
+                loc += 1
+
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        return loc, []
+
+    def postParse( self, instring, loc, tokenlist ):
+        return tokenlist
+
+    #~ @profile
+    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
+        debugging = ( self.debug ) #and doActions )
+
+        if debugging or self.failAction:
+            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
+            if (self.debugActions[0] ):
+                self.debugActions[0]( instring, loc, self )
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            try:
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            except ParseBaseException as err:
+                #~ print ("Exception raised:", err)
+                if self.debugActions[2]:
+                    self.debugActions[2]( instring, tokensStart, self, err )
+                if self.failAction:
+                    self.failAction( instring, tokensStart, self, err )
+                raise
+        else:
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            if self.mayIndexError or preloc >= len(instring):
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            else:
+                loc,tokens = self.parseImpl( instring, preloc, doActions )
+
+        tokens = self.postParse( instring, loc, tokens )
+
+        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
+        if self.parseAction and (doActions or self.callDuringTry):
+            if debugging:
+                try:
+                    for fn in self.parseAction:
+                        tokens = fn( instring, tokensStart, retTokens )
+                        if tokens is not None:
+                            retTokens = ParseResults( tokens,
+                                                      self.resultsName,
+                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                      modal=self.modalResults )
+                except ParseBaseException as err:
+                    #~ print "Exception raised in user parse action:", err
+                    if (self.debugActions[2] ):
+                        self.debugActions[2]( instring, tokensStart, self, err )
+                    raise
+            else:
+                for fn in self.parseAction:
+                    tokens = fn( instring, tokensStart, retTokens )
+                    if tokens is not None:
+                        retTokens = ParseResults( tokens,
+                                                  self.resultsName,
+                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                  modal=self.modalResults )
+        if debugging:
+            #~ print ("Matched",self,"->",retTokens.asList())
+            if (self.debugActions[1] ):
+                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )
+
+        return loc, retTokens
+
+    def tryParse( self, instring, loc ):
+        try:
+            return self._parse( instring, loc, doActions=False )[0]
+        except ParseFatalException:
+            raise ParseException( instring, loc, self.errmsg, self)
+    
+    def canParseNext(self, instring, loc):
+        try:
+            self.tryParse(instring, loc)
+        except (ParseException, IndexError):
+            return False
+        else:
+            return True
+
+    class _UnboundedCache(object):
+        def __init__(self):
+            cache = {}
+            self.not_in_cache = not_in_cache = object()
+
+            def get(self, key):
+                return cache.get(key, not_in_cache)
+
+            def set(self, key, value):
+                cache[key] = value
+
+            def clear(self):
+                cache.clear()
+                
+            def cache_len(self):
+                return len(cache)
+
+            self.get = types.MethodType(get, self)
+            self.set = types.MethodType(set, self)
+            self.clear = types.MethodType(clear, self)
+            self.__len__ = types.MethodType(cache_len, self)
+
+    if _OrderedDict is not None:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = _OrderedDict()
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(cache) > size:
+                        try:
+                            cache.popitem(False)
+                        except KeyError:
+                            pass
+
+                def clear(self):
+                    cache.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    else:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = {}
+                key_fifo = collections.deque([], size)
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(key_fifo) > size:
+                        cache.pop(key_fifo.popleft(), None)
+                    key_fifo.append(key)
+
+                def clear(self):
+                    cache.clear()
+                    key_fifo.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    # argument cache for optimizing repeated calls when backtracking through recursive expressions
+    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
+    packrat_cache_lock = RLock()
+    packrat_cache_stats = [0, 0]
+
+    # this method gets repeatedly called during backtracking with the same arguments -
+    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
+    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
+        HIT, MISS = 0, 1
+        lookup = (self, instring, loc, callPreParse, doActions)
+        with ParserElement.packrat_cache_lock:
+            cache = ParserElement.packrat_cache
+            value = cache.get(lookup)
+            if value is cache.not_in_cache:
+                ParserElement.packrat_cache_stats[MISS] += 1
+                try:
+                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                except ParseBaseException as pe:
+                    # cache a copy of the exception, without the traceback
+                    cache.set(lookup, pe.__class__(*pe.args))
+                    raise
+                else:
+                    cache.set(lookup, (value[0], value[1].copy()))
+                    return value
+            else:
+                ParserElement.packrat_cache_stats[HIT] += 1
+                if isinstance(value, Exception):
+                    raise value
+                return (value[0], value[1].copy())
+
+    _parse = _parseNoCache
+
+    @staticmethod
+    def resetCache():
+        ParserElement.packrat_cache.clear()
+        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)
+
+    _packratEnabled = False
+    @staticmethod
+    def enablePackrat(cache_size_limit=128):
+        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
+           Repeated parse attempts at the same string location (which happens
+           often in many complex grammars) can immediately return a cached value,
+           instead of re-executing parsing/validating code.  Memoizing is done of
+           both valid results and parsing exceptions.
+           
+           Parameters:
+            - cache_size_limit - (default=C{128}) - if an integer value is provided
+              will limit the size of the packrat cache; if None is passed, then
+              the cache size will be unbounded; if 0 is passed, the cache will
+              be effectively disabled.
+            
+           This speedup may break existing programs that use parse actions that
+           have side-effects.  For this reason, packrat parsing is disabled when
+           you first import pyparsing.  To activate the packrat feature, your
+           program must call the class method C{ParserElement.enablePackrat()}.  If
+           your program uses C{psyco} to "compile as you go", you must call
+           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
+           Python will crash.  For best results, call C{enablePackrat()} immediately
+           after importing pyparsing.
+           
+           Example::
+               import pyparsing
+               pyparsing.ParserElement.enablePackrat()
+        """
+        if not ParserElement._packratEnabled:
+            ParserElement._packratEnabled = True
+            if cache_size_limit is None:
+                ParserElement.packrat_cache = ParserElement._UnboundedCache()
+            else:
+                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
+            ParserElement._parse = ParserElement._parseCache
+
+    def parseString( self, instring, parseAll=False ):
+        """
+        Execute the parse expression with the given string.
+        This is the main interface to the client code, once the complete
+        expression has been built.
+
+        If you want the grammar to require that the entire input string be
+        successfully parsed, then set C{parseAll} to True (equivalent to ending
+        the grammar with C{L{StringEnd()}}).
+
+        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
+        in order to report proper column numbers in parse actions.
+        If the input string contains tabs and
+        the grammar uses parse actions that use the C{loc} argument to index into the
+        string being parsed, you can ensure you have a consistent view of the input
+        string by:
+         - calling C{parseWithTabs} on your grammar before calling C{parseString}
+           (see L{I{parseWithTabs}<parseWithTabs>})
+         - define your parse action using the full C{(s,loc,toks)} signature, and
+           reference the input string using the parse action's C{s} argument
+         - explictly expand the tabs in your input string before calling
+           C{parseString}
+        
+        Example::
+            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
+            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
+        """
+        ParserElement.resetCache()
+        if not self.streamlined:
+            self.streamline()
+            #~ self.saveAsList = True
+        for e in self.ignoreExprs:
+            e.streamline()
+        if not self.keepTabs:
+            instring = instring.expandtabs()
+        try:
+            loc, tokens = self._parse( instring, 0 )
+            if parseAll:
+                loc = self.preParse( instring, loc )
+                se = Empty() + StringEnd()
+                se._parse( instring, loc )
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+        else:
+            return tokens
+
+    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
+        """
+        Scan the input string for expression matches.  Each match will return the
+        matching tokens, start location, and end location.  May be called with optional
+        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
+        C{overlap} is specified, then overlapping matches will be reported.
+
+        Note that the start and end locations are reported relative to the string
+        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
+        strings with embedded tabs.
+
+        Example::
+            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
+            print(source)
+            for tokens,start,end in Word(alphas).scanString(source):
+                print(' '*start + '^'*(end-start))
+                print(' '*start + tokens[0])
+        
+        prints::
+        
+            sldjf123lsdjjkf345sldkjf879lkjsfd987
+            ^^^^^
+            sldjf
+                    ^^^^^^^
+                    lsdjjkf
+                              ^^^^^^
+                              sldkjf
+                                       ^^^^^^
+                                       lkjsfd
+        """
+        if not self.streamlined:
+            self.streamline()
+        for e in self.ignoreExprs:
+            e.streamline()
+
+        if not self.keepTabs:
+            instring = _ustr(instring).expandtabs()
+        instrlen = len(instring)
+        loc = 0
+        preparseFn = self.preParse
+        parseFn = self._parse
+        ParserElement.resetCache()
+        matches = 0
+        try:
+            while loc <= instrlen and matches < maxMatches:
+                try:
+                    preloc = preparseFn( instring, loc )
+                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
+                except ParseException:
+                    loc = preloc+1
+                else:
+                    if nextLoc > loc:
+                        matches += 1
+                        yield tokens, preloc, nextLoc
+                        if overlap:
+                            nextloc = preparseFn( instring, loc )
+                            if nextloc > loc:
+                                loc = nextLoc
+                            else:
+                                loc += 1
+                        else:
+                            loc = nextLoc
+                    else:
+                        loc = preloc+1
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def transformString( self, instring ):
+        """
+        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
+        be returned from a parse action.  To use C{transformString}, define a grammar and
+        attach a parse action to it that modifies the returned token list.
+        Invoking C{transformString()} on a target string will then scan for matches,
+        and replace the matched text patterns according to the logic in the parse
+        action.  C{transformString()} returns the resulting transformed string.
+        
+        Example::
+            wd = Word(alphas)
+            wd.setParseAction(lambda toks: toks[0].title())
+            
+            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
+        Prints::
+            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
+        """
+        out = []
+        lastE = 0
+        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
+        # keep string locs straight between transformString and scanString
+        self.keepTabs = True
+        try:
+            for t,s,e in self.scanString( instring ):
+                out.append( instring[lastE:s] )
+                if t:
+                    if isinstance(t,ParseResults):
+                        out += t.asList()
+                    elif isinstance(t,list):
+                        out += t
+                    else:
+                        out.append(t)
+                lastE = e
+            out.append(instring[lastE:])
+            out = [o for o in out if o]
+            return "".join(map(_ustr,_flatten(out)))
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def searchString( self, instring, maxMatches=_MAX_INT ):
+        """
+        Another extension to C{L{scanString}}, simplifying the access to the tokens found
+        to match the given parse expression.  May be called with optional
+        C{maxMatches} argument, to clip searching after 'n' matches are found.
+        
+        Example::
+            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
+            cap_word = Word(alphas.upper(), alphas.lower())
+            
+            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))
+
+            # the sum() builtin can be used to merge results into a single ParseResults object
+            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
+        prints::
+            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
+            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
+        """
+        try:
+            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
+        """
+        Generator method to split a string using the given expression as a separator.
+        May be called with optional C{maxsplit} argument, to limit the number of splits;
+        and the optional C{includeSeparators} argument (default=C{False}), if the separating
+        matching text should be included in the split results.
+        
+        Example::        
+            punc = oneOf(list(".,;:/-!?"))
+            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
+        prints::
+            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
+        """
+        splits = 0
+        last = 0
+        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
+            yield instring[last:s]
+            if includeSeparators:
+                yield t[0]
+            last = e
+        yield instring[last:]
+
+    def __add__(self, other ):
+        """
+        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
+        converts them to L{Literal}s by default.
+        
+        Example::
+            greet = Word(alphas) + "," + Word(alphas) + "!"
+            hello = "Hello, World!"
+            print (hello, "->", greet.parseString(hello))
+        Prints::
+            Hello, World! -> ['Hello', ',', 'World', '!']
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return And( [ self, other ] )
+
+    def __radd__(self, other ):
+        """
+        Implementation of + operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other + self
+
+    def __sub__(self, other):
+        """
+        Implementation of - operator, returns C{L{And}} with error stop
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return self + And._ErrorStop() + other
+
+    def __rsub__(self, other ):
+        """
+        Implementation of - operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other - self
+
+    def __mul__(self,other):
+        """
+        Implementation of * operator, allows use of C{expr * 3} in place of
+        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
+        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
+        may also include C{None} as in:
+         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
+              to C{expr*n + L{ZeroOrMore}(expr)}
+              (read as "at least n instances of C{expr}")
+         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
+              (read as "0 to n instances of C{expr}")
+         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
+         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}
+
+        Note that C{expr*(None,n)} does not raise an exception if
+        more than n exprs exist in the input stream; that is,
+        C{expr*(None,n)} does not enforce a maximum number of expr
+        occurrences.  If this behavior is desired, then write
+        C{expr*(None,n) + ~expr}
+        """
+        if isinstance(other,int):
+            minElements, optElements = other,0
+        elif isinstance(other,tuple):
+            other = (other + (None, None))[:2]
+            if other[0] is None:
+                other = (0, other[1])
+            if isinstance(other[0],int) and other[1] is None:
+                if other[0] == 0:
+                    return ZeroOrMore(self)
+                if other[0] == 1:
+                    return OneOrMore(self)
+                else:
+                    return self*other[0] + ZeroOrMore(self)
+            elif isinstance(other[0],int) and isinstance(other[1],int):
+                minElements, optElements = other
+                optElements -= minElements
+            else:
+                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
+        else:
+            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
+
+        if minElements < 0:
+            raise ValueError("cannot multiply ParserElement by negative value")
+        if optElements < 0:
+            raise ValueError("second tuple value must be greater or equal to first tuple value")
+        if minElements == optElements == 0:
+            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")
+
+        if (optElements):
+            def makeOptionalList(n):
+                if n>1:
+                    return Optional(self + makeOptionalList(n-1))
+                else:
+                    return Optional(self)
+            if minElements:
+                if minElements == 1:
+                    ret = self + makeOptionalList(optElements)
+                else:
+                    ret = And([self]*minElements) + makeOptionalList(optElements)
+            else:
+                ret = makeOptionalList(optElements)
+        else:
+            if minElements == 1:
+                ret = self
+            else:
+                ret = And([self]*minElements)
+        return ret
+
+    def __rmul__(self, other):
+        return self.__mul__(other)
+
+    def __or__(self, other ):
+        """
+        Implementation of | operator - returns C{L{MatchFirst}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return MatchFirst( [ self, other ] )
+
+    def __ror__(self, other ):
+        """
+        Implementation of | operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other | self
+
+    def __xor__(self, other ):
+        """
+        Implementation of ^ operator - returns C{L{Or}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Or( [ self, other ] )
+
+    def __rxor__(self, other ):
+        """
+        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other ^ self
+
+    def __and__(self, other ):
+        """
+        Implementation of & operator - returns C{L{Each}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Each( [ self, other ] )
+
+    def __rand__(self, other ):
+        """
+        Implementation of & operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other & self
+
+    def __invert__( self ):
+        """
+        Implementation of ~ operator - returns C{L{NotAny}}
+        """
+        return NotAny( self )
+
+    def __call__(self, name=None):
+        """
+        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
+        
+        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
+        passed as C{True}.
+           
+        If C{name} is omitted, same as calling C{L{copy}}.
+
+        Example::
+            # these are equivalent
+            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
+            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
+        """
+        if name is not None:
+            return self.setResultsName(name)
+        else:
+            return self.copy()
+
+    def suppress( self ):
+        """
+        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
+        cluttering up returned output.
+        """
+        return Suppress( self )
+
+    def leaveWhitespace( self ):
+        """
+        Disables the skipping of whitespace before matching the characters in the
+        C{ParserElement}'s defined pattern.  This is normally only used internally by
+        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
+        """
+        self.skipWhitespace = False
+        return self
+
+    def setWhitespaceChars( self, chars ):
+        """
+        Overrides the default whitespace chars
+        """
+        self.skipWhitespace = True
+        self.whiteChars = chars
+        self.copyDefaultWhiteChars = False
+        return self
+
+    def parseWithTabs( self ):
+        """
+        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
+        Must be called before C{parseString} when the input grammar contains elements that
+        match C{<TAB>} characters.
+        """
+        self.keepTabs = True
+        return self
+
+    def ignore( self, other ):
+        """
+        Define expression to be ignored (e.g., comments) while doing pattern
+        matching; may be called repeatedly, to define multiple comment or other
+        ignorable patterns.
+        
+        Example::
+            patt = OneOrMore(Word(alphas))
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
+            
+            patt.ignore(cStyleComment)
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
+        """
+        if isinstance(other, basestring):
+            other = Suppress(other)
+
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                self.ignoreExprs.append(other)
+        else:
+            self.ignoreExprs.append( Suppress( other.copy() ) )
+        return self
+
+    def setDebugActions( self, startAction, successAction, exceptionAction ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        """
+        self.debugActions = (startAction or _defaultStartDebugAction,
+                             successAction or _defaultSuccessDebugAction,
+                             exceptionAction or _defaultExceptionDebugAction)
+        self.debug = True
+        return self
+
+    def setDebug( self, flag=True ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        Set C{flag} to True to enable, False to disable.
+
+        Example::
+            wd = Word(alphas).setName("alphaword")
+            integer = Word(nums).setName("numword")
+            term = wd | integer
+            
+            # turn on debugging for wd
+            wd.setDebug()
+
+            OneOrMore(term).parseString("abc 123 xyz 890")
+        
+        prints::
+            Match alphaword at loc 0(1,1)
+            Matched alphaword -> ['abc']
+            Match alphaword at loc 3(1,4)
+            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
+            Match alphaword at loc 7(1,8)
+            Matched alphaword -> ['xyz']
+            Match alphaword at loc 11(1,12)
+            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
+            Match alphaword at loc 15(1,16)
+            Exception raised:Expected alphaword (at char 15), (line:1, col:16)
+
+        The output shown is that produced by the default debug actions - custom debug actions can be
+        specified using L{setDebugActions}. Prior to attempting
+        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
+        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
+        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
+        which makes debugging and exception messages easier to understand - for instance, the default
+        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
+        """
+        if flag:
+            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
+        else:
+            self.debug = False
+        return self
+
+    def __str__( self ):
+        return self.name
+
+    def __repr__( self ):
+        return _ustr(self)
+
+    def streamline( self ):
+        self.streamlined = True
+        self.strRepr = None
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        pass
+
+    def validate( self, validateTrace=[] ):
+        """
+        Check defined expressions for valid structure, check for infinite recursive definitions.
+        """
+        self.checkRecursion( [] )
+
+    def parseFile( self, file_or_filename, parseAll=False ):
+        """
+        Execute the parse expression on the given file or filename.
+        If a filename is specified (instead of a file object),
+        the entire file is opened, read, and closed before parsing.
+        """
+        try:
+            file_contents = file_or_filename.read()
+        except AttributeError:
+            with open(file_or_filename, "r") as f:
+                file_contents = f.read()
+        try:
+            return self.parseString(file_contents, parseAll)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def __eq__(self,other):
+        if isinstance(other, ParserElement):
+            return self is other or vars(self) == vars(other)
+        elif isinstance(other, basestring):
+            return self.matches(other)
+        else:
+            return super(ParserElement,self)==other
+
+    def __ne__(self,other):
+        return not (self == other)
+
+    def __hash__(self):
+        return hash(id(self))
+
+    def __req__(self,other):
+        return self == other
+
+    def __rne__(self,other):
+        return not (self == other)
+
+    def matches(self, testString, parseAll=True):
+        """
+        Method for quick testing of a parser against a test string. Good for simple 
+        inline microtests of sub expressions while building up larger parser.
+           
+        Parameters:
+         - testString - to test against this expression for a match
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
+            
+        Example::
+            expr = Word(nums)
+            assert expr.matches("100")
+        """
+        try:
+            self.parseString(_ustr(testString), parseAll=parseAll)
+            return True
+        except ParseBaseException:
+            return False
+                
+    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
+        """
+        Execute the parse expression on a series of test strings, showing each
+        test, the parsed results or where the parse failed. Quick and easy way to
+        run a parse expression against a list of sample strings.
+           
+        Parameters:
+         - tests - a list of separate test strings, or a multiline string of test strings
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
+         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
+              string; pass None to disable comment filtering
+         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
+              if False, only dump nested list
+         - printResults - (default=C{True}) prints test output to stdout
+         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing
+
+        Returns: a (success, results) tuple, where success indicates that all tests succeeded
+        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
+        test's output
+        
+        Example::
+            number_expr = pyparsing_common.number.copy()
+
+            result = number_expr.runTests('''
+                # unsigned integer
+                100
+                # negative integer
+                -100
+                # float with scientific notation
+                6.02e23
+                # integer with scientific notation
+                1e-12
+                ''')
+            print("Success" if result[0] else "Failed!")
+
+            result = number_expr.runTests('''
+                # stray character
+                100Z
+                # missing leading digit before '.'
+                -.100
+                # too many '.'
+                3.14.159
+                ''', failureTests=True)
+            print("Success" if result[0] else "Failed!")
+        prints::
+            # unsigned integer
+            100
+            [100]
+
+            # negative integer
+            -100
+            [-100]
+
+            # float with scientific notation
+            6.02e23
+            [6.02e+23]
+
+            # integer with scientific notation
+            1e-12
+            [1e-12]
+
+            Success
+            
+            # stray character
+            100Z
+               ^
+            FAIL: Expected end of text (at char 3), (line:1, col:4)
+
+            # missing leading digit before '.'
+            -.100
+            ^
+            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)
+
+            # too many '.'
+            3.14.159
+                ^
+            FAIL: Expected end of text (at char 4), (line:1, col:5)
+
+            Success
+
+        Each test string must be on a single line. If you want to test a string that spans multiple
+        lines, create a test like this::
+
+            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
+        
+        (Note that this is a raw string literal, you must include the leading 'r'.)
+        """
+        if isinstance(tests, basestring):
+            tests = list(map(str.strip, tests.rstrip().splitlines()))
+        if isinstance(comment, basestring):
+            comment = Literal(comment)
+        allResults = []
+        comments = []
+        success = True
+        for t in tests:
+            if comment is not None and comment.matches(t, False) or comments and not t:
+                comments.append(t)
+                continue
+            if not t:
+                continue
+            out = ['\n'.join(comments), t]
+            comments = []
+            try:
+                t = t.replace(r'\n','\n')
+                result = self.parseString(t, parseAll=parseAll)
+                out.append(result.dump(full=fullDump))
+                success = success and not failureTests
+            except ParseBaseException as pe:
+                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                if '\n' in t:
+                    out.append(line(pe.loc, t))
+                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
+                else:
+                    out.append(' '*pe.loc + '^' + fatal)
+                out.append("FAIL: " + str(pe))
+                success = success and failureTests
+                result = pe
+            except Exception as exc:
+                out.append("FAIL-EXCEPTION: " + str(exc))
+                success = success and failureTests
+                result = exc
+
+            if printResults:
+                if fullDump:
+                    out.append('')
+                print('\n'.join(out))
+
+            allResults.append((t, result))
+        
+        return success, allResults
+
+        
+class Token(ParserElement):
+    """
+    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
+    """
+    def __init__( self ):
+        super(Token,self).__init__( savelist=False )
+
+
+class Empty(Token):
+    """
+    An empty token, will always match.
+    """
+    def __init__( self ):
+        super(Empty,self).__init__()
+        self.name = "Empty"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+
+class NoMatch(Token):
+    """
+    A token that will never match.
+    """
+    def __init__( self ):
+        super(NoMatch,self).__init__()
+        self.name = "NoMatch"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.errmsg = "Unmatchable token"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Literal(Token):
+    """
+    Token to exactly match a specified string.
+    
+    Example::
+        Literal('blah').parseString('blah')  # -> ['blah']
+        Literal('blah').parseString('blahfooblah')  # -> ['blah']
+        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
+    
+    For case-insensitive matching, use L{CaselessLiteral}.
+    
+    For keyword matching (force word break before and after the matched string),
+    use L{Keyword} or L{CaselessKeyword}.
+    """
+    def __init__( self, matchString ):
+        super(Literal,self).__init__()
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Literal; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+            self.__class__ = Empty
+        self.name = '"%s"' % _ustr(self.match)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+
+    # Performance tuning: this routine gets called a *lot*
+    # if this is a single character match string  and the first character matches,
+    # short-circuit as quickly as possible, and avoid calling startswith
+    #~ @profile
+    def parseImpl( self, instring, loc, doActions=True ):
+        if (instring[loc] == self.firstMatchChar and
+            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+_L = Literal
+ParserElement._literalStringClass = Literal
+
+class Keyword(Token):
+    """
+    Token to exactly match a specified string as a keyword, that is, it must be
+    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
+     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
+     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
+    Accepts two optional constructor arguments in addition to the keyword string:
+     - C{identChars} is a string of characters that would be valid identifier characters,
+          defaulting to all alphanumerics + "_" and "$"
+     - C{caseless} allows case-insensitive matching, default is C{False}.
+       
+    Example::
+        Keyword("start").parseString("start")  # -> ['start']
+        Keyword("start").parseString("starting")  # -> Exception
+
+    For case-insensitive matching, use L{CaselessKeyword}.
+    """
+    DEFAULT_KEYWORD_CHARS = alphanums+"_$"
+
+    def __init__( self, matchString, identChars=None, caseless=False ):
+        super(Keyword,self).__init__()
+        if identChars is None:
+            identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Keyword; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+        self.name = '"%s"' % self.match
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+        self.caseless = caseless
+        if caseless:
+            self.caselessmatch = matchString.upper()
+            identChars = identChars.upper()
+        self.identChars = set(identChars)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.caseless:
+            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
+                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        else:
+            if (instring[loc] == self.firstMatchChar and
+                (self.matchLen==1 or instring.startswith(self.match,loc)) and
+                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
+                (loc == 0 or instring[loc-1] not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+    def copy(self):
+        c = super(Keyword,self).copy()
+        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        return c
+
+    @staticmethod
+    def setDefaultKeywordChars( chars ):
+        """Overrides the default Keyword chars
+        """
+        Keyword.DEFAULT_KEYWORD_CHARS = chars
+
+class CaselessLiteral(Literal):
+    """
+    Token to match a specified string, ignoring case of letters.
+    Note: the matched results will always be in the case of the given
+    match string, NOT the case of the input text.
+
+    Example::
+        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessKeyword}.)
+    """
+    def __init__( self, matchString ):
+        super(CaselessLiteral,self).__init__( matchString.upper() )
+        # Preserve the defining literal.
+        self.returnString = matchString
+        self.name = "'%s'" % self.returnString
+        self.errmsg = "Expected " + self.name
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[ loc:loc+self.matchLen ].upper() == self.match:
+            return loc+self.matchLen, self.returnString
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CaselessKeyword(Keyword):
+    """
+    Caseless version of L{Keyword}.
+
+    Example::
+        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessLiteral}.)
+    """
+    def __init__( self, matchString, identChars=None ):
+        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CloseMatch(Token):
+    """
+    A variation on L{Literal} which matches "close" matches, that is, 
+    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
+     - C{match_string} - string to be matched
+     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
+    
+    The results from a successful parse will contain the matched text from the input string and the following named results:
+     - C{mismatches} - a list of the positions within the match_string where mismatches were found
+     - C{original} - the original match_string used to compare against the input string
+    
+    If C{mismatches} is an empty list, then the match was an exact match.
+    
+    Example::
+        patt = CloseMatch("ATCATCGAATGGA")
+        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
+        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)
+
+        # exact match
+        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})
+
+        # close match allowing up to 2 mismatches
+        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
+        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
+    """
+    def __init__(self, match_string, maxMismatches=1):
+        super(CloseMatch,self).__init__()
+        self.name = match_string
+        self.match_string = match_string
+        self.maxMismatches = maxMismatches
+        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
+        self.mayIndexError = False
+        self.mayReturnEmpty = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        start = loc
+        instrlen = len(instring)
+        maxloc = start + len(self.match_string)
+
+        if maxloc <= instrlen:
+            match_string = self.match_string
+            match_stringloc = 0
+            mismatches = []
+            maxMismatches = self.maxMismatches
+
+            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
+                src,mat = s_m
+                if src != mat:
+                    mismatches.append(match_stringloc)
+                    if len(mismatches) > maxMismatches:
+                        break
+            else:
+                loc = match_stringloc + 1
+                results = ParseResults([instring[start:loc]])
+                results['original'] = self.match_string
+                results['mismatches'] = mismatches
+                return loc, results
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Word(Token):
+    """
+    Token for matching words composed of allowed character sets.
+    Defined with string containing all allowed initial characters,
+    an optional string containing allowed body characters (if omitted,
+    defaults to the initial character set), and an optional minimum,
+    maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction. An optional
+    C{excludeChars} parameter can list characters that might be found in 
+    the input C{bodyChars} string; useful to define a word of all printables
+    except for one or two characters, for instance.
+    
+    L{srange} is useful for defining custom character set strings for defining 
+    C{Word} expressions, using range notation from regular expression character sets.
+    
+    A common mistake is to use C{Word} to match a specific literal string, as in 
+    C{Word("Address")}. Remember that C{Word} uses the string argument to define
+    I{sets} of matchable characters. This expression would match "Add", "AAA",
+    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
+    To match an exact literal string, use L{Literal} or L{Keyword}.
+
+    pyparsing includes helper strings for building Words:
+     - L{alphas}
+     - L{nums}
+     - L{alphanums}
+     - L{hexnums}
+     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
+     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
+     - L{printables} (any non-whitespace character)
+
+    Example::
+        # a word composed of digits
+        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
+        
+        # a word with a leading capital, and zero or more lowercase
+        capital_word = Word(alphas.upper(), alphas.lower())
+
+        # hostnames are alphanumeric, with leading alpha, and '-'
+        hostname = Word(alphas, alphanums+'-')
+        
+        # roman numeral (not a strict parser, accepts invalid mix of characters)
+        roman = Word("IVXLCDM")
+        
+        # any string of non-whitespace characters, except for ','
+        csv_value = Word(printables, excludeChars=",")
+    """
+    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
+        super(Word,self).__init__()
+        if excludeChars:
+            initChars = ''.join(c for c in initChars if c not in excludeChars)
+            if bodyChars:
+                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
+        self.initCharsOrig = initChars
+        self.initChars = set(initChars)
+        if bodyChars :
+            self.bodyCharsOrig = bodyChars
+            self.bodyChars = set(bodyChars)
+        else:
+            self.bodyCharsOrig = initChars
+            self.bodyChars = set(initChars)
+
+        self.maxSpecified = max > 0
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.asKeyword = asKeyword
+
+        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
+            if self.bodyCharsOrig == self.initCharsOrig:
+                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
+            elif len(self.initCharsOrig) == 1:
+                self.reString = "%s[%s]*" % \
+                                      (re.escape(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            else:
+                self.reString = "[%s][%s]*" % \
+                                      (_escapeRegexRangeChars(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            if self.asKeyword:
+                self.reString = r"\b"+self.reString+r"\b"
+            try:
+                self.re = re.compile( self.reString )
+            except Exception:
+                self.re = None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.re:
+            result = self.re.match(instring,loc)
+            if not result:
+                raise ParseException(instring, loc, self.errmsg, self)
+
+            loc = result.end()
+            return loc, result.group()
+
+        if not(instring[ loc ] in self.initChars):
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        instrlen = len(instring)
+        bodychars = self.bodyChars
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, instrlen )
+        while loc < maxloc and instring[loc] in bodychars:
+            loc += 1
+
+        throwException = False
+        if loc - start < self.minLen:
+            throwException = True
+        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
+            throwException = True
+        if self.asKeyword:
+            if (start>0 and instring[start-1] in bodychars) or (loc<instrlen and instring[loc] in bodychars):
+                throwException = True
+
+        if throwException:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(Word,self).__str__()
+        except Exception:
+            pass
+
+
+        if self.strRepr is None:
+
+            def charsAsStr(s):
+                if len(s)>4:
+                    return s[:4]+"..."
+                else:
+                    return s
+
+            if ( self.initCharsOrig != self.bodyCharsOrig ):
+                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
+            else:
+                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
+
+        return self.strRepr
+
+
+class Regex(Token):
+    r"""
+    Token for matching strings that match a given regular expression.
+    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
+    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
+    named parse results.
+
+    Example::
+        realnum = Regex(r"[+-]?\d+\.\d*")
+        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
+        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
+        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
+    """
+    compiledREtype = type(re.compile("[A-Z]"))
+    def __init__( self, pattern, flags=0):
+        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
+        super(Regex,self).__init__()
+
+        if isinstance(pattern, basestring):
+            if not pattern:
+                warnings.warn("null string passed to Regex; use Empty() instead",
+                        SyntaxWarning, stacklevel=2)
+
+            self.pattern = pattern
+            self.flags = flags
+
+            try:
+                self.re = re.compile(self.pattern, self.flags)
+                self.reString = self.pattern
+            except sre_constants.error:
+                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
+                    SyntaxWarning, stacklevel=2)
+                raise
+
+        elif isinstance(pattern, Regex.compiledREtype):
+            self.re = pattern
+            self.pattern = \
+            self.reString = str(pattern)
+            self.flags = flags
+            
+        else:
+            raise ValueError("Regex may only be constructed with a string or a compiled RE object")
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = self.re.match(instring,loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        d = result.groupdict()
+        ret = ParseResults(result.group())
+        if d:
+            for k in d:
+                ret[k] = d[k]
+        return loc,ret
+
+    def __str__( self ):
+        try:
+            return super(Regex,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "Re:(%s)" % repr(self.pattern)
+
+        return self.strRepr
+
+
+class QuotedString(Token):
+    r"""
+    Token for matching strings that are delimited by quoting characters.
+    
+    Defined with the following parameters:
+        - quoteChar - string of one or more characters defining the quote delimiting string
+        - escChar - character to escape quotes, typically backslash (default=C{None})
+        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
+        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
+        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
+        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
+        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})
+
+    Example::
+        qs = QuotedString('"')
+        print(qs.searchString('lsjdf "This is the quote" sldjf'))
+        complex_qs = QuotedString('{{', endQuoteChar='}}')
+        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
+        sql_qs = QuotedString('"', escQuote='""')
+        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
+    prints::
+        [['This is the quote']]
+        [['This is the "quote"']]
+        [['This is the quote with "embedded" quotes']]
+    """
+    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
+        super(QuotedString,self).__init__()
+
+        # remove white space from quote chars - wont work anyway
+        quoteChar = quoteChar.strip()
+        if not quoteChar:
+            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+            raise SyntaxError()
+
+        if endQuoteChar is None:
+            endQuoteChar = quoteChar
+        else:
+            endQuoteChar = endQuoteChar.strip()
+            if not endQuoteChar:
+                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+                raise SyntaxError()
+
+        self.quoteChar = quoteChar
+        self.quoteCharLen = len(quoteChar)
+        self.firstQuoteChar = quoteChar[0]
+        self.endQuoteChar = endQuoteChar
+        self.endQuoteCharLen = len(endQuoteChar)
+        self.escChar = escChar
+        self.escQuote = escQuote
+        self.unquoteResults = unquoteResults
+        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+
+        if multiline:
+            self.flags = re.MULTILINE | re.DOTALL
+            self.pattern = r'%s(?:[^%s%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        else:
+            self.flags = 0
+            self.pattern = r'%s(?:[^%s\n\r%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        if len(self.endQuoteChar) > 1:
+            self.pattern += (
+                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
+                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
+                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
+                )
+        if escQuote:
+            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
+        if escChar:
+            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
+            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
+        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
+
+        try:
+            self.re = re.compile(self.pattern, self.flags)
+            self.reString = self.pattern
+        except sre_constants.error:
+            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
+                SyntaxWarning, stacklevel=2)
+            raise
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.group()
+
+        if self.unquoteResults:
+
+            # strip off quotes
+            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]
+
+            if isinstance(ret,basestring):
+                # replace escaped whitespace
+                if '\\' in ret and self.convertWhitespaceEscapes:
+                    ws_map = {
+                        r'\t' : '\t',
+                        r'\n' : '\n',
+                        r'\f' : '\f',
+                        r'\r' : '\r',
+                    }
+                    for wslit,wschar in ws_map.items():
+                        ret = ret.replace(wslit, wschar)
+
+                # replace escaped characters
+                if self.escChar:
+                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+
+                # replace escaped quotes
+                if self.escQuote:
+                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+
+        return loc, ret
+
+    def __str__( self ):
+        try:
+            return super(QuotedString,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
+
+        return self.strRepr
+
+
+class CharsNotIn(Token):
+    """
+    Token for matching words composed of characters I{not} in a given set (will
+    include whitespace in matched characters if not listed in the provided exclusion set - see example).
+    Defined with string containing all disallowed characters, and an optional
+    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction.
+
+    Example::
+        # define a comma-separated-value as anything that is not a ','
+        csv_value = CharsNotIn(',')
+        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
+    prints::
+        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
+    """
+    def __init__( self, notChars, min=1, max=0, exact=0 ):
+        super(CharsNotIn,self).__init__()
+        self.skipWhitespace = False
+        self.notChars = notChars
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = ( self.minLen == 0 )
+        self.mayIndexError = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[loc] in self.notChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        notchars = self.notChars
+        maxlen = min( start+self.maxLen, len(instring) )
+        while loc < maxlen and \
+              (instring[loc] not in notchars):
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(CharsNotIn, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            if len(self.notChars) > 4:
+                self.strRepr = "!W:(%s...)" % self.notChars[:4]
+            else:
+                self.strRepr = "!W:(%s)" % self.notChars
+
+        return self.strRepr
+
+class White(Token):
+    """
+    Special matching class for matching whitespace.  Normally, whitespace is ignored
+    by pyparsing grammars.  This class is included when some whitespace structures
+    are significant.  Define with a string containing the whitespace characters to be
+    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
+    as defined for the C{L{Word}} class.
+    """
+    whiteStrs = {
+        " " : "<SPC>",
+        "\t": "<TAB>",
+        "\n": "<LF>",
+        "\r": "<CR>",
+        "\f": "<FF>",
+        }
+    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
+        super(White,self).__init__()
+        self.matchWhite = ws
+        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
+        #~ self.leaveWhitespace()
+        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
+        self.mayReturnEmpty = True
+        self.errmsg = "Expected " + self.name
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if not(instring[ loc ] in self.matchWhite):
+            raise ParseException(instring, loc, self.errmsg, self)
+        start = loc
+        loc += 1
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, len(instring) )
+        while loc < maxloc and instring[loc] in self.matchWhite:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+
+class _PositionToken(Token):
+    def __init__( self ):
+        super(_PositionToken,self).__init__()
+        self.name=self.__class__.__name__
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+class GoToColumn(_PositionToken):
+    """
+    Token to advance to a specific column of input text; useful for tabular report scraping.
+    """
+    def __init__( self, colno ):
+        super(GoToColumn,self).__init__()
+        self.col = colno
+
+    def preParse( self, instring, loc ):
+        if col(loc,instring) != self.col:
+            instrlen = len(instring)
+            if self.ignoreExprs:
+                loc = self._skipIgnorables( instring, loc )
+            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
+                loc += 1
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        thiscol = col( loc, instring )
+        if thiscol > self.col:
+            raise ParseException( instring, loc, "Text not in expected column", self )
+        newloc = loc + self.col - thiscol
+        ret = instring[ loc: newloc ]
+        return newloc, ret
+
+
+class LineStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of a line within the parse string
+    
+    Example::
+    
+        test = '''\
+        AAA this line
+        AAA and this line
+          AAA but not this one
+        B AAA and definitely not this one
+        '''
+
+        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
+            print(t)
+    
+    Prints::
+        ['AAA', ' this line']
+        ['AAA', ' and this line']    
+
+    """
+    def __init__( self ):
+        super(LineStart,self).__init__()
+        self.errmsg = "Expected start of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if col(loc, instring) == 1:
+            return loc, []
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class LineEnd(_PositionToken):
+    """
+    Matches if current position is at the end of a line within the parse string
+    """
+    def __init__( self ):
+        super(LineEnd,self).__init__()
+        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
+        self.errmsg = "Expected end of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc<len(instring):
+            if instring[loc] == "\n":
+                return loc+1, "\n"
+            else:
+                raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc+1, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class StringStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of the parse string
+    """
+    def __init__( self ):
+        super(StringStart,self).__init__()
+        self.errmsg = "Expected start of text"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc != 0:
+            # see if entire string up to here is just whitespace and ignoreables
+            if loc != self.preParse( instring, 0 ):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class StringEnd(_PositionToken):
+    """
+    Matches if current position is at the end of the parse string
+    """
+    def __init__( self ):
+        super(StringEnd,self).__init__()
+        self.errmsg = "Expected end of text"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc < len(instring):
+            raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc+1, []
+        elif loc > len(instring):
+            return loc, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class WordStart(_PositionToken):
+    """
+    Matches if the current position is at the beginning of a Word, and
+    is not preceded by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
+    the string being parsed, or at the beginning of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordStart,self).__init__()
+        self.wordChars = set(wordChars)
+        self.errmsg = "Not at the start of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        if loc != 0:
+            if (instring[loc-1] in self.wordChars or
+                instring[loc] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class WordEnd(_PositionToken):
+    """
+    Matches if the current position is at the end of a Word, and
+    is not followed by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
+    the string being parsed, or at the end of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordEnd,self).__init__()
+        self.wordChars = set(wordChars)
+        self.skipWhitespace = False
+        self.errmsg = "Not at the end of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        instrlen = len(instring)
+        if instrlen>0 and loc<instrlen:
+            if (instring[loc] in self.wordChars or
+                instring[loc-1] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+
+class ParseExpression(ParserElement):
+    """
+    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(ParseExpression,self).__init__(savelist)
+        if isinstance( exprs, _generatorType ):
+            exprs = list(exprs)
+
+        if isinstance( exprs, basestring ):
+            self.exprs = [ ParserElement._literalStringClass( exprs ) ]
+        elif isinstance( exprs, Iterable ):
+            exprs = list(exprs)
+            # if sequence of strings provided, wrap with Literal
+            if all(isinstance(expr, basestring) for expr in exprs):
+                exprs = map(ParserElement._literalStringClass, exprs)
+            self.exprs = list(exprs)
+        else:
+            try:
+                self.exprs = list( exprs )
+            except TypeError:
+                self.exprs = [ exprs ]
+        self.callPreparse = False
+
+    def __getitem__( self, i ):
+        return self.exprs[i]
+
+    def append( self, other ):
+        self.exprs.append( other )
+        self.strRepr = None
+        return self
+
+    def leaveWhitespace( self ):
+        """Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
+           all contained expressions."""
+        self.skipWhitespace = False
+        self.exprs = [ e.copy() for e in self.exprs ]
+        for e in self.exprs:
+            e.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseExpression, self).ignore( other )
+                for e in self.exprs:
+                    e.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseExpression, self).ignore( other )
+            for e in self.exprs:
+                e.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def __str__( self ):
+        try:
+            return super(ParseExpression,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.exprs) )
+        return self.strRepr
+
+    def streamline( self ):
+        super(ParseExpression,self).streamline()
+
+        for e in self.exprs:
+            e.streamline()
+
+        # collapse nested And's of the form And( And( And( a,b), c), d) to And( a,b,c,d )
+        # but only if there are no parse actions or resultsNames on the nested And's
+        # (likewise for Or's and MatchFirst's)
+        if ( len(self.exprs) == 2 ):
+            other = self.exprs[0]
+            if ( isinstance( other, self.__class__ ) and
+                  not(other.parseAction) and
+                  other.resultsName is None and
+                  not other.debug ):
+                self.exprs = other.exprs[:] + [ self.exprs[1] ]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+            other = self.exprs[-1]
+            if ( isinstance( other, self.__class__ ) and
+                  not(other.parseAction) and
+                  other.resultsName is None and
+                  not other.debug ):
+                self.exprs = self.exprs[:-1] + other.exprs[:]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+        self.errmsg = "Expected " + _ustr(self)
+        
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        ret = super(ParseExpression,self).setResultsName(name,listAllMatches)
+        return ret
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        for e in self.exprs:
+            e.validate(tmp)
+        self.checkRecursion( [] )
+        
+    def copy(self):
+        ret = super(ParseExpression,self).copy()
+        ret.exprs = [e.copy() for e in self.exprs]
+        return ret
+
+class And(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found in the given order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'+'} operator.
+    May also be constructed using the C{'-'} operator, which will suppress backtracking.
+
+    Example::
+        integer = Word(nums)
+        name_expr = OneOrMore(Word(alphas))
+
+        expr = And([integer("id"),name_expr("name"),integer("age")])
+        # more easily written as:
+        expr = integer("id") + name_expr("name") + integer("age")
+    """
+
+    class _ErrorStop(Empty):
+        def __init__(self, *args, **kwargs):
+            super(And._ErrorStop,self).__init__(*args, **kwargs)
+            self.name = '-'
+            self.leaveWhitespace()
+
+    def __init__( self, exprs, savelist = True ):
+        super(And,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.setWhitespaceChars( self.exprs[0].whiteChars )
+        self.skipWhitespace = self.exprs[0].skipWhitespace
+        self.callPreparse = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        # pass False as last arg to _parse for first element, since we already
+        # pre-parsed the string as part of our And pre-parsing
+        loc, resultlist = self.exprs[0]._parse( instring, loc, doActions, callPreParse=False )
+        errorStop = False
+        for e in self.exprs[1:]:
+            if isinstance(e, And._ErrorStop):
+                errorStop = True
+                continue
+            if errorStop:
+                try:
+                    loc, exprtokens = e._parse( instring, loc, doActions )
+                except ParseSyntaxException:
+                    raise
+                except ParseBaseException as pe:
+                    pe.__traceback__ = None
+                    raise ParseSyntaxException._from_exception(pe)
+                except IndexError:
+                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
+            else:
+                loc, exprtokens = e._parse( instring, loc, doActions )
+            if exprtokens or exprtokens.haskeys():
+                resultlist += exprtokens
+        return loc, resultlist
+
+    def __iadd__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #And( [ self, other ] )
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+            if not e.mayReturnEmpty:
+                break
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+
+class Or(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the expression that matches the longest string will be used.
+    May be constructed using the C{'^'} operator.
+
+    Example::
+        # construct Or using '^' operator
+        
+        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789"))
+    prints::
+        [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(Or,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        matches = []
+        for e in self.exprs:
+            try:
+                loc2 = e.tryParse( instring, loc )
+            except ParseException as err:
+                err.__traceback__ = None
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+            else:
+                # save match among all matches, to retry longest to shortest
+                matches.append((loc2, e))
+
+        if matches:
+            matches.sort(key=lambda x: -x[0])
+            for _,e in matches:
+                try:
+                    return e._parse( instring, loc, doActions )
+                except ParseException as err:
+                    err.__traceback__ = None
+                    if err.loc > maxExcLoc:
+                        maxException = err
+                        maxExcLoc = err.loc
+
+        if maxException is not None:
+            maxException.msg = self.errmsg
+            raise maxException
+        else:
+            raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+
+    def __ixor__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #Or( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class MatchFirst(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the first one listed is the one that will match.
+    May be constructed using the C{'|'} operator.
+
+    Example::
+        # construct MatchFirst using '|' operator
+        
+        # watch the order of expressions to match
+        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]
+
+        # put more selective expression first
+        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
+        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(MatchFirst,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        for e in self.exprs:
+            try:
+                ret = e._parse( instring, loc, doActions )
+                return ret
+            except ParseException as err:
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+
+        # only got here if no expression matched, raise exception for match that made it the furthest
+        else:
+            if maxException is not None:
+                maxException.msg = self.errmsg
+                raise maxException
+            else:
+                raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+    def __ior__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #MatchFirst( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class Each(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found, but in any order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'&'} operator.
+
+    Example::
+        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
+        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
+        integer = Word(nums)
+        shape_attr = "shape:" + shape_type("shape")
+        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
+        color_attr = "color:" + color("color")
+        size_attr = "size:" + integer("size")
+
+        # use Each (using operator '&') to accept attributes in any order 
+        # (shape and posn are required, color and size are optional)
+        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)
+
+        shape_spec.runTests('''
+            shape: SQUARE color: BLACK posn: 100, 120
+            shape: CIRCLE size: 50 color: BLUE posn: 50,80
+            color:GREEN size:20 shape:TRIANGLE posn:20,40
+            '''
+            )
+    prints::
+        shape: SQUARE color: BLACK posn: 100, 120
+        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
+        - color: BLACK
+        - posn: ['100', ',', '120']
+          - x: 100
+          - y: 120
+        - shape: SQUARE
+
+
+        shape: CIRCLE size: 50 color: BLUE posn: 50,80
+        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
+        - color: BLUE
+        - posn: ['50', ',', '80']
+          - x: 50
+          - y: 80
+        - shape: CIRCLE
+        - size: 50
+
+
+        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
+        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
+        - color: GREEN
+        - posn: ['20', ',', '40']
+          - x: 20
+          - y: 40
+        - shape: TRIANGLE
+        - size: 20
+    """
+    def __init__( self, exprs, savelist = True ):
+        super(Each,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.skipWhitespace = True
+        self.initExprGroups = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.initExprGroups:
+            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
+            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
+            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
+            self.optionals = opt1 + opt2
+            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
+            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
+            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
+            self.required += self.multirequired
+            self.initExprGroups = False
+        tmpLoc = loc
+        tmpReqd = self.required[:]
+        tmpOpt  = self.optionals[:]
+        matchOrder = []
+
+        keepMatching = True
+        while keepMatching:
+            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
+            failed = []
+            for e in tmpExprs:
+                try:
+                    tmpLoc = e.tryParse( instring, tmpLoc )
+                except ParseException:
+                    failed.append(e)
+                else:
+                    matchOrder.append(self.opt1map.get(id(e),e))
+                    if e in tmpReqd:
+                        tmpReqd.remove(e)
+                    elif e in tmpOpt:
+                        tmpOpt.remove(e)
+            if len(failed) == len(tmpExprs):
+                keepMatching = False
+
+        if tmpReqd:
+            missing = ", ".join(_ustr(e) for e in tmpReqd)
+            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )
+
+        # add any unmatched Optionals, in case they have default values defined
+        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]
+
+        resultlist = []
+        for e in matchOrder:
+            loc,results = e._parse(instring,loc,doActions)
+            resultlist.append(results)
+
+        finalResults = sum(resultlist, ParseResults([]))
+        return loc, finalResults
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class ParseElementEnhance(ParserElement):
+    """
+    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(ParseElementEnhance,self).__init__(savelist)
+        if isinstance( expr, basestring ):
+            if issubclass(ParserElement._literalStringClass, Token):
+                expr = ParserElement._literalStringClass(expr)
+            else:
+                expr = ParserElement._literalStringClass(Literal(expr))
+        self.expr = expr
+        self.strRepr = None
+        if expr is not None:
+            self.mayIndexError = expr.mayIndexError
+            self.mayReturnEmpty = expr.mayReturnEmpty
+            self.setWhitespaceChars( expr.whiteChars )
+            self.skipWhitespace = expr.skipWhitespace
+            self.saveAsList = expr.saveAsList
+            self.callPreparse = expr.callPreparse
+            self.ignoreExprs.extend(expr.ignoreExprs)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr is not None:
+            return self.expr._parse( instring, loc, doActions, callPreParse=False )
+        else:
+            raise ParseException("",loc,self.errmsg,self)
+
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        self.expr = self.expr.copy()
+        if self.expr is not None:
+            self.expr.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseElementEnhance, self).ignore( other )
+                if self.expr is not None:
+                    self.expr.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseElementEnhance, self).ignore( other )
+            if self.expr is not None:
+                self.expr.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def streamline( self ):
+        super(ParseElementEnhance,self).streamline()
+        if self.expr is not None:
+            self.expr.streamline()
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        if self in parseElementList:
+            raise RecursiveGrammarException( parseElementList+[self] )
+        subRecCheckList = parseElementList[:] + [ self ]
+        if self.expr is not None:
+            self.expr.checkRecursion( subRecCheckList )
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        if self.expr is not None:
+            self.expr.validate(tmp)
+        self.checkRecursion( [] )
+
+    def __str__( self ):
+        try:
+            return super(ParseElementEnhance,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None and self.expr is not None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
+        return self.strRepr
+
+
+class FollowedBy(ParseElementEnhance):
+    """
+    Lookahead matching of the given parse expression.  C{FollowedBy}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression matches at the current
+    position.  C{FollowedBy} always returns a null token list.
+
+    Example::
+        # use FollowedBy to match a label only if it is followed by a ':'
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
+    prints::
+        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
+    """
+    def __init__( self, expr ):
+        super(FollowedBy,self).__init__(expr)
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self.expr.tryParse( instring, loc )
+        return loc, []
+
+
+class NotAny(ParseElementEnhance):
+    """
+    Lookahead to disallow matching with the given parse expression.  C{NotAny}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression does I{not} match at the current
+    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
+    always returns a null token list.  May be constructed using the '~' operator.
+
+    Example::
+        
+    """
+    def __init__( self, expr ):
+        super(NotAny,self).__init__(expr)
+        #~ self.leaveWhitespace()
+        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
+        self.mayReturnEmpty = True
+        self.errmsg = "Found unwanted token, "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr.canParseNext(instring, loc):
+            raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "~{" + _ustr(self.expr) + "}"
+
+        return self.strRepr
+
+class _MultipleMatch(ParseElementEnhance):
+    def __init__( self, expr, stopOn=None):
+        super(_MultipleMatch, self).__init__(expr)
+        self.saveAsList = True
+        ender = stopOn
+        if isinstance(ender, basestring):
+            ender = ParserElement._literalStringClass(ender)
+        self.not_ender = ~ender if ender is not None else None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self_expr_parse = self.expr._parse
+        self_skip_ignorables = self._skipIgnorables
+        check_ender = self.not_ender is not None
+        if check_ender:
+            try_not_ender = self.not_ender.tryParse
+        
+        # must be at least one (but first see if we are the stopOn sentinel;
+        # if so, fail)
+        if check_ender:
+            try_not_ender(instring, loc)
+        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
+        try:
+            hasIgnoreExprs = (not not self.ignoreExprs)
+            while 1:
+                if check_ender:
+                    try_not_ender(instring, loc)
+                if hasIgnoreExprs:
+                    preloc = self_skip_ignorables( instring, loc )
+                else:
+                    preloc = loc
+                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
+                if tmptokens or tmptokens.haskeys():
+                    tokens += tmptokens
+        except (ParseException,IndexError):
+            pass
+
+        return loc, tokens
+        
+class OneOrMore(_MultipleMatch):
+    """
+    Repetition of one or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match one or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: BLACK"
+        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+
+        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
+        
+        # could also be written as
+        (attr_expr * (1,)).parseString(text).pprint()
+    """
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + _ustr(self.expr) + "}..."
+
+        return self.strRepr
+
+class ZeroOrMore(_MultipleMatch):
+    """
+    Optional repetition of zero or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match zero or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example: similar to L{OneOrMore}
+    """
+    def __init__( self, expr, stopOn=None):
+        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
+        self.mayReturnEmpty = True
+        
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
+        except (ParseException,IndexError):
+            return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]..."
+
+        return self.strRepr
+
+class _NullToken(object):
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+    def __str__(self):
+        return ""
+
+_optionalNotMatched = _NullToken()
+class Optional(ParseElementEnhance):
+    """
+    Optional matching of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - default (optional) - value to be returned if the optional expression is not found.
+
+    Example::
+        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
+        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
+        zip.runTests('''
+            # traditional ZIP code
+            12345
+            
+            # ZIP+4 form
+            12101-0001
+            
+            # invalid ZIP
+            98765-
+            ''')
+    prints::
+        # traditional ZIP code
+        12345
+        ['12345']
+
+        # ZIP+4 form
+        12101-0001
+        ['12101-0001']
+
+        # invalid ZIP
+        98765-
+             ^
+        FAIL: Expected end of text (at char 5), (line:1, col:6)
+    """
+    def __init__( self, expr, default=_optionalNotMatched ):
+        super(Optional,self).__init__( expr, savelist=False )
+        self.saveAsList = self.expr.saveAsList
+        self.defaultValue = default
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
+        except (ParseException,IndexError):
+            if self.defaultValue is not _optionalNotMatched:
+                if self.expr.resultsName:
+                    tokens = ParseResults([ self.defaultValue ])
+                    tokens[self.expr.resultsName] = self.defaultValue
+                else:
+                    tokens = [ self.defaultValue ]
+            else:
+                tokens = []
+        return loc, tokens
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]"
+
+        return self.strRepr
+
+class SkipTo(ParseElementEnhance):
+    """
+    Token for skipping over all undefined text until the matched expression is found.
+
+    Parameters:
+     - expr - target expression marking the end of the data to be skipped
+     - include - (default=C{False}) if True, the target expression is also parsed 
+          (the skipped text and target expression are returned as a 2-element list).
+     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
+          comments) that might contain false matches to the target expression
+     - failOn - (default=C{None}) define expressions that are not allowed to be 
+          included in the skipped test; if found before the target expression is found, 
+          the SkipTo is not a match
+
+    Example::
+        report = '''
+            Outstanding Issues Report - 1 Jan 2000
+
+               # | Severity | Description                               |  Days Open
+            -----+----------+-------------------------------------------+-----------
+             101 | Critical | Intermittent system crash                 |          6
+              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
+              79 | Minor    | System slow when running too many reports |         47
+            '''
+        integer = Word(nums)
+        SEP = Suppress('|')
+        # use SkipTo to simply match everything up until the next SEP
+        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
+        # - parse action will call token.strip() for each matched token, i.e., the description body
+        string_data = SkipTo(SEP, ignore=quotedString)
+        string_data.setParseAction(tokenMap(str.strip))
+        ticket_expr = (integer("issue_num") + SEP 
+                      + string_data("sev") + SEP 
+                      + string_data("desc") + SEP 
+                      + integer("days_open"))
+        
+        for tkt in ticket_expr.searchString(report):
+            print tkt.dump()
+    prints::
+        ['101', 'Critical', 'Intermittent system crash', '6']
+        - days_open: 6
+        - desc: Intermittent system crash
+        - issue_num: 101
+        - sev: Critical
+        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
+        - days_open: 14
+        - desc: Spelling error on Login ('log|n')
+        - issue_num: 94
+        - sev: Cosmetic
+        ['79', 'Minor', 'System slow when running too many reports', '47']
+        - days_open: 47
+        - desc: System slow when running too many reports
+        - issue_num: 79
+        - sev: Minor
+    """
+    def __init__( self, other, include=False, ignore=None, failOn=None ):
+        super( SkipTo, self ).__init__( other )
+        self.ignoreExpr = ignore
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.includeMatch = include
+        self.asList = False
+        if isinstance(failOn, basestring):
+            self.failOn = ParserElement._literalStringClass(failOn)
+        else:
+            self.failOn = failOn
+        self.errmsg = "No match found for "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        startloc = loc
+        instrlen = len(instring)
+        expr = self.expr
+        expr_parse = self.expr._parse
+        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
+        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
+        
+        tmploc = loc
+        while tmploc <= instrlen:
+            if self_failOn_canParseNext is not None:
+                # break if failOn expression matches
+                if self_failOn_canParseNext(instring, tmploc):
+                    break
+                    
+            if self_ignoreExpr_tryParse is not None:
+                # advance past ignore expressions
+                while 1:
+                    try:
+                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                    except ParseBaseException:
+                        break
+            
+            try:
+                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+            except (ParseException, IndexError):
+                # no match, advance loc in string
+                tmploc += 1
+            else:
+                # matched skipto expr, done
+                break
+
+        else:
+            # ran off the end of the input string without matching skipto expr, fail
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        # build up return values
+        loc = tmploc
+        skiptext = instring[startloc:loc]
+        skipresult = ParseResults(skiptext)
+        
+        if self.includeMatch:
+            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
+            skipresult += mat
+
+        return loc, skipresult
+
+class Forward(ParseElementEnhance):
+    """
+    Forward declaration of an expression to be defined later -
+    used for recursive grammars, such as algebraic infix notation.
+    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.
+
+    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
+    Specifically, '|' has a lower precedence than '<<', so that::
+        fwdExpr << a | b | c
+    will actually be evaluated as::
+        (fwdExpr << a) | b | c
+    thereby leaving b and c out as parseable alternatives.  It is recommended that you
+    explicitly group the values inserted into the C{Forward}::
+        fwdExpr << (a | b | c)
+    Converting to use the '<<=' operator instead will avoid this problem.
+
+    See L{ParseResults.pprint} for an example of a recursive parser created using
+    C{Forward}.
+    """
+    def __init__( self, other=None ):
+        super(Forward,self).__init__( other, savelist=False )
+
+    def __lshift__( self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass(other)
+        self.expr = other
+        self.strRepr = None
+        self.mayIndexError = self.expr.mayIndexError
+        self.mayReturnEmpty = self.expr.mayReturnEmpty
+        self.setWhitespaceChars( self.expr.whiteChars )
+        self.skipWhitespace = self.expr.skipWhitespace
+        self.saveAsList = self.expr.saveAsList
+        self.ignoreExprs.extend(self.expr.ignoreExprs)
+        return self
+        
+    def __ilshift__(self, other):
+        return self << other
+    
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        return self
+
+    def streamline( self ):
+        if not self.streamlined:
+            self.streamlined = True
+            if self.expr is not None:
+                self.expr.streamline()
+        return self
+
+    def validate( self, validateTrace=[] ):
+        if self not in validateTrace:
+            tmp = validateTrace[:]+[self]
+            if self.expr is not None:
+                self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+        return self.__class__.__name__ + ": ..."
+
+        # stubbed out for now - creates awful memory and perf issues
+        self._revertClass = self.__class__
+        self.__class__ = _ForwardNoRecurse
+        try:
+            if self.expr is not None:
+                retString = _ustr(self.expr)
+            else:
+                retString = "None"
+        finally:
+            self.__class__ = self._revertClass
+        return self.__class__.__name__ + ": " + retString
+
+    def copy(self):
+        if self.expr is not None:
+            return super(Forward,self).copy()
+        else:
+            ret = Forward()
+            ret <<= self
+            return ret
+
+class _ForwardNoRecurse(Forward):
+    def __str__( self ):
+        return "..."
+
+class TokenConverter(ParseElementEnhance):
+    """
+    Abstract subclass of C{ParseExpression}, for converting parsed results.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(TokenConverter,self).__init__( expr )#, savelist )
+        self.saveAsList = False
+
+class Combine(TokenConverter):
+    """
+    Converter to concatenate all matching tokens to a single string.
+    By default, the matching patterns must also be contiguous in the input string;
+    this can be disabled by specifying C{'adjacent=False'} in the constructor.
+
+    Example::
+        real = Word(nums) + '.' + Word(nums)
+        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
+        # will also erroneously match the following
+        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']
+
+        real = Combine(Word(nums) + '.' + Word(nums))
+        print(real.parseString('3.1416')) # -> ['3.1416']
+        # no match when there are internal spaces
+        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
+    """
+    def __init__( self, expr, joinString="", adjacent=True ):
+        super(Combine,self).__init__( expr )
+        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
+        if adjacent:
+            self.leaveWhitespace()
+        self.adjacent = adjacent
+        self.skipWhitespace = True
+        self.joinString = joinString
+        self.callPreparse = True
+
+    def ignore( self, other ):
+        if self.adjacent:
+            ParserElement.ignore(self, other)
+        else:
+            super( Combine, self).ignore( other )
+        return self
+
+    def postParse( self, instring, loc, tokenlist ):
+        retToks = tokenlist.copy()
+        del retToks[:]
+        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)
+
+        if self.resultsName and retToks.haskeys():
+            return [ retToks ]
+        else:
+            return retToks
+
+class Group(TokenConverter):
+    """
+    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.
+
+    Example::
+        ident = Word(alphas)
+        num = Word(nums)
+        term = ident | num
+        func = ident + Optional(delimitedList(term))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']
+
+        func = ident + Group(Optional(delimitedList(term)))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
+    """
+    def __init__( self, expr ):
+        super(Group,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        return [ tokenlist ]
+
+class Dict(TokenConverter):
+    """
+    Converter to return a repetitive expression as a list, but also as a dictionary.
+    Each element can also be referenced using the first token in the expression as its key.
+    Useful for tabular report scraping when the first column can be used as a item key.
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        # print attributes as plain groups
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
+        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
+        print(result.dump())
+        
+        # access named fields as dict entries, or output as dict
+        print(result['shape'])        
+        print(result.asDict())
+    prints::
+        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
+
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
+    See more examples at L{ParseResults} of accessing fields by results name.
+    """
+    def __init__( self, expr ):
+        super(Dict,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        for i,tok in enumerate(tokenlist):
+            if len(tok) == 0:
+                continue
+            ikey = tok[0]
+            if isinstance(ikey,int):
+                ikey = _ustr(tok[0]).strip()
+            if len(tok)==1:
+                tokenlist[ikey] = _ParseResultsWithOffset("",i)
+            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
+                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
+            else:
+                dictvalue = tok.copy() #ParseResults(i)
+                del dictvalue[0]
+                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
+                else:
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)
+
+        if self.resultsName:
+            return [ tokenlist ]
+        else:
+            return tokenlist
+
+
+class Suppress(TokenConverter):
+    """
+    Converter for ignoring the results of a parsed expression.
+
+    Example::
+        source = "a, b, c,d"
+        wd = Word(alphas)
+        wd_list1 = wd + ZeroOrMore(',' + wd)
+        print(wd_list1.parseString(source))
+
+        # often, delimiters that are useful during parsing are just in the
+        # way afterward - use Suppress to keep them out of the parsed output
+        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        print(wd_list2.parseString(source))
+    prints::
+        ['a', ',', 'b', ',', 'c', ',', 'd']
+        ['a', 'b', 'c', 'd']
+    (See also L{delimitedList}.)
+    """
+    def postParse( self, instring, loc, tokenlist ):
+        return []
+
+    def suppress( self ):
+        return self
+
+
+class OnlyOnce(object):
+    """
+    Wrapper for parse actions, to ensure they are only called once.
+    """
+    def __init__(self, methodCall):
+        self.callable = _trim_arity(methodCall)
+        self.called = False
+    def __call__(self,s,l,t):
+        if not self.called:
+            results = self.callable(s,l,t)
+            self.called = True
+            return results
+        raise ParseException(s,l,"")
+    def reset(self):
+        self.called = False
+
+def traceParseAction(f):
+    """
+    Decorator for debugging parse actions. 
+    
+    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
+    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.
+
+    Example::
+        wd = Word(alphas)
+
+        @traceParseAction
+        def remove_duplicate_chars(tokens):
+            return ''.join(sorted(set(''.join(tokens))))
+
+        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
+        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
+    prints::
+        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
+        <<leaving remove_duplicate_chars (ret: 'dfjkls')
+        ['dfjkls']
+    """
+    f = _trim_arity(f)
+    def z(*paArgs):
+        thisFunc = f.__name__
+        s,l,t = paArgs[-3:]
+        if len(paArgs)>3:
+            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
+        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
+        try:
+            ret = f(*paArgs)
+        except Exception as exc:
+            sys.stderr.write( "<<leaving %s (exception: %s)\n" % (thisFunc,exc) )
+            raise
+        sys.stderr.write( "<<leaving %s (ret: %r)\n" % (thisFunc,ret) )
+        return ret
+    try:
+        z.__name__ = f.__name__
+    except AttributeError:
+        pass
+    return z
+
+#
+# global helpers
+#
+def delimitedList( expr, delim=",", combine=False ):
+    """
+    Helper to define a delimited list of expressions - the delimiter defaults to ','.
+    By default, the list elements and delimiters can have intervening whitespace, and
+    comments, but this can be overridden by passing C{combine=True} in the constructor.
+    If C{combine} is set to C{True}, the matching tokens are returned as a single token
+    string, with the delimiters included; otherwise, the matching tokens are returned
+    as a list of tokens, with the delimiters suppressed.
+
+    Example::
+        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
+        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+    """
+    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
+    if combine:
+        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
+    else:
+        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)
+
+def countedArray( expr, intExpr=None ):
+    """
+    Helper to define a counted list of expressions.
+    This helper defines a pattern of the form::
+        integer expr expr expr...
+    where the leading integer tells how many expr expressions follow.
+    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
+    
+    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.
+
+    Example::
+        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']
+
+        # in this parser, the leading integer value is given in binary,
+        # '10' indicating that 2 values are in the array
+        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
+        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
+    """
+    arrayExpr = Forward()
+    def countFieldParseAction(s,l,t):
+        n = t[0]
+        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
+        return []
+    if intExpr is None:
+        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
+    else:
+        intExpr = intExpr.copy()
+    intExpr.setName("arrayLen")
+    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
+    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')
+
+def _flatten(L):
+    ret = []
+    for i in L:
+        if isinstance(i,list):
+            ret.extend(_flatten(i))
+        else:
+            ret.append(i)
+    return ret
+
+def matchPreviousLiteral(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousLiteral(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
+    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
+    If this is not desired, use C{matchPreviousExpr}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    def copyTokenToRepeater(s,l,t):
+        if t:
+            if len(t) == 1:
+                rep << t[0]
+            else:
+                # flatten t tokens
+                tflat = _flatten(t.asList())
+                rep << And(Literal(tt) for tt in tflat)
+        else:
+            rep << Empty()
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def matchPreviousExpr(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousExpr(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
+    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
+    the expressions are evaluated first, and then compared, so
+    C{"1"} is compared with C{"10"}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    e2 = expr.copy()
+    rep <<= e2
+    def copyTokenToRepeater(s,l,t):
+        matchTokens = _flatten(t.asList())
+        def mustMatchTheseTokens(s,l,t):
+            theseTokens = _flatten(t.asList())
+            if  theseTokens != matchTokens:
+                raise ParseException("",0,"")
+        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def _escapeRegexRangeChars(s):
+    #~  escape these chars: ^-]
+    for c in r"\^-]":
+        s = s.replace(c,_bslash+c)
+    s = s.replace("\n",r"\n")
+    s = s.replace("\t",r"\t")
+    return _ustr(s)
+
+def oneOf( strs, caseless=False, useRegex=True ):
+    """
+    Helper to quickly define a set of alternative Literals, and makes sure to do
+    longest-first testing when there is a conflict, regardless of the input order,
+    but returns a C{L{MatchFirst}} for best performance.
+
+    Parameters:
+     - strs - a string of space-delimited literals, or a collection of string literals
+     - caseless - (default=C{False}) - treat all literals as caseless
+     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
+          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
+          if creating a C{Regex} raises an exception)
+
+    Example::
+        comp_oper = oneOf("< = > <= >= !=")
+        var = Word(alphas)
+        number = Word(nums)
+        term = var | number
+        comparison_expr = term + comp_oper + term
+        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
+    prints::
+        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
+    """
+    if caseless:
+        isequal = ( lambda a,b: a.upper() == b.upper() )
+        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
+        parseElementClass = CaselessLiteral
+    else:
+        isequal = ( lambda a,b: a == b )
+        masks = ( lambda a,b: b.startswith(a) )
+        parseElementClass = Literal
+
+    symbols = []
+    if isinstance(strs,basestring):
+        symbols = strs.split()
+    elif isinstance(strs, Iterable):
+        symbols = list(strs)
+    else:
+        warnings.warn("Invalid argument to oneOf, expected string or iterable",
+                SyntaxWarning, stacklevel=2)
+    if not symbols:
+        return NoMatch()
+
+    i = 0
+    while i < len(symbols)-1:
+        cur = symbols[i]
+        for j,other in enumerate(symbols[i+1:]):
+            if ( isequal(other, cur) ):
+                del symbols[i+j+1]
+                break
+            elif ( masks(cur, other) ):
+                del symbols[i+j+1]
+                symbols.insert(i,other)
+                cur = other
+                break
+        else:
+            i += 1
+
+    if not caseless and useRegex:
+        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
+        try:
+            if len(symbols)==len("".join(symbols)):
+                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
+            else:
+                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
+        except Exception:
+            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
+                    SyntaxWarning, stacklevel=2)
+
+
+    # last resort, just use MatchFirst
+    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))
+
+def dictOf( key, value ):
+    """
+    Helper to easily and clearly define a dictionary by specifying the respective patterns
+    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
+    in the proper order.  The key pattern can include delimiting markers or punctuation,
+    as long as they are suppressed, thereby leaving the significant key text.  The value
+    pattern can include named results, so that the C{Dict} results can include named token
+    fields.
+
+    Example::
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        attr_label = label
+        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)
+
+        # similar to Dict, but simpler call format
+        result = dictOf(attr_label, attr_value).parseString(text)
+        print(result.dump())
+        print(result['shape'])
+        print(result.shape)  # object attribute access works too
+        print(result.asDict())
+    prints::
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        SQUARE
+        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
+    """
+    return Dict( ZeroOrMore( Group ( key + value ) ) )
+
+def originalTextFor(expr, asString=True):
+    """
+    Helper to return the original, untokenized text for a given expression.  Useful to
+    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
+    revert separate tokens with intervening whitespace back to the original matching
+    input text. By default, returns astring containing the original parsed text.  
+       
+    If the optional C{asString} argument is passed as C{False}, then the return value is a 
+    C{L{ParseResults}} containing any results names that were originally matched, and a 
+    single token containing the original matched text from the input string.  So if 
+    the expression passed to C{L{originalTextFor}} contains expressions with defined
+    results names, you must set C{asString} to C{False} if you want to preserve those
+    results name values.
+
+    Example::
+        src = "this is test <b> bold <i>text</i> </b> normal text "
+        for tag in ("b","i"):
+            opener,closer = makeHTMLTags(tag)
+            patt = originalTextFor(opener + SkipTo(closer) + closer)
+            print(patt.searchString(src)[0])
+    prints::
+        ['<b> bold <i>text</i> </b>']
+        ['<i>text</i>']
+    """
+    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
+    endlocMarker = locMarker.copy()
+    endlocMarker.callPreparse = False
+    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
+    if asString:
+        extractText = lambda s,l,t: s[t._original_start:t._original_end]
+    else:
+        def extractText(s,l,t):
+            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
+    matchExpr.setParseAction(extractText)
+    matchExpr.ignoreExprs = expr.ignoreExprs
+    return matchExpr
+
+def ungroup(expr): 
+    """
+    Helper to undo pyparsing's default grouping of And expressions, even
+    if all but one are non-empty.
+    """
+    return TokenConverter(expr).setParseAction(lambda t:t[0])
+
+def locatedExpr(expr):
+    """
+    Helper to decorate a returned token with its starting and ending locations in the input string.
+    This helper adds the following results names:
+     - locn_start = location where matched expression begins
+     - locn_end = location where matched expression ends
+     - value = the actual parsed results
+
+    Be careful if the input text contains C{<TAB>} characters, you may want to call
+    C{L{ParserElement.parseWithTabs}}
+
+    Example::
+        wd = Word(alphas)
+        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+            print(match)
+    prints::
+        [[0, 'ljsdf', 5]]
+        [[8, 'lksdjjf', 15]]
+        [[18, 'lkkjj', 23]]
+    """
+    locator = Empty().setParseAction(lambda s,l,t: l)
+    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
+
+
+# convenience constants for positional expressions
+empty       = Empty().setName("empty")
+lineStart   = LineStart().setName("lineStart")
+lineEnd     = LineEnd().setName("lineEnd")
+stringStart = StringStart().setName("stringStart")
+stringEnd   = StringEnd().setName("stringEnd")
+
+_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
+_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
+_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
+_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
+_charRange = Group(_singleChar + Suppress("-") + _singleChar)
+_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"
+
+def srange(s):
+    r"""
+    Helper to easily define string ranges for use in Word construction.  Borrows
+    syntax from regexp '[]' string range definitions::
+        srange("[0-9]")   -> "0123456789"
+        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
+        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
+    The input string must be enclosed in []'s, and the returned string is the expanded
+    character set joined into a single string.
+    The values enclosed in the []'s may be:
+     - a single character
+     - an escaped character with a leading backslash (such as C{\-} or C{\]})
+     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
+         (C{\0x##} is also supported for backwards compatibility) 
+     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
+     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
+     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
+    """
+    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
+    try:
+        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
+    except Exception:
+        return ""
+
+def matchOnlyAtCol(n):
+    """
+    Helper method for defining parse actions that require matching at a specific
+    column in the input text.
+    """
+    def verifyCol(strg,locn,toks):
+        if col(locn,strg) != n:
+            raise ParseException(strg,locn,"matched token not at column %d" % n)
+    return verifyCol
+
+def replaceWith(replStr):
+    """
+    Helper method for common parse actions that simply return a literal value.  Especially
+    useful when used with C{L{transformString<ParserElement.transformString>}()}.
+
+    Example::
+        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
+        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
+        term = na | num
+        
+        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
+    """
+    return lambda s,l,t: [replStr]
+
+def removeQuotes(s,l,t):
+    """
+    Helper parse action for removing quotation marks from parsed quoted strings.
+
+    Example::
+        # by default, quotation marks are included in parsed results
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]
+
+        # use removeQuotes to strip quotation marks from parsed results
+        quotedString.setParseAction(removeQuotes)
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
+    """
+    return t[0][1:-1]
+
+def tokenMap(func, *args):
+    """
+    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
+    args are passed, they are forwarded to the given function as additional arguments after
+    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
+    parsed data to an integer using base 16.
+
+    Example (compare the last to example in L{ParserElement.transformString}::
+        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
+        hex_ints.runTests('''
+            00 11 22 aa FF 0a 0d 1a
+            ''')
+        
+        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
+        OneOrMore(upperword).runTests('''
+            my kingdom for a horse
+            ''')
+
+        wd = Word(alphas).setParseAction(tokenMap(str.title))
+        OneOrMore(wd).setParseAction(' '.join).runTests('''
+            now is the winter of our discontent made glorious summer by this sun of york
+            ''')
+    prints::
+        00 11 22 aa FF 0a 0d 1a
+        [0, 17, 34, 170, 255, 10, 13, 26]
+
+        my kingdom for a horse
+        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']
+
+        now is the winter of our discontent made glorious summer by this sun of york
+        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
+    """
+    def pa(s,l,t):
+        return [func(tokn, *args) for tokn in t]
+
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    pa.__name__ = func_name
+
+    return pa
+
+upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
+"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""
+
+downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
+"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
+    
+def _makeTags(tagStr, xml):
+    """Internal helper to construct opening and closing tag expressions, given a tag name"""
+    if isinstance(tagStr,basestring):
+        resname = tagStr
+        tagStr = Keyword(tagStr, caseless=not xml)
+    else:
+        resname = tagStr.name
+
+    tagAttrName = Word(alphas,alphanums+"_-:")
+    if (xml):
+        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    else:
+        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
+        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
+                Optional( Suppress("=") + tagAttrValue ) ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    closeTag = Combine(_L("</") + tagStr + ">")
+
+    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
+    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("</%s>" % resname)
+    openTag.tag = resname
+    closeTag.tag = resname
+    return openTag, closeTag
+
+def makeHTMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
+    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.
+
+    Example::
+        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
+        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
+        a,a_end = makeHTMLTags("A")
+        link_expr = a + SkipTo(a_end)("link_text") + a_end
+        
+        for link in link_expr.searchString(text):
+            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
+            print(link.link_text, '->', link.href)
+    prints::
+        pyparsing -> http://pyparsing.wikispaces.com
+    """
+    return _makeTags( tagStr, False )
+
+def makeXMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
+    tags only in the given upper/lower case.
+
+    Example: similar to L{makeHTMLTags}
+    """
+    return _makeTags( tagStr, True )
+
+def withAttribute(*args,**attrDict):
+    """
+    Helper to create a validating parse action to be used with start tags created
+    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
+    with a required attribute value, to avoid false matches on common tags such as
+    C{<TD>} or C{<DIV>}.
+
+    Call C{withAttribute} with a series of attribute names and values. Specify the list
+    of filter attributes names and values as:
+     - keyword arguments, as in C{(align="right")}, or
+     - as an explicit dict with C{**} operator, when an attribute name is also a Python
+          reserved word, as in C{**{"class":"Customer", "align":"right"}}
+     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
+    For attribute names with a namespace prefix, you must use the second form.  Attribute
+    names are matched insensitive to upper/lower case.
+       
+    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.
+
+    To verify that the attribute exists, but without specifying a value, pass
+    C{withAttribute.ANY_VALUE} as the value.
+
+    Example::
+        html = '''
+            <div>
+            Some text
+            <div type="grid">1 4 0 1 0</div>
+            <div type="graph">1,3 2,3 1,1</div>
+            <div>this has no type</div>
+            </div>
+                
+        '''
+        div,div_end = makeHTMLTags("div")
+
+        # only match div tag having a type attribute with value "grid"
+        div_grid = div().setParseAction(withAttribute(type="grid"))
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+        
+        # construct a match with any div tag having a type attribute, regardless of the value
+        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+    prints::
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    if args:
+        attrs = args[:]
+    else:
+        attrs = attrDict.items()
+    attrs = [(k,v) for k,v in attrs]
+    def pa(s,l,tokens):
+        for attrName,attrValue in attrs:
+            if attrName not in tokens:
+                raise ParseException(s,l,"no matching attribute " + attrName)
+            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
+                raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" %
+                                            (attrName, tokens[attrName], attrValue))
+    return pa
+withAttribute.ANY_VALUE = object()
+
+def withClass(classname, namespace=''):
+    """
+    Simplified version of C{L{withAttribute}} when matching on a div class - made
+    difficult because C{class} is a reserved word in Python.
+
+    Example::
+        html = '''
+            <div>
+            Some text
+            <div class="grid">1 4 0 1 0</div>
+            <div class="graph">1,3 2,3 1,1</div>
+            <div>this &lt;div&gt; has no class</div>
+            </div>
+                
+        '''
+        div,div_end = makeHTMLTags("div")
+        div_grid = div().setParseAction(withClass("grid"))
+        
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+        
+        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+    prints::
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    classattr = "%s:class" % namespace if namespace else "class"
+    return withAttribute(**{classattr : classname})        
+
+opAssoc = _Constants()
+opAssoc.LEFT = object()
+opAssoc.RIGHT = object()
+
+def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ):
+    """
+    Helper method for constructing grammars of expressions made up of
+    operators working in a precedence hierarchy.  Operators may be unary or
+    binary, left- or right-associative.  Parse actions can also be attached
+    to operator expressions. The generated parser will also recognize the use 
+    of parentheses to override operator precedences (see example below).
+    
+    Note: if you define a deep operator list, you may see performance issues
+    when using infixNotation. See L{ParserElement.enablePackrat} for a
+    mechanism to potentially improve your parser performance.
+
+    Parameters:
+     - baseExpr - expression representing the most basic element for the nested
+     - opList - list of tuples, one for each operator precedence level in the
+      expression grammar; each tuple is of the form
+      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
+       - opExpr is the pyparsing expression for the operator;
+          may also be a string, which will be converted to a Literal;
+          if numTerms is 3, opExpr is a tuple of two expressions, for the
+          two operators separating the 3 terms
+       - numTerms is the number of terms for this operator (must
+          be 1, 2, or 3)
+       - rightLeftAssoc is the indicator whether the operator is
+          right or left associative, using the pyparsing-defined
+          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
+       - parseAction is the parse action to be associated with
+          expressions matching this operator expression (the
+          parse action tuple member may be omitted); if the parse action
+          is passed a tuple or list of functions, this is equivalent to
+          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
+     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
+     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})
+
+    Example::
+        # simple example of four-function arithmetic with ints and variable names
+        integer = pyparsing_common.signed_integer
+        varname = pyparsing_common.identifier 
+        
+        arith_expr = infixNotation(integer | varname,
+            [
+            ('-', 1, opAssoc.RIGHT),
+            (oneOf('* /'), 2, opAssoc.LEFT),
+            (oneOf('+ -'), 2, opAssoc.LEFT),
+            ])
+        
+        arith_expr.runTests('''
+            5+3*6
+            (5+3)*6
+            -2--11
+            ''', fullDump=False)
+    prints::
+        5+3*6
+        [[5, '+', [3, '*', 6]]]
+
+        (5+3)*6
+        [[[5, '+', 3], '*', 6]]
+
+        -2--11
+        [[['-', 2], '-', ['-', 11]]]
+    """
+    ret = Forward()
+    lastExpr = baseExpr | ( lpar + ret + rpar )
+    for i,operDef in enumerate(opList):
+        opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4]
+        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
+        if arity == 3:
+            if opExpr is None or len(opExpr) != 2:
+                raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions")
+            opExpr1, opExpr2 = opExpr
+        thisExpr = Forward().setName(termName)
+        if rightLeftAssoc == opAssoc.LEFT:
+            if arity == 1:
+                matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) )
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) )
+                else:
+                    matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) )
+            elif arity == 3:
+                matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \
+                            Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr )
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        elif rightLeftAssoc == opAssoc.RIGHT:
+            if arity == 1:
+                # try to avoid LR with this extra test
+                if not isinstance(opExpr, Optional):
+                    opExpr = Optional(opExpr)
+                matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr )
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) )
+                else:
+                    matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) )
+            elif arity == 3:
+                matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \
+                            Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr )
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        else:
+            raise ValueError("operator must indicate right or left associativity")
+        if pa:
+            if isinstance(pa, (tuple, list)):
+                matchExpr.setParseAction(*pa)
+            else:
+                matchExpr.setParseAction(pa)
+        thisExpr <<= ( matchExpr.setName(termName) | lastExpr )
+        lastExpr = thisExpr
+    ret <<= lastExpr
+    return ret
+
+operatorPrecedence = infixNotation
+"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release."""
+
+dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes")
+sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes")
+quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'|
+                       Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes")
+unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")
+
+def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
+    """
+    Helper method for defining nested lists enclosed in opening and closing
+    delimiters ("(" and ")" are the default).
+
+    Parameters:
+     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
+     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
+     - content - expression for items within the nested lists (default=C{None})
+     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})
+
+    If an expression is not provided for the content argument, the nested
+    expression will capture all whitespace-delimited content between delimiters
+    as a list of separate values.
+
+    Use the C{ignoreExpr} argument to define expressions that may contain
+    opening or closing characters that should not be treated as opening
+    or closing characters for nesting, such as quotedString or a comment
+    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
+    The default is L{quotedString}, but if no expressions are to be ignored,
+    then pass C{None} for this argument.
+
+    Example::
+        data_type = oneOf("void int short long char float double")
+        decl_data_type = Combine(data_type + Optional(Word('*')))
+        ident = Word(alphas+'_', alphanums+'_')
+        number = pyparsing_common.number
+        arg = Group(decl_data_type + ident)
+        LPAR,RPAR = map(Suppress, "()")
+
+        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))
+
+        c_function = (decl_data_type("type") 
+                      + ident("name")
+                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
+                      + code_body("body"))
+        c_function.ignore(cStyleComment)
+        
+        source_code = '''
+            int is_odd(int x) { 
+                return (x%2); 
+            }
+                
+            int dec_to_hex(char hchar) { 
+                if (hchar >= '0' && hchar <= '9') { 
+                    return (ord(hchar)-ord('0')); 
+                } else { 
+                    return (10+ord(hchar)-ord('A'));
+                } 
+            }
+        '''
+        for func in c_function.searchString(source_code):
+            print("%(name)s (%(type)s) args: %(args)s" % func)
+
+    prints::
+        is_odd (int) args: [['int', 'x']]
+        dec_to_hex (int) args: [['char', 'hchar']]
+    """
+    if opener == closer:
+        raise ValueError("opening and closing strings cannot be the same")
+    if content is None:
+        if isinstance(opener,basestring) and isinstance(closer,basestring):
+            if len(opener) == 1 and len(closer)==1:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr +
+                                    CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+                else:
+                    content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS
+                                ).setParseAction(lambda t:t[0].strip()))
+            else:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr + 
+                                    ~Literal(opener) + ~Literal(closer) +
+                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+                else:
+                    content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) +
+                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+        else:
+            raise ValueError("opening and closing arguments must be strings if no content expression is given")
+    ret = Forward()
+    if ignoreExpr is not None:
+        ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) )
+    else:
+        ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content )  + Suppress(closer) )
+    ret.setName('nested %s%s expression' % (opener,closer))
+    return ret
+
+def indentedBlock(blockStatementExpr, indentStack, indent=True):
+    """
+    Helper method for defining space-delimited indentation blocks, such as
+    those used to define block statements in Python source code.
+
+    Parameters:
+     - blockStatementExpr - expression defining syntax of statement that
+            is repeated within the indented block
+     - indentStack - list created by caller to manage indentation stack
+            (multiple statementWithIndentedBlock expressions within a single grammar
+            should share a common indentStack)
+     - indent - boolean indicating whether block must be indented beyond the
+            the current level; set to False for block of left-most statements
+            (default=C{True})
+
+    A valid block must contain at least one C{blockStatement}.
+
+    Example::
+        data = '''
+        def A(z):
+          A1
+          B = 100
+          G = A2
+          A2
+          A3
+        B
+        def BB(a,b,c):
+          BB1
+          def BBA():
+            bba1
+            bba2
+            bba3
+        C
+        D
+        def spam(x,y):
+             def eggs(z):
+                 pass
+        '''
+
+
+        indentStack = [1]
+        stmt = Forward()
+
+        identifier = Word(alphas, alphanums)
+        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
+        func_body = indentedBlock(stmt, indentStack)
+        funcDef = Group( funcDecl + func_body )
+
+        rvalue = Forward()
+        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
+        rvalue << (funcCall | identifier | Word(nums))
+        assignment = Group(identifier + "=" + rvalue)
+        stmt << ( funcDef | assignment | identifier )
+
+        module_body = OneOrMore(stmt)
+
+        parseTree = module_body.parseString(data)
+        parseTree.pprint()
+    prints::
+        [['def',
+          'A',
+          ['(', 'z', ')'],
+          ':',
+          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
+         'B',
+         ['def',
+          'BB',
+          ['(', 'a', 'b', 'c', ')'],
+          ':',
+          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
+         'C',
+         'D',
+         ['def',
+          'spam',
+          ['(', 'x', 'y', ')'],
+          ':',
+          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
+    """
+    def checkPeerIndent(s,l,t):
+        if l >= len(s): return
+        curCol = col(l,s)
+        if curCol != indentStack[-1]:
+            if curCol > indentStack[-1]:
+                raise ParseFatalException(s,l,"illegal nesting")
+            raise ParseException(s,l,"not a peer entry")
+
+    def checkSubIndent(s,l,t):
+        curCol = col(l,s)
+        if curCol > indentStack[-1]:
+            indentStack.append( curCol )
+        else:
+            raise ParseException(s,l,"not a subentry")
+
+    def checkUnindent(s,l,t):
+        if l >= len(s): return
+        curCol = col(l,s)
+        if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]):
+            raise ParseException(s,l,"not an unindent")
+        indentStack.pop()
+
+    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress())
+    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
+    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
+    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
+    if indent:
+        smExpr = Group( Optional(NL) +
+            #~ FollowedBy(blockStatementExpr) +
+            INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT)
+    else:
+        smExpr = Group( Optional(NL) +
+            (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) )
+    blockStatementExpr.ignore(_bslash + LineEnd())
+    return smExpr.setName('indented block')
+
+alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
+punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")
+
+anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag'))
+_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\''))
+commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
+def replaceHTMLEntity(t):
+    """Helper parser action to replace common HTML entities with their special characters"""
+    return _htmlEntityMap.get(t.entity)
+
+# it's easy to get these comment structures wrong - they're very common, so may as well make them available
+cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
+"Comment of the form C{/* ... */}"
+
+htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
+"Comment of the form C{<!-- ... -->}"
+
+restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
+dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
+"Comment of the form C{// ... (to end of line)}"
+
+cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment")
+"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}"
+
+javaStyleComment = cppStyleComment
+"Same as C{L{cppStyleComment}}"
+
+pythonStyleComment = Regex(r"#.*").setName("Python style comment")
+"Comment of the form C{# ... (to end of line)}"
+
+_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') +
+                                  Optional( Word(" \t") +
+                                            ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem")
+commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList")
+"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas.
+   This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}."""
+
+# some other useful expressions - using lower-case class name since we are really using this as a namespace
+class pyparsing_common:
+    """
+    Here are some common low-level expressions that may be useful in jump-starting parser development:
+     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
+     - common L{programming identifiers<identifier>}
+     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
+     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
+     - L{UUID<uuid>}
+     - L{comma-separated list<comma_separated_list>}
+    Parse actions:
+     - C{L{convertToInteger}}
+     - C{L{convertToFloat}}
+     - C{L{convertToDate}}
+     - C{L{convertToDatetime}}
+     - C{L{stripHTMLTags}}
+     - C{L{upcaseTokens}}
+     - C{L{downcaseTokens}}
+
+    Example::
+        pyparsing_common.number.runTests('''
+            # any int or real number, returned as the appropriate type
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.fnumber.runTests('''
+            # any int or real number, returned as float
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.hex_integer.runTests('''
+            # hex numbers
+            100
+            FF
+            ''')
+
+        pyparsing_common.fraction.runTests('''
+            # fractions
+            1/2
+            -3/4
+            ''')
+
+        pyparsing_common.mixed_integer.runTests('''
+            # mixed fractions
+            1
+            1/2
+            -3/4
+            1-3/4
+            ''')
+
+        import uuid
+        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+        pyparsing_common.uuid.runTests('''
+            # uuid
+            12345678-1234-5678-1234-567812345678
+            ''')
+    prints::
+        # any int or real number, returned as the appropriate type
+        100
+        [100]
+
+        -100
+        [-100]
+
+        +100
+        [100]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # any int or real number, returned as float
+        100
+        [100.0]
+
+        -100
+        [-100.0]
+
+        +100
+        [100.0]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # hex numbers
+        100
+        [256]
+
+        FF
+        [255]
+
+        # fractions
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        # mixed fractions
+        1
+        [1]
+
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        1-3/4
+        [1.75]
+
+        # uuid
+        12345678-1234-5678-1234-567812345678
+        [UUID('12345678-1234-5678-1234-567812345678')]
+    """
+
+    convertToInteger = tokenMap(int)
+    """
+    Parse action for converting parsed integers to Python int
+    """
+
+    convertToFloat = tokenMap(float)
+    """
+    Parse action for converting parsed numbers to Python float
+    """
+
+    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
+    """expression that parses an unsigned integer, returns an int"""
+
+    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16))
+    """expression that parses a hexadecimal integer, returns an int"""
+
+    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
+    """expression that parses an integer with optional leading sign, returns an int"""
+
+    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
+    """fractional expression of an integer divided by an integer, returns a float"""
+    fraction.addParseAction(lambda t: t[0]/t[-1])
+
+    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
+    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
+    mixed_integer.addParseAction(sum)
+
+    real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat)
+    """expression that parses a floating point number and returns a float"""
+
+    sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
+    """expression that parses a floating point number with optional scientific notation and returns a float"""
+
+    # streamlining this expression makes the docs nicer-looking
+    number = (sci_real | real | signed_integer).streamline()
+    """any numeric expression, returns the corresponding Python type"""
+
+    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
+    """any int or real number, returned as float"""
+    
+    identifier = Word(alphas+'_', alphanums+'_').setName("identifier")
+    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
+    
+    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
+    "IPv4 address (C{0.0.0.0 - 255.255.255.255})"
+
+    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
+    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address")
+    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address")
+    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
+    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
+    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
+    "IPv6 address (long, short, or mixed form)"
+    
+    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
+    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"
+
+    @staticmethod
+    def convertToDate(fmt="%Y-%m-%d"):
+        """
+        Helper to create a parse action for converting parsed date string to Python datetime.date
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})
+
+        Example::
+            date_expr = pyparsing_common.iso8601_date.copy()
+            date_expr.setParseAction(pyparsing_common.convertToDate())
+            print(date_expr.parseString("1999-12-31"))
+        prints::
+            [datetime.date(1999, 12, 31)]
+        """
+        def cvt_fn(s,l,t):
+            try:
+                return datetime.strptime(t[0], fmt).date()
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    @staticmethod
+    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
+        """
+        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})
+
+        Example::
+            dt_expr = pyparsing_common.iso8601_datetime.copy()
+            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
+            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
+        prints::
+            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
+        """
+        def cvt_fn(s,l,t):
+            try:
+                return datetime.strptime(t[0], fmt)
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
+    "ISO8601 date (C{yyyy-mm-dd})"
+
+    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
+    "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}"
+
+    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
+    "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})"
+
+    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
+    @staticmethod
+    def stripHTMLTags(s, l, tokens):
+        """
+        Parse action to remove HTML tags from web page HTML source
+
+        Example::
+            # strip HTML links from normal text 
+            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
+            td,td_end = makeHTMLTags("TD")
+            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
+            
+            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
+        """
+        return pyparsing_common._html_stripper.transformString(tokens[0])
+
+    _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') 
+                                        + Optional( White(" \t") ) ) ).streamline().setName("commaItem")
+    comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list")
+    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""
+
+    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
+    """Parse action to convert tokens to upper case."""
+
+    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
+    """Parse action to convert tokens to lower case."""
+
+
+if __name__ == "__main__":
+
+    selectToken    = CaselessLiteral("select")
+    fromToken      = CaselessLiteral("from")
+
+    ident          = Word(alphas, alphanums + "_$")
+
+    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    columnNameList = Group(delimitedList(columnName)).setName("columns")
+    columnSpec     = ('*' | columnNameList)
+
+    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    tableNameList  = Group(delimitedList(tableName)).setName("tables")
+    
+    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")
+
+    # demo runTests method, including embedded comments in test string
+    simpleSQL.runTests("""
+        # '*' as column list and dotted table name
+        select * from SYS.XYZZY
+
+        # caseless match on "SELECT", and casts back to "select"
+        SELECT * from XYZZY, ABC
+
+        # list of column names, and mixed case SELECT keyword
+        Select AA,BB,CC from Sys.dual
+
+        # multiple tables
+        Select A, B, C from Sys.dual, Table2
+
+        # invalid SELECT keyword - should fail
+        Xelect A, B, C from Sys.dual
+
+        # incomplete command - should fail
+        Select
+
+        # invalid column name - should fail
+        Select ^^^ frox Sys.dual
+
+        """)
+
+    pyparsing_common.number.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    # any int or real number, returned as float
+    pyparsing_common.fnumber.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    pyparsing_common.hex_integer.runTests("""
+        100
+        FF
+        """)
+
+    import uuid
+    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+    pyparsing_common.uuid.runTests("""
+        12345678-1234-5678-1234-567812345678
+        """)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py
new file mode 100644
index 0000000000000000000000000000000000000000..190c0239cd7d7af82a6e0cbc8d68053fa2e3dfaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/_vendor/six.py
@@ -0,0 +1,868 @@
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+# Copyright (c) 2010-2015 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson <benjamin@python.org>"
+__version__ = "1.10.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = str,
+    integer_types = int,
+    class_types = type,
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = basestring,
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+
+            def __len__(self):
+                return 1 << 31
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+    get_source = get_code  # same as get_code
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser",
+                "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog",
+                "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
+                "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+                      "moves.urllib_parse", "moves.urllib.parse")
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+                      "moves.urllib_error", "moves.urllib.error")
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+                      "moves.urllib_request", "moves.urllib.request")
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+                      "moves.urllib_response", "moves.urllib.response")
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+                      "moves.urllib_robotparser", "moves.urllib.robotparser")
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ['parse', 'error', 'request', 'response', 'robotparser']
+
+_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
+                      "moves.urllib")
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+    def advance_iterator(it):
+        return it.next()
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(get_unbound_function,
+         """Get the function out of a possibly unbound function""")
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems,
+         "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(iterlists,
+         "Return an iterator over the (key, [values]) pairs of a dictionary.")
+
+
+if PY3:
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+    unichr = chr
+    import struct
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+else:
+    def b(s):
+        return s
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        if value is None:
+            value = tp()
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+
+else:
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec("""exec _code_ in _globs_, _locs_""")
+
+    exec_("""def reraise(tp, value, tb=None):
+    raise tp, value, tb
+""")
+
+
+if sys.version_info[:2] == (3, 2):
+    exec_("""def raise_from(value, from_value):
+    if from_value is None:
+        raise value
+    raise value from from_value
+""")
+elif sys.version_info[:2] > (3, 2):
+    exec_("""def raise_from(value, from_value):
+    raise value from from_value
+""")
+else:
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (isinstance(fp, file) and
+                    isinstance(data, unicode) and
+                    fp.encoding is not None):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
+              updated=functools.WRAPPER_UPDATES):
+        def wrapper(f):
+            f = functools.wraps(wrapped, assigned, updated)(f)
+            f.__wrapped__ = wrapped
+            return f
+        return wrapper
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(meta):
+
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+    return type.__new__(metaclass, 'temporary_class', (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get('__slots__')
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop('__dict__', None)
+        orig_vars.pop('__weakref__', None)
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+    return wrapper
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if '__str__' not in klass.__dict__:
+            raise ValueError("@python_2_unicode_compatible cannot be applied "
+                             "to %s because it doesn't define __str__()." %
+                             klass.__name__)
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (type(importer).__name__ == "_SixMetaPathImporter" and
+                importer.name == __name__):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..c1eb9e998f8e117c82c176bc83ab1d350c729cd7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/extern/__init__.py
@@ -0,0 +1,73 @@
+import sys
+
+
+class VendorImporter:
+    """
+    A PEP 302 meta path importer for finding optionally-vendored
+    or otherwise naturally-installed packages from root_name.
+    """
+
+    def __init__(self, root_name, vendored_names=(), vendor_pkg=None):
+        self.root_name = root_name
+        self.vendored_names = set(vendored_names)
+        self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor')
+
+    @property
+    def search_path(self):
+        """
+        Search first the vendor package then as a natural package.
+        """
+        yield self.vendor_pkg + '.'
+        yield ''
+
+    def find_module(self, fullname, path=None):
+        """
+        Return self when fullname starts with root_name and the
+        target module is one vendored through this importer.
+        """
+        root, base, target = fullname.partition(self.root_name + '.')
+        if root:
+            return
+        if not any(map(target.startswith, self.vendored_names)):
+            return
+        return self
+
+    def load_module(self, fullname):
+        """
+        Iterate over the search path to locate and load fullname.
+        """
+        root, base, target = fullname.partition(self.root_name + '.')
+        for prefix in self.search_path:
+            try:
+                extant = prefix + target
+                __import__(extant)
+                mod = sys.modules[extant]
+                sys.modules[fullname] = mod
+                # mysterious hack:
+                # Remove the reference to the extant package/module
+                # on later Python versions to cause relative imports
+                # in the vendor package to resolve the same modules
+                # as those going through this importer.
+                if prefix and sys.version_info > (3, 3):
+                    del sys.modules[extant]
+                return mod
+            except ImportError:
+                pass
+        else:
+            raise ImportError(
+                "The '{target}' package is required; "
+                "normally this is bundled with this package so if you get "
+                "this warning, consult the packager of your "
+                "distribution.".format(**locals())
+            )
+
+    def install(self):
+        """
+        Install this importer into sys.meta_path if not already present.
+        """
+        if self not in sys.meta_path:
+            sys.meta_path.append(self)
+
+
+names = 'packaging', 'pyparsing', 'six', 'appdirs'
+VendorImporter(__name__, names).install()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..a381c424f9eaacb4126d4b8a474052551e34ccfb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pkg_resources/py31compat.py
@@ -0,0 +1,23 @@
+import os
+import errno
+import sys
+
+from .extern import six
+
+
+def _makedirs_31(path, exist_ok=False):
+    try:
+        os.makedirs(path)
+    except OSError as exc:
+        if not exist_ok or exc.errno != errno.EEXIST:
+            raise
+
+
+# rely on compatibility behavior until mode considerations
+#  and exists_ok considerations are disentangled.
+# See https://github.com/pypa/setuptools/pull/1083#issuecomment-315168663
+needs_makedirs = (
+    six.PY2 or
+    (3, 4) <= sys.version_info < (3, 4, 1)
+)
+makedirs = _makedirs_31 if needs_makedirs else os.makedirs
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..3522d50a805a967751c5040dba8c1f33e7c57922
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/METADATA
@@ -0,0 +1,173 @@
+Metadata-Version: 2.1
+Name: progress
+Version: 1.5
+Summary: Easy to use progress bars
+Home-page: http://github.com/verigak/progress/
+Author: Giorgos Verigakis
+Author-email: verigak@gmail.com
+License: ISC
+Platform: UNKNOWN
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: ISC License (ISCL)
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+
+Easy progress reporting for Python
+==================================
+
+|pypi|
+
+|demo|
+
+.. |pypi| image:: https://img.shields.io/pypi/v/progress.svg
+   :target: https://pypi.org/project/progress/
+.. |demo| image:: https://raw.github.com/verigak/progress/master/demo.gif
+   :alt: Demo
+
+Bars
+----
+
+There are 7 progress bars to choose from:
+
+- ``Bar``
+- ``ChargingBar``
+- ``FillingSquaresBar``
+- ``FillingCirclesBar``
+- ``IncrementalBar``
+- ``PixelBar``
+- ``ShadyBar``
+
+To use them, just call ``next`` to advance and ``finish`` to finish:
+
+.. code-block:: python
+
+    from progress.bar import Bar
+
+    bar = Bar('Processing', max=20)
+    for i in range(20):
+        # Do some work
+        bar.next()
+    bar.finish()
+
+or use any bar of this class as a context manager:
+
+.. code-block:: python
+
+    from progress.bar import Bar
+
+    with Bar('Processing', max=20) as bar:
+        for i in range(20):
+            # Do some work
+            bar.next()
+
+The result will be a bar like the following: ::
+
+    Processing |#############                   | 42/100
+
+To simplify the common case where the work is done in an iterator, you can
+use the ``iter`` method:
+
+.. code-block:: python
+
+    for i in Bar('Processing').iter(it):
+        # Do some work
+
+Progress bars are very customizable, you can change their width, their fill
+character, their suffix and more:
+
+.. code-block:: python
+
+    bar = Bar('Loading', fill='@', suffix='%(percent)d%%')
+
+This will produce a bar like the following: ::
+
+    Loading |@@@@@@@@@@@@@                   | 42%
+
+You can use a number of template arguments in ``message`` and ``suffix``:
+
+==========  ================================
+Name        Value
+==========  ================================
+index       current value
+max         maximum value
+remaining   max - index
+progress    index / max
+percent     progress * 100
+avg         simple moving average time per item (in seconds)
+elapsed     elapsed time in seconds
+elapsed_td  elapsed as a timedelta (useful for printing as a string)
+eta         avg * remaining
+eta_td      eta as a timedelta (useful for printing as a string)
+==========  ================================
+
+Instead of passing all configuration options on instatiation, you can create
+your custom subclass:
+
+.. code-block:: python
+
+    class FancyBar(Bar):
+        message = 'Loading'
+        fill = '*'
+        suffix = '%(percent).1f%% - %(eta)ds'
+
+You can also override any of the arguments or create your own:
+
+.. code-block:: python
+
+    class SlowBar(Bar):
+        suffix = '%(remaining_hours)d hours remaining'
+        @property
+        def remaining_hours(self):
+            return self.eta // 3600
+
+
+Spinners
+========
+
+For actions with an unknown number of steps you can use a spinner:
+
+.. code-block:: python
+
+    from progress.spinner import Spinner
+
+    spinner = Spinner('Loading ')
+    while state != 'FINISHED':
+        # Do some work
+        spinner.next()
+
+There are 5 predefined spinners:
+
+- ``Spinner``
+- ``PieSpinner``
+- ``MoonSpinner``
+- ``LineSpinner``
+- ``PixelSpinner``
+
+Installation
+============
+
+Download from PyPi
+
+.. code-block:: shell
+
+    pip install progress
+
+
+Other
+=====
+
+There are a number of other classes available too, please check the source or
+subclass one of them to create your own.
+
+
+License
+=======
+
+progress is licensed under ISC
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..25a397659daa8e5f7c6aeb138a20ad93deb26eda
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/RECORD
@@ -0,0 +1,18 @@
+progress/__init__.py,sha256=fcbQQXo5np2CoQyhSH5XprkicwLZNLePR3uIahznSO0,4857
+progress/bar.py,sha256=QuDuVNcmXgpxtNtxO0Fq72xKigxABaVmxYGBw4J3Z_E,2854
+progress/counter.py,sha256=MznyBrvPWrOlGe4MZAlGUb9q3aODe6_aNYeAE_VNoYA,1372
+progress/spinner.py,sha256=k8JbDW94T0-WXuXfxZIFhdoNPYp3jfnpXqBnfRv5fGs,1380
+progress-1.5.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+progress-1.5.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+progress-1.5.dist-info/METADATA,sha256=I7SkME7k1abUtaNnbD9kD86dyShGIl8MnHFkKGCAPz8,3980
+progress-1.5.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+progress-1.5.dist-info/top_level.txt,sha256=deWgGnjsbS4Te_YRxD6BN8yoqv0q8sH67UsBKNCcyJ8,9
+progress-1.5.dist-info/RECORD,,
+progress/__init__.cpython-38.pyc,,
+progress/bar.cpython-38.pyc,,
+progress-1.5.dist-info/__pycache__,,
+progress/__pycache__,,
+progress-1.5.dist-info/INSTALLER,,
+progress/spinner.cpython-38.pyc,,
+progress-1.5.virtualenv,,
+progress/counter.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..81fae4427bf938bf6348bf9741625348c7abb71e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.dist-info/top_level.txt
@@ -0,0 +1 @@
+progress
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress-1.5.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e434c257fefd4eda43f5daf5b8dcf7d4cf9da30b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/__init__.py
@@ -0,0 +1,177 @@
+# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+from __future__ import division, print_function
+
+from collections import deque
+from datetime import timedelta
+from math import ceil
+from sys import stderr
+try:
+    from time import monotonic
+except ImportError:
+    from time import time as monotonic
+
+
+__version__ = '1.5'
+
+HIDE_CURSOR = '\x1b[?25l'
+SHOW_CURSOR = '\x1b[?25h'
+
+
+class Infinite(object):
+    file = stderr
+    sma_window = 10         # Simple Moving Average window
+    check_tty = True
+    hide_cursor = True
+
+    def __init__(self, message='', **kwargs):
+        self.index = 0
+        self.start_ts = monotonic()
+        self.avg = 0
+        self._avg_update_ts = self.start_ts
+        self._ts = self.start_ts
+        self._xput = deque(maxlen=self.sma_window)
+        for key, val in kwargs.items():
+            setattr(self, key, val)
+
+        self._width = 0
+        self.message = message
+
+        if self.file and self.is_tty():
+            if self.hide_cursor:
+                print(HIDE_CURSOR, end='', file=self.file)
+            print(self.message, end='', file=self.file)
+            self.file.flush()
+
+    def __getitem__(self, key):
+        if key.startswith('_'):
+            return None
+        return getattr(self, key, None)
+
+    @property
+    def elapsed(self):
+        return int(monotonic() - self.start_ts)
+
+    @property
+    def elapsed_td(self):
+        return timedelta(seconds=self.elapsed)
+
+    def update_avg(self, n, dt):
+        if n > 0:
+            xput_len = len(self._xput)
+            self._xput.append(dt / n)
+            now = monotonic()
+            # update when we're still filling _xput, then after every second
+            if (xput_len < self.sma_window or
+                    now - self._avg_update_ts > 1):
+                self.avg = sum(self._xput) / len(self._xput)
+                self._avg_update_ts = now
+
+    def update(self):
+        pass
+
+    def start(self):
+        pass
+
+    def clearln(self):
+        if self.file and self.is_tty():
+            print('\r\x1b[K', end='', file=self.file)
+
+    def write(self, s):
+        if self.file and self.is_tty():
+            line = self.message + s.ljust(self._width)
+            print('\r' + line, end='', file=self.file)
+            self._width = max(self._width, len(s))
+            self.file.flush()
+
+    def writeln(self, line):
+        if self.file and self.is_tty():
+            self.clearln()
+            print(line, end='', file=self.file)
+            self.file.flush()
+
+    def finish(self):
+        if self.file and self.is_tty():
+            print(file=self.file)
+            if self.hide_cursor:
+                print(SHOW_CURSOR, end='', file=self.file)
+
+    def is_tty(self):
+        return self.file.isatty() if self.check_tty else True
+
+    def next(self, n=1):
+        now = monotonic()
+        dt = now - self._ts
+        self.update_avg(n, dt)
+        self._ts = now
+        self.index = self.index + n
+        self.update()
+
+    def iter(self, it):
+        with self:
+            for x in it:
+                yield x
+                self.next()
+
+    def __enter__(self):
+        self.start()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.finish()
+
+
+class Progress(Infinite):
+    def __init__(self, *args, **kwargs):
+        super(Progress, self).__init__(*args, **kwargs)
+        self.max = kwargs.get('max', 100)
+
+    @property
+    def eta(self):
+        return int(ceil(self.avg * self.remaining))
+
+    @property
+    def eta_td(self):
+        return timedelta(seconds=self.eta)
+
+    @property
+    def percent(self):
+        return self.progress * 100
+
+    @property
+    def progress(self):
+        return min(1, self.index / self.max)
+
+    @property
+    def remaining(self):
+        return max(self.max - self.index, 0)
+
+    def start(self):
+        self.update()
+
+    def goto(self, index):
+        incr = index - self.index
+        self.next(incr)
+
+    def iter(self, it):
+        try:
+            self.max = len(it)
+        except TypeError:
+            pass
+
+        with self:
+            for x in it:
+                yield x
+                self.next()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/bar.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/bar.py
new file mode 100644
index 0000000000000000000000000000000000000000..8819efda65b9f6bf1315ad15bedc5a3857bf67fc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/bar.py
@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+from __future__ import unicode_literals
+
+import sys
+
+from . import Progress
+
+
+class Bar(Progress):
+    width = 32
+    suffix = '%(index)d/%(max)d'
+    bar_prefix = ' |'
+    bar_suffix = '| '
+    empty_fill = ' '
+    fill = '#'
+
+    def update(self):
+        filled_length = int(self.width * self.progress)
+        empty_length = self.width - filled_length
+
+        message = self.message % self
+        bar = self.fill * filled_length
+        empty = self.empty_fill * empty_length
+        suffix = self.suffix % self
+        line = ''.join([message, self.bar_prefix, bar, empty, self.bar_suffix,
+                        suffix])
+        self.writeln(line)
+
+
+class ChargingBar(Bar):
+    suffix = '%(percent)d%%'
+    bar_prefix = ' '
+    bar_suffix = ' '
+    empty_fill = '∙'
+    fill = '█'
+
+
+class FillingSquaresBar(ChargingBar):
+    empty_fill = '▢'
+    fill = '▣'
+
+
+class FillingCirclesBar(ChargingBar):
+    empty_fill = '◯'
+    fill = '◉'
+
+
+class IncrementalBar(Bar):
+    if sys.platform.startswith('win'):
+        phases = (u' ', u'▌', u'█')
+    else:
+        phases = (' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█')
+
+    def update(self):
+        nphases = len(self.phases)
+        filled_len = self.width * self.progress
+        nfull = int(filled_len)                      # Number of full chars
+        phase = int((filled_len - nfull) * nphases)  # Phase of last char
+        nempty = self.width - nfull                  # Number of empty chars
+
+        message = self.message % self
+        bar = self.phases[-1] * nfull
+        current = self.phases[phase] if phase > 0 else ''
+        empty = self.empty_fill * max(0, nempty - len(current))
+        suffix = self.suffix % self
+        line = ''.join([message, self.bar_prefix, bar, current, empty,
+                        self.bar_suffix, suffix])
+        self.writeln(line)
+
+
+class PixelBar(IncrementalBar):
+    phases = ('⡀', '⡄', '⡆', '⡇', '⣇', '⣧', '⣷', '⣿')
+
+
+class ShadyBar(IncrementalBar):
+    phases = (' ', '░', '▒', '▓', '█')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/counter.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/counter.py
new file mode 100644
index 0000000000000000000000000000000000000000..d955ca4771bb2cd78a8e9334a6917f9f6cce59b1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/counter.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+from __future__ import unicode_literals
+from . import Infinite, Progress
+
+
+class Counter(Infinite):
+    def update(self):
+        self.write(str(self.index))
+
+
+class Countdown(Progress):
+    def update(self):
+        self.write(str(self.remaining))
+
+
+class Stack(Progress):
+    phases = (' ', '▁', '▂', '▃', '▄', '▅', '▆', '▇', '█')
+
+    def update(self):
+        nphases = len(self.phases)
+        i = min(nphases - 1, int(self.progress * nphases))
+        self.write(self.phases[i])
+
+
+class Pie(Stack):
+    phases = ('○', '◔', '◑', '◕', '●')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/spinner.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/spinner.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e100cabb9b8d7113111d1b09a7b84da2895e2a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/progress/spinner.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+from __future__ import unicode_literals
+from . import Infinite
+
+
+class Spinner(Infinite):
+    phases = ('-', '\\', '|', '/')
+    hide_cursor = True
+
+    def update(self):
+        i = self.index % len(self.phases)
+        self.write(self.phases[i])
+
+
+class PieSpinner(Spinner):
+    phases = ['◷', '◶', '◵', '◴']
+
+
+class MoonSpinner(Spinner):
+    phases = ['◑', '◒', '◐', '◓']
+
+
+class LineSpinner(Spinner):
+    phases = ['⎺', '⎻', '⎼', '⎽', '⎼', '⎻']
+
+
+class PixelSpinner(Spinner):
+    phases = ['⣾', '⣷', '⣯', '⣟', '⡿', '⢿', '⣻', '⣽']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4-py3.8-nspkg.pth b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4-py3.8-nspkg.pth
new file mode 100644
index 0000000000000000000000000000000000000000..baef7a0f418633ed421ab4c995e4a4a233d9c368
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4-py3.8-nspkg.pth
@@ -0,0 +1 @@
+import sys, types, os;has_mfs = sys.version_info > (3, 5);p = os.path.join(sys._getframe(1).f_locals['sitedir'], *('google',));importlib = has_mfs and __import__('importlib.util');has_mfs and __import__('importlib.machinery');m = has_mfs and sys.modules.setdefault('google', importlib.util.module_from_spec(importlib.machinery.PathFinder.find_spec('google', [os.path.dirname(p)])));m = m or sys.modules.setdefault('google', types.ModuleType('google'));mp = (m or []) and m.__dict__.setdefault('__path__',[]);(p not in mp) and mp.append(p)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..2c03255fa749b976ea466c6f4c7c0e889debab92
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/METADATA
@@ -0,0 +1,26 @@
+Metadata-Version: 2.1
+Name: protobuf
+Version: 3.15.4
+Summary: Protocol Buffers
+Home-page: https://developers.google.com/protocol-buffers/
+Maintainer: protobuf@googlegroups.com
+Maintainer-email: protobuf@googlegroups.com
+License: 3-Clause BSD License
+Download-URL: https://github.com/protocolbuffers/protobuf/releases
+Platform: UNKNOWN
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Requires-Dist: six (>=1.9)
+
+Protocol Buffers are Google's data interchange format
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..29d665c0495339b5e4f03631bf459189bfba2461
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/RECORD
@@ -0,0 +1,97 @@
+google/protobuf/__init__.py,sha256=tbdkxiFyqQlQYxigoaNvO9nsn1heXzTjprLorJ6mGBc,1705
+google/protobuf/__pycache__/__init__.cpython-38.pyc,,
+google/protobuf/__pycache__/any_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/api_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/descriptor.cpython-38.pyc,,
+google/protobuf/__pycache__/descriptor_database.cpython-38.pyc,,
+google/protobuf/__pycache__/descriptor_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/descriptor_pool.cpython-38.pyc,,
+google/protobuf/__pycache__/duration_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/empty_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/field_mask_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/json_format.cpython-38.pyc,,
+google/protobuf/__pycache__/message.cpython-38.pyc,,
+google/protobuf/__pycache__/message_factory.cpython-38.pyc,,
+google/protobuf/__pycache__/proto_builder.cpython-38.pyc,,
+google/protobuf/__pycache__/reflection.cpython-38.pyc,,
+google/protobuf/__pycache__/service.cpython-38.pyc,,
+google/protobuf/__pycache__/service_reflection.cpython-38.pyc,,
+google/protobuf/__pycache__/source_context_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/struct_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/symbol_database.cpython-38.pyc,,
+google/protobuf/__pycache__/text_encoding.cpython-38.pyc,,
+google/protobuf/__pycache__/text_format.cpython-38.pyc,,
+google/protobuf/__pycache__/timestamp_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/type_pb2.cpython-38.pyc,,
+google/protobuf/__pycache__/wrappers_pb2.cpython-38.pyc,,
+google/protobuf/any_pb2.py,sha256=LTtDfSgRAsXnThPXcTGyTOESmQROJ7WJThu8GciKfJY,2779
+google/protobuf/api_pb2.py,sha256=Z-sZ0G_tZx6cF_i8JQuY8KTRv4RUGzl2lEIBt2G5Fbs,11875
+google/protobuf/compiler/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+google/protobuf/compiler/__pycache__/__init__.cpython-38.pyc,,
+google/protobuf/compiler/__pycache__/plugin_pb2.cpython-38.pyc,,
+google/protobuf/compiler/plugin_pb2.py,sha256=80pi3kuwNp1xKpflR9xrPmYR1-DnMoJ-oIRLYGDY-zA,13798
+google/protobuf/descriptor.py,sha256=2kF4fx7iQUhH-Rg24vA6S1eqCw4eG6wik8WHliwWwC8,44527
+google/protobuf/descriptor_database.py,sha256=2hBUBbzWjTdyq0nLZ9HYKbqhMpouzZVk9srurERnLVo,6819
+google/protobuf/descriptor_pb2.py,sha256=Jhi1CtqRWaAN5bjUHBRsu0Hre7eaeBDLtPnhJ2oeVIw,101546
+google/protobuf/descriptor_pool.py,sha256=PJI4il1EgcxZ_kbzHc4KFcqqpntxwcnqxCaH9IPr2EM,46541
+google/protobuf/duration_pb2.py,sha256=u4UHkAPwyNQR05pQWZUSqLgLs_OeT1DfffKvPe45z_o,2886
+google/protobuf/empty_pb2.py,sha256=1DQ-4UnoSF4V47tPjA0ZVNaWU3nkQn-vNasSjv8Rm90,1934
+google/protobuf/field_mask_pb2.py,sha256=vNP3bloup3Hj-f5u0wDUTCY0xuTR-xlYIeAxx1x3csM,2460
+google/protobuf/internal/__init__.py,sha256=7FN-OGGv5BJuE6uRdYD4k2NyLPkR_J66Bxpn4idh9vs,1631
+google/protobuf/internal/__pycache__/__init__.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/api_implementation.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/containers.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/decoder.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/encoder.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/enum_type_wrapper.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/extension_dict.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/message_listener.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/python_message.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/type_checkers.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/well_known_types.cpython-38.pyc,,
+google/protobuf/internal/__pycache__/wire_format.cpython-38.pyc,,
+google/protobuf/internal/_api_implementation.cpython-38-x86_64-linux-gnu.so,sha256=ZVZ-zAKr-zEzoo9ICWeshNyERCjUH9o5eeQSgncSmtk,5504
+google/protobuf/internal/api_implementation.py,sha256=RTpoUA8mAgna-qYF0SeS4IcK4udnzl07CXO8jEEWaoc,6723
+google/protobuf/internal/containers.py,sha256=Gb8Y4pJi4zzHLsLJHViXIY5x-cMoMVstc7ylEJqQJYQ,25430
+google/protobuf/internal/decoder.py,sha256=acOZsYzSNHSBrK0kRql3Ap624z0TDyeO5TgD3Q__2Xg,38658
+google/protobuf/internal/encoder.py,sha256=-jrRL5tGaWHehfnvLZjaaUCiMCsQDTLs0OFvwreFG30,28659
+google/protobuf/internal/enum_type_wrapper.py,sha256=bgoNiGIIEvlOag5FdB02FCBQlfWJLHmI_zj_okTB2TY,4495
+google/protobuf/internal/extension_dict.py,sha256=3DbWhlrpGybuur1bjfGKhx2d8IVo7tVQUEcF8tPLTyo,8443
+google/protobuf/internal/message_listener.py,sha256=Qwc5gkifAvWzhm3b0v-nXJkozNTgL-L92XAslngFaow,3367
+google/protobuf/internal/python_message.py,sha256=LIgdL-JVQvWgv08fajyoKz9EvWA2f6QR_pbC_f4Wb4I,58404
+google/protobuf/internal/type_checkers.py,sha256=i-OGJQGXBZUlqMun5aKHATeNB_ZbRYR-4mnyHOYbbyg,16602
+google/protobuf/internal/well_known_types.py,sha256=tygq38pMP6aF5ggrl3OBOTwffp1OHXVE82G9CDq2hsc,29241
+google/protobuf/internal/wire_format.py,sha256=7Wz8gV7QOvoTzLMWrwlWSg7hIJ_T8Pm1w8_WLhpieVw,8444
+google/protobuf/json_format.py,sha256=5oQ_F_UE1Br6lgDwnEK7X1OwQdgrJjMSkCV1H30009c,32942
+google/protobuf/message.py,sha256=sxeDQl1HFtOzsk0oQvMadPw9C3DjJ6FXTzQHAMrsvsU,14291
+google/protobuf/message_factory.py,sha256=UpWKeIkRQNv3h9jlymU5XEOsfICqjX2_quopnOXhOEE,7576
+google/protobuf/proto_builder.py,sha256=JBGzUkVd7eDz8cdzUbpIvy2-JbFPfsGcaIAJJII3gfI,5202
+google/protobuf/pyext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+google/protobuf/pyext/__pycache__/__init__.cpython-38.pyc,,
+google/protobuf/pyext/__pycache__/cpp_message.cpython-38.pyc,,
+google/protobuf/pyext/_message.cpython-38-x86_64-linux-gnu.so,sha256=tbdZO9D7HgW7nkV_LoE_0a6L8GgCTbsgdWakCqIfF1Y,2474096
+google/protobuf/pyext/cpp_message.py,sha256=D0-bxtjf1Ri8b0GubL5xgkkEB_z_mIf847yrRvVqDBU,2851
+google/protobuf/reflection.py,sha256=f61wP6k-HMShRwLsfRomScGzG0ZpWULpyhYwvjuZMKQ,3779
+google/protobuf/service.py,sha256=MGWgoxTrSlmqWsgXvp1XaP5Sg-_pq8Sw2XJuY1m6MVM,9146
+google/protobuf/service_reflection.py,sha256=GrQxVlbPi0MFq9RnOFE3fcqZHiXosMEUlydpcOvc2hg,11072
+google/protobuf/source_context_pb2.py,sha256=eMlazBoPnjMrdxmrR1BYotJe5ZKXiPEkGYhDB2e22tc,2540
+google/protobuf/struct_pb2.py,sha256=oLDxsr7Y-F_5uQkV77ZqHTvCpIYelWSIEIE2h1_6ATU,11609
+google/protobuf/symbol_database.py,sha256=aCPGE4N2slb6HFB4cHFJDA8zehgMy16XY8BMH_ebfhc,6944
+google/protobuf/text_encoding.py,sha256=WBifUXeaz2b8C5Hpr-Kka_mfHvQSb3_Rf_Tg6SOrN3k,4855
+google/protobuf/text_format.py,sha256=nx9GGRq7Yz5Cdzx1jJQsMnmNkZ6NrO7zPSTNrF0ABE0,61220
+google/protobuf/timestamp_pb2.py,sha256=F03TleW2W4YaveszZfQvvfE-By6UEfpPizzvy-tRU_s,2906
+google/protobuf/type_pb2.py,sha256=4vPfRIq-Ql4NP1Ueoe2XcZeNGUajR2KnS22EM_UEAgQ,25240
+google/protobuf/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+google/protobuf/util/__pycache__/__init__.cpython-38.pyc,,
+google/protobuf/util/__pycache__/json_format_pb2.cpython-38.pyc,,
+google/protobuf/util/__pycache__/json_format_proto3_pb2.cpython-38.pyc,,
+google/protobuf/util/json_format_pb2.py,sha256=hfgj2fj5-sP6rAwkG_vzXP4QVhUMDfHmpcwRWdYGhl8,40339
+google/protobuf/util/json_format_proto3_pb2.py,sha256=KMQX5XNU-yGdDEIHdn4Z_IjhCyFiO1S6FAT3EXyFtXM,92752
+google/protobuf/wrappers_pb2.py,sha256=4AWtwFmMLzXpHVB8Pfybqs_yZPDqIG3ZjmiS18IL_Zo,12494
+protobuf-3.15.4-py3.8-nspkg.pth,sha256=xH5gTxc4UipYP3qrbP-4CCHNGBV97eBR4QqhheCvBl4,539
+protobuf-3.15.4.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+protobuf-3.15.4.dist-info/METADATA,sha256=BYXQKnnRfMu3o1QdcBRw6trQti0ZkiylV69f3yL39Wk,958
+protobuf-3.15.4.dist-info/RECORD,,
+protobuf-3.15.4.dist-info/WHEEL,sha256=Dh4w5P6PPWbqyqoE6MHlzbFQwZXlM-voWJDf2WUsS2g,108
+protobuf-3.15.4.dist-info/namespace_packages.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
+protobuf-3.15.4.dist-info/top_level.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..69d594f055a5127401ebe017f8837cef4c76c020
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-manylinux1_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/namespace_packages.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/namespace_packages.txt
new file mode 100644
index 0000000000000000000000000000000000000000..cb429113e0f9a73019fd799e8052093fea7f0c8b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/namespace_packages.txt
@@ -0,0 +1 @@
+google
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..cb429113e0f9a73019fd799e8052093fea7f0c8b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/protobuf-3.15.4.dist-info/top_level.txt
@@ -0,0 +1 @@
+google
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pvectorc.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pvectorc.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..34abb11277fd65b90803913558ae90e638d33f66
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pvectorc.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..266c91b252f12734d363cbaea3b0ac86dad5f782
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/METADATA
@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: pyRFC3339
+Version: 1.1
+Summary: Generate and parse RFC 3339 timestamps
+Home-page: https://github.com/kurtraschke/pyRFC3339
+Author: Kurt Raschke
+Author-email: kurt@kurtraschke.com
+License: MIT
+Keywords: rfc 3339 timestamp
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Topic :: Internet
+Requires-Dist: pytz
+
+Description
+===========
+
+.. image:: https://travis-ci.org/kurtraschke/pyRFC3339.svg?branch=master
+    :target: https://travis-ci.org/kurtraschke/pyRFC3339
+
+pyRFC3339 parses and generates :RFC:`3339`-compliant timestamps using `Python <https://www.python.org/>`_ `datetime.datetime <https://docs.python.org/2/library/datetime.html#datetime-objects>`_ objects.
+
+>>> from pyrfc3339 import generate, parse
+>>> from datetime import datetime
+>>> import pytz
+>>> generate(datetime.utcnow().replace(tzinfo=pytz.utc)) #doctest:+ELLIPSIS
+'...T...Z'
+>>> parse('2009-01-01T10:01:02Z')
+datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=<UTC>)
+>>> parse('2009-01-01T14:01:02-04:00')
+datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=<UTC-04:00>)
+
+Installation
+============
+
+To install the latest version from `PyPI <https://pypi.python.org/pypi>`_:
+
+``$ pip install pyRFC3339``
+
+To install the latest development version:
+
+``$ pip install https://github.com/kurtraschke/pyRFC3339/tarball/master#egg=pyRFC3339-dev``
+
+To build the documentation with Sphinx:
+
+#. ``$ pip install Sphinx``
+#. ``$ python setup.py build_sphinx``
+
+The documentation is also available online at:
+
+``https://pythonhosted.org/pyRFC3339/``
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..833c5719f5474cc3beba0e79fbea9134fd3e1521
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/RECORD
@@ -0,0 +1,13 @@
+pyRFC3339-1.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pyRFC3339-1.1.dist-info/METADATA,sha256=jliImO0A5b1TZHRvvO4CqqpAOM0jL9Nk_Pi4s_e2Kgg,2002
+pyRFC3339-1.1.dist-info/RECORD,,
+pyRFC3339-1.1.dist-info/WHEEL,sha256=gduuPyBvFJQSQ0zdyxF7k0zynDXbIbvg5ZBHoXum5uk,110
+pyRFC3339-1.1.dist-info/top_level.txt,sha256=2oJKzRP6wgrj8j7WsDqOVRAduxrIXvT1_DaW3LGR78E,10
+pyrfc3339/__init__.py,sha256=4w-EQcJ92HPPTE0Fs7XKk1WADdYqvylltB3jz2YI8m4,599
+pyrfc3339/__pycache__/__init__.cpython-38.pyc,,
+pyrfc3339/__pycache__/generator.cpython-38.pyc,,
+pyrfc3339/__pycache__/parser.cpython-38.pyc,,
+pyrfc3339/__pycache__/utils.cpython-38.pyc,,
+pyrfc3339/generator.py,sha256=SjaZfwMGU2wVtja8F3RLlKs61Nx4aedfAa65MoL3h04,2170
+pyrfc3339/parser.py,sha256=xhB9S2tfM8FOkSeZyWCuJU4XKMH6wmcXE5dDPuW7yo0,3267
+pyrfc3339/utils.py,sha256=DntNyZHqOqMwkDAbCs60GAWbVvaRAFCWToUHa1DrQXU,3409
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..1316c41d0706f2dbe6e8d73a809c31d67f02954a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.31.1)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..83b0618e09508407a61ae677cadfe51122a89434
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyRFC3339-1.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+pyrfc3339
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..79b7547b671808a3d06d117010d6c3cf67ddc29f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/LICENSE
@@ -0,0 +1,27 @@
+pycparser -- A C parser in Python
+
+Copyright (c) 2008-2017, Eli Bendersky
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this 
+  list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice, 
+  this list of conditions and the following disclaimer in the documentation 
+  and/or other materials provided with the distribution.
+* Neither the name of Eli Bendersky nor the names of its contributors may 
+  be used to endorse or promote products derived from this software without 
+  specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a3939e065e442cc5422a401cf094abc7b71bb512
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/METADATA
@@ -0,0 +1,27 @@
+Metadata-Version: 2.1
+Name: pycparser
+Version: 2.20
+Summary: C parser in Python
+Home-page: https://github.com/eliben/pycparser
+Author: Eli Bendersky
+Author-email: eliben@gmail.com
+Maintainer: Eli Bendersky
+License: BSD
+Platform: Cross Platform
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+
+
+pycparser is a complete parser of the C language, written in
+pure Python using the PLY parsing library.
+It parses C code into an AST and can serve as a front-end for
+C compilers or analysis tools.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f47a55154a2bce2517f5256014c7fe1d2959fd2f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/RECORD
@@ -0,0 +1,41 @@
+pycparser-2.20.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pycparser-2.20.dist-info/LICENSE,sha256=PHZimICuwvhXjtkUcBpP-eXai2CsuLfsZ1q_g8kMUWg,1536
+pycparser-2.20.dist-info/METADATA,sha256=5_RDLTEfmg8dh29oc053jTNp_OL82PllsggkGQTU_Ds,907
+pycparser-2.20.dist-info/RECORD,,
+pycparser-2.20.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pycparser-2.20.dist-info/top_level.txt,sha256=c-lPcS74L_8KoH7IE6PQF5ofyirRQNV4VhkbSFIPeWM,10
+pycparser/__init__.py,sha256=O2ajDXgU2_NI52hUFV8WeAjCR5L-sclmaXerpcxqgPo,2815
+pycparser/__pycache__/__init__.cpython-38.pyc,,
+pycparser/__pycache__/_ast_gen.cpython-38.pyc,,
+pycparser/__pycache__/_build_tables.cpython-38.pyc,,
+pycparser/__pycache__/ast_transforms.cpython-38.pyc,,
+pycparser/__pycache__/c_ast.cpython-38.pyc,,
+pycparser/__pycache__/c_generator.cpython-38.pyc,,
+pycparser/__pycache__/c_lexer.cpython-38.pyc,,
+pycparser/__pycache__/c_parser.cpython-38.pyc,,
+pycparser/__pycache__/lextab.cpython-38.pyc,,
+pycparser/__pycache__/plyparser.cpython-38.pyc,,
+pycparser/__pycache__/yacctab.cpython-38.pyc,,
+pycparser/_ast_gen.py,sha256=_LbRr_kKa2EHeb7y0gV525JV29nzCUbTH4oZ-9I4qIs,10607
+pycparser/_build_tables.py,sha256=oZCd3Plhq-vkV-QuEsaahcf-jUI6-HgKsrAL9gvFzuU,1039
+pycparser/_c_ast.cfg,sha256=1W8-DHa5RqZvyhha_0b4VvKL0CEYv9W0xFs_YwiyEHY,4206
+pycparser/ast_transforms.py,sha256=93ENKENTlugzFehnrQ0fdprijVdNt_ACCPygMxH4v7Q,3648
+pycparser/c_ast.py,sha256=JdDyC3QUZBfX9wVu2ENOrQQPbc737Jmf8Vtozhukayo,30233
+pycparser/c_generator.py,sha256=AwzNyE_rOFK2gzK0J5pCWDqfk7V8KL54ITFRf9m4GlY,15365
+pycparser/c_lexer.py,sha256=GWPUkwFe6F00gTAKIPAx4xs8-J-at_oGwEHnrKF4teM,16208
+pycparser/c_parser.py,sha256=w74N4tFGQ3TETIqUwClZIcbl-V4hFeJSPG2halVgUVs,69746
+pycparser/lextab.py,sha256=FyjRIsaq2wViDqJNYScURuc7GDW5F12VuYxOJLh1j4g,7011
+pycparser/ply/__init__.py,sha256=q4s86QwRsYRa20L9ueSxfh-hPihpftBjDOvYa2_SS2Y,102
+pycparser/ply/__pycache__/__init__.cpython-38.pyc,,
+pycparser/ply/__pycache__/cpp.cpython-38.pyc,,
+pycparser/ply/__pycache__/ctokens.cpython-38.pyc,,
+pycparser/ply/__pycache__/lex.cpython-38.pyc,,
+pycparser/ply/__pycache__/yacc.cpython-38.pyc,,
+pycparser/ply/__pycache__/ygen.cpython-38.pyc,,
+pycparser/ply/cpp.py,sha256=UtC3ylTWp5_1MKA-PLCuwKQR8zSOnlGuGGIdzj8xS98,33282
+pycparser/ply/ctokens.py,sha256=MKksnN40TehPhgVfxCJhjj_BjL943apreABKYz-bl0Y,3177
+pycparser/ply/lex.py,sha256=7Qol57x702HZwjA3ZLp-84CUEWq1EehW-N67Wzghi-M,42918
+pycparser/ply/yacc.py,sha256=eatSDkRLgRr6X3-hoDk_SQQv065R0BdL2K7fQ54CgVM,137323
+pycparser/ply/ygen.py,sha256=2JYNeYtrPz1JzLSLO3d4GsS8zJU8jY_I_CR1VI9gWrA,2251
+pycparser/plyparser.py,sha256=saGNjpsgncQz-hHEh45f28BLqopTxHffaJg_9BCZhi8,4873
+pycparser/yacctab.py,sha256=KOewsHNgbSYaYrLvDJr7K3jXj-7qou0ngyNEnhDmyB4,169715
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..dc1c9e101ad9ccd943b359338ef42c342ebc84a1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser-2.20.dist-info/top_level.txt
@@ -0,0 +1 @@
+pycparser
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e86e9f6a120a6f8f72aeae03d874a27a1f058ee
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/__init__.py
@@ -0,0 +1,90 @@
+#-----------------------------------------------------------------
+# pycparser: __init__.py
+#
+# This package file exports some convenience functions for
+# interacting with pycparser
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+__all__ = ['c_lexer', 'c_parser', 'c_ast']
+__version__ = '2.20'
+
+import io
+from subprocess import check_output
+from .c_parser import CParser
+
+
+def preprocess_file(filename, cpp_path='cpp', cpp_args=''):
+    """ Preprocess a file using cpp.
+
+        filename:
+            Name of the file you want to preprocess.
+
+        cpp_path:
+        cpp_args:
+            Refer to the documentation of parse_file for the meaning of these
+            arguments.
+
+        When successful, returns the preprocessed file's contents.
+        Errors from cpp will be printed out.
+    """
+    path_list = [cpp_path]
+    if isinstance(cpp_args, list):
+        path_list += cpp_args
+    elif cpp_args != '':
+        path_list += [cpp_args]
+    path_list += [filename]
+
+    try:
+        # Note the use of universal_newlines to treat all newlines
+        # as \n for Python's purpose
+        text = check_output(path_list, universal_newlines=True)
+    except OSError as e:
+        raise RuntimeError("Unable to invoke 'cpp'.  " +
+            'Make sure its path was passed correctly\n' +
+            ('Original error: %s' % e))
+
+    return text
+
+
+def parse_file(filename, use_cpp=False, cpp_path='cpp', cpp_args='',
+               parser=None):
+    """ Parse a C file using pycparser.
+
+        filename:
+            Name of the file you want to parse.
+
+        use_cpp:
+            Set to True if you want to execute the C pre-processor
+            on the file prior to parsing it.
+
+        cpp_path:
+            If use_cpp is True, this is the path to 'cpp' on your
+            system. If no path is provided, it attempts to just
+            execute 'cpp', so it must be in your PATH.
+
+        cpp_args:
+            If use_cpp is True, set this to the command line arguments strings
+            to cpp. Be careful with quotes - it's best to pass a raw string
+            (r'') here. For example:
+            r'-I../utils/fake_libc_include'
+            If several arguments are required, pass a list of strings.
+
+        parser:
+            Optional parser object to be used instead of the default CParser
+
+        When successful, an AST is returned. ParseError can be
+        thrown if the file doesn't parse successfully.
+
+        Errors from cpp will be printed out.
+    """
+    if use_cpp:
+        text = preprocess_file(filename, cpp_path, cpp_args)
+    else:
+        with io.open(filename) as f:
+            text = f.read()
+
+    if parser is None:
+        parser = CParser()
+    return parser.parse(text, filename)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_ast_gen.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_ast_gen.py
new file mode 100644
index 0000000000000000000000000000000000000000..5ec2d3df177f87e4bcf33e02f49305bd49d1fa3b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_ast_gen.py
@@ -0,0 +1,338 @@
+#-----------------------------------------------------------------
+# _ast_gen.py
+#
+# Generates the AST Node classes from a specification given in
+# a configuration file
+#
+# The design of this module was inspired by astgen.py from the
+# Python 2.5 code-base.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+import pprint
+from string import Template
+
+
+class ASTCodeGenerator(object):
+    def __init__(self, cfg_filename='_c_ast.cfg'):
+        """ Initialize the code generator from a configuration
+            file.
+        """
+        self.cfg_filename = cfg_filename
+        self.node_cfg = [NodeCfg(name, contents)
+            for (name, contents) in self.parse_cfgfile(cfg_filename)]
+
+    def generate(self, file=None):
+        """ Generates the code into file, an open file buffer.
+        """
+        src = Template(_PROLOGUE_COMMENT).substitute(
+            cfg_filename=self.cfg_filename)
+
+        src += _PROLOGUE_CODE
+        for node_cfg in self.node_cfg:
+            src += node_cfg.generate_source() + '\n\n'
+
+        file.write(src)
+
+    def parse_cfgfile(self, filename):
+        """ Parse the configuration file and yield pairs of
+            (name, contents) for each node.
+        """
+        with open(filename, "r") as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith('#'):
+                    continue
+                colon_i = line.find(':')
+                lbracket_i = line.find('[')
+                rbracket_i = line.find(']')
+                if colon_i < 1 or lbracket_i <= colon_i or rbracket_i <= lbracket_i:
+                    raise RuntimeError("Invalid line in %s:\n%s\n" % (filename, line))
+
+                name = line[:colon_i]
+                val = line[lbracket_i + 1:rbracket_i]
+                vallist = [v.strip() for v in val.split(',')] if val else []
+                yield name, vallist
+
+
+class NodeCfg(object):
+    """ Node configuration.
+
+        name: node name
+        contents: a list of contents - attributes and child nodes
+        See comment at the top of the configuration file for details.
+    """
+
+    def __init__(self, name, contents):
+        self.name = name
+        self.all_entries = []
+        self.attr = []
+        self.child = []
+        self.seq_child = []
+
+        for entry in contents:
+            clean_entry = entry.rstrip('*')
+            self.all_entries.append(clean_entry)
+
+            if entry.endswith('**'):
+                self.seq_child.append(clean_entry)
+            elif entry.endswith('*'):
+                self.child.append(clean_entry)
+            else:
+                self.attr.append(entry)
+
+    def generate_source(self):
+        src = self._gen_init()
+        src += '\n' + self._gen_children()
+        src += '\n' + self._gen_iter()
+
+        src += '\n' + self._gen_attr_names()
+        return src
+
+    def _gen_init(self):
+        src = "class %s(Node):\n" % self.name
+
+        if self.all_entries:
+            args = ', '.join(self.all_entries)
+            slots = ', '.join("'{0}'".format(e) for e in self.all_entries)
+            slots += ", 'coord', '__weakref__'"
+            arglist = '(self, %s, coord=None)' % args
+        else:
+            slots = "'coord', '__weakref__'"
+            arglist = '(self, coord=None)'
+
+        src += "    __slots__ = (%s)\n" % slots
+        src += "    def __init__%s:\n" % arglist
+
+        for name in self.all_entries + ['coord']:
+            src += "        self.%s = %s\n" % (name, name)
+
+        return src
+
+    def _gen_children(self):
+        src = '    def children(self):\n'
+
+        if self.all_entries:
+            src += '        nodelist = []\n'
+
+            for child in self.child:
+                src += (
+                    '        if self.%(child)s is not None:' +
+                    ' nodelist.append(("%(child)s", self.%(child)s))\n') % (
+                        dict(child=child))
+
+            for seq_child in self.seq_child:
+                src += (
+                    '        for i, child in enumerate(self.%(child)s or []):\n'
+                    '            nodelist.append(("%(child)s[%%d]" %% i, child))\n') % (
+                        dict(child=seq_child))
+
+            src += '        return tuple(nodelist)\n'
+        else:
+            src += '        return ()\n'
+
+        return src
+
+    def _gen_iter(self):
+        src = '    def __iter__(self):\n'
+
+        if self.all_entries:
+            for child in self.child:
+                src += (
+                    '        if self.%(child)s is not None:\n' +
+                    '            yield self.%(child)s\n') % (dict(child=child))
+
+            for seq_child in self.seq_child:
+                src += (
+                    '        for child in (self.%(child)s or []):\n'
+                    '            yield child\n') % (dict(child=seq_child))
+
+            if not (self.child or self.seq_child):
+                # Empty generator
+                src += (
+                    '        return\n' +
+                    '        yield\n')
+        else:
+            # Empty generator
+            src += (
+                '        return\n' +
+                '        yield\n')
+
+        return src
+
+    def _gen_attr_names(self):
+        src = "    attr_names = (" + ''.join("%r, " % nm for nm in self.attr) + ')'
+        return src
+
+
+_PROLOGUE_COMMENT = \
+r'''#-----------------------------------------------------------------
+# ** ATTENTION **
+# This code was automatically generated from the file:
+# $cfg_filename
+#
+# Do not modify it directly. Modify the configuration file and
+# run the generator again.
+# ** ** *** ** **
+#
+# pycparser: c_ast.py
+#
+# AST Node classes.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+
+'''
+
+_PROLOGUE_CODE = r'''
+import sys
+
+def _repr(obj):
+    """
+    Get the representation of an object, with dedicated pprint-like format for lists.
+    """
+    if isinstance(obj, list):
+        return '[' + (',\n '.join((_repr(e).replace('\n', '\n ') for e in obj))) + '\n]'
+    else:
+        return repr(obj) 
+
+class Node(object):
+    __slots__ = ()
+    """ Abstract base class for AST nodes.
+    """
+    def __repr__(self):
+        """ Generates a python representation of the current node
+        """
+        result = self.__class__.__name__ + '('
+        
+        indent = ''
+        separator = ''
+        for name in self.__slots__[:-2]:
+            result += separator
+            result += indent
+            result += name + '=' + (_repr(getattr(self, name)).replace('\n', '\n  ' + (' ' * (len(name) + len(self.__class__.__name__)))))
+            
+            separator = ','
+            indent = '\n ' + (' ' * len(self.__class__.__name__))
+        
+        result += indent + ')'
+        
+        return result
+
+    def children(self):
+        """ A sequence of all children that are Nodes
+        """
+        pass
+
+    def show(self, buf=sys.stdout, offset=0, attrnames=False, nodenames=False, showcoord=False, _my_node_name=None):
+        """ Pretty print the Node and all its attributes and
+            children (recursively) to a buffer.
+
+            buf:
+                Open IO buffer into which the Node is printed.
+
+            offset:
+                Initial offset (amount of leading spaces)
+
+            attrnames:
+                True if you want to see the attribute names in
+                name=value pairs. False to only see the values.
+
+            nodenames:
+                True if you want to see the actual node names
+                within their parents.
+
+            showcoord:
+                Do you want the coordinates of each Node to be
+                displayed.
+        """
+        lead = ' ' * offset
+        if nodenames and _my_node_name is not None:
+            buf.write(lead + self.__class__.__name__+ ' <' + _my_node_name + '>: ')
+        else:
+            buf.write(lead + self.__class__.__name__+ ': ')
+
+        if self.attr_names:
+            if attrnames:
+                nvlist = [(n, getattr(self,n)) for n in self.attr_names]
+                attrstr = ', '.join('%s=%s' % nv for nv in nvlist)
+            else:
+                vlist = [getattr(self, n) for n in self.attr_names]
+                attrstr = ', '.join('%s' % v for v in vlist)
+            buf.write(attrstr)
+
+        if showcoord:
+            buf.write(' (at %s)' % self.coord)
+        buf.write('\n')
+
+        for (child_name, child) in self.children():
+            child.show(
+                buf,
+                offset=offset + 2,
+                attrnames=attrnames,
+                nodenames=nodenames,
+                showcoord=showcoord,
+                _my_node_name=child_name)
+
+
+class NodeVisitor(object):
+    """ A base NodeVisitor class for visiting c_ast nodes.
+        Subclass it and define your own visit_XXX methods, where
+        XXX is the class name you want to visit with these
+        methods.
+
+        For example:
+
+        class ConstantVisitor(NodeVisitor):
+            def __init__(self):
+                self.values = []
+
+            def visit_Constant(self, node):
+                self.values.append(node.value)
+
+        Creates a list of values of all the constant nodes
+        encountered below the given node. To use it:
+
+        cv = ConstantVisitor()
+        cv.visit(node)
+
+        Notes:
+
+        *   generic_visit() will be called for AST nodes for which
+            no visit_XXX method was defined.
+        *   The children of nodes for which a visit_XXX was
+            defined will not be visited - if you need this, call
+            generic_visit() on the node.
+            You can use:
+                NodeVisitor.generic_visit(self, node)
+        *   Modeled after Python's own AST visiting facilities
+            (the ast module of Python 3.0)
+    """
+
+    _method_cache = None
+
+    def visit(self, node):
+        """ Visit a node.
+        """
+
+        if self._method_cache is None:
+            self._method_cache = {}
+
+        visitor = self._method_cache.get(node.__class__.__name__, None)
+        if visitor is None:
+            method = 'visit_' + node.__class__.__name__
+            visitor = getattr(self, method, self.generic_visit)
+            self._method_cache[node.__class__.__name__] = visitor
+
+        return visitor(node)
+
+    def generic_visit(self, node):
+        """ Called if no explicit visitor function exists for a
+            node. Implements preorder visiting of the node.
+        """
+        for c in node:
+            self.visit(c)
+
+'''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_build_tables.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_build_tables.py
new file mode 100644
index 0000000000000000000000000000000000000000..958381ad0f2927aff0253a8516c3bc76d00760d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_build_tables.py
@@ -0,0 +1,37 @@
+#-----------------------------------------------------------------
+# pycparser: _build_tables.py
+#
+# A dummy for generating the lexing/parsing tables and and
+# compiling them into .pyc for faster execution in optimized mode.
+# Also generates AST code from the configuration file.
+# Should be called from the pycparser directory.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+
+# Insert '.' and '..' as first entries to the search path for modules.
+# Restricted environments like embeddable python do not include the
+# current working directory on startup.
+import sys
+sys.path[0:0] = ['.', '..']
+
+# Generate c_ast.py
+from _ast_gen import ASTCodeGenerator
+ast_gen = ASTCodeGenerator('_c_ast.cfg')
+ast_gen.generate(open('c_ast.py', 'w'))
+
+from pycparser import c_parser
+
+# Generates the tables
+#
+c_parser.CParser(
+    lex_optimize=True,
+    yacc_debug=False,
+    yacc_optimize=True)
+
+# Load to compile into .pyc
+#
+import lextab
+import yacctab
+import c_ast
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_c_ast.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_c_ast.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..b93d50bb64028a49ba0f81c0a8bc24961020caf4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/_c_ast.cfg
@@ -0,0 +1,191 @@
+#-----------------------------------------------------------------
+# pycparser: _c_ast.cfg
+#
+# Defines the AST Node classes used in pycparser.
+#
+# Each entry is a Node sub-class name, listing the attributes
+# and child nodes of the class:
+#   <name>*     - a child node
+#   <name>**    - a sequence of child nodes
+#   <name>      - an attribute
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+
+# ArrayDecl is a nested declaration of an array with the given type.
+# dim: the dimension (for example, constant 42)
+# dim_quals: list of dimension qualifiers, to support C99's allowing 'const'
+#            and 'static' within the array dimension in function declarations.
+ArrayDecl: [type*, dim*, dim_quals]
+
+ArrayRef: [name*, subscript*]
+
+# op: =, +=, /= etc.
+#
+Assignment: [op, lvalue*, rvalue*]
+
+BinaryOp: [op, left*, right*]
+
+Break: []
+
+Case: [expr*, stmts**]
+
+Cast: [to_type*, expr*]
+
+# Compound statement in C99 is a list of block items (declarations or
+# statements).
+#
+Compound: [block_items**]
+
+# Compound literal (anonymous aggregate) for C99.
+# (type-name) {initializer_list}
+# type: the typename
+# init: InitList for the initializer list
+#
+CompoundLiteral: [type*, init*]
+
+# type: int, char, float, etc. see CLexer for constant token types
+#
+Constant: [type, value]
+
+Continue: []
+
+# name: the variable being declared
+# quals: list of qualifiers (const, volatile)
+# funcspec: list function specifiers (i.e. inline in C99)
+# storage: list of storage specifiers (extern, register, etc.)
+# type: declaration type (probably nested with all the modifiers)
+# init: initialization value, or None
+# bitsize: bit field size, or None
+#
+Decl: [name, quals, storage, funcspec, type*, init*, bitsize*]
+
+DeclList: [decls**]
+
+Default: [stmts**]
+
+DoWhile: [cond*, stmt*]
+
+# Represents the ellipsis (...) parameter in a function
+# declaration
+#
+EllipsisParam: []
+
+# An empty statement (a semicolon ';' on its own)
+#
+EmptyStatement: []
+
+# Enumeration type specifier
+# name: an optional ID
+# values: an EnumeratorList
+#
+Enum: [name, values*]
+
+# A name/value pair for enumeration values
+#
+Enumerator: [name, value*]
+
+# A list of enumerators
+#
+EnumeratorList: [enumerators**]
+
+# A list of expressions separated by the comma operator.
+#
+ExprList: [exprs**]
+
+# This is the top of the AST, representing a single C file (a
+# translation unit in K&R jargon). It contains a list of
+# "external-declaration"s, which is either declarations (Decl),
+# Typedef or function definitions (FuncDef).
+#
+FileAST: [ext**]
+
+# for (init; cond; next) stmt
+#
+For: [init*, cond*, next*, stmt*]
+
+# name: Id
+# args: ExprList
+#
+FuncCall: [name*, args*]
+
+# type <decl>(args)
+#
+FuncDecl: [args*, type*]
+
+# Function definition: a declarator for the function name and
+# a body, which is a compound statement.
+# There's an optional list of parameter declarations for old
+# K&R-style definitions
+#
+FuncDef: [decl*, param_decls**, body*]
+
+Goto: [name]
+
+ID: [name]
+
+# Holder for types that are a simple identifier (e.g. the built
+# ins void, char etc. and typedef-defined types)
+#
+IdentifierType: [names]
+
+If: [cond*, iftrue*, iffalse*]
+
+# An initialization list used for compound literals.
+#
+InitList: [exprs**]
+
+Label: [name, stmt*]
+
+# A named initializer for C99.
+# The name of a NamedInitializer is a sequence of Nodes, because
+# names can be hierarchical and contain constant expressions.
+#
+NamedInitializer: [name**, expr*]
+
+# a list of comma separated function parameter declarations
+#
+ParamList: [params**]
+
+PtrDecl: [quals, type*]
+
+Return: [expr*]
+
+# name: struct tag name
+# decls: declaration of members
+#
+Struct: [name, decls**]
+
+# type: . or ->
+# name.field or name->field
+#
+StructRef: [name*, type, field*]
+
+Switch: [cond*, stmt*]
+
+# cond ? iftrue : iffalse
+#
+TernaryOp: [cond*, iftrue*, iffalse*]
+
+# A base type declaration
+#
+TypeDecl: [declname, quals, type*]
+
+# A typedef declaration.
+# Very similar to Decl, but without some attributes
+#
+Typedef: [name, quals, storage, type*]
+
+Typename: [name, quals, type*]
+
+UnaryOp: [op, expr*]
+
+# name: union tag name
+# decls: declaration of members
+#
+Union: [name, decls**]
+
+While: [cond*, stmt*]
+
+Pragma: [string]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ast_transforms.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ast_transforms.py
new file mode 100644
index 0000000000000000000000000000000000000000..0aeb88f0e2dab9334cb5251bb30c8cbd2fa3c511
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ast_transforms.py
@@ -0,0 +1,106 @@
+#------------------------------------------------------------------------------
+# pycparser: ast_transforms.py
+#
+# Some utilities used by the parser to create a friendlier AST.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#------------------------------------------------------------------------------
+
+from . import c_ast
+
+
+def fix_switch_cases(switch_node):
+    """ The 'case' statements in a 'switch' come out of parsing with one
+        child node, so subsequent statements are just tucked to the parent
+        Compound. Additionally, consecutive (fall-through) case statements
+        come out messy. This is a peculiarity of the C grammar. The following:
+
+            switch (myvar) {
+                case 10:
+                    k = 10;
+                    p = k + 1;
+                    return 10;
+                case 20:
+                case 30:
+                    return 20;
+                default:
+                    break;
+            }
+
+        Creates this tree (pseudo-dump):
+
+            Switch
+                ID: myvar
+                Compound:
+                    Case 10:
+                        k = 10
+                    p = k + 1
+                    return 10
+                    Case 20:
+                        Case 30:
+                            return 20
+                    Default:
+                        break
+
+        The goal of this transform is to fix this mess, turning it into the
+        following:
+
+            Switch
+                ID: myvar
+                Compound:
+                    Case 10:
+                        k = 10
+                        p = k + 1
+                        return 10
+                    Case 20:
+                    Case 30:
+                        return 20
+                    Default:
+                        break
+
+        A fixed AST node is returned. The argument may be modified.
+    """
+    assert isinstance(switch_node, c_ast.Switch)
+    if not isinstance(switch_node.stmt, c_ast.Compound):
+        return switch_node
+
+    # The new Compound child for the Switch, which will collect children in the
+    # correct order
+    new_compound = c_ast.Compound([], switch_node.stmt.coord)
+
+    # The last Case/Default node
+    last_case = None
+
+    # Goes over the children of the Compound below the Switch, adding them
+    # either directly below new_compound or below the last Case as appropriate
+    # (for `switch(cond) {}`, block_items would have been None)
+    for child in (switch_node.stmt.block_items or []):
+        if isinstance(child, (c_ast.Case, c_ast.Default)):
+            # If it's a Case/Default:
+            # 1. Add it to the Compound and mark as "last case"
+            # 2. If its immediate child is also a Case or Default, promote it
+            #    to a sibling.
+            new_compound.block_items.append(child)
+            _extract_nested_case(child, new_compound.block_items)
+            last_case = new_compound.block_items[-1]
+        else:
+            # Other statements are added as children to the last case, if it
+            # exists.
+            if last_case is None:
+                new_compound.block_items.append(child)
+            else:
+                last_case.stmts.append(child)
+
+    switch_node.stmt = new_compound
+    return switch_node
+
+
+def _extract_nested_case(case_node, stmts_list):
+    """ Recursively extract consecutive Case statements that are made nested
+        by the parser and add them to the stmts_list.
+    """
+    if isinstance(case_node.stmts[0], (c_ast.Case, c_ast.Default)):
+        stmts_list.append(case_node.stmts.pop())
+        _extract_nested_case(stmts_list[-1], stmts_list)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_ast.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_ast.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7bbbeed27c330e8fef5c6b7ab507f57cf080960
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_ast.py
@@ -0,0 +1,1084 @@
+#-----------------------------------------------------------------
+# ** ATTENTION **
+# This code was automatically generated from the file:
+# _c_ast.cfg
+#
+# Do not modify it directly. Modify the configuration file and
+# run the generator again.
+# ** ** *** ** **
+#
+# pycparser: c_ast.py
+#
+# AST Node classes.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+
+
+import sys
+
+def _repr(obj):
+    """
+    Get the representation of an object, with dedicated pprint-like format for lists.
+    """
+    if isinstance(obj, list):
+        return '[' + (',\n '.join((_repr(e).replace('\n', '\n ') for e in obj))) + '\n]'
+    else:
+        return repr(obj) 
+
+class Node(object):
+    __slots__ = ()
+    """ Abstract base class for AST nodes.
+    """
+    def __repr__(self):
+        """ Generates a python representation of the current node
+        """
+        result = self.__class__.__name__ + '('
+        
+        indent = ''
+        separator = ''
+        for name in self.__slots__[:-2]:
+            result += separator
+            result += indent
+            result += name + '=' + (_repr(getattr(self, name)).replace('\n', '\n  ' + (' ' * (len(name) + len(self.__class__.__name__)))))
+            
+            separator = ','
+            indent = '\n ' + (' ' * len(self.__class__.__name__))
+        
+        result += indent + ')'
+        
+        return result
+
+    def children(self):
+        """ A sequence of all children that are Nodes
+        """
+        pass
+
+    def show(self, buf=sys.stdout, offset=0, attrnames=False, nodenames=False, showcoord=False, _my_node_name=None):
+        """ Pretty print the Node and all its attributes and
+            children (recursively) to a buffer.
+
+            buf:
+                Open IO buffer into which the Node is printed.
+
+            offset:
+                Initial offset (amount of leading spaces)
+
+            attrnames:
+                True if you want to see the attribute names in
+                name=value pairs. False to only see the values.
+
+            nodenames:
+                True if you want to see the actual node names
+                within their parents.
+
+            showcoord:
+                Do you want the coordinates of each Node to be
+                displayed.
+        """
+        lead = ' ' * offset
+        if nodenames and _my_node_name is not None:
+            buf.write(lead + self.__class__.__name__+ ' <' + _my_node_name + '>: ')
+        else:
+            buf.write(lead + self.__class__.__name__+ ': ')
+
+        if self.attr_names:
+            if attrnames:
+                nvlist = [(n, getattr(self,n)) for n in self.attr_names]
+                attrstr = ', '.join('%s=%s' % nv for nv in nvlist)
+            else:
+                vlist = [getattr(self, n) for n in self.attr_names]
+                attrstr = ', '.join('%s' % v for v in vlist)
+            buf.write(attrstr)
+
+        if showcoord:
+            buf.write(' (at %s)' % self.coord)
+        buf.write('\n')
+
+        for (child_name, child) in self.children():
+            child.show(
+                buf,
+                offset=offset + 2,
+                attrnames=attrnames,
+                nodenames=nodenames,
+                showcoord=showcoord,
+                _my_node_name=child_name)
+
+
+class NodeVisitor(object):
+    """ A base NodeVisitor class for visiting c_ast nodes.
+        Subclass it and define your own visit_XXX methods, where
+        XXX is the class name you want to visit with these
+        methods.
+
+        For example:
+
+        class ConstantVisitor(NodeVisitor):
+            def __init__(self):
+                self.values = []
+
+            def visit_Constant(self, node):
+                self.values.append(node.value)
+
+        Creates a list of values of all the constant nodes
+        encountered below the given node. To use it:
+
+        cv = ConstantVisitor()
+        cv.visit(node)
+
+        Notes:
+
+        *   generic_visit() will be called for AST nodes for which
+            no visit_XXX method was defined.
+        *   The children of nodes for which a visit_XXX was
+            defined will not be visited - if you need this, call
+            generic_visit() on the node.
+            You can use:
+                NodeVisitor.generic_visit(self, node)
+        *   Modeled after Python's own AST visiting facilities
+            (the ast module of Python 3.0)
+    """
+
+    _method_cache = None
+
+    def visit(self, node):
+        """ Visit a node.
+        """
+
+        if self._method_cache is None:
+            self._method_cache = {}
+
+        visitor = self._method_cache.get(node.__class__.__name__, None)
+        if visitor is None:
+            method = 'visit_' + node.__class__.__name__
+            visitor = getattr(self, method, self.generic_visit)
+            self._method_cache[node.__class__.__name__] = visitor
+
+        return visitor(node)
+
+    def generic_visit(self, node):
+        """ Called if no explicit visitor function exists for a
+            node. Implements preorder visiting of the node.
+        """
+        for c in node:
+            self.visit(c)
+
+class ArrayDecl(Node):
+    __slots__ = ('type', 'dim', 'dim_quals', 'coord', '__weakref__')
+    def __init__(self, type, dim, dim_quals, coord=None):
+        self.type = type
+        self.dim = dim
+        self.dim_quals = dim_quals
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        if self.dim is not None: nodelist.append(("dim", self.dim))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+        if self.dim is not None:
+            yield self.dim
+
+    attr_names = ('dim_quals', )
+
+class ArrayRef(Node):
+    __slots__ = ('name', 'subscript', 'coord', '__weakref__')
+    def __init__(self, name, subscript, coord=None):
+        self.name = name
+        self.subscript = subscript
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.name is not None: nodelist.append(("name", self.name))
+        if self.subscript is not None: nodelist.append(("subscript", self.subscript))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.name is not None:
+            yield self.name
+        if self.subscript is not None:
+            yield self.subscript
+
+    attr_names = ()
+
+class Assignment(Node):
+    __slots__ = ('op', 'lvalue', 'rvalue', 'coord', '__weakref__')
+    def __init__(self, op, lvalue, rvalue, coord=None):
+        self.op = op
+        self.lvalue = lvalue
+        self.rvalue = rvalue
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.lvalue is not None: nodelist.append(("lvalue", self.lvalue))
+        if self.rvalue is not None: nodelist.append(("rvalue", self.rvalue))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.lvalue is not None:
+            yield self.lvalue
+        if self.rvalue is not None:
+            yield self.rvalue
+
+    attr_names = ('op', )
+
+class BinaryOp(Node):
+    __slots__ = ('op', 'left', 'right', 'coord', '__weakref__')
+    def __init__(self, op, left, right, coord=None):
+        self.op = op
+        self.left = left
+        self.right = right
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.left is not None: nodelist.append(("left", self.left))
+        if self.right is not None: nodelist.append(("right", self.right))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.left is not None:
+            yield self.left
+        if self.right is not None:
+            yield self.right
+
+    attr_names = ('op', )
+
+class Break(Node):
+    __slots__ = ('coord', '__weakref__')
+    def __init__(self, coord=None):
+        self.coord = coord
+
+    def children(self):
+        return ()
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ()
+
+class Case(Node):
+    __slots__ = ('expr', 'stmts', 'coord', '__weakref__')
+    def __init__(self, expr, stmts, coord=None):
+        self.expr = expr
+        self.stmts = stmts
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.expr is not None: nodelist.append(("expr", self.expr))
+        for i, child in enumerate(self.stmts or []):
+            nodelist.append(("stmts[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.expr is not None:
+            yield self.expr
+        for child in (self.stmts or []):
+            yield child
+
+    attr_names = ()
+
+class Cast(Node):
+    __slots__ = ('to_type', 'expr', 'coord', '__weakref__')
+    def __init__(self, to_type, expr, coord=None):
+        self.to_type = to_type
+        self.expr = expr
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.to_type is not None: nodelist.append(("to_type", self.to_type))
+        if self.expr is not None: nodelist.append(("expr", self.expr))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.to_type is not None:
+            yield self.to_type
+        if self.expr is not None:
+            yield self.expr
+
+    attr_names = ()
+
+class Compound(Node):
+    __slots__ = ('block_items', 'coord', '__weakref__')
+    def __init__(self, block_items, coord=None):
+        self.block_items = block_items
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.block_items or []):
+            nodelist.append(("block_items[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.block_items or []):
+            yield child
+
+    attr_names = ()
+
+class CompoundLiteral(Node):
+    __slots__ = ('type', 'init', 'coord', '__weakref__')
+    def __init__(self, type, init, coord=None):
+        self.type = type
+        self.init = init
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        if self.init is not None: nodelist.append(("init", self.init))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+        if self.init is not None:
+            yield self.init
+
+    attr_names = ()
+
+class Constant(Node):
+    __slots__ = ('type', 'value', 'coord', '__weakref__')
+    def __init__(self, type, value, coord=None):
+        self.type = type
+        self.value = value
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        return tuple(nodelist)
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ('type', 'value', )
+
+class Continue(Node):
+    __slots__ = ('coord', '__weakref__')
+    def __init__(self, coord=None):
+        self.coord = coord
+
+    def children(self):
+        return ()
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ()
+
+class Decl(Node):
+    __slots__ = ('name', 'quals', 'storage', 'funcspec', 'type', 'init', 'bitsize', 'coord', '__weakref__')
+    def __init__(self, name, quals, storage, funcspec, type, init, bitsize, coord=None):
+        self.name = name
+        self.quals = quals
+        self.storage = storage
+        self.funcspec = funcspec
+        self.type = type
+        self.init = init
+        self.bitsize = bitsize
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        if self.init is not None: nodelist.append(("init", self.init))
+        if self.bitsize is not None: nodelist.append(("bitsize", self.bitsize))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+        if self.init is not None:
+            yield self.init
+        if self.bitsize is not None:
+            yield self.bitsize
+
+    attr_names = ('name', 'quals', 'storage', 'funcspec', )
+
+class DeclList(Node):
+    __slots__ = ('decls', 'coord', '__weakref__')
+    def __init__(self, decls, coord=None):
+        self.decls = decls
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.decls or []):
+            nodelist.append(("decls[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.decls or []):
+            yield child
+
+    attr_names = ()
+
+class Default(Node):
+    __slots__ = ('stmts', 'coord', '__weakref__')
+    def __init__(self, stmts, coord=None):
+        self.stmts = stmts
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.stmts or []):
+            nodelist.append(("stmts[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.stmts or []):
+            yield child
+
+    attr_names = ()
+
+class DoWhile(Node):
+    __slots__ = ('cond', 'stmt', 'coord', '__weakref__')
+    def __init__(self, cond, stmt, coord=None):
+        self.cond = cond
+        self.stmt = stmt
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.stmt is not None: nodelist.append(("stmt", self.stmt))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.cond is not None:
+            yield self.cond
+        if self.stmt is not None:
+            yield self.stmt
+
+    attr_names = ()
+
+class EllipsisParam(Node):
+    __slots__ = ('coord', '__weakref__')
+    def __init__(self, coord=None):
+        self.coord = coord
+
+    def children(self):
+        return ()
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ()
+
+class EmptyStatement(Node):
+    __slots__ = ('coord', '__weakref__')
+    def __init__(self, coord=None):
+        self.coord = coord
+
+    def children(self):
+        return ()
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ()
+
+class Enum(Node):
+    __slots__ = ('name', 'values', 'coord', '__weakref__')
+    def __init__(self, name, values, coord=None):
+        self.name = name
+        self.values = values
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.values is not None: nodelist.append(("values", self.values))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.values is not None:
+            yield self.values
+
+    attr_names = ('name', )
+
+class Enumerator(Node):
+    __slots__ = ('name', 'value', 'coord', '__weakref__')
+    def __init__(self, name, value, coord=None):
+        self.name = name
+        self.value = value
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.value is not None: nodelist.append(("value", self.value))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.value is not None:
+            yield self.value
+
+    attr_names = ('name', )
+
+class EnumeratorList(Node):
+    __slots__ = ('enumerators', 'coord', '__weakref__')
+    def __init__(self, enumerators, coord=None):
+        self.enumerators = enumerators
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.enumerators or []):
+            nodelist.append(("enumerators[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.enumerators or []):
+            yield child
+
+    attr_names = ()
+
+class ExprList(Node):
+    __slots__ = ('exprs', 'coord', '__weakref__')
+    def __init__(self, exprs, coord=None):
+        self.exprs = exprs
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.exprs or []):
+            nodelist.append(("exprs[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.exprs or []):
+            yield child
+
+    attr_names = ()
+
+class FileAST(Node):
+    __slots__ = ('ext', 'coord', '__weakref__')
+    def __init__(self, ext, coord=None):
+        self.ext = ext
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.ext or []):
+            nodelist.append(("ext[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.ext or []):
+            yield child
+
+    attr_names = ()
+
+class For(Node):
+    __slots__ = ('init', 'cond', 'next', 'stmt', 'coord', '__weakref__')
+    def __init__(self, init, cond, next, stmt, coord=None):
+        self.init = init
+        self.cond = cond
+        self.next = next
+        self.stmt = stmt
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.init is not None: nodelist.append(("init", self.init))
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.next is not None: nodelist.append(("next", self.next))
+        if self.stmt is not None: nodelist.append(("stmt", self.stmt))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.init is not None:
+            yield self.init
+        if self.cond is not None:
+            yield self.cond
+        if self.next is not None:
+            yield self.next
+        if self.stmt is not None:
+            yield self.stmt
+
+    attr_names = ()
+
+class FuncCall(Node):
+    __slots__ = ('name', 'args', 'coord', '__weakref__')
+    def __init__(self, name, args, coord=None):
+        self.name = name
+        self.args = args
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.name is not None: nodelist.append(("name", self.name))
+        if self.args is not None: nodelist.append(("args", self.args))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.name is not None:
+            yield self.name
+        if self.args is not None:
+            yield self.args
+
+    attr_names = ()
+
+class FuncDecl(Node):
+    __slots__ = ('args', 'type', 'coord', '__weakref__')
+    def __init__(self, args, type, coord=None):
+        self.args = args
+        self.type = type
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.args is not None: nodelist.append(("args", self.args))
+        if self.type is not None: nodelist.append(("type", self.type))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.args is not None:
+            yield self.args
+        if self.type is not None:
+            yield self.type
+
+    attr_names = ()
+
+class FuncDef(Node):
+    __slots__ = ('decl', 'param_decls', 'body', 'coord', '__weakref__')
+    def __init__(self, decl, param_decls, body, coord=None):
+        self.decl = decl
+        self.param_decls = param_decls
+        self.body = body
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.decl is not None: nodelist.append(("decl", self.decl))
+        if self.body is not None: nodelist.append(("body", self.body))
+        for i, child in enumerate(self.param_decls or []):
+            nodelist.append(("param_decls[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.decl is not None:
+            yield self.decl
+        if self.body is not None:
+            yield self.body
+        for child in (self.param_decls or []):
+            yield child
+
+    attr_names = ()
+
+class Goto(Node):
+    __slots__ = ('name', 'coord', '__weakref__')
+    def __init__(self, name, coord=None):
+        self.name = name
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        return tuple(nodelist)
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ('name', )
+
+class ID(Node):
+    __slots__ = ('name', 'coord', '__weakref__')
+    def __init__(self, name, coord=None):
+        self.name = name
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        return tuple(nodelist)
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ('name', )
+
+class IdentifierType(Node):
+    __slots__ = ('names', 'coord', '__weakref__')
+    def __init__(self, names, coord=None):
+        self.names = names
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        return tuple(nodelist)
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ('names', )
+
+class If(Node):
+    __slots__ = ('cond', 'iftrue', 'iffalse', 'coord', '__weakref__')
+    def __init__(self, cond, iftrue, iffalse, coord=None):
+        self.cond = cond
+        self.iftrue = iftrue
+        self.iffalse = iffalse
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.iftrue is not None: nodelist.append(("iftrue", self.iftrue))
+        if self.iffalse is not None: nodelist.append(("iffalse", self.iffalse))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.cond is not None:
+            yield self.cond
+        if self.iftrue is not None:
+            yield self.iftrue
+        if self.iffalse is not None:
+            yield self.iffalse
+
+    attr_names = ()
+
+class InitList(Node):
+    __slots__ = ('exprs', 'coord', '__weakref__')
+    def __init__(self, exprs, coord=None):
+        self.exprs = exprs
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.exprs or []):
+            nodelist.append(("exprs[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.exprs or []):
+            yield child
+
+    attr_names = ()
+
+class Label(Node):
+    __slots__ = ('name', 'stmt', 'coord', '__weakref__')
+    def __init__(self, name, stmt, coord=None):
+        self.name = name
+        self.stmt = stmt
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.stmt is not None: nodelist.append(("stmt", self.stmt))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.stmt is not None:
+            yield self.stmt
+
+    attr_names = ('name', )
+
+class NamedInitializer(Node):
+    __slots__ = ('name', 'expr', 'coord', '__weakref__')
+    def __init__(self, name, expr, coord=None):
+        self.name = name
+        self.expr = expr
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.expr is not None: nodelist.append(("expr", self.expr))
+        for i, child in enumerate(self.name or []):
+            nodelist.append(("name[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.expr is not None:
+            yield self.expr
+        for child in (self.name or []):
+            yield child
+
+    attr_names = ()
+
+class ParamList(Node):
+    __slots__ = ('params', 'coord', '__weakref__')
+    def __init__(self, params, coord=None):
+        self.params = params
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.params or []):
+            nodelist.append(("params[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.params or []):
+            yield child
+
+    attr_names = ()
+
+class PtrDecl(Node):
+    __slots__ = ('quals', 'type', 'coord', '__weakref__')
+    def __init__(self, quals, type, coord=None):
+        self.quals = quals
+        self.type = type
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+
+    attr_names = ('quals', )
+
+class Return(Node):
+    __slots__ = ('expr', 'coord', '__weakref__')
+    def __init__(self, expr, coord=None):
+        self.expr = expr
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.expr is not None: nodelist.append(("expr", self.expr))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.expr is not None:
+            yield self.expr
+
+    attr_names = ()
+
+class Struct(Node):
+    __slots__ = ('name', 'decls', 'coord', '__weakref__')
+    def __init__(self, name, decls, coord=None):
+        self.name = name
+        self.decls = decls
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.decls or []):
+            nodelist.append(("decls[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.decls or []):
+            yield child
+
+    attr_names = ('name', )
+
+class StructRef(Node):
+    __slots__ = ('name', 'type', 'field', 'coord', '__weakref__')
+    def __init__(self, name, type, field, coord=None):
+        self.name = name
+        self.type = type
+        self.field = field
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.name is not None: nodelist.append(("name", self.name))
+        if self.field is not None: nodelist.append(("field", self.field))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.name is not None:
+            yield self.name
+        if self.field is not None:
+            yield self.field
+
+    attr_names = ('type', )
+
+class Switch(Node):
+    __slots__ = ('cond', 'stmt', 'coord', '__weakref__')
+    def __init__(self, cond, stmt, coord=None):
+        self.cond = cond
+        self.stmt = stmt
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.stmt is not None: nodelist.append(("stmt", self.stmt))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.cond is not None:
+            yield self.cond
+        if self.stmt is not None:
+            yield self.stmt
+
+    attr_names = ()
+
+class TernaryOp(Node):
+    __slots__ = ('cond', 'iftrue', 'iffalse', 'coord', '__weakref__')
+    def __init__(self, cond, iftrue, iffalse, coord=None):
+        self.cond = cond
+        self.iftrue = iftrue
+        self.iffalse = iffalse
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.iftrue is not None: nodelist.append(("iftrue", self.iftrue))
+        if self.iffalse is not None: nodelist.append(("iffalse", self.iffalse))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.cond is not None:
+            yield self.cond
+        if self.iftrue is not None:
+            yield self.iftrue
+        if self.iffalse is not None:
+            yield self.iffalse
+
+    attr_names = ()
+
+class TypeDecl(Node):
+    __slots__ = ('declname', 'quals', 'type', 'coord', '__weakref__')
+    def __init__(self, declname, quals, type, coord=None):
+        self.declname = declname
+        self.quals = quals
+        self.type = type
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+
+    attr_names = ('declname', 'quals', )
+
+class Typedef(Node):
+    __slots__ = ('name', 'quals', 'storage', 'type', 'coord', '__weakref__')
+    def __init__(self, name, quals, storage, type, coord=None):
+        self.name = name
+        self.quals = quals
+        self.storage = storage
+        self.type = type
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+
+    attr_names = ('name', 'quals', 'storage', )
+
+class Typename(Node):
+    __slots__ = ('name', 'quals', 'type', 'coord', '__weakref__')
+    def __init__(self, name, quals, type, coord=None):
+        self.name = name
+        self.quals = quals
+        self.type = type
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.type is not None: nodelist.append(("type", self.type))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.type is not None:
+            yield self.type
+
+    attr_names = ('name', 'quals', )
+
+class UnaryOp(Node):
+    __slots__ = ('op', 'expr', 'coord', '__weakref__')
+    def __init__(self, op, expr, coord=None):
+        self.op = op
+        self.expr = expr
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.expr is not None: nodelist.append(("expr", self.expr))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.expr is not None:
+            yield self.expr
+
+    attr_names = ('op', )
+
+class Union(Node):
+    __slots__ = ('name', 'decls', 'coord', '__weakref__')
+    def __init__(self, name, decls, coord=None):
+        self.name = name
+        self.decls = decls
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        for i, child in enumerate(self.decls or []):
+            nodelist.append(("decls[%d]" % i, child))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        for child in (self.decls or []):
+            yield child
+
+    attr_names = ('name', )
+
+class While(Node):
+    __slots__ = ('cond', 'stmt', 'coord', '__weakref__')
+    def __init__(self, cond, stmt, coord=None):
+        self.cond = cond
+        self.stmt = stmt
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        if self.cond is not None: nodelist.append(("cond", self.cond))
+        if self.stmt is not None: nodelist.append(("stmt", self.stmt))
+        return tuple(nodelist)
+
+    def __iter__(self):
+        if self.cond is not None:
+            yield self.cond
+        if self.stmt is not None:
+            yield self.stmt
+
+    attr_names = ()
+
+class Pragma(Node):
+    __slots__ = ('string', 'coord', '__weakref__')
+    def __init__(self, string, coord=None):
+        self.string = string
+        self.coord = coord
+
+    def children(self):
+        nodelist = []
+        return tuple(nodelist)
+
+    def __iter__(self):
+        return
+        yield
+
+    attr_names = ('string', )
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_generator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..973d24a8c1ff3726787eff9a3d2b19c415f78185
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_generator.py
@@ -0,0 +1,444 @@
+#------------------------------------------------------------------------------
+# pycparser: c_generator.py
+#
+# C code generator from pycparser AST nodes.
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#------------------------------------------------------------------------------
+from . import c_ast
+
+
+class CGenerator(object):
+    """ Uses the same visitor pattern as c_ast.NodeVisitor, but modified to
+        return a value from each visit method, using string accumulation in
+        generic_visit.
+    """
+    def __init__(self):
+        # Statements start with indentation of self.indent_level spaces, using
+        # the _make_indent method
+        #
+        self.indent_level = 0
+
+    def _make_indent(self):
+        return ' ' * self.indent_level
+
+    def visit(self, node):
+        method = 'visit_' + node.__class__.__name__
+        return getattr(self, method, self.generic_visit)(node)
+
+    def generic_visit(self, node):
+        #~ print('generic:', type(node))
+        if node is None:
+            return ''
+        else:
+            return ''.join(self.visit(c) for c_name, c in node.children())
+
+    def visit_Constant(self, n):
+        return n.value
+
+    def visit_ID(self, n):
+        return n.name
+
+    def visit_Pragma(self, n):
+        ret = '#pragma'
+        if n.string:
+            ret += ' ' + n.string
+        return ret
+
+    def visit_ArrayRef(self, n):
+        arrref = self._parenthesize_unless_simple(n.name)
+        return arrref + '[' + self.visit(n.subscript) + ']'
+
+    def visit_StructRef(self, n):
+        sref = self._parenthesize_unless_simple(n.name)
+        return sref + n.type + self.visit(n.field)
+
+    def visit_FuncCall(self, n):
+        fref = self._parenthesize_unless_simple(n.name)
+        return fref + '(' + self.visit(n.args) + ')'
+
+    def visit_UnaryOp(self, n):
+        operand = self._parenthesize_unless_simple(n.expr)
+        if n.op == 'p++':
+            return '%s++' % operand
+        elif n.op == 'p--':
+            return '%s--' % operand
+        elif n.op == 'sizeof':
+            # Always parenthesize the argument of sizeof since it can be
+            # a name.
+            return 'sizeof(%s)' % self.visit(n.expr)
+        else:
+            return '%s%s' % (n.op, operand)
+
+    def visit_BinaryOp(self, n):
+        lval_str = self._parenthesize_if(n.left,
+                            lambda d: not self._is_simple_node(d))
+        rval_str = self._parenthesize_if(n.right,
+                            lambda d: not self._is_simple_node(d))
+        return '%s %s %s' % (lval_str, n.op, rval_str)
+
+    def visit_Assignment(self, n):
+        rval_str = self._parenthesize_if(
+                            n.rvalue,
+                            lambda n: isinstance(n, c_ast.Assignment))
+        return '%s %s %s' % (self.visit(n.lvalue), n.op, rval_str)
+
+    def visit_IdentifierType(self, n):
+        return ' '.join(n.names)
+
+    def _visit_expr(self, n):
+        if isinstance(n, c_ast.InitList):
+            return '{' + self.visit(n) + '}'
+        elif isinstance(n, c_ast.ExprList):
+            return '(' + self.visit(n) + ')'
+        else:
+            return self.visit(n)
+
+    def visit_Decl(self, n, no_type=False):
+        # no_type is used when a Decl is part of a DeclList, where the type is
+        # explicitly only for the first declaration in a list.
+        #
+        s = n.name if no_type else self._generate_decl(n)
+        if n.bitsize: s += ' : ' + self.visit(n.bitsize)
+        if n.init:
+            s += ' = ' + self._visit_expr(n.init)
+        return s
+
+    def visit_DeclList(self, n):
+        s = self.visit(n.decls[0])
+        if len(n.decls) > 1:
+            s += ', ' + ', '.join(self.visit_Decl(decl, no_type=True)
+                                    for decl in n.decls[1:])
+        return s
+
+    def visit_Typedef(self, n):
+        s = ''
+        if n.storage: s += ' '.join(n.storage) + ' '
+        s += self._generate_type(n.type)
+        return s
+
+    def visit_Cast(self, n):
+        s = '(' + self._generate_type(n.to_type, emit_declname=False) + ')'
+        return s + ' ' + self._parenthesize_unless_simple(n.expr)
+
+    def visit_ExprList(self, n):
+        visited_subexprs = []
+        for expr in n.exprs:
+            visited_subexprs.append(self._visit_expr(expr))
+        return ', '.join(visited_subexprs)
+
+    def visit_InitList(self, n):
+        visited_subexprs = []
+        for expr in n.exprs:
+            visited_subexprs.append(self._visit_expr(expr))
+        return ', '.join(visited_subexprs)
+
+    def visit_Enum(self, n):
+        return self._generate_struct_union_enum(n, name='enum')
+
+    def visit_Enumerator(self, n):
+        if not n.value:
+            return '{indent}{name},\n'.format(
+                indent=self._make_indent(),
+                name=n.name,
+            )
+        else:
+            return '{indent}{name} = {value},\n'.format(
+                indent=self._make_indent(),
+                name=n.name,
+                value=self.visit(n.value),
+            )
+
+    def visit_FuncDef(self, n):
+        decl = self.visit(n.decl)
+        self.indent_level = 0
+        body = self.visit(n.body)
+        if n.param_decls:
+            knrdecls = ';\n'.join(self.visit(p) for p in n.param_decls)
+            return decl + '\n' + knrdecls + ';\n' + body + '\n'
+        else:
+            return decl + '\n' + body + '\n'
+
+    def visit_FileAST(self, n):
+        s = ''
+        for ext in n.ext:
+            if isinstance(ext, c_ast.FuncDef):
+                s += self.visit(ext)
+            elif isinstance(ext, c_ast.Pragma):
+                s += self.visit(ext) + '\n'
+            else:
+                s += self.visit(ext) + ';\n'
+        return s
+
+    def visit_Compound(self, n):
+        s = self._make_indent() + '{\n'
+        self.indent_level += 2
+        if n.block_items:
+            s += ''.join(self._generate_stmt(stmt) for stmt in n.block_items)
+        self.indent_level -= 2
+        s += self._make_indent() + '}\n'
+        return s
+
+    def visit_CompoundLiteral(self, n):
+        return '(' + self.visit(n.type) + '){' + self.visit(n.init) + '}'
+
+
+    def visit_EmptyStatement(self, n):
+        return ';'
+
+    def visit_ParamList(self, n):
+        return ', '.join(self.visit(param) for param in n.params)
+
+    def visit_Return(self, n):
+        s = 'return'
+        if n.expr: s += ' ' + self.visit(n.expr)
+        return s + ';'
+
+    def visit_Break(self, n):
+        return 'break;'
+
+    def visit_Continue(self, n):
+        return 'continue;'
+
+    def visit_TernaryOp(self, n):
+        s  = '(' + self._visit_expr(n.cond) + ') ? '
+        s += '(' + self._visit_expr(n.iftrue) + ') : '
+        s += '(' + self._visit_expr(n.iffalse) + ')'
+        return s
+
+    def visit_If(self, n):
+        s = 'if ('
+        if n.cond: s += self.visit(n.cond)
+        s += ')\n'
+        s += self._generate_stmt(n.iftrue, add_indent=True)
+        if n.iffalse:
+            s += self._make_indent() + 'else\n'
+            s += self._generate_stmt(n.iffalse, add_indent=True)
+        return s
+
+    def visit_For(self, n):
+        s = 'for ('
+        if n.init: s += self.visit(n.init)
+        s += ';'
+        if n.cond: s += ' ' + self.visit(n.cond)
+        s += ';'
+        if n.next: s += ' ' + self.visit(n.next)
+        s += ')\n'
+        s += self._generate_stmt(n.stmt, add_indent=True)
+        return s
+
+    def visit_While(self, n):
+        s = 'while ('
+        if n.cond: s += self.visit(n.cond)
+        s += ')\n'
+        s += self._generate_stmt(n.stmt, add_indent=True)
+        return s
+
+    def visit_DoWhile(self, n):
+        s = 'do\n'
+        s += self._generate_stmt(n.stmt, add_indent=True)
+        s += self._make_indent() + 'while ('
+        if n.cond: s += self.visit(n.cond)
+        s += ');'
+        return s
+
+    def visit_Switch(self, n):
+        s = 'switch (' + self.visit(n.cond) + ')\n'
+        s += self._generate_stmt(n.stmt, add_indent=True)
+        return s
+
+    def visit_Case(self, n):
+        s = 'case ' + self.visit(n.expr) + ':\n'
+        for stmt in n.stmts:
+            s += self._generate_stmt(stmt, add_indent=True)
+        return s
+
+    def visit_Default(self, n):
+        s = 'default:\n'
+        for stmt in n.stmts:
+            s += self._generate_stmt(stmt, add_indent=True)
+        return s
+
+    def visit_Label(self, n):
+        return n.name + ':\n' + self._generate_stmt(n.stmt)
+
+    def visit_Goto(self, n):
+        return 'goto ' + n.name + ';'
+
+    def visit_EllipsisParam(self, n):
+        return '...'
+
+    def visit_Struct(self, n):
+        return self._generate_struct_union_enum(n, 'struct')
+
+    def visit_Typename(self, n):
+        return self._generate_type(n.type)
+
+    def visit_Union(self, n):
+        return self._generate_struct_union_enum(n, 'union')
+
+    def visit_NamedInitializer(self, n):
+        s = ''
+        for name in n.name:
+            if isinstance(name, c_ast.ID):
+                s += '.' + name.name
+            else:
+                s += '[' + self.visit(name) + ']'
+        s += ' = ' + self._visit_expr(n.expr)
+        return s
+
+    def visit_FuncDecl(self, n):
+        return self._generate_type(n)
+
+    def visit_ArrayDecl(self, n):
+        return self._generate_type(n, emit_declname=False)
+
+    def visit_TypeDecl(self, n):
+        return self._generate_type(n, emit_declname=False)
+
+    def visit_PtrDecl(self, n):
+        return self._generate_type(n, emit_declname=False)
+
+    def _generate_struct_union_enum(self, n, name):
+        """ Generates code for structs, unions, and enums. name should be
+            'struct', 'union', or 'enum'.
+        """
+        if name in ('struct', 'union'):
+            members = n.decls
+            body_function = self._generate_struct_union_body
+        else:
+            assert name == 'enum'
+            members = None if n.values is None else n.values.enumerators
+            body_function = self._generate_enum_body
+        s = name + ' ' + (n.name or '')
+        if members is not None:
+            # None means no members
+            # Empty sequence means an empty list of members
+            s += '\n'
+            s += self._make_indent()
+            self.indent_level += 2
+            s += '{\n'
+            s += body_function(members)
+            self.indent_level -= 2
+            s += self._make_indent() + '}'
+        return s
+
+    def _generate_struct_union_body(self, members):
+        return ''.join(self._generate_stmt(decl) for decl in members)
+
+    def _generate_enum_body(self, members):
+        # `[:-2] + '\n'` removes the final `,` from the enumerator list
+        return ''.join(self.visit(value) for value in members)[:-2] + '\n'
+
+    def _generate_stmt(self, n, add_indent=False):
+        """ Generation from a statement node. This method exists as a wrapper
+            for individual visit_* methods to handle different treatment of
+            some statements in this context.
+        """
+        typ = type(n)
+        if add_indent: self.indent_level += 2
+        indent = self._make_indent()
+        if add_indent: self.indent_level -= 2
+
+        if typ in (
+                c_ast.Decl, c_ast.Assignment, c_ast.Cast, c_ast.UnaryOp,
+                c_ast.BinaryOp, c_ast.TernaryOp, c_ast.FuncCall, c_ast.ArrayRef,
+                c_ast.StructRef, c_ast.Constant, c_ast.ID, c_ast.Typedef,
+                c_ast.ExprList):
+            # These can also appear in an expression context so no semicolon
+            # is added to them automatically
+            #
+            return indent + self.visit(n) + ';\n'
+        elif typ in (c_ast.Compound,):
+            # No extra indentation required before the opening brace of a
+            # compound - because it consists of multiple lines it has to
+            # compute its own indentation.
+            #
+            return self.visit(n)
+        else:
+            return indent + self.visit(n) + '\n'
+
+    def _generate_decl(self, n):
+        """ Generation from a Decl node.
+        """
+        s = ''
+        if n.funcspec: s = ' '.join(n.funcspec) + ' '
+        if n.storage: s += ' '.join(n.storage) + ' '
+        s += self._generate_type(n.type)
+        return s
+
+    def _generate_type(self, n, modifiers=[], emit_declname = True):
+        """ Recursive generation from a type node. n is the type node.
+            modifiers collects the PtrDecl, ArrayDecl and FuncDecl modifiers
+            encountered on the way down to a TypeDecl, to allow proper
+            generation from it.
+        """
+        typ = type(n)
+        #~ print(n, modifiers)
+
+        if typ == c_ast.TypeDecl:
+            s = ''
+            if n.quals: s += ' '.join(n.quals) + ' '
+            s += self.visit(n.type)
+
+            nstr = n.declname if n.declname and emit_declname else ''
+            # Resolve modifiers.
+            # Wrap in parens to distinguish pointer to array and pointer to
+            # function syntax.
+            #
+            for i, modifier in enumerate(modifiers):
+                if isinstance(modifier, c_ast.ArrayDecl):
+                    if (i != 0 and
+                        isinstance(modifiers[i - 1], c_ast.PtrDecl)):
+                            nstr = '(' + nstr + ')'
+                    nstr += '['
+                    if modifier.dim_quals:
+                        nstr += ' '.join(modifier.dim_quals) + ' '
+                    nstr += self.visit(modifier.dim) + ']'
+                elif isinstance(modifier, c_ast.FuncDecl):
+                    if (i != 0 and
+                        isinstance(modifiers[i - 1], c_ast.PtrDecl)):
+                            nstr = '(' + nstr + ')'
+                    nstr += '(' + self.visit(modifier.args) + ')'
+                elif isinstance(modifier, c_ast.PtrDecl):
+                    if modifier.quals:
+                        nstr = '* %s%s' % (' '.join(modifier.quals),
+                                           ' ' + nstr if nstr else '')
+                    else:
+                        nstr = '*' + nstr
+            if nstr: s += ' ' + nstr
+            return s
+        elif typ == c_ast.Decl:
+            return self._generate_decl(n.type)
+        elif typ == c_ast.Typename:
+            return self._generate_type(n.type, emit_declname = emit_declname)
+        elif typ == c_ast.IdentifierType:
+            return ' '.join(n.names) + ' '
+        elif typ in (c_ast.ArrayDecl, c_ast.PtrDecl, c_ast.FuncDecl):
+            return self._generate_type(n.type, modifiers + [n],
+                                       emit_declname = emit_declname)
+        else:
+            return self.visit(n)
+
+    def _parenthesize_if(self, n, condition):
+        """ Visits 'n' and returns its string representation, parenthesized
+            if the condition function applied to the node returns True.
+        """
+        s = self._visit_expr(n)
+        if condition(n):
+            return '(' + s + ')'
+        else:
+            return s
+
+    def _parenthesize_unless_simple(self, n):
+        """ Common use case for _parenthesize_if
+        """
+        return self._parenthesize_if(n, lambda d: not self._is_simple_node(d))
+
+    def _is_simple_node(self, n):
+        """ Returns True for nodes that are "simple" - i.e. nodes that always
+            have higher precedence than operators.
+        """
+        return isinstance(n, (c_ast.Constant, c_ast.ID, c_ast.ArrayRef,
+                              c_ast.StructRef, c_ast.FuncCall))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_lexer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_lexer.py
new file mode 100644
index 0000000000000000000000000000000000000000..045d24eb2a18d54f8f9442afc19717b7fbb7a147
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_lexer.py
@@ -0,0 +1,514 @@
+#------------------------------------------------------------------------------
+# pycparser: c_lexer.py
+#
+# CLexer class: lexer for the C language
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#------------------------------------------------------------------------------
+import re
+import sys
+
+from .ply import lex
+from .ply.lex import TOKEN
+
+
+class CLexer(object):
+    """ A lexer for the C language. After building it, set the
+        input text with input(), and call token() to get new
+        tokens.
+
+        The public attribute filename can be set to an initial
+        filename, but the lexer will update it upon #line
+        directives.
+    """
+    def __init__(self, error_func, on_lbrace_func, on_rbrace_func,
+                 type_lookup_func):
+        """ Create a new Lexer.
+
+            error_func:
+                An error function. Will be called with an error
+                message, line and column as arguments, in case of
+                an error during lexing.
+
+            on_lbrace_func, on_rbrace_func:
+                Called when an LBRACE or RBRACE is encountered
+                (likely to push/pop type_lookup_func's scope)
+
+            type_lookup_func:
+                A type lookup function. Given a string, it must
+                return True IFF this string is a name of a type
+                that was defined with a typedef earlier.
+        """
+        self.error_func = error_func
+        self.on_lbrace_func = on_lbrace_func
+        self.on_rbrace_func = on_rbrace_func
+        self.type_lookup_func = type_lookup_func
+        self.filename = ''
+
+        # Keeps track of the last token returned from self.token()
+        self.last_token = None
+
+        # Allow either "# line" or "# <num>" to support GCC's
+        # cpp output
+        #
+        self.line_pattern = re.compile(r'([ \t]*line\W)|([ \t]*\d+)')
+        self.pragma_pattern = re.compile(r'[ \t]*pragma\W')
+
+    def build(self, **kwargs):
+        """ Builds the lexer from the specification. Must be
+            called after the lexer object is created.
+
+            This method exists separately, because the PLY
+            manual warns against calling lex.lex inside
+            __init__
+        """
+        self.lexer = lex.lex(object=self, **kwargs)
+
+    def reset_lineno(self):
+        """ Resets the internal line number counter of the lexer.
+        """
+        self.lexer.lineno = 1
+
+    def input(self, text):
+        self.lexer.input(text)
+
+    def token(self):
+        self.last_token = self.lexer.token()
+        return self.last_token
+
+    def find_tok_column(self, token):
+        """ Find the column of the token in its line.
+        """
+        last_cr = self.lexer.lexdata.rfind('\n', 0, token.lexpos)
+        return token.lexpos - last_cr
+
+    ######################--   PRIVATE   --######################
+
+    ##
+    ## Internal auxiliary methods
+    ##
+    def _error(self, msg, token):
+        location = self._make_tok_location(token)
+        self.error_func(msg, location[0], location[1])
+        self.lexer.skip(1)
+
+    def _make_tok_location(self, token):
+        return (token.lineno, self.find_tok_column(token))
+
+    ##
+    ## Reserved keywords
+    ##
+    keywords = (
+        '_BOOL', '_COMPLEX', 'AUTO', 'BREAK', 'CASE', 'CHAR', 'CONST',
+        'CONTINUE', 'DEFAULT', 'DO', 'DOUBLE', 'ELSE', 'ENUM', 'EXTERN',
+        'FLOAT', 'FOR', 'GOTO', 'IF', 'INLINE', 'INT', 'LONG',
+        'REGISTER', 'OFFSETOF',
+        'RESTRICT', 'RETURN', 'SHORT', 'SIGNED', 'SIZEOF', 'STATIC', 'STRUCT',
+        'SWITCH', 'TYPEDEF', 'UNION', 'UNSIGNED', 'VOID',
+        'VOLATILE', 'WHILE', '__INT128',
+    )
+
+    keyword_map = {}
+    for keyword in keywords:
+        if keyword == '_BOOL':
+            keyword_map['_Bool'] = keyword
+        elif keyword == '_COMPLEX':
+            keyword_map['_Complex'] = keyword
+        else:
+            keyword_map[keyword.lower()] = keyword
+
+    ##
+    ## All the tokens recognized by the lexer
+    ##
+    tokens = keywords + (
+        # Identifiers
+        'ID',
+
+        # Type identifiers (identifiers previously defined as
+        # types with typedef)
+        'TYPEID',
+
+        # constants
+        'INT_CONST_DEC', 'INT_CONST_OCT', 'INT_CONST_HEX', 'INT_CONST_BIN', 'INT_CONST_CHAR',
+        'FLOAT_CONST', 'HEX_FLOAT_CONST',
+        'CHAR_CONST',
+        'WCHAR_CONST',
+
+        # String literals
+        'STRING_LITERAL',
+        'WSTRING_LITERAL',
+
+        # Operators
+        'PLUS', 'MINUS', 'TIMES', 'DIVIDE', 'MOD',
+        'OR', 'AND', 'NOT', 'XOR', 'LSHIFT', 'RSHIFT',
+        'LOR', 'LAND', 'LNOT',
+        'LT', 'LE', 'GT', 'GE', 'EQ', 'NE',
+
+        # Assignment
+        'EQUALS', 'TIMESEQUAL', 'DIVEQUAL', 'MODEQUAL',
+        'PLUSEQUAL', 'MINUSEQUAL',
+        'LSHIFTEQUAL','RSHIFTEQUAL', 'ANDEQUAL', 'XOREQUAL',
+        'OREQUAL',
+
+        # Increment/decrement
+        'PLUSPLUS', 'MINUSMINUS',
+
+        # Structure dereference (->)
+        'ARROW',
+
+        # Conditional operator (?)
+        'CONDOP',
+
+        # Delimeters
+        'LPAREN', 'RPAREN',         # ( )
+        'LBRACKET', 'RBRACKET',     # [ ]
+        'LBRACE', 'RBRACE',         # { }
+        'COMMA', 'PERIOD',          # . ,
+        'SEMI', 'COLON',            # ; :
+
+        # Ellipsis (...)
+        'ELLIPSIS',
+
+        # pre-processor
+        'PPHASH',       # '#'
+        'PPPRAGMA',     # 'pragma'
+        'PPPRAGMASTR',
+    )
+
+    ##
+    ## Regexes for use in tokens
+    ##
+    ##
+
+    # valid C identifiers (K&R2: A.2.3), plus '$' (supported by some compilers)
+    identifier = r'[a-zA-Z_$][0-9a-zA-Z_$]*'
+
+    hex_prefix = '0[xX]'
+    hex_digits = '[0-9a-fA-F]+'
+    bin_prefix = '0[bB]'
+    bin_digits = '[01]+'
+
+    # integer constants (K&R2: A.2.5.1)
+    integer_suffix_opt = r'(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?'
+    decimal_constant = '(0'+integer_suffix_opt+')|([1-9][0-9]*'+integer_suffix_opt+')'
+    octal_constant = '0[0-7]*'+integer_suffix_opt
+    hex_constant = hex_prefix+hex_digits+integer_suffix_opt
+    bin_constant = bin_prefix+bin_digits+integer_suffix_opt
+
+    bad_octal_constant = '0[0-7]*[89]'
+
+    # character constants (K&R2: A.2.5.2)
+    # Note: a-zA-Z and '.-~^_!=&;,' are allowed as escape chars to support #line
+    # directives with Windows paths as filenames (..\..\dir\file)
+    # For the same reason, decimal_escape allows all digit sequences. We want to
+    # parse all correct code, even if it means to sometimes parse incorrect
+    # code.
+    #
+    # The original regexes were taken verbatim from the C syntax definition,
+    # and were later modified to avoid worst-case exponential running time.
+    #
+    #   simple_escape = r"""([a-zA-Z._~!=&\^\-\\?'"])"""
+    #   decimal_escape = r"""(\d+)"""
+    #   hex_escape = r"""(x[0-9a-fA-F]+)"""
+    #   bad_escape = r"""([\\][^a-zA-Z._~^!=&\^\-\\?'"x0-7])"""
+    #
+    # The following modifications were made to avoid the ambiguity that allowed backtracking:
+    # (https://github.com/eliben/pycparser/issues/61)
+    #
+    # - \x was removed from simple_escape, unless it was not followed by a hex digit, to avoid ambiguity with hex_escape.
+    # - hex_escape allows one or more hex characters, but requires that the next character(if any) is not hex
+    # - decimal_escape allows one or more decimal characters, but requires that the next character(if any) is not a decimal
+    # - bad_escape does not allow any decimals (8-9), to avoid conflicting with the permissive decimal_escape.
+    #
+    # Without this change, python's `re` module would recursively try parsing each ambiguous escape sequence in multiple ways.
+    # e.g. `\123` could be parsed as `\1`+`23`, `\12`+`3`, and `\123`.
+
+    simple_escape = r"""([a-wyzA-Z._~!=&\^\-\\?'"]|x(?![0-9a-fA-F]))"""
+    decimal_escape = r"""(\d+)(?!\d)"""
+    hex_escape = r"""(x[0-9a-fA-F]+)(?![0-9a-fA-F])"""
+    bad_escape = r"""([\\][^a-zA-Z._~^!=&\^\-\\?'"x0-9])"""
+
+    escape_sequence = r"""(\\("""+simple_escape+'|'+decimal_escape+'|'+hex_escape+'))'
+
+    # This complicated regex with lookahead might be slow for strings, so because all of the valid escapes (including \x) allowed
+    # 0 or more non-escaped characters after the first character, simple_escape+decimal_escape+hex_escape got simplified to
+
+    escape_sequence_start_in_string = r"""(\\[0-9a-zA-Z._~!=&\^\-\\?'"])"""
+
+    cconst_char = r"""([^'\\\n]|"""+escape_sequence+')'
+    char_const = "'"+cconst_char+"'"
+    wchar_const = 'L'+char_const
+    multicharacter_constant = "'"+cconst_char+"{2,4}'"
+    unmatched_quote = "('"+cconst_char+"*\\n)|('"+cconst_char+"*$)"
+    bad_char_const = r"""('"""+cconst_char+"""[^'\n]+')|('')|('"""+bad_escape+r"""[^'\n]*')"""
+
+    # string literals (K&R2: A.2.6)
+    string_char = r"""([^"\\\n]|"""+escape_sequence_start_in_string+')'
+    string_literal = '"'+string_char+'*"'
+    wstring_literal = 'L'+string_literal
+    bad_string_literal = '"'+string_char+'*'+bad_escape+string_char+'*"'
+
+    # floating constants (K&R2: A.2.5.3)
+    exponent_part = r"""([eE][-+]?[0-9]+)"""
+    fractional_constant = r"""([0-9]*\.[0-9]+)|([0-9]+\.)"""
+    floating_constant = '(((('+fractional_constant+')'+exponent_part+'?)|([0-9]+'+exponent_part+'))[FfLl]?)'
+    binary_exponent_part = r'''([pP][+-]?[0-9]+)'''
+    hex_fractional_constant = '((('+hex_digits+r""")?\."""+hex_digits+')|('+hex_digits+r"""\.))"""
+    hex_floating_constant = '('+hex_prefix+'('+hex_digits+'|'+hex_fractional_constant+')'+binary_exponent_part+'[FfLl]?)'
+
+    ##
+    ## Lexer states: used for preprocessor \n-terminated directives
+    ##
+    states = (
+        # ppline: preprocessor line directives
+        #
+        ('ppline', 'exclusive'),
+
+        # pppragma: pragma
+        #
+        ('pppragma', 'exclusive'),
+    )
+
+    def t_PPHASH(self, t):
+        r'[ \t]*\#'
+        if self.line_pattern.match(t.lexer.lexdata, pos=t.lexer.lexpos):
+            t.lexer.begin('ppline')
+            self.pp_line = self.pp_filename = None
+        elif self.pragma_pattern.match(t.lexer.lexdata, pos=t.lexer.lexpos):
+            t.lexer.begin('pppragma')
+        else:
+            t.type = 'PPHASH'
+            return t
+
+    ##
+    ## Rules for the ppline state
+    ##
+    @TOKEN(string_literal)
+    def t_ppline_FILENAME(self, t):
+        if self.pp_line is None:
+            self._error('filename before line number in #line', t)
+        else:
+            self.pp_filename = t.value.lstrip('"').rstrip('"')
+
+    @TOKEN(decimal_constant)
+    def t_ppline_LINE_NUMBER(self, t):
+        if self.pp_line is None:
+            self.pp_line = t.value
+        else:
+            # Ignore: GCC's cpp sometimes inserts a numeric flag
+            # after the file name
+            pass
+
+    def t_ppline_NEWLINE(self, t):
+        r'\n'
+        if self.pp_line is None:
+            self._error('line number missing in #line', t)
+        else:
+            self.lexer.lineno = int(self.pp_line)
+
+            if self.pp_filename is not None:
+                self.filename = self.pp_filename
+
+        t.lexer.begin('INITIAL')
+
+    def t_ppline_PPLINE(self, t):
+        r'line'
+        pass
+
+    t_ppline_ignore = ' \t'
+
+    def t_ppline_error(self, t):
+        self._error('invalid #line directive', t)
+
+    ##
+    ## Rules for the pppragma state
+    ##
+    def t_pppragma_NEWLINE(self, t):
+        r'\n'
+        t.lexer.lineno += 1
+        t.lexer.begin('INITIAL')
+
+    def t_pppragma_PPPRAGMA(self, t):
+        r'pragma'
+        return t
+
+    t_pppragma_ignore = ' \t'
+
+    def t_pppragma_STR(self, t):
+        '.+'
+        t.type = 'PPPRAGMASTR'
+        return t
+
+    def t_pppragma_error(self, t):
+        self._error('invalid #pragma directive', t)
+
+    ##
+    ## Rules for the normal state
+    ##
+    t_ignore = ' \t'
+
+    # Newlines
+    def t_NEWLINE(self, t):
+        r'\n+'
+        t.lexer.lineno += t.value.count("\n")
+
+    # Operators
+    t_PLUS              = r'\+'
+    t_MINUS             = r'-'
+    t_TIMES             = r'\*'
+    t_DIVIDE            = r'/'
+    t_MOD               = r'%'
+    t_OR                = r'\|'
+    t_AND               = r'&'
+    t_NOT               = r'~'
+    t_XOR               = r'\^'
+    t_LSHIFT            = r'<<'
+    t_RSHIFT            = r'>>'
+    t_LOR               = r'\|\|'
+    t_LAND              = r'&&'
+    t_LNOT              = r'!'
+    t_LT                = r'<'
+    t_GT                = r'>'
+    t_LE                = r'<='
+    t_GE                = r'>='
+    t_EQ                = r'=='
+    t_NE                = r'!='
+
+    # Assignment operators
+    t_EQUALS            = r'='
+    t_TIMESEQUAL        = r'\*='
+    t_DIVEQUAL          = r'/='
+    t_MODEQUAL          = r'%='
+    t_PLUSEQUAL         = r'\+='
+    t_MINUSEQUAL        = r'-='
+    t_LSHIFTEQUAL       = r'<<='
+    t_RSHIFTEQUAL       = r'>>='
+    t_ANDEQUAL          = r'&='
+    t_OREQUAL           = r'\|='
+    t_XOREQUAL          = r'\^='
+
+    # Increment/decrement
+    t_PLUSPLUS          = r'\+\+'
+    t_MINUSMINUS        = r'--'
+
+    # ->
+    t_ARROW             = r'->'
+
+    # ?
+    t_CONDOP            = r'\?'
+
+    # Delimeters
+    t_LPAREN            = r'\('
+    t_RPAREN            = r'\)'
+    t_LBRACKET          = r'\['
+    t_RBRACKET          = r'\]'
+    t_COMMA             = r','
+    t_PERIOD            = r'\.'
+    t_SEMI              = r';'
+    t_COLON             = r':'
+    t_ELLIPSIS          = r'\.\.\.'
+
+    # Scope delimiters
+    # To see why on_lbrace_func is needed, consider:
+    #   typedef char TT;
+    #   void foo(int TT) { TT = 10; }
+    #   TT x = 5;
+    # Outside the function, TT is a typedef, but inside (starting and ending
+    # with the braces) it's a parameter.  The trouble begins with yacc's
+    # lookahead token.  If we open a new scope in brace_open, then TT has
+    # already been read and incorrectly interpreted as TYPEID.  So, we need
+    # to open and close scopes from within the lexer.
+    # Similar for the TT immediately outside the end of the function.
+    #
+    @TOKEN(r'\{')
+    def t_LBRACE(self, t):
+        self.on_lbrace_func()
+        return t
+    @TOKEN(r'\}')
+    def t_RBRACE(self, t):
+        self.on_rbrace_func()
+        return t
+
+    t_STRING_LITERAL = string_literal
+
+    # The following floating and integer constants are defined as
+    # functions to impose a strict order (otherwise, decimal
+    # is placed before the others because its regex is longer,
+    # and this is bad)
+    #
+    @TOKEN(floating_constant)
+    def t_FLOAT_CONST(self, t):
+        return t
+
+    @TOKEN(hex_floating_constant)
+    def t_HEX_FLOAT_CONST(self, t):
+        return t
+
+    @TOKEN(hex_constant)
+    def t_INT_CONST_HEX(self, t):
+        return t
+
+    @TOKEN(bin_constant)
+    def t_INT_CONST_BIN(self, t):
+        return t
+
+    @TOKEN(bad_octal_constant)
+    def t_BAD_CONST_OCT(self, t):
+        msg = "Invalid octal constant"
+        self._error(msg, t)
+
+    @TOKEN(octal_constant)
+    def t_INT_CONST_OCT(self, t):
+        return t
+
+    @TOKEN(decimal_constant)
+    def t_INT_CONST_DEC(self, t):
+        return t
+
+    # Must come before bad_char_const, to prevent it from
+    # catching valid char constants as invalid
+    #
+    @TOKEN(multicharacter_constant)
+    def t_INT_CONST_CHAR(self, t):
+        return t
+
+    @TOKEN(char_const)
+    def t_CHAR_CONST(self, t):
+        return t
+
+    @TOKEN(wchar_const)
+    def t_WCHAR_CONST(self, t):
+        return t
+
+    @TOKEN(unmatched_quote)
+    def t_UNMATCHED_QUOTE(self, t):
+        msg = "Unmatched '"
+        self._error(msg, t)
+
+    @TOKEN(bad_char_const)
+    def t_BAD_CHAR_CONST(self, t):
+        msg = "Invalid char constant %s" % t.value
+        self._error(msg, t)
+
+    @TOKEN(wstring_literal)
+    def t_WSTRING_LITERAL(self, t):
+        return t
+
+    # unmatched string literals are caught by the preprocessor
+
+    @TOKEN(bad_string_literal)
+    def t_BAD_STRING_LITERAL(self, t):
+        msg = "String contains invalid escape code"
+        self._error(msg, t)
+
+    @TOKEN(identifier)
+    def t_ID(self, t):
+        t.type = self.keyword_map.get(t.value, "ID")
+        if t.type == 'ID' and self.type_lookup_func(t.value):
+            t.type = "TYPEID"
+        return t
+
+    def t_error(self, t):
+        msg = 'Illegal character %s' % repr(t.value[0])
+        self._error(msg, t)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..744ede8ac956bfc75ca04ff58e863831fd8be723
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/c_parser.py
@@ -0,0 +1,1863 @@
+#------------------------------------------------------------------------------
+# pycparser: c_parser.py
+#
+# CParser class: Parser and AST builder for the C language
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#------------------------------------------------------------------------------
+import re
+
+from .ply import yacc
+
+from . import c_ast
+from .c_lexer import CLexer
+from .plyparser import PLYParser, Coord, ParseError, parameterized, template
+from .ast_transforms import fix_switch_cases
+
+
+@template
+class CParser(PLYParser):
+    def __init__(
+            self,
+            lex_optimize=True,
+            lexer=CLexer,
+            lextab='pycparser.lextab',
+            yacc_optimize=True,
+            yacctab='pycparser.yacctab',
+            yacc_debug=False,
+            taboutputdir=''):
+        """ Create a new CParser.
+
+            Some arguments for controlling the debug/optimization
+            level of the parser are provided. The defaults are
+            tuned for release/performance mode.
+            The simple rules for using them are:
+            *) When tweaking CParser/CLexer, set these to False
+            *) When releasing a stable parser, set to True
+
+            lex_optimize:
+                Set to False when you're modifying the lexer.
+                Otherwise, changes in the lexer won't be used, if
+                some lextab.py file exists.
+                When releasing with a stable lexer, set to True
+                to save the re-generation of the lexer table on
+                each run.
+
+            lexer:
+                Set this parameter to define the lexer to use if
+                you're not using the default CLexer.
+
+            lextab:
+                Points to the lex table that's used for optimized
+                mode. Only if you're modifying the lexer and want
+                some tests to avoid re-generating the table, make
+                this point to a local lex table file (that's been
+                earlier generated with lex_optimize=True)
+
+            yacc_optimize:
+                Set to False when you're modifying the parser.
+                Otherwise, changes in the parser won't be used, if
+                some parsetab.py file exists.
+                When releasing with a stable parser, set to True
+                to save the re-generation of the parser table on
+                each run.
+
+            yacctab:
+                Points to the yacc table that's used for optimized
+                mode. Only if you're modifying the parser, make
+                this point to a local yacc table file
+
+            yacc_debug:
+                Generate a parser.out file that explains how yacc
+                built the parsing table from the grammar.
+
+            taboutputdir:
+                Set this parameter to control the location of generated
+                lextab and yacctab files.
+        """
+        self.clex = lexer(
+            error_func=self._lex_error_func,
+            on_lbrace_func=self._lex_on_lbrace_func,
+            on_rbrace_func=self._lex_on_rbrace_func,
+            type_lookup_func=self._lex_type_lookup_func)
+
+        self.clex.build(
+            optimize=lex_optimize,
+            lextab=lextab,
+            outputdir=taboutputdir)
+        self.tokens = self.clex.tokens
+
+        rules_with_opt = [
+            'abstract_declarator',
+            'assignment_expression',
+            'declaration_list',
+            'declaration_specifiers_no_type',
+            'designation',
+            'expression',
+            'identifier_list',
+            'init_declarator_list',
+            'id_init_declarator_list',
+            'initializer_list',
+            'parameter_type_list',
+            'block_item_list',
+            'type_qualifier_list',
+            'struct_declarator_list'
+        ]
+
+        for rule in rules_with_opt:
+            self._create_opt_rule(rule)
+
+        self.cparser = yacc.yacc(
+            module=self,
+            start='translation_unit_or_empty',
+            debug=yacc_debug,
+            optimize=yacc_optimize,
+            tabmodule=yacctab,
+            outputdir=taboutputdir)
+
+        # Stack of scopes for keeping track of symbols. _scope_stack[-1] is
+        # the current (topmost) scope. Each scope is a dictionary that
+        # specifies whether a name is a type. If _scope_stack[n][name] is
+        # True, 'name' is currently a type in the scope. If it's False,
+        # 'name' is used in the scope but not as a type (for instance, if we
+        # saw: int name;
+        # If 'name' is not a key in _scope_stack[n] then 'name' was not defined
+        # in this scope at all.
+        self._scope_stack = [dict()]
+
+        # Keeps track of the last token given to yacc (the lookahead token)
+        self._last_yielded_token = None
+
+    def parse(self, text, filename='', debuglevel=0):
+        """ Parses C code and returns an AST.
+
+            text:
+                A string containing the C source code
+
+            filename:
+                Name of the file being parsed (for meaningful
+                error messages)
+
+            debuglevel:
+                Debug level to yacc
+        """
+        self.clex.filename = filename
+        self.clex.reset_lineno()
+        self._scope_stack = [dict()]
+        self._last_yielded_token = None
+        return self.cparser.parse(
+                input=text,
+                lexer=self.clex,
+                debug=debuglevel)
+
+    ######################--   PRIVATE   --######################
+
+    def _push_scope(self):
+        self._scope_stack.append(dict())
+
+    def _pop_scope(self):
+        assert len(self._scope_stack) > 1
+        self._scope_stack.pop()
+
+    def _add_typedef_name(self, name, coord):
+        """ Add a new typedef name (ie a TYPEID) to the current scope
+        """
+        if not self._scope_stack[-1].get(name, True):
+            self._parse_error(
+                "Typedef %r previously declared as non-typedef "
+                "in this scope" % name, coord)
+        self._scope_stack[-1][name] = True
+
+    def _add_identifier(self, name, coord):
+        """ Add a new object, function, or enum member name (ie an ID) to the
+            current scope
+        """
+        if self._scope_stack[-1].get(name, False):
+            self._parse_error(
+                "Non-typedef %r previously declared as typedef "
+                "in this scope" % name, coord)
+        self._scope_stack[-1][name] = False
+
+    def _is_type_in_scope(self, name):
+        """ Is *name* a typedef-name in the current scope?
+        """
+        for scope in reversed(self._scope_stack):
+            # If name is an identifier in this scope it shadows typedefs in
+            # higher scopes.
+            in_scope = scope.get(name)
+            if in_scope is not None: return in_scope
+        return False
+
+    def _lex_error_func(self, msg, line, column):
+        self._parse_error(msg, self._coord(line, column))
+
+    def _lex_on_lbrace_func(self):
+        self._push_scope()
+
+    def _lex_on_rbrace_func(self):
+        self._pop_scope()
+
+    def _lex_type_lookup_func(self, name):
+        """ Looks up types that were previously defined with
+            typedef.
+            Passed to the lexer for recognizing identifiers that
+            are types.
+        """
+        is_type = self._is_type_in_scope(name)
+        return is_type
+
+    def _get_yacc_lookahead_token(self):
+        """ We need access to yacc's lookahead token in certain cases.
+            This is the last token yacc requested from the lexer, so we
+            ask the lexer.
+        """
+        return self.clex.last_token
+
+    # To understand what's going on here, read sections A.8.5 and
+    # A.8.6 of K&R2 very carefully.
+    #
+    # A C type consists of a basic type declaration, with a list
+    # of modifiers. For example:
+    #
+    # int *c[5];
+    #
+    # The basic declaration here is 'int c', and the pointer and
+    # the array are the modifiers.
+    #
+    # Basic declarations are represented by TypeDecl (from module c_ast) and the
+    # modifiers are FuncDecl, PtrDecl and ArrayDecl.
+    #
+    # The standard states that whenever a new modifier is parsed, it should be
+    # added to the end of the list of modifiers. For example:
+    #
+    # K&R2 A.8.6.2: Array Declarators
+    #
+    # In a declaration T D where D has the form
+    #   D1 [constant-expression-opt]
+    # and the type of the identifier in the declaration T D1 is
+    # "type-modifier T", the type of the
+    # identifier of D is "type-modifier array of T"
+    #
+    # This is what this method does. The declarator it receives
+    # can be a list of declarators ending with TypeDecl. It
+    # tacks the modifier to the end of this list, just before
+    # the TypeDecl.
+    #
+    # Additionally, the modifier may be a list itself. This is
+    # useful for pointers, that can come as a chain from the rule
+    # p_pointer. In this case, the whole modifier list is spliced
+    # into the new location.
+    def _type_modify_decl(self, decl, modifier):
+        """ Tacks a type modifier on a declarator, and returns
+            the modified declarator.
+
+            Note: the declarator and modifier may be modified
+        """
+        #~ print '****'
+        #~ decl.show(offset=3)
+        #~ modifier.show(offset=3)
+        #~ print '****'
+
+        modifier_head = modifier
+        modifier_tail = modifier
+
+        # The modifier may be a nested list. Reach its tail.
+        #
+        while modifier_tail.type:
+            modifier_tail = modifier_tail.type
+
+        # If the decl is a basic type, just tack the modifier onto
+        # it
+        #
+        if isinstance(decl, c_ast.TypeDecl):
+            modifier_tail.type = decl
+            return modifier
+        else:
+            # Otherwise, the decl is a list of modifiers. Reach
+            # its tail and splice the modifier onto the tail,
+            # pointing to the underlying basic type.
+            #
+            decl_tail = decl
+
+            while not isinstance(decl_tail.type, c_ast.TypeDecl):
+                decl_tail = decl_tail.type
+
+            modifier_tail.type = decl_tail.type
+            decl_tail.type = modifier_head
+            return decl
+
+    # Due to the order in which declarators are constructed,
+    # they have to be fixed in order to look like a normal AST.
+    #
+    # When a declaration arrives from syntax construction, it has
+    # these problems:
+    # * The innermost TypeDecl has no type (because the basic
+    #   type is only known at the uppermost declaration level)
+    # * The declaration has no variable name, since that is saved
+    #   in the innermost TypeDecl
+    # * The typename of the declaration is a list of type
+    #   specifiers, and not a node. Here, basic identifier types
+    #   should be separated from more complex types like enums
+    #   and structs.
+    #
+    # This method fixes these problems.
+    #
+    def _fix_decl_name_type(self, decl, typename):
+        """ Fixes a declaration. Modifies decl.
+        """
+        # Reach the underlying basic type
+        #
+        type = decl
+        while not isinstance(type, c_ast.TypeDecl):
+            type = type.type
+
+        decl.name = type.declname
+        type.quals = decl.quals
+
+        # The typename is a list of types. If any type in this
+        # list isn't an IdentifierType, it must be the only
+        # type in the list (it's illegal to declare "int enum ..")
+        # If all the types are basic, they're collected in the
+        # IdentifierType holder.
+        #
+        for tn in typename:
+            if not isinstance(tn, c_ast.IdentifierType):
+                if len(typename) > 1:
+                    self._parse_error(
+                        "Invalid multiple types specified", tn.coord)
+                else:
+                    type.type = tn
+                    return decl
+
+        if not typename:
+            # Functions default to returning int
+            #
+            if not isinstance(decl.type, c_ast.FuncDecl):
+                self._parse_error(
+                        "Missing type in declaration", decl.coord)
+            type.type = c_ast.IdentifierType(
+                    ['int'],
+                    coord=decl.coord)
+        else:
+            # At this point, we know that typename is a list of IdentifierType
+            # nodes. Concatenate all the names into a single list.
+            #
+            type.type = c_ast.IdentifierType(
+                [name for id in typename for name in id.names],
+                coord=typename[0].coord)
+        return decl
+
+    def _add_declaration_specifier(self, declspec, newspec, kind, append=False):
+        """ Declaration specifiers are represented by a dictionary
+            with the entries:
+            * qual: a list of type qualifiers
+            * storage: a list of storage type qualifiers
+            * type: a list of type specifiers
+            * function: a list of function specifiers
+
+            This method is given a declaration specifier, and a
+            new specifier of a given kind.
+            If `append` is True, the new specifier is added to the end of
+            the specifiers list, otherwise it's added at the beginning.
+            Returns the declaration specifier, with the new
+            specifier incorporated.
+        """
+        spec = declspec or dict(qual=[], storage=[], type=[], function=[])
+
+        if append:
+            spec[kind].append(newspec)
+        else:
+            spec[kind].insert(0, newspec)
+
+        return spec
+
+    def _build_declarations(self, spec, decls, typedef_namespace=False):
+        """ Builds a list of declarations all sharing the given specifiers.
+            If typedef_namespace is true, each declared name is added
+            to the "typedef namespace", which also includes objects,
+            functions, and enum constants.
+        """
+        is_typedef = 'typedef' in spec['storage']
+        declarations = []
+
+        # Bit-fields are allowed to be unnamed.
+        #
+        if decls[0].get('bitsize') is not None:
+            pass
+
+        # When redeclaring typedef names as identifiers in inner scopes, a
+        # problem can occur where the identifier gets grouped into
+        # spec['type'], leaving decl as None.  This can only occur for the
+        # first declarator.
+        #
+        elif decls[0]['decl'] is None:
+            if len(spec['type']) < 2 or len(spec['type'][-1].names) != 1 or \
+                    not self._is_type_in_scope(spec['type'][-1].names[0]):
+                coord = '?'
+                for t in spec['type']:
+                    if hasattr(t, 'coord'):
+                        coord = t.coord
+                        break
+                self._parse_error('Invalid declaration', coord)
+
+            # Make this look as if it came from "direct_declarator:ID"
+            decls[0]['decl'] = c_ast.TypeDecl(
+                declname=spec['type'][-1].names[0],
+                type=None,
+                quals=None,
+                coord=spec['type'][-1].coord)
+            # Remove the "new" type's name from the end of spec['type']
+            del spec['type'][-1]
+
+        # A similar problem can occur where the declaration ends up looking
+        # like an abstract declarator.  Give it a name if this is the case.
+        #
+        elif not isinstance(decls[0]['decl'],
+                (c_ast.Struct, c_ast.Union, c_ast.IdentifierType)):
+            decls_0_tail = decls[0]['decl']
+            while not isinstance(decls_0_tail, c_ast.TypeDecl):
+                decls_0_tail = decls_0_tail.type
+            if decls_0_tail.declname is None:
+                decls_0_tail.declname = spec['type'][-1].names[0]
+                del spec['type'][-1]
+
+        for decl in decls:
+            assert decl['decl'] is not None
+            if is_typedef:
+                declaration = c_ast.Typedef(
+                    name=None,
+                    quals=spec['qual'],
+                    storage=spec['storage'],
+                    type=decl['decl'],
+                    coord=decl['decl'].coord)
+            else:
+                declaration = c_ast.Decl(
+                    name=None,
+                    quals=spec['qual'],
+                    storage=spec['storage'],
+                    funcspec=spec['function'],
+                    type=decl['decl'],
+                    init=decl.get('init'),
+                    bitsize=decl.get('bitsize'),
+                    coord=decl['decl'].coord)
+
+            if isinstance(declaration.type,
+                    (c_ast.Struct, c_ast.Union, c_ast.IdentifierType)):
+                fixed_decl = declaration
+            else:
+                fixed_decl = self._fix_decl_name_type(declaration, spec['type'])
+
+            # Add the type name defined by typedef to a
+            # symbol table (for usage in the lexer)
+            #
+            if typedef_namespace:
+                if is_typedef:
+                    self._add_typedef_name(fixed_decl.name, fixed_decl.coord)
+                else:
+                    self._add_identifier(fixed_decl.name, fixed_decl.coord)
+
+            declarations.append(fixed_decl)
+
+        return declarations
+
+    def _build_function_definition(self, spec, decl, param_decls, body):
+        """ Builds a function definition.
+        """
+        assert 'typedef' not in spec['storage']
+
+        declaration = self._build_declarations(
+            spec=spec,
+            decls=[dict(decl=decl, init=None)],
+            typedef_namespace=True)[0]
+
+        return c_ast.FuncDef(
+            decl=declaration,
+            param_decls=param_decls,
+            body=body,
+            coord=decl.coord)
+
+    def _select_struct_union_class(self, token):
+        """ Given a token (either STRUCT or UNION), selects the
+            appropriate AST class.
+        """
+        if token == 'struct':
+            return c_ast.Struct
+        else:
+            return c_ast.Union
+
+    ##
+    ## Precedence and associativity of operators
+    ##
+    precedence = (
+        ('left', 'LOR'),
+        ('left', 'LAND'),
+        ('left', 'OR'),
+        ('left', 'XOR'),
+        ('left', 'AND'),
+        ('left', 'EQ', 'NE'),
+        ('left', 'GT', 'GE', 'LT', 'LE'),
+        ('left', 'RSHIFT', 'LSHIFT'),
+        ('left', 'PLUS', 'MINUS'),
+        ('left', 'TIMES', 'DIVIDE', 'MOD')
+    )
+
+    ##
+    ## Grammar productions
+    ## Implementation of the BNF defined in K&R2 A.13
+    ##
+
+    # Wrapper around a translation unit, to allow for empty input.
+    # Not strictly part of the C99 Grammar, but useful in practice.
+    #
+    def p_translation_unit_or_empty(self, p):
+        """ translation_unit_or_empty   : translation_unit
+                                        | empty
+        """
+        if p[1] is None:
+            p[0] = c_ast.FileAST([])
+        else:
+            p[0] = c_ast.FileAST(p[1])
+
+    def p_translation_unit_1(self, p):
+        """ translation_unit    : external_declaration
+        """
+        # Note: external_declaration is already a list
+        #
+        p[0] = p[1]
+
+    def p_translation_unit_2(self, p):
+        """ translation_unit    : translation_unit external_declaration
+        """
+        p[1].extend(p[2])
+        p[0] = p[1]
+
+    # Declarations always come as lists (because they can be
+    # several in one line), so we wrap the function definition
+    # into a list as well, to make the return value of
+    # external_declaration homogenous.
+    #
+    def p_external_declaration_1(self, p):
+        """ external_declaration    : function_definition
+        """
+        p[0] = [p[1]]
+
+    def p_external_declaration_2(self, p):
+        """ external_declaration    : declaration
+        """
+        p[0] = p[1]
+
+    def p_external_declaration_3(self, p):
+        """ external_declaration    : pp_directive
+                                    | pppragma_directive
+        """
+        p[0] = [p[1]]
+
+    def p_external_declaration_4(self, p):
+        """ external_declaration    : SEMI
+        """
+        p[0] = []
+
+    def p_pp_directive(self, p):
+        """ pp_directive  : PPHASH
+        """
+        self._parse_error('Directives not supported yet',
+                          self._token_coord(p, 1))
+
+    def p_pppragma_directive(self, p):
+        """ pppragma_directive      : PPPRAGMA
+                                    | PPPRAGMA PPPRAGMASTR
+        """
+        if len(p) == 3:
+            p[0] = c_ast.Pragma(p[2], self._token_coord(p, 2))
+        else:
+            p[0] = c_ast.Pragma("", self._token_coord(p, 1))
+
+    # In function definitions, the declarator can be followed by
+    # a declaration list, for old "K&R style" function definitios.
+    #
+    def p_function_definition_1(self, p):
+        """ function_definition : id_declarator declaration_list_opt compound_statement
+        """
+        # no declaration specifiers - 'int' becomes the default type
+        spec = dict(
+            qual=[],
+            storage=[],
+            type=[c_ast.IdentifierType(['int'],
+                                       coord=self._token_coord(p, 1))],
+            function=[])
+
+        p[0] = self._build_function_definition(
+            spec=spec,
+            decl=p[1],
+            param_decls=p[2],
+            body=p[3])
+
+    def p_function_definition_2(self, p):
+        """ function_definition : declaration_specifiers id_declarator declaration_list_opt compound_statement
+        """
+        spec = p[1]
+
+        p[0] = self._build_function_definition(
+            spec=spec,
+            decl=p[2],
+            param_decls=p[3],
+            body=p[4])
+
+    def p_statement(self, p):
+        """ statement   : labeled_statement
+                        | expression_statement
+                        | compound_statement
+                        | selection_statement
+                        | iteration_statement
+                        | jump_statement
+                        | pppragma_directive
+        """
+        p[0] = p[1]
+
+    # A pragma is generally considered a decorator rather than an actual statement.
+    # Still, for the purposes of analyzing an abstract syntax tree of C code,
+    # pragma's should not be ignored and were previously treated as a statement.
+    # This presents a problem for constructs that take a statement such as labeled_statements,
+    # selection_statements, and iteration_statements, causing a misleading structure
+    # in the AST. For example, consider the following C code.
+    #
+    #   for (int i = 0; i < 3; i++)
+    #       #pragma omp critical
+    #       sum += 1;
+    #
+    # This code will compile and execute "sum += 1;" as the body of the for loop.
+    # Previous implementations of PyCParser would render the AST for this
+    # block of code as follows:
+    #
+    #   For:
+    #     DeclList:
+    #       Decl: i, [], [], []
+    #         TypeDecl: i, []
+    #           IdentifierType: ['int']
+    #         Constant: int, 0
+    #     BinaryOp: <
+    #       ID: i
+    #       Constant: int, 3
+    #     UnaryOp: p++
+    #       ID: i
+    #     Pragma: omp critical
+    #   Assignment: +=
+    #     ID: sum
+    #     Constant: int, 1
+    #
+    # This AST misleadingly takes the Pragma as the body of the loop and the
+    # assignment then becomes a sibling of the loop.
+    #
+    # To solve edge cases like these, the pragmacomp_or_statement rule groups
+    # a pragma and its following statement (which would otherwise be orphaned)
+    # using a compound block, effectively turning the above code into:
+    #
+    #   for (int i = 0; i < 3; i++) {
+    #       #pragma omp critical
+    #       sum += 1;
+    #   }
+    def p_pragmacomp_or_statement(self, p):
+        """ pragmacomp_or_statement     : pppragma_directive statement
+                                        | statement
+        """
+        if isinstance(p[1], c_ast.Pragma) and len(p) == 3:
+            p[0] = c_ast.Compound(
+                block_items=[p[1], p[2]],
+                coord=self._token_coord(p, 1))
+        else:
+            p[0] = p[1]
+
+    # In C, declarations can come several in a line:
+    #   int x, *px, romulo = 5;
+    #
+    # However, for the AST, we will split them to separate Decl
+    # nodes.
+    #
+    # This rule splits its declarations and always returns a list
+    # of Decl nodes, even if it's one element long.
+    #
+    def p_decl_body(self, p):
+        """ decl_body : declaration_specifiers init_declarator_list_opt
+                      | declaration_specifiers_no_type id_init_declarator_list_opt
+        """
+        spec = p[1]
+
+        # p[2] (init_declarator_list_opt) is either a list or None
+        #
+        if p[2] is None:
+            # By the standard, you must have at least one declarator unless
+            # declaring a structure tag, a union tag, or the members of an
+            # enumeration.
+            #
+            ty = spec['type']
+            s_u_or_e = (c_ast.Struct, c_ast.Union, c_ast.Enum)
+            if len(ty) == 1 and isinstance(ty[0], s_u_or_e):
+                decls = [c_ast.Decl(
+                    name=None,
+                    quals=spec['qual'],
+                    storage=spec['storage'],
+                    funcspec=spec['function'],
+                    type=ty[0],
+                    init=None,
+                    bitsize=None,
+                    coord=ty[0].coord)]
+
+            # However, this case can also occur on redeclared identifiers in
+            # an inner scope.  The trouble is that the redeclared type's name
+            # gets grouped into declaration_specifiers; _build_declarations
+            # compensates for this.
+            #
+            else:
+                decls = self._build_declarations(
+                    spec=spec,
+                    decls=[dict(decl=None, init=None)],
+                    typedef_namespace=True)
+
+        else:
+            decls = self._build_declarations(
+                spec=spec,
+                decls=p[2],
+                typedef_namespace=True)
+
+        p[0] = decls
+
+    # The declaration has been split to a decl_body sub-rule and
+    # SEMI, because having them in a single rule created a problem
+    # for defining typedefs.
+    #
+    # If a typedef line was directly followed by a line using the
+    # type defined with the typedef, the type would not be
+    # recognized. This is because to reduce the declaration rule,
+    # the parser's lookahead asked for the token after SEMI, which
+    # was the type from the next line, and the lexer had no chance
+    # to see the updated type symbol table.
+    #
+    # Splitting solves this problem, because after seeing SEMI,
+    # the parser reduces decl_body, which actually adds the new
+    # type into the table to be seen by the lexer before the next
+    # line is reached.
+    def p_declaration(self, p):
+        """ declaration : decl_body SEMI
+        """
+        p[0] = p[1]
+
+    # Since each declaration is a list of declarations, this
+    # rule will combine all the declarations and return a single
+    # list
+    #
+    def p_declaration_list(self, p):
+        """ declaration_list    : declaration
+                                | declaration_list declaration
+        """
+        p[0] = p[1] if len(p) == 2 else p[1] + p[2]
+
+    # To know when declaration-specifiers end and declarators begin,
+    # we require declaration-specifiers to have at least one
+    # type-specifier, and disallow typedef-names after we've seen any
+    # type-specifier. These are both required by the spec.
+    #
+    def p_declaration_specifiers_no_type_1(self, p):
+        """ declaration_specifiers_no_type  : type_qualifier declaration_specifiers_no_type_opt
+        """
+        p[0] = self._add_declaration_specifier(p[2], p[1], 'qual')
+
+    def p_declaration_specifiers_no_type_2(self, p):
+        """ declaration_specifiers_no_type  : storage_class_specifier declaration_specifiers_no_type_opt
+        """
+        p[0] = self._add_declaration_specifier(p[2], p[1], 'storage')
+
+    def p_declaration_specifiers_no_type_3(self, p):
+        """ declaration_specifiers_no_type  : function_specifier declaration_specifiers_no_type_opt
+        """
+        p[0] = self._add_declaration_specifier(p[2], p[1], 'function')
+
+
+    def p_declaration_specifiers_1(self, p):
+        """ declaration_specifiers  : declaration_specifiers type_qualifier
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'qual', append=True)
+
+    def p_declaration_specifiers_2(self, p):
+        """ declaration_specifiers  : declaration_specifiers storage_class_specifier
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'storage', append=True)
+
+    def p_declaration_specifiers_3(self, p):
+        """ declaration_specifiers  : declaration_specifiers function_specifier
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'function', append=True)
+
+    def p_declaration_specifiers_4(self, p):
+        """ declaration_specifiers  : declaration_specifiers type_specifier_no_typeid
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'type', append=True)
+
+    def p_declaration_specifiers_5(self, p):
+        """ declaration_specifiers  : type_specifier
+        """
+        p[0] = self._add_declaration_specifier(None, p[1], 'type')
+
+    def p_declaration_specifiers_6(self, p):
+        """ declaration_specifiers  : declaration_specifiers_no_type type_specifier
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'type', append=True)
+
+
+    def p_storage_class_specifier(self, p):
+        """ storage_class_specifier : AUTO
+                                    | REGISTER
+                                    | STATIC
+                                    | EXTERN
+                                    | TYPEDEF
+        """
+        p[0] = p[1]
+
+    def p_function_specifier(self, p):
+        """ function_specifier  : INLINE
+        """
+        p[0] = p[1]
+
+    def p_type_specifier_no_typeid(self, p):
+        """ type_specifier_no_typeid  : VOID
+                                      | _BOOL
+                                      | CHAR
+                                      | SHORT
+                                      | INT
+                                      | LONG
+                                      | FLOAT
+                                      | DOUBLE
+                                      | _COMPLEX
+                                      | SIGNED
+                                      | UNSIGNED
+                                      | __INT128
+        """
+        p[0] = c_ast.IdentifierType([p[1]], coord=self._token_coord(p, 1))
+
+    def p_type_specifier(self, p):
+        """ type_specifier  : typedef_name
+                            | enum_specifier
+                            | struct_or_union_specifier
+                            | type_specifier_no_typeid
+        """
+        p[0] = p[1]
+
+    def p_type_qualifier(self, p):
+        """ type_qualifier  : CONST
+                            | RESTRICT
+                            | VOLATILE
+        """
+        p[0] = p[1]
+
+    def p_init_declarator_list(self, p):
+        """ init_declarator_list    : init_declarator
+                                    | init_declarator_list COMMA init_declarator
+        """
+        p[0] = p[1] + [p[3]] if len(p) == 4 else [p[1]]
+
+    # Returns a {decl=<declarator> : init=<initializer>} dictionary
+    # If there's no initializer, uses None
+    #
+    def p_init_declarator(self, p):
+        """ init_declarator : declarator
+                            | declarator EQUALS initializer
+        """
+        p[0] = dict(decl=p[1], init=(p[3] if len(p) > 2 else None))
+
+    def p_id_init_declarator_list(self, p):
+        """ id_init_declarator_list    : id_init_declarator
+                                       | id_init_declarator_list COMMA init_declarator
+        """
+        p[0] = p[1] + [p[3]] if len(p) == 4 else [p[1]]
+
+    def p_id_init_declarator(self, p):
+        """ id_init_declarator : id_declarator
+                               | id_declarator EQUALS initializer
+        """
+        p[0] = dict(decl=p[1], init=(p[3] if len(p) > 2 else None))
+
+    # Require at least one type specifier in a specifier-qualifier-list
+    #
+    def p_specifier_qualifier_list_1(self, p):
+        """ specifier_qualifier_list    : specifier_qualifier_list type_specifier_no_typeid
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'type', append=True)
+
+    def p_specifier_qualifier_list_2(self, p):
+        """ specifier_qualifier_list    : specifier_qualifier_list type_qualifier
+        """
+        p[0] = self._add_declaration_specifier(p[1], p[2], 'qual', append=True)
+
+    def p_specifier_qualifier_list_3(self, p):
+        """ specifier_qualifier_list  : type_specifier
+        """
+        p[0] = self._add_declaration_specifier(None, p[1], 'type')
+
+    def p_specifier_qualifier_list_4(self, p):
+        """ specifier_qualifier_list  : type_qualifier_list type_specifier
+        """
+        spec = dict(qual=p[1], storage=[], type=[], function=[])
+        p[0] = self._add_declaration_specifier(spec, p[2], 'type', append=True)
+
+    # TYPEID is allowed here (and in other struct/enum related tag names), because
+    # struct/enum tags reside in their own namespace and can be named the same as types
+    #
+    def p_struct_or_union_specifier_1(self, p):
+        """ struct_or_union_specifier   : struct_or_union ID
+                                        | struct_or_union TYPEID
+        """
+        klass = self._select_struct_union_class(p[1])
+        # None means no list of members
+        p[0] = klass(
+            name=p[2],
+            decls=None,
+            coord=self._token_coord(p, 2))
+
+    def p_struct_or_union_specifier_2(self, p):
+        """ struct_or_union_specifier : struct_or_union brace_open struct_declaration_list brace_close
+                                      | struct_or_union brace_open brace_close
+        """
+        klass = self._select_struct_union_class(p[1])
+        if len(p) == 4:
+            # Empty sequence means an empty list of members
+            p[0] = klass(
+                name=None,
+                decls=[],
+                coord=self._token_coord(p, 2))
+        else:
+            p[0] = klass(
+                name=None,
+                decls=p[3],
+                coord=self._token_coord(p, 2))
+
+
+    def p_struct_or_union_specifier_3(self, p):
+        """ struct_or_union_specifier   : struct_or_union ID brace_open struct_declaration_list brace_close
+                                        | struct_or_union ID brace_open brace_close
+                                        | struct_or_union TYPEID brace_open struct_declaration_list brace_close
+                                        | struct_or_union TYPEID brace_open brace_close
+        """
+        klass = self._select_struct_union_class(p[1])
+        if len(p) == 5:
+            # Empty sequence means an empty list of members
+            p[0] = klass(
+                name=p[2],
+                decls=[],
+                coord=self._token_coord(p, 2))
+        else:
+            p[0] = klass(
+                name=p[2],
+                decls=p[4],
+                coord=self._token_coord(p, 2))
+
+    def p_struct_or_union(self, p):
+        """ struct_or_union : STRUCT
+                            | UNION
+        """
+        p[0] = p[1]
+
+    # Combine all declarations into a single list
+    #
+    def p_struct_declaration_list(self, p):
+        """ struct_declaration_list     : struct_declaration
+                                        | struct_declaration_list struct_declaration
+        """
+        if len(p) == 2:
+            p[0] = p[1] or []
+        else:
+            p[0] = p[1] + (p[2] or [])
+
+    def p_struct_declaration_1(self, p):
+        """ struct_declaration : specifier_qualifier_list struct_declarator_list_opt SEMI
+        """
+        spec = p[1]
+        assert 'typedef' not in spec['storage']
+
+        if p[2] is not None:
+            decls = self._build_declarations(
+                spec=spec,
+                decls=p[2])
+
+        elif len(spec['type']) == 1:
+            # Anonymous struct/union, gcc extension, C1x feature.
+            # Although the standard only allows structs/unions here, I see no
+            # reason to disallow other types since some compilers have typedefs
+            # here, and pycparser isn't about rejecting all invalid code.
+            #
+            node = spec['type'][0]
+            if isinstance(node, c_ast.Node):
+                decl_type = node
+            else:
+                decl_type = c_ast.IdentifierType(node)
+
+            decls = self._build_declarations(
+                spec=spec,
+                decls=[dict(decl=decl_type)])
+
+        else:
+            # Structure/union members can have the same names as typedefs.
+            # The trouble is that the member's name gets grouped into
+            # specifier_qualifier_list; _build_declarations compensates.
+            #
+            decls = self._build_declarations(
+                spec=spec,
+                decls=[dict(decl=None, init=None)])
+
+        p[0] = decls
+
+    def p_struct_declaration_2(self, p):
+        """ struct_declaration : SEMI
+        """
+        p[0] = None
+
+    def p_struct_declaration_3(self, p):
+        """ struct_declaration : pppragma_directive
+        """
+        p[0] = [p[1]]
+
+    def p_struct_declarator_list(self, p):
+        """ struct_declarator_list  : struct_declarator
+                                    | struct_declarator_list COMMA struct_declarator
+        """
+        p[0] = p[1] + [p[3]] if len(p) == 4 else [p[1]]
+
+    # struct_declarator passes up a dict with the keys: decl (for
+    # the underlying declarator) and bitsize (for the bitsize)
+    #
+    def p_struct_declarator_1(self, p):
+        """ struct_declarator : declarator
+        """
+        p[0] = {'decl': p[1], 'bitsize': None}
+
+    def p_struct_declarator_2(self, p):
+        """ struct_declarator   : declarator COLON constant_expression
+                                | COLON constant_expression
+        """
+        if len(p) > 3:
+            p[0] = {'decl': p[1], 'bitsize': p[3]}
+        else:
+            p[0] = {'decl': c_ast.TypeDecl(None, None, None), 'bitsize': p[2]}
+
+    def p_enum_specifier_1(self, p):
+        """ enum_specifier  : ENUM ID
+                            | ENUM TYPEID
+        """
+        p[0] = c_ast.Enum(p[2], None, self._token_coord(p, 1))
+
+    def p_enum_specifier_2(self, p):
+        """ enum_specifier  : ENUM brace_open enumerator_list brace_close
+        """
+        p[0] = c_ast.Enum(None, p[3], self._token_coord(p, 1))
+
+    def p_enum_specifier_3(self, p):
+        """ enum_specifier  : ENUM ID brace_open enumerator_list brace_close
+                            | ENUM TYPEID brace_open enumerator_list brace_close
+        """
+        p[0] = c_ast.Enum(p[2], p[4], self._token_coord(p, 1))
+
+    def p_enumerator_list(self, p):
+        """ enumerator_list : enumerator
+                            | enumerator_list COMMA
+                            | enumerator_list COMMA enumerator
+        """
+        if len(p) == 2:
+            p[0] = c_ast.EnumeratorList([p[1]], p[1].coord)
+        elif len(p) == 3:
+            p[0] = p[1]
+        else:
+            p[1].enumerators.append(p[3])
+            p[0] = p[1]
+
+    def p_enumerator(self, p):
+        """ enumerator  : ID
+                        | ID EQUALS constant_expression
+        """
+        if len(p) == 2:
+            enumerator = c_ast.Enumerator(
+                        p[1], None,
+                        self._token_coord(p, 1))
+        else:
+            enumerator = c_ast.Enumerator(
+                        p[1], p[3],
+                        self._token_coord(p, 1))
+        self._add_identifier(enumerator.name, enumerator.coord)
+
+        p[0] = enumerator
+
+    def p_declarator(self, p):
+        """ declarator  : id_declarator
+                        | typeid_declarator
+        """
+        p[0] = p[1]
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_xxx_declarator_1(self, p):
+        """ xxx_declarator  : direct_xxx_declarator
+        """
+        p[0] = p[1]
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_xxx_declarator_2(self, p):
+        """ xxx_declarator  : pointer direct_xxx_declarator
+        """
+        p[0] = self._type_modify_decl(p[2], p[1])
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_direct_xxx_declarator_1(self, p):
+        """ direct_xxx_declarator   : yyy
+        """
+        p[0] = c_ast.TypeDecl(
+            declname=p[1],
+            type=None,
+            quals=None,
+            coord=self._token_coord(p, 1))
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'))
+    def p_direct_xxx_declarator_2(self, p):
+        """ direct_xxx_declarator   : LPAREN xxx_declarator RPAREN
+        """
+        p[0] = p[2]
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_direct_xxx_declarator_3(self, p):
+        """ direct_xxx_declarator   : direct_xxx_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET
+        """
+        quals = (p[3] if len(p) > 5 else []) or []
+        # Accept dimension qualifiers
+        # Per C99 6.7.5.3 p7
+        arr = c_ast.ArrayDecl(
+            type=None,
+            dim=p[4] if len(p) > 5 else p[3],
+            dim_quals=quals,
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=arr)
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_direct_xxx_declarator_4(self, p):
+        """ direct_xxx_declarator   : direct_xxx_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET
+                                    | direct_xxx_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET
+        """
+        # Using slice notation for PLY objects doesn't work in Python 3 for the
+        # version of PLY embedded with pycparser; see PLY Google Code issue 30.
+        # Work around that here by listing the two elements separately.
+        listed_quals = [item if isinstance(item, list) else [item]
+            for item in [p[3],p[4]]]
+        dim_quals = [qual for sublist in listed_quals for qual in sublist
+            if qual is not None]
+        arr = c_ast.ArrayDecl(
+            type=None,
+            dim=p[5],
+            dim_quals=dim_quals,
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=arr)
+
+    # Special for VLAs
+    #
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_direct_xxx_declarator_5(self, p):
+        """ direct_xxx_declarator   : direct_xxx_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET
+        """
+        arr = c_ast.ArrayDecl(
+            type=None,
+            dim=c_ast.ID(p[4], self._token_coord(p, 4)),
+            dim_quals=p[3] if p[3] != None else [],
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=arr)
+
+    @parameterized(('id', 'ID'), ('typeid', 'TYPEID'), ('typeid_noparen', 'TYPEID'))
+    def p_direct_xxx_declarator_6(self, p):
+        """ direct_xxx_declarator   : direct_xxx_declarator LPAREN parameter_type_list RPAREN
+                                    | direct_xxx_declarator LPAREN identifier_list_opt RPAREN
+        """
+        func = c_ast.FuncDecl(
+            args=p[3],
+            type=None,
+            coord=p[1].coord)
+
+        # To see why _get_yacc_lookahead_token is needed, consider:
+        #   typedef char TT;
+        #   void foo(int TT) { TT = 10; }
+        # Outside the function, TT is a typedef, but inside (starting and
+        # ending with the braces) it's a parameter.  The trouble begins with
+        # yacc's lookahead token.  We don't know if we're declaring or
+        # defining a function until we see LBRACE, but if we wait for yacc to
+        # trigger a rule on that token, then TT will have already been read
+        # and incorrectly interpreted as TYPEID.  We need to add the
+        # parameters to the scope the moment the lexer sees LBRACE.
+        #
+        if self._get_yacc_lookahead_token().type == "LBRACE":
+            if func.args is not None:
+                for param in func.args.params:
+                    if isinstance(param, c_ast.EllipsisParam): break
+                    self._add_identifier(param.name, param.coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=func)
+
+    def p_pointer(self, p):
+        """ pointer : TIMES type_qualifier_list_opt
+                    | TIMES type_qualifier_list_opt pointer
+        """
+        coord = self._token_coord(p, 1)
+        # Pointer decls nest from inside out. This is important when different
+        # levels have different qualifiers. For example:
+        #
+        #  char * const * p;
+        #
+        # Means "pointer to const pointer to char"
+        #
+        # While:
+        #
+        #  char ** const p;
+        #
+        # Means "const pointer to pointer to char"
+        #
+        # So when we construct PtrDecl nestings, the leftmost pointer goes in
+        # as the most nested type.
+        nested_type = c_ast.PtrDecl(quals=p[2] or [], type=None, coord=coord)
+        if len(p) > 3:
+            tail_type = p[3]
+            while tail_type.type is not None:
+                tail_type = tail_type.type
+            tail_type.type = nested_type
+            p[0] = p[3]
+        else:
+            p[0] = nested_type
+
+    def p_type_qualifier_list(self, p):
+        """ type_qualifier_list : type_qualifier
+                                | type_qualifier_list type_qualifier
+        """
+        p[0] = [p[1]] if len(p) == 2 else p[1] + [p[2]]
+
+    def p_parameter_type_list(self, p):
+        """ parameter_type_list : parameter_list
+                                | parameter_list COMMA ELLIPSIS
+        """
+        if len(p) > 2:
+            p[1].params.append(c_ast.EllipsisParam(self._token_coord(p, 3)))
+
+        p[0] = p[1]
+
+    def p_parameter_list(self, p):
+        """ parameter_list  : parameter_declaration
+                            | parameter_list COMMA parameter_declaration
+        """
+        if len(p) == 2: # single parameter
+            p[0] = c_ast.ParamList([p[1]], p[1].coord)
+        else:
+            p[1].params.append(p[3])
+            p[0] = p[1]
+
+    # From ISO/IEC 9899:TC2, 6.7.5.3.11:
+    # "If, in a parameter declaration, an identifier can be treated either
+    #  as a typedef name or as a parameter name, it shall be taken as a
+    #  typedef name."
+    #
+    # Inside a parameter declaration, once we've reduced declaration specifiers,
+    # if we shift in an LPAREN and see a TYPEID, it could be either an abstract
+    # declarator or a declarator nested inside parens. This rule tells us to
+    # always treat it as an abstract declarator. Therefore, we only accept
+    # `id_declarator`s and `typeid_noparen_declarator`s.
+    def p_parameter_declaration_1(self, p):
+        """ parameter_declaration   : declaration_specifiers id_declarator
+                                    | declaration_specifiers typeid_noparen_declarator
+        """
+        spec = p[1]
+        if not spec['type']:
+            spec['type'] = [c_ast.IdentifierType(['int'],
+                coord=self._token_coord(p, 1))]
+        p[0] = self._build_declarations(
+            spec=spec,
+            decls=[dict(decl=p[2])])[0]
+
+    def p_parameter_declaration_2(self, p):
+        """ parameter_declaration   : declaration_specifiers abstract_declarator_opt
+        """
+        spec = p[1]
+        if not spec['type']:
+            spec['type'] = [c_ast.IdentifierType(['int'],
+                coord=self._token_coord(p, 1))]
+
+        # Parameters can have the same names as typedefs.  The trouble is that
+        # the parameter's name gets grouped into declaration_specifiers, making
+        # it look like an old-style declaration; compensate.
+        #
+        if len(spec['type']) > 1 and len(spec['type'][-1].names) == 1 and \
+                self._is_type_in_scope(spec['type'][-1].names[0]):
+            decl = self._build_declarations(
+                    spec=spec,
+                    decls=[dict(decl=p[2], init=None)])[0]
+
+        # This truly is an old-style parameter declaration
+        #
+        else:
+            decl = c_ast.Typename(
+                name='',
+                quals=spec['qual'],
+                type=p[2] or c_ast.TypeDecl(None, None, None),
+                coord=self._token_coord(p, 2))
+            typename = spec['type']
+            decl = self._fix_decl_name_type(decl, typename)
+
+        p[0] = decl
+
+    def p_identifier_list(self, p):
+        """ identifier_list : identifier
+                            | identifier_list COMMA identifier
+        """
+        if len(p) == 2: # single parameter
+            p[0] = c_ast.ParamList([p[1]], p[1].coord)
+        else:
+            p[1].params.append(p[3])
+            p[0] = p[1]
+
+    def p_initializer_1(self, p):
+        """ initializer : assignment_expression
+        """
+        p[0] = p[1]
+
+    def p_initializer_2(self, p):
+        """ initializer : brace_open initializer_list_opt brace_close
+                        | brace_open initializer_list COMMA brace_close
+        """
+        if p[2] is None:
+            p[0] = c_ast.InitList([], self._token_coord(p, 1))
+        else:
+            p[0] = p[2]
+
+    def p_initializer_list(self, p):
+        """ initializer_list    : designation_opt initializer
+                                | initializer_list COMMA designation_opt initializer
+        """
+        if len(p) == 3: # single initializer
+            init = p[2] if p[1] is None else c_ast.NamedInitializer(p[1], p[2])
+            p[0] = c_ast.InitList([init], p[2].coord)
+        else:
+            init = p[4] if p[3] is None else c_ast.NamedInitializer(p[3], p[4])
+            p[1].exprs.append(init)
+            p[0] = p[1]
+
+    def p_designation(self, p):
+        """ designation : designator_list EQUALS
+        """
+        p[0] = p[1]
+
+    # Designators are represented as a list of nodes, in the order in which
+    # they're written in the code.
+    #
+    def p_designator_list(self, p):
+        """ designator_list : designator
+                            | designator_list designator
+        """
+        p[0] = [p[1]] if len(p) == 2 else p[1] + [p[2]]
+
+    def p_designator(self, p):
+        """ designator  : LBRACKET constant_expression RBRACKET
+                        | PERIOD identifier
+        """
+        p[0] = p[2]
+
+    def p_type_name(self, p):
+        """ type_name   : specifier_qualifier_list abstract_declarator_opt
+        """
+        typename = c_ast.Typename(
+            name='',
+            quals=p[1]['qual'],
+            type=p[2] or c_ast.TypeDecl(None, None, None),
+            coord=self._token_coord(p, 2))
+
+        p[0] = self._fix_decl_name_type(typename, p[1]['type'])
+
+    def p_abstract_declarator_1(self, p):
+        """ abstract_declarator     : pointer
+        """
+        dummytype = c_ast.TypeDecl(None, None, None)
+        p[0] = self._type_modify_decl(
+            decl=dummytype,
+            modifier=p[1])
+
+    def p_abstract_declarator_2(self, p):
+        """ abstract_declarator     : pointer direct_abstract_declarator
+        """
+        p[0] = self._type_modify_decl(p[2], p[1])
+
+    def p_abstract_declarator_3(self, p):
+        """ abstract_declarator     : direct_abstract_declarator
+        """
+        p[0] = p[1]
+
+    # Creating and using direct_abstract_declarator_opt here
+    # instead of listing both direct_abstract_declarator and the
+    # lack of it in the beginning of _1 and _2 caused two
+    # shift/reduce errors.
+    #
+    def p_direct_abstract_declarator_1(self, p):
+        """ direct_abstract_declarator  : LPAREN abstract_declarator RPAREN """
+        p[0] = p[2]
+
+    def p_direct_abstract_declarator_2(self, p):
+        """ direct_abstract_declarator  : direct_abstract_declarator LBRACKET assignment_expression_opt RBRACKET
+        """
+        arr = c_ast.ArrayDecl(
+            type=None,
+            dim=p[3],
+            dim_quals=[],
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=arr)
+
+    def p_direct_abstract_declarator_3(self, p):
+        """ direct_abstract_declarator  : LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET
+        """
+        quals = (p[2] if len(p) > 4 else []) or []
+        p[0] = c_ast.ArrayDecl(
+            type=c_ast.TypeDecl(None, None, None),
+            dim=p[3] if len(p) > 4 else p[2],
+            dim_quals=quals,
+            coord=self._token_coord(p, 1))
+
+    def p_direct_abstract_declarator_4(self, p):
+        """ direct_abstract_declarator  : direct_abstract_declarator LBRACKET TIMES RBRACKET
+        """
+        arr = c_ast.ArrayDecl(
+            type=None,
+            dim=c_ast.ID(p[3], self._token_coord(p, 3)),
+            dim_quals=[],
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=arr)
+
+    def p_direct_abstract_declarator_5(self, p):
+        """ direct_abstract_declarator  : LBRACKET TIMES RBRACKET
+        """
+        p[0] = c_ast.ArrayDecl(
+            type=c_ast.TypeDecl(None, None, None),
+            dim=c_ast.ID(p[3], self._token_coord(p, 3)),
+            dim_quals=[],
+            coord=self._token_coord(p, 1))
+
+    def p_direct_abstract_declarator_6(self, p):
+        """ direct_abstract_declarator  : direct_abstract_declarator LPAREN parameter_type_list_opt RPAREN
+        """
+        func = c_ast.FuncDecl(
+            args=p[3],
+            type=None,
+            coord=p[1].coord)
+
+        p[0] = self._type_modify_decl(decl=p[1], modifier=func)
+
+    def p_direct_abstract_declarator_7(self, p):
+        """ direct_abstract_declarator  : LPAREN parameter_type_list_opt RPAREN
+        """
+        p[0] = c_ast.FuncDecl(
+            args=p[2],
+            type=c_ast.TypeDecl(None, None, None),
+            coord=self._token_coord(p, 1))
+
+    # declaration is a list, statement isn't. To make it consistent, block_item
+    # will always be a list
+    #
+    def p_block_item(self, p):
+        """ block_item  : declaration
+                        | statement
+        """
+        p[0] = p[1] if isinstance(p[1], list) else [p[1]]
+
+    # Since we made block_item a list, this just combines lists
+    #
+    def p_block_item_list(self, p):
+        """ block_item_list : block_item
+                            | block_item_list block_item
+        """
+        # Empty block items (plain ';') produce [None], so ignore them
+        p[0] = p[1] if (len(p) == 2 or p[2] == [None]) else p[1] + p[2]
+
+    def p_compound_statement_1(self, p):
+        """ compound_statement : brace_open block_item_list_opt brace_close """
+        p[0] = c_ast.Compound(
+            block_items=p[2],
+            coord=self._token_coord(p, 1))
+
+    def p_labeled_statement_1(self, p):
+        """ labeled_statement : ID COLON pragmacomp_or_statement """
+        p[0] = c_ast.Label(p[1], p[3], self._token_coord(p, 1))
+
+    def p_labeled_statement_2(self, p):
+        """ labeled_statement : CASE constant_expression COLON pragmacomp_or_statement """
+        p[0] = c_ast.Case(p[2], [p[4]], self._token_coord(p, 1))
+
+    def p_labeled_statement_3(self, p):
+        """ labeled_statement : DEFAULT COLON pragmacomp_or_statement """
+        p[0] = c_ast.Default([p[3]], self._token_coord(p, 1))
+
+    def p_selection_statement_1(self, p):
+        """ selection_statement : IF LPAREN expression RPAREN pragmacomp_or_statement """
+        p[0] = c_ast.If(p[3], p[5], None, self._token_coord(p, 1))
+
+    def p_selection_statement_2(self, p):
+        """ selection_statement : IF LPAREN expression RPAREN statement ELSE pragmacomp_or_statement """
+        p[0] = c_ast.If(p[3], p[5], p[7], self._token_coord(p, 1))
+
+    def p_selection_statement_3(self, p):
+        """ selection_statement : SWITCH LPAREN expression RPAREN pragmacomp_or_statement """
+        p[0] = fix_switch_cases(
+                c_ast.Switch(p[3], p[5], self._token_coord(p, 1)))
+
+    def p_iteration_statement_1(self, p):
+        """ iteration_statement : WHILE LPAREN expression RPAREN pragmacomp_or_statement """
+        p[0] = c_ast.While(p[3], p[5], self._token_coord(p, 1))
+
+    def p_iteration_statement_2(self, p):
+        """ iteration_statement : DO pragmacomp_or_statement WHILE LPAREN expression RPAREN SEMI """
+        p[0] = c_ast.DoWhile(p[5], p[2], self._token_coord(p, 1))
+
+    def p_iteration_statement_3(self, p):
+        """ iteration_statement : FOR LPAREN expression_opt SEMI expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement """
+        p[0] = c_ast.For(p[3], p[5], p[7], p[9], self._token_coord(p, 1))
+
+    def p_iteration_statement_4(self, p):
+        """ iteration_statement : FOR LPAREN declaration expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement """
+        p[0] = c_ast.For(c_ast.DeclList(p[3], self._token_coord(p, 1)),
+                         p[4], p[6], p[8], self._token_coord(p, 1))
+
+    def p_jump_statement_1(self, p):
+        """ jump_statement  : GOTO ID SEMI """
+        p[0] = c_ast.Goto(p[2], self._token_coord(p, 1))
+
+    def p_jump_statement_2(self, p):
+        """ jump_statement  : BREAK SEMI """
+        p[0] = c_ast.Break(self._token_coord(p, 1))
+
+    def p_jump_statement_3(self, p):
+        """ jump_statement  : CONTINUE SEMI """
+        p[0] = c_ast.Continue(self._token_coord(p, 1))
+
+    def p_jump_statement_4(self, p):
+        """ jump_statement  : RETURN expression SEMI
+                            | RETURN SEMI
+        """
+        p[0] = c_ast.Return(p[2] if len(p) == 4 else None, self._token_coord(p, 1))
+
+    def p_expression_statement(self, p):
+        """ expression_statement : expression_opt SEMI """
+        if p[1] is None:
+            p[0] = c_ast.EmptyStatement(self._token_coord(p, 2))
+        else:
+            p[0] = p[1]
+
+    def p_expression(self, p):
+        """ expression  : assignment_expression
+                        | expression COMMA assignment_expression
+        """
+        if len(p) == 2:
+            p[0] = p[1]
+        else:
+            if not isinstance(p[1], c_ast.ExprList):
+                p[1] = c_ast.ExprList([p[1]], p[1].coord)
+
+            p[1].exprs.append(p[3])
+            p[0] = p[1]
+
+    def p_typedef_name(self, p):
+        """ typedef_name : TYPEID """
+        p[0] = c_ast.IdentifierType([p[1]], coord=self._token_coord(p, 1))
+
+    def p_assignment_expression(self, p):
+        """ assignment_expression   : conditional_expression
+                                    | unary_expression assignment_operator assignment_expression
+        """
+        if len(p) == 2:
+            p[0] = p[1]
+        else:
+            p[0] = c_ast.Assignment(p[2], p[1], p[3], p[1].coord)
+
+    # K&R2 defines these as many separate rules, to encode
+    # precedence and associativity. Why work hard ? I'll just use
+    # the built in precedence/associativity specification feature
+    # of PLY. (see precedence declaration above)
+    #
+    def p_assignment_operator(self, p):
+        """ assignment_operator : EQUALS
+                                | XOREQUAL
+                                | TIMESEQUAL
+                                | DIVEQUAL
+                                | MODEQUAL
+                                | PLUSEQUAL
+                                | MINUSEQUAL
+                                | LSHIFTEQUAL
+                                | RSHIFTEQUAL
+                                | ANDEQUAL
+                                | OREQUAL
+        """
+        p[0] = p[1]
+
+    def p_constant_expression(self, p):
+        """ constant_expression : conditional_expression """
+        p[0] = p[1]
+
+    def p_conditional_expression(self, p):
+        """ conditional_expression  : binary_expression
+                                    | binary_expression CONDOP expression COLON conditional_expression
+        """
+        if len(p) == 2:
+            p[0] = p[1]
+        else:
+            p[0] = c_ast.TernaryOp(p[1], p[3], p[5], p[1].coord)
+
+    def p_binary_expression(self, p):
+        """ binary_expression   : cast_expression
+                                | binary_expression TIMES binary_expression
+                                | binary_expression DIVIDE binary_expression
+                                | binary_expression MOD binary_expression
+                                | binary_expression PLUS binary_expression
+                                | binary_expression MINUS binary_expression
+                                | binary_expression RSHIFT binary_expression
+                                | binary_expression LSHIFT binary_expression
+                                | binary_expression LT binary_expression
+                                | binary_expression LE binary_expression
+                                | binary_expression GE binary_expression
+                                | binary_expression GT binary_expression
+                                | binary_expression EQ binary_expression
+                                | binary_expression NE binary_expression
+                                | binary_expression AND binary_expression
+                                | binary_expression OR binary_expression
+                                | binary_expression XOR binary_expression
+                                | binary_expression LAND binary_expression
+                                | binary_expression LOR binary_expression
+        """
+        if len(p) == 2:
+            p[0] = p[1]
+        else:
+            p[0] = c_ast.BinaryOp(p[2], p[1], p[3], p[1].coord)
+
+    def p_cast_expression_1(self, p):
+        """ cast_expression : unary_expression """
+        p[0] = p[1]
+
+    def p_cast_expression_2(self, p):
+        """ cast_expression : LPAREN type_name RPAREN cast_expression """
+        p[0] = c_ast.Cast(p[2], p[4], self._token_coord(p, 1))
+
+    def p_unary_expression_1(self, p):
+        """ unary_expression    : postfix_expression """
+        p[0] = p[1]
+
+    def p_unary_expression_2(self, p):
+        """ unary_expression    : PLUSPLUS unary_expression
+                                | MINUSMINUS unary_expression
+                                | unary_operator cast_expression
+        """
+        p[0] = c_ast.UnaryOp(p[1], p[2], p[2].coord)
+
+    def p_unary_expression_3(self, p):
+        """ unary_expression    : SIZEOF unary_expression
+                                | SIZEOF LPAREN type_name RPAREN
+        """
+        p[0] = c_ast.UnaryOp(
+            p[1],
+            p[2] if len(p) == 3 else p[3],
+            self._token_coord(p, 1))
+
+    def p_unary_operator(self, p):
+        """ unary_operator  : AND
+                            | TIMES
+                            | PLUS
+                            | MINUS
+                            | NOT
+                            | LNOT
+        """
+        p[0] = p[1]
+
+    def p_postfix_expression_1(self, p):
+        """ postfix_expression  : primary_expression """
+        p[0] = p[1]
+
+    def p_postfix_expression_2(self, p):
+        """ postfix_expression  : postfix_expression LBRACKET expression RBRACKET """
+        p[0] = c_ast.ArrayRef(p[1], p[3], p[1].coord)
+
+    def p_postfix_expression_3(self, p):
+        """ postfix_expression  : postfix_expression LPAREN argument_expression_list RPAREN
+                                | postfix_expression LPAREN RPAREN
+        """
+        p[0] = c_ast.FuncCall(p[1], p[3] if len(p) == 5 else None, p[1].coord)
+
+    def p_postfix_expression_4(self, p):
+        """ postfix_expression  : postfix_expression PERIOD ID
+                                | postfix_expression PERIOD TYPEID
+                                | postfix_expression ARROW ID
+                                | postfix_expression ARROW TYPEID
+        """
+        field = c_ast.ID(p[3], self._token_coord(p, 3))
+        p[0] = c_ast.StructRef(p[1], p[2], field, p[1].coord)
+
+    def p_postfix_expression_5(self, p):
+        """ postfix_expression  : postfix_expression PLUSPLUS
+                                | postfix_expression MINUSMINUS
+        """
+        p[0] = c_ast.UnaryOp('p' + p[2], p[1], p[1].coord)
+
+    def p_postfix_expression_6(self, p):
+        """ postfix_expression  : LPAREN type_name RPAREN brace_open initializer_list brace_close
+                                | LPAREN type_name RPAREN brace_open initializer_list COMMA brace_close
+        """
+        p[0] = c_ast.CompoundLiteral(p[2], p[5])
+
+    def p_primary_expression_1(self, p):
+        """ primary_expression  : identifier """
+        p[0] = p[1]
+
+    def p_primary_expression_2(self, p):
+        """ primary_expression  : constant """
+        p[0] = p[1]
+
+    def p_primary_expression_3(self, p):
+        """ primary_expression  : unified_string_literal
+                                | unified_wstring_literal
+        """
+        p[0] = p[1]
+
+    def p_primary_expression_4(self, p):
+        """ primary_expression  : LPAREN expression RPAREN """
+        p[0] = p[2]
+
+    def p_primary_expression_5(self, p):
+        """ primary_expression  : OFFSETOF LPAREN type_name COMMA offsetof_member_designator RPAREN
+        """
+        coord = self._token_coord(p, 1)
+        p[0] = c_ast.FuncCall(c_ast.ID(p[1], coord),
+                              c_ast.ExprList([p[3], p[5]], coord),
+                              coord)
+
+    def p_offsetof_member_designator(self, p):
+        """ offsetof_member_designator : identifier
+                                         | offsetof_member_designator PERIOD identifier
+                                         | offsetof_member_designator LBRACKET expression RBRACKET
+        """
+        if len(p) == 2:
+            p[0] = p[1]
+        elif len(p) == 4:
+            p[0] = c_ast.StructRef(p[1], p[2], p[3], p[1].coord)
+        elif len(p) == 5:
+            p[0] = c_ast.ArrayRef(p[1], p[3], p[1].coord)
+        else:
+            raise NotImplementedError("Unexpected parsing state. len(p): %u" % len(p))
+
+    def p_argument_expression_list(self, p):
+        """ argument_expression_list    : assignment_expression
+                                        | argument_expression_list COMMA assignment_expression
+        """
+        if len(p) == 2: # single expr
+            p[0] = c_ast.ExprList([p[1]], p[1].coord)
+        else:
+            p[1].exprs.append(p[3])
+            p[0] = p[1]
+
+    def p_identifier(self, p):
+        """ identifier  : ID """
+        p[0] = c_ast.ID(p[1], self._token_coord(p, 1))
+
+    def p_constant_1(self, p):
+        """ constant    : INT_CONST_DEC
+                        | INT_CONST_OCT
+                        | INT_CONST_HEX
+                        | INT_CONST_BIN
+                        | INT_CONST_CHAR
+        """
+        uCount = 0
+        lCount = 0
+        for x in p[1][-3:]:
+            if x in ('l', 'L'):
+                lCount += 1
+            elif x in ('u', 'U'):
+                uCount += 1
+        t = ''
+        if uCount > 1:
+             raise ValueError('Constant cannot have more than one u/U suffix.')
+        elif lCount > 2:
+             raise ValueError('Constant cannot have more than two l/L suffix.')
+        prefix = 'unsigned ' * uCount + 'long ' * lCount
+        p[0] = c_ast.Constant(
+            prefix + 'int', p[1], self._token_coord(p, 1))
+
+    def p_constant_2(self, p):
+        """ constant    : FLOAT_CONST
+                        | HEX_FLOAT_CONST
+        """
+        if 'x' in p[1].lower():
+            t = 'float'
+        else:
+            if p[1][-1] in ('f', 'F'):
+                t = 'float'
+            elif p[1][-1] in ('l', 'L'):
+                t = 'long double'
+            else:
+                t = 'double'
+
+        p[0] = c_ast.Constant(
+            t, p[1], self._token_coord(p, 1))
+
+    def p_constant_3(self, p):
+        """ constant    : CHAR_CONST
+                        | WCHAR_CONST
+        """
+        p[0] = c_ast.Constant(
+            'char', p[1], self._token_coord(p, 1))
+
+    # The "unified" string and wstring literal rules are for supporting
+    # concatenation of adjacent string literals.
+    # I.e. "hello " "world" is seen by the C compiler as a single string literal
+    # with the value "hello world"
+    #
+    def p_unified_string_literal(self, p):
+        """ unified_string_literal  : STRING_LITERAL
+                                    | unified_string_literal STRING_LITERAL
+        """
+        if len(p) == 2: # single literal
+            p[0] = c_ast.Constant(
+                'string', p[1], self._token_coord(p, 1))
+        else:
+            p[1].value = p[1].value[:-1] + p[2][1:]
+            p[0] = p[1]
+
+    def p_unified_wstring_literal(self, p):
+        """ unified_wstring_literal : WSTRING_LITERAL
+                                    | unified_wstring_literal WSTRING_LITERAL
+        """
+        if len(p) == 2: # single literal
+            p[0] = c_ast.Constant(
+                'string', p[1], self._token_coord(p, 1))
+        else:
+            p[1].value = p[1].value.rstrip()[:-1] + p[2][2:]
+            p[0] = p[1]
+
+    def p_brace_open(self, p):
+        """ brace_open  :   LBRACE
+        """
+        p[0] = p[1]
+        p.set_lineno(0, p.lineno(1))
+
+    def p_brace_close(self, p):
+        """ brace_close :   RBRACE
+        """
+        p[0] = p[1]
+        p.set_lineno(0, p.lineno(1))
+
+    def p_empty(self, p):
+        'empty : '
+        p[0] = None
+
+    def p_error(self, p):
+        # If error recovery is added here in the future, make sure
+        # _get_yacc_lookahead_token still works!
+        #
+        if p:
+            self._parse_error(
+                'before: %s' % p.value,
+                self._coord(lineno=p.lineno,
+                            column=self.clex.find_tok_column(p)))
+        else:
+            self._parse_error('At end of input', self.clex.filename)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/lextab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/lextab.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb3ae07d5d372198fe147ad2f30a5658448aad33
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/lextab.py
@@ -0,0 +1,10 @@
+# lextab.py. This file automatically created by PLY (version 3.10). Don't edit!
+_tabversion   = '3.10'
+_lextokens    = set(('VOID', 'LBRACKET', 'WCHAR_CONST', 'FLOAT_CONST', 'MINUS', 'RPAREN', 'LONG', 'PLUS', 'ELLIPSIS', 'GT', 'GOTO', 'ENUM', 'PERIOD', 'GE', 'INT_CONST_DEC', 'ARROW', '__INT128', 'HEX_FLOAT_CONST', 'DOUBLE', 'MINUSEQUAL', 'INT_CONST_OCT', 'TIMESEQUAL', 'OR', 'SHORT', 'RETURN', 'RSHIFTEQUAL', 'RESTRICT', 'STATIC', 'SIZEOF', 'UNSIGNED', 'UNION', 'COLON', 'WSTRING_LITERAL', 'DIVIDE', 'FOR', 'PLUSPLUS', 'EQUALS', 'ELSE', 'INLINE', 'EQ', 'AND', 'TYPEID', 'LBRACE', 'PPHASH', 'INT', 'SIGNED', 'CONTINUE', 'NOT', 'OREQUAL', 'MOD', 'RSHIFT', 'DEFAULT', 'CHAR', 'WHILE', 'DIVEQUAL', 'EXTERN', 'CASE', 'LAND', 'REGISTER', 'MODEQUAL', 'NE', 'SWITCH', 'INT_CONST_HEX', '_COMPLEX', 'PPPRAGMASTR', 'PLUSEQUAL', 'STRUCT', 'CONDOP', 'BREAK', 'VOLATILE', 'PPPRAGMA', 'ANDEQUAL', 'INT_CONST_BIN', 'DO', 'LNOT', 'CONST', 'LOR', 'CHAR_CONST', 'LSHIFT', 'RBRACE', '_BOOL', 'LE', 'SEMI', 'LT', 'COMMA', 'OFFSETOF', 'TYPEDEF', 'XOR', 'AUTO', 'TIMES', 'LPAREN', 'MINUSMINUS', 'ID', 'IF', 'STRING_LITERAL', 'FLOAT', 'XOREQUAL', 'LSHIFTEQUAL', 'RBRACKET'))
+_lexreflags   = 64
+_lexliterals  = ''
+_lexstateinfo = {'ppline': 'exclusive', 'pppragma': 'exclusive', 'INITIAL': 'inclusive'}
+_lexstatere   = {'ppline': [('(?P<t_ppline_FILENAME>"([^"\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*")|(?P<t_ppline_LINE_NUMBER>(0(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?)|([1-9][0-9]*(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?))|(?P<t_ppline_NEWLINE>\\n)|(?P<t_ppline_PPLINE>line)', [None, ('t_ppline_FILENAME', 'FILENAME'), None, None, None, None, None, None, ('t_ppline_LINE_NUMBER', 'LINE_NUMBER'), None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, ('t_ppline_NEWLINE', 'NEWLINE'), ('t_ppline_PPLINE', 'PPLINE')])], 'pppragma': [('(?P<t_pppragma_NEWLINE>\\n)|(?P<t_pppragma_PPPRAGMA>pragma)|(?P<t_pppragma_STR>.+)', [None, ('t_pppragma_NEWLINE', 'NEWLINE'), ('t_pppragma_PPPRAGMA', 'PPPRAGMA'), ('t_pppragma_STR', 'STR')])], 'INITIAL': [('(?P<t_PPHASH>[ \\t]*\\#)|(?P<t_NEWLINE>\\n+)|(?P<t_LBRACE>\\{)|(?P<t_RBRACE>\\})|(?P<t_FLOAT_CONST>((((([0-9]*\\.[0-9]+)|([0-9]+\\.))([eE][-+]?[0-9]+)?)|([0-9]+([eE][-+]?[0-9]+)))[FfLl]?))|(?P<t_HEX_FLOAT_CONST>(0[xX]([0-9a-fA-F]+|((([0-9a-fA-F]+)?\\.[0-9a-fA-F]+)|([0-9a-fA-F]+\\.)))([pP][+-]?[0-9]+)[FfLl]?))|(?P<t_INT_CONST_HEX>0[xX][0-9a-fA-F]+(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?)', [None, ('t_PPHASH', 'PPHASH'), ('t_NEWLINE', 'NEWLINE'), ('t_LBRACE', 'LBRACE'), ('t_RBRACE', 'RBRACE'), ('t_FLOAT_CONST', 'FLOAT_CONST'), None, None, None, None, None, None, None, None, None, ('t_HEX_FLOAT_CONST', 'HEX_FLOAT_CONST'), None, None, None, None, None, None, None, ('t_INT_CONST_HEX', 'INT_CONST_HEX')]), ('(?P<t_INT_CONST_BIN>0[bB][01]+(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?)|(?P<t_BAD_CONST_OCT>0[0-7]*[89])|(?P<t_INT_CONST_OCT>0[0-7]*(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?)|(?P<t_INT_CONST_DEC>(0(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?)|([1-9][0-9]*(([uU]ll)|([uU]LL)|(ll[uU]?)|(LL[uU]?)|([uU][lL])|([lL][uU]?)|[uU])?))|(?P<t_CHAR_CONST>\'([^\'\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))\')|(?P<t_WCHAR_CONST>L\'([^\'\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))\')|(?P<t_UNMATCHED_QUOTE>(\'([^\'\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*\\n)|(\'([^\'\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*$))|(?P<t_BAD_CHAR_CONST>(\'([^\'\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))[^\'\n]+\')|(\'\')|(\'([\\\\][^a-zA-Z._~^!=&\\^\\-\\\\?\'"x0-7])[^\'\\n]*\'))', [None, ('t_INT_CONST_BIN', 'INT_CONST_BIN'), None, None, None, None, None, None, None, ('t_BAD_CONST_OCT', 'BAD_CONST_OCT'), ('t_INT_CONST_OCT', 'INT_CONST_OCT'), None, None, None, None, None, None, None, ('t_INT_CONST_DEC', 'INT_CONST_DEC'), None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, None, ('t_CHAR_CONST', 'CHAR_CONST'), None, None, None, None, None, None, ('t_WCHAR_CONST', 'WCHAR_CONST'), None, None, None, None, None, None, ('t_UNMATCHED_QUOTE', 'UNMATCHED_QUOTE'), None, None, None, None, None, None, None, None, None, None, None, None, None, None, ('t_BAD_CHAR_CONST', 'BAD_CHAR_CONST')]), ('(?P<t_WSTRING_LITERAL>L"([^"\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*")|(?P<t_BAD_STRING_LITERAL>"([^"\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*?([\\\\][^a-zA-Z._~^!=&\\^\\-\\\\?\'"x0-7])([^"\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*")|(?P<t_ID>[a-zA-Z_$][0-9a-zA-Z_$]*)|(?P<t_STRING_LITERAL>"([^"\\\\\\n]|(\\\\(([a-zA-Z._~!=&\\^\\-\\\\?\'"])|(\\d+)|(x[0-9a-fA-F]+))))*")|(?P<t_ELLIPSIS>\\.\\.\\.)|(?P<t_PLUSPLUS>\\+\\+)|(?P<t_LOR>\\|\\|)|(?P<t_XOREQUAL>\\^=)|(?P<t_OREQUAL>\\|=)|(?P<t_LSHIFTEQUAL><<=)|(?P<t_RSHIFTEQUAL>>>=)|(?P<t_PLUSEQUAL>\\+=)|(?P<t_TIMESEQUAL>\\*=)|(?P<t_PLUS>\\+)|(?P<t_MODEQUAL>%=)|(?P<t_DIVEQUAL>/=)', [None, ('t_WSTRING_LITERAL', 'WSTRING_LITERAL'), None, None, None, None, None, None, ('t_BAD_STRING_LITERAL', 'BAD_STRING_LITERAL'), None, None, None, None, None, None, None, None, None, None, None, None, None, ('t_ID', 'ID'), (None, 'STRING_LITERAL'), None, None, None, None, None, None, (None, 'ELLIPSIS'), (None, 'PLUSPLUS'), (None, 'LOR'), (None, 'XOREQUAL'), (None, 'OREQUAL'), (None, 'LSHIFTEQUAL'), (None, 'RSHIFTEQUAL'), (None, 'PLUSEQUAL'), (None, 'TIMESEQUAL'), (None, 'PLUS'), (None, 'MODEQUAL'), (None, 'DIVEQUAL')]), ('(?P<t_RBRACKET>\\])|(?P<t_CONDOP>\\?)|(?P<t_XOR>\\^)|(?P<t_LSHIFT><<)|(?P<t_LE><=)|(?P<t_LPAREN>\\()|(?P<t_ARROW>->)|(?P<t_EQ>==)|(?P<t_NE>!=)|(?P<t_MINUSMINUS>--)|(?P<t_OR>\\|)|(?P<t_TIMES>\\*)|(?P<t_LBRACKET>\\[)|(?P<t_GE>>=)|(?P<t_RPAREN>\\))|(?P<t_LAND>&&)|(?P<t_RSHIFT>>>)|(?P<t_MINUSEQUAL>-=)|(?P<t_PERIOD>\\.)|(?P<t_ANDEQUAL>&=)|(?P<t_EQUALS>=)|(?P<t_LT><)|(?P<t_COMMA>,)|(?P<t_DIVIDE>/)|(?P<t_AND>&)|(?P<t_MOD>%)|(?P<t_SEMI>;)|(?P<t_MINUS>-)|(?P<t_GT>>)|(?P<t_COLON>:)|(?P<t_NOT>~)|(?P<t_LNOT>!)', [None, (None, 'RBRACKET'), (None, 'CONDOP'), (None, 'XOR'), (None, 'LSHIFT'), (None, 'LE'), (None, 'LPAREN'), (None, 'ARROW'), (None, 'EQ'), (None, 'NE'), (None, 'MINUSMINUS'), (None, 'OR'), (None, 'TIMES'), (None, 'LBRACKET'), (None, 'GE'), (None, 'RPAREN'), (None, 'LAND'), (None, 'RSHIFT'), (None, 'MINUSEQUAL'), (None, 'PERIOD'), (None, 'ANDEQUAL'), (None, 'EQUALS'), (None, 'LT'), (None, 'COMMA'), (None, 'DIVIDE'), (None, 'AND'), (None, 'MOD'), (None, 'SEMI'), (None, 'MINUS'), (None, 'GT'), (None, 'COLON'), (None, 'NOT'), (None, 'LNOT')])]}
+_lexstateignore = {'ppline': ' \t', 'pppragma': ' \t', 'INITIAL': ' \t'}
+_lexstateerrorf = {'ppline': 't_ppline_error', 'pppragma': 't_pppragma_error', 'INITIAL': 't_error'}
+_lexstateeoff = {}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..6e53cddcf6740cfb5317ce75efd7930c19e66f17
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/__init__.py
@@ -0,0 +1,5 @@
+# PLY package
+# Author: David Beazley (dave@dabeaz.com)
+
+__version__ = '3.9'
+__all__ = ['lex','yacc']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/cpp.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/cpp.py
new file mode 100644
index 0000000000000000000000000000000000000000..86273eac77a5b404cb41cf4d2650d8a37415fb67
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/cpp.py
@@ -0,0 +1,905 @@
+# -----------------------------------------------------------------------------
+# cpp.py
+#
+# Author:  David Beazley (http://www.dabeaz.com)
+# Copyright (C) 2017
+# All rights reserved
+#
+# This module implements an ANSI-C style lexical preprocessor for PLY.
+# -----------------------------------------------------------------------------
+import sys
+
+# Some Python 3 compatibility shims
+if sys.version_info.major < 3:
+    STRING_TYPES = (str, unicode)
+else:
+    STRING_TYPES = str
+    xrange = range
+
+# -----------------------------------------------------------------------------
+# Default preprocessor lexer definitions.   These tokens are enough to get
+# a basic preprocessor working.   Other modules may import these if they want
+# -----------------------------------------------------------------------------
+
+tokens = (
+   'CPP_ID','CPP_INTEGER', 'CPP_FLOAT', 'CPP_STRING', 'CPP_CHAR', 'CPP_WS', 'CPP_COMMENT1', 'CPP_COMMENT2', 'CPP_POUND','CPP_DPOUND'
+)
+
+literals = "+-*/%|&~^<>=!?()[]{}.,;:\\\'\""
+
+# Whitespace
+def t_CPP_WS(t):
+    r'\s+'
+    t.lexer.lineno += t.value.count("\n")
+    return t
+
+t_CPP_POUND = r'\#'
+t_CPP_DPOUND = r'\#\#'
+
+# Identifier
+t_CPP_ID = r'[A-Za-z_][\w_]*'
+
+# Integer literal
+def CPP_INTEGER(t):
+    r'(((((0x)|(0X))[0-9a-fA-F]+)|(\d+))([uU][lL]|[lL][uU]|[uU]|[lL])?)'
+    return t
+
+t_CPP_INTEGER = CPP_INTEGER
+
+# Floating literal
+t_CPP_FLOAT = r'((\d+)(\.\d+)(e(\+|-)?(\d+))? | (\d+)e(\+|-)?(\d+))([lL]|[fF])?'
+
+# String literal
+def t_CPP_STRING(t):
+    r'\"([^\\\n]|(\\(.|\n)))*?\"'
+    t.lexer.lineno += t.value.count("\n")
+    return t
+
+# Character constant 'c' or L'c'
+def t_CPP_CHAR(t):
+    r'(L)?\'([^\\\n]|(\\(.|\n)))*?\''
+    t.lexer.lineno += t.value.count("\n")
+    return t
+
+# Comment
+def t_CPP_COMMENT1(t):
+    r'(/\*(.|\n)*?\*/)'
+    ncr = t.value.count("\n")
+    t.lexer.lineno += ncr
+    # replace with one space or a number of '\n'
+    t.type = 'CPP_WS'; t.value = '\n' * ncr if ncr else ' '
+    return t
+
+# Line comment
+def t_CPP_COMMENT2(t):
+    r'(//.*?(\n|$))'
+    # replace with '/n'
+    t.type = 'CPP_WS'; t.value = '\n'
+    return t
+
+def t_error(t):
+    t.type = t.value[0]
+    t.value = t.value[0]
+    t.lexer.skip(1)
+    return t
+
+import re
+import copy
+import time
+import os.path
+
+# -----------------------------------------------------------------------------
+# trigraph()
+#
+# Given an input string, this function replaces all trigraph sequences.
+# The following mapping is used:
+#
+#     ??=    #
+#     ??/    \
+#     ??'    ^
+#     ??(    [
+#     ??)    ]
+#     ??!    |
+#     ??<    {
+#     ??>    }
+#     ??-    ~
+# -----------------------------------------------------------------------------
+
+_trigraph_pat = re.compile(r'''\?\?[=/\'\(\)\!<>\-]''')
+_trigraph_rep = {
+    '=':'#',
+    '/':'\\',
+    "'":'^',
+    '(':'[',
+    ')':']',
+    '!':'|',
+    '<':'{',
+    '>':'}',
+    '-':'~'
+}
+
+def trigraph(input):
+    return _trigraph_pat.sub(lambda g: _trigraph_rep[g.group()[-1]],input)
+
+# ------------------------------------------------------------------
+# Macro object
+#
+# This object holds information about preprocessor macros
+#
+#    .name      - Macro name (string)
+#    .value     - Macro value (a list of tokens)
+#    .arglist   - List of argument names
+#    .variadic  - Boolean indicating whether or not variadic macro
+#    .vararg    - Name of the variadic parameter
+#
+# When a macro is created, the macro replacement token sequence is
+# pre-scanned and used to create patch lists that are later used
+# during macro expansion
+# ------------------------------------------------------------------
+
+class Macro(object):
+    def __init__(self,name,value,arglist=None,variadic=False):
+        self.name = name
+        self.value = value
+        self.arglist = arglist
+        self.variadic = variadic
+        if variadic:
+            self.vararg = arglist[-1]
+        self.source = None
+
+# ------------------------------------------------------------------
+# Preprocessor object
+#
+# Object representing a preprocessor.  Contains macro definitions,
+# include directories, and other information
+# ------------------------------------------------------------------
+
+class Preprocessor(object):
+    def __init__(self,lexer=None):
+        if lexer is None:
+            lexer = lex.lexer
+        self.lexer = lexer
+        self.macros = { }
+        self.path = []
+        self.temp_path = []
+
+        # Probe the lexer for selected tokens
+        self.lexprobe()
+
+        tm = time.localtime()
+        self.define("__DATE__ \"%s\"" % time.strftime("%b %d %Y",tm))
+        self.define("__TIME__ \"%s\"" % time.strftime("%H:%M:%S",tm))
+        self.parser = None
+
+    # -----------------------------------------------------------------------------
+    # tokenize()
+    #
+    # Utility function. Given a string of text, tokenize into a list of tokens
+    # -----------------------------------------------------------------------------
+
+    def tokenize(self,text):
+        tokens = []
+        self.lexer.input(text)
+        while True:
+            tok = self.lexer.token()
+            if not tok: break
+            tokens.append(tok)
+        return tokens
+
+    # ---------------------------------------------------------------------
+    # error()
+    #
+    # Report a preprocessor error/warning of some kind
+    # ----------------------------------------------------------------------
+
+    def error(self,file,line,msg):
+        print("%s:%d %s" % (file,line,msg))
+
+    # ----------------------------------------------------------------------
+    # lexprobe()
+    #
+    # This method probes the preprocessor lexer object to discover
+    # the token types of symbols that are important to the preprocessor.
+    # If this works right, the preprocessor will simply "work"
+    # with any suitable lexer regardless of how tokens have been named.
+    # ----------------------------------------------------------------------
+
+    def lexprobe(self):
+
+        # Determine the token type for identifiers
+        self.lexer.input("identifier")
+        tok = self.lexer.token()
+        if not tok or tok.value != "identifier":
+            print("Couldn't determine identifier type")
+        else:
+            self.t_ID = tok.type
+
+        # Determine the token type for integers
+        self.lexer.input("12345")
+        tok = self.lexer.token()
+        if not tok or int(tok.value) != 12345:
+            print("Couldn't determine integer type")
+        else:
+            self.t_INTEGER = tok.type
+            self.t_INTEGER_TYPE = type(tok.value)
+
+        # Determine the token type for strings enclosed in double quotes
+        self.lexer.input("\"filename\"")
+        tok = self.lexer.token()
+        if not tok or tok.value != "\"filename\"":
+            print("Couldn't determine string type")
+        else:
+            self.t_STRING = tok.type
+
+        # Determine the token type for whitespace--if any
+        self.lexer.input("  ")
+        tok = self.lexer.token()
+        if not tok or tok.value != "  ":
+            self.t_SPACE = None
+        else:
+            self.t_SPACE = tok.type
+
+        # Determine the token type for newlines
+        self.lexer.input("\n")
+        tok = self.lexer.token()
+        if not tok or tok.value != "\n":
+            self.t_NEWLINE = None
+            print("Couldn't determine token for newlines")
+        else:
+            self.t_NEWLINE = tok.type
+
+        self.t_WS = (self.t_SPACE, self.t_NEWLINE)
+
+        # Check for other characters used by the preprocessor
+        chars = [ '<','>','#','##','\\','(',')',',','.']
+        for c in chars:
+            self.lexer.input(c)
+            tok = self.lexer.token()
+            if not tok or tok.value != c:
+                print("Unable to lex '%s' required for preprocessor" % c)
+
+    # ----------------------------------------------------------------------
+    # add_path()
+    #
+    # Adds a search path to the preprocessor.
+    # ----------------------------------------------------------------------
+
+    def add_path(self,path):
+        self.path.append(path)
+
+    # ----------------------------------------------------------------------
+    # group_lines()
+    #
+    # Given an input string, this function splits it into lines.  Trailing whitespace
+    # is removed.   Any line ending with \ is grouped with the next line.  This
+    # function forms the lowest level of the preprocessor---grouping into text into
+    # a line-by-line format.
+    # ----------------------------------------------------------------------
+
+    def group_lines(self,input):
+        lex = self.lexer.clone()
+        lines = [x.rstrip() for x in input.splitlines()]
+        for i in xrange(len(lines)):
+            j = i+1
+            while lines[i].endswith('\\') and (j < len(lines)):
+                lines[i] = lines[i][:-1]+lines[j]
+                lines[j] = ""
+                j += 1
+
+        input = "\n".join(lines)
+        lex.input(input)
+        lex.lineno = 1
+
+        current_line = []
+        while True:
+            tok = lex.token()
+            if not tok:
+                break
+            current_line.append(tok)
+            if tok.type in self.t_WS and '\n' in tok.value:
+                yield current_line
+                current_line = []
+
+        if current_line:
+            yield current_line
+
+    # ----------------------------------------------------------------------
+    # tokenstrip()
+    #
+    # Remove leading/trailing whitespace tokens from a token list
+    # ----------------------------------------------------------------------
+
+    def tokenstrip(self,tokens):
+        i = 0
+        while i < len(tokens) and tokens[i].type in self.t_WS:
+            i += 1
+        del tokens[:i]
+        i = len(tokens)-1
+        while i >= 0 and tokens[i].type in self.t_WS:
+            i -= 1
+        del tokens[i+1:]
+        return tokens
+
+
+    # ----------------------------------------------------------------------
+    # collect_args()
+    #
+    # Collects comma separated arguments from a list of tokens.   The arguments
+    # must be enclosed in parenthesis.  Returns a tuple (tokencount,args,positions)
+    # where tokencount is the number of tokens consumed, args is a list of arguments,
+    # and positions is a list of integers containing the starting index of each
+    # argument.  Each argument is represented by a list of tokens.
+    #
+    # When collecting arguments, leading and trailing whitespace is removed
+    # from each argument.
+    #
+    # This function properly handles nested parenthesis and commas---these do not
+    # define new arguments.
+    # ----------------------------------------------------------------------
+
+    def collect_args(self,tokenlist):
+        args = []
+        positions = []
+        current_arg = []
+        nesting = 1
+        tokenlen = len(tokenlist)
+
+        # Search for the opening '('.
+        i = 0
+        while (i < tokenlen) and (tokenlist[i].type in self.t_WS):
+            i += 1
+
+        if (i < tokenlen) and (tokenlist[i].value == '('):
+            positions.append(i+1)
+        else:
+            self.error(self.source,tokenlist[0].lineno,"Missing '(' in macro arguments")
+            return 0, [], []
+
+        i += 1
+
+        while i < tokenlen:
+            t = tokenlist[i]
+            if t.value == '(':
+                current_arg.append(t)
+                nesting += 1
+            elif t.value == ')':
+                nesting -= 1
+                if nesting == 0:
+                    if current_arg:
+                        args.append(self.tokenstrip(current_arg))
+                        positions.append(i)
+                    return i+1,args,positions
+                current_arg.append(t)
+            elif t.value == ',' and nesting == 1:
+                args.append(self.tokenstrip(current_arg))
+                positions.append(i+1)
+                current_arg = []
+            else:
+                current_arg.append(t)
+            i += 1
+
+        # Missing end argument
+        self.error(self.source,tokenlist[-1].lineno,"Missing ')' in macro arguments")
+        return 0, [],[]
+
+    # ----------------------------------------------------------------------
+    # macro_prescan()
+    #
+    # Examine the macro value (token sequence) and identify patch points
+    # This is used to speed up macro expansion later on---we'll know
+    # right away where to apply patches to the value to form the expansion
+    # ----------------------------------------------------------------------
+
+    def macro_prescan(self,macro):
+        macro.patch     = []             # Standard macro arguments
+        macro.str_patch = []             # String conversion expansion
+        macro.var_comma_patch = []       # Variadic macro comma patch
+        i = 0
+        while i < len(macro.value):
+            if macro.value[i].type == self.t_ID and macro.value[i].value in macro.arglist:
+                argnum = macro.arglist.index(macro.value[i].value)
+                # Conversion of argument to a string
+                if i > 0 and macro.value[i-1].value == '#':
+                    macro.value[i] = copy.copy(macro.value[i])
+                    macro.value[i].type = self.t_STRING
+                    del macro.value[i-1]
+                    macro.str_patch.append((argnum,i-1))
+                    continue
+                # Concatenation
+                elif (i > 0 and macro.value[i-1].value == '##'):
+                    macro.patch.append(('c',argnum,i-1))
+                    del macro.value[i-1]
+                    continue
+                elif ((i+1) < len(macro.value) and macro.value[i+1].value == '##'):
+                    macro.patch.append(('c',argnum,i))
+                    i += 1
+                    continue
+                # Standard expansion
+                else:
+                    macro.patch.append(('e',argnum,i))
+            elif macro.value[i].value == '##':
+                if macro.variadic and (i > 0) and (macro.value[i-1].value == ',') and \
+                        ((i+1) < len(macro.value)) and (macro.value[i+1].type == self.t_ID) and \
+                        (macro.value[i+1].value == macro.vararg):
+                    macro.var_comma_patch.append(i-1)
+            i += 1
+        macro.patch.sort(key=lambda x: x[2],reverse=True)
+
+    # ----------------------------------------------------------------------
+    # macro_expand_args()
+    #
+    # Given a Macro and list of arguments (each a token list), this method
+    # returns an expanded version of a macro.  The return value is a token sequence
+    # representing the replacement macro tokens
+    # ----------------------------------------------------------------------
+
+    def macro_expand_args(self,macro,args):
+        # Make a copy of the macro token sequence
+        rep = [copy.copy(_x) for _x in macro.value]
+
+        # Make string expansion patches.  These do not alter the length of the replacement sequence
+
+        str_expansion = {}
+        for argnum, i in macro.str_patch:
+            if argnum not in str_expansion:
+                str_expansion[argnum] = ('"%s"' % "".join([x.value for x in args[argnum]])).replace("\\","\\\\")
+            rep[i] = copy.copy(rep[i])
+            rep[i].value = str_expansion[argnum]
+
+        # Make the variadic macro comma patch.  If the variadic macro argument is empty, we get rid
+        comma_patch = False
+        if macro.variadic and not args[-1]:
+            for i in macro.var_comma_patch:
+                rep[i] = None
+                comma_patch = True
+
+        # Make all other patches.   The order of these matters.  It is assumed that the patch list
+        # has been sorted in reverse order of patch location since replacements will cause the
+        # size of the replacement sequence to expand from the patch point.
+
+        expanded = { }
+        for ptype, argnum, i in macro.patch:
+            # Concatenation.   Argument is left unexpanded
+            if ptype == 'c':
+                rep[i:i+1] = args[argnum]
+            # Normal expansion.  Argument is macro expanded first
+            elif ptype == 'e':
+                if argnum not in expanded:
+                    expanded[argnum] = self.expand_macros(args[argnum])
+                rep[i:i+1] = expanded[argnum]
+
+        # Get rid of removed comma if necessary
+        if comma_patch:
+            rep = [_i for _i in rep if _i]
+
+        return rep
+
+
+    # ----------------------------------------------------------------------
+    # expand_macros()
+    #
+    # Given a list of tokens, this function performs macro expansion.
+    # The expanded argument is a dictionary that contains macros already
+    # expanded.  This is used to prevent infinite recursion.
+    # ----------------------------------------------------------------------
+
+    def expand_macros(self,tokens,expanded=None):
+        if expanded is None:
+            expanded = {}
+        i = 0
+        while i < len(tokens):
+            t = tokens[i]
+            if t.type == self.t_ID:
+                if t.value in self.macros and t.value not in expanded:
+                    # Yes, we found a macro match
+                    expanded[t.value] = True
+
+                    m = self.macros[t.value]
+                    if not m.arglist:
+                        # A simple macro
+                        ex = self.expand_macros([copy.copy(_x) for _x in m.value],expanded)
+                        for e in ex:
+                            e.lineno = t.lineno
+                        tokens[i:i+1] = ex
+                        i += len(ex)
+                    else:
+                        # A macro with arguments
+                        j = i + 1
+                        while j < len(tokens) and tokens[j].type in self.t_WS:
+                            j += 1
+                        if tokens[j].value == '(':
+                            tokcount,args,positions = self.collect_args(tokens[j:])
+                            if not m.variadic and len(args) !=  len(m.arglist):
+                                self.error(self.source,t.lineno,"Macro %s requires %d arguments" % (t.value,len(m.arglist)))
+                                i = j + tokcount
+                            elif m.variadic and len(args) < len(m.arglist)-1:
+                                if len(m.arglist) > 2:
+                                    self.error(self.source,t.lineno,"Macro %s must have at least %d arguments" % (t.value, len(m.arglist)-1))
+                                else:
+                                    self.error(self.source,t.lineno,"Macro %s must have at least %d argument" % (t.value, len(m.arglist)-1))
+                                i = j + tokcount
+                            else:
+                                if m.variadic:
+                                    if len(args) == len(m.arglist)-1:
+                                        args.append([])
+                                    else:
+                                        args[len(m.arglist)-1] = tokens[j+positions[len(m.arglist)-1]:j+tokcount-1]
+                                        del args[len(m.arglist):]
+
+                                # Get macro replacement text
+                                rep = self.macro_expand_args(m,args)
+                                rep = self.expand_macros(rep,expanded)
+                                for r in rep:
+                                    r.lineno = t.lineno
+                                tokens[i:j+tokcount] = rep
+                                i += len(rep)
+                    del expanded[t.value]
+                    continue
+                elif t.value == '__LINE__':
+                    t.type = self.t_INTEGER
+                    t.value = self.t_INTEGER_TYPE(t.lineno)
+
+            i += 1
+        return tokens
+
+    # ----------------------------------------------------------------------
+    # evalexpr()
+    #
+    # Evaluate an expression token sequence for the purposes of evaluating
+    # integral expressions.
+    # ----------------------------------------------------------------------
+
+    def evalexpr(self,tokens):
+        # tokens = tokenize(line)
+        # Search for defined macros
+        i = 0
+        while i < len(tokens):
+            if tokens[i].type == self.t_ID and tokens[i].value == 'defined':
+                j = i + 1
+                needparen = False
+                result = "0L"
+                while j < len(tokens):
+                    if tokens[j].type in self.t_WS:
+                        j += 1
+                        continue
+                    elif tokens[j].type == self.t_ID:
+                        if tokens[j].value in self.macros:
+                            result = "1L"
+                        else:
+                            result = "0L"
+                        if not needparen: break
+                    elif tokens[j].value == '(':
+                        needparen = True
+                    elif tokens[j].value == ')':
+                        break
+                    else:
+                        self.error(self.source,tokens[i].lineno,"Malformed defined()")
+                    j += 1
+                tokens[i].type = self.t_INTEGER
+                tokens[i].value = self.t_INTEGER_TYPE(result)
+                del tokens[i+1:j+1]
+            i += 1
+        tokens = self.expand_macros(tokens)
+        for i,t in enumerate(tokens):
+            if t.type == self.t_ID:
+                tokens[i] = copy.copy(t)
+                tokens[i].type = self.t_INTEGER
+                tokens[i].value = self.t_INTEGER_TYPE("0L")
+            elif t.type == self.t_INTEGER:
+                tokens[i] = copy.copy(t)
+                # Strip off any trailing suffixes
+                tokens[i].value = str(tokens[i].value)
+                while tokens[i].value[-1] not in "0123456789abcdefABCDEF":
+                    tokens[i].value = tokens[i].value[:-1]
+
+        expr = "".join([str(x.value) for x in tokens])
+        expr = expr.replace("&&"," and ")
+        expr = expr.replace("||"," or ")
+        expr = expr.replace("!"," not ")
+        try:
+            result = eval(expr)
+        except Exception:
+            self.error(self.source,tokens[0].lineno,"Couldn't evaluate expression")
+            result = 0
+        return result
+
+    # ----------------------------------------------------------------------
+    # parsegen()
+    #
+    # Parse an input string/
+    # ----------------------------------------------------------------------
+    def parsegen(self,input,source=None):
+
+        # Replace trigraph sequences
+        t = trigraph(input)
+        lines = self.group_lines(t)
+
+        if not source:
+            source = ""
+
+        self.define("__FILE__ \"%s\"" % source)
+
+        self.source = source
+        chunk = []
+        enable = True
+        iftrigger = False
+        ifstack = []
+
+        for x in lines:
+            for i,tok in enumerate(x):
+                if tok.type not in self.t_WS: break
+            if tok.value == '#':
+                # Preprocessor directive
+
+                # insert necessary whitespace instead of eaten tokens
+                for tok in x:
+                    if tok.type in self.t_WS and '\n' in tok.value:
+                        chunk.append(tok)
+
+                dirtokens = self.tokenstrip(x[i+1:])
+                if dirtokens:
+                    name = dirtokens[0].value
+                    args = self.tokenstrip(dirtokens[1:])
+                else:
+                    name = ""
+                    args = []
+
+                if name == 'define':
+                    if enable:
+                        for tok in self.expand_macros(chunk):
+                            yield tok
+                        chunk = []
+                        self.define(args)
+                elif name == 'include':
+                    if enable:
+                        for tok in self.expand_macros(chunk):
+                            yield tok
+                        chunk = []
+                        oldfile = self.macros['__FILE__']
+                        for tok in self.include(args):
+                            yield tok
+                        self.macros['__FILE__'] = oldfile
+                        self.source = source
+                elif name == 'undef':
+                    if enable:
+                        for tok in self.expand_macros(chunk):
+                            yield tok
+                        chunk = []
+                        self.undef(args)
+                elif name == 'ifdef':
+                    ifstack.append((enable,iftrigger))
+                    if enable:
+                        if not args[0].value in self.macros:
+                            enable = False
+                            iftrigger = False
+                        else:
+                            iftrigger = True
+                elif name == 'ifndef':
+                    ifstack.append((enable,iftrigger))
+                    if enable:
+                        if args[0].value in self.macros:
+                            enable = False
+                            iftrigger = False
+                        else:
+                            iftrigger = True
+                elif name == 'if':
+                    ifstack.append((enable,iftrigger))
+                    if enable:
+                        result = self.evalexpr(args)
+                        if not result:
+                            enable = False
+                            iftrigger = False
+                        else:
+                            iftrigger = True
+                elif name == 'elif':
+                    if ifstack:
+                        if ifstack[-1][0]:     # We only pay attention if outer "if" allows this
+                            if enable:         # If already true, we flip enable False
+                                enable = False
+                            elif not iftrigger:   # If False, but not triggered yet, we'll check expression
+                                result = self.evalexpr(args)
+                                if result:
+                                    enable  = True
+                                    iftrigger = True
+                    else:
+                        self.error(self.source,dirtokens[0].lineno,"Misplaced #elif")
+
+                elif name == 'else':
+                    if ifstack:
+                        if ifstack[-1][0]:
+                            if enable:
+                                enable = False
+                            elif not iftrigger:
+                                enable = True
+                                iftrigger = True
+                    else:
+                        self.error(self.source,dirtokens[0].lineno,"Misplaced #else")
+
+                elif name == 'endif':
+                    if ifstack:
+                        enable,iftrigger = ifstack.pop()
+                    else:
+                        self.error(self.source,dirtokens[0].lineno,"Misplaced #endif")
+                else:
+                    # Unknown preprocessor directive
+                    pass
+
+            else:
+                # Normal text
+                if enable:
+                    chunk.extend(x)
+
+        for tok in self.expand_macros(chunk):
+            yield tok
+        chunk = []
+
+    # ----------------------------------------------------------------------
+    # include()
+    #
+    # Implementation of file-inclusion
+    # ----------------------------------------------------------------------
+
+    def include(self,tokens):
+        # Try to extract the filename and then process an include file
+        if not tokens:
+            return
+        if tokens:
+            if tokens[0].value != '<' and tokens[0].type != self.t_STRING:
+                tokens = self.expand_macros(tokens)
+
+            if tokens[0].value == '<':
+                # Include <...>
+                i = 1
+                while i < len(tokens):
+                    if tokens[i].value == '>':
+                        break
+                    i += 1
+                else:
+                    print("Malformed #include <...>")
+                    return
+                filename = "".join([x.value for x in tokens[1:i]])
+                path = self.path + [""] + self.temp_path
+            elif tokens[0].type == self.t_STRING:
+                filename = tokens[0].value[1:-1]
+                path = self.temp_path + [""] + self.path
+            else:
+                print("Malformed #include statement")
+                return
+        for p in path:
+            iname = os.path.join(p,filename)
+            try:
+                data = open(iname,"r").read()
+                dname = os.path.dirname(iname)
+                if dname:
+                    self.temp_path.insert(0,dname)
+                for tok in self.parsegen(data,filename):
+                    yield tok
+                if dname:
+                    del self.temp_path[0]
+                break
+            except IOError:
+                pass
+        else:
+            print("Couldn't find '%s'" % filename)
+
+    # ----------------------------------------------------------------------
+    # define()
+    #
+    # Define a new macro
+    # ----------------------------------------------------------------------
+
+    def define(self,tokens):
+        if isinstance(tokens,STRING_TYPES):
+            tokens = self.tokenize(tokens)
+
+        linetok = tokens
+        try:
+            name = linetok[0]
+            if len(linetok) > 1:
+                mtype = linetok[1]
+            else:
+                mtype = None
+            if not mtype:
+                m = Macro(name.value,[])
+                self.macros[name.value] = m
+            elif mtype.type in self.t_WS:
+                # A normal macro
+                m = Macro(name.value,self.tokenstrip(linetok[2:]))
+                self.macros[name.value] = m
+            elif mtype.value == '(':
+                # A macro with arguments
+                tokcount, args, positions = self.collect_args(linetok[1:])
+                variadic = False
+                for a in args:
+                    if variadic:
+                        print("No more arguments may follow a variadic argument")
+                        break
+                    astr = "".join([str(_i.value) for _i in a])
+                    if astr == "...":
+                        variadic = True
+                        a[0].type = self.t_ID
+                        a[0].value = '__VA_ARGS__'
+                        variadic = True
+                        del a[1:]
+                        continue
+                    elif astr[-3:] == "..." and a[0].type == self.t_ID:
+                        variadic = True
+                        del a[1:]
+                        # If, for some reason, "." is part of the identifier, strip off the name for the purposes
+                        # of macro expansion
+                        if a[0].value[-3:] == '...':
+                            a[0].value = a[0].value[:-3]
+                        continue
+                    if len(a) > 1 or a[0].type != self.t_ID:
+                        print("Invalid macro argument")
+                        break
+                else:
+                    mvalue = self.tokenstrip(linetok[1+tokcount:])
+                    i = 0
+                    while i < len(mvalue):
+                        if i+1 < len(mvalue):
+                            if mvalue[i].type in self.t_WS and mvalue[i+1].value == '##':
+                                del mvalue[i]
+                                continue
+                            elif mvalue[i].value == '##' and mvalue[i+1].type in self.t_WS:
+                                del mvalue[i+1]
+                        i += 1
+                    m = Macro(name.value,mvalue,[x[0].value for x in args],variadic)
+                    self.macro_prescan(m)
+                    self.macros[name.value] = m
+            else:
+                print("Bad macro definition")
+        except LookupError:
+            print("Bad macro definition")
+
+    # ----------------------------------------------------------------------
+    # undef()
+    #
+    # Undefine a macro
+    # ----------------------------------------------------------------------
+
+    def undef(self,tokens):
+        id = tokens[0].value
+        try:
+            del self.macros[id]
+        except LookupError:
+            pass
+
+    # ----------------------------------------------------------------------
+    # parse()
+    #
+    # Parse input text.
+    # ----------------------------------------------------------------------
+    def parse(self,input,source=None,ignore={}):
+        self.ignore = ignore
+        self.parser = self.parsegen(input,source)
+
+    # ----------------------------------------------------------------------
+    # token()
+    #
+    # Method to return individual tokens
+    # ----------------------------------------------------------------------
+    def token(self):
+        try:
+            while True:
+                tok = next(self.parser)
+                if tok.type not in self.ignore: return tok
+        except StopIteration:
+            self.parser = None
+            return None
+
+if __name__ == '__main__':
+    import ply.lex as lex
+    lexer = lex.lex()
+
+    # Run a preprocessor
+    import sys
+    f = open(sys.argv[1])
+    input = f.read()
+
+    p = Preprocessor(lexer)
+    p.parse(input,sys.argv[1])
+    while True:
+        tok = p.token()
+        if not tok: break
+        print(p.source, tok)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ctokens.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ctokens.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6f6952d605ee5fa0a25eff03f18769b6b445fae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ctokens.py
@@ -0,0 +1,133 @@
+# ----------------------------------------------------------------------
+# ctokens.py
+#
+# Token specifications for symbols in ANSI C and C++.  This file is
+# meant to be used as a library in other tokenizers.
+# ----------------------------------------------------------------------
+
+# Reserved words
+
+tokens = [
+    # Literals (identifier, integer constant, float constant, string constant, char const)
+    'ID', 'TYPEID', 'INTEGER', 'FLOAT', 'STRING', 'CHARACTER',
+
+    # Operators (+,-,*,/,%,|,&,~,^,<<,>>, ||, &&, !, <, <=, >, >=, ==, !=)
+    'PLUS', 'MINUS', 'TIMES', 'DIVIDE', 'MODULO',
+    'OR', 'AND', 'NOT', 'XOR', 'LSHIFT', 'RSHIFT',
+    'LOR', 'LAND', 'LNOT',
+    'LT', 'LE', 'GT', 'GE', 'EQ', 'NE',
+    
+    # Assignment (=, *=, /=, %=, +=, -=, <<=, >>=, &=, ^=, |=)
+    'EQUALS', 'TIMESEQUAL', 'DIVEQUAL', 'MODEQUAL', 'PLUSEQUAL', 'MINUSEQUAL',
+    'LSHIFTEQUAL','RSHIFTEQUAL', 'ANDEQUAL', 'XOREQUAL', 'OREQUAL',
+
+    # Increment/decrement (++,--)
+    'INCREMENT', 'DECREMENT',
+
+    # Structure dereference (->)
+    'ARROW',
+
+    # Ternary operator (?)
+    'TERNARY',
+    
+    # Delimeters ( ) [ ] { } , . ; :
+    'LPAREN', 'RPAREN',
+    'LBRACKET', 'RBRACKET',
+    'LBRACE', 'RBRACE',
+    'COMMA', 'PERIOD', 'SEMI', 'COLON',
+
+    # Ellipsis (...)
+    'ELLIPSIS',
+]
+    
+# Operators
+t_PLUS             = r'\+'
+t_MINUS            = r'-'
+t_TIMES            = r'\*'
+t_DIVIDE           = r'/'
+t_MODULO           = r'%'
+t_OR               = r'\|'
+t_AND              = r'&'
+t_NOT              = r'~'
+t_XOR              = r'\^'
+t_LSHIFT           = r'<<'
+t_RSHIFT           = r'>>'
+t_LOR              = r'\|\|'
+t_LAND             = r'&&'
+t_LNOT             = r'!'
+t_LT               = r'<'
+t_GT               = r'>'
+t_LE               = r'<='
+t_GE               = r'>='
+t_EQ               = r'=='
+t_NE               = r'!='
+
+# Assignment operators
+
+t_EQUALS           = r'='
+t_TIMESEQUAL       = r'\*='
+t_DIVEQUAL         = r'/='
+t_MODEQUAL         = r'%='
+t_PLUSEQUAL        = r'\+='
+t_MINUSEQUAL       = r'-='
+t_LSHIFTEQUAL      = r'<<='
+t_RSHIFTEQUAL      = r'>>='
+t_ANDEQUAL         = r'&='
+t_OREQUAL          = r'\|='
+t_XOREQUAL         = r'\^='
+
+# Increment/decrement
+t_INCREMENT        = r'\+\+'
+t_DECREMENT        = r'--'
+
+# ->
+t_ARROW            = r'->'
+
+# ?
+t_TERNARY          = r'\?'
+
+# Delimeters
+t_LPAREN           = r'\('
+t_RPAREN           = r'\)'
+t_LBRACKET         = r'\['
+t_RBRACKET         = r'\]'
+t_LBRACE           = r'\{'
+t_RBRACE           = r'\}'
+t_COMMA            = r','
+t_PERIOD           = r'\.'
+t_SEMI             = r';'
+t_COLON            = r':'
+t_ELLIPSIS         = r'\.\.\.'
+
+# Identifiers
+t_ID = r'[A-Za-z_][A-Za-z0-9_]*'
+
+# Integer literal
+t_INTEGER = r'\d+([uU]|[lL]|[uU][lL]|[lL][uU])?'
+
+# Floating literal
+t_FLOAT = r'((\d+)(\.\d+)(e(\+|-)?(\d+))? | (\d+)e(\+|-)?(\d+))([lL]|[fF])?'
+
+# String literal
+t_STRING = r'\"([^\\\n]|(\\.))*?\"'
+
+# Character constant 'c' or L'c'
+t_CHARACTER = r'(L)?\'([^\\\n]|(\\.))*?\''
+
+# Comment (C-Style)
+def t_COMMENT(t):
+    r'/\*(.|\n)*?\*/'
+    t.lexer.lineno += t.value.count('\n')
+    return t
+
+# Comment (C++-Style)
+def t_CPPCOMMENT(t):
+    r'//.*\n'
+    t.lexer.lineno += 1
+    return t
+
+
+    
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/lex.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/lex.py
new file mode 100644
index 0000000000000000000000000000000000000000..4bdd76ca06d1aee995142be8a3183894776df6fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/lex.py
@@ -0,0 +1,1099 @@
+# -----------------------------------------------------------------------------
+# ply: lex.py
+#
+# Copyright (C) 2001-2017
+# David M. Beazley (Dabeaz LLC)
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the David Beazley or Dabeaz LLC may be used to
+#   endorse or promote products derived from this software without
+#  specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+
+__version__    = '3.10'
+__tabversion__ = '3.10'
+
+import re
+import sys
+import types
+import copy
+import os
+import inspect
+
+# This tuple contains known string types
+try:
+    # Python 2.6
+    StringTypes = (types.StringType, types.UnicodeType)
+except AttributeError:
+    # Python 3.0
+    StringTypes = (str, bytes)
+
+# This regular expression is used to match valid token names
+_is_identifier = re.compile(r'^[a-zA-Z0-9_]+$')
+
+# Exception thrown when invalid token encountered and no default error
+# handler is defined.
+class LexError(Exception):
+    def __init__(self, message, s):
+        self.args = (message,)
+        self.text = s
+
+
+# Token class.  This class is used to represent the tokens produced.
+class LexToken(object):
+    def __str__(self):
+        return 'LexToken(%s,%r,%d,%d)' % (self.type, self.value, self.lineno, self.lexpos)
+
+    def __repr__(self):
+        return str(self)
+
+
+# This object is a stand-in for a logging object created by the
+# logging module.
+
+class PlyLogger(object):
+    def __init__(self, f):
+        self.f = f
+
+    def critical(self, msg, *args, **kwargs):
+        self.f.write((msg % args) + '\n')
+
+    def warning(self, msg, *args, **kwargs):
+        self.f.write('WARNING: ' + (msg % args) + '\n')
+
+    def error(self, msg, *args, **kwargs):
+        self.f.write('ERROR: ' + (msg % args) + '\n')
+
+    info = critical
+    debug = critical
+
+
+# Null logger is used when no output is generated. Does nothing.
+class NullLogger(object):
+    def __getattribute__(self, name):
+        return self
+
+    def __call__(self, *args, **kwargs):
+        return self
+
+
+# -----------------------------------------------------------------------------
+#                        === Lexing Engine ===
+#
+# The following Lexer class implements the lexer runtime.   There are only
+# a few public methods and attributes:
+#
+#    input()          -  Store a new string in the lexer
+#    token()          -  Get the next token
+#    clone()          -  Clone the lexer
+#
+#    lineno           -  Current line number
+#    lexpos           -  Current position in the input string
+# -----------------------------------------------------------------------------
+
+class Lexer:
+    def __init__(self):
+        self.lexre = None             # Master regular expression. This is a list of
+                                      # tuples (re, findex) where re is a compiled
+                                      # regular expression and findex is a list
+                                      # mapping regex group numbers to rules
+        self.lexretext = None         # Current regular expression strings
+        self.lexstatere = {}          # Dictionary mapping lexer states to master regexs
+        self.lexstateretext = {}      # Dictionary mapping lexer states to regex strings
+        self.lexstaterenames = {}     # Dictionary mapping lexer states to symbol names
+        self.lexstate = 'INITIAL'     # Current lexer state
+        self.lexstatestack = []       # Stack of lexer states
+        self.lexstateinfo = None      # State information
+        self.lexstateignore = {}      # Dictionary of ignored characters for each state
+        self.lexstateerrorf = {}      # Dictionary of error functions for each state
+        self.lexstateeoff = {}        # Dictionary of eof functions for each state
+        self.lexreflags = 0           # Optional re compile flags
+        self.lexdata = None           # Actual input data (as a string)
+        self.lexpos = 0               # Current position in input text
+        self.lexlen = 0               # Length of the input text
+        self.lexerrorf = None         # Error rule (if any)
+        self.lexeoff = None           # EOF rule (if any)
+        self.lextokens = None         # List of valid tokens
+        self.lexignore = ''           # Ignored characters
+        self.lexliterals = ''         # Literal characters that can be passed through
+        self.lexmodule = None         # Module
+        self.lineno = 1               # Current line number
+        self.lexoptimize = False      # Optimized mode
+
+    def clone(self, object=None):
+        c = copy.copy(self)
+
+        # If the object parameter has been supplied, it means we are attaching the
+        # lexer to a new object.  In this case, we have to rebind all methods in
+        # the lexstatere and lexstateerrorf tables.
+
+        if object:
+            newtab = {}
+            for key, ritem in self.lexstatere.items():
+                newre = []
+                for cre, findex in ritem:
+                    newfindex = []
+                    for f in findex:
+                        if not f or not f[0]:
+                            newfindex.append(f)
+                            continue
+                        newfindex.append((getattr(object, f[0].__name__), f[1]))
+                newre.append((cre, newfindex))
+                newtab[key] = newre
+            c.lexstatere = newtab
+            c.lexstateerrorf = {}
+            for key, ef in self.lexstateerrorf.items():
+                c.lexstateerrorf[key] = getattr(object, ef.__name__)
+            c.lexmodule = object
+        return c
+
+    # ------------------------------------------------------------
+    # writetab() - Write lexer information to a table file
+    # ------------------------------------------------------------
+    def writetab(self, lextab, outputdir=''):
+        if isinstance(lextab, types.ModuleType):
+            raise IOError("Won't overwrite existing lextab module")
+        basetabmodule = lextab.split('.')[-1]
+        filename = os.path.join(outputdir, basetabmodule) + '.py'
+        with open(filename, 'w') as tf:
+            tf.write('# %s.py. This file automatically created by PLY (version %s). Don\'t edit!\n' % (basetabmodule, __version__))
+            tf.write('_tabversion   = %s\n' % repr(__tabversion__))
+            tf.write('_lextokens    = set(%s)\n' % repr(tuple(self.lextokens)))
+            tf.write('_lexreflags   = %s\n' % repr(self.lexreflags))
+            tf.write('_lexliterals  = %s\n' % repr(self.lexliterals))
+            tf.write('_lexstateinfo = %s\n' % repr(self.lexstateinfo))
+
+            # Rewrite the lexstatere table, replacing function objects with function names
+            tabre = {}
+            for statename, lre in self.lexstatere.items():
+                titem = []
+                for (pat, func), retext, renames in zip(lre, self.lexstateretext[statename], self.lexstaterenames[statename]):
+                    titem.append((retext, _funcs_to_names(func, renames)))
+                tabre[statename] = titem
+
+            tf.write('_lexstatere   = %s\n' % repr(tabre))
+            tf.write('_lexstateignore = %s\n' % repr(self.lexstateignore))
+
+            taberr = {}
+            for statename, ef in self.lexstateerrorf.items():
+                taberr[statename] = ef.__name__ if ef else None
+            tf.write('_lexstateerrorf = %s\n' % repr(taberr))
+
+            tabeof = {}
+            for statename, ef in self.lexstateeoff.items():
+                tabeof[statename] = ef.__name__ if ef else None
+            tf.write('_lexstateeoff = %s\n' % repr(tabeof))
+
+    # ------------------------------------------------------------
+    # readtab() - Read lexer information from a tab file
+    # ------------------------------------------------------------
+    def readtab(self, tabfile, fdict):
+        if isinstance(tabfile, types.ModuleType):
+            lextab = tabfile
+        else:
+            exec('import %s' % tabfile)
+            lextab = sys.modules[tabfile]
+
+        if getattr(lextab, '_tabversion', '0.0') != __tabversion__:
+            raise ImportError('Inconsistent PLY version')
+
+        self.lextokens      = lextab._lextokens
+        self.lexreflags     = lextab._lexreflags
+        self.lexliterals    = lextab._lexliterals
+        self.lextokens_all  = self.lextokens | set(self.lexliterals)
+        self.lexstateinfo   = lextab._lexstateinfo
+        self.lexstateignore = lextab._lexstateignore
+        self.lexstatere     = {}
+        self.lexstateretext = {}
+        for statename, lre in lextab._lexstatere.items():
+            titem = []
+            txtitem = []
+            for pat, func_name in lre:
+                titem.append((re.compile(pat, lextab._lexreflags), _names_to_funcs(func_name, fdict)))
+
+            self.lexstatere[statename] = titem
+            self.lexstateretext[statename] = txtitem
+
+        self.lexstateerrorf = {}
+        for statename, ef in lextab._lexstateerrorf.items():
+            self.lexstateerrorf[statename] = fdict[ef]
+
+        self.lexstateeoff = {}
+        for statename, ef in lextab._lexstateeoff.items():
+            self.lexstateeoff[statename] = fdict[ef]
+
+        self.begin('INITIAL')
+
+    # ------------------------------------------------------------
+    # input() - Push a new string into the lexer
+    # ------------------------------------------------------------
+    def input(self, s):
+        # Pull off the first character to see if s looks like a string
+        c = s[:1]
+        if not isinstance(c, StringTypes):
+            raise ValueError('Expected a string')
+        self.lexdata = s
+        self.lexpos = 0
+        self.lexlen = len(s)
+
+    # ------------------------------------------------------------
+    # begin() - Changes the lexing state
+    # ------------------------------------------------------------
+    def begin(self, state):
+        if state not in self.lexstatere:
+            raise ValueError('Undefined state')
+        self.lexre = self.lexstatere[state]
+        self.lexretext = self.lexstateretext[state]
+        self.lexignore = self.lexstateignore.get(state, '')
+        self.lexerrorf = self.lexstateerrorf.get(state, None)
+        self.lexeoff = self.lexstateeoff.get(state, None)
+        self.lexstate = state
+
+    # ------------------------------------------------------------
+    # push_state() - Changes the lexing state and saves old on stack
+    # ------------------------------------------------------------
+    def push_state(self, state):
+        self.lexstatestack.append(self.lexstate)
+        self.begin(state)
+
+    # ------------------------------------------------------------
+    # pop_state() - Restores the previous state
+    # ------------------------------------------------------------
+    def pop_state(self):
+        self.begin(self.lexstatestack.pop())
+
+    # ------------------------------------------------------------
+    # current_state() - Returns the current lexing state
+    # ------------------------------------------------------------
+    def current_state(self):
+        return self.lexstate
+
+    # ------------------------------------------------------------
+    # skip() - Skip ahead n characters
+    # ------------------------------------------------------------
+    def skip(self, n):
+        self.lexpos += n
+
+    # ------------------------------------------------------------
+    # opttoken() - Return the next token from the Lexer
+    #
+    # Note: This function has been carefully implemented to be as fast
+    # as possible.  Don't make changes unless you really know what
+    # you are doing
+    # ------------------------------------------------------------
+    def token(self):
+        # Make local copies of frequently referenced attributes
+        lexpos    = self.lexpos
+        lexlen    = self.lexlen
+        lexignore = self.lexignore
+        lexdata   = self.lexdata
+
+        while lexpos < lexlen:
+            # This code provides some short-circuit code for whitespace, tabs, and other ignored characters
+            if lexdata[lexpos] in lexignore:
+                lexpos += 1
+                continue
+
+            # Look for a regular expression match
+            for lexre, lexindexfunc in self.lexre:
+                m = lexre.match(lexdata, lexpos)
+                if not m:
+                    continue
+
+                # Create a token for return
+                tok = LexToken()
+                tok.value = m.group()
+                tok.lineno = self.lineno
+                tok.lexpos = lexpos
+
+                i = m.lastindex
+                func, tok.type = lexindexfunc[i]
+
+                if not func:
+                    # If no token type was set, it's an ignored token
+                    if tok.type:
+                        self.lexpos = m.end()
+                        return tok
+                    else:
+                        lexpos = m.end()
+                        break
+
+                lexpos = m.end()
+
+                # If token is processed by a function, call it
+
+                tok.lexer = self      # Set additional attributes useful in token rules
+                self.lexmatch = m
+                self.lexpos = lexpos
+
+                newtok = func(tok)
+
+                # Every function must return a token, if nothing, we just move to next token
+                if not newtok:
+                    lexpos    = self.lexpos         # This is here in case user has updated lexpos.
+                    lexignore = self.lexignore      # This is here in case there was a state change
+                    break
+
+                # Verify type of the token.  If not in the token map, raise an error
+                if not self.lexoptimize:
+                    if newtok.type not in self.lextokens_all:
+                        raise LexError("%s:%d: Rule '%s' returned an unknown token type '%s'" % (
+                            func.__code__.co_filename, func.__code__.co_firstlineno,
+                            func.__name__, newtok.type), lexdata[lexpos:])
+
+                return newtok
+            else:
+                # No match, see if in literals
+                if lexdata[lexpos] in self.lexliterals:
+                    tok = LexToken()
+                    tok.value = lexdata[lexpos]
+                    tok.lineno = self.lineno
+                    tok.type = tok.value
+                    tok.lexpos = lexpos
+                    self.lexpos = lexpos + 1
+                    return tok
+
+                # No match. Call t_error() if defined.
+                if self.lexerrorf:
+                    tok = LexToken()
+                    tok.value = self.lexdata[lexpos:]
+                    tok.lineno = self.lineno
+                    tok.type = 'error'
+                    tok.lexer = self
+                    tok.lexpos = lexpos
+                    self.lexpos = lexpos
+                    newtok = self.lexerrorf(tok)
+                    if lexpos == self.lexpos:
+                        # Error method didn't change text position at all. This is an error.
+                        raise LexError("Scanning error. Illegal character '%s'" % (lexdata[lexpos]), lexdata[lexpos:])
+                    lexpos = self.lexpos
+                    if not newtok:
+                        continue
+                    return newtok
+
+                self.lexpos = lexpos
+                raise LexError("Illegal character '%s' at index %d" % (lexdata[lexpos], lexpos), lexdata[lexpos:])
+
+        if self.lexeoff:
+            tok = LexToken()
+            tok.type = 'eof'
+            tok.value = ''
+            tok.lineno = self.lineno
+            tok.lexpos = lexpos
+            tok.lexer = self
+            self.lexpos = lexpos
+            newtok = self.lexeoff(tok)
+            return newtok
+
+        self.lexpos = lexpos + 1
+        if self.lexdata is None:
+            raise RuntimeError('No input string given with input()')
+        return None
+
+    # Iterator interface
+    def __iter__(self):
+        return self
+
+    def next(self):
+        t = self.token()
+        if t is None:
+            raise StopIteration
+        return t
+
+    __next__ = next
+
+# -----------------------------------------------------------------------------
+#                           ==== Lex Builder ===
+#
+# The functions and classes below are used to collect lexing information
+# and build a Lexer object from it.
+# -----------------------------------------------------------------------------
+
+# -----------------------------------------------------------------------------
+# _get_regex(func)
+#
+# Returns the regular expression assigned to a function either as a doc string
+# or as a .regex attribute attached by the @TOKEN decorator.
+# -----------------------------------------------------------------------------
+def _get_regex(func):
+    return getattr(func, 'regex', func.__doc__)
+
+# -----------------------------------------------------------------------------
+# get_caller_module_dict()
+#
+# This function returns a dictionary containing all of the symbols defined within
+# a caller further down the call stack.  This is used to get the environment
+# associated with the yacc() call if none was provided.
+# -----------------------------------------------------------------------------
+def get_caller_module_dict(levels):
+    f = sys._getframe(levels)
+    ldict = f.f_globals.copy()
+    if f.f_globals != f.f_locals:
+        ldict.update(f.f_locals)
+    return ldict
+
+# -----------------------------------------------------------------------------
+# _funcs_to_names()
+#
+# Given a list of regular expression functions, this converts it to a list
+# suitable for output to a table file
+# -----------------------------------------------------------------------------
+def _funcs_to_names(funclist, namelist):
+    result = []
+    for f, name in zip(funclist, namelist):
+        if f and f[0]:
+            result.append((name, f[1]))
+        else:
+            result.append(f)
+    return result
+
+# -----------------------------------------------------------------------------
+# _names_to_funcs()
+#
+# Given a list of regular expression function names, this converts it back to
+# functions.
+# -----------------------------------------------------------------------------
+def _names_to_funcs(namelist, fdict):
+    result = []
+    for n in namelist:
+        if n and n[0]:
+            result.append((fdict[n[0]], n[1]))
+        else:
+            result.append(n)
+    return result
+
+# -----------------------------------------------------------------------------
+# _form_master_re()
+#
+# This function takes a list of all of the regex components and attempts to
+# form the master regular expression.  Given limitations in the Python re
+# module, it may be necessary to break the master regex into separate expressions.
+# -----------------------------------------------------------------------------
+def _form_master_re(relist, reflags, ldict, toknames):
+    if not relist:
+        return []
+    regex = '|'.join(relist)
+    try:
+        lexre = re.compile(regex, reflags)
+
+        # Build the index to function map for the matching engine
+        lexindexfunc = [None] * (max(lexre.groupindex.values()) + 1)
+        lexindexnames = lexindexfunc[:]
+
+        for f, i in lexre.groupindex.items():
+            handle = ldict.get(f, None)
+            if type(handle) in (types.FunctionType, types.MethodType):
+                lexindexfunc[i] = (handle, toknames[f])
+                lexindexnames[i] = f
+            elif handle is not None:
+                lexindexnames[i] = f
+                if f.find('ignore_') > 0:
+                    lexindexfunc[i] = (None, None)
+                else:
+                    lexindexfunc[i] = (None, toknames[f])
+
+        return [(lexre, lexindexfunc)], [regex], [lexindexnames]
+    except Exception:
+        m = int(len(relist)/2)
+        if m == 0:
+            m = 1
+        llist, lre, lnames = _form_master_re(relist[:m], reflags, ldict, toknames)
+        rlist, rre, rnames = _form_master_re(relist[m:], reflags, ldict, toknames)
+        return (llist+rlist), (lre+rre), (lnames+rnames)
+
+# -----------------------------------------------------------------------------
+# def _statetoken(s,names)
+#
+# Given a declaration name s of the form "t_" and a dictionary whose keys are
+# state names, this function returns a tuple (states,tokenname) where states
+# is a tuple of state names and tokenname is the name of the token.  For example,
+# calling this with s = "t_foo_bar_SPAM" might return (('foo','bar'),'SPAM')
+# -----------------------------------------------------------------------------
+def _statetoken(s, names):
+    nonstate = 1
+    parts = s.split('_')
+    for i, part in enumerate(parts[1:], 1):
+        if part not in names and part != 'ANY':
+            break
+
+    if i > 1:
+        states = tuple(parts[1:i])
+    else:
+        states = ('INITIAL',)
+
+    if 'ANY' in states:
+        states = tuple(names)
+
+    tokenname = '_'.join(parts[i:])
+    return (states, tokenname)
+
+
+# -----------------------------------------------------------------------------
+# LexerReflect()
+#
+# This class represents information needed to build a lexer as extracted from a
+# user's input file.
+# -----------------------------------------------------------------------------
+class LexerReflect(object):
+    def __init__(self, ldict, log=None, reflags=0):
+        self.ldict      = ldict
+        self.error_func = None
+        self.tokens     = []
+        self.reflags    = reflags
+        self.stateinfo  = {'INITIAL': 'inclusive'}
+        self.modules    = set()
+        self.error      = False
+        self.log        = PlyLogger(sys.stderr) if log is None else log
+
+    # Get all of the basic information
+    def get_all(self):
+        self.get_tokens()
+        self.get_literals()
+        self.get_states()
+        self.get_rules()
+
+    # Validate all of the information
+    def validate_all(self):
+        self.validate_tokens()
+        self.validate_literals()
+        self.validate_rules()
+        return self.error
+
+    # Get the tokens map
+    def get_tokens(self):
+        tokens = self.ldict.get('tokens', None)
+        if not tokens:
+            self.log.error('No token list is defined')
+            self.error = True
+            return
+
+        if not isinstance(tokens, (list, tuple)):
+            self.log.error('tokens must be a list or tuple')
+            self.error = True
+            return
+
+        if not tokens:
+            self.log.error('tokens is empty')
+            self.error = True
+            return
+
+        self.tokens = tokens
+
+    # Validate the tokens
+    def validate_tokens(self):
+        terminals = {}
+        for n in self.tokens:
+            if not _is_identifier.match(n):
+                self.log.error("Bad token name '%s'", n)
+                self.error = True
+            if n in terminals:
+                self.log.warning("Token '%s' multiply defined", n)
+            terminals[n] = 1
+
+    # Get the literals specifier
+    def get_literals(self):
+        self.literals = self.ldict.get('literals', '')
+        if not self.literals:
+            self.literals = ''
+
+    # Validate literals
+    def validate_literals(self):
+        try:
+            for c in self.literals:
+                if not isinstance(c, StringTypes) or len(c) > 1:
+                    self.log.error('Invalid literal %s. Must be a single character', repr(c))
+                    self.error = True
+
+        except TypeError:
+            self.log.error('Invalid literals specification. literals must be a sequence of characters')
+            self.error = True
+
+    def get_states(self):
+        self.states = self.ldict.get('states', None)
+        # Build statemap
+        if self.states:
+            if not isinstance(self.states, (tuple, list)):
+                self.log.error('states must be defined as a tuple or list')
+                self.error = True
+            else:
+                for s in self.states:
+                    if not isinstance(s, tuple) or len(s) != 2:
+                        self.log.error("Invalid state specifier %s. Must be a tuple (statename,'exclusive|inclusive')", repr(s))
+                        self.error = True
+                        continue
+                    name, statetype = s
+                    if not isinstance(name, StringTypes):
+                        self.log.error('State name %s must be a string', repr(name))
+                        self.error = True
+                        continue
+                    if not (statetype == 'inclusive' or statetype == 'exclusive'):
+                        self.log.error("State type for state %s must be 'inclusive' or 'exclusive'", name)
+                        self.error = True
+                        continue
+                    if name in self.stateinfo:
+                        self.log.error("State '%s' already defined", name)
+                        self.error = True
+                        continue
+                    self.stateinfo[name] = statetype
+
+    # Get all of the symbols with a t_ prefix and sort them into various
+    # categories (functions, strings, error functions, and ignore characters)
+
+    def get_rules(self):
+        tsymbols = [f for f in self.ldict if f[:2] == 't_']
+
+        # Now build up a list of functions and a list of strings
+        self.toknames = {}        # Mapping of symbols to token names
+        self.funcsym  = {}        # Symbols defined as functions
+        self.strsym   = {}        # Symbols defined as strings
+        self.ignore   = {}        # Ignore strings by state
+        self.errorf   = {}        # Error functions by state
+        self.eoff     = {}        # EOF functions by state
+
+        for s in self.stateinfo:
+            self.funcsym[s] = []
+            self.strsym[s] = []
+
+        if len(tsymbols) == 0:
+            self.log.error('No rules of the form t_rulename are defined')
+            self.error = True
+            return
+
+        for f in tsymbols:
+            t = self.ldict[f]
+            states, tokname = _statetoken(f, self.stateinfo)
+            self.toknames[f] = tokname
+
+            if hasattr(t, '__call__'):
+                if tokname == 'error':
+                    for s in states:
+                        self.errorf[s] = t
+                elif tokname == 'eof':
+                    for s in states:
+                        self.eoff[s] = t
+                elif tokname == 'ignore':
+                    line = t.__code__.co_firstlineno
+                    file = t.__code__.co_filename
+                    self.log.error("%s:%d: Rule '%s' must be defined as a string", file, line, t.__name__)
+                    self.error = True
+                else:
+                    for s in states:
+                        self.funcsym[s].append((f, t))
+            elif isinstance(t, StringTypes):
+                if tokname == 'ignore':
+                    for s in states:
+                        self.ignore[s] = t
+                    if '\\' in t:
+                        self.log.warning("%s contains a literal backslash '\\'", f)
+
+                elif tokname == 'error':
+                    self.log.error("Rule '%s' must be defined as a function", f)
+                    self.error = True
+                else:
+                    for s in states:
+                        self.strsym[s].append((f, t))
+            else:
+                self.log.error('%s not defined as a function or string', f)
+                self.error = True
+
+        # Sort the functions by line number
+        for f in self.funcsym.values():
+            f.sort(key=lambda x: x[1].__code__.co_firstlineno)
+
+        # Sort the strings by regular expression length
+        for s in self.strsym.values():
+            s.sort(key=lambda x: len(x[1]), reverse=True)
+
+    # Validate all of the t_rules collected
+    def validate_rules(self):
+        for state in self.stateinfo:
+            # Validate all rules defined by functions
+
+            for fname, f in self.funcsym[state]:
+                line = f.__code__.co_firstlineno
+                file = f.__code__.co_filename
+                module = inspect.getmodule(f)
+                self.modules.add(module)
+
+                tokname = self.toknames[fname]
+                if isinstance(f, types.MethodType):
+                    reqargs = 2
+                else:
+                    reqargs = 1
+                nargs = f.__code__.co_argcount
+                if nargs > reqargs:
+                    self.log.error("%s:%d: Rule '%s' has too many arguments", file, line, f.__name__)
+                    self.error = True
+                    continue
+
+                if nargs < reqargs:
+                    self.log.error("%s:%d: Rule '%s' requires an argument", file, line, f.__name__)
+                    self.error = True
+                    continue
+
+                if not _get_regex(f):
+                    self.log.error("%s:%d: No regular expression defined for rule '%s'", file, line, f.__name__)
+                    self.error = True
+                    continue
+
+                try:
+                    c = re.compile('(?P<%s>%s)' % (fname, _get_regex(f)), self.reflags)
+                    if c.match(''):
+                        self.log.error("%s:%d: Regular expression for rule '%s' matches empty string", file, line, f.__name__)
+                        self.error = True
+                except re.error as e:
+                    self.log.error("%s:%d: Invalid regular expression for rule '%s'. %s", file, line, f.__name__, e)
+                    if '#' in _get_regex(f):
+                        self.log.error("%s:%d. Make sure '#' in rule '%s' is escaped with '\\#'", file, line, f.__name__)
+                    self.error = True
+
+            # Validate all rules defined by strings
+            for name, r in self.strsym[state]:
+                tokname = self.toknames[name]
+                if tokname == 'error':
+                    self.log.error("Rule '%s' must be defined as a function", name)
+                    self.error = True
+                    continue
+
+                if tokname not in self.tokens and tokname.find('ignore_') < 0:
+                    self.log.error("Rule '%s' defined for an unspecified token %s", name, tokname)
+                    self.error = True
+                    continue
+
+                try:
+                    c = re.compile('(?P<%s>%s)' % (name, r), self.reflags)
+                    if (c.match('')):
+                        self.log.error("Regular expression for rule '%s' matches empty string", name)
+                        self.error = True
+                except re.error as e:
+                    self.log.error("Invalid regular expression for rule '%s'. %s", name, e)
+                    if '#' in r:
+                        self.log.error("Make sure '#' in rule '%s' is escaped with '\\#'", name)
+                    self.error = True
+
+            if not self.funcsym[state] and not self.strsym[state]:
+                self.log.error("No rules defined for state '%s'", state)
+                self.error = True
+
+            # Validate the error function
+            efunc = self.errorf.get(state, None)
+            if efunc:
+                f = efunc
+                line = f.__code__.co_firstlineno
+                file = f.__code__.co_filename
+                module = inspect.getmodule(f)
+                self.modules.add(module)
+
+                if isinstance(f, types.MethodType):
+                    reqargs = 2
+                else:
+                    reqargs = 1
+                nargs = f.__code__.co_argcount
+                if nargs > reqargs:
+                    self.log.error("%s:%d: Rule '%s' has too many arguments", file, line, f.__name__)
+                    self.error = True
+
+                if nargs < reqargs:
+                    self.log.error("%s:%d: Rule '%s' requires an argument", file, line, f.__name__)
+                    self.error = True
+
+        for module in self.modules:
+            self.validate_module(module)
+
+    # -----------------------------------------------------------------------------
+    # validate_module()
+    #
+    # This checks to see if there are duplicated t_rulename() functions or strings
+    # in the parser input file.  This is done using a simple regular expression
+    # match on each line in the source code of the given module.
+    # -----------------------------------------------------------------------------
+
+    def validate_module(self, module):
+        try:
+            lines, linen = inspect.getsourcelines(module)
+        except IOError:
+            return
+
+        fre = re.compile(r'\s*def\s+(t_[a-zA-Z_0-9]*)\(')
+        sre = re.compile(r'\s*(t_[a-zA-Z_0-9]*)\s*=')
+
+        counthash = {}
+        linen += 1
+        for line in lines:
+            m = fre.match(line)
+            if not m:
+                m = sre.match(line)
+            if m:
+                name = m.group(1)
+                prev = counthash.get(name)
+                if not prev:
+                    counthash[name] = linen
+                else:
+                    filename = inspect.getsourcefile(module)
+                    self.log.error('%s:%d: Rule %s redefined. Previously defined on line %d', filename, linen, name, prev)
+                    self.error = True
+            linen += 1
+
+# -----------------------------------------------------------------------------
+# lex(module)
+#
+# Build all of the regular expression rules from definitions in the supplied module
+# -----------------------------------------------------------------------------
+def lex(module=None, object=None, debug=False, optimize=False, lextab='lextab',
+        reflags=int(re.VERBOSE), nowarn=False, outputdir=None, debuglog=None, errorlog=None):
+
+    if lextab is None:
+        lextab = 'lextab'
+
+    global lexer
+
+    ldict = None
+    stateinfo  = {'INITIAL': 'inclusive'}
+    lexobj = Lexer()
+    lexobj.lexoptimize = optimize
+    global token, input
+
+    if errorlog is None:
+        errorlog = PlyLogger(sys.stderr)
+
+    if debug:
+        if debuglog is None:
+            debuglog = PlyLogger(sys.stderr)
+
+    # Get the module dictionary used for the lexer
+    if object:
+        module = object
+
+    # Get the module dictionary used for the parser
+    if module:
+        _items = [(k, getattr(module, k)) for k in dir(module)]
+        ldict = dict(_items)
+        # If no __file__ attribute is available, try to obtain it from the __module__ instead
+        if '__file__' not in ldict:
+            ldict['__file__'] = sys.modules[ldict['__module__']].__file__
+    else:
+        ldict = get_caller_module_dict(2)
+
+    # Determine if the module is package of a package or not.
+    # If so, fix the tabmodule setting so that tables load correctly
+    pkg = ldict.get('__package__')
+    if pkg and isinstance(lextab, str):
+        if '.' not in lextab:
+            lextab = pkg + '.' + lextab
+
+    # Collect parser information from the dictionary
+    linfo = LexerReflect(ldict, log=errorlog, reflags=reflags)
+    linfo.get_all()
+    if not optimize:
+        if linfo.validate_all():
+            raise SyntaxError("Can't build lexer")
+
+    if optimize and lextab:
+        try:
+            lexobj.readtab(lextab, ldict)
+            token = lexobj.token
+            input = lexobj.input
+            lexer = lexobj
+            return lexobj
+
+        except ImportError:
+            pass
+
+    # Dump some basic debugging information
+    if debug:
+        debuglog.info('lex: tokens   = %r', linfo.tokens)
+        debuglog.info('lex: literals = %r', linfo.literals)
+        debuglog.info('lex: states   = %r', linfo.stateinfo)
+
+    # Build a dictionary of valid token names
+    lexobj.lextokens = set()
+    for n in linfo.tokens:
+        lexobj.lextokens.add(n)
+
+    # Get literals specification
+    if isinstance(linfo.literals, (list, tuple)):
+        lexobj.lexliterals = type(linfo.literals[0])().join(linfo.literals)
+    else:
+        lexobj.lexliterals = linfo.literals
+
+    lexobj.lextokens_all = lexobj.lextokens | set(lexobj.lexliterals)
+
+    # Get the stateinfo dictionary
+    stateinfo = linfo.stateinfo
+
+    regexs = {}
+    # Build the master regular expressions
+    for state in stateinfo:
+        regex_list = []
+
+        # Add rules defined by functions first
+        for fname, f in linfo.funcsym[state]:
+            line = f.__code__.co_firstlineno
+            file = f.__code__.co_filename
+            regex_list.append('(?P<%s>%s)' % (fname, _get_regex(f)))
+            if debug:
+                debuglog.info("lex: Adding rule %s -> '%s' (state '%s')", fname, _get_regex(f), state)
+
+        # Now add all of the simple rules
+        for name, r in linfo.strsym[state]:
+            regex_list.append('(?P<%s>%s)' % (name, r))
+            if debug:
+                debuglog.info("lex: Adding rule %s -> '%s' (state '%s')", name, r, state)
+
+        regexs[state] = regex_list
+
+    # Build the master regular expressions
+
+    if debug:
+        debuglog.info('lex: ==== MASTER REGEXS FOLLOW ====')
+
+    for state in regexs:
+        lexre, re_text, re_names = _form_master_re(regexs[state], reflags, ldict, linfo.toknames)
+        lexobj.lexstatere[state] = lexre
+        lexobj.lexstateretext[state] = re_text
+        lexobj.lexstaterenames[state] = re_names
+        if debug:
+            for i, text in enumerate(re_text):
+                debuglog.info("lex: state '%s' : regex[%d] = '%s'", state, i, text)
+
+    # For inclusive states, we need to add the regular expressions from the INITIAL state
+    for state, stype in stateinfo.items():
+        if state != 'INITIAL' and stype == 'inclusive':
+            lexobj.lexstatere[state].extend(lexobj.lexstatere['INITIAL'])
+            lexobj.lexstateretext[state].extend(lexobj.lexstateretext['INITIAL'])
+            lexobj.lexstaterenames[state].extend(lexobj.lexstaterenames['INITIAL'])
+
+    lexobj.lexstateinfo = stateinfo
+    lexobj.lexre = lexobj.lexstatere['INITIAL']
+    lexobj.lexretext = lexobj.lexstateretext['INITIAL']
+    lexobj.lexreflags = reflags
+
+    # Set up ignore variables
+    lexobj.lexstateignore = linfo.ignore
+    lexobj.lexignore = lexobj.lexstateignore.get('INITIAL', '')
+
+    # Set up error functions
+    lexobj.lexstateerrorf = linfo.errorf
+    lexobj.lexerrorf = linfo.errorf.get('INITIAL', None)
+    if not lexobj.lexerrorf:
+        errorlog.warning('No t_error rule is defined')
+
+    # Set up eof functions
+    lexobj.lexstateeoff = linfo.eoff
+    lexobj.lexeoff = linfo.eoff.get('INITIAL', None)
+
+    # Check state information for ignore and error rules
+    for s, stype in stateinfo.items():
+        if stype == 'exclusive':
+            if s not in linfo.errorf:
+                errorlog.warning("No error rule is defined for exclusive state '%s'", s)
+            if s not in linfo.ignore and lexobj.lexignore:
+                errorlog.warning("No ignore rule is defined for exclusive state '%s'", s)
+        elif stype == 'inclusive':
+            if s not in linfo.errorf:
+                linfo.errorf[s] = linfo.errorf.get('INITIAL', None)
+            if s not in linfo.ignore:
+                linfo.ignore[s] = linfo.ignore.get('INITIAL', '')
+
+    # Create global versions of the token() and input() functions
+    token = lexobj.token
+    input = lexobj.input
+    lexer = lexobj
+
+    # If in optimize mode, we write the lextab
+    if lextab and optimize:
+        if outputdir is None:
+            # If no output directory is set, the location of the output files
+            # is determined according to the following rules:
+            #     - If lextab specifies a package, files go into that package directory
+            #     - Otherwise, files go in the same directory as the specifying module
+            if isinstance(lextab, types.ModuleType):
+                srcfile = lextab.__file__
+            else:
+                if '.' not in lextab:
+                    srcfile = ldict['__file__']
+                else:
+                    parts = lextab.split('.')
+                    pkgname = '.'.join(parts[:-1])
+                    exec('import %s' % pkgname)
+                    srcfile = getattr(sys.modules[pkgname], '__file__', '')
+            outputdir = os.path.dirname(srcfile)
+        try:
+            lexobj.writetab(lextab, outputdir)
+        except IOError as e:
+            errorlog.warning("Couldn't write lextab module %r. %s" % (lextab, e))
+
+    return lexobj
+
+# -----------------------------------------------------------------------------
+# runmain()
+#
+# This runs the lexer as a main program
+# -----------------------------------------------------------------------------
+
+def runmain(lexer=None, data=None):
+    if not data:
+        try:
+            filename = sys.argv[1]
+            f = open(filename)
+            data = f.read()
+            f.close()
+        except IndexError:
+            sys.stdout.write('Reading from standard input (type EOF to end):\n')
+            data = sys.stdin.read()
+
+    if lexer:
+        _input = lexer.input
+    else:
+        _input = input
+    _input(data)
+    if lexer:
+        _token = lexer.token
+    else:
+        _token = token
+
+    while True:
+        tok = _token()
+        if not tok:
+            break
+        sys.stdout.write('(%s,%r,%d,%d)\n' % (tok.type, tok.value, tok.lineno, tok.lexpos))
+
+# -----------------------------------------------------------------------------
+# @TOKEN(regex)
+#
+# This decorator function can be used to set the regex expression on a function
+# when its docstring might need to be set in an alternative way
+# -----------------------------------------------------------------------------
+
+def TOKEN(r):
+    def set_regex(f):
+        if hasattr(r, '__call__'):
+            f.regex = _get_regex(r)
+        else:
+            f.regex = r
+        return f
+    return set_regex
+
+# Alternative spelling of the TOKEN decorator
+Token = TOKEN
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/yacc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/yacc.py
new file mode 100644
index 0000000000000000000000000000000000000000..20b4f2863cc7193ad4b779a30375c865495fa50c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/yacc.py
@@ -0,0 +1,3494 @@
+# -----------------------------------------------------------------------------
+# ply: yacc.py
+#
+# Copyright (C) 2001-2017
+# David M. Beazley (Dabeaz LLC)
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+# * Redistributions in binary form must reproduce the above copyright notice,
+#   this list of conditions and the following disclaimer in the documentation
+#   and/or other materials provided with the distribution.
+# * Neither the name of the David Beazley or Dabeaz LLC may be used to
+#   endorse or promote products derived from this software without
+#  specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# -----------------------------------------------------------------------------
+#
+# This implements an LR parser that is constructed from grammar rules defined
+# as Python functions. The grammer is specified by supplying the BNF inside
+# Python documentation strings.  The inspiration for this technique was borrowed
+# from John Aycock's Spark parsing system.  PLY might be viewed as cross between
+# Spark and the GNU bison utility.
+#
+# The current implementation is only somewhat object-oriented. The
+# LR parser itself is defined in terms of an object (which allows multiple
+# parsers to co-exist).  However, most of the variables used during table
+# construction are defined in terms of global variables.  Users shouldn't
+# notice unless they are trying to define multiple parsers at the same
+# time using threads (in which case they should have their head examined).
+#
+# This implementation supports both SLR and LALR(1) parsing.  LALR(1)
+# support was originally implemented by Elias Ioup (ezioup@alumni.uchicago.edu),
+# using the algorithm found in Aho, Sethi, and Ullman "Compilers: Principles,
+# Techniques, and Tools" (The Dragon Book).  LALR(1) has since been replaced
+# by the more efficient DeRemer and Pennello algorithm.
+#
+# :::::::: WARNING :::::::
+#
+# Construction of LR parsing tables is fairly complicated and expensive.
+# To make this module run fast, a *LOT* of work has been put into
+# optimization---often at the expensive of readability and what might
+# consider to be good Python "coding style."   Modify the code at your
+# own risk!
+# ----------------------------------------------------------------------------
+
+import re
+import types
+import sys
+import os.path
+import inspect
+import base64
+import warnings
+
+__version__    = '3.10'
+__tabversion__ = '3.10'
+
+#-----------------------------------------------------------------------------
+#                     === User configurable parameters ===
+#
+# Change these to modify the default behavior of yacc (if you wish)
+#-----------------------------------------------------------------------------
+
+yaccdebug   = True             # Debugging mode.  If set, yacc generates a
+                               # a 'parser.out' file in the current directory
+
+debug_file  = 'parser.out'     # Default name of the debugging file
+tab_module  = 'parsetab'       # Default name of the table module
+default_lr  = 'LALR'           # Default LR table generation method
+
+error_count = 3                # Number of symbols that must be shifted to leave recovery mode
+
+yaccdevel   = False            # Set to True if developing yacc.  This turns off optimized
+                               # implementations of certain functions.
+
+resultlimit = 40               # Size limit of results when running in debug mode.
+
+pickle_protocol = 0            # Protocol to use when writing pickle files
+
+# String type-checking compatibility
+if sys.version_info[0] < 3:
+    string_types = basestring
+else:
+    string_types = str
+
+MAXINT = sys.maxsize
+
+# This object is a stand-in for a logging object created by the
+# logging module.   PLY will use this by default to create things
+# such as the parser.out file.  If a user wants more detailed
+# information, they can create their own logging object and pass
+# it into PLY.
+
+class PlyLogger(object):
+    def __init__(self, f):
+        self.f = f
+
+    def debug(self, msg, *args, **kwargs):
+        self.f.write((msg % args) + '\n')
+
+    info = debug
+
+    def warning(self, msg, *args, **kwargs):
+        self.f.write('WARNING: ' + (msg % args) + '\n')
+
+    def error(self, msg, *args, **kwargs):
+        self.f.write('ERROR: ' + (msg % args) + '\n')
+
+    critical = debug
+
+# Null logger is used when no output is generated. Does nothing.
+class NullLogger(object):
+    def __getattribute__(self, name):
+        return self
+
+    def __call__(self, *args, **kwargs):
+        return self
+
+# Exception raised for yacc-related errors
+class YaccError(Exception):
+    pass
+
+# Format the result message that the parser produces when running in debug mode.
+def format_result(r):
+    repr_str = repr(r)
+    if '\n' in repr_str:
+        repr_str = repr(repr_str)
+    if len(repr_str) > resultlimit:
+        repr_str = repr_str[:resultlimit] + ' ...'
+    result = '<%s @ 0x%x> (%s)' % (type(r).__name__, id(r), repr_str)
+    return result
+
+# Format stack entries when the parser is running in debug mode
+def format_stack_entry(r):
+    repr_str = repr(r)
+    if '\n' in repr_str:
+        repr_str = repr(repr_str)
+    if len(repr_str) < 16:
+        return repr_str
+    else:
+        return '<%s @ 0x%x>' % (type(r).__name__, id(r))
+
+# Panic mode error recovery support.   This feature is being reworked--much of the
+# code here is to offer a deprecation/backwards compatible transition
+
+_errok = None
+_token = None
+_restart = None
+_warnmsg = '''PLY: Don't use global functions errok(), token(), and restart() in p_error().
+Instead, invoke the methods on the associated parser instance:
+
+    def p_error(p):
+        ...
+        # Use parser.errok(), parser.token(), parser.restart()
+        ...
+
+    parser = yacc.yacc()
+'''
+
+def errok():
+    warnings.warn(_warnmsg)
+    return _errok()
+
+def restart():
+    warnings.warn(_warnmsg)
+    return _restart()
+
+def token():
+    warnings.warn(_warnmsg)
+    return _token()
+
+# Utility function to call the p_error() function with some deprecation hacks
+def call_errorfunc(errorfunc, token, parser):
+    global _errok, _token, _restart
+    _errok = parser.errok
+    _token = parser.token
+    _restart = parser.restart
+    r = errorfunc(token)
+    try:
+        del _errok, _token, _restart
+    except NameError:
+        pass
+    return r
+
+#-----------------------------------------------------------------------------
+#                        ===  LR Parsing Engine ===
+#
+# The following classes are used for the LR parser itself.  These are not
+# used during table construction and are independent of the actual LR
+# table generation algorithm
+#-----------------------------------------------------------------------------
+
+# This class is used to hold non-terminal grammar symbols during parsing.
+# It normally has the following attributes set:
+#        .type       = Grammar symbol type
+#        .value      = Symbol value
+#        .lineno     = Starting line number
+#        .endlineno  = Ending line number (optional, set automatically)
+#        .lexpos     = Starting lex position
+#        .endlexpos  = Ending lex position (optional, set automatically)
+
+class YaccSymbol:
+    def __str__(self):
+        return self.type
+
+    def __repr__(self):
+        return str(self)
+
+# This class is a wrapper around the objects actually passed to each
+# grammar rule.   Index lookup and assignment actually assign the
+# .value attribute of the underlying YaccSymbol object.
+# The lineno() method returns the line number of a given
+# item (or 0 if not defined).   The linespan() method returns
+# a tuple of (startline,endline) representing the range of lines
+# for a symbol.  The lexspan() method returns a tuple (lexpos,endlexpos)
+# representing the range of positional information for a symbol.
+
+class YaccProduction:
+    def __init__(self, s, stack=None):
+        self.slice = s
+        self.stack = stack
+        self.lexer = None
+        self.parser = None
+
+    def __getitem__(self, n):
+        if isinstance(n, slice):
+            return [s.value for s in self.slice[n]]
+        elif n >= 0:
+            return self.slice[n].value
+        else:
+            return self.stack[n].value
+
+    def __setitem__(self, n, v):
+        self.slice[n].value = v
+
+    def __getslice__(self, i, j):
+        return [s.value for s in self.slice[i:j]]
+
+    def __len__(self):
+        return len(self.slice)
+
+    def lineno(self, n):
+        return getattr(self.slice[n], 'lineno', 0)
+
+    def set_lineno(self, n, lineno):
+        self.slice[n].lineno = lineno
+
+    def linespan(self, n):
+        startline = getattr(self.slice[n], 'lineno', 0)
+        endline = getattr(self.slice[n], 'endlineno', startline)
+        return startline, endline
+
+    def lexpos(self, n):
+        return getattr(self.slice[n], 'lexpos', 0)
+
+    def lexspan(self, n):
+        startpos = getattr(self.slice[n], 'lexpos', 0)
+        endpos = getattr(self.slice[n], 'endlexpos', startpos)
+        return startpos, endpos
+
+    def error(self):
+        raise SyntaxError
+
+# -----------------------------------------------------------------------------
+#                               == LRParser ==
+#
+# The LR Parsing engine.
+# -----------------------------------------------------------------------------
+
+class LRParser:
+    def __init__(self, lrtab, errorf):
+        self.productions = lrtab.lr_productions
+        self.action = lrtab.lr_action
+        self.goto = lrtab.lr_goto
+        self.errorfunc = errorf
+        self.set_defaulted_states()
+        self.errorok = True
+
+    def errok(self):
+        self.errorok = True
+
+    def restart(self):
+        del self.statestack[:]
+        del self.symstack[:]
+        sym = YaccSymbol()
+        sym.type = '$end'
+        self.symstack.append(sym)
+        self.statestack.append(0)
+
+    # Defaulted state support.
+    # This method identifies parser states where there is only one possible reduction action.
+    # For such states, the parser can make a choose to make a rule reduction without consuming
+    # the next look-ahead token.  This delayed invocation of the tokenizer can be useful in
+    # certain kinds of advanced parsing situations where the lexer and parser interact with
+    # each other or change states (i.e., manipulation of scope, lexer states, etc.).
+    #
+    # See:  https://www.gnu.org/software/bison/manual/html_node/Default-Reductions.html#Default-Reductions
+    def set_defaulted_states(self):
+        self.defaulted_states = {}
+        for state, actions in self.action.items():
+            rules = list(actions.values())
+            if len(rules) == 1 and rules[0] < 0:
+                self.defaulted_states[state] = rules[0]
+
+    def disable_defaulted_states(self):
+        self.defaulted_states = {}
+
+    def parse(self, input=None, lexer=None, debug=False, tracking=False, tokenfunc=None):
+        if debug or yaccdevel:
+            if isinstance(debug, int):
+                debug = PlyLogger(sys.stderr)
+            return self.parsedebug(input, lexer, debug, tracking, tokenfunc)
+        elif tracking:
+            return self.parseopt(input, lexer, debug, tracking, tokenfunc)
+        else:
+            return self.parseopt_notrack(input, lexer, debug, tracking, tokenfunc)
+
+
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+    # parsedebug().
+    #
+    # This is the debugging enabled version of parse().  All changes made to the
+    # parsing engine should be made here.   Optimized versions of this function
+    # are automatically created by the ply/ygen.py script.  This script cuts out
+    # sections enclosed in markers such as this:
+    #
+    #      #--! DEBUG
+    #      statements
+    #      #--! DEBUG
+    #
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+    def parsedebug(self, input=None, lexer=None, debug=False, tracking=False, tokenfunc=None):
+        #--! parsedebug-start
+        lookahead = None                         # Current lookahead symbol
+        lookaheadstack = []                      # Stack of lookahead symbols
+        actions = self.action                    # Local reference to action table (to avoid lookup on self.)
+        goto    = self.goto                      # Local reference to goto table (to avoid lookup on self.)
+        prod    = self.productions               # Local reference to production list (to avoid lookup on self.)
+        defaulted_states = self.defaulted_states # Local reference to defaulted states
+        pslice  = YaccProduction(None)           # Production object passed to grammar rules
+        errorcount = 0                           # Used during error recovery
+
+        #--! DEBUG
+        debug.info('PLY: PARSE DEBUG START')
+        #--! DEBUG
+
+        # If no lexer was given, we will try to use the lex module
+        if not lexer:
+            from . import lex
+            lexer = lex.lexer
+
+        # Set up the lexer and parser objects on pslice
+        pslice.lexer = lexer
+        pslice.parser = self
+
+        # If input was supplied, pass to lexer
+        if input is not None:
+            lexer.input(input)
+
+        if tokenfunc is None:
+            # Tokenize function
+            get_token = lexer.token
+        else:
+            get_token = tokenfunc
+
+        # Set the parser() token method (sometimes used in error recovery)
+        self.token = get_token
+
+        # Set up the state and symbol stacks
+
+        statestack = []                # Stack of parsing states
+        self.statestack = statestack
+        symstack   = []                # Stack of grammar symbols
+        self.symstack = symstack
+
+        pslice.stack = symstack         # Put in the production
+        errtoken   = None               # Err token
+
+        # The start state is assumed to be (0,$end)
+
+        statestack.append(0)
+        sym = YaccSymbol()
+        sym.type = '$end'
+        symstack.append(sym)
+        state = 0
+        while True:
+            # Get the next symbol on the input.  If a lookahead symbol
+            # is already set, we just use that. Otherwise, we'll pull
+            # the next token off of the lookaheadstack or from the lexer
+
+            #--! DEBUG
+            debug.debug('')
+            debug.debug('State  : %s', state)
+            #--! DEBUG
+
+            if state not in defaulted_states:
+                if not lookahead:
+                    if not lookaheadstack:
+                        lookahead = get_token()     # Get the next token
+                    else:
+                        lookahead = lookaheadstack.pop()
+                    if not lookahead:
+                        lookahead = YaccSymbol()
+                        lookahead.type = '$end'
+
+                # Check the action table
+                ltype = lookahead.type
+                t = actions[state].get(ltype)
+            else:
+                t = defaulted_states[state]
+                #--! DEBUG
+                debug.debug('Defaulted state %s: Reduce using %d', state, -t)
+                #--! DEBUG
+
+            #--! DEBUG
+            debug.debug('Stack  : %s',
+                        ('%s . %s' % (' '.join([xx.type for xx in symstack][1:]), str(lookahead))).lstrip())
+            #--! DEBUG
+
+            if t is not None:
+                if t > 0:
+                    # shift a symbol on the stack
+                    statestack.append(t)
+                    state = t
+
+                    #--! DEBUG
+                    debug.debug('Action : Shift and goto state %s', t)
+                    #--! DEBUG
+
+                    symstack.append(lookahead)
+                    lookahead = None
+
+                    # Decrease error count on successful shift
+                    if errorcount:
+                        errorcount -= 1
+                    continue
+
+                if t < 0:
+                    # reduce a symbol on the stack, emit a production
+                    p = prod[-t]
+                    pname = p.name
+                    plen  = p.len
+
+                    # Get production function
+                    sym = YaccSymbol()
+                    sym.type = pname       # Production name
+                    sym.value = None
+
+                    #--! DEBUG
+                    if plen:
+                        debug.info('Action : Reduce rule [%s] with %s and goto state %d', p.str,
+                                   '['+','.join([format_stack_entry(_v.value) for _v in symstack[-plen:]])+']',
+                                   goto[statestack[-1-plen]][pname])
+                    else:
+                        debug.info('Action : Reduce rule [%s] with %s and goto state %d', p.str, [],
+                                   goto[statestack[-1]][pname])
+
+                    #--! DEBUG
+
+                    if plen:
+                        targ = symstack[-plen-1:]
+                        targ[0] = sym
+
+                        #--! TRACKING
+                        if tracking:
+                            t1 = targ[1]
+                            sym.lineno = t1.lineno
+                            sym.lexpos = t1.lexpos
+                            t1 = targ[-1]
+                            sym.endlineno = getattr(t1, 'endlineno', t1.lineno)
+                            sym.endlexpos = getattr(t1, 'endlexpos', t1.lexpos)
+                        #--! TRACKING
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # below as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            del symstack[-plen:]
+                            self.state = state
+                            p.callable(pslice)
+                            del statestack[-plen:]
+                            #--! DEBUG
+                            debug.info('Result : %s', format_result(pslice[0]))
+                            #--! DEBUG
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            symstack.extend(targ[1:-1])         # Put the production slice back on the stack
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                    else:
+
+                        #--! TRACKING
+                        if tracking:
+                            sym.lineno = lexer.lineno
+                            sym.lexpos = lexer.lexpos
+                        #--! TRACKING
+
+                        targ = [sym]
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # above as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            self.state = state
+                            p.callable(pslice)
+                            #--! DEBUG
+                            debug.info('Result : %s', format_result(pslice[0]))
+                            #--! DEBUG
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                if t == 0:
+                    n = symstack[-1]
+                    result = getattr(n, 'value', None)
+                    #--! DEBUG
+                    debug.info('Done   : Returning %s', format_result(result))
+                    debug.info('PLY: PARSE DEBUG END')
+                    #--! DEBUG
+                    return result
+
+            if t is None:
+
+                #--! DEBUG
+                debug.error('Error  : %s',
+                            ('%s . %s' % (' '.join([xx.type for xx in symstack][1:]), str(lookahead))).lstrip())
+                #--! DEBUG
+
+                # We have some kind of parsing error here.  To handle
+                # this, we are going to push the current token onto
+                # the tokenstack and replace it with an 'error' token.
+                # If there are any synchronization rules, they may
+                # catch it.
+                #
+                # In addition to pushing the error token, we call call
+                # the user defined p_error() function if this is the
+                # first syntax error.  This function is only called if
+                # errorcount == 0.
+                if errorcount == 0 or self.errorok:
+                    errorcount = error_count
+                    self.errorok = False
+                    errtoken = lookahead
+                    if errtoken.type == '$end':
+                        errtoken = None               # End of file!
+                    if self.errorfunc:
+                        if errtoken and not hasattr(errtoken, 'lexer'):
+                            errtoken.lexer = lexer
+                        self.state = state
+                        tok = call_errorfunc(self.errorfunc, errtoken, self)
+                        if self.errorok:
+                            # User must have done some kind of panic
+                            # mode recovery on their own.  The
+                            # returned token is the next lookahead
+                            lookahead = tok
+                            errtoken = None
+                            continue
+                    else:
+                        if errtoken:
+                            if hasattr(errtoken, 'lineno'):
+                                lineno = lookahead.lineno
+                            else:
+                                lineno = 0
+                            if lineno:
+                                sys.stderr.write('yacc: Syntax error at line %d, token=%s\n' % (lineno, errtoken.type))
+                            else:
+                                sys.stderr.write('yacc: Syntax error, token=%s' % errtoken.type)
+                        else:
+                            sys.stderr.write('yacc: Parse error in input. EOF\n')
+                            return
+
+                else:
+                    errorcount = error_count
+
+                # case 1:  the statestack only has 1 entry on it.  If we're in this state, the
+                # entire parse has been rolled back and we're completely hosed.   The token is
+                # discarded and we just keep going.
+
+                if len(statestack) <= 1 and lookahead.type != '$end':
+                    lookahead = None
+                    errtoken = None
+                    state = 0
+                    # Nuke the pushback stack
+                    del lookaheadstack[:]
+                    continue
+
+                # case 2: the statestack has a couple of entries on it, but we're
+                # at the end of the file. nuke the top entry and generate an error token
+
+                # Start nuking entries on the stack
+                if lookahead.type == '$end':
+                    # Whoa. We're really hosed here. Bail out
+                    return
+
+                if lookahead.type != 'error':
+                    sym = symstack[-1]
+                    if sym.type == 'error':
+                        # Hmmm. Error is on top of stack, we'll just nuke input
+                        # symbol and continue
+                        #--! TRACKING
+                        if tracking:
+                            sym.endlineno = getattr(lookahead, 'lineno', sym.lineno)
+                            sym.endlexpos = getattr(lookahead, 'lexpos', sym.lexpos)
+                        #--! TRACKING
+                        lookahead = None
+                        continue
+
+                    # Create the error symbol for the first time and make it the new lookahead symbol
+                    t = YaccSymbol()
+                    t.type = 'error'
+
+                    if hasattr(lookahead, 'lineno'):
+                        t.lineno = t.endlineno = lookahead.lineno
+                    if hasattr(lookahead, 'lexpos'):
+                        t.lexpos = t.endlexpos = lookahead.lexpos
+                    t.value = lookahead
+                    lookaheadstack.append(lookahead)
+                    lookahead = t
+                else:
+                    sym = symstack.pop()
+                    #--! TRACKING
+                    if tracking:
+                        lookahead.lineno = sym.lineno
+                        lookahead.lexpos = sym.lexpos
+                    #--! TRACKING
+                    statestack.pop()
+                    state = statestack[-1]
+
+                continue
+
+            # Call an error function here
+            raise RuntimeError('yacc: internal parser error!!!\n')
+
+        #--! parsedebug-end
+
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+    # parseopt().
+    #
+    # Optimized version of parse() method.  DO NOT EDIT THIS CODE DIRECTLY!
+    # This code is automatically generated by the ply/ygen.py script. Make
+    # changes to the parsedebug() method instead.
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+    def parseopt(self, input=None, lexer=None, debug=False, tracking=False, tokenfunc=None):
+        #--! parseopt-start
+        lookahead = None                         # Current lookahead symbol
+        lookaheadstack = []                      # Stack of lookahead symbols
+        actions = self.action                    # Local reference to action table (to avoid lookup on self.)
+        goto    = self.goto                      # Local reference to goto table (to avoid lookup on self.)
+        prod    = self.productions               # Local reference to production list (to avoid lookup on self.)
+        defaulted_states = self.defaulted_states # Local reference to defaulted states
+        pslice  = YaccProduction(None)           # Production object passed to grammar rules
+        errorcount = 0                           # Used during error recovery
+
+
+        # If no lexer was given, we will try to use the lex module
+        if not lexer:
+            from . import lex
+            lexer = lex.lexer
+
+        # Set up the lexer and parser objects on pslice
+        pslice.lexer = lexer
+        pslice.parser = self
+
+        # If input was supplied, pass to lexer
+        if input is not None:
+            lexer.input(input)
+
+        if tokenfunc is None:
+            # Tokenize function
+            get_token = lexer.token
+        else:
+            get_token = tokenfunc
+
+        # Set the parser() token method (sometimes used in error recovery)
+        self.token = get_token
+
+        # Set up the state and symbol stacks
+
+        statestack = []                # Stack of parsing states
+        self.statestack = statestack
+        symstack   = []                # Stack of grammar symbols
+        self.symstack = symstack
+
+        pslice.stack = symstack         # Put in the production
+        errtoken   = None               # Err token
+
+        # The start state is assumed to be (0,$end)
+
+        statestack.append(0)
+        sym = YaccSymbol()
+        sym.type = '$end'
+        symstack.append(sym)
+        state = 0
+        while True:
+            # Get the next symbol on the input.  If a lookahead symbol
+            # is already set, we just use that. Otherwise, we'll pull
+            # the next token off of the lookaheadstack or from the lexer
+
+
+            if state not in defaulted_states:
+                if not lookahead:
+                    if not lookaheadstack:
+                        lookahead = get_token()     # Get the next token
+                    else:
+                        lookahead = lookaheadstack.pop()
+                    if not lookahead:
+                        lookahead = YaccSymbol()
+                        lookahead.type = '$end'
+
+                # Check the action table
+                ltype = lookahead.type
+                t = actions[state].get(ltype)
+            else:
+                t = defaulted_states[state]
+
+
+            if t is not None:
+                if t > 0:
+                    # shift a symbol on the stack
+                    statestack.append(t)
+                    state = t
+
+
+                    symstack.append(lookahead)
+                    lookahead = None
+
+                    # Decrease error count on successful shift
+                    if errorcount:
+                        errorcount -= 1
+                    continue
+
+                if t < 0:
+                    # reduce a symbol on the stack, emit a production
+                    p = prod[-t]
+                    pname = p.name
+                    plen  = p.len
+
+                    # Get production function
+                    sym = YaccSymbol()
+                    sym.type = pname       # Production name
+                    sym.value = None
+
+
+                    if plen:
+                        targ = symstack[-plen-1:]
+                        targ[0] = sym
+
+                        #--! TRACKING
+                        if tracking:
+                            t1 = targ[1]
+                            sym.lineno = t1.lineno
+                            sym.lexpos = t1.lexpos
+                            t1 = targ[-1]
+                            sym.endlineno = getattr(t1, 'endlineno', t1.lineno)
+                            sym.endlexpos = getattr(t1, 'endlexpos', t1.lexpos)
+                        #--! TRACKING
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # below as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            del symstack[-plen:]
+                            self.state = state
+                            p.callable(pslice)
+                            del statestack[-plen:]
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            symstack.extend(targ[1:-1])         # Put the production slice back on the stack
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                    else:
+
+                        #--! TRACKING
+                        if tracking:
+                            sym.lineno = lexer.lineno
+                            sym.lexpos = lexer.lexpos
+                        #--! TRACKING
+
+                        targ = [sym]
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # above as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            self.state = state
+                            p.callable(pslice)
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                if t == 0:
+                    n = symstack[-1]
+                    result = getattr(n, 'value', None)
+                    return result
+
+            if t is None:
+
+
+                # We have some kind of parsing error here.  To handle
+                # this, we are going to push the current token onto
+                # the tokenstack and replace it with an 'error' token.
+                # If there are any synchronization rules, they may
+                # catch it.
+                #
+                # In addition to pushing the error token, we call call
+                # the user defined p_error() function if this is the
+                # first syntax error.  This function is only called if
+                # errorcount == 0.
+                if errorcount == 0 or self.errorok:
+                    errorcount = error_count
+                    self.errorok = False
+                    errtoken = lookahead
+                    if errtoken.type == '$end':
+                        errtoken = None               # End of file!
+                    if self.errorfunc:
+                        if errtoken and not hasattr(errtoken, 'lexer'):
+                            errtoken.lexer = lexer
+                        self.state = state
+                        tok = call_errorfunc(self.errorfunc, errtoken, self)
+                        if self.errorok:
+                            # User must have done some kind of panic
+                            # mode recovery on their own.  The
+                            # returned token is the next lookahead
+                            lookahead = tok
+                            errtoken = None
+                            continue
+                    else:
+                        if errtoken:
+                            if hasattr(errtoken, 'lineno'):
+                                lineno = lookahead.lineno
+                            else:
+                                lineno = 0
+                            if lineno:
+                                sys.stderr.write('yacc: Syntax error at line %d, token=%s\n' % (lineno, errtoken.type))
+                            else:
+                                sys.stderr.write('yacc: Syntax error, token=%s' % errtoken.type)
+                        else:
+                            sys.stderr.write('yacc: Parse error in input. EOF\n')
+                            return
+
+                else:
+                    errorcount = error_count
+
+                # case 1:  the statestack only has 1 entry on it.  If we're in this state, the
+                # entire parse has been rolled back and we're completely hosed.   The token is
+                # discarded and we just keep going.
+
+                if len(statestack) <= 1 and lookahead.type != '$end':
+                    lookahead = None
+                    errtoken = None
+                    state = 0
+                    # Nuke the pushback stack
+                    del lookaheadstack[:]
+                    continue
+
+                # case 2: the statestack has a couple of entries on it, but we're
+                # at the end of the file. nuke the top entry and generate an error token
+
+                # Start nuking entries on the stack
+                if lookahead.type == '$end':
+                    # Whoa. We're really hosed here. Bail out
+                    return
+
+                if lookahead.type != 'error':
+                    sym = symstack[-1]
+                    if sym.type == 'error':
+                        # Hmmm. Error is on top of stack, we'll just nuke input
+                        # symbol and continue
+                        #--! TRACKING
+                        if tracking:
+                            sym.endlineno = getattr(lookahead, 'lineno', sym.lineno)
+                            sym.endlexpos = getattr(lookahead, 'lexpos', sym.lexpos)
+                        #--! TRACKING
+                        lookahead = None
+                        continue
+
+                    # Create the error symbol for the first time and make it the new lookahead symbol
+                    t = YaccSymbol()
+                    t.type = 'error'
+
+                    if hasattr(lookahead, 'lineno'):
+                        t.lineno = t.endlineno = lookahead.lineno
+                    if hasattr(lookahead, 'lexpos'):
+                        t.lexpos = t.endlexpos = lookahead.lexpos
+                    t.value = lookahead
+                    lookaheadstack.append(lookahead)
+                    lookahead = t
+                else:
+                    sym = symstack.pop()
+                    #--! TRACKING
+                    if tracking:
+                        lookahead.lineno = sym.lineno
+                        lookahead.lexpos = sym.lexpos
+                    #--! TRACKING
+                    statestack.pop()
+                    state = statestack[-1]
+
+                continue
+
+            # Call an error function here
+            raise RuntimeError('yacc: internal parser error!!!\n')
+
+        #--! parseopt-end
+
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+    # parseopt_notrack().
+    #
+    # Optimized version of parseopt() with line number tracking removed.
+    # DO NOT EDIT THIS CODE DIRECTLY. This code is automatically generated
+    # by the ply/ygen.py script. Make changes to the parsedebug() method instead.
+    # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+    def parseopt_notrack(self, input=None, lexer=None, debug=False, tracking=False, tokenfunc=None):
+        #--! parseopt-notrack-start
+        lookahead = None                         # Current lookahead symbol
+        lookaheadstack = []                      # Stack of lookahead symbols
+        actions = self.action                    # Local reference to action table (to avoid lookup on self.)
+        goto    = self.goto                      # Local reference to goto table (to avoid lookup on self.)
+        prod    = self.productions               # Local reference to production list (to avoid lookup on self.)
+        defaulted_states = self.defaulted_states # Local reference to defaulted states
+        pslice  = YaccProduction(None)           # Production object passed to grammar rules
+        errorcount = 0                           # Used during error recovery
+
+
+        # If no lexer was given, we will try to use the lex module
+        if not lexer:
+            from . import lex
+            lexer = lex.lexer
+
+        # Set up the lexer and parser objects on pslice
+        pslice.lexer = lexer
+        pslice.parser = self
+
+        # If input was supplied, pass to lexer
+        if input is not None:
+            lexer.input(input)
+
+        if tokenfunc is None:
+            # Tokenize function
+            get_token = lexer.token
+        else:
+            get_token = tokenfunc
+
+        # Set the parser() token method (sometimes used in error recovery)
+        self.token = get_token
+
+        # Set up the state and symbol stacks
+
+        statestack = []                # Stack of parsing states
+        self.statestack = statestack
+        symstack   = []                # Stack of grammar symbols
+        self.symstack = symstack
+
+        pslice.stack = symstack         # Put in the production
+        errtoken   = None               # Err token
+
+        # The start state is assumed to be (0,$end)
+
+        statestack.append(0)
+        sym = YaccSymbol()
+        sym.type = '$end'
+        symstack.append(sym)
+        state = 0
+        while True:
+            # Get the next symbol on the input.  If a lookahead symbol
+            # is already set, we just use that. Otherwise, we'll pull
+            # the next token off of the lookaheadstack or from the lexer
+
+
+            if state not in defaulted_states:
+                if not lookahead:
+                    if not lookaheadstack:
+                        lookahead = get_token()     # Get the next token
+                    else:
+                        lookahead = lookaheadstack.pop()
+                    if not lookahead:
+                        lookahead = YaccSymbol()
+                        lookahead.type = '$end'
+
+                # Check the action table
+                ltype = lookahead.type
+                t = actions[state].get(ltype)
+            else:
+                t = defaulted_states[state]
+
+
+            if t is not None:
+                if t > 0:
+                    # shift a symbol on the stack
+                    statestack.append(t)
+                    state = t
+
+
+                    symstack.append(lookahead)
+                    lookahead = None
+
+                    # Decrease error count on successful shift
+                    if errorcount:
+                        errorcount -= 1
+                    continue
+
+                if t < 0:
+                    # reduce a symbol on the stack, emit a production
+                    p = prod[-t]
+                    pname = p.name
+                    plen  = p.len
+
+                    # Get production function
+                    sym = YaccSymbol()
+                    sym.type = pname       # Production name
+                    sym.value = None
+
+
+                    if plen:
+                        targ = symstack[-plen-1:]
+                        targ[0] = sym
+
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # below as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            del symstack[-plen:]
+                            self.state = state
+                            p.callable(pslice)
+                            del statestack[-plen:]
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            symstack.extend(targ[1:-1])         # Put the production slice back on the stack
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                    else:
+
+
+                        targ = [sym]
+
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+                        # The code enclosed in this section is duplicated
+                        # above as a performance optimization.  Make sure
+                        # changes get made in both locations.
+
+                        pslice.slice = targ
+
+                        try:
+                            # Call the grammar rule with our special slice object
+                            self.state = state
+                            p.callable(pslice)
+                            symstack.append(sym)
+                            state = goto[statestack[-1]][pname]
+                            statestack.append(state)
+                        except SyntaxError:
+                            # If an error was set. Enter error recovery state
+                            lookaheadstack.append(lookahead)    # Save the current lookahead token
+                            statestack.pop()                    # Pop back one state (before the reduce)
+                            state = statestack[-1]
+                            sym.type = 'error'
+                            sym.value = 'error'
+                            lookahead = sym
+                            errorcount = error_count
+                            self.errorok = False
+
+                        continue
+                        # !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+                if t == 0:
+                    n = symstack[-1]
+                    result = getattr(n, 'value', None)
+                    return result
+
+            if t is None:
+
+
+                # We have some kind of parsing error here.  To handle
+                # this, we are going to push the current token onto
+                # the tokenstack and replace it with an 'error' token.
+                # If there are any synchronization rules, they may
+                # catch it.
+                #
+                # In addition to pushing the error token, we call call
+                # the user defined p_error() function if this is the
+                # first syntax error.  This function is only called if
+                # errorcount == 0.
+                if errorcount == 0 or self.errorok:
+                    errorcount = error_count
+                    self.errorok = False
+                    errtoken = lookahead
+                    if errtoken.type == '$end':
+                        errtoken = None               # End of file!
+                    if self.errorfunc:
+                        if errtoken and not hasattr(errtoken, 'lexer'):
+                            errtoken.lexer = lexer
+                        self.state = state
+                        tok = call_errorfunc(self.errorfunc, errtoken, self)
+                        if self.errorok:
+                            # User must have done some kind of panic
+                            # mode recovery on their own.  The
+                            # returned token is the next lookahead
+                            lookahead = tok
+                            errtoken = None
+                            continue
+                    else:
+                        if errtoken:
+                            if hasattr(errtoken, 'lineno'):
+                                lineno = lookahead.lineno
+                            else:
+                                lineno = 0
+                            if lineno:
+                                sys.stderr.write('yacc: Syntax error at line %d, token=%s\n' % (lineno, errtoken.type))
+                            else:
+                                sys.stderr.write('yacc: Syntax error, token=%s' % errtoken.type)
+                        else:
+                            sys.stderr.write('yacc: Parse error in input. EOF\n')
+                            return
+
+                else:
+                    errorcount = error_count
+
+                # case 1:  the statestack only has 1 entry on it.  If we're in this state, the
+                # entire parse has been rolled back and we're completely hosed.   The token is
+                # discarded and we just keep going.
+
+                if len(statestack) <= 1 and lookahead.type != '$end':
+                    lookahead = None
+                    errtoken = None
+                    state = 0
+                    # Nuke the pushback stack
+                    del lookaheadstack[:]
+                    continue
+
+                # case 2: the statestack has a couple of entries on it, but we're
+                # at the end of the file. nuke the top entry and generate an error token
+
+                # Start nuking entries on the stack
+                if lookahead.type == '$end':
+                    # Whoa. We're really hosed here. Bail out
+                    return
+
+                if lookahead.type != 'error':
+                    sym = symstack[-1]
+                    if sym.type == 'error':
+                        # Hmmm. Error is on top of stack, we'll just nuke input
+                        # symbol and continue
+                        lookahead = None
+                        continue
+
+                    # Create the error symbol for the first time and make it the new lookahead symbol
+                    t = YaccSymbol()
+                    t.type = 'error'
+
+                    if hasattr(lookahead, 'lineno'):
+                        t.lineno = t.endlineno = lookahead.lineno
+                    if hasattr(lookahead, 'lexpos'):
+                        t.lexpos = t.endlexpos = lookahead.lexpos
+                    t.value = lookahead
+                    lookaheadstack.append(lookahead)
+                    lookahead = t
+                else:
+                    sym = symstack.pop()
+                    statestack.pop()
+                    state = statestack[-1]
+
+                continue
+
+            # Call an error function here
+            raise RuntimeError('yacc: internal parser error!!!\n')
+
+        #--! parseopt-notrack-end
+
+# -----------------------------------------------------------------------------
+#                          === Grammar Representation ===
+#
+# The following functions, classes, and variables are used to represent and
+# manipulate the rules that make up a grammar.
+# -----------------------------------------------------------------------------
+
+# regex matching identifiers
+_is_identifier = re.compile(r'^[a-zA-Z0-9_-]+$')
+
+# -----------------------------------------------------------------------------
+# class Production:
+#
+# This class stores the raw information about a single production or grammar rule.
+# A grammar rule refers to a specification such as this:
+#
+#       expr : expr PLUS term
+#
+# Here are the basic attributes defined on all productions
+#
+#       name     - Name of the production.  For example 'expr'
+#       prod     - A list of symbols on the right side ['expr','PLUS','term']
+#       prec     - Production precedence level
+#       number   - Production number.
+#       func     - Function that executes on reduce
+#       file     - File where production function is defined
+#       lineno   - Line number where production function is defined
+#
+# The following attributes are defined or optional.
+#
+#       len       - Length of the production (number of symbols on right hand side)
+#       usyms     - Set of unique symbols found in the production
+# -----------------------------------------------------------------------------
+
+class Production(object):
+    reduced = 0
+    def __init__(self, number, name, prod, precedence=('right', 0), func=None, file='', line=0):
+        self.name     = name
+        self.prod     = tuple(prod)
+        self.number   = number
+        self.func     = func
+        self.callable = None
+        self.file     = file
+        self.line     = line
+        self.prec     = precedence
+
+        # Internal settings used during table construction
+
+        self.len  = len(self.prod)   # Length of the production
+
+        # Create a list of unique production symbols used in the production
+        self.usyms = []
+        for s in self.prod:
+            if s not in self.usyms:
+                self.usyms.append(s)
+
+        # List of all LR items for the production
+        self.lr_items = []
+        self.lr_next = None
+
+        # Create a string representation
+        if self.prod:
+            self.str = '%s -> %s' % (self.name, ' '.join(self.prod))
+        else:
+            self.str = '%s -> <empty>' % self.name
+
+    def __str__(self):
+        return self.str
+
+    def __repr__(self):
+        return 'Production(' + str(self) + ')'
+
+    def __len__(self):
+        return len(self.prod)
+
+    def __nonzero__(self):
+        return 1
+
+    def __getitem__(self, index):
+        return self.prod[index]
+
+    # Return the nth lr_item from the production (or None if at the end)
+    def lr_item(self, n):
+        if n > len(self.prod):
+            return None
+        p = LRItem(self, n)
+        # Precompute the list of productions immediately following.
+        try:
+            p.lr_after = Prodnames[p.prod[n+1]]
+        except (IndexError, KeyError):
+            p.lr_after = []
+        try:
+            p.lr_before = p.prod[n-1]
+        except IndexError:
+            p.lr_before = None
+        return p
+
+    # Bind the production function name to a callable
+    def bind(self, pdict):
+        if self.func:
+            self.callable = pdict[self.func]
+
+# This class serves as a minimal standin for Production objects when
+# reading table data from files.   It only contains information
+# actually used by the LR parsing engine, plus some additional
+# debugging information.
+class MiniProduction(object):
+    def __init__(self, str, name, len, func, file, line):
+        self.name     = name
+        self.len      = len
+        self.func     = func
+        self.callable = None
+        self.file     = file
+        self.line     = line
+        self.str      = str
+
+    def __str__(self):
+        return self.str
+
+    def __repr__(self):
+        return 'MiniProduction(%s)' % self.str
+
+    # Bind the production function name to a callable
+    def bind(self, pdict):
+        if self.func:
+            self.callable = pdict[self.func]
+
+
+# -----------------------------------------------------------------------------
+# class LRItem
+#
+# This class represents a specific stage of parsing a production rule.  For
+# example:
+#
+#       expr : expr . PLUS term
+#
+# In the above, the "." represents the current location of the parse.  Here
+# basic attributes:
+#
+#       name       - Name of the production.  For example 'expr'
+#       prod       - A list of symbols on the right side ['expr','.', 'PLUS','term']
+#       number     - Production number.
+#
+#       lr_next      Next LR item. Example, if we are ' expr -> expr . PLUS term'
+#                    then lr_next refers to 'expr -> expr PLUS . term'
+#       lr_index   - LR item index (location of the ".") in the prod list.
+#       lookaheads - LALR lookahead symbols for this item
+#       len        - Length of the production (number of symbols on right hand side)
+#       lr_after    - List of all productions that immediately follow
+#       lr_before   - Grammar symbol immediately before
+# -----------------------------------------------------------------------------
+
+class LRItem(object):
+    def __init__(self, p, n):
+        self.name       = p.name
+        self.prod       = list(p.prod)
+        self.number     = p.number
+        self.lr_index   = n
+        self.lookaheads = {}
+        self.prod.insert(n, '.')
+        self.prod       = tuple(self.prod)
+        self.len        = len(self.prod)
+        self.usyms      = p.usyms
+
+    def __str__(self):
+        if self.prod:
+            s = '%s -> %s' % (self.name, ' '.join(self.prod))
+        else:
+            s = '%s -> <empty>' % self.name
+        return s
+
+    def __repr__(self):
+        return 'LRItem(' + str(self) + ')'
+
+# -----------------------------------------------------------------------------
+# rightmost_terminal()
+#
+# Return the rightmost terminal from a list of symbols.  Used in add_production()
+# -----------------------------------------------------------------------------
+def rightmost_terminal(symbols, terminals):
+    i = len(symbols) - 1
+    while i >= 0:
+        if symbols[i] in terminals:
+            return symbols[i]
+        i -= 1
+    return None
+
+# -----------------------------------------------------------------------------
+#                           === GRAMMAR CLASS ===
+#
+# The following class represents the contents of the specified grammar along
+# with various computed properties such as first sets, follow sets, LR items, etc.
+# This data is used for critical parts of the table generation process later.
+# -----------------------------------------------------------------------------
+
+class GrammarError(YaccError):
+    pass
+
+class Grammar(object):
+    def __init__(self, terminals):
+        self.Productions  = [None]  # A list of all of the productions.  The first
+                                    # entry is always reserved for the purpose of
+                                    # building an augmented grammar
+
+        self.Prodnames    = {}      # A dictionary mapping the names of nonterminals to a list of all
+                                    # productions of that nonterminal.
+
+        self.Prodmap      = {}      # A dictionary that is only used to detect duplicate
+                                    # productions.
+
+        self.Terminals    = {}      # A dictionary mapping the names of terminal symbols to a
+                                    # list of the rules where they are used.
+
+        for term in terminals:
+            self.Terminals[term] = []
+
+        self.Terminals['error'] = []
+
+        self.Nonterminals = {}      # A dictionary mapping names of nonterminals to a list
+                                    # of rule numbers where they are used.
+
+        self.First        = {}      # A dictionary of precomputed FIRST(x) symbols
+
+        self.Follow       = {}      # A dictionary of precomputed FOLLOW(x) symbols
+
+        self.Precedence   = {}      # Precedence rules for each terminal. Contains tuples of the
+                                    # form ('right',level) or ('nonassoc', level) or ('left',level)
+
+        self.UsedPrecedence = set() # Precedence rules that were actually used by the grammer.
+                                    # This is only used to provide error checking and to generate
+                                    # a warning about unused precedence rules.
+
+        self.Start = None           # Starting symbol for the grammar
+
+
+    def __len__(self):
+        return len(self.Productions)
+
+    def __getitem__(self, index):
+        return self.Productions[index]
+
+    # -----------------------------------------------------------------------------
+    # set_precedence()
+    #
+    # Sets the precedence for a given terminal. assoc is the associativity such as
+    # 'left','right', or 'nonassoc'.  level is a numeric level.
+    #
+    # -----------------------------------------------------------------------------
+
+    def set_precedence(self, term, assoc, level):
+        assert self.Productions == [None], 'Must call set_precedence() before add_production()'
+        if term in self.Precedence:
+            raise GrammarError('Precedence already specified for terminal %r' % term)
+        if assoc not in ['left', 'right', 'nonassoc']:
+            raise GrammarError("Associativity must be one of 'left','right', or 'nonassoc'")
+        self.Precedence[term] = (assoc, level)
+
+    # -----------------------------------------------------------------------------
+    # add_production()
+    #
+    # Given an action function, this function assembles a production rule and
+    # computes its precedence level.
+    #
+    # The production rule is supplied as a list of symbols.   For example,
+    # a rule such as 'expr : expr PLUS term' has a production name of 'expr' and
+    # symbols ['expr','PLUS','term'].
+    #
+    # Precedence is determined by the precedence of the right-most non-terminal
+    # or the precedence of a terminal specified by %prec.
+    #
+    # A variety of error checks are performed to make sure production symbols
+    # are valid and that %prec is used correctly.
+    # -----------------------------------------------------------------------------
+
+    def add_production(self, prodname, syms, func=None, file='', line=0):
+
+        if prodname in self.Terminals:
+            raise GrammarError('%s:%d: Illegal rule name %r. Already defined as a token' % (file, line, prodname))
+        if prodname == 'error':
+            raise GrammarError('%s:%d: Illegal rule name %r. error is a reserved word' % (file, line, prodname))
+        if not _is_identifier.match(prodname):
+            raise GrammarError('%s:%d: Illegal rule name %r' % (file, line, prodname))
+
+        # Look for literal tokens
+        for n, s in enumerate(syms):
+            if s[0] in "'\"":
+                try:
+                    c = eval(s)
+                    if (len(c) > 1):
+                        raise GrammarError('%s:%d: Literal token %s in rule %r may only be a single character' %
+                                           (file, line, s, prodname))
+                    if c not in self.Terminals:
+                        self.Terminals[c] = []
+                    syms[n] = c
+                    continue
+                except SyntaxError:
+                    pass
+            if not _is_identifier.match(s) and s != '%prec':
+                raise GrammarError('%s:%d: Illegal name %r in rule %r' % (file, line, s, prodname))
+
+        # Determine the precedence level
+        if '%prec' in syms:
+            if syms[-1] == '%prec':
+                raise GrammarError('%s:%d: Syntax error. Nothing follows %%prec' % (file, line))
+            if syms[-2] != '%prec':
+                raise GrammarError('%s:%d: Syntax error. %%prec can only appear at the end of a grammar rule' %
+                                   (file, line))
+            precname = syms[-1]
+            prodprec = self.Precedence.get(precname)
+            if not prodprec:
+                raise GrammarError('%s:%d: Nothing known about the precedence of %r' % (file, line, precname))
+            else:
+                self.UsedPrecedence.add(precname)
+            del syms[-2:]     # Drop %prec from the rule
+        else:
+            # If no %prec, precedence is determined by the rightmost terminal symbol
+            precname = rightmost_terminal(syms, self.Terminals)
+            prodprec = self.Precedence.get(precname, ('right', 0))
+
+        # See if the rule is already in the rulemap
+        map = '%s -> %s' % (prodname, syms)
+        if map in self.Prodmap:
+            m = self.Prodmap[map]
+            raise GrammarError('%s:%d: Duplicate rule %s. ' % (file, line, m) +
+                               'Previous definition at %s:%d' % (m.file, m.line))
+
+        # From this point on, everything is valid.  Create a new Production instance
+        pnumber  = len(self.Productions)
+        if prodname not in self.Nonterminals:
+            self.Nonterminals[prodname] = []
+
+        # Add the production number to Terminals and Nonterminals
+        for t in syms:
+            if t in self.Terminals:
+                self.Terminals[t].append(pnumber)
+            else:
+                if t not in self.Nonterminals:
+                    self.Nonterminals[t] = []
+                self.Nonterminals[t].append(pnumber)
+
+        # Create a production and add it to the list of productions
+        p = Production(pnumber, prodname, syms, prodprec, func, file, line)
+        self.Productions.append(p)
+        self.Prodmap[map] = p
+
+        # Add to the global productions list
+        try:
+            self.Prodnames[prodname].append(p)
+        except KeyError:
+            self.Prodnames[prodname] = [p]
+
+    # -----------------------------------------------------------------------------
+    # set_start()
+    #
+    # Sets the starting symbol and creates the augmented grammar.  Production
+    # rule 0 is S' -> start where start is the start symbol.
+    # -----------------------------------------------------------------------------
+
+    def set_start(self, start=None):
+        if not start:
+            start = self.Productions[1].name
+        if start not in self.Nonterminals:
+            raise GrammarError('start symbol %s undefined' % start)
+        self.Productions[0] = Production(0, "S'", [start])
+        self.Nonterminals[start].append(0)
+        self.Start = start
+
+    # -----------------------------------------------------------------------------
+    # find_unreachable()
+    #
+    # Find all of the nonterminal symbols that can't be reached from the starting
+    # symbol.  Returns a list of nonterminals that can't be reached.
+    # -----------------------------------------------------------------------------
+
+    def find_unreachable(self):
+
+        # Mark all symbols that are reachable from a symbol s
+        def mark_reachable_from(s):
+            if s in reachable:
+                return
+            reachable.add(s)
+            for p in self.Prodnames.get(s, []):
+                for r in p.prod:
+                    mark_reachable_from(r)
+
+        reachable = set()
+        mark_reachable_from(self.Productions[0].prod[0])
+        return [s for s in self.Nonterminals if s not in reachable]
+
+    # -----------------------------------------------------------------------------
+    # infinite_cycles()
+    #
+    # This function looks at the various parsing rules and tries to detect
+    # infinite recursion cycles (grammar rules where there is no possible way
+    # to derive a string of only terminals).
+    # -----------------------------------------------------------------------------
+
+    def infinite_cycles(self):
+        terminates = {}
+
+        # Terminals:
+        for t in self.Terminals:
+            terminates[t] = True
+
+        terminates['$end'] = True
+
+        # Nonterminals:
+
+        # Initialize to false:
+        for n in self.Nonterminals:
+            terminates[n] = False
+
+        # Then propagate termination until no change:
+        while True:
+            some_change = False
+            for (n, pl) in self.Prodnames.items():
+                # Nonterminal n terminates iff any of its productions terminates.
+                for p in pl:
+                    # Production p terminates iff all of its rhs symbols terminate.
+                    for s in p.prod:
+                        if not terminates[s]:
+                            # The symbol s does not terminate,
+                            # so production p does not terminate.
+                            p_terminates = False
+                            break
+                    else:
+                        # didn't break from the loop,
+                        # so every symbol s terminates
+                        # so production p terminates.
+                        p_terminates = True
+
+                    if p_terminates:
+                        # symbol n terminates!
+                        if not terminates[n]:
+                            terminates[n] = True
+                            some_change = True
+                        # Don't need to consider any more productions for this n.
+                        break
+
+            if not some_change:
+                break
+
+        infinite = []
+        for (s, term) in terminates.items():
+            if not term:
+                if s not in self.Prodnames and s not in self.Terminals and s != 'error':
+                    # s is used-but-not-defined, and we've already warned of that,
+                    # so it would be overkill to say that it's also non-terminating.
+                    pass
+                else:
+                    infinite.append(s)
+
+        return infinite
+
+    # -----------------------------------------------------------------------------
+    # undefined_symbols()
+    #
+    # Find all symbols that were used the grammar, but not defined as tokens or
+    # grammar rules.  Returns a list of tuples (sym, prod) where sym in the symbol
+    # and prod is the production where the symbol was used.
+    # -----------------------------------------------------------------------------
+    def undefined_symbols(self):
+        result = []
+        for p in self.Productions:
+            if not p:
+                continue
+
+            for s in p.prod:
+                if s not in self.Prodnames and s not in self.Terminals and s != 'error':
+                    result.append((s, p))
+        return result
+
+    # -----------------------------------------------------------------------------
+    # unused_terminals()
+    #
+    # Find all terminals that were defined, but not used by the grammar.  Returns
+    # a list of all symbols.
+    # -----------------------------------------------------------------------------
+    def unused_terminals(self):
+        unused_tok = []
+        for s, v in self.Terminals.items():
+            if s != 'error' and not v:
+                unused_tok.append(s)
+
+        return unused_tok
+
+    # ------------------------------------------------------------------------------
+    # unused_rules()
+    #
+    # Find all grammar rules that were defined,  but not used (maybe not reachable)
+    # Returns a list of productions.
+    # ------------------------------------------------------------------------------
+
+    def unused_rules(self):
+        unused_prod = []
+        for s, v in self.Nonterminals.items():
+            if not v:
+                p = self.Prodnames[s][0]
+                unused_prod.append(p)
+        return unused_prod
+
+    # -----------------------------------------------------------------------------
+    # unused_precedence()
+    #
+    # Returns a list of tuples (term,precedence) corresponding to precedence
+    # rules that were never used by the grammar.  term is the name of the terminal
+    # on which precedence was applied and precedence is a string such as 'left' or
+    # 'right' corresponding to the type of precedence.
+    # -----------------------------------------------------------------------------
+
+    def unused_precedence(self):
+        unused = []
+        for termname in self.Precedence:
+            if not (termname in self.Terminals or termname in self.UsedPrecedence):
+                unused.append((termname, self.Precedence[termname][0]))
+
+        return unused
+
+    # -------------------------------------------------------------------------
+    # _first()
+    #
+    # Compute the value of FIRST1(beta) where beta is a tuple of symbols.
+    #
+    # During execution of compute_first1, the result may be incomplete.
+    # Afterward (e.g., when called from compute_follow()), it will be complete.
+    # -------------------------------------------------------------------------
+    def _first(self, beta):
+
+        # We are computing First(x1,x2,x3,...,xn)
+        result = []
+        for x in beta:
+            x_produces_empty = False
+
+            # Add all the non-<empty> symbols of First[x] to the result.
+            for f in self.First[x]:
+                if f == '<empty>':
+                    x_produces_empty = True
+                else:
+                    if f not in result:
+                        result.append(f)
+
+            if x_produces_empty:
+                # We have to consider the next x in beta,
+                # i.e. stay in the loop.
+                pass
+            else:
+                # We don't have to consider any further symbols in beta.
+                break
+        else:
+            # There was no 'break' from the loop,
+            # so x_produces_empty was true for all x in beta,
+            # so beta produces empty as well.
+            result.append('<empty>')
+
+        return result
+
+    # -------------------------------------------------------------------------
+    # compute_first()
+    #
+    # Compute the value of FIRST1(X) for all symbols
+    # -------------------------------------------------------------------------
+    def compute_first(self):
+        if self.First:
+            return self.First
+
+        # Terminals:
+        for t in self.Terminals:
+            self.First[t] = [t]
+
+        self.First['$end'] = ['$end']
+
+        # Nonterminals:
+
+        # Initialize to the empty set:
+        for n in self.Nonterminals:
+            self.First[n] = []
+
+        # Then propagate symbols until no change:
+        while True:
+            some_change = False
+            for n in self.Nonterminals:
+                for p in self.Prodnames[n]:
+                    for f in self._first(p.prod):
+                        if f not in self.First[n]:
+                            self.First[n].append(f)
+                            some_change = True
+            if not some_change:
+                break
+
+        return self.First
+
+    # ---------------------------------------------------------------------
+    # compute_follow()
+    #
+    # Computes all of the follow sets for every non-terminal symbol.  The
+    # follow set is the set of all symbols that might follow a given
+    # non-terminal.  See the Dragon book, 2nd Ed. p. 189.
+    # ---------------------------------------------------------------------
+    def compute_follow(self, start=None):
+        # If already computed, return the result
+        if self.Follow:
+            return self.Follow
+
+        # If first sets not computed yet, do that first.
+        if not self.First:
+            self.compute_first()
+
+        # Add '$end' to the follow list of the start symbol
+        for k in self.Nonterminals:
+            self.Follow[k] = []
+
+        if not start:
+            start = self.Productions[1].name
+
+        self.Follow[start] = ['$end']
+
+        while True:
+            didadd = False
+            for p in self.Productions[1:]:
+                # Here is the production set
+                for i, B in enumerate(p.prod):
+                    if B in self.Nonterminals:
+                        # Okay. We got a non-terminal in a production
+                        fst = self._first(p.prod[i+1:])
+                        hasempty = False
+                        for f in fst:
+                            if f != '<empty>' and f not in self.Follow[B]:
+                                self.Follow[B].append(f)
+                                didadd = True
+                            if f == '<empty>':
+                                hasempty = True
+                        if hasempty or i == (len(p.prod)-1):
+                            # Add elements of follow(a) to follow(b)
+                            for f in self.Follow[p.name]:
+                                if f not in self.Follow[B]:
+                                    self.Follow[B].append(f)
+                                    didadd = True
+            if not didadd:
+                break
+        return self.Follow
+
+
+    # -----------------------------------------------------------------------------
+    # build_lritems()
+    #
+    # This function walks the list of productions and builds a complete set of the
+    # LR items.  The LR items are stored in two ways:  First, they are uniquely
+    # numbered and placed in the list _lritems.  Second, a linked list of LR items
+    # is built for each production.  For example:
+    #
+    #   E -> E PLUS E
+    #
+    # Creates the list
+    #
+    #  [E -> . E PLUS E, E -> E . PLUS E, E -> E PLUS . E, E -> E PLUS E . ]
+    # -----------------------------------------------------------------------------
+
+    def build_lritems(self):
+        for p in self.Productions:
+            lastlri = p
+            i = 0
+            lr_items = []
+            while True:
+                if i > len(p):
+                    lri = None
+                else:
+                    lri = LRItem(p, i)
+                    # Precompute the list of productions immediately following
+                    try:
+                        lri.lr_after = self.Prodnames[lri.prod[i+1]]
+                    except (IndexError, KeyError):
+                        lri.lr_after = []
+                    try:
+                        lri.lr_before = lri.prod[i-1]
+                    except IndexError:
+                        lri.lr_before = None
+
+                lastlri.lr_next = lri
+                if not lri:
+                    break
+                lr_items.append(lri)
+                lastlri = lri
+                i += 1
+            p.lr_items = lr_items
+
+# -----------------------------------------------------------------------------
+#                            == Class LRTable ==
+#
+# This basic class represents a basic table of LR parsing information.
+# Methods for generating the tables are not defined here.  They are defined
+# in the derived class LRGeneratedTable.
+# -----------------------------------------------------------------------------
+
+class VersionError(YaccError):
+    pass
+
+class LRTable(object):
+    def __init__(self):
+        self.lr_action = None
+        self.lr_goto = None
+        self.lr_productions = None
+        self.lr_method = None
+
+    def read_table(self, module):
+        if isinstance(module, types.ModuleType):
+            parsetab = module
+        else:
+            exec('import %s' % module)
+            parsetab = sys.modules[module]
+
+        if parsetab._tabversion != __tabversion__:
+            raise VersionError('yacc table file version is out of date')
+
+        self.lr_action = parsetab._lr_action
+        self.lr_goto = parsetab._lr_goto
+
+        self.lr_productions = []
+        for p in parsetab._lr_productions:
+            self.lr_productions.append(MiniProduction(*p))
+
+        self.lr_method = parsetab._lr_method
+        return parsetab._lr_signature
+
+    def read_pickle(self, filename):
+        try:
+            import cPickle as pickle
+        except ImportError:
+            import pickle
+
+        if not os.path.exists(filename):
+          raise ImportError
+
+        in_f = open(filename, 'rb')
+
+        tabversion = pickle.load(in_f)
+        if tabversion != __tabversion__:
+            raise VersionError('yacc table file version is out of date')
+        self.lr_method = pickle.load(in_f)
+        signature      = pickle.load(in_f)
+        self.lr_action = pickle.load(in_f)
+        self.lr_goto   = pickle.load(in_f)
+        productions    = pickle.load(in_f)
+
+        self.lr_productions = []
+        for p in productions:
+            self.lr_productions.append(MiniProduction(*p))
+
+        in_f.close()
+        return signature
+
+    # Bind all production function names to callable objects in pdict
+    def bind_callables(self, pdict):
+        for p in self.lr_productions:
+            p.bind(pdict)
+
+
+# -----------------------------------------------------------------------------
+#                           === LR Generator ===
+#
+# The following classes and functions are used to generate LR parsing tables on
+# a grammar.
+# -----------------------------------------------------------------------------
+
+# -----------------------------------------------------------------------------
+# digraph()
+# traverse()
+#
+# The following two functions are used to compute set valued functions
+# of the form:
+#
+#     F(x) = F'(x) U U{F(y) | x R y}
+#
+# This is used to compute the values of Read() sets as well as FOLLOW sets
+# in LALR(1) generation.
+#
+# Inputs:  X    - An input set
+#          R    - A relation
+#          FP   - Set-valued function
+# ------------------------------------------------------------------------------
+
+def digraph(X, R, FP):
+    N = {}
+    for x in X:
+        N[x] = 0
+    stack = []
+    F = {}
+    for x in X:
+        if N[x] == 0:
+            traverse(x, N, stack, F, X, R, FP)
+    return F
+
+def traverse(x, N, stack, F, X, R, FP):
+    stack.append(x)
+    d = len(stack)
+    N[x] = d
+    F[x] = FP(x)             # F(X) <- F'(x)
+
+    rel = R(x)               # Get y's related to x
+    for y in rel:
+        if N[y] == 0:
+            traverse(y, N, stack, F, X, R, FP)
+        N[x] = min(N[x], N[y])
+        for a in F.get(y, []):
+            if a not in F[x]:
+                F[x].append(a)
+    if N[x] == d:
+        N[stack[-1]] = MAXINT
+        F[stack[-1]] = F[x]
+        element = stack.pop()
+        while element != x:
+            N[stack[-1]] = MAXINT
+            F[stack[-1]] = F[x]
+            element = stack.pop()
+
+class LALRError(YaccError):
+    pass
+
+# -----------------------------------------------------------------------------
+#                             == LRGeneratedTable ==
+#
+# This class implements the LR table generation algorithm.  There are no
+# public methods except for write()
+# -----------------------------------------------------------------------------
+
+class LRGeneratedTable(LRTable):
+    def __init__(self, grammar, method='LALR', log=None):
+        if method not in ['SLR', 'LALR']:
+            raise LALRError('Unsupported method %s' % method)
+
+        self.grammar = grammar
+        self.lr_method = method
+
+        # Set up the logger
+        if not log:
+            log = NullLogger()
+        self.log = log
+
+        # Internal attributes
+        self.lr_action     = {}        # Action table
+        self.lr_goto       = {}        # Goto table
+        self.lr_productions  = grammar.Productions    # Copy of grammar Production array
+        self.lr_goto_cache = {}        # Cache of computed gotos
+        self.lr0_cidhash   = {}        # Cache of closures
+
+        self._add_count    = 0         # Internal counter used to detect cycles
+
+        # Diagonistic information filled in by the table generator
+        self.sr_conflict   = 0
+        self.rr_conflict   = 0
+        self.conflicts     = []        # List of conflicts
+
+        self.sr_conflicts  = []
+        self.rr_conflicts  = []
+
+        # Build the tables
+        self.grammar.build_lritems()
+        self.grammar.compute_first()
+        self.grammar.compute_follow()
+        self.lr_parse_table()
+
+    # Compute the LR(0) closure operation on I, where I is a set of LR(0) items.
+
+    def lr0_closure(self, I):
+        self._add_count += 1
+
+        # Add everything in I to J
+        J = I[:]
+        didadd = True
+        while didadd:
+            didadd = False
+            for j in J:
+                for x in j.lr_after:
+                    if getattr(x, 'lr0_added', 0) == self._add_count:
+                        continue
+                    # Add B --> .G to J
+                    J.append(x.lr_next)
+                    x.lr0_added = self._add_count
+                    didadd = True
+
+        return J
+
+    # Compute the LR(0) goto function goto(I,X) where I is a set
+    # of LR(0) items and X is a grammar symbol.   This function is written
+    # in a way that guarantees uniqueness of the generated goto sets
+    # (i.e. the same goto set will never be returned as two different Python
+    # objects).  With uniqueness, we can later do fast set comparisons using
+    # id(obj) instead of element-wise comparison.
+
+    def lr0_goto(self, I, x):
+        # First we look for a previously cached entry
+        g = self.lr_goto_cache.get((id(I), x))
+        if g:
+            return g
+
+        # Now we generate the goto set in a way that guarantees uniqueness
+        # of the result
+
+        s = self.lr_goto_cache.get(x)
+        if not s:
+            s = {}
+            self.lr_goto_cache[x] = s
+
+        gs = []
+        for p in I:
+            n = p.lr_next
+            if n and n.lr_before == x:
+                s1 = s.get(id(n))
+                if not s1:
+                    s1 = {}
+                    s[id(n)] = s1
+                gs.append(n)
+                s = s1
+        g = s.get('$end')
+        if not g:
+            if gs:
+                g = self.lr0_closure(gs)
+                s['$end'] = g
+            else:
+                s['$end'] = gs
+        self.lr_goto_cache[(id(I), x)] = g
+        return g
+
+    # Compute the LR(0) sets of item function
+    def lr0_items(self):
+        C = [self.lr0_closure([self.grammar.Productions[0].lr_next])]
+        i = 0
+        for I in C:
+            self.lr0_cidhash[id(I)] = i
+            i += 1
+
+        # Loop over the items in C and each grammar symbols
+        i = 0
+        while i < len(C):
+            I = C[i]
+            i += 1
+
+            # Collect all of the symbols that could possibly be in the goto(I,X) sets
+            asyms = {}
+            for ii in I:
+                for s in ii.usyms:
+                    asyms[s] = None
+
+            for x in asyms:
+                g = self.lr0_goto(I, x)
+                if not g or id(g) in self.lr0_cidhash:
+                    continue
+                self.lr0_cidhash[id(g)] = len(C)
+                C.append(g)
+
+        return C
+
+    # -----------------------------------------------------------------------------
+    #                       ==== LALR(1) Parsing ====
+    #
+    # LALR(1) parsing is almost exactly the same as SLR except that instead of
+    # relying upon Follow() sets when performing reductions, a more selective
+    # lookahead set that incorporates the state of the LR(0) machine is utilized.
+    # Thus, we mainly just have to focus on calculating the lookahead sets.
+    #
+    # The method used here is due to DeRemer and Pennelo (1982).
+    #
+    # DeRemer, F. L., and T. J. Pennelo: "Efficient Computation of LALR(1)
+    #     Lookahead Sets", ACM Transactions on Programming Languages and Systems,
+    #     Vol. 4, No. 4, Oct. 1982, pp. 615-649
+    #
+    # Further details can also be found in:
+    #
+    #  J. Tremblay and P. Sorenson, "The Theory and Practice of Compiler Writing",
+    #      McGraw-Hill Book Company, (1985).
+    #
+    # -----------------------------------------------------------------------------
+
+    # -----------------------------------------------------------------------------
+    # compute_nullable_nonterminals()
+    #
+    # Creates a dictionary containing all of the non-terminals that might produce
+    # an empty production.
+    # -----------------------------------------------------------------------------
+
+    def compute_nullable_nonterminals(self):
+        nullable = set()
+        num_nullable = 0
+        while True:
+            for p in self.grammar.Productions[1:]:
+                if p.len == 0:
+                    nullable.add(p.name)
+                    continue
+                for t in p.prod:
+                    if t not in nullable:
+                        break
+                else:
+                    nullable.add(p.name)
+            if len(nullable) == num_nullable:
+                break
+            num_nullable = len(nullable)
+        return nullable
+
+    # -----------------------------------------------------------------------------
+    # find_nonterminal_trans(C)
+    #
+    # Given a set of LR(0) items, this functions finds all of the non-terminal
+    # transitions.    These are transitions in which a dot appears immediately before
+    # a non-terminal.   Returns a list of tuples of the form (state,N) where state
+    # is the state number and N is the nonterminal symbol.
+    #
+    # The input C is the set of LR(0) items.
+    # -----------------------------------------------------------------------------
+
+    def find_nonterminal_transitions(self, C):
+        trans = []
+        for stateno, state in enumerate(C):
+            for p in state:
+                if p.lr_index < p.len - 1:
+                    t = (stateno, p.prod[p.lr_index+1])
+                    if t[1] in self.grammar.Nonterminals:
+                        if t not in trans:
+                            trans.append(t)
+        return trans
+
+    # -----------------------------------------------------------------------------
+    # dr_relation()
+    #
+    # Computes the DR(p,A) relationships for non-terminal transitions.  The input
+    # is a tuple (state,N) where state is a number and N is a nonterminal symbol.
+    #
+    # Returns a list of terminals.
+    # -----------------------------------------------------------------------------
+
+    def dr_relation(self, C, trans, nullable):
+        dr_set = {}
+        state, N = trans
+        terms = []
+
+        g = self.lr0_goto(C[state], N)
+        for p in g:
+            if p.lr_index < p.len - 1:
+                a = p.prod[p.lr_index+1]
+                if a in self.grammar.Terminals:
+                    if a not in terms:
+                        terms.append(a)
+
+        # This extra bit is to handle the start state
+        if state == 0 and N == self.grammar.Productions[0].prod[0]:
+            terms.append('$end')
+
+        return terms
+
+    # -----------------------------------------------------------------------------
+    # reads_relation()
+    #
+    # Computes the READS() relation (p,A) READS (t,C).
+    # -----------------------------------------------------------------------------
+
+    def reads_relation(self, C, trans, empty):
+        # Look for empty transitions
+        rel = []
+        state, N = trans
+
+        g = self.lr0_goto(C[state], N)
+        j = self.lr0_cidhash.get(id(g), -1)
+        for p in g:
+            if p.lr_index < p.len - 1:
+                a = p.prod[p.lr_index + 1]
+                if a in empty:
+                    rel.append((j, a))
+
+        return rel
+
+    # -----------------------------------------------------------------------------
+    # compute_lookback_includes()
+    #
+    # Determines the lookback and includes relations
+    #
+    # LOOKBACK:
+    #
+    # This relation is determined by running the LR(0) state machine forward.
+    # For example, starting with a production "N : . A B C", we run it forward
+    # to obtain "N : A B C ."   We then build a relationship between this final
+    # state and the starting state.   These relationships are stored in a dictionary
+    # lookdict.
+    #
+    # INCLUDES:
+    #
+    # Computes the INCLUDE() relation (p,A) INCLUDES (p',B).
+    #
+    # This relation is used to determine non-terminal transitions that occur
+    # inside of other non-terminal transition states.   (p,A) INCLUDES (p', B)
+    # if the following holds:
+    #
+    #       B -> LAT, where T -> epsilon and p' -L-> p
+    #
+    # L is essentially a prefix (which may be empty), T is a suffix that must be
+    # able to derive an empty string.  State p' must lead to state p with the string L.
+    #
+    # -----------------------------------------------------------------------------
+
+    def compute_lookback_includes(self, C, trans, nullable):
+        lookdict = {}          # Dictionary of lookback relations
+        includedict = {}       # Dictionary of include relations
+
+        # Make a dictionary of non-terminal transitions
+        dtrans = {}
+        for t in trans:
+            dtrans[t] = 1
+
+        # Loop over all transitions and compute lookbacks and includes
+        for state, N in trans:
+            lookb = []
+            includes = []
+            for p in C[state]:
+                if p.name != N:
+                    continue
+
+                # Okay, we have a name match.  We now follow the production all the way
+                # through the state machine until we get the . on the right hand side
+
+                lr_index = p.lr_index
+                j = state
+                while lr_index < p.len - 1:
+                    lr_index = lr_index + 1
+                    t = p.prod[lr_index]
+
+                    # Check to see if this symbol and state are a non-terminal transition
+                    if (j, t) in dtrans:
+                        # Yes.  Okay, there is some chance that this is an includes relation
+                        # the only way to know for certain is whether the rest of the
+                        # production derives empty
+
+                        li = lr_index + 1
+                        while li < p.len:
+                            if p.prod[li] in self.grammar.Terminals:
+                                break      # No forget it
+                            if p.prod[li] not in nullable:
+                                break
+                            li = li + 1
+                        else:
+                            # Appears to be a relation between (j,t) and (state,N)
+                            includes.append((j, t))
+
+                    g = self.lr0_goto(C[j], t)               # Go to next set
+                    j = self.lr0_cidhash.get(id(g), -1)      # Go to next state
+
+                # When we get here, j is the final state, now we have to locate the production
+                for r in C[j]:
+                    if r.name != p.name:
+                        continue
+                    if r.len != p.len:
+                        continue
+                    i = 0
+                    # This look is comparing a production ". A B C" with "A B C ."
+                    while i < r.lr_index:
+                        if r.prod[i] != p.prod[i+1]:
+                            break
+                        i = i + 1
+                    else:
+                        lookb.append((j, r))
+            for i in includes:
+                if i not in includedict:
+                    includedict[i] = []
+                includedict[i].append((state, N))
+            lookdict[(state, N)] = lookb
+
+        return lookdict, includedict
+
+    # -----------------------------------------------------------------------------
+    # compute_read_sets()
+    #
+    # Given a set of LR(0) items, this function computes the read sets.
+    #
+    # Inputs:  C        =  Set of LR(0) items
+    #          ntrans   = Set of nonterminal transitions
+    #          nullable = Set of empty transitions
+    #
+    # Returns a set containing the read sets
+    # -----------------------------------------------------------------------------
+
+    def compute_read_sets(self, C, ntrans, nullable):
+        FP = lambda x: self.dr_relation(C, x, nullable)
+        R =  lambda x: self.reads_relation(C, x, nullable)
+        F = digraph(ntrans, R, FP)
+        return F
+
+    # -----------------------------------------------------------------------------
+    # compute_follow_sets()
+    #
+    # Given a set of LR(0) items, a set of non-terminal transitions, a readset,
+    # and an include set, this function computes the follow sets
+    #
+    # Follow(p,A) = Read(p,A) U U {Follow(p',B) | (p,A) INCLUDES (p',B)}
+    #
+    # Inputs:
+    #            ntrans     = Set of nonterminal transitions
+    #            readsets   = Readset (previously computed)
+    #            inclsets   = Include sets (previously computed)
+    #
+    # Returns a set containing the follow sets
+    # -----------------------------------------------------------------------------
+
+    def compute_follow_sets(self, ntrans, readsets, inclsets):
+        FP = lambda x: readsets[x]
+        R  = lambda x: inclsets.get(x, [])
+        F = digraph(ntrans, R, FP)
+        return F
+
+    # -----------------------------------------------------------------------------
+    # add_lookaheads()
+    #
+    # Attaches the lookahead symbols to grammar rules.
+    #
+    # Inputs:    lookbacks         -  Set of lookback relations
+    #            followset         -  Computed follow set
+    #
+    # This function directly attaches the lookaheads to productions contained
+    # in the lookbacks set
+    # -----------------------------------------------------------------------------
+
+    def add_lookaheads(self, lookbacks, followset):
+        for trans, lb in lookbacks.items():
+            # Loop over productions in lookback
+            for state, p in lb:
+                if state not in p.lookaheads:
+                    p.lookaheads[state] = []
+                f = followset.get(trans, [])
+                for a in f:
+                    if a not in p.lookaheads[state]:
+                        p.lookaheads[state].append(a)
+
+    # -----------------------------------------------------------------------------
+    # add_lalr_lookaheads()
+    #
+    # This function does all of the work of adding lookahead information for use
+    # with LALR parsing
+    # -----------------------------------------------------------------------------
+
+    def add_lalr_lookaheads(self, C):
+        # Determine all of the nullable nonterminals
+        nullable = self.compute_nullable_nonterminals()
+
+        # Find all non-terminal transitions
+        trans = self.find_nonterminal_transitions(C)
+
+        # Compute read sets
+        readsets = self.compute_read_sets(C, trans, nullable)
+
+        # Compute lookback/includes relations
+        lookd, included = self.compute_lookback_includes(C, trans, nullable)
+
+        # Compute LALR FOLLOW sets
+        followsets = self.compute_follow_sets(trans, readsets, included)
+
+        # Add all of the lookaheads
+        self.add_lookaheads(lookd, followsets)
+
+    # -----------------------------------------------------------------------------
+    # lr_parse_table()
+    #
+    # This function constructs the parse tables for SLR or LALR
+    # -----------------------------------------------------------------------------
+    def lr_parse_table(self):
+        Productions = self.grammar.Productions
+        Precedence  = self.grammar.Precedence
+        goto   = self.lr_goto         # Goto array
+        action = self.lr_action       # Action array
+        log    = self.log             # Logger for output
+
+        actionp = {}                  # Action production array (temporary)
+
+        log.info('Parsing method: %s', self.lr_method)
+
+        # Step 1: Construct C = { I0, I1, ... IN}, collection of LR(0) items
+        # This determines the number of states
+
+        C = self.lr0_items()
+
+        if self.lr_method == 'LALR':
+            self.add_lalr_lookaheads(C)
+
+        # Build the parser table, state by state
+        st = 0
+        for I in C:
+            # Loop over each production in I
+            actlist = []              # List of actions
+            st_action  = {}
+            st_actionp = {}
+            st_goto    = {}
+            log.info('')
+            log.info('state %d', st)
+            log.info('')
+            for p in I:
+                log.info('    (%d) %s', p.number, p)
+            log.info('')
+
+            for p in I:
+                    if p.len == p.lr_index + 1:
+                        if p.name == "S'":
+                            # Start symbol. Accept!
+                            st_action['$end'] = 0
+                            st_actionp['$end'] = p
+                        else:
+                            # We are at the end of a production.  Reduce!
+                            if self.lr_method == 'LALR':
+                                laheads = p.lookaheads[st]
+                            else:
+                                laheads = self.grammar.Follow[p.name]
+                            for a in laheads:
+                                actlist.append((a, p, 'reduce using rule %d (%s)' % (p.number, p)))
+                                r = st_action.get(a)
+                                if r is not None:
+                                    # Whoa. Have a shift/reduce or reduce/reduce conflict
+                                    if r > 0:
+                                        # Need to decide on shift or reduce here
+                                        # By default we favor shifting. Need to add
+                                        # some precedence rules here.
+
+                                        # Shift precedence comes from the token
+                                        sprec, slevel = Precedence.get(a, ('right', 0))
+
+                                        # Reduce precedence comes from rule being reduced (p)
+                                        rprec, rlevel = Productions[p.number].prec
+
+                                        if (slevel < rlevel) or ((slevel == rlevel) and (rprec == 'left')):
+                                            # We really need to reduce here.
+                                            st_action[a] = -p.number
+                                            st_actionp[a] = p
+                                            if not slevel and not rlevel:
+                                                log.info('  ! shift/reduce conflict for %s resolved as reduce', a)
+                                                self.sr_conflicts.append((st, a, 'reduce'))
+                                            Productions[p.number].reduced += 1
+                                        elif (slevel == rlevel) and (rprec == 'nonassoc'):
+                                            st_action[a] = None
+                                        else:
+                                            # Hmmm. Guess we'll keep the shift
+                                            if not rlevel:
+                                                log.info('  ! shift/reduce conflict for %s resolved as shift', a)
+                                                self.sr_conflicts.append((st, a, 'shift'))
+                                    elif r < 0:
+                                        # Reduce/reduce conflict.   In this case, we favor the rule
+                                        # that was defined first in the grammar file
+                                        oldp = Productions[-r]
+                                        pp = Productions[p.number]
+                                        if oldp.line > pp.line:
+                                            st_action[a] = -p.number
+                                            st_actionp[a] = p
+                                            chosenp, rejectp = pp, oldp
+                                            Productions[p.number].reduced += 1
+                                            Productions[oldp.number].reduced -= 1
+                                        else:
+                                            chosenp, rejectp = oldp, pp
+                                        self.rr_conflicts.append((st, chosenp, rejectp))
+                                        log.info('  ! reduce/reduce conflict for %s resolved using rule %d (%s)',
+                                                 a, st_actionp[a].number, st_actionp[a])
+                                    else:
+                                        raise LALRError('Unknown conflict in state %d' % st)
+                                else:
+                                    st_action[a] = -p.number
+                                    st_actionp[a] = p
+                                    Productions[p.number].reduced += 1
+                    else:
+                        i = p.lr_index
+                        a = p.prod[i+1]       # Get symbol right after the "."
+                        if a in self.grammar.Terminals:
+                            g = self.lr0_goto(I, a)
+                            j = self.lr0_cidhash.get(id(g), -1)
+                            if j >= 0:
+                                # We are in a shift state
+                                actlist.append((a, p, 'shift and go to state %d' % j))
+                                r = st_action.get(a)
+                                if r is not None:
+                                    # Whoa have a shift/reduce or shift/shift conflict
+                                    if r > 0:
+                                        if r != j:
+                                            raise LALRError('Shift/shift conflict in state %d' % st)
+                                    elif r < 0:
+                                        # Do a precedence check.
+                                        #   -  if precedence of reduce rule is higher, we reduce.
+                                        #   -  if precedence of reduce is same and left assoc, we reduce.
+                                        #   -  otherwise we shift
+
+                                        # Shift precedence comes from the token
+                                        sprec, slevel = Precedence.get(a, ('right', 0))
+
+                                        # Reduce precedence comes from the rule that could have been reduced
+                                        rprec, rlevel = Productions[st_actionp[a].number].prec
+
+                                        if (slevel > rlevel) or ((slevel == rlevel) and (rprec == 'right')):
+                                            # We decide to shift here... highest precedence to shift
+                                            Productions[st_actionp[a].number].reduced -= 1
+                                            st_action[a] = j
+                                            st_actionp[a] = p
+                                            if not rlevel:
+                                                log.info('  ! shift/reduce conflict for %s resolved as shift', a)
+                                                self.sr_conflicts.append((st, a, 'shift'))
+                                        elif (slevel == rlevel) and (rprec == 'nonassoc'):
+                                            st_action[a] = None
+                                        else:
+                                            # Hmmm. Guess we'll keep the reduce
+                                            if not slevel and not rlevel:
+                                                log.info('  ! shift/reduce conflict for %s resolved as reduce', a)
+                                                self.sr_conflicts.append((st, a, 'reduce'))
+
+                                    else:
+                                        raise LALRError('Unknown conflict in state %d' % st)
+                                else:
+                                    st_action[a] = j
+                                    st_actionp[a] = p
+
+            # Print the actions associated with each terminal
+            _actprint = {}
+            for a, p, m in actlist:
+                if a in st_action:
+                    if p is st_actionp[a]:
+                        log.info('    %-15s %s', a, m)
+                        _actprint[(a, m)] = 1
+            log.info('')
+            # Print the actions that were not used. (debugging)
+            not_used = 0
+            for a, p, m in actlist:
+                if a in st_action:
+                    if p is not st_actionp[a]:
+                        if not (a, m) in _actprint:
+                            log.debug('  ! %-15s [ %s ]', a, m)
+                            not_used = 1
+                            _actprint[(a, m)] = 1
+            if not_used:
+                log.debug('')
+
+            # Construct the goto table for this state
+
+            nkeys = {}
+            for ii in I:
+                for s in ii.usyms:
+                    if s in self.grammar.Nonterminals:
+                        nkeys[s] = None
+            for n in nkeys:
+                g = self.lr0_goto(I, n)
+                j = self.lr0_cidhash.get(id(g), -1)
+                if j >= 0:
+                    st_goto[n] = j
+                    log.info('    %-30s shift and go to state %d', n, j)
+
+            action[st] = st_action
+            actionp[st] = st_actionp
+            goto[st] = st_goto
+            st += 1
+
+    # -----------------------------------------------------------------------------
+    # write()
+    #
+    # This function writes the LR parsing tables to a file
+    # -----------------------------------------------------------------------------
+
+    def write_table(self, tabmodule, outputdir='', signature=''):
+        if isinstance(tabmodule, types.ModuleType):
+            raise IOError("Won't overwrite existing tabmodule")
+
+        basemodulename = tabmodule.split('.')[-1]
+        filename = os.path.join(outputdir, basemodulename) + '.py'
+        try:
+            f = open(filename, 'w')
+
+            f.write('''
+# %s
+# This file is automatically generated. Do not edit.
+_tabversion = %r
+
+_lr_method = %r
+
+_lr_signature = %r
+    ''' % (os.path.basename(filename), __tabversion__, self.lr_method, signature))
+
+            # Change smaller to 0 to go back to original tables
+            smaller = 1
+
+            # Factor out names to try and make smaller
+            if smaller:
+                items = {}
+
+                for s, nd in self.lr_action.items():
+                    for name, v in nd.items():
+                        i = items.get(name)
+                        if not i:
+                            i = ([], [])
+                            items[name] = i
+                        i[0].append(s)
+                        i[1].append(v)
+
+                f.write('\n_lr_action_items = {')
+                for k, v in items.items():
+                    f.write('%r:([' % k)
+                    for i in v[0]:
+                        f.write('%r,' % i)
+                    f.write('],[')
+                    for i in v[1]:
+                        f.write('%r,' % i)
+
+                    f.write(']),')
+                f.write('}\n')
+
+                f.write('''
+_lr_action = {}
+for _k, _v in _lr_action_items.items():
+   for _x,_y in zip(_v[0],_v[1]):
+      if not _x in _lr_action:  _lr_action[_x] = {}
+      _lr_action[_x][_k] = _y
+del _lr_action_items
+''')
+
+            else:
+                f.write('\n_lr_action = { ')
+                for k, v in self.lr_action.items():
+                    f.write('(%r,%r):%r,' % (k[0], k[1], v))
+                f.write('}\n')
+
+            if smaller:
+                # Factor out names to try and make smaller
+                items = {}
+
+                for s, nd in self.lr_goto.items():
+                    for name, v in nd.items():
+                        i = items.get(name)
+                        if not i:
+                            i = ([], [])
+                            items[name] = i
+                        i[0].append(s)
+                        i[1].append(v)
+
+                f.write('\n_lr_goto_items = {')
+                for k, v in items.items():
+                    f.write('%r:([' % k)
+                    for i in v[0]:
+                        f.write('%r,' % i)
+                    f.write('],[')
+                    for i in v[1]:
+                        f.write('%r,' % i)
+
+                    f.write(']),')
+                f.write('}\n')
+
+                f.write('''
+_lr_goto = {}
+for _k, _v in _lr_goto_items.items():
+   for _x, _y in zip(_v[0], _v[1]):
+       if not _x in _lr_goto: _lr_goto[_x] = {}
+       _lr_goto[_x][_k] = _y
+del _lr_goto_items
+''')
+            else:
+                f.write('\n_lr_goto = { ')
+                for k, v in self.lr_goto.items():
+                    f.write('(%r,%r):%r,' % (k[0], k[1], v))
+                f.write('}\n')
+
+            # Write production table
+            f.write('_lr_productions = [\n')
+            for p in self.lr_productions:
+                if p.func:
+                    f.write('  (%r,%r,%d,%r,%r,%d),\n' % (p.str, p.name, p.len,
+                                                          p.func, os.path.basename(p.file), p.line))
+                else:
+                    f.write('  (%r,%r,%d,None,None,None),\n' % (str(p), p.name, p.len))
+            f.write(']\n')
+            f.close()
+
+        except IOError as e:
+            raise
+
+
+    # -----------------------------------------------------------------------------
+    # pickle_table()
+    #
+    # This function pickles the LR parsing tables to a supplied file object
+    # -----------------------------------------------------------------------------
+
+    def pickle_table(self, filename, signature=''):
+        try:
+            import cPickle as pickle
+        except ImportError:
+            import pickle
+        with open(filename, 'wb') as outf:
+            pickle.dump(__tabversion__, outf, pickle_protocol)
+            pickle.dump(self.lr_method, outf, pickle_protocol)
+            pickle.dump(signature, outf, pickle_protocol)
+            pickle.dump(self.lr_action, outf, pickle_protocol)
+            pickle.dump(self.lr_goto, outf, pickle_protocol)
+
+            outp = []
+            for p in self.lr_productions:
+                if p.func:
+                    outp.append((p.str, p.name, p.len, p.func, os.path.basename(p.file), p.line))
+                else:
+                    outp.append((str(p), p.name, p.len, None, None, None))
+            pickle.dump(outp, outf, pickle_protocol)
+
+# -----------------------------------------------------------------------------
+#                            === INTROSPECTION ===
+#
+# The following functions and classes are used to implement the PLY
+# introspection features followed by the yacc() function itself.
+# -----------------------------------------------------------------------------
+
+# -----------------------------------------------------------------------------
+# get_caller_module_dict()
+#
+# This function returns a dictionary containing all of the symbols defined within
+# a caller further down the call stack.  This is used to get the environment
+# associated with the yacc() call if none was provided.
+# -----------------------------------------------------------------------------
+
+def get_caller_module_dict(levels):
+    f = sys._getframe(levels)
+    ldict = f.f_globals.copy()
+    if f.f_globals != f.f_locals:
+        ldict.update(f.f_locals)
+    return ldict
+
+# -----------------------------------------------------------------------------
+# parse_grammar()
+#
+# This takes a raw grammar rule string and parses it into production data
+# -----------------------------------------------------------------------------
+def parse_grammar(doc, file, line):
+    grammar = []
+    # Split the doc string into lines
+    pstrings = doc.splitlines()
+    lastp = None
+    dline = line
+    for ps in pstrings:
+        dline += 1
+        p = ps.split()
+        if not p:
+            continue
+        try:
+            if p[0] == '|':
+                # This is a continuation of a previous rule
+                if not lastp:
+                    raise SyntaxError("%s:%d: Misplaced '|'" % (file, dline))
+                prodname = lastp
+                syms = p[1:]
+            else:
+                prodname = p[0]
+                lastp = prodname
+                syms   = p[2:]
+                assign = p[1]
+                if assign != ':' and assign != '::=':
+                    raise SyntaxError("%s:%d: Syntax error. Expected ':'" % (file, dline))
+
+            grammar.append((file, dline, prodname, syms))
+        except SyntaxError:
+            raise
+        except Exception:
+            raise SyntaxError('%s:%d: Syntax error in rule %r' % (file, dline, ps.strip()))
+
+    return grammar
+
+# -----------------------------------------------------------------------------
+# ParserReflect()
+#
+# This class represents information extracted for building a parser including
+# start symbol, error function, tokens, precedence list, action functions,
+# etc.
+# -----------------------------------------------------------------------------
+class ParserReflect(object):
+    def __init__(self, pdict, log=None):
+        self.pdict      = pdict
+        self.start      = None
+        self.error_func = None
+        self.tokens     = None
+        self.modules    = set()
+        self.grammar    = []
+        self.error      = False
+
+        if log is None:
+            self.log = PlyLogger(sys.stderr)
+        else:
+            self.log = log
+
+    # Get all of the basic information
+    def get_all(self):
+        self.get_start()
+        self.get_error_func()
+        self.get_tokens()
+        self.get_precedence()
+        self.get_pfunctions()
+
+    # Validate all of the information
+    def validate_all(self):
+        self.validate_start()
+        self.validate_error_func()
+        self.validate_tokens()
+        self.validate_precedence()
+        self.validate_pfunctions()
+        self.validate_modules()
+        return self.error
+
+    # Compute a signature over the grammar
+    def signature(self):
+        parts = []
+        try:
+            if self.start:
+                parts.append(self.start)
+            if self.prec:
+                parts.append(''.join([''.join(p) for p in self.prec]))
+            if self.tokens:
+                parts.append(' '.join(self.tokens))
+            for f in self.pfuncs:
+                if f[3]:
+                    parts.append(f[3])
+        except (TypeError, ValueError):
+            pass
+        return ''.join(parts)
+
+    # -----------------------------------------------------------------------------
+    # validate_modules()
+    #
+    # This method checks to see if there are duplicated p_rulename() functions
+    # in the parser module file.  Without this function, it is really easy for
+    # users to make mistakes by cutting and pasting code fragments (and it's a real
+    # bugger to try and figure out why the resulting parser doesn't work).  Therefore,
+    # we just do a little regular expression pattern matching of def statements
+    # to try and detect duplicates.
+    # -----------------------------------------------------------------------------
+
+    def validate_modules(self):
+        # Match def p_funcname(
+        fre = re.compile(r'\s*def\s+(p_[a-zA-Z_0-9]*)\(')
+
+        for module in self.modules:
+            try:
+                lines, linen = inspect.getsourcelines(module)
+            except IOError:
+                continue
+
+            counthash = {}
+            for linen, line in enumerate(lines):
+                linen += 1
+                m = fre.match(line)
+                if m:
+                    name = m.group(1)
+                    prev = counthash.get(name)
+                    if not prev:
+                        counthash[name] = linen
+                    else:
+                        filename = inspect.getsourcefile(module)
+                        self.log.warning('%s:%d: Function %s redefined. Previously defined on line %d',
+                                         filename, linen, name, prev)
+
+    # Get the start symbol
+    def get_start(self):
+        self.start = self.pdict.get('start')
+
+    # Validate the start symbol
+    def validate_start(self):
+        if self.start is not None:
+            if not isinstance(self.start, string_types):
+                self.log.error("'start' must be a string")
+
+    # Look for error handler
+    def get_error_func(self):
+        self.error_func = self.pdict.get('p_error')
+
+    # Validate the error function
+    def validate_error_func(self):
+        if self.error_func:
+            if isinstance(self.error_func, types.FunctionType):
+                ismethod = 0
+            elif isinstance(self.error_func, types.MethodType):
+                ismethod = 1
+            else:
+                self.log.error("'p_error' defined, but is not a function or method")
+                self.error = True
+                return
+
+            eline = self.error_func.__code__.co_firstlineno
+            efile = self.error_func.__code__.co_filename
+            module = inspect.getmodule(self.error_func)
+            self.modules.add(module)
+
+            argcount = self.error_func.__code__.co_argcount - ismethod
+            if argcount != 1:
+                self.log.error('%s:%d: p_error() requires 1 argument', efile, eline)
+                self.error = True
+
+    # Get the tokens map
+    def get_tokens(self):
+        tokens = self.pdict.get('tokens')
+        if not tokens:
+            self.log.error('No token list is defined')
+            self.error = True
+            return
+
+        if not isinstance(tokens, (list, tuple)):
+            self.log.error('tokens must be a list or tuple')
+            self.error = True
+            return
+
+        if not tokens:
+            self.log.error('tokens is empty')
+            self.error = True
+            return
+
+        self.tokens = tokens
+
+    # Validate the tokens
+    def validate_tokens(self):
+        # Validate the tokens.
+        if 'error' in self.tokens:
+            self.log.error("Illegal token name 'error'. Is a reserved word")
+            self.error = True
+            return
+
+        terminals = set()
+        for n in self.tokens:
+            if n in terminals:
+                self.log.warning('Token %r multiply defined', n)
+            terminals.add(n)
+
+    # Get the precedence map (if any)
+    def get_precedence(self):
+        self.prec = self.pdict.get('precedence')
+
+    # Validate and parse the precedence map
+    def validate_precedence(self):
+        preclist = []
+        if self.prec:
+            if not isinstance(self.prec, (list, tuple)):
+                self.log.error('precedence must be a list or tuple')
+                self.error = True
+                return
+            for level, p in enumerate(self.prec):
+                if not isinstance(p, (list, tuple)):
+                    self.log.error('Bad precedence table')
+                    self.error = True
+                    return
+
+                if len(p) < 2:
+                    self.log.error('Malformed precedence entry %s. Must be (assoc, term, ..., term)', p)
+                    self.error = True
+                    return
+                assoc = p[0]
+                if not isinstance(assoc, string_types):
+                    self.log.error('precedence associativity must be a string')
+                    self.error = True
+                    return
+                for term in p[1:]:
+                    if not isinstance(term, string_types):
+                        self.log.error('precedence items must be strings')
+                        self.error = True
+                        return
+                    preclist.append((term, assoc, level+1))
+        self.preclist = preclist
+
+    # Get all p_functions from the grammar
+    def get_pfunctions(self):
+        p_functions = []
+        for name, item in self.pdict.items():
+            if not name.startswith('p_') or name == 'p_error':
+                continue
+            if isinstance(item, (types.FunctionType, types.MethodType)):
+                line = getattr(item, 'co_firstlineno', item.__code__.co_firstlineno)
+                module = inspect.getmodule(item)
+                p_functions.append((line, module, name, item.__doc__))
+
+        # Sort all of the actions by line number; make sure to stringify
+        # modules to make them sortable, since `line` may not uniquely sort all
+        # p functions
+        p_functions.sort(key=lambda p_function: (
+            p_function[0],
+            str(p_function[1]),
+            p_function[2],
+            p_function[3]))
+        self.pfuncs = p_functions
+
+    # Validate all of the p_functions
+    def validate_pfunctions(self):
+        grammar = []
+        # Check for non-empty symbols
+        if len(self.pfuncs) == 0:
+            self.log.error('no rules of the form p_rulename are defined')
+            self.error = True
+            return
+
+        for line, module, name, doc in self.pfuncs:
+            file = inspect.getsourcefile(module)
+            func = self.pdict[name]
+            if isinstance(func, types.MethodType):
+                reqargs = 2
+            else:
+                reqargs = 1
+            if func.__code__.co_argcount > reqargs:
+                self.log.error('%s:%d: Rule %r has too many arguments', file, line, func.__name__)
+                self.error = True
+            elif func.__code__.co_argcount < reqargs:
+                self.log.error('%s:%d: Rule %r requires an argument', file, line, func.__name__)
+                self.error = True
+            elif not func.__doc__:
+                self.log.warning('%s:%d: No documentation string specified in function %r (ignored)',
+                                 file, line, func.__name__)
+            else:
+                try:
+                    parsed_g = parse_grammar(doc, file, line)
+                    for g in parsed_g:
+                        grammar.append((name, g))
+                except SyntaxError as e:
+                    self.log.error(str(e))
+                    self.error = True
+
+                # Looks like a valid grammar rule
+                # Mark the file in which defined.
+                self.modules.add(module)
+
+        # Secondary validation step that looks for p_ definitions that are not functions
+        # or functions that look like they might be grammar rules.
+
+        for n, v in self.pdict.items():
+            if n.startswith('p_') and isinstance(v, (types.FunctionType, types.MethodType)):
+                continue
+            if n.startswith('t_'):
+                continue
+            if n.startswith('p_') and n != 'p_error':
+                self.log.warning('%r not defined as a function', n)
+            if ((isinstance(v, types.FunctionType) and v.__code__.co_argcount == 1) or
+                   (isinstance(v, types.MethodType) and v.__func__.__code__.co_argcount == 2)):
+                if v.__doc__:
+                    try:
+                        doc = v.__doc__.split(' ')
+                        if doc[1] == ':':
+                            self.log.warning('%s:%d: Possible grammar rule %r defined without p_ prefix',
+                                             v.__code__.co_filename, v.__code__.co_firstlineno, n)
+                    except IndexError:
+                        pass
+
+        self.grammar = grammar
+
+# -----------------------------------------------------------------------------
+# yacc(module)
+#
+# Build a parser
+# -----------------------------------------------------------------------------
+
+def yacc(method='LALR', debug=yaccdebug, module=None, tabmodule=tab_module, start=None,
+         check_recursion=True, optimize=False, write_tables=True, debugfile=debug_file,
+         outputdir=None, debuglog=None, errorlog=None, picklefile=None):
+
+    if tabmodule is None:
+        tabmodule = tab_module
+
+    # Reference to the parsing method of the last built parser
+    global parse
+
+    # If pickling is enabled, table files are not created
+    if picklefile:
+        write_tables = 0
+
+    if errorlog is None:
+        errorlog = PlyLogger(sys.stderr)
+
+    # Get the module dictionary used for the parser
+    if module:
+        _items = [(k, getattr(module, k)) for k in dir(module)]
+        pdict = dict(_items)
+        # If no __file__ attribute is available, try to obtain it from the __module__ instead
+        if '__file__' not in pdict:
+            pdict['__file__'] = sys.modules[pdict['__module__']].__file__
+    else:
+        pdict = get_caller_module_dict(2)
+
+    if outputdir is None:
+        # If no output directory is set, the location of the output files
+        # is determined according to the following rules:
+        #     - If tabmodule specifies a package, files go into that package directory
+        #     - Otherwise, files go in the same directory as the specifying module
+        if isinstance(tabmodule, types.ModuleType):
+            srcfile = tabmodule.__file__
+        else:
+            if '.' not in tabmodule:
+                srcfile = pdict['__file__']
+            else:
+                parts = tabmodule.split('.')
+                pkgname = '.'.join(parts[:-1])
+                exec('import %s' % pkgname)
+                srcfile = getattr(sys.modules[pkgname], '__file__', '')
+        outputdir = os.path.dirname(srcfile)
+
+    # Determine if the module is package of a package or not.
+    # If so, fix the tabmodule setting so that tables load correctly
+    pkg = pdict.get('__package__')
+    if pkg and isinstance(tabmodule, str):
+        if '.' not in tabmodule:
+            tabmodule = pkg + '.' + tabmodule
+
+
+
+    # Set start symbol if it's specified directly using an argument
+    if start is not None:
+        pdict['start'] = start
+
+    # Collect parser information from the dictionary
+    pinfo = ParserReflect(pdict, log=errorlog)
+    pinfo.get_all()
+
+    if pinfo.error:
+        raise YaccError('Unable to build parser')
+
+    # Check signature against table files (if any)
+    signature = pinfo.signature()
+
+    # Read the tables
+    try:
+        lr = LRTable()
+        if picklefile:
+            read_signature = lr.read_pickle(picklefile)
+        else:
+            read_signature = lr.read_table(tabmodule)
+        if optimize or (read_signature == signature):
+            try:
+                lr.bind_callables(pinfo.pdict)
+                parser = LRParser(lr, pinfo.error_func)
+                parse = parser.parse
+                return parser
+            except Exception as e:
+                errorlog.warning('There was a problem loading the table file: %r', e)
+    except VersionError as e:
+        errorlog.warning(str(e))
+    except ImportError:
+        pass
+
+    if debuglog is None:
+        if debug:
+            try:
+                debuglog = PlyLogger(open(os.path.join(outputdir, debugfile), 'w'))
+            except IOError as e:
+                errorlog.warning("Couldn't open %r. %s" % (debugfile, e))
+                debuglog = NullLogger()
+        else:
+            debuglog = NullLogger()
+
+    debuglog.info('Created by PLY version %s (http://www.dabeaz.com/ply)', __version__)
+
+    errors = False
+
+    # Validate the parser information
+    if pinfo.validate_all():
+        raise YaccError('Unable to build parser')
+
+    if not pinfo.error_func:
+        errorlog.warning('no p_error() function is defined')
+
+    # Create a grammar object
+    grammar = Grammar(pinfo.tokens)
+
+    # Set precedence level for terminals
+    for term, assoc, level in pinfo.preclist:
+        try:
+            grammar.set_precedence(term, assoc, level)
+        except GrammarError as e:
+            errorlog.warning('%s', e)
+
+    # Add productions to the grammar
+    for funcname, gram in pinfo.grammar:
+        file, line, prodname, syms = gram
+        try:
+            grammar.add_production(prodname, syms, funcname, file, line)
+        except GrammarError as e:
+            errorlog.error('%s', e)
+            errors = True
+
+    # Set the grammar start symbols
+    try:
+        if start is None:
+            grammar.set_start(pinfo.start)
+        else:
+            grammar.set_start(start)
+    except GrammarError as e:
+        errorlog.error(str(e))
+        errors = True
+
+    if errors:
+        raise YaccError('Unable to build parser')
+
+    # Verify the grammar structure
+    undefined_symbols = grammar.undefined_symbols()
+    for sym, prod in undefined_symbols:
+        errorlog.error('%s:%d: Symbol %r used, but not defined as a token or a rule', prod.file, prod.line, sym)
+        errors = True
+
+    unused_terminals = grammar.unused_terminals()
+    if unused_terminals:
+        debuglog.info('')
+        debuglog.info('Unused terminals:')
+        debuglog.info('')
+        for term in unused_terminals:
+            errorlog.warning('Token %r defined, but not used', term)
+            debuglog.info('    %s', term)
+
+    # Print out all productions to the debug log
+    if debug:
+        debuglog.info('')
+        debuglog.info('Grammar')
+        debuglog.info('')
+        for n, p in enumerate(grammar.Productions):
+            debuglog.info('Rule %-5d %s', n, p)
+
+    # Find unused non-terminals
+    unused_rules = grammar.unused_rules()
+    for prod in unused_rules:
+        errorlog.warning('%s:%d: Rule %r defined, but not used', prod.file, prod.line, prod.name)
+
+    if len(unused_terminals) == 1:
+        errorlog.warning('There is 1 unused token')
+    if len(unused_terminals) > 1:
+        errorlog.warning('There are %d unused tokens', len(unused_terminals))
+
+    if len(unused_rules) == 1:
+        errorlog.warning('There is 1 unused rule')
+    if len(unused_rules) > 1:
+        errorlog.warning('There are %d unused rules', len(unused_rules))
+
+    if debug:
+        debuglog.info('')
+        debuglog.info('Terminals, with rules where they appear')
+        debuglog.info('')
+        terms = list(grammar.Terminals)
+        terms.sort()
+        for term in terms:
+            debuglog.info('%-20s : %s', term, ' '.join([str(s) for s in grammar.Terminals[term]]))
+
+        debuglog.info('')
+        debuglog.info('Nonterminals, with rules where they appear')
+        debuglog.info('')
+        nonterms = list(grammar.Nonterminals)
+        nonterms.sort()
+        for nonterm in nonterms:
+            debuglog.info('%-20s : %s', nonterm, ' '.join([str(s) for s in grammar.Nonterminals[nonterm]]))
+        debuglog.info('')
+
+    if check_recursion:
+        unreachable = grammar.find_unreachable()
+        for u in unreachable:
+            errorlog.warning('Symbol %r is unreachable', u)
+
+        infinite = grammar.infinite_cycles()
+        for inf in infinite:
+            errorlog.error('Infinite recursion detected for symbol %r', inf)
+            errors = True
+
+    unused_prec = grammar.unused_precedence()
+    for term, assoc in unused_prec:
+        errorlog.error('Precedence rule %r defined for unknown symbol %r', assoc, term)
+        errors = True
+
+    if errors:
+        raise YaccError('Unable to build parser')
+
+    # Run the LRGeneratedTable on the grammar
+    if debug:
+        errorlog.debug('Generating %s tables', method)
+
+    lr = LRGeneratedTable(grammar, method, debuglog)
+
+    if debug:
+        num_sr = len(lr.sr_conflicts)
+
+        # Report shift/reduce and reduce/reduce conflicts
+        if num_sr == 1:
+            errorlog.warning('1 shift/reduce conflict')
+        elif num_sr > 1:
+            errorlog.warning('%d shift/reduce conflicts', num_sr)
+
+        num_rr = len(lr.rr_conflicts)
+        if num_rr == 1:
+            errorlog.warning('1 reduce/reduce conflict')
+        elif num_rr > 1:
+            errorlog.warning('%d reduce/reduce conflicts', num_rr)
+
+    # Write out conflicts to the output file
+    if debug and (lr.sr_conflicts or lr.rr_conflicts):
+        debuglog.warning('')
+        debuglog.warning('Conflicts:')
+        debuglog.warning('')
+
+        for state, tok, resolution in lr.sr_conflicts:
+            debuglog.warning('shift/reduce conflict for %s in state %d resolved as %s',  tok, state, resolution)
+
+        already_reported = set()
+        for state, rule, rejected in lr.rr_conflicts:
+            if (state, id(rule), id(rejected)) in already_reported:
+                continue
+            debuglog.warning('reduce/reduce conflict in state %d resolved using rule (%s)', state, rule)
+            debuglog.warning('rejected rule (%s) in state %d', rejected, state)
+            errorlog.warning('reduce/reduce conflict in state %d resolved using rule (%s)', state, rule)
+            errorlog.warning('rejected rule (%s) in state %d', rejected, state)
+            already_reported.add((state, id(rule), id(rejected)))
+
+        warned_never = []
+        for state, rule, rejected in lr.rr_conflicts:
+            if not rejected.reduced and (rejected not in warned_never):
+                debuglog.warning('Rule (%s) is never reduced', rejected)
+                errorlog.warning('Rule (%s) is never reduced', rejected)
+                warned_never.append(rejected)
+
+    # Write the table file if requested
+    if write_tables:
+        try:
+            lr.write_table(tabmodule, outputdir, signature)
+        except IOError as e:
+            errorlog.warning("Couldn't create %r. %s" % (tabmodule, e))
+
+    # Write a pickled version of the tables
+    if picklefile:
+        try:
+            lr.pickle_table(picklefile, signature)
+        except IOError as e:
+            errorlog.warning("Couldn't create %r. %s" % (picklefile, e))
+
+    # Build the parser
+    lr.bind_callables(pinfo.pdict)
+    parser = LRParser(lr, pinfo.error_func)
+
+    parse = parser.parse
+    return parser
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ygen.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ygen.py
new file mode 100644
index 0000000000000000000000000000000000000000..acf5ca1a37b69389256227c570c65eed96e3228e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/ply/ygen.py
@@ -0,0 +1,74 @@
+# ply: ygen.py
+#
+# This is a support program that auto-generates different versions of the YACC parsing
+# function with different features removed for the purposes of performance.
+#
+# Users should edit the method LParser.parsedebug() in yacc.py.   The source code 
+# for that method is then used to create the other methods.   See the comments in
+# yacc.py for further details.
+
+import os.path
+import shutil
+
+def get_source_range(lines, tag):
+    srclines = enumerate(lines)
+    start_tag = '#--! %s-start' % tag
+    end_tag = '#--! %s-end' % tag
+
+    for start_index, line in srclines:
+        if line.strip().startswith(start_tag):
+            break
+
+    for end_index, line in srclines:
+        if line.strip().endswith(end_tag):
+            break
+
+    return (start_index + 1, end_index)
+
+def filter_section(lines, tag):
+    filtered_lines = []
+    include = True
+    tag_text = '#--! %s' % tag
+    for line in lines:
+        if line.strip().startswith(tag_text):
+            include = not include
+        elif include:
+            filtered_lines.append(line)
+    return filtered_lines
+
+def main():
+    dirname = os.path.dirname(__file__)
+    shutil.copy2(os.path.join(dirname, 'yacc.py'), os.path.join(dirname, 'yacc.py.bak'))
+    with open(os.path.join(dirname, 'yacc.py'), 'r') as f:
+        lines = f.readlines()
+
+    parse_start, parse_end = get_source_range(lines, 'parsedebug')
+    parseopt_start, parseopt_end = get_source_range(lines, 'parseopt')
+    parseopt_notrack_start, parseopt_notrack_end = get_source_range(lines, 'parseopt-notrack')
+
+    # Get the original source
+    orig_lines = lines[parse_start:parse_end]
+
+    # Filter the DEBUG sections out
+    parseopt_lines = filter_section(orig_lines, 'DEBUG')
+
+    # Filter the TRACKING sections out
+    parseopt_notrack_lines = filter_section(parseopt_lines, 'TRACKING')
+
+    # Replace the parser source sections with updated versions
+    lines[parseopt_notrack_start:parseopt_notrack_end] = parseopt_notrack_lines
+    lines[parseopt_start:parseopt_end] = parseopt_lines
+
+    lines = [line.rstrip()+'\n' for line in lines]
+    with open(os.path.join(dirname, 'yacc.py'), 'w') as f:
+        f.writelines(lines)
+
+    print('Updated yacc.py')
+
+if __name__ == '__main__':
+    main()
+
+
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/plyparser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/plyparser.py
new file mode 100644
index 0000000000000000000000000000000000000000..6222c0eab1763f164bf635902be87de4b3f74002
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/plyparser.py
@@ -0,0 +1,133 @@
+#-----------------------------------------------------------------
+# plyparser.py
+#
+# PLYParser class and other utilites for simplifying programming
+# parsers with PLY
+#
+# Eli Bendersky [https://eli.thegreenplace.net/]
+# License: BSD
+#-----------------------------------------------------------------
+
+import warnings
+
+class Coord(object):
+    """ Coordinates of a syntactic element. Consists of:
+            - File name
+            - Line number
+            - (optional) column number, for the Lexer
+    """
+    __slots__ = ('file', 'line', 'column', '__weakref__')
+    def __init__(self, file, line, column=None):
+        self.file = file
+        self.line = line
+        self.column = column
+
+    def __str__(self):
+        str = "%s:%s" % (self.file, self.line)
+        if self.column: str += ":%s" % self.column
+        return str
+
+
+class ParseError(Exception): pass
+
+
+class PLYParser(object):
+    def _create_opt_rule(self, rulename):
+        """ Given a rule name, creates an optional ply.yacc rule
+            for it. The name of the optional rule is
+            <rulename>_opt
+        """
+        optname = rulename + '_opt'
+
+        def optrule(self, p):
+            p[0] = p[1]
+
+        optrule.__doc__ = '%s : empty\n| %s' % (optname, rulename)
+        optrule.__name__ = 'p_%s' % optname
+        setattr(self.__class__, optrule.__name__, optrule)
+
+    def _coord(self, lineno, column=None):
+        return Coord(
+                file=self.clex.filename,
+                line=lineno,
+                column=column)
+
+    def _token_coord(self, p, token_idx):
+        """ Returns the coordinates for the YaccProduction objet 'p' indexed
+            with 'token_idx'. The coordinate includes the 'lineno' and
+            'column'. Both follow the lex semantic, starting from 1.
+        """
+        last_cr = p.lexer.lexer.lexdata.rfind('\n', 0, p.lexpos(token_idx))
+        if last_cr < 0:
+            last_cr = -1
+        column = (p.lexpos(token_idx) - (last_cr))
+        return self._coord(p.lineno(token_idx), column)
+
+    def _parse_error(self, msg, coord):
+        raise ParseError("%s: %s" % (coord, msg))
+
+
+def parameterized(*params):
+    """ Decorator to create parameterized rules.
+
+    Parameterized rule methods must be named starting with 'p_' and contain
+    'xxx', and their docstrings may contain 'xxx' and 'yyy'. These will be
+    replaced by the given parameter tuples. For example, ``p_xxx_rule()`` with
+    docstring 'xxx_rule  : yyy' when decorated with
+    ``@parameterized(('id', 'ID'))`` produces ``p_id_rule()`` with the docstring
+    'id_rule  : ID'. Using multiple tuples produces multiple rules.
+    """
+    def decorate(rule_func):
+        rule_func._params = params
+        return rule_func
+    return decorate
+
+
+def template(cls):
+    """ Class decorator to generate rules from parameterized rule templates.
+
+    See `parameterized` for more information on parameterized rules.
+    """
+    issued_nodoc_warning = False
+    for attr_name in dir(cls):
+        if attr_name.startswith('p_'):
+            method = getattr(cls, attr_name)
+            if hasattr(method, '_params'):
+                # Remove the template method
+                delattr(cls, attr_name)
+                # Create parameterized rules from this method; only run this if
+                # the method has a docstring. This is to address an issue when
+                # pycparser's users are installed in -OO mode which strips
+                # docstrings away.
+                # See: https://github.com/eliben/pycparser/pull/198/ and
+                #      https://github.com/eliben/pycparser/issues/197
+                # for discussion.
+                if method.__doc__ is not None:
+                    _create_param_rules(cls, method)
+                elif not issued_nodoc_warning:
+                    warnings.warn(
+                        'parsing methods must have __doc__ for pycparser to work properly',
+                        RuntimeWarning,
+                        stacklevel=2)
+                    issued_nodoc_warning = True
+    return cls
+
+
+def _create_param_rules(cls, func):
+    """ Create ply.yacc rules based on a parameterized rule function
+
+    Generates new methods (one per each pair of parameters) based on the
+    template rule function `func`, and attaches them to `cls`. The rule
+    function's parameters must be accessible via its `_params` attribute.
+    """
+    for xxx, yyy in func._params:
+        # Use the template method's body for each new method
+        def param_rule(self, p):
+            func(self, p)
+
+        # Substitute in the params for the grammar rule and function name
+        param_rule.__doc__ = func.__doc__.replace('xxx', xxx).replace('yyy', yyy)
+        param_rule.__name__ = func.__name__.replace('xxx', xxx)
+
+        # Attach the new method to the class
+        setattr(cls, param_rule.__name__, param_rule)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/yacctab.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/yacctab.py
new file mode 100644
index 0000000000000000000000000000000000000000..7fbdef9767b58c283691ea102adea04309ce51bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pycparser/yacctab.py
@@ -0,0 +1,338 @@
+
+# yacctab.py
+# This file is automatically generated. Do not edit.
+_tabversion = '3.10'
+
+_lr_method = 'LALR'
+
+_lr_signature = 'translation_unit_or_emptyleftLORleftLANDleftORleftXORleftANDleftEQNEleftGTGELTLEleftRSHIFTLSHIFTleftPLUSMINUSleftTIMESDIVIDEMOD_BOOL _COMPLEX AUTO BREAK CASE CHAR CONST CONTINUE DEFAULT DO DOUBLE ELSE ENUM EXTERN FLOAT FOR GOTO IF INLINE INT LONG REGISTER OFFSETOF RESTRICT RETURN SHORT SIGNED SIZEOF STATIC STRUCT SWITCH TYPEDEF UNION UNSIGNED VOID VOLATILE WHILE __INT128 ID TYPEID INT_CONST_DEC INT_CONST_OCT INT_CONST_HEX INT_CONST_BIN FLOAT_CONST HEX_FLOAT_CONST CHAR_CONST WCHAR_CONST STRING_LITERAL WSTRING_LITERAL PLUS MINUS TIMES DIVIDE MOD OR AND NOT XOR LSHIFT RSHIFT LOR LAND LNOT LT LE GT GE EQ NE EQUALS TIMESEQUAL DIVEQUAL MODEQUAL PLUSEQUAL MINUSEQUAL LSHIFTEQUAL RSHIFTEQUAL ANDEQUAL XOREQUAL OREQUAL PLUSPLUS MINUSMINUS ARROW CONDOP LPAREN RPAREN LBRACKET RBRACKET LBRACE RBRACE COMMA PERIOD SEMI COLON ELLIPSIS PPHASH PPPRAGMA PPPRAGMASTRabstract_declarator_opt : empty\n| abstract_declaratorassignment_expression_opt : empty\n| assignment_expressionblock_item_list_opt : empty\n| block_item_listdeclaration_list_opt : empty\n| declaration_listdeclaration_specifiers_no_type_opt : empty\n| declaration_specifiers_no_typedesignation_opt : empty\n| designationexpression_opt : empty\n| expressionid_init_declarator_list_opt : empty\n| id_init_declarator_listidentifier_list_opt : empty\n| identifier_listinit_declarator_list_opt : empty\n| init_declarator_listinitializer_list_opt : empty\n| initializer_listparameter_type_list_opt : empty\n| parameter_type_liststruct_declarator_list_opt : empty\n| struct_declarator_listtype_qualifier_list_opt : empty\n| type_qualifier_list direct_id_declarator   : ID\n         direct_id_declarator   : LPAREN id_declarator RPAREN\n         direct_id_declarator   : direct_id_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET\n         direct_id_declarator   : direct_id_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET\n                                    | direct_id_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET\n         direct_id_declarator   : direct_id_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET\n         direct_id_declarator   : direct_id_declarator LPAREN parameter_type_list RPAREN\n                                    | direct_id_declarator LPAREN identifier_list_opt RPAREN\n         direct_typeid_declarator   : TYPEID\n         direct_typeid_declarator   : LPAREN typeid_declarator RPAREN\n         direct_typeid_declarator   : direct_typeid_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET\n         direct_typeid_declarator   : direct_typeid_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET\n                                    | direct_typeid_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET\n         direct_typeid_declarator   : direct_typeid_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET\n         direct_typeid_declarator   : direct_typeid_declarator LPAREN parameter_type_list RPAREN\n                                    | direct_typeid_declarator LPAREN identifier_list_opt RPAREN\n         direct_typeid_noparen_declarator   : TYPEID\n         direct_typeid_noparen_declarator   : direct_typeid_noparen_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET\n         direct_typeid_noparen_declarator   : direct_typeid_noparen_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET\n                                    | direct_typeid_noparen_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET\n         direct_typeid_noparen_declarator   : direct_typeid_noparen_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET\n         direct_typeid_noparen_declarator   : direct_typeid_noparen_declarator LPAREN parameter_type_list RPAREN\n                                    | direct_typeid_noparen_declarator LPAREN identifier_list_opt RPAREN\n         id_declarator  : direct_id_declarator\n         id_declarator  : pointer direct_id_declarator\n         typeid_declarator  : direct_typeid_declarator\n         typeid_declarator  : pointer direct_typeid_declarator\n         typeid_noparen_declarator  : direct_typeid_noparen_declarator\n         typeid_noparen_declarator  : pointer direct_typeid_noparen_declarator\n         translation_unit_or_empty   : translation_unit\n                                        | empty\n         translation_unit    : external_declaration\n         translation_unit    : translation_unit external_declaration\n         external_declaration    : function_definition\n         external_declaration    : declaration\n         external_declaration    : pp_directive\n                                    | pppragma_directive\n         external_declaration    : SEMI\n         pp_directive  : PPHASH\n         pppragma_directive      : PPPRAGMA\n                                    | PPPRAGMA PPPRAGMASTR\n         function_definition : id_declarator declaration_list_opt compound_statement\n         function_definition : declaration_specifiers id_declarator declaration_list_opt compound_statement\n         statement   : labeled_statement\n                        | expression_statement\n                        | compound_statement\n                        | selection_statement\n                        | iteration_statement\n                        | jump_statement\n                        | pppragma_directive\n         pragmacomp_or_statement     : pppragma_directive statement\n                                        | statement\n         decl_body : declaration_specifiers init_declarator_list_opt\n                      | declaration_specifiers_no_type id_init_declarator_list_opt\n         declaration : decl_body SEMI\n         declaration_list    : declaration\n                                | declaration_list declaration\n         declaration_specifiers_no_type  : type_qualifier declaration_specifiers_no_type_opt\n         declaration_specifiers_no_type  : storage_class_specifier declaration_specifiers_no_type_opt\n         declaration_specifiers_no_type  : function_specifier declaration_specifiers_no_type_opt\n         declaration_specifiers  : declaration_specifiers type_qualifier\n         declaration_specifiers  : declaration_specifiers storage_class_specifier\n         declaration_specifiers  : declaration_specifiers function_specifier\n         declaration_specifiers  : declaration_specifiers type_specifier_no_typeid\n         declaration_specifiers  : type_specifier\n         declaration_specifiers  : declaration_specifiers_no_type type_specifier\n         storage_class_specifier : AUTO\n                                    | REGISTER\n                                    | STATIC\n                                    | EXTERN\n                                    | TYPEDEF\n         function_specifier  : INLINE\n         type_specifier_no_typeid  : VOID\n                                      | _BOOL\n                                      | CHAR\n                                      | SHORT\n                                      | INT\n                                      | LONG\n                                      | FLOAT\n                                      | DOUBLE\n                                      | _COMPLEX\n                                      | SIGNED\n                                      | UNSIGNED\n                                      | __INT128\n         type_specifier  : typedef_name\n                            | enum_specifier\n                            | struct_or_union_specifier\n                            | type_specifier_no_typeid\n         type_qualifier  : CONST\n                            | RESTRICT\n                            | VOLATILE\n         init_declarator_list    : init_declarator\n                                    | init_declarator_list COMMA init_declarator\n         init_declarator : declarator\n                            | declarator EQUALS initializer\n         id_init_declarator_list    : id_init_declarator\n                                       | id_init_declarator_list COMMA init_declarator\n         id_init_declarator : id_declarator\n                               | id_declarator EQUALS initializer\n         specifier_qualifier_list    : specifier_qualifier_list type_specifier_no_typeid\n         specifier_qualifier_list    : specifier_qualifier_list type_qualifier\n         specifier_qualifier_list  : type_specifier\n         specifier_qualifier_list  : type_qualifier_list type_specifier\n         struct_or_union_specifier   : struct_or_union ID\n                                        | struct_or_union TYPEID\n         struct_or_union_specifier : struct_or_union brace_open struct_declaration_list brace_close\n                                      | struct_or_union brace_open brace_close\n         struct_or_union_specifier   : struct_or_union ID brace_open struct_declaration_list brace_close\n                                        | struct_or_union ID brace_open brace_close\n                                        | struct_or_union TYPEID brace_open struct_declaration_list brace_close\n                                        | struct_or_union TYPEID brace_open brace_close\n         struct_or_union : STRUCT\n                            | UNION\n         struct_declaration_list     : struct_declaration\n                                        | struct_declaration_list struct_declaration\n         struct_declaration : specifier_qualifier_list struct_declarator_list_opt SEMI\n         struct_declaration : SEMI\n         struct_declaration : pppragma_directive\n         struct_declarator_list  : struct_declarator\n                                    | struct_declarator_list COMMA struct_declarator\n         struct_declarator : declarator\n         struct_declarator   : declarator COLON constant_expression\n                                | COLON constant_expression\n         enum_specifier  : ENUM ID\n                            | ENUM TYPEID\n         enum_specifier  : ENUM brace_open enumerator_list brace_close\n         enum_specifier  : ENUM ID brace_open enumerator_list brace_close\n                            | ENUM TYPEID brace_open enumerator_list brace_close\n         enumerator_list : enumerator\n                            | enumerator_list COMMA\n                            | enumerator_list COMMA enumerator\n         enumerator  : ID\n                        | ID EQUALS constant_expression\n         declarator  : id_declarator\n                        | typeid_declarator\n         pointer : TIMES type_qualifier_list_opt\n                    | TIMES type_qualifier_list_opt pointer\n         type_qualifier_list : type_qualifier\n                                | type_qualifier_list type_qualifier\n         parameter_type_list : parameter_list\n                                | parameter_list COMMA ELLIPSIS\n         parameter_list  : parameter_declaration\n                            | parameter_list COMMA parameter_declaration\n         parameter_declaration   : declaration_specifiers id_declarator\n                                    | declaration_specifiers typeid_noparen_declarator\n         parameter_declaration   : declaration_specifiers abstract_declarator_opt\n         identifier_list : identifier\n                            | identifier_list COMMA identifier\n         initializer : assignment_expression\n         initializer : brace_open initializer_list_opt brace_close\n                        | brace_open initializer_list COMMA brace_close\n         initializer_list    : designation_opt initializer\n                                | initializer_list COMMA designation_opt initializer\n         designation : designator_list EQUALS\n         designator_list : designator\n                            | designator_list designator\n         designator  : LBRACKET constant_expression RBRACKET\n                        | PERIOD identifier\n         type_name   : specifier_qualifier_list abstract_declarator_opt\n         abstract_declarator     : pointer\n         abstract_declarator     : pointer direct_abstract_declarator\n         abstract_declarator     : direct_abstract_declarator\n         direct_abstract_declarator  : LPAREN abstract_declarator RPAREN  direct_abstract_declarator  : direct_abstract_declarator LBRACKET assignment_expression_opt RBRACKET\n         direct_abstract_declarator  : LBRACKET assignment_expression_opt RBRACKET\n         direct_abstract_declarator  : direct_abstract_declarator LBRACKET TIMES RBRACKET\n         direct_abstract_declarator  : LBRACKET TIMES RBRACKET\n         direct_abstract_declarator  : direct_abstract_declarator LPAREN parameter_type_list_opt RPAREN\n         direct_abstract_declarator  : LPAREN parameter_type_list_opt RPAREN\n         block_item  : declaration\n                        | statement\n         block_item_list : block_item\n                            | block_item_list block_item\n         compound_statement : brace_open block_item_list_opt brace_close  labeled_statement : ID COLON pragmacomp_or_statement  labeled_statement : CASE constant_expression COLON pragmacomp_or_statement  labeled_statement : DEFAULT COLON pragmacomp_or_statement  selection_statement : IF LPAREN expression RPAREN pragmacomp_or_statement  selection_statement : IF LPAREN expression RPAREN statement ELSE pragmacomp_or_statement  selection_statement : SWITCH LPAREN expression RPAREN pragmacomp_or_statement  iteration_statement : WHILE LPAREN expression RPAREN pragmacomp_or_statement  iteration_statement : DO pragmacomp_or_statement WHILE LPAREN expression RPAREN SEMI  iteration_statement : FOR LPAREN expression_opt SEMI expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement  iteration_statement : FOR LPAREN declaration expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement  jump_statement  : GOTO ID SEMI  jump_statement  : BREAK SEMI  jump_statement  : CONTINUE SEMI  jump_statement  : RETURN expression SEMI\n                            | RETURN SEMI\n         expression_statement : expression_opt SEMI  expression  : assignment_expression\n                        | expression COMMA assignment_expression\n         typedef_name : TYPEID  assignment_expression   : conditional_expression\n                                    | unary_expression assignment_operator assignment_expression\n         assignment_operator : EQUALS\n                                | XOREQUAL\n                                | TIMESEQUAL\n                                | DIVEQUAL\n                                | MODEQUAL\n                                | PLUSEQUAL\n                                | MINUSEQUAL\n                                | LSHIFTEQUAL\n                                | RSHIFTEQUAL\n                                | ANDEQUAL\n                                | OREQUAL\n         constant_expression : conditional_expression  conditional_expression  : binary_expression\n                                    | binary_expression CONDOP expression COLON conditional_expression\n         binary_expression   : cast_expression\n                                | binary_expression TIMES binary_expression\n                                | binary_expression DIVIDE binary_expression\n                                | binary_expression MOD binary_expression\n                                | binary_expression PLUS binary_expression\n                                | binary_expression MINUS binary_expression\n                                | binary_expression RSHIFT binary_expression\n                                | binary_expression LSHIFT binary_expression\n                                | binary_expression LT binary_expression\n                                | binary_expression LE binary_expression\n                                | binary_expression GE binary_expression\n                                | binary_expression GT binary_expression\n                                | binary_expression EQ binary_expression\n                                | binary_expression NE binary_expression\n                                | binary_expression AND binary_expression\n                                | binary_expression OR binary_expression\n                                | binary_expression XOR binary_expression\n                                | binary_expression LAND binary_expression\n                                | binary_expression LOR binary_expression\n         cast_expression : unary_expression  cast_expression : LPAREN type_name RPAREN cast_expression  unary_expression    : postfix_expression  unary_expression    : PLUSPLUS unary_expression\n                                | MINUSMINUS unary_expression\n                                | unary_operator cast_expression\n         unary_expression    : SIZEOF unary_expression\n                                | SIZEOF LPAREN type_name RPAREN\n         unary_operator  : AND\n                            | TIMES\n                            | PLUS\n                            | MINUS\n                            | NOT\n                            | LNOT\n         postfix_expression  : primary_expression  postfix_expression  : postfix_expression LBRACKET expression RBRACKET  postfix_expression  : postfix_expression LPAREN argument_expression_list RPAREN\n                                | postfix_expression LPAREN RPAREN\n         postfix_expression  : postfix_expression PERIOD ID\n                                | postfix_expression PERIOD TYPEID\n                                | postfix_expression ARROW ID\n                                | postfix_expression ARROW TYPEID\n         postfix_expression  : postfix_expression PLUSPLUS\n                                | postfix_expression MINUSMINUS\n         postfix_expression  : LPAREN type_name RPAREN brace_open initializer_list brace_close\n                                | LPAREN type_name RPAREN brace_open initializer_list COMMA brace_close\n         primary_expression  : identifier  primary_expression  : constant  primary_expression  : unified_string_literal\n                                | unified_wstring_literal\n         primary_expression  : LPAREN expression RPAREN  primary_expression  : OFFSETOF LPAREN type_name COMMA offsetof_member_designator RPAREN\n         offsetof_member_designator : identifier\n                                         | offsetof_member_designator PERIOD identifier\n                                         | offsetof_member_designator LBRACKET expression RBRACKET\n         argument_expression_list    : assignment_expression\n                                        | argument_expression_list COMMA assignment_expression\n         identifier  : ID  constant    : INT_CONST_DEC\n                        | INT_CONST_OCT\n                        | INT_CONST_HEX\n                        | INT_CONST_BIN\n         constant    : FLOAT_CONST\n                        | HEX_FLOAT_CONST\n         constant    : CHAR_CONST\n                        | WCHAR_CONST\n         unified_string_literal  : STRING_LITERAL\n                                    | unified_string_literal STRING_LITERAL\n         unified_wstring_literal : WSTRING_LITERAL\n                                    | unified_wstring_literal WSTRING_LITERAL\n         brace_open  :   LBRACE\n         brace_close :   RBRACE\n        empty : '
+    
+_lr_action_items = {'VOID':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[6,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,6,-96,-111,-106,-65,-95,-112,6,-221,-109,-113,6,-63,-118,6,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,6,-53,6,-84,6,6,-61,-133,-307,-132,6,-153,-152,-166,-90,-92,6,-89,-91,-94,-83,-86,-88,-69,-30,6,6,-70,6,-85,6,6,6,-135,-130,-145,-146,-142,-308,6,6,-167,6,6,-36,-35,6,6,-73,-76,-72,-74,6,-78,-199,-198,-77,-200,-75,6,-139,6,-137,-134,-143,-131,-128,-129,-154,-71,6,-31,6,6,6,-34,6,6,6,-218,-217,6,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,6,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'LBRACKET':([2,3,5,6,7,8,9,10,11,15,16,19,20,21,24,25,29,30,31,32,35,37,39,41,44,45,48,50,51,54,61,69,70,71,73,74,76,77,78,79,80,83,85,88,91,92,96,105,113,115,126,127,131,139,140,143,150,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,187,188,189,192,193,196,199,229,232,234,235,237,238,244,249,251,260,276,279,280,282,286,293,296,319,324,325,356,357,362,363,370,371,374,379,383,384,385,386,389,394,397,398,418,419,420,421,427,428,447,448,452,454,456,459,460,466,472,473,474,475,476,484,485,486,491,492,495,496,507,510,511,512,513,518,520,525,],[-104,-117,-115,-101,-99,59,-97,-116,-98,-102,-93,-96,-111,-106,-95,-112,-221,-109,-309,-113,-118,-29,-107,-103,-114,-108,-110,-105,-119,-100,59,-133,-307,-132,-153,-152,-28,-164,-166,-27,-90,-92,144,-37,-89,-91,-94,-30,198,-294,-135,-130,-308,-167,-165,144,-298,-286,-301,-305,-302,-299,-284,-285,284,-297,-271,-303,-295,-283,-300,-296,-36,-35,198,198,326,-45,330,-294,-139,-137,-134,-131,-128,-129,-154,-38,376,-306,-304,-280,-279,-31,-34,198,198,326,330,-138,-136,-156,-155,-44,-43,-183,376,-278,-277,-276,-275,-274,-287,198,198,-33,-32,-197,-191,-193,-195,-39,-42,-186,376,-184,-272,-273,376,-51,-50,-192,-194,-196,-41,-40,-185,509,-289,-46,-49,-288,376,-281,-48,-47,-290,-282,-291,]),'WCHAR_CONST':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,156,-28,-309,156,-308,-167,-309,156,156,-270,156,-268,156,-267,156,-266,156,156,-265,-269,156,156,156,-73,-76,-72,156,-74,156,156,-78,-199,-198,-77,-200,156,-75,-266,156,156,156,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,156,-233,-234,-226,-232,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,156,-309,-266,156,-218,-217,156,-215,156,156,156,-201,156,-214,156,-80,-202,156,156,156,-266,156,156,-12,156,156,-11,156,156,-28,-309,-266,-213,-216,156,-205,156,-79,-203,-309,-182,156,156,-309,156,-266,156,156,156,156,-204,156,156,156,156,-11,156,-209,-208,-206,-80,156,-309,156,156,156,-210,-207,156,-212,-211,]),'FLOAT_CONST':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,157,-28,-309,157,-308,-167,-309,157,157,-270,157,-268,157,-267,157,-266,157,157,-265,-269,157,157,157,-73,-76,-72,157,-74,157,157,-78,-199,-198,-77,-200,157,-75,-266,157,157,157,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,157,-233,-234,-226,-232,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,157,-309,-266,157,-218,-217,157,-215,157,157,157,-201,157,-214,157,-80,-202,157,157,157,-266,157,157,-12,157,157,-11,157,157,-28,-309,-266,-213,-216,157,-205,157,-79,-203,-309,-182,157,157,-309,157,-266,157,157,157,157,-204,157,157,157,157,-11,157,-209,-208,-206,-80,157,-309,157,157,157,-210,-207,157,-212,-211,]),'MINUS':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,115,121,131,139,144,147,148,150,151,152,153,154,155,156,157,158,159,160,161,162,164,166,167,169,170,171,172,173,174,175,176,177,178,179,180,181,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,282,284,285,288,289,290,291,292,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,383,384,385,386,389,394,395,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,422,423,424,430,432,433,435,437,439,442,443,454,457,458,459,460,461,463,465,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,160,-28,-309,-294,160,-308,-167,-309,160,160,-298,-270,-257,-286,-301,-305,-302,-299,-284,160,-268,-285,-259,-238,160,-267,160,-297,-266,-271,160,160,-303,-265,-295,-283,301,-300,-296,-269,160,160,160,-73,-76,-72,160,-74,160,160,-78,-199,-198,-77,-200,160,-75,-266,-294,160,160,160,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,160,-233,-234,-226,-232,-306,160,-263,-304,-280,-279,160,160,160,-257,-262,160,-260,-261,160,160,160,160,160,160,160,160,160,160,160,160,160,160,160,160,160,160,160,-309,-266,160,-218,-217,160,-215,160,160,160,-201,160,-214,160,-80,-202,160,160,160,-266,160,160,-12,160,160,-11,-278,-277,-276,-275,-274,-287,160,301,301,301,-243,301,301,301,-242,301,301,-240,-239,301,301,301,301,301,-241,160,-28,-309,-266,-213,-216,160,-205,160,-79,-203,-309,-182,-264,-272,-273,160,160,-258,-309,160,-266,160,160,160,160,-204,160,160,160,160,-11,160,-209,-208,-206,-80,-288,160,-309,-281,160,160,-282,160,-210,-207,160,-212,-211,]),'RPAREN':([2,3,5,6,7,8,9,10,11,15,16,19,20,21,24,25,29,30,31,32,35,37,39,41,44,45,48,50,51,54,58,60,61,69,71,73,74,76,77,78,79,80,83,85,88,91,92,96,105,109,110,111,112,113,114,115,116,118,126,127,131,139,140,141,143,145,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,183,187,188,189,190,191,192,193,194,195,196,197,199,211,227,232,234,235,237,238,244,249,251,256,257,276,278,279,280,282,285,286,289,290,292,293,294,295,296,297,319,320,321,322,323,324,325,327,331,332,333,334,347,356,357,362,363,370,371,381,382,383,384,385,386,388,389,390,392,393,394,396,397,398,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,418,419,420,421,425,426,427,428,431,436,438,440,444,447,448,458,459,460,465,472,473,474,475,476,484,485,490,491,492,494,495,496,500,503,507,511,512,513,514,515,518,520,521,525,],[-104,-117,-115,-101,-99,-52,-97,-116,-98,-102,-93,-96,-111,-106,-95,-112,-221,-109,-309,-113,-118,-29,-107,-103,-114,-108,-110,-105,-119,-100,105,-309,-53,-133,-132,-153,-152,-28,-164,-166,-27,-90,-92,-54,-37,-89,-91,-94,-30,187,-17,188,-170,-309,-18,-294,-168,-175,-135,-130,-308,-167,-165,251,-55,-309,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,-236,-300,-296,-222,-36,-35,-309,-174,-2,-188,-56,-172,-1,-45,-173,-190,-14,-219,-139,-137,-134,-131,-128,-129,-154,-38,370,371,-306,-263,-304,-280,-279,389,-31,-257,-262,-260,-34,394,395,-309,-261,-188,-23,-24,420,421,-57,-189,-309,-309,-176,-169,-171,-13,-138,-136,-156,-155,-44,-43,-223,458,-278,-277,-276,-275,-292,-274,460,463,464,-287,-187,-188,-309,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-33,-32,-197,-191,472,473,-193,-195,476,-220,479,481,483,-39,-42,-264,-272,-273,-258,-51,-50,-192,-194,-196,-41,-40,-293,507,-289,-237,-46,-49,-309,516,-288,-281,-48,-47,-309,522,-290,-282,526,-291,]),'LONG':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[21,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,21,-96,-111,-106,-65,-95,-112,21,-221,-109,-113,21,-63,-118,21,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,21,-53,21,-84,21,21,-61,-133,-307,-132,21,-153,-152,-166,-90,-92,21,-89,-91,-94,-83,-86,-88,-69,-30,21,21,-70,21,-85,21,21,21,-135,-130,-145,-146,-142,-308,21,21,-167,21,21,-36,-35,21,21,-73,-76,-72,-74,21,-78,-199,-198,-77,-200,-75,21,-139,21,-137,-134,-143,-131,-128,-129,-154,-71,21,-31,21,21,21,-34,21,21,21,-218,-217,21,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,21,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'PLUS':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,115,121,131,139,144,147,148,150,151,152,153,154,155,156,157,158,159,160,161,162,164,166,167,169,170,171,172,173,174,175,176,177,178,179,180,181,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,282,284,285,288,289,290,291,292,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,383,384,385,386,389,394,395,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,422,423,424,430,432,433,435,437,439,442,443,454,457,458,459,460,461,463,465,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,167,-28,-309,-294,167,-308,-167,-309,167,167,-298,-270,-257,-286,-301,-305,-302,-299,-284,167,-268,-285,-259,-238,167,-267,167,-297,-266,-271,167,167,-303,-265,-295,-283,305,-300,-296,-269,167,167,167,-73,-76,-72,167,-74,167,167,-78,-199,-198,-77,-200,167,-75,-266,-294,167,167,167,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,167,-233,-234,-226,-232,-306,167,-263,-304,-280,-279,167,167,167,-257,-262,167,-260,-261,167,167,167,167,167,167,167,167,167,167,167,167,167,167,167,167,167,167,167,-309,-266,167,-218,-217,167,-215,167,167,167,-201,167,-214,167,-80,-202,167,167,167,-266,167,167,-12,167,167,-11,-278,-277,-276,-275,-274,-287,167,305,305,305,-243,305,305,305,-242,305,305,-240,-239,305,305,305,305,305,-241,167,-28,-309,-266,-213,-216,167,-205,167,-79,-203,-309,-182,-264,-272,-273,167,167,-258,-309,167,-266,167,167,167,167,-204,167,167,167,167,-11,167,-209,-208,-206,-80,-288,167,-309,-281,167,167,-282,167,-210,-207,167,-212,-211,]),'ELLIPSIS':([201,],[333,]),'GT':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,306,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,306,-245,-243,-247,306,-246,-242,-249,306,-240,-239,-248,306,306,306,306,-241,-264,-272,-273,-258,-288,-281,-282,]),'GOTO':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,204,-308,-73,-76,-72,-74,204,-78,-199,-198,-77,-200,204,-75,-218,-217,-215,204,-201,-214,204,-80,-202,204,-213,-216,-205,204,-79,-203,204,-204,204,204,-209,-208,-206,-80,204,204,-210,-207,204,-212,-211,]),'ENUM':([0,1,3,7,8,9,11,12,14,17,18,19,23,24,26,34,35,36,37,40,42,47,49,51,53,54,55,56,57,60,61,64,65,67,68,70,72,78,87,101,102,103,104,105,117,120,121,122,123,124,125,128,129,130,131,132,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,233,236,258,277,286,287,288,291,293,327,331,336,337,339,340,346,349,351,352,353,360,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[28,-309,-117,-99,-52,-97,-98,-64,-60,-66,28,-96,-65,-95,28,-63,-118,28,-29,-62,-67,-309,-309,-119,-68,-100,-87,-10,-9,28,-53,-84,28,28,-61,-307,28,-166,28,-83,-86,-88,-69,-30,28,-70,28,-85,28,28,28,-145,-146,-142,-308,28,-167,28,28,-36,-35,28,28,-73,-76,-72,-74,28,-78,-199,-198,-77,-200,-75,28,28,-143,-71,28,-31,28,28,28,-34,28,28,-218,-217,28,-215,-201,-214,-78,-80,-202,-144,28,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'PERIOD':([70,115,131,150,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,260,276,279,280,282,374,379,383,384,385,386,389,394,452,454,456,459,460,466,486,491,492,507,510,511,518,520,525,],[-307,-294,-308,-298,-286,-301,-305,-302,-299,-284,-285,283,-297,-271,-303,-295,-283,-300,-296,-294,375,-306,-304,-280,-279,-183,375,-278,-277,-276,-275,-274,-287,-186,375,-184,-272,-273,375,-185,508,-289,-288,375,-281,-290,-282,-291,]),'GE':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,310,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,310,-245,-243,-247,310,-246,-242,-249,310,-240,-239,-248,310,310,310,310,-241,-264,-272,-273,-258,-288,-281,-282,]),'INT_CONST_DEC':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,177,-28,-309,177,-308,-167,-309,177,177,-270,177,-268,177,-267,177,-266,177,177,-265,-269,177,177,177,-73,-76,-72,177,-74,177,177,-78,-199,-198,-77,-200,177,-75,-266,177,177,177,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,177,-233,-234,-226,-232,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,177,-309,-266,177,-218,-217,177,-215,177,177,177,-201,177,-214,177,-80,-202,177,177,177,-266,177,177,-12,177,177,-11,177,177,-28,-309,-266,-213,-216,177,-205,177,-79,-203,-309,-182,177,177,-309,177,-266,177,177,177,177,-204,177,177,177,177,-11,177,-209,-208,-206,-80,177,-309,177,177,177,-210,-207,177,-212,-211,]),'ARROW':([115,131,150,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,279,280,282,383,384,385,386,389,394,459,460,507,511,520,],[-294,-308,-298,-286,-301,-305,-302,-299,-284,-285,281,-297,-271,-303,-295,-283,-300,-296,-294,-306,-304,-280,-279,-278,-277,-276,-275,-274,-287,-272,-273,-288,-281,-282,]),'CHAR':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[41,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,41,-96,-111,-106,-65,-95,-112,41,-221,-109,-113,41,-63,-118,41,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,41,-53,41,-84,41,41,-61,-133,-307,-132,41,-153,-152,-166,-90,-92,41,-89,-91,-94,-83,-86,-88,-69,-30,41,41,-70,41,-85,41,41,41,-135,-130,-145,-146,-142,-308,41,41,-167,41,41,-36,-35,41,41,-73,-76,-72,-74,41,-78,-199,-198,-77,-200,-75,41,-139,41,-137,-134,-143,-131,-128,-129,-154,-71,41,-31,41,41,41,-34,41,41,41,-218,-217,41,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,41,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'HEX_FLOAT_CONST':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,180,-28,-309,180,-308,-167,-309,180,180,-270,180,-268,180,-267,180,-266,180,180,-265,-269,180,180,180,-73,-76,-72,180,-74,180,180,-78,-199,-198,-77,-200,180,-75,-266,180,180,180,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,180,-233,-234,-226,-232,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,180,-309,-266,180,-218,-217,180,-215,180,180,180,-201,180,-214,180,-80,-202,180,180,180,-266,180,180,-12,180,180,-11,180,180,-28,-309,-266,-213,-216,180,-205,180,-79,-203,-309,-182,180,180,-309,180,-266,180,180,180,180,-204,180,180,180,180,-11,180,-209,-208,-206,-80,180,-309,180,180,180,-210,-207,180,-212,-211,]),'DOUBLE':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[45,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,45,-96,-111,-106,-65,-95,-112,45,-221,-109,-113,45,-63,-118,45,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,45,-53,45,-84,45,45,-61,-133,-307,-132,45,-153,-152,-166,-90,-92,45,-89,-91,-94,-83,-86,-88,-69,-30,45,45,-70,45,-85,45,45,45,-135,-130,-145,-146,-142,-308,45,45,-167,45,45,-36,-35,45,45,-73,-76,-72,-74,45,-78,-199,-198,-77,-200,-75,45,-139,45,-137,-134,-143,-131,-128,-129,-154,-71,45,-31,45,45,45,-34,45,45,45,-218,-217,45,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,45,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'MINUSEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,265,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'INT_CONST_OCT':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,181,-28,-309,181,-308,-167,-309,181,181,-270,181,-268,181,-267,181,-266,181,181,-265,-269,181,181,181,-73,-76,-72,181,-74,181,181,-78,-199,-198,-77,-200,181,-75,-266,181,181,181,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,181,-233,-234,-226,-232,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,181,-309,-266,181,-218,-217,181,-215,181,181,181,-201,181,-214,181,-80,-202,181,181,181,-266,181,181,-12,181,181,-11,181,181,-28,-309,-266,-213,-216,181,-205,181,-79,-203,-309,-182,181,181,-309,181,-266,181,181,181,181,-204,181,181,181,181,-11,181,-209,-208,-206,-80,181,-309,181,181,181,-210,-207,181,-212,-211,]),'TIMESEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,274,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'OR':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,315,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,315,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,315,-250,-252,-253,-241,-264,-272,-273,-258,-288,-281,-282,]),'SHORT':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[2,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,2,-96,-111,-106,-65,-95,-112,2,-221,-109,-113,2,-63,-118,2,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,2,-53,2,-84,2,2,-61,-133,-307,-132,2,-153,-152,-166,-90,-92,2,-89,-91,-94,-83,-86,-88,-69,-30,2,2,-70,2,-85,2,2,2,-135,-130,-145,-146,-142,-308,2,2,-167,2,2,-36,-35,2,2,-73,-76,-72,-74,2,-78,-199,-198,-77,-200,-75,2,-139,2,-137,-134,-143,-131,-128,-129,-154,-71,2,-31,2,2,2,-34,2,2,2,-218,-217,2,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,2,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'RETURN':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,207,-308,-73,-76,-72,-74,207,-78,-199,-198,-77,-200,207,-75,-218,-217,-215,207,-201,-214,207,-80,-202,207,-213,-216,-205,207,-79,-203,207,-204,207,207,-209,-208,-206,-80,207,207,-210,-207,207,-212,-211,]),'RSHIFTEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,275,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'RESTRICT':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,31,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,59,60,61,63,64,67,68,69,70,71,72,73,74,76,78,80,83,87,91,92,96,101,104,105,107,108,113,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,144,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,254,255,258,277,286,287,288,291,293,296,326,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,423,424,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[35,35,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,35,-96,-111,-106,-65,-95,-112,35,-221,-109,35,-113,35,-63,-118,-29,-107,-62,-103,-67,-114,-108,35,-110,35,-105,-119,-68,-100,35,35,-53,35,-84,35,-61,-133,-307,-132,35,-153,-152,35,-166,-90,-92,35,-89,-91,-94,-83,-69,-30,35,35,35,-70,35,-85,35,35,35,-135,-130,-145,-146,-142,-308,35,35,-167,35,35,35,-36,-35,35,35,-73,-76,-72,-74,35,-78,-199,-198,-77,-200,-75,35,-139,35,-137,-134,-143,-131,-128,-129,-154,35,35,-71,35,-31,35,35,35,-34,35,35,35,35,-218,-217,35,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,35,-33,-32,35,35,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'STATIC':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,59,60,61,63,64,67,68,69,70,71,73,74,78,80,83,87,91,92,96,101,104,105,107,113,120,121,122,126,131,139,144,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,254,258,286,293,326,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,423,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[9,9,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,9,-96,-111,-106,-65,-95,-112,9,-221,-109,-113,9,-63,-118,-29,-107,-62,-103,-67,-114,-108,9,-110,9,-105,-119,-68,-100,108,9,-53,9,-84,9,-61,-133,-307,-132,-153,-152,-166,-90,-92,9,-89,-91,-94,-83,-69,-30,185,9,-70,9,-85,-135,-308,-167,255,9,-36,-35,9,9,-73,-76,-72,-74,9,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,368,-71,-31,-34,424,9,9,-218,-217,9,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,9,-33,-32,470,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'SIZEOF':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,159,-28,-309,159,-308,-167,-309,159,159,-270,159,-268,159,-267,159,-266,159,159,-265,-269,159,159,159,-73,-76,-72,159,-74,159,159,-78,-199,-198,-77,-200,159,-75,-266,159,159,159,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,159,-233,-234,-226,-232,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,159,-309,-266,159,-218,-217,159,-215,159,159,159,-201,159,-214,159,-80,-202,159,159,159,-266,159,159,-12,159,159,-11,159,159,-28,-309,-266,-213,-216,159,-205,159,-79,-203,-309,-182,159,159,-309,159,-266,159,159,159,159,-204,159,159,159,159,-11,159,-209,-208,-206,-80,159,-309,159,159,159,-210,-207,159,-212,-211,]),'UNSIGNED':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[20,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,20,-96,-111,-106,-65,-95,-112,20,-221,-109,-113,20,-63,-118,20,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,20,-53,20,-84,20,20,-61,-133,-307,-132,20,-153,-152,-166,-90,-92,20,-89,-91,-94,-83,-86,-88,-69,-30,20,20,-70,20,-85,20,20,20,-135,-130,-145,-146,-142,-308,20,20,-167,20,20,-36,-35,20,20,-73,-76,-72,-74,20,-78,-199,-198,-77,-200,-75,20,-139,20,-137,-134,-143,-131,-128,-129,-154,-71,20,-31,20,20,20,-34,20,20,20,-218,-217,20,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,20,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'UNION':([0,1,3,7,8,9,11,12,14,17,18,19,23,24,26,34,35,36,37,40,42,47,49,51,53,54,55,56,57,60,61,64,65,67,68,70,72,78,87,101,102,103,104,105,117,120,121,122,123,124,125,128,129,130,131,132,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,233,236,258,277,286,287,288,291,293,327,331,336,337,339,340,346,349,351,352,353,360,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[22,-309,-117,-99,-52,-97,-98,-64,-60,-66,22,-96,-65,-95,22,-63,-118,22,-29,-62,-67,-309,-309,-119,-68,-100,-87,-10,-9,22,-53,-84,22,22,-61,-307,22,-166,22,-83,-86,-88,-69,-30,22,-70,22,-85,22,22,22,-145,-146,-142,-308,22,-167,22,22,-36,-35,22,22,-73,-76,-72,-74,22,-78,-199,-198,-77,-200,-75,22,22,-143,-71,22,-31,22,22,22,-34,22,22,-218,-217,22,-215,-201,-214,-78,-80,-202,-144,22,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'COLON':([2,3,5,6,8,10,15,20,21,25,29,30,32,35,37,39,41,44,45,48,50,51,61,69,71,73,74,85,86,88,105,115,119,126,127,131,133,143,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,183,187,188,212,227,229,232,234,235,237,238,244,245,249,251,276,278,279,280,282,286,289,290,292,293,297,344,345,356,357,359,362,363,370,371,381,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,419,436,447,448,458,459,460,465,484,485,494,507,511,520,],[-104,-117,-115,-101,-52,-116,-102,-111,-106,-112,-221,-109,-113,-118,-29,-107,-103,-114,-108,-110,-105,-119,-53,-133,-132,-153,-152,-54,-163,-37,-30,-294,-162,-135,-130,-308,239,-55,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,-236,-300,-296,-222,-36,-35,342,-219,354,-139,-137,-134,-131,-128,-129,361,-154,-38,-306,-263,-304,-280,-279,-31,-257,-262,-260,-34,-261,439,-235,-138,-136,239,-156,-155,-44,-43,-223,-278,-277,-276,-275,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,467,-253,-241,-33,-32,-220,-39,-42,-264,-272,-273,-258,-41,-40,-237,-288,-281,-282,]),'$end':([0,12,14,17,23,26,34,40,42,43,52,53,68,101,104,120,131,258,353,],[-309,-64,-60,-66,-65,-58,-63,-62,-67,0,-59,-68,-61,-83,-69,-70,-308,-71,-202,]),'WSTRING_LITERAL':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,153,155,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,155,-28,-309,155,-308,-167,-309,155,155,-270,276,-305,155,-268,155,-267,155,-266,155,155,-265,-269,155,155,155,-73,-76,-72,155,-74,155,155,-78,-199,-198,-77,-200,155,-75,-266,155,155,155,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,155,-233,-234,-226,-232,-306,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,155,-309,-266,155,-218,-217,155,-215,155,155,155,-201,155,-214,155,-80,-202,155,155,155,-266,155,155,-12,155,155,-11,155,155,-28,-309,-266,-213,-216,155,-205,155,-79,-203,-309,-182,155,155,-309,155,-266,155,155,155,155,-204,155,155,155,155,-11,155,-209,-208,-206,-80,155,-309,155,155,155,-210,-207,155,-212,-211,]),'DIVIDE':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,308,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,308,308,308,308,308,308,308,308,308,308,-240,-239,308,308,308,308,308,-241,-264,-272,-273,-258,-288,-281,-282,]),'FOR':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,209,-308,-73,-76,-72,-74,209,-78,-199,-198,-77,-200,209,-75,-218,-217,-215,209,-201,-214,209,-80,-202,209,-213,-216,-205,209,-79,-203,209,-204,209,209,-209,-208,-206,-80,209,209,-210,-207,209,-212,-211,]),'PLUSPLUS':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,115,121,131,139,144,147,148,150,151,153,154,155,156,157,158,159,160,161,162,166,167,169,170,171,172,173,174,175,176,177,178,180,181,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,279,280,282,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,383,384,385,386,389,394,395,422,423,424,430,432,433,435,437,439,442,443,454,457,459,460,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,169,-28,-309,-294,169,-308,-167,-309,169,169,-298,-270,-286,-301,-305,-302,-299,-284,169,-268,-285,282,169,-267,169,-297,-266,-271,169,169,-303,-265,-295,-283,-300,-296,-269,169,169,169,-73,-76,-72,169,-74,169,169,-78,-199,-198,-77,-200,169,-75,-266,-294,169,169,169,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,169,-233,-234,-226,-232,-306,169,-304,-280,-279,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,169,-309,-266,169,-218,-217,169,-215,169,169,169,-201,169,-214,169,-80,-202,169,169,169,-266,169,169,-12,169,169,-11,-278,-277,-276,-275,-274,-287,169,169,-28,-309,-266,-213,-216,169,-205,169,-79,-203,-309,-182,-272,-273,169,169,-309,169,-266,169,169,169,169,-204,169,169,169,169,-11,169,-209,-208,-206,-80,-288,169,-309,-281,169,169,-282,169,-210,-207,169,-212,-211,]),'EQUALS':([8,37,61,85,86,87,88,89,97,105,115,119,131,138,143,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,187,188,229,251,276,278,279,280,282,286,289,290,292,293,297,370,371,374,379,383,384,385,386,389,394,418,419,447,448,452,456,458,459,460,465,484,485,486,507,511,520,],[-52,-29,-53,-54,-163,-162,-37,147,148,-30,-294,-162,-308,250,-55,-298,267,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-36,-35,-294,-38,-306,-263,-304,-280,-279,-31,-257,-262,-260,-34,-261,-44,-43,-183,457,-278,-277,-276,-275,-274,-287,-33,-32,-39,-42,-186,-184,-264,-272,-273,-258,-41,-40,-185,-288,-281,-282,]),'ELSE':([53,104,131,202,203,206,208,217,220,225,336,337,340,349,351,352,353,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[-68,-69,-308,-73,-76,-72,-74,-78,-77,-75,-218,-217,-215,-214,-78,-80,-202,-213,-216,-205,-79,-203,-204,-209,-208,-206,517,-210,-207,-212,-211,]),'ANDEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,272,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'EQ':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,312,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,312,-245,-243,-247,-251,-246,-242,-249,312,-240,-239,-248,312,-250,312,312,-241,-264,-272,-273,-258,-288,-281,-282,]),'AND':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,115,121,131,139,144,147,148,150,151,152,153,154,155,156,157,158,159,160,161,162,164,166,167,169,170,171,172,173,174,175,176,177,178,179,180,181,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,282,284,285,288,289,290,291,292,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,383,384,385,386,389,394,395,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,422,423,424,430,432,433,435,437,439,442,443,454,457,458,459,460,461,463,465,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,176,-28,-309,-294,176,-308,-167,-309,176,176,-298,-270,-257,-286,-301,-305,-302,-299,-284,176,-268,-285,-259,-238,176,-267,176,-297,-266,-271,176,176,-303,-265,-295,-283,313,-300,-296,-269,176,176,176,-73,-76,-72,176,-74,176,176,-78,-199,-198,-77,-200,176,-75,-266,-294,176,176,176,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,176,-233,-234,-226,-232,-306,176,-263,-304,-280,-279,176,176,176,-257,-262,176,-260,-261,176,176,176,176,176,176,176,176,176,176,176,176,176,176,176,176,176,176,176,-309,-266,176,-218,-217,176,-215,176,176,176,-201,176,-214,176,-80,-202,176,176,176,-266,176,176,-12,176,176,-11,-278,-277,-276,-275,-274,-287,176,-244,313,-245,-243,-247,-251,-246,-242,-249,313,-240,-239,-248,313,-250,-252,313,-241,176,-28,-309,-266,-213,-216,176,-205,176,-79,-203,-309,-182,-264,-272,-273,176,176,-258,-309,176,-266,176,176,176,176,-204,176,176,176,176,-11,176,-209,-208,-206,-80,-288,176,-309,-281,176,176,-282,176,-210,-207,176,-212,-211,]),'TYPEID':([0,1,2,3,5,6,7,8,9,10,11,12,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,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,76,77,78,79,80,81,83,84,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,140,142,145,149,173,187,188,189,192,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,281,283,286,287,288,291,293,327,331,336,337,339,340,346,349,351,352,353,356,357,359,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[29,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,29,-96,-111,-106,-141,-65,-95,-112,29,69,73,-221,-109,-309,-113,88,-63,-118,29,-29,-140,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,29,-53,88,-84,29,29,-61,-133,-307,-132,29,-153,-152,-28,-164,-166,-27,-90,88,-92,88,29,-89,-91,-94,-83,-86,-88,-69,-30,196,29,-70,29,-85,29,29,29,-135,-130,-145,-146,-142,-308,29,88,-167,-165,88,29,88,29,-36,-35,29,196,29,-73,-76,-72,-74,29,-78,-199,-198,-77,-200,-75,29,-139,29,-137,-134,-143,-131,-128,-129,-154,-71,29,383,385,-31,29,29,29,-34,29,29,-218,-217,29,-215,-201,-214,-78,-80,-202,-138,-136,88,-144,-156,-155,29,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'LBRACE':([8,18,22,27,28,37,38,53,61,62,64,66,67,69,70,71,73,74,87,101,104,105,121,122,131,146,147,148,187,188,202,203,206,208,215,217,218,219,220,222,224,225,260,286,293,336,337,340,342,346,349,351,352,353,354,372,378,380,395,418,419,432,433,437,439,442,443,454,457,458,463,464,466,479,480,481,483,487,488,501,502,504,505,510,517,522,523,524,526,527,528,],[-52,-309,-141,70,70,-29,-140,-68,-53,-7,-84,70,-8,70,-307,70,70,70,-309,-83,-69,-30,70,-85,-308,70,70,70,-36,-35,-73,-76,-72,-74,70,-78,-199,-198,-77,-200,70,-75,-309,-31,-34,-218,-217,-215,70,-201,-214,70,-80,-202,70,-12,70,-11,70,-33,-32,-213,-216,-205,70,-79,-203,-309,-182,70,70,70,-309,70,-204,70,70,70,-11,-209,-208,-206,-80,-309,70,70,-210,-207,70,-212,-211,]),'PPHASH':([0,12,14,17,23,26,34,40,42,53,68,101,104,120,131,258,353,],[42,-64,-60,-66,-65,42,-63,-62,-67,-68,-61,-83,-69,-70,-308,-71,-202,]),'INT':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[50,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,50,-96,-111,-106,-65,-95,-112,50,-221,-109,-113,50,-63,-118,50,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,50,-53,50,-84,50,50,-61,-133,-307,-132,50,-153,-152,-166,-90,-92,50,-89,-91,-94,-83,-86,-88,-69,-30,50,50,-70,50,-85,50,50,50,-135,-130,-145,-146,-142,-308,50,50,-167,50,50,-36,-35,50,50,-73,-76,-72,-74,50,-78,-199,-198,-77,-200,-75,50,-139,50,-137,-134,-143,-131,-128,-129,-154,-71,50,-31,50,50,50,-34,50,50,50,-218,-217,50,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,50,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'SIGNED':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[48,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,48,-96,-111,-106,-65,-95,-112,48,-221,-109,-113,48,-63,-118,48,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,48,-53,48,-84,48,48,-61,-133,-307,-132,48,-153,-152,-166,-90,-92,48,-89,-91,-94,-83,-86,-88,-69,-30,48,48,-70,48,-85,48,48,48,-135,-130,-145,-146,-142,-308,48,48,-167,48,48,-36,-35,48,48,-73,-76,-72,-74,48,-78,-199,-198,-77,-200,-75,48,-139,48,-137,-134,-143,-131,-128,-129,-154,-71,48,-31,48,48,48,-34,48,48,48,-218,-217,48,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,48,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'CONTINUE':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,210,-308,-73,-76,-72,-74,210,-78,-199,-198,-77,-200,210,-75,-218,-217,-215,210,-201,-214,210,-80,-202,210,-213,-216,-205,210,-79,-203,210,-204,210,210,-209,-208,-206,-80,210,210,-210,-207,210,-212,-211,]),'NOT':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,184,-28,-309,184,-308,-167,-309,184,184,-270,184,-268,184,-267,184,-266,184,184,-265,-269,184,184,184,-73,-76,-72,184,-74,184,184,-78,-199,-198,-77,-200,184,-75,-266,184,184,184,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,184,-233,-234,-226,-232,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,184,-309,-266,184,-218,-217,184,-215,184,184,184,-201,184,-214,184,-80,-202,184,184,184,-266,184,184,-12,184,184,-11,184,184,-28,-309,-266,-213,-216,184,-205,184,-79,-203,-309,-182,184,184,-309,184,-266,184,184,184,184,-204,184,184,184,184,-11,184,-209,-208,-206,-80,184,-309,184,184,184,-210,-207,184,-212,-211,]),'OREQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,273,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'MOD':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,316,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,316,316,316,316,316,316,316,316,316,316,-240,-239,316,316,316,316,316,-241,-264,-272,-273,-258,-288,-281,-282,]),'RSHIFT':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,298,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,298,-245,-243,298,298,298,-242,298,298,-240,-239,298,298,298,298,298,-241,-264,-272,-273,-258,-288,-281,-282,]),'DEFAULT':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,212,-308,-73,-76,-72,-74,212,-78,-199,-198,-77,-200,212,-75,-218,-217,-215,212,-201,-214,212,-80,-202,212,-213,-216,-205,212,-79,-203,212,-204,212,212,-209,-208,-206,-80,212,212,-210,-207,212,-212,-211,]),'__INT128':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[25,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,25,-96,-111,-106,-65,-95,-112,25,-221,-109,-113,25,-63,-118,25,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,25,-53,25,-84,25,25,-61,-133,-307,-132,25,-153,-152,-166,-90,-92,25,-89,-91,-94,-83,-86,-88,-69,-30,25,25,-70,25,-85,25,25,25,-135,-130,-145,-146,-142,-308,25,25,-167,25,25,-36,-35,25,25,-73,-76,-72,-74,25,-78,-199,-198,-77,-200,-75,25,-139,25,-137,-134,-143,-131,-128,-129,-154,-71,25,-31,25,25,25,-34,25,25,25,-218,-217,25,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,25,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'WHILE':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,350,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,213,-308,-73,-76,-72,-74,213,-78,-199,-198,-77,-200,213,-75,-218,-217,-215,213,-201,-214,441,213,-80,-202,213,-213,-216,-205,213,-79,-203,213,-204,213,213,-209,-208,-206,-80,213,213,-210,-207,213,-212,-211,]),'DIVEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,264,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'EXTERN':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,60,61,63,64,67,68,69,70,71,73,74,80,83,87,91,92,96,101,104,105,113,120,121,122,126,131,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,258,286,293,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[11,11,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,11,-96,-111,-106,-65,-95,-112,11,-221,-109,-113,11,-63,-118,-29,-107,-62,-103,-67,-114,-108,11,-110,11,-105,-119,-68,-100,11,-53,11,-84,11,-61,-133,-307,-132,-153,-152,-90,-92,11,-89,-91,-94,-83,-69,-30,11,-70,11,-85,-135,-308,11,-36,-35,11,11,-73,-76,-72,-74,11,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,-71,-31,-34,11,11,-218,-217,11,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,11,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'CASE':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,214,-308,-73,-76,-72,-74,214,-78,-199,-198,-77,-200,214,-75,-218,-217,-215,214,-201,-214,214,-80,-202,214,-213,-216,-205,214,-79,-203,214,-204,214,214,-209,-208,-206,-80,214,214,-210,-207,214,-212,-211,]),'LAND':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,311,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,311,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-264,-272,-273,-258,-288,-281,-282,]),'REGISTER':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,60,61,63,64,67,68,69,70,71,73,74,80,83,87,91,92,96,101,104,105,113,120,121,122,126,131,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,258,286,293,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[19,19,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,19,-96,-111,-106,-65,-95,-112,19,-221,-109,-113,19,-63,-118,-29,-107,-62,-103,-67,-114,-108,19,-110,19,-105,-119,-68,-100,19,-53,19,-84,19,-61,-133,-307,-132,-153,-152,-90,-92,19,-89,-91,-94,-83,-69,-30,19,-70,19,-85,-135,-308,19,-36,-35,19,19,-73,-76,-72,-74,19,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,-71,-31,-34,19,19,-218,-217,19,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,19,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'MODEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,266,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'NE':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,303,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,303,-245,-243,-247,-251,-246,-242,-249,303,-240,-239,-248,303,-250,303,303,-241,-264,-272,-273,-258,-288,-281,-282,]),'SWITCH':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,216,-308,-73,-76,-72,-74,216,-78,-199,-198,-77,-200,216,-75,-218,-217,-215,216,-201,-214,216,-80,-202,216,-213,-216,-205,216,-79,-203,216,-204,216,216,-209,-208,-206,-80,216,216,-210,-207,216,-212,-211,]),'INT_CONST_HEX':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,170,-28,-309,170,-308,-167,-309,170,170,-270,170,-268,170,-267,170,-266,170,170,-265,-269,170,170,170,-73,-76,-72,170,-74,170,170,-78,-199,-198,-77,-200,170,-75,-266,170,170,170,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,170,-233,-234,-226,-232,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,170,-309,-266,170,-218,-217,170,-215,170,170,170,-201,170,-214,170,-80,-202,170,170,170,-266,170,170,-12,170,170,-11,170,170,-28,-309,-266,-213,-216,170,-205,170,-79,-203,-309,-182,170,170,-309,170,-266,170,170,170,170,-204,170,170,170,170,-11,170,-209,-208,-206,-80,170,-309,170,170,170,-210,-207,170,-212,-211,]),'_COMPLEX':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[30,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,30,-96,-111,-106,-65,-95,-112,30,-221,-109,-113,30,-63,-118,30,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,30,-53,30,-84,30,30,-61,-133,-307,-132,30,-153,-152,-166,-90,-92,30,-89,-91,-94,-83,-86,-88,-69,-30,30,30,-70,30,-85,30,30,30,-135,-130,-145,-146,-142,-308,30,30,-167,30,30,-36,-35,30,30,-73,-76,-72,-74,30,-78,-199,-198,-77,-200,-75,30,-139,30,-137,-134,-143,-131,-128,-129,-154,-71,30,-31,30,30,30,-34,30,30,30,-218,-217,30,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,30,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'PPPRAGMASTR':([53,],[104,]),'PLUSEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,269,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'STRUCT':([0,1,3,7,8,9,11,12,14,17,18,19,23,24,26,34,35,36,37,40,42,47,49,51,53,54,55,56,57,60,61,64,65,67,68,70,72,78,87,101,102,103,104,105,117,120,121,122,123,124,125,128,129,130,131,132,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,233,236,258,277,286,287,288,291,293,327,331,336,337,339,340,346,349,351,352,353,360,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[38,-309,-117,-99,-52,-97,-98,-64,-60,-66,38,-96,-65,-95,38,-63,-118,38,-29,-62,-67,-309,-309,-119,-68,-100,-87,-10,-9,38,-53,-84,38,38,-61,-307,38,-166,38,-83,-86,-88,-69,-30,38,-70,38,-85,38,38,38,-145,-146,-142,-308,38,-167,38,38,-36,-35,38,38,-73,-76,-72,-74,38,-78,-199,-198,-77,-200,-75,38,38,-143,-71,38,-31,38,38,38,-34,38,38,-218,-217,38,-215,-201,-214,-78,-80,-202,-144,38,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'CONDOP':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,314,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-264,-272,-273,-258,-288,-281,-282,]),'BREAK':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,221,-308,-73,-76,-72,-74,221,-78,-199,-198,-77,-200,221,-75,-218,-217,-215,221,-201,-214,221,-80,-202,221,-213,-216,-205,221,-79,-203,221,-204,221,221,-209,-208,-206,-80,221,221,-210,-207,221,-212,-211,]),'VOLATILE':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,31,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,59,60,61,63,64,67,68,69,70,71,72,73,74,76,78,80,83,87,91,92,96,101,104,105,107,108,113,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,144,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,254,255,258,277,286,287,288,291,293,296,326,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,423,424,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[51,51,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,51,-96,-111,-106,-65,-95,-112,51,-221,-109,51,-113,51,-63,-118,-29,-107,-62,-103,-67,-114,-108,51,-110,51,-105,-119,-68,-100,51,51,-53,51,-84,51,-61,-133,-307,-132,51,-153,-152,51,-166,-90,-92,51,-89,-91,-94,-83,-69,-30,51,51,51,-70,51,-85,51,51,51,-135,-130,-145,-146,-142,-308,51,51,-167,51,51,51,-36,-35,51,51,-73,-76,-72,-74,51,-78,-199,-198,-77,-200,-75,51,-139,51,-137,-134,-143,-131,-128,-129,-154,51,51,-71,51,-31,51,51,51,-34,51,51,51,51,-218,-217,51,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,51,-33,-32,51,51,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'PPPRAGMA':([0,12,14,17,23,26,34,40,42,53,68,70,72,101,104,120,121,123,124,125,128,129,130,131,202,203,206,208,215,217,218,219,220,222,224,225,231,233,236,258,336,337,340,342,346,349,351,352,353,354,360,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[53,-64,-60,-66,-65,53,-63,-62,-67,-68,-61,-307,53,-83,-69,-70,53,53,53,53,-145,-146,-142,-308,-73,-76,-72,-74,53,-78,-199,-198,-77,-200,53,-75,53,53,-143,-71,-218,-217,-215,53,-201,-214,53,-80,-202,53,-144,-213,-216,-205,53,-79,-203,53,-204,53,53,-209,-208,-206,-80,53,53,-210,-207,53,-212,-211,]),'INLINE':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,60,61,63,64,67,68,69,70,71,73,74,80,83,87,91,92,96,101,104,105,113,120,121,122,126,131,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,258,286,293,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[54,54,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,54,-96,-111,-106,-65,-95,-112,54,-221,-109,-113,54,-63,-118,-29,-107,-62,-103,-67,-114,-108,54,-110,54,-105,-119,-68,-100,54,-53,54,-84,54,-61,-133,-307,-132,-153,-152,-90,-92,54,-89,-91,-94,-83,-69,-30,54,-70,54,-85,-135,-308,54,-36,-35,54,54,-73,-76,-72,-74,54,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,-71,-31,-34,54,54,-218,-217,54,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,54,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'INT_CONST_BIN':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,150,-28,-309,150,-308,-167,-309,150,150,-270,150,-268,150,-267,150,-266,150,150,-265,-269,150,150,150,-73,-76,-72,150,-74,150,150,-78,-199,-198,-77,-200,150,-75,-266,150,150,150,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,150,-233,-234,-226,-232,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,150,-309,-266,150,-218,-217,150,-215,150,150,150,-201,150,-214,150,-80,-202,150,150,150,-266,150,150,-12,150,150,-11,150,150,-28,-309,-266,-213,-216,150,-205,150,-79,-203,-309,-182,150,150,-309,150,-266,150,150,150,150,-204,150,150,150,150,-11,150,-209,-208,-206,-80,150,-309,150,150,150,-210,-207,150,-212,-211,]),'DO':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,224,-308,-73,-76,-72,-74,224,-78,-199,-198,-77,-200,224,-75,-218,-217,-215,224,-201,-214,224,-80,-202,224,-213,-216,-205,224,-79,-203,224,-204,224,224,-209,-208,-206,-80,224,224,-210,-207,224,-212,-211,]),'LNOT':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,151,-28,-309,151,-308,-167,-309,151,151,-270,151,-268,151,-267,151,-266,151,151,-265,-269,151,151,151,-73,-76,-72,151,-74,151,151,-78,-199,-198,-77,-200,151,-75,-266,151,151,151,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,151,-233,-234,-226,-232,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,151,-309,-266,151,-218,-217,151,-215,151,151,151,-201,151,-214,151,-80,-202,151,151,151,-266,151,151,-12,151,151,-11,151,151,-28,-309,-266,-213,-216,151,-205,151,-79,-203,-309,-182,151,151,-309,151,-266,151,151,151,151,-204,151,151,151,151,-11,151,-209,-208,-206,-80,151,-309,151,151,151,-210,-207,151,-212,-211,]),'CONST':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,31,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,59,60,61,63,64,67,68,69,70,71,72,73,74,76,78,80,83,87,91,92,96,101,104,105,107,108,113,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,144,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,254,255,258,277,286,287,288,291,293,296,326,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,423,424,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[3,3,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,3,-96,-111,-106,-65,-95,-112,3,-221,-109,3,-113,3,-63,-118,-29,-107,-62,-103,-67,-114,-108,3,-110,3,-105,-119,-68,-100,3,3,-53,3,-84,3,-61,-133,-307,-132,3,-153,-152,3,-166,-90,-92,3,-89,-91,-94,-83,-69,-30,3,3,3,-70,3,-85,3,3,3,-135,-130,-145,-146,-142,-308,3,3,-167,3,3,3,-36,-35,3,3,-73,-76,-72,-74,3,-78,-199,-198,-77,-200,-75,3,-139,3,-137,-134,-143,-131,-128,-129,-154,3,3,-71,3,-31,3,3,3,-34,3,3,3,3,-218,-217,3,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,3,-33,-32,3,3,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'LOR':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,299,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-264,-272,-273,-258,-288,-281,-282,]),'CHAR_CONST':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,154,-28,-309,154,-308,-167,-309,154,154,-270,154,-268,154,-267,154,-266,154,154,-265,-269,154,154,154,-73,-76,-72,154,-74,154,154,-78,-199,-198,-77,-200,154,-75,-266,154,154,154,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,154,-233,-234,-226,-232,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,154,-309,-266,154,-218,-217,154,-215,154,154,154,-201,154,-214,154,-80,-202,154,154,154,-266,154,154,-12,154,154,-11,154,154,-28,-309,-266,-213,-216,154,-205,154,-79,-203,-309,-182,154,154,-309,154,-266,154,154,154,154,-204,154,154,154,154,-11,154,-209,-208,-206,-80,154,-309,154,154,154,-210,-207,154,-212,-211,]),'LSHIFT':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,300,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,300,-245,-243,300,300,300,-242,300,300,-240,-239,300,300,300,300,300,-241,-264,-272,-273,-258,-288,-281,-282,]),'RBRACE':([53,70,72,101,104,115,121,123,124,125,128,129,130,131,136,137,138,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,183,202,203,206,208,215,217,218,219,220,222,223,225,226,231,233,236,246,247,248,260,261,276,278,279,280,282,289,290,292,297,336,337,340,345,346,349,351,352,353,360,364,365,373,377,380,381,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,432,433,437,442,443,451,454,455,458,459,460,465,480,489,493,494,501,502,504,505,506,507,510,511,520,523,524,527,528,],[-68,-307,131,-83,-69,-294,-309,131,131,131,-145,-146,-142,-308,-157,131,-160,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,-236,-300,-296,-222,-73,-76,-72,-74,-6,-78,-199,-198,-77,-200,-5,-75,131,131,131,-143,131,131,-158,-309,-177,-306,-263,-304,-280,-279,-257,-262,-260,-261,-218,-217,-215,-235,-201,-214,-78,-80,-202,-144,-159,-161,131,-22,-21,-223,-278,-277,-276,-275,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-213,-216,-205,-79,-203,-178,131,-180,-264,-272,-273,-258,-204,-179,131,-237,-209,-208,-206,-80,-181,-288,131,-281,-282,-210,-207,-212,-211,]),'_BOOL':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[15,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,15,-96,-111,-106,-65,-95,-112,15,-221,-109,-113,15,-63,-118,15,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,15,-53,15,-84,15,15,-61,-133,-307,-132,15,-153,-152,-166,-90,-92,15,-89,-91,-94,-83,-86,-88,-69,-30,15,15,-70,15,-85,15,15,15,-135,-130,-145,-146,-142,-308,15,15,-167,15,15,-36,-35,15,15,-73,-76,-72,-74,15,-78,-199,-198,-77,-200,-75,15,-139,15,-137,-134,-143,-131,-128,-129,-154,-71,15,-31,15,15,15,-34,15,15,15,-218,-217,15,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,15,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'LE':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,302,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,302,-245,-243,-247,302,-246,-242,-249,302,-240,-239,-248,302,302,302,302,-241,-264,-272,-273,-258,-288,-281,-282,]),'SEMI':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,46,47,48,49,50,51,53,54,55,56,57,61,63,65,68,69,70,71,72,73,74,80,82,83,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,115,119,120,121,123,124,125,126,127,128,129,130,131,133,143,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,183,187,188,202,203,205,206,207,208,210,211,215,217,218,219,220,221,222,223,224,225,227,229,231,232,233,234,235,236,237,238,240,241,242,243,244,245,249,251,252,258,259,261,262,263,276,278,279,280,282,286,289,290,292,293,297,335,336,337,338,339,340,342,345,346,347,349,351,352,353,354,356,357,358,360,362,363,370,371,381,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,418,419,432,433,434,435,436,437,439,442,443,445,446,447,448,451,458,459,460,465,477,478,479,480,481,483,484,485,489,494,499,501,502,504,505,507,511,516,517,520,522,523,524,526,527,528,],[17,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,-96,-111,-106,-65,-95,-112,17,-221,-109,-113,-309,-63,-118,-309,-29,-107,-62,-103,-67,-114,-108,101,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,-53,-309,-309,-61,-133,-307,-132,128,-153,-152,-90,-20,-92,-54,-163,-162,-37,-122,-81,-89,-91,-19,-120,-124,-94,-126,-16,-82,-15,-83,-86,-88,-69,-30,-294,-162,-70,-309,128,128,128,-135,-130,-145,-146,-142,-308,-309,-55,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,-236,-300,-296,-222,-36,-35,-73,-76,336,-72,337,-74,340,-14,-309,-78,-199,-198,-77,349,-200,-13,-309,-75,-219,-294,128,-139,128,-137,-134,-143,-131,-128,-26,-25,360,-147,-129,-149,-154,-38,-121,-71,-123,-177,-127,-125,-306,-263,-304,-280,-279,-31,-257,-262,-260,-34,-261,432,-218,-217,433,-309,-215,-309,-235,-201,-13,-214,-78,-80,-202,-309,-138,-136,-151,-144,-156,-155,-44,-43,-223,-278,-277,-276,-275,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-33,-32,-213,-216,477,-309,-220,-205,-309,-79,-203,-148,-150,-39,-42,-178,-264,-272,-273,-258,-309,500,-309,-204,-309,-309,-41,-40,-179,-237,514,-209,-208,-206,-80,-288,-281,523,-309,-282,-309,-210,-207,-309,-212,-211,]),'LT':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,304,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,304,-245,-243,-247,304,-246,-242,-249,304,-240,-239,-248,304,304,304,304,-241,-264,-272,-273,-258,-288,-281,-282,]),'COMMA':([2,3,5,6,7,8,9,10,11,15,16,19,20,21,24,25,29,30,31,32,35,37,39,41,44,45,48,50,51,54,61,69,71,73,74,76,77,78,79,80,82,83,85,86,87,88,89,91,92,94,95,96,97,98,105,112,113,114,115,116,118,119,126,127,131,136,137,138,139,140,143,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,183,187,188,190,191,192,193,194,195,196,197,199,211,227,229,232,234,235,237,238,240,243,244,245,246,247,248,249,251,252,259,261,262,263,276,278,279,280,282,286,289,290,292,293,294,296,297,324,325,332,334,338,345,356,357,358,362,363,364,365,370,371,377,381,383,384,385,386,387,388,389,390,391,394,396,397,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,415,416,417,418,419,420,421,427,428,436,438,440,444,445,446,447,448,451,455,458,459,460,465,472,473,474,475,476,484,485,489,490,493,494,495,496,503,506,507,511,512,513,519,520,],[-104,-117,-115,-101,-99,-52,-97,-116,-98,-102,-93,-96,-111,-106,-95,-112,-221,-109,-309,-113,-118,-29,-107,-103,-114,-108,-110,-105,-119,-100,-53,-133,-132,-153,-152,-28,-164,-166,-27,-90,142,-92,-54,-163,-162,-37,-122,-89,-91,-120,-124,-94,-126,149,-30,-170,-309,200,-294,201,-175,-162,-135,-130,-308,-157,248,-160,-167,-165,-55,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,-236,-300,-296,-222,-36,-35,-174,-2,-188,-56,-172,-1,-45,-173,-190,341,-219,-294,-139,-137,-134,-131,-128,359,-147,-129,-149,248,248,-158,-154,-38,-121,-123,-177,-127,-125,-306,-263,-304,-280,-279,-31,-257,-262,-260,-34,341,-309,-261,-57,-189,-176,-171,341,-235,-138,-136,-151,-156,-155,-159,-161,-44,-43,454,-223,-278,-277,-276,-275,341,-292,-274,461,462,-287,-187,-188,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,341,-253,-241,-33,-32,-197,-191,-193,-195,-220,341,341,341,-148,-150,-39,-42,-178,-180,-264,-272,-273,-258,-51,-50,-192,-194,-196,-41,-40,-179,-293,510,-237,-46,-49,341,-181,-288,-281,-48,-47,341,-282,]),'OFFSETOF':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,166,167,169,171,173,174,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,165,-28,-309,165,-308,-167,-309,165,165,-270,165,-268,165,-267,165,-266,165,165,-265,-269,165,165,165,-73,-76,-72,165,-74,165,165,-78,-199,-198,-77,-200,165,-75,-266,165,165,165,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,165,-233,-234,-226,-232,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,165,-309,-266,165,-218,-217,165,-215,165,165,165,-201,165,-214,165,-80,-202,165,165,165,-266,165,165,-12,165,165,-11,165,165,-28,-309,-266,-213,-216,165,-205,165,-79,-203,-309,-182,165,165,-309,165,-266,165,165,165,165,-204,165,165,165,165,-11,165,-209,-208,-206,-80,165,-309,165,165,165,-210,-207,165,-212,-211,]),'TYPEDEF':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,60,61,63,64,67,68,69,70,71,73,74,80,83,87,91,92,96,101,104,105,113,120,121,122,126,131,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,258,286,293,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[7,7,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,7,-96,-111,-106,-65,-95,-112,7,-221,-109,-113,7,-63,-118,-29,-107,-62,-103,-67,-114,-108,7,-110,7,-105,-119,-68,-100,7,-53,7,-84,7,-61,-133,-307,-132,-153,-152,-90,-92,7,-89,-91,-94,-83,-69,-30,7,-70,7,-85,-135,-308,7,-36,-35,7,7,-73,-76,-72,-74,7,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,-71,-31,-34,7,7,-218,-217,7,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,7,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'XOR':([115,131,150,152,153,154,155,156,157,158,161,162,164,170,172,175,177,178,179,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,458,459,460,465,507,511,520,],[-294,-308,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,-238,-297,-271,-303,-295,-283,307,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-244,307,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,307,-250,-252,307,-241,-264,-272,-273,-258,-288,-281,-282,]),'AUTO':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,37,39,40,41,42,44,45,47,48,49,50,51,53,54,60,61,63,64,67,68,69,70,71,73,74,80,83,87,91,92,96,101,104,105,113,120,121,122,126,131,145,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,232,234,235,249,258,286,293,327,331,336,337,339,340,346,349,351,352,353,356,357,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[24,24,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,24,-96,-111,-106,-65,-95,-112,24,-221,-109,-113,24,-63,-118,-29,-107,-62,-103,-67,-114,-108,24,-110,24,-105,-119,-68,-100,24,-53,24,-84,24,-61,-133,-307,-132,-153,-152,-90,-92,24,-89,-91,-94,-83,-69,-30,24,-70,24,-85,-135,-308,24,-36,-35,24,24,-73,-76,-72,-74,24,-78,-199,-198,-77,-200,-75,-139,-137,-134,-154,-71,-31,-34,24,24,-218,-217,24,-215,-201,-214,-78,-80,-202,-138,-136,-156,-155,24,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'TIMES':([0,1,2,3,4,5,6,7,9,10,11,12,14,15,16,17,19,20,21,23,24,25,26,29,30,31,32,33,34,35,36,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,59,63,65,68,69,70,71,73,74,76,77,78,79,80,81,83,91,92,96,101,102,103,104,106,107,108,113,115,120,121,126,127,131,133,139,142,144,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,164,166,167,169,170,171,172,173,174,175,176,177,178,179,180,181,184,185,186,189,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,232,234,235,237,238,239,244,249,250,253,254,255,258,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,282,284,285,288,289,290,291,292,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,356,357,359,361,362,363,367,368,369,372,376,378,380,383,384,385,386,389,394,395,398,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,422,423,424,430,432,433,435,437,439,442,443,454,457,458,459,460,461,463,465,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[31,-309,-104,-117,31,-115,-101,-99,-97,-116,-98,-64,-60,-102,-93,-66,-96,-111,-106,-65,-95,-112,31,-221,-109,-309,-113,31,-63,-118,31,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,-309,31,31,-61,-133,-307,-132,-153,-152,-28,31,-166,-27,-90,31,-92,-89,-91,-94,-83,-86,-88,-69,171,-28,-309,31,-294,-70,228,-135,-130,-308,31,-167,31,-309,228,228,31,-298,-270,-257,-286,-301,-305,-302,-299,-284,228,-268,-285,-259,-238,228,-267,228,-297,-266,-271,228,228,-303,-265,-295,-283,309,-300,-296,-269,228,228,31,329,-73,-76,-72,228,-74,228,228,-78,-199,-198,-77,-200,228,-75,-266,-294,-139,-137,-134,-131,-128,228,-129,-154,228,367,-28,-309,-71,-309,-227,-230,-228,-224,-225,-229,-231,228,-233,-234,-226,-232,-306,228,-263,-304,-280,-279,228,228,228,-257,-262,228,-260,31,-261,228,228,228,228,228,228,228,228,228,228,228,228,228,228,228,228,228,228,228,-309,-266,430,-218,-217,228,-215,228,228,228,-201,228,-214,228,-80,-202,228,228,-138,-136,31,228,-156,-155,-266,228,228,-12,228,228,-11,-278,-277,-276,-275,-274,-287,228,31,309,309,309,309,309,309,309,309,309,309,-240,-239,309,309,309,309,309,-241,469,-28,-309,-266,-213,-216,228,-205,228,-79,-203,-309,-182,-264,-272,-273,228,228,-258,-309,228,-266,228,228,228,228,-204,228,228,228,228,-11,228,-209,-208,-206,-80,-288,228,-309,-281,228,228,-282,228,-210,-207,228,-212,-211,]),'LPAREN':([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,19,20,21,23,24,25,26,29,30,31,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,59,61,63,65,68,69,70,71,73,74,76,77,78,79,80,81,83,84,85,88,91,92,96,101,102,103,104,105,106,107,108,113,115,120,121,126,127,131,133,139,140,142,143,144,147,148,149,150,151,153,154,155,156,157,158,159,160,161,162,165,166,167,169,170,171,172,173,174,175,176,177,178,180,181,184,185,186,187,188,189,192,193,196,198,199,202,203,206,207,208,209,213,214,215,216,217,218,219,220,222,224,225,228,229,230,232,234,235,237,238,239,244,249,250,251,253,254,255,258,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,279,280,282,284,285,286,288,291,293,296,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,319,324,325,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,356,357,359,361,362,363,367,368,369,370,371,372,376,378,380,383,384,385,386,389,394,395,397,398,418,419,420,421,422,423,424,427,428,430,432,433,435,437,439,441,442,443,447,448,454,457,459,460,461,463,466,467,469,470,471,472,473,474,475,476,477,479,480,481,482,483,484,485,487,488,495,496,500,501,502,504,505,507,509,510,511,512,513,514,517,520,522,523,524,526,527,528,],[4,-309,-104,-117,4,-115,-101,-99,60,-97,-116,-98,-64,4,-60,-102,-93,-66,-96,-111,-106,-65,-95,-112,4,-221,-109,-309,-113,81,-63,-118,4,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,-309,60,81,4,-61,-133,-307,-132,-153,-152,-28,-164,-166,-27,-90,81,-92,81,145,-37,-89,-91,-94,-83,-86,-88,-69,-30,173,-28,-309,189,-294,-70,173,-135,-130,-308,81,-167,-165,81,145,-309,173,173,81,-298,-270,-286,-301,-305,-302,-299,-284,277,-268,-285,285,287,288,-267,291,-297,-266,-271,173,291,-303,-265,-295,-283,-300,-296,-269,173,173,-36,-35,189,189,327,-45,173,331,-73,-76,-72,173,-74,339,343,288,173,348,-78,-199,-198,-77,-200,173,-75,-266,-294,355,-139,-137,-134,-131,-128,288,-129,-154,288,-38,173,-28,-309,-71,-309,-227,-230,-228,-224,-225,-229,-231,173,-233,-234,-226,-232,-306,173,-304,-280,-279,173,173,-31,173,173,-34,398,288,288,288,288,288,288,288,288,288,288,288,288,288,288,288,288,173,288,288,189,327,331,-309,-266,173,-218,-217,173,-215,173,173,173,-201,173,-214,173,-80,-202,173,173,-138,-136,81,288,-156,-155,-266,173,173,-44,-43,-12,288,173,-11,-278,-277,-276,-275,-274,-287,288,398,398,-33,-32,-197,-191,173,-28,-309,-193,-195,-266,-213,-216,173,-205,173,482,-79,-203,-39,-42,-309,-182,-272,-273,173,288,-309,288,-266,173,173,-51,-50,-192,-194,-196,173,173,-204,173,173,173,-41,-40,173,-11,-46,-49,173,-209,-208,-206,-80,-288,173,-309,-281,-48,-47,173,173,-282,173,-210,-207,173,-212,-211,]),'MINUSMINUS':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,115,121,131,139,144,147,148,150,151,153,154,155,156,157,158,159,160,161,162,166,167,169,170,171,172,173,174,175,176,177,178,180,181,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,229,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,276,277,279,280,282,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,383,384,385,386,389,394,395,422,423,424,430,432,433,435,437,439,442,443,454,457,459,460,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,507,509,510,511,514,517,520,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,174,-28,-309,-294,174,-308,-167,-309,174,174,-298,-270,-286,-301,-305,-302,-299,-284,174,-268,-285,280,174,-267,174,-297,-266,-271,174,174,-303,-265,-295,-283,-300,-296,-269,174,174,174,-73,-76,-72,174,-74,174,174,-78,-199,-198,-77,-200,174,-75,-266,-294,174,174,174,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,174,-233,-234,-226,-232,-306,174,-304,-280,-279,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,174,-309,-266,174,-218,-217,174,-215,174,174,174,-201,174,-214,174,-80,-202,174,174,174,-266,174,174,-12,174,174,-11,-278,-277,-276,-275,-274,-287,174,174,-28,-309,-266,-213,-216,174,-205,174,-79,-203,-309,-182,-272,-273,174,174,-309,174,-266,174,174,174,174,-204,174,174,174,174,-11,174,-209,-208,-206,-80,-288,174,-309,-281,174,174,-282,174,-210,-207,174,-212,-211,]),'ID':([0,1,2,3,4,5,6,7,9,10,11,12,13,14,15,16,17,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,38,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,59,60,63,65,68,69,70,71,73,74,75,76,77,78,79,80,81,83,84,91,92,96,101,102,103,104,106,107,108,113,120,121,126,127,131,133,134,135,139,140,142,144,145,147,148,149,151,159,160,166,167,169,171,173,174,176,184,185,186,189,192,198,200,202,203,204,206,207,208,214,215,217,218,219,220,222,224,225,228,232,234,235,237,238,239,244,248,249,250,253,254,255,258,260,264,265,266,267,268,269,270,271,272,273,274,275,277,281,283,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,319,326,327,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,356,357,359,361,362,363,367,368,369,372,375,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,462,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,508,509,510,514,517,522,523,524,526,527,528,],[37,-309,-104,-117,37,-115,-101,-99,-97,-116,-98,-64,37,-60,-102,-93,-66,-96,-111,-106,-141,-65,-95,-112,37,71,74,-221,-109,-309,-113,37,-63,-118,37,-140,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,-309,115,37,37,-61,-133,-307,-132,-153,-152,138,-28,-164,-166,-27,-90,37,-92,37,-89,-91,-94,-83,-86,-88,-69,115,-28,-309,37,-70,229,-135,-130,-308,37,138,138,-167,-165,37,-309,115,115,115,37,-270,115,-268,115,-267,115,-266,115,115,-265,-269,115,115,37,37,115,115,-73,-76,335,-72,115,-74,115,229,-78,-199,-198,-77,-200,229,-75,-266,-139,-137,-134,-131,-128,115,-129,138,-154,115,115,-28,-309,-71,-309,-227,-230,-228,-224,-225,-229,-231,115,-233,-234,-226,-232,115,384,386,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,115,37,-309,115,-266,115,-218,-217,115,-215,115,229,115,-201,115,-214,229,-80,-202,229,115,-138,-136,37,115,-156,-155,-266,115,115,-12,115,115,115,-11,115,115,-28,-309,-266,-213,-216,115,-205,229,-79,-203,-309,-182,115,115,115,-309,115,-266,115,115,115,229,-204,229,115,229,115,-11,115,-209,-208,-206,-80,115,115,-309,115,229,229,-210,-207,229,-212,-211,]),'IF':([53,70,101,104,121,131,202,203,206,208,215,217,218,219,220,222,224,225,336,337,340,342,346,349,351,352,353,354,432,433,437,439,442,443,479,480,481,483,501,502,504,505,517,522,523,524,526,527,528,],[-68,-307,-83,-69,230,-308,-73,-76,-72,-74,230,-78,-199,-198,-77,-200,230,-75,-218,-217,-215,230,-201,-214,230,-80,-202,230,-213,-216,-205,230,-79,-203,230,-204,230,230,-209,-208,-206,-80,230,230,-210,-207,230,-212,-211,]),'STRING_LITERAL':([3,35,51,53,59,70,76,78,79,101,104,106,107,108,121,131,139,144,147,148,151,159,160,161,166,167,169,171,173,174,175,176,184,185,186,198,202,203,206,207,208,214,215,217,218,219,220,222,224,225,228,239,250,253,254,255,260,264,265,266,267,268,269,270,271,272,273,274,275,277,279,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,326,329,330,336,337,339,340,341,342,343,346,348,349,351,352,353,354,355,361,367,368,369,372,376,378,380,395,422,423,424,430,432,433,435,437,439,442,443,454,457,461,463,466,467,469,470,471,477,479,480,481,482,483,487,488,500,501,502,504,505,509,510,514,517,522,523,524,526,527,528,],[-117,-118,-119,-68,-309,-307,-28,-166,-27,-83,-69,175,-28,-309,175,-308,-167,-309,175,175,-270,175,-268,279,175,-267,175,-266,175,175,-303,-265,-269,175,175,175,-73,-76,-72,175,-74,175,175,-78,-199,-198,-77,-200,175,-75,-266,175,175,175,-28,-309,-309,-227,-230,-228,-224,-225,-229,-231,175,-233,-234,-226,-232,175,-304,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,175,-309,-266,175,-218,-217,175,-215,175,175,175,-201,175,-214,175,-80,-202,175,175,175,-266,175,175,-12,175,175,-11,175,175,-28,-309,-266,-213,-216,175,-205,175,-79,-203,-309,-182,175,175,-309,175,-266,175,175,175,175,-204,175,175,175,175,-11,175,-209,-208,-206,-80,175,-309,175,175,175,-210,-207,175,-212,-211,]),'FLOAT':([0,1,2,3,5,6,7,8,9,10,11,12,14,15,16,17,18,19,20,21,23,24,25,26,29,30,32,33,34,35,36,37,39,40,41,42,44,45,47,48,49,50,51,53,54,55,56,57,60,61,63,64,65,67,68,69,70,71,72,73,74,78,80,83,87,91,92,96,101,102,103,104,105,113,117,120,121,122,123,124,125,126,127,128,129,130,131,132,133,139,145,173,187,188,189,201,202,203,206,208,215,217,218,219,220,222,225,231,232,233,234,235,236,237,238,244,249,258,277,286,287,288,291,293,296,327,331,336,337,339,340,346,349,351,352,353,356,357,360,362,363,398,418,419,432,433,437,442,443,480,501,502,504,505,523,524,527,528,],[39,-309,-104,-117,-115,-101,-99,-52,-97,-116,-98,-64,-60,-102,-93,-66,39,-96,-111,-106,-65,-95,-112,39,-221,-109,-113,39,-63,-118,39,-29,-107,-62,-103,-67,-114,-108,-309,-110,-309,-105,-119,-68,-100,-87,-10,-9,39,-53,39,-84,39,39,-61,-133,-307,-132,39,-153,-152,-166,-90,-92,39,-89,-91,-94,-83,-86,-88,-69,-30,39,39,-70,39,-85,39,39,39,-135,-130,-145,-146,-142,-308,39,39,-167,39,39,-36,-35,39,39,-73,-76,-72,-74,39,-78,-199,-198,-77,-200,-75,39,-139,39,-137,-134,-143,-131,-128,-129,-154,-71,39,-31,39,39,39,-34,39,39,39,-218,-217,39,-215,-201,-214,-78,-80,-202,-138,-136,-144,-156,-155,39,-33,-32,-213,-216,-205,-79,-203,-204,-209,-208,-206,-80,-210,-207,-212,-211,]),'XOREQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,268,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'LSHIFTEQUAL':([115,131,150,152,153,154,155,156,157,158,161,162,170,172,175,177,178,180,181,229,276,278,279,280,282,289,290,292,297,383,384,385,386,389,394,458,459,460,465,507,511,520,],[-294,-308,-298,270,-286,-301,-305,-302,-299,-284,-285,-259,-297,-271,-303,-295,-283,-300,-296,-294,-306,-263,-304,-280,-279,-257,-262,-260,-261,-278,-277,-276,-275,-274,-287,-264,-272,-273,-258,-288,-281,-282,]),'RBRACKET':([3,35,51,59,78,79,106,107,115,131,139,144,150,152,153,154,155,156,157,158,161,162,163,164,168,170,171,172,175,177,178,179,180,181,182,183,198,227,253,254,276,278,279,280,282,289,290,292,297,317,318,326,328,329,330,345,366,367,381,383,384,385,386,387,389,394,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,416,417,422,423,429,430,436,449,450,453,458,459,460,465,468,469,494,497,498,507,511,519,520,],[-117,-118,-119,-309,-166,-27,-309,-28,-294,-308,-167,-309,-298,-257,-286,-301,-305,-302,-299,-284,-285,-259,286,-238,-4,-297,293,-271,-303,-295,-283,-236,-300,-296,-3,-222,-309,-219,-309,-28,-306,-263,-304,-280,-279,-257,-262,-260,-261,418,419,-309,427,428,-309,-235,447,448,-223,-278,-277,-276,-275,459,-274,-287,-244,-256,-245,-243,-247,-251,-246,-242,-249,-254,-240,-239,-248,-255,-250,-252,-253,-241,-309,-28,474,475,-220,484,485,486,-264,-272,-273,-258,495,496,-237,512,513,-288,-281,525,-282,]),}
+
+_lr_action = {}
+for _k, _v in _lr_action_items.items():
+   for _x,_y in zip(_v[0],_v[1]):
+      if not _x in _lr_action:  _lr_action[_x] = {}
+      _lr_action[_x][_k] = _y
+del _lr_action_items
+
+_lr_goto_items = {'expression_statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[202,202,202,202,202,202,202,202,202,202,202,202,202,]),'struct_or_union_specifier':([0,18,26,36,60,65,67,72,87,117,121,123,124,125,132,145,173,189,201,215,231,233,277,287,288,291,327,331,339,398,],[5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,]),'init_declarator_list':([33,63,],[82,82,]),'init_declarator_list_opt':([33,63,],[90,90,]),'iteration_statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[203,203,203,203,203,203,203,203,203,203,203,203,203,]),'unified_string_literal':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,161,]),'assignment_expression_opt':([106,198,253,330,422,],[163,328,366,429,468,]),'brace_open':([27,28,66,69,71,73,74,121,146,147,148,215,224,342,351,354,378,395,439,458,463,464,479,481,483,487,517,522,526,],[72,75,121,123,124,134,135,121,121,260,260,121,121,121,121,121,260,466,121,466,466,466,121,121,121,260,121,121,121,]),'enumerator':([75,134,135,248,],[136,136,136,364,]),'typeid_noparen_declarator':([113,],[197,]),'type_qualifier_list_opt':([31,59,108,144,255,326,424,],[77,106,186,253,369,422,471,]),'declaration_specifiers_no_type_opt':([1,47,49,],[55,102,103,]),'expression_opt':([121,215,224,339,342,351,354,435,439,477,479,481,483,500,514,517,522,526,],[205,205,205,434,205,205,205,478,205,499,205,205,205,515,521,205,205,205,]),'designation':([260,454,466,510,],[372,372,372,372,]),'parameter_list':([60,145,189,327,331,398,],[116,116,116,116,116,116,]),'labeled_statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[206,206,206,206,206,206,206,206,206,206,206,206,206,]),'abstract_declarator':([113,189,296,398,],[191,323,191,323,]),'translation_unit':([0,],[26,]),'init_declarator':([33,63,142,149,],[94,94,252,263,]),'direct_abstract_declarator':([113,189,192,296,319,397,398,],[199,199,325,199,325,325,199,]),'designator_list':([260,454,466,510,],[379,379,379,379,]),'identifier':([60,106,121,145,147,148,159,166,169,173,174,185,186,198,200,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,327,330,339,341,342,343,348,351,354,355,361,368,369,375,376,378,395,422,435,439,461,462,463,467,470,471,477,479,481,482,483,487,500,508,509,514,517,522,526,],[118,178,178,118,178,178,178,178,178,178,178,178,178,178,332,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,178,118,178,178,178,178,178,178,178,178,178,178,178,178,452,178,178,178,178,178,178,178,492,178,178,178,178,178,178,178,178,178,178,178,518,178,178,178,178,178,]),'offsetof_member_designator':([462,],[491,]),'unary_expression':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[152,152,152,152,278,289,292,152,297,152,152,152,152,289,152,152,289,289,152,152,152,152,152,152,152,289,289,289,289,289,289,289,289,289,289,289,289,289,289,289,289,152,289,289,152,152,152,152,152,152,152,152,152,289,152,152,289,152,289,152,152,152,152,289,289,152,152,152,152,152,152,152,152,152,152,152,152,152,152,]),'abstract_declarator_opt':([113,296,],[190,396,]),'initializer':([147,148,378,487,],[259,262,455,506,]),'direct_id_declarator':([0,4,13,26,33,36,63,65,81,84,113,133,142,149,189,192,319,359,],[8,8,61,8,8,8,8,8,8,61,8,8,8,8,8,61,61,8,]),'struct_declaration_list':([72,123,124,],[125,231,233,]),'pp_directive':([0,26,],[12,12,]),'declaration_list':([18,87,],[67,67,]),'id_init_declarator':([36,65,],[95,95,]),'type_specifier':([0,18,26,36,60,65,67,72,87,117,121,123,124,125,132,145,173,189,201,215,231,233,277,287,288,291,327,331,339,398,],[16,16,16,96,16,96,16,127,16,96,16,127,127,127,237,16,127,16,16,16,127,127,127,127,127,127,16,16,16,16,]),'compound_statement':([66,121,146,215,224,342,351,354,439,479,481,483,517,522,526,],[120,208,258,208,208,208,208,208,208,208,208,208,208,208,208,]),'pointer':([0,4,26,33,36,63,65,77,81,113,133,142,149,189,296,359,398,],[13,13,13,84,13,84,13,140,84,192,84,84,84,319,397,84,397,]),'typeid_declarator':([33,63,81,133,142,149,359,],[86,86,141,86,86,86,86,]),'id_init_declarator_list':([36,65,],[98,98,]),'declarator':([33,63,133,142,149,359,],[89,89,245,89,89,245,]),'argument_expression_list':([285,],[390,]),'struct_declarator_list_opt':([133,],[242,]),'typedef_name':([0,18,26,36,60,65,67,72,87,117,121,123,124,125,132,145,173,189,201,215,231,233,277,287,288,291,327,331,339,398,],[32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,32,]),'parameter_type_list_opt':([189,331,398,],[322,431,322,]),'struct_declarator':([133,359,],[243,445,]),'type_qualifier':([0,1,18,26,31,33,47,49,59,60,63,67,72,76,87,107,108,113,121,123,124,125,132,133,144,145,173,189,201,215,231,233,254,255,277,287,288,291,296,326,327,331,339,398,423,424,],[47,47,47,47,78,91,47,47,78,47,91,47,78,139,47,139,78,91,47,78,78,78,139,244,78,47,78,47,47,47,78,78,139,78,78,78,78,78,244,78,47,47,47,47,139,78,]),'assignment_operator':([152,],[271,]),'expression':([121,173,207,215,224,277,284,288,291,314,339,342,343,348,351,354,355,435,439,477,479,481,482,483,500,509,514,517,522,526,],[211,294,338,211,211,294,387,294,294,415,211,211,438,440,211,211,444,211,211,211,211,211,503,211,211,519,211,211,211,211,]),'storage_class_specifier':([0,1,18,26,33,47,49,60,63,67,87,113,121,145,189,201,215,327,331,339,398,],[1,1,1,1,80,1,1,1,80,1,1,80,1,1,1,1,1,1,1,1,1,]),'unified_wstring_literal':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,153,]),'translation_unit_or_empty':([0,],[43,]),'initializer_list_opt':([260,],[373,]),'brace_close':([72,123,124,125,137,226,231,233,246,247,373,454,493,510,],[126,232,234,235,249,353,356,357,362,363,451,489,511,520,]),'direct_typeid_declarator':([33,63,81,84,133,142,149,359,],[85,85,85,143,85,85,85,85,]),'external_declaration':([0,26,],[14,68,]),'pragmacomp_or_statement':([224,342,354,439,479,481,483,517,522,526,],[350,437,443,480,501,502,504,524,527,528,]),'type_name':([173,277,287,288,291,],[295,382,391,392,393,]),'block_item_list':([121,],[215,]),'pppragma_directive':([0,26,72,121,123,124,125,215,224,231,233,342,351,354,439,479,481,483,517,522,526,],[23,23,129,217,129,129,129,217,351,129,129,351,217,351,351,351,351,351,351,351,351,]),'statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[218,218,352,352,442,352,352,352,352,505,352,352,352,]),'cast_expression':([106,121,147,148,166,173,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[164,164,164,164,290,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,465,164,164,164,164,465,164,164,164,164,164,164,164,164,164,164,164,164,164,164,164,]),'struct_declarator_list':([133,],[240,]),'empty':([0,1,18,31,33,36,47,49,59,60,63,65,87,106,108,113,121,133,144,145,189,198,215,224,253,255,260,296,326,327,330,331,339,342,351,354,398,422,424,435,439,454,466,477,479,481,483,500,510,514,517,522,526,],[52,57,62,79,93,100,57,57,79,110,93,100,62,182,79,195,223,241,79,110,320,182,347,347,182,79,380,195,79,110,182,320,347,347,347,347,320,182,79,347,347,488,488,347,347,347,347,347,488,347,347,347,347,]),'parameter_declaration':([60,145,189,201,327,331,398,],[112,112,112,334,112,112,112,]),'primary_expression':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,172,]),'declaration':([0,18,26,67,87,121,215,339,],[34,64,34,122,64,219,219,435,]),'declaration_specifiers_no_type':([0,1,18,26,47,49,60,67,87,121,145,189,201,215,327,331,339,398,],[36,56,65,36,56,56,117,65,65,65,117,117,117,65,117,117,65,117,]),'jump_statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[220,220,220,220,220,220,220,220,220,220,220,220,220,]),'enumerator_list':([75,134,135,],[137,246,247,]),'block_item':([121,215,],[222,346,]),'constant_expression':([214,239,250,361,376,],[344,358,365,446,453,]),'identifier_list_opt':([60,145,327,],[109,256,425,]),'constant':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,158,]),'type_specifier_no_typeid':([0,18,26,33,36,60,63,65,67,72,87,113,117,121,123,124,125,132,133,145,173,189,201,215,231,233,277,287,288,291,296,327,331,339,398,],[10,10,10,83,10,10,83,10,10,10,10,83,10,10,10,10,10,10,238,10,10,10,10,10,10,10,10,10,10,10,238,10,10,10,10,]),'struct_declaration':([72,123,124,125,231,233,],[130,130,130,236,236,236,]),'direct_typeid_noparen_declarator':([113,192,],[193,324,]),'id_declarator':([0,4,26,33,36,63,65,81,113,133,142,149,189,359,],[18,58,18,87,97,119,97,58,194,119,119,119,58,119,]),'selection_statement':([121,215,224,342,351,354,439,479,481,483,517,522,526,],[225,225,225,225,225,225,225,225,225,225,225,225,225,]),'postfix_expression':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,162,]),'initializer_list':([260,466,],[377,493,]),'unary_operator':([106,121,147,148,159,166,169,173,174,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,395,422,435,439,461,463,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,166,]),'struct_or_union':([0,18,26,36,60,65,67,72,87,117,121,123,124,125,132,145,173,189,201,215,231,233,277,287,288,291,327,331,339,398,],[27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,27,]),'block_item_list_opt':([121,],[226,]),'assignment_expression':([106,121,147,148,173,185,186,198,207,215,224,253,271,277,284,285,288,291,314,330,339,341,342,343,348,351,354,355,368,369,378,422,435,439,461,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[168,227,261,261,227,317,318,168,227,227,227,168,381,227,227,388,227,227,227,168,227,436,227,227,227,227,227,227,449,450,261,168,227,227,490,497,498,227,227,227,227,227,261,227,227,227,227,227,227,]),'designation_opt':([260,454,466,510,],[378,487,378,487,]),'parameter_type_list':([60,145,189,327,331,398,],[111,257,321,426,321,321,]),'type_qualifier_list':([31,59,72,108,123,124,125,144,173,231,233,255,277,287,288,291,326,424,],[76,107,132,76,132,132,132,254,132,132,132,76,132,132,132,132,423,76,]),'designator':([260,379,454,466,510,],[374,456,374,374,374,]),'id_init_declarator_list_opt':([36,65,],[99,99,]),'declaration_specifiers':([0,18,26,60,67,87,121,145,189,201,215,327,331,339,398,],[33,63,33,113,63,63,63,113,113,113,63,113,113,63,113,]),'identifier_list':([60,145,327,],[114,114,114,]),'declaration_list_opt':([18,87,],[66,146,]),'function_definition':([0,26,],[40,40,]),'binary_expression':([106,121,147,148,173,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,330,339,341,342,343,348,351,354,355,361,368,369,376,378,422,435,439,461,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,399,400,401,402,403,404,405,406,407,408,409,410,411,412,413,414,179,416,417,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,179,]),'enum_specifier':([0,18,26,36,60,65,67,72,87,117,121,123,124,125,132,145,173,189,201,215,231,233,277,287,288,291,327,331,339,398,],[44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,44,]),'decl_body':([0,18,26,67,87,121,215,339,],[46,46,46,46,46,46,46,46,]),'function_specifier':([0,1,18,26,33,47,49,60,63,67,87,113,121,145,189,201,215,327,331,339,398,],[49,49,49,49,92,49,49,49,92,49,49,92,49,49,49,49,49,49,49,49,49,]),'specifier_qualifier_list':([72,123,124,125,173,231,233,277,287,288,291,],[133,133,133,133,296,133,133,296,296,296,296,]),'conditional_expression':([106,121,147,148,173,185,186,198,207,214,215,224,239,250,253,271,277,284,285,288,291,314,330,339,341,342,343,348,351,354,355,361,368,369,376,378,422,435,439,461,467,470,471,477,479,481,482,483,487,500,509,514,517,522,526,],[183,183,183,183,183,183,183,183,183,345,183,183,345,345,183,183,183,183,183,183,183,183,183,183,183,183,183,183,183,183,183,345,183,183,345,183,183,183,183,183,494,183,183,183,183,183,183,183,183,183,183,183,183,183,183,]),}
+
+_lr_goto = {}
+for _k, _v in _lr_goto_items.items():
+   for _x, _y in zip(_v[0], _v[1]):
+       if not _x in _lr_goto: _lr_goto[_x] = {}
+       _lr_goto[_x][_k] = _y
+del _lr_goto_items
+_lr_productions = [
+  ("S' -> translation_unit_or_empty","S'",1,None,None,None),
+  ('abstract_declarator_opt -> empty','abstract_declarator_opt',1,'p_abstract_declarator_opt','plyparser.py',43),
+  ('abstract_declarator_opt -> abstract_declarator','abstract_declarator_opt',1,'p_abstract_declarator_opt','plyparser.py',44),
+  ('assignment_expression_opt -> empty','assignment_expression_opt',1,'p_assignment_expression_opt','plyparser.py',43),
+  ('assignment_expression_opt -> assignment_expression','assignment_expression_opt',1,'p_assignment_expression_opt','plyparser.py',44),
+  ('block_item_list_opt -> empty','block_item_list_opt',1,'p_block_item_list_opt','plyparser.py',43),
+  ('block_item_list_opt -> block_item_list','block_item_list_opt',1,'p_block_item_list_opt','plyparser.py',44),
+  ('declaration_list_opt -> empty','declaration_list_opt',1,'p_declaration_list_opt','plyparser.py',43),
+  ('declaration_list_opt -> declaration_list','declaration_list_opt',1,'p_declaration_list_opt','plyparser.py',44),
+  ('declaration_specifiers_no_type_opt -> empty','declaration_specifiers_no_type_opt',1,'p_declaration_specifiers_no_type_opt','plyparser.py',43),
+  ('declaration_specifiers_no_type_opt -> declaration_specifiers_no_type','declaration_specifiers_no_type_opt',1,'p_declaration_specifiers_no_type_opt','plyparser.py',44),
+  ('designation_opt -> empty','designation_opt',1,'p_designation_opt','plyparser.py',43),
+  ('designation_opt -> designation','designation_opt',1,'p_designation_opt','plyparser.py',44),
+  ('expression_opt -> empty','expression_opt',1,'p_expression_opt','plyparser.py',43),
+  ('expression_opt -> expression','expression_opt',1,'p_expression_opt','plyparser.py',44),
+  ('id_init_declarator_list_opt -> empty','id_init_declarator_list_opt',1,'p_id_init_declarator_list_opt','plyparser.py',43),
+  ('id_init_declarator_list_opt -> id_init_declarator_list','id_init_declarator_list_opt',1,'p_id_init_declarator_list_opt','plyparser.py',44),
+  ('identifier_list_opt -> empty','identifier_list_opt',1,'p_identifier_list_opt','plyparser.py',43),
+  ('identifier_list_opt -> identifier_list','identifier_list_opt',1,'p_identifier_list_opt','plyparser.py',44),
+  ('init_declarator_list_opt -> empty','init_declarator_list_opt',1,'p_init_declarator_list_opt','plyparser.py',43),
+  ('init_declarator_list_opt -> init_declarator_list','init_declarator_list_opt',1,'p_init_declarator_list_opt','plyparser.py',44),
+  ('initializer_list_opt -> empty','initializer_list_opt',1,'p_initializer_list_opt','plyparser.py',43),
+  ('initializer_list_opt -> initializer_list','initializer_list_opt',1,'p_initializer_list_opt','plyparser.py',44),
+  ('parameter_type_list_opt -> empty','parameter_type_list_opt',1,'p_parameter_type_list_opt','plyparser.py',43),
+  ('parameter_type_list_opt -> parameter_type_list','parameter_type_list_opt',1,'p_parameter_type_list_opt','plyparser.py',44),
+  ('struct_declarator_list_opt -> empty','struct_declarator_list_opt',1,'p_struct_declarator_list_opt','plyparser.py',43),
+  ('struct_declarator_list_opt -> struct_declarator_list','struct_declarator_list_opt',1,'p_struct_declarator_list_opt','plyparser.py',44),
+  ('type_qualifier_list_opt -> empty','type_qualifier_list_opt',1,'p_type_qualifier_list_opt','plyparser.py',43),
+  ('type_qualifier_list_opt -> type_qualifier_list','type_qualifier_list_opt',1,'p_type_qualifier_list_opt','plyparser.py',44),
+  ('direct_id_declarator -> ID','direct_id_declarator',1,'p_direct_id_declarator_1','plyparser.py',126),
+  ('direct_id_declarator -> LPAREN id_declarator RPAREN','direct_id_declarator',3,'p_direct_id_declarator_2','plyparser.py',126),
+  ('direct_id_declarator -> direct_id_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET','direct_id_declarator',5,'p_direct_id_declarator_3','plyparser.py',126),
+  ('direct_id_declarator -> direct_id_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET','direct_id_declarator',6,'p_direct_id_declarator_4','plyparser.py',126),
+  ('direct_id_declarator -> direct_id_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET','direct_id_declarator',6,'p_direct_id_declarator_4','plyparser.py',127),
+  ('direct_id_declarator -> direct_id_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET','direct_id_declarator',5,'p_direct_id_declarator_5','plyparser.py',126),
+  ('direct_id_declarator -> direct_id_declarator LPAREN parameter_type_list RPAREN','direct_id_declarator',4,'p_direct_id_declarator_6','plyparser.py',126),
+  ('direct_id_declarator -> direct_id_declarator LPAREN identifier_list_opt RPAREN','direct_id_declarator',4,'p_direct_id_declarator_6','plyparser.py',127),
+  ('direct_typeid_declarator -> TYPEID','direct_typeid_declarator',1,'p_direct_typeid_declarator_1','plyparser.py',126),
+  ('direct_typeid_declarator -> LPAREN typeid_declarator RPAREN','direct_typeid_declarator',3,'p_direct_typeid_declarator_2','plyparser.py',126),
+  ('direct_typeid_declarator -> direct_typeid_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET','direct_typeid_declarator',5,'p_direct_typeid_declarator_3','plyparser.py',126),
+  ('direct_typeid_declarator -> direct_typeid_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET','direct_typeid_declarator',6,'p_direct_typeid_declarator_4','plyparser.py',126),
+  ('direct_typeid_declarator -> direct_typeid_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET','direct_typeid_declarator',6,'p_direct_typeid_declarator_4','plyparser.py',127),
+  ('direct_typeid_declarator -> direct_typeid_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET','direct_typeid_declarator',5,'p_direct_typeid_declarator_5','plyparser.py',126),
+  ('direct_typeid_declarator -> direct_typeid_declarator LPAREN parameter_type_list RPAREN','direct_typeid_declarator',4,'p_direct_typeid_declarator_6','plyparser.py',126),
+  ('direct_typeid_declarator -> direct_typeid_declarator LPAREN identifier_list_opt RPAREN','direct_typeid_declarator',4,'p_direct_typeid_declarator_6','plyparser.py',127),
+  ('direct_typeid_noparen_declarator -> TYPEID','direct_typeid_noparen_declarator',1,'p_direct_typeid_noparen_declarator_1','plyparser.py',126),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LBRACKET type_qualifier_list_opt assignment_expression_opt RBRACKET','direct_typeid_noparen_declarator',5,'p_direct_typeid_noparen_declarator_3','plyparser.py',126),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LBRACKET STATIC type_qualifier_list_opt assignment_expression RBRACKET','direct_typeid_noparen_declarator',6,'p_direct_typeid_noparen_declarator_4','plyparser.py',126),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LBRACKET type_qualifier_list STATIC assignment_expression RBRACKET','direct_typeid_noparen_declarator',6,'p_direct_typeid_noparen_declarator_4','plyparser.py',127),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LBRACKET type_qualifier_list_opt TIMES RBRACKET','direct_typeid_noparen_declarator',5,'p_direct_typeid_noparen_declarator_5','plyparser.py',126),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LPAREN parameter_type_list RPAREN','direct_typeid_noparen_declarator',4,'p_direct_typeid_noparen_declarator_6','plyparser.py',126),
+  ('direct_typeid_noparen_declarator -> direct_typeid_noparen_declarator LPAREN identifier_list_opt RPAREN','direct_typeid_noparen_declarator',4,'p_direct_typeid_noparen_declarator_6','plyparser.py',127),
+  ('id_declarator -> direct_id_declarator','id_declarator',1,'p_id_declarator_1','plyparser.py',126),
+  ('id_declarator -> pointer direct_id_declarator','id_declarator',2,'p_id_declarator_2','plyparser.py',126),
+  ('typeid_declarator -> direct_typeid_declarator','typeid_declarator',1,'p_typeid_declarator_1','plyparser.py',126),
+  ('typeid_declarator -> pointer direct_typeid_declarator','typeid_declarator',2,'p_typeid_declarator_2','plyparser.py',126),
+  ('typeid_noparen_declarator -> direct_typeid_noparen_declarator','typeid_noparen_declarator',1,'p_typeid_noparen_declarator_1','plyparser.py',126),
+  ('typeid_noparen_declarator -> pointer direct_typeid_noparen_declarator','typeid_noparen_declarator',2,'p_typeid_noparen_declarator_2','plyparser.py',126),
+  ('translation_unit_or_empty -> translation_unit','translation_unit_or_empty',1,'p_translation_unit_or_empty','c_parser.py',514),
+  ('translation_unit_or_empty -> empty','translation_unit_or_empty',1,'p_translation_unit_or_empty','c_parser.py',515),
+  ('translation_unit -> external_declaration','translation_unit',1,'p_translation_unit_1','c_parser.py',523),
+  ('translation_unit -> translation_unit external_declaration','translation_unit',2,'p_translation_unit_2','c_parser.py',530),
+  ('external_declaration -> function_definition','external_declaration',1,'p_external_declaration_1','c_parser.py',542),
+  ('external_declaration -> declaration','external_declaration',1,'p_external_declaration_2','c_parser.py',547),
+  ('external_declaration -> pp_directive','external_declaration',1,'p_external_declaration_3','c_parser.py',552),
+  ('external_declaration -> pppragma_directive','external_declaration',1,'p_external_declaration_3','c_parser.py',553),
+  ('external_declaration -> SEMI','external_declaration',1,'p_external_declaration_4','c_parser.py',558),
+  ('pp_directive -> PPHASH','pp_directive',1,'p_pp_directive','c_parser.py',563),
+  ('pppragma_directive -> PPPRAGMA','pppragma_directive',1,'p_pppragma_directive','c_parser.py',569),
+  ('pppragma_directive -> PPPRAGMA PPPRAGMASTR','pppragma_directive',2,'p_pppragma_directive','c_parser.py',570),
+  ('function_definition -> id_declarator declaration_list_opt compound_statement','function_definition',3,'p_function_definition_1','c_parser.py',581),
+  ('function_definition -> declaration_specifiers id_declarator declaration_list_opt compound_statement','function_definition',4,'p_function_definition_2','c_parser.py',598),
+  ('statement -> labeled_statement','statement',1,'p_statement','c_parser.py',609),
+  ('statement -> expression_statement','statement',1,'p_statement','c_parser.py',610),
+  ('statement -> compound_statement','statement',1,'p_statement','c_parser.py',611),
+  ('statement -> selection_statement','statement',1,'p_statement','c_parser.py',612),
+  ('statement -> iteration_statement','statement',1,'p_statement','c_parser.py',613),
+  ('statement -> jump_statement','statement',1,'p_statement','c_parser.py',614),
+  ('statement -> pppragma_directive','statement',1,'p_statement','c_parser.py',615),
+  ('pragmacomp_or_statement -> pppragma_directive statement','pragmacomp_or_statement',2,'p_pragmacomp_or_statement','c_parser.py',662),
+  ('pragmacomp_or_statement -> statement','pragmacomp_or_statement',1,'p_pragmacomp_or_statement','c_parser.py',663),
+  ('decl_body -> declaration_specifiers init_declarator_list_opt','decl_body',2,'p_decl_body','c_parser.py',682),
+  ('decl_body -> declaration_specifiers_no_type id_init_declarator_list_opt','decl_body',2,'p_decl_body','c_parser.py',683),
+  ('declaration -> decl_body SEMI','declaration',2,'p_declaration','c_parser.py',742),
+  ('declaration_list -> declaration','declaration_list',1,'p_declaration_list','c_parser.py',751),
+  ('declaration_list -> declaration_list declaration','declaration_list',2,'p_declaration_list','c_parser.py',752),
+  ('declaration_specifiers_no_type -> type_qualifier declaration_specifiers_no_type_opt','declaration_specifiers_no_type',2,'p_declaration_specifiers_no_type_1','c_parser.py',762),
+  ('declaration_specifiers_no_type -> storage_class_specifier declaration_specifiers_no_type_opt','declaration_specifiers_no_type',2,'p_declaration_specifiers_no_type_2','c_parser.py',767),
+  ('declaration_specifiers_no_type -> function_specifier declaration_specifiers_no_type_opt','declaration_specifiers_no_type',2,'p_declaration_specifiers_no_type_3','c_parser.py',772),
+  ('declaration_specifiers -> declaration_specifiers type_qualifier','declaration_specifiers',2,'p_declaration_specifiers_1','c_parser.py',778),
+  ('declaration_specifiers -> declaration_specifiers storage_class_specifier','declaration_specifiers',2,'p_declaration_specifiers_2','c_parser.py',783),
+  ('declaration_specifiers -> declaration_specifiers function_specifier','declaration_specifiers',2,'p_declaration_specifiers_3','c_parser.py',788),
+  ('declaration_specifiers -> declaration_specifiers type_specifier_no_typeid','declaration_specifiers',2,'p_declaration_specifiers_4','c_parser.py',793),
+  ('declaration_specifiers -> type_specifier','declaration_specifiers',1,'p_declaration_specifiers_5','c_parser.py',798),
+  ('declaration_specifiers -> declaration_specifiers_no_type type_specifier','declaration_specifiers',2,'p_declaration_specifiers_6','c_parser.py',803),
+  ('storage_class_specifier -> AUTO','storage_class_specifier',1,'p_storage_class_specifier','c_parser.py',809),
+  ('storage_class_specifier -> REGISTER','storage_class_specifier',1,'p_storage_class_specifier','c_parser.py',810),
+  ('storage_class_specifier -> STATIC','storage_class_specifier',1,'p_storage_class_specifier','c_parser.py',811),
+  ('storage_class_specifier -> EXTERN','storage_class_specifier',1,'p_storage_class_specifier','c_parser.py',812),
+  ('storage_class_specifier -> TYPEDEF','storage_class_specifier',1,'p_storage_class_specifier','c_parser.py',813),
+  ('function_specifier -> INLINE','function_specifier',1,'p_function_specifier','c_parser.py',818),
+  ('type_specifier_no_typeid -> VOID','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',823),
+  ('type_specifier_no_typeid -> _BOOL','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',824),
+  ('type_specifier_no_typeid -> CHAR','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',825),
+  ('type_specifier_no_typeid -> SHORT','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',826),
+  ('type_specifier_no_typeid -> INT','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',827),
+  ('type_specifier_no_typeid -> LONG','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',828),
+  ('type_specifier_no_typeid -> FLOAT','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',829),
+  ('type_specifier_no_typeid -> DOUBLE','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',830),
+  ('type_specifier_no_typeid -> _COMPLEX','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',831),
+  ('type_specifier_no_typeid -> SIGNED','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',832),
+  ('type_specifier_no_typeid -> UNSIGNED','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',833),
+  ('type_specifier_no_typeid -> __INT128','type_specifier_no_typeid',1,'p_type_specifier_no_typeid','c_parser.py',834),
+  ('type_specifier -> typedef_name','type_specifier',1,'p_type_specifier','c_parser.py',839),
+  ('type_specifier -> enum_specifier','type_specifier',1,'p_type_specifier','c_parser.py',840),
+  ('type_specifier -> struct_or_union_specifier','type_specifier',1,'p_type_specifier','c_parser.py',841),
+  ('type_specifier -> type_specifier_no_typeid','type_specifier',1,'p_type_specifier','c_parser.py',842),
+  ('type_qualifier -> CONST','type_qualifier',1,'p_type_qualifier','c_parser.py',847),
+  ('type_qualifier -> RESTRICT','type_qualifier',1,'p_type_qualifier','c_parser.py',848),
+  ('type_qualifier -> VOLATILE','type_qualifier',1,'p_type_qualifier','c_parser.py',849),
+  ('init_declarator_list -> init_declarator','init_declarator_list',1,'p_init_declarator_list','c_parser.py',854),
+  ('init_declarator_list -> init_declarator_list COMMA init_declarator','init_declarator_list',3,'p_init_declarator_list','c_parser.py',855),
+  ('init_declarator -> declarator','init_declarator',1,'p_init_declarator','c_parser.py',863),
+  ('init_declarator -> declarator EQUALS initializer','init_declarator',3,'p_init_declarator','c_parser.py',864),
+  ('id_init_declarator_list -> id_init_declarator','id_init_declarator_list',1,'p_id_init_declarator_list','c_parser.py',869),
+  ('id_init_declarator_list -> id_init_declarator_list COMMA init_declarator','id_init_declarator_list',3,'p_id_init_declarator_list','c_parser.py',870),
+  ('id_init_declarator -> id_declarator','id_init_declarator',1,'p_id_init_declarator','c_parser.py',875),
+  ('id_init_declarator -> id_declarator EQUALS initializer','id_init_declarator',3,'p_id_init_declarator','c_parser.py',876),
+  ('specifier_qualifier_list -> specifier_qualifier_list type_specifier_no_typeid','specifier_qualifier_list',2,'p_specifier_qualifier_list_1','c_parser.py',883),
+  ('specifier_qualifier_list -> specifier_qualifier_list type_qualifier','specifier_qualifier_list',2,'p_specifier_qualifier_list_2','c_parser.py',888),
+  ('specifier_qualifier_list -> type_specifier','specifier_qualifier_list',1,'p_specifier_qualifier_list_3','c_parser.py',893),
+  ('specifier_qualifier_list -> type_qualifier_list type_specifier','specifier_qualifier_list',2,'p_specifier_qualifier_list_4','c_parser.py',898),
+  ('struct_or_union_specifier -> struct_or_union ID','struct_or_union_specifier',2,'p_struct_or_union_specifier_1','c_parser.py',907),
+  ('struct_or_union_specifier -> struct_or_union TYPEID','struct_or_union_specifier',2,'p_struct_or_union_specifier_1','c_parser.py',908),
+  ('struct_or_union_specifier -> struct_or_union brace_open struct_declaration_list brace_close','struct_or_union_specifier',4,'p_struct_or_union_specifier_2','c_parser.py',918),
+  ('struct_or_union_specifier -> struct_or_union brace_open brace_close','struct_or_union_specifier',3,'p_struct_or_union_specifier_2','c_parser.py',919),
+  ('struct_or_union_specifier -> struct_or_union ID brace_open struct_declaration_list brace_close','struct_or_union_specifier',5,'p_struct_or_union_specifier_3','c_parser.py',936),
+  ('struct_or_union_specifier -> struct_or_union ID brace_open brace_close','struct_or_union_specifier',4,'p_struct_or_union_specifier_3','c_parser.py',937),
+  ('struct_or_union_specifier -> struct_or_union TYPEID brace_open struct_declaration_list brace_close','struct_or_union_specifier',5,'p_struct_or_union_specifier_3','c_parser.py',938),
+  ('struct_or_union_specifier -> struct_or_union TYPEID brace_open brace_close','struct_or_union_specifier',4,'p_struct_or_union_specifier_3','c_parser.py',939),
+  ('struct_or_union -> STRUCT','struct_or_union',1,'p_struct_or_union','c_parser.py',955),
+  ('struct_or_union -> UNION','struct_or_union',1,'p_struct_or_union','c_parser.py',956),
+  ('struct_declaration_list -> struct_declaration','struct_declaration_list',1,'p_struct_declaration_list','c_parser.py',963),
+  ('struct_declaration_list -> struct_declaration_list struct_declaration','struct_declaration_list',2,'p_struct_declaration_list','c_parser.py',964),
+  ('struct_declaration -> specifier_qualifier_list struct_declarator_list_opt SEMI','struct_declaration',3,'p_struct_declaration_1','c_parser.py',972),
+  ('struct_declaration -> SEMI','struct_declaration',1,'p_struct_declaration_2','c_parser.py',1010),
+  ('struct_declaration -> pppragma_directive','struct_declaration',1,'p_struct_declaration_3','c_parser.py',1015),
+  ('struct_declarator_list -> struct_declarator','struct_declarator_list',1,'p_struct_declarator_list','c_parser.py',1020),
+  ('struct_declarator_list -> struct_declarator_list COMMA struct_declarator','struct_declarator_list',3,'p_struct_declarator_list','c_parser.py',1021),
+  ('struct_declarator -> declarator','struct_declarator',1,'p_struct_declarator_1','c_parser.py',1029),
+  ('struct_declarator -> declarator COLON constant_expression','struct_declarator',3,'p_struct_declarator_2','c_parser.py',1034),
+  ('struct_declarator -> COLON constant_expression','struct_declarator',2,'p_struct_declarator_2','c_parser.py',1035),
+  ('enum_specifier -> ENUM ID','enum_specifier',2,'p_enum_specifier_1','c_parser.py',1043),
+  ('enum_specifier -> ENUM TYPEID','enum_specifier',2,'p_enum_specifier_1','c_parser.py',1044),
+  ('enum_specifier -> ENUM brace_open enumerator_list brace_close','enum_specifier',4,'p_enum_specifier_2','c_parser.py',1049),
+  ('enum_specifier -> ENUM ID brace_open enumerator_list brace_close','enum_specifier',5,'p_enum_specifier_3','c_parser.py',1054),
+  ('enum_specifier -> ENUM TYPEID brace_open enumerator_list brace_close','enum_specifier',5,'p_enum_specifier_3','c_parser.py',1055),
+  ('enumerator_list -> enumerator','enumerator_list',1,'p_enumerator_list','c_parser.py',1060),
+  ('enumerator_list -> enumerator_list COMMA','enumerator_list',2,'p_enumerator_list','c_parser.py',1061),
+  ('enumerator_list -> enumerator_list COMMA enumerator','enumerator_list',3,'p_enumerator_list','c_parser.py',1062),
+  ('enumerator -> ID','enumerator',1,'p_enumerator','c_parser.py',1073),
+  ('enumerator -> ID EQUALS constant_expression','enumerator',3,'p_enumerator','c_parser.py',1074),
+  ('declarator -> id_declarator','declarator',1,'p_declarator','c_parser.py',1089),
+  ('declarator -> typeid_declarator','declarator',1,'p_declarator','c_parser.py',1090),
+  ('pointer -> TIMES type_qualifier_list_opt','pointer',2,'p_pointer','c_parser.py',1201),
+  ('pointer -> TIMES type_qualifier_list_opt pointer','pointer',3,'p_pointer','c_parser.py',1202),
+  ('type_qualifier_list -> type_qualifier','type_qualifier_list',1,'p_type_qualifier_list','c_parser.py',1231),
+  ('type_qualifier_list -> type_qualifier_list type_qualifier','type_qualifier_list',2,'p_type_qualifier_list','c_parser.py',1232),
+  ('parameter_type_list -> parameter_list','parameter_type_list',1,'p_parameter_type_list','c_parser.py',1237),
+  ('parameter_type_list -> parameter_list COMMA ELLIPSIS','parameter_type_list',3,'p_parameter_type_list','c_parser.py',1238),
+  ('parameter_list -> parameter_declaration','parameter_list',1,'p_parameter_list','c_parser.py',1246),
+  ('parameter_list -> parameter_list COMMA parameter_declaration','parameter_list',3,'p_parameter_list','c_parser.py',1247),
+  ('parameter_declaration -> declaration_specifiers id_declarator','parameter_declaration',2,'p_parameter_declaration_1','c_parser.py',1266),
+  ('parameter_declaration -> declaration_specifiers typeid_noparen_declarator','parameter_declaration',2,'p_parameter_declaration_1','c_parser.py',1267),
+  ('parameter_declaration -> declaration_specifiers abstract_declarator_opt','parameter_declaration',2,'p_parameter_declaration_2','c_parser.py',1278),
+  ('identifier_list -> identifier','identifier_list',1,'p_identifier_list','c_parser.py',1309),
+  ('identifier_list -> identifier_list COMMA identifier','identifier_list',3,'p_identifier_list','c_parser.py',1310),
+  ('initializer -> assignment_expression','initializer',1,'p_initializer_1','c_parser.py',1319),
+  ('initializer -> brace_open initializer_list_opt brace_close','initializer',3,'p_initializer_2','c_parser.py',1324),
+  ('initializer -> brace_open initializer_list COMMA brace_close','initializer',4,'p_initializer_2','c_parser.py',1325),
+  ('initializer_list -> designation_opt initializer','initializer_list',2,'p_initializer_list','c_parser.py',1333),
+  ('initializer_list -> initializer_list COMMA designation_opt initializer','initializer_list',4,'p_initializer_list','c_parser.py',1334),
+  ('designation -> designator_list EQUALS','designation',2,'p_designation','c_parser.py',1345),
+  ('designator_list -> designator','designator_list',1,'p_designator_list','c_parser.py',1353),
+  ('designator_list -> designator_list designator','designator_list',2,'p_designator_list','c_parser.py',1354),
+  ('designator -> LBRACKET constant_expression RBRACKET','designator',3,'p_designator','c_parser.py',1359),
+  ('designator -> PERIOD identifier','designator',2,'p_designator','c_parser.py',1360),
+  ('type_name -> specifier_qualifier_list abstract_declarator_opt','type_name',2,'p_type_name','c_parser.py',1365),
+  ('abstract_declarator -> pointer','abstract_declarator',1,'p_abstract_declarator_1','c_parser.py',1376),
+  ('abstract_declarator -> pointer direct_abstract_declarator','abstract_declarator',2,'p_abstract_declarator_2','c_parser.py',1384),
+  ('abstract_declarator -> direct_abstract_declarator','abstract_declarator',1,'p_abstract_declarator_3','c_parser.py',1389),
+  ('direct_abstract_declarator -> LPAREN abstract_declarator RPAREN','direct_abstract_declarator',3,'p_direct_abstract_declarator_1','c_parser.py',1399),
+  ('direct_abstract_declarator -> direct_abstract_declarator LBRACKET assignment_expression_opt RBRACKET','direct_abstract_declarator',4,'p_direct_abstract_declarator_2','c_parser.py',1403),
+  ('direct_abstract_declarator -> LBRACKET assignment_expression_opt RBRACKET','direct_abstract_declarator',3,'p_direct_abstract_declarator_3','c_parser.py',1414),
+  ('direct_abstract_declarator -> direct_abstract_declarator LBRACKET TIMES RBRACKET','direct_abstract_declarator',4,'p_direct_abstract_declarator_4','c_parser.py',1423),
+  ('direct_abstract_declarator -> LBRACKET TIMES RBRACKET','direct_abstract_declarator',3,'p_direct_abstract_declarator_5','c_parser.py',1434),
+  ('direct_abstract_declarator -> direct_abstract_declarator LPAREN parameter_type_list_opt RPAREN','direct_abstract_declarator',4,'p_direct_abstract_declarator_6','c_parser.py',1443),
+  ('direct_abstract_declarator -> LPAREN parameter_type_list_opt RPAREN','direct_abstract_declarator',3,'p_direct_abstract_declarator_7','c_parser.py',1453),
+  ('block_item -> declaration','block_item',1,'p_block_item','c_parser.py',1464),
+  ('block_item -> statement','block_item',1,'p_block_item','c_parser.py',1465),
+  ('block_item_list -> block_item','block_item_list',1,'p_block_item_list','c_parser.py',1472),
+  ('block_item_list -> block_item_list block_item','block_item_list',2,'p_block_item_list','c_parser.py',1473),
+  ('compound_statement -> brace_open block_item_list_opt brace_close','compound_statement',3,'p_compound_statement_1','c_parser.py',1479),
+  ('labeled_statement -> ID COLON pragmacomp_or_statement','labeled_statement',3,'p_labeled_statement_1','c_parser.py',1485),
+  ('labeled_statement -> CASE constant_expression COLON pragmacomp_or_statement','labeled_statement',4,'p_labeled_statement_2','c_parser.py',1489),
+  ('labeled_statement -> DEFAULT COLON pragmacomp_or_statement','labeled_statement',3,'p_labeled_statement_3','c_parser.py',1493),
+  ('selection_statement -> IF LPAREN expression RPAREN pragmacomp_or_statement','selection_statement',5,'p_selection_statement_1','c_parser.py',1497),
+  ('selection_statement -> IF LPAREN expression RPAREN statement ELSE pragmacomp_or_statement','selection_statement',7,'p_selection_statement_2','c_parser.py',1501),
+  ('selection_statement -> SWITCH LPAREN expression RPAREN pragmacomp_or_statement','selection_statement',5,'p_selection_statement_3','c_parser.py',1505),
+  ('iteration_statement -> WHILE LPAREN expression RPAREN pragmacomp_or_statement','iteration_statement',5,'p_iteration_statement_1','c_parser.py',1510),
+  ('iteration_statement -> DO pragmacomp_or_statement WHILE LPAREN expression RPAREN SEMI','iteration_statement',7,'p_iteration_statement_2','c_parser.py',1514),
+  ('iteration_statement -> FOR LPAREN expression_opt SEMI expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement','iteration_statement',9,'p_iteration_statement_3','c_parser.py',1518),
+  ('iteration_statement -> FOR LPAREN declaration expression_opt SEMI expression_opt RPAREN pragmacomp_or_statement','iteration_statement',8,'p_iteration_statement_4','c_parser.py',1522),
+  ('jump_statement -> GOTO ID SEMI','jump_statement',3,'p_jump_statement_1','c_parser.py',1527),
+  ('jump_statement -> BREAK SEMI','jump_statement',2,'p_jump_statement_2','c_parser.py',1531),
+  ('jump_statement -> CONTINUE SEMI','jump_statement',2,'p_jump_statement_3','c_parser.py',1535),
+  ('jump_statement -> RETURN expression SEMI','jump_statement',3,'p_jump_statement_4','c_parser.py',1539),
+  ('jump_statement -> RETURN SEMI','jump_statement',2,'p_jump_statement_4','c_parser.py',1540),
+  ('expression_statement -> expression_opt SEMI','expression_statement',2,'p_expression_statement','c_parser.py',1545),
+  ('expression -> assignment_expression','expression',1,'p_expression','c_parser.py',1552),
+  ('expression -> expression COMMA assignment_expression','expression',3,'p_expression','c_parser.py',1553),
+  ('typedef_name -> TYPEID','typedef_name',1,'p_typedef_name','c_parser.py',1565),
+  ('assignment_expression -> conditional_expression','assignment_expression',1,'p_assignment_expression','c_parser.py',1569),
+  ('assignment_expression -> unary_expression assignment_operator assignment_expression','assignment_expression',3,'p_assignment_expression','c_parser.py',1570),
+  ('assignment_operator -> EQUALS','assignment_operator',1,'p_assignment_operator','c_parser.py',1583),
+  ('assignment_operator -> XOREQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1584),
+  ('assignment_operator -> TIMESEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1585),
+  ('assignment_operator -> DIVEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1586),
+  ('assignment_operator -> MODEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1587),
+  ('assignment_operator -> PLUSEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1588),
+  ('assignment_operator -> MINUSEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1589),
+  ('assignment_operator -> LSHIFTEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1590),
+  ('assignment_operator -> RSHIFTEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1591),
+  ('assignment_operator -> ANDEQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1592),
+  ('assignment_operator -> OREQUAL','assignment_operator',1,'p_assignment_operator','c_parser.py',1593),
+  ('constant_expression -> conditional_expression','constant_expression',1,'p_constant_expression','c_parser.py',1598),
+  ('conditional_expression -> binary_expression','conditional_expression',1,'p_conditional_expression','c_parser.py',1602),
+  ('conditional_expression -> binary_expression CONDOP expression COLON conditional_expression','conditional_expression',5,'p_conditional_expression','c_parser.py',1603),
+  ('binary_expression -> cast_expression','binary_expression',1,'p_binary_expression','c_parser.py',1611),
+  ('binary_expression -> binary_expression TIMES binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1612),
+  ('binary_expression -> binary_expression DIVIDE binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1613),
+  ('binary_expression -> binary_expression MOD binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1614),
+  ('binary_expression -> binary_expression PLUS binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1615),
+  ('binary_expression -> binary_expression MINUS binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1616),
+  ('binary_expression -> binary_expression RSHIFT binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1617),
+  ('binary_expression -> binary_expression LSHIFT binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1618),
+  ('binary_expression -> binary_expression LT binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1619),
+  ('binary_expression -> binary_expression LE binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1620),
+  ('binary_expression -> binary_expression GE binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1621),
+  ('binary_expression -> binary_expression GT binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1622),
+  ('binary_expression -> binary_expression EQ binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1623),
+  ('binary_expression -> binary_expression NE binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1624),
+  ('binary_expression -> binary_expression AND binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1625),
+  ('binary_expression -> binary_expression OR binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1626),
+  ('binary_expression -> binary_expression XOR binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1627),
+  ('binary_expression -> binary_expression LAND binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1628),
+  ('binary_expression -> binary_expression LOR binary_expression','binary_expression',3,'p_binary_expression','c_parser.py',1629),
+  ('cast_expression -> unary_expression','cast_expression',1,'p_cast_expression_1','c_parser.py',1637),
+  ('cast_expression -> LPAREN type_name RPAREN cast_expression','cast_expression',4,'p_cast_expression_2','c_parser.py',1641),
+  ('unary_expression -> postfix_expression','unary_expression',1,'p_unary_expression_1','c_parser.py',1645),
+  ('unary_expression -> PLUSPLUS unary_expression','unary_expression',2,'p_unary_expression_2','c_parser.py',1649),
+  ('unary_expression -> MINUSMINUS unary_expression','unary_expression',2,'p_unary_expression_2','c_parser.py',1650),
+  ('unary_expression -> unary_operator cast_expression','unary_expression',2,'p_unary_expression_2','c_parser.py',1651),
+  ('unary_expression -> SIZEOF unary_expression','unary_expression',2,'p_unary_expression_3','c_parser.py',1656),
+  ('unary_expression -> SIZEOF LPAREN type_name RPAREN','unary_expression',4,'p_unary_expression_3','c_parser.py',1657),
+  ('unary_operator -> AND','unary_operator',1,'p_unary_operator','c_parser.py',1665),
+  ('unary_operator -> TIMES','unary_operator',1,'p_unary_operator','c_parser.py',1666),
+  ('unary_operator -> PLUS','unary_operator',1,'p_unary_operator','c_parser.py',1667),
+  ('unary_operator -> MINUS','unary_operator',1,'p_unary_operator','c_parser.py',1668),
+  ('unary_operator -> NOT','unary_operator',1,'p_unary_operator','c_parser.py',1669),
+  ('unary_operator -> LNOT','unary_operator',1,'p_unary_operator','c_parser.py',1670),
+  ('postfix_expression -> primary_expression','postfix_expression',1,'p_postfix_expression_1','c_parser.py',1675),
+  ('postfix_expression -> postfix_expression LBRACKET expression RBRACKET','postfix_expression',4,'p_postfix_expression_2','c_parser.py',1679),
+  ('postfix_expression -> postfix_expression LPAREN argument_expression_list RPAREN','postfix_expression',4,'p_postfix_expression_3','c_parser.py',1683),
+  ('postfix_expression -> postfix_expression LPAREN RPAREN','postfix_expression',3,'p_postfix_expression_3','c_parser.py',1684),
+  ('postfix_expression -> postfix_expression PERIOD ID','postfix_expression',3,'p_postfix_expression_4','c_parser.py',1689),
+  ('postfix_expression -> postfix_expression PERIOD TYPEID','postfix_expression',3,'p_postfix_expression_4','c_parser.py',1690),
+  ('postfix_expression -> postfix_expression ARROW ID','postfix_expression',3,'p_postfix_expression_4','c_parser.py',1691),
+  ('postfix_expression -> postfix_expression ARROW TYPEID','postfix_expression',3,'p_postfix_expression_4','c_parser.py',1692),
+  ('postfix_expression -> postfix_expression PLUSPLUS','postfix_expression',2,'p_postfix_expression_5','c_parser.py',1698),
+  ('postfix_expression -> postfix_expression MINUSMINUS','postfix_expression',2,'p_postfix_expression_5','c_parser.py',1699),
+  ('postfix_expression -> LPAREN type_name RPAREN brace_open initializer_list brace_close','postfix_expression',6,'p_postfix_expression_6','c_parser.py',1704),
+  ('postfix_expression -> LPAREN type_name RPAREN brace_open initializer_list COMMA brace_close','postfix_expression',7,'p_postfix_expression_6','c_parser.py',1705),
+  ('primary_expression -> identifier','primary_expression',1,'p_primary_expression_1','c_parser.py',1710),
+  ('primary_expression -> constant','primary_expression',1,'p_primary_expression_2','c_parser.py',1714),
+  ('primary_expression -> unified_string_literal','primary_expression',1,'p_primary_expression_3','c_parser.py',1718),
+  ('primary_expression -> unified_wstring_literal','primary_expression',1,'p_primary_expression_3','c_parser.py',1719),
+  ('primary_expression -> LPAREN expression RPAREN','primary_expression',3,'p_primary_expression_4','c_parser.py',1724),
+  ('primary_expression -> OFFSETOF LPAREN type_name COMMA offsetof_member_designator RPAREN','primary_expression',6,'p_primary_expression_5','c_parser.py',1728),
+  ('offsetof_member_designator -> identifier','offsetof_member_designator',1,'p_offsetof_member_designator','c_parser.py',1736),
+  ('offsetof_member_designator -> offsetof_member_designator PERIOD identifier','offsetof_member_designator',3,'p_offsetof_member_designator','c_parser.py',1737),
+  ('offsetof_member_designator -> offsetof_member_designator LBRACKET expression RBRACKET','offsetof_member_designator',4,'p_offsetof_member_designator','c_parser.py',1738),
+  ('argument_expression_list -> assignment_expression','argument_expression_list',1,'p_argument_expression_list','c_parser.py',1751),
+  ('argument_expression_list -> argument_expression_list COMMA assignment_expression','argument_expression_list',3,'p_argument_expression_list','c_parser.py',1752),
+  ('identifier -> ID','identifier',1,'p_identifier','c_parser.py',1761),
+  ('constant -> INT_CONST_DEC','constant',1,'p_constant_1','c_parser.py',1765),
+  ('constant -> INT_CONST_OCT','constant',1,'p_constant_1','c_parser.py',1766),
+  ('constant -> INT_CONST_HEX','constant',1,'p_constant_1','c_parser.py',1767),
+  ('constant -> INT_CONST_BIN','constant',1,'p_constant_1','c_parser.py',1768),
+  ('constant -> FLOAT_CONST','constant',1,'p_constant_2','c_parser.py',1774),
+  ('constant -> HEX_FLOAT_CONST','constant',1,'p_constant_2','c_parser.py',1775),
+  ('constant -> CHAR_CONST','constant',1,'p_constant_3','c_parser.py',1791),
+  ('constant -> WCHAR_CONST','constant',1,'p_constant_3','c_parser.py',1792),
+  ('unified_string_literal -> STRING_LITERAL','unified_string_literal',1,'p_unified_string_literal','c_parser.py',1803),
+  ('unified_string_literal -> unified_string_literal STRING_LITERAL','unified_string_literal',2,'p_unified_string_literal','c_parser.py',1804),
+  ('unified_wstring_literal -> WSTRING_LITERAL','unified_wstring_literal',1,'p_unified_wstring_literal','c_parser.py',1814),
+  ('unified_wstring_literal -> unified_wstring_literal WSTRING_LITERAL','unified_wstring_literal',2,'p_unified_wstring_literal','c_parser.py',1815),
+  ('brace_open -> LBRACE','brace_open',1,'p_brace_open','c_parser.py',1825),
+  ('brace_close -> RBRACE','brace_close',1,'p_brace_close','c_parser.py',1831),
+  ('empty -> <empty>','empty',0,'p_empty','c_parser.py',1837),
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/DESCRIPTION.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/DESCRIPTION.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e8c82879d0855a04429ce231be62a443d822d6ad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/DESCRIPTION.rst
@@ -0,0 +1,30 @@
+
+PyMacaroons
+===========
+
+PyMacaroons is a Python implementation of Macaroons. *They're better than cookies!*
+
+Installation
+------------
+
+Install PyMacaroons by running:
+
+    pip install pymacaroons
+
+Contribute
+----------
+
+- `Issue Tracker`_
+- `Source Code`_
+
+.. _Issue Tracker: https://github.com/ecordell/pymacaroons/issues
+.. _Source Code: https://github.com/ecordell/pymacaroons
+
+License
+-------
+
+The project is licensed under the MIT license.
+
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..da55ab37f2f1ef5a4f1479a34341ee8af2dc14de
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/METADATA
@@ -0,0 +1,59 @@
+Metadata-Version: 2.0
+Name: pymacaroons
+Version: 0.13.0
+Summary: Macaroon library for Python
+Home-page: https://github.com/ecordell/pymacaroons
+Author: Evan Cordell
+Author-email: cordell.evan@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Security
+Requires-Dist: PyNaCl (>=1.1.2,<2.0)
+Requires-Dist: six (>=1.8.0)
+
+
+PyMacaroons
+===========
+
+PyMacaroons is a Python implementation of Macaroons. *They're better than cookies!*
+
+Installation
+------------
+
+Install PyMacaroons by running:
+
+    pip install pymacaroons
+
+Contribute
+----------
+
+- `Issue Tracker`_
+- `Source Code`_
+
+.. _Issue Tracker: https://github.com/ecordell/pymacaroons/issues
+.. _Source Code: https://github.com/ecordell/pymacaroons
+
+License
+-------
+
+The project is licensed under the MIT license.
+
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..8d74cdce86a3c5460330dbf2f6a1e7015db3bb0b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/RECORD
@@ -0,0 +1,51 @@
+pymacaroons-0.13.0.dist-info/DESCRIPTION.rst,sha256=_DcZ3rDKf9o6yVhi6Mge9sTOarjzWoqrJ32iYwqNRVw,452
+pymacaroons-0.13.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pymacaroons-0.13.0.dist-info/METADATA,sha256=UeOvPeTkF3coCuSo7jqCyieE-gox9TofOWvTvLNA5Hs,1578
+pymacaroons-0.13.0.dist-info/RECORD,,
+pymacaroons-0.13.0.dist-info/WHEEL,sha256=o2k-Qa-RMNIJmUdIc7KU6VWR_ErNRbWNlxDIpl7lm34,110
+pymacaroons-0.13.0.dist-info/metadata.json,sha256=CtcGWEPnTOoIwBcqdOvRWEtrqE1NgEAhyyCJvh-Xjk0,1200
+pymacaroons-0.13.0.dist-info/top_level.txt,sha256=2QDsmWBOboaTSQ0J7B0QX2mc0tg7v5SdScvW-rq_Wwo,12
+pymacaroons/__init__.py,sha256=gXqicEcga74IxYacb9tSqMpK8G_JOAeVn3_83bMdbm0,391
+pymacaroons/__pycache__/__init__.cpython-38.pyc,,
+pymacaroons/__pycache__/caveat.cpython-38.pyc,,
+pymacaroons/__pycache__/exceptions.cpython-38.pyc,,
+pymacaroons/__pycache__/macaroon.cpython-38.pyc,,
+pymacaroons/__pycache__/utils.cpython-38.pyc,,
+pymacaroons/__pycache__/verifier.cpython-38.pyc,,
+pymacaroons/binders/__init__.py,sha256=7HjW8FwqQ6hoviQIxL8ekLKo9L6VNOiTSuXLiQcx2_0,154
+pymacaroons/binders/__pycache__/__init__.cpython-38.pyc,,
+pymacaroons/binders/__pycache__/base_binder.cpython-38.pyc,,
+pymacaroons/binders/__pycache__/hash_signatures_binder.cpython-38.pyc,,
+pymacaroons/binders/base_binder.py,sha256=IucuZaz88GMSVAZ1SjSyWNqI0e7cvkkSMMKUrM5rDCs,398
+pymacaroons/binders/hash_signatures_binder.py,sha256=4FPRFvTxJWAJF6qUjej1XnGmzTX5LFGsGpUROCF4rJ0,523
+pymacaroons/caveat.py,sha256=gVOwjFmJ38T5ke41Vb4O2Lt_3_NgbX3o6xpGotaDZ38,1974
+pymacaroons/caveat_delegates/__init__.py,sha256=hm5XL3-7tbE0OJeJ2VgpB6qH2QeFuNSE12t9oyb_Gb8,561
+pymacaroons/caveat_delegates/__pycache__/__init__.cpython-38.pyc,,
+pymacaroons/caveat_delegates/__pycache__/base_first_party.cpython-38.pyc,,
+pymacaroons/caveat_delegates/__pycache__/base_third_party.cpython-38.pyc,,
+pymacaroons/caveat_delegates/__pycache__/encrypted_first_party.cpython-38.pyc,,
+pymacaroons/caveat_delegates/__pycache__/first_party.cpython-38.pyc,,
+pymacaroons/caveat_delegates/__pycache__/third_party.cpython-38.pyc,,
+pymacaroons/caveat_delegates/base_first_party.py,sha256=qmDVudedRAsm7c4s5tUgCHg_RArUdN2TUJXEVXscs4I,754
+pymacaroons/caveat_delegates/base_third_party.py,sha256=-CDFbkxb9OYSTG-fq7N1FMY-RicDOn23tvKMVAhva7E,1162
+pymacaroons/caveat_delegates/encrypted_first_party.py,sha256=2bd3wCG4zKEzeupj0QG8diIYb8JPLY_Sz-f0lQ9s4rs,2061
+pymacaroons/caveat_delegates/first_party.py,sha256=UGkdgYhVR-o3BJTrk_3f0JRq137fSMTbt4RDbHIuGt8,1690
+pymacaroons/caveat_delegates/third_party.py,sha256=LGgG-ReJ7-vMXQ0bN0iLgtqjwFHys0g_iMXZaunIvvk,3500
+pymacaroons/exceptions.py,sha256=FlQW20Y4OSIgjbsRL28yltV7-l2bVv4MyO4MbY_sHZE,488
+pymacaroons/field_encryptors/__init__.py,sha256=WXBu-YLzVqWFGYshORtnCojui2b8QCGASwyDqeBl3cM,173
+pymacaroons/field_encryptors/__pycache__/__init__.cpython-38.pyc,,
+pymacaroons/field_encryptors/__pycache__/base_field_encryptor.cpython-38.pyc,,
+pymacaroons/field_encryptors/__pycache__/secret_box_encryptor.cpython-38.pyc,,
+pymacaroons/field_encryptors/base_field_encryptor.py,sha256=vqclTMp4xOJuT51XxDOu3e9ZKcvWsXRDhI7XWWA9Eco,584
+pymacaroons/field_encryptors/secret_box_encryptor.py,sha256=dFXFTSI9KeMtxT65oTagniIhmpGL-iLoXadu5g8l_kE,1080
+pymacaroons/macaroon.py,sha256=0r_woXoBYDU3lzi20OSDSMb5kP7TgLTuumUZ-OyI33w,4961
+pymacaroons/serializers/__init__.py,sha256=iXtNCad8vptOlHeKoeNjiFEoXFhiEKcJG83Z2K6Srlo,219
+pymacaroons/serializers/__pycache__/__init__.cpython-38.pyc,,
+pymacaroons/serializers/__pycache__/base_serializer.cpython-38.pyc,,
+pymacaroons/serializers/__pycache__/binary_serializer.cpython-38.pyc,,
+pymacaroons/serializers/__pycache__/json_serializer.cpython-38.pyc,,
+pymacaroons/serializers/base_serializer.py,sha256=L5csgK9rjgH3J3Vc-1wU209vWqE7zdqYbCe5pyauxSs,242
+pymacaroons/serializers/binary_serializer.py,sha256=qI5XVmYJTbd1jWP_sPIvmOBRViMAqw8C_njBPqu0H98,12592
+pymacaroons/serializers/json_serializer.py,sha256=EUPluHmorXJBT-iC5eAW50tMS2wCGFHBDZ34V-Q8Ugc,5973
+pymacaroons/utils.py,sha256=kWN2HZJJan1-8yZj8M3tjyLDcxQf7GwuIP9Ial5Obw4,3271
+pymacaroons/verifier.py,sha256=HqBUw6ityVpEvlJTxzlbkzDW5Ah__jVhH9k6otcyQew,4177
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..8b6dd1b5a884bfc07b5f771ab5dc56ed02323531
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.29.0)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/metadata.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/metadata.json
new file mode 100644
index 0000000000000000000000000000000000000000..8050779c5cdb613e7a010c4678164578ba1cc82f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/metadata.json
@@ -0,0 +1 @@
+{"classifiers": ["Development Status :: 4 - Beta", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy", "Topic :: Internet :: WWW/HTTP", "Topic :: Security :: Cryptography", "Topic :: Security"], "extensions": {"python.details": {"contacts": [{"email": "cordell.evan@gmail.com", "name": "Evan Cordell", "role": "author"}], "document_names": {"description": "DESCRIPTION.rst"}, "project_urls": {"Home": "https://github.com/ecordell/pymacaroons"}}}, "extras": [], "generator": "bdist_wheel (0.29.0)", "license": "MIT", "metadata_version": "2.0", "name": "pymacaroons", "run_requires": [{"requires": ["PyNaCl (>=1.1.2,<2.0)", "six (>=1.8.0)"]}], "summary": "Macaroon library for Python", "version": "0.13.0"}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f249e7da8ece5d8f38e27076a005755103ebdd6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons-0.13.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+pymacaroons
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..832cf89822757a7a24fcd1f2450e993977383250
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/__init__.py
@@ -0,0 +1,21 @@
+from .caveat import Caveat
+from .macaroon import Macaroon
+from .macaroon import MACAROON_V1
+from .macaroon import MACAROON_V2
+from .verifier import Verifier
+
+
+__all__ = [
+    'Macaroon',
+    'Caveat',
+    'Verifier',
+    'MACAROON_V1',
+    'MACAROON_V2'
+]
+
+
+__author__ = 'Evan Cordell'
+
+__version__ = "0.13.0"
+__version_info__ = tuple(__version__.split('.'))
+__short_version__ = __version__
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..02f75a90b68717756acac7e4db59a18957a7defb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/__init__.py
@@ -0,0 +1,7 @@
+from .base_binder import BaseBinder
+from .hash_signatures_binder import HashSignaturesBinder
+
+__all__ = [
+    'BaseBinder',
+    'HashSignaturesBinder',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/base_binder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/base_binder.py
new file mode 100644
index 0000000000000000000000000000000000000000..a600f01c03796807396e7dd1f0e43c4f71c6611a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/base_binder.py
@@ -0,0 +1,17 @@
+from abc import ABCMeta, abstractmethod
+
+
+class BaseBinder(object):
+    __metaclass__ = ABCMeta
+
+    def __init__(self, root):
+        self.root = root
+
+    def bind(self, discharge):
+        protected = discharge.copy()
+        protected.signature = self.bind_signature(discharge.signature_bytes)
+        return protected
+
+    @abstractmethod
+    def bind_signature(self, signature):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/hash_signatures_binder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/hash_signatures_binder.py
new file mode 100644
index 0000000000000000000000000000000000000000..435dc69f5f9c934f89344e62b86e324aaf3c963d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/binders/hash_signatures_binder.py
@@ -0,0 +1,18 @@
+import binascii
+
+from pymacaroons.binders.base_binder import BaseBinder
+from pymacaroons.utils import hmac_concat, truncate_or_pad
+
+
+class HashSignaturesBinder(BaseBinder):
+
+    def __init__(self, root, key=None):
+        super(HashSignaturesBinder, self).__init__(root)
+        self.key = key or truncate_or_pad(b'\0')
+
+    def bind_signature(self, signature):
+        return hmac_concat(
+            self.key,
+            binascii.unhexlify(self.root.signature_bytes),
+            binascii.unhexlify(signature)
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1dbf0853c87f5644b8089d4292b9223532cc51ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat.py
@@ -0,0 +1,70 @@
+from base64 import standard_b64encode
+
+from pymacaroons.utils import convert_to_string, convert_to_bytes
+
+
+class Caveat(object):
+
+    def __init__(self,
+                 caveat_id=None,
+                 verification_key_id=None,
+                 location=None,
+                 version=None):
+        from pymacaroons.macaroon import MACAROON_V1
+        self.caveat_id = caveat_id
+        self.verification_key_id = verification_key_id
+        self.location = location
+        if version is None:
+            version = MACAROON_V1
+        self._version = version
+
+    @property
+    def caveat_id(self):
+        from pymacaroons.macaroon import MACAROON_V1
+        if self._version == MACAROON_V1:
+            return convert_to_string(self._caveat_id)
+        return self._caveat_id
+
+    @property
+    def caveat_id_bytes(self):
+        return self._caveat_id
+
+    @property
+    def verification_key_id(self):
+        return self._verification_key_id
+
+    @property
+    def location(self):
+        return convert_to_string(self._location)
+
+    @caveat_id.setter
+    def caveat_id(self, value):
+        self._caveat_id = convert_to_bytes(value)
+
+    @verification_key_id.setter
+    def verification_key_id(self, value):
+        self._verification_key_id = convert_to_bytes(value)
+
+    @location.setter
+    def location(self, value):
+        self._location = convert_to_bytes(value)
+
+    def first_party(self):
+        return self._verification_key_id is None
+
+    def third_party(self):
+        return self._verification_key_id is not None
+
+    def to_dict(self):
+        try:
+            cid = convert_to_string(self.caveat_id)
+        except UnicodeEncodeError:
+            cid = convert_to_string(standard_b64encode(self.caveat_id_bytes))
+        return {
+            'cid': cid,
+            'vid': (
+                standard_b64encode(self.verification_key_id)
+                if self.verification_key_id else None
+            ),
+            'cl': self.location
+        }
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a2de3074ae2f4329269b2978617adcdd9f036a73
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/__init__.py
@@ -0,0 +1,20 @@
+from .first_party import (
+    FirstPartyCaveatDelegate, FirstPartyCaveatVerifierDelegate
+)
+from .encrypted_first_party import (
+    EncryptedFirstPartyCaveatDelegate,
+    EncryptedFirstPartyCaveatVerifierDelegate
+)
+from .third_party import (
+    ThirdPartyCaveatDelegate,
+    ThirdPartyCaveatVerifierDelegate
+)
+
+__all__ = [
+    'FirstPartyCaveatDelegate',
+    'FirstPartyCaveatVerifierDelegate',
+    'ThirdPartyCaveatDelegate',
+    'ThirdPartyCaveatVerifierDelegate',
+    'EncryptedFirstPartyCaveatDelegate',
+    'EncryptedFirstPartyCaveatVerifierDelegate',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_first_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_first_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..c61197ed4804dbfc6042f43e44a95e85c5d1eabd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_first_party.py
@@ -0,0 +1,29 @@
+from abc import ABCMeta, abstractmethod
+
+
+class BaseFirstPartyCaveatDelegate(object):
+    __metaclass__ = ABCMeta
+
+    def __init__(self, *args, **kwargs):
+        super(BaseFirstPartyCaveatDelegate, self).__init__(*args, **kwargs)
+
+    @abstractmethod
+    def add_first_party_caveat(self, macaroon, predicate, **kwargs):
+        pass
+
+
+class BaseFirstPartyCaveatVerifierDelegate(object):
+    __metaclass__ = ABCMeta
+
+    def __init__(self, *args, **kwargs):
+        super(BaseFirstPartyCaveatVerifierDelegate, self).__init__(
+            *args, **kwargs
+        )
+
+    @abstractmethod
+    def verify_first_party_caveat(self, verifier, caveat, signature):
+        pass
+
+    @abstractmethod
+    def update_signature(self, signature, caveat):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_third_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_third_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4c93766f524157bd9d21084a96cdd1e306af4b7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/base_third_party.py
@@ -0,0 +1,40 @@
+from abc import ABCMeta, abstractmethod
+
+
+class BaseThirdPartyCaveatDelegate(object):
+    __metaclass__ = ABCMeta
+
+    def __init__(self, *args, **kwargs):
+        super(BaseThirdPartyCaveatDelegate, self).__init__(*args, **kwargs)
+
+    @abstractmethod
+    def add_third_party_caveat(self,
+                               macaroon,
+                               location,
+                               key,
+                               key_id,
+                               **kwargs):
+        pass
+
+
+class BaseThirdPartyCaveatVerifierDelegate(object):
+    __metaclass__ = ABCMeta
+
+    def __init__(self, *args, **kwargs):
+        super(BaseThirdPartyCaveatVerifierDelegate, self).__init__(
+            *args, **kwargs
+        )
+
+    @abstractmethod
+    def verify_third_party_caveat(self,
+                                  verifier,
+                                  caveat,
+                                  root,
+                                  macaroon,
+                                  discharge_macaroons,
+                                  signature):
+        pass
+
+    @abstractmethod
+    def update_signature(self, signature, caveat):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/encrypted_first_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/encrypted_first_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..97eb353ef801550f48f8636a9c3eac8fb194fe93
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/encrypted_first_party.py
@@ -0,0 +1,58 @@
+from __future__ import unicode_literals
+import binascii
+
+from six import iteritems
+from pymacaroons.field_encryptors import SecretBoxEncryptor
+
+from .first_party import (
+    FirstPartyCaveatDelegate, FirstPartyCaveatVerifierDelegate
+)
+
+
+class EncryptedFirstPartyCaveatDelegate(FirstPartyCaveatDelegate):
+
+    def __init__(self, field_encryptor=None, *args, **kwargs):
+        self.field_encryptor = field_encryptor or SecretBoxEncryptor()
+        super(EncryptedFirstPartyCaveatDelegate, self).__init__(
+            *args, **kwargs
+        )
+
+    def add_first_party_caveat(self, macaroon, predicate, **kwargs):
+        if kwargs.get('encrypted'):
+            predicate = self.field_encryptor.encrypt(
+                binascii.unhexlify(macaroon.signature_bytes),
+                predicate
+            )
+        return super(EncryptedFirstPartyCaveatDelegate,
+                     self).add_first_party_caveat(macaroon,
+                                                  predicate,
+                                                  **kwargs)
+
+
+class EncryptedFirstPartyCaveatVerifierDelegate(
+        FirstPartyCaveatVerifierDelegate):
+
+    def __init__(self, field_encryptors=None, *args, **kwargs):
+        secret_box_encryptor = SecretBoxEncryptor()
+        self.field_encryptors = dict(
+            (f.signifier, f) for f in field_encryptors
+        ) if field_encryptors else {
+            secret_box_encryptor.signifier: secret_box_encryptor
+        }
+        super(EncryptedFirstPartyCaveatVerifierDelegate, self).__init__(
+            *args, **kwargs
+        )
+
+    def verify_first_party_caveat(self, verifier, caveat, signature):
+        predicate = caveat.caveat_id_bytes
+
+        for signifier, encryptor in iteritems(self.field_encryptors):
+            if predicate.startswith(signifier):
+                predicate = encryptor.decrypt(
+                    signature,
+                    predicate
+                )
+
+        caveat_met = sum(callback(predicate)
+                         for callback in verifier.callbacks)
+        return caveat_met
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/first_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/first_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..b44b8c4d3cb675b24cea7e7b0c3de09a1542de3d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/first_party.py
@@ -0,0 +1,51 @@
+from __future__ import unicode_literals
+import binascii
+
+from pymacaroons import Caveat
+from pymacaroons.utils import (
+    convert_to_string,
+    convert_to_bytes,
+    sign_first_party_caveat
+)
+
+from .base_first_party import (
+    BaseFirstPartyCaveatDelegate,
+    BaseFirstPartyCaveatVerifierDelegate
+)
+
+
+class FirstPartyCaveatDelegate(BaseFirstPartyCaveatDelegate):
+
+    def __init__(self, *args, **kwargs):
+        super(FirstPartyCaveatDelegate, self).__init__(*args, **kwargs)
+
+    def add_first_party_caveat(self, macaroon, predicate, **kwargs):
+        predicate = convert_to_bytes(predicate)
+        # Check it's valid utf-8 for first party caveats.
+        # Will raise a unicode error if not.
+        predicate.decode('utf-8')
+        caveat = Caveat(caveat_id=predicate, version=macaroon.version)
+        macaroon.caveats.append(caveat)
+        encode_key = binascii.unhexlify(macaroon.signature_bytes)
+        macaroon.signature = sign_first_party_caveat(encode_key, predicate)
+        return macaroon
+
+
+class FirstPartyCaveatVerifierDelegate(BaseFirstPartyCaveatVerifierDelegate):
+
+    def __init__(self, *args, **kwargs):
+        super(FirstPartyCaveatVerifierDelegate, self).__init__(*args, **kwargs)
+
+    def verify_first_party_caveat(self, verifier, caveat, signature):
+        predicate = convert_to_string(caveat.caveat_id)
+        caveat_met = sum(callback(predicate)
+                         for callback in verifier.callbacks)
+        return caveat_met
+
+    def update_signature(self, signature, caveat):
+        return binascii.unhexlify(
+            sign_first_party_caveat(
+                signature,
+                caveat.caveat_id_bytes
+            )
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/third_party.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/third_party.py
new file mode 100644
index 0000000000000000000000000000000000000000..7dfc5525d2075372069e57c001111a3a39e5eecc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/caveat_delegates/third_party.py
@@ -0,0 +1,106 @@
+from __future__ import unicode_literals
+import binascii
+
+from nacl.secret import SecretBox
+
+from pymacaroons import Caveat
+from pymacaroons.utils import (
+    convert_to_bytes,
+    truncate_or_pad,
+    generate_derived_key,
+    sign_third_party_caveat,
+)
+from pymacaroons.exceptions import MacaroonUnmetCaveatException
+from .base_third_party import (
+    BaseThirdPartyCaveatDelegate,
+    BaseThirdPartyCaveatVerifierDelegate,
+)
+
+
+class ThirdPartyCaveatDelegate(BaseThirdPartyCaveatDelegate):
+
+    def __init__(self, *args, **kwargs):
+        super(ThirdPartyCaveatDelegate, self).__init__(*args, **kwargs)
+
+    def add_third_party_caveat(self,
+                               macaroon,
+                               location,
+                               key,
+                               key_id,
+                               **kwargs):
+        derived_key = truncate_or_pad(
+            generate_derived_key(convert_to_bytes(key))
+        )
+        old_key = truncate_or_pad(binascii.unhexlify(macaroon.signature_bytes))
+        box = SecretBox(key=old_key)
+        verification_key_id = box.encrypt(
+            derived_key, nonce=kwargs.get('nonce')
+        )
+        caveat = Caveat(
+            caveat_id=key_id,
+            location=location,
+            verification_key_id=verification_key_id,
+            version=macaroon.version
+        )
+        macaroon.caveats.append(caveat)
+        encode_key = binascii.unhexlify(macaroon.signature_bytes)
+        macaroon.signature = sign_third_party_caveat(
+            encode_key,
+            caveat._verification_key_id,
+            caveat._caveat_id
+        )
+        return macaroon
+
+
+class ThirdPartyCaveatVerifierDelegate(BaseThirdPartyCaveatVerifierDelegate):
+
+    def __init__(self, *args, **kwargs):
+        super(ThirdPartyCaveatVerifierDelegate, self).__init__(*args, **kwargs)
+
+    def verify_third_party_caveat(self,
+                                  verifier,
+                                  caveat,
+                                  root,
+                                  macaroon,
+                                  discharge_macaroons,
+                                  signature):
+        caveat_macaroon = self._caveat_macaroon(caveat, discharge_macaroons)
+        caveat_key = self._extract_caveat_key(signature, caveat)
+
+        caveat_met = verifier.verify_discharge(
+            root,
+            caveat_macaroon,
+            caveat_key,
+            discharge_macaroons=discharge_macaroons
+        )
+
+        return caveat_met
+
+    def update_signature(self, signature, caveat):
+        return binascii.unhexlify(
+            sign_third_party_caveat(
+                signature,
+                caveat._verification_key_id,
+                caveat._caveat_id
+            )
+        )
+
+    def _caveat_macaroon(self, caveat, discharge_macaroons):
+        # TODO: index discharge macaroons by identifier
+        caveat_macaroon = next(
+            (m for m in discharge_macaroons
+             if m.identifier_bytes == caveat.caveat_id_bytes), None)
+
+        if not caveat_macaroon:
+            raise MacaroonUnmetCaveatException(
+                'Caveat not met. No discharge macaroon found for identifier: '
+                '{}'.format(caveat.caveat_id_bytes)
+            )
+
+        return caveat_macaroon
+
+    def _extract_caveat_key(self, signature, caveat):
+        key = truncate_or_pad(signature)
+        box = SecretBox(key=key)
+        decrypted = box.decrypt(caveat._verification_key_id)
+        return decrypted
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..f2509216a2d807d7ba036ab779b5437e2b745b2f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/exceptions.py
@@ -0,0 +1,26 @@
+class MacaroonException(Exception):
+    pass
+
+
+class MacaroonInitException(MacaroonException):
+    pass
+
+
+class MacaroonVerificationFailedException(MacaroonException):
+    pass
+
+
+class MacaroonInvalidSignatureException(MacaroonVerificationFailedException):
+    pass
+
+
+class MacaroonUnmetCaveatException(MacaroonVerificationFailedException):
+    pass
+
+
+class MacaroonSerializationException(MacaroonException):
+    pass
+
+
+class MacaroonDeserializationException(MacaroonException):
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..8db55566e23048acc4a8e81414a1d7f2448a7e29
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/__init__.py
@@ -0,0 +1,7 @@
+from .base_field_encryptor import BaseFieldEncryptor
+from .secret_box_encryptor import SecretBoxEncryptor
+
+__all__ = [
+    'BaseFieldEncryptor',
+    'SecretBoxEncryptor',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/base_field_encryptor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/base_field_encryptor.py
new file mode 100644
index 0000000000000000000000000000000000000000..4e456709c3b882d2bab8ba2d81721692761406f8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/base_field_encryptor.py
@@ -0,0 +1,22 @@
+from pymacaroons.utils import convert_to_bytes
+
+
+class BaseFieldEncryptor(object):
+
+    def __init__(self, signifier=None, nonce=None):
+        self.signifier = signifier or ''
+        self.nonce = nonce
+
+    @property
+    def signifier(self):
+        return convert_to_bytes(self._signifier)
+
+    @signifier.setter
+    def signifier(self, string_or_bytes):
+        self._signifier = convert_to_bytes(string_or_bytes)
+
+    def encrypt(self, signature, field_data):
+        raise NotImplementedError()
+
+    def decrypt(self, signature, field_data):
+        raise NotImplementedError()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/secret_box_encryptor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/secret_box_encryptor.py
new file mode 100644
index 0000000000000000000000000000000000000000..a625d127564f82234a2541f0d1b397f4d4c95d52
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/field_encryptors/secret_box_encryptor.py
@@ -0,0 +1,32 @@
+from base64 import standard_b64encode, standard_b64decode
+
+from nacl.secret import SecretBox
+
+from pymacaroons.field_encryptors.base_field_encryptor import (
+    BaseFieldEncryptor
+)
+from pymacaroons.utils import (
+    truncate_or_pad, convert_to_bytes, convert_to_string
+)
+
+
+class SecretBoxEncryptor(BaseFieldEncryptor):
+
+    def __init__(self, signifier=None, nonce=None):
+        super(SecretBoxEncryptor, self).__init__(
+            signifier=signifier or 'sbe::'
+        )
+        self.nonce = nonce
+
+    def encrypt(self, signature, field_data):
+        encrypt_key = truncate_or_pad(signature)
+        box = SecretBox(key=encrypt_key)
+        encrypted = box.encrypt(convert_to_bytes(field_data), nonce=self.nonce)
+        return self._signifier + standard_b64encode(encrypted)
+
+    def decrypt(self, signature, field_data):
+        key = truncate_or_pad(signature)
+        box = SecretBox(key=key)
+        encoded = convert_to_bytes(field_data[len(self.signifier):])
+        decrypted = box.decrypt(standard_b64decode(encoded))
+        return convert_to_string(decrypted)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/macaroon.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/macaroon.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e9ed3edf6f1d46e3fae432866c47b1fc968ae98
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/macaroon.py
@@ -0,0 +1,149 @@
+from __future__ import unicode_literals
+import copy
+from base64 import standard_b64encode
+
+from pymacaroons.binders import HashSignaturesBinder
+from pymacaroons.serializers.binary_serializer import BinarySerializer
+from pymacaroons.exceptions import MacaroonInitException
+from pymacaroons.utils import (
+    convert_to_bytes,
+    convert_to_string,
+    create_initial_signature
+)
+from pymacaroons.caveat_delegates import (
+    FirstPartyCaveatDelegate, ThirdPartyCaveatDelegate)
+
+MACAROON_V1 = 1
+MACAROON_V2 = 2
+
+
+class Macaroon(object):
+
+    def __init__(self,
+                 location=None,
+                 identifier=None,
+                 key=None,
+                 caveats=None,
+                 signature=None,
+                 version=MACAROON_V1):
+        if version > MACAROON_V2:
+            version = MACAROON_V2
+        self._version = version
+        self.caveats = caveats or []
+        self.location = location or ''
+        self.identifier = identifier or ''
+        self.signature = signature or ''
+        self.first_party_caveat_delegate = FirstPartyCaveatDelegate()
+        self.third_party_caveat_delegate = ThirdPartyCaveatDelegate()
+        if key:
+            self.signature = create_initial_signature(
+                convert_to_bytes(key), self.identifier_bytes
+            )
+
+    @classmethod
+    def deserialize(cls, serialized, serializer=None):
+        serializer = serializer or BinarySerializer()
+        if serialized:
+            return serializer.deserialize(serialized)
+        else:
+            raise MacaroonInitException(
+                'Must supply serialized macaroon.'
+            )
+
+    @property
+    def location(self):
+        return convert_to_string(self._location)
+
+    @location.setter
+    def location(self, string_or_bytes):
+        self._location = convert_to_bytes(string_or_bytes)
+
+    @property
+    def version(self):
+        return self._version
+
+    @property
+    def identifier(self):
+        if self.version == MACAROON_V1:
+            return convert_to_string(self._identifier)
+        return self._identifier
+
+    @property
+    def identifier_bytes(self):
+        return self._identifier
+
+    @identifier.setter
+    def identifier(self, string_or_bytes):
+        self._identifier = convert_to_bytes(string_or_bytes)
+
+    @property
+    def signature(self):
+        return convert_to_string(self._signature)
+
+    @signature.setter
+    def signature(self, string_or_bytes):
+        self._signature = convert_to_bytes(string_or_bytes)
+
+    @property
+    def signature_bytes(self):
+        return self._signature
+
+    def copy(self):
+        return copy.deepcopy(self)
+
+    def serialize(self, serializer=None):
+        serializer = serializer or BinarySerializer()
+        return serializer.serialize(self)
+
+    def inspect(self):
+        combined = 'location {loc}\n'.format(loc=self.location)
+        try:
+            combined += 'identifier {id}\n'.format(id=self.identifier)
+        except UnicodeEncodeError:
+            combined += 'identifier64 {id}\n'.format(id=convert_to_string(
+                    standard_b64encode(self.identifier_bytes)
+            ))
+        for caveat in self.caveats:
+            try:
+                combined += 'cid {cid}\n'.format(
+                    cid=convert_to_string(caveat.caveat_id))
+            except UnicodeEncodeError:
+                combined += 'cid64 {cid}\n'.format(cid=convert_to_string(
+                    standard_b64encode(caveat.caveat_id_bytes)
+                ))
+            if caveat.verification_key_id and caveat.location:
+                vid = convert_to_string(
+                    standard_b64encode(caveat.verification_key_id)
+                )
+                combined += 'vid {vid}\n'.format(vid=vid)
+                combined += 'cl {cl}\n'.format(cl=caveat.location)
+        combined += 'signature {sig}'.format(sig=self.signature)
+        return combined
+
+    def first_party_caveats(self):
+        return [caveat for caveat in self.caveats if caveat.first_party()]
+
+    def third_party_caveats(self):
+        return [caveat for caveat in self.caveats if caveat.third_party()]
+
+    def prepare_for_request(self, discharge_macaroon):
+        ''' Return a new discharge macaroon bound to the receiving macaroon's
+        current signature so that it can be used in a request.
+
+        This must be done before a discharge macaroon is sent to a server.
+
+        :param discharge_macaroon:
+        :return: bound discharge macaroon
+        '''
+        protected = discharge_macaroon.copy()
+        return HashSignaturesBinder(self).bind(protected)
+
+    def add_first_party_caveat(self, predicate, **kwargs):
+        return self.first_party_caveat_delegate.add_first_party_caveat(
+            self, predicate, **kwargs
+        )
+
+    def add_third_party_caveat(self, location, key, key_id, **kwargs):
+        return self.third_party_caveat_delegate.add_third_party_caveat(
+            self, location, key, key_id, **kwargs
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d598bf0428fe5fc083a71c9327f7c554a9505988
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/__init__.py
@@ -0,0 +1,9 @@
+from .base_serializer import BaseSerializer
+from .binary_serializer import BinarySerializer
+from .json_serializer import JsonSerializer
+
+__all__ = [
+    'BaseSerializer',
+    'BinarySerializer',
+    'JsonSerializer',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/base_serializer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/base_serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..c940e0874e31ed9f17ad529707c608ff21647a5b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/base_serializer.py
@@ -0,0 +1,13 @@
+from abc import ABCMeta, abstractmethod
+
+
+class BaseSerializer(object):
+    __metaclass__ = ABCMeta
+
+    @abstractmethod
+    def serialize(self, macaroon):
+        pass
+
+    @abstractmethod
+    def deserialize(self, serialized):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/binary_serializer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/binary_serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..1ebdb731dd3961ec8d4843a28b12e6e16fa51aad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/binary_serializer.py
@@ -0,0 +1,356 @@
+from __future__ import unicode_literals
+
+import binascii
+from collections import namedtuple
+import six
+import struct
+import sys
+from base64 import urlsafe_b64encode
+
+from pymacaroons.utils import (
+    convert_to_bytes,
+    convert_to_string,
+    raw_b64decode,
+)
+from pymacaroons.serializers.base_serializer import BaseSerializer
+from pymacaroons.exceptions import MacaroonSerializationException
+
+
+PacketV2 = namedtuple('PacketV2', ['field_type', 'data'])
+
+
+class BinarySerializer(BaseSerializer):
+
+    PACKET_PREFIX_LENGTH = 4
+    _LOCATION = 1
+    _IDENTIFIER = 2
+    _VID = 4
+    _SIGNATURE = 6
+    _EOS = 0
+
+    def serialize(self, macaroon):
+        return urlsafe_b64encode(
+            self.serialize_raw(macaroon)).decode('ascii').rstrip('=')
+
+    def serialize_raw(self, macaroon):
+        from pymacaroons.macaroon import MACAROON_V1
+        if macaroon.version == MACAROON_V1:
+            return self._serialize_v1(macaroon)
+        return self._serialize_v2(macaroon)
+
+    def _serialize_v1(self, macaroon):
+        combined = self._packetize(b'location', macaroon.location)
+        combined += self._packetize(b'identifier', macaroon.identifier)
+
+        for caveat in macaroon.caveats:
+            combined += self._packetize(b'cid', caveat._caveat_id)
+
+            if caveat._verification_key_id and caveat._location:
+                combined += self._packetize(
+                    b'vid', caveat._verification_key_id)
+                combined += self._packetize(b'cl', caveat._location)
+
+        combined += self._packetize(
+            b'signature',
+            binascii.unhexlify(macaroon.signature_bytes)
+        )
+        return combined
+
+    def _serialize_v2(self, macaroon):
+        from pymacaroons.macaroon import MACAROON_V2
+
+        # https://github.com/rescrv/libmacaroons/blob/master/doc/format.txt
+        data = bytearray()
+        data.append(MACAROON_V2)
+        if macaroon.location is not None:
+            self._append_packet(data, self._LOCATION, convert_to_bytes(
+                macaroon.location))
+            self._append_packet(data, self._IDENTIFIER,
+                                macaroon.identifier_bytes)
+        self._append_packet(data, self._EOS)
+        for c in macaroon.caveats:
+            if c.location is not None:
+                self._append_packet(data, self._LOCATION,
+                                    convert_to_bytes(c.location))
+            self._append_packet(data, self._IDENTIFIER, c.caveat_id_bytes)
+            if c.verification_key_id is not None:
+                self._append_packet(data, self._VID, convert_to_bytes(
+                    c.verification_key_id))
+            self._append_packet(data, self._EOS)
+        self._append_packet(data, self._EOS)
+        self._append_packet(data, self._SIGNATURE, binascii.unhexlify(
+            macaroon.signature_bytes))
+        return bytes(data)
+
+    def deserialize(self, serialized):
+        if len(serialized) == 0:
+            raise ValueError('empty macaroon')
+        serialized = convert_to_string(serialized)
+        decoded = raw_b64decode(serialized)
+        return self.deserialize_raw(decoded)
+
+    def deserialize_raw(self, serialized):
+        from pymacaroons.macaroon import MACAROON_V2
+        from pymacaroons.exceptions import MacaroonDeserializationException
+
+        first = six.byte2int(serialized[:1])
+        if first == MACAROON_V2:
+            return self._deserialize_v2(serialized)
+        if _is_ascii_hex(first):
+            return self._deserialize_v1(serialized)
+        raise MacaroonDeserializationException(
+            'cannot determine data format of binary-encoded macaroon')
+
+    def _deserialize_v1(self, decoded):
+        from pymacaroons.macaroon import Macaroon, MACAROON_V1
+        from pymacaroons.caveat import Caveat
+        from pymacaroons.exceptions import MacaroonDeserializationException
+
+        macaroon = Macaroon(version=MACAROON_V1)
+
+        index = 0
+
+        while index < len(decoded):
+            packet_length = int(
+                struct.unpack(
+                    b"4s",
+                    decoded[index:index + self.PACKET_PREFIX_LENGTH]
+                )[0],
+                16
+            )
+            packet = decoded[
+                index + self.PACKET_PREFIX_LENGTH:index + packet_length
+            ]
+
+            key, value = self._depacketize(packet)
+
+            if key == b'location':
+                macaroon.location = value
+            elif key == b'identifier':
+                macaroon.identifier = value
+            elif key == b'cid':
+                macaroon.caveats.append(Caveat(caveat_id=value,
+                                               version=MACAROON_V1))
+            elif key == b'vid':
+                macaroon.caveats[-1].verification_key_id = value
+            elif key == b'cl':
+                macaroon.caveats[-1].location = value
+            elif key == b'signature':
+                macaroon.signature = binascii.hexlify(value)
+            else:
+                raise MacaroonDeserializationException(
+                    'Key {key} not valid key for this format. '
+                    'Value: {value}'.format(
+                        key=key, value=value
+                    )
+                )
+
+            index = index + packet_length
+
+        return macaroon
+
+    def _deserialize_v2(self, serialized):
+        from pymacaroons.macaroon import Macaroon, MACAROON_V2
+        from pymacaroons.caveat import Caveat
+        from pymacaroons.exceptions import MacaroonDeserializationException
+
+        # skip the initial version byte.
+        serialized = serialized[1:]
+        serialized, section = self._parse_section_v2(serialized)
+        loc = ''
+        if len(section) > 0 and section[0].field_type == self._LOCATION:
+            loc = section[0].data.decode('utf-8')
+            section = section[1:]
+        if len(section) != 1 or section[0].field_type != self._IDENTIFIER:
+            raise MacaroonDeserializationException('invalid macaroon header')
+        macaroon = Macaroon(
+            identifier=section[0].data,
+            location=loc,
+            version=MACAROON_V2,
+        )
+        while True:
+            rest, section = self._parse_section_v2(serialized)
+            serialized = rest
+            if len(section) == 0:
+                break
+            cav = Caveat(version=MACAROON_V2)
+            if len(section) > 0 and section[0].field_type == self._LOCATION:
+                cav.location = section[0].data.decode('utf-8')
+                section = section[1:]
+
+            if len(section) == 0 or section[0].field_type != self._IDENTIFIER:
+                raise MacaroonDeserializationException(
+                    'no identifier in caveat')
+
+            cav.caveat_id = section[0].data
+            section = section[1:]
+            if len(section) == 0:
+                # First party caveat.
+                if cav.location is not None:
+                    raise MacaroonDeserializationException(
+                        'location not allowed in first party caveat')
+                macaroon.caveats.append(cav)
+                continue
+
+            if len(section) != 1:
+                raise MacaroonDeserializationException(
+                    'extra fields found in caveat')
+
+            if section[0].field_type != self._VID:
+                raise MacaroonDeserializationException(
+                    'invalid field found in caveat')
+            cav.verification_key_id = section[0].data
+            macaroon.caveats.append(cav)
+        serialized, packet = self._parse_packet_v2(serialized)
+        if packet.field_type != self._SIGNATURE:
+            raise MacaroonDeserializationException(
+                'unexpected field found instead of signature')
+        macaroon.signature = binascii.hexlify(packet.data)
+        return macaroon
+
+    def _packetize(self, key, data):
+        # The 2 covers the space and the newline
+        packet_size = self.PACKET_PREFIX_LENGTH + 2 + len(key) + len(data)
+        # Ignore the first two chars, 0x
+        packet_size_hex = hex(packet_size)[2:]
+
+        if packet_size > 65535:
+            raise MacaroonSerializationException(
+                'Packet too long for serialization. '
+                'Max length is 0xFFFF (65535). '
+                'Packet length: 0x{hex_length} ({length}) '
+                'Key: {key}'.format(
+                    key=key,
+                    hex_length=packet_size_hex,
+                    length=packet_size
+                )
+            )
+
+        header = packet_size_hex.zfill(4).encode('ascii')
+        packet_content = key + b' ' + convert_to_bytes(data) + b'\n'
+        packet = struct.pack(
+            convert_to_bytes("4s%ds" % len(packet_content)),
+            header,
+            packet_content
+        )
+        return packet
+
+    def _depacketize(self, packet):
+        key = packet.split(b' ')[0]
+        value = packet[len(key) + 1:-1]
+        return (key, value)
+
+    def _append_packet(self, data, field_type, packet_data=None):
+        _encode_uvarint(data, field_type)
+        if field_type != self._EOS:
+            _encode_uvarint(data, len(packet_data))
+            data.extend(packet_data)
+
+    def _parse_section_v2(self, data):
+        ''' Parses a sequence of packets in data.
+
+        The sequence is terminated by a packet with a field type of EOS
+        :param data bytes to be deserialized.
+        :return: the rest of data and an array of packet V2
+        '''
+
+        from pymacaroons.exceptions import MacaroonDeserializationException
+
+        prev_field_type = -1
+        packets = []
+        while True:
+            if len(data) == 0:
+                raise MacaroonDeserializationException(
+                    'section extends past end of buffer')
+            rest, packet = self._parse_packet_v2(data)
+            if packet.field_type == self._EOS:
+                return rest, packets
+            if packet.field_type <= prev_field_type:
+                raise MacaroonDeserializationException('fields out of order')
+            packets.append(packet)
+            prev_field_type = packet.field_type
+            data = rest
+
+    def _parse_packet_v2(self, data):
+        ''' Parses a V2 data packet at the start of the given data.
+
+        The format of a packet is as follows:
+
+        field_type(varint) payload_len(varint) data[payload_len bytes]
+
+        apart from EOS which has no payload_en or data (it's a single zero
+        byte).
+
+        :param data:
+        :return: rest of data, PacketV2
+        '''
+        from pymacaroons.exceptions import MacaroonDeserializationException
+
+        ft, n = _decode_uvarint(data)
+        data = data[n:]
+        if ft == self._EOS:
+            return data, PacketV2(ft, None)
+        payload_len, n = _decode_uvarint(data)
+        data = data[n:]
+        if payload_len > len(data):
+            raise MacaroonDeserializationException(
+                'field data extends past end of buffer')
+        return data[payload_len:], PacketV2(ft, data[0:payload_len])
+
+
+def _encode_uvarint(data, n):
+    ''' Encodes integer into variable-length format into data.'''
+    if n < 0:
+        raise ValueError('only support positive integer')
+    while True:
+        this_byte = n & 0x7f
+        n >>= 7
+        if n == 0:
+            data.append(this_byte)
+            break
+        data.append(this_byte | 0x80)
+
+
+if sys.version_info.major == 2:
+    def _decode_uvarint(data):
+        ''' Decode a variable -length integer.
+
+        Reads a sequence of unsigned integer byte and decodes them into an
+        integer in variable-length format and returns it and the length read.
+        '''
+        n = 0
+        shift = 0
+        i = 0
+        for b in data:
+            b = ord(b)
+            i += 1
+            if b < 0x80:
+                return n | b << shift, i
+            n |= (b & 0x7f) << shift
+            shift += 7
+        raise Exception('cannot read uvarint from buffer')
+else:
+    def _decode_uvarint(data):
+        ''' Decode a variable -length integer.
+
+        Reads a sequence of unsigned integer byte and decodes them into an
+        integer in variable-length format and returns it and the length read.
+        '''
+        n = 0
+        shift = 0
+        i = 0
+        for b in data:
+            i += 1
+            if b < 0x80:
+                return n | b << shift, i
+            n |= (b & 0x7f) << shift
+            shift += 7
+        raise Exception('cannot read uvarint from buffer')
+
+
+def _is_ascii_hex(b):
+    if ord('0') <= b <= ord('9'):
+        return True
+    if ord('a') <= b <= ord('f'):
+        return True
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/json_serializer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/json_serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..def585c044186a07938a8ae461314380b80c583a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/serializers/json_serializer.py
@@ -0,0 +1,181 @@
+import binascii
+import json
+from pymacaroons import utils
+
+
+class JsonSerializer(object):
+    '''Serializer used to produce JSON macaroon format v1.
+    '''
+    def serialize(self, m):
+        '''Serialize the macaroon in JSON format indicated by the version field.
+
+        @param macaroon the macaroon to serialize.
+        @return JSON macaroon.
+        '''
+        from pymacaroons import macaroon
+        if m.version == macaroon.MACAROON_V1:
+            return self._serialize_v1(m)
+        return self._serialize_v2(m)
+
+    def _serialize_v1(self, macaroon):
+        '''Serialize the macaroon in JSON format v1.
+
+        @param macaroon the macaroon to serialize.
+        @return JSON macaroon.
+        '''
+        serialized = {
+            'identifier': utils.convert_to_string(macaroon.identifier),
+            'signature': macaroon.signature,
+        }
+        if macaroon.location:
+            serialized['location'] = macaroon.location
+        if macaroon.caveats:
+            serialized['caveats'] = [
+                _caveat_v1_to_dict(caveat) for caveat in macaroon.caveats
+            ]
+        return json.dumps(serialized)
+
+    def _serialize_v2(self, macaroon):
+        '''Serialize the macaroon in JSON format v2.
+
+        @param macaroon the macaroon to serialize.
+        @return JSON macaroon in v2 format.
+        '''
+        serialized = {}
+        _add_json_binary_field(macaroon.identifier_bytes, serialized, 'i')
+        _add_json_binary_field(binascii.unhexlify(macaroon.signature_bytes),
+                               serialized, 's')
+
+        if macaroon.location:
+            serialized['l'] = macaroon.location
+        if macaroon.caveats:
+            serialized['c'] = [
+                _caveat_v2_to_dict(caveat) for caveat in macaroon.caveats
+            ]
+        return json.dumps(serialized)
+
+    def deserialize(self, serialized):
+        '''Deserialize a JSON macaroon depending on the format.
+
+        @param serialized the macaroon in JSON format.
+        @return the macaroon object.
+        '''
+        deserialized = json.loads(serialized)
+        if deserialized.get('identifier') is None:
+            return self._deserialize_v2(deserialized)
+        else:
+            return self._deserialize_v1(deserialized)
+
+    def _deserialize_v1(self, deserialized):
+        '''Deserialize a JSON macaroon in v1 format.
+
+        @param serialized the macaroon in v1 JSON format.
+        @return the macaroon object.
+        '''
+        from pymacaroons.macaroon import Macaroon, MACAROON_V1
+        from pymacaroons.caveat import Caveat
+
+        caveats = []
+        for c in deserialized.get('caveats', []):
+            caveat = Caveat(
+                caveat_id=c['cid'],
+                verification_key_id=(
+                    utils.raw_b64decode(c['vid']) if c.get('vid')
+                    else None
+                ),
+                location=(
+                    c['cl'] if c.get('cl') else None
+                ),
+                version=MACAROON_V1
+            )
+            caveats.append(caveat)
+
+        return Macaroon(
+            location=deserialized.get('location'),
+            identifier=deserialized['identifier'],
+            caveats=caveats,
+            signature=deserialized['signature'],
+            version=MACAROON_V1
+        )
+
+    def _deserialize_v2(self, deserialized):
+        '''Deserialize a JSON macaroon v2.
+
+        @param serialized the macaroon in JSON format v2.
+        @return the macaroon object.
+        '''
+        from pymacaroons.macaroon import Macaroon, MACAROON_V2
+        from pymacaroons.caveat import Caveat
+        caveats = []
+        for c in deserialized.get('c', []):
+            caveat = Caveat(
+                caveat_id=_read_json_binary_field(c, 'i'),
+                verification_key_id=_read_json_binary_field(c, 'v'),
+                location=_read_json_binary_field(c, 'l'),
+                version=MACAROON_V2
+            )
+            caveats.append(caveat)
+        return Macaroon(
+            location=_read_json_binary_field(deserialized, 'l'),
+            identifier=_read_json_binary_field(deserialized, 'i'),
+            caveats=caveats,
+            signature=binascii.hexlify(
+                _read_json_binary_field(deserialized, 's')),
+            version=MACAROON_V2
+        )
+
+
+def _caveat_v1_to_dict(c):
+    ''' Return a caveat as a dictionary for export as the JSON
+    macaroon v1 format.
+    '''
+    serialized = {}
+    if len(c.caveat_id) > 0:
+        serialized['cid'] = c.caveat_id
+    if c.verification_key_id:
+        serialized['vid'] = utils.raw_urlsafe_b64encode(
+            c.verification_key_id).decode('utf-8')
+    if c.location:
+        serialized['cl'] = c.location
+    return serialized
+
+
+def _caveat_v2_to_dict(c):
+    ''' Return a caveat as a dictionary for export as the JSON
+    macaroon v2 format.
+    '''
+    serialized = {}
+    if len(c.caveat_id_bytes) > 0:
+        _add_json_binary_field(c.caveat_id_bytes, serialized, 'i')
+    if c.verification_key_id:
+        _add_json_binary_field(c.verification_key_id, serialized, 'v')
+    if c.location:
+        serialized['l'] = c.location
+    return serialized
+
+
+def _add_json_binary_field(b, serialized, field):
+    ''' Set the given field to the given val (a bytearray) in the serialized
+    dictionary.
+
+    If the value isn't valid utf-8, we base64 encode it and use field+"64"
+    as the field name.
+    '''
+    try:
+        val = b.decode("utf-8")
+        serialized[field] = val
+    except UnicodeDecodeError:
+        val = utils.raw_urlsafe_b64encode(b).decode('utf-8')
+        serialized[field + '64'] = val
+
+
+def _read_json_binary_field(deserialized, field):
+    ''' Read the value of a JSON field that may be string or base64-encoded.
+    '''
+    val = deserialized.get(field)
+    if val is not None:
+        return utils.convert_to_bytes(val)
+    val = deserialized.get(field + '64')
+    if val is None:
+        return None
+    return utils.raw_urlsafe_b64decode(val)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..4c8145c0b59d76c70277baf585c37e33f4fa9651
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/utils.py
@@ -0,0 +1,131 @@
+import base64
+from hashlib import sha256
+import hmac
+import binascii
+
+from six import text_type, binary_type
+
+
+def convert_to_bytes(string_or_bytes):
+    if string_or_bytes is None:
+        return None
+    if isinstance(string_or_bytes, text_type):
+        return string_or_bytes.encode('utf-8')
+    elif isinstance(string_or_bytes, binary_type):
+        return string_or_bytes
+    else:
+        raise TypeError("Must be a string or bytes object.")
+
+
+def convert_to_string(string_or_bytes):
+    if string_or_bytes is None:
+        return None
+    if isinstance(string_or_bytes, text_type):
+        return string_or_bytes
+    elif isinstance(string_or_bytes, binary_type):
+        return string_or_bytes.decode('utf-8')
+    else:
+        raise TypeError("Must be a string or bytes object.")
+
+
+def truncate_or_pad(byte_string, size=None):
+    if size is None:
+        size = 32
+    byte_array = bytearray(byte_string)
+    length = len(byte_array)
+    if length > size:
+        return bytes(byte_array[:size])
+    elif length < size:
+        return bytes(byte_array + b"\0"*(size-length))
+    else:
+        return byte_string
+
+
+def generate_derived_key(key):
+    return hmac_digest(b'macaroons-key-generator', key)
+
+
+def hmac_digest(key, data):
+    return hmac.new(
+        key,
+        msg=data,
+        digestmod=sha256
+    ).digest()
+
+
+def hmac_hex(key, data):
+    dig = hmac_digest(key, data)
+    return binascii.hexlify(dig)
+
+
+def create_initial_signature(key, identifier):
+    derived_key = generate_derived_key(key)
+    return hmac_hex(derived_key, identifier)
+
+
+def hmac_concat(key, data1, data2):
+    hash1 = hmac_digest(key, data1)
+    hash2 = hmac_digest(key, data2)
+    return hmac_hex(key, hash1 + hash2)
+
+
+def sign_first_party_caveat(signature, predicate):
+    return hmac_hex(signature, predicate)
+
+
+def sign_third_party_caveat(signature, verification_id, caveat_id):
+    return hmac_concat(signature, verification_id, caveat_id)
+
+
+def equals(val1, val2):
+    """
+    Returns True if the two strings are equal, False otherwise.
+
+    The time taken is independent of the number of characters that match.
+
+    For the sake of simplicity, this function executes in constant time only
+    when the two strings have the same length. It short-circuits when they
+    have different lengths.
+    """
+    if len(val1) != len(val2):
+        return False
+    result = 0
+    for x, y in zip(val1, val2):
+        result |= ord(x) ^ ord(y)
+    return result == 0
+
+
+def add_base64_padding(b):
+    '''Add padding to base64 encoded bytes.
+
+    Padding can be removed when sending the messages.
+
+    @param b bytes to be padded.
+    @return a padded bytes.
+    '''
+    return b + b'=' * (-len(b) % 4)
+
+
+def raw_b64decode(s):
+    if '_' or '-' in s:
+        return raw_urlsafe_b64decode(s)
+    else:
+        return base64.b64decode(add_base64_padding(s))
+
+
+def raw_urlsafe_b64decode(s):
+    '''Base64 decode with added padding and conversion to bytes.
+
+    @param s string decode
+    @return bytes decoded
+    '''
+    return base64.urlsafe_b64decode(add_base64_padding(s.encode('utf-8')))
+
+
+def raw_urlsafe_b64encode(b):
+    '''Base64 encode with padding removed.
+
+    @param s string decode
+    @return bytes decoded
+    '''
+    return base64.urlsafe_b64encode(b).rstrip(b'=')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/verifier.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/verifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3475fff1a0e77951a6fd281054056bd1e88dc5e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pymacaroons/verifier.py
@@ -0,0 +1,127 @@
+import binascii
+
+try:
+    # py2.7.7+ and py3.3+ have native comparison support
+    from hmac import compare_digest as constant_time_compare
+except ImportError:
+    from pymacaroons.utils import equals as constant_time_compare
+
+from pymacaroons.binders import HashSignaturesBinder
+from pymacaroons.exceptions import MacaroonInvalidSignatureException
+from pymacaroons.caveat_delegates import (
+    FirstPartyCaveatVerifierDelegate,
+    ThirdPartyCaveatVerifierDelegate,
+)
+from pymacaroons.utils import (
+    convert_to_bytes,
+    convert_to_string,
+    generate_derived_key,
+    hmac_digest
+)
+
+
+class Verifier(object):
+
+    def __init__(self):
+        self.predicates = []
+        self.callbacks = [self.verify_exact]
+        self.calculated_signature = None
+        self.first_party_caveat_verifier_delegate = (
+            FirstPartyCaveatVerifierDelegate()
+        )
+        self.third_party_caveat_verifier_delegate = (
+            ThirdPartyCaveatVerifierDelegate()
+        )
+
+    def satisfy_exact(self, predicate):
+        if predicate is None:
+            raise TypeError('Predicate cannot be none.')
+        self.predicates.append(convert_to_string(predicate))
+
+    def satisfy_general(self, func):
+        if not hasattr(func, '__call__'):
+            raise TypeError('General caveat verifiers must be callable.')
+        self.callbacks.append(func)
+
+    def verify_exact(self, predicate):
+        return predicate in self.predicates
+
+    def verify(self, macaroon, key, discharge_macaroons=None):
+        key = generate_derived_key(convert_to_bytes(key))
+        return self.verify_discharge(
+            macaroon,
+            macaroon,
+            key,
+            discharge_macaroons
+        )
+
+    def verify_discharge(self, root, discharge, key, discharge_macaroons=None):
+        calculated_signature = hmac_digest(
+            key, discharge.identifier_bytes
+        )
+
+        calculated_signature = self._verify_caveats(
+            root, discharge, discharge_macaroons, calculated_signature
+        )
+
+        if root != discharge:
+            calculated_signature = binascii.unhexlify(
+                HashSignaturesBinder(root).bind_signature(
+                    binascii.hexlify(calculated_signature)
+                )
+            )
+
+        if not self._signatures_match(
+                discharge.signature_bytes,
+                binascii.hexlify(calculated_signature)):
+            raise MacaroonInvalidSignatureException('Signatures do not match')
+
+        return True
+
+    def _verify_caveats(self, root, macaroon, discharge_macaroons, signature):
+        for caveat in macaroon.caveats:
+            if self._caveat_met(root,
+                                caveat,
+                                macaroon,
+                                discharge_macaroons,
+                                signature):
+                signature = self._update_signature(caveat, signature)
+        return signature
+
+    def _caveat_met(self, root, caveat, macaroon,
+                    discharge_macaroons, signature):
+        if caveat.first_party():
+            return (
+                self
+                .first_party_caveat_verifier_delegate
+                .verify_first_party_caveat(self, caveat, signature)
+            )
+        else:
+            return (
+                self
+                .third_party_caveat_verifier_delegate
+                .verify_third_party_caveat(
+                    self, caveat, root, macaroon,
+                    discharge_macaroons, signature,
+                )
+            )
+
+    def _update_signature(self, caveat, signature):
+        if caveat.first_party():
+            return (
+                self
+                .first_party_caveat_verifier_delegate
+                .update_signature(signature, caveat)
+            )
+        else:
+            return (
+                self
+                .third_party_caveat_verifier_delegate
+                .update_signature(signature, caveat)
+            )
+
+    def _signatures_match(self, macaroon_signature, computed_signature):
+        return constant_time_compare(
+            convert_to_bytes(macaroon_signature),
+            convert_to_bytes(computed_signature)
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c827341d066e598f9a4a3f90fe0a6f04f52d7100
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/METADATA
@@ -0,0 +1,104 @@
+Metadata-Version: 2.1
+Name: pyparsing
+Version: 2.4.6
+Summary: Python parsing module
+Home-page: https://github.com/pyparsing/pyparsing/
+Author: Paul McGuire
+Author-email: ptmcg@users.sourceforge.net
+License: MIT License
+Download-URL: https://pypi.org/project/pyparsing/
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Requires-Python: >=2.6, !=3.0.*, !=3.1.*, !=3.2.*
+
+PyParsing -- A Python Parsing Module
+====================================
+
+|Build Status|
+
+Introduction
+============
+
+The pyparsing module is an alternative approach to creating and
+executing simple grammars, vs. the traditional lex/yacc approach, or the
+use of regular expressions. The pyparsing module provides a library of
+classes that client code uses to construct the grammar directly in
+Python code.
+
+*[Since first writing this description of pyparsing in late 2003, this
+technique for developing parsers has become more widespread, under the
+name Parsing Expression Grammars - PEGs. See more information on PEGs at*
+https://en.wikipedia.org/wiki/Parsing_expression_grammar *.]*
+
+Here is a program to parse ``"Hello, World!"`` (or any greeting of the form
+``"salutation, addressee!"``):
+
+.. code:: python
+
+    from pyparsing import Word, alphas
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+    hello = "Hello, World!"
+    print(hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the
+self-explanatory class names, and the use of '+', '|' and '^' operator
+definitions.
+
+The parsed results returned from ``parseString()`` can be accessed as a
+nested list, a dictionary, or an object with named attributes.
+
+The pyparsing module handles some of the problems that are typically
+vexing when writing text parsers:
+
+- extra or missing whitespace (the above program will also handle ``"Hello,World!"``, ``"Hello , World !"``, etc.)
+- quoted strings
+- embedded comments
+
+The examples directory includes a simple SQL parser, simple CORBA IDL
+parser, a config file parser, a chemical formula parser, and a four-
+function algebraic notation parser, among many others.
+
+Documentation
+=============
+
+There are many examples in the online docstrings of the classes
+and methods in pyparsing. You can find them compiled into online docs
+at https://pyparsing-docs.readthedocs.io/en/latest/. Additional
+documentation resources and project info are listed in the online
+GitHub wiki, at https://github.com/pyparsing/pyparsing/wiki. An
+entire directory of examples is at
+https://github.com/pyparsing/pyparsing/tree/master/examples.
+
+License
+=======
+
+MIT License. See header of pyparsing.py
+
+History
+=======
+
+See CHANGES file.
+
+.. |Build Status| image:: https://travis-ci.org/pyparsing/pyparsing.svg?branch=master
+   :target: https://travis-ci.org/pyparsing/pyparsing
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..ba4d371c9cf83d139df4c8efa2a66977399c3527
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/RECORD
@@ -0,0 +1,11 @@
+pyparsing.py,sha256=QpY03-YstMc9fIJS1T7-uKDASD_0_wdyBpOHdh6ThLw,272400
+pyparsing-2.4.6.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+pyparsing-2.4.6.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+pyparsing-2.4.6.dist-info/METADATA,sha256=l9eaWZ2eTYBnKxlz3wLV9YflJBpOiiv9l2zMl88rdYE,3636
+pyparsing-2.4.6.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pyparsing-2.4.6.dist-info/top_level.txt,sha256=eUOjGzJVhlQ3WS2rFAy2mN3LX_7FKTM5GSJ04jfnLmU,10
+pyparsing-2.4.6.dist-info/RECORD,,
+pyparsing-2.4.6.dist-info/INSTALLER,,
+pyparsing-2.4.6.dist-info/__pycache__,,
+pyparsing-2.4.6.virtualenv,,
+pyparsing.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..210dfec50b01975ca39665ff3a471976d8845d67
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.dist-info/top_level.txt
@@ -0,0 +1 @@
+pyparsing
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing-2.4.6.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d2f98e46e8a0be7184416d56321b03aa0eb0bae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyparsing.py
@@ -0,0 +1,7090 @@
+# -*- coding: utf-8 -*-
+# module pyparsing.py
+#
+# Copyright (c) 2003-2019  Paul T. McGuire
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+__doc__ = \
+"""
+pyparsing module - Classes and methods to define and execute parsing grammars
+=============================================================================
+
+The pyparsing module is an alternative approach to creating and
+executing simple grammars, vs. the traditional lex/yacc approach, or the
+use of regular expressions.  With pyparsing, you don't need to learn
+a new syntax for defining grammars or matching expressions - the parsing
+module provides a library of classes that you use to construct the
+grammar directly in Python.
+
+Here is a program to parse "Hello, World!" (or any greeting of the form
+``"<salutation>, <addressee>!"``), built up using :class:`Word`,
+:class:`Literal`, and :class:`And` elements
+(the :class:`'+'<ParserElement.__add__>` operators create :class:`And` expressions,
+and the strings are auto-converted to :class:`Literal` expressions)::
+
+    from pyparsing import Word, alphas
+
+    # define grammar of a greeting
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+
+    hello = "Hello, World!"
+    print (hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the
+self-explanatory class names, and the use of '+', '|' and '^' operators.
+
+The :class:`ParseResults` object returned from
+:class:`ParserElement.parseString` can be
+accessed as a nested list, a dictionary, or an object with named
+attributes.
+
+The pyparsing module handles some of the problems that are typically
+vexing when writing text parsers:
+
+  - extra or missing whitespace (the above program will also handle
+    "Hello,World!", "Hello  ,  World  !", etc.)
+  - quoted strings
+  - embedded comments
+
+
+Getting Started -
+-----------------
+Visit the classes :class:`ParserElement` and :class:`ParseResults` to
+see the base classes that most other pyparsing
+classes inherit from. Use the docstrings for examples of how to:
+
+ - construct literal match expressions from :class:`Literal` and
+   :class:`CaselessLiteral` classes
+ - construct character word-group expressions using the :class:`Word`
+   class
+ - see how to create repetitive expressions using :class:`ZeroOrMore`
+   and :class:`OneOrMore` classes
+ - use :class:`'+'<And>`, :class:`'|'<MatchFirst>`, :class:`'^'<Or>`,
+   and :class:`'&'<Each>` operators to combine simple expressions into
+   more complex ones
+ - associate names with your parsed results using
+   :class:`ParserElement.setResultsName`
+ - access the parsed data, which is returned as a :class:`ParseResults`
+   object
+ - find some helpful expression short-cuts like :class:`delimitedList`
+   and :class:`oneOf`
+ - find more useful common expressions in the :class:`pyparsing_common`
+   namespace class
+"""
+
+__version__ = "2.4.6"
+__versionTime__ = "24 Dec 2019 04:27 UTC"
+__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"
+
+import string
+from weakref import ref as wkref
+import copy
+import sys
+import warnings
+import re
+import sre_constants
+import collections
+import pprint
+import traceback
+import types
+from datetime import datetime
+from operator import itemgetter
+import itertools
+from functools import wraps
+from contextlib import contextmanager
+
+try:
+    # Python 3
+    from itertools import filterfalse
+except ImportError:
+    from itertools import ifilterfalse as filterfalse
+
+try:
+    from _thread import RLock
+except ImportError:
+    from threading import RLock
+
+try:
+    # Python 3
+    from collections.abc import Iterable
+    from collections.abc import MutableMapping, Mapping
+except ImportError:
+    # Python 2.7
+    from collections import Iterable
+    from collections import MutableMapping, Mapping
+
+try:
+    from collections import OrderedDict as _OrderedDict
+except ImportError:
+    try:
+        from ordereddict import OrderedDict as _OrderedDict
+    except ImportError:
+        _OrderedDict = None
+
+try:
+    from types import SimpleNamespace
+except ImportError:
+    class SimpleNamespace: pass
+
+# version compatibility configuration
+__compat__ = SimpleNamespace()
+__compat__.__doc__ = """
+    A cross-version compatibility configuration for pyparsing features that will be
+    released in a future version. By setting values in this configuration to True,
+    those features can be enabled in prior versions for compatibility development
+    and testing.
+
+     - collect_all_And_tokens - flag to enable fix for Issue #63 that fixes erroneous grouping
+       of results names when an And expression is nested within an Or or MatchFirst; set to
+       True to enable bugfix released in pyparsing 2.3.0, or False to preserve
+       pre-2.3.0 handling of named results
+"""
+__compat__.collect_all_And_tokens = True
+
+__diag__ = SimpleNamespace()
+__diag__.__doc__ = """
+Diagnostic configuration (all default to False)
+     - warn_multiple_tokens_in_named_alternation - flag to enable warnings when a results
+       name is defined on a MatchFirst or Or expression with one or more And subexpressions
+       (only warns if __compat__.collect_all_And_tokens is False)
+     - warn_ungrouped_named_tokens_in_collection - flag to enable warnings when a results
+       name is defined on a containing expression with ungrouped subexpressions that also
+       have results names
+     - warn_name_set_on_empty_Forward - flag to enable warnings whan a Forward is defined
+       with a results name, but has no contents defined
+     - warn_on_multiple_string_args_to_oneof - flag to enable warnings whan oneOf is
+       incorrectly called with multiple str arguments
+     - enable_debug_on_named_expressions - flag to auto-enable debug on all subsequent
+       calls to ParserElement.setName()
+"""
+__diag__.warn_multiple_tokens_in_named_alternation = False
+__diag__.warn_ungrouped_named_tokens_in_collection = False
+__diag__.warn_name_set_on_empty_Forward = False
+__diag__.warn_on_multiple_string_args_to_oneof = False
+__diag__.enable_debug_on_named_expressions = False
+__diag__._all_names = [nm for nm in vars(__diag__) if nm.startswith("enable_") or nm.startswith("warn_")]
+
+def _enable_all_warnings():
+    __diag__.warn_multiple_tokens_in_named_alternation = True
+    __diag__.warn_ungrouped_named_tokens_in_collection = True
+    __diag__.warn_name_set_on_empty_Forward = True
+    __diag__.warn_on_multiple_string_args_to_oneof = True
+__diag__.enable_all_warnings = _enable_all_warnings
+
+
+__all__ = ['__version__', '__versionTime__', '__author__', '__compat__', '__diag__',
+           'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
+           'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
+           'PrecededBy', 'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
+           'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
+           'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
+           'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter',
+           'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore', 'Char',
+           'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
+           'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
+           'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
+           'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
+           'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
+           'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
+           'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity',
+           'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
+           'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
+           'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation', 'locatedExpr', 'withClass',
+           'CloseMatch', 'tokenMap', 'pyparsing_common', 'pyparsing_unicode', 'unicode_set',
+           'conditionAsParseAction', 're',
+           ]
+
+system_version = tuple(sys.version_info)[:3]
+PY_3 = system_version[0] == 3
+if PY_3:
+    _MAX_INT = sys.maxsize
+    basestring = str
+    unichr = chr
+    unicode = str
+    _ustr = str
+
+    # build list of single arg builtins, that can be used as parse actions
+    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
+
+else:
+    _MAX_INT = sys.maxint
+    range = xrange
+
+    def _ustr(obj):
+        """Drop-in replacement for str(obj) that tries to be Unicode
+        friendly. It first tries str(obj). If that fails with
+        a UnicodeEncodeError, then it tries unicode(obj). It then
+        < returns the unicode object | encodes it with the default
+        encoding | ... >.
+        """
+        if isinstance(obj, unicode):
+            return obj
+
+        try:
+            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
+            # it won't break any existing code.
+            return str(obj)
+
+        except UnicodeEncodeError:
+            # Else encode it
+            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
+            xmlcharref = Regex(r'&#\d+;')
+            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
+            return xmlcharref.transformString(ret)
+
+    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
+    singleArgBuiltins = []
+    import __builtin__
+
+    for fname in "sum len sorted reversed list tuple set any all min max".split():
+        try:
+            singleArgBuiltins.append(getattr(__builtin__, fname))
+        except AttributeError:
+            continue
+
+_generatorType = type((y for y in range(1)))
+
+def _xml_escape(data):
+    """Escape &, <, >, ", ', etc. in a string of data."""
+
+    # ampersand must be replaced first
+    from_symbols = '&><"\''
+    to_symbols = ('&' + s + ';' for s in "amp gt lt quot apos".split())
+    for from_, to_ in zip(from_symbols, to_symbols):
+        data = data.replace(from_, to_)
+    return data
+
+alphas = string.ascii_uppercase + string.ascii_lowercase
+nums = "0123456789"
+hexnums = nums + "ABCDEFabcdef"
+alphanums = alphas + nums
+_bslash = chr(92)
+printables = "".join(c for c in string.printable if c not in string.whitespace)
+
+
+def conditionAsParseAction(fn, message=None, fatal=False):
+    msg = message if message is not None else "failed user-defined condition"
+    exc_type = ParseFatalException if fatal else ParseException
+    fn = _trim_arity(fn)
+
+    @wraps(fn)
+    def pa(s, l, t):
+        if not bool(fn(s, l, t)):
+            raise exc_type(s, l, msg)
+
+    return pa
+
+class ParseBaseException(Exception):
+    """base exception class for all parsing runtime exceptions"""
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__(self, pstr, loc=0, msg=None, elem=None):
+        self.loc = loc
+        if msg is None:
+            self.msg = pstr
+            self.pstr = ""
+        else:
+            self.msg = msg
+            self.pstr = pstr
+        self.parserElement = elem
+        self.args = (pstr, loc, msg)
+
+    @classmethod
+    def _from_exception(cls, pe):
+        """
+        internal factory method to simplify creating one type of ParseException
+        from another - avoids having __init__ signature conflicts among subclasses
+        """
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+
+    def __getattr__(self, aname):
+        """supported attributes by name are:
+           - lineno - returns the line number of the exception text
+           - col - returns the column number of the exception text
+           - line - returns the line containing the exception text
+        """
+        if aname == "lineno":
+            return lineno(self.loc, self.pstr)
+        elif aname in ("col", "column"):
+            return col(self.loc, self.pstr)
+        elif aname == "line":
+            return line(self.loc, self.pstr)
+        else:
+            raise AttributeError(aname)
+
+    def __str__(self):
+        if self.pstr:
+            if self.loc >= len(self.pstr):
+                foundstr = ', found end of text'
+            else:
+                foundstr = (', found %r' % self.pstr[self.loc:self.loc + 1]).replace(r'\\', '\\')
+        else:
+            foundstr = ''
+        return ("%s%s  (at char %d), (line:%d, col:%d)" %
+                   (self.msg, foundstr, self.loc, self.lineno, self.column))
+    def __repr__(self):
+        return _ustr(self)
+    def markInputline(self, markerString=">!<"):
+        """Extracts the exception line from the input string, and marks
+           the location of the exception with a special symbol.
+        """
+        line_str = self.line
+        line_column = self.column - 1
+        if markerString:
+            line_str = "".join((line_str[:line_column],
+                                markerString, line_str[line_column:]))
+        return line_str.strip()
+    def __dir__(self):
+        return "lineno col line".split() + dir(type(self))
+
+class ParseException(ParseBaseException):
+    """
+    Exception thrown when parse expressions don't match class;
+    supported attributes by name are:
+    - lineno - returns the line number of the exception text
+    - col - returns the column number of the exception text
+    - line - returns the line containing the exception text
+
+    Example::
+
+        try:
+            Word(nums).setName("integer").parseString("ABC")
+        except ParseException as pe:
+            print(pe)
+            print("column: {}".format(pe.col))
+
+    prints::
+
+       Expected integer (at char 0), (line:1, col:1)
+        column: 1
+
+    """
+
+    @staticmethod
+    def explain(exc, depth=16):
+        """
+        Method to take an exception and translate the Python internal traceback into a list
+        of the pyparsing expressions that caused the exception to be raised.
+
+        Parameters:
+
+         - exc - exception raised during parsing (need not be a ParseException, in support
+           of Python exceptions that might be raised in a parse action)
+         - depth (default=16) - number of levels back in the stack trace to list expression
+           and function names; if None, the full stack trace names will be listed; if 0, only
+           the failing input line, marker, and exception string will be shown
+
+        Returns a multi-line string listing the ParserElements and/or function names in the
+        exception's stack trace.
+
+        Note: the diagnostic output will include string representations of the expressions
+        that failed to parse. These representations will be more helpful if you use `setName` to
+        give identifiable names to your expressions. Otherwise they will use the default string
+        forms, which may be cryptic to read.
+
+        explain() is only supported under Python 3.
+        """
+        import inspect
+
+        if depth is None:
+            depth = sys.getrecursionlimit()
+        ret = []
+        if isinstance(exc, ParseBaseException):
+            ret.append(exc.line)
+            ret.append(' ' * (exc.col - 1) + '^')
+        ret.append("{0}: {1}".format(type(exc).__name__, exc))
+
+        if depth > 0:
+            callers = inspect.getinnerframes(exc.__traceback__, context=depth)
+            seen = set()
+            for i, ff in enumerate(callers[-depth:]):
+                frm = ff[0]
+
+                f_self = frm.f_locals.get('self', None)
+                if isinstance(f_self, ParserElement):
+                    if frm.f_code.co_name not in ('parseImpl', '_parseNoCache'):
+                        continue
+                    if f_self in seen:
+                        continue
+                    seen.add(f_self)
+
+                    self_type = type(f_self)
+                    ret.append("{0}.{1} - {2}".format(self_type.__module__,
+                                                      self_type.__name__,
+                                                      f_self))
+                elif f_self is not None:
+                    self_type = type(f_self)
+                    ret.append("{0}.{1}".format(self_type.__module__,
+                                                self_type.__name__))
+                else:
+                    code = frm.f_code
+                    if code.co_name in ('wrapper', '<module>'):
+                        continue
+
+                    ret.append("{0}".format(code.co_name))
+
+                depth -= 1
+                if not depth:
+                    break
+
+        return '\n'.join(ret)
+
+
+class ParseFatalException(ParseBaseException):
+    """user-throwable exception thrown when inconsistent parse content
+       is found; stops all parsing immediately"""
+    pass
+
+class ParseSyntaxException(ParseFatalException):
+    """just like :class:`ParseFatalException`, but thrown internally
+    when an :class:`ErrorStop<And._ErrorStop>` ('-' operator) indicates
+    that parsing is to stop immediately because an unbacktrackable
+    syntax error has been found.
+    """
+    pass
+
+#~ class ReparseException(ParseBaseException):
+    #~ """Experimental class - parse actions can raise this exception to cause
+       #~ pyparsing to reparse the input string:
+        #~ - with a modified input string, and/or
+        #~ - with a modified start location
+       #~ Set the values of the ReparseException in the constructor, and raise the
+       #~ exception in a parse action to cause pyparsing to use the new string/location.
+       #~ Setting the values as None causes no change to be made.
+       #~ """
+    #~ def __init_( self, newstring, restartLoc ):
+        #~ self.newParseText = newstring
+        #~ self.reparseLoc = restartLoc
+
+class RecursiveGrammarException(Exception):
+    """exception thrown by :class:`ParserElement.validate` if the
+    grammar could be improperly recursive
+    """
+    def __init__(self, parseElementList):
+        self.parseElementTrace = parseElementList
+
+    def __str__(self):
+        return "RecursiveGrammarException: %s" % self.parseElementTrace
+
+class _ParseResultsWithOffset(object):
+    def __init__(self, p1, p2):
+        self.tup = (p1, p2)
+    def __getitem__(self, i):
+        return self.tup[i]
+    def __repr__(self):
+        return repr(self.tup[0])
+    def setOffset(self, i):
+        self.tup = (self.tup[0], i)
+
+class ParseResults(object):
+    """Structured parse results, to provide multiple means of access to
+    the parsed data:
+
+       - as a list (``len(results)``)
+       - by list index (``results[0], results[1]``, etc.)
+       - by attribute (``results.<resultsName>`` - see :class:`ParserElement.setResultsName`)
+
+    Example::
+
+        integer = Word(nums)
+        date_str = (integer.setResultsName("year") + '/'
+                        + integer.setResultsName("month") + '/'
+                        + integer.setResultsName("day"))
+        # equivalent form:
+        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+        # parseString returns a ParseResults object
+        result = date_str.parseString("1999/12/31")
+
+        def test(s, fn=repr):
+            print("%s -> %s" % (s, fn(eval(s))))
+        test("list(result)")
+        test("result[0]")
+        test("result['month']")
+        test("result.day")
+        test("'month' in result")
+        test("'minutes' in result")
+        test("result.dump()", str)
+
+    prints::
+
+        list(result) -> ['1999', '/', '12', '/', '31']
+        result[0] -> '1999'
+        result['month'] -> '12'
+        result.day -> '31'
+        'month' in result -> True
+        'minutes' in result -> False
+        result.dump() -> ['1999', '/', '12', '/', '31']
+        - day: 31
+        - month: 12
+        - year: 1999
+    """
+    def __new__(cls, toklist=None, name=None, asList=True, modal=True):
+        if isinstance(toklist, cls):
+            return toklist
+        retobj = object.__new__(cls)
+        retobj.__doinit = True
+        return retobj
+
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__(self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance):
+        if self.__doinit:
+            self.__doinit = False
+            self.__name = None
+            self.__parent = None
+            self.__accumNames = {}
+            self.__asList = asList
+            self.__modal = modal
+            if toklist is None:
+                toklist = []
+            if isinstance(toklist, list):
+                self.__toklist = toklist[:]
+            elif isinstance(toklist, _generatorType):
+                self.__toklist = list(toklist)
+            else:
+                self.__toklist = [toklist]
+            self.__tokdict = dict()
+
+        if name is not None and name:
+            if not modal:
+                self.__accumNames[name] = 0
+            if isinstance(name, int):
+                name = _ustr(name)  # will always return a str, but use _ustr for consistency
+            self.__name = name
+            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None, '', [])):
+                if isinstance(toklist, basestring):
+                    toklist = [toklist]
+                if asList:
+                    if isinstance(toklist, ParseResults):
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist.__toklist), 0)
+                    else:
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]), 0)
+                    self[name].__name = name
+                else:
+                    try:
+                        self[name] = toklist[0]
+                    except (KeyError, TypeError, IndexError):
+                        self[name] = toklist
+
+    def __getitem__(self, i):
+        if isinstance(i, (int, slice)):
+            return self.__toklist[i]
+        else:
+            if i not in self.__accumNames:
+                return self.__tokdict[i][-1][0]
+            else:
+                return ParseResults([v[0] for v in self.__tokdict[i]])
+
+    def __setitem__(self, k, v, isinstance=isinstance):
+        if isinstance(v, _ParseResultsWithOffset):
+            self.__tokdict[k] = self.__tokdict.get(k, list()) + [v]
+            sub = v[0]
+        elif isinstance(k, (int, slice)):
+            self.__toklist[k] = v
+            sub = v
+        else:
+            self.__tokdict[k] = self.__tokdict.get(k, list()) + [_ParseResultsWithOffset(v, 0)]
+            sub = v
+        if isinstance(sub, ParseResults):
+            sub.__parent = wkref(self)
+
+    def __delitem__(self, i):
+        if isinstance(i, (int, slice)):
+            mylen = len(self.__toklist)
+            del self.__toklist[i]
+
+            # convert int to slice
+            if isinstance(i, int):
+                if i < 0:
+                    i += mylen
+                i = slice(i, i + 1)
+            # get removed indices
+            removed = list(range(*i.indices(mylen)))
+            removed.reverse()
+            # fixup indices in token dictionary
+            for name, occurrences in self.__tokdict.items():
+                for j in removed:
+                    for k, (value, position) in enumerate(occurrences):
+                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
+        else:
+            del self.__tokdict[i]
+
+    def __contains__(self, k):
+        return k in self.__tokdict
+
+    def __len__(self):
+        return len(self.__toklist)
+
+    def __bool__(self):
+        return (not not self.__toklist)
+    __nonzero__ = __bool__
+
+    def __iter__(self):
+        return iter(self.__toklist)
+
+    def __reversed__(self):
+        return iter(self.__toklist[::-1])
+
+    def _iterkeys(self):
+        if hasattr(self.__tokdict, "iterkeys"):
+            return self.__tokdict.iterkeys()
+        else:
+            return iter(self.__tokdict)
+
+    def _itervalues(self):
+        return (self[k] for k in self._iterkeys())
+
+    def _iteritems(self):
+        return ((k, self[k]) for k in self._iterkeys())
+
+    if PY_3:
+        keys = _iterkeys
+        """Returns an iterator of all named result keys."""
+
+        values = _itervalues
+        """Returns an iterator of all named result values."""
+
+        items = _iteritems
+        """Returns an iterator of all named result key-value tuples."""
+
+    else:
+        iterkeys = _iterkeys
+        """Returns an iterator of all named result keys (Python 2.x only)."""
+
+        itervalues = _itervalues
+        """Returns an iterator of all named result values (Python 2.x only)."""
+
+        iteritems = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""
+
+        def keys(self):
+            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iterkeys())
+
+        def values(self):
+            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.itervalues())
+
+        def items(self):
+            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iteritems())
+
+    def haskeys(self):
+        """Since keys() returns an iterator, this method is helpful in bypassing
+           code that looks for the existence of any defined results names."""
+        return bool(self.__tokdict)
+
+    def pop(self, *args, **kwargs):
+        """
+        Removes and returns item at specified index (default= ``last``).
+        Supports both ``list`` and ``dict`` semantics for ``pop()``. If
+        passed no argument or an integer argument, it will use ``list``
+        semantics and pop tokens from the list of parsed tokens. If passed
+        a non-integer argument (most likely a string), it will use ``dict``
+        semantics and pop the corresponding value from any defined results
+        names. A second default return value argument is supported, just as in
+        ``dict.pop()``.
+
+        Example::
+
+            def remove_first(tokens):
+                tokens.pop(0)
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']
+
+            label = Word(alphas)
+            patt = label("LABEL") + OneOrMore(Word(nums))
+            print(patt.parseString("AAB 123 321").dump())
+
+            # Use pop() in a parse action to remove named result (note that corresponding value is not
+            # removed from list form of results)
+            def remove_LABEL(tokens):
+                tokens.pop("LABEL")
+                return tokens
+            patt.addParseAction(remove_LABEL)
+            print(patt.parseString("AAB 123 321").dump())
+
+        prints::
+
+            ['AAB', '123', '321']
+            - LABEL: AAB
+
+            ['AAB', '123', '321']
+        """
+        if not args:
+            args = [-1]
+        for k, v in kwargs.items():
+            if k == 'default':
+                args = (args[0], v)
+            else:
+                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
+        if (isinstance(args[0], int)
+                or len(args) == 1
+                or args[0] in self):
+            index = args[0]
+            ret = self[index]
+            del self[index]
+            return ret
+        else:
+            defaultvalue = args[1]
+            return defaultvalue
+
+    def get(self, key, defaultValue=None):
+        """
+        Returns named result matching the given key, or if there is no
+        such name, then returns the given ``defaultValue`` or ``None`` if no
+        ``defaultValue`` is specified.
+
+        Similar to ``dict.get()``.
+
+        Example::
+
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+            result = date_str.parseString("1999/12/31")
+            print(result.get("year")) # -> '1999'
+            print(result.get("hour", "not specified")) # -> 'not specified'
+            print(result.get("hour")) # -> None
+        """
+        if key in self:
+            return self[key]
+        else:
+            return defaultValue
+
+    def insert(self, index, insStr):
+        """
+        Inserts new element at location index in the list of parsed tokens.
+
+        Similar to ``list.insert()``.
+
+        Example::
+
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to insert the parse location in the front of the parsed results
+            def insert_locn(locn, tokens):
+                tokens.insert(0, locn)
+            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
+        """
+        self.__toklist.insert(index, insStr)
+        # fixup indices in token dictionary
+        for name, occurrences in self.__tokdict.items():
+            for k, (value, position) in enumerate(occurrences):
+                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
+
+    def append(self, item):
+        """
+        Add single element to end of ParseResults list of elements.
+
+        Example::
+
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to compute the sum of the parsed integers, and add it to the end
+            def append_sum(tokens):
+                tokens.append(sum(map(int, tokens)))
+            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
+        """
+        self.__toklist.append(item)
+
+    def extend(self, itemseq):
+        """
+        Add sequence of elements to end of ParseResults list of elements.
+
+        Example::
+
+            patt = OneOrMore(Word(alphas))
+
+            # use a parse action to append the reverse of the matched strings, to make a palindrome
+            def make_palindrome(tokens):
+                tokens.extend(reversed([t[::-1] for t in tokens]))
+                return ''.join(tokens)
+            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
+        """
+        if isinstance(itemseq, ParseResults):
+            self.__iadd__(itemseq)
+        else:
+            self.__toklist.extend(itemseq)
+
+    def clear(self):
+        """
+        Clear all elements and results names.
+        """
+        del self.__toklist[:]
+        self.__tokdict.clear()
+
+    def __getattr__(self, name):
+        try:
+            return self[name]
+        except KeyError:
+            return ""
+
+    def __add__(self, other):
+        ret = self.copy()
+        ret += other
+        return ret
+
+    def __iadd__(self, other):
+        if other.__tokdict:
+            offset = len(self.__toklist)
+            addoffset = lambda a: offset if a < 0 else a + offset
+            otheritems = other.__tokdict.items()
+            otherdictitems = [(k, _ParseResultsWithOffset(v[0], addoffset(v[1])))
+                              for k, vlist in otheritems for v in vlist]
+            for k, v in otherdictitems:
+                self[k] = v
+                if isinstance(v[0], ParseResults):
+                    v[0].__parent = wkref(self)
+
+        self.__toklist += other.__toklist
+        self.__accumNames.update(other.__accumNames)
+        return self
+
+    def __radd__(self, other):
+        if isinstance(other, int) and other == 0:
+            # useful for merging many ParseResults using sum() builtin
+            return self.copy()
+        else:
+            # this may raise a TypeError - so be it
+            return other + self
+
+    def __repr__(self):
+        return "(%s, %s)" % (repr(self.__toklist), repr(self.__tokdict))
+
+    def __str__(self):
+        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
+
+    def _asStringList(self, sep=''):
+        out = []
+        for item in self.__toklist:
+            if out and sep:
+                out.append(sep)
+            if isinstance(item, ParseResults):
+                out += item._asStringList()
+            else:
+                out.append(_ustr(item))
+        return out
+
+    def asList(self):
+        """
+        Returns the parse results as a nested list of matching tokens, all converted to strings.
+
+        Example::
+
+            patt = OneOrMore(Word(alphas))
+            result = patt.parseString("sldkj lsdkj sldkj")
+            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
+            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
+
+            # Use asList() to create an actual list
+            result_list = result.asList()
+            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
+        """
+        return [res.asList() if isinstance(res, ParseResults) else res for res in self.__toklist]
+
+    def asDict(self):
+        """
+        Returns the named parse results as a nested dictionary.
+
+        Example::
+
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+            result = date_str.parseString('12/31/1999')
+            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
+
+            result_dict = result.asDict()
+            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}
+
+            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
+            import json
+            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
+            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
+        """
+        if PY_3:
+            item_fn = self.items
+        else:
+            item_fn = self.iteritems
+
+        def toItem(obj):
+            if isinstance(obj, ParseResults):
+                if obj.haskeys():
+                    return obj.asDict()
+                else:
+                    return [toItem(v) for v in obj]
+            else:
+                return obj
+
+        return dict((k, toItem(v)) for k, v in item_fn())
+
+    def copy(self):
+        """
+        Returns a new copy of a :class:`ParseResults` object.
+        """
+        ret = ParseResults(self.__toklist)
+        ret.__tokdict = dict(self.__tokdict.items())
+        ret.__parent = self.__parent
+        ret.__accumNames.update(self.__accumNames)
+        ret.__name = self.__name
+        return ret
+
+    def asXML(self, doctag=None, namedItemsOnly=False, indent="", formatted=True):
+        """
+        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
+        """
+        nl = "\n"
+        out = []
+        namedItems = dict((v[1], k) for (k, vlist) in self.__tokdict.items()
+                          for v in vlist)
+        nextLevelIndent = indent + "  "
+
+        # collapse out indents if formatting is not desired
+        if not formatted:
+            indent = ""
+            nextLevelIndent = ""
+            nl = ""
+
+        selfTag = None
+        if doctag is not None:
+            selfTag = doctag
+        else:
+            if self.__name:
+                selfTag = self.__name
+
+        if not selfTag:
+            if namedItemsOnly:
+                return ""
+            else:
+                selfTag = "ITEM"
+
+        out += [nl, indent, "<", selfTag, ">"]
+
+        for i, res in enumerate(self.__toklist):
+            if isinstance(res, ParseResults):
+                if i in namedItems:
+                    out += [res.asXML(namedItems[i],
+                                      namedItemsOnly and doctag is None,
+                                      nextLevelIndent,
+                                      formatted)]
+                else:
+                    out += [res.asXML(None,
+                                      namedItemsOnly and doctag is None,
+                                      nextLevelIndent,
+                                      formatted)]
+            else:
+                # individual token, see if there is a name for it
+                resTag = None
+                if i in namedItems:
+                    resTag = namedItems[i]
+                if not resTag:
+                    if namedItemsOnly:
+                        continue
+                    else:
+                        resTag = "ITEM"
+                xmlBodyText = _xml_escape(_ustr(res))
+                out += [nl, nextLevelIndent, "<", resTag, ">",
+                        xmlBodyText,
+                                                "</", resTag, ">"]
+
+        out += [nl, indent, "</", selfTag, ">"]
+        return "".join(out)
+
+    def __lookup(self, sub):
+        for k, vlist in self.__tokdict.items():
+            for v, loc in vlist:
+                if sub is v:
+                    return k
+        return None
+
+    def getName(self):
+        r"""
+        Returns the results name for this token expression. Useful when several
+        different expressions might match at a particular location.
+
+        Example::
+
+            integer = Word(nums)
+            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
+            house_number_expr = Suppress('#') + Word(nums, alphanums)
+            user_data = (Group(house_number_expr)("house_number")
+                        | Group(ssn_expr)("ssn")
+                        | Group(integer)("age"))
+            user_info = OneOrMore(user_data)
+
+            result = user_info.parseString("22 111-22-3333 #221B")
+            for item in result:
+                print(item.getName(), ':', item[0])
+
+        prints::
+
+            age : 22
+            ssn : 111-22-3333
+            house_number : 221B
+        """
+        if self.__name:
+            return self.__name
+        elif self.__parent:
+            par = self.__parent()
+            if par:
+                return par.__lookup(self)
+            else:
+                return None
+        elif (len(self) == 1
+              and len(self.__tokdict) == 1
+              and next(iter(self.__tokdict.values()))[0][1] in (0, -1)):
+            return next(iter(self.__tokdict.keys()))
+        else:
+            return None
+
+    def dump(self, indent='', full=True, include_list=True, _depth=0):
+        """
+        Diagnostic method for listing out the contents of
+        a :class:`ParseResults`. Accepts an optional ``indent`` argument so
+        that this string can be embedded in a nested display of other data.
+
+        Example::
+
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+            result = date_str.parseString('12/31/1999')
+            print(result.dump())
+
+        prints::
+
+            ['12', '/', '31', '/', '1999']
+            - day: 1999
+            - month: 31
+            - year: 12
+        """
+        out = []
+        NL = '\n'
+        if include_list:
+            out.append(indent + _ustr(self.asList()))
+        else:
+            out.append('')
+
+        if full:
+            if self.haskeys():
+                items = sorted((str(k), v) for k, v in self.items())
+                for k, v in items:
+                    if out:
+                        out.append(NL)
+                    out.append("%s%s- %s: " % (indent, ('  ' * _depth), k))
+                    if isinstance(v, ParseResults):
+                        if v:
+                            out.append(v.dump(indent=indent, full=full, include_list=include_list, _depth=_depth + 1))
+                        else:
+                            out.append(_ustr(v))
+                    else:
+                        out.append(repr(v))
+            elif any(isinstance(vv, ParseResults) for vv in self):
+                v = self
+                for i, vv in enumerate(v):
+                    if isinstance(vv, ParseResults):
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,
+                                                            ('  ' * (_depth)),
+                                                            i,
+                                                            indent,
+                                                            ('  ' * (_depth + 1)),
+                                                            vv.dump(indent=indent,
+                                                                    full=full,
+                                                                    include_list=include_list,
+                                                                    _depth=_depth + 1)))
+                    else:
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,
+                                                            ('  ' * (_depth)),
+                                                            i,
+                                                            indent,
+                                                            ('  ' * (_depth + 1)),
+                                                            _ustr(vv)))
+
+        return "".join(out)
+
+    def pprint(self, *args, **kwargs):
+        """
+        Pretty-printer for parsed results as a list, using the
+        `pprint <https://docs.python.org/3/library/pprint.html>`_ module.
+        Accepts additional positional or keyword args as defined for
+        `pprint.pprint <https://docs.python.org/3/library/pprint.html#pprint.pprint>`_ .
+
+        Example::
+
+            ident = Word(alphas, alphanums)
+            num = Word(nums)
+            func = Forward()
+            term = ident | num | Group('(' + func + ')')
+            func <<= ident + Group(Optional(delimitedList(term)))
+            result = func.parseString("fna a,b,(fnb c,d,200),100")
+            result.pprint(width=40)
+
+        prints::
+
+            ['fna',
+             ['a',
+              'b',
+              ['(', 'fnb', ['c', 'd', '200'], ')'],
+              '100']]
+        """
+        pprint.pprint(self.asList(), *args, **kwargs)
+
+    # add support for pickle protocol
+    def __getstate__(self):
+        return (self.__toklist,
+                (self.__tokdict.copy(),
+                 self.__parent is not None and self.__parent() or None,
+                 self.__accumNames,
+                 self.__name))
+
+    def __setstate__(self, state):
+        self.__toklist = state[0]
+        self.__tokdict, par, inAccumNames, self.__name = state[1]
+        self.__accumNames = {}
+        self.__accumNames.update(inAccumNames)
+        if par is not None:
+            self.__parent = wkref(par)
+        else:
+            self.__parent = None
+
+    def __getnewargs__(self):
+        return self.__toklist, self.__name, self.__asList, self.__modal
+
+    def __dir__(self):
+        return dir(type(self)) + list(self.keys())
+
+    @classmethod
+    def from_dict(cls, other, name=None):
+        """
+        Helper classmethod to construct a ParseResults from a dict, preserving the
+        name-value relations as results names. If an optional 'name' argument is
+        given, a nested ParseResults will be returned
+        """
+        def is_iterable(obj):
+            try:
+                iter(obj)
+            except Exception:
+                return False
+            else:
+                if PY_3:
+                    return not isinstance(obj, (str, bytes))
+                else:
+                    return not isinstance(obj, basestring)
+
+        ret = cls([])
+        for k, v in other.items():
+            if isinstance(v, Mapping):
+                ret += cls.from_dict(v, name=k)
+            else:
+                ret += cls([v], name=k, asList=is_iterable(v))
+        if name is not None:
+            ret = cls([ret], name=name)
+        return ret
+
+MutableMapping.register(ParseResults)
+
+def col (loc, strg):
+    """Returns current column within a string, counting newlines as line separators.
+   The first column is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See
+   :class:`ParserElement.parseString` for more
+   information on parsing strings containing ``<TAB>`` s, and suggested
+   methods to maintain a consistent view of the parsed string, the parse
+   location, and line and column positions within the parsed string.
+   """
+    s = strg
+    return 1 if 0 < loc < len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)
+
+def lineno(loc, strg):
+    """Returns current line number within a string, counting newlines as line separators.
+    The first line is number 1.
+
+    Note - the default parsing behavior is to expand tabs in the input string
+    before starting the parsing process.  See :class:`ParserElement.parseString`
+    for more information on parsing strings containing ``<TAB>`` s, and
+    suggested methods to maintain a consistent view of the parsed string, the
+    parse location, and line and column positions within the parsed string.
+    """
+    return strg.count("\n", 0, loc) + 1
+
+def line(loc, strg):
+    """Returns the line of text containing loc within a string, counting newlines as line separators.
+       """
+    lastCR = strg.rfind("\n", 0, loc)
+    nextCR = strg.find("\n", loc)
+    if nextCR >= 0:
+        return strg[lastCR + 1:nextCR]
+    else:
+        return strg[lastCR + 1:]
+
+def _defaultStartDebugAction(instring, loc, expr):
+    print(("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % (lineno(loc, instring), col(loc, instring))))
+
+def _defaultSuccessDebugAction(instring, startloc, endloc, expr, toks):
+    print("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
+
+def _defaultExceptionDebugAction(instring, loc, expr, exc):
+    print("Exception raised:" + _ustr(exc))
+
+def nullDebugAction(*args):
+    """'Do-nothing' debug action, to suppress debugging output during parsing."""
+    pass
+
+# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
+#~ 'decorator to trim function calls to match the arity of the target'
+#~ def _trim_arity(func, maxargs=3):
+    #~ if func in singleArgBuiltins:
+        #~ return lambda s,l,t: func(t)
+    #~ limit = 0
+    #~ foundArity = False
+    #~ def wrapper(*args):
+        #~ nonlocal limit,foundArity
+        #~ while 1:
+            #~ try:
+                #~ ret = func(*args[limit:])
+                #~ foundArity = True
+                #~ return ret
+            #~ except TypeError:
+                #~ if limit == maxargs or foundArity:
+                    #~ raise
+                #~ limit += 1
+                #~ continue
+    #~ return wrapper
+
+# this version is Python 2.x-3.x cross-compatible
+'decorator to trim function calls to match the arity of the target'
+def _trim_arity(func, maxargs=2):
+    if func in singleArgBuiltins:
+        return lambda s, l, t: func(t)
+    limit = [0]
+    foundArity = [False]
+
+    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
+    if system_version[:2] >= (3, 5):
+        def extract_stack(limit=0):
+            # special handling for Python 3.5.0 - extra deep call stack by 1
+            offset = -3 if system_version == (3, 5, 0) else -2
+            frame_summary = traceback.extract_stack(limit=-offset + limit - 1)[offset]
+            return [frame_summary[:2]]
+        def extract_tb(tb, limit=0):
+            frames = traceback.extract_tb(tb, limit=limit)
+            frame_summary = frames[-1]
+            return [frame_summary[:2]]
+    else:
+        extract_stack = traceback.extract_stack
+        extract_tb = traceback.extract_tb
+
+    # synthesize what would be returned by traceback.extract_stack at the call to
+    # user's parse action 'func', so that we don't incur call penalty at parse time
+
+    LINE_DIFF = 6
+    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND
+    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
+    this_line = extract_stack(limit=2)[-1]
+    pa_call_line_synth = (this_line[0], this_line[1] + LINE_DIFF)
+
+    def wrapper(*args):
+        while 1:
+            try:
+                ret = func(*args[limit[0]:])
+                foundArity[0] = True
+                return ret
+            except TypeError:
+                # re-raise TypeErrors if they did not come from our arity testing
+                if foundArity[0]:
+                    raise
+                else:
+                    try:
+                        tb = sys.exc_info()[-1]
+                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
+                            raise
+                    finally:
+                        try:
+                            del tb
+                        except NameError:
+                            pass
+
+                if limit[0] <= maxargs:
+                    limit[0] += 1
+                    continue
+                raise
+
+    # copy func name to wrapper for sensible debug output
+    func_name = "<parse action>"
+    try:
+        func_name = getattr(func, '__name__',
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    wrapper.__name__ = func_name
+
+    return wrapper
+
+
+class ParserElement(object):
+    """Abstract base level parser element class."""
+    DEFAULT_WHITE_CHARS = " \n\t\r"
+    verbose_stacktrace = False
+
+    @staticmethod
+    def setDefaultWhitespaceChars(chars):
+        r"""
+        Overrides the default whitespace chars
+
+        Example::
+
+            # default whitespace chars are space, <TAB> and newline
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+
+            # change to just treat newline as significant
+            ParserElement.setDefaultWhitespaceChars(" \t")
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
+        """
+        ParserElement.DEFAULT_WHITE_CHARS = chars
+
+    @staticmethod
+    def inlineLiteralsUsing(cls):
+        """
+        Set class to be used for inclusion of string literals into a parser.
+
+        Example::
+
+            # default literal class used is Literal
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+
+            # change to Suppress
+            ParserElement.inlineLiteralsUsing(Suppress)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
+        """
+        ParserElement._literalStringClass = cls
+
+    def __init__(self, savelist=False):
+        self.parseAction = list()
+        self.failAction = None
+        # ~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
+        self.strRepr = None
+        self.resultsName = None
+        self.saveAsList = savelist
+        self.skipWhitespace = True
+        self.whiteChars = set(ParserElement.DEFAULT_WHITE_CHARS)
+        self.copyDefaultWhiteChars = True
+        self.mayReturnEmpty = False # used when checking for left-recursion
+        self.keepTabs = False
+        self.ignoreExprs = list()
+        self.debug = False
+        self.streamlined = False
+        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
+        self.errmsg = ""
+        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
+        self.debugActions = (None, None, None)  # custom debug actions
+        self.re = None
+        self.callPreparse = True # used to avoid redundant calls to preParse
+        self.callDuringTry = False
+
+    def copy(self):
+        """
+        Make a copy of this :class:`ParserElement`.  Useful for defining
+        different parse actions for the same parsing pattern, using copies of
+        the original parse element.
+
+        Example::
+
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            integerK = integer.copy().addParseAction(lambda toks: toks[0] * 1024) + Suppress("K")
+            integerM = integer.copy().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
+
+            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
+
+        prints::
+
+            [5120, 100, 655360, 268435456]
+
+        Equivalent form of ``expr.copy()`` is just ``expr()``::
+
+            integerM = integer().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
+        """
+        cpy = copy.copy(self)
+        cpy.parseAction = self.parseAction[:]
+        cpy.ignoreExprs = self.ignoreExprs[:]
+        if self.copyDefaultWhiteChars:
+            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        return cpy
+
+    def setName(self, name):
+        """
+        Define name for this expression, makes debugging and exception messages clearer.
+
+        Example::
+
+            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
+            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+        """
+        self.name = name
+        self.errmsg = "Expected " + self.name
+        if __diag__.enable_debug_on_named_expressions:
+            self.setDebug()
+        return self
+
+    def setResultsName(self, name, listAllMatches=False):
+        """
+        Define name for referencing matching tokens as a nested attribute
+        of the returned parse results.
+        NOTE: this returns a *copy* of the original :class:`ParserElement` object;
+        this is so that the client can define a basic element, such as an
+        integer, and reference it in multiple places with different names.
+
+        You can also set results names using the abbreviated syntax,
+        ``expr("name")`` in place of ``expr.setResultsName("name")``
+        - see :class:`__call__`.
+
+        Example::
+
+            date_str = (integer.setResultsName("year") + '/'
+                        + integer.setResultsName("month") + '/'
+                        + integer.setResultsName("day"))
+
+            # equivalent form:
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+        """
+        return self._setResultsName(name, listAllMatches)
+
+    def _setResultsName(self, name, listAllMatches=False):
+        newself = self.copy()
+        if name.endswith("*"):
+            name = name[:-1]
+            listAllMatches = True
+        newself.resultsName = name
+        newself.modalResults = not listAllMatches
+        return newself
+
+    def setBreak(self, breakFlag=True):
+        """Method to invoke the Python pdb debugger when this element is
+           about to be parsed. Set ``breakFlag`` to True to enable, False to
+           disable.
+        """
+        if breakFlag:
+            _parseMethod = self._parse
+            def breaker(instring, loc, doActions=True, callPreParse=True):
+                import pdb
+                # this call to pdb.set_trace() is intentional, not a checkin error
+                pdb.set_trace()
+                return _parseMethod(instring, loc, doActions, callPreParse)
+            breaker._originalParseMethod = _parseMethod
+            self._parse = breaker
+        else:
+            if hasattr(self._parse, "_originalParseMethod"):
+                self._parse = self._parse._originalParseMethod
+        return self
+
+    def setParseAction(self, *fns, **kwargs):
+        """
+        Define one or more actions to perform when successfully matching parse element definition.
+        Parse action fn is a callable method with 0-3 arguments, called as ``fn(s, loc, toks)`` ,
+        ``fn(loc, toks)`` , ``fn(toks)`` , or just ``fn()`` , where:
+
+        - s   = the original string being parsed (see note below)
+        - loc = the location of the matching substring
+        - toks = a list of the matched tokens, packaged as a :class:`ParseResults` object
+
+        If the functions in fns modify the tokens, they can return them as the return
+        value from fn, and the modified list of tokens will replace the original.
+        Otherwise, fn does not need to return any value.
+
+        If None is passed as the parse action, all previously added parse actions for this
+        expression are cleared.
+
+        Optional keyword arguments:
+        - callDuringTry = (default= ``False``) indicate if parse action should be run during lookaheads and alternate testing
+
+        Note: the default parsing behavior is to expand tabs in the input string
+        before starting the parsing process.  See :class:`parseString for more
+        information on parsing strings containing ``<TAB>`` s, and suggested
+        methods to maintain a consistent view of the parsed string, the parse
+        location, and line and column positions within the parsed string.
+
+        Example::
+
+            integer = Word(nums)
+            date_str = integer + '/' + integer + '/' + integer
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+            # use parse action to convert to ints at parse time
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            date_str = integer + '/' + integer + '/' + integer
+
+            # note that integer fields are now ints, not strings
+            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
+        """
+        if list(fns) == [None,]:
+            self.parseAction = []
+        else:
+            if not all(callable(fn) for fn in fns):
+                raise TypeError("parse actions must be callable")
+            self.parseAction = list(map(_trim_arity, list(fns)))
+            self.callDuringTry = kwargs.get("callDuringTry", False)
+        return self
+
+    def addParseAction(self, *fns, **kwargs):
+        """
+        Add one or more parse actions to expression's list of parse actions. See :class:`setParseAction`.
+
+        See examples in :class:`copy`.
+        """
+        self.parseAction += list(map(_trim_arity, list(fns)))
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def addCondition(self, *fns, **kwargs):
+        """Add a boolean predicate function to expression's list of parse actions. See
+        :class:`setParseAction` for function call signatures. Unlike ``setParseAction``,
+        functions passed to ``addCondition`` need to return boolean success/fail of the condition.
+
+        Optional keyword arguments:
+        - message = define a custom message to be used in the raised exception
+        - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
+
+        Example::
+
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            year_int = integer.copy()
+            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
+            date_str = year_int + '/' + integer + '/' + integer
+
+            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
+        """
+        for fn in fns:
+            self.parseAction.append(conditionAsParseAction(fn, message=kwargs.get('message'),
+                                                           fatal=kwargs.get('fatal', False)))
+
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def setFailAction(self, fn):
+        """Define action to perform if parsing fails at this expression.
+           Fail acton fn is a callable function that takes the arguments
+           ``fn(s, loc, expr, err)`` where:
+           - s = string being parsed
+           - loc = location where expression match was attempted and failed
+           - expr = the parse expression that failed
+           - err = the exception thrown
+           The function returns no value.  It may throw :class:`ParseFatalException`
+           if it is desired to stop parsing immediately."""
+        self.failAction = fn
+        return self
+
+    def _skipIgnorables(self, instring, loc):
+        exprsFound = True
+        while exprsFound:
+            exprsFound = False
+            for e in self.ignoreExprs:
+                try:
+                    while 1:
+                        loc, dummy = e._parse(instring, loc)
+                        exprsFound = True
+                except ParseException:
+                    pass
+        return loc
+
+    def preParse(self, instring, loc):
+        if self.ignoreExprs:
+            loc = self._skipIgnorables(instring, loc)
+
+        if self.skipWhitespace:
+            wt = self.whiteChars
+            instrlen = len(instring)
+            while loc < instrlen and instring[loc] in wt:
+                loc += 1
+
+        return loc
+
+    def parseImpl(self, instring, loc, doActions=True):
+        return loc, []
+
+    def postParse(self, instring, loc, tokenlist):
+        return tokenlist
+
+    # ~ @profile
+    def _parseNoCache(self, instring, loc, doActions=True, callPreParse=True):
+        TRY, MATCH, FAIL = 0, 1, 2
+        debugging = (self.debug)  # and doActions)
+
+        if debugging or self.failAction:
+            # ~ print ("Match", self, "at loc", loc, "(%d, %d)" % (lineno(loc, instring), col(loc, instring)))
+            if self.debugActions[TRY]:
+                self.debugActions[TRY](instring, loc, self)
+            try:
+                if callPreParse and self.callPreparse:
+                    preloc = self.preParse(instring, loc)
+                else:
+                    preloc = loc
+                tokensStart = preloc
+                if self.mayIndexError or preloc >= len(instring):
+                    try:
+                        loc, tokens = self.parseImpl(instring, preloc, doActions)
+                    except IndexError:
+                        raise ParseException(instring, len(instring), self.errmsg, self)
+                else:
+                    loc, tokens = self.parseImpl(instring, preloc, doActions)
+            except Exception as err:
+                # ~ print ("Exception raised:", err)
+                if self.debugActions[FAIL]:
+                    self.debugActions[FAIL](instring, tokensStart, self, err)
+                if self.failAction:
+                    self.failAction(instring, tokensStart, self, err)
+                raise
+        else:
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse(instring, loc)
+            else:
+                preloc = loc
+            tokensStart = preloc
+            if self.mayIndexError or preloc >= len(instring):
+                try:
+                    loc, tokens = self.parseImpl(instring, preloc, doActions)
+                except IndexError:
+                    raise ParseException(instring, len(instring), self.errmsg, self)
+            else:
+                loc, tokens = self.parseImpl(instring, preloc, doActions)
+
+        tokens = self.postParse(instring, loc, tokens)
+
+        retTokens = ParseResults(tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults)
+        if self.parseAction and (doActions or self.callDuringTry):
+            if debugging:
+                try:
+                    for fn in self.parseAction:
+                        try:
+                            tokens = fn(instring, tokensStart, retTokens)
+                        except IndexError as parse_action_exc:
+                            exc = ParseException("exception raised in parse action")
+                            exc.__cause__ = parse_action_exc
+                            raise exc
+
+                        if tokens is not None and tokens is not retTokens:
+                            retTokens = ParseResults(tokens,
+                                                      self.resultsName,
+                                                      asList=self.saveAsList and isinstance(tokens, (ParseResults, list)),
+                                                      modal=self.modalResults)
+                except Exception as err:
+                    # ~ print "Exception raised in user parse action:", err
+                    if self.debugActions[FAIL]:
+                        self.debugActions[FAIL](instring, tokensStart, self, err)
+                    raise
+            else:
+                for fn in self.parseAction:
+                    try:
+                        tokens = fn(instring, tokensStart, retTokens)
+                    except IndexError as parse_action_exc:
+                        exc = ParseException("exception raised in parse action")
+                        exc.__cause__ = parse_action_exc
+                        raise exc
+
+                    if tokens is not None and tokens is not retTokens:
+                        retTokens = ParseResults(tokens,
+                                                  self.resultsName,
+                                                  asList=self.saveAsList and isinstance(tokens, (ParseResults, list)),
+                                                  modal=self.modalResults)
+        if debugging:
+            # ~ print ("Matched", self, "->", retTokens.asList())
+            if self.debugActions[MATCH]:
+                self.debugActions[MATCH](instring, tokensStart, loc, self, retTokens)
+
+        return loc, retTokens
+
+    def tryParse(self, instring, loc):
+        try:
+            return self._parse(instring, loc, doActions=False)[0]
+        except ParseFatalException:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+    def canParseNext(self, instring, loc):
+        try:
+            self.tryParse(instring, loc)
+        except (ParseException, IndexError):
+            return False
+        else:
+            return True
+
+    class _UnboundedCache(object):
+        def __init__(self):
+            cache = {}
+            self.not_in_cache = not_in_cache = object()
+
+            def get(self, key):
+                return cache.get(key, not_in_cache)
+
+            def set(self, key, value):
+                cache[key] = value
+
+            def clear(self):
+                cache.clear()
+
+            def cache_len(self):
+                return len(cache)
+
+            self.get = types.MethodType(get, self)
+            self.set = types.MethodType(set, self)
+            self.clear = types.MethodType(clear, self)
+            self.__len__ = types.MethodType(cache_len, self)
+
+    if _OrderedDict is not None:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = _OrderedDict()
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(cache) > size:
+                        try:
+                            cache.popitem(False)
+                        except KeyError:
+                            pass
+
+                def clear(self):
+                    cache.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    else:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = {}
+                key_fifo = collections.deque([], size)
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(key_fifo) > size:
+                        cache.pop(key_fifo.popleft(), None)
+                    key_fifo.append(key)
+
+                def clear(self):
+                    cache.clear()
+                    key_fifo.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    # argument cache for optimizing repeated calls when backtracking through recursive expressions
+    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
+    packrat_cache_lock = RLock()
+    packrat_cache_stats = [0, 0]
+
+    # this method gets repeatedly called during backtracking with the same arguments -
+    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
+    def _parseCache(self, instring, loc, doActions=True, callPreParse=True):
+        HIT, MISS = 0, 1
+        lookup = (self, instring, loc, callPreParse, doActions)
+        with ParserElement.packrat_cache_lock:
+            cache = ParserElement.packrat_cache
+            value = cache.get(lookup)
+            if value is cache.not_in_cache:
+                ParserElement.packrat_cache_stats[MISS] += 1
+                try:
+                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                except ParseBaseException as pe:
+                    # cache a copy of the exception, without the traceback
+                    cache.set(lookup, pe.__class__(*pe.args))
+                    raise
+                else:
+                    cache.set(lookup, (value[0], value[1].copy()))
+                    return value
+            else:
+                ParserElement.packrat_cache_stats[HIT] += 1
+                if isinstance(value, Exception):
+                    raise value
+                return value[0], value[1].copy()
+
+    _parse = _parseNoCache
+
+    @staticmethod
+    def resetCache():
+        ParserElement.packrat_cache.clear()
+        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)
+
+    _packratEnabled = False
+    @staticmethod
+    def enablePackrat(cache_size_limit=128):
+        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
+           Repeated parse attempts at the same string location (which happens
+           often in many complex grammars) can immediately return a cached value,
+           instead of re-executing parsing/validating code.  Memoizing is done of
+           both valid results and parsing exceptions.
+
+           Parameters:
+
+           - cache_size_limit - (default= ``128``) - if an integer value is provided
+             will limit the size of the packrat cache; if None is passed, then
+             the cache size will be unbounded; if 0 is passed, the cache will
+             be effectively disabled.
+
+           This speedup may break existing programs that use parse actions that
+           have side-effects.  For this reason, packrat parsing is disabled when
+           you first import pyparsing.  To activate the packrat feature, your
+           program must call the class method :class:`ParserElement.enablePackrat`.
+           For best results, call ``enablePackrat()`` immediately after
+           importing pyparsing.
+
+           Example::
+
+               import pyparsing
+               pyparsing.ParserElement.enablePackrat()
+        """
+        if not ParserElement._packratEnabled:
+            ParserElement._packratEnabled = True
+            if cache_size_limit is None:
+                ParserElement.packrat_cache = ParserElement._UnboundedCache()
+            else:
+                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
+            ParserElement._parse = ParserElement._parseCache
+
+    def parseString(self, instring, parseAll=False):
+        """
+        Execute the parse expression with the given string.
+        This is the main interface to the client code, once the complete
+        expression has been built.
+
+        Returns the parsed data as a :class:`ParseResults` object, which may be
+        accessed as a list, or as a dict or object with attributes if the given parser
+        includes results names.
+
+        If you want the grammar to require that the entire input string be
+        successfully parsed, then set ``parseAll`` to True (equivalent to ending
+        the grammar with ``StringEnd()``).
+
+        Note: ``parseString`` implicitly calls ``expandtabs()`` on the input string,
+        in order to report proper column numbers in parse actions.
+        If the input string contains tabs and
+        the grammar uses parse actions that use the ``loc`` argument to index into the
+        string being parsed, you can ensure you have a consistent view of the input
+        string by:
+
+        - calling ``parseWithTabs`` on your grammar before calling ``parseString``
+          (see :class:`parseWithTabs`)
+        - define your parse action using the full ``(s, loc, toks)`` signature, and
+          reference the input string using the parse action's ``s`` argument
+        - explictly expand the tabs in your input string before calling
+          ``parseString``
+
+        Example::
+
+            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
+            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
+        """
+        ParserElement.resetCache()
+        if not self.streamlined:
+            self.streamline()
+            # ~ self.saveAsList = True
+        for e in self.ignoreExprs:
+            e.streamline()
+        if not self.keepTabs:
+            instring = instring.expandtabs()
+        try:
+            loc, tokens = self._parse(instring, 0)
+            if parseAll:
+                loc = self.preParse(instring, loc)
+                se = Empty() + StringEnd()
+                se._parse(instring, loc)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+        else:
+            return tokens
+
+    def scanString(self, instring, maxMatches=_MAX_INT, overlap=False):
+        """
+        Scan the input string for expression matches.  Each match will return the
+        matching tokens, start location, and end location.  May be called with optional
+        ``maxMatches`` argument, to clip scanning after 'n' matches are found.  If
+        ``overlap`` is specified, then overlapping matches will be reported.
+
+        Note that the start and end locations are reported relative to the string
+        being parsed.  See :class:`parseString` for more information on parsing
+        strings with embedded tabs.
+
+        Example::
+
+            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
+            print(source)
+            for tokens, start, end in Word(alphas).scanString(source):
+                print(' '*start + '^'*(end-start))
+                print(' '*start + tokens[0])
+
+        prints::
+
+            sldjf123lsdjjkf345sldkjf879lkjsfd987
+            ^^^^^
+            sldjf
+                    ^^^^^^^
+                    lsdjjkf
+                              ^^^^^^
+                              sldkjf
+                                       ^^^^^^
+                                       lkjsfd
+        """
+        if not self.streamlined:
+            self.streamline()
+        for e in self.ignoreExprs:
+            e.streamline()
+
+        if not self.keepTabs:
+            instring = _ustr(instring).expandtabs()
+        instrlen = len(instring)
+        loc = 0
+        preparseFn = self.preParse
+        parseFn = self._parse
+        ParserElement.resetCache()
+        matches = 0
+        try:
+            while loc <= instrlen and matches < maxMatches:
+                try:
+                    preloc = preparseFn(instring, loc)
+                    nextLoc, tokens = parseFn(instring, preloc, callPreParse=False)
+                except ParseException:
+                    loc = preloc + 1
+                else:
+                    if nextLoc > loc:
+                        matches += 1
+                        yield tokens, preloc, nextLoc
+                        if overlap:
+                            nextloc = preparseFn(instring, loc)
+                            if nextloc > loc:
+                                loc = nextLoc
+                            else:
+                                loc += 1
+                        else:
+                            loc = nextLoc
+                    else:
+                        loc = preloc + 1
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def transformString(self, instring):
+        """
+        Extension to :class:`scanString`, to modify matching text with modified tokens that may
+        be returned from a parse action.  To use ``transformString``, define a grammar and
+        attach a parse action to it that modifies the returned token list.
+        Invoking ``transformString()`` on a target string will then scan for matches,
+        and replace the matched text patterns according to the logic in the parse
+        action.  ``transformString()`` returns the resulting transformed string.
+
+        Example::
+
+            wd = Word(alphas)
+            wd.setParseAction(lambda toks: toks[0].title())
+
+            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
+
+        prints::
+
+            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
+        """
+        out = []
+        lastE = 0
+        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
+        # keep string locs straight between transformString and scanString
+        self.keepTabs = True
+        try:
+            for t, s, e in self.scanString(instring):
+                out.append(instring[lastE:s])
+                if t:
+                    if isinstance(t, ParseResults):
+                        out += t.asList()
+                    elif isinstance(t, list):
+                        out += t
+                    else:
+                        out.append(t)
+                lastE = e
+            out.append(instring[lastE:])
+            out = [o for o in out if o]
+            return "".join(map(_ustr, _flatten(out)))
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def searchString(self, instring, maxMatches=_MAX_INT):
+        """
+        Another extension to :class:`scanString`, simplifying the access to the tokens found
+        to match the given parse expression.  May be called with optional
+        ``maxMatches`` argument, to clip searching after 'n' matches are found.
+
+        Example::
+
+            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
+            cap_word = Word(alphas.upper(), alphas.lower())
+
+            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))
+
+            # the sum() builtin can be used to merge results into a single ParseResults object
+            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
+
+        prints::
+
+            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
+            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
+        """
+        try:
+            return ParseResults([t for t, s, e in self.scanString(instring, maxMatches)])
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
+        """
+        Generator method to split a string using the given expression as a separator.
+        May be called with optional ``maxsplit`` argument, to limit the number of splits;
+        and the optional ``includeSeparators`` argument (default= ``False``), if the separating
+        matching text should be included in the split results.
+
+        Example::
+
+            punc = oneOf(list(".,;:/-!?"))
+            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
+
+        prints::
+
+            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
+        """
+        splits = 0
+        last = 0
+        for t, s, e in self.scanString(instring, maxMatches=maxsplit):
+            yield instring[last:s]
+            if includeSeparators:
+                yield t[0]
+            last = e
+        yield instring[last:]
+
+    def __add__(self, other):
+        """
+        Implementation of + operator - returns :class:`And`. Adding strings to a ParserElement
+        converts them to :class:`Literal`s by default.
+
+        Example::
+
+            greet = Word(alphas) + "," + Word(alphas) + "!"
+            hello = "Hello, World!"
+            print (hello, "->", greet.parseString(hello))
+
+        prints::
+
+            Hello, World! -> ['Hello', ',', 'World', '!']
+
+        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`.
+
+            Literal('start') + ... + Literal('end')
+
+        is equivalent to:
+
+            Literal('start') + SkipTo('end')("_skipped*") + Literal('end')
+
+        Note that the skipped text is returned with '_skipped' as a results name,
+        and to support having multiple skips in the same parser, the value returned is
+        a list of all skipped text.
+        """
+        if other is Ellipsis:
+            return _PendingSkip(self)
+
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return And([self, other])
+
+    def __radd__(self, other):
+        """
+        Implementation of + operator when left operand is not a :class:`ParserElement`
+        """
+        if other is Ellipsis:
+            return SkipTo(self)("_skipped*") + self
+
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return other + self
+
+    def __sub__(self, other):
+        """
+        Implementation of - operator, returns :class:`And` with error stop
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return self + And._ErrorStop() + other
+
+    def __rsub__(self, other):
+        """
+        Implementation of - operator when left operand is not a :class:`ParserElement`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return other - self
+
+    def __mul__(self, other):
+        """
+        Implementation of * operator, allows use of ``expr * 3`` in place of
+        ``expr + expr + expr``.  Expressions may also me multiplied by a 2-integer
+        tuple, similar to ``{min, max}`` multipliers in regular expressions.  Tuples
+        may also include ``None`` as in:
+         - ``expr*(n, None)`` or ``expr*(n, )`` is equivalent
+              to ``expr*n + ZeroOrMore(expr)``
+              (read as "at least n instances of ``expr``")
+         - ``expr*(None, n)`` is equivalent to ``expr*(0, n)``
+              (read as "0 to n instances of ``expr``")
+         - ``expr*(None, None)`` is equivalent to ``ZeroOrMore(expr)``
+         - ``expr*(1, None)`` is equivalent to ``OneOrMore(expr)``
+
+        Note that ``expr*(None, n)`` does not raise an exception if
+        more than n exprs exist in the input stream; that is,
+        ``expr*(None, n)`` does not enforce a maximum number of expr
+        occurrences.  If this behavior is desired, then write
+        ``expr*(None, n) + ~expr``
+        """
+        if other is Ellipsis:
+            other = (0, None)
+        elif isinstance(other, tuple) and other[:1] == (Ellipsis,):
+            other = ((0, ) + other[1:] + (None,))[:2]
+
+        if isinstance(other, int):
+            minElements, optElements = other, 0
+        elif isinstance(other, tuple):
+            other = tuple(o if o is not Ellipsis else None for o in other)
+            other = (other + (None, None))[:2]
+            if other[0] is None:
+                other = (0, other[1])
+            if isinstance(other[0], int) and other[1] is None:
+                if other[0] == 0:
+                    return ZeroOrMore(self)
+                if other[0] == 1:
+                    return OneOrMore(self)
+                else:
+                    return self * other[0] + ZeroOrMore(self)
+            elif isinstance(other[0], int) and isinstance(other[1], int):
+                minElements, optElements = other
+                optElements -= minElements
+            else:
+                raise TypeError("cannot multiply 'ParserElement' and ('%s', '%s') objects", type(other[0]), type(other[1]))
+        else:
+            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
+
+        if minElements < 0:
+            raise ValueError("cannot multiply ParserElement by negative value")
+        if optElements < 0:
+            raise ValueError("second tuple value must be greater or equal to first tuple value")
+        if minElements == optElements == 0:
+            raise ValueError("cannot multiply ParserElement by 0 or (0, 0)")
+
+        if optElements:
+            def makeOptionalList(n):
+                if n > 1:
+                    return Optional(self + makeOptionalList(n - 1))
+                else:
+                    return Optional(self)
+            if minElements:
+                if minElements == 1:
+                    ret = self + makeOptionalList(optElements)
+                else:
+                    ret = And([self] * minElements) + makeOptionalList(optElements)
+            else:
+                ret = makeOptionalList(optElements)
+        else:
+            if minElements == 1:
+                ret = self
+            else:
+                ret = And([self] * minElements)
+        return ret
+
+    def __rmul__(self, other):
+        return self.__mul__(other)
+
+    def __or__(self, other):
+        """
+        Implementation of | operator - returns :class:`MatchFirst`
+        """
+        if other is Ellipsis:
+            return _PendingSkip(self, must_skip=True)
+
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return MatchFirst([self, other])
+
+    def __ror__(self, other):
+        """
+        Implementation of | operator when left operand is not a :class:`ParserElement`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return other | self
+
+    def __xor__(self, other):
+        """
+        Implementation of ^ operator - returns :class:`Or`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return Or([self, other])
+
+    def __rxor__(self, other):
+        """
+        Implementation of ^ operator when left operand is not a :class:`ParserElement`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return other ^ self
+
+    def __and__(self, other):
+        """
+        Implementation of & operator - returns :class:`Each`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return Each([self, other])
+
+    def __rand__(self, other):
+        """
+        Implementation of & operator when left operand is not a :class:`ParserElement`
+        """
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        if not isinstance(other, ParserElement):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                          SyntaxWarning, stacklevel=2)
+            return None
+        return other & self
+
+    def __invert__(self):
+        """
+        Implementation of ~ operator - returns :class:`NotAny`
+        """
+        return NotAny(self)
+
+    def __iter__(self):
+        # must implement __iter__ to override legacy use of sequential access to __getitem__ to
+        # iterate over a sequence
+        raise TypeError('%r object is not iterable' % self.__class__.__name__)
+
+    def __getitem__(self, key):
+        """
+        use ``[]`` indexing notation as a short form for expression repetition:
+         - ``expr[n]`` is equivalent to ``expr*n``
+         - ``expr[m, n]`` is equivalent to ``expr*(m, n)``
+         - ``expr[n, ...]`` or ``expr[n,]`` is equivalent
+              to ``expr*n + ZeroOrMore(expr)``
+              (read as "at least n instances of ``expr``")
+         - ``expr[..., n]`` is equivalent to ``expr*(0, n)``
+              (read as "0 to n instances of ``expr``")
+         - ``expr[...]`` and ``expr[0, ...]`` are equivalent to ``ZeroOrMore(expr)``
+         - ``expr[1, ...]`` is equivalent to ``OneOrMore(expr)``
+         ``None`` may be used in place of ``...``.
+
+        Note that ``expr[..., n]`` and ``expr[m, n]``do not raise an exception
+        if more than ``n`` ``expr``s exist in the input stream.  If this behavior is
+        desired, then write ``expr[..., n] + ~expr``.
+       """
+
+        # convert single arg keys to tuples
+        try:
+            if isinstance(key, str):
+                key = (key,)
+            iter(key)
+        except TypeError:
+            key = (key, key)
+
+        if len(key) > 2:
+            warnings.warn("only 1 or 2 index arguments supported ({0}{1})".format(key[:5],
+                                                                                '... [{0}]'.format(len(key))
+                                                                                if len(key) > 5 else ''))
+
+        # clip to 2 elements
+        ret = self * tuple(key[:2])
+        return ret
+
+    def __call__(self, name=None):
+        """
+        Shortcut for :class:`setResultsName`, with ``listAllMatches=False``.
+
+        If ``name`` is given with a trailing ``'*'`` character, then ``listAllMatches`` will be
+        passed as ``True``.
+
+        If ``name` is omitted, same as calling :class:`copy`.
+
+        Example::
+
+            # these are equivalent
+            userdata = Word(alphas).setResultsName("name") + Word(nums + "-").setResultsName("socsecno")
+            userdata = Word(alphas)("name") + Word(nums + "-")("socsecno")
+        """
+        if name is not None:
+            return self._setResultsName(name)
+        else:
+            return self.copy()
+
+    def suppress(self):
+        """
+        Suppresses the output of this :class:`ParserElement`; useful to keep punctuation from
+        cluttering up returned output.
+        """
+        return Suppress(self)
+
+    def leaveWhitespace(self):
+        """
+        Disables the skipping of whitespace before matching the characters in the
+        :class:`ParserElement`'s defined pattern.  This is normally only used internally by
+        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
+        """
+        self.skipWhitespace = False
+        return self
+
+    def setWhitespaceChars(self, chars):
+        """
+        Overrides the default whitespace chars
+        """
+        self.skipWhitespace = True
+        self.whiteChars = chars
+        self.copyDefaultWhiteChars = False
+        return self
+
+    def parseWithTabs(self):
+        """
+        Overrides default behavior to expand ``<TAB>``s to spaces before parsing the input string.
+        Must be called before ``parseString`` when the input grammar contains elements that
+        match ``<TAB>`` characters.
+        """
+        self.keepTabs = True
+        return self
+
+    def ignore(self, other):
+        """
+        Define expression to be ignored (e.g., comments) while doing pattern
+        matching; may be called repeatedly, to define multiple comment or other
+        ignorable patterns.
+
+        Example::
+
+            patt = OneOrMore(Word(alphas))
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
+
+            patt.ignore(cStyleComment)
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
+        """
+        if isinstance(other, basestring):
+            other = Suppress(other)
+
+        if isinstance(other, Suppress):
+            if other not in self.ignoreExprs:
+                self.ignoreExprs.append(other)
+        else:
+            self.ignoreExprs.append(Suppress(other.copy()))
+        return self
+
+    def setDebugActions(self, startAction, successAction, exceptionAction):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        """
+        self.debugActions = (startAction or _defaultStartDebugAction,
+                             successAction or _defaultSuccessDebugAction,
+                             exceptionAction or _defaultExceptionDebugAction)
+        self.debug = True
+        return self
+
+    def setDebug(self, flag=True):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        Set ``flag`` to True to enable, False to disable.
+
+        Example::
+
+            wd = Word(alphas).setName("alphaword")
+            integer = Word(nums).setName("numword")
+            term = wd | integer
+
+            # turn on debugging for wd
+            wd.setDebug()
+
+            OneOrMore(term).parseString("abc 123 xyz 890")
+
+        prints::
+
+            Match alphaword at loc 0(1,1)
+            Matched alphaword -> ['abc']
+            Match alphaword at loc 3(1,4)
+            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
+            Match alphaword at loc 7(1,8)
+            Matched alphaword -> ['xyz']
+            Match alphaword at loc 11(1,12)
+            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
+            Match alphaword at loc 15(1,16)
+            Exception raised:Expected alphaword (at char 15), (line:1, col:16)
+
+        The output shown is that produced by the default debug actions - custom debug actions can be
+        specified using :class:`setDebugActions`. Prior to attempting
+        to match the ``wd`` expression, the debugging message ``"Match <exprname> at loc <n>(<line>,<col>)"``
+        is shown. Then if the parse succeeds, a ``"Matched"`` message is shown, or an ``"Exception raised"``
+        message is shown. Also note the use of :class:`setName` to assign a human-readable name to the expression,
+        which makes debugging and exception messages easier to understand - for instance, the default
+        name created for the :class:`Word` expression without calling ``setName`` is ``"W:(ABCD...)"``.
+        """
+        if flag:
+            self.setDebugActions(_defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction)
+        else:
+            self.debug = False
+        return self
+
+    def __str__(self):
+        return self.name
+
+    def __repr__(self):
+        return _ustr(self)
+
+    def streamline(self):
+        self.streamlined = True
+        self.strRepr = None
+        return self
+
+    def checkRecursion(self, parseElementList):
+        pass
+
+    def validate(self, validateTrace=None):
+        """
+        Check defined expressions for valid structure, check for infinite recursive definitions.
+        """
+        self.checkRecursion([])
+
+    def parseFile(self, file_or_filename, parseAll=False):
+        """
+        Execute the parse expression on the given file or filename.
+        If a filename is specified (instead of a file object),
+        the entire file is opened, read, and closed before parsing.
+        """
+        try:
+            file_contents = file_or_filename.read()
+        except AttributeError:
+            with open(file_or_filename, "r") as f:
+                file_contents = f.read()
+        try:
+            return self.parseString(file_contents, parseAll)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        elif isinstance(other, basestring):
+            return self.matches(other)
+        elif isinstance(other, ParserElement):
+            return vars(self) == vars(other)
+        return False
+
+    def __ne__(self, other):
+        return not (self == other)
+
+    def __hash__(self):
+        return id(self)
+
+    def __req__(self, other):
+        return self == other
+
+    def __rne__(self, other):
+        return not (self == other)
+
+    def matches(self, testString, parseAll=True):
+        """
+        Method for quick testing of a parser against a test string. Good for simple
+        inline microtests of sub expressions while building up larger parser.
+
+        Parameters:
+         - testString - to test against this expression for a match
+         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests
+
+        Example::
+
+            expr = Word(nums)
+            assert expr.matches("100")
+        """
+        try:
+            self.parseString(_ustr(testString), parseAll=parseAll)
+            return True
+        except ParseBaseException:
+            return False
+
+    def runTests(self, tests, parseAll=True, comment='#',
+                 fullDump=True, printResults=True, failureTests=False, postParse=None,
+                 file=None):
+        """
+        Execute the parse expression on a series of test strings, showing each
+        test, the parsed results or where the parse failed. Quick and easy way to
+        run a parse expression against a list of sample strings.
+
+        Parameters:
+         - tests - a list of separate test strings, or a multiline string of test strings
+         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests
+         - comment - (default= ``'#'``) - expression for indicating embedded comments in the test
+              string; pass None to disable comment filtering
+         - fullDump - (default= ``True``) - dump results as list followed by results names in nested outline;
+              if False, only dump nested list
+         - printResults - (default= ``True``) prints test output to stdout
+         - failureTests - (default= ``False``) indicates if these tests are expected to fail parsing
+         - postParse - (default= ``None``) optional callback for successful parse results; called as
+              `fn(test_string, parse_results)` and returns a string to be added to the test output
+         - file - (default=``None``) optional file-like object to which test output will be written;
+              if None, will default to ``sys.stdout``
+
+        Returns: a (success, results) tuple, where success indicates that all tests succeeded
+        (or failed if ``failureTests`` is True), and the results contain a list of lines of each
+        test's output
+
+        Example::
+
+            number_expr = pyparsing_common.number.copy()
+
+            result = number_expr.runTests('''
+                # unsigned integer
+                100
+                # negative integer
+                -100
+                # float with scientific notation
+                6.02e23
+                # integer with scientific notation
+                1e-12
+                ''')
+            print("Success" if result[0] else "Failed!")
+
+            result = number_expr.runTests('''
+                # stray character
+                100Z
+                # missing leading digit before '.'
+                -.100
+                # too many '.'
+                3.14.159
+                ''', failureTests=True)
+            print("Success" if result[0] else "Failed!")
+
+        prints::
+
+            # unsigned integer
+            100
+            [100]
+
+            # negative integer
+            -100
+            [-100]
+
+            # float with scientific notation
+            6.02e23
+            [6.02e+23]
+
+            # integer with scientific notation
+            1e-12
+            [1e-12]
+
+            Success
+
+            # stray character
+            100Z
+               ^
+            FAIL: Expected end of text (at char 3), (line:1, col:4)
+
+            # missing leading digit before '.'
+            -.100
+            ^
+            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)
+
+            # too many '.'
+            3.14.159
+                ^
+            FAIL: Expected end of text (at char 4), (line:1, col:5)
+
+            Success
+
+        Each test string must be on a single line. If you want to test a string that spans multiple
+        lines, create a test like this::
+
+            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
+
+        (Note that this is a raw string literal, you must include the leading 'r'.)
+        """
+        if isinstance(tests, basestring):
+            tests = list(map(str.strip, tests.rstrip().splitlines()))
+        if isinstance(comment, basestring):
+            comment = Literal(comment)
+        if file is None:
+            file = sys.stdout
+        print_ = file.write
+
+        allResults = []
+        comments = []
+        success = True
+        NL = Literal(r'\n').addParseAction(replaceWith('\n')).ignore(quotedString)
+        BOM = u'\ufeff'
+        for t in tests:
+            if comment is not None and comment.matches(t, False) or comments and not t:
+                comments.append(t)
+                continue
+            if not t:
+                continue
+            out = ['\n'.join(comments), t]
+            comments = []
+            try:
+                # convert newline marks to actual newlines, and strip leading BOM if present
+                t = NL.transformString(t.lstrip(BOM))
+                result = self.parseString(t, parseAll=parseAll)
+            except ParseBaseException as pe:
+                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                if '\n' in t:
+                    out.append(line(pe.loc, t))
+                    out.append(' ' * (col(pe.loc, t) - 1) + '^' + fatal)
+                else:
+                    out.append(' ' * pe.loc + '^' + fatal)
+                out.append("FAIL: " + str(pe))
+                success = success and failureTests
+                result = pe
+            except Exception as exc:
+                out.append("FAIL-EXCEPTION: " + str(exc))
+                success = success and failureTests
+                result = exc
+            else:
+                success = success and not failureTests
+                if postParse is not None:
+                    try:
+                        pp_value = postParse(t, result)
+                        if pp_value is not None:
+                            if isinstance(pp_value, ParseResults):
+                                out.append(pp_value.dump())
+                            else:
+                                out.append(str(pp_value))
+                        else:
+                            out.append(result.dump())
+                    except Exception as e:
+                        out.append(result.dump(full=fullDump))
+                        out.append("{0} failed: {1}: {2}".format(postParse.__name__, type(e).__name__, e))
+                else:
+                    out.append(result.dump(full=fullDump))
+
+            if printResults:
+                if fullDump:
+                    out.append('')
+                print_('\n'.join(out))
+
+            allResults.append((t, result))
+
+        return success, allResults
+
+
+class _PendingSkip(ParserElement):
+    # internal placeholder class to hold a place were '...' is added to a parser element,
+    # once another ParserElement is added, this placeholder will be replaced with a SkipTo
+    def __init__(self, expr, must_skip=False):
+        super(_PendingSkip, self).__init__()
+        self.strRepr = str(expr + Empty()).replace('Empty', '...')
+        self.name = self.strRepr
+        self.anchor = expr
+        self.must_skip = must_skip
+
+    def __add__(self, other):
+        skipper = SkipTo(other).setName("...")("_skipped*")
+        if self.must_skip:
+            def must_skip(t):
+                if not t._skipped or t._skipped.asList() == ['']:
+                    del t[0]
+                    t.pop("_skipped", None)
+            def show_skip(t):
+                if t._skipped.asList()[-1:] == ['']:
+                    skipped = t.pop('_skipped')
+                    t['_skipped'] = 'missing <' + repr(self.anchor) + '>'
+            return (self.anchor + skipper().addParseAction(must_skip)
+                    | skipper().addParseAction(show_skip)) + other
+
+        return self.anchor + skipper + other
+
+    def __repr__(self):
+        return self.strRepr
+
+    def parseImpl(self, *args):
+        raise Exception("use of `...` expression without following SkipTo target expression")
+
+
+class Token(ParserElement):
+    """Abstract :class:`ParserElement` subclass, for defining atomic
+    matching patterns.
+    """
+    def __init__(self):
+        super(Token, self).__init__(savelist=False)
+
+
+class Empty(Token):
+    """An empty token, will always match.
+    """
+    def __init__(self):
+        super(Empty, self).__init__()
+        self.name = "Empty"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+
+class NoMatch(Token):
+    """A token that will never match.
+    """
+    def __init__(self):
+        super(NoMatch, self).__init__()
+        self.name = "NoMatch"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.errmsg = "Unmatchable token"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Literal(Token):
+    """Token to exactly match a specified string.
+
+    Example::
+
+        Literal('blah').parseString('blah')  # -> ['blah']
+        Literal('blah').parseString('blahfooblah')  # -> ['blah']
+        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
+
+    For case-insensitive matching, use :class:`CaselessLiteral`.
+
+    For keyword matching (force word break before and after the matched string),
+    use :class:`Keyword` or :class:`CaselessKeyword`.
+    """
+    def __init__(self, matchString):
+        super(Literal, self).__init__()
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Literal; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+            self.__class__ = Empty
+        self.name = '"%s"' % _ustr(self.match)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+
+        # Performance tuning: modify __class__ to select
+        # a parseImpl optimized for single-character check
+        if self.matchLen == 1 and type(self) is Literal:
+            self.__class__ = _SingleCharLiteral
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc] == self.firstMatchChar and instring.startswith(self.match, loc):
+            return loc + self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class _SingleCharLiteral(Literal):
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc] == self.firstMatchChar:
+            return loc + 1, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+_L = Literal
+ParserElement._literalStringClass = Literal
+
+class Keyword(Token):
+    """Token to exactly match a specified string as a keyword, that is,
+    it must be immediately followed by a non-keyword character.  Compare
+    with :class:`Literal`:
+
+     - ``Literal("if")`` will match the leading ``'if'`` in
+       ``'ifAndOnlyIf'``.
+     - ``Keyword("if")`` will not; it will only match the leading
+       ``'if'`` in ``'if x=1'``, or ``'if(y==2)'``
+
+    Accepts two optional constructor arguments in addition to the
+    keyword string:
+
+     - ``identChars`` is a string of characters that would be valid
+       identifier characters, defaulting to all alphanumerics + "_" and
+       "$"
+     - ``caseless`` allows case-insensitive matching, default is ``False``.
+
+    Example::
+
+        Keyword("start").parseString("start")  # -> ['start']
+        Keyword("start").parseString("starting")  # -> Exception
+
+    For case-insensitive matching, use :class:`CaselessKeyword`.
+    """
+    DEFAULT_KEYWORD_CHARS = alphanums + "_$"
+
+    def __init__(self, matchString, identChars=None, caseless=False):
+        super(Keyword, self).__init__()
+        if identChars is None:
+            identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Keyword; use Empty() instead",
+                          SyntaxWarning, stacklevel=2)
+        self.name = '"%s"' % self.match
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+        self.caseless = caseless
+        if caseless:
+            self.caselessmatch = matchString.upper()
+            identChars = identChars.upper()
+        self.identChars = set(identChars)
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if self.caseless:
+            if ((instring[loc:loc + self.matchLen].upper() == self.caselessmatch)
+                    and (loc >= len(instring) - self.matchLen
+                         or instring[loc + self.matchLen].upper() not in self.identChars)
+                    and (loc == 0
+                         or instring[loc - 1].upper() not in self.identChars)):
+                return loc + self.matchLen, self.match
+
+        else:
+            if instring[loc] == self.firstMatchChar:
+                if ((self.matchLen == 1 or instring.startswith(self.match, loc))
+                        and (loc >= len(instring) - self.matchLen
+                             or instring[loc + self.matchLen] not in self.identChars)
+                        and (loc == 0 or instring[loc - 1] not in self.identChars)):
+                    return loc + self.matchLen, self.match
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+    def copy(self):
+        c = super(Keyword, self).copy()
+        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        return c
+
+    @staticmethod
+    def setDefaultKeywordChars(chars):
+        """Overrides the default Keyword chars
+        """
+        Keyword.DEFAULT_KEYWORD_CHARS = chars
+
+class CaselessLiteral(Literal):
+    """Token to match a specified string, ignoring case of letters.
+    Note: the matched results will always be in the case of the given
+    match string, NOT the case of the input text.
+
+    Example::
+
+        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
+
+    (Contrast with example for :class:`CaselessKeyword`.)
+    """
+    def __init__(self, matchString):
+        super(CaselessLiteral, self).__init__(matchString.upper())
+        # Preserve the defining literal.
+        self.returnString = matchString
+        self.name = "'%s'" % self.returnString
+        self.errmsg = "Expected " + self.name
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc:loc + self.matchLen].upper() == self.match:
+            return loc + self.matchLen, self.returnString
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CaselessKeyword(Keyword):
+    """
+    Caseless version of :class:`Keyword`.
+
+    Example::
+
+        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
+
+    (Contrast with example for :class:`CaselessLiteral`.)
+    """
+    def __init__(self, matchString, identChars=None):
+        super(CaselessKeyword, self).__init__(matchString, identChars, caseless=True)
+
+class CloseMatch(Token):
+    """A variation on :class:`Literal` which matches "close" matches,
+    that is, strings with at most 'n' mismatching characters.
+    :class:`CloseMatch` takes parameters:
+
+     - ``match_string`` - string to be matched
+     - ``maxMismatches`` - (``default=1``) maximum number of
+       mismatches allowed to count as a match
+
+    The results from a successful parse will contain the matched text
+    from the input string and the following named results:
+
+     - ``mismatches`` - a list of the positions within the
+       match_string where mismatches were found
+     - ``original`` - the original match_string used to compare
+       against the input string
+
+    If ``mismatches`` is an empty list, then the match was an exact
+    match.
+
+    Example::
+
+        patt = CloseMatch("ATCATCGAATGGA")
+        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
+        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)
+
+        # exact match
+        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})
+
+        # close match allowing up to 2 mismatches
+        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
+        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
+    """
+    def __init__(self, match_string, maxMismatches=1):
+        super(CloseMatch, self).__init__()
+        self.name = match_string
+        self.match_string = match_string
+        self.maxMismatches = maxMismatches
+        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
+        self.mayIndexError = False
+        self.mayReturnEmpty = False
+
+    def parseImpl(self, instring, loc, doActions=True):
+        start = loc
+        instrlen = len(instring)
+        maxloc = start + len(self.match_string)
+
+        if maxloc <= instrlen:
+            match_string = self.match_string
+            match_stringloc = 0
+            mismatches = []
+            maxMismatches = self.maxMismatches
+
+            for match_stringloc, s_m in enumerate(zip(instring[loc:maxloc], match_string)):
+                src, mat = s_m
+                if src != mat:
+                    mismatches.append(match_stringloc)
+                    if len(mismatches) > maxMismatches:
+                        break
+            else:
+                loc = match_stringloc + 1
+                results = ParseResults([instring[start:loc]])
+                results['original'] = match_string
+                results['mismatches'] = mismatches
+                return loc, results
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Word(Token):
+    """Token for matching words composed of allowed character sets.
+    Defined with string containing all allowed initial characters, an
+    optional string containing allowed body characters (if omitted,
+    defaults to the initial character set), and an optional minimum,
+    maximum, and/or exact length.  The default value for ``min`` is
+    1 (a minimum value < 1 is not valid); the default values for
+    ``max`` and ``exact`` are 0, meaning no maximum or exact
+    length restriction. An optional ``excludeChars`` parameter can
+    list characters that might be found in the input ``bodyChars``
+    string; useful to define a word of all printables except for one or
+    two characters, for instance.
+
+    :class:`srange` is useful for defining custom character set strings
+    for defining ``Word`` expressions, using range notation from
+    regular expression character sets.
+
+    A common mistake is to use :class:`Word` to match a specific literal
+    string, as in ``Word("Address")``. Remember that :class:`Word`
+    uses the string argument to define *sets* of matchable characters.
+    This expression would match "Add", "AAA", "dAred", or any other word
+    made up of the characters 'A', 'd', 'r', 'e', and 's'. To match an
+    exact literal string, use :class:`Literal` or :class:`Keyword`.
+
+    pyparsing includes helper strings for building Words:
+
+     - :class:`alphas`
+     - :class:`nums`
+     - :class:`alphanums`
+     - :class:`hexnums`
+     - :class:`alphas8bit` (alphabetic characters in ASCII range 128-255
+       - accented, tilded, umlauted, etc.)
+     - :class:`punc8bit` (non-alphabetic characters in ASCII range
+       128-255 - currency, symbols, superscripts, diacriticals, etc.)
+     - :class:`printables` (any non-whitespace character)
+
+    Example::
+
+        # a word composed of digits
+        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
+
+        # a word with a leading capital, and zero or more lowercase
+        capital_word = Word(alphas.upper(), alphas.lower())
+
+        # hostnames are alphanumeric, with leading alpha, and '-'
+        hostname = Word(alphas, alphanums + '-')
+
+        # roman numeral (not a strict parser, accepts invalid mix of characters)
+        roman = Word("IVXLCDM")
+
+        # any string of non-whitespace characters, except for ','
+        csv_value = Word(printables, excludeChars=",")
+    """
+    def __init__(self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None):
+        super(Word, self).__init__()
+        if excludeChars:
+            excludeChars = set(excludeChars)
+            initChars = ''.join(c for c in initChars if c not in excludeChars)
+            if bodyChars:
+                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
+        self.initCharsOrig = initChars
+        self.initChars = set(initChars)
+        if bodyChars:
+            self.bodyCharsOrig = bodyChars
+            self.bodyChars = set(bodyChars)
+        else:
+            self.bodyCharsOrig = initChars
+            self.bodyChars = set(initChars)
+
+        self.maxSpecified = max > 0
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.asKeyword = asKeyword
+
+        if ' ' not in self.initCharsOrig + self.bodyCharsOrig and (min == 1 and max == 0 and exact == 0):
+            if self.bodyCharsOrig == self.initCharsOrig:
+                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
+            elif len(self.initCharsOrig) == 1:
+                self.reString = "%s[%s]*" % (re.escape(self.initCharsOrig),
+                                             _escapeRegexRangeChars(self.bodyCharsOrig),)
+            else:
+                self.reString = "[%s][%s]*" % (_escapeRegexRangeChars(self.initCharsOrig),
+                                               _escapeRegexRangeChars(self.bodyCharsOrig),)
+            if self.asKeyword:
+                self.reString = r"\b" + self.reString + r"\b"
+
+            try:
+                self.re = re.compile(self.reString)
+            except Exception:
+                self.re = None
+            else:
+                self.re_match = self.re.match
+                self.__class__ = _WordRegex
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc] not in self.initChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        instrlen = len(instring)
+        bodychars = self.bodyChars
+        maxloc = start + self.maxLen
+        maxloc = min(maxloc, instrlen)
+        while loc < maxloc and instring[loc] in bodychars:
+            loc += 1
+
+        throwException = False
+        if loc - start < self.minLen:
+            throwException = True
+        elif self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
+            throwException = True
+        elif self.asKeyword:
+            if (start > 0 and instring[start - 1] in bodychars
+                    or loc < instrlen and instring[loc] in bodychars):
+                throwException = True
+
+        if throwException:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__(self):
+        try:
+            return super(Word, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+
+            def charsAsStr(s):
+                if len(s) > 4:
+                    return s[:4] + "..."
+                else:
+                    return s
+
+            if self.initCharsOrig != self.bodyCharsOrig:
+                self.strRepr = "W:(%s, %s)" % (charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig))
+            else:
+                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
+
+        return self.strRepr
+
+class _WordRegex(Word):
+    def parseImpl(self, instring, loc, doActions=True):
+        result = self.re_match(instring, loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        return loc, result.group()
+
+
+class Char(_WordRegex):
+    """A short-cut class for defining ``Word(characters, exact=1)``,
+    when defining a match of any single character in a string of
+    characters.
+    """
+    def __init__(self, charset, asKeyword=False, excludeChars=None):
+        super(Char, self).__init__(charset, exact=1, asKeyword=asKeyword, excludeChars=excludeChars)
+        self.reString = "[%s]" % _escapeRegexRangeChars(''.join(self.initChars))
+        if asKeyword:
+            self.reString = r"\b%s\b" % self.reString
+        self.re = re.compile(self.reString)
+        self.re_match = self.re.match
+
+
+class Regex(Token):
+    r"""Token for matching strings that match a given regular
+    expression. Defined with string specifying the regular expression in
+    a form recognized by the stdlib Python  `re module <https://docs.python.org/3/library/re.html>`_.
+    If the given regex contains named groups (defined using ``(?P<name>...)``),
+    these will be preserved as named parse results.
+
+    If instead of the Python stdlib re module you wish to use a different RE module
+    (such as the `regex` module), you can replace it by either building your
+    Regex object with a compiled RE that was compiled using regex:
+
+    Example::
+
+        realnum = Regex(r"[+-]?\d+\.\d*")
+        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
+        # ref: https://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
+        roman = Regex(r"M{0,4}(CM|CD|D?{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
+
+        # use regex module instead of stdlib re module to construct a Regex using
+        # a compiled regular expression
+        import regex
+        parser = pp.Regex(regex.compile(r'[0-9]'))
+
+    """
+    def __init__(self, pattern, flags=0, asGroupList=False, asMatch=False):
+        """The parameters ``pattern`` and ``flags`` are passed
+        to the ``re.compile()`` function as-is. See the Python
+        `re module <https://docs.python.org/3/library/re.html>`_ module for an
+        explanation of the acceptable patterns and flags.
+        """
+        super(Regex, self).__init__()
+
+        if isinstance(pattern, basestring):
+            if not pattern:
+                warnings.warn("null string passed to Regex; use Empty() instead",
+                              SyntaxWarning, stacklevel=2)
+
+            self.pattern = pattern
+            self.flags = flags
+
+            try:
+                self.re = re.compile(self.pattern, self.flags)
+                self.reString = self.pattern
+            except sre_constants.error:
+                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
+                              SyntaxWarning, stacklevel=2)
+                raise
+
+        elif hasattr(pattern, 'pattern') and hasattr(pattern, 'match'):
+            self.re = pattern
+            self.pattern = self.reString = pattern.pattern
+            self.flags = flags
+
+        else:
+            raise TypeError("Regex may only be constructed with a string or a compiled RE object")
+
+        self.re_match = self.re.match
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+        self.asGroupList = asGroupList
+        self.asMatch = asMatch
+        if self.asGroupList:
+            self.parseImpl = self.parseImplAsGroupList
+        if self.asMatch:
+            self.parseImpl = self.parseImplAsMatch
+
+    def parseImpl(self, instring, loc, doActions=True):
+        result = self.re_match(instring, loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = ParseResults(result.group())
+        d = result.groupdict()
+        if d:
+            for k, v in d.items():
+                ret[k] = v
+        return loc, ret
+
+    def parseImplAsGroupList(self, instring, loc, doActions=True):
+        result = self.re_match(instring, loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.groups()
+        return loc, ret
+
+    def parseImplAsMatch(self, instring, loc, doActions=True):
+        result = self.re_match(instring, loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result
+        return loc, ret
+
+    def __str__(self):
+        try:
+            return super(Regex, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "Re:(%s)" % repr(self.pattern)
+
+        return self.strRepr
+
+    def sub(self, repl):
+        r"""
+        Return Regex with an attached parse action to transform the parsed
+        result as if called using `re.sub(expr, repl, string) <https://docs.python.org/3/library/re.html#re.sub>`_.
+
+        Example::
+
+            make_html = Regex(r"(\w+):(.*?):").sub(r"<\1>\2</\1>")
+            print(make_html.transformString("h1:main title:"))
+            # prints "<h1>main title</h1>"
+        """
+        if self.asGroupList:
+            warnings.warn("cannot use sub() with Regex(asGroupList=True)",
+                          SyntaxWarning, stacklevel=2)
+            raise SyntaxError()
+
+        if self.asMatch and callable(repl):
+            warnings.warn("cannot use sub() with a callable with Regex(asMatch=True)",
+                          SyntaxWarning, stacklevel=2)
+            raise SyntaxError()
+
+        if self.asMatch:
+            def pa(tokens):
+                return tokens[0].expand(repl)
+        else:
+            def pa(tokens):
+                return self.re.sub(repl, tokens[0])
+        return self.addParseAction(pa)
+
+class QuotedString(Token):
+    r"""
+    Token for matching strings that are delimited by quoting characters.
+
+    Defined with the following parameters:
+
+        - quoteChar - string of one or more characters defining the
+          quote delimiting string
+        - escChar - character to escape quotes, typically backslash
+          (default= ``None``)
+        - escQuote - special quote sequence to escape an embedded quote
+          string (such as SQL's ``""`` to escape an embedded ``"``)
+          (default= ``None``)
+        - multiline - boolean indicating whether quotes can span
+          multiple lines (default= ``False``)
+        - unquoteResults - boolean indicating whether the matched text
+          should be unquoted (default= ``True``)
+        - endQuoteChar - string of one or more characters defining the
+          end of the quote delimited string (default= ``None``  => same as
+          quoteChar)
+        - convertWhitespaceEscapes - convert escaped whitespace
+          (``'\t'``, ``'\n'``, etc.) to actual whitespace
+          (default= ``True``)
+
+    Example::
+
+        qs = QuotedString('"')
+        print(qs.searchString('lsjdf "This is the quote" sldjf'))
+        complex_qs = QuotedString('{{', endQuoteChar='}}')
+        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
+        sql_qs = QuotedString('"', escQuote='""')
+        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
+
+    prints::
+
+        [['This is the quote']]
+        [['This is the "quote"']]
+        [['This is the quote with "embedded" quotes']]
+    """
+    def __init__(self, quoteChar, escChar=None, escQuote=None, multiline=False,
+                 unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
+        super(QuotedString, self).__init__()
+
+        # remove white space from quote chars - wont work anyway
+        quoteChar = quoteChar.strip()
+        if not quoteChar:
+            warnings.warn("quoteChar cannot be the empty string", SyntaxWarning, stacklevel=2)
+            raise SyntaxError()
+
+        if endQuoteChar is None:
+            endQuoteChar = quoteChar
+        else:
+            endQuoteChar = endQuoteChar.strip()
+            if not endQuoteChar:
+                warnings.warn("endQuoteChar cannot be the empty string", SyntaxWarning, stacklevel=2)
+                raise SyntaxError()
+
+        self.quoteChar = quoteChar
+        self.quoteCharLen = len(quoteChar)
+        self.firstQuoteChar = quoteChar[0]
+        self.endQuoteChar = endQuoteChar
+        self.endQuoteCharLen = len(endQuoteChar)
+        self.escChar = escChar
+        self.escQuote = escQuote
+        self.unquoteResults = unquoteResults
+        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+
+        if multiline:
+            self.flags = re.MULTILINE | re.DOTALL
+            self.pattern = r'%s(?:[^%s%s]' % (re.escape(self.quoteChar),
+                                              _escapeRegexRangeChars(self.endQuoteChar[0]),
+                                              (escChar is not None and _escapeRegexRangeChars(escChar) or ''))
+        else:
+            self.flags = 0
+            self.pattern = r'%s(?:[^%s\n\r%s]' % (re.escape(self.quoteChar),
+                                                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                                                  (escChar is not None and _escapeRegexRangeChars(escChar) or ''))
+        if len(self.endQuoteChar) > 1:
+            self.pattern += (
+                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
+                                                   _escapeRegexRangeChars(self.endQuoteChar[i]))
+                                      for i in range(len(self.endQuoteChar) - 1, 0, -1)) + ')')
+
+        if escQuote:
+            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
+        if escChar:
+            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
+            self.escCharReplacePattern = re.escape(self.escChar) + "(.)"
+        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
+
+        try:
+            self.re = re.compile(self.pattern, self.flags)
+            self.reString = self.pattern
+            self.re_match = self.re.match
+        except sre_constants.error:
+            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
+                          SyntaxWarning, stacklevel=2)
+            raise
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl(self, instring, loc, doActions=True):
+        result = instring[loc] == self.firstQuoteChar and self.re_match(instring, loc) or None
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.group()
+
+        if self.unquoteResults:
+
+            # strip off quotes
+            ret = ret[self.quoteCharLen: -self.endQuoteCharLen]
+
+            if isinstance(ret, basestring):
+                # replace escaped whitespace
+                if '\\' in ret and self.convertWhitespaceEscapes:
+                    ws_map = {
+                        r'\t': '\t',
+                        r'\n': '\n',
+                        r'\f': '\f',
+                        r'\r': '\r',
+                    }
+                    for wslit, wschar in ws_map.items():
+                        ret = ret.replace(wslit, wschar)
+
+                # replace escaped characters
+                if self.escChar:
+                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+
+                # replace escaped quotes
+                if self.escQuote:
+                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+
+        return loc, ret
+
+    def __str__(self):
+        try:
+            return super(QuotedString, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
+
+        return self.strRepr
+
+
+class CharsNotIn(Token):
+    """Token for matching words composed of characters *not* in a given
+    set (will include whitespace in matched characters if not listed in
+    the provided exclusion set - see example). Defined with string
+    containing all disallowed characters, and an optional minimum,
+    maximum, and/or exact length.  The default value for ``min`` is
+    1 (a minimum value < 1 is not valid); the default values for
+    ``max`` and ``exact`` are 0, meaning no maximum or exact
+    length restriction.
+
+    Example::
+
+        # define a comma-separated-value as anything that is not a ','
+        csv_value = CharsNotIn(',')
+        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
+
+    prints::
+
+        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
+    """
+    def __init__(self, notChars, min=1, max=0, exact=0):
+        super(CharsNotIn, self).__init__()
+        self.skipWhitespace = False
+        self.notChars = notChars
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use "
+                             "Optional(CharsNotIn()) if zero-length char group is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = (self.minLen == 0)
+        self.mayIndexError = False
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc] in self.notChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        notchars = self.notChars
+        maxlen = min(start + self.maxLen, len(instring))
+        while loc < maxlen and instring[loc] not in notchars:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__(self):
+        try:
+            return super(CharsNotIn, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            if len(self.notChars) > 4:
+                self.strRepr = "!W:(%s...)" % self.notChars[:4]
+            else:
+                self.strRepr = "!W:(%s)" % self.notChars
+
+        return self.strRepr
+
+class White(Token):
+    """Special matching class for matching whitespace.  Normally,
+    whitespace is ignored by pyparsing grammars.  This class is included
+    when some whitespace structures are significant.  Define with
+    a string containing the whitespace characters to be matched; default
+    is ``" \\t\\r\\n"``.  Also takes optional ``min``,
+    ``max``, and ``exact`` arguments, as defined for the
+    :class:`Word` class.
+    """
+    whiteStrs = {
+        ' ' : '<SP>',
+        '\t': '<TAB>',
+        '\n': '<LF>',
+        '\r': '<CR>',
+        '\f': '<FF>',
+        u'\u00A0': '<NBSP>',
+        u'\u1680': '<OGHAM_SPACE_MARK>',
+        u'\u180E': '<MONGOLIAN_VOWEL_SEPARATOR>',
+        u'\u2000': '<EN_QUAD>',
+        u'\u2001': '<EM_QUAD>',
+        u'\u2002': '<EN_SPACE>',
+        u'\u2003': '<EM_SPACE>',
+        u'\u2004': '<THREE-PER-EM_SPACE>',
+        u'\u2005': '<FOUR-PER-EM_SPACE>',
+        u'\u2006': '<SIX-PER-EM_SPACE>',
+        u'\u2007': '<FIGURE_SPACE>',
+        u'\u2008': '<PUNCTUATION_SPACE>',
+        u'\u2009': '<THIN_SPACE>',
+        u'\u200A': '<HAIR_SPACE>',
+        u'\u200B': '<ZERO_WIDTH_SPACE>',
+        u'\u202F': '<NNBSP>',
+        u'\u205F': '<MMSP>',
+        u'\u3000': '<IDEOGRAPHIC_SPACE>',
+        }
+    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
+        super(White, self).__init__()
+        self.matchWhite = ws
+        self.setWhitespaceChars("".join(c for c in self.whiteChars if c not in self.matchWhite))
+        # ~ self.leaveWhitespace()
+        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
+        self.mayReturnEmpty = True
+        self.errmsg = "Expected " + self.name
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if instring[loc] not in self.matchWhite:
+            raise ParseException(instring, loc, self.errmsg, self)
+        start = loc
+        loc += 1
+        maxloc = start + self.maxLen
+        maxloc = min(maxloc, len(instring))
+        while loc < maxloc and instring[loc] in self.matchWhite:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+
+class _PositionToken(Token):
+    def __init__(self):
+        super(_PositionToken, self).__init__()
+        self.name = self.__class__.__name__
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+class GoToColumn(_PositionToken):
+    """Token to advance to a specific column of input text; useful for
+    tabular report scraping.
+    """
+    def __init__(self, colno):
+        super(GoToColumn, self).__init__()
+        self.col = colno
+
+    def preParse(self, instring, loc):
+        if col(loc, instring) != self.col:
+            instrlen = len(instring)
+            if self.ignoreExprs:
+                loc = self._skipIgnorables(instring, loc)
+            while loc < instrlen and instring[loc].isspace() and col(loc, instring) != self.col:
+                loc += 1
+        return loc
+
+    def parseImpl(self, instring, loc, doActions=True):
+        thiscol = col(loc, instring)
+        if thiscol > self.col:
+            raise ParseException(instring, loc, "Text not in expected column", self)
+        newloc = loc + self.col - thiscol
+        ret = instring[loc: newloc]
+        return newloc, ret
+
+
+class LineStart(_PositionToken):
+    r"""Matches if current position is at the beginning of a line within
+    the parse string
+
+    Example::
+
+        test = '''\
+        AAA this line
+        AAA and this line
+          AAA but not this one
+        B AAA and definitely not this one
+        '''
+
+        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
+            print(t)
+
+    prints::
+
+        ['AAA', ' this line']
+        ['AAA', ' and this line']
+
+    """
+    def __init__(self):
+        super(LineStart, self).__init__()
+        self.errmsg = "Expected start of line"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if col(loc, instring) == 1:
+            return loc, []
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class LineEnd(_PositionToken):
+    """Matches if current position is at the end of a line within the
+    parse string
+    """
+    def __init__(self):
+        super(LineEnd, self).__init__()
+        self.setWhitespaceChars(ParserElement.DEFAULT_WHITE_CHARS.replace("\n", ""))
+        self.errmsg = "Expected end of line"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if loc < len(instring):
+            if instring[loc] == "\n":
+                return loc + 1, "\n"
+            else:
+                raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc + 1, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class StringStart(_PositionToken):
+    """Matches if current position is at the beginning of the parse
+    string
+    """
+    def __init__(self):
+        super(StringStart, self).__init__()
+        self.errmsg = "Expected start of text"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if loc != 0:
+            # see if entire string up to here is just whitespace and ignoreables
+            if loc != self.preParse(instring, 0):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class StringEnd(_PositionToken):
+    """Matches if current position is at the end of the parse string
+    """
+    def __init__(self):
+        super(StringEnd, self).__init__()
+        self.errmsg = "Expected end of text"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if loc < len(instring):
+            raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc + 1, []
+        elif loc > len(instring):
+            return loc, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class WordStart(_PositionToken):
+    """Matches if the current position is at the beginning of a Word,
+    and is not preceded by any character in a given set of
+    ``wordChars`` (default= ``printables``). To emulate the
+    ``\b`` behavior of regular expressions, use
+    ``WordStart(alphanums)``. ``WordStart`` will also match at
+    the beginning of the string being parsed, or at the beginning of
+    a line.
+    """
+    def __init__(self, wordChars=printables):
+        super(WordStart, self).__init__()
+        self.wordChars = set(wordChars)
+        self.errmsg = "Not at the start of a word"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if loc != 0:
+            if (instring[loc - 1] in self.wordChars
+                    or instring[loc] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class WordEnd(_PositionToken):
+    """Matches if the current position is at the end of a Word, and is
+    not followed by any character in a given set of ``wordChars``
+    (default= ``printables``). To emulate the ``\b`` behavior of
+    regular expressions, use ``WordEnd(alphanums)``. ``WordEnd``
+    will also match at the end of the string being parsed, or at the end
+    of a line.
+    """
+    def __init__(self, wordChars=printables):
+        super(WordEnd, self).__init__()
+        self.wordChars = set(wordChars)
+        self.skipWhitespace = False
+        self.errmsg = "Not at the end of a word"
+
+    def parseImpl(self, instring, loc, doActions=True):
+        instrlen = len(instring)
+        if instrlen > 0 and loc < instrlen:
+            if (instring[loc] in self.wordChars or
+                    instring[loc - 1] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+
+class ParseExpression(ParserElement):
+    """Abstract subclass of ParserElement, for combining and
+    post-processing parsed tokens.
+    """
+    def __init__(self, exprs, savelist=False):
+        super(ParseExpression, self).__init__(savelist)
+        if isinstance(exprs, _generatorType):
+            exprs = list(exprs)
+
+        if isinstance(exprs, basestring):
+            self.exprs = [self._literalStringClass(exprs)]
+        elif isinstance(exprs, ParserElement):
+            self.exprs = [exprs]
+        elif isinstance(exprs, Iterable):
+            exprs = list(exprs)
+            # if sequence of strings provided, wrap with Literal
+            if any(isinstance(expr, basestring) for expr in exprs):
+                exprs = (self._literalStringClass(e) if isinstance(e, basestring) else e for e in exprs)
+            self.exprs = list(exprs)
+        else:
+            try:
+                self.exprs = list(exprs)
+            except TypeError:
+                self.exprs = [exprs]
+        self.callPreparse = False
+
+    def append(self, other):
+        self.exprs.append(other)
+        self.strRepr = None
+        return self
+
+    def leaveWhitespace(self):
+        """Extends ``leaveWhitespace`` defined in base class, and also invokes ``leaveWhitespace`` on
+           all contained expressions."""
+        self.skipWhitespace = False
+        self.exprs = [e.copy() for e in self.exprs]
+        for e in self.exprs:
+            e.leaveWhitespace()
+        return self
+
+    def ignore(self, other):
+        if isinstance(other, Suppress):
+            if other not in self.ignoreExprs:
+                super(ParseExpression, self).ignore(other)
+                for e in self.exprs:
+                    e.ignore(self.ignoreExprs[-1])
+        else:
+            super(ParseExpression, self).ignore(other)
+            for e in self.exprs:
+                e.ignore(self.ignoreExprs[-1])
+        return self
+
+    def __str__(self):
+        try:
+            return super(ParseExpression, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "%s:(%s)" % (self.__class__.__name__, _ustr(self.exprs))
+        return self.strRepr
+
+    def streamline(self):
+        super(ParseExpression, self).streamline()
+
+        for e in self.exprs:
+            e.streamline()
+
+        # collapse nested And's of the form And(And(And(a, b), c), d) to And(a, b, c, d)
+        # but only if there are no parse actions or resultsNames on the nested And's
+        # (likewise for Or's and MatchFirst's)
+        if len(self.exprs) == 2:
+            other = self.exprs[0]
+            if (isinstance(other, self.__class__)
+                    and not other.parseAction
+                    and other.resultsName is None
+                    and not other.debug):
+                self.exprs = other.exprs[:] + [self.exprs[1]]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+            other = self.exprs[-1]
+            if (isinstance(other, self.__class__)
+                    and not other.parseAction
+                    and other.resultsName is None
+                    and not other.debug):
+                self.exprs = self.exprs[:-1] + other.exprs[:]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+        self.errmsg = "Expected " + _ustr(self)
+
+        return self
+
+    def validate(self, validateTrace=None):
+        tmp = (validateTrace if validateTrace is not None else [])[:] + [self]
+        for e in self.exprs:
+            e.validate(tmp)
+        self.checkRecursion([])
+
+    def copy(self):
+        ret = super(ParseExpression, self).copy()
+        ret.exprs = [e.copy() for e in self.exprs]
+        return ret
+
+    def _setResultsName(self, name, listAllMatches=False):
+        if __diag__.warn_ungrouped_named_tokens_in_collection:
+            for e in self.exprs:
+                if isinstance(e, ParserElement) and e.resultsName:
+                    warnings.warn("{0}: setting results name {1!r} on {2} expression "
+                                  "collides with {3!r} on contained expression".format("warn_ungrouped_named_tokens_in_collection",
+                                                                                       name,
+                                                                                       type(self).__name__,
+                                                                                       e.resultsName),
+                                  stacklevel=3)
+
+        return super(ParseExpression, self)._setResultsName(name, listAllMatches)
+
+
+class And(ParseExpression):
+    """
+    Requires all given :class:`ParseExpression` s to be found in the given order.
+    Expressions may be separated by whitespace.
+    May be constructed using the ``'+'`` operator.
+    May also be constructed using the ``'-'`` operator, which will
+    suppress backtracking.
+
+    Example::
+
+        integer = Word(nums)
+        name_expr = OneOrMore(Word(alphas))
+
+        expr = And([integer("id"), name_expr("name"), integer("age")])
+        # more easily written as:
+        expr = integer("id") + name_expr("name") + integer("age")
+    """
+
+    class _ErrorStop(Empty):
+        def __init__(self, *args, **kwargs):
+            super(And._ErrorStop, self).__init__(*args, **kwargs)
+            self.name = '-'
+            self.leaveWhitespace()
+
+    def __init__(self, exprs, savelist=True):
+        if exprs and Ellipsis in exprs:
+            tmp = []
+            for i, expr in enumerate(exprs):
+                if expr is Ellipsis:
+                    if i < len(exprs) - 1:
+                        skipto_arg = (Empty() + exprs[i + 1]).exprs[-1]
+                        tmp.append(SkipTo(skipto_arg)("_skipped*"))
+                    else:
+                        raise Exception("cannot construct And with sequence ending in ...")
+                else:
+                    tmp.append(expr)
+            exprs[:] = tmp
+        super(And, self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.setWhitespaceChars(self.exprs[0].whiteChars)
+        self.skipWhitespace = self.exprs[0].skipWhitespace
+        self.callPreparse = True
+
+    def streamline(self):
+        # collapse any _PendingSkip's
+        if self.exprs:
+            if any(isinstance(e, ParseExpression) and e.exprs and isinstance(e.exprs[-1], _PendingSkip)
+                   for e in self.exprs[:-1]):
+                for i, e in enumerate(self.exprs[:-1]):
+                    if e is None:
+                        continue
+                    if (isinstance(e, ParseExpression)
+                            and e.exprs and isinstance(e.exprs[-1], _PendingSkip)):
+                        e.exprs[-1] = e.exprs[-1] + self.exprs[i + 1]
+                        self.exprs[i + 1] = None
+                self.exprs = [e for e in self.exprs if e is not None]
+
+        super(And, self).streamline()
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        return self
+
+    def parseImpl(self, instring, loc, doActions=True):
+        # pass False as last arg to _parse for first element, since we already
+        # pre-parsed the string as part of our And pre-parsing
+        loc, resultlist = self.exprs[0]._parse(instring, loc, doActions, callPreParse=False)
+        errorStop = False
+        for e in self.exprs[1:]:
+            if isinstance(e, And._ErrorStop):
+                errorStop = True
+                continue
+            if errorStop:
+                try:
+                    loc, exprtokens = e._parse(instring, loc, doActions)
+                except ParseSyntaxException:
+                    raise
+                except ParseBaseException as pe:
+                    pe.__traceback__ = None
+                    raise ParseSyntaxException._from_exception(pe)
+                except IndexError:
+                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
+            else:
+                loc, exprtokens = e._parse(instring, loc, doActions)
+            if exprtokens or exprtokens.haskeys():
+                resultlist += exprtokens
+        return loc, resultlist
+
+    def __iadd__(self, other):
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        return self.append(other)  # And([self, other])
+
+    def checkRecursion(self, parseElementList):
+        subRecCheckList = parseElementList[:] + [self]
+        for e in self.exprs:
+            e.checkRecursion(subRecCheckList)
+            if not e.mayReturnEmpty:
+                break
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+
+class Or(ParseExpression):
+    """Requires that at least one :class:`ParseExpression` is found. If
+    two expressions match, the expression that matches the longest
+    string will be used. May be constructed using the ``'^'``
+    operator.
+
+    Example::
+
+        # construct Or using '^' operator
+
+        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789"))
+
+    prints::
+
+        [['123'], ['3.1416'], ['789']]
+    """
+    def __init__(self, exprs, savelist=False):
+        super(Or, self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def streamline(self):
+        super(Or, self).streamline()
+        if __compat__.collect_all_And_tokens:
+            self.saveAsList = any(e.saveAsList for e in self.exprs)
+        return self
+
+    def parseImpl(self, instring, loc, doActions=True):
+        maxExcLoc = -1
+        maxException = None
+        matches = []
+        for e in self.exprs:
+            try:
+                loc2 = e.tryParse(instring, loc)
+            except ParseException as err:
+                err.__traceback__ = None
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring, len(instring), e.errmsg, self)
+                    maxExcLoc = len(instring)
+            else:
+                # save match among all matches, to retry longest to shortest
+                matches.append((loc2, e))
+
+        if matches:
+            # re-evaluate all matches in descending order of length of match, in case attached actions
+            # might change whether or how much they match of the input.
+            matches.sort(key=itemgetter(0), reverse=True)
+
+            if not doActions:
+                # no further conditions or parse actions to change the selection of
+                # alternative, so the first match will be the best match
+                best_expr = matches[0][1]
+                return best_expr._parse(instring, loc, doActions)
+
+            longest = -1, None
+            for loc1, expr1 in matches:
+                if loc1 <= longest[0]:
+                    # already have a longer match than this one will deliver, we are done
+                    return longest
+
+                try:
+                    loc2, toks = expr1._parse(instring, loc, doActions)
+                except ParseException as err:
+                    err.__traceback__ = None
+                    if err.loc > maxExcLoc:
+                        maxException = err
+                        maxExcLoc = err.loc
+                else:
+                    if loc2 >= loc1:
+                        return loc2, toks
+                    # didn't match as much as before
+                    elif loc2 > longest[0]:
+                        longest = loc2, toks
+
+            if longest != (-1, None):
+                return longest
+
+        if maxException is not None:
+            maxException.msg = self.errmsg
+            raise maxException
+        else:
+            raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+
+    def __ixor__(self, other):
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        return self.append(other)  # Or([self, other])
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion(self, parseElementList):
+        subRecCheckList = parseElementList[:] + [self]
+        for e in self.exprs:
+            e.checkRecursion(subRecCheckList)
+
+    def _setResultsName(self, name, listAllMatches=False):
+        if (not __compat__.collect_all_And_tokens
+                and __diag__.warn_multiple_tokens_in_named_alternation):
+            if any(isinstance(e, And) for e in self.exprs):
+                warnings.warn("{0}: setting results name {1!r} on {2} expression "
+                              "may only return a single token for an And alternative, "
+                              "in future will return the full list of tokens".format(
+                    "warn_multiple_tokens_in_named_alternation", name, type(self).__name__),
+                    stacklevel=3)
+
+        return super(Or, self)._setResultsName(name, listAllMatches)
+
+
+class MatchFirst(ParseExpression):
+    """Requires that at least one :class:`ParseExpression` is found. If
+    two expressions match, the first one listed is the one that will
+    match. May be constructed using the ``'|'`` operator.
+
+    Example::
+
+        # construct MatchFirst using '|' operator
+
+        # watch the order of expressions to match
+        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]
+
+        # put more selective expression first
+        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
+        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
+    """
+    def __init__(self, exprs, savelist=False):
+        super(MatchFirst, self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def streamline(self):
+        super(MatchFirst, self).streamline()
+        if __compat__.collect_all_And_tokens:
+            self.saveAsList = any(e.saveAsList for e in self.exprs)
+        return self
+
+    def parseImpl(self, instring, loc, doActions=True):
+        maxExcLoc = -1
+        maxException = None
+        for e in self.exprs:
+            try:
+                ret = e._parse(instring, loc, doActions)
+                return ret
+            except ParseException as err:
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring, len(instring), e.errmsg, self)
+                    maxExcLoc = len(instring)
+
+        # only got here if no expression matched, raise exception for match that made it the furthest
+        else:
+            if maxException is not None:
+                maxException.msg = self.errmsg
+                raise maxException
+            else:
+                raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+    def __ior__(self, other):
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        return self.append(other)  # MatchFirst([self, other])
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion(self, parseElementList):
+        subRecCheckList = parseElementList[:] + [self]
+        for e in self.exprs:
+            e.checkRecursion(subRecCheckList)
+
+    def _setResultsName(self, name, listAllMatches=False):
+        if (not __compat__.collect_all_And_tokens
+                and __diag__.warn_multiple_tokens_in_named_alternation):
+            if any(isinstance(e, And) for e in self.exprs):
+                warnings.warn("{0}: setting results name {1!r} on {2} expression "
+                              "may only return a single token for an And alternative, "
+                              "in future will return the full list of tokens".format(
+                    "warn_multiple_tokens_in_named_alternation", name, type(self).__name__),
+                    stacklevel=3)
+
+        return super(MatchFirst, self)._setResultsName(name, listAllMatches)
+
+
+class Each(ParseExpression):
+    """Requires all given :class:`ParseExpression` s to be found, but in
+    any order. Expressions may be separated by whitespace.
+
+    May be constructed using the ``'&'`` operator.
+
+    Example::
+
+        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
+        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
+        integer = Word(nums)
+        shape_attr = "shape:" + shape_type("shape")
+        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
+        color_attr = "color:" + color("color")
+        size_attr = "size:" + integer("size")
+
+        # use Each (using operator '&') to accept attributes in any order
+        # (shape and posn are required, color and size are optional)
+        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)
+
+        shape_spec.runTests('''
+            shape: SQUARE color: BLACK posn: 100, 120
+            shape: CIRCLE size: 50 color: BLUE posn: 50,80
+            color:GREEN size:20 shape:TRIANGLE posn:20,40
+            '''
+            )
+
+    prints::
+
+        shape: SQUARE color: BLACK posn: 100, 120
+        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
+        - color: BLACK
+        - posn: ['100', ',', '120']
+          - x: 100
+          - y: 120
+        - shape: SQUARE
+
+
+        shape: CIRCLE size: 50 color: BLUE posn: 50,80
+        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
+        - color: BLUE
+        - posn: ['50', ',', '80']
+          - x: 50
+          - y: 80
+        - shape: CIRCLE
+        - size: 50
+
+
+        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
+        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
+        - color: GREEN
+        - posn: ['20', ',', '40']
+          - x: 20
+          - y: 40
+        - shape: TRIANGLE
+        - size: 20
+    """
+    def __init__(self, exprs, savelist=True):
+        super(Each, self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.skipWhitespace = True
+        self.initExprGroups = True
+        self.saveAsList = True
+
+    def streamline(self):
+        super(Each, self).streamline()
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        return self
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if self.initExprGroups:
+            self.opt1map = dict((id(e.expr), e) for e in self.exprs if isinstance(e, Optional))
+            opt1 = [e.expr for e in self.exprs if isinstance(e, Optional)]
+            opt2 = [e for e in self.exprs if e.mayReturnEmpty and not isinstance(e, Optional)]
+            self.optionals = opt1 + opt2
+            self.multioptionals = [e.expr for e in self.exprs if isinstance(e, ZeroOrMore)]
+            self.multirequired = [e.expr for e in self.exprs if isinstance(e, OneOrMore)]
+            self.required = [e for e in self.exprs if not isinstance(e, (Optional, ZeroOrMore, OneOrMore))]
+            self.required += self.multirequired
+            self.initExprGroups = False
+        tmpLoc = loc
+        tmpReqd = self.required[:]
+        tmpOpt  = self.optionals[:]
+        matchOrder = []
+
+        keepMatching = True
+        while keepMatching:
+            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
+            failed = []
+            for e in tmpExprs:
+                try:
+                    tmpLoc = e.tryParse(instring, tmpLoc)
+                except ParseException:
+                    failed.append(e)
+                else:
+                    matchOrder.append(self.opt1map.get(id(e), e))
+                    if e in tmpReqd:
+                        tmpReqd.remove(e)
+                    elif e in tmpOpt:
+                        tmpOpt.remove(e)
+            if len(failed) == len(tmpExprs):
+                keepMatching = False
+
+        if tmpReqd:
+            missing = ", ".join(_ustr(e) for e in tmpReqd)
+            raise ParseException(instring, loc, "Missing one or more required elements (%s)" % missing)
+
+        # add any unmatched Optionals, in case they have default values defined
+        matchOrder += [e for e in self.exprs if isinstance(e, Optional) and e.expr in tmpOpt]
+
+        resultlist = []
+        for e in matchOrder:
+            loc, results = e._parse(instring, loc, doActions)
+            resultlist.append(results)
+
+        finalResults = sum(resultlist, ParseResults([]))
+        return loc, finalResults
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion(self, parseElementList):
+        subRecCheckList = parseElementList[:] + [self]
+        for e in self.exprs:
+            e.checkRecursion(subRecCheckList)
+
+
+class ParseElementEnhance(ParserElement):
+    """Abstract subclass of :class:`ParserElement`, for combining and
+    post-processing parsed tokens.
+    """
+    def __init__(self, expr, savelist=False):
+        super(ParseElementEnhance, self).__init__(savelist)
+        if isinstance(expr, basestring):
+            if issubclass(self._literalStringClass, Token):
+                expr = self._literalStringClass(expr)
+            else:
+                expr = self._literalStringClass(Literal(expr))
+        self.expr = expr
+        self.strRepr = None
+        if expr is not None:
+            self.mayIndexError = expr.mayIndexError
+            self.mayReturnEmpty = expr.mayReturnEmpty
+            self.setWhitespaceChars(expr.whiteChars)
+            self.skipWhitespace = expr.skipWhitespace
+            self.saveAsList = expr.saveAsList
+            self.callPreparse = expr.callPreparse
+            self.ignoreExprs.extend(expr.ignoreExprs)
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if self.expr is not None:
+            return self.expr._parse(instring, loc, doActions, callPreParse=False)
+        else:
+            raise ParseException("", loc, self.errmsg, self)
+
+    def leaveWhitespace(self):
+        self.skipWhitespace = False
+        self.expr = self.expr.copy()
+        if self.expr is not None:
+            self.expr.leaveWhitespace()
+        return self
+
+    def ignore(self, other):
+        if isinstance(other, Suppress):
+            if other not in self.ignoreExprs:
+                super(ParseElementEnhance, self).ignore(other)
+                if self.expr is not None:
+                    self.expr.ignore(self.ignoreExprs[-1])
+        else:
+            super(ParseElementEnhance, self).ignore(other)
+            if self.expr is not None:
+                self.expr.ignore(self.ignoreExprs[-1])
+        return self
+
+    def streamline(self):
+        super(ParseElementEnhance, self).streamline()
+        if self.expr is not None:
+            self.expr.streamline()
+        return self
+
+    def checkRecursion(self, parseElementList):
+        if self in parseElementList:
+            raise RecursiveGrammarException(parseElementList + [self])
+        subRecCheckList = parseElementList[:] + [self]
+        if self.expr is not None:
+            self.expr.checkRecursion(subRecCheckList)
+
+    def validate(self, validateTrace=None):
+        if validateTrace is None:
+            validateTrace = []
+        tmp = validateTrace[:] + [self]
+        if self.expr is not None:
+            self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__(self):
+        try:
+            return super(ParseElementEnhance, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None and self.expr is not None:
+            self.strRepr = "%s:(%s)" % (self.__class__.__name__, _ustr(self.expr))
+        return self.strRepr
+
+
+class FollowedBy(ParseElementEnhance):
+    """Lookahead matching of the given parse expression.
+    ``FollowedBy`` does *not* advance the parsing position within
+    the input string, it only verifies that the specified parse
+    expression matches at the current position.  ``FollowedBy``
+    always returns a null token list. If any results names are defined
+    in the lookahead expression, those *will* be returned for access by
+    name.
+
+    Example::
+
+        # use FollowedBy to match a label only if it is followed by a ':'
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+
+        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
+
+    prints::
+
+        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
+    """
+    def __init__(self, expr):
+        super(FollowedBy, self).__init__(expr)
+        self.mayReturnEmpty = True
+
+    def parseImpl(self, instring, loc, doActions=True):
+        # by using self._expr.parse and deleting the contents of the returned ParseResults list
+        # we keep any named results that were defined in the FollowedBy expression
+        _, ret = self.expr._parse(instring, loc, doActions=doActions)
+        del ret[:]
+
+        return loc, ret
+
+
+class PrecededBy(ParseElementEnhance):
+    """Lookbehind matching of the given parse expression.
+    ``PrecededBy`` does not advance the parsing position within the
+    input string, it only verifies that the specified parse expression
+    matches prior to the current position.  ``PrecededBy`` always
+    returns a null token list, but if a results name is defined on the
+    given expression, it is returned.
+
+    Parameters:
+
+     - expr - expression that must match prior to the current parse
+       location
+     - retreat - (default= ``None``) - (int) maximum number of characters
+       to lookbehind prior to the current parse location
+
+    If the lookbehind expression is a string, Literal, Keyword, or
+    a Word or CharsNotIn with a specified exact or maximum length, then
+    the retreat parameter is not required. Otherwise, retreat must be
+    specified to give a maximum number of characters to look back from
+    the current parse position for a lookbehind match.
+
+    Example::
+
+        # VB-style variable names with type prefixes
+        int_var = PrecededBy("#") + pyparsing_common.identifier
+        str_var = PrecededBy("$") + pyparsing_common.identifier
+
+    """
+    def __init__(self, expr, retreat=None):
+        super(PrecededBy, self).__init__(expr)
+        self.expr = self.expr().leaveWhitespace()
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.exact = False
+        if isinstance(expr, str):
+            retreat = len(expr)
+            self.exact = True
+        elif isinstance(expr, (Literal, Keyword)):
+            retreat = expr.matchLen
+            self.exact = True
+        elif isinstance(expr, (Word, CharsNotIn)) and expr.maxLen != _MAX_INT:
+            retreat = expr.maxLen
+            self.exact = True
+        elif isinstance(expr, _PositionToken):
+            retreat = 0
+            self.exact = True
+        self.retreat = retreat
+        self.errmsg = "not preceded by " + str(expr)
+        self.skipWhitespace = False
+        self.parseAction.append(lambda s, l, t: t.__delitem__(slice(None, None)))
+
+    def parseImpl(self, instring, loc=0, doActions=True):
+        if self.exact:
+            if loc < self.retreat:
+                raise ParseException(instring, loc, self.errmsg)
+            start = loc - self.retreat
+            _, ret = self.expr._parse(instring, start)
+        else:
+            # retreat specified a maximum lookbehind window, iterate
+            test_expr = self.expr + StringEnd()
+            instring_slice = instring[max(0, loc - self.retreat):loc]
+            last_expr = ParseException(instring, loc, self.errmsg)
+            for offset in range(1, min(loc, self.retreat + 1)+1):
+                try:
+                    # print('trying', offset, instring_slice, repr(instring_slice[loc - offset:]))
+                    _, ret = test_expr._parse(instring_slice, len(instring_slice) - offset)
+                except ParseBaseException as pbe:
+                    last_expr = pbe
+                else:
+                    break
+            else:
+                raise last_expr
+        return loc, ret
+
+
+class NotAny(ParseElementEnhance):
+    """Lookahead to disallow matching with the given parse expression.
+    ``NotAny`` does *not* advance the parsing position within the
+    input string, it only verifies that the specified parse expression
+    does *not* match at the current position.  Also, ``NotAny`` does
+    *not* skip over leading whitespace. ``NotAny`` always returns
+    a null token list.  May be constructed using the '~' operator.
+
+    Example::
+
+        AND, OR, NOT = map(CaselessKeyword, "AND OR NOT".split())
+
+        # take care not to mistake keywords for identifiers
+        ident = ~(AND | OR | NOT) + Word(alphas)
+        boolean_term = Optional(NOT) + ident
+
+        # very crude boolean expression - to support parenthesis groups and
+        # operation hierarchy, use infixNotation
+        boolean_expr = boolean_term + ZeroOrMore((AND | OR) + boolean_term)
+
+        # integers that are followed by "." are actually floats
+        integer = Word(nums) + ~Char(".")
+    """
+    def __init__(self, expr):
+        super(NotAny, self).__init__(expr)
+        # ~ self.leaveWhitespace()
+        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
+        self.mayReturnEmpty = True
+        self.errmsg = "Found unwanted token, " + _ustr(self.expr)
+
+    def parseImpl(self, instring, loc, doActions=True):
+        if self.expr.canParseNext(instring, loc):
+            raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "~{" + _ustr(self.expr) + "}"
+
+        return self.strRepr
+
+class _MultipleMatch(ParseElementEnhance):
+    def __init__(self, expr, stopOn=None):
+        super(_MultipleMatch, self).__init__(expr)
+        self.saveAsList = True
+        ender = stopOn
+        if isinstance(ender, basestring):
+            ender = self._literalStringClass(ender)
+        self.stopOn(ender)
+
+    def stopOn(self, ender):
+        if isinstance(ender, basestring):
+            ender = self._literalStringClass(ender)
+        self.not_ender = ~ender if ender is not None else None
+        return self
+
+    def parseImpl(self, instring, loc, doActions=True):
+        self_expr_parse = self.expr._parse
+        self_skip_ignorables = self._skipIgnorables
+        check_ender = self.not_ender is not None
+        if check_ender:
+            try_not_ender = self.not_ender.tryParse
+
+        # must be at least one (but first see if we are the stopOn sentinel;
+        # if so, fail)
+        if check_ender:
+            try_not_ender(instring, loc)
+        loc, tokens = self_expr_parse(instring, loc, doActions, callPreParse=False)
+        try:
+            hasIgnoreExprs = (not not self.ignoreExprs)
+            while 1:
+                if check_ender:
+                    try_not_ender(instring, loc)
+                if hasIgnoreExprs:
+                    preloc = self_skip_ignorables(instring, loc)
+                else:
+                    preloc = loc
+                loc, tmptokens = self_expr_parse(instring, preloc, doActions)
+                if tmptokens or tmptokens.haskeys():
+                    tokens += tmptokens
+        except (ParseException, IndexError):
+            pass
+
+        return loc, tokens
+
+    def _setResultsName(self, name, listAllMatches=False):
+        if __diag__.warn_ungrouped_named_tokens_in_collection:
+            for e in [self.expr] + getattr(self.expr, 'exprs', []):
+                if isinstance(e, ParserElement) and e.resultsName:
+                    warnings.warn("{0}: setting results name {1!r} on {2} expression "
+                                  "collides with {3!r} on contained expression".format("warn_ungrouped_named_tokens_in_collection",
+                                                                                       name,
+                                                                                       type(self).__name__,
+                                                                                       e.resultsName),
+                                  stacklevel=3)
+
+        return super(_MultipleMatch, self)._setResultsName(name, listAllMatches)
+
+
+class OneOrMore(_MultipleMatch):
+    """Repetition of one or more of the given expression.
+
+    Parameters:
+     - expr - expression that must match one or more times
+     - stopOn - (default= ``None``) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition
+          expression)
+
+    Example::
+
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: BLACK"
+        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+
+        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
+
+        # could also be written as
+        (attr_expr * (1,)).parseString(text).pprint()
+    """
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + _ustr(self.expr) + "}..."
+
+        return self.strRepr
+
+class ZeroOrMore(_MultipleMatch):
+    """Optional repetition of zero or more of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - stopOn - (default= ``None``) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition
+          expression)
+
+    Example: similar to :class:`OneOrMore`
+    """
+    def __init__(self, expr, stopOn=None):
+        super(ZeroOrMore, self).__init__(expr, stopOn=stopOn)
+        self.mayReturnEmpty = True
+
+    def parseImpl(self, instring, loc, doActions=True):
+        try:
+            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
+        except (ParseException, IndexError):
+            return loc, []
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]..."
+
+        return self.strRepr
+
+
+class _NullToken(object):
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+    def __str__(self):
+        return ""
+
+class Optional(ParseElementEnhance):
+    """Optional matching of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - default (optional) - value to be returned if the optional expression is not found.
+
+    Example::
+
+        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
+        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
+        zip.runTests('''
+            # traditional ZIP code
+            12345
+
+            # ZIP+4 form
+            12101-0001
+
+            # invalid ZIP
+            98765-
+            ''')
+
+    prints::
+
+        # traditional ZIP code
+        12345
+        ['12345']
+
+        # ZIP+4 form
+        12101-0001
+        ['12101-0001']
+
+        # invalid ZIP
+        98765-
+             ^
+        FAIL: Expected end of text (at char 5), (line:1, col:6)
+    """
+    __optionalNotMatched = _NullToken()
+
+    def __init__(self, expr, default=__optionalNotMatched):
+        super(Optional, self).__init__(expr, savelist=False)
+        self.saveAsList = self.expr.saveAsList
+        self.defaultValue = default
+        self.mayReturnEmpty = True
+
+    def parseImpl(self, instring, loc, doActions=True):
+        try:
+            loc, tokens = self.expr._parse(instring, loc, doActions, callPreParse=False)
+        except (ParseException, IndexError):
+            if self.defaultValue is not self.__optionalNotMatched:
+                if self.expr.resultsName:
+                    tokens = ParseResults([self.defaultValue])
+                    tokens[self.expr.resultsName] = self.defaultValue
+                else:
+                    tokens = [self.defaultValue]
+            else:
+                tokens = []
+        return loc, tokens
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]"
+
+        return self.strRepr
+
+class SkipTo(ParseElementEnhance):
+    """Token for skipping over all undefined text until the matched
+    expression is found.
+
+    Parameters:
+     - expr - target expression marking the end of the data to be skipped
+     - include - (default= ``False``) if True, the target expression is also parsed
+          (the skipped text and target expression are returned as a 2-element list).
+     - ignore - (default= ``None``) used to define grammars (typically quoted strings and
+          comments) that might contain false matches to the target expression
+     - failOn - (default= ``None``) define expressions that are not allowed to be
+          included in the skipped test; if found before the target expression is found,
+          the SkipTo is not a match
+
+    Example::
+
+        report = '''
+            Outstanding Issues Report - 1 Jan 2000
+
+               # | Severity | Description                               |  Days Open
+            -----+----------+-------------------------------------------+-----------
+             101 | Critical | Intermittent system crash                 |          6
+              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
+              79 | Minor    | System slow when running too many reports |         47
+            '''
+        integer = Word(nums)
+        SEP = Suppress('|')
+        # use SkipTo to simply match everything up until the next SEP
+        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
+        # - parse action will call token.strip() for each matched token, i.e., the description body
+        string_data = SkipTo(SEP, ignore=quotedString)
+        string_data.setParseAction(tokenMap(str.strip))
+        ticket_expr = (integer("issue_num") + SEP
+                      + string_data("sev") + SEP
+                      + string_data("desc") + SEP
+                      + integer("days_open"))
+
+        for tkt in ticket_expr.searchString(report):
+            print tkt.dump()
+
+    prints::
+
+        ['101', 'Critical', 'Intermittent system crash', '6']
+        - days_open: 6
+        - desc: Intermittent system crash
+        - issue_num: 101
+        - sev: Critical
+        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
+        - days_open: 14
+        - desc: Spelling error on Login ('log|n')
+        - issue_num: 94
+        - sev: Cosmetic
+        ['79', 'Minor', 'System slow when running too many reports', '47']
+        - days_open: 47
+        - desc: System slow when running too many reports
+        - issue_num: 79
+        - sev: Minor
+    """
+    def __init__(self, other, include=False, ignore=None, failOn=None):
+        super(SkipTo, self).__init__(other)
+        self.ignoreExpr = ignore
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.includeMatch = include
+        self.saveAsList = False
+        if isinstance(failOn, basestring):
+            self.failOn = self._literalStringClass(failOn)
+        else:
+            self.failOn = failOn
+        self.errmsg = "No match found for " + _ustr(self.expr)
+
+    def parseImpl(self, instring, loc, doActions=True):
+        startloc = loc
+        instrlen = len(instring)
+        expr = self.expr
+        expr_parse = self.expr._parse
+        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
+        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
+
+        tmploc = loc
+        while tmploc <= instrlen:
+            if self_failOn_canParseNext is not None:
+                # break if failOn expression matches
+                if self_failOn_canParseNext(instring, tmploc):
+                    break
+
+            if self_ignoreExpr_tryParse is not None:
+                # advance past ignore expressions
+                while 1:
+                    try:
+                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                    except ParseBaseException:
+                        break
+
+            try:
+                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+            except (ParseException, IndexError):
+                # no match, advance loc in string
+                tmploc += 1
+            else:
+                # matched skipto expr, done
+                break
+
+        else:
+            # ran off the end of the input string without matching skipto expr, fail
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        # build up return values
+        loc = tmploc
+        skiptext = instring[startloc:loc]
+        skipresult = ParseResults(skiptext)
+
+        if self.includeMatch:
+            loc, mat = expr_parse(instring, loc, doActions, callPreParse=False)
+            skipresult += mat
+
+        return loc, skipresult
+
+class Forward(ParseElementEnhance):
+    """Forward declaration of an expression to be defined later -
+    used for recursive grammars, such as algebraic infix notation.
+    When the expression is known, it is assigned to the ``Forward``
+    variable using the '<<' operator.
+
+    Note: take care when assigning to ``Forward`` not to overlook
+    precedence of operators.
+
+    Specifically, '|' has a lower precedence than '<<', so that::
+
+        fwdExpr << a | b | c
+
+    will actually be evaluated as::
+
+        (fwdExpr << a) | b | c
+
+    thereby leaving b and c out as parseable alternatives.  It is recommended that you
+    explicitly group the values inserted into the ``Forward``::
+
+        fwdExpr << (a | b | c)
+
+    Converting to use the '<<=' operator instead will avoid this problem.
+
+    See :class:`ParseResults.pprint` for an example of a recursive
+    parser created using ``Forward``.
+    """
+    def __init__(self, other=None):
+        super(Forward, self).__init__(other, savelist=False)
+
+    def __lshift__(self, other):
+        if isinstance(other, basestring):
+            other = self._literalStringClass(other)
+        self.expr = other
+        self.strRepr = None
+        self.mayIndexError = self.expr.mayIndexError
+        self.mayReturnEmpty = self.expr.mayReturnEmpty
+        self.setWhitespaceChars(self.expr.whiteChars)
+        self.skipWhitespace = self.expr.skipWhitespace
+        self.saveAsList = self.expr.saveAsList
+        self.ignoreExprs.extend(self.expr.ignoreExprs)
+        return self
+
+    def __ilshift__(self, other):
+        return self << other
+
+    def leaveWhitespace(self):
+        self.skipWhitespace = False
+        return self
+
+    def streamline(self):
+        if not self.streamlined:
+            self.streamlined = True
+            if self.expr is not None:
+                self.expr.streamline()
+        return self
+
+    def validate(self, validateTrace=None):
+        if validateTrace is None:
+            validateTrace = []
+
+        if self not in validateTrace:
+            tmp = validateTrace[:] + [self]
+            if self.expr is not None:
+                self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__(self):
+        if hasattr(self, "name"):
+            return self.name
+        if self.strRepr is not None:
+            return self.strRepr
+
+        # Avoid infinite recursion by setting a temporary strRepr
+        self.strRepr = ": ..."
+
+        # Use the string representation of main expression.
+        retString = '...'
+        try:
+            if self.expr is not None:
+                retString = _ustr(self.expr)[:1000]
+            else:
+                retString = "None"
+        finally:
+            self.strRepr = self.__class__.__name__ + ": " + retString
+        return self.strRepr
+
+    def copy(self):
+        if self.expr is not None:
+            return super(Forward, self).copy()
+        else:
+            ret = Forward()
+            ret <<= self
+            return ret
+
+    def _setResultsName(self, name, listAllMatches=False):
+        if __diag__.warn_name_set_on_empty_Forward:
+            if self.expr is None:
+                warnings.warn("{0}: setting results name {0!r} on {1} expression "
+                              "that has no contained expression".format("warn_name_set_on_empty_Forward",
+                                                                        name,
+                                                                        type(self).__name__),
+                              stacklevel=3)
+
+        return super(Forward, self)._setResultsName(name, listAllMatches)
+
+class TokenConverter(ParseElementEnhance):
+    """
+    Abstract subclass of :class:`ParseExpression`, for converting parsed results.
+    """
+    def __init__(self, expr, savelist=False):
+        super(TokenConverter, self).__init__(expr)  # , savelist)
+        self.saveAsList = False
+
+class Combine(TokenConverter):
+    """Converter to concatenate all matching tokens to a single string.
+    By default, the matching patterns must also be contiguous in the
+    input string; this can be disabled by specifying
+    ``'adjacent=False'`` in the constructor.
+
+    Example::
+
+        real = Word(nums) + '.' + Word(nums)
+        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
+        # will also erroneously match the following
+        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']
+
+        real = Combine(Word(nums) + '.' + Word(nums))
+        print(real.parseString('3.1416')) # -> ['3.1416']
+        # no match when there are internal spaces
+        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
+    """
+    def __init__(self, expr, joinString="", adjacent=True):
+        super(Combine, self).__init__(expr)
+        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
+        if adjacent:
+            self.leaveWhitespace()
+        self.adjacent = adjacent
+        self.skipWhitespace = True
+        self.joinString = joinString
+        self.callPreparse = True
+
+    def ignore(self, other):
+        if self.adjacent:
+            ParserElement.ignore(self, other)
+        else:
+            super(Combine, self).ignore(other)
+        return self
+
+    def postParse(self, instring, loc, tokenlist):
+        retToks = tokenlist.copy()
+        del retToks[:]
+        retToks += ParseResults(["".join(tokenlist._asStringList(self.joinString))], modal=self.modalResults)
+
+        if self.resultsName and retToks.haskeys():
+            return [retToks]
+        else:
+            return retToks
+
+class Group(TokenConverter):
+    """Converter to return the matched tokens as a list - useful for
+    returning tokens of :class:`ZeroOrMore` and :class:`OneOrMore` expressions.
+
+    Example::
+
+        ident = Word(alphas)
+        num = Word(nums)
+        term = ident | num
+        func = ident + Optional(delimitedList(term))
+        print(func.parseString("fn a, b, 100"))  # -> ['fn', 'a', 'b', '100']
+
+        func = ident + Group(Optional(delimitedList(term)))
+        print(func.parseString("fn a, b, 100"))  # -> ['fn', ['a', 'b', '100']]
+    """
+    def __init__(self, expr):
+        super(Group, self).__init__(expr)
+        self.saveAsList = True
+
+    def postParse(self, instring, loc, tokenlist):
+        return [tokenlist]
+
+class Dict(TokenConverter):
+    """Converter to return a repetitive expression as a list, but also
+    as a dictionary. Each element can also be referenced using the first
+    token in the expression as its key. Useful for tabular report
+    scraping when the first column can be used as a item key.
+
+    Example::
+
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+
+        # print attributes as plain groups
+        print(OneOrMore(attr_expr).parseString(text).dump())
+
+        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
+        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
+        print(result.dump())
+
+        # access named fields as dict entries, or output as dict
+        print(result['shape'])
+        print(result.asDict())
+
+    prints::
+
+        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
+
+    See more examples at :class:`ParseResults` of accessing fields by results name.
+    """
+    def __init__(self, expr):
+        super(Dict, self).__init__(expr)
+        self.saveAsList = True
+
+    def postParse(self, instring, loc, tokenlist):
+        for i, tok in enumerate(tokenlist):
+            if len(tok) == 0:
+                continue
+            ikey = tok[0]
+            if isinstance(ikey, int):
+                ikey = _ustr(tok[0]).strip()
+            if len(tok) == 1:
+                tokenlist[ikey] = _ParseResultsWithOffset("", i)
+            elif len(tok) == 2 and not isinstance(tok[1], ParseResults):
+                tokenlist[ikey] = _ParseResultsWithOffset(tok[1], i)
+            else:
+                dictvalue = tok.copy()  # ParseResults(i)
+                del dictvalue[0]
+                if len(dictvalue) != 1 or (isinstance(dictvalue, ParseResults) and dictvalue.haskeys()):
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue, i)
+                else:
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0], i)
+
+        if self.resultsName:
+            return [tokenlist]
+        else:
+            return tokenlist
+
+
+class Suppress(TokenConverter):
+    """Converter for ignoring the results of a parsed expression.
+
+    Example::
+
+        source = "a, b, c,d"
+        wd = Word(alphas)
+        wd_list1 = wd + ZeroOrMore(',' + wd)
+        print(wd_list1.parseString(source))
+
+        # often, delimiters that are useful during parsing are just in the
+        # way afterward - use Suppress to keep them out of the parsed output
+        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        print(wd_list2.parseString(source))
+
+    prints::
+
+        ['a', ',', 'b', ',', 'c', ',', 'd']
+        ['a', 'b', 'c', 'd']
+
+    (See also :class:`delimitedList`.)
+    """
+    def postParse(self, instring, loc, tokenlist):
+        return []
+
+    def suppress(self):
+        return self
+
+
+class OnlyOnce(object):
+    """Wrapper for parse actions, to ensure they are only called once.
+    """
+    def __init__(self, methodCall):
+        self.callable = _trim_arity(methodCall)
+        self.called = False
+    def __call__(self, s, l, t):
+        if not self.called:
+            results = self.callable(s, l, t)
+            self.called = True
+            return results
+        raise ParseException(s, l, "")
+    def reset(self):
+        self.called = False
+
+def traceParseAction(f):
+    """Decorator for debugging parse actions.
+
+    When the parse action is called, this decorator will print
+    ``">> entering method-name(line:<current_source_line>, <parse_location>, <matched_tokens>)"``.
+    When the parse action completes, the decorator will print
+    ``"<<"`` followed by the returned value, or any exception that the parse action raised.
+
+    Example::
+
+        wd = Word(alphas)
+
+        @traceParseAction
+        def remove_duplicate_chars(tokens):
+            return ''.join(sorted(set(''.join(tokens))))
+
+        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
+        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
+
+    prints::
+
+        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
+        <<leaving remove_duplicate_chars (ret: 'dfjkls')
+        ['dfjkls']
+    """
+    f = _trim_arity(f)
+    def z(*paArgs):
+        thisFunc = f.__name__
+        s, l, t = paArgs[-3:]
+        if len(paArgs) > 3:
+            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
+        sys.stderr.write(">>entering %s(line: '%s', %d, %r)\n" % (thisFunc, line(l, s), l, t))
+        try:
+            ret = f(*paArgs)
+        except Exception as exc:
+            sys.stderr.write("<<leaving %s (exception: %s)\n" % (thisFunc, exc))
+            raise
+        sys.stderr.write("<<leaving %s (ret: %r)\n" % (thisFunc, ret))
+        return ret
+    try:
+        z.__name__ = f.__name__
+    except AttributeError:
+        pass
+    return z
+
+#
+# global helpers
+#
+def delimitedList(expr, delim=",", combine=False):
+    """Helper to define a delimited list of expressions - the delimiter
+    defaults to ','. By default, the list elements and delimiters can
+    have intervening whitespace, and comments, but this can be
+    overridden by passing ``combine=True`` in the constructor. If
+    ``combine`` is set to ``True``, the matching tokens are
+    returned as a single token string, with the delimiters included;
+    otherwise, the matching tokens are returned as a list of tokens,
+    with the delimiters suppressed.
+
+    Example::
+
+        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
+        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+    """
+    dlName = _ustr(expr) + " [" + _ustr(delim) + " " + _ustr(expr) + "]..."
+    if combine:
+        return Combine(expr + ZeroOrMore(delim + expr)).setName(dlName)
+    else:
+        return (expr + ZeroOrMore(Suppress(delim) + expr)).setName(dlName)
+
+def countedArray(expr, intExpr=None):
+    """Helper to define a counted list of expressions.
+
+    This helper defines a pattern of the form::
+
+        integer expr expr expr...
+
+    where the leading integer tells how many expr expressions follow.
+    The matched tokens returns the array of expr tokens as a list - the
+    leading count token is suppressed.
+
+    If ``intExpr`` is specified, it should be a pyparsing expression
+    that produces an integer value.
+
+    Example::
+
+        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']
+
+        # in this parser, the leading integer value is given in binary,
+        # '10' indicating that 2 values are in the array
+        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
+        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
+    """
+    arrayExpr = Forward()
+    def countFieldParseAction(s, l, t):
+        n = t[0]
+        arrayExpr << (n and Group(And([expr] * n)) or Group(empty))
+        return []
+    if intExpr is None:
+        intExpr = Word(nums).setParseAction(lambda t: int(t[0]))
+    else:
+        intExpr = intExpr.copy()
+    intExpr.setName("arrayLen")
+    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
+    return (intExpr + arrayExpr).setName('(len) ' + _ustr(expr) + '...')
+
+def _flatten(L):
+    ret = []
+    for i in L:
+        if isinstance(i, list):
+            ret.extend(_flatten(i))
+        else:
+            ret.append(i)
+    return ret
+
+def matchPreviousLiteral(expr):
+    """Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks for
+    a 'repeat' of a previous expression.  For example::
+
+        first = Word(nums)
+        second = matchPreviousLiteral(first)
+        matchExpr = first + ":" + second
+
+    will match ``"1:1"``, but not ``"1:2"``.  Because this
+    matches a previous literal, will also match the leading
+    ``"1:1"`` in ``"1:10"``. If this is not desired, use
+    :class:`matchPreviousExpr`. Do *not* use with packrat parsing
+    enabled.
+    """
+    rep = Forward()
+    def copyTokenToRepeater(s, l, t):
+        if t:
+            if len(t) == 1:
+                rep << t[0]
+            else:
+                # flatten t tokens
+                tflat = _flatten(t.asList())
+                rep << And(Literal(tt) for tt in tflat)
+        else:
+            rep << Empty()
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def matchPreviousExpr(expr):
+    """Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks for
+    a 'repeat' of a previous expression.  For example::
+
+        first = Word(nums)
+        second = matchPreviousExpr(first)
+        matchExpr = first + ":" + second
+
+    will match ``"1:1"``, but not ``"1:2"``.  Because this
+    matches by expressions, will *not* match the leading ``"1:1"``
+    in ``"1:10"``; the expressions are evaluated first, and then
+    compared, so ``"1"`` is compared with ``"10"``. Do *not* use
+    with packrat parsing enabled.
+    """
+    rep = Forward()
+    e2 = expr.copy()
+    rep <<= e2
+    def copyTokenToRepeater(s, l, t):
+        matchTokens = _flatten(t.asList())
+        def mustMatchTheseTokens(s, l, t):
+            theseTokens = _flatten(t.asList())
+            if theseTokens != matchTokens:
+                raise ParseException('', 0, '')
+        rep.setParseAction(mustMatchTheseTokens, callDuringTry=True)
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def _escapeRegexRangeChars(s):
+    # ~  escape these chars: ^-]
+    for c in r"\^-]":
+        s = s.replace(c, _bslash + c)
+    s = s.replace("\n", r"\n")
+    s = s.replace("\t", r"\t")
+    return _ustr(s)
+
+def oneOf(strs, caseless=False, useRegex=True, asKeyword=False):
+    """Helper to quickly define a set of alternative Literals, and makes
+    sure to do longest-first testing when there is a conflict,
+    regardless of the input order, but returns
+    a :class:`MatchFirst` for best performance.
+
+    Parameters:
+
+     - strs - a string of space-delimited literals, or a collection of
+       string literals
+     - caseless - (default= ``False``) - treat all literals as
+       caseless
+     - useRegex - (default= ``True``) - as an optimization, will
+       generate a Regex object; otherwise, will generate
+       a :class:`MatchFirst` object (if ``caseless=True`` or ``asKeyword=True``, or if
+       creating a :class:`Regex` raises an exception)
+     - asKeyword - (default=``False``) - enforce Keyword-style matching on the
+       generated expressions
+
+    Example::
+
+        comp_oper = oneOf("< = > <= >= !=")
+        var = Word(alphas)
+        number = Word(nums)
+        term = var | number
+        comparison_expr = term + comp_oper + term
+        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
+
+    prints::
+
+        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
+    """
+    if isinstance(caseless, basestring):
+        warnings.warn("More than one string argument passed to oneOf, pass "
+                      "choices as a list or space-delimited string", stacklevel=2)
+
+    if caseless:
+        isequal = (lambda a, b: a.upper() == b.upper())
+        masks = (lambda a, b: b.upper().startswith(a.upper()))
+        parseElementClass = CaselessKeyword if asKeyword else CaselessLiteral
+    else:
+        isequal = (lambda a, b: a == b)
+        masks = (lambda a, b: b.startswith(a))
+        parseElementClass = Keyword if asKeyword else Literal
+
+    symbols = []
+    if isinstance(strs, basestring):
+        symbols = strs.split()
+    elif isinstance(strs, Iterable):
+        symbols = list(strs)
+    else:
+        warnings.warn("Invalid argument to oneOf, expected string or iterable",
+                      SyntaxWarning, stacklevel=2)
+    if not symbols:
+        return NoMatch()
+
+    if not asKeyword:
+        # if not producing keywords, need to reorder to take care to avoid masking
+        # longer choices with shorter ones
+        i = 0
+        while i < len(symbols) - 1:
+            cur = symbols[i]
+            for j, other in enumerate(symbols[i + 1:]):
+                if isequal(other, cur):
+                    del symbols[i + j + 1]
+                    break
+                elif masks(cur, other):
+                    del symbols[i + j + 1]
+                    symbols.insert(i, other)
+                    break
+            else:
+                i += 1
+
+    if not (caseless or asKeyword) and useRegex:
+        # ~ print (strs, "->", "|".join([_escapeRegexChars(sym) for sym in symbols]))
+        try:
+            if len(symbols) == len("".join(symbols)):
+                return Regex("[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols)).setName(' | '.join(symbols))
+            else:
+                return Regex("|".join(re.escape(sym) for sym in symbols)).setName(' | '.join(symbols))
+        except Exception:
+            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
+                    SyntaxWarning, stacklevel=2)
+
+    # last resort, just use MatchFirst
+    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))
+
+def dictOf(key, value):
+    """Helper to easily and clearly define a dictionary by specifying
+    the respective patterns for the key and value.  Takes care of
+    defining the :class:`Dict`, :class:`ZeroOrMore`, and
+    :class:`Group` tokens in the proper order.  The key pattern
+    can include delimiting markers or punctuation, as long as they are
+    suppressed, thereby leaving the significant key text.  The value
+    pattern can include named results, so that the :class:`Dict` results
+    can include named token fields.
+
+    Example::
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        print(OneOrMore(attr_expr).parseString(text).dump())
+
+        attr_label = label
+        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)
+
+        # similar to Dict, but simpler call format
+        result = dictOf(attr_label, attr_value).parseString(text)
+        print(result.dump())
+        print(result['shape'])
+        print(result.shape)  # object attribute access works too
+        print(result.asDict())
+
+    prints::
+
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        SQUARE
+        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
+    """
+    return Dict(OneOrMore(Group(key + value)))
+
+def originalTextFor(expr, asString=True):
+    """Helper to return the original, untokenized text for a given
+    expression.  Useful to restore the parsed fields of an HTML start
+    tag into the raw tag text itself, or to revert separate tokens with
+    intervening whitespace back to the original matching input text. By
+    default, returns astring containing the original parsed text.
+
+    If the optional ``asString`` argument is passed as
+    ``False``, then the return value is
+    a :class:`ParseResults` containing any results names that
+    were originally matched, and a single token containing the original
+    matched text from the input string.  So if the expression passed to
+    :class:`originalTextFor` contains expressions with defined
+    results names, you must set ``asString`` to ``False`` if you
+    want to preserve those results name values.
+
+    Example::
+
+        src = "this is test <b> bold <i>text</i> </b> normal text "
+        for tag in ("b", "i"):
+            opener, closer = makeHTMLTags(tag)
+            patt = originalTextFor(opener + SkipTo(closer) + closer)
+            print(patt.searchString(src)[0])
+
+    prints::
+
+        ['<b> bold <i>text</i> </b>']
+        ['<i>text</i>']
+    """
+    locMarker = Empty().setParseAction(lambda s, loc, t: loc)
+    endlocMarker = locMarker.copy()
+    endlocMarker.callPreparse = False
+    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
+    if asString:
+        extractText = lambda s, l, t: s[t._original_start: t._original_end]
+    else:
+        def extractText(s, l, t):
+            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
+    matchExpr.setParseAction(extractText)
+    matchExpr.ignoreExprs = expr.ignoreExprs
+    return matchExpr
+
+def ungroup(expr):
+    """Helper to undo pyparsing's default grouping of And expressions,
+    even if all but one are non-empty.
+    """
+    return TokenConverter(expr).addParseAction(lambda t: t[0])
+
+def locatedExpr(expr):
+    """Helper to decorate a returned token with its starting and ending
+    locations in the input string.
+
+    This helper adds the following results names:
+
+     - locn_start = location where matched expression begins
+     - locn_end = location where matched expression ends
+     - value = the actual parsed results
+
+    Be careful if the input text contains ``<TAB>`` characters, you
+    may want to call :class:`ParserElement.parseWithTabs`
+
+    Example::
+
+        wd = Word(alphas)
+        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+            print(match)
+
+    prints::
+
+        [[0, 'ljsdf', 5]]
+        [[8, 'lksdjjf', 15]]
+        [[18, 'lkkjj', 23]]
+    """
+    locator = Empty().setParseAction(lambda s, l, t: l)
+    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
+
+
+# convenience constants for positional expressions
+empty       = Empty().setName("empty")
+lineStart   = LineStart().setName("lineStart")
+lineEnd     = LineEnd().setName("lineEnd")
+stringStart = StringStart().setName("stringStart")
+stringEnd   = StringEnd().setName("stringEnd")
+
+_escapedPunc = Word(_bslash, r"\[]-*.$+^?()~ ", exact=2).setParseAction(lambda s, l, t: t[0][1])
+_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s, l, t: unichr(int(t[0].lstrip(r'\0x'), 16)))
+_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s, l, t: unichr(int(t[0][1:], 8)))
+_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
+_charRange = Group(_singleChar + Suppress("-") + _singleChar)
+_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group(OneOrMore(_charRange | _singleChar)).setResultsName("body") + "]"
+
+def srange(s):
+    r"""Helper to easily define string ranges for use in Word
+    construction. Borrows syntax from regexp '[]' string range
+    definitions::
+
+        srange("[0-9]")   -> "0123456789"
+        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
+        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
+
+    The input string must be enclosed in []'s, and the returned string
+    is the expanded character set joined into a single string. The
+    values enclosed in the []'s may be:
+
+     - a single character
+     - an escaped character with a leading backslash (such as ``\-``
+       or ``\]``)
+     - an escaped hex character with a leading ``'\x'``
+       (``\x21``, which is a ``'!'`` character) (``\0x##``
+       is also supported for backwards compatibility)
+     - an escaped octal character with a leading ``'\0'``
+       (``\041``, which is a ``'!'`` character)
+     - a range of any of the above, separated by a dash (``'a-z'``,
+       etc.)
+     - any combination of the above (``'aeiouy'``,
+       ``'a-zA-Z0-9_$'``, etc.)
+    """
+    _expanded = lambda p: p if not isinstance(p, ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]), ord(p[1]) + 1))
+    try:
+        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
+    except Exception:
+        return ""
+
+def matchOnlyAtCol(n):
+    """Helper method for defining parse actions that require matching at
+    a specific column in the input text.
+    """
+    def verifyCol(strg, locn, toks):
+        if col(locn, strg) != n:
+            raise ParseException(strg, locn, "matched token not at column %d" % n)
+    return verifyCol
+
+def replaceWith(replStr):
+    """Helper method for common parse actions that simply return
+    a literal value.  Especially useful when used with
+    :class:`transformString<ParserElement.transformString>` ().
+
+    Example::
+
+        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
+        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
+        term = na | num
+
+        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
+    """
+    return lambda s, l, t: [replStr]
+
+def removeQuotes(s, l, t):
+    """Helper parse action for removing quotation marks from parsed
+    quoted strings.
+
+    Example::
+
+        # by default, quotation marks are included in parsed results
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]
+
+        # use removeQuotes to strip quotation marks from parsed results
+        quotedString.setParseAction(removeQuotes)
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
+    """
+    return t[0][1:-1]
+
+def tokenMap(func, *args):
+    """Helper to define a parse action by mapping a function to all
+    elements of a ParseResults list. If any additional args are passed,
+    they are forwarded to the given function as additional arguments
+    after the token, as in
+    ``hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))``,
+    which will convert the parsed data to an integer using base 16.
+
+    Example (compare the last to example in :class:`ParserElement.transformString`::
+
+        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
+        hex_ints.runTests('''
+            00 11 22 aa FF 0a 0d 1a
+            ''')
+
+        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
+        OneOrMore(upperword).runTests('''
+            my kingdom for a horse
+            ''')
+
+        wd = Word(alphas).setParseAction(tokenMap(str.title))
+        OneOrMore(wd).setParseAction(' '.join).runTests('''
+            now is the winter of our discontent made glorious summer by this sun of york
+            ''')
+
+    prints::
+
+        00 11 22 aa FF 0a 0d 1a
+        [0, 17, 34, 170, 255, 10, 13, 26]
+
+        my kingdom for a horse
+        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']
+
+        now is the winter of our discontent made glorious summer by this sun of york
+        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
+    """
+    def pa(s, l, t):
+        return [func(tokn, *args) for tokn in t]
+
+    try:
+        func_name = getattr(func, '__name__',
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    pa.__name__ = func_name
+
+    return pa
+
+upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
+"""(Deprecated) Helper parse action to convert tokens to upper case.
+Deprecated in favor of :class:`pyparsing_common.upcaseTokens`"""
+
+downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
+"""(Deprecated) Helper parse action to convert tokens to lower case.
+Deprecated in favor of :class:`pyparsing_common.downcaseTokens`"""
+
+def _makeTags(tagStr, xml,
+              suppress_LT=Suppress("<"),
+              suppress_GT=Suppress(">")):
+    """Internal helper to construct opening and closing tag expressions, given a tag name"""
+    if isinstance(tagStr, basestring):
+        resname = tagStr
+        tagStr = Keyword(tagStr, caseless=not xml)
+    else:
+        resname = tagStr.name
+
+    tagAttrName = Word(alphas, alphanums + "_-:")
+    if xml:
+        tagAttrValue = dblQuotedString.copy().setParseAction(removeQuotes)
+        openTag = (suppress_LT
+                   + tagStr("tag")
+                   + Dict(ZeroOrMore(Group(tagAttrName + Suppress("=") + tagAttrValue)))
+                   + Optional("/", default=[False])("empty").setParseAction(lambda s, l, t: t[0] == '/')
+                   + suppress_GT)
+    else:
+        tagAttrValue = quotedString.copy().setParseAction(removeQuotes) | Word(printables, excludeChars=">")
+        openTag = (suppress_LT
+                   + tagStr("tag")
+                   + Dict(ZeroOrMore(Group(tagAttrName.setParseAction(downcaseTokens)
+                                           + Optional(Suppress("=") + tagAttrValue))))
+                   + Optional("/", default=[False])("empty").setParseAction(lambda s, l, t: t[0] == '/')
+                   + suppress_GT)
+    closeTag = Combine(_L("</") + tagStr + ">", adjacent=False)
+
+    openTag.setName("<%s>" % resname)
+    # add start<tagname> results name in parse action now that ungrouped names are not reported at two levels
+    openTag.addParseAction(lambda t: t.__setitem__("start" + "".join(resname.replace(":", " ").title().split()), t.copy()))
+    closeTag = closeTag("end" + "".join(resname.replace(":", " ").title().split())).setName("</%s>" % resname)
+    openTag.tag = resname
+    closeTag.tag = resname
+    openTag.tag_body = SkipTo(closeTag())
+    return openTag, closeTag
+
+def makeHTMLTags(tagStr):
+    """Helper to construct opening and closing tag expressions for HTML,
+    given a tag name. Matches tags in either upper or lower case,
+    attributes with namespaces and with quoted or unquoted values.
+
+    Example::
+
+        text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
+        # makeHTMLTags returns pyparsing expressions for the opening and
+        # closing tags as a 2-tuple
+        a, a_end = makeHTMLTags("A")
+        link_expr = a + SkipTo(a_end)("link_text") + a_end
+
+        for link in link_expr.searchString(text):
+            # attributes in the <A> tag (like "href" shown here) are
+            # also accessible as named results
+            print(link.link_text, '->', link.href)
+
+    prints::
+
+        pyparsing -> https://github.com/pyparsing/pyparsing/wiki
+    """
+    return _makeTags(tagStr, False)
+
+def makeXMLTags(tagStr):
+    """Helper to construct opening and closing tag expressions for XML,
+    given a tag name. Matches tags only in the given upper/lower case.
+
+    Example: similar to :class:`makeHTMLTags`
+    """
+    return _makeTags(tagStr, True)
+
+def withAttribute(*args, **attrDict):
+    """Helper to create a validating parse action to be used with start
+    tags created with :class:`makeXMLTags` or
+    :class:`makeHTMLTags`. Use ``withAttribute`` to qualify
+    a starting tag with a required attribute value, to avoid false
+    matches on common tags such as ``<TD>`` or ``<DIV>``.
+
+    Call ``withAttribute`` with a series of attribute names and
+    values. Specify the list of filter attributes names and values as:
+
+     - keyword arguments, as in ``(align="right")``, or
+     - as an explicit dict with ``**`` operator, when an attribute
+       name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}``
+     - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))``
+
+    For attribute names with a namespace prefix, you must use the second
+    form.  Attribute names are matched insensitive to upper/lower case.
+
+    If just testing for ``class`` (with or without a namespace), use
+    :class:`withClass`.
+
+    To verify that the attribute exists, but without specifying a value,
+    pass ``withAttribute.ANY_VALUE`` as the value.
+
+    Example::
+
+        html = '''
+            <div>
+            Some text
+            <div type="grid">1 4 0 1 0</div>
+            <div type="graph">1,3 2,3 1,1</div>
+            <div>this has no type</div>
+            </div>
+
+        '''
+        div,div_end = makeHTMLTags("div")
+
+        # only match div tag having a type attribute with value "grid"
+        div_grid = div().setParseAction(withAttribute(type="grid"))
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+
+        # construct a match with any div tag having a type attribute, regardless of the value
+        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+
+    prints::
+
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    if args:
+        attrs = args[:]
+    else:
+        attrs = attrDict.items()
+    attrs = [(k, v) for k, v in attrs]
+    def pa(s, l, tokens):
+        for attrName, attrValue in attrs:
+            if attrName not in tokens:
+                raise ParseException(s, l, "no matching attribute " + attrName)
+            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
+                raise ParseException(s, l, "attribute '%s' has value '%s', must be '%s'" %
+                                            (attrName, tokens[attrName], attrValue))
+    return pa
+withAttribute.ANY_VALUE = object()
+
+def withClass(classname, namespace=''):
+    """Simplified version of :class:`withAttribute` when
+    matching on a div class - made difficult because ``class`` is
+    a reserved word in Python.
+
+    Example::
+
+        html = '''
+            <div>
+            Some text
+            <div class="grid">1 4 0 1 0</div>
+            <div class="graph">1,3 2,3 1,1</div>
+            <div>this &lt;div&gt; has no class</div>
+            </div>
+
+        '''
+        div,div_end = makeHTMLTags("div")
+        div_grid = div().setParseAction(withClass("grid"))
+
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+
+        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+
+    prints::
+
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    classattr = "%s:class" % namespace if namespace else "class"
+    return withAttribute(**{classattr: classname})
+
+opAssoc = SimpleNamespace()
+opAssoc.LEFT = object()
+opAssoc.RIGHT = object()
+
+def infixNotation(baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')')):
+    """Helper method for constructing grammars of expressions made up of
+    operators working in a precedence hierarchy.  Operators may be unary
+    or binary, left- or right-associative.  Parse actions can also be
+    attached to operator expressions. The generated parser will also
+    recognize the use of parentheses to override operator precedences
+    (see example below).
+
+    Note: if you define a deep operator list, you may see performance
+    issues when using infixNotation. See
+    :class:`ParserElement.enablePackrat` for a mechanism to potentially
+    improve your parser performance.
+
+    Parameters:
+     - baseExpr - expression representing the most basic element for the
+       nested
+     - opList - list of tuples, one for each operator precedence level
+       in the expression grammar; each tuple is of the form ``(opExpr,
+       numTerms, rightLeftAssoc, parseAction)``, where:
+
+       - opExpr is the pyparsing expression for the operator; may also
+         be a string, which will be converted to a Literal; if numTerms
+         is 3, opExpr is a tuple of two expressions, for the two
+         operators separating the 3 terms
+       - numTerms is the number of terms for this operator (must be 1,
+         2, or 3)
+       - rightLeftAssoc is the indicator whether the operator is right
+         or left associative, using the pyparsing-defined constants
+         ``opAssoc.RIGHT`` and ``opAssoc.LEFT``.
+       - parseAction is the parse action to be associated with
+         expressions matching this operator expression (the parse action
+         tuple member may be omitted); if the parse action is passed
+         a tuple or list of functions, this is equivalent to calling
+         ``setParseAction(*fn)``
+         (:class:`ParserElement.setParseAction`)
+     - lpar - expression for matching left-parentheses
+       (default= ``Suppress('(')``)
+     - rpar - expression for matching right-parentheses
+       (default= ``Suppress(')')``)
+
+    Example::
+
+        # simple example of four-function arithmetic with ints and
+        # variable names
+        integer = pyparsing_common.signed_integer
+        varname = pyparsing_common.identifier
+
+        arith_expr = infixNotation(integer | varname,
+            [
+            ('-', 1, opAssoc.RIGHT),
+            (oneOf('* /'), 2, opAssoc.LEFT),
+            (oneOf('+ -'), 2, opAssoc.LEFT),
+            ])
+
+        arith_expr.runTests('''
+            5+3*6
+            (5+3)*6
+            -2--11
+            ''', fullDump=False)
+
+    prints::
+
+        5+3*6
+        [[5, '+', [3, '*', 6]]]
+
+        (5+3)*6
+        [[[5, '+', 3], '*', 6]]
+
+        -2--11
+        [[['-', 2], '-', ['-', 11]]]
+    """
+    # captive version of FollowedBy that does not do parse actions or capture results names
+    class _FB(FollowedBy):
+        def parseImpl(self, instring, loc, doActions=True):
+            self.expr.tryParse(instring, loc)
+            return loc, []
+
+    ret = Forward()
+    lastExpr = baseExpr | (lpar + ret + rpar)
+    for i, operDef in enumerate(opList):
+        opExpr, arity, rightLeftAssoc, pa = (operDef + (None, ))[:4]
+        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
+        if arity == 3:
+            if opExpr is None or len(opExpr) != 2:
+                raise ValueError(
+                    "if numterms=3, opExpr must be a tuple or list of two expressions")
+            opExpr1, opExpr2 = opExpr
+        thisExpr = Forward().setName(termName)
+        if rightLeftAssoc == opAssoc.LEFT:
+            if arity == 1:
+                matchExpr = _FB(lastExpr + opExpr) + Group(lastExpr + OneOrMore(opExpr))
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = _FB(lastExpr + opExpr + lastExpr) + Group(lastExpr + OneOrMore(opExpr + lastExpr))
+                else:
+                    matchExpr = _FB(lastExpr + lastExpr) + Group(lastExpr + OneOrMore(lastExpr))
+            elif arity == 3:
+                matchExpr = (_FB(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr)
+                             + Group(lastExpr + OneOrMore(opExpr1 + lastExpr + opExpr2 + lastExpr)))
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        elif rightLeftAssoc == opAssoc.RIGHT:
+            if arity == 1:
+                # try to avoid LR with this extra test
+                if not isinstance(opExpr, Optional):
+                    opExpr = Optional(opExpr)
+                matchExpr = _FB(opExpr.expr + thisExpr) + Group(opExpr + thisExpr)
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = _FB(lastExpr + opExpr + thisExpr) + Group(lastExpr + OneOrMore(opExpr + thisExpr))
+                else:
+                    matchExpr = _FB(lastExpr + thisExpr) + Group(lastExpr + OneOrMore(thisExpr))
+            elif arity == 3:
+                matchExpr = (_FB(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr)
+                             + Group(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr))
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        else:
+            raise ValueError("operator must indicate right or left associativity")
+        if pa:
+            if isinstance(pa, (tuple, list)):
+                matchExpr.setParseAction(*pa)
+            else:
+                matchExpr.setParseAction(pa)
+        thisExpr <<= (matchExpr.setName(termName) | lastExpr)
+        lastExpr = thisExpr
+    ret <<= lastExpr
+    return ret
+
+operatorPrecedence = infixNotation
+"""(Deprecated) Former name of :class:`infixNotation`, will be
+dropped in a future release."""
+
+dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"').setName("string enclosed in double quotes")
+sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").setName("string enclosed in single quotes")
+quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"'
+                       | Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").setName("quotedString using single or double quotes")
+unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")
+
+def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
+    """Helper method for defining nested lists enclosed in opening and
+    closing delimiters ("(" and ")" are the default).
+
+    Parameters:
+     - opener - opening character for a nested list
+       (default= ``"("``); can also be a pyparsing expression
+     - closer - closing character for a nested list
+       (default= ``")"``); can also be a pyparsing expression
+     - content - expression for items within the nested lists
+       (default= ``None``)
+     - ignoreExpr - expression for ignoring opening and closing
+       delimiters (default= :class:`quotedString`)
+
+    If an expression is not provided for the content argument, the
+    nested expression will capture all whitespace-delimited content
+    between delimiters as a list of separate values.
+
+    Use the ``ignoreExpr`` argument to define expressions that may
+    contain opening or closing characters that should not be treated as
+    opening or closing characters for nesting, such as quotedString or
+    a comment expression.  Specify multiple expressions using an
+    :class:`Or` or :class:`MatchFirst`. The default is
+    :class:`quotedString`, but if no expressions are to be ignored, then
+    pass ``None`` for this argument.
+
+    Example::
+
+        data_type = oneOf("void int short long char float double")
+        decl_data_type = Combine(data_type + Optional(Word('*')))
+        ident = Word(alphas+'_', alphanums+'_')
+        number = pyparsing_common.number
+        arg = Group(decl_data_type + ident)
+        LPAR, RPAR = map(Suppress, "()")
+
+        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))
+
+        c_function = (decl_data_type("type")
+                      + ident("name")
+                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR
+                      + code_body("body"))
+        c_function.ignore(cStyleComment)
+
+        source_code = '''
+            int is_odd(int x) {
+                return (x%2);
+            }
+
+            int dec_to_hex(char hchar) {
+                if (hchar >= '0' && hchar <= '9') {
+                    return (ord(hchar)-ord('0'));
+                } else {
+                    return (10+ord(hchar)-ord('A'));
+                }
+            }
+        '''
+        for func in c_function.searchString(source_code):
+            print("%(name)s (%(type)s) args: %(args)s" % func)
+
+
+    prints::
+
+        is_odd (int) args: [['int', 'x']]
+        dec_to_hex (int) args: [['char', 'hchar']]
+    """
+    if opener == closer:
+        raise ValueError("opening and closing strings cannot be the same")
+    if content is None:
+        if isinstance(opener, basestring) and isinstance(closer, basestring):
+            if len(opener) == 1 and len(closer) == 1:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr
+                                                 + CharsNotIn(opener
+                                                              + closer
+                                                              + ParserElement.DEFAULT_WHITE_CHARS, exact=1)
+                                                 )
+                                       ).setParseAction(lambda t: t[0].strip()))
+                else:
+                    content = (empty.copy() + CharsNotIn(opener
+                                                         + closer
+                                                         + ParserElement.DEFAULT_WHITE_CHARS
+                                                         ).setParseAction(lambda t: t[0].strip()))
+            else:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr
+                                                 + ~Literal(opener)
+                                                 + ~Literal(closer)
+                                                 + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS, exact=1))
+                                       ).setParseAction(lambda t: t[0].strip()))
+                else:
+                    content = (Combine(OneOrMore(~Literal(opener)
+                                                 + ~Literal(closer)
+                                                 + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS, exact=1))
+                                       ).setParseAction(lambda t: t[0].strip()))
+        else:
+            raise ValueError("opening and closing arguments must be strings if no content expression is given")
+    ret = Forward()
+    if ignoreExpr is not None:
+        ret <<= Group(Suppress(opener) + ZeroOrMore(ignoreExpr | ret | content) + Suppress(closer))
+    else:
+        ret <<= Group(Suppress(opener) + ZeroOrMore(ret | content)  + Suppress(closer))
+    ret.setName('nested %s%s expression' % (opener, closer))
+    return ret
+
+def indentedBlock(blockStatementExpr, indentStack, indent=True):
+    """Helper method for defining space-delimited indentation blocks,
+    such as those used to define block statements in Python source code.
+
+    Parameters:
+
+     - blockStatementExpr - expression defining syntax of statement that
+       is repeated within the indented block
+     - indentStack - list created by caller to manage indentation stack
+       (multiple statementWithIndentedBlock expressions within a single
+       grammar should share a common indentStack)
+     - indent - boolean indicating whether block must be indented beyond
+       the current level; set to False for block of left-most
+       statements (default= ``True``)
+
+    A valid block must contain at least one ``blockStatement``.
+
+    Example::
+
+        data = '''
+        def A(z):
+          A1
+          B = 100
+          G = A2
+          A2
+          A3
+        B
+        def BB(a,b,c):
+          BB1
+          def BBA():
+            bba1
+            bba2
+            bba3
+        C
+        D
+        def spam(x,y):
+             def eggs(z):
+                 pass
+        '''
+
+
+        indentStack = [1]
+        stmt = Forward()
+
+        identifier = Word(alphas, alphanums)
+        funcDecl = ("def" + identifier + Group("(" + Optional(delimitedList(identifier)) + ")") + ":")
+        func_body = indentedBlock(stmt, indentStack)
+        funcDef = Group(funcDecl + func_body)
+
+        rvalue = Forward()
+        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
+        rvalue << (funcCall | identifier | Word(nums))
+        assignment = Group(identifier + "=" + rvalue)
+        stmt << (funcDef | assignment | identifier)
+
+        module_body = OneOrMore(stmt)
+
+        parseTree = module_body.parseString(data)
+        parseTree.pprint()
+
+    prints::
+
+        [['def',
+          'A',
+          ['(', 'z', ')'],
+          ':',
+          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
+         'B',
+         ['def',
+          'BB',
+          ['(', 'a', 'b', 'c', ')'],
+          ':',
+          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
+         'C',
+         'D',
+         ['def',
+          'spam',
+          ['(', 'x', 'y', ')'],
+          ':',
+          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]]
+    """
+    backup_stack = indentStack[:]
+
+    def reset_stack():
+        indentStack[:] = backup_stack
+
+    def checkPeerIndent(s, l, t):
+        if l >= len(s): return
+        curCol = col(l, s)
+        if curCol != indentStack[-1]:
+            if curCol > indentStack[-1]:
+                raise ParseException(s, l, "illegal nesting")
+            raise ParseException(s, l, "not a peer entry")
+
+    def checkSubIndent(s, l, t):
+        curCol = col(l, s)
+        if curCol > indentStack[-1]:
+            indentStack.append(curCol)
+        else:
+            raise ParseException(s, l, "not a subentry")
+
+    def checkUnindent(s, l, t):
+        if l >= len(s): return
+        curCol = col(l, s)
+        if not(indentStack and curCol in indentStack):
+            raise ParseException(s, l, "not an unindent")
+        if curCol < indentStack[-1]:
+            indentStack.pop()
+
+    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress(), stopOn=StringEnd())
+    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
+    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
+    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
+    if indent:
+        smExpr = Group(Optional(NL)
+                       + INDENT
+                       + OneOrMore(PEER + Group(blockStatementExpr) + Optional(NL), stopOn=StringEnd())
+                       + UNDENT)
+    else:
+        smExpr = Group(Optional(NL)
+                       + OneOrMore(PEER + Group(blockStatementExpr) + Optional(NL), stopOn=StringEnd())
+                       + UNDENT)
+    smExpr.setFailAction(lambda a, b, c, d: reset_stack())
+    blockStatementExpr.ignore(_bslash + LineEnd())
+    return smExpr.setName('indented block')
+
+alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
+punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")
+
+anyOpenTag, anyCloseTag = makeHTMLTags(Word(alphas, alphanums + "_:").setName('any tag'))
+_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(), '><& "\''))
+commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
+def replaceHTMLEntity(t):
+    """Helper parser action to replace common HTML entities with their special characters"""
+    return _htmlEntityMap.get(t.entity)
+
+# it's easy to get these comment structures wrong - they're very common, so may as well make them available
+cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
+"Comment of the form ``/* ... */``"
+
+htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
+"Comment of the form ``<!-- ... -->``"
+
+restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
+dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
+"Comment of the form ``// ... (to end of line)``"
+
+cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/' | dblSlashComment).setName("C++ style comment")
+"Comment of either form :class:`cStyleComment` or :class:`dblSlashComment`"
+
+javaStyleComment = cppStyleComment
+"Same as :class:`cppStyleComment`"
+
+pythonStyleComment = Regex(r"#.*").setName("Python style comment")
+"Comment of the form ``# ... (to end of line)``"
+
+_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',')
+                                  + Optional(Word(" \t")
+                                             + ~Literal(",") + ~LineEnd()))).streamline().setName("commaItem")
+commaSeparatedList = delimitedList(Optional(quotedString.copy() | _commasepitem, default="")).setName("commaSeparatedList")
+"""(Deprecated) Predefined expression of 1 or more printable words or
+quoted strings, separated by commas.
+
+This expression is deprecated in favor of :class:`pyparsing_common.comma_separated_list`.
+"""
+
+# some other useful expressions - using lower-case class name since we are really using this as a namespace
+class pyparsing_common:
+    """Here are some common low-level expressions that may be useful in
+    jump-starting parser development:
+
+     - numeric forms (:class:`integers<integer>`, :class:`reals<real>`,
+       :class:`scientific notation<sci_real>`)
+     - common :class:`programming identifiers<identifier>`
+     - network addresses (:class:`MAC<mac_address>`,
+       :class:`IPv4<ipv4_address>`, :class:`IPv6<ipv6_address>`)
+     - ISO8601 :class:`dates<iso8601_date>` and
+       :class:`datetime<iso8601_datetime>`
+     - :class:`UUID<uuid>`
+     - :class:`comma-separated list<comma_separated_list>`
+
+    Parse actions:
+
+     - :class:`convertToInteger`
+     - :class:`convertToFloat`
+     - :class:`convertToDate`
+     - :class:`convertToDatetime`
+     - :class:`stripHTMLTags`
+     - :class:`upcaseTokens`
+     - :class:`downcaseTokens`
+
+    Example::
+
+        pyparsing_common.number.runTests('''
+            # any int or real number, returned as the appropriate type
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.fnumber.runTests('''
+            # any int or real number, returned as float
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.hex_integer.runTests('''
+            # hex numbers
+            100
+            FF
+            ''')
+
+        pyparsing_common.fraction.runTests('''
+            # fractions
+            1/2
+            -3/4
+            ''')
+
+        pyparsing_common.mixed_integer.runTests('''
+            # mixed fractions
+            1
+            1/2
+            -3/4
+            1-3/4
+            ''')
+
+        import uuid
+        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+        pyparsing_common.uuid.runTests('''
+            # uuid
+            12345678-1234-5678-1234-567812345678
+            ''')
+
+    prints::
+
+        # any int or real number, returned as the appropriate type
+        100
+        [100]
+
+        -100
+        [-100]
+
+        +100
+        [100]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # any int or real number, returned as float
+        100
+        [100.0]
+
+        -100
+        [-100.0]
+
+        +100
+        [100.0]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # hex numbers
+        100
+        [256]
+
+        FF
+        [255]
+
+        # fractions
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        # mixed fractions
+        1
+        [1]
+
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        1-3/4
+        [1.75]
+
+        # uuid
+        12345678-1234-5678-1234-567812345678
+        [UUID('12345678-1234-5678-1234-567812345678')]
+    """
+
+    convertToInteger = tokenMap(int)
+    """
+    Parse action for converting parsed integers to Python int
+    """
+
+    convertToFloat = tokenMap(float)
+    """
+    Parse action for converting parsed numbers to Python float
+    """
+
+    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
+    """expression that parses an unsigned integer, returns an int"""
+
+    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int, 16))
+    """expression that parses a hexadecimal integer, returns an int"""
+
+    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
+    """expression that parses an integer with optional leading sign, returns an int"""
+
+    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
+    """fractional expression of an integer divided by an integer, returns a float"""
+    fraction.addParseAction(lambda t: t[0]/t[-1])
+
+    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
+    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
+    mixed_integer.addParseAction(sum)
+
+    real = Regex(r'[+-]?(:?\d+\.\d*|\.\d+)').setName("real number").setParseAction(convertToFloat)
+    """expression that parses a floating point number and returns a float"""
+
+    sci_real = Regex(r'[+-]?(:?\d+(:?[eE][+-]?\d+)|(:?\d+\.\d*|\.\d+)(:?[eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
+    """expression that parses a floating point number with optional
+    scientific notation and returns a float"""
+
+    # streamlining this expression makes the docs nicer-looking
+    number = (sci_real | real | signed_integer).streamline()
+    """any numeric expression, returns the corresponding Python type"""
+
+    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
+    """any int or real number, returned as float"""
+
+    identifier = Word(alphas + '_', alphanums + '_').setName("identifier")
+    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
+
+    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
+    "IPv4 address (``0.0.0.0 - 255.255.255.255``)"
+
+    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
+    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part) * 7).setName("full IPv6 address")
+    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part) * (0, 6))
+                           + "::"
+                           + Optional(_ipv6_part + (':' + _ipv6_part) * (0, 6))
+                           ).setName("short IPv6 address")
+    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
+    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
+    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
+    "IPv6 address (long, short, or mixed form)"
+
+    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
+    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"
+
+    @staticmethod
+    def convertToDate(fmt="%Y-%m-%d"):
+        """
+        Helper to create a parse action for converting parsed date string to Python datetime.date
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%d"``)
+
+        Example::
+
+            date_expr = pyparsing_common.iso8601_date.copy()
+            date_expr.setParseAction(pyparsing_common.convertToDate())
+            print(date_expr.parseString("1999-12-31"))
+
+        prints::
+
+            [datetime.date(1999, 12, 31)]
+        """
+        def cvt_fn(s, l, t):
+            try:
+                return datetime.strptime(t[0], fmt).date()
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    @staticmethod
+    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
+        """Helper to create a parse action for converting parsed
+        datetime string to Python datetime.datetime
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%dT%H:%M:%S.%f"``)
+
+        Example::
+
+            dt_expr = pyparsing_common.iso8601_datetime.copy()
+            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
+            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
+
+        prints::
+
+            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
+        """
+        def cvt_fn(s, l, t):
+            try:
+                return datetime.strptime(t[0], fmt)
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
+    "ISO8601 date (``yyyy-mm-dd``)"
+
+    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
+    "ISO8601 datetime (``yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)``) - trailing seconds, milliseconds, and timezone optional; accepts separating ``'T'`` or ``' '``"
+
+    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
+    "UUID (``xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx``)"
+
+    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
+    @staticmethod
+    def stripHTMLTags(s, l, tokens):
+        """Parse action to remove HTML tags from web page HTML source
+
+        Example::
+
+            # strip HTML links from normal text
+            text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
+            td, td_end = makeHTMLTags("TD")
+            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
+            print(table_text.parseString(text).body)
+
+        Prints::
+
+            More info at the pyparsing wiki page
+        """
+        return pyparsing_common._html_stripper.transformString(tokens[0])
+
+    _commasepitem = Combine(OneOrMore(~Literal(",")
+                                      + ~LineEnd()
+                                      + Word(printables, excludeChars=',')
+                                      + Optional(White(" \t")))).streamline().setName("commaItem")
+    comma_separated_list = delimitedList(Optional(quotedString.copy()
+                                                  | _commasepitem, default='')
+                                         ).setName("comma separated list")
+    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""
+
+    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
+    """Parse action to convert tokens to upper case."""
+
+    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
+    """Parse action to convert tokens to lower case."""
+
+
+class _lazyclassproperty(object):
+    def __init__(self, fn):
+        self.fn = fn
+        self.__doc__ = fn.__doc__
+        self.__name__ = fn.__name__
+
+    def __get__(self, obj, cls):
+        if cls is None:
+            cls = type(obj)
+        if not hasattr(cls, '_intern') or any(cls._intern is getattr(superclass, '_intern', [])
+                                              for superclass in cls.__mro__[1:]):
+            cls._intern = {}
+        attrname = self.fn.__name__
+        if attrname not in cls._intern:
+            cls._intern[attrname] = self.fn(cls)
+        return cls._intern[attrname]
+
+
+class unicode_set(object):
+    """
+    A set of Unicode characters, for language-specific strings for
+    ``alphas``, ``nums``, ``alphanums``, and ``printables``.
+    A unicode_set is defined by a list of ranges in the Unicode character
+    set, in a class attribute ``_ranges``, such as::
+
+        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]
+
+    A unicode set can also be defined using multiple inheritance of other unicode sets::
+
+        class CJK(Chinese, Japanese, Korean):
+            pass
+    """
+    _ranges = []
+
+    @classmethod
+    def _get_chars_for_ranges(cls):
+        ret = []
+        for cc in cls.__mro__:
+            if cc is unicode_set:
+                break
+            for rr in cc._ranges:
+                ret.extend(range(rr[0], rr[-1] + 1))
+        return [unichr(c) for c in sorted(set(ret))]
+
+    @_lazyclassproperty
+    def printables(cls):
+        "all non-whitespace characters in this range"
+        return u''.join(filterfalse(unicode.isspace, cls._get_chars_for_ranges()))
+
+    @_lazyclassproperty
+    def alphas(cls):
+        "all alphabetic characters in this range"
+        return u''.join(filter(unicode.isalpha, cls._get_chars_for_ranges()))
+
+    @_lazyclassproperty
+    def nums(cls):
+        "all numeric digit characters in this range"
+        return u''.join(filter(unicode.isdigit, cls._get_chars_for_ranges()))
+
+    @_lazyclassproperty
+    def alphanums(cls):
+        "all alphanumeric characters in this range"
+        return cls.alphas + cls.nums
+
+
+class pyparsing_unicode(unicode_set):
+    """
+    A namespace class for defining common language unicode_sets.
+    """
+    _ranges = [(32, sys.maxunicode)]
+
+    class Latin1(unicode_set):
+        "Unicode set for Latin-1 Unicode Character Range"
+        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]
+
+    class LatinA(unicode_set):
+        "Unicode set for Latin-A Unicode Character Range"
+        _ranges = [(0x0100, 0x017f),]
+
+    class LatinB(unicode_set):
+        "Unicode set for Latin-B Unicode Character Range"
+        _ranges = [(0x0180, 0x024f),]
+
+    class Greek(unicode_set):
+        "Unicode set for Greek Unicode Character Ranges"
+        _ranges = [
+            (0x0370, 0x03ff), (0x1f00, 0x1f15), (0x1f18, 0x1f1d), (0x1f20, 0x1f45), (0x1f48, 0x1f4d),
+            (0x1f50, 0x1f57), (0x1f59,), (0x1f5b,), (0x1f5d,), (0x1f5f, 0x1f7d), (0x1f80, 0x1fb4), (0x1fb6, 0x1fc4),
+            (0x1fc6, 0x1fd3), (0x1fd6, 0x1fdb), (0x1fdd, 0x1fef), (0x1ff2, 0x1ff4), (0x1ff6, 0x1ffe),
+        ]
+
+    class Cyrillic(unicode_set):
+        "Unicode set for Cyrillic Unicode Character Range"
+        _ranges = [(0x0400, 0x04ff)]
+
+    class Chinese(unicode_set):
+        "Unicode set for Chinese Unicode Character Range"
+        _ranges = [(0x4e00, 0x9fff), (0x3000, 0x303f),]
+
+    class Japanese(unicode_set):
+        "Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana ranges"
+        _ranges = []
+
+        class Kanji(unicode_set):
+            "Unicode set for Kanji Unicode Character Range"
+            _ranges = [(0x4E00, 0x9Fbf), (0x3000, 0x303f),]
+
+        class Hiragana(unicode_set):
+            "Unicode set for Hiragana Unicode Character Range"
+            _ranges = [(0x3040, 0x309f),]
+
+        class Katakana(unicode_set):
+            "Unicode set for Katakana  Unicode Character Range"
+            _ranges = [(0x30a0, 0x30ff),]
+
+    class Korean(unicode_set):
+        "Unicode set for Korean Unicode Character Range"
+        _ranges = [(0xac00, 0xd7af), (0x1100, 0x11ff), (0x3130, 0x318f), (0xa960, 0xa97f), (0xd7b0, 0xd7ff), (0x3000, 0x303f),]
+
+    class CJK(Chinese, Japanese, Korean):
+        "Unicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character Range"
+        pass
+
+    class Thai(unicode_set):
+        "Unicode set for Thai Unicode Character Range"
+        _ranges = [(0x0e01, 0x0e3a), (0x0e3f, 0x0e5b),]
+
+    class Arabic(unicode_set):
+        "Unicode set for Arabic Unicode Character Range"
+        _ranges = [(0x0600, 0x061b), (0x061e, 0x06ff), (0x0700, 0x077f),]
+
+    class Hebrew(unicode_set):
+        "Unicode set for Hebrew Unicode Character Range"
+        _ranges = [(0x0590, 0x05ff),]
+
+    class Devanagari(unicode_set):
+        "Unicode set for Devanagari Unicode Character Range"
+        _ranges = [(0x0900, 0x097f), (0xa8e0, 0xa8ff)]
+
+pyparsing_unicode.Japanese._ranges = (pyparsing_unicode.Japanese.Kanji._ranges
+                                      + pyparsing_unicode.Japanese.Hiragana._ranges
+                                      + pyparsing_unicode.Japanese.Katakana._ranges)
+
+# define ranges in language character sets
+if PY_3:
+    setattr(pyparsing_unicode, u"العربية", pyparsing_unicode.Arabic)
+    setattr(pyparsing_unicode, u"中文", pyparsing_unicode.Chinese)
+    setattr(pyparsing_unicode, u"кириллица", pyparsing_unicode.Cyrillic)
+    setattr(pyparsing_unicode, u"Ελληνικά", pyparsing_unicode.Greek)
+    setattr(pyparsing_unicode, u"עִברִית", pyparsing_unicode.Hebrew)
+    setattr(pyparsing_unicode, u"日本語", pyparsing_unicode.Japanese)
+    setattr(pyparsing_unicode.Japanese, u"漢字", pyparsing_unicode.Japanese.Kanji)
+    setattr(pyparsing_unicode.Japanese, u"カタカナ", pyparsing_unicode.Japanese.Katakana)
+    setattr(pyparsing_unicode.Japanese, u"ひらがな", pyparsing_unicode.Japanese.Hiragana)
+    setattr(pyparsing_unicode, u"한국어", pyparsing_unicode.Korean)
+    setattr(pyparsing_unicode, u"ไทย", pyparsing_unicode.Thai)
+    setattr(pyparsing_unicode, u"देवनागरी", pyparsing_unicode.Devanagari)
+
+
+class pyparsing_test:
+    """
+    namespace class for classes useful in writing unit tests
+    """
+
+    class reset_pyparsing_context:
+        """
+        Context manager to be used when writing unit tests that modify pyparsing config values:
+         - packrat parsing
+         - default whitespace characters.
+         - default keyword characters
+         - literal string auto-conversion class
+         - __diag__ settings
+
+        Example:
+            with reset_pyparsing_context():
+                # test that literals used to construct a grammar are automatically suppressed
+                ParserElement.inlineLiteralsUsing(Suppress)
+
+                term = Word(alphas) | Word(nums)
+                group = Group('(' + term[...] + ')')
+
+                # assert that the '()' characters are not included in the parsed tokens
+                self.assertParseAndCheckLisst(group, "(abc 123 def)", ['abc', '123', 'def'])
+
+            # after exiting context manager, literals are converted to Literal expressions again
+        """
+
+        def __init__(self):
+            self._save_context = {}
+
+        def save(self):
+            self._save_context["default_whitespace"] = ParserElement.DEFAULT_WHITE_CHARS
+            self._save_context["default_keyword_chars"] = Keyword.DEFAULT_KEYWORD_CHARS
+            self._save_context[
+                "literal_string_class"
+            ] = ParserElement._literalStringClass
+            self._save_context["packrat_enabled"] = ParserElement._packratEnabled
+            self._save_context["packrat_parse"] = ParserElement._parse
+            self._save_context["__diag__"] = {
+                name: getattr(__diag__, name) for name in __diag__._all_names
+            }
+            self._save_context["__compat__"] = {
+                "collect_all_And_tokens": __compat__.collect_all_And_tokens
+            }
+            return self
+
+        def restore(self):
+            # reset pyparsing global state
+            if (
+                ParserElement.DEFAULT_WHITE_CHARS
+                != self._save_context["default_whitespace"]
+            ):
+                ParserElement.setDefaultWhitespaceChars(
+                    self._save_context["default_whitespace"]
+                )
+            Keyword.DEFAULT_KEYWORD_CHARS = self._save_context["default_keyword_chars"]
+            ParserElement.inlineLiteralsUsing(
+                self._save_context["literal_string_class"]
+            )
+            for name, value in self._save_context["__diag__"].items():
+                setattr(__diag__, name, value)
+            ParserElement._packratEnabled = self._save_context["packrat_enabled"]
+            ParserElement._parse = self._save_context["packrat_parse"]
+            __compat__.collect_all_And_tokens = self._save_context["__compat__"]
+
+        def __enter__(self):
+            return self.save()
+
+        def __exit__(self, *args):
+            return self.restore()
+
+    class TestParseResultsAsserts:
+        """
+        A mixin class to add parse results assertion methods to normal unittest.TestCase classes.
+        """
+        def assertParseResultsEquals(
+            self, result, expected_list=None, expected_dict=None, msg=None
+        ):
+            """
+            Unit test assertion to compare a ParseResults object with an optional expected_list,
+            and compare any defined results names with an optional expected_dict.
+            """
+            if expected_list is not None:
+                self.assertEqual(expected_list, result.asList(), msg=msg)
+            if expected_dict is not None:
+                self.assertEqual(expected_dict, result.asDict(), msg=msg)
+
+        def assertParseAndCheckList(
+            self, expr, test_string, expected_list, msg=None, verbose=True
+        ):
+            """
+            Convenience wrapper assert to test a parser element and input string, and assert that
+            the resulting ParseResults.asList() is equal to the expected_list.
+            """
+            result = expr.parseString(test_string, parseAll=True)
+            if verbose:
+                print(result.dump())
+            self.assertParseResultsEquals(result, expected_list=expected_list, msg=msg)
+
+        def assertParseAndCheckDict(
+            self, expr, test_string, expected_dict, msg=None, verbose=True
+        ):
+            """
+            Convenience wrapper assert to test a parser element and input string, and assert that
+            the resulting ParseResults.asDict() is equal to the expected_dict.
+            """
+            result = expr.parseString(test_string, parseAll=True)
+            if verbose:
+                print(result.dump())
+            self.assertParseResultsEquals(result, expected_dict=expected_dict, msg=msg)
+
+        def assertRunTestResults(
+            self, run_tests_report, expected_parse_results=None, msg=None
+        ):
+            """
+            Unit test assertion to evaluate output of ParserElement.runTests(). If a list of
+            list-dict tuples is given as the expected_parse_results argument, then these are zipped
+            with the report tuples returned by runTests and evaluated using assertParseResultsEquals.
+            Finally, asserts that the overall runTests() success value is True.
+
+            :param run_tests_report: tuple(bool, [tuple(str, ParseResults or Exception)]) returned from runTests
+            :param expected_parse_results (optional): [tuple(str, list, dict, Exception)]
+            """
+            run_test_success, run_test_results = run_tests_report
+
+            if expected_parse_results is not None:
+                merged = [
+                    (rpt[0], rpt[1], expected)
+                    for rpt, expected in zip(run_test_results, expected_parse_results)
+                ]
+                for test_string, result, expected in merged:
+                    # expected should be a tuple containing a list and/or a dict or an exception,
+                    # and optional failure message string
+                    # an empty tuple will skip any result validation
+                    fail_msg = next(
+                        (exp for exp in expected if isinstance(exp, str)), None
+                    )
+                    expected_exception = next(
+                        (
+                            exp
+                            for exp in expected
+                            if isinstance(exp, type) and issubclass(exp, Exception)
+                        ),
+                        None,
+                    )
+                    if expected_exception is not None:
+                        with self.assertRaises(
+                            expected_exception=expected_exception, msg=fail_msg or msg
+                        ):
+                            if isinstance(result, Exception):
+                                raise result
+                    else:
+                        expected_list = next(
+                            (exp for exp in expected if isinstance(exp, list)), None
+                        )
+                        expected_dict = next(
+                            (exp for exp in expected if isinstance(exp, dict)), None
+                        )
+                        if (expected_list, expected_dict) != (None, None):
+                            self.assertParseResultsEquals(
+                                result,
+                                expected_list=expected_list,
+                                expected_dict=expected_dict,
+                                msg=fail_msg or msg,
+                            )
+                        else:
+                            # warning here maybe?
+                            print("no validation for {!r}".format(test_string))
+
+            # do this last, in case some specific test results can be reported instead
+            self.assertTrue(
+                run_test_success, msg=msg if msg is not None else "failed runTests"
+            )
+
+        @contextmanager
+        def assertRaisesParseException(self, exc_type=ParseException, msg=None):
+            with self.assertRaises(exc_type, msg=msg):
+                yield
+
+
+if __name__ == "__main__":
+
+    selectToken    = CaselessLiteral("select")
+    fromToken      = CaselessLiteral("from")
+
+    ident          = Word(alphas, alphanums + "_$")
+
+    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    columnNameList = Group(delimitedList(columnName)).setName("columns")
+    columnSpec     = ('*' | columnNameList)
+
+    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    tableNameList  = Group(delimitedList(tableName)).setName("tables")
+
+    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")
+
+    # demo runTests method, including embedded comments in test string
+    simpleSQL.runTests("""
+        # '*' as column list and dotted table name
+        select * from SYS.XYZZY
+
+        # caseless match on "SELECT", and casts back to "select"
+        SELECT * from XYZZY, ABC
+
+        # list of column names, and mixed case SELECT keyword
+        Select AA,BB,CC from Sys.dual
+
+        # multiple tables
+        Select A, B, C from Sys.dual, Table2
+
+        # invalid SELECT keyword - should fail
+        Xelect A, B, C from Sys.dual
+
+        # incomplete command - should fail
+        Select
+
+        # invalid column name - should fail
+        Select ^^^ frox Sys.dual
+
+        """)
+
+    pyparsing_common.number.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    # any int or real number, returned as float
+    pyparsing_common.fnumber.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    pyparsing_common.hex_integer.runTests("""
+        100
+        FF
+        """)
+
+    import uuid
+    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+    pyparsing_common.uuid.runTests("""
+        12345678-1234-5678-1234-567812345678
+        """)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..2961c301c2458212e7fbfc57b73b0c1b5839c010
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/__init__.py
@@ -0,0 +1,20 @@
+"""
+pyRFC3339 parses and generates :RFC:`3339`-compliant timestamps using Python
+:class:`datetime.datetime` objects.
+
+>>> from pyrfc3339 import generate, parse
+>>> from datetime import datetime
+>>> import pytz
+>>> generate(datetime.utcnow().replace(tzinfo=pytz.utc)) #doctest:+ELLIPSIS
+'...T...Z'
+>>> parse('2009-01-01T10:01:02Z')
+datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=<UTC>)
+>>> parse('2009-01-01T14:01:02-04:00')
+datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=<UTC-04:00>)
+
+"""
+
+from pyrfc3339.generator import generate
+from pyrfc3339.parser import parse
+
+__all__ = ['generate', 'parse']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/generator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/generator.py
new file mode 100644
index 0000000000000000000000000000000000000000..a114d9d3cb5873c0c0e4958cb86f82d81bf85a98
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/generator.py
@@ -0,0 +1,67 @@
+import pytz
+
+from pyrfc3339.utils import timezone, timedelta_seconds
+
+
+def generate(dt, utc=True, accept_naive=False, microseconds=False):
+    '''
+    Generate an :RFC:`3339`-formatted timestamp from a
+    :class:`datetime.datetime`.
+
+    >>> from datetime import datetime
+    >>> generate(datetime(2009,1,1,12,59,59,0,pytz.utc))
+    '2009-01-01T12:59:59Z'
+
+    The timestamp will use UTC unless `utc=False` is specified, in which case
+    it will use the timezone from the :class:`datetime.datetime`'s
+    :attr:`tzinfo` parameter.
+
+    >>> eastern = pytz.timezone('US/Eastern')
+    >>> dt = eastern.localize(datetime(2009,1,1,12,59,59))
+    >>> generate(dt)
+    '2009-01-01T17:59:59Z'
+    >>> generate(dt, utc=False)
+    '2009-01-01T12:59:59-05:00'
+
+    Unless `accept_naive=True` is specified, the `datetime` must not be naive.
+
+    >>> generate(datetime(2009,1,1,12,59,59,0))
+    Traceback (most recent call last):
+    ...
+    ValueError: naive datetime and accept_naive is False
+
+    >>> generate(datetime(2009,1,1,12,59,59,0), accept_naive=True)
+    '2009-01-01T12:59:59Z'
+
+    If `accept_naive=True` is specified, the `datetime` is assumed to be UTC.
+    Attempting to generate a local timestamp from a naive datetime will result
+    in an error.
+
+    >>> generate(datetime(2009,1,1,12,59,59,0), accept_naive=True, utc=False)
+    Traceback (most recent call last):
+    ...
+    ValueError: cannot generate a local timestamp from a naive datetime
+
+    '''
+    if dt.tzinfo is None:
+        if accept_naive is True:
+            if utc is True:
+                dt = dt.replace(tzinfo=pytz.utc)
+            else:
+                raise ValueError("cannot generate a local timestamp from " +
+                                 "a naive datetime")
+        else:
+            raise ValueError("naive datetime and accept_naive is False")
+
+    if utc is True:
+        dt = dt.astimezone(pytz.utc)
+
+    timestamp = dt.strftime('%Y-%m-%dT%H:%M:%S')
+    if microseconds is True:
+        timestamp += dt.strftime('.%f')
+    if dt.tzinfo is pytz.utc:
+        timestamp += 'Z'
+    else:
+        timestamp += timezone(timedelta_seconds(dt.tzinfo.utcoffset(dt)))
+
+    return timestamp
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..d37dd395ed9807c5e0573a47541700886b0ab2bf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/parser.py
@@ -0,0 +1,87 @@
+import re
+from datetime import datetime
+
+import pytz
+
+from pyrfc3339.utils import FixedOffset
+
+
+def parse(timestamp, utc=False, produce_naive=False):
+    '''
+    Parse an :RFC:`3339`-formatted timestamp and return a
+    `datetime.datetime`.
+
+    If the timestamp is presented in UTC, then the `tzinfo` parameter of the
+    returned `datetime` will be set to `pytz.utc`.
+
+    >>> parse('2009-01-01T10:01:02Z')
+    datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=<UTC>)
+
+    Otherwise, a `tzinfo` instance is created with the appropriate offset, and
+    the `tzinfo` parameter of the returned `datetime` is set to that value.
+
+    >>> parse('2009-01-01T14:01:02-04:00')
+    datetime.datetime(2009, 1, 1, 14, 1, 2, tzinfo=<UTC-04:00>)
+
+    However, if `parse()`  is called with `utc=True`, then the returned
+    `datetime` will be normalized to UTC (and its tzinfo parameter set to
+    `pytz.utc`), regardless of the input timezone.
+
+    >>> parse('2009-01-01T06:01:02-04:00', utc=True)
+    datetime.datetime(2009, 1, 1, 10, 1, 2, tzinfo=<UTC>)
+
+    The input is strictly required to conform to :RFC:`3339`, and appropriate
+    exceptions are thrown for invalid input.
+
+    >>> parse('2009-01-01T06:01:02')
+    Traceback (most recent call last):
+    ...
+    ValueError: timestamp does not conform to RFC 3339
+
+    >>> parse('2009-01-01T25:01:02Z')
+    Traceback (most recent call last):
+    ...
+    ValueError: hour must be in 0..23
+
+    '''
+
+    parse_re = re.compile(r'''^(?:(?:(?P<date_fullyear>[0-9]{4})\-(?P<date_month>[0-9]{2})\-(?P<date_mday>[0-9]{2}))T(?:(?:(?P<time_hour>[0-9]{2})\:(?P<time_minute>[0-9]{2})\:(?P<time_second>[0-9]{2})(?P<time_secfrac>(?:\.[0-9]{1,}))?)(?P<time_offset>(?:Z|(?P<time_numoffset>(?P<time_houroffset>(?:\+|\-)[0-9]{2})\:(?P<time_minuteoffset>[0-9]{2}))))))$''',
+                          re.I | re.X)
+
+    match = parse_re.match(timestamp)
+
+    if match is not None:
+        if match.group('time_offset') in ["Z", "z", "+00:00", "-00:00"]:
+            if produce_naive is True:
+                tzinfo = None
+            else:
+                tzinfo = pytz.utc
+        else:
+            if produce_naive is True:
+                raise ValueError("cannot produce a naive datetime from " +
+                                 "a local timestamp")
+            else:
+                tzinfo = FixedOffset(int(match.group('time_houroffset')),
+                                     int(match.group('time_minuteoffset')))
+
+        secfrac = match.group('time_secfrac')
+        if secfrac is None:
+            microsecond = 0
+        else:
+            microsecond = int(round(float(secfrac) * 1000000))
+
+        dt_out = datetime(year=int(match.group('date_fullyear')),
+                          month=int(match.group('date_month')),
+                          day=int(match.group('date_mday')),
+                          hour=int(match.group('time_hour')),
+                          minute=int(match.group('time_minute')),
+                          second=int(match.group('time_second')),
+                          microsecond=microsecond,
+                          tzinfo=tzinfo)
+
+        if utc:
+            dt_out = dt_out.astimezone(pytz.utc)
+
+        return dt_out
+    else:
+        raise ValueError("timestamp does not conform to RFC 3339")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..35aa65544344bf683f00d575466393c5ac9b9629
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrfc3339/utils.py
@@ -0,0 +1,143 @@
+from __future__ import division
+
+from datetime import timedelta, tzinfo
+from copy import deepcopy
+
+
+class FixedOffset(tzinfo):
+    '''
+    Represent a timezone with a fixed offset from UTC and no adjustment for
+    DST.
+
+    >>> FixedOffset(4,0)
+    <UTC+04:00>
+    >>> FixedOffset(-4,0)
+    <UTC-04:00>
+    >>> FixedOffset(4,30)
+    <UTC+04:30>
+
+    >>> tz = FixedOffset(-5,0)
+    >>> tz.dst(None)
+    datetime.timedelta(0)
+
+    The class tries to do the right thing with the sign
+    of the time zone offset:
+
+    >>> FixedOffset(-9,30)
+    <UTC-09:30>
+    >>> FixedOffset(-9,-30)
+    Traceback (most recent call last):
+    ...
+    ValueError: minutes must not be negative
+
+    Offsets must thus be normalized so that the minute value is positive:
+
+    >>> FixedOffset(-8,30)
+    <UTC-08:30>
+
+    '''
+
+    def __init__(self, hours, minutes):
+        '''
+        Create a new FixedOffset instance with the given offset.
+
+        '''
+        tzinfo.__init__(self)
+        if minutes < 0:
+            raise ValueError("minutes must not be negative")
+        if hours < 0:
+            minutes *= -1
+        self.__offset = timedelta(hours=hours,
+                                  minutes=minutes)
+        self.__name = "UTC" + timezone(timedelta_seconds(self.__offset))
+
+    def dst(self, dt):
+        '''
+        Return offset for DST.  Always returns timedelta(0).
+
+        '''
+        return timedelta(0)
+
+    def utcoffset(self, dt):
+        '''
+        Return offset from UTC.
+
+        '''
+        return self.__offset
+
+    def tzname(self, dt):
+        '''
+        Return name of timezone.
+
+        '''
+        return self.__name
+
+    def __repr__(self):
+        return "<{0}>".format(self.tzname(None))
+
+    def __deepcopy__(self, memo):
+        cls = self.__class__
+        result = cls.__new__(cls)
+        memo[id(self)] = result
+        for k, v in self.__dict__.items():
+            setattr(result, k, deepcopy(v, memo))
+        return result
+
+
+def timedelta_seconds(td):
+    '''
+    Return the offset stored by a :class:`datetime.timedelta` object as an
+    integer number of seconds.  Microseconds, if present, are rounded to
+    the nearest second.
+
+    Delegates to
+    :meth:`timedelta.total_seconds() <datetime.timedelta.total_seconds()>`
+    if available.
+
+    >>> timedelta_seconds(timedelta(hours=1))
+    3600
+    >>> timedelta_seconds(timedelta(hours=-1))
+    -3600
+    >>> timedelta_seconds(timedelta(hours=1, minutes=30))
+    5400
+    >>> timedelta_seconds(timedelta(hours=1, minutes=30,
+    ... microseconds=300000))
+    5400
+    >>> timedelta_seconds(timedelta(hours=1, minutes=30,
+    ...	microseconds=900000))
+    5401
+
+    '''
+
+    try:
+        return int(round(td.total_seconds()))
+    except AttributeError:
+        days = td.days
+        seconds = td.seconds
+        microseconds = td.microseconds
+
+        return int(round((days * 86400) + seconds + (microseconds / 1000000)))
+
+
+def timezone(utcoffset):
+    '''
+    Return a string representing the timezone offset.
+    Remaining seconds are rounded to the nearest minute.
+
+    >>> timezone(3600)
+    '+01:00'
+    >>> timezone(5400)
+    '+01:30'
+    >>> timezone(-28800)
+    '-08:00'
+
+    '''
+
+    hours, seconds = divmod(abs(utcoffset), 3600)
+    minutes = round(float(seconds) / 60)
+
+    if utcoffset >= 0:
+        sign = '+'
+    else:
+        sign = '-'
+    return '{0}{1:02d}:{2:02d}'.format(sign, int(hours), int(minutes))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/LICENCE.mit b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/LICENCE.mit
new file mode 100644
index 0000000000000000000000000000000000000000..6609e4c05a320c436dfbc5ab4e638a28d422ce73
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/LICENCE.mit
@@ -0,0 +1,22 @@
+Copyright (c) 2019 Tobias Gustafsson
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..08986d2377424ce20d63bd6ed56cacf94586efed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/METADATA
@@ -0,0 +1,741 @@
+Metadata-Version: 2.1
+Name: pyrsistent
+Version: 0.17.3
+Summary: Persistent/Functional/Immutable data structures
+Home-page: http://github.com/tobgu/pyrsistent/
+Author: Tobias Gustafsson
+Author-email: tobias.l.gustafsson@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.5
+
+Pyrsistent
+==========
+.. image:: https://travis-ci.org/tobgu/pyrsistent.svg?branch=master
+    :target: https://travis-ci.org/tobgu/pyrsistent
+
+.. image:: https://badge.fury.io/py/pyrsistent.svg
+    :target: https://badge.fury.io/py/pyrsistent
+
+.. image:: https://coveralls.io/repos/tobgu/pyrsistent/badge.svg?branch=master&service=github
+    :target: https://coveralls.io/github/tobgu/pyrsistent?branch=master
+
+
+.. _Pyrthon: https://www.github.com/tobgu/pyrthon/
+
+Pyrsistent is a number of persistent collections (by some referred to as functional data structures). Persistent in
+the sense that they are immutable.
+
+All methods on a data structure that would normally mutate it instead return a new copy of the structure containing the
+requested updates. The original structure is left untouched.
+
+This will simplify the reasoning about what a program does since no hidden side effects ever can take place to these
+data structures. You can rest assured that the object you hold a reference to will remain the same throughout its
+lifetime and need not worry that somewhere five stack levels below you in the darkest corner of your application
+someone has decided to remove that element that you expected to be there.
+
+Pyrsistent is influenced by persistent data structures such as those found in the standard library of Clojure. The
+data structures are designed to share common elements through path copying.
+It aims at taking these concepts and make them as pythonic as possible so that they can be easily integrated into any python
+program without hassle.
+
+If you want to go all in on persistent data structures and use literal syntax to define them in your code rather
+than function calls check out Pyrthon_.
+
+Examples
+--------
+.. _Sequence: collections_
+.. _Hashable: collections_
+.. _Mapping: collections_
+.. _Mappings: collections_
+.. _Set: collections_
+.. _collections: https://docs.python.org/3/library/collections.abc.html
+.. _documentation: http://pyrsistent.readthedocs.org/
+
+The collection types and key features currently implemented are:
+
+* PVector_, similar to a python list
+* PMap_, similar to dict
+* PSet_, similar to set
+* PRecord_, a PMap on steroids with fixed fields, optional type and invariant checking and much more
+* PClass_, a Python class fixed fields, optional type and invariant checking and much more
+* `Checked collections`_, PVector, PMap and PSet with optional type and invariance checks and more
+* PBag, similar to collections.Counter
+* PList, a classic singly linked list
+* PDeque, similar to collections.deque
+* Immutable object type (immutable) built on the named tuple
+* freeze_ and thaw_ functions to convert between pythons standard collections and pyrsistent collections.
+* Flexible transformations_ of arbitrarily complex structures built from PMaps and PVectors.
+
+Below are examples of common usage patterns for some of the structures and features. More information and
+full documentation for all data structures is available in the documentation_.
+
+.. _PVector:
+
+PVector
+~~~~~~~
+With full support for the Sequence_ protocol PVector is meant as a drop in replacement to the built in list from a readers
+point of view. Write operations of course differ since no in place mutation is done but naming should be in line
+with corresponding operations on the built in list.
+
+Support for the Hashable_ protocol also means that it can be used as key in Mappings_.
+
+Appends are amortized O(1). Random access and insert is log32(n) where n is the size of the vector.
+
+.. code:: python
+
+    >>> from pyrsistent import v, pvector
+
+    # No mutation of vectors once created, instead they
+    # are "evolved" leaving the original untouched
+    >>> v1 = v(1, 2, 3)
+    >>> v2 = v1.append(4)
+    >>> v3 = v2.set(1, 5)
+    >>> v1
+    pvector([1, 2, 3])
+    >>> v2
+    pvector([1, 2, 3, 4])
+    >>> v3
+    pvector([1, 5, 3, 4])
+
+    # Random access and slicing
+    >>> v3[1]
+    5
+    >>> v3[1:3]
+    pvector([5, 3])
+
+    # Iteration
+    >>> list(x + 1 for x in v3)
+    [2, 6, 4, 5]
+    >>> pvector(2 * x for x in range(3))
+    pvector([0, 2, 4])
+
+.. _PMap:
+
+PMap
+~~~~
+With full support for the Mapping_ protocol PMap is meant as a drop in replacement to the built in dict from a readers point
+of view. Support for the Hashable_ protocol also means that it can be used as key in other Mappings_.
+
+Random access and insert is log32(n) where n is the size of the map.
+
+.. code:: python
+
+    >>> from pyrsistent import m, pmap, v
+
+    # No mutation of maps once created, instead they are
+    # "evolved" leaving the original untouched
+    >>> m1 = m(a=1, b=2)
+    >>> m2 = m1.set('c', 3)
+    >>> m3 = m2.set('a', 5)
+    >>> m1
+    pmap({'a': 1, 'b': 2})
+    >>> m2
+    pmap({'a': 1, 'c': 3, 'b': 2})
+    >>> m3
+    pmap({'a': 5, 'c': 3, 'b': 2})
+    >>> m3['a']
+    5
+
+    # Evolution of nested persistent structures
+    >>> m4 = m(a=5, b=6, c=v(1, 2))
+    >>> m4.transform(('c', 1), 17)
+    pmap({'a': 5, 'c': pvector([1, 17]), 'b': 6})
+    >>> m5 = m(a=1, b=2)
+
+    # Evolve by merging with other mappings
+    >>> m5.update(m(a=2, c=3), {'a': 17, 'd': 35})
+    pmap({'a': 17, 'c': 3, 'b': 2, 'd': 35})
+    >>> pmap({'x': 1, 'y': 2}) + pmap({'y': 3, 'z': 4})
+    pmap({'y': 3, 'x': 1, 'z': 4})
+
+    # Dict-like methods to convert to list and iterate
+    >>> m3.items()
+    pvector([('a', 5), ('c', 3), ('b', 2)])
+    >>> list(m3)
+    ['a', 'c', 'b']
+
+.. _PSet:
+
+PSet
+~~~~
+With full support for the Set_ protocol PSet is meant as a drop in replacement to the built in set from a readers point
+of view. Support for the Hashable_ protocol also means that it can be used as key in Mappings_.
+
+Random access and insert is log32(n) where n is the size of the set.
+
+.. code:: python
+
+    >>> from pyrsistent import s
+
+    # No mutation of sets once created, you know the story...
+    >>> s1 = s(1, 2, 3, 2)
+    >>> s2 = s1.add(4)
+    >>> s3 = s1.remove(1)
+    >>> s1
+    pset([1, 2, 3])
+    >>> s2
+    pset([1, 2, 3, 4])
+    >>> s3
+    pset([2, 3])
+
+    # Full support for set operations
+    >>> s1 | s(3, 4, 5)
+    pset([1, 2, 3, 4, 5])
+    >>> s1 & s(3, 4, 5)
+    pset([3])
+    >>> s1 < s2
+    True
+    >>> s1 < s(3, 4, 5)
+    False
+
+.. _PRecord:
+
+PRecord
+~~~~~~~
+A PRecord is a PMap with a fixed set of specified fields. Records are declared as python classes inheriting
+from PRecord. Because it is a PMap it has full support for all Mapping methods such as iteration and element
+access using subscript notation.
+
+.. code:: python
+
+    >>> from pyrsistent import PRecord, field
+    >>> class ARecord(PRecord):
+    ...     x = field()
+    ...
+    >>> r = ARecord(x=3)
+    >>> r
+    ARecord(x=3)
+    >>> r.x
+    3
+    >>> r.set(x=2)
+    ARecord(x=2)
+    >>> r.set(y=2)
+    Traceback (most recent call last):
+    AttributeError: 'y' is not among the specified fields for ARecord
+
+Type information
+****************
+It is possible to add type information to the record to enforce type checks. Multiple allowed types can be specified
+by providing an iterable of types.
+
+.. code:: python
+
+    >>> class BRecord(PRecord):
+    ...     x = field(type=int)
+    ...     y = field(type=(int, type(None)))
+    ...
+    >>> BRecord(x=3, y=None)
+    BRecord(y=None, x=3)
+    >>> BRecord(x=3.0)
+    Traceback (most recent call last):
+    PTypeError: Invalid type for field BRecord.x, was float
+
+
+Custom types (classes) that are iterable should be wrapped in a tuple to prevent their
+members being added to the set of valid types.  Although Enums in particular are now
+supported without wrapping, see #83 for more information.
+
+Mandatory fields
+****************
+Fields are not mandatory by default but can be specified as such. If fields are missing an
+*InvariantException* will be thrown which contains information about the missing fields.
+
+.. code:: python
+
+    >>> from pyrsistent import InvariantException
+    >>> class CRecord(PRecord):
+    ...     x = field(mandatory=True)
+    ...
+    >>> r = CRecord(x=3)
+    >>> try:
+    ...    r.discard('x')
+    ... except InvariantException as e:
+    ...    print(e.missing_fields)
+    ...
+    ('CRecord.x',)
+
+Invariants
+**********
+It is possible to add invariants that must hold when evolving the record. Invariants can be
+specified on both field and record level. If invariants fail an *InvariantException* will be
+thrown which contains information about the failing invariants. An invariant function should
+return a tuple consisting of a boolean that tells if the invariant holds or not and an object
+describing the invariant. This object can later be used to identify which invariant that failed.
+
+The global invariant function is only executed if all field invariants hold.
+
+Global invariants are inherited to subclasses.
+
+.. code:: python
+
+    >>> class RestrictedVector(PRecord):
+    ...     __invariant__ = lambda r: (r.y >= r.x, 'x larger than y')
+    ...     x = field(invariant=lambda x: (x > 0, 'x negative'))
+    ...     y = field(invariant=lambda y: (y > 0, 'y negative'))
+    ...
+    >>> r = RestrictedVector(y=3, x=2)
+    >>> try:
+    ...    r.set(x=-1, y=-2)
+    ... except InvariantException as e:
+    ...    print(e.invariant_errors)
+    ...
+    ('y negative', 'x negative')
+    >>> try:
+    ...    r.set(x=2, y=1)
+    ... except InvariantException as e:
+    ...    print(e.invariant_errors)
+    ...
+    ('x larger than y',)
+
+Invariants may also contain multiple assertions. For those cases the invariant function should
+return a tuple of invariant tuples as described above. This structure is reflected in the
+invariant_errors attribute of the exception which will contain tuples with data from all failed
+invariants. Eg:
+
+.. code:: python
+
+    >>> class EvenX(PRecord):
+    ...     x = field(invariant=lambda x: ((x > 0, 'x negative'), (x % 2 == 0, 'x odd')))
+    ...
+    >>> try:
+    ...    EvenX(x=-1)
+    ... except InvariantException as e:
+    ...    print(e.invariant_errors)
+    ...
+    (('x negative', 'x odd'),)
+
+
+Factories
+*********
+It's possible to specify factory functions for fields. The factory function receives whatever
+is supplied as field value and the actual returned by the factory is assigned to the field
+given that any type and invariant checks hold.
+PRecords have a default factory specified as a static function on the class, create(). It takes
+a *Mapping* as argument and returns an instance of the specific record.
+If a record has fields of type PRecord the create() method of that record will
+be called to create the "sub record" if no factory has explicitly been specified to override
+this behaviour.
+
+.. code:: python
+
+    >>> class DRecord(PRecord):
+    ...     x = field(factory=int)
+    ...
+    >>> class ERecord(PRecord):
+    ...     d = field(type=DRecord)
+    ...
+    >>> ERecord.create({'d': {'x': '1'}})
+    ERecord(d=DRecord(x=1))
+
+Collection fields
+*****************
+It is also possible to have fields with ``pyrsistent`` collections.
+
+.. code:: python
+
+   >>> from pyrsistent import pset_field, pmap_field, pvector_field
+   >>> class MultiRecord(PRecord):
+   ...     set_of_ints = pset_field(int)
+   ...     map_int_to_str = pmap_field(int, str)
+   ...     vector_of_strs = pvector_field(str)
+   ...
+
+Serialization
+*************
+PRecords support serialization back to dicts. Default serialization will take keys and values
+"as is" and output them into a dict. It is possible to specify custom serialization functions
+to take care of fields that require special treatment.
+
+.. code:: python
+
+    >>> from datetime import date
+    >>> class Person(PRecord):
+    ...     name = field(type=unicode)
+    ...     birth_date = field(type=date,
+    ...                        serializer=lambda format, d: d.strftime(format['date']))
+    ...
+    >>> john = Person(name=u'John', birth_date=date(1985, 10, 21))
+    >>> john.serialize({'date': '%Y-%m-%d'})
+    {'birth_date': '1985-10-21', 'name': u'John'}
+
+
+.. _instar: https://github.com/boxed/instar/
+
+.. _PClass:
+
+PClass
+~~~~~~
+A PClass is a python class with a fixed set of specified fields. PClasses are declared as python classes inheriting
+from PClass. It is defined the same way that PRecords are and behaves like a PRecord in all aspects except that it
+is not a PMap and hence not a collection but rather a plain Python object.
+
+.. code:: python
+
+    >>> from pyrsistent import PClass, field
+    >>> class AClass(PClass):
+    ...     x = field()
+    ...
+    >>> a = AClass(x=3)
+    >>> a
+    AClass(x=3)
+    >>> a.x
+    3
+
+
+Checked collections
+~~~~~~~~~~~~~~~~~~~
+Checked collections currently come in three flavors: CheckedPVector, CheckedPMap and CheckedPSet.
+
+.. code:: python
+
+    >>> from pyrsistent import CheckedPVector, CheckedPMap, CheckedPSet, thaw
+    >>> class Positives(CheckedPSet):
+    ...     __type__ = (long, int)
+    ...     __invariant__ = lambda n: (n >= 0, 'Negative')
+    ...
+    >>> class Lottery(PRecord):
+    ...     name = field(type=str)
+    ...     numbers = field(type=Positives, invariant=lambda p: (len(p) > 0, 'No numbers'))
+    ...
+    >>> class Lotteries(CheckedPVector):
+    ...     __type__ = Lottery
+    ...
+    >>> class LotteriesByDate(CheckedPMap):
+    ...     __key_type__ = date
+    ...     __value_type__ = Lotteries
+    ...
+    >>> lotteries = LotteriesByDate.create({date(2015, 2, 15): [{'name': 'SuperLotto', 'numbers': {1, 2, 3}},
+    ...                                                         {'name': 'MegaLotto',  'numbers': {4, 5, 6}}],
+    ...                                     date(2015, 2, 16): [{'name': 'SuperLotto', 'numbers': {3, 2, 1}},
+    ...                                                         {'name': 'MegaLotto',  'numbers': {6, 5, 4}}]})
+    >>> lotteries
+    LotteriesByDate({datetime.date(2015, 2, 15): Lotteries([Lottery(numbers=Positives([1, 2, 3]), name='SuperLotto'), Lottery(numbers=Positives([4, 5, 6]), name='MegaLotto')]), datetime.date(2015, 2, 16): Lotteries([Lottery(numbers=Positives([1, 2, 3]), name='SuperLotto'), Lottery(numbers=Positives([4, 5, 6]), name='MegaLotto')])})
+
+    # The checked versions support all operations that the corresponding
+    # unchecked types do
+    >>> lottery_0215 = lotteries[date(2015, 2, 15)]
+    >>> lottery_0215.transform([0, 'name'], 'SuperDuperLotto')
+    Lotteries([Lottery(numbers=Positives([1, 2, 3]), name='SuperDuperLotto'), Lottery(numbers=Positives([4, 5, 6]), name='MegaLotto')])
+
+    # But also makes asserts that types and invariants hold
+    >>> lottery_0215.transform([0, 'name'], 999)
+    Traceback (most recent call last):
+    PTypeError: Invalid type for field Lottery.name, was int
+
+    >>> lottery_0215.transform([0, 'numbers'], set())
+    Traceback (most recent call last):
+    InvariantException: Field invariant failed
+
+    # They can be converted back to python built ins with either thaw()
+    # or serialize() (which provides possibilities to customize serialization)
+    >>> thaw(lottery_0215)
+    [{'numbers': set([1, 2, 3]), 'name': 'SuperLotto'}, {'numbers': set([4, 5, 6]), 'name': 'MegaLotto'}]
+    >>> lottery_0215.serialize()
+    [{'numbers': set([1, 2, 3]), 'name': 'SuperLotto'}, {'numbers': set([4, 5, 6]), 'name': 'MegaLotto'}]
+
+.. _transformations:
+
+Transformations
+~~~~~~~~~~~~~~~
+Transformations are inspired by the cool library instar_ for Clojure. They let you evolve PMaps and PVectors
+with arbitrarily deep/complex nesting using simple syntax and flexible matching syntax.
+
+The first argument to transformation is the path that points out the value to transform. The
+second is the transformation to perform. If the transformation is callable it will be applied
+to the value(s) matching the path. The path may also contain callables. In that case they are
+treated as matchers. If the matcher returns True for a specific key it is considered for transformation.
+
+.. code:: python
+
+    # Basic examples
+    >>> from pyrsistent import inc, freeze, thaw, rex, ny, discard
+    >>> v1 = freeze([1, 2, 3, 4, 5])
+    >>> v1.transform([2], inc)
+    pvector([1, 2, 4, 4, 5])
+    >>> v1.transform([lambda ix: 0 < ix < 4], 8)
+    pvector([1, 8, 8, 8, 5])
+    >>> v1.transform([lambda ix, v: ix == 0 or v == 5], 0)
+    pvector([0, 2, 3, 4, 0])
+
+    # The (a)ny matcher can be used to match anything
+    >>> v1.transform([ny], 8)
+    pvector([8, 8, 8, 8, 8])
+
+    # Regular expressions can be used for matching
+    >>> scores = freeze({'John': 12, 'Joseph': 34, 'Sara': 23})
+    >>> scores.transform([rex('^Jo')], 0)
+    pmap({'Joseph': 0, 'Sara': 23, 'John': 0})
+
+    # Transformations can be done on arbitrarily deep structures
+    >>> news_paper = freeze({'articles': [{'author': 'Sara', 'content': 'A short article'},
+    ...                                   {'author': 'Steve', 'content': 'A slightly longer article'}],
+    ...                      'weather': {'temperature': '11C', 'wind': '5m/s'}})
+    >>> short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:25] + '...' if len(c) > 25 else c)
+    >>> very_short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:15] + '...' if len(c) > 15 else c)
+    >>> very_short_news.articles[0].content
+    'A short article'
+    >>> very_short_news.articles[1].content
+    'A slightly long...'
+
+    # When nothing has been transformed the original data structure is kept
+    >>> short_news is news_paper
+    True
+    >>> very_short_news is news_paper
+    False
+    >>> very_short_news.articles[0] is news_paper.articles[0]
+    True
+
+    # There is a special transformation that can be used to discard elements. Also
+    # multiple transformations can be applied in one call
+    >>> thaw(news_paper.transform(['weather'], discard, ['articles', ny, 'content'], discard))
+    {'articles': [{'author': 'Sara'}, {'author': 'Steve'}]}
+
+Evolvers
+~~~~~~~~
+PVector, PMap and PSet all have support for a concept dubbed *evolvers*. An evolver acts like a mutable
+view of the underlying persistent data structure with "transaction like" semantics. No updates of the original
+data structure is ever performed, it is still fully immutable.
+
+The evolvers have a very limited API by design to discourage excessive, and inappropriate, usage as that would
+take us down the mutable road. In principle only basic mutation and element access functions are supported.
+Check out the documentation_ of each data structure for specific examples.
+
+Examples of when you may want to use an evolver instead of working directly with the data structure include:
+
+* Multiple updates are done to the same data structure and the intermediate results are of no
+  interest. In this case using an evolver may be a more efficient and easier to work with.
+* You need to pass a vector into a legacy function or a function that you have no control
+  over which performs in place mutations. In this case pass an evolver instance
+  instead and then create a new pvector from the evolver once the function returns.
+
+.. code:: python
+
+    >>> from pyrsistent import v
+
+    # In place mutation as when working with the built in counterpart
+    >>> v1 = v(1, 2, 3)
+    >>> e = v1.evolver()
+    >>> e[1] = 22
+    >>> e = e.append(4)
+    >>> e = e.extend([5, 6])
+    >>> e[5] += 1
+    >>> len(e)
+    6
+
+    # The evolver is considered *dirty* when it contains changes compared to the underlying vector
+    >>> e.is_dirty()
+    True
+
+    # But the underlying pvector still remains untouched
+    >>> v1
+    pvector([1, 2, 3])
+
+    # Once satisfied with the updates you can produce a new pvector containing the updates.
+    # The new pvector will share data with the original pvector in the same way that would have
+    # been done if only using operations on the pvector.
+    >>> v2 = e.persistent()
+    >>> v2
+    pvector([1, 22, 3, 4, 5, 7])
+
+    # The evolver is now no longer considered *dirty* as it contains no differences compared to the
+    # pvector just produced.
+    >>> e.is_dirty()
+    False
+
+    # You may continue to work with the same evolver without affecting the content of v2
+    >>> e[0] = 11
+
+    # Or create a new evolver from v2. The two evolvers can be updated independently but will both
+    # share data with v2 where possible.
+    >>> e2 = v2.evolver()
+    >>> e2[0] = 1111
+    >>> e.persistent()
+    pvector([11, 22, 3, 4, 5, 7])
+    >>> e2.persistent()
+    pvector([1111, 22, 3, 4, 5, 7])
+
+.. _freeze:
+.. _thaw:
+
+freeze and thaw
+~~~~~~~~~~~~~~~
+These functions are great when your cozy immutable world has to interact with the evil mutable world outside.
+
+.. code:: python
+
+    >>> from pyrsistent import freeze, thaw, v, m
+    >>> freeze([1, {'a': 3}])
+    pvector([1, pmap({'a': 3})])
+    >>> thaw(v(1, m(a=3)))
+    [1, {'a': 3}]
+
+Compatibility
+-------------
+
+Pyrsistent is developed and tested on Python 3.5, 3.6, 3.7, 3.8 and PyPy3.
+
+Performance
+-----------
+
+Pyrsistent is developed with performance in mind. Still, while some operations are nearly on par with their built in,
+mutable, counterparts in terms of speed, other operations are slower. In the cases where attempts at
+optimizations have been done, speed has generally been valued over space.
+
+Pyrsistent comes with two API compatible flavors of PVector (on which PMap and PSet are based), one pure Python
+implementation and one implemented as a C extension. The latter generally being 2 - 20 times faster than the former.
+The C extension will be used automatically when possible.
+
+The pure python implementation is fully PyPy compatible. Running it under PyPy speeds operations up considerably if
+the structures are used heavily (if JITed), for some cases the performance is almost on par with the built in counterparts.
+
+Type hints
+----------
+
+PEP 561 style type hints for use with mypy and various editors are available for most types and functions in pyrsistent.
+
+Type classes for annotating your own code with pyrsistent types are also available under pyrsistent.typing.
+
+Installation
+------------
+
+pip install pyrsistent
+
+Documentation
+-------------
+
+Available at http://pyrsistent.readthedocs.org/
+
+Brief presentation available at http://slides.com/tobiasgustafsson/immutability-and-python/
+
+Contributors
+------------
+
+Tobias Gustafsson https://github.com/tobgu
+
+Christopher Armstrong https://github.com/radix
+
+Anders Hovmöller https://github.com/boxed
+
+Itamar Turner-Trauring https://github.com/itamarst
+
+Jonathan Lange https://github.com/jml
+
+Richard Futrell https://github.com/Futrell
+
+Jakob Hollenstein https://github.com/jkbjh
+
+David Honour https://github.com/foolswood
+
+David R. MacIver https://github.com/DRMacIver
+
+Marcus Ewert https://github.com/sarum90
+
+Jean-Paul Calderone https://github.com/exarkun
+
+Douglas Treadwell https://github.com/douglas-treadwell
+
+Travis Parker https://github.com/teepark
+
+Julian Berman https://github.com/Julian
+
+Dennis Tomas https://github.com/dtomas
+
+Neil Vyas https://github.com/neilvyas
+
+doozr https://github.com/doozr
+
+Kamil Galuszka https://github.com/galuszkak
+
+Tsuyoshi Hombashi https://github.com/thombashi
+
+nattofriends https://github.com/nattofriends
+
+agberk https://github.com/agberk
+
+Waleed Khan https://github.com/arxanas
+
+Jean-Louis Fuchs https://github.com/ganwell
+
+Carlos Corbacho https://github.com/ccorbacho
+
+Felix Yan https://github.com/felixonmars
+
+benrg https://github.com/benrg
+
+Jere Lahelma https://github.com/je-l
+
+Max Taggart https://github.com/MaxTaggart
+
+Vincent Philippon https://github.com/vphilippon
+
+Semen Zhydenko https://github.com/ss18
+
+Till Varoquaux  https://github.com/till-varoquaux
+
+Michal Kowalik https://github.com/michalvi
+
+ossdev07 https://github.com/ossdev07
+
+Kerry Olesen https://github.com/qhesz
+
+johnthagen https://github.com/johnthagen
+
+Bastien Vallet https://github.com/djailla
+
+Ram Rachum  https://github.com/cool-RR
+
+Vincent Philippon https://github.com/vphilippon
+
+Contributing
+------------
+
+Want to contribute? That's great! If you experience problems please log them on GitHub. If you want to contribute code,
+please fork the repository and submit a pull request.
+
+Run tests
+~~~~~~~~~
+.. _tox: https://tox.readthedocs.io/en/latest/
+
+Tests can be executed using tox_.
+
+Install tox: ``pip install tox``
+
+Run test for Python 3.8: ``tox -e py38``
+
+Release
+~~~~~~~
+* `pip install -r requirements.txt`
+* Update CHANGES.txt
+* Update README with any new contributors and potential info needed.
+* Update _pyrsistent_version.py
+* `rm -rf dist/* && python setup.py sdist`
+* (`twine upload -r testpypi dist/*`), if testing the distribution on testpypi
+* `twine upload dist/*`
+* Commit and tag with new version: `git add -u . && git commit -m 'Prepare version vX.Y.Z' && git tag -a vX.Y.Z -m 'vX.Y.Z'`
+* Push commit and tags: `git push && git push --tags`
+
+Project status
+--------------
+Pyrsistent can be considered stable and mature (who knows, there may even be a 1.0 some day :-)). The project is
+maintained, bugs fixed, PRs reviewed and merged and new releases made. I currently do not have time for development
+of new features or functionality which I don't have use for myself. I'm more than happy to take PRs for new
+functionality though!
+
+There are a bunch of issues marked with ``enhancement`` and ``help wanted`` that contain requests for new functionality
+that would be nice to include. The level of difficulty and extend of the issues varies, please reach out to me if you're
+interested in working on any of them.
+
+If you feel that you have a grand master plan for where you would like Pyrsistent to go and have the time to put into
+it please don't hesitate to discuss this with me and submit PRs for it. If all goes well I'd be more than happy to add
+additional maintainers to the project!
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..e2cc250fbadc942c38450df7f11c08e773e19c95
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/RECORD
@@ -0,0 +1,44 @@
+__pycache__/_pyrsistent_version.cpython-38.pyc,,
+_pyrsistent_version.py,sha256=nYwUCnGDgfmsnYIi7CEpIk6_BIHoLHHkPCvVlRO-WC0,23
+pvectorc.cpython-38-x86_64-linux-gnu.so,sha256=xi74OXkZPmtCfisGk0H3DDTJL4XojOIVEzQWOb15yYA,140144
+pyrsistent-0.17.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pyrsistent-0.17.3.dist-info/LICENCE.mit,sha256=oPX4hyFm7bDiMEf0lX-aOn06CIiYRK4fe2PYJbKM1NM,1060
+pyrsistent-0.17.3.dist-info/METADATA,sha256=tqfPC2EK_nDf_5ury3cNttyceAYhhtz1n6APvSQiDCE,26128
+pyrsistent-0.17.3.dist-info/RECORD,,
+pyrsistent-0.17.3.dist-info/WHEEL,sha256=TpFVeXF_cAlV118WSIPWtjqW7nPvzoOw-49FmS3fDKQ,103
+pyrsistent-0.17.3.dist-info/top_level.txt,sha256=4RgY60Kwp0PJK6JLt04o336V4SZXK5QLBlfX0jZTNlw,40
+pyrsistent/__init__.py,sha256=1cONLCDzbyDoZ_deek8Ei_iqOLI4oNseRPLF3zvmEoA,1479
+pyrsistent/__init__.pyi,sha256=xrlyeqwkRQHxsSXZEoIR_PliQBSrMiEy8TpuyRpe3mY,7188
+pyrsistent/__pycache__/__init__.cpython-38.pyc,,
+pyrsistent/__pycache__/_checked_types.cpython-38.pyc,,
+pyrsistent/__pycache__/_field_common.cpython-38.pyc,,
+pyrsistent/__pycache__/_helpers.cpython-38.pyc,,
+pyrsistent/__pycache__/_immutable.cpython-38.pyc,,
+pyrsistent/__pycache__/_pbag.cpython-38.pyc,,
+pyrsistent/__pycache__/_pclass.cpython-38.pyc,,
+pyrsistent/__pycache__/_pdeque.cpython-38.pyc,,
+pyrsistent/__pycache__/_plist.cpython-38.pyc,,
+pyrsistent/__pycache__/_pmap.cpython-38.pyc,,
+pyrsistent/__pycache__/_precord.cpython-38.pyc,,
+pyrsistent/__pycache__/_pset.cpython-38.pyc,,
+pyrsistent/__pycache__/_pvector.cpython-38.pyc,,
+pyrsistent/__pycache__/_toolz.cpython-38.pyc,,
+pyrsistent/__pycache__/_transformations.cpython-38.pyc,,
+pyrsistent/__pycache__/typing.cpython-38.pyc,,
+pyrsistent/_checked_types.py,sha256=vAnQADVANwPL_xx-El0eZ8ko7CtZpevyU7jZS0QJNLs,18289
+pyrsistent/_field_common.py,sha256=PpLx5MCre3guRALmm9ptnN_8qGhHL6OSfWENiBhMZXg,11530
+pyrsistent/_helpers.py,sha256=nyTDJGDkgESDDfkAvCTht9OhSAhWJGWf4-tt2WMkj3w,2452
+pyrsistent/_immutable.py,sha256=GPgpjTAX1y7MzeO2-zCDxeHw8rKrihrzpNwtFriZdPo,3537
+pyrsistent/_pbag.py,sha256=G5LgB5_eT_pOOkqLmZqGGIliVohnjBlZXzo_7C9qpqQ,6730
+pyrsistent/_pclass.py,sha256=2mqz57Ojd7BpR7nJLrbMz35g414pW_ddnIEf3xPTRK4,9702
+pyrsistent/_pdeque.py,sha256=Nlthy8fHSIFsoUteGVcyKao98OqZkZko7x9AxVLhxvM,12203
+pyrsistent/_plist.py,sha256=dlteSIcFB4k95VFHoEwbB0YBsKwmEnY2JNeapX87hws,8293
+pyrsistent/_pmap.py,sha256=tgZh2Plw3o2AHXC_93Oqg0CvmFvBGhPp5HfFiPWuuF0,14637
+pyrsistent/_precord.py,sha256=nAV90p1QdsAJDgNBO-UrZzFTk98TrB90JiquOr2VQrQ,6999
+pyrsistent/_pset.py,sha256=7oiBpDB0YklYGuukADU8dMy_Eq3DlT7Wbu9UUvpiAcY,5687
+pyrsistent/_pvector.py,sha256=tYz4cwokH9MYu0kAwafrlx-U0IJyIvxK8rFbRde_IAg,22694
+pyrsistent/_toolz.py,sha256=_FomPNhGhHO4hyIFaOeNpcbGiXRLD9dLdHhCnPYoie0,3428
+pyrsistent/_transformations.py,sha256=CF9KXf366Z2hl87a09M6NAiXDpZJ4iCEfhddJbUUNXU,3800
+pyrsistent/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pyrsistent/typing.py,sha256=uzxxq11LHbhAcsNPnxDqORkPjy6HImGulJJ2zFBdRL0,1767
+pyrsistent/typing.pyi,sha256=Wg8-s8yeZo-WlRc_-TjBCjWV2d2vbdrw6T2oUzD7gps,10409
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d193dea988d97c2f7f7bf3c4fc196496d361cd4d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-linux_x86_64
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f2460728a9d539786d134de947c2028b3f8aea98
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent-0.17.3.dist-info/top_level.txt
@@ -0,0 +1,3 @@
+_pyrsistent_version
+pvectorc
+pyrsistent
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..be299658f3fedf265fe737e05e88e9e888183d58
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.py
@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+
+from pyrsistent._pmap import pmap, m, PMap
+
+from pyrsistent._pvector import pvector, v, PVector
+
+from pyrsistent._pset import pset, s, PSet
+
+from pyrsistent._pbag import pbag, b, PBag
+
+from pyrsistent._plist import plist, l, PList
+
+from pyrsistent._pdeque import pdeque, dq, PDeque
+
+from pyrsistent._checked_types import (
+    CheckedPMap, CheckedPVector, CheckedPSet, InvariantException, CheckedKeyTypeError,
+    CheckedValueTypeError, CheckedType, optional)
+
+from pyrsistent._field_common import (
+    field, PTypeError, pset_field, pmap_field, pvector_field)
+
+from pyrsistent._precord import PRecord
+
+from pyrsistent._pclass import PClass, PClassMeta
+
+from pyrsistent._immutable import immutable
+
+from pyrsistent._helpers import freeze, thaw, mutant
+
+from pyrsistent._transformations import inc, discard, rex, ny
+
+from pyrsistent._toolz import get_in
+
+
+__all__ = ('pmap', 'm', 'PMap',
+           'pvector', 'v', 'PVector',
+           'pset', 's', 'PSet',
+           'pbag', 'b', 'PBag',
+           'plist', 'l', 'PList',
+           'pdeque', 'dq', 'PDeque',
+           'CheckedPMap', 'CheckedPVector', 'CheckedPSet', 'InvariantException', 'CheckedKeyTypeError', 'CheckedValueTypeError', 'CheckedType', 'optional',
+           'PRecord', 'field', 'pset_field', 'pmap_field', 'pvector_field',
+           'PClass', 'PClassMeta',
+           'immutable',
+           'freeze', 'thaw', 'mutant',
+           'get_in',
+           'inc', 'discard', 'rex', 'ny')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..5909f7991a9afad56fc93e675e2b88ddab454afd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/__init__.pyi
@@ -0,0 +1,213 @@
+# flake8: noqa: E704
+# from https://gist.github.com/WuTheFWasThat/091a17d4b5cab597dfd5d4c2d96faf09
+# Stubs for pyrsistent (Python 3.6)
+
+from typing import Any
+from typing import AnyStr
+from typing import Callable
+from typing import Iterable
+from typing import Iterator
+from typing import List
+from typing import Optional
+from typing import Mapping
+from typing import MutableMapping
+from typing import Sequence
+from typing import Set
+from typing import Union
+from typing import Tuple
+from typing import Type
+from typing import TypeVar
+from typing import overload
+
+# see commit 08519aa for explanation of the re-export
+from pyrsistent.typing import CheckedKeyTypeError as CheckedKeyTypeError
+from pyrsistent.typing import CheckedPMap as CheckedPMap
+from pyrsistent.typing import CheckedPSet as CheckedPSet
+from pyrsistent.typing import CheckedPVector as CheckedPVector
+from pyrsistent.typing import CheckedType as CheckedType
+from pyrsistent.typing import CheckedValueTypeError as CheckedValueTypeError
+from pyrsistent.typing import InvariantException as InvariantException
+from pyrsistent.typing import PClass as PClass
+from pyrsistent.typing import PBag as PBag
+from pyrsistent.typing import PDeque as PDeque
+from pyrsistent.typing import PList as PList
+from pyrsistent.typing import PMap as PMap
+from pyrsistent.typing import PMapEvolver as PMapEvolver
+from pyrsistent.typing import PSet as PSet
+from pyrsistent.typing import PSetEvolver as PSetEvolver
+from pyrsistent.typing import PTypeError as PTypeError
+from pyrsistent.typing import PVector as PVector
+from pyrsistent.typing import PVectorEvolver as PVectorEvolver
+
+T = TypeVar('T')
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+
+def pmap(initial: Union[Mapping[KT, VT], Iterable[Tuple[KT, VT]]] = {}, pre_size: int = 0) -> PMap[KT, VT]: ...
+def m(**kwargs: VT) -> PMap[str, VT]: ...
+
+def pvector(iterable: Iterable[T] = ...) -> PVector[T]: ...
+def v(*iterable: T) -> PVector[T]: ...
+
+def pset(iterable: Iterable[T] = (), pre_size: int = 8) -> PSet[T]: ...
+def s(*iterable: T) -> PSet[T]: ...
+
+# see class_test.py for use cases
+Invariant = Tuple[bool, Optional[Union[str, Callable[[], str]]]]
+
+@overload
+def field(
+    type: Union[Type[T], Sequence[Type[T]]] = ...,
+    invariant: Callable[[Any], Union[Invariant, Iterable[Invariant]]] = lambda _: (True, None),
+    initial: Any = object(),
+    mandatory: bool = False,
+    factory: Callable[[Any], T] = lambda x: x,
+    serializer: Callable[[Any, T], Any] = lambda _, value: value,
+) -> T: ...
+# The actual return value (_PField) is irrelevant after a PRecord has been instantiated,
+# see https://github.com/tobgu/pyrsistent/blob/master/pyrsistent/_precord.py#L10
+@overload
+def field(
+    type: Any = ...,
+    invariant: Callable[[Any], Union[Invariant, Iterable[Invariant]]] = lambda _: (True, None),
+    initial: Any = object(),
+    mandatory: bool = False,
+    factory: Callable[[Any], Any] = lambda x: x,
+    serializer: Callable[[Any, Any], Any] = lambda _, value: value,
+) -> Any: ...
+
+# Use precise types for the simplest use cases, but fall back to Any for
+# everything else. See record_test.py for the wide range of possible types for
+# item_type
+@overload
+def pset_field(
+    item_type: Type[T],
+    optional: bool = False,
+    initial: Iterable[T] = ...,
+) -> PSet[T]: ...
+@overload
+def pset_field(
+    item_type: Any,
+    optional: bool = False,
+    initial: Any = (),
+) -> PSet[Any]: ...
+
+@overload
+def pmap_field(
+    key_type: Type[KT],
+    value_type: Type[VT],
+    optional: bool = False,
+    invariant: Callable[[Any], Tuple[bool, Optional[str]]] = lambda _: (True, None),
+) -> PMap[KT, VT]: ...
+@overload
+def pmap_field(
+    key_type: Any,
+    value_type: Any,
+    optional: bool = False,
+    invariant: Callable[[Any], Tuple[bool, Optional[str]]] = lambda _: (True, None),
+) -> PMap[Any, Any]: ...
+
+@overload
+def pvector_field(
+    item_type: Type[T],
+    optional: bool = False,
+    initial: Iterable[T] = ...,
+) -> PVector[T]: ...
+@overload
+def pvector_field(
+    item_type: Any,
+    optional: bool = False,
+    initial: Any = (),
+) -> PVector[Any]: ...
+
+def pbag(elements: Iterable[T]) -> PBag[T]: ...
+def b(*elements: T) -> PBag[T]: ...
+
+def plist(iterable: Iterable[T] = (), reverse: bool = False) -> PList[T]: ...
+def l(*elements: T) -> PList[T]: ...
+
+def pdeque(iterable: Optional[Iterable[T]] = None, maxlen: Optional[int] = None) -> PDeque[T]: ...
+def dq(*iterable: T) -> PDeque[T]: ...
+
+@overload
+def optional(type: T) -> Tuple[T, Type[None]]: ...
+@overload
+def optional(*typs: Any) -> Tuple[Any, ...]: ...
+
+T_PRecord = TypeVar('T_PRecord', bound='PRecord')
+class PRecord(PMap[AnyStr, Any]):
+    _precord_fields: Mapping
+    _precord_initial_values: Mapping
+
+    def __hash__(self) -> int: ...
+    def __init__(self, **kwargs: Any) -> None: ...
+    def __iter__(self) -> Iterator[Any]: ...
+    def __len__(self) -> int: ...
+    @classmethod
+    def create(
+        cls: Type[T_PRecord],
+        kwargs: Mapping,
+        _factory_fields: Optional[Iterable] = None,
+        ignore_extra: bool = False,
+    ) -> T_PRecord: ...
+    # This is OK because T_PRecord is a concrete type
+    def discard(self: T_PRecord, key: KT) -> T_PRecord: ...
+    def remove(self: T_PRecord, key: KT) -> T_PRecord: ...
+
+    def serialize(self, format: Optional[Any] = ...) -> MutableMapping: ...
+
+    # From pyrsistent documentation:
+    #   This set function differs slightly from that in the PMap
+    #   class. First of all it accepts key-value pairs. Second it accepts multiple key-value
+    #   pairs to perform one, atomic, update of multiple fields.
+    @overload
+    def set(self, key: KT, val: VT) -> Any: ...
+    @overload
+    def set(self, **kwargs: VT) -> Any: ...
+
+def immutable(
+    members: Union[str, Iterable[str]] = '',
+    name: str = 'Immutable',
+    verbose: bool = False,
+) -> Tuple: ...  # actually a namedtuple
+
+# ignore mypy warning "Overloaded function signatures 1 and 5 overlap with
+# incompatible return types"
+@overload
+def freeze(o: Mapping[KT, VT]) -> PMap[KT, VT]: ... # type: ignore
+@overload
+def freeze(o: List[T]) -> PVector[T]: ... # type: ignore
+@overload
+def freeze(o: Tuple[T, ...]) -> Tuple[T, ...]: ...
+@overload
+def freeze(o: Set[T]) -> PSet[T]: ... # type: ignore
+@overload
+def freeze(o: T) -> T: ...
+
+
+@overload
+def thaw(o: PMap[KT, VT]) -> MutableMapping[KT, VT]: ... # type: ignore
+@overload
+def thaw(o: PVector[T]) -> List[T]: ... # type: ignore
+@overload
+def thaw(o: Tuple[T, ...]) -> Tuple[T, ...]: ...
+# collections.abc.MutableSet is kind of garbage:
+# https://stackoverflow.com/questions/24977898/why-does-collections-mutableset-not-bestow-an-update-method
+@overload
+def thaw(o: PSet[T]) -> Set[T]: ... # type: ignore
+@overload
+def thaw(o: T) -> T: ...
+
+def mutant(fn: Callable) -> Callable: ...
+
+def inc(x: int) -> int: ...
+@overload
+def discard(evolver: PMapEvolver[KT, VT], key: KT) -> None: ...
+@overload
+def discard(evolver: PVectorEvolver[T], key: int) -> None: ...
+@overload
+def discard(evolver: PSetEvolver[T], key: T) -> None: ...
+def rex(expr: str) -> Callable[[Any], bool]: ...
+def ny(_: Any) -> bool: ...
+
+def get_in(keys: Iterable, coll: Mapping, default: Optional[Any] = None, no_default: bool = False) -> Any: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_checked_types.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_checked_types.py
new file mode 100644
index 0000000000000000000000000000000000000000..966963d02d926c4246fea1a98b56e6be03ce3af7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_checked_types.py
@@ -0,0 +1,539 @@
+from enum import Enum
+
+from collections.abc import Iterable
+
+from pyrsistent._pmap import PMap, pmap
+from pyrsistent._pset import PSet, pset
+from pyrsistent._pvector import PythonPVector, python_pvector
+
+
+class CheckedType(object):
+    """
+    Marker class to enable creation and serialization of checked object graphs.
+    """
+    __slots__ = ()
+
+    @classmethod
+    def create(cls, source_data, _factory_fields=None):
+        raise NotImplementedError()
+
+    def serialize(self, format=None):
+        raise NotImplementedError()
+
+
+def _restore_pickle(cls, data):
+    return cls.create(data, _factory_fields=set())
+
+
+class InvariantException(Exception):
+    """
+    Exception raised from a :py:class:`CheckedType` when invariant tests fail or when a mandatory
+    field is missing.
+
+    Contains two fields of interest:
+    invariant_errors, a tuple of error data for the failing invariants
+    missing_fields, a tuple of strings specifying the missing names
+    """
+
+    def __init__(self, error_codes=(), missing_fields=(), *args, **kwargs):
+        self.invariant_errors = tuple(e() if callable(e) else e for e in error_codes)
+        self.missing_fields = missing_fields
+        super(InvariantException, self).__init__(*args, **kwargs)
+
+    def __str__(self):
+        return super(InvariantException, self).__str__() + \
+            ", invariant_errors=[{invariant_errors}], missing_fields=[{missing_fields}]".format(
+            invariant_errors=', '.join(str(e) for e in self.invariant_errors),
+            missing_fields=', '.join(self.missing_fields))
+
+
+_preserved_iterable_types = (
+    Enum,
+)
+"""Some types are themselves iterable, but we want to use the type itself and
+not its members for the type specification. This defines a set of such types
+that we explicitly preserve.
+
+Note that strings are not such types because the string inputs we pass in are
+values, not types.
+"""
+
+
+def maybe_parse_user_type(t):
+    """Try to coerce a user-supplied type directive into a list of types.
+
+    This function should be used in all places where a user specifies a type,
+    for consistency.
+
+    The policy for what defines valid user input should be clear from the implementation.
+    """
+    is_type = isinstance(t, type)
+    is_preserved = isinstance(t, type) and issubclass(t, _preserved_iterable_types)
+    is_string = isinstance(t, str)
+    is_iterable = isinstance(t, Iterable)
+
+    if is_preserved:
+        return [t]
+    elif is_string:
+        return [t]
+    elif is_type and not is_iterable:
+        return [t]
+    elif is_iterable:
+        # Recur to validate contained types as well.
+        ts = t
+        return tuple(e for t in ts for e in maybe_parse_user_type(t))
+    else:
+        # If this raises because `t` cannot be formatted, so be it.
+        raise TypeError(
+            'Type specifications must be types or strings. Input: {}'.format(t)
+        )
+
+
+def maybe_parse_many_user_types(ts):
+    # Just a different name to communicate that you're parsing multiple user
+    # inputs. `maybe_parse_user_type` handles the iterable case anyway.
+    return maybe_parse_user_type(ts)
+
+
+def _store_types(dct, bases, destination_name, source_name):
+    maybe_types = maybe_parse_many_user_types([
+        d[source_name]
+        for d in ([dct] + [b.__dict__ for b in bases]) if source_name in d
+    ])
+
+    dct[destination_name] = maybe_types
+
+
+def _merge_invariant_results(result):
+    verdict = True
+    data = []
+    for verd, dat in result:
+        if not verd:
+            verdict = False
+            data.append(dat)
+
+    return verdict, tuple(data)
+
+
+def wrap_invariant(invariant):
+    # Invariant functions may return the outcome of several tests
+    # In those cases the results have to be merged before being passed
+    # back to the client.
+    def f(*args, **kwargs):
+        result = invariant(*args, **kwargs)
+        if isinstance(result[0], bool):
+            return result
+
+        return _merge_invariant_results(result)
+
+    return f
+
+
+def _all_dicts(bases, seen=None):
+    """
+    Yield each class in ``bases`` and each of their base classes.
+    """
+    if seen is None:
+        seen = set()
+    for cls in bases:
+        if cls in seen:
+            continue
+        seen.add(cls)
+        yield cls.__dict__
+        for b in _all_dicts(cls.__bases__, seen):
+            yield b
+
+
+def store_invariants(dct, bases, destination_name, source_name):
+    # Invariants are inherited
+    invariants = []
+    for ns in [dct] + list(_all_dicts(bases)):
+        try:
+            invariant = ns[source_name]
+        except KeyError:
+            continue
+        invariants.append(invariant)
+
+    if not all(callable(invariant) for invariant in invariants):
+        raise TypeError('Invariants must be callable')
+    dct[destination_name] = tuple(wrap_invariant(inv) for inv in invariants)
+
+
+class _CheckedTypeMeta(type):
+    def __new__(mcs, name, bases, dct):
+        _store_types(dct, bases, '_checked_types', '__type__')
+        store_invariants(dct, bases, '_checked_invariants', '__invariant__')
+
+        def default_serializer(self, _, value):
+            if isinstance(value, CheckedType):
+                return value.serialize()
+            return value
+
+        dct.setdefault('__serializer__', default_serializer)
+
+        dct['__slots__'] = ()
+
+        return super(_CheckedTypeMeta, mcs).__new__(mcs, name, bases, dct)
+
+
+class CheckedTypeError(TypeError):
+    def __init__(self, source_class, expected_types, actual_type, actual_value, *args, **kwargs):
+        super(CheckedTypeError, self).__init__(*args, **kwargs)
+        self.source_class = source_class
+        self.expected_types = expected_types
+        self.actual_type = actual_type
+        self.actual_value = actual_value
+
+
+class CheckedKeyTypeError(CheckedTypeError):
+    """
+    Raised when trying to set a value using a key with a type that doesn't match the declared type.
+
+    Attributes:
+    source_class -- The class of the collection
+    expected_types  -- Allowed types
+    actual_type -- The non matching type
+    actual_value -- Value of the variable with the non matching type
+    """
+    pass
+
+
+class CheckedValueTypeError(CheckedTypeError):
+    """
+    Raised when trying to set a value using a key with a type that doesn't match the declared type.
+
+    Attributes:
+    source_class -- The class of the collection
+    expected_types  -- Allowed types
+    actual_type -- The non matching type
+    actual_value -- Value of the variable with the non matching type
+    """
+    pass
+
+
+def _get_class(type_name):
+    module_name, class_name = type_name.rsplit('.', 1)
+    module = __import__(module_name, fromlist=[class_name])
+    return getattr(module, class_name)
+
+
+def get_type(typ):
+    if isinstance(typ, type):
+        return typ
+
+    return _get_class(typ)
+
+
+def get_types(typs):
+    return [get_type(typ) for typ in typs]
+
+
+def _check_types(it, expected_types, source_class, exception_type=CheckedValueTypeError):
+    if expected_types:
+        for e in it:
+            if not any(isinstance(e, get_type(t)) for t in expected_types):
+                actual_type = type(e)
+                msg = "Type {source_class} can only be used with {expected_types}, not {actual_type}".format(
+                    source_class=source_class.__name__,
+                    expected_types=tuple(get_type(et).__name__ for et in expected_types),
+                    actual_type=actual_type.__name__)
+                raise exception_type(source_class, expected_types, actual_type, e, msg)
+
+
+def _invariant_errors(elem, invariants):
+    return [data for valid, data in (invariant(elem) for invariant in invariants) if not valid]
+
+
+def _invariant_errors_iterable(it, invariants):
+    return sum([_invariant_errors(elem, invariants) for elem in it], [])
+
+
+def optional(*typs):
+    """ Convenience function to specify that a value may be of any of the types in type 'typs' or None """
+    return tuple(typs) + (type(None),)
+
+
+def _checked_type_create(cls, source_data, _factory_fields=None, ignore_extra=False):
+    if isinstance(source_data, cls):
+        return source_data
+
+    # Recursively apply create methods of checked types if the types of the supplied data
+    # does not match any of the valid types.
+    types = get_types(cls._checked_types)
+    checked_type = next((t for t in types if issubclass(t, CheckedType)), None)
+    if checked_type:
+        return cls([checked_type.create(data, ignore_extra=ignore_extra)
+                    if not any(isinstance(data, t) for t in types) else data
+                    for data in source_data])
+
+    return cls(source_data)
+
+class CheckedPVector(PythonPVector, CheckedType, metaclass=_CheckedTypeMeta):
+    """
+    A CheckedPVector is a PVector which allows specifying type and invariant checks.
+
+    >>> class Positives(CheckedPVector):
+    ...     __type__ = (int, float)
+    ...     __invariant__ = lambda n: (n >= 0, 'Negative')
+    ...
+    >>> Positives([1, 2, 3])
+    Positives([1, 2, 3])
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, initial=()):
+        if type(initial) == PythonPVector:
+            return super(CheckedPVector, cls).__new__(cls, initial._count, initial._shift, initial._root, initial._tail)
+
+        return CheckedPVector.Evolver(cls, python_pvector()).extend(initial).persistent()
+
+    def set(self, key, value):
+        return self.evolver().set(key, value).persistent()
+
+    def append(self, val):
+        return self.evolver().append(val).persistent()
+
+    def extend(self, it):
+        return self.evolver().extend(it).persistent()
+
+    create = classmethod(_checked_type_create)
+
+    def serialize(self, format=None):
+        serializer = self.__serializer__
+        return list(serializer(format, v) for v in self)
+
+    def __reduce__(self):
+        # Pickling support
+        return _restore_pickle, (self.__class__, list(self),)
+
+    class Evolver(PythonPVector.Evolver):
+        __slots__ = ('_destination_class', '_invariant_errors')
+
+        def __init__(self, destination_class, vector):
+            super(CheckedPVector.Evolver, self).__init__(vector)
+            self._destination_class = destination_class
+            self._invariant_errors = []
+
+        def _check(self, it):
+            _check_types(it, self._destination_class._checked_types, self._destination_class)
+            error_data = _invariant_errors_iterable(it, self._destination_class._checked_invariants)
+            self._invariant_errors.extend(error_data)
+
+        def __setitem__(self, key, value):
+            self._check([value])
+            return super(CheckedPVector.Evolver, self).__setitem__(key, value)
+
+        def append(self, elem):
+            self._check([elem])
+            return super(CheckedPVector.Evolver, self).append(elem)
+
+        def extend(self, it):
+            it = list(it)
+            self._check(it)
+            return super(CheckedPVector.Evolver, self).extend(it)
+
+        def persistent(self):
+            if self._invariant_errors:
+                raise InvariantException(error_codes=self._invariant_errors)
+
+            result = self._orig_pvector
+            if self.is_dirty() or (self._destination_class != type(self._orig_pvector)):
+                pv = super(CheckedPVector.Evolver, self).persistent().extend(self._extra_tail)
+                result = self._destination_class(pv)
+                self._reset(result)
+
+            return result
+
+    def __repr__(self):
+        return self.__class__.__name__ + "({0})".format(self.tolist())
+
+    __str__ = __repr__
+
+    def evolver(self):
+        return CheckedPVector.Evolver(self.__class__, self)
+
+
+class CheckedPSet(PSet, CheckedType, metaclass=_CheckedTypeMeta):
+    """
+    A CheckedPSet is a PSet which allows specifying type and invariant checks.
+
+    >>> class Positives(CheckedPSet):
+    ...     __type__ = (int, float)
+    ...     __invariant__ = lambda n: (n >= 0, 'Negative')
+    ...
+    >>> Positives([1, 2, 3])
+    Positives([1, 2, 3])
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, initial=()):
+        if type(initial) is PMap:
+            return super(CheckedPSet, cls).__new__(cls, initial)
+
+        evolver = CheckedPSet.Evolver(cls, pset())
+        for e in initial:
+            evolver.add(e)
+
+        return evolver.persistent()
+
+    def __repr__(self):
+        return self.__class__.__name__ + super(CheckedPSet, self).__repr__()[4:]
+
+    def __str__(self):
+        return self.__repr__()
+
+    def serialize(self, format=None):
+        serializer = self.__serializer__
+        return set(serializer(format, v) for v in self)
+
+    create = classmethod(_checked_type_create)
+
+    def __reduce__(self):
+        # Pickling support
+        return _restore_pickle, (self.__class__, list(self),)
+
+    def evolver(self):
+        return CheckedPSet.Evolver(self.__class__, self)
+
+    class Evolver(PSet._Evolver):
+        __slots__ = ('_destination_class', '_invariant_errors')
+
+        def __init__(self, destination_class, original_set):
+            super(CheckedPSet.Evolver, self).__init__(original_set)
+            self._destination_class = destination_class
+            self._invariant_errors = []
+
+        def _check(self, it):
+            _check_types(it, self._destination_class._checked_types, self._destination_class)
+            error_data = _invariant_errors_iterable(it, self._destination_class._checked_invariants)
+            self._invariant_errors.extend(error_data)
+
+        def add(self, element):
+            self._check([element])
+            self._pmap_evolver[element] = True
+            return self
+
+        def persistent(self):
+            if self._invariant_errors:
+                raise InvariantException(error_codes=self._invariant_errors)
+
+            if self.is_dirty() or self._destination_class != type(self._original_pset):
+                return self._destination_class(self._pmap_evolver.persistent())
+
+            return self._original_pset
+
+
+class _CheckedMapTypeMeta(type):
+    def __new__(mcs, name, bases, dct):
+        _store_types(dct, bases, '_checked_key_types', '__key_type__')
+        _store_types(dct, bases, '_checked_value_types', '__value_type__')
+        store_invariants(dct, bases, '_checked_invariants', '__invariant__')
+
+        def default_serializer(self, _, key, value):
+            sk = key
+            if isinstance(key, CheckedType):
+                sk = key.serialize()
+
+            sv = value
+            if isinstance(value, CheckedType):
+                sv = value.serialize()
+
+            return sk, sv
+
+        dct.setdefault('__serializer__', default_serializer)
+
+        dct['__slots__'] = ()
+
+        return super(_CheckedMapTypeMeta, mcs).__new__(mcs, name, bases, dct)
+
+# Marker object
+_UNDEFINED_CHECKED_PMAP_SIZE = object()
+
+
+class CheckedPMap(PMap, CheckedType, metaclass=_CheckedMapTypeMeta):
+    """
+    A CheckedPMap is a PMap which allows specifying type and invariant checks.
+
+    >>> class IntToFloatMap(CheckedPMap):
+    ...     __key_type__ = int
+    ...     __value_type__ = float
+    ...     __invariant__ = lambda k, v: (int(v) == k, 'Invalid mapping')
+    ...
+    >>> IntToFloatMap({1: 1.5, 2: 2.25})
+    IntToFloatMap({1: 1.5, 2: 2.25})
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, initial={}, size=_UNDEFINED_CHECKED_PMAP_SIZE):
+        if size is not _UNDEFINED_CHECKED_PMAP_SIZE:
+            return super(CheckedPMap, cls).__new__(cls, size, initial)
+
+        evolver = CheckedPMap.Evolver(cls, pmap())
+        for k, v in initial.items():
+            evolver.set(k, v)
+
+        return evolver.persistent()
+
+    def evolver(self):
+        return CheckedPMap.Evolver(self.__class__, self)
+
+    def __repr__(self):
+        return self.__class__.__name__ + "({0})".format(str(dict(self)))
+
+    __str__ = __repr__
+
+    def serialize(self, format=None):
+        serializer = self.__serializer__
+        return dict(serializer(format, k, v) for k, v in self.items())
+
+    @classmethod
+    def create(cls, source_data, _factory_fields=None):
+        if isinstance(source_data, cls):
+            return source_data
+
+        # Recursively apply create methods of checked types if the types of the supplied data
+        # does not match any of the valid types.
+        key_types = get_types(cls._checked_key_types)
+        checked_key_type = next((t for t in key_types if issubclass(t, CheckedType)), None)
+        value_types = get_types(cls._checked_value_types)
+        checked_value_type = next((t for t in value_types if issubclass(t, CheckedType)), None)
+
+        if checked_key_type or checked_value_type:
+            return cls(dict((checked_key_type.create(key) if checked_key_type and not any(isinstance(key, t) for t in key_types) else key,
+                             checked_value_type.create(value) if checked_value_type and not any(isinstance(value, t) for t in value_types) else value)
+                            for key, value in source_data.items()))
+
+        return cls(source_data)
+
+    def __reduce__(self):
+        # Pickling support
+        return _restore_pickle, (self.__class__, dict(self),)
+
+    class Evolver(PMap._Evolver):
+        __slots__ = ('_destination_class', '_invariant_errors')
+
+        def __init__(self, destination_class, original_map):
+            super(CheckedPMap.Evolver, self).__init__(original_map)
+            self._destination_class = destination_class
+            self._invariant_errors = []
+
+        def set(self, key, value):
+            _check_types([key], self._destination_class._checked_key_types, self._destination_class, CheckedKeyTypeError)
+            _check_types([value], self._destination_class._checked_value_types, self._destination_class)
+            self._invariant_errors.extend(data for valid, data in (invariant(key, value)
+                                                                   for invariant in self._destination_class._checked_invariants)
+                                          if not valid)
+
+            return super(CheckedPMap.Evolver, self).set(key, value)
+
+        def persistent(self):
+            if self._invariant_errors:
+                raise InvariantException(error_codes=self._invariant_errors)
+
+            if self.is_dirty() or type(self._original_pmap) != self._destination_class:
+                return self._destination_class(self._buckets_evolver.persistent(), self._size)
+
+            return self._original_pmap
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_field_common.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_field_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..9ddfe29d2d971ec581e161d6de8b459a66e05b32
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_field_common.py
@@ -0,0 +1,329 @@
+import sys
+
+from pyrsistent._checked_types import (
+    CheckedPMap,
+    CheckedPSet,
+    CheckedPVector,
+    CheckedType,
+    InvariantException,
+    _restore_pickle,
+    get_type,
+    maybe_parse_user_type,
+    maybe_parse_many_user_types,
+)
+from pyrsistent._checked_types import optional as optional_type
+from pyrsistent._checked_types import wrap_invariant
+import inspect
+
+PY2 = sys.version_info[0] < 3
+
+
+def set_fields(dct, bases, name):
+    dct[name] = dict(sum([list(b.__dict__.get(name, {}).items()) for b in bases], []))
+
+    for k, v in list(dct.items()):
+        if isinstance(v, _PField):
+            dct[name][k] = v
+            del dct[k]
+
+
+def check_global_invariants(subject, invariants):
+    error_codes = tuple(error_code for is_ok, error_code in
+                        (invariant(subject) for invariant in invariants) if not is_ok)
+    if error_codes:
+        raise InvariantException(error_codes, (), 'Global invariant failed')
+
+
+def serialize(serializer, format, value):
+    if isinstance(value, CheckedType) and serializer is PFIELD_NO_SERIALIZER:
+        return value.serialize(format)
+
+    return serializer(format, value)
+
+
+def check_type(destination_cls, field, name, value):
+    if field.type and not any(isinstance(value, get_type(t)) for t in field.type):
+        actual_type = type(value)
+        message = "Invalid type for field {0}.{1}, was {2}".format(destination_cls.__name__, name, actual_type.__name__)
+        raise PTypeError(destination_cls, name, field.type, actual_type, message)
+
+
+def is_type_cls(type_cls, field_type):
+    if type(field_type) is set:
+        return True
+    types = tuple(field_type)
+    if len(types) == 0:
+        return False
+    return issubclass(get_type(types[0]), type_cls)
+
+
+def is_field_ignore_extra_complaint(type_cls, field, ignore_extra):
+    # ignore_extra param has default False value, for speed purpose no need to propagate False
+    if not ignore_extra:
+        return False
+
+    if not is_type_cls(type_cls, field.type):
+        return False
+
+    if PY2:
+        return 'ignore_extra' in inspect.getargspec(field.factory).args
+    else:
+        return 'ignore_extra' in inspect.signature(field.factory).parameters
+
+
+
+class _PField(object):
+    __slots__ = ('type', 'invariant', 'initial', 'mandatory', '_factory', 'serializer')
+
+    def __init__(self, type, invariant, initial, mandatory, factory, serializer):
+        self.type = type
+        self.invariant = invariant
+        self.initial = initial
+        self.mandatory = mandatory
+        self._factory = factory
+        self.serializer = serializer
+
+    @property
+    def factory(self):
+        # If no factory is specified and the type is another CheckedType use the factory method of that CheckedType
+        if self._factory is PFIELD_NO_FACTORY and len(self.type) == 1:
+            typ = get_type(tuple(self.type)[0])
+            if issubclass(typ, CheckedType):
+                return typ.create
+
+        return self._factory
+
+PFIELD_NO_TYPE = ()
+PFIELD_NO_INVARIANT = lambda _: (True, None)
+PFIELD_NO_FACTORY = lambda x: x
+PFIELD_NO_INITIAL = object()
+PFIELD_NO_SERIALIZER = lambda _, value: value
+
+
+def field(type=PFIELD_NO_TYPE, invariant=PFIELD_NO_INVARIANT, initial=PFIELD_NO_INITIAL,
+          mandatory=False, factory=PFIELD_NO_FACTORY, serializer=PFIELD_NO_SERIALIZER):
+    """
+    Field specification factory for :py:class:`PRecord`.
+
+    :param type: a type or iterable with types that are allowed for this field
+    :param invariant: a function specifying an invariant that must hold for the field
+    :param initial: value of field if not specified when instantiating the record
+    :param mandatory: boolean specifying if the field is mandatory or not
+    :param factory: function called when field is set.
+    :param serializer: function that returns a serialized version of the field
+    """
+
+    # NB: We have to check this predicate separately from the predicates in
+    # `maybe_parse_user_type` et al. because this one is related to supporting
+    # the argspec for `field`, while those are related to supporting the valid
+    # ways to specify types.
+
+    # Multiple types must be passed in one of the following containers. Note
+    # that a type that is a subclass of one of these containers, like a
+    # `collections.namedtuple`, will work as expected, since we check
+    # `isinstance` and not `issubclass`.
+    if isinstance(type, (list, set, tuple)):
+        types = set(maybe_parse_many_user_types(type))
+    else:
+        types = set(maybe_parse_user_type(type))
+
+    invariant_function = wrap_invariant(invariant) if invariant != PFIELD_NO_INVARIANT and callable(invariant) else invariant
+    field = _PField(type=types, invariant=invariant_function, initial=initial,
+                    mandatory=mandatory, factory=factory, serializer=serializer)
+
+    _check_field_parameters(field)
+
+    return field
+
+
+def _check_field_parameters(field):
+    for t in field.type:
+        if not isinstance(t, type) and not isinstance(t, str):
+            raise TypeError('Type parameter expected, not {0}'.format(type(t)))
+
+    if field.initial is not PFIELD_NO_INITIAL and \
+            not callable(field.initial) and \
+            field.type and not any(isinstance(field.initial, t) for t in field.type):
+        raise TypeError('Initial has invalid type {0}'.format(type(field.initial)))
+
+    if not callable(field.invariant):
+        raise TypeError('Invariant must be callable')
+
+    if not callable(field.factory):
+        raise TypeError('Factory must be callable')
+
+    if not callable(field.serializer):
+        raise TypeError('Serializer must be callable')
+
+
+class PTypeError(TypeError):
+    """
+    Raised when trying to assign a value with a type that doesn't match the declared type.
+
+    Attributes:
+    source_class -- The class of the record
+    field -- Field name
+    expected_types  -- Types allowed for the field
+    actual_type -- The non matching type
+    """
+    def __init__(self, source_class, field, expected_types, actual_type, *args, **kwargs):
+        super(PTypeError, self).__init__(*args, **kwargs)
+        self.source_class = source_class
+        self.field = field
+        self.expected_types = expected_types
+        self.actual_type = actual_type
+
+
+SEQ_FIELD_TYPE_SUFFIXES = {
+    CheckedPVector: "PVector",
+    CheckedPSet: "PSet",
+}
+
+# Global dictionary to hold auto-generated field types: used for unpickling
+_seq_field_types = {}
+
+def _restore_seq_field_pickle(checked_class, item_type, data):
+    """Unpickling function for auto-generated PVec/PSet field types."""
+    type_ = _seq_field_types[checked_class, item_type]
+    return _restore_pickle(type_, data)
+
+def _types_to_names(types):
+    """Convert a tuple of types to a human-readable string."""
+    return "".join(get_type(typ).__name__.capitalize() for typ in types)
+
+def _make_seq_field_type(checked_class, item_type):
+    """Create a subclass of the given checked class with the given item type."""
+    type_ = _seq_field_types.get((checked_class, item_type))
+    if type_ is not None:
+        return type_
+
+    class TheType(checked_class):
+        __type__ = item_type
+
+        def __reduce__(self):
+            return (_restore_seq_field_pickle,
+                    (checked_class, item_type, list(self)))
+
+    suffix = SEQ_FIELD_TYPE_SUFFIXES[checked_class]
+    TheType.__name__ = _types_to_names(TheType._checked_types) + suffix
+    _seq_field_types[checked_class, item_type] = TheType
+    return TheType
+
+def _sequence_field(checked_class, item_type, optional, initial):
+    """
+    Create checked field for either ``PSet`` or ``PVector``.
+
+    :param checked_class: ``CheckedPSet`` or ``CheckedPVector``.
+    :param item_type: The required type for the items in the set.
+    :param optional: If true, ``None`` can be used as a value for
+        this field.
+    :param initial: Initial value to pass to factory.
+
+    :return: A ``field`` containing a checked class.
+    """
+    TheType = _make_seq_field_type(checked_class, item_type)
+
+    if optional:
+        def factory(argument, _factory_fields=None, ignore_extra=False):
+            if argument is None:
+                return None
+            else:
+                return TheType.create(argument, _factory_fields=_factory_fields, ignore_extra=ignore_extra)
+    else:
+        factory = TheType.create
+
+    return field(type=optional_type(TheType) if optional else TheType,
+                 factory=factory, mandatory=True,
+                 initial=factory(initial))
+
+
+def pset_field(item_type, optional=False, initial=()):
+    """
+    Create checked ``PSet`` field.
+
+    :param item_type: The required type for the items in the set.
+    :param optional: If true, ``None`` can be used as a value for
+        this field.
+    :param initial: Initial value to pass to factory if no value is given
+        for the field.
+
+    :return: A ``field`` containing a ``CheckedPSet`` of the given type.
+    """
+    return _sequence_field(CheckedPSet, item_type, optional,
+                           initial)
+
+
+def pvector_field(item_type, optional=False, initial=()):
+    """
+    Create checked ``PVector`` field.
+
+    :param item_type: The required type for the items in the vector.
+    :param optional: If true, ``None`` can be used as a value for
+        this field.
+    :param initial: Initial value to pass to factory if no value is given
+        for the field.
+
+    :return: A ``field`` containing a ``CheckedPVector`` of the given type.
+    """
+    return _sequence_field(CheckedPVector, item_type, optional,
+                           initial)
+
+
+_valid = lambda item: (True, "")
+
+
+# Global dictionary to hold auto-generated field types: used for unpickling
+_pmap_field_types = {}
+
+def _restore_pmap_field_pickle(key_type, value_type, data):
+    """Unpickling function for auto-generated PMap field types."""
+    type_ = _pmap_field_types[key_type, value_type]
+    return _restore_pickle(type_, data)
+
+def _make_pmap_field_type(key_type, value_type):
+    """Create a subclass of CheckedPMap with the given key and value types."""
+    type_ = _pmap_field_types.get((key_type, value_type))
+    if type_ is not None:
+        return type_
+
+    class TheMap(CheckedPMap):
+        __key_type__ = key_type
+        __value_type__ = value_type
+
+        def __reduce__(self):
+            return (_restore_pmap_field_pickle,
+                    (self.__key_type__, self.__value_type__, dict(self)))
+
+    TheMap.__name__ = "{0}To{1}PMap".format(
+        _types_to_names(TheMap._checked_key_types),
+        _types_to_names(TheMap._checked_value_types))
+    _pmap_field_types[key_type, value_type] = TheMap
+    return TheMap
+
+
+def pmap_field(key_type, value_type, optional=False, invariant=PFIELD_NO_INVARIANT):
+    """
+    Create a checked ``PMap`` field.
+
+    :param key: The required type for the keys of the map.
+    :param value: The required type for the values of the map.
+    :param optional: If true, ``None`` can be used as a value for
+        this field.
+    :param invariant: Pass-through to ``field``.
+
+    :return: A ``field`` containing a ``CheckedPMap``.
+    """
+    TheMap = _make_pmap_field_type(key_type, value_type)
+
+    if optional:
+        def factory(argument):
+            if argument is None:
+                return None
+            else:
+                return TheMap.create(argument)
+    else:
+        factory = TheMap.create
+
+    return field(mandatory=True, initial=TheMap(),
+                 type=optional_type(TheMap) if optional else TheMap,
+                 factory=factory, invariant=invariant)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_helpers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..29ef17483e3c8a90bcbb3a15df4b27bf29267fb9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_helpers.py
@@ -0,0 +1,81 @@
+from functools import wraps
+from pyrsistent._pmap import PMap, pmap
+from pyrsistent._pset import PSet, pset
+from pyrsistent._pvector import PVector, pvector
+
+
+def freeze(o):
+    """
+    Recursively convert simple Python containers into pyrsistent versions
+    of those containers.
+
+    - list is converted to pvector, recursively
+    - dict is converted to pmap, recursively on values (but not keys)
+    - set is converted to pset, but not recursively
+    - tuple is converted to tuple, recursively.
+
+    Sets and dict keys are not recursively frozen because they do not contain
+    mutable data by convention. The main exception to this rule is that
+    dict keys and set elements are often instances of mutable objects that
+    support hash-by-id, which this function can't convert anyway.
+
+    >>> freeze(set([1, 2]))
+    pset([1, 2])
+    >>> freeze([1, {'a': 3}])
+    pvector([1, pmap({'a': 3})])
+    >>> freeze((1, []))
+    (1, pvector([]))
+    """
+    typ = type(o)
+    if typ is dict:
+        return pmap(dict((k, freeze(v)) for k, v in o.items()))
+    if typ is list:
+        return pvector(map(freeze, o))
+    if typ is tuple:
+        return tuple(map(freeze, o))
+    if typ is set:
+        return pset(o)
+    return o
+
+
+def thaw(o):
+    """
+    Recursively convert pyrsistent containers into simple Python containers.
+
+    - pvector is converted to list, recursively
+    - pmap is converted to dict, recursively on values (but not keys)
+    - pset is converted to set, but not recursively
+    - tuple is converted to tuple, recursively.
+
+    >>> from pyrsistent import s, m, v
+    >>> thaw(s(1, 2))
+    {1, 2}
+    >>> thaw(v(1, m(a=3)))
+    [1, {'a': 3}]
+    >>> thaw((1, v()))
+    (1, [])
+    """
+    if isinstance(o, PVector):
+        return list(map(thaw, o))
+    if isinstance(o, PMap):
+        return dict((k, thaw(v)) for k, v in o.iteritems())
+    if isinstance(o, PSet):
+        return set(o)
+    if type(o) is tuple:
+        return tuple(map(thaw, o))
+    return o
+
+
+def mutant(fn):
+    """
+    Convenience decorator to isolate mutation to within the decorated function (with respect
+    to the input arguments).
+
+    All arguments to the decorated function will be frozen so that they are guaranteed not to change.
+    The return value is also frozen.
+    """
+    @wraps(fn)
+    def inner_f(*args, **kwargs):
+        return freeze(fn(*[freeze(e) for e in args], **dict(freeze(item) for item in kwargs.items())))
+
+    return inner_f
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_immutable.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_immutable.py
new file mode 100644
index 0000000000000000000000000000000000000000..66060d09f04e4170dfebe8fa319457bcadf60edd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_immutable.py
@@ -0,0 +1,103 @@
+import sys
+
+
+def immutable(members='', name='Immutable', verbose=False):
+    """
+    Produces a class that either can be used standalone or as a base class for persistent classes.
+
+    This is a thin wrapper around a named tuple.
+
+    Constructing a type and using it to instantiate objects:
+
+    >>> Point = immutable('x, y', name='Point')
+    >>> p = Point(1, 2)
+    >>> p2 = p.set(x=3)
+    >>> p
+    Point(x=1, y=2)
+    >>> p2
+    Point(x=3, y=2)
+
+    Inheriting from a constructed type. In this case no type name needs to be supplied:
+
+    >>> class PositivePoint(immutable('x, y')):
+    ...     __slots__ = tuple()
+    ...     def __new__(cls, x, y):
+    ...         if x > 0 and y > 0:
+    ...             return super(PositivePoint, cls).__new__(cls, x, y)
+    ...         raise Exception('Coordinates must be positive!')
+    ...
+    >>> p = PositivePoint(1, 2)
+    >>> p.set(x=3)
+    PositivePoint(x=3, y=2)
+    >>> p.set(y=-3)
+    Traceback (most recent call last):
+    Exception: Coordinates must be positive!
+
+    The persistent class also supports the notion of frozen members. The value of a frozen member
+    cannot be updated. For example it could be used to implement an ID that should remain the same
+    over time. A frozen member is denoted by a trailing underscore.
+
+    >>> Point = immutable('x, y, id_', name='Point')
+    >>> p = Point(1, 2, id_=17)
+    >>> p.set(x=3)
+    Point(x=3, y=2, id_=17)
+    >>> p.set(id_=18)
+    Traceback (most recent call last):
+    AttributeError: Cannot set frozen members id_
+    """
+
+    if isinstance(members, str):
+        members = members.replace(',', ' ').split()
+
+    def frozen_member_test():
+        frozen_members = ["'%s'" % f for f in members if f.endswith('_')]
+        if frozen_members:
+            return """
+        frozen_fields = fields_to_modify & set([{frozen_members}])
+        if frozen_fields:
+            raise AttributeError('Cannot set frozen members %s' % ', '.join(frozen_fields))
+            """.format(frozen_members=', '.join(frozen_members))
+
+        return ''
+
+    verbose_string = ""
+    if sys.version_info < (3, 7):
+        # Verbose is no longer supported in Python 3.7
+        verbose_string = ", verbose={verbose}".format(verbose=verbose)
+
+    quoted_members = ', '.join("'%s'" % m for m in members)
+    template = """
+class {class_name}(namedtuple('ImmutableBase', [{quoted_members}]{verbose_string})):
+    __slots__ = tuple()
+
+    def __repr__(self):
+        return super({class_name}, self).__repr__().replace('ImmutableBase', self.__class__.__name__)
+
+    def set(self, **kwargs):
+        if not kwargs:
+            return self
+
+        fields_to_modify = set(kwargs.keys())
+        if not fields_to_modify <= {member_set}:
+            raise AttributeError("'%s' is not a member" % ', '.join(fields_to_modify - {member_set}))
+
+        {frozen_member_test}
+
+        return self.__class__.__new__(self.__class__, *map(kwargs.pop, [{quoted_members}], self))
+""".format(quoted_members=quoted_members,
+               member_set="set([%s])" % quoted_members if quoted_members else 'set()',
+               frozen_member_test=frozen_member_test(),
+               verbose_string=verbose_string,
+               class_name=name)
+
+    if verbose:
+        print(template)
+
+    from collections import namedtuple
+    namespace = dict(namedtuple=namedtuple, __name__='pyrsistent_immutable')
+    try:
+        exec(template, namespace)
+    except SyntaxError as e:
+        raise SyntaxError(e.message + ':\n' + template) from e
+
+    return namespace[name]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pbag.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pbag.py
new file mode 100644
index 0000000000000000000000000000000000000000..9cf5840b72e708649ab9b4a9ac3e36d58eed06cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pbag.py
@@ -0,0 +1,267 @@
+from collections.abc import Container, Iterable, Sized, Hashable
+from functools import reduce
+from pyrsistent._pmap import pmap
+
+
+def _add_to_counters(counters, element):
+    return counters.set(element, counters.get(element, 0) + 1)
+
+
+class PBag(object):
+    """
+    A persistent bag/multiset type.
+
+    Requires elements to be hashable, and allows duplicates, but has no
+    ordering. Bags are hashable.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`b`
+    or :py:func:`pbag` to create an instance.
+
+    Some examples:
+
+    >>> s = pbag([1, 2, 3, 1])
+    >>> s2 = s.add(4)
+    >>> s3 = s2.remove(1)
+    >>> s
+    pbag([1, 1, 2, 3])
+    >>> s2
+    pbag([1, 1, 2, 3, 4])
+    >>> s3
+    pbag([1, 2, 3, 4])
+    """
+
+    __slots__ = ('_counts', '__weakref__')
+
+    def __init__(self, counts):
+        self._counts = counts
+
+    def add(self, element):
+        """
+        Add an element to the bag.
+
+        >>> s = pbag([1])
+        >>> s2 = s.add(1)
+        >>> s3 = s.add(2)
+        >>> s2
+        pbag([1, 1])
+        >>> s3
+        pbag([1, 2])
+        """
+        return PBag(_add_to_counters(self._counts, element))
+
+    def update(self, iterable):
+        """
+        Update bag with all elements in iterable.
+
+        >>> s = pbag([1])
+        >>> s.update([1, 2])
+        pbag([1, 1, 2])
+        """
+        if iterable:
+            return PBag(reduce(_add_to_counters, iterable, self._counts))
+
+        return self
+
+    def remove(self, element):
+        """
+        Remove an element from the bag.
+
+        >>> s = pbag([1, 1, 2])
+        >>> s2 = s.remove(1)
+        >>> s3 = s.remove(2)
+        >>> s2
+        pbag([1, 2])
+        >>> s3
+        pbag([1, 1])
+        """
+        if element not in self._counts:
+            raise KeyError(element)
+        elif self._counts[element] == 1:
+            newc = self._counts.remove(element)
+        else:
+            newc = self._counts.set(element, self._counts[element] - 1)
+        return PBag(newc)
+
+    def count(self, element):
+        """
+        Return the number of times an element appears.
+
+
+        >>> pbag([]).count('non-existent')
+        0
+        >>> pbag([1, 1, 2]).count(1)
+        2
+        """
+        return self._counts.get(element, 0)
+
+    def __len__(self):
+        """
+        Return the length including duplicates.
+
+        >>> len(pbag([1, 1, 2]))
+        3
+        """
+        return sum(self._counts.itervalues())
+
+    def __iter__(self):
+        """
+        Return an iterator of all elements, including duplicates.
+
+        >>> list(pbag([1, 1, 2]))
+        [1, 1, 2]
+        >>> list(pbag([1, 2]))
+        [1, 2]
+        """
+        for elt, count in self._counts.iteritems():
+            for i in range(count):
+                yield elt
+
+    def __contains__(self, elt):
+        """
+        Check if an element is in the bag.
+
+        >>> 1 in pbag([1, 1, 2])
+        True
+        >>> 0 in pbag([1, 2])
+        False
+        """
+        return elt in self._counts
+
+    def __repr__(self):
+        return "pbag({0})".format(list(self))
+
+    def __eq__(self, other):
+        """
+        Check if two bags are equivalent, honoring the number of duplicates,
+        and ignoring insertion order.
+
+        >>> pbag([1, 1, 2]) == pbag([1, 2])
+        False
+        >>> pbag([2, 1, 0]) == pbag([0, 1, 2])
+        True
+        """
+        if type(other) is not PBag:
+            raise TypeError("Can only compare PBag with PBags")
+        return self._counts == other._counts
+
+    def __lt__(self, other):
+        raise TypeError('PBags are not orderable')
+
+    __le__ = __lt__
+    __gt__ = __lt__
+    __ge__ = __lt__
+
+    # Multiset-style operations similar to collections.Counter
+
+    def __add__(self, other):
+        """
+        Combine elements from two PBags.
+
+        >>> pbag([1, 2, 2]) + pbag([2, 3, 3])
+        pbag([1, 2, 2, 2, 3, 3])
+        """
+        if not isinstance(other, PBag):
+            return NotImplemented
+        result = self._counts.evolver()
+        for elem, other_count in other._counts.iteritems():
+            result[elem] = self.count(elem) + other_count
+        return PBag(result.persistent())
+
+    def __sub__(self, other):
+        """
+        Remove elements from one PBag that are present in another.
+
+        >>> pbag([1, 2, 2, 2, 3]) - pbag([2, 3, 3, 4])
+        pbag([1, 2, 2])
+        """
+        if not isinstance(other, PBag):
+            return NotImplemented
+        result = self._counts.evolver()
+        for elem, other_count in other._counts.iteritems():
+            newcount = self.count(elem) - other_count
+            if newcount > 0:
+                result[elem] = newcount
+            elif elem in self:
+                result.remove(elem)
+        return PBag(result.persistent())
+
+    def __or__(self, other):
+        """
+        Union: Keep elements that are present in either of two PBags.
+
+        >>> pbag([1, 2, 2, 2]) | pbag([2, 3, 3])
+        pbag([1, 2, 2, 2, 3, 3])
+        """
+        if not isinstance(other, PBag):
+            return NotImplemented
+        result = self._counts.evolver()
+        for elem, other_count in other._counts.iteritems():
+            count = self.count(elem)
+            newcount = max(count, other_count)
+            result[elem] = newcount
+        return PBag(result.persistent())
+
+    def __and__(self, other):
+        """
+        Intersection: Only keep elements that are present in both PBags.
+
+        >>> pbag([1, 2, 2, 2]) & pbag([2, 3, 3])
+        pbag([2])
+        """
+        if not isinstance(other, PBag):
+            return NotImplemented
+        result = pmap().evolver()
+        for elem, count in self._counts.iteritems():
+            newcount = min(count, other.count(elem))
+            if newcount > 0:
+                result[elem] = newcount
+        return PBag(result.persistent())
+
+    def __hash__(self):
+        """
+        Hash based on value of elements.
+
+        >>> m = pmap({pbag([1, 2]): "it's here!"})
+        >>> m[pbag([2, 1])]
+        "it's here!"
+        >>> pbag([1, 1, 2]) in m
+        False
+        """
+        return hash(self._counts)
+
+
+Container.register(PBag)
+Iterable.register(PBag)
+Sized.register(PBag)
+Hashable.register(PBag)
+
+
+def b(*elements):
+    """
+    Construct a persistent bag.
+
+    Takes an arbitrary number of arguments to insert into the new persistent
+    bag.
+
+    >>> b(1, 2, 3, 2)
+    pbag([1, 2, 2, 3])
+    """
+    return pbag(elements)
+
+
+def pbag(elements):
+    """
+    Convert an iterable to a persistent bag.
+
+    Takes an iterable with elements to insert.
+
+    >>> pbag([1, 2, 3, 2])
+    pbag([1, 2, 2, 3])
+    """
+    if not elements:
+        return _EMPTY_PBAG
+    return PBag(reduce(_add_to_counters, elements, pmap()))
+
+
+_EMPTY_PBAG = PBag(pmap())
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pclass.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pclass.py
new file mode 100644
index 0000000000000000000000000000000000000000..fd31a95d63a281b6e5624121f790b08ecaee8be1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pclass.py
@@ -0,0 +1,262 @@
+from pyrsistent._checked_types import (InvariantException, CheckedType, _restore_pickle, store_invariants)
+from pyrsistent._field_common import (
+    set_fields, check_type, is_field_ignore_extra_complaint, PFIELD_NO_INITIAL, serialize, check_global_invariants
+)
+from pyrsistent._transformations import transform
+
+
+def _is_pclass(bases):
+    return len(bases) == 1 and bases[0] == CheckedType
+
+
+class PClassMeta(type):
+    def __new__(mcs, name, bases, dct):
+        set_fields(dct, bases, name='_pclass_fields')
+        store_invariants(dct, bases, '_pclass_invariants', '__invariant__')
+        dct['__slots__'] = ('_pclass_frozen',) + tuple(key for key in dct['_pclass_fields'])
+
+        # There must only be one __weakref__ entry in the inheritance hierarchy,
+        # lets put it on the top level class.
+        if _is_pclass(bases):
+            dct['__slots__'] += ('__weakref__',)
+
+        return super(PClassMeta, mcs).__new__(mcs, name, bases, dct)
+
+_MISSING_VALUE = object()
+
+
+def _check_and_set_attr(cls, field, name, value, result, invariant_errors):
+    check_type(cls, field, name, value)
+    is_ok, error_code = field.invariant(value)
+    if not is_ok:
+        invariant_errors.append(error_code)
+    else:
+        setattr(result, name, value)
+
+
+class PClass(CheckedType, metaclass=PClassMeta):
+    """
+    A PClass is a python class with a fixed set of specified fields. PClasses are declared as python classes inheriting
+    from PClass. It is defined the same way that PRecords are and behaves like a PRecord in all aspects except that it
+    is not a PMap and hence not a collection but rather a plain Python object.
+
+
+    More documentation and examples of PClass usage is available at https://github.com/tobgu/pyrsistent
+    """
+    def __new__(cls, **kwargs):    # Support *args?
+        result = super(PClass, cls).__new__(cls)
+        factory_fields = kwargs.pop('_factory_fields', None)
+        ignore_extra = kwargs.pop('ignore_extra', None)
+        missing_fields = []
+        invariant_errors = []
+        for name, field in cls._pclass_fields.items():
+            if name in kwargs:
+                if factory_fields is None or name in factory_fields:
+                    if is_field_ignore_extra_complaint(PClass, field, ignore_extra):
+                        value = field.factory(kwargs[name], ignore_extra=ignore_extra)
+                    else:
+                        value = field.factory(kwargs[name])
+                else:
+                    value = kwargs[name]
+                _check_and_set_attr(cls, field, name, value, result, invariant_errors)
+                del kwargs[name]
+            elif field.initial is not PFIELD_NO_INITIAL:
+                initial = field.initial() if callable(field.initial) else field.initial
+                _check_and_set_attr(
+                    cls, field, name, initial, result, invariant_errors)
+            elif field.mandatory:
+                missing_fields.append('{0}.{1}'.format(cls.__name__, name))
+
+        if invariant_errors or missing_fields:
+            raise InvariantException(tuple(invariant_errors), tuple(missing_fields), 'Field invariant failed')
+
+        if kwargs:
+            raise AttributeError("'{0}' are not among the specified fields for {1}".format(
+                ', '.join(kwargs), cls.__name__))
+
+        check_global_invariants(result, cls._pclass_invariants)
+
+        result._pclass_frozen = True
+        return result
+
+    def set(self, *args, **kwargs):
+        """
+        Set a field in the instance. Returns a new instance with the updated value. The original instance remains
+        unmodified. Accepts key-value pairs or single string representing the field name and a value.
+
+        >>> from pyrsistent import PClass, field
+        >>> class AClass(PClass):
+        ...     x = field()
+        ...
+        >>> a = AClass(x=1)
+        >>> a2 = a.set(x=2)
+        >>> a3 = a.set('x', 3)
+        >>> a
+        AClass(x=1)
+        >>> a2
+        AClass(x=2)
+        >>> a3
+        AClass(x=3)
+        """
+        if args:
+            kwargs[args[0]] = args[1]
+
+        factory_fields = set(kwargs)
+
+        for key in self._pclass_fields:
+            if key not in kwargs:
+                value = getattr(self, key, _MISSING_VALUE)
+                if value is not _MISSING_VALUE:
+                    kwargs[key] = value
+
+        return self.__class__(_factory_fields=factory_fields, **kwargs)
+
+    @classmethod
+    def create(cls, kwargs, _factory_fields=None, ignore_extra=False):
+        """
+        Factory method. Will create a new PClass of the current type and assign the values
+        specified in kwargs.
+
+        :param ignore_extra: A boolean which when set to True will ignore any keys which appear in kwargs that are not
+                             in the set of fields on the PClass.
+        """
+        if isinstance(kwargs, cls):
+            return kwargs
+
+        if ignore_extra:
+            kwargs = {k: kwargs[k] for k in cls._pclass_fields if k in kwargs}
+
+        return cls(_factory_fields=_factory_fields, ignore_extra=ignore_extra, **kwargs)
+
+    def serialize(self, format=None):
+        """
+        Serialize the current PClass using custom serializer functions for fields where
+        such have been supplied.
+        """
+        result = {}
+        for name in self._pclass_fields:
+            value = getattr(self, name, _MISSING_VALUE)
+            if value is not _MISSING_VALUE:
+                result[name] = serialize(self._pclass_fields[name].serializer, format, value)
+
+        return result
+
+    def transform(self, *transformations):
+        """
+        Apply transformations to the currency PClass. For more details on transformations see
+        the documentation for PMap. Transformations on PClasses do not support key matching
+        since the PClass is not a collection. Apart from that the transformations available
+        for other persistent types work as expected.
+        """
+        return transform(self, transformations)
+
+    def __eq__(self, other):
+        if isinstance(other, self.__class__):
+            for name in self._pclass_fields:
+                if getattr(self, name, _MISSING_VALUE) != getattr(other, name, _MISSING_VALUE):
+                    return False
+
+            return True
+
+        return NotImplemented
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        # May want to optimize this by caching the hash somehow
+        return hash(tuple((key, getattr(self, key, _MISSING_VALUE)) for key in self._pclass_fields))
+
+    def __setattr__(self, key, value):
+        if getattr(self, '_pclass_frozen', False):
+            raise AttributeError("Can't set attribute, key={0}, value={1}".format(key, value))
+
+        super(PClass, self).__setattr__(key, value)
+
+    def __delattr__(self, key):
+            raise AttributeError("Can't delete attribute, key={0}, use remove()".format(key))
+
+    def _to_dict(self):
+        result = {}
+        for key in self._pclass_fields:
+            value = getattr(self, key, _MISSING_VALUE)
+            if value is not _MISSING_VALUE:
+                result[key] = value
+
+        return result
+
+    def __repr__(self):
+        return "{0}({1})".format(self.__class__.__name__,
+                                 ', '.join('{0}={1}'.format(k, repr(v)) for k, v in self._to_dict().items()))
+
+    def __reduce__(self):
+        # Pickling support
+        data = dict((key, getattr(self, key)) for key in self._pclass_fields if hasattr(self, key))
+        return _restore_pickle, (self.__class__, data,)
+
+    def evolver(self):
+        """
+        Returns an evolver for this object.
+        """
+        return _PClassEvolver(self, self._to_dict())
+
+    def remove(self, name):
+        """
+        Remove attribute given by name from the current instance. Raises AttributeError if the
+        attribute doesn't exist.
+        """
+        evolver = self.evolver()
+        del evolver[name]
+        return evolver.persistent()
+
+
+class _PClassEvolver(object):
+    __slots__ = ('_pclass_evolver_original', '_pclass_evolver_data', '_pclass_evolver_data_is_dirty', '_factory_fields')
+
+    def __init__(self, original, initial_dict):
+        self._pclass_evolver_original = original
+        self._pclass_evolver_data = initial_dict
+        self._pclass_evolver_data_is_dirty = False
+        self._factory_fields = set()
+
+    def __getitem__(self, item):
+        return self._pclass_evolver_data[item]
+
+    def set(self, key, value):
+        if self._pclass_evolver_data.get(key, _MISSING_VALUE) is not value:
+            self._pclass_evolver_data[key] = value
+            self._factory_fields.add(key)
+            self._pclass_evolver_data_is_dirty = True
+
+        return self
+
+    def __setitem__(self, key, value):
+        self.set(key, value)
+
+    def remove(self, item):
+        if item in self._pclass_evolver_data:
+            del self._pclass_evolver_data[item]
+            self._factory_fields.discard(item)
+            self._pclass_evolver_data_is_dirty = True
+            return self
+
+        raise AttributeError(item)
+
+    def __delitem__(self, item):
+        self.remove(item)
+
+    def persistent(self):
+        if self._pclass_evolver_data_is_dirty:
+            return self._pclass_evolver_original.__class__(_factory_fields=self._factory_fields,
+                                                           **self._pclass_evolver_data)
+
+        return self._pclass_evolver_original
+
+    def __setattr__(self, key, value):
+        if key not in self.__slots__:
+            self.set(key, value)
+        else:
+            super(_PClassEvolver, self).__setattr__(key, value)
+
+    def __getattr__(self, item):
+        return self[item]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pdeque.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pdeque.py
new file mode 100644
index 0000000000000000000000000000000000000000..bd11bfa0320df9646804b276abd1d5ca3ac43cd4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pdeque.py
@@ -0,0 +1,376 @@
+from collections.abc import Sequence, Hashable
+from itertools import islice, chain
+from numbers import Integral
+from pyrsistent._plist import plist
+
+
+class PDeque(object):
+    """
+    Persistent double ended queue (deque). Allows quick appends and pops in both ends. Implemented
+    using two persistent lists.
+
+    A maximum length can be specified to create a bounded queue.
+
+    Fully supports the Sequence and Hashable protocols including indexing and slicing but
+    if you need fast random access go for the PVector instead.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`dq` or :py:func:`pdeque` to
+    create an instance.
+
+    Some examples:
+
+    >>> x = pdeque([1, 2, 3])
+    >>> x.left
+    1
+    >>> x.right
+    3
+    >>> x[0] == x.left
+    True
+    >>> x[-1] == x.right
+    True
+    >>> x.pop()
+    pdeque([1, 2])
+    >>> x.pop() == x[:-1]
+    True
+    >>> x.popleft()
+    pdeque([2, 3])
+    >>> x.append(4)
+    pdeque([1, 2, 3, 4])
+    >>> x.appendleft(4)
+    pdeque([4, 1, 2, 3])
+
+    >>> y = pdeque([1, 2, 3], maxlen=3)
+    >>> y.append(4)
+    pdeque([2, 3, 4], maxlen=3)
+    >>> y.appendleft(4)
+    pdeque([4, 1, 2], maxlen=3)
+    """
+    __slots__ = ('_left_list', '_right_list', '_length', '_maxlen', '__weakref__')
+
+    def __new__(cls, left_list, right_list, length, maxlen=None):
+        instance = super(PDeque, cls).__new__(cls)
+        instance._left_list = left_list
+        instance._right_list = right_list
+        instance._length = length
+
+        if maxlen is not None:
+            if not isinstance(maxlen, Integral):
+                raise TypeError('An integer is required as maxlen')
+
+            if maxlen < 0:
+                raise ValueError("maxlen must be non-negative")
+
+        instance._maxlen = maxlen
+        return instance
+
+    @property
+    def right(self):
+        """
+        Rightmost element in dqueue.
+        """
+        return PDeque._tip_from_lists(self._right_list, self._left_list)
+
+    @property
+    def left(self):
+        """
+        Leftmost element in dqueue.
+        """
+        return PDeque._tip_from_lists(self._left_list, self._right_list)
+
+    @staticmethod
+    def _tip_from_lists(primary_list, secondary_list):
+        if primary_list:
+            return primary_list.first
+
+        if secondary_list:
+            return secondary_list[-1]
+
+        raise IndexError('No elements in empty deque')
+
+    def __iter__(self):
+        return chain(self._left_list, self._right_list.reverse())
+
+    def __repr__(self):
+        return "pdeque({0}{1})".format(list(self),
+                                       ', maxlen={0}'.format(self._maxlen) if self._maxlen is not None else '')
+    __str__ = __repr__
+
+    @property
+    def maxlen(self):
+        """
+        Maximum length of the queue.
+        """
+        return self._maxlen
+
+    def pop(self, count=1):
+        """
+        Return new deque with rightmost element removed. Popping the empty queue
+        will return the empty queue. A optional count can be given to indicate the
+        number of elements to pop. Popping with a negative index is the same as
+        popleft. Executes in amortized O(k) where k is the number of elements to pop.
+
+        >>> pdeque([1, 2]).pop()
+        pdeque([1])
+        >>> pdeque([1, 2]).pop(2)
+        pdeque([])
+        >>> pdeque([1, 2]).pop(-1)
+        pdeque([2])
+        """
+        if count < 0:
+            return self.popleft(-count)
+
+        new_right_list, new_left_list = PDeque._pop_lists(self._right_list, self._left_list, count)
+        return PDeque(new_left_list, new_right_list, max(self._length - count, 0), self._maxlen)
+
+    def popleft(self, count=1):
+        """
+        Return new deque with leftmost element removed. Otherwise functionally
+        equivalent to pop().
+
+        >>> pdeque([1, 2]).popleft()
+        pdeque([2])
+        """
+        if count < 0:
+            return self.pop(-count)
+
+        new_left_list, new_right_list = PDeque._pop_lists(self._left_list, self._right_list, count)
+        return PDeque(new_left_list, new_right_list, max(self._length - count, 0), self._maxlen)
+
+    @staticmethod
+    def _pop_lists(primary_list, secondary_list, count):
+        new_primary_list = primary_list
+        new_secondary_list = secondary_list
+
+        while count > 0 and (new_primary_list or new_secondary_list):
+            count -= 1
+            if new_primary_list.rest:
+                new_primary_list = new_primary_list.rest
+            elif new_primary_list:
+                new_primary_list = new_secondary_list.reverse()
+                new_secondary_list = plist()
+            else:
+                new_primary_list = new_secondary_list.reverse().rest
+                new_secondary_list = plist()
+
+        return new_primary_list, new_secondary_list
+
+    def _is_empty(self):
+        return not self._left_list and not self._right_list
+
+    def __lt__(self, other):
+        if not isinstance(other, PDeque):
+            return NotImplemented
+
+        return tuple(self) < tuple(other)
+
+    def __eq__(self, other):
+        if not isinstance(other, PDeque):
+            return NotImplemented
+
+        if tuple(self) == tuple(other):
+            # Sanity check of the length value since it is redundant (there for performance)
+            assert len(self) == len(other)
+            return True
+
+        return False
+
+    def __hash__(self):
+        return  hash(tuple(self))
+
+    def __len__(self):
+        return self._length
+
+    def append(self, elem):
+        """
+        Return new deque with elem as the rightmost element.
+
+        >>> pdeque([1, 2]).append(3)
+        pdeque([1, 2, 3])
+        """
+        new_left_list, new_right_list, new_length = self._append(self._left_list, self._right_list, elem)
+        return PDeque(new_left_list, new_right_list, new_length, self._maxlen)
+
+    def appendleft(self, elem):
+        """
+        Return new deque with elem as the leftmost element.
+
+        >>> pdeque([1, 2]).appendleft(3)
+        pdeque([3, 1, 2])
+        """
+        new_right_list, new_left_list, new_length = self._append(self._right_list, self._left_list, elem)
+        return PDeque(new_left_list, new_right_list, new_length, self._maxlen)
+
+    def _append(self, primary_list, secondary_list, elem):
+        if self._maxlen is not None and self._length == self._maxlen:
+            if self._maxlen == 0:
+                return primary_list, secondary_list, 0
+            new_primary_list, new_secondary_list = PDeque._pop_lists(primary_list, secondary_list, 1)
+            return new_primary_list, new_secondary_list.cons(elem), self._length
+
+        return primary_list, secondary_list.cons(elem), self._length + 1
+
+    @staticmethod
+    def _extend_list(the_list, iterable):
+        count = 0
+        for elem in iterable:
+            the_list = the_list.cons(elem)
+            count += 1
+
+        return the_list, count
+
+    def _extend(self, primary_list, secondary_list, iterable):
+        new_primary_list, extend_count = PDeque._extend_list(primary_list, iterable)
+        new_secondary_list = secondary_list
+        current_len = self._length + extend_count
+        if self._maxlen is not None and current_len > self._maxlen:
+            pop_len = current_len - self._maxlen
+            new_secondary_list, new_primary_list = PDeque._pop_lists(new_secondary_list, new_primary_list, pop_len)
+            extend_count -= pop_len
+
+        return new_primary_list, new_secondary_list, extend_count
+
+    def extend(self, iterable):
+        """
+        Return new deque with all elements of iterable appended to the right.
+
+        >>> pdeque([1, 2]).extend([3, 4])
+        pdeque([1, 2, 3, 4])
+        """
+        new_right_list, new_left_list, extend_count = self._extend(self._right_list, self._left_list, iterable)
+        return PDeque(new_left_list, new_right_list, self._length + extend_count, self._maxlen)
+
+    def extendleft(self, iterable):
+        """
+        Return new deque with all elements of iterable appended to the left.
+
+        NB! The elements will be inserted in reverse order compared to the order in the iterable.
+
+        >>> pdeque([1, 2]).extendleft([3, 4])
+        pdeque([4, 3, 1, 2])
+        """
+        new_left_list, new_right_list, extend_count = self._extend(self._left_list, self._right_list, iterable)
+        return PDeque(new_left_list, new_right_list, self._length + extend_count, self._maxlen)
+
+    def count(self, elem):
+        """
+        Return the number of elements equal to elem present in the queue
+
+        >>> pdeque([1, 2, 1]).count(1)
+        2
+        """
+        return self._left_list.count(elem) + self._right_list.count(elem)
+
+    def remove(self, elem):
+        """
+        Return new deque with first element from left equal to elem removed. If no such element is found
+        a ValueError is raised.
+
+        >>> pdeque([2, 1, 2]).remove(2)
+        pdeque([1, 2])
+        """
+        try:
+            return PDeque(self._left_list.remove(elem), self._right_list, self._length - 1)
+        except ValueError:
+            # Value not found in left list, try the right list
+            try:
+                # This is severely inefficient with a double reverse, should perhaps implement a remove_last()?
+                return PDeque(self._left_list,
+                               self._right_list.reverse().remove(elem).reverse(), self._length - 1)
+            except ValueError as e:
+                raise ValueError('{0} not found in PDeque'.format(elem)) from e
+
+    def reverse(self):
+        """
+        Return reversed deque.
+
+        >>> pdeque([1, 2, 3]).reverse()
+        pdeque([3, 2, 1])
+
+        Also supports the standard python reverse function.
+
+        >>> reversed(pdeque([1, 2, 3]))
+        pdeque([3, 2, 1])
+        """
+        return PDeque(self._right_list, self._left_list, self._length)
+    __reversed__ = reverse
+
+    def rotate(self, steps):
+        """
+        Return deque with elements rotated steps steps.
+
+        >>> x = pdeque([1, 2, 3])
+        >>> x.rotate(1)
+        pdeque([3, 1, 2])
+        >>> x.rotate(-2)
+        pdeque([3, 1, 2])
+        """
+        popped_deque = self.pop(steps)
+        if steps >= 0:
+            return popped_deque.extendleft(islice(self.reverse(), steps))
+
+        return popped_deque.extend(islice(self, -steps))
+
+    def __reduce__(self):
+        # Pickling support
+        return pdeque, (list(self), self._maxlen)
+
+    def __getitem__(self, index):
+        if isinstance(index, slice):
+            if index.step is not None and index.step != 1:
+                # Too difficult, no structural sharing possible
+                return pdeque(tuple(self)[index], maxlen=self._maxlen)
+
+            result = self
+            if index.start is not None:
+                result = result.popleft(index.start % self._length)
+            if index.stop is not None:
+                result = result.pop(self._length - (index.stop % self._length))
+
+            return result
+
+        if not isinstance(index, Integral):
+            raise TypeError("'%s' object cannot be interpreted as an index" % type(index).__name__)
+
+        if index >= 0:
+            return self.popleft(index).left
+
+        shifted = len(self) + index
+        if shifted < 0:
+            raise IndexError(
+                "pdeque index {0} out of range {1}".format(index, len(self)),
+            )
+        return self.popleft(shifted).left
+
+    index = Sequence.index
+
+Sequence.register(PDeque)
+Hashable.register(PDeque)
+
+
+def pdeque(iterable=(), maxlen=None):
+    """
+    Return deque containing the elements of iterable. If maxlen is specified then
+    len(iterable) - maxlen elements are discarded from the left to if len(iterable) > maxlen.
+
+    >>> pdeque([1, 2, 3])
+    pdeque([1, 2, 3])
+    >>> pdeque([1, 2, 3, 4], maxlen=2)
+    pdeque([3, 4], maxlen=2)
+    """
+    t = tuple(iterable)
+    if maxlen is not None:
+        t = t[-maxlen:]
+    length = len(t)
+    pivot = int(length / 2)
+    left = plist(t[:pivot])
+    right = plist(t[pivot:], reverse=True)
+    return PDeque(left, right, length, maxlen)
+
+def dq(*elements):
+    """
+    Return deque containing all arguments.
+
+    >>> dq(1, 2, 3)
+    pdeque([1, 2, 3])
+    """
+    return pdeque(elements)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_plist.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_plist.py
new file mode 100644
index 0000000000000000000000000000000000000000..bea7f5ecfe6357684ef3483ccbf68ce9bfc196a1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_plist.py
@@ -0,0 +1,313 @@
+from collections.abc import Sequence, Hashable
+from numbers import Integral
+from functools import reduce
+
+
+class _PListBuilder(object):
+    """
+    Helper class to allow construction of a list without
+    having to reverse it in the end.
+    """
+    __slots__ = ('_head', '_tail')
+
+    def __init__(self):
+        self._head = _EMPTY_PLIST
+        self._tail = _EMPTY_PLIST
+
+    def _append(self, elem, constructor):
+        if not self._tail:
+            self._head = constructor(elem)
+            self._tail = self._head
+        else:
+            self._tail.rest = constructor(elem)
+            self._tail = self._tail.rest
+
+        return self._head
+
+    def append_elem(self, elem):
+        return self._append(elem, lambda e: PList(e, _EMPTY_PLIST))
+
+    def append_plist(self, pl):
+        return self._append(pl, lambda l: l)
+
+    def build(self):
+        return self._head
+
+
+class _PListBase(object):
+    __slots__ = ('__weakref__',)
+
+    # Selected implementations can be taken straight from the Sequence
+    # class, other are less suitable. Especially those that work with
+    # index lookups.
+    count = Sequence.count
+    index = Sequence.index
+
+    def __reduce__(self):
+        # Pickling support
+        return plist, (list(self),)
+
+    def __len__(self):
+        """
+        Return the length of the list, computed by traversing it.
+
+        This is obviously O(n) but with the current implementation
+        where a list is also a node the overhead of storing the length
+        in every node would be quite significant.
+        """
+        return sum(1 for _ in self)
+
+    def __repr__(self):
+        return "plist({0})".format(list(self))
+    __str__ = __repr__
+
+    def cons(self, elem):
+        """
+        Return a new list with elem inserted as new head.
+
+        >>> plist([1, 2]).cons(3)
+        plist([3, 1, 2])
+        """
+        return PList(elem, self)
+
+    def mcons(self, iterable):
+        """
+        Return a new list with all elements of iterable repeatedly cons:ed to the current list.
+        NB! The elements will be inserted in the reverse order of the iterable.
+        Runs in O(len(iterable)).
+
+        >>> plist([1, 2]).mcons([3, 4])
+        plist([4, 3, 1, 2])
+        """
+        head = self
+        for elem in iterable:
+            head = head.cons(elem)
+
+        return head
+
+    def reverse(self):
+        """
+        Return a reversed version of list. Runs in O(n) where n is the length of the list.
+
+        >>> plist([1, 2, 3]).reverse()
+        plist([3, 2, 1])
+
+        Also supports the standard reversed function.
+
+        >>> reversed(plist([1, 2, 3]))
+        plist([3, 2, 1])
+        """
+        result = plist()
+        head = self
+        while head:
+            result = result.cons(head.first)
+            head = head.rest
+
+        return result
+    __reversed__ = reverse
+
+    def split(self, index):
+        """
+        Spilt the list at position specified by index. Returns a tuple containing the
+        list up until index and the list after the index. Runs in O(index).
+
+        >>> plist([1, 2, 3, 4]).split(2)
+        (plist([1, 2]), plist([3, 4]))
+        """
+        lb = _PListBuilder()
+        right_list = self
+        i = 0
+        while right_list and i < index:
+            lb.append_elem(right_list.first)
+            right_list = right_list.rest
+            i += 1
+
+        if not right_list:
+            # Just a small optimization in the cases where no split occurred
+            return self, _EMPTY_PLIST
+
+        return lb.build(), right_list
+
+    def __iter__(self):
+        li = self
+        while li:
+            yield li.first
+            li = li.rest
+
+    def __lt__(self, other):
+        if not isinstance(other, _PListBase):
+            return NotImplemented
+
+        return tuple(self) < tuple(other)
+
+    def __eq__(self, other):
+        """
+        Traverses the lists, checking equality of elements.
+
+        This is an O(n) operation, but preserves the standard semantics of list equality.
+        """
+        if not isinstance(other, _PListBase):
+            return NotImplemented
+
+        self_head = self
+        other_head = other
+        while self_head and other_head:
+            if not self_head.first == other_head.first:
+                return False
+            self_head = self_head.rest
+            other_head = other_head.rest
+
+        return not self_head and not other_head
+
+    def __getitem__(self, index):
+        # Don't use this this data structure if you plan to do a lot of indexing, it is
+        # very inefficient! Use a PVector instead!
+
+        if isinstance(index, slice):
+            if index.start is not None and index.stop is None and (index.step is None or index.step == 1):
+                return self._drop(index.start)
+
+            # Take the easy way out for all other slicing cases, not much structural reuse possible anyway
+            return plist(tuple(self)[index])
+
+        if not isinstance(index, Integral):
+            raise TypeError("'%s' object cannot be interpreted as an index" % type(index).__name__)
+
+        if index < 0:
+            # NB: O(n)!
+            index += len(self)
+
+        try:
+            return self._drop(index).first
+        except AttributeError as e:
+            raise IndexError("PList index out of range") from e
+
+    def _drop(self, count):
+        if count < 0:
+            raise IndexError("PList index out of range")
+
+        head = self
+        while count > 0:
+            head = head.rest
+            count -= 1
+
+        return head
+
+    def __hash__(self):
+        return hash(tuple(self))
+
+    def remove(self, elem):
+        """
+        Return new list with first element equal to elem removed. O(k) where k is the position
+        of the element that is removed.
+
+        Raises ValueError if no matching element is found.
+
+        >>> plist([1, 2, 1]).remove(1)
+        plist([2, 1])
+        """
+
+        builder = _PListBuilder()
+        head = self
+        while head:
+            if head.first == elem:
+                return builder.append_plist(head.rest)
+
+            builder.append_elem(head.first)
+            head = head.rest
+
+        raise ValueError('{0} not found in PList'.format(elem))
+
+
+class PList(_PListBase):
+    """
+    Classical Lisp style singly linked list. Adding elements to the head using cons is O(1).
+    Element access is O(k) where k is the position of the element in the list. Taking the
+    length of the list is O(n).
+
+    Fully supports the Sequence and Hashable protocols including indexing and slicing but
+    if you need fast random access go for the PVector instead.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`l` or :py:func:`plist` to
+    create an instance.
+
+    Some examples:
+
+    >>> x = plist([1, 2])
+    >>> y = x.cons(3)
+    >>> x
+    plist([1, 2])
+    >>> y
+    plist([3, 1, 2])
+    >>> y.first
+    3
+    >>> y.rest == x
+    True
+    >>> y[:2]
+    plist([3, 1])
+    """
+    __slots__ = ('first', 'rest')
+
+    def __new__(cls, first, rest):
+        instance = super(PList, cls).__new__(cls)
+        instance.first = first
+        instance.rest = rest
+        return instance
+
+    def __bool__(self):
+        return True
+    __nonzero__ = __bool__
+
+
+Sequence.register(PList)
+Hashable.register(PList)
+
+
+class _EmptyPList(_PListBase):
+    __slots__ = ()
+
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+
+    @property
+    def first(self):
+        raise AttributeError("Empty PList has no first")
+
+    @property
+    def rest(self):
+        return self
+
+
+Sequence.register(_EmptyPList)
+Hashable.register(_EmptyPList)
+
+_EMPTY_PLIST = _EmptyPList()
+
+
+def plist(iterable=(), reverse=False):
+    """
+    Creates a new persistent list containing all elements of iterable.
+    Optional parameter reverse specifies if the elements should be inserted in
+    reverse order or not.
+
+    >>> plist([1, 2, 3])
+    plist([1, 2, 3])
+    >>> plist([1, 2, 3], reverse=True)
+    plist([3, 2, 1])
+    """
+    if not reverse:
+        iterable = list(iterable)
+        iterable.reverse()
+
+    return reduce(lambda pl, elem: pl.cons(elem), iterable, _EMPTY_PLIST)
+
+
+def l(*elements):
+    """
+    Creates a new persistent list containing all arguments.
+
+    >>> l(1, 2, 3)
+    plist([1, 2, 3])
+    """
+    return plist(elements)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pmap.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pmap.py
new file mode 100644
index 0000000000000000000000000000000000000000..7ccec1aa25f818ab92ca2588ae480d38243209d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pmap.py
@@ -0,0 +1,459 @@
+from collections.abc import Mapping, Hashable
+from itertools import chain
+from pyrsistent._pvector import pvector
+from pyrsistent._transformations import transform
+
+
+class PMap(object):
+    """
+    Persistent map/dict. Tries to follow the same naming conventions as the built in dict where feasible.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`m` or :py:func:`pmap` to
+    create an instance.
+
+    Was originally written as a very close copy of the Clojure equivalent but was later rewritten to closer
+    re-assemble the python dict. This means that a sparse vector (a PVector) of buckets is used. The keys are
+    hashed and the elements inserted at position hash % len(bucket_vector). Whenever the map size exceeds 2/3 of
+    the containing vectors size the map is reallocated to a vector of double the size. This is done to avoid
+    excessive hash collisions.
+
+    This structure corresponds most closely to the built in dict type and is intended as a replacement. Where the
+    semantics are the same (more or less) the same function names have been used but for some cases it is not possible,
+    for example assignments and deletion of values.
+
+    PMap implements the Mapping protocol and is Hashable. It also supports dot-notation for
+    element access.
+
+    Random access and insert is log32(n) where n is the size of the map.
+
+    The following are examples of some common operations on persistent maps
+
+    >>> m1 = m(a=1, b=3)
+    >>> m2 = m1.set('c', 3)
+    >>> m3 = m2.remove('a')
+    >>> m1
+    pmap({'b': 3, 'a': 1})
+    >>> m2
+    pmap({'c': 3, 'b': 3, 'a': 1})
+    >>> m3
+    pmap({'c': 3, 'b': 3})
+    >>> m3['c']
+    3
+    >>> m3.c
+    3
+    """
+    __slots__ = ('_size', '_buckets', '__weakref__', '_cached_hash')
+
+    def __new__(cls, size, buckets):
+        self = super(PMap, cls).__new__(cls)
+        self._size = size
+        self._buckets = buckets
+        return self
+
+    @staticmethod
+    def _get_bucket(buckets, key):
+        index = hash(key) % len(buckets)
+        bucket = buckets[index]
+        return index, bucket
+
+    @staticmethod
+    def _getitem(buckets, key):
+        _, bucket = PMap._get_bucket(buckets, key)
+        if bucket:
+            for k, v in bucket:
+                if k == key:
+                    return v
+
+        raise KeyError(key)
+
+    def __getitem__(self, key):
+        return PMap._getitem(self._buckets, key)
+
+    @staticmethod
+    def _contains(buckets, key):
+        _, bucket = PMap._get_bucket(buckets, key)
+        if bucket:
+            for k, _ in bucket:
+                if k == key:
+                    return True
+
+            return False
+
+        return False
+
+    def __contains__(self, key):
+        return self._contains(self._buckets, key)
+
+    get = Mapping.get
+
+    def __iter__(self):
+        return self.iterkeys()
+
+    def __getattr__(self, key):
+        try:
+            return self[key]
+        except KeyError as e:
+            raise AttributeError(
+                "{0} has no attribute '{1}'".format(type(self).__name__, key)
+            ) from e
+
+    def iterkeys(self):
+        for k, _ in self.iteritems():
+            yield k
+
+    # These are more efficient implementations compared to the original
+    # methods that are based on the keys iterator and then calls the
+    # accessor functions to access the value for the corresponding key
+    def itervalues(self):
+        for _, v in self.iteritems():
+            yield v
+
+    def iteritems(self):
+        for bucket in self._buckets:
+            if bucket:
+                for k, v in bucket:
+                    yield k, v
+
+    def values(self):
+        return pvector(self.itervalues())
+
+    def keys(self):
+        return pvector(self.iterkeys())
+
+    def items(self):
+        return pvector(self.iteritems())
+
+    def __len__(self):
+        return self._size
+
+    def __repr__(self):
+        return 'pmap({0})'.format(str(dict(self)))
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if not isinstance(other, Mapping):
+            return NotImplemented
+        if len(self) != len(other):
+            return False
+        if isinstance(other, PMap):
+            if (hasattr(self, '_cached_hash') and hasattr(other, '_cached_hash')
+                    and self._cached_hash != other._cached_hash):
+                return False
+            if self._buckets == other._buckets:
+                return True
+            return dict(self.iteritems()) == dict(other.iteritems())
+        elif isinstance(other, dict):
+            return dict(self.iteritems()) == other
+        return dict(self.iteritems()) == dict(other.items())
+
+    __ne__ = Mapping.__ne__
+
+    def __lt__(self, other):
+        raise TypeError('PMaps are not orderable')
+
+    __le__ = __lt__
+    __gt__ = __lt__
+    __ge__ = __lt__
+
+    def __str__(self):
+        return self.__repr__()
+
+    def __hash__(self):
+        if not hasattr(self, '_cached_hash'):
+            self._cached_hash = hash(frozenset(self.iteritems()))
+        return self._cached_hash
+
+    def set(self, key, val):
+        """
+        Return a new PMap with key and val inserted.
+
+        >>> m1 = m(a=1, b=2)
+        >>> m2 = m1.set('a', 3)
+        >>> m3 = m1.set('c' ,4)
+        >>> m1
+        pmap({'b': 2, 'a': 1})
+        >>> m2
+        pmap({'b': 2, 'a': 3})
+        >>> m3
+        pmap({'c': 4, 'b': 2, 'a': 1})
+        """
+        return self.evolver().set(key, val).persistent()
+
+    def remove(self, key):
+        """
+        Return a new PMap without the element specified by key. Raises KeyError if the element
+        is not present.
+
+        >>> m1 = m(a=1, b=2)
+        >>> m1.remove('a')
+        pmap({'b': 2})
+        """
+        return self.evolver().remove(key).persistent()
+
+    def discard(self, key):
+        """
+        Return a new PMap without the element specified by key. Returns reference to itself
+        if element is not present.
+
+        >>> m1 = m(a=1, b=2)
+        >>> m1.discard('a')
+        pmap({'b': 2})
+        >>> m1 is m1.discard('c')
+        True
+        """
+        try:
+            return self.remove(key)
+        except KeyError:
+            return self
+
+    def update(self, *maps):
+        """
+        Return a new PMap with the items in Mappings inserted. If the same key is present in multiple
+        maps the rightmost (last) value is inserted.
+
+        >>> m1 = m(a=1, b=2)
+        >>> m1.update(m(a=2, c=3), {'a': 17, 'd': 35})
+        pmap({'c': 3, 'b': 2, 'a': 17, 'd': 35})
+        """
+        return self.update_with(lambda l, r: r, *maps)
+
+    def update_with(self, update_fn, *maps):
+        """
+        Return a new PMap with the items in Mappings maps inserted. If the same key is present in multiple
+        maps the values will be merged using merge_fn going from left to right.
+
+        >>> from operator import add
+        >>> m1 = m(a=1, b=2)
+        >>> m1.update_with(add, m(a=2))
+        pmap({'b': 2, 'a': 3})
+
+        The reverse behaviour of the regular merge. Keep the leftmost element instead of the rightmost.
+
+        >>> m1 = m(a=1)
+        >>> m1.update_with(lambda l, r: l, m(a=2), {'a':3})
+        pmap({'a': 1})
+        """
+        evolver = self.evolver()
+        for map in maps:
+            for key, value in map.items():
+                evolver.set(key, update_fn(evolver[key], value) if key in evolver else value)
+
+        return evolver.persistent()
+
+    def __add__(self, other):
+        return self.update(other)
+
+    def __reduce__(self):
+        # Pickling support
+        return pmap, (dict(self),)
+
+    def transform(self, *transformations):
+        """
+        Transform arbitrarily complex combinations of PVectors and PMaps. A transformation
+        consists of two parts. One match expression that specifies which elements to transform
+        and one transformation function that performs the actual transformation.
+
+        >>> from pyrsistent import freeze, ny
+        >>> news_paper = freeze({'articles': [{'author': 'Sara', 'content': 'A short article'},
+        ...                                   {'author': 'Steve', 'content': 'A slightly longer article'}],
+        ...                      'weather': {'temperature': '11C', 'wind': '5m/s'}})
+        >>> short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:25] + '...' if len(c) > 25 else c)
+        >>> very_short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:15] + '...' if len(c) > 15 else c)
+        >>> very_short_news.articles[0].content
+        'A short article'
+        >>> very_short_news.articles[1].content
+        'A slightly long...'
+
+        When nothing has been transformed the original data structure is kept
+
+        >>> short_news is news_paper
+        True
+        >>> very_short_news is news_paper
+        False
+        >>> very_short_news.articles[0] is news_paper.articles[0]
+        True
+        """
+        return transform(self, transformations)
+
+    def copy(self):
+        return self
+
+    class _Evolver(object):
+        __slots__ = ('_buckets_evolver', '_size', '_original_pmap')
+
+        def __init__(self, original_pmap):
+            self._original_pmap = original_pmap
+            self._buckets_evolver = original_pmap._buckets.evolver()
+            self._size = original_pmap._size
+
+        def __getitem__(self, key):
+            return PMap._getitem(self._buckets_evolver, key)
+
+        def __setitem__(self, key, val):
+            self.set(key, val)
+
+        def set(self, key, val):
+            if len(self._buckets_evolver) < 0.67 * self._size:
+                self._reallocate(2 * len(self._buckets_evolver))
+
+            kv = (key, val)
+            index, bucket = PMap._get_bucket(self._buckets_evolver, key)
+            if bucket:
+                for k, v in bucket:
+                    if k == key:
+                        if v is not val:
+                            new_bucket = [(k2, v2) if k2 != k else (k2, val) for k2, v2 in bucket]
+                            self._buckets_evolver[index] = new_bucket
+
+                        return self
+
+                new_bucket = [kv]
+                new_bucket.extend(bucket)
+                self._buckets_evolver[index] = new_bucket
+                self._size += 1
+            else:
+                self._buckets_evolver[index] = [kv]
+                self._size += 1
+
+            return self
+
+        def _reallocate(self, new_size):
+            new_list = new_size * [None]
+            buckets = self._buckets_evolver.persistent()
+            for k, v in chain.from_iterable(x for x in buckets if x):
+                index = hash(k) % new_size
+                if new_list[index]:
+                    new_list[index].append((k, v))
+                else:
+                    new_list[index] = [(k, v)]
+
+            # A reallocation should always result in a dirty buckets evolver to avoid
+            # possible loss of elements when doing the reallocation.
+            self._buckets_evolver = pvector().evolver()
+            self._buckets_evolver.extend(new_list)
+
+        def is_dirty(self):
+            return self._buckets_evolver.is_dirty()
+
+        def persistent(self):
+            if self.is_dirty():
+                self._original_pmap = PMap(self._size, self._buckets_evolver.persistent())
+
+            return self._original_pmap
+
+        def __len__(self):
+            return self._size
+
+        def __contains__(self, key):
+            return PMap._contains(self._buckets_evolver, key)
+
+        def __delitem__(self, key):
+            self.remove(key)
+
+        def remove(self, key):
+            index, bucket = PMap._get_bucket(self._buckets_evolver, key)
+
+            if bucket:
+                new_bucket = [(k, v) for (k, v) in bucket if k != key]
+                if len(bucket) > len(new_bucket):
+                    self._buckets_evolver[index] = new_bucket if new_bucket else None
+                    self._size -= 1
+                    return self
+
+            raise KeyError('{0}'.format(key))
+
+    def evolver(self):
+        """
+        Create a new evolver for this pmap. For a discussion on evolvers in general see the
+        documentation for the pvector evolver.
+
+        Create the evolver and perform various mutating updates to it:
+
+        >>> m1 = m(a=1, b=2)
+        >>> e = m1.evolver()
+        >>> e['c'] = 3
+        >>> len(e)
+        3
+        >>> del e['a']
+
+        The underlying pmap remains the same:
+
+        >>> m1
+        pmap({'b': 2, 'a': 1})
+
+        The changes are kept in the evolver. An updated pmap can be created using the
+        persistent() function on the evolver.
+
+        >>> m2 = e.persistent()
+        >>> m2
+        pmap({'c': 3, 'b': 2})
+
+        The new pmap will share data with the original pmap in the same way that would have
+        been done if only using operations on the pmap.
+        """
+        return self._Evolver(self)
+
+Mapping.register(PMap)
+Hashable.register(PMap)
+
+
+def _turbo_mapping(initial, pre_size):
+    if pre_size:
+        size = pre_size
+    else:
+        try:
+            size = 2 * len(initial) or 8
+        except Exception:
+            # Guess we can't figure out the length. Give up on length hinting,
+            # we can always reallocate later.
+            size = 8
+
+    buckets = size * [None]
+
+    if not isinstance(initial, Mapping):
+        # Make a dictionary of the initial data if it isn't already,
+        # that will save us some job further down since we can assume no
+        # key collisions
+        initial = dict(initial)
+
+    for k, v in initial.items():
+        h = hash(k)
+        index = h % size
+        bucket = buckets[index]
+
+        if bucket:
+            bucket.append((k, v))
+        else:
+            buckets[index] = [(k, v)]
+
+    return PMap(len(initial), pvector().extend(buckets))
+
+
+_EMPTY_PMAP = _turbo_mapping({}, 0)
+
+
+def pmap(initial={}, pre_size=0):
+    """
+    Create new persistent map, inserts all elements in initial into the newly created map.
+    The optional argument pre_size may be used to specify an initial size of the underlying bucket vector. This
+    may have a positive performance impact in the cases where you know beforehand that a large number of elements
+    will be inserted into the map eventually since it will reduce the number of reallocations required.
+
+    >>> pmap({'a': 13, 'b': 14})
+    pmap({'b': 14, 'a': 13})
+    """
+    if not initial:
+        return _EMPTY_PMAP
+
+    return _turbo_mapping(initial, pre_size)
+
+
+def m(**kwargs):
+    """
+    Creates a new persitent map. Inserts all key value arguments into the newly created map.
+
+    >>> m(a=13, b=14)
+    pmap({'b': 14, 'a': 13})
+    """
+    return pmap(kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_precord.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_precord.py
new file mode 100644
index 0000000000000000000000000000000000000000..10d47475113cb4cf1b186c4146cc064cde7afdac
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_precord.py
@@ -0,0 +1,167 @@
+from pyrsistent._checked_types import CheckedType, _restore_pickle, InvariantException, store_invariants
+from pyrsistent._field_common import (
+    set_fields, check_type, is_field_ignore_extra_complaint, PFIELD_NO_INITIAL, serialize, check_global_invariants
+)
+from pyrsistent._pmap import PMap, pmap
+
+
+class _PRecordMeta(type):
+    def __new__(mcs, name, bases, dct):
+        set_fields(dct, bases, name='_precord_fields')
+        store_invariants(dct, bases, '_precord_invariants', '__invariant__')
+
+        dct['_precord_mandatory_fields'] = \
+            set(name for name, field in dct['_precord_fields'].items() if field.mandatory)
+
+        dct['_precord_initial_values'] = \
+            dict((k, field.initial) for k, field in dct['_precord_fields'].items() if field.initial is not PFIELD_NO_INITIAL)
+
+
+        dct['__slots__'] = ()
+
+        return super(_PRecordMeta, mcs).__new__(mcs, name, bases, dct)
+
+
+class PRecord(PMap, CheckedType, metaclass=_PRecordMeta):
+    """
+    A PRecord is a PMap with a fixed set of specified fields. Records are declared as python classes inheriting
+    from PRecord. Because it is a PMap it has full support for all Mapping methods such as iteration and element
+    access using subscript notation.
+
+    More documentation and examples of PRecord usage is available at https://github.com/tobgu/pyrsistent
+    """
+    def __new__(cls, **kwargs):
+        # Hack total! If these two special attributes exist that means we can create
+        # ourselves. Otherwise we need to go through the Evolver to create the structures
+        # for us.
+        if '_precord_size' in kwargs and '_precord_buckets' in kwargs:
+            return super(PRecord, cls).__new__(cls, kwargs['_precord_size'], kwargs['_precord_buckets'])
+
+        factory_fields = kwargs.pop('_factory_fields', None)
+        ignore_extra = kwargs.pop('_ignore_extra', False)
+
+        initial_values = kwargs
+        if cls._precord_initial_values:
+            initial_values = dict((k, v() if callable(v) else v)
+                                  for k, v in cls._precord_initial_values.items())
+            initial_values.update(kwargs)
+
+        e = _PRecordEvolver(cls, pmap(), _factory_fields=factory_fields, _ignore_extra=ignore_extra)
+        for k, v in initial_values.items():
+            e[k] = v
+
+        return e.persistent()
+
+    def set(self, *args, **kwargs):
+        """
+        Set a field in the record. This set function differs slightly from that in the PMap
+        class. First of all it accepts key-value pairs. Second it accepts multiple key-value
+        pairs to perform one, atomic, update of multiple fields.
+        """
+
+        # The PRecord set() can accept kwargs since all fields that have been declared are
+        # valid python identifiers. Also allow multiple fields to be set in one operation.
+        if args:
+            return super(PRecord, self).set(args[0], args[1])
+
+        return self.update(kwargs)
+
+    def evolver(self):
+        """
+        Returns an evolver of this object.
+        """
+        return _PRecordEvolver(self.__class__, self)
+
+    def __repr__(self):
+        return "{0}({1})".format(self.__class__.__name__,
+                                 ', '.join('{0}={1}'.format(k, repr(v)) for k, v in self.items()))
+
+    @classmethod
+    def create(cls, kwargs, _factory_fields=None, ignore_extra=False):
+        """
+        Factory method. Will create a new PRecord of the current type and assign the values
+        specified in kwargs.
+
+        :param ignore_extra: A boolean which when set to True will ignore any keys which appear in kwargs that are not
+                             in the set of fields on the PRecord.
+        """
+        if isinstance(kwargs, cls):
+            return kwargs
+
+        if ignore_extra:
+            kwargs = {k: kwargs[k] for k in cls._precord_fields if k in kwargs}
+
+        return cls(_factory_fields=_factory_fields, _ignore_extra=ignore_extra, **kwargs)
+
+    def __reduce__(self):
+        # Pickling support
+        return _restore_pickle, (self.__class__, dict(self),)
+
+    def serialize(self, format=None):
+        """
+        Serialize the current PRecord using custom serializer functions for fields where
+        such have been supplied.
+        """
+        return dict((k, serialize(self._precord_fields[k].serializer, format, v)) for k, v in self.items())
+
+
+class _PRecordEvolver(PMap._Evolver):
+    __slots__ = ('_destination_cls', '_invariant_error_codes', '_missing_fields', '_factory_fields', '_ignore_extra')
+
+    def __init__(self, cls, original_pmap, _factory_fields=None, _ignore_extra=False):
+        super(_PRecordEvolver, self).__init__(original_pmap)
+        self._destination_cls = cls
+        self._invariant_error_codes = []
+        self._missing_fields = []
+        self._factory_fields = _factory_fields
+        self._ignore_extra = _ignore_extra
+
+    def __setitem__(self, key, original_value):
+        self.set(key, original_value)
+
+    def set(self, key, original_value):
+        field = self._destination_cls._precord_fields.get(key)
+        if field:
+            if self._factory_fields is None or field in self._factory_fields:
+                try:
+                    if is_field_ignore_extra_complaint(PRecord, field, self._ignore_extra):
+                        value = field.factory(original_value, ignore_extra=self._ignore_extra)
+                    else:
+                        value = field.factory(original_value)
+                except InvariantException as e:
+                    self._invariant_error_codes += e.invariant_errors
+                    self._missing_fields += e.missing_fields
+                    return self
+            else:
+                value = original_value
+
+            check_type(self._destination_cls, field, key, value)
+
+            is_ok, error_code = field.invariant(value)
+            if not is_ok:
+                self._invariant_error_codes.append(error_code)
+
+            return super(_PRecordEvolver, self).set(key, value)
+        else:
+            raise AttributeError("'{0}' is not among the specified fields for {1}".format(key, self._destination_cls.__name__))
+
+    def persistent(self):
+        cls = self._destination_cls
+        is_dirty = self.is_dirty()
+        pm = super(_PRecordEvolver, self).persistent()
+        if is_dirty or not isinstance(pm, cls):
+            result = cls(_precord_buckets=pm._buckets, _precord_size=pm._size)
+        else:
+            result = pm
+
+        if cls._precord_mandatory_fields:
+            self._missing_fields += tuple('{0}.{1}'.format(cls.__name__, f) for f
+                                          in (cls._precord_mandatory_fields - set(result.keys())))
+
+        if self._invariant_error_codes or self._missing_fields:
+            raise InvariantException(tuple(self._invariant_error_codes), tuple(self._missing_fields),
+                                     'Field invariant failed')
+
+        check_global_invariants(result, cls._precord_invariants)
+
+        return result
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pset.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pset.py
new file mode 100644
index 0000000000000000000000000000000000000000..bcc7db2cfb98e1c10e496df0ad0e81f749d4c200
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pset.py
@@ -0,0 +1,227 @@
+from collections.abc import Set, Hashable
+import sys
+from pyrsistent._pmap import pmap
+
+
+class PSet(object):
+    """
+    Persistent set implementation. Built on top of the persistent map. The set supports all operations
+    in the Set protocol and is Hashable.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`s` or :py:func:`pset`
+    to create an instance.
+
+    Random access and insert is log32(n) where n is the size of the set.
+
+    Some examples:
+
+    >>> s = pset([1, 2, 3, 1])
+    >>> s2 = s.add(4)
+    >>> s3 = s2.remove(2)
+    >>> s
+    pset([1, 2, 3])
+    >>> s2
+    pset([1, 2, 3, 4])
+    >>> s3
+    pset([1, 3, 4])
+    """
+    __slots__ = ('_map', '__weakref__')
+
+    def __new__(cls, m):
+        self = super(PSet, cls).__new__(cls)
+        self._map = m
+        return self
+
+    def __contains__(self, element):
+        return element in self._map
+
+    def __iter__(self):
+        return iter(self._map)
+
+    def __len__(self):
+        return len(self._map)
+
+    def __repr__(self):
+        if not self:
+            return 'p' + str(set(self))
+
+        return 'pset([{0}])'.format(str(set(self))[1:-1])
+
+    def __str__(self):
+        return self.__repr__()
+
+    def __hash__(self):
+        return hash(self._map)
+
+    def __reduce__(self):
+        # Pickling support
+        return pset, (list(self),)
+
+    @classmethod
+    def _from_iterable(cls, it, pre_size=8):
+        return PSet(pmap(dict((k, True) for k in it), pre_size=pre_size))
+
+    def add(self, element):
+        """
+        Return a new PSet with element added
+
+        >>> s1 = s(1, 2)
+        >>> s1.add(3)
+        pset([1, 2, 3])
+        """
+        return self.evolver().add(element).persistent()
+
+    def update(self, iterable):
+        """
+        Return a new PSet with elements in iterable added
+
+        >>> s1 = s(1, 2)
+        >>> s1.update([3, 4, 4])
+        pset([1, 2, 3, 4])
+        """
+        e = self.evolver()
+        for element in iterable:
+            e.add(element)
+
+        return e.persistent()
+
+    def remove(self, element):
+        """
+        Return a new PSet with element removed. Raises KeyError if element is not present.
+
+        >>> s1 = s(1, 2)
+        >>> s1.remove(2)
+        pset([1])
+        """
+        if element in self._map:
+            return self.evolver().remove(element).persistent()
+
+        raise KeyError("Element '%s' not present in PSet" % element)
+
+    def discard(self, element):
+        """
+        Return a new PSet with element removed. Returns itself if element is not present.
+        """
+        if element in self._map:
+            return self.evolver().remove(element).persistent()
+
+        return self
+
+    class _Evolver(object):
+        __slots__ = ('_original_pset', '_pmap_evolver')
+
+        def __init__(self, original_pset):
+            self._original_pset = original_pset
+            self._pmap_evolver = original_pset._map.evolver()
+
+        def add(self, element):
+            self._pmap_evolver[element] = True
+            return self
+
+        def remove(self, element):
+            del self._pmap_evolver[element]
+            return self
+
+        def is_dirty(self):
+            return self._pmap_evolver.is_dirty()
+
+        def persistent(self):
+            if not self.is_dirty():
+                return  self._original_pset
+
+            return PSet(self._pmap_evolver.persistent())
+
+        def __len__(self):
+            return len(self._pmap_evolver)
+
+    def copy(self):
+        return self
+
+    def evolver(self):
+        """
+        Create a new evolver for this pset. For a discussion on evolvers in general see the
+        documentation for the pvector evolver.
+
+        Create the evolver and perform various mutating updates to it:
+
+        >>> s1 = s(1, 2, 3)
+        >>> e = s1.evolver()
+        >>> _ = e.add(4)
+        >>> len(e)
+        4
+        >>> _ = e.remove(1)
+
+        The underlying pset remains the same:
+
+        >>> s1
+        pset([1, 2, 3])
+
+        The changes are kept in the evolver. An updated pmap can be created using the
+        persistent() function on the evolver.
+
+        >>> s2 = e.persistent()
+        >>> s2
+        pset([2, 3, 4])
+
+        The new pset will share data with the original pset in the same way that would have
+        been done if only using operations on the pset.
+        """
+        return PSet._Evolver(self)
+
+    # All the operations and comparisons you would expect on a set.
+    #
+    # This is not very beautiful. If we avoid inheriting from PSet we can use the
+    # __slots__ concepts (which requires a new style class) and hopefully save some memory.
+    __le__ = Set.__le__
+    __lt__ = Set.__lt__
+    __gt__ = Set.__gt__
+    __ge__ = Set.__ge__
+    __eq__ = Set.__eq__
+    __ne__ = Set.__ne__
+
+    __and__ = Set.__and__
+    __or__ = Set.__or__
+    __sub__ = Set.__sub__
+    __xor__ = Set.__xor__
+
+    issubset = __le__
+    issuperset = __ge__
+    union = __or__
+    intersection = __and__
+    difference = __sub__
+    symmetric_difference = __xor__
+
+    isdisjoint = Set.isdisjoint
+
+Set.register(PSet)
+Hashable.register(PSet)
+
+_EMPTY_PSET = PSet(pmap())
+
+
+def pset(iterable=(), pre_size=8):
+    """
+    Creates a persistent set from iterable. Optionally takes a sizing parameter equivalent to that
+    used for :py:func:`pmap`.
+
+    >>> s1 = pset([1, 2, 3, 2])
+    >>> s1
+    pset([1, 2, 3])
+    """
+    if not iterable:
+        return _EMPTY_PSET
+
+    return PSet._from_iterable(iterable, pre_size=pre_size)
+
+
+def s(*elements):
+    """
+    Create a persistent set.
+
+    Takes an arbitrary number of arguments to insert into the new set.
+
+    >>> s1 = s(1, 2, 3, 2)
+    >>> s1
+    pset([1, 2, 3])
+    """
+    return pset(elements)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pvector.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pvector.py
new file mode 100644
index 0000000000000000000000000000000000000000..2aff0e8b42b76d94e940bb2a866f5fc3fdb07d7a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_pvector.py
@@ -0,0 +1,711 @@
+from abc import abstractmethod, ABCMeta
+from collections.abc import Sequence, Hashable
+from numbers import Integral
+import operator
+from pyrsistent._transformations import transform
+
+
+def _bitcount(val):
+    return bin(val).count("1")
+
+BRANCH_FACTOR = 32
+BIT_MASK = BRANCH_FACTOR - 1
+SHIFT = _bitcount(BIT_MASK)
+
+
+def compare_pvector(v, other, operator):
+    return operator(v.tolist(), other.tolist() if isinstance(other, PVector) else other)
+
+
+def _index_or_slice(index, stop):
+    if stop is None:
+        return index
+
+    return slice(index, stop)
+
+
+class PythonPVector(object):
+    """
+    Support structure for PVector that implements structural sharing for vectors using a trie.
+    """
+    __slots__ = ('_count', '_shift', '_root', '_tail', '_tail_offset', '__weakref__')
+
+    def __new__(cls, count, shift, root, tail):
+        self = super(PythonPVector, cls).__new__(cls)
+        self._count = count
+        self._shift = shift
+        self._root = root
+        self._tail = tail
+
+        # Derived attribute stored for performance
+        self._tail_offset = self._count - len(self._tail)
+        return self
+
+    def __len__(self):
+        return self._count
+
+    def __getitem__(self, index):
+        if isinstance(index, slice):
+            # There are more conditions than the below where it would be OK to
+            # return ourselves, implement those...
+            if index.start is None and index.stop is None and index.step is None:
+                return self
+
+            # This is a bit nasty realizing the whole structure as a list before
+            # slicing it but it is the fastest way I've found to date, and it's easy :-)
+            return _EMPTY_PVECTOR.extend(self.tolist()[index])
+
+        if index < 0:
+            index += self._count
+
+        return PythonPVector._node_for(self, index)[index & BIT_MASK]
+
+    def __add__(self, other):
+        return self.extend(other)
+
+    def __repr__(self):
+        return 'pvector({0})'.format(str(self.tolist()))
+
+    def __str__(self):
+        return self.__repr__()
+
+    def __iter__(self):
+        # This is kind of lazy and will produce some memory overhead but it is the fasted method
+        # by far of those tried since it uses the speed of the built in python list directly.
+        return iter(self.tolist())
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __eq__(self, other):
+        return self is other or (hasattr(other, '__len__') and self._count == len(other)) and compare_pvector(self, other, operator.eq)
+
+    def __gt__(self, other):
+        return compare_pvector(self, other, operator.gt)
+
+    def __lt__(self, other):
+        return compare_pvector(self, other, operator.lt)
+
+    def __ge__(self, other):
+        return compare_pvector(self, other, operator.ge)
+
+    def __le__(self, other):
+        return compare_pvector(self, other, operator.le)
+
+    def __mul__(self, times):
+        if times <= 0 or self is _EMPTY_PVECTOR:
+            return _EMPTY_PVECTOR
+
+        if times == 1:
+            return self
+
+        return _EMPTY_PVECTOR.extend(times * self.tolist())
+
+    __rmul__ = __mul__
+
+    def _fill_list(self, node, shift, the_list):
+        if shift:
+            shift -= SHIFT
+            for n in node:
+                self._fill_list(n, shift, the_list)
+        else:
+            the_list.extend(node)
+
+    def tolist(self):
+        """
+        The fastest way to convert the vector into a python list.
+        """
+        the_list = []
+        self._fill_list(self._root, self._shift, the_list)
+        the_list.extend(self._tail)
+        return the_list
+
+    def _totuple(self):
+        """
+        Returns the content as a python tuple.
+        """
+        return tuple(self.tolist())
+
+    def __hash__(self):
+        # Taking the easy way out again...
+        return hash(self._totuple())
+
+    def transform(self, *transformations):
+        return transform(self, transformations)
+
+    def __reduce__(self):
+        # Pickling support
+        return pvector, (self.tolist(),)
+
+    def mset(self, *args):
+        if len(args) % 2:
+            raise TypeError("mset expected an even number of arguments")
+
+        evolver = self.evolver()
+        for i in range(0, len(args), 2):
+            evolver[args[i]] = args[i+1]
+
+        return evolver.persistent()
+
+    class Evolver(object):
+        __slots__ = ('_count', '_shift', '_root', '_tail', '_tail_offset', '_dirty_nodes',
+                     '_extra_tail', '_cached_leafs', '_orig_pvector')
+
+        def __init__(self, v):
+            self._reset(v)
+
+        def __getitem__(self, index):
+            if not isinstance(index, Integral):
+                raise TypeError("'%s' object cannot be interpreted as an index" % type(index).__name__)
+
+            if index < 0:
+                index += self._count + len(self._extra_tail)
+
+            if self._count <= index < self._count + len(self._extra_tail):
+                return self._extra_tail[index - self._count]
+
+            return PythonPVector._node_for(self, index)[index & BIT_MASK]
+
+        def _reset(self, v):
+            self._count = v._count
+            self._shift = v._shift
+            self._root = v._root
+            self._tail = v._tail
+            self._tail_offset = v._tail_offset
+            self._dirty_nodes = {}
+            self._cached_leafs = {}
+            self._extra_tail = []
+            self._orig_pvector = v
+
+        def append(self, element):
+            self._extra_tail.append(element)
+            return self
+
+        def extend(self, iterable):
+            self._extra_tail.extend(iterable)
+            return self
+
+        def set(self, index, val):
+            self[index] = val
+            return self
+
+        def __setitem__(self, index, val):
+            if not isinstance(index, Integral):
+                raise TypeError("'%s' object cannot be interpreted as an index" % type(index).__name__)
+
+            if index < 0:
+                index += self._count + len(self._extra_tail)
+
+            if 0 <= index < self._count:
+                node = self._cached_leafs.get(index >> SHIFT)
+                if node:
+                    node[index & BIT_MASK] = val
+                elif index >= self._tail_offset:
+                    if id(self._tail) not in self._dirty_nodes:
+                        self._tail = list(self._tail)
+                        self._dirty_nodes[id(self._tail)] = True
+                        self._cached_leafs[index >> SHIFT] = self._tail
+                    self._tail[index & BIT_MASK] = val
+                else:
+                    self._root = self._do_set(self._shift, self._root, index, val)
+            elif self._count <= index < self._count + len(self._extra_tail):
+                self._extra_tail[index - self._count] = val
+            elif index == self._count + len(self._extra_tail):
+                self._extra_tail.append(val)
+            else:
+                raise IndexError("Index out of range: %s" % (index,))
+
+        def _do_set(self, level, node, i, val):
+            if id(node) in self._dirty_nodes:
+                ret = node
+            else:
+                ret = list(node)
+                self._dirty_nodes[id(ret)] = True
+
+            if level == 0:
+                ret[i & BIT_MASK] = val
+                self._cached_leafs[i >> SHIFT] = ret
+            else:
+                sub_index = (i >> level) & BIT_MASK  # >>>
+                ret[sub_index] = self._do_set(level - SHIFT, node[sub_index], i, val)
+
+            return ret
+
+        def delete(self, index):
+            del self[index]
+            return self
+
+        def __delitem__(self, key):
+            if self._orig_pvector:
+                # All structural sharing bets are off, base evolver on _extra_tail only
+                l = PythonPVector(self._count, self._shift, self._root, self._tail).tolist()
+                l.extend(self._extra_tail)
+                self._reset(_EMPTY_PVECTOR)
+                self._extra_tail = l
+
+            del self._extra_tail[key]
+
+        def persistent(self):
+            result = self._orig_pvector
+            if self.is_dirty():
+                result = PythonPVector(self._count, self._shift, self._root, self._tail).extend(self._extra_tail)
+                self._reset(result)
+
+            return result
+
+        def __len__(self):
+            return self._count + len(self._extra_tail)
+
+        def is_dirty(self):
+            return bool(self._dirty_nodes or self._extra_tail)
+
+    def evolver(self):
+        return PythonPVector.Evolver(self)
+
+    def set(self, i, val):
+        # This method could be implemented by a call to mset() but doing so would cause
+        # a ~5 X performance penalty on PyPy (considered the primary platform for this implementation
+        #  of PVector) so we're keeping this implementation for now.
+
+        if not isinstance(i, Integral):
+            raise TypeError("'%s' object cannot be interpreted as an index" % type(i).__name__)
+
+        if i < 0:
+            i += self._count
+
+        if 0 <= i < self._count:
+            if i >= self._tail_offset:
+                new_tail = list(self._tail)
+                new_tail[i & BIT_MASK] = val
+                return PythonPVector(self._count, self._shift, self._root, new_tail)
+
+            return PythonPVector(self._count, self._shift, self._do_set(self._shift, self._root, i, val), self._tail)
+
+        if i == self._count:
+            return self.append(val)
+
+        raise IndexError("Index out of range: %s" % (i,))
+
+    def _do_set(self, level, node, i, val):
+        ret = list(node)
+        if level == 0:
+            ret[i & BIT_MASK] = val
+        else:
+            sub_index = (i >> level) & BIT_MASK  # >>>
+            ret[sub_index] = self._do_set(level - SHIFT, node[sub_index], i, val)
+
+        return ret
+
+    @staticmethod
+    def _node_for(pvector_like, i):
+        if 0 <= i < pvector_like._count:
+            if i >= pvector_like._tail_offset:
+                return pvector_like._tail
+
+            node = pvector_like._root
+            for level in range(pvector_like._shift, 0, -SHIFT):
+                node = node[(i >> level) & BIT_MASK]  # >>>
+
+            return node
+
+        raise IndexError("Index out of range: %s" % (i,))
+
+    def _create_new_root(self):
+        new_shift = self._shift
+
+        # Overflow root?
+        if (self._count >> SHIFT) > (1 << self._shift): # >>>
+            new_root = [self._root, self._new_path(self._shift, self._tail)]
+            new_shift += SHIFT
+        else:
+            new_root = self._push_tail(self._shift, self._root, self._tail)
+
+        return new_root, new_shift
+
+    def append(self, val):
+        if len(self._tail) < BRANCH_FACTOR:
+            new_tail = list(self._tail)
+            new_tail.append(val)
+            return PythonPVector(self._count + 1, self._shift, self._root, new_tail)
+
+        # Full tail, push into tree
+        new_root, new_shift = self._create_new_root()
+        return PythonPVector(self._count + 1, new_shift, new_root, [val])
+
+    def _new_path(self, level, node):
+        if level == 0:
+            return node
+
+        return [self._new_path(level - SHIFT, node)]
+
+    def _mutating_insert_tail(self):
+        self._root, self._shift = self._create_new_root()
+        self._tail = []
+
+    def _mutating_fill_tail(self, offset, sequence):
+        max_delta_len = BRANCH_FACTOR - len(self._tail)
+        delta = sequence[offset:offset + max_delta_len]
+        self._tail.extend(delta)
+        delta_len = len(delta)
+        self._count += delta_len
+        return offset + delta_len
+
+    def _mutating_extend(self, sequence):
+        offset = 0
+        sequence_len = len(sequence)
+        while offset < sequence_len:
+            offset = self._mutating_fill_tail(offset, sequence)
+            if len(self._tail) == BRANCH_FACTOR:
+                self._mutating_insert_tail()
+
+        self._tail_offset = self._count - len(self._tail)
+
+    def extend(self, obj):
+        # Mutates the new vector directly for efficiency but that's only an
+        # implementation detail, once it is returned it should be considered immutable
+        l = obj.tolist() if isinstance(obj, PythonPVector) else list(obj)
+        if l:
+            new_vector = self.append(l[0])
+            new_vector._mutating_extend(l[1:])
+            return new_vector
+
+        return self
+
+    def _push_tail(self, level, parent, tail_node):
+        """
+        if parent is leaf, insert node,
+        else does it map to an existing child? ->
+             node_to_insert = push node one more level
+        else alloc new path
+
+        return  node_to_insert placed in copy of parent
+        """
+        ret = list(parent)
+
+        if level == SHIFT:
+            ret.append(tail_node)
+            return ret
+
+        sub_index = ((self._count - 1) >> level) & BIT_MASK  # >>>
+        if len(parent) > sub_index:
+            ret[sub_index] = self._push_tail(level - SHIFT, parent[sub_index], tail_node)
+            return ret
+
+        ret.append(self._new_path(level - SHIFT, tail_node))
+        return ret
+
+    def index(self, value, *args, **kwargs):
+        return self.tolist().index(value, *args, **kwargs)
+
+    def count(self, value):
+        return self.tolist().count(value)
+
+    def delete(self, index, stop=None):
+        l = self.tolist()
+        del l[_index_or_slice(index, stop)]
+        return _EMPTY_PVECTOR.extend(l)
+
+    def remove(self, value):
+        l = self.tolist()
+        l.remove(value)
+        return _EMPTY_PVECTOR.extend(l)
+
+class PVector(metaclass=ABCMeta):
+    """
+    Persistent vector implementation. Meant as a replacement for the cases where you would normally
+    use a Python list.
+
+    Do not instantiate directly, instead use the factory functions :py:func:`v` and :py:func:`pvector` to
+    create an instance.
+
+    Heavily influenced by the persistent vector available in Clojure. Initially this was more or
+    less just a port of the Java code for the Clojure vector. It has since been modified and to
+    some extent optimized for usage in Python.
+
+    The vector is organized as a trie, any mutating method will return a new vector that contains the changes. No
+    updates are done to the original vector. Structural sharing between vectors are applied where possible to save
+    space and to avoid making complete copies.
+
+    This structure corresponds most closely to the built in list type and is intended as a replacement. Where the
+    semantics are the same (more or less) the same function names have been used but for some cases it is not possible,
+    for example assignments.
+
+    The PVector implements the Sequence protocol and is Hashable.
+
+    Inserts are amortized O(1). Random access is log32(n) where n is the size of the vector.
+
+    The following are examples of some common operations on persistent vectors:
+
+    >>> p = v(1, 2, 3)
+    >>> p2 = p.append(4)
+    >>> p3 = p2.extend([5, 6, 7])
+    >>> p
+    pvector([1, 2, 3])
+    >>> p2
+    pvector([1, 2, 3, 4])
+    >>> p3
+    pvector([1, 2, 3, 4, 5, 6, 7])
+    >>> p3[5]
+    6
+    >>> p.set(1, 99)
+    pvector([1, 99, 3])
+    >>>
+    """
+
+    @abstractmethod
+    def __len__(self):
+        """
+        >>> len(v(1, 2, 3))
+        3
+        """
+
+    @abstractmethod
+    def __getitem__(self, index):
+        """
+        Get value at index. Full slicing support.
+
+        >>> v1 = v(5, 6, 7, 8)
+        >>> v1[2]
+        7
+        >>> v1[1:3]
+        pvector([6, 7])
+        """
+
+    @abstractmethod
+    def __add__(self, other):
+        """
+        >>> v1 = v(1, 2)
+        >>> v2 = v(3, 4)
+        >>> v1 + v2
+        pvector([1, 2, 3, 4])
+        """
+
+    @abstractmethod
+    def __mul__(self, times):
+        """
+        >>> v1 = v(1, 2)
+        >>> 3 * v1
+        pvector([1, 2, 1, 2, 1, 2])
+        """
+
+    @abstractmethod
+    def __hash__(self):
+        """
+        >>> v1 = v(1, 2, 3)
+        >>> v2 = v(1, 2, 3)
+        >>> hash(v1) == hash(v2)
+        True
+        """
+
+    @abstractmethod
+    def evolver(self):
+        """
+        Create a new evolver for this pvector. The evolver acts as a mutable view of the vector
+        with "transaction like" semantics. No part of the underlying vector i updated, it is still
+        fully immutable. Furthermore multiple evolvers created from the same pvector do not
+        interfere with each other.
+
+        You may want to use an evolver instead of working directly with the pvector in the
+        following cases:
+
+        * Multiple updates are done to the same vector and the intermediate results are of no
+          interest. In this case using an evolver may be a more efficient and easier to work with.
+        * You need to pass a vector into a legacy function or a function that you have no control
+          over which performs in place mutations of lists. In this case pass an evolver instance
+          instead and then create a new pvector from the evolver once the function returns.
+
+        The following example illustrates a typical workflow when working with evolvers. It also
+        displays most of the API (which i kept small by design, you should not be tempted to
+        use evolvers in excess ;-)).
+
+        Create the evolver and perform various mutating updates to it:
+
+        >>> v1 = v(1, 2, 3, 4, 5)
+        >>> e = v1.evolver()
+        >>> e[1] = 22
+        >>> _ = e.append(6)
+        >>> _ = e.extend([7, 8, 9])
+        >>> e[8] += 1
+        >>> len(e)
+        9
+
+        The underlying pvector remains the same:
+
+        >>> v1
+        pvector([1, 2, 3, 4, 5])
+
+        The changes are kept in the evolver. An updated pvector can be created using the
+        persistent() function on the evolver.
+
+        >>> v2 = e.persistent()
+        >>> v2
+        pvector([1, 22, 3, 4, 5, 6, 7, 8, 10])
+
+        The new pvector will share data with the original pvector in the same way that would have
+        been done if only using operations on the pvector.
+        """
+
+    @abstractmethod
+    def mset(self, *args):
+        """
+        Return a new vector with elements in specified positions replaced by values (multi set).
+
+        Elements on even positions in the argument list are interpreted as indexes while
+        elements on odd positions are considered values.
+
+        >>> v1 = v(1, 2, 3)
+        >>> v1.mset(0, 11, 2, 33)
+        pvector([11, 2, 33])
+        """
+
+    @abstractmethod
+    def set(self, i, val):
+        """
+        Return a new vector with element at position i replaced with val. The original vector remains unchanged.
+
+        Setting a value one step beyond the end of the vector is equal to appending. Setting beyond that will
+        result in an IndexError.
+
+        >>> v1 = v(1, 2, 3)
+        >>> v1.set(1, 4)
+        pvector([1, 4, 3])
+        >>> v1.set(3, 4)
+        pvector([1, 2, 3, 4])
+        >>> v1.set(-1, 4)
+        pvector([1, 2, 4])
+        """
+
+    @abstractmethod
+    def append(self, val):
+        """
+        Return a new vector with val appended.
+
+        >>> v1 = v(1, 2)
+        >>> v1.append(3)
+        pvector([1, 2, 3])
+        """
+
+    @abstractmethod
+    def extend(self, obj):
+        """
+        Return a new vector with all values in obj appended to it. Obj may be another
+        PVector or any other Iterable.
+
+        >>> v1 = v(1, 2, 3)
+        >>> v1.extend([4, 5])
+        pvector([1, 2, 3, 4, 5])
+        """
+
+    @abstractmethod
+    def index(self, value, *args, **kwargs):
+        """
+        Return first index of value. Additional indexes may be supplied to limit the search to a
+        sub range of the vector.
+
+        >>> v1 = v(1, 2, 3, 4, 3)
+        >>> v1.index(3)
+        2
+        >>> v1.index(3, 3, 5)
+        4
+        """
+
+    @abstractmethod
+    def count(self, value):
+        """
+        Return the number of times that value appears in the vector.
+
+        >>> v1 = v(1, 4, 3, 4)
+        >>> v1.count(4)
+        2
+        """
+
+    @abstractmethod
+    def transform(self, *transformations):
+        """
+        Transform arbitrarily complex combinations of PVectors and PMaps. A transformation
+        consists of two parts. One match expression that specifies which elements to transform
+        and one transformation function that performs the actual transformation.
+
+        >>> from pyrsistent import freeze, ny
+        >>> news_paper = freeze({'articles': [{'author': 'Sara', 'content': 'A short article'},
+        ...                                   {'author': 'Steve', 'content': 'A slightly longer article'}],
+        ...                      'weather': {'temperature': '11C', 'wind': '5m/s'}})
+        >>> short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:25] + '...' if len(c) > 25 else c)
+        >>> very_short_news = news_paper.transform(['articles', ny, 'content'], lambda c: c[:15] + '...' if len(c) > 15 else c)
+        >>> very_short_news.articles[0].content
+        'A short article'
+        >>> very_short_news.articles[1].content
+        'A slightly long...'
+
+        When nothing has been transformed the original data structure is kept
+
+        >>> short_news is news_paper
+        True
+        >>> very_short_news is news_paper
+        False
+        >>> very_short_news.articles[0] is news_paper.articles[0]
+        True
+        """
+
+    @abstractmethod
+    def delete(self, index, stop=None):
+        """
+        Delete a portion of the vector by index or range.
+
+        >>> v1 = v(1, 2, 3, 4, 5)
+        >>> v1.delete(1)
+        pvector([1, 3, 4, 5])
+        >>> v1.delete(1, 3)
+        pvector([1, 4, 5])
+        """
+
+    @abstractmethod
+    def remove(self, value):
+        """
+        Remove the first occurrence of a value from the vector.
+
+        >>> v1 = v(1, 2, 3, 2, 1)
+        >>> v2 = v1.remove(1)
+        >>> v2
+        pvector([2, 3, 2, 1])
+        >>> v2.remove(1)
+        pvector([2, 3, 2])
+        """
+
+
+_EMPTY_PVECTOR = PythonPVector(0, SHIFT, [], [])
+PVector.register(PythonPVector)
+Sequence.register(PVector)
+Hashable.register(PVector)
+
+def python_pvector(iterable=()):
+    """
+    Create a new persistent vector containing the elements in iterable.
+
+    >>> v1 = pvector([1, 2, 3])
+    >>> v1
+    pvector([1, 2, 3])
+    """
+    return _EMPTY_PVECTOR.extend(iterable)
+
+try:
+    # Use the C extension as underlying trie implementation if it is available
+    import os
+    if os.environ.get('PYRSISTENT_NO_C_EXTENSION'):
+        pvector = python_pvector
+    else:
+        from pvectorc import pvector
+        PVector.register(type(pvector()))
+except ImportError:
+    pvector = python_pvector
+
+
+def v(*elements):
+    """
+    Create a new persistent vector containing all parameters to this function.
+
+    >>> v1 = v(1, 2, 3)
+    >>> v1
+    pvector([1, 2, 3])
+    """
+    return pvector(elements)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_toolz.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_toolz.py
new file mode 100644
index 0000000000000000000000000000000000000000..a7faed1653591be9d01ffdf2f642c3a25f2d4829
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_toolz.py
@@ -0,0 +1,83 @@
+"""
+Functionality copied from the toolz package to avoid having
+to add toolz as a dependency.
+
+See https://github.com/pytoolz/toolz/.
+
+toolz is relased under BSD licence. Below is the licence text
+from toolz as it appeared when copying the code.
+
+--------------------------------------------------------------
+
+Copyright (c) 2013 Matthew Rocklin
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  a. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+  b. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimer in the
+     documentation and/or other materials provided with the distribution.
+  c. Neither the name of toolz nor the names of its contributors
+     may be used to endorse or promote products derived from this software
+     without specific prior written permission.
+
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGE.
+"""
+import operator
+from functools import reduce
+
+
+def get_in(keys, coll, default=None, no_default=False):
+    """
+    NB: This is a straight copy of the get_in implementation found in
+        the toolz library (https://github.com/pytoolz/toolz/). It works
+        with persistent data structures as well as the corresponding
+        datastructures from the stdlib.
+
+    Returns coll[i0][i1]...[iX] where [i0, i1, ..., iX]==keys.
+
+    If coll[i0][i1]...[iX] cannot be found, returns ``default``, unless
+    ``no_default`` is specified, then it raises KeyError or IndexError.
+
+    ``get_in`` is a generalization of ``operator.getitem`` for nested data
+    structures such as dictionaries and lists.
+    >>> from pyrsistent import freeze
+    >>> transaction = freeze({'name': 'Alice',
+    ...                       'purchase': {'items': ['Apple', 'Orange'],
+    ...                                    'costs': [0.50, 1.25]},
+    ...                       'credit card': '5555-1234-1234-1234'})
+    >>> get_in(['purchase', 'items', 0], transaction)
+    'Apple'
+    >>> get_in(['name'], transaction)
+    'Alice'
+    >>> get_in(['purchase', 'total'], transaction)
+    >>> get_in(['purchase', 'items', 'apple'], transaction)
+    >>> get_in(['purchase', 'items', 10], transaction)
+    >>> get_in(['purchase', 'total'], transaction, 0)
+    0
+    >>> get_in(['y'], {}, no_default=True)
+    Traceback (most recent call last):
+        ...
+    KeyError: 'y'
+    """
+    try:
+        return reduce(operator.getitem, keys, coll)
+    except (KeyError, IndexError, TypeError):
+        if no_default:
+            raise
+        return default
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_transformations.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_transformations.py
new file mode 100644
index 0000000000000000000000000000000000000000..7544843aca65a9cbbe33457a445a4592cc7e748a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/_transformations.py
@@ -0,0 +1,139 @@
+import re
+try:
+    from inspect import Parameter, signature
+except ImportError:
+    signature = None
+    from inspect import getfullargspec
+
+
+_EMPTY_SENTINEL = object()
+
+
+def inc(x):
+    """ Add one to the current value """
+    return x + 1
+
+
+def dec(x):
+    """ Subtract one from the current value """
+    return x - 1
+
+
+def discard(evolver, key):
+    """ Discard the element and returns a structure without the discarded elements """
+    try:
+        del evolver[key]
+    except KeyError:
+        pass
+
+
+# Matchers
+def rex(expr):
+    """ Regular expression matcher to use together with transform functions """
+    r = re.compile(expr)
+    return lambda key: isinstance(key, str) and r.match(key)
+
+
+def ny(_):
+    """ Matcher that matches any value """
+    return True
+
+
+# Support functions
+def _chunks(l, n):
+    for i in range(0, len(l), n):
+        yield l[i:i + n]
+
+
+def transform(structure, transformations):
+    r = structure
+    for path, command in _chunks(transformations, 2):
+        r = _do_to_path(r, path, command)
+    return r
+
+
+def _do_to_path(structure, path, command):
+    if not path:
+        return command(structure) if callable(command) else command
+
+    kvs = _get_keys_and_values(structure, path[0])
+    return _update_structure(structure, kvs, path[1:], command)
+
+
+def _items(structure):
+    try:
+        return structure.items()
+    except AttributeError:
+        # Support wider range of structures by adding a transform_items() or similar?
+        return list(enumerate(structure))
+
+
+def _get(structure, key, default):
+    try:
+        if hasattr(structure, '__getitem__'):
+            return structure[key]
+
+        return getattr(structure, key)
+
+    except (IndexError, KeyError):
+        return default
+
+
+def _get_keys_and_values(structure, key_spec):
+    if callable(key_spec):
+        # Support predicates as callable objects in the path
+        arity = _get_arity(key_spec)
+        if arity == 1:
+            # Unary predicates are called with the "key" of the path
+            # - eg a key in a mapping, an index in a sequence.
+            return [(k, v) for k, v in _items(structure) if key_spec(k)]
+        elif arity == 2:
+            # Binary predicates are called with the key and the corresponding
+            # value.
+            return [(k, v) for k, v in _items(structure) if key_spec(k, v)]
+        else:
+            # Other arities are an error.
+            raise ValueError(
+                "callable in transform path must take 1 or 2 arguments"
+            )
+
+    # Non-callables are used as-is as a key.
+    return [(key_spec, _get(structure, key_spec, _EMPTY_SENTINEL))]
+
+
+if signature is None:
+    def _get_arity(f):
+        argspec = getfullargspec(f)
+        return len(argspec.args) - len(argspec.defaults or ())
+else:
+    def _get_arity(f):
+        return sum(
+            1
+            for p
+            in signature(f).parameters.values()
+            if p.default is Parameter.empty
+            and p.kind in (Parameter.POSITIONAL_ONLY, Parameter.POSITIONAL_OR_KEYWORD)
+        )
+
+
+def _update_structure(structure, kvs, path, command):
+    from pyrsistent._pmap import pmap
+    e = structure.evolver()
+    if not path and command is discard:
+        # Do this in reverse to avoid index problems with vectors. See #92.
+        for k, v in reversed(kvs):
+            discard(e, k)
+    else:
+        for k, v in kvs:
+            is_empty = False
+            if v is _EMPTY_SENTINEL:
+                # Allow expansion of structure but make sure to cover the case
+                # when an empty pmap is added as leaf node. See #154.
+                is_empty = True
+                v = pmap()
+
+            result = _do_to_path(v, path, command)
+            if result is not v or is_empty:
+                e[k] = result
+
+    return e.persistent()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/py.typed b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/py.typed
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a86c831ba478bb1118aa2aeb69954a9ddebc429
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.py
@@ -0,0 +1,80 @@
+"""Helpers for use with type annotation.
+
+Use the empty classes in this module when annotating the types of Pyrsistent
+objects, instead of using the actual collection class.
+
+For example,
+
+    from pyrsistent import pvector
+    from pyrsistent.typing import PVector
+
+    myvector: PVector[str] = pvector(['a', 'b', 'c'])
+
+"""
+from __future__ import absolute_import
+
+try:
+    from typing import Container
+    from typing import Hashable
+    from typing import Generic
+    from typing import Iterable
+    from typing import Mapping
+    from typing import Sequence
+    from typing import Sized
+    from typing import TypeVar
+
+    __all__ = [
+        'CheckedPMap',
+        'CheckedPSet',
+        'CheckedPVector',
+        'PBag',
+        'PDeque',
+        'PList',
+        'PMap',
+        'PSet',
+        'PVector',
+    ]
+
+    T = TypeVar('T')
+    KT = TypeVar('KT')
+    VT = TypeVar('VT')
+
+    class CheckedPMap(Mapping[KT, VT], Hashable):
+        pass
+
+    # PSet.add and PSet.discard have different type signatures than that of Set.
+    class CheckedPSet(Generic[T], Hashable):
+        pass
+
+    class CheckedPVector(Sequence[T], Hashable):
+        pass
+
+    class PBag(Container[T], Iterable[T], Sized, Hashable):
+        pass
+
+    class PDeque(Sequence[T], Hashable):
+        pass
+
+    class PList(Sequence[T], Hashable):
+        pass
+
+    class PMap(Mapping[KT, VT], Hashable):
+        pass
+
+    # PSet.add and PSet.discard have different type signatures than that of Set.
+    class PSet(Generic[T], Hashable):
+        pass
+
+    class PVector(Sequence[T], Hashable):
+        pass
+
+    class PVectorEvolver(Generic[T]):
+        pass
+
+    class PMapEvolver(Generic[KT, VT]):
+        pass
+
+    class PSetEvolver(Generic[T]):
+        pass
+except ImportError:
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.pyi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.pyi
new file mode 100644
index 0000000000000000000000000000000000000000..0221c48cc916e11695dd4f5c82ecf680127fcb9b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pyrsistent/typing.pyi
@@ -0,0 +1,292 @@
+# flake8: noqa: E704
+# from https://gist.github.com/WuTheFWasThat/091a17d4b5cab597dfd5d4c2d96faf09
+# Stubs for pyrsistent (Python 3.6)
+#
+from typing import Any
+from typing import Callable
+from typing import Dict
+from typing import Generic
+from typing import Hashable
+from typing import Iterator
+from typing import Iterable
+from typing import List
+from typing import Mapping
+from typing import Optional
+from typing import Sequence
+from typing import AbstractSet
+from typing import Sized
+from typing import Set
+from typing import Tuple
+from typing import TypeVar
+from typing import Type
+from typing import Union
+from typing import overload
+
+T = TypeVar('T')
+KT = TypeVar('KT')
+VT = TypeVar('VT')
+
+
+class PMap(Mapping[KT, VT], Hashable):
+    def __add__(self, other: PMap[KT, VT]) -> PMap[KT, VT]: ...
+    def __getitem__(self, key: KT) -> VT: ...
+    def __getattr__(self, key: str) -> VT: ...
+    def __hash__(self) -> int: ...
+    def __iter__(self) -> Iterator[KT]: ...
+    def __len__(self) -> int: ...
+    def copy(self) -> PMap[KT, VT]: ...
+    def discard(self, key: KT) -> PMap[KT, VT]: ...
+    def evolver(self) -> PMapEvolver[KT, VT]: ...
+    def iteritems(self) -> Iterable[Tuple[KT, VT]]: ...
+    def iterkeys(self) -> Iterable[KT]: ...
+    def itervalues(self) -> Iterable[VT]: ...
+    def remove(self, key: KT) -> PMap[KT, VT]: ...
+    def set(self, key: KT, val: VT) -> PMap[KT, VT]: ...
+    def transform(self, *transformations: Any) -> PMap[KT, VT]: ...
+    def update(self, *args: Mapping): ...
+    def update_with(self, update_fn: Callable[[VT, VT], VT], *args: Mapping) -> Any: ...
+
+
+class PMapEvolver(Generic[KT, VT]):
+    def __delitem__(self, key: KT) -> None: ...
+    def __getitem__(self, key: KT) -> VT: ...
+    def __len__(self) -> int: ...
+    def __setitem__(self, key: KT, val: VT) -> None: ...
+    def is_dirty(self) -> bool: ...
+    def persistent(self) -> PMap[KT, VT]: ...
+    def remove(self, key: KT) -> PMapEvolver[KT, VT]: ...
+    def set(self, key: KT, val: VT) -> PMapEvolver[KT, VT]: ...
+
+
+class PVector(Sequence[T], Hashable):
+    def __add__(self, other: PVector[T]) -> PVector[T]: ...
+    @overload
+    def __getitem__(self, index: int) -> T: ...
+    @overload
+    def __getitem__(self, index: slice) -> PVector[T]: ...
+    def __hash__(self) -> int: ...
+    def __len__(self) -> int: ...
+    def __mul__(self, other: PVector[T]) -> PVector[T]: ...
+    def append(self, val: T) -> PVector[T]: ...
+    def delete(self, index: int, stop: Optional[int]) -> PVector[T]: ...
+    def evolver(self) -> PVectorEvolver[T]: ...
+    def extend(self, obj: Iterable[T]) -> PVector[T]: ...
+    def tolist(self) -> List[T]: ...
+    def mset(self, *args: Iterable[Union[T, int]]) -> PVector[T]: ...
+    def remove(self, value: T) -> PVector[T]: ...
+    # Not compatible with MutableSequence
+    def set(self, i: int, val: T) -> PVector[T]: ...
+    def transform(self, *transformations: Any) -> PVector[T]: ...
+
+
+class PVectorEvolver(Sequence[T], Sized):
+    def __delitem__(self, i: Union[int, slice]) -> None: ...
+    @overload
+    def __getitem__(self, index: int) -> T: ...
+    # Not actually supported
+    @overload
+    def __getitem__(self, index: slice) -> PVectorEvolver[T]: ...
+    def __len__(self) -> int: ...
+    def __setitem__(self, index: int, val: T) -> None: ...
+    def append(self, val: T) -> PVectorEvolver[T]: ...
+    def delete(self, value: T) -> PVectorEvolver[T]: ...
+    def extend(self, obj: Iterable[T]) -> PVectorEvolver[T]: ...
+    def is_dirty(self) -> bool: ...
+    def persistent(self) -> PVector[T]: ...
+    def set(self, i: int, val: T) -> PVectorEvolver[T]: ...
+
+
+class PSet(AbstractSet[T], Hashable):
+    def __contains__(self, element: object) -> bool: ...
+    def __hash__(self) -> int: ...
+    def __iter__(self) -> Iterator[T]: ...
+    def __len__(self) -> int: ...
+    def add(self, element: T) -> PSet[T]: ...
+    def copy(self) -> PSet[T]: ...
+    def difference(self, iterable: Iterable) -> PSet[T]: ...
+    def discard(self, element: T) -> PSet[T]: ...
+    def evolver(self) -> PSetEvolver[T]: ...
+    def intersection(self, iterable: Iterable) -> PSet[T]: ...
+    def issubset(self, iterable: Iterable) -> bool: ...
+    def issuperset(self, iterable: Iterable) -> bool: ...
+    def remove(self, element: T) -> PSet[T]: ...
+    def symmetric_difference(self, iterable: Iterable[T]) -> PSet[T]: ...
+    def union(self, iterable: Iterable[T]) -> PSet[T]: ...
+    def update(self, iterable: Iterable[T]) -> PSet[T]: ...
+
+
+class PSetEvolver(Generic[T], Sized):
+    def __len__(self) -> int: ...
+    def add(self, element: T) -> PSetEvolver[T]: ...
+    def is_dirty(self) -> bool: ...
+    def persistent(self) -> PSet[T]: ...
+    def remove(self, element: T) -> PSetEvolver[T]: ...
+
+
+class PBag(Generic[T], Sized, Hashable):
+    def __add__(self, other: PBag[T]) -> PBag[T]: ...
+    def __and__(self, other: PBag[T]) -> PBag[T]: ...
+    def __contains__(self, elem: object) -> bool: ...
+    def __hash__(self) -> int: ...
+    def __iter__(self) -> Iterator[T]: ...
+    def __len__(self) -> int: ...
+    def __or__(self, other: PBag[T]) -> PBag[T]: ...
+    def __sub__(self, other: PBag[T]) -> PBag[T]: ...
+    def add(self, elem: T) -> PBag[T]: ...
+    def count(self, elem: T) -> int: ...
+    def remove(self, elem: T) -> PBag[T]: ...
+    def update(self, iterable: Iterable[T]) -> PBag[T]: ...
+
+
+class PDeque(Sequence[T], Hashable):
+    @overload
+    def __getitem__(self, index: int) -> T: ...
+    @overload
+    def __getitem__(self, index: slice) -> PDeque[T]: ...
+    def __hash__(self) -> int: ...
+    def __len__(self) -> int: ...
+    def __lt__(self, other: PDeque[T]) -> bool: ...
+    def append(self, elem: T) -> PDeque[T]: ...
+    def appendleft(self, elem: T) -> PDeque[T]: ...
+    def extend(self, iterable: Iterable[T]) -> PDeque[T]: ...
+    def extendleft(self, iterable: Iterable[T]) -> PDeque[T]: ...
+    @property
+    def left(self) -> T: ...
+    # The real return type is Integral according to what pyrsistent
+    # checks at runtime but mypy doesn't deal in numeric.*:
+    # https://github.com/python/mypy/issues/2636
+    @property
+    def maxlen(self) -> int: ...
+    def pop(self, count: int = 1) -> PDeque[T]: ...
+    def popleft(self, count: int = 1) -> PDeque[T]: ...
+    def remove(self, elem: T) -> PDeque[T]: ...
+    def reverse(self) -> PDeque[T]: ...
+    @property
+    def right(self) -> T: ...
+    def rotate(self, steps: int) -> PDeque[T]: ...
+
+
+class PList(Sequence[T], Hashable):
+    @overload
+    def __getitem__(self, index: int) -> T: ...
+    @overload
+    def __getitem__(self, index: slice) -> PList[T]: ...
+    def __hash__(self) -> int: ...
+    def __len__(self) -> int: ...
+    def __lt__(self, other: PList[T]) -> bool: ...
+    def __gt__(self, other: PList[T]) -> bool: ...
+    def cons(self, elem: T) -> PList[T]: ...
+    @property
+    def first(self) -> T: ...
+    def mcons(self, iterable: Iterable[T]) -> PList[T]: ...
+    def remove(self, elem: T) -> PList[T]: ...
+    @property
+    def rest(self) -> PList[T]: ...
+    def reverse(self) -> PList[T]: ...
+    def split(self, index: int) -> Tuple[PList[T], PList[T]]: ...
+
+T_PClass = TypeVar('T_PClass', bound='PClass')
+
+class PClass(Hashable):
+    def __new__(cls, **kwargs: Any): ...
+    def set(self: T_PClass, *args: Any, **kwargs: Any) -> T_PClass: ...
+    @classmethod
+    def create(
+        cls: Type[T_PClass],
+        kwargs: Any,
+        _factory_fields: Optional[Any] = ...,
+        ignore_extra: bool = ...,
+    ) -> T_PClass: ...
+    def serialize(self, format: Optional[Any] = ...): ...
+    def transform(self, *transformations: Any): ...
+    def __eq__(self, other: object): ...
+    def __ne__(self, other: object): ...
+    def __hash__(self): ...
+    def __reduce__(self): ...
+    def evolver(self) -> PClassEvolver: ...
+    def remove(self: T_PClass, name: Any) -> T_PClass: ...
+
+class PClassEvolver:
+    def __init__(self, original: Any, initial_dict: Any) -> None: ...
+    def __getitem__(self, item: Any): ...
+    def set(self, key: Any, value: Any): ...
+    def __setitem__(self, key: Any, value: Any) -> None: ...
+    def remove(self, item: Any): ...
+    def __delitem__(self, item: Any) -> None: ...
+    def persistent(self) -> PClass: ...
+    def __getattr__(self, item: Any): ...
+
+
+
+class CheckedPMap(PMap[KT, VT]):
+    __key_type__: Type[KT]
+    __value_type__: Type[VT]
+    def __new__(cls, source: Mapping[KT, VT] = ..., size: int = ...) -> CheckedPMap: ...
+    @classmethod
+    def create(cls, source_data: Mapping[KT, VT], _factory_fields: Any = ...) -> CheckedPMap[KT, VT]: ...
+    def serialize(self, format: Optional[Any] = ...) -> Dict[KT, VT]: ...
+
+
+class CheckedPVector(PVector[T]):
+    __type__: Type[T]
+    def __new__(self, initial: Iterable[T] = ...) -> CheckedPVector: ...
+    @classmethod
+    def create(cls, source_data: Iterable[T], _factory_fields: Any = ...) -> CheckedPVector[T]: ...
+    def serialize(self, format: Optional[Any] = ...) -> List[T]: ...
+
+
+class CheckedPSet(PSet[T]):
+    __type__: Type[T]
+    def __new__(cls, initial: Iterable[T] = ...) -> CheckedPSet: ...
+    @classmethod
+    def create(cls, source_data: Iterable[T], _factory_fields: Any = ...) -> CheckedPSet[T]: ...
+    def serialize(self, format: Optional[Any] = ...) -> Set[T]: ...
+
+
+class InvariantException(Exception):
+    invariant_errors: Tuple[Any, ...] = ...  # possibly nested tuple
+    missing_fields: Tuple[str, ...] = ...
+    def __init__(
+        self,
+        error_codes: Any = ...,
+        missing_fields: Any = ...,
+        *args: Any,
+        **kwargs: Any
+    ) -> None: ...
+
+
+class CheckedTypeError(TypeError):
+    source_class: Type[Any]
+    expected_types: Tuple[Any, ...]
+    actual_type: Type[Any]
+    actual_value: Any
+    def __init__(
+        self,
+        source_class: Any,
+        expected_types: Any,
+        actual_type: Any,
+        actual_value: Any,
+        *args: Any,
+        **kwargs: Any
+    ) -> None: ...
+
+
+class CheckedKeyTypeError(CheckedTypeError): ...
+class CheckedValueTypeError(CheckedTypeError): ...
+class CheckedType: ...
+
+
+class PTypeError(TypeError):
+    source_class: Type[Any] = ...
+    field: str = ...
+    expected_types: Tuple[Any, ...] = ...
+    actual_type: Type[Any] = ...
+    def __init__(
+        self,
+        source_class: Any,
+        field: Any,
+        expected_types: Any,
+        actual_type: Any,
+        *args: Any,
+        **kwargs: Any
+    ) -> None: ...
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..1e65815cf0b3132689485874a93034ede7206bf4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/LICENSE
@@ -0,0 +1,54 @@
+Copyright 2017- Paul Ganssle <paul@ganssle.io>
+Copyright 2017- dateutil contributors (see AUTHORS file)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+The above license applies to all contributions after 2017-12-01, as well as
+all contributions that have been re-licensed (see AUTHORS file for the list of
+contributors who have re-licensed their code).
+--------------------------------------------------------------------------------
+dateutil - Extensions to the standard Python datetime module.
+
+Copyright (c) 2003-2011 - Gustavo Niemeyer <gustavo@niemeyer.net>
+Copyright (c) 2012-2014 - Tomi Pieviläinen <tomi.pievilainen@iki.fi>
+Copyright (c) 2014-2016 - Yaron de Leeuw <me@jarondl.net>
+Copyright (c) 2015-     - Paul Ganssle <paul@ganssle.io>
+Copyright (c) 2015-     - dateutil contributors (see AUTHORS file)
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the name of the copyright holder nor the names of its
+      contributors may be used to endorse or promote products derived from
+      this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+The above BSD License Applies to all code, even that also covered by Apache 2.0.
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..2e476a142eece0523cb4a041ab5719844b02f5cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/METADATA
@@ -0,0 +1,200 @@
+Metadata-Version: 2.1
+Name: python-dateutil
+Version: 2.8.1
+Summary: Extensions to the standard Python datetime module
+Home-page: https://dateutil.readthedocs.io
+Author: Gustavo Niemeyer
+Author-email: gustavo@niemeyer.net
+Maintainer: Paul Ganssle
+Maintainer-email: dateutil@python.org
+License: Dual License
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,>=2.7
+Description-Content-Type: text/x-rst
+Requires-Dist: six (>=1.5)
+
+dateutil - powerful extensions to datetime
+==========================================
+
+|pypi| |support| |licence|
+
+|gitter| |readthedocs|
+
+|travis| |appveyor| |pipelines| |coverage|
+
+.. |pypi| image:: https://img.shields.io/pypi/v/python-dateutil.svg?style=flat-square
+    :target: https://pypi.org/project/python-dateutil/
+    :alt: pypi version
+
+.. |support| image:: https://img.shields.io/pypi/pyversions/python-dateutil.svg?style=flat-square
+    :target: https://pypi.org/project/python-dateutil/
+    :alt: supported Python version
+
+.. |travis| image:: https://img.shields.io/travis/dateutil/dateutil/master.svg?style=flat-square&label=Travis%20Build
+    :target: https://travis-ci.org/dateutil/dateutil
+    :alt: travis build status
+
+.. |appveyor| image:: https://img.shields.io/appveyor/ci/dateutil/dateutil/master.svg?style=flat-square&logo=appveyor
+    :target: https://ci.appveyor.com/project/dateutil/dateutil
+    :alt: appveyor build status
+
+.. |pipelines| image:: https://dev.azure.com/pythondateutilazure/dateutil/_apis/build/status/dateutil.dateutil?branchName=master
+    :target: https://dev.azure.com/pythondateutilazure/dateutil/_build/latest?definitionId=1&branchName=master
+    :alt: azure pipelines build status
+
+.. |coverage| image:: https://codecov.io/github/dateutil/dateutil/coverage.svg?branch=master
+    :target: https://codecov.io/github/dateutil/dateutil?branch=master
+    :alt: Code coverage
+
+.. |gitter| image:: https://badges.gitter.im/dateutil/dateutil.svg
+   :alt: Join the chat at https://gitter.im/dateutil/dateutil
+   :target: https://gitter.im/dateutil/dateutil
+
+.. |licence| image:: https://img.shields.io/pypi/l/python-dateutil.svg?style=flat-square
+    :target: https://pypi.org/project/python-dateutil/
+    :alt: licence
+
+.. |readthedocs| image:: https://img.shields.io/readthedocs/dateutil/latest.svg?style=flat-square&label=Read%20the%20Docs
+   :alt: Read the documentation at https://dateutil.readthedocs.io/en/latest/
+   :target: https://dateutil.readthedocs.io/en/latest/
+
+The `dateutil` module provides powerful extensions to
+the standard `datetime` module, available in Python.
+
+Installation
+============
+`dateutil` can be installed from PyPI using `pip` (note that the package name is
+different from the importable name)::
+
+    pip install python-dateutil
+
+Download
+========
+dateutil is available on PyPI
+https://pypi.org/project/python-dateutil/
+
+The documentation is hosted at:
+https://dateutil.readthedocs.io/en/stable/
+
+Code
+====
+The code and issue tracker are hosted on GitHub:
+https://github.com/dateutil/dateutil/
+
+Features
+========
+
+* Computing of relative deltas (next month, next year,
+  next Monday, last week of month, etc);
+* Computing of relative deltas between two given
+  date and/or datetime objects;
+* Computing of dates based on very flexible recurrence rules,
+  using a superset of the `iCalendar <https://www.ietf.org/rfc/rfc2445.txt>`_
+  specification. Parsing of RFC strings is supported as well.
+* Generic parsing of dates in almost any string format;
+* Timezone (tzinfo) implementations for tzfile(5) format
+  files (/etc/localtime, /usr/share/zoneinfo, etc), TZ
+  environment string (in all known formats), iCalendar
+  format files, given ranges (with help from relative deltas),
+  local machine timezone, fixed offset timezone, UTC timezone,
+  and Windows registry-based time zones.
+* Internal up-to-date world timezone information based on
+  Olson's database.
+* Computing of Easter Sunday dates for any given year,
+  using Western, Orthodox or Julian algorithms;
+* A comprehensive test suite.
+
+Quick example
+=============
+Here's a snapshot, just to give an idea about the power of the
+package. For more examples, look at the documentation.
+
+Suppose you want to know how much time is left, in
+years/months/days/etc, before the next easter happening on a
+year with a Friday 13th in August, and you want to get today's
+date out of the "date" unix system command. Here is the code:
+
+.. code-block:: python3
+
+    >>> from dateutil.relativedelta import *
+    >>> from dateutil.easter import *
+    >>> from dateutil.rrule import *
+    >>> from dateutil.parser import *
+    >>> from datetime import *
+    >>> now = parse("Sat Oct 11 17:13:46 UTC 2003")
+    >>> today = now.date()
+    >>> year = rrule(YEARLY,dtstart=now,bymonth=8,bymonthday=13,byweekday=FR)[0].year
+    >>> rdelta = relativedelta(easter(year), today)
+    >>> print("Today is: %s" % today)
+    Today is: 2003-10-11
+    >>> print("Year with next Aug 13th on a Friday is: %s" % year)
+    Year with next Aug 13th on a Friday is: 2004
+    >>> print("How far is the Easter of that year: %s" % rdelta)
+    How far is the Easter of that year: relativedelta(months=+6)
+    >>> print("And the Easter of that year is: %s" % (today+rdelta))
+    And the Easter of that year is: 2004-04-11
+
+Being exactly 6 months ahead was **really** a coincidence :)
+
+Contributing
+============
+
+We welcome many types of contributions - bug reports, pull requests (code, infrastructure or documentation fixes). For more information about how to contribute to the project, see the ``CONTRIBUTING.md`` file in the repository.
+
+
+Author
+======
+The dateutil module was written by Gustavo Niemeyer <gustavo@niemeyer.net>
+in 2003.
+
+It is maintained by:
+
+* Gustavo Niemeyer <gustavo@niemeyer.net> 2003-2011
+* Tomi Pieviläinen <tomi.pievilainen@iki.fi> 2012-2014
+* Yaron de Leeuw <me@jarondl.net> 2014-2016
+* Paul Ganssle <paul@ganssle.io> 2015-
+
+Starting with version 2.4.1, all source and binary distributions will be signed
+by a PGP key that has, at the very least, been signed by the key which made the
+previous release. A table of release signing keys can be found below:
+
+===========  ============================
+Releases     Signing key fingerprint
+===========  ============================
+2.4.1-       `6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB`_ (|pgp_mirror|_)
+===========  ============================
+
+
+Contact
+=======
+Our mailing list is available at `dateutil@python.org <https://mail.python.org/mailman/listinfo/dateutil>`_. As it is hosted by the PSF, it is subject to the `PSF code of
+conduct <https://www.python.org/psf/codeofconduct/>`_.
+
+License
+=======
+
+All contributions after December 1, 2017 released under dual license - either `Apache 2.0 License <https://www.apache.org/licenses/LICENSE-2.0>`_ or the `BSD 3-Clause License <https://opensource.org/licenses/BSD-3-Clause>`_. Contributions before December 1, 2017 - except those those explicitly relicensed - are released only under the BSD 3-Clause License.
+
+
+.. _6B49 ACBA DCF6 BD1C A206 67AB CD54 FCE3 D964 BEFB:
+   https://pgp.mit.edu/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB
+
+.. |pgp_mirror| replace:: mirror
+.. _pgp_mirror: https://sks-keyservers.net/pks/lookup?op=vindex&search=0xCD54FCE3D964BEFB
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..ace9b35bd91e6f63bae59ed63465611cc6146449
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/RECORD
@@ -0,0 +1,44 @@
+dateutil/__init__.py,sha256=lXElASqwYGwqlrSWSeX19JwF5Be9tNecDa9ebk-0gmk,222
+dateutil/__pycache__/__init__.cpython-38.pyc,,
+dateutil/__pycache__/_common.cpython-38.pyc,,
+dateutil/__pycache__/_version.cpython-38.pyc,,
+dateutil/__pycache__/easter.cpython-38.pyc,,
+dateutil/__pycache__/relativedelta.cpython-38.pyc,,
+dateutil/__pycache__/rrule.cpython-38.pyc,,
+dateutil/__pycache__/tzwin.cpython-38.pyc,,
+dateutil/__pycache__/utils.cpython-38.pyc,,
+dateutil/_common.py,sha256=77w0yytkrxlYbSn--lDVPUMabUXRR9I3lBv_vQRUqUY,932
+dateutil/_version.py,sha256=U1JNX8P5pUNBtcStwfGyAUIMMHGZXhiTDTVXgAUWxs4,116
+dateutil/easter.py,sha256=0liVsgqSx-NPhaFevOJaYgEbrSu2oQQ2o9m_OEBdc-s,2684
+dateutil/parser/__init__.py,sha256=wWk6GFuxTpjoggCGtgkceJoti4pVjl4_fHQXpNOaSYg,1766
+dateutil/parser/__pycache__/__init__.cpython-38.pyc,,
+dateutil/parser/__pycache__/_parser.cpython-38.pyc,,
+dateutil/parser/__pycache__/isoparser.cpython-38.pyc,,
+dateutil/parser/_parser.py,sha256=F0w8h9txvatnYAmeJ1MMbIAvZHRzy3iFjv-AZqRovNs,58804
+dateutil/parser/isoparser.py,sha256=BeEEqIeqhcgik5Cp1_G5Aztsqayp-MAr3aVqAKo1XRc,13098
+dateutil/relativedelta.py,sha256=GjVxqpAVWnG67rdbf7pkoIlJvQqmju9NSfGCcqblc7U,24904
+dateutil/rrule.py,sha256=dStRcOIj8jul-BurMKguc_IBckY-Qci1K6EYqNW8eUg,66514
+dateutil/tz/__init__.py,sha256=F-Mz13v6jYseklQf9Te9J6nzcLDmq47gORa61K35_FA,444
+dateutil/tz/__pycache__/__init__.cpython-38.pyc,,
+dateutil/tz/__pycache__/_common.cpython-38.pyc,,
+dateutil/tz/__pycache__/_factories.cpython-38.pyc,,
+dateutil/tz/__pycache__/tz.cpython-38.pyc,,
+dateutil/tz/__pycache__/win.cpython-38.pyc,,
+dateutil/tz/_common.py,sha256=cgzDTANsOXvEc86cYF77EsliuSab8Puwpsl5-bX3_S4,12977
+dateutil/tz/_factories.py,sha256=unb6XQNXrPMveksTCU-Ag8jmVZs4SojoPUcAHpWnrvU,2569
+dateutil/tz/tz.py,sha256=npaGnA2M2LGUUerXzAml9rMM-BE771igYFcFETeC3JE,62851
+dateutil/tz/win.py,sha256=xJszWgSwE1xPx_HJj4ZkepyukC_hNy016WMcXhbRaB8,12935
+dateutil/tzwin.py,sha256=7Ar4vdQCnnM0mKR3MUjbIKsZrBVfHgdwsJZc_mGYRew,59
+dateutil/utils.py,sha256=Agvhi7i3HuJdwHYCe9lDS63l_LNFUUlB2hmR3ZKNYwE,1959
+dateutil/zoneinfo/__init__.py,sha256=KYg0pthCMjcp5MXSEiBJn3nMjZeNZav7rlJw5-tz1S4,5889
+dateutil/zoneinfo/__pycache__/__init__.cpython-38.pyc,,
+dateutil/zoneinfo/__pycache__/rebuild.cpython-38.pyc,,
+dateutil/zoneinfo/dateutil-zoneinfo.tar.gz,sha256=6bZJKrN3mhnCqMgQgFSllQNNbtld9AnuPaRIXWoSH4o,153315
+dateutil/zoneinfo/rebuild.py,sha256=2uFJQiW3Fl8fVogrSXisJMpLeHI1zGwpvBFF43QdeF0,1719
+python_dateutil-2.8.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+python_dateutil-2.8.1.dist-info/LICENSE,sha256=ugD1Gg2SgjtaHN4n2LW50jIeZ-2NqbwWPv-W1eF-V34,2889
+python_dateutil-2.8.1.dist-info/METADATA,sha256=u7pGPxvY3bP0MsvsWab9OeTybTnbLX011vZxRW12I1Y,7988
+python_dateutil-2.8.1.dist-info/RECORD,,
+python_dateutil-2.8.1.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110
+python_dateutil-2.8.1.dist-info/top_level.txt,sha256=4tjdWkhRZvF7LA_BYe_L9gB2w_p2a-z5y6ArjaRkot8,9
+python_dateutil-2.8.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..8b701e93c23159bc1f4145f779049ce0a6a6cf77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.33.6)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..66501480ba5b63f98ee9a59c1f99e5e6917da6d9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+dateutil
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/zip-safe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/zip-safe
new file mode 100644
index 0000000000000000000000000000000000000000..8b137891791fe96927ad78e64b0aad7bded08bdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/python_dateutil-2.8.1.dist-info/zip-safe
@@ -0,0 +1 @@
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..5863bb9c4a81840a297e6ba53890aa4fbb0a1f5b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/METADATA
@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: pytoml
+Version: 0.1.21
+Summary: A parser for TOML-0.4.0
+Home-page: https://github.com/avakar/pytoml
+Author: Martin Vejnár
+Author-email: vejnar.martin@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+
+[![PyPI](https://img.shields.io/pypi/v/pytoml.svg)](https://pypi.python.org/pypi/pytoml)
+[![Build Status](https://travis-ci.org/avakar/pytoml.svg?branch=master)](https://travis-ci.org/avakar/pytoml)
+
+# Deprecated
+
+The pytoml project is no longer being actively maintained. Consider using the
+[toml](https://github.com/uiri/toml) package instead.
+
+# pytoml
+
+This project aims at being a specs-conforming and strict parser and writer for [TOML][1] files.
+The library currently supports [version 0.4.0][2] of the specs and runs with Python 2.7+ and 3.5+.
+
+Install:
+
+    pip install pytoml
+
+The interface is the same as for the standard `json` package.
+
+    >>> import pytoml as toml
+    >>> toml.loads('a = 1')
+    {'a': 1}
+    >>> with open('file.toml', 'rb') as fin:
+    ...     obj = toml.load(fin)
+    >>> obj
+    {'a': 1}
+
+The `loads` function accepts either a bytes object
+(that gets decoded as UTF-8 with no BOM allowed),
+or a unicode object.
+
+Use `dump` or `dumps` to serialize a dict into TOML.
+
+    >>> print toml.dumps(obj)
+    a = 1
+
+## tests
+
+To run the tests update the `toml-test` submodule:
+
+    git submodule update --init --recursive
+
+Then run the tests:
+
+    python test/test.py
+
+  [1]: https://github.com/toml-lang/toml
+  [2]: https://github.com/toml-lang/toml/blob/master/versions/en/toml-v0.4.0.md
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..87a356b9990737c86b7aeebf4cbd2b16545ac7c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/RECORD
@@ -0,0 +1,22 @@
+pytoml/__init__.py,sha256=aaP6a6S-oBAkE91bnvKlpy-3Ypv-GFLEIOdy-LuBK0Y,130
+pytoml/core.py,sha256=W8BqMPwcme5HkPBtxkQz9VJBvhkrELje94Dh1iUfFaI,522
+pytoml/parser.py,sha256=EAraDAq9Z1XlTcksrg5QVu0XzVpAHo5d96ReppjSa-U,10651
+pytoml/test.py,sha256=2rSkw5pQrKAyCY4FfwoThsdvp6CP7AjwFiah30n5RAk,1051
+pytoml/utils.py,sha256=GXvQZaY-N9M7ybPuFglDYxm7vIv8HeiqrVaP8Apd4fY,1732
+pytoml/writer.py,sha256=u5vwRNLG7bR7K3HzgJqWUfzWoWgtQfk6o5ebaDSe6gg,3483
+pytoml-0.1.21.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+pytoml-0.1.21.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+pytoml-0.1.21.dist-info/METADATA,sha256=yqK2aVy45YbnMiHIaUTbE5Al9mrxzpeK9QA0PHh1ukU,1982
+pytoml-0.1.21.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+pytoml-0.1.21.dist-info/top_level.txt,sha256=u6-m8vvMEpDTaZiHCdubMZpzyfXl0P7aHblTupzejg4,7
+pytoml-0.1.21.dist-info/RECORD,,
+pytoml-0.1.21.virtualenv,,
+pytoml/writer.cpython-38.pyc,,
+pytoml/utils.cpython-38.pyc,,
+pytoml/parser.cpython-38.pyc,,
+pytoml-0.1.21.dist-info/INSTALLER,,
+pytoml/test.cpython-38.pyc,,
+pytoml/__init__.cpython-38.pyc,,
+pytoml/core.cpython-38.pyc,,
+pytoml/__pycache__,,
+pytoml-0.1.21.dist-info/__pycache__,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..058140720adf7d877e12b9a762a1432d6f967f8a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.dist-info/top_level.txt
@@ -0,0 +1 @@
+pytoml
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml-0.1.21.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..eb328cba301045f233b0f3f7b26d7530b7be2173
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/__init__.py
@@ -0,0 +1,4 @@
+from .core import TomlError
+from .parser import load, loads
+from .test import translate_to_test
+from .writer import dump, dumps
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/core.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..0fcada48c6441c1d3b566dd900d6af3564365cb9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/core.py
@@ -0,0 +1,13 @@
+class TomlError(RuntimeError):
+    def __init__(self, message, line, col, filename):
+        RuntimeError.__init__(self, message, line, col, filename)
+        self.message = message
+        self.line = line
+        self.col = col
+        self.filename = filename
+
+    def __str__(self):
+        return '{}({}, {}): {}'.format(self.filename, self.line, self.col, self.message)
+
+    def __repr__(self):
+        return 'TomlError({!r}, {!r}, {!r}, {!r})'.format(self.message, self.line, self.col, self.filename)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..c8ae4678f0975f720393f9a777326f771229c817
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/parser.py
@@ -0,0 +1,342 @@
+import re, sys
+from .core import TomlError
+from .utils import rfc3339_re, parse_rfc3339_re
+
+if sys.version_info[0] == 2:
+    _chr = unichr
+else:
+    _chr = chr
+
+def load(fin, translate=lambda t, x, v: v, object_pairs_hook=dict):
+    return loads(fin.read(), translate=translate, object_pairs_hook=object_pairs_hook, filename=getattr(fin, 'name', repr(fin)))
+
+def loads(s, filename='<string>', translate=lambda t, x, v: v, object_pairs_hook=dict):
+    if isinstance(s, bytes):
+        s = s.decode('utf-8')
+
+    s = s.replace('\r\n', '\n')
+
+    root = object_pairs_hook()
+    tables = object_pairs_hook()
+    scope = root
+
+    src = _Source(s, filename=filename)
+    ast = _p_toml(src, object_pairs_hook=object_pairs_hook)
+
+    def error(msg):
+        raise TomlError(msg, pos[0], pos[1], filename)
+
+    def process_value(v, object_pairs_hook):
+        kind, text, value, pos = v
+        if kind == 'array':
+            if value and any(k != value[0][0] for k, t, v, p in value[1:]):
+                error('array-type-mismatch')
+            value = [process_value(item, object_pairs_hook=object_pairs_hook) for item in value]
+        elif kind == 'table':
+            value = object_pairs_hook([(k, process_value(value[k], object_pairs_hook=object_pairs_hook)) for k in value])
+        return translate(kind, text, value)
+
+    for kind, value, pos in ast:
+        if kind == 'kv':
+            k, v = value
+            if k in scope:
+                error('duplicate_keys. Key "{0}" was used more than once.'.format(k))
+            scope[k] = process_value(v, object_pairs_hook=object_pairs_hook)
+        else:
+            is_table_array = (kind == 'table_array')
+            cur = tables
+            for name in value[:-1]:
+                if isinstance(cur.get(name), list):
+                    d, cur = cur[name][-1]
+                else:
+                    d, cur = cur.setdefault(name, (None, object_pairs_hook()))
+
+            scope = object_pairs_hook()
+            name = value[-1]
+            if name not in cur:
+                if is_table_array:
+                    cur[name] = [(scope, object_pairs_hook())]
+                else:
+                    cur[name] = (scope, object_pairs_hook())
+            elif isinstance(cur[name], list):
+                if not is_table_array:
+                    error('table_type_mismatch')
+                cur[name].append((scope, object_pairs_hook()))
+            else:
+                if is_table_array:
+                    error('table_type_mismatch')
+                old_scope, next_table = cur[name]
+                if old_scope is not None:
+                    error('duplicate_tables')
+                cur[name] = (scope, next_table)
+
+    def merge_tables(scope, tables):
+        if scope is None:
+            scope = object_pairs_hook()
+        for k in tables:
+            if k in scope:
+                error('key_table_conflict')
+            v = tables[k]
+            if isinstance(v, list):
+                scope[k] = [merge_tables(sc, tbl) for sc, tbl in v]
+            else:
+                scope[k] = merge_tables(v[0], v[1])
+        return scope
+
+    return merge_tables(root, tables)
+
+class _Source:
+    def __init__(self, s, filename=None):
+        self.s = s
+        self._pos = (1, 1)
+        self._last = None
+        self._filename = filename
+        self.backtrack_stack = []
+
+    def last(self):
+        return self._last
+
+    def pos(self):
+        return self._pos
+
+    def fail(self):
+        return self._expect(None)
+
+    def consume_dot(self):
+        if self.s:
+            self._last = self.s[0]
+            self.s = self[1:]
+            self._advance(self._last)
+            return self._last
+        return None
+
+    def expect_dot(self):
+        return self._expect(self.consume_dot())
+
+    def consume_eof(self):
+        if not self.s:
+            self._last = ''
+            return True
+        return False
+
+    def expect_eof(self):
+        return self._expect(self.consume_eof())
+
+    def consume(self, s):
+        if self.s.startswith(s):
+            self.s = self.s[len(s):]
+            self._last = s
+            self._advance(s)
+            return True
+        return False
+
+    def expect(self, s):
+        return self._expect(self.consume(s))
+
+    def consume_re(self, re):
+        m = re.match(self.s)
+        if m:
+            self.s = self.s[len(m.group(0)):]
+            self._last = m
+            self._advance(m.group(0))
+            return m
+        return None
+
+    def expect_re(self, re):
+        return self._expect(self.consume_re(re))
+
+    def __enter__(self):
+        self.backtrack_stack.append((self.s, self._pos))
+
+    def __exit__(self, type, value, traceback):
+        if type is None:
+            self.backtrack_stack.pop()
+        else:
+            self.s, self._pos = self.backtrack_stack.pop()
+        return type == TomlError
+
+    def commit(self):
+        self.backtrack_stack[-1] = (self.s, self._pos)
+
+    def _expect(self, r):
+        if not r:
+            raise TomlError('msg', self._pos[0], self._pos[1], self._filename)
+        return r
+
+    def _advance(self, s):
+        suffix_pos = s.rfind('\n')
+        if suffix_pos == -1:
+            self._pos = (self._pos[0], self._pos[1] + len(s))
+        else:
+            self._pos = (self._pos[0] + s.count('\n'), len(s) - suffix_pos)
+
+_ews_re = re.compile(r'(?:[ \t]|#[^\n]*\n|#[^\n]*\Z|\n)*')
+def _p_ews(s):
+    s.expect_re(_ews_re)
+
+_ws_re = re.compile(r'[ \t]*')
+def _p_ws(s):
+    s.expect_re(_ws_re)
+
+_escapes = { 'b': '\b', 'n': '\n', 'r': '\r', 't': '\t', '"': '"',
+    '\\': '\\', 'f': '\f' }
+
+_basicstr_re = re.compile(r'[^"\\\000-\037]*')
+_short_uni_re = re.compile(r'u([0-9a-fA-F]{4})')
+_long_uni_re = re.compile(r'U([0-9a-fA-F]{8})')
+_escapes_re = re.compile(r'[btnfr\"\\]')
+_newline_esc_re = re.compile('\n[ \t\n]*')
+def _p_basicstr_content(s, content=_basicstr_re):
+    res = []
+    while True:
+        res.append(s.expect_re(content).group(0))
+        if not s.consume('\\'):
+            break
+        if s.consume_re(_newline_esc_re):
+            pass
+        elif s.consume_re(_short_uni_re) or s.consume_re(_long_uni_re):
+            v = int(s.last().group(1), 16)
+            if 0xd800 <= v < 0xe000:
+                s.fail()
+            res.append(_chr(v))
+        else:
+            s.expect_re(_escapes_re)
+            res.append(_escapes[s.last().group(0)])
+    return ''.join(res)
+
+_key_re = re.compile(r'[0-9a-zA-Z-_]+')
+def _p_key(s):
+    with s:
+        s.expect('"')
+        r = _p_basicstr_content(s, _basicstr_re)
+        s.expect('"')
+        return r
+    if s.consume('\''):
+        if s.consume('\'\''):
+            s.consume('\n')
+            r = s.expect_re(_litstr_ml_re).group(0)
+            s.expect('\'\'\'')
+        else:
+            r = s.expect_re(_litstr_re).group(0)
+            s.expect('\'')
+        return r
+    return s.expect_re(_key_re).group(0)
+
+_float_re = re.compile(r'[+-]?(?:0|[1-9](?:_?\d)*)(?:\.\d(?:_?\d)*)?(?:[eE][+-]?(?:\d(?:_?\d)*))?')
+
+_basicstr_ml_re = re.compile(r'(?:""?(?!")|[^"\\\000-\011\013-\037])*')
+_litstr_re = re.compile(r"[^'\000\010\012-\037]*")
+_litstr_ml_re = re.compile(r"(?:(?:|'|'')(?:[^'\000-\010\013-\037]))*")
+def _p_value(s, object_pairs_hook):
+    pos = s.pos()
+
+    if s.consume('true'):
+        return 'bool', s.last(), True, pos
+    if s.consume('false'):
+        return 'bool', s.last(), False, pos
+
+    if s.consume('"'):
+        if s.consume('""'):
+            s.consume('\n')
+            r = _p_basicstr_content(s, _basicstr_ml_re)
+            s.expect('"""')
+        else:
+            r = _p_basicstr_content(s, _basicstr_re)
+            s.expect('"')
+        return 'str', r, r, pos
+
+    if s.consume('\''):
+        if s.consume('\'\''):
+            s.consume('\n')
+            r = s.expect_re(_litstr_ml_re).group(0)
+            s.expect('\'\'\'')
+        else:
+            r = s.expect_re(_litstr_re).group(0)
+            s.expect('\'')
+        return 'str', r, r, pos
+
+    if s.consume_re(rfc3339_re):
+        m = s.last()
+        return 'datetime', m.group(0), parse_rfc3339_re(m), pos
+
+    if s.consume_re(_float_re):
+        m = s.last().group(0)
+        r = m.replace('_','')
+        if '.' in m or 'e' in m or 'E' in m:
+            return 'float', m, float(r), pos
+        else:
+            return 'int', m, int(r, 10), pos
+
+    if s.consume('['):
+        items = []
+        with s:
+            while True:
+                _p_ews(s)
+                items.append(_p_value(s, object_pairs_hook=object_pairs_hook))
+                s.commit()
+                _p_ews(s)
+                s.expect(',')
+                s.commit()
+        _p_ews(s)
+        s.expect(']')
+        return 'array', None, items, pos
+
+    if s.consume('{'):
+        _p_ws(s)
+        items = object_pairs_hook()
+        if not s.consume('}'):
+            k = _p_key(s)
+            _p_ws(s)
+            s.expect('=')
+            _p_ws(s)
+            items[k] = _p_value(s, object_pairs_hook=object_pairs_hook)
+            _p_ws(s)
+            while s.consume(','):
+                _p_ws(s)
+                k = _p_key(s)
+                _p_ws(s)
+                s.expect('=')
+                _p_ws(s)
+                items[k] = _p_value(s, object_pairs_hook=object_pairs_hook)
+                _p_ws(s)
+            s.expect('}')
+        return 'table', None, items, pos
+
+    s.fail()
+
+def _p_stmt(s, object_pairs_hook):
+    pos = s.pos()
+    if s.consume(   '['):
+        is_array = s.consume('[')
+        _p_ws(s)
+        keys = [_p_key(s)]
+        _p_ws(s)
+        while s.consume('.'):
+            _p_ws(s)
+            keys.append(_p_key(s))
+            _p_ws(s)
+        s.expect(']')
+        if is_array:
+            s.expect(']')
+        return 'table_array' if is_array else 'table', keys, pos
+
+    key = _p_key(s)
+    _p_ws(s)
+    s.expect('=')
+    _p_ws(s)
+    value = _p_value(s, object_pairs_hook=object_pairs_hook)
+    return 'kv', (key, value), pos
+
+_stmtsep_re = re.compile(r'(?:[ \t]*(?:#[^\n]*)?\n)+[ \t]*')
+def _p_toml(s, object_pairs_hook):
+    stmts = []
+    _p_ews(s)
+    with s:
+        stmts.append(_p_stmt(s, object_pairs_hook=object_pairs_hook))
+        while True:
+            s.commit()
+            s.expect_re(_stmtsep_re)
+            stmts.append(_p_stmt(s, object_pairs_hook=object_pairs_hook))
+    _p_ews(s)
+    s.expect_eof()
+    return stmts
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/test.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/test.py
new file mode 100644
index 0000000000000000000000000000000000000000..11deec9acff9c66cdb4a91207025f18f35105ec3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/test.py
@@ -0,0 +1,30 @@
+import datetime
+from .utils import format_rfc3339
+
+try:
+    _string_types = (str, unicode)
+    _int_types = (int, long)
+except NameError:
+    _string_types = str
+    _int_types = int
+
+def translate_to_test(v):
+    if isinstance(v, dict):
+        return { k: translate_to_test(v) for k, v in v.items() }
+    if isinstance(v, list):
+        a = [translate_to_test(x) for x in v]
+        if v and isinstance(v[0], dict):
+            return a
+        else:
+            return {'type': 'array', 'value': a}
+    if isinstance(v, datetime.datetime):
+        return {'type': 'datetime', 'value': format_rfc3339(v)}
+    if isinstance(v, bool):
+        return {'type': 'bool', 'value': 'true' if v else 'false'}
+    if isinstance(v, _int_types):
+        return {'type': 'integer', 'value': str(v)}
+    if isinstance(v, float):
+        return {'type': 'float', 'value': '{:.17}'.format(v)}
+    if isinstance(v, _string_types):
+        return {'type': 'string', 'value': v}
+    raise RuntimeError('unexpected value: {!r}'.format(v))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..56f199efe83ee2fe33a9b6061f1aa2bdb5f73fec
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/utils.py
@@ -0,0 +1,67 @@
+import datetime
+import re
+
+rfc3339_re = re.compile(r'(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?(?:Z|([+-]\d{2}):(\d{2}))')
+
+def parse_rfc3339(v):
+    m = rfc3339_re.match(v)
+    if not m or m.group(0) != v:
+        return None
+    return parse_rfc3339_re(m)
+
+def parse_rfc3339_re(m):
+    r = map(int, m.groups()[:6])
+    if m.group(7):
+        micro = float(m.group(7))
+    else:
+        micro = 0
+
+    if m.group(8):
+        g = int(m.group(8), 10) * 60 + int(m.group(9), 10)
+        tz = _TimeZone(datetime.timedelta(0, g * 60))
+    else:
+        tz = _TimeZone(datetime.timedelta(0, 0))
+
+    y, m, d, H, M, S = r
+    return datetime.datetime(y, m, d, H, M, S, int(micro * 1000000), tz)
+
+
+def format_rfc3339(v):
+    offs = v.utcoffset()
+    offs = int(offs.total_seconds()) // 60 if offs is not None else 0
+
+    if offs == 0:
+        suffix = 'Z'
+    else:
+        if offs > 0:
+            suffix = '+'
+        else:
+            suffix = '-'
+            offs = -offs
+        suffix = '{0}{1:02}:{2:02}'.format(suffix, offs // 60, offs % 60)
+
+    if v.microsecond:
+        return v.strftime('%Y-%m-%dT%H:%M:%S.%f') + suffix
+    else:
+        return v.strftime('%Y-%m-%dT%H:%M:%S') + suffix
+
+class _TimeZone(datetime.tzinfo):
+    def __init__(self, offset):
+        self._offset = offset
+
+    def utcoffset(self, dt):
+        return self._offset
+
+    def dst(self, dt):
+        return None
+
+    def tzname(self, dt):
+        m = self._offset.total_seconds() // 60
+        if m < 0:
+            res = '-'
+            m = -m
+        else:
+            res = '+'
+        h = m // 60
+        m = m - h * 60
+        return '{}{:.02}{:.02}'.format(res, h, m)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/writer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/writer.py
new file mode 100644
index 0000000000000000000000000000000000000000..c6fd4e1c18198cc94123c5b9676abcf6140e3474
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytoml/writer.py
@@ -0,0 +1,114 @@
+from __future__ import unicode_literals
+import io, datetime, math, string, sys
+
+from .utils import format_rfc3339
+
+try:
+    from pathlib import PurePath as _path_types
+except ImportError:
+    _path_types = ()
+
+
+if sys.version_info[0] == 3:
+    long = int
+    unicode = str
+
+
+def dumps(obj, sort_keys=False):
+    fout = io.StringIO()
+    dump(obj, fout, sort_keys=sort_keys)
+    return fout.getvalue()
+
+
+_escapes = {'\n': 'n', '\r': 'r', '\\': '\\', '\t': 't', '\b': 'b', '\f': 'f', '"': '"'}
+
+
+def _escape_string(s):
+    res = []
+    start = 0
+
+    def flush():
+        if start != i:
+            res.append(s[start:i])
+        return i + 1
+
+    i = 0
+    while i < len(s):
+        c = s[i]
+        if c in '"\\\n\r\t\b\f':
+            start = flush()
+            res.append('\\' + _escapes[c])
+        elif ord(c) < 0x20:
+            start = flush()
+            res.append('\\u%04x' % ord(c))
+        i += 1
+
+    flush()
+    return '"' + ''.join(res) + '"'
+
+
+_key_chars = string.digits + string.ascii_letters + '-_'
+def _escape_id(s):
+    if any(c not in _key_chars for c in s):
+        return _escape_string(s)
+    return s
+
+
+def _format_value(v):
+    if isinstance(v, bool):
+        return 'true' if v else 'false'
+    if isinstance(v, int) or isinstance(v, long):
+        return unicode(v)
+    if isinstance(v, float):
+        if math.isnan(v) or math.isinf(v):
+            raise ValueError("{0} is not a valid TOML value".format(v))
+        else:
+            return repr(v)
+    elif isinstance(v, unicode) or isinstance(v, bytes):
+        return _escape_string(v)
+    elif isinstance(v, datetime.datetime):
+        return format_rfc3339(v)
+    elif isinstance(v, list):
+        return '[{0}]'.format(', '.join(_format_value(obj) for obj in v))
+    elif isinstance(v, dict):
+        return '{{{0}}}'.format(', '.join('{} = {}'.format(_escape_id(k), _format_value(obj)) for k, obj in v.items()))
+    elif isinstance(v, _path_types):
+        return _escape_string(str(v))
+    else:
+        raise RuntimeError(v)
+
+
+def dump(obj, fout, sort_keys=False):
+    tables = [((), obj, False)]
+
+    while tables:
+        name, table, is_array = tables.pop()
+        if name:
+            section_name = '.'.join(_escape_id(c) for c in name)
+            if is_array:
+                fout.write('[[{0}]]\n'.format(section_name))
+            else:
+                fout.write('[{0}]\n'.format(section_name))
+
+        table_keys = sorted(table.keys()) if sort_keys else table.keys()
+        new_tables = []
+        has_kv = False
+        for k in table_keys:
+            v = table[k]
+            if isinstance(v, dict):
+                new_tables.append((name + (k,), v, False))
+            elif isinstance(v, list) and v and all(isinstance(o, dict) for o in v):
+                new_tables.extend((name + (k,), d, True) for d in v)
+            elif v is None:
+                # based on mojombo's comment: https://github.com/toml-lang/toml/issues/146#issuecomment-25019344
+                fout.write(
+                    '#{} = null  # To use: uncomment and replace null with value\n'.format(_escape_id(k)))
+                has_kv = True
+            else:
+                fout.write('{0} = {1}\n'.format(_escape_id(k), _format_value(v)))
+                has_kv = True
+
+        tables.extend(reversed(new_tables))
+
+        if (name or has_kv) and tables:
+            fout.write('\n')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/DESCRIPTION.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/DESCRIPTION.rst
new file mode 100644
index 0000000000000000000000000000000000000000..172954824a9ba59f86d0329f161281829f5c3b6a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/DESCRIPTION.rst
@@ -0,0 +1,598 @@
+pytz - World Timezone Definitions for Python
+============================================
+
+:Author: Stuart Bishop <stuart@stuartbishop.net>
+
+Introduction
+~~~~~~~~~~~~
+
+pytz brings the Olson tz database into Python. This library allows
+accurate and cross platform timezone calculations using Python 2.4
+or higher. It also solves the issue of ambiguous times at the end
+of daylight saving time, which you can read more about in the Python
+Library Reference (``datetime.tzinfo``).
+
+Almost all of the Olson timezones are supported.
+
+.. note::
+
+    This library differs from the documented Python API for
+    tzinfo implementations; if you want to create local wallclock
+    times you need to use the ``localize()`` method documented in this
+    document. In addition, if you perform date arithmetic on local
+    times that cross DST boundaries, the result may be in an incorrect
+    timezone (ie. subtract 1 minute from 2002-10-27 1:00 EST and you get
+    2002-10-27 0:59 EST instead of the correct 2002-10-27 1:59 EDT). A
+    ``normalize()`` method is provided to correct this. Unfortunately these
+    issues cannot be resolved without modifying the Python datetime
+    implementation (see PEP-431).
+
+
+Installation
+~~~~~~~~~~~~
+
+This package can either be installed using ``pip`` or from a tarball using the
+standard Python distutils.
+
+If you are installing using ``pip``, you don't need to download anything as the
+latest version will be downloaded for you from PyPI::
+
+    pip install pytz
+
+If you are installing from a tarball, run the following command as an
+administrative user::
+
+    python setup.py install
+
+
+pytz for Enterprise
+~~~~~~~~~~~~~~~~~~~
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of pytz and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. `Learn more. <https://tidelift.com/subscription/pkg/pypi-pytz?utm_source=pypi-pytz&utm_medium=referral&utm_campaign=enterprise&utm_term=repo>`_.
+
+
+Example & Usage
+~~~~~~~~~~~~~~~
+
+Localized times and date arithmetic
+-----------------------------------
+
+>>> from datetime import datetime, timedelta
+>>> from pytz import timezone
+>>> import pytz
+>>> utc = pytz.utc
+>>> utc.zone
+'UTC'
+>>> eastern = timezone('US/Eastern')
+>>> eastern.zone
+'US/Eastern'
+>>> amsterdam = timezone('Europe/Amsterdam')
+>>> fmt = '%Y-%m-%d %H:%M:%S %Z%z'
+
+This library only supports two ways of building a localized time. The
+first is to use the ``localize()`` method provided by the pytz library.
+This is used to localize a naive datetime (datetime with no timezone
+information):
+
+>>> loc_dt = eastern.localize(datetime(2002, 10, 27, 6, 0, 0))
+>>> print(loc_dt.strftime(fmt))
+2002-10-27 06:00:00 EST-0500
+
+The second way of building a localized time is by converting an existing
+localized time using the standard ``astimezone()`` method:
+
+>>> ams_dt = loc_dt.astimezone(amsterdam)
+>>> ams_dt.strftime(fmt)
+'2002-10-27 12:00:00 CET+0100'
+
+Unfortunately using the tzinfo argument of the standard datetime
+constructors ''does not work'' with pytz for many timezones.
+
+>>> datetime(2002, 10, 27, 12, 0, 0, tzinfo=amsterdam).strftime(fmt)  # /!\ Does not work this way!
+'2002-10-27 12:00:00 LMT+0020'
+
+It is safe for timezones without daylight saving transitions though, such
+as UTC:
+
+>>> datetime(2002, 10, 27, 12, 0, 0, tzinfo=pytz.utc).strftime(fmt)  # /!\ Not recommended except for UTC
+'2002-10-27 12:00:00 UTC+0000'
+
+The preferred way of dealing with times is to always work in UTC,
+converting to localtime only when generating output to be read
+by humans.
+
+>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
+>>> loc_dt = utc_dt.astimezone(eastern)
+>>> loc_dt.strftime(fmt)
+'2002-10-27 01:00:00 EST-0500'
+
+This library also allows you to do date arithmetic using local
+times, although it is more complicated than working in UTC as you
+need to use the ``normalize()`` method to handle daylight saving time
+and other timezone transitions. In this example, ``loc_dt`` is set
+to the instant when daylight saving time ends in the US/Eastern
+timezone.
+
+>>> before = loc_dt - timedelta(minutes=10)
+>>> before.strftime(fmt)
+'2002-10-27 00:50:00 EST-0500'
+>>> eastern.normalize(before).strftime(fmt)
+'2002-10-27 01:50:00 EDT-0400'
+>>> after = eastern.normalize(before + timedelta(minutes=20))
+>>> after.strftime(fmt)
+'2002-10-27 01:10:00 EST-0500'
+
+Creating local times is also tricky, and the reason why working with
+local times is not recommended. Unfortunately, you cannot just pass
+a ``tzinfo`` argument when constructing a datetime (see the next
+section for more details)
+
+>>> dt = datetime(2002, 10, 27, 1, 30, 0)
+>>> dt1 = eastern.localize(dt, is_dst=True)
+>>> dt1.strftime(fmt)
+'2002-10-27 01:30:00 EDT-0400'
+>>> dt2 = eastern.localize(dt, is_dst=False)
+>>> dt2.strftime(fmt)
+'2002-10-27 01:30:00 EST-0500'
+
+Converting between timezones is more easily done, using the
+standard astimezone method.
+
+>>> utc_dt = utc.localize(datetime.utcfromtimestamp(1143408899))
+>>> utc_dt.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> au_tz = timezone('Australia/Sydney')
+>>> au_dt = utc_dt.astimezone(au_tz)
+>>> au_dt.strftime(fmt)
+'2006-03-27 08:34:59 AEDT+1100'
+>>> utc_dt2 = au_dt.astimezone(utc)
+>>> utc_dt2.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> utc_dt == utc_dt2
+True
+
+You can take shortcuts when dealing with the UTC side of timezone
+conversions. ``normalize()`` and ``localize()`` are not really
+necessary when there are no daylight saving time transitions to
+deal with.
+
+>>> utc_dt = datetime.utcfromtimestamp(1143408899).replace(tzinfo=utc)
+>>> utc_dt.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> au_tz = timezone('Australia/Sydney')
+>>> au_dt = au_tz.normalize(utc_dt.astimezone(au_tz))
+>>> au_dt.strftime(fmt)
+'2006-03-27 08:34:59 AEDT+1100'
+>>> utc_dt2 = au_dt.astimezone(utc)
+>>> utc_dt2.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+
+
+``tzinfo`` API
+--------------
+
+The ``tzinfo`` instances returned by the ``timezone()`` function have
+been extended to cope with ambiguous times by adding an ``is_dst``
+parameter to the ``utcoffset()``, ``dst()`` && ``tzname()`` methods.
+
+>>> tz = timezone('America/St_Johns')
+
+>>> normal = datetime(2009, 9, 1)
+>>> ambiguous = datetime(2009, 10, 31, 23, 30)
+
+The ``is_dst`` parameter is ignored for most timestamps. It is only used
+during DST transition ambiguous periods to resolve that ambiguity.
+
+>>> print(tz.utcoffset(normal, is_dst=True))
+-1 day, 21:30:00
+>>> print(tz.dst(normal, is_dst=True))
+1:00:00
+>>> tz.tzname(normal, is_dst=True)
+'NDT'
+
+>>> print(tz.utcoffset(ambiguous, is_dst=True))
+-1 day, 21:30:00
+>>> print(tz.dst(ambiguous, is_dst=True))
+1:00:00
+>>> tz.tzname(ambiguous, is_dst=True)
+'NDT'
+
+>>> print(tz.utcoffset(normal, is_dst=False))
+-1 day, 21:30:00
+>>> tz.dst(normal, is_dst=False)
+datetime.timedelta(0, 3600)
+>>> tz.tzname(normal, is_dst=False)
+'NDT'
+
+>>> print(tz.utcoffset(ambiguous, is_dst=False))
+-1 day, 20:30:00
+>>> tz.dst(ambiguous, is_dst=False)
+datetime.timedelta(0)
+>>> tz.tzname(ambiguous, is_dst=False)
+'NST'
+
+If ``is_dst`` is not specified, ambiguous timestamps will raise
+an ``pytz.exceptions.AmbiguousTimeError`` exception.
+
+>>> print(tz.utcoffset(normal))
+-1 day, 21:30:00
+>>> print(tz.dst(normal))
+1:00:00
+>>> tz.tzname(normal)
+'NDT'
+
+>>> import pytz.exceptions
+>>> try:
+...     tz.utcoffset(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+>>> try:
+...     tz.dst(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+>>> try:
+...     tz.tzname(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+
+
+Problems with Localtime
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The major problem we have to deal with is that certain datetimes
+may occur twice in a year. For example, in the US/Eastern timezone
+on the last Sunday morning in October, the following sequence
+happens:
+
+    - 01:00 EDT occurs
+    - 1 hour later, instead of 2:00am the clock is turned back 1 hour
+      and 01:00 happens again (this time 01:00 EST)
+
+In fact, every instant between 01:00 and 02:00 occurs twice. This means
+that if you try and create a time in the 'US/Eastern' timezone
+the standard datetime syntax, there is no way to specify if you meant
+before of after the end-of-daylight-saving-time transition. Using the
+pytz custom syntax, the best you can do is make an educated guess:
+
+>>> loc_dt = eastern.localize(datetime(2002, 10, 27, 1, 30, 00))
+>>> loc_dt.strftime(fmt)
+'2002-10-27 01:30:00 EST-0500'
+
+As you can see, the system has chosen one for you and there is a 50%
+chance of it being out by one hour. For some applications, this does
+not matter. However, if you are trying to schedule meetings with people
+in different timezones or analyze log files it is not acceptable.
+
+The best and simplest solution is to stick with using UTC.  The pytz
+package encourages using UTC for internal timezone representation by
+including a special UTC implementation based on the standard Python
+reference implementation in the Python documentation.
+
+The UTC timezone unpickles to be the same instance, and pickles to a
+smaller size than other pytz tzinfo instances.  The UTC implementation
+can be obtained as pytz.utc, pytz.UTC, or pytz.timezone('UTC').
+
+>>> import pickle, pytz
+>>> dt = datetime(2005, 3, 1, 14, 13, 21, tzinfo=utc)
+>>> naive = dt.replace(tzinfo=None)
+>>> p = pickle.dumps(dt, 1)
+>>> naive_p = pickle.dumps(naive, 1)
+>>> len(p) - len(naive_p)
+17
+>>> new = pickle.loads(p)
+>>> new == dt
+True
+>>> new is dt
+False
+>>> new.tzinfo is dt.tzinfo
+True
+>>> pytz.utc is pytz.UTC is pytz.timezone('UTC')
+True
+
+Note that some other timezones are commonly thought of as the same (GMT,
+Greenwich, Universal, etc.). The definition of UTC is distinct from these
+other timezones, and they are not equivalent. For this reason, they will
+not compare the same in Python.
+
+>>> utc == pytz.timezone('GMT')
+False
+
+See the section `What is UTC`_, below.
+
+If you insist on working with local times, this library provides a
+facility for constructing them unambiguously:
+
+>>> loc_dt = datetime(2002, 10, 27, 1, 30, 00)
+>>> est_dt = eastern.localize(loc_dt, is_dst=True)
+>>> edt_dt = eastern.localize(loc_dt, is_dst=False)
+>>> print(est_dt.strftime(fmt) + ' / ' + edt_dt.strftime(fmt))
+2002-10-27 01:30:00 EDT-0400 / 2002-10-27 01:30:00 EST-0500
+
+If you pass None as the is_dst flag to localize(), pytz will refuse to
+guess and raise exceptions if you try to build ambiguous or non-existent
+times.
+
+For example, 1:30am on 27th Oct 2002 happened twice in the US/Eastern
+timezone when the clocks where put back at the end of Daylight Saving
+Time:
+
+>>> dt = datetime(2002, 10, 27, 1, 30, 00)
+>>> try:
+...     eastern.localize(dt, is_dst=None)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % dt)
+pytz.exceptions.AmbiguousTimeError: 2002-10-27 01:30:00
+
+Similarly, 2:30am on 7th April 2002 never happened at all in the
+US/Eastern timezone, as the clocks where put forward at 2:00am skipping
+the entire hour:
+
+>>> dt = datetime(2002, 4, 7, 2, 30, 00)
+>>> try:
+...     eastern.localize(dt, is_dst=None)
+... except pytz.exceptions.NonExistentTimeError:
+...     print('pytz.exceptions.NonExistentTimeError: %s' % dt)
+pytz.exceptions.NonExistentTimeError: 2002-04-07 02:30:00
+
+Both of these exceptions share a common base class to make error handling
+easier:
+
+>>> isinstance(pytz.AmbiguousTimeError(), pytz.InvalidTimeError)
+True
+>>> isinstance(pytz.NonExistentTimeError(), pytz.InvalidTimeError)
+True
+
+
+A special case is where countries change their timezone definitions
+with no daylight savings time switch. For example, in 1915 Warsaw
+switched from Warsaw time to Central European time with no daylight savings
+transition. So at the stroke of midnight on August 5th 1915 the clocks
+were wound back 24 minutes creating an ambiguous time period that cannot
+be specified without referring to the timezone abbreviation or the
+actual UTC offset. In this case midnight happened twice, neither time
+during a daylight saving time period. pytz handles this transition by
+treating the ambiguous period before the switch as daylight savings
+time, and the ambiguous period after as standard time.
+
+
+>>> warsaw = pytz.timezone('Europe/Warsaw')
+>>> amb_dt1 = warsaw.localize(datetime(1915, 8, 4, 23, 59, 59), is_dst=True)
+>>> amb_dt1.strftime(fmt)
+'1915-08-04 23:59:59 WMT+0124'
+>>> amb_dt2 = warsaw.localize(datetime(1915, 8, 4, 23, 59, 59), is_dst=False)
+>>> amb_dt2.strftime(fmt)
+'1915-08-04 23:59:59 CET+0100'
+>>> switch_dt = warsaw.localize(datetime(1915, 8, 5, 00, 00, 00), is_dst=False)
+>>> switch_dt.strftime(fmt)
+'1915-08-05 00:00:00 CET+0100'
+>>> str(switch_dt - amb_dt1)
+'0:24:01'
+>>> str(switch_dt - amb_dt2)
+'0:00:01'
+
+The best way of creating a time during an ambiguous time period is
+by converting from another timezone such as UTC:
+
+>>> utc_dt = datetime(1915, 8, 4, 22, 36, tzinfo=pytz.utc)
+>>> utc_dt.astimezone(warsaw).strftime(fmt)
+'1915-08-04 23:36:00 CET+0100'
+
+The standard Python way of handling all these ambiguities is not to
+handle them, such as demonstrated in this example using the US/Eastern
+timezone definition from the Python documentation (Note that this
+implementation only works for dates between 1987 and 2006 - it is
+included for tests only!):
+
+>>> from pytz.reference import Eastern # pytz.reference only for tests
+>>> dt = datetime(2002, 10, 27, 0, 30, tzinfo=Eastern)
+>>> str(dt)
+'2002-10-27 00:30:00-04:00'
+>>> str(dt + timedelta(hours=1))
+'2002-10-27 01:30:00-05:00'
+>>> str(dt + timedelta(hours=2))
+'2002-10-27 02:30:00-05:00'
+>>> str(dt + timedelta(hours=3))
+'2002-10-27 03:30:00-05:00'
+
+Notice the first two results? At first glance you might think they are
+correct, but taking the UTC offset into account you find that they are
+actually two hours appart instead of the 1 hour we asked for.
+
+>>> from pytz.reference import UTC # pytz.reference only for tests
+>>> str(dt.astimezone(UTC))
+'2002-10-27 04:30:00+00:00'
+>>> str((dt + timedelta(hours=1)).astimezone(UTC))
+'2002-10-27 06:30:00+00:00'
+
+
+Country Information
+~~~~~~~~~~~~~~~~~~~
+
+A mechanism is provided to access the timezones commonly in use
+for a particular country, looked up using the ISO 3166 country code.
+It returns a list of strings that can be used to retrieve the relevant
+tzinfo instance using ``pytz.timezone()``:
+
+>>> print(' '.join(pytz.country_timezones['nz']))
+Pacific/Auckland Pacific/Chatham
+
+The Olson database comes with a ISO 3166 country code to English country
+name mapping that pytz exposes as a dictionary:
+
+>>> print(pytz.country_names['nz'])
+New Zealand
+
+
+What is UTC
+~~~~~~~~~~~
+
+'UTC' is `Coordinated Universal Time`_. It is a successor to, but distinct
+from, Greenwich Mean Time (GMT) and the various definitions of Universal
+Time. UTC is now the worldwide standard for regulating clocks and time
+measurement.
+
+All other timezones are defined relative to UTC, and include offsets like
+UTC+0800 - hours to add or subtract from UTC to derive the local time. No
+daylight saving time occurs in UTC, making it a useful timezone to perform
+date arithmetic without worrying about the confusion and ambiguities caused
+by daylight saving time transitions, your country changing its timezone, or
+mobile computers that roam through multiple timezones.
+
+..  _Coordinated Universal Time: https://en.wikipedia.org/wiki/Coordinated_Universal_Time
+
+
+Helpers
+~~~~~~~
+
+There are two lists of timezones provided.
+
+``all_timezones`` is the exhaustive list of the timezone names that can
+be used.
+
+>>> from pytz import all_timezones
+>>> len(all_timezones) >= 500
+True
+>>> 'Etc/Greenwich' in all_timezones
+True
+
+``common_timezones`` is a list of useful, current timezones. It doesn't
+contain deprecated zones or historical zones, except for a few I've
+deemed in common usage, such as US/Eastern (open a bug report if you
+think other timezones are deserving of being included here). It is also
+a sequence of strings.
+
+>>> from pytz import common_timezones
+>>> len(common_timezones) < len(all_timezones)
+True
+>>> 'Etc/Greenwich' in common_timezones
+False
+>>> 'Australia/Melbourne' in common_timezones
+True
+>>> 'US/Eastern' in common_timezones
+True
+>>> 'Canada/Eastern' in common_timezones
+True
+>>> 'Australia/Yancowinna' in all_timezones
+True
+>>> 'Australia/Yancowinna' in common_timezones
+False
+
+Both ``common_timezones`` and ``all_timezones`` are alphabetically
+sorted:
+
+>>> common_timezones_dupe = common_timezones[:]
+>>> common_timezones_dupe.sort()
+>>> common_timezones == common_timezones_dupe
+True
+>>> all_timezones_dupe = all_timezones[:]
+>>> all_timezones_dupe.sort()
+>>> all_timezones == all_timezones_dupe
+True
+
+``all_timezones`` and ``common_timezones`` are also available as sets.
+
+>>> from pytz import all_timezones_set, common_timezones_set
+>>> 'US/Eastern' in all_timezones_set
+True
+>>> 'US/Eastern' in common_timezones_set
+True
+>>> 'Australia/Victoria' in common_timezones_set
+False
+
+You can also retrieve lists of timezones used by particular countries
+using the ``country_timezones()`` function. It requires an ISO-3166
+two letter country code.
+
+>>> from pytz import country_timezones
+>>> print(' '.join(country_timezones('ch')))
+Europe/Zurich
+>>> print(' '.join(country_timezones('CH')))
+Europe/Zurich
+
+
+Internationalization - i18n/l10n
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Pytz is an interface to the IANA database, which uses ASCII names. The `Unicode  Consortium's Unicode Locales (CLDR) <http://cldr.unicode.org>`_
+project provides translations. Thomas Khyn's
+`l18n <https://pypi.org/project/l18n/>`_ package can be used to access
+these translations from Python.
+
+
+License
+~~~~~~~
+
+MIT license.
+
+This code is also available as part of Zope 3 under the Zope Public
+License,  Version 2.1 (ZPL).
+
+I'm happy to relicense this code if necessary for inclusion in other
+open source projects.
+
+
+Latest Versions
+~~~~~~~~~~~~~~~
+
+This package will be updated after releases of the Olson timezone
+database.  The latest version can be downloaded from the `Python Package
+Index <https://pypi.org/project/pytz/>`_.  The code that is used
+to generate this distribution is hosted on launchpad.net and available
+using git::
+
+    git clone https://git.launchpad.net/pytz
+
+A mirror on github is also available at https://github.com/stub42/pytz
+
+Announcements of new releases are made on
+`Launchpad <https://launchpad.net/pytz>`_, and the
+`Atom feed <http://feeds.launchpad.net/pytz/announcements.atom>`_
+hosted there.
+
+
+Bugs, Feature Requests & Patches
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Bugs can be reported using `Launchpad Bugs <https://bugs.launchpad.net/pytz>`_.
+
+
+Security Issues
+~~~~~~~~~~~~~~~
+
+Reports about security issues can be made via `Tidelift <https://tidelift.com/security>`_.
+
+
+Issues & Limitations
+~~~~~~~~~~~~~~~~~~~~
+
+- Offsets from UTC are rounded to the nearest whole minute, so timezones
+  such as Europe/Amsterdam pre 1937 will be up to 30 seconds out. This
+  is a limitation of the Python datetime library.
+
+- If you think a timezone definition is incorrect, I probably can't fix
+  it. pytz is a direct translation of the Olson timezone database, and
+  changes to the timezone definitions need to be made to this source.
+  If you find errors they should be reported to the time zone mailing
+  list, linked from http://www.iana.org/time-zones.
+
+
+Further Reading
+~~~~~~~~~~~~~~~
+
+More info than you want to know about timezones:
+http://www.twinsun.com/tz/tz-link.htm
+
+
+Contact
+~~~~~~~
+
+Stuart Bishop <stuart@stuartbishop.net>
+
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..5f1c11289f6a54cb07ebdbf31d02e8e81b18b07f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/LICENSE.txt
@@ -0,0 +1,19 @@
+Copyright (c) 2003-2019 Stuart Bishop <stuart@stuartbishop.net>
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..2fcd986ba7d643309d9f966a25421de94327b8a0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/METADATA
@@ -0,0 +1,634 @@
+Metadata-Version: 2.0
+Name: pytz
+Version: 2021.1
+Summary: World timezone definitions, modern and historical
+Home-page: http://pythonhosted.org/pytz
+Author: Stuart Bishop
+Author-email: stuart@stuartbishop.net
+Maintainer: Stuart Bishop
+Maintainer-email: stuart@stuartbishop.net
+License: MIT
+Download-URL: https://pypi.org/project/pytz/
+Keywords: timezone,tzinfo,datetime,olson,time
+Platform: Independent
+Classifier: Development Status :: 6 - Mature
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.4
+Classifier: Programming Language :: Python :: 2.5
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.1
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+
+pytz - World Timezone Definitions for Python
+============================================
+
+:Author: Stuart Bishop <stuart@stuartbishop.net>
+
+Introduction
+~~~~~~~~~~~~
+
+pytz brings the Olson tz database into Python. This library allows
+accurate and cross platform timezone calculations using Python 2.4
+or higher. It also solves the issue of ambiguous times at the end
+of daylight saving time, which you can read more about in the Python
+Library Reference (``datetime.tzinfo``).
+
+Almost all of the Olson timezones are supported.
+
+.. note::
+
+    This library differs from the documented Python API for
+    tzinfo implementations; if you want to create local wallclock
+    times you need to use the ``localize()`` method documented in this
+    document. In addition, if you perform date arithmetic on local
+    times that cross DST boundaries, the result may be in an incorrect
+    timezone (ie. subtract 1 minute from 2002-10-27 1:00 EST and you get
+    2002-10-27 0:59 EST instead of the correct 2002-10-27 1:59 EDT). A
+    ``normalize()`` method is provided to correct this. Unfortunately these
+    issues cannot be resolved without modifying the Python datetime
+    implementation (see PEP-431).
+
+
+Installation
+~~~~~~~~~~~~
+
+This package can either be installed using ``pip`` or from a tarball using the
+standard Python distutils.
+
+If you are installing using ``pip``, you don't need to download anything as the
+latest version will be downloaded for you from PyPI::
+
+    pip install pytz
+
+If you are installing from a tarball, run the following command as an
+administrative user::
+
+    python setup.py install
+
+
+pytz for Enterprise
+~~~~~~~~~~~~~~~~~~~
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of pytz and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. `Learn more. <https://tidelift.com/subscription/pkg/pypi-pytz?utm_source=pypi-pytz&utm_medium=referral&utm_campaign=enterprise&utm_term=repo>`_.
+
+
+Example & Usage
+~~~~~~~~~~~~~~~
+
+Localized times and date arithmetic
+-----------------------------------
+
+>>> from datetime import datetime, timedelta
+>>> from pytz import timezone
+>>> import pytz
+>>> utc = pytz.utc
+>>> utc.zone
+'UTC'
+>>> eastern = timezone('US/Eastern')
+>>> eastern.zone
+'US/Eastern'
+>>> amsterdam = timezone('Europe/Amsterdam')
+>>> fmt = '%Y-%m-%d %H:%M:%S %Z%z'
+
+This library only supports two ways of building a localized time. The
+first is to use the ``localize()`` method provided by the pytz library.
+This is used to localize a naive datetime (datetime with no timezone
+information):
+
+>>> loc_dt = eastern.localize(datetime(2002, 10, 27, 6, 0, 0))
+>>> print(loc_dt.strftime(fmt))
+2002-10-27 06:00:00 EST-0500
+
+The second way of building a localized time is by converting an existing
+localized time using the standard ``astimezone()`` method:
+
+>>> ams_dt = loc_dt.astimezone(amsterdam)
+>>> ams_dt.strftime(fmt)
+'2002-10-27 12:00:00 CET+0100'
+
+Unfortunately using the tzinfo argument of the standard datetime
+constructors ''does not work'' with pytz for many timezones.
+
+>>> datetime(2002, 10, 27, 12, 0, 0, tzinfo=amsterdam).strftime(fmt)  # /!\ Does not work this way!
+'2002-10-27 12:00:00 LMT+0020'
+
+It is safe for timezones without daylight saving transitions though, such
+as UTC:
+
+>>> datetime(2002, 10, 27, 12, 0, 0, tzinfo=pytz.utc).strftime(fmt)  # /!\ Not recommended except for UTC
+'2002-10-27 12:00:00 UTC+0000'
+
+The preferred way of dealing with times is to always work in UTC,
+converting to localtime only when generating output to be read
+by humans.
+
+>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
+>>> loc_dt = utc_dt.astimezone(eastern)
+>>> loc_dt.strftime(fmt)
+'2002-10-27 01:00:00 EST-0500'
+
+This library also allows you to do date arithmetic using local
+times, although it is more complicated than working in UTC as you
+need to use the ``normalize()`` method to handle daylight saving time
+and other timezone transitions. In this example, ``loc_dt`` is set
+to the instant when daylight saving time ends in the US/Eastern
+timezone.
+
+>>> before = loc_dt - timedelta(minutes=10)
+>>> before.strftime(fmt)
+'2002-10-27 00:50:00 EST-0500'
+>>> eastern.normalize(before).strftime(fmt)
+'2002-10-27 01:50:00 EDT-0400'
+>>> after = eastern.normalize(before + timedelta(minutes=20))
+>>> after.strftime(fmt)
+'2002-10-27 01:10:00 EST-0500'
+
+Creating local times is also tricky, and the reason why working with
+local times is not recommended. Unfortunately, you cannot just pass
+a ``tzinfo`` argument when constructing a datetime (see the next
+section for more details)
+
+>>> dt = datetime(2002, 10, 27, 1, 30, 0)
+>>> dt1 = eastern.localize(dt, is_dst=True)
+>>> dt1.strftime(fmt)
+'2002-10-27 01:30:00 EDT-0400'
+>>> dt2 = eastern.localize(dt, is_dst=False)
+>>> dt2.strftime(fmt)
+'2002-10-27 01:30:00 EST-0500'
+
+Converting between timezones is more easily done, using the
+standard astimezone method.
+
+>>> utc_dt = utc.localize(datetime.utcfromtimestamp(1143408899))
+>>> utc_dt.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> au_tz = timezone('Australia/Sydney')
+>>> au_dt = utc_dt.astimezone(au_tz)
+>>> au_dt.strftime(fmt)
+'2006-03-27 08:34:59 AEDT+1100'
+>>> utc_dt2 = au_dt.astimezone(utc)
+>>> utc_dt2.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> utc_dt == utc_dt2
+True
+
+You can take shortcuts when dealing with the UTC side of timezone
+conversions. ``normalize()`` and ``localize()`` are not really
+necessary when there are no daylight saving time transitions to
+deal with.
+
+>>> utc_dt = datetime.utcfromtimestamp(1143408899).replace(tzinfo=utc)
+>>> utc_dt.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+>>> au_tz = timezone('Australia/Sydney')
+>>> au_dt = au_tz.normalize(utc_dt.astimezone(au_tz))
+>>> au_dt.strftime(fmt)
+'2006-03-27 08:34:59 AEDT+1100'
+>>> utc_dt2 = au_dt.astimezone(utc)
+>>> utc_dt2.strftime(fmt)
+'2006-03-26 21:34:59 UTC+0000'
+
+
+``tzinfo`` API
+--------------
+
+The ``tzinfo`` instances returned by the ``timezone()`` function have
+been extended to cope with ambiguous times by adding an ``is_dst``
+parameter to the ``utcoffset()``, ``dst()`` && ``tzname()`` methods.
+
+>>> tz = timezone('America/St_Johns')
+
+>>> normal = datetime(2009, 9, 1)
+>>> ambiguous = datetime(2009, 10, 31, 23, 30)
+
+The ``is_dst`` parameter is ignored for most timestamps. It is only used
+during DST transition ambiguous periods to resolve that ambiguity.
+
+>>> print(tz.utcoffset(normal, is_dst=True))
+-1 day, 21:30:00
+>>> print(tz.dst(normal, is_dst=True))
+1:00:00
+>>> tz.tzname(normal, is_dst=True)
+'NDT'
+
+>>> print(tz.utcoffset(ambiguous, is_dst=True))
+-1 day, 21:30:00
+>>> print(tz.dst(ambiguous, is_dst=True))
+1:00:00
+>>> tz.tzname(ambiguous, is_dst=True)
+'NDT'
+
+>>> print(tz.utcoffset(normal, is_dst=False))
+-1 day, 21:30:00
+>>> tz.dst(normal, is_dst=False)
+datetime.timedelta(0, 3600)
+>>> tz.tzname(normal, is_dst=False)
+'NDT'
+
+>>> print(tz.utcoffset(ambiguous, is_dst=False))
+-1 day, 20:30:00
+>>> tz.dst(ambiguous, is_dst=False)
+datetime.timedelta(0)
+>>> tz.tzname(ambiguous, is_dst=False)
+'NST'
+
+If ``is_dst`` is not specified, ambiguous timestamps will raise
+an ``pytz.exceptions.AmbiguousTimeError`` exception.
+
+>>> print(tz.utcoffset(normal))
+-1 day, 21:30:00
+>>> print(tz.dst(normal))
+1:00:00
+>>> tz.tzname(normal)
+'NDT'
+
+>>> import pytz.exceptions
+>>> try:
+...     tz.utcoffset(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+>>> try:
+...     tz.dst(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+>>> try:
+...     tz.tzname(ambiguous)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % ambiguous)
+pytz.exceptions.AmbiguousTimeError: 2009-10-31 23:30:00
+
+
+Problems with Localtime
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The major problem we have to deal with is that certain datetimes
+may occur twice in a year. For example, in the US/Eastern timezone
+on the last Sunday morning in October, the following sequence
+happens:
+
+    - 01:00 EDT occurs
+    - 1 hour later, instead of 2:00am the clock is turned back 1 hour
+      and 01:00 happens again (this time 01:00 EST)
+
+In fact, every instant between 01:00 and 02:00 occurs twice. This means
+that if you try and create a time in the 'US/Eastern' timezone
+the standard datetime syntax, there is no way to specify if you meant
+before of after the end-of-daylight-saving-time transition. Using the
+pytz custom syntax, the best you can do is make an educated guess:
+
+>>> loc_dt = eastern.localize(datetime(2002, 10, 27, 1, 30, 00))
+>>> loc_dt.strftime(fmt)
+'2002-10-27 01:30:00 EST-0500'
+
+As you can see, the system has chosen one for you and there is a 50%
+chance of it being out by one hour. For some applications, this does
+not matter. However, if you are trying to schedule meetings with people
+in different timezones or analyze log files it is not acceptable.
+
+The best and simplest solution is to stick with using UTC.  The pytz
+package encourages using UTC for internal timezone representation by
+including a special UTC implementation based on the standard Python
+reference implementation in the Python documentation.
+
+The UTC timezone unpickles to be the same instance, and pickles to a
+smaller size than other pytz tzinfo instances.  The UTC implementation
+can be obtained as pytz.utc, pytz.UTC, or pytz.timezone('UTC').
+
+>>> import pickle, pytz
+>>> dt = datetime(2005, 3, 1, 14, 13, 21, tzinfo=utc)
+>>> naive = dt.replace(tzinfo=None)
+>>> p = pickle.dumps(dt, 1)
+>>> naive_p = pickle.dumps(naive, 1)
+>>> len(p) - len(naive_p)
+17
+>>> new = pickle.loads(p)
+>>> new == dt
+True
+>>> new is dt
+False
+>>> new.tzinfo is dt.tzinfo
+True
+>>> pytz.utc is pytz.UTC is pytz.timezone('UTC')
+True
+
+Note that some other timezones are commonly thought of as the same (GMT,
+Greenwich, Universal, etc.). The definition of UTC is distinct from these
+other timezones, and they are not equivalent. For this reason, they will
+not compare the same in Python.
+
+>>> utc == pytz.timezone('GMT')
+False
+
+See the section `What is UTC`_, below.
+
+If you insist on working with local times, this library provides a
+facility for constructing them unambiguously:
+
+>>> loc_dt = datetime(2002, 10, 27, 1, 30, 00)
+>>> est_dt = eastern.localize(loc_dt, is_dst=True)
+>>> edt_dt = eastern.localize(loc_dt, is_dst=False)
+>>> print(est_dt.strftime(fmt) + ' / ' + edt_dt.strftime(fmt))
+2002-10-27 01:30:00 EDT-0400 / 2002-10-27 01:30:00 EST-0500
+
+If you pass None as the is_dst flag to localize(), pytz will refuse to
+guess and raise exceptions if you try to build ambiguous or non-existent
+times.
+
+For example, 1:30am on 27th Oct 2002 happened twice in the US/Eastern
+timezone when the clocks where put back at the end of Daylight Saving
+Time:
+
+>>> dt = datetime(2002, 10, 27, 1, 30, 00)
+>>> try:
+...     eastern.localize(dt, is_dst=None)
+... except pytz.exceptions.AmbiguousTimeError:
+...     print('pytz.exceptions.AmbiguousTimeError: %s' % dt)
+pytz.exceptions.AmbiguousTimeError: 2002-10-27 01:30:00
+
+Similarly, 2:30am on 7th April 2002 never happened at all in the
+US/Eastern timezone, as the clocks where put forward at 2:00am skipping
+the entire hour:
+
+>>> dt = datetime(2002, 4, 7, 2, 30, 00)
+>>> try:
+...     eastern.localize(dt, is_dst=None)
+... except pytz.exceptions.NonExistentTimeError:
+...     print('pytz.exceptions.NonExistentTimeError: %s' % dt)
+pytz.exceptions.NonExistentTimeError: 2002-04-07 02:30:00
+
+Both of these exceptions share a common base class to make error handling
+easier:
+
+>>> isinstance(pytz.AmbiguousTimeError(), pytz.InvalidTimeError)
+True
+>>> isinstance(pytz.NonExistentTimeError(), pytz.InvalidTimeError)
+True
+
+
+A special case is where countries change their timezone definitions
+with no daylight savings time switch. For example, in 1915 Warsaw
+switched from Warsaw time to Central European time with no daylight savings
+transition. So at the stroke of midnight on August 5th 1915 the clocks
+were wound back 24 minutes creating an ambiguous time period that cannot
+be specified without referring to the timezone abbreviation or the
+actual UTC offset. In this case midnight happened twice, neither time
+during a daylight saving time period. pytz handles this transition by
+treating the ambiguous period before the switch as daylight savings
+time, and the ambiguous period after as standard time.
+
+
+>>> warsaw = pytz.timezone('Europe/Warsaw')
+>>> amb_dt1 = warsaw.localize(datetime(1915, 8, 4, 23, 59, 59), is_dst=True)
+>>> amb_dt1.strftime(fmt)
+'1915-08-04 23:59:59 WMT+0124'
+>>> amb_dt2 = warsaw.localize(datetime(1915, 8, 4, 23, 59, 59), is_dst=False)
+>>> amb_dt2.strftime(fmt)
+'1915-08-04 23:59:59 CET+0100'
+>>> switch_dt = warsaw.localize(datetime(1915, 8, 5, 00, 00, 00), is_dst=False)
+>>> switch_dt.strftime(fmt)
+'1915-08-05 00:00:00 CET+0100'
+>>> str(switch_dt - amb_dt1)
+'0:24:01'
+>>> str(switch_dt - amb_dt2)
+'0:00:01'
+
+The best way of creating a time during an ambiguous time period is
+by converting from another timezone such as UTC:
+
+>>> utc_dt = datetime(1915, 8, 4, 22, 36, tzinfo=pytz.utc)
+>>> utc_dt.astimezone(warsaw).strftime(fmt)
+'1915-08-04 23:36:00 CET+0100'
+
+The standard Python way of handling all these ambiguities is not to
+handle them, such as demonstrated in this example using the US/Eastern
+timezone definition from the Python documentation (Note that this
+implementation only works for dates between 1987 and 2006 - it is
+included for tests only!):
+
+>>> from pytz.reference import Eastern # pytz.reference only for tests
+>>> dt = datetime(2002, 10, 27, 0, 30, tzinfo=Eastern)
+>>> str(dt)
+'2002-10-27 00:30:00-04:00'
+>>> str(dt + timedelta(hours=1))
+'2002-10-27 01:30:00-05:00'
+>>> str(dt + timedelta(hours=2))
+'2002-10-27 02:30:00-05:00'
+>>> str(dt + timedelta(hours=3))
+'2002-10-27 03:30:00-05:00'
+
+Notice the first two results? At first glance you might think they are
+correct, but taking the UTC offset into account you find that they are
+actually two hours appart instead of the 1 hour we asked for.
+
+>>> from pytz.reference import UTC # pytz.reference only for tests
+>>> str(dt.astimezone(UTC))
+'2002-10-27 04:30:00+00:00'
+>>> str((dt + timedelta(hours=1)).astimezone(UTC))
+'2002-10-27 06:30:00+00:00'
+
+
+Country Information
+~~~~~~~~~~~~~~~~~~~
+
+A mechanism is provided to access the timezones commonly in use
+for a particular country, looked up using the ISO 3166 country code.
+It returns a list of strings that can be used to retrieve the relevant
+tzinfo instance using ``pytz.timezone()``:
+
+>>> print(' '.join(pytz.country_timezones['nz']))
+Pacific/Auckland Pacific/Chatham
+
+The Olson database comes with a ISO 3166 country code to English country
+name mapping that pytz exposes as a dictionary:
+
+>>> print(pytz.country_names['nz'])
+New Zealand
+
+
+What is UTC
+~~~~~~~~~~~
+
+'UTC' is `Coordinated Universal Time`_. It is a successor to, but distinct
+from, Greenwich Mean Time (GMT) and the various definitions of Universal
+Time. UTC is now the worldwide standard for regulating clocks and time
+measurement.
+
+All other timezones are defined relative to UTC, and include offsets like
+UTC+0800 - hours to add or subtract from UTC to derive the local time. No
+daylight saving time occurs in UTC, making it a useful timezone to perform
+date arithmetic without worrying about the confusion and ambiguities caused
+by daylight saving time transitions, your country changing its timezone, or
+mobile computers that roam through multiple timezones.
+
+..  _Coordinated Universal Time: https://en.wikipedia.org/wiki/Coordinated_Universal_Time
+
+
+Helpers
+~~~~~~~
+
+There are two lists of timezones provided.
+
+``all_timezones`` is the exhaustive list of the timezone names that can
+be used.
+
+>>> from pytz import all_timezones
+>>> len(all_timezones) >= 500
+True
+>>> 'Etc/Greenwich' in all_timezones
+True
+
+``common_timezones`` is a list of useful, current timezones. It doesn't
+contain deprecated zones or historical zones, except for a few I've
+deemed in common usage, such as US/Eastern (open a bug report if you
+think other timezones are deserving of being included here). It is also
+a sequence of strings.
+
+>>> from pytz import common_timezones
+>>> len(common_timezones) < len(all_timezones)
+True
+>>> 'Etc/Greenwich' in common_timezones
+False
+>>> 'Australia/Melbourne' in common_timezones
+True
+>>> 'US/Eastern' in common_timezones
+True
+>>> 'Canada/Eastern' in common_timezones
+True
+>>> 'Australia/Yancowinna' in all_timezones
+True
+>>> 'Australia/Yancowinna' in common_timezones
+False
+
+Both ``common_timezones`` and ``all_timezones`` are alphabetically
+sorted:
+
+>>> common_timezones_dupe = common_timezones[:]
+>>> common_timezones_dupe.sort()
+>>> common_timezones == common_timezones_dupe
+True
+>>> all_timezones_dupe = all_timezones[:]
+>>> all_timezones_dupe.sort()
+>>> all_timezones == all_timezones_dupe
+True
+
+``all_timezones`` and ``common_timezones`` are also available as sets.
+
+>>> from pytz import all_timezones_set, common_timezones_set
+>>> 'US/Eastern' in all_timezones_set
+True
+>>> 'US/Eastern' in common_timezones_set
+True
+>>> 'Australia/Victoria' in common_timezones_set
+False
+
+You can also retrieve lists of timezones used by particular countries
+using the ``country_timezones()`` function. It requires an ISO-3166
+two letter country code.
+
+>>> from pytz import country_timezones
+>>> print(' '.join(country_timezones('ch')))
+Europe/Zurich
+>>> print(' '.join(country_timezones('CH')))
+Europe/Zurich
+
+
+Internationalization - i18n/l10n
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Pytz is an interface to the IANA database, which uses ASCII names. The `Unicode  Consortium's Unicode Locales (CLDR) <http://cldr.unicode.org>`_
+project provides translations. Thomas Khyn's
+`l18n <https://pypi.org/project/l18n/>`_ package can be used to access
+these translations from Python.
+
+
+License
+~~~~~~~
+
+MIT license.
+
+This code is also available as part of Zope 3 under the Zope Public
+License,  Version 2.1 (ZPL).
+
+I'm happy to relicense this code if necessary for inclusion in other
+open source projects.
+
+
+Latest Versions
+~~~~~~~~~~~~~~~
+
+This package will be updated after releases of the Olson timezone
+database.  The latest version can be downloaded from the `Python Package
+Index <https://pypi.org/project/pytz/>`_.  The code that is used
+to generate this distribution is hosted on launchpad.net and available
+using git::
+
+    git clone https://git.launchpad.net/pytz
+
+A mirror on github is also available at https://github.com/stub42/pytz
+
+Announcements of new releases are made on
+`Launchpad <https://launchpad.net/pytz>`_, and the
+`Atom feed <http://feeds.launchpad.net/pytz/announcements.atom>`_
+hosted there.
+
+
+Bugs, Feature Requests & Patches
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Bugs can be reported using `Launchpad Bugs <https://bugs.launchpad.net/pytz>`_.
+
+
+Security Issues
+~~~~~~~~~~~~~~~
+
+Reports about security issues can be made via `Tidelift <https://tidelift.com/security>`_.
+
+
+Issues & Limitations
+~~~~~~~~~~~~~~~~~~~~
+
+- Offsets from UTC are rounded to the nearest whole minute, so timezones
+  such as Europe/Amsterdam pre 1937 will be up to 30 seconds out. This
+  is a limitation of the Python datetime library.
+
+- If you think a timezone definition is incorrect, I probably can't fix
+  it. pytz is a direct translation of the Olson timezone database, and
+  changes to the timezone definitions need to be made to this source.
+  If you find errors they should be reported to the time zone mailing
+  list, linked from http://www.iana.org/time-zones.
+
+
+Further Reading
+~~~~~~~~~~~~~~~
+
+More info than you want to know about timezones:
+http://www.twinsun.com/tz/tz-link.htm
+
+
+Contact
+~~~~~~~
+
+Stuart Bishop <stuart@stuartbishop.net>
+
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..fcf52aa6e6e5e4ad3b67d20ae326fda921141c8d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/RECORD
@@ -0,0 +1,620 @@
+pytz-2021.1.dist-info/DESCRIPTION.rst,sha256=ovmwqIt48fGpf9TczEWesZm0IiGilc_OZOjBt_tim30,19920
+pytz-2021.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+pytz-2021.1.dist-info/LICENSE.txt,sha256=vosaN-vibFkqkPbA6zMQOn84POL010mMCvmlJpkKB7g,1088
+pytz-2021.1.dist-info/METADATA,sha256=kTNHa1f5tk5725uGfhpiJEY6J6m2fcDDXD62EBk3DNI,21412
+pytz-2021.1.dist-info/RECORD,,
+pytz-2021.1.dist-info/WHEEL,sha256=kdsN-5OJAZIiHN-iO4Rhl82KyS0bDWf4uBwMbkNafr8,110
+pytz-2021.1.dist-info/metadata.json,sha256=E_bzRXeDscpn48NauiutB0Z_tAPTWdw-bvwTjz3pzLc,1587
+pytz-2021.1.dist-info/top_level.txt,sha256=6xRYlt934v1yHb1JIrXgHyGxn3cqACvd-yE8ski_kcc,5
+pytz-2021.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pytz/__init__.py,sha256=kA0Hlp5D5MTPPuf88KVg8pYRwJRGxTQJJuVN794hwsU,35147
+pytz/__pycache__/__init__.cpython-38.pyc,,
+pytz/__pycache__/exceptions.cpython-38.pyc,,
+pytz/__pycache__/lazy.cpython-38.pyc,,
+pytz/__pycache__/reference.cpython-38.pyc,,
+pytz/__pycache__/tzfile.cpython-38.pyc,,
+pytz/__pycache__/tzinfo.cpython-38.pyc,,
+pytz/exceptions.py,sha256=434ZcuLlpLQY9mWoGq7zJMV1TyiYvVgpKBU1qZkbDjM,1571
+pytz/lazy.py,sha256=toeR5uDWKBj6ezsUZ4elNP6CEMtK7CO2jS9A30nsFbo,5404
+pytz/reference.py,sha256=zUtCki7JFEmrzrjNsfMD7YL0lWDxynKc1Ubo4iXSs74,3778
+pytz/tzfile.py,sha256=K2y7pZs4vydpZVftrfAA_-hgw17y1Szc7z_QCse6udU,4723
+pytz/tzinfo.py,sha256=-5UjW-yqHbtO5NtSaWope7EbSdf2oTES26Kdlxjqdk0,19272
+pytz/zoneinfo/Africa/Abidjan,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Accra,sha256=c0Z3DcevVpxyT9HOgW1xSf_f8-MDQgBZ-qFVfMlZ4RU,1060
+pytz/zoneinfo/Africa/Addis_Ababa,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Algiers,sha256=vaFpjNVCwObnbfu82rOQzdJvN6nVgmpXpQ1aqzfzsqY,735
+pytz/zoneinfo/Africa/Asmara,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Asmera,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Bamako,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Bangui,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Banjul,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Bissau,sha256=IjuxDP6EZiDHFvl_bHS6NN7sdRxLKXllooBC829poak,194
+pytz/zoneinfo/Africa/Blantyre,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Brazzaville,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Bujumbura,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Cairo,sha256=L6zLQLnQtLkEELOGfm6USaHY33qAEPgGV822-iU1vxc,1955
+pytz/zoneinfo/Africa/Casablanca,sha256=qzlDyFvkLZWy8Bydogdx_cxZCkWzRwEEsuVWstJI_-s,2429
+pytz/zoneinfo/Africa/Ceuta,sha256=jp7xqONgZ3NPnElHzJEVusHKM9rxDK1nxJm4-i7Ln8o,2036
+pytz/zoneinfo/Africa/Conakry,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Dakar,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Dar_es_Salaam,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Djibouti,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Douala,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/El_Aaiun,sha256=Ja0t5t3QHHrvY0EGgxadypAabj4GjMLuQTTbOAur5M0,2295
+pytz/zoneinfo/Africa/Freetown,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Gaborone,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Harare,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Johannesburg,sha256=bBvMdSZo53WFowiuhUO9C8zY6BOGViboCb-U8_49l34,246
+pytz/zoneinfo/Africa/Juba,sha256=UVnIqEPJwHLTMC-r5qZQHNv9opoYVsKdq-ta_5XUw_Q,679
+pytz/zoneinfo/Africa/Kampala,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Khartoum,sha256=MYWDoJ3AcCItZdApoeOgtWWDDxquwTon5v5TOGP70-o,679
+pytz/zoneinfo/Africa/Kigali,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Kinshasa,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Lagos,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Libreville,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Lome,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Luanda,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Lubumbashi,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Lusaka,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Malabo,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Maputo,sha256=k_GelVHViGiuWCB1LSyTpIYSTDZEY9yclInQRY-LxoI,149
+pytz/zoneinfo/Africa/Maseru,sha256=bBvMdSZo53WFowiuhUO9C8zY6BOGViboCb-U8_49l34,246
+pytz/zoneinfo/Africa/Mbabane,sha256=bBvMdSZo53WFowiuhUO9C8zY6BOGViboCb-U8_49l34,246
+pytz/zoneinfo/Africa/Mogadishu,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Monrovia,sha256=-VsJW5cU4KdvfgYaQVv4lcuzmaKIVFMd42nO6RXOBdU,208
+pytz/zoneinfo/Africa/Nairobi,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Africa/Ndjamena,sha256=8T3A0Zm9Gj0Bvm6rd88t3GAXKiKdGUfHlIqYlkYI0KM,199
+pytz/zoneinfo/Africa/Niamey,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Nouakchott,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Ouagadougou,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Porto-Novo,sha256=z_6wKCzL1_ug5JP_hneh5abdUZeIUELkN_ladz-ESEY,235
+pytz/zoneinfo/Africa/Sao_Tome,sha256=MdjxpQ268uzJ7Zx1ZroFUtRUwqsJ6F_yY3AYV9FXw1I,254
+pytz/zoneinfo/Africa/Timbuktu,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Africa/Tripoli,sha256=W1dptGD70T7ppGoo0fczFQeDiIp0nultLNPV66MwB2c,625
+pytz/zoneinfo/Africa/Tunis,sha256=OFVMEM4eYT2Ez0beuhEUCTSIpcFldWxsV2uEoTZIUNI,689
+pytz/zoneinfo/Africa/Windhoek,sha256=xuhvudrMH4alnVmouSTQI8YL8F_HbgsF2EQ7AZKzuHs,955
+pytz/zoneinfo/America/Adak,sha256=IB1DhwJQAKbhPJ9jHLf8zW5Dad7HIkBS-dhv64E1OlM,2356
+pytz/zoneinfo/America/Anchorage,sha256=oZA1NSPS2BWdymYpnCHFO8BlYVS-ll5KLg2Ez9CbETs,2371
+pytz/zoneinfo/America/Anguilla,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Antigua,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Araguaina,sha256=kppiiytmSQeesflyNGYM3r8NVUl1C-ggu08s9_Tt-co,884
+pytz/zoneinfo/America/Argentina/Buenos_Aires,sha256=ntn_GFHadbrFJ4ZuhU6h2uzbFwmDyS9mXV5S28pkGF8,1076
+pytz/zoneinfo/America/Argentina/Catamarca,sha256=diH1f96kbbY-7gJYQnSCNHs3n9dwHJqUhSdGNx1L7I0,1076
+pytz/zoneinfo/America/Argentina/ComodRivadavia,sha256=diH1f96kbbY-7gJYQnSCNHs3n9dwHJqUhSdGNx1L7I0,1076
+pytz/zoneinfo/America/Argentina/Cordoba,sha256=1XqIP8Qo2bPR7909hrAI-qAttybmwEW4ms7FjZA5Yfw,1076
+pytz/zoneinfo/America/Argentina/Jujuy,sha256=5HR0TlZFifwJ5nLTmg7yWXgCTx9mRhahfs4_Wq70wOY,1048
+pytz/zoneinfo/America/Argentina/La_Rioja,sha256=Zf_E3akFE1YUt9MZ4xxbRnOrp2bH1D-Bjsc0SLFfRyU,1090
+pytz/zoneinfo/America/Argentina/Mendoza,sha256=5DJiYYeQpcLBR_IoIJtk43IswJeGYawx5GykszuJ-Nw,1076
+pytz/zoneinfo/America/Argentina/Rio_Gallegos,sha256=T97WADwva6JbxICviNQUt_7iw9c-nloI4QJCscENSck,1076
+pytz/zoneinfo/America/Argentina/Salta,sha256=ATw0uR6szWKPs6jzdn6revS7UxCXD26ORK6jlmsjL18,1048
+pytz/zoneinfo/America/Argentina/San_Juan,sha256=qlW693a0Tnofy-RdcVBuWY3DvTTGxWwcYdKU3Y98pX8,1090
+pytz/zoneinfo/America/Argentina/San_Luis,sha256=WYdcro5-Fe-N6LkQsKwx_1tVozmnBp58DO1-BJs2suo,1102
+pytz/zoneinfo/America/Argentina/Tucuman,sha256=wsjg1a5AM1dP2gjr112k3vt54trcOOM_StF74xzvBJc,1104
+pytz/zoneinfo/America/Argentina/Ushuaia,sha256=9548Vvq_kpw_NX5s65vYuIbqvwGV-PBxqwmcrflLI0U,1076
+pytz/zoneinfo/America/Aruba,sha256=ZGEIylAZ5iy_rIBsXREtH_ZfWRIkLI9dQjP_EIyn3sY,186
+pytz/zoneinfo/America/Asuncion,sha256=FTLtFk6MjJoh5VIDgJ2Sf4B_iNeCDxrV0MWwQL-sOVM,2044
+pytz/zoneinfo/America/Atikokan,sha256=4a94GtPHUdQ-2sdz9WinsKn9V_QiM4XmFj48FTPMeSA,336
+pytz/zoneinfo/America/Atka,sha256=IB1DhwJQAKbhPJ9jHLf8zW5Dad7HIkBS-dhv64E1OlM,2356
+pytz/zoneinfo/America/Bahia,sha256=cmLkSAAzINlzYGXBqADEU3uPgA9S5nt-p1AV3Zy86VY,1024
+pytz/zoneinfo/America/Bahia_Banderas,sha256=BNjbcHSlPsJ4UpJx-gs1hpIyx2ScBieh1nyDuGb0PcE,1546
+pytz/zoneinfo/America/Barbados,sha256=Y0XwBAv5eSAZHNixVIhRvPxNWqP2a1FCH2_z2Vrd-sc,314
+pytz/zoneinfo/America/Belem,sha256=_258hQZLCEXBX8xRLyQSw-AE-jiDmjVwJX32mN5UUEk,576
+pytz/zoneinfo/America/Belize,sha256=pkfLY2KfPchbeJa1pWcXmWAwp4ZlRvxWLVezXnrbkws,1614
+pytz/zoneinfo/America/Blanc-Sablon,sha256=tVN5ZPmIO3vc3_ayowg6qbvjheg4OJtDFT9y8IuW334,298
+pytz/zoneinfo/America/Boa_Vista,sha256=V4VVOkrFUV1qUfVp9E974IOJFmA5QxQrctatTBEb-hs,632
+pytz/zoneinfo/America/Bogota,sha256=ZaQKTZi35AMdlROs0vjEDA_phR8ztJOnjA8aLJZ5tHw,246
+pytz/zoneinfo/America/Boise,sha256=Yv4AXa2nSH_oVo3FZqZCR7V7z7c6WnQgKIUyNUpzGXA,2394
+pytz/zoneinfo/America/Buenos_Aires,sha256=ntn_GFHadbrFJ4ZuhU6h2uzbFwmDyS9mXV5S28pkGF8,1076
+pytz/zoneinfo/America/Cambridge_Bay,sha256=Nanl8yH4SshljhEjDe-PZCYEXbUuuZGmkbAAt2dB-bk,2084
+pytz/zoneinfo/America/Campo_Grande,sha256=5BBENR3_8gJp4F_Uj2RRknvRc4JJWNRPnZU9E7tb8QI,1444
+pytz/zoneinfo/America/Cancun,sha256=YR2U5T6mDGd5xm8EVA_TM1NwSRMYPNYWvV7wuthnX0I,782
+pytz/zoneinfo/America/Caracas,sha256=2NpwXPEtQkI82WCZuQWHXf66VCADcawMpfhKTsuA0x4,264
+pytz/zoneinfo/America/Catamarca,sha256=diH1f96kbbY-7gJYQnSCNHs3n9dwHJqUhSdGNx1L7I0,1076
+pytz/zoneinfo/America/Cayenne,sha256=atVbW5ChJiKQ_q-3kFs-DLTTZa9ptkiHkmJlq4AXoY4,198
+pytz/zoneinfo/America/Cayman,sha256=kayA_pdpMcSQ0FjIzotdcf-m1JYfbKE-qcFT8LC8zqA,182
+pytz/zoneinfo/America/Chicago,sha256=4aZFw-svkMyXmSpNufqzK-xveos-oVJDpEyI8Yu9HQE,3576
+pytz/zoneinfo/America/Chihuahua,sha256=cewXJyEw4KCoz33yl8o2tUJZmugBWH4R0Aovdmuqf-o,1484
+pytz/zoneinfo/America/Coral_Harbour,sha256=4a94GtPHUdQ-2sdz9WinsKn9V_QiM4XmFj48FTPMeSA,336
+pytz/zoneinfo/America/Cordoba,sha256=1XqIP8Qo2bPR7909hrAI-qAttybmwEW4ms7FjZA5Yfw,1076
+pytz/zoneinfo/America/Costa_Rica,sha256=74rYa6lrgIkyls9PkHo8SCYl9oOqiuG5S7MWdnJelP4,316
+pytz/zoneinfo/America/Creston,sha256=dNOa71QgQ2d5uh7cl-xZme-8u3nMR9GJ7PSktWIDORQ,208
+pytz/zoneinfo/America/Cuiaba,sha256=M0FsR8T9s4jFSuzD8Qi6pqtb6Rf2NTzyVHKGZrn56n4,1416
+pytz/zoneinfo/America/Curacao,sha256=ZGEIylAZ5iy_rIBsXREtH_ZfWRIkLI9dQjP_EIyn3sY,186
+pytz/zoneinfo/America/Danmarkshavn,sha256=YRZAfUCoVtaL1L-MYMYMH1wyOaVQnfUo_gFnvMXSuzw,698
+pytz/zoneinfo/America/Dawson,sha256=rAHhyuMuyjf_eyA2SBG76MRBf_fj_xi5FAuiWVQgJhw,1614
+pytz/zoneinfo/America/Dawson_Creek,sha256=aJXCyP4j3ggE4wGCN-LrS9hpD_5zWHzQTeSAKTWEPUM,1050
+pytz/zoneinfo/America/Denver,sha256=6_yPo1_mvnt9DgpPzr0QdHsjdsfUG6ALnagQLML1DSM,2444
+pytz/zoneinfo/America/Detroit,sha256=hecz8yqY2Cj5B61G3gLZdAVZvRgK9l0P90c_gN-uD5g,2230
+pytz/zoneinfo/America/Dominica,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Edmonton,sha256=-TkIfc3QlvaCf0p8COZ43Y1HRBAl-nARUi-JdXeK1vE,2332
+pytz/zoneinfo/America/Eirunepe,sha256=pS90HZzRwH4Tf8ugmKHfiphX7zCPqZkh_0CNb-fEMAM,656
+pytz/zoneinfo/America/El_Salvador,sha256=gvGN8Lkj-sGm2_rs8OUjAMf1oMtKp2Xes6UfWT0WqgU,224
+pytz/zoneinfo/America/Ensenada,sha256=OHHtvy3J70z6wvKBHgPqMEnGs6SXp8fkf0WX9ZiOODk,2342
+pytz/zoneinfo/America/Fort_Nelson,sha256=erfODr3DrSpz65kAdO7Ts2dGbZxvddEP6gx4BX3y2J0,2240
+pytz/zoneinfo/America/Fort_Wayne,sha256=GrNub1_3Um5Qh67wOx58_TEAz4fwAeAlk2AlMTVA_sI,1666
+pytz/zoneinfo/America/Fortaleza,sha256=mITuMrRLRTWyoiF04Oy_UZ8gxZofTpXDblM8t7ch7Sg,716
+pytz/zoneinfo/America/Glace_Bay,sha256=G8DGLGCapH_aYCF_OhaL5Qonf7FOAgAPwelO5htCWBc,2192
+pytz/zoneinfo/America/Godthab,sha256=FtlXWP_hBNuwBHkI2b1yne_tSUJpwLtWLyTHZoFZkmM,1878
+pytz/zoneinfo/America/Goose_Bay,sha256=JgaLueghSvX2g725FOfIgpgvsqxZGykWOhAZWGpQZRY,3210
+pytz/zoneinfo/America/Grand_Turk,sha256=4YOFEPK60Bel2_fCsY6vSZxUcMJKjiKtyOf_Q0khEwU,1834
+pytz/zoneinfo/America/Grenada,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Guadeloupe,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Guatemala,sha256=dugUgCd6QY52yHkHuUP4jRWzo5x439IQigaYCvEF46Q,280
+pytz/zoneinfo/America/Guayaquil,sha256=PbcF4bvGAm-aFwdtGPotJy3kb4NwoyWwxgwL98BeUWA,246
+pytz/zoneinfo/America/Guyana,sha256=mDyb0FtGOpwGPq864vAHX22LY0Pxex94f1wVMyo36d0,236
+pytz/zoneinfo/America/Halifax,sha256=TZpmc5PwWoLfTfQoQ_b3U17BE2iVKSeNkR0Ho8mbTn8,3424
+pytz/zoneinfo/America/Havana,sha256=HUQeAuKBsEkI5SLZjqynXICOUVOajkKzKH5r-Ov5Odc,2416
+pytz/zoneinfo/America/Hermosillo,sha256=9Ij30JYmMscC1XHi4o9v-uSXoUuE8V9zhGz2iV5hVFI,416
+pytz/zoneinfo/America/Indiana/Indianapolis,sha256=GrNub1_3Um5Qh67wOx58_TEAz4fwAeAlk2AlMTVA_sI,1666
+pytz/zoneinfo/America/Indiana/Knox,sha256=BiALShjiOLg1o8mMRWJ1jyTlJkgvwzte7B9WSOvTUNg,2428
+pytz/zoneinfo/America/Indiana/Marengo,sha256=CPYY3XgJFNEzONxei7x04wOGI_b86RAn4jBPewi1HZw,1722
+pytz/zoneinfo/America/Indiana/Petersburg,sha256=axot1SloP27ZWjezmo7kldu9qA2frEtPVqWngcXtft0,1904
+pytz/zoneinfo/America/Indiana/Tell_City,sha256=GrWNjb1i4sbIYlJ8fU0viJ2Q5JmrlvLgcLQILnk3El8,1684
+pytz/zoneinfo/America/Indiana/Vevay,sha256=GGosHbQUoIDOKPZxdal42X40veEITMmrnlKOnLUhb-c,1414
+pytz/zoneinfo/America/Indiana/Vincennes,sha256=gh7LAbHbMD92eo9C_c5IiwQ1fJvxhdJN402Q_4YJdLg,1694
+pytz/zoneinfo/America/Indiana/Winamac,sha256=yS-_aKSC4crd0WdNutkHRHxUjmBCU56QVQcqy7kYpbQ,1778
+pytz/zoneinfo/America/Indianapolis,sha256=GrNub1_3Um5Qh67wOx58_TEAz4fwAeAlk2AlMTVA_sI,1666
+pytz/zoneinfo/America/Inuvik,sha256=MU_oDiidQaijt1KV0B5h9LqHoCrJ8ieldD9tsiJiX5o,1894
+pytz/zoneinfo/America/Iqaluit,sha256=6PitEMSFWcSb-Io8fvm4oQ_7v39G_qANc6reTjXoZJ0,2032
+pytz/zoneinfo/America/Jamaica,sha256=wlagieUPRf5-beie-h7QsONbNzjGsm8vMs8uf28pw28,482
+pytz/zoneinfo/America/Jujuy,sha256=5HR0TlZFifwJ5nLTmg7yWXgCTx9mRhahfs4_Wq70wOY,1048
+pytz/zoneinfo/America/Juneau,sha256=k7hxb0aGRnfnE-DBi3LkcjAzRPyAf0_Hw0vVFfjGeb0,2353
+pytz/zoneinfo/America/Kentucky/Louisville,sha256=-yqgeeHZdq6oP3_WzVvYOmqV9HQv8y7ZWmc9bzHvJAY,2772
+pytz/zoneinfo/America/Kentucky/Monticello,sha256=NJMKjG7jjlRzZhndMPw51bYW0D3jviW2Qbl70YcU0Gg,2352
+pytz/zoneinfo/America/Knox_IN,sha256=BiALShjiOLg1o8mMRWJ1jyTlJkgvwzte7B9WSOvTUNg,2428
+pytz/zoneinfo/America/Kralendijk,sha256=ZGEIylAZ5iy_rIBsXREtH_ZfWRIkLI9dQjP_EIyn3sY,186
+pytz/zoneinfo/America/La_Paz,sha256=PAGF2VU_QOw2xT1Cqdp2P8Aj9hXMVWlCByV7cvfIQ_k,232
+pytz/zoneinfo/America/Lima,sha256=JHDCg95uw6BEu4a4Gfyikm1s8rm8AsYPG8dJxQQNZFs,406
+pytz/zoneinfo/America/Los_Angeles,sha256=VOy1PikdjiVdJ7lukVGzwl8uDxV_KYqznkTm5BLEiDM,2836
+pytz/zoneinfo/America/Louisville,sha256=-yqgeeHZdq6oP3_WzVvYOmqV9HQv8y7ZWmc9bzHvJAY,2772
+pytz/zoneinfo/America/Lower_Princes,sha256=ZGEIylAZ5iy_rIBsXREtH_ZfWRIkLI9dQjP_EIyn3sY,186
+pytz/zoneinfo/America/Maceio,sha256=pzjNghmeHhvF4aI3cDq2G_5t71BSNGIbRAF5NmJyDmw,744
+pytz/zoneinfo/America/Managua,sha256=xBzF01AHn2E2fD8Qdy-DHFe36UqoeNpKPfChduBKWdk,430
+pytz/zoneinfo/America/Manaus,sha256=lp6RlkcXJQ7mSsKqnEgC8svJVrFDJk_16xxvfpNSpK4,604
+pytz/zoneinfo/America/Marigot,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Martinique,sha256=fMs80kOU2YFvC0f9y2eje97JeAtTYBamXrnlTunNLzQ,232
+pytz/zoneinfo/America/Matamoros,sha256=RlEMOT_zvCLQ8s7TNvRE2PnC4H9JrxO7MGxmfu5xPPI,1390
+pytz/zoneinfo/America/Mazatlan,sha256=aIyre-8trAXSHtqxbuu6gDDkWCUjI_SdAKPIjz74M2E,1526
+pytz/zoneinfo/America/Mendoza,sha256=5DJiYYeQpcLBR_IoIJtk43IswJeGYawx5GykszuJ-Nw,1076
+pytz/zoneinfo/America/Menominee,sha256=Arv9WLbfhNcpRsUjHDU757BEdwlp08Gt30AixG3gZ04,2274
+pytz/zoneinfo/America/Merida,sha256=BJQ5mzAT-akb_EA7WqGdNheCorDqLBnDS_4X3YJz0rc,1422
+pytz/zoneinfo/America/Metlakatla,sha256=twmieGTVY2V-U8nFxqvx7asYv8GVjeWdLtrOI7UApVI,1423
+pytz/zoneinfo/America/Mexico_City,sha256=DSpTe5TT0KBsxGx79Rs7ah-zJpiGOJKwPjztovRN0b4,1584
+pytz/zoneinfo/America/Miquelon,sha256=LNbkN87EnZUa41Xizko5VIN55EyQvf5Kk5b5AfNQG8Q,1666
+pytz/zoneinfo/America/Moncton,sha256=Wmv-bk9aKKcWWzOpc1UFu67HOfwaIk2Wmh3LgqGctys,3154
+pytz/zoneinfo/America/Monterrey,sha256=HA4yn9jQHk9i0PqiB7fSoFdzXtB1DT1cheGRPXrQNdQ,1390
+pytz/zoneinfo/America/Montevideo,sha256=4jcgTegK5X8F0yNYzk-3oySZ4U9XQ09UbTJ_mlu8N70,1510
+pytz/zoneinfo/America/Montreal,sha256=ggOSzbHkmfgu9wTQzP0MUKsrKMbgveuAeThh1eFl1a0,3494
+pytz/zoneinfo/America/Montserrat,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Nassau,sha256=MEpB_L1x3UnwwqjOwNqDvCfgQYPOnhB2jewLwiOxV4g,2388
+pytz/zoneinfo/America/New_York,sha256=7AoiEGjr3wV4P7C4Qs35COZqwr2mjNDq7ocpsSPFOM8,3536
+pytz/zoneinfo/America/Nipigon,sha256=EGPXcOin8mfzFTkYJm4ICpY7fyE24I2pXg4ejafSMyU,2122
+pytz/zoneinfo/America/Nome,sha256=2izM3-P-PqJ9za6MdhzFfMvPFNq7Gim69tAvEwPeY2s,2367
+pytz/zoneinfo/America/Noronha,sha256=3R4lLV8jg5SljhC5OVVCk51Y77Efjo6zCe-oppg_FFo,716
+pytz/zoneinfo/America/North_Dakota/Beulah,sha256=PHlzEk3wsNXYsfMZZSio7ZfdnyxPFpOhK3dS-1AJKGg,2380
+pytz/zoneinfo/America/North_Dakota/Center,sha256=PaM52_JOVMEpVdw5qiOlhkp3qA0xp0d6Z9neOatmLKo,2380
+pytz/zoneinfo/America/North_Dakota/New_Salem,sha256=o0xmH1FUh3lVFLtP5Lb9c0PfSyaPTsRvQSQYwnn_yls,2380
+pytz/zoneinfo/America/Nuuk,sha256=FtlXWP_hBNuwBHkI2b1yne_tSUJpwLtWLyTHZoFZkmM,1878
+pytz/zoneinfo/America/Ojinaga,sha256=cO3V-x_1Q-mpbJgKNd6-WTfxDEHBV1aqS4wzVl5A0Q4,1484
+pytz/zoneinfo/America/Panama,sha256=kayA_pdpMcSQ0FjIzotdcf-m1JYfbKE-qcFT8LC8zqA,182
+pytz/zoneinfo/America/Pangnirtung,sha256=P9Kw_I-NxcUYJIr1j40jTn9q7F8TPAE_FqXsfLYF86A,2094
+pytz/zoneinfo/America/Paramaribo,sha256=Hm5tDwUmnoTrTUPEO4WArfSF74ZjywVEocy4kL51FzA,262
+pytz/zoneinfo/America/Phoenix,sha256=nEOwYOnGxENw9zW8m50PGxbtVfTrX3QYAo4x4LgOLfI,328
+pytz/zoneinfo/America/Port-au-Prince,sha256=09ZAJd4IOiMpfdpUuF1U44R_hRt6BvpAkFXOnYO9yOM,1434
+pytz/zoneinfo/America/Port_of_Spain,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Porto_Acre,sha256=17onkm8P_VgMkErjK9rr0qwNni7qp9tgcUZ93g3ltOs,628
+pytz/zoneinfo/America/Porto_Velho,sha256=ZRfzgGEu26hnl3JPtiZLOSFGj_WBSbOKdiLC1xIyc5c,576
+pytz/zoneinfo/America/Puerto_Rico,sha256=hJHlV_-AGoMGUWuMpZRv9fLmghrzFHfrR9fRkcxaZJc,246
+pytz/zoneinfo/America/Punta_Arenas,sha256=kpqStczF3X0yK0lwOcxmwbQM8ZV9MrNktm7orJF-EJc,1902
+pytz/zoneinfo/America/Rainy_River,sha256=r6kx6lD2IzCdygkj-DKyL2tPSn7k0Zil7PSHCBFKOa0,2122
+pytz/zoneinfo/America/Rankin_Inlet,sha256=KpQX97-EuF4MNyxQrtOKP616CK_vjniM-lo14WGVz0c,1892
+pytz/zoneinfo/America/Recife,sha256=ijFN2ZzZe5oBYdl8Ag3SwmGjj2JeVYYX2Vo767g2s6I,716
+pytz/zoneinfo/America/Regina,sha256=yjqT08pHbICYe83H8JmtaDBvCFqRv7Tfze3Y8xuXukw,980
+pytz/zoneinfo/America/Resolute,sha256=VP_u5XsepfSwx7Ou9zjGw2p5Qi10AIA54sP1J2DkppM,1892
+pytz/zoneinfo/America/Rio_Branco,sha256=17onkm8P_VgMkErjK9rr0qwNni7qp9tgcUZ93g3ltOs,628
+pytz/zoneinfo/America/Rosario,sha256=1XqIP8Qo2bPR7909hrAI-qAttybmwEW4ms7FjZA5Yfw,1076
+pytz/zoneinfo/America/Santa_Isabel,sha256=OHHtvy3J70z6wvKBHgPqMEnGs6SXp8fkf0WX9ZiOODk,2342
+pytz/zoneinfo/America/Santarem,sha256=Gl_lI3pPZ57UIYXWcmaTpFqWDA5re6bHh1nWs_Z0-Nc,602
+pytz/zoneinfo/America/Santiago,sha256=GB14PW0xABV283dXc8qL-nnDW-ViFUR3bne7sg0Aido,2529
+pytz/zoneinfo/America/Santo_Domingo,sha256=DKtaEj8fQ92ybITTWU4Bm160S9pzJmUVbjaWRnenxU4,458
+pytz/zoneinfo/America/Sao_Paulo,sha256=cO3VGekMGdSf1y4f_UgkpDMRes26-l1oGUoDglIiUQg,1444
+pytz/zoneinfo/America/Scoresbysund,sha256=dfHb86egoiNykb3bR3OHXpGFPm_Apck8BLiVTCqVAVc,1916
+pytz/zoneinfo/America/Shiprock,sha256=6_yPo1_mvnt9DgpPzr0QdHsjdsfUG6ALnagQLML1DSM,2444
+pytz/zoneinfo/America/Sitka,sha256=aiS7Fk37hZpzZ9VkeJQeF-BqTLRC1QOTCgMAJwT8UxA,2329
+pytz/zoneinfo/America/St_Barthelemy,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/St_Johns,sha256=r1-17uKv27eZ3JsVkw_DLZQbo6wvjuuVu7C2pDsmOgI,3655
+pytz/zoneinfo/America/St_Kitts,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/St_Lucia,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/St_Thomas,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/St_Vincent,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Swift_Current,sha256=RRKOF7vZC8VvYxD8PP4J1_hUPayKBP7Lu80avRkfPDY,560
+pytz/zoneinfo/America/Tegucigalpa,sha256=EzOz7ntTlreMq69JZ2CcAb8Ps98V9bUMN480tpPIyw4,252
+pytz/zoneinfo/America/Thule,sha256=8xuPRaZU8RgO5ECqFYHYmnHioc81sBOailkVu8Y02i8,1502
+pytz/zoneinfo/America/Thunder_Bay,sha256=cJ9lcf2mDZttEx_ttYYoZAJfuGhSsDgNV2PI-ggWdPE,2202
+pytz/zoneinfo/America/Tijuana,sha256=OHHtvy3J70z6wvKBHgPqMEnGs6SXp8fkf0WX9ZiOODk,2342
+pytz/zoneinfo/America/Toronto,sha256=ggOSzbHkmfgu9wTQzP0MUKsrKMbgveuAeThh1eFl1a0,3494
+pytz/zoneinfo/America/Tortola,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Vancouver,sha256=sknKH0jSPWam-DHfM35qXs8Nam7d5TFlkUI9Sgxryyg,2892
+pytz/zoneinfo/America/Virgin,sha256=17gT2eOVMFKJF_sypwDPudkFwGEijrRfkBU-aK3FL60,148
+pytz/zoneinfo/America/Whitehorse,sha256=Kfv607qGHJxXGBP1nPJyNg2_duWrmxhZGFQr82ukgq8,1614
+pytz/zoneinfo/America/Winnipeg,sha256=7P-_YQrneFcon7QKSTOnkiGjEppFDn3Z48MJ1qq8VBw,2868
+pytz/zoneinfo/America/Yakutat,sha256=tFwnKbvwhyyn4LNTAn5ye_JWDdxjCerNDt7oOwUwO2M,2305
+pytz/zoneinfo/America/Yellowknife,sha256=pfFvC8NEy373KbO6r6ec-Gw_O0D2h64mXU1X1AsUDgE,1966
+pytz/zoneinfo/Antarctica/Casey,sha256=a_ShNA5q27F-GNPiFPttIhhdHc1MP485jX6pwRjZ_t0,384
+pytz/zoneinfo/Antarctica/Davis,sha256=6PokyOaaISRTN13sisuGgdt5vG5A2YqNooJpfLTb5SQ,297
+pytz/zoneinfo/Antarctica/DumontDUrville,sha256=g8HQLY-aN3p6az-04KdHOdZYFnN__-8ltHRuY9eQX-I,194
+pytz/zoneinfo/Antarctica/Macquarie,sha256=ie7RlaU8RHTorVVj-MX8StKMqx_oXf4UH2PUqpzcwe0,2260
+pytz/zoneinfo/Antarctica/Mawson,sha256=9TW1g_z0tk5EfeB7K69VJo8agO7-K9ZxWbiqNKnUZNE,199
+pytz/zoneinfo/Antarctica/McMurdo,sha256=gADjoyPo_QISQU6UJrAgcHp3HDaMoOFRdH-d23uBSyc,2437
+pytz/zoneinfo/Antarctica/Palmer,sha256=DW_DXByXg5MnMZ-w1bNdu8b0lKOYD_EgrPRd5EcyEm4,1418
+pytz/zoneinfo/Antarctica/Rothera,sha256=QQI1m1IN4_2e6Bb0z-rOYaOwxp4XjMJDOKM9SFDUPKg,164
+pytz/zoneinfo/Antarctica/South_Pole,sha256=gADjoyPo_QISQU6UJrAgcHp3HDaMoOFRdH-d23uBSyc,2437
+pytz/zoneinfo/Antarctica/Syowa,sha256=VnmdVypdJUhsBw1XuXZEcEQIFmoiqoYcdpl8ht37QgY,165
+pytz/zoneinfo/Antarctica/Troll,sha256=3zrh-P_jMCss9GGwHJJHkypZZydq4mkgo_TDqctn3c4,1162
+pytz/zoneinfo/Antarctica/Vostok,sha256=6tx86WD3MVGJBCbOJUCoA6YlGwCn2BT4B85Zss0vz4Y,165
+pytz/zoneinfo/Arctic/Longyearbyen,sha256=UdCERhj1JYpx3ojmilaRoyVoR4qMA1-PEv6hGwnpsJA,2228
+pytz/zoneinfo/Asia/Aden,sha256=rq9KPj8l0FBnnKn93WkMeA1IngNtTzk5_oV4sEZhc4w,165
+pytz/zoneinfo/Asia/Almaty,sha256=rBIl_pqZNmKZabjEa4mcsLahl9PbAdZJpQMQLVmcfBU,997
+pytz/zoneinfo/Asia/Amman,sha256=bvwhc1hPCGvQMqWzaoCHrCA_y78n3H-Z2t4wHSocuAw,1853
+pytz/zoneinfo/Asia/Anadyr,sha256=hDDTly45ejoVVP9Al07TmKpTACNGJaIPlcXLRbsG_4g,1188
+pytz/zoneinfo/Asia/Aqtau,sha256=A5exZN256JagFJTcasgdCrQ8giOqZ2EFMRVYBWTaqZA,983
+pytz/zoneinfo/Asia/Aqtobe,sha256=LQ7P5LEEe7jbWbjqvzmM79c0o6AdZeCExQS-fOWp8yw,1011
+pytz/zoneinfo/Asia/Ashgabat,sha256=L4DYV2mZWycsYeHIypXzO6ZNY3tD8wjgxfPR2ZPW26c,619
+pytz/zoneinfo/Asia/Ashkhabad,sha256=L4DYV2mZWycsYeHIypXzO6ZNY3tD8wjgxfPR2ZPW26c,619
+pytz/zoneinfo/Asia/Atyrau,sha256=3uEo89ORyDJqQ_TtaQdIf9UPaB8WqIRQVi0geeY9gVE,991
+pytz/zoneinfo/Asia/Baghdad,sha256=lQMSUnOuijbcoTaCqMNnYhnvKtS2IVP_kXFAzePVNDU,983
+pytz/zoneinfo/Asia/Bahrain,sha256=V0rFJdLHIrToJ5Wl28VzVowwCVZoY8ZZSeNp-7kOvjY,199
+pytz/zoneinfo/Asia/Baku,sha256=vhHnliaOdRyNudl0sFJFdLynEg0Hc0I-IiZNfbDeCbM,1227
+pytz/zoneinfo/Asia/Bangkok,sha256=eYq0vh89N1j069URoQvtBu0ndEal6FPrtbF8WCKKpDw,199
+pytz/zoneinfo/Asia/Barnaul,sha256=2c1Cq8XYlBgybRQMP8w0NCf7kaLDrPZtGn4M5iJZbJo,1221
+pytz/zoneinfo/Asia/Beirut,sha256=_Z_2ZAg_iL9vU51JDB8CB04uXBDrf1kLIis-JnXaS2o,2154
+pytz/zoneinfo/Asia/Bishkek,sha256=do_4ki1JvSKupUrvlz9jRkHspDhdvk1D2IkByFskjJM,983
+pytz/zoneinfo/Asia/Brunei,sha256=BMMjwEmZ9rMoNpWfg8IrlLhRbMKbdW48padRF-FGolc,203
+pytz/zoneinfo/Asia/Calcutta,sha256=6Qw0EDbLcgMgDik8s7UTJn4QSjmllPNeGVJU5rwKF88,285
+pytz/zoneinfo/Asia/Chita,sha256=4ICOcAVAEWnP-cdf_YJu1_kCYnYPG2_vYfSbuNI-VwI,1221
+pytz/zoneinfo/Asia/Choibalsan,sha256=sJQAAjiT9VyG73dYhpYkq4tcmfITcPpiAa8YXsDlKag,949
+pytz/zoneinfo/Asia/Chongqing,sha256=ZP_C5DqUQ1oEPAQNHTr36S0DGtx453N68YYbqk7u8-Y,561
+pytz/zoneinfo/Asia/Chungking,sha256=ZP_C5DqUQ1oEPAQNHTr36S0DGtx453N68YYbqk7u8-Y,561
+pytz/zoneinfo/Asia/Colombo,sha256=HGea9jswIIgz7k20LTzbKtQyUun67IP5HvsZrmAJZJY,372
+pytz/zoneinfo/Asia/Dacca,sha256=3K5llGhcpCdZMMcJuomICVv7lZlDRpU4PUb5DtFx8l4,337
+pytz/zoneinfo/Asia/Damascus,sha256=6mcB6bxH1KsLqzb_LmJUT3tUDnq9_ScLFKoMFkcZy3A,2294
+pytz/zoneinfo/Asia/Dhaka,sha256=3K5llGhcpCdZMMcJuomICVv7lZlDRpU4PUb5DtFx8l4,337
+pytz/zoneinfo/Asia/Dili,sha256=ptjbacc9JK0pv2JpD-gHMglrwYNj9LMMIua0U0ZTMUc,227
+pytz/zoneinfo/Asia/Dubai,sha256=-ga0m3ua9Y6kSWREz2_VdtcVAkq83WrW3vxjBI7WNGs,165
+pytz/zoneinfo/Asia/Dushanbe,sha256=FUk9Tt_GimfRulcWamEvuOvA7FQ52YfZqQ2w88qMx6M,591
+pytz/zoneinfo/Asia/Famagusta,sha256=CFrcygd8ude5x6OEtfM_Dw0KYHoxpPPzq46KoHVxjjc,2028
+pytz/zoneinfo/Asia/Gaza,sha256=LPrVQ4DY43CC-2CnMLx6VEt4IP26P6Jw0HRlhbEbXHo,2422
+pytz/zoneinfo/Asia/Harbin,sha256=ZP_C5DqUQ1oEPAQNHTr36S0DGtx453N68YYbqk7u8-Y,561
+pytz/zoneinfo/Asia/Hebron,sha256=dXAP5ZeuPWJZLh6Y41hEz3owiuqElZxn1SKtdWaeKtw,2450
+pytz/zoneinfo/Asia/Ho_Chi_Minh,sha256=L5TXNg6-odIIn-JAyLTR8fKFiUFBNFwy0HzwZchbnm4,351
+pytz/zoneinfo/Asia/Hong_Kong,sha256=UcnFEc9S8hMWl9giVXni4TAhLPWX0H12XvwSt4AJHew,1203
+pytz/zoneinfo/Asia/Hovd,sha256=JUnOos7PNTi2VRKxD6XnaVR3NpuhsX_Pi18rIzVe1xw,891
+pytz/zoneinfo/Asia/Irkutsk,sha256=iUJZCVBjpfB4rNKJOr6g0zUZtccYYk_Gk0wTklx8Yj0,1243
+pytz/zoneinfo/Asia/Istanbul,sha256=2S0A_f7VxvyErJMMCPqK33AChA29IVkMr1o-SpMtMxk,1947
+pytz/zoneinfo/Asia/Jakarta,sha256=_WRgz6Zb6wxIXtMwpKjG4w4PJtDRzkhdrw-3a4NCBFA,355
+pytz/zoneinfo/Asia/Jayapura,sha256=ihzUd-L8HUVqG-Na10MyPE-YYwjVFj-xerqjTN4EJZs,221
+pytz/zoneinfo/Asia/Jerusalem,sha256=JUuWQmW5Tha0pJjw61Q5aN7CX0z4D7ops9OOSnda6Dc,2388
+pytz/zoneinfo/Asia/Kabul,sha256=ial7SvweHTQXDl79MnXm6QHtiw2i7Zt1e5urLXU8Sq8,208
+pytz/zoneinfo/Asia/Kamchatka,sha256=pBA0RbynKTKsMCmf2hJMZ_hgVUPemms-VceMMJ7QC64,1166
+pytz/zoneinfo/Asia/Karachi,sha256=iB-mWMTXUyfBwAkZdz8_UmEw0xsgxIub-KNI7akzhkk,379
+pytz/zoneinfo/Asia/Kashgar,sha256=AEXDJ5PxQOhePZZw1QZl98moDNa-bW3I3WVNQZHBPYA,165
+pytz/zoneinfo/Asia/Kathmandu,sha256=TUeW7rDSifOTSsNxvo9igIYZfGITEZUf-0EjglyRDWs,212
+pytz/zoneinfo/Asia/Katmandu,sha256=TUeW7rDSifOTSsNxvo9igIYZfGITEZUf-0EjglyRDWs,212
+pytz/zoneinfo/Asia/Khandyga,sha256=XYzE2tsE5Say9pg0cHDQkEE9aTuy2piFSLAGx_d-dmM,1271
+pytz/zoneinfo/Asia/Kolkata,sha256=6Qw0EDbLcgMgDik8s7UTJn4QSjmllPNeGVJU5rwKF88,285
+pytz/zoneinfo/Asia/Krasnoyarsk,sha256=nzRw4PI2AiK_Ge854b8U7TSDw0LGQy3ca5YuOOU2XwI,1207
+pytz/zoneinfo/Asia/Kuala_Lumpur,sha256=RfiIYo6sMEkSA8m5iUmyOyJzKZrgRs8ehGuDZwoq88k,383
+pytz/zoneinfo/Asia/Kuching,sha256=KsAtQ0aocINozixwW7CkorY-1PTLlsj7UUnQGQMEYTQ,483
+pytz/zoneinfo/Asia/Kuwait,sha256=rq9KPj8l0FBnnKn93WkMeA1IngNtTzk5_oV4sEZhc4w,165
+pytz/zoneinfo/Asia/Macao,sha256=MvAkRyRsrA2r052ItlyF5bh2FheRjI0jPwg0uIiH2Yk,1227
+pytz/zoneinfo/Asia/Macau,sha256=MvAkRyRsrA2r052ItlyF5bh2FheRjI0jPwg0uIiH2Yk,1227
+pytz/zoneinfo/Asia/Magadan,sha256=cqwjKQt8TlznM1w2DezAZuz1EjeOfLxPeSY19i9zkfQ,1222
+pytz/zoneinfo/Asia/Makassar,sha256=OhJtCqSTEU-u5n0opBVO5Bu-wQzcYPy9S_6aAhJXgOw,254
+pytz/zoneinfo/Asia/Manila,sha256=ujfq0kl1EhxcYSOrG-FS750aNaYUt1TT4bFuK4EcL_c,328
+pytz/zoneinfo/Asia/Muscat,sha256=-ga0m3ua9Y6kSWREz2_VdtcVAkq83WrW3vxjBI7WNGs,165
+pytz/zoneinfo/Asia/Nicosia,sha256=0Unm0IFT7HyGeQ7F3vTa_-klfysCgrulqFO6BD1plZU,2002
+pytz/zoneinfo/Asia/Novokuznetsk,sha256=vQGcqKdmYmWDdl73QPZTcyadnope1RPJ4oBgZelQu90,1165
+pytz/zoneinfo/Asia/Novosibirsk,sha256=ApL3s20HX2eIAno03HCa2RXdlLotVb9JvnZl7W1sM00,1221
+pytz/zoneinfo/Asia/Omsk,sha256=wxbEesfe7dJOkNPffqTwT6wuTSSTM6E9f0uFMAyzMCM,1207
+pytz/zoneinfo/Asia/Oral,sha256=iMjqD4LvDgyxN15v7CqyEdBDyBFaOlChwX1wHz2JiVQ,1005
+pytz/zoneinfo/Asia/Phnom_Penh,sha256=eYq0vh89N1j069URoQvtBu0ndEal6FPrtbF8WCKKpDw,199
+pytz/zoneinfo/Asia/Pontianak,sha256=inOXwuKtjKv1z_eliPZSIqjSt6whtuxhPeG1YpjU_BQ,353
+pytz/zoneinfo/Asia/Pyongyang,sha256=_-g3GnDAtfDX4XAktXH9jFouLUDmOovnjoOfvRpUDsE,237
+pytz/zoneinfo/Asia/Qatar,sha256=V0rFJdLHIrToJ5Wl28VzVowwCVZoY8ZZSeNp-7kOvjY,199
+pytz/zoneinfo/Asia/Qostanay,sha256=UGYEvmZfAAS9D6EMGd0n6-r_Az_zgTDSWLPeHzFLfu0,1011
+pytz/zoneinfo/Asia/Qyzylorda,sha256=aiSRxwoUbQ-TBHf2wcyaOhQb86j3jQpXwcQaSPnAtwU,1025
+pytz/zoneinfo/Asia/Rangoon,sha256=ZHuX-XVHr8dGJjrPQ5cW7b8jQUv3ihyd-VzN545mlMA,268
+pytz/zoneinfo/Asia/Riyadh,sha256=rq9KPj8l0FBnnKn93WkMeA1IngNtTzk5_oV4sEZhc4w,165
+pytz/zoneinfo/Asia/Saigon,sha256=L5TXNg6-odIIn-JAyLTR8fKFiUFBNFwy0HzwZchbnm4,351
+pytz/zoneinfo/Asia/Sakhalin,sha256=95AdPwOgSe0g9wdx67kKLDbjvY3FtpeVBoAWbJVco0w,1202
+pytz/zoneinfo/Asia/Samarkand,sha256=BBe6Gg_KlSQuS5hAyvvhZWmClcLJaFjnCNGC391HHQM,577
+pytz/zoneinfo/Asia/Seoul,sha256=LI9LsV3XcJC0l-KoQf8zI-y7rk-du57erS-N2Ptdi7Q,617
+pytz/zoneinfo/Asia/Shanghai,sha256=ZP_C5DqUQ1oEPAQNHTr36S0DGtx453N68YYbqk7u8-Y,561
+pytz/zoneinfo/Asia/Singapore,sha256=hIgr_LHMTWh3GgeG-MmLHBp-9anUxQcfMlKFtX8WvmU,383
+pytz/zoneinfo/Asia/Srednekolymsk,sha256=0DllW8q5VgXEMV5c_nLJElZsNpauvNhNACQpcgdqEl0,1208
+pytz/zoneinfo/Asia/Taipei,sha256=DMmQwOpPql25ue3Nf8vAKKT4em06D1Z9rHbLIitxixk,761
+pytz/zoneinfo/Asia/Tashkent,sha256=LS-yTxh0v1vmJoQ9I6fY-IERk7ukPmovVx2Ut_-b-Ig,591
+pytz/zoneinfo/Asia/Tbilisi,sha256=w6UNxgyn4BVVTF5WkAtxo_u7nnIY26makKQ5nRgifds,1035
+pytz/zoneinfo/Asia/Tehran,sha256=ATT50Q0hK6uSba5_WnOE3Px0OWxIwxaqK5Oi10P2A-M,2582
+pytz/zoneinfo/Asia/Tel_Aviv,sha256=JUuWQmW5Tha0pJjw61Q5aN7CX0z4D7ops9OOSnda6Dc,2388
+pytz/zoneinfo/Asia/Thimbu,sha256=uia8or5dtDkxVUZrcLwkjbTz9C7ZhLq0T4jlE4YvuvQ,203
+pytz/zoneinfo/Asia/Thimphu,sha256=uia8or5dtDkxVUZrcLwkjbTz9C7ZhLq0T4jlE4YvuvQ,203
+pytz/zoneinfo/Asia/Tokyo,sha256=oCueZgRNxcNcX3ZGdif9y6Su4cyVhga4XHdwlcrYLOs,309
+pytz/zoneinfo/Asia/Tomsk,sha256=77YgdJLxETRKjQjnaHHf54xBAqNywTDwQQmZ5v6Aq28,1221
+pytz/zoneinfo/Asia/Ujung_Pandang,sha256=OhJtCqSTEU-u5n0opBVO5Bu-wQzcYPy9S_6aAhJXgOw,254
+pytz/zoneinfo/Asia/Ulaanbaatar,sha256=uyQSzIBl0f2TXHrmUm3VPs1C9ro013hYmAlx6yUjh3Y,891
+pytz/zoneinfo/Asia/Ulan_Bator,sha256=uyQSzIBl0f2TXHrmUm3VPs1C9ro013hYmAlx6yUjh3Y,891
+pytz/zoneinfo/Asia/Urumqi,sha256=AEXDJ5PxQOhePZZw1QZl98moDNa-bW3I3WVNQZHBPYA,165
+pytz/zoneinfo/Asia/Ust-Nera,sha256=JAZhRAPdbOL9AL-WHOL8aZjxdZxLmGDNBGMCw9TKtR8,1252
+pytz/zoneinfo/Asia/Vientiane,sha256=eYq0vh89N1j069URoQvtBu0ndEal6FPrtbF8WCKKpDw,199
+pytz/zoneinfo/Asia/Vladivostok,sha256=Wokhgtj2nwUj992h7SyfB_fRNHAKfPNzhsf_oZpim8c,1208
+pytz/zoneinfo/Asia/Yakutsk,sha256=RVCIl52EvMrp2RG2hg2cjDSr9QhsscaAT-NV81xw7zc,1207
+pytz/zoneinfo/Asia/Yangon,sha256=ZHuX-XVHr8dGJjrPQ5cW7b8jQUv3ihyd-VzN545mlMA,268
+pytz/zoneinfo/Asia/Yekaterinburg,sha256=NzVc2DiPeyw0FdMHwSPQJF9k3tvWdtrETZiN58pyxLk,1243
+pytz/zoneinfo/Asia/Yerevan,sha256=k0WHtWQW_cBCjcEv8nP01cVPeTVDlf18lQ0_u6cin1o,1151
+pytz/zoneinfo/Atlantic/Azores,sha256=ut7TdE-xiQNjRybg56Tt5b7Zo5zqbuF5IFci2aDMs1Q,3484
+pytz/zoneinfo/Atlantic/Bermuda,sha256=LNGKfMsnYvwImjTyzXrLhMOHHDu7qI67RbYNKvvI15I,2396
+pytz/zoneinfo/Atlantic/Canary,sha256=ymK9ufqphvNjDK3hzikN4GfkcR3QeCBiPKyVc6FjlbA,1897
+pytz/zoneinfo/Atlantic/Cape_Verde,sha256=ESQvE3deMI-lx9mG0yJLEsFX5KRl-7c6gD5O2h0Zm9Q,270
+pytz/zoneinfo/Atlantic/Faeroe,sha256=NibdZPZtapnYR_myIZnMdTaSKGsOBGgujj0_T2NvAzs,1815
+pytz/zoneinfo/Atlantic/Faroe,sha256=NibdZPZtapnYR_myIZnMdTaSKGsOBGgujj0_T2NvAzs,1815
+pytz/zoneinfo/Atlantic/Jan_Mayen,sha256=UdCERhj1JYpx3ojmilaRoyVoR4qMA1-PEv6hGwnpsJA,2228
+pytz/zoneinfo/Atlantic/Madeira,sha256=e1K2l8ykd8xpznQNs3SSuIZ1ZfVx2Y69EXrhvYV3P14,3475
+pytz/zoneinfo/Atlantic/Reykjavik,sha256=mSkaRBGZLeUrm88EeHcaWnEd35Wn-Ag2G10HtI3G2fg,1162
+pytz/zoneinfo/Atlantic/South_Georgia,sha256=QZ72fRKp6Kgvy7DfyHGht1MVnzGgSPujLQd4XMjNrrc,164
+pytz/zoneinfo/Atlantic/St_Helena,sha256=0u-sTl8j2IyV1ywdtCgHFw9S9D3ZiiBa9akqkbny2Zc,148
+pytz/zoneinfo/Atlantic/Stanley,sha256=exKMLw-P952wS1FTxVjnUU1mkD2OvKUDwtDt8IGgf8w,1214
+pytz/zoneinfo/Australia/ACT,sha256=QsOFdYWxbbL4_9R7oZ-qYPRzNA3o1P6TIOp76GFgWQY,2190
+pytz/zoneinfo/Australia/Adelaide,sha256=ld2EbxU75oVgmPe703z-I6aqLg0Kmv62ZcCGzkT5R20,2208
+pytz/zoneinfo/Australia/Brisbane,sha256=eW6Qzze2t0-speJmmvt1JMzbkSadIKdE84XHc7JUtGc,419
+pytz/zoneinfo/Australia/Broken_Hill,sha256=3k_3ljTvS5GSfo7Xh6w71UgR3aAwYPBsnCJ-mlEYCqQ,2229
+pytz/zoneinfo/Australia/Canberra,sha256=QsOFdYWxbbL4_9R7oZ-qYPRzNA3o1P6TIOp76GFgWQY,2190
+pytz/zoneinfo/Australia/Currie,sha256=GLQSzgIfsWxOvmKOrhpfofWqINQf6h36NYy3mcq6gcg,2358
+pytz/zoneinfo/Australia/Darwin,sha256=fn0IZhIW98FAnzLig-_GBtW5LA54jajdeeUzg4tCGvo,325
+pytz/zoneinfo/Australia/Eucla,sha256=LxEuFWyMse_cALVtRWCkf6sIIEk13jQ4JXW8k2agSd8,470
+pytz/zoneinfo/Australia/Hobart,sha256=GLQSzgIfsWxOvmKOrhpfofWqINQf6h36NYy3mcq6gcg,2358
+pytz/zoneinfo/Australia/LHI,sha256=Luf0Lx_iJHuh3kZd4LxRjf36tLF5-wW2UFMVNKNT7gg,1860
+pytz/zoneinfo/Australia/Lindeman,sha256=xM6Udx22oLNoLR1Y7GQhHOYov8nw3xQNqgc_NVQ2JK4,475
+pytz/zoneinfo/Australia/Lord_Howe,sha256=Luf0Lx_iJHuh3kZd4LxRjf36tLF5-wW2UFMVNKNT7gg,1860
+pytz/zoneinfo/Australia/Melbourne,sha256=lvx_MQcunMc6u2smIrl8X427bLsXvjkgpCSdjYCTNBM,2190
+pytz/zoneinfo/Australia/NSW,sha256=QsOFdYWxbbL4_9R7oZ-qYPRzNA3o1P6TIOp76GFgWQY,2190
+pytz/zoneinfo/Australia/North,sha256=fn0IZhIW98FAnzLig-_GBtW5LA54jajdeeUzg4tCGvo,325
+pytz/zoneinfo/Australia/Perth,sha256=Al1DOUh4U_ofMUQSeVlzSyD3x7SUjP9dchSaBUGmeWg,446
+pytz/zoneinfo/Australia/Queensland,sha256=eW6Qzze2t0-speJmmvt1JMzbkSadIKdE84XHc7JUtGc,419
+pytz/zoneinfo/Australia/South,sha256=ld2EbxU75oVgmPe703z-I6aqLg0Kmv62ZcCGzkT5R20,2208
+pytz/zoneinfo/Australia/Sydney,sha256=QsOFdYWxbbL4_9R7oZ-qYPRzNA3o1P6TIOp76GFgWQY,2190
+pytz/zoneinfo/Australia/Tasmania,sha256=GLQSzgIfsWxOvmKOrhpfofWqINQf6h36NYy3mcq6gcg,2358
+pytz/zoneinfo/Australia/Victoria,sha256=lvx_MQcunMc6u2smIrl8X427bLsXvjkgpCSdjYCTNBM,2190
+pytz/zoneinfo/Australia/West,sha256=Al1DOUh4U_ofMUQSeVlzSyD3x7SUjP9dchSaBUGmeWg,446
+pytz/zoneinfo/Australia/Yancowinna,sha256=3k_3ljTvS5GSfo7Xh6w71UgR3aAwYPBsnCJ-mlEYCqQ,2229
+pytz/zoneinfo/Brazil/Acre,sha256=17onkm8P_VgMkErjK9rr0qwNni7qp9tgcUZ93g3ltOs,628
+pytz/zoneinfo/Brazil/DeNoronha,sha256=3R4lLV8jg5SljhC5OVVCk51Y77Efjo6zCe-oppg_FFo,716
+pytz/zoneinfo/Brazil/East,sha256=cO3VGekMGdSf1y4f_UgkpDMRes26-l1oGUoDglIiUQg,1444
+pytz/zoneinfo/Brazil/West,sha256=lp6RlkcXJQ7mSsKqnEgC8svJVrFDJk_16xxvfpNSpK4,604
+pytz/zoneinfo/CET,sha256=o4omkrM_IsITxooUo8krM921XfBdvRs9JhwGXGd-Ypg,2094
+pytz/zoneinfo/CST6CDT,sha256=WGbtZ1FwjRX6Jeo_TCXKsfeDs4V9uhXGJfcnLJhk3s0,2310
+pytz/zoneinfo/Canada/Atlantic,sha256=TZpmc5PwWoLfTfQoQ_b3U17BE2iVKSeNkR0Ho8mbTn8,3424
+pytz/zoneinfo/Canada/Central,sha256=7P-_YQrneFcon7QKSTOnkiGjEppFDn3Z48MJ1qq8VBw,2868
+pytz/zoneinfo/Canada/Eastern,sha256=ggOSzbHkmfgu9wTQzP0MUKsrKMbgveuAeThh1eFl1a0,3494
+pytz/zoneinfo/Canada/Mountain,sha256=-TkIfc3QlvaCf0p8COZ43Y1HRBAl-nARUi-JdXeK1vE,2332
+pytz/zoneinfo/Canada/Newfoundland,sha256=r1-17uKv27eZ3JsVkw_DLZQbo6wvjuuVu7C2pDsmOgI,3655
+pytz/zoneinfo/Canada/Pacific,sha256=sknKH0jSPWam-DHfM35qXs8Nam7d5TFlkUI9Sgxryyg,2892
+pytz/zoneinfo/Canada/Saskatchewan,sha256=yjqT08pHbICYe83H8JmtaDBvCFqRv7Tfze3Y8xuXukw,980
+pytz/zoneinfo/Canada/Yukon,sha256=Kfv607qGHJxXGBP1nPJyNg2_duWrmxhZGFQr82ukgq8,1614
+pytz/zoneinfo/Chile/Continental,sha256=GB14PW0xABV283dXc8qL-nnDW-ViFUR3bne7sg0Aido,2529
+pytz/zoneinfo/Chile/EasterIsland,sha256=paHp1QRXIa02kgd0-4V6vWXdqcwheow-hJQD9VqacfQ,2233
+pytz/zoneinfo/Cuba,sha256=HUQeAuKBsEkI5SLZjqynXICOUVOajkKzKH5r-Ov5Odc,2416
+pytz/zoneinfo/EET,sha256=gGVsW5-qnI7ty8vqVK1ADWhunrvAT8kUC79GUf-_7G8,1908
+pytz/zoneinfo/EST,sha256=uKE_VPKfxGyYEsyqV_DdE2MW55vs_qUioOdIn5Goobc,114
+pytz/zoneinfo/EST5EDT,sha256=fwzEMT1jgnY2dDjd0EqDl26_7LC-oF48Bd4ng5311H0,2310
+pytz/zoneinfo/Egypt,sha256=L6zLQLnQtLkEELOGfm6USaHY33qAEPgGV822-iU1vxc,1955
+pytz/zoneinfo/Eire,sha256=-JSA3vsi44F1DE8supVjSppH2Vpp12WjJI0_COtAmqU,3492
+pytz/zoneinfo/Etc/GMT,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Etc/GMT+0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Etc/GMT+1,sha256=1Qzl2X9rQ_RXEf11yH09wQZCr_ph6UdFP7E0yu9s-IQ,116
+pytz/zoneinfo/Etc/GMT+10,sha256=JEQyQyQlkC0o6ZTdeVjZhCIOh6cK5TF7H00Pkls-sUI,117
+pytz/zoneinfo/Etc/GMT+11,sha256=tWvcvYMFCaE60nJVvDrrov7stJvs1KQYOyrhl3dzcUs,117
+pytz/zoneinfo/Etc/GMT+12,sha256=b70HEhErq8IJmq8x7cOZy4eR__3fq5uHHpjvPBEHqMA,117
+pytz/zoneinfo/Etc/GMT+2,sha256=T6Ep5zhslBKbYaECFUB6gUKh3iTZPyMoW1kjhonxrUo,116
+pytz/zoneinfo/Etc/GMT+3,sha256=QGoYrE04bUJ-OzL37dt2MZT5FxWNLpJDPVXgJbstYZA,116
+pytz/zoneinfo/Etc/GMT+4,sha256=RWrkNki-wV7X-coe0VvufBe6LrWVpkPJgia5QQYEnBo,116
+pytz/zoneinfo/Etc/GMT+5,sha256=oRmeC41dgYXT-zzyZIRKXN9IvdL2Da5nTuwmG2_prIA,116
+pytz/zoneinfo/Etc/GMT+6,sha256=d6dAnwiejyFI2n7AzFlFW0aFAT6zYNEjBIEG0uu0sbQ,116
+pytz/zoneinfo/Etc/GMT+7,sha256=TqjYbzd0YHpx1wisFg08J19wTpg6ztJLLongZY_lozs,116
+pytz/zoneinfo/Etc/GMT+8,sha256=th_8bIMmYgRPCesBrbmBhRr0jQO7whd70LiY9HfwJyk,116
+pytz/zoneinfo/Etc/GMT+9,sha256=Qq5E6iUS7JMJIymT7YoqlI8MtqtVy0mr9t6zWFtWc9Y,116
+pytz/zoneinfo/Etc/GMT-0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Etc/GMT-1,sha256=73F1eU8uAQGP3mcoB2q99CjfManGFHk3fefljp9pYC4,117
+pytz/zoneinfo/Etc/GMT-10,sha256=fKWWNwLBOp1OkKjtc1w9LIXJR1mTTD-JdvYflRy1IrU,118
+pytz/zoneinfo/Etc/GMT-11,sha256=D2S79n6psa9t9_2vj5wIrFpHH2OJLcCKP6vtwzFZINY,118
+pytz/zoneinfo/Etc/GMT-12,sha256=me4V6lmWI8gSr8H7N41WAD0Eww1anh_EF34Qr9UoSnI,118
+pytz/zoneinfo/Etc/GMT-13,sha256=xbmbG1BQA6Dlpa_iUwEGyJxW4a3t6lmawdPKAE8vbR8,118
+pytz/zoneinfo/Etc/GMT-14,sha256=PpXoREBh02qFpvxVMj2pV9IAzSQvBE7XPvnN9qSZ-Kc,118
+pytz/zoneinfo/Etc/GMT-2,sha256=ve6hWLdeuiLhqagaWLqMD6HNybS1chRwjudfTZ2bYBE,117
+pytz/zoneinfo/Etc/GMT-3,sha256=N77jILanuLDVkLsdujXZSu-dsHiwN5MIpwh7fMUifso,117
+pytz/zoneinfo/Etc/GMT-4,sha256=LSko5fVHqPl5zfwjGqkbMa_OFnvtpT6o_4xYxNz9n5o,117
+pytz/zoneinfo/Etc/GMT-5,sha256=uLaSR5Mb18HRTsAA5SveY9PAJ97dO8QzIWqNXe3wZb4,117
+pytz/zoneinfo/Etc/GMT-6,sha256=JSN-RUAphJ50fpIv7cYC6unrtrz9S1Wma-piDHlGe7c,117
+pytz/zoneinfo/Etc/GMT-7,sha256=vVAOF8xU9T9ESnw68c0SFXpcvkoopaiwTR0zbefHHSU,117
+pytz/zoneinfo/Etc/GMT-8,sha256=S7xFQbFMpiDZy4v5L4D9fCrjRIzzoLC5p8Se23xi7us,117
+pytz/zoneinfo/Etc/GMT-9,sha256=I5vHNmUK-Yyg_S1skFN44VGVzBgktjFgVQiDIKO4aMI,117
+pytz/zoneinfo/Etc/GMT0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Etc/Greenwich,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Etc/UCT,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/Etc/UTC,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/Etc/Universal,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/Etc/Zulu,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/Europe/Amsterdam,sha256=pw8HngVt3bU5QrRzu70qOmf69TIyklkglvVUte9ntKo,2910
+pytz/zoneinfo/Europe/Andorra,sha256=gTB5jCQmvIw3JJi1_vAcOYuhtzPBR6RXUx9gVV6p6ug,1742
+pytz/zoneinfo/Europe/Astrakhan,sha256=ywtzL92KVfoybOmAhE9eHqmMcvJZm5b0js5GDdWIJEQ,1165
+pytz/zoneinfo/Europe/Athens,sha256=XDY-FBUddRyQHN8GxQLZ4awjuOlWlzlUdjv7OdXFNzA,2262
+pytz/zoneinfo/Europe/Belfast,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/Europe/Belgrade,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/Berlin,sha256=XuR19xoPwaMvrrhJ-MOcbnqmbW1B7HQrl7OnQ2s7BwE,2298
+pytz/zoneinfo/Europe/Bratislava,sha256=G9fdhUXmzx651BnyZ6V7AOYIV9EV5aMJMm44eJaLLZw,2301
+pytz/zoneinfo/Europe/Brussels,sha256=gS9Vrrbozend9HhuFetCVrIegs9fXSjaG60X2UVwysA,2933
+pytz/zoneinfo/Europe/Bucharest,sha256=nfg6-bU2D6DMEWb9EMIBR5kxnNsbDSx0UKfHH_ZzqFc,2184
+pytz/zoneinfo/Europe/Budapest,sha256=lNwqxWciBvw9ei81VQwIKHbC_ZDJjpgHU6HFg4wCUkY,2368
+pytz/zoneinfo/Europe/Busingen,sha256=K5QY7Ujj2VUchKR4bhhb0hgdAJhmwED71ykXDQOGKe8,1909
+pytz/zoneinfo/Europe/Chisinau,sha256=p1J_rqFE13pL8cpBRrEFe-teCI8f0fKK4uTUy_4diF4,2390
+pytz/zoneinfo/Europe/Copenhagen,sha256=q7iAbkd7y9QvbAi6XGZEUOTwNDCRYWRu9VQCxUrZ01U,2137
+pytz/zoneinfo/Europe/Dublin,sha256=-JSA3vsi44F1DE8supVjSppH2Vpp12WjJI0_COtAmqU,3492
+pytz/zoneinfo/Europe/Gibraltar,sha256=egOcazf2u1njGZ0tDj-f1NzZT_K5rpUKSqtShxO7U6c,3052
+pytz/zoneinfo/Europe/Guernsey,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/Europe/Helsinki,sha256=GEkB7LsVhmegt7YuuWheCDvDGC7b7Nw9bTdDGS9qkJc,1900
+pytz/zoneinfo/Europe/Isle_of_Man,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/Europe/Istanbul,sha256=2S0A_f7VxvyErJMMCPqK33AChA29IVkMr1o-SpMtMxk,1947
+pytz/zoneinfo/Europe/Jersey,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/Europe/Kaliningrad,sha256=s7GXSe1YvMcs7AiUhHNTA6I4nAOQn_Kmz_ZqJYO-LMM,1493
+pytz/zoneinfo/Europe/Kiev,sha256=iVkTPFkl2tADYapa1HASlaV3tT2VsJpTPTTJC_9HtAk,2088
+pytz/zoneinfo/Europe/Kirov,sha256=Sr4HEUwk3tPTXioeCLhvlgKbCAFU7Gy2UB3f--uWLDc,1153
+pytz/zoneinfo/Europe/Lisbon,sha256=L6n3snx6pNHHJIL6JOLFOAlYkQ2J5uB_y5MG_Ic_PDU,3469
+pytz/zoneinfo/Europe/Ljubljana,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/London,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/Europe/Luxembourg,sha256=974Dvf_X1QISKG1zIiTJJIfGavobO21HUVS-HfysOcY,2946
+pytz/zoneinfo/Europe/Madrid,sha256=MTTMnrbDDtexRikd72-FbQEpCZjc63_UtBIiDomD95c,2614
+pytz/zoneinfo/Europe/Malta,sha256=xRwBfrV8hOihGtqcek5_B6l5hjc206g3yfbEWXIaUis,2620
+pytz/zoneinfo/Europe/Mariehamn,sha256=GEkB7LsVhmegt7YuuWheCDvDGC7b7Nw9bTdDGS9qkJc,1900
+pytz/zoneinfo/Europe/Minsk,sha256=mn86zdrNWpJYDfE51Iy9n1-Zi2piTyb9EPaS2A-uGJQ,1321
+pytz/zoneinfo/Europe/Monaco,sha256=50uVZXYXXqfnr-K4tsSNl26CZbRju65C-STp818wX84,2944
+pytz/zoneinfo/Europe/Moscow,sha256=KmkofRcj6T8Ph28PJChm8JVp13uRvef6TZ0GuPzUiDw,1535
+pytz/zoneinfo/Europe/Nicosia,sha256=0Unm0IFT7HyGeQ7F3vTa_-klfysCgrulqFO6BD1plZU,2002
+pytz/zoneinfo/Europe/Oslo,sha256=UdCERhj1JYpx3ojmilaRoyVoR4qMA1-PEv6hGwnpsJA,2228
+pytz/zoneinfo/Europe/Paris,sha256=q3ehSIot1GZ6TyMHIjbg0oRf4ghAXuwbSDSYVim6evg,2962
+pytz/zoneinfo/Europe/Podgorica,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/Prague,sha256=G9fdhUXmzx651BnyZ6V7AOYIV9EV5aMJMm44eJaLLZw,2301
+pytz/zoneinfo/Europe/Riga,sha256=hJ2_0m1taW9IuA-hMyP5n-WX7YOrR0heKszJhgljRWk,2198
+pytz/zoneinfo/Europe/Rome,sha256=-X5F_d3Dz0kBRWiUTXUN-fgeCHbUEHLaaHIwEPZEdUQ,2641
+pytz/zoneinfo/Europe/Samara,sha256=z2innqSZ8_lkEy8cIyF9JM_FfnO2sWZaqeFqOh8pD7M,1215
+pytz/zoneinfo/Europe/San_Marino,sha256=-X5F_d3Dz0kBRWiUTXUN-fgeCHbUEHLaaHIwEPZEdUQ,2641
+pytz/zoneinfo/Europe/Sarajevo,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/Saratov,sha256=BMej49HlQG24CWCh5VOENrB3jPuJPScPszRtb7MrJ3I,1183
+pytz/zoneinfo/Europe/Simferopol,sha256=_M6LXB5Rqh932nKIJotGjT8YNszAOb7RjHN5ng-uW1Y,1453
+pytz/zoneinfo/Europe/Skopje,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/Sofia,sha256=hCQKXfMNrnA5xHNw_uzTjKzVw4-Bvsq5oGO4yUCv5tY,2077
+pytz/zoneinfo/Europe/Stockholm,sha256=Xgp4GSh8-pzdeJeP8TQ20jWDDUj17R69h6RYTbLYd2g,1909
+pytz/zoneinfo/Europe/Tallinn,sha256=4a6JC0aIpMzqIV7O35zoG0LLJwkQq5AoXZ2ivkic6-w,2148
+pytz/zoneinfo/Europe/Tirane,sha256=ztlZyCS9WCXeVW8nBun3Tyi5HUY0EtFbiBbEc1gucuw,2084
+pytz/zoneinfo/Europe/Tiraspol,sha256=p1J_rqFE13pL8cpBRrEFe-teCI8f0fKK4uTUy_4diF4,2390
+pytz/zoneinfo/Europe/Ulyanovsk,sha256=nFsgcVTmTiiFzHtyJDRnO-3H4GRAfAeceb6b2jFHLUQ,1267
+pytz/zoneinfo/Europe/Uzhgorod,sha256=TIG1rC4QR7nz-vO1VtmN9mDMVjKPDKi7mEB9KpfJOBA,2050
+pytz/zoneinfo/Europe/Vaduz,sha256=K5QY7Ujj2VUchKR4bhhb0hgdAJhmwED71ykXDQOGKe8,1909
+pytz/zoneinfo/Europe/Vatican,sha256=-X5F_d3Dz0kBRWiUTXUN-fgeCHbUEHLaaHIwEPZEdUQ,2641
+pytz/zoneinfo/Europe/Vienna,sha256=ZmI3kADE6bnrJEccqh73XXBY36L1G4DkpiTQImtNrUk,2200
+pytz/zoneinfo/Europe/Vilnius,sha256=UFzRX3orCTB8d9IzlxJPy5eUA2oBPuCu1UJl-2D7C3U,2162
+pytz/zoneinfo/Europe/Volgograd,sha256=XZNEUXwnmGdOTld_9Lug2CFfXbFCJFZC45nOMb59FRk,1165
+pytz/zoneinfo/Europe/Warsaw,sha256=TiLDPbeVF0ckgLVEkaSeDaKZ8wctdJDOl_HE_Wd5rKs,2654
+pytz/zoneinfo/Europe/Zagreb,sha256=OpWtsGFWBE_S-mYoQcAmjCta9HwbGQANnSmVY9OHCTo,1920
+pytz/zoneinfo/Europe/Zaporozhye,sha256=V0dhGl3gET8OftMezf8CVy-W00Z7FtuEev5TjI2Rnyw,2106
+pytz/zoneinfo/Europe/Zurich,sha256=K5QY7Ujj2VUchKR4bhhb0hgdAJhmwED71ykXDQOGKe8,1909
+pytz/zoneinfo/Factory,sha256=aFFlKx93HXoJoF4SSuTlD8cZtJA-ne5oKzAa6eX2V4k,116
+pytz/zoneinfo/GB,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/GB-Eire,sha256=xp08wV44TZMmAdBqppttDChQAb8tRN03GcEht99RYtY,3648
+pytz/zoneinfo/GMT,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/GMT+0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/GMT-0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/GMT0,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/Greenwich,sha256=bZ83iIPAefhsA4elVHqSxEmGnYBuB94QCEqwTwJJAY0,114
+pytz/zoneinfo/HST,sha256=1YkCncvgL9Z5CmUo4Vk8VbQmgA7ZAQ0PtE37j1yOli8,115
+pytz/zoneinfo/Hongkong,sha256=UcnFEc9S8hMWl9giVXni4TAhLPWX0H12XvwSt4AJHew,1203
+pytz/zoneinfo/Iceland,sha256=mSkaRBGZLeUrm88EeHcaWnEd35Wn-Ag2G10HtI3G2fg,1162
+pytz/zoneinfo/Indian/Antananarivo,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Indian/Chagos,sha256=23B26pwwK0gxW7TP76GltyY-RU_o6RGGSrF93pF7S1E,199
+pytz/zoneinfo/Indian/Christmas,sha256=J4I0WDX_LYAJxsx2vU0EdxFJQKRE-rRL1UvNQv09pCs,165
+pytz/zoneinfo/Indian/Cocos,sha256=PX-k8JpghajjvhljtBjWozaiu9NhUSpVeoACy2cAxN8,174
+pytz/zoneinfo/Indian/Comoro,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Indian/Kerguelen,sha256=oIvd6bmQFMLUefoBn4c1fQTOAawGcrPcmge2jU7BsYo,165
+pytz/zoneinfo/Indian/Mahe,sha256=ZNXjaoL_o6572xXgsgSmbd5D_SkaCaayolpSN1je82w,165
+pytz/zoneinfo/Indian/Maldives,sha256=dUQBbrmoB3odWsMt3K1YUnB447A6nkW3aR1aHzdLF7M,199
+pytz/zoneinfo/Indian/Mauritius,sha256=k6vWUVcfU3gS1K12e_aMw6BeSdMvdLyCJRCAL7CD0go,241
+pytz/zoneinfo/Indian/Mayotte,sha256=yJsuJTqJJqbOz37_NOS_zbf-JNr_IthHGMMN7sDqSWg,265
+pytz/zoneinfo/Indian/Reunion,sha256=lHnSVh7CYCuDBEM4dYsWDk006BSAznkCPxjiTtL_WiI,165
+pytz/zoneinfo/Iran,sha256=ATT50Q0hK6uSba5_WnOE3Px0OWxIwxaqK5Oi10P2A-M,2582
+pytz/zoneinfo/Israel,sha256=JUuWQmW5Tha0pJjw61Q5aN7CX0z4D7ops9OOSnda6Dc,2388
+pytz/zoneinfo/Jamaica,sha256=wlagieUPRf5-beie-h7QsONbNzjGsm8vMs8uf28pw28,482
+pytz/zoneinfo/Japan,sha256=oCueZgRNxcNcX3ZGdif9y6Su4cyVhga4XHdwlcrYLOs,309
+pytz/zoneinfo/Kwajalein,sha256=L4nH3qxv5EBKVRxYt67b9IfZfBzg5KJk19iu7x3oBMk,316
+pytz/zoneinfo/Libya,sha256=W1dptGD70T7ppGoo0fczFQeDiIp0nultLNPV66MwB2c,625
+pytz/zoneinfo/MET,sha256=i3CKSuP4N_PAj7o-Cbk8zPEdFs0CWWBCAfg2JXDx5V8,2094
+pytz/zoneinfo/MST,sha256=6IQwvtT12Bz1pTiqFuoVxNY-4ViS7ZrYHo5nPWwzKPw,114
+pytz/zoneinfo/MST7MDT,sha256=910Ek32FKoSyZWY_H19VHaVvqb-JsvnWTOOHvhrKsE0,2310
+pytz/zoneinfo/Mexico/BajaNorte,sha256=OHHtvy3J70z6wvKBHgPqMEnGs6SXp8fkf0WX9ZiOODk,2342
+pytz/zoneinfo/Mexico/BajaSur,sha256=aIyre-8trAXSHtqxbuu6gDDkWCUjI_SdAKPIjz74M2E,1526
+pytz/zoneinfo/Mexico/General,sha256=DSpTe5TT0KBsxGx79Rs7ah-zJpiGOJKwPjztovRN0b4,1584
+pytz/zoneinfo/NZ,sha256=gADjoyPo_QISQU6UJrAgcHp3HDaMoOFRdH-d23uBSyc,2437
+pytz/zoneinfo/NZ-CHAT,sha256=lkVqaSF1WWpv_B2K-k2uJp2setRVK6XbjsQ38gDGVEg,2068
+pytz/zoneinfo/Navajo,sha256=6_yPo1_mvnt9DgpPzr0QdHsjdsfUG6ALnagQLML1DSM,2444
+pytz/zoneinfo/PRC,sha256=ZP_C5DqUQ1oEPAQNHTr36S0DGtx453N68YYbqk7u8-Y,561
+pytz/zoneinfo/PST8PDT,sha256=Q7TCLkE69a6g7mPoPAkqhg-0dStyiAC0jVlM72KG_R8,2310
+pytz/zoneinfo/Pacific/Apia,sha256=p1vFsjfezDCHmPOnmgG47q7wTPM5feosoWN3ucgGnrw,1097
+pytz/zoneinfo/Pacific/Auckland,sha256=gADjoyPo_QISQU6UJrAgcHp3HDaMoOFRdH-d23uBSyc,2437
+pytz/zoneinfo/Pacific/Bougainville,sha256=ZKDa_S_2gSlmOWizV1DqxH3wbE58rfK1vKZHZqrrtjI,268
+pytz/zoneinfo/Pacific/Chatham,sha256=lkVqaSF1WWpv_B2K-k2uJp2setRVK6XbjsQ38gDGVEg,2068
+pytz/zoneinfo/Pacific/Chuuk,sha256=6IYDKViuRDC_RVx1AJOxazVET6cZtdv_LFE6xbtGItI,269
+pytz/zoneinfo/Pacific/Easter,sha256=paHp1QRXIa02kgd0-4V6vWXdqcwheow-hJQD9VqacfQ,2233
+pytz/zoneinfo/Pacific/Efate,sha256=pG4NMVeM3hBJTZnZmqeLqz3Q5oCggTW4HO-R9Fe926A,538
+pytz/zoneinfo/Pacific/Enderbury,sha256=zqW7qAC_6FTcgrGEMhpIsl1oV9I46gY2nH3pwadll68,234
+pytz/zoneinfo/Pacific/Fakaofo,sha256=gow-SgE5r5c8J_Ag5nvJ5SUPDg6yH8pth_a-QLDcPv8,200
+pytz/zoneinfo/Pacific/Fiji,sha256=W6rxVK44zQaoLWLexVRoav16jMcuWYbNskIa5Ld9H-Q,1077
+pytz/zoneinfo/Pacific/Funafuti,sha256=P-XYwlWQpWvS3Q_TYFe37BrgxKJy5tg7PHEQNCDGv5U,166
+pytz/zoneinfo/Pacific/Galapagos,sha256=MdtlC-ffp8reICzDxsQ8tWMsTkq5ZcN-j3OyyhjokV8,238
+pytz/zoneinfo/Pacific/Gambier,sha256=z6eYF8sszLjkfpqmWnbBBAUB-ibaR5nodKaAYbvXOe0,164
+pytz/zoneinfo/Pacific/Guadalcanal,sha256=6GX-XpxcCyA64qUMdxJMFMq4sPk0ZjhexqGbryzfgjE,166
+pytz/zoneinfo/Pacific/Guam,sha256=Ex9znmf6rNfGze6gNpZJCMr1TT4rkl2SnrhecrdJufI,494
+pytz/zoneinfo/Pacific/Honolulu,sha256=fwPRv1Jk56sCOi75uZfd_Iy2k2aSQHx3B2K5xUlSPzM,329
+pytz/zoneinfo/Pacific/Johnston,sha256=fwPRv1Jk56sCOi75uZfd_Iy2k2aSQHx3B2K5xUlSPzM,329
+pytz/zoneinfo/Pacific/Kiritimati,sha256=VHR3iuwiv3tx65WtitVHCoQEg3VJd812VZ5djuSyUxc,238
+pytz/zoneinfo/Pacific/Kosrae,sha256=Vm5AKI6NvuYSz58s8922WNIiWoqPcix2JOJOix1mlSU,351
+pytz/zoneinfo/Pacific/Kwajalein,sha256=L4nH3qxv5EBKVRxYt67b9IfZfBzg5KJk19iu7x3oBMk,316
+pytz/zoneinfo/Pacific/Majuro,sha256=Dwqh7gXoz7Duwu1n7XF8yEjhM4ULEs42LSQyy7F-qzQ,310
+pytz/zoneinfo/Pacific/Marquesas,sha256=uzsjVolutGRXp_FRnvXoU0ApDEb4ZaYoz_r60D7jufg,173
+pytz/zoneinfo/Pacific/Midway,sha256=fCYrYphYY6rUfxOw712y5cyRe104AC3pouqD3bCINFg,175
+pytz/zoneinfo/Pacific/Nauru,sha256=oGxocYsqssZ_EeQHf3cUP5cg0qtqzx1BzoEjVWjE_7g,252
+pytz/zoneinfo/Pacific/Niue,sha256=lSsVlJJ458vNuIgjZESQyatsJV3LpWGyHqbYXMXPjZ4,241
+pytz/zoneinfo/Pacific/Norfolk,sha256=CdEXM9SKYC9Wn7aMxD2sV5i8zE88NQo25Z_L874JthI,880
+pytz/zoneinfo/Pacific/Noumea,sha256=FSanpAOCE7WHQeiop4QErKV9ZC3Tzu2GxkH8-tIXsHY,304
+pytz/zoneinfo/Pacific/Pago_Pago,sha256=fCYrYphYY6rUfxOw712y5cyRe104AC3pouqD3bCINFg,175
+pytz/zoneinfo/Pacific/Palau,sha256=CRW__McXPlOaxo2S9kHMHaBdjv7u59ZWEwYuJConzmQ,180
+pytz/zoneinfo/Pacific/Pitcairn,sha256=O65Ed1FOCF_0rEjpYPAquDwtAF3hxyJNiujgpgZV0kc,202
+pytz/zoneinfo/Pacific/Pohnpei,sha256=YqXrKwjhUnxWyV6PFg1L6_zu84MfPW82dypf0S7pHtQ,303
+pytz/zoneinfo/Pacific/Ponape,sha256=YqXrKwjhUnxWyV6PFg1L6_zu84MfPW82dypf0S7pHtQ,303
+pytz/zoneinfo/Pacific/Port_Moresby,sha256=ei_XjmiRDLh-RU94uvz9CCIIRFH1r0X7WL-sB-6DF60,186
+pytz/zoneinfo/Pacific/Rarotonga,sha256=UfUhlaG0u7yOlzoKnHE9pRiHqQ2N_M9n5WHaCCwtbV4,577
+pytz/zoneinfo/Pacific/Saipan,sha256=Ex9znmf6rNfGze6gNpZJCMr1TT4rkl2SnrhecrdJufI,494
+pytz/zoneinfo/Pacific/Samoa,sha256=fCYrYphYY6rUfxOw712y5cyRe104AC3pouqD3bCINFg,175
+pytz/zoneinfo/Pacific/Tahiti,sha256=9iozXRFYDhBOLijmDk2mRS4Mb-LXWW1u7n790jBNKxM,165
+pytz/zoneinfo/Pacific/Tarawa,sha256=vT6UxW7KeGptdh80Fj9ASATGmLx8Wai630lML4mwg80,166
+pytz/zoneinfo/Pacific/Tongatapu,sha256=ht8ZhdveQXJqsxYtSEcqmRTzXA3OtqYoi4WVBvOPGhw,372
+pytz/zoneinfo/Pacific/Truk,sha256=6IYDKViuRDC_RVx1AJOxazVET6cZtdv_LFE6xbtGItI,269
+pytz/zoneinfo/Pacific/Wake,sha256=dTJxldgcad-kGrODwo4cAHGRSsS-K3fjeZ62WEUhmFk,166
+pytz/zoneinfo/Pacific/Wallis,sha256=CAlw1H5gkER5lkvtmHY-ppoGL3hNmYxfMaXQpI0fTOE,166
+pytz/zoneinfo/Pacific/Yap,sha256=6IYDKViuRDC_RVx1AJOxazVET6cZtdv_LFE6xbtGItI,269
+pytz/zoneinfo/Poland,sha256=TiLDPbeVF0ckgLVEkaSeDaKZ8wctdJDOl_HE_Wd5rKs,2654
+pytz/zoneinfo/Portugal,sha256=L6n3snx6pNHHJIL6JOLFOAlYkQ2J5uB_y5MG_Ic_PDU,3469
+pytz/zoneinfo/ROC,sha256=DMmQwOpPql25ue3Nf8vAKKT4em06D1Z9rHbLIitxixk,761
+pytz/zoneinfo/ROK,sha256=LI9LsV3XcJC0l-KoQf8zI-y7rk-du57erS-N2Ptdi7Q,617
+pytz/zoneinfo/Singapore,sha256=hIgr_LHMTWh3GgeG-MmLHBp-9anUxQcfMlKFtX8WvmU,383
+pytz/zoneinfo/Turkey,sha256=2S0A_f7VxvyErJMMCPqK33AChA29IVkMr1o-SpMtMxk,1947
+pytz/zoneinfo/UCT,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/US/Alaska,sha256=oZA1NSPS2BWdymYpnCHFO8BlYVS-ll5KLg2Ez9CbETs,2371
+pytz/zoneinfo/US/Aleutian,sha256=IB1DhwJQAKbhPJ9jHLf8zW5Dad7HIkBS-dhv64E1OlM,2356
+pytz/zoneinfo/US/Arizona,sha256=nEOwYOnGxENw9zW8m50PGxbtVfTrX3QYAo4x4LgOLfI,328
+pytz/zoneinfo/US/Central,sha256=4aZFw-svkMyXmSpNufqzK-xveos-oVJDpEyI8Yu9HQE,3576
+pytz/zoneinfo/US/East-Indiana,sha256=GrNub1_3Um5Qh67wOx58_TEAz4fwAeAlk2AlMTVA_sI,1666
+pytz/zoneinfo/US/Eastern,sha256=7AoiEGjr3wV4P7C4Qs35COZqwr2mjNDq7ocpsSPFOM8,3536
+pytz/zoneinfo/US/Hawaii,sha256=fwPRv1Jk56sCOi75uZfd_Iy2k2aSQHx3B2K5xUlSPzM,329
+pytz/zoneinfo/US/Indiana-Starke,sha256=BiALShjiOLg1o8mMRWJ1jyTlJkgvwzte7B9WSOvTUNg,2428
+pytz/zoneinfo/US/Michigan,sha256=hecz8yqY2Cj5B61G3gLZdAVZvRgK9l0P90c_gN-uD5g,2230
+pytz/zoneinfo/US/Mountain,sha256=6_yPo1_mvnt9DgpPzr0QdHsjdsfUG6ALnagQLML1DSM,2444
+pytz/zoneinfo/US/Pacific,sha256=VOy1PikdjiVdJ7lukVGzwl8uDxV_KYqznkTm5BLEiDM,2836
+pytz/zoneinfo/US/Samoa,sha256=fCYrYphYY6rUfxOw712y5cyRe104AC3pouqD3bCINFg,175
+pytz/zoneinfo/UTC,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/Universal,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/W-SU,sha256=KmkofRcj6T8Ph28PJChm8JVp13uRvef6TZ0GuPzUiDw,1535
+pytz/zoneinfo/WET,sha256=Sc0l03EfVs_aIi17I4KyZJFkwiAHat5BgpjuuFDhgQ0,1905
+pytz/zoneinfo/Zulu,sha256=i4WEZ5GrLIpUY8g6W-PAQ-JXDXRIQ01BOYlp7Ufj5vI,114
+pytz/zoneinfo/iso3166.tab,sha256=BMh_yY7MXp8DMEy71jarFX3IJSNpwuEyIjIo2HKUXD4,4463
+pytz/zoneinfo/leapseconds,sha256=WFKV3wNak8BTFEaUwFFeLO5bUOa0moZ3S-255JLAank,3392
+pytz/zoneinfo/tzdata.zi,sha256=35McqINLMRv5Nhy80Nw8u3IhmB4nL9cSWWhZiSl3_nk,113161
+pytz/zoneinfo/zone.tab,sha256=2wzsaOCfYuhhMxZsFO9y1ckAPgD4uzBfbff64XV1qWU,19321
+pytz/zoneinfo/zone1970.tab,sha256=EBkiCpmeio73EQXCl7T9lGFBT19NJwWPw8tqkCc0QRI,17835
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..7332a419cda6903b61439f3bac93492b0747e6e7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.30.0)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/metadata.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/metadata.json
new file mode 100644
index 0000000000000000000000000000000000000000..1a0df75f2952f9d8ec77b8f40a4ebe43cad6a6a3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/metadata.json
@@ -0,0 +1 @@
+{"classifiers": ["Development Status :: 6 - Mature", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.4", "Programming Language :: Python :: 2.5", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.1", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Topic :: Software Development :: Libraries :: Python Modules"], "download_url": "https://pypi.org/project/pytz/", "extensions": {"python.details": {"contacts": [{"email": "stuart@stuartbishop.net", "name": "Stuart Bishop", "role": "author"}, {"email": "stuart@stuartbishop.net", "name": "Stuart Bishop", "role": "maintainer"}], "document_names": {"description": "DESCRIPTION.rst", "license": "LICENSE.txt"}, "project_urls": {"Home": "http://pythonhosted.org/pytz"}}}, "generator": "bdist_wheel (0.30.0)", "keywords": ["timezone", "tzinfo", "datetime", "olson", "time"], "license": "MIT", "metadata_version": "2.0", "name": "pytz", "platform": "Independent", "summary": "World timezone definitions, modern and historical", "version": "2021.1"}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..af44f198c687e245aada835efbab2f75ed2c9baf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+pytz
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/zip-safe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/zip-safe
new file mode 100644
index 0000000000000000000000000000000000000000..8b137891791fe96927ad78e64b0aad7bded08bdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz-2021.1.dist-info/zip-safe
@@ -0,0 +1 @@
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2f49fa5362a069bda56a3f2de16c87dbb6d0669
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/__init__.py
@@ -0,0 +1,1558 @@
+'''
+datetime.tzinfo timezone definitions generated from the
+Olson timezone database:
+
+    ftp://elsie.nci.nih.gov/pub/tz*.tar.gz
+
+See the datetime section of the Python Library Reference for information
+on how to use these modules.
+'''
+
+import sys
+import datetime
+import os.path
+
+from pytz.exceptions import AmbiguousTimeError
+from pytz.exceptions import InvalidTimeError
+from pytz.exceptions import NonExistentTimeError
+from pytz.exceptions import UnknownTimeZoneError
+from pytz.lazy import LazyDict, LazyList, LazySet  # noqa
+from pytz.tzinfo import unpickler, BaseTzInfo
+from pytz.tzfile import build_tzinfo
+
+
+# The IANA (nee Olson) database is updated several times a year.
+OLSON_VERSION = '2021a'
+VERSION = '2021.1'  # pip compatible version number.
+__version__ = VERSION
+
+OLSEN_VERSION = OLSON_VERSION  # Old releases had this misspelling
+
+__all__ = [
+    'timezone', 'utc', 'country_timezones', 'country_names',
+    'AmbiguousTimeError', 'InvalidTimeError',
+    'NonExistentTimeError', 'UnknownTimeZoneError',
+    'all_timezones', 'all_timezones_set',
+    'common_timezones', 'common_timezones_set',
+    'BaseTzInfo', 'FixedOffset',
+]
+
+
+if sys.version_info[0] > 2:  # Python 3.x
+
+    # Python 3.x doesn't have unicode(), making writing code
+    # for Python 2.3 and Python 3.x a pain.
+    unicode = str
+
+    def ascii(s):
+        r"""
+        >>> ascii('Hello')
+        'Hello'
+        >>> ascii('\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
+        Traceback (most recent call last):
+            ...
+        UnicodeEncodeError: ...
+        """
+        if type(s) == bytes:
+            s = s.decode('ASCII')
+        else:
+            s.encode('ASCII')  # Raise an exception if not ASCII
+        return s  # But the string - not a byte string.
+
+else:  # Python 2.x
+
+    def ascii(s):
+        r"""
+        >>> ascii('Hello')
+        'Hello'
+        >>> ascii(u'Hello')
+        'Hello'
+        >>> ascii(u'\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
+        Traceback (most recent call last):
+            ...
+        UnicodeEncodeError: ...
+        """
+        return s.encode('ASCII')
+
+
+def open_resource(name):
+    """Open a resource from the zoneinfo subdir for reading.
+
+    Uses the pkg_resources module if available and no standard file
+    found at the calculated location.
+
+    It is possible to specify different location for zoneinfo
+    subdir by using the PYTZ_TZDATADIR environment variable.
+    """
+    name_parts = name.lstrip('/').split('/')
+    for part in name_parts:
+        if part == os.path.pardir or os.path.sep in part:
+            raise ValueError('Bad path segment: %r' % part)
+    zoneinfo_dir = os.environ.get('PYTZ_TZDATADIR', None)
+    if zoneinfo_dir is not None:
+        filename = os.path.join(zoneinfo_dir, *name_parts)
+    else:
+        filename = os.path.join(os.path.dirname(__file__),
+                                'zoneinfo', *name_parts)
+        if not os.path.exists(filename):
+            # http://bugs.launchpad.net/bugs/383171 - we avoid using this
+            # unless absolutely necessary to help when a broken version of
+            # pkg_resources is installed.
+            try:
+                from pkg_resources import resource_stream
+            except ImportError:
+                resource_stream = None
+
+            if resource_stream is not None:
+                return resource_stream(__name__, 'zoneinfo/' + name)
+    return open(filename, 'rb')
+
+
+def resource_exists(name):
+    """Return true if the given resource exists"""
+    try:
+        if os.environ.get('PYTZ_SKIPEXISTSCHECK', ''):
+            # In "standard" distributions, we can assume that
+            # all the listed timezones are present. As an
+            # import-speed optimization, you can set the
+            # PYTZ_SKIPEXISTSCHECK flag to skip checking
+            # for the presence of the resource file on disk.
+            return True
+        open_resource(name).close()
+        return True
+    except IOError:
+        return False
+
+
+_tzinfo_cache = {}
+
+
+def timezone(zone):
+    r''' Return a datetime.tzinfo implementation for the given timezone
+
+    >>> from datetime import datetime, timedelta
+    >>> utc = timezone('UTC')
+    >>> eastern = timezone('US/Eastern')
+    >>> eastern.zone
+    'US/Eastern'
+    >>> timezone(unicode('US/Eastern')) is eastern
+    True
+    >>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
+    >>> loc_dt = utc_dt.astimezone(eastern)
+    >>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
+    >>> loc_dt.strftime(fmt)
+    '2002-10-27 01:00:00 EST (-0500)'
+    >>> (loc_dt - timedelta(minutes=10)).strftime(fmt)
+    '2002-10-27 00:50:00 EST (-0500)'
+    >>> eastern.normalize(loc_dt - timedelta(minutes=10)).strftime(fmt)
+    '2002-10-27 01:50:00 EDT (-0400)'
+    >>> (loc_dt + timedelta(minutes=10)).strftime(fmt)
+    '2002-10-27 01:10:00 EST (-0500)'
+
+    Raises UnknownTimeZoneError if passed an unknown zone.
+
+    >>> try:
+    ...     timezone('Asia/Shangri-La')
+    ... except UnknownTimeZoneError:
+    ...     print('Unknown')
+    Unknown
+
+    >>> try:
+    ...     timezone(unicode('\N{TRADE MARK SIGN}'))
+    ... except UnknownTimeZoneError:
+    ...     print('Unknown')
+    Unknown
+
+    '''
+    if zone is None:
+        raise UnknownTimeZoneError(None)
+
+    if zone.upper() == 'UTC':
+        return utc
+
+    try:
+        zone = ascii(zone)
+    except UnicodeEncodeError:
+        # All valid timezones are ASCII
+        raise UnknownTimeZoneError(zone)
+
+    zone = _case_insensitive_zone_lookup(_unmunge_zone(zone))
+    if zone not in _tzinfo_cache:
+        if zone in all_timezones_set:  # noqa
+            fp = open_resource(zone)
+            try:
+                _tzinfo_cache[zone] = build_tzinfo(zone, fp)
+            finally:
+                fp.close()
+        else:
+            raise UnknownTimeZoneError(zone)
+
+    return _tzinfo_cache[zone]
+
+
+def _unmunge_zone(zone):
+    """Undo the time zone name munging done by older versions of pytz."""
+    return zone.replace('_plus_', '+').replace('_minus_', '-')
+
+
+_all_timezones_lower_to_standard = None
+
+
+def _case_insensitive_zone_lookup(zone):
+    """case-insensitively matching timezone, else return zone unchanged"""
+    global _all_timezones_lower_to_standard
+    if _all_timezones_lower_to_standard is None:
+        _all_timezones_lower_to_standard = dict((tz.lower(), tz) for tz in all_timezones)  # noqa
+    return _all_timezones_lower_to_standard.get(zone.lower()) or zone  # noqa
+
+
+ZERO = datetime.timedelta(0)
+HOUR = datetime.timedelta(hours=1)
+
+
+class UTC(BaseTzInfo):
+    """UTC
+
+    Optimized UTC implementation. It unpickles using the single module global
+    instance defined beneath this class declaration.
+    """
+    zone = "UTC"
+
+    _utcoffset = ZERO
+    _dst = ZERO
+    _tzname = zone
+
+    def fromutc(self, dt):
+        if dt.tzinfo is None:
+            return self.localize(dt)
+        return super(utc.__class__, self).fromutc(dt)
+
+    def utcoffset(self, dt):
+        return ZERO
+
+    def tzname(self, dt):
+        return "UTC"
+
+    def dst(self, dt):
+        return ZERO
+
+    def __reduce__(self):
+        return _UTC, ()
+
+    def localize(self, dt, is_dst=False):
+        '''Convert naive time to local time'''
+        if dt.tzinfo is not None:
+            raise ValueError('Not naive datetime (tzinfo is already set)')
+        return dt.replace(tzinfo=self)
+
+    def normalize(self, dt, is_dst=False):
+        '''Correct the timezone information on the given datetime'''
+        if dt.tzinfo is self:
+            return dt
+        if dt.tzinfo is None:
+            raise ValueError('Naive time - no tzinfo set')
+        return dt.astimezone(self)
+
+    def __repr__(self):
+        return "<UTC>"
+
+    def __str__(self):
+        return "UTC"
+
+
+UTC = utc = UTC()  # UTC is a singleton
+
+
+def _UTC():
+    """Factory function for utc unpickling.
+
+    Makes sure that unpickling a utc instance always returns the same
+    module global.
+
+    These examples belong in the UTC class above, but it is obscured; or in
+    the README.rst, but we are not depending on Python 2.4 so integrating
+    the README.rst examples with the unit tests is not trivial.
+
+    >>> import datetime, pickle
+    >>> dt = datetime.datetime(2005, 3, 1, 14, 13, 21, tzinfo=utc)
+    >>> naive = dt.replace(tzinfo=None)
+    >>> p = pickle.dumps(dt, 1)
+    >>> naive_p = pickle.dumps(naive, 1)
+    >>> len(p) - len(naive_p)
+    17
+    >>> new = pickle.loads(p)
+    >>> new == dt
+    True
+    >>> new is dt
+    False
+    >>> new.tzinfo is dt.tzinfo
+    True
+    >>> utc is UTC is timezone('UTC')
+    True
+    >>> utc is timezone('GMT')
+    False
+    """
+    return utc
+
+
+_UTC.__safe_for_unpickling__ = True
+
+
+def _p(*args):
+    """Factory function for unpickling pytz tzinfo instances.
+
+    Just a wrapper around tzinfo.unpickler to save a few bytes in each pickle
+    by shortening the path.
+    """
+    return unpickler(*args)
+
+
+_p.__safe_for_unpickling__ = True
+
+
+class _CountryTimezoneDict(LazyDict):
+    """Map ISO 3166 country code to a list of timezone names commonly used
+    in that country.
+
+    iso3166_code is the two letter code used to identify the country.
+
+    >>> def print_list(list_of_strings):
+    ...     'We use a helper so doctests work under Python 2.3 -> 3.x'
+    ...     for s in list_of_strings:
+    ...         print(s)
+
+    >>> print_list(country_timezones['nz'])
+    Pacific/Auckland
+    Pacific/Chatham
+    >>> print_list(country_timezones['ch'])
+    Europe/Zurich
+    >>> print_list(country_timezones['CH'])
+    Europe/Zurich
+    >>> print_list(country_timezones[unicode('ch')])
+    Europe/Zurich
+    >>> print_list(country_timezones['XXX'])
+    Traceback (most recent call last):
+    ...
+    KeyError: 'XXX'
+
+    Previously, this information was exposed as a function rather than a
+    dictionary. This is still supported::
+
+    >>> print_list(country_timezones('nz'))
+    Pacific/Auckland
+    Pacific/Chatham
+    """
+    def __call__(self, iso3166_code):
+        """Backwards compatibility."""
+        return self[iso3166_code]
+
+    def _fill(self):
+        data = {}
+        zone_tab = open_resource('zone.tab')
+        try:
+            for line in zone_tab:
+                line = line.decode('UTF-8')
+                if line.startswith('#'):
+                    continue
+                code, coordinates, zone = line.split(None, 4)[:3]
+                if zone not in all_timezones_set:  # noqa
+                    continue
+                try:
+                    data[code].append(zone)
+                except KeyError:
+                    data[code] = [zone]
+            self.data = data
+        finally:
+            zone_tab.close()
+
+
+country_timezones = _CountryTimezoneDict()
+
+
+class _CountryNameDict(LazyDict):
+    '''Dictionary proving ISO3166 code -> English name.
+
+    >>> print(country_names['au'])
+    Australia
+    '''
+    def _fill(self):
+        data = {}
+        zone_tab = open_resource('iso3166.tab')
+        try:
+            for line in zone_tab.readlines():
+                line = line.decode('UTF-8')
+                if line.startswith('#'):
+                    continue
+                code, name = line.split(None, 1)
+                data[code] = name.strip()
+            self.data = data
+        finally:
+            zone_tab.close()
+
+
+country_names = _CountryNameDict()
+
+
+# Time-zone info based solely on fixed offsets
+
+class _FixedOffset(datetime.tzinfo):
+
+    zone = None  # to match the standard pytz API
+
+    def __init__(self, minutes):
+        if abs(minutes) >= 1440:
+            raise ValueError("absolute offset is too large", minutes)
+        self._minutes = minutes
+        self._offset = datetime.timedelta(minutes=minutes)
+
+    def utcoffset(self, dt):
+        return self._offset
+
+    def __reduce__(self):
+        return FixedOffset, (self._minutes, )
+
+    def dst(self, dt):
+        return ZERO
+
+    def tzname(self, dt):
+        return None
+
+    def __repr__(self):
+        return 'pytz.FixedOffset(%d)' % self._minutes
+
+    def localize(self, dt, is_dst=False):
+        '''Convert naive time to local time'''
+        if dt.tzinfo is not None:
+            raise ValueError('Not naive datetime (tzinfo is already set)')
+        return dt.replace(tzinfo=self)
+
+    def normalize(self, dt, is_dst=False):
+        '''Correct the timezone information on the given datetime'''
+        if dt.tzinfo is self:
+            return dt
+        if dt.tzinfo is None:
+            raise ValueError('Naive time - no tzinfo set')
+        return dt.astimezone(self)
+
+
+def FixedOffset(offset, _tzinfos={}):
+    """return a fixed-offset timezone based off a number of minutes.
+
+        >>> one = FixedOffset(-330)
+        >>> one
+        pytz.FixedOffset(-330)
+        >>> str(one.utcoffset(datetime.datetime.now()))
+        '-1 day, 18:30:00'
+        >>> str(one.dst(datetime.datetime.now()))
+        '0:00:00'
+
+        >>> two = FixedOffset(1380)
+        >>> two
+        pytz.FixedOffset(1380)
+        >>> str(two.utcoffset(datetime.datetime.now()))
+        '23:00:00'
+        >>> str(two.dst(datetime.datetime.now()))
+        '0:00:00'
+
+    The datetime.timedelta must be between the range of -1 and 1 day,
+    non-inclusive.
+
+        >>> FixedOffset(1440)
+        Traceback (most recent call last):
+        ...
+        ValueError: ('absolute offset is too large', 1440)
+
+        >>> FixedOffset(-1440)
+        Traceback (most recent call last):
+        ...
+        ValueError: ('absolute offset is too large', -1440)
+
+    An offset of 0 is special-cased to return UTC.
+
+        >>> FixedOffset(0) is UTC
+        True
+
+    There should always be only one instance of a FixedOffset per timedelta.
+    This should be true for multiple creation calls.
+
+        >>> FixedOffset(-330) is one
+        True
+        >>> FixedOffset(1380) is two
+        True
+
+    It should also be true for pickling.
+
+        >>> import pickle
+        >>> pickle.loads(pickle.dumps(one)) is one
+        True
+        >>> pickle.loads(pickle.dumps(two)) is two
+        True
+    """
+    if offset == 0:
+        return UTC
+
+    info = _tzinfos.get(offset)
+    if info is None:
+        # We haven't seen this one before. we need to save it.
+
+        # Use setdefault to avoid a race condition and make sure we have
+        # only one
+        info = _tzinfos.setdefault(offset, _FixedOffset(offset))
+
+    return info
+
+
+FixedOffset.__safe_for_unpickling__ = True
+
+
+def _test():
+    import doctest
+    sys.path.insert(0, os.pardir)
+    import pytz
+    return doctest.testmod(pytz)
+
+
+if __name__ == '__main__':
+    _test()
+all_timezones = \
+['Africa/Abidjan',
+ 'Africa/Accra',
+ 'Africa/Addis_Ababa',
+ 'Africa/Algiers',
+ 'Africa/Asmara',
+ 'Africa/Asmera',
+ 'Africa/Bamako',
+ 'Africa/Bangui',
+ 'Africa/Banjul',
+ 'Africa/Bissau',
+ 'Africa/Blantyre',
+ 'Africa/Brazzaville',
+ 'Africa/Bujumbura',
+ 'Africa/Cairo',
+ 'Africa/Casablanca',
+ 'Africa/Ceuta',
+ 'Africa/Conakry',
+ 'Africa/Dakar',
+ 'Africa/Dar_es_Salaam',
+ 'Africa/Djibouti',
+ 'Africa/Douala',
+ 'Africa/El_Aaiun',
+ 'Africa/Freetown',
+ 'Africa/Gaborone',
+ 'Africa/Harare',
+ 'Africa/Johannesburg',
+ 'Africa/Juba',
+ 'Africa/Kampala',
+ 'Africa/Khartoum',
+ 'Africa/Kigali',
+ 'Africa/Kinshasa',
+ 'Africa/Lagos',
+ 'Africa/Libreville',
+ 'Africa/Lome',
+ 'Africa/Luanda',
+ 'Africa/Lubumbashi',
+ 'Africa/Lusaka',
+ 'Africa/Malabo',
+ 'Africa/Maputo',
+ 'Africa/Maseru',
+ 'Africa/Mbabane',
+ 'Africa/Mogadishu',
+ 'Africa/Monrovia',
+ 'Africa/Nairobi',
+ 'Africa/Ndjamena',
+ 'Africa/Niamey',
+ 'Africa/Nouakchott',
+ 'Africa/Ouagadougou',
+ 'Africa/Porto-Novo',
+ 'Africa/Sao_Tome',
+ 'Africa/Timbuktu',
+ 'Africa/Tripoli',
+ 'Africa/Tunis',
+ 'Africa/Windhoek',
+ 'America/Adak',
+ 'America/Anchorage',
+ 'America/Anguilla',
+ 'America/Antigua',
+ 'America/Araguaina',
+ 'America/Argentina/Buenos_Aires',
+ 'America/Argentina/Catamarca',
+ 'America/Argentina/ComodRivadavia',
+ 'America/Argentina/Cordoba',
+ 'America/Argentina/Jujuy',
+ 'America/Argentina/La_Rioja',
+ 'America/Argentina/Mendoza',
+ 'America/Argentina/Rio_Gallegos',
+ 'America/Argentina/Salta',
+ 'America/Argentina/San_Juan',
+ 'America/Argentina/San_Luis',
+ 'America/Argentina/Tucuman',
+ 'America/Argentina/Ushuaia',
+ 'America/Aruba',
+ 'America/Asuncion',
+ 'America/Atikokan',
+ 'America/Atka',
+ 'America/Bahia',
+ 'America/Bahia_Banderas',
+ 'America/Barbados',
+ 'America/Belem',
+ 'America/Belize',
+ 'America/Blanc-Sablon',
+ 'America/Boa_Vista',
+ 'America/Bogota',
+ 'America/Boise',
+ 'America/Buenos_Aires',
+ 'America/Cambridge_Bay',
+ 'America/Campo_Grande',
+ 'America/Cancun',
+ 'America/Caracas',
+ 'America/Catamarca',
+ 'America/Cayenne',
+ 'America/Cayman',
+ 'America/Chicago',
+ 'America/Chihuahua',
+ 'America/Coral_Harbour',
+ 'America/Cordoba',
+ 'America/Costa_Rica',
+ 'America/Creston',
+ 'America/Cuiaba',
+ 'America/Curacao',
+ 'America/Danmarkshavn',
+ 'America/Dawson',
+ 'America/Dawson_Creek',
+ 'America/Denver',
+ 'America/Detroit',
+ 'America/Dominica',
+ 'America/Edmonton',
+ 'America/Eirunepe',
+ 'America/El_Salvador',
+ 'America/Ensenada',
+ 'America/Fort_Nelson',
+ 'America/Fort_Wayne',
+ 'America/Fortaleza',
+ 'America/Glace_Bay',
+ 'America/Godthab',
+ 'America/Goose_Bay',
+ 'America/Grand_Turk',
+ 'America/Grenada',
+ 'America/Guadeloupe',
+ 'America/Guatemala',
+ 'America/Guayaquil',
+ 'America/Guyana',
+ 'America/Halifax',
+ 'America/Havana',
+ 'America/Hermosillo',
+ 'America/Indiana/Indianapolis',
+ 'America/Indiana/Knox',
+ 'America/Indiana/Marengo',
+ 'America/Indiana/Petersburg',
+ 'America/Indiana/Tell_City',
+ 'America/Indiana/Vevay',
+ 'America/Indiana/Vincennes',
+ 'America/Indiana/Winamac',
+ 'America/Indianapolis',
+ 'America/Inuvik',
+ 'America/Iqaluit',
+ 'America/Jamaica',
+ 'America/Jujuy',
+ 'America/Juneau',
+ 'America/Kentucky/Louisville',
+ 'America/Kentucky/Monticello',
+ 'America/Knox_IN',
+ 'America/Kralendijk',
+ 'America/La_Paz',
+ 'America/Lima',
+ 'America/Los_Angeles',
+ 'America/Louisville',
+ 'America/Lower_Princes',
+ 'America/Maceio',
+ 'America/Managua',
+ 'America/Manaus',
+ 'America/Marigot',
+ 'America/Martinique',
+ 'America/Matamoros',
+ 'America/Mazatlan',
+ 'America/Mendoza',
+ 'America/Menominee',
+ 'America/Merida',
+ 'America/Metlakatla',
+ 'America/Mexico_City',
+ 'America/Miquelon',
+ 'America/Moncton',
+ 'America/Monterrey',
+ 'America/Montevideo',
+ 'America/Montreal',
+ 'America/Montserrat',
+ 'America/Nassau',
+ 'America/New_York',
+ 'America/Nipigon',
+ 'America/Nome',
+ 'America/Noronha',
+ 'America/North_Dakota/Beulah',
+ 'America/North_Dakota/Center',
+ 'America/North_Dakota/New_Salem',
+ 'America/Nuuk',
+ 'America/Ojinaga',
+ 'America/Panama',
+ 'America/Pangnirtung',
+ 'America/Paramaribo',
+ 'America/Phoenix',
+ 'America/Port-au-Prince',
+ 'America/Port_of_Spain',
+ 'America/Porto_Acre',
+ 'America/Porto_Velho',
+ 'America/Puerto_Rico',
+ 'America/Punta_Arenas',
+ 'America/Rainy_River',
+ 'America/Rankin_Inlet',
+ 'America/Recife',
+ 'America/Regina',
+ 'America/Resolute',
+ 'America/Rio_Branco',
+ 'America/Rosario',
+ 'America/Santa_Isabel',
+ 'America/Santarem',
+ 'America/Santiago',
+ 'America/Santo_Domingo',
+ 'America/Sao_Paulo',
+ 'America/Scoresbysund',
+ 'America/Shiprock',
+ 'America/Sitka',
+ 'America/St_Barthelemy',
+ 'America/St_Johns',
+ 'America/St_Kitts',
+ 'America/St_Lucia',
+ 'America/St_Thomas',
+ 'America/St_Vincent',
+ 'America/Swift_Current',
+ 'America/Tegucigalpa',
+ 'America/Thule',
+ 'America/Thunder_Bay',
+ 'America/Tijuana',
+ 'America/Toronto',
+ 'America/Tortola',
+ 'America/Vancouver',
+ 'America/Virgin',
+ 'America/Whitehorse',
+ 'America/Winnipeg',
+ 'America/Yakutat',
+ 'America/Yellowknife',
+ 'Antarctica/Casey',
+ 'Antarctica/Davis',
+ 'Antarctica/DumontDUrville',
+ 'Antarctica/Macquarie',
+ 'Antarctica/Mawson',
+ 'Antarctica/McMurdo',
+ 'Antarctica/Palmer',
+ 'Antarctica/Rothera',
+ 'Antarctica/South_Pole',
+ 'Antarctica/Syowa',
+ 'Antarctica/Troll',
+ 'Antarctica/Vostok',
+ 'Arctic/Longyearbyen',
+ 'Asia/Aden',
+ 'Asia/Almaty',
+ 'Asia/Amman',
+ 'Asia/Anadyr',
+ 'Asia/Aqtau',
+ 'Asia/Aqtobe',
+ 'Asia/Ashgabat',
+ 'Asia/Ashkhabad',
+ 'Asia/Atyrau',
+ 'Asia/Baghdad',
+ 'Asia/Bahrain',
+ 'Asia/Baku',
+ 'Asia/Bangkok',
+ 'Asia/Barnaul',
+ 'Asia/Beirut',
+ 'Asia/Bishkek',
+ 'Asia/Brunei',
+ 'Asia/Calcutta',
+ 'Asia/Chita',
+ 'Asia/Choibalsan',
+ 'Asia/Chongqing',
+ 'Asia/Chungking',
+ 'Asia/Colombo',
+ 'Asia/Dacca',
+ 'Asia/Damascus',
+ 'Asia/Dhaka',
+ 'Asia/Dili',
+ 'Asia/Dubai',
+ 'Asia/Dushanbe',
+ 'Asia/Famagusta',
+ 'Asia/Gaza',
+ 'Asia/Harbin',
+ 'Asia/Hebron',
+ 'Asia/Ho_Chi_Minh',
+ 'Asia/Hong_Kong',
+ 'Asia/Hovd',
+ 'Asia/Irkutsk',
+ 'Asia/Istanbul',
+ 'Asia/Jakarta',
+ 'Asia/Jayapura',
+ 'Asia/Jerusalem',
+ 'Asia/Kabul',
+ 'Asia/Kamchatka',
+ 'Asia/Karachi',
+ 'Asia/Kashgar',
+ 'Asia/Kathmandu',
+ 'Asia/Katmandu',
+ 'Asia/Khandyga',
+ 'Asia/Kolkata',
+ 'Asia/Krasnoyarsk',
+ 'Asia/Kuala_Lumpur',
+ 'Asia/Kuching',
+ 'Asia/Kuwait',
+ 'Asia/Macao',
+ 'Asia/Macau',
+ 'Asia/Magadan',
+ 'Asia/Makassar',
+ 'Asia/Manila',
+ 'Asia/Muscat',
+ 'Asia/Nicosia',
+ 'Asia/Novokuznetsk',
+ 'Asia/Novosibirsk',
+ 'Asia/Omsk',
+ 'Asia/Oral',
+ 'Asia/Phnom_Penh',
+ 'Asia/Pontianak',
+ 'Asia/Pyongyang',
+ 'Asia/Qatar',
+ 'Asia/Qostanay',
+ 'Asia/Qyzylorda',
+ 'Asia/Rangoon',
+ 'Asia/Riyadh',
+ 'Asia/Saigon',
+ 'Asia/Sakhalin',
+ 'Asia/Samarkand',
+ 'Asia/Seoul',
+ 'Asia/Shanghai',
+ 'Asia/Singapore',
+ 'Asia/Srednekolymsk',
+ 'Asia/Taipei',
+ 'Asia/Tashkent',
+ 'Asia/Tbilisi',
+ 'Asia/Tehran',
+ 'Asia/Tel_Aviv',
+ 'Asia/Thimbu',
+ 'Asia/Thimphu',
+ 'Asia/Tokyo',
+ 'Asia/Tomsk',
+ 'Asia/Ujung_Pandang',
+ 'Asia/Ulaanbaatar',
+ 'Asia/Ulan_Bator',
+ 'Asia/Urumqi',
+ 'Asia/Ust-Nera',
+ 'Asia/Vientiane',
+ 'Asia/Vladivostok',
+ 'Asia/Yakutsk',
+ 'Asia/Yangon',
+ 'Asia/Yekaterinburg',
+ 'Asia/Yerevan',
+ 'Atlantic/Azores',
+ 'Atlantic/Bermuda',
+ 'Atlantic/Canary',
+ 'Atlantic/Cape_Verde',
+ 'Atlantic/Faeroe',
+ 'Atlantic/Faroe',
+ 'Atlantic/Jan_Mayen',
+ 'Atlantic/Madeira',
+ 'Atlantic/Reykjavik',
+ 'Atlantic/South_Georgia',
+ 'Atlantic/St_Helena',
+ 'Atlantic/Stanley',
+ 'Australia/ACT',
+ 'Australia/Adelaide',
+ 'Australia/Brisbane',
+ 'Australia/Broken_Hill',
+ 'Australia/Canberra',
+ 'Australia/Currie',
+ 'Australia/Darwin',
+ 'Australia/Eucla',
+ 'Australia/Hobart',
+ 'Australia/LHI',
+ 'Australia/Lindeman',
+ 'Australia/Lord_Howe',
+ 'Australia/Melbourne',
+ 'Australia/NSW',
+ 'Australia/North',
+ 'Australia/Perth',
+ 'Australia/Queensland',
+ 'Australia/South',
+ 'Australia/Sydney',
+ 'Australia/Tasmania',
+ 'Australia/Victoria',
+ 'Australia/West',
+ 'Australia/Yancowinna',
+ 'Brazil/Acre',
+ 'Brazil/DeNoronha',
+ 'Brazil/East',
+ 'Brazil/West',
+ 'CET',
+ 'CST6CDT',
+ 'Canada/Atlantic',
+ 'Canada/Central',
+ 'Canada/Eastern',
+ 'Canada/Mountain',
+ 'Canada/Newfoundland',
+ 'Canada/Pacific',
+ 'Canada/Saskatchewan',
+ 'Canada/Yukon',
+ 'Chile/Continental',
+ 'Chile/EasterIsland',
+ 'Cuba',
+ 'EET',
+ 'EST',
+ 'EST5EDT',
+ 'Egypt',
+ 'Eire',
+ 'Etc/GMT',
+ 'Etc/GMT+0',
+ 'Etc/GMT+1',
+ 'Etc/GMT+10',
+ 'Etc/GMT+11',
+ 'Etc/GMT+12',
+ 'Etc/GMT+2',
+ 'Etc/GMT+3',
+ 'Etc/GMT+4',
+ 'Etc/GMT+5',
+ 'Etc/GMT+6',
+ 'Etc/GMT+7',
+ 'Etc/GMT+8',
+ 'Etc/GMT+9',
+ 'Etc/GMT-0',
+ 'Etc/GMT-1',
+ 'Etc/GMT-10',
+ 'Etc/GMT-11',
+ 'Etc/GMT-12',
+ 'Etc/GMT-13',
+ 'Etc/GMT-14',
+ 'Etc/GMT-2',
+ 'Etc/GMT-3',
+ 'Etc/GMT-4',
+ 'Etc/GMT-5',
+ 'Etc/GMT-6',
+ 'Etc/GMT-7',
+ 'Etc/GMT-8',
+ 'Etc/GMT-9',
+ 'Etc/GMT0',
+ 'Etc/Greenwich',
+ 'Etc/UCT',
+ 'Etc/UTC',
+ 'Etc/Universal',
+ 'Etc/Zulu',
+ 'Europe/Amsterdam',
+ 'Europe/Andorra',
+ 'Europe/Astrakhan',
+ 'Europe/Athens',
+ 'Europe/Belfast',
+ 'Europe/Belgrade',
+ 'Europe/Berlin',
+ 'Europe/Bratislava',
+ 'Europe/Brussels',
+ 'Europe/Bucharest',
+ 'Europe/Budapest',
+ 'Europe/Busingen',
+ 'Europe/Chisinau',
+ 'Europe/Copenhagen',
+ 'Europe/Dublin',
+ 'Europe/Gibraltar',
+ 'Europe/Guernsey',
+ 'Europe/Helsinki',
+ 'Europe/Isle_of_Man',
+ 'Europe/Istanbul',
+ 'Europe/Jersey',
+ 'Europe/Kaliningrad',
+ 'Europe/Kiev',
+ 'Europe/Kirov',
+ 'Europe/Lisbon',
+ 'Europe/Ljubljana',
+ 'Europe/London',
+ 'Europe/Luxembourg',
+ 'Europe/Madrid',
+ 'Europe/Malta',
+ 'Europe/Mariehamn',
+ 'Europe/Minsk',
+ 'Europe/Monaco',
+ 'Europe/Moscow',
+ 'Europe/Nicosia',
+ 'Europe/Oslo',
+ 'Europe/Paris',
+ 'Europe/Podgorica',
+ 'Europe/Prague',
+ 'Europe/Riga',
+ 'Europe/Rome',
+ 'Europe/Samara',
+ 'Europe/San_Marino',
+ 'Europe/Sarajevo',
+ 'Europe/Saratov',
+ 'Europe/Simferopol',
+ 'Europe/Skopje',
+ 'Europe/Sofia',
+ 'Europe/Stockholm',
+ 'Europe/Tallinn',
+ 'Europe/Tirane',
+ 'Europe/Tiraspol',
+ 'Europe/Ulyanovsk',
+ 'Europe/Uzhgorod',
+ 'Europe/Vaduz',
+ 'Europe/Vatican',
+ 'Europe/Vienna',
+ 'Europe/Vilnius',
+ 'Europe/Volgograd',
+ 'Europe/Warsaw',
+ 'Europe/Zagreb',
+ 'Europe/Zaporozhye',
+ 'Europe/Zurich',
+ 'GB',
+ 'GB-Eire',
+ 'GMT',
+ 'GMT+0',
+ 'GMT-0',
+ 'GMT0',
+ 'Greenwich',
+ 'HST',
+ 'Hongkong',
+ 'Iceland',
+ 'Indian/Antananarivo',
+ 'Indian/Chagos',
+ 'Indian/Christmas',
+ 'Indian/Cocos',
+ 'Indian/Comoro',
+ 'Indian/Kerguelen',
+ 'Indian/Mahe',
+ 'Indian/Maldives',
+ 'Indian/Mauritius',
+ 'Indian/Mayotte',
+ 'Indian/Reunion',
+ 'Iran',
+ 'Israel',
+ 'Jamaica',
+ 'Japan',
+ 'Kwajalein',
+ 'Libya',
+ 'MET',
+ 'MST',
+ 'MST7MDT',
+ 'Mexico/BajaNorte',
+ 'Mexico/BajaSur',
+ 'Mexico/General',
+ 'NZ',
+ 'NZ-CHAT',
+ 'Navajo',
+ 'PRC',
+ 'PST8PDT',
+ 'Pacific/Apia',
+ 'Pacific/Auckland',
+ 'Pacific/Bougainville',
+ 'Pacific/Chatham',
+ 'Pacific/Chuuk',
+ 'Pacific/Easter',
+ 'Pacific/Efate',
+ 'Pacific/Enderbury',
+ 'Pacific/Fakaofo',
+ 'Pacific/Fiji',
+ 'Pacific/Funafuti',
+ 'Pacific/Galapagos',
+ 'Pacific/Gambier',
+ 'Pacific/Guadalcanal',
+ 'Pacific/Guam',
+ 'Pacific/Honolulu',
+ 'Pacific/Johnston',
+ 'Pacific/Kiritimati',
+ 'Pacific/Kosrae',
+ 'Pacific/Kwajalein',
+ 'Pacific/Majuro',
+ 'Pacific/Marquesas',
+ 'Pacific/Midway',
+ 'Pacific/Nauru',
+ 'Pacific/Niue',
+ 'Pacific/Norfolk',
+ 'Pacific/Noumea',
+ 'Pacific/Pago_Pago',
+ 'Pacific/Palau',
+ 'Pacific/Pitcairn',
+ 'Pacific/Pohnpei',
+ 'Pacific/Ponape',
+ 'Pacific/Port_Moresby',
+ 'Pacific/Rarotonga',
+ 'Pacific/Saipan',
+ 'Pacific/Samoa',
+ 'Pacific/Tahiti',
+ 'Pacific/Tarawa',
+ 'Pacific/Tongatapu',
+ 'Pacific/Truk',
+ 'Pacific/Wake',
+ 'Pacific/Wallis',
+ 'Pacific/Yap',
+ 'Poland',
+ 'Portugal',
+ 'ROC',
+ 'ROK',
+ 'Singapore',
+ 'Turkey',
+ 'UCT',
+ 'US/Alaska',
+ 'US/Aleutian',
+ 'US/Arizona',
+ 'US/Central',
+ 'US/East-Indiana',
+ 'US/Eastern',
+ 'US/Hawaii',
+ 'US/Indiana-Starke',
+ 'US/Michigan',
+ 'US/Mountain',
+ 'US/Pacific',
+ 'US/Samoa',
+ 'UTC',
+ 'Universal',
+ 'W-SU',
+ 'WET',
+ 'Zulu']
+all_timezones = LazyList(
+        tz for tz in all_timezones if resource_exists(tz))
+        
+all_timezones_set = LazySet(all_timezones)
+common_timezones = \
+['Africa/Abidjan',
+ 'Africa/Accra',
+ 'Africa/Addis_Ababa',
+ 'Africa/Algiers',
+ 'Africa/Asmara',
+ 'Africa/Bamako',
+ 'Africa/Bangui',
+ 'Africa/Banjul',
+ 'Africa/Bissau',
+ 'Africa/Blantyre',
+ 'Africa/Brazzaville',
+ 'Africa/Bujumbura',
+ 'Africa/Cairo',
+ 'Africa/Casablanca',
+ 'Africa/Ceuta',
+ 'Africa/Conakry',
+ 'Africa/Dakar',
+ 'Africa/Dar_es_Salaam',
+ 'Africa/Djibouti',
+ 'Africa/Douala',
+ 'Africa/El_Aaiun',
+ 'Africa/Freetown',
+ 'Africa/Gaborone',
+ 'Africa/Harare',
+ 'Africa/Johannesburg',
+ 'Africa/Juba',
+ 'Africa/Kampala',
+ 'Africa/Khartoum',
+ 'Africa/Kigali',
+ 'Africa/Kinshasa',
+ 'Africa/Lagos',
+ 'Africa/Libreville',
+ 'Africa/Lome',
+ 'Africa/Luanda',
+ 'Africa/Lubumbashi',
+ 'Africa/Lusaka',
+ 'Africa/Malabo',
+ 'Africa/Maputo',
+ 'Africa/Maseru',
+ 'Africa/Mbabane',
+ 'Africa/Mogadishu',
+ 'Africa/Monrovia',
+ 'Africa/Nairobi',
+ 'Africa/Ndjamena',
+ 'Africa/Niamey',
+ 'Africa/Nouakchott',
+ 'Africa/Ouagadougou',
+ 'Africa/Porto-Novo',
+ 'Africa/Sao_Tome',
+ 'Africa/Tripoli',
+ 'Africa/Tunis',
+ 'Africa/Windhoek',
+ 'America/Adak',
+ 'America/Anchorage',
+ 'America/Anguilla',
+ 'America/Antigua',
+ 'America/Araguaina',
+ 'America/Argentina/Buenos_Aires',
+ 'America/Argentina/Catamarca',
+ 'America/Argentina/Cordoba',
+ 'America/Argentina/Jujuy',
+ 'America/Argentina/La_Rioja',
+ 'America/Argentina/Mendoza',
+ 'America/Argentina/Rio_Gallegos',
+ 'America/Argentina/Salta',
+ 'America/Argentina/San_Juan',
+ 'America/Argentina/San_Luis',
+ 'America/Argentina/Tucuman',
+ 'America/Argentina/Ushuaia',
+ 'America/Aruba',
+ 'America/Asuncion',
+ 'America/Atikokan',
+ 'America/Bahia',
+ 'America/Bahia_Banderas',
+ 'America/Barbados',
+ 'America/Belem',
+ 'America/Belize',
+ 'America/Blanc-Sablon',
+ 'America/Boa_Vista',
+ 'America/Bogota',
+ 'America/Boise',
+ 'America/Cambridge_Bay',
+ 'America/Campo_Grande',
+ 'America/Cancun',
+ 'America/Caracas',
+ 'America/Cayenne',
+ 'America/Cayman',
+ 'America/Chicago',
+ 'America/Chihuahua',
+ 'America/Costa_Rica',
+ 'America/Creston',
+ 'America/Cuiaba',
+ 'America/Curacao',
+ 'America/Danmarkshavn',
+ 'America/Dawson',
+ 'America/Dawson_Creek',
+ 'America/Denver',
+ 'America/Detroit',
+ 'America/Dominica',
+ 'America/Edmonton',
+ 'America/Eirunepe',
+ 'America/El_Salvador',
+ 'America/Fort_Nelson',
+ 'America/Fortaleza',
+ 'America/Glace_Bay',
+ 'America/Goose_Bay',
+ 'America/Grand_Turk',
+ 'America/Grenada',
+ 'America/Guadeloupe',
+ 'America/Guatemala',
+ 'America/Guayaquil',
+ 'America/Guyana',
+ 'America/Halifax',
+ 'America/Havana',
+ 'America/Hermosillo',
+ 'America/Indiana/Indianapolis',
+ 'America/Indiana/Knox',
+ 'America/Indiana/Marengo',
+ 'America/Indiana/Petersburg',
+ 'America/Indiana/Tell_City',
+ 'America/Indiana/Vevay',
+ 'America/Indiana/Vincennes',
+ 'America/Indiana/Winamac',
+ 'America/Inuvik',
+ 'America/Iqaluit',
+ 'America/Jamaica',
+ 'America/Juneau',
+ 'America/Kentucky/Louisville',
+ 'America/Kentucky/Monticello',
+ 'America/Kralendijk',
+ 'America/La_Paz',
+ 'America/Lima',
+ 'America/Los_Angeles',
+ 'America/Lower_Princes',
+ 'America/Maceio',
+ 'America/Managua',
+ 'America/Manaus',
+ 'America/Marigot',
+ 'America/Martinique',
+ 'America/Matamoros',
+ 'America/Mazatlan',
+ 'America/Menominee',
+ 'America/Merida',
+ 'America/Metlakatla',
+ 'America/Mexico_City',
+ 'America/Miquelon',
+ 'America/Moncton',
+ 'America/Monterrey',
+ 'America/Montevideo',
+ 'America/Montserrat',
+ 'America/Nassau',
+ 'America/New_York',
+ 'America/Nipigon',
+ 'America/Nome',
+ 'America/Noronha',
+ 'America/North_Dakota/Beulah',
+ 'America/North_Dakota/Center',
+ 'America/North_Dakota/New_Salem',
+ 'America/Nuuk',
+ 'America/Ojinaga',
+ 'America/Panama',
+ 'America/Pangnirtung',
+ 'America/Paramaribo',
+ 'America/Phoenix',
+ 'America/Port-au-Prince',
+ 'America/Port_of_Spain',
+ 'America/Porto_Velho',
+ 'America/Puerto_Rico',
+ 'America/Punta_Arenas',
+ 'America/Rainy_River',
+ 'America/Rankin_Inlet',
+ 'America/Recife',
+ 'America/Regina',
+ 'America/Resolute',
+ 'America/Rio_Branco',
+ 'America/Santarem',
+ 'America/Santiago',
+ 'America/Santo_Domingo',
+ 'America/Sao_Paulo',
+ 'America/Scoresbysund',
+ 'America/Sitka',
+ 'America/St_Barthelemy',
+ 'America/St_Johns',
+ 'America/St_Kitts',
+ 'America/St_Lucia',
+ 'America/St_Thomas',
+ 'America/St_Vincent',
+ 'America/Swift_Current',
+ 'America/Tegucigalpa',
+ 'America/Thule',
+ 'America/Thunder_Bay',
+ 'America/Tijuana',
+ 'America/Toronto',
+ 'America/Tortola',
+ 'America/Vancouver',
+ 'America/Whitehorse',
+ 'America/Winnipeg',
+ 'America/Yakutat',
+ 'America/Yellowknife',
+ 'Antarctica/Casey',
+ 'Antarctica/Davis',
+ 'Antarctica/DumontDUrville',
+ 'Antarctica/Macquarie',
+ 'Antarctica/Mawson',
+ 'Antarctica/McMurdo',
+ 'Antarctica/Palmer',
+ 'Antarctica/Rothera',
+ 'Antarctica/Syowa',
+ 'Antarctica/Troll',
+ 'Antarctica/Vostok',
+ 'Arctic/Longyearbyen',
+ 'Asia/Aden',
+ 'Asia/Almaty',
+ 'Asia/Amman',
+ 'Asia/Anadyr',
+ 'Asia/Aqtau',
+ 'Asia/Aqtobe',
+ 'Asia/Ashgabat',
+ 'Asia/Atyrau',
+ 'Asia/Baghdad',
+ 'Asia/Bahrain',
+ 'Asia/Baku',
+ 'Asia/Bangkok',
+ 'Asia/Barnaul',
+ 'Asia/Beirut',
+ 'Asia/Bishkek',
+ 'Asia/Brunei',
+ 'Asia/Chita',
+ 'Asia/Choibalsan',
+ 'Asia/Colombo',
+ 'Asia/Damascus',
+ 'Asia/Dhaka',
+ 'Asia/Dili',
+ 'Asia/Dubai',
+ 'Asia/Dushanbe',
+ 'Asia/Famagusta',
+ 'Asia/Gaza',
+ 'Asia/Hebron',
+ 'Asia/Ho_Chi_Minh',
+ 'Asia/Hong_Kong',
+ 'Asia/Hovd',
+ 'Asia/Irkutsk',
+ 'Asia/Jakarta',
+ 'Asia/Jayapura',
+ 'Asia/Jerusalem',
+ 'Asia/Kabul',
+ 'Asia/Kamchatka',
+ 'Asia/Karachi',
+ 'Asia/Kathmandu',
+ 'Asia/Khandyga',
+ 'Asia/Kolkata',
+ 'Asia/Krasnoyarsk',
+ 'Asia/Kuala_Lumpur',
+ 'Asia/Kuching',
+ 'Asia/Kuwait',
+ 'Asia/Macau',
+ 'Asia/Magadan',
+ 'Asia/Makassar',
+ 'Asia/Manila',
+ 'Asia/Muscat',
+ 'Asia/Nicosia',
+ 'Asia/Novokuznetsk',
+ 'Asia/Novosibirsk',
+ 'Asia/Omsk',
+ 'Asia/Oral',
+ 'Asia/Phnom_Penh',
+ 'Asia/Pontianak',
+ 'Asia/Pyongyang',
+ 'Asia/Qatar',
+ 'Asia/Qostanay',
+ 'Asia/Qyzylorda',
+ 'Asia/Riyadh',
+ 'Asia/Sakhalin',
+ 'Asia/Samarkand',
+ 'Asia/Seoul',
+ 'Asia/Shanghai',
+ 'Asia/Singapore',
+ 'Asia/Srednekolymsk',
+ 'Asia/Taipei',
+ 'Asia/Tashkent',
+ 'Asia/Tbilisi',
+ 'Asia/Tehran',
+ 'Asia/Thimphu',
+ 'Asia/Tokyo',
+ 'Asia/Tomsk',
+ 'Asia/Ulaanbaatar',
+ 'Asia/Urumqi',
+ 'Asia/Ust-Nera',
+ 'Asia/Vientiane',
+ 'Asia/Vladivostok',
+ 'Asia/Yakutsk',
+ 'Asia/Yangon',
+ 'Asia/Yekaterinburg',
+ 'Asia/Yerevan',
+ 'Atlantic/Azores',
+ 'Atlantic/Bermuda',
+ 'Atlantic/Canary',
+ 'Atlantic/Cape_Verde',
+ 'Atlantic/Faroe',
+ 'Atlantic/Madeira',
+ 'Atlantic/Reykjavik',
+ 'Atlantic/South_Georgia',
+ 'Atlantic/St_Helena',
+ 'Atlantic/Stanley',
+ 'Australia/Adelaide',
+ 'Australia/Brisbane',
+ 'Australia/Broken_Hill',
+ 'Australia/Darwin',
+ 'Australia/Eucla',
+ 'Australia/Hobart',
+ 'Australia/Lindeman',
+ 'Australia/Lord_Howe',
+ 'Australia/Melbourne',
+ 'Australia/Perth',
+ 'Australia/Sydney',
+ 'Canada/Atlantic',
+ 'Canada/Central',
+ 'Canada/Eastern',
+ 'Canada/Mountain',
+ 'Canada/Newfoundland',
+ 'Canada/Pacific',
+ 'Europe/Amsterdam',
+ 'Europe/Andorra',
+ 'Europe/Astrakhan',
+ 'Europe/Athens',
+ 'Europe/Belgrade',
+ 'Europe/Berlin',
+ 'Europe/Bratislava',
+ 'Europe/Brussels',
+ 'Europe/Bucharest',
+ 'Europe/Budapest',
+ 'Europe/Busingen',
+ 'Europe/Chisinau',
+ 'Europe/Copenhagen',
+ 'Europe/Dublin',
+ 'Europe/Gibraltar',
+ 'Europe/Guernsey',
+ 'Europe/Helsinki',
+ 'Europe/Isle_of_Man',
+ 'Europe/Istanbul',
+ 'Europe/Jersey',
+ 'Europe/Kaliningrad',
+ 'Europe/Kiev',
+ 'Europe/Kirov',
+ 'Europe/Lisbon',
+ 'Europe/Ljubljana',
+ 'Europe/London',
+ 'Europe/Luxembourg',
+ 'Europe/Madrid',
+ 'Europe/Malta',
+ 'Europe/Mariehamn',
+ 'Europe/Minsk',
+ 'Europe/Monaco',
+ 'Europe/Moscow',
+ 'Europe/Oslo',
+ 'Europe/Paris',
+ 'Europe/Podgorica',
+ 'Europe/Prague',
+ 'Europe/Riga',
+ 'Europe/Rome',
+ 'Europe/Samara',
+ 'Europe/San_Marino',
+ 'Europe/Sarajevo',
+ 'Europe/Saratov',
+ 'Europe/Simferopol',
+ 'Europe/Skopje',
+ 'Europe/Sofia',
+ 'Europe/Stockholm',
+ 'Europe/Tallinn',
+ 'Europe/Tirane',
+ 'Europe/Ulyanovsk',
+ 'Europe/Uzhgorod',
+ 'Europe/Vaduz',
+ 'Europe/Vatican',
+ 'Europe/Vienna',
+ 'Europe/Vilnius',
+ 'Europe/Volgograd',
+ 'Europe/Warsaw',
+ 'Europe/Zagreb',
+ 'Europe/Zaporozhye',
+ 'Europe/Zurich',
+ 'GMT',
+ 'Indian/Antananarivo',
+ 'Indian/Chagos',
+ 'Indian/Christmas',
+ 'Indian/Cocos',
+ 'Indian/Comoro',
+ 'Indian/Kerguelen',
+ 'Indian/Mahe',
+ 'Indian/Maldives',
+ 'Indian/Mauritius',
+ 'Indian/Mayotte',
+ 'Indian/Reunion',
+ 'Pacific/Apia',
+ 'Pacific/Auckland',
+ 'Pacific/Bougainville',
+ 'Pacific/Chatham',
+ 'Pacific/Chuuk',
+ 'Pacific/Easter',
+ 'Pacific/Efate',
+ 'Pacific/Enderbury',
+ 'Pacific/Fakaofo',
+ 'Pacific/Fiji',
+ 'Pacific/Funafuti',
+ 'Pacific/Galapagos',
+ 'Pacific/Gambier',
+ 'Pacific/Guadalcanal',
+ 'Pacific/Guam',
+ 'Pacific/Honolulu',
+ 'Pacific/Kiritimati',
+ 'Pacific/Kosrae',
+ 'Pacific/Kwajalein',
+ 'Pacific/Majuro',
+ 'Pacific/Marquesas',
+ 'Pacific/Midway',
+ 'Pacific/Nauru',
+ 'Pacific/Niue',
+ 'Pacific/Norfolk',
+ 'Pacific/Noumea',
+ 'Pacific/Pago_Pago',
+ 'Pacific/Palau',
+ 'Pacific/Pitcairn',
+ 'Pacific/Pohnpei',
+ 'Pacific/Port_Moresby',
+ 'Pacific/Rarotonga',
+ 'Pacific/Saipan',
+ 'Pacific/Tahiti',
+ 'Pacific/Tarawa',
+ 'Pacific/Tongatapu',
+ 'Pacific/Wake',
+ 'Pacific/Wallis',
+ 'US/Alaska',
+ 'US/Arizona',
+ 'US/Central',
+ 'US/Eastern',
+ 'US/Hawaii',
+ 'US/Mountain',
+ 'US/Pacific',
+ 'UTC']
+common_timezones = LazyList(
+            tz for tz in common_timezones if tz in all_timezones)
+        
+common_timezones_set = LazySet(common_timezones)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b20bde9ff9240ce8cc578e480f4d9aa8555bab4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/exceptions.py
@@ -0,0 +1,59 @@
+'''
+Custom exceptions raised by pytz.
+'''
+
+__all__ = [
+    'UnknownTimeZoneError', 'InvalidTimeError', 'AmbiguousTimeError',
+    'NonExistentTimeError',
+]
+
+
+class Error(Exception):
+    '''Base class for all exceptions raised by the pytz library'''
+
+
+class UnknownTimeZoneError(KeyError, Error):
+    '''Exception raised when pytz is passed an unknown timezone.
+
+    >>> isinstance(UnknownTimeZoneError(), LookupError)
+    True
+
+    This class is actually a subclass of KeyError to provide backwards
+    compatibility with code relying on the undocumented behavior of earlier
+    pytz releases.
+
+    >>> isinstance(UnknownTimeZoneError(), KeyError)
+    True
+
+    And also a subclass of pytz.exceptions.Error, as are other pytz
+    exceptions.
+
+    >>> isinstance(UnknownTimeZoneError(), Error)
+    True
+
+    '''
+    pass
+
+
+class InvalidTimeError(Error):
+    '''Base class for invalid time exceptions.'''
+
+
+class AmbiguousTimeError(InvalidTimeError):
+    '''Exception raised when attempting to create an ambiguous wallclock time.
+
+    At the end of a DST transition period, a particular wallclock time will
+    occur twice (once before the clocks are set back, once after). Both
+    possibilities may be correct, unless further information is supplied.
+
+    See DstTzInfo.normalize() for more info
+    '''
+
+
+class NonExistentTimeError(InvalidTimeError):
+    '''Exception raised when attempting to create a wallclock time that
+    cannot exist.
+
+    At the start of a DST transition period, the wallclock time jumps forward.
+    The instants jumped over never occur.
+    '''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/lazy.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/lazy.py
new file mode 100644
index 0000000000000000000000000000000000000000..39344fc1f8c77d5ec43539d0c8e655f4b5d7d6f6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/lazy.py
@@ -0,0 +1,172 @@
+from threading import RLock
+try:
+    from collections.abc import Mapping as DictMixin
+except ImportError:  # Python < 3.3
+    try:
+        from UserDict import DictMixin  # Python 2
+    except ImportError:  # Python 3.0-3.3
+        from collections import Mapping as DictMixin
+
+
+# With lazy loading, we might end up with multiple threads triggering
+# it at the same time. We need a lock.
+_fill_lock = RLock()
+
+
+class LazyDict(DictMixin):
+    """Dictionary populated on first use."""
+    data = None
+
+    def __getitem__(self, key):
+        if self.data is None:
+            _fill_lock.acquire()
+            try:
+                if self.data is None:
+                    self._fill()
+            finally:
+                _fill_lock.release()
+        return self.data[key.upper()]
+
+    def __contains__(self, key):
+        if self.data is None:
+            _fill_lock.acquire()
+            try:
+                if self.data is None:
+                    self._fill()
+            finally:
+                _fill_lock.release()
+        return key in self.data
+
+    def __iter__(self):
+        if self.data is None:
+            _fill_lock.acquire()
+            try:
+                if self.data is None:
+                    self._fill()
+            finally:
+                _fill_lock.release()
+        return iter(self.data)
+
+    def __len__(self):
+        if self.data is None:
+            _fill_lock.acquire()
+            try:
+                if self.data is None:
+                    self._fill()
+            finally:
+                _fill_lock.release()
+        return len(self.data)
+
+    def keys(self):
+        if self.data is None:
+            _fill_lock.acquire()
+            try:
+                if self.data is None:
+                    self._fill()
+            finally:
+                _fill_lock.release()
+        return self.data.keys()
+
+
+class LazyList(list):
+    """List populated on first use."""
+
+    _props = [
+        '__str__', '__repr__', '__unicode__',
+        '__hash__', '__sizeof__', '__cmp__',
+        '__lt__', '__le__', '__eq__', '__ne__', '__gt__', '__ge__',
+        'append', 'count', 'index', 'extend', 'insert', 'pop', 'remove',
+        'reverse', 'sort', '__add__', '__radd__', '__iadd__', '__mul__',
+        '__rmul__', '__imul__', '__contains__', '__len__', '__nonzero__',
+        '__getitem__', '__setitem__', '__delitem__', '__iter__',
+        '__reversed__', '__getslice__', '__setslice__', '__delslice__']
+
+    def __new__(cls, fill_iter=None):
+
+        if fill_iter is None:
+            return list()
+
+        # We need a new class as we will be dynamically messing with its
+        # methods.
+        class LazyList(list):
+            pass
+
+        fill_iter = [fill_iter]
+
+        def lazy(name):
+            def _lazy(self, *args, **kw):
+                _fill_lock.acquire()
+                try:
+                    if len(fill_iter) > 0:
+                        list.extend(self, fill_iter.pop())
+                        for method_name in cls._props:
+                            delattr(LazyList, method_name)
+                finally:
+                    _fill_lock.release()
+                return getattr(list, name)(self, *args, **kw)
+            return _lazy
+
+        for name in cls._props:
+            setattr(LazyList, name, lazy(name))
+
+        new_list = LazyList()
+        return new_list
+
+# Not all versions of Python declare the same magic methods.
+# Filter out properties that don't exist in this version of Python
+# from the list.
+LazyList._props = [prop for prop in LazyList._props if hasattr(list, prop)]
+
+
+class LazySet(set):
+    """Set populated on first use."""
+
+    _props = (
+        '__str__', '__repr__', '__unicode__',
+        '__hash__', '__sizeof__', '__cmp__',
+        '__lt__', '__le__', '__eq__', '__ne__', '__gt__', '__ge__',
+        '__contains__', '__len__', '__nonzero__',
+        '__getitem__', '__setitem__', '__delitem__', '__iter__',
+        '__sub__', '__and__', '__xor__', '__or__',
+        '__rsub__', '__rand__', '__rxor__', '__ror__',
+        '__isub__', '__iand__', '__ixor__', '__ior__',
+        'add', 'clear', 'copy', 'difference', 'difference_update',
+        'discard', 'intersection', 'intersection_update', 'isdisjoint',
+        'issubset', 'issuperset', 'pop', 'remove',
+        'symmetric_difference', 'symmetric_difference_update',
+        'union', 'update')
+
+    def __new__(cls, fill_iter=None):
+
+        if fill_iter is None:
+            return set()
+
+        class LazySet(set):
+            pass
+
+        fill_iter = [fill_iter]
+
+        def lazy(name):
+            def _lazy(self, *args, **kw):
+                _fill_lock.acquire()
+                try:
+                    if len(fill_iter) > 0:
+                        for i in fill_iter.pop():
+                            set.add(self, i)
+                        for method_name in cls._props:
+                            delattr(LazySet, method_name)
+                finally:
+                    _fill_lock.release()
+                return getattr(set, name)(self, *args, **kw)
+            return _lazy
+
+        for name in cls._props:
+            setattr(LazySet, name, lazy(name))
+
+        new_set = LazySet()
+        return new_set
+
+# Not all versions of Python declare the same magic methods.
+# Filter out properties that don't exist in this version of Python
+# from the list.
+LazySet._props = [prop for prop in LazySet._props if hasattr(set, prop)]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/reference.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/reference.py
new file mode 100644
index 0000000000000000000000000000000000000000..f765ca0af0b24e66dc3b7d51b9bf97e71b2b67aa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/reference.py
@@ -0,0 +1,140 @@
+'''
+Reference tzinfo implementations from the Python docs.
+Used for testing against as they are only correct for the years
+1987 to 2006. Do not use these for real code.
+'''
+
+from datetime import tzinfo, timedelta, datetime
+from pytz import HOUR, ZERO, UTC
+
+__all__ = [
+    'FixedOffset',
+    'LocalTimezone',
+    'USTimeZone',
+    'Eastern',
+    'Central',
+    'Mountain',
+    'Pacific',
+    'UTC'
+]
+
+
+# A class building tzinfo objects for fixed-offset time zones.
+# Note that FixedOffset(0, "UTC") is a different way to build a
+# UTC tzinfo object.
+class FixedOffset(tzinfo):
+    """Fixed offset in minutes east from UTC."""
+
+    def __init__(self, offset, name):
+        self.__offset = timedelta(minutes=offset)
+        self.__name = name
+
+    def utcoffset(self, dt):
+        return self.__offset
+
+    def tzname(self, dt):
+        return self.__name
+
+    def dst(self, dt):
+        return ZERO
+
+
+import time as _time
+
+STDOFFSET = timedelta(seconds=-_time.timezone)
+if _time.daylight:
+    DSTOFFSET = timedelta(seconds=-_time.altzone)
+else:
+    DSTOFFSET = STDOFFSET
+
+DSTDIFF = DSTOFFSET - STDOFFSET
+
+
+# A class capturing the platform's idea of local time.
+class LocalTimezone(tzinfo):
+
+    def utcoffset(self, dt):
+        if self._isdst(dt):
+            return DSTOFFSET
+        else:
+            return STDOFFSET
+
+    def dst(self, dt):
+        if self._isdst(dt):
+            return DSTDIFF
+        else:
+            return ZERO
+
+    def tzname(self, dt):
+        return _time.tzname[self._isdst(dt)]
+
+    def _isdst(self, dt):
+        tt = (dt.year, dt.month, dt.day,
+              dt.hour, dt.minute, dt.second,
+              dt.weekday(), 0, -1)
+        stamp = _time.mktime(tt)
+        tt = _time.localtime(stamp)
+        return tt.tm_isdst > 0
+
+Local = LocalTimezone()
+
+
+def first_sunday_on_or_after(dt):
+    days_to_go = 6 - dt.weekday()
+    if days_to_go:
+        dt += timedelta(days_to_go)
+    return dt
+
+
+# In the US, DST starts at 2am (standard time) on the first Sunday in April.
+DSTSTART = datetime(1, 4, 1, 2)
+# and ends at 2am (DST time; 1am standard time) on the last Sunday of Oct.
+# which is the first Sunday on or after Oct 25.
+DSTEND = datetime(1, 10, 25, 1)
+
+
+# A complete implementation of current DST rules for major US time zones.
+class USTimeZone(tzinfo):
+
+    def __init__(self, hours, reprname, stdname, dstname):
+        self.stdoffset = timedelta(hours=hours)
+        self.reprname = reprname
+        self.stdname = stdname
+        self.dstname = dstname
+
+    def __repr__(self):
+        return self.reprname
+
+    def tzname(self, dt):
+        if self.dst(dt):
+            return self.dstname
+        else:
+            return self.stdname
+
+    def utcoffset(self, dt):
+        return self.stdoffset + self.dst(dt)
+
+    def dst(self, dt):
+        if dt is None or dt.tzinfo is None:
+            # An exception may be sensible here, in one or both cases.
+            # It depends on how you want to treat them.  The default
+            # fromutc() implementation (called by the default astimezone()
+            # implementation) passes a datetime with dt.tzinfo is self.
+            return ZERO
+        assert dt.tzinfo is self
+
+        # Find first Sunday in April & the last in October.
+        start = first_sunday_on_or_after(DSTSTART.replace(year=dt.year))
+        end = first_sunday_on_or_after(DSTEND.replace(year=dt.year))
+
+        # Can't compare naive to aware objects, so strip the timezone from
+        # dt first.
+        if start <= dt.replace(tzinfo=None) < end:
+            return HOUR
+        else:
+            return ZERO
+
+Eastern = USTimeZone(-5, "Eastern", "EST", "EDT")
+Central = USTimeZone(-6, "Central", "CST", "CDT")
+Mountain = USTimeZone(-7, "Mountain", "MST", "MDT")
+Pacific = USTimeZone(-8, "Pacific", "PST", "PDT")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..99e74489b859e21fcaa68e93089035c3d81a73c8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzfile.py
@@ -0,0 +1,133 @@
+'''
+$Id: tzfile.py,v 1.8 2004/06/03 00:15:24 zenzen Exp $
+'''
+
+from datetime import datetime
+from struct import unpack, calcsize
+
+from pytz.tzinfo import StaticTzInfo, DstTzInfo, memorized_ttinfo
+from pytz.tzinfo import memorized_datetime, memorized_timedelta
+
+
+def _byte_string(s):
+    """Cast a string or byte string to an ASCII byte string."""
+    return s.encode('ASCII')
+
+_NULL = _byte_string('\0')
+
+
+def _std_string(s):
+    """Cast a string or byte string to an ASCII string."""
+    return str(s.decode('ASCII'))
+
+
+def build_tzinfo(zone, fp):
+    head_fmt = '>4s c 15x 6l'
+    head_size = calcsize(head_fmt)
+    (magic, format, ttisgmtcnt, ttisstdcnt, leapcnt, timecnt,
+        typecnt, charcnt) = unpack(head_fmt, fp.read(head_size))
+
+    # Make sure it is a tzfile(5) file
+    assert magic == _byte_string('TZif'), 'Got magic %s' % repr(magic)
+
+    # Read out the transition times, localtime indices and ttinfo structures.
+    data_fmt = '>%(timecnt)dl %(timecnt)dB %(ttinfo)s %(charcnt)ds' % dict(
+        timecnt=timecnt, ttinfo='lBB' * typecnt, charcnt=charcnt)
+    data_size = calcsize(data_fmt)
+    data = unpack(data_fmt, fp.read(data_size))
+
+    # make sure we unpacked the right number of values
+    assert len(data) == 2 * timecnt + 3 * typecnt + 1
+    transitions = [memorized_datetime(trans)
+                   for trans in data[:timecnt]]
+    lindexes = list(data[timecnt:2 * timecnt])
+    ttinfo_raw = data[2 * timecnt:-1]
+    tznames_raw = data[-1]
+    del data
+
+    # Process ttinfo into separate structs
+    ttinfo = []
+    tznames = {}
+    i = 0
+    while i < len(ttinfo_raw):
+        # have we looked up this timezone name yet?
+        tzname_offset = ttinfo_raw[i + 2]
+        if tzname_offset not in tznames:
+            nul = tznames_raw.find(_NULL, tzname_offset)
+            if nul < 0:
+                nul = len(tznames_raw)
+            tznames[tzname_offset] = _std_string(
+                tznames_raw[tzname_offset:nul])
+        ttinfo.append((ttinfo_raw[i],
+                       bool(ttinfo_raw[i + 1]),
+                       tznames[tzname_offset]))
+        i += 3
+
+    # Now build the timezone object
+    if len(ttinfo) == 1 or len(transitions) == 0:
+        ttinfo[0][0], ttinfo[0][2]
+        cls = type(zone, (StaticTzInfo,), dict(
+            zone=zone,
+            _utcoffset=memorized_timedelta(ttinfo[0][0]),
+            _tzname=ttinfo[0][2]))
+    else:
+        # Early dates use the first standard time ttinfo
+        i = 0
+        while ttinfo[i][1]:
+            i += 1
+        if ttinfo[i] == ttinfo[lindexes[0]]:
+            transitions[0] = datetime.min
+        else:
+            transitions.insert(0, datetime.min)
+            lindexes.insert(0, i)
+
+        # calculate transition info
+        transition_info = []
+        for i in range(len(transitions)):
+            inf = ttinfo[lindexes[i]]
+            utcoffset = inf[0]
+            if not inf[1]:
+                dst = 0
+            else:
+                for j in range(i - 1, -1, -1):
+                    prev_inf = ttinfo[lindexes[j]]
+                    if not prev_inf[1]:
+                        break
+                dst = inf[0] - prev_inf[0]  # dst offset
+
+                # Bad dst? Look further. DST > 24 hours happens when
+                # a timzone has moved across the international dateline.
+                if dst <= 0 or dst > 3600 * 3:
+                    for j in range(i + 1, len(transitions)):
+                        stdinf = ttinfo[lindexes[j]]
+                        if not stdinf[1]:
+                            dst = inf[0] - stdinf[0]
+                            if dst > 0:
+                                break  # Found a useful std time.
+
+            tzname = inf[2]
+
+            # Round utcoffset and dst to the nearest minute or the
+            # datetime library will complain. Conversions to these timezones
+            # might be up to plus or minus 30 seconds out, but it is
+            # the best we can do.
+            utcoffset = int((utcoffset + 30) // 60) * 60
+            dst = int((dst + 30) // 60) * 60
+            transition_info.append(memorized_ttinfo(utcoffset, dst, tzname))
+
+        cls = type(zone, (DstTzInfo,), dict(
+            zone=zone,
+            _utc_transition_times=transitions,
+            _transition_info=transition_info))
+
+    return cls()
+
+if __name__ == '__main__':
+    import os.path
+    from pprint import pprint
+    base = os.path.join(os.path.dirname(__file__), 'zoneinfo')
+    tz = build_tzinfo('Australia/Melbourne',
+                      open(os.path.join(base, 'Australia', 'Melbourne'), 'rb'))
+    tz = build_tzinfo('US/Eastern',
+                      open(os.path.join(base, 'US', 'Eastern'), 'rb'))
+    pprint(tz._utc_transition_times)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzinfo.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzinfo.py
new file mode 100644
index 0000000000000000000000000000000000000000..725978d53720202bf7b1a64f356f47c49d42fd92
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/tzinfo.py
@@ -0,0 +1,577 @@
+'''Base classes and helpers for building zone specific tzinfo classes'''
+
+from datetime import datetime, timedelta, tzinfo
+from bisect import bisect_right
+try:
+    set
+except NameError:
+    from sets import Set as set
+
+import pytz
+from pytz.exceptions import AmbiguousTimeError, NonExistentTimeError
+
+__all__ = []
+
+_timedelta_cache = {}
+
+
+def memorized_timedelta(seconds):
+    '''Create only one instance of each distinct timedelta'''
+    try:
+        return _timedelta_cache[seconds]
+    except KeyError:
+        delta = timedelta(seconds=seconds)
+        _timedelta_cache[seconds] = delta
+        return delta
+
+_epoch = datetime.utcfromtimestamp(0)
+_datetime_cache = {0: _epoch}
+
+
+def memorized_datetime(seconds):
+    '''Create only one instance of each distinct datetime'''
+    try:
+        return _datetime_cache[seconds]
+    except KeyError:
+        # NB. We can't just do datetime.utcfromtimestamp(seconds) as this
+        # fails with negative values under Windows (Bug #90096)
+        dt = _epoch + timedelta(seconds=seconds)
+        _datetime_cache[seconds] = dt
+        return dt
+
+_ttinfo_cache = {}
+
+
+def memorized_ttinfo(*args):
+    '''Create only one instance of each distinct tuple'''
+    try:
+        return _ttinfo_cache[args]
+    except KeyError:
+        ttinfo = (
+            memorized_timedelta(args[0]),
+            memorized_timedelta(args[1]),
+            args[2]
+        )
+        _ttinfo_cache[args] = ttinfo
+        return ttinfo
+
+_notime = memorized_timedelta(0)
+
+
+def _to_seconds(td):
+    '''Convert a timedelta to seconds'''
+    return td.seconds + td.days * 24 * 60 * 60
+
+
+class BaseTzInfo(tzinfo):
+    # Overridden in subclass
+    _utcoffset = None
+    _tzname = None
+    zone = None
+
+    def __str__(self):
+        return self.zone
+
+
+class StaticTzInfo(BaseTzInfo):
+    '''A timezone that has a constant offset from UTC
+
+    These timezones are rare, as most locations have changed their
+    offset at some point in their history
+    '''
+    def fromutc(self, dt):
+        '''See datetime.tzinfo.fromutc'''
+        if dt.tzinfo is not None and dt.tzinfo is not self:
+            raise ValueError('fromutc: dt.tzinfo is not self')
+        return (dt + self._utcoffset).replace(tzinfo=self)
+
+    def utcoffset(self, dt, is_dst=None):
+        '''See datetime.tzinfo.utcoffset
+
+        is_dst is ignored for StaticTzInfo, and exists only to
+        retain compatibility with DstTzInfo.
+        '''
+        return self._utcoffset
+
+    def dst(self, dt, is_dst=None):
+        '''See datetime.tzinfo.dst
+
+        is_dst is ignored for StaticTzInfo, and exists only to
+        retain compatibility with DstTzInfo.
+        '''
+        return _notime
+
+    def tzname(self, dt, is_dst=None):
+        '''See datetime.tzinfo.tzname
+
+        is_dst is ignored for StaticTzInfo, and exists only to
+        retain compatibility with DstTzInfo.
+        '''
+        return self._tzname
+
+    def localize(self, dt, is_dst=False):
+        '''Convert naive time to local time'''
+        if dt.tzinfo is not None:
+            raise ValueError('Not naive datetime (tzinfo is already set)')
+        return dt.replace(tzinfo=self)
+
+    def normalize(self, dt, is_dst=False):
+        '''Correct the timezone information on the given datetime.
+
+        This is normally a no-op, as StaticTzInfo timezones never have
+        ambiguous cases to correct:
+
+        >>> from pytz import timezone
+        >>> gmt = timezone('GMT')
+        >>> isinstance(gmt, StaticTzInfo)
+        True
+        >>> dt = datetime(2011, 5, 8, 1, 2, 3, tzinfo=gmt)
+        >>> gmt.normalize(dt) is dt
+        True
+
+        The supported method of converting between timezones is to use
+        datetime.astimezone(). Currently normalize() also works:
+
+        >>> la = timezone('America/Los_Angeles')
+        >>> dt = la.localize(datetime(2011, 5, 7, 1, 2, 3))
+        >>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
+        >>> gmt.normalize(dt).strftime(fmt)
+        '2011-05-07 08:02:03 GMT (+0000)'
+        '''
+        if dt.tzinfo is self:
+            return dt
+        if dt.tzinfo is None:
+            raise ValueError('Naive time - no tzinfo set')
+        return dt.astimezone(self)
+
+    def __repr__(self):
+        return '<StaticTzInfo %r>' % (self.zone,)
+
+    def __reduce__(self):
+        # Special pickle to zone remains a singleton and to cope with
+        # database changes.
+        return pytz._p, (self.zone,)
+
+
+class DstTzInfo(BaseTzInfo):
+    '''A timezone that has a variable offset from UTC
+
+    The offset might change if daylight saving time comes into effect,
+    or at a point in history when the region decides to change their
+    timezone definition.
+    '''
+    # Overridden in subclass
+
+    # Sorted list of DST transition times, UTC
+    _utc_transition_times = None
+
+    # [(utcoffset, dstoffset, tzname)] corresponding to
+    # _utc_transition_times entries
+    _transition_info = None
+
+    zone = None
+
+    # Set in __init__
+
+    _tzinfos = None
+    _dst = None  # DST offset
+
+    def __init__(self, _inf=None, _tzinfos=None):
+        if _inf:
+            self._tzinfos = _tzinfos
+            self._utcoffset, self._dst, self._tzname = _inf
+        else:
+            _tzinfos = {}
+            self._tzinfos = _tzinfos
+            self._utcoffset, self._dst, self._tzname = (
+                self._transition_info[0])
+            _tzinfos[self._transition_info[0]] = self
+            for inf in self._transition_info[1:]:
+                if inf not in _tzinfos:
+                    _tzinfos[inf] = self.__class__(inf, _tzinfos)
+
+    def fromutc(self, dt):
+        '''See datetime.tzinfo.fromutc'''
+        if (dt.tzinfo is not None and
+                getattr(dt.tzinfo, '_tzinfos', None) is not self._tzinfos):
+            raise ValueError('fromutc: dt.tzinfo is not self')
+        dt = dt.replace(tzinfo=None)
+        idx = max(0, bisect_right(self._utc_transition_times, dt) - 1)
+        inf = self._transition_info[idx]
+        return (dt + inf[0]).replace(tzinfo=self._tzinfos[inf])
+
+    def normalize(self, dt):
+        '''Correct the timezone information on the given datetime
+
+        If date arithmetic crosses DST boundaries, the tzinfo
+        is not magically adjusted. This method normalizes the
+        tzinfo to the correct one.
+
+        To test, first we need to do some setup
+
+        >>> from pytz import timezone
+        >>> utc = timezone('UTC')
+        >>> eastern = timezone('US/Eastern')
+        >>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
+
+        We next create a datetime right on an end-of-DST transition point,
+        the instant when the wallclocks are wound back one hour.
+
+        >>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
+        >>> loc_dt = utc_dt.astimezone(eastern)
+        >>> loc_dt.strftime(fmt)
+        '2002-10-27 01:00:00 EST (-0500)'
+
+        Now, if we subtract a few minutes from it, note that the timezone
+        information has not changed.
+
+        >>> before = loc_dt - timedelta(minutes=10)
+        >>> before.strftime(fmt)
+        '2002-10-27 00:50:00 EST (-0500)'
+
+        But we can fix that by calling the normalize method
+
+        >>> before = eastern.normalize(before)
+        >>> before.strftime(fmt)
+        '2002-10-27 01:50:00 EDT (-0400)'
+
+        The supported method of converting between timezones is to use
+        datetime.astimezone(). Currently, normalize() also works:
+
+        >>> th = timezone('Asia/Bangkok')
+        >>> am = timezone('Europe/Amsterdam')
+        >>> dt = th.localize(datetime(2011, 5, 7, 1, 2, 3))
+        >>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
+        >>> am.normalize(dt).strftime(fmt)
+        '2011-05-06 20:02:03 CEST (+0200)'
+        '''
+        if dt.tzinfo is None:
+            raise ValueError('Naive time - no tzinfo set')
+
+        # Convert dt in localtime to UTC
+        offset = dt.tzinfo._utcoffset
+        dt = dt.replace(tzinfo=None)
+        dt = dt - offset
+        # convert it back, and return it
+        return self.fromutc(dt)
+
+    def localize(self, dt, is_dst=False):
+        '''Convert naive time to local time.
+
+        This method should be used to construct localtimes, rather
+        than passing a tzinfo argument to a datetime constructor.
+
+        is_dst is used to determine the correct timezone in the ambigous
+        period at the end of daylight saving time.
+
+        >>> from pytz import timezone
+        >>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
+        >>> amdam = timezone('Europe/Amsterdam')
+        >>> dt  = datetime(2004, 10, 31, 2, 0, 0)
+        >>> loc_dt1 = amdam.localize(dt, is_dst=True)
+        >>> loc_dt2 = amdam.localize(dt, is_dst=False)
+        >>> loc_dt1.strftime(fmt)
+        '2004-10-31 02:00:00 CEST (+0200)'
+        >>> loc_dt2.strftime(fmt)
+        '2004-10-31 02:00:00 CET (+0100)'
+        >>> str(loc_dt2 - loc_dt1)
+        '1:00:00'
+
+        Use is_dst=None to raise an AmbiguousTimeError for ambiguous
+        times at the end of daylight saving time
+
+        >>> try:
+        ...     loc_dt1 = amdam.localize(dt, is_dst=None)
+        ... except AmbiguousTimeError:
+        ...     print('Ambiguous')
+        Ambiguous
+
+        is_dst defaults to False
+
+        >>> amdam.localize(dt) == amdam.localize(dt, False)
+        True
+
+        is_dst is also used to determine the correct timezone in the
+        wallclock times jumped over at the start of daylight saving time.
+
+        >>> pacific = timezone('US/Pacific')
+        >>> dt = datetime(2008, 3, 9, 2, 0, 0)
+        >>> ploc_dt1 = pacific.localize(dt, is_dst=True)
+        >>> ploc_dt2 = pacific.localize(dt, is_dst=False)
+        >>> ploc_dt1.strftime(fmt)
+        '2008-03-09 02:00:00 PDT (-0700)'
+        >>> ploc_dt2.strftime(fmt)
+        '2008-03-09 02:00:00 PST (-0800)'
+        >>> str(ploc_dt2 - ploc_dt1)
+        '1:00:00'
+
+        Use is_dst=None to raise a NonExistentTimeError for these skipped
+        times.
+
+        >>> try:
+        ...     loc_dt1 = pacific.localize(dt, is_dst=None)
+        ... except NonExistentTimeError:
+        ...     print('Non-existent')
+        Non-existent
+        '''
+        if dt.tzinfo is not None:
+            raise ValueError('Not naive datetime (tzinfo is already set)')
+
+        # Find the two best possibilities.
+        possible_loc_dt = set()
+        for delta in [timedelta(days=-1), timedelta(days=1)]:
+            loc_dt = dt + delta
+            idx = max(0, bisect_right(
+                self._utc_transition_times, loc_dt) - 1)
+            inf = self._transition_info[idx]
+            tzinfo = self._tzinfos[inf]
+            loc_dt = tzinfo.normalize(dt.replace(tzinfo=tzinfo))
+            if loc_dt.replace(tzinfo=None) == dt:
+                possible_loc_dt.add(loc_dt)
+
+        if len(possible_loc_dt) == 1:
+            return possible_loc_dt.pop()
+
+        # If there are no possibly correct timezones, we are attempting
+        # to convert a time that never happened - the time period jumped
+        # during the start-of-DST transition period.
+        if len(possible_loc_dt) == 0:
+            # If we refuse to guess, raise an exception.
+            if is_dst is None:
+                raise NonExistentTimeError(dt)
+
+            # If we are forcing the pre-DST side of the DST transition, we
+            # obtain the correct timezone by winding the clock forward a few
+            # hours.
+            elif is_dst:
+                return self.localize(
+                    dt + timedelta(hours=6), is_dst=True) - timedelta(hours=6)
+
+            # If we are forcing the post-DST side of the DST transition, we
+            # obtain the correct timezone by winding the clock back.
+            else:
+                return self.localize(
+                    dt - timedelta(hours=6),
+                    is_dst=False) + timedelta(hours=6)
+
+        # If we get this far, we have multiple possible timezones - this
+        # is an ambiguous case occuring during the end-of-DST transition.
+
+        # If told to be strict, raise an exception since we have an
+        # ambiguous case
+        if is_dst is None:
+            raise AmbiguousTimeError(dt)
+
+        # Filter out the possiblilities that don't match the requested
+        # is_dst
+        filtered_possible_loc_dt = [
+            p for p in possible_loc_dt if bool(p.tzinfo._dst) == is_dst
+        ]
+
+        # Hopefully we only have one possibility left. Return it.
+        if len(filtered_possible_loc_dt) == 1:
+            return filtered_possible_loc_dt[0]
+
+        if len(filtered_possible_loc_dt) == 0:
+            filtered_possible_loc_dt = list(possible_loc_dt)
+
+        # If we get this far, we have in a wierd timezone transition
+        # where the clocks have been wound back but is_dst is the same
+        # in both (eg. Europe/Warsaw 1915 when they switched to CET).
+        # At this point, we just have to guess unless we allow more
+        # hints to be passed in (such as the UTC offset or abbreviation),
+        # but that is just getting silly.
+        #
+        # Choose the earliest (by UTC) applicable timezone if is_dst=True
+        # Choose the latest (by UTC) applicable timezone if is_dst=False
+        # i.e., behave like end-of-DST transition
+        dates = {}  # utc -> local
+        for local_dt in filtered_possible_loc_dt:
+            utc_time = (
+                local_dt.replace(tzinfo=None) - local_dt.tzinfo._utcoffset)
+            assert utc_time not in dates
+            dates[utc_time] = local_dt
+        return dates[[min, max][not is_dst](dates)]
+
+    def utcoffset(self, dt, is_dst=None):
+        '''See datetime.tzinfo.utcoffset
+
+        The is_dst parameter may be used to remove ambiguity during DST
+        transitions.
+
+        >>> from pytz import timezone
+        >>> tz = timezone('America/St_Johns')
+        >>> ambiguous = datetime(2009, 10, 31, 23, 30)
+
+        >>> str(tz.utcoffset(ambiguous, is_dst=False))
+        '-1 day, 20:30:00'
+
+        >>> str(tz.utcoffset(ambiguous, is_dst=True))
+        '-1 day, 21:30:00'
+
+        >>> try:
+        ...     tz.utcoffset(ambiguous)
+        ... except AmbiguousTimeError:
+        ...     print('Ambiguous')
+        Ambiguous
+
+        '''
+        if dt is None:
+            return None
+        elif dt.tzinfo is not self:
+            dt = self.localize(dt, is_dst)
+            return dt.tzinfo._utcoffset
+        else:
+            return self._utcoffset
+
+    def dst(self, dt, is_dst=None):
+        '''See datetime.tzinfo.dst
+
+        The is_dst parameter may be used to remove ambiguity during DST
+        transitions.
+
+        >>> from pytz import timezone
+        >>> tz = timezone('America/St_Johns')
+
+        >>> normal = datetime(2009, 9, 1)
+
+        >>> str(tz.dst(normal))
+        '1:00:00'
+        >>> str(tz.dst(normal, is_dst=False))
+        '1:00:00'
+        >>> str(tz.dst(normal, is_dst=True))
+        '1:00:00'
+
+        >>> ambiguous = datetime(2009, 10, 31, 23, 30)
+
+        >>> str(tz.dst(ambiguous, is_dst=False))
+        '0:00:00'
+        >>> str(tz.dst(ambiguous, is_dst=True))
+        '1:00:00'
+        >>> try:
+        ...     tz.dst(ambiguous)
+        ... except AmbiguousTimeError:
+        ...     print('Ambiguous')
+        Ambiguous
+
+        '''
+        if dt is None:
+            return None
+        elif dt.tzinfo is not self:
+            dt = self.localize(dt, is_dst)
+            return dt.tzinfo._dst
+        else:
+            return self._dst
+
+    def tzname(self, dt, is_dst=None):
+        '''See datetime.tzinfo.tzname
+
+        The is_dst parameter may be used to remove ambiguity during DST
+        transitions.
+
+        >>> from pytz import timezone
+        >>> tz = timezone('America/St_Johns')
+
+        >>> normal = datetime(2009, 9, 1)
+
+        >>> tz.tzname(normal)
+        'NDT'
+        >>> tz.tzname(normal, is_dst=False)
+        'NDT'
+        >>> tz.tzname(normal, is_dst=True)
+        'NDT'
+
+        >>> ambiguous = datetime(2009, 10, 31, 23, 30)
+
+        >>> tz.tzname(ambiguous, is_dst=False)
+        'NST'
+        >>> tz.tzname(ambiguous, is_dst=True)
+        'NDT'
+        >>> try:
+        ...     tz.tzname(ambiguous)
+        ... except AmbiguousTimeError:
+        ...     print('Ambiguous')
+        Ambiguous
+        '''
+        if dt is None:
+            return self.zone
+        elif dt.tzinfo is not self:
+            dt = self.localize(dt, is_dst)
+            return dt.tzinfo._tzname
+        else:
+            return self._tzname
+
+    def __repr__(self):
+        if self._dst:
+            dst = 'DST'
+        else:
+            dst = 'STD'
+        if self._utcoffset > _notime:
+            return '<DstTzInfo %r %s+%s %s>' % (
+                self.zone, self._tzname, self._utcoffset, dst
+            )
+        else:
+            return '<DstTzInfo %r %s%s %s>' % (
+                self.zone, self._tzname, self._utcoffset, dst
+            )
+
+    def __reduce__(self):
+        # Special pickle to zone remains a singleton and to cope with
+        # database changes.
+        return pytz._p, (
+            self.zone,
+            _to_seconds(self._utcoffset),
+            _to_seconds(self._dst),
+            self._tzname
+        )
+
+
+def unpickler(zone, utcoffset=None, dstoffset=None, tzname=None):
+    """Factory function for unpickling pytz tzinfo instances.
+
+    This is shared for both StaticTzInfo and DstTzInfo instances, because
+    database changes could cause a zones implementation to switch between
+    these two base classes and we can't break pickles on a pytz version
+    upgrade.
+    """
+    # Raises a KeyError if zone no longer exists, which should never happen
+    # and would be a bug.
+    tz = pytz.timezone(zone)
+
+    # A StaticTzInfo - just return it
+    if utcoffset is None:
+        return tz
+
+    # This pickle was created from a DstTzInfo. We need to
+    # determine which of the list of tzinfo instances for this zone
+    # to use in order to restore the state of any datetime instances using
+    # it correctly.
+    utcoffset = memorized_timedelta(utcoffset)
+    dstoffset = memorized_timedelta(dstoffset)
+    try:
+        return tz._tzinfos[(utcoffset, dstoffset, tzname)]
+    except KeyError:
+        # The particular state requested in this timezone no longer exists.
+        # This indicates a corrupt pickle, or the timezone database has been
+        # corrected violently enough to make this particular
+        # (utcoffset,dstoffset) no longer exist in the zone, or the
+        # abbreviation has been changed.
+        pass
+
+    # See if we can find an entry differing only by tzname. Abbreviations
+    # get changed from the initial guess by the database maintainers to
+    # match reality when this information is discovered.
+    for localized_tz in tz._tzinfos.values():
+        if (localized_tz._utcoffset == utcoffset and
+                localized_tz._dst == dstoffset):
+            return localized_tz
+
+    # This (utcoffset, dstoffset) information has been removed from the
+    # zone. Add it back. This might occur when the database maintainers have
+    # corrected incorrect information. datetime instances using this
+    # incorrect information will continue to do so, exactly as they were
+    # before being pickled. This is purely an overly paranoid safety net - I
+    # doubt this will ever been needed in real life.
+    inf = (utcoffset, dstoffset, tzname)
+    tz._tzinfos[inf] = tz.__class__(inf, tz._tzinfos)
+    return tz._tzinfos[inf]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Abidjan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Abidjan
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Abidjan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Accra b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Accra
new file mode 100644
index 0000000000000000000000000000000000000000..d0083ed886487a1594af7f5f8897cf45885aeb71
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Accra differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Addis_Ababa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Addis_Ababa
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Addis_Ababa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Algiers b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Algiers
new file mode 100644
index 0000000000000000000000000000000000000000..6cfd8a16e16ec08c7cd83e6c0e1f9e1bbc5dc18a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Algiers differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmara b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmara
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmara differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmera b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmera
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Asmera differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bamako b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bamako
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bamako differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bangui b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bangui
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bangui differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Banjul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Banjul
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Banjul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bissau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bissau
new file mode 100644
index 0000000000000000000000000000000000000000..82ea5aaf0c6ae2b3ec582013b6d16e6d6f29eb0a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bissau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Blantyre b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Blantyre
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Blantyre differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Brazzaville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Brazzaville
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Brazzaville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bujumbura b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bujumbura
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Bujumbura differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Cairo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Cairo
new file mode 100644
index 0000000000000000000000000000000000000000..d3f819623fc9ef90d327380fad15341ec1a0e202
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Cairo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Casablanca b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Casablanca
new file mode 100644
index 0000000000000000000000000000000000000000..17e0d1b89f093e1e4452a8921ffff9a91287eb4c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Casablanca differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ceuta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ceuta
new file mode 100644
index 0000000000000000000000000000000000000000..850c8f06fa7918684e67e9ab8192ac933dac90b3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ceuta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Conakry b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Conakry
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Conakry differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dakar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dakar
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dakar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dar_es_Salaam b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dar_es_Salaam
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Dar_es_Salaam differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Djibouti b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Djibouti
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Djibouti differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Douala b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Douala
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Douala differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/El_Aaiun b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/El_Aaiun
new file mode 100644
index 0000000000000000000000000000000000000000..64f1b7694418a8c284febe195659c4dd53359b1a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/El_Aaiun differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Freetown b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Freetown
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Freetown differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Gaborone b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Gaborone
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Gaborone differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Harare b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Harare
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Harare differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Johannesburg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Johannesburg
new file mode 100644
index 0000000000000000000000000000000000000000..b1c425daced454f53d7d18fea807bf8d081cf97e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Johannesburg differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Juba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Juba
new file mode 100644
index 0000000000000000000000000000000000000000..06482943a45a58a02a43b9e2b6a3f215b21b045f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Juba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kampala b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kampala
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kampala differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Khartoum b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Khartoum
new file mode 100644
index 0000000000000000000000000000000000000000..8ee8cb92e72d9c507ad0ee06dc6a38406ab06f34
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Khartoum differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kigali b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kigali
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kigali differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kinshasa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kinshasa
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Kinshasa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lagos b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lagos
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lagos differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Libreville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Libreville
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Libreville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lome b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lome
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lome differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Luanda b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Luanda
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Luanda differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lubumbashi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lubumbashi
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lubumbashi differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lusaka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lusaka
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Lusaka differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Malabo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Malabo
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Malabo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maputo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maputo
new file mode 100644
index 0000000000000000000000000000000000000000..52753c0f87bbfa457ada89d400908a3d6537ac0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maputo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maseru b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maseru
new file mode 100644
index 0000000000000000000000000000000000000000..b1c425daced454f53d7d18fea807bf8d081cf97e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Maseru differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mbabane b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mbabane
new file mode 100644
index 0000000000000000000000000000000000000000..b1c425daced454f53d7d18fea807bf8d081cf97e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mbabane differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mogadishu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mogadishu
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Mogadishu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Monrovia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Monrovia
new file mode 100644
index 0000000000000000000000000000000000000000..6d688502a1ca80f2e57a6de2790ac3193879d248
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Monrovia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nairobi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nairobi
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nairobi differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ndjamena b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ndjamena
new file mode 100644
index 0000000000000000000000000000000000000000..a968845e29b8b2b47d4a73f74ae04ef681d7d485
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ndjamena differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Niamey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Niamey
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Niamey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nouakchott b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nouakchott
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Nouakchott differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ouagadougou b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ouagadougou
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Ouagadougou differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Porto-Novo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Porto-Novo
new file mode 100644
index 0000000000000000000000000000000000000000..afb6a4a8fb17b0d4670b8ea1b38f5cc6100244e4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Porto-Novo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Sao_Tome b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Sao_Tome
new file mode 100644
index 0000000000000000000000000000000000000000..59f3759c409a1fb50e632ef5ef613d3fee7af7ef
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Sao_Tome differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Timbuktu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Timbuktu
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Timbuktu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tripoli b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tripoli
new file mode 100644
index 0000000000000000000000000000000000000000..07b393bb7db14cef1e906ebe63cfbbe8cddc79d5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tripoli differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tunis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tunis
new file mode 100644
index 0000000000000000000000000000000000000000..427fa563033fdd8533ae56337fa20befe9719b42
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Tunis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Windhoek b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Windhoek
new file mode 100644
index 0000000000000000000000000000000000000000..abecd137b1fc3220637b22ffea0e7256a58e9377
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Africa/Windhoek differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Adak b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Adak
new file mode 100644
index 0000000000000000000000000000000000000000..43236498f681cc06f64ca2afa613880331fe6fbb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Adak differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anchorage b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anchorage
new file mode 100644
index 0000000000000000000000000000000000000000..9bbb2fd3b361ea8aa4c126d14df5fa370343a63f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anchorage differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anguilla b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anguilla
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Anguilla differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Antigua b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Antigua
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Antigua differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Araguaina b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Araguaina
new file mode 100644
index 0000000000000000000000000000000000000000..49381b4108b1827f24ad7d2c18064a22624092e7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Araguaina differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Buenos_Aires b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Buenos_Aires
new file mode 100644
index 0000000000000000000000000000000000000000..260f86a9180677d86fc3280b06f01d6a6cd91c94
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Buenos_Aires differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Catamarca b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Catamarca
new file mode 100644
index 0000000000000000000000000000000000000000..0ae222a2f8bb2fb1b7abe17d08e076674c51541d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Catamarca differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/ComodRivadavia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/ComodRivadavia
new file mode 100644
index 0000000000000000000000000000000000000000..0ae222a2f8bb2fb1b7abe17d08e076674c51541d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/ComodRivadavia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Cordoba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Cordoba
new file mode 100644
index 0000000000000000000000000000000000000000..da4c23a545b3603bcdd4555ba8feba117802e7b4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Cordoba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Jujuy b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Jujuy
new file mode 100644
index 0000000000000000000000000000000000000000..604b85663672d83658f331a69cc8f41cf2a2b5a1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Jujuy differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/La_Rioja b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/La_Rioja
new file mode 100644
index 0000000000000000000000000000000000000000..2218e36bfdb95ea041b166f183895a6ca4871ab1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/La_Rioja differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Mendoza b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Mendoza
new file mode 100644
index 0000000000000000000000000000000000000000..f9e677f171b3900dfd978eb8ea2aa226557d2c5b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Mendoza differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Rio_Gallegos b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Rio_Gallegos
new file mode 100644
index 0000000000000000000000000000000000000000..c36587e1c292673fa537cecf729f4c873d375c9a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Rio_Gallegos differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Salta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Salta
new file mode 100644
index 0000000000000000000000000000000000000000..0e797f2215ab398bc59b8e4d60e5260fcb365c3b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Salta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Juan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Juan
new file mode 100644
index 0000000000000000000000000000000000000000..2698495bb3f953685e45edb916798cd24f772664
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Juan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Luis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Luis
new file mode 100644
index 0000000000000000000000000000000000000000..fe50f6211cff908f21257cb42259fe2692abdc4e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/San_Luis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Tucuman b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Tucuman
new file mode 100644
index 0000000000000000000000000000000000000000..c954000ba9b28204cc3223628d13e9dcfa4b6eb0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Tucuman differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Ushuaia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Ushuaia
new file mode 100644
index 0000000000000000000000000000000000000000..3643628a24723239a13d61b2215c907cdba03985
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Argentina/Ushuaia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Aruba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Aruba
new file mode 100644
index 0000000000000000000000000000000000000000..f7ab6efcc0f5bfd5c4172cbe32c03a8e08b0099c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Aruba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Asuncion b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Asuncion
new file mode 100644
index 0000000000000000000000000000000000000000..2f3bbda6d3586a2ef5b94bc28ff37906fbc758f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Asuncion differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atikokan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atikokan
new file mode 100644
index 0000000000000000000000000000000000000000..629ed4231944255aaa0725f807517df48b39e135
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atikokan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atka
new file mode 100644
index 0000000000000000000000000000000000000000..43236498f681cc06f64ca2afa613880331fe6fbb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Atka differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia
new file mode 100644
index 0000000000000000000000000000000000000000..15808d30fb1bb250cce195a00a2d7dca321df7d3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia_Banderas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia_Banderas
new file mode 100644
index 0000000000000000000000000000000000000000..896af3f56abd712e2fa85d69592bd33b88d364bc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bahia_Banderas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Barbados b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Barbados
new file mode 100644
index 0000000000000000000000000000000000000000..9b90e306a68c3285f6cd2de26d02cf8e7106ae8e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Barbados differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belem b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belem
new file mode 100644
index 0000000000000000000000000000000000000000..60b5924dc12f14c274073b1fe4ccc590b742da5a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belem differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belize b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belize
new file mode 100644
index 0000000000000000000000000000000000000000..e6f5dfa6a8d82523e8cb12f17cf73560bc09a383
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Belize differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Blanc-Sablon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Blanc-Sablon
new file mode 100644
index 0000000000000000000000000000000000000000..f9f13a1679fa9ca7cee6a41bf094a861d4c6824a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Blanc-Sablon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boa_Vista b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boa_Vista
new file mode 100644
index 0000000000000000000000000000000000000000..978c33100fb2d9b14c1faa581890c16c8747b42b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boa_Vista differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bogota b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bogota
new file mode 100644
index 0000000000000000000000000000000000000000..b2647d7a837637d3b85d4bc85f83c88982597faf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Bogota differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boise b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boise
new file mode 100644
index 0000000000000000000000000000000000000000..f8d54e27479149d35f6ddff12f709096f08bfac3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Boise differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Buenos_Aires b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Buenos_Aires
new file mode 100644
index 0000000000000000000000000000000000000000..260f86a9180677d86fc3280b06f01d6a6cd91c94
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Buenos_Aires differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cambridge_Bay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cambridge_Bay
new file mode 100644
index 0000000000000000000000000000000000000000..f8db4b6ebf5b66d3d566fc3975d6151783f6e645
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cambridge_Bay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Campo_Grande b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Campo_Grande
new file mode 100644
index 0000000000000000000000000000000000000000..81206247d9efa7d3dd10dd9e88c669718d86cc50
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Campo_Grande differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cancun b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cancun
new file mode 100644
index 0000000000000000000000000000000000000000..f907f0a5ba77b9ec845c450cd535ee589b46c5ad
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cancun differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Caracas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Caracas
new file mode 100644
index 0000000000000000000000000000000000000000..eedf725e8de1a61c4db886ce8b8b60fb4ee91c77
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Caracas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Catamarca b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Catamarca
new file mode 100644
index 0000000000000000000000000000000000000000..0ae222a2f8bb2fb1b7abe17d08e076674c51541d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Catamarca differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayenne b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayenne
new file mode 100644
index 0000000000000000000000000000000000000000..e5bc06fdbe5a3062f90274a6b5cc5c56e2d74d5f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayenne differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayman b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayman
new file mode 100644
index 0000000000000000000000000000000000000000..9964b9a33452f4b636f43703b7cdec4891cbda5f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cayman differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chicago b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chicago
new file mode 100644
index 0000000000000000000000000000000000000000..a5b1617c7f70bfc77b7d504aaa3f23603082c3cb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chicago differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chihuahua b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chihuahua
new file mode 100644
index 0000000000000000000000000000000000000000..8ed5f93b02001a63ce43dd221ff48cc5faa6752e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Chihuahua differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Coral_Harbour b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Coral_Harbour
new file mode 100644
index 0000000000000000000000000000000000000000..629ed4231944255aaa0725f807517df48b39e135
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Coral_Harbour differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cordoba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cordoba
new file mode 100644
index 0000000000000000000000000000000000000000..da4c23a545b3603bcdd4555ba8feba117802e7b4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cordoba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Costa_Rica b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Costa_Rica
new file mode 100644
index 0000000000000000000000000000000000000000..37cb85e4dbfb7ac9c01eecf584a1a721ed251e93
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Costa_Rica differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Creston b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Creston
new file mode 100644
index 0000000000000000000000000000000000000000..ca648573e483c86c1ca09d6d5be131877398c8f9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Creston differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cuiaba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cuiaba
new file mode 100644
index 0000000000000000000000000000000000000000..9bea3d4079f4449d5bed22b81404b5ee2ab6394a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Cuiaba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Curacao b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Curacao
new file mode 100644
index 0000000000000000000000000000000000000000..f7ab6efcc0f5bfd5c4172cbe32c03a8e08b0099c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Curacao differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Danmarkshavn b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Danmarkshavn
new file mode 100644
index 0000000000000000000000000000000000000000..9549adcb657569ea304592a4070ceecb4550a4db
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Danmarkshavn differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson
new file mode 100644
index 0000000000000000000000000000000000000000..343b63227d2185863cd720bf449de000bbc794d0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson_Creek b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson_Creek
new file mode 100644
index 0000000000000000000000000000000000000000..db9e3396557652707c0c2232e119e13a2dd172fb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dawson_Creek differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Denver b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Denver
new file mode 100644
index 0000000000000000000000000000000000000000..5fbe26b1d93d1acb2561c390c1e097d07f1a262e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Denver differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Detroit b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Detroit
new file mode 100644
index 0000000000000000000000000000000000000000..e104faa46545ee873295cde34e1d46bccad8647c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Detroit differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dominica b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dominica
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Dominica differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Edmonton b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Edmonton
new file mode 100644
index 0000000000000000000000000000000000000000..cd78a6f8be1dd55ac5afd25bbae39bd5706e42d1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Edmonton differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Eirunepe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Eirunepe
new file mode 100644
index 0000000000000000000000000000000000000000..39d6daeb9b6dd3b225b0ddacceb6984e8204ac7d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Eirunepe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/El_Salvador b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/El_Salvador
new file mode 100644
index 0000000000000000000000000000000000000000..e2f22304aad56062cfb66d23f3a8c296689286ed
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/El_Salvador differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ensenada b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ensenada
new file mode 100644
index 0000000000000000000000000000000000000000..ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ensenada differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Nelson b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Nelson
new file mode 100644
index 0000000000000000000000000000000000000000..5a0b7f1ca032be1adf8ba91f863e727c5ec6a026
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Nelson differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Wayne b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Wayne
new file mode 100644
index 0000000000000000000000000000000000000000..09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fort_Wayne differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fortaleza b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fortaleza
new file mode 100644
index 0000000000000000000000000000000000000000..be57dc20b46142787cbd820e0d1c927d2f02f046
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Fortaleza differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Glace_Bay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Glace_Bay
new file mode 100644
index 0000000000000000000000000000000000000000..48412a4cbf9241ea83887876b1b8b22c367ff4fd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Glace_Bay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Godthab b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Godthab
new file mode 100644
index 0000000000000000000000000000000000000000..0160308bf63690a6dee51c3c8849f494a47186c2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Godthab differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Goose_Bay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Goose_Bay
new file mode 100644
index 0000000000000000000000000000000000000000..a3f299079aebb8524bf77e7f92e0a7e6d0a7b6fb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Goose_Bay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grand_Turk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grand_Turk
new file mode 100644
index 0000000000000000000000000000000000000000..06da1a6d7a3eeec0e82f7c5815a8fed4252e16b2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grand_Turk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grenada b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grenada
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Grenada differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guadeloupe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guadeloupe
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guadeloupe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guatemala b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guatemala
new file mode 100644
index 0000000000000000000000000000000000000000..407138caf94e467b52d925f96ad80b506e16d9ec
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guatemala differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guayaquil b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guayaquil
new file mode 100644
index 0000000000000000000000000000000000000000..0559a7a4a4288d7e3c3b1bcf47c57a7ea82be2ef
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guayaquil differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guyana b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guyana
new file mode 100644
index 0000000000000000000000000000000000000000..d5dab14969306692ae95a1e9434252737b6c4b9d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Guyana differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Halifax b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Halifax
new file mode 100644
index 0000000000000000000000000000000000000000..756099abe6cee44295a5566ad6cd0c352fb82e64
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Halifax differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Havana b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Havana
new file mode 100644
index 0000000000000000000000000000000000000000..b69ac4510784f23ee794cd6d11e62315a7318e5e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Havana differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Hermosillo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Hermosillo
new file mode 100644
index 0000000000000000000000000000000000000000..791a9fa2b38729ff10032f9e1f021754c76c87f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Hermosillo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Indianapolis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Indianapolis
new file mode 100644
index 0000000000000000000000000000000000000000..09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Indianapolis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Knox b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Knox
new file mode 100644
index 0000000000000000000000000000000000000000..fcd408d74df43310a9a85c475f83d545f6d75911
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Knox differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Marengo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Marengo
new file mode 100644
index 0000000000000000000000000000000000000000..1abf75e7e864625b975feebdd0b232d0de624b27
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Marengo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Petersburg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Petersburg
new file mode 100644
index 0000000000000000000000000000000000000000..0133548ecac014f4b37f0abcd471a5a6b4e7ed5f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Petersburg differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Tell_City b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Tell_City
new file mode 100644
index 0000000000000000000000000000000000000000..7bbb653cd7ce09d88f8a1701853bfe92ac7db0c4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Tell_City differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vevay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vevay
new file mode 100644
index 0000000000000000000000000000000000000000..d236b7c07726828984d3afbfa872b3abeae3e809
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vevay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vincennes b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vincennes
new file mode 100644
index 0000000000000000000000000000000000000000..c818929d19b2ca5925c181696f02a2ba93a7009a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Vincennes differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Winamac b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Winamac
new file mode 100644
index 0000000000000000000000000000000000000000..630935c1e1a8c1a87e728fc1dcc4c930e81b30e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indiana/Winamac differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indianapolis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indianapolis
new file mode 100644
index 0000000000000000000000000000000000000000..09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Indianapolis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Inuvik b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Inuvik
new file mode 100644
index 0000000000000000000000000000000000000000..87bb355295a3efcacd4baecb5a8bfa3fb9ce9c54
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Inuvik differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Iqaluit b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Iqaluit
new file mode 100644
index 0000000000000000000000000000000000000000..c8138bdbb3cf141ad42ace037e144bee98d81481
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Iqaluit differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jamaica b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jamaica
new file mode 100644
index 0000000000000000000000000000000000000000..2a9b7fd52d37a1ffe9fc589daa04d88c6c71a6e0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jamaica differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jujuy b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jujuy
new file mode 100644
index 0000000000000000000000000000000000000000..604b85663672d83658f331a69cc8f41cf2a2b5a1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Jujuy differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Juneau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Juneau
new file mode 100644
index 0000000000000000000000000000000000000000..451f3490096338f40e601628ac70f04112ace51d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Juneau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Louisville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Louisville
new file mode 100644
index 0000000000000000000000000000000000000000..177836e4fd98399bd4cdda410648cc286408b95b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Louisville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Monticello b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Monticello
new file mode 100644
index 0000000000000000000000000000000000000000..438e3eab4a6e581c6f5e7661098bf07b1a000593
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kentucky/Monticello differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Knox_IN b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Knox_IN
new file mode 100644
index 0000000000000000000000000000000000000000..fcd408d74df43310a9a85c475f83d545f6d75911
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Knox_IN differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kralendijk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kralendijk
new file mode 100644
index 0000000000000000000000000000000000000000..f7ab6efcc0f5bfd5c4172cbe32c03a8e08b0099c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Kralendijk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/La_Paz b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/La_Paz
new file mode 100644
index 0000000000000000000000000000000000000000..a10137243577a8b312dc463571c4c94ecd3bf1f1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/La_Paz differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lima b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lima
new file mode 100644
index 0000000000000000000000000000000000000000..3c6529b7567f032882863fcd48b790e0988261bf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lima differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Los_Angeles b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Los_Angeles
new file mode 100644
index 0000000000000000000000000000000000000000..9dad4f4c75b373635ccbe634798f8d9e587e36c1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Los_Angeles differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Louisville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Louisville
new file mode 100644
index 0000000000000000000000000000000000000000..177836e4fd98399bd4cdda410648cc286408b95b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Louisville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lower_Princes b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lower_Princes
new file mode 100644
index 0000000000000000000000000000000000000000..f7ab6efcc0f5bfd5c4172cbe32c03a8e08b0099c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Lower_Princes differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Maceio b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Maceio
new file mode 100644
index 0000000000000000000000000000000000000000..bc8b951d2e880182a369cba8fae1270e40694aaa
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Maceio differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Managua b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Managua
new file mode 100644
index 0000000000000000000000000000000000000000..e0242bff6e5df45de8b235abb4a8405fbb8ba6a6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Managua differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Manaus b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Manaus
new file mode 100644
index 0000000000000000000000000000000000000000..63d58f80f556e1c3135d6dbcb2a2dfc6f61b4fc9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Manaus differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Marigot b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Marigot
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Marigot differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Martinique b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Martinique
new file mode 100644
index 0000000000000000000000000000000000000000..8df43dcf1c9f63d3ea9f056f062ea97e5c7c0b57
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Martinique differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Matamoros b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Matamoros
new file mode 100644
index 0000000000000000000000000000000000000000..047968dfff4dba196d5c9695e79cf28395d9a0aa
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Matamoros differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mazatlan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mazatlan
new file mode 100644
index 0000000000000000000000000000000000000000..e4a785743d75f939c3e4798ebe7c79d38e4cfd08
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mazatlan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mendoza b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mendoza
new file mode 100644
index 0000000000000000000000000000000000000000..f9e677f171b3900dfd978eb8ea2aa226557d2c5b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mendoza differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Menominee b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Menominee
new file mode 100644
index 0000000000000000000000000000000000000000..314613866de53e1457f6cbf2fb617be7e4955edf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Menominee differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Merida b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Merida
new file mode 100644
index 0000000000000000000000000000000000000000..ea852da33a81478433a389e2b4da03b425d9f764
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Merida differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Metlakatla b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Metlakatla
new file mode 100644
index 0000000000000000000000000000000000000000..1e94be3d552ea0d6e29824469866c2a51a187be9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Metlakatla differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mexico_City b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mexico_City
new file mode 100644
index 0000000000000000000000000000000000000000..e7fb6f2953d123efbc2550f450decd794b017d4f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Mexico_City differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Miquelon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Miquelon
new file mode 100644
index 0000000000000000000000000000000000000000..b924b7100438cfacf25c56c494fd1abf3f262100
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Miquelon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Moncton b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Moncton
new file mode 100644
index 0000000000000000000000000000000000000000..9df8d0f2ec9fc8f1974d83cdd8155c79340007ed
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Moncton differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Monterrey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Monterrey
new file mode 100644
index 0000000000000000000000000000000000000000..a8928c8dc94aaebfaf9cdeb93011d41b482a4cc6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Monterrey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montevideo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montevideo
new file mode 100644
index 0000000000000000000000000000000000000000..2f357bcf50da794541a518510777bd5c470b9b77
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montevideo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montreal b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montreal
new file mode 100644
index 0000000000000000000000000000000000000000..6752c5b05285678b86aea170f0921fc5f5e57738
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montreal differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montserrat b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montserrat
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Montserrat differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nassau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nassau
new file mode 100644
index 0000000000000000000000000000000000000000..d807a61d4e9b725648fbbfb1bd6c93046d9785aa
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nassau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/New_York b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/New_York
new file mode 100644
index 0000000000000000000000000000000000000000..2f75480e069b60b6c58a9137c7eebd4796f74226
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/New_York differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nipigon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nipigon
new file mode 100644
index 0000000000000000000000000000000000000000..f6a856e693420d6d989c45acff2c48b60db69186
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nipigon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nome b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nome
new file mode 100644
index 0000000000000000000000000000000000000000..10998df3bbe67aa8a02602301d10ec2b2c33006b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nome differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Noronha b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Noronha
new file mode 100644
index 0000000000000000000000000000000000000000..f140726f2a6945357b325f0bb452dce7557bbff7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Noronha differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Beulah b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Beulah
new file mode 100644
index 0000000000000000000000000000000000000000..246345dde7cada7b0de81cc23fabc66b60d51e79
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Beulah differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Center b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Center
new file mode 100644
index 0000000000000000000000000000000000000000..1fa0703778034551487b7b55d80d41ad220f2102
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/Center differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/New_Salem b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/New_Salem
new file mode 100644
index 0000000000000000000000000000000000000000..123f2aeecfc88f2e543f99d6a859e02788170852
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/North_Dakota/New_Salem differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nuuk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nuuk
new file mode 100644
index 0000000000000000000000000000000000000000..0160308bf63690a6dee51c3c8849f494a47186c2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Nuuk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ojinaga b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ojinaga
new file mode 100644
index 0000000000000000000000000000000000000000..fc4a03e36931bbca9b00e0344d3659e4af700be5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Ojinaga differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Panama b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Panama
new file mode 100644
index 0000000000000000000000000000000000000000..9964b9a33452f4b636f43703b7cdec4891cbda5f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Panama differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Pangnirtung b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Pangnirtung
new file mode 100644
index 0000000000000000000000000000000000000000..3e4e0db6ae0a5a704f8cdd549071cc5b7124e2fd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Pangnirtung differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Paramaribo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Paramaribo
new file mode 100644
index 0000000000000000000000000000000000000000..bc8a6edf1331b6912c26e81078b00c8e5d87ffdf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Paramaribo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Phoenix b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Phoenix
new file mode 100644
index 0000000000000000000000000000000000000000..ac6bb0c78291f1e341f42c34639458fb385bf8ed
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Phoenix differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port-au-Prince b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port-au-Prince
new file mode 100644
index 0000000000000000000000000000000000000000..287f1439266639f9564149d6e162feaba3fbed86
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port-au-Prince differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port_of_Spain b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port_of_Spain
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Port_of_Spain differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Acre b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Acre
new file mode 100644
index 0000000000000000000000000000000000000000..a374cb43d98bfbd06c82ca306a74f96993fd5657
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Acre differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Velho b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Velho
new file mode 100644
index 0000000000000000000000000000000000000000..2e873a5aa868c5605443c48510646f1408d58c4a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Porto_Velho differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Puerto_Rico b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Puerto_Rico
new file mode 100644
index 0000000000000000000000000000000000000000..a662a57137b69e8ba445e899566222cdd422a764
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Puerto_Rico differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Punta_Arenas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Punta_Arenas
new file mode 100644
index 0000000000000000000000000000000000000000..a5a8af52c2f26baf6f85a1786f69593491ad5195
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Punta_Arenas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rainy_River b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rainy_River
new file mode 100644
index 0000000000000000000000000000000000000000..ea66099155ca930810062eebcfbc7fc99e97097f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rainy_River differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rankin_Inlet b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rankin_Inlet
new file mode 100644
index 0000000000000000000000000000000000000000..3a70587472c633aaa178c7f979b8b3884d604372
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rankin_Inlet differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Recife b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Recife
new file mode 100644
index 0000000000000000000000000000000000000000..d7abb168a7434579852b7533fe062fed9297ec2b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Recife differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Regina b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Regina
new file mode 100644
index 0000000000000000000000000000000000000000..20c9c84df491e4072ec4c5d2c931a7433d9fd394
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Regina differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Resolute b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Resolute
new file mode 100644
index 0000000000000000000000000000000000000000..0a73b753ba597f89cd57cc3875e7869dc133778c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Resolute differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rio_Branco b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rio_Branco
new file mode 100644
index 0000000000000000000000000000000000000000..a374cb43d98bfbd06c82ca306a74f96993fd5657
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rio_Branco differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rosario b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rosario
new file mode 100644
index 0000000000000000000000000000000000000000..da4c23a545b3603bcdd4555ba8feba117802e7b4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Rosario differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santa_Isabel b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santa_Isabel
new file mode 100644
index 0000000000000000000000000000000000000000..ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santa_Isabel differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santarem b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santarem
new file mode 100644
index 0000000000000000000000000000000000000000..c28f36063bd264e932a1910861e884d2a1669b00
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santarem differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santiago b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santiago
new file mode 100644
index 0000000000000000000000000000000000000000..816a0428188d99f437004312ee73c3860ee0f54f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santiago differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santo_Domingo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santo_Domingo
new file mode 100644
index 0000000000000000000000000000000000000000..4fe36fd4c11f998ba3f626c5e23d97bd82d12791
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Santo_Domingo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sao_Paulo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sao_Paulo
new file mode 100644
index 0000000000000000000000000000000000000000..13ff083869a9ac8476775587de8476654a100017
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sao_Paulo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Scoresbysund b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Scoresbysund
new file mode 100644
index 0000000000000000000000000000000000000000..e20e9e1c4272adc40c07562bb3d6767cb056b550
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Scoresbysund differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Shiprock b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Shiprock
new file mode 100644
index 0000000000000000000000000000000000000000..5fbe26b1d93d1acb2561c390c1e097d07f1a262e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Shiprock differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sitka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sitka
new file mode 100644
index 0000000000000000000000000000000000000000..31f7061371910ad42e4310b7a646ba1a98b6cba4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Sitka differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Barthelemy b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Barthelemy
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Barthelemy differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Johns b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Johns
new file mode 100644
index 0000000000000000000000000000000000000000..65a5b0c720dad151ffdcba3dbe91c8bd638845c6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Johns differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Kitts b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Kitts
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Kitts differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Lucia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Lucia
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Lucia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Thomas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Thomas
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Thomas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Vincent b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Vincent
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/St_Vincent differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Swift_Current b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Swift_Current
new file mode 100644
index 0000000000000000000000000000000000000000..8e9ef255eeb11515b84126d9ee5c0c6b3c72f2a0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Swift_Current differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tegucigalpa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tegucigalpa
new file mode 100644
index 0000000000000000000000000000000000000000..2adacb2e500e2f9621b2debc1756d308747b67f6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tegucigalpa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thule b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thule
new file mode 100644
index 0000000000000000000000000000000000000000..6f802f1c2acf9cc73481ae86c9e099fcfc28cf25
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thule differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thunder_Bay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thunder_Bay
new file mode 100644
index 0000000000000000000000000000000000000000..e504c9acf198fbd447221f120354774e46dbbcc0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Thunder_Bay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tijuana b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tijuana
new file mode 100644
index 0000000000000000000000000000000000000000..ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tijuana differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Toronto b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Toronto
new file mode 100644
index 0000000000000000000000000000000000000000..6752c5b05285678b86aea170f0921fc5f5e57738
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Toronto differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tortola b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tortola
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Tortola differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Vancouver b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Vancouver
new file mode 100644
index 0000000000000000000000000000000000000000..bb60cbced30763c08b6cf73554c8d6651ff387d0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Vancouver differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Virgin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Virgin
new file mode 100644
index 0000000000000000000000000000000000000000..697cf5bcf7f151ffc1c1fc4247e4e9c7e3ff01a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Virgin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Whitehorse b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Whitehorse
new file mode 100644
index 0000000000000000000000000000000000000000..9ee229c0eb82c6aea7359e0b38677264f3cad8ab
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Whitehorse differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Winnipeg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Winnipeg
new file mode 100644
index 0000000000000000000000000000000000000000..ac40299f6b27043e8f2454ac594b0ec184c1a237
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Winnipeg differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yakutat b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yakutat
new file mode 100644
index 0000000000000000000000000000000000000000..da209f9f0a07625ec83d4ec84917216347f5687f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yakutat differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yellowknife b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yellowknife
new file mode 100644
index 0000000000000000000000000000000000000000..e6afa390e879f97cef351e382ae62daf183e8d77
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/America/Yellowknife differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Casey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Casey
new file mode 100644
index 0000000000000000000000000000000000000000..cbcbe4e339d934f57725542db534641292fd077c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Casey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Davis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Davis
new file mode 100644
index 0000000000000000000000000000000000000000..916f2c25926bf444b7c366110a29a3fafb17fbc0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Davis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/DumontDUrville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/DumontDUrville
new file mode 100644
index 0000000000000000000000000000000000000000..a71b39c0046b02c20e17d33d333e5af0b01eced2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/DumontDUrville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Macquarie b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Macquarie
new file mode 100644
index 0000000000000000000000000000000000000000..9e7cc687d76b00d8f112245d5c5d2f20a2a61814
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Macquarie differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Mawson b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Mawson
new file mode 100644
index 0000000000000000000000000000000000000000..b32e7fd6c6a3faddaa98dec06b88dcca3574486f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Mawson differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/McMurdo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/McMurdo
new file mode 100644
index 0000000000000000000000000000000000000000..6575fdce31183d8238b18f2f30ab5b9227c7071c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/McMurdo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Palmer b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Palmer
new file mode 100644
index 0000000000000000000000000000000000000000..3dd85f84ff48fb8553b4a964659872ae1fb7d33d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Palmer differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Rothera b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Rothera
new file mode 100644
index 0000000000000000000000000000000000000000..8b2430a20eb481b488fccd5f1a966d06bfa214b9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Rothera differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/South_Pole b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/South_Pole
new file mode 100644
index 0000000000000000000000000000000000000000..6575fdce31183d8238b18f2f30ab5b9227c7071c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/South_Pole differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Syowa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Syowa
new file mode 100644
index 0000000000000000000000000000000000000000..254af7d12f38af0abd6302a4df574e45b50d1805
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Syowa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Troll b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Troll
new file mode 100644
index 0000000000000000000000000000000000000000..5e565da2f6b138b70179cb7e72347163ab44b6ab
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Troll differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Vostok b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Vostok
new file mode 100644
index 0000000000000000000000000000000000000000..728305305df3d82fca7829ff3e9581583758dbeb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Antarctica/Vostok differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Arctic/Longyearbyen b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Arctic/Longyearbyen
new file mode 100644
index 0000000000000000000000000000000000000000..15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Arctic/Longyearbyen differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aden b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aden
new file mode 100644
index 0000000000000000000000000000000000000000..2aea25f8c210369e0b805d0dd5f0e899190c2340
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aden differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Almaty b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Almaty
new file mode 100644
index 0000000000000000000000000000000000000000..a4b00779005803d665d613e326bb77d86f45ebd8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Almaty differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Amman b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Amman
new file mode 100644
index 0000000000000000000000000000000000000000..c9e8707912d45ec0f9eaf56d46877fe9289d4a11
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Amman differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Anadyr b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Anadyr
new file mode 100644
index 0000000000000000000000000000000000000000..6ed8b7cb07634b9d669c6c36448fb8df0fdb32a3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Anadyr differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtau
new file mode 100644
index 0000000000000000000000000000000000000000..e2d0f919541fc9d64f01d8c6128c7e73a94869cf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtobe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtobe
new file mode 100644
index 0000000000000000000000000000000000000000..06f0a13a662aacfa70c489d2fec5276362576089
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Aqtobe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashgabat b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashgabat
new file mode 100644
index 0000000000000000000000000000000000000000..73891af1ee95a4d5d602967fd5a965c8a7ec1327
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashgabat differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashkhabad b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashkhabad
new file mode 100644
index 0000000000000000000000000000000000000000..73891af1ee95a4d5d602967fd5a965c8a7ec1327
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ashkhabad differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Atyrau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Atyrau
new file mode 100644
index 0000000000000000000000000000000000000000..8b5153e0545f550c6f9b0da9ce134a8a7a4ebe36
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Atyrau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baghdad b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baghdad
new file mode 100644
index 0000000000000000000000000000000000000000..f7162edf93c28193436cc379c0dfe4185e368a42
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baghdad differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bahrain b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bahrain
new file mode 100644
index 0000000000000000000000000000000000000000..63188b269d077e29f48a42a03c2a52aefdb61320
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bahrain differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baku b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baku
new file mode 100644
index 0000000000000000000000000000000000000000..a0de74b958e42ade6f93ec0c4bc06ae714d5c606
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Baku differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bangkok b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bangkok
new file mode 100644
index 0000000000000000000000000000000000000000..c292ac5b5f489a88bf10a1263b14e7412479d9e7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bangkok differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Barnaul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Barnaul
new file mode 100644
index 0000000000000000000000000000000000000000..759592a255408caf354d0c4a2e406ee5a1638181
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Barnaul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Beirut b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Beirut
new file mode 100644
index 0000000000000000000000000000000000000000..fb266ede2279b6aff913538d9d5aae3935e53aeb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Beirut differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bishkek b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bishkek
new file mode 100644
index 0000000000000000000000000000000000000000..f6e20dd3a85eadd3dcc28cf59f3acc5b95584f0e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Bishkek differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Brunei b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Brunei
new file mode 100644
index 0000000000000000000000000000000000000000..3dab0abf4ed950f46a23282c59f6f6fa3b6ba758
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Brunei differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Calcutta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Calcutta
new file mode 100644
index 0000000000000000000000000000000000000000..0014046d29a38e9b8006f746fea794d7f71eb479
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Calcutta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chita b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chita
new file mode 100644
index 0000000000000000000000000000000000000000..c4149c05ce2638c976aec0d18eb7567c7276bc80
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chita differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Choibalsan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Choibalsan
new file mode 100644
index 0000000000000000000000000000000000000000..e48daa82435078a2a731225ee963b30a48f78ce1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Choibalsan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chongqing b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chongqing
new file mode 100644
index 0000000000000000000000000000000000000000..91f6f8bc2e234bafd484146986bdb289082c3588
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chongqing differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chungking b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chungking
new file mode 100644
index 0000000000000000000000000000000000000000..91f6f8bc2e234bafd484146986bdb289082c3588
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Chungking differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Colombo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Colombo
new file mode 100644
index 0000000000000000000000000000000000000000..62c64d85dfbdc41ae8e78bc8304ceb35b16b4255
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Colombo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dacca b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dacca
new file mode 100644
index 0000000000000000000000000000000000000000..b11c92841068c12a5d0102402127ff4537a66899
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dacca differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Damascus b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Damascus
new file mode 100644
index 0000000000000000000000000000000000000000..d9104a7ab8cb13b4c87eb25ff633b03ec12ddd81
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Damascus differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dhaka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dhaka
new file mode 100644
index 0000000000000000000000000000000000000000..b11c92841068c12a5d0102402127ff4537a66899
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dhaka differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dili b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dili
new file mode 100644
index 0000000000000000000000000000000000000000..30943bbd0a8251404c407cde82243294071baf22
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dili differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dubai b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dubai
new file mode 100644
index 0000000000000000000000000000000000000000..fc0a589e2b22acd9a76e402f0e7ef3c7b0547148
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dubai differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dushanbe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dushanbe
new file mode 100644
index 0000000000000000000000000000000000000000..82d85b8c1b387ffc54acf509ac75220465b64d4c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Dushanbe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Famagusta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Famagusta
new file mode 100644
index 0000000000000000000000000000000000000000..653b146a60e5e5641a07bfc82f9590dad1ed69f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Famagusta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Gaza b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Gaza
new file mode 100644
index 0000000000000000000000000000000000000000..a4ca1c6e028f91977916e3ab1f45d5be135eea02
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Gaza differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Harbin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Harbin
new file mode 100644
index 0000000000000000000000000000000000000000..91f6f8bc2e234bafd484146986bdb289082c3588
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Harbin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hebron b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hebron
new file mode 100644
index 0000000000000000000000000000000000000000..1a206a70c7da285a55cf3790e116e633fbd0a14a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hebron differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ho_Chi_Minh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ho_Chi_Minh
new file mode 100644
index 0000000000000000000000000000000000000000..e2934e371b6d5cf80244d8d55594f7094bc9cbb8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ho_Chi_Minh differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hong_Kong b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hong_Kong
new file mode 100644
index 0000000000000000000000000000000000000000..23d0375fba3377a3d513d849c0d29c82ad2add64
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hong_Kong differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hovd b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hovd
new file mode 100644
index 0000000000000000000000000000000000000000..4cb800a9187901afa985f1ae67565d654021cabc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Hovd differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Irkutsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Irkutsk
new file mode 100644
index 0000000000000000000000000000000000000000..4dcbbb7ea21e193cd2e2578a17bc955caea227a4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Irkutsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Istanbul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Istanbul
new file mode 100644
index 0000000000000000000000000000000000000000..508446bb6aee2841ab88e82607a6ad6e748e7db7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Istanbul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jakarta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jakarta
new file mode 100644
index 0000000000000000000000000000000000000000..5baa3a8f2ed24f68c49bd7e3ccd4772a8e734414
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jakarta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jayapura b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jayapura
new file mode 100644
index 0000000000000000000000000000000000000000..3002c82022f7e9a4ff1ad545ea617106a13b24e0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jayapura differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jerusalem b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jerusalem
new file mode 100644
index 0000000000000000000000000000000000000000..1ebd0664aa29c0abd722661f761031ec0304631c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Jerusalem differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kabul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kabul
new file mode 100644
index 0000000000000000000000000000000000000000..d19b9bd51d701d8bfe7b3e95c9f6f3c736a9aeee
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kabul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kamchatka b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kamchatka
new file mode 100644
index 0000000000000000000000000000000000000000..3e80b4e09f792e37422ffafe42355aeb3e6940eb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kamchatka differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Karachi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Karachi
new file mode 100644
index 0000000000000000000000000000000000000000..ba65c0e8d31cb1d59935878af29baac722f45936
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Karachi differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kashgar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kashgar
new file mode 100644
index 0000000000000000000000000000000000000000..faa14d92d58fa883c4203022e091dc9154ac92dc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kashgar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kathmandu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kathmandu
new file mode 100644
index 0000000000000000000000000000000000000000..a5d510753f02d5dedcf1ffac153558466dca9b99
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kathmandu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Katmandu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Katmandu
new file mode 100644
index 0000000000000000000000000000000000000000..a5d510753f02d5dedcf1ffac153558466dca9b99
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Katmandu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Khandyga b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Khandyga
new file mode 100644
index 0000000000000000000000000000000000000000..72bea64ba83546e72ff9d6a4f9a9e64cc2d93b47
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Khandyga differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kolkata b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kolkata
new file mode 100644
index 0000000000000000000000000000000000000000..0014046d29a38e9b8006f746fea794d7f71eb479
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kolkata differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Krasnoyarsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Krasnoyarsk
new file mode 100644
index 0000000000000000000000000000000000000000..30c6f165052efa4fbc176cbcf19b626b1615d88b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Krasnoyarsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuala_Lumpur b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuala_Lumpur
new file mode 100644
index 0000000000000000000000000000000000000000..612b01e71cf873b7f8a80d25d7906d77aa91ca5c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuala_Lumpur differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuching b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuching
new file mode 100644
index 0000000000000000000000000000000000000000..c86750cb7d512966b1a8b19cb44531a618b00930
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuching differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuwait b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuwait
new file mode 100644
index 0000000000000000000000000000000000000000..2aea25f8c210369e0b805d0dd5f0e899190c2340
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Kuwait differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macao b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macao
new file mode 100644
index 0000000000000000000000000000000000000000..cac65063d0dbf48e37c547fba3b67f34110d5a90
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macao differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macau
new file mode 100644
index 0000000000000000000000000000000000000000..cac65063d0dbf48e37c547fba3b67f34110d5a90
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Macau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Magadan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Magadan
new file mode 100644
index 0000000000000000000000000000000000000000..b4fcac18e3540f029f01bbf2751045b3983d96fa
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Magadan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Makassar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Makassar
new file mode 100644
index 0000000000000000000000000000000000000000..556ba866933d37f3cfcf8042045d64e209bae30f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Makassar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Manila b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Manila
new file mode 100644
index 0000000000000000000000000000000000000000..f4f4b04efa2b6a442d4072b3899f4dae69bdd771
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Manila differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Muscat b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Muscat
new file mode 100644
index 0000000000000000000000000000000000000000..fc0a589e2b22acd9a76e402f0e7ef3c7b0547148
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Muscat differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Nicosia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Nicosia
new file mode 100644
index 0000000000000000000000000000000000000000..f7f10ab7665e94ca44fd8cd98a362cd4b304eff1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Nicosia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novokuznetsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novokuznetsk
new file mode 100644
index 0000000000000000000000000000000000000000..d983276119c95872882589a9fdd829eb1f86f606
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novokuznetsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novosibirsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novosibirsk
new file mode 100644
index 0000000000000000000000000000000000000000..e0ee5fcea981010008b7b9dc3af1cdd53363128c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Novosibirsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Omsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Omsk
new file mode 100644
index 0000000000000000000000000000000000000000..b29b7693118fb1ed214adb8a4e686172d0914b2f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Omsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Oral b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Oral
new file mode 100644
index 0000000000000000000000000000000000000000..ad1f9ca1ca321f6852d1d654d1fb0b14c556330f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Oral differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Phnom_Penh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Phnom_Penh
new file mode 100644
index 0000000000000000000000000000000000000000..c292ac5b5f489a88bf10a1263b14e7412479d9e7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Phnom_Penh differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pontianak b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pontianak
new file mode 100644
index 0000000000000000000000000000000000000000..12ce24cbeae404efe6921081d21289be452ff88d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pontianak differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pyongyang b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pyongyang
new file mode 100644
index 0000000000000000000000000000000000000000..7ad7e0b2cf8fa4fc844fe8cc9c58e4f3018cead1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Pyongyang differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qatar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qatar
new file mode 100644
index 0000000000000000000000000000000000000000..63188b269d077e29f48a42a03c2a52aefdb61320
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qatar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qostanay b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qostanay
new file mode 100644
index 0000000000000000000000000000000000000000..73b9d963efc99f7af196755a6b2be015d9cb7a67
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qostanay differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qyzylorda b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qyzylorda
new file mode 100644
index 0000000000000000000000000000000000000000..c2fe4c144c82b300ff126ed44098ee2bf8d752d3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Qyzylorda differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Rangoon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Rangoon
new file mode 100644
index 0000000000000000000000000000000000000000..dd77395b05a89b875683f8aa82062748f2ed504c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Rangoon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Riyadh b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Riyadh
new file mode 100644
index 0000000000000000000000000000000000000000..2aea25f8c210369e0b805d0dd5f0e899190c2340
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Riyadh differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Saigon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Saigon
new file mode 100644
index 0000000000000000000000000000000000000000..e2934e371b6d5cf80244d8d55594f7094bc9cbb8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Saigon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Sakhalin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Sakhalin
new file mode 100644
index 0000000000000000000000000000000000000000..485459ce0397787a099064952c66989712ae707f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Sakhalin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Samarkand b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Samarkand
new file mode 100644
index 0000000000000000000000000000000000000000..030d47ce0785f3bdb75314e0d03fb20c3e0172d5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Samarkand differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Seoul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Seoul
new file mode 100644
index 0000000000000000000000000000000000000000..96199e73e73aafacd89e48cb2855a96d7a134e1d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Seoul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Shanghai b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Shanghai
new file mode 100644
index 0000000000000000000000000000000000000000..91f6f8bc2e234bafd484146986bdb289082c3588
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Shanghai differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Singapore b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Singapore
new file mode 100644
index 0000000000000000000000000000000000000000..2364b2178b03853b1771cb3f34b964fdb82e2e91
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Singapore differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Srednekolymsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Srednekolymsk
new file mode 100644
index 0000000000000000000000000000000000000000..261a9832b3ee4bda7c9935b566a7f7f0e6489e97
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Srednekolymsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Taipei b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Taipei
new file mode 100644
index 0000000000000000000000000000000000000000..24c43444b6751343d2915843d03e55753d4d7359
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Taipei differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tashkent b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tashkent
new file mode 100644
index 0000000000000000000000000000000000000000..32a9d7d0c9cbfa841cc4e922fd1b486a34b57370
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tashkent differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tbilisi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tbilisi
new file mode 100644
index 0000000000000000000000000000000000000000..b608d79748884c4a8271e695fe4ed992a91fea65
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tbilisi differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tehran b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tehran
new file mode 100644
index 0000000000000000000000000000000000000000..8cec5ad7de2f2c14dd4b0a6c375d7198ef7429b6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tehran differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tel_Aviv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tel_Aviv
new file mode 100644
index 0000000000000000000000000000000000000000..1ebd0664aa29c0abd722661f761031ec0304631c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tel_Aviv differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimbu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimbu
new file mode 100644
index 0000000000000000000000000000000000000000..fe409c7a2a40294af6bae4523492be88d38a97bc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimbu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimphu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimphu
new file mode 100644
index 0000000000000000000000000000000000000000..fe409c7a2a40294af6bae4523492be88d38a97bc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Thimphu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tokyo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tokyo
new file mode 100644
index 0000000000000000000000000000000000000000..26f4d34d67b46513491f26c2e661c6e653cc130d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tokyo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tomsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tomsk
new file mode 100644
index 0000000000000000000000000000000000000000..670e2ad2ce22f08d496b42363caa2e424121b20c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Tomsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ujung_Pandang b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ujung_Pandang
new file mode 100644
index 0000000000000000000000000000000000000000..556ba866933d37f3cfcf8042045d64e209bae30f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ujung_Pandang differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulaanbaatar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulaanbaatar
new file mode 100644
index 0000000000000000000000000000000000000000..2e20cc3a438bb2076bfc1856045075dd041cad3d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulaanbaatar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulan_Bator b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulan_Bator
new file mode 100644
index 0000000000000000000000000000000000000000..2e20cc3a438bb2076bfc1856045075dd041cad3d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ulan_Bator differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Urumqi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Urumqi
new file mode 100644
index 0000000000000000000000000000000000000000..faa14d92d58fa883c4203022e091dc9154ac92dc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Urumqi differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ust-Nera b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ust-Nera
new file mode 100644
index 0000000000000000000000000000000000000000..9e4a78f6a547de2a91e728ac4ab5ffa4884105b4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Ust-Nera differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vientiane b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vientiane
new file mode 100644
index 0000000000000000000000000000000000000000..c292ac5b5f489a88bf10a1263b14e7412479d9e7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vientiane differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vladivostok b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vladivostok
new file mode 100644
index 0000000000000000000000000000000000000000..8ab253ce73555cbbf42ec67a8560acef080fc480
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Vladivostok differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yakutsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yakutsk
new file mode 100644
index 0000000000000000000000000000000000000000..c815e99b1a8f2d4b9bd45d3a6f39c95db5bbf563
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yakutsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yangon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yangon
new file mode 100644
index 0000000000000000000000000000000000000000..dd77395b05a89b875683f8aa82062748f2ed504c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yangon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yekaterinburg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yekaterinburg
new file mode 100644
index 0000000000000000000000000000000000000000..6958d7edddb85d298c5f2b890b21d9ca2056e9c5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yekaterinburg differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yerevan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yerevan
new file mode 100644
index 0000000000000000000000000000000000000000..250bfe020ada912671d670e77403a269c74b658e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Asia/Yerevan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Azores b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Azores
new file mode 100644
index 0000000000000000000000000000000000000000..56593dbfff9bc50bb32e64ff282d0502e75526c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Azores differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Bermuda b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Bermuda
new file mode 100644
index 0000000000000000000000000000000000000000..527524ed295aba41b9a0448ffd7993c489a2cb99
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Bermuda differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Canary b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Canary
new file mode 100644
index 0000000000000000000000000000000000000000..f3192156ff043a529461aa9004a8de9dda326f7d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Canary differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Cape_Verde b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Cape_Verde
new file mode 100644
index 0000000000000000000000000000000000000000..e2a49d248de086306d2dd16a2b2d497a008c8f07
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Cape_Verde differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faeroe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faeroe
new file mode 100644
index 0000000000000000000000000000000000000000..4dab7ef0859c244b916d61b7489d7371881e0ca2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faeroe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faroe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faroe
new file mode 100644
index 0000000000000000000000000000000000000000..4dab7ef0859c244b916d61b7489d7371881e0ca2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Faroe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Jan_Mayen b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Jan_Mayen
new file mode 100644
index 0000000000000000000000000000000000000000..15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Jan_Mayen differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Madeira b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Madeira
new file mode 100644
index 0000000000000000000000000000000000000000..5213761f891303f95e1962570568ae62ed387950
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Madeira differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Reykjavik b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Reykjavik
new file mode 100644
index 0000000000000000000000000000000000000000..10e0fc8190a401f67b861ced3b8b16401432a565
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Reykjavik differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/South_Georgia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/South_Georgia
new file mode 100644
index 0000000000000000000000000000000000000000..446660861227aa8ceb7084f48c3b2654ea64f4dc
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/South_Georgia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/St_Helena b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/St_Helena
new file mode 100644
index 0000000000000000000000000000000000000000..28b32ab2e0b9053f39a91d9f28b6072e41423954
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/St_Helena differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Stanley b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Stanley
new file mode 100644
index 0000000000000000000000000000000000000000..88077f110715ac1e349708821ac1e00f35bf6395
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Atlantic/Stanley differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/ACT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/ACT
new file mode 100644
index 0000000000000000000000000000000000000000..0aea4c3d43e504dafabc031d7ca9cbe8db46163c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/ACT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Adelaide b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Adelaide
new file mode 100644
index 0000000000000000000000000000000000000000..f5dedca59e2b220f7395c73f60ff26e610373e8b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Adelaide differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Brisbane b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Brisbane
new file mode 100644
index 0000000000000000000000000000000000000000..7ff9949ffa93e44835ab133998b89e440094f909
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Brisbane differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Broken_Hill b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Broken_Hill
new file mode 100644
index 0000000000000000000000000000000000000000..698c76e30e91f568a29daca12993cfacbfdbf83e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Broken_Hill differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Canberra b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Canberra
new file mode 100644
index 0000000000000000000000000000000000000000..0aea4c3d43e504dafabc031d7ca9cbe8db46163c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Canberra differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Currie b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Currie
new file mode 100644
index 0000000000000000000000000000000000000000..3adb8e1bf7c6ec51f1c100538799271d7d7a6e6f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Currie differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Darwin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Darwin
new file mode 100644
index 0000000000000000000000000000000000000000..74a30879bc6180d588a706451226cb4c95faf79d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Darwin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Eucla b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Eucla
new file mode 100644
index 0000000000000000000000000000000000000000..3bf1171caddd7882d8a438f1d5eca0026549be08
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Eucla differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Hobart b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Hobart
new file mode 100644
index 0000000000000000000000000000000000000000..3adb8e1bf7c6ec51f1c100538799271d7d7a6e6f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Hobart differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/LHI b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/LHI
new file mode 100644
index 0000000000000000000000000000000000000000..9e04a80ecea45473faabeb609eb06cfe62193d48
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/LHI differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lindeman b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lindeman
new file mode 100644
index 0000000000000000000000000000000000000000..4ee1825abfe65887069dcbd10bcf786d50ba0702
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lindeman differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lord_Howe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lord_Howe
new file mode 100644
index 0000000000000000000000000000000000000000..9e04a80ecea45473faabeb609eb06cfe62193d48
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Lord_Howe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Melbourne b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Melbourne
new file mode 100644
index 0000000000000000000000000000000000000000..ee903f4b1fc292bc9cbec7b501a266030ef3510e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Melbourne differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/NSW b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/NSW
new file mode 100644
index 0000000000000000000000000000000000000000..0aea4c3d43e504dafabc031d7ca9cbe8db46163c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/NSW differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/North b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/North
new file mode 100644
index 0000000000000000000000000000000000000000..74a30879bc6180d588a706451226cb4c95faf79d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/North differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Perth b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Perth
new file mode 100644
index 0000000000000000000000000000000000000000..f8ddbdf215d34b022af11c3d1930dd6ea4dca87e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Perth differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Queensland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Queensland
new file mode 100644
index 0000000000000000000000000000000000000000..7ff9949ffa93e44835ab133998b89e440094f909
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Queensland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/South b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/South
new file mode 100644
index 0000000000000000000000000000000000000000..f5dedca59e2b220f7395c73f60ff26e610373e8b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/South differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Sydney b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Sydney
new file mode 100644
index 0000000000000000000000000000000000000000..0aea4c3d43e504dafabc031d7ca9cbe8db46163c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Sydney differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Tasmania b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Tasmania
new file mode 100644
index 0000000000000000000000000000000000000000..3adb8e1bf7c6ec51f1c100538799271d7d7a6e6f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Tasmania differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Victoria b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Victoria
new file mode 100644
index 0000000000000000000000000000000000000000..ee903f4b1fc292bc9cbec7b501a266030ef3510e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Victoria differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/West b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/West
new file mode 100644
index 0000000000000000000000000000000000000000..f8ddbdf215d34b022af11c3d1930dd6ea4dca87e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/West differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Yancowinna b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Yancowinna
new file mode 100644
index 0000000000000000000000000000000000000000..698c76e30e91f568a29daca12993cfacbfdbf83e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Australia/Yancowinna differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/Acre b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/Acre
new file mode 100644
index 0000000000000000000000000000000000000000..a374cb43d98bfbd06c82ca306a74f96993fd5657
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/Acre differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/DeNoronha b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/DeNoronha
new file mode 100644
index 0000000000000000000000000000000000000000..f140726f2a6945357b325f0bb452dce7557bbff7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/DeNoronha differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/East b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/East
new file mode 100644
index 0000000000000000000000000000000000000000..13ff083869a9ac8476775587de8476654a100017
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/East differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/West b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/West
new file mode 100644
index 0000000000000000000000000000000000000000..63d58f80f556e1c3135d6dbcb2a2dfc6f61b4fc9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Brazil/West differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CET b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CET
new file mode 100644
index 0000000000000000000000000000000000000000..122e934210cabf0b29a2dd7d11eb8220ed1cad43
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CET differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CST6CDT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CST6CDT
new file mode 100644
index 0000000000000000000000000000000000000000..ca67929fbeb05083c63e8319dd9ebf65b3d75e4d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/CST6CDT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Atlantic b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Atlantic
new file mode 100644
index 0000000000000000000000000000000000000000..756099abe6cee44295a5566ad6cd0c352fb82e64
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Atlantic differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Central b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Central
new file mode 100644
index 0000000000000000000000000000000000000000..ac40299f6b27043e8f2454ac594b0ec184c1a237
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Central differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Eastern b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Eastern
new file mode 100644
index 0000000000000000000000000000000000000000..6752c5b05285678b86aea170f0921fc5f5e57738
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Eastern differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Mountain b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Mountain
new file mode 100644
index 0000000000000000000000000000000000000000..cd78a6f8be1dd55ac5afd25bbae39bd5706e42d1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Mountain differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Newfoundland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Newfoundland
new file mode 100644
index 0000000000000000000000000000000000000000..65a5b0c720dad151ffdcba3dbe91c8bd638845c6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Newfoundland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Pacific b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Pacific
new file mode 100644
index 0000000000000000000000000000000000000000..bb60cbced30763c08b6cf73554c8d6651ff387d0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Pacific differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Saskatchewan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Saskatchewan
new file mode 100644
index 0000000000000000000000000000000000000000..20c9c84df491e4072ec4c5d2c931a7433d9fd394
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Saskatchewan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Yukon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Yukon
new file mode 100644
index 0000000000000000000000000000000000000000..9ee229c0eb82c6aea7359e0b38677264f3cad8ab
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Canada/Yukon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/Continental b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/Continental
new file mode 100644
index 0000000000000000000000000000000000000000..816a0428188d99f437004312ee73c3860ee0f54f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/Continental differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/EasterIsland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/EasterIsland
new file mode 100644
index 0000000000000000000000000000000000000000..cae3744096402e8a452336544edf96ca9ae5ad8d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Chile/EasterIsland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Cuba b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Cuba
new file mode 100644
index 0000000000000000000000000000000000000000..b69ac4510784f23ee794cd6d11e62315a7318e5e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Cuba differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EET b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EET
new file mode 100644
index 0000000000000000000000000000000000000000..cbdb71ddd38be8f4a23e57bdb4b86e52195e9f89
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EET differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST
new file mode 100644
index 0000000000000000000000000000000000000000..21ebc00b3fc096035b9810519d778d04a3562a44
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST5EDT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST5EDT
new file mode 100644
index 0000000000000000000000000000000000000000..9bce5007d4dbb871974a69cb0f68151c1ee22556
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/EST5EDT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Egypt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Egypt
new file mode 100644
index 0000000000000000000000000000000000000000..d3f819623fc9ef90d327380fad15341ec1a0e202
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Egypt differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Eire b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Eire
new file mode 100644
index 0000000000000000000000000000000000000000..1d994902db21814a626e42639d7a96b18ee73756
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Eire differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+1 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+1
new file mode 100644
index 0000000000000000000000000000000000000000..4dab6f9005bea50a065c685ec8260b0da2bff921
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+1 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+10 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+10
new file mode 100644
index 0000000000000000000000000000000000000000..c749290af2f6b5fe22770c34eb1e8fc87cd85aff
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+10 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+11 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+11
new file mode 100644
index 0000000000000000000000000000000000000000..d969982309e5ca7d32979a7dad814ca307d2cd8d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+11 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+12 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+12
new file mode 100644
index 0000000000000000000000000000000000000000..cdeec90973be28ee4075eadd22b8b574db2d7a5f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+12 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+2
new file mode 100644
index 0000000000000000000000000000000000000000..fbd2a941fda996f4abc1f0e09cdf99c271f5a1e2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+2 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+3
new file mode 100644
index 0000000000000000000000000000000000000000..ee246ef56f18de61105af0c14d201fd090f74905
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+3 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+4 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+4
new file mode 100644
index 0000000000000000000000000000000000000000..5a25ff2a6afda2cb09b9e147ad20610bc1923444
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+4 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+5 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+5
new file mode 100644
index 0000000000000000000000000000000000000000..c0b745f1cc44d03a00f8bdf127c154392e3baf27
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+5 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+6 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+6
new file mode 100644
index 0000000000000000000000000000000000000000..06e777d57e0267a0635b6b284729fddcfe6221dd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+6 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+7 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+7
new file mode 100644
index 0000000000000000000000000000000000000000..4e0b53a082f11f9b9debf5e110b97b1b0473c9a6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+7 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+8
new file mode 100644
index 0000000000000000000000000000000000000000..714b0c562889a8a774d9aa27810d8400164d00e6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+8 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+9 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+9
new file mode 100644
index 0000000000000000000000000000000000000000..78b9daa373d2aa2856eafcc92ebc6d899cafde5c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT+9 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-1 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-1
new file mode 100644
index 0000000000000000000000000000000000000000..a838bebf5e7bac3e1257eeb0a61c1b83feb1324c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-1 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-10 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-10
new file mode 100644
index 0000000000000000000000000000000000000000..68ff77db0d95c7d054ef33c05e05ba71bcbbbdd8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-10 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-11 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-11
new file mode 100644
index 0000000000000000000000000000000000000000..66af5a42be440f1fb8fec3b915afb49b356f63a5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-11 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-12 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-12
new file mode 100644
index 0000000000000000000000000000000000000000..17ba5057727dd73bd5f6234cc5b239b71a861945
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-12 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-13 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-13
new file mode 100644
index 0000000000000000000000000000000000000000..5f3706ce64cadf081a6c56abd7ba423575a4abb2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-13 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-14 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-14
new file mode 100644
index 0000000000000000000000000000000000000000..7e9f9c465ce6211c65d617f60472c9b55b5052c5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-14 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-2 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-2
new file mode 100644
index 0000000000000000000000000000000000000000..fcef6d9acb247deb539fcc4b30149802572ea642
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-2 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-3 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-3
new file mode 100644
index 0000000000000000000000000000000000000000..27973bc857b4e618218ca2790acacb81f7c7bb82
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-3 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-4 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-4
new file mode 100644
index 0000000000000000000000000000000000000000..1efd841261a977ae218d408f9cc308c3e312a5e8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-4 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-5 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-5
new file mode 100644
index 0000000000000000000000000000000000000000..1f761844fc44f8228bb748235bfd30be6c389cd1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-5 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-6 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-6
new file mode 100644
index 0000000000000000000000000000000000000000..952681ed46cb60e59baf76a2c43b49d5f67255d1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-6 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-7 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-7
new file mode 100644
index 0000000000000000000000000000000000000000..cefc9126c691060225ff2eee1241b1e5e9825fcd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-7 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-8 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-8
new file mode 100644
index 0000000000000000000000000000000000000000..afb093da00685297cb11347c4840acf3a8e2e2bf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-8 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-9 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-9
new file mode 100644
index 0000000000000000000000000000000000000000..9265fb7c2071ec0e66c657ad2ae42d5dd525fe97
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT-9 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/GMT0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Greenwich b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Greenwich
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Greenwich differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UCT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UCT
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UCT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UTC b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UTC
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/UTC differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Universal b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Universal
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Universal differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Zulu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Zulu
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Etc/Zulu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Amsterdam b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Amsterdam
new file mode 100644
index 0000000000000000000000000000000000000000..c3ff07b436aedf662eae60f50668f5abcdb172b6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Amsterdam differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Andorra b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Andorra
new file mode 100644
index 0000000000000000000000000000000000000000..5962550392fa78514061582e9371c32b9f1d929b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Andorra differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Astrakhan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Astrakhan
new file mode 100644
index 0000000000000000000000000000000000000000..73a4d013fcb82c2beb6f885f359b9ca20da054e7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Astrakhan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Athens b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Athens
new file mode 100644
index 0000000000000000000000000000000000000000..9f3a0678d766881389e129c93def7fffd74f14f1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Athens differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belfast b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belfast
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belfast differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belgrade b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belgrade
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Belgrade differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Berlin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Berlin
new file mode 100644
index 0000000000000000000000000000000000000000..7f6d958f8630cba512d8e58ca8edfbd516291522
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Berlin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bratislava b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bratislava
new file mode 100644
index 0000000000000000000000000000000000000000..ce8f433ece44f0b96b18d3b5780730e7f9cad9f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bratislava differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Brussels b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Brussels
new file mode 100644
index 0000000000000000000000000000000000000000..40d7124e5346af056c75e2f7012a51d94e8154b7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Brussels differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bucharest b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bucharest
new file mode 100644
index 0000000000000000000000000000000000000000..4303b903e5e007484c0d8e1eea43a35e9b53f38b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Bucharest differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Budapest b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Budapest
new file mode 100644
index 0000000000000000000000000000000000000000..b76c873d9256e1d73c2ea672140b813f15657bc7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Budapest differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Busingen b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Busingen
new file mode 100644
index 0000000000000000000000000000000000000000..ad6cf59281a1046d9dcd045fda521585e3e33e06
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Busingen differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Chisinau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Chisinau
new file mode 100644
index 0000000000000000000000000000000000000000..5ee23fe0e59f044598675db44d53c20590b88934
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Chisinau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Copenhagen b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Copenhagen
new file mode 100644
index 0000000000000000000000000000000000000000..776be6e4a6d5a054152135a1ad149576052f49a1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Copenhagen differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Dublin b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Dublin
new file mode 100644
index 0000000000000000000000000000000000000000..1d994902db21814a626e42639d7a96b18ee73756
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Dublin differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Gibraltar b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Gibraltar
new file mode 100644
index 0000000000000000000000000000000000000000..117aadb8364cd7901388098503f4538c7b445aeb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Gibraltar differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Guernsey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Guernsey
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Guernsey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Helsinki b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Helsinki
new file mode 100644
index 0000000000000000000000000000000000000000..b4f8f9cbb57450549933f83ac90dd56a2ca75344
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Helsinki differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Isle_of_Man b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Isle_of_Man
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Isle_of_Man differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Istanbul b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Istanbul
new file mode 100644
index 0000000000000000000000000000000000000000..508446bb6aee2841ab88e82607a6ad6e748e7db7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Istanbul differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Jersey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Jersey
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Jersey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kaliningrad b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kaliningrad
new file mode 100644
index 0000000000000000000000000000000000000000..cc99beabe4ffc5107c4719d1201d6583b9ead03a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kaliningrad differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kiev b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kiev
new file mode 100644
index 0000000000000000000000000000000000000000..9337c9ea27c0a61b1082f4be37cfb0f9484cf5e2
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kiev differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kirov b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kirov
new file mode 100644
index 0000000000000000000000000000000000000000..a3b5320a0bd139c07b8642c4efd7b98f57c6e8dd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Kirov differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Lisbon b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Lisbon
new file mode 100644
index 0000000000000000000000000000000000000000..355817b52b1b05680bbb57e4dc8de358eff27a39
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Lisbon differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ljubljana b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ljubljana
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ljubljana differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/London b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/London
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/London differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Luxembourg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Luxembourg
new file mode 100644
index 0000000000000000000000000000000000000000..c4ca733f5345df24e5286b70464a6c0498353372
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Luxembourg differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Madrid b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Madrid
new file mode 100644
index 0000000000000000000000000000000000000000..16f6420ab7efc7ceac3b0e42fe37836185cfc463
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Madrid differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Malta b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Malta
new file mode 100644
index 0000000000000000000000000000000000000000..bf2452da40314be196f61e6a7cdd48eaf5c426f3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Malta differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Mariehamn b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Mariehamn
new file mode 100644
index 0000000000000000000000000000000000000000..b4f8f9cbb57450549933f83ac90dd56a2ca75344
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Mariehamn differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Minsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Minsk
new file mode 100644
index 0000000000000000000000000000000000000000..453306c07566a94c0c391024fb16ee36245a0a40
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Minsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Monaco b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Monaco
new file mode 100644
index 0000000000000000000000000000000000000000..adbe45d1c1db7287345b1826a356732075a38c51
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Monaco differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Moscow b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Moscow
new file mode 100644
index 0000000000000000000000000000000000000000..ddb3f4e99a1030f33b56fad986c8d9c16e59eb32
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Moscow differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Nicosia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Nicosia
new file mode 100644
index 0000000000000000000000000000000000000000..f7f10ab7665e94ca44fd8cd98a362cd4b304eff1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Nicosia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Oslo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Oslo
new file mode 100644
index 0000000000000000000000000000000000000000..15a34c3cedb7c9ca519c195f5ec0ce9d8d1885a5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Oslo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Paris b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Paris
new file mode 100644
index 0000000000000000000000000000000000000000..7d366c6098c49ecd546e1cc1538919e1414a3aee
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Paris differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Podgorica b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Podgorica
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Podgorica differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Prague b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Prague
new file mode 100644
index 0000000000000000000000000000000000000000..ce8f433ece44f0b96b18d3b5780730e7f9cad9f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Prague differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Riga b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Riga
new file mode 100644
index 0000000000000000000000000000000000000000..8db477d01736445cafce8af7a7085d226d81f546
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Riga differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Rome b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Rome
new file mode 100644
index 0000000000000000000000000000000000000000..ac4c16342b5bbfa4c58a26f57db33b95f5b3e533
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Rome differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Samara b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Samara
new file mode 100644
index 0000000000000000000000000000000000000000..97d5dd9e6ed7fc924c9bcb514f991cc8b52061b3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Samara differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/San_Marino b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/San_Marino
new file mode 100644
index 0000000000000000000000000000000000000000..ac4c16342b5bbfa4c58a26f57db33b95f5b3e533
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/San_Marino differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sarajevo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sarajevo
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sarajevo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Saratov b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Saratov
new file mode 100644
index 0000000000000000000000000000000000000000..8fd5f6d4b881457d13fdcdd35abb6fc5429d7084
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Saratov differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Simferopol b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Simferopol
new file mode 100644
index 0000000000000000000000000000000000000000..432e8315bc9dfa74080467f9e08073d9fdcc833a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Simferopol differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Skopje b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Skopje
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Skopje differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sofia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sofia
new file mode 100644
index 0000000000000000000000000000000000000000..0e4d879332d21c93c229fc25587205020eeb3127
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Sofia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Stockholm b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Stockholm
new file mode 100644
index 0000000000000000000000000000000000000000..f3e0c7f0f25f0a7290e56281c91190e3611498a7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Stockholm differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tallinn b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tallinn
new file mode 100644
index 0000000000000000000000000000000000000000..b5acca3cf51e7f7b3176965748688ff41720246f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tallinn differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tirane b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tirane
new file mode 100644
index 0000000000000000000000000000000000000000..0b86017d243f1b7bbb41d6b4feefcb2b7edfc7d8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tirane differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tiraspol b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tiraspol
new file mode 100644
index 0000000000000000000000000000000000000000..5ee23fe0e59f044598675db44d53c20590b88934
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Tiraspol differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ulyanovsk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ulyanovsk
new file mode 100644
index 0000000000000000000000000000000000000000..7b61bdc522b5b7f4397fdb9246185f4d972f4b6c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Ulyanovsk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Uzhgorod b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Uzhgorod
new file mode 100644
index 0000000000000000000000000000000000000000..66ae8d69e3f86cfdd8d90a9b1d094d807f75f27a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Uzhgorod differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vaduz b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vaduz
new file mode 100644
index 0000000000000000000000000000000000000000..ad6cf59281a1046d9dcd045fda521585e3e33e06
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vaduz differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vatican b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vatican
new file mode 100644
index 0000000000000000000000000000000000000000..ac4c16342b5bbfa4c58a26f57db33b95f5b3e533
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vatican differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vienna b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vienna
new file mode 100644
index 0000000000000000000000000000000000000000..3582bb15cd7322088839b0134987ad10e717b6b5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vienna differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vilnius b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vilnius
new file mode 100644
index 0000000000000000000000000000000000000000..7abd63fa608e0186b9f154d9fcc32472c28f6759
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Vilnius differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Volgograd b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Volgograd
new file mode 100644
index 0000000000000000000000000000000000000000..11739ac271da2b623bef49ea64908820b7ca05fd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Volgograd differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Warsaw b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Warsaw
new file mode 100644
index 0000000000000000000000000000000000000000..e33cf67171da78aa9e6eb02e50f9b9603da4c3f4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Warsaw differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zagreb b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zagreb
new file mode 100644
index 0000000000000000000000000000000000000000..27de456f16ab549627b284a39e2265cbdb4ad8e9
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zagreb differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zaporozhye b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zaporozhye
new file mode 100644
index 0000000000000000000000000000000000000000..e42edfc8506b9b99362b36d90c8b8c4db67d50d8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zaporozhye differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zurich b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zurich
new file mode 100644
index 0000000000000000000000000000000000000000..ad6cf59281a1046d9dcd045fda521585e3e33e06
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Europe/Zurich differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Factory b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Factory
new file mode 100644
index 0000000000000000000000000000000000000000..60aa2a0d695ba577ff87624d479f1eb25c8f1caf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Factory differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB-Eire b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB-Eire
new file mode 100644
index 0000000000000000000000000000000000000000..ac02a81440f47a67b9f01d3fbcdb085266d20894
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GB-Eire differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT+0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT+0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT+0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT-0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT-0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT-0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT0 b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT0
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/GMT0 differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Greenwich b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Greenwich
new file mode 100644
index 0000000000000000000000000000000000000000..c63474664a289aa3c3c0d8b2ce06d484679754c0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Greenwich differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/HST b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/HST
new file mode 100644
index 0000000000000000000000000000000000000000..cccd45eb8cb2f56b6a1b75e2d7b9530cb5abf2e1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/HST differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Hongkong b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Hongkong
new file mode 100644
index 0000000000000000000000000000000000000000..23d0375fba3377a3d513d849c0d29c82ad2add64
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Hongkong differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iceland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iceland
new file mode 100644
index 0000000000000000000000000000000000000000..10e0fc8190a401f67b861ced3b8b16401432a565
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iceland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Antananarivo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Antananarivo
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Antananarivo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Chagos b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Chagos
new file mode 100644
index 0000000000000000000000000000000000000000..93d6dda50f579093f25617c77081ae99c8631ea5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Chagos differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Christmas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Christmas
new file mode 100644
index 0000000000000000000000000000000000000000..d18c3810d97bbd424dc3c8fa98de46bfa08c3fa8
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Christmas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Cocos b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Cocos
new file mode 100644
index 0000000000000000000000000000000000000000..f8116e7025cadc709bbd995905e88c92ed03642a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Cocos differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Comoro b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Comoro
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Comoro differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Kerguelen b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Kerguelen
new file mode 100644
index 0000000000000000000000000000000000000000..cde4cf7ea7086a3fa3609566ff03e9425b096f36
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Kerguelen differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mahe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mahe
new file mode 100644
index 0000000000000000000000000000000000000000..208f9386bdad172305a48f6ab7e70ac3e1ca0e1e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mahe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Maldives b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Maldives
new file mode 100644
index 0000000000000000000000000000000000000000..7c839cfa9bd62842cf23f01d5195b239bc5a437c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Maldives differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mauritius b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mauritius
new file mode 100644
index 0000000000000000000000000000000000000000..17f26169904928e4061e4ee58bdf7a6c62001524
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mauritius differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mayotte b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mayotte
new file mode 100644
index 0000000000000000000000000000000000000000..9dcfc19c56e62b12b730f4335b34479695f273f5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Mayotte differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Reunion b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Reunion
new file mode 100644
index 0000000000000000000000000000000000000000..dfe08313dffde345044d5053e3359f92163d3e38
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Indian/Reunion differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iran b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iran
new file mode 100644
index 0000000000000000000000000000000000000000..8cec5ad7de2f2c14dd4b0a6c375d7198ef7429b6
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Iran differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Israel b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Israel
new file mode 100644
index 0000000000000000000000000000000000000000..1ebd0664aa29c0abd722661f761031ec0304631c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Israel differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Jamaica b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Jamaica
new file mode 100644
index 0000000000000000000000000000000000000000..2a9b7fd52d37a1ffe9fc589daa04d88c6c71a6e0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Jamaica differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Japan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Japan
new file mode 100644
index 0000000000000000000000000000000000000000..26f4d34d67b46513491f26c2e661c6e653cc130d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Japan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Kwajalein b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Kwajalein
new file mode 100644
index 0000000000000000000000000000000000000000..1a7975fad7f7e96f7101eb3c64c9b420eeebb621
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Kwajalein differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Libya b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Libya
new file mode 100644
index 0000000000000000000000000000000000000000..07b393bb7db14cef1e906ebe63cfbbe8cddc79d5
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Libya differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MET b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MET
new file mode 100644
index 0000000000000000000000000000000000000000..4a826bb185531c34eb37959037c68fbf08c23f71
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MET differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST
new file mode 100644
index 0000000000000000000000000000000000000000..c93a58eee8b32f672fd3a96ca3e6ada5b0a0e168
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST7MDT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST7MDT
new file mode 100644
index 0000000000000000000000000000000000000000..4506a6e150dfd73884811c8c0f5a0e21dc76a756
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/MST7MDT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaNorte b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaNorte
new file mode 100644
index 0000000000000000000000000000000000000000..ada6bf78b2815d3d99c97d521ab9a6b35c8af8c3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaNorte differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaSur b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaSur
new file mode 100644
index 0000000000000000000000000000000000000000..e4a785743d75f939c3e4798ebe7c79d38e4cfd08
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/BajaSur differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/General b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/General
new file mode 100644
index 0000000000000000000000000000000000000000..e7fb6f2953d123efbc2550f450decd794b017d4f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Mexico/General differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ
new file mode 100644
index 0000000000000000000000000000000000000000..6575fdce31183d8238b18f2f30ab5b9227c7071c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ-CHAT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ-CHAT
new file mode 100644
index 0000000000000000000000000000000000000000..c00410988272dec2ae70ede88720b4a46146a4d1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/NZ-CHAT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Navajo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Navajo
new file mode 100644
index 0000000000000000000000000000000000000000..5fbe26b1d93d1acb2561c390c1e097d07f1a262e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Navajo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PRC b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PRC
new file mode 100644
index 0000000000000000000000000000000000000000..91f6f8bc2e234bafd484146986bdb289082c3588
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PRC differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PST8PDT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PST8PDT
new file mode 100644
index 0000000000000000000000000000000000000000..99d246baa35cb9c6f56d50adbec163452e2a47fa
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/PST8PDT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Apia b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Apia
new file mode 100644
index 0000000000000000000000000000000000000000..dab1f3f602b297cff53222906fe7c20230587395
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Apia differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Auckland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Auckland
new file mode 100644
index 0000000000000000000000000000000000000000..6575fdce31183d8238b18f2f30ab5b9227c7071c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Auckland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Bougainville b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Bougainville
new file mode 100644
index 0000000000000000000000000000000000000000..2892d268094ea785b045e53cb441a551672aabd0
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Bougainville differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chatham b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chatham
new file mode 100644
index 0000000000000000000000000000000000000000..c00410988272dec2ae70ede88720b4a46146a4d1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chatham differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chuuk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chuuk
new file mode 100644
index 0000000000000000000000000000000000000000..07c84b7110ad9589810b916390aedc7ef498f423
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Chuuk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Easter b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Easter
new file mode 100644
index 0000000000000000000000000000000000000000..cae3744096402e8a452336544edf96ca9ae5ad8d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Easter differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Efate b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Efate
new file mode 100644
index 0000000000000000000000000000000000000000..d8d4093bc804be0730b5f5f530db42d55991afbf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Efate differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Enderbury b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Enderbury
new file mode 100644
index 0000000000000000000000000000000000000000..f0b8252362b0916405ad479b9f3ac148a2527814
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Enderbury differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fakaofo b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fakaofo
new file mode 100644
index 0000000000000000000000000000000000000000..e40307f6aab2a169bb957979f5580affb379131e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fakaofo differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fiji b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fiji
new file mode 100644
index 0000000000000000000000000000000000000000..e71691ee932809771920778c699c27e32ce99207
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Fiji differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Funafuti b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Funafuti
new file mode 100644
index 0000000000000000000000000000000000000000..ea728637ac1fa43f2d73469151c688468b34c3e3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Funafuti differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Galapagos b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Galapagos
new file mode 100644
index 0000000000000000000000000000000000000000..31f0921ea04cd201675b613082fb4b0b0b91941c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Galapagos differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Gambier b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Gambier
new file mode 100644
index 0000000000000000000000000000000000000000..e1fc3daa55eb2bc8c5d6a78bd77a01d193a821a7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Gambier differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guadalcanal b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guadalcanal
new file mode 100644
index 0000000000000000000000000000000000000000..7e9d10a100f9cbe796d99945dd60e0430dced523
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guadalcanal differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guam b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guam
new file mode 100644
index 0000000000000000000000000000000000000000..66490d25dff9bcc8f710b0141f1a02e64aeb32f3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Guam differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Honolulu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Honolulu
new file mode 100644
index 0000000000000000000000000000000000000000..c7cd060159bd22fc5e6f10ac5a2089afb2c19c6a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Honolulu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Johnston b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Johnston
new file mode 100644
index 0000000000000000000000000000000000000000..c7cd060159bd22fc5e6f10ac5a2089afb2c19c6a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Johnston differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kiritimati b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kiritimati
new file mode 100644
index 0000000000000000000000000000000000000000..7cae0cb7562e5c0f9fa46913b71a5c3628c01bbf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kiritimati differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kosrae b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kosrae
new file mode 100644
index 0000000000000000000000000000000000000000..a584aae5eb8187f88600e97b6d6c764245a37e65
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kosrae differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kwajalein b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kwajalein
new file mode 100644
index 0000000000000000000000000000000000000000..1a7975fad7f7e96f7101eb3c64c9b420eeebb621
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Kwajalein differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Majuro b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Majuro
new file mode 100644
index 0000000000000000000000000000000000000000..9ef8374de4fa73cd2a3359d3c3886b11643a7146
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Majuro differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Marquesas b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Marquesas
new file mode 100644
index 0000000000000000000000000000000000000000..74d6792bf6fcb791bfc0af1f827737f612abef67
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Marquesas differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Midway b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Midway
new file mode 100644
index 0000000000000000000000000000000000000000..cb56709a77dedb471150f4907771bf38f1879ba4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Midway differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Nauru b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Nauru
new file mode 100644
index 0000000000000000000000000000000000000000..acec0429f147f40279107a48cb85c3b0e9f56c94
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Nauru differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Niue b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Niue
new file mode 100644
index 0000000000000000000000000000000000000000..684b010e8b6bad56b084072403110b94e8cfe2dd
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Niue differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Norfolk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Norfolk
new file mode 100644
index 0000000000000000000000000000000000000000..53c1aad4e0a541ee3c2c4c6de33a79ca93a7d244
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Norfolk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Noumea b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Noumea
new file mode 100644
index 0000000000000000000000000000000000000000..931a1a306f70eb0c7578a65425086270c6ea2b88
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Noumea differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pago_Pago b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pago_Pago
new file mode 100644
index 0000000000000000000000000000000000000000..cb56709a77dedb471150f4907771bf38f1879ba4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pago_Pago differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Palau b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Palau
new file mode 100644
index 0000000000000000000000000000000000000000..146b35152aaeffb5940d30910ba37703f4096285
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Palau differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pitcairn b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pitcairn
new file mode 100644
index 0000000000000000000000000000000000000000..ef91b061bb145b2658d49fd5065ed74b1a6cf6f7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pitcairn differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pohnpei b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pohnpei
new file mode 100644
index 0000000000000000000000000000000000000000..c298ddd4debb649220e5dfde60948591bc6a3501
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Pohnpei differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Ponape b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Ponape
new file mode 100644
index 0000000000000000000000000000000000000000..c298ddd4debb649220e5dfde60948591bc6a3501
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Ponape differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Port_Moresby b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Port_Moresby
new file mode 100644
index 0000000000000000000000000000000000000000..920ad27e629e350c1baac8537bb639a59fd19039
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Port_Moresby differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Rarotonga b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Rarotonga
new file mode 100644
index 0000000000000000000000000000000000000000..da6b0fadea95ebd9d06a6ac997806993a4d7330d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Rarotonga differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Saipan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Saipan
new file mode 100644
index 0000000000000000000000000000000000000000..66490d25dff9bcc8f710b0141f1a02e64aeb32f3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Saipan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Samoa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Samoa
new file mode 100644
index 0000000000000000000000000000000000000000..cb56709a77dedb471150f4907771bf38f1879ba4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Samoa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tahiti b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tahiti
new file mode 100644
index 0000000000000000000000000000000000000000..442b8eb5a438985092d8657ebcabe8859037482a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tahiti differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tarawa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tarawa
new file mode 100644
index 0000000000000000000000000000000000000000..3db6c750333fa6dc1efc84b1abc24528fbc00b0b
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tarawa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tongatapu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tongatapu
new file mode 100644
index 0000000000000000000000000000000000000000..5553c6009acd272cae012a08b618c2fd649dceae
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Tongatapu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Truk b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Truk
new file mode 100644
index 0000000000000000000000000000000000000000..07c84b7110ad9589810b916390aedc7ef498f423
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Truk differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wake b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wake
new file mode 100644
index 0000000000000000000000000000000000000000..c9e310670f07e9e577791bfa19fefde61351fcdf
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wake differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wallis b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wallis
new file mode 100644
index 0000000000000000000000000000000000000000..b35344b312c6ca690c0f79a858c3995a05c71ff3
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Wallis differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Yap b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Yap
new file mode 100644
index 0000000000000000000000000000000000000000..07c84b7110ad9589810b916390aedc7ef498f423
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Pacific/Yap differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Poland b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Poland
new file mode 100644
index 0000000000000000000000000000000000000000..e33cf67171da78aa9e6eb02e50f9b9603da4c3f4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Poland differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Portugal b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Portugal
new file mode 100644
index 0000000000000000000000000000000000000000..355817b52b1b05680bbb57e4dc8de358eff27a39
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Portugal differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROC b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROC
new file mode 100644
index 0000000000000000000000000000000000000000..24c43444b6751343d2915843d03e55753d4d7359
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROC differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROK b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROK
new file mode 100644
index 0000000000000000000000000000000000000000..96199e73e73aafacd89e48cb2855a96d7a134e1d
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/ROK differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Singapore b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Singapore
new file mode 100644
index 0000000000000000000000000000000000000000..2364b2178b03853b1771cb3f34b964fdb82e2e91
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Singapore differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Turkey b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Turkey
new file mode 100644
index 0000000000000000000000000000000000000000..508446bb6aee2841ab88e82607a6ad6e748e7db7
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Turkey differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UCT b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UCT
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UCT differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Alaska b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Alaska
new file mode 100644
index 0000000000000000000000000000000000000000..9bbb2fd3b361ea8aa4c126d14df5fa370343a63f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Alaska differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Aleutian b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Aleutian
new file mode 100644
index 0000000000000000000000000000000000000000..43236498f681cc06f64ca2afa613880331fe6fbb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Aleutian differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Arizona b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Arizona
new file mode 100644
index 0000000000000000000000000000000000000000..ac6bb0c78291f1e341f42c34639458fb385bf8ed
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Arizona differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Central b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Central
new file mode 100644
index 0000000000000000000000000000000000000000..a5b1617c7f70bfc77b7d504aaa3f23603082c3cb
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Central differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/East-Indiana b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/East-Indiana
new file mode 100644
index 0000000000000000000000000000000000000000..09511ccdcf97a5baa8e1b0eb75e040eee6b6e0c4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/East-Indiana differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Eastern b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Eastern
new file mode 100644
index 0000000000000000000000000000000000000000..2f75480e069b60b6c58a9137c7eebd4796f74226
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Eastern differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Hawaii b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Hawaii
new file mode 100644
index 0000000000000000000000000000000000000000..c7cd060159bd22fc5e6f10ac5a2089afb2c19c6a
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Hawaii differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Indiana-Starke b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Indiana-Starke
new file mode 100644
index 0000000000000000000000000000000000000000..fcd408d74df43310a9a85c475f83d545f6d75911
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Indiana-Starke differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Michigan b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Michigan
new file mode 100644
index 0000000000000000000000000000000000000000..e104faa46545ee873295cde34e1d46bccad8647c
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Michigan differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Mountain b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Mountain
new file mode 100644
index 0000000000000000000000000000000000000000..5fbe26b1d93d1acb2561c390c1e097d07f1a262e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Mountain differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Pacific b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Pacific
new file mode 100644
index 0000000000000000000000000000000000000000..9dad4f4c75b373635ccbe634798f8d9e587e36c1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Pacific differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Samoa b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Samoa
new file mode 100644
index 0000000000000000000000000000000000000000..cb56709a77dedb471150f4907771bf38f1879ba4
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/US/Samoa differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UTC b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UTC
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/UTC differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Universal b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Universal
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Universal differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/W-SU b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/W-SU
new file mode 100644
index 0000000000000000000000000000000000000000..ddb3f4e99a1030f33b56fad986c8d9c16e59eb32
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/W-SU differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/WET b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/WET
new file mode 100644
index 0000000000000000000000000000000000000000..c27390b5b638399057d5f5c6d09ef8c81d5f01c1
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/WET differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Zulu b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Zulu
new file mode 100644
index 0000000000000000000000000000000000000000..91558be0c2bf903b2364215ba26d5227d6126508
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/Zulu differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/iso3166.tab b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/iso3166.tab
new file mode 100644
index 0000000000000000000000000000000000000000..a4ff61a4d3213a5cce54f00bad04f1dfb550d581
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/iso3166.tab
@@ -0,0 +1,274 @@
+# ISO 3166 alpha-2 country codes
+#
+# This file is in the public domain, so clarified as of
+# 2009-05-17 by Arthur David Olson.
+#
+# From Paul Eggert (2015-05-02):
+# This file contains a table of two-letter country codes.  Columns are
+# separated by a single tab.  Lines beginning with '#' are comments.
+# All text uses UTF-8 encoding.  The columns of the table are as follows:
+#
+# 1.  ISO 3166-1 alpha-2 country code, current as of
+#     ISO 3166-1 N976 (2018-11-06).  See: Updates on ISO 3166-1
+#     https://isotc.iso.org/livelink/livelink/Open/16944257
+# 2.  The usual English name for the coded region,
+#     chosen so that alphabetic sorting of subsets produces helpful lists.
+#     This is not the same as the English name in the ISO 3166 tables.
+#
+# The table is sorted by country code.
+#
+# This table is intended as an aid for users, to help them select time
+# zone data appropriate for their practical needs.  It is not intended
+# to take or endorse any position on legal or territorial claims.
+#
+#country-
+#code	name of country, territory, area, or subdivision
+AD	Andorra
+AE	United Arab Emirates
+AF	Afghanistan
+AG	Antigua & Barbuda
+AI	Anguilla
+AL	Albania
+AM	Armenia
+AO	Angola
+AQ	Antarctica
+AR	Argentina
+AS	Samoa (American)
+AT	Austria
+AU	Australia
+AW	Aruba
+AX	Åland Islands
+AZ	Azerbaijan
+BA	Bosnia & Herzegovina
+BB	Barbados
+BD	Bangladesh
+BE	Belgium
+BF	Burkina Faso
+BG	Bulgaria
+BH	Bahrain
+BI	Burundi
+BJ	Benin
+BL	St Barthelemy
+BM	Bermuda
+BN	Brunei
+BO	Bolivia
+BQ	Caribbean NL
+BR	Brazil
+BS	Bahamas
+BT	Bhutan
+BV	Bouvet Island
+BW	Botswana
+BY	Belarus
+BZ	Belize
+CA	Canada
+CC	Cocos (Keeling) Islands
+CD	Congo (Dem. Rep.)
+CF	Central African Rep.
+CG	Congo (Rep.)
+CH	Switzerland
+CI	Côte d'Ivoire
+CK	Cook Islands
+CL	Chile
+CM	Cameroon
+CN	China
+CO	Colombia
+CR	Costa Rica
+CU	Cuba
+CV	Cape Verde
+CW	Curaçao
+CX	Christmas Island
+CY	Cyprus
+CZ	Czech Republic
+DE	Germany
+DJ	Djibouti
+DK	Denmark
+DM	Dominica
+DO	Dominican Republic
+DZ	Algeria
+EC	Ecuador
+EE	Estonia
+EG	Egypt
+EH	Western Sahara
+ER	Eritrea
+ES	Spain
+ET	Ethiopia
+FI	Finland
+FJ	Fiji
+FK	Falkland Islands
+FM	Micronesia
+FO	Faroe Islands
+FR	France
+GA	Gabon
+GB	Britain (UK)
+GD	Grenada
+GE	Georgia
+GF	French Guiana
+GG	Guernsey
+GH	Ghana
+GI	Gibraltar
+GL	Greenland
+GM	Gambia
+GN	Guinea
+GP	Guadeloupe
+GQ	Equatorial Guinea
+GR	Greece
+GS	South Georgia & the South Sandwich Islands
+GT	Guatemala
+GU	Guam
+GW	Guinea-Bissau
+GY	Guyana
+HK	Hong Kong
+HM	Heard Island & McDonald Islands
+HN	Honduras
+HR	Croatia
+HT	Haiti
+HU	Hungary
+ID	Indonesia
+IE	Ireland
+IL	Israel
+IM	Isle of Man
+IN	India
+IO	British Indian Ocean Territory
+IQ	Iraq
+IR	Iran
+IS	Iceland
+IT	Italy
+JE	Jersey
+JM	Jamaica
+JO	Jordan
+JP	Japan
+KE	Kenya
+KG	Kyrgyzstan
+KH	Cambodia
+KI	Kiribati
+KM	Comoros
+KN	St Kitts & Nevis
+KP	Korea (North)
+KR	Korea (South)
+KW	Kuwait
+KY	Cayman Islands
+KZ	Kazakhstan
+LA	Laos
+LB	Lebanon
+LC	St Lucia
+LI	Liechtenstein
+LK	Sri Lanka
+LR	Liberia
+LS	Lesotho
+LT	Lithuania
+LU	Luxembourg
+LV	Latvia
+LY	Libya
+MA	Morocco
+MC	Monaco
+MD	Moldova
+ME	Montenegro
+MF	St Martin (French)
+MG	Madagascar
+MH	Marshall Islands
+MK	North Macedonia
+ML	Mali
+MM	Myanmar (Burma)
+MN	Mongolia
+MO	Macau
+MP	Northern Mariana Islands
+MQ	Martinique
+MR	Mauritania
+MS	Montserrat
+MT	Malta
+MU	Mauritius
+MV	Maldives
+MW	Malawi
+MX	Mexico
+MY	Malaysia
+MZ	Mozambique
+NA	Namibia
+NC	New Caledonia
+NE	Niger
+NF	Norfolk Island
+NG	Nigeria
+NI	Nicaragua
+NL	Netherlands
+NO	Norway
+NP	Nepal
+NR	Nauru
+NU	Niue
+NZ	New Zealand
+OM	Oman
+PA	Panama
+PE	Peru
+PF	French Polynesia
+PG	Papua New Guinea
+PH	Philippines
+PK	Pakistan
+PL	Poland
+PM	St Pierre & Miquelon
+PN	Pitcairn
+PR	Puerto Rico
+PS	Palestine
+PT	Portugal
+PW	Palau
+PY	Paraguay
+QA	Qatar
+RE	Réunion
+RO	Romania
+RS	Serbia
+RU	Russia
+RW	Rwanda
+SA	Saudi Arabia
+SB	Solomon Islands
+SC	Seychelles
+SD	Sudan
+SE	Sweden
+SG	Singapore
+SH	St Helena
+SI	Slovenia
+SJ	Svalbard & Jan Mayen
+SK	Slovakia
+SL	Sierra Leone
+SM	San Marino
+SN	Senegal
+SO	Somalia
+SR	Suriname
+SS	South Sudan
+ST	Sao Tome & Principe
+SV	El Salvador
+SX	St Maarten (Dutch)
+SY	Syria
+SZ	Eswatini (Swaziland)
+TC	Turks & Caicos Is
+TD	Chad
+TF	French Southern & Antarctic Lands
+TG	Togo
+TH	Thailand
+TJ	Tajikistan
+TK	Tokelau
+TL	East Timor
+TM	Turkmenistan
+TN	Tunisia
+TO	Tonga
+TR	Turkey
+TT	Trinidad & Tobago
+TV	Tuvalu
+TW	Taiwan
+TZ	Tanzania
+UA	Ukraine
+UG	Uganda
+UM	US minor outlying islands
+US	United States
+UY	Uruguay
+UZ	Uzbekistan
+VA	Vatican City
+VC	St Vincent
+VE	Venezuela
+VG	Virgin Islands (UK)
+VI	Virgin Islands (US)
+VN	Vietnam
+VU	Vanuatu
+WF	Wallis & Futuna
+WS	Samoa (western)
+YE	Yemen
+YT	Mayotte
+ZA	South Africa
+ZM	Zambia
+ZW	Zimbabwe
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/leapseconds b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/leapseconds
new file mode 100644
index 0000000000000000000000000000000000000000..cf0df04c3c8eaa6f1fb875ea930b9767958740d8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/leapseconds
@@ -0,0 +1,82 @@
+# Allowance for leap seconds added to each time zone file.
+
+# This file is in the public domain.
+
+# This file is generated automatically from the data in the public-domain
+# NIST format leap-seconds.list file, which can be copied from
+# <ftp://ftp.nist.gov/pub/time/leap-seconds.list>
+# or <ftp://ftp.boulder.nist.gov/pub/time/leap-seconds.list>.
+# The NIST file is used instead of its IERS upstream counterpart
+# <https://hpiers.obspm.fr/iers/bul/bulc/ntp/leap-seconds.list>
+# because under US law the NIST file is public domain
+# whereas the IERS file's copyright and license status is unclear.
+# For more about leap-seconds.list, please see
+# The NTP Timescale and Leap Seconds
+# <https://www.eecis.udel.edu/~mills/leap.html>.
+
+# The rules for leap seconds are specified in Annex 1 (Time scales) of:
+# Standard-frequency and time-signal emissions.
+# International Telecommunication Union - Radiocommunication Sector
+# (ITU-R) Recommendation TF.460-6 (02/2002)
+# <https://www.itu.int/rec/R-REC-TF.460-6-200202-I/>.
+# The International Earth Rotation and Reference Systems Service (IERS)
+# periodically uses leap seconds to keep UTC to within 0.9 s of UT1
+# (a proxy for Earth's angle in space as measured by astronomers)
+# and publishes leap second data in a copyrighted file
+# <https://hpiers.obspm.fr/iers/bul/bulc/Leap_Second.dat>.
+# See: Levine J. Coordinated Universal Time and the leap second.
+# URSI Radio Sci Bull. 2016;89(4):30-6. doi:10.23919/URSIRSB.2016.7909995
+# <https://ieeexplore.ieee.org/document/7909995>.
+
+# There were no leap seconds before 1972, as no official mechanism
+# accounted for the discrepancy between atomic time (TAI) and the earth's
+# rotation.  The first ("1 Jan 1972") data line in leap-seconds.list
+# does not denote a leap second; it denotes the start of the current definition
+# of UTC.
+
+# All leap-seconds are Stationary (S) at the given UTC time.
+# The correction (+ or -) is made at the given time, so in the unlikely
+# event of a negative leap second, a line would look like this:
+# Leap	YEAR	MON	DAY	23:59:59	-	S
+# Typical lines look like this:
+# Leap	YEAR	MON	DAY	23:59:60	+	S
+Leap	1972	Jun	30	23:59:60	+	S
+Leap	1972	Dec	31	23:59:60	+	S
+Leap	1973	Dec	31	23:59:60	+	S
+Leap	1974	Dec	31	23:59:60	+	S
+Leap	1975	Dec	31	23:59:60	+	S
+Leap	1976	Dec	31	23:59:60	+	S
+Leap	1977	Dec	31	23:59:60	+	S
+Leap	1978	Dec	31	23:59:60	+	S
+Leap	1979	Dec	31	23:59:60	+	S
+Leap	1981	Jun	30	23:59:60	+	S
+Leap	1982	Jun	30	23:59:60	+	S
+Leap	1983	Jun	30	23:59:60	+	S
+Leap	1985	Jun	30	23:59:60	+	S
+Leap	1987	Dec	31	23:59:60	+	S
+Leap	1989	Dec	31	23:59:60	+	S
+Leap	1990	Dec	31	23:59:60	+	S
+Leap	1992	Jun	30	23:59:60	+	S
+Leap	1993	Jun	30	23:59:60	+	S
+Leap	1994	Jun	30	23:59:60	+	S
+Leap	1995	Dec	31	23:59:60	+	S
+Leap	1997	Jun	30	23:59:60	+	S
+Leap	1998	Dec	31	23:59:60	+	S
+Leap	2005	Dec	31	23:59:60	+	S
+Leap	2008	Dec	31	23:59:60	+	S
+Leap	2012	Jun	30	23:59:60	+	S
+Leap	2015	Jun	30	23:59:60	+	S
+Leap	2016	Dec	31	23:59:60	+	S
+
+# UTC timestamp when this leap second list expires.
+# Any additional leap seconds will come after this.
+# This Expires line is commented out for now,
+# so that pre-2020a zic implementations do not reject this file.
+#Expires 2021	Dec	28	00:00:00
+
+# POSIX timestamps for the data in this file:
+#updated 1467936000 (2016-07-08 00:00:00 UTC)
+#expires 1640649600 (2021-12-28 00:00:00 UTC)
+
+#	Updated through IERS Bulletin C61
+#	File expires on:  28 December 2021
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/tzdata.zi b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/tzdata.zi
new file mode 100644
index 0000000000000000000000000000000000000000..aaf67f0c1b649d6567b6ae4187fabf0da692e716
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/tzdata.zi
@@ -0,0 +1,4459 @@
+# version unknown-dirty
+# This zic input file is in the public domain.
+R d 1916 o - Jun 14 23s 1 S
+R d 1916 1919 - O Su>=1 23s 0 -
+R d 1917 o - Mar 24 23s 1 S
+R d 1918 o - Mar 9 23s 1 S
+R d 1919 o - Mar 1 23s 1 S
+R d 1920 o - F 14 23s 1 S
+R d 1920 o - O 23 23s 0 -
+R d 1921 o - Mar 14 23s 1 S
+R d 1921 o - Jun 21 23s 0 -
+R d 1939 o - S 11 23s 1 S
+R d 1939 o - N 19 1 0 -
+R d 1944 1945 - Ap M>=1 2 1 S
+R d 1944 o - O 8 2 0 -
+R d 1945 o - S 16 1 0 -
+R d 1971 o - Ap 25 23s 1 S
+R d 1971 o - S 26 23s 0 -
+R d 1977 o - May 6 0 1 S
+R d 1977 o - O 21 0 0 -
+R d 1978 o - Mar 24 1 1 S
+R d 1978 o - S 22 3 0 -
+R d 1980 o - Ap 25 0 1 S
+R d 1980 o - O 31 2 0 -
+Z Africa/Algiers 0:12:12 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 d WE%sT 1940 F 25 2
+1 d CE%sT 1946 O 7
+0 - WET 1956 Ja 29
+1 - CET 1963 Ap 14
+0 d WE%sT 1977 O 21
+1 d CE%sT 1979 O 26
+0 d WE%sT 1981 May
+1 - CET
+Z Atlantic/Cape_Verde -1:34:4 - LMT 1912 Ja 1 2u
+-2 - -02 1942 S
+-2 1 -01 1945 O 15
+-2 - -02 1975 N 25 2
+-1 - -01
+Z Africa/Ndjamena 1:0:12 - LMT 1912
+1 - WAT 1979 O 14
+1 1 WAST 1980 Mar 8
+1 - WAT
+Z Africa/Abidjan -0:16:8 - LMT 1912
+0 - GMT
+L Africa/Abidjan Africa/Bamako
+L Africa/Abidjan Africa/Banjul
+L Africa/Abidjan Africa/Conakry
+L Africa/Abidjan Africa/Dakar
+L Africa/Abidjan Africa/Freetown
+L Africa/Abidjan Africa/Lome
+L Africa/Abidjan Africa/Nouakchott
+L Africa/Abidjan Africa/Ouagadougou
+L Africa/Abidjan Atlantic/St_Helena
+R K 1940 o - Jul 15 0 1 S
+R K 1940 o - O 1 0 0 -
+R K 1941 o - Ap 15 0 1 S
+R K 1941 o - S 16 0 0 -
+R K 1942 1944 - Ap 1 0 1 S
+R K 1942 o - O 27 0 0 -
+R K 1943 1945 - N 1 0 0 -
+R K 1945 o - Ap 16 0 1 S
+R K 1957 o - May 10 0 1 S
+R K 1957 1958 - O 1 0 0 -
+R K 1958 o - May 1 0 1 S
+R K 1959 1981 - May 1 1 1 S
+R K 1959 1965 - S 30 3 0 -
+R K 1966 1994 - O 1 3 0 -
+R K 1982 o - Jul 25 1 1 S
+R K 1983 o - Jul 12 1 1 S
+R K 1984 1988 - May 1 1 1 S
+R K 1989 o - May 6 1 1 S
+R K 1990 1994 - May 1 1 1 S
+R K 1995 2010 - Ap lastF 0s 1 S
+R K 1995 2005 - S lastTh 24 0 -
+R K 2006 o - S 21 24 0 -
+R K 2007 o - S Th>=1 24 0 -
+R K 2008 o - Au lastTh 24 0 -
+R K 2009 o - Au 20 24 0 -
+R K 2010 o - Au 10 24 0 -
+R K 2010 o - S 9 24 1 S
+R K 2010 o - S lastTh 24 0 -
+R K 2014 o - May 15 24 1 S
+R K 2014 o - Jun 26 24 0 -
+R K 2014 o - Jul 31 24 1 S
+R K 2014 o - S lastTh 24 0 -
+Z Africa/Cairo 2:5:9 - LMT 1900 O
+2 K EE%sT
+R GH 1919 o - N 24 0 0:20 +0020
+R GH 1920 1942 - Ja 1 2 0 GMT
+R GH 1920 1939 - S 1 2 0:20 +0020
+R GH 1940 1941 - May 1 2 0:20 +0020
+R GH 1950 1955 - S 1 2 0:30 +0030
+R GH 1951 1956 - Ja 1 2 0 GMT
+Z Africa/Accra -0:0:52 - LMT 1915 N 2
+0 GH %s 1942 F 8
+0:30 - +0030 1946 Ja 6
+0 GH %s
+Z Africa/Bissau -1:2:20 - LMT 1912 Ja 1 1u
+-1 - -01 1975
+0 - GMT
+Z Africa/Nairobi 2:27:16 - LMT 1908 May
+2:30 - +0230 1928 Jun 30 24
+3 - EAT 1930 Ja 4 24
+2:30 - +0230 1936 D 31 24
+2:45 - +0245 1942 Jul 31 24
+3 - EAT
+L Africa/Nairobi Africa/Addis_Ababa
+L Africa/Nairobi Africa/Asmara
+L Africa/Nairobi Africa/Dar_es_Salaam
+L Africa/Nairobi Africa/Djibouti
+L Africa/Nairobi Africa/Kampala
+L Africa/Nairobi Africa/Mogadishu
+L Africa/Nairobi Indian/Antananarivo
+L Africa/Nairobi Indian/Comoro
+L Africa/Nairobi Indian/Mayotte
+Z Africa/Monrovia -0:43:8 - LMT 1882
+-0:43:8 - MMT 1919 Mar
+-0:44:30 - MMT 1972 Ja 7
+0 - GMT
+R L 1951 o - O 14 2 1 S
+R L 1952 o - Ja 1 0 0 -
+R L 1953 o - O 9 2 1 S
+R L 1954 o - Ja 1 0 0 -
+R L 1955 o - S 30 0 1 S
+R L 1956 o - Ja 1 0 0 -
+R L 1982 1984 - Ap 1 0 1 S
+R L 1982 1985 - O 1 0 0 -
+R L 1985 o - Ap 6 0 1 S
+R L 1986 o - Ap 4 0 1 S
+R L 1986 o - O 3 0 0 -
+R L 1987 1989 - Ap 1 0 1 S
+R L 1987 1989 - O 1 0 0 -
+R L 1997 o - Ap 4 0 1 S
+R L 1997 o - O 4 0 0 -
+R L 2013 o - Mar lastF 1 1 S
+R L 2013 o - O lastF 2 0 -
+Z Africa/Tripoli 0:52:44 - LMT 1920
+1 L CE%sT 1959
+2 - EET 1982
+1 L CE%sT 1990 May 4
+2 - EET 1996 S 30
+1 L CE%sT 1997 O 4
+2 - EET 2012 N 10 2
+1 L CE%sT 2013 O 25 2
+2 - EET
+R MU 1982 o - O 10 0 1 -
+R MU 1983 o - Mar 21 0 0 -
+R MU 2008 o - O lastSu 2 1 -
+R MU 2009 o - Mar lastSu 2 0 -
+Z Indian/Mauritius 3:50 - LMT 1907
+4 MU +04/+05
+R M 1939 o - S 12 0 1 -
+R M 1939 o - N 19 0 0 -
+R M 1940 o - F 25 0 1 -
+R M 1945 o - N 18 0 0 -
+R M 1950 o - Jun 11 0 1 -
+R M 1950 o - O 29 0 0 -
+R M 1967 o - Jun 3 12 1 -
+R M 1967 o - O 1 0 0 -
+R M 1974 o - Jun 24 0 1 -
+R M 1974 o - S 1 0 0 -
+R M 1976 1977 - May 1 0 1 -
+R M 1976 o - Au 1 0 0 -
+R M 1977 o - S 28 0 0 -
+R M 1978 o - Jun 1 0 1 -
+R M 1978 o - Au 4 0 0 -
+R M 2008 o - Jun 1 0 1 -
+R M 2008 o - S 1 0 0 -
+R M 2009 o - Jun 1 0 1 -
+R M 2009 o - Au 21 0 0 -
+R M 2010 o - May 2 0 1 -
+R M 2010 o - Au 8 0 0 -
+R M 2011 o - Ap 3 0 1 -
+R M 2011 o - Jul 31 0 0 -
+R M 2012 2013 - Ap lastSu 2 1 -
+R M 2012 o - Jul 20 3 0 -
+R M 2012 o - Au 20 2 1 -
+R M 2012 o - S 30 3 0 -
+R M 2013 o - Jul 7 3 0 -
+R M 2013 o - Au 10 2 1 -
+R M 2013 2018 - O lastSu 3 0 -
+R M 2014 2018 - Mar lastSu 2 1 -
+R M 2014 o - Jun 28 3 0 -
+R M 2014 o - Au 2 2 1 -
+R M 2015 o - Jun 14 3 0 -
+R M 2015 o - Jul 19 2 1 -
+R M 2016 o - Jun 5 3 0 -
+R M 2016 o - Jul 10 2 1 -
+R M 2017 o - May 21 3 0 -
+R M 2017 o - Jul 2 2 1 -
+R M 2018 o - May 13 3 0 -
+R M 2018 o - Jun 17 2 1 -
+R M 2019 o - May 5 3 -1 -
+R M 2019 o - Jun 9 2 0 -
+R M 2020 o - Ap 19 3 -1 -
+R M 2020 o - May 31 2 0 -
+R M 2021 o - Ap 11 3 -1 -
+R M 2021 o - May 16 2 0 -
+R M 2022 o - Mar 27 3 -1 -
+R M 2022 o - May 8 2 0 -
+R M 2023 o - Mar 19 3 -1 -
+R M 2023 o - Ap 30 2 0 -
+R M 2024 o - Mar 10 3 -1 -
+R M 2024 o - Ap 14 2 0 -
+R M 2025 o - F 23 3 -1 -
+R M 2025 o - Ap 6 2 0 -
+R M 2026 o - F 15 3 -1 -
+R M 2026 o - Mar 22 2 0 -
+R M 2027 o - F 7 3 -1 -
+R M 2027 o - Mar 14 2 0 -
+R M 2028 o - Ja 23 3 -1 -
+R M 2028 o - Mar 5 2 0 -
+R M 2029 o - Ja 14 3 -1 -
+R M 2029 o - F 18 2 0 -
+R M 2029 o - D 30 3 -1 -
+R M 2030 o - F 10 2 0 -
+R M 2030 o - D 22 3 -1 -
+R M 2031 o - F 2 2 0 -
+R M 2031 o - D 14 3 -1 -
+R M 2032 o - Ja 18 2 0 -
+R M 2032 o - N 28 3 -1 -
+R M 2033 o - Ja 9 2 0 -
+R M 2033 o - N 20 3 -1 -
+R M 2033 o - D 25 2 0 -
+R M 2034 o - N 5 3 -1 -
+R M 2034 o - D 17 2 0 -
+R M 2035 o - O 28 3 -1 -
+R M 2035 o - D 9 2 0 -
+R M 2036 o - O 19 3 -1 -
+R M 2036 o - N 23 2 0 -
+R M 2037 o - O 4 3 -1 -
+R M 2037 o - N 15 2 0 -
+R M 2038 o - S 26 3 -1 -
+R M 2038 o - N 7 2 0 -
+R M 2039 o - S 18 3 -1 -
+R M 2039 o - O 23 2 0 -
+R M 2040 o - S 2 3 -1 -
+R M 2040 o - O 14 2 0 -
+R M 2041 o - Au 25 3 -1 -
+R M 2041 o - S 29 2 0 -
+R M 2042 o - Au 10 3 -1 -
+R M 2042 o - S 21 2 0 -
+R M 2043 o - Au 2 3 -1 -
+R M 2043 o - S 13 2 0 -
+R M 2044 o - Jul 24 3 -1 -
+R M 2044 o - Au 28 2 0 -
+R M 2045 o - Jul 9 3 -1 -
+R M 2045 o - Au 20 2 0 -
+R M 2046 o - Jul 1 3 -1 -
+R M 2046 o - Au 12 2 0 -
+R M 2047 o - Jun 23 3 -1 -
+R M 2047 o - Jul 28 2 0 -
+R M 2048 o - Jun 7 3 -1 -
+R M 2048 o - Jul 19 2 0 -
+R M 2049 o - May 30 3 -1 -
+R M 2049 o - Jul 4 2 0 -
+R M 2050 o - May 15 3 -1 -
+R M 2050 o - Jun 26 2 0 -
+R M 2051 o - May 7 3 -1 -
+R M 2051 o - Jun 18 2 0 -
+R M 2052 o - Ap 28 3 -1 -
+R M 2052 o - Jun 2 2 0 -
+R M 2053 o - Ap 13 3 -1 -
+R M 2053 o - May 25 2 0 -
+R M 2054 o - Ap 5 3 -1 -
+R M 2054 o - May 17 2 0 -
+R M 2055 o - Mar 28 3 -1 -
+R M 2055 o - May 2 2 0 -
+R M 2056 o - Mar 12 3 -1 -
+R M 2056 o - Ap 23 2 0 -
+R M 2057 o - Mar 4 3 -1 -
+R M 2057 o - Ap 8 2 0 -
+R M 2058 o - F 17 3 -1 -
+R M 2058 o - Mar 31 2 0 -
+R M 2059 o - F 9 3 -1 -
+R M 2059 o - Mar 23 2 0 -
+R M 2060 o - F 1 3 -1 -
+R M 2060 o - Mar 7 2 0 -
+R M 2061 o - Ja 16 3 -1 -
+R M 2061 o - F 27 2 0 -
+R M 2062 o - Ja 8 3 -1 -
+R M 2062 o - F 19 2 0 -
+R M 2062 o - D 31 3 -1 -
+R M 2063 o - F 4 2 0 -
+R M 2063 o - D 16 3 -1 -
+R M 2064 o - Ja 27 2 0 -
+R M 2064 o - D 7 3 -1 -
+R M 2065 o - Ja 11 2 0 -
+R M 2065 o - N 22 3 -1 -
+R M 2066 o - Ja 3 2 0 -
+R M 2066 o - N 14 3 -1 -
+R M 2066 o - D 26 2 0 -
+R M 2067 o - N 6 3 -1 -
+R M 2067 o - D 11 2 0 -
+R M 2068 o - O 21 3 -1 -
+R M 2068 o - D 2 2 0 -
+R M 2069 o - O 13 3 -1 -
+R M 2069 o - N 24 2 0 -
+R M 2070 o - O 5 3 -1 -
+R M 2070 o - N 9 2 0 -
+R M 2071 o - S 20 3 -1 -
+R M 2071 o - N 1 2 0 -
+R M 2072 o - S 11 3 -1 -
+R M 2072 o - O 16 2 0 -
+R M 2073 o - Au 27 3 -1 -
+R M 2073 o - O 8 2 0 -
+R M 2074 o - Au 19 3 -1 -
+R M 2074 o - S 30 2 0 -
+R M 2075 o - Au 11 3 -1 -
+R M 2075 o - S 15 2 0 -
+R M 2076 o - Jul 26 3 -1 -
+R M 2076 o - S 6 2 0 -
+R M 2077 o - Jul 18 3 -1 -
+R M 2077 o - Au 29 2 0 -
+R M 2078 o - Jul 10 3 -1 -
+R M 2078 o - Au 14 2 0 -
+R M 2079 o - Jun 25 3 -1 -
+R M 2079 o - Au 6 2 0 -
+R M 2080 o - Jun 16 3 -1 -
+R M 2080 o - Jul 21 2 0 -
+R M 2081 o - Jun 1 3 -1 -
+R M 2081 o - Jul 13 2 0 -
+R M 2082 o - May 24 3 -1 -
+R M 2082 o - Jul 5 2 0 -
+R M 2083 o - May 16 3 -1 -
+R M 2083 o - Jun 20 2 0 -
+R M 2084 o - Ap 30 3 -1 -
+R M 2084 o - Jun 11 2 0 -
+R M 2085 o - Ap 22 3 -1 -
+R M 2085 o - Jun 3 2 0 -
+R M 2086 o - Ap 14 3 -1 -
+R M 2086 o - May 19 2 0 -
+R M 2087 o - Mar 30 3 -1 -
+R M 2087 o - May 11 2 0 -
+Z Africa/Casablanca -0:30:20 - LMT 1913 O 26
+0 M +00/+01 1984 Mar 16
+1 - +01 1986
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/El_Aaiun -0:52:48 - LMT 1934
+-1 - -01 1976 Ap 14
+0 M +00/+01 2018 O 28 3
+1 M +01/+00
+Z Africa/Maputo 2:10:20 - LMT 1903 Mar
+2 - CAT
+L Africa/Maputo Africa/Blantyre
+L Africa/Maputo Africa/Bujumbura
+L Africa/Maputo Africa/Gaborone
+L Africa/Maputo Africa/Harare
+L Africa/Maputo Africa/Kigali
+L Africa/Maputo Africa/Lubumbashi
+L Africa/Maputo Africa/Lusaka
+R NA 1994 o - Mar 21 0 -1 WAT
+R NA 1994 2017 - S Su>=1 2 0 CAT
+R NA 1995 2017 - Ap Su>=1 2 -1 WAT
+Z Africa/Windhoek 1:8:24 - LMT 1892 F 8
+1:30 - +0130 1903 Mar
+2 - SAST 1942 S 20 2
+2 1 SAST 1943 Mar 21 2
+2 - SAST 1990 Mar 21
+2 NA %s
+Z Africa/Lagos 0:13:35 - LMT 1905 Jul
+0 - GMT 1908 Jul
+0:13:35 - LMT 1914
+0:30 - +0030 1919 S
+1 - WAT
+L Africa/Lagos Africa/Bangui
+L Africa/Lagos Africa/Brazzaville
+L Africa/Lagos Africa/Douala
+L Africa/Lagos Africa/Kinshasa
+L Africa/Lagos Africa/Libreville
+L Africa/Lagos Africa/Luanda
+L Africa/Lagos Africa/Malabo
+L Africa/Lagos Africa/Niamey
+L Africa/Lagos Africa/Porto-Novo
+Z Indian/Reunion 3:41:52 - LMT 1911 Jun
+4 - +04
+Z Africa/Sao_Tome 0:26:56 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 - GMT 2018 Ja 1 1
+1 - WAT 2019 Ja 1 2
+0 - GMT
+Z Indian/Mahe 3:41:48 - LMT 1907
+4 - +04
+R SA 1942 1943 - S Su>=15 2 1 -
+R SA 1943 1944 - Mar Su>=15 2 0 -
+Z Africa/Johannesburg 1:52 - LMT 1892 F 8
+1:30 - SAST 1903 Mar
+2 SA SAST
+L Africa/Johannesburg Africa/Maseru
+L Africa/Johannesburg Africa/Mbabane
+R SD 1970 o - May 1 0 1 S
+R SD 1970 1985 - O 15 0 0 -
+R SD 1971 o - Ap 30 0 1 S
+R SD 1972 1985 - Ap lastSu 0 1 S
+Z Africa/Khartoum 2:10:8 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2017 N
+2 - CAT
+Z Africa/Juba 2:6:28 - LMT 1931
+2 SD CA%sT 2000 Ja 15 12
+3 - EAT 2021 F
+2 - CAT
+R n 1939 o - Ap 15 23s 1 S
+R n 1939 o - N 18 23s 0 -
+R n 1940 o - F 25 23s 1 S
+R n 1941 o - O 6 0 0 -
+R n 1942 o - Mar 9 0 1 S
+R n 1942 o - N 2 3 0 -
+R n 1943 o - Mar 29 2 1 S
+R n 1943 o - Ap 17 2 0 -
+R n 1943 o - Ap 25 2 1 S
+R n 1943 o - O 4 2 0 -
+R n 1944 1945 - Ap M>=1 2 1 S
+R n 1944 o - O 8 0 0 -
+R n 1945 o - S 16 0 0 -
+R n 1977 o - Ap 30 0s 1 S
+R n 1977 o - S 24 0s 0 -
+R n 1978 o - May 1 0s 1 S
+R n 1978 o - O 1 0s 0 -
+R n 1988 o - Jun 1 0s 1 S
+R n 1988 1990 - S lastSu 0s 0 -
+R n 1989 o - Mar 26 0s 1 S
+R n 1990 o - May 1 0s 1 S
+R n 2005 o - May 1 0s 1 S
+R n 2005 o - S 30 1s 0 -
+R n 2006 2008 - Mar lastSu 2s 1 S
+R n 2006 2008 - O lastSu 2s 0 -
+Z Africa/Tunis 0:40:44 - LMT 1881 May 12
+0:9:21 - PMT 1911 Mar 11
+1 n CE%sT
+Z Antarctica/Casey 0 - -00 1969
+8 - +08 2009 O 18 2
+11 - +11 2010 Mar 5 2
+8 - +08 2011 O 28 2
+11 - +11 2012 F 21 17u
+8 - +08 2016 O 22
+11 - +11 2018 Mar 11 4
+8 - +08 2018 O 7 4
+11 - +11 2019 Mar 17 3
+8 - +08 2019 O 4 3
+11 - +11 2020 Mar 8 3
+8 - +08 2020 O 4 0:1
+11 - +11
+Z Antarctica/Davis 0 - -00 1957 Ja 13
+7 - +07 1964 N
+0 - -00 1969 F
+7 - +07 2009 O 18 2
+5 - +05 2010 Mar 10 20u
+7 - +07 2011 O 28 2
+5 - +05 2012 F 21 20u
+7 - +07
+Z Antarctica/Mawson 0 - -00 1954 F 13
+6 - +06 2009 O 18 2
+5 - +05
+Z Indian/Kerguelen 0 - -00 1950
+5 - +05
+Z Antarctica/DumontDUrville 0 - -00 1947
+10 - +10 1952 Ja 14
+0 - -00 1956 N
+10 - +10
+Z Antarctica/Syowa 0 - -00 1957 Ja 29
+3 - +03
+R Tr 2005 ma - Mar lastSu 1u 2 +02
+R Tr 2004 ma - O lastSu 1u 0 +00
+Z Antarctica/Troll 0 - -00 2005 F 12
+0 Tr %s
+Z Antarctica/Vostok 0 - -00 1957 D 16
+6 - +06
+Z Antarctica/Rothera 0 - -00 1976 D
+-3 - -03
+Z Asia/Kabul 4:36:48 - LMT 1890
+4 - +04 1945
+4:30 - +0430
+R AM 2011 o - Mar lastSu 2s 1 -
+R AM 2011 o - O lastSu 2s 0 -
+Z Asia/Yerevan 2:58 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1995 S 24 2s
+4 - +04 1997
+4 R +04/+05 2011
+4 AM +04/+05
+R AZ 1997 2015 - Mar lastSu 4 1 -
+R AZ 1997 2015 - O lastSu 5 0 -
+Z Asia/Baku 3:19:24 - LMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992 S lastSu 2s
+4 - +04 1996
+4 E +04/+05 1997
+4 AZ +04/+05
+R BD 2009 o - Jun 19 23 1 -
+R BD 2009 o - D 31 24 0 -
+Z Asia/Dhaka 6:1:40 - LMT 1890
+5:53:20 - HMT 1941 O
+6:30 - +0630 1942 May 15
+5:30 - +0530 1942 S
+6:30 - +0630 1951 S 30
+6 - +06 2009
+6 BD +06/+07
+Z Asia/Thimphu 5:58:36 - LMT 1947 Au 15
+5:30 - +0530 1987 O
+6 - +06
+Z Indian/Chagos 4:49:40 - LMT 1907
+5 - +05 1996
+6 - +06
+Z Asia/Brunei 7:39:40 - LMT 1926 Mar
+7:30 - +0730 1933
+8 - +08
+Z Asia/Yangon 6:24:47 - LMT 1880
+6:24:47 - RMT 1920
+6:30 - +0630 1942 May
+9 - +09 1945 May 3
+6:30 - +0630
+R Sh 1919 o - Ap 12 24 1 D
+R Sh 1919 o - S 30 24 0 S
+R Sh 1940 o - Jun 1 0 1 D
+R Sh 1940 o - O 12 24 0 S
+R Sh 1941 o - Mar 15 0 1 D
+R Sh 1941 o - N 1 24 0 S
+R Sh 1942 o - Ja 31 0 1 D
+R Sh 1945 o - S 1 24 0 S
+R Sh 1946 o - May 15 0 1 D
+R Sh 1946 o - S 30 24 0 S
+R Sh 1947 o - Ap 15 0 1 D
+R Sh 1947 o - O 31 24 0 S
+R Sh 1948 1949 - May 1 0 1 D
+R Sh 1948 1949 - S 30 24 0 S
+R CN 1986 o - May 4 2 1 D
+R CN 1986 1991 - S Su>=11 2 0 S
+R CN 1987 1991 - Ap Su>=11 2 1 D
+Z Asia/Shanghai 8:5:43 - LMT 1901
+8 Sh C%sT 1949 May 28
+8 CN C%sT
+Z Asia/Urumqi 5:50:20 - LMT 1928
+6 - +06
+R HK 1946 o - Ap 21 0 1 S
+R HK 1946 o - D 1 3:30s 0 -
+R HK 1947 o - Ap 13 3:30s 1 S
+R HK 1947 o - N 30 3:30s 0 -
+R HK 1948 o - May 2 3:30s 1 S
+R HK 1948 1952 - O Su>=28 3:30s 0 -
+R HK 1949 1953 - Ap Su>=1 3:30 1 S
+R HK 1953 1964 - O Su>=31 3:30 0 -
+R HK 1954 1964 - Mar Su>=18 3:30 1 S
+R HK 1965 1976 - Ap Su>=16 3:30 1 S
+R HK 1965 1976 - O Su>=16 3:30 0 -
+R HK 1973 o - D 30 3:30 1 S
+R HK 1979 o - May 13 3:30 1 S
+R HK 1979 o - O 21 3:30 0 -
+Z Asia/Hong_Kong 7:36:42 - LMT 1904 O 30 0:36:42
+8 - HKT 1941 Jun 15 3
+8 1 HKST 1941 O 1 4
+8 0:30 HKWT 1941 D 25
+9 - JST 1945 N 18 2
+8 HK HK%sT
+R f 1946 o - May 15 0 1 D
+R f 1946 o - O 1 0 0 S
+R f 1947 o - Ap 15 0 1 D
+R f 1947 o - N 1 0 0 S
+R f 1948 1951 - May 1 0 1 D
+R f 1948 1951 - O 1 0 0 S
+R f 1952 o - Mar 1 0 1 D
+R f 1952 1954 - N 1 0 0 S
+R f 1953 1959 - Ap 1 0 1 D
+R f 1955 1961 - O 1 0 0 S
+R f 1960 1961 - Jun 1 0 1 D
+R f 1974 1975 - Ap 1 0 1 D
+R f 1974 1975 - O 1 0 0 S
+R f 1979 o - Jul 1 0 1 D
+R f 1979 o - O 1 0 0 S
+Z Asia/Taipei 8:6 - LMT 1896
+8 - CST 1937 O
+9 - JST 1945 S 21 1
+8 f C%sT
+R _ 1942 1943 - Ap 30 23 1 -
+R _ 1942 o - N 17 23 0 -
+R _ 1943 o - S 30 23 0 S
+R _ 1946 o - Ap 30 23s 1 D
+R _ 1946 o - S 30 23s 0 S
+R _ 1947 o - Ap 19 23s 1 D
+R _ 1947 o - N 30 23s 0 S
+R _ 1948 o - May 2 23s 1 D
+R _ 1948 o - O 31 23s 0 S
+R _ 1949 1950 - Ap Sa>=1 23s 1 D
+R _ 1949 1950 - O lastSa 23s 0 S
+R _ 1951 o - Mar 31 23s 1 D
+R _ 1951 o - O 28 23s 0 S
+R _ 1952 1953 - Ap Sa>=1 23s 1 D
+R _ 1952 o - N 1 23s 0 S
+R _ 1953 1954 - O lastSa 23s 0 S
+R _ 1954 1956 - Mar Sa>=17 23s 1 D
+R _ 1955 o - N 5 23s 0 S
+R _ 1956 1964 - N Su>=1 3:30 0 S
+R _ 1957 1964 - Mar Su>=18 3:30 1 D
+R _ 1965 1973 - Ap Su>=16 3:30 1 D
+R _ 1965 1966 - O Su>=16 2:30 0 S
+R _ 1967 1976 - O Su>=16 3:30 0 S
+R _ 1973 o - D 30 3:30 1 D
+R _ 1975 1976 - Ap Su>=16 3:30 1 D
+R _ 1979 o - May 13 3:30 1 D
+R _ 1979 o - O Su>=16 3:30 0 S
+Z Asia/Macau 7:34:10 - LMT 1904 O 30
+8 - CST 1941 D 21 23
+9 _ +09/+10 1945 S 30 24
+8 _ C%sT
+R CY 1975 o - Ap 13 0 1 S
+R CY 1975 o - O 12 0 0 -
+R CY 1976 o - May 15 0 1 S
+R CY 1976 o - O 11 0 0 -
+R CY 1977 1980 - Ap Su>=1 0 1 S
+R CY 1977 o - S 25 0 0 -
+R CY 1978 o - O 2 0 0 -
+R CY 1979 1997 - S lastSu 0 0 -
+R CY 1981 1998 - Mar lastSu 0 1 S
+Z Asia/Nicosia 2:13:28 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT
+Z Asia/Famagusta 2:15:48 - LMT 1921 N 14
+2 CY EE%sT 1998 S
+2 E EE%sT 2016 S 8
+3 - +03 2017 O 29 1u
+2 E EE%sT
+L Asia/Nicosia Europe/Nicosia
+Z Asia/Tbilisi 2:59:11 - LMT 1880
+2:59:11 - TBMT 1924 May 2
+3 - +03 1957 Mar
+4 R +04/+05 1991 Mar 31 2s
+3 R +03/+04 1992
+3 e +03/+04 1994 S lastSu
+4 e +04/+05 1996 O lastSu
+4 1 +05 1997 Mar lastSu
+4 e +04/+05 2004 Jun 27
+3 R +03/+04 2005 Mar lastSu 2
+4 - +04
+Z Asia/Dili 8:22:20 - LMT 1912
+8 - +08 1942 F 21 23
+9 - +09 1976 May 3
+8 - +08 2000 S 17
+9 - +09
+Z Asia/Kolkata 5:53:28 - LMT 1854 Jun 28
+5:53:20 - HMT 1870
+5:21:10 - MMT 1906
+5:30 - IST 1941 O
+5:30 1 +0630 1942 May 15
+5:30 - IST 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - IST
+Z Asia/Jakarta 7:7:12 - LMT 1867 Au 10
+7:7:12 - BMT 1923 D 31 23:47:12
+7:20 - +0720 1932 N
+7:30 - +0730 1942 Mar 23
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+7 - WIB
+Z Asia/Pontianak 7:17:20 - LMT 1908 May
+7:17:20 - PMT 1932 N
+7:30 - +0730 1942 Ja 29
+9 - +09 1945 S 23
+7:30 - +0730 1948 May
+8 - +08 1950 May
+7:30 - +0730 1964
+8 - WITA 1988
+7 - WIB
+Z Asia/Makassar 7:57:36 - LMT 1920
+7:57:36 - MMT 1932 N
+8 - +08 1942 F 9
+9 - +09 1945 S 23
+8 - WITA
+Z Asia/Jayapura 9:22:48 - LMT 1932 N
+9 - +09 1944 S
+9:30 - +0930 1964
+9 - WIT
+R i 1978 1980 - Mar 20 24 1 -
+R i 1978 o - O 20 24 0 -
+R i 1979 o - S 18 24 0 -
+R i 1980 o - S 22 24 0 -
+R i 1991 o - May 2 24 1 -
+R i 1992 1995 - Mar 21 24 1 -
+R i 1991 1995 - S 21 24 0 -
+R i 1996 o - Mar 20 24 1 -
+R i 1996 o - S 20 24 0 -
+R i 1997 1999 - Mar 21 24 1 -
+R i 1997 1999 - S 21 24 0 -
+R i 2000 o - Mar 20 24 1 -
+R i 2000 o - S 20 24 0 -
+R i 2001 2003 - Mar 21 24 1 -
+R i 2001 2003 - S 21 24 0 -
+R i 2004 o - Mar 20 24 1 -
+R i 2004 o - S 20 24 0 -
+R i 2005 o - Mar 21 24 1 -
+R i 2005 o - S 21 24 0 -
+R i 2008 o - Mar 20 24 1 -
+R i 2008 o - S 20 24 0 -
+R i 2009 2011 - Mar 21 24 1 -
+R i 2009 2011 - S 21 24 0 -
+R i 2012 o - Mar 20 24 1 -
+R i 2012 o - S 20 24 0 -
+R i 2013 2015 - Mar 21 24 1 -
+R i 2013 2015 - S 21 24 0 -
+R i 2016 o - Mar 20 24 1 -
+R i 2016 o - S 20 24 0 -
+R i 2017 2019 - Mar 21 24 1 -
+R i 2017 2019 - S 21 24 0 -
+R i 2020 o - Mar 20 24 1 -
+R i 2020 o - S 20 24 0 -
+R i 2021 2023 - Mar 21 24 1 -
+R i 2021 2023 - S 21 24 0 -
+R i 2024 o - Mar 20 24 1 -
+R i 2024 o - S 20 24 0 -
+R i 2025 2027 - Mar 21 24 1 -
+R i 2025 2027 - S 21 24 0 -
+R i 2028 2029 - Mar 20 24 1 -
+R i 2028 2029 - S 20 24 0 -
+R i 2030 2031 - Mar 21 24 1 -
+R i 2030 2031 - S 21 24 0 -
+R i 2032 2033 - Mar 20 24 1 -
+R i 2032 2033 - S 20 24 0 -
+R i 2034 2035 - Mar 21 24 1 -
+R i 2034 2035 - S 21 24 0 -
+R i 2036 2037 - Mar 20 24 1 -
+R i 2036 2037 - S 20 24 0 -
+R i 2038 2039 - Mar 21 24 1 -
+R i 2038 2039 - S 21 24 0 -
+R i 2040 2041 - Mar 20 24 1 -
+R i 2040 2041 - S 20 24 0 -
+R i 2042 2043 - Mar 21 24 1 -
+R i 2042 2043 - S 21 24 0 -
+R i 2044 2045 - Mar 20 24 1 -
+R i 2044 2045 - S 20 24 0 -
+R i 2046 2047 - Mar 21 24 1 -
+R i 2046 2047 - S 21 24 0 -
+R i 2048 2049 - Mar 20 24 1 -
+R i 2048 2049 - S 20 24 0 -
+R i 2050 2051 - Mar 21 24 1 -
+R i 2050 2051 - S 21 24 0 -
+R i 2052 2053 - Mar 20 24 1 -
+R i 2052 2053 - S 20 24 0 -
+R i 2054 2055 - Mar 21 24 1 -
+R i 2054 2055 - S 21 24 0 -
+R i 2056 2057 - Mar 20 24 1 -
+R i 2056 2057 - S 20 24 0 -
+R i 2058 2059 - Mar 21 24 1 -
+R i 2058 2059 - S 21 24 0 -
+R i 2060 2062 - Mar 20 24 1 -
+R i 2060 2062 - S 20 24 0 -
+R i 2063 o - Mar 21 24 1 -
+R i 2063 o - S 21 24 0 -
+R i 2064 2066 - Mar 20 24 1 -
+R i 2064 2066 - S 20 24 0 -
+R i 2067 o - Mar 21 24 1 -
+R i 2067 o - S 21 24 0 -
+R i 2068 2070 - Mar 20 24 1 -
+R i 2068 2070 - S 20 24 0 -
+R i 2071 o - Mar 21 24 1 -
+R i 2071 o - S 21 24 0 -
+R i 2072 2074 - Mar 20 24 1 -
+R i 2072 2074 - S 20 24 0 -
+R i 2075 o - Mar 21 24 1 -
+R i 2075 o - S 21 24 0 -
+R i 2076 2078 - Mar 20 24 1 -
+R i 2076 2078 - S 20 24 0 -
+R i 2079 o - Mar 21 24 1 -
+R i 2079 o - S 21 24 0 -
+R i 2080 2082 - Mar 20 24 1 -
+R i 2080 2082 - S 20 24 0 -
+R i 2083 o - Mar 21 24 1 -
+R i 2083 o - S 21 24 0 -
+R i 2084 2086 - Mar 20 24 1 -
+R i 2084 2086 - S 20 24 0 -
+R i 2087 o - Mar 21 24 1 -
+R i 2087 o - S 21 24 0 -
+R i 2088 ma - Mar 20 24 1 -
+R i 2088 ma - S 20 24 0 -
+Z Asia/Tehran 3:25:44 - LMT 1916
+3:25:44 - TMT 1946
+3:30 - +0330 1977 N
+4 i +04/+05 1979
+3:30 i +0330/+0430
+R IQ 1982 o - May 1 0 1 -
+R IQ 1982 1984 - O 1 0 0 -
+R IQ 1983 o - Mar 31 0 1 -
+R IQ 1984 1985 - Ap 1 0 1 -
+R IQ 1985 1990 - S lastSu 1s 0 -
+R IQ 1986 1990 - Mar lastSu 1s 1 -
+R IQ 1991 2007 - Ap 1 3s 1 -
+R IQ 1991 2007 - O 1 3s 0 -
+Z Asia/Baghdad 2:57:40 - LMT 1890
+2:57:36 - BMT 1918
+3 - +03 1982 May
+3 IQ +03/+04
+R Z 1940 o - May 31 24u 1 D
+R Z 1940 o - S 30 24u 0 S
+R Z 1940 o - N 16 24u 1 D
+R Z 1942 1946 - O 31 24u 0 S
+R Z 1943 1944 - Mar 31 24u 1 D
+R Z 1945 1946 - Ap 15 24u 1 D
+R Z 1948 o - May 22 24u 2 DD
+R Z 1948 o - Au 31 24u 1 D
+R Z 1948 1949 - O 31 24u 0 S
+R Z 1949 o - Ap 30 24u 1 D
+R Z 1950 o - Ap 15 24u 1 D
+R Z 1950 o - S 14 24u 0 S
+R Z 1951 o - Mar 31 24u 1 D
+R Z 1951 o - N 10 24u 0 S
+R Z 1952 o - Ap 19 24u 1 D
+R Z 1952 o - O 18 24u 0 S
+R Z 1953 o - Ap 11 24u 1 D
+R Z 1953 o - S 12 24u 0 S
+R Z 1954 o - Jun 12 24u 1 D
+R Z 1954 o - S 11 24u 0 S
+R Z 1955 o - Jun 11 24u 1 D
+R Z 1955 o - S 10 24u 0 S
+R Z 1956 o - Jun 2 24u 1 D
+R Z 1956 o - S 29 24u 0 S
+R Z 1957 o - Ap 27 24u 1 D
+R Z 1957 o - S 21 24u 0 S
+R Z 1974 o - Jul 6 24 1 D
+R Z 1974 o - O 12 24 0 S
+R Z 1975 o - Ap 19 24 1 D
+R Z 1975 o - Au 30 24 0 S
+R Z 1980 o - Au 2 24s 1 D
+R Z 1980 o - S 13 24s 0 S
+R Z 1984 o - May 5 24s 1 D
+R Z 1984 o - Au 25 24s 0 S
+R Z 1985 o - Ap 13 24 1 D
+R Z 1985 o - Au 31 24 0 S
+R Z 1986 o - May 17 24 1 D
+R Z 1986 o - S 6 24 0 S
+R Z 1987 o - Ap 14 24 1 D
+R Z 1987 o - S 12 24 0 S
+R Z 1988 o - Ap 9 24 1 D
+R Z 1988 o - S 3 24 0 S
+R Z 1989 o - Ap 29 24 1 D
+R Z 1989 o - S 2 24 0 S
+R Z 1990 o - Mar 24 24 1 D
+R Z 1990 o - Au 25 24 0 S
+R Z 1991 o - Mar 23 24 1 D
+R Z 1991 o - Au 31 24 0 S
+R Z 1992 o - Mar 28 24 1 D
+R Z 1992 o - S 5 24 0 S
+R Z 1993 o - Ap 2 0 1 D
+R Z 1993 o - S 5 0 0 S
+R Z 1994 o - Ap 1 0 1 D
+R Z 1994 o - Au 28 0 0 S
+R Z 1995 o - Mar 31 0 1 D
+R Z 1995 o - S 3 0 0 S
+R Z 1996 o - Mar 14 24 1 D
+R Z 1996 o - S 15 24 0 S
+R Z 1997 o - Mar 20 24 1 D
+R Z 1997 o - S 13 24 0 S
+R Z 1998 o - Mar 20 0 1 D
+R Z 1998 o - S 6 0 0 S
+R Z 1999 o - Ap 2 2 1 D
+R Z 1999 o - S 3 2 0 S
+R Z 2000 o - Ap 14 2 1 D
+R Z 2000 o - O 6 1 0 S
+R Z 2001 o - Ap 9 1 1 D
+R Z 2001 o - S 24 1 0 S
+R Z 2002 o - Mar 29 1 1 D
+R Z 2002 o - O 7 1 0 S
+R Z 2003 o - Mar 28 1 1 D
+R Z 2003 o - O 3 1 0 S
+R Z 2004 o - Ap 7 1 1 D
+R Z 2004 o - S 22 1 0 S
+R Z 2005 2012 - Ap F<=1 2 1 D
+R Z 2005 o - O 9 2 0 S
+R Z 2006 o - O 1 2 0 S
+R Z 2007 o - S 16 2 0 S
+R Z 2008 o - O 5 2 0 S
+R Z 2009 o - S 27 2 0 S
+R Z 2010 o - S 12 2 0 S
+R Z 2011 o - O 2 2 0 S
+R Z 2012 o - S 23 2 0 S
+R Z 2013 ma - Mar F>=23 2 1 D
+R Z 2013 ma - O lastSu 2 0 S
+Z Asia/Jerusalem 2:20:54 - LMT 1880
+2:20:40 - JMT 1918
+2 Z I%sT
+R JP 1948 o - May Sa>=1 24 1 D
+R JP 1948 1951 - S Sa>=8 25 0 S
+R JP 1949 o - Ap Sa>=1 24 1 D
+R JP 1950 1951 - May Sa>=1 24 1 D
+Z Asia/Tokyo 9:18:59 - LMT 1887 D 31 15u
+9 JP J%sT
+R J 1973 o - Jun 6 0 1 S
+R J 1973 1975 - O 1 0 0 -
+R J 1974 1977 - May 1 0 1 S
+R J 1976 o - N 1 0 0 -
+R J 1977 o - O 1 0 0 -
+R J 1978 o - Ap 30 0 1 S
+R J 1978 o - S 30 0 0 -
+R J 1985 o - Ap 1 0 1 S
+R J 1985 o - O 1 0 0 -
+R J 1986 1988 - Ap F>=1 0 1 S
+R J 1986 1990 - O F>=1 0 0 -
+R J 1989 o - May 8 0 1 S
+R J 1990 o - Ap 27 0 1 S
+R J 1991 o - Ap 17 0 1 S
+R J 1991 o - S 27 0 0 -
+R J 1992 o - Ap 10 0 1 S
+R J 1992 1993 - O F>=1 0 0 -
+R J 1993 1998 - Ap F>=1 0 1 S
+R J 1994 o - S F>=15 0 0 -
+R J 1995 1998 - S F>=15 0s 0 -
+R J 1999 o - Jul 1 0s 1 S
+R J 1999 2002 - S lastF 0s 0 -
+R J 2000 2001 - Mar lastTh 0s 1 S
+R J 2002 2012 - Mar lastTh 24 1 S
+R J 2003 o - O 24 0s 0 -
+R J 2004 o - O 15 0s 0 -
+R J 2005 o - S lastF 0s 0 -
+R J 2006 2011 - O lastF 0s 0 -
+R J 2013 o - D 20 0 0 -
+R J 2014 ma - Mar lastTh 24 1 S
+R J 2014 ma - O lastF 0s 0 -
+Z Asia/Amman 2:23:44 - LMT 1931
+2 J EE%sT
+Z Asia/Almaty 5:7:48 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2004 O 31 2s
+6 - +06
+Z Asia/Qyzylorda 4:21:52 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1991 S 29 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 1992 Mar 29 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06 2018 D 21
+5 - +05
+Z Asia/Qostanay 4:14:28 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+6 - +06
+Z Asia/Aqtobe 3:48:40 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2004 O 31 2s
+5 - +05
+Z Asia/Aqtau 3:21:4 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1994 S 25 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Atyrau 3:27:44 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1999 Mar 28 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+Z Asia/Oral 3:25:24 - LMT 1924 May 2
+3 - +03 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1989 Mar 26 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 1992 Mar 29 2s
+4 R +04/+05 2004 O 31 2s
+5 - +05
+R KG 1992 1996 - Ap Su>=7 0s 1 -
+R KG 1992 1996 - S lastSu 0 0 -
+R KG 1997 2005 - Mar lastSu 2:30 1 -
+R KG 1997 2004 - O lastSu 2:30 0 -
+Z Asia/Bishkek 4:58:24 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1991 Au 31 2
+5 KG +05/+06 2005 Au 12
+6 - +06
+R KR 1948 o - Jun 1 0 1 D
+R KR 1948 o - S 12 24 0 S
+R KR 1949 o - Ap 3 0 1 D
+R KR 1949 1951 - S Sa>=7 24 0 S
+R KR 1950 o - Ap 1 0 1 D
+R KR 1951 o - May 6 0 1 D
+R KR 1955 o - May 5 0 1 D
+R KR 1955 o - S 8 24 0 S
+R KR 1956 o - May 20 0 1 D
+R KR 1956 o - S 29 24 0 S
+R KR 1957 1960 - May Su>=1 0 1 D
+R KR 1957 1960 - S Sa>=17 24 0 S
+R KR 1987 1988 - May Su>=8 2 1 D
+R KR 1987 1988 - O Su>=8 3 0 S
+Z Asia/Seoul 8:27:52 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 S 8
+9 KR K%sT 1954 Mar 21
+8:30 KR K%sT 1961 Au 10
+9 KR K%sT
+Z Asia/Pyongyang 8:23 - LMT 1908 Ap
+8:30 - KST 1912
+9 - JST 1945 Au 24
+9 - KST 2015 Au 15
+8:30 - KST 2018 May 4 23:30
+9 - KST
+R l 1920 o - Mar 28 0 1 S
+R l 1920 o - O 25 0 0 -
+R l 1921 o - Ap 3 0 1 S
+R l 1921 o - O 3 0 0 -
+R l 1922 o - Mar 26 0 1 S
+R l 1922 o - O 8 0 0 -
+R l 1923 o - Ap 22 0 1 S
+R l 1923 o - S 16 0 0 -
+R l 1957 1961 - May 1 0 1 S
+R l 1957 1961 - O 1 0 0 -
+R l 1972 o - Jun 22 0 1 S
+R l 1972 1977 - O 1 0 0 -
+R l 1973 1977 - May 1 0 1 S
+R l 1978 o - Ap 30 0 1 S
+R l 1978 o - S 30 0 0 -
+R l 1984 1987 - May 1 0 1 S
+R l 1984 1991 - O 16 0 0 -
+R l 1988 o - Jun 1 0 1 S
+R l 1989 o - May 10 0 1 S
+R l 1990 1992 - May 1 0 1 S
+R l 1992 o - O 4 0 0 -
+R l 1993 ma - Mar lastSu 0 1 S
+R l 1993 1998 - S lastSu 0 0 -
+R l 1999 ma - O lastSu 0 0 -
+Z Asia/Beirut 2:22 - LMT 1880
+2 l EE%sT
+R NB 1935 1941 - S 14 0 0:20 -
+R NB 1935 1941 - D 14 0 0 -
+Z Asia/Kuala_Lumpur 6:46:46 - LMT 1901
+6:55:25 - SMT 1905 Jun
+7 - +07 1933
+7 0:20 +0720 1936
+7:20 - +0720 1941 S
+7:30 - +0730 1942 F 16
+9 - +09 1945 S 12
+7:30 - +0730 1982
+8 - +08
+Z Asia/Kuching 7:21:20 - LMT 1926 Mar
+7:30 - +0730 1933
+8 NB +08/+0820 1942 F 16
+9 - +09 1945 S 12
+8 - +08
+Z Indian/Maldives 4:54 - LMT 1880
+4:54 - MMT 1960
+5 - +05
+R X 1983 1984 - Ap 1 0 1 -
+R X 1983 o - O 1 0 0 -
+R X 1985 1998 - Mar lastSu 0 1 -
+R X 1984 1998 - S lastSu 0 0 -
+R X 2001 o - Ap lastSa 2 1 -
+R X 2001 2006 - S lastSa 2 0 -
+R X 2002 2006 - Mar lastSa 2 1 -
+R X 2015 2016 - Mar lastSa 2 1 -
+R X 2015 2016 - S lastSa 0 0 -
+Z Asia/Hovd 6:6:36 - LMT 1905 Au
+6 - +06 1978
+7 X +07/+08
+Z Asia/Ulaanbaatar 7:7:32 - LMT 1905 Au
+7 - +07 1978
+8 X +08/+09
+Z Asia/Choibalsan 7:38 - LMT 1905 Au
+7 - +07 1978
+8 - +08 1983 Ap
+9 X +09/+10 2008 Mar 31
+8 X +08/+09
+Z Asia/Kathmandu 5:41:16 - LMT 1920
+5:30 - +0530 1986
+5:45 - +0545
+R PK 2002 o - Ap Su>=2 0 1 S
+R PK 2002 o - O Su>=2 0 0 -
+R PK 2008 o - Jun 1 0 1 S
+R PK 2008 2009 - N 1 0 0 -
+R PK 2009 o - Ap 15 0 1 S
+Z Asia/Karachi 4:28:12 - LMT 1907
+5:30 - +0530 1942 S
+5:30 1 +0630 1945 O 15
+5:30 - +0530 1951 S 30
+5 - +05 1971 Mar 26
+5 PK PK%sT
+R P 1999 2005 - Ap F>=15 0 1 S
+R P 1999 2003 - O F>=15 0 0 -
+R P 2004 o - O 1 1 0 -
+R P 2005 o - O 4 2 0 -
+R P 2006 2007 - Ap 1 0 1 S
+R P 2006 o - S 22 0 0 -
+R P 2007 o - S 13 2 0 -
+R P 2008 2009 - Mar lastF 0 1 S
+R P 2008 o - S 1 0 0 -
+R P 2009 o - S 4 1 0 -
+R P 2010 o - Mar 26 0 1 S
+R P 2010 o - Au 11 0 0 -
+R P 2011 o - Ap 1 0:1 1 S
+R P 2011 o - Au 1 0 0 -
+R P 2011 o - Au 30 0 1 S
+R P 2011 o - S 30 0 0 -
+R P 2012 2014 - Mar lastTh 24 1 S
+R P 2012 o - S 21 1 0 -
+R P 2013 o - S 27 0 0 -
+R P 2014 o - O 24 0 0 -
+R P 2015 o - Mar 28 0 1 S
+R P 2015 o - O 23 1 0 -
+R P 2016 2018 - Mar Sa>=24 1 1 S
+R P 2016 2018 - O Sa>=24 1 0 -
+R P 2019 o - Mar 29 0 1 S
+R P 2019 o - O Sa>=24 0 0 -
+R P 2020 ma - Mar Sa>=24 0 1 S
+R P 2020 ma - O Sa>=24 1 0 -
+Z Asia/Gaza 2:17:52 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT 2008 Au 29
+2 - EET 2008 S
+2 P EE%sT 2010
+2 - EET 2010 Mar 27 0:1
+2 P EE%sT 2011 Au
+2 - EET 2012
+2 P EE%sT
+Z Asia/Hebron 2:20:23 - LMT 1900 O
+2 Z EET/EEST 1948 May 15
+2 K EE%sT 1967 Jun 5
+2 Z I%sT 1996
+2 J EE%sT 1999
+2 P EE%sT
+R PH 1936 o - N 1 0 1 D
+R PH 1937 o - F 1 0 0 S
+R PH 1954 o - Ap 12 0 1 D
+R PH 1954 o - Jul 1 0 0 S
+R PH 1978 o - Mar 22 0 1 D
+R PH 1978 o - S 21 0 0 S
+Z Asia/Manila -15:56 - LMT 1844 D 31
+8:4 - LMT 1899 May 11
+8 PH P%sT 1942 May
+9 - JST 1944 N
+8 PH P%sT
+Z Asia/Qatar 3:26:8 - LMT 1920
+4 - +04 1972 Jun
+3 - +03
+L Asia/Qatar Asia/Bahrain
+Z Asia/Riyadh 3:6:52 - LMT 1947 Mar 14
+3 - +03
+L Asia/Riyadh Asia/Aden
+L Asia/Riyadh Asia/Kuwait
+Z Asia/Singapore 6:55:25 - LMT 1901
+6:55:25 - SMT 1905 Jun
+7 - +07 1933
+7 0:20 +0720 1936
+7:20 - +0720 1941 S
+7:30 - +0730 1942 F 16
+9 - +09 1945 S 12
+7:30 - +0730 1982
+8 - +08
+Z Asia/Colombo 5:19:24 - LMT 1880
+5:19:32 - MMT 1906
+5:30 - +0530 1942 Ja 5
+5:30 0:30 +06 1942 S
+5:30 1 +0630 1945 O 16 2
+5:30 - +0530 1996 May 25
+6:30 - +0630 1996 O 26 0:30
+6 - +06 2006 Ap 15 0:30
+5:30 - +0530
+R S 1920 1923 - Ap Su>=15 2 1 S
+R S 1920 1923 - O Su>=1 2 0 -
+R S 1962 o - Ap 29 2 1 S
+R S 1962 o - O 1 2 0 -
+R S 1963 1965 - May 1 2 1 S
+R S 1963 o - S 30 2 0 -
+R S 1964 o - O 1 2 0 -
+R S 1965 o - S 30 2 0 -
+R S 1966 o - Ap 24 2 1 S
+R S 1966 1976 - O 1 2 0 -
+R S 1967 1978 - May 1 2 1 S
+R S 1977 1978 - S 1 2 0 -
+R S 1983 1984 - Ap 9 2 1 S
+R S 1983 1984 - O 1 2 0 -
+R S 1986 o - F 16 2 1 S
+R S 1986 o - O 9 2 0 -
+R S 1987 o - Mar 1 2 1 S
+R S 1987 1988 - O 31 2 0 -
+R S 1988 o - Mar 15 2 1 S
+R S 1989 o - Mar 31 2 1 S
+R S 1989 o - O 1 2 0 -
+R S 1990 o - Ap 1 2 1 S
+R S 1990 o - S 30 2 0 -
+R S 1991 o - Ap 1 0 1 S
+R S 1991 1992 - O 1 0 0 -
+R S 1992 o - Ap 8 0 1 S
+R S 1993 o - Mar 26 0 1 S
+R S 1993 o - S 25 0 0 -
+R S 1994 1996 - Ap 1 0 1 S
+R S 1994 2005 - O 1 0 0 -
+R S 1997 1998 - Mar lastM 0 1 S
+R S 1999 2006 - Ap 1 0 1 S
+R S 2006 o - S 22 0 0 -
+R S 2007 o - Mar lastF 0 1 S
+R S 2007 o - N F>=1 0 0 -
+R S 2008 o - Ap F>=1 0 1 S
+R S 2008 o - N 1 0 0 -
+R S 2009 o - Mar lastF 0 1 S
+R S 2010 2011 - Ap F>=1 0 1 S
+R S 2012 ma - Mar lastF 0 1 S
+R S 2009 ma - O lastF 0 0 -
+Z Asia/Damascus 2:25:12 - LMT 1920
+2 S EE%sT
+Z Asia/Dushanbe 4:35:12 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 1 +05/+06 1991 S 9 2s
+5 - +05
+Z Asia/Bangkok 6:42:4 - LMT 1880
+6:42:4 - BMT 1920 Ap
+7 - +07
+L Asia/Bangkok Asia/Phnom_Penh
+L Asia/Bangkok Asia/Vientiane
+Z Asia/Ashgabat 3:53:32 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2
+4 R +04/+05 1992 Ja 19 2
+5 - +05
+Z Asia/Dubai 3:41:12 - LMT 1920
+4 - +04
+L Asia/Dubai Asia/Muscat
+Z Asia/Samarkand 4:27:53 - LMT 1924 May 2
+4 - +04 1930 Jun 21
+5 - +05 1981 Ap
+5 1 +06 1981 O
+6 - +06 1982 Ap
+5 R +05/+06 1992
+5 - +05
+Z Asia/Tashkent 4:37:11 - LMT 1924 May 2
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2
+5 R +05/+06 1992
+5 - +05
+Z Asia/Ho_Chi_Minh 7:6:40 - LMT 1906 Jul
+7:6:30 - PLMT 1911 May
+7 - +07 1942 D 31 23
+8 - +08 1945 Mar 14 23
+9 - +09 1945 S 2
+7 - +07 1947 Ap
+8 - +08 1955 Jul
+7 - +07 1959 D 31 23
+8 - +08 1975 Jun 13
+7 - +07
+R AU 1917 o - Ja 1 2s 1 D
+R AU 1917 o - Mar lastSu 2s 0 S
+R AU 1942 o - Ja 1 2s 1 D
+R AU 1942 o - Mar lastSu 2s 0 S
+R AU 1942 o - S 27 2s 1 D
+R AU 1943 1944 - Mar lastSu 2s 0 S
+R AU 1943 o - O 3 2s 1 D
+Z Australia/Darwin 8:43:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT
+R AW 1974 o - O lastSu 2s 1 D
+R AW 1975 o - Mar Su>=1 2s 0 S
+R AW 1983 o - O lastSu 2s 1 D
+R AW 1984 o - Mar Su>=1 2s 0 S
+R AW 1991 o - N 17 2s 1 D
+R AW 1992 o - Mar Su>=1 2s 0 S
+R AW 2006 o - D 3 2s 1 D
+R AW 2007 2009 - Mar lastSu 2s 0 S
+R AW 2007 2008 - O lastSu 2s 1 D
+Z Australia/Perth 7:43:24 - LMT 1895 D
+8 AU AW%sT 1943 Jul
+8 AW AW%sT
+Z Australia/Eucla 8:35:28 - LMT 1895 D
+8:45 AU +0845/+0945 1943 Jul
+8:45 AW +0845/+0945
+R AQ 1971 o - O lastSu 2s 1 D
+R AQ 1972 o - F lastSu 2s 0 S
+R AQ 1989 1991 - O lastSu 2s 1 D
+R AQ 1990 1992 - Mar Su>=1 2s 0 S
+R Ho 1992 1993 - O lastSu 2s 1 D
+R Ho 1993 1994 - Mar Su>=1 2s 0 S
+Z Australia/Brisbane 10:12:8 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT
+Z Australia/Lindeman 9:55:56 - LMT 1895
+10 AU AE%sT 1971
+10 AQ AE%sT 1992 Jul
+10 Ho AE%sT
+R AS 1971 1985 - O lastSu 2s 1 D
+R AS 1986 o - O 19 2s 1 D
+R AS 1987 2007 - O lastSu 2s 1 D
+R AS 1972 o - F 27 2s 0 S
+R AS 1973 1985 - Mar Su>=1 2s 0 S
+R AS 1986 1990 - Mar Su>=15 2s 0 S
+R AS 1991 o - Mar 3 2s 0 S
+R AS 1992 o - Mar 22 2s 0 S
+R AS 1993 o - Mar 7 2s 0 S
+R AS 1994 o - Mar 20 2s 0 S
+R AS 1995 2005 - Mar lastSu 2s 0 S
+R AS 2006 o - Ap 2 2s 0 S
+R AS 2007 o - Mar lastSu 2s 0 S
+R AS 2008 ma - Ap Su>=1 2s 0 S
+R AS 2008 ma - O Su>=1 2s 1 D
+Z Australia/Adelaide 9:14:20 - LMT 1895 F
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AS AC%sT
+R AT 1916 o - O Su>=1 2s 1 D
+R AT 1917 o - Mar lastSu 2s 0 S
+R AT 1917 1918 - O Su>=22 2s 1 D
+R AT 1918 1919 - Mar Su>=1 2s 0 S
+R AT 1967 o - O Su>=1 2s 1 D
+R AT 1968 o - Mar Su>=29 2s 0 S
+R AT 1968 1985 - O lastSu 2s 1 D
+R AT 1969 1971 - Mar Su>=8 2s 0 S
+R AT 1972 o - F lastSu 2s 0 S
+R AT 1973 1981 - Mar Su>=1 2s 0 S
+R AT 1982 1983 - Mar lastSu 2s 0 S
+R AT 1984 1986 - Mar Su>=1 2s 0 S
+R AT 1986 o - O Su>=15 2s 1 D
+R AT 1987 1990 - Mar Su>=15 2s 0 S
+R AT 1987 o - O Su>=22 2s 1 D
+R AT 1988 1990 - O lastSu 2s 1 D
+R AT 1991 1999 - O Su>=1 2s 1 D
+R AT 1991 2005 - Mar lastSu 2s 0 S
+R AT 2000 o - Au lastSu 2s 1 D
+R AT 2001 ma - O Su>=1 2s 1 D
+R AT 2006 o - Ap Su>=1 2s 0 S
+R AT 2007 o - Mar lastSu 2s 0 S
+R AT 2008 ma - Ap Su>=1 2s 0 S
+Z Australia/Hobart 9:49:16 - LMT 1895 S
+10 AT AE%sT 1919 O 24
+10 AU AE%sT 1967
+10 AT AE%sT
+R AV 1971 1985 - O lastSu 2s 1 D
+R AV 1972 o - F lastSu 2s 0 S
+R AV 1973 1985 - Mar Su>=1 2s 0 S
+R AV 1986 1990 - Mar Su>=15 2s 0 S
+R AV 1986 1987 - O Su>=15 2s 1 D
+R AV 1988 1999 - O lastSu 2s 1 D
+R AV 1991 1994 - Mar Su>=1 2s 0 S
+R AV 1995 2005 - Mar lastSu 2s 0 S
+R AV 2000 o - Au lastSu 2s 1 D
+R AV 2001 2007 - O lastSu 2s 1 D
+R AV 2006 o - Ap Su>=1 2s 0 S
+R AV 2007 o - Mar lastSu 2s 0 S
+R AV 2008 ma - Ap Su>=1 2s 0 S
+R AV 2008 ma - O Su>=1 2s 1 D
+Z Australia/Melbourne 9:39:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AV AE%sT
+R AN 1971 1985 - O lastSu 2s 1 D
+R AN 1972 o - F 27 2s 0 S
+R AN 1973 1981 - Mar Su>=1 2s 0 S
+R AN 1982 o - Ap Su>=1 2s 0 S
+R AN 1983 1985 - Mar Su>=1 2s 0 S
+R AN 1986 1989 - Mar Su>=15 2s 0 S
+R AN 1986 o - O 19 2s 1 D
+R AN 1987 1999 - O lastSu 2s 1 D
+R AN 1990 1995 - Mar Su>=1 2s 0 S
+R AN 1996 2005 - Mar lastSu 2s 0 S
+R AN 2000 o - Au lastSu 2s 1 D
+R AN 2001 2007 - O lastSu 2s 1 D
+R AN 2006 o - Ap Su>=1 2s 0 S
+R AN 2007 o - Mar lastSu 2s 0 S
+R AN 2008 ma - Ap Su>=1 2s 0 S
+R AN 2008 ma - O Su>=1 2s 1 D
+Z Australia/Sydney 10:4:52 - LMT 1895 F
+10 AU AE%sT 1971
+10 AN AE%sT
+Z Australia/Broken_Hill 9:25:48 - LMT 1895 F
+10 - AEST 1896 Au 23
+9 - ACST 1899 May
+9:30 AU AC%sT 1971
+9:30 AN AC%sT 2000
+9:30 AS AC%sT
+R LH 1981 1984 - O lastSu 2 1 -
+R LH 1982 1985 - Mar Su>=1 2 0 -
+R LH 1985 o - O lastSu 2 0:30 -
+R LH 1986 1989 - Mar Su>=15 2 0 -
+R LH 1986 o - O 19 2 0:30 -
+R LH 1987 1999 - O lastSu 2 0:30 -
+R LH 1990 1995 - Mar Su>=1 2 0 -
+R LH 1996 2005 - Mar lastSu 2 0 -
+R LH 2000 o - Au lastSu 2 0:30 -
+R LH 2001 2007 - O lastSu 2 0:30 -
+R LH 2006 o - Ap Su>=1 2 0 -
+R LH 2007 o - Mar lastSu 2 0 -
+R LH 2008 ma - Ap Su>=1 2 0 -
+R LH 2008 ma - O Su>=1 2 0:30 -
+Z Australia/Lord_Howe 10:36:20 - LMT 1895 F
+10 - AEST 1981 Mar
+10:30 LH +1030/+1130 1985 Jul
+10:30 LH +1030/+11
+Z Antarctica/Macquarie 0 - -00 1899 N
+10 - AEST 1916 O 1 2
+10 1 AEDT 1917 F
+10 AU AE%sT 1919 Ap 1 0s
+0 - -00 1948 Mar 25
+10 AU AE%sT 1967
+10 AT AE%sT 2010
+10 1 AEDT 2011
+10 AT AE%sT
+Z Indian/Christmas 7:2:52 - LMT 1895 F
+7 - +07
+Z Indian/Cocos 6:27:40 - LMT 1900
+6:30 - +0630
+R FJ 1998 1999 - N Su>=1 2 1 -
+R FJ 1999 2000 - F lastSu 3 0 -
+R FJ 2009 o - N 29 2 1 -
+R FJ 2010 o - Mar lastSu 3 0 -
+R FJ 2010 2013 - O Su>=21 2 1 -
+R FJ 2011 o - Mar Su>=1 3 0 -
+R FJ 2012 2013 - Ja Su>=18 3 0 -
+R FJ 2014 o - Ja Su>=18 2 0 -
+R FJ 2014 2018 - N Su>=1 2 1 -
+R FJ 2015 ma - Ja Su>=12 3 0 -
+R FJ 2019 o - N Su>=8 2 1 -
+R FJ 2020 o - D 20 2 1 -
+R FJ 2021 ma - N Su>=8 2 1 -
+Z Pacific/Fiji 11:55:44 - LMT 1915 O 26
+12 FJ +12/+13
+Z Pacific/Gambier -8:59:48 - LMT 1912 O
+-9 - -09
+Z Pacific/Marquesas -9:18 - LMT 1912 O
+-9:30 - -0930
+Z Pacific/Tahiti -9:58:16 - LMT 1912 O
+-10 - -10
+R Gu 1959 o - Jun 27 2 1 D
+R Gu 1961 o - Ja 29 2 0 S
+R Gu 1967 o - S 1 2 1 D
+R Gu 1969 o - Ja 26 0:1 0 S
+R Gu 1969 o - Jun 22 2 1 D
+R Gu 1969 o - Au 31 2 0 S
+R Gu 1970 1971 - Ap lastSu 2 1 D
+R Gu 1970 1971 - S Su>=1 2 0 S
+R Gu 1973 o - D 16 2 1 D
+R Gu 1974 o - F 24 2 0 S
+R Gu 1976 o - May 26 2 1 D
+R Gu 1976 o - Au 22 2:1 0 S
+R Gu 1977 o - Ap 24 2 1 D
+R Gu 1977 o - Au 28 2 0 S
+Z Pacific/Guam -14:21 - LMT 1844 D 31
+9:39 - LMT 1901
+10 - GST 1941 D 10
+9 - +09 1944 Jul 31
+10 Gu G%sT 2000 D 23
+10 - ChST
+L Pacific/Guam Pacific/Saipan
+Z Pacific/Tarawa 11:32:4 - LMT 1901
+12 - +12
+Z Pacific/Enderbury -11:24:20 - LMT 1901
+-12 - -12 1979 O
+-11 - -11 1994 D 31
+13 - +13
+Z Pacific/Kiritimati -10:29:20 - LMT 1901
+-10:40 - -1040 1979 O
+-10 - -10 1994 D 31
+14 - +14
+Z Pacific/Majuro 11:24:48 - LMT 1901
+11 - +11 1914 O
+9 - +09 1919 F
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1944 Ja 30
+11 - +11 1969 O
+12 - +12
+Z Pacific/Kwajalein 11:9:20 - LMT 1901
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1944 F 6
+11 - +11 1969 O
+-12 - -12 1993 Au 20 24
+12 - +12
+Z Pacific/Chuuk -13:52:52 - LMT 1844 D 31
+10:7:8 - LMT 1901
+10 - +10 1914 O
+9 - +09 1919 F
+10 - +10 1941 Ap
+9 - +09 1945 Au
+10 - +10
+Z Pacific/Pohnpei -13:27:8 - LMT 1844 D 31
+10:32:52 - LMT 1901
+11 - +11 1914 O
+9 - +09 1919 F
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1945 Au
+11 - +11
+Z Pacific/Kosrae -13:8:4 - LMT 1844 D 31
+10:51:56 - LMT 1901
+11 - +11 1914 O
+9 - +09 1919 F
+11 - +11 1937
+10 - +10 1941 Ap
+9 - +09 1945 Au
+11 - +11 1969 O
+12 - +12 1999
+11 - +11
+Z Pacific/Nauru 11:7:40 - LMT 1921 Ja 15
+11:30 - +1130 1942 Au 29
+9 - +09 1945 S 8
+11:30 - +1130 1979 F 10 2
+12 - +12
+R NC 1977 1978 - D Su>=1 0 1 -
+R NC 1978 1979 - F 27 0 0 -
+R NC 1996 o - D 1 2s 1 -
+R NC 1997 o - Mar 2 2s 0 -
+Z Pacific/Noumea 11:5:48 - LMT 1912 Ja 13
+11 NC +11/+12
+R NZ 1927 o - N 6 2 1 S
+R NZ 1928 o - Mar 4 2 0 M
+R NZ 1928 1933 - O Su>=8 2 0:30 S
+R NZ 1929 1933 - Mar Su>=15 2 0 M
+R NZ 1934 1940 - Ap lastSu 2 0 M
+R NZ 1934 1940 - S lastSu 2 0:30 S
+R NZ 1946 o - Ja 1 0 0 S
+R NZ 1974 o - N Su>=1 2s 1 D
+R k 1974 o - N Su>=1 2:45s 1 -
+R NZ 1975 o - F lastSu 2s 0 S
+R k 1975 o - F lastSu 2:45s 0 -
+R NZ 1975 1988 - O lastSu 2s 1 D
+R k 1975 1988 - O lastSu 2:45s 1 -
+R NZ 1976 1989 - Mar Su>=1 2s 0 S
+R k 1976 1989 - Mar Su>=1 2:45s 0 -
+R NZ 1989 o - O Su>=8 2s 1 D
+R k 1989 o - O Su>=8 2:45s 1 -
+R NZ 1990 2006 - O Su>=1 2s 1 D
+R k 1990 2006 - O Su>=1 2:45s 1 -
+R NZ 1990 2007 - Mar Su>=15 2s 0 S
+R k 1990 2007 - Mar Su>=15 2:45s 0 -
+R NZ 2007 ma - S lastSu 2s 1 D
+R k 2007 ma - S lastSu 2:45s 1 -
+R NZ 2008 ma - Ap Su>=1 2s 0 S
+R k 2008 ma - Ap Su>=1 2:45s 0 -
+Z Pacific/Auckland 11:39:4 - LMT 1868 N 2
+11:30 NZ NZ%sT 1946
+12 NZ NZ%sT
+Z Pacific/Chatham 12:13:48 - LMT 1868 N 2
+12:15 - +1215 1946
+12:45 k +1245/+1345
+L Pacific/Auckland Antarctica/McMurdo
+R CK 1978 o - N 12 0 0:30 -
+R CK 1979 1991 - Mar Su>=1 0 0 -
+R CK 1979 1990 - O lastSu 0 0:30 -
+Z Pacific/Rarotonga -10:39:4 - LMT 1901
+-10:30 - -1030 1978 N 12
+-10 CK -10/-0930
+Z Pacific/Niue -11:19:40 - LMT 1901
+-11:20 - -1120 1951
+-11:30 - -1130 1978 O
+-11 - -11
+Z Pacific/Norfolk 11:11:52 - LMT 1901
+11:12 - +1112 1951
+11:30 - +1130 1974 O 27 2s
+11:30 1 +1230 1975 Mar 2 2s
+11:30 - +1130 2015 O 4 2s
+11 - +11 2019 Jul
+11 AN +11/+12
+Z Pacific/Palau -15:2:4 - LMT 1844 D 31
+8:57:56 - LMT 1901
+9 - +09
+Z Pacific/Port_Moresby 9:48:40 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10
+Z Pacific/Bougainville 10:22:16 - LMT 1880
+9:48:32 - PMMT 1895
+10 - +10 1942 Jul
+9 - +09 1945 Au 21
+10 - +10 2014 D 28 2
+11 - +11
+Z Pacific/Pitcairn -8:40:20 - LMT 1901
+-8:30 - -0830 1998 Ap 27
+-8 - -08
+Z Pacific/Pago_Pago 12:37:12 - LMT 1892 Jul 5
+-11:22:48 - LMT 1911
+-11 - SST
+L Pacific/Pago_Pago Pacific/Midway
+R WS 2010 o - S lastSu 0 1 -
+R WS 2011 o - Ap Sa>=1 4 0 -
+R WS 2011 o - S lastSa 3 1 -
+R WS 2012 ma - Ap Su>=1 4 0 -
+R WS 2012 ma - S lastSu 3 1 -
+Z Pacific/Apia 12:33:4 - LMT 1892 Jul 5
+-11:26:56 - LMT 1911
+-11:30 - -1130 1950
+-11 WS -11/-10 2011 D 29 24
+13 WS +13/+14
+Z Pacific/Guadalcanal 10:39:48 - LMT 1912 O
+11 - +11
+Z Pacific/Fakaofo -11:24:56 - LMT 1901
+-11 - -11 2011 D 30
+13 - +13
+R TO 1999 o - O 7 2s 1 -
+R TO 2000 o - Mar 19 2s 0 -
+R TO 2000 2001 - N Su>=1 2 1 -
+R TO 2001 2002 - Ja lastSu 2 0 -
+R TO 2016 o - N Su>=1 2 1 -
+R TO 2017 o - Ja Su>=15 3 0 -
+Z Pacific/Tongatapu 12:19:20 - LMT 1901
+12:20 - +1220 1941
+13 - +13 1999
+13 TO +13/+14
+Z Pacific/Funafuti 11:56:52 - LMT 1901
+12 - +12
+Z Pacific/Wake 11:6:28 - LMT 1901
+12 - +12
+R VU 1973 o - D 22 12u 1 -
+R VU 1974 o - Mar 30 12u 0 -
+R VU 1983 1991 - S Sa>=22 24 1 -
+R VU 1984 1991 - Mar Sa>=22 24 0 -
+R VU 1992 1993 - Ja Sa>=22 24 0 -
+R VU 1992 o - O Sa>=22 24 1 -
+Z Pacific/Efate 11:13:16 - LMT 1912 Ja 13
+11 VU +11/+12
+Z Pacific/Wallis 12:15:20 - LMT 1901
+12 - +12
+R G 1916 o - May 21 2s 1 BST
+R G 1916 o - O 1 2s 0 GMT
+R G 1917 o - Ap 8 2s 1 BST
+R G 1917 o - S 17 2s 0 GMT
+R G 1918 o - Mar 24 2s 1 BST
+R G 1918 o - S 30 2s 0 GMT
+R G 1919 o - Mar 30 2s 1 BST
+R G 1919 o - S 29 2s 0 GMT
+R G 1920 o - Mar 28 2s 1 BST
+R G 1920 o - O 25 2s 0 GMT
+R G 1921 o - Ap 3 2s 1 BST
+R G 1921 o - O 3 2s 0 GMT
+R G 1922 o - Mar 26 2s 1 BST
+R G 1922 o - O 8 2s 0 GMT
+R G 1923 o - Ap Su>=16 2s 1 BST
+R G 1923 1924 - S Su>=16 2s 0 GMT
+R G 1924 o - Ap Su>=9 2s 1 BST
+R G 1925 1926 - Ap Su>=16 2s 1 BST
+R G 1925 1938 - O Su>=2 2s 0 GMT
+R G 1927 o - Ap Su>=9 2s 1 BST
+R G 1928 1929 - Ap Su>=16 2s 1 BST
+R G 1930 o - Ap Su>=9 2s 1 BST
+R G 1931 1932 - Ap Su>=16 2s 1 BST
+R G 1933 o - Ap Su>=9 2s 1 BST
+R G 1934 o - Ap Su>=16 2s 1 BST
+R G 1935 o - Ap Su>=9 2s 1 BST
+R G 1936 1937 - Ap Su>=16 2s 1 BST
+R G 1938 o - Ap Su>=9 2s 1 BST
+R G 1939 o - Ap Su>=16 2s 1 BST
+R G 1939 o - N Su>=16 2s 0 GMT
+R G 1940 o - F Su>=23 2s 1 BST
+R G 1941 o - May Su>=2 1s 2 BDST
+R G 1941 1943 - Au Su>=9 1s 1 BST
+R G 1942 1944 - Ap Su>=2 1s 2 BDST
+R G 1944 o - S Su>=16 1s 1 BST
+R G 1945 o - Ap M>=2 1s 2 BDST
+R G 1945 o - Jul Su>=9 1s 1 BST
+R G 1945 1946 - O Su>=2 2s 0 GMT
+R G 1946 o - Ap Su>=9 2s 1 BST
+R G 1947 o - Mar 16 2s 1 BST
+R G 1947 o - Ap 13 1s 2 BDST
+R G 1947 o - Au 10 1s 1 BST
+R G 1947 o - N 2 2s 0 GMT
+R G 1948 o - Mar 14 2s 1 BST
+R G 1948 o - O 31 2s 0 GMT
+R G 1949 o - Ap 3 2s 1 BST
+R G 1949 o - O 30 2s 0 GMT
+R G 1950 1952 - Ap Su>=14 2s 1 BST
+R G 1950 1952 - O Su>=21 2s 0 GMT
+R G 1953 o - Ap Su>=16 2s 1 BST
+R G 1953 1960 - O Su>=2 2s 0 GMT
+R G 1954 o - Ap Su>=9 2s 1 BST
+R G 1955 1956 - Ap Su>=16 2s 1 BST
+R G 1957 o - Ap Su>=9 2s 1 BST
+R G 1958 1959 - Ap Su>=16 2s 1 BST
+R G 1960 o - Ap Su>=9 2s 1 BST
+R G 1961 1963 - Mar lastSu 2s 1 BST
+R G 1961 1968 - O Su>=23 2s 0 GMT
+R G 1964 1967 - Mar Su>=19 2s 1 BST
+R G 1968 o - F 18 2s 1 BST
+R G 1972 1980 - Mar Su>=16 2s 1 BST
+R G 1972 1980 - O Su>=23 2s 0 GMT
+R G 1981 1995 - Mar lastSu 1u 1 BST
+R G 1981 1989 - O Su>=23 1u 0 GMT
+R G 1990 1995 - O Su>=22 1u 0 GMT
+Z Europe/London -0:1:15 - LMT 1847 D 1 0s
+0 G %s 1968 O 27
+1 - BST 1971 O 31 2u
+0 G %s 1996
+0 E GMT/BST
+L Europe/London Europe/Jersey
+L Europe/London Europe/Guernsey
+L Europe/London Europe/Isle_of_Man
+R IE 1971 o - O 31 2u -1 -
+R IE 1972 1980 - Mar Su>=16 2u 0 -
+R IE 1972 1980 - O Su>=23 2u -1 -
+R IE 1981 ma - Mar lastSu 1u 0 -
+R IE 1981 1989 - O Su>=23 1u -1 -
+R IE 1990 1995 - O Su>=22 1u -1 -
+R IE 1996 ma - O lastSu 1u -1 -
+Z Europe/Dublin -0:25 - LMT 1880 Au 2
+-0:25:21 - DMT 1916 May 21 2s
+-0:25:21 1 IST 1916 O 1 2s
+0 G %s 1921 D 6
+0 G GMT/IST 1940 F 25 2s
+0 1 IST 1946 O 6 2s
+0 - GMT 1947 Mar 16 2s
+0 1 IST 1947 N 2 2s
+0 - GMT 1948 Ap 18 2s
+0 G GMT/IST 1968 O 27
+1 IE IST/GMT
+R E 1977 1980 - Ap Su>=1 1u 1 S
+R E 1977 o - S lastSu 1u 0 -
+R E 1978 o - O 1 1u 0 -
+R E 1979 1995 - S lastSu 1u 0 -
+R E 1981 ma - Mar lastSu 1u 1 S
+R E 1996 ma - O lastSu 1u 0 -
+R W- 1977 1980 - Ap Su>=1 1s 1 S
+R W- 1977 o - S lastSu 1s 0 -
+R W- 1978 o - O 1 1s 0 -
+R W- 1979 1995 - S lastSu 1s 0 -
+R W- 1981 ma - Mar lastSu 1s 1 S
+R W- 1996 ma - O lastSu 1s 0 -
+R c 1916 o - Ap 30 23 1 S
+R c 1916 o - O 1 1 0 -
+R c 1917 1918 - Ap M>=15 2s 1 S
+R c 1917 1918 - S M>=15 2s 0 -
+R c 1940 o - Ap 1 2s 1 S
+R c 1942 o - N 2 2s 0 -
+R c 1943 o - Mar 29 2s 1 S
+R c 1943 o - O 4 2s 0 -
+R c 1944 1945 - Ap M>=1 2s 1 S
+R c 1944 o - O 2 2s 0 -
+R c 1945 o - S 16 2s 0 -
+R c 1977 1980 - Ap Su>=1 2s 1 S
+R c 1977 o - S lastSu 2s 0 -
+R c 1978 o - O 1 2s 0 -
+R c 1979 1995 - S lastSu 2s 0 -
+R c 1981 ma - Mar lastSu 2s 1 S
+R c 1996 ma - O lastSu 2s 0 -
+R e 1977 1980 - Ap Su>=1 0 1 S
+R e 1977 o - S lastSu 0 0 -
+R e 1978 o - O 1 0 0 -
+R e 1979 1995 - S lastSu 0 0 -
+R e 1981 ma - Mar lastSu 0 1 S
+R e 1996 ma - O lastSu 0 0 -
+R R 1917 o - Jul 1 23 1 MST
+R R 1917 o - D 28 0 0 MMT
+R R 1918 o - May 31 22 2 MDST
+R R 1918 o - S 16 1 1 MST
+R R 1919 o - May 31 23 2 MDST
+R R 1919 o - Jul 1 0u 1 MSD
+R R 1919 o - Au 16 0 0 MSK
+R R 1921 o - F 14 23 1 MSD
+R R 1921 o - Mar 20 23 2 +05
+R R 1921 o - S 1 0 1 MSD
+R R 1921 o - O 1 0 0 -
+R R 1981 1984 - Ap 1 0 1 S
+R R 1981 1983 - O 1 0 0 -
+R R 1984 1995 - S lastSu 2s 0 -
+R R 1985 2010 - Mar lastSu 2s 1 S
+R R 1996 2010 - O lastSu 2s 0 -
+Z WET 0 E WE%sT
+Z CET 1 c CE%sT
+Z MET 1 c ME%sT
+Z EET 2 E EE%sT
+R q 1940 o - Jun 16 0 1 S
+R q 1942 o - N 2 3 0 -
+R q 1943 o - Mar 29 2 1 S
+R q 1943 o - Ap 10 3 0 -
+R q 1974 o - May 4 0 1 S
+R q 1974 o - O 2 0 0 -
+R q 1975 o - May 1 0 1 S
+R q 1975 o - O 2 0 0 -
+R q 1976 o - May 2 0 1 S
+R q 1976 o - O 3 0 0 -
+R q 1977 o - May 8 0 1 S
+R q 1977 o - O 2 0 0 -
+R q 1978 o - May 6 0 1 S
+R q 1978 o - O 1 0 0 -
+R q 1979 o - May 5 0 1 S
+R q 1979 o - S 30 0 0 -
+R q 1980 o - May 3 0 1 S
+R q 1980 o - O 4 0 0 -
+R q 1981 o - Ap 26 0 1 S
+R q 1981 o - S 27 0 0 -
+R q 1982 o - May 2 0 1 S
+R q 1982 o - O 3 0 0 -
+R q 1983 o - Ap 18 0 1 S
+R q 1983 o - O 1 0 0 -
+R q 1984 o - Ap 1 0 1 S
+Z Europe/Tirane 1:19:20 - LMT 1914
+1 - CET 1940 Jun 16
+1 q CE%sT 1984 Jul
+1 E CE%sT
+Z Europe/Andorra 0:6:4 - LMT 1901
+0 - WET 1946 S 30
+1 - CET 1985 Mar 31 2
+1 E CE%sT
+R a 1920 o - Ap 5 2s 1 S
+R a 1920 o - S 13 2s 0 -
+R a 1946 o - Ap 14 2s 1 S
+R a 1946 o - O 7 2s 0 -
+R a 1947 1948 - O Su>=1 2s 0 -
+R a 1947 o - Ap 6 2s 1 S
+R a 1948 o - Ap 18 2s 1 S
+R a 1980 o - Ap 6 0 1 S
+R a 1980 o - S 28 0 0 -
+Z Europe/Vienna 1:5:21 - LMT 1893 Ap
+1 c CE%sT 1920
+1 a CE%sT 1940 Ap 1 2s
+1 c CE%sT 1945 Ap 2 2s
+1 1 CEST 1945 Ap 12 2s
+1 - CET 1946
+1 a CE%sT 1981
+1 E CE%sT
+Z Europe/Minsk 1:50:16 - LMT 1880
+1:50 - MMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 Jun 28
+1 c CE%sT 1944 Jul 3
+3 R MSK/MSD 1990
+3 - MSK 1991 Mar 31 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03
+R b 1918 o - Mar 9 0s 1 S
+R b 1918 1919 - O Sa>=1 23s 0 -
+R b 1919 o - Mar 1 23s 1 S
+R b 1920 o - F 14 23s 1 S
+R b 1920 o - O 23 23s 0 -
+R b 1921 o - Mar 14 23s 1 S
+R b 1921 o - O 25 23s 0 -
+R b 1922 o - Mar 25 23s 1 S
+R b 1922 1927 - O Sa>=1 23s 0 -
+R b 1923 o - Ap 21 23s 1 S
+R b 1924 o - Mar 29 23s 1 S
+R b 1925 o - Ap 4 23s 1 S
+R b 1926 o - Ap 17 23s 1 S
+R b 1927 o - Ap 9 23s 1 S
+R b 1928 o - Ap 14 23s 1 S
+R b 1928 1938 - O Su>=2 2s 0 -
+R b 1929 o - Ap 21 2s 1 S
+R b 1930 o - Ap 13 2s 1 S
+R b 1931 o - Ap 19 2s 1 S
+R b 1932 o - Ap 3 2s 1 S
+R b 1933 o - Mar 26 2s 1 S
+R b 1934 o - Ap 8 2s 1 S
+R b 1935 o - Mar 31 2s 1 S
+R b 1936 o - Ap 19 2s 1 S
+R b 1937 o - Ap 4 2s 1 S
+R b 1938 o - Mar 27 2s 1 S
+R b 1939 o - Ap 16 2s 1 S
+R b 1939 o - N 19 2s 0 -
+R b 1940 o - F 25 2s 1 S
+R b 1944 o - S 17 2s 0 -
+R b 1945 o - Ap 2 2s 1 S
+R b 1945 o - S 16 2s 0 -
+R b 1946 o - May 19 2s 1 S
+R b 1946 o - O 7 2s 0 -
+Z Europe/Brussels 0:17:30 - LMT 1880
+0:17:30 - BMT 1892 May 1 0:17:30
+0 - WET 1914 N 8
+1 - CET 1916 May
+1 c CE%sT 1918 N 11 11u
+0 b WE%sT 1940 May 20 2s
+1 c CE%sT 1944 S 3
+1 b CE%sT 1977
+1 E CE%sT
+R BG 1979 o - Mar 31 23 1 S
+R BG 1979 o - O 1 1 0 -
+R BG 1980 1982 - Ap Sa>=1 23 1 S
+R BG 1980 o - S 29 1 0 -
+R BG 1981 o - S 27 2 0 -
+Z Europe/Sofia 1:33:16 - LMT 1880
+1:56:56 - IMT 1894 N 30
+2 - EET 1942 N 2 3
+1 c CE%sT 1945
+1 - CET 1945 Ap 2 3
+2 - EET 1979 Mar 31 23
+2 BG EE%sT 1982 S 26 3
+2 c EE%sT 1991
+2 e EE%sT 1997
+2 E EE%sT
+R CZ 1945 o - Ap M>=1 2s 1 S
+R CZ 1945 o - O 1 2s 0 -
+R CZ 1946 o - May 6 2s 1 S
+R CZ 1946 1949 - O Su>=1 2s 0 -
+R CZ 1947 1948 - Ap Su>=15 2s 1 S
+R CZ 1949 o - Ap 9 2s 1 S
+Z Europe/Prague 0:57:44 - LMT 1850
+0:57:44 - PMT 1891 O
+1 c CE%sT 1945 May 9
+1 CZ CE%sT 1946 D 1 3
+1 -1 GMT 1947 F 23 2
+1 CZ CE%sT 1979
+1 E CE%sT
+R D 1916 o - May 14 23 1 S
+R D 1916 o - S 30 23 0 -
+R D 1940 o - May 15 0 1 S
+R D 1945 o - Ap 2 2s 1 S
+R D 1945 o - Au 15 2s 0 -
+R D 1946 o - May 1 2s 1 S
+R D 1946 o - S 1 2s 0 -
+R D 1947 o - May 4 2s 1 S
+R D 1947 o - Au 10 2s 0 -
+R D 1948 o - May 9 2s 1 S
+R D 1948 o - Au 8 2s 0 -
+Z Europe/Copenhagen 0:50:20 - LMT 1890
+0:50:20 - CMT 1894
+1 D CE%sT 1942 N 2 2s
+1 c CE%sT 1945 Ap 2 2
+1 D CE%sT 1980
+1 E CE%sT
+Z Atlantic/Faroe -0:27:4 - LMT 1908 Ja 11
+0 - WET 1981
+0 E WE%sT
+R Th 1991 1992 - Mar lastSu 2 1 D
+R Th 1991 1992 - S lastSu 2 0 S
+R Th 1993 2006 - Ap Su>=1 2 1 D
+R Th 1993 2006 - O lastSu 2 0 S
+R Th 2007 ma - Mar Su>=8 2 1 D
+R Th 2007 ma - N Su>=1 2 0 S
+Z America/Danmarkshavn -1:14:40 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02 1996
+0 - GMT
+Z America/Scoresbysund -1:27:52 - LMT 1916 Jul 28
+-2 - -02 1980 Ap 6 2
+-2 c -02/-01 1981 Mar 29
+-1 E -01/+00
+Z America/Nuuk -3:26:56 - LMT 1916 Jul 28
+-3 - -03 1980 Ap 6 2
+-3 E -03/-02
+Z America/Thule -4:35:8 - LMT 1916 Jul 28
+-4 Th A%sT
+Z Europe/Tallinn 1:39 - LMT 1880
+1:39 - TMT 1918 F
+1 c CE%sT 1919 Jul
+1:39 - TMT 1921 May
+2 - EET 1940 Au 6
+3 - MSK 1941 S 15
+1 c CE%sT 1944 S 22
+3 R MSK/MSD 1989 Mar 26 2s
+2 1 EEST 1989 S 24 2s
+2 c EE%sT 1998 S 22
+2 E EE%sT 1999 O 31 4
+2 - EET 2002 F 21
+2 E EE%sT
+R FI 1942 o - Ap 2 24 1 S
+R FI 1942 o - O 4 1 0 -
+R FI 1981 1982 - Mar lastSu 2 1 S
+R FI 1981 1982 - S lastSu 3 0 -
+Z Europe/Helsinki 1:39:49 - LMT 1878 May 31
+1:39:49 - HMT 1921 May
+2 FI EE%sT 1983
+2 E EE%sT
+L Europe/Helsinki Europe/Mariehamn
+R F 1916 o - Jun 14 23s 1 S
+R F 1916 1919 - O Su>=1 23s 0 -
+R F 1917 o - Mar 24 23s 1 S
+R F 1918 o - Mar 9 23s 1 S
+R F 1919 o - Mar 1 23s 1 S
+R F 1920 o - F 14 23s 1 S
+R F 1920 o - O 23 23s 0 -
+R F 1921 o - Mar 14 23s 1 S
+R F 1921 o - O 25 23s 0 -
+R F 1922 o - Mar 25 23s 1 S
+R F 1922 1938 - O Sa>=1 23s 0 -
+R F 1923 o - May 26 23s 1 S
+R F 1924 o - Mar 29 23s 1 S
+R F 1925 o - Ap 4 23s 1 S
+R F 1926 o - Ap 17 23s 1 S
+R F 1927 o - Ap 9 23s 1 S
+R F 1928 o - Ap 14 23s 1 S
+R F 1929 o - Ap 20 23s 1 S
+R F 1930 o - Ap 12 23s 1 S
+R F 1931 o - Ap 18 23s 1 S
+R F 1932 o - Ap 2 23s 1 S
+R F 1933 o - Mar 25 23s 1 S
+R F 1934 o - Ap 7 23s 1 S
+R F 1935 o - Mar 30 23s 1 S
+R F 1936 o - Ap 18 23s 1 S
+R F 1937 o - Ap 3 23s 1 S
+R F 1938 o - Mar 26 23s 1 S
+R F 1939 o - Ap 15 23s 1 S
+R F 1939 o - N 18 23s 0 -
+R F 1940 o - F 25 2 1 S
+R F 1941 o - May 5 0 2 M
+R F 1941 o - O 6 0 1 S
+R F 1942 o - Mar 9 0 2 M
+R F 1942 o - N 2 3 1 S
+R F 1943 o - Mar 29 2 2 M
+R F 1943 o - O 4 3 1 S
+R F 1944 o - Ap 3 2 2 M
+R F 1944 o - O 8 1 1 S
+R F 1945 o - Ap 2 2 2 M
+R F 1945 o - S 16 3 0 -
+R F 1976 o - Mar 28 1 1 S
+R F 1976 o - S 26 1 0 -
+Z Europe/Paris 0:9:21 - LMT 1891 Mar 16
+0:9:21 - PMT 1911 Mar 11
+0 F WE%sT 1940 Jun 14 23
+1 c CE%sT 1944 Au 25
+0 F WE%sT 1945 S 16 3
+1 F CE%sT 1977
+1 E CE%sT
+R DE 1946 o - Ap 14 2s 1 S
+R DE 1946 o - O 7 2s 0 -
+R DE 1947 1949 - O Su>=1 2s 0 -
+R DE 1947 o - Ap 6 3s 1 S
+R DE 1947 o - May 11 2s 2 M
+R DE 1947 o - Jun 29 3 1 S
+R DE 1948 o - Ap 18 2s 1 S
+R DE 1949 o - Ap 10 2s 1 S
+R So 1945 o - May 24 2 2 M
+R So 1945 o - S 24 3 1 S
+R So 1945 o - N 18 2s 0 -
+Z Europe/Berlin 0:53:28 - LMT 1893 Ap
+1 c CE%sT 1945 May 24 2
+1 So CE%sT 1946
+1 DE CE%sT 1980
+1 E CE%sT
+L Europe/Zurich Europe/Busingen
+Z Europe/Gibraltar -0:21:24 - LMT 1880 Au 2 0s
+0 G %s 1957 Ap 14 2
+1 - CET 1982
+1 E CE%sT
+R g 1932 o - Jul 7 0 1 S
+R g 1932 o - S 1 0 0 -
+R g 1941 o - Ap 7 0 1 S
+R g 1942 o - N 2 3 0 -
+R g 1943 o - Mar 30 0 1 S
+R g 1943 o - O 4 0 0 -
+R g 1952 o - Jul 1 0 1 S
+R g 1952 o - N 2 0 0 -
+R g 1975 o - Ap 12 0s 1 S
+R g 1975 o - N 26 0s 0 -
+R g 1976 o - Ap 11 2s 1 S
+R g 1976 o - O 10 2s 0 -
+R g 1977 1978 - Ap Su>=1 2s 1 S
+R g 1977 o - S 26 2s 0 -
+R g 1978 o - S 24 4 0 -
+R g 1979 o - Ap 1 9 1 S
+R g 1979 o - S 29 2 0 -
+R g 1980 o - Ap 1 0 1 S
+R g 1980 o - S 28 0 0 -
+Z Europe/Athens 1:34:52 - LMT 1895 S 14
+1:34:52 - AMT 1916 Jul 28 0:1
+2 g EE%sT 1941 Ap 30
+1 g CE%sT 1944 Ap 4
+2 g EE%sT 1981
+2 E EE%sT
+R h 1918 1919 - Ap 15 2 1 S
+R h 1918 1920 - S M>=15 3 0 -
+R h 1920 o - Ap 5 2 1 S
+R h 1945 o - May 1 23 1 S
+R h 1945 o - N 1 1 0 -
+R h 1946 o - Mar 31 2s 1 S
+R h 1946 o - O 7 2 0 -
+R h 1947 1949 - Ap Su>=4 2s 1 S
+R h 1947 1949 - O Su>=1 2s 0 -
+R h 1954 o - May 23 0 1 S
+R h 1954 o - O 3 0 0 -
+R h 1955 o - May 22 2 1 S
+R h 1955 o - O 2 3 0 -
+R h 1956 1957 - Jun Su>=1 2 1 S
+R h 1956 1957 - S lastSu 3 0 -
+R h 1980 o - Ap 6 0 1 S
+R h 1980 o - S 28 1 0 -
+R h 1981 1983 - Mar lastSu 0 1 S
+R h 1981 1983 - S lastSu 1 0 -
+Z Europe/Budapest 1:16:20 - LMT 1890 N
+1 c CE%sT 1918
+1 h CE%sT 1941 Ap 7 23
+1 c CE%sT 1945
+1 h CE%sT 1984
+1 E CE%sT
+R w 1917 1919 - F 19 23 1 -
+R w 1917 o - O 21 1 0 -
+R w 1918 1919 - N 16 1 0 -
+R w 1921 o - Mar 19 23 1 -
+R w 1921 o - Jun 23 1 0 -
+R w 1939 o - Ap 29 23 1 -
+R w 1939 o - O 29 2 0 -
+R w 1940 o - F 25 2 1 -
+R w 1940 1941 - N Su>=2 1s 0 -
+R w 1941 1942 - Mar Su>=2 1s 1 -
+R w 1943 1946 - Mar Su>=1 1s 1 -
+R w 1942 1948 - O Su>=22 1s 0 -
+R w 1947 1967 - Ap Su>=1 1s 1 -
+R w 1949 o - O 30 1s 0 -
+R w 1950 1966 - O Su>=22 1s 0 -
+R w 1967 o - O 29 1s 0 -
+Z Atlantic/Reykjavik -1:28 - LMT 1908
+-1 w -01/+00 1968 Ap 7 1s
+0 - GMT
+R I 1916 o - Jun 3 24 1 S
+R I 1916 1917 - S 30 24 0 -
+R I 1917 o - Mar 31 24 1 S
+R I 1918 o - Mar 9 24 1 S
+R I 1918 o - O 6 24 0 -
+R I 1919 o - Mar 1 24 1 S
+R I 1919 o - O 4 24 0 -
+R I 1920 o - Mar 20 24 1 S
+R I 1920 o - S 18 24 0 -
+R I 1940 o - Jun 14 24 1 S
+R I 1942 o - N 2 2s 0 -
+R I 1943 o - Mar 29 2s 1 S
+R I 1943 o - O 4 2s 0 -
+R I 1944 o - Ap 2 2s 1 S
+R I 1944 o - S 17 2s 0 -
+R I 1945 o - Ap 2 2 1 S
+R I 1945 o - S 15 1 0 -
+R I 1946 o - Mar 17 2s 1 S
+R I 1946 o - O 6 2s 0 -
+R I 1947 o - Mar 16 0s 1 S
+R I 1947 o - O 5 0s 0 -
+R I 1948 o - F 29 2s 1 S
+R I 1948 o - O 3 2s 0 -
+R I 1966 1968 - May Su>=22 0s 1 S
+R I 1966 o - S 24 24 0 -
+R I 1967 1969 - S Su>=22 0s 0 -
+R I 1969 o - Jun 1 0s 1 S
+R I 1970 o - May 31 0s 1 S
+R I 1970 o - S lastSu 0s 0 -
+R I 1971 1972 - May Su>=22 0s 1 S
+R I 1971 o - S lastSu 0s 0 -
+R I 1972 o - O 1 0s 0 -
+R I 1973 o - Jun 3 0s 1 S
+R I 1973 1974 - S lastSu 0s 0 -
+R I 1974 o - May 26 0s 1 S
+R I 1975 o - Jun 1 0s 1 S
+R I 1975 1977 - S lastSu 0s 0 -
+R I 1976 o - May 30 0s 1 S
+R I 1977 1979 - May Su>=22 0s 1 S
+R I 1978 o - O 1 0s 0 -
+R I 1979 o - S 30 0s 0 -
+Z Europe/Rome 0:49:56 - LMT 1866 D 12
+0:49:56 - RMT 1893 O 31 23:49:56
+1 I CE%sT 1943 S 10
+1 c CE%sT 1944 Jun 4
+1 I CE%sT 1980
+1 E CE%sT
+L Europe/Rome Europe/Vatican
+L Europe/Rome Europe/San_Marino
+R LV 1989 1996 - Mar lastSu 2s 1 S
+R LV 1989 1996 - S lastSu 2s 0 -
+Z Europe/Riga 1:36:34 - LMT 1880
+1:36:34 - RMT 1918 Ap 15 2
+1:36:34 1 LST 1918 S 16 3
+1:36:34 - RMT 1919 Ap 1 2
+1:36:34 1 LST 1919 May 22 3
+1:36:34 - RMT 1926 May 11
+2 - EET 1940 Au 5
+3 - MSK 1941 Jul
+1 c CE%sT 1944 O 13
+3 R MSK/MSD 1989 Mar lastSu 2s
+2 1 EEST 1989 S lastSu 2s
+2 LV EE%sT 1997 Ja 21
+2 E EE%sT 2000 F 29
+2 - EET 2001 Ja 2
+2 E EE%sT
+L Europe/Zurich Europe/Vaduz
+Z Europe/Vilnius 1:41:16 - LMT 1880
+1:24 - WMT 1917
+1:35:36 - KMT 1919 O 10
+1 - CET 1920 Jul 12
+2 - EET 1920 O 9
+1 - CET 1940 Au 3
+3 - MSK 1941 Jun 24
+1 c CE%sT 1944 Au
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 1991 S 29 2s
+2 c EE%sT 1998
+2 - EET 1998 Mar 29 1u
+1 E CE%sT 1999 O 31 1u
+2 - EET 2003
+2 E EE%sT
+R LX 1916 o - May 14 23 1 S
+R LX 1916 o - O 1 1 0 -
+R LX 1917 o - Ap 28 23 1 S
+R LX 1917 o - S 17 1 0 -
+R LX 1918 o - Ap M>=15 2s 1 S
+R LX 1918 o - S M>=15 2s 0 -
+R LX 1919 o - Mar 1 23 1 S
+R LX 1919 o - O 5 3 0 -
+R LX 1920 o - F 14 23 1 S
+R LX 1920 o - O 24 2 0 -
+R LX 1921 o - Mar 14 23 1 S
+R LX 1921 o - O 26 2 0 -
+R LX 1922 o - Mar 25 23 1 S
+R LX 1922 o - O Su>=2 1 0 -
+R LX 1923 o - Ap 21 23 1 S
+R LX 1923 o - O Su>=2 2 0 -
+R LX 1924 o - Mar 29 23 1 S
+R LX 1924 1928 - O Su>=2 1 0 -
+R LX 1925 o - Ap 5 23 1 S
+R LX 1926 o - Ap 17 23 1 S
+R LX 1927 o - Ap 9 23 1 S
+R LX 1928 o - Ap 14 23 1 S
+R LX 1929 o - Ap 20 23 1 S
+Z Europe/Luxembourg 0:24:36 - LMT 1904 Jun
+1 LX CE%sT 1918 N 25
+0 LX WE%sT 1929 O 6 2s
+0 b WE%sT 1940 May 14 3
+1 c WE%sT 1944 S 18 3
+1 b CE%sT 1977
+1 E CE%sT
+R MT 1973 o - Mar 31 0s 1 S
+R MT 1973 o - S 29 0s 0 -
+R MT 1974 o - Ap 21 0s 1 S
+R MT 1974 o - S 16 0s 0 -
+R MT 1975 1979 - Ap Su>=15 2 1 S
+R MT 1975 1980 - S Su>=15 2 0 -
+R MT 1980 o - Mar 31 2 1 S
+Z Europe/Malta 0:58:4 - LMT 1893 N 2 0s
+1 I CE%sT 1973 Mar 31
+1 MT CE%sT 1981
+1 E CE%sT
+R MD 1997 ma - Mar lastSu 2 1 S
+R MD 1997 ma - O lastSu 3 0 -
+Z Europe/Chisinau 1:55:20 - LMT 1880
+1:55 - CMT 1918 F 15
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1940 Au 15
+2 1 EEST 1941 Jul 17
+1 c CE%sT 1944 Au 24
+3 R MSK/MSD 1990 May 6 2
+2 R EE%sT 1992
+2 e EE%sT 1997
+2 MD EE%sT
+Z Europe/Monaco 0:29:32 - LMT 1892 Jun
+0:9:21 - PMT 1911 Mar 29
+0 F WE%sT 1945 S 16 3
+1 F CE%sT 1977
+1 E CE%sT
+R N 1916 o - May 1 0 1 NST
+R N 1916 o - O 1 0 0 AMT
+R N 1917 o - Ap 16 2s 1 NST
+R N 1917 o - S 17 2s 0 AMT
+R N 1918 1921 - Ap M>=1 2s 1 NST
+R N 1918 1921 - S lastM 2s 0 AMT
+R N 1922 o - Mar lastSu 2s 1 NST
+R N 1922 1936 - O Su>=2 2s 0 AMT
+R N 1923 o - Jun F>=1 2s 1 NST
+R N 1924 o - Mar lastSu 2s 1 NST
+R N 1925 o - Jun F>=1 2s 1 NST
+R N 1926 1931 - May 15 2s 1 NST
+R N 1932 o - May 22 2s 1 NST
+R N 1933 1936 - May 15 2s 1 NST
+R N 1937 o - May 22 2s 1 NST
+R N 1937 o - Jul 1 0 1 S
+R N 1937 1939 - O Su>=2 2s 0 -
+R N 1938 1939 - May 15 2s 1 S
+R N 1945 o - Ap 2 2s 1 S
+R N 1945 o - S 16 2s 0 -
+Z Europe/Amsterdam 0:19:32 - LMT 1835
+0:19:32 N %s 1937 Jul
+0:20 N +0020/+0120 1940 May 16
+1 c CE%sT 1945 Ap 2 2
+1 N CE%sT 1977
+1 E CE%sT
+R NO 1916 o - May 22 1 1 S
+R NO 1916 o - S 30 0 0 -
+R NO 1945 o - Ap 2 2s 1 S
+R NO 1945 o - O 1 2s 0 -
+R NO 1959 1964 - Mar Su>=15 2s 1 S
+R NO 1959 1965 - S Su>=15 2s 0 -
+R NO 1965 o - Ap 25 2s 1 S
+Z Europe/Oslo 0:43 - LMT 1895
+1 NO CE%sT 1940 Au 10 23
+1 c CE%sT 1945 Ap 2 2
+1 NO CE%sT 1980
+1 E CE%sT
+L Europe/Oslo Arctic/Longyearbyen
+R O 1918 1919 - S 16 2s 0 -
+R O 1919 o - Ap 15 2s 1 S
+R O 1944 o - Ap 3 2s 1 S
+R O 1944 o - O 4 2 0 -
+R O 1945 o - Ap 29 0 1 S
+R O 1945 o - N 1 0 0 -
+R O 1946 o - Ap 14 0s 1 S
+R O 1946 o - O 7 2s 0 -
+R O 1947 o - May 4 2s 1 S
+R O 1947 1949 - O Su>=1 2s 0 -
+R O 1948 o - Ap 18 2s 1 S
+R O 1949 o - Ap 10 2s 1 S
+R O 1957 o - Jun 2 1s 1 S
+R O 1957 1958 - S lastSu 1s 0 -
+R O 1958 o - Mar 30 1s 1 S
+R O 1959 o - May 31 1s 1 S
+R O 1959 1961 - O Su>=1 1s 0 -
+R O 1960 o - Ap 3 1s 1 S
+R O 1961 1964 - May lastSu 1s 1 S
+R O 1962 1964 - S lastSu 1s 0 -
+Z Europe/Warsaw 1:24 - LMT 1880
+1:24 - WMT 1915 Au 5
+1 c CE%sT 1918 S 16 3
+2 O EE%sT 1922 Jun
+1 O CE%sT 1940 Jun 23 2
+1 c CE%sT 1944 O
+1 O CE%sT 1977
+1 W- CE%sT 1988
+1 E CE%sT
+R p 1916 o - Jun 17 23 1 S
+R p 1916 o - N 1 1 0 -
+R p 1917 o - F 28 23s 1 S
+R p 1917 1921 - O 14 23s 0 -
+R p 1918 o - Mar 1 23s 1 S
+R p 1919 o - F 28 23s 1 S
+R p 1920 o - F 29 23s 1 S
+R p 1921 o - F 28 23s 1 S
+R p 1924 o - Ap 16 23s 1 S
+R p 1924 o - O 14 23s 0 -
+R p 1926 o - Ap 17 23s 1 S
+R p 1926 1929 - O Sa>=1 23s 0 -
+R p 1927 o - Ap 9 23s 1 S
+R p 1928 o - Ap 14 23s 1 S
+R p 1929 o - Ap 20 23s 1 S
+R p 1931 o - Ap 18 23s 1 S
+R p 1931 1932 - O Sa>=1 23s 0 -
+R p 1932 o - Ap 2 23s 1 S
+R p 1934 o - Ap 7 23s 1 S
+R p 1934 1938 - O Sa>=1 23s 0 -
+R p 1935 o - Mar 30 23s 1 S
+R p 1936 o - Ap 18 23s 1 S
+R p 1937 o - Ap 3 23s 1 S
+R p 1938 o - Mar 26 23s 1 S
+R p 1939 o - Ap 15 23s 1 S
+R p 1939 o - N 18 23s 0 -
+R p 1940 o - F 24 23s 1 S
+R p 1940 1941 - O 5 23s 0 -
+R p 1941 o - Ap 5 23s 1 S
+R p 1942 1945 - Mar Sa>=8 23s 1 S
+R p 1942 o - Ap 25 22s 2 M
+R p 1942 o - Au 15 22s 1 S
+R p 1942 1945 - O Sa>=24 23s 0 -
+R p 1943 o - Ap 17 22s 2 M
+R p 1943 1945 - Au Sa>=25 22s 1 S
+R p 1944 1945 - Ap Sa>=21 22s 2 M
+R p 1946 o - Ap Sa>=1 23s 1 S
+R p 1946 o - O Sa>=1 23s 0 -
+R p 1947 1949 - Ap Su>=1 2s 1 S
+R p 1947 1949 - O Su>=1 2s 0 -
+R p 1951 1965 - Ap Su>=1 2s 1 S
+R p 1951 1965 - O Su>=1 2s 0 -
+R p 1977 o - Mar 27 0s 1 S
+R p 1977 o - S 25 0s 0 -
+R p 1978 1979 - Ap Su>=1 0s 1 S
+R p 1978 o - O 1 0s 0 -
+R p 1979 1982 - S lastSu 1s 0 -
+R p 1980 o - Mar lastSu 0s 1 S
+R p 1981 1982 - Mar lastSu 1s 1 S
+R p 1983 o - Mar lastSu 2s 1 S
+Z Europe/Lisbon -0:36:45 - LMT 1884
+-0:36:45 - LMT 1912 Ja 1 0u
+0 p WE%sT 1966 Ap 3 2
+1 - CET 1976 S 26 1
+0 p WE%sT 1983 S 25 1s
+0 W- WE%sT 1992 S 27 1s
+1 E CE%sT 1996 Mar 31 1u
+0 E WE%sT
+Z Atlantic/Azores -1:42:40 - LMT 1884
+-1:54:32 - HMT 1912 Ja 1 2u
+-2 p -02/-01 1942 Ap 25 22s
+-2 p +00 1942 Au 15 22s
+-2 p -02/-01 1943 Ap 17 22s
+-2 p +00 1943 Au 28 22s
+-2 p -02/-01 1944 Ap 22 22s
+-2 p +00 1944 Au 26 22s
+-2 p -02/-01 1945 Ap 21 22s
+-2 p +00 1945 Au 25 22s
+-2 p -02/-01 1966 Ap 3 2
+-1 p -01/+00 1983 S 25 1s
+-1 W- -01/+00 1992 S 27 1s
+0 E WE%sT 1993 Mar 28 1u
+-1 E -01/+00
+Z Atlantic/Madeira -1:7:36 - LMT 1884
+-1:7:36 - FMT 1912 Ja 1 1u
+-1 p -01/+00 1942 Ap 25 22s
+-1 p +01 1942 Au 15 22s
+-1 p -01/+00 1943 Ap 17 22s
+-1 p +01 1943 Au 28 22s
+-1 p -01/+00 1944 Ap 22 22s
+-1 p +01 1944 Au 26 22s
+-1 p -01/+00 1945 Ap 21 22s
+-1 p +01 1945 Au 25 22s
+-1 p -01/+00 1966 Ap 3 2
+0 p WE%sT 1983 S 25 1s
+0 E WE%sT
+R z 1932 o - May 21 0s 1 S
+R z 1932 1939 - O Su>=1 0s 0 -
+R z 1933 1939 - Ap Su>=2 0s 1 S
+R z 1979 o - May 27 0 1 S
+R z 1979 o - S lastSu 0 0 -
+R z 1980 o - Ap 5 23 1 S
+R z 1980 o - S lastSu 1 0 -
+R z 1991 1993 - Mar lastSu 0s 1 S
+R z 1991 1993 - S lastSu 0s 0 -
+Z Europe/Bucharest 1:44:24 - LMT 1891 O
+1:44:24 - BMT 1931 Jul 24
+2 z EE%sT 1981 Mar 29 2s
+2 c EE%sT 1991
+2 z EE%sT 1994
+2 e EE%sT 1997
+2 E EE%sT
+Z Europe/Kaliningrad 1:22 - LMT 1893 Ap
+1 c CE%sT 1945 Ap 10
+2 O EE%sT 1946 Ap 7
+3 R MSK/MSD 1989 Mar 26 2s
+2 R EE%sT 2011 Mar 27 2s
+3 - +03 2014 O 26 2s
+2 - EET
+Z Europe/Moscow 2:30:17 - LMT 1880
+2:30:17 - MMT 1916 Jul 3
+2:31:19 R %s 1919 Jul 1 0u
+3 R %s 1921 O
+3 R MSK/MSD 1922 O
+2 - EET 1930 Jun 21
+3 R MSK/MSD 1991 Mar 31 2s
+2 R EE%sT 1992 Ja 19 2s
+3 R MSK/MSD 2011 Mar 27 2s
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Simferopol 2:16:24 - LMT 1880
+2:16 - SMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 N
+1 c CE%sT 1944 Ap 13
+3 R MSK/MSD 1990
+3 - MSK 1990 Jul 1 2
+2 - EET 1992
+2 e EE%sT 1994 May
+3 e MSK/MSD 1996 Mar 31 0s
+3 1 MSD 1996 O 27 3s
+3 R MSK/MSD 1997
+3 - MSK 1997 Mar lastSu 1u
+2 E EE%sT 2014 Mar 30 2
+4 - MSK 2014 O 26 2s
+3 - MSK
+Z Europe/Astrakhan 3:12:12 - LMT 1924 May
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Europe/Volgograd 2:57:40 - LMT 1920 Ja 3
+3 - +03 1930 Jun 21
+4 - +04 1961 N 11
+4 R +04/+05 1988 Mar 27 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2018 O 28 2s
+4 - +04 2020 D 27 2s
+3 - +03
+Z Europe/Saratov 3:4:18 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1988 Mar 27 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 D 4 2s
+4 - +04
+Z Europe/Kirov 3:18:48 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+4 - +04 1992 Mar 29 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03
+Z Europe/Samara 3:20:20 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 - +04 1935 Ja 27
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1991 S 29 2s
+3 - +03 1991 O 20 3
+4 R +04/+05 2010 Mar 28 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04
+Z Europe/Ulyanovsk 3:13:36 - LMT 1919 Jul 1 0u
+3 - +03 1930 Jun 21
+4 R +04/+05 1989 Mar 26 2s
+3 R +03/+04 1991 Mar 31 2s
+2 R +02/+03 1992 Ja 19 2s
+3 R +03/+04 2011 Mar 27 2s
+4 - +04 2014 O 26 2s
+3 - +03 2016 Mar 27 2s
+4 - +04
+Z Asia/Yekaterinburg 4:2:33 - LMT 1916 Jul 3
+3:45:5 - PMT 1919 Jul 15 4
+4 - +04 1930 Jun 21
+5 R +05/+06 1991 Mar 31 2s
+4 R +04/+05 1992 Ja 19 2s
+5 R +05/+06 2011 Mar 27 2s
+6 - +06 2014 O 26 2s
+5 - +05
+Z Asia/Omsk 4:53:30 - LMT 1919 N 14
+5 - +05 1930 Jun 21
+6 R +06/+07 1991 Mar 31 2s
+5 R +05/+06 1992 Ja 19 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06
+Z Asia/Barnaul 5:35 - LMT 1919 D 10
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1995 May 28
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Mar 27 2s
+7 - +07
+Z Asia/Novosibirsk 5:31:40 - LMT 1919 D 14 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 1993 May 23
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 Jul 24 2s
+7 - +07
+Z Asia/Tomsk 5:39:51 - LMT 1919 D 22
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2002 May 1 3
+6 R +06/+07 2011 Mar 27 2s
+7 - +07 2014 O 26 2s
+6 - +06 2016 May 29 2s
+7 - +07
+Z Asia/Novokuznetsk 5:48:48 - LMT 1924 May
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2010 Mar 28 2s
+6 R +06/+07 2011 Mar 27 2s
+7 - +07
+Z Asia/Krasnoyarsk 6:11:26 - LMT 1920 Ja 6
+6 - +06 1930 Jun 21
+7 R +07/+08 1991 Mar 31 2s
+6 R +06/+07 1992 Ja 19 2s
+7 R +07/+08 2011 Mar 27 2s
+8 - +08 2014 O 26 2s
+7 - +07
+Z Asia/Irkutsk 6:57:5 - LMT 1880
+6:57:5 - IMT 1920 Ja 25
+7 - +07 1930 Jun 21
+8 R +08/+09 1991 Mar 31 2s
+7 R +07/+08 1992 Ja 19 2s
+8 R +08/+09 2011 Mar 27 2s
+9 - +09 2014 O 26 2s
+8 - +08
+Z Asia/Chita 7:33:52 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+8 - +08 2016 Mar 27 2
+9 - +09
+Z Asia/Yakutsk 8:38:58 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2011 Mar 27 2s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Vladivostok 8:47:31 - LMT 1922 N 15
+9 - +09 1930 Jun 21
+10 R +10/+11 1991 Mar 31 2s
+9 R +09/+10 1992 Ja 19 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Khandyga 9:2:13 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1991 Mar 31 2s
+8 R +08/+09 1992 Ja 19 2s
+9 R +09/+10 2004
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2011 S 13 0s
+10 - +10 2014 O 26 2s
+9 - +09
+Z Asia/Sakhalin 9:30:48 - LMT 1905 Au 23
+9 - +09 1945 Au 25
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 1997 Mar lastSu 2s
+10 R +10/+11 2011 Mar 27 2s
+11 - +11 2014 O 26 2s
+10 - +10 2016 Mar 27 2s
+11 - +11
+Z Asia/Magadan 10:3:12 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+10 - +10 2016 Ap 24 2s
+11 - +11
+Z Asia/Srednekolymsk 10:14:52 - LMT 1924 May 2
+10 - +10 1930 Jun 21
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2014 O 26 2s
+11 - +11
+Z Asia/Ust-Nera 9:32:54 - LMT 1919 D 15
+8 - +08 1930 Jun 21
+9 R +09/+10 1981 Ap
+11 R +11/+12 1991 Mar 31 2s
+10 R +10/+11 1992 Ja 19 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12 2011 S 13 0s
+11 - +11 2014 O 26 2s
+10 - +10
+Z Asia/Kamchatka 10:34:36 - LMT 1922 N 10
+11 - +11 1930 Jun 21
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Asia/Anadyr 11:49:56 - LMT 1924 May 2
+12 - +12 1930 Jun 21
+13 R +13/+14 1982 Ap 1 0s
+12 R +12/+13 1991 Mar 31 2s
+11 R +11/+12 1992 Ja 19 2s
+12 R +12/+13 2010 Mar 28 2s
+11 R +11/+12 2011 Mar 27 2s
+12 - +12
+Z Europe/Belgrade 1:22 - LMT 1884
+1 - CET 1941 Ap 18 23
+1 c CE%sT 1945
+1 - CET 1945 May 8 2s
+1 1 CEST 1945 S 16 2s
+1 - CET 1982 N 27
+1 E CE%sT
+L Europe/Belgrade Europe/Ljubljana
+L Europe/Belgrade Europe/Podgorica
+L Europe/Belgrade Europe/Sarajevo
+L Europe/Belgrade Europe/Skopje
+L Europe/Belgrade Europe/Zagreb
+L Europe/Prague Europe/Bratislava
+R s 1918 o - Ap 15 23 1 S
+R s 1918 1919 - O 6 24s 0 -
+R s 1919 o - Ap 6 23 1 S
+R s 1924 o - Ap 16 23 1 S
+R s 1924 o - O 4 24s 0 -
+R s 1926 o - Ap 17 23 1 S
+R s 1926 1929 - O Sa>=1 24s 0 -
+R s 1927 o - Ap 9 23 1 S
+R s 1928 o - Ap 15 0 1 S
+R s 1929 o - Ap 20 23 1 S
+R s 1937 o - Jun 16 23 1 S
+R s 1937 o - O 2 24s 0 -
+R s 1938 o - Ap 2 23 1 S
+R s 1938 o - Ap 30 23 2 M
+R s 1938 o - O 2 24 1 S
+R s 1939 o - O 7 24s 0 -
+R s 1942 o - May 2 23 1 S
+R s 1942 o - S 1 1 0 -
+R s 1943 1946 - Ap Sa>=13 23 1 S
+R s 1943 1944 - O Su>=1 1 0 -
+R s 1945 1946 - S lastSu 1 0 -
+R s 1949 o - Ap 30 23 1 S
+R s 1949 o - O 2 1 0 -
+R s 1974 1975 - Ap Sa>=12 23 1 S
+R s 1974 1975 - O Su>=1 1 0 -
+R s 1976 o - Mar 27 23 1 S
+R s 1976 1977 - S lastSu 1 0 -
+R s 1977 o - Ap 2 23 1 S
+R s 1978 o - Ap 2 2s 1 S
+R s 1978 o - O 1 2s 0 -
+R Sp 1967 o - Jun 3 12 1 S
+R Sp 1967 o - O 1 0 0 -
+R Sp 1974 o - Jun 24 0 1 S
+R Sp 1974 o - S 1 0 0 -
+R Sp 1976 1977 - May 1 0 1 S
+R Sp 1976 o - Au 1 0 0 -
+R Sp 1977 o - S 28 0 0 -
+R Sp 1978 o - Jun 1 0 1 S
+R Sp 1978 o - Au 4 0 0 -
+Z Europe/Madrid -0:14:44 - LMT 1900 D 31 23:45:16
+0 s WE%sT 1940 Mar 16 23
+1 s CE%sT 1979
+1 E CE%sT
+Z Africa/Ceuta -0:21:16 - LMT 1900 D 31 23:38:44
+0 - WET 1918 May 6 23
+0 1 WEST 1918 O 7 23
+0 - WET 1924
+0 s WE%sT 1929
+0 - WET 1967
+0 Sp WE%sT 1984 Mar 16
+1 - CET 1986
+1 E CE%sT
+Z Atlantic/Canary -1:1:36 - LMT 1922 Mar
+-1 - -01 1946 S 30 1
+0 - WET 1980 Ap 6 0s
+0 1 WEST 1980 S 28 1u
+0 E WE%sT
+Z Europe/Stockholm 1:12:12 - LMT 1879
+1:0:14 - SET 1900
+1 - CET 1916 May 14 23
+1 1 CEST 1916 O 1 1
+1 - CET 1980
+1 E CE%sT
+R CH 1941 1942 - May M>=1 1 1 S
+R CH 1941 1942 - O M>=1 2 0 -
+Z Europe/Zurich 0:34:8 - LMT 1853 Jul 16
+0:29:46 - BMT 1894 Jun
+1 CH CE%sT 1981
+1 E CE%sT
+R T 1916 o - May 1 0 1 S
+R T 1916 o - O 1 0 0 -
+R T 1920 o - Mar 28 0 1 S
+R T 1920 o - O 25 0 0 -
+R T 1921 o - Ap 3 0 1 S
+R T 1921 o - O 3 0 0 -
+R T 1922 o - Mar 26 0 1 S
+R T 1922 o - O 8 0 0 -
+R T 1924 o - May 13 0 1 S
+R T 1924 1925 - O 1 0 0 -
+R T 1925 o - May 1 0 1 S
+R T 1940 o - Jul 1 0 1 S
+R T 1940 o - O 6 0 0 -
+R T 1940 o - D 1 0 1 S
+R T 1941 o - S 21 0 0 -
+R T 1942 o - Ap 1 0 1 S
+R T 1945 o - O 8 0 0 -
+R T 1946 o - Jun 1 0 1 S
+R T 1946 o - O 1 0 0 -
+R T 1947 1948 - Ap Su>=16 0 1 S
+R T 1947 1951 - O Su>=2 0 0 -
+R T 1949 o - Ap 10 0 1 S
+R T 1950 o - Ap 16 0 1 S
+R T 1951 o - Ap 22 0 1 S
+R T 1962 o - Jul 15 0 1 S
+R T 1963 o - O 30 0 0 -
+R T 1964 o - May 15 0 1 S
+R T 1964 o - O 1 0 0 -
+R T 1973 o - Jun 3 1 1 S
+R T 1973 1976 - O Su>=31 2 0 -
+R T 1974 o - Mar 31 2 1 S
+R T 1975 o - Mar 22 2 1 S
+R T 1976 o - Mar 21 2 1 S
+R T 1977 1978 - Ap Su>=1 2 1 S
+R T 1977 1978 - O Su>=15 2 0 -
+R T 1978 o - Jun 29 0 0 -
+R T 1983 o - Jul 31 2 1 S
+R T 1983 o - O 2 2 0 -
+R T 1985 o - Ap 20 1s 1 S
+R T 1985 o - S 28 1s 0 -
+R T 1986 1993 - Mar lastSu 1s 1 S
+R T 1986 1995 - S lastSu 1s 0 -
+R T 1994 o - Mar 20 1s 1 S
+R T 1995 2006 - Mar lastSu 1s 1 S
+R T 1996 2006 - O lastSu 1s 0 -
+Z Europe/Istanbul 1:55:52 - LMT 1880
+1:56:56 - IMT 1910 O
+2 T EE%sT 1978 Jun 29
+3 T +03/+04 1984 N 1 2
+2 T EE%sT 2007
+2 E EE%sT 2011 Mar 27 1u
+2 - EET 2011 Mar 28 1u
+2 E EE%sT 2014 Mar 30 1u
+2 - EET 2014 Mar 31 1u
+2 E EE%sT 2015 O 25 1u
+2 1 EEST 2015 N 8 1u
+2 E EE%sT 2016 S 7
+3 - +03
+L Europe/Istanbul Asia/Istanbul
+Z Europe/Kiev 2:2:4 - LMT 1880
+2:2:4 - KMT 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 S 20
+1 c CE%sT 1943 N 6
+3 R MSK/MSD 1990 Jul 1 2
+2 1 EEST 1991 S 29 3
+2 e EE%sT 1995
+2 E EE%sT
+Z Europe/Uzhgorod 1:29:12 - LMT 1890 O
+1 - CET 1940
+1 c CE%sT 1944 O
+1 1 CEST 1944 O 26
+1 - CET 1945 Jun 29
+3 R MSK/MSD 1990
+3 - MSK 1990 Jul 1 2
+1 - CET 1991 Mar 31 3
+2 - EET 1992
+2 e EE%sT 1995
+2 E EE%sT
+Z Europe/Zaporozhye 2:20:40 - LMT 1880
+2:20 - +0220 1924 May 2
+2 - EET 1930 Jun 21
+3 - MSK 1941 Au 25
+1 c CE%sT 1943 O 25
+3 R MSK/MSD 1991 Mar 31 2
+2 e EE%sT 1995
+2 E EE%sT
+R u 1918 1919 - Mar lastSu 2 1 D
+R u 1918 1919 - O lastSu 2 0 S
+R u 1942 o - F 9 2 1 W
+R u 1945 o - Au 14 23u 1 P
+R u 1945 o - S 30 2 0 S
+R u 1967 2006 - O lastSu 2 0 S
+R u 1967 1973 - Ap lastSu 2 1 D
+R u 1974 o - Ja 6 2 1 D
+R u 1975 o - F lastSu 2 1 D
+R u 1976 1986 - Ap lastSu 2 1 D
+R u 1987 2006 - Ap Su>=1 2 1 D
+R u 2007 ma - Mar Su>=8 2 1 D
+R u 2007 ma - N Su>=1 2 0 S
+Z EST -5 - EST
+Z MST -7 - MST
+Z HST -10 - HST
+Z EST5EDT -5 u E%sT
+Z CST6CDT -6 u C%sT
+Z MST7MDT -7 u M%sT
+Z PST8PDT -8 u P%sT
+R NY 1920 o - Mar lastSu 2 1 D
+R NY 1920 o - O lastSu 2 0 S
+R NY 1921 1966 - Ap lastSu 2 1 D
+R NY 1921 1954 - S lastSu 2 0 S
+R NY 1955 1966 - O lastSu 2 0 S
+Z America/New_York -4:56:2 - LMT 1883 N 18 12:3:58
+-5 u E%sT 1920
+-5 NY E%sT 1942
+-5 u E%sT 1946
+-5 NY E%sT 1967
+-5 u E%sT
+R Ch 1920 o - Jun 13 2 1 D
+R Ch 1920 1921 - O lastSu 2 0 S
+R Ch 1921 o - Mar lastSu 2 1 D
+R Ch 1922 1966 - Ap lastSu 2 1 D
+R Ch 1922 1954 - S lastSu 2 0 S
+R Ch 1955 1966 - O lastSu 2 0 S
+Z America/Chicago -5:50:36 - LMT 1883 N 18 12:9:24
+-6 u C%sT 1920
+-6 Ch C%sT 1936 Mar 1 2
+-5 - EST 1936 N 15 2
+-6 Ch C%sT 1942
+-6 u C%sT 1946
+-6 Ch C%sT 1967
+-6 u C%sT
+Z America/North_Dakota/Center -6:45:12 - LMT 1883 N 18 12:14:48
+-7 u M%sT 1992 O 25 2
+-6 u C%sT
+Z America/North_Dakota/New_Salem -6:45:39 - LMT 1883 N 18 12:14:21
+-7 u M%sT 2003 O 26 2
+-6 u C%sT
+Z America/North_Dakota/Beulah -6:47:7 - LMT 1883 N 18 12:12:53
+-7 u M%sT 2010 N 7 2
+-6 u C%sT
+R De 1920 1921 - Mar lastSu 2 1 D
+R De 1920 o - O lastSu 2 0 S
+R De 1921 o - May 22 2 0 S
+R De 1965 1966 - Ap lastSu 2 1 D
+R De 1965 1966 - O lastSu 2 0 S
+Z America/Denver -6:59:56 - LMT 1883 N 18 12:0:4
+-7 u M%sT 1920
+-7 De M%sT 1942
+-7 u M%sT 1946
+-7 De M%sT 1967
+-7 u M%sT
+R CA 1948 o - Mar 14 2:1 1 D
+R CA 1949 o - Ja 1 2 0 S
+R CA 1950 1966 - Ap lastSu 1 1 D
+R CA 1950 1961 - S lastSu 2 0 S
+R CA 1962 1966 - O lastSu 2 0 S
+Z America/Los_Angeles -7:52:58 - LMT 1883 N 18 12:7:2
+-8 u P%sT 1946
+-8 CA P%sT 1967
+-8 u P%sT
+Z America/Juneau 15:2:19 - LMT 1867 O 19 15:33:32
+-8:57:41 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1980 Ap 27 2
+-9 u Y%sT 1980 O 26 2
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Sitka 14:58:47 - LMT 1867 O 19 15:30
+-9:1:13 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Metlakatla 15:13:42 - LMT 1867 O 19 15:44:55
+-8:46:18 - LMT 1900 Au 20 12
+-8 - PST 1942
+-8 u P%sT 1946
+-8 - PST 1969
+-8 u P%sT 1983 O 30 2
+-8 - PST 2015 N 1 2
+-9 u AK%sT 2018 N 4 2
+-8 - PST 2019 Ja 20 2
+-9 u AK%sT
+Z America/Yakutat 14:41:5 - LMT 1867 O 19 15:12:18
+-9:18:55 - LMT 1900 Au 20 12
+-9 - YST 1942
+-9 u Y%sT 1946
+-9 - YST 1969
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Anchorage 14:0:24 - LMT 1867 O 19 14:31:37
+-9:59:36 - LMT 1900 Au 20 12
+-10 - AST 1942
+-10 u A%sT 1967 Ap
+-10 - AHST 1969
+-10 u AH%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Nome 12:58:22 - LMT 1867 O 19 13:29:35
+-11:1:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-9 u Y%sT 1983 N 30
+-9 u AK%sT
+Z America/Adak 12:13:22 - LMT 1867 O 19 12:44:35
+-11:46:38 - LMT 1900 Au 20 12
+-11 - NST 1942
+-11 u N%sT 1946
+-11 - NST 1967 Ap
+-11 - BST 1969
+-11 u B%sT 1983 O 30 2
+-10 u AH%sT 1983 N 30
+-10 u H%sT
+Z Pacific/Honolulu -10:31:26 - LMT 1896 Ja 13 12
+-10:30 - HST 1933 Ap 30 2
+-10:30 1 HDT 1933 May 21 12
+-10:30 u H%sT 1947 Jun 8 2
+-10 - HST
+Z America/Phoenix -7:28:18 - LMT 1883 N 18 11:31:42
+-7 u M%sT 1944 Ja 1 0:1
+-7 - MST 1944 Ap 1 0:1
+-7 u M%sT 1944 O 1 0:1
+-7 - MST 1967
+-7 u M%sT 1968 Mar 21
+-7 - MST
+Z America/Boise -7:44:49 - LMT 1883 N 18 12:15:11
+-8 u P%sT 1923 May 13 2
+-7 u M%sT 1974
+-7 - MST 1974 F 3 2
+-7 u M%sT
+R In 1941 o - Jun 22 2 1 D
+R In 1941 1954 - S lastSu 2 0 S
+R In 1946 1954 - Ap lastSu 2 1 D
+Z America/Indiana/Indianapolis -5:44:38 - LMT 1883 N 18 12:15:22
+-6 u C%sT 1920
+-6 In C%sT 1942
+-6 u C%sT 1946
+-6 In C%sT 1955 Ap 24 2
+-5 - EST 1957 S 29 2
+-6 - CST 1958 Ap 27 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006
+-5 u E%sT
+R Ma 1951 o - Ap lastSu 2 1 D
+R Ma 1951 o - S lastSu 2 0 S
+R Ma 1954 1960 - Ap lastSu 2 1 D
+R Ma 1954 1960 - S lastSu 2 0 S
+Z America/Indiana/Marengo -5:45:23 - LMT 1883 N 18 12:14:37
+-6 u C%sT 1951
+-6 Ma C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT 1976
+-5 - EST 2006
+-5 u E%sT
+R V 1946 o - Ap lastSu 2 1 D
+R V 1946 o - S lastSu 2 0 S
+R V 1953 1954 - Ap lastSu 2 1 D
+R V 1953 1959 - S lastSu 2 0 S
+R V 1955 o - May 1 0 1 D
+R V 1956 1963 - Ap lastSu 2 1 D
+R V 1960 o - O lastSu 2 0 S
+R V 1961 o - S lastSu 2 0 S
+R V 1962 1963 - O lastSu 2 0 S
+Z America/Indiana/Vincennes -5:50:7 - LMT 1883 N 18 12:9:53
+-6 u C%sT 1946
+-6 V C%sT 1964 Ap 26 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+R Pe 1955 o - May 1 0 1 D
+R Pe 1955 1960 - S lastSu 2 0 S
+R Pe 1956 1963 - Ap lastSu 2 1 D
+R Pe 1961 1963 - O lastSu 2 0 S
+Z America/Indiana/Tell_City -5:47:3 - LMT 1883 N 18 12:12:57
+-6 u C%sT 1946
+-6 Pe C%sT 1964 Ap 26 2
+-5 - EST 1967 O 29 2
+-6 u C%sT 1969 Ap 27 2
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+R Pi 1955 o - May 1 0 1 D
+R Pi 1955 1960 - S lastSu 2 0 S
+R Pi 1956 1964 - Ap lastSu 2 1 D
+R Pi 1961 1964 - O lastSu 2 0 S
+Z America/Indiana/Petersburg -5:49:7 - LMT 1883 N 18 12:10:53
+-6 u C%sT 1955
+-6 Pi C%sT 1965 Ap 25 2
+-5 - EST 1966 O 30 2
+-6 u C%sT 1977 O 30 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 N 4 2
+-5 u E%sT
+R St 1947 1961 - Ap lastSu 2 1 D
+R St 1947 1954 - S lastSu 2 0 S
+R St 1955 1956 - O lastSu 2 0 S
+R St 1957 1958 - S lastSu 2 0 S
+R St 1959 1961 - O lastSu 2 0 S
+Z America/Indiana/Knox -5:46:30 - LMT 1883 N 18 12:13:30
+-6 u C%sT 1947
+-6 St C%sT 1962 Ap 29 2
+-5 - EST 1963 O 27 2
+-6 u C%sT 1991 O 27 2
+-5 - EST 2006 Ap 2 2
+-6 u C%sT
+R Pu 1946 1960 - Ap lastSu 2 1 D
+R Pu 1946 1954 - S lastSu 2 0 S
+R Pu 1955 1956 - O lastSu 2 0 S
+R Pu 1957 1960 - S lastSu 2 0 S
+Z America/Indiana/Winamac -5:46:25 - LMT 1883 N 18 12:13:35
+-6 u C%sT 1946
+-6 Pu C%sT 1961 Ap 30 2
+-5 - EST 1969
+-5 u E%sT 1971
+-5 - EST 2006 Ap 2 2
+-6 u C%sT 2007 Mar 11 2
+-5 u E%sT
+Z America/Indiana/Vevay -5:40:16 - LMT 1883 N 18 12:19:44
+-6 u C%sT 1954 Ap 25 2
+-5 - EST 1969
+-5 u E%sT 1973
+-5 - EST 2006
+-5 u E%sT
+R v 1921 o - May 1 2 1 D
+R v 1921 o - S 1 2 0 S
+R v 1941 o - Ap lastSu 2 1 D
+R v 1941 o - S lastSu 2 0 S
+R v 1946 o - Ap lastSu 0:1 1 D
+R v 1946 o - Jun 2 2 0 S
+R v 1950 1961 - Ap lastSu 2 1 D
+R v 1950 1955 - S lastSu 2 0 S
+R v 1956 1961 - O lastSu 2 0 S
+Z America/Kentucky/Louisville -5:43:2 - LMT 1883 N 18 12:16:58
+-6 u C%sT 1921
+-6 v C%sT 1942
+-6 u C%sT 1946
+-6 v C%sT 1961 Jul 23 2
+-5 - EST 1968
+-5 u E%sT 1974 Ja 6 2
+-6 1 CDT 1974 O 27 2
+-5 u E%sT
+Z America/Kentucky/Monticello -5:39:24 - LMT 1883 N 18 12:20:36
+-6 u C%sT 1946
+-6 - CST 1968
+-6 u C%sT 2000 O 29 2
+-5 u E%sT
+R Dt 1948 o - Ap lastSu 2 1 D
+R Dt 1948 o - S lastSu 2 0 S
+Z America/Detroit -5:32:11 - LMT 1905
+-6 - CST 1915 May 15 2
+-5 - EST 1942
+-5 u E%sT 1946
+-5 Dt E%sT 1967 Jun 14 0:1
+-5 u E%sT 1969
+-5 - EST 1973
+-5 u E%sT 1975
+-5 - EST 1975 Ap 27 2
+-5 u E%sT
+R Me 1946 o - Ap lastSu 2 1 D
+R Me 1946 o - S lastSu 2 0 S
+R Me 1966 o - Ap lastSu 2 1 D
+R Me 1966 o - O lastSu 2 0 S
+Z America/Menominee -5:50:27 - LMT 1885 S 18 12
+-6 u C%sT 1946
+-6 Me C%sT 1969 Ap 27 2
+-5 - EST 1973 Ap 29 2
+-6 u C%sT
+R C 1918 o - Ap 14 2 1 D
+R C 1918 o - O 27 2 0 S
+R C 1942 o - F 9 2 1 W
+R C 1945 o - Au 14 23u 1 P
+R C 1945 o - S 30 2 0 S
+R C 1974 1986 - Ap lastSu 2 1 D
+R C 1974 2006 - O lastSu 2 0 S
+R C 1987 2006 - Ap Su>=1 2 1 D
+R C 2007 ma - Mar Su>=8 2 1 D
+R C 2007 ma - N Su>=1 2 0 S
+R j 1917 o - Ap 8 2 1 D
+R j 1917 o - S 17 2 0 S
+R j 1919 o - May 5 23 1 D
+R j 1919 o - Au 12 23 0 S
+R j 1920 1935 - May Su>=1 23 1 D
+R j 1920 1935 - O lastSu 23 0 S
+R j 1936 1941 - May M>=9 0 1 D
+R j 1936 1941 - O M>=2 0 0 S
+R j 1946 1950 - May Su>=8 2 1 D
+R j 1946 1950 - O Su>=2 2 0 S
+R j 1951 1986 - Ap lastSu 2 1 D
+R j 1951 1959 - S lastSu 2 0 S
+R j 1960 1986 - O lastSu 2 0 S
+R j 1987 o - Ap Su>=1 0:1 1 D
+R j 1987 2006 - O lastSu 0:1 0 S
+R j 1988 o - Ap Su>=1 0:1 2 DD
+R j 1989 2006 - Ap Su>=1 0:1 1 D
+R j 2007 2011 - Mar Su>=8 0:1 1 D
+R j 2007 2010 - N Su>=1 0:1 0 S
+Z America/St_Johns -3:30:52 - LMT 1884
+-3:30:52 j N%sT 1918
+-3:30:52 C N%sT 1919
+-3:30:52 j N%sT 1935 Mar 30
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 2011 N
+-3:30 C N%sT
+Z America/Goose_Bay -4:1:40 - LMT 1884
+-3:30:52 - NST 1918
+-3:30:52 C N%sT 1919
+-3:30:52 - NST 1935 Mar 30
+-3:30 - NST 1936
+-3:30 j N%sT 1942 May 11
+-3:30 C N%sT 1946
+-3:30 j N%sT 1966 Mar 15 2
+-4 j A%sT 2011 N
+-4 C A%sT
+R H 1916 o - Ap 1 0 1 D
+R H 1916 o - O 1 0 0 S
+R H 1920 o - May 9 0 1 D
+R H 1920 o - Au 29 0 0 S
+R H 1921 o - May 6 0 1 D
+R H 1921 1922 - S 5 0 0 S
+R H 1922 o - Ap 30 0 1 D
+R H 1923 1925 - May Su>=1 0 1 D
+R H 1923 o - S 4 0 0 S
+R H 1924 o - S 15 0 0 S
+R H 1925 o - S 28 0 0 S
+R H 1926 o - May 16 0 1 D
+R H 1926 o - S 13 0 0 S
+R H 1927 o - May 1 0 1 D
+R H 1927 o - S 26 0 0 S
+R H 1928 1931 - May Su>=8 0 1 D
+R H 1928 o - S 9 0 0 S
+R H 1929 o - S 3 0 0 S
+R H 1930 o - S 15 0 0 S
+R H 1931 1932 - S M>=24 0 0 S
+R H 1932 o - May 1 0 1 D
+R H 1933 o - Ap 30 0 1 D
+R H 1933 o - O 2 0 0 S
+R H 1934 o - May 20 0 1 D
+R H 1934 o - S 16 0 0 S
+R H 1935 o - Jun 2 0 1 D
+R H 1935 o - S 30 0 0 S
+R H 1936 o - Jun 1 0 1 D
+R H 1936 o - S 14 0 0 S
+R H 1937 1938 - May Su>=1 0 1 D
+R H 1937 1941 - S M>=24 0 0 S
+R H 1939 o - May 28 0 1 D
+R H 1940 1941 - May Su>=1 0 1 D
+R H 1946 1949 - Ap lastSu 2 1 D
+R H 1946 1949 - S lastSu 2 0 S
+R H 1951 1954 - Ap lastSu 2 1 D
+R H 1951 1954 - S lastSu 2 0 S
+R H 1956 1959 - Ap lastSu 2 1 D
+R H 1956 1959 - S lastSu 2 0 S
+R H 1962 1973 - Ap lastSu 2 1 D
+R H 1962 1973 - O lastSu 2 0 S
+Z America/Halifax -4:14:24 - LMT 1902 Jun 15
+-4 H A%sT 1918
+-4 C A%sT 1919
+-4 H A%sT 1942 F 9 2s
+-4 C A%sT 1946
+-4 H A%sT 1974
+-4 C A%sT
+Z America/Glace_Bay -3:59:48 - LMT 1902 Jun 15
+-4 C A%sT 1953
+-4 H A%sT 1954
+-4 - AST 1972
+-4 H A%sT 1974
+-4 C A%sT
+R o 1933 1935 - Jun Su>=8 1 1 D
+R o 1933 1935 - S Su>=8 1 0 S
+R o 1936 1938 - Jun Su>=1 1 1 D
+R o 1936 1938 - S Su>=1 1 0 S
+R o 1939 o - May 27 1 1 D
+R o 1939 1941 - S Sa>=21 1 0 S
+R o 1940 o - May 19 1 1 D
+R o 1941 o - May 4 1 1 D
+R o 1946 1972 - Ap lastSu 2 1 D
+R o 1946 1956 - S lastSu 2 0 S
+R o 1957 1972 - O lastSu 2 0 S
+R o 1993 2006 - Ap Su>=1 0:1 1 D
+R o 1993 2006 - O lastSu 0:1 0 S
+Z America/Moncton -4:19:8 - LMT 1883 D 9
+-5 - EST 1902 Jun 15
+-4 C A%sT 1933
+-4 o A%sT 1942
+-4 C A%sT 1946
+-4 o A%sT 1973
+-4 C A%sT 1993
+-4 o A%sT 2007
+-4 C A%sT
+Z America/Blanc-Sablon -3:48:28 - LMT 1884
+-4 C A%sT 1970
+-4 - AST
+R t 1919 o - Mar 30 23:30 1 D
+R t 1919 o - O 26 0 0 S
+R t 1920 o - May 2 2 1 D
+R t 1920 o - S 26 0 0 S
+R t 1921 o - May 15 2 1 D
+R t 1921 o - S 15 2 0 S
+R t 1922 1923 - May Su>=8 2 1 D
+R t 1922 1926 - S Su>=15 2 0 S
+R t 1924 1927 - May Su>=1 2 1 D
+R t 1927 1937 - S Su>=25 2 0 S
+R t 1928 1937 - Ap Su>=25 2 1 D
+R t 1938 1940 - Ap lastSu 2 1 D
+R t 1938 1939 - S lastSu 2 0 S
+R t 1945 1946 - S lastSu 2 0 S
+R t 1946 o - Ap lastSu 2 1 D
+R t 1947 1949 - Ap lastSu 0 1 D
+R t 1947 1948 - S lastSu 0 0 S
+R t 1949 o - N lastSu 0 0 S
+R t 1950 1973 - Ap lastSu 2 1 D
+R t 1950 o - N lastSu 2 0 S
+R t 1951 1956 - S lastSu 2 0 S
+R t 1957 1973 - O lastSu 2 0 S
+Z America/Toronto -5:17:32 - LMT 1895
+-5 C E%sT 1919
+-5 t E%sT 1942 F 9 2s
+-5 C E%sT 1946
+-5 t E%sT 1974
+-5 C E%sT
+Z America/Thunder_Bay -5:57 - LMT 1895
+-6 - CST 1910
+-5 - EST 1942
+-5 C E%sT 1970
+-5 t E%sT 1973
+-5 - EST 1974
+-5 C E%sT
+Z America/Nipigon -5:53:4 - LMT 1895
+-5 C E%sT 1940 S 29
+-5 1 EDT 1942 F 9 2s
+-5 C E%sT
+Z America/Rainy_River -6:18:16 - LMT 1895
+-6 C C%sT 1940 S 29
+-6 1 CDT 1942 F 9 2s
+-6 C C%sT
+Z America/Atikokan -6:6:28 - LMT 1895
+-6 C C%sT 1940 S 29
+-6 1 CDT 1942 F 9 2s
+-6 C C%sT 1945 S 30 2
+-5 - EST
+R W 1916 o - Ap 23 0 1 D
+R W 1916 o - S 17 0 0 S
+R W 1918 o - Ap 14 2 1 D
+R W 1918 o - O 27 2 0 S
+R W 1937 o - May 16 2 1 D
+R W 1937 o - S 26 2 0 S
+R W 1942 o - F 9 2 1 W
+R W 1945 o - Au 14 23u 1 P
+R W 1945 o - S lastSu 2 0 S
+R W 1946 o - May 12 2 1 D
+R W 1946 o - O 13 2 0 S
+R W 1947 1949 - Ap lastSu 2 1 D
+R W 1947 1949 - S lastSu 2 0 S
+R W 1950 o - May 1 2 1 D
+R W 1950 o - S 30 2 0 S
+R W 1951 1960 - Ap lastSu 2 1 D
+R W 1951 1958 - S lastSu 2 0 S
+R W 1959 o - O lastSu 2 0 S
+R W 1960 o - S lastSu 2 0 S
+R W 1963 o - Ap lastSu 2 1 D
+R W 1963 o - S 22 2 0 S
+R W 1966 1986 - Ap lastSu 2s 1 D
+R W 1966 2005 - O lastSu 2s 0 S
+R W 1987 2005 - Ap Su>=1 2s 1 D
+Z America/Winnipeg -6:28:36 - LMT 1887 Jul 16
+-6 W C%sT 2006
+-6 C C%sT
+R r 1918 o - Ap 14 2 1 D
+R r 1918 o - O 27 2 0 S
+R r 1930 1934 - May Su>=1 0 1 D
+R r 1930 1934 - O Su>=1 0 0 S
+R r 1937 1941 - Ap Su>=8 0 1 D
+R r 1937 o - O Su>=8 0 0 S
+R r 1938 o - O Su>=1 0 0 S
+R r 1939 1941 - O Su>=8 0 0 S
+R r 1942 o - F 9 2 1 W
+R r 1945 o - Au 14 23u 1 P
+R r 1945 o - S lastSu 2 0 S
+R r 1946 o - Ap Su>=8 2 1 D
+R r 1946 o - O Su>=8 2 0 S
+R r 1947 1957 - Ap lastSu 2 1 D
+R r 1947 1957 - S lastSu 2 0 S
+R r 1959 o - Ap lastSu 2 1 D
+R r 1959 o - O lastSu 2 0 S
+R Sw 1957 o - Ap lastSu 2 1 D
+R Sw 1957 o - O lastSu 2 0 S
+R Sw 1959 1961 - Ap lastSu 2 1 D
+R Sw 1959 o - O lastSu 2 0 S
+R Sw 1960 1961 - S lastSu 2 0 S
+Z America/Regina -6:58:36 - LMT 1905 S
+-7 r M%sT 1960 Ap lastSu 2
+-6 - CST
+Z America/Swift_Current -7:11:20 - LMT 1905 S
+-7 C M%sT 1946 Ap lastSu 2
+-7 r M%sT 1950
+-7 Sw M%sT 1972 Ap lastSu 2
+-6 - CST
+R Ed 1918 1919 - Ap Su>=8 2 1 D
+R Ed 1918 o - O 27 2 0 S
+R Ed 1919 o - May 27 2 0 S
+R Ed 1920 1923 - Ap lastSu 2 1 D
+R Ed 1920 o - O lastSu 2 0 S
+R Ed 1921 1923 - S lastSu 2 0 S
+R Ed 1942 o - F 9 2 1 W
+R Ed 1945 o - Au 14 23u 1 P
+R Ed 1945 o - S lastSu 2 0 S
+R Ed 1947 o - Ap lastSu 2 1 D
+R Ed 1947 o - S lastSu 2 0 S
+R Ed 1972 1986 - Ap lastSu 2 1 D
+R Ed 1972 2006 - O lastSu 2 0 S
+Z America/Edmonton -7:33:52 - LMT 1906 S
+-7 Ed M%sT 1987
+-7 C M%sT
+R Va 1918 o - Ap 14 2 1 D
+R Va 1918 o - O 27 2 0 S
+R Va 1942 o - F 9 2 1 W
+R Va 1945 o - Au 14 23u 1 P
+R Va 1945 o - S 30 2 0 S
+R Va 1946 1986 - Ap lastSu 2 1 D
+R Va 1946 o - S 29 2 0 S
+R Va 1947 1961 - S lastSu 2 0 S
+R Va 1962 2006 - O lastSu 2 0 S
+Z America/Vancouver -8:12:28 - LMT 1884
+-8 Va P%sT 1987
+-8 C P%sT
+Z America/Dawson_Creek -8:0:56 - LMT 1884
+-8 C P%sT 1947
+-8 Va P%sT 1972 Au 30 2
+-7 - MST
+Z America/Fort_Nelson -8:10:47 - LMT 1884
+-8 Va P%sT 1946
+-8 - PST 1947
+-8 Va P%sT 1987
+-8 C P%sT 2015 Mar 8 2
+-7 - MST
+Z America/Creston -7:46:4 - LMT 1884
+-7 - MST 1916 O
+-8 - PST 1918 Jun 2
+-7 - MST
+R Y 1918 o - Ap 14 2 1 D
+R Y 1918 o - O 27 2 0 S
+R Y 1919 o - May 25 2 1 D
+R Y 1919 o - N 1 0 0 S
+R Y 1942 o - F 9 2 1 W
+R Y 1945 o - Au 14 23u 1 P
+R Y 1945 o - S 30 2 0 S
+R Y 1965 o - Ap lastSu 0 2 DD
+R Y 1965 o - O lastSu 2 0 S
+R Y 1980 1986 - Ap lastSu 2 1 D
+R Y 1980 2006 - O lastSu 2 0 S
+R Y 1987 2006 - Ap Su>=1 2 1 D
+Z America/Pangnirtung 0 - -00 1921
+-4 Y A%sT 1995 Ap Su>=1 2
+-5 C E%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 C E%sT
+Z America/Iqaluit 0 - -00 1942 Au
+-5 Y E%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 C E%sT
+Z America/Resolute 0 - -00 1947 Au 31
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT 2006 O 29 2
+-5 - EST 2007 Mar 11 3
+-6 C C%sT
+Z America/Rankin_Inlet 0 - -00 1957
+-6 Y C%sT 2000 O 29 2
+-5 - EST 2001 Ap 1 3
+-6 C C%sT
+Z America/Cambridge_Bay 0 - -00 1920
+-7 Y M%sT 1999 O 31 2
+-6 C C%sT 2000 O 29 2
+-5 - EST 2000 N 5
+-6 - CST 2001 Ap 1 3
+-7 C M%sT
+Z America/Yellowknife 0 - -00 1935
+-7 Y M%sT 1980
+-7 C M%sT
+Z America/Inuvik 0 - -00 1953
+-8 Y P%sT 1979 Ap lastSu 2
+-7 Y M%sT 1980
+-7 C M%sT
+Z America/Whitehorse -9:0:12 - LMT 1900 Au 20
+-9 Y Y%sT 1967 May 28
+-8 Y P%sT 1980
+-8 C P%sT 2020 N
+-7 - MST
+Z America/Dawson -9:17:40 - LMT 1900 Au 20
+-9 Y Y%sT 1973 O 28
+-8 Y P%sT 1980
+-8 C P%sT 2020 N
+-7 - MST
+R m 1939 o - F 5 0 1 D
+R m 1939 o - Jun 25 0 0 S
+R m 1940 o - D 9 0 1 D
+R m 1941 o - Ap 1 0 0 S
+R m 1943 o - D 16 0 1 W
+R m 1944 o - May 1 0 0 S
+R m 1950 o - F 12 0 1 D
+R m 1950 o - Jul 30 0 0 S
+R m 1996 2000 - Ap Su>=1 2 1 D
+R m 1996 2000 - O lastSu 2 0 S
+R m 2001 o - May Su>=1 2 1 D
+R m 2001 o - S lastSu 2 0 S
+R m 2002 ma - Ap Su>=1 2 1 D
+R m 2002 ma - O lastSu 2 0 S
+Z America/Cancun -5:47:4 - LMT 1922 Ja 1 0:12:56
+-6 - CST 1981 D 23
+-5 m E%sT 1998 Au 2 2
+-6 m C%sT 2015 F 1 2
+-5 - EST
+Z America/Merida -5:58:28 - LMT 1922 Ja 1 0:1:32
+-6 - CST 1981 D 23
+-5 - EST 1982 D 2
+-6 m C%sT
+Z America/Matamoros -6:40 - LMT 1921 D 31 23:20
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT 2010
+-6 u C%sT
+Z America/Monterrey -6:41:16 - LMT 1921 D 31 23:18:44
+-6 - CST 1988
+-6 u C%sT 1989
+-6 m C%sT
+Z America/Mexico_City -6:36:36 - LMT 1922 Ja 1 0:23:24
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 m C%sT 2001 S 30 2
+-6 - CST 2002 F 20
+-6 m C%sT
+Z America/Ojinaga -6:57:40 - LMT 1922 Ja 1 0:2:20
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT 2010
+-7 u M%sT
+Z America/Chihuahua -7:4:20 - LMT 1921 D 31 23:55:40
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 - CST 1996
+-6 m C%sT 1998
+-6 - CST 1998 Ap Su>=1 3
+-7 m M%sT
+Z America/Hermosillo -7:23:52 - LMT 1921 D 31 23:36:8
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 1999
+-7 - MST
+Z America/Mazatlan -7:5:40 - LMT 1921 D 31 23:54:20
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT
+Z America/Bahia_Banderas -7:1 - LMT 1921 D 31 23:59
+-7 - MST 1927 Jun 10 23
+-6 - CST 1930 N 15
+-7 - MST 1931 May 1 23
+-6 - CST 1931 O
+-7 - MST 1932 Ap
+-6 - CST 1942 Ap 24
+-7 - MST 1949 Ja 14
+-8 - PST 1970
+-7 m M%sT 2010 Ap 4 2
+-6 m C%sT
+Z America/Tijuana -7:48:4 - LMT 1922 Ja 1 0:11:56
+-7 - MST 1924
+-8 - PST 1927 Jun 10 23
+-7 - MST 1930 N 15
+-8 - PST 1931 Ap
+-8 1 PDT 1931 S 30
+-8 - PST 1942 Ap 24
+-8 1 PWT 1945 Au 14 23u
+-8 1 PPT 1945 N 12
+-8 - PST 1948 Ap 5
+-8 1 PDT 1949 Ja 14
+-8 - PST 1954
+-8 CA P%sT 1961
+-8 - PST 1976
+-8 u P%sT 1996
+-8 m P%sT 2001
+-8 u P%sT 2002 F 20
+-8 m P%sT 2010
+-8 u P%sT
+R BS 1942 o - May 1 24 1 W
+R BS 1944 o - D 31 24 0 S
+R BS 1945 o - F 1 0 1 W
+R BS 1945 o - Au 14 23u 1 P
+R BS 1945 o - O 17 24 0 S
+R BS 1964 1975 - O lastSu 2 0 S
+R BS 1964 1975 - Ap lastSu 2 1 D
+Z America/Nassau -5:9:30 - LMT 1912 Mar 2
+-5 BS E%sT 1976
+-5 u E%sT
+R BB 1977 o - Jun 12 2 1 D
+R BB 1977 1978 - O Su>=1 2 0 S
+R BB 1978 1980 - Ap Su>=15 2 1 D
+R BB 1979 o - S 30 2 0 S
+R BB 1980 o - S 25 2 0 S
+Z America/Barbados -3:58:29 - LMT 1924
+-3:58:29 - BMT 1932
+-4 BB A%sT
+R BZ 1918 1941 - O Sa>=1 24 0:30 -0530
+R BZ 1919 1942 - F Sa>=8 24 0 CST
+R BZ 1942 o - Jun 27 24 1 CWT
+R BZ 1945 o - Au 14 23u 1 CPT
+R BZ 1945 o - D 15 24 0 CST
+R BZ 1947 1967 - O Sa>=1 24 0:30 -0530
+R BZ 1948 1968 - F Sa>=8 24 0 CST
+R BZ 1973 o - D 5 0 1 CDT
+R BZ 1974 o - F 9 0 0 CST
+R BZ 1982 o - D 18 0 1 CDT
+R BZ 1983 o - F 12 0 0 CST
+Z America/Belize -5:52:48 - LMT 1912 Ap
+-6 BZ %s
+R Be 1917 o - Ap 5 24 1 -
+R Be 1917 o - S 30 24 0 -
+R Be 1918 o - Ap 13 24 1 -
+R Be 1918 o - S 15 24 0 S
+R Be 1942 o - Ja 11 2 1 D
+R Be 1942 o - O 18 2 0 S
+R Be 1943 o - Mar 21 2 1 D
+R Be 1943 o - O 31 2 0 S
+R Be 1944 1945 - Mar Su>=8 2 1 D
+R Be 1944 1945 - N Su>=1 2 0 S
+R Be 1947 o - May Su>=15 2 1 D
+R Be 1947 o - S Su>=8 2 0 S
+R Be 1948 1952 - May Su>=22 2 1 D
+R Be 1948 1952 - S Su>=1 2 0 S
+R Be 1956 o - May Su>=22 2 1 D
+R Be 1956 o - O lastSu 2 0 S
+Z Atlantic/Bermuda -4:19:18 - LMT 1890
+-4:19:18 Be BMT/BST 1930 Ja 1 2
+-4 Be A%sT 1974 Ap 28 2
+-4 C A%sT 1976
+-4 u A%sT
+R CR 1979 1980 - F lastSu 0 1 D
+R CR 1979 1980 - Jun Su>=1 0 0 S
+R CR 1991 1992 - Ja Sa>=15 0 1 D
+R CR 1991 o - Jul 1 0 0 S
+R CR 1992 o - Mar 15 0 0 S
+Z America/Costa_Rica -5:36:13 - LMT 1890
+-5:36:13 - SJMT 1921 Ja 15
+-6 CR C%sT
+R Q 1928 o - Jun 10 0 1 D
+R Q 1928 o - O 10 0 0 S
+R Q 1940 1942 - Jun Su>=1 0 1 D
+R Q 1940 1942 - S Su>=1 0 0 S
+R Q 1945 1946 - Jun Su>=1 0 1 D
+R Q 1945 1946 - S Su>=1 0 0 S
+R Q 1965 o - Jun 1 0 1 D
+R Q 1965 o - S 30 0 0 S
+R Q 1966 o - May 29 0 1 D
+R Q 1966 o - O 2 0 0 S
+R Q 1967 o - Ap 8 0 1 D
+R Q 1967 1968 - S Su>=8 0 0 S
+R Q 1968 o - Ap 14 0 1 D
+R Q 1969 1977 - Ap lastSu 0 1 D
+R Q 1969 1971 - O lastSu 0 0 S
+R Q 1972 1974 - O 8 0 0 S
+R Q 1975 1977 - O lastSu 0 0 S
+R Q 1978 o - May 7 0 1 D
+R Q 1978 1990 - O Su>=8 0 0 S
+R Q 1979 1980 - Mar Su>=15 0 1 D
+R Q 1981 1985 - May Su>=5 0 1 D
+R Q 1986 1989 - Mar Su>=14 0 1 D
+R Q 1990 1997 - Ap Su>=1 0 1 D
+R Q 1991 1995 - O Su>=8 0s 0 S
+R Q 1996 o - O 6 0s 0 S
+R Q 1997 o - O 12 0s 0 S
+R Q 1998 1999 - Mar lastSu 0s 1 D
+R Q 1998 2003 - O lastSu 0s 0 S
+R Q 2000 2003 - Ap Su>=1 0s 1 D
+R Q 2004 o - Mar lastSu 0s 1 D
+R Q 2006 2010 - O lastSu 0s 0 S
+R Q 2007 o - Mar Su>=8 0s 1 D
+R Q 2008 o - Mar Su>=15 0s 1 D
+R Q 2009 2010 - Mar Su>=8 0s 1 D
+R Q 2011 o - Mar Su>=15 0s 1 D
+R Q 2011 o - N 13 0s 0 S
+R Q 2012 o - Ap 1 0s 1 D
+R Q 2012 ma - N Su>=1 0s 0 S
+R Q 2013 ma - Mar Su>=8 0s 1 D
+Z America/Havana -5:29:28 - LMT 1890
+-5:29:36 - HMT 1925 Jul 19 12
+-5 Q C%sT
+R DO 1966 o - O 30 0 1 EDT
+R DO 1967 o - F 28 0 0 EST
+R DO 1969 1973 - O lastSu 0 0:30 -0430
+R DO 1970 o - F 21 0 0 EST
+R DO 1971 o - Ja 20 0 0 EST
+R DO 1972 1974 - Ja 21 0 0 EST
+Z America/Santo_Domingo -4:39:36 - LMT 1890
+-4:40 - SDMT 1933 Ap 1 12
+-5 DO %s 1974 O 27
+-4 - AST 2000 O 29 2
+-5 u E%sT 2000 D 3 1
+-4 - AST
+R SV 1987 1988 - May Su>=1 0 1 D
+R SV 1987 1988 - S lastSu 0 0 S
+Z America/El_Salvador -5:56:48 - LMT 1921
+-6 SV C%sT
+R GT 1973 o - N 25 0 1 D
+R GT 1974 o - F 24 0 0 S
+R GT 1983 o - May 21 0 1 D
+R GT 1983 o - S 22 0 0 S
+R GT 1991 o - Mar 23 0 1 D
+R GT 1991 o - S 7 0 0 S
+R GT 2006 o - Ap 30 0 1 D
+R GT 2006 o - O 1 0 0 S
+Z America/Guatemala -6:2:4 - LMT 1918 O 5
+-6 GT C%sT
+R HT 1983 o - May 8 0 1 D
+R HT 1984 1987 - Ap lastSu 0 1 D
+R HT 1983 1987 - O lastSu 0 0 S
+R HT 1988 1997 - Ap Su>=1 1s 1 D
+R HT 1988 1997 - O lastSu 1s 0 S
+R HT 2005 2006 - Ap Su>=1 0 1 D
+R HT 2005 2006 - O lastSu 0 0 S
+R HT 2012 2015 - Mar Su>=8 2 1 D
+R HT 2012 2015 - N Su>=1 2 0 S
+R HT 2017 ma - Mar Su>=8 2 1 D
+R HT 2017 ma - N Su>=1 2 0 S
+Z America/Port-au-Prince -4:49:20 - LMT 1890
+-4:49 - PPMT 1917 Ja 24 12
+-5 HT E%sT
+R HN 1987 1988 - May Su>=1 0 1 D
+R HN 1987 1988 - S lastSu 0 0 S
+R HN 2006 o - May Su>=1 0 1 D
+R HN 2006 o - Au M>=1 0 0 S
+Z America/Tegucigalpa -5:48:52 - LMT 1921 Ap
+-6 HN C%sT
+Z America/Jamaica -5:7:10 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1974
+-5 u E%sT 1984
+-5 - EST
+Z America/Martinique -4:4:20 - LMT 1890
+-4:4:20 - FFMT 1911 May
+-4 - AST 1980 Ap 6
+-4 1 ADT 1980 S 28
+-4 - AST
+R NI 1979 1980 - Mar Su>=16 0 1 D
+R NI 1979 1980 - Jun M>=23 0 0 S
+R NI 2005 o - Ap 10 0 1 D
+R NI 2005 o - O Su>=1 0 0 S
+R NI 2006 o - Ap 30 2 1 D
+R NI 2006 o - O Su>=1 1 0 S
+Z America/Managua -5:45:8 - LMT 1890
+-5:45:12 - MMT 1934 Jun 23
+-6 - CST 1973 May
+-5 - EST 1975 F 16
+-6 NI C%sT 1992 Ja 1 4
+-5 - EST 1992 S 24
+-6 - CST 1993
+-5 - EST 1997
+-6 NI C%sT
+Z America/Panama -5:18:8 - LMT 1890
+-5:19:36 - CMT 1908 Ap 22
+-5 - EST
+L America/Panama America/Cayman
+Z America/Puerto_Rico -4:24:25 - LMT 1899 Mar 28 12
+-4 - AST 1942 May 3
+-4 u A%sT 1946
+-4 - AST
+Z America/Miquelon -3:44:40 - LMT 1911 May 15
+-4 - AST 1980 May
+-3 - -03 1987
+-3 C -03/-02
+Z America/Grand_Turk -4:44:32 - LMT 1890
+-5:7:10 - KMT 1912 F
+-5 - EST 1979
+-5 u E%sT 2015 Mar 8 2
+-4 - AST 2018 Mar 11 3
+-5 u E%sT
+R A 1930 o - D 1 0 1 -
+R A 1931 o - Ap 1 0 0 -
+R A 1931 o - O 15 0 1 -
+R A 1932 1940 - Mar 1 0 0 -
+R A 1932 1939 - N 1 0 1 -
+R A 1940 o - Jul 1 0 1 -
+R A 1941 o - Jun 15 0 0 -
+R A 1941 o - O 15 0 1 -
+R A 1943 o - Au 1 0 0 -
+R A 1943 o - O 15 0 1 -
+R A 1946 o - Mar 1 0 0 -
+R A 1946 o - O 1 0 1 -
+R A 1963 o - O 1 0 0 -
+R A 1963 o - D 15 0 1 -
+R A 1964 1966 - Mar 1 0 0 -
+R A 1964 1966 - O 15 0 1 -
+R A 1967 o - Ap 2 0 0 -
+R A 1967 1968 - O Su>=1 0 1 -
+R A 1968 1969 - Ap Su>=1 0 0 -
+R A 1974 o - Ja 23 0 1 -
+R A 1974 o - May 1 0 0 -
+R A 1988 o - D 1 0 1 -
+R A 1989 1993 - Mar Su>=1 0 0 -
+R A 1989 1992 - O Su>=15 0 1 -
+R A 1999 o - O Su>=1 0 1 -
+R A 2000 o - Mar 3 0 0 -
+R A 2007 o - D 30 0 1 -
+R A 2008 2009 - Mar Su>=15 0 0 -
+R A 2008 o - O Su>=15 0 1 -
+Z America/Argentina/Buenos_Aires -3:53:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Cordoba -4:16:48 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02
+Z America/Argentina/Salta -4:21:40 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Tucuman -4:20:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 13
+-3 A -03/-02
+Z America/Argentina/La_Rioja -4:27:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/San_Juan -4:34:4 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar
+-4 - -04 1991 May 7
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Jujuy -4:21:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 28
+-4 1 -03 1991 Mar 17
+-4 - -04 1991 O 6
+-3 1 -02 1992
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Catamarca -4:23:8 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1991 Mar 3
+-4 - -04 1991 O 20
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Mendoza -4:35:16 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990 Mar 4
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 O 15
+-4 1 -03 1992 Mar
+-4 - -04 1992 O 18
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 23
+-4 - -04 2004 S 26
+-3 A -03/-02 2008 O 18
+-3 - -03
+R Sa 2008 2009 - Mar Su>=8 0 0 -
+R Sa 2007 2008 - O Su>=8 0 1 -
+Z America/Argentina/San_Luis -4:25:24 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1990
+-3 1 -02 1990 Mar 14
+-4 - -04 1990 O 15
+-4 1 -03 1991 Mar
+-4 - -04 1991 Jun
+-3 - -03 1999 O 3
+-4 1 -03 2000 Mar 3
+-3 - -03 2004 May 31
+-4 - -04 2004 Jul 25
+-3 A -03/-02 2008 Ja 21
+-4 Sa -04/-03 2009 O 11
+-3 - -03
+Z America/Argentina/Rio_Gallegos -4:36:52 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 Jun
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+Z America/Argentina/Ushuaia -4:33:12 - LMT 1894 O 31
+-4:16:48 - CMT 1920 May
+-4 - -04 1930 D
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1999 O 3
+-4 A -04/-03 2000 Mar 3
+-3 - -03 2004 May 30
+-4 - -04 2004 Jun 20
+-3 A -03/-02 2008 O 18
+-3 - -03
+L America/Curacao America/Aruba
+Z America/La_Paz -4:32:36 - LMT 1890
+-4:32:36 - CMT 1931 O 15
+-4:32:36 1 BST 1932 Mar 21
+-4 - -04
+R B 1931 o - O 3 11 1 -
+R B 1932 1933 - Ap 1 0 0 -
+R B 1932 o - O 3 0 1 -
+R B 1949 1952 - D 1 0 1 -
+R B 1950 o - Ap 16 1 0 -
+R B 1951 1952 - Ap 1 0 0 -
+R B 1953 o - Mar 1 0 0 -
+R B 1963 o - D 9 0 1 -
+R B 1964 o - Mar 1 0 0 -
+R B 1965 o - Ja 31 0 1 -
+R B 1965 o - Mar 31 0 0 -
+R B 1965 o - D 1 0 1 -
+R B 1966 1968 - Mar 1 0 0 -
+R B 1966 1967 - N 1 0 1 -
+R B 1985 o - N 2 0 1 -
+R B 1986 o - Mar 15 0 0 -
+R B 1986 o - O 25 0 1 -
+R B 1987 o - F 14 0 0 -
+R B 1987 o - O 25 0 1 -
+R B 1988 o - F 7 0 0 -
+R B 1988 o - O 16 0 1 -
+R B 1989 o - Ja 29 0 0 -
+R B 1989 o - O 15 0 1 -
+R B 1990 o - F 11 0 0 -
+R B 1990 o - O 21 0 1 -
+R B 1991 o - F 17 0 0 -
+R B 1991 o - O 20 0 1 -
+R B 1992 o - F 9 0 0 -
+R B 1992 o - O 25 0 1 -
+R B 1993 o - Ja 31 0 0 -
+R B 1993 1995 - O Su>=11 0 1 -
+R B 1994 1995 - F Su>=15 0 0 -
+R B 1996 o - F 11 0 0 -
+R B 1996 o - O 6 0 1 -
+R B 1997 o - F 16 0 0 -
+R B 1997 o - O 6 0 1 -
+R B 1998 o - Mar 1 0 0 -
+R B 1998 o - O 11 0 1 -
+R B 1999 o - F 21 0 0 -
+R B 1999 o - O 3 0 1 -
+R B 2000 o - F 27 0 0 -
+R B 2000 2001 - O Su>=8 0 1 -
+R B 2001 2006 - F Su>=15 0 0 -
+R B 2002 o - N 3 0 1 -
+R B 2003 o - O 19 0 1 -
+R B 2004 o - N 2 0 1 -
+R B 2005 o - O 16 0 1 -
+R B 2006 o - N 5 0 1 -
+R B 2007 o - F 25 0 0 -
+R B 2007 o - O Su>=8 0 1 -
+R B 2008 2017 - O Su>=15 0 1 -
+R B 2008 2011 - F Su>=15 0 0 -
+R B 2012 o - F Su>=22 0 0 -
+R B 2013 2014 - F Su>=15 0 0 -
+R B 2015 o - F Su>=22 0 0 -
+R B 2016 2019 - F Su>=15 0 0 -
+R B 2018 o - N Su>=1 0 1 -
+Z America/Noronha -2:9:40 - LMT 1914
+-2 B -02/-01 1990 S 17
+-2 - -02 1999 S 30
+-2 B -02/-01 2000 O 15
+-2 - -02 2001 S 13
+-2 B -02/-01 2002 O
+-2 - -02
+Z America/Belem -3:13:56 - LMT 1914
+-3 B -03/-02 1988 S 12
+-3 - -03
+Z America/Santarem -3:38:48 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 2008 Jun 24
+-3 - -03
+Z America/Fortaleza -2:34 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Recife -2:19:36 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 15
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Araguaina -3:12:48 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 S 14
+-3 B -03/-02 2003 S 24
+-3 - -03 2012 O 21
+-3 B -03/-02 2013 S
+-3 - -03
+Z America/Maceio -2:22:52 - LMT 1914
+-3 B -03/-02 1990 S 17
+-3 - -03 1995 O 13
+-3 B -03/-02 1996 S 4
+-3 - -03 1999 S 30
+-3 B -03/-02 2000 O 22
+-3 - -03 2001 S 13
+-3 B -03/-02 2002 O
+-3 - -03
+Z America/Bahia -2:34:4 - LMT 1914
+-3 B -03/-02 2003 S 24
+-3 - -03 2011 O 16
+-3 B -03/-02 2012 O 21
+-3 - -03
+Z America/Sao_Paulo -3:6:28 - LMT 1914
+-3 B -03/-02 1963 O 23
+-3 1 -02 1964
+-3 B -03/-02
+Z America/Campo_Grande -3:38:28 - LMT 1914
+-4 B -04/-03
+Z America/Cuiaba -3:44:20 - LMT 1914
+-4 B -04/-03 2003 S 24
+-4 - -04 2004 O
+-4 B -04/-03
+Z America/Porto_Velho -4:15:36 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04
+Z America/Boa_Vista -4:2:40 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1999 S 30
+-4 B -04/-03 2000 O 15
+-4 - -04
+Z America/Manaus -4:0:4 - LMT 1914
+-4 B -04/-03 1988 S 12
+-4 - -04 1993 S 28
+-4 B -04/-03 1994 S 22
+-4 - -04
+Z America/Eirunepe -4:39:28 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 1993 S 28
+-5 B -05/-04 1994 S 22
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+Z America/Rio_Branco -4:31:12 - LMT 1914
+-5 B -05/-04 1988 S 12
+-5 - -05 2008 Jun 24
+-4 - -04 2013 N 10
+-5 - -05
+R x 1927 1931 - S 1 0 1 -
+R x 1928 1932 - Ap 1 0 0 -
+R x 1968 o - N 3 4u 1 -
+R x 1969 o - Mar 30 3u 0 -
+R x 1969 o - N 23 4u 1 -
+R x 1970 o - Mar 29 3u 0 -
+R x 1971 o - Mar 14 3u 0 -
+R x 1970 1972 - O Su>=9 4u 1 -
+R x 1972 1986 - Mar Su>=9 3u 0 -
+R x 1973 o - S 30 4u 1 -
+R x 1974 1987 - O Su>=9 4u 1 -
+R x 1987 o - Ap 12 3u 0 -
+R x 1988 1990 - Mar Su>=9 3u 0 -
+R x 1988 1989 - O Su>=9 4u 1 -
+R x 1990 o - S 16 4u 1 -
+R x 1991 1996 - Mar Su>=9 3u 0 -
+R x 1991 1997 - O Su>=9 4u 1 -
+R x 1997 o - Mar 30 3u 0 -
+R x 1998 o - Mar Su>=9 3u 0 -
+R x 1998 o - S 27 4u 1 -
+R x 1999 o - Ap 4 3u 0 -
+R x 1999 2010 - O Su>=9 4u 1 -
+R x 2000 2007 - Mar Su>=9 3u 0 -
+R x 2008 o - Mar 30 3u 0 -
+R x 2009 o - Mar Su>=9 3u 0 -
+R x 2010 o - Ap Su>=1 3u 0 -
+R x 2011 o - May Su>=2 3u 0 -
+R x 2011 o - Au Su>=16 4u 1 -
+R x 2012 2014 - Ap Su>=23 3u 0 -
+R x 2012 2014 - S Su>=2 4u 1 -
+R x 2016 2018 - May Su>=9 3u 0 -
+R x 2016 2018 - Au Su>=9 4u 1 -
+R x 2019 ma - Ap Su>=2 3u 0 -
+R x 2019 ma - S Su>=2 4u 1 -
+Z America/Santiago -4:42:46 - LMT 1890
+-4:42:46 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:46 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:46 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1946 Jul 15
+-4 1 -03 1946 S
+-4 - -04 1947 Ap
+-5 - -05 1947 May 21 23
+-4 x -04/-03
+Z America/Punta_Arenas -4:43:40 - LMT 1890
+-4:42:46 - SMT 1910 Ja 10
+-5 - -05 1916 Jul
+-4:42:46 - SMT 1918 S 10
+-4 - -04 1919 Jul
+-4:42:46 - SMT 1927 S
+-5 x -05/-04 1932 S
+-4 - -04 1942 Jun
+-5 - -05 1942 Au
+-4 - -04 1947 Ap
+-5 - -05 1947 May 21 23
+-4 x -04/-03 2016 D 4
+-3 - -03
+Z Pacific/Easter -7:17:28 - LMT 1890
+-7:17:28 - EMT 1932 S
+-7 x -07/-06 1982 Mar 14 3u
+-6 x -06/-05
+Z Antarctica/Palmer 0 - -00 1965
+-4 A -04/-03 1969 O 5
+-3 A -03/-02 1982 May
+-4 x -04/-03 2016 D 4
+-3 - -03
+R CO 1992 o - May 3 0 1 -
+R CO 1993 o - Ap 4 0 0 -
+Z America/Bogota -4:56:16 - LMT 1884 Mar 13
+-4:56:16 - BMT 1914 N 23
+-5 CO -05/-04
+Z America/Curacao -4:35:47 - LMT 1912 F 12
+-4:30 - -0430 1965
+-4 - AST
+L America/Curacao America/Lower_Princes
+L America/Curacao America/Kralendijk
+R EC 1992 o - N 28 0 1 -
+R EC 1993 o - F 5 0 0 -
+Z America/Guayaquil -5:19:20 - LMT 1890
+-5:14 - QMT 1931
+-5 EC -05/-04
+Z Pacific/Galapagos -5:58:24 - LMT 1931
+-5 - -05 1986
+-6 EC -06/-05
+R FK 1937 1938 - S lastSu 0 1 -
+R FK 1938 1942 - Mar Su>=19 0 0 -
+R FK 1939 o - O 1 0 1 -
+R FK 1940 1942 - S lastSu 0 1 -
+R FK 1943 o - Ja 1 0 0 -
+R FK 1983 o - S lastSu 0 1 -
+R FK 1984 1985 - Ap lastSu 0 0 -
+R FK 1984 o - S 16 0 1 -
+R FK 1985 2000 - S Su>=9 0 1 -
+R FK 1986 2000 - Ap Su>=16 0 0 -
+R FK 2001 2010 - Ap Su>=15 2 0 -
+R FK 2001 2010 - S Su>=1 2 1 -
+Z Atlantic/Stanley -3:51:24 - LMT 1890
+-3:51:24 - SMT 1912 Mar 12
+-4 FK -04/-03 1983 May
+-3 FK -03/-02 1985 S 15
+-4 FK -04/-03 2010 S 5 2
+-3 - -03
+Z America/Cayenne -3:29:20 - LMT 1911 Jul
+-4 - -04 1967 O
+-3 - -03
+Z America/Guyana -3:52:40 - LMT 1915 Mar
+-3:45 - -0345 1975 Jul 31
+-3 - -03 1991
+-4 - -04
+R y 1975 1988 - O 1 0 1 -
+R y 1975 1978 - Mar 1 0 0 -
+R y 1979 1991 - Ap 1 0 0 -
+R y 1989 o - O 22 0 1 -
+R y 1990 o - O 1 0 1 -
+R y 1991 o - O 6 0 1 -
+R y 1992 o - Mar 1 0 0 -
+R y 1992 o - O 5 0 1 -
+R y 1993 o - Mar 31 0 0 -
+R y 1993 1995 - O 1 0 1 -
+R y 1994 1995 - F lastSu 0 0 -
+R y 1996 o - Mar 1 0 0 -
+R y 1996 2001 - O Su>=1 0 1 -
+R y 1997 o - F lastSu 0 0 -
+R y 1998 2001 - Mar Su>=1 0 0 -
+R y 2002 2004 - Ap Su>=1 0 0 -
+R y 2002 2003 - S Su>=1 0 1 -
+R y 2004 2009 - O Su>=15 0 1 -
+R y 2005 2009 - Mar Su>=8 0 0 -
+R y 2010 ma - O Su>=1 0 1 -
+R y 2010 2012 - Ap Su>=8 0 0 -
+R y 2013 ma - Mar Su>=22 0 0 -
+Z America/Asuncion -3:50:40 - LMT 1890
+-3:50:40 - AMT 1931 O 10
+-4 - -04 1972 O
+-3 - -03 1974 Ap
+-4 y -04/-03
+R PE 1938 o - Ja 1 0 1 -
+R PE 1938 o - Ap 1 0 0 -
+R PE 1938 1939 - S lastSu 0 1 -
+R PE 1939 1940 - Mar Su>=24 0 0 -
+R PE 1986 1987 - Ja 1 0 1 -
+R PE 1986 1987 - Ap 1 0 0 -
+R PE 1990 o - Ja 1 0 1 -
+R PE 1990 o - Ap 1 0 0 -
+R PE 1994 o - Ja 1 0 1 -
+R PE 1994 o - Ap 1 0 0 -
+Z America/Lima -5:8:12 - LMT 1890
+-5:8:36 - LMT 1908 Jul 28
+-5 PE -05/-04
+Z Atlantic/South_Georgia -2:26:8 - LMT 1890
+-2 - -02
+Z America/Paramaribo -3:40:40 - LMT 1911
+-3:40:52 - PMT 1935
+-3:40:36 - PMT 1945 O
+-3:30 - -0330 1984 O
+-3 - -03
+Z America/Port_of_Spain -4:6:4 - LMT 1912 Mar 2
+-4 - AST
+L America/Port_of_Spain America/Anguilla
+L America/Port_of_Spain America/Antigua
+L America/Port_of_Spain America/Dominica
+L America/Port_of_Spain America/Grenada
+L America/Port_of_Spain America/Guadeloupe
+L America/Port_of_Spain America/Marigot
+L America/Port_of_Spain America/Montserrat
+L America/Port_of_Spain America/St_Barthelemy
+L America/Port_of_Spain America/St_Kitts
+L America/Port_of_Spain America/St_Lucia
+L America/Port_of_Spain America/St_Thomas
+L America/Port_of_Spain America/St_Vincent
+L America/Port_of_Spain America/Tortola
+R U 1923 1925 - O 1 0 0:30 -
+R U 1924 1926 - Ap 1 0 0 -
+R U 1933 1938 - O lastSu 0 0:30 -
+R U 1934 1941 - Mar lastSa 24 0 -
+R U 1939 o - O 1 0 0:30 -
+R U 1940 o - O 27 0 0:30 -
+R U 1941 o - Au 1 0 0:30 -
+R U 1942 o - D 14 0 0:30 -
+R U 1943 o - Mar 14 0 0 -
+R U 1959 o - May 24 0 0:30 -
+R U 1959 o - N 15 0 0 -
+R U 1960 o - Ja 17 0 1 -
+R U 1960 o - Mar 6 0 0 -
+R U 1965 o - Ap 4 0 1 -
+R U 1965 o - S 26 0 0 -
+R U 1968 o - May 27 0 0:30 -
+R U 1968 o - D 1 0 0 -
+R U 1970 o - Ap 25 0 1 -
+R U 1970 o - Jun 14 0 0 -
+R U 1972 o - Ap 23 0 1 -
+R U 1972 o - Jul 16 0 0 -
+R U 1974 o - Ja 13 0 1:30 -
+R U 1974 o - Mar 10 0 0:30 -
+R U 1974 o - S 1 0 0 -
+R U 1974 o - D 22 0 1 -
+R U 1975 o - Mar 30 0 0 -
+R U 1976 o - D 19 0 1 -
+R U 1977 o - Mar 6 0 0 -
+R U 1977 o - D 4 0 1 -
+R U 1978 1979 - Mar Su>=1 0 0 -
+R U 1978 o - D 17 0 1 -
+R U 1979 o - Ap 29 0 1 -
+R U 1980 o - Mar 16 0 0 -
+R U 1987 o - D 14 0 1 -
+R U 1988 o - F 28 0 0 -
+R U 1988 o - D 11 0 1 -
+R U 1989 o - Mar 5 0 0 -
+R U 1989 o - O 29 0 1 -
+R U 1990 o - F 25 0 0 -
+R U 1990 1991 - O Su>=21 0 1 -
+R U 1991 1992 - Mar Su>=1 0 0 -
+R U 1992 o - O 18 0 1 -
+R U 1993 o - F 28 0 0 -
+R U 2004 o - S 19 0 1 -
+R U 2005 o - Mar 27 2 0 -
+R U 2005 o - O 9 2 1 -
+R U 2006 2015 - Mar Su>=8 2 0 -
+R U 2006 2014 - O Su>=1 2 1 -
+Z America/Montevideo -3:44:51 - LMT 1908 Jun 10
+-3:44:51 - MMT 1920 May
+-4 - -04 1923 O
+-3:30 U -0330/-03 1942 D 14
+-3 U -03/-0230 1960
+-3 U -03/-02 1968
+-3 U -03/-0230 1970
+-3 U -03/-02 1974
+-3 U -03/-0130 1974 Mar 10
+-3 U -03/-0230 1974 D 22
+-3 U -03/-02
+Z America/Caracas -4:27:44 - LMT 1890
+-4:27:40 - CMT 1912 F 12
+-4:30 - -0430 1965
+-4 - -04 2007 D 9 3
+-4:30 - -0430 2016 May 1 2:30
+-4 - -04
+Z Etc/GMT 0 - GMT
+Z Etc/UTC 0 - UTC
+L Etc/GMT GMT
+L Etc/UTC Etc/Universal
+L Etc/UTC Etc/Zulu
+L Etc/GMT Etc/Greenwich
+L Etc/GMT Etc/GMT-0
+L Etc/GMT Etc/GMT+0
+L Etc/GMT Etc/GMT0
+Z Etc/GMT-14 14 - +14
+Z Etc/GMT-13 13 - +13
+Z Etc/GMT-12 12 - +12
+Z Etc/GMT-11 11 - +11
+Z Etc/GMT-10 10 - +10
+Z Etc/GMT-9 9 - +09
+Z Etc/GMT-8 8 - +08
+Z Etc/GMT-7 7 - +07
+Z Etc/GMT-6 6 - +06
+Z Etc/GMT-5 5 - +05
+Z Etc/GMT-4 4 - +04
+Z Etc/GMT-3 3 - +03
+Z Etc/GMT-2 2 - +02
+Z Etc/GMT-1 1 - +01
+Z Etc/GMT+1 -1 - -01
+Z Etc/GMT+2 -2 - -02
+Z Etc/GMT+3 -3 - -03
+Z Etc/GMT+4 -4 - -04
+Z Etc/GMT+5 -5 - -05
+Z Etc/GMT+6 -6 - -06
+Z Etc/GMT+7 -7 - -07
+Z Etc/GMT+8 -8 - -08
+Z Etc/GMT+9 -9 - -09
+Z Etc/GMT+10 -10 - -10
+Z Etc/GMT+11 -11 - -11
+Z Etc/GMT+12 -12 - -12
+Z Factory 0 - -00
+L Africa/Nairobi Africa/Asmera
+L Africa/Abidjan Africa/Timbuktu
+L America/Argentina/Catamarca America/Argentina/ComodRivadavia
+L America/Adak America/Atka
+L America/Argentina/Buenos_Aires America/Buenos_Aires
+L America/Argentina/Catamarca America/Catamarca
+L America/Atikokan America/Coral_Harbour
+L America/Argentina/Cordoba America/Cordoba
+L America/Tijuana America/Ensenada
+L America/Indiana/Indianapolis America/Fort_Wayne
+L America/Nuuk America/Godthab
+L America/Indiana/Indianapolis America/Indianapolis
+L America/Argentina/Jujuy America/Jujuy
+L America/Indiana/Knox America/Knox_IN
+L America/Kentucky/Louisville America/Louisville
+L America/Argentina/Mendoza America/Mendoza
+L America/Toronto America/Montreal
+L America/Rio_Branco America/Porto_Acre
+L America/Argentina/Cordoba America/Rosario
+L America/Tijuana America/Santa_Isabel
+L America/Denver America/Shiprock
+L America/Port_of_Spain America/Virgin
+L Pacific/Auckland Antarctica/South_Pole
+L Asia/Ashgabat Asia/Ashkhabad
+L Asia/Kolkata Asia/Calcutta
+L Asia/Shanghai Asia/Chongqing
+L Asia/Shanghai Asia/Chungking
+L Asia/Dhaka Asia/Dacca
+L Asia/Shanghai Asia/Harbin
+L Asia/Urumqi Asia/Kashgar
+L Asia/Kathmandu Asia/Katmandu
+L Asia/Macau Asia/Macao
+L Asia/Yangon Asia/Rangoon
+L Asia/Ho_Chi_Minh Asia/Saigon
+L Asia/Jerusalem Asia/Tel_Aviv
+L Asia/Thimphu Asia/Thimbu
+L Asia/Makassar Asia/Ujung_Pandang
+L Asia/Ulaanbaatar Asia/Ulan_Bator
+L Atlantic/Faroe Atlantic/Faeroe
+L Europe/Oslo Atlantic/Jan_Mayen
+L Australia/Sydney Australia/ACT
+L Australia/Sydney Australia/Canberra
+L Australia/Hobart Australia/Currie
+L Australia/Lord_Howe Australia/LHI
+L Australia/Sydney Australia/NSW
+L Australia/Darwin Australia/North
+L Australia/Brisbane Australia/Queensland
+L Australia/Adelaide Australia/South
+L Australia/Hobart Australia/Tasmania
+L Australia/Melbourne Australia/Victoria
+L Australia/Perth Australia/West
+L Australia/Broken_Hill Australia/Yancowinna
+L America/Rio_Branco Brazil/Acre
+L America/Noronha Brazil/DeNoronha
+L America/Sao_Paulo Brazil/East
+L America/Manaus Brazil/West
+L America/Halifax Canada/Atlantic
+L America/Winnipeg Canada/Central
+L America/Toronto Canada/Eastern
+L America/Edmonton Canada/Mountain
+L America/St_Johns Canada/Newfoundland
+L America/Vancouver Canada/Pacific
+L America/Regina Canada/Saskatchewan
+L America/Whitehorse Canada/Yukon
+L America/Santiago Chile/Continental
+L Pacific/Easter Chile/EasterIsland
+L America/Havana Cuba
+L Africa/Cairo Egypt
+L Europe/Dublin Eire
+L Etc/UTC Etc/UCT
+L Europe/London Europe/Belfast
+L Europe/Chisinau Europe/Tiraspol
+L Europe/London GB
+L Europe/London GB-Eire
+L Etc/GMT GMT+0
+L Etc/GMT GMT-0
+L Etc/GMT GMT0
+L Etc/GMT Greenwich
+L Asia/Hong_Kong Hongkong
+L Atlantic/Reykjavik Iceland
+L Asia/Tehran Iran
+L Asia/Jerusalem Israel
+L America/Jamaica Jamaica
+L Asia/Tokyo Japan
+L Pacific/Kwajalein Kwajalein
+L Africa/Tripoli Libya
+L America/Tijuana Mexico/BajaNorte
+L America/Mazatlan Mexico/BajaSur
+L America/Mexico_City Mexico/General
+L Pacific/Auckland NZ
+L Pacific/Chatham NZ-CHAT
+L America/Denver Navajo
+L Asia/Shanghai PRC
+L Pacific/Honolulu Pacific/Johnston
+L Pacific/Pohnpei Pacific/Ponape
+L Pacific/Pago_Pago Pacific/Samoa
+L Pacific/Chuuk Pacific/Truk
+L Pacific/Chuuk Pacific/Yap
+L Europe/Warsaw Poland
+L Europe/Lisbon Portugal
+L Asia/Taipei ROC
+L Asia/Seoul ROK
+L Asia/Singapore Singapore
+L Europe/Istanbul Turkey
+L Etc/UTC UCT
+L America/Anchorage US/Alaska
+L America/Adak US/Aleutian
+L America/Phoenix US/Arizona
+L America/Chicago US/Central
+L America/Indiana/Indianapolis US/East-Indiana
+L America/New_York US/Eastern
+L Pacific/Honolulu US/Hawaii
+L America/Indiana/Knox US/Indiana-Starke
+L America/Detroit US/Michigan
+L America/Denver US/Mountain
+L America/Los_Angeles US/Pacific
+L Pacific/Pago_Pago US/Samoa
+L Etc/UTC UTC
+L Etc/UTC Universal
+L Europe/Moscow W-SU
+L Etc/UTC Zulu
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone.tab b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone.tab
new file mode 100644
index 0000000000000000000000000000000000000000..1f0128f3b280857704f2eddaa1187abf2471ac78
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone.tab
@@ -0,0 +1,451 @@
+# tzdb timezone descriptions (deprecated version)
+#
+# This file is in the public domain, so clarified as of
+# 2009-05-17 by Arthur David Olson.
+#
+# From Paul Eggert (2018-06-27):
+# This file is intended as a backward-compatibility aid for older programs.
+# New programs should use zone1970.tab.  This file is like zone1970.tab (see
+# zone1970.tab's comments), but with the following additional restrictions:
+#
+# 1.  This file contains only ASCII characters.
+# 2.  The first data column contains exactly one country code.
+#
+# Because of (2), each row stands for an area that is the intersection
+# of a region identified by a country code and of a timezone where civil
+# clocks have agreed since 1970; this is a narrower definition than
+# that of zone1970.tab.
+#
+# This table is intended as an aid for users, to help them select timezones
+# appropriate for their practical needs.  It is not intended to take or
+# endorse any position on legal or territorial claims.
+#
+#country-
+#code	coordinates	TZ			comments
+AD	+4230+00131	Europe/Andorra
+AE	+2518+05518	Asia/Dubai
+AF	+3431+06912	Asia/Kabul
+AG	+1703-06148	America/Antigua
+AI	+1812-06304	America/Anguilla
+AL	+4120+01950	Europe/Tirane
+AM	+4011+04430	Asia/Yerevan
+AO	-0848+01314	Africa/Luanda
+AQ	-7750+16636	Antarctica/McMurdo	New Zealand time - McMurdo, South Pole
+AQ	-6617+11031	Antarctica/Casey	Casey
+AQ	-6835+07758	Antarctica/Davis	Davis
+AQ	-6640+14001	Antarctica/DumontDUrville	Dumont-d'Urville
+AQ	-6736+06253	Antarctica/Mawson	Mawson
+AQ	-6448-06406	Antarctica/Palmer	Palmer
+AQ	-6734-06808	Antarctica/Rothera	Rothera
+AQ	-690022+0393524	Antarctica/Syowa	Syowa
+AQ	-720041+0023206	Antarctica/Troll	Troll
+AQ	-7824+10654	Antarctica/Vostok	Vostok
+AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
+AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
+AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
+AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
+AR	-2649-06513	America/Argentina/Tucuman	Tucuman (TM)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
+AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
+AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
+AR	-3319-06621	America/Argentina/San_Luis	San Luis (SL)
+AR	-5138-06913	America/Argentina/Rio_Gallegos	Santa Cruz (SC)
+AR	-5448-06818	America/Argentina/Ushuaia	Tierra del Fuego (TF)
+AS	-1416-17042	Pacific/Pago_Pago
+AT	+4813+01620	Europe/Vienna
+AU	-3133+15905	Australia/Lord_Howe	Lord Howe Island
+AU	-5430+15857	Antarctica/Macquarie	Macquarie Island
+AU	-4253+14719	Australia/Hobart	Tasmania
+AU	-3749+14458	Australia/Melbourne	Victoria
+AU	-3352+15113	Australia/Sydney	New South Wales (most areas)
+AU	-3157+14127	Australia/Broken_Hill	New South Wales (Yancowinna)
+AU	-2728+15302	Australia/Brisbane	Queensland (most areas)
+AU	-2016+14900	Australia/Lindeman	Queensland (Whitsunday Islands)
+AU	-3455+13835	Australia/Adelaide	South Australia
+AU	-1228+13050	Australia/Darwin	Northern Territory
+AU	-3157+11551	Australia/Perth	Western Australia (most areas)
+AU	-3143+12852	Australia/Eucla	Western Australia (Eucla)
+AW	+1230-06958	America/Aruba
+AX	+6006+01957	Europe/Mariehamn
+AZ	+4023+04951	Asia/Baku
+BA	+4352+01825	Europe/Sarajevo
+BB	+1306-05937	America/Barbados
+BD	+2343+09025	Asia/Dhaka
+BE	+5050+00420	Europe/Brussels
+BF	+1222-00131	Africa/Ouagadougou
+BG	+4241+02319	Europe/Sofia
+BH	+2623+05035	Asia/Bahrain
+BI	-0323+02922	Africa/Bujumbura
+BJ	+0629+00237	Africa/Porto-Novo
+BL	+1753-06251	America/St_Barthelemy
+BM	+3217-06446	Atlantic/Bermuda
+BN	+0456+11455	Asia/Brunei
+BO	-1630-06809	America/La_Paz
+BQ	+120903-0681636	America/Kralendijk
+BR	-0351-03225	America/Noronha	Atlantic islands
+BR	-0127-04829	America/Belem	Para (east); Amapa
+BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
+BR	-0803-03454	America/Recife	Pernambuco
+BR	-0712-04812	America/Araguaina	Tocantins
+BR	-0940-03543	America/Maceio	Alagoas, Sergipe
+BR	-1259-03831	America/Bahia	Bahia
+BR	-2332-04637	America/Sao_Paulo	Brazil (southeast: GO, DF, MG, ES, RJ, SP, PR, SC, RS)
+BR	-2027-05437	America/Campo_Grande	Mato Grosso do Sul
+BR	-1535-05605	America/Cuiaba	Mato Grosso
+BR	-0226-05452	America/Santarem	Para (west)
+BR	-0846-06354	America/Porto_Velho	Rondonia
+BR	+0249-06040	America/Boa_Vista	Roraima
+BR	-0308-06001	America/Manaus	Amazonas (east)
+BR	-0640-06952	America/Eirunepe	Amazonas (west)
+BR	-0958-06748	America/Rio_Branco	Acre
+BS	+2505-07721	America/Nassau
+BT	+2728+08939	Asia/Thimphu
+BW	-2439+02555	Africa/Gaborone
+BY	+5354+02734	Europe/Minsk
+BZ	+1730-08812	America/Belize
+CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
+CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
+CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
+CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
+CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
+CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
+CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
+CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
+CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
+CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
+CA	+5024-10439	America/Regina	CST - SK (most areas)
+CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
+CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
+CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
+CA	+4906-11631	America/Creston	MST - BC (Creston)
+CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
+CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
+CA	+6404-13925	America/Dawson	MST - Yukon (west)
+CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
+CC	-1210+09655	Indian/Cocos
+CD	-0418+01518	Africa/Kinshasa	Dem. Rep. of Congo (west)
+CD	-1140+02728	Africa/Lubumbashi	Dem. Rep. of Congo (east)
+CF	+0422+01835	Africa/Bangui
+CG	-0416+01517	Africa/Brazzaville
+CH	+4723+00832	Europe/Zurich
+CI	+0519-00402	Africa/Abidjan
+CK	-2114-15946	Pacific/Rarotonga
+CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
+CL	-2709-10926	Pacific/Easter	Easter Island
+CM	+0403+00942	Africa/Douala
+CN	+3114+12128	Asia/Shanghai	Beijing Time
+CN	+4348+08735	Asia/Urumqi	Xinjiang Time
+CO	+0436-07405	America/Bogota
+CR	+0956-08405	America/Costa_Rica
+CU	+2308-08222	America/Havana
+CV	+1455-02331	Atlantic/Cape_Verde
+CW	+1211-06900	America/Curacao
+CX	-1025+10543	Indian/Christmas
+CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3507+03357	Asia/Famagusta	Northern Cyprus
+CZ	+5005+01426	Europe/Prague
+DE	+5230+01322	Europe/Berlin	Germany (most areas)
+DE	+4742+00841	Europe/Busingen	Busingen
+DJ	+1136+04309	Africa/Djibouti
+DK	+5540+01235	Europe/Copenhagen
+DM	+1518-06124	America/Dominica
+DO	+1828-06954	America/Santo_Domingo
+DZ	+3647+00303	Africa/Algiers
+EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
+EC	-0054-08936	Pacific/Galapagos	Galapagos Islands
+EE	+5925+02445	Europe/Tallinn
+EG	+3003+03115	Africa/Cairo
+EH	+2709-01312	Africa/El_Aaiun
+ER	+1520+03853	Africa/Asmara
+ES	+4024-00341	Europe/Madrid	Spain (mainland)
+ES	+3553-00519	Africa/Ceuta	Ceuta, Melilla
+ES	+2806-01524	Atlantic/Canary	Canary Islands
+ET	+0902+03842	Africa/Addis_Ababa
+FI	+6010+02458	Europe/Helsinki
+FJ	-1808+17825	Pacific/Fiji
+FK	-5142-05751	Atlantic/Stanley
+FM	+0725+15147	Pacific/Chuuk	Chuuk/Truk, Yap
+FM	+0658+15813	Pacific/Pohnpei	Pohnpei/Ponape
+FM	+0519+16259	Pacific/Kosrae	Kosrae
+FO	+6201-00646	Atlantic/Faroe
+FR	+4852+00220	Europe/Paris
+GA	+0023+00927	Africa/Libreville
+GB	+513030-0000731	Europe/London
+GD	+1203-06145	America/Grenada
+GE	+4143+04449	Asia/Tbilisi
+GF	+0456-05220	America/Cayenne
+GG	+492717-0023210	Europe/Guernsey
+GH	+0533-00013	Africa/Accra
+GI	+3608-00521	Europe/Gibraltar
+GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
+GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
+GL	+7634-06847	America/Thule	Thule/Pituffik
+GM	+1328-01639	Africa/Banjul
+GN	+0931-01343	Africa/Conakry
+GP	+1614-06132	America/Guadeloupe
+GQ	+0345+00847	Africa/Malabo
+GR	+3758+02343	Europe/Athens
+GS	-5416-03632	Atlantic/South_Georgia
+GT	+1438-09031	America/Guatemala
+GU	+1328+14445	Pacific/Guam
+GW	+1151-01535	Africa/Bissau
+GY	+0648-05810	America/Guyana
+HK	+2217+11409	Asia/Hong_Kong
+HN	+1406-08713	America/Tegucigalpa
+HR	+4548+01558	Europe/Zagreb
+HT	+1832-07220	America/Port-au-Prince
+HU	+4730+01905	Europe/Budapest
+ID	-0610+10648	Asia/Jakarta	Java, Sumatra
+ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
+ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+IE	+5320-00615	Europe/Dublin
+IL	+314650+0351326	Asia/Jerusalem
+IM	+5409-00428	Europe/Isle_of_Man
+IN	+2232+08822	Asia/Kolkata
+IO	-0720+07225	Indian/Chagos
+IQ	+3321+04425	Asia/Baghdad
+IR	+3540+05126	Asia/Tehran
+IS	+6409-02151	Atlantic/Reykjavik
+IT	+4154+01229	Europe/Rome
+JE	+491101-0020624	Europe/Jersey
+JM	+175805-0764736	America/Jamaica
+JO	+3157+03556	Asia/Amman
+JP	+353916+1394441	Asia/Tokyo
+KE	-0117+03649	Africa/Nairobi
+KG	+4254+07436	Asia/Bishkek
+KH	+1133+10455	Asia/Phnom_Penh
+KI	+0125+17300	Pacific/Tarawa	Gilbert Islands
+KI	-0308-17105	Pacific/Enderbury	Phoenix Islands
+KI	+0152-15720	Pacific/Kiritimati	Line Islands
+KM	-1141+04316	Indian/Comoro
+KN	+1718-06243	America/St_Kitts
+KP	+3901+12545	Asia/Pyongyang
+KR	+3733+12658	Asia/Seoul
+KW	+2920+04759	Asia/Kuwait
+KY	+1918-08123	America/Cayman
+KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
+KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
+KZ	+5017+05710	Asia/Aqtobe	Aqtobe/Aktobe
+KZ	+4431+05016	Asia/Aqtau	Mangghystau/Mankistau
+KZ	+4707+05156	Asia/Atyrau	Atyrau/Atirau/Gur'yev
+KZ	+5113+05121	Asia/Oral	West Kazakhstan
+LA	+1758+10236	Asia/Vientiane
+LB	+3353+03530	Asia/Beirut
+LC	+1401-06100	America/St_Lucia
+LI	+4709+00931	Europe/Vaduz
+LK	+0656+07951	Asia/Colombo
+LR	+0618-01047	Africa/Monrovia
+LS	-2928+02730	Africa/Maseru
+LT	+5441+02519	Europe/Vilnius
+LU	+4936+00609	Europe/Luxembourg
+LV	+5657+02406	Europe/Riga
+LY	+3254+01311	Africa/Tripoli
+MA	+3339-00735	Africa/Casablanca
+MC	+4342+00723	Europe/Monaco
+MD	+4700+02850	Europe/Chisinau
+ME	+4226+01916	Europe/Podgorica
+MF	+1804-06305	America/Marigot
+MG	-1855+04731	Indian/Antananarivo
+MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
+MH	+0905+16720	Pacific/Kwajalein	Kwajalein
+MK	+4159+02126	Europe/Skopje
+ML	+1239-00800	Africa/Bamako
+MM	+1647+09610	Asia/Yangon
+MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4801+09139	Asia/Hovd	Bayan-Olgiy, Govi-Altai, Hovd, Uvs, Zavkhan
+MN	+4804+11430	Asia/Choibalsan	Dornod, Sukhbaatar
+MO	+221150+1133230	Asia/Macau
+MP	+1512+14545	Pacific/Saipan
+MQ	+1436-06105	America/Martinique
+MR	+1806-01557	Africa/Nouakchott
+MS	+1643-06213	America/Montserrat
+MT	+3554+01431	Europe/Malta
+MU	-2010+05730	Indian/Mauritius
+MV	+0410+07330	Indian/Maldives
+MW	-1547+03500	Africa/Blantyre
+MX	+1924-09909	America/Mexico_City	Central Time
+MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
+MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatan
+MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo Leon, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo Leon, Tamaulipas (US border)
+MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
+MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
+MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
+MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
+MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
+MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahia de Banderas
+MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
+MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
+MZ	-2558+03235	Africa/Maputo
+NA	-2234+01706	Africa/Windhoek
+NC	-2216+16627	Pacific/Noumea
+NE	+1331+00207	Africa/Niamey
+NF	-2903+16758	Pacific/Norfolk
+NG	+0627+00324	Africa/Lagos
+NI	+1209-08617	America/Managua
+NL	+5222+00454	Europe/Amsterdam
+NO	+5955+01045	Europe/Oslo
+NP	+2743+08519	Asia/Kathmandu
+NR	-0031+16655	Pacific/Nauru
+NU	-1901-16955	Pacific/Niue
+NZ	-3652+17446	Pacific/Auckland	New Zealand (most areas)
+NZ	-4357-17633	Pacific/Chatham	Chatham Islands
+OM	+2336+05835	Asia/Muscat
+PA	+0858-07932	America/Panama
+PE	-1203-07703	America/Lima
+PF	-1732-14934	Pacific/Tahiti	Society Islands
+PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
+PF	-2308-13457	Pacific/Gambier	Gambier Islands
+PG	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas)
+PG	-0613+15534	Pacific/Bougainville	Bougainville
+PH	+1435+12100	Asia/Manila
+PK	+2452+06703	Asia/Karachi
+PL	+5215+02100	Europe/Warsaw
+PM	+4703-05620	America/Miquelon
+PN	-2504-13005	Pacific/Pitcairn
+PR	+182806-0660622	America/Puerto_Rico
+PS	+3130+03428	Asia/Gaza	Gaza Strip
+PS	+313200+0350542	Asia/Hebron	West Bank
+PT	+3843-00908	Europe/Lisbon	Portugal (mainland)
+PT	+3238-01654	Atlantic/Madeira	Madeira Islands
+PT	+3744-02540	Atlantic/Azores	Azores
+PW	+0720+13429	Pacific/Palau
+PY	-2516-05740	America/Asuncion
+QA	+2517+05132	Asia/Qatar
+RE	-2052+05528	Indian/Reunion
+RO	+4426+02606	Europe/Bucharest
+RS	+4450+02030	Europe/Belgrade
+RU	+5443+02030	Europe/Kaliningrad	MSK-01 - Kaliningrad
+RU	+554521+0373704	Europe/Moscow	MSK+00 - Moscow area
+# The obsolescent zone.tab format cannot represent Europe/Simferopol well.
+# Put it in RU section and list as UA.  See "territorial claims" above.
+# Programs should use zone1970.tab instead; see above.
+UA	+4457+03406	Europe/Simferopol	Crimea
+RU	+5836+04939	Europe/Kirov	MSK+00 - Kirov
+RU	+4844+04425	Europe/Volgograd	MSK+00 - Volgograd
+RU	+4621+04803	Europe/Astrakhan	MSK+01 - Astrakhan
+RU	+5134+04602	Europe/Saratov	MSK+01 - Saratov
+RU	+5420+04824	Europe/Ulyanovsk	MSK+01 - Ulyanovsk
+RU	+5312+05009	Europe/Samara	MSK+01 - Samara, Udmurtia
+RU	+5651+06036	Asia/Yekaterinburg	MSK+02 - Urals
+RU	+5500+07324	Asia/Omsk	MSK+03 - Omsk
+RU	+5502+08255	Asia/Novosibirsk	MSK+04 - Novosibirsk
+RU	+5322+08345	Asia/Barnaul	MSK+04 - Altai
+RU	+5630+08458	Asia/Tomsk	MSK+04 - Tomsk
+RU	+5345+08707	Asia/Novokuznetsk	MSK+04 - Kemerovo
+RU	+5601+09250	Asia/Krasnoyarsk	MSK+04 - Krasnoyarsk area
+RU	+5216+10420	Asia/Irkutsk	MSK+05 - Irkutsk, Buryatia
+RU	+5203+11328	Asia/Chita	MSK+06 - Zabaykalsky
+RU	+6200+12940	Asia/Yakutsk	MSK+06 - Lena River
+RU	+623923+1353314	Asia/Khandyga	MSK+06 - Tomponsky, Ust-Maysky
+RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
+RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
+RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
+RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
+RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
+RW	-0157+03004	Africa/Kigali
+SA	+2438+04643	Asia/Riyadh
+SB	-0932+16012	Pacific/Guadalcanal
+SC	-0440+05528	Indian/Mahe
+SD	+1536+03232	Africa/Khartoum
+SE	+5920+01803	Europe/Stockholm
+SG	+0117+10351	Asia/Singapore
+SH	-1555-00542	Atlantic/St_Helena
+SI	+4603+01431	Europe/Ljubljana
+SJ	+7800+01600	Arctic/Longyearbyen
+SK	+4809+01707	Europe/Bratislava
+SL	+0830-01315	Africa/Freetown
+SM	+4355+01228	Europe/San_Marino
+SN	+1440-01726	Africa/Dakar
+SO	+0204+04522	Africa/Mogadishu
+SR	+0550-05510	America/Paramaribo
+SS	+0451+03137	Africa/Juba
+ST	+0020+00644	Africa/Sao_Tome
+SV	+1342-08912	America/El_Salvador
+SX	+180305-0630250	America/Lower_Princes
+SY	+3330+03618	Asia/Damascus
+SZ	-2618+03106	Africa/Mbabane
+TC	+2128-07108	America/Grand_Turk
+TD	+1207+01503	Africa/Ndjamena
+TF	-492110+0701303	Indian/Kerguelen
+TG	+0608+00113	Africa/Lome
+TH	+1345+10031	Asia/Bangkok
+TJ	+3835+06848	Asia/Dushanbe
+TK	-0922-17114	Pacific/Fakaofo
+TL	-0833+12535	Asia/Dili
+TM	+3757+05823	Asia/Ashgabat
+TN	+3648+01011	Africa/Tunis
+TO	-2110-17510	Pacific/Tongatapu
+TR	+4101+02858	Europe/Istanbul
+TT	+1039-06131	America/Port_of_Spain
+TV	-0831+17913	Pacific/Funafuti
+TW	+2503+12130	Asia/Taipei
+TZ	-0648+03917	Africa/Dar_es_Salaam
+UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
+UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
+UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
+UG	+0019+03225	Africa/Kampala
+UM	+2813-17722	Pacific/Midway	Midway Islands
+UM	+1917+16637	Pacific/Wake	Wake Island
+US	+404251-0740023	America/New_York	Eastern (most areas)
+US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
+US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
+US	+364947-0845057	America/Kentucky/Monticello	Eastern - KY (Wayne)
+US	+394606-0860929	America/Indiana/Indianapolis	Eastern - IN (most areas)
+US	+384038-0873143	America/Indiana/Vincennes	Eastern - IN (Da, Du, K, Mn)
+US	+410305-0863611	America/Indiana/Winamac	Eastern - IN (Pulaski)
+US	+382232-0862041	America/Indiana/Marengo	Eastern - IN (Crawford)
+US	+382931-0871643	America/Indiana/Petersburg	Eastern - IN (Pike)
+US	+384452-0850402	America/Indiana/Vevay	Eastern - IN (Switzerland)
+US	+415100-0873900	America/Chicago	Central (most areas)
+US	+375711-0864541	America/Indiana/Tell_City	Central - IN (Perry)
+US	+411745-0863730	America/Indiana/Knox	Central - IN (Starke)
+US	+450628-0873651	America/Menominee	Central - MI (Wisconsin border)
+US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
+US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
+US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
+US	+394421-1045903	America/Denver	Mountain (most areas)
+US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo)
+US	+340308-1181434	America/Los_Angeles	Pacific
+US	+611305-1495401	America/Anchorage	Alaska (most areas)
+US	+581807-1342511	America/Juneau	Alaska - Juneau area
+US	+571035-1351807	America/Sitka	Alaska - Sitka area
+US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
+US	+593249-1394338	America/Yakutat	Alaska - Yakutat
+US	+643004-1652423	America/Nome	Alaska (west)
+US	+515248-1763929	America/Adak	Aleutian Islands
+US	+211825-1575130	Pacific/Honolulu	Hawaii
+UY	-345433-0561245	America/Montevideo
+UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
+UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
+VA	+415408+0122711	Europe/Vatican
+VC	+1309-06114	America/St_Vincent
+VE	+1030-06656	America/Caracas
+VG	+1827-06437	America/Tortola
+VI	+1821-06456	America/St_Thomas
+VN	+1045+10640	Asia/Ho_Chi_Minh
+VU	-1740+16825	Pacific/Efate
+WF	-1318-17610	Pacific/Wallis
+WS	-1350-17144	Pacific/Apia
+YE	+1245+04512	Asia/Aden
+YT	-1247+04514	Indian/Mayotte
+ZA	-2615+02800	Africa/Johannesburg
+ZM	-1525+02817	Africa/Lusaka
+ZW	-1750+03103	Africa/Harare
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone1970.tab b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone1970.tab
new file mode 100644
index 0000000000000000000000000000000000000000..396e4d3810b1bc4b610d7612a139d989747144b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/pytz/zoneinfo/zone1970.tab
@@ -0,0 +1,383 @@
+# tzdb timezone descriptions
+#
+# This file is in the public domain.
+#
+# From Paul Eggert (2018-06-27):
+# This file contains a table where each row stands for a timezone where
+# civil timestamps have agreed since 1970.  Columns are separated by
+# a single tab.  Lines beginning with '#' are comments.  All text uses
+# UTF-8 encoding.  The columns of the table are as follows:
+#
+# 1.  The countries that overlap the timezone, as a comma-separated list
+#     of ISO 3166 2-character country codes.  See the file 'iso3166.tab'.
+# 2.  Latitude and longitude of the timezone's principal location
+#     in ISO 6709 sign-degrees-minutes-seconds format,
+#     either ±DDMM±DDDMM or ±DDMMSS±DDDMMSS,
+#     first latitude (+ is north), then longitude (+ is east).
+# 3.  Timezone name used in value of TZ environment variable.
+#     Please see the theory.html file for how these names are chosen.
+#     If multiple timezones overlap a country, each has a row in the
+#     table, with each column 1 containing the country code.
+# 4.  Comments; present if and only if a country has multiple timezones.
+#
+# If a timezone covers multiple countries, the most-populous city is used,
+# and that country is listed first in column 1; any other countries
+# are listed alphabetically by country code.  The table is sorted
+# first by country code, then (if possible) by an order within the
+# country that (1) makes some geographical sense, and (2) puts the
+# most populous timezones first, where that does not contradict (1).
+#
+# This table is intended as an aid for users, to help them select timezones
+# appropriate for their practical needs.  It is not intended to take or
+# endorse any position on legal or territorial claims.
+#
+#country-
+#codes	coordinates	TZ	comments
+AD	+4230+00131	Europe/Andorra
+AE,OM	+2518+05518	Asia/Dubai
+AF	+3431+06912	Asia/Kabul
+AL	+4120+01950	Europe/Tirane
+AM	+4011+04430	Asia/Yerevan
+AQ	-6617+11031	Antarctica/Casey	Casey
+AQ	-6835+07758	Antarctica/Davis	Davis
+AQ	-6640+14001	Antarctica/DumontDUrville	Dumont-d'Urville
+AQ	-6736+06253	Antarctica/Mawson	Mawson
+AQ	-6448-06406	Antarctica/Palmer	Palmer
+AQ	-6734-06808	Antarctica/Rothera	Rothera
+AQ	-690022+0393524	Antarctica/Syowa	Syowa
+AQ	-720041+0023206	Antarctica/Troll	Troll
+AQ	-7824+10654	Antarctica/Vostok	Vostok
+AR	-3436-05827	America/Argentina/Buenos_Aires	Buenos Aires (BA, CF)
+AR	-3124-06411	America/Argentina/Cordoba	Argentina (most areas: CB, CC, CN, ER, FM, MN, SE, SF)
+AR	-2447-06525	America/Argentina/Salta	Salta (SA, LP, NQ, RN)
+AR	-2411-06518	America/Argentina/Jujuy	Jujuy (JY)
+AR	-2649-06513	America/Argentina/Tucuman	Tucumán (TM)
+AR	-2828-06547	America/Argentina/Catamarca	Catamarca (CT); Chubut (CH)
+AR	-2926-06651	America/Argentina/La_Rioja	La Rioja (LR)
+AR	-3132-06831	America/Argentina/San_Juan	San Juan (SJ)
+AR	-3253-06849	America/Argentina/Mendoza	Mendoza (MZ)
+AR	-3319-06621	America/Argentina/San_Luis	San Luis (SL)
+AR	-5138-06913	America/Argentina/Rio_Gallegos	Santa Cruz (SC)
+AR	-5448-06818	America/Argentina/Ushuaia	Tierra del Fuego (TF)
+AS,UM	-1416-17042	Pacific/Pago_Pago	Samoa, Midway
+AT	+4813+01620	Europe/Vienna
+AU	-3133+15905	Australia/Lord_Howe	Lord Howe Island
+AU	-5430+15857	Antarctica/Macquarie	Macquarie Island
+AU	-4253+14719	Australia/Hobart	Tasmania
+AU	-3749+14458	Australia/Melbourne	Victoria
+AU	-3352+15113	Australia/Sydney	New South Wales (most areas)
+AU	-3157+14127	Australia/Broken_Hill	New South Wales (Yancowinna)
+AU	-2728+15302	Australia/Brisbane	Queensland (most areas)
+AU	-2016+14900	Australia/Lindeman	Queensland (Whitsunday Islands)
+AU	-3455+13835	Australia/Adelaide	South Australia
+AU	-1228+13050	Australia/Darwin	Northern Territory
+AU	-3157+11551	Australia/Perth	Western Australia (most areas)
+AU	-3143+12852	Australia/Eucla	Western Australia (Eucla)
+AZ	+4023+04951	Asia/Baku
+BB	+1306-05937	America/Barbados
+BD	+2343+09025	Asia/Dhaka
+BE	+5050+00420	Europe/Brussels
+BG	+4241+02319	Europe/Sofia
+BM	+3217-06446	Atlantic/Bermuda
+BN	+0456+11455	Asia/Brunei
+BO	-1630-06809	America/La_Paz
+BR	-0351-03225	America/Noronha	Atlantic islands
+BR	-0127-04829	America/Belem	Pará (east); Amapá
+BR	-0343-03830	America/Fortaleza	Brazil (northeast: MA, PI, CE, RN, PB)
+BR	-0803-03454	America/Recife	Pernambuco
+BR	-0712-04812	America/Araguaina	Tocantins
+BR	-0940-03543	America/Maceio	Alagoas, Sergipe
+BR	-1259-03831	America/Bahia	Bahia
+BR	-2332-04637	America/Sao_Paulo	Brazil (southeast: GO, DF, MG, ES, RJ, SP, PR, SC, RS)
+BR	-2027-05437	America/Campo_Grande	Mato Grosso do Sul
+BR	-1535-05605	America/Cuiaba	Mato Grosso
+BR	-0226-05452	America/Santarem	Pará (west)
+BR	-0846-06354	America/Porto_Velho	Rondônia
+BR	+0249-06040	America/Boa_Vista	Roraima
+BR	-0308-06001	America/Manaus	Amazonas (east)
+BR	-0640-06952	America/Eirunepe	Amazonas (west)
+BR	-0958-06748	America/Rio_Branco	Acre
+BS	+2505-07721	America/Nassau
+BT	+2728+08939	Asia/Thimphu
+BY	+5354+02734	Europe/Minsk
+BZ	+1730-08812	America/Belize
+CA	+4734-05243	America/St_Johns	Newfoundland; Labrador (southeast)
+CA	+4439-06336	America/Halifax	Atlantic - NS (most areas); PE
+CA	+4612-05957	America/Glace_Bay	Atlantic - NS (Cape Breton)
+CA	+4606-06447	America/Moncton	Atlantic - New Brunswick
+CA	+5320-06025	America/Goose_Bay	Atlantic - Labrador (most areas)
+CA	+5125-05707	America/Blanc-Sablon	AST - QC (Lower North Shore)
+CA	+4339-07923	America/Toronto	Eastern - ON, QC (most areas)
+CA	+4901-08816	America/Nipigon	Eastern - ON, QC (no DST 1967-73)
+CA	+4823-08915	America/Thunder_Bay	Eastern - ON (Thunder Bay)
+CA	+6344-06828	America/Iqaluit	Eastern - NU (most east areas)
+CA	+6608-06544	America/Pangnirtung	Eastern - NU (Pangnirtung)
+CA	+484531-0913718	America/Atikokan	EST - ON (Atikokan); NU (Coral H)
+CA	+4953-09709	America/Winnipeg	Central - ON (west); Manitoba
+CA	+4843-09434	America/Rainy_River	Central - ON (Rainy R, Ft Frances)
+CA	+744144-0944945	America/Resolute	Central - NU (Resolute)
+CA	+624900-0920459	America/Rankin_Inlet	Central - NU (central)
+CA	+5024-10439	America/Regina	CST - SK (most areas)
+CA	+5017-10750	America/Swift_Current	CST - SK (midwest)
+CA	+5333-11328	America/Edmonton	Mountain - AB; BC (E); SK (W)
+CA	+690650-1050310	America/Cambridge_Bay	Mountain - NU (west)
+CA	+6227-11421	America/Yellowknife	Mountain - NT (central)
+CA	+682059-1334300	America/Inuvik	Mountain - NT (west)
+CA	+4906-11631	America/Creston	MST - BC (Creston)
+CA	+5946-12014	America/Dawson_Creek	MST - BC (Dawson Cr, Ft St John)
+CA	+5848-12242	America/Fort_Nelson	MST - BC (Ft Nelson)
+CA	+6043-13503	America/Whitehorse	MST - Yukon (east)
+CA	+6404-13925	America/Dawson	MST - Yukon (west)
+CA	+4916-12307	America/Vancouver	Pacific - BC (most areas)
+CC	-1210+09655	Indian/Cocos
+CH,DE,LI	+4723+00832	Europe/Zurich	Swiss time
+CI,BF,GM,GN,ML,MR,SH,SL,SN,TG	+0519-00402	Africa/Abidjan
+CK	-2114-15946	Pacific/Rarotonga
+CL	-3327-07040	America/Santiago	Chile (most areas)
+CL	-5309-07055	America/Punta_Arenas	Region of Magallanes
+CL	-2709-10926	Pacific/Easter	Easter Island
+CN	+3114+12128	Asia/Shanghai	Beijing Time
+CN	+4348+08735	Asia/Urumqi	Xinjiang Time
+CO	+0436-07405	America/Bogota
+CR	+0956-08405	America/Costa_Rica
+CU	+2308-08222	America/Havana
+CV	+1455-02331	Atlantic/Cape_Verde
+CW,AW,BQ,SX	+1211-06900	America/Curacao
+CX	-1025+10543	Indian/Christmas
+CY	+3510+03322	Asia/Nicosia	Cyprus (most areas)
+CY	+3507+03357	Asia/Famagusta	Northern Cyprus
+CZ,SK	+5005+01426	Europe/Prague
+DE	+5230+01322	Europe/Berlin	Germany (most areas)
+DK	+5540+01235	Europe/Copenhagen
+DO	+1828-06954	America/Santo_Domingo
+DZ	+3647+00303	Africa/Algiers
+EC	-0210-07950	America/Guayaquil	Ecuador (mainland)
+EC	-0054-08936	Pacific/Galapagos	Galápagos Islands
+EE	+5925+02445	Europe/Tallinn
+EG	+3003+03115	Africa/Cairo
+EH	+2709-01312	Africa/El_Aaiun
+ES	+4024-00341	Europe/Madrid	Spain (mainland)
+ES	+3553-00519	Africa/Ceuta	Ceuta, Melilla
+ES	+2806-01524	Atlantic/Canary	Canary Islands
+FI,AX	+6010+02458	Europe/Helsinki
+FJ	-1808+17825	Pacific/Fiji
+FK	-5142-05751	Atlantic/Stanley
+FM	+0725+15147	Pacific/Chuuk	Chuuk/Truk, Yap
+FM	+0658+15813	Pacific/Pohnpei	Pohnpei/Ponape
+FM	+0519+16259	Pacific/Kosrae	Kosrae
+FO	+6201-00646	Atlantic/Faroe
+FR	+4852+00220	Europe/Paris
+GB,GG,IM,JE	+513030-0000731	Europe/London
+GE	+4143+04449	Asia/Tbilisi
+GF	+0456-05220	America/Cayenne
+GH	+0533-00013	Africa/Accra
+GI	+3608-00521	Europe/Gibraltar
+GL	+6411-05144	America/Nuuk	Greenland (most areas)
+GL	+7646-01840	America/Danmarkshavn	National Park (east coast)
+GL	+7029-02158	America/Scoresbysund	Scoresbysund/Ittoqqortoormiit
+GL	+7634-06847	America/Thule	Thule/Pituffik
+GR	+3758+02343	Europe/Athens
+GS	-5416-03632	Atlantic/South_Georgia
+GT	+1438-09031	America/Guatemala
+GU,MP	+1328+14445	Pacific/Guam
+GW	+1151-01535	Africa/Bissau
+GY	+0648-05810	America/Guyana
+HK	+2217+11409	Asia/Hong_Kong
+HN	+1406-08713	America/Tegucigalpa
+HT	+1832-07220	America/Port-au-Prince
+HU	+4730+01905	Europe/Budapest
+ID	-0610+10648	Asia/Jakarta	Java, Sumatra
+ID	-0002+10920	Asia/Pontianak	Borneo (west, central)
+ID	-0507+11924	Asia/Makassar	Borneo (east, south); Sulawesi/Celebes, Bali, Nusa Tengarra; Timor (west)
+ID	-0232+14042	Asia/Jayapura	New Guinea (West Papua / Irian Jaya); Malukus/Moluccas
+IE	+5320-00615	Europe/Dublin
+IL	+314650+0351326	Asia/Jerusalem
+IN	+2232+08822	Asia/Kolkata
+IO	-0720+07225	Indian/Chagos
+IQ	+3321+04425	Asia/Baghdad
+IR	+3540+05126	Asia/Tehran
+IS	+6409-02151	Atlantic/Reykjavik
+IT,SM,VA	+4154+01229	Europe/Rome
+JM	+175805-0764736	America/Jamaica
+JO	+3157+03556	Asia/Amman
+JP	+353916+1394441	Asia/Tokyo
+KE,DJ,ER,ET,KM,MG,SO,TZ,UG,YT	-0117+03649	Africa/Nairobi
+KG	+4254+07436	Asia/Bishkek
+KI	+0125+17300	Pacific/Tarawa	Gilbert Islands
+KI	-0308-17105	Pacific/Enderbury	Phoenix Islands
+KI	+0152-15720	Pacific/Kiritimati	Line Islands
+KP	+3901+12545	Asia/Pyongyang
+KR	+3733+12658	Asia/Seoul
+KZ	+4315+07657	Asia/Almaty	Kazakhstan (most areas)
+KZ	+4448+06528	Asia/Qyzylorda	Qyzylorda/Kyzylorda/Kzyl-Orda
+KZ	+5312+06337	Asia/Qostanay	Qostanay/Kostanay/Kustanay
+KZ	+5017+05710	Asia/Aqtobe	Aqtöbe/Aktobe
+KZ	+4431+05016	Asia/Aqtau	Mangghystaū/Mankistau
+KZ	+4707+05156	Asia/Atyrau	Atyraū/Atirau/Gur'yev
+KZ	+5113+05121	Asia/Oral	West Kazakhstan
+LB	+3353+03530	Asia/Beirut
+LK	+0656+07951	Asia/Colombo
+LR	+0618-01047	Africa/Monrovia
+LT	+5441+02519	Europe/Vilnius
+LU	+4936+00609	Europe/Luxembourg
+LV	+5657+02406	Europe/Riga
+LY	+3254+01311	Africa/Tripoli
+MA	+3339-00735	Africa/Casablanca
+MC	+4342+00723	Europe/Monaco
+MD	+4700+02850	Europe/Chisinau
+MH	+0709+17112	Pacific/Majuro	Marshall Islands (most areas)
+MH	+0905+16720	Pacific/Kwajalein	Kwajalein
+MM	+1647+09610	Asia/Yangon
+MN	+4755+10653	Asia/Ulaanbaatar	Mongolia (most areas)
+MN	+4801+09139	Asia/Hovd	Bayan-Ölgii, Govi-Altai, Hovd, Uvs, Zavkhan
+MN	+4804+11430	Asia/Choibalsan	Dornod, Sükhbaatar
+MO	+221150+1133230	Asia/Macau
+MQ	+1436-06105	America/Martinique
+MT	+3554+01431	Europe/Malta
+MU	-2010+05730	Indian/Mauritius
+MV	+0410+07330	Indian/Maldives
+MX	+1924-09909	America/Mexico_City	Central Time
+MX	+2105-08646	America/Cancun	Eastern Standard Time - Quintana Roo
+MX	+2058-08937	America/Merida	Central Time - Campeche, Yucatán
+MX	+2540-10019	America/Monterrey	Central Time - Durango; Coahuila, Nuevo León, Tamaulipas (most areas)
+MX	+2550-09730	America/Matamoros	Central Time US - Coahuila, Nuevo León, Tamaulipas (US border)
+MX	+2313-10625	America/Mazatlan	Mountain Time - Baja California Sur, Nayarit, Sinaloa
+MX	+2838-10605	America/Chihuahua	Mountain Time - Chihuahua (most areas)
+MX	+2934-10425	America/Ojinaga	Mountain Time US - Chihuahua (US border)
+MX	+2904-11058	America/Hermosillo	Mountain Standard Time - Sonora
+MX	+3232-11701	America/Tijuana	Pacific Time US - Baja California
+MX	+2048-10515	America/Bahia_Banderas	Central Time - Bahía de Banderas
+MY	+0310+10142	Asia/Kuala_Lumpur	Malaysia (peninsula)
+MY	+0133+11020	Asia/Kuching	Sabah, Sarawak
+MZ,BI,BW,CD,MW,RW,ZM,ZW	-2558+03235	Africa/Maputo	Central Africa Time
+NA	-2234+01706	Africa/Windhoek
+NC	-2216+16627	Pacific/Noumea
+NF	-2903+16758	Pacific/Norfolk
+NG,AO,BJ,CD,CF,CG,CM,GA,GQ,NE	+0627+00324	Africa/Lagos	West Africa Time
+NI	+1209-08617	America/Managua
+NL	+5222+00454	Europe/Amsterdam
+NO,SJ	+5955+01045	Europe/Oslo
+NP	+2743+08519	Asia/Kathmandu
+NR	-0031+16655	Pacific/Nauru
+NU	-1901-16955	Pacific/Niue
+NZ,AQ	-3652+17446	Pacific/Auckland	New Zealand time
+NZ	-4357-17633	Pacific/Chatham	Chatham Islands
+PA,KY	+0858-07932	America/Panama
+PE	-1203-07703	America/Lima
+PF	-1732-14934	Pacific/Tahiti	Society Islands
+PF	-0900-13930	Pacific/Marquesas	Marquesas Islands
+PF	-2308-13457	Pacific/Gambier	Gambier Islands
+PG	-0930+14710	Pacific/Port_Moresby	Papua New Guinea (most areas)
+PG	-0613+15534	Pacific/Bougainville	Bougainville
+PH	+1435+12100	Asia/Manila
+PK	+2452+06703	Asia/Karachi
+PL	+5215+02100	Europe/Warsaw
+PM	+4703-05620	America/Miquelon
+PN	-2504-13005	Pacific/Pitcairn
+PR	+182806-0660622	America/Puerto_Rico
+PS	+3130+03428	Asia/Gaza	Gaza Strip
+PS	+313200+0350542	Asia/Hebron	West Bank
+PT	+3843-00908	Europe/Lisbon	Portugal (mainland)
+PT	+3238-01654	Atlantic/Madeira	Madeira Islands
+PT	+3744-02540	Atlantic/Azores	Azores
+PW	+0720+13429	Pacific/Palau
+PY	-2516-05740	America/Asuncion
+QA,BH	+2517+05132	Asia/Qatar
+RE,TF	-2052+05528	Indian/Reunion	Réunion, Crozet, Scattered Islands
+RO	+4426+02606	Europe/Bucharest
+RS,BA,HR,ME,MK,SI	+4450+02030	Europe/Belgrade
+RU	+5443+02030	Europe/Kaliningrad	MSK-01 - Kaliningrad
+RU	+554521+0373704	Europe/Moscow	MSK+00 - Moscow area
+# Mention RU and UA alphabetically.  See "territorial claims" above.
+RU,UA	+4457+03406	Europe/Simferopol	Crimea
+RU	+5836+04939	Europe/Kirov	MSK+00 - Kirov
+RU	+4844+04425	Europe/Volgograd	MSK+00 - Volgograd
+RU	+4621+04803	Europe/Astrakhan	MSK+01 - Astrakhan
+RU	+5134+04602	Europe/Saratov	MSK+01 - Saratov
+RU	+5420+04824	Europe/Ulyanovsk	MSK+01 - Ulyanovsk
+RU	+5312+05009	Europe/Samara	MSK+01 - Samara, Udmurtia
+RU	+5651+06036	Asia/Yekaterinburg	MSK+02 - Urals
+RU	+5500+07324	Asia/Omsk	MSK+03 - Omsk
+RU	+5502+08255	Asia/Novosibirsk	MSK+04 - Novosibirsk
+RU	+5322+08345	Asia/Barnaul	MSK+04 - Altai
+RU	+5630+08458	Asia/Tomsk	MSK+04 - Tomsk
+RU	+5345+08707	Asia/Novokuznetsk	MSK+04 - Kemerovo
+RU	+5601+09250	Asia/Krasnoyarsk	MSK+04 - Krasnoyarsk area
+RU	+5216+10420	Asia/Irkutsk	MSK+05 - Irkutsk, Buryatia
+RU	+5203+11328	Asia/Chita	MSK+06 - Zabaykalsky
+RU	+6200+12940	Asia/Yakutsk	MSK+06 - Lena River
+RU	+623923+1353314	Asia/Khandyga	MSK+06 - Tomponsky, Ust-Maysky
+RU	+4310+13156	Asia/Vladivostok	MSK+07 - Amur River
+RU	+643337+1431336	Asia/Ust-Nera	MSK+07 - Oymyakonsky
+RU	+5934+15048	Asia/Magadan	MSK+08 - Magadan
+RU	+4658+14242	Asia/Sakhalin	MSK+08 - Sakhalin Island
+RU	+6728+15343	Asia/Srednekolymsk	MSK+08 - Sakha (E); North Kuril Is
+RU	+5301+15839	Asia/Kamchatka	MSK+09 - Kamchatka
+RU	+6445+17729	Asia/Anadyr	MSK+09 - Bering Sea
+SA,KW,YE	+2438+04643	Asia/Riyadh
+SB	-0932+16012	Pacific/Guadalcanal
+SC	-0440+05528	Indian/Mahe
+SD	+1536+03232	Africa/Khartoum
+SE	+5920+01803	Europe/Stockholm
+SG	+0117+10351	Asia/Singapore
+SR	+0550-05510	America/Paramaribo
+SS	+0451+03137	Africa/Juba
+ST	+0020+00644	Africa/Sao_Tome
+SV	+1342-08912	America/El_Salvador
+SY	+3330+03618	Asia/Damascus
+TC	+2128-07108	America/Grand_Turk
+TD	+1207+01503	Africa/Ndjamena
+TF	-492110+0701303	Indian/Kerguelen	Kerguelen, St Paul Island, Amsterdam Island
+TH,KH,LA,VN	+1345+10031	Asia/Bangkok	Indochina (most areas)
+TJ	+3835+06848	Asia/Dushanbe
+TK	-0922-17114	Pacific/Fakaofo
+TL	-0833+12535	Asia/Dili
+TM	+3757+05823	Asia/Ashgabat
+TN	+3648+01011	Africa/Tunis
+TO	-2110-17510	Pacific/Tongatapu
+TR	+4101+02858	Europe/Istanbul
+TT,AG,AI,BL,DM,GD,GP,KN,LC,MF,MS,VC,VG,VI	+1039-06131	America/Port_of_Spain
+TV	-0831+17913	Pacific/Funafuti
+TW	+2503+12130	Asia/Taipei
+UA	+5026+03031	Europe/Kiev	Ukraine (most areas)
+UA	+4837+02218	Europe/Uzhgorod	Transcarpathia
+UA	+4750+03510	Europe/Zaporozhye	Zaporozhye and east Lugansk
+UM	+1917+16637	Pacific/Wake	Wake Island
+US	+404251-0740023	America/New_York	Eastern (most areas)
+US	+421953-0830245	America/Detroit	Eastern - MI (most areas)
+US	+381515-0854534	America/Kentucky/Louisville	Eastern - KY (Louisville area)
+US	+364947-0845057	America/Kentucky/Monticello	Eastern - KY (Wayne)
+US	+394606-0860929	America/Indiana/Indianapolis	Eastern - IN (most areas)
+US	+384038-0873143	America/Indiana/Vincennes	Eastern - IN (Da, Du, K, Mn)
+US	+410305-0863611	America/Indiana/Winamac	Eastern - IN (Pulaski)
+US	+382232-0862041	America/Indiana/Marengo	Eastern - IN (Crawford)
+US	+382931-0871643	America/Indiana/Petersburg	Eastern - IN (Pike)
+US	+384452-0850402	America/Indiana/Vevay	Eastern - IN (Switzerland)
+US	+415100-0873900	America/Chicago	Central (most areas)
+US	+375711-0864541	America/Indiana/Tell_City	Central - IN (Perry)
+US	+411745-0863730	America/Indiana/Knox	Central - IN (Starke)
+US	+450628-0873651	America/Menominee	Central - MI (Wisconsin border)
+US	+470659-1011757	America/North_Dakota/Center	Central - ND (Oliver)
+US	+465042-1012439	America/North_Dakota/New_Salem	Central - ND (Morton rural)
+US	+471551-1014640	America/North_Dakota/Beulah	Central - ND (Mercer)
+US	+394421-1045903	America/Denver	Mountain (most areas)
+US	+433649-1161209	America/Boise	Mountain - ID (south); OR (east)
+US	+332654-1120424	America/Phoenix	MST - Arizona (except Navajo)
+US	+340308-1181434	America/Los_Angeles	Pacific
+US	+611305-1495401	America/Anchorage	Alaska (most areas)
+US	+581807-1342511	America/Juneau	Alaska - Juneau area
+US	+571035-1351807	America/Sitka	Alaska - Sitka area
+US	+550737-1313435	America/Metlakatla	Alaska - Annette Island
+US	+593249-1394338	America/Yakutat	Alaska - Yakutat
+US	+643004-1652423	America/Nome	Alaska (west)
+US	+515248-1763929	America/Adak	Aleutian Islands
+US,UM	+211825-1575130	Pacific/Honolulu	Hawaii
+UY	-345433-0561245	America/Montevideo
+UZ	+3940+06648	Asia/Samarkand	Uzbekistan (west)
+UZ	+4120+06918	Asia/Tashkent	Uzbekistan (east)
+VE	+1030-06656	America/Caracas
+VN	+1045+10640	Asia/Ho_Chi_Minh	Vietnam (south)
+VU	-1740+16825	Pacific/Efate
+WF	-1318-17610	Pacific/Wallis
+WS	-1350-17144	Pacific/Apia
+ZA,LS,SZ	-2615+02800	Africa/Johannesburg
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b06e5875c81ac4ac4c6db532cc554915c7e5285d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/METADATA
@@ -0,0 +1,141 @@
+Metadata-Version: 2.1
+Name: requests
+Version: 2.22.0
+Summary: Python HTTP for Humans.
+Home-page: http://python-requests.org
+Author: Kenneth Reitz
+Author-email: me@kennethreitz.org
+License: Apache 2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Description-Content-Type: text/markdown
+Provides-Extra: security
+Requires-Dist: cryptography (>=1.3.4) ; extra == 'security'
+Requires-Dist: idna (>=2.0.0) ; extra == 'security'
+Requires-Dist: pyOpenSSL (>=0.14) ; extra == 'security'
+Provides-Extra: socks
+Requires-Dist: PySocks (!=1.5.7,>=1.5.6) ; extra == 'socks'
+Requires-Dist: win-inet-pton ; (sys_platform == "win32" and python_version == "2.7") and extra == 'socks'
+
+Requests: HTTP for Humans™
+==========================
+
+[![image](https://img.shields.io/pypi/v/requests.svg)](https://pypi.org/project/requests/)
+[![image](https://img.shields.io/pypi/l/requests.svg)](https://pypi.org/project/requests/)
+[![image](https://img.shields.io/pypi/pyversions/requests.svg)](https://pypi.org/project/requests/)
+[![codecov.io](https://codecov.io/github/requests/requests/coverage.svg?branch=master)](https://codecov.io/github/requests/requests)
+[![image](https://img.shields.io/github/contributors/requests/requests.svg)](https://github.com/requests/requests/graphs/contributors)
+[![image](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/kennethreitz)
+
+Requests is the only *Non-GMO* HTTP library for Python, safe for human
+consumption.
+
+![image](https://farm5.staticflickr.com/4317/35198386374_1939af3de6_k_d.jpg)
+
+Behold, the power of Requests:
+
+``` {.sourceCode .python}
+>>> import requests
+>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
+>>> r.status_code
+200
+>>> r.headers['content-type']
+'application/json; charset=utf8'
+>>> r.encoding
+'utf-8'
+>>> r.text
+u'{"type":"User"...'
+>>> r.json()
+{u'disk_usage': 368627, u'private_gists': 484, ...}
+```
+
+See [the similar code, sans Requests](https://gist.github.com/973705).
+
+[![image](https://raw.githubusercontent.com/requests/requests/master/docs/_static/requests-logo-small.png)](http://docs.python-requests.org/)
+
+Requests allows you to send *organic, grass-fed* HTTP/1.1 requests,
+without the need for manual labor. There's no need to manually add query
+strings to your URLs, or to form-encode your POST data. Keep-alive and
+HTTP connection pooling are 100% automatic, thanks to
+[urllib3](https://github.com/shazow/urllib3).
+
+Besides, all the cool kids are doing it. Requests is one of the most
+downloaded Python packages of all time, pulling in over 11,000,000
+downloads every month. You don't want to be left out!
+
+Feature Support
+---------------
+
+Requests is ready for today's web.
+
+-   International Domains and URLs
+-   Keep-Alive & Connection Pooling
+-   Sessions with Cookie Persistence
+-   Browser-style SSL Verification
+-   Basic/Digest Authentication
+-   Elegant Key/Value Cookies
+-   Automatic Decompression
+-   Automatic Content Decoding
+-   Unicode Response Bodies
+-   Multipart File Uploads
+-   HTTP(S) Proxy Support
+-   Connection Timeouts
+-   Streaming Downloads
+-   `.netrc` Support
+-   Chunked Requests
+
+Requests officially supports Python 2.7 & 3.4–3.7, and runs great on
+PyPy.
+
+Installation
+------------
+
+To install Requests, simply use [pipenv](http://pipenv.org/) (or pip, of
+course):
+
+``` {.sourceCode .bash}
+$ pipenv install requests
+✨🍰✨
+```
+
+Satisfaction guaranteed.
+
+Documentation
+-------------
+
+Fantastic documentation is available at
+<http://docs.python-requests.org/>, for a limited time only.
+
+How to Contribute
+-----------------
+
+1.  Become more familiar with the project by reading our [Contributor's Guide](http://docs.python-requests.org/en/latest/dev/contributing/) and our [development philosophy](http://docs.python-requests.org/en/latest/dev/philosophy/).
+2.  Check for open issues or open a fresh issue to start a discussion
+    around a feature idea or a bug. There is a [Contributor
+    Friendly](https://github.com/requests/requests/issues?direction=desc&labels=Contributor+Friendly&page=1&sort=updated&state=open)
+    tag for issues that should be ideal for people who are not very
+    familiar with the codebase yet.
+3.  Fork [the repository](https://github.com/requests/requests) on
+    GitHub to start making your changes to the **master** branch (or
+    branch off of it).
+4.  Write a test which shows that the bug was fixed or that the feature
+    works as expected.
+5.  Send a pull request and bug the maintainer until it gets merged and
+    published. :) Make sure to add yourself to
+    [AUTHORS](https://github.com/requests/requests/blob/master/AUTHORS.rst).
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..853a1f1ef3a2a9962f6db612b63caff76bbc875d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/RECORD
@@ -0,0 +1,46 @@
+requests/__init__.py,sha256=PnKCgjcTq44LaAMzB-7--B2FdewRrE8F_vjZeaG9NhA,3921
+requests/__version__.py,sha256=Bm-GFstQaFezsFlnmEMrJDe8JNROz9n2XXYtODdvjjc,436
+requests/_internal_utils.py,sha256=Zx3PnEUccyfsB-ie11nZVAW8qClJy0gx1qNME7rgT18,1096
+requests/adapters.py,sha256=WelSM1BCQXdbjEuDsBxqKDADeY8BHmxlrwbNnLN2rr4,21344
+requests/api.py,sha256=fbUo11QoLOoNgWU6FfvNz8vMj9bE_cMmICXBa7TZHJs,6271
+requests/auth.py,sha256=QB2-cSUj1jrvWZfPXttsZpyAacQgtKLVk14vQW9TpSE,10206
+requests/certs.py,sha256=dOB5rV2DZ13dEhq9BUa_4hd5kAqg59e_zUZB00faYz8,453
+requests/compat.py,sha256=FVIeTOniQMHQkeE2JdJvar3OZ-b4IFh8aNezIn45zws,1678
+requests/cookies.py,sha256=Y-bKX6TvW3FnYlE6Au0SXtVVWcaNdFvuAwQxw-G0iTI,18430
+requests/exceptions.py,sha256=Q8YeWWxiHHXhkEynLpMgC_6_r_ZTYw2aITs9wCSAZNY,3185
+requests/help.py,sha256=lLcBtKAar8T6T78e9Tc4Zfd_EEJFhntxgib1JHNctEI,3515
+requests/hooks.py,sha256=QReGyy0bRcr5rkwCuObNakbYsc7EkiKeBwG4qHekr2Q,757
+requests/models.py,sha256=bce6oORR26SY-dVPaqMpdBunD1zXzrgMSlH6jhfvuRA,34210
+requests/packages.py,sha256=Q2rF0L5mc3wQAvc6q_lAVtPTDOaOeFgD-7kWSQLkjEQ,542
+requests/sessions.py,sha256=DjbCotDW6xSAaBsjbW-L8l4N0UcwmrxVNgSrZgIjGWM,29332
+requests/status_codes.py,sha256=XWlcpBjbCtq9sSqpH9_KKxgnLTf9Z__wCWolq21ySlg,4129
+requests/structures.py,sha256=zoP8qly2Jak5e89HwpqjN1z2diztI-_gaqts1raJJBc,2981
+requests/utils.py,sha256=LtPJ1db6mJff2TJSJWKi7rBpzjPS3mSOrjC9zRhoD3A,30049
+requests-2.22.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+requests-2.22.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+requests-2.22.0.dist-info/METADATA,sha256=P_W5z_XB-k7Tgwcj1Oz0eL74k1bRbwwFjJwEPWOkk_4,5355
+requests-2.22.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+requests-2.22.0.dist-info/top_level.txt,sha256=fMSVmHfb5rbGOo6xv-O_tUX6j-WyixssE-SnwcDRxNQ,9
+requests-2.22.0.dist-info/RECORD,,
+requests/compat.cpython-38.pyc,,
+requests/help.cpython-38.pyc,,
+requests/exceptions.cpython-38.pyc,,
+requests/api.cpython-38.pyc,,
+requests/__init__.cpython-38.pyc,,
+requests/auth.cpython-38.pyc,,
+requests/adapters.cpython-38.pyc,,
+requests/sessions.cpython-38.pyc,,
+requests-2.22.0.virtualenv,,
+requests-2.22.0.dist-info/__pycache__,,
+requests/__pycache__,,
+requests/packages.cpython-38.pyc,,
+requests/utils.cpython-38.pyc,,
+requests/status_codes.cpython-38.pyc,,
+requests/models.cpython-38.pyc,,
+requests/cookies.cpython-38.pyc,,
+requests/hooks.cpython-38.pyc,,
+requests/certs.cpython-38.pyc,,
+requests/structures.cpython-38.pyc,,
+requests-2.22.0.dist-info/INSTALLER,,
+requests/__version__.cpython-38.pyc,,
+requests/_internal_utils.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f2293605cf1b01dca72aad0a15c45b72ed5429a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+requests
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.22.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/DESCRIPTION.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/DESCRIPTION.rst
new file mode 100644
index 0000000000000000000000000000000000000000..63f129a3ccaab9fb4d9941826691e8f14f66ca94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/DESCRIPTION.rst
@@ -0,0 +1,136 @@
+
+<span align="center">
+
+<pre>
+    <a href="https://requests.readthedocs.io/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/requests-logo.png" align="center" /></a>
+
+    <div align="left">
+    <p></p>
+    <code> Python 3.7.4 (default, Sep  7 2019, 18:27:02)</code>
+    <code> >>> <strong>import requests</strong></code>
+    <code> >>> r = requests.get('https://api.github.com/repos/psf/requests')</code>
+    <code> >>> r.json()["description"]</code>
+    <code> 'A simple, yet elegant HTTP library.'</code>
+    </div>
+
+    <p>
+        This software has been designed for you, with much joy,
+        by <a href="https://kennethreitz.org/">Kenneth Reitz</a> &
+        is protected by The <a href="https://www.python.org/psf/">Python Software Foundation</a>.
+
+    </p>
+
+</pre>
+
+</span>
+
+<p>&nbsp;</p><p>&nbsp;</p>
+
+<p align="center"><strong>Requests</strong> is an elegant and simple HTTP library for Python, built with ♥.</p>
+
+<p>&nbsp;</p>
+
+```python
+>>> import requests
+>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
+>>> r.status_code
+200
+>>> r.headers['content-type']
+'application/json; charset=utf8'
+>>> r.encoding
+'utf-8'
+>>> r.text
+'{"type":"User"...'
+>>> r.json()
+{'disk_usage': 368627, 'private_gists': 484, ...}
+```
+
+
+
+---------------------------------------------------------------------
+
+<p>&nbsp;</p>
+
+Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your `PUT` & `POST` data — but nowadays, just use the `json` method!
+
+
+Requests is one of the most downloaded Python package today, pulling in around `14M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `500,000+` repositories. You may certainly put your trust in this code.
+
+
+<p>&nbsp;</p>
+<p align="center"><a href="https://pepy.tech/project/requests" rel="nofollow"><img src="https://camo.githubusercontent.com/e1dedc9f5ce5cd6b6c699f33d2e812daadcf3645/68747470733a2f2f706570792e746563682f62616467652f7265717565737473" alt="Downloads" data-canonical-src="https://pepy.tech/badge/requests" style="max-width:100%;"></a>
+<a href="https://pypi.org/project/requests/" rel="nofollow"><img src="https://camo.githubusercontent.com/6d78aeec0a9a1cfe147ad064bfb99069e298e29b/68747470733a2f2f696d672e736869656c64732e696f2f707970692f707976657273696f6e732f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/pypi/pyversions/requests.svg" style="max-width:100%;"></a>
+<a href="https://github.com/psf/requests/graphs/contributors"><img src="https://camo.githubusercontent.com/a70ea15870b38bba9203b969f6a6b7e7845fbb8a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f7073662f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/github/contributors/psf/requests.svg" style="max-width:100%;"></a></p>
+
+<p>&nbsp;</p>
+
+<h2 align="center">Supported Features & Best–Practices</h2>
+
+Requests is ready for the demands of building robust and reliable HTTP–speak applications, for the needs of today.
+
+<pre class="test">
+         + International Domains and URLs       + Keep-Alive & Connection Pooling
+         + Sessions with Cookie Persistence     + Browser-style SSL Verification
+         + Basic & Digest Authentication        + Familiar `dict`–like Cookies
+         + Automatic Decompression of Content   + Automatic Content Decoding
+         + Automatic Connection Pooling         + Unicode Response Bodies<super>*</super>
+         + Multi-part File Uploads              + SOCKS Proxy Support
+         + Connection Timeouts                  + Streaming Downloads
+         + Automatic honoring of `.netrc`       + Chunked HTTP Requests
+
+                            &, of course, rock–solid stability!
+
+</pre>
+
+</div>
+
+<p align="center">
+        ✨ 🍰 ✨&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+</p>
+
+<p>&nbsp;</p>
+
+Requests Module Installation
+----------------------------
+
+The recommended way to install the `requests` module is to simply use [`pipenv`](https://pipenv.kennethreitz.org) (or `pip`, of
+course):
+
+```console
+$ pipenv install requests
+Adding requests to Pipfile's [packages]…
+✔ Installation Succeeded
+…
+```
+
+Requests officially supports Python 2.7 & 3.5+.
+
+-------------------------------------
+
+## P.S. — Documentation is available at [`requests.readthedocs.io`](https://requests.readthedocs.io/en/latest/).
+
+<p align="center">
+        <a href="https://requests.readthedocs.io/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/ss.png" align="center" /></a>
+
+</p>
+
+
+------------------
+
+
+<p>&nbsp;</p>
+
+<p align="center">
+        <a href="https://kennethreitz.org/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/kr.png" align="center" /></a>
+
+</p>
+
+<p>&nbsp;</p>
+
+<p align="center">
+        <a href="https://www.python.org/psf/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/psf.png" align="center" /></a>
+
+</p>
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..13d91ddc7a834d243717de34aa46dc51acf43818
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/LICENSE.txt
@@ -0,0 +1,13 @@
+Copyright 2019 Kenneth Reitz
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       https://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..6bd1cff46775e37b5867c9740a9a9938195b3973
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/METADATA
@@ -0,0 +1,177 @@
+Metadata-Version: 2.0
+Name: requests
+Version: 2.24.0
+Summary: Python HTTP for Humans.
+Home-page: https://requests.readthedocs.io
+Author: Kenneth Reitz
+Author-email: me@kennethreitz.org
+License: Apache 2.0
+Project-URL: Source, https://github.com/psf/requests
+Project-URL: Documentation, https://requests.readthedocs.io
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Description-Content-Type: text/markdown
+Provides-Extra: security
+Provides-Extra: socks
+Requires-Dist: chardet (>=3.0.2,<4)
+Requires-Dist: idna (>=2.5,<3)
+Requires-Dist: urllib3 (!=1.25.1,<1.26,!=1.25.0,>=1.21.1)
+Requires-Dist: certifi (>=2017.4.17)
+Provides-Extra: security
+Requires-Dist: pyOpenSSL (>=0.14); extra == 'security'
+Requires-Dist: cryptography (>=1.3.4); extra == 'security'
+Provides-Extra: socks
+Requires-Dist: PySocks (!=1.5.7,>=1.5.6); extra == 'socks'
+Provides-Extra: socks
+Requires-Dist: win-inet-pton; sys_platform == "win32" and python_version == "2.7" and extra == 'socks'
+
+
+<span align="center">
+
+<pre>
+    <a href="https://requests.readthedocs.io/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/requests-logo.png" align="center" /></a>
+
+    <div align="left">
+    <p></p>
+    <code> Python 3.7.4 (default, Sep  7 2019, 18:27:02)</code>
+    <code> >>> <strong>import requests</strong></code>
+    <code> >>> r = requests.get('https://api.github.com/repos/psf/requests')</code>
+    <code> >>> r.json()["description"]</code>
+    <code> 'A simple, yet elegant HTTP library.'</code>
+    </div>
+
+    <p>
+        This software has been designed for you, with much joy,
+        by <a href="https://kennethreitz.org/">Kenneth Reitz</a> &
+        is protected by The <a href="https://www.python.org/psf/">Python Software Foundation</a>.
+
+    </p>
+
+</pre>
+
+</span>
+
+<p>&nbsp;</p><p>&nbsp;</p>
+
+<p align="center"><strong>Requests</strong> is an elegant and simple HTTP library for Python, built with ♥.</p>
+
+<p>&nbsp;</p>
+
+```python
+>>> import requests
+>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
+>>> r.status_code
+200
+>>> r.headers['content-type']
+'application/json; charset=utf8'
+>>> r.encoding
+'utf-8'
+>>> r.text
+'{"type":"User"...'
+>>> r.json()
+{'disk_usage': 368627, 'private_gists': 484, ...}
+```
+
+
+
+---------------------------------------------------------------------
+
+<p>&nbsp;</p>
+
+Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your `PUT` & `POST` data — but nowadays, just use the `json` method!
+
+
+Requests is one of the most downloaded Python package today, pulling in around `14M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `500,000+` repositories. You may certainly put your trust in this code.
+
+
+<p>&nbsp;</p>
+<p align="center"><a href="https://pepy.tech/project/requests" rel="nofollow"><img src="https://camo.githubusercontent.com/e1dedc9f5ce5cd6b6c699f33d2e812daadcf3645/68747470733a2f2f706570792e746563682f62616467652f7265717565737473" alt="Downloads" data-canonical-src="https://pepy.tech/badge/requests" style="max-width:100%;"></a>
+<a href="https://pypi.org/project/requests/" rel="nofollow"><img src="https://camo.githubusercontent.com/6d78aeec0a9a1cfe147ad064bfb99069e298e29b/68747470733a2f2f696d672e736869656c64732e696f2f707970692f707976657273696f6e732f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/pypi/pyversions/requests.svg" style="max-width:100%;"></a>
+<a href="https://github.com/psf/requests/graphs/contributors"><img src="https://camo.githubusercontent.com/a70ea15870b38bba9203b969f6a6b7e7845fbb8a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f7073662f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/github/contributors/psf/requests.svg" style="max-width:100%;"></a></p>
+
+<p>&nbsp;</p>
+
+<h2 align="center">Supported Features & Best–Practices</h2>
+
+Requests is ready for the demands of building robust and reliable HTTP–speak applications, for the needs of today.
+
+<pre class="test">
+         + International Domains and URLs       + Keep-Alive & Connection Pooling
+         + Sessions with Cookie Persistence     + Browser-style SSL Verification
+         + Basic & Digest Authentication        + Familiar `dict`–like Cookies
+         + Automatic Decompression of Content   + Automatic Content Decoding
+         + Automatic Connection Pooling         + Unicode Response Bodies<super>*</super>
+         + Multi-part File Uploads              + SOCKS Proxy Support
+         + Connection Timeouts                  + Streaming Downloads
+         + Automatic honoring of `.netrc`       + Chunked HTTP Requests
+
+                            &, of course, rock–solid stability!
+
+</pre>
+
+</div>
+
+<p align="center">
+        ✨ 🍰 ✨&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+
+</p>
+
+<p>&nbsp;</p>
+
+Requests Module Installation
+----------------------------
+
+The recommended way to install the `requests` module is to simply use [`pipenv`](https://pipenv.kennethreitz.org) (or `pip`, of
+course):
+
+```console
+$ pipenv install requests
+Adding requests to Pipfile's [packages]…
+✔ Installation Succeeded
+…
+```
+
+Requests officially supports Python 2.7 & 3.5+.
+
+-------------------------------------
+
+## P.S. — Documentation is available at [`requests.readthedocs.io`](https://requests.readthedocs.io/en/latest/).
+
+<p align="center">
+        <a href="https://requests.readthedocs.io/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/ss.png" align="center" /></a>
+
+</p>
+
+
+------------------
+
+
+<p>&nbsp;</p>
+
+<p align="center">
+        <a href="https://kennethreitz.org/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/kr.png" align="center" /></a>
+
+</p>
+
+<p>&nbsp;</p>
+
+<p align="center">
+        <a href="https://www.python.org/psf/"><img src="https://raw.githubusercontent.com/psf/requests/master/ext/psf.png" align="center" /></a>
+
+</p>
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..e7555aeeca332c825ce8589e63b37f6934a3d6c2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/RECORD
@@ -0,0 +1,44 @@
+requests-2.24.0.dist-info/DESCRIPTION.rst,sha256=ZG-WjeYGqCA5qbqHhGigoEDupjOaKMBaQm9veUh9138,5155
+requests-2.24.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+requests-2.24.0.dist-info/LICENSE.txt,sha256=iDei8zphvO4XXAKP8W0cFgq6SKOuvhSVrOcJvk5iY2s,582
+requests-2.24.0.dist-info/METADATA,sha256=flBB925Jz6o3J1ZtnhAMNEfM8TpXeho-R5AjbAprLjA,6887
+requests-2.24.0.dist-info/RECORD,,
+requests-2.24.0.dist-info/WHEEL,sha256=AvR0WeTpDaxT645bl5FQxUK6NPsTls2ttpcGJg3j1Xg,110
+requests-2.24.0.dist-info/metadata.json,sha256=XmKXWAQzV8c988vJZuKHBM64knfo5V3AC5OYkI5cZEs,1843
+requests-2.24.0.dist-info/top_level.txt,sha256=fMSVmHfb5rbGOo6xv-O_tUX6j-WyixssE-SnwcDRxNQ,9
+requests/__init__.py,sha256=N5ugWQFoqkxlXE5NVKlXRuhTvRItCxbfybFiro6HDEU,4148
+requests/__pycache__/__init__.cpython-38.pyc,,
+requests/__pycache__/__version__.cpython-38.pyc,,
+requests/__pycache__/_internal_utils.cpython-38.pyc,,
+requests/__pycache__/adapters.cpython-38.pyc,,
+requests/__pycache__/api.cpython-38.pyc,,
+requests/__pycache__/auth.cpython-38.pyc,,
+requests/__pycache__/certs.cpython-38.pyc,,
+requests/__pycache__/compat.cpython-38.pyc,,
+requests/__pycache__/cookies.cpython-38.pyc,,
+requests/__pycache__/exceptions.cpython-38.pyc,,
+requests/__pycache__/help.cpython-38.pyc,,
+requests/__pycache__/hooks.cpython-38.pyc,,
+requests/__pycache__/models.cpython-38.pyc,,
+requests/__pycache__/packages.cpython-38.pyc,,
+requests/__pycache__/sessions.cpython-38.pyc,,
+requests/__pycache__/status_codes.cpython-38.pyc,,
+requests/__pycache__/structures.cpython-38.pyc,,
+requests/__pycache__/utils.cpython-38.pyc,,
+requests/__version__.py,sha256=Xwky1FMlMkJJGidBM50JC7FKcosWzkjIW-WhQGrBdFM,441
+requests/_internal_utils.py,sha256=Zx3PnEUccyfsB-ie11nZVAW8qClJy0gx1qNME7rgT18,1096
+requests/adapters.py,sha256=WelSM1BCQXdbjEuDsBxqKDADeY8BHmxlrwbNnLN2rr4,21344
+requests/api.py,sha256=PlHM-HT3PQ5lyufoeGmV-nJxRi7UnUyGVh7OV7B9XV4,6496
+requests/auth.py,sha256=OMoJIVKyRLy9THr91y8rxysZuclwPB-K1Xg1zBomUhQ,10207
+requests/certs.py,sha256=dOB5rV2DZ13dEhq9BUa_4hd5kAqg59e_zUZB00faYz8,453
+requests/compat.py,sha256=iBRvu-X540CH4PJsuxr0vcGTnl_TZhq_75SwmeckQ7w,1782
+requests/cookies.py,sha256=Y-bKX6TvW3FnYlE6Au0SXtVVWcaNdFvuAwQxw-G0iTI,18430
+requests/exceptions.py,sha256=xXoj1rdhnxTS_DYphKZ9OvFZJQZ333A64REc9ZDZIgU,3161
+requests/help.py,sha256=lLcBtKAar8T6T78e9Tc4Zfd_EEJFhntxgib1JHNctEI,3515
+requests/hooks.py,sha256=QReGyy0bRcr5rkwCuObNakbYsc7EkiKeBwG4qHekr2Q,757
+requests/models.py,sha256=Z1pO2GjDrU35EXOlCKVuajQo_0JAe_dp9146Gd7yIbA,34222
+requests/packages.py,sha256=Q2rF0L5mc3wQAvc6q_lAVtPTDOaOeFgD-7kWSQLkjEQ,542
+requests/sessions.py,sha256=OBtwQs1vjkB1xamFdi_p5y8BVeX16BJoQcwSwx_Y3fI,29316
+requests/status_codes.py,sha256=gT79Pbs_cQjBgp-fvrUgg1dn2DQO32bDj4TInjnMPSc,4188
+requests/structures.py,sha256=msAtr9mq1JxHd-JRyiILfdFlpbJwvvFuP3rfUQT_QxE,3005
+requests/utils.py,sha256=VBs99cvV8Z29WGXeWZqHzZ80_nu1AwwjYzJfe0wQIvs,30176
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..9dff69d86102d36169ccf42a9e71885d3dc17155
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.24.0)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/metadata.json b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/metadata.json
new file mode 100644
index 0000000000000000000000000000000000000000..8732219cccd198058279d826b5c5b83702796355
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/metadata.json
@@ -0,0 +1 @@
+{"license": "Apache 2.0", "name": "requests", "metadata_version": "2.0", "generator": "bdist_wheel (0.24.0)", "project_url": "Source, https://github.com/psf/requests", "summary": "Python HTTP for Humans.", "run_requires": [{"requires": ["PySocks (!=1.5.7,>=1.5.6)"], "extra": "socks"}, {"environment": "sys_platform == \"win32\" and python_version == \"2.7\"", "requires": ["win-inet-pton"], "extra": "socks"}, {"requires": ["pyOpenSSL (>=0.14)", "cryptography (>=1.3.4)"], "extra": "security"}, {"requires": ["chardet (>=3.0.2,<4)", "idna (>=2.5,<3)", "urllib3 (!=1.25.1,<1.26,!=1.25.0,>=1.21.1)", "certifi (>=2017.4.17)"]}], "version": "2.24.0", "extensions": {"python.details": {"project_urls": {"Home": "https://requests.readthedocs.io"}, "document_names": {"description": "DESCRIPTION.rst", "license": "LICENSE.txt"}, "contacts": [{"role": "author", "email": "me@kennethreitz.org", "name": "Kenneth Reitz"}]}}, "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*", "description_content_type": "text/markdown", "test_requires": [{"requires": ["pytest-httpbin (==0.0.7)", "pytest-cov", "pytest-mock", "pytest-xdist", "PySocks (!=1.5.7,>=1.5.6)", "pytest (>=3)"]}], "classifiers": ["Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Natural Language :: English", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: Implementation :: CPython", "Programming Language :: Python :: Implementation :: PyPy"], "extras": ["security", "socks"]}
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f2293605cf1b01dca72aad0a15c45b72ed5429a2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests-2.24.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+requests
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a899df67fb619d871db8b62eea9c1ed436c3a79
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__init__.py
@@ -0,0 +1,131 @@
+# -*- coding: utf-8 -*-
+
+#   __
+#  /__)  _  _     _   _ _/   _
+# / (   (- (/ (/ (- _)  /  _)
+#          /
+
+"""
+Requests HTTP Library
+~~~~~~~~~~~~~~~~~~~~~
+
+Requests is an HTTP library, written in Python, for human beings. Basic GET
+usage:
+
+   >>> import requests
+   >>> r = requests.get('https://www.python.org')
+   >>> r.status_code
+   200
+   >>> 'Python is a programming language' in r.content
+   True
+
+... or POST:
+
+   >>> payload = dict(key1='value1', key2='value2')
+   >>> r = requests.post('https://httpbin.org/post', data=payload)
+   >>> print(r.text)
+   {
+     ...
+     "form": {
+       "key2": "value2",
+       "key1": "value1"
+     },
+     ...
+   }
+
+The other HTTP methods are supported - see `requests.api`. Full documentation
+is at <http://python-requests.org>.
+
+:copyright: (c) 2017 by Kenneth Reitz.
+:license: Apache 2.0, see LICENSE for more details.
+"""
+
+import urllib3
+import chardet
+import warnings
+from .exceptions import RequestsDependencyWarning
+
+
+def check_compatibility(urllib3_version, chardet_version):
+    urllib3_version = urllib3_version.split('.')
+    assert urllib3_version != ['dev']  # Verify urllib3 isn't installed from git.
+
+    # Sometimes, urllib3 only reports its version as 16.1.
+    if len(urllib3_version) == 2:
+        urllib3_version.append('0')
+
+    # Check urllib3 for compatibility.
+    major, minor, patch = urllib3_version  # noqa: F811
+    major, minor, patch = int(major), int(minor), int(patch)
+    # urllib3 >= 1.21.1, <= 1.25
+    assert major == 1
+    assert minor >= 21
+    assert minor <= 25
+
+    # Check chardet for compatibility.
+    major, minor, patch = chardet_version.split('.')[:3]
+    major, minor, patch = int(major), int(minor), int(patch)
+    # chardet >= 3.0.2, < 3.1.0
+    assert major == 3
+    assert minor < 1
+    assert patch >= 2
+
+
+def _check_cryptography(cryptography_version):
+    # cryptography < 1.3.4
+    try:
+        cryptography_version = list(map(int, cryptography_version.split('.')))
+    except ValueError:
+        return
+
+    if cryptography_version < [1, 3, 4]:
+        warning = 'Old version of cryptography ({}) may cause slowdown.'.format(cryptography_version)
+        warnings.warn(warning, RequestsDependencyWarning)
+
+# Check imported dependencies for compatibility.
+try:
+    check_compatibility(urllib3.__version__, chardet.__version__)
+except (AssertionError, ValueError):
+    warnings.warn("urllib3 ({}) or chardet ({}) doesn't match a supported "
+                  "version!".format(urllib3.__version__, chardet.__version__),
+                  RequestsDependencyWarning)
+
+# Attempt to enable urllib3's SNI support, if possible
+try:
+    from urllib3.contrib import pyopenssl
+    pyopenssl.inject_into_urllib3()
+
+    # Check cryptography version
+    from cryptography import __version__ as cryptography_version
+    _check_cryptography(cryptography_version)
+except ImportError:
+    pass
+
+# urllib3's DependencyWarnings should be silenced.
+from urllib3.exceptions import DependencyWarning
+warnings.simplefilter('ignore', DependencyWarning)
+
+from .__version__ import __title__, __description__, __url__, __version__
+from .__version__ import __build__, __author__, __author_email__, __license__
+from .__version__ import __copyright__, __cake__
+
+from . import utils
+from . import packages
+from .models import Request, Response, PreparedRequest
+from .api import request, get, head, post, patch, put, delete, options
+from .sessions import session, Session
+from .status_codes import codes
+from .exceptions import (
+    RequestException, Timeout, URLRequired,
+    TooManyRedirects, HTTPError, ConnectionError,
+    FileModeWarning, ConnectTimeout, ReadTimeout
+)
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+from logging import NullHandler
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+# FileModeWarnings go off per the default.
+warnings.simplefilter('default', FileModeWarning, append=True)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__version__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__version__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9844f740abea47edbe57cb01d181b341d021ffb1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/__version__.py
@@ -0,0 +1,14 @@
+# .-. .-. .-. . . .-. .-. .-. .-.
+# |(  |-  |.| | | |-  `-.  |  `-.
+# ' ' `-' `-`.`-' `-' `-'  '  `-'
+
+__title__ = 'requests'
+__description__ = 'Python HTTP for Humans.'
+__url__ = 'http://python-requests.org'
+__version__ = '2.22.0'
+__build__ = 0x022200
+__author__ = 'Kenneth Reitz'
+__author_email__ = 'me@kennethreitz.org'
+__license__ = 'Apache 2.0'
+__copyright__ = 'Copyright 2019 Kenneth Reitz'
+__cake__ = u'\u2728 \U0001f370 \u2728'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/_internal_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/_internal_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..759d9a56ba0102bb3b7b3abfcfae6731a2ecc243
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/_internal_utils.py
@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests._internal_utils
+~~~~~~~~~~~~~~
+
+Provides utility functions that are consumed internally by Requests
+which depend on extremely few external helpers (such as compat)
+"""
+
+from .compat import is_py2, builtin_str, str
+
+
+def to_native_string(string, encoding='ascii'):
+    """Given a string object, regardless of type, returns a representation of
+    that string in the native string type, encoding and decoding where
+    necessary. This assumes ASCII unless told otherwise.
+    """
+    if isinstance(string, builtin_str):
+        out = string
+    else:
+        if is_py2:
+            out = string.encode(encoding)
+        else:
+            out = string.decode(encoding)
+
+    return out
+
+
+def unicode_is_ascii(u_string):
+    """Determine if unicode string only contains ASCII characters.
+
+    :param str u_string: unicode string to check. Must be unicode
+        and not Python 2 `str`.
+    :rtype: bool
+    """
+    assert isinstance(u_string, str)
+    try:
+        u_string.encode('ascii')
+        return True
+    except UnicodeEncodeError:
+        return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/adapters.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/adapters.py
new file mode 100644
index 0000000000000000000000000000000000000000..fa4d9b3cc9a2cf6dc2465958387f32193b431410
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/adapters.py
@@ -0,0 +1,533 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.adapters
+~~~~~~~~~~~~~~~~~
+
+This module contains the transport adapters that Requests uses to define
+and maintain connections.
+"""
+
+import os.path
+import socket
+
+from urllib3.poolmanager import PoolManager, proxy_from_url
+from urllib3.response import HTTPResponse
+from urllib3.util import parse_url
+from urllib3.util import Timeout as TimeoutSauce
+from urllib3.util.retry import Retry
+from urllib3.exceptions import ClosedPoolError
+from urllib3.exceptions import ConnectTimeoutError
+from urllib3.exceptions import HTTPError as _HTTPError
+from urllib3.exceptions import MaxRetryError
+from urllib3.exceptions import NewConnectionError
+from urllib3.exceptions import ProxyError as _ProxyError
+from urllib3.exceptions import ProtocolError
+from urllib3.exceptions import ReadTimeoutError
+from urllib3.exceptions import SSLError as _SSLError
+from urllib3.exceptions import ResponseError
+from urllib3.exceptions import LocationValueError
+
+from .models import Response
+from .compat import urlparse, basestring
+from .utils import (DEFAULT_CA_BUNDLE_PATH, extract_zipped_paths,
+                    get_encoding_from_headers, prepend_scheme_if_needed,
+                    get_auth_from_url, urldefragauth, select_proxy)
+from .structures import CaseInsensitiveDict
+from .cookies import extract_cookies_to_jar
+from .exceptions import (ConnectionError, ConnectTimeout, ReadTimeout, SSLError,
+                         ProxyError, RetryError, InvalidSchema, InvalidProxyURL,
+                         InvalidURL)
+from .auth import _basic_auth_str
+
+try:
+    from urllib3.contrib.socks import SOCKSProxyManager
+except ImportError:
+    def SOCKSProxyManager(*args, **kwargs):
+        raise InvalidSchema("Missing dependencies for SOCKS support.")
+
+DEFAULT_POOLBLOCK = False
+DEFAULT_POOLSIZE = 10
+DEFAULT_RETRIES = 0
+DEFAULT_POOL_TIMEOUT = None
+
+
+class BaseAdapter(object):
+    """The Base Transport Adapter"""
+
+    def __init__(self):
+        super(BaseAdapter, self).__init__()
+
+    def send(self, request, stream=False, timeout=None, verify=True,
+             cert=None, proxies=None):
+        """Sends PreparedRequest object. Returns Response object.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param stream: (optional) Whether to stream the request content.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple
+        :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use
+        :param cert: (optional) Any user-provided SSL certificate to be trusted.
+        :param proxies: (optional) The proxies dictionary to apply to the request.
+        """
+        raise NotImplementedError
+
+    def close(self):
+        """Cleans up adapter specific items."""
+        raise NotImplementedError
+
+
+class HTTPAdapter(BaseAdapter):
+    """The built-in HTTP Adapter for urllib3.
+
+    Provides a general-case interface for Requests sessions to contact HTTP and
+    HTTPS urls by implementing the Transport Adapter interface. This class will
+    usually be created by the :class:`Session <Session>` class under the
+    covers.
+
+    :param pool_connections: The number of urllib3 connection pools to cache.
+    :param pool_maxsize: The maximum number of connections to save in the pool.
+    :param max_retries: The maximum number of retries each connection
+        should attempt. Note, this applies only to failed DNS lookups, socket
+        connections and connection timeouts, never to requests where data has
+        made it to the server. By default, Requests does not retry failed
+        connections. If you need granular control over the conditions under
+        which we retry a request, import urllib3's ``Retry`` class and pass
+        that instead.
+    :param pool_block: Whether the connection pool should block for connections.
+
+    Usage::
+
+      >>> import requests
+      >>> s = requests.Session()
+      >>> a = requests.adapters.HTTPAdapter(max_retries=3)
+      >>> s.mount('http://', a)
+    """
+    __attrs__ = ['max_retries', 'config', '_pool_connections', '_pool_maxsize',
+                 '_pool_block']
+
+    def __init__(self, pool_connections=DEFAULT_POOLSIZE,
+                 pool_maxsize=DEFAULT_POOLSIZE, max_retries=DEFAULT_RETRIES,
+                 pool_block=DEFAULT_POOLBLOCK):
+        if max_retries == DEFAULT_RETRIES:
+            self.max_retries = Retry(0, read=False)
+        else:
+            self.max_retries = Retry.from_int(max_retries)
+        self.config = {}
+        self.proxy_manager = {}
+
+        super(HTTPAdapter, self).__init__()
+
+        self._pool_connections = pool_connections
+        self._pool_maxsize = pool_maxsize
+        self._pool_block = pool_block
+
+        self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block)
+
+    def __getstate__(self):
+        return {attr: getattr(self, attr, None) for attr in self.__attrs__}
+
+    def __setstate__(self, state):
+        # Can't handle by adding 'proxy_manager' to self.__attrs__ because
+        # self.poolmanager uses a lambda function, which isn't pickleable.
+        self.proxy_manager = {}
+        self.config = {}
+
+        for attr, value in state.items():
+            setattr(self, attr, value)
+
+        self.init_poolmanager(self._pool_connections, self._pool_maxsize,
+                              block=self._pool_block)
+
+    def init_poolmanager(self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs):
+        """Initializes a urllib3 PoolManager.
+
+        This method should not be called from user code, and is only
+        exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param connections: The number of urllib3 connection pools to cache.
+        :param maxsize: The maximum number of connections to save in the pool.
+        :param block: Block when no free connections are available.
+        :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager.
+        """
+        # save these values for pickling
+        self._pool_connections = connections
+        self._pool_maxsize = maxsize
+        self._pool_block = block
+
+        self.poolmanager = PoolManager(num_pools=connections, maxsize=maxsize,
+                                       block=block, strict=True, **pool_kwargs)
+
+    def proxy_manager_for(self, proxy, **proxy_kwargs):
+        """Return urllib3 ProxyManager for the given proxy.
+
+        This method should not be called from user code, and is only
+        exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param proxy: The proxy to return a urllib3 ProxyManager for.
+        :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager.
+        :returns: ProxyManager
+        :rtype: urllib3.ProxyManager
+        """
+        if proxy in self.proxy_manager:
+            manager = self.proxy_manager[proxy]
+        elif proxy.lower().startswith('socks'):
+            username, password = get_auth_from_url(proxy)
+            manager = self.proxy_manager[proxy] = SOCKSProxyManager(
+                proxy,
+                username=username,
+                password=password,
+                num_pools=self._pool_connections,
+                maxsize=self._pool_maxsize,
+                block=self._pool_block,
+                **proxy_kwargs
+            )
+        else:
+            proxy_headers = self.proxy_headers(proxy)
+            manager = self.proxy_manager[proxy] = proxy_from_url(
+                proxy,
+                proxy_headers=proxy_headers,
+                num_pools=self._pool_connections,
+                maxsize=self._pool_maxsize,
+                block=self._pool_block,
+                **proxy_kwargs)
+
+        return manager
+
+    def cert_verify(self, conn, url, verify, cert):
+        """Verify a SSL certificate. This method should not be called from user
+        code, and is only exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param conn: The urllib3 connection object associated with the cert.
+        :param url: The requested URL.
+        :param verify: Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use
+        :param cert: The SSL certificate to verify.
+        """
+        if url.lower().startswith('https') and verify:
+
+            cert_loc = None
+
+            # Allow self-specified cert location.
+            if verify is not True:
+                cert_loc = verify
+
+            if not cert_loc:
+                cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)
+
+            if not cert_loc or not os.path.exists(cert_loc):
+                raise IOError("Could not find a suitable TLS CA certificate bundle, "
+                              "invalid path: {}".format(cert_loc))
+
+            conn.cert_reqs = 'CERT_REQUIRED'
+
+            if not os.path.isdir(cert_loc):
+                conn.ca_certs = cert_loc
+            else:
+                conn.ca_cert_dir = cert_loc
+        else:
+            conn.cert_reqs = 'CERT_NONE'
+            conn.ca_certs = None
+            conn.ca_cert_dir = None
+
+        if cert:
+            if not isinstance(cert, basestring):
+                conn.cert_file = cert[0]
+                conn.key_file = cert[1]
+            else:
+                conn.cert_file = cert
+                conn.key_file = None
+            if conn.cert_file and not os.path.exists(conn.cert_file):
+                raise IOError("Could not find the TLS certificate file, "
+                              "invalid path: {}".format(conn.cert_file))
+            if conn.key_file and not os.path.exists(conn.key_file):
+                raise IOError("Could not find the TLS key file, "
+                              "invalid path: {}".format(conn.key_file))
+
+    def build_response(self, req, resp):
+        """Builds a :class:`Response <requests.Response>` object from a urllib3
+        response. This should not be called from user code, and is only exposed
+        for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`
+
+        :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response.
+        :param resp: The urllib3 response object.
+        :rtype: requests.Response
+        """
+        response = Response()
+
+        # Fallback to None if there's no status_code, for whatever reason.
+        response.status_code = getattr(resp, 'status', None)
+
+        # Make headers case-insensitive.
+        response.headers = CaseInsensitiveDict(getattr(resp, 'headers', {}))
+
+        # Set encoding.
+        response.encoding = get_encoding_from_headers(response.headers)
+        response.raw = resp
+        response.reason = response.raw.reason
+
+        if isinstance(req.url, bytes):
+            response.url = req.url.decode('utf-8')
+        else:
+            response.url = req.url
+
+        # Add new cookies from the server.
+        extract_cookies_to_jar(response.cookies, req, resp)
+
+        # Give the Response some context.
+        response.request = req
+        response.connection = self
+
+        return response
+
+    def get_connection(self, url, proxies=None):
+        """Returns a urllib3 connection for the given URL. This should not be
+        called from user code, and is only exposed for use when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param url: The URL to connect to.
+        :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
+        :rtype: urllib3.ConnectionPool
+        """
+        proxy = select_proxy(url, proxies)
+
+        if proxy:
+            proxy = prepend_scheme_if_needed(proxy, 'http')
+            proxy_url = parse_url(proxy)
+            if not proxy_url.host:
+                raise InvalidProxyURL("Please check proxy URL. It is malformed"
+                                      " and could be missing the host.")
+            proxy_manager = self.proxy_manager_for(proxy)
+            conn = proxy_manager.connection_from_url(url)
+        else:
+            # Only scheme should be lower case
+            parsed = urlparse(url)
+            url = parsed.geturl()
+            conn = self.poolmanager.connection_from_url(url)
+
+        return conn
+
+    def close(self):
+        """Disposes of any internal state.
+
+        Currently, this closes the PoolManager and any active ProxyManager,
+        which closes any pooled connections.
+        """
+        self.poolmanager.clear()
+        for proxy in self.proxy_manager.values():
+            proxy.clear()
+
+    def request_url(self, request, proxies):
+        """Obtain the url to use when making the final request.
+
+        If the message is being sent through a HTTP proxy, the full URL has to
+        be used. Otherwise, we should only use the path portion of the URL.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
+        :rtype: str
+        """
+        proxy = select_proxy(request.url, proxies)
+        scheme = urlparse(request.url).scheme
+
+        is_proxied_http_request = (proxy and scheme != 'https')
+        using_socks_proxy = False
+        if proxy:
+            proxy_scheme = urlparse(proxy).scheme.lower()
+            using_socks_proxy = proxy_scheme.startswith('socks')
+
+        url = request.path_url
+        if is_proxied_http_request and not using_socks_proxy:
+            url = urldefragauth(request.url)
+
+        return url
+
+    def add_headers(self, request, **kwargs):
+        """Add any headers needed by the connection. As of v2.0 this does
+        nothing by default, but is left for overriding by users that subclass
+        the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to.
+        :param kwargs: The keyword arguments from the call to send().
+        """
+        pass
+
+    def proxy_headers(self, proxy):
+        """Returns a dictionary of the headers to add to any request sent
+        through a proxy. This works with urllib3 magic to ensure that they are
+        correctly sent to the proxy, rather than in a tunnelled request if
+        CONNECT is being used.
+
+        This should not be called from user code, and is only exposed for use
+        when subclassing the
+        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.
+
+        :param proxy: The url of the proxy being used for this request.
+        :rtype: dict
+        """
+        headers = {}
+        username, password = get_auth_from_url(proxy)
+
+        if username:
+            headers['Proxy-Authorization'] = _basic_auth_str(username,
+                                                             password)
+
+        return headers
+
+    def send(self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None):
+        """Sends PreparedRequest object. Returns Response object.
+
+        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
+        :param stream: (optional) Whether to stream the request content.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple or urllib3 Timeout object
+        :param verify: (optional) Either a boolean, in which case it controls whether
+            we verify the server's TLS certificate, or a string, in which case it
+            must be a path to a CA bundle to use
+        :param cert: (optional) Any user-provided SSL certificate to be trusted.
+        :param proxies: (optional) The proxies dictionary to apply to the request.
+        :rtype: requests.Response
+        """
+
+        try:
+            conn = self.get_connection(request.url, proxies)
+        except LocationValueError as e:
+            raise InvalidURL(e, request=request)
+
+        self.cert_verify(conn, request.url, verify, cert)
+        url = self.request_url(request, proxies)
+        self.add_headers(request, stream=stream, timeout=timeout, verify=verify, cert=cert, proxies=proxies)
+
+        chunked = not (request.body is None or 'Content-Length' in request.headers)
+
+        if isinstance(timeout, tuple):
+            try:
+                connect, read = timeout
+                timeout = TimeoutSauce(connect=connect, read=read)
+            except ValueError as e:
+                # this may raise a string formatting error.
+                err = ("Invalid timeout {}. Pass a (connect, read) "
+                       "timeout tuple, or a single float to set "
+                       "both timeouts to the same value".format(timeout))
+                raise ValueError(err)
+        elif isinstance(timeout, TimeoutSauce):
+            pass
+        else:
+            timeout = TimeoutSauce(connect=timeout, read=timeout)
+
+        try:
+            if not chunked:
+                resp = conn.urlopen(
+                    method=request.method,
+                    url=url,
+                    body=request.body,
+                    headers=request.headers,
+                    redirect=False,
+                    assert_same_host=False,
+                    preload_content=False,
+                    decode_content=False,
+                    retries=self.max_retries,
+                    timeout=timeout
+                )
+
+            # Send the request.
+            else:
+                if hasattr(conn, 'proxy_pool'):
+                    conn = conn.proxy_pool
+
+                low_conn = conn._get_conn(timeout=DEFAULT_POOL_TIMEOUT)
+
+                try:
+                    low_conn.putrequest(request.method,
+                                        url,
+                                        skip_accept_encoding=True)
+
+                    for header, value in request.headers.items():
+                        low_conn.putheader(header, value)
+
+                    low_conn.endheaders()
+
+                    for i in request.body:
+                        low_conn.send(hex(len(i))[2:].encode('utf-8'))
+                        low_conn.send(b'\r\n')
+                        low_conn.send(i)
+                        low_conn.send(b'\r\n')
+                    low_conn.send(b'0\r\n\r\n')
+
+                    # Receive the response from the server
+                    try:
+                        # For Python 2.7, use buffering of HTTP responses
+                        r = low_conn.getresponse(buffering=True)
+                    except TypeError:
+                        # For compatibility with Python 3.3+
+                        r = low_conn.getresponse()
+
+                    resp = HTTPResponse.from_httplib(
+                        r,
+                        pool=conn,
+                        connection=low_conn,
+                        preload_content=False,
+                        decode_content=False
+                    )
+                except:
+                    # If we hit any problems here, clean up the connection.
+                    # Then, reraise so that we can handle the actual exception.
+                    low_conn.close()
+                    raise
+
+        except (ProtocolError, socket.error) as err:
+            raise ConnectionError(err, request=request)
+
+        except MaxRetryError as e:
+            if isinstance(e.reason, ConnectTimeoutError):
+                # TODO: Remove this in 3.0.0: see #2811
+                if not isinstance(e.reason, NewConnectionError):
+                    raise ConnectTimeout(e, request=request)
+
+            if isinstance(e.reason, ResponseError):
+                raise RetryError(e, request=request)
+
+            if isinstance(e.reason, _ProxyError):
+                raise ProxyError(e, request=request)
+
+            if isinstance(e.reason, _SSLError):
+                # This branch is for urllib3 v1.22 and later.
+                raise SSLError(e, request=request)
+
+            raise ConnectionError(e, request=request)
+
+        except ClosedPoolError as e:
+            raise ConnectionError(e, request=request)
+
+        except _ProxyError as e:
+            raise ProxyError(e)
+
+        except (_SSLError, _HTTPError) as e:
+            if isinstance(e, _SSLError):
+                # This branch is for urllib3 versions earlier than v1.22
+                raise SSLError(e, request=request)
+            elif isinstance(e, ReadTimeoutError):
+                raise ReadTimeout(e, request=request)
+            else:
+                raise
+
+        return self.build_response(request, resp)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/api.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/api.py
new file mode 100644
index 0000000000000000000000000000000000000000..ef71d0759ea9f3c38bae8dd227371042c959dcb7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/api.py
@@ -0,0 +1,158 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.api
+~~~~~~~~~~~~
+
+This module implements the Requests API.
+
+:copyright: (c) 2012 by Kenneth Reitz.
+:license: Apache2, see LICENSE for more details.
+"""
+
+from . import sessions
+
+
+def request(method, url, **kwargs):
+    """Constructs and sends a :class:`Request <Request>`.
+
+    :param method: method for the new :class:`Request` object.
+    :param url: URL for the new :class:`Request` object.
+    :param params: (optional) Dictionary, list of tuples or bytes to send
+        in the query string for the :class:`Request`.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
+    :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
+    :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
+    :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
+        ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
+        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
+        defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
+        to add for the file.
+    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
+    :param timeout: (optional) How many seconds to wait for the server to send data
+        before giving up, as a float, or a :ref:`(connect timeout, read
+        timeout) <timeouts>` tuple.
+    :type timeout: float or tuple
+    :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
+    :type allow_redirects: bool
+    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
+    :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use. Defaults to ``True``.
+    :param stream: (optional) if ``False``, the response content will be immediately downloaded.
+    :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.request('GET', 'https://httpbin.org/get')
+      <Response [200]>
+    """
+
+    # By using the 'with' statement we are sure the session is closed, thus we
+    # avoid leaving sockets open which can trigger a ResourceWarning in some
+    # cases, and look like a memory leak in others.
+    with sessions.Session() as session:
+        return session.request(method=method, url=url, **kwargs)
+
+
+def get(url, params=None, **kwargs):
+    r"""Sends a GET request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param params: (optional) Dictionary, list of tuples or bytes to send
+        in the query string for the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    kwargs.setdefault('allow_redirects', True)
+    return request('get', url, params=params, **kwargs)
+
+
+def options(url, **kwargs):
+    r"""Sends an OPTIONS request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    kwargs.setdefault('allow_redirects', True)
+    return request('options', url, **kwargs)
+
+
+def head(url, **kwargs):
+    r"""Sends a HEAD request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    kwargs.setdefault('allow_redirects', False)
+    return request('head', url, **kwargs)
+
+
+def post(url, data=None, json=None, **kwargs):
+    r"""Sends a POST request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('post', url, data=data, json=json, **kwargs)
+
+
+def put(url, data=None, **kwargs):
+    r"""Sends a PUT request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('put', url, data=data, **kwargs)
+
+
+def patch(url, data=None, **kwargs):
+    r"""Sends a PATCH request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+        object to send in the body of the :class:`Request`.
+    :param json: (optional) json data to send in the body of the :class:`Request`.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('patch', url, data=data, **kwargs)
+
+
+def delete(url, **kwargs):
+    r"""Sends a DELETE request.
+
+    :param url: URL for the new :class:`Request` object.
+    :param \*\*kwargs: Optional arguments that ``request`` takes.
+    :return: :class:`Response <Response>` object
+    :rtype: requests.Response
+    """
+
+    return request('delete', url, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/auth.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/auth.py
new file mode 100644
index 0000000000000000000000000000000000000000..bdde51c7fd1b0f1e3c7adeb8f2bf2587cdfab122
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/auth.py
@@ -0,0 +1,305 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.auth
+~~~~~~~~~~~~~
+
+This module contains the authentication handlers for Requests.
+"""
+
+import os
+import re
+import time
+import hashlib
+import threading
+import warnings
+
+from base64 import b64encode
+
+from .compat import urlparse, str, basestring
+from .cookies import extract_cookies_to_jar
+from ._internal_utils import to_native_string
+from .utils import parse_dict_header
+
+CONTENT_TYPE_FORM_URLENCODED = 'application/x-www-form-urlencoded'
+CONTENT_TYPE_MULTI_PART = 'multipart/form-data'
+
+
+def _basic_auth_str(username, password):
+    """Returns a Basic Auth string."""
+
+    # "I want us to put a big-ol' comment on top of it that
+    # says that this behaviour is dumb but we need to preserve
+    # it because people are relying on it."
+    #    - Lukasa
+    #
+    # These are here solely to maintain backwards compatibility
+    # for things like ints. This will be removed in 3.0.0.
+    if not isinstance(username, basestring):
+        warnings.warn(
+            "Non-string usernames will no longer be supported in Requests "
+            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            "a string or bytes object in the near future to avoid "
+            "problems.".format(username),
+            category=DeprecationWarning,
+        )
+        username = str(username)
+
+    if not isinstance(password, basestring):
+        warnings.warn(
+            "Non-string passwords will no longer be supported in Requests "
+            "3.0.0. Please convert the object you've passed in ({!r}) to "
+            "a string or bytes object in the near future to avoid "
+            "problems.".format(password),
+            category=DeprecationWarning,
+        )
+        password = str(password)
+    # -- End Removal --
+
+    if isinstance(username, str):
+        username = username.encode('latin1')
+
+    if isinstance(password, str):
+        password = password.encode('latin1')
+
+    authstr = 'Basic ' + to_native_string(
+        b64encode(b':'.join((username, password))).strip()
+    )
+
+    return authstr
+
+
+class AuthBase(object):
+    """Base class that all auth implementations derive from"""
+
+    def __call__(self, r):
+        raise NotImplementedError('Auth hooks must be callable.')
+
+
+class HTTPBasicAuth(AuthBase):
+    """Attaches HTTP Basic Authentication to the given Request object."""
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+
+    def __eq__(self, other):
+        return all([
+            self.username == getattr(other, 'username', None),
+            self.password == getattr(other, 'password', None)
+        ])
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __call__(self, r):
+        r.headers['Authorization'] = _basic_auth_str(self.username, self.password)
+        return r
+
+
+class HTTPProxyAuth(HTTPBasicAuth):
+    """Attaches HTTP Proxy Authentication to a given Request object."""
+
+    def __call__(self, r):
+        r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password)
+        return r
+
+
+class HTTPDigestAuth(AuthBase):
+    """Attaches HTTP Digest Authentication to the given Request object."""
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+        # Keep state in per-thread local storage
+        self._thread_local = threading.local()
+
+    def init_per_thread_state(self):
+        # Ensure state is initialized just once per-thread
+        if not hasattr(self._thread_local, 'init'):
+            self._thread_local.init = True
+            self._thread_local.last_nonce = ''
+            self._thread_local.nonce_count = 0
+            self._thread_local.chal = {}
+            self._thread_local.pos = None
+            self._thread_local.num_401_calls = None
+
+    def build_digest_header(self, method, url):
+        """
+        :rtype: str
+        """
+
+        realm = self._thread_local.chal['realm']
+        nonce = self._thread_local.chal['nonce']
+        qop = self._thread_local.chal.get('qop')
+        algorithm = self._thread_local.chal.get('algorithm')
+        opaque = self._thread_local.chal.get('opaque')
+        hash_utf8 = None
+
+        if algorithm is None:
+            _algorithm = 'MD5'
+        else:
+            _algorithm = algorithm.upper()
+        # lambdas assume digest modules are imported at the top level
+        if _algorithm == 'MD5' or _algorithm == 'MD5-SESS':
+            def md5_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.md5(x).hexdigest()
+            hash_utf8 = md5_utf8
+        elif _algorithm == 'SHA':
+            def sha_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha1(x).hexdigest()
+            hash_utf8 = sha_utf8
+        elif _algorithm == 'SHA-256':
+            def sha256_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha256(x).hexdigest()
+            hash_utf8 = sha256_utf8
+        elif _algorithm == 'SHA-512':
+            def sha512_utf8(x):
+                if isinstance(x, str):
+                    x = x.encode('utf-8')
+                return hashlib.sha512(x).hexdigest()
+            hash_utf8 = sha512_utf8
+
+        KD = lambda s, d: hash_utf8("%s:%s" % (s, d))
+
+        if hash_utf8 is None:
+            return None
+
+        # XXX not implemented yet
+        entdig = None
+        p_parsed = urlparse(url)
+        #: path is request-uri defined in RFC 2616 which should not be empty
+        path = p_parsed.path or "/"
+        if p_parsed.query:
+            path += '?' + p_parsed.query
+
+        A1 = '%s:%s:%s' % (self.username, realm, self.password)
+        A2 = '%s:%s' % (method, path)
+
+        HA1 = hash_utf8(A1)
+        HA2 = hash_utf8(A2)
+
+        if nonce == self._thread_local.last_nonce:
+            self._thread_local.nonce_count += 1
+        else:
+            self._thread_local.nonce_count = 1
+        ncvalue = '%08x' % self._thread_local.nonce_count
+        s = str(self._thread_local.nonce_count).encode('utf-8')
+        s += nonce.encode('utf-8')
+        s += time.ctime().encode('utf-8')
+        s += os.urandom(8)
+
+        cnonce = (hashlib.sha1(s).hexdigest()[:16])
+        if _algorithm == 'MD5-SESS':
+            HA1 = hash_utf8('%s:%s:%s' % (HA1, nonce, cnonce))
+
+        if not qop:
+            respdig = KD(HA1, "%s:%s" % (nonce, HA2))
+        elif qop == 'auth' or 'auth' in qop.split(','):
+            noncebit = "%s:%s:%s:%s:%s" % (
+                nonce, ncvalue, cnonce, 'auth', HA2
+            )
+            respdig = KD(HA1, noncebit)
+        else:
+            # XXX handle auth-int.
+            return None
+
+        self._thread_local.last_nonce = nonce
+
+        # XXX should the partial digests be encoded too?
+        base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
+               'response="%s"' % (self.username, realm, nonce, path, respdig)
+        if opaque:
+            base += ', opaque="%s"' % opaque
+        if algorithm:
+            base += ', algorithm="%s"' % algorithm
+        if entdig:
+            base += ', digest="%s"' % entdig
+        if qop:
+            base += ', qop="auth", nc=%s, cnonce="%s"' % (ncvalue, cnonce)
+
+        return 'Digest %s' % (base)
+
+    def handle_redirect(self, r, **kwargs):
+        """Reset num_401_calls counter on redirects."""
+        if r.is_redirect:
+            self._thread_local.num_401_calls = 1
+
+    def handle_401(self, r, **kwargs):
+        """
+        Takes the given response and tries digest-auth, if needed.
+
+        :rtype: requests.Response
+        """
+
+        # If response is not 4xx, do not auth
+        # See https://github.com/requests/requests/issues/3772
+        if not 400 <= r.status_code < 500:
+            self._thread_local.num_401_calls = 1
+            return r
+
+        if self._thread_local.pos is not None:
+            # Rewind the file position indicator of the body to where
+            # it was to resend the request.
+            r.request.body.seek(self._thread_local.pos)
+        s_auth = r.headers.get('www-authenticate', '')
+
+        if 'digest' in s_auth.lower() and self._thread_local.num_401_calls < 2:
+
+            self._thread_local.num_401_calls += 1
+            pat = re.compile(r'digest ', flags=re.IGNORECASE)
+            self._thread_local.chal = parse_dict_header(pat.sub('', s_auth, count=1))
+
+            # Consume content and release the original connection
+            # to allow our new request to reuse the same one.
+            r.content
+            r.close()
+            prep = r.request.copy()
+            extract_cookies_to_jar(prep._cookies, r.request, r.raw)
+            prep.prepare_cookies(prep._cookies)
+
+            prep.headers['Authorization'] = self.build_digest_header(
+                prep.method, prep.url)
+            _r = r.connection.send(prep, **kwargs)
+            _r.history.append(r)
+            _r.request = prep
+
+            return _r
+
+        self._thread_local.num_401_calls = 1
+        return r
+
+    def __call__(self, r):
+        # Initialize per-thread state, if needed
+        self.init_per_thread_state()
+        # If we have a saved nonce, skip the 401
+        if self._thread_local.last_nonce:
+            r.headers['Authorization'] = self.build_digest_header(r.method, r.url)
+        try:
+            self._thread_local.pos = r.body.tell()
+        except AttributeError:
+            # In the case of HTTPDigestAuth being reused and the body of
+            # the previous request was a file-like object, pos has the
+            # file position of the previous body. Ensure it's set to
+            # None.
+            self._thread_local.pos = None
+        r.register_hook('response', self.handle_401)
+        r.register_hook('response', self.handle_redirect)
+        self._thread_local.num_401_calls = 1
+
+        return r
+
+    def __eq__(self, other):
+        return all([
+            self.username == getattr(other, 'username', None),
+            self.password == getattr(other, 'password', None)
+        ])
+
+    def __ne__(self, other):
+        return not self == other
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/certs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/certs.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1a378d787d5a220ef2df694c5cbcd6b4015cbea
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/certs.py
@@ -0,0 +1,18 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""
+requests.certs
+~~~~~~~~~~~~~~
+
+This module returns the preferred default CA certificate bundle. There is
+only one — the one from the certifi package.
+
+If you are packaging Requests, e.g., for a Linux distribution or a managed
+environment, you can change the definition of where() to return a separately
+packaged CA bundle.
+"""
+from certifi import where
+
+if __name__ == '__main__':
+    print(where())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..c44b35efb984650802c40efbc5281b875bae4adc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/compat.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.compat
+~~~~~~~~~~~~~~~
+
+This module handles import compatibility issues between Python 2 and
+Python 3.
+"""
+
+import chardet
+
+import sys
+
+# -------
+# Pythons
+# -------
+
+# Syntax sugar.
+_ver = sys.version_info
+
+#: Python 2.x?
+is_py2 = (_ver[0] == 2)
+
+#: Python 3.x?
+is_py3 = (_ver[0] == 3)
+
+try:
+    import simplejson as json
+except ImportError:
+    import json
+
+# ---------
+# Specifics
+# ---------
+
+if is_py2:
+    from urllib import (
+        quote, unquote, quote_plus, unquote_plus, urlencode, getproxies,
+        proxy_bypass, proxy_bypass_environment, getproxies_environment)
+    from urlparse import urlparse, urlunparse, urljoin, urlsplit, urldefrag
+    from urllib2 import parse_http_list
+    import cookielib
+    from Cookie import Morsel
+    from StringIO import StringIO
+    from collections import Callable, Mapping, MutableMapping, OrderedDict
+
+
+    builtin_str = str
+    bytes = str
+    str = unicode
+    basestring = basestring
+    numeric_types = (int, long, float)
+    integer_types = (int, long)
+
+elif is_py3:
+    from urllib.parse import urlparse, urlunparse, urljoin, urlsplit, urlencode, quote, unquote, quote_plus, unquote_plus, urldefrag
+    from urllib.request import parse_http_list, getproxies, proxy_bypass, proxy_bypass_environment, getproxies_environment
+    from http import cookiejar as cookielib
+    from http.cookies import Morsel
+    from io import StringIO
+    from collections import OrderedDict
+    from collections.abc import Callable, Mapping, MutableMapping
+
+    builtin_str = str
+    str = str
+    bytes = bytes
+    basestring = (str, bytes)
+    numeric_types = (int, float)
+    integer_types = (int,)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/cookies.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/cookies.py
new file mode 100644
index 0000000000000000000000000000000000000000..56fccd9c2570d2a31365ed11278fd1b6ecc2aa54
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/cookies.py
@@ -0,0 +1,549 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.cookies
+~~~~~~~~~~~~~~~~
+
+Compatibility code to be able to use `cookielib.CookieJar` with requests.
+
+requests.utils imports from here, so be careful with imports.
+"""
+
+import copy
+import time
+import calendar
+
+from ._internal_utils import to_native_string
+from .compat import cookielib, urlparse, urlunparse, Morsel, MutableMapping
+
+try:
+    import threading
+except ImportError:
+    import dummy_threading as threading
+
+
+class MockRequest(object):
+    """Wraps a `requests.Request` to mimic a `urllib2.Request`.
+
+    The code in `cookielib.CookieJar` expects this interface in order to correctly
+    manage cookie policies, i.e., determine whether a cookie can be set, given the
+    domains of the request and the cookie.
+
+    The original request object is read-only. The client is responsible for collecting
+    the new headers via `get_new_headers()` and interpreting them appropriately. You
+    probably want `get_cookie_header`, defined below.
+    """
+
+    def __init__(self, request):
+        self._r = request
+        self._new_headers = {}
+        self.type = urlparse(self._r.url).scheme
+
+    def get_type(self):
+        return self.type
+
+    def get_host(self):
+        return urlparse(self._r.url).netloc
+
+    def get_origin_req_host(self):
+        return self.get_host()
+
+    def get_full_url(self):
+        # Only return the response's URL if the user hadn't set the Host
+        # header
+        if not self._r.headers.get('Host'):
+            return self._r.url
+        # If they did set it, retrieve it and reconstruct the expected domain
+        host = to_native_string(self._r.headers['Host'], encoding='utf-8')
+        parsed = urlparse(self._r.url)
+        # Reconstruct the URL as we expect it
+        return urlunparse([
+            parsed.scheme, host, parsed.path, parsed.params, parsed.query,
+            parsed.fragment
+        ])
+
+    def is_unverifiable(self):
+        return True
+
+    def has_header(self, name):
+        return name in self._r.headers or name in self._new_headers
+
+    def get_header(self, name, default=None):
+        return self._r.headers.get(name, self._new_headers.get(name, default))
+
+    def add_header(self, key, val):
+        """cookielib has no legitimate use for this method; add it back if you find one."""
+        raise NotImplementedError("Cookie headers should be added with add_unredirected_header()")
+
+    def add_unredirected_header(self, name, value):
+        self._new_headers[name] = value
+
+    def get_new_headers(self):
+        return self._new_headers
+
+    @property
+    def unverifiable(self):
+        return self.is_unverifiable()
+
+    @property
+    def origin_req_host(self):
+        return self.get_origin_req_host()
+
+    @property
+    def host(self):
+        return self.get_host()
+
+
+class MockResponse(object):
+    """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.
+
+    ...what? Basically, expose the parsed HTTP headers from the server response
+    the way `cookielib` expects to see them.
+    """
+
+    def __init__(self, headers):
+        """Make a MockResponse for `cookielib` to read.
+
+        :param headers: a httplib.HTTPMessage or analogous carrying the headers
+        """
+        self._headers = headers
+
+    def info(self):
+        return self._headers
+
+    def getheaders(self, name):
+        self._headers.getheaders(name)
+
+
+def extract_cookies_to_jar(jar, request, response):
+    """Extract the cookies from the response into a CookieJar.
+
+    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
+    :param request: our own requests.Request object
+    :param response: urllib3.HTTPResponse object
+    """
+    if not (hasattr(response, '_original_response') and
+            response._original_response):
+        return
+    # the _original_response field is the wrapped httplib.HTTPResponse object,
+    req = MockRequest(request)
+    # pull out the HTTPMessage with the headers and put it in the mock:
+    res = MockResponse(response._original_response.msg)
+    jar.extract_cookies(res, req)
+
+
+def get_cookie_header(jar, request):
+    """
+    Produce an appropriate Cookie header string to be sent with `request`, or None.
+
+    :rtype: str
+    """
+    r = MockRequest(request)
+    jar.add_cookie_header(r)
+    return r.get_new_headers().get('Cookie')
+
+
+def remove_cookie_by_name(cookiejar, name, domain=None, path=None):
+    """Unsets a cookie by name, by default over all domains and paths.
+
+    Wraps CookieJar.clear(), is O(n).
+    """
+    clearables = []
+    for cookie in cookiejar:
+        if cookie.name != name:
+            continue
+        if domain is not None and domain != cookie.domain:
+            continue
+        if path is not None and path != cookie.path:
+            continue
+        clearables.append((cookie.domain, cookie.path, cookie.name))
+
+    for domain, path, name in clearables:
+        cookiejar.clear(domain, path, name)
+
+
+class CookieConflictError(RuntimeError):
+    """There are two cookies that meet the criteria specified in the cookie jar.
+    Use .get and .set and include domain and path args in order to be more specific.
+    """
+
+
+class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
+    """Compatibility class; is a cookielib.CookieJar, but exposes a dict
+    interface.
+
+    This is the CookieJar we create by default for requests and sessions that
+    don't specify one, since some clients may expect response.cookies and
+    session.cookies to support dict operations.
+
+    Requests does not use the dict interface internally; it's just for
+    compatibility with external client code. All requests code should work
+    out of the box with externally provided instances of ``CookieJar``, e.g.
+    ``LWPCookieJar`` and ``FileCookieJar``.
+
+    Unlike a regular CookieJar, this class is pickleable.
+
+    .. warning:: dictionary operations that are normally O(1) may be O(n).
+    """
+
+    def get(self, name, default=None, domain=None, path=None):
+        """Dict-like get() that also supports optional domain and path args in
+        order to resolve naming collisions from using one cookie jar over
+        multiple domains.
+
+        .. warning:: operation is O(n), not O(1).
+        """
+        try:
+            return self._find_no_duplicates(name, domain, path)
+        except KeyError:
+            return default
+
+    def set(self, name, value, **kwargs):
+        """Dict-like set() that also supports optional domain and path args in
+        order to resolve naming collisions from using one cookie jar over
+        multiple domains.
+        """
+        # support client code that unsets cookies by assignment of a None value:
+        if value is None:
+            remove_cookie_by_name(self, name, domain=kwargs.get('domain'), path=kwargs.get('path'))
+            return
+
+        if isinstance(value, Morsel):
+            c = morsel_to_cookie(value)
+        else:
+            c = create_cookie(name, value, **kwargs)
+        self.set_cookie(c)
+        return c
+
+    def iterkeys(self):
+        """Dict-like iterkeys() that returns an iterator of names of cookies
+        from the jar.
+
+        .. seealso:: itervalues() and iteritems().
+        """
+        for cookie in iter(self):
+            yield cookie.name
+
+    def keys(self):
+        """Dict-like keys() that returns a list of names of cookies from the
+        jar.
+
+        .. seealso:: values() and items().
+        """
+        return list(self.iterkeys())
+
+    def itervalues(self):
+        """Dict-like itervalues() that returns an iterator of values of cookies
+        from the jar.
+
+        .. seealso:: iterkeys() and iteritems().
+        """
+        for cookie in iter(self):
+            yield cookie.value
+
+    def values(self):
+        """Dict-like values() that returns a list of values of cookies from the
+        jar.
+
+        .. seealso:: keys() and items().
+        """
+        return list(self.itervalues())
+
+    def iteritems(self):
+        """Dict-like iteritems() that returns an iterator of name-value tuples
+        from the jar.
+
+        .. seealso:: iterkeys() and itervalues().
+        """
+        for cookie in iter(self):
+            yield cookie.name, cookie.value
+
+    def items(self):
+        """Dict-like items() that returns a list of name-value tuples from the
+        jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
+        vanilla python dict of key value pairs.
+
+        .. seealso:: keys() and values().
+        """
+        return list(self.iteritems())
+
+    def list_domains(self):
+        """Utility method to list all the domains in the jar."""
+        domains = []
+        for cookie in iter(self):
+            if cookie.domain not in domains:
+                domains.append(cookie.domain)
+        return domains
+
+    def list_paths(self):
+        """Utility method to list all the paths in the jar."""
+        paths = []
+        for cookie in iter(self):
+            if cookie.path not in paths:
+                paths.append(cookie.path)
+        return paths
+
+    def multiple_domains(self):
+        """Returns True if there are multiple domains in the jar.
+        Returns False otherwise.
+
+        :rtype: bool
+        """
+        domains = []
+        for cookie in iter(self):
+            if cookie.domain is not None and cookie.domain in domains:
+                return True
+            domains.append(cookie.domain)
+        return False  # there is only one domain in jar
+
+    def get_dict(self, domain=None, path=None):
+        """Takes as an argument an optional domain and path and returns a plain
+        old Python dict of name-value pairs of cookies that meet the
+        requirements.
+
+        :rtype: dict
+        """
+        dictionary = {}
+        for cookie in iter(self):
+            if (
+                (domain is None or cookie.domain == domain) and
+                (path is None or cookie.path == path)
+            ):
+                dictionary[cookie.name] = cookie.value
+        return dictionary
+
+    def __contains__(self, name):
+        try:
+            return super(RequestsCookieJar, self).__contains__(name)
+        except CookieConflictError:
+            return True
+
+    def __getitem__(self, name):
+        """Dict-like __getitem__() for compatibility with client code. Throws
+        exception if there are more than one cookie with name. In that case,
+        use the more explicit get() method instead.
+
+        .. warning:: operation is O(n), not O(1).
+        """
+        return self._find_no_duplicates(name)
+
+    def __setitem__(self, name, value):
+        """Dict-like __setitem__ for compatibility with client code. Throws
+        exception if there is already a cookie of that name in the jar. In that
+        case, use the more explicit set() method instead.
+        """
+        self.set(name, value)
+
+    def __delitem__(self, name):
+        """Deletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
+        ``remove_cookie_by_name()``.
+        """
+        remove_cookie_by_name(self, name)
+
+    def set_cookie(self, cookie, *args, **kwargs):
+        if hasattr(cookie.value, 'startswith') and cookie.value.startswith('"') and cookie.value.endswith('"'):
+            cookie.value = cookie.value.replace('\\"', '')
+        return super(RequestsCookieJar, self).set_cookie(cookie, *args, **kwargs)
+
+    def update(self, other):
+        """Updates this jar with cookies from another CookieJar or dict-like"""
+        if isinstance(other, cookielib.CookieJar):
+            for cookie in other:
+                self.set_cookie(copy.copy(cookie))
+        else:
+            super(RequestsCookieJar, self).update(other)
+
+    def _find(self, name, domain=None, path=None):
+        """Requests uses this method internally to get cookie values.
+
+        If there are conflicting cookies, _find arbitrarily chooses one.
+        See _find_no_duplicates if you want an exception thrown if there are
+        conflicting cookies.
+
+        :param name: a string containing name of cookie
+        :param domain: (optional) string containing domain of cookie
+        :param path: (optional) string containing path of cookie
+        :return: cookie.value
+        """
+        for cookie in iter(self):
+            if cookie.name == name:
+                if domain is None or cookie.domain == domain:
+                    if path is None or cookie.path == path:
+                        return cookie.value
+
+        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+
+    def _find_no_duplicates(self, name, domain=None, path=None):
+        """Both ``__get_item__`` and ``get`` call this function: it's never
+        used elsewhere in Requests.
+
+        :param name: a string containing name of cookie
+        :param domain: (optional) string containing domain of cookie
+        :param path: (optional) string containing path of cookie
+        :raises KeyError: if cookie is not found
+        :raises CookieConflictError: if there are multiple cookies
+            that match name and optionally domain and path
+        :return: cookie.value
+        """
+        toReturn = None
+        for cookie in iter(self):
+            if cookie.name == name:
+                if domain is None or cookie.domain == domain:
+                    if path is None or cookie.path == path:
+                        if toReturn is not None:  # if there are multiple cookies that meet passed in criteria
+                            raise CookieConflictError('There are multiple cookies with name, %r' % (name))
+                        toReturn = cookie.value  # we will eventually return this as long as no cookie conflict
+
+        if toReturn:
+            return toReturn
+        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))
+
+    def __getstate__(self):
+        """Unlike a normal CookieJar, this class is pickleable."""
+        state = self.__dict__.copy()
+        # remove the unpickleable RLock object
+        state.pop('_cookies_lock')
+        return state
+
+    def __setstate__(self, state):
+        """Unlike a normal CookieJar, this class is pickleable."""
+        self.__dict__.update(state)
+        if '_cookies_lock' not in self.__dict__:
+            self._cookies_lock = threading.RLock()
+
+    def copy(self):
+        """Return a copy of this RequestsCookieJar."""
+        new_cj = RequestsCookieJar()
+        new_cj.set_policy(self.get_policy())
+        new_cj.update(self)
+        return new_cj
+
+    def get_policy(self):
+        """Return the CookiePolicy instance used."""
+        return self._policy
+
+
+def _copy_cookie_jar(jar):
+    if jar is None:
+        return None
+
+    if hasattr(jar, 'copy'):
+        # We're dealing with an instance of RequestsCookieJar
+        return jar.copy()
+    # We're dealing with a generic CookieJar instance
+    new_jar = copy.copy(jar)
+    new_jar.clear()
+    for cookie in jar:
+        new_jar.set_cookie(copy.copy(cookie))
+    return new_jar
+
+
+def create_cookie(name, value, **kwargs):
+    """Make a cookie from underspecified parameters.
+
+    By default, the pair of `name` and `value` will be set for the domain ''
+    and sent on every request (this is sometimes called a "supercookie").
+    """
+    result = {
+        'version': 0,
+        'name': name,
+        'value': value,
+        'port': None,
+        'domain': '',
+        'path': '/',
+        'secure': False,
+        'expires': None,
+        'discard': True,
+        'comment': None,
+        'comment_url': None,
+        'rest': {'HttpOnly': None},
+        'rfc2109': False,
+    }
+
+    badargs = set(kwargs) - set(result)
+    if badargs:
+        err = 'create_cookie() got unexpected keyword arguments: %s'
+        raise TypeError(err % list(badargs))
+
+    result.update(kwargs)
+    result['port_specified'] = bool(result['port'])
+    result['domain_specified'] = bool(result['domain'])
+    result['domain_initial_dot'] = result['domain'].startswith('.')
+    result['path_specified'] = bool(result['path'])
+
+    return cookielib.Cookie(**result)
+
+
+def morsel_to_cookie(morsel):
+    """Convert a Morsel object into a Cookie containing the one k/v pair."""
+
+    expires = None
+    if morsel['max-age']:
+        try:
+            expires = int(time.time() + int(morsel['max-age']))
+        except ValueError:
+            raise TypeError('max-age: %s must be integer' % morsel['max-age'])
+    elif morsel['expires']:
+        time_template = '%a, %d-%b-%Y %H:%M:%S GMT'
+        expires = calendar.timegm(
+            time.strptime(morsel['expires'], time_template)
+        )
+    return create_cookie(
+        comment=morsel['comment'],
+        comment_url=bool(morsel['comment']),
+        discard=False,
+        domain=morsel['domain'],
+        expires=expires,
+        name=morsel.key,
+        path=morsel['path'],
+        port=None,
+        rest={'HttpOnly': morsel['httponly']},
+        rfc2109=False,
+        secure=bool(morsel['secure']),
+        value=morsel.value,
+        version=morsel['version'] or 0,
+    )
+
+
+def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True):
+    """Returns a CookieJar from a key/value dictionary.
+
+    :param cookie_dict: Dict of key/values to insert into CookieJar.
+    :param cookiejar: (optional) A cookiejar to add the cookies to.
+    :param overwrite: (optional) If False, will not replace cookies
+        already in the jar with new ones.
+    :rtype: CookieJar
+    """
+    if cookiejar is None:
+        cookiejar = RequestsCookieJar()
+
+    if cookie_dict is not None:
+        names_from_jar = [cookie.name for cookie in cookiejar]
+        for name in cookie_dict:
+            if overwrite or (name not in names_from_jar):
+                cookiejar.set_cookie(create_cookie(name, cookie_dict[name]))
+
+    return cookiejar
+
+
+def merge_cookies(cookiejar, cookies):
+    """Add cookies to cookiejar and returns a merged CookieJar.
+
+    :param cookiejar: CookieJar object to add the cookies to.
+    :param cookies: Dictionary or CookieJar object to be added.
+    :rtype: CookieJar
+    """
+    if not isinstance(cookiejar, cookielib.CookieJar):
+        raise ValueError('You can only merge into CookieJar')
+
+    if isinstance(cookies, dict):
+        cookiejar = cookiejar_from_dict(
+            cookies, cookiejar=cookiejar, overwrite=False)
+    elif isinstance(cookies, cookielib.CookieJar):
+        try:
+            cookiejar.update(cookies)
+        except AttributeError:
+            for cookie_in_jar in cookies:
+                cookiejar.set_cookie(cookie_in_jar)
+
+    return cookiejar
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..a80cad80f14411ddf0ba86070d1a65c78dbf7878
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/exceptions.py
@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.exceptions
+~~~~~~~~~~~~~~~~~~~
+
+This module contains the set of Requests' exceptions.
+"""
+from urllib3.exceptions import HTTPError as BaseHTTPError
+
+
+class RequestException(IOError):
+    """There was an ambiguous exception that occurred while handling your
+    request.
+    """
+
+    def __init__(self, *args, **kwargs):
+        """Initialize RequestException with `request` and `response` objects."""
+        response = kwargs.pop('response', None)
+        self.response = response
+        self.request = kwargs.pop('request', None)
+        if (response is not None and not self.request and
+                hasattr(response, 'request')):
+            self.request = self.response.request
+        super(RequestException, self).__init__(*args, **kwargs)
+
+
+class HTTPError(RequestException):
+    """An HTTP error occurred."""
+
+
+class ConnectionError(RequestException):
+    """A Connection error occurred."""
+
+
+class ProxyError(ConnectionError):
+    """A proxy error occurred."""
+
+
+class SSLError(ConnectionError):
+    """An SSL error occurred."""
+
+
+class Timeout(RequestException):
+    """The request timed out.
+
+    Catching this error will catch both
+    :exc:`~requests.exceptions.ConnectTimeout` and
+    :exc:`~requests.exceptions.ReadTimeout` errors.
+    """
+
+
+class ConnectTimeout(ConnectionError, Timeout):
+    """The request timed out while trying to connect to the remote server.
+
+    Requests that produced this error are safe to retry.
+    """
+
+
+class ReadTimeout(Timeout):
+    """The server did not send any data in the allotted amount of time."""
+
+
+class URLRequired(RequestException):
+    """A valid URL is required to make a request."""
+
+
+class TooManyRedirects(RequestException):
+    """Too many redirects."""
+
+
+class MissingSchema(RequestException, ValueError):
+    """The URL schema (e.g. http or https) is missing."""
+
+
+class InvalidSchema(RequestException, ValueError):
+    """See defaults.py for valid schemas."""
+
+
+class InvalidURL(RequestException, ValueError):
+    """The URL provided was somehow invalid."""
+
+
+class InvalidHeader(RequestException, ValueError):
+    """The header value provided was somehow invalid."""
+
+
+class InvalidProxyURL(InvalidURL):
+    """The proxy URL provided is invalid."""
+
+
+class ChunkedEncodingError(RequestException):
+    """The server declared chunked encoding but sent an invalid chunk."""
+
+
+class ContentDecodingError(RequestException, BaseHTTPError):
+    """Failed to decode response content"""
+
+
+class StreamConsumedError(RequestException, TypeError):
+    """The content for this response was already consumed"""
+
+
+class RetryError(RequestException):
+    """Custom retries logic failed"""
+
+
+class UnrewindableBodyError(RequestException):
+    """Requests encountered an error when trying to rewind a body"""
+
+# Warnings
+
+
+class RequestsWarning(Warning):
+    """Base warning for Requests."""
+    pass
+
+
+class FileModeWarning(RequestsWarning, DeprecationWarning):
+    """A file was opened in text mode, but Requests determined its binary length."""
+    pass
+
+
+class RequestsDependencyWarning(RequestsWarning):
+    """An imported dependency doesn't match the expected version range."""
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/help.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/help.py
new file mode 100644
index 0000000000000000000000000000000000000000..e53d35ef6dec122aa4aba941b9c555997a35d143
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/help.py
@@ -0,0 +1,119 @@
+"""Module containing bug report helper(s)."""
+from __future__ import print_function
+
+import json
+import platform
+import sys
+import ssl
+
+import idna
+import urllib3
+import chardet
+
+from . import __version__ as requests_version
+
+try:
+    from urllib3.contrib import pyopenssl
+except ImportError:
+    pyopenssl = None
+    OpenSSL = None
+    cryptography = None
+else:
+    import OpenSSL
+    import cryptography
+
+
+def _implementation():
+    """Return a dict with the Python implementation and version.
+
+    Provide both the name and the version of the Python implementation
+    currently running. For example, on CPython 2.7.5 it will return
+    {'name': 'CPython', 'version': '2.7.5'}.
+
+    This function works best on CPython and PyPy: in particular, it probably
+    doesn't work for Jython or IronPython. Future investigation should be done
+    to work out the correct shape of the code for those platforms.
+    """
+    implementation = platform.python_implementation()
+
+    if implementation == 'CPython':
+        implementation_version = platform.python_version()
+    elif implementation == 'PyPy':
+        implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major,
+                                               sys.pypy_version_info.minor,
+                                               sys.pypy_version_info.micro)
+        if sys.pypy_version_info.releaselevel != 'final':
+            implementation_version = ''.join([
+                implementation_version, sys.pypy_version_info.releaselevel
+            ])
+    elif implementation == 'Jython':
+        implementation_version = platform.python_version()  # Complete Guess
+    elif implementation == 'IronPython':
+        implementation_version = platform.python_version()  # Complete Guess
+    else:
+        implementation_version = 'Unknown'
+
+    return {'name': implementation, 'version': implementation_version}
+
+
+def info():
+    """Generate information for a bug report."""
+    try:
+        platform_info = {
+            'system': platform.system(),
+            'release': platform.release(),
+        }
+    except IOError:
+        platform_info = {
+            'system': 'Unknown',
+            'release': 'Unknown',
+        }
+
+    implementation_info = _implementation()
+    urllib3_info = {'version': urllib3.__version__}
+    chardet_info = {'version': chardet.__version__}
+
+    pyopenssl_info = {
+        'version': None,
+        'openssl_version': '',
+    }
+    if OpenSSL:
+        pyopenssl_info = {
+            'version': OpenSSL.__version__,
+            'openssl_version': '%x' % OpenSSL.SSL.OPENSSL_VERSION_NUMBER,
+        }
+    cryptography_info = {
+        'version': getattr(cryptography, '__version__', ''),
+    }
+    idna_info = {
+        'version': getattr(idna, '__version__', ''),
+    }
+
+    system_ssl = ssl.OPENSSL_VERSION_NUMBER
+    system_ssl_info = {
+        'version': '%x' % system_ssl if system_ssl is not None else ''
+    }
+
+    return {
+        'platform': platform_info,
+        'implementation': implementation_info,
+        'system_ssl': system_ssl_info,
+        'using_pyopenssl': pyopenssl is not None,
+        'pyOpenSSL': pyopenssl_info,
+        'urllib3': urllib3_info,
+        'chardet': chardet_info,
+        'cryptography': cryptography_info,
+        'idna': idna_info,
+        'requests': {
+            'version': requests_version,
+        },
+    }
+
+
+def main():
+    """Pretty-print the bug information as JSON."""
+    print(json.dumps(info(), sort_keys=True, indent=2))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/hooks.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/hooks.py
new file mode 100644
index 0000000000000000000000000000000000000000..7a51f212c8a08fc6a04e509e89d8dcc85185df77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/hooks.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.hooks
+~~~~~~~~~~~~~~
+
+This module provides the capabilities for the Requests hooks system.
+
+Available hooks:
+
+``response``:
+    The response generated from a Request.
+"""
+HOOKS = ['response']
+
+
+def default_hooks():
+    return {event: [] for event in HOOKS}
+
+# TODO: response is the only one
+
+
+def dispatch_hook(key, hooks, hook_data, **kwargs):
+    """Dispatches a hook dictionary on a given piece of data."""
+    hooks = hooks or {}
+    hooks = hooks.get(key)
+    if hooks:
+        if hasattr(hooks, '__call__'):
+            hooks = [hooks]
+        for hook in hooks:
+            _hook_data = hook(hook_data, **kwargs)
+            if _hook_data is not None:
+                hook_data = _hook_data
+    return hook_data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/models.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/models.py
new file mode 100644
index 0000000000000000000000000000000000000000..62dcd0b7c8c64399ad0d317fcfa926e40388d968
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/models.py
@@ -0,0 +1,953 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.models
+~~~~~~~~~~~~~~~
+
+This module contains the primary objects that power Requests.
+"""
+
+import datetime
+import sys
+
+# Import encoding now, to avoid implicit import later.
+# Implicit import within threads may cause LookupError when standard library is in a ZIP,
+# such as in Embedded Python. See https://github.com/requests/requests/issues/3578.
+import encodings.idna
+
+from urllib3.fields import RequestField
+from urllib3.filepost import encode_multipart_formdata
+from urllib3.util import parse_url
+from urllib3.exceptions import (
+    DecodeError, ReadTimeoutError, ProtocolError, LocationParseError)
+
+from io import UnsupportedOperation
+from .hooks import default_hooks
+from .structures import CaseInsensitiveDict
+
+from .auth import HTTPBasicAuth
+from .cookies import cookiejar_from_dict, get_cookie_header, _copy_cookie_jar
+from .exceptions import (
+    HTTPError, MissingSchema, InvalidURL, ChunkedEncodingError,
+    ContentDecodingError, ConnectionError, StreamConsumedError)
+from ._internal_utils import to_native_string, unicode_is_ascii
+from .utils import (
+    guess_filename, get_auth_from_url, requote_uri,
+    stream_decode_response_unicode, to_key_val_list, parse_header_links,
+    iter_slices, guess_json_utf, super_len, check_header_validity)
+from .compat import (
+    Callable, Mapping,
+    cookielib, urlunparse, urlsplit, urlencode, str, bytes,
+    is_py2, chardet, builtin_str, basestring)
+from .compat import json as complexjson
+from .status_codes import codes
+
+#: The set of HTTP status codes that indicate an automatically
+#: processable redirect.
+REDIRECT_STATI = (
+    codes.moved,               # 301
+    codes.found,               # 302
+    codes.other,               # 303
+    codes.temporary_redirect,  # 307
+    codes.permanent_redirect,  # 308
+)
+
+DEFAULT_REDIRECT_LIMIT = 30
+CONTENT_CHUNK_SIZE = 10 * 1024
+ITER_CHUNK_SIZE = 512
+
+
+class RequestEncodingMixin(object):
+    @property
+    def path_url(self):
+        """Build the path URL to use."""
+
+        url = []
+
+        p = urlsplit(self.url)
+
+        path = p.path
+        if not path:
+            path = '/'
+
+        url.append(path)
+
+        query = p.query
+        if query:
+            url.append('?')
+            url.append(query)
+
+        return ''.join(url)
+
+    @staticmethod
+    def _encode_params(data):
+        """Encode parameters in a piece of data.
+
+        Will successfully encode parameters when passed as a dict or a list of
+        2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
+        if parameters are supplied as a dict.
+        """
+
+        if isinstance(data, (str, bytes)):
+            return data
+        elif hasattr(data, 'read'):
+            return data
+        elif hasattr(data, '__iter__'):
+            result = []
+            for k, vs in to_key_val_list(data):
+                if isinstance(vs, basestring) or not hasattr(vs, '__iter__'):
+                    vs = [vs]
+                for v in vs:
+                    if v is not None:
+                        result.append(
+                            (k.encode('utf-8') if isinstance(k, str) else k,
+                             v.encode('utf-8') if isinstance(v, str) else v))
+            return urlencode(result, doseq=True)
+        else:
+            return data
+
+    @staticmethod
+    def _encode_files(files, data):
+        """Build the body for a multipart/form-data request.
+
+        Will successfully encode files when passed as a dict or a list of
+        tuples. Order is retained if data is a list of tuples but arbitrary
+        if parameters are supplied as a dict.
+        The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
+        or 4-tuples (filename, fileobj, contentype, custom_headers).
+        """
+        if (not files):
+            raise ValueError("Files must be provided.")
+        elif isinstance(data, basestring):
+            raise ValueError("Data must not be a string.")
+
+        new_fields = []
+        fields = to_key_val_list(data or {})
+        files = to_key_val_list(files or {})
+
+        for field, val in fields:
+            if isinstance(val, basestring) or not hasattr(val, '__iter__'):
+                val = [val]
+            for v in val:
+                if v is not None:
+                    # Don't call str() on bytestrings: in Py3 it all goes wrong.
+                    if not isinstance(v, bytes):
+                        v = str(v)
+
+                    new_fields.append(
+                        (field.decode('utf-8') if isinstance(field, bytes) else field,
+                         v.encode('utf-8') if isinstance(v, str) else v))
+
+        for (k, v) in files:
+            # support for explicit filename
+            ft = None
+            fh = None
+            if isinstance(v, (tuple, list)):
+                if len(v) == 2:
+                    fn, fp = v
+                elif len(v) == 3:
+                    fn, fp, ft = v
+                else:
+                    fn, fp, ft, fh = v
+            else:
+                fn = guess_filename(v) or k
+                fp = v
+
+            if isinstance(fp, (str, bytes, bytearray)):
+                fdata = fp
+            elif hasattr(fp, 'read'):
+                fdata = fp.read()
+            elif fp is None:
+                continue
+            else:
+                fdata = fp
+
+            rf = RequestField(name=k, data=fdata, filename=fn, headers=fh)
+            rf.make_multipart(content_type=ft)
+            new_fields.append(rf)
+
+        body, content_type = encode_multipart_formdata(new_fields)
+
+        return body, content_type
+
+
+class RequestHooksMixin(object):
+    def register_hook(self, event, hook):
+        """Properly register a hook."""
+
+        if event not in self.hooks:
+            raise ValueError('Unsupported event specified, with event name "%s"' % (event))
+
+        if isinstance(hook, Callable):
+            self.hooks[event].append(hook)
+        elif hasattr(hook, '__iter__'):
+            self.hooks[event].extend(h for h in hook if isinstance(h, Callable))
+
+    def deregister_hook(self, event, hook):
+        """Deregister a previously registered hook.
+        Returns True if the hook existed, False if not.
+        """
+
+        try:
+            self.hooks[event].remove(hook)
+            return True
+        except ValueError:
+            return False
+
+
+class Request(RequestHooksMixin):
+    """A user-created :class:`Request <Request>` object.
+
+    Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server.
+
+    :param method: HTTP method to use.
+    :param url: URL to send.
+    :param headers: dictionary of headers to send.
+    :param files: dictionary of {filename: fileobject} files to multipart upload.
+    :param data: the body to attach to the request. If a dictionary or
+        list of tuples ``[(key, value)]`` is provided, form-encoding will
+        take place.
+    :param json: json for the body to attach to the request (if files or data is not specified).
+    :param params: URL parameters to append to the URL. If a dictionary or
+        list of tuples ``[(key, value)]`` is provided, form-encoding will
+        take place.
+    :param auth: Auth handler or (user, pass) tuple.
+    :param cookies: dictionary or CookieJar of cookies to attach to this request.
+    :param hooks: dictionary of callback hooks, for internal usage.
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.Request('GET', 'https://httpbin.org/get')
+      >>> req.prepare()
+      <PreparedRequest [GET]>
+    """
+
+    def __init__(self,
+            method=None, url=None, headers=None, files=None, data=None,
+            params=None, auth=None, cookies=None, hooks=None, json=None):
+
+        # Default empty dicts for dict params.
+        data = [] if data is None else data
+        files = [] if files is None else files
+        headers = {} if headers is None else headers
+        params = {} if params is None else params
+        hooks = {} if hooks is None else hooks
+
+        self.hooks = default_hooks()
+        for (k, v) in list(hooks.items()):
+            self.register_hook(event=k, hook=v)
+
+        self.method = method
+        self.url = url
+        self.headers = headers
+        self.files = files
+        self.data = data
+        self.json = json
+        self.params = params
+        self.auth = auth
+        self.cookies = cookies
+
+    def __repr__(self):
+        return '<Request [%s]>' % (self.method)
+
+    def prepare(self):
+        """Constructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it."""
+        p = PreparedRequest()
+        p.prepare(
+            method=self.method,
+            url=self.url,
+            headers=self.headers,
+            files=self.files,
+            data=self.data,
+            json=self.json,
+            params=self.params,
+            auth=self.auth,
+            cookies=self.cookies,
+            hooks=self.hooks,
+        )
+        return p
+
+
+class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
+    """The fully mutable :class:`PreparedRequest <PreparedRequest>` object,
+    containing the exact bytes that will be sent to the server.
+
+    Generated from either a :class:`Request <Request>` object or manually.
+
+    Usage::
+
+      >>> import requests
+      >>> req = requests.Request('GET', 'https://httpbin.org/get')
+      >>> r = req.prepare()
+      <PreparedRequest [GET]>
+
+      >>> s = requests.Session()
+      >>> s.send(r)
+      <Response [200]>
+    """
+
+    def __init__(self):
+        #: HTTP verb to send to the server.
+        self.method = None
+        #: HTTP URL to send the request to.
+        self.url = None
+        #: dictionary of HTTP headers.
+        self.headers = None
+        # The `CookieJar` used to create the Cookie header will be stored here
+        # after prepare_cookies is called
+        self._cookies = None
+        #: request body to send to the server.
+        self.body = None
+        #: dictionary of callback hooks, for internal usage.
+        self.hooks = default_hooks()
+        #: integer denoting starting position of a readable file-like body.
+        self._body_position = None
+
+    def prepare(self,
+            method=None, url=None, headers=None, files=None, data=None,
+            params=None, auth=None, cookies=None, hooks=None, json=None):
+        """Prepares the entire request with the given parameters."""
+
+        self.prepare_method(method)
+        self.prepare_url(url, params)
+        self.prepare_headers(headers)
+        self.prepare_cookies(cookies)
+        self.prepare_body(data, files, json)
+        self.prepare_auth(auth, url)
+
+        # Note that prepare_auth must be last to enable authentication schemes
+        # such as OAuth to work on a fully prepared request.
+
+        # This MUST go after prepare_auth. Authenticators could add a hook
+        self.prepare_hooks(hooks)
+
+    def __repr__(self):
+        return '<PreparedRequest [%s]>' % (self.method)
+
+    def copy(self):
+        p = PreparedRequest()
+        p.method = self.method
+        p.url = self.url
+        p.headers = self.headers.copy() if self.headers is not None else None
+        p._cookies = _copy_cookie_jar(self._cookies)
+        p.body = self.body
+        p.hooks = self.hooks
+        p._body_position = self._body_position
+        return p
+
+    def prepare_method(self, method):
+        """Prepares the given HTTP method."""
+        self.method = method
+        if self.method is not None:
+            self.method = to_native_string(self.method.upper())
+
+    @staticmethod
+    def _get_idna_encoded_host(host):
+        import idna
+
+        try:
+            host = idna.encode(host, uts46=True).decode('utf-8')
+        except idna.IDNAError:
+            raise UnicodeError
+        return host
+
+    def prepare_url(self, url, params):
+        """Prepares the given HTTP URL."""
+        #: Accept objects that have string representations.
+        #: We're unable to blindly call unicode/str functions
+        #: as this will include the bytestring indicator (b'')
+        #: on python 3.x.
+        #: https://github.com/requests/requests/pull/2238
+        if isinstance(url, bytes):
+            url = url.decode('utf8')
+        else:
+            url = unicode(url) if is_py2 else str(url)
+
+        # Remove leading whitespaces from url
+        url = url.lstrip()
+
+        # Don't do any URL preparation for non-HTTP schemes like `mailto`,
+        # `data` etc to work around exceptions from `url_parse`, which
+        # handles RFC 3986 only.
+        if ':' in url and not url.lower().startswith('http'):
+            self.url = url
+            return
+
+        # Support for unicode domain names and paths.
+        try:
+            scheme, auth, host, port, path, query, fragment = parse_url(url)
+        except LocationParseError as e:
+            raise InvalidURL(*e.args)
+
+        if not scheme:
+            error = ("Invalid URL {0!r}: No schema supplied. Perhaps you meant http://{0}?")
+            error = error.format(to_native_string(url, 'utf8'))
+
+            raise MissingSchema(error)
+
+        if not host:
+            raise InvalidURL("Invalid URL %r: No host supplied" % url)
+
+        # In general, we want to try IDNA encoding the hostname if the string contains
+        # non-ASCII characters. This allows users to automatically get the correct IDNA
+        # behaviour. For strings containing only ASCII characters, we need to also verify
+        # it doesn't start with a wildcard (*), before allowing the unencoded hostname.
+        if not unicode_is_ascii(host):
+            try:
+                host = self._get_idna_encoded_host(host)
+            except UnicodeError:
+                raise InvalidURL('URL has an invalid label.')
+        elif host.startswith(u'*'):
+            raise InvalidURL('URL has an invalid label.')
+
+        # Carefully reconstruct the network location
+        netloc = auth or ''
+        if netloc:
+            netloc += '@'
+        netloc += host
+        if port:
+            netloc += ':' + str(port)
+
+        # Bare domains aren't valid URLs.
+        if not path:
+            path = '/'
+
+        if is_py2:
+            if isinstance(scheme, str):
+                scheme = scheme.encode('utf-8')
+            if isinstance(netloc, str):
+                netloc = netloc.encode('utf-8')
+            if isinstance(path, str):
+                path = path.encode('utf-8')
+            if isinstance(query, str):
+                query = query.encode('utf-8')
+            if isinstance(fragment, str):
+                fragment = fragment.encode('utf-8')
+
+        if isinstance(params, (str, bytes)):
+            params = to_native_string(params)
+
+        enc_params = self._encode_params(params)
+        if enc_params:
+            if query:
+                query = '%s&%s' % (query, enc_params)
+            else:
+                query = enc_params
+
+        url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment]))
+        self.url = url
+
+    def prepare_headers(self, headers):
+        """Prepares the given HTTP headers."""
+
+        self.headers = CaseInsensitiveDict()
+        if headers:
+            for header in headers.items():
+                # Raise exception on invalid header value.
+                check_header_validity(header)
+                name, value = header
+                self.headers[to_native_string(name)] = value
+
+    def prepare_body(self, data, files, json=None):
+        """Prepares the given HTTP body data."""
+
+        # Check if file, fo, generator, iterator.
+        # If not, run through normal process.
+
+        # Nottin' on you.
+        body = None
+        content_type = None
+
+        if not data and json is not None:
+            # urllib3 requires a bytes-like body. Python 2's json.dumps
+            # provides this natively, but Python 3 gives a Unicode string.
+            content_type = 'application/json'
+            body = complexjson.dumps(json)
+            if not isinstance(body, bytes):
+                body = body.encode('utf-8')
+
+        is_stream = all([
+            hasattr(data, '__iter__'),
+            not isinstance(data, (basestring, list, tuple, Mapping))
+        ])
+
+        try:
+            length = super_len(data)
+        except (TypeError, AttributeError, UnsupportedOperation):
+            length = None
+
+        if is_stream:
+            body = data
+
+            if getattr(body, 'tell', None) is not None:
+                # Record the current file position before reading.
+                # This will allow us to rewind a file in the event
+                # of a redirect.
+                try:
+                    self._body_position = body.tell()
+                except (IOError, OSError):
+                    # This differentiates from None, allowing us to catch
+                    # a failed `tell()` later when trying to rewind the body
+                    self._body_position = object()
+
+            if files:
+                raise NotImplementedError('Streamed bodies and files are mutually exclusive.')
+
+            if length:
+                self.headers['Content-Length'] = builtin_str(length)
+            else:
+                self.headers['Transfer-Encoding'] = 'chunked'
+        else:
+            # Multi-part file uploads.
+            if files:
+                (body, content_type) = self._encode_files(files, data)
+            else:
+                if data:
+                    body = self._encode_params(data)
+                    if isinstance(data, basestring) or hasattr(data, 'read'):
+                        content_type = None
+                    else:
+                        content_type = 'application/x-www-form-urlencoded'
+
+            self.prepare_content_length(body)
+
+            # Add content-type if it wasn't explicitly provided.
+            if content_type and ('content-type' not in self.headers):
+                self.headers['Content-Type'] = content_type
+
+        self.body = body
+
+    def prepare_content_length(self, body):
+        """Prepare Content-Length header based on request method and body"""
+        if body is not None:
+            length = super_len(body)
+            if length:
+                # If length exists, set it. Otherwise, we fallback
+                # to Transfer-Encoding: chunked.
+                self.headers['Content-Length'] = builtin_str(length)
+        elif self.method not in ('GET', 'HEAD') and self.headers.get('Content-Length') is None:
+            # Set Content-Length to 0 for methods that can have a body
+            # but don't provide one. (i.e. not GET or HEAD)
+            self.headers['Content-Length'] = '0'
+
+    def prepare_auth(self, auth, url=''):
+        """Prepares the given HTTP auth data."""
+
+        # If no Auth is explicitly provided, extract it from the URL first.
+        if auth is None:
+            url_auth = get_auth_from_url(self.url)
+            auth = url_auth if any(url_auth) else None
+
+        if auth:
+            if isinstance(auth, tuple) and len(auth) == 2:
+                # special-case basic HTTP auth
+                auth = HTTPBasicAuth(*auth)
+
+            # Allow auth to make its changes.
+            r = auth(self)
+
+            # Update self to reflect the auth changes.
+            self.__dict__.update(r.__dict__)
+
+            # Recompute Content-Length
+            self.prepare_content_length(self.body)
+
+    def prepare_cookies(self, cookies):
+        """Prepares the given HTTP cookie data.
+
+        This function eventually generates a ``Cookie`` header from the
+        given cookies using cookielib. Due to cookielib's design, the header
+        will not be regenerated if it already exists, meaning this function
+        can only be called once for the life of the
+        :class:`PreparedRequest <PreparedRequest>` object. Any subsequent calls
+        to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
+        header is removed beforehand.
+        """
+        if isinstance(cookies, cookielib.CookieJar):
+            self._cookies = cookies
+        else:
+            self._cookies = cookiejar_from_dict(cookies)
+
+        cookie_header = get_cookie_header(self._cookies, self)
+        if cookie_header is not None:
+            self.headers['Cookie'] = cookie_header
+
+    def prepare_hooks(self, hooks):
+        """Prepares the given hooks."""
+        # hooks can be passed as None to the prepare method and to this
+        # method. To prevent iterating over None, simply use an empty list
+        # if hooks is False-y
+        hooks = hooks or []
+        for event in hooks:
+            self.register_hook(event, hooks[event])
+
+
+class Response(object):
+    """The :class:`Response <Response>` object, which contains a
+    server's response to an HTTP request.
+    """
+
+    __attrs__ = [
+        '_content', 'status_code', 'headers', 'url', 'history',
+        'encoding', 'reason', 'cookies', 'elapsed', 'request'
+    ]
+
+    def __init__(self):
+        self._content = False
+        self._content_consumed = False
+        self._next = None
+
+        #: Integer Code of responded HTTP Status, e.g. 404 or 200.
+        self.status_code = None
+
+        #: Case-insensitive Dictionary of Response Headers.
+        #: For example, ``headers['content-encoding']`` will return the
+        #: value of a ``'Content-Encoding'`` response header.
+        self.headers = CaseInsensitiveDict()
+
+        #: File-like object representation of response (for advanced usage).
+        #: Use of ``raw`` requires that ``stream=True`` be set on the request.
+        # This requirement does not apply for use internally to Requests.
+        self.raw = None
+
+        #: Final URL location of Response.
+        self.url = None
+
+        #: Encoding to decode with when accessing r.text.
+        self.encoding = None
+
+        #: A list of :class:`Response <Response>` objects from
+        #: the history of the Request. Any redirect responses will end
+        #: up here. The list is sorted from the oldest to the most recent request.
+        self.history = []
+
+        #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK".
+        self.reason = None
+
+        #: A CookieJar of Cookies the server sent back.
+        self.cookies = cookiejar_from_dict({})
+
+        #: The amount of time elapsed between sending the request
+        #: and the arrival of the response (as a timedelta).
+        #: This property specifically measures the time taken between sending
+        #: the first byte of the request and finishing parsing the headers. It
+        #: is therefore unaffected by consuming the response content or the
+        #: value of the ``stream`` keyword argument.
+        self.elapsed = datetime.timedelta(0)
+
+        #: The :class:`PreparedRequest <PreparedRequest>` object to which this
+        #: is a response.
+        self.request = None
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def __getstate__(self):
+        # Consume everything; accessing the content attribute makes
+        # sure the content has been fully read.
+        if not self._content_consumed:
+            self.content
+
+        return {attr: getattr(self, attr, None) for attr in self.__attrs__}
+
+    def __setstate__(self, state):
+        for name, value in state.items():
+            setattr(self, name, value)
+
+        # pickled objects do not have .raw
+        setattr(self, '_content_consumed', True)
+        setattr(self, 'raw', None)
+
+    def __repr__(self):
+        return '<Response [%s]>' % (self.status_code)
+
+    def __bool__(self):
+        """Returns True if :attr:`status_code` is less than 400.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code, is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        return self.ok
+
+    def __nonzero__(self):
+        """Returns True if :attr:`status_code` is less than 400.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code, is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        return self.ok
+
+    def __iter__(self):
+        """Allows you to use a response as an iterator."""
+        return self.iter_content(128)
+
+    @property
+    def ok(self):
+        """Returns True if :attr:`status_code` is less than 400, False if not.
+
+        This attribute checks if the status code of the response is between
+        400 and 600 to see if there was a client error or a server error. If
+        the status code is between 200 and 400, this will return True. This
+        is **not** a check to see if the response code is ``200 OK``.
+        """
+        try:
+            self.raise_for_status()
+        except HTTPError:
+            return False
+        return True
+
+    @property
+    def is_redirect(self):
+        """True if this Response is a well-formed HTTP redirect that could have
+        been processed automatically (by :meth:`Session.resolve_redirects`).
+        """
+        return ('location' in self.headers and self.status_code in REDIRECT_STATI)
+
+    @property
+    def is_permanent_redirect(self):
+        """True if this Response one of the permanent versions of redirect."""
+        return ('location' in self.headers and self.status_code in (codes.moved_permanently, codes.permanent_redirect))
+
+    @property
+    def next(self):
+        """Returns a PreparedRequest for the next request in a redirect chain, if there is one."""
+        return self._next
+
+    @property
+    def apparent_encoding(self):
+        """The apparent encoding, provided by the chardet library."""
+        return chardet.detect(self.content)['encoding']
+
+    def iter_content(self, chunk_size=1, decode_unicode=False):
+        """Iterates over the response data.  When stream=True is set on the
+        request, this avoids reading the content at once into memory for
+        large responses.  The chunk size is the number of bytes it should
+        read into memory.  This is not necessarily the length of each item
+        returned as decoding can take place.
+
+        chunk_size must be of type int or None. A value of None will
+        function differently depending on the value of `stream`.
+        stream=True will read data as it arrives in whatever size the
+        chunks are received. If stream=False, data is returned as
+        a single chunk.
+
+        If decode_unicode is True, content will be decoded using the best
+        available encoding based on the response.
+        """
+
+        def generate():
+            # Special case for urllib3.
+            if hasattr(self.raw, 'stream'):
+                try:
+                    for chunk in self.raw.stream(chunk_size, decode_content=True):
+                        yield chunk
+                except ProtocolError as e:
+                    raise ChunkedEncodingError(e)
+                except DecodeError as e:
+                    raise ContentDecodingError(e)
+                except ReadTimeoutError as e:
+                    raise ConnectionError(e)
+            else:
+                # Standard file-like object.
+                while True:
+                    chunk = self.raw.read(chunk_size)
+                    if not chunk:
+                        break
+                    yield chunk
+
+            self._content_consumed = True
+
+        if self._content_consumed and isinstance(self._content, bool):
+            raise StreamConsumedError()
+        elif chunk_size is not None and not isinstance(chunk_size, int):
+            raise TypeError("chunk_size must be an int, it is instead a %s." % type(chunk_size))
+        # simulate reading small chunks of the content
+        reused_chunks = iter_slices(self._content, chunk_size)
+
+        stream_chunks = generate()
+
+        chunks = reused_chunks if self._content_consumed else stream_chunks
+
+        if decode_unicode:
+            chunks = stream_decode_response_unicode(chunks, self)
+
+        return chunks
+
+    def iter_lines(self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None):
+        """Iterates over the response data, one line at a time.  When
+        stream=True is set on the request, this avoids reading the
+        content at once into memory for large responses.
+
+        .. note:: This method is not reentrant safe.
+        """
+
+        pending = None
+
+        for chunk in self.iter_content(chunk_size=chunk_size, decode_unicode=decode_unicode):
+
+            if pending is not None:
+                chunk = pending + chunk
+
+            if delimiter:
+                lines = chunk.split(delimiter)
+            else:
+                lines = chunk.splitlines()
+
+            if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]:
+                pending = lines.pop()
+            else:
+                pending = None
+
+            for line in lines:
+                yield line
+
+        if pending is not None:
+            yield pending
+
+    @property
+    def content(self):
+        """Content of the response, in bytes."""
+
+        if self._content is False:
+            # Read the contents.
+            if self._content_consumed:
+                raise RuntimeError(
+                    'The content for this response was already consumed')
+
+            if self.status_code == 0 or self.raw is None:
+                self._content = None
+            else:
+                self._content = b''.join(self.iter_content(CONTENT_CHUNK_SIZE)) or b''
+
+        self._content_consumed = True
+        # don't need to release the connection; that's been handled by urllib3
+        # since we exhausted the data.
+        return self._content
+
+    @property
+    def text(self):
+        """Content of the response, in unicode.
+
+        If Response.encoding is None, encoding will be guessed using
+        ``chardet``.
+
+        The encoding of the response content is determined based solely on HTTP
+        headers, following RFC 2616 to the letter. If you can take advantage of
+        non-HTTP knowledge to make a better guess at the encoding, you should
+        set ``r.encoding`` appropriately before accessing this property.
+        """
+
+        # Try charset from content-type
+        content = None
+        encoding = self.encoding
+
+        if not self.content:
+            return str('')
+
+        # Fallback to auto-detected encoding.
+        if self.encoding is None:
+            encoding = self.apparent_encoding
+
+        # Decode unicode from given encoding.
+        try:
+            content = str(self.content, encoding, errors='replace')
+        except (LookupError, TypeError):
+            # A LookupError is raised if the encoding was not found which could
+            # indicate a misspelling or similar mistake.
+            #
+            # A TypeError can be raised if encoding is None
+            #
+            # So we try blindly encoding.
+            content = str(self.content, errors='replace')
+
+        return content
+
+    def json(self, **kwargs):
+        r"""Returns the json-encoded content of a response, if any.
+
+        :param \*\*kwargs: Optional arguments that ``json.loads`` takes.
+        :raises ValueError: If the response body does not contain valid json.
+        """
+
+        if not self.encoding and self.content and len(self.content) > 3:
+            # No encoding set. JSON RFC 4627 section 3 states we should expect
+            # UTF-8, -16 or -32. Detect which one to use; If the detection or
+            # decoding fails, fall back to `self.text` (using chardet to make
+            # a best guess).
+            encoding = guess_json_utf(self.content)
+            if encoding is not None:
+                try:
+                    return complexjson.loads(
+                        self.content.decode(encoding), **kwargs
+                    )
+                except UnicodeDecodeError:
+                    # Wrong UTF codec detected; usually because it's not UTF-8
+                    # but some other 8-bit codec.  This is an RFC violation,
+                    # and the server didn't bother to tell us what codec *was*
+                    # used.
+                    pass
+        return complexjson.loads(self.text, **kwargs)
+
+    @property
+    def links(self):
+        """Returns the parsed header links of the response, if any."""
+
+        header = self.headers.get('link')
+
+        # l = MultiDict()
+        l = {}
+
+        if header:
+            links = parse_header_links(header)
+
+            for link in links:
+                key = link.get('rel') or link.get('url')
+                l[key] = link
+
+        return l
+
+    def raise_for_status(self):
+        """Raises stored :class:`HTTPError`, if one occurred."""
+
+        http_error_msg = ''
+        if isinstance(self.reason, bytes):
+            # We attempt to decode utf-8 first because some servers
+            # choose to localize their reason strings. If the string
+            # isn't utf-8, we fall back to iso-8859-1 for all other
+            # encodings. (See PR #3538)
+            try:
+                reason = self.reason.decode('utf-8')
+            except UnicodeDecodeError:
+                reason = self.reason.decode('iso-8859-1')
+        else:
+            reason = self.reason
+
+        if 400 <= self.status_code < 500:
+            http_error_msg = u'%s Client Error: %s for url: %s' % (self.status_code, reason, self.url)
+
+        elif 500 <= self.status_code < 600:
+            http_error_msg = u'%s Server Error: %s for url: %s' % (self.status_code, reason, self.url)
+
+        if http_error_msg:
+            raise HTTPError(http_error_msg, response=self)
+
+    def close(self):
+        """Releases the connection back to the pool. Once this method has been
+        called the underlying ``raw`` object must not be accessed again.
+
+        *Note: Should not normally need to be called explicitly.*
+        """
+        if not self._content_consumed:
+            self.raw.close()
+
+        release_conn = getattr(self.raw, 'release_conn', None)
+        if release_conn is not None:
+            release_conn()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/packages.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/packages.py
new file mode 100644
index 0000000000000000000000000000000000000000..7232fe0ff7e85083d47d624532f29badd7c854d0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/packages.py
@@ -0,0 +1,14 @@
+import sys
+
+# This code exists for backwards compatibility reasons.
+# I don't like it either. Just look the other way. :)
+
+for package in ('urllib3', 'idna', 'chardet'):
+    locals()[package] = __import__(package)
+    # This traversal is apparently necessary such that the identities are
+    # preserved (requests.packages.urllib3.* is urllib3.*)
+    for mod in list(sys.modules):
+        if mod == package or mod.startswith(package + '.'):
+            sys.modules['requests.packages.' + mod] = sys.modules[mod]
+
+# Kinda cool, though, right?
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/sessions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/sessions.py
new file mode 100644
index 0000000000000000000000000000000000000000..d73d700fa6baa975ab9b10fbdb186bccdb9d3610
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/sessions.py
@@ -0,0 +1,770 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.session
+~~~~~~~~~~~~~~~~
+
+This module provides a Session object to manage and persist settings across
+requests (cookies, auth, proxies).
+"""
+import os
+import sys
+import time
+from datetime import timedelta
+
+from .auth import _basic_auth_str
+from .compat import cookielib, is_py3, OrderedDict, urljoin, urlparse, Mapping
+from .cookies import (
+    cookiejar_from_dict, extract_cookies_to_jar, RequestsCookieJar, merge_cookies)
+from .models import Request, PreparedRequest, DEFAULT_REDIRECT_LIMIT
+from .hooks import default_hooks, dispatch_hook
+from ._internal_utils import to_native_string
+from .utils import to_key_val_list, default_headers, DEFAULT_PORTS
+from .exceptions import (
+    TooManyRedirects, InvalidSchema, ChunkedEncodingError, ContentDecodingError)
+
+from .structures import CaseInsensitiveDict
+from .adapters import HTTPAdapter
+
+from .utils import (
+    requote_uri, get_environ_proxies, get_netrc_auth, should_bypass_proxies,
+    get_auth_from_url, rewind_body
+)
+
+from .status_codes import codes
+
+# formerly defined here, reexposed here for backward compatibility
+from .models import REDIRECT_STATI
+
+# Preferred clock, based on which one is more accurate on a given system.
+if sys.platform == 'win32':
+    try:  # Python 3.4+
+        preferred_clock = time.perf_counter
+    except AttributeError:  # Earlier than Python 3.
+        preferred_clock = time.clock
+else:
+    preferred_clock = time.time
+
+
+def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
+    """Determines appropriate setting for a given request, taking into account
+    the explicit setting on that request, and the setting in the session. If a
+    setting is a dictionary, they will be merged together using `dict_class`
+    """
+
+    if session_setting is None:
+        return request_setting
+
+    if request_setting is None:
+        return session_setting
+
+    # Bypass if not a dictionary (e.g. verify)
+    if not (
+            isinstance(session_setting, Mapping) and
+            isinstance(request_setting, Mapping)
+    ):
+        return request_setting
+
+    merged_setting = dict_class(to_key_val_list(session_setting))
+    merged_setting.update(to_key_val_list(request_setting))
+
+    # Remove keys that are set to None. Extract keys first to avoid altering
+    # the dictionary during iteration.
+    none_keys = [k for (k, v) in merged_setting.items() if v is None]
+    for key in none_keys:
+        del merged_setting[key]
+
+    return merged_setting
+
+
+def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
+    """Properly merges both requests and session hooks.
+
+    This is necessary because when request_hooks == {'response': []}, the
+    merge breaks Session hooks entirely.
+    """
+    if session_hooks is None or session_hooks.get('response') == []:
+        return request_hooks
+
+    if request_hooks is None or request_hooks.get('response') == []:
+        return session_hooks
+
+    return merge_setting(request_hooks, session_hooks, dict_class)
+
+
+class SessionRedirectMixin(object):
+
+    def get_redirect_target(self, resp):
+        """Receives a Response. Returns a redirect URI or ``None``"""
+        # Due to the nature of how requests processes redirects this method will
+        # be called at least once upon the original response and at least twice
+        # on each subsequent redirect response (if any).
+        # If a custom mixin is used to handle this logic, it may be advantageous
+        # to cache the redirect location onto the response object as a private
+        # attribute.
+        if resp.is_redirect:
+            location = resp.headers['location']
+            # Currently the underlying http module on py3 decode headers
+            # in latin1, but empirical evidence suggests that latin1 is very
+            # rarely used with non-ASCII characters in HTTP headers.
+            # It is more likely to get UTF8 header rather than latin1.
+            # This causes incorrect handling of UTF8 encoded location headers.
+            # To solve this, we re-encode the location in latin1.
+            if is_py3:
+                location = location.encode('latin1')
+            return to_native_string(location, 'utf8')
+        return None
+
+    def should_strip_auth(self, old_url, new_url):
+        """Decide whether Authorization header should be removed when redirecting"""
+        old_parsed = urlparse(old_url)
+        new_parsed = urlparse(new_url)
+        if old_parsed.hostname != new_parsed.hostname:
+            return True
+        # Special case: allow http -> https redirect when using the standard
+        # ports. This isn't specified by RFC 7235, but is kept to avoid
+        # breaking backwards compatibility with older versions of requests
+        # that allowed any redirects on the same host.
+        if (old_parsed.scheme == 'http' and old_parsed.port in (80, None)
+                and new_parsed.scheme == 'https' and new_parsed.port in (443, None)):
+            return False
+
+        # Handle default port usage corresponding to scheme.
+        changed_port = old_parsed.port != new_parsed.port
+        changed_scheme = old_parsed.scheme != new_parsed.scheme
+        default_port = (DEFAULT_PORTS.get(old_parsed.scheme, None), None)
+        if (not changed_scheme and old_parsed.port in default_port
+                and new_parsed.port in default_port):
+            return False
+
+        # Standard case: root URI must match
+        return changed_port or changed_scheme
+
+    def resolve_redirects(self, resp, req, stream=False, timeout=None,
+                          verify=True, cert=None, proxies=None, yield_requests=False, **adapter_kwargs):
+        """Receives a Response. Returns a generator of Responses or Requests."""
+
+        hist = []  # keep track of history
+
+        url = self.get_redirect_target(resp)
+        previous_fragment = urlparse(req.url).fragment
+        while url:
+            prepared_request = req.copy()
+
+            # Update history and keep track of redirects.
+            # resp.history must ignore the original request in this loop
+            hist.append(resp)
+            resp.history = hist[1:]
+
+            try:
+                resp.content  # Consume socket so it can be released
+            except (ChunkedEncodingError, ContentDecodingError, RuntimeError):
+                resp.raw.read(decode_content=False)
+
+            if len(resp.history) >= self.max_redirects:
+                raise TooManyRedirects('Exceeded %s redirects.' % self.max_redirects, response=resp)
+
+            # Release the connection back into the pool.
+            resp.close()
+
+            # Handle redirection without scheme (see: RFC 1808 Section 4)
+            if url.startswith('//'):
+                parsed_rurl = urlparse(resp.url)
+                url = '%s:%s' % (to_native_string(parsed_rurl.scheme), url)
+
+            # Normalize url case and attach previous fragment if needed (RFC 7231 7.1.2)
+            parsed = urlparse(url)
+            if parsed.fragment == '' and previous_fragment:
+                parsed = parsed._replace(fragment=previous_fragment)
+            elif parsed.fragment:
+                previous_fragment = parsed.fragment
+            url = parsed.geturl()
+
+            # Facilitate relative 'location' headers, as allowed by RFC 7231.
+            # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource')
+            # Compliant with RFC3986, we percent encode the url.
+            if not parsed.netloc:
+                url = urljoin(resp.url, requote_uri(url))
+            else:
+                url = requote_uri(url)
+
+            prepared_request.url = to_native_string(url)
+
+            self.rebuild_method(prepared_request, resp)
+
+            # https://github.com/requests/requests/issues/1084
+            if resp.status_code not in (codes.temporary_redirect, codes.permanent_redirect):
+                # https://github.com/requests/requests/issues/3490
+                purged_headers = ('Content-Length', 'Content-Type', 'Transfer-Encoding')
+                for header in purged_headers:
+                    prepared_request.headers.pop(header, None)
+                prepared_request.body = None
+
+            headers = prepared_request.headers
+            try:
+                del headers['Cookie']
+            except KeyError:
+                pass
+
+            # Extract any cookies sent on the response to the cookiejar
+            # in the new request. Because we've mutated our copied prepared
+            # request, use the old one that we haven't yet touched.
+            extract_cookies_to_jar(prepared_request._cookies, req, resp.raw)
+            merge_cookies(prepared_request._cookies, self.cookies)
+            prepared_request.prepare_cookies(prepared_request._cookies)
+
+            # Rebuild auth and proxy information.
+            proxies = self.rebuild_proxies(prepared_request, proxies)
+            self.rebuild_auth(prepared_request, resp)
+
+            # A failed tell() sets `_body_position` to `object()`. This non-None
+            # value ensures `rewindable` will be True, allowing us to raise an
+            # UnrewindableBodyError, instead of hanging the connection.
+            rewindable = (
+                prepared_request._body_position is not None and
+                ('Content-Length' in headers or 'Transfer-Encoding' in headers)
+            )
+
+            # Attempt to rewind consumed file-like object.
+            if rewindable:
+                rewind_body(prepared_request)
+
+            # Override the original request.
+            req = prepared_request
+
+            if yield_requests:
+                yield req
+            else:
+
+                resp = self.send(
+                    req,
+                    stream=stream,
+                    timeout=timeout,
+                    verify=verify,
+                    cert=cert,
+                    proxies=proxies,
+                    allow_redirects=False,
+                    **adapter_kwargs
+                )
+
+                extract_cookies_to_jar(self.cookies, prepared_request, resp.raw)
+
+                # extract redirect url, if any, for the next loop
+                url = self.get_redirect_target(resp)
+                yield resp
+
+    def rebuild_auth(self, prepared_request, response):
+        """When being redirected we may want to strip authentication from the
+        request to avoid leaking credentials. This method intelligently removes
+        and reapplies authentication where possible to avoid credential loss.
+        """
+        headers = prepared_request.headers
+        url = prepared_request.url
+
+        if 'Authorization' in headers and self.should_strip_auth(response.request.url, url):
+            # If we get redirected to a new host, we should strip out any
+            # authentication headers.
+            del headers['Authorization']
+
+        # .netrc might have more auth for us on our new host.
+        new_auth = get_netrc_auth(url) if self.trust_env else None
+        if new_auth is not None:
+            prepared_request.prepare_auth(new_auth)
+
+        return
+
+    def rebuild_proxies(self, prepared_request, proxies):
+        """This method re-evaluates the proxy configuration by considering the
+        environment variables. If we are redirected to a URL covered by
+        NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
+        proxy keys for this URL (in case they were stripped by a previous
+        redirect).
+
+        This method also replaces the Proxy-Authorization header where
+        necessary.
+
+        :rtype: dict
+        """
+        proxies = proxies if proxies is not None else {}
+        headers = prepared_request.headers
+        url = prepared_request.url
+        scheme = urlparse(url).scheme
+        new_proxies = proxies.copy()
+        no_proxy = proxies.get('no_proxy')
+
+        bypass_proxy = should_bypass_proxies(url, no_proxy=no_proxy)
+        if self.trust_env and not bypass_proxy:
+            environ_proxies = get_environ_proxies(url, no_proxy=no_proxy)
+
+            proxy = environ_proxies.get(scheme, environ_proxies.get('all'))
+
+            if proxy:
+                new_proxies.setdefault(scheme, proxy)
+
+        if 'Proxy-Authorization' in headers:
+            del headers['Proxy-Authorization']
+
+        try:
+            username, password = get_auth_from_url(new_proxies[scheme])
+        except KeyError:
+            username, password = None, None
+
+        if username and password:
+            headers['Proxy-Authorization'] = _basic_auth_str(username, password)
+
+        return new_proxies
+
+    def rebuild_method(self, prepared_request, response):
+        """When being redirected we may want to change the method of the request
+        based on certain specs or browser behavior.
+        """
+        method = prepared_request.method
+
+        # https://tools.ietf.org/html/rfc7231#section-6.4.4
+        if response.status_code == codes.see_other and method != 'HEAD':
+            method = 'GET'
+
+        # Do what the browsers do, despite standards...
+        # First, turn 302s into GETs.
+        if response.status_code == codes.found and method != 'HEAD':
+            method = 'GET'
+
+        # Second, if a POST is responded to with a 301, turn it into a GET.
+        # This bizarre behaviour is explained in Issue 1704.
+        if response.status_code == codes.moved and method == 'POST':
+            method = 'GET'
+
+        prepared_request.method = method
+
+
+class Session(SessionRedirectMixin):
+    """A Requests session.
+
+    Provides cookie persistence, connection-pooling, and configuration.
+
+    Basic Usage::
+
+      >>> import requests
+      >>> s = requests.Session()
+      >>> s.get('https://httpbin.org/get')
+      <Response [200]>
+
+    Or as a context manager::
+
+      >>> with requests.Session() as s:
+      >>>     s.get('https://httpbin.org/get')
+      <Response [200]>
+    """
+
+    __attrs__ = [
+        'headers', 'cookies', 'auth', 'proxies', 'hooks', 'params', 'verify',
+        'cert', 'prefetch', 'adapters', 'stream', 'trust_env',
+        'max_redirects',
+    ]
+
+    def __init__(self):
+
+        #: A case-insensitive dictionary of headers to be sent on each
+        #: :class:`Request <Request>` sent from this
+        #: :class:`Session <Session>`.
+        self.headers = default_headers()
+
+        #: Default Authentication tuple or object to attach to
+        #: :class:`Request <Request>`.
+        self.auth = None
+
+        #: Dictionary mapping protocol or protocol and host to the URL of the proxy
+        #: (e.g. {'http': 'foo.bar:3128', 'http://host.name': 'foo.bar:4012'}) to
+        #: be used on each :class:`Request <Request>`.
+        self.proxies = {}
+
+        #: Event-handling hooks.
+        self.hooks = default_hooks()
+
+        #: Dictionary of querystring data to attach to each
+        #: :class:`Request <Request>`. The dictionary values may be lists for
+        #: representing multivalued query parameters.
+        self.params = {}
+
+        #: Stream response content default.
+        self.stream = False
+
+        #: SSL Verification default.
+        self.verify = True
+
+        #: SSL client certificate default, if String, path to ssl client
+        #: cert file (.pem). If Tuple, ('cert', 'key') pair.
+        self.cert = None
+
+        #: Maximum number of redirects allowed. If the request exceeds this
+        #: limit, a :class:`TooManyRedirects` exception is raised.
+        #: This defaults to requests.models.DEFAULT_REDIRECT_LIMIT, which is
+        #: 30.
+        self.max_redirects = DEFAULT_REDIRECT_LIMIT
+
+        #: Trust environment settings for proxy configuration, default
+        #: authentication and similar.
+        self.trust_env = True
+
+        #: A CookieJar containing all currently outstanding cookies set on this
+        #: session. By default it is a
+        #: :class:`RequestsCookieJar <requests.cookies.RequestsCookieJar>`, but
+        #: may be any other ``cookielib.CookieJar`` compatible object.
+        self.cookies = cookiejar_from_dict({})
+
+        # Default connection adapters.
+        self.adapters = OrderedDict()
+        self.mount('https://', HTTPAdapter())
+        self.mount('http://', HTTPAdapter())
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()
+
+    def prepare_request(self, request):
+        """Constructs a :class:`PreparedRequest <PreparedRequest>` for
+        transmission and returns it. The :class:`PreparedRequest` has settings
+        merged from the :class:`Request <Request>` instance and those of the
+        :class:`Session`.
+
+        :param request: :class:`Request` instance to prepare with this
+            session's settings.
+        :rtype: requests.PreparedRequest
+        """
+        cookies = request.cookies or {}
+
+        # Bootstrap CookieJar.
+        if not isinstance(cookies, cookielib.CookieJar):
+            cookies = cookiejar_from_dict(cookies)
+
+        # Merge with session cookies
+        merged_cookies = merge_cookies(
+            merge_cookies(RequestsCookieJar(), self.cookies), cookies)
+
+        # Set environment's basic authentication if not explicitly set.
+        auth = request.auth
+        if self.trust_env and not auth and not self.auth:
+            auth = get_netrc_auth(request.url)
+
+        p = PreparedRequest()
+        p.prepare(
+            method=request.method.upper(),
+            url=request.url,
+            files=request.files,
+            data=request.data,
+            json=request.json,
+            headers=merge_setting(request.headers, self.headers, dict_class=CaseInsensitiveDict),
+            params=merge_setting(request.params, self.params),
+            auth=merge_setting(auth, self.auth),
+            cookies=merged_cookies,
+            hooks=merge_hooks(request.hooks, self.hooks),
+        )
+        return p
+
+    def request(self, method, url,
+            params=None, data=None, headers=None, cookies=None, files=None,
+            auth=None, timeout=None, allow_redirects=True, proxies=None,
+            hooks=None, stream=None, verify=None, cert=None, json=None):
+        """Constructs a :class:`Request <Request>`, prepares it and sends it.
+        Returns :class:`Response <Response>` object.
+
+        :param method: method for the new :class:`Request` object.
+        :param url: URL for the new :class:`Request` object.
+        :param params: (optional) Dictionary or bytes to be sent in the query
+            string for the :class:`Request`.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param json: (optional) json to send in the body of the
+            :class:`Request`.
+        :param headers: (optional) Dictionary of HTTP Headers to send with the
+            :class:`Request`.
+        :param cookies: (optional) Dict or CookieJar object to send with the
+            :class:`Request`.
+        :param files: (optional) Dictionary of ``'filename': file-like-objects``
+            for multipart encoding upload.
+        :param auth: (optional) Auth tuple or callable to enable
+            Basic/Digest/Custom HTTP Auth.
+        :param timeout: (optional) How long to wait for the server to send
+            data before giving up, as a float, or a :ref:`(connect timeout,
+            read timeout) <timeouts>` tuple.
+        :type timeout: float or tuple
+        :param allow_redirects: (optional) Set to True by default.
+        :type allow_redirects: bool
+        :param proxies: (optional) Dictionary mapping protocol or protocol and
+            hostname to the URL of the proxy.
+        :param stream: (optional) whether to immediately download the response
+            content. Defaults to ``False``.
+        :param verify: (optional) Either a boolean, in which case it controls whether we verify
+            the server's TLS certificate, or a string, in which case it must be a path
+            to a CA bundle to use. Defaults to ``True``.
+        :param cert: (optional) if String, path to ssl client cert file (.pem).
+            If Tuple, ('cert', 'key') pair.
+        :rtype: requests.Response
+        """
+        # Create the Request.
+        req = Request(
+            method=method.upper(),
+            url=url,
+            headers=headers,
+            files=files,
+            data=data or {},
+            json=json,
+            params=params or {},
+            auth=auth,
+            cookies=cookies,
+            hooks=hooks,
+        )
+        prep = self.prepare_request(req)
+
+        proxies = proxies or {}
+
+        settings = self.merge_environment_settings(
+            prep.url, proxies, stream, verify, cert
+        )
+
+        # Send the request.
+        send_kwargs = {
+            'timeout': timeout,
+            'allow_redirects': allow_redirects,
+        }
+        send_kwargs.update(settings)
+        resp = self.send(prep, **send_kwargs)
+
+        return resp
+
+    def get(self, url, **kwargs):
+        r"""Sends a GET request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', True)
+        return self.request('GET', url, **kwargs)
+
+    def options(self, url, **kwargs):
+        r"""Sends a OPTIONS request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', True)
+        return self.request('OPTIONS', url, **kwargs)
+
+    def head(self, url, **kwargs):
+        r"""Sends a HEAD request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        kwargs.setdefault('allow_redirects', False)
+        return self.request('HEAD', url, **kwargs)
+
+    def post(self, url, data=None, json=None, **kwargs):
+        r"""Sends a POST request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param json: (optional) json to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('POST', url, data=data, json=json, **kwargs)
+
+    def put(self, url, data=None, **kwargs):
+        r"""Sends a PUT request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('PUT', url, data=data, **kwargs)
+
+    def patch(self, url, data=None, **kwargs):
+        r"""Sends a PATCH request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
+            object to send in the body of the :class:`Request`.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('PATCH', url, data=data, **kwargs)
+
+    def delete(self, url, **kwargs):
+        r"""Sends a DELETE request. Returns :class:`Response` object.
+
+        :param url: URL for the new :class:`Request` object.
+        :param \*\*kwargs: Optional arguments that ``request`` takes.
+        :rtype: requests.Response
+        """
+
+        return self.request('DELETE', url, **kwargs)
+
+    def send(self, request, **kwargs):
+        """Send a given PreparedRequest.
+
+        :rtype: requests.Response
+        """
+        # Set defaults that the hooks can utilize to ensure they always have
+        # the correct parameters to reproduce the previous request.
+        kwargs.setdefault('stream', self.stream)
+        kwargs.setdefault('verify', self.verify)
+        kwargs.setdefault('cert', self.cert)
+        kwargs.setdefault('proxies', self.proxies)
+
+        # It's possible that users might accidentally send a Request object.
+        # Guard against that specific failure case.
+        if isinstance(request, Request):
+            raise ValueError('You can only send PreparedRequests.')
+
+        # Set up variables needed for resolve_redirects and dispatching of hooks
+        allow_redirects = kwargs.pop('allow_redirects', True)
+        stream = kwargs.get('stream')
+        hooks = request.hooks
+
+        # Get the appropriate adapter to use
+        adapter = self.get_adapter(url=request.url)
+
+        # Start time (approximately) of the request
+        start = preferred_clock()
+
+        # Send the request
+        r = adapter.send(request, **kwargs)
+
+        # Total elapsed time of the request (approximately)
+        elapsed = preferred_clock() - start
+        r.elapsed = timedelta(seconds=elapsed)
+
+        # Response manipulation hooks
+        r = dispatch_hook('response', hooks, r, **kwargs)
+
+        # Persist cookies
+        if r.history:
+
+            # If the hooks create history then we want those cookies too
+            for resp in r.history:
+                extract_cookies_to_jar(self.cookies, resp.request, resp.raw)
+
+        extract_cookies_to_jar(self.cookies, request, r.raw)
+
+        # Redirect resolving generator.
+        gen = self.resolve_redirects(r, request, **kwargs)
+
+        # Resolve redirects if allowed.
+        history = [resp for resp in gen] if allow_redirects else []
+
+        # Shuffle things around if there's history.
+        if history:
+            # Insert the first (original) request at the start
+            history.insert(0, r)
+            # Get the last request made
+            r = history.pop()
+            r.history = history
+
+        # If redirects aren't being followed, store the response on the Request for Response.next().
+        if not allow_redirects:
+            try:
+                r._next = next(self.resolve_redirects(r, request, yield_requests=True, **kwargs))
+            except StopIteration:
+                pass
+
+        if not stream:
+            r.content
+
+        return r
+
+    def merge_environment_settings(self, url, proxies, stream, verify, cert):
+        """
+        Check the environment and merge it with some settings.
+
+        :rtype: dict
+        """
+        # Gather clues from the surrounding environment.
+        if self.trust_env:
+            # Set environment's proxies.
+            no_proxy = proxies.get('no_proxy') if proxies is not None else None
+            env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
+            for (k, v) in env_proxies.items():
+                proxies.setdefault(k, v)
+
+            # Look for requests environment configuration and be compatible
+            # with cURL.
+            if verify is True or verify is None:
+                verify = (os.environ.get('REQUESTS_CA_BUNDLE') or
+                          os.environ.get('CURL_CA_BUNDLE'))
+
+        # Merge all the kwargs.
+        proxies = merge_setting(proxies, self.proxies)
+        stream = merge_setting(stream, self.stream)
+        verify = merge_setting(verify, self.verify)
+        cert = merge_setting(cert, self.cert)
+
+        return {'verify': verify, 'proxies': proxies, 'stream': stream,
+                'cert': cert}
+
+    def get_adapter(self, url):
+        """
+        Returns the appropriate connection adapter for the given URL.
+
+        :rtype: requests.adapters.BaseAdapter
+        """
+        for (prefix, adapter) in self.adapters.items():
+
+            if url.lower().startswith(prefix.lower()):
+                return adapter
+
+        # Nothing matches :-/
+        raise InvalidSchema("No connection adapters were found for '%s'" % url)
+
+    def close(self):
+        """Closes all adapters and as such the session"""
+        for v in self.adapters.values():
+            v.close()
+
+    def mount(self, prefix, adapter):
+        """Registers a connection adapter to a prefix.
+
+        Adapters are sorted in descending order by prefix length.
+        """
+        self.adapters[prefix] = adapter
+        keys_to_move = [k for k in self.adapters if len(k) < len(prefix)]
+
+        for key in keys_to_move:
+            self.adapters[key] = self.adapters.pop(key)
+
+    def __getstate__(self):
+        state = {attr: getattr(self, attr, None) for attr in self.__attrs__}
+        return state
+
+    def __setstate__(self, state):
+        for attr, value in state.items():
+            setattr(self, attr, value)
+
+
+def session():
+    """
+    Returns a :class:`Session` for context-management.
+
+    .. deprecated:: 1.0.0
+
+        This method has been deprecated since version 1.0.0 and is only kept for
+        backwards compatibility. New code should use :class:`~requests.sessions.Session`
+        to create a session. This may be removed at a future date.
+
+    :rtype: Session
+    """
+    return Session()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/status_codes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/status_codes.py
new file mode 100644
index 0000000000000000000000000000000000000000..813e8c4e62fdcbbfcb73e2f52e187e0c3c5b84d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/status_codes.py
@@ -0,0 +1,120 @@
+# -*- coding: utf-8 -*-
+
+r"""
+The ``codes`` object defines a mapping from common names for HTTP statuses
+to their numerical codes, accessible either as attributes or as dictionary
+items.
+
+>>> requests.codes['temporary_redirect']
+307
+>>> requests.codes.teapot
+418
+>>> requests.codes['\o/']
+200
+
+Some codes have multiple names, and both upper- and lower-case versions of
+the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
+``codes.okay`` all correspond to the HTTP status code 200.
+"""
+
+from .structures import LookupDict
+
+_codes = {
+
+    # Informational.
+    100: ('continue',),
+    101: ('switching_protocols',),
+    102: ('processing',),
+    103: ('checkpoint',),
+    122: ('uri_too_long', 'request_uri_too_long'),
+    200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'),
+    201: ('created',),
+    202: ('accepted',),
+    203: ('non_authoritative_info', 'non_authoritative_information'),
+    204: ('no_content',),
+    205: ('reset_content', 'reset'),
+    206: ('partial_content', 'partial'),
+    207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'),
+    208: ('already_reported',),
+    226: ('im_used',),
+
+    # Redirection.
+    300: ('multiple_choices',),
+    301: ('moved_permanently', 'moved', '\\o-'),
+    302: ('found',),
+    303: ('see_other', 'other'),
+    304: ('not_modified',),
+    305: ('use_proxy',),
+    306: ('switch_proxy',),
+    307: ('temporary_redirect', 'temporary_moved', 'temporary'),
+    308: ('permanent_redirect',
+          'resume_incomplete', 'resume',),  # These 2 to be removed in 3.0
+
+    # Client Error.
+    400: ('bad_request', 'bad'),
+    401: ('unauthorized',),
+    402: ('payment_required', 'payment'),
+    403: ('forbidden',),
+    404: ('not_found', '-o-'),
+    405: ('method_not_allowed', 'not_allowed'),
+    406: ('not_acceptable',),
+    407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'),
+    408: ('request_timeout', 'timeout'),
+    409: ('conflict',),
+    410: ('gone',),
+    411: ('length_required',),
+    412: ('precondition_failed', 'precondition'),
+    413: ('request_entity_too_large',),
+    414: ('request_uri_too_large',),
+    415: ('unsupported_media_type', 'unsupported_media', 'media_type'),
+    416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'),
+    417: ('expectation_failed',),
+    418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'),
+    421: ('misdirected_request',),
+    422: ('unprocessable_entity', 'unprocessable'),
+    423: ('locked',),
+    424: ('failed_dependency', 'dependency'),
+    425: ('unordered_collection', 'unordered'),
+    426: ('upgrade_required', 'upgrade'),
+    428: ('precondition_required', 'precondition'),
+    429: ('too_many_requests', 'too_many'),
+    431: ('header_fields_too_large', 'fields_too_large'),
+    444: ('no_response', 'none'),
+    449: ('retry_with', 'retry'),
+    450: ('blocked_by_windows_parental_controls', 'parental_controls'),
+    451: ('unavailable_for_legal_reasons', 'legal_reasons'),
+    499: ('client_closed_request',),
+
+    # Server Error.
+    500: ('internal_server_error', 'server_error', '/o\\', '✗'),
+    501: ('not_implemented',),
+    502: ('bad_gateway',),
+    503: ('service_unavailable', 'unavailable'),
+    504: ('gateway_timeout',),
+    505: ('http_version_not_supported', 'http_version'),
+    506: ('variant_also_negotiates',),
+    507: ('insufficient_storage',),
+    509: ('bandwidth_limit_exceeded', 'bandwidth'),
+    510: ('not_extended',),
+    511: ('network_authentication_required', 'network_auth', 'network_authentication'),
+}
+
+codes = LookupDict(name='status_codes')
+
+def _init():
+    for code, titles in _codes.items():
+        for title in titles:
+            setattr(codes, title, code)
+            if not title.startswith(('\\', '/')):
+                setattr(codes, title.upper(), code)
+
+    def doc(code):
+        names = ', '.join('``%s``' % n for n in _codes[code])
+        return '* %d: %s' % (code, names)
+
+    global __doc__
+    __doc__ = (__doc__ + '\n' +
+               '\n'.join(doc(code) for code in sorted(_codes))
+               if __doc__ is not None else None)
+
+_init()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/structures.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/structures.py
new file mode 100644
index 0000000000000000000000000000000000000000..da930e2852049feb2b6e262d442b9cc25ecb2d94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/structures.py
@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.structures
+~~~~~~~~~~~~~~~~~~~
+
+Data structures that power Requests.
+"""
+
+from .compat import OrderedDict, Mapping, MutableMapping
+
+
+class CaseInsensitiveDict(MutableMapping):
+    """A case-insensitive ``dict``-like object.
+
+    Implements all methods and operations of
+    ``MutableMapping`` as well as dict's ``copy``. Also
+    provides ``lower_items``.
+
+    All keys are expected to be strings. The structure remembers the
+    case of the last key to be set, and ``iter(instance)``,
+    ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()``
+    will contain case-sensitive keys. However, querying and contains
+    testing is case insensitive::
+
+        cid = CaseInsensitiveDict()
+        cid['Accept'] = 'application/json'
+        cid['aCCEPT'] == 'application/json'  # True
+        list(cid) == ['Accept']  # True
+
+    For example, ``headers['content-encoding']`` will return the
+    value of a ``'Content-Encoding'`` response header, regardless
+    of how the header name was originally stored.
+
+    If the constructor, ``.update``, or equality comparison
+    operations are given keys that have equal ``.lower()``s, the
+    behavior is undefined.
+    """
+
+    def __init__(self, data=None, **kwargs):
+        self._store = OrderedDict()
+        if data is None:
+            data = {}
+        self.update(data, **kwargs)
+
+    def __setitem__(self, key, value):
+        # Use the lowercased key for lookups, but store the actual
+        # key alongside the value.
+        self._store[key.lower()] = (key, value)
+
+    def __getitem__(self, key):
+        return self._store[key.lower()][1]
+
+    def __delitem__(self, key):
+        del self._store[key.lower()]
+
+    def __iter__(self):
+        return (casedkey for casedkey, mappedvalue in self._store.values())
+
+    def __len__(self):
+        return len(self._store)
+
+    def lower_items(self):
+        """Like iteritems(), but with all lowercase keys."""
+        return (
+            (lowerkey, keyval[1])
+            for (lowerkey, keyval)
+            in self._store.items()
+        )
+
+    def __eq__(self, other):
+        if isinstance(other, Mapping):
+            other = CaseInsensitiveDict(other)
+        else:
+            return NotImplemented
+        # Compare insensitively
+        return dict(self.lower_items()) == dict(other.lower_items())
+
+    # Copy is required
+    def copy(self):
+        return CaseInsensitiveDict(self._store.values())
+
+    def __repr__(self):
+        return str(dict(self.items()))
+
+
+class LookupDict(dict):
+    """Dictionary lookup object."""
+
+    def __init__(self, name=None):
+        self.name = name
+        super(LookupDict, self).__init__()
+
+    def __repr__(self):
+        return '<lookup \'%s\'>' % (self.name)
+
+    def __getitem__(self, key):
+        # We allow fall-through here, so values default to None
+
+        return self.__dict__.get(key, None)
+
+    def get(self, key, default=None):
+        return self.__dict__.get(key, default)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..8170a8d2c45dc6d9dbb44abc4d5ce4d7c548463d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests/utils.py
@@ -0,0 +1,977 @@
+# -*- coding: utf-8 -*-
+
+"""
+requests.utils
+~~~~~~~~~~~~~~
+
+This module provides utility functions that are used within Requests
+that are also useful for external consumption.
+"""
+
+import codecs
+import contextlib
+import io
+import os
+import re
+import socket
+import struct
+import sys
+import tempfile
+import warnings
+import zipfile
+
+from .__version__ import __version__
+from . import certs
+# to_native_string is unused here, but imported here for backwards compatibility
+from ._internal_utils import to_native_string
+from .compat import parse_http_list as _parse_list_header
+from .compat import (
+    quote, urlparse, bytes, str, OrderedDict, unquote, getproxies,
+    proxy_bypass, urlunparse, basestring, integer_types, is_py3,
+    proxy_bypass_environment, getproxies_environment, Mapping)
+from .cookies import cookiejar_from_dict
+from .structures import CaseInsensitiveDict
+from .exceptions import (
+    InvalidURL, InvalidHeader, FileModeWarning, UnrewindableBodyError)
+
+NETRC_FILES = ('.netrc', '_netrc')
+
+DEFAULT_CA_BUNDLE_PATH = certs.where()
+
+DEFAULT_PORTS = {'http': 80, 'https': 443}
+
+
+if sys.platform == 'win32':
+    # provide a proxy_bypass version on Windows without DNS lookups
+
+    def proxy_bypass_registry(host):
+        try:
+            if is_py3:
+                import winreg
+            else:
+                import _winreg as winreg
+        except ImportError:
+            return False
+
+        try:
+            internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
+                r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
+            # ProxyEnable could be REG_SZ or REG_DWORD, normalizing it
+            proxyEnable = int(winreg.QueryValueEx(internetSettings,
+                                              'ProxyEnable')[0])
+            # ProxyOverride is almost always a string
+            proxyOverride = winreg.QueryValueEx(internetSettings,
+                                                'ProxyOverride')[0]
+        except OSError:
+            return False
+        if not proxyEnable or not proxyOverride:
+            return False
+
+        # make a check value list from the registry entry: replace the
+        # '<local>' string by the localhost entry and the corresponding
+        # canonical entry.
+        proxyOverride = proxyOverride.split(';')
+        # now check if we match one of the registry values.
+        for test in proxyOverride:
+            if test == '<local>':
+                if '.' not in host:
+                    return True
+            test = test.replace(".", r"\.")     # mask dots
+            test = test.replace("*", r".*")     # change glob sequence
+            test = test.replace("?", r".")      # change glob char
+            if re.match(test, host, re.I):
+                return True
+        return False
+
+    def proxy_bypass(host):  # noqa
+        """Return True, if the host should be bypassed.
+
+        Checks proxy settings gathered from the environment, if specified,
+        or the registry.
+        """
+        if getproxies_environment():
+            return proxy_bypass_environment(host)
+        else:
+            return proxy_bypass_registry(host)
+
+
+def dict_to_sequence(d):
+    """Returns an internal sequence dictionary update."""
+
+    if hasattr(d, 'items'):
+        d = d.items()
+
+    return d
+
+
+def super_len(o):
+    total_length = None
+    current_position = 0
+
+    if hasattr(o, '__len__'):
+        total_length = len(o)
+
+    elif hasattr(o, 'len'):
+        total_length = o.len
+
+    elif hasattr(o, 'fileno'):
+        try:
+            fileno = o.fileno()
+        except io.UnsupportedOperation:
+            pass
+        else:
+            total_length = os.fstat(fileno).st_size
+
+            # Having used fstat to determine the file length, we need to
+            # confirm that this file was opened up in binary mode.
+            if 'b' not in o.mode:
+                warnings.warn((
+                    "Requests has determined the content-length for this "
+                    "request using the binary size of the file: however, the "
+                    "file has been opened in text mode (i.e. without the 'b' "
+                    "flag in the mode). This may lead to an incorrect "
+                    "content-length. In Requests 3.0, support will be removed "
+                    "for files in text mode."),
+                    FileModeWarning
+                )
+
+    if hasattr(o, 'tell'):
+        try:
+            current_position = o.tell()
+        except (OSError, IOError):
+            # This can happen in some weird situations, such as when the file
+            # is actually a special file descriptor like stdin. In this
+            # instance, we don't know what the length is, so set it to zero and
+            # let requests chunk it instead.
+            if total_length is not None:
+                current_position = total_length
+        else:
+            if hasattr(o, 'seek') and total_length is None:
+                # StringIO and BytesIO have seek but no useable fileno
+                try:
+                    # seek to end of file
+                    o.seek(0, 2)
+                    total_length = o.tell()
+
+                    # seek back to current position to support
+                    # partially read file-like objects
+                    o.seek(current_position or 0)
+                except (OSError, IOError):
+                    total_length = 0
+
+    if total_length is None:
+        total_length = 0
+
+    return max(0, total_length - current_position)
+
+
+def get_netrc_auth(url, raise_errors=False):
+    """Returns the Requests tuple auth for a given url from netrc."""
+
+    try:
+        from netrc import netrc, NetrcParseError
+
+        netrc_path = None
+
+        for f in NETRC_FILES:
+            try:
+                loc = os.path.expanduser('~/{}'.format(f))
+            except KeyError:
+                # os.path.expanduser can fail when $HOME is undefined and
+                # getpwuid fails. See https://bugs.python.org/issue20164 &
+                # https://github.com/requests/requests/issues/1846
+                return
+
+            if os.path.exists(loc):
+                netrc_path = loc
+                break
+
+        # Abort early if there isn't one.
+        if netrc_path is None:
+            return
+
+        ri = urlparse(url)
+
+        # Strip port numbers from netloc. This weird `if...encode`` dance is
+        # used for Python 3.2, which doesn't support unicode literals.
+        splitstr = b':'
+        if isinstance(url, str):
+            splitstr = splitstr.decode('ascii')
+        host = ri.netloc.split(splitstr)[0]
+
+        try:
+            _netrc = netrc(netrc_path).authenticators(host)
+            if _netrc:
+                # Return with login / password
+                login_i = (0 if _netrc[0] else 1)
+                return (_netrc[login_i], _netrc[2])
+        except (NetrcParseError, IOError):
+            # If there was a parsing error or a permissions issue reading the file,
+            # we'll just skip netrc auth unless explicitly asked to raise errors.
+            if raise_errors:
+                raise
+
+    # AppEngine hackiness.
+    except (ImportError, AttributeError):
+        pass
+
+
+def guess_filename(obj):
+    """Tries to guess the filename of the given object."""
+    name = getattr(obj, 'name', None)
+    if (name and isinstance(name, basestring) and name[0] != '<' and
+            name[-1] != '>'):
+        return os.path.basename(name)
+
+
+def extract_zipped_paths(path):
+    """Replace nonexistent paths that look like they refer to a member of a zip
+    archive with the location of an extracted copy of the target, or else
+    just return the provided path unchanged.
+    """
+    if os.path.exists(path):
+        # this is already a valid path, no need to do anything further
+        return path
+
+    # find the first valid part of the provided path and treat that as a zip archive
+    # assume the rest of the path is the name of a member in the archive
+    archive, member = os.path.split(path)
+    while archive and not os.path.exists(archive):
+        archive, prefix = os.path.split(archive)
+        member = '/'.join([prefix, member])
+
+    if not zipfile.is_zipfile(archive):
+        return path
+
+    zip_file = zipfile.ZipFile(archive)
+    if member not in zip_file.namelist():
+        return path
+
+    # we have a valid zip archive and a valid member of that archive
+    tmp = tempfile.gettempdir()
+    extracted_path = os.path.join(tmp, *member.split('/'))
+    if not os.path.exists(extracted_path):
+        extracted_path = zip_file.extract(member, path=tmp)
+
+    return extracted_path
+
+
+def from_key_val_list(value):
+    """Take an object and test to see if it can be represented as a
+    dictionary. Unless it can not be represented as such, return an
+    OrderedDict, e.g.,
+
+    ::
+
+        >>> from_key_val_list([('key', 'val')])
+        OrderedDict([('key', 'val')])
+        >>> from_key_val_list('string')
+        ValueError: cannot encode objects that are not 2-tuples
+        >>> from_key_val_list({'key': 'val'})
+        OrderedDict([('key', 'val')])
+
+    :rtype: OrderedDict
+    """
+    if value is None:
+        return None
+
+    if isinstance(value, (str, bytes, bool, int)):
+        raise ValueError('cannot encode objects that are not 2-tuples')
+
+    return OrderedDict(value)
+
+
+def to_key_val_list(value):
+    """Take an object and test to see if it can be represented as a
+    dictionary. If it can be, return a list of tuples, e.g.,
+
+    ::
+
+        >>> to_key_val_list([('key', 'val')])
+        [('key', 'val')]
+        >>> to_key_val_list({'key': 'val'})
+        [('key', 'val')]
+        >>> to_key_val_list('string')
+        ValueError: cannot encode objects that are not 2-tuples.
+
+    :rtype: list
+    """
+    if value is None:
+        return None
+
+    if isinstance(value, (str, bytes, bool, int)):
+        raise ValueError('cannot encode objects that are not 2-tuples')
+
+    if isinstance(value, Mapping):
+        value = value.items()
+
+    return list(value)
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def parse_list_header(value):
+    """Parse lists as described by RFC 2068 Section 2.
+
+    In particular, parse comma-separated lists where the elements of
+    the list may include quoted-strings.  A quoted-string could
+    contain a comma.  A non-quoted string could have quotes in the
+    middle.  Quotes are removed automatically after parsing.
+
+    It basically works like :func:`parse_set_header` just that items
+    may appear multiple times and case sensitivity is preserved.
+
+    The return value is a standard :class:`list`:
+
+    >>> parse_list_header('token, "quoted value"')
+    ['token', 'quoted value']
+
+    To create a header from the :class:`list` again, use the
+    :func:`dump_header` function.
+
+    :param value: a string with a list header.
+    :return: :class:`list`
+    :rtype: list
+    """
+    result = []
+    for item in _parse_list_header(value):
+        if item[:1] == item[-1:] == '"':
+            item = unquote_header_value(item[1:-1])
+        result.append(item)
+    return result
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def parse_dict_header(value):
+    """Parse lists of key, value pairs as described by RFC 2068 Section 2 and
+    convert them into a python dict:
+
+    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
+    >>> type(d) is dict
+    True
+    >>> sorted(d.items())
+    [('bar', 'as well'), ('foo', 'is a fish')]
+
+    If there is no value for a key it will be `None`:
+
+    >>> parse_dict_header('key_without_value')
+    {'key_without_value': None}
+
+    To create a header from the :class:`dict` again, use the
+    :func:`dump_header` function.
+
+    :param value: a string with a dict header.
+    :return: :class:`dict`
+    :rtype: dict
+    """
+    result = {}
+    for item in _parse_list_header(value):
+        if '=' not in item:
+            result[item] = None
+            continue
+        name, value = item.split('=', 1)
+        if value[:1] == value[-1:] == '"':
+            value = unquote_header_value(value[1:-1])
+        result[name] = value
+    return result
+
+
+# From mitsuhiko/werkzeug (used with permission).
+def unquote_header_value(value, is_filename=False):
+    r"""Unquotes a header value.  (Reversal of :func:`quote_header_value`).
+    This does not use the real unquoting but what browsers are actually
+    using for quoting.
+
+    :param value: the header value to unquote.
+    :rtype: str
+    """
+    if value and value[0] == value[-1] == '"':
+        # this is not the real unquoting, but fixing this so that the
+        # RFC is met will result in bugs with internet explorer and
+        # probably some other browsers as well.  IE for example is
+        # uploading files with "C:\foo\bar.txt" as filename
+        value = value[1:-1]
+
+        # if this is a filename and the starting characters look like
+        # a UNC path, then just return the value without quotes.  Using the
+        # replace sequence below on a UNC path has the effect of turning
+        # the leading double slash into a single slash and then
+        # _fix_ie_filename() doesn't work correctly.  See #458.
+        if not is_filename or value[:2] != '\\\\':
+            return value.replace('\\\\', '\\').replace('\\"', '"')
+    return value
+
+
+def dict_from_cookiejar(cj):
+    """Returns a key/value dictionary from a CookieJar.
+
+    :param cj: CookieJar object to extract cookies from.
+    :rtype: dict
+    """
+
+    cookie_dict = {}
+
+    for cookie in cj:
+        cookie_dict[cookie.name] = cookie.value
+
+    return cookie_dict
+
+
+def add_dict_to_cookiejar(cj, cookie_dict):
+    """Returns a CookieJar from a key/value dictionary.
+
+    :param cj: CookieJar to insert cookies into.
+    :param cookie_dict: Dict of key/values to insert into CookieJar.
+    :rtype: CookieJar
+    """
+
+    return cookiejar_from_dict(cookie_dict, cj)
+
+
+def get_encodings_from_content(content):
+    """Returns encodings from given content string.
+
+    :param content: bytestring to extract encodings from.
+    """
+    warnings.warn((
+        'In requests 3.0, get_encodings_from_content will be removed. For '
+        'more information, please see the discussion on issue #2266. (This'
+        ' warning should only appear once.)'),
+        DeprecationWarning)
+
+    charset_re = re.compile(r'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I)
+    pragma_re = re.compile(r'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I)
+    xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]')
+
+    return (charset_re.findall(content) +
+            pragma_re.findall(content) +
+            xml_re.findall(content))
+
+
+def _parse_content_type_header(header):
+    """Returns content type and parameters from given header
+
+    :param header: string
+    :return: tuple containing content type and dictionary of
+         parameters
+    """
+
+    tokens = header.split(';')
+    content_type, params = tokens[0].strip(), tokens[1:]
+    params_dict = {}
+    items_to_strip = "\"' "
+
+    for param in params:
+        param = param.strip()
+        if param:
+            key, value = param, True
+            index_of_equals = param.find("=")
+            if index_of_equals != -1:
+                key = param[:index_of_equals].strip(items_to_strip)
+                value = param[index_of_equals + 1:].strip(items_to_strip)
+            params_dict[key.lower()] = value
+    return content_type, params_dict
+
+
+def get_encoding_from_headers(headers):
+    """Returns encodings from given HTTP Header Dict.
+
+    :param headers: dictionary to extract encoding from.
+    :rtype: str
+    """
+
+    content_type = headers.get('content-type')
+
+    if not content_type:
+        return None
+
+    content_type, params = _parse_content_type_header(content_type)
+
+    if 'charset' in params:
+        return params['charset'].strip("'\"")
+
+    if 'text' in content_type:
+        return 'ISO-8859-1'
+
+
+def stream_decode_response_unicode(iterator, r):
+    """Stream decodes a iterator."""
+
+    if r.encoding is None:
+        for item in iterator:
+            yield item
+        return
+
+    decoder = codecs.getincrementaldecoder(r.encoding)(errors='replace')
+    for chunk in iterator:
+        rv = decoder.decode(chunk)
+        if rv:
+            yield rv
+    rv = decoder.decode(b'', final=True)
+    if rv:
+        yield rv
+
+
+def iter_slices(string, slice_length):
+    """Iterate over slices of a string."""
+    pos = 0
+    if slice_length is None or slice_length <= 0:
+        slice_length = len(string)
+    while pos < len(string):
+        yield string[pos:pos + slice_length]
+        pos += slice_length
+
+
+def get_unicode_from_response(r):
+    """Returns the requested content back in unicode.
+
+    :param r: Response object to get unicode content from.
+
+    Tried:
+
+    1. charset from content-type
+    2. fall back and replace all unicode characters
+
+    :rtype: str
+    """
+    warnings.warn((
+        'In requests 3.0, get_unicode_from_response will be removed. For '
+        'more information, please see the discussion on issue #2266. (This'
+        ' warning should only appear once.)'),
+        DeprecationWarning)
+
+    tried_encodings = []
+
+    # Try charset from content-type
+    encoding = get_encoding_from_headers(r.headers)
+
+    if encoding:
+        try:
+            return str(r.content, encoding)
+        except UnicodeError:
+            tried_encodings.append(encoding)
+
+    # Fall back:
+    try:
+        return str(r.content, encoding, errors='replace')
+    except TypeError:
+        return r.content
+
+
+# The unreserved URI characters (RFC 3986)
+UNRESERVED_SET = frozenset(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~")
+
+
+def unquote_unreserved(uri):
+    """Un-escape any percent-escape sequences in a URI that are unreserved
+    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
+
+    :rtype: str
+    """
+    parts = uri.split('%')
+    for i in range(1, len(parts)):
+        h = parts[i][0:2]
+        if len(h) == 2 and h.isalnum():
+            try:
+                c = chr(int(h, 16))
+            except ValueError:
+                raise InvalidURL("Invalid percent-escape sequence: '%s'" % h)
+
+            if c in UNRESERVED_SET:
+                parts[i] = c + parts[i][2:]
+            else:
+                parts[i] = '%' + parts[i]
+        else:
+            parts[i] = '%' + parts[i]
+    return ''.join(parts)
+
+
+def requote_uri(uri):
+    """Re-quote the given URI.
+
+    This function passes the given URI through an unquote/quote cycle to
+    ensure that it is fully and consistently quoted.
+
+    :rtype: str
+    """
+    safe_with_percent = "!#$%&'()*+,/:;=?@[]~"
+    safe_without_percent = "!#$&'()*+,/:;=?@[]~"
+    try:
+        # Unquote only the unreserved characters
+        # Then quote only illegal characters (do not quote reserved,
+        # unreserved, or '%')
+        return quote(unquote_unreserved(uri), safe=safe_with_percent)
+    except InvalidURL:
+        # We couldn't unquote the given URI, so let's try quoting it, but
+        # there may be unquoted '%'s in the URI. We need to make sure they're
+        # properly quoted so they do not cause issues elsewhere.
+        return quote(uri, safe=safe_without_percent)
+
+
+def address_in_network(ip, net):
+    """This function allows you to check if an IP belongs to a network subnet
+
+    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
+             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24
+
+    :rtype: bool
+    """
+    ipaddr = struct.unpack('=L', socket.inet_aton(ip))[0]
+    netaddr, bits = net.split('/')
+    netmask = struct.unpack('=L', socket.inet_aton(dotted_netmask(int(bits))))[0]
+    network = struct.unpack('=L', socket.inet_aton(netaddr))[0] & netmask
+    return (ipaddr & netmask) == (network & netmask)
+
+
+def dotted_netmask(mask):
+    """Converts mask from /xx format to xxx.xxx.xxx.xxx
+
+    Example: if mask is 24 function returns 255.255.255.0
+
+    :rtype: str
+    """
+    bits = 0xffffffff ^ (1 << 32 - mask) - 1
+    return socket.inet_ntoa(struct.pack('>I', bits))
+
+
+def is_ipv4_address(string_ip):
+    """
+    :rtype: bool
+    """
+    try:
+        socket.inet_aton(string_ip)
+    except socket.error:
+        return False
+    return True
+
+
+def is_valid_cidr(string_network):
+    """
+    Very simple check of the cidr format in no_proxy variable.
+
+    :rtype: bool
+    """
+    if string_network.count('/') == 1:
+        try:
+            mask = int(string_network.split('/')[1])
+        except ValueError:
+            return False
+
+        if mask < 1 or mask > 32:
+            return False
+
+        try:
+            socket.inet_aton(string_network.split('/')[0])
+        except socket.error:
+            return False
+    else:
+        return False
+    return True
+
+
+@contextlib.contextmanager
+def set_environ(env_name, value):
+    """Set the environment variable 'env_name' to 'value'
+
+    Save previous value, yield, and then restore the previous value stored in
+    the environment variable 'env_name'.
+
+    If 'value' is None, do nothing"""
+    value_changed = value is not None
+    if value_changed:
+        old_value = os.environ.get(env_name)
+        os.environ[env_name] = value
+    try:
+        yield
+    finally:
+        if value_changed:
+            if old_value is None:
+                del os.environ[env_name]
+            else:
+                os.environ[env_name] = old_value
+
+
+def should_bypass_proxies(url, no_proxy):
+    """
+    Returns whether we should bypass proxies or not.
+
+    :rtype: bool
+    """
+    # Prioritize lowercase environment variables over uppercase
+    # to keep a consistent behaviour with other http projects (curl, wget).
+    get_proxy = lambda k: os.environ.get(k) or os.environ.get(k.upper())
+
+    # First check whether no_proxy is defined. If it is, check that the URL
+    # we're getting isn't in the no_proxy list.
+    no_proxy_arg = no_proxy
+    if no_proxy is None:
+        no_proxy = get_proxy('no_proxy')
+    parsed = urlparse(url)
+
+    if parsed.hostname is None:
+        # URLs don't always have hostnames, e.g. file:/// urls.
+        return True
+
+    if no_proxy:
+        # We need to check whether we match here. We need to see if we match
+        # the end of the hostname, both with and without the port.
+        no_proxy = (
+            host for host in no_proxy.replace(' ', '').split(',') if host
+        )
+
+        if is_ipv4_address(parsed.hostname):
+            for proxy_ip in no_proxy:
+                if is_valid_cidr(proxy_ip):
+                    if address_in_network(parsed.hostname, proxy_ip):
+                        return True
+                elif parsed.hostname == proxy_ip:
+                    # If no_proxy ip was defined in plain IP notation instead of cidr notation &
+                    # matches the IP of the index
+                    return True
+        else:
+            host_with_port = parsed.hostname
+            if parsed.port:
+                host_with_port += ':{}'.format(parsed.port)
+
+            for host in no_proxy:
+                if parsed.hostname.endswith(host) or host_with_port.endswith(host):
+                    # The URL does match something in no_proxy, so we don't want
+                    # to apply the proxies on this URL.
+                    return True
+
+    with set_environ('no_proxy', no_proxy_arg):
+        # parsed.hostname can be `None` in cases such as a file URI.
+        try:
+            bypass = proxy_bypass(parsed.hostname)
+        except (TypeError, socket.gaierror):
+            bypass = False
+
+    if bypass:
+        return True
+
+    return False
+
+
+def get_environ_proxies(url, no_proxy=None):
+    """
+    Return a dict of environment proxies.
+
+    :rtype: dict
+    """
+    if should_bypass_proxies(url, no_proxy=no_proxy):
+        return {}
+    else:
+        return getproxies()
+
+
+def select_proxy(url, proxies):
+    """Select a proxy for the url, if applicable.
+
+    :param url: The url being for the request
+    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
+    """
+    proxies = proxies or {}
+    urlparts = urlparse(url)
+    if urlparts.hostname is None:
+        return proxies.get(urlparts.scheme, proxies.get('all'))
+
+    proxy_keys = [
+        urlparts.scheme + '://' + urlparts.hostname,
+        urlparts.scheme,
+        'all://' + urlparts.hostname,
+        'all',
+    ]
+    proxy = None
+    for proxy_key in proxy_keys:
+        if proxy_key in proxies:
+            proxy = proxies[proxy_key]
+            break
+
+    return proxy
+
+
+def default_user_agent(name="python-requests"):
+    """
+    Return a string representing the default user agent.
+
+    :rtype: str
+    """
+    return '%s/%s' % (name, __version__)
+
+
+def default_headers():
+    """
+    :rtype: requests.structures.CaseInsensitiveDict
+    """
+    return CaseInsensitiveDict({
+        'User-Agent': default_user_agent(),
+        'Accept-Encoding': ', '.join(('gzip', 'deflate')),
+        'Accept': '*/*',
+        'Connection': 'keep-alive',
+    })
+
+
+def parse_header_links(value):
+    """Return a list of parsed link headers proxies.
+
+    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"
+
+    :rtype: list
+    """
+
+    links = []
+
+    replace_chars = ' \'"'
+
+    value = value.strip(replace_chars)
+    if not value:
+        return links
+
+    for val in re.split(', *<', value):
+        try:
+            url, params = val.split(';', 1)
+        except ValueError:
+            url, params = val, ''
+
+        link = {'url': url.strip('<> \'"')}
+
+        for param in params.split(';'):
+            try:
+                key, value = param.split('=')
+            except ValueError:
+                break
+
+            link[key.strip(replace_chars)] = value.strip(replace_chars)
+
+        links.append(link)
+
+    return links
+
+
+# Null bytes; no need to recreate these on each call to guess_json_utf
+_null = '\x00'.encode('ascii')  # encoding to ASCII for Python 3
+_null2 = _null * 2
+_null3 = _null * 3
+
+
+def guess_json_utf(data):
+    """
+    :rtype: str
+    """
+    # JSON always starts with two ASCII characters, so detection is as
+    # easy as counting the nulls and from their location and count
+    # determine the encoding. Also detect a BOM, if present.
+    sample = data[:4]
+    if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE):
+        return 'utf-32'     # BOM included
+    if sample[:3] == codecs.BOM_UTF8:
+        return 'utf-8-sig'  # BOM included, MS style (discouraged)
+    if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE):
+        return 'utf-16'     # BOM included
+    nullcount = sample.count(_null)
+    if nullcount == 0:
+        return 'utf-8'
+    if nullcount == 2:
+        if sample[::2] == _null2:   # 1st and 3rd are null
+            return 'utf-16-be'
+        if sample[1::2] == _null2:  # 2nd and 4th are null
+            return 'utf-16-le'
+        # Did not detect 2 valid UTF-16 ascii-range characters
+    if nullcount == 3:
+        if sample[:3] == _null3:
+            return 'utf-32-be'
+        if sample[1:] == _null3:
+            return 'utf-32-le'
+        # Did not detect a valid UTF-32 ascii-range character
+    return None
+
+
+def prepend_scheme_if_needed(url, new_scheme):
+    """Given a URL that may or may not have a scheme, prepend the given scheme.
+    Does not replace a present scheme with the one provided as an argument.
+
+    :rtype: str
+    """
+    scheme, netloc, path, params, query, fragment = urlparse(url, new_scheme)
+
+    # urlparse is a finicky beast, and sometimes decides that there isn't a
+    # netloc present. Assume that it's being over-cautious, and switch netloc
+    # and path if urlparse decided there was no netloc.
+    if not netloc:
+        netloc, path = path, netloc
+
+    return urlunparse((scheme, netloc, path, params, query, fragment))
+
+
+def get_auth_from_url(url):
+    """Given a url with authentication components, extract them into a tuple of
+    username,password.
+
+    :rtype: (str,str)
+    """
+    parsed = urlparse(url)
+
+    try:
+        auth = (unquote(parsed.username), unquote(parsed.password))
+    except (AttributeError, TypeError):
+        auth = ('', '')
+
+    return auth
+
+
+# Moved outside of function to avoid recompile every call
+_CLEAN_HEADER_REGEX_BYTE = re.compile(b'^\\S[^\\r\\n]*$|^$')
+_CLEAN_HEADER_REGEX_STR = re.compile(r'^\S[^\r\n]*$|^$')
+
+
+def check_header_validity(header):
+    """Verifies that header value is a string which doesn't contain
+    leading whitespace or return characters. This prevents unintended
+    header injection.
+
+    :param header: tuple, in the format (name, value).
+    """
+    name, value = header
+
+    if isinstance(value, bytes):
+        pat = _CLEAN_HEADER_REGEX_BYTE
+    else:
+        pat = _CLEAN_HEADER_REGEX_STR
+    try:
+        if not pat.match(value):
+            raise InvalidHeader("Invalid return character or leading space in header: %s" % name)
+    except TypeError:
+        raise InvalidHeader("Value for header {%s: %s} must be of type str or "
+                            "bytes, not %s" % (name, value, type(value)))
+
+
+def urldefragauth(url):
+    """
+    Given a url remove the fragment and the authentication part.
+
+    :rtype: str
+    """
+    scheme, netloc, path, params, query, fragment = urlparse(url)
+
+    # see func:`prepend_scheme_if_needed`
+    if not netloc:
+        netloc, path = path, netloc
+
+    netloc = netloc.rsplit('@', 1)[-1]
+
+    return urlunparse((scheme, netloc, path, params, query, ''))
+
+
+def rewind_body(prepared_request):
+    """Move file pointer back to its recorded starting position
+    so it can be read again on redirect.
+    """
+    body_seek = getattr(prepared_request.body, 'seek', None)
+    if body_seek is not None and isinstance(prepared_request._body_position, integer_types):
+        try:
+            body_seek(prepared_request._body_position)
+        except (IOError, OSError):
+            raise UnrewindableBodyError("An error occurred when rewinding request "
+                                        "body for redirect.")
+    else:
+        raise UnrewindableBodyError("Unable to rewind request body for redirect.")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/AUTHORS.rst b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/AUTHORS.rst
new file mode 100644
index 0000000000000000000000000000000000000000..2efa3070603f957158d53a92fe6aea3217da3d85
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/AUTHORS.rst
@@ -0,0 +1,53 @@
+Requests-toolbelt is written and maintained by Ian Cordasco, Cory Benfield and
+various contributors:
+
+Development Lead
+````````````````
+
+- Ian Cordasco
+
+- Cory Benfield
+
+
+Requests
+````````
+
+- Kenneth Reitz <me@kennethreitz.com> and various contributors
+
+
+Urllib3
+```````
+
+- Andrey Petrov <andrey.petrov@shazow.net>
+
+
+Patches and Suggestions
+```````````````````````
+
+- Jay De Lanoy <jay@delanoy.co>
+
+- Zhaoyu Luo <luozhaoyu90@gmail.com>
+
+- Markus Unterwaditzer <markus@unterwaditzer.net>
+
+- Bryce Boe <bbzbryce@gmail.com> (@bboe)
+
+- Dan Lipsitt (https://github.com/DanLipsitt)
+
+- Cea Stapleton (http://www.ceastapleton.com)
+
+- Patrick Creech <pcreech@redhat.com>
+
+- Mike Lambert (@mikelambert)
+
+- Ryan Barrett (https://snarfed.org/)
+
+- Victor Grau Serrat (@lacabra)
+
+- Yorgos Pagles <yorgos@pagles.org>
+
+- Thomas Hauk <thauk@copperleaf.com>
+
+- Achim Herwig <python@wodca.de>
+
+- Ryan Ashley <rashley-iqt>
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..13c64acb864106a5df3e876e559e6855d31ece76
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/LICENSE
@@ -0,0 +1,13 @@
+Copyright 2014 Ian Cordasco, Cory Benfield
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..e08605941c725afe4a3d9791dfe9029bf8487990
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/METADATA
@@ -0,0 +1,482 @@
+Metadata-Version: 2.1
+Name: requests-toolbelt
+Version: 0.9.1
+Summary: A utility belt for advanced users of python-requests
+Home-page: https://toolbelt.readthedocs.org
+Author: Ian Cordasco, Cory Benfield
+Author-email: graffatcolmingov@gmail.com
+License: Apache 2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Dist: requests (<3.0.0,>=2.0.1)
+
+The Requests Toolbelt
+=====================
+
+This is just a collection of utilities for `python-requests`_, but don't 
+really belong in ``requests`` proper. The minimum tested requests version is 
+``2.1.0``. In reality, the toolbelt should work with ``2.0.1`` as well, but 
+some idiosyncracies prevent effective or sane testing on that version.
+
+``pip install requests-toolbelt`` to get started!
+
+
+multipart/form-data Encoder
+---------------------------
+
+The main attraction is a streaming multipart form-data object, ``MultipartEncoder``.
+Its API looks like this:
+
+.. code-block:: python
+
+    from requests_toolbelt import MultipartEncoder
+    import requests
+
+    m = MultipartEncoder(
+        fields={'field0': 'value', 'field1': 'value',
+                'field2': ('filename', open('file.py', 'rb'), 'text/plain')}
+        )
+
+    r = requests.post('http://httpbin.org/post', data=m,
+                      headers={'Content-Type': m.content_type})
+
+
+You can also use ``multipart/form-data`` encoding for requests that don't
+require files:
+
+.. code-block:: python
+
+    from requests_toolbelt import MultipartEncoder
+    import requests
+
+    m = MultipartEncoder(fields={'field0': 'value', 'field1': 'value'})
+
+    r = requests.post('http://httpbin.org/post', data=m,
+                      headers={'Content-Type': m.content_type})
+
+
+Or, you can just create the string and examine the data:
+
+.. code-block:: python
+
+    # Assuming `m` is one of the above
+    m.to_string()  # Always returns unicode
+
+
+User-Agent constructor
+----------------------
+
+You can easily construct a requests-style ``User-Agent`` string::
+
+    from requests_toolbelt import user_agent
+
+    headers = {
+        'User-Agent': user_agent('my_package', '0.0.1')
+        }
+
+    r = requests.get('https://api.github.com/users', headers=headers)
+
+
+SSLAdapter
+----------
+
+The ``SSLAdapter`` was originally published on `Cory Benfield's blog`_. 
+This adapter allows the user to choose one of the SSL protocols made available 
+in Python's ``ssl`` module for outgoing HTTPS connections:
+
+.. code-block:: python
+
+    from requests_toolbelt import SSLAdapter
+    import requests
+    import ssl
+
+    s = requests.Session()
+    s.mount('https://', SSLAdapter(ssl.PROTOCOL_TLSv1))
+
+cookies/ForgetfulCookieJar
+--------------------------
+
+The ``ForgetfulCookieJar`` prevents a particular requests session from storing 
+cookies:
+
+.. code-block:: python
+
+    from requests_toolbelt.cookies.forgetful import ForgetfulCookieJar
+
+    session = requests.Session()
+    session.cookies = ForgetfulCookieJar()
+
+Known Issues
+------------
+
+On Python 3.3.0 and 3.3.1, the standard library's ``http`` module will fail
+when passing an instance of the ``MultipartEncoder``. This is fixed in later
+minor releases of Python 3.3. Please consider upgrading to a later minor
+version or Python 3.4. *There is absolutely nothing this library can do to
+work around that bug.*
+
+Contributing
+------------
+
+Please read the `suggested workflow
+<https://toolbelt.readthedocs.org/en/latest/contributing.html>`_ for
+contributing to this project.
+
+Please report any bugs on the `issue tracker`_
+
+.. _Cory Benfield's blog: https://lukasa.co.uk/2013/01/Choosing_SSL_Version_In_Requests/
+.. _python-requests: https://github.com/kennethreitz/requests
+.. _issue tracker: https://github.com/requests/toolbelt/issues
+
+
+History
+=======
+
+0.9.1 -- 2019-01-29
+-------------------
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Fix import of pyOpenSSL shim from urllib3 for PKCS12 adapter
+
+0.9.0 -- 2019-01-29
+-------------------
+
+New Features
+~~~~~~~~~~~~
+
+- Add X509 Adapter that can handle PKCS12 
+- Add stateless solution for streaming files by MultipartEncoder from one host to another (in chunks)
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Update link to example
+- Move import of ``ABCs`` from collections into version-specific part of
+  _compat module
+- Fix backwards incompatibility in ``get_encodings_from_content``
+- Correct callback documentation for ``MultipartEncoderMonitor``
+- Fix bug when ``MultipartEncoder`` is asked to encode zero parts
+- Correct the type of non string request body dumps
+- Removed content from being stored in MultipartDecoder
+- Fix bug by enabling support for contenttype with capital letters. 
+- Coerce proxy URL to bytes before dumping request
+- Avoid bailing out with exception upon empty response reason
+- Corrected Pool documentation
+- Corrected parentheses match in example usage
+- Fix "oject" to "object" in ``MultipartEncoder``
+- Fix URL for the project after the move 
+- Add fix for OSX TCPKeepAliveAdapter
+
+Miscellaneous
+~~~~~~~~~~~~~
+
+- Remove py33 from testing and add Python 3.6 and nightly testing to the travis matrix.
+
+0.8.0 -- 2017-05-20
+-------------------
+
+More information about this release can be found on the `0.8.0 milestone`_.
+
+New Features
+~~~~~~~~~~~~
+
+- Add ``UserAgentBuilder`` to provide more control over generated User-Agent
+  strings.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Include ``_validate_certificate`` in the lits of picked attributes on the
+  ``AppEngineAdapter``.
+- Fix backwards incompatibility in ``get_encodings_from_content``
+
+.. _0.8.0 milestone:
+    https://github.com/requests/toolbelt/milestones/0.8.0
+
+0.7.1 -- 2017-02-13
+-------------------
+
+More information about this release can be found on the `0.7.1 milestone`_.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Fixed monkey-patching for the AppEngineAdapter.
+
+- Make it easier to disable certificate verification when monkey-patching
+  AppEngine.
+
+- Handle ``multipart/form-data`` bodies without a trailing ``CRLF``.
+
+
+.. links
+.. _0.7.1 milestone:
+    https://github.com/requests/toolbelt/milestone/9
+
+0.7.0 -- 2016-07-21
+-------------------
+
+More information about this release can be found on the `0.7.0 milestone`_.
+
+New Features
+~~~~~~~~~~~~
+
+- Add ``BaseUrlSession`` to allow developers to have a session that has a
+  "Base" URL. See the documentation for more details and examples.
+
+- Split the logic of ``stream_response_to_file`` into two separate functions:
+
+  * ``get_download_file_path`` to generate the file name from the Response.
+
+  * ``stream_response_to_file`` which will use ``get_download_file_path`` if
+    necessary
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Fixed the issue for people using *very* old versions of Requests where they
+  would see an ImportError from ``requests_toolbelt._compat`` when trying to
+  import ``connection``.
+
+
+.. _0.7.0 milestone:
+    https://github.com/requests/toolbelt/milestones/0.7.0
+
+0.6.2 -- 2016-05-10
+-------------------
+
+Fixed Bugs
+~~~~~~~~~~
+
+- When passing a timeout via Requests, it was not appropriately translated to
+  the timeout that the urllib3 code was expecting.
+
+0.6.1 -- 2016-05-05
+-------------------
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Remove assertion about request URLs in the AppEngineAdapter.
+
+- Prevent pip from installing requests 3.0.0 when that is released until we
+  are ready to handle it.
+
+0.6.0 -- 2016-01-27
+-------------------
+
+More information about this release can be found on the `0.6.0 milestone`_.
+
+New Features
+~~~~~~~~~~~~
+
+- Add ``AppEngineAdapter`` to support developers using Google's AppEngine
+  platform with Requests.
+
+- Add ``GuessProxyAuth`` class to support guessing between Basic and Digest
+  Authentication for proxies.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Ensure that proxies use the correct TLS version when using the
+  ``SSLAdapter``.
+
+- Fix an ``AttributeError`` when using the ``HTTPProxyDigestAuth`` class.
+
+Miscellaneous
+~~~~~~~~~~~~~
+
+- Drop testing support for Python 3.2. virtualenv and pip have stopped
+  supporting it meaning that it is harder to test for this with our CI
+  infrastructure. Moving forward we will make a best-effort attempt to
+  support 3.2 but will not test for it.
+
+
+.. _0.6.0 milestone:
+    https://github.com/requests/toolbelt/milestones/0.6.0
+
+0.5.1 -- 2015-12-16
+-------------------
+
+More information about this release can be found on the `0.5.1 milestone`_.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Now papers over the differences in requests' ``super_len`` function from
+  versions prior to 2.9.0 and versions 2.9.0 and later.
+
+
+.. _0.5.1 milestone:
+    https://github.com/requests/toolbelt/milestones/0.5.1
+
+0.5.0 -- 2015-11-24
+-------------------
+
+More information about this release can be found on the `milestone
+<https://github.com/requests/toolbelt/issues?utf8=%E2%9C%93&q=is%3Aall+milestone%3A0.5+>`_
+for 0.5.0.
+
+New Features
+~~~~~~~~~~~~
+
+- The ``tee`` submodule was added to ``requests_toolbelt.downloadutils``. It
+  allows you to iterate over the bytes of a response while also writing them
+  to a file. The ``tee.tee`` function, expects you to pass an open file
+  object, while ``tee.tee_to_file`` will use the provided file name to open
+  the file for you.
+
+- Added a new parameter to ``requests_toolbelt.utils.user_agent`` that allows
+  the user to specify additional items.
+
+- Added nested form-data helper,
+  ``requests_toolbelt.utils.formdata.urlencode``.
+
+- Added the ``ForgetfulCookieJar`` to ``requests_toolbelt.cookies``.
+
+- Added utilities for dumping the information about a request-response cycle
+  in ``requests_toolbelt.utils.dump``.
+
+- Implemented the API described in the ``requests_toolbelt.threaded`` module
+  docstring, i.e., added ``requests_toolbelt.threaded.map`` as an available
+  function.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- Now papers over the API differences in versions of requests installed from
+  system packages versus versions of requests installed from PyPI.
+
+- Allow string types for ``SourceAddressAdapter``.
+
+0.4.0 -- 2015-04-03
+-------------------
+
+For more information about this release, please see `milestone 0.4.0
+<https://github.com/requests/toolbelt/issues?q=milestone%3A0.4>`_
+on the project's page.
+
+New Features
+~~~~~~~~~~~~
+
+- A naive implemenation of a thread pool is now included in the toolbelt. See
+  the docs in ``docs/threading.rst`` or on `Read The Docs
+  <https://toolbelt.readthedocs.org>`_.
+
+- The ``StreamingIterator`` now accepts files (such as ``sys.stdin``) without
+  a specific length and will properly stream them.
+
+- The ``MultipartEncoder`` now accepts exactly the same format of fields as
+  requests' ``files`` parameter does. In other words, you can now also pass in
+  extra headers to add to a part in the body. You can also now specify a
+  custom ``Content-Type`` for a part.
+
+- An implementation of HTTP Digest Authentication for Proxies is now included.
+
+- A transport adapter that allows a user to specify a specific Certificate
+  Fingerprint is now included in the toolbelt.
+
+- A transport adapter that simplifies how users specify socket options is now
+  included.
+
+- A transport adapter that simplifies how users can specify TCP Keep-Alive
+  options is now included in the toolbelt.
+
+- Deprecated functions from ``requests.utils`` are now included and
+  maintained.
+
+- An authentication tool that allows users to specify how to authenticate to
+  several different domains at once is now included.
+
+- A function to save streamed responses to disk by analyzing the
+  ``Content-Disposition`` header is now included in the toolbelt.
+
+Fixed Bugs
+~~~~~~~~~~
+
+- The ``MultipartEncoder`` will now allow users to upload files larger than
+  4GB on 32-bit systems.
+
+- The ``MultipartEncoder`` will now accept empty unicode strings for form
+  values.
+
+0.3.1 -- 2014-06-23
+-------------------
+
+- Fix the fact that 0.3.0 bundle did not include the ``StreamingIterator``
+
+0.3.0 -- 2014-05-21
+-------------------
+
+Bug Fixes
+~~~~~~~~~
+
+- Complete rewrite of ``MultipartEncoder`` fixes bug where bytes were lost in
+  uploads
+
+New Features
+~~~~~~~~~~~~
+
+- ``MultipartDecoder`` to accept ``multipart/form-data`` response bodies and
+  parse them into an easy to use object.
+
+- ``SourceAddressAdapter`` to allow users to choose a local address to bind
+  connections to.
+
+- ``GuessAuth`` which accepts a username and password and uses the
+  ``WWW-Authenticate`` header to determine how to authenticate against a
+  server.
+
+- ``MultipartEncoderMonitor`` wraps an instance of the ``MultipartEncoder``
+  and keeps track of how many bytes were read and will call the provided
+  callback.
+
+- ``StreamingIterator`` will wrap an iterator and stream the upload instead of
+  chunk it, provided you also provide the length of the content you wish to
+  upload.
+
+0.2.0 -- 2014-02-24
+-------------------
+
+- Add ability to tell ``MultipartEncoder`` which encoding to use. By default
+  it uses 'utf-8'.
+
+- Fix #10 - allow users to install with pip
+
+- Fix #9 - Fix ``MultipartEncoder#to_string`` so that it properly handles file
+  objects as fields
+
+0.1.2 -- 2014-01-19
+-------------------
+
+- At some point during development we broke how we handle normal file objects.
+  Thanks to @konomae this is now fixed.
+
+0.1.1 -- 2014-01-19
+-------------------
+
+- Handle ``io.BytesIO``-like objects better
+
+0.1.0 -- 2014-01-18
+-------------------
+
+- Add initial implementation of the streaming ``MultipartEncoder``
+
+- Add initial implementation of the ``user_agent`` function
+
+- Add the ``SSLAdapter``
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6b4f6354413bc0230ef93653d47d85d9c41d5daf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/RECORD
@@ -0,0 +1,75 @@
+requests_toolbelt-0.9.1.dist-info/AUTHORS.rst,sha256=UIQVRmi8wwPjhXoIhsRrepLX05C7N04i6eM52DHf_eY,902
+requests_toolbelt-0.9.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+requests_toolbelt-0.9.1.dist-info/LICENSE,sha256=Oho8_6erwADL1yamZPVsM8UypVSA-eBW3-lBz5O3w38,595
+requests_toolbelt-0.9.1.dist-info/METADATA,sha256=Ij-vbWPcMGBCy6-Or54hmaCh6E-MhkOZLx3oKyFWQyc,13807
+requests_toolbelt-0.9.1.dist-info/RECORD,,
+requests_toolbelt-0.9.1.dist-info/WHEEL,sha256=_wJFdOYk7i3xxT8ElOkUJvOdOvfNGbR9g-bf6UQT6sU,110
+requests_toolbelt-0.9.1.dist-info/top_level.txt,sha256=94d34hHwG8qjeDXYn9Co3jucG_N9CkO-V5kWQ6Cre8w,18
+requests_toolbelt/__init__.py,sha256=seklPG53_MZXW1ceVirG8wHQcEBhUPX2aLsdDcTOg14,1181
+requests_toolbelt/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/__pycache__/_compat.cpython-38.pyc,,
+requests_toolbelt/__pycache__/exceptions.cpython-38.pyc,,
+requests_toolbelt/__pycache__/sessions.cpython-38.pyc,,
+requests_toolbelt/__pycache__/streaming_iterator.cpython-38.pyc,,
+requests_toolbelt/_compat.py,sha256=oAsGRwH1It25nrmod9jG25DHKmQMRaeUG8vgPRHNC64,9893
+requests_toolbelt/adapters/__init__.py,sha256=aHfAB7Gt5HDtrvNWaRObcmU3JTlfwRLLXXxZIOa9BWk,363
+requests_toolbelt/adapters/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/appengine.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/fingerprint.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/host_header_ssl.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/socket_options.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/source.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/ssl.cpython-38.pyc,,
+requests_toolbelt/adapters/__pycache__/x509.cpython-38.pyc,,
+requests_toolbelt/adapters/appengine.py,sha256=f7HAfWRsXoPa0AEQpUlS6HIsY9RUxlQWjoFq1bRjRsk,7540
+requests_toolbelt/adapters/fingerprint.py,sha256=NRL_75ZO-nIvOOG8KIqgzXLoLN6B6leRKfT78P3cQQE,1404
+requests_toolbelt/adapters/host_header_ssl.py,sha256=6UbWnM3DYG6PROLPjzuCo3PEw-BxLXTUMtl68sAOIlk,1396
+requests_toolbelt/adapters/socket_options.py,sha256=smrs73O0zLJKlbJc5R1QD14lAw7kvRG3_GhMw1RUDUs,4789
+requests_toolbelt/adapters/source.py,sha256=n0WBD4vOUZm2aZqKEFzmiQo8_uslXBkNqG2wti4lKDg,2608
+requests_toolbelt/adapters/ssl.py,sha256=QGjVCHwqSTzvP58EIYOb47CdLB9KPg5AmGDNQ7buwwA,2399
+requests_toolbelt/adapters/x509.py,sha256=9ypicNCvGIfLdCPzExm6ri-WzM4MxniAGBM4MBQIr0o,7324
+requests_toolbelt/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+requests_toolbelt/auth/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/auth/__pycache__/_digest_auth_compat.cpython-38.pyc,,
+requests_toolbelt/auth/__pycache__/guess.cpython-38.pyc,,
+requests_toolbelt/auth/__pycache__/handler.cpython-38.pyc,,
+requests_toolbelt/auth/__pycache__/http_proxy_digest.cpython-38.pyc,,
+requests_toolbelt/auth/_digest_auth_compat.py,sha256=Japu0u8KwV3IFbRiEmzrxVR6MxINnpmbPYeEqyh_zbM,910
+requests_toolbelt/auth/guess.py,sha256=QSl22nPByDKiuACvR5uxpVbtGcMby8SwAHjwsPW9sD0,4944
+requests_toolbelt/auth/handler.py,sha256=0kC45uh-DGcUc4d1mCIZ8vLLONGUK9vrQ96Zovq1c_s,4408
+requests_toolbelt/auth/http_proxy_digest.py,sha256=LzZOs1Dllk2GvX1Dq9xTtdwFMppUcNC__2DVtWMY5fg,3705
+requests_toolbelt/cookies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+requests_toolbelt/cookies/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/cookies/__pycache__/forgetful.cpython-38.pyc,,
+requests_toolbelt/cookies/forgetful.py,sha256=B3_AB6lyRHJG4WvvKobS5W_MTP31BQ5RrLs3uYVx7cs,213
+requests_toolbelt/downloadutils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+requests_toolbelt/downloadutils/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/downloadutils/__pycache__/stream.cpython-38.pyc,,
+requests_toolbelt/downloadutils/__pycache__/tee.cpython-38.pyc,,
+requests_toolbelt/downloadutils/stream.py,sha256=ryVjUCEDtVff-QyY8N8tRF8WXIW_sMSyeQsLlBNxBvg,6069
+requests_toolbelt/downloadutils/tee.py,sha256=qV9Bwq83OZWDg-lW0YsP4Cdzsu0gc797GCSv6w7dPPw,4365
+requests_toolbelt/exceptions.py,sha256=1bm02fkuugxiPEGX70Eqt3Esr6rKAzMq8L37SFs0lFA,1135
+requests_toolbelt/multipart/__init__.py,sha256=DBN8VAhbphNGErpKSrYTIk8QYaofmnddPWtNmn2Ujdc,847
+requests_toolbelt/multipart/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/multipart/__pycache__/decoder.cpython-38.pyc,,
+requests_toolbelt/multipart/__pycache__/encoder.cpython-38.pyc,,
+requests_toolbelt/multipart/decoder.py,sha256=aKIBsljH8zDOGLesGCARDaVgEgmZ9AOQeGbM6JT1fVM,4861
+requests_toolbelt/multipart/encoder.py,sha256=aLJPUvWsPOUvDG1V9BBeHih3SEUTL_4zNO8nsYwS3pA,20772
+requests_toolbelt/sessions.py,sha256=dRi6ty0DposGvZHFPp4TodnhgTr98IBT5R9i5wExdTM,2321
+requests_toolbelt/streaming_iterator.py,sha256=RoBpiFO996ixJ7XBdeTEDcvdt2gO8UifRZHLydRUlQ0,4044
+requests_toolbelt/threaded/__init__.py,sha256=ZUw0h0PkLXz9H0qsPKgSD0_kX8SpLH8yjb3RvIWkuOg,3213
+requests_toolbelt/threaded/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/threaded/__pycache__/pool.cpython-38.pyc,,
+requests_toolbelt/threaded/__pycache__/thread.cpython-38.pyc,,
+requests_toolbelt/threaded/pool.py,sha256=8xSLI2_xElatT09jDVDua3693WXkm6vWFPQBHhLs48Y,6628
+requests_toolbelt/threaded/thread.py,sha256=16UmWaK_lZgDcKkBkS1j-6_K3zKIok314g7Fpllj2Jg,1465
+requests_toolbelt/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+requests_toolbelt/utils/__pycache__/__init__.cpython-38.pyc,,
+requests_toolbelt/utils/__pycache__/deprecated.cpython-38.pyc,,
+requests_toolbelt/utils/__pycache__/dump.cpython-38.pyc,,
+requests_toolbelt/utils/__pycache__/formdata.cpython-38.pyc,,
+requests_toolbelt/utils/__pycache__/user_agent.cpython-38.pyc,,
+requests_toolbelt/utils/deprecated.py,sha256=KERWioUNTuwTCRFJOyW_zJKib20-iNETE879znAcnJU,2558
+requests_toolbelt/utils/dump.py,sha256=ML9r5O50x6WFa1AGr4_lW_LDUiX3-BOPvCjD3iSRX14,6490
+requests_toolbelt/utils/formdata.py,sha256=ppqpIdkW6V0CNyeFiKAytDU0H9g1yXLzZU0QTuWrjb0,3233
+requests_toolbelt/utils/user_agent.py,sha256=iyeEadoOTsWMANRh2XzhDnwnUyX8K6BT9yZAfVTiwh0,4524
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..c4bde30377756381c5d37d2ed1a082566a715c9b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.32.3)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..976bdfe94eb65daff9a297c3455db84a53a75f87
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt-0.9.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+requests_toolbelt
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..888b77ecc27c14c658591763bc4ed973e6542c2b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/__init__.py
@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+"""
+requests-toolbelt
+=================
+
+See http://toolbelt.rtfd.org/ for documentation
+
+:copyright: (c) 2014 by Ian Cordasco and Cory Benfield
+:license: Apache v2.0, see LICENSE for more details
+"""
+
+from .adapters import SSLAdapter, SourceAddressAdapter
+from .auth.guess import GuessAuth
+from .multipart import (
+    MultipartEncoder, MultipartEncoderMonitor, MultipartDecoder,
+    ImproperBodyPartContentException, NonMultipartContentTypeException
+    )
+from .streaming_iterator import StreamingIterator
+from .utils.user_agent import user_agent
+
+__title__ = 'requests-toolbelt'
+__authors__ = 'Ian Cordasco, Cory Benfield'
+__license__ = 'Apache v2.0'
+__copyright__ = 'Copyright 2014 Ian Cordasco, Cory Benfield'
+__version__ = '0.9.1'
+__version_info__ = tuple(int(i) for i in __version__.split('.'))
+
+__all__ = [
+    'GuessAuth', 'MultipartEncoder', 'MultipartEncoderMonitor',
+    'MultipartDecoder', 'SSLAdapter', 'SourceAddressAdapter',
+    'StreamingIterator', 'user_agent', 'ImproperBodyPartContentException',
+    'NonMultipartContentTypeException', '__title__', '__authors__',
+    '__license__', '__copyright__', '__version__', '__version_info__',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..622e77fa198e80cc4efdfdad2e8596c1b2c712f0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/_compat.py
@@ -0,0 +1,324 @@
+"""Private module full of compatibility hacks.
+
+Primarily this is for downstream redistributions of requests that unvendor
+urllib3 without providing a shim.
+
+.. warning::
+
+    This module is private. If you use it, and something breaks, you were
+    warned
+"""
+import sys
+
+import requests
+
+try:
+    from requests.packages.urllib3 import fields
+    from requests.packages.urllib3 import filepost
+    from requests.packages.urllib3 import poolmanager
+except ImportError:
+    from urllib3 import fields
+    from urllib3 import filepost
+    from urllib3 import poolmanager
+
+try:
+    from requests.packages.urllib3.connection import HTTPConnection
+    from requests.packages.urllib3 import connection
+except ImportError:
+    try:
+        from urllib3.connection import HTTPConnection
+        from urllib3 import connection
+    except ImportError:
+        HTTPConnection = None
+        connection = None
+
+
+if requests.__build__ < 0x020300:
+    timeout = None
+else:
+    try:
+        from requests.packages.urllib3.util import timeout
+    except ImportError:
+        from urllib3.util import timeout
+
+if requests.__build__ < 0x021000:
+    gaecontrib = None
+else:
+    try:
+        from requests.packages.urllib3.contrib import appengine as gaecontrib
+    except ImportError:
+        from urllib3.contrib import appengine as gaecontrib
+
+if requests.__build__ < 0x021200:
+    PyOpenSSLContext = None
+else:
+    try:
+        from requests.packages.urllib3.contrib.pyopenssl \
+                import PyOpenSSLContext
+    except ImportError:
+        try:
+            from urllib3.contrib.pyopenssl import PyOpenSSLContext
+        except ImportError:
+            PyOpenSSLContext = None
+
+PY3 = sys.version_info > (3, 0)
+
+if PY3:
+    from collections.abc import Mapping, MutableMapping
+    import queue
+    from urllib.parse import urlencode, urljoin
+else:
+    from collections import Mapping, MutableMapping
+    import Queue as queue
+    from urllib import urlencode
+    from urlparse import urljoin
+
+try:
+    basestring = basestring
+except NameError:
+    basestring = (str, bytes)
+
+
+class HTTPHeaderDict(MutableMapping):
+    """
+    :param headers:
+        An iterable of field-value pairs. Must not contain multiple field names
+        when compared case-insensitively.
+
+    :param kwargs:
+        Additional field-value pairs to pass in to ``dict.update``.
+
+    A ``dict`` like container for storing HTTP Headers.
+
+    Field names are stored and compared case-insensitively in compliance with
+    RFC 7230. Iteration provides the first case-sensitive key seen for each
+    case-insensitive pair.
+
+    Using ``__setitem__`` syntax overwrites fields that compare equal
+    case-insensitively in order to maintain ``dict``'s api. For fields that
+    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
+    in a loop.
+
+    If multiple fields that are equal case-insensitively are passed to the
+    constructor or ``.update``, the behavior is undefined and some will be
+    lost.
+
+    >>> headers = HTTPHeaderDict()
+    >>> headers.add('Set-Cookie', 'foo=bar')
+    >>> headers.add('set-cookie', 'baz=quxx')
+    >>> headers['content-length'] = '7'
+    >>> headers['SET-cookie']
+    'foo=bar, baz=quxx'
+    >>> headers['Content-Length']
+    '7'
+    """
+
+    def __init__(self, headers=None, **kwargs):
+        super(HTTPHeaderDict, self).__init__()
+        self._container = {}
+        if headers is not None:
+            if isinstance(headers, HTTPHeaderDict):
+                self._copy_from(headers)
+            else:
+                self.extend(headers)
+        if kwargs:
+            self.extend(kwargs)
+
+    def __setitem__(self, key, val):
+        self._container[key.lower()] = (key, val)
+        return self._container[key.lower()]
+
+    def __getitem__(self, key):
+        val = self._container[key.lower()]
+        return ', '.join(val[1:])
+
+    def __delitem__(self, key):
+        del self._container[key.lower()]
+
+    def __contains__(self, key):
+        return key.lower() in self._container
+
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, 'keys'):
+            return False
+        if not isinstance(other, type(self)):
+            other = type(self)(other)
+        return (dict((k.lower(), v) for k, v in self.itermerged()) ==
+                dict((k.lower(), v) for k, v in other.itermerged()))
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    if not PY3:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
+        return len(self._container)
+
+    def __iter__(self):
+        # Only provide the originally cased names
+        for vals in self._container.values():
+            yield vals[0]
+
+    def pop(self, key, default=__marker):
+        """D.pop(k[,d]) -> v, remove specified key and return its value.
+
+        If key is not found, d is returned if given, otherwise KeyError is
+        raised.
+        """
+        # Using the MutableMapping function directly fails due to the private
+        # marker.
+        # Using ordinary dict.pop would expose the internal structures.
+        # So let's reinvent the wheel.
+        try:
+            value = self[key]
+        except KeyError:
+            if default is self.__marker:
+                raise
+            return default
+        else:
+            del self[key]
+            return value
+
+    def discard(self, key):
+        try:
+            del self[key]
+        except KeyError:
+            pass
+
+    def add(self, key, val):
+        """Adds a (name, value) pair, doesn't overwrite the value if it already
+        exists.
+
+        >>> headers = HTTPHeaderDict(foo='bar')
+        >>> headers.add('Foo', 'baz')
+        >>> headers['foo']
+        'bar, baz'
+        """
+        key_lower = key.lower()
+        new_vals = key, val
+        # Keep the common case aka no item present as fast as possible
+        vals = self._container.setdefault(key_lower, new_vals)
+        if new_vals is not vals:
+            # new_vals was not inserted, as there was a previous one
+            if isinstance(vals, list):
+                # If already several items got inserted, we have a list
+                vals.append(val)
+            else:
+                # vals should be a tuple then, i.e. only one item so far
+                # Need to convert the tuple to list for further extension
+                self._container[key_lower] = [vals[0], vals[1], val]
+
+    def extend(self, *args, **kwargs):
+        """Generic import function for any type of header-like object.
+        Adapted version of MutableMapping.update in order to insert items
+        with self.add instead of self.__setitem__
+        """
+        if len(args) > 1:
+            raise TypeError("extend() takes at most 1 positional "
+                            "arguments ({} given)".format(len(args)))
+        other = args[0] if len(args) >= 1 else ()
+
+        if isinstance(other, HTTPHeaderDict):
+            for key, val in other.iteritems():
+                self.add(key, val)
+        elif isinstance(other, Mapping):
+            for key in other:
+                self.add(key, other[key])
+        elif hasattr(other, "keys"):
+            for key in other.keys():
+                self.add(key, other[key])
+        else:
+            for key, value in other:
+                self.add(key, value)
+
+        for key, value in kwargs.items():
+            self.add(key, value)
+
+    def getlist(self, key):
+        """Returns a list of all the values for the named field. Returns an
+        empty list if the key doesn't exist."""
+        try:
+            vals = self._container[key.lower()]
+        except KeyError:
+            return []
+        else:
+            if isinstance(vals, tuple):
+                return [vals[1]]
+            else:
+                return vals[1:]
+
+    # Backwards compatibility for httplib
+    getheaders = getlist
+    getallmatchingheaders = getlist
+    iget = getlist
+
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+
+    def _copy_from(self, other):
+        for key in other:
+            val = other.getlist(key)
+            if isinstance(val, list):
+                # Don't need to convert tuples
+                val = list(val)
+            self._container[key.lower()] = [key] + val
+
+    def copy(self):
+        clone = type(self)()
+        clone._copy_from(self)
+        return clone
+
+    def iteritems(self):
+        """Iterate over all header lines, including duplicate ones."""
+        for key in self:
+            vals = self._container[key.lower()]
+            for val in vals[1:]:
+                yield vals[0], val
+
+    def itermerged(self):
+        """Iterate over all headers, merging duplicate ones together."""
+        for key in self:
+            val = self._container[key.lower()]
+            yield val[0], ', '.join(val[1:])
+
+    def items(self):
+        return list(self.iteritems())
+
+    @classmethod
+    def from_httplib(cls, message):  # Python 2
+        """Read headers from a Python 2 httplib message object."""
+        # python2.7 does not expose a proper API for exporting multiheaders
+        # efficiently. This function re-reads raw lines from the message
+        # object and extracts the multiheaders properly.
+        headers = []
+
+        for line in message.headers:
+            if line.startswith((' ', '\t')):
+                key, value = headers[-1]
+                headers[-1] = (key, value + '\r\n' + line.rstrip())
+                continue
+
+            key, value = line.split(':', 1)
+            headers.append((key, value.strip()))
+
+        return cls(headers)
+
+
+__all__ = (
+    'basestring',
+    'connection',
+    'fields',
+    'filepost',
+    'poolmanager',
+    'timeout',
+    'HTTPHeaderDict',
+    'queue',
+    'urlencode',
+    'gaecontrib',
+    'urljoin',
+    'PyOpenSSLContext',
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ddfe4fe2496a573c51ab28441b79717089f49050
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/__init__.py
@@ -0,0 +1,15 @@
+# -*- coding: utf-8 -*-
+"""
+requests-toolbelt.adapters
+==========================
+
+See http://toolbelt.rtfd.org/ for documentation
+
+:copyright: (c) 2014 by Ian Cordasco and Cory Benfield
+:license: Apache v2.0, see LICENSE for more details
+"""
+
+from .ssl import SSLAdapter
+from .source import SourceAddressAdapter
+
+__all__ = ['SSLAdapter', 'SourceAddressAdapter']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/appengine.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/appengine.py
new file mode 100644
index 0000000000000000000000000000000000000000..2af2bbbdbad31817687b8646ef4dcfe7c0d1108f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/appengine.py
@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+"""The App Engine Transport Adapter for requests.
+
+.. versionadded:: 0.6.0
+
+This requires a version of requests >= 2.10.0 and Python 2.
+
+There are two ways to use this library:
+
+#. If you're using requests directly, you can use code like:
+
+   .. code-block:: python
+
+       >>> import requests
+       >>> import ssl
+       >>> import requests.packages.urllib3.contrib.appengine as ul_appengine
+       >>> from requests_toolbelt.adapters import appengine
+       >>> s = requests.Session()
+       >>> if ul_appengine.is_appengine_sandbox():
+       ...    s.mount('http://', appengine.AppEngineAdapter())
+       ...    s.mount('https://', appengine.AppEngineAdapter())
+
+#. If you depend on external libraries which use requests, you can use code
+   like:
+
+   .. code-block:: python
+
+       >>> from requests_toolbelt.adapters import appengine
+       >>> appengine.monkeypatch()
+
+which will ensure all requests.Session objects use AppEngineAdapter properly.
+
+You are also able to :ref:`disable certificate validation <insecure_appengine>`
+when monkey-patching.
+"""
+import requests
+import warnings
+from requests import adapters
+from requests import sessions
+
+from .. import exceptions as exc
+from .._compat import gaecontrib
+from .._compat import timeout
+
+
+class AppEngineMROHack(adapters.HTTPAdapter):
+    """Resolves infinite recursion when monkeypatching.
+
+    This works by injecting itself as the base class of both the
+    :class:`AppEngineAdapter` and Requests' default HTTPAdapter, which needs to
+    be done because default HTTPAdapter's MRO is recompiled when we
+    monkeypatch, at which point this class becomes HTTPAdapter's base class.
+    In addition, we use an instantiation flag to avoid infinite recursion.
+    """
+    _initialized = False
+
+    def __init__(self, *args, **kwargs):
+        if not self._initialized:
+            self._initialized = True
+            super(AppEngineMROHack, self).__init__(*args, **kwargs)
+
+
+class AppEngineAdapter(AppEngineMROHack, adapters.HTTPAdapter):
+    """The transport adapter for Requests to use urllib3's GAE support.
+
+    Implements Requests's HTTPAdapter API.
+
+    When deploying to Google's App Engine service, some of Requests'
+    functionality is broken. There is underlying support for GAE in urllib3.
+    This functionality, however, is opt-in and needs to be enabled explicitly
+    for Requests to be able to use it.
+    """
+
+    __attrs__ = adapters.HTTPAdapter.__attrs__ + ['_validate_certificate']
+
+    def __init__(self, validate_certificate=True, *args, **kwargs):
+        _check_version()
+        self._validate_certificate = validate_certificate
+        super(AppEngineAdapter, self).__init__(*args, **kwargs)
+
+    def init_poolmanager(self, connections, maxsize, block=False):
+        self.poolmanager = _AppEnginePoolManager(self._validate_certificate)
+
+
+class InsecureAppEngineAdapter(AppEngineAdapter):
+    """An always-insecure GAE adapter for Requests.
+
+    This is a variant of the the transport adapter for Requests to use
+    urllib3's GAE support that does not validate certificates. Use with
+    caution!
+
+    .. note::
+        The ``validate_certificate`` keyword argument will not be honored here
+        and is not part of the signature because we always force it to
+        ``False``.
+
+    See :class:`AppEngineAdapter` for further details.
+    """
+
+    def __init__(self, *args, **kwargs):
+        if kwargs.pop("validate_certificate", False):
+            warnings.warn("Certificate validation cannot be specified on the "
+                          "InsecureAppEngineAdapter, but was present. This "
+                          "will be ignored and certificate validation will "
+                          "remain off.", exc.IgnoringGAECertificateValidation)
+
+        super(InsecureAppEngineAdapter, self).__init__(
+            validate_certificate=False, *args, **kwargs)
+
+
+class _AppEnginePoolManager(object):
+    """Implements urllib3's PoolManager API expected by requests.
+
+    While a real PoolManager map hostnames to reusable Connections,
+    AppEngine has no concept of a reusable connection to a host.
+    So instead, this class constructs a small Connection per request,
+    that is returned to the Adapter and used to access the URL.
+    """
+
+    def __init__(self, validate_certificate=True):
+        self.appengine_manager = gaecontrib.AppEngineManager(
+            validate_certificate=validate_certificate)
+
+    def connection_from_url(self, url):
+        return _AppEngineConnection(self.appengine_manager, url)
+
+    def clear(self):
+        pass
+
+
+class _AppEngineConnection(object):
+    """Implements urllib3's HTTPConnectionPool API's urlopen().
+
+    This Connection's urlopen() is called with a host-relative path,
+    so in order to properly support opening the URL, we need to store
+    the full URL when this Connection is constructed from the PoolManager.
+
+    This code wraps AppEngineManager.urlopen(), which exposes a different
+    API than in the original urllib3 urlopen(), and thus needs this adapter.
+    """
+
+    def __init__(self, appengine_manager, url):
+        self.appengine_manager = appengine_manager
+        self.url = url
+
+    def urlopen(self, method, url, body=None, headers=None, retries=None,
+                redirect=True, assert_same_host=True,
+                timeout=timeout.Timeout.DEFAULT_TIMEOUT,
+                pool_timeout=None, release_conn=None, **response_kw):
+        # This function's url argument is a host-relative URL,
+        # but the AppEngineManager expects an absolute URL.
+        # So we saved out the self.url when the AppEngineConnection
+        # was constructed, which we then can use down below instead.
+
+        # We once tried to verify our assumptions here, but sometimes the
+        # passed-in URL differs on url fragments, or "http://a.com" vs "/".
+
+        # urllib3's App Engine adapter only uses Timeout.total, not read or
+        # connect.
+        if not timeout.total:
+            timeout.total = timeout._read or timeout._connect
+
+        # Jump through the hoops necessary to call AppEngineManager's API.
+        return self.appengine_manager.urlopen(
+            method,
+            self.url,
+            body=body,
+            headers=headers,
+            retries=retries,
+            redirect=redirect,
+            timeout=timeout,
+            **response_kw)
+
+
+def monkeypatch(validate_certificate=True):
+    """Sets up all Sessions to use AppEngineAdapter by default.
+
+    If you don't want to deal with configuring your own Sessions,
+    or if you use libraries that use requests directly (ie requests.post),
+    then you may prefer to monkeypatch and auto-configure all Sessions.
+
+    .. warning: :
+
+        If ``validate_certificate`` is ``False``, certification validation will
+        effectively be disabled for all requests.
+    """
+    _check_version()
+    # HACK: We should consider modifying urllib3 to support this cleanly,
+    # so that we can set a module-level variable in the sessions module,
+    # instead of overriding an imported HTTPAdapter as is done here.
+    adapter = AppEngineAdapter
+    if not validate_certificate:
+        adapter = InsecureAppEngineAdapter
+
+    sessions.HTTPAdapter = adapter
+    adapters.HTTPAdapter = adapter
+
+
+def _check_version():
+    if gaecontrib is None:
+        raise exc.VersionMismatchError(
+            "The toolbelt requires at least Requests 2.10.0 to be "
+            "installed. Version {0} was found instead.".format(
+                requests.__version__
+            )
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/fingerprint.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/fingerprint.py
new file mode 100644
index 0000000000000000000000000000000000000000..6645d349816cf43055861f893f9f2e3d2f301e91
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/fingerprint.py
@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+"""Submodule containing the implementation for the FingerprintAdapter.
+
+This file contains an implementation of a Transport Adapter that validates
+the fingerprints of SSL certificates presented upon connection.
+"""
+from requests.adapters import HTTPAdapter
+
+from .._compat import poolmanager
+
+
+class FingerprintAdapter(HTTPAdapter):
+    """
+    A HTTPS Adapter for Python Requests that verifies certificate fingerprints,
+    instead of certificate hostnames.
+
+    Example usage:
+
+    .. code-block:: python
+
+        import requests
+        import ssl
+        from requests_toolbelt.adapters.fingerprint import FingerprintAdapter
+
+        twitter_fingerprint = '...'
+        s = requests.Session()
+        s.mount(
+            'https://twitter.com',
+            FingerprintAdapter(twitter_fingerprint)
+        )
+
+    The fingerprint should be provided as a hexadecimal string, optionally
+    containing colons.
+    """
+
+    __attrs__ = HTTPAdapter.__attrs__ + ['fingerprint']
+
+    def __init__(self, fingerprint, **kwargs):
+        self.fingerprint = fingerprint
+
+        super(FingerprintAdapter, self).__init__(**kwargs)
+
+    def init_poolmanager(self, connections, maxsize, block=False):
+        self.poolmanager = poolmanager.PoolManager(
+            num_pools=connections,
+            maxsize=maxsize,
+            block=block,
+            assert_fingerprint=self.fingerprint)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/host_header_ssl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/host_header_ssl.py
new file mode 100644
index 0000000000000000000000000000000000000000..f34ed1aa134fb3f1fece5cbb721e95d10c7628d3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/host_header_ssl.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+"""
+requests_toolbelt.adapters.host_header_ssl
+==========================================
+
+This file contains an implementation of the HostHeaderSSLAdapter.
+"""
+
+from requests.adapters import HTTPAdapter
+
+
+class HostHeaderSSLAdapter(HTTPAdapter):
+    """
+    A HTTPS Adapter for Python Requests that sets the hostname for certificate
+    verification based on the Host header.
+
+    This allows requesting the IP address directly via HTTPS without getting
+    a "hostname doesn't match" exception.
+
+    Example usage:
+
+        >>> s.mount('https://', HostHeaderSSLAdapter())
+        >>> s.get("https://93.184.216.34", headers={"Host": "example.org"})
+
+    """
+
+    def send(self, request, **kwargs):
+        # HTTP headers are case-insensitive (RFC 7230)
+        host_header = None
+        for header in request.headers:
+            if header.lower() == "host":
+                host_header = request.headers[header]
+                break
+
+        connection_pool_kwargs = self.poolmanager.connection_pool_kw
+
+        if host_header:
+            connection_pool_kwargs["assert_hostname"] = host_header
+        elif "assert_hostname" in connection_pool_kwargs:
+            # an assert_hostname from a previous request may have been left
+            connection_pool_kwargs.pop("assert_hostname", None)
+
+        return super(HostHeaderSSLAdapter, self).send(request, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/socket_options.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/socket_options.py
new file mode 100644
index 0000000000000000000000000000000000000000..f8aef5dd5e99db598248df22223ce7ee67ab0824
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/socket_options.py
@@ -0,0 +1,129 @@
+# -*- coding: utf-8 -*-
+"""The implementation of the SocketOptionsAdapter."""
+import socket
+import warnings
+import sys
+
+import requests
+from requests import adapters
+
+from .._compat import connection
+from .._compat import poolmanager
+from .. import exceptions as exc
+
+
+class SocketOptionsAdapter(adapters.HTTPAdapter):
+    """An adapter for requests that allows users to specify socket options.
+
+    Since version 2.4.0 of requests, it is possible to specify a custom list
+    of socket options that need to be set before establishing the connection.
+
+    Example usage::
+
+        >>> import socket
+        >>> import requests
+        >>> from requests_toolbelt.adapters import socket_options
+        >>> s = requests.Session()
+        >>> opts = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 0)]
+        >>> adapter = socket_options.SocketOptionsAdapter(socket_options=opts)
+        >>> s.mount('http://', adapter)
+
+    You can also take advantage of the list of default options on this class
+    to keep using the original options in addition to your custom options. In
+    that case, ``opts`` might look like::
+
+        >>> opts = socket_options.SocketOptionsAdapter.default_options + opts
+
+    """
+
+    if connection is not None:
+        default_options = getattr(
+            connection.HTTPConnection,
+            'default_socket_options',
+            [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+        )
+    else:
+        default_options = []
+        warnings.warn(exc.RequestsVersionTooOld,
+                      "This version of Requests is only compatible with a "
+                      "version of urllib3 which is too old to support "
+                      "setting options on a socket. This adapter is "
+                      "functionally useless.")
+
+    def __init__(self, **kwargs):
+        self.socket_options = kwargs.pop('socket_options',
+                                         self.default_options)
+
+        super(SocketOptionsAdapter, self).__init__(**kwargs)
+
+    def init_poolmanager(self, connections, maxsize, block=False):
+        if requests.__build__ >= 0x020400:
+            # NOTE(Ian): Perhaps we should raise a warning
+            self.poolmanager = poolmanager.PoolManager(
+                num_pools=connections,
+                maxsize=maxsize,
+                block=block,
+                socket_options=self.socket_options
+            )
+        else:
+            super(SocketOptionsAdapter, self).init_poolmanager(
+                connections, maxsize, block
+            )
+
+
+class TCPKeepAliveAdapter(SocketOptionsAdapter):
+    """An adapter for requests that turns on TCP Keep-Alive by default.
+
+    The adapter sets 4 socket options:
+
+    - ``SOL_SOCKET`` ``SO_KEEPALIVE`` - This turns on TCP Keep-Alive
+    - ``IPPROTO_TCP`` ``TCP_KEEPINTVL`` 20 - Sets the keep alive interval
+    - ``IPPROTO_TCP`` ``TCP_KEEPCNT`` 5 - Sets the number of keep alive probes
+    - ``IPPROTO_TCP`` ``TCP_KEEPIDLE`` 60 - Sets the keep alive time if the
+      socket library has the ``TCP_KEEPIDLE`` constant
+
+    The latter three can be overridden by keyword arguments (respectively):
+
+    - ``idle``
+    - ``interval``
+    - ``count``
+
+    You can use this adapter like so::
+
+       >>> from requests_toolbelt.adapters import socket_options
+       >>> tcp = socket_options.TCPKeepAliveAdapter(idle=120, interval=10)
+       >>> s = requests.Session()
+       >>> s.mount('http://', tcp)
+
+    """
+
+    def __init__(self, **kwargs):
+        socket_options = kwargs.pop('socket_options',
+                                    SocketOptionsAdapter.default_options)
+        idle = kwargs.pop('idle', 60)
+        interval = kwargs.pop('interval', 20)
+        count = kwargs.pop('count', 5)
+        socket_options = socket_options + [
+            (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1)
+        ]
+
+        # NOTE(Ian): OSX does not have these constants defined, so we
+        # set them conditionally.
+        if getattr(socket, 'TCP_KEEPINTVL', None) is not None:
+            socket_options += [(socket.IPPROTO_TCP, socket.TCP_KEEPINTVL,
+                                interval)]
+        elif sys.platform == 'darwin':
+            # On OSX, TCP_KEEPALIVE from netinet/tcp.h is not exported
+            # by python's socket module
+            TCP_KEEPALIVE = getattr(socket, 'TCP_KEEPALIVE', 0x10)
+            socket_options += [(socket.IPPROTO_TCP, TCP_KEEPALIVE, interval)]
+
+        if getattr(socket, 'TCP_KEEPCNT', None) is not None:
+            socket_options += [(socket.IPPROTO_TCP, socket.TCP_KEEPCNT, count)]
+
+        if getattr(socket, 'TCP_KEEPIDLE', None) is not None:
+            socket_options += [(socket.IPPROTO_TCP, socket.TCP_KEEPIDLE, idle)]
+
+        super(TCPKeepAliveAdapter, self).__init__(
+            socket_options=socket_options, **kwargs
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/source.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/source.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3dda797acc29c7024f07d1e6dd7c3e688607573
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/source.py
@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+"""
+requests_toolbelt.source_adapter
+================================
+
+This file contains an implementation of the SourceAddressAdapter originally
+demonstrated on the Requests GitHub page.
+"""
+from requests.adapters import HTTPAdapter
+
+from .._compat import poolmanager, basestring
+
+
+class SourceAddressAdapter(HTTPAdapter):
+    """
+    A Source Address Adapter for Python Requests that enables you to choose the
+    local address to bind to. This allows you to send your HTTP requests from a
+    specific interface and IP address.
+
+    Two address formats are accepted. The first is a string: this will set the
+    local IP address to the address given in the string, and will also choose a
+    semi-random high port for the local port number.
+
+    The second is a two-tuple of the form (ip address, port): for example,
+    ``('10.10.10.10', 8999)``. This will set the local IP address to the first
+    element, and the local port to the second element. If ``0`` is used as the
+    port number, a semi-random high port will be selected.
+
+    .. warning:: Setting an explicit local port can have negative interactions
+                 with connection-pooling in Requests: in particular, it risks
+                 the possibility of getting "Address in use" errors. The
+                 string-only argument is generally preferred to the tuple-form.
+
+    Example usage:
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.adapters.source import SourceAddressAdapter
+
+        s = requests.Session()
+        s.mount('http://', SourceAddressAdapter('10.10.10.10'))
+        s.mount('https://', SourceAddressAdapter(('10.10.10.10', 8999)))
+    """
+    def __init__(self, source_address, **kwargs):
+        if isinstance(source_address, basestring):
+            self.source_address = (source_address, 0)
+        elif isinstance(source_address, tuple):
+            self.source_address = source_address
+        else:
+            raise TypeError(
+                "source_address must be IP address string or (ip, port) tuple"
+            )
+
+        super(SourceAddressAdapter, self).__init__(**kwargs)
+
+    def init_poolmanager(self, connections, maxsize, block=False):
+        self.poolmanager = poolmanager.PoolManager(
+            num_pools=connections,
+            maxsize=maxsize,
+            block=block,
+            source_address=self.source_address)
+
+    def proxy_manager_for(self, *args, **kwargs):
+        kwargs['source_address'] = self.source_address
+        return super(SourceAddressAdapter, self).proxy_manager_for(
+            *args, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/ssl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/ssl.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4a76ae4553984e2b2983a89258704c9e8fd238c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/ssl.py
@@ -0,0 +1,66 @@
+# -*- coding: utf-8 -*-
+"""
+
+requests_toolbelt.ssl_adapter
+=============================
+
+This file contains an implementation of the SSLAdapter originally demonstrated
+in this blog post:
+https://lukasa.co.uk/2013/01/Choosing_SSL_Version_In_Requests/
+
+"""
+import requests
+
+from requests.adapters import HTTPAdapter
+
+from .._compat import poolmanager
+
+
+class SSLAdapter(HTTPAdapter):
+    """
+    A HTTPS Adapter for Python Requests that allows the choice of the SSL/TLS
+    version negotiated by Requests. This can be used either to enforce the
+    choice of high-security TLS versions (where supported), or to work around
+    misbehaving servers that fail to correctly negotiate the default TLS
+    version being offered.
+
+    Example usage:
+
+        >>> import requests
+        >>> import ssl
+        >>> from requests_toolbelt import SSLAdapter
+        >>> s = requests.Session()
+        >>> s.mount('https://', SSLAdapter(ssl.PROTOCOL_TLSv1))
+
+    You can replace the chosen protocol with any that are available in the
+    default Python SSL module. All subsequent requests that match the adapter
+    prefix will use the chosen SSL version instead of the default.
+
+    This adapter will also attempt to change the SSL/TLS version negotiated by
+    Requests when using a proxy. However, this may not always be possible:
+    prior to Requests v2.4.0 the adapter did not have access to the proxy setup
+    code. In earlier versions of Requests, this adapter will not function
+    properly when used with proxies.
+    """
+
+    __attrs__ = HTTPAdapter.__attrs__ + ['ssl_version']
+
+    def __init__(self, ssl_version=None, **kwargs):
+        self.ssl_version = ssl_version
+
+        super(SSLAdapter, self).__init__(**kwargs)
+
+    def init_poolmanager(self, connections, maxsize, block=False):
+        self.poolmanager = poolmanager.PoolManager(
+            num_pools=connections,
+            maxsize=maxsize,
+            block=block,
+            ssl_version=self.ssl_version)
+
+    if requests.__build__ >= 0x020400:
+        # Earlier versions of requests either don't have this method or, worse,
+        # don't allow passing arbitrary keyword arguments. As a result, only
+        # conditionally define this method.
+        def proxy_manager_for(self, *args, **kwargs):
+            kwargs['ssl_version'] = self.ssl_version
+            return super(SSLAdapter, self).proxy_manager_for(*args, **kwargs)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/x509.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/x509.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc9d5dc064c3dda888988c6442ad3ba34982badf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/adapters/x509.py
@@ -0,0 +1,178 @@
+# -*- coding: utf-8 -*-
+"""A X509Adapter for use with the requests library.
+
+This file contains an implementation of the X509Adapter that will
+allow users to authenticate a request using an arbitrary
+X.509 certificate without needing to convert it to a .pem file
+
+"""
+
+from OpenSSL.crypto import PKey, X509
+from cryptography import x509
+from cryptography.hazmat.primitives.serialization import (load_pem_private_key,
+                                                          load_der_private_key)
+from cryptography.hazmat.primitives.serialization import Encoding
+from cryptography.hazmat.backends import default_backend
+
+from datetime import datetime
+from requests.adapters import HTTPAdapter
+import requests
+
+from .._compat import PyOpenSSLContext
+from .. import exceptions as exc
+
+"""
+importing the protocol constants from _ssl instead of ssl because only the
+constants are needed and to handle issues caused by importing from ssl on
+the 2.7.x line.
+"""
+try:
+    from _ssl import PROTOCOL_TLS as PROTOCOL
+except ImportError:
+    from _ssl import PROTOCOL_SSLv23 as PROTOCOL
+
+
+class X509Adapter(HTTPAdapter):
+    r"""Adapter for use with X.509 certificates.
+
+    Provides an interface for Requests sessions to contact HTTPS urls and
+    authenticate  with an X.509 cert by implementing the Transport Adapter
+    interface. This class will need to be manually instantiated and mounted
+    to the session
+
+    :param pool_connections: The number of urllib3 connection pools to
+           cache.
+    :param pool_maxsize: The maximum number of connections to save in the
+            pool.
+    :param max_retries: The maximum number of retries each connection
+        should attempt. Note, this applies only to failed DNS lookups,
+        socket connections and connection timeouts, never to requests where
+        data has made it to the server. By default, Requests does not retry
+        failed connections. If you need granular control over the
+        conditions under which we retry a request, import urllib3's
+        ``Retry`` class and pass that instead.
+    :param pool_block: Whether the connection pool should block for
+            connections.
+
+    :param bytes cert_bytes:
+        bytes object containing contents of a cryptography.x509Certificate
+        object using the encoding specified by the ``encoding`` parameter.
+    :param bytes pk_bytes:
+        bytes object containing contents of a object that implements
+        ``cryptography.hazmat.primitives.serialization.PrivateFormat``
+        using the encoding specified by the ``encoding`` parameter.
+    :param password:
+        string or utf8 encoded bytes containing the passphrase used for the
+        private key. None if unencrypted. Defaults to None.
+    :param encoding:
+        Enumeration detailing the encoding method used on the ``cert_bytes``
+        parameter. Can be either PEM or DER. Defaults to PEM.
+    :type encoding:
+        :class: `cryptography.hazmat.primitives.serialization.Encoding`
+
+    Usage::
+
+      >>> import requests
+      >>> from requests_toolbelt.adapters.x509 import X509Adapter
+      >>> s = requests.Session()
+      >>> a = X509Adapter(max_retries=3,
+                cert_bytes=b'...', pk_bytes=b'...', encoding='...'
+      >>> s.mount('https://', a)
+    """
+
+    def __init__(self, *args, **kwargs):
+        self._check_version()
+        cert_bytes = kwargs.pop('cert_bytes', None)
+        pk_bytes = kwargs.pop('pk_bytes', None)
+        password = kwargs.pop('password', None)
+        encoding = kwargs.pop('encoding', Encoding.PEM)
+
+        password_bytes = None
+
+        if cert_bytes is None or not isinstance(cert_bytes, bytes):
+            raise ValueError('Invalid cert content provided. '
+                             'You must provide an X.509 cert '
+                             'formatted as a byte array.')
+        if pk_bytes is None or not isinstance(pk_bytes, bytes):
+            raise ValueError('Invalid private key content provided. '
+                             'You must provide a private key '
+                             'formatted as a byte array.')
+
+        if isinstance(password, bytes):
+            password_bytes = password
+        elif password:
+            password_bytes = password.encode('utf8')
+
+        self.ssl_context = create_ssl_context(cert_bytes, pk_bytes,
+                                              password_bytes, encoding)
+
+        super(X509Adapter, self).__init__(*args, **kwargs)
+
+    def init_poolmanager(self, *args, **kwargs):
+        if self.ssl_context:
+            kwargs['ssl_context'] = self.ssl_context
+        return super(X509Adapter, self).init_poolmanager(*args, **kwargs)
+
+    def proxy_manager_for(self, *args, **kwargs):
+        if self.ssl_context:
+            kwargs['ssl_context'] = self.ssl_context
+        return super(X509Adapter, self).proxy_manager_for(*args, **kwargs)
+
+    def _check_version(self):
+        if PyOpenSSLContext is None:
+            raise exc.VersionMismatchError(
+                "The X509Adapter requires at least Requests 2.12.0 to be "
+                "installed. Version {0} was found instead.".format(
+                    requests.__version__
+                )
+            )
+
+
+def check_cert_dates(cert):
+    """Verify that the supplied client cert is not invalid."""
+
+    now = datetime.utcnow()
+    if cert.not_valid_after < now or cert.not_valid_before > now:
+        raise ValueError('Client certificate expired: Not After: '
+                         '{0:%Y-%m-%d %H:%M:%SZ} '
+                         'Not Before: {1:%Y-%m-%d %H:%M:%SZ}'
+                         .format(cert.not_valid_after, cert.not_valid_before))
+
+
+def create_ssl_context(cert_byes, pk_bytes, password=None,
+                       encoding=Encoding.PEM):
+    """Create an SSL Context with the supplied cert/password.
+
+    :param cert_bytes array of bytes containing the cert encoded
+           using the method supplied in the ``encoding`` parameter
+    :param pk_bytes array of bytes containing the private key encoded
+           using the method supplied in the ``encoding`` parameter
+    :param password array of bytes containing the passphrase to be used
+           with the supplied private key. None if unencrypted.
+           Defaults to None.
+    :param encoding ``cryptography.hazmat.primitives.serialization.Encoding``
+            details the encoding method used on the ``cert_bytes``  and
+            ``pk_bytes`` parameters. Can be either PEM or DER.
+            Defaults to PEM.
+    """
+    backend = default_backend()
+
+    cert = None
+    key = None
+    if encoding == Encoding.PEM:
+        cert = x509.load_pem_x509_certificate(cert_byes, backend)
+        key = load_pem_private_key(pk_bytes, password, backend)
+    elif encoding == Encoding.DER:
+        cert = x509.load_der_x509_certificate(cert_byes, backend)
+        key = load_der_private_key(pk_bytes, password, backend)
+    else:
+        raise ValueError('Invalid encoding provided: Must be PEM or DER')
+
+    if not (cert and key):
+        raise ValueError('Cert and key could not be parsed from '
+                         'provided data')
+    check_cert_dates(cert)
+    ssl_context = PyOpenSSLContext(PROTOCOL)
+    ssl_context._ctx.use_certificate(X509.from_cryptography(cert))
+    ssl_context._ctx.use_privatekey(PKey.from_cryptography_key(key))
+    return ssl_context
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/_digest_auth_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/_digest_auth_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..285a6a76309a2e1775afe13d7184491f80384b99
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/_digest_auth_compat.py
@@ -0,0 +1,29 @@
+"""Provide a compatibility layer for requests.auth.HTTPDigestAuth."""
+import requests
+
+
+class _ThreadingDescriptor(object):
+    def __init__(self, prop, default):
+        self.prop = prop
+        self.default = default
+
+    def __get__(self, obj, objtype=None):
+        return getattr(obj._thread_local, self.prop, self.default)
+
+    def __set__(self, obj, value):
+        setattr(obj._thread_local, self.prop, value)
+
+
+class _HTTPDigestAuth(requests.auth.HTTPDigestAuth):
+    init = _ThreadingDescriptor('init', True)
+    last_nonce = _ThreadingDescriptor('last_nonce', '')
+    nonce_count = _ThreadingDescriptor('nonce_count', 0)
+    chal = _ThreadingDescriptor('chal', {})
+    pos = _ThreadingDescriptor('pos', None)
+    num_401_calls = _ThreadingDescriptor('num_401_calls', 1)
+
+
+if requests.__build__ < 0x020800:
+    HTTPDigestAuth = requests.auth.HTTPDigestAuth
+else:
+    HTTPDigestAuth = _HTTPDigestAuth
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/guess.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/guess.py
new file mode 100644
index 0000000000000000000000000000000000000000..ba6de504a85a575b12a24245aec15321c967f7fd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/guess.py
@@ -0,0 +1,146 @@
+# -*- coding: utf-8 -*-
+"""The module containing the code for GuessAuth."""
+from requests import auth
+from requests import cookies
+
+from . import _digest_auth_compat as auth_compat, http_proxy_digest
+
+
+class GuessAuth(auth.AuthBase):
+    """Guesses the auth type by the WWW-Authentication header."""
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+        self.auth = None
+        self.pos = None
+
+    def _handle_basic_auth_401(self, r, kwargs):
+        if self.pos is not None:
+            r.request.body.seek(self.pos)
+
+        # Consume content and release the original connection
+        # to allow our new request to reuse the same one.
+        r.content
+        r.raw.release_conn()
+        prep = r.request.copy()
+        if not hasattr(prep, '_cookies'):
+            prep._cookies = cookies.RequestsCookieJar()
+        cookies.extract_cookies_to_jar(prep._cookies, r.request, r.raw)
+        prep.prepare_cookies(prep._cookies)
+
+        self.auth = auth.HTTPBasicAuth(self.username, self.password)
+        prep = self.auth(prep)
+        _r = r.connection.send(prep, **kwargs)
+        _r.history.append(r)
+        _r.request = prep
+
+        return _r
+
+    def _handle_digest_auth_401(self, r, kwargs):
+        self.auth = auth_compat.HTTPDigestAuth(self.username, self.password)
+        try:
+            self.auth.init_per_thread_state()
+        except AttributeError:
+            # If we're not on requests 2.8.0+ this method does not exist and
+            # is not relevant.
+            pass
+
+        # Check that the attr exists because much older versions of requests
+        # set this attribute lazily. For example:
+        # https://github.com/kennethreitz/requests/blob/33735480f77891754304e7f13e3cdf83aaaa76aa/requests/auth.py#L59
+        if (hasattr(self.auth, 'num_401_calls') and
+                self.auth.num_401_calls is None):
+            self.auth.num_401_calls = 1
+        # Digest auth would resend the request by itself. We can take a
+        # shortcut here.
+        return self.auth.handle_401(r, **kwargs)
+
+    def handle_401(self, r, **kwargs):
+        """Resends a request with auth headers, if needed."""
+
+        www_authenticate = r.headers.get('www-authenticate', '').lower()
+
+        if 'basic' in www_authenticate:
+            return self._handle_basic_auth_401(r, kwargs)
+
+        if 'digest' in www_authenticate:
+            return self._handle_digest_auth_401(r, kwargs)
+
+    def __call__(self, request):
+        if self.auth is not None:
+            return self.auth(request)
+
+        try:
+            self.pos = request.body.tell()
+        except AttributeError:
+            pass
+
+        request.register_hook('response', self.handle_401)
+        return request
+
+
+class GuessProxyAuth(GuessAuth):
+    """
+    Guesses the auth type by WWW-Authentication and Proxy-Authentication
+    headers
+    """
+    def __init__(self, username=None, password=None,
+                 proxy_username=None, proxy_password=None):
+        super(GuessProxyAuth, self).__init__(username, password)
+        self.proxy_username = proxy_username
+        self.proxy_password = proxy_password
+        self.proxy_auth = None
+
+    def _handle_basic_auth_407(self, r, kwargs):
+        if self.pos is not None:
+            r.request.body.seek(self.pos)
+
+        r.content
+        r.raw.release_conn()
+        prep = r.request.copy()
+        if not hasattr(prep, '_cookies'):
+            prep._cookies = cookies.RequestsCookieJar()
+        cookies.extract_cookies_to_jar(prep._cookies, r.request, r.raw)
+        prep.prepare_cookies(prep._cookies)
+
+        self.proxy_auth = auth.HTTPProxyAuth(self.proxy_username,
+                                             self.proxy_password)
+        prep = self.proxy_auth(prep)
+        _r = r.connection.send(prep, **kwargs)
+        _r.history.append(r)
+        _r.request = prep
+
+        return _r
+
+    def _handle_digest_auth_407(self, r, kwargs):
+        self.proxy_auth = http_proxy_digest.HTTPProxyDigestAuth(
+            username=self.proxy_username,
+            password=self.proxy_password)
+
+        try:
+            self.auth.init_per_thread_state()
+        except AttributeError:
+            pass
+
+        return self.proxy_auth.handle_407(r, **kwargs)
+
+    def handle_407(self, r, **kwargs):
+        proxy_authenticate = r.headers.get('Proxy-Authenticate', '').lower()
+
+        if 'basic' in proxy_authenticate:
+            return self._handle_basic_auth_407(r, kwargs)
+
+        if 'digest' in proxy_authenticate:
+            return self._handle_digest_auth_407(r, kwargs)
+
+    def __call__(self, request):
+        if self.proxy_auth is not None:
+            request = self.proxy_auth(request)
+
+        try:
+            self.pos = request.body.tell()
+        except AttributeError:
+            pass
+
+        request.register_hook('response', self.handle_407)
+        return super(GuessProxyAuth, self).__call__(request)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/handler.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/handler.py
new file mode 100644
index 0000000000000000000000000000000000000000..7729c11b8979acb175278d045d82426c5f98a571
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/handler.py
@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+"""
+
+requests_toolbelt.auth.handler
+==============================
+
+This holds all of the implementation details of the Authentication Handler.
+
+"""
+
+from requests.auth import AuthBase, HTTPBasicAuth
+from requests.compat import urlparse, urlunparse
+
+
+class AuthHandler(AuthBase):
+
+    """
+
+    The ``AuthHandler`` object takes a dictionary of domains paired with
+    authentication strategies and will use this to determine which credentials
+    to use when making a request. For example, you could do the following:
+
+    .. code-block:: python
+
+        from requests import HTTPDigestAuth
+        from requests_toolbelt.auth.handler import AuthHandler
+
+        import requests
+
+        auth = AuthHandler({
+            'https://api.github.com': ('sigmavirus24', 'fakepassword'),
+            'https://example.com': HTTPDigestAuth('username', 'password')
+        })
+
+        r = requests.get('https://api.github.com/user', auth=auth)
+        # => <Response [200]>
+        r = requests.get('https://example.com/some/path', auth=auth)
+        # => <Response [200]>
+
+        s = requests.Session()
+        s.auth = auth
+        r = s.get('https://api.github.com/user')
+        # => <Response [200]>
+
+    .. warning::
+
+        :class:`requests.auth.HTTPDigestAuth` is not yet thread-safe. If you
+        use :class:`AuthHandler` across multiple threads you should
+        instantiate a new AuthHandler for each thread with a new
+        HTTPDigestAuth instance for each thread.
+
+    """
+
+    def __init__(self, strategies):
+        self.strategies = dict(strategies)
+        self._make_uniform()
+
+    def __call__(self, request):
+        auth = self.get_strategy_for(request.url)
+        return auth(request)
+
+    def __repr__(self):
+        return '<AuthHandler({0!r})>'.format(self.strategies)
+
+    def _make_uniform(self):
+        existing_strategies = list(self.strategies.items())
+        self.strategies = {}
+
+        for (k, v) in existing_strategies:
+            self.add_strategy(k, v)
+
+    @staticmethod
+    def _key_from_url(url):
+        parsed = urlparse(url)
+        return urlunparse((parsed.scheme.lower(),
+                           parsed.netloc.lower(),
+                           '', '', '', ''))
+
+    def add_strategy(self, domain, strategy):
+        """Add a new domain and authentication strategy.
+
+        :param str domain: The domain you wish to match against. For example:
+            ``'https://api.github.com'``
+        :param str strategy: The authentication strategy you wish to use for
+            that domain. For example: ``('username', 'password')`` or
+            ``requests.HTTPDigestAuth('username', 'password')``
+
+        .. code-block:: python
+
+            a = AuthHandler({})
+            a.add_strategy('https://api.github.com', ('username', 'password'))
+
+        """
+        # Turn tuples into Basic Authentication objects
+        if isinstance(strategy, tuple):
+            strategy = HTTPBasicAuth(*strategy)
+
+        key = self._key_from_url(domain)
+        self.strategies[key] = strategy
+
+    def get_strategy_for(self, url):
+        """Retrieve the authentication strategy for a specified URL.
+
+        :param str url: The full URL you will be making a request against. For
+            example, ``'https://api.github.com/user'``
+        :returns: Callable that adds authentication to a request.
+
+        .. code-block:: python
+
+            import requests
+            a = AuthHandler({'example.com', ('foo', 'bar')})
+            strategy = a.get_strategy_for('http://example.com/example')
+            assert isinstance(strategy, requests.auth.HTTPBasicAuth)
+
+        """
+        key = self._key_from_url(url)
+        return self.strategies.get(key, NullAuthStrategy())
+
+    def remove_strategy(self, domain):
+        """Remove the domain and strategy from the collection of strategies.
+
+        :param str domain: The domain you wish remove. For example,
+            ``'https://api.github.com'``.
+
+        .. code-block:: python
+
+            a = AuthHandler({'example.com', ('foo', 'bar')})
+            a.remove_strategy('example.com')
+            assert a.strategies == {}
+
+        """
+        key = self._key_from_url(domain)
+        if key in self.strategies:
+            del self.strategies[key]
+
+
+class NullAuthStrategy(AuthBase):
+    def __repr__(self):
+        return '<NullAuthStrategy>'
+
+    def __call__(self, r):
+        return r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/http_proxy_digest.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/http_proxy_digest.py
new file mode 100644
index 0000000000000000000000000000000000000000..d4143808fd95469e852a67fa50c3652201f4a696
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/auth/http_proxy_digest.py
@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+"""The module containing HTTPProxyDigestAuth."""
+import re
+
+from requests import cookies, utils
+
+from . import _digest_auth_compat as auth
+
+
+class HTTPProxyDigestAuth(auth.HTTPDigestAuth):
+    """HTTP digest authentication between proxy
+
+    :param stale_rejects: The number of rejects indicate that:
+        the client may wish to simply retry the request
+        with a new encrypted response, without reprompting the user for a
+        new username and password. i.e., retry build_digest_header
+    :type stale_rejects: int
+    """
+    _pat = re.compile(r'digest ', flags=re.IGNORECASE)
+
+    def __init__(self, *args, **kwargs):
+        super(HTTPProxyDigestAuth, self).__init__(*args, **kwargs)
+        self.stale_rejects = 0
+
+        self.init_per_thread_state()
+
+    @property
+    def stale_rejects(self):
+        thread_local = getattr(self, '_thread_local', None)
+        if thread_local is None:
+            return self._stale_rejects
+        return thread_local.stale_rejects
+
+    @stale_rejects.setter
+    def stale_rejects(self, value):
+        thread_local = getattr(self, '_thread_local', None)
+        if thread_local is None:
+            self._stale_rejects = value
+        else:
+            thread_local.stale_rejects = value
+
+    def init_per_thread_state(self):
+        try:
+            super(HTTPProxyDigestAuth, self).init_per_thread_state()
+        except AttributeError:
+            # If we're not on requests 2.8.0+ this method does not exist
+            pass
+
+    def handle_407(self, r, **kwargs):
+        """Handle HTTP 407 only once, otherwise give up
+
+        :param r: current response
+        :returns: responses, along with the new response
+        """
+        if r.status_code == 407 and self.stale_rejects < 2:
+            s_auth = r.headers.get("proxy-authenticate")
+            if s_auth is None:
+                raise IOError(
+                    "proxy server violated RFC 7235:"
+                    "407 response MUST contain header proxy-authenticate")
+            elif not self._pat.match(s_auth):
+                return r
+
+            self.chal = utils.parse_dict_header(
+                self._pat.sub('', s_auth, count=1))
+
+            # if we present the user/passwd and still get rejected
+            # http://tools.ietf.org/html/rfc2617#section-3.2.1
+            if ('Proxy-Authorization' in r.request.headers and
+                    'stale' in self.chal):
+                if self.chal['stale'].lower() == 'true':  # try again
+                    self.stale_rejects += 1
+                # wrong user/passwd
+                elif self.chal['stale'].lower() == 'false':
+                    raise IOError("User or password is invalid")
+
+            # Consume content and release the original connection
+            # to allow our new request to reuse the same one.
+            r.content
+            r.close()
+            prep = r.request.copy()
+            cookies.extract_cookies_to_jar(prep._cookies, r.request, r.raw)
+            prep.prepare_cookies(prep._cookies)
+
+            prep.headers['Proxy-Authorization'] = self.build_digest_header(
+                prep.method, prep.url)
+            _r = r.connection.send(prep, **kwargs)
+            _r.history.append(r)
+            _r.request = prep
+
+            return _r
+        else:  # give up authenticate
+            return r
+
+    def __call__(self, r):
+        self.init_per_thread_state()
+        # if we have nonce, then just use it, otherwise server will tell us
+        if self.last_nonce:
+            r.headers['Proxy-Authorization'] = self.build_digest_header(
+                r.method, r.url
+            )
+        r.register_hook('response', self.handle_407)
+        return r
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/cookies/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/cookies/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/cookies/forgetful.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/cookies/forgetful.py
new file mode 100644
index 0000000000000000000000000000000000000000..33203638470956e2eb42b3d518f2be6882ac2079
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/cookies/forgetful.py
@@ -0,0 +1,7 @@
+"""The module containing the code for ForgetfulCookieJar."""
+from requests.cookies import RequestsCookieJar
+
+
+class ForgetfulCookieJar(RequestsCookieJar):
+    def set_cookie(self, *args, **kwargs):
+        return
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/stream.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/stream.py
new file mode 100644
index 0000000000000000000000000000000000000000..eed60a72f2ae7965ef32b117a93d37027d2646cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/stream.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+"""Utilities for dealing with streamed requests."""
+import collections
+import os.path
+import re
+
+from .. import exceptions as exc
+
+# Regular expressions stolen from werkzeug/http.py
+# cd2c97bb0a076da2322f11adce0b2731f9193396 L62-L64
+_QUOTED_STRING_RE = r'"[^"\\]*(?:\\.[^"\\]*)*"'
+_OPTION_HEADER_PIECE_RE = re.compile(
+    r';\s*(%s|[^\s;=]+)\s*(?:=\s*(%s|[^;]+))?\s*' % (_QUOTED_STRING_RE,
+                                                     _QUOTED_STRING_RE)
+)
+_DEFAULT_CHUNKSIZE = 512
+
+
+def _get_filename(content_disposition):
+    for match in _OPTION_HEADER_PIECE_RE.finditer(content_disposition):
+        k, v = match.groups()
+        if k == 'filename':
+            # ignore any directory paths in the filename
+            return os.path.split(v)[1]
+    return None
+
+
+def get_download_file_path(response, path):
+    """
+    Given a response and a path, return a file path for a download.
+
+    If a ``path`` parameter is a directory, this function will parse the
+    ``Content-Disposition`` header on the response to determine the name of the
+    file as reported by the server, and return a file path in the specified
+    directory.
+
+    If ``path`` is empty or None, this function will return a path relative
+    to the process' current working directory.
+
+    If path is a full file path, return it.
+
+    :param response: A Response object from requests
+    :type response: requests.models.Response
+    :param str path: Directory or file path.
+    :returns: full file path to download as
+    :rtype: str
+    :raises: :class:`requests_toolbelt.exceptions.StreamingError`
+    """
+    path_is_dir = path and os.path.isdir(path)
+
+    if path and not path_is_dir:
+        # fully qualified file path
+        filepath = path
+    else:
+        response_filename = _get_filename(
+            response.headers.get('content-disposition', '')
+        )
+        if not response_filename:
+            raise exc.StreamingError('No filename given to stream response to')
+
+        if path_is_dir:
+            # directory to download to
+            filepath = os.path.join(path, response_filename)
+        else:
+            # fallback to downloading to current working directory
+            filepath = response_filename
+
+    return filepath
+
+
+def stream_response_to_file(response, path=None, chunksize=_DEFAULT_CHUNKSIZE):
+    """Stream a response body to the specified file.
+
+    Either use the ``path`` provided or use the name provided in the
+    ``Content-Disposition`` header.
+
+    .. warning::
+
+        If you pass this function an open file-like object as the ``path``
+        parameter, the function will not close that file for you.
+
+    .. warning::
+
+        This function will not automatically close the response object
+        passed in as the ``response`` parameter.
+
+    If a ``path`` parameter is a directory, this function will parse the
+    ``Content-Disposition`` header on the response to determine the name of the
+    file as reported by the server, and return a file path in the specified
+    directory. If no ``path`` parameter is supplied, this function will default
+    to the process' current working directory.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt import exceptions
+        from requests_toolbelt.downloadutils import stream
+
+        r = requests.get(url, stream=True)
+        try:
+            filename = stream.stream_response_to_file(r)
+        except exceptions.StreamingError as e:
+            # The toolbelt could not find the filename in the
+            # Content-Disposition
+            print(e.message)
+
+    You can also specify the filename as a string. This will be passed to
+    the built-in :func:`open` and we will read the content into the file.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.downloadutils import stream
+
+        r = requests.get(url, stream=True)
+        filename = stream.stream_response_to_file(r, path='myfile')
+
+    If the calculated download file path already exists, this function will
+    raise a StreamingError.
+
+    Instead, if you want to manage the file object yourself, you need to
+    provide either a :class:`io.BytesIO` object or a file opened with the
+    `'b'` flag. See the two examples below for more details.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.downloadutils import stream
+
+        with open('myfile', 'wb') as fd:
+            r = requests.get(url, stream=True)
+            filename = stream.stream_response_to_file(r, path=fd)
+
+        print('{0} saved to {1}'.format(url, filename))
+
+    .. code-block:: python
+
+        import io
+        import requests
+        from requests_toolbelt.downloadutils import stream
+
+        b = io.BytesIO()
+        r = requests.get(url, stream=True)
+        filename = stream.stream_response_to_file(r, path=b)
+        assert filename is None
+
+    :param response: A Response object from requests
+    :type response: requests.models.Response
+    :param path: *(optional)*, Either a string with the path to the location
+        to save the response content, or a file-like object expecting bytes.
+    :type path: :class:`str`, or object with a :meth:`write`
+    :param int chunksize: (optional), Size of chunk to attempt to stream
+        (default 512B).
+    :returns: The name of the file, if one can be determined, else None
+    :rtype: str
+    :raises: :class:`requests_toolbelt.exceptions.StreamingError`
+    """
+    pre_opened = False
+    fd = None
+    filename = None
+    if path and isinstance(getattr(path, 'write', None), collections.Callable):
+        pre_opened = True
+        fd = path
+        filename = getattr(fd, 'name', None)
+    else:
+        filename = get_download_file_path(response, path)
+        if os.path.exists(filename):
+            raise exc.StreamingError("File already exists: %s" % filename)
+        fd = open(filename, 'wb')
+
+    for chunk in response.iter_content(chunk_size=chunksize):
+        fd.write(chunk)
+
+    if not pre_opened:
+        fd.close()
+
+    return filename
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/tee.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/tee.py
new file mode 100644
index 0000000000000000000000000000000000000000..ecc7d0cddb99a4bf3664fb7b63b81afabbaff614
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/downloadutils/tee.py
@@ -0,0 +1,123 @@
+"""Tee function implementations."""
+import io
+
+_DEFAULT_CHUNKSIZE = 65536
+
+__all__ = ['tee', 'tee_to_file', 'tee_to_bytearray']
+
+
+def _tee(response, callback, chunksize, decode_content):
+    for chunk in response.raw.stream(amt=chunksize,
+                                     decode_content=decode_content):
+        callback(chunk)
+        yield chunk
+
+
+def tee(response, fileobject, chunksize=_DEFAULT_CHUNKSIZE,
+        decode_content=None):
+    """Stream the response both to the generator and a file.
+
+    This will stream the response body while writing the bytes to
+    ``fileobject``.
+
+    Example usage:
+
+    .. code-block:: python
+
+        resp = requests.get(url, stream=True)
+        with open('save_file', 'wb') as save_file:
+            for chunk in tee(resp, save_file):
+                # do stuff with chunk
+
+    .. code-block:: python
+
+        import io
+
+        resp = requests.get(url, stream=True)
+        fileobject = io.BytesIO()
+
+        for chunk in tee(resp, fileobject):
+            # do stuff with chunk
+
+    :param response: Response from requests.
+    :type response: requests.Response
+    :param fileobject: Writable file-like object.
+    :type fileobject: file, io.BytesIO
+    :param int chunksize: (optional), Size of chunk to attempt to stream.
+    :param bool decode_content: (optional), If True, this will decode the
+        compressed content of the response.
+    :raises: TypeError if the fileobject wasn't opened with the right mode
+        or isn't a BytesIO object.
+    """
+    # We will be streaming the raw bytes from over the wire, so we need to
+    # ensure that writing to the fileobject will preserve those bytes. On
+    # Python3, if the user passes an io.StringIO, this will fail, so we need
+    # to check for BytesIO instead.
+    if not ('b' in getattr(fileobject, 'mode', '') or
+            isinstance(fileobject, io.BytesIO)):
+        raise TypeError('tee() will write bytes directly to this fileobject'
+                        ', it must be opened with the "b" flag if it is a file'
+                        ' or inherit from io.BytesIO.')
+
+    return _tee(response, fileobject.write, chunksize, decode_content)
+
+
+def tee_to_file(response, filename, chunksize=_DEFAULT_CHUNKSIZE,
+                decode_content=None):
+    """Stream the response both to the generator and a file.
+
+    This will open a file named ``filename`` and stream the response body
+    while writing the bytes to the opened file object.
+
+    Example usage:
+
+    .. code-block:: python
+
+        resp = requests.get(url, stream=True)
+        for chunk in tee_to_file(resp, 'save_file'):
+            # do stuff with chunk
+
+    :param response: Response from requests.
+    :type response: requests.Response
+    :param str filename: Name of file in which we write the response content.
+    :param int chunksize: (optional), Size of chunk to attempt to stream.
+    :param bool decode_content: (optional), If True, this will decode the
+        compressed content of the response.
+    """
+    with open(filename, 'wb') as fd:
+        for chunk in tee(response, fd, chunksize, decode_content):
+            yield chunk
+
+
+def tee_to_bytearray(response, bytearr, chunksize=_DEFAULT_CHUNKSIZE,
+                     decode_content=None):
+    """Stream the response both to the generator and a bytearray.
+
+    This will stream the response provided to the function, add them to the
+    provided :class:`bytearray` and yield them to the user.
+
+    .. note::
+
+        This uses the :meth:`bytearray.extend` by default instead of passing
+        the bytearray into the ``readinto`` method.
+
+    Example usage:
+
+    .. code-block:: python
+
+        b = bytearray()
+        resp = requests.get(url, stream=True)
+        for chunk in tee_to_bytearray(resp, b):
+            # do stuff with chunk
+
+    :param response: Response from requests.
+    :type response: requests.Response
+    :param bytearray bytearr: Array to add the streamed bytes to.
+    :param int chunksize: (optional), Size of chunk to attempt to stream.
+    :param bool decode_content: (optional), If True, this will decode the
+        compressed content of the response.
+    """
+    if not isinstance(bytearr, bytearray):
+        raise TypeError('tee_to_bytearray() expects bytearr to be a '
+                        'bytearray')
+    return _tee(response, bytearr.extend, chunksize, decode_content)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..32ade215a37aa369b35dbcf6d4cf4a7bc4b3453f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/exceptions.py
@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+"""Collection of exceptions raised by requests-toolbelt."""
+
+
+class StreamingError(Exception):
+    """Used in :mod:`requests_toolbelt.downloadutils.stream`."""
+    pass
+
+
+class VersionMismatchError(Exception):
+    """Used to indicate a version mismatch in the version of requests required.
+
+    The feature in use requires a newer version of Requests to function
+    appropriately but the version installed is not sufficient.
+    """
+    pass
+
+
+class RequestsVersionTooOld(Warning):
+    """Used to indicate that the Requests version is too old.
+
+    If the version of Requests is too old to support a feature, we will issue
+    this warning to the user.
+    """
+    pass
+
+
+class IgnoringGAECertificateValidation(Warning):
+    """Used to indicate that given GAE validation behavior will be ignored.
+
+    If the user has tried to specify certificate validation when using the
+    insecure AppEngine adapter, it will be ignored (certificate validation will
+    remain off), so we will issue this warning to the user.
+
+    In :class:`requests_toolbelt.adapters.appengine.InsecureAppEngineAdapter`.
+    """
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..4bc49660818c5d35004596a758a8dc077f0ca0c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/__init__.py
@@ -0,0 +1,31 @@
+"""
+requests_toolbelt.multipart
+===========================
+
+See http://toolbelt.rtfd.org/ for documentation
+
+:copyright: (c) 2014 by Ian Cordasco and Cory Benfield
+:license: Apache v2.0, see LICENSE for more details
+"""
+
+from .encoder import MultipartEncoder, MultipartEncoderMonitor
+from .decoder import MultipartDecoder
+from .decoder import ImproperBodyPartContentException
+from .decoder import NonMultipartContentTypeException
+
+__title__ = 'requests-toolbelt'
+__authors__ = 'Ian Cordasco, Cory Benfield'
+__license__ = 'Apache v2.0'
+__copyright__ = 'Copyright 2014 Ian Cordasco, Cory Benfield'
+
+__all__ = [
+    'MultipartEncoder',
+    'MultipartEncoderMonitor',
+    'MultipartDecoder',
+    'ImproperBodyPartContentException',
+    'NonMultipartContentTypeException',
+    '__title__',
+    '__authors__',
+    '__license__',
+    '__copyright__',
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/decoder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/decoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..19d86af98ea9b09192ba7152c492d9f60accc80f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/decoder.py
@@ -0,0 +1,156 @@
+# -*- coding: utf-8 -*-
+"""
+
+requests_toolbelt.multipart.decoder
+===================================
+
+This holds all the implementation details of the MultipartDecoder
+
+"""
+
+import sys
+import email.parser
+from .encoder import encode_with
+from requests.structures import CaseInsensitiveDict
+
+
+def _split_on_find(content, bound):
+    point = content.find(bound)
+    return content[:point], content[point + len(bound):]
+
+
+class ImproperBodyPartContentException(Exception):
+    pass
+
+
+class NonMultipartContentTypeException(Exception):
+    pass
+
+
+def _header_parser(string, encoding):
+    major = sys.version_info[0]
+    if major == 3:
+        string = string.decode(encoding)
+    headers = email.parser.HeaderParser().parsestr(string).items()
+    return (
+        (encode_with(k, encoding), encode_with(v, encoding))
+        for k, v in headers
+    )
+
+
+class BodyPart(object):
+    """
+
+    The ``BodyPart`` object is a ``Response``-like interface to an individual
+    subpart of a multipart response. It is expected that these will
+    generally be created by objects of the ``MultipartDecoder`` class.
+
+    Like ``Response``, there is a ``CaseInsensitiveDict`` object named headers,
+    ``content`` to access bytes, ``text`` to access unicode, and ``encoding``
+    to access the unicode codec.
+
+    """
+
+    def __init__(self, content, encoding):
+        self.encoding = encoding
+        headers = {}
+        # Split into header section (if any) and the content
+        if b'\r\n\r\n' in content:
+            first, self.content = _split_on_find(content, b'\r\n\r\n')
+            if first != b'':
+                headers = _header_parser(first.lstrip(), encoding)
+        else:
+            raise ImproperBodyPartContentException(
+                'content does not contain CR-LF-CR-LF'
+            )
+        self.headers = CaseInsensitiveDict(headers)
+
+    @property
+    def text(self):
+        """Content of the ``BodyPart`` in unicode."""
+        return self.content.decode(self.encoding)
+
+
+class MultipartDecoder(object):
+    """
+
+    The ``MultipartDecoder`` object parses the multipart payload of
+    a bytestring into a tuple of ``Response``-like ``BodyPart`` objects.
+
+    The basic usage is::
+
+        import requests
+        from requests_toolbelt import MultipartDecoder
+
+        response = request.get(url)
+        decoder = MultipartDecoder.from_response(response)
+        for part in decoder.parts:
+            print(part.headers['content-type'])
+
+    If the multipart content is not from a response, basic usage is::
+
+        from requests_toolbelt import MultipartDecoder
+
+        decoder = MultipartDecoder(content, content_type)
+        for part in decoder.parts:
+            print(part.headers['content-type'])
+
+    For both these usages, there is an optional ``encoding`` parameter. This is
+    a string, which is the name of the unicode codec to use (default is
+    ``'utf-8'``).
+
+    """
+    def __init__(self, content, content_type, encoding='utf-8'):
+        #: Original Content-Type header
+        self.content_type = content_type
+        #: Response body encoding
+        self.encoding = encoding
+        #: Parsed parts of the multipart response body
+        self.parts = tuple()
+        self._find_boundary()
+        self._parse_body(content)
+
+    def _find_boundary(self):
+        ct_info = tuple(x.strip() for x in self.content_type.split(';'))
+        mimetype = ct_info[0]
+        if mimetype.split('/')[0].lower() != 'multipart':
+            raise NonMultipartContentTypeException(
+                "Unexpected mimetype in content-type: '{0}'".format(mimetype)
+            )
+        for item in ct_info[1:]:
+            attr, value = _split_on_find(
+                item,
+                '='
+            )
+            if attr.lower() == 'boundary':
+                self.boundary = encode_with(value.strip('"'), self.encoding)
+
+    @staticmethod
+    def _fix_first_part(part, boundary_marker):
+        bm_len = len(boundary_marker)
+        if boundary_marker == part[:bm_len]:
+            return part[bm_len:]
+        else:
+            return part
+
+    def _parse_body(self, content):
+        boundary = b''.join((b'--', self.boundary))
+
+        def body_part(part):
+            fixed = MultipartDecoder._fix_first_part(part, boundary)
+            return BodyPart(fixed, self.encoding)
+
+        def test_part(part):
+            return (part != b'' and
+                    part != b'\r\n' and
+                    part[:4] != b'--\r\n' and
+                    part != b'--')
+
+        parts = content.split(b''.join((b'\r\n', boundary)))
+        self.parts = tuple(body_part(x) for x in parts if test_part(x))
+
+    @classmethod
+    def from_response(cls, response, encoding='utf-8'):
+        content = response.content
+        content_type = response.headers.get('content-type', None)
+        return cls(content, content_type, encoding)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/encoder.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/encoder.py
new file mode 100644
index 0000000000000000000000000000000000000000..e4c7cd7a521be81657896b7c0a1c821934da8c82
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/multipart/encoder.py
@@ -0,0 +1,655 @@
+# -*- coding: utf-8 -*-
+"""
+
+requests_toolbelt.multipart.encoder
+===================================
+
+This holds all of the implementation details of the MultipartEncoder
+
+"""
+import contextlib
+import io
+import os
+from uuid import uuid4
+
+import requests
+
+from .._compat import fields
+
+
+class FileNotSupportedError(Exception):
+    """File not supported error."""
+
+
+class MultipartEncoder(object):
+
+    """
+
+    The ``MultipartEncoder`` object is a generic interface to the engine that
+    will create a ``multipart/form-data`` body for you.
+
+    The basic usage is:
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt import MultipartEncoder
+
+        encoder = MultipartEncoder({'field': 'value',
+                                    'other_field', 'other_value'})
+        r = requests.post('https://httpbin.org/post', data=encoder,
+                          headers={'Content-Type': encoder.content_type})
+
+    If you do not need to take advantage of streaming the post body, you can
+    also do:
+
+    .. code-block:: python
+
+        r = requests.post('https://httpbin.org/post',
+                          data=encoder.to_string(),
+                          headers={'Content-Type': encoder.content_type})
+
+    If you want the encoder to use a specific order, you can use an
+    OrderedDict or more simply, a list of tuples:
+
+    .. code-block:: python
+
+        encoder = MultipartEncoder([('field', 'value'),
+                                    ('other_field', 'other_value')])
+
+    .. versionchanged:: 0.4.0
+
+    You can also provide tuples as part values as you would provide them to
+    requests' ``files`` parameter.
+
+    .. code-block:: python
+
+        encoder = MultipartEncoder({
+            'field': ('file_name', b'{"a": "b"}', 'application/json',
+                      {'X-My-Header': 'my-value'})
+        ])
+
+    .. warning::
+
+        This object will end up directly in :mod:`httplib`. Currently,
+        :mod:`httplib` has a hard-coded read size of **8192 bytes**. This
+        means that it will loop until the file has been read and your upload
+        could take a while. This is **not** a bug in requests. A feature is
+        being considered for this object to allow you, the user, to specify
+        what size should be returned on a read. If you have opinions on this,
+        please weigh in on `this issue`_.
+
+    .. _this issue:
+        https://github.com/requests/toolbelt/issues/75
+
+    """
+
+    def __init__(self, fields, boundary=None, encoding='utf-8'):
+        #: Boundary value either passed in by the user or created
+        self.boundary_value = boundary or uuid4().hex
+
+        # Computed boundary
+        self.boundary = '--{0}'.format(self.boundary_value)
+
+        #: Encoding of the data being passed in
+        self.encoding = encoding
+
+        # Pre-encoded boundary
+        self._encoded_boundary = b''.join([
+            encode_with(self.boundary, self.encoding),
+            encode_with('\r\n', self.encoding)
+            ])
+
+        #: Fields provided by the user
+        self.fields = fields
+
+        #: Whether or not the encoder is finished
+        self.finished = False
+
+        #: Pre-computed parts of the upload
+        self.parts = []
+
+        # Pre-computed parts iterator
+        self._iter_parts = iter([])
+
+        # The part we're currently working with
+        self._current_part = None
+
+        # Cached computation of the body's length
+        self._len = None
+
+        # Our buffer
+        self._buffer = CustomBytesIO(encoding=encoding)
+
+        # Pre-compute each part's headers
+        self._prepare_parts()
+
+        # Load boundary into buffer
+        self._write_boundary()
+
+    @property
+    def len(self):
+        """Length of the multipart/form-data body.
+
+        requests will first attempt to get the length of the body by calling
+        ``len(body)`` and then by checking for the ``len`` attribute.
+
+        On 32-bit systems, the ``__len__`` method cannot return anything
+        larger than an integer (in C) can hold. If the total size of the body
+        is even slightly larger than 4GB users will see an OverflowError. This
+        manifested itself in `bug #80`_.
+
+        As such, we now calculate the length lazily as a property.
+
+        .. _bug #80:
+            https://github.com/requests/toolbelt/issues/80
+        """
+        # If _len isn't already calculated, calculate, return, and set it
+        return self._len or self._calculate_length()
+
+    def __repr__(self):
+        return '<MultipartEncoder: {0!r}>'.format(self.fields)
+
+    def _calculate_length(self):
+        """
+        This uses the parts to calculate the length of the body.
+
+        This returns the calculated length so __len__ can be lazy.
+        """
+        boundary_len = len(self.boundary)  # Length of --{boundary}
+        # boundary length + header length + body length + len('\r\n') * 2
+        self._len = sum(
+            (boundary_len + total_len(p) + 4) for p in self.parts
+            ) + boundary_len + 4
+        return self._len
+
+    def _calculate_load_amount(self, read_size):
+        """This calculates how many bytes need to be added to the buffer.
+
+        When a consumer read's ``x`` from the buffer, there are two cases to
+        satisfy:
+
+            1. Enough data in the buffer to return the requested amount
+            2. Not enough data
+
+        This function uses the amount of unread bytes in the buffer and
+        determines how much the Encoder has to load before it can return the
+        requested amount of bytes.
+
+        :param int read_size: the number of bytes the consumer requests
+        :returns: int -- the number of bytes that must be loaded into the
+            buffer before the read can be satisfied. This will be strictly
+            non-negative
+        """
+        amount = read_size - total_len(self._buffer)
+        return amount if amount > 0 else 0
+
+    def _load(self, amount):
+        """Load ``amount`` number of bytes into the buffer."""
+        self._buffer.smart_truncate()
+        part = self._current_part or self._next_part()
+        while amount == -1 or amount > 0:
+            written = 0
+            if part and not part.bytes_left_to_write():
+                written += self._write(b'\r\n')
+                written += self._write_boundary()
+                part = self._next_part()
+
+            if not part:
+                written += self._write_closing_boundary()
+                self.finished = True
+                break
+
+            written += part.write_to(self._buffer, amount)
+
+            if amount != -1:
+                amount -= written
+
+    def _next_part(self):
+        try:
+            p = self._current_part = next(self._iter_parts)
+        except StopIteration:
+            p = None
+        return p
+
+    def _iter_fields(self):
+        _fields = self.fields
+        if hasattr(self.fields, 'items'):
+            _fields = list(self.fields.items())
+        for k, v in _fields:
+            file_name = None
+            file_type = None
+            file_headers = None
+            if isinstance(v, (list, tuple)):
+                if len(v) == 2:
+                    file_name, file_pointer = v
+                elif len(v) == 3:
+                    file_name, file_pointer, file_type = v
+                else:
+                    file_name, file_pointer, file_type, file_headers = v
+            else:
+                file_pointer = v
+
+            field = fields.RequestField(name=k, data=file_pointer,
+                                        filename=file_name,
+                                        headers=file_headers)
+            field.make_multipart(content_type=file_type)
+            yield field
+
+    def _prepare_parts(self):
+        """This uses the fields provided by the user and creates Part objects.
+
+        It populates the `parts` attribute and uses that to create a
+        generator for iteration.
+        """
+        enc = self.encoding
+        self.parts = [Part.from_field(f, enc) for f in self._iter_fields()]
+        self._iter_parts = iter(self.parts)
+
+    def _write(self, bytes_to_write):
+        """Write the bytes to the end of the buffer.
+
+        :param bytes bytes_to_write: byte-string (or bytearray) to append to
+            the buffer
+        :returns: int -- the number of bytes written
+        """
+        return self._buffer.append(bytes_to_write)
+
+    def _write_boundary(self):
+        """Write the boundary to the end of the buffer."""
+        return self._write(self._encoded_boundary)
+
+    def _write_closing_boundary(self):
+        """Write the bytes necessary to finish a multipart/form-data body."""
+        with reset(self._buffer):
+            self._buffer.seek(-2, 2)
+            self._buffer.write(b'--\r\n')
+        return 2
+
+    def _write_headers(self, headers):
+        """Write the current part's headers to the buffer."""
+        return self._write(encode_with(headers, self.encoding))
+
+    @property
+    def content_type(self):
+        return str(
+            'multipart/form-data; boundary={0}'.format(self.boundary_value)
+            )
+
+    def to_string(self):
+        """Return the entirety of the data in the encoder.
+
+        .. note::
+
+            This simply reads all of the data it can. If you have started
+            streaming or reading data from the encoder, this method will only
+            return whatever data is left in the encoder.
+
+        .. note::
+
+            This method affects the internal state of the encoder. Calling
+            this method will exhaust the encoder.
+
+        :returns: the multipart message
+        :rtype: bytes
+        """
+
+        return self.read()
+
+    def read(self, size=-1):
+        """Read data from the streaming encoder.
+
+        :param int size: (optional), If provided, ``read`` will return exactly
+            that many bytes. If it is not provided, it will return the
+            remaining bytes.
+        :returns: bytes
+        """
+        if self.finished:
+            return self._buffer.read(size)
+
+        bytes_to_load = size
+        if bytes_to_load != -1 and bytes_to_load is not None:
+            bytes_to_load = self._calculate_load_amount(int(size))
+
+        self._load(bytes_to_load)
+        return self._buffer.read(size)
+
+
+def IDENTITY(monitor):
+    return monitor
+
+
+class MultipartEncoderMonitor(object):
+
+    """
+    An object used to monitor the progress of a :class:`MultipartEncoder`.
+
+    The :class:`MultipartEncoder` should only be responsible for preparing and
+    streaming the data. For anyone who wishes to monitor it, they shouldn't be
+    using that instance to manage that as well. Using this class, they can
+    monitor an encoder and register a callback. The callback receives the
+    instance of the monitor.
+
+    To use this monitor, you construct your :class:`MultipartEncoder` as you
+    normally would.
+
+    .. code-block:: python
+
+        from requests_toolbelt import (MultipartEncoder,
+                                       MultipartEncoderMonitor)
+        import requests
+
+        def callback(monitor):
+            # Do something with this information
+            pass
+
+        m = MultipartEncoder(fields={'field0': 'value0'})
+        monitor = MultipartEncoderMonitor(m, callback)
+        headers = {'Content-Type': monitor.content_type}
+        r = requests.post('https://httpbin.org/post', data=monitor,
+                          headers=headers)
+
+    Alternatively, if your use case is very simple, you can use the following
+    pattern.
+
+    .. code-block:: python
+
+        from requests_toolbelt import MultipartEncoderMonitor
+        import requests
+
+        def callback(monitor):
+            # Do something with this information
+            pass
+
+        monitor = MultipartEncoderMonitor.from_fields(
+            fields={'field0': 'value0'}, callback
+            )
+        headers = {'Content-Type': montior.content_type}
+        r = requests.post('https://httpbin.org/post', data=monitor,
+                          headers=headers)
+
+    """
+
+    def __init__(self, encoder, callback=None):
+        #: Instance of the :class:`MultipartEncoder` being monitored
+        self.encoder = encoder
+
+        #: Optionally function to call after a read
+        self.callback = callback or IDENTITY
+
+        #: Number of bytes already read from the :class:`MultipartEncoder`
+        #: instance
+        self.bytes_read = 0
+
+        #: Avoid the same problem in bug #80
+        self.len = self.encoder.len
+
+    @classmethod
+    def from_fields(cls, fields, boundary=None, encoding='utf-8',
+                    callback=None):
+        encoder = MultipartEncoder(fields, boundary, encoding)
+        return cls(encoder, callback)
+
+    @property
+    def content_type(self):
+        return self.encoder.content_type
+
+    def to_string(self):
+        return self.read()
+
+    def read(self, size=-1):
+        string = self.encoder.read(size)
+        self.bytes_read += len(string)
+        self.callback(self)
+        return string
+
+
+def encode_with(string, encoding):
+    """Encoding ``string`` with ``encoding`` if necessary.
+
+    :param str string: If string is a bytes object, it will not encode it.
+        Otherwise, this function will encode it with the provided encoding.
+    :param str encoding: The encoding with which to encode string.
+    :returns: encoded bytes object
+    """
+    if not (string is None or isinstance(string, bytes)):
+        return string.encode(encoding)
+    return string
+
+
+def readable_data(data, encoding):
+    """Coerce the data to an object with a ``read`` method."""
+    if hasattr(data, 'read'):
+        return data
+
+    return CustomBytesIO(data, encoding)
+
+
+def total_len(o):
+    if hasattr(o, '__len__'):
+        return len(o)
+
+    if hasattr(o, 'len'):
+        return o.len
+
+    if hasattr(o, 'fileno'):
+        try:
+            fileno = o.fileno()
+        except io.UnsupportedOperation:
+            pass
+        else:
+            return os.fstat(fileno).st_size
+
+    if hasattr(o, 'getvalue'):
+        # e.g. BytesIO, cStringIO.StringIO
+        return len(o.getvalue())
+
+
+@contextlib.contextmanager
+def reset(buffer):
+    """Keep track of the buffer's current position and write to the end.
+
+    This is a context manager meant to be used when adding data to the buffer.
+    It eliminates the need for every function to be concerned with the
+    position of the cursor in the buffer.
+    """
+    original_position = buffer.tell()
+    buffer.seek(0, 2)
+    yield
+    buffer.seek(original_position, 0)
+
+
+def coerce_data(data, encoding):
+    """Ensure that every object's __len__ behaves uniformly."""
+    if not isinstance(data, CustomBytesIO):
+        if hasattr(data, 'getvalue'):
+            return CustomBytesIO(data.getvalue(), encoding)
+
+        if hasattr(data, 'fileno'):
+            return FileWrapper(data)
+
+        if not hasattr(data, 'read'):
+            return CustomBytesIO(data, encoding)
+
+    return data
+
+
+def to_list(fields):
+    if hasattr(fields, 'items'):
+        return list(fields.items())
+    return list(fields)
+
+
+class Part(object):
+    def __init__(self, headers, body):
+        self.headers = headers
+        self.body = body
+        self.headers_unread = True
+        self.len = len(self.headers) + total_len(self.body)
+
+    @classmethod
+    def from_field(cls, field, encoding):
+        """Create a part from a Request Field generated by urllib3."""
+        headers = encode_with(field.render_headers(), encoding)
+        body = coerce_data(field.data, encoding)
+        return cls(headers, body)
+
+    def bytes_left_to_write(self):
+        """Determine if there are bytes left to write.
+
+        :returns: bool -- ``True`` if there are bytes left to write, otherwise
+            ``False``
+        """
+        to_read = 0
+        if self.headers_unread:
+            to_read += len(self.headers)
+
+        return (to_read + total_len(self.body)) > 0
+
+    def write_to(self, buffer, size):
+        """Write the requested amount of bytes to the buffer provided.
+
+        The number of bytes written may exceed size on the first read since we
+        load the headers ambitiously.
+
+        :param CustomBytesIO buffer: buffer we want to write bytes to
+        :param int size: number of bytes requested to be written to the buffer
+        :returns: int -- number of bytes actually written
+        """
+        written = 0
+        if self.headers_unread:
+            written += buffer.append(self.headers)
+            self.headers_unread = False
+
+        while total_len(self.body) > 0 and (size == -1 or written < size):
+            amount_to_read = size
+            if size != -1:
+                amount_to_read = size - written
+            written += buffer.append(self.body.read(amount_to_read))
+
+        return written
+
+
+class CustomBytesIO(io.BytesIO):
+    def __init__(self, buffer=None, encoding='utf-8'):
+        buffer = encode_with(buffer, encoding)
+        super(CustomBytesIO, self).__init__(buffer)
+
+    def _get_end(self):
+        current_pos = self.tell()
+        self.seek(0, 2)
+        length = self.tell()
+        self.seek(current_pos, 0)
+        return length
+
+    @property
+    def len(self):
+        length = self._get_end()
+        return length - self.tell()
+
+    def append(self, bytes):
+        with reset(self):
+            written = self.write(bytes)
+        return written
+
+    def smart_truncate(self):
+        to_be_read = total_len(self)
+        already_read = self._get_end() - to_be_read
+
+        if already_read >= to_be_read:
+            old_bytes = self.read()
+            self.seek(0, 0)
+            self.truncate()
+            self.write(old_bytes)
+            self.seek(0, 0)  # We want to be at the beginning
+
+
+class FileWrapper(object):
+    def __init__(self, file_object):
+        self.fd = file_object
+
+    @property
+    def len(self):
+        return total_len(self.fd) - self.fd.tell()
+
+    def read(self, length=-1):
+        return self.fd.read(length)
+
+
+class FileFromURLWrapper(object):
+    """File from URL wrapper.
+
+    The :class:`FileFromURLWrapper` object gives you the ability to stream file
+    from provided URL in chunks by :class:`MultipartEncoder`.
+    Provide a stateless solution for streaming file from one server to another.
+    You can use the :class:`FileFromURLWrapper` without a session or with
+    a session as demonstated by the examples below:
+
+    .. code-block:: python
+        # no session
+
+        import requests
+        from requests_toolbelt import MultipartEncoder, FileFromURLWrapper
+
+        url = 'https://httpbin.org/image/png'
+        streaming_encoder = MultipartEncoder(
+            fields={
+                'file': FileFromURLWrapper(url)
+            }
+        )
+        r = requests.post(
+            'https://httpbin.org/post', data=streaming_encoder,
+            headers={'Content-Type': streaming_encoder.content_type}
+        )
+
+    .. code-block:: python
+        # using a session
+
+        import requests
+        from requests_toolbelt import MultipartEncoder, FileFromURLWrapper
+
+        session = requests.Session()
+        url = 'https://httpbin.org/image/png'
+        streaming_encoder = MultipartEncoder(
+            fields={
+                'file': FileFromURLWrapper(url, session=session)
+            }
+        )
+        r = session.post(
+            'https://httpbin.org/post', data=streaming_encoder,
+            headers={'Content-Type': streaming_encoder.content_type}
+        )
+
+    """
+
+    def __init__(self, file_url, session=None):
+        self.session = session or requests.Session()
+        requested_file = self._request_for_file(file_url)
+        self.len = int(requested_file.headers['content-length'])
+        self.raw_data = requested_file.raw
+
+    def _request_for_file(self, file_url):
+        """Make call for file under provided URL."""
+        response = self.session.get(file_url, stream=True)
+        content_length = response.headers.get('content-length', None)
+        if content_length is None:
+            error_msg = (
+                "Data from provided URL {url} is not supported. Lack of "
+                "content-length Header in requested file response.".format(
+                    url=file_url)
+            )
+            raise FileNotSupportedError(error_msg)
+        elif not content_length.isdigit():
+            error_msg = (
+                "Data from provided URL {url} is not supported. content-length"
+                " header value is not a digit.".format(url=file_url)
+            )
+            raise FileNotSupportedError(error_msg)
+        return response
+
+    def read(self, chunk_size):
+        """Read file in chunks."""
+        chunk_size = chunk_size if chunk_size >= 0 else self.len
+        chunk = self.raw_data.read(chunk_size) or b''
+        self.len -= len(chunk) if chunk else 0  # left to read
+        return chunk
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/sessions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/sessions.py
new file mode 100644
index 0000000000000000000000000000000000000000..7beac968d2ed13f7535a8a31e5bb8f41e29dcca1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/sessions.py
@@ -0,0 +1,70 @@
+import requests
+
+from ._compat import urljoin
+
+
+class BaseUrlSession(requests.Session):
+    """A Session with a URL that all requests will use as a base.
+
+    Let's start by looking at an example:
+
+    .. code-block:: python
+
+        >>> from requests_toolbelt import sessions
+        >>> s = sessions.BaseUrlSession(
+        ...     base_url='https://example.com/resource/')
+        >>> r = s.get('sub-resource/' params={'foo': 'bar'})
+        >>> print(r.request.url)
+        https://example.com/resource/sub-resource/?foo=bar
+
+    Our call to the ``get`` method will make a request to the URL passed in
+    when we created the Session and the partial resource name we provide.
+
+    We implement this by overriding the ``request`` method so most uses of a
+    Session are covered. (This, however, precludes the use of PreparedRequest
+    objects).
+
+    .. note::
+
+        The base URL that you provide and the path you provide are **very**
+        important.
+
+    Let's look at another *similar* example
+
+    .. code-block:: python
+
+        >>> from requests_toolbelt import sessions
+        >>> s = sessions.BaseUrlSession(
+        ...     base_url='https://example.com/resource/')
+        >>> r = s.get('/sub-resource/' params={'foo': 'bar'})
+        >>> print(r.request.url)
+        https://example.com/sub-resource/?foo=bar
+
+    The key difference here is that we called ``get`` with ``/sub-resource/``,
+    i.e., there was a leading ``/``. This changes how we create the URL
+    because we rely on :mod:`urllib.parse.urljoin`.
+
+    To override how we generate the URL, sub-class this method and override the
+    ``create_url`` method.
+
+    Based on implementation from
+    https://github.com/kennethreitz/requests/issues/2554#issuecomment-109341010
+    """
+
+    base_url = None
+
+    def __init__(self, base_url=None):
+        if base_url:
+            self.base_url = base_url
+        super(BaseUrlSession, self).__init__()
+
+    def request(self, method, url, *args, **kwargs):
+        """Send the request after generating the complete URL."""
+        url = self.create_url(url)
+        return super(BaseUrlSession, self).request(
+            method, url, *args, **kwargs
+        )
+
+    def create_url(self, url):
+        """Create the URL based off this partial path."""
+        return urljoin(self.base_url, url)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/streaming_iterator.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/streaming_iterator.py
new file mode 100644
index 0000000000000000000000000000000000000000..64fd75f16da866d24a3a87159497dc8ae1783143
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/streaming_iterator.py
@@ -0,0 +1,116 @@
+# -*- coding: utf-8 -*-
+"""
+
+requests_toolbelt.streaming_iterator
+====================================
+
+This holds the implementation details for the :class:`StreamingIterator`. It
+is designed for the case where you, the user, know the size of the upload but
+need to provide the data as an iterator. This class will allow you to specify
+the size and stream the data without using a chunked transfer-encoding.
+
+"""
+from requests.utils import super_len
+
+from .multipart.encoder import CustomBytesIO, encode_with
+
+
+class StreamingIterator(object):
+
+    """
+    This class provides a way of allowing iterators with a known size to be
+    streamed instead of chunked.
+
+    In requests, if you pass in an iterator it assumes you want to use
+    chunked transfer-encoding to upload the data, which not all servers
+    support well. Additionally, you may want to set the content-length
+    yourself to avoid this but that will not work. The only way to preempt
+    requests using a chunked transfer-encoding and forcing it to stream the
+    uploads is to mimic a very specific interace. Instead of having to know
+    these details you can instead just use this class. You simply provide the
+    size and iterator and pass the instance of StreamingIterator to requests
+    via the data parameter like so:
+
+    .. code-block:: python
+
+        from requests_toolbelt import StreamingIterator
+
+        import requests
+
+        # Let iterator be some generator that you already have and size be
+        # the size of the data produced by the iterator
+
+        r = requests.post(url, data=StreamingIterator(size, iterator))
+
+    You can also pass file-like objects to :py:class:`StreamingIterator` in
+    case requests can't determize the filesize itself. This is the case with
+    streaming file objects like ``stdin`` or any sockets. Wrapping e.g. files
+    that are on disk with ``StreamingIterator`` is unnecessary, because
+    requests can determine the filesize itself.
+
+    Naturally, you should also set the `Content-Type` of your upload
+    appropriately because the toolbelt will not attempt to guess that for you.
+    """
+
+    def __init__(self, size, iterator, encoding='utf-8'):
+        #: The expected size of the upload
+        self.size = int(size)
+
+        if self.size < 0:
+            raise ValueError(
+                'The size of the upload must be a positive integer'
+                )
+
+        #: Attribute that requests will check to determine the length of the
+        #: body. See bug #80 for more details
+        self.len = self.size
+
+        #: Encoding the input data is using
+        self.encoding = encoding
+
+        #: The iterator used to generate the upload data
+        self.iterator = iterator
+
+        if hasattr(iterator, 'read'):
+            self._file = iterator
+        else:
+            self._file = _IteratorAsBinaryFile(iterator, encoding)
+
+    def read(self, size=-1):
+        return encode_with(self._file.read(size), self.encoding)
+
+
+class _IteratorAsBinaryFile(object):
+    def __init__(self, iterator, encoding='utf-8'):
+        #: The iterator used to generate the upload data
+        self.iterator = iterator
+
+        #: Encoding the iterator is using
+        self.encoding = encoding
+
+        # The buffer we use to provide the correct number of bytes requested
+        # during a read
+        self._buffer = CustomBytesIO()
+
+    def _get_bytes(self):
+        try:
+            return encode_with(next(self.iterator), self.encoding)
+        except StopIteration:
+            return b''
+
+    def _load_bytes(self, size):
+        self._buffer.smart_truncate()
+        amount_to_load = size - super_len(self._buffer)
+        bytes_to_append = True
+
+        while amount_to_load > 0 and bytes_to_append:
+            bytes_to_append = self._get_bytes()
+            amount_to_load -= self._buffer.append(bytes_to_append)
+
+    def read(self, size=-1):
+        size = int(size)
+        if size == -1:
+            return b''.join(self.iterator)
+
+        self._load_bytes(size)
+        return self._buffer.read(size)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..984f1e8014ba15c93500f55086ab892dc9b46755
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/__init__.py
@@ -0,0 +1,97 @@
+"""
+This module provides the API for ``requests_toolbelt.threaded``.
+
+The module provides a clean and simple API for making requests via a thread
+pool. The thread pool will use sessions for increased performance.
+
+A simple use-case is:
+
+.. code-block:: python
+
+    from requests_toolbelt import threaded
+
+    urls_to_get = [{
+        'url': 'https://api.github.com/users/sigmavirus24',
+        'method': 'GET',
+    }, {
+        'url': 'https://api.github.com/repos/requests/toolbelt',
+        'method': 'GET',
+    }, {
+        'url': 'https://google.com',
+        'method': 'GET',
+    }]
+    responses, errors = threaded.map(urls_to_get)
+
+By default, the threaded submodule will detect the number of CPUs your
+computer has and use that if no other number of processes is selected. To
+change this, always use the keyword argument ``num_processes``. Using the
+above example, we would expand it like so:
+
+.. code-block:: python
+
+    responses, errors = threaded.map(urls_to_get, num_processes=10)
+
+You can also customize how a :class:`requests.Session` is initialized by
+creating a callback function:
+
+.. code-block:: python
+
+    from requests_toolbelt import user_agent
+
+    def initialize_session(session):
+        session.headers['User-Agent'] = user_agent('my-scraper', '0.1')
+        session.headers['Accept'] = 'application/json'
+
+    responses, errors = threaded.map(urls_to_get,
+                                     initializer=initialize_session)
+
+.. autofunction:: requests_toolbelt.threaded.map
+
+Inspiration is blatantly drawn from the standard library's multiprocessing
+library. See the following references:
+
+- multiprocessing's `pool source`_
+
+- map and map_async `inspiration`_
+
+.. _pool source:
+    https://hg.python.org/cpython/file/8ef4f75a8018/Lib/multiprocessing/pool.py
+.. _inspiration:
+    https://hg.python.org/cpython/file/8ef4f75a8018/Lib/multiprocessing/pool.py#l340
+"""
+from . import pool
+from .._compat import queue
+
+
+def map(requests, **kwargs):
+    r"""Simple interface to the threaded Pool object.
+
+    This function takes a list of dictionaries representing requests to make
+    using Sessions in threads and returns a tuple where the first item is
+    a generator of successful responses and the second is a generator of
+    exceptions.
+
+    :param list requests:
+        Collection of dictionaries representing requests to make with the Pool
+        object.
+    :param \*\*kwargs:
+        Keyword arguments that are passed to the
+        :class:`~requests_toolbelt.threaded.pool.Pool` object.
+    :returns: Tuple of responses and exceptions from the pool
+    :rtype: (:class:`~requests_toolbelt.threaded.pool.ThreadResponse`,
+        :class:`~requests_toolbelt.threaded.pool.ThreadException`)
+    """
+    if not (requests and all(isinstance(r, dict) for r in requests)):
+        raise ValueError('map expects a list of dictionaries.')
+
+    # Build our queue of requests
+    job_queue = queue.Queue()
+    for request in requests:
+        job_queue.put(request)
+
+    # Ensure the user doesn't try to pass their own job_queue
+    kwargs['job_queue'] = job_queue
+
+    threadpool = pool.Pool(**kwargs)
+    threadpool.join_all()
+    return threadpool.responses(), threadpool.exceptions()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/pool.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/pool.py
new file mode 100644
index 0000000000000000000000000000000000000000..1fe81461a9b4491c4f03411a889ccabdf235b9d6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/pool.py
@@ -0,0 +1,211 @@
+"""Module implementing the Pool for :mod:``requests_toolbelt.threaded``."""
+import multiprocessing
+import requests
+
+from . import thread
+from .._compat import queue
+
+
+class Pool(object):
+    """Pool that manages the threads containing sessions.
+
+    :param queue:
+        The queue you're expected to use to which you should add items.
+    :type queue: queue.Queue
+    :param initializer:
+        Function used to initialize an instance of ``session``.
+    :type initializer: collections.Callable
+    :param auth_generator:
+        Function used to generate new auth credentials for the session.
+    :type auth_generator: collections.Callable
+    :param int num_process:
+        Number of threads to create.
+    :param session:
+    :type session: requests.Session
+    """
+
+    def __init__(self, job_queue, initializer=None, auth_generator=None,
+                 num_processes=None, session=requests.Session):
+        if num_processes is None:
+            num_processes = multiprocessing.cpu_count() or 1
+
+        if num_processes < 1:
+            raise ValueError("Number of processes should at least be 1.")
+
+        self._job_queue = job_queue
+        self._response_queue = queue.Queue()
+        self._exc_queue = queue.Queue()
+        self._processes = num_processes
+        self._initializer = initializer or _identity
+        self._auth = auth_generator or _identity
+        self._session = session
+        self._pool = [
+            thread.SessionThread(self._new_session(), self._job_queue,
+                                 self._response_queue, self._exc_queue)
+            for _ in range(self._processes)
+        ]
+
+    def _new_session(self):
+        return self._auth(self._initializer(self._session()))
+
+    @classmethod
+    def from_exceptions(cls, exceptions, **kwargs):
+        r"""Create a :class:`~Pool` from an :class:`~ThreadException`\ s.
+
+        Provided an iterable that provides :class:`~ThreadException` objects,
+        this classmethod will generate a new pool to retry the requests that
+        caused the exceptions.
+
+        :param exceptions:
+            Iterable that returns :class:`~ThreadException`
+        :type exceptions: iterable
+        :param kwargs:
+            Keyword arguments passed to the :class:`~Pool` initializer.
+        :returns: An initialized :class:`~Pool` object.
+        :rtype: :class:`~Pool`
+        """
+        job_queue = queue.Queue()
+        for exc in exceptions:
+            job_queue.put(exc.request_kwargs)
+
+        return cls(job_queue=job_queue, **kwargs)
+
+    @classmethod
+    def from_urls(cls, urls, request_kwargs=None, **kwargs):
+        """Create a :class:`~Pool` from an iterable of URLs.
+
+        :param urls:
+            Iterable that returns URLs with which we create a pool.
+        :type urls: iterable
+        :param dict request_kwargs:
+            Dictionary of other keyword arguments to provide to the request
+            method.
+        :param kwargs:
+            Keyword arguments passed to the :class:`~Pool` initializer.
+        :returns: An initialized :class:`~Pool` object.
+        :rtype: :class:`~Pool`
+        """
+        request_dict = {'method': 'GET'}
+        request_dict.update(request_kwargs or {})
+        job_queue = queue.Queue()
+        for url in urls:
+            job = request_dict.copy()
+            job.update({'url': url})
+            job_queue.put(job)
+
+        return cls(job_queue=job_queue, **kwargs)
+
+    def exceptions(self):
+        """Iterate over all the exceptions in the pool.
+
+        :returns: Generator of :class:`~ThreadException`
+        """
+        while True:
+            exc = self.get_exception()
+            if exc is None:
+                break
+            yield exc
+
+    def get_exception(self):
+        """Get an exception from the pool.
+
+        :rtype: :class:`~ThreadException`
+        """
+        try:
+            (request, exc) = self._exc_queue.get_nowait()
+        except queue.Empty:
+            return None
+        else:
+            return ThreadException(request, exc)
+
+    def get_response(self):
+        """Get a response from the pool.
+
+        :rtype: :class:`~ThreadResponse`
+        """
+        try:
+            (request, response) = self._response_queue.get_nowait()
+        except queue.Empty:
+            return None
+        else:
+            return ThreadResponse(request, response)
+
+    def responses(self):
+        """Iterate over all the responses in the pool.
+
+        :returns: Generator of :class:`~ThreadResponse`
+        """
+        while True:
+            resp = self.get_response()
+            if resp is None:
+                break
+            yield resp
+
+    def join_all(self):
+        """Join all the threads to the master thread."""
+        for session_thread in self._pool:
+            session_thread.join()
+
+
+class ThreadProxy(object):
+    proxied_attr = None
+
+    def __getattr__(self, attr):
+        """Proxy attribute accesses to the proxied object."""
+        get = object.__getattribute__
+        if attr not in self.attrs:
+            response = get(self, self.proxied_attr)
+            return getattr(response, attr)
+        else:
+            return get(self, attr)
+
+
+class ThreadResponse(ThreadProxy):
+    """A wrapper around a requests Response object.
+
+    This will proxy most attribute access actions to the Response object. For
+    example, if you wanted the parsed JSON from the response, you might do:
+
+    .. code-block:: python
+
+        thread_response = pool.get_response()
+        json = thread_response.json()
+
+    """
+    proxied_attr = 'response'
+    attrs = frozenset(['request_kwargs', 'response'])
+
+    def __init__(self, request_kwargs, response):
+        #: The original keyword arguments provided to the queue
+        self.request_kwargs = request_kwargs
+        #: The wrapped response
+        self.response = response
+
+
+class ThreadException(ThreadProxy):
+    """A wrapper around an exception raised during a request.
+
+    This will proxy most attribute access actions to the exception object. For
+    example, if you wanted the message from the exception, you might do:
+
+    .. code-block:: python
+
+        thread_exc = pool.get_exception()
+        msg = thread_exc.message
+
+    """
+    proxied_attr = 'exception'
+    attrs = frozenset(['request_kwargs', 'exception'])
+
+    def __init__(self, request_kwargs, exception):
+        #: The original keyword arguments provided to the queue
+        self.request_kwargs = request_kwargs
+        #: The captured and wrapped exception
+        self.exception = exception
+
+
+def _identity(session_obj):
+    return session_obj
+
+
+__all__ = ['ThreadException', 'ThreadResponse', 'Pool']
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/thread.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/thread.py
new file mode 100644
index 0000000000000000000000000000000000000000..542813c1fdb7de6fa1bedc55c0601a35c5f44abf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/threaded/thread.py
@@ -0,0 +1,53 @@
+"""Module containing the SessionThread class."""
+import threading
+import uuid
+
+import requests.exceptions as exc
+
+from .._compat import queue
+
+
+class SessionThread(object):
+    def __init__(self, initialized_session, job_queue, response_queue,
+                 exception_queue):
+        self._session = initialized_session
+        self._jobs = job_queue
+        self._create_worker()
+        self._responses = response_queue
+        self._exceptions = exception_queue
+
+    def _create_worker(self):
+        self._worker = threading.Thread(
+            target=self._make_request,
+            name=uuid.uuid4(),
+        )
+        self._worker.daemon = True
+        self._worker._state = 0
+        self._worker.start()
+
+    def _handle_request(self, kwargs):
+        try:
+            response = self._session.request(**kwargs)
+        except exc.RequestException as e:
+            self._exceptions.put((kwargs, e))
+        else:
+            self._responses.put((kwargs, response))
+        finally:
+            self._jobs.task_done()
+
+    def _make_request(self):
+        while True:
+            try:
+                kwargs = self._jobs.get_nowait()
+            except queue.Empty:
+                break
+
+            self._handle_request(kwargs)
+
+    def is_alive(self):
+        """Proxy to the thread's ``is_alive`` method."""
+        return self._worker.is_alive()
+
+    def join(self):
+        """Join this thread to the master thread."""
+        self._worker.join()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/deprecated.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/deprecated.py
new file mode 100644
index 0000000000000000000000000000000000000000..c935783bdcf9c2233295f11c9c389b72524345ab
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/deprecated.py
@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+"""A collection of functions deprecated in requests.utils."""
+import re
+import sys
+
+from requests import utils
+
+find_charset = re.compile(
+    br'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I
+).findall
+
+find_pragma = re.compile(
+    br'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I
+).findall
+
+find_xml = re.compile(
+    br'^<\?xml.*?encoding=["\']*(.+?)["\'>]'
+).findall
+
+
+def get_encodings_from_content(content):
+    """Return encodings from given content string.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.utils import deprecated
+
+        r = requests.get(url)
+        encodings = deprecated.get_encodings_from_content(r)
+
+    :param content: bytestring to extract encodings from
+    :type content: bytes
+    :return: encodings detected in the provided content
+    :rtype: list(str)
+    """
+    encodings = (find_charset(content) + find_pragma(content)
+                 + find_xml(content))
+    if (3, 0) <= sys.version_info < (4, 0):
+        encodings = [encoding.decode('utf8') for encoding in encodings]
+    return encodings
+
+
+def get_unicode_from_response(response):
+    """Return the requested content back in unicode.
+
+    This will first attempt to retrieve the encoding from the response
+    headers. If that fails, it will use
+    :func:`requests_toolbelt.utils.deprecated.get_encodings_from_content`
+    to determine encodings from HTML elements.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.utils import deprecated
+
+        r = requests.get(url)
+        text = deprecated.get_unicode_from_response(r)
+
+    :param response: Response object to get unicode content from.
+    :type response: requests.models.Response
+    """
+    tried_encodings = set()
+
+    # Try charset from content-type
+    encoding = utils.get_encoding_from_headers(response.headers)
+
+    if encoding:
+        try:
+            return str(response.content, encoding)
+        except UnicodeError:
+            tried_encodings.add(encoding.lower())
+
+    encodings = get_encodings_from_content(response.content)
+
+    for _encoding in encodings:
+        _encoding = _encoding.lower()
+        if _encoding in tried_encodings:
+            continue
+        try:
+            return str(response.content, _encoding)
+        except UnicodeError:
+            tried_encodings.add(_encoding)
+
+    # Fall back:
+    if encoding:
+        try:
+            return str(response.content, encoding, errors='replace')
+        except TypeError:
+            pass
+    return response.text
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/dump.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/dump.py
new file mode 100644
index 0000000000000000000000000000000000000000..23b35e75aea063e57f7d1d0b44523172a4882b1e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/dump.py
@@ -0,0 +1,197 @@
+"""This module provides functions for dumping information about responses."""
+import collections
+
+from requests import compat
+
+
+__all__ = ('dump_response', 'dump_all')
+
+HTTP_VERSIONS = {
+    9: b'0.9',
+    10: b'1.0',
+    11: b'1.1',
+}
+
+_PrefixSettings = collections.namedtuple('PrefixSettings',
+                                         ['request', 'response'])
+
+
+class PrefixSettings(_PrefixSettings):
+    def __new__(cls, request, response):
+        request = _coerce_to_bytes(request)
+        response = _coerce_to_bytes(response)
+        return super(PrefixSettings, cls).__new__(cls, request, response)
+
+
+def _get_proxy_information(response):
+    if getattr(response.connection, 'proxy_manager', False):
+        proxy_info = {}
+        request_url = response.request.url
+        if request_url.startswith('https://'):
+            proxy_info['method'] = 'CONNECT'
+
+        proxy_info['request_path'] = request_url
+        return proxy_info
+    return None
+
+
+def _format_header(name, value):
+    return (_coerce_to_bytes(name) + b': ' + _coerce_to_bytes(value) +
+            b'\r\n')
+
+
+def _build_request_path(url, proxy_info):
+    uri = compat.urlparse(url)
+    proxy_url = proxy_info.get('request_path')
+    if proxy_url is not None:
+        request_path = _coerce_to_bytes(proxy_url)
+        return request_path, uri
+
+    request_path = _coerce_to_bytes(uri.path)
+    if uri.query:
+        request_path += b'?' + _coerce_to_bytes(uri.query)
+
+    return request_path, uri
+
+
+def _dump_request_data(request, prefixes, bytearr, proxy_info=None):
+    if proxy_info is None:
+        proxy_info = {}
+
+    prefix = prefixes.request
+    method = _coerce_to_bytes(proxy_info.pop('method', request.method))
+    request_path, uri = _build_request_path(request.url, proxy_info)
+
+    # <prefix><METHOD> <request-path> HTTP/1.1
+    bytearr.extend(prefix + method + b' ' + request_path + b' HTTP/1.1\r\n')
+
+    # <prefix>Host: <request-host> OR host header specified by user
+    headers = request.headers.copy()
+    host_header = _coerce_to_bytes(headers.pop('Host', uri.netloc))
+    bytearr.extend(prefix + b'Host: ' + host_header + b'\r\n')
+
+    for name, value in headers.items():
+        bytearr.extend(prefix + _format_header(name, value))
+
+    bytearr.extend(prefix + b'\r\n')
+    if request.body:
+        if isinstance(request.body, compat.basestring):
+            bytearr.extend(prefix + _coerce_to_bytes(request.body))
+        else:
+            # In the event that the body is a file-like object, let's not try
+            # to read everything into memory.
+            bytearr.extend(b'<< Request body is not a string-like type >>')
+    bytearr.extend(b'\r\n')
+
+
+def _dump_response_data(response, prefixes, bytearr):
+    prefix = prefixes.response
+    # Let's interact almost entirely with urllib3's response
+    raw = response.raw
+
+    # Let's convert the version int from httplib to bytes
+    version_str = HTTP_VERSIONS.get(raw.version, b'?')
+
+    # <prefix>HTTP/<version_str> <status_code> <reason>
+    bytearr.extend(prefix + b'HTTP/' + version_str + b' ' +
+                   str(raw.status).encode('ascii') + b' ' +
+                   _coerce_to_bytes(response.reason) + b'\r\n')
+
+    headers = raw.headers
+    for name in headers.keys():
+        for value in headers.getlist(name):
+            bytearr.extend(prefix + _format_header(name, value))
+
+    bytearr.extend(prefix + b'\r\n')
+
+    bytearr.extend(response.content)
+
+
+def _coerce_to_bytes(data):
+    if not isinstance(data, bytes) and hasattr(data, 'encode'):
+        data = data.encode('utf-8')
+    # Don't bail out with an exception if data is None
+    return data if data is not None else b''
+
+
+def dump_response(response, request_prefix=b'< ', response_prefix=b'> ',
+                  data_array=None):
+    """Dump a single request-response cycle's information.
+
+    This will take a response object and dump only the data that requests can
+    see for that single request-response cycle.
+
+    Example::
+
+        import requests
+        from requests_toolbelt.utils import dump
+
+        resp = requests.get('https://api.github.com/users/sigmavirus24')
+        data = dump.dump_response(resp)
+        print(data.decode('utf-8'))
+
+    :param response:
+        The response to format
+    :type response: :class:`requests.Response`
+    :param request_prefix: (*optional*)
+        Bytes to prefix each line of the request data
+    :type request_prefix: :class:`bytes`
+    :param response_prefix: (*optional*)
+        Bytes to prefix each line of the response data
+    :type response_prefix: :class:`bytes`
+    :param data_array: (*optional*)
+        Bytearray to which we append the request-response cycle data
+    :type data_array: :class:`bytearray`
+    :returns: Formatted bytes of request and response information.
+    :rtype: :class:`bytearray`
+    """
+    data = data_array if data_array is not None else bytearray()
+    prefixes = PrefixSettings(request_prefix, response_prefix)
+
+    if not hasattr(response, 'request'):
+        raise ValueError('Response has no associated request')
+
+    proxy_info = _get_proxy_information(response)
+    _dump_request_data(response.request, prefixes, data,
+                       proxy_info=proxy_info)
+    _dump_response_data(response, prefixes, data)
+    return data
+
+
+def dump_all(response, request_prefix=b'< ', response_prefix=b'> '):
+    """Dump all requests and responses including redirects.
+
+    This takes the response returned by requests and will dump all
+    request-response pairs in the redirect history in order followed by the
+    final request-response.
+
+    Example::
+
+        import requests
+        from requests_toolbelt.utils import dump
+
+        resp = requests.get('https://httpbin.org/redirect/5')
+        data = dump.dump_all(resp)
+        print(data.decode('utf-8'))
+
+    :param response:
+        The response to format
+    :type response: :class:`requests.Response`
+    :param request_prefix: (*optional*)
+        Bytes to prefix each line of the request data
+    :type request_prefix: :class:`bytes`
+    :param response_prefix: (*optional*)
+        Bytes to prefix each line of the response data
+    :type response_prefix: :class:`bytes`
+    :returns: Formatted bytes of request and response information.
+    :rtype: :class:`bytearray`
+    """
+    data = bytearray()
+
+    history = list(response.history[:])
+    history.append(response)
+
+    for response in history:
+        dump_response(response, request_prefix, response_prefix, data)
+
+    return data
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/formdata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/formdata.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0a909d24c175f63e133f1cfb64adf90154afca6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/formdata.py
@@ -0,0 +1,108 @@
+# -*- coding: utf-8 -*-
+"""Implementation of nested form-data encoding function(s)."""
+from .._compat import basestring
+from .._compat import urlencode as _urlencode
+
+
+__all__ = ('urlencode',)
+
+
+def urlencode(query, *args, **kwargs):
+    """Handle nested form-data queries and serialize them appropriately.
+
+    There are times when a website expects a nested form data query to be sent
+    but, the standard library's urlencode function does not appropriately
+    handle the nested structures. In that case, you need this function which
+    will flatten the structure first and then properly encode it for you.
+
+    When using this to send data in the body of a request, make sure you
+    specify the appropriate Content-Type header for the request.
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.utils import formdata
+
+        query = {
+           'my_dict': {
+               'foo': 'bar',
+               'biz': 'baz",
+            },
+            'a': 'b',
+        }
+
+        resp = requests.get(url, params=formdata.urlencode(query))
+        # or
+        resp = requests.post(
+            url,
+            data=formdata.urlencode(query),
+            headers={
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+        )
+
+    Similarly, you can specify a list of nested tuples, e.g.,
+
+    .. code-block:: python
+
+        import requests
+        from requests_toolbelt.utils import formdata
+
+        query = [
+            ('my_list', [
+                ('foo', 'bar'),
+                ('biz', 'baz'),
+            ]),
+            ('a', 'b'),
+        ]
+
+        resp = requests.get(url, params=formdata.urlencode(query))
+        # or
+        resp = requests.post(
+            url,
+            data=formdata.urlencode(query),
+            headers={
+                'Content-Type': 'application/x-www-form-urlencoded'
+            },
+        )
+
+    For additional parameter and return information, see the official
+    `urlencode`_ documentation.
+
+    .. _urlencode:
+        https://docs.python.org/3/library/urllib.parse.html#urllib.parse.urlencode
+    """
+    expand_classes = (dict, list, tuple)
+    original_query_list = _to_kv_list(query)
+
+    if not all(_is_two_tuple(i) for i in original_query_list):
+        raise ValueError("Expected query to be able to be converted to a "
+                         "list comprised of length 2 tuples.")
+
+    query_list = original_query_list
+    while any(isinstance(v, expand_classes) for _, v in query_list):
+        query_list = _expand_query_values(query_list)
+
+    return _urlencode(query_list, *args, **kwargs)
+
+
+def _to_kv_list(dict_or_list):
+    if hasattr(dict_or_list, 'items'):
+        return list(dict_or_list.items())
+    return dict_or_list
+
+
+def _is_two_tuple(item):
+    return isinstance(item, (list, tuple)) and len(item) == 2
+
+
+def _expand_query_values(original_query_list):
+    query_list = []
+    for key, value in original_query_list:
+        if isinstance(value, basestring):
+            query_list.append((key, value))
+        else:
+            key_fmt = key + '[%s]'
+            value_list = _to_kv_list(value)
+            query_list.extend((key_fmt % k, v) for k, v in value_list)
+    return query_list
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/user_agent.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/user_agent.py
new file mode 100644
index 0000000000000000000000000000000000000000..e9636a41c802e6680e429207515e336a44f8dbbc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/requests_toolbelt/utils/user_agent.py
@@ -0,0 +1,143 @@
+# -*- coding: utf-8 -*-
+import collections
+import platform
+import sys
+
+
+def user_agent(name, version, extras=None):
+    """Return an internet-friendly user_agent string.
+
+    The majority of this code has been wilfully stolen from the equivalent
+    function in Requests.
+
+    :param name: The intended name of the user-agent, e.g. "python-requests".
+    :param version: The version of the user-agent, e.g. "0.0.1".
+    :param extras: List of two-item tuples that are added to the user-agent
+        string.
+    :returns: Formatted user-agent string
+    :rtype: str
+    """
+    if extras is None:
+        extras = []
+
+    return UserAgentBuilder(
+            name, version
+        ).include_extras(
+            extras
+        ).include_implementation(
+        ).include_system().build()
+
+
+class UserAgentBuilder(object):
+    """Class to provide a greater level of control than :func:`user_agent`.
+
+    This is used by :func:`user_agent` to build its User-Agent string.
+
+    .. code-block:: python
+
+        user_agent_str = UserAgentBuilder(
+                name='requests-toolbelt',
+                version='17.4.0',
+            ).include_implementation(
+            ).include_system(
+            ).include_extras([
+                ('requests', '2.14.2'),
+                ('urllib3', '1.21.2'),
+            ]).build()
+
+    """
+
+    format_string = '%s/%s'
+
+    def __init__(self, name, version):
+        """Initialize our builder with the name and version of our user agent.
+
+        :param str name:
+            Name of our user-agent.
+        :param str version:
+            The version string for user-agent.
+        """
+        self._pieces = collections.deque([(name, version)])
+
+    def build(self):
+        """Finalize the User-Agent string.
+
+        :returns:
+            Formatted User-Agent string.
+        :rtype:
+            str
+        """
+        return " ".join([self.format_string % piece for piece in self._pieces])
+
+    def include_extras(self, extras):
+        """Include extra portions of the User-Agent.
+
+        :param list extras:
+            list of tuples of extra-name and extra-version
+        """
+        if any(len(extra) != 2 for extra in extras):
+            raise ValueError('Extras should be a sequence of two item tuples.')
+
+        self._pieces.extend(extras)
+        return self
+
+    def include_implementation(self):
+        """Append the implementation string to the user-agent string.
+
+        This adds the the information that you're using CPython 2.7.13 to the
+        User-Agent.
+        """
+        self._pieces.append(_implementation_tuple())
+        return self
+
+    def include_system(self):
+        """Append the information about the Operating System."""
+        self._pieces.append(_platform_tuple())
+        return self
+
+
+def _implementation_tuple():
+    """Return the tuple of interpreter name and version.
+
+    Returns a string that provides both the name and the version of the Python
+    implementation currently running. For example, on CPython 2.7.5 it will
+    return "CPython/2.7.5".
+
+    This function works best on CPython and PyPy: in particular, it probably
+    doesn't work for Jython or IronPython. Future investigation should be done
+    to work out the correct shape of the code for those platforms.
+    """
+    implementation = platform.python_implementation()
+
+    if implementation == 'CPython':
+        implementation_version = platform.python_version()
+    elif implementation == 'PyPy':
+        implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major,
+                                               sys.pypy_version_info.minor,
+                                               sys.pypy_version_info.micro)
+        if sys.pypy_version_info.releaselevel != 'final':
+            implementation_version = ''.join([
+                implementation_version, sys.pypy_version_info.releaselevel
+                ])
+    elif implementation == 'Jython':
+        implementation_version = platform.python_version()  # Complete Guess
+    elif implementation == 'IronPython':
+        implementation_version = platform.python_version()  # Complete Guess
+    else:
+        implementation_version = 'Unknown'
+
+    return (implementation, implementation_version)
+
+
+def _implementation_string():
+    return "%s/%s" % _implementation_tuple()
+
+
+def _platform_tuple():
+    try:
+        p_system = platform.system()
+        p_release = platform.release()
+    except IOError:
+        p_system = 'Unknown'
+        p_release = 'Unknown'
+    return (p_system, p_release)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..984b3fc8bfcc84be1df354237a6f6d9930a70c83
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/METADATA
@@ -0,0 +1,236 @@
+Metadata-Version: 2.1
+Name: retrying
+Version: 1.3.3
+Summary: Retrying
+Home-page: https://github.com/rholder/retrying
+Author: Ray Holder
+Author-email: UNKNOWN
+License: Apache 2.0
+Keywords: decorator decorators retry retrying exception exponential backoff
+Platform: UNKNOWN
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3.2
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+
+Retrying
+=========================
+.. image:: https://travis-ci.org/rholder/retrying.png?branch=master
+    :target: https://travis-ci.org/rholder/retrying
+
+.. image:: https://badge.fury.io/py/retrying.png
+    :target: https://pypi.python.org/pypi/retrying
+
+.. image:: https://pypip.in/d/retrying/badge.png
+    :target: https://pypi.python.org/pypi/retrying
+
+Retrying is an Apache 2.0 licensed general-purpose retrying library, written in
+Python, to simplify the task of adding retry behavior to just about anything.
+
+
+The simplest use case is retrying a flaky function whenever an Exception occurs
+until a value is returned.
+
+.. code-block:: python
+
+    import random
+    from retrying import retry
+
+    @retry
+    def do_something_unreliable():
+        if random.randint(0, 10) > 1:
+            raise IOError("Broken sauce, everything is hosed!!!111one")
+        else:
+            return "Awesome sauce!"
+
+    print do_something_unreliable()
+
+
+Features
+--------
+
+- Generic Decorator API
+- Specify stop condition (i.e. limit by number of attempts)
+- Specify wait condition (i.e. exponential backoff sleeping between attempts)
+- Customize retrying on Exceptions
+- Customize retrying on expected returned result
+
+
+Installation
+------------
+
+To install retrying, simply:
+
+.. code-block:: bash
+
+    $ pip install retrying
+
+Or, if you absolutely must:
+
+.. code-block:: bash
+
+    $ easy_install retrying
+
+But, you might regret that later.
+
+
+Examples
+----------
+
+As you saw above, the default behavior is to retry forever without waiting.
+
+.. code-block:: python
+
+    @retry
+    def never_give_up_never_surrender():
+        print "Retry forever ignoring Exceptions, don't wait between retries"
+
+
+Let's be a little less persistent and set some boundaries, such as the number of attempts before giving up.
+
+.. code-block:: python
+
+    @retry(stop_max_attempt_number=7)
+    def stop_after_7_attempts():
+        print "Stopping after 7 attempts"
+
+We don't have all day, so let's set a boundary for how long we should be retrying stuff.
+
+.. code-block:: python
+
+    @retry(stop_max_delay=10000)
+    def stop_after_10_s():
+        print "Stopping after 10 seconds"
+
+Most things don't like to be polled as fast as possible, so let's just wait 2 seconds between retries.
+
+.. code-block:: python
+
+    @retry(wait_fixed=2000)
+    def wait_2_s():
+        print "Wait 2 second between retries"
+
+
+Some things perform best with a bit of randomness injected.
+
+.. code-block:: python
+
+    @retry(wait_random_min=1000, wait_random_max=2000)
+    def wait_random_1_to_2_s():
+        print "Randomly wait 1 to 2 seconds between retries"
+
+Then again, it's hard to beat exponential backoff when retrying distributed services and other remote endpoints.
+
+.. code-block:: python
+
+    @retry(wait_exponential_multiplier=1000, wait_exponential_max=10000)
+    def wait_exponential_1000():
+        print "Wait 2^x * 1000 milliseconds between each retry, up to 10 seconds, then 10 seconds afterwards"
+
+
+We have a few options for dealing with retries that raise specific or general exceptions, as in the cases here.
+
+.. code-block:: python
+
+    def retry_if_io_error(exception):
+        """Return True if we should retry (in this case when it's an IOError), False otherwise"""
+        return isinstance(exception, IOError)
+
+    @retry(retry_on_exception=retry_if_io_error)
+    def might_io_error():
+        print "Retry forever with no wait if an IOError occurs, raise any other errors"
+
+    @retry(retry_on_exception=retry_if_io_error, wrap_exception=True)
+    def only_raise_retry_error_when_not_io_error():
+        print "Retry forever with no wait if an IOError occurs, raise any other errors wrapped in RetryError"
+
+We can also use the result of the function to alter the behavior of retrying.
+
+.. code-block:: python
+
+    def retry_if_result_none(result):
+        """Return True if we should retry (in this case when result is None), False otherwise"""
+        return result is None
+
+    @retry(retry_on_result=retry_if_result_none)
+    def might_return_none():
+        print "Retry forever ignoring Exceptions with no wait if return value is None"
+
+
+Any combination of stop, wait, etc. is also supported to give you the freedom to mix and match.
+
+Contribute
+----------
+
+#. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
+#. Fork `the repository`_ on GitHub to start making your changes to the **master** branch (or branch off of it).
+#. Write a test which shows that the bug was fixed or that the feature works as expected.
+#. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS_.
+
+.. _`the repository`: http://github.com/rholder/retrying
+.. _AUTHORS: https://github.com/rholder/retrying/blob/master/AUTHORS.rst
+
+
+.. :changelog:
+
+History
+-------
+1.3.3 (2014-12-14)
+++++++++++++++++++
+- Add minimum six version of 1.7.0 since anything less will break things
+
+1.3.2 (2014-11-09)
+++++++++++++++++++
+- Ensure we wrap the decorated functions to prevent information loss
+- Allow a jitter value to be passed in
+
+1.3.1 (2014-09-30)
+++++++++++++++++++
+- Add requirements.txt to MANIFEST.in to fix pip installs
+
+1.3.0 (2014-09-30)
+++++++++++++++++++
+- Add upstream six dependency, remove embedded six functionality
+
+1.2.3 (2014-08-25)
+++++++++++++++++++
+- Add support for custom wait and stop functions
+
+1.2.2 (2014-06-20)
+++++++++++++++++++
+- Bug fix to not raise a RetryError on failure when exceptions aren't being wrapped
+
+1.2.1 (2014-05-05)
+++++++++++++++++++
+- Bug fix for explicitly passing in a wait type
+
+1.2.0 (2014-05-04)
+++++++++++++++++++
+- Remove the need for explicit specification of stop/wait types when they can be inferred
+- Add a little checking for exception propagation
+
+1.1.0 (2014-03-31)
+++++++++++++++++++
+- Added proper exception propagation through reraising with Python 2.6, 2.7, and 3.2 compatibility
+- Update test suite for behavior changes
+
+1.0.1 (2013-03-20)
+++++++++++++++++++
+- Fixed a bug where classes not extending from the Python exception hierarchy could slip through
+- Update test suite for custom Python exceptions
+
+1.0.0 (2013-01-21)
+++++++++++++++++++
+- First stable, tested version now exists
+- Apache 2.0 license applied
+- Sanitizing some setup.py and test suite running
+- Added Travis CI support
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..6e26278ef51f48ca7f3bac1f7564ba18fdf1c48a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/RECORD
@@ -0,0 +1,11 @@
+retrying.py,sha256=VmHyyhLAnj7Eq9bklbKKDmjGMVCT6fu7EZsAAM4rzXU,9955
+retrying-1.3.3.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+retrying-1.3.3.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+retrying-1.3.3.dist-info/METADATA,sha256=B-eP4nBk0ZHdqnY1vYKJmEFKfGZ3sEBarFMFt2Ze0gQ,7095
+retrying-1.3.3.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+retrying-1.3.3.dist-info/top_level.txt,sha256=Aq_0tUMcxGxrQRe4aHi-VVSo2MPzZVLtT0pAxNLUs_E,9
+retrying-1.3.3.dist-info/RECORD,,
+retrying-1.3.3.dist-info/INSTALLER,,
+retrying-1.3.3.virtualenv,,
+retrying-1.3.3.dist-info/__pycache__,,
+retrying.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..16f59d32ee5ba4ab3f7efa37a152b218ba084df7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+retrying
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying-1.3.3.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ed312da22fc717c87714ee69665491d936ba744
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/retrying.py
@@ -0,0 +1,267 @@
+## Copyright 2013-2014 Ray Holder
+##
+## Licensed under the Apache License, Version 2.0 (the "License");
+## you may not use this file except in compliance with the License.
+## You may obtain a copy of the License at
+##
+## http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing, software
+## distributed under the License is distributed on an "AS IS" BASIS,
+## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+## See the License for the specific language governing permissions and
+## limitations under the License.
+
+import random
+import six
+import sys
+import time
+import traceback
+
+
+# sys.maxint / 2, since Python 3.2 doesn't have a sys.maxint...
+MAX_WAIT = 1073741823
+
+
+def retry(*dargs, **dkw):
+    """
+    Decorator function that instantiates the Retrying object
+    @param *dargs: positional arguments passed to Retrying object
+    @param **dkw: keyword arguments passed to the Retrying object
+    """
+    # support both @retry and @retry() as valid syntax
+    if len(dargs) == 1 and callable(dargs[0]):
+        def wrap_simple(f):
+
+            @six.wraps(f)
+            def wrapped_f(*args, **kw):
+                return Retrying().call(f, *args, **kw)
+
+            return wrapped_f
+
+        return wrap_simple(dargs[0])
+
+    else:
+        def wrap(f):
+
+            @six.wraps(f)
+            def wrapped_f(*args, **kw):
+                return Retrying(*dargs, **dkw).call(f, *args, **kw)
+
+            return wrapped_f
+
+        return wrap
+
+
+class Retrying(object):
+
+    def __init__(self,
+                 stop=None, wait=None,
+                 stop_max_attempt_number=None,
+                 stop_max_delay=None,
+                 wait_fixed=None,
+                 wait_random_min=None, wait_random_max=None,
+                 wait_incrementing_start=None, wait_incrementing_increment=None,
+                 wait_exponential_multiplier=None, wait_exponential_max=None,
+                 retry_on_exception=None,
+                 retry_on_result=None,
+                 wrap_exception=False,
+                 stop_func=None,
+                 wait_func=None,
+                 wait_jitter_max=None):
+
+        self._stop_max_attempt_number = 5 if stop_max_attempt_number is None else stop_max_attempt_number
+        self._stop_max_delay = 100 if stop_max_delay is None else stop_max_delay
+        self._wait_fixed = 1000 if wait_fixed is None else wait_fixed
+        self._wait_random_min = 0 if wait_random_min is None else wait_random_min
+        self._wait_random_max = 1000 if wait_random_max is None else wait_random_max
+        self._wait_incrementing_start = 0 if wait_incrementing_start is None else wait_incrementing_start
+        self._wait_incrementing_increment = 100 if wait_incrementing_increment is None else wait_incrementing_increment
+        self._wait_exponential_multiplier = 1 if wait_exponential_multiplier is None else wait_exponential_multiplier
+        self._wait_exponential_max = MAX_WAIT if wait_exponential_max is None else wait_exponential_max
+        self._wait_jitter_max = 0 if wait_jitter_max is None else wait_jitter_max
+
+        # TODO add chaining of stop behaviors
+        # stop behavior
+        stop_funcs = []
+        if stop_max_attempt_number is not None:
+            stop_funcs.append(self.stop_after_attempt)
+
+        if stop_max_delay is not None:
+            stop_funcs.append(self.stop_after_delay)
+
+        if stop_func is not None:
+            self.stop = stop_func
+
+        elif stop is None:
+            self.stop = lambda attempts, delay: any(f(attempts, delay) for f in stop_funcs)
+
+        else:
+            self.stop = getattr(self, stop)
+
+        # TODO add chaining of wait behaviors
+        # wait behavior
+        wait_funcs = [lambda *args, **kwargs: 0]
+        if wait_fixed is not None:
+            wait_funcs.append(self.fixed_sleep)
+
+        if wait_random_min is not None or wait_random_max is not None:
+            wait_funcs.append(self.random_sleep)
+
+        if wait_incrementing_start is not None or wait_incrementing_increment is not None:
+            wait_funcs.append(self.incrementing_sleep)
+
+        if wait_exponential_multiplier is not None or wait_exponential_max is not None:
+            wait_funcs.append(self.exponential_sleep)
+
+        if wait_func is not None:
+            self.wait = wait_func
+
+        elif wait is None:
+            self.wait = lambda attempts, delay: max(f(attempts, delay) for f in wait_funcs)
+
+        else:
+            self.wait = getattr(self, wait)
+
+        # retry on exception filter
+        if retry_on_exception is None:
+            self._retry_on_exception = self.always_reject
+        else:
+            self._retry_on_exception = retry_on_exception
+
+        # TODO simplify retrying by Exception types
+        # retry on result filter
+        if retry_on_result is None:
+            self._retry_on_result = self.never_reject
+        else:
+            self._retry_on_result = retry_on_result
+
+        self._wrap_exception = wrap_exception
+
+    def stop_after_attempt(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """Stop after the previous attempt >= stop_max_attempt_number."""
+        return previous_attempt_number >= self._stop_max_attempt_number
+
+    def stop_after_delay(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """Stop after the time from the first attempt >= stop_max_delay."""
+        return delay_since_first_attempt_ms >= self._stop_max_delay
+
+    def no_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """Don't sleep at all before retrying."""
+        return 0
+
+    def fixed_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """Sleep a fixed amount of time between each retry."""
+        return self._wait_fixed
+
+    def random_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """Sleep a random amount of time between wait_random_min and wait_random_max"""
+        return random.randint(self._wait_random_min, self._wait_random_max)
+
+    def incrementing_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
+        """
+        Sleep an incremental amount of time after each attempt, starting at
+        wait_incrementing_start and incrementing by wait_incrementing_increment
+        """
+        result = self._wait_incrementing_start + (self._wait_incrementing_increment * (previous_attempt_number - 1))
+        if result < 0:
+            result = 0
+        return result
+
+    def exponential_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
+        exp = 2 ** previous_attempt_number
+        result = self._wait_exponential_multiplier * exp
+        if result > self._wait_exponential_max:
+            result = self._wait_exponential_max
+        if result < 0:
+            result = 0
+        return result
+
+    def never_reject(self, result):
+        return False
+
+    def always_reject(self, result):
+        return True
+
+    def should_reject(self, attempt):
+        reject = False
+        if attempt.has_exception:
+            reject |= self._retry_on_exception(attempt.value[1])
+        else:
+            reject |= self._retry_on_result(attempt.value)
+
+        return reject
+
+    def call(self, fn, *args, **kwargs):
+        start_time = int(round(time.time() * 1000))
+        attempt_number = 1
+        while True:
+            try:
+                attempt = Attempt(fn(*args, **kwargs), attempt_number, False)
+            except:
+                tb = sys.exc_info()
+                attempt = Attempt(tb, attempt_number, True)
+
+            if not self.should_reject(attempt):
+                return attempt.get(self._wrap_exception)
+
+            delay_since_first_attempt_ms = int(round(time.time() * 1000)) - start_time
+            if self.stop(attempt_number, delay_since_first_attempt_ms):
+                if not self._wrap_exception and attempt.has_exception:
+                    # get() on an attempt with an exception should cause it to be raised, but raise just in case
+                    raise attempt.get()
+                else:
+                    raise RetryError(attempt)
+            else:
+                sleep = self.wait(attempt_number, delay_since_first_attempt_ms)
+                if self._wait_jitter_max:
+                    jitter = random.random() * self._wait_jitter_max
+                    sleep = sleep + max(0, jitter)
+                time.sleep(sleep / 1000.0)
+
+            attempt_number += 1
+
+
+class Attempt(object):
+    """
+    An Attempt encapsulates a call to a target function that may end as a
+    normal return value from the function or an Exception depending on what
+    occurred during the execution.
+    """
+
+    def __init__(self, value, attempt_number, has_exception):
+        self.value = value
+        self.attempt_number = attempt_number
+        self.has_exception = has_exception
+
+    def get(self, wrap_exception=False):
+        """
+        Return the return value of this Attempt instance or raise an Exception.
+        If wrap_exception is true, this Attempt is wrapped inside of a
+        RetryError before being raised.
+        """
+        if self.has_exception:
+            if wrap_exception:
+                raise RetryError(self)
+            else:
+                six.reraise(self.value[0], self.value[1], self.value[2])
+        else:
+            return self.value
+
+    def __repr__(self):
+        if self.has_exception:
+            return "Attempts: {0}, Error:\n{1}".format(self.attempt_number, "".join(traceback.format_tb(self.value[2])))
+        else:
+            return "Attempts: {0}, Value: {1}".format(self.attempt_number, self.value)
+
+
+class RetryError(Exception):
+    """
+    A RetryError encapsulates the last Attempt instance right before giving up.
+    """
+
+    def __init__(self, last_attempt):
+        self.last_attempt = last_attempt
+
+    def __str__(self):
+        return "RetryError[{0}]".format(self.last_attempt)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..4adf953086ea4e28c5236788234f38f88602296f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/METADATA
@@ -0,0 +1,82 @@
+Metadata-Version: 2.1
+Name: setuptools
+Version: 44.0.0
+Summary: Easily download, build, install, upgrade, and uninstall Python packages
+Home-page: https://github.com/pypa/setuptools
+Author: Python Packaging Authority
+Author-email: distutils-sig@python.org
+License: UNKNOWN
+Project-URL: Documentation, https://setuptools.readthedocs.io/
+Keywords: CPAN PyPI distutils eggs package management
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
+Description-Content-Type: text/x-rst; charset=UTF-8
+
+.. image:: https://img.shields.io/pypi/v/setuptools.svg
+   :target: https://pypi.org/project/setuptools
+
+.. image:: https://img.shields.io/readthedocs/setuptools/latest.svg
+    :target: https://setuptools.readthedocs.io
+
+.. image:: https://img.shields.io/travis/pypa/setuptools/master.svg?label=Linux%20CI&logo=travis&logoColor=white
+   :target: https://travis-ci.org/pypa/setuptools
+
+.. image:: https://img.shields.io/appveyor/ci/pypa/setuptools/master.svg?label=Windows%20CI&logo=appveyor&logoColor=white
+   :target: https://ci.appveyor.com/project/pypa/setuptools/branch/master
+
+.. image:: https://img.shields.io/codecov/c/github/pypa/setuptools/master.svg?logo=codecov&logoColor=white
+   :target: https://codecov.io/gh/pypa/setuptools
+
+.. image:: https://tidelift.com/badges/github/pypa/setuptools?style=flat
+   :target: https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=readme
+
+.. image:: https://img.shields.io/pypi/pyversions/setuptools.svg
+
+See the `Installation Instructions
+<https://packaging.python.org/installing/>`_ in the Python Packaging
+User's Guide for instructions on installing, upgrading, and uninstalling
+Setuptools.
+
+Questions and comments should be directed to the `distutils-sig
+mailing list <http://mail.python.org/pipermail/distutils-sig/>`_.
+Bug reports and especially tested patches may be
+submitted directly to the `bug tracker
+<https://github.com/pypa/setuptools/issues>`_.
+
+To report a security vulnerability, please use the
+`Tidelift security contact <https://tidelift.com/security>`_.
+Tidelift will coordinate the fix and disclosure.
+
+
+For Enterprise
+==============
+
+Available as part of the Tidelift Subscription.
+
+Setuptools and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
+
+`Learn more <https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=referral&utm_campaign=github>`_.
+
+Code of Conduct
+===============
+
+Everyone interacting in the setuptools project's codebases, issue trackers,
+chat rooms, and mailing lists is expected to follow the
+`PyPA Code of Conduct <https://www.pypa.io/en/latest/code-of-conduct/>`_.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c4b06c17458276c58daeb715b7c49369c1abaa24
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/RECORD
@@ -0,0 +1,171 @@
+easy_install.py,sha256=MDC9vt5AxDsXX5qcKlBz2TnW6Tpuv_AobnfhCJ9X3PM,126
+setuptools/__init__.py,sha256=WBpCcn2lvdckotabeae1TTYonPOcgCIF3raD2zRWzBc,7283
+setuptools/_deprecation_warning.py,sha256=jU9-dtfv6cKmtQJOXN8nP1mm7gONw5kKEtiPtbwnZyI,218
+setuptools/_imp.py,sha256=jloslOkxrTKbobgemfP94YII0nhqiJzE1bRmCTZ1a5I,2223
+setuptools/archive_util.py,sha256=kw8Ib_lKjCcnPKNbS7h8HztRVK0d5RacU3r_KRdVnmM,6592
+setuptools/build_meta.py,sha256=-9Nmj9YdbW4zX3TssPJZhsENrTa4fw3k86Jm1cdKMik,9597
+setuptools/cli-32.exe,sha256=dfEuovMNnA2HLa3jRfMPVi5tk4R7alCbpTvuxtCyw0Y,65536
+setuptools/cli-64.exe,sha256=KLABu5pyrnokJCv6skjXZ6GsXeyYHGcqOUT3oHI3Xpo,74752
+setuptools/cli.exe,sha256=dfEuovMNnA2HLa3jRfMPVi5tk4R7alCbpTvuxtCyw0Y,65536
+setuptools/config.py,sha256=6SB2OY3qcooOJmG_rsK_s0pKBsorBlDpfMJUyzjQIGk,20575
+setuptools/dep_util.py,sha256=fgixvC1R7sH3r13ktyf7N0FALoqEXL1cBarmNpSEoWg,935
+setuptools/depends.py,sha256=qt2RWllArRvhnm8lxsyRpcthEZYp4GHQgREl1q0LkFw,5517
+setuptools/dist.py,sha256=xtXaNsOsE32MwwQqErzgXJF7jsTQz9GYFRrwnPFQ0J0,49865
+setuptools/errors.py,sha256=MVOcv381HNSajDgEUWzOQ4J6B5BHCBMSjHfaWcEwA1o,524
+setuptools/extension.py,sha256=uc6nHI-MxwmNCNPbUiBnybSyqhpJqjbhvOQ-emdvt_E,1729
+setuptools/glob.py,sha256=o75cHrOxYsvn854thSxE0x9k8JrKDuhP_rRXlVB00Q4,5084
+setuptools/gui-32.exe,sha256=XBr0bHMA6Hpz2s9s9Bzjl-PwXfa9nH4ie0rFn4V2kWA,65536
+setuptools/gui-64.exe,sha256=aYKMhX1IJLn4ULHgWX0sE0yREUt6B3TEHf_jOw6yNyE,75264
+setuptools/gui.exe,sha256=XBr0bHMA6Hpz2s9s9Bzjl-PwXfa9nH4ie0rFn4V2kWA,65536
+setuptools/installer.py,sha256=TCFRonRo01I79zo-ucf3Ymhj8TenPlmhMijN916aaJs,5337
+setuptools/launch.py,sha256=sd7ejwhBocCDx_wG9rIs0OaZ8HtmmFU8ZC6IR_S0Lvg,787
+setuptools/lib2to3_ex.py,sha256=t5e12hbR2pi9V4ezWDTB4JM-AISUnGOkmcnYHek3xjg,2013
+setuptools/monkey.py,sha256=FGc9fffh7gAxMLFmJs2DW_OYWpBjkdbNS2n14UAK4NA,5264
+setuptools/msvc.py,sha256=8baJ6aYgCA4TRdWQQi185qB9dnU8FaP4wgpbmd7VODs,46751
+setuptools/namespaces.py,sha256=F0Nrbv8KCT2OrO7rwa03om4N4GZKAlnce-rr-cgDQa8,3199
+setuptools/package_index.py,sha256=6pb-B1POtHyLycAbkDETk4fO-Qv8_sY-rjTXhUOoh6k,40605
+setuptools/py27compat.py,sha256=tvmer0Tn-wk_JummCkoM22UIjpjL-AQ8uUiOaqTs8sI,1496
+setuptools/py31compat.py,sha256=h2rtZghOfwoGYd8sQ0-auaKiF3TcL3qX0bX3VessqcE,838
+setuptools/py33compat.py,sha256=SMF9Z8wnGicTOkU1uRNwZ_kz5Z_bj29PUBbqdqeeNsc,1330
+setuptools/py34compat.py,sha256=KYOd6ybRxjBW8NJmYD8t_UyyVmysppFXqHpFLdslGXU,245
+setuptools/sandbox.py,sha256=9UbwfEL5QY436oMI1LtFWohhoZ-UzwHvGyZjUH_qhkw,14276
+setuptools/script (dev).tmpl,sha256=RUzQzCQUaXtwdLtYHWYbIQmOaES5Brqq1FvUA_tu-5I,218
+setuptools/script.tmpl,sha256=WGTt5piezO27c-Dbx6l5Q4T3Ff20A5z7872hv3aAhYY,138
+setuptools/site-patch.py,sha256=OumkIHMuoSenRSW1382kKWI1VAwxNE86E5W8iDd34FY,2302
+setuptools/ssl_support.py,sha256=nLjPUBBw7RTTx6O4RJZ5eAMGgjJG8beiDbkFXDZpLuM,8493
+setuptools/unicode_utils.py,sha256=NOiZ_5hD72A6w-4wVj8awHFM3n51Kmw1Ic_vx15XFqw,996
+setuptools/version.py,sha256=og_cuZQb0QI6ukKZFfZWPlr1HgJBPPn2vO2m_bI9ZTE,144
+setuptools/wheel.py,sha256=zct-SEj5_LoHg6XELt2cVRdulsUENenCdS1ekM7TlZA,8455
+setuptools/windows_support.py,sha256=5GrfqSP2-dLGJoZTq2g6dCKkyQxxa2n5IQiXlJCoYEE,714
+setuptools/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+setuptools/_vendor/ordered_set.py,sha256=dbaCcs27dyN9gnMWGF5nA_BrVn6Q-NrjKYJpV9_fgBs,15130
+setuptools/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055
+setuptools/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098
+setuptools/_vendor/packaging/__about__.py,sha256=CpuMSyh1V7adw8QMjWKkY3LtdqRUkRX4MgJ6nF4stM0,744
+setuptools/_vendor/packaging/__init__.py,sha256=6enbp5XgRfjBjsI9-bn00HjHf5TH21PDMOKkJW8xw-w,562
+setuptools/_vendor/packaging/_compat.py,sha256=Ugdm-qcneSchW25JrtMIKgUxfEEBcCAz6WrEeXeqz9o,865
+setuptools/_vendor/packaging/_structures.py,sha256=pVd90XcXRGwpZRB_qdFuVEibhCHpX_bL5zYr9-N0mc8,1416
+setuptools/_vendor/packaging/markers.py,sha256=-meFl9Fr9V8rF5Rduzgett5EHK9wBYRUqssAV2pj0lw,8268
+setuptools/_vendor/packaging/requirements.py,sha256=3dwIJekt8RRGCUbgxX8reeAbgmZYjb0wcCRtmH63kxI,4742
+setuptools/_vendor/packaging/specifiers.py,sha256=0ZzQpcUnvrQ6LjR-mQRLzMr8G6hdRv-mY0VSf_amFtI,27778
+setuptools/_vendor/packaging/tags.py,sha256=EPLXhO6GTD7_oiWEO1U0l0PkfR8R_xivpMDHXnsTlts,12933
+setuptools/_vendor/packaging/utils.py,sha256=VaTC0Ei7zO2xl9ARiWmz2YFLFt89PuuhLbAlXMyAGms,1520
+setuptools/_vendor/packaging/version.py,sha256=Npdwnb8OHedj_2L86yiUqscujb7w_i5gmSK1PhOAFzg,11978
+setuptools/command/__init__.py,sha256=QCAuA9whnq8Bnoc0bBaS6Lw_KAUO0DiHYZQXEMNn5hg,568
+setuptools/command/alias.py,sha256=KjpE0sz_SDIHv3fpZcIQK-sCkJz-SrC6Gmug6b9Nkc8,2426
+setuptools/command/bdist_egg.py,sha256=nnfV8Ah8IRC_Ifv5Loa9FdxL66MVbyDXwy-foP810zM,18185
+setuptools/command/bdist_rpm.py,sha256=B7l0TnzCGb-0nLlm6rS00jWLkojASwVmdhW2w5Qz_Ak,1508
+setuptools/command/bdist_wininst.py,sha256=_6dz3lpB1tY200LxKPLM7qgwTCceOMgaWFF-jW2-pm0,637
+setuptools/command/build_clib.py,sha256=bQ9aBr-5ZSO-9fGsGsDLz0mnnFteHUZnftVLkhvHDq0,4484
+setuptools/command/build_ext.py,sha256=Ib42YUGksBswm2mL5xmQPF6NeTA6HcqrvAtEgFCv32A,13019
+setuptools/command/build_py.py,sha256=yWyYaaS9F3o9JbIczn064A5g1C5_UiKRDxGaTqYbtLE,9596
+setuptools/command/develop.py,sha256=MQlnGS6uP19erK2JCNOyQYoYyquk3PADrqrrinqqLtA,8184
+setuptools/command/dist_info.py,sha256=5t6kOfrdgALT-P3ogss6PF9k-Leyesueycuk3dUyZnI,960
+setuptools/command/easy_install.py,sha256=0lY8Agxe-7IgMtxgxFuOY1NrDlBzOUlpCKsvayXlTYY,89903
+setuptools/command/egg_info.py,sha256=0e_TXrMfpa8nGTO7GmJcmpPCMWzliZi6zt9aMchlumc,25578
+setuptools/command/install.py,sha256=8doMxeQEDoK4Eco0mO2WlXXzzp9QnsGJQ7Z7yWkZPG8,4705
+setuptools/command/install_egg_info.py,sha256=4zq_Ad3jE-EffParuyDEnvxU6efB-Xhrzdr8aB6Ln_8,3195
+setuptools/command/install_lib.py,sha256=9zdc-H5h6RPxjySRhOwi30E_WfcVva7gpfhZ5ata60w,5023
+setuptools/command/install_scripts.py,sha256=UD0rEZ6861mTYhIdzcsqKnUl8PozocXWl9VBQ1VTWnc,2439
+setuptools/command/launcher manifest.xml,sha256=xlLbjWrB01tKC0-hlVkOKkiSPbzMml2eOPtJ_ucCnbE,628
+setuptools/command/py36compat.py,sha256=SzjZcOxF7zdFUT47Zv2n7AM3H8koDys_0OpS-n9gIfc,4986
+setuptools/command/register.py,sha256=kk3DxXCb5lXTvqnhfwx2g6q7iwbUmgTyXUCaBooBOUk,468
+setuptools/command/rotate.py,sha256=co5C1EkI7P0GGT6Tqz-T2SIj2LBJTZXYELpmao6d4KQ,2164
+setuptools/command/saveopts.py,sha256=za7QCBcQimKKriWcoCcbhxPjUz30gSB74zuTL47xpP4,658
+setuptools/command/sdist.py,sha256=IL1LepD2h8qGKOFJ3rrQVbjNH_Q6ViD40l0QADr4MEU,8088
+setuptools/command/setopt.py,sha256=NTWDyx-gjDF-txf4dO577s7LOzHVoKR0Mq33rFxaRr8,5085
+setuptools/command/test.py,sha256=u2kXngIIdSYqtvwFlHiN6Iye1IB4TU6uadB2uiV1szw,9602
+setuptools/command/upload.py,sha256=XT3YFVfYPAmA5qhGg0euluU98ftxRUW-PzKcODMLxUs,462
+setuptools/command/upload_docs.py,sha256=oXiGplM_cUKLwE4CWWw98RzCufAu8tBhMC97GegFcms,7311
+setuptools/extern/__init__.py,sha256=4q9gtShB1XFP6CisltsyPqtcfTO6ZM9Lu1QBl3l-qmo,2514
+setuptools-44.0.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+setuptools-44.0.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+setuptools-44.0.0.dist-info/METADATA,sha256=L93fcafgVw4xoJUNG0lehyy0prVj-jU_JFxRh0ZUtos,3523
+setuptools-44.0.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+setuptools-44.0.0.dist-info/dependency_links.txt,sha256=HlkCFkoK5TbZ5EMLbLKYhLcY_E31kBWD8TqW2EgmatQ,239
+setuptools-44.0.0.dist-info/entry_points.txt,sha256=ZmIqlp-SBdsBS2cuetmU2NdSOs4DG0kxctUR9UJ8Xk0,3150
+setuptools-44.0.0.dist-info/top_level.txt,sha256=2HUXVVwA4Pff1xgTFr3GsTXXKaPaO6vlG6oNJ_4u4Tg,38
+setuptools-44.0.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+setuptools-44.0.0.dist-info/RECORD,,
+setuptools/sandbox.cpython-38.pyc,,
+setuptools/archive_util.cpython-38.pyc,,
+setuptools/msvc.cpython-38.pyc,,
+setuptools/version.cpython-38.pyc,,
+setuptools-44.0.0.virtualenv,,
+../../../bin/easy_install,,
+setuptools/__pycache__,,
+setuptools/dist.cpython-38.pyc,,
+setuptools/extern/__pycache__,,
+setuptools/extension.cpython-38.pyc,,
+setuptools/namespaces.cpython-38.pyc,,
+setuptools/command/build_ext.cpython-38.pyc,,
+setuptools/command/build_py.cpython-38.pyc,,
+setuptools/_vendor/ordered_set.cpython-38.pyc,,
+setuptools/command/egg_info.cpython-38.pyc,,
+setuptools/_vendor/packaging/version.cpython-38.pyc,,
+setuptools/command/bdist_rpm.cpython-38.pyc,,
+setuptools/_vendor/__pycache__,,
+easy_install.cpython-38.pyc,,
+setuptools/_vendor/packaging/__pycache__,,
+setuptools/glob.cpython-38.pyc,,
+setuptools/command/__init__.cpython-38.pyc,,
+setuptools/_vendor/packaging/utils.cpython-38.pyc,,
+setuptools/py34compat.cpython-38.pyc,,
+setuptools/windows_support.cpython-38.pyc,,
+setuptools/launch.cpython-38.pyc,,
+setuptools/command/setopt.cpython-38.pyc,,
+setuptools/build_meta.cpython-38.pyc,,
+setuptools/ssl_support.cpython-38.pyc,,
+setuptools/_vendor/packaging/_compat.cpython-38.pyc,,
+setuptools/installer.cpython-38.pyc,,
+setuptools/_vendor/pyparsing.cpython-38.pyc,,
+setuptools/site-patch.cpython-38.pyc,,
+setuptools/command/test.cpython-38.pyc,,
+setuptools/command/bdist_wininst.cpython-38.pyc,,
+setuptools/depends.cpython-38.pyc,,
+setuptools-44.0.0.dist-info/__pycache__,,
+setuptools/command/py36compat.cpython-38.pyc,,
+setuptools/_vendor/packaging/markers.cpython-38.pyc,,
+../../../bin/easy_install3,,
+setuptools/command/build_clib.cpython-38.pyc,,
+setuptools/config.cpython-38.pyc,,
+setuptools/errors.cpython-38.pyc,,
+setuptools/command/install_lib.cpython-38.pyc,,
+setuptools-44.0.0.dist-info/INSTALLER,,
+setuptools/command/alias.cpython-38.pyc,,
+setuptools/unicode_utils.cpython-38.pyc,,
+setuptools/_imp.cpython-38.pyc,,
+setuptools/__init__.cpython-38.pyc,,
+setuptools/extern/__init__.cpython-38.pyc,,
+setuptools/command/install_scripts.cpython-38.pyc,,
+setuptools/wheel.cpython-38.pyc,,
+setuptools/command/dist_info.cpython-38.pyc,,
+setuptools/command/develop.cpython-38.pyc,,
+setuptools/py27compat.cpython-38.pyc,,
+setuptools/command/bdist_egg.cpython-38.pyc,,
+../../../bin/easy_install-3.8,,
+setuptools/package_index.cpython-38.pyc,,
+setuptools/monkey.cpython-38.pyc,,
+setuptools/_vendor/packaging/specifiers.cpython-38.pyc,,
+setuptools/command/install.cpython-38.pyc,,
+setuptools/_vendor/packaging/_structures.cpython-38.pyc,,
+setuptools/_vendor/__init__.cpython-38.pyc,,
+setuptools/_vendor/packaging/__init__.cpython-38.pyc,,
+setuptools/command/rotate.cpython-38.pyc,,
+setuptools/command/upload_docs.cpython-38.pyc,,
+setuptools/py31compat.cpython-38.pyc,,
+setuptools/_deprecation_warning.cpython-38.pyc,,
+setuptools/dep_util.cpython-38.pyc,,
+setuptools/command/install_egg_info.cpython-38.pyc,,
+setuptools/command/easy_install.cpython-38.pyc,,
+setuptools/lib2to3_ex.cpython-38.pyc,,
+setuptools/command/saveopts.cpython-38.pyc,,
+setuptools/_vendor/six.cpython-38.pyc,,
+setuptools/_vendor/packaging/requirements.cpython-38.pyc,,
+setuptools/_vendor/packaging/__about__.cpython-38.pyc,,
+setuptools/command/register.cpython-38.pyc,,
+setuptools/command/upload.cpython-38.pyc,,
+setuptools/command/sdist.cpython-38.pyc,,
+setuptools/command/__pycache__,,
+setuptools/_vendor/packaging/tags.cpython-38.pyc,,
+setuptools/py33compat.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e87d02103ede91545d70783dd59653d183424b68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/dependency_links.txt
@@ -0,0 +1,2 @@
+https://files.pythonhosted.org/packages/source/c/certifi/certifi-2016.9.26.tar.gz#md5=baa81e951a29958563689d868ef1064d
+https://files.pythonhosted.org/packages/source/w/wincertstore/wincertstore-0.2.zip#md5=ae728f2f007185648d0c7a8679b361e2
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..0fed3f1d83f3eb690dddad3f050da3d3f021eb6a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/entry_points.txt
@@ -0,0 +1,68 @@
+[console_scripts]
+easy_install = setuptools.command.easy_install:main
+
+[distutils.commands]
+alias = setuptools.command.alias:alias
+bdist_egg = setuptools.command.bdist_egg:bdist_egg
+bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm
+bdist_wininst = setuptools.command.bdist_wininst:bdist_wininst
+build_clib = setuptools.command.build_clib:build_clib
+build_ext = setuptools.command.build_ext:build_ext
+build_py = setuptools.command.build_py:build_py
+develop = setuptools.command.develop:develop
+dist_info = setuptools.command.dist_info:dist_info
+easy_install = setuptools.command.easy_install:easy_install
+egg_info = setuptools.command.egg_info:egg_info
+install = setuptools.command.install:install
+install_egg_info = setuptools.command.install_egg_info:install_egg_info
+install_lib = setuptools.command.install_lib:install_lib
+install_scripts = setuptools.command.install_scripts:install_scripts
+rotate = setuptools.command.rotate:rotate
+saveopts = setuptools.command.saveopts:saveopts
+sdist = setuptools.command.sdist:sdist
+setopt = setuptools.command.setopt:setopt
+test = setuptools.command.test:test
+upload_docs = setuptools.command.upload_docs:upload_docs
+
+[distutils.setup_keywords]
+convert_2to3_doctests = setuptools.dist:assert_string_list
+dependency_links = setuptools.dist:assert_string_list
+eager_resources = setuptools.dist:assert_string_list
+entry_points = setuptools.dist:check_entry_points
+exclude_package_data = setuptools.dist:check_package_data
+extras_require = setuptools.dist:check_extras
+include_package_data = setuptools.dist:assert_bool
+install_requires = setuptools.dist:check_requirements
+namespace_packages = setuptools.dist:check_nsp
+package_data = setuptools.dist:check_package_data
+packages = setuptools.dist:check_packages
+python_requires = setuptools.dist:check_specifier
+setup_requires = setuptools.dist:check_requirements
+test_loader = setuptools.dist:check_importable
+test_runner = setuptools.dist:check_importable
+test_suite = setuptools.dist:check_test_suite
+tests_require = setuptools.dist:check_requirements
+use_2to3 = setuptools.dist:assert_bool
+use_2to3_exclude_fixers = setuptools.dist:assert_string_list
+use_2to3_fixers = setuptools.dist:assert_string_list
+zip_safe = setuptools.dist:assert_bool
+
+[egg_info.writers]
+PKG-INFO = setuptools.command.egg_info:write_pkg_info
+dependency_links.txt = setuptools.command.egg_info:overwrite_arg
+depends.txt = setuptools.command.egg_info:warn_depends_obsolete
+eager_resources.txt = setuptools.command.egg_info:overwrite_arg
+entry_points.txt = setuptools.command.egg_info:write_entries
+namespace_packages.txt = setuptools.command.egg_info:overwrite_arg
+requires.txt = setuptools.command.egg_info:write_requirements
+top_level.txt = setuptools.command.egg_info:write_toplevel_names
+
+[setuptools.finalize_distribution_options]
+2to3_doctests = setuptools.dist:Distribution._finalize_2to3_doctests
+features = setuptools.dist:Distribution._finalize_feature_opts
+keywords = setuptools.dist:Distribution._finalize_setup_keywords
+parent_finalize = setuptools.dist:_Distribution.finalize_options
+
+[setuptools.installation]
+eggsecutable = setuptools.command.easy_install:bootstrap
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4577c6a795e510bf7578236665f582c3770fb42e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/top_level.txt
@@ -0,0 +1,3 @@
+easy_install
+pkg_resources
+setuptools
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe
new file mode 100644
index 0000000000000000000000000000000000000000..8b137891791fe96927ad78e64b0aad7bded08bdc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.dist-info/zip-safe
@@ -0,0 +1 @@
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools-44.0.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a71b2bbdc6170963a66959c48080c1dedc7bb703
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/__init__.py
@@ -0,0 +1,228 @@
+"""Extensions to the 'distutils' for large or complex distributions"""
+
+import os
+import sys
+import functools
+import distutils.core
+import distutils.filelist
+import re
+from distutils.errors import DistutilsOptionError
+from distutils.util import convert_path
+from fnmatch import fnmatchcase
+
+from ._deprecation_warning import SetuptoolsDeprecationWarning
+
+from setuptools.extern.six import PY3, string_types
+from setuptools.extern.six.moves import filter, map
+
+import setuptools.version
+from setuptools.extension import Extension
+from setuptools.dist import Distribution, Feature
+from setuptools.depends import Require
+from . import monkey
+
+__metaclass__ = type
+
+
+__all__ = [
+    'setup', 'Distribution', 'Feature', 'Command', 'Extension', 'Require',
+    'SetuptoolsDeprecationWarning',
+    'find_packages'
+]
+
+if PY3:
+  __all__.append('find_namespace_packages')
+
+__version__ = setuptools.version.__version__
+
+bootstrap_install_from = None
+
+# If we run 2to3 on .py files, should we also convert docstrings?
+# Default: yes; assume that we can detect doctests reliably
+run_2to3_on_doctests = True
+# Standard package names for fixer packages
+lib2to3_fixer_packages = ['lib2to3.fixes']
+
+
+class PackageFinder:
+    """
+    Generate a list of all Python packages found within a directory
+    """
+
+    @classmethod
+    def find(cls, where='.', exclude=(), include=('*',)):
+        """Return a list all Python packages found within directory 'where'
+
+        'where' is the root directory which will be searched for packages.  It
+        should be supplied as a "cross-platform" (i.e. URL-style) path; it will
+        be converted to the appropriate local path syntax.
+
+        'exclude' is a sequence of package names to exclude; '*' can be used
+        as a wildcard in the names, such that 'foo.*' will exclude all
+        subpackages of 'foo' (but not 'foo' itself).
+
+        'include' is a sequence of package names to include.  If it's
+        specified, only the named packages will be included.  If it's not
+        specified, all found packages will be included.  'include' can contain
+        shell style wildcard patterns just like 'exclude'.
+        """
+
+        return list(cls._find_packages_iter(
+            convert_path(where),
+            cls._build_filter('ez_setup', '*__pycache__', *exclude),
+            cls._build_filter(*include)))
+
+    @classmethod
+    def _find_packages_iter(cls, where, exclude, include):
+        """
+        All the packages found in 'where' that pass the 'include' filter, but
+        not the 'exclude' filter.
+        """
+        for root, dirs, files in os.walk(where, followlinks=True):
+            # Copy dirs to iterate over it, then empty dirs.
+            all_dirs = dirs[:]
+            dirs[:] = []
+
+            for dir in all_dirs:
+                full_path = os.path.join(root, dir)
+                rel_path = os.path.relpath(full_path, where)
+                package = rel_path.replace(os.path.sep, '.')
+
+                # Skip directory trees that are not valid packages
+                if ('.' in dir or not cls._looks_like_package(full_path)):
+                    continue
+
+                # Should this package be included?
+                if include(package) and not exclude(package):
+                    yield package
+
+                # Keep searching subdirectories, as there may be more packages
+                # down there, even if the parent was excluded.
+                dirs.append(dir)
+
+    @staticmethod
+    def _looks_like_package(path):
+        """Does a directory look like a package?"""
+        return os.path.isfile(os.path.join(path, '__init__.py'))
+
+    @staticmethod
+    def _build_filter(*patterns):
+        """
+        Given a list of patterns, return a callable that will be true only if
+        the input matches at least one of the patterns.
+        """
+        return lambda name: any(fnmatchcase(name, pat=pat) for pat in patterns)
+
+
+class PEP420PackageFinder(PackageFinder):
+    @staticmethod
+    def _looks_like_package(path):
+        return True
+
+
+find_packages = PackageFinder.find
+
+if PY3:
+  find_namespace_packages = PEP420PackageFinder.find
+
+
+def _install_setup_requires(attrs):
+    # Note: do not use `setuptools.Distribution` directly, as
+    # our PEP 517 backend patch `distutils.core.Distribution`.
+    dist = distutils.core.Distribution(dict(
+        (k, v) for k, v in attrs.items()
+        if k in ('dependency_links', 'setup_requires')
+    ))
+    # Honor setup.cfg's options.
+    dist.parse_config_files(ignore_option_errors=True)
+    if dist.setup_requires:
+        dist.fetch_build_eggs(dist.setup_requires)
+
+
+def setup(**attrs):
+    # Make sure we have any requirements needed to interpret 'attrs'.
+    _install_setup_requires(attrs)
+    return distutils.core.setup(**attrs)
+
+setup.__doc__ = distutils.core.setup.__doc__
+
+
+_Command = monkey.get_unpatched(distutils.core.Command)
+
+
+class Command(_Command):
+    __doc__ = _Command.__doc__
+
+    command_consumes_arguments = False
+
+    def __init__(self, dist, **kw):
+        """
+        Construct the command for dist, updating
+        vars(self) with any keyword parameters.
+        """
+        _Command.__init__(self, dist)
+        vars(self).update(kw)
+
+    def _ensure_stringlike(self, option, what, default=None):
+        val = getattr(self, option)
+        if val is None:
+            setattr(self, option, default)
+            return default
+        elif not isinstance(val, string_types):
+            raise DistutilsOptionError("'%s' must be a %s (got `%s`)"
+                                       % (option, what, val))
+        return val
+
+    def ensure_string_list(self, option):
+        r"""Ensure that 'option' is a list of strings.  If 'option' is
+        currently a string, we split it either on /,\s*/ or /\s+/, so
+        "foo bar baz", "foo,bar,baz", and "foo,   bar baz" all become
+        ["foo", "bar", "baz"].
+        """
+        val = getattr(self, option)
+        if val is None:
+            return
+        elif isinstance(val, string_types):
+            setattr(self, option, re.split(r',\s*|\s+', val))
+        else:
+            if isinstance(val, list):
+                ok = all(isinstance(v, string_types) for v in val)
+            else:
+                ok = False
+            if not ok:
+                raise DistutilsOptionError(
+                      "'%s' must be a list of strings (got %r)"
+                      % (option, val))
+
+    def reinitialize_command(self, command, reinit_subcommands=0, **kw):
+        cmd = _Command.reinitialize_command(self, command, reinit_subcommands)
+        vars(cmd).update(kw)
+        return cmd
+
+
+def _find_all_simple(path):
+    """
+    Find all files under 'path'
+    """
+    results = (
+        os.path.join(base, file)
+        for base, dirs, files in os.walk(path, followlinks=True)
+        for file in files
+    )
+    return filter(os.path.isfile, results)
+
+
+def findall(dir=os.curdir):
+    """
+    Find all files under 'dir' and return the list of full filenames.
+    Unless dir is '.', return full filenames with dir prepended.
+    """
+    files = _find_all_simple(dir)
+    if dir == os.curdir:
+        make_rel = functools.partial(os.path.relpath, start=dir)
+        files = map(make_rel, files)
+    return list(files)
+
+
+# Apply monkey patches
+monkey.patch_all()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py
new file mode 100644
index 0000000000000000000000000000000000000000..086b64dd3817c0c1a194ffc1959eeffdd2695bef
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_deprecation_warning.py
@@ -0,0 +1,7 @@
+class SetuptoolsDeprecationWarning(Warning):
+    """
+    Base class for warning deprecations in ``setuptools``
+
+    This class is not derived from ``DeprecationWarning``, and as such is
+    visible by default.
+    """
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_imp.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_imp.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3cce9b284b1e580c1715c5e300a18077d63e8ce
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_imp.py
@@ -0,0 +1,73 @@
+"""
+Re-implementation of find_module and get_frozen_object
+from the deprecated imp module.
+"""
+
+import os
+import importlib.util
+import importlib.machinery
+
+from .py34compat import module_from_spec
+
+
+PY_SOURCE = 1
+PY_COMPILED = 2
+C_EXTENSION = 3
+C_BUILTIN = 6
+PY_FROZEN = 7
+
+
+def find_module(module, paths=None):
+    """Just like 'imp.find_module()', but with package support"""
+    spec = importlib.util.find_spec(module, paths)
+    if spec is None:
+        raise ImportError("Can't find %s" % module)
+    if not spec.has_location and hasattr(spec, 'submodule_search_locations'):
+        spec = importlib.util.spec_from_loader('__init__.py', spec.loader)
+
+    kind = -1
+    file = None
+    static = isinstance(spec.loader, type)
+    if spec.origin == 'frozen' or static and issubclass(
+            spec.loader, importlib.machinery.FrozenImporter):
+        kind = PY_FROZEN
+        path = None  # imp compabilty
+        suffix = mode = ''  # imp compability
+    elif spec.origin == 'built-in' or static and issubclass(
+            spec.loader, importlib.machinery.BuiltinImporter):
+        kind = C_BUILTIN
+        path = None  # imp compabilty
+        suffix = mode = ''  # imp compability
+    elif spec.has_location:
+        path = spec.origin
+        suffix = os.path.splitext(path)[1]
+        mode = 'r' if suffix in importlib.machinery.SOURCE_SUFFIXES else 'rb'
+
+        if suffix in importlib.machinery.SOURCE_SUFFIXES:
+            kind = PY_SOURCE
+        elif suffix in importlib.machinery.BYTECODE_SUFFIXES:
+            kind = PY_COMPILED
+        elif suffix in importlib.machinery.EXTENSION_SUFFIXES:
+            kind = C_EXTENSION
+
+        if kind in {PY_SOURCE, PY_COMPILED}:
+            file = open(path, mode)
+    else:
+        path = None
+        suffix = mode = ''
+
+    return file, path, (suffix, mode, kind)
+
+
+def get_frozen_object(module, paths=None):
+    spec = importlib.util.find_spec(module, paths)
+    if not spec:
+        raise ImportError("Can't find %s" % module)
+    return spec.loader.get_code(module)
+
+
+def get_module(module, paths, info):
+    spec = importlib.util.find_spec(module, paths)
+    if not spec:
+        raise ImportError("Can't find %s" % module)
+    return module_from_spec(spec)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py
new file mode 100644
index 0000000000000000000000000000000000000000..14876000de895a609d5b9f3de39c3c8fc44ef1fc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py
@@ -0,0 +1,488 @@
+"""
+An OrderedSet is a custom MutableSet that remembers its order, so that every
+entry has an index that can be looked up.
+
+Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger,
+and released under the MIT license.
+"""
+import itertools as it
+from collections import deque
+
+try:
+    # Python 3
+    from collections.abc import MutableSet, Sequence
+except ImportError:
+    # Python 2.7
+    from collections import MutableSet, Sequence
+
+SLICE_ALL = slice(None)
+__version__ = "3.1"
+
+
+def is_iterable(obj):
+    """
+    Are we being asked to look up a list of things, instead of a single thing?
+    We check for the `__iter__` attribute so that this can cover types that
+    don't have to be known by this module, such as NumPy arrays.
+
+    Strings, however, should be considered as atomic values to look up, not
+    iterables. The same goes for tuples, since they are immutable and therefore
+    valid entries.
+
+    We don't need to check for the Python 2 `unicode` type, because it doesn't
+    have an `__iter__` attribute anyway.
+    """
+    return (
+        hasattr(obj, "__iter__")
+        and not isinstance(obj, str)
+        and not isinstance(obj, tuple)
+    )
+
+
+class OrderedSet(MutableSet, Sequence):
+    """
+    An OrderedSet is a custom MutableSet that remembers its order, so that
+    every entry has an index that can be looked up.
+
+    Example:
+        >>> OrderedSet([1, 1, 2, 3, 2])
+        OrderedSet([1, 2, 3])
+    """
+
+    def __init__(self, iterable=None):
+        self.items = []
+        self.map = {}
+        if iterable is not None:
+            self |= iterable
+
+    def __len__(self):
+        """
+        Returns the number of unique elements in the ordered set
+
+        Example:
+            >>> len(OrderedSet([]))
+            0
+            >>> len(OrderedSet([1, 2]))
+            2
+        """
+        return len(self.items)
+
+    def __getitem__(self, index):
+        """
+        Get the item at a given index.
+
+        If `index` is a slice, you will get back that slice of items, as a
+        new OrderedSet.
+
+        If `index` is a list or a similar iterable, you'll get a list of
+        items corresponding to those indices. This is similar to NumPy's
+        "fancy indexing". The result is not an OrderedSet because you may ask
+        for duplicate indices, and the number of elements returned should be
+        the number of elements asked for.
+
+        Example:
+            >>> oset = OrderedSet([1, 2, 3])
+            >>> oset[1]
+            2
+        """
+        if isinstance(index, slice) and index == SLICE_ALL:
+            return self.copy()
+        elif is_iterable(index):
+            return [self.items[i] for i in index]
+        elif hasattr(index, "__index__") or isinstance(index, slice):
+            result = self.items[index]
+            if isinstance(result, list):
+                return self.__class__(result)
+            else:
+                return result
+        else:
+            raise TypeError("Don't know how to index an OrderedSet by %r" % index)
+
+    def copy(self):
+        """
+        Return a shallow copy of this object.
+
+        Example:
+            >>> this = OrderedSet([1, 2, 3])
+            >>> other = this.copy()
+            >>> this == other
+            True
+            >>> this is other
+            False
+        """
+        return self.__class__(self)
+
+    def __getstate__(self):
+        if len(self) == 0:
+            # The state can't be an empty list.
+            # We need to return a truthy value, or else __setstate__ won't be run.
+            #
+            # This could have been done more gracefully by always putting the state
+            # in a tuple, but this way is backwards- and forwards- compatible with
+            # previous versions of OrderedSet.
+            return (None,)
+        else:
+            return list(self)
+
+    def __setstate__(self, state):
+        if state == (None,):
+            self.__init__([])
+        else:
+            self.__init__(state)
+
+    def __contains__(self, key):
+        """
+        Test if the item is in this ordered set
+
+        Example:
+            >>> 1 in OrderedSet([1, 3, 2])
+            True
+            >>> 5 in OrderedSet([1, 3, 2])
+            False
+        """
+        return key in self.map
+
+    def add(self, key):
+        """
+        Add `key` as an item to this OrderedSet, then return its index.
+
+        If `key` is already in the OrderedSet, return the index it already
+        had.
+
+        Example:
+            >>> oset = OrderedSet()
+            >>> oset.append(3)
+            0
+            >>> print(oset)
+            OrderedSet([3])
+        """
+        if key not in self.map:
+            self.map[key] = len(self.items)
+            self.items.append(key)
+        return self.map[key]
+
+    append = add
+
+    def update(self, sequence):
+        """
+        Update the set with the given iterable sequence, then return the index
+        of the last element inserted.
+
+        Example:
+            >>> oset = OrderedSet([1, 2, 3])
+            >>> oset.update([3, 1, 5, 1, 4])
+            4
+            >>> print(oset)
+            OrderedSet([1, 2, 3, 5, 4])
+        """
+        item_index = None
+        try:
+            for item in sequence:
+                item_index = self.add(item)
+        except TypeError:
+            raise ValueError(
+                "Argument needs to be an iterable, got %s" % type(sequence)
+            )
+        return item_index
+
+    def index(self, key):
+        """
+        Get the index of a given entry, raising an IndexError if it's not
+        present.
+
+        `key` can be an iterable of entries that is not a string, in which case
+        this returns a list of indices.
+
+        Example:
+            >>> oset = OrderedSet([1, 2, 3])
+            >>> oset.index(2)
+            1
+        """
+        if is_iterable(key):
+            return [self.index(subkey) for subkey in key]
+        return self.map[key]
+
+    # Provide some compatibility with pd.Index
+    get_loc = index
+    get_indexer = index
+
+    def pop(self):
+        """
+        Remove and return the last element from the set.
+
+        Raises KeyError if the set is empty.
+
+        Example:
+            >>> oset = OrderedSet([1, 2, 3])
+            >>> oset.pop()
+            3
+        """
+        if not self.items:
+            raise KeyError("Set is empty")
+
+        elem = self.items[-1]
+        del self.items[-1]
+        del self.map[elem]
+        return elem
+
+    def discard(self, key):
+        """
+        Remove an element.  Do not raise an exception if absent.
+
+        The MutableSet mixin uses this to implement the .remove() method, which
+        *does* raise an error when asked to remove a non-existent item.
+
+        Example:
+            >>> oset = OrderedSet([1, 2, 3])
+            >>> oset.discard(2)
+            >>> print(oset)
+            OrderedSet([1, 3])
+            >>> oset.discard(2)
+            >>> print(oset)
+            OrderedSet([1, 3])
+        """
+        if key in self:
+            i = self.map[key]
+            del self.items[i]
+            del self.map[key]
+            for k, v in self.map.items():
+                if v >= i:
+                    self.map[k] = v - 1
+
+    def clear(self):
+        """
+        Remove all items from this OrderedSet.
+        """
+        del self.items[:]
+        self.map.clear()
+
+    def __iter__(self):
+        """
+        Example:
+            >>> list(iter(OrderedSet([1, 2, 3])))
+            [1, 2, 3]
+        """
+        return iter(self.items)
+
+    def __reversed__(self):
+        """
+        Example:
+            >>> list(reversed(OrderedSet([1, 2, 3])))
+            [3, 2, 1]
+        """
+        return reversed(self.items)
+
+    def __repr__(self):
+        if not self:
+            return "%s()" % (self.__class__.__name__,)
+        return "%s(%r)" % (self.__class__.__name__, list(self))
+
+    def __eq__(self, other):
+        """
+        Returns true if the containers have the same items. If `other` is a
+        Sequence, then order is checked, otherwise it is ignored.
+
+        Example:
+            >>> oset = OrderedSet([1, 3, 2])
+            >>> oset == [1, 3, 2]
+            True
+            >>> oset == [1, 2, 3]
+            False
+            >>> oset == [2, 3]
+            False
+            >>> oset == OrderedSet([3, 2, 1])
+            False
+        """
+        # In Python 2 deque is not a Sequence, so treat it as one for
+        # consistent behavior with Python 3.
+        if isinstance(other, (Sequence, deque)):
+            # Check that this OrderedSet contains the same elements, in the
+            # same order, as the other object.
+            return list(self) == list(other)
+        try:
+            other_as_set = set(other)
+        except TypeError:
+            # If `other` can't be converted into a set, it's not equal.
+            return False
+        else:
+            return set(self) == other_as_set
+
+    def union(self, *sets):
+        """
+        Combines all unique items.
+        Each items order is defined by its first appearance.
+
+        Example:
+            >>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0])
+            >>> print(oset)
+            OrderedSet([3, 1, 4, 5, 2, 0])
+            >>> oset.union([8, 9])
+            OrderedSet([3, 1, 4, 5, 2, 0, 8, 9])
+            >>> oset | {10}
+            OrderedSet([3, 1, 4, 5, 2, 0, 10])
+        """
+        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
+        containers = map(list, it.chain([self], sets))
+        items = it.chain.from_iterable(containers)
+        return cls(items)
+
+    def __and__(self, other):
+        # the parent implementation of this is backwards
+        return self.intersection(other)
+
+    def intersection(self, *sets):
+        """
+        Returns elements in common between all sets. Order is defined only
+        by the first set.
+
+        Example:
+            >>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3])
+            >>> print(oset)
+            OrderedSet([1, 2, 3])
+            >>> oset.intersection([2, 4, 5], [1, 2, 3, 4])
+            OrderedSet([2])
+            >>> oset.intersection()
+            OrderedSet([1, 2, 3])
+        """
+        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
+        if sets:
+            common = set.intersection(*map(set, sets))
+            items = (item for item in self if item in common)
+        else:
+            items = self
+        return cls(items)
+
+    def difference(self, *sets):
+        """
+        Returns all elements that are in this set but not the others.
+
+        Example:
+            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]))
+            OrderedSet([1, 3])
+            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3]))
+            OrderedSet([1])
+            >>> OrderedSet([1, 2, 3]) - OrderedSet([2])
+            OrderedSet([1, 3])
+            >>> OrderedSet([1, 2, 3]).difference()
+            OrderedSet([1, 2, 3])
+        """
+        cls = self.__class__
+        if sets:
+            other = set.union(*map(set, sets))
+            items = (item for item in self if item not in other)
+        else:
+            items = self
+        return cls(items)
+
+    def issubset(self, other):
+        """
+        Report whether another set contains this set.
+
+        Example:
+            >>> OrderedSet([1, 2, 3]).issubset({1, 2})
+            False
+            >>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4})
+            True
+            >>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5})
+            False
+        """
+        if len(self) > len(other):  # Fast check for obvious cases
+            return False
+        return all(item in other for item in self)
+
+    def issuperset(self, other):
+        """
+        Report whether this set contains another set.
+
+        Example:
+            >>> OrderedSet([1, 2]).issuperset([1, 2, 3])
+            False
+            >>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3})
+            True
+            >>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3})
+            False
+        """
+        if len(self) < len(other):  # Fast check for obvious cases
+            return False
+        return all(item in self for item in other)
+
+    def symmetric_difference(self, other):
+        """
+        Return the symmetric difference of two OrderedSets as a new set.
+        That is, the new set will contain all elements that are in exactly
+        one of the sets.
+
+        Their order will be preserved, with elements from `self` preceding
+        elements from `other`.
+
+        Example:
+            >>> this = OrderedSet([1, 4, 3, 5, 7])
+            >>> other = OrderedSet([9, 7, 1, 3, 2])
+            >>> this.symmetric_difference(other)
+            OrderedSet([4, 5, 9, 2])
+        """
+        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
+        diff1 = cls(self).difference(other)
+        diff2 = cls(other).difference(self)
+        return diff1.union(diff2)
+
+    def _update_items(self, items):
+        """
+        Replace the 'items' list of this OrderedSet with a new one, updating
+        self.map accordingly.
+        """
+        self.items = items
+        self.map = {item: idx for (idx, item) in enumerate(items)}
+
+    def difference_update(self, *sets):
+        """
+        Update this OrderedSet to remove items from one or more other sets.
+
+        Example:
+            >>> this = OrderedSet([1, 2, 3])
+            >>> this.difference_update(OrderedSet([2, 4]))
+            >>> print(this)
+            OrderedSet([1, 3])
+
+            >>> this = OrderedSet([1, 2, 3, 4, 5])
+            >>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6]))
+            >>> print(this)
+            OrderedSet([3, 5])
+        """
+        items_to_remove = set()
+        for other in sets:
+            items_to_remove |= set(other)
+        self._update_items([item for item in self.items if item not in items_to_remove])
+
+    def intersection_update(self, other):
+        """
+        Update this OrderedSet to keep only items in another set, preserving
+        their order in this set.
+
+        Example:
+            >>> this = OrderedSet([1, 4, 3, 5, 7])
+            >>> other = OrderedSet([9, 7, 1, 3, 2])
+            >>> this.intersection_update(other)
+            >>> print(this)
+            OrderedSet([1, 3, 7])
+        """
+        other = set(other)
+        self._update_items([item for item in self.items if item in other])
+
+    def symmetric_difference_update(self, other):
+        """
+        Update this OrderedSet to remove items from another set, then
+        add items from the other set that were not present in this set.
+
+        Example:
+            >>> this = OrderedSet([1, 4, 3, 5, 7])
+            >>> other = OrderedSet([9, 7, 1, 3, 2])
+            >>> this.symmetric_difference_update(other)
+            >>> print(this)
+            OrderedSet([4, 5, 9, 2])
+        """
+        items_to_add = [item for item in other if item not in self]
+        items_to_remove = set(other)
+        self._update_items(
+            [item for item in self.items if item not in items_to_remove] + items_to_add
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc95138d049ba3194964d528b552a6d1514fa382
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py
@@ -0,0 +1,27 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+__all__ = [
+    "__title__",
+    "__summary__",
+    "__uri__",
+    "__version__",
+    "__author__",
+    "__email__",
+    "__license__",
+    "__copyright__",
+]
+
+__title__ = "packaging"
+__summary__ = "Core utilities for Python packages"
+__uri__ = "https://github.com/pypa/packaging"
+
+__version__ = "19.2"
+
+__author__ = "Donald Stufft and individual contributors"
+__email__ = "donald@stufft.io"
+
+__license__ = "BSD or Apache License, Version 2.0"
+__copyright__ = "Copyright 2014-2019 %s" % __author__
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a0cf67df5245be16a020ca048832e180f7ce8661
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py
@@ -0,0 +1,26 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+from .__about__ import (
+    __author__,
+    __copyright__,
+    __email__,
+    __license__,
+    __summary__,
+    __title__,
+    __uri__,
+    __version__,
+)
+
+__all__ = [
+    "__title__",
+    "__summary__",
+    "__uri__",
+    "__version__",
+    "__author__",
+    "__email__",
+    "__license__",
+    "__copyright__",
+]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..25da473c196855ad59a6d2d785ef1ddef49795be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py
@@ -0,0 +1,31 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+
+# flake8: noqa
+
+if PY3:
+    string_types = (str,)
+else:
+    string_types = (basestring,)
+
+
+def with_metaclass(meta, *bases):
+    """
+    Create a base class with a metaclass.
+    """
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(meta):
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py
new file mode 100644
index 0000000000000000000000000000000000000000..68dcca634d8e3f0081bad2f9ae5e653a2942db68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py
@@ -0,0 +1,68 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+
+class Infinity(object):
+    def __repr__(self):
+        return "Infinity"
+
+    def __hash__(self):
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        return False
+
+    def __le__(self, other):
+        return False
+
+    def __eq__(self, other):
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        return True
+
+    def __ge__(self, other):
+        return True
+
+    def __neg__(self):
+        return NegativeInfinity
+
+
+Infinity = Infinity()
+
+
+class NegativeInfinity(object):
+    def __repr__(self):
+        return "-Infinity"
+
+    def __hash__(self):
+        return hash(repr(self))
+
+    def __lt__(self, other):
+        return True
+
+    def __le__(self, other):
+        return True
+
+    def __eq__(self, other):
+        return isinstance(other, self.__class__)
+
+    def __ne__(self, other):
+        return not isinstance(other, self.__class__)
+
+    def __gt__(self, other):
+        return False
+
+    def __ge__(self, other):
+        return False
+
+    def __neg__(self):
+        return Infinity
+
+
+NegativeInfinity = NegativeInfinity()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py
new file mode 100644
index 0000000000000000000000000000000000000000..4bdfdb24f2096eac046bb9a576065bb96cfd476e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.py
@@ -0,0 +1,296 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import operator
+import os
+import platform
+import sys
+
+from setuptools.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd
+from setuptools.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString
+from setuptools.extern.pyparsing import Literal as L  # noqa
+
+from ._compat import string_types
+from .specifiers import Specifier, InvalidSpecifier
+
+
+__all__ = [
+    "InvalidMarker",
+    "UndefinedComparison",
+    "UndefinedEnvironmentName",
+    "Marker",
+    "default_environment",
+]
+
+
+class InvalidMarker(ValueError):
+    """
+    An invalid marker was found, users should refer to PEP 508.
+    """
+
+
+class UndefinedComparison(ValueError):
+    """
+    An invalid operation was attempted on a value that doesn't support it.
+    """
+
+
+class UndefinedEnvironmentName(ValueError):
+    """
+    A name was attempted to be used that does not exist inside of the
+    environment.
+    """
+
+
+class Node(object):
+    def __init__(self, value):
+        self.value = value
+
+    def __str__(self):
+        return str(self.value)
+
+    def __repr__(self):
+        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))
+
+    def serialize(self):
+        raise NotImplementedError
+
+
+class Variable(Node):
+    def serialize(self):
+        return str(self)
+
+
+class Value(Node):
+    def serialize(self):
+        return '"{0}"'.format(self)
+
+
+class Op(Node):
+    def serialize(self):
+        return str(self)
+
+
+VARIABLE = (
+    L("implementation_version")
+    | L("platform_python_implementation")
+    | L("implementation_name")
+    | L("python_full_version")
+    | L("platform_release")
+    | L("platform_version")
+    | L("platform_machine")
+    | L("platform_system")
+    | L("python_version")
+    | L("sys_platform")
+    | L("os_name")
+    | L("os.name")
+    | L("sys.platform")  # PEP-345
+    | L("platform.version")  # PEP-345
+    | L("platform.machine")  # PEP-345
+    | L("platform.python_implementation")  # PEP-345
+    | L("python_implementation")  # PEP-345
+    | L("extra")  # undocumented setuptools legacy
+)
+ALIASES = {
+    "os.name": "os_name",
+    "sys.platform": "sys_platform",
+    "platform.version": "platform_version",
+    "platform.machine": "platform_machine",
+    "platform.python_implementation": "platform_python_implementation",
+    "python_implementation": "platform_python_implementation",
+}
+VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))
+
+VERSION_CMP = (
+    L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<")
+)
+
+MARKER_OP = VERSION_CMP | L("not in") | L("in")
+MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))
+
+MARKER_VALUE = QuotedString("'") | QuotedString('"')
+MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))
+
+BOOLOP = L("and") | L("or")
+
+MARKER_VAR = VARIABLE | MARKER_VALUE
+
+MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
+MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))
+
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+
+MARKER_EXPR = Forward()
+MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
+MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)
+
+MARKER = stringStart + MARKER_EXPR + stringEnd
+
+
+def _coerce_parse_result(results):
+    if isinstance(results, ParseResults):
+        return [_coerce_parse_result(i) for i in results]
+    else:
+        return results
+
+
+def _format_marker(marker, first=True):
+    assert isinstance(marker, (list, tuple, string_types))
+
+    # Sometimes we have a structure like [[...]] which is a single item list
+    # where the single item is itself it's own list. In that case we want skip
+    # the rest of this function so that we don't get extraneous () on the
+    # outside.
+    if (
+        isinstance(marker, list)
+        and len(marker) == 1
+        and isinstance(marker[0], (list, tuple))
+    ):
+        return _format_marker(marker[0])
+
+    if isinstance(marker, list):
+        inner = (_format_marker(m, first=False) for m in marker)
+        if first:
+            return " ".join(inner)
+        else:
+            return "(" + " ".join(inner) + ")"
+    elif isinstance(marker, tuple):
+        return " ".join([m.serialize() for m in marker])
+    else:
+        return marker
+
+
+_operators = {
+    "in": lambda lhs, rhs: lhs in rhs,
+    "not in": lambda lhs, rhs: lhs not in rhs,
+    "<": operator.lt,
+    "<=": operator.le,
+    "==": operator.eq,
+    "!=": operator.ne,
+    ">=": operator.ge,
+    ">": operator.gt,
+}
+
+
+def _eval_op(lhs, op, rhs):
+    try:
+        spec = Specifier("".join([op.serialize(), rhs]))
+    except InvalidSpecifier:
+        pass
+    else:
+        return spec.contains(lhs)
+
+    oper = _operators.get(op.serialize())
+    if oper is None:
+        raise UndefinedComparison(
+            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
+        )
+
+    return oper(lhs, rhs)
+
+
+_undefined = object()
+
+
+def _get_env(environment, name):
+    value = environment.get(name, _undefined)
+
+    if value is _undefined:
+        raise UndefinedEnvironmentName(
+            "{0!r} does not exist in evaluation environment.".format(name)
+        )
+
+    return value
+
+
+def _evaluate_markers(markers, environment):
+    groups = [[]]
+
+    for marker in markers:
+        assert isinstance(marker, (list, tuple, string_types))
+
+        if isinstance(marker, list):
+            groups[-1].append(_evaluate_markers(marker, environment))
+        elif isinstance(marker, tuple):
+            lhs, op, rhs = marker
+
+            if isinstance(lhs, Variable):
+                lhs_value = _get_env(environment, lhs.value)
+                rhs_value = rhs.value
+            else:
+                lhs_value = lhs.value
+                rhs_value = _get_env(environment, rhs.value)
+
+            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
+        else:
+            assert marker in ["and", "or"]
+            if marker == "or":
+                groups.append([])
+
+    return any(all(item) for item in groups)
+
+
+def format_full_version(info):
+    version = "{0.major}.{0.minor}.{0.micro}".format(info)
+    kind = info.releaselevel
+    if kind != "final":
+        version += kind[0] + str(info.serial)
+    return version
+
+
+def default_environment():
+    if hasattr(sys, "implementation"):
+        iver = format_full_version(sys.implementation.version)
+        implementation_name = sys.implementation.name
+    else:
+        iver = "0"
+        implementation_name = ""
+
+    return {
+        "implementation_name": implementation_name,
+        "implementation_version": iver,
+        "os_name": os.name,
+        "platform_machine": platform.machine(),
+        "platform_release": platform.release(),
+        "platform_system": platform.system(),
+        "platform_version": platform.version(),
+        "python_full_version": platform.python_version(),
+        "platform_python_implementation": platform.python_implementation(),
+        "python_version": ".".join(platform.python_version_tuple()[:2]),
+        "sys_platform": sys.platform,
+    }
+
+
+class Marker(object):
+    def __init__(self, marker):
+        try:
+            self._markers = _coerce_parse_result(MARKER.parseString(marker))
+        except ParseException as e:
+            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
+                marker, marker[e.loc : e.loc + 8]
+            )
+            raise InvalidMarker(err_str)
+
+    def __str__(self):
+        return _format_marker(self._markers)
+
+    def __repr__(self):
+        return "<Marker({0!r})>".format(str(self))
+
+    def evaluate(self, environment=None):
+        """Evaluate a marker.
+
+        Return the boolean from evaluating the given marker against the
+        environment. environment is an optional argument to override all or
+        part of the determined environment.
+
+        The environment is determined from the current Python process.
+        """
+        current_environment = default_environment()
+        if environment is not None:
+            current_environment.update(environment)
+
+        return _evaluate_markers(self._markers, current_environment)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py
new file mode 100644
index 0000000000000000000000000000000000000000..8a0c2cb9be06e633b26c7205d6efe42827835910
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.py
@@ -0,0 +1,138 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import string
+import re
+
+from setuptools.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
+from setuptools.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
+from setuptools.extern.pyparsing import Literal as L  # noqa
+from setuptools.extern.six.moves.urllib import parse as urlparse
+
+from .markers import MARKER_EXPR, Marker
+from .specifiers import LegacySpecifier, Specifier, SpecifierSet
+
+
+class InvalidRequirement(ValueError):
+    """
+    An invalid requirement was found, users should refer to PEP 508.
+    """
+
+
+ALPHANUM = Word(string.ascii_letters + string.digits)
+
+LBRACKET = L("[").suppress()
+RBRACKET = L("]").suppress()
+LPAREN = L("(").suppress()
+RPAREN = L(")").suppress()
+COMMA = L(",").suppress()
+SEMICOLON = L(";").suppress()
+AT = L("@").suppress()
+
+PUNCTUATION = Word("-_.")
+IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
+IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))
+
+NAME = IDENTIFIER("name")
+EXTRA = IDENTIFIER
+
+URI = Regex(r"[^ ]+")("url")
+URL = AT + URI
+
+EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
+EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")
+
+VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
+VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)
+
+VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
+VERSION_MANY = Combine(
+    VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False
+)("_raw_spec")
+_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
+_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "")
+
+VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
+VERSION_SPEC.setParseAction(lambda s, l, t: t[1])
+
+MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
+MARKER_EXPR.setParseAction(
+    lambda s, l, t: Marker(s[t._original_start : t._original_end])
+)
+MARKER_SEPARATOR = SEMICOLON
+MARKER = MARKER_SEPARATOR + MARKER_EXPR
+
+VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
+URL_AND_MARKER = URL + Optional(MARKER)
+
+NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)
+
+REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
+# setuptools.extern.pyparsing isn't thread safe during initialization, so we do it eagerly, see
+# issue #104
+REQUIREMENT.parseString("x[]")
+
+
+class Requirement(object):
+    """Parse a requirement.
+
+    Parse a given requirement string into its parts, such as name, specifier,
+    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
+    string.
+    """
+
+    # TODO: Can we test whether something is contained within a requirement?
+    #       If so how do we do that? Do we need to test against the _name_ of
+    #       the thing as well as the version? What about the markers?
+    # TODO: Can we normalize the name and extra name?
+
+    def __init__(self, requirement_string):
+        try:
+            req = REQUIREMENT.parseString(requirement_string)
+        except ParseException as e:
+            raise InvalidRequirement(
+                'Parse error at "{0!r}": {1}'.format(
+                    requirement_string[e.loc : e.loc + 8], e.msg
+                )
+            )
+
+        self.name = req.name
+        if req.url:
+            parsed_url = urlparse.urlparse(req.url)
+            if parsed_url.scheme == "file":
+                if urlparse.urlunparse(parsed_url) != req.url:
+                    raise InvalidRequirement("Invalid URL given")
+            elif not (parsed_url.scheme and parsed_url.netloc) or (
+                not parsed_url.scheme and not parsed_url.netloc
+            ):
+                raise InvalidRequirement("Invalid URL: {0}".format(req.url))
+            self.url = req.url
+        else:
+            self.url = None
+        self.extras = set(req.extras.asList() if req.extras else [])
+        self.specifier = SpecifierSet(req.specifier)
+        self.marker = req.marker if req.marker else None
+
+    def __str__(self):
+        parts = [self.name]
+
+        if self.extras:
+            parts.append("[{0}]".format(",".join(sorted(self.extras))))
+
+        if self.specifier:
+            parts.append(str(self.specifier))
+
+        if self.url:
+            parts.append("@ {0}".format(self.url))
+            if self.marker:
+                parts.append(" ")
+
+        if self.marker:
+            parts.append("; {0}".format(self.marker))
+
+        return "".join(parts)
+
+    def __repr__(self):
+        return "<Requirement({0!r})>".format(str(self))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py
new file mode 100644
index 0000000000000000000000000000000000000000..743576a080a0af8d0995f307ea6afc645b13ca61
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.py
@@ -0,0 +1,749 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import abc
+import functools
+import itertools
+import re
+
+from ._compat import string_types, with_metaclass
+from .version import Version, LegacyVersion, parse
+
+
+class InvalidSpecifier(ValueError):
+    """
+    An invalid specifier was found, users should refer to PEP 440.
+    """
+
+
+class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):
+    @abc.abstractmethod
+    def __str__(self):
+        """
+        Returns the str representation of this Specifier like object. This
+        should be representative of the Specifier itself.
+        """
+
+    @abc.abstractmethod
+    def __hash__(self):
+        """
+        Returns a hash value for this Specifier like object.
+        """
+
+    @abc.abstractmethod
+    def __eq__(self, other):
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are equal.
+        """
+
+    @abc.abstractmethod
+    def __ne__(self, other):
+        """
+        Returns a boolean representing whether or not the two Specifier like
+        objects are not equal.
+        """
+
+    @abc.abstractproperty
+    def prereleases(self):
+        """
+        Returns whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @prereleases.setter
+    def prereleases(self, value):
+        """
+        Sets whether or not pre-releases as a whole are allowed by this
+        specifier.
+        """
+
+    @abc.abstractmethod
+    def contains(self, item, prereleases=None):
+        """
+        Determines if the given item is contained within this specifier.
+        """
+
+    @abc.abstractmethod
+    def filter(self, iterable, prereleases=None):
+        """
+        Takes an iterable of items and filters them so that only items which
+        are contained within this specifier are allowed in it.
+        """
+
+
+class _IndividualSpecifier(BaseSpecifier):
+
+    _operators = {}
+
+    def __init__(self, spec="", prereleases=None):
+        match = self._regex.search(spec)
+        if not match:
+            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))
+
+        self._spec = (match.group("operator").strip(), match.group("version").strip())
+
+        # Store whether or not this Specifier should accept prereleases
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<{0}({1!r}{2})>".format(self.__class__.__name__, str(self), pre)
+
+    def __str__(self):
+        return "{0}{1}".format(*self._spec)
+
+    def __hash__(self):
+        return hash(self._spec)
+
+    def __eq__(self, other):
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(other)
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec == other._spec
+
+    def __ne__(self, other):
+        if isinstance(other, string_types):
+            try:
+                other = self.__class__(other)
+            except InvalidSpecifier:
+                return NotImplemented
+        elif not isinstance(other, self.__class__):
+            return NotImplemented
+
+        return self._spec != other._spec
+
+    def _get_operator(self, op):
+        return getattr(self, "_compare_{0}".format(self._operators[op]))
+
+    def _coerce_version(self, version):
+        if not isinstance(version, (LegacyVersion, Version)):
+            version = parse(version)
+        return version
+
+    @property
+    def operator(self):
+        return self._spec[0]
+
+    @property
+    def version(self):
+        return self._spec[1]
+
+    @property
+    def prereleases(self):
+        return self._prereleases
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+    def __contains__(self, item):
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # Determine if prereleases are to be allowed or not.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # Normalize item to a Version or LegacyVersion, this allows us to have
+        # a shortcut for ``"2.0" in Specifier(">=2")
+        item = self._coerce_version(item)
+
+        # Determine if we should be supporting prereleases in this specifier
+        # or not, if we do not support prereleases than we can short circuit
+        # logic if this version is a prereleases.
+        if item.is_prerelease and not prereleases:
+            return False
+
+        # Actually do the comparison to determine if this item is contained
+        # within this Specifier or not.
+        return self._get_operator(self.operator)(item, self.version)
+
+    def filter(self, iterable, prereleases=None):
+        yielded = False
+        found_prereleases = []
+
+        kw = {"prereleases": prereleases if prereleases is not None else True}
+
+        # Attempt to iterate over all the values in the iterable and if any of
+        # them match, yield them.
+        for version in iterable:
+            parsed_version = self._coerce_version(version)
+
+            if self.contains(parsed_version, **kw):
+                # If our version is a prerelease, and we were not set to allow
+                # prereleases, then we'll store it for later incase nothing
+                # else matches this specifier.
+                if parsed_version.is_prerelease and not (
+                    prereleases or self.prereleases
+                ):
+                    found_prereleases.append(version)
+                # Either this is not a prerelease, or we should have been
+                # accepting prereleases from the beginning.
+                else:
+                    yielded = True
+                    yield version
+
+        # Now that we've iterated over everything, determine if we've yielded
+        # any values, and if we have not and we have any prereleases stored up
+        # then we will go ahead and yield the prereleases.
+        if not yielded and found_prereleases:
+            for version in found_prereleases:
+                yield version
+
+
+class LegacySpecifier(_IndividualSpecifier):
+
+    _regex_str = r"""
+        (?P<operator>(==|!=|<=|>=|<|>))
+        \s*
+        (?P<version>
+            [^,;\s)]* # Since this is a "legacy" specifier, and the version
+                      # string can be just about anything, we match everything
+                      # except for whitespace, a semi-colon for marker support,
+                      # a closing paren since versions can be enclosed in
+                      # them, and a comma since it's a version separator.
+        )
+        """
+
+    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+    }
+
+    def _coerce_version(self, version):
+        if not isinstance(version, LegacyVersion):
+            version = LegacyVersion(str(version))
+        return version
+
+    def _compare_equal(self, prospective, spec):
+        return prospective == self._coerce_version(spec)
+
+    def _compare_not_equal(self, prospective, spec):
+        return prospective != self._coerce_version(spec)
+
+    def _compare_less_than_equal(self, prospective, spec):
+        return prospective <= self._coerce_version(spec)
+
+    def _compare_greater_than_equal(self, prospective, spec):
+        return prospective >= self._coerce_version(spec)
+
+    def _compare_less_than(self, prospective, spec):
+        return prospective < self._coerce_version(spec)
+
+    def _compare_greater_than(self, prospective, spec):
+        return prospective > self._coerce_version(spec)
+
+
+def _require_version_compare(fn):
+    @functools.wraps(fn)
+    def wrapped(self, prospective, spec):
+        if not isinstance(prospective, Version):
+            return False
+        return fn(self, prospective, spec)
+
+    return wrapped
+
+
+class Specifier(_IndividualSpecifier):
+
+    _regex_str = r"""
+        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
+        (?P<version>
+            (?:
+                # The identity operators allow for an escape hatch that will
+                # do an exact string match of the version you wish to install.
+                # This will not be parsed by PEP 440 and we cannot determine
+                # any semantic meaning from it. This operator is discouraged
+                # but included entirely as an escape hatch.
+                (?<====)  # Only match for the identity operator
+                \s*
+                [^\s]*    # We just match everything, except for whitespace
+                          # since we are only testing for strict identity.
+            )
+            |
+            (?:
+                # The (non)equality operators allow for wild card and local
+                # versions to be specified so we have to define these two
+                # operators separately to enable that.
+                (?<===|!=)            # Only match for equals and not equals
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+
+                # You cannot use a wild card and a dev or local version
+                # together so group them with a | and make them optional.
+                (?:
+                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
+                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
+                    |
+                    \.\*  # Wild card syntax of .*
+                )?
+            )
+            |
+            (?:
+                # The compatible operator requires at least two digits in the
+                # release segment.
+                (?<=~=)               # Only match for the compatible operator
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+            |
+            (?:
+                # All other operators only allow a sub set of what the
+                # (non)equality operators do. Specifically they do not allow
+                # local versions to be specified nor do they allow the prefix
+                # matching wild cards.
+                (?<!==|!=|~=)         # We have special cases for these
+                                      # operators so we want to make sure they
+                                      # don't match here.
+
+                \s*
+                v?
+                (?:[0-9]+!)?          # epoch
+                [0-9]+(?:\.[0-9]+)*   # release
+                (?:                   # pre release
+                    [-_\.]?
+                    (a|b|c|rc|alpha|beta|pre|preview)
+                    [-_\.]?
+                    [0-9]*
+                )?
+                (?:                                   # post release
+                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
+                )?
+                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
+            )
+        )
+        """
+
+    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    _operators = {
+        "~=": "compatible",
+        "==": "equal",
+        "!=": "not_equal",
+        "<=": "less_than_equal",
+        ">=": "greater_than_equal",
+        "<": "less_than",
+        ">": "greater_than",
+        "===": "arbitrary",
+    }
+
+    @_require_version_compare
+    def _compare_compatible(self, prospective, spec):
+        # Compatible releases have an equivalent combination of >= and ==. That
+        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
+        # implement this in terms of the other specifiers instead of
+        # implementing it ourselves. The only thing we need to do is construct
+        # the other specifiers.
+
+        # We want everything but the last item in the version, but we want to
+        # ignore post and dev releases and we want to treat the pre-release as
+        # it's own separate segment.
+        prefix = ".".join(
+            list(
+                itertools.takewhile(
+                    lambda x: (not x.startswith("post") and not x.startswith("dev")),
+                    _version_split(spec),
+                )
+            )[:-1]
+        )
+
+        # Add the prefix notation to the end of our string
+        prefix += ".*"
+
+        return self._get_operator(">=")(prospective, spec) and self._get_operator("==")(
+            prospective, prefix
+        )
+
+    @_require_version_compare
+    def _compare_equal(self, prospective, spec):
+        # We need special logic to handle prefix matching
+        if spec.endswith(".*"):
+            # In the case of prefix matching we want to ignore local segment.
+            prospective = Version(prospective.public)
+            # Split the spec out by dots, and pretend that there is an implicit
+            # dot in between a release segment and a pre-release segment.
+            spec = _version_split(spec[:-2])  # Remove the trailing .*
+
+            # Split the prospective version out by dots, and pretend that there
+            # is an implicit dot in between a release segment and a pre-release
+            # segment.
+            prospective = _version_split(str(prospective))
+
+            # Shorten the prospective version to be the same length as the spec
+            # so that we can determine if the specifier is a prefix of the
+            # prospective version or not.
+            prospective = prospective[: len(spec)]
+
+            # Pad out our two sides with zeros so that they both equal the same
+            # length.
+            spec, prospective = _pad_version(spec, prospective)
+        else:
+            # Convert our spec string into a Version
+            spec = Version(spec)
+
+            # If the specifier does not have a local segment, then we want to
+            # act as if the prospective version also does not have a local
+            # segment.
+            if not spec.local:
+                prospective = Version(prospective.public)
+
+        return prospective == spec
+
+    @_require_version_compare
+    def _compare_not_equal(self, prospective, spec):
+        return not self._compare_equal(prospective, spec)
+
+    @_require_version_compare
+    def _compare_less_than_equal(self, prospective, spec):
+        return prospective <= Version(spec)
+
+    @_require_version_compare
+    def _compare_greater_than_equal(self, prospective, spec):
+        return prospective >= Version(spec)
+
+    @_require_version_compare
+    def _compare_less_than(self, prospective, spec):
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec)
+
+        # Check to see if the prospective version is less than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective < spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a pre-release version, that we do not accept pre-release
+        # versions for the version mentioned in the specifier (e.g. <3.1 should
+        # not match 3.1.dev0, but should match 3.0.dev0).
+        if not spec.is_prerelease and prospective.is_prerelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # less than the spec version *and* it's not a pre-release of the same
+        # version in the spec.
+        return True
+
+    @_require_version_compare
+    def _compare_greater_than(self, prospective, spec):
+        # Convert our spec to a Version instance, since we'll want to work with
+        # it as a version.
+        spec = Version(spec)
+
+        # Check to see if the prospective version is greater than the spec
+        # version. If it's not we can short circuit and just return False now
+        # instead of doing extra unneeded work.
+        if not prospective > spec:
+            return False
+
+        # This special case is here so that, unless the specifier itself
+        # includes is a post-release version, that we do not accept
+        # post-release versions for the version mentioned in the specifier
+        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
+        if not spec.is_postrelease and prospective.is_postrelease:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # Ensure that we do not allow a local version of the version mentioned
+        # in the specifier, which is technically greater than, to match.
+        if prospective.local is not None:
+            if Version(prospective.base_version) == Version(spec.base_version):
+                return False
+
+        # If we've gotten to here, it means that prospective version is both
+        # greater than the spec version *and* it's not a pre-release of the
+        # same version in the spec.
+        return True
+
+    def _compare_arbitrary(self, prospective, spec):
+        return str(prospective).lower() == str(spec).lower()
+
+    @property
+    def prereleases(self):
+        # If there is an explicit prereleases set for this, then we'll just
+        # blindly use that.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # Look at all of our specifiers and determine if they are inclusive
+        # operators, and if they are if they are including an explicit
+        # prerelease.
+        operator, version = self._spec
+        if operator in ["==", ">=", "<=", "~=", "==="]:
+            # The == specifier can include a trailing .*, if it does we
+            # want to remove before parsing.
+            if operator == "==" and version.endswith(".*"):
+                version = version[:-2]
+
+            # Parse the version, and if it is a pre-release than this
+            # specifier allows pre-releases.
+            if parse(version).is_prerelease:
+                return True
+
+        return False
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+
+_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")
+
+
+def _version_split(version):
+    result = []
+    for item in version.split("."):
+        match = _prefix_regex.search(item)
+        if match:
+            result.extend(match.groups())
+        else:
+            result.append(item)
+    return result
+
+
+def _pad_version(left, right):
+    left_split, right_split = [], []
+
+    # Get the release segment of our versions
+    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
+    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))
+
+    # Get the rest of our versions
+    left_split.append(left[len(left_split[0]) :])
+    right_split.append(right[len(right_split[0]) :])
+
+    # Insert our padding
+    left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0])))
+    right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0])))
+
+    return (list(itertools.chain(*left_split)), list(itertools.chain(*right_split)))
+
+
+class SpecifierSet(BaseSpecifier):
+    def __init__(self, specifiers="", prereleases=None):
+        # Split on , to break each indidivual specifier into it's own item, and
+        # strip each item to remove leading/trailing whitespace.
+        specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
+
+        # Parsed each individual specifier, attempting first to make it a
+        # Specifier and falling back to a LegacySpecifier.
+        parsed = set()
+        for specifier in specifiers:
+            try:
+                parsed.add(Specifier(specifier))
+            except InvalidSpecifier:
+                parsed.add(LegacySpecifier(specifier))
+
+        # Turn our parsed specifiers into a frozen set and save them for later.
+        self._specs = frozenset(parsed)
+
+        # Store our prereleases value so we can use it later to determine if
+        # we accept prereleases or not.
+        self._prereleases = prereleases
+
+    def __repr__(self):
+        pre = (
+            ", prereleases={0!r}".format(self.prereleases)
+            if self._prereleases is not None
+            else ""
+        )
+
+        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)
+
+    def __str__(self):
+        return ",".join(sorted(str(s) for s in self._specs))
+
+    def __hash__(self):
+        return hash(self._specs)
+
+    def __and__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        specifier = SpecifierSet()
+        specifier._specs = frozenset(self._specs | other._specs)
+
+        if self._prereleases is None and other._prereleases is not None:
+            specifier._prereleases = other._prereleases
+        elif self._prereleases is not None and other._prereleases is None:
+            specifier._prereleases = self._prereleases
+        elif self._prereleases == other._prereleases:
+            specifier._prereleases = self._prereleases
+        else:
+            raise ValueError(
+                "Cannot combine SpecifierSets with True and False prerelease "
+                "overrides."
+            )
+
+        return specifier
+
+    def __eq__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif isinstance(other, _IndividualSpecifier):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs == other._specs
+
+    def __ne__(self, other):
+        if isinstance(other, string_types):
+            other = SpecifierSet(other)
+        elif isinstance(other, _IndividualSpecifier):
+            other = SpecifierSet(str(other))
+        elif not isinstance(other, SpecifierSet):
+            return NotImplemented
+
+        return self._specs != other._specs
+
+    def __len__(self):
+        return len(self._specs)
+
+    def __iter__(self):
+        return iter(self._specs)
+
+    @property
+    def prereleases(self):
+        # If we have been given an explicit prerelease modifier, then we'll
+        # pass that through here.
+        if self._prereleases is not None:
+            return self._prereleases
+
+        # If we don't have any specifiers, and we don't have a forced value,
+        # then we'll just return None since we don't know if this should have
+        # pre-releases or not.
+        if not self._specs:
+            return None
+
+        # Otherwise we'll see if any of the given specifiers accept
+        # prereleases, if any of them do we'll return True, otherwise False.
+        return any(s.prereleases for s in self._specs)
+
+    @prereleases.setter
+    def prereleases(self, value):
+        self._prereleases = value
+
+    def __contains__(self, item):
+        return self.contains(item)
+
+    def contains(self, item, prereleases=None):
+        # Ensure that our item is a Version or LegacyVersion instance.
+        if not isinstance(item, (LegacyVersion, Version)):
+            item = parse(item)
+
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # We can determine if we're going to allow pre-releases by looking to
+        # see if any of the underlying items supports them. If none of them do
+        # and this item is a pre-release then we do not allow it and we can
+        # short circuit that here.
+        # Note: This means that 1.0.dev1 would not be contained in something
+        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
+        if not prereleases and item.is_prerelease:
+            return False
+
+        # We simply dispatch to the underlying specs here to make sure that the
+        # given version is contained within all of them.
+        # Note: This use of all() here means that an empty set of specifiers
+        #       will always return True, this is an explicit design decision.
+        return all(s.contains(item, prereleases=prereleases) for s in self._specs)
+
+    def filter(self, iterable, prereleases=None):
+        # Determine if we're forcing a prerelease or not, if we're not forcing
+        # one for this particular filter call, then we'll use whatever the
+        # SpecifierSet thinks for whether or not we should support prereleases.
+        if prereleases is None:
+            prereleases = self.prereleases
+
+        # If we have any specifiers, then we want to wrap our iterable in the
+        # filter method for each one, this will act as a logical AND amongst
+        # each specifier.
+        if self._specs:
+            for spec in self._specs:
+                iterable = spec.filter(iterable, prereleases=bool(prereleases))
+            return iterable
+        # If we do not have any specifiers, then we need to have a rough filter
+        # which will filter out any pre-releases, unless there are no final
+        # releases, and which will filter out LegacyVersion in general.
+        else:
+            filtered = []
+            found_prereleases = []
+
+            for item in iterable:
+                # Ensure that we some kind of Version class for this item.
+                if not isinstance(item, (LegacyVersion, Version)):
+                    parsed_version = parse(item)
+                else:
+                    parsed_version = item
+
+                # Filter out any item which is parsed as a LegacyVersion
+                if isinstance(parsed_version, LegacyVersion):
+                    continue
+
+                # Store any item which is a pre-release for later unless we've
+                # already found a final version or we are accepting prereleases
+                if parsed_version.is_prerelease and not prereleases:
+                    if not filtered:
+                        found_prereleases.append(item)
+                else:
+                    filtered.append(item)
+
+            # If we've found no items except for pre-releases, then we'll go
+            # ahead and use the pre-releases
+            if not filtered and found_prereleases and prereleases is None:
+                return found_prereleases
+
+            return filtered
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec9942f0f6627f34554082a8c0909bc70bd2a260
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/tags.py
@@ -0,0 +1,404 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+
+from __future__ import absolute_import
+
+import distutils.util
+
+try:
+    from importlib.machinery import EXTENSION_SUFFIXES
+except ImportError:  # pragma: no cover
+    import imp
+
+    EXTENSION_SUFFIXES = [x[0] for x in imp.get_suffixes()]
+    del imp
+import platform
+import re
+import sys
+import sysconfig
+import warnings
+
+
+INTERPRETER_SHORT_NAMES = {
+    "python": "py",  # Generic.
+    "cpython": "cp",
+    "pypy": "pp",
+    "ironpython": "ip",
+    "jython": "jy",
+}
+
+
+_32_BIT_INTERPRETER = sys.maxsize <= 2 ** 32
+
+
+class Tag(object):
+
+    __slots__ = ["_interpreter", "_abi", "_platform"]
+
+    def __init__(self, interpreter, abi, platform):
+        self._interpreter = interpreter.lower()
+        self._abi = abi.lower()
+        self._platform = platform.lower()
+
+    @property
+    def interpreter(self):
+        return self._interpreter
+
+    @property
+    def abi(self):
+        return self._abi
+
+    @property
+    def platform(self):
+        return self._platform
+
+    def __eq__(self, other):
+        return (
+            (self.platform == other.platform)
+            and (self.abi == other.abi)
+            and (self.interpreter == other.interpreter)
+        )
+
+    def __hash__(self):
+        return hash((self._interpreter, self._abi, self._platform))
+
+    def __str__(self):
+        return "{}-{}-{}".format(self._interpreter, self._abi, self._platform)
+
+    def __repr__(self):
+        return "<{self} @ {self_id}>".format(self=self, self_id=id(self))
+
+
+def parse_tag(tag):
+    tags = set()
+    interpreters, abis, platforms = tag.split("-")
+    for interpreter in interpreters.split("."):
+        for abi in abis.split("."):
+            for platform_ in platforms.split("."):
+                tags.add(Tag(interpreter, abi, platform_))
+    return frozenset(tags)
+
+
+def _normalize_string(string):
+    return string.replace(".", "_").replace("-", "_")
+
+
+def _cpython_interpreter(py_version):
+    # TODO: Is using py_version_nodot for interpreter version critical?
+    return "cp{major}{minor}".format(major=py_version[0], minor=py_version[1])
+
+
+def _cpython_abis(py_version):
+    abis = []
+    version = "{}{}".format(*py_version[:2])
+    debug = pymalloc = ucs4 = ""
+    with_debug = sysconfig.get_config_var("Py_DEBUG")
+    has_refcount = hasattr(sys, "gettotalrefcount")
+    # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled
+    # extension modules is the best option.
+    # https://github.com/pypa/pip/issues/3383#issuecomment-173267692
+    has_ext = "_d.pyd" in EXTENSION_SUFFIXES
+    if with_debug or (with_debug is None and (has_refcount or has_ext)):
+        debug = "d"
+    if py_version < (3, 8):
+        with_pymalloc = sysconfig.get_config_var("WITH_PYMALLOC")
+        if with_pymalloc or with_pymalloc is None:
+            pymalloc = "m"
+        if py_version < (3, 3):
+            unicode_size = sysconfig.get_config_var("Py_UNICODE_SIZE")
+            if unicode_size == 4 or (
+                unicode_size is None and sys.maxunicode == 0x10FFFF
+            ):
+                ucs4 = "u"
+    elif debug:
+        # Debug builds can also load "normal" extension modules.
+        # We can also assume no UCS-4 or pymalloc requirement.
+        abis.append("cp{version}".format(version=version))
+    abis.insert(
+        0,
+        "cp{version}{debug}{pymalloc}{ucs4}".format(
+            version=version, debug=debug, pymalloc=pymalloc, ucs4=ucs4
+        ),
+    )
+    return abis
+
+
+def _cpython_tags(py_version, interpreter, abis, platforms):
+    for abi in abis:
+        for platform_ in platforms:
+            yield Tag(interpreter, abi, platform_)
+    for tag in (Tag(interpreter, "abi3", platform_) for platform_ in platforms):
+        yield tag
+    for tag in (Tag(interpreter, "none", platform_) for platform_ in platforms):
+        yield tag
+    # PEP 384 was first implemented in Python 3.2.
+    for minor_version in range(py_version[1] - 1, 1, -1):
+        for platform_ in platforms:
+            interpreter = "cp{major}{minor}".format(
+                major=py_version[0], minor=minor_version
+            )
+            yield Tag(interpreter, "abi3", platform_)
+
+
+def _pypy_interpreter():
+    return "pp{py_major}{pypy_major}{pypy_minor}".format(
+        py_major=sys.version_info[0],
+        pypy_major=sys.pypy_version_info.major,
+        pypy_minor=sys.pypy_version_info.minor,
+    )
+
+
+def _generic_abi():
+    abi = sysconfig.get_config_var("SOABI")
+    if abi:
+        return _normalize_string(abi)
+    else:
+        return "none"
+
+
+def _pypy_tags(py_version, interpreter, abi, platforms):
+    for tag in (Tag(interpreter, abi, platform) for platform in platforms):
+        yield tag
+    for tag in (Tag(interpreter, "none", platform) for platform in platforms):
+        yield tag
+
+
+def _generic_tags(interpreter, py_version, abi, platforms):
+    for tag in (Tag(interpreter, abi, platform) for platform in platforms):
+        yield tag
+    if abi != "none":
+        tags = (Tag(interpreter, "none", platform_) for platform_ in platforms)
+        for tag in tags:
+            yield tag
+
+
+def _py_interpreter_range(py_version):
+    """
+    Yield Python versions in descending order.
+
+    After the latest version, the major-only version will be yielded, and then
+    all following versions up to 'end'.
+    """
+    yield "py{major}{minor}".format(major=py_version[0], minor=py_version[1])
+    yield "py{major}".format(major=py_version[0])
+    for minor in range(py_version[1] - 1, -1, -1):
+        yield "py{major}{minor}".format(major=py_version[0], minor=minor)
+
+
+def _independent_tags(interpreter, py_version, platforms):
+    """
+    Return the sequence of tags that are consistent across implementations.
+
+    The tags consist of:
+    - py*-none-<platform>
+    - <interpreter>-none-any
+    - py*-none-any
+    """
+    for version in _py_interpreter_range(py_version):
+        for platform_ in platforms:
+            yield Tag(version, "none", platform_)
+    yield Tag(interpreter, "none", "any")
+    for version in _py_interpreter_range(py_version):
+        yield Tag(version, "none", "any")
+
+
+def _mac_arch(arch, is_32bit=_32_BIT_INTERPRETER):
+    if not is_32bit:
+        return arch
+
+    if arch.startswith("ppc"):
+        return "ppc"
+
+    return "i386"
+
+
+def _mac_binary_formats(version, cpu_arch):
+    formats = [cpu_arch]
+    if cpu_arch == "x86_64":
+        if version < (10, 4):
+            return []
+        formats.extend(["intel", "fat64", "fat32"])
+
+    elif cpu_arch == "i386":
+        if version < (10, 4):
+            return []
+        formats.extend(["intel", "fat32", "fat"])
+
+    elif cpu_arch == "ppc64":
+        # TODO: Need to care about 32-bit PPC for ppc64 through 10.2?
+        if version > (10, 5) or version < (10, 4):
+            return []
+        formats.append("fat64")
+
+    elif cpu_arch == "ppc":
+        if version > (10, 6):
+            return []
+        formats.extend(["fat32", "fat"])
+
+    formats.append("universal")
+    return formats
+
+
+def _mac_platforms(version=None, arch=None):
+    version_str, _, cpu_arch = platform.mac_ver()
+    if version is None:
+        version = tuple(map(int, version_str.split(".")[:2]))
+    if arch is None:
+        arch = _mac_arch(cpu_arch)
+    platforms = []
+    for minor_version in range(version[1], -1, -1):
+        compat_version = version[0], minor_version
+        binary_formats = _mac_binary_formats(compat_version, arch)
+        for binary_format in binary_formats:
+            platforms.append(
+                "macosx_{major}_{minor}_{binary_format}".format(
+                    major=compat_version[0],
+                    minor=compat_version[1],
+                    binary_format=binary_format,
+                )
+            )
+    return platforms
+
+
+# From PEP 513.
+def _is_manylinux_compatible(name, glibc_version):
+    # Check for presence of _manylinux module.
+    try:
+        import _manylinux
+
+        return bool(getattr(_manylinux, name + "_compatible"))
+    except (ImportError, AttributeError):
+        # Fall through to heuristic check below.
+        pass
+
+    return _have_compatible_glibc(*glibc_version)
+
+
+def _glibc_version_string():
+    # Returns glibc version string, or None if not using glibc.
+    import ctypes
+
+    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
+    # manpage says, "If filename is NULL, then the returned handle is for the
+    # main program". This way we can let the linker do the work to figure out
+    # which libc our process is actually using.
+    process_namespace = ctypes.CDLL(None)
+    try:
+        gnu_get_libc_version = process_namespace.gnu_get_libc_version
+    except AttributeError:
+        # Symbol doesn't exist -> therefore, we are not linked to
+        # glibc.
+        return None
+
+    # Call gnu_get_libc_version, which returns a string like "2.5"
+    gnu_get_libc_version.restype = ctypes.c_char_p
+    version_str = gnu_get_libc_version()
+    # py2 / py3 compatibility:
+    if not isinstance(version_str, str):
+        version_str = version_str.decode("ascii")
+
+    return version_str
+
+
+# Separated out from have_compatible_glibc for easier unit testing.
+def _check_glibc_version(version_str, required_major, minimum_minor):
+    # Parse string and check against requested version.
+    #
+    # We use a regexp instead of str.split because we want to discard any
+    # random junk that might come after the minor version -- this might happen
+    # in patched/forked versions of glibc (e.g. Linaro's version of glibc
+    # uses version strings like "2.20-2014.11"). See gh-3588.
+    m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
+    if not m:
+        warnings.warn(
+            "Expected glibc version with 2 components major.minor,"
+            " got: %s" % version_str,
+            RuntimeWarning,
+        )
+        return False
+    return (
+        int(m.group("major")) == required_major
+        and int(m.group("minor")) >= minimum_minor
+    )
+
+
+def _have_compatible_glibc(required_major, minimum_minor):
+    version_str = _glibc_version_string()
+    if version_str is None:
+        return False
+    return _check_glibc_version(version_str, required_major, minimum_minor)
+
+
+def _linux_platforms(is_32bit=_32_BIT_INTERPRETER):
+    linux = _normalize_string(distutils.util.get_platform())
+    if linux == "linux_x86_64" and is_32bit:
+        linux = "linux_i686"
+    manylinux_support = (
+        ("manylinux2014", (2, 17)),  # CentOS 7 w/ glibc 2.17 (PEP 599)
+        ("manylinux2010", (2, 12)),  # CentOS 6 w/ glibc 2.12 (PEP 571)
+        ("manylinux1", (2, 5)),  # CentOS 5 w/ glibc 2.5 (PEP 513)
+    )
+    manylinux_support_iter = iter(manylinux_support)
+    for name, glibc_version in manylinux_support_iter:
+        if _is_manylinux_compatible(name, glibc_version):
+            platforms = [linux.replace("linux", name)]
+            break
+    else:
+        platforms = []
+    # Support for a later manylinux implies support for an earlier version.
+    platforms += [linux.replace("linux", name) for name, _ in manylinux_support_iter]
+    platforms.append(linux)
+    return platforms
+
+
+def _generic_platforms():
+    platform = _normalize_string(distutils.util.get_platform())
+    return [platform]
+
+
+def _interpreter_name():
+    name = platform.python_implementation().lower()
+    return INTERPRETER_SHORT_NAMES.get(name) or name
+
+
+def _generic_interpreter(name, py_version):
+    version = sysconfig.get_config_var("py_version_nodot")
+    if not version:
+        version = "".join(map(str, py_version[:2]))
+    return "{name}{version}".format(name=name, version=version)
+
+
+def sys_tags():
+    """
+    Returns the sequence of tag triples for the running interpreter.
+
+    The order of the sequence corresponds to priority order for the
+    interpreter, from most to least important.
+    """
+    py_version = sys.version_info[:2]
+    interpreter_name = _interpreter_name()
+    if platform.system() == "Darwin":
+        platforms = _mac_platforms()
+    elif platform.system() == "Linux":
+        platforms = _linux_platforms()
+    else:
+        platforms = _generic_platforms()
+
+    if interpreter_name == "cp":
+        interpreter = _cpython_interpreter(py_version)
+        abis = _cpython_abis(py_version)
+        for tag in _cpython_tags(py_version, interpreter, abis, platforms):
+            yield tag
+    elif interpreter_name == "pp":
+        interpreter = _pypy_interpreter()
+        abi = _generic_abi()
+        for tag in _pypy_tags(py_version, interpreter, abi, platforms):
+            yield tag
+    else:
+        interpreter = _generic_interpreter(interpreter_name, py_version)
+        abi = _generic_abi()
+        for tag in _generic_tags(interpreter, py_version, abi, platforms):
+            yield tag
+    for tag in _independent_tags(interpreter, py_version, platforms):
+        yield tag
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..88418786933b8bc5f6179b8e191f60f79efd7074
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py
@@ -0,0 +1,57 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import re
+
+from .version import InvalidVersion, Version
+
+
+_canonicalize_regex = re.compile(r"[-_.]+")
+
+
+def canonicalize_name(name):
+    # This is taken from PEP 503.
+    return _canonicalize_regex.sub("-", name).lower()
+
+
+def canonicalize_version(version):
+    """
+    This is very similar to Version.__str__, but has one subtle differences
+    with the way it handles the release segment.
+    """
+
+    try:
+        version = Version(version)
+    except InvalidVersion:
+        # Legacy versions cannot be normalized
+        return version
+
+    parts = []
+
+    # Epoch
+    if version.epoch != 0:
+        parts.append("{0}!".format(version.epoch))
+
+    # Release segment
+    # NB: This strips trailing '.0's to normalize
+    parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in version.release)))
+
+    # Pre-release
+    if version.pre is not None:
+        parts.append("".join(str(x) for x in version.pre))
+
+    # Post-release
+    if version.post is not None:
+        parts.append(".post{0}".format(version.post))
+
+    # Development release
+    if version.dev is not None:
+        parts.append(".dev{0}".format(version.dev))
+
+    # Local version segment
+    if version.local is not None:
+        parts.append("+{0}".format(version.local))
+
+    return "".join(parts)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..95157a1f78c26829ffbe1bd2463f7735b636d16f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.py
@@ -0,0 +1,420 @@
+# This file is dual licensed under the terms of the Apache License, Version
+# 2.0, and the BSD License. See the LICENSE file in the root of this repository
+# for complete details.
+from __future__ import absolute_import, division, print_function
+
+import collections
+import itertools
+import re
+
+from ._structures import Infinity
+
+
+__all__ = ["parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"]
+
+
+_Version = collections.namedtuple(
+    "_Version", ["epoch", "release", "dev", "pre", "post", "local"]
+)
+
+
+def parse(version):
+    """
+    Parse the given version string and return either a :class:`Version` object
+    or a :class:`LegacyVersion` object depending on if the given version is
+    a valid PEP 440 version or a legacy version.
+    """
+    try:
+        return Version(version)
+    except InvalidVersion:
+        return LegacyVersion(version)
+
+
+class InvalidVersion(ValueError):
+    """
+    An invalid version was found, users should refer to PEP 440.
+    """
+
+
+class _BaseVersion(object):
+    def __hash__(self):
+        return hash(self._key)
+
+    def __lt__(self, other):
+        return self._compare(other, lambda s, o: s < o)
+
+    def __le__(self, other):
+        return self._compare(other, lambda s, o: s <= o)
+
+    def __eq__(self, other):
+        return self._compare(other, lambda s, o: s == o)
+
+    def __ge__(self, other):
+        return self._compare(other, lambda s, o: s >= o)
+
+    def __gt__(self, other):
+        return self._compare(other, lambda s, o: s > o)
+
+    def __ne__(self, other):
+        return self._compare(other, lambda s, o: s != o)
+
+    def _compare(self, other, method):
+        if not isinstance(other, _BaseVersion):
+            return NotImplemented
+
+        return method(self._key, other._key)
+
+
+class LegacyVersion(_BaseVersion):
+    def __init__(self, version):
+        self._version = str(version)
+        self._key = _legacy_cmpkey(self._version)
+
+    def __str__(self):
+        return self._version
+
+    def __repr__(self):
+        return "<LegacyVersion({0})>".format(repr(str(self)))
+
+    @property
+    def public(self):
+        return self._version
+
+    @property
+    def base_version(self):
+        return self._version
+
+    @property
+    def epoch(self):
+        return -1
+
+    @property
+    def release(self):
+        return None
+
+    @property
+    def pre(self):
+        return None
+
+    @property
+    def post(self):
+        return None
+
+    @property
+    def dev(self):
+        return None
+
+    @property
+    def local(self):
+        return None
+
+    @property
+    def is_prerelease(self):
+        return False
+
+    @property
+    def is_postrelease(self):
+        return False
+
+    @property
+    def is_devrelease(self):
+        return False
+
+
+_legacy_version_component_re = re.compile(r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE)
+
+_legacy_version_replacement_map = {
+    "pre": "c",
+    "preview": "c",
+    "-": "final-",
+    "rc": "c",
+    "dev": "@",
+}
+
+
+def _parse_version_parts(s):
+    for part in _legacy_version_component_re.split(s):
+        part = _legacy_version_replacement_map.get(part, part)
+
+        if not part or part == ".":
+            continue
+
+        if part[:1] in "0123456789":
+            # pad for numeric comparison
+            yield part.zfill(8)
+        else:
+            yield "*" + part
+
+    # ensure that alpha/beta/candidate are before final
+    yield "*final"
+
+
+def _legacy_cmpkey(version):
+    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
+    # greater than or equal to 0. This will effectively put the LegacyVersion,
+    # which uses the defacto standard originally implemented by setuptools,
+    # as before all PEP 440 versions.
+    epoch = -1
+
+    # This scheme is taken from pkg_resources.parse_version setuptools prior to
+    # it's adoption of the packaging library.
+    parts = []
+    for part in _parse_version_parts(version.lower()):
+        if part.startswith("*"):
+            # remove "-" before a prerelease tag
+            if part < "*final":
+                while parts and parts[-1] == "*final-":
+                    parts.pop()
+
+            # remove trailing zeros from each series of numeric parts
+            while parts and parts[-1] == "00000000":
+                parts.pop()
+
+        parts.append(part)
+    parts = tuple(parts)
+
+    return epoch, parts
+
+
+# Deliberately not anchored to the start and end of the string, to make it
+# easier for 3rd party code to reuse
+VERSION_PATTERN = r"""
+    v?
+    (?:
+        (?:(?P<epoch>[0-9]+)!)?                           # epoch
+        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
+        (?P<pre>                                          # pre-release
+            [-_\.]?
+            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
+            [-_\.]?
+            (?P<pre_n>[0-9]+)?
+        )?
+        (?P<post>                                         # post release
+            (?:-(?P<post_n1>[0-9]+))
+            |
+            (?:
+                [-_\.]?
+                (?P<post_l>post|rev|r)
+                [-_\.]?
+                (?P<post_n2>[0-9]+)?
+            )
+        )?
+        (?P<dev>                                          # dev release
+            [-_\.]?
+            (?P<dev_l>dev)
+            [-_\.]?
+            (?P<dev_n>[0-9]+)?
+        )?
+    )
+    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
+"""
+
+
+class Version(_BaseVersion):
+
+    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
+
+    def __init__(self, version):
+        # Validate the version and parse it into pieces
+        match = self._regex.search(version)
+        if not match:
+            raise InvalidVersion("Invalid version: '{0}'".format(version))
+
+        # Store the parsed out pieces of the version
+        self._version = _Version(
+            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
+            release=tuple(int(i) for i in match.group("release").split(".")),
+            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
+            post=_parse_letter_version(
+                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
+            ),
+            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
+            local=_parse_local_version(match.group("local")),
+        )
+
+        # Generate a key which will be used for sorting
+        self._key = _cmpkey(
+            self._version.epoch,
+            self._version.release,
+            self._version.pre,
+            self._version.post,
+            self._version.dev,
+            self._version.local,
+        )
+
+    def __repr__(self):
+        return "<Version({0})>".format(repr(str(self)))
+
+    def __str__(self):
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        # Pre-release
+        if self.pre is not None:
+            parts.append("".join(str(x) for x in self.pre))
+
+        # Post-release
+        if self.post is not None:
+            parts.append(".post{0}".format(self.post))
+
+        # Development release
+        if self.dev is not None:
+            parts.append(".dev{0}".format(self.dev))
+
+        # Local version segment
+        if self.local is not None:
+            parts.append("+{0}".format(self.local))
+
+        return "".join(parts)
+
+    @property
+    def epoch(self):
+        return self._version.epoch
+
+    @property
+    def release(self):
+        return self._version.release
+
+    @property
+    def pre(self):
+        return self._version.pre
+
+    @property
+    def post(self):
+        return self._version.post[1] if self._version.post else None
+
+    @property
+    def dev(self):
+        return self._version.dev[1] if self._version.dev else None
+
+    @property
+    def local(self):
+        if self._version.local:
+            return ".".join(str(x) for x in self._version.local)
+        else:
+            return None
+
+    @property
+    def public(self):
+        return str(self).split("+", 1)[0]
+
+    @property
+    def base_version(self):
+        parts = []
+
+        # Epoch
+        if self.epoch != 0:
+            parts.append("{0}!".format(self.epoch))
+
+        # Release segment
+        parts.append(".".join(str(x) for x in self.release))
+
+        return "".join(parts)
+
+    @property
+    def is_prerelease(self):
+        return self.dev is not None or self.pre is not None
+
+    @property
+    def is_postrelease(self):
+        return self.post is not None
+
+    @property
+    def is_devrelease(self):
+        return self.dev is not None
+
+
+def _parse_letter_version(letter, number):
+    if letter:
+        # We consider there to be an implicit 0 in a pre-release if there is
+        # not a numeral associated with it.
+        if number is None:
+            number = 0
+
+        # We normalize any letters to their lower case form
+        letter = letter.lower()
+
+        # We consider some words to be alternate spellings of other words and
+        # in those cases we want to normalize the spellings to our preferred
+        # spelling.
+        if letter == "alpha":
+            letter = "a"
+        elif letter == "beta":
+            letter = "b"
+        elif letter in ["c", "pre", "preview"]:
+            letter = "rc"
+        elif letter in ["rev", "r"]:
+            letter = "post"
+
+        return letter, int(number)
+    if not letter and number:
+        # We assume if we are given a number, but we are not given a letter
+        # then this is using the implicit post release syntax (e.g. 1.0-1)
+        letter = "post"
+
+        return letter, int(number)
+
+
+_local_version_separators = re.compile(r"[\._-]")
+
+
+def _parse_local_version(local):
+    """
+    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
+    """
+    if local is not None:
+        return tuple(
+            part.lower() if not part.isdigit() else int(part)
+            for part in _local_version_separators.split(local)
+        )
+
+
+def _cmpkey(epoch, release, pre, post, dev, local):
+    # When we compare a release version, we want to compare it with all of the
+    # trailing zeros removed. So we'll use a reverse the list, drop all the now
+    # leading zeros until we come to something non zero, then take the rest
+    # re-reverse it back into the correct order and make it a tuple and use
+    # that for our sorting key.
+    release = tuple(
+        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
+    )
+
+    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
+    # We'll do this by abusing the pre segment, but we _only_ want to do this
+    # if there is not a pre or a post segment. If we have one of those then
+    # the normal sorting rules will handle this case correctly.
+    if pre is None and post is None and dev is not None:
+        pre = -Infinity
+    # Versions without a pre-release (except as noted above) should sort after
+    # those with one.
+    elif pre is None:
+        pre = Infinity
+
+    # Versions without a post segment should sort before those with one.
+    if post is None:
+        post = -Infinity
+
+    # Versions without a development segment should sort after those with one.
+    if dev is None:
+        dev = Infinity
+
+    if local is None:
+        # Versions without a local segment should sort before those with one.
+        local = -Infinity
+    else:
+        # Versions with a local segment need that segment parsed to implement
+        # the sorting rules in PEP440.
+        # - Alpha numeric segments sort before numeric segments
+        # - Alpha numeric segments sort lexicographically
+        # - Numeric segments sort numerically
+        # - Shorter versions sort before longer versions when the prefixes
+        #   match exactly
+        local = tuple((i, "") if isinstance(i, int) else (-Infinity, i) for i in local)
+
+    return epoch, release, pre, post, dev, local
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py
new file mode 100644
index 0000000000000000000000000000000000000000..cf75e1e5fcbfe7eac41d2a9e446c5c980741087b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py
@@ -0,0 +1,5742 @@
+# module pyparsing.py
+#
+# Copyright (c) 2003-2018  Paul T. McGuire
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+__doc__ = \
+"""
+pyparsing module - Classes and methods to define and execute parsing grammars
+=============================================================================
+
+The pyparsing module is an alternative approach to creating and executing simple grammars,
+vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
+don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
+provides a library of classes that you use to construct the grammar directly in Python.
+
+Here is a program to parse "Hello, World!" (or any greeting of the form 
+C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
+(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
+L{Literal} expressions)::
+
+    from pyparsing import Word, alphas
+
+    # define grammar of a greeting
+    greet = Word(alphas) + "," + Word(alphas) + "!"
+
+    hello = "Hello, World!"
+    print (hello, "->", greet.parseString(hello))
+
+The program outputs the following::
+
+    Hello, World! -> ['Hello', ',', 'World', '!']
+
+The Python representation of the grammar is quite readable, owing to the self-explanatory
+class names, and the use of '+', '|' and '^' operators.
+
+The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
+object with named attributes.
+
+The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
+ - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
+ - quoted strings
+ - embedded comments
+
+
+Getting Started -
+-----------------
+Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
+classes inherit from. Use the docstrings for examples of how to:
+ - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
+ - construct character word-group expressions using the L{Word} class
+ - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
+ - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
+ - associate names with your parsed results using L{ParserElement.setResultsName}
+ - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
+ - find more useful common expressions in the L{pyparsing_common} namespace class
+"""
+
+__version__ = "2.2.1"
+__versionTime__ = "18 Sep 2018 00:49 UTC"
+__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"
+
+import string
+from weakref import ref as wkref
+import copy
+import sys
+import warnings
+import re
+import sre_constants
+import collections
+import pprint
+import traceback
+import types
+from datetime import datetime
+
+try:
+    from _thread import RLock
+except ImportError:
+    from threading import RLock
+
+try:
+    # Python 3
+    from collections.abc import Iterable
+    from collections.abc import MutableMapping
+except ImportError:
+    # Python 2.7
+    from collections import Iterable
+    from collections import MutableMapping
+
+try:
+    from collections import OrderedDict as _OrderedDict
+except ImportError:
+    try:
+        from ordereddict import OrderedDict as _OrderedDict
+    except ImportError:
+        _OrderedDict = None
+
+#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )
+
+__all__ = [
+'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
+'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
+'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
+'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
+'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
+'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
+'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
+'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
+'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
+'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
+'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
+'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
+'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
+'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
+'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
+'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
+'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
+'CloseMatch', 'tokenMap', 'pyparsing_common',
+]
+
+system_version = tuple(sys.version_info)[:3]
+PY_3 = system_version[0] == 3
+if PY_3:
+    _MAX_INT = sys.maxsize
+    basestring = str
+    unichr = chr
+    _ustr = str
+
+    # build list of single arg builtins, that can be used as parse actions
+    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]
+
+else:
+    _MAX_INT = sys.maxint
+    range = xrange
+
+    def _ustr(obj):
+        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
+           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
+           then < returns the unicode object | encodes it with the default encoding | ... >.
+        """
+        if isinstance(obj,unicode):
+            return obj
+
+        try:
+            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
+            # it won't break any existing code.
+            return str(obj)
+
+        except UnicodeEncodeError:
+            # Else encode it
+            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
+            xmlcharref = Regex(r'&#\d+;')
+            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
+            return xmlcharref.transformString(ret)
+
+    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
+    singleArgBuiltins = []
+    import __builtin__
+    for fname in "sum len sorted reversed list tuple set any all min max".split():
+        try:
+            singleArgBuiltins.append(getattr(__builtin__,fname))
+        except AttributeError:
+            continue
+            
+_generatorType = type((y for y in range(1)))
+ 
+def _xml_escape(data):
+    """Escape &, <, >, ", ', etc. in a string of data."""
+
+    # ampersand must be replaced first
+    from_symbols = '&><"\''
+    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
+    for from_,to_ in zip(from_symbols, to_symbols):
+        data = data.replace(from_, to_)
+    return data
+
+class _Constants(object):
+    pass
+
+alphas     = string.ascii_uppercase + string.ascii_lowercase
+nums       = "0123456789"
+hexnums    = nums + "ABCDEFabcdef"
+alphanums  = alphas + nums
+_bslash    = chr(92)
+printables = "".join(c for c in string.printable if c not in string.whitespace)
+
+class ParseBaseException(Exception):
+    """base exception class for all parsing runtime exceptions"""
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, pstr, loc=0, msg=None, elem=None ):
+        self.loc = loc
+        if msg is None:
+            self.msg = pstr
+            self.pstr = ""
+        else:
+            self.msg = msg
+            self.pstr = pstr
+        self.parserElement = elem
+        self.args = (pstr, loc, msg)
+
+    @classmethod
+    def _from_exception(cls, pe):
+        """
+        internal factory method to simplify creating one type of ParseException 
+        from another - avoids having __init__ signature conflicts among subclasses
+        """
+        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)
+
+    def __getattr__( self, aname ):
+        """supported attributes by name are:
+            - lineno - returns the line number of the exception text
+            - col - returns the column number of the exception text
+            - line - returns the line containing the exception text
+        """
+        if( aname == "lineno" ):
+            return lineno( self.loc, self.pstr )
+        elif( aname in ("col", "column") ):
+            return col( self.loc, self.pstr )
+        elif( aname == "line" ):
+            return line( self.loc, self.pstr )
+        else:
+            raise AttributeError(aname)
+
+    def __str__( self ):
+        return "%s (at char %d), (line:%d, col:%d)" % \
+                ( self.msg, self.loc, self.lineno, self.column )
+    def __repr__( self ):
+        return _ustr(self)
+    def markInputline( self, markerString = ">!<" ):
+        """Extracts the exception line from the input string, and marks
+           the location of the exception with a special symbol.
+        """
+        line_str = self.line
+        line_column = self.column - 1
+        if markerString:
+            line_str = "".join((line_str[:line_column],
+                                markerString, line_str[line_column:]))
+        return line_str.strip()
+    def __dir__(self):
+        return "lineno col line".split() + dir(type(self))
+
+class ParseException(ParseBaseException):
+    """
+    Exception thrown when parse expressions don't match class;
+    supported attributes by name are:
+     - lineno - returns the line number of the exception text
+     - col - returns the column number of the exception text
+     - line - returns the line containing the exception text
+        
+    Example::
+        try:
+            Word(nums).setName("integer").parseString("ABC")
+        except ParseException as pe:
+            print(pe)
+            print("column: {}".format(pe.col))
+            
+    prints::
+       Expected integer (at char 0), (line:1, col:1)
+        column: 1
+    """
+    pass
+
+class ParseFatalException(ParseBaseException):
+    """user-throwable exception thrown when inconsistent parse content
+       is found; stops all parsing immediately"""
+    pass
+
+class ParseSyntaxException(ParseFatalException):
+    """just like L{ParseFatalException}, but thrown internally when an
+       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
+       immediately because an unbacktrackable syntax error has been found"""
+    pass
+
+#~ class ReparseException(ParseBaseException):
+    #~ """Experimental class - parse actions can raise this exception to cause
+       #~ pyparsing to reparse the input string:
+        #~ - with a modified input string, and/or
+        #~ - with a modified start location
+       #~ Set the values of the ReparseException in the constructor, and raise the
+       #~ exception in a parse action to cause pyparsing to use the new string/location.
+       #~ Setting the values as None causes no change to be made.
+       #~ """
+    #~ def __init_( self, newstring, restartLoc ):
+        #~ self.newParseText = newstring
+        #~ self.reparseLoc = restartLoc
+
+class RecursiveGrammarException(Exception):
+    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
+    def __init__( self, parseElementList ):
+        self.parseElementTrace = parseElementList
+
+    def __str__( self ):
+        return "RecursiveGrammarException: %s" % self.parseElementTrace
+
+class _ParseResultsWithOffset(object):
+    def __init__(self,p1,p2):
+        self.tup = (p1,p2)
+    def __getitem__(self,i):
+        return self.tup[i]
+    def __repr__(self):
+        return repr(self.tup[0])
+    def setOffset(self,i):
+        self.tup = (self.tup[0],i)
+
+class ParseResults(object):
+    """
+    Structured parse results, to provide multiple means of access to the parsed data:
+       - as a list (C{len(results)})
+       - by list index (C{results[0], results[1]}, etc.)
+       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})
+
+    Example::
+        integer = Word(nums)
+        date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+        # equivalent form:
+        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+
+        # parseString returns a ParseResults object
+        result = date_str.parseString("1999/12/31")
+
+        def test(s, fn=repr):
+            print("%s -> %s" % (s, fn(eval(s))))
+        test("list(result)")
+        test("result[0]")
+        test("result['month']")
+        test("result.day")
+        test("'month' in result")
+        test("'minutes' in result")
+        test("result.dump()", str)
+    prints::
+        list(result) -> ['1999', '/', '12', '/', '31']
+        result[0] -> '1999'
+        result['month'] -> '12'
+        result.day -> '31'
+        'month' in result -> True
+        'minutes' in result -> False
+        result.dump() -> ['1999', '/', '12', '/', '31']
+        - day: 31
+        - month: 12
+        - year: 1999
+    """
+    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
+        if isinstance(toklist, cls):
+            return toklist
+        retobj = object.__new__(cls)
+        retobj.__doinit = True
+        return retobj
+
+    # Performance tuning: we construct a *lot* of these, so keep this
+    # constructor as small and fast as possible
+    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
+        if self.__doinit:
+            self.__doinit = False
+            self.__name = None
+            self.__parent = None
+            self.__accumNames = {}
+            self.__asList = asList
+            self.__modal = modal
+            if toklist is None:
+                toklist = []
+            if isinstance(toklist, list):
+                self.__toklist = toklist[:]
+            elif isinstance(toklist, _generatorType):
+                self.__toklist = list(toklist)
+            else:
+                self.__toklist = [toklist]
+            self.__tokdict = dict()
+
+        if name is not None and name:
+            if not modal:
+                self.__accumNames[name] = 0
+            if isinstance(name,int):
+                name = _ustr(name) # will always return a str, but use _ustr for consistency
+            self.__name = name
+            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
+                if isinstance(toklist,basestring):
+                    toklist = [ toklist ]
+                if asList:
+                    if isinstance(toklist,ParseResults):
+                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
+                    else:
+                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
+                    self[name].__name = name
+                else:
+                    try:
+                        self[name] = toklist[0]
+                    except (KeyError,TypeError,IndexError):
+                        self[name] = toklist
+
+    def __getitem__( self, i ):
+        if isinstance( i, (int,slice) ):
+            return self.__toklist[i]
+        else:
+            if i not in self.__accumNames:
+                return self.__tokdict[i][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[i] ])
+
+    def __setitem__( self, k, v, isinstance=isinstance ):
+        if isinstance(v,_ParseResultsWithOffset):
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
+            sub = v[0]
+        elif isinstance(k,(int,slice)):
+            self.__toklist[k] = v
+            sub = v
+        else:
+            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
+            sub = v
+        if isinstance(sub,ParseResults):
+            sub.__parent = wkref(self)
+
+    def __delitem__( self, i ):
+        if isinstance(i,(int,slice)):
+            mylen = len( self.__toklist )
+            del self.__toklist[i]
+
+            # convert int to slice
+            if isinstance(i, int):
+                if i < 0:
+                    i += mylen
+                i = slice(i, i+1)
+            # get removed indices
+            removed = list(range(*i.indices(mylen)))
+            removed.reverse()
+            # fixup indices in token dictionary
+            for name,occurrences in self.__tokdict.items():
+                for j in removed:
+                    for k, (value, position) in enumerate(occurrences):
+                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
+        else:
+            del self.__tokdict[i]
+
+    def __contains__( self, k ):
+        return k in self.__tokdict
+
+    def __len__( self ): return len( self.__toklist )
+    def __bool__(self): return ( not not self.__toklist )
+    __nonzero__ = __bool__
+    def __iter__( self ): return iter( self.__toklist )
+    def __reversed__( self ): return iter( self.__toklist[::-1] )
+    def _iterkeys( self ):
+        if hasattr(self.__tokdict, "iterkeys"):
+            return self.__tokdict.iterkeys()
+        else:
+            return iter(self.__tokdict)
+
+    def _itervalues( self ):
+        return (self[k] for k in self._iterkeys())
+            
+    def _iteritems( self ):
+        return ((k, self[k]) for k in self._iterkeys())
+
+    if PY_3:
+        keys = _iterkeys       
+        """Returns an iterator of all named result keys (Python 3.x only)."""
+
+        values = _itervalues
+        """Returns an iterator of all named result values (Python 3.x only)."""
+
+        items = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""
+
+    else:
+        iterkeys = _iterkeys
+        """Returns an iterator of all named result keys (Python 2.x only)."""
+
+        itervalues = _itervalues
+        """Returns an iterator of all named result values (Python 2.x only)."""
+
+        iteritems = _iteritems
+        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""
+
+        def keys( self ):
+            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iterkeys())
+
+        def values( self ):
+            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.itervalues())
+                
+        def items( self ):
+            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
+            return list(self.iteritems())
+
+    def haskeys( self ):
+        """Since keys() returns an iterator, this method is helpful in bypassing
+           code that looks for the existence of any defined results names."""
+        return bool(self.__tokdict)
+        
+    def pop( self, *args, **kwargs):
+        """
+        Removes and returns item at specified index (default=C{last}).
+        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
+        argument or an integer argument, it will use C{list} semantics
+        and pop tokens from the list of parsed tokens. If passed a 
+        non-integer argument (most likely a string), it will use C{dict}
+        semantics and pop the corresponding value from any defined 
+        results names. A second default return value argument is 
+        supported, just as in C{dict.pop()}.
+
+        Example::
+            def remove_first(tokens):
+                tokens.pop(0)
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']
+
+            label = Word(alphas)
+            patt = label("LABEL") + OneOrMore(Word(nums))
+            print(patt.parseString("AAB 123 321").dump())
+
+            # Use pop() in a parse action to remove named result (note that corresponding value is not
+            # removed from list form of results)
+            def remove_LABEL(tokens):
+                tokens.pop("LABEL")
+                return tokens
+            patt.addParseAction(remove_LABEL)
+            print(patt.parseString("AAB 123 321").dump())
+        prints::
+            ['AAB', '123', '321']
+            - LABEL: AAB
+
+            ['AAB', '123', '321']
+        """
+        if not args:
+            args = [-1]
+        for k,v in kwargs.items():
+            if k == 'default':
+                args = (args[0], v)
+            else:
+                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
+        if (isinstance(args[0], int) or 
+                        len(args) == 1 or 
+                        args[0] in self):
+            index = args[0]
+            ret = self[index]
+            del self[index]
+            return ret
+        else:
+            defaultvalue = args[1]
+            return defaultvalue
+
+    def get(self, key, defaultValue=None):
+        """
+        Returns named result matching the given key, or if there is no
+        such name, then returns the given C{defaultValue} or C{None} if no
+        C{defaultValue} is specified.
+
+        Similar to C{dict.get()}.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            result = date_str.parseString("1999/12/31")
+            print(result.get("year")) # -> '1999'
+            print(result.get("hour", "not specified")) # -> 'not specified'
+            print(result.get("hour")) # -> None
+        """
+        if key in self:
+            return self[key]
+        else:
+            return defaultValue
+
+    def insert( self, index, insStr ):
+        """
+        Inserts new element at location index in the list of parsed tokens.
+        
+        Similar to C{list.insert()}.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+
+            # use a parse action to insert the parse location in the front of the parsed results
+            def insert_locn(locn, tokens):
+                tokens.insert(0, locn)
+            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
+        """
+        self.__toklist.insert(index, insStr)
+        # fixup indices in token dictionary
+        for name,occurrences in self.__tokdict.items():
+            for k, (value, position) in enumerate(occurrences):
+                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))
+
+    def append( self, item ):
+        """
+        Add single element to end of ParseResults list of elements.
+
+        Example::
+            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
+            
+            # use a parse action to compute the sum of the parsed integers, and add it to the end
+            def append_sum(tokens):
+                tokens.append(sum(map(int, tokens)))
+            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
+        """
+        self.__toklist.append(item)
+
+    def extend( self, itemseq ):
+        """
+        Add sequence of elements to end of ParseResults list of elements.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            
+            # use a parse action to append the reverse of the matched strings, to make a palindrome
+            def make_palindrome(tokens):
+                tokens.extend(reversed([t[::-1] for t in tokens]))
+                return ''.join(tokens)
+            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
+        """
+        if isinstance(itemseq, ParseResults):
+            self += itemseq
+        else:
+            self.__toklist.extend(itemseq)
+
+    def clear( self ):
+        """
+        Clear all elements and results names.
+        """
+        del self.__toklist[:]
+        self.__tokdict.clear()
+
+    def __getattr__( self, name ):
+        try:
+            return self[name]
+        except KeyError:
+            return ""
+            
+        if name in self.__tokdict:
+            if name not in self.__accumNames:
+                return self.__tokdict[name][-1][0]
+            else:
+                return ParseResults([ v[0] for v in self.__tokdict[name] ])
+        else:
+            return ""
+
+    def __add__( self, other ):
+        ret = self.copy()
+        ret += other
+        return ret
+
+    def __iadd__( self, other ):
+        if other.__tokdict:
+            offset = len(self.__toklist)
+            addoffset = lambda a: offset if a<0 else a+offset
+            otheritems = other.__tokdict.items()
+            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
+                                for (k,vlist) in otheritems for v in vlist]
+            for k,v in otherdictitems:
+                self[k] = v
+                if isinstance(v[0],ParseResults):
+                    v[0].__parent = wkref(self)
+            
+        self.__toklist += other.__toklist
+        self.__accumNames.update( other.__accumNames )
+        return self
+
+    def __radd__(self, other):
+        if isinstance(other,int) and other == 0:
+            # useful for merging many ParseResults using sum() builtin
+            return self.copy()
+        else:
+            # this may raise a TypeError - so be it
+            return other + self
+        
+    def __repr__( self ):
+        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )
+
+    def __str__( self ):
+        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'
+
+    def _asStringList( self, sep='' ):
+        out = []
+        for item in self.__toklist:
+            if out and sep:
+                out.append(sep)
+            if isinstance( item, ParseResults ):
+                out += item._asStringList()
+            else:
+                out.append( _ustr(item) )
+        return out
+
+    def asList( self ):
+        """
+        Returns the parse results as a nested list of matching tokens, all converted to strings.
+
+        Example::
+            patt = OneOrMore(Word(alphas))
+            result = patt.parseString("sldkj lsdkj sldkj")
+            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
+            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
+            
+            # Use asList() to create an actual list
+            result_list = result.asList()
+            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
+        """
+        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]
+
+    def asDict( self ):
+        """
+        Returns the named parse results as a nested dictionary.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
+            
+            result_dict = result.asDict()
+            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}
+
+            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
+            import json
+            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
+            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
+        """
+        if PY_3:
+            item_fn = self.items
+        else:
+            item_fn = self.iteritems
+            
+        def toItem(obj):
+            if isinstance(obj, ParseResults):
+                if obj.haskeys():
+                    return obj.asDict()
+                else:
+                    return [toItem(v) for v in obj]
+            else:
+                return obj
+                
+        return dict((k,toItem(v)) for k,v in item_fn())
+
+    def copy( self ):
+        """
+        Returns a new copy of a C{ParseResults} object.
+        """
+        ret = ParseResults( self.__toklist )
+        ret.__tokdict = self.__tokdict.copy()
+        ret.__parent = self.__parent
+        ret.__accumNames.update( self.__accumNames )
+        ret.__name = self.__name
+        return ret
+
+    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
+        """
+        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
+        """
+        nl = "\n"
+        out = []
+        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
+                                                            for v in vlist)
+        nextLevelIndent = indent + "  "
+
+        # collapse out indents if formatting is not desired
+        if not formatted:
+            indent = ""
+            nextLevelIndent = ""
+            nl = ""
+
+        selfTag = None
+        if doctag is not None:
+            selfTag = doctag
+        else:
+            if self.__name:
+                selfTag = self.__name
+
+        if not selfTag:
+            if namedItemsOnly:
+                return ""
+            else:
+                selfTag = "ITEM"
+
+        out += [ nl, indent, "<", selfTag, ">" ]
+
+        for i,res in enumerate(self.__toklist):
+            if isinstance(res,ParseResults):
+                if i in namedItems:
+                    out += [ res.asXML(namedItems[i],
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+                else:
+                    out += [ res.asXML(None,
+                                        namedItemsOnly and doctag is None,
+                                        nextLevelIndent,
+                                        formatted)]
+            else:
+                # individual token, see if there is a name for it
+                resTag = None
+                if i in namedItems:
+                    resTag = namedItems[i]
+                if not resTag:
+                    if namedItemsOnly:
+                        continue
+                    else:
+                        resTag = "ITEM"
+                xmlBodyText = _xml_escape(_ustr(res))
+                out += [ nl, nextLevelIndent, "<", resTag, ">",
+                                                xmlBodyText,
+                                                "</", resTag, ">" ]
+
+        out += [ nl, indent, "</", selfTag, ">" ]
+        return "".join(out)
+
+    def __lookup(self,sub):
+        for k,vlist in self.__tokdict.items():
+            for v,loc in vlist:
+                if sub is v:
+                    return k
+        return None
+
+    def getName(self):
+        r"""
+        Returns the results name for this token expression. Useful when several 
+        different expressions might match at a particular location.
+
+        Example::
+            integer = Word(nums)
+            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
+            house_number_expr = Suppress('#') + Word(nums, alphanums)
+            user_data = (Group(house_number_expr)("house_number") 
+                        | Group(ssn_expr)("ssn")
+                        | Group(integer)("age"))
+            user_info = OneOrMore(user_data)
+            
+            result = user_info.parseString("22 111-22-3333 #221B")
+            for item in result:
+                print(item.getName(), ':', item[0])
+        prints::
+            age : 22
+            ssn : 111-22-3333
+            house_number : 221B
+        """
+        if self.__name:
+            return self.__name
+        elif self.__parent:
+            par = self.__parent()
+            if par:
+                return par.__lookup(self)
+            else:
+                return None
+        elif (len(self) == 1 and
+               len(self.__tokdict) == 1 and
+               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
+            return next(iter(self.__tokdict.keys()))
+        else:
+            return None
+
+    def dump(self, indent='', depth=0, full=True):
+        """
+        Diagnostic method for listing out the contents of a C{ParseResults}.
+        Accepts an optional C{indent} argument so that this string can be embedded
+        in a nested display of other data.
+
+        Example::
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+            
+            result = date_str.parseString('12/31/1999')
+            print(result.dump())
+        prints::
+            ['12', '/', '31', '/', '1999']
+            - day: 1999
+            - month: 31
+            - year: 12
+        """
+        out = []
+        NL = '\n'
+        out.append( indent+_ustr(self.asList()) )
+        if full:
+            if self.haskeys():
+                items = sorted((str(k), v) for k,v in self.items())
+                for k,v in items:
+                    if out:
+                        out.append(NL)
+                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
+                    if isinstance(v,ParseResults):
+                        if v:
+                            out.append( v.dump(indent,depth+1) )
+                        else:
+                            out.append(_ustr(v))
+                    else:
+                        out.append(repr(v))
+            elif any(isinstance(vv,ParseResults) for vv in self):
+                v = self
+                for i,vv in enumerate(v):
+                    if isinstance(vv,ParseResults):
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
+                    else:
+                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
+            
+        return "".join(out)
+
+    def pprint(self, *args, **kwargs):
+        """
+        Pretty-printer for parsed results as a list, using the C{pprint} module.
+        Accepts additional positional or keyword args as defined for the 
+        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})
+
+        Example::
+            ident = Word(alphas, alphanums)
+            num = Word(nums)
+            func = Forward()
+            term = ident | num | Group('(' + func + ')')
+            func <<= ident + Group(Optional(delimitedList(term)))
+            result = func.parseString("fna a,b,(fnb c,d,200),100")
+            result.pprint(width=40)
+        prints::
+            ['fna',
+             ['a',
+              'b',
+              ['(', 'fnb', ['c', 'd', '200'], ')'],
+              '100']]
+        """
+        pprint.pprint(self.asList(), *args, **kwargs)
+
+    # add support for pickle protocol
+    def __getstate__(self):
+        return ( self.__toklist,
+                 ( self.__tokdict.copy(),
+                   self.__parent is not None and self.__parent() or None,
+                   self.__accumNames,
+                   self.__name ) )
+
+    def __setstate__(self,state):
+        self.__toklist = state[0]
+        (self.__tokdict,
+         par,
+         inAccumNames,
+         self.__name) = state[1]
+        self.__accumNames = {}
+        self.__accumNames.update(inAccumNames)
+        if par is not None:
+            self.__parent = wkref(par)
+        else:
+            self.__parent = None
+
+    def __getnewargs__(self):
+        return self.__toklist, self.__name, self.__asList, self.__modal
+
+    def __dir__(self):
+        return (dir(type(self)) + list(self.keys()))
+
+MutableMapping.register(ParseResults)
+
+def col (loc,strg):
+    """Returns current column within a string, counting newlines as line separators.
+   The first column is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
+   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    s = strg
+    return 1 if 0<loc<len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)
+
+def lineno(loc,strg):
+    """Returns current line number within a string, counting newlines as line separators.
+   The first line is number 1.
+
+   Note: the default parsing behavior is to expand tabs in the input string
+   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
+   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+   consistent view of the parsed string, the parse location, and line and column
+   positions within the parsed string.
+   """
+    return strg.count("\n",0,loc) + 1
+
+def line( loc, strg ):
+    """Returns the line of text containing loc within a string, counting newlines as line separators.
+       """
+    lastCR = strg.rfind("\n", 0, loc)
+    nextCR = strg.find("\n", loc)
+    if nextCR >= 0:
+        return strg[lastCR+1:nextCR]
+    else:
+        return strg[lastCR+1:]
+
+def _defaultStartDebugAction( instring, loc, expr ):
+    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))
+
+def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
+    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))
+
+def _defaultExceptionDebugAction( instring, loc, expr, exc ):
+    print ("Exception raised:" + _ustr(exc))
+
+def nullDebugAction(*args):
+    """'Do-nothing' debug action, to suppress debugging output during parsing."""
+    pass
+
+# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
+#~ 'decorator to trim function calls to match the arity of the target'
+#~ def _trim_arity(func, maxargs=3):
+    #~ if func in singleArgBuiltins:
+        #~ return lambda s,l,t: func(t)
+    #~ limit = 0
+    #~ foundArity = False
+    #~ def wrapper(*args):
+        #~ nonlocal limit,foundArity
+        #~ while 1:
+            #~ try:
+                #~ ret = func(*args[limit:])
+                #~ foundArity = True
+                #~ return ret
+            #~ except TypeError:
+                #~ if limit == maxargs or foundArity:
+                    #~ raise
+                #~ limit += 1
+                #~ continue
+    #~ return wrapper
+
+# this version is Python 2.x-3.x cross-compatible
+'decorator to trim function calls to match the arity of the target'
+def _trim_arity(func, maxargs=2):
+    if func in singleArgBuiltins:
+        return lambda s,l,t: func(t)
+    limit = [0]
+    foundArity = [False]
+    
+    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
+    if system_version[:2] >= (3,5):
+        def extract_stack(limit=0):
+            # special handling for Python 3.5.0 - extra deep call stack by 1
+            offset = -3 if system_version == (3,5,0) else -2
+            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
+            return [frame_summary[:2]]
+        def extract_tb(tb, limit=0):
+            frames = traceback.extract_tb(tb, limit=limit)
+            frame_summary = frames[-1]
+            return [frame_summary[:2]]
+    else:
+        extract_stack = traceback.extract_stack
+        extract_tb = traceback.extract_tb
+    
+    # synthesize what would be returned by traceback.extract_stack at the call to 
+    # user's parse action 'func', so that we don't incur call penalty at parse time
+    
+    LINE_DIFF = 6
+    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
+    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
+    this_line = extract_stack(limit=2)[-1]
+    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)
+
+    def wrapper(*args):
+        while 1:
+            try:
+                ret = func(*args[limit[0]:])
+                foundArity[0] = True
+                return ret
+            except TypeError:
+                # re-raise TypeErrors if they did not come from our arity testing
+                if foundArity[0]:
+                    raise
+                else:
+                    try:
+                        tb = sys.exc_info()[-1]
+                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
+                            raise
+                    finally:
+                        del tb
+
+                if limit[0] <= maxargs:
+                    limit[0] += 1
+                    continue
+                raise
+
+    # copy func name to wrapper for sensible debug output
+    func_name = "<parse action>"
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    wrapper.__name__ = func_name
+
+    return wrapper
+
+class ParserElement(object):
+    """Abstract base level parser element class."""
+    DEFAULT_WHITE_CHARS = " \n\t\r"
+    verbose_stacktrace = False
+
+    @staticmethod
+    def setDefaultWhitespaceChars( chars ):
+        r"""
+        Overrides the default whitespace chars
+
+        Example::
+            # default whitespace chars are space, <TAB> and newline
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
+            
+            # change to just treat newline as significant
+            ParserElement.setDefaultWhitespaceChars(" \t")
+            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
+        """
+        ParserElement.DEFAULT_WHITE_CHARS = chars
+
+    @staticmethod
+    def inlineLiteralsUsing(cls):
+        """
+        Set class to be used for inclusion of string literals into a parser.
+        
+        Example::
+            # default literal class used is Literal
+            integer = Word(nums)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+
+            # change to Suppress
+            ParserElement.inlineLiteralsUsing(Suppress)
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
+        """
+        ParserElement._literalStringClass = cls
+
+    def __init__( self, savelist=False ):
+        self.parseAction = list()
+        self.failAction = None
+        #~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
+        self.strRepr = None
+        self.resultsName = None
+        self.saveAsList = savelist
+        self.skipWhitespace = True
+        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        self.copyDefaultWhiteChars = True
+        self.mayReturnEmpty = False # used when checking for left-recursion
+        self.keepTabs = False
+        self.ignoreExprs = list()
+        self.debug = False
+        self.streamlined = False
+        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
+        self.errmsg = ""
+        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
+        self.debugActions = ( None, None, None ) #custom debug actions
+        self.re = None
+        self.callPreparse = True # used to avoid redundant calls to preParse
+        self.callDuringTry = False
+
+    def copy( self ):
+        """
+        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
+        for the same parsing pattern, using copies of the original parse element.
+        
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
+            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+            
+            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
+        prints::
+            [5120, 100, 655360, 268435456]
+        Equivalent form of C{expr.copy()} is just C{expr()}::
+            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
+        """
+        cpy = copy.copy( self )
+        cpy.parseAction = self.parseAction[:]
+        cpy.ignoreExprs = self.ignoreExprs[:]
+        if self.copyDefaultWhiteChars:
+            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
+        return cpy
+
+    def setName( self, name ):
+        """
+        Define name for this expression, makes debugging and exception messages clearer.
+        
+        Example::
+            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
+            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
+        """
+        self.name = name
+        self.errmsg = "Expected " + self.name
+        if hasattr(self,"exception"):
+            self.exception.msg = self.errmsg
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        """
+        Define name for referencing matching tokens as a nested attribute
+        of the returned parse results.
+        NOTE: this returns a *copy* of the original C{ParserElement} object;
+        this is so that the client can define a basic element, such as an
+        integer, and reference it in multiple places with different names.
+
+        You can also set results names using the abbreviated syntax,
+        C{expr("name")} in place of C{expr.setResultsName("name")} - 
+        see L{I{__call__}<__call__>}.
+
+        Example::
+            date_str = (integer.setResultsName("year") + '/' 
+                        + integer.setResultsName("month") + '/' 
+                        + integer.setResultsName("day"))
+
+            # equivalent form:
+            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
+        """
+        newself = self.copy()
+        if name.endswith("*"):
+            name = name[:-1]
+            listAllMatches=True
+        newself.resultsName = name
+        newself.modalResults = not listAllMatches
+        return newself
+
+    def setBreak(self,breakFlag = True):
+        """Method to invoke the Python pdb debugger when this element is
+           about to be parsed. Set C{breakFlag} to True to enable, False to
+           disable.
+        """
+        if breakFlag:
+            _parseMethod = self._parse
+            def breaker(instring, loc, doActions=True, callPreParse=True):
+                import pdb
+                pdb.set_trace()
+                return _parseMethod( instring, loc, doActions, callPreParse )
+            breaker._originalParseMethod = _parseMethod
+            self._parse = breaker
+        else:
+            if hasattr(self._parse,"_originalParseMethod"):
+                self._parse = self._parse._originalParseMethod
+        return self
+
+    def setParseAction( self, *fns, **kwargs ):
+        """
+        Define one or more actions to perform when successfully matching parse element definition.
+        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
+        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
+         - s   = the original string being parsed (see note below)
+         - loc = the location of the matching substring
+         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
+        If the functions in fns modify the tokens, they can return them as the return
+        value from fn, and the modified list of tokens will replace the original.
+        Otherwise, fn does not need to return any value.
+
+        Optional keyword arguments:
+         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing
+
+        Note: the default parsing behavior is to expand tabs in the input string
+        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
+        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
+        consistent view of the parsed string, the parse location, and line and column
+        positions within the parsed string.
+        
+        Example::
+            integer = Word(nums)
+            date_str = integer + '/' + integer + '/' + integer
+
+            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']
+
+            # use parse action to convert to ints at parse time
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            date_str = integer + '/' + integer + '/' + integer
+
+            # note that integer fields are now ints, not strings
+            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
+        """
+        self.parseAction = list(map(_trim_arity, list(fns)))
+        self.callDuringTry = kwargs.get("callDuringTry", False)
+        return self
+
+    def addParseAction( self, *fns, **kwargs ):
+        """
+        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
+        
+        See examples in L{I{copy}<copy>}.
+        """
+        self.parseAction += list(map(_trim_arity, list(fns)))
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def addCondition(self, *fns, **kwargs):
+        """Add a boolean predicate function to expression's list of parse actions. See 
+        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
+        functions passed to C{addCondition} need to return boolean success/fail of the condition.
+
+        Optional keyword arguments:
+         - message = define a custom message to be used in the raised exception
+         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
+         
+        Example::
+            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
+            year_int = integer.copy()
+            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
+            date_str = year_int + '/' + integer + '/' + integer
+
+            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
+        """
+        msg = kwargs.get("message", "failed user-defined condition")
+        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
+        for fn in fns:
+            def pa(s,l,t):
+                if not bool(_trim_arity(fn)(s,l,t)):
+                    raise exc_type(s,l,msg)
+            self.parseAction.append(pa)
+        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
+        return self
+
+    def setFailAction( self, fn ):
+        """Define action to perform if parsing fails at this expression.
+           Fail acton fn is a callable function that takes the arguments
+           C{fn(s,loc,expr,err)} where:
+            - s = string being parsed
+            - loc = location where expression match was attempted and failed
+            - expr = the parse expression that failed
+            - err = the exception thrown
+           The function returns no value.  It may throw C{L{ParseFatalException}}
+           if it is desired to stop parsing immediately."""
+        self.failAction = fn
+        return self
+
+    def _skipIgnorables( self, instring, loc ):
+        exprsFound = True
+        while exprsFound:
+            exprsFound = False
+            for e in self.ignoreExprs:
+                try:
+                    while 1:
+                        loc,dummy = e._parse( instring, loc )
+                        exprsFound = True
+                except ParseException:
+                    pass
+        return loc
+
+    def preParse( self, instring, loc ):
+        if self.ignoreExprs:
+            loc = self._skipIgnorables( instring, loc )
+
+        if self.skipWhitespace:
+            wt = self.whiteChars
+            instrlen = len(instring)
+            while loc < instrlen and instring[loc] in wt:
+                loc += 1
+
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        return loc, []
+
+    def postParse( self, instring, loc, tokenlist ):
+        return tokenlist
+
+    #~ @profile
+    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
+        debugging = ( self.debug ) #and doActions )
+
+        if debugging or self.failAction:
+            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
+            if (self.debugActions[0] ):
+                self.debugActions[0]( instring, loc, self )
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            try:
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            except ParseBaseException as err:
+                #~ print ("Exception raised:", err)
+                if self.debugActions[2]:
+                    self.debugActions[2]( instring, tokensStart, self, err )
+                if self.failAction:
+                    self.failAction( instring, tokensStart, self, err )
+                raise
+        else:
+            if callPreParse and self.callPreparse:
+                preloc = self.preParse( instring, loc )
+            else:
+                preloc = loc
+            tokensStart = preloc
+            if self.mayIndexError or preloc >= len(instring):
+                try:
+                    loc,tokens = self.parseImpl( instring, preloc, doActions )
+                except IndexError:
+                    raise ParseException( instring, len(instring), self.errmsg, self )
+            else:
+                loc,tokens = self.parseImpl( instring, preloc, doActions )
+
+        tokens = self.postParse( instring, loc, tokens )
+
+        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
+        if self.parseAction and (doActions or self.callDuringTry):
+            if debugging:
+                try:
+                    for fn in self.parseAction:
+                        tokens = fn( instring, tokensStart, retTokens )
+                        if tokens is not None:
+                            retTokens = ParseResults( tokens,
+                                                      self.resultsName,
+                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                      modal=self.modalResults )
+                except ParseBaseException as err:
+                    #~ print "Exception raised in user parse action:", err
+                    if (self.debugActions[2] ):
+                        self.debugActions[2]( instring, tokensStart, self, err )
+                    raise
+            else:
+                for fn in self.parseAction:
+                    tokens = fn( instring, tokensStart, retTokens )
+                    if tokens is not None:
+                        retTokens = ParseResults( tokens,
+                                                  self.resultsName,
+                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
+                                                  modal=self.modalResults )
+        if debugging:
+            #~ print ("Matched",self,"->",retTokens.asList())
+            if (self.debugActions[1] ):
+                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )
+
+        return loc, retTokens
+
+    def tryParse( self, instring, loc ):
+        try:
+            return self._parse( instring, loc, doActions=False )[0]
+        except ParseFatalException:
+            raise ParseException( instring, loc, self.errmsg, self)
+    
+    def canParseNext(self, instring, loc):
+        try:
+            self.tryParse(instring, loc)
+        except (ParseException, IndexError):
+            return False
+        else:
+            return True
+
+    class _UnboundedCache(object):
+        def __init__(self):
+            cache = {}
+            self.not_in_cache = not_in_cache = object()
+
+            def get(self, key):
+                return cache.get(key, not_in_cache)
+
+            def set(self, key, value):
+                cache[key] = value
+
+            def clear(self):
+                cache.clear()
+                
+            def cache_len(self):
+                return len(cache)
+
+            self.get = types.MethodType(get, self)
+            self.set = types.MethodType(set, self)
+            self.clear = types.MethodType(clear, self)
+            self.__len__ = types.MethodType(cache_len, self)
+
+    if _OrderedDict is not None:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = _OrderedDict()
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(cache) > size:
+                        try:
+                            cache.popitem(False)
+                        except KeyError:
+                            pass
+
+                def clear(self):
+                    cache.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    else:
+        class _FifoCache(object):
+            def __init__(self, size):
+                self.not_in_cache = not_in_cache = object()
+
+                cache = {}
+                key_fifo = collections.deque([], size)
+
+                def get(self, key):
+                    return cache.get(key, not_in_cache)
+
+                def set(self, key, value):
+                    cache[key] = value
+                    while len(key_fifo) > size:
+                        cache.pop(key_fifo.popleft(), None)
+                    key_fifo.append(key)
+
+                def clear(self):
+                    cache.clear()
+                    key_fifo.clear()
+
+                def cache_len(self):
+                    return len(cache)
+
+                self.get = types.MethodType(get, self)
+                self.set = types.MethodType(set, self)
+                self.clear = types.MethodType(clear, self)
+                self.__len__ = types.MethodType(cache_len, self)
+
+    # argument cache for optimizing repeated calls when backtracking through recursive expressions
+    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
+    packrat_cache_lock = RLock()
+    packrat_cache_stats = [0, 0]
+
+    # this method gets repeatedly called during backtracking with the same arguments -
+    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
+    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
+        HIT, MISS = 0, 1
+        lookup = (self, instring, loc, callPreParse, doActions)
+        with ParserElement.packrat_cache_lock:
+            cache = ParserElement.packrat_cache
+            value = cache.get(lookup)
+            if value is cache.not_in_cache:
+                ParserElement.packrat_cache_stats[MISS] += 1
+                try:
+                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
+                except ParseBaseException as pe:
+                    # cache a copy of the exception, without the traceback
+                    cache.set(lookup, pe.__class__(*pe.args))
+                    raise
+                else:
+                    cache.set(lookup, (value[0], value[1].copy()))
+                    return value
+            else:
+                ParserElement.packrat_cache_stats[HIT] += 1
+                if isinstance(value, Exception):
+                    raise value
+                return (value[0], value[1].copy())
+
+    _parse = _parseNoCache
+
+    @staticmethod
+    def resetCache():
+        ParserElement.packrat_cache.clear()
+        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)
+
+    _packratEnabled = False
+    @staticmethod
+    def enablePackrat(cache_size_limit=128):
+        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
+           Repeated parse attempts at the same string location (which happens
+           often in many complex grammars) can immediately return a cached value,
+           instead of re-executing parsing/validating code.  Memoizing is done of
+           both valid results and parsing exceptions.
+           
+           Parameters:
+            - cache_size_limit - (default=C{128}) - if an integer value is provided
+              will limit the size of the packrat cache; if None is passed, then
+              the cache size will be unbounded; if 0 is passed, the cache will
+              be effectively disabled.
+            
+           This speedup may break existing programs that use parse actions that
+           have side-effects.  For this reason, packrat parsing is disabled when
+           you first import pyparsing.  To activate the packrat feature, your
+           program must call the class method C{ParserElement.enablePackrat()}.  If
+           your program uses C{psyco} to "compile as you go", you must call
+           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
+           Python will crash.  For best results, call C{enablePackrat()} immediately
+           after importing pyparsing.
+           
+           Example::
+               import pyparsing
+               pyparsing.ParserElement.enablePackrat()
+        """
+        if not ParserElement._packratEnabled:
+            ParserElement._packratEnabled = True
+            if cache_size_limit is None:
+                ParserElement.packrat_cache = ParserElement._UnboundedCache()
+            else:
+                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
+            ParserElement._parse = ParserElement._parseCache
+
+    def parseString( self, instring, parseAll=False ):
+        """
+        Execute the parse expression with the given string.
+        This is the main interface to the client code, once the complete
+        expression has been built.
+
+        If you want the grammar to require that the entire input string be
+        successfully parsed, then set C{parseAll} to True (equivalent to ending
+        the grammar with C{L{StringEnd()}}).
+
+        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
+        in order to report proper column numbers in parse actions.
+        If the input string contains tabs and
+        the grammar uses parse actions that use the C{loc} argument to index into the
+        string being parsed, you can ensure you have a consistent view of the input
+        string by:
+         - calling C{parseWithTabs} on your grammar before calling C{parseString}
+           (see L{I{parseWithTabs}<parseWithTabs>})
+         - define your parse action using the full C{(s,loc,toks)} signature, and
+           reference the input string using the parse action's C{s} argument
+         - explictly expand the tabs in your input string before calling
+           C{parseString}
+        
+        Example::
+            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
+            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
+        """
+        ParserElement.resetCache()
+        if not self.streamlined:
+            self.streamline()
+            #~ self.saveAsList = True
+        for e in self.ignoreExprs:
+            e.streamline()
+        if not self.keepTabs:
+            instring = instring.expandtabs()
+        try:
+            loc, tokens = self._parse( instring, 0 )
+            if parseAll:
+                loc = self.preParse( instring, loc )
+                se = Empty() + StringEnd()
+                se._parse( instring, loc )
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+        else:
+            return tokens
+
+    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
+        """
+        Scan the input string for expression matches.  Each match will return the
+        matching tokens, start location, and end location.  May be called with optional
+        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
+        C{overlap} is specified, then overlapping matches will be reported.
+
+        Note that the start and end locations are reported relative to the string
+        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
+        strings with embedded tabs.
+
+        Example::
+            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
+            print(source)
+            for tokens,start,end in Word(alphas).scanString(source):
+                print(' '*start + '^'*(end-start))
+                print(' '*start + tokens[0])
+        
+        prints::
+        
+            sldjf123lsdjjkf345sldkjf879lkjsfd987
+            ^^^^^
+            sldjf
+                    ^^^^^^^
+                    lsdjjkf
+                              ^^^^^^
+                              sldkjf
+                                       ^^^^^^
+                                       lkjsfd
+        """
+        if not self.streamlined:
+            self.streamline()
+        for e in self.ignoreExprs:
+            e.streamline()
+
+        if not self.keepTabs:
+            instring = _ustr(instring).expandtabs()
+        instrlen = len(instring)
+        loc = 0
+        preparseFn = self.preParse
+        parseFn = self._parse
+        ParserElement.resetCache()
+        matches = 0
+        try:
+            while loc <= instrlen and matches < maxMatches:
+                try:
+                    preloc = preparseFn( instring, loc )
+                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
+                except ParseException:
+                    loc = preloc+1
+                else:
+                    if nextLoc > loc:
+                        matches += 1
+                        yield tokens, preloc, nextLoc
+                        if overlap:
+                            nextloc = preparseFn( instring, loc )
+                            if nextloc > loc:
+                                loc = nextLoc
+                            else:
+                                loc += 1
+                        else:
+                            loc = nextLoc
+                    else:
+                        loc = preloc+1
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def transformString( self, instring ):
+        """
+        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
+        be returned from a parse action.  To use C{transformString}, define a grammar and
+        attach a parse action to it that modifies the returned token list.
+        Invoking C{transformString()} on a target string will then scan for matches,
+        and replace the matched text patterns according to the logic in the parse
+        action.  C{transformString()} returns the resulting transformed string.
+        
+        Example::
+            wd = Word(alphas)
+            wd.setParseAction(lambda toks: toks[0].title())
+            
+            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
+        Prints::
+            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
+        """
+        out = []
+        lastE = 0
+        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
+        # keep string locs straight between transformString and scanString
+        self.keepTabs = True
+        try:
+            for t,s,e in self.scanString( instring ):
+                out.append( instring[lastE:s] )
+                if t:
+                    if isinstance(t,ParseResults):
+                        out += t.asList()
+                    elif isinstance(t,list):
+                        out += t
+                    else:
+                        out.append(t)
+                lastE = e
+            out.append(instring[lastE:])
+            out = [o for o in out if o]
+            return "".join(map(_ustr,_flatten(out)))
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def searchString( self, instring, maxMatches=_MAX_INT ):
+        """
+        Another extension to C{L{scanString}}, simplifying the access to the tokens found
+        to match the given parse expression.  May be called with optional
+        C{maxMatches} argument, to clip searching after 'n' matches are found.
+        
+        Example::
+            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
+            cap_word = Word(alphas.upper(), alphas.lower())
+            
+            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))
+
+            # the sum() builtin can be used to merge results into a single ParseResults object
+            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
+        prints::
+            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
+            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
+        """
+        try:
+            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
+        """
+        Generator method to split a string using the given expression as a separator.
+        May be called with optional C{maxsplit} argument, to limit the number of splits;
+        and the optional C{includeSeparators} argument (default=C{False}), if the separating
+        matching text should be included in the split results.
+        
+        Example::        
+            punc = oneOf(list(".,;:/-!?"))
+            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
+        prints::
+            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
+        """
+        splits = 0
+        last = 0
+        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
+            yield instring[last:s]
+            if includeSeparators:
+                yield t[0]
+            last = e
+        yield instring[last:]
+
+    def __add__(self, other ):
+        """
+        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
+        converts them to L{Literal}s by default.
+        
+        Example::
+            greet = Word(alphas) + "," + Word(alphas) + "!"
+            hello = "Hello, World!"
+            print (hello, "->", greet.parseString(hello))
+        Prints::
+            Hello, World! -> ['Hello', ',', 'World', '!']
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return And( [ self, other ] )
+
+    def __radd__(self, other ):
+        """
+        Implementation of + operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other + self
+
+    def __sub__(self, other):
+        """
+        Implementation of - operator, returns C{L{And}} with error stop
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return self + And._ErrorStop() + other
+
+    def __rsub__(self, other ):
+        """
+        Implementation of - operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other - self
+
+    def __mul__(self,other):
+        """
+        Implementation of * operator, allows use of C{expr * 3} in place of
+        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
+        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
+        may also include C{None} as in:
+         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
+              to C{expr*n + L{ZeroOrMore}(expr)}
+              (read as "at least n instances of C{expr}")
+         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
+              (read as "0 to n instances of C{expr}")
+         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
+         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}
+
+        Note that C{expr*(None,n)} does not raise an exception if
+        more than n exprs exist in the input stream; that is,
+        C{expr*(None,n)} does not enforce a maximum number of expr
+        occurrences.  If this behavior is desired, then write
+        C{expr*(None,n) + ~expr}
+        """
+        if isinstance(other,int):
+            minElements, optElements = other,0
+        elif isinstance(other,tuple):
+            other = (other + (None, None))[:2]
+            if other[0] is None:
+                other = (0, other[1])
+            if isinstance(other[0],int) and other[1] is None:
+                if other[0] == 0:
+                    return ZeroOrMore(self)
+                if other[0] == 1:
+                    return OneOrMore(self)
+                else:
+                    return self*other[0] + ZeroOrMore(self)
+            elif isinstance(other[0],int) and isinstance(other[1],int):
+                minElements, optElements = other
+                optElements -= minElements
+            else:
+                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
+        else:
+            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))
+
+        if minElements < 0:
+            raise ValueError("cannot multiply ParserElement by negative value")
+        if optElements < 0:
+            raise ValueError("second tuple value must be greater or equal to first tuple value")
+        if minElements == optElements == 0:
+            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")
+
+        if (optElements):
+            def makeOptionalList(n):
+                if n>1:
+                    return Optional(self + makeOptionalList(n-1))
+                else:
+                    return Optional(self)
+            if minElements:
+                if minElements == 1:
+                    ret = self + makeOptionalList(optElements)
+                else:
+                    ret = And([self]*minElements) + makeOptionalList(optElements)
+            else:
+                ret = makeOptionalList(optElements)
+        else:
+            if minElements == 1:
+                ret = self
+            else:
+                ret = And([self]*minElements)
+        return ret
+
+    def __rmul__(self, other):
+        return self.__mul__(other)
+
+    def __or__(self, other ):
+        """
+        Implementation of | operator - returns C{L{MatchFirst}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return MatchFirst( [ self, other ] )
+
+    def __ror__(self, other ):
+        """
+        Implementation of | operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other | self
+
+    def __xor__(self, other ):
+        """
+        Implementation of ^ operator - returns C{L{Or}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Or( [ self, other ] )
+
+    def __rxor__(self, other ):
+        """
+        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other ^ self
+
+    def __and__(self, other ):
+        """
+        Implementation of & operator - returns C{L{Each}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return Each( [ self, other ] )
+
+    def __rand__(self, other ):
+        """
+        Implementation of & operator when left operand is not a C{L{ParserElement}}
+        """
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        if not isinstance( other, ParserElement ):
+            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
+                    SyntaxWarning, stacklevel=2)
+            return None
+        return other & self
+
+    def __invert__( self ):
+        """
+        Implementation of ~ operator - returns C{L{NotAny}}
+        """
+        return NotAny( self )
+
+    def __call__(self, name=None):
+        """
+        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
+        
+        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
+        passed as C{True}.
+           
+        If C{name} is omitted, same as calling C{L{copy}}.
+
+        Example::
+            # these are equivalent
+            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
+            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
+        """
+        if name is not None:
+            return self.setResultsName(name)
+        else:
+            return self.copy()
+
+    def suppress( self ):
+        """
+        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
+        cluttering up returned output.
+        """
+        return Suppress( self )
+
+    def leaveWhitespace( self ):
+        """
+        Disables the skipping of whitespace before matching the characters in the
+        C{ParserElement}'s defined pattern.  This is normally only used internally by
+        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
+        """
+        self.skipWhitespace = False
+        return self
+
+    def setWhitespaceChars( self, chars ):
+        """
+        Overrides the default whitespace chars
+        """
+        self.skipWhitespace = True
+        self.whiteChars = chars
+        self.copyDefaultWhiteChars = False
+        return self
+
+    def parseWithTabs( self ):
+        """
+        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
+        Must be called before C{parseString} when the input grammar contains elements that
+        match C{<TAB>} characters.
+        """
+        self.keepTabs = True
+        return self
+
+    def ignore( self, other ):
+        """
+        Define expression to be ignored (e.g., comments) while doing pattern
+        matching; may be called repeatedly, to define multiple comment or other
+        ignorable patterns.
+        
+        Example::
+            patt = OneOrMore(Word(alphas))
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
+            
+            patt.ignore(cStyleComment)
+            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
+        """
+        if isinstance(other, basestring):
+            other = Suppress(other)
+
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                self.ignoreExprs.append(other)
+        else:
+            self.ignoreExprs.append( Suppress( other.copy() ) )
+        return self
+
+    def setDebugActions( self, startAction, successAction, exceptionAction ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        """
+        self.debugActions = (startAction or _defaultStartDebugAction,
+                             successAction or _defaultSuccessDebugAction,
+                             exceptionAction or _defaultExceptionDebugAction)
+        self.debug = True
+        return self
+
+    def setDebug( self, flag=True ):
+        """
+        Enable display of debugging messages while doing pattern matching.
+        Set C{flag} to True to enable, False to disable.
+
+        Example::
+            wd = Word(alphas).setName("alphaword")
+            integer = Word(nums).setName("numword")
+            term = wd | integer
+            
+            # turn on debugging for wd
+            wd.setDebug()
+
+            OneOrMore(term).parseString("abc 123 xyz 890")
+        
+        prints::
+            Match alphaword at loc 0(1,1)
+            Matched alphaword -> ['abc']
+            Match alphaword at loc 3(1,4)
+            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
+            Match alphaword at loc 7(1,8)
+            Matched alphaword -> ['xyz']
+            Match alphaword at loc 11(1,12)
+            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
+            Match alphaword at loc 15(1,16)
+            Exception raised:Expected alphaword (at char 15), (line:1, col:16)
+
+        The output shown is that produced by the default debug actions - custom debug actions can be
+        specified using L{setDebugActions}. Prior to attempting
+        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
+        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
+        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
+        which makes debugging and exception messages easier to understand - for instance, the default
+        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
+        """
+        if flag:
+            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
+        else:
+            self.debug = False
+        return self
+
+    def __str__( self ):
+        return self.name
+
+    def __repr__( self ):
+        return _ustr(self)
+
+    def streamline( self ):
+        self.streamlined = True
+        self.strRepr = None
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        pass
+
+    def validate( self, validateTrace=[] ):
+        """
+        Check defined expressions for valid structure, check for infinite recursive definitions.
+        """
+        self.checkRecursion( [] )
+
+    def parseFile( self, file_or_filename, parseAll=False ):
+        """
+        Execute the parse expression on the given file or filename.
+        If a filename is specified (instead of a file object),
+        the entire file is opened, read, and closed before parsing.
+        """
+        try:
+            file_contents = file_or_filename.read()
+        except AttributeError:
+            with open(file_or_filename, "r") as f:
+                file_contents = f.read()
+        try:
+            return self.parseString(file_contents, parseAll)
+        except ParseBaseException as exc:
+            if ParserElement.verbose_stacktrace:
+                raise
+            else:
+                # catch and re-raise exception from here, clears out pyparsing internal stack trace
+                raise exc
+
+    def __eq__(self,other):
+        if isinstance(other, ParserElement):
+            return self is other or vars(self) == vars(other)
+        elif isinstance(other, basestring):
+            return self.matches(other)
+        else:
+            return super(ParserElement,self)==other
+
+    def __ne__(self,other):
+        return not (self == other)
+
+    def __hash__(self):
+        return hash(id(self))
+
+    def __req__(self,other):
+        return self == other
+
+    def __rne__(self,other):
+        return not (self == other)
+
+    def matches(self, testString, parseAll=True):
+        """
+        Method for quick testing of a parser against a test string. Good for simple 
+        inline microtests of sub expressions while building up larger parser.
+           
+        Parameters:
+         - testString - to test against this expression for a match
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
+            
+        Example::
+            expr = Word(nums)
+            assert expr.matches("100")
+        """
+        try:
+            self.parseString(_ustr(testString), parseAll=parseAll)
+            return True
+        except ParseBaseException:
+            return False
+                
+    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
+        """
+        Execute the parse expression on a series of test strings, showing each
+        test, the parsed results or where the parse failed. Quick and easy way to
+        run a parse expression against a list of sample strings.
+           
+        Parameters:
+         - tests - a list of separate test strings, or a multiline string of test strings
+         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
+         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
+              string; pass None to disable comment filtering
+         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
+              if False, only dump nested list
+         - printResults - (default=C{True}) prints test output to stdout
+         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing
+
+        Returns: a (success, results) tuple, where success indicates that all tests succeeded
+        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
+        test's output
+        
+        Example::
+            number_expr = pyparsing_common.number.copy()
+
+            result = number_expr.runTests('''
+                # unsigned integer
+                100
+                # negative integer
+                -100
+                # float with scientific notation
+                6.02e23
+                # integer with scientific notation
+                1e-12
+                ''')
+            print("Success" if result[0] else "Failed!")
+
+            result = number_expr.runTests('''
+                # stray character
+                100Z
+                # missing leading digit before '.'
+                -.100
+                # too many '.'
+                3.14.159
+                ''', failureTests=True)
+            print("Success" if result[0] else "Failed!")
+        prints::
+            # unsigned integer
+            100
+            [100]
+
+            # negative integer
+            -100
+            [-100]
+
+            # float with scientific notation
+            6.02e23
+            [6.02e+23]
+
+            # integer with scientific notation
+            1e-12
+            [1e-12]
+
+            Success
+            
+            # stray character
+            100Z
+               ^
+            FAIL: Expected end of text (at char 3), (line:1, col:4)
+
+            # missing leading digit before '.'
+            -.100
+            ^
+            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)
+
+            # too many '.'
+            3.14.159
+                ^
+            FAIL: Expected end of text (at char 4), (line:1, col:5)
+
+            Success
+
+        Each test string must be on a single line. If you want to test a string that spans multiple
+        lines, create a test like this::
+
+            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
+        
+        (Note that this is a raw string literal, you must include the leading 'r'.)
+        """
+        if isinstance(tests, basestring):
+            tests = list(map(str.strip, tests.rstrip().splitlines()))
+        if isinstance(comment, basestring):
+            comment = Literal(comment)
+        allResults = []
+        comments = []
+        success = True
+        for t in tests:
+            if comment is not None and comment.matches(t, False) or comments and not t:
+                comments.append(t)
+                continue
+            if not t:
+                continue
+            out = ['\n'.join(comments), t]
+            comments = []
+            try:
+                t = t.replace(r'\n','\n')
+                result = self.parseString(t, parseAll=parseAll)
+                out.append(result.dump(full=fullDump))
+                success = success and not failureTests
+            except ParseBaseException as pe:
+                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
+                if '\n' in t:
+                    out.append(line(pe.loc, t))
+                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
+                else:
+                    out.append(' '*pe.loc + '^' + fatal)
+                out.append("FAIL: " + str(pe))
+                success = success and failureTests
+                result = pe
+            except Exception as exc:
+                out.append("FAIL-EXCEPTION: " + str(exc))
+                success = success and failureTests
+                result = exc
+
+            if printResults:
+                if fullDump:
+                    out.append('')
+                print('\n'.join(out))
+
+            allResults.append((t, result))
+        
+        return success, allResults
+
+        
+class Token(ParserElement):
+    """
+    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
+    """
+    def __init__( self ):
+        super(Token,self).__init__( savelist=False )
+
+
+class Empty(Token):
+    """
+    An empty token, will always match.
+    """
+    def __init__( self ):
+        super(Empty,self).__init__()
+        self.name = "Empty"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+
+class NoMatch(Token):
+    """
+    A token that will never match.
+    """
+    def __init__( self ):
+        super(NoMatch,self).__init__()
+        self.name = "NoMatch"
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.errmsg = "Unmatchable token"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Literal(Token):
+    """
+    Token to exactly match a specified string.
+    
+    Example::
+        Literal('blah').parseString('blah')  # -> ['blah']
+        Literal('blah').parseString('blahfooblah')  # -> ['blah']
+        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
+    
+    For case-insensitive matching, use L{CaselessLiteral}.
+    
+    For keyword matching (force word break before and after the matched string),
+    use L{Keyword} or L{CaselessKeyword}.
+    """
+    def __init__( self, matchString ):
+        super(Literal,self).__init__()
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Literal; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+            self.__class__ = Empty
+        self.name = '"%s"' % _ustr(self.match)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+
+    # Performance tuning: this routine gets called a *lot*
+    # if this is a single character match string  and the first character matches,
+    # short-circuit as quickly as possible, and avoid calling startswith
+    #~ @profile
+    def parseImpl( self, instring, loc, doActions=True ):
+        if (instring[loc] == self.firstMatchChar and
+            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+_L = Literal
+ParserElement._literalStringClass = Literal
+
+class Keyword(Token):
+    """
+    Token to exactly match a specified string as a keyword, that is, it must be
+    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
+     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
+     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
+    Accepts two optional constructor arguments in addition to the keyword string:
+     - C{identChars} is a string of characters that would be valid identifier characters,
+          defaulting to all alphanumerics + "_" and "$"
+     - C{caseless} allows case-insensitive matching, default is C{False}.
+       
+    Example::
+        Keyword("start").parseString("start")  # -> ['start']
+        Keyword("start").parseString("starting")  # -> Exception
+
+    For case-insensitive matching, use L{CaselessKeyword}.
+    """
+    DEFAULT_KEYWORD_CHARS = alphanums+"_$"
+
+    def __init__( self, matchString, identChars=None, caseless=False ):
+        super(Keyword,self).__init__()
+        if identChars is None:
+            identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        self.match = matchString
+        self.matchLen = len(matchString)
+        try:
+            self.firstMatchChar = matchString[0]
+        except IndexError:
+            warnings.warn("null string passed to Keyword; use Empty() instead",
+                            SyntaxWarning, stacklevel=2)
+        self.name = '"%s"' % self.match
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = False
+        self.mayIndexError = False
+        self.caseless = caseless
+        if caseless:
+            self.caselessmatch = matchString.upper()
+            identChars = identChars.upper()
+        self.identChars = set(identChars)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.caseless:
+            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
+                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        else:
+            if (instring[loc] == self.firstMatchChar and
+                (self.matchLen==1 or instring.startswith(self.match,loc)) and
+                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
+                (loc == 0 or instring[loc-1] not in self.identChars) ):
+                return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+    def copy(self):
+        c = super(Keyword,self).copy()
+        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
+        return c
+
+    @staticmethod
+    def setDefaultKeywordChars( chars ):
+        """Overrides the default Keyword chars
+        """
+        Keyword.DEFAULT_KEYWORD_CHARS = chars
+
+class CaselessLiteral(Literal):
+    """
+    Token to match a specified string, ignoring case of letters.
+    Note: the matched results will always be in the case of the given
+    match string, NOT the case of the input text.
+
+    Example::
+        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessKeyword}.)
+    """
+    def __init__( self, matchString ):
+        super(CaselessLiteral,self).__init__( matchString.upper() )
+        # Preserve the defining literal.
+        self.returnString = matchString
+        self.name = "'%s'" % self.returnString
+        self.errmsg = "Expected " + self.name
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[ loc:loc+self.matchLen ].upper() == self.match:
+            return loc+self.matchLen, self.returnString
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CaselessKeyword(Keyword):
+    """
+    Caseless version of L{Keyword}.
+
+    Example::
+        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
+        
+    (Contrast with example for L{CaselessLiteral}.)
+    """
+    def __init__( self, matchString, identChars=None ):
+        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
+             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
+            return loc+self.matchLen, self.match
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class CloseMatch(Token):
+    """
+    A variation on L{Literal} which matches "close" matches, that is, 
+    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
+     - C{match_string} - string to be matched
+     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
+    
+    The results from a successful parse will contain the matched text from the input string and the following named results:
+     - C{mismatches} - a list of the positions within the match_string where mismatches were found
+     - C{original} - the original match_string used to compare against the input string
+    
+    If C{mismatches} is an empty list, then the match was an exact match.
+    
+    Example::
+        patt = CloseMatch("ATCATCGAATGGA")
+        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
+        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)
+
+        # exact match
+        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})
+
+        # close match allowing up to 2 mismatches
+        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
+        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
+    """
+    def __init__(self, match_string, maxMismatches=1):
+        super(CloseMatch,self).__init__()
+        self.name = match_string
+        self.match_string = match_string
+        self.maxMismatches = maxMismatches
+        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
+        self.mayIndexError = False
+        self.mayReturnEmpty = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        start = loc
+        instrlen = len(instring)
+        maxloc = start + len(self.match_string)
+
+        if maxloc <= instrlen:
+            match_string = self.match_string
+            match_stringloc = 0
+            mismatches = []
+            maxMismatches = self.maxMismatches
+
+            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
+                src,mat = s_m
+                if src != mat:
+                    mismatches.append(match_stringloc)
+                    if len(mismatches) > maxMismatches:
+                        break
+            else:
+                loc = match_stringloc + 1
+                results = ParseResults([instring[start:loc]])
+                results['original'] = self.match_string
+                results['mismatches'] = mismatches
+                return loc, results
+
+        raise ParseException(instring, loc, self.errmsg, self)
+
+
+class Word(Token):
+    """
+    Token for matching words composed of allowed character sets.
+    Defined with string containing all allowed initial characters,
+    an optional string containing allowed body characters (if omitted,
+    defaults to the initial character set), and an optional minimum,
+    maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction. An optional
+    C{excludeChars} parameter can list characters that might be found in 
+    the input C{bodyChars} string; useful to define a word of all printables
+    except for one or two characters, for instance.
+    
+    L{srange} is useful for defining custom character set strings for defining 
+    C{Word} expressions, using range notation from regular expression character sets.
+    
+    A common mistake is to use C{Word} to match a specific literal string, as in 
+    C{Word("Address")}. Remember that C{Word} uses the string argument to define
+    I{sets} of matchable characters. This expression would match "Add", "AAA",
+    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
+    To match an exact literal string, use L{Literal} or L{Keyword}.
+
+    pyparsing includes helper strings for building Words:
+     - L{alphas}
+     - L{nums}
+     - L{alphanums}
+     - L{hexnums}
+     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
+     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
+     - L{printables} (any non-whitespace character)
+
+    Example::
+        # a word composed of digits
+        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
+        
+        # a word with a leading capital, and zero or more lowercase
+        capital_word = Word(alphas.upper(), alphas.lower())
+
+        # hostnames are alphanumeric, with leading alpha, and '-'
+        hostname = Word(alphas, alphanums+'-')
+        
+        # roman numeral (not a strict parser, accepts invalid mix of characters)
+        roman = Word("IVXLCDM")
+        
+        # any string of non-whitespace characters, except for ','
+        csv_value = Word(printables, excludeChars=",")
+    """
+    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
+        super(Word,self).__init__()
+        if excludeChars:
+            initChars = ''.join(c for c in initChars if c not in excludeChars)
+            if bodyChars:
+                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
+        self.initCharsOrig = initChars
+        self.initChars = set(initChars)
+        if bodyChars :
+            self.bodyCharsOrig = bodyChars
+            self.bodyChars = set(bodyChars)
+        else:
+            self.bodyCharsOrig = initChars
+            self.bodyChars = set(initChars)
+
+        self.maxSpecified = max > 0
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.asKeyword = asKeyword
+
+        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
+            if self.bodyCharsOrig == self.initCharsOrig:
+                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
+            elif len(self.initCharsOrig) == 1:
+                self.reString = "%s[%s]*" % \
+                                      (re.escape(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            else:
+                self.reString = "[%s][%s]*" % \
+                                      (_escapeRegexRangeChars(self.initCharsOrig),
+                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
+            if self.asKeyword:
+                self.reString = r"\b"+self.reString+r"\b"
+            try:
+                self.re = re.compile( self.reString )
+            except Exception:
+                self.re = None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.re:
+            result = self.re.match(instring,loc)
+            if not result:
+                raise ParseException(instring, loc, self.errmsg, self)
+
+            loc = result.end()
+            return loc, result.group()
+
+        if not(instring[ loc ] in self.initChars):
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        instrlen = len(instring)
+        bodychars = self.bodyChars
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, instrlen )
+        while loc < maxloc and instring[loc] in bodychars:
+            loc += 1
+
+        throwException = False
+        if loc - start < self.minLen:
+            throwException = True
+        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
+            throwException = True
+        if self.asKeyword:
+            if (start>0 and instring[start-1] in bodychars) or (loc<instrlen and instring[loc] in bodychars):
+                throwException = True
+
+        if throwException:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(Word,self).__str__()
+        except Exception:
+            pass
+
+
+        if self.strRepr is None:
+
+            def charsAsStr(s):
+                if len(s)>4:
+                    return s[:4]+"..."
+                else:
+                    return s
+
+            if ( self.initCharsOrig != self.bodyCharsOrig ):
+                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
+            else:
+                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)
+
+        return self.strRepr
+
+
+class Regex(Token):
+    r"""
+    Token for matching strings that match a given regular expression.
+    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
+    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
+    named parse results.
+
+    Example::
+        realnum = Regex(r"[+-]?\d+\.\d*")
+        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
+        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
+        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
+    """
+    compiledREtype = type(re.compile("[A-Z]"))
+    def __init__( self, pattern, flags=0):
+        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
+        super(Regex,self).__init__()
+
+        if isinstance(pattern, basestring):
+            if not pattern:
+                warnings.warn("null string passed to Regex; use Empty() instead",
+                        SyntaxWarning, stacklevel=2)
+
+            self.pattern = pattern
+            self.flags = flags
+
+            try:
+                self.re = re.compile(self.pattern, self.flags)
+                self.reString = self.pattern
+            except sre_constants.error:
+                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
+                    SyntaxWarning, stacklevel=2)
+                raise
+
+        elif isinstance(pattern, Regex.compiledREtype):
+            self.re = pattern
+            self.pattern = \
+            self.reString = str(pattern)
+            self.flags = flags
+            
+        else:
+            raise ValueError("Regex may only be constructed with a string or a compiled RE object")
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = self.re.match(instring,loc)
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        d = result.groupdict()
+        ret = ParseResults(result.group())
+        if d:
+            for k in d:
+                ret[k] = d[k]
+        return loc,ret
+
+    def __str__( self ):
+        try:
+            return super(Regex,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "Re:(%s)" % repr(self.pattern)
+
+        return self.strRepr
+
+
+class QuotedString(Token):
+    r"""
+    Token for matching strings that are delimited by quoting characters.
+    
+    Defined with the following parameters:
+        - quoteChar - string of one or more characters defining the quote delimiting string
+        - escChar - character to escape quotes, typically backslash (default=C{None})
+        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
+        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
+        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
+        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
+        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})
+
+    Example::
+        qs = QuotedString('"')
+        print(qs.searchString('lsjdf "This is the quote" sldjf'))
+        complex_qs = QuotedString('{{', endQuoteChar='}}')
+        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
+        sql_qs = QuotedString('"', escQuote='""')
+        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
+    prints::
+        [['This is the quote']]
+        [['This is the "quote"']]
+        [['This is the quote with "embedded" quotes']]
+    """
+    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
+        super(QuotedString,self).__init__()
+
+        # remove white space from quote chars - wont work anyway
+        quoteChar = quoteChar.strip()
+        if not quoteChar:
+            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+            raise SyntaxError()
+
+        if endQuoteChar is None:
+            endQuoteChar = quoteChar
+        else:
+            endQuoteChar = endQuoteChar.strip()
+            if not endQuoteChar:
+                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
+                raise SyntaxError()
+
+        self.quoteChar = quoteChar
+        self.quoteCharLen = len(quoteChar)
+        self.firstQuoteChar = quoteChar[0]
+        self.endQuoteChar = endQuoteChar
+        self.endQuoteCharLen = len(endQuoteChar)
+        self.escChar = escChar
+        self.escQuote = escQuote
+        self.unquoteResults = unquoteResults
+        self.convertWhitespaceEscapes = convertWhitespaceEscapes
+
+        if multiline:
+            self.flags = re.MULTILINE | re.DOTALL
+            self.pattern = r'%s(?:[^%s%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        else:
+            self.flags = 0
+            self.pattern = r'%s(?:[^%s\n\r%s]' % \
+                ( re.escape(self.quoteChar),
+                  _escapeRegexRangeChars(self.endQuoteChar[0]),
+                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
+        if len(self.endQuoteChar) > 1:
+            self.pattern += (
+                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
+                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
+                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
+                )
+        if escQuote:
+            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
+        if escChar:
+            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
+            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
+        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))
+
+        try:
+            self.re = re.compile(self.pattern, self.flags)
+            self.reString = self.pattern
+        except sre_constants.error:
+            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
+                SyntaxWarning, stacklevel=2)
+            raise
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayIndexError = False
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
+        if not result:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        loc = result.end()
+        ret = result.group()
+
+        if self.unquoteResults:
+
+            # strip off quotes
+            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]
+
+            if isinstance(ret,basestring):
+                # replace escaped whitespace
+                if '\\' in ret and self.convertWhitespaceEscapes:
+                    ws_map = {
+                        r'\t' : '\t',
+                        r'\n' : '\n',
+                        r'\f' : '\f',
+                        r'\r' : '\r',
+                    }
+                    for wslit,wschar in ws_map.items():
+                        ret = ret.replace(wslit, wschar)
+
+                # replace escaped characters
+                if self.escChar:
+                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)
+
+                # replace escaped quotes
+                if self.escQuote:
+                    ret = ret.replace(self.escQuote, self.endQuoteChar)
+
+        return loc, ret
+
+    def __str__( self ):
+        try:
+            return super(QuotedString,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)
+
+        return self.strRepr
+
+
+class CharsNotIn(Token):
+    """
+    Token for matching words composed of characters I{not} in a given set (will
+    include whitespace in matched characters if not listed in the provided exclusion set - see example).
+    Defined with string containing all disallowed characters, and an optional
+    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
+    minimum value < 1 is not valid); the default values for C{max} and C{exact}
+    are 0, meaning no maximum or exact length restriction.
+
+    Example::
+        # define a comma-separated-value as anything that is not a ','
+        csv_value = CharsNotIn(',')
+        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
+    prints::
+        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
+    """
+    def __init__( self, notChars, min=1, max=0, exact=0 ):
+        super(CharsNotIn,self).__init__()
+        self.skipWhitespace = False
+        self.notChars = notChars
+
+        if min < 1:
+            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+        self.name = _ustr(self)
+        self.errmsg = "Expected " + self.name
+        self.mayReturnEmpty = ( self.minLen == 0 )
+        self.mayIndexError = False
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if instring[loc] in self.notChars:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        start = loc
+        loc += 1
+        notchars = self.notChars
+        maxlen = min( start+self.maxLen, len(instring) )
+        while loc < maxlen and \
+              (instring[loc] not in notchars):
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+    def __str__( self ):
+        try:
+            return super(CharsNotIn, self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            if len(self.notChars) > 4:
+                self.strRepr = "!W:(%s...)" % self.notChars[:4]
+            else:
+                self.strRepr = "!W:(%s)" % self.notChars
+
+        return self.strRepr
+
+class White(Token):
+    """
+    Special matching class for matching whitespace.  Normally, whitespace is ignored
+    by pyparsing grammars.  This class is included when some whitespace structures
+    are significant.  Define with a string containing the whitespace characters to be
+    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
+    as defined for the C{L{Word}} class.
+    """
+    whiteStrs = {
+        " " : "<SPC>",
+        "\t": "<TAB>",
+        "\n": "<LF>",
+        "\r": "<CR>",
+        "\f": "<FF>",
+        }
+    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
+        super(White,self).__init__()
+        self.matchWhite = ws
+        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
+        #~ self.leaveWhitespace()
+        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
+        self.mayReturnEmpty = True
+        self.errmsg = "Expected " + self.name
+
+        self.minLen = min
+
+        if max > 0:
+            self.maxLen = max
+        else:
+            self.maxLen = _MAX_INT
+
+        if exact > 0:
+            self.maxLen = exact
+            self.minLen = exact
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if not(instring[ loc ] in self.matchWhite):
+            raise ParseException(instring, loc, self.errmsg, self)
+        start = loc
+        loc += 1
+        maxloc = start + self.maxLen
+        maxloc = min( maxloc, len(instring) )
+        while loc < maxloc and instring[loc] in self.matchWhite:
+            loc += 1
+
+        if loc - start < self.minLen:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        return loc, instring[start:loc]
+
+
+class _PositionToken(Token):
+    def __init__( self ):
+        super(_PositionToken,self).__init__()
+        self.name=self.__class__.__name__
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+
+class GoToColumn(_PositionToken):
+    """
+    Token to advance to a specific column of input text; useful for tabular report scraping.
+    """
+    def __init__( self, colno ):
+        super(GoToColumn,self).__init__()
+        self.col = colno
+
+    def preParse( self, instring, loc ):
+        if col(loc,instring) != self.col:
+            instrlen = len(instring)
+            if self.ignoreExprs:
+                loc = self._skipIgnorables( instring, loc )
+            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
+                loc += 1
+        return loc
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        thiscol = col( loc, instring )
+        if thiscol > self.col:
+            raise ParseException( instring, loc, "Text not in expected column", self )
+        newloc = loc + self.col - thiscol
+        ret = instring[ loc: newloc ]
+        return newloc, ret
+
+
+class LineStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of a line within the parse string
+    
+    Example::
+    
+        test = '''\
+        AAA this line
+        AAA and this line
+          AAA but not this one
+        B AAA and definitely not this one
+        '''
+
+        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
+            print(t)
+    
+    Prints::
+        ['AAA', ' this line']
+        ['AAA', ' and this line']    
+
+    """
+    def __init__( self ):
+        super(LineStart,self).__init__()
+        self.errmsg = "Expected start of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if col(loc, instring) == 1:
+            return loc, []
+        raise ParseException(instring, loc, self.errmsg, self)
+
+class LineEnd(_PositionToken):
+    """
+    Matches if current position is at the end of a line within the parse string
+    """
+    def __init__( self ):
+        super(LineEnd,self).__init__()
+        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
+        self.errmsg = "Expected end of line"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc<len(instring):
+            if instring[loc] == "\n":
+                return loc+1, "\n"
+            else:
+                raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc+1, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class StringStart(_PositionToken):
+    """
+    Matches if current position is at the beginning of the parse string
+    """
+    def __init__( self ):
+        super(StringStart,self).__init__()
+        self.errmsg = "Expected start of text"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc != 0:
+            # see if entire string up to here is just whitespace and ignoreables
+            if loc != self.preParse( instring, 0 ):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class StringEnd(_PositionToken):
+    """
+    Matches if current position is at the end of the parse string
+    """
+    def __init__( self ):
+        super(StringEnd,self).__init__()
+        self.errmsg = "Expected end of text"
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if loc < len(instring):
+            raise ParseException(instring, loc, self.errmsg, self)
+        elif loc == len(instring):
+            return loc+1, []
+        elif loc > len(instring):
+            return loc, []
+        else:
+            raise ParseException(instring, loc, self.errmsg, self)
+
+class WordStart(_PositionToken):
+    """
+    Matches if the current position is at the beginning of a Word, and
+    is not preceded by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
+    the string being parsed, or at the beginning of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordStart,self).__init__()
+        self.wordChars = set(wordChars)
+        self.errmsg = "Not at the start of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        if loc != 0:
+            if (instring[loc-1] in self.wordChars or
+                instring[loc] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+class WordEnd(_PositionToken):
+    """
+    Matches if the current position is at the end of a Word, and
+    is not followed by any character in a given set of C{wordChars}
+    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
+    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
+    the string being parsed, or at the end of a line.
+    """
+    def __init__(self, wordChars = printables):
+        super(WordEnd,self).__init__()
+        self.wordChars = set(wordChars)
+        self.skipWhitespace = False
+        self.errmsg = "Not at the end of a word"
+
+    def parseImpl(self, instring, loc, doActions=True ):
+        instrlen = len(instring)
+        if instrlen>0 and loc<instrlen:
+            if (instring[loc] in self.wordChars or
+                instring[loc-1] not in self.wordChars):
+                raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+
+class ParseExpression(ParserElement):
+    """
+    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(ParseExpression,self).__init__(savelist)
+        if isinstance( exprs, _generatorType ):
+            exprs = list(exprs)
+
+        if isinstance( exprs, basestring ):
+            self.exprs = [ ParserElement._literalStringClass( exprs ) ]
+        elif isinstance( exprs, Iterable ):
+            exprs = list(exprs)
+            # if sequence of strings provided, wrap with Literal
+            if all(isinstance(expr, basestring) for expr in exprs):
+                exprs = map(ParserElement._literalStringClass, exprs)
+            self.exprs = list(exprs)
+        else:
+            try:
+                self.exprs = list( exprs )
+            except TypeError:
+                self.exprs = [ exprs ]
+        self.callPreparse = False
+
+    def __getitem__( self, i ):
+        return self.exprs[i]
+
+    def append( self, other ):
+        self.exprs.append( other )
+        self.strRepr = None
+        return self
+
+    def leaveWhitespace( self ):
+        """Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
+           all contained expressions."""
+        self.skipWhitespace = False
+        self.exprs = [ e.copy() for e in self.exprs ]
+        for e in self.exprs:
+            e.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseExpression, self).ignore( other )
+                for e in self.exprs:
+                    e.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseExpression, self).ignore( other )
+            for e in self.exprs:
+                e.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def __str__( self ):
+        try:
+            return super(ParseExpression,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.exprs) )
+        return self.strRepr
+
+    def streamline( self ):
+        super(ParseExpression,self).streamline()
+
+        for e in self.exprs:
+            e.streamline()
+
+        # collapse nested And's of the form And( And( And( a,b), c), d) to And( a,b,c,d )
+        # but only if there are no parse actions or resultsNames on the nested And's
+        # (likewise for Or's and MatchFirst's)
+        if ( len(self.exprs) == 2 ):
+            other = self.exprs[0]
+            if ( isinstance( other, self.__class__ ) and
+                  not(other.parseAction) and
+                  other.resultsName is None and
+                  not other.debug ):
+                self.exprs = other.exprs[:] + [ self.exprs[1] ]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+            other = self.exprs[-1]
+            if ( isinstance( other, self.__class__ ) and
+                  not(other.parseAction) and
+                  other.resultsName is None and
+                  not other.debug ):
+                self.exprs = self.exprs[:-1] + other.exprs[:]
+                self.strRepr = None
+                self.mayReturnEmpty |= other.mayReturnEmpty
+                self.mayIndexError  |= other.mayIndexError
+
+        self.errmsg = "Expected " + _ustr(self)
+        
+        return self
+
+    def setResultsName( self, name, listAllMatches=False ):
+        ret = super(ParseExpression,self).setResultsName(name,listAllMatches)
+        return ret
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        for e in self.exprs:
+            e.validate(tmp)
+        self.checkRecursion( [] )
+        
+    def copy(self):
+        ret = super(ParseExpression,self).copy()
+        ret.exprs = [e.copy() for e in self.exprs]
+        return ret
+
+class And(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found in the given order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'+'} operator.
+    May also be constructed using the C{'-'} operator, which will suppress backtracking.
+
+    Example::
+        integer = Word(nums)
+        name_expr = OneOrMore(Word(alphas))
+
+        expr = And([integer("id"),name_expr("name"),integer("age")])
+        # more easily written as:
+        expr = integer("id") + name_expr("name") + integer("age")
+    """
+
+    class _ErrorStop(Empty):
+        def __init__(self, *args, **kwargs):
+            super(And._ErrorStop,self).__init__(*args, **kwargs)
+            self.name = '-'
+            self.leaveWhitespace()
+
+    def __init__( self, exprs, savelist = True ):
+        super(And,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.setWhitespaceChars( self.exprs[0].whiteChars )
+        self.skipWhitespace = self.exprs[0].skipWhitespace
+        self.callPreparse = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        # pass False as last arg to _parse for first element, since we already
+        # pre-parsed the string as part of our And pre-parsing
+        loc, resultlist = self.exprs[0]._parse( instring, loc, doActions, callPreParse=False )
+        errorStop = False
+        for e in self.exprs[1:]:
+            if isinstance(e, And._ErrorStop):
+                errorStop = True
+                continue
+            if errorStop:
+                try:
+                    loc, exprtokens = e._parse( instring, loc, doActions )
+                except ParseSyntaxException:
+                    raise
+                except ParseBaseException as pe:
+                    pe.__traceback__ = None
+                    raise ParseSyntaxException._from_exception(pe)
+                except IndexError:
+                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
+            else:
+                loc, exprtokens = e._parse( instring, loc, doActions )
+            if exprtokens or exprtokens.haskeys():
+                resultlist += exprtokens
+        return loc, resultlist
+
+    def __iadd__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #And( [ self, other ] )
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+            if not e.mayReturnEmpty:
+                break
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+
+class Or(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the expression that matches the longest string will be used.
+    May be constructed using the C{'^'} operator.
+
+    Example::
+        # construct Or using '^' operator
+        
+        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789"))
+    prints::
+        [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(Or,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        matches = []
+        for e in self.exprs:
+            try:
+                loc2 = e.tryParse( instring, loc )
+            except ParseException as err:
+                err.__traceback__ = None
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+            else:
+                # save match among all matches, to retry longest to shortest
+                matches.append((loc2, e))
+
+        if matches:
+            matches.sort(key=lambda x: -x[0])
+            for _,e in matches:
+                try:
+                    return e._parse( instring, loc, doActions )
+                except ParseException as err:
+                    err.__traceback__ = None
+                    if err.loc > maxExcLoc:
+                        maxException = err
+                        maxExcLoc = err.loc
+
+        if maxException is not None:
+            maxException.msg = self.errmsg
+            raise maxException
+        else:
+            raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+
+    def __ixor__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #Or( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class MatchFirst(ParseExpression):
+    """
+    Requires that at least one C{ParseExpression} is found.
+    If two expressions match, the first one listed is the one that will match.
+    May be constructed using the C{'|'} operator.
+
+    Example::
+        # construct MatchFirst using '|' operator
+        
+        # watch the order of expressions to match
+        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
+        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]
+
+        # put more selective expression first
+        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
+        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
+    """
+    def __init__( self, exprs, savelist = False ):
+        super(MatchFirst,self).__init__(exprs, savelist)
+        if self.exprs:
+            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
+        else:
+            self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        maxExcLoc = -1
+        maxException = None
+        for e in self.exprs:
+            try:
+                ret = e._parse( instring, loc, doActions )
+                return ret
+            except ParseException as err:
+                if err.loc > maxExcLoc:
+                    maxException = err
+                    maxExcLoc = err.loc
+            except IndexError:
+                if len(instring) > maxExcLoc:
+                    maxException = ParseException(instring,len(instring),e.errmsg,self)
+                    maxExcLoc = len(instring)
+
+        # only got here if no expression matched, raise exception for match that made it the furthest
+        else:
+            if maxException is not None:
+                maxException.msg = self.errmsg
+                raise maxException
+            else:
+                raise ParseException(instring, loc, "no defined alternatives to match", self)
+
+    def __ior__(self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass( other )
+        return self.append( other ) #MatchFirst( [ self, other ] )
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class Each(ParseExpression):
+    """
+    Requires all given C{ParseExpression}s to be found, but in any order.
+    Expressions may be separated by whitespace.
+    May be constructed using the C{'&'} operator.
+
+    Example::
+        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
+        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
+        integer = Word(nums)
+        shape_attr = "shape:" + shape_type("shape")
+        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
+        color_attr = "color:" + color("color")
+        size_attr = "size:" + integer("size")
+
+        # use Each (using operator '&') to accept attributes in any order 
+        # (shape and posn are required, color and size are optional)
+        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)
+
+        shape_spec.runTests('''
+            shape: SQUARE color: BLACK posn: 100, 120
+            shape: CIRCLE size: 50 color: BLUE posn: 50,80
+            color:GREEN size:20 shape:TRIANGLE posn:20,40
+            '''
+            )
+    prints::
+        shape: SQUARE color: BLACK posn: 100, 120
+        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
+        - color: BLACK
+        - posn: ['100', ',', '120']
+          - x: 100
+          - y: 120
+        - shape: SQUARE
+
+
+        shape: CIRCLE size: 50 color: BLUE posn: 50,80
+        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
+        - color: BLUE
+        - posn: ['50', ',', '80']
+          - x: 50
+          - y: 80
+        - shape: CIRCLE
+        - size: 50
+
+
+        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
+        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
+        - color: GREEN
+        - posn: ['20', ',', '40']
+          - x: 20
+          - y: 40
+        - shape: TRIANGLE
+        - size: 20
+    """
+    def __init__( self, exprs, savelist = True ):
+        super(Each,self).__init__(exprs, savelist)
+        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
+        self.skipWhitespace = True
+        self.initExprGroups = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.initExprGroups:
+            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
+            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
+            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
+            self.optionals = opt1 + opt2
+            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
+            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
+            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
+            self.required += self.multirequired
+            self.initExprGroups = False
+        tmpLoc = loc
+        tmpReqd = self.required[:]
+        tmpOpt  = self.optionals[:]
+        matchOrder = []
+
+        keepMatching = True
+        while keepMatching:
+            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
+            failed = []
+            for e in tmpExprs:
+                try:
+                    tmpLoc = e.tryParse( instring, tmpLoc )
+                except ParseException:
+                    failed.append(e)
+                else:
+                    matchOrder.append(self.opt1map.get(id(e),e))
+                    if e in tmpReqd:
+                        tmpReqd.remove(e)
+                    elif e in tmpOpt:
+                        tmpOpt.remove(e)
+            if len(failed) == len(tmpExprs):
+                keepMatching = False
+
+        if tmpReqd:
+            missing = ", ".join(_ustr(e) for e in tmpReqd)
+            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )
+
+        # add any unmatched Optionals, in case they have default values defined
+        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]
+
+        resultlist = []
+        for e in matchOrder:
+            loc,results = e._parse(instring,loc,doActions)
+            resultlist.append(results)
+
+        finalResults = sum(resultlist, ParseResults([]))
+        return loc, finalResults
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"
+
+        return self.strRepr
+
+    def checkRecursion( self, parseElementList ):
+        subRecCheckList = parseElementList[:] + [ self ]
+        for e in self.exprs:
+            e.checkRecursion( subRecCheckList )
+
+
+class ParseElementEnhance(ParserElement):
+    """
+    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(ParseElementEnhance,self).__init__(savelist)
+        if isinstance( expr, basestring ):
+            if issubclass(ParserElement._literalStringClass, Token):
+                expr = ParserElement._literalStringClass(expr)
+            else:
+                expr = ParserElement._literalStringClass(Literal(expr))
+        self.expr = expr
+        self.strRepr = None
+        if expr is not None:
+            self.mayIndexError = expr.mayIndexError
+            self.mayReturnEmpty = expr.mayReturnEmpty
+            self.setWhitespaceChars( expr.whiteChars )
+            self.skipWhitespace = expr.skipWhitespace
+            self.saveAsList = expr.saveAsList
+            self.callPreparse = expr.callPreparse
+            self.ignoreExprs.extend(expr.ignoreExprs)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr is not None:
+            return self.expr._parse( instring, loc, doActions, callPreParse=False )
+        else:
+            raise ParseException("",loc,self.errmsg,self)
+
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        self.expr = self.expr.copy()
+        if self.expr is not None:
+            self.expr.leaveWhitespace()
+        return self
+
+    def ignore( self, other ):
+        if isinstance( other, Suppress ):
+            if other not in self.ignoreExprs:
+                super( ParseElementEnhance, self).ignore( other )
+                if self.expr is not None:
+                    self.expr.ignore( self.ignoreExprs[-1] )
+        else:
+            super( ParseElementEnhance, self).ignore( other )
+            if self.expr is not None:
+                self.expr.ignore( self.ignoreExprs[-1] )
+        return self
+
+    def streamline( self ):
+        super(ParseElementEnhance,self).streamline()
+        if self.expr is not None:
+            self.expr.streamline()
+        return self
+
+    def checkRecursion( self, parseElementList ):
+        if self in parseElementList:
+            raise RecursiveGrammarException( parseElementList+[self] )
+        subRecCheckList = parseElementList[:] + [ self ]
+        if self.expr is not None:
+            self.expr.checkRecursion( subRecCheckList )
+
+    def validate( self, validateTrace=[] ):
+        tmp = validateTrace[:]+[self]
+        if self.expr is not None:
+            self.expr.validate(tmp)
+        self.checkRecursion( [] )
+
+    def __str__( self ):
+        try:
+            return super(ParseElementEnhance,self).__str__()
+        except Exception:
+            pass
+
+        if self.strRepr is None and self.expr is not None:
+            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
+        return self.strRepr
+
+
+class FollowedBy(ParseElementEnhance):
+    """
+    Lookahead matching of the given parse expression.  C{FollowedBy}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression matches at the current
+    position.  C{FollowedBy} always returns a null token list.
+
+    Example::
+        # use FollowedBy to match a label only if it is followed by a ':'
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
+    prints::
+        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
+    """
+    def __init__( self, expr ):
+        super(FollowedBy,self).__init__(expr)
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self.expr.tryParse( instring, loc )
+        return loc, []
+
+
+class NotAny(ParseElementEnhance):
+    """
+    Lookahead to disallow matching with the given parse expression.  C{NotAny}
+    does I{not} advance the parsing position within the input string, it only
+    verifies that the specified parse expression does I{not} match at the current
+    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
+    always returns a null token list.  May be constructed using the '~' operator.
+
+    Example::
+        
+    """
+    def __init__( self, expr ):
+        super(NotAny,self).__init__(expr)
+        #~ self.leaveWhitespace()
+        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
+        self.mayReturnEmpty = True
+        self.errmsg = "Found unwanted token, "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        if self.expr.canParseNext(instring, loc):
+            raise ParseException(instring, loc, self.errmsg, self)
+        return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "~{" + _ustr(self.expr) + "}"
+
+        return self.strRepr
+
+class _MultipleMatch(ParseElementEnhance):
+    def __init__( self, expr, stopOn=None):
+        super(_MultipleMatch, self).__init__(expr)
+        self.saveAsList = True
+        ender = stopOn
+        if isinstance(ender, basestring):
+            ender = ParserElement._literalStringClass(ender)
+        self.not_ender = ~ender if ender is not None else None
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        self_expr_parse = self.expr._parse
+        self_skip_ignorables = self._skipIgnorables
+        check_ender = self.not_ender is not None
+        if check_ender:
+            try_not_ender = self.not_ender.tryParse
+        
+        # must be at least one (but first see if we are the stopOn sentinel;
+        # if so, fail)
+        if check_ender:
+            try_not_ender(instring, loc)
+        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
+        try:
+            hasIgnoreExprs = (not not self.ignoreExprs)
+            while 1:
+                if check_ender:
+                    try_not_ender(instring, loc)
+                if hasIgnoreExprs:
+                    preloc = self_skip_ignorables( instring, loc )
+                else:
+                    preloc = loc
+                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
+                if tmptokens or tmptokens.haskeys():
+                    tokens += tmptokens
+        except (ParseException,IndexError):
+            pass
+
+        return loc, tokens
+        
+class OneOrMore(_MultipleMatch):
+    """
+    Repetition of one or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match one or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: BLACK"
+        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]
+
+        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
+        
+        # could also be written as
+        (attr_expr * (1,)).parseString(text).pprint()
+    """
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "{" + _ustr(self.expr) + "}..."
+
+        return self.strRepr
+
+class ZeroOrMore(_MultipleMatch):
+    """
+    Optional repetition of zero or more of the given expression.
+    
+    Parameters:
+     - expr - expression that must match zero or more times
+     - stopOn - (default=C{None}) - expression for a terminating sentinel
+          (only required if the sentinel would ordinarily match the repetition 
+          expression)          
+
+    Example: similar to L{OneOrMore}
+    """
+    def __init__( self, expr, stopOn=None):
+        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
+        self.mayReturnEmpty = True
+        
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
+        except (ParseException,IndexError):
+            return loc, []
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]..."
+
+        return self.strRepr
+
+class _NullToken(object):
+    def __bool__(self):
+        return False
+    __nonzero__ = __bool__
+    def __str__(self):
+        return ""
+
+_optionalNotMatched = _NullToken()
+class Optional(ParseElementEnhance):
+    """
+    Optional matching of the given expression.
+
+    Parameters:
+     - expr - expression that must match zero or more times
+     - default (optional) - value to be returned if the optional expression is not found.
+
+    Example::
+        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
+        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
+        zip.runTests('''
+            # traditional ZIP code
+            12345
+            
+            # ZIP+4 form
+            12101-0001
+            
+            # invalid ZIP
+            98765-
+            ''')
+    prints::
+        # traditional ZIP code
+        12345
+        ['12345']
+
+        # ZIP+4 form
+        12101-0001
+        ['12101-0001']
+
+        # invalid ZIP
+        98765-
+             ^
+        FAIL: Expected end of text (at char 5), (line:1, col:6)
+    """
+    def __init__( self, expr, default=_optionalNotMatched ):
+        super(Optional,self).__init__( expr, savelist=False )
+        self.saveAsList = self.expr.saveAsList
+        self.defaultValue = default
+        self.mayReturnEmpty = True
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        try:
+            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
+        except (ParseException,IndexError):
+            if self.defaultValue is not _optionalNotMatched:
+                if self.expr.resultsName:
+                    tokens = ParseResults([ self.defaultValue ])
+                    tokens[self.expr.resultsName] = self.defaultValue
+                else:
+                    tokens = [ self.defaultValue ]
+            else:
+                tokens = []
+        return loc, tokens
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+
+        if self.strRepr is None:
+            self.strRepr = "[" + _ustr(self.expr) + "]"
+
+        return self.strRepr
+
+class SkipTo(ParseElementEnhance):
+    """
+    Token for skipping over all undefined text until the matched expression is found.
+
+    Parameters:
+     - expr - target expression marking the end of the data to be skipped
+     - include - (default=C{False}) if True, the target expression is also parsed 
+          (the skipped text and target expression are returned as a 2-element list).
+     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
+          comments) that might contain false matches to the target expression
+     - failOn - (default=C{None}) define expressions that are not allowed to be 
+          included in the skipped test; if found before the target expression is found, 
+          the SkipTo is not a match
+
+    Example::
+        report = '''
+            Outstanding Issues Report - 1 Jan 2000
+
+               # | Severity | Description                               |  Days Open
+            -----+----------+-------------------------------------------+-----------
+             101 | Critical | Intermittent system crash                 |          6
+              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
+              79 | Minor    | System slow when running too many reports |         47
+            '''
+        integer = Word(nums)
+        SEP = Suppress('|')
+        # use SkipTo to simply match everything up until the next SEP
+        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
+        # - parse action will call token.strip() for each matched token, i.e., the description body
+        string_data = SkipTo(SEP, ignore=quotedString)
+        string_data.setParseAction(tokenMap(str.strip))
+        ticket_expr = (integer("issue_num") + SEP 
+                      + string_data("sev") + SEP 
+                      + string_data("desc") + SEP 
+                      + integer("days_open"))
+        
+        for tkt in ticket_expr.searchString(report):
+            print tkt.dump()
+    prints::
+        ['101', 'Critical', 'Intermittent system crash', '6']
+        - days_open: 6
+        - desc: Intermittent system crash
+        - issue_num: 101
+        - sev: Critical
+        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
+        - days_open: 14
+        - desc: Spelling error on Login ('log|n')
+        - issue_num: 94
+        - sev: Cosmetic
+        ['79', 'Minor', 'System slow when running too many reports', '47']
+        - days_open: 47
+        - desc: System slow when running too many reports
+        - issue_num: 79
+        - sev: Minor
+    """
+    def __init__( self, other, include=False, ignore=None, failOn=None ):
+        super( SkipTo, self ).__init__( other )
+        self.ignoreExpr = ignore
+        self.mayReturnEmpty = True
+        self.mayIndexError = False
+        self.includeMatch = include
+        self.asList = False
+        if isinstance(failOn, basestring):
+            self.failOn = ParserElement._literalStringClass(failOn)
+        else:
+            self.failOn = failOn
+        self.errmsg = "No match found for "+_ustr(self.expr)
+
+    def parseImpl( self, instring, loc, doActions=True ):
+        startloc = loc
+        instrlen = len(instring)
+        expr = self.expr
+        expr_parse = self.expr._parse
+        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
+        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
+        
+        tmploc = loc
+        while tmploc <= instrlen:
+            if self_failOn_canParseNext is not None:
+                # break if failOn expression matches
+                if self_failOn_canParseNext(instring, tmploc):
+                    break
+                    
+            if self_ignoreExpr_tryParse is not None:
+                # advance past ignore expressions
+                while 1:
+                    try:
+                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
+                    except ParseBaseException:
+                        break
+            
+            try:
+                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
+            except (ParseException, IndexError):
+                # no match, advance loc in string
+                tmploc += 1
+            else:
+                # matched skipto expr, done
+                break
+
+        else:
+            # ran off the end of the input string without matching skipto expr, fail
+            raise ParseException(instring, loc, self.errmsg, self)
+
+        # build up return values
+        loc = tmploc
+        skiptext = instring[startloc:loc]
+        skipresult = ParseResults(skiptext)
+        
+        if self.includeMatch:
+            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
+            skipresult += mat
+
+        return loc, skipresult
+
+class Forward(ParseElementEnhance):
+    """
+    Forward declaration of an expression to be defined later -
+    used for recursive grammars, such as algebraic infix notation.
+    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.
+
+    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
+    Specifically, '|' has a lower precedence than '<<', so that::
+        fwdExpr << a | b | c
+    will actually be evaluated as::
+        (fwdExpr << a) | b | c
+    thereby leaving b and c out as parseable alternatives.  It is recommended that you
+    explicitly group the values inserted into the C{Forward}::
+        fwdExpr << (a | b | c)
+    Converting to use the '<<=' operator instead will avoid this problem.
+
+    See L{ParseResults.pprint} for an example of a recursive parser created using
+    C{Forward}.
+    """
+    def __init__( self, other=None ):
+        super(Forward,self).__init__( other, savelist=False )
+
+    def __lshift__( self, other ):
+        if isinstance( other, basestring ):
+            other = ParserElement._literalStringClass(other)
+        self.expr = other
+        self.strRepr = None
+        self.mayIndexError = self.expr.mayIndexError
+        self.mayReturnEmpty = self.expr.mayReturnEmpty
+        self.setWhitespaceChars( self.expr.whiteChars )
+        self.skipWhitespace = self.expr.skipWhitespace
+        self.saveAsList = self.expr.saveAsList
+        self.ignoreExprs.extend(self.expr.ignoreExprs)
+        return self
+        
+    def __ilshift__(self, other):
+        return self << other
+    
+    def leaveWhitespace( self ):
+        self.skipWhitespace = False
+        return self
+
+    def streamline( self ):
+        if not self.streamlined:
+            self.streamlined = True
+            if self.expr is not None:
+                self.expr.streamline()
+        return self
+
+    def validate( self, validateTrace=[] ):
+        if self not in validateTrace:
+            tmp = validateTrace[:]+[self]
+            if self.expr is not None:
+                self.expr.validate(tmp)
+        self.checkRecursion([])
+
+    def __str__( self ):
+        if hasattr(self,"name"):
+            return self.name
+        return self.__class__.__name__ + ": ..."
+
+        # stubbed out for now - creates awful memory and perf issues
+        self._revertClass = self.__class__
+        self.__class__ = _ForwardNoRecurse
+        try:
+            if self.expr is not None:
+                retString = _ustr(self.expr)
+            else:
+                retString = "None"
+        finally:
+            self.__class__ = self._revertClass
+        return self.__class__.__name__ + ": " + retString
+
+    def copy(self):
+        if self.expr is not None:
+            return super(Forward,self).copy()
+        else:
+            ret = Forward()
+            ret <<= self
+            return ret
+
+class _ForwardNoRecurse(Forward):
+    def __str__( self ):
+        return "..."
+
+class TokenConverter(ParseElementEnhance):
+    """
+    Abstract subclass of C{ParseExpression}, for converting parsed results.
+    """
+    def __init__( self, expr, savelist=False ):
+        super(TokenConverter,self).__init__( expr )#, savelist )
+        self.saveAsList = False
+
+class Combine(TokenConverter):
+    """
+    Converter to concatenate all matching tokens to a single string.
+    By default, the matching patterns must also be contiguous in the input string;
+    this can be disabled by specifying C{'adjacent=False'} in the constructor.
+
+    Example::
+        real = Word(nums) + '.' + Word(nums)
+        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
+        # will also erroneously match the following
+        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']
+
+        real = Combine(Word(nums) + '.' + Word(nums))
+        print(real.parseString('3.1416')) # -> ['3.1416']
+        # no match when there are internal spaces
+        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
+    """
+    def __init__( self, expr, joinString="", adjacent=True ):
+        super(Combine,self).__init__( expr )
+        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
+        if adjacent:
+            self.leaveWhitespace()
+        self.adjacent = adjacent
+        self.skipWhitespace = True
+        self.joinString = joinString
+        self.callPreparse = True
+
+    def ignore( self, other ):
+        if self.adjacent:
+            ParserElement.ignore(self, other)
+        else:
+            super( Combine, self).ignore( other )
+        return self
+
+    def postParse( self, instring, loc, tokenlist ):
+        retToks = tokenlist.copy()
+        del retToks[:]
+        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)
+
+        if self.resultsName and retToks.haskeys():
+            return [ retToks ]
+        else:
+            return retToks
+
+class Group(TokenConverter):
+    """
+    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.
+
+    Example::
+        ident = Word(alphas)
+        num = Word(nums)
+        term = ident | num
+        func = ident + Optional(delimitedList(term))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']
+
+        func = ident + Group(Optional(delimitedList(term)))
+        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
+    """
+    def __init__( self, expr ):
+        super(Group,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        return [ tokenlist ]
+
+class Dict(TokenConverter):
+    """
+    Converter to return a repetitive expression as a list, but also as a dictionary.
+    Each element can also be referenced using the first token in the expression as its key.
+    Useful for tabular report scraping when the first column can be used as a item key.
+
+    Example::
+        data_word = Word(alphas)
+        label = data_word + FollowedBy(':')
+        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))
+
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        
+        # print attributes as plain groups
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
+        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
+        print(result.dump())
+        
+        # access named fields as dict entries, or output as dict
+        print(result['shape'])        
+        print(result.asDict())
+    prints::
+        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
+
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
+    See more examples at L{ParseResults} of accessing fields by results name.
+    """
+    def __init__( self, expr ):
+        super(Dict,self).__init__( expr )
+        self.saveAsList = True
+
+    def postParse( self, instring, loc, tokenlist ):
+        for i,tok in enumerate(tokenlist):
+            if len(tok) == 0:
+                continue
+            ikey = tok[0]
+            if isinstance(ikey,int):
+                ikey = _ustr(tok[0]).strip()
+            if len(tok)==1:
+                tokenlist[ikey] = _ParseResultsWithOffset("",i)
+            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
+                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
+            else:
+                dictvalue = tok.copy() #ParseResults(i)
+                del dictvalue[0]
+                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
+                else:
+                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)
+
+        if self.resultsName:
+            return [ tokenlist ]
+        else:
+            return tokenlist
+
+
+class Suppress(TokenConverter):
+    """
+    Converter for ignoring the results of a parsed expression.
+
+    Example::
+        source = "a, b, c,d"
+        wd = Word(alphas)
+        wd_list1 = wd + ZeroOrMore(',' + wd)
+        print(wd_list1.parseString(source))
+
+        # often, delimiters that are useful during parsing are just in the
+        # way afterward - use Suppress to keep them out of the parsed output
+        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
+        print(wd_list2.parseString(source))
+    prints::
+        ['a', ',', 'b', ',', 'c', ',', 'd']
+        ['a', 'b', 'c', 'd']
+    (See also L{delimitedList}.)
+    """
+    def postParse( self, instring, loc, tokenlist ):
+        return []
+
+    def suppress( self ):
+        return self
+
+
+class OnlyOnce(object):
+    """
+    Wrapper for parse actions, to ensure they are only called once.
+    """
+    def __init__(self, methodCall):
+        self.callable = _trim_arity(methodCall)
+        self.called = False
+    def __call__(self,s,l,t):
+        if not self.called:
+            results = self.callable(s,l,t)
+            self.called = True
+            return results
+        raise ParseException(s,l,"")
+    def reset(self):
+        self.called = False
+
+def traceParseAction(f):
+    """
+    Decorator for debugging parse actions. 
+    
+    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
+    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.
+
+    Example::
+        wd = Word(alphas)
+
+        @traceParseAction
+        def remove_duplicate_chars(tokens):
+            return ''.join(sorted(set(''.join(tokens))))
+
+        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
+        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
+    prints::
+        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
+        <<leaving remove_duplicate_chars (ret: 'dfjkls')
+        ['dfjkls']
+    """
+    f = _trim_arity(f)
+    def z(*paArgs):
+        thisFunc = f.__name__
+        s,l,t = paArgs[-3:]
+        if len(paArgs)>3:
+            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
+        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
+        try:
+            ret = f(*paArgs)
+        except Exception as exc:
+            sys.stderr.write( "<<leaving %s (exception: %s)\n" % (thisFunc,exc) )
+            raise
+        sys.stderr.write( "<<leaving %s (ret: %r)\n" % (thisFunc,ret) )
+        return ret
+    try:
+        z.__name__ = f.__name__
+    except AttributeError:
+        pass
+    return z
+
+#
+# global helpers
+#
+def delimitedList( expr, delim=",", combine=False ):
+    """
+    Helper to define a delimited list of expressions - the delimiter defaults to ','.
+    By default, the list elements and delimiters can have intervening whitespace, and
+    comments, but this can be overridden by passing C{combine=True} in the constructor.
+    If C{combine} is set to C{True}, the matching tokens are returned as a single token
+    string, with the delimiters included; otherwise, the matching tokens are returned
+    as a list of tokens, with the delimiters suppressed.
+
+    Example::
+        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
+        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
+    """
+    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
+    if combine:
+        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
+    else:
+        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)
+
+def countedArray( expr, intExpr=None ):
+    """
+    Helper to define a counted list of expressions.
+    This helper defines a pattern of the form::
+        integer expr expr expr...
+    where the leading integer tells how many expr expressions follow.
+    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
+    
+    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.
+
+    Example::
+        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']
+
+        # in this parser, the leading integer value is given in binary,
+        # '10' indicating that 2 values are in the array
+        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
+        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
+    """
+    arrayExpr = Forward()
+    def countFieldParseAction(s,l,t):
+        n = t[0]
+        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
+        return []
+    if intExpr is None:
+        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
+    else:
+        intExpr = intExpr.copy()
+    intExpr.setName("arrayLen")
+    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
+    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')
+
+def _flatten(L):
+    ret = []
+    for i in L:
+        if isinstance(i,list):
+            ret.extend(_flatten(i))
+        else:
+            ret.append(i)
+    return ret
+
+def matchPreviousLiteral(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousLiteral(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
+    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
+    If this is not desired, use C{matchPreviousExpr}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    def copyTokenToRepeater(s,l,t):
+        if t:
+            if len(t) == 1:
+                rep << t[0]
+            else:
+                # flatten t tokens
+                tflat = _flatten(t.asList())
+                rep << And(Literal(tt) for tt in tflat)
+        else:
+            rep << Empty()
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def matchPreviousExpr(expr):
+    """
+    Helper to define an expression that is indirectly defined from
+    the tokens matched in a previous expression, that is, it looks
+    for a 'repeat' of a previous expression.  For example::
+        first = Word(nums)
+        second = matchPreviousExpr(first)
+        matchExpr = first + ":" + second
+    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
+    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
+    the expressions are evaluated first, and then compared, so
+    C{"1"} is compared with C{"10"}.
+    Do I{not} use with packrat parsing enabled.
+    """
+    rep = Forward()
+    e2 = expr.copy()
+    rep <<= e2
+    def copyTokenToRepeater(s,l,t):
+        matchTokens = _flatten(t.asList())
+        def mustMatchTheseTokens(s,l,t):
+            theseTokens = _flatten(t.asList())
+            if  theseTokens != matchTokens:
+                raise ParseException("",0,"")
+        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
+    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
+    rep.setName('(prev) ' + _ustr(expr))
+    return rep
+
+def _escapeRegexRangeChars(s):
+    #~  escape these chars: ^-]
+    for c in r"\^-]":
+        s = s.replace(c,_bslash+c)
+    s = s.replace("\n",r"\n")
+    s = s.replace("\t",r"\t")
+    return _ustr(s)
+
+def oneOf( strs, caseless=False, useRegex=True ):
+    """
+    Helper to quickly define a set of alternative Literals, and makes sure to do
+    longest-first testing when there is a conflict, regardless of the input order,
+    but returns a C{L{MatchFirst}} for best performance.
+
+    Parameters:
+     - strs - a string of space-delimited literals, or a collection of string literals
+     - caseless - (default=C{False}) - treat all literals as caseless
+     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
+          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
+          if creating a C{Regex} raises an exception)
+
+    Example::
+        comp_oper = oneOf("< = > <= >= !=")
+        var = Word(alphas)
+        number = Word(nums)
+        term = var | number
+        comparison_expr = term + comp_oper + term
+        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
+    prints::
+        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
+    """
+    if caseless:
+        isequal = ( lambda a,b: a.upper() == b.upper() )
+        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
+        parseElementClass = CaselessLiteral
+    else:
+        isequal = ( lambda a,b: a == b )
+        masks = ( lambda a,b: b.startswith(a) )
+        parseElementClass = Literal
+
+    symbols = []
+    if isinstance(strs,basestring):
+        symbols = strs.split()
+    elif isinstance(strs, Iterable):
+        symbols = list(strs)
+    else:
+        warnings.warn("Invalid argument to oneOf, expected string or iterable",
+                SyntaxWarning, stacklevel=2)
+    if not symbols:
+        return NoMatch()
+
+    i = 0
+    while i < len(symbols)-1:
+        cur = symbols[i]
+        for j,other in enumerate(symbols[i+1:]):
+            if ( isequal(other, cur) ):
+                del symbols[i+j+1]
+                break
+            elif ( masks(cur, other) ):
+                del symbols[i+j+1]
+                symbols.insert(i,other)
+                cur = other
+                break
+        else:
+            i += 1
+
+    if not caseless and useRegex:
+        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
+        try:
+            if len(symbols)==len("".join(symbols)):
+                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
+            else:
+                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
+        except Exception:
+            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
+                    SyntaxWarning, stacklevel=2)
+
+
+    # last resort, just use MatchFirst
+    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))
+
+def dictOf( key, value ):
+    """
+    Helper to easily and clearly define a dictionary by specifying the respective patterns
+    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
+    in the proper order.  The key pattern can include delimiting markers or punctuation,
+    as long as they are suppressed, thereby leaving the significant key text.  The value
+    pattern can include named results, so that the C{Dict} results can include named token
+    fields.
+
+    Example::
+        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
+        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
+        print(OneOrMore(attr_expr).parseString(text).dump())
+        
+        attr_label = label
+        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)
+
+        # similar to Dict, but simpler call format
+        result = dictOf(attr_label, attr_value).parseString(text)
+        print(result.dump())
+        print(result['shape'])
+        print(result.shape)  # object attribute access works too
+        print(result.asDict())
+    prints::
+        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
+        - color: light blue
+        - posn: upper left
+        - shape: SQUARE
+        - texture: burlap
+        SQUARE
+        SQUARE
+        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
+    """
+    return Dict( ZeroOrMore( Group ( key + value ) ) )
+
+def originalTextFor(expr, asString=True):
+    """
+    Helper to return the original, untokenized text for a given expression.  Useful to
+    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
+    revert separate tokens with intervening whitespace back to the original matching
+    input text. By default, returns astring containing the original parsed text.  
+       
+    If the optional C{asString} argument is passed as C{False}, then the return value is a 
+    C{L{ParseResults}} containing any results names that were originally matched, and a 
+    single token containing the original matched text from the input string.  So if 
+    the expression passed to C{L{originalTextFor}} contains expressions with defined
+    results names, you must set C{asString} to C{False} if you want to preserve those
+    results name values.
+
+    Example::
+        src = "this is test <b> bold <i>text</i> </b> normal text "
+        for tag in ("b","i"):
+            opener,closer = makeHTMLTags(tag)
+            patt = originalTextFor(opener + SkipTo(closer) + closer)
+            print(patt.searchString(src)[0])
+    prints::
+        ['<b> bold <i>text</i> </b>']
+        ['<i>text</i>']
+    """
+    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
+    endlocMarker = locMarker.copy()
+    endlocMarker.callPreparse = False
+    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
+    if asString:
+        extractText = lambda s,l,t: s[t._original_start:t._original_end]
+    else:
+        def extractText(s,l,t):
+            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
+    matchExpr.setParseAction(extractText)
+    matchExpr.ignoreExprs = expr.ignoreExprs
+    return matchExpr
+
+def ungroup(expr): 
+    """
+    Helper to undo pyparsing's default grouping of And expressions, even
+    if all but one are non-empty.
+    """
+    return TokenConverter(expr).setParseAction(lambda t:t[0])
+
+def locatedExpr(expr):
+    """
+    Helper to decorate a returned token with its starting and ending locations in the input string.
+    This helper adds the following results names:
+     - locn_start = location where matched expression begins
+     - locn_end = location where matched expression ends
+     - value = the actual parsed results
+
+    Be careful if the input text contains C{<TAB>} characters, you may want to call
+    C{L{ParserElement.parseWithTabs}}
+
+    Example::
+        wd = Word(alphas)
+        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
+            print(match)
+    prints::
+        [[0, 'ljsdf', 5]]
+        [[8, 'lksdjjf', 15]]
+        [[18, 'lkkjj', 23]]
+    """
+    locator = Empty().setParseAction(lambda s,l,t: l)
+    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))
+
+
+# convenience constants for positional expressions
+empty       = Empty().setName("empty")
+lineStart   = LineStart().setName("lineStart")
+lineEnd     = LineEnd().setName("lineEnd")
+stringStart = StringStart().setName("stringStart")
+stringEnd   = StringEnd().setName("stringEnd")
+
+_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
+_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
+_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
+_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
+_charRange = Group(_singleChar + Suppress("-") + _singleChar)
+_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"
+
+def srange(s):
+    r"""
+    Helper to easily define string ranges for use in Word construction.  Borrows
+    syntax from regexp '[]' string range definitions::
+        srange("[0-9]")   -> "0123456789"
+        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
+        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
+    The input string must be enclosed in []'s, and the returned string is the expanded
+    character set joined into a single string.
+    The values enclosed in the []'s may be:
+     - a single character
+     - an escaped character with a leading backslash (such as C{\-} or C{\]})
+     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
+         (C{\0x##} is also supported for backwards compatibility) 
+     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
+     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
+     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
+    """
+    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
+    try:
+        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
+    except Exception:
+        return ""
+
+def matchOnlyAtCol(n):
+    """
+    Helper method for defining parse actions that require matching at a specific
+    column in the input text.
+    """
+    def verifyCol(strg,locn,toks):
+        if col(locn,strg) != n:
+            raise ParseException(strg,locn,"matched token not at column %d" % n)
+    return verifyCol
+
+def replaceWith(replStr):
+    """
+    Helper method for common parse actions that simply return a literal value.  Especially
+    useful when used with C{L{transformString<ParserElement.transformString>}()}.
+
+    Example::
+        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
+        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
+        term = na | num
+        
+        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
+    """
+    return lambda s,l,t: [replStr]
+
+def removeQuotes(s,l,t):
+    """
+    Helper parse action for removing quotation marks from parsed quoted strings.
+
+    Example::
+        # by default, quotation marks are included in parsed results
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]
+
+        # use removeQuotes to strip quotation marks from parsed results
+        quotedString.setParseAction(removeQuotes)
+        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
+    """
+    return t[0][1:-1]
+
+def tokenMap(func, *args):
+    """
+    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
+    args are passed, they are forwarded to the given function as additional arguments after
+    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
+    parsed data to an integer using base 16.
+
+    Example (compare the last to example in L{ParserElement.transformString}::
+        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
+        hex_ints.runTests('''
+            00 11 22 aa FF 0a 0d 1a
+            ''')
+        
+        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
+        OneOrMore(upperword).runTests('''
+            my kingdom for a horse
+            ''')
+
+        wd = Word(alphas).setParseAction(tokenMap(str.title))
+        OneOrMore(wd).setParseAction(' '.join).runTests('''
+            now is the winter of our discontent made glorious summer by this sun of york
+            ''')
+    prints::
+        00 11 22 aa FF 0a 0d 1a
+        [0, 17, 34, 170, 255, 10, 13, 26]
+
+        my kingdom for a horse
+        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']
+
+        now is the winter of our discontent made glorious summer by this sun of york
+        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
+    """
+    def pa(s,l,t):
+        return [func(tokn, *args) for tokn in t]
+
+    try:
+        func_name = getattr(func, '__name__', 
+                            getattr(func, '__class__').__name__)
+    except Exception:
+        func_name = str(func)
+    pa.__name__ = func_name
+
+    return pa
+
+upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
+"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""
+
+downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
+"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
+    
+def _makeTags(tagStr, xml):
+    """Internal helper to construct opening and closing tag expressions, given a tag name"""
+    if isinstance(tagStr,basestring):
+        resname = tagStr
+        tagStr = Keyword(tagStr, caseless=not xml)
+    else:
+        resname = tagStr.name
+
+    tagAttrName = Word(alphas,alphanums+"_-:")
+    if (xml):
+        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    else:
+        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
+        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
+        openTag = Suppress("<") + tagStr("tag") + \
+                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
+                Optional( Suppress("=") + tagAttrValue ) ))) + \
+                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
+    closeTag = Combine(_L("</") + tagStr + ">")
+
+    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
+    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("</%s>" % resname)
+    openTag.tag = resname
+    closeTag.tag = resname
+    return openTag, closeTag
+
+def makeHTMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
+    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.
+
+    Example::
+        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
+        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
+        a,a_end = makeHTMLTags("A")
+        link_expr = a + SkipTo(a_end)("link_text") + a_end
+        
+        for link in link_expr.searchString(text):
+            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
+            print(link.link_text, '->', link.href)
+    prints::
+        pyparsing -> http://pyparsing.wikispaces.com
+    """
+    return _makeTags( tagStr, False )
+
+def makeXMLTags(tagStr):
+    """
+    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
+    tags only in the given upper/lower case.
+
+    Example: similar to L{makeHTMLTags}
+    """
+    return _makeTags( tagStr, True )
+
+def withAttribute(*args,**attrDict):
+    """
+    Helper to create a validating parse action to be used with start tags created
+    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
+    with a required attribute value, to avoid false matches on common tags such as
+    C{<TD>} or C{<DIV>}.
+
+    Call C{withAttribute} with a series of attribute names and values. Specify the list
+    of filter attributes names and values as:
+     - keyword arguments, as in C{(align="right")}, or
+     - as an explicit dict with C{**} operator, when an attribute name is also a Python
+          reserved word, as in C{**{"class":"Customer", "align":"right"}}
+     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
+    For attribute names with a namespace prefix, you must use the second form.  Attribute
+    names are matched insensitive to upper/lower case.
+       
+    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.
+
+    To verify that the attribute exists, but without specifying a value, pass
+    C{withAttribute.ANY_VALUE} as the value.
+
+    Example::
+        html = '''
+            <div>
+            Some text
+            <div type="grid">1 4 0 1 0</div>
+            <div type="graph">1,3 2,3 1,1</div>
+            <div>this has no type</div>
+            </div>
+                
+        '''
+        div,div_end = makeHTMLTags("div")
+
+        # only match div tag having a type attribute with value "grid"
+        div_grid = div().setParseAction(withAttribute(type="grid"))
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+        
+        # construct a match with any div tag having a type attribute, regardless of the value
+        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+    prints::
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    if args:
+        attrs = args[:]
+    else:
+        attrs = attrDict.items()
+    attrs = [(k,v) for k,v in attrs]
+    def pa(s,l,tokens):
+        for attrName,attrValue in attrs:
+            if attrName not in tokens:
+                raise ParseException(s,l,"no matching attribute " + attrName)
+            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
+                raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" %
+                                            (attrName, tokens[attrName], attrValue))
+    return pa
+withAttribute.ANY_VALUE = object()
+
+def withClass(classname, namespace=''):
+    """
+    Simplified version of C{L{withAttribute}} when matching on a div class - made
+    difficult because C{class} is a reserved word in Python.
+
+    Example::
+        html = '''
+            <div>
+            Some text
+            <div class="grid">1 4 0 1 0</div>
+            <div class="graph">1,3 2,3 1,1</div>
+            <div>this &lt;div&gt; has no class</div>
+            </div>
+                
+        '''
+        div,div_end = makeHTMLTags("div")
+        div_grid = div().setParseAction(withClass("grid"))
+        
+        grid_expr = div_grid + SkipTo(div | div_end)("body")
+        for grid_header in grid_expr.searchString(html):
+            print(grid_header.body)
+        
+        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
+        div_expr = div_any_type + SkipTo(div | div_end)("body")
+        for div_header in div_expr.searchString(html):
+            print(div_header.body)
+    prints::
+        1 4 0 1 0
+
+        1 4 0 1 0
+        1,3 2,3 1,1
+    """
+    classattr = "%s:class" % namespace if namespace else "class"
+    return withAttribute(**{classattr : classname})        
+
+opAssoc = _Constants()
+opAssoc.LEFT = object()
+opAssoc.RIGHT = object()
+
+def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ):
+    """
+    Helper method for constructing grammars of expressions made up of
+    operators working in a precedence hierarchy.  Operators may be unary or
+    binary, left- or right-associative.  Parse actions can also be attached
+    to operator expressions. The generated parser will also recognize the use 
+    of parentheses to override operator precedences (see example below).
+    
+    Note: if you define a deep operator list, you may see performance issues
+    when using infixNotation. See L{ParserElement.enablePackrat} for a
+    mechanism to potentially improve your parser performance.
+
+    Parameters:
+     - baseExpr - expression representing the most basic element for the nested
+     - opList - list of tuples, one for each operator precedence level in the
+      expression grammar; each tuple is of the form
+      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
+       - opExpr is the pyparsing expression for the operator;
+          may also be a string, which will be converted to a Literal;
+          if numTerms is 3, opExpr is a tuple of two expressions, for the
+          two operators separating the 3 terms
+       - numTerms is the number of terms for this operator (must
+          be 1, 2, or 3)
+       - rightLeftAssoc is the indicator whether the operator is
+          right or left associative, using the pyparsing-defined
+          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
+       - parseAction is the parse action to be associated with
+          expressions matching this operator expression (the
+          parse action tuple member may be omitted); if the parse action
+          is passed a tuple or list of functions, this is equivalent to
+          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
+     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
+     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})
+
+    Example::
+        # simple example of four-function arithmetic with ints and variable names
+        integer = pyparsing_common.signed_integer
+        varname = pyparsing_common.identifier 
+        
+        arith_expr = infixNotation(integer | varname,
+            [
+            ('-', 1, opAssoc.RIGHT),
+            (oneOf('* /'), 2, opAssoc.LEFT),
+            (oneOf('+ -'), 2, opAssoc.LEFT),
+            ])
+        
+        arith_expr.runTests('''
+            5+3*6
+            (5+3)*6
+            -2--11
+            ''', fullDump=False)
+    prints::
+        5+3*6
+        [[5, '+', [3, '*', 6]]]
+
+        (5+3)*6
+        [[[5, '+', 3], '*', 6]]
+
+        -2--11
+        [[['-', 2], '-', ['-', 11]]]
+    """
+    ret = Forward()
+    lastExpr = baseExpr | ( lpar + ret + rpar )
+    for i,operDef in enumerate(opList):
+        opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4]
+        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
+        if arity == 3:
+            if opExpr is None or len(opExpr) != 2:
+                raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions")
+            opExpr1, opExpr2 = opExpr
+        thisExpr = Forward().setName(termName)
+        if rightLeftAssoc == opAssoc.LEFT:
+            if arity == 1:
+                matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) )
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) )
+                else:
+                    matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) )
+            elif arity == 3:
+                matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \
+                            Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr )
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        elif rightLeftAssoc == opAssoc.RIGHT:
+            if arity == 1:
+                # try to avoid LR with this extra test
+                if not isinstance(opExpr, Optional):
+                    opExpr = Optional(opExpr)
+                matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr )
+            elif arity == 2:
+                if opExpr is not None:
+                    matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) )
+                else:
+                    matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) )
+            elif arity == 3:
+                matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \
+                            Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr )
+            else:
+                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
+        else:
+            raise ValueError("operator must indicate right or left associativity")
+        if pa:
+            if isinstance(pa, (tuple, list)):
+                matchExpr.setParseAction(*pa)
+            else:
+                matchExpr.setParseAction(pa)
+        thisExpr <<= ( matchExpr.setName(termName) | lastExpr )
+        lastExpr = thisExpr
+    ret <<= lastExpr
+    return ret
+
+operatorPrecedence = infixNotation
+"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release."""
+
+dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes")
+sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes")
+quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'|
+                       Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes")
+unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")
+
+def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
+    """
+    Helper method for defining nested lists enclosed in opening and closing
+    delimiters ("(" and ")" are the default).
+
+    Parameters:
+     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
+     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
+     - content - expression for items within the nested lists (default=C{None})
+     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})
+
+    If an expression is not provided for the content argument, the nested
+    expression will capture all whitespace-delimited content between delimiters
+    as a list of separate values.
+
+    Use the C{ignoreExpr} argument to define expressions that may contain
+    opening or closing characters that should not be treated as opening
+    or closing characters for nesting, such as quotedString or a comment
+    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
+    The default is L{quotedString}, but if no expressions are to be ignored,
+    then pass C{None} for this argument.
+
+    Example::
+        data_type = oneOf("void int short long char float double")
+        decl_data_type = Combine(data_type + Optional(Word('*')))
+        ident = Word(alphas+'_', alphanums+'_')
+        number = pyparsing_common.number
+        arg = Group(decl_data_type + ident)
+        LPAR,RPAR = map(Suppress, "()")
+
+        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))
+
+        c_function = (decl_data_type("type") 
+                      + ident("name")
+                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
+                      + code_body("body"))
+        c_function.ignore(cStyleComment)
+        
+        source_code = '''
+            int is_odd(int x) { 
+                return (x%2); 
+            }
+                
+            int dec_to_hex(char hchar) { 
+                if (hchar >= '0' && hchar <= '9') { 
+                    return (ord(hchar)-ord('0')); 
+                } else { 
+                    return (10+ord(hchar)-ord('A'));
+                } 
+            }
+        '''
+        for func in c_function.searchString(source_code):
+            print("%(name)s (%(type)s) args: %(args)s" % func)
+
+    prints::
+        is_odd (int) args: [['int', 'x']]
+        dec_to_hex (int) args: [['char', 'hchar']]
+    """
+    if opener == closer:
+        raise ValueError("opening and closing strings cannot be the same")
+    if content is None:
+        if isinstance(opener,basestring) and isinstance(closer,basestring):
+            if len(opener) == 1 and len(closer)==1:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr +
+                                    CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+                else:
+                    content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS
+                                ).setParseAction(lambda t:t[0].strip()))
+            else:
+                if ignoreExpr is not None:
+                    content = (Combine(OneOrMore(~ignoreExpr + 
+                                    ~Literal(opener) + ~Literal(closer) +
+                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+                else:
+                    content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) +
+                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
+                                ).setParseAction(lambda t:t[0].strip()))
+        else:
+            raise ValueError("opening and closing arguments must be strings if no content expression is given")
+    ret = Forward()
+    if ignoreExpr is not None:
+        ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) )
+    else:
+        ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content )  + Suppress(closer) )
+    ret.setName('nested %s%s expression' % (opener,closer))
+    return ret
+
+def indentedBlock(blockStatementExpr, indentStack, indent=True):
+    """
+    Helper method for defining space-delimited indentation blocks, such as
+    those used to define block statements in Python source code.
+
+    Parameters:
+     - blockStatementExpr - expression defining syntax of statement that
+            is repeated within the indented block
+     - indentStack - list created by caller to manage indentation stack
+            (multiple statementWithIndentedBlock expressions within a single grammar
+            should share a common indentStack)
+     - indent - boolean indicating whether block must be indented beyond the
+            the current level; set to False for block of left-most statements
+            (default=C{True})
+
+    A valid block must contain at least one C{blockStatement}.
+
+    Example::
+        data = '''
+        def A(z):
+          A1
+          B = 100
+          G = A2
+          A2
+          A3
+        B
+        def BB(a,b,c):
+          BB1
+          def BBA():
+            bba1
+            bba2
+            bba3
+        C
+        D
+        def spam(x,y):
+             def eggs(z):
+                 pass
+        '''
+
+
+        indentStack = [1]
+        stmt = Forward()
+
+        identifier = Word(alphas, alphanums)
+        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
+        func_body = indentedBlock(stmt, indentStack)
+        funcDef = Group( funcDecl + func_body )
+
+        rvalue = Forward()
+        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
+        rvalue << (funcCall | identifier | Word(nums))
+        assignment = Group(identifier + "=" + rvalue)
+        stmt << ( funcDef | assignment | identifier )
+
+        module_body = OneOrMore(stmt)
+
+        parseTree = module_body.parseString(data)
+        parseTree.pprint()
+    prints::
+        [['def',
+          'A',
+          ['(', 'z', ')'],
+          ':',
+          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
+         'B',
+         ['def',
+          'BB',
+          ['(', 'a', 'b', 'c', ')'],
+          ':',
+          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
+         'C',
+         'D',
+         ['def',
+          'spam',
+          ['(', 'x', 'y', ')'],
+          ':',
+          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
+    """
+    def checkPeerIndent(s,l,t):
+        if l >= len(s): return
+        curCol = col(l,s)
+        if curCol != indentStack[-1]:
+            if curCol > indentStack[-1]:
+                raise ParseFatalException(s,l,"illegal nesting")
+            raise ParseException(s,l,"not a peer entry")
+
+    def checkSubIndent(s,l,t):
+        curCol = col(l,s)
+        if curCol > indentStack[-1]:
+            indentStack.append( curCol )
+        else:
+            raise ParseException(s,l,"not a subentry")
+
+    def checkUnindent(s,l,t):
+        if l >= len(s): return
+        curCol = col(l,s)
+        if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]):
+            raise ParseException(s,l,"not an unindent")
+        indentStack.pop()
+
+    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress())
+    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
+    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
+    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
+    if indent:
+        smExpr = Group( Optional(NL) +
+            #~ FollowedBy(blockStatementExpr) +
+            INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT)
+    else:
+        smExpr = Group( Optional(NL) +
+            (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) )
+    blockStatementExpr.ignore(_bslash + LineEnd())
+    return smExpr.setName('indented block')
+
+alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
+punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")
+
+anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag'))
+_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\''))
+commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
+def replaceHTMLEntity(t):
+    """Helper parser action to replace common HTML entities with their special characters"""
+    return _htmlEntityMap.get(t.entity)
+
+# it's easy to get these comment structures wrong - they're very common, so may as well make them available
+cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
+"Comment of the form C{/* ... */}"
+
+htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
+"Comment of the form C{<!-- ... -->}"
+
+restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
+dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
+"Comment of the form C{// ... (to end of line)}"
+
+cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment")
+"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}"
+
+javaStyleComment = cppStyleComment
+"Same as C{L{cppStyleComment}}"
+
+pythonStyleComment = Regex(r"#.*").setName("Python style comment")
+"Comment of the form C{# ... (to end of line)}"
+
+_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') +
+                                  Optional( Word(" \t") +
+                                            ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem")
+commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList")
+"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas.
+   This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}."""
+
+# some other useful expressions - using lower-case class name since we are really using this as a namespace
+class pyparsing_common:
+    """
+    Here are some common low-level expressions that may be useful in jump-starting parser development:
+     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
+     - common L{programming identifiers<identifier>}
+     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
+     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
+     - L{UUID<uuid>}
+     - L{comma-separated list<comma_separated_list>}
+    Parse actions:
+     - C{L{convertToInteger}}
+     - C{L{convertToFloat}}
+     - C{L{convertToDate}}
+     - C{L{convertToDatetime}}
+     - C{L{stripHTMLTags}}
+     - C{L{upcaseTokens}}
+     - C{L{downcaseTokens}}
+
+    Example::
+        pyparsing_common.number.runTests('''
+            # any int or real number, returned as the appropriate type
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.fnumber.runTests('''
+            # any int or real number, returned as float
+            100
+            -100
+            +100
+            3.14159
+            6.02e23
+            1e-12
+            ''')
+
+        pyparsing_common.hex_integer.runTests('''
+            # hex numbers
+            100
+            FF
+            ''')
+
+        pyparsing_common.fraction.runTests('''
+            # fractions
+            1/2
+            -3/4
+            ''')
+
+        pyparsing_common.mixed_integer.runTests('''
+            # mixed fractions
+            1
+            1/2
+            -3/4
+            1-3/4
+            ''')
+
+        import uuid
+        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+        pyparsing_common.uuid.runTests('''
+            # uuid
+            12345678-1234-5678-1234-567812345678
+            ''')
+    prints::
+        # any int or real number, returned as the appropriate type
+        100
+        [100]
+
+        -100
+        [-100]
+
+        +100
+        [100]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # any int or real number, returned as float
+        100
+        [100.0]
+
+        -100
+        [-100.0]
+
+        +100
+        [100.0]
+
+        3.14159
+        [3.14159]
+
+        6.02e23
+        [6.02e+23]
+
+        1e-12
+        [1e-12]
+
+        # hex numbers
+        100
+        [256]
+
+        FF
+        [255]
+
+        # fractions
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        # mixed fractions
+        1
+        [1]
+
+        1/2
+        [0.5]
+
+        -3/4
+        [-0.75]
+
+        1-3/4
+        [1.75]
+
+        # uuid
+        12345678-1234-5678-1234-567812345678
+        [UUID('12345678-1234-5678-1234-567812345678')]
+    """
+
+    convertToInteger = tokenMap(int)
+    """
+    Parse action for converting parsed integers to Python int
+    """
+
+    convertToFloat = tokenMap(float)
+    """
+    Parse action for converting parsed numbers to Python float
+    """
+
+    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
+    """expression that parses an unsigned integer, returns an int"""
+
+    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16))
+    """expression that parses a hexadecimal integer, returns an int"""
+
+    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
+    """expression that parses an integer with optional leading sign, returns an int"""
+
+    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
+    """fractional expression of an integer divided by an integer, returns a float"""
+    fraction.addParseAction(lambda t: t[0]/t[-1])
+
+    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
+    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
+    mixed_integer.addParseAction(sum)
+
+    real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat)
+    """expression that parses a floating point number and returns a float"""
+
+    sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
+    """expression that parses a floating point number with optional scientific notation and returns a float"""
+
+    # streamlining this expression makes the docs nicer-looking
+    number = (sci_real | real | signed_integer).streamline()
+    """any numeric expression, returns the corresponding Python type"""
+
+    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
+    """any int or real number, returned as float"""
+    
+    identifier = Word(alphas+'_', alphanums+'_').setName("identifier")
+    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
+    
+    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
+    "IPv4 address (C{0.0.0.0 - 255.255.255.255})"
+
+    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
+    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address")
+    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address")
+    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
+    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
+    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
+    "IPv6 address (long, short, or mixed form)"
+    
+    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
+    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"
+
+    @staticmethod
+    def convertToDate(fmt="%Y-%m-%d"):
+        """
+        Helper to create a parse action for converting parsed date string to Python datetime.date
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})
+
+        Example::
+            date_expr = pyparsing_common.iso8601_date.copy()
+            date_expr.setParseAction(pyparsing_common.convertToDate())
+            print(date_expr.parseString("1999-12-31"))
+        prints::
+            [datetime.date(1999, 12, 31)]
+        """
+        def cvt_fn(s,l,t):
+            try:
+                return datetime.strptime(t[0], fmt).date()
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    @staticmethod
+    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
+        """
+        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime
+
+        Params -
+         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})
+
+        Example::
+            dt_expr = pyparsing_common.iso8601_datetime.copy()
+            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
+            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
+        prints::
+            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
+        """
+        def cvt_fn(s,l,t):
+            try:
+                return datetime.strptime(t[0], fmt)
+            except ValueError as ve:
+                raise ParseException(s, l, str(ve))
+        return cvt_fn
+
+    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
+    "ISO8601 date (C{yyyy-mm-dd})"
+
+    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
+    "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}"
+
+    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
+    "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})"
+
+    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
+    @staticmethod
+    def stripHTMLTags(s, l, tokens):
+        """
+        Parse action to remove HTML tags from web page HTML source
+
+        Example::
+            # strip HTML links from normal text 
+            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
+            td,td_end = makeHTMLTags("TD")
+            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
+            
+            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
+        """
+        return pyparsing_common._html_stripper.transformString(tokens[0])
+
+    _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') 
+                                        + Optional( White(" \t") ) ) ).streamline().setName("commaItem")
+    comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list")
+    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""
+
+    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
+    """Parse action to convert tokens to upper case."""
+
+    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
+    """Parse action to convert tokens to lower case."""
+
+
+if __name__ == "__main__":
+
+    selectToken    = CaselessLiteral("select")
+    fromToken      = CaselessLiteral("from")
+
+    ident          = Word(alphas, alphanums + "_$")
+
+    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    columnNameList = Group(delimitedList(columnName)).setName("columns")
+    columnSpec     = ('*' | columnNameList)
+
+    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
+    tableNameList  = Group(delimitedList(tableName)).setName("tables")
+    
+    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")
+
+    # demo runTests method, including embedded comments in test string
+    simpleSQL.runTests("""
+        # '*' as column list and dotted table name
+        select * from SYS.XYZZY
+
+        # caseless match on "SELECT", and casts back to "select"
+        SELECT * from XYZZY, ABC
+
+        # list of column names, and mixed case SELECT keyword
+        Select AA,BB,CC from Sys.dual
+
+        # multiple tables
+        Select A, B, C from Sys.dual, Table2
+
+        # invalid SELECT keyword - should fail
+        Xelect A, B, C from Sys.dual
+
+        # incomplete command - should fail
+        Select
+
+        # invalid column name - should fail
+        Select ^^^ frox Sys.dual
+
+        """)
+
+    pyparsing_common.number.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    # any int or real number, returned as float
+    pyparsing_common.fnumber.runTests("""
+        100
+        -100
+        +100
+        3.14159
+        6.02e23
+        1e-12
+        """)
+
+    pyparsing_common.hex_integer.runTests("""
+        100
+        FF
+        """)
+
+    import uuid
+    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
+    pyparsing_common.uuid.runTests("""
+        12345678-1234-5678-1234-567812345678
+        """)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py
new file mode 100644
index 0000000000000000000000000000000000000000..190c0239cd7d7af82a6e0cbc8d68053fa2e3dfaf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/_vendor/six.py
@@ -0,0 +1,868 @@
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+# Copyright (c) 2010-2015 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson <benjamin@python.org>"
+__version__ = "1.10.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = str,
+    integer_types = int,
+    class_types = type,
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = basestring,
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+
+            def __len__(self):
+                return 1 << 31
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+    get_source = get_code  # same as get_code
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser",
+                "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog",
+                "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
+                "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+                      "moves.urllib_parse", "moves.urllib.parse")
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+                      "moves.urllib_error", "moves.urllib.error")
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+                      "moves.urllib_request", "moves.urllib.request")
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+                      "moves.urllib_response", "moves.urllib.response")
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+                      "moves.urllib_robotparser", "moves.urllib.robotparser")
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ['parse', 'error', 'request', 'response', 'robotparser']
+
+_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
+                      "moves.urllib")
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+    def advance_iterator(it):
+        return it.next()
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(get_unbound_function,
+         """Get the function out of a possibly unbound function""")
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems,
+         "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(iterlists,
+         "Return an iterator over the (key, [values]) pairs of a dictionary.")
+
+
+if PY3:
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+    unichr = chr
+    import struct
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+else:
+    def b(s):
+        return s
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        if value is None:
+            value = tp()
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+
+else:
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec("""exec _code_ in _globs_, _locs_""")
+
+    exec_("""def reraise(tp, value, tb=None):
+    raise tp, value, tb
+""")
+
+
+if sys.version_info[:2] == (3, 2):
+    exec_("""def raise_from(value, from_value):
+    if from_value is None:
+        raise value
+    raise value from from_value
+""")
+elif sys.version_info[:2] > (3, 2):
+    exec_("""def raise_from(value, from_value):
+    raise value from from_value
+""")
+else:
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (isinstance(fp, file) and
+                    isinstance(data, unicode) and
+                    fp.encoding is not None):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
+              updated=functools.WRAPPER_UPDATES):
+        def wrapper(f):
+            f = functools.wraps(wrapped, assigned, updated)(f)
+            f.__wrapped__ = wrapped
+            return f
+        return wrapper
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(meta):
+
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+    return type.__new__(metaclass, 'temporary_class', (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get('__slots__')
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop('__dict__', None)
+        orig_vars.pop('__weakref__', None)
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+    return wrapper
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if '__str__' not in klass.__dict__:
+            raise ValueError("@python_2_unicode_compatible cannot be applied "
+                             "to %s because it doesn't define __str__()." %
+                             klass.__name__)
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (type(importer).__name__ == "_SixMetaPathImporter" and
+                importer.name == __name__):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/archive_util.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/archive_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..81436044d995ff430334a7ef324b08e616f4b7a7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/archive_util.py
@@ -0,0 +1,173 @@
+"""Utilities for extracting common archive formats"""
+
+import zipfile
+import tarfile
+import os
+import shutil
+import posixpath
+import contextlib
+from distutils.errors import DistutilsError
+
+from pkg_resources import ensure_directory
+
+__all__ = [
+    "unpack_archive", "unpack_zipfile", "unpack_tarfile", "default_filter",
+    "UnrecognizedFormat", "extraction_drivers", "unpack_directory",
+]
+
+
+class UnrecognizedFormat(DistutilsError):
+    """Couldn't recognize the archive type"""
+
+
+def default_filter(src, dst):
+    """The default progress/filter callback; returns True for all files"""
+    return dst
+
+
+def unpack_archive(filename, extract_dir, progress_filter=default_filter,
+        drivers=None):
+    """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``
+
+    `progress_filter` is a function taking two arguments: a source path
+    internal to the archive ('/'-separated), and a filesystem path where it
+    will be extracted.  The callback must return the desired extract path
+    (which may be the same as the one passed in), or else ``None`` to skip
+    that file or directory.  The callback can thus be used to report on the
+    progress of the extraction, as well as to filter the items extracted or
+    alter their extraction paths.
+
+    `drivers`, if supplied, must be a non-empty sequence of functions with the
+    same signature as this function (minus the `drivers` argument), that raise
+    ``UnrecognizedFormat`` if they do not support extracting the designated
+    archive type.  The `drivers` are tried in sequence until one is found that
+    does not raise an error, or until all are exhausted (in which case
+    ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
+    drivers, the module's ``extraction_drivers`` constant will be used, which
+    means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
+    order.
+    """
+    for driver in drivers or extraction_drivers:
+        try:
+            driver(filename, extract_dir, progress_filter)
+        except UnrecognizedFormat:
+            continue
+        else:
+            return
+    else:
+        raise UnrecognizedFormat(
+            "Not a recognized archive type: %s" % filename
+        )
+
+
+def unpack_directory(filename, extract_dir, progress_filter=default_filter):
+    """"Unpack" a directory, using the same interface as for archives
+
+    Raises ``UnrecognizedFormat`` if `filename` is not a directory
+    """
+    if not os.path.isdir(filename):
+        raise UnrecognizedFormat("%s is not a directory" % filename)
+
+    paths = {
+        filename: ('', extract_dir),
+    }
+    for base, dirs, files in os.walk(filename):
+        src, dst = paths[base]
+        for d in dirs:
+            paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d)
+        for f in files:
+            target = os.path.join(dst, f)
+            target = progress_filter(src + f, target)
+            if not target:
+                # skip non-files
+                continue
+            ensure_directory(target)
+            f = os.path.join(base, f)
+            shutil.copyfile(f, target)
+            shutil.copystat(f, target)
+
+
+def unpack_zipfile(filename, extract_dir, progress_filter=default_filter):
+    """Unpack zip `filename` to `extract_dir`
+
+    Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined
+    by ``zipfile.is_zipfile()``).  See ``unpack_archive()`` for an explanation
+    of the `progress_filter` argument.
+    """
+
+    if not zipfile.is_zipfile(filename):
+        raise UnrecognizedFormat("%s is not a zip file" % (filename,))
+
+    with zipfile.ZipFile(filename) as z:
+        for info in z.infolist():
+            name = info.filename
+
+            # don't extract absolute paths or ones with .. in them
+            if name.startswith('/') or '..' in name.split('/'):
+                continue
+
+            target = os.path.join(extract_dir, *name.split('/'))
+            target = progress_filter(name, target)
+            if not target:
+                continue
+            if name.endswith('/'):
+                # directory
+                ensure_directory(target)
+            else:
+                # file
+                ensure_directory(target)
+                data = z.read(info.filename)
+                with open(target, 'wb') as f:
+                    f.write(data)
+            unix_attributes = info.external_attr >> 16
+            if unix_attributes:
+                os.chmod(target, unix_attributes)
+
+
+def unpack_tarfile(filename, extract_dir, progress_filter=default_filter):
+    """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`
+
+    Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined
+    by ``tarfile.open()``).  See ``unpack_archive()`` for an explanation
+    of the `progress_filter` argument.
+    """
+    try:
+        tarobj = tarfile.open(filename)
+    except tarfile.TarError:
+        raise UnrecognizedFormat(
+            "%s is not a compressed or uncompressed tar file" % (filename,)
+        )
+    with contextlib.closing(tarobj):
+        # don't do any chowning!
+        tarobj.chown = lambda *args: None
+        for member in tarobj:
+            name = member.name
+            # don't extract absolute paths or ones with .. in them
+            if not name.startswith('/') and '..' not in name.split('/'):
+                prelim_dst = os.path.join(extract_dir, *name.split('/'))
+
+                # resolve any links and to extract the link targets as normal
+                # files
+                while member is not None and (member.islnk() or member.issym()):
+                    linkpath = member.linkname
+                    if member.issym():
+                        base = posixpath.dirname(member.name)
+                        linkpath = posixpath.join(base, linkpath)
+                        linkpath = posixpath.normpath(linkpath)
+                    member = tarobj._getmember(linkpath)
+
+                if member is not None and (member.isfile() or member.isdir()):
+                    final_dst = progress_filter(name, prelim_dst)
+                    if final_dst:
+                        if final_dst.endswith(os.sep):
+                            final_dst = final_dst[:-1]
+                        try:
+                            # XXX Ugh
+                            tarobj._extract_member(member, final_dst)
+                        except tarfile.ExtractError:
+                            # chown/chmod/mkfifo/mknode/makedev failed
+                            pass
+        return True
+
+
+extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/build_meta.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/build_meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..10c4b528d996d23a1319e3fed755aef0e6da2eb9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/build_meta.py
@@ -0,0 +1,257 @@
+"""A PEP 517 interface to setuptools
+
+Previously, when a user or a command line tool (let's call it a "frontend")
+needed to make a request of setuptools to take a certain action, for
+example, generating a list of installation requirements, the frontend would
+would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.
+
+PEP 517 defines a different method of interfacing with setuptools. Rather
+than calling "setup.py" directly, the frontend should:
+
+  1. Set the current directory to the directory with a setup.py file
+  2. Import this module into a safe python interpreter (one in which
+     setuptools can potentially set global variables or crash hard).
+  3. Call one of the functions defined in PEP 517.
+
+What each function does is defined in PEP 517. However, here is a "casual"
+definition of the functions (this definition should not be relied on for
+bug reports or API stability):
+
+  - `build_wheel`: build a wheel in the folder and return the basename
+  - `get_requires_for_build_wheel`: get the `setup_requires` to build
+  - `prepare_metadata_for_build_wheel`: get the `install_requires`
+  - `build_sdist`: build an sdist in the folder and return the basename
+  - `get_requires_for_build_sdist`: get the `setup_requires` to build
+
+Again, this is not a formal definition! Just a "taste" of the module.
+"""
+
+import io
+import os
+import sys
+import tokenize
+import shutil
+import contextlib
+
+import setuptools
+import distutils
+from setuptools.py31compat import TemporaryDirectory
+
+from pkg_resources import parse_requirements
+from pkg_resources.py31compat import makedirs
+
+__all__ = ['get_requires_for_build_sdist',
+           'get_requires_for_build_wheel',
+           'prepare_metadata_for_build_wheel',
+           'build_wheel',
+           'build_sdist',
+           '__legacy__',
+           'SetupRequirementsError']
+
+class SetupRequirementsError(BaseException):
+    def __init__(self, specifiers):
+        self.specifiers = specifiers
+
+
+class Distribution(setuptools.dist.Distribution):
+    def fetch_build_eggs(self, specifiers):
+        specifier_list = list(map(str, parse_requirements(specifiers)))
+
+        raise SetupRequirementsError(specifier_list)
+
+    @classmethod
+    @contextlib.contextmanager
+    def patch(cls):
+        """
+        Replace
+        distutils.dist.Distribution with this class
+        for the duration of this context.
+        """
+        orig = distutils.core.Distribution
+        distutils.core.Distribution = cls
+        try:
+            yield
+        finally:
+            distutils.core.Distribution = orig
+
+
+def _to_str(s):
+    """
+    Convert a filename to a string (on Python 2, explicitly
+    a byte string, not Unicode) as distutils checks for the
+    exact type str.
+    """
+    if sys.version_info[0] == 2 and not isinstance(s, str):
+        # Assume it's Unicode, as that's what the PEP says
+        # should be provided.
+        return s.encode(sys.getfilesystemencoding())
+    return s
+
+
+def _get_immediate_subdirectories(a_dir):
+    return [name for name in os.listdir(a_dir)
+            if os.path.isdir(os.path.join(a_dir, name))]
+
+
+def _file_with_extension(directory, extension):
+    matching = (
+        f for f in os.listdir(directory)
+        if f.endswith(extension)
+    )
+    file, = matching
+    return file
+
+
+def _open_setup_script(setup_script):
+    if not os.path.exists(setup_script):
+        # Supply a default setup.py
+        return io.StringIO(u"from setuptools import setup; setup()")
+
+    return getattr(tokenize, 'open', open)(setup_script)
+
+
+class _BuildMetaBackend(object):
+
+    def _fix_config(self, config_settings):
+        config_settings = config_settings or {}
+        config_settings.setdefault('--global-option', [])
+        return config_settings
+
+    def _get_build_requires(self, config_settings, requirements):
+        config_settings = self._fix_config(config_settings)
+
+        sys.argv = sys.argv[:1] + ['egg_info'] + \
+            config_settings["--global-option"]
+        try:
+            with Distribution.patch():
+                self.run_setup()
+        except SetupRequirementsError as e:
+            requirements += e.specifiers
+
+        return requirements
+
+    def run_setup(self, setup_script='setup.py'):
+        # Note that we can reuse our build directory between calls
+        # Correctness comes first, then optimization later
+        __file__ = setup_script
+        __name__ = '__main__'
+
+        with _open_setup_script(__file__) as f:
+            code = f.read().replace(r'\r\n', r'\n')
+
+        exec(compile(code, __file__, 'exec'), locals())
+
+    def get_requires_for_build_wheel(self, config_settings=None):
+        config_settings = self._fix_config(config_settings)
+        return self._get_build_requires(config_settings, requirements=['wheel'])
+
+    def get_requires_for_build_sdist(self, config_settings=None):
+        config_settings = self._fix_config(config_settings)
+        return self._get_build_requires(config_settings, requirements=[])
+
+    def prepare_metadata_for_build_wheel(self, metadata_directory,
+                                         config_settings=None):
+        sys.argv = sys.argv[:1] + ['dist_info', '--egg-base',
+                                   _to_str(metadata_directory)]
+        self.run_setup()
+
+        dist_info_directory = metadata_directory
+        while True:
+            dist_infos = [f for f in os.listdir(dist_info_directory)
+                          if f.endswith('.dist-info')]
+
+            if (len(dist_infos) == 0 and
+                len(_get_immediate_subdirectories(dist_info_directory)) == 1):
+
+                dist_info_directory = os.path.join(
+                    dist_info_directory, os.listdir(dist_info_directory)[0])
+                continue
+
+            assert len(dist_infos) == 1
+            break
+
+        # PEP 517 requires that the .dist-info directory be placed in the
+        # metadata_directory. To comply, we MUST copy the directory to the root
+        if dist_info_directory != metadata_directory:
+            shutil.move(
+                os.path.join(dist_info_directory, dist_infos[0]),
+                metadata_directory)
+            shutil.rmtree(dist_info_directory, ignore_errors=True)
+
+        return dist_infos[0]
+
+    def _build_with_temp_dir(self, setup_command, result_extension,
+                             result_directory, config_settings):
+        config_settings = self._fix_config(config_settings)
+        result_directory = os.path.abspath(result_directory)
+
+        # Build in a temporary directory, then copy to the target.
+        makedirs(result_directory, exist_ok=True)
+        with TemporaryDirectory(dir=result_directory) as tmp_dist_dir:
+            sys.argv = (sys.argv[:1] + setup_command +
+                        ['--dist-dir', tmp_dist_dir] +
+                        config_settings["--global-option"])
+            self.run_setup()
+
+            result_basename = _file_with_extension(tmp_dist_dir, result_extension)
+            result_path = os.path.join(result_directory, result_basename)
+            if os.path.exists(result_path):
+                # os.rename will fail overwriting on non-Unix.
+                os.remove(result_path)
+            os.rename(os.path.join(tmp_dist_dir, result_basename), result_path)
+
+        return result_basename
+
+
+    def build_wheel(self, wheel_directory, config_settings=None,
+                    metadata_directory=None):
+        return self._build_with_temp_dir(['bdist_wheel'], '.whl',
+                                         wheel_directory, config_settings)
+
+    def build_sdist(self, sdist_directory, config_settings=None):
+        return self._build_with_temp_dir(['sdist', '--formats', 'gztar'],
+                                         '.tar.gz', sdist_directory,
+                                         config_settings)
+
+
+class _BuildMetaLegacyBackend(_BuildMetaBackend):
+    """Compatibility backend for setuptools
+
+    This is a version of setuptools.build_meta that endeavors to maintain backwards
+    compatibility with pre-PEP 517 modes of invocation. It exists as a temporary
+    bridge between the old packaging mechanism and the new packaging mechanism,
+    and will eventually be removed.
+    """
+    def run_setup(self, setup_script='setup.py'):
+        # In order to maintain compatibility with scripts assuming that
+        # the setup.py script is in a directory on the PYTHONPATH, inject
+        # '' into sys.path. (pypa/setuptools#1642)
+        sys_path = list(sys.path)           # Save the original path
+
+        script_dir = os.path.dirname(os.path.abspath(setup_script))
+        if script_dir not in sys.path:
+            sys.path.insert(0, script_dir)
+
+        try:
+            super(_BuildMetaLegacyBackend,
+                  self).run_setup(setup_script=setup_script)
+        finally:
+            # While PEP 517 frontends should be calling each hook in a fresh
+            # subprocess according to the standard (and thus it should not be
+            # strictly necessary to restore the old sys.path), we'll restore
+            # the original path so that the path manipulation does not persist
+            # within the hook after run_setup is called.
+            sys.path[:] = sys_path
+
+# The primary backend
+_BACKEND = _BuildMetaBackend()
+
+get_requires_for_build_wheel = _BACKEND.get_requires_for_build_wheel
+get_requires_for_build_sdist = _BACKEND.get_requires_for_build_sdist
+prepare_metadata_for_build_wheel = _BACKEND.prepare_metadata_for_build_wheel
+build_wheel = _BACKEND.build_wheel
+build_sdist = _BACKEND.build_sdist
+
+
+# The legacy backend
+__legacy__ = _BuildMetaLegacyBackend()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-32.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-32.exe
new file mode 100644
index 0000000000000000000000000000000000000000..b1487b7819e7286577a043c7726fbe0ca1543083
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-32.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-64.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-64.exe
new file mode 100644
index 0000000000000000000000000000000000000000..675e6bf3743f3d3011c238657e7128ee9960ef7f
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli-64.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli.exe
new file mode 100644
index 0000000000000000000000000000000000000000..b1487b7819e7286577a043c7726fbe0ca1543083
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/cli.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..743f5588faf3ad79850df7bd196749e7a6c03f93
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/__init__.py
@@ -0,0 +1,17 @@
+__all__ = [
+    'alias', 'bdist_egg', 'bdist_rpm', 'build_ext', 'build_py', 'develop',
+    'easy_install', 'egg_info', 'install', 'install_lib', 'rotate', 'saveopts',
+    'sdist', 'setopt', 'test', 'install_egg_info', 'install_scripts',
+    'bdist_wininst', 'upload_docs', 'build_clib', 'dist_info',
+]
+
+from distutils.command.bdist import bdist
+import sys
+
+from setuptools.command import install_scripts
+
+if 'egg' not in bdist.format_commands:
+    bdist.format_command['egg'] = ('bdist_egg', "Python .egg file")
+    bdist.format_commands.append('egg')
+
+del bdist, sys
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/alias.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/alias.py
new file mode 100644
index 0000000000000000000000000000000000000000..4532b1cc0dca76227927e873f9c64f01008e565a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/alias.py
@@ -0,0 +1,80 @@
+from distutils.errors import DistutilsOptionError
+
+from setuptools.extern.six.moves import map
+
+from setuptools.command.setopt import edit_config, option_base, config_file
+
+
+def shquote(arg):
+    """Quote an argument for later parsing by shlex.split()"""
+    for c in '"', "'", "\\", "#":
+        if c in arg:
+            return repr(arg)
+    if arg.split() != [arg]:
+        return repr(arg)
+    return arg
+
+
+class alias(option_base):
+    """Define a shortcut that invokes one or more commands"""
+
+    description = "define a shortcut to invoke one or more commands"
+    command_consumes_arguments = True
+
+    user_options = [
+        ('remove', 'r', 'remove (unset) the alias'),
+    ] + option_base.user_options
+
+    boolean_options = option_base.boolean_options + ['remove']
+
+    def initialize_options(self):
+        option_base.initialize_options(self)
+        self.args = None
+        self.remove = None
+
+    def finalize_options(self):
+        option_base.finalize_options(self)
+        if self.remove and len(self.args) != 1:
+            raise DistutilsOptionError(
+                "Must specify exactly one argument (the alias name) when "
+                "using --remove"
+            )
+
+    def run(self):
+        aliases = self.distribution.get_option_dict('aliases')
+
+        if not self.args:
+            print("Command Aliases")
+            print("---------------")
+            for alias in aliases:
+                print("setup.py alias", format_alias(alias, aliases))
+            return
+
+        elif len(self.args) == 1:
+            alias, = self.args
+            if self.remove:
+                command = None
+            elif alias in aliases:
+                print("setup.py alias", format_alias(alias, aliases))
+                return
+            else:
+                print("No alias definition found for %r" % alias)
+                return
+        else:
+            alias = self.args[0]
+            command = ' '.join(map(shquote, self.args[1:]))
+
+        edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run)
+
+
+def format_alias(name, aliases):
+    source, command = aliases[name]
+    if source == config_file('global'):
+        source = '--global-config '
+    elif source == config_file('user'):
+        source = '--user-config '
+    elif source == config_file('local'):
+        source = ''
+    else:
+        source = '--filename=%r' % source
+    return source + name + ' ' + command
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py
new file mode 100644
index 0000000000000000000000000000000000000000..98470f1715b21befab94b3e84428622a1ba86463
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_egg.py
@@ -0,0 +1,502 @@
+"""setuptools.command.bdist_egg
+
+Build .egg distributions"""
+
+from distutils.errors import DistutilsSetupError
+from distutils.dir_util import remove_tree, mkpath
+from distutils import log
+from types import CodeType
+import sys
+import os
+import re
+import textwrap
+import marshal
+
+from setuptools.extern import six
+
+from pkg_resources import get_build_platform, Distribution, ensure_directory
+from pkg_resources import EntryPoint
+from setuptools.extension import Library
+from setuptools import Command
+
+try:
+    # Python 2.7 or >=3.2
+    from sysconfig import get_path, get_python_version
+
+    def _get_purelib():
+        return get_path("purelib")
+except ImportError:
+    from distutils.sysconfig import get_python_lib, get_python_version
+
+    def _get_purelib():
+        return get_python_lib(False)
+
+
+def strip_module(filename):
+    if '.' in filename:
+        filename = os.path.splitext(filename)[0]
+    if filename.endswith('module'):
+        filename = filename[:-6]
+    return filename
+
+
+def sorted_walk(dir):
+    """Do os.walk in a reproducible way,
+    independent of indeterministic filesystem readdir order
+    """
+    for base, dirs, files in os.walk(dir):
+        dirs.sort()
+        files.sort()
+        yield base, dirs, files
+
+
+def write_stub(resource, pyfile):
+    _stub_template = textwrap.dedent("""
+        def __bootstrap__():
+            global __bootstrap__, __loader__, __file__
+            import sys, pkg_resources, imp
+            __file__ = pkg_resources.resource_filename(__name__, %r)
+            __loader__ = None; del __bootstrap__, __loader__
+            imp.load_dynamic(__name__,__file__)
+        __bootstrap__()
+        """).lstrip()
+    with open(pyfile, 'w') as f:
+        f.write(_stub_template % resource)
+
+
+class bdist_egg(Command):
+    description = "create an \"egg\" distribution"
+
+    user_options = [
+        ('bdist-dir=', 'b',
+         "temporary directory for creating the distribution"),
+        ('plat-name=', 'p', "platform name to embed in generated filenames "
+                            "(default: %s)" % get_build_platform()),
+        ('exclude-source-files', None,
+         "remove all .py files from the generated egg"),
+        ('keep-temp', 'k',
+         "keep the pseudo-installation tree around after " +
+         "creating the distribution archive"),
+        ('dist-dir=', 'd',
+         "directory to put final built distributions in"),
+        ('skip-build', None,
+         "skip rebuilding everything (for testing/debugging)"),
+    ]
+
+    boolean_options = [
+        'keep-temp', 'skip-build', 'exclude-source-files'
+    ]
+
+    def initialize_options(self):
+        self.bdist_dir = None
+        self.plat_name = None
+        self.keep_temp = 0
+        self.dist_dir = None
+        self.skip_build = 0
+        self.egg_output = None
+        self.exclude_source_files = None
+
+    def finalize_options(self):
+        ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info")
+        self.egg_info = ei_cmd.egg_info
+
+        if self.bdist_dir is None:
+            bdist_base = self.get_finalized_command('bdist').bdist_base
+            self.bdist_dir = os.path.join(bdist_base, 'egg')
+
+        if self.plat_name is None:
+            self.plat_name = get_build_platform()
+
+        self.set_undefined_options('bdist', ('dist_dir', 'dist_dir'))
+
+        if self.egg_output is None:
+
+            # Compute filename of the output egg
+            basename = Distribution(
+                None, None, ei_cmd.egg_name, ei_cmd.egg_version,
+                get_python_version(),
+                self.distribution.has_ext_modules() and self.plat_name
+            ).egg_name()
+
+            self.egg_output = os.path.join(self.dist_dir, basename + '.egg')
+
+    def do_install_data(self):
+        # Hack for packages that install data to install's --install-lib
+        self.get_finalized_command('install').install_lib = self.bdist_dir
+
+        site_packages = os.path.normcase(os.path.realpath(_get_purelib()))
+        old, self.distribution.data_files = self.distribution.data_files, []
+
+        for item in old:
+            if isinstance(item, tuple) and len(item) == 2:
+                if os.path.isabs(item[0]):
+                    realpath = os.path.realpath(item[0])
+                    normalized = os.path.normcase(realpath)
+                    if normalized == site_packages or normalized.startswith(
+                        site_packages + os.sep
+                    ):
+                        item = realpath[len(site_packages) + 1:], item[1]
+                        # XXX else: raise ???
+            self.distribution.data_files.append(item)
+
+        try:
+            log.info("installing package data to %s", self.bdist_dir)
+            self.call_command('install_data', force=0, root=None)
+        finally:
+            self.distribution.data_files = old
+
+    def get_outputs(self):
+        return [self.egg_output]
+
+    def call_command(self, cmdname, **kw):
+        """Invoke reinitialized command `cmdname` with keyword args"""
+        for dirname in INSTALL_DIRECTORY_ATTRS:
+            kw.setdefault(dirname, self.bdist_dir)
+        kw.setdefault('skip_build', self.skip_build)
+        kw.setdefault('dry_run', self.dry_run)
+        cmd = self.reinitialize_command(cmdname, **kw)
+        self.run_command(cmdname)
+        return cmd
+
+    def run(self):
+        # Generate metadata first
+        self.run_command("egg_info")
+        # We run install_lib before install_data, because some data hacks
+        # pull their data path from the install_lib command.
+        log.info("installing library code to %s", self.bdist_dir)
+        instcmd = self.get_finalized_command('install')
+        old_root = instcmd.root
+        instcmd.root = None
+        if self.distribution.has_c_libraries() and not self.skip_build:
+            self.run_command('build_clib')
+        cmd = self.call_command('install_lib', warn_dir=0)
+        instcmd.root = old_root
+
+        all_outputs, ext_outputs = self.get_ext_outputs()
+        self.stubs = []
+        to_compile = []
+        for (p, ext_name) in enumerate(ext_outputs):
+            filename, ext = os.path.splitext(ext_name)
+            pyfile = os.path.join(self.bdist_dir, strip_module(filename) +
+                                  '.py')
+            self.stubs.append(pyfile)
+            log.info("creating stub loader for %s", ext_name)
+            if not self.dry_run:
+                write_stub(os.path.basename(ext_name), pyfile)
+            to_compile.append(pyfile)
+            ext_outputs[p] = ext_name.replace(os.sep, '/')
+
+        if to_compile:
+            cmd.byte_compile(to_compile)
+        if self.distribution.data_files:
+            self.do_install_data()
+
+        # Make the EGG-INFO directory
+        archive_root = self.bdist_dir
+        egg_info = os.path.join(archive_root, 'EGG-INFO')
+        self.mkpath(egg_info)
+        if self.distribution.scripts:
+            script_dir = os.path.join(egg_info, 'scripts')
+            log.info("installing scripts to %s", script_dir)
+            self.call_command('install_scripts', install_dir=script_dir,
+                              no_ep=1)
+
+        self.copy_metadata_to(egg_info)
+        native_libs = os.path.join(egg_info, "native_libs.txt")
+        if all_outputs:
+            log.info("writing %s", native_libs)
+            if not self.dry_run:
+                ensure_directory(native_libs)
+                libs_file = open(native_libs, 'wt')
+                libs_file.write('\n'.join(all_outputs))
+                libs_file.write('\n')
+                libs_file.close()
+        elif os.path.isfile(native_libs):
+            log.info("removing %s", native_libs)
+            if not self.dry_run:
+                os.unlink(native_libs)
+
+        write_safety_flag(
+            os.path.join(archive_root, 'EGG-INFO'), self.zip_safe()
+        )
+
+        if os.path.exists(os.path.join(self.egg_info, 'depends.txt')):
+            log.warn(
+                "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n"
+                "Use the install_requires/extras_require setup() args instead."
+            )
+
+        if self.exclude_source_files:
+            self.zap_pyfiles()
+
+        # Make the archive
+        make_zipfile(self.egg_output, archive_root, verbose=self.verbose,
+                     dry_run=self.dry_run, mode=self.gen_header())
+        if not self.keep_temp:
+            remove_tree(self.bdist_dir, dry_run=self.dry_run)
+
+        # Add to 'Distribution.dist_files' so that the "upload" command works
+        getattr(self.distribution, 'dist_files', []).append(
+            ('bdist_egg', get_python_version(), self.egg_output))
+
+    def zap_pyfiles(self):
+        log.info("Removing .py files from temporary directory")
+        for base, dirs, files in walk_egg(self.bdist_dir):
+            for name in files:
+                path = os.path.join(base, name)
+
+                if name.endswith('.py'):
+                    log.debug("Deleting %s", path)
+                    os.unlink(path)
+
+                if base.endswith('__pycache__'):
+                    path_old = path
+
+                    pattern = r'(?P<name>.+)\.(?P<magic>[^.]+)\.pyc'
+                    m = re.match(pattern, name)
+                    path_new = os.path.join(
+                        base, os.pardir, m.group('name') + '.pyc')
+                    log.info(
+                        "Renaming file from [%s] to [%s]"
+                        % (path_old, path_new))
+                    try:
+                        os.remove(path_new)
+                    except OSError:
+                        pass
+                    os.rename(path_old, path_new)
+
+    def zip_safe(self):
+        safe = getattr(self.distribution, 'zip_safe', None)
+        if safe is not None:
+            return safe
+        log.warn("zip_safe flag not set; analyzing archive contents...")
+        return analyze_egg(self.bdist_dir, self.stubs)
+
+    def gen_header(self):
+        epm = EntryPoint.parse_map(self.distribution.entry_points or '')
+        ep = epm.get('setuptools.installation', {}).get('eggsecutable')
+        if ep is None:
+            return 'w'  # not an eggsecutable, do it the usual way.
+
+        if not ep.attrs or ep.extras:
+            raise DistutilsSetupError(
+                "eggsecutable entry point (%r) cannot have 'extras' "
+                "or refer to a module" % (ep,)
+            )
+
+        pyver = '{}.{}'.format(*sys.version_info)
+        pkg = ep.module_name
+        full = '.'.join(ep.attrs)
+        base = ep.attrs[0]
+        basename = os.path.basename(self.egg_output)
+
+        header = (
+            "#!/bin/sh\n"
+            'if [ `basename $0` = "%(basename)s" ]\n'
+            'then exec python%(pyver)s -c "'
+            "import sys, os; sys.path.insert(0, os.path.abspath('$0')); "
+            "from %(pkg)s import %(base)s; sys.exit(%(full)s())"
+            '" "$@"\n'
+            'else\n'
+            '  echo $0 is not the correct name for this egg file.\n'
+            '  echo Please rename it back to %(basename)s and try again.\n'
+            '  exec false\n'
+            'fi\n'
+        ) % locals()
+
+        if not self.dry_run:
+            mkpath(os.path.dirname(self.egg_output), dry_run=self.dry_run)
+            f = open(self.egg_output, 'w')
+            f.write(header)
+            f.close()
+        return 'a'
+
+    def copy_metadata_to(self, target_dir):
+        "Copy metadata (egg info) to the target_dir"
+        # normalize the path (so that a forward-slash in egg_info will
+        # match using startswith below)
+        norm_egg_info = os.path.normpath(self.egg_info)
+        prefix = os.path.join(norm_egg_info, '')
+        for path in self.ei_cmd.filelist.files:
+            if path.startswith(prefix):
+                target = os.path.join(target_dir, path[len(prefix):])
+                ensure_directory(target)
+                self.copy_file(path, target)
+
+    def get_ext_outputs(self):
+        """Get a list of relative paths to C extensions in the output distro"""
+
+        all_outputs = []
+        ext_outputs = []
+
+        paths = {self.bdist_dir: ''}
+        for base, dirs, files in sorted_walk(self.bdist_dir):
+            for filename in files:
+                if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS:
+                    all_outputs.append(paths[base] + filename)
+            for filename in dirs:
+                paths[os.path.join(base, filename)] = (paths[base] +
+                                                       filename + '/')
+
+        if self.distribution.has_ext_modules():
+            build_cmd = self.get_finalized_command('build_ext')
+            for ext in build_cmd.extensions:
+                if isinstance(ext, Library):
+                    continue
+                fullname = build_cmd.get_ext_fullname(ext.name)
+                filename = build_cmd.get_ext_filename(fullname)
+                if not os.path.basename(filename).startswith('dl-'):
+                    if os.path.exists(os.path.join(self.bdist_dir, filename)):
+                        ext_outputs.append(filename)
+
+        return all_outputs, ext_outputs
+
+
+NATIVE_EXTENSIONS = dict.fromkeys('.dll .so .dylib .pyd'.split())
+
+
+def walk_egg(egg_dir):
+    """Walk an unpacked egg's contents, skipping the metadata directory"""
+    walker = sorted_walk(egg_dir)
+    base, dirs, files = next(walker)
+    if 'EGG-INFO' in dirs:
+        dirs.remove('EGG-INFO')
+    yield base, dirs, files
+    for bdf in walker:
+        yield bdf
+
+
+def analyze_egg(egg_dir, stubs):
+    # check for existing flag in EGG-INFO
+    for flag, fn in safety_flags.items():
+        if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)):
+            return flag
+    if not can_scan():
+        return False
+    safe = True
+    for base, dirs, files in walk_egg(egg_dir):
+        for name in files:
+            if name.endswith('.py') or name.endswith('.pyw'):
+                continue
+            elif name.endswith('.pyc') or name.endswith('.pyo'):
+                # always scan, even if we already know we're not safe
+                safe = scan_module(egg_dir, base, name, stubs) and safe
+    return safe
+
+
+def write_safety_flag(egg_dir, safe):
+    # Write or remove zip safety flag file(s)
+    for flag, fn in safety_flags.items():
+        fn = os.path.join(egg_dir, fn)
+        if os.path.exists(fn):
+            if safe is None or bool(safe) != flag:
+                os.unlink(fn)
+        elif safe is not None and bool(safe) == flag:
+            f = open(fn, 'wt')
+            f.write('\n')
+            f.close()
+
+
+safety_flags = {
+    True: 'zip-safe',
+    False: 'not-zip-safe',
+}
+
+
+def scan_module(egg_dir, base, name, stubs):
+    """Check whether module possibly uses unsafe-for-zipfile stuff"""
+
+    filename = os.path.join(base, name)
+    if filename[:-1] in stubs:
+        return True  # Extension module
+    pkg = base[len(egg_dir) + 1:].replace(os.sep, '.')
+    module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0]
+    if six.PY2:
+        skip = 8  # skip magic & date
+    elif sys.version_info < (3, 7):
+        skip = 12  # skip magic & date & file size
+    else:
+        skip = 16  # skip magic & reserved? & date & file size
+    f = open(filename, 'rb')
+    f.read(skip)
+    code = marshal.load(f)
+    f.close()
+    safe = True
+    symbols = dict.fromkeys(iter_symbols(code))
+    for bad in ['__file__', '__path__']:
+        if bad in symbols:
+            log.warn("%s: module references %s", module, bad)
+            safe = False
+    if 'inspect' in symbols:
+        for bad in [
+            'getsource', 'getabsfile', 'getsourcefile', 'getfile'
+            'getsourcelines', 'findsource', 'getcomments', 'getframeinfo',
+            'getinnerframes', 'getouterframes', 'stack', 'trace'
+        ]:
+            if bad in symbols:
+                log.warn("%s: module MAY be using inspect.%s", module, bad)
+                safe = False
+    return safe
+
+
+def iter_symbols(code):
+    """Yield names and strings used by `code` and its nested code objects"""
+    for name in code.co_names:
+        yield name
+    for const in code.co_consts:
+        if isinstance(const, six.string_types):
+            yield const
+        elif isinstance(const, CodeType):
+            for name in iter_symbols(const):
+                yield name
+
+
+def can_scan():
+    if not sys.platform.startswith('java') and sys.platform != 'cli':
+        # CPython, PyPy, etc.
+        return True
+    log.warn("Unable to analyze compiled code on this platform.")
+    log.warn("Please ask the author to include a 'zip_safe'"
+             " setting (either True or False) in the package's setup.py")
+
+
+# Attribute names of options for commands that might need to be convinced to
+# install to the egg build directory
+
+INSTALL_DIRECTORY_ATTRS = [
+    'install_lib', 'install_dir', 'install_data', 'install_base'
+]
+
+
+def make_zipfile(zip_filename, base_dir, verbose=0, dry_run=0, compress=True,
+                 mode='w'):
+    """Create a zip file from all the files under 'base_dir'.  The output
+    zip file will be named 'base_dir' + ".zip".  Uses either the "zipfile"
+    Python module (if available) or the InfoZIP "zip" utility (if installed
+    and found on the default search path).  If neither tool is available,
+    raises DistutilsExecError.  Returns the name of the output zip file.
+    """
+    import zipfile
+
+    mkpath(os.path.dirname(zip_filename), dry_run=dry_run)
+    log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir)
+
+    def visit(z, dirname, names):
+        for name in names:
+            path = os.path.normpath(os.path.join(dirname, name))
+            if os.path.isfile(path):
+                p = path[len(base_dir) + 1:]
+                if not dry_run:
+                    z.write(path, p)
+                log.debug("adding '%s'", p)
+
+    compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED
+    if not dry_run:
+        z = zipfile.ZipFile(zip_filename, mode, compression=compression)
+        for dirname, dirs, files in sorted_walk(base_dir):
+            visit(z, dirname, files)
+        z.close()
+    else:
+        for dirname, dirs, files in sorted_walk(base_dir):
+            visit(None, dirname, files)
+    return zip_filename
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py
new file mode 100644
index 0000000000000000000000000000000000000000..70730927ecaed778ebbdee98eb37c24ec3f1a8e6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_rpm.py
@@ -0,0 +1,43 @@
+import distutils.command.bdist_rpm as orig
+
+
+class bdist_rpm(orig.bdist_rpm):
+    """
+    Override the default bdist_rpm behavior to do the following:
+
+    1. Run egg_info to ensure the name and version are properly calculated.
+    2. Always run 'install' using --single-version-externally-managed to
+       disable eggs in RPM distributions.
+    3. Replace dash with underscore in the version numbers for better RPM
+       compatibility.
+    """
+
+    def run(self):
+        # ensure distro name is up-to-date
+        self.run_command('egg_info')
+
+        orig.bdist_rpm.run(self)
+
+    def _make_spec_file(self):
+        version = self.distribution.get_version()
+        rpmversion = version.replace('-', '_')
+        spec = orig.bdist_rpm._make_spec_file(self)
+        line23 = '%define version ' + version
+        line24 = '%define version ' + rpmversion
+        spec = [
+            line.replace(
+                "Source0: %{name}-%{version}.tar",
+                "Source0: %{name}-%{unmangled_version}.tar"
+            ).replace(
+                "setup.py install ",
+                "setup.py install --single-version-externally-managed "
+            ).replace(
+                "%setup",
+                "%setup -n %{name}-%{unmangled_version}"
+            ).replace(line23, line24)
+            for line in spec
+        ]
+        insert_loc = spec.index(line24) + 1
+        unmangled_version = "%define unmangled_version " + version
+        spec.insert(insert_loc, unmangled_version)
+        return spec
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py
new file mode 100644
index 0000000000000000000000000000000000000000..073de97b46c92e2e221cade8c1350ab2c5cff891
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/bdist_wininst.py
@@ -0,0 +1,21 @@
+import distutils.command.bdist_wininst as orig
+
+
+class bdist_wininst(orig.bdist_wininst):
+    def reinitialize_command(self, command, reinit_subcommands=0):
+        """
+        Supplement reinitialize_command to work around
+        http://bugs.python.org/issue20819
+        """
+        cmd = self.distribution.reinitialize_command(
+            command, reinit_subcommands)
+        if command in ('install', 'install_lib'):
+            cmd.install_lib = None
+        return cmd
+
+    def run(self):
+        self._is_running = True
+        try:
+            orig.bdist_wininst.run(self)
+        finally:
+            self._is_running = False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py
new file mode 100644
index 0000000000000000000000000000000000000000..09caff6ffde8fc3f368cb635dc3cbbbc8851530d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_clib.py
@@ -0,0 +1,98 @@
+import distutils.command.build_clib as orig
+from distutils.errors import DistutilsSetupError
+from distutils import log
+from setuptools.dep_util import newer_pairwise_group
+
+
+class build_clib(orig.build_clib):
+    """
+    Override the default build_clib behaviour to do the following:
+
+    1. Implement a rudimentary timestamp-based dependency system
+       so 'compile()' doesn't run every time.
+    2. Add more keys to the 'build_info' dictionary:
+        * obj_deps - specify dependencies for each object compiled.
+                     this should be a dictionary mapping a key
+                     with the source filename to a list of
+                     dependencies. Use an empty string for global
+                     dependencies.
+        * cflags   - specify a list of additional flags to pass to
+                     the compiler.
+    """
+
+    def build_libraries(self, libraries):
+        for (lib_name, build_info) in libraries:
+            sources = build_info.get('sources')
+            if sources is None or not isinstance(sources, (list, tuple)):
+                raise DistutilsSetupError(
+                       "in 'libraries' option (library '%s'), "
+                       "'sources' must be present and must be "
+                       "a list of source filenames" % lib_name)
+            sources = list(sources)
+
+            log.info("building '%s' library", lib_name)
+
+            # Make sure everything is the correct type.
+            # obj_deps should be a dictionary of keys as sources
+            # and a list/tuple of files that are its dependencies.
+            obj_deps = build_info.get('obj_deps', dict())
+            if not isinstance(obj_deps, dict):
+                raise DistutilsSetupError(
+                       "in 'libraries' option (library '%s'), "
+                       "'obj_deps' must be a dictionary of "
+                       "type 'source: list'" % lib_name)
+            dependencies = []
+
+            # Get the global dependencies that are specified by the '' key.
+            # These will go into every source's dependency list.
+            global_deps = obj_deps.get('', list())
+            if not isinstance(global_deps, (list, tuple)):
+                raise DistutilsSetupError(
+                       "in 'libraries' option (library '%s'), "
+                       "'obj_deps' must be a dictionary of "
+                       "type 'source: list'" % lib_name)
+
+            # Build the list to be used by newer_pairwise_group
+            # each source will be auto-added to its dependencies.
+            for source in sources:
+                src_deps = [source]
+                src_deps.extend(global_deps)
+                extra_deps = obj_deps.get(source, list())
+                if not isinstance(extra_deps, (list, tuple)):
+                    raise DistutilsSetupError(
+                           "in 'libraries' option (library '%s'), "
+                           "'obj_deps' must be a dictionary of "
+                           "type 'source: list'" % lib_name)
+                src_deps.extend(extra_deps)
+                dependencies.append(src_deps)
+
+            expected_objects = self.compiler.object_filenames(
+                    sources,
+                    output_dir=self.build_temp
+                    )
+
+            if newer_pairwise_group(dependencies, expected_objects) != ([], []):
+                # First, compile the source code to object files in the library
+                # directory.  (This should probably change to putting object
+                # files in a temporary build directory.)
+                macros = build_info.get('macros')
+                include_dirs = build_info.get('include_dirs')
+                cflags = build_info.get('cflags')
+                objects = self.compiler.compile(
+                        sources,
+                        output_dir=self.build_temp,
+                        macros=macros,
+                        include_dirs=include_dirs,
+                        extra_postargs=cflags,
+                        debug=self.debug
+                        )
+
+            # Now "link" the object files together into a static library.
+            # (On Unix at least, this isn't really linking -- it just
+            # builds an archive.  Whatever.)
+            self.compiler.create_static_lib(
+                    expected_objects,
+                    lib_name,
+                    output_dir=self.build_clib,
+                    debug=self.debug
+                    )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..daa8e4fe81c18e8fc3e07718b4a66137b062127e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_ext.py
@@ -0,0 +1,327 @@
+import os
+import sys
+import itertools
+from distutils.command.build_ext import build_ext as _du_build_ext
+from distutils.file_util import copy_file
+from distutils.ccompiler import new_compiler
+from distutils.sysconfig import customize_compiler, get_config_var
+from distutils.errors import DistutilsError
+from distutils import log
+
+from setuptools.extension import Library
+from setuptools.extern import six
+
+if six.PY2:
+    import imp
+
+    EXTENSION_SUFFIXES = [s for s, _, tp in imp.get_suffixes() if tp == imp.C_EXTENSION]
+else:
+    from importlib.machinery import EXTENSION_SUFFIXES
+
+try:
+    # Attempt to use Cython for building extensions, if available
+    from Cython.Distutils.build_ext import build_ext as _build_ext
+    # Additionally, assert that the compiler module will load
+    # also. Ref #1229.
+    __import__('Cython.Compiler.Main')
+except ImportError:
+    _build_ext = _du_build_ext
+
+# make sure _config_vars is initialized
+get_config_var("LDSHARED")
+from distutils.sysconfig import _config_vars as _CONFIG_VARS
+
+
+def _customize_compiler_for_shlib(compiler):
+    if sys.platform == "darwin":
+        # building .dylib requires additional compiler flags on OSX; here we
+        # temporarily substitute the pyconfig.h variables so that distutils'
+        # 'customize_compiler' uses them before we build the shared libraries.
+        tmp = _CONFIG_VARS.copy()
+        try:
+            # XXX Help!  I don't have any idea whether these are right...
+            _CONFIG_VARS['LDSHARED'] = (
+                "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup")
+            _CONFIG_VARS['CCSHARED'] = " -dynamiclib"
+            _CONFIG_VARS['SO'] = ".dylib"
+            customize_compiler(compiler)
+        finally:
+            _CONFIG_VARS.clear()
+            _CONFIG_VARS.update(tmp)
+    else:
+        customize_compiler(compiler)
+
+
+have_rtld = False
+use_stubs = False
+libtype = 'shared'
+
+if sys.platform == "darwin":
+    use_stubs = True
+elif os.name != 'nt':
+    try:
+        import dl
+        use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW')
+    except ImportError:
+        pass
+
+if_dl = lambda s: s if have_rtld else ''
+
+
+def get_abi3_suffix():
+    """Return the file extension for an abi3-compliant Extension()"""
+    for suffix in EXTENSION_SUFFIXES:
+        if '.abi3' in suffix:  # Unix
+            return suffix
+        elif suffix == '.pyd':  # Windows
+            return suffix
+
+
+class build_ext(_build_ext):
+    def run(self):
+        """Build extensions in build directory, then copy if --inplace"""
+        old_inplace, self.inplace = self.inplace, 0
+        _build_ext.run(self)
+        self.inplace = old_inplace
+        if old_inplace:
+            self.copy_extensions_to_source()
+
+    def copy_extensions_to_source(self):
+        build_py = self.get_finalized_command('build_py')
+        for ext in self.extensions:
+            fullname = self.get_ext_fullname(ext.name)
+            filename = self.get_ext_filename(fullname)
+            modpath = fullname.split('.')
+            package = '.'.join(modpath[:-1])
+            package_dir = build_py.get_package_dir(package)
+            dest_filename = os.path.join(package_dir,
+                                         os.path.basename(filename))
+            src_filename = os.path.join(self.build_lib, filename)
+
+            # Always copy, even if source is older than destination, to ensure
+            # that the right extensions for the current Python/platform are
+            # used.
+            copy_file(
+                src_filename, dest_filename, verbose=self.verbose,
+                dry_run=self.dry_run
+            )
+            if ext._needs_stub:
+                self.write_stub(package_dir or os.curdir, ext, True)
+
+    def get_ext_filename(self, fullname):
+        filename = _build_ext.get_ext_filename(self, fullname)
+        if fullname in self.ext_map:
+            ext = self.ext_map[fullname]
+            use_abi3 = (
+                six.PY3
+                and getattr(ext, 'py_limited_api')
+                and get_abi3_suffix()
+            )
+            if use_abi3:
+                so_ext = get_config_var('EXT_SUFFIX')
+                filename = filename[:-len(so_ext)]
+                filename = filename + get_abi3_suffix()
+            if isinstance(ext, Library):
+                fn, ext = os.path.splitext(filename)
+                return self.shlib_compiler.library_filename(fn, libtype)
+            elif use_stubs and ext._links_to_dynamic:
+                d, fn = os.path.split(filename)
+                return os.path.join(d, 'dl-' + fn)
+        return filename
+
+    def initialize_options(self):
+        _build_ext.initialize_options(self)
+        self.shlib_compiler = None
+        self.shlibs = []
+        self.ext_map = {}
+
+    def finalize_options(self):
+        _build_ext.finalize_options(self)
+        self.extensions = self.extensions or []
+        self.check_extensions_list(self.extensions)
+        self.shlibs = [ext for ext in self.extensions
+                       if isinstance(ext, Library)]
+        if self.shlibs:
+            self.setup_shlib_compiler()
+        for ext in self.extensions:
+            ext._full_name = self.get_ext_fullname(ext.name)
+        for ext in self.extensions:
+            fullname = ext._full_name
+            self.ext_map[fullname] = ext
+
+            # distutils 3.1 will also ask for module names
+            # XXX what to do with conflicts?
+            self.ext_map[fullname.split('.')[-1]] = ext
+
+            ltd = self.shlibs and self.links_to_dynamic(ext) or False
+            ns = ltd and use_stubs and not isinstance(ext, Library)
+            ext._links_to_dynamic = ltd
+            ext._needs_stub = ns
+            filename = ext._file_name = self.get_ext_filename(fullname)
+            libdir = os.path.dirname(os.path.join(self.build_lib, filename))
+            if ltd and libdir not in ext.library_dirs:
+                ext.library_dirs.append(libdir)
+            if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs:
+                ext.runtime_library_dirs.append(os.curdir)
+
+    def setup_shlib_compiler(self):
+        compiler = self.shlib_compiler = new_compiler(
+            compiler=self.compiler, dry_run=self.dry_run, force=self.force
+        )
+        _customize_compiler_for_shlib(compiler)
+
+        if self.include_dirs is not None:
+            compiler.set_include_dirs(self.include_dirs)
+        if self.define is not None:
+            # 'define' option is a list of (name,value) tuples
+            for (name, value) in self.define:
+                compiler.define_macro(name, value)
+        if self.undef is not None:
+            for macro in self.undef:
+                compiler.undefine_macro(macro)
+        if self.libraries is not None:
+            compiler.set_libraries(self.libraries)
+        if self.library_dirs is not None:
+            compiler.set_library_dirs(self.library_dirs)
+        if self.rpath is not None:
+            compiler.set_runtime_library_dirs(self.rpath)
+        if self.link_objects is not None:
+            compiler.set_link_objects(self.link_objects)
+
+        # hack so distutils' build_extension() builds a library instead
+        compiler.link_shared_object = link_shared_object.__get__(compiler)
+
+    def get_export_symbols(self, ext):
+        if isinstance(ext, Library):
+            return ext.export_symbols
+        return _build_ext.get_export_symbols(self, ext)
+
+    def build_extension(self, ext):
+        ext._convert_pyx_sources_to_lang()
+        _compiler = self.compiler
+        try:
+            if isinstance(ext, Library):
+                self.compiler = self.shlib_compiler
+            _build_ext.build_extension(self, ext)
+            if ext._needs_stub:
+                cmd = self.get_finalized_command('build_py').build_lib
+                self.write_stub(cmd, ext)
+        finally:
+            self.compiler = _compiler
+
+    def links_to_dynamic(self, ext):
+        """Return true if 'ext' links to a dynamic lib in the same package"""
+        # XXX this should check to ensure the lib is actually being built
+        # XXX as dynamic, and not just using a locally-found version or a
+        # XXX static-compiled version
+        libnames = dict.fromkeys([lib._full_name for lib in self.shlibs])
+        pkg = '.'.join(ext._full_name.split('.')[:-1] + [''])
+        return any(pkg + libname in libnames for libname in ext.libraries)
+
+    def get_outputs(self):
+        return _build_ext.get_outputs(self) + self.__get_stubs_outputs()
+
+    def __get_stubs_outputs(self):
+        # assemble the base name for each extension that needs a stub
+        ns_ext_bases = (
+            os.path.join(self.build_lib, *ext._full_name.split('.'))
+            for ext in self.extensions
+            if ext._needs_stub
+        )
+        # pair each base with the extension
+        pairs = itertools.product(ns_ext_bases, self.__get_output_extensions())
+        return list(base + fnext for base, fnext in pairs)
+
+    def __get_output_extensions(self):
+        yield '.py'
+        yield '.pyc'
+        if self.get_finalized_command('build_py').optimize:
+            yield '.pyo'
+
+    def write_stub(self, output_dir, ext, compile=False):
+        log.info("writing stub loader for %s to %s", ext._full_name,
+                 output_dir)
+        stub_file = (os.path.join(output_dir, *ext._full_name.split('.')) +
+                     '.py')
+        if compile and os.path.exists(stub_file):
+            raise DistutilsError(stub_file + " already exists! Please delete.")
+        if not self.dry_run:
+            f = open(stub_file, 'w')
+            f.write(
+                '\n'.join([
+                    "def __bootstrap__():",
+                    "   global __bootstrap__, __file__, __loader__",
+                    "   import sys, os, pkg_resources, imp" + if_dl(", dl"),
+                    "   __file__ = pkg_resources.resource_filename"
+                    "(__name__,%r)"
+                    % os.path.basename(ext._file_name),
+                    "   del __bootstrap__",
+                    "   if '__loader__' in globals():",
+                    "       del __loader__",
+                    if_dl("   old_flags = sys.getdlopenflags()"),
+                    "   old_dir = os.getcwd()",
+                    "   try:",
+                    "     os.chdir(os.path.dirname(__file__))",
+                    if_dl("     sys.setdlopenflags(dl.RTLD_NOW)"),
+                    "     imp.load_dynamic(__name__,__file__)",
+                    "   finally:",
+                    if_dl("     sys.setdlopenflags(old_flags)"),
+                    "     os.chdir(old_dir)",
+                    "__bootstrap__()",
+                    ""  # terminal \n
+                ])
+            )
+            f.close()
+        if compile:
+            from distutils.util import byte_compile
+
+            byte_compile([stub_file], optimize=0,
+                         force=True, dry_run=self.dry_run)
+            optimize = self.get_finalized_command('install_lib').optimize
+            if optimize > 0:
+                byte_compile([stub_file], optimize=optimize,
+                             force=True, dry_run=self.dry_run)
+            if os.path.exists(stub_file) and not self.dry_run:
+                os.unlink(stub_file)
+
+
+if use_stubs or os.name == 'nt':
+    # Build shared libraries
+    #
+    def link_shared_object(
+            self, objects, output_libname, output_dir=None, libraries=None,
+            library_dirs=None, runtime_library_dirs=None, export_symbols=None,
+            debug=0, extra_preargs=None, extra_postargs=None, build_temp=None,
+            target_lang=None):
+        self.link(
+            self.SHARED_LIBRARY, objects, output_libname,
+            output_dir, libraries, library_dirs, runtime_library_dirs,
+            export_symbols, debug, extra_preargs, extra_postargs,
+            build_temp, target_lang
+        )
+else:
+    # Build static libraries everywhere else
+    libtype = 'static'
+
+    def link_shared_object(
+            self, objects, output_libname, output_dir=None, libraries=None,
+            library_dirs=None, runtime_library_dirs=None, export_symbols=None,
+            debug=0, extra_preargs=None, extra_postargs=None, build_temp=None,
+            target_lang=None):
+        # XXX we need to either disallow these attrs on Library instances,
+        # or warn/abort here if set, or something...
+        # libraries=None, library_dirs=None, runtime_library_dirs=None,
+        # export_symbols=None, extra_preargs=None, extra_postargs=None,
+        # build_temp=None
+
+        assert output_dir is None  # distutils build_ext doesn't pass this
+        output_dir, filename = os.path.split(output_libname)
+        basename, ext = os.path.splitext(filename)
+        if self.library_filename("x").startswith('lib'):
+            # strip 'lib' prefix; this is kludgy if some platform uses
+            # a different prefix
+            basename = basename[3:]
+
+        self.create_static_lib(
+            objects, basename, output_dir, debug, target_lang
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_py.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_py.py
new file mode 100644
index 0000000000000000000000000000000000000000..b0314fd413ae7f8c1027ccde0b092fd493fb104b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/build_py.py
@@ -0,0 +1,270 @@
+from glob import glob
+from distutils.util import convert_path
+import distutils.command.build_py as orig
+import os
+import fnmatch
+import textwrap
+import io
+import distutils.errors
+import itertools
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import map, filter, filterfalse
+
+try:
+    from setuptools.lib2to3_ex import Mixin2to3
+except ImportError:
+
+    class Mixin2to3:
+        def run_2to3(self, files, doctests=True):
+            "do nothing"
+
+
+class build_py(orig.build_py, Mixin2to3):
+    """Enhanced 'build_py' command that includes data files with packages
+
+    The data files are specified via a 'package_data' argument to 'setup()'.
+    See 'setuptools.dist.Distribution' for more details.
+
+    Also, this version of the 'build_py' command allows you to specify both
+    'py_modules' and 'packages' in the same setup operation.
+    """
+
+    def finalize_options(self):
+        orig.build_py.finalize_options(self)
+        self.package_data = self.distribution.package_data
+        self.exclude_package_data = (self.distribution.exclude_package_data or
+                                     {})
+        if 'data_files' in self.__dict__:
+            del self.__dict__['data_files']
+        self.__updated_files = []
+        self.__doctests_2to3 = []
+
+    def run(self):
+        """Build modules, packages, and copy data files to build directory"""
+        if not self.py_modules and not self.packages:
+            return
+
+        if self.py_modules:
+            self.build_modules()
+
+        if self.packages:
+            self.build_packages()
+            self.build_package_data()
+
+        self.run_2to3(self.__updated_files, False)
+        self.run_2to3(self.__updated_files, True)
+        self.run_2to3(self.__doctests_2to3, True)
+
+        # Only compile actual .py files, using our base class' idea of what our
+        # output files are.
+        self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=0))
+
+    def __getattr__(self, attr):
+        "lazily compute data files"
+        if attr == 'data_files':
+            self.data_files = self._get_data_files()
+            return self.data_files
+        return orig.build_py.__getattr__(self, attr)
+
+    def build_module(self, module, module_file, package):
+        if six.PY2 and isinstance(package, six.string_types):
+            # avoid errors on Python 2 when unicode is passed (#190)
+            package = package.split('.')
+        outfile, copied = orig.build_py.build_module(self, module, module_file,
+                                                     package)
+        if copied:
+            self.__updated_files.append(outfile)
+        return outfile, copied
+
+    def _get_data_files(self):
+        """Generate list of '(package,src_dir,build_dir,filenames)' tuples"""
+        self.analyze_manifest()
+        return list(map(self._get_pkg_data_files, self.packages or ()))
+
+    def _get_pkg_data_files(self, package):
+        # Locate package source directory
+        src_dir = self.get_package_dir(package)
+
+        # Compute package build directory
+        build_dir = os.path.join(*([self.build_lib] + package.split('.')))
+
+        # Strip directory from globbed filenames
+        filenames = [
+            os.path.relpath(file, src_dir)
+            for file in self.find_data_files(package, src_dir)
+        ]
+        return package, src_dir, build_dir, filenames
+
+    def find_data_files(self, package, src_dir):
+        """Return filenames for package's data files in 'src_dir'"""
+        patterns = self._get_platform_patterns(
+            self.package_data,
+            package,
+            src_dir,
+        )
+        globs_expanded = map(glob, patterns)
+        # flatten the expanded globs into an iterable of matches
+        globs_matches = itertools.chain.from_iterable(globs_expanded)
+        glob_files = filter(os.path.isfile, globs_matches)
+        files = itertools.chain(
+            self.manifest_files.get(package, []),
+            glob_files,
+        )
+        return self.exclude_data_files(package, src_dir, files)
+
+    def build_package_data(self):
+        """Copy data files into build directory"""
+        for package, src_dir, build_dir, filenames in self.data_files:
+            for filename in filenames:
+                target = os.path.join(build_dir, filename)
+                self.mkpath(os.path.dirname(target))
+                srcfile = os.path.join(src_dir, filename)
+                outf, copied = self.copy_file(srcfile, target)
+                srcfile = os.path.abspath(srcfile)
+                if (copied and
+                        srcfile in self.distribution.convert_2to3_doctests):
+                    self.__doctests_2to3.append(outf)
+
+    def analyze_manifest(self):
+        self.manifest_files = mf = {}
+        if not self.distribution.include_package_data:
+            return
+        src_dirs = {}
+        for package in self.packages or ():
+            # Locate package source directory
+            src_dirs[assert_relative(self.get_package_dir(package))] = package
+
+        self.run_command('egg_info')
+        ei_cmd = self.get_finalized_command('egg_info')
+        for path in ei_cmd.filelist.files:
+            d, f = os.path.split(assert_relative(path))
+            prev = None
+            oldf = f
+            while d and d != prev and d not in src_dirs:
+                prev = d
+                d, df = os.path.split(d)
+                f = os.path.join(df, f)
+            if d in src_dirs:
+                if path.endswith('.py') and f == oldf:
+                    continue  # it's a module, not data
+                mf.setdefault(src_dirs[d], []).append(path)
+
+    def get_data_files(self):
+        pass  # Lazily compute data files in _get_data_files() function.
+
+    def check_package(self, package, package_dir):
+        """Check namespace packages' __init__ for declare_namespace"""
+        try:
+            return self.packages_checked[package]
+        except KeyError:
+            pass
+
+        init_py = orig.build_py.check_package(self, package, package_dir)
+        self.packages_checked[package] = init_py
+
+        if not init_py or not self.distribution.namespace_packages:
+            return init_py
+
+        for pkg in self.distribution.namespace_packages:
+            if pkg == package or pkg.startswith(package + '.'):
+                break
+        else:
+            return init_py
+
+        with io.open(init_py, 'rb') as f:
+            contents = f.read()
+        if b'declare_namespace' not in contents:
+            raise distutils.errors.DistutilsError(
+                "Namespace package problem: %s is a namespace package, but "
+                "its\n__init__.py does not call declare_namespace()! Please "
+                'fix it.\n(See the setuptools manual under '
+                '"Namespace Packages" for details.)\n"' % (package,)
+            )
+        return init_py
+
+    def initialize_options(self):
+        self.packages_checked = {}
+        orig.build_py.initialize_options(self)
+
+    def get_package_dir(self, package):
+        res = orig.build_py.get_package_dir(self, package)
+        if self.distribution.src_root is not None:
+            return os.path.join(self.distribution.src_root, res)
+        return res
+
+    def exclude_data_files(self, package, src_dir, files):
+        """Filter filenames for package's data files in 'src_dir'"""
+        files = list(files)
+        patterns = self._get_platform_patterns(
+            self.exclude_package_data,
+            package,
+            src_dir,
+        )
+        match_groups = (
+            fnmatch.filter(files, pattern)
+            for pattern in patterns
+        )
+        # flatten the groups of matches into an iterable of matches
+        matches = itertools.chain.from_iterable(match_groups)
+        bad = set(matches)
+        keepers = (
+            fn
+            for fn in files
+            if fn not in bad
+        )
+        # ditch dupes
+        return list(_unique_everseen(keepers))
+
+    @staticmethod
+    def _get_platform_patterns(spec, package, src_dir):
+        """
+        yield platform-specific path patterns (suitable for glob
+        or fn_match) from a glob-based spec (such as
+        self.package_data or self.exclude_package_data)
+        matching package in src_dir.
+        """
+        raw_patterns = itertools.chain(
+            spec.get('', []),
+            spec.get(package, []),
+        )
+        return (
+            # Each pattern has to be converted to a platform-specific path
+            os.path.join(src_dir, convert_path(pattern))
+            for pattern in raw_patterns
+        )
+
+
+# from Python docs
+def _unique_everseen(iterable, key=None):
+    "List unique elements, preserving order. Remember all elements ever seen."
+    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
+    # unique_everseen('ABBCcAD', str.lower) --> A B C D
+    seen = set()
+    seen_add = seen.add
+    if key is None:
+        for element in filterfalse(seen.__contains__, iterable):
+            seen_add(element)
+            yield element
+    else:
+        for element in iterable:
+            k = key(element)
+            if k not in seen:
+                seen_add(k)
+                yield element
+
+
+def assert_relative(path):
+    if not os.path.isabs(path):
+        return path
+    from distutils.errors import DistutilsSetupError
+
+    msg = textwrap.dedent("""
+        Error: setup script specifies an absolute path:
+
+            %s
+
+        setup() arguments must *always* be /-separated paths relative to the
+        setup.py directory, *never* absolute paths.
+        """).lstrip() % path
+    raise DistutilsSetupError(msg)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/develop.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/develop.py
new file mode 100644
index 0000000000000000000000000000000000000000..009e4f9368f5b29fffd160f3b712fb0cd19807bd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/develop.py
@@ -0,0 +1,221 @@
+from distutils.util import convert_path
+from distutils import log
+from distutils.errors import DistutilsError, DistutilsOptionError
+import os
+import glob
+import io
+
+from setuptools.extern import six
+
+import pkg_resources
+from setuptools.command.easy_install import easy_install
+from setuptools import namespaces
+import setuptools
+
+__metaclass__ = type
+
+
+class develop(namespaces.DevelopInstaller, easy_install):
+    """Set up package for development"""
+
+    description = "install package in 'development mode'"
+
+    user_options = easy_install.user_options + [
+        ("uninstall", "u", "Uninstall this source package"),
+        ("egg-path=", None, "Set the path to be used in the .egg-link file"),
+    ]
+
+    boolean_options = easy_install.boolean_options + ['uninstall']
+
+    command_consumes_arguments = False  # override base
+
+    def run(self):
+        if self.uninstall:
+            self.multi_version = True
+            self.uninstall_link()
+            self.uninstall_namespaces()
+        else:
+            self.install_for_development()
+        self.warn_deprecated_options()
+
+    def initialize_options(self):
+        self.uninstall = None
+        self.egg_path = None
+        easy_install.initialize_options(self)
+        self.setup_path = None
+        self.always_copy_from = '.'  # always copy eggs installed in curdir
+
+    def finalize_options(self):
+        ei = self.get_finalized_command("egg_info")
+        if ei.broken_egg_info:
+            template = "Please rename %r to %r before using 'develop'"
+            args = ei.egg_info, ei.broken_egg_info
+            raise DistutilsError(template % args)
+        self.args = [ei.egg_name]
+
+        easy_install.finalize_options(self)
+        self.expand_basedirs()
+        self.expand_dirs()
+        # pick up setup-dir .egg files only: no .egg-info
+        self.package_index.scan(glob.glob('*.egg'))
+
+        egg_link_fn = ei.egg_name + '.egg-link'
+        self.egg_link = os.path.join(self.install_dir, egg_link_fn)
+        self.egg_base = ei.egg_base
+        if self.egg_path is None:
+            self.egg_path = os.path.abspath(ei.egg_base)
+
+        target = pkg_resources.normalize_path(self.egg_base)
+        egg_path = pkg_resources.normalize_path(
+            os.path.join(self.install_dir, self.egg_path))
+        if egg_path != target:
+            raise DistutilsOptionError(
+                "--egg-path must be a relative path from the install"
+                " directory to " + target
+            )
+
+        # Make a distribution for the package's source
+        self.dist = pkg_resources.Distribution(
+            target,
+            pkg_resources.PathMetadata(target, os.path.abspath(ei.egg_info)),
+            project_name=ei.egg_name
+        )
+
+        self.setup_path = self._resolve_setup_path(
+            self.egg_base,
+            self.install_dir,
+            self.egg_path,
+        )
+
+    @staticmethod
+    def _resolve_setup_path(egg_base, install_dir, egg_path):
+        """
+        Generate a path from egg_base back to '.' where the
+        setup script resides and ensure that path points to the
+        setup path from $install_dir/$egg_path.
+        """
+        path_to_setup = egg_base.replace(os.sep, '/').rstrip('/')
+        if path_to_setup != os.curdir:
+            path_to_setup = '../' * (path_to_setup.count('/') + 1)
+        resolved = pkg_resources.normalize_path(
+            os.path.join(install_dir, egg_path, path_to_setup)
+        )
+        if resolved != pkg_resources.normalize_path(os.curdir):
+            raise DistutilsOptionError(
+                "Can't get a consistent path to setup script from"
+                " installation directory", resolved,
+                pkg_resources.normalize_path(os.curdir))
+        return path_to_setup
+
+    def install_for_development(self):
+        if six.PY3 and getattr(self.distribution, 'use_2to3', False):
+            # If we run 2to3 we can not do this inplace:
+
+            # Ensure metadata is up-to-date
+            self.reinitialize_command('build_py', inplace=0)
+            self.run_command('build_py')
+            bpy_cmd = self.get_finalized_command("build_py")
+            build_path = pkg_resources.normalize_path(bpy_cmd.build_lib)
+
+            # Build extensions
+            self.reinitialize_command('egg_info', egg_base=build_path)
+            self.run_command('egg_info')
+
+            self.reinitialize_command('build_ext', inplace=0)
+            self.run_command('build_ext')
+
+            # Fixup egg-link and easy-install.pth
+            ei_cmd = self.get_finalized_command("egg_info")
+            self.egg_path = build_path
+            self.dist.location = build_path
+            # XXX
+            self.dist._provider = pkg_resources.PathMetadata(
+                build_path, ei_cmd.egg_info)
+        else:
+            # Without 2to3 inplace works fine:
+            self.run_command('egg_info')
+
+            # Build extensions in-place
+            self.reinitialize_command('build_ext', inplace=1)
+            self.run_command('build_ext')
+
+        self.install_site_py()  # ensure that target dir is site-safe
+        if setuptools.bootstrap_install_from:
+            self.easy_install(setuptools.bootstrap_install_from)
+            setuptools.bootstrap_install_from = None
+
+        self.install_namespaces()
+
+        # create an .egg-link in the installation dir, pointing to our egg
+        log.info("Creating %s (link to %s)", self.egg_link, self.egg_base)
+        if not self.dry_run:
+            with open(self.egg_link, "w") as f:
+                f.write(self.egg_path + "\n" + self.setup_path)
+        # postprocess the installed distro, fixing up .pth, installing scripts,
+        # and handling requirements
+        self.process_distribution(None, self.dist, not self.no_deps)
+
+    def uninstall_link(self):
+        if os.path.exists(self.egg_link):
+            log.info("Removing %s (link to %s)", self.egg_link, self.egg_base)
+            egg_link_file = open(self.egg_link)
+            contents = [line.rstrip() for line in egg_link_file]
+            egg_link_file.close()
+            if contents not in ([self.egg_path],
+                                [self.egg_path, self.setup_path]):
+                log.warn("Link points to %s: uninstall aborted", contents)
+                return
+            if not self.dry_run:
+                os.unlink(self.egg_link)
+        if not self.dry_run:
+            self.update_pth(self.dist)  # remove any .pth link to us
+        if self.distribution.scripts:
+            # XXX should also check for entry point scripts!
+            log.warn("Note: you must uninstall or replace scripts manually!")
+
+    def install_egg_scripts(self, dist):
+        if dist is not self.dist:
+            # Installing a dependency, so fall back to normal behavior
+            return easy_install.install_egg_scripts(self, dist)
+
+        # create wrapper scripts in the script dir, pointing to dist.scripts
+
+        # new-style...
+        self.install_wrapper_scripts(dist)
+
+        # ...and old-style
+        for script_name in self.distribution.scripts or []:
+            script_path = os.path.abspath(convert_path(script_name))
+            script_name = os.path.basename(script_path)
+            with io.open(script_path) as strm:
+                script_text = strm.read()
+            self.install_script(dist, script_name, script_text, script_path)
+
+    def install_wrapper_scripts(self, dist):
+        dist = VersionlessRequirement(dist)
+        return easy_install.install_wrapper_scripts(self, dist)
+
+
+class VersionlessRequirement:
+    """
+    Adapt a pkg_resources.Distribution to simply return the project
+    name as the 'requirement' so that scripts will work across
+    multiple versions.
+
+    >>> from pkg_resources import Distribution
+    >>> dist = Distribution(project_name='foo', version='1.0')
+    >>> str(dist.as_requirement())
+    'foo==1.0'
+    >>> adapted_dist = VersionlessRequirement(dist)
+    >>> str(adapted_dist.as_requirement())
+    'foo'
+    """
+
+    def __init__(self, dist):
+        self.__dist = dist
+
+    def __getattr__(self, name):
+        return getattr(self.__dist, name)
+
+    def as_requirement(self):
+        return self.project_name
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..c45258fa03a3ddd6a73db4514365f8741d16ca86
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/dist_info.py
@@ -0,0 +1,36 @@
+"""
+Create a dist_info directory
+As defined in the wheel specification
+"""
+
+import os
+
+from distutils.core import Command
+from distutils import log
+
+
+class dist_info(Command):
+
+    description = 'create a .dist-info directory'
+
+    user_options = [
+        ('egg-base=', 'e', "directory containing .egg-info directories"
+                           " (default: top of the source tree)"),
+    ]
+
+    def initialize_options(self):
+        self.egg_base = None
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        egg_info = self.get_finalized_command('egg_info')
+        egg_info.egg_base = self.egg_base
+        egg_info.finalize_options()
+        egg_info.run()
+        dist_info_dir = egg_info.egg_info[:-len('.egg-info')] + '.dist-info'
+        log.info("creating '{}'".format(os.path.abspath(dist_info_dir)))
+
+        bdist_wheel = self.get_finalized_command('bdist_wheel')
+        bdist_wheel.egg2dist(egg_info.egg_info, dist_info_dir)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f6839cb3b78fe8d63f709b6ff9abb15bf276b6e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/easy_install.py
@@ -0,0 +1,2402 @@
+#!/usr/bin/env python
+"""
+Easy Install
+------------
+
+A tool for doing automatic download/extract/build of distutils-based Python
+packages.  For detailed documentation, see the accompanying EasyInstall.txt
+file, or visit the `EasyInstall home page`__.
+
+__ https://setuptools.readthedocs.io/en/latest/easy_install.html
+
+"""
+
+from glob import glob
+from distutils.util import get_platform
+from distutils.util import convert_path, subst_vars
+from distutils.errors import (
+    DistutilsArgError, DistutilsOptionError,
+    DistutilsError, DistutilsPlatformError,
+)
+from distutils.command.install import INSTALL_SCHEMES, SCHEME_KEYS
+from distutils import log, dir_util
+from distutils.command.build_scripts import first_line_re
+from distutils.spawn import find_executable
+import sys
+import os
+import zipimport
+import shutil
+import tempfile
+import zipfile
+import re
+import stat
+import random
+import textwrap
+import warnings
+import site
+import struct
+import contextlib
+import subprocess
+import shlex
+import io
+
+
+from sysconfig import get_config_vars, get_path
+
+from setuptools import SetuptoolsDeprecationWarning
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import configparser, map
+
+from setuptools import Command
+from setuptools.sandbox import run_setup
+from setuptools.py27compat import rmtree_safe
+from setuptools.command import setopt
+from setuptools.archive_util import unpack_archive
+from setuptools.package_index import (
+    PackageIndex, parse_requirement_arg, URL_SCHEME,
+)
+from setuptools.command import bdist_egg, egg_info
+from setuptools.wheel import Wheel
+from pkg_resources import (
+    yield_lines, normalize_path, resource_string, ensure_directory,
+    get_distribution, find_distributions, Environment, Requirement,
+    Distribution, PathMetadata, EggMetadata, WorkingSet, DistributionNotFound,
+    VersionConflict, DEVELOP_DIST,
+)
+import pkg_resources.py31compat
+
+__metaclass__ = type
+
+# Turn on PEP440Warnings
+warnings.filterwarnings("default", category=pkg_resources.PEP440Warning)
+
+__all__ = [
+    'samefile', 'easy_install', 'PthDistributions', 'extract_wininst_cfg',
+    'main', 'get_exe_prefixes',
+]
+
+
+def is_64bit():
+    return struct.calcsize("P") == 8
+
+
+def samefile(p1, p2):
+    """
+    Determine if two paths reference the same file.
+
+    Augments os.path.samefile to work on Windows and
+    suppresses errors if the path doesn't exist.
+    """
+    both_exist = os.path.exists(p1) and os.path.exists(p2)
+    use_samefile = hasattr(os.path, 'samefile') and both_exist
+    if use_samefile:
+        return os.path.samefile(p1, p2)
+    norm_p1 = os.path.normpath(os.path.normcase(p1))
+    norm_p2 = os.path.normpath(os.path.normcase(p2))
+    return norm_p1 == norm_p2
+
+
+if six.PY2:
+
+    def _to_bytes(s):
+        return s
+
+    def isascii(s):
+        try:
+            six.text_type(s, 'ascii')
+            return True
+        except UnicodeError:
+            return False
+else:
+
+    def _to_bytes(s):
+        return s.encode('utf8')
+
+    def isascii(s):
+        try:
+            s.encode('ascii')
+            return True
+        except UnicodeError:
+            return False
+
+
+_one_liner = lambda text: textwrap.dedent(text).strip().replace('\n', '; ')
+
+
+class easy_install(Command):
+    """Manage a download/build/install process"""
+    description = "Find/get/install Python packages"
+    command_consumes_arguments = True
+
+    user_options = [
+        ('prefix=', None, "installation prefix"),
+        ("zip-ok", "z", "install package as a zipfile"),
+        ("multi-version", "m", "make apps have to require() a version"),
+        ("upgrade", "U", "force upgrade (searches PyPI for latest versions)"),
+        ("install-dir=", "d", "install package to DIR"),
+        ("script-dir=", "s", "install scripts to DIR"),
+        ("exclude-scripts", "x", "Don't install scripts"),
+        ("always-copy", "a", "Copy all needed packages to install dir"),
+        ("index-url=", "i", "base URL of Python Package Index"),
+        ("find-links=", "f", "additional URL(s) to search for packages"),
+        ("build-directory=", "b",
+         "download/extract/build in DIR; keep the results"),
+        ('optimize=', 'O',
+         "also compile with optimization: -O1 for \"python -O\", "
+         "-O2 for \"python -OO\", and -O0 to disable [default: -O0]"),
+        ('record=', None,
+         "filename in which to record list of installed files"),
+        ('always-unzip', 'Z', "don't install as a zipfile, no matter what"),
+        ('site-dirs=', 'S', "list of directories where .pth files work"),
+        ('editable', 'e', "Install specified packages in editable form"),
+        ('no-deps', 'N', "don't install dependencies"),
+        ('allow-hosts=', 'H', "pattern(s) that hostnames must match"),
+        ('local-snapshots-ok', 'l',
+         "allow building eggs from local checkouts"),
+        ('version', None, "print version information and exit"),
+        ('install-layout=', None, "installation layout to choose (known values: deb)"),
+        ('force-installation-into-system-dir', '0', "force installation into /usr"),
+        ('no-find-links', None,
+         "Don't load find-links defined in packages being installed")
+    ]
+    boolean_options = [
+        'zip-ok', 'multi-version', 'exclude-scripts', 'upgrade', 'always-copy',
+        'editable',
+        'no-deps', 'local-snapshots-ok', 'version', 'force-installation-into-system-dir'
+    ]
+
+    if site.ENABLE_USER_SITE:
+        help_msg = "install in user site-package '%s'" % site.USER_SITE
+        user_options.append(('user', None, help_msg))
+        boolean_options.append('user')
+
+    negative_opt = {'always-unzip': 'zip-ok'}
+    create_index = PackageIndex
+
+    def initialize_options(self):
+        # the --user option seems to be an opt-in one,
+        # so the default should be False.
+        self.user = 0
+        self.zip_ok = self.local_snapshots_ok = None
+        self.install_dir = self.script_dir = self.exclude_scripts = None
+        self.index_url = None
+        self.find_links = None
+        self.build_directory = None
+        self.args = None
+        self.optimize = self.record = None
+        self.upgrade = self.always_copy = self.multi_version = None
+        self.editable = self.no_deps = self.allow_hosts = None
+        self.root = self.prefix = self.no_report = None
+        self.version = None
+        self.install_purelib = None  # for pure module distributions
+        self.install_platlib = None  # non-pure (dists w/ extensions)
+        self.install_headers = None  # for C/C++ headers
+        self.install_lib = None  # set to either purelib or platlib
+        self.install_scripts = None
+        self.install_data = None
+        self.install_base = None
+        self.install_platbase = None
+        if site.ENABLE_USER_SITE:
+            self.install_userbase = site.USER_BASE
+            self.install_usersite = site.USER_SITE
+        else:
+            self.install_userbase = None
+            self.install_usersite = None
+        self.no_find_links = None
+
+        # Options not specifiable via command line
+        self.package_index = None
+        self.pth_file = self.always_copy_from = None
+        self.site_dirs = None
+        self.installed_projects = {}
+        self.sitepy_installed = False
+        # enable custom installation, known values: deb
+        self.install_layout = None
+        self.force_installation_into_system_dir = None
+        self.multiarch = None
+
+        # Always read easy_install options, even if we are subclassed, or have
+        # an independent instance created.  This ensures that defaults will
+        # always come from the standard configuration file(s)' "easy_install"
+        # section, even if this is a "develop" or "install" command, or some
+        # other embedding.
+        self._dry_run = None
+        self.verbose = self.distribution.verbose
+        self.distribution._set_command_options(
+            self, self.distribution.get_option_dict('easy_install')
+        )
+
+    def delete_blockers(self, blockers):
+        extant_blockers = (
+            filename for filename in blockers
+            if os.path.exists(filename) or os.path.islink(filename)
+        )
+        list(map(self._delete_path, extant_blockers))
+
+    def _delete_path(self, path):
+        log.info("Deleting %s", path)
+        if self.dry_run:
+            return
+
+        is_tree = os.path.isdir(path) and not os.path.islink(path)
+        remover = rmtree if is_tree else os.unlink
+        remover(path)
+
+    @staticmethod
+    def _render_version():
+        """
+        Render the Setuptools version and installation details, then exit.
+        """
+        ver = '{}.{}'.format(*sys.version_info)
+        dist = get_distribution('setuptools')
+        tmpl = 'setuptools {dist.version} from {dist.location} (Python {ver})'
+        print(tmpl.format(**locals()))
+        raise SystemExit()
+
+    def finalize_options(self):
+        self.version and self._render_version()
+
+        py_version = sys.version.split()[0]
+        prefix, exec_prefix = get_config_vars('prefix', 'exec_prefix')
+
+        self.config_vars = {
+            'dist_name': self.distribution.get_name(),
+            'dist_version': self.distribution.get_version(),
+            'dist_fullname': self.distribution.get_fullname(),
+            'py_version': py_version,
+            'py_version_short': py_version[0:3],
+            'py_version_nodot': py_version[0] + py_version[2],
+            'sys_prefix': prefix,
+            'prefix': prefix,
+            'sys_exec_prefix': exec_prefix,
+            'exec_prefix': exec_prefix,
+            # Only python 3.2+ has abiflags
+            'abiflags': getattr(sys, 'abiflags', ''),
+        }
+
+        if site.ENABLE_USER_SITE:
+            self.config_vars['userbase'] = self.install_userbase
+            self.config_vars['usersite'] = self.install_usersite
+
+        self._fix_install_dir_for_user_site()
+
+        self.expand_basedirs()
+        self.expand_dirs()
+
+        if self.install_layout:
+            if not self.install_layout.lower() in ['deb']:
+                raise DistutilsOptionError("unknown value for --install-layout")
+            self.install_layout = self.install_layout.lower()
+
+            import sysconfig
+            if sys.version_info[:2] >= (3, 3):
+                self.multiarch = sysconfig.get_config_var('MULTIARCH')
+
+        self._expand(
+            'install_dir', 'script_dir', 'build_directory',
+            'site_dirs',
+        )
+        # If a non-default installation directory was specified, default the
+        # script directory to match it.
+        if self.script_dir is None:
+            self.script_dir = self.install_dir
+
+        if self.no_find_links is None:
+            self.no_find_links = False
+
+        # Let install_dir get set by install_lib command, which in turn
+        # gets its info from the install command, and takes into account
+        # --prefix and --home and all that other crud.
+        self.set_undefined_options(
+            'install_lib', ('install_dir', 'install_dir')
+        )
+        # Likewise, set default script_dir from 'install_scripts.install_dir'
+        self.set_undefined_options(
+            'install_scripts', ('install_dir', 'script_dir')
+        )
+
+        if self.user and self.install_purelib:
+            self.install_dir = self.install_purelib
+            self.script_dir = self.install_scripts
+
+        if self.prefix == '/usr' and not self.force_installation_into_system_dir:
+            raise DistutilsOptionError("""installation into /usr
+
+Trying to install into the system managed parts of the file system. Please
+consider to install to another location, or use the option
+--force-installation-into-system-dir to overwrite this warning.
+""")
+
+        # default --record from the install command
+        self.set_undefined_options('install', ('record', 'record'))
+        # Should this be moved to the if statement below? It's not used
+        # elsewhere
+        normpath = map(normalize_path, sys.path)
+        self.all_site_dirs = get_site_dirs()
+        if self.site_dirs is not None:
+            site_dirs = [
+                os.path.expanduser(s.strip()) for s in
+                self.site_dirs.split(',')
+            ]
+            for d in site_dirs:
+                if not os.path.isdir(d):
+                    log.warn("%s (in --site-dirs) does not exist", d)
+                elif normalize_path(d) not in normpath:
+                    raise DistutilsOptionError(
+                        d + " (in --site-dirs) is not on sys.path"
+                    )
+                else:
+                    self.all_site_dirs.append(normalize_path(d))
+        if not self.editable:
+            self.check_site_dir()
+        self.index_url = self.index_url or "https://pypi.org/simple/"
+        self.shadow_path = self.all_site_dirs[:]
+        for path_item in self.install_dir, normalize_path(self.script_dir):
+            if path_item not in self.shadow_path:
+                self.shadow_path.insert(0, path_item)
+
+        if self.allow_hosts is not None:
+            hosts = [s.strip() for s in self.allow_hosts.split(',')]
+        else:
+            hosts = ['*']
+        if self.package_index is None:
+            self.package_index = self.create_index(
+                self.index_url, search_path=self.shadow_path, hosts=hosts,
+            )
+        self.local_index = Environment(self.shadow_path + sys.path)
+
+        if self.find_links is not None:
+            if isinstance(self.find_links, six.string_types):
+                self.find_links = self.find_links.split()
+        else:
+            self.find_links = []
+        if self.local_snapshots_ok:
+            self.package_index.scan_egg_links(self.shadow_path + sys.path)
+        if not self.no_find_links:
+            self.package_index.add_find_links(self.find_links)
+        self.set_undefined_options('install_lib', ('optimize', 'optimize'))
+        if not isinstance(self.optimize, int):
+            try:
+                self.optimize = int(self.optimize)
+                if not (0 <= self.optimize <= 2):
+                    raise ValueError
+            except ValueError:
+                raise DistutilsOptionError("--optimize must be 0, 1, or 2")
+
+        if self.editable and not self.build_directory:
+            raise DistutilsArgError(
+                "Must specify a build directory (-b) when using --editable"
+            )
+        if not self.args:
+            raise DistutilsArgError(
+                "No urls, filenames, or requirements specified (see --help)")
+
+        self.outputs = []
+
+    def _fix_install_dir_for_user_site(self):
+        """
+        Fix the install_dir if "--user" was used.
+        """
+        if not self.user or not site.ENABLE_USER_SITE:
+            return
+
+        self.create_home_path()
+        if self.install_userbase is None:
+            msg = "User base directory is not specified"
+            raise DistutilsPlatformError(msg)
+        self.install_base = self.install_platbase = self.install_userbase
+        scheme_name = os.name.replace('posix', 'unix') + '_user'
+        self.select_scheme(scheme_name)
+
+    def _expand_attrs(self, attrs):
+        for attr in attrs:
+            val = getattr(self, attr)
+            if val is not None:
+                if os.name == 'posix' or os.name == 'nt':
+                    val = os.path.expanduser(val)
+                val = subst_vars(val, self.config_vars)
+                setattr(self, attr, val)
+
+    def expand_basedirs(self):
+        """Calls `os.path.expanduser` on install_base, install_platbase and
+        root."""
+        self._expand_attrs(['install_base', 'install_platbase', 'root'])
+
+    def expand_dirs(self):
+        """Calls `os.path.expanduser` on install dirs."""
+        dirs = [
+            'install_purelib',
+            'install_platlib',
+            'install_lib',
+            'install_headers',
+            'install_scripts',
+            'install_data',
+        ]
+        self._expand_attrs(dirs)
+
+    def run(self, show_deprecation=True):
+        if show_deprecation:
+            self.announce(
+                "WARNING: The easy_install command is deprecated "
+                "and will be removed in a future version."
+                , log.WARN,
+            )
+        if self.verbose != self.distribution.verbose:
+            log.set_verbosity(self.verbose)
+        try:
+            for spec in self.args:
+                self.easy_install(spec, not self.no_deps)
+            if self.record:
+                outputs = list(sorted(self.outputs))
+                if self.root:  # strip any package prefix
+                    root_len = len(self.root)
+                    for counter in range(len(outputs)):
+                        outputs[counter] = outputs[counter][root_len:]
+                from distutils import file_util
+
+                self.execute(
+                    file_util.write_file, (self.record, outputs),
+                    "writing list of installed files to '%s'" %
+                    self.record
+                )
+            self.warn_deprecated_options()
+        finally:
+            log.set_verbosity(self.distribution.verbose)
+
+    def pseudo_tempname(self):
+        """Return a pseudo-tempname base in the install directory.
+        This code is intentionally naive; if a malicious party can write to
+        the target directory you're already in deep doodoo.
+        """
+        try:
+            pid = os.getpid()
+        except Exception:
+            pid = random.randint(0, sys.maxsize)
+        return os.path.join(self.install_dir, "test-easy-install-%s" % pid)
+
+    def warn_deprecated_options(self):
+        pass
+
+    def check_site_dir(self):
+        """Verify that self.install_dir is .pth-capable dir, if needed"""
+
+        instdir = normalize_path(self.install_dir)
+        pth_file = os.path.join(instdir, 'easy-install.pth')
+
+        # Is it a configured, PYTHONPATH, implicit, or explicit site dir?
+        is_site_dir = instdir in self.all_site_dirs
+
+        if not is_site_dir and not self.multi_version:
+            # No?  Then directly test whether it does .pth file processing
+            is_site_dir = self.check_pth_processing()
+        else:
+            # make sure we can write to target dir
+            testfile = self.pseudo_tempname() + '.write-test'
+            test_exists = os.path.exists(testfile)
+            try:
+                if test_exists:
+                    os.unlink(testfile)
+                open(testfile, 'w').close()
+                os.unlink(testfile)
+            except (OSError, IOError):
+                self.cant_write_to_target()
+
+        if not is_site_dir and not self.multi_version:
+            # Can't install non-multi to non-site dir
+            raise DistutilsError(self.no_default_version_msg())
+
+        if is_site_dir:
+            if self.pth_file is None:
+                self.pth_file = PthDistributions(pth_file, self.all_site_dirs)
+        else:
+            self.pth_file = None
+
+        if instdir not in map(normalize_path, _pythonpath()):
+            # only PYTHONPATH dirs need a site.py, so pretend it's there
+            self.sitepy_installed = True
+        elif self.multi_version and not os.path.exists(pth_file):
+            self.sitepy_installed = True  # don't need site.py in this case
+            self.pth_file = None  # and don't create a .pth file
+        self.install_dir = instdir
+
+    __cant_write_msg = textwrap.dedent("""
+        can't create or remove files in install directory
+
+        The following error occurred while trying to add or remove files in the
+        installation directory:
+
+            %s
+
+        The installation directory you specified (via --install-dir, --prefix, or
+        the distutils default setting) was:
+
+            %s
+        """).lstrip()
+
+    __not_exists_id = textwrap.dedent("""
+        This directory does not currently exist.  Please create it and try again, or
+        choose a different installation directory (using the -d or --install-dir
+        option).
+        """).lstrip()
+
+    __access_msg = textwrap.dedent("""
+        Perhaps your account does not have write access to this directory?  If the
+        installation directory is a system-owned directory, you may need to sign in
+        as the administrator or "root" account.  If you do not have administrative
+        access to this machine, you may wish to choose a different installation
+        directory, preferably one that is listed in your PYTHONPATH environment
+        variable.
+
+        For information on other options, you may wish to consult the
+        documentation at:
+
+          https://setuptools.readthedocs.io/en/latest/easy_install.html
+
+        Please make the appropriate changes for your system and try again.
+        """).lstrip()
+
+    def cant_write_to_target(self):
+        msg = self.__cant_write_msg % (sys.exc_info()[1], self.install_dir,)
+
+        if not os.path.exists(self.install_dir):
+            msg += '\n' + self.__not_exists_id
+        else:
+            msg += '\n' + self.__access_msg
+        raise DistutilsError(msg)
+
+    def check_pth_processing(self):
+        """Empirically verify whether .pth files are supported in inst. dir"""
+        instdir = self.install_dir
+        log.info("Checking .pth file support in %s", instdir)
+        pth_file = self.pseudo_tempname() + ".pth"
+        ok_file = pth_file + '.ok'
+        ok_exists = os.path.exists(ok_file)
+        tmpl = _one_liner("""
+            import os
+            f = open({ok_file!r}, 'w')
+            f.write('OK')
+            f.close()
+            """) + '\n'
+        try:
+            if ok_exists:
+                os.unlink(ok_file)
+            dirname = os.path.dirname(ok_file)
+            pkg_resources.py31compat.makedirs(dirname, exist_ok=True)
+            f = open(pth_file, 'w')
+        except (OSError, IOError):
+            self.cant_write_to_target()
+        else:
+            try:
+                f.write(tmpl.format(**locals()))
+                f.close()
+                f = None
+                executable = sys.executable
+                if os.name == 'nt':
+                    dirname, basename = os.path.split(executable)
+                    alt = os.path.join(dirname, 'pythonw.exe')
+                    use_alt = (
+                        basename.lower() == 'python.exe' and
+                        os.path.exists(alt)
+                    )
+                    if use_alt:
+                        # use pythonw.exe to avoid opening a console window
+                        executable = alt
+
+                from distutils.spawn import spawn
+
+                spawn([executable, '-E', '-c', 'pass'], 0)
+
+                if os.path.exists(ok_file):
+                    log.info(
+                        "TEST PASSED: %s appears to support .pth files",
+                        instdir
+                    )
+                    return True
+            finally:
+                if f:
+                    f.close()
+                if os.path.exists(ok_file):
+                    os.unlink(ok_file)
+                if os.path.exists(pth_file):
+                    os.unlink(pth_file)
+        if not self.multi_version:
+            log.warn("TEST FAILED: %s does NOT support .pth files", instdir)
+        return False
+
+    def install_egg_scripts(self, dist):
+        """Write all the scripts for `dist`, unless scripts are excluded"""
+        if not self.exclude_scripts and dist.metadata_isdir('scripts'):
+            for script_name in dist.metadata_listdir('scripts'):
+                if dist.metadata_isdir('scripts/' + script_name):
+                    # The "script" is a directory, likely a Python 3
+                    # __pycache__ directory, so skip it.
+                    continue
+                self.install_script(
+                    dist, script_name,
+                    dist.get_metadata('scripts/' + script_name)
+                )
+        self.install_wrapper_scripts(dist)
+
+    def add_output(self, path):
+        if os.path.isdir(path):
+            for base, dirs, files in os.walk(path):
+                for filename in files:
+                    self.outputs.append(os.path.join(base, filename))
+        else:
+            self.outputs.append(path)
+
+    def not_editable(self, spec):
+        if self.editable:
+            raise DistutilsArgError(
+                "Invalid argument %r: you can't use filenames or URLs "
+                "with --editable (except via the --find-links option)."
+                % (spec,)
+            )
+
+    def check_editable(self, spec):
+        if not self.editable:
+            return
+
+        if os.path.exists(os.path.join(self.build_directory, spec.key)):
+            raise DistutilsArgError(
+                "%r already exists in %s; can't do a checkout there" %
+                (spec.key, self.build_directory)
+            )
+
+    @contextlib.contextmanager
+    def _tmpdir(self):
+        tmpdir = tempfile.mkdtemp(prefix=u"easy_install-")
+        try:
+            # cast to str as workaround for #709 and #710 and #712
+            yield str(tmpdir)
+        finally:
+            os.path.exists(tmpdir) and rmtree(rmtree_safe(tmpdir))
+
+    def easy_install(self, spec, deps=False):
+        if not self.editable:
+            self.install_site_py()
+
+        with self._tmpdir() as tmpdir:
+            if not isinstance(spec, Requirement):
+                if URL_SCHEME(spec):
+                    # It's a url, download it to tmpdir and process
+                    self.not_editable(spec)
+                    dl = self.package_index.download(spec, tmpdir)
+                    return self.install_item(None, dl, tmpdir, deps, True)
+
+                elif os.path.exists(spec):
+                    # Existing file or directory, just process it directly
+                    self.not_editable(spec)
+                    return self.install_item(None, spec, tmpdir, deps, True)
+                else:
+                    spec = parse_requirement_arg(spec)
+
+            self.check_editable(spec)
+            dist = self.package_index.fetch_distribution(
+                spec, tmpdir, self.upgrade, self.editable,
+                not self.always_copy, self.local_index
+            )
+            if dist is None:
+                msg = "Could not find suitable distribution for %r" % spec
+                if self.always_copy:
+                    msg += " (--always-copy skips system and development eggs)"
+                raise DistutilsError(msg)
+            elif dist.precedence == DEVELOP_DIST:
+                # .egg-info dists don't need installing, just process deps
+                self.process_distribution(spec, dist, deps, "Using")
+                return dist
+            else:
+                return self.install_item(spec, dist.location, tmpdir, deps)
+
+    def install_item(self, spec, download, tmpdir, deps, install_needed=False):
+
+        # Installation is also needed if file in tmpdir or is not an egg
+        install_needed = install_needed or self.always_copy
+        install_needed = install_needed or os.path.dirname(download) == tmpdir
+        install_needed = install_needed or not download.endswith('.egg')
+        install_needed = install_needed or (
+            self.always_copy_from is not None and
+            os.path.dirname(normalize_path(download)) ==
+            normalize_path(self.always_copy_from)
+        )
+
+        if spec and not install_needed:
+            # at this point, we know it's a local .egg, we just don't know if
+            # it's already installed.
+            for dist in self.local_index[spec.project_name]:
+                if dist.location == download:
+                    break
+            else:
+                install_needed = True  # it's not in the local index
+
+        log.info("Processing %s", os.path.basename(download))
+
+        if install_needed:
+            dists = self.install_eggs(spec, download, tmpdir)
+            for dist in dists:
+                self.process_distribution(spec, dist, deps)
+        else:
+            dists = [self.egg_distribution(download)]
+            self.process_distribution(spec, dists[0], deps, "Using")
+
+        if spec is not None:
+            for dist in dists:
+                if dist in spec:
+                    return dist
+
+    def select_scheme(self, name):
+        """Sets the install directories by applying the install schemes."""
+        # it's the caller's problem if they supply a bad name!
+        scheme = INSTALL_SCHEMES[name]
+        for key in SCHEME_KEYS:
+            attrname = 'install_' + key
+            if getattr(self, attrname) is None:
+                setattr(self, attrname, scheme[key])
+
+    def process_distribution(self, requirement, dist, deps=True, *info):
+        self.update_pth(dist)
+        self.package_index.add(dist)
+        if dist in self.local_index[dist.key]:
+            self.local_index.remove(dist)
+        self.local_index.add(dist)
+        self.install_egg_scripts(dist)
+        self.installed_projects[dist.key] = dist
+        log.info(self.installation_report(requirement, dist, *info))
+        if (dist.has_metadata('dependency_links.txt') and
+                not self.no_find_links):
+            self.package_index.add_find_links(
+                dist.get_metadata_lines('dependency_links.txt')
+            )
+        if not deps and not self.always_copy:
+            return
+        elif requirement is not None and dist.key != requirement.key:
+            log.warn("Skipping dependencies for %s", dist)
+            return  # XXX this is not the distribution we were looking for
+        elif requirement is None or dist not in requirement:
+            # if we wound up with a different version, resolve what we've got
+            distreq = dist.as_requirement()
+            requirement = Requirement(str(distreq))
+        log.info("Processing dependencies for %s", requirement)
+        try:
+            distros = WorkingSet([]).resolve(
+                [requirement], self.local_index, self.easy_install
+            )
+        except DistributionNotFound as e:
+            raise DistutilsError(str(e))
+        except VersionConflict as e:
+            raise DistutilsError(e.report())
+        if self.always_copy or self.always_copy_from:
+            # Force all the relevant distros to be copied or activated
+            for dist in distros:
+                if dist.key not in self.installed_projects:
+                    self.easy_install(dist.as_requirement())
+        log.info("Finished processing dependencies for %s", requirement)
+
+    def should_unzip(self, dist):
+        if self.zip_ok is not None:
+            return not self.zip_ok
+        if dist.has_metadata('not-zip-safe'):
+            return True
+        if not dist.has_metadata('zip-safe'):
+            return True
+        return False
+
+    def maybe_move(self, spec, dist_filename, setup_base):
+        dst = os.path.join(self.build_directory, spec.key)
+        if os.path.exists(dst):
+            msg = (
+                "%r already exists in %s; build directory %s will not be kept"
+            )
+            log.warn(msg, spec.key, self.build_directory, setup_base)
+            return setup_base
+        if os.path.isdir(dist_filename):
+            setup_base = dist_filename
+        else:
+            if os.path.dirname(dist_filename) == setup_base:
+                os.unlink(dist_filename)  # get it out of the tmp dir
+            contents = os.listdir(setup_base)
+            if len(contents) == 1:
+                dist_filename = os.path.join(setup_base, contents[0])
+                if os.path.isdir(dist_filename):
+                    # if the only thing there is a directory, move it instead
+                    setup_base = dist_filename
+        ensure_directory(dst)
+        shutil.move(setup_base, dst)
+        return dst
+
+    def install_wrapper_scripts(self, dist):
+        if self.exclude_scripts:
+            return
+        for args in ScriptWriter.best().get_args(dist):
+            self.write_script(*args)
+
+    def install_script(self, dist, script_name, script_text, dev_path=None):
+        """Generate a legacy script wrapper and install it"""
+        spec = str(dist.as_requirement())
+        is_script = is_python_script(script_text, script_name)
+
+        if is_script:
+            body = self._load_template(dev_path) % locals()
+            script_text = ScriptWriter.get_header(script_text) + body
+        self.write_script(script_name, _to_bytes(script_text), 'b')
+
+    @staticmethod
+    def _load_template(dev_path):
+        """
+        There are a couple of template scripts in the package. This
+        function loads one of them and prepares it for use.
+        """
+        # See https://github.com/pypa/setuptools/issues/134 for info
+        # on script file naming and downstream issues with SVR4
+        name = 'script.tmpl'
+        if dev_path:
+            name = name.replace('.tmpl', ' (dev).tmpl')
+
+        raw_bytes = resource_string('setuptools', name)
+        return raw_bytes.decode('utf-8')
+
+    def write_script(self, script_name, contents, mode="t", blockers=()):
+        """Write an executable file to the scripts directory"""
+        self.delete_blockers(  # clean up old .py/.pyw w/o a script
+            [os.path.join(self.script_dir, x) for x in blockers]
+        )
+        log.info("Installing %s script to %s", script_name, self.script_dir)
+        target = os.path.join(self.script_dir, script_name)
+        self.add_output(target)
+
+        if self.dry_run:
+            return
+
+        mask = current_umask()
+        ensure_directory(target)
+        if os.path.exists(target):
+            os.unlink(target)
+        with open(target, "w" + mode) as f:
+            f.write(contents)
+        chmod(target, 0o777 - mask)
+
+    def install_eggs(self, spec, dist_filename, tmpdir):
+        # .egg dirs or files are already built, so just return them
+        if dist_filename.lower().endswith('.egg'):
+            return [self.install_egg(dist_filename, tmpdir)]
+        elif dist_filename.lower().endswith('.exe'):
+            return [self.install_exe(dist_filename, tmpdir)]
+        elif dist_filename.lower().endswith('.whl'):
+            return [self.install_wheel(dist_filename, tmpdir)]
+
+        # Anything else, try to extract and build
+        setup_base = tmpdir
+        if os.path.isfile(dist_filename) and not dist_filename.endswith('.py'):
+            unpack_archive(dist_filename, tmpdir, self.unpack_progress)
+        elif os.path.isdir(dist_filename):
+            setup_base = os.path.abspath(dist_filename)
+
+        if (setup_base.startswith(tmpdir)  # something we downloaded
+                and self.build_directory and spec is not None):
+            setup_base = self.maybe_move(spec, dist_filename, setup_base)
+
+        # Find the setup.py file
+        setup_script = os.path.join(setup_base, 'setup.py')
+
+        if not os.path.exists(setup_script):
+            setups = glob(os.path.join(setup_base, '*', 'setup.py'))
+            if not setups:
+                raise DistutilsError(
+                    "Couldn't find a setup script in %s" %
+                    os.path.abspath(dist_filename)
+                )
+            if len(setups) > 1:
+                raise DistutilsError(
+                    "Multiple setup scripts in %s" %
+                    os.path.abspath(dist_filename)
+                )
+            setup_script = setups[0]
+
+        # Now run it, and return the result
+        if self.editable:
+            log.info(self.report_editable(spec, setup_script))
+            return []
+        else:
+            return self.build_and_install(setup_script, setup_base)
+
+    def egg_distribution(self, egg_path):
+        if os.path.isdir(egg_path):
+            metadata = PathMetadata(egg_path, os.path.join(egg_path,
+                                                           'EGG-INFO'))
+        else:
+            metadata = EggMetadata(zipimport.zipimporter(egg_path))
+        return Distribution.from_filename(egg_path, metadata=metadata)
+
+    def install_egg(self, egg_path, tmpdir):
+        destination = os.path.join(
+            self.install_dir,
+            os.path.basename(egg_path),
+        )
+        destination = os.path.abspath(destination)
+        if not self.dry_run:
+            ensure_directory(destination)
+
+        dist = self.egg_distribution(egg_path)
+        if not samefile(egg_path, destination):
+            if os.path.isdir(destination) and not os.path.islink(destination):
+                dir_util.remove_tree(destination, dry_run=self.dry_run)
+            elif os.path.exists(destination):
+                self.execute(
+                    os.unlink,
+                    (destination,),
+                    "Removing " + destination,
+                )
+            try:
+                new_dist_is_zipped = False
+                if os.path.isdir(egg_path):
+                    if egg_path.startswith(tmpdir):
+                        f, m = shutil.move, "Moving"
+                    else:
+                        f, m = shutil.copytree, "Copying"
+                elif self.should_unzip(dist):
+                    self.mkpath(destination)
+                    f, m = self.unpack_and_compile, "Extracting"
+                else:
+                    new_dist_is_zipped = True
+                    if egg_path.startswith(tmpdir):
+                        f, m = shutil.move, "Moving"
+                    else:
+                        f, m = shutil.copy2, "Copying"
+                self.execute(
+                    f,
+                    (egg_path, destination),
+                    (m + " %s to %s") % (
+                        os.path.basename(egg_path),
+                        os.path.dirname(destination)
+                    ),
+                )
+                update_dist_caches(
+                    destination,
+                    fix_zipimporter_caches=new_dist_is_zipped,
+                )
+            except Exception:
+                update_dist_caches(destination, fix_zipimporter_caches=False)
+                raise
+
+        self.add_output(destination)
+        return self.egg_distribution(destination)
+
+    def install_exe(self, dist_filename, tmpdir):
+        # See if it's valid, get data
+        cfg = extract_wininst_cfg(dist_filename)
+        if cfg is None:
+            raise DistutilsError(
+                "%s is not a valid distutils Windows .exe" % dist_filename
+            )
+        # Create a dummy distribution object until we build the real distro
+        dist = Distribution(
+            None,
+            project_name=cfg.get('metadata', 'name'),
+            version=cfg.get('metadata', 'version'), platform=get_platform(),
+        )
+
+        # Convert the .exe to an unpacked egg
+        egg_path = os.path.join(tmpdir, dist.egg_name() + '.egg')
+        dist.location = egg_path
+        egg_tmp = egg_path + '.tmp'
+        _egg_info = os.path.join(egg_tmp, 'EGG-INFO')
+        pkg_inf = os.path.join(_egg_info, 'PKG-INFO')
+        ensure_directory(pkg_inf)  # make sure EGG-INFO dir exists
+        dist._provider = PathMetadata(egg_tmp, _egg_info)  # XXX
+        self.exe_to_egg(dist_filename, egg_tmp)
+
+        # Write EGG-INFO/PKG-INFO
+        if not os.path.exists(pkg_inf):
+            f = open(pkg_inf, 'w')
+            f.write('Metadata-Version: 1.0\n')
+            for k, v in cfg.items('metadata'):
+                if k != 'target_version':
+                    f.write('%s: %s\n' % (k.replace('_', '-').title(), v))
+            f.close()
+        script_dir = os.path.join(_egg_info, 'scripts')
+        # delete entry-point scripts to avoid duping
+        self.delete_blockers([
+            os.path.join(script_dir, args[0])
+            for args in ScriptWriter.get_args(dist)
+        ])
+        # Build .egg file from tmpdir
+        bdist_egg.make_zipfile(
+            egg_path, egg_tmp, verbose=self.verbose, dry_run=self.dry_run,
+        )
+        # install the .egg
+        return self.install_egg(egg_path, tmpdir)
+
+    def exe_to_egg(self, dist_filename, egg_tmp):
+        """Extract a bdist_wininst to the directories an egg would use"""
+        # Check for .pth file and set up prefix translations
+        prefixes = get_exe_prefixes(dist_filename)
+        to_compile = []
+        native_libs = []
+        top_level = {}
+
+        def process(src, dst):
+            s = src.lower()
+            for old, new in prefixes:
+                if s.startswith(old):
+                    src = new + src[len(old):]
+                    parts = src.split('/')
+                    dst = os.path.join(egg_tmp, *parts)
+                    dl = dst.lower()
+                    if dl.endswith('.pyd') or dl.endswith('.dll'):
+                        parts[-1] = bdist_egg.strip_module(parts[-1])
+                        top_level[os.path.splitext(parts[0])[0]] = 1
+                        native_libs.append(src)
+                    elif dl.endswith('.py') and old != 'SCRIPTS/':
+                        top_level[os.path.splitext(parts[0])[0]] = 1
+                        to_compile.append(dst)
+                    return dst
+            if not src.endswith('.pth'):
+                log.warn("WARNING: can't process %s", src)
+            return None
+
+        # extract, tracking .pyd/.dll->native_libs and .py -> to_compile
+        unpack_archive(dist_filename, egg_tmp, process)
+        stubs = []
+        for res in native_libs:
+            if res.lower().endswith('.pyd'):  # create stubs for .pyd's
+                parts = res.split('/')
+                resource = parts[-1]
+                parts[-1] = bdist_egg.strip_module(parts[-1]) + '.py'
+                pyfile = os.path.join(egg_tmp, *parts)
+                to_compile.append(pyfile)
+                stubs.append(pyfile)
+                bdist_egg.write_stub(resource, pyfile)
+        self.byte_compile(to_compile)  # compile .py's
+        bdist_egg.write_safety_flag(
+            os.path.join(egg_tmp, 'EGG-INFO'),
+            bdist_egg.analyze_egg(egg_tmp, stubs))  # write zip-safety flag
+
+        for name in 'top_level', 'native_libs':
+            if locals()[name]:
+                txt = os.path.join(egg_tmp, 'EGG-INFO', name + '.txt')
+                if not os.path.exists(txt):
+                    f = open(txt, 'w')
+                    f.write('\n'.join(locals()[name]) + '\n')
+                    f.close()
+
+    def install_wheel(self, wheel_path, tmpdir):
+        wheel = Wheel(wheel_path)
+        assert wheel.is_compatible()
+        destination = os.path.join(self.install_dir, wheel.egg_name())
+        destination = os.path.abspath(destination)
+        if not self.dry_run:
+            ensure_directory(destination)
+        if os.path.isdir(destination) and not os.path.islink(destination):
+            dir_util.remove_tree(destination, dry_run=self.dry_run)
+        elif os.path.exists(destination):
+            self.execute(
+                os.unlink,
+                (destination,),
+                "Removing " + destination,
+            )
+        try:
+            self.execute(
+                wheel.install_as_egg,
+                (destination,),
+                ("Installing %s to %s") % (
+                    os.path.basename(wheel_path),
+                    os.path.dirname(destination)
+                ),
+            )
+        finally:
+            update_dist_caches(destination, fix_zipimporter_caches=False)
+        self.add_output(destination)
+        return self.egg_distribution(destination)
+
+    __mv_warning = textwrap.dedent("""
+        Because this distribution was installed --multi-version, before you can
+        import modules from this package in an application, you will need to
+        'import pkg_resources' and then use a 'require()' call similar to one of
+        these examples, in order to select the desired version:
+
+            pkg_resources.require("%(name)s")  # latest installed version
+            pkg_resources.require("%(name)s==%(version)s")  # this exact version
+            pkg_resources.require("%(name)s>=%(version)s")  # this version or higher
+        """).lstrip()
+
+    __id_warning = textwrap.dedent("""
+        Note also that the installation directory must be on sys.path at runtime for
+        this to work.  (e.g. by being the application's script directory, by being on
+        PYTHONPATH, or by being added to sys.path by your code.)
+        """)
+
+    def installation_report(self, req, dist, what="Installed"):
+        """Helpful installation message for display to package users"""
+        msg = "\n%(what)s %(eggloc)s%(extras)s"
+        if self.multi_version and not self.no_report:
+            msg += '\n' + self.__mv_warning
+            if self.install_dir not in map(normalize_path, sys.path):
+                msg += '\n' + self.__id_warning
+
+        eggloc = dist.location
+        name = dist.project_name
+        version = dist.version
+        extras = ''  # TODO: self.report_extras(req, dist)
+        return msg % locals()
+
+    __editable_msg = textwrap.dedent("""
+        Extracted editable version of %(spec)s to %(dirname)s
+
+        If it uses setuptools in its setup script, you can activate it in
+        "development" mode by going to that directory and running::
+
+            %(python)s setup.py develop
+
+        See the setuptools documentation for the "develop" command for more info.
+        """).lstrip()
+
+    def report_editable(self, spec, setup_script):
+        dirname = os.path.dirname(setup_script)
+        python = sys.executable
+        return '\n' + self.__editable_msg % locals()
+
+    def run_setup(self, setup_script, setup_base, args):
+        sys.modules.setdefault('distutils.command.bdist_egg', bdist_egg)
+        sys.modules.setdefault('distutils.command.egg_info', egg_info)
+
+        args = list(args)
+        if self.verbose > 2:
+            v = 'v' * (self.verbose - 1)
+            args.insert(0, '-' + v)
+        elif self.verbose < 2:
+            args.insert(0, '-q')
+        if self.dry_run:
+            args.insert(0, '-n')
+        log.info(
+            "Running %s %s", setup_script[len(setup_base) + 1:], ' '.join(args)
+        )
+        try:
+            run_setup(setup_script, args)
+        except SystemExit as v:
+            raise DistutilsError("Setup script exited with %s" % (v.args[0],))
+
+    def build_and_install(self, setup_script, setup_base):
+        args = ['bdist_egg', '--dist-dir']
+
+        dist_dir = tempfile.mkdtemp(
+            prefix='egg-dist-tmp-', dir=os.path.dirname(setup_script)
+        )
+        try:
+            self._set_fetcher_options(os.path.dirname(setup_script))
+            args.append(dist_dir)
+
+            self.run_setup(setup_script, setup_base, args)
+            all_eggs = Environment([dist_dir])
+            eggs = []
+            for key in all_eggs:
+                for dist in all_eggs[key]:
+                    eggs.append(self.install_egg(dist.location, setup_base))
+            if not eggs and not self.dry_run:
+                log.warn("No eggs found in %s (setup script problem?)",
+                         dist_dir)
+            return eggs
+        finally:
+            rmtree(dist_dir)
+            log.set_verbosity(self.verbose)  # restore our log verbosity
+
+    def _set_fetcher_options(self, base):
+        """
+        When easy_install is about to run bdist_egg on a source dist, that
+        source dist might have 'setup_requires' directives, requiring
+        additional fetching. Ensure the fetcher options given to easy_install
+        are available to that command as well.
+        """
+        # find the fetch options from easy_install and write them out
+        # to the setup.cfg file.
+        ei_opts = self.distribution.get_option_dict('easy_install').copy()
+        fetch_directives = (
+            'find_links', 'site_dirs', 'index_url', 'optimize', 'allow_hosts',
+        )
+        fetch_options = {}
+        for key, val in ei_opts.items():
+            if key not in fetch_directives:
+                continue
+            fetch_options[key.replace('_', '-')] = val[1]
+        # create a settings dictionary suitable for `edit_config`
+        settings = dict(easy_install=fetch_options)
+        cfg_filename = os.path.join(base, 'setup.cfg')
+        setopt.edit_config(cfg_filename, settings)
+
+    def update_pth(self, dist):
+        if self.pth_file is None:
+            return
+
+        for d in self.pth_file[dist.key]:  # drop old entries
+            if self.multi_version or d.location != dist.location:
+                log.info("Removing %s from easy-install.pth file", d)
+                self.pth_file.remove(d)
+                if d.location in self.shadow_path:
+                    self.shadow_path.remove(d.location)
+
+        if not self.multi_version:
+            if dist.location in self.pth_file.paths:
+                log.info(
+                    "%s is already the active version in easy-install.pth",
+                    dist,
+                )
+            else:
+                log.info("Adding %s to easy-install.pth file", dist)
+                self.pth_file.add(dist)  # add new entry
+                if dist.location not in self.shadow_path:
+                    self.shadow_path.append(dist.location)
+
+        if not self.dry_run:
+
+            self.pth_file.save()
+
+            if dist.key == 'setuptools':
+                # Ensure that setuptools itself never becomes unavailable!
+                # XXX should this check for latest version?
+                filename = os.path.join(self.install_dir, 'setuptools.pth')
+                if os.path.islink(filename):
+                    os.unlink(filename)
+                f = open(filename, 'wt')
+                f.write(self.pth_file.make_relative(dist.location) + '\n')
+                f.close()
+
+    def unpack_progress(self, src, dst):
+        # Progress filter for unpacking
+        log.debug("Unpacking %s to %s", src, dst)
+        return dst  # only unpack-and-compile skips files for dry run
+
+    def unpack_and_compile(self, egg_path, destination):
+        to_compile = []
+        to_chmod = []
+
+        def pf(src, dst):
+            if dst.endswith('.py') and not src.startswith('EGG-INFO/'):
+                to_compile.append(dst)
+            elif dst.endswith('.dll') or dst.endswith('.so'):
+                to_chmod.append(dst)
+            self.unpack_progress(src, dst)
+            return not self.dry_run and dst or None
+
+        unpack_archive(egg_path, destination, pf)
+        self.byte_compile(to_compile)
+        if not self.dry_run:
+            for f in to_chmod:
+                mode = ((os.stat(f)[stat.ST_MODE]) | 0o555) & 0o7755
+                chmod(f, mode)
+
+    def byte_compile(self, to_compile):
+        if sys.dont_write_bytecode:
+            return
+
+        from distutils.util import byte_compile
+
+        try:
+            # try to make the byte compile messages quieter
+            log.set_verbosity(self.verbose - 1)
+
+            byte_compile(to_compile, optimize=0, force=1, dry_run=self.dry_run)
+            if self.optimize:
+                byte_compile(
+                    to_compile, optimize=self.optimize, force=1,
+                    dry_run=self.dry_run,
+                )
+        finally:
+            log.set_verbosity(self.verbose)  # restore original verbosity
+
+    __no_default_msg = textwrap.dedent("""
+        bad install directory or PYTHONPATH
+
+        You are attempting to install a package to a directory that is not
+        on PYTHONPATH and which Python does not read ".pth" files from.  The
+        installation directory you specified (via --install-dir, --prefix, or
+        the distutils default setting) was:
+
+            %s
+
+        and your PYTHONPATH environment variable currently contains:
+
+            %r
+
+        Here are some of your options for correcting the problem:
+
+        * You can choose a different installation directory, i.e., one that is
+          on PYTHONPATH or supports .pth files
+
+        * You can add the installation directory to the PYTHONPATH environment
+          variable.  (It must then also be on PYTHONPATH whenever you run
+          Python and want to use the package(s) you are installing.)
+
+        * You can set up the installation directory to support ".pth" files by
+          using one of the approaches described here:
+
+          https://setuptools.readthedocs.io/en/latest/easy_install.html#custom-installation-locations
+
+
+        Please make the appropriate changes for your system and try again.""").lstrip()
+
+    def no_default_version_msg(self):
+        template = self.__no_default_msg
+        return template % (self.install_dir, os.environ.get('PYTHONPATH', ''))
+
+    def install_site_py(self):
+        """Make sure there's a site.py in the target dir, if needed"""
+
+        if self.sitepy_installed:
+            return  # already did it, or don't need to
+
+        sitepy = os.path.join(self.install_dir, "site.py")
+        source = resource_string("setuptools", "site-patch.py")
+        source = source.decode('utf-8')
+        current = ""
+
+        if os.path.exists(sitepy):
+            log.debug("Checking existing site.py in %s", self.install_dir)
+            with io.open(sitepy) as strm:
+                current = strm.read()
+
+            if not current.startswith('def __boot():'):
+                raise DistutilsError(
+                    "%s is not a setuptools-generated site.py; please"
+                    " remove it." % sitepy
+                )
+
+        if current != source:
+            log.info("Creating %s", sitepy)
+            if not self.dry_run:
+                ensure_directory(sitepy)
+                with io.open(sitepy, 'w', encoding='utf-8') as strm:
+                    strm.write(source)
+            self.byte_compile([sitepy])
+
+        self.sitepy_installed = True
+
+    def create_home_path(self):
+        """Create directories under ~."""
+        if not self.user:
+            return
+        home = convert_path(os.path.expanduser("~"))
+        for name, path in six.iteritems(self.config_vars):
+            if path.startswith(home) and not os.path.isdir(path):
+                self.debug_print("os.makedirs('%s', 0o700)" % path)
+                os.makedirs(path, 0o700)
+
+    if sys.version[:3] in ('2.3', '2.4', '2.5') or 'real_prefix' in sys.__dict__:
+        sitedir_name = 'site-packages'
+    else:
+        sitedir_name = 'dist-packages'
+
+    INSTALL_SCHEMES = dict(
+        posix=dict(
+            install_dir='$base/lib/python$py_version_short/site-packages',
+            script_dir='$base/bin',
+        ),
+        unix_local = dict(
+            install_dir = '$base/local/lib/python$py_version_short/%s' % sitedir_name,
+            script_dir  = '$base/local/bin',
+        ),
+        posix_local = dict(
+            install_dir = '$base/local/lib/python$py_version_short/%s' % sitedir_name,
+            script_dir  = '$base/local/bin',
+        ),
+        deb_system = dict(
+            install_dir = '$base/lib/python3/%s' % sitedir_name,
+            script_dir  = '$base/bin',
+        ),
+    )
+
+    DEFAULT_SCHEME = dict(
+        install_dir='$base/Lib/site-packages',
+        script_dir='$base/Scripts',
+    )
+
+    def _expand(self, *attrs):
+        config_vars = self.get_finalized_command('install').config_vars
+
+        if self.prefix or self.install_layout:
+            if self.install_layout and self.install_layout in ['deb']:
+                    scheme_name = "deb_system"
+                    self.prefix = '/usr'
+            elif self.prefix or 'real_prefix' in sys.__dict__:
+                scheme_name = os.name
+            else:
+                scheme_name = "posix_local"
+            # Set default install_dir/scripts from --prefix
+            config_vars = config_vars.copy()
+            config_vars['base'] = self.prefix
+            scheme = self.INSTALL_SCHEMES.get(scheme_name,self.DEFAULT_SCHEME)
+            for attr, val in scheme.items():
+                if getattr(self, attr, None) is None:
+                    setattr(self, attr, val)
+
+        from distutils.util import subst_vars
+
+        for attr in attrs:
+            val = getattr(self, attr)
+            if val is not None:
+                val = subst_vars(val, config_vars)
+                if os.name == 'posix':
+                    val = os.path.expanduser(val)
+                setattr(self, attr, val)
+
+
+def _pythonpath():
+    items = os.environ.get('PYTHONPATH', '').split(os.pathsep)
+    return filter(None, items)
+
+
+def get_site_dirs():
+    """
+    Return a list of 'site' dirs
+    """
+
+    sitedirs = []
+
+    # start with PYTHONPATH
+    sitedirs.extend(_pythonpath())
+
+    prefixes = [sys.prefix]
+    if sys.exec_prefix != sys.prefix:
+        prefixes.append(sys.exec_prefix)
+    for prefix in prefixes:
+        if prefix:
+            if sys.platform in ('os2emx', 'riscos'):
+                sitedirs.append(os.path.join(prefix, "Lib", "site-packages"))
+            elif os.sep == '/':
+                sitedirs.extend([
+                    os.path.join(
+                        prefix,
+                        "local/lib",
+                        "python" + sys.version[:3],
+                        "dist-packages",
+                    ),
+                    os.path.join(
+                        prefix,
+                        "lib",
+                        "python{}.{}".format(*sys.version_info),
+                        "dist-packages",
+                    ),
+                    os.path.join(prefix, "lib", "site-python"),
+                ])
+            else:
+                sitedirs.extend([
+                    prefix,
+                    os.path.join(prefix, "lib", "site-packages"),
+                ])
+            if sys.platform == 'darwin':
+                # for framework builds *only* we add the standard Apple
+                # locations. Currently only per-user, but /Library and
+                # /Network/Library could be added too
+                if 'Python.framework' in prefix:
+                    home = os.environ.get('HOME')
+                    if home:
+                        home_sp = os.path.join(
+                            home,
+                            'Library',
+                            'Python',
+                            '{}.{}'.format(*sys.version_info),
+                            'site-packages',
+                        )
+                        sitedirs.append(home_sp)
+    lib_paths = get_path('purelib'), get_path('platlib')
+    for site_lib in lib_paths:
+        if site_lib not in sitedirs:
+            sitedirs.append(site_lib)
+
+    if site.ENABLE_USER_SITE:
+        sitedirs.append(site.USER_SITE)
+
+    try:
+        sitedirs.extend(site.getsitepackages())
+    except AttributeError:
+        pass
+
+    sitedirs = list(map(normalize_path, sitedirs))
+
+    return sitedirs
+
+
+def expand_paths(inputs):
+    """Yield sys.path directories that might contain "old-style" packages"""
+
+    seen = {}
+
+    for dirname in inputs:
+        dirname = normalize_path(dirname)
+        if dirname in seen:
+            continue
+
+        seen[dirname] = 1
+        if not os.path.isdir(dirname):
+            continue
+
+        files = os.listdir(dirname)
+        yield dirname, files
+
+        for name in files:
+            if not name.endswith('.pth'):
+                # We only care about the .pth files
+                continue
+            if name in ('easy-install.pth', 'setuptools.pth'):
+                # Ignore .pth files that we control
+                continue
+
+            # Read the .pth file
+            f = open(os.path.join(dirname, name))
+            lines = list(yield_lines(f))
+            f.close()
+
+            # Yield existing non-dupe, non-import directory lines from it
+            for line in lines:
+                if not line.startswith("import"):
+                    line = normalize_path(line.rstrip())
+                    if line not in seen:
+                        seen[line] = 1
+                        if not os.path.isdir(line):
+                            continue
+                        yield line, os.listdir(line)
+
+
+def extract_wininst_cfg(dist_filename):
+    """Extract configuration data from a bdist_wininst .exe
+
+    Returns a configparser.RawConfigParser, or None
+    """
+    f = open(dist_filename, 'rb')
+    try:
+        endrec = zipfile._EndRecData(f)
+        if endrec is None:
+            return None
+
+        prepended = (endrec[9] - endrec[5]) - endrec[6]
+        if prepended < 12:  # no wininst data here
+            return None
+        f.seek(prepended - 12)
+
+        tag, cfglen, bmlen = struct.unpack("<iii", f.read(12))
+        if tag not in (0x1234567A, 0x1234567B):
+            return None  # not a valid tag
+
+        f.seek(prepended - (12 + cfglen))
+        init = {'version': '', 'target_version': ''}
+        cfg = configparser.RawConfigParser(init)
+        try:
+            part = f.read(cfglen)
+            # Read up to the first null byte.
+            config = part.split(b'\0', 1)[0]
+            # Now the config is in bytes, but for RawConfigParser, it should
+            #  be text, so decode it.
+            config = config.decode(sys.getfilesystemencoding())
+            cfg.readfp(six.StringIO(config))
+        except configparser.Error:
+            return None
+        if not cfg.has_section('metadata') or not cfg.has_section('Setup'):
+            return None
+        return cfg
+
+    finally:
+        f.close()
+
+
+def get_exe_prefixes(exe_filename):
+    """Get exe->egg path translations for a given .exe file"""
+
+    prefixes = [
+        ('PURELIB/', ''),
+        ('PLATLIB/pywin32_system32', ''),
+        ('PLATLIB/', ''),
+        ('SCRIPTS/', 'EGG-INFO/scripts/'),
+        ('DATA/lib/site-packages', ''),
+    ]
+    z = zipfile.ZipFile(exe_filename)
+    try:
+        for info in z.infolist():
+            name = info.filename
+            parts = name.split('/')
+            if len(parts) == 3 and parts[2] == 'PKG-INFO':
+                if parts[1].endswith('.egg-info'):
+                    prefixes.insert(0, ('/'.join(parts[:2]), 'EGG-INFO/'))
+                    break
+            if len(parts) != 2 or not name.endswith('.pth'):
+                continue
+            if name.endswith('-nspkg.pth'):
+                continue
+            if parts[0].upper() in ('PURELIB', 'PLATLIB'):
+                contents = z.read(name)
+                if six.PY3:
+                    contents = contents.decode()
+                for pth in yield_lines(contents):
+                    pth = pth.strip().replace('\\', '/')
+                    if not pth.startswith('import'):
+                        prefixes.append((('%s/%s/' % (parts[0], pth)), ''))
+    finally:
+        z.close()
+    prefixes = [(x.lower(), y) for x, y in prefixes]
+    prefixes.sort()
+    prefixes.reverse()
+    return prefixes
+
+
+class PthDistributions(Environment):
+    """A .pth file with Distribution paths in it"""
+
+    dirty = False
+
+    def __init__(self, filename, sitedirs=()):
+        self.filename = filename
+        self.sitedirs = list(map(normalize_path, sitedirs))
+        self.basedir = normalize_path(os.path.dirname(self.filename))
+        self._load()
+        Environment.__init__(self, [], None, None)
+        for path in yield_lines(self.paths):
+            list(map(self.add, find_distributions(path, True)))
+
+    def _load(self):
+        self.paths = []
+        saw_import = False
+        seen = dict.fromkeys(self.sitedirs)
+        if os.path.isfile(self.filename):
+            f = open(self.filename, 'rt')
+            for line in f:
+                if line.startswith('import'):
+                    saw_import = True
+                    continue
+                path = line.rstrip()
+                self.paths.append(path)
+                if not path.strip() or path.strip().startswith('#'):
+                    continue
+                # skip non-existent paths, in case somebody deleted a package
+                # manually, and duplicate paths as well
+                path = self.paths[-1] = normalize_path(
+                    os.path.join(self.basedir, path)
+                )
+                if not os.path.exists(path) or path in seen:
+                    self.paths.pop()  # skip it
+                    self.dirty = True  # we cleaned up, so we're dirty now :)
+                    continue
+                seen[path] = 1
+            f.close()
+
+        if self.paths and not saw_import:
+            self.dirty = True  # ensure anything we touch has import wrappers
+        while self.paths and not self.paths[-1].strip():
+            self.paths.pop()
+
+    def save(self):
+        """Write changed .pth file back to disk"""
+        if not self.dirty:
+            return
+
+        rel_paths = list(map(self.make_relative, self.paths))
+        if rel_paths:
+            log.debug("Saving %s", self.filename)
+            lines = self._wrap_lines(rel_paths)
+            data = '\n'.join(lines) + '\n'
+
+            if os.path.islink(self.filename):
+                os.unlink(self.filename)
+            with open(self.filename, 'wt') as f:
+                f.write(data)
+
+        elif os.path.exists(self.filename):
+            log.debug("Deleting empty %s", self.filename)
+            os.unlink(self.filename)
+
+        self.dirty = False
+
+    @staticmethod
+    def _wrap_lines(lines):
+        return lines
+
+    def add(self, dist):
+        """Add `dist` to the distribution map"""
+        new_path = (
+            dist.location not in self.paths and (
+                dist.location not in self.sitedirs or
+                # account for '.' being in PYTHONPATH
+                dist.location == os.getcwd()
+            )
+        )
+        if new_path:
+            self.paths.append(dist.location)
+            self.dirty = True
+        Environment.add(self, dist)
+
+    def remove(self, dist):
+        """Remove `dist` from the distribution map"""
+        while dist.location in self.paths:
+            self.paths.remove(dist.location)
+            self.dirty = True
+        Environment.remove(self, dist)
+
+    def make_relative(self, path):
+        npath, last = os.path.split(normalize_path(path))
+        baselen = len(self.basedir)
+        parts = [last]
+        sep = os.altsep == '/' and '/' or os.sep
+        while len(npath) >= baselen:
+            if npath == self.basedir:
+                parts.append(os.curdir)
+                parts.reverse()
+                return sep.join(parts)
+            npath, last = os.path.split(npath)
+            parts.append(last)
+        else:
+            return path
+
+
+class RewritePthDistributions(PthDistributions):
+    @classmethod
+    def _wrap_lines(cls, lines):
+        yield cls.prelude
+        for line in lines:
+            yield line
+        yield cls.postlude
+
+    prelude = _one_liner("""
+        import sys
+        sys.__plen = len(sys.path)
+        """)
+    postlude = _one_liner("""
+        import sys
+        new = sys.path[sys.__plen:]
+        del sys.path[sys.__plen:]
+        p = getattr(sys, '__egginsert', 0)
+        sys.path[p:p] = new
+        sys.__egginsert = p + len(new)
+        """)
+
+
+if os.environ.get('SETUPTOOLS_SYS_PATH_TECHNIQUE', 'raw') == 'rewrite':
+    PthDistributions = RewritePthDistributions
+
+
+def _first_line_re():
+    """
+    Return a regular expression based on first_line_re suitable for matching
+    strings.
+    """
+    if isinstance(first_line_re.pattern, str):
+        return first_line_re
+
+    # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern.
+    return re.compile(first_line_re.pattern.decode())
+
+
+def auto_chmod(func, arg, exc):
+    if func in [os.unlink, os.remove] and os.name == 'nt':
+        chmod(arg, stat.S_IWRITE)
+        return func(arg)
+    et, ev, _ = sys.exc_info()
+    six.reraise(et, (ev[0], ev[1] + (" %s %s" % (func, arg))))
+
+
+def update_dist_caches(dist_path, fix_zipimporter_caches):
+    """
+    Fix any globally cached `dist_path` related data
+
+    `dist_path` should be a path of a newly installed egg distribution (zipped
+    or unzipped).
+
+    sys.path_importer_cache contains finder objects that have been cached when
+    importing data from the original distribution. Any such finders need to be
+    cleared since the replacement distribution might be packaged differently,
+    e.g. a zipped egg distribution might get replaced with an unzipped egg
+    folder or vice versa. Having the old finders cached may then cause Python
+    to attempt loading modules from the replacement distribution using an
+    incorrect loader.
+
+    zipimport.zipimporter objects are Python loaders charged with importing
+    data packaged inside zip archives. If stale loaders referencing the
+    original distribution, are left behind, they can fail to load modules from
+    the replacement distribution. E.g. if an old zipimport.zipimporter instance
+    is used to load data from a new zipped egg archive, it may cause the
+    operation to attempt to locate the requested data in the wrong location -
+    one indicated by the original distribution's zip archive directory
+    information. Such an operation may then fail outright, e.g. report having
+    read a 'bad local file header', or even worse, it may fail silently &
+    return invalid data.
+
+    zipimport._zip_directory_cache contains cached zip archive directory
+    information for all existing zipimport.zipimporter instances and all such
+    instances connected to the same archive share the same cached directory
+    information.
+
+    If asked, and the underlying Python implementation allows it, we can fix
+    all existing zipimport.zipimporter instances instead of having to track
+    them down and remove them one by one, by updating their shared cached zip
+    archive directory information. This, of course, assumes that the
+    replacement distribution is packaged as a zipped egg.
+
+    If not asked to fix existing zipimport.zipimporter instances, we still do
+    our best to clear any remaining zipimport.zipimporter related cached data
+    that might somehow later get used when attempting to load data from the new
+    distribution and thus cause such load operations to fail. Note that when
+    tracking down such remaining stale data, we can not catch every conceivable
+    usage from here, and we clear only those that we know of and have found to
+    cause problems if left alive. Any remaining caches should be updated by
+    whomever is in charge of maintaining them, i.e. they should be ready to
+    handle us replacing their zip archives with new distributions at runtime.
+
+    """
+    # There are several other known sources of stale zipimport.zipimporter
+    # instances that we do not clear here, but might if ever given a reason to
+    # do so:
+    # * Global setuptools pkg_resources.working_set (a.k.a. 'master working
+    # set') may contain distributions which may in turn contain their
+    #   zipimport.zipimporter loaders.
+    # * Several zipimport.zipimporter loaders held by local variables further
+    #   up the function call stack when running the setuptools installation.
+    # * Already loaded modules may have their __loader__ attribute set to the
+    #   exact loader instance used when importing them. Python 3.4 docs state
+    #   that this information is intended mostly for introspection and so is
+    #   not expected to cause us problems.
+    normalized_path = normalize_path(dist_path)
+    _uncache(normalized_path, sys.path_importer_cache)
+    if fix_zipimporter_caches:
+        _replace_zip_directory_cache_data(normalized_path)
+    else:
+        # Here, even though we do not want to fix existing and now stale
+        # zipimporter cache information, we still want to remove it. Related to
+        # Python's zip archive directory information cache, we clear each of
+        # its stale entries in two phases:
+        #   1. Clear the entry so attempting to access zip archive information
+        #      via any existing stale zipimport.zipimporter instances fails.
+        #   2. Remove the entry from the cache so any newly constructed
+        #      zipimport.zipimporter instances do not end up using old stale
+        #      zip archive directory information.
+        # This whole stale data removal step does not seem strictly necessary,
+        # but has been left in because it was done before we started replacing
+        # the zip archive directory information cache content if possible, and
+        # there are no relevant unit tests that we can depend on to tell us if
+        # this is really needed.
+        _remove_and_clear_zip_directory_cache_data(normalized_path)
+
+
+def _collect_zipimporter_cache_entries(normalized_path, cache):
+    """
+    Return zipimporter cache entry keys related to a given normalized path.
+
+    Alternative path spellings (e.g. those using different character case or
+    those using alternative path separators) related to the same path are
+    included. Any sub-path entries are included as well, i.e. those
+    corresponding to zip archives embedded in other zip archives.
+
+    """
+    result = []
+    prefix_len = len(normalized_path)
+    for p in cache:
+        np = normalize_path(p)
+        if (np.startswith(normalized_path) and
+                np[prefix_len:prefix_len + 1] in (os.sep, '')):
+            result.append(p)
+    return result
+
+
+def _update_zipimporter_cache(normalized_path, cache, updater=None):
+    """
+    Update zipimporter cache data for a given normalized path.
+
+    Any sub-path entries are processed as well, i.e. those corresponding to zip
+    archives embedded in other zip archives.
+
+    Given updater is a callable taking a cache entry key and the original entry
+    (after already removing the entry from the cache), and expected to update
+    the entry and possibly return a new one to be inserted in its place.
+    Returning None indicates that the entry should not be replaced with a new
+    one. If no updater is given, the cache entries are simply removed without
+    any additional processing, the same as if the updater simply returned None.
+
+    """
+    for p in _collect_zipimporter_cache_entries(normalized_path, cache):
+        # N.B. pypy's custom zipimport._zip_directory_cache implementation does
+        # not support the complete dict interface:
+        # * Does not support item assignment, thus not allowing this function
+        #    to be used only for removing existing cache entries.
+        #  * Does not support the dict.pop() method, forcing us to use the
+        #    get/del patterns instead. For more detailed information see the
+        #    following links:
+        #      https://github.com/pypa/setuptools/issues/202#issuecomment-202913420
+        #      http://bit.ly/2h9itJX
+        old_entry = cache[p]
+        del cache[p]
+        new_entry = updater and updater(p, old_entry)
+        if new_entry is not None:
+            cache[p] = new_entry
+
+
+def _uncache(normalized_path, cache):
+    _update_zipimporter_cache(normalized_path, cache)
+
+
+def _remove_and_clear_zip_directory_cache_data(normalized_path):
+    def clear_and_remove_cached_zip_archive_directory_data(path, old_entry):
+        old_entry.clear()
+
+    _update_zipimporter_cache(
+        normalized_path, zipimport._zip_directory_cache,
+        updater=clear_and_remove_cached_zip_archive_directory_data)
+
+
+# PyPy Python implementation does not allow directly writing to the
+# zipimport._zip_directory_cache and so prevents us from attempting to correct
+# its content. The best we can do there is clear the problematic cache content
+# and have PyPy repopulate it as needed. The downside is that if there are any
+# stale zipimport.zipimporter instances laying around, attempting to use them
+# will fail due to not having its zip archive directory information available
+# instead of being automatically corrected to use the new correct zip archive
+# directory information.
+if '__pypy__' in sys.builtin_module_names:
+    _replace_zip_directory_cache_data = \
+        _remove_and_clear_zip_directory_cache_data
+else:
+
+    def _replace_zip_directory_cache_data(normalized_path):
+        def replace_cached_zip_archive_directory_data(path, old_entry):
+            # N.B. In theory, we could load the zip directory information just
+            # once for all updated path spellings, and then copy it locally and
+            # update its contained path strings to contain the correct
+            # spelling, but that seems like a way too invasive move (this cache
+            # structure is not officially documented anywhere and could in
+            # theory change with new Python releases) for no significant
+            # benefit.
+            old_entry.clear()
+            zipimport.zipimporter(path)
+            old_entry.update(zipimport._zip_directory_cache[path])
+            return old_entry
+
+        _update_zipimporter_cache(
+            normalized_path, zipimport._zip_directory_cache,
+            updater=replace_cached_zip_archive_directory_data)
+
+
+def is_python(text, filename='<string>'):
+    "Is this string a valid Python script?"
+    try:
+        compile(text, filename, 'exec')
+    except (SyntaxError, TypeError):
+        return False
+    else:
+        return True
+
+
+def is_sh(executable):
+    """Determine if the specified executable is a .sh (contains a #! line)"""
+    try:
+        with io.open(executable, encoding='latin-1') as fp:
+            magic = fp.read(2)
+    except (OSError, IOError):
+        return executable
+    return magic == '#!'
+
+
+def nt_quote_arg(arg):
+    """Quote a command line argument according to Windows parsing rules"""
+    return subprocess.list2cmdline([arg])
+
+
+def is_python_script(script_text, filename):
+    """Is this text, as a whole, a Python script? (as opposed to shell/bat/etc.
+    """
+    if filename.endswith('.py') or filename.endswith('.pyw'):
+        return True  # extension says it's Python
+    if is_python(script_text, filename):
+        return True  # it's syntactically valid Python
+    if script_text.startswith('#!'):
+        # It begins with a '#!' line, so check if 'python' is in it somewhere
+        return 'python' in script_text.splitlines()[0].lower()
+
+    return False  # Not any Python I can recognize
+
+
+try:
+    from os import chmod as _chmod
+except ImportError:
+    # Jython compatibility
+    def _chmod(*args):
+        pass
+
+
+def chmod(path, mode):
+    log.debug("changing mode of %s to %o", path, mode)
+    try:
+        _chmod(path, mode)
+    except os.error as e:
+        log.debug("chmod failed: %s", e)
+
+
+class CommandSpec(list):
+    """
+    A command spec for a #! header, specified as a list of arguments akin to
+    those passed to Popen.
+    """
+
+    options = []
+    split_args = dict()
+
+    @classmethod
+    def best(cls):
+        """
+        Choose the best CommandSpec class based on environmental conditions.
+        """
+        return cls
+
+    @classmethod
+    def _sys_executable(cls):
+        _default = os.path.normpath(sys.executable)
+        return os.environ.get('__PYVENV_LAUNCHER__', _default)
+
+    @classmethod
+    def from_param(cls, param):
+        """
+        Construct a CommandSpec from a parameter to build_scripts, which may
+        be None.
+        """
+        if isinstance(param, cls):
+            return param
+        if isinstance(param, list):
+            return cls(param)
+        if param is None:
+            return cls.from_environment()
+        # otherwise, assume it's a string.
+        return cls.from_string(param)
+
+    @classmethod
+    def from_environment(cls):
+        return cls([cls._sys_executable()])
+
+    @classmethod
+    def from_string(cls, string):
+        """
+        Construct a command spec from a simple string representing a command
+        line parseable by shlex.split.
+        """
+        items = shlex.split(string, **cls.split_args)
+        return cls(items)
+
+    def install_options(self, script_text):
+        self.options = shlex.split(self._extract_options(script_text))
+        cmdline = subprocess.list2cmdline(self)
+        if not isascii(cmdline):
+            self.options[:0] = ['-x']
+
+    @staticmethod
+    def _extract_options(orig_script):
+        """
+        Extract any options from the first line of the script.
+        """
+        first = (orig_script + '\n').splitlines()[0]
+        match = _first_line_re().match(first)
+        options = match.group(1) or '' if match else ''
+        return options.strip()
+
+    def as_header(self):
+        return self._render(self + list(self.options))
+
+    @staticmethod
+    def _strip_quotes(item):
+        _QUOTES = '"\''
+        for q in _QUOTES:
+            if item.startswith(q) and item.endswith(q):
+                return item[1:-1]
+        return item
+
+    @staticmethod
+    def _render(items):
+        cmdline = subprocess.list2cmdline(
+            CommandSpec._strip_quotes(item.strip()) for item in items)
+        return '#!' + cmdline + '\n'
+
+
+# For pbr compat; will be removed in a future version.
+sys_executable = CommandSpec._sys_executable()
+
+
+class WindowsCommandSpec(CommandSpec):
+    split_args = dict(posix=False)
+
+
+class ScriptWriter:
+    """
+    Encapsulates behavior around writing entry point scripts for console and
+    gui apps.
+    """
+
+    template = textwrap.dedent(r"""
+        # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r
+        __requires__ = %(spec)r
+        import re
+        import sys
+        from pkg_resources import load_entry_point
+
+        if __name__ == '__main__':
+            sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
+            sys.exit(
+                load_entry_point(%(spec)r, %(group)r, %(name)r)()
+            )
+    """).lstrip()
+
+    command_spec_class = CommandSpec
+
+    @classmethod
+    def get_script_args(cls, dist, executable=None, wininst=False):
+        # for backward compatibility
+        warnings.warn("Use get_args", EasyInstallDeprecationWarning)
+        writer = (WindowsScriptWriter if wininst else ScriptWriter).best()
+        header = cls.get_script_header("", executable, wininst)
+        return writer.get_args(dist, header)
+
+    @classmethod
+    def get_script_header(cls, script_text, executable=None, wininst=False):
+        # for backward compatibility
+        warnings.warn("Use get_header", EasyInstallDeprecationWarning, stacklevel=2)
+        if wininst:
+            executable = "python.exe"
+        return cls.get_header(script_text, executable)
+
+    @classmethod
+    def get_args(cls, dist, header=None):
+        """
+        Yield write_script() argument tuples for a distribution's
+        console_scripts and gui_scripts entry points.
+        """
+        if header is None:
+            header = cls.get_header()
+        spec = str(dist.as_requirement())
+        for type_ in 'console', 'gui':
+            group = type_ + '_scripts'
+            for name, ep in dist.get_entry_map(group).items():
+                cls._ensure_safe_name(name)
+                script_text = cls.template % locals()
+                args = cls._get_script_args(type_, name, header, script_text)
+                for res in args:
+                    yield res
+
+    @staticmethod
+    def _ensure_safe_name(name):
+        """
+        Prevent paths in *_scripts entry point names.
+        """
+        has_path_sep = re.search(r'[\\/]', name)
+        if has_path_sep:
+            raise ValueError("Path separators not allowed in script names")
+
+    @classmethod
+    def get_writer(cls, force_windows):
+        # for backward compatibility
+        warnings.warn("Use best", EasyInstallDeprecationWarning)
+        return WindowsScriptWriter.best() if force_windows else cls.best()
+
+    @classmethod
+    def best(cls):
+        """
+        Select the best ScriptWriter for this environment.
+        """
+        if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'):
+            return WindowsScriptWriter.best()
+        else:
+            return cls
+
+    @classmethod
+    def _get_script_args(cls, type_, name, header, script_text):
+        # Simply write the stub with no extension.
+        yield (name, header + script_text)
+
+    @classmethod
+    def get_header(cls, script_text="", executable=None):
+        """Create a #! line, getting options (if any) from script_text"""
+        cmd = cls.command_spec_class.best().from_param(executable)
+        cmd.install_options(script_text)
+        return cmd.as_header()
+
+
+class WindowsScriptWriter(ScriptWriter):
+    command_spec_class = WindowsCommandSpec
+
+    @classmethod
+    def get_writer(cls):
+        # for backward compatibility
+        warnings.warn("Use best", EasyInstallDeprecationWarning)
+        return cls.best()
+
+    @classmethod
+    def best(cls):
+        """
+        Select the best ScriptWriter suitable for Windows
+        """
+        writer_lookup = dict(
+            executable=WindowsExecutableLauncherWriter,
+            natural=cls,
+        )
+        # for compatibility, use the executable launcher by default
+        launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable')
+        return writer_lookup[launcher]
+
+    @classmethod
+    def _get_script_args(cls, type_, name, header, script_text):
+        "For Windows, add a .py extension"
+        ext = dict(console='.pya', gui='.pyw')[type_]
+        if ext not in os.environ['PATHEXT'].lower().split(';'):
+            msg = (
+                "{ext} not listed in PATHEXT; scripts will not be "
+                "recognized as executables."
+            ).format(**locals())
+            warnings.warn(msg, UserWarning)
+        old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe']
+        old.remove(ext)
+        header = cls._adjust_header(type_, header)
+        blockers = [name + x for x in old]
+        yield name + ext, header + script_text, 't', blockers
+
+    @classmethod
+    def _adjust_header(cls, type_, orig_header):
+        """
+        Make sure 'pythonw' is used for gui and and 'python' is used for
+        console (regardless of what sys.executable is).
+        """
+        pattern = 'pythonw.exe'
+        repl = 'python.exe'
+        if type_ == 'gui':
+            pattern, repl = repl, pattern
+        pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE)
+        new_header = pattern_ob.sub(string=orig_header, repl=repl)
+        return new_header if cls._use_header(new_header) else orig_header
+
+    @staticmethod
+    def _use_header(new_header):
+        """
+        Should _adjust_header use the replaced header?
+
+        On non-windows systems, always use. On
+        Windows systems, only use the replaced header if it resolves
+        to an executable on the system.
+        """
+        clean_header = new_header[2:-1].strip('"')
+        return sys.platform != 'win32' or find_executable(clean_header)
+
+
+class WindowsExecutableLauncherWriter(WindowsScriptWriter):
+    @classmethod
+    def _get_script_args(cls, type_, name, header, script_text):
+        """
+        For Windows, add a .py extension and an .exe launcher
+        """
+        if type_ == 'gui':
+            launcher_type = 'gui'
+            ext = '-script.pyw'
+            old = ['.pyw']
+        else:
+            launcher_type = 'cli'
+            ext = '-script.py'
+            old = ['.py', '.pyc', '.pyo']
+        hdr = cls._adjust_header(type_, header)
+        blockers = [name + x for x in old]
+        yield (name + ext, hdr + script_text, 't', blockers)
+        yield (
+            name + '.exe', get_win_launcher(launcher_type),
+            'b'  # write in binary mode
+        )
+        if not is_64bit():
+            # install a manifest for the launcher to prevent Windows
+            # from detecting it as an installer (which it will for
+            #  launchers like easy_install.exe). Consider only
+            #  adding a manifest for launchers detected as installers.
+            #  See Distribute #143 for details.
+            m_name = name + '.exe.manifest'
+            yield (m_name, load_launcher_manifest(name), 't')
+
+
+# for backward-compatibility
+get_script_args = ScriptWriter.get_script_args
+get_script_header = ScriptWriter.get_script_header
+
+
+def get_win_launcher(type):
+    """
+    Load the Windows launcher (executable) suitable for launching a script.
+
+    `type` should be either 'cli' or 'gui'
+
+    Returns the executable as a byte string.
+    """
+    launcher_fn = '%s.exe' % type
+    if is_64bit():
+        launcher_fn = launcher_fn.replace(".", "-64.")
+    else:
+        launcher_fn = launcher_fn.replace(".", "-32.")
+    return resource_string('setuptools', launcher_fn)
+
+
+def load_launcher_manifest(name):
+    manifest = pkg_resources.resource_string(__name__, 'launcher manifest.xml')
+    if six.PY2:
+        return manifest % vars()
+    else:
+        return manifest.decode('utf-8') % vars()
+
+
+def rmtree(path, ignore_errors=False, onerror=auto_chmod):
+    return shutil.rmtree(path, ignore_errors, onerror)
+
+
+def current_umask():
+    tmp = os.umask(0o022)
+    os.umask(tmp)
+    return tmp
+
+
+def bootstrap():
+    # This function is called when setuptools*.egg is run using /bin/sh
+    import setuptools
+
+    argv0 = os.path.dirname(setuptools.__path__[0])
+    sys.argv[0] = argv0
+    sys.argv.append(argv0)
+    main()
+
+
+def main(argv=None, **kw):
+    from setuptools import setup
+    from setuptools.dist import Distribution
+
+    class DistributionWithoutHelpCommands(Distribution):
+        common_usage = ""
+
+        def _show_help(self, *args, **kw):
+            with _patch_usage():
+                Distribution._show_help(self, *args, **kw)
+
+    if argv is None:
+        argv = sys.argv[1:]
+
+    with _patch_usage():
+        setup(
+            script_args=['-q', 'easy_install', '-v'] + argv,
+            script_name=sys.argv[0] or 'easy_install',
+            distclass=DistributionWithoutHelpCommands,
+            **kw
+        )
+
+
+@contextlib.contextmanager
+def _patch_usage():
+    import distutils.core
+    USAGE = textwrap.dedent("""
+        usage: %(script)s [options] requirement_or_url ...
+           or: %(script)s --help
+        """).lstrip()
+
+    def gen_usage(script_name):
+        return USAGE % dict(
+            script=os.path.basename(script_name),
+        )
+
+    saved = distutils.core.gen_usage
+    distutils.core.gen_usage = gen_usage
+    try:
+        yield
+    finally:
+        distutils.core.gen_usage = saved
+
+class EasyInstallDeprecationWarning(SetuptoolsDeprecationWarning):
+    """Class for warning about deprecations in EasyInstall in SetupTools. Not ignored by default, unlike DeprecationWarning."""
+    
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..b767ef31d3155dd0292f748f8749c405fd1d3258
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/egg_info.py
@@ -0,0 +1,717 @@
+"""setuptools.command.egg_info
+
+Create a distribution's .egg-info directory and contents"""
+
+from distutils.filelist import FileList as _FileList
+from distutils.errors import DistutilsInternalError
+from distutils.util import convert_path
+from distutils import log
+import distutils.errors
+import distutils.filelist
+import os
+import re
+import sys
+import io
+import warnings
+import time
+import collections
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import map
+
+from setuptools import Command
+from setuptools.command.sdist import sdist
+from setuptools.command.sdist import walk_revctrl
+from setuptools.command.setopt import edit_config
+from setuptools.command import bdist_egg
+from pkg_resources import (
+    parse_requirements, safe_name, parse_version,
+    safe_version, yield_lines, EntryPoint, iter_entry_points, to_filename)
+import setuptools.unicode_utils as unicode_utils
+from setuptools.glob import glob
+
+from setuptools.extern import packaging
+from setuptools import SetuptoolsDeprecationWarning
+
+def translate_pattern(glob):
+    """
+    Translate a file path glob like '*.txt' in to a regular expression.
+    This differs from fnmatch.translate which allows wildcards to match
+    directory separators. It also knows about '**/' which matches any number of
+    directories.
+    """
+    pat = ''
+
+    # This will split on '/' within [character classes]. This is deliberate.
+    chunks = glob.split(os.path.sep)
+
+    sep = re.escape(os.sep)
+    valid_char = '[^%s]' % (sep,)
+
+    for c, chunk in enumerate(chunks):
+        last_chunk = c == len(chunks) - 1
+
+        # Chunks that are a literal ** are globstars. They match anything.
+        if chunk == '**':
+            if last_chunk:
+                # Match anything if this is the last component
+                pat += '.*'
+            else:
+                # Match '(name/)*'
+                pat += '(?:%s+%s)*' % (valid_char, sep)
+            continue  # Break here as the whole path component has been handled
+
+        # Find any special characters in the remainder
+        i = 0
+        chunk_len = len(chunk)
+        while i < chunk_len:
+            char = chunk[i]
+            if char == '*':
+                # Match any number of name characters
+                pat += valid_char + '*'
+            elif char == '?':
+                # Match a name character
+                pat += valid_char
+            elif char == '[':
+                # Character class
+                inner_i = i + 1
+                # Skip initial !/] chars
+                if inner_i < chunk_len and chunk[inner_i] == '!':
+                    inner_i = inner_i + 1
+                if inner_i < chunk_len and chunk[inner_i] == ']':
+                    inner_i = inner_i + 1
+
+                # Loop till the closing ] is found
+                while inner_i < chunk_len and chunk[inner_i] != ']':
+                    inner_i = inner_i + 1
+
+                if inner_i >= chunk_len:
+                    # Got to the end of the string without finding a closing ]
+                    # Do not treat this as a matching group, but as a literal [
+                    pat += re.escape(char)
+                else:
+                    # Grab the insides of the [brackets]
+                    inner = chunk[i + 1:inner_i]
+                    char_class = ''
+
+                    # Class negation
+                    if inner[0] == '!':
+                        char_class = '^'
+                        inner = inner[1:]
+
+                    char_class += re.escape(inner)
+                    pat += '[%s]' % (char_class,)
+
+                    # Skip to the end ]
+                    i = inner_i
+            else:
+                pat += re.escape(char)
+            i += 1
+
+        # Join each chunk with the dir separator
+        if not last_chunk:
+            pat += sep
+
+    pat += r'\Z'
+    return re.compile(pat, flags=re.MULTILINE|re.DOTALL)
+
+
+class InfoCommon:
+    tag_build = None
+    tag_date = None
+
+    @property
+    def name(self):
+        return safe_name(self.distribution.get_name())
+
+    def tagged_version(self):
+        version = self.distribution.get_version()
+        # egg_info may be called more than once for a distribution,
+        # in which case the version string already contains all tags.
+        if self.vtags and version.endswith(self.vtags):
+            return safe_version(version)
+        return safe_version(version + self.vtags)
+
+    def tags(self):
+        version = ''
+        if self.tag_build:
+            version += self.tag_build
+        if self.tag_date:
+            version += time.strftime("-%Y%m%d")
+        return version
+    vtags = property(tags)
+
+
+class egg_info(InfoCommon, Command):
+    description = "create a distribution's .egg-info directory"
+
+    user_options = [
+        ('egg-base=', 'e', "directory containing .egg-info directories"
+                           " (default: top of the source tree)"),
+        ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"),
+        ('tag-build=', 'b', "Specify explicit tag to add to version number"),
+        ('no-date', 'D', "Don't include date stamp [default]"),
+    ]
+
+    boolean_options = ['tag-date']
+    negative_opt = {
+        'no-date': 'tag-date',
+    }
+
+    def initialize_options(self):
+        self.egg_base = None
+        self.egg_name = None
+        self.egg_info = None
+        self.egg_version = None
+        self.broken_egg_info = False
+
+    ####################################
+    # allow the 'tag_svn_revision' to be detected and
+    # set, supporting sdists built on older Setuptools.
+    @property
+    def tag_svn_revision(self):
+        pass
+
+    @tag_svn_revision.setter
+    def tag_svn_revision(self, value):
+        pass
+    ####################################
+
+    def save_version_info(self, filename):
+        """
+        Materialize the value of date into the
+        build tag. Install build keys in a deterministic order
+        to avoid arbitrary reordering on subsequent builds.
+        """
+        egg_info = collections.OrderedDict()
+        # follow the order these keys would have been added
+        # when PYTHONHASHSEED=0
+        egg_info['tag_build'] = self.tags()
+        egg_info['tag_date'] = 0
+        edit_config(filename, dict(egg_info=egg_info))
+
+    def finalize_options(self):
+        # Note: we need to capture the current value returned
+        # by `self.tagged_version()`, so we can later update
+        # `self.distribution.metadata.version` without
+        # repercussions.
+        self.egg_name = self.name
+        self.egg_version = self.tagged_version()
+        parsed_version = parse_version(self.egg_version)
+
+        try:
+            is_version = isinstance(parsed_version, packaging.version.Version)
+            spec = (
+                "%s==%s" if is_version else "%s===%s"
+            )
+            list(
+                parse_requirements(spec % (self.egg_name, self.egg_version))
+            )
+        except ValueError:
+            raise distutils.errors.DistutilsOptionError(
+                "Invalid distribution name or version syntax: %s-%s" %
+                (self.egg_name, self.egg_version)
+            )
+
+        if self.egg_base is None:
+            dirs = self.distribution.package_dir
+            self.egg_base = (dirs or {}).get('', os.curdir)
+
+        self.ensure_dirname('egg_base')
+        self.egg_info = to_filename(self.egg_name) + '.egg-info'
+        if self.egg_base != os.curdir:
+            self.egg_info = os.path.join(self.egg_base, self.egg_info)
+        if '-' in self.egg_name:
+            self.check_broken_egg_info()
+
+        # Set package version for the benefit of dumber commands
+        # (e.g. sdist, bdist_wininst, etc.)
+        #
+        self.distribution.metadata.version = self.egg_version
+
+        # If we bootstrapped around the lack of a PKG-INFO, as might be the
+        # case in a fresh checkout, make sure that any special tags get added
+        # to the version info
+        #
+        pd = self.distribution._patched_dist
+        if pd is not None and pd.key == self.egg_name.lower():
+            pd._version = self.egg_version
+            pd._parsed_version = parse_version(self.egg_version)
+            self.distribution._patched_dist = None
+
+    def write_or_delete_file(self, what, filename, data, force=False):
+        """Write `data` to `filename` or delete if empty
+
+        If `data` is non-empty, this routine is the same as ``write_file()``.
+        If `data` is empty but not ``None``, this is the same as calling
+        ``delete_file(filename)`.  If `data` is ``None``, then this is a no-op
+        unless `filename` exists, in which case a warning is issued about the
+        orphaned file (if `force` is false), or deleted (if `force` is true).
+        """
+        if data:
+            self.write_file(what, filename, data)
+        elif os.path.exists(filename):
+            if data is None and not force:
+                log.warn(
+                    "%s not set in setup(), but %s exists", what, filename
+                )
+                return
+            else:
+                self.delete_file(filename)
+
+    def write_file(self, what, filename, data):
+        """Write `data` to `filename` (if not a dry run) after announcing it
+
+        `what` is used in a log message to identify what is being written
+        to the file.
+        """
+        log.info("writing %s to %s", what, filename)
+        if six.PY3:
+            data = data.encode("utf-8")
+        if not self.dry_run:
+            f = open(filename, 'wb')
+            f.write(data)
+            f.close()
+
+    def delete_file(self, filename):
+        """Delete `filename` (if not a dry run) after announcing it"""
+        log.info("deleting %s", filename)
+        if not self.dry_run:
+            os.unlink(filename)
+
+    def run(self):
+        self.mkpath(self.egg_info)
+        os.utime(self.egg_info, None)
+        installer = self.distribution.fetch_build_egg
+        for ep in iter_entry_points('egg_info.writers'):
+            ep.require(installer=installer)
+            writer = ep.resolve()
+            writer(self, ep.name, os.path.join(self.egg_info, ep.name))
+
+        # Get rid of native_libs.txt if it was put there by older bdist_egg
+        nl = os.path.join(self.egg_info, "native_libs.txt")
+        if os.path.exists(nl):
+            self.delete_file(nl)
+
+        self.find_sources()
+
+    def find_sources(self):
+        """Generate SOURCES.txt manifest file"""
+        manifest_filename = os.path.join(self.egg_info, "SOURCES.txt")
+        mm = manifest_maker(self.distribution)
+        mm.manifest = manifest_filename
+        mm.run()
+        self.filelist = mm.filelist
+
+    def check_broken_egg_info(self):
+        bei = self.egg_name + '.egg-info'
+        if self.egg_base != os.curdir:
+            bei = os.path.join(self.egg_base, bei)
+        if os.path.exists(bei):
+            log.warn(
+                "-" * 78 + '\n'
+                "Note: Your current .egg-info directory has a '-' in its name;"
+                '\nthis will not work correctly with "setup.py develop".\n\n'
+                'Please rename %s to %s to correct this problem.\n' + '-' * 78,
+                bei, self.egg_info
+            )
+            self.broken_egg_info = self.egg_info
+            self.egg_info = bei  # make it work for now
+
+
+class FileList(_FileList):
+    # Implementations of the various MANIFEST.in commands
+
+    def process_template_line(self, line):
+        # Parse the line: split it up, make sure the right number of words
+        # is there, and return the relevant words.  'action' is always
+        # defined: it's the first word of the line.  Which of the other
+        # three are defined depends on the action; it'll be either
+        # patterns, (dir and patterns), or (dir_pattern).
+        (action, patterns, dir, dir_pattern) = self._parse_template_line(line)
+
+        # OK, now we know that the action is valid and we have the
+        # right number of words on the line for that action -- so we
+        # can proceed with minimal error-checking.
+        if action == 'include':
+            self.debug_print("include " + ' '.join(patterns))
+            for pattern in patterns:
+                if not self.include(pattern):
+                    log.warn("warning: no files found matching '%s'", pattern)
+
+        elif action == 'exclude':
+            self.debug_print("exclude " + ' '.join(patterns))
+            for pattern in patterns:
+                if not self.exclude(pattern):
+                    log.warn(("warning: no previously-included files "
+                              "found matching '%s'"), pattern)
+
+        elif action == 'global-include':
+            self.debug_print("global-include " + ' '.join(patterns))
+            for pattern in patterns:
+                if not self.global_include(pattern):
+                    log.warn(("warning: no files found matching '%s' "
+                              "anywhere in distribution"), pattern)
+
+        elif action == 'global-exclude':
+            self.debug_print("global-exclude " + ' '.join(patterns))
+            for pattern in patterns:
+                if not self.global_exclude(pattern):
+                    log.warn(("warning: no previously-included files matching "
+                              "'%s' found anywhere in distribution"),
+                             pattern)
+
+        elif action == 'recursive-include':
+            self.debug_print("recursive-include %s %s" %
+                             (dir, ' '.join(patterns)))
+            for pattern in patterns:
+                if not self.recursive_include(dir, pattern):
+                    log.warn(("warning: no files found matching '%s' "
+                              "under directory '%s'"),
+                             pattern, dir)
+
+        elif action == 'recursive-exclude':
+            self.debug_print("recursive-exclude %s %s" %
+                             (dir, ' '.join(patterns)))
+            for pattern in patterns:
+                if not self.recursive_exclude(dir, pattern):
+                    log.warn(("warning: no previously-included files matching "
+                              "'%s' found under directory '%s'"),
+                             pattern, dir)
+
+        elif action == 'graft':
+            self.debug_print("graft " + dir_pattern)
+            if not self.graft(dir_pattern):
+                log.warn("warning: no directories found matching '%s'",
+                         dir_pattern)
+
+        elif action == 'prune':
+            self.debug_print("prune " + dir_pattern)
+            if not self.prune(dir_pattern):
+                log.warn(("no previously-included directories found "
+                          "matching '%s'"), dir_pattern)
+
+        else:
+            raise DistutilsInternalError(
+                "this cannot happen: invalid action '%s'" % action)
+
+    def _remove_files(self, predicate):
+        """
+        Remove all files from the file list that match the predicate.
+        Return True if any matching files were removed
+        """
+        found = False
+        for i in range(len(self.files) - 1, -1, -1):
+            if predicate(self.files[i]):
+                self.debug_print(" removing " + self.files[i])
+                del self.files[i]
+                found = True
+        return found
+
+    def include(self, pattern):
+        """Include files that match 'pattern'."""
+        found = [f for f in glob(pattern) if not os.path.isdir(f)]
+        self.extend(found)
+        return bool(found)
+
+    def exclude(self, pattern):
+        """Exclude files that match 'pattern'."""
+        match = translate_pattern(pattern)
+        return self._remove_files(match.match)
+
+    def recursive_include(self, dir, pattern):
+        """
+        Include all files anywhere in 'dir/' that match the pattern.
+        """
+        full_pattern = os.path.join(dir, '**', pattern)
+        found = [f for f in glob(full_pattern, recursive=True)
+                 if not os.path.isdir(f)]
+        self.extend(found)
+        return bool(found)
+
+    def recursive_exclude(self, dir, pattern):
+        """
+        Exclude any file anywhere in 'dir/' that match the pattern.
+        """
+        match = translate_pattern(os.path.join(dir, '**', pattern))
+        return self._remove_files(match.match)
+
+    def graft(self, dir):
+        """Include all files from 'dir/'."""
+        found = [
+            item
+            for match_dir in glob(dir)
+            for item in distutils.filelist.findall(match_dir)
+        ]
+        self.extend(found)
+        return bool(found)
+
+    def prune(self, dir):
+        """Filter out files from 'dir/'."""
+        match = translate_pattern(os.path.join(dir, '**'))
+        return self._remove_files(match.match)
+
+    def global_include(self, pattern):
+        """
+        Include all files anywhere in the current directory that match the
+        pattern. This is very inefficient on large file trees.
+        """
+        if self.allfiles is None:
+            self.findall()
+        match = translate_pattern(os.path.join('**', pattern))
+        found = [f for f in self.allfiles if match.match(f)]
+        self.extend(found)
+        return bool(found)
+
+    def global_exclude(self, pattern):
+        """
+        Exclude all files anywhere that match the pattern.
+        """
+        match = translate_pattern(os.path.join('**', pattern))
+        return self._remove_files(match.match)
+
+    def append(self, item):
+        if item.endswith('\r'):  # Fix older sdists built on Windows
+            item = item[:-1]
+        path = convert_path(item)
+
+        if self._safe_path(path):
+            self.files.append(path)
+
+    def extend(self, paths):
+        self.files.extend(filter(self._safe_path, paths))
+
+    def _repair(self):
+        """
+        Replace self.files with only safe paths
+
+        Because some owners of FileList manipulate the underlying
+        ``files`` attribute directly, this method must be called to
+        repair those paths.
+        """
+        self.files = list(filter(self._safe_path, self.files))
+
+    def _safe_path(self, path):
+        enc_warn = "'%s' not %s encodable -- skipping"
+
+        # To avoid accidental trans-codings errors, first to unicode
+        u_path = unicode_utils.filesys_decode(path)
+        if u_path is None:
+            log.warn("'%s' in unexpected encoding -- skipping" % path)
+            return False
+
+        # Must ensure utf-8 encodability
+        utf8_path = unicode_utils.try_encode(u_path, "utf-8")
+        if utf8_path is None:
+            log.warn(enc_warn, path, 'utf-8')
+            return False
+
+        try:
+            # accept is either way checks out
+            if os.path.exists(u_path) or os.path.exists(utf8_path):
+                return True
+        # this will catch any encode errors decoding u_path
+        except UnicodeEncodeError:
+            log.warn(enc_warn, path, sys.getfilesystemencoding())
+
+
+class manifest_maker(sdist):
+    template = "MANIFEST.in"
+
+    def initialize_options(self):
+        self.use_defaults = 1
+        self.prune = 1
+        self.manifest_only = 1
+        self.force_manifest = 1
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        self.filelist = FileList()
+        if not os.path.exists(self.manifest):
+            self.write_manifest()  # it must exist so it'll get in the list
+        self.add_defaults()
+        if os.path.exists(self.template):
+            self.read_template()
+        self.prune_file_list()
+        self.filelist.sort()
+        self.filelist.remove_duplicates()
+        self.write_manifest()
+
+    def _manifest_normalize(self, path):
+        path = unicode_utils.filesys_decode(path)
+        return path.replace(os.sep, '/')
+
+    def write_manifest(self):
+        """
+        Write the file list in 'self.filelist' to the manifest file
+        named by 'self.manifest'.
+        """
+        self.filelist._repair()
+
+        # Now _repairs should encodability, but not unicode
+        files = [self._manifest_normalize(f) for f in self.filelist.files]
+        msg = "writing manifest file '%s'" % self.manifest
+        self.execute(write_file, (self.manifest, files), msg)
+
+    def warn(self, msg):
+        if not self._should_suppress_warning(msg):
+            sdist.warn(self, msg)
+
+    @staticmethod
+    def _should_suppress_warning(msg):
+        """
+        suppress missing-file warnings from sdist
+        """
+        return re.match(r"standard file .*not found", msg)
+
+    def add_defaults(self):
+        sdist.add_defaults(self)
+        self.check_license()
+        self.filelist.append(self.template)
+        self.filelist.append(self.manifest)
+        rcfiles = list(walk_revctrl())
+        if rcfiles:
+            self.filelist.extend(rcfiles)
+        elif os.path.exists(self.manifest):
+            self.read_manifest()
+
+        if os.path.exists("setup.py"):
+            # setup.py should be included by default, even if it's not
+            # the script called to create the sdist
+            self.filelist.append("setup.py")
+
+        ei_cmd = self.get_finalized_command('egg_info')
+        self.filelist.graft(ei_cmd.egg_info)
+
+    def prune_file_list(self):
+        build = self.get_finalized_command('build')
+        base_dir = self.distribution.get_fullname()
+        self.filelist.prune(build.build_base)
+        self.filelist.prune(base_dir)
+        sep = re.escape(os.sep)
+        self.filelist.exclude_pattern(r'(^|' + sep + r')(RCS|CVS|\.svn)' + sep,
+                                      is_regex=1)
+
+
+def write_file(filename, contents):
+    """Create a file with the specified name and write 'contents' (a
+    sequence of strings without line terminators) to it.
+    """
+    contents = "\n".join(contents)
+
+    # assuming the contents has been vetted for utf-8 encoding
+    contents = contents.encode("utf-8")
+
+    with open(filename, "wb") as f:  # always write POSIX-style manifest
+        f.write(contents)
+
+
+def write_pkg_info(cmd, basename, filename):
+    log.info("writing %s", filename)
+    if not cmd.dry_run:
+        metadata = cmd.distribution.metadata
+        metadata.version, oldver = cmd.egg_version, metadata.version
+        metadata.name, oldname = cmd.egg_name, metadata.name
+
+        try:
+            # write unescaped data to PKG-INFO, so older pkg_resources
+            # can still parse it
+            metadata.write_pkg_info(cmd.egg_info)
+        finally:
+            metadata.name, metadata.version = oldname, oldver
+
+        safe = getattr(cmd.distribution, 'zip_safe', None)
+
+        bdist_egg.write_safety_flag(cmd.egg_info, safe)
+
+
+def warn_depends_obsolete(cmd, basename, filename):
+    if os.path.exists(filename):
+        log.warn(
+            "WARNING: 'depends.txt' is not used by setuptools 0.6!\n"
+            "Use the install_requires/extras_require setup() args instead."
+        )
+
+
+def _write_requirements(stream, reqs):
+    lines = yield_lines(reqs or ())
+    append_cr = lambda line: line + '\n'
+    lines = map(append_cr, sorted(lines))
+    stream.writelines(lines)
+
+
+def write_requirements(cmd, basename, filename):
+    dist = cmd.distribution
+    data = six.StringIO()
+    _write_requirements(data, dist.install_requires)
+    extras_require = dist.extras_require or {}
+    for extra in sorted(extras_require):
+        data.write('\n[{extra}]\n'.format(**vars()))
+        _write_requirements(data, extras_require[extra])
+    cmd.write_or_delete_file("requirements", filename, data.getvalue())
+
+
+def write_setup_requirements(cmd, basename, filename):
+    data = io.StringIO()
+    _write_requirements(data, cmd.distribution.setup_requires)
+    cmd.write_or_delete_file("setup-requirements", filename, data.getvalue())
+
+
+def write_toplevel_names(cmd, basename, filename):
+    pkgs = dict.fromkeys(
+        [
+            k.split('.', 1)[0]
+            for k in cmd.distribution.iter_distribution_names()
+        ]
+    )
+    cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n')
+
+
+def overwrite_arg(cmd, basename, filename):
+    write_arg(cmd, basename, filename, True)
+
+
+def write_arg(cmd, basename, filename, force=False):
+    argname = os.path.splitext(basename)[0]
+    value = getattr(cmd.distribution, argname, None)
+    if value is not None:
+        value = '\n'.join(value) + '\n'
+    cmd.write_or_delete_file(argname, filename, value, force)
+
+
+def write_entries(cmd, basename, filename):
+    ep = cmd.distribution.entry_points
+
+    if isinstance(ep, six.string_types) or ep is None:
+        data = ep
+    elif ep is not None:
+        data = []
+        for section, contents in sorted(ep.items()):
+            if not isinstance(contents, six.string_types):
+                contents = EntryPoint.parse_group(section, contents)
+                contents = '\n'.join(sorted(map(str, contents.values())))
+            data.append('[%s]\n%s\n\n' % (section, contents))
+        data = ''.join(data)
+
+    cmd.write_or_delete_file('entry points', filename, data, True)
+
+
+def get_pkg_info_revision():
+    """
+    Get a -r### off of PKG-INFO Version in case this is an sdist of
+    a subversion revision.
+    """
+    warnings.warn("get_pkg_info_revision is deprecated.", EggInfoDeprecationWarning)
+    if os.path.exists('PKG-INFO'):
+        with io.open('PKG-INFO') as f:
+            for line in f:
+                match = re.match(r"Version:.*-r(\d+)\s*$", line)
+                if match:
+                    return int(match.group(1))
+    return 0
+
+
+class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning):
+    """Class for warning about deprecations in eggInfo in setupTools. Not ignored by default, unlike DeprecationWarning."""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install.py
new file mode 100644
index 0000000000000000000000000000000000000000..72b9a3e424707633c7e31a347170f358cfa3f87a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install.py
@@ -0,0 +1,125 @@
+from distutils.errors import DistutilsArgError
+import inspect
+import glob
+import warnings
+import platform
+import distutils.command.install as orig
+
+import setuptools
+
+# Prior to numpy 1.9, NumPy relies on the '_install' name, so provide it for
+# now. See https://github.com/pypa/setuptools/issues/199/
+_install = orig.install
+
+
+class install(orig.install):
+    """Use easy_install to install the package, w/dependencies"""
+
+    user_options = orig.install.user_options + [
+        ('old-and-unmanageable', None, "Try not to use this!"),
+        ('single-version-externally-managed', None,
+         "used by system package builders to create 'flat' eggs"),
+    ]
+    boolean_options = orig.install.boolean_options + [
+        'old-and-unmanageable', 'single-version-externally-managed',
+    ]
+    new_commands = [
+        ('install_egg_info', lambda self: True),
+        ('install_scripts', lambda self: True),
+    ]
+    _nc = dict(new_commands)
+
+    def initialize_options(self):
+        orig.install.initialize_options(self)
+        self.old_and_unmanageable = None
+        self.single_version_externally_managed = None
+
+    def finalize_options(self):
+        orig.install.finalize_options(self)
+        if self.root:
+            self.single_version_externally_managed = True
+        elif self.single_version_externally_managed:
+            if not self.root and not self.record:
+                raise DistutilsArgError(
+                    "You must specify --record or --root when building system"
+                    " packages"
+                )
+
+    def handle_extra_path(self):
+        if self.root or self.single_version_externally_managed:
+            # explicit backward-compatibility mode, allow extra_path to work
+            return orig.install.handle_extra_path(self)
+
+        # Ignore extra_path when installing an egg (or being run by another
+        # command without --root or --single-version-externally-managed
+        self.path_file = None
+        self.extra_dirs = ''
+
+    def run(self):
+        # Explicit request for old-style install?  Just do it
+        if self.old_and_unmanageable or self.single_version_externally_managed:
+            return orig.install.run(self)
+
+        if not self._called_from_setup(inspect.currentframe()):
+            # Run in backward-compatibility mode to support bdist_* commands.
+            orig.install.run(self)
+        else:
+            self.do_egg_install()
+
+    @staticmethod
+    def _called_from_setup(run_frame):
+        """
+        Attempt to detect whether run() was called from setup() or by another
+        command.  If called by setup(), the parent caller will be the
+        'run_command' method in 'distutils.dist', and *its* caller will be
+        the 'run_commands' method.  If called any other way, the
+        immediate caller *might* be 'run_command', but it won't have been
+        called by 'run_commands'. Return True in that case or if a call stack
+        is unavailable. Return False otherwise.
+        """
+        if run_frame is None:
+            msg = "Call stack not available. bdist_* commands may fail."
+            warnings.warn(msg)
+            if platform.python_implementation() == 'IronPython':
+                msg = "For best results, pass -X:Frames to enable call stack."
+                warnings.warn(msg)
+            return True
+        res = inspect.getouterframes(run_frame)[2]
+        caller, = res[:1]
+        info = inspect.getframeinfo(caller)
+        caller_module = caller.f_globals.get('__name__', '')
+        return (
+            caller_module == 'distutils.dist'
+            and info.function == 'run_commands'
+        )
+
+    def do_egg_install(self):
+
+        easy_install = self.distribution.get_command_class('easy_install')
+
+        cmd = easy_install(
+            self.distribution, args="x", root=self.root, record=self.record,
+        )
+        cmd.ensure_finalized()  # finalize before bdist_egg munges install cmd
+        cmd.always_copy_from = '.'  # make sure local-dir eggs get installed
+
+        # pick up setup-dir .egg files only: no .egg-info
+        cmd.package_index.scan(glob.glob('*.egg'))
+
+        self.run_command('bdist_egg')
+        args = [self.distribution.get_command_obj('bdist_egg').egg_output]
+
+        if setuptools.bootstrap_install_from:
+            # Bootstrap self-installation of setuptools
+            args.insert(0, setuptools.bootstrap_install_from)
+
+        cmd.args = args
+        cmd.run(show_deprecation=False)
+        setuptools.bootstrap_install_from = None
+
+
+# XXX Python 3.1 doesn't see _nc if this is inside the class
+install.sub_commands = (
+    [cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc] +
+    install.new_commands
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f405bcad743bac704e90c5489713a5cd4404497
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_egg_info.py
@@ -0,0 +1,82 @@
+from distutils import log, dir_util
+import os, sys
+
+from setuptools import Command
+from setuptools import namespaces
+from setuptools.archive_util import unpack_archive
+import pkg_resources
+
+
+class install_egg_info(namespaces.Installer, Command):
+    """Install an .egg-info directory for the package"""
+
+    description = "Install an .egg-info directory for the package"
+
+    user_options = [
+        ('install-dir=', 'd', "directory to install to"),
+    ]
+
+    def initialize_options(self):
+        self.install_dir = None
+        self.install_layout = None
+        self.prefix_option = None
+
+    def finalize_options(self):
+        self.set_undefined_options('install_lib',
+                                   ('install_dir', 'install_dir'))
+        self.set_undefined_options('install',('install_layout','install_layout'))
+        if sys.hexversion > 0x2060000:
+            self.set_undefined_options('install',('prefix_option','prefix_option'))
+        ei_cmd = self.get_finalized_command("egg_info")
+        basename = pkg_resources.Distribution(
+            None, None, ei_cmd.egg_name, ei_cmd.egg_version
+        ).egg_name() + '.egg-info'
+
+        if self.install_layout:
+            if not self.install_layout.lower() in ['deb']:
+                raise DistutilsOptionError("unknown value for --install-layout")
+            self.install_layout = self.install_layout.lower()
+            basename = basename.replace('-py%s' % pkg_resources.PY_MAJOR, '')
+        elif self.prefix_option or 'real_prefix' in sys.__dict__:
+            # don't modify for virtualenv
+            pass
+        else:
+            basename = basename.replace('-py%s' % pkg_resources.PY_MAJOR, '')
+
+        self.source = ei_cmd.egg_info
+        self.target = os.path.join(self.install_dir, basename)
+        self.outputs = []
+
+    def run(self):
+        self.run_command('egg_info')
+        if os.path.isdir(self.target) and not os.path.islink(self.target):
+            dir_util.remove_tree(self.target, dry_run=self.dry_run)
+        elif os.path.exists(self.target):
+            self.execute(os.unlink, (self.target,), "Removing " + self.target)
+        if not self.dry_run:
+            pkg_resources.ensure_directory(self.target)
+        self.execute(
+            self.copytree, (), "Copying %s to %s" % (self.source, self.target)
+        )
+        self.install_namespaces()
+
+    def get_outputs(self):
+        return self.outputs
+
+    def copytree(self):
+        # Copy the .egg-info tree to site-packages
+        def skimmer(src, dst):
+            # filter out source-control directories; note that 'src' is always
+            # a '/'-separated path, regardless of platform.  'dst' is a
+            # platform-specific path.
+            for skip in '.svn/', 'CVS/':
+                if src.startswith(skip) or '/' + skip in src:
+                    return None
+            if self.install_layout and self.install_layout in ['deb'] and src.startswith('SOURCES.txt'):
+                log.info("Skipping SOURCES.txt")
+                return None
+            self.outputs.append(dst)
+            log.debug("Copying %s to %s", src, dst)
+            return dst
+
+        unpack_archive(self.source, self.target, skimmer)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf81519d98e8221707f45c1a3901b8d836095d30
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_lib.py
@@ -0,0 +1,147 @@
+import os
+import sys
+from itertools import product, starmap
+import distutils.command.install_lib as orig
+
+
+class install_lib(orig.install_lib):
+    """Don't add compiled flags to filenames of non-Python files"""
+
+    def initialize_options(self):
+        orig.install_lib.initialize_options(self)
+        self.multiarch = None
+        self.install_layout = None
+
+    def finalize_options(self):
+        orig.install_lib.finalize_options(self)
+        self.set_undefined_options('install',('install_layout','install_layout'))
+        if self.install_layout == 'deb' and sys.version_info[:2] >= (3, 3):
+            import sysconfig
+            self.multiarch = sysconfig.get_config_var('MULTIARCH')
+
+    def run(self):
+        self.build()
+        outfiles = self.install()
+        if outfiles is not None:
+            # always compile, in case we have any extension stubs to deal with
+            self.byte_compile(outfiles)
+
+    def get_exclusions(self):
+        """
+        Return a collections.Sized collections.Container of paths to be
+        excluded for single_version_externally_managed installations.
+        """
+        all_packages = (
+            pkg
+            for ns_pkg in self._get_SVEM_NSPs()
+            for pkg in self._all_packages(ns_pkg)
+        )
+
+        excl_specs = product(all_packages, self._gen_exclusion_paths())
+        return set(starmap(self._exclude_pkg_path, excl_specs))
+
+    def _exclude_pkg_path(self, pkg, exclusion_path):
+        """
+        Given a package name and exclusion path within that package,
+        compute the full exclusion path.
+        """
+        parts = pkg.split('.') + [exclusion_path]
+        return os.path.join(self.install_dir, *parts)
+
+    @staticmethod
+    def _all_packages(pkg_name):
+        """
+        >>> list(install_lib._all_packages('foo.bar.baz'))
+        ['foo.bar.baz', 'foo.bar', 'foo']
+        """
+        while pkg_name:
+            yield pkg_name
+            pkg_name, sep, child = pkg_name.rpartition('.')
+
+    def _get_SVEM_NSPs(self):
+        """
+        Get namespace packages (list) but only for
+        single_version_externally_managed installations and empty otherwise.
+        """
+        # TODO: is it necessary to short-circuit here? i.e. what's the cost
+        # if get_finalized_command is called even when namespace_packages is
+        # False?
+        if not self.distribution.namespace_packages:
+            return []
+
+        install_cmd = self.get_finalized_command('install')
+        svem = install_cmd.single_version_externally_managed
+
+        return self.distribution.namespace_packages if svem else []
+
+    @staticmethod
+    def _gen_exclusion_paths():
+        """
+        Generate file paths to be excluded for namespace packages (bytecode
+        cache files).
+        """
+        # always exclude the package module itself
+        yield '__init__.py'
+
+        yield '__init__.pyc'
+        yield '__init__.pyo'
+
+        if not hasattr(sys, 'implementation'):
+            return
+
+        base = os.path.join('__pycache__', '__init__.' + sys.implementation.cache_tag)
+        yield base + '.pyc'
+        yield base + '.pyo'
+        yield base + '.opt-1.pyc'
+        yield base + '.opt-2.pyc'
+
+    def copy_tree(
+            self, infile, outfile,
+            preserve_mode=1, preserve_times=1, preserve_symlinks=0, level=1
+    ):
+        assert preserve_mode and preserve_times and not preserve_symlinks
+        exclude = self.get_exclusions()
+
+        if not exclude:
+            import distutils.dir_util
+            distutils.dir_util._multiarch = self.multiarch
+            return orig.install_lib.copy_tree(self, infile, outfile)
+
+        # Exclude namespace package __init__.py* files from the output
+
+        from setuptools.archive_util import unpack_directory
+        from distutils import log
+
+        outfiles = []
+
+        if self.multiarch:
+            import sysconfig
+            ext_suffix = sysconfig.get_config_var ('EXT_SUFFIX')
+            if ext_suffix.endswith(self.multiarch + ext_suffix[-3:]):
+                new_suffix = None
+            else:
+                new_suffix = "%s-%s%s" % (ext_suffix[:-3], self.multiarch, ext_suffix[-3:])
+
+        def pf(src, dst):
+            if dst in exclude:
+                log.warn("Skipping installation of %s (namespace package)",
+                         dst)
+                return False
+
+            if self.multiarch and new_suffix and dst.endswith(ext_suffix) and not dst.endswith(new_suffix):
+                dst = dst.replace(ext_suffix, new_suffix)
+                log.info("renaming extension to %s", os.path.basename(dst))
+
+            log.info("copying %s -> %s", src, os.path.dirname(dst))
+            outfiles.append(dst)
+            return dst
+
+        unpack_directory(infile, outfile, pf)
+        return outfiles
+
+    def get_outputs(self):
+        outputs = orig.install_lib.get_outputs(self)
+        exclude = self.get_exclusions()
+        if exclude:
+            return [f for f in outputs if f not in exclude]
+        return outputs
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py
new file mode 100644
index 0000000000000000000000000000000000000000..16234273a2d36b0b3d821a7a97bf8f03cf3f2948
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/install_scripts.py
@@ -0,0 +1,65 @@
+from distutils import log
+import distutils.command.install_scripts as orig
+import os
+import sys
+
+from pkg_resources import Distribution, PathMetadata, ensure_directory
+
+
+class install_scripts(orig.install_scripts):
+    """Do normal script install, plus any egg_info wrapper scripts"""
+
+    def initialize_options(self):
+        orig.install_scripts.initialize_options(self)
+        self.no_ep = False
+
+    def run(self):
+        import setuptools.command.easy_install as ei
+
+        self.run_command("egg_info")
+        if self.distribution.scripts:
+            orig.install_scripts.run(self)  # run first to set up self.outfiles
+        else:
+            self.outfiles = []
+        if self.no_ep:
+            # don't install entry point scripts into .egg file!
+            return
+
+        ei_cmd = self.get_finalized_command("egg_info")
+        dist = Distribution(
+            ei_cmd.egg_base, PathMetadata(ei_cmd.egg_base, ei_cmd.egg_info),
+            ei_cmd.egg_name, ei_cmd.egg_version,
+        )
+        bs_cmd = self.get_finalized_command('build_scripts')
+        exec_param = getattr(bs_cmd, 'executable', None)
+        bw_cmd = self.get_finalized_command("bdist_wininst")
+        is_wininst = getattr(bw_cmd, '_is_running', False)
+        writer = ei.ScriptWriter
+        if is_wininst:
+            exec_param = "python.exe"
+            writer = ei.WindowsScriptWriter
+        if exec_param == sys.executable:
+            # In case the path to the Python executable contains a space, wrap
+            # it so it's not split up.
+            exec_param = [exec_param]
+        # resolve the writer to the environment
+        writer = writer.best()
+        cmd = writer.command_spec_class.best().from_param(exec_param)
+        for args in writer.get_args(dist, cmd.as_header()):
+            self.write_script(*args)
+
+    def write_script(self, script_name, contents, mode="t", *ignored):
+        """Write an executable file to the scripts directory"""
+        from setuptools.command.easy_install import chmod, current_umask
+
+        log.info("Installing %s script to %s", script_name, self.install_dir)
+        target = os.path.join(self.install_dir, script_name)
+        self.outfiles.append(target)
+
+        mask = current_umask()
+        if not self.dry_run:
+            ensure_directory(target)
+            f = open(target, "w" + mode)
+            f.write(contents)
+            f.close()
+            chmod(target, 0o777 - mask)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml
new file mode 100644
index 0000000000000000000000000000000000000000..5972a96d8ded85cc14147ffc1400ec67c3b5a578
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/launcher manifest.xml	
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
+    <assemblyIdentity version="1.0.0.0"
+                      processorArchitecture="X86"
+                      name="%(name)s"
+                      type="win32"/>
+    <!-- Identify the application security requirements. -->
+    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
+        <security>
+            <requestedPrivileges>
+                <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
+            </requestedPrivileges>
+        </security>
+    </trustInfo>
+</assembly>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..61063e7542586c05c3af21d31cd917ebd1118272
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/py36compat.py
@@ -0,0 +1,136 @@
+import os
+from glob import glob
+from distutils.util import convert_path
+from distutils.command import sdist
+
+from setuptools.extern.six.moves import filter
+
+
+class sdist_add_defaults:
+    """
+    Mix-in providing forward-compatibility for functionality as found in
+    distutils on Python 3.7.
+
+    Do not edit the code in this class except to update functionality
+    as implemented in distutils. Instead, override in the subclass.
+    """
+
+    def add_defaults(self):
+        """Add all the default files to self.filelist:
+          - README or README.txt
+          - setup.py
+          - test/test*.py
+          - all pure Python modules mentioned in setup script
+          - all files pointed by package_data (build_py)
+          - all files defined in data_files.
+          - all files defined as scripts.
+          - all C sources listed as part of extensions or C libraries
+            in the setup script (doesn't catch C headers!)
+        Warns if (README or README.txt) or setup.py are missing; everything
+        else is optional.
+        """
+        self._add_defaults_standards()
+        self._add_defaults_optional()
+        self._add_defaults_python()
+        self._add_defaults_data_files()
+        self._add_defaults_ext()
+        self._add_defaults_c_libs()
+        self._add_defaults_scripts()
+
+    @staticmethod
+    def _cs_path_exists(fspath):
+        """
+        Case-sensitive path existence check
+
+        >>> sdist_add_defaults._cs_path_exists(__file__)
+        True
+        >>> sdist_add_defaults._cs_path_exists(__file__.upper())
+        False
+        """
+        if not os.path.exists(fspath):
+            return False
+        # make absolute so we always have a directory
+        abspath = os.path.abspath(fspath)
+        directory, filename = os.path.split(abspath)
+        return filename in os.listdir(directory)
+
+    def _add_defaults_standards(self):
+        standards = [self.READMES, self.distribution.script_name]
+        for fn in standards:
+            if isinstance(fn, tuple):
+                alts = fn
+                got_it = False
+                for fn in alts:
+                    if self._cs_path_exists(fn):
+                        got_it = True
+                        self.filelist.append(fn)
+                        break
+
+                if not got_it:
+                    self.warn("standard file not found: should have one of " +
+                              ', '.join(alts))
+            else:
+                if self._cs_path_exists(fn):
+                    self.filelist.append(fn)
+                else:
+                    self.warn("standard file '%s' not found" % fn)
+
+    def _add_defaults_optional(self):
+        optional = ['test/test*.py', 'setup.cfg']
+        for pattern in optional:
+            files = filter(os.path.isfile, glob(pattern))
+            self.filelist.extend(files)
+
+    def _add_defaults_python(self):
+        # build_py is used to get:
+        #  - python modules
+        #  - files defined in package_data
+        build_py = self.get_finalized_command('build_py')
+
+        # getting python files
+        if self.distribution.has_pure_modules():
+            self.filelist.extend(build_py.get_source_files())
+
+        # getting package_data files
+        # (computed in build_py.data_files by build_py.finalize_options)
+        for pkg, src_dir, build_dir, filenames in build_py.data_files:
+            for filename in filenames:
+                self.filelist.append(os.path.join(src_dir, filename))
+
+    def _add_defaults_data_files(self):
+        # getting distribution.data_files
+        if self.distribution.has_data_files():
+            for item in self.distribution.data_files:
+                if isinstance(item, str):
+                    # plain file
+                    item = convert_path(item)
+                    if os.path.isfile(item):
+                        self.filelist.append(item)
+                else:
+                    # a (dirname, filenames) tuple
+                    dirname, filenames = item
+                    for f in filenames:
+                        f = convert_path(f)
+                        if os.path.isfile(f):
+                            self.filelist.append(f)
+
+    def _add_defaults_ext(self):
+        if self.distribution.has_ext_modules():
+            build_ext = self.get_finalized_command('build_ext')
+            self.filelist.extend(build_ext.get_source_files())
+
+    def _add_defaults_c_libs(self):
+        if self.distribution.has_c_libraries():
+            build_clib = self.get_finalized_command('build_clib')
+            self.filelist.extend(build_clib.get_source_files())
+
+    def _add_defaults_scripts(self):
+        if self.distribution.has_scripts():
+            build_scripts = self.get_finalized_command('build_scripts')
+            self.filelist.extend(build_scripts.get_source_files())
+
+
+if hasattr(sdist.sdist, '_add_defaults_standards'):
+    # disable the functionality already available upstream
+    class sdist_add_defaults:
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/register.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/register.py
new file mode 100644
index 0000000000000000000000000000000000000000..b8266b9a60f8c363ba35f7b73befd7c9c7cb4abc
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/register.py
@@ -0,0 +1,18 @@
+from distutils import log
+import distutils.command.register as orig
+
+from setuptools.errors import RemovedCommandError
+
+
+class register(orig.register):
+    """Formerly used to register packages on PyPI."""
+
+    def run(self):
+        msg = (
+            "The register command has been removed, use twine to upload "
+            + "instead (https://pypi.org/p/twine)"
+        )
+
+        self.announce("ERROR: " + msg, log.ERROR)
+
+        raise RemovedCommandError(msg)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/rotate.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/rotate.py
new file mode 100644
index 0000000000000000000000000000000000000000..b89353f529b3d08e768dea69a9dc8b5e7403003d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/rotate.py
@@ -0,0 +1,66 @@
+from distutils.util import convert_path
+from distutils import log
+from distutils.errors import DistutilsOptionError
+import os
+import shutil
+
+from setuptools.extern import six
+
+from setuptools import Command
+
+
+class rotate(Command):
+    """Delete older distributions"""
+
+    description = "delete older distributions, keeping N newest files"
+    user_options = [
+        ('match=', 'm', "patterns to match (required)"),
+        ('dist-dir=', 'd', "directory where the distributions are"),
+        ('keep=', 'k', "number of matching distributions to keep"),
+    ]
+
+    boolean_options = []
+
+    def initialize_options(self):
+        self.match = None
+        self.dist_dir = None
+        self.keep = None
+
+    def finalize_options(self):
+        if self.match is None:
+            raise DistutilsOptionError(
+                "Must specify one or more (comma-separated) match patterns "
+                "(e.g. '.zip' or '.egg')"
+            )
+        if self.keep is None:
+            raise DistutilsOptionError("Must specify number of files to keep")
+        try:
+            self.keep = int(self.keep)
+        except ValueError:
+            raise DistutilsOptionError("--keep must be an integer")
+        if isinstance(self.match, six.string_types):
+            self.match = [
+                convert_path(p.strip()) for p in self.match.split(',')
+            ]
+        self.set_undefined_options('bdist', ('dist_dir', 'dist_dir'))
+
+    def run(self):
+        self.run_command("egg_info")
+        from glob import glob
+
+        for pattern in self.match:
+            pattern = self.distribution.get_name() + '*' + pattern
+            files = glob(os.path.join(self.dist_dir, pattern))
+            files = [(os.path.getmtime(f), f) for f in files]
+            files.sort()
+            files.reverse()
+
+            log.info("%d file(s) matching %s", len(files), pattern)
+            files = files[self.keep:]
+            for (t, f) in files:
+                log.info("Deleting %s", f)
+                if not self.dry_run:
+                    if os.path.isdir(f):
+                        shutil.rmtree(f)
+                    else:
+                        os.unlink(f)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py
new file mode 100644
index 0000000000000000000000000000000000000000..611cec552867a6d50b7edd700c86c7396d906ea2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/saveopts.py
@@ -0,0 +1,22 @@
+from setuptools.command.setopt import edit_config, option_base
+
+
+class saveopts(option_base):
+    """Save command-line options to a file"""
+
+    description = "save supplied options to setup.cfg or other config file"
+
+    def run(self):
+        dist = self.distribution
+        settings = {}
+
+        for cmd in dist.command_options:
+
+            if cmd == 'saveopts':
+                continue  # don't save our own options!
+
+            for opt, (src, val) in dist.get_option_dict(cmd).items():
+                if src == "command line":
+                    settings.setdefault(cmd, {})[opt] = val
+
+        edit_config(self.filename, settings, self.dry_run)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/sdist.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/sdist.py
new file mode 100644
index 0000000000000000000000000000000000000000..a851453f9aa9506d307e1aa7e802fdee9e943eae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/sdist.py
@@ -0,0 +1,252 @@
+from distutils import log
+import distutils.command.sdist as orig
+import os
+import sys
+import io
+import contextlib
+
+from setuptools.extern import six, ordered_set
+
+from .py36compat import sdist_add_defaults
+
+import pkg_resources
+
+_default_revctrl = list
+
+
+def walk_revctrl(dirname=''):
+    """Find all files under revision control"""
+    for ep in pkg_resources.iter_entry_points('setuptools.file_finders'):
+        for item in ep.load()(dirname):
+            yield item
+
+
+class sdist(sdist_add_defaults, orig.sdist):
+    """Smart sdist that finds anything supported by revision control"""
+
+    user_options = [
+        ('formats=', None,
+         "formats for source distribution (comma-separated list)"),
+        ('keep-temp', 'k',
+         "keep the distribution tree around after creating " +
+         "archive file(s)"),
+        ('dist-dir=', 'd',
+         "directory to put the source distribution archive(s) in "
+         "[default: dist]"),
+    ]
+
+    negative_opt = {}
+
+    README_EXTENSIONS = ['', '.rst', '.txt', '.md']
+    READMES = tuple('README{0}'.format(ext) for ext in README_EXTENSIONS)
+
+    def run(self):
+        self.run_command('egg_info')
+        ei_cmd = self.get_finalized_command('egg_info')
+        self.filelist = ei_cmd.filelist
+        self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt'))
+        self.check_readme()
+
+        # Run sub commands
+        for cmd_name in self.get_sub_commands():
+            self.run_command(cmd_name)
+
+        self.make_distribution()
+
+        dist_files = getattr(self.distribution, 'dist_files', [])
+        for file in self.archive_files:
+            data = ('sdist', '', file)
+            if data not in dist_files:
+                dist_files.append(data)
+
+    def initialize_options(self):
+        orig.sdist.initialize_options(self)
+
+        self._default_to_gztar()
+
+    def _default_to_gztar(self):
+        # only needed on Python prior to 3.6.
+        if sys.version_info >= (3, 6, 0, 'beta', 1):
+            return
+        self.formats = ['gztar']
+
+    def make_distribution(self):
+        """
+        Workaround for #516
+        """
+        with self._remove_os_link():
+            orig.sdist.make_distribution(self)
+
+    @staticmethod
+    @contextlib.contextmanager
+    def _remove_os_link():
+        """
+        In a context, remove and restore os.link if it exists
+        """
+
+        class NoValue:
+            pass
+
+        orig_val = getattr(os, 'link', NoValue)
+        try:
+            del os.link
+        except Exception:
+            pass
+        try:
+            yield
+        finally:
+            if orig_val is not NoValue:
+                setattr(os, 'link', orig_val)
+
+    def __read_template_hack(self):
+        # This grody hack closes the template file (MANIFEST.in) if an
+        #  exception occurs during read_template.
+        # Doing so prevents an error when easy_install attempts to delete the
+        #  file.
+        try:
+            orig.sdist.read_template(self)
+        except Exception:
+            _, _, tb = sys.exc_info()
+            tb.tb_next.tb_frame.f_locals['template'].close()
+            raise
+
+    # Beginning with Python 2.7.2, 3.1.4, and 3.2.1, this leaky file handle
+    #  has been fixed, so only override the method if we're using an earlier
+    #  Python.
+    has_leaky_handle = (
+        sys.version_info < (2, 7, 2)
+        or (3, 0) <= sys.version_info < (3, 1, 4)
+        or (3, 2) <= sys.version_info < (3, 2, 1)
+    )
+    if has_leaky_handle:
+        read_template = __read_template_hack
+
+    def _add_defaults_optional(self):
+        if six.PY2:
+            sdist_add_defaults._add_defaults_optional(self)
+        else:
+            super()._add_defaults_optional()
+        if os.path.isfile('pyproject.toml'):
+            self.filelist.append('pyproject.toml')
+
+    def _add_defaults_python(self):
+        """getting python files"""
+        if self.distribution.has_pure_modules():
+            build_py = self.get_finalized_command('build_py')
+            self.filelist.extend(build_py.get_source_files())
+            self._add_data_files(self._safe_data_files(build_py))
+
+    def _safe_data_files(self, build_py):
+        """
+        Extracting data_files from build_py is known to cause
+        infinite recursion errors when `include_package_data`
+        is enabled, so suppress it in that case.
+        """
+        if self.distribution.include_package_data:
+            return ()
+        return build_py.data_files
+
+    def _add_data_files(self, data_files):
+        """
+        Add data files as found in build_py.data_files.
+        """
+        self.filelist.extend(
+            os.path.join(src_dir, name)
+            for _, src_dir, _, filenames in data_files
+            for name in filenames
+        )
+
+    def _add_defaults_data_files(self):
+        try:
+            if six.PY2:
+                sdist_add_defaults._add_defaults_data_files(self)
+            else:
+                super()._add_defaults_data_files()
+        except TypeError:
+            log.warn("data_files contains unexpected objects")
+
+    def check_readme(self):
+        for f in self.READMES:
+            if os.path.exists(f):
+                return
+        else:
+            self.warn(
+                "standard file not found: should have one of " +
+                ', '.join(self.READMES)
+            )
+
+    def make_release_tree(self, base_dir, files):
+        orig.sdist.make_release_tree(self, base_dir, files)
+
+        # Save any egg_info command line options used to create this sdist
+        dest = os.path.join(base_dir, 'setup.cfg')
+        if hasattr(os, 'link') and os.path.exists(dest):
+            # unlink and re-copy, since it might be hard-linked, and
+            # we don't want to change the source version
+            os.unlink(dest)
+            self.copy_file('setup.cfg', dest)
+
+        self.get_finalized_command('egg_info').save_version_info(dest)
+
+    def _manifest_is_not_generated(self):
+        # check for special comment used in 2.7.1 and higher
+        if not os.path.isfile(self.manifest):
+            return False
+
+        with io.open(self.manifest, 'rb') as fp:
+            first_line = fp.readline()
+        return (first_line !=
+                '# file GENERATED by distutils, do NOT edit\n'.encode())
+
+    def read_manifest(self):
+        """Read the manifest file (named by 'self.manifest') and use it to
+        fill in 'self.filelist', the list of files to include in the source
+        distribution.
+        """
+        log.info("reading manifest file '%s'", self.manifest)
+        manifest = open(self.manifest, 'rb')
+        for line in manifest:
+            # The manifest must contain UTF-8. See #303.
+            if six.PY3:
+                try:
+                    line = line.decode('UTF-8')
+                except UnicodeDecodeError:
+                    log.warn("%r not UTF-8 decodable -- skipping" % line)
+                    continue
+            # ignore comments and blank lines
+            line = line.strip()
+            if line.startswith('#') or not line:
+                continue
+            self.filelist.append(line)
+        manifest.close()
+
+    def check_license(self):
+        """Checks if license_file' or 'license_files' is configured and adds any
+        valid paths to 'self.filelist'.
+        """
+
+        files = ordered_set.OrderedSet()
+
+        opts = self.distribution.get_option_dict('metadata')
+
+        # ignore the source of the value
+        _, license_file = opts.get('license_file', (None, None))
+
+        if license_file is None:
+            log.debug("'license_file' option was not specified")
+        else:
+            files.add(license_file)
+
+        try:
+            files.update(self.distribution.metadata.license_files)
+        except TypeError:
+            log.warn("warning: 'license_files' option is malformed")
+
+        for f in files:
+            if not os.path.exists(f):
+                log.warn(
+                    "warning: Failed to find the configured license file '%s'",
+                    f)
+                files.remove(f)
+
+        self.filelist.extend(files)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/setopt.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/setopt.py
new file mode 100644
index 0000000000000000000000000000000000000000..7e57cc02627fc3c3bb49613731a51c72452f96ba
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/setopt.py
@@ -0,0 +1,149 @@
+from distutils.util import convert_path
+from distutils import log
+from distutils.errors import DistutilsOptionError
+import distutils
+import os
+
+from setuptools.extern.six.moves import configparser
+
+from setuptools import Command
+
+__all__ = ['config_file', 'edit_config', 'option_base', 'setopt']
+
+
+def config_file(kind="local"):
+    """Get the filename of the distutils, local, global, or per-user config
+
+    `kind` must be one of "local", "global", or "user"
+    """
+    if kind == 'local':
+        return 'setup.cfg'
+    if kind == 'global':
+        return os.path.join(
+            os.path.dirname(distutils.__file__), 'distutils.cfg'
+        )
+    if kind == 'user':
+        dot = os.name == 'posix' and '.' or ''
+        return os.path.expanduser(convert_path("~/%spydistutils.cfg" % dot))
+    raise ValueError(
+        "config_file() type must be 'local', 'global', or 'user'", kind
+    )
+
+
+def edit_config(filename, settings, dry_run=False):
+    """Edit a configuration file to include `settings`
+
+    `settings` is a dictionary of dictionaries or ``None`` values, keyed by
+    command/section name.  A ``None`` value means to delete the entire section,
+    while a dictionary lists settings to be changed or deleted in that section.
+    A setting of ``None`` means to delete that setting.
+    """
+    log.debug("Reading configuration from %s", filename)
+    opts = configparser.RawConfigParser()
+    opts.read([filename])
+    for section, options in settings.items():
+        if options is None:
+            log.info("Deleting section [%s] from %s", section, filename)
+            opts.remove_section(section)
+        else:
+            if not opts.has_section(section):
+                log.debug("Adding new section [%s] to %s", section, filename)
+                opts.add_section(section)
+            for option, value in options.items():
+                if value is None:
+                    log.debug(
+                        "Deleting %s.%s from %s",
+                        section, option, filename
+                    )
+                    opts.remove_option(section, option)
+                    if not opts.options(section):
+                        log.info("Deleting empty [%s] section from %s",
+                                 section, filename)
+                        opts.remove_section(section)
+                else:
+                    log.debug(
+                        "Setting %s.%s to %r in %s",
+                        section, option, value, filename
+                    )
+                    opts.set(section, option, value)
+
+    log.info("Writing %s", filename)
+    if not dry_run:
+        with open(filename, 'w') as f:
+            opts.write(f)
+
+
+class option_base(Command):
+    """Abstract base class for commands that mess with config files"""
+
+    user_options = [
+        ('global-config', 'g',
+         "save options to the site-wide distutils.cfg file"),
+        ('user-config', 'u',
+         "save options to the current user's pydistutils.cfg file"),
+        ('filename=', 'f',
+         "configuration file to use (default=setup.cfg)"),
+    ]
+
+    boolean_options = [
+        'global-config', 'user-config',
+    ]
+
+    def initialize_options(self):
+        self.global_config = None
+        self.user_config = None
+        self.filename = None
+
+    def finalize_options(self):
+        filenames = []
+        if self.global_config:
+            filenames.append(config_file('global'))
+        if self.user_config:
+            filenames.append(config_file('user'))
+        if self.filename is not None:
+            filenames.append(self.filename)
+        if not filenames:
+            filenames.append(config_file('local'))
+        if len(filenames) > 1:
+            raise DistutilsOptionError(
+                "Must specify only one configuration file option",
+                filenames
+            )
+        self.filename, = filenames
+
+
+class setopt(option_base):
+    """Save command-line options to a file"""
+
+    description = "set an option in setup.cfg or another config file"
+
+    user_options = [
+        ('command=', 'c', 'command to set an option for'),
+        ('option=', 'o', 'option to set'),
+        ('set-value=', 's', 'value of the option'),
+        ('remove', 'r', 'remove (unset) the value'),
+    ] + option_base.user_options
+
+    boolean_options = option_base.boolean_options + ['remove']
+
+    def initialize_options(self):
+        option_base.initialize_options(self)
+        self.command = None
+        self.option = None
+        self.set_value = None
+        self.remove = None
+
+    def finalize_options(self):
+        option_base.finalize_options(self)
+        if self.command is None or self.option is None:
+            raise DistutilsOptionError("Must specify --command *and* --option")
+        if self.set_value is None and not self.remove:
+            raise DistutilsOptionError("Must specify --set-value or --remove")
+
+    def run(self):
+        edit_config(
+            self.filename, {
+                self.command: {self.option.replace('-', '_'): self.set_value}
+            },
+            self.dry_run
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/test.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/test.py
new file mode 100644
index 0000000000000000000000000000000000000000..c148b38d10c7691c2045520e5aedb60293dd714d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/test.py
@@ -0,0 +1,279 @@
+import os
+import operator
+import sys
+import contextlib
+import itertools
+import unittest
+from distutils.errors import DistutilsError, DistutilsOptionError
+from distutils import log
+from unittest import TestLoader
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import map, filter
+
+from pkg_resources import (resource_listdir, resource_exists, normalize_path,
+                           working_set, _namespace_packages, evaluate_marker,
+                           add_activation_listener, require, EntryPoint)
+from setuptools import Command
+from .build_py import _unique_everseen
+
+__metaclass__ = type
+
+
+class ScanningLoader(TestLoader):
+
+    def __init__(self):
+        TestLoader.__init__(self)
+        self._visited = set()
+
+    def loadTestsFromModule(self, module, pattern=None):
+        """Return a suite of all tests cases contained in the given module
+
+        If the module is a package, load tests from all the modules in it.
+        If the module has an ``additional_tests`` function, call it and add
+        the return value to the tests.
+        """
+        if module in self._visited:
+            return None
+        self._visited.add(module)
+
+        tests = []
+        tests.append(TestLoader.loadTestsFromModule(self, module))
+
+        if hasattr(module, "additional_tests"):
+            tests.append(module.additional_tests())
+
+        if hasattr(module, '__path__'):
+            for file in resource_listdir(module.__name__, ''):
+                if file.endswith('.py') and file != '__init__.py':
+                    submodule = module.__name__ + '.' + file[:-3]
+                else:
+                    if resource_exists(module.__name__, file + '/__init__.py'):
+                        submodule = module.__name__ + '.' + file
+                    else:
+                        continue
+                tests.append(self.loadTestsFromName(submodule))
+
+        if len(tests) != 1:
+            return self.suiteClass(tests)
+        else:
+            return tests[0]  # don't create a nested suite for only one return
+
+
+# adapted from jaraco.classes.properties:NonDataProperty
+class NonDataProperty:
+    def __init__(self, fget):
+        self.fget = fget
+
+    def __get__(self, obj, objtype=None):
+        if obj is None:
+            return self
+        return self.fget(obj)
+
+
+class test(Command):
+    """Command to run unit tests after in-place build"""
+
+    description = "run unit tests after in-place build (deprecated)"
+
+    user_options = [
+        ('test-module=', 'm', "Run 'test_suite' in specified module"),
+        ('test-suite=', 's',
+         "Run single test, case or suite (e.g. 'module.test_suite')"),
+        ('test-runner=', 'r', "Test runner to use"),
+    ]
+
+    def initialize_options(self):
+        self.test_suite = None
+        self.test_module = None
+        self.test_loader = None
+        self.test_runner = None
+
+    def finalize_options(self):
+
+        if self.test_suite and self.test_module:
+            msg = "You may specify a module or a suite, but not both"
+            raise DistutilsOptionError(msg)
+
+        if self.test_suite is None:
+            if self.test_module is None:
+                self.test_suite = self.distribution.test_suite
+            else:
+                self.test_suite = self.test_module + ".test_suite"
+
+        if self.test_loader is None:
+            self.test_loader = getattr(self.distribution, 'test_loader', None)
+        if self.test_loader is None:
+            self.test_loader = "setuptools.command.test:ScanningLoader"
+        if self.test_runner is None:
+            self.test_runner = getattr(self.distribution, 'test_runner', None)
+
+    @NonDataProperty
+    def test_args(self):
+        return list(self._test_args())
+
+    def _test_args(self):
+        if not self.test_suite and sys.version_info >= (2, 7):
+            yield 'discover'
+        if self.verbose:
+            yield '--verbose'
+        if self.test_suite:
+            yield self.test_suite
+
+    def with_project_on_sys_path(self, func):
+        """
+        Backward compatibility for project_on_sys_path context.
+        """
+        with self.project_on_sys_path():
+            func()
+
+    @contextlib.contextmanager
+    def project_on_sys_path(self, include_dists=[]):
+        with_2to3 = six.PY3 and getattr(self.distribution, 'use_2to3', False)
+
+        if with_2to3:
+            # If we run 2to3 we can not do this inplace:
+
+            # Ensure metadata is up-to-date
+            self.reinitialize_command('build_py', inplace=0)
+            self.run_command('build_py')
+            bpy_cmd = self.get_finalized_command("build_py")
+            build_path = normalize_path(bpy_cmd.build_lib)
+
+            # Build extensions
+            self.reinitialize_command('egg_info', egg_base=build_path)
+            self.run_command('egg_info')
+
+            self.reinitialize_command('build_ext', inplace=0)
+            self.run_command('build_ext')
+        else:
+            # Without 2to3 inplace works fine:
+            self.run_command('egg_info')
+
+            # Build extensions in-place
+            self.reinitialize_command('build_ext', inplace=1)
+            self.run_command('build_ext')
+
+        ei_cmd = self.get_finalized_command("egg_info")
+
+        old_path = sys.path[:]
+        old_modules = sys.modules.copy()
+
+        try:
+            project_path = normalize_path(ei_cmd.egg_base)
+            sys.path.insert(0, project_path)
+            working_set.__init__()
+            add_activation_listener(lambda dist: dist.activate())
+            require('%s==%s' % (ei_cmd.egg_name, ei_cmd.egg_version))
+            with self.paths_on_pythonpath([project_path]):
+                yield
+        finally:
+            sys.path[:] = old_path
+            sys.modules.clear()
+            sys.modules.update(old_modules)
+            working_set.__init__()
+
+    @staticmethod
+    @contextlib.contextmanager
+    def paths_on_pythonpath(paths):
+        """
+        Add the indicated paths to the head of the PYTHONPATH environment
+        variable so that subprocesses will also see the packages at
+        these paths.
+
+        Do this in a context that restores the value on exit.
+        """
+        nothing = object()
+        orig_pythonpath = os.environ.get('PYTHONPATH', nothing)
+        current_pythonpath = os.environ.get('PYTHONPATH', '')
+        try:
+            prefix = os.pathsep.join(_unique_everseen(paths))
+            to_join = filter(None, [prefix, current_pythonpath])
+            new_path = os.pathsep.join(to_join)
+            if new_path:
+                os.environ['PYTHONPATH'] = new_path
+            yield
+        finally:
+            if orig_pythonpath is nothing:
+                os.environ.pop('PYTHONPATH', None)
+            else:
+                os.environ['PYTHONPATH'] = orig_pythonpath
+
+    @staticmethod
+    def install_dists(dist):
+        """
+        Install the requirements indicated by self.distribution and
+        return an iterable of the dists that were built.
+        """
+        ir_d = dist.fetch_build_eggs(dist.install_requires)
+        tr_d = dist.fetch_build_eggs(dist.tests_require or [])
+        er_d = dist.fetch_build_eggs(
+            v for k, v in dist.extras_require.items()
+            if k.startswith(':') and evaluate_marker(k[1:])
+        )
+        return itertools.chain(ir_d, tr_d, er_d)
+
+    def run(self):
+        self.announce(
+            "WARNING: Testing via this command is deprecated and will be "
+            "removed in a future version. Users looking for a generic test "
+            "entry point independent of test runner are encouraged to use "
+            "tox.",
+            log.WARN,
+        )
+
+        installed_dists = self.install_dists(self.distribution)
+
+        cmd = ' '.join(self._argv)
+        if self.dry_run:
+            self.announce('skipping "%s" (dry run)' % cmd)
+            return
+
+        self.announce('running "%s"' % cmd)
+
+        paths = map(operator.attrgetter('location'), installed_dists)
+        with self.paths_on_pythonpath(paths):
+            with self.project_on_sys_path():
+                self.run_tests()
+
+    def run_tests(self):
+        # Purge modules under test from sys.modules. The test loader will
+        # re-import them from the build location. Required when 2to3 is used
+        # with namespace packages.
+        if six.PY3 and getattr(self.distribution, 'use_2to3', False):
+            module = self.test_suite.split('.')[0]
+            if module in _namespace_packages:
+                del_modules = []
+                if module in sys.modules:
+                    del_modules.append(module)
+                module += '.'
+                for name in sys.modules:
+                    if name.startswith(module):
+                        del_modules.append(name)
+                list(map(sys.modules.__delitem__, del_modules))
+
+        test = unittest.main(
+            None, None, self._argv,
+            testLoader=self._resolve_as_ep(self.test_loader),
+            testRunner=self._resolve_as_ep(self.test_runner),
+            exit=False,
+        )
+        if not test.result.wasSuccessful():
+            msg = 'Test failed: %s' % test.result
+            self.announce(msg, log.ERROR)
+            raise DistutilsError(msg)
+
+    @property
+    def _argv(self):
+        return ['unittest'] + self.test_args
+
+    @staticmethod
+    def _resolve_as_ep(val):
+        """
+        Load the indicated attribute value, called, as a as if it were
+        specified as an entry point.
+        """
+        if val is None:
+            return
+        parsed = EntryPoint.parse("x=" + val)
+        return parsed.resolve()()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload.py
new file mode 100644
index 0000000000000000000000000000000000000000..ec7f81e22772511d668e5ab92f625db33259e803
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload.py
@@ -0,0 +1,17 @@
+from distutils import log
+from distutils.command import upload as orig
+
+from setuptools.errors import RemovedCommandError
+
+
+class upload(orig.upload):
+    """Formerly used to upload packages to PyPI."""
+
+    def run(self):
+        msg = (
+            "The upload command has been removed, use twine to upload "
+            + "instead (https://pypi.org/p/twine)"
+        )
+
+        self.announce("ERROR: " + msg, log.ERROR)
+        raise RemovedCommandError(msg)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py
new file mode 100644
index 0000000000000000000000000000000000000000..07aa564af451ce41d818d72f8ee93cb46887cecf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/command/upload_docs.py
@@ -0,0 +1,206 @@
+# -*- coding: utf-8 -*-
+"""upload_docs
+
+Implements a Distutils 'upload_docs' subcommand (upload documentation to
+PyPI's pythonhosted.org).
+"""
+
+from base64 import standard_b64encode
+from distutils import log
+from distutils.errors import DistutilsOptionError
+import os
+import socket
+import zipfile
+import tempfile
+import shutil
+import itertools
+import functools
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import http_client, urllib
+
+from pkg_resources import iter_entry_points
+from .upload import upload
+
+
+def _encode(s):
+    errors = 'surrogateescape' if six.PY3 else 'strict'
+    return s.encode('utf-8', errors)
+
+
+class upload_docs(upload):
+    # override the default repository as upload_docs isn't
+    # supported by Warehouse (and won't be).
+    DEFAULT_REPOSITORY = 'https://pypi.python.org/pypi/'
+
+    description = 'Upload documentation to PyPI'
+
+    user_options = [
+        ('repository=', 'r',
+         "url of repository [default: %s]" % upload.DEFAULT_REPOSITORY),
+        ('show-response', None,
+         'display full response text from server'),
+        ('upload-dir=', None, 'directory to upload'),
+    ]
+    boolean_options = upload.boolean_options
+
+    def has_sphinx(self):
+        if self.upload_dir is None:
+            for ep in iter_entry_points('distutils.commands', 'build_sphinx'):
+                return True
+
+    sub_commands = [('build_sphinx', has_sphinx)]
+
+    def initialize_options(self):
+        upload.initialize_options(self)
+        self.upload_dir = None
+        self.target_dir = None
+
+    def finalize_options(self):
+        upload.finalize_options(self)
+        if self.upload_dir is None:
+            if self.has_sphinx():
+                build_sphinx = self.get_finalized_command('build_sphinx')
+                self.target_dir = build_sphinx.builder_target_dir
+            else:
+                build = self.get_finalized_command('build')
+                self.target_dir = os.path.join(build.build_base, 'docs')
+        else:
+            self.ensure_dirname('upload_dir')
+            self.target_dir = self.upload_dir
+        if 'pypi.python.org' in self.repository:
+            log.warn("Upload_docs command is deprecated. Use RTD instead.")
+        self.announce('Using upload directory %s' % self.target_dir)
+
+    def create_zipfile(self, filename):
+        zip_file = zipfile.ZipFile(filename, "w")
+        try:
+            self.mkpath(self.target_dir)  # just in case
+            for root, dirs, files in os.walk(self.target_dir):
+                if root == self.target_dir and not files:
+                    tmpl = "no files found in upload directory '%s'"
+                    raise DistutilsOptionError(tmpl % self.target_dir)
+                for name in files:
+                    full = os.path.join(root, name)
+                    relative = root[len(self.target_dir):].lstrip(os.path.sep)
+                    dest = os.path.join(relative, name)
+                    zip_file.write(full, dest)
+        finally:
+            zip_file.close()
+
+    def run(self):
+        # Run sub commands
+        for cmd_name in self.get_sub_commands():
+            self.run_command(cmd_name)
+
+        tmp_dir = tempfile.mkdtemp()
+        name = self.distribution.metadata.get_name()
+        zip_file = os.path.join(tmp_dir, "%s.zip" % name)
+        try:
+            self.create_zipfile(zip_file)
+            self.upload_file(zip_file)
+        finally:
+            shutil.rmtree(tmp_dir)
+
+    @staticmethod
+    def _build_part(item, sep_boundary):
+        key, values = item
+        title = '\nContent-Disposition: form-data; name="%s"' % key
+        # handle multiple entries for the same name
+        if not isinstance(values, list):
+            values = [values]
+        for value in values:
+            if isinstance(value, tuple):
+                title += '; filename="%s"' % value[0]
+                value = value[1]
+            else:
+                value = _encode(value)
+            yield sep_boundary
+            yield _encode(title)
+            yield b"\n\n"
+            yield value
+            if value and value[-1:] == b'\r':
+                yield b'\n'  # write an extra newline (lurve Macs)
+
+    @classmethod
+    def _build_multipart(cls, data):
+        """
+        Build up the MIME payload for the POST data
+        """
+        boundary = b'--------------GHSKFJDLGDS7543FJKLFHRE75642756743254'
+        sep_boundary = b'\n--' + boundary
+        end_boundary = sep_boundary + b'--'
+        end_items = end_boundary, b"\n",
+        builder = functools.partial(
+            cls._build_part,
+            sep_boundary=sep_boundary,
+        )
+        part_groups = map(builder, data.items())
+        parts = itertools.chain.from_iterable(part_groups)
+        body_items = itertools.chain(parts, end_items)
+        content_type = 'multipart/form-data; boundary=%s' % boundary.decode('ascii')
+        return b''.join(body_items), content_type
+
+    def upload_file(self, filename):
+        with open(filename, 'rb') as f:
+            content = f.read()
+        meta = self.distribution.metadata
+        data = {
+            ':action': 'doc_upload',
+            'name': meta.get_name(),
+            'content': (os.path.basename(filename), content),
+        }
+        # set up the authentication
+        credentials = _encode(self.username + ':' + self.password)
+        credentials = standard_b64encode(credentials)
+        if six.PY3:
+            credentials = credentials.decode('ascii')
+        auth = "Basic " + credentials
+
+        body, ct = self._build_multipart(data)
+
+        msg = "Submitting documentation to %s" % (self.repository)
+        self.announce(msg, log.INFO)
+
+        # build the Request
+        # We can't use urllib2 since we need to send the Basic
+        # auth right with the first request
+        schema, netloc, url, params, query, fragments = \
+            urllib.parse.urlparse(self.repository)
+        assert not params and not query and not fragments
+        if schema == 'http':
+            conn = http_client.HTTPConnection(netloc)
+        elif schema == 'https':
+            conn = http_client.HTTPSConnection(netloc)
+        else:
+            raise AssertionError("unsupported schema " + schema)
+
+        data = ''
+        try:
+            conn.connect()
+            conn.putrequest("POST", url)
+            content_type = ct
+            conn.putheader('Content-type', content_type)
+            conn.putheader('Content-length', str(len(body)))
+            conn.putheader('Authorization', auth)
+            conn.endheaders()
+            conn.send(body)
+        except socket.error as e:
+            self.announce(str(e), log.ERROR)
+            return
+
+        r = conn.getresponse()
+        if r.status == 200:
+            msg = 'Server response (%s): %s' % (r.status, r.reason)
+            self.announce(msg, log.INFO)
+        elif r.status == 301:
+            location = r.getheader('Location')
+            if location is None:
+                location = 'https://pythonhosted.org/%s/' % meta.get_name()
+            msg = 'Upload successful. Visit %s' % location
+            self.announce(msg, log.INFO)
+        else:
+            msg = 'Upload failed (%s): %s' % (r.status, r.reason)
+            self.announce(msg, log.ERROR)
+        if self.show_response:
+            print('-' * 75, r.read(), '-' * 75)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/config.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/config.py
new file mode 100644
index 0000000000000000000000000000000000000000..9b9a0c45e756b44ddea7660228934d0a37fcd97c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/config.py
@@ -0,0 +1,659 @@
+from __future__ import absolute_import, unicode_literals
+import io
+import os
+import sys
+
+import warnings
+import functools
+from collections import defaultdict
+from functools import partial
+from functools import wraps
+from importlib import import_module
+
+from distutils.errors import DistutilsOptionError, DistutilsFileError
+from setuptools.extern.packaging.version import LegacyVersion, parse
+from setuptools.extern.packaging.specifiers import SpecifierSet
+from setuptools.extern.six import string_types, PY3
+
+
+__metaclass__ = type
+
+
+def read_configuration(
+        filepath, find_others=False, ignore_option_errors=False):
+    """Read given configuration file and returns options from it as a dict.
+
+    :param str|unicode filepath: Path to configuration file
+        to get options from.
+
+    :param bool find_others: Whether to search for other configuration files
+        which could be on in various places.
+
+    :param bool ignore_option_errors: Whether to silently ignore
+        options, values of which could not be resolved (e.g. due to exceptions
+        in directives such as file:, attr:, etc.).
+        If False exceptions are propagated as expected.
+
+    :rtype: dict
+    """
+    from setuptools.dist import Distribution, _Distribution
+
+    filepath = os.path.abspath(filepath)
+
+    if not os.path.isfile(filepath):
+        raise DistutilsFileError(
+            'Configuration file %s does not exist.' % filepath)
+
+    current_directory = os.getcwd()
+    os.chdir(os.path.dirname(filepath))
+
+    try:
+        dist = Distribution()
+
+        filenames = dist.find_config_files() if find_others else []
+        if filepath not in filenames:
+            filenames.append(filepath)
+
+        _Distribution.parse_config_files(dist, filenames=filenames)
+
+        handlers = parse_configuration(
+            dist, dist.command_options,
+            ignore_option_errors=ignore_option_errors)
+
+    finally:
+        os.chdir(current_directory)
+
+    return configuration_to_dict(handlers)
+
+
+def _get_option(target_obj, key):
+    """
+    Given a target object and option key, get that option from
+    the target object, either through a get_{key} method or
+    from an attribute directly.
+    """
+    getter_name = 'get_{key}'.format(**locals())
+    by_attribute = functools.partial(getattr, target_obj, key)
+    getter = getattr(target_obj, getter_name, by_attribute)
+    return getter()
+
+
+def configuration_to_dict(handlers):
+    """Returns configuration data gathered by given handlers as a dict.
+
+    :param list[ConfigHandler] handlers: Handlers list,
+        usually from parse_configuration()
+
+    :rtype: dict
+    """
+    config_dict = defaultdict(dict)
+
+    for handler in handlers:
+        for option in handler.set_options:
+            value = _get_option(handler.target_obj, option)
+            config_dict[handler.section_prefix][option] = value
+
+    return config_dict
+
+
+def parse_configuration(
+        distribution, command_options, ignore_option_errors=False):
+    """Performs additional parsing of configuration options
+    for a distribution.
+
+    Returns a list of used option handlers.
+
+    :param Distribution distribution:
+    :param dict command_options:
+    :param bool ignore_option_errors: Whether to silently ignore
+        options, values of which could not be resolved (e.g. due to exceptions
+        in directives such as file:, attr:, etc.).
+        If False exceptions are propagated as expected.
+    :rtype: list
+    """
+    options = ConfigOptionsHandler(
+        distribution, command_options, ignore_option_errors)
+    options.parse()
+
+    meta = ConfigMetadataHandler(
+        distribution.metadata, command_options, ignore_option_errors,
+        distribution.package_dir)
+    meta.parse()
+
+    return meta, options
+
+
+class ConfigHandler:
+    """Handles metadata supplied in configuration files."""
+
+    section_prefix = None
+    """Prefix for config sections handled by this handler.
+    Must be provided by class heirs.
+
+    """
+
+    aliases = {}
+    """Options aliases.
+    For compatibility with various packages. E.g.: d2to1 and pbr.
+    Note: `-` in keys is replaced with `_` by config parser.
+
+    """
+
+    def __init__(self, target_obj, options, ignore_option_errors=False):
+        sections = {}
+
+        section_prefix = self.section_prefix
+        for section_name, section_options in options.items():
+            if not section_name.startswith(section_prefix):
+                continue
+
+            section_name = section_name.replace(section_prefix, '').strip('.')
+            sections[section_name] = section_options
+
+        self.ignore_option_errors = ignore_option_errors
+        self.target_obj = target_obj
+        self.sections = sections
+        self.set_options = []
+
+    @property
+    def parsers(self):
+        """Metadata item name to parser function mapping."""
+        raise NotImplementedError(
+            '%s must provide .parsers property' % self.__class__.__name__)
+
+    def __setitem__(self, option_name, value):
+        unknown = tuple()
+        target_obj = self.target_obj
+
+        # Translate alias into real name.
+        option_name = self.aliases.get(option_name, option_name)
+
+        current_value = getattr(target_obj, option_name, unknown)
+
+        if current_value is unknown:
+            raise KeyError(option_name)
+
+        if current_value:
+            # Already inhabited. Skipping.
+            return
+
+        skip_option = False
+        parser = self.parsers.get(option_name)
+        if parser:
+            try:
+                value = parser(value)
+
+            except Exception:
+                skip_option = True
+                if not self.ignore_option_errors:
+                    raise
+
+        if skip_option:
+            return
+
+        setter = getattr(target_obj, 'set_%s' % option_name, None)
+        if setter is None:
+            setattr(target_obj, option_name, value)
+        else:
+            setter(value)
+
+        self.set_options.append(option_name)
+
+    @classmethod
+    def _parse_list(cls, value, separator=','):
+        """Represents value as a list.
+
+        Value is split either by separator (defaults to comma) or by lines.
+
+        :param value:
+        :param separator: List items separator character.
+        :rtype: list
+        """
+        if isinstance(value, list):  # _get_parser_compound case
+            return value
+
+        if '\n' in value:
+            value = value.splitlines()
+        else:
+            value = value.split(separator)
+
+        return [chunk.strip() for chunk in value if chunk.strip()]
+
+    @classmethod
+    def _parse_dict(cls, value):
+        """Represents value as a dict.
+
+        :param value:
+        :rtype: dict
+        """
+        separator = '='
+        result = {}
+        for line in cls._parse_list(value):
+            key, sep, val = line.partition(separator)
+            if sep != separator:
+                raise DistutilsOptionError(
+                    'Unable to parse option value to dict: %s' % value)
+            result[key.strip()] = val.strip()
+
+        return result
+
+    @classmethod
+    def _parse_bool(cls, value):
+        """Represents value as boolean.
+
+        :param value:
+        :rtype: bool
+        """
+        value = value.lower()
+        return value in ('1', 'true', 'yes')
+
+    @classmethod
+    def _exclude_files_parser(cls, key):
+        """Returns a parser function to make sure field inputs
+        are not files.
+
+        Parses a value after getting the key so error messages are
+        more informative.
+
+        :param key:
+        :rtype: callable
+        """
+        def parser(value):
+            exclude_directive = 'file:'
+            if value.startswith(exclude_directive):
+                raise ValueError(
+                    'Only strings are accepted for the {0} field, '
+                    'files are not accepted'.format(key))
+            return value
+        return parser
+
+    @classmethod
+    def _parse_file(cls, value):
+        """Represents value as a string, allowing including text
+        from nearest files using `file:` directive.
+
+        Directive is sandboxed and won't reach anything outside
+        directory with setup.py.
+
+        Examples:
+            file: README.rst, CHANGELOG.md, src/file.txt
+
+        :param str value:
+        :rtype: str
+        """
+        include_directive = 'file:'
+
+        if not isinstance(value, string_types):
+            return value
+
+        if not value.startswith(include_directive):
+            return value
+
+        spec = value[len(include_directive):]
+        filepaths = (os.path.abspath(path.strip()) for path in spec.split(','))
+        return '\n'.join(
+            cls._read_file(path)
+            for path in filepaths
+            if (cls._assert_local(path) or True)
+            and os.path.isfile(path)
+        )
+
+    @staticmethod
+    def _assert_local(filepath):
+        if not filepath.startswith(os.getcwd()):
+            raise DistutilsOptionError(
+                '`file:` directive can not access %s' % filepath)
+
+    @staticmethod
+    def _read_file(filepath):
+        with io.open(filepath, encoding='utf-8') as f:
+            return f.read()
+
+    @classmethod
+    def _parse_attr(cls, value, package_dir=None):
+        """Represents value as a module attribute.
+
+        Examples:
+            attr: package.attr
+            attr: package.module.attr
+
+        :param str value:
+        :rtype: str
+        """
+        attr_directive = 'attr:'
+        if not value.startswith(attr_directive):
+            return value
+
+        attrs_path = value.replace(attr_directive, '').strip().split('.')
+        attr_name = attrs_path.pop()
+
+        module_name = '.'.join(attrs_path)
+        module_name = module_name or '__init__'
+
+        parent_path = os.getcwd()
+        if package_dir:
+            if attrs_path[0] in package_dir:
+                # A custom path was specified for the module we want to import
+                custom_path = package_dir[attrs_path[0]]
+                parts = custom_path.rsplit('/', 1)
+                if len(parts) > 1:
+                    parent_path = os.path.join(os.getcwd(), parts[0])
+                    module_name = parts[1]
+                else:
+                    module_name = custom_path
+            elif '' in package_dir:
+                # A custom parent directory was specified for all root modules
+                parent_path = os.path.join(os.getcwd(), package_dir[''])
+        sys.path.insert(0, parent_path)
+        try:
+            module = import_module(module_name)
+            value = getattr(module, attr_name)
+
+        finally:
+            sys.path = sys.path[1:]
+
+        return value
+
+    @classmethod
+    def _get_parser_compound(cls, *parse_methods):
+        """Returns parser function to represents value as a list.
+
+        Parses a value applying given methods one after another.
+
+        :param parse_methods:
+        :rtype: callable
+        """
+        def parse(value):
+            parsed = value
+
+            for method in parse_methods:
+                parsed = method(parsed)
+
+            return parsed
+
+        return parse
+
+    @classmethod
+    def _parse_section_to_dict(cls, section_options, values_parser=None):
+        """Parses section options into a dictionary.
+
+        Optionally applies a given parser to values.
+
+        :param dict section_options:
+        :param callable values_parser:
+        :rtype: dict
+        """
+        value = {}
+        values_parser = values_parser or (lambda val: val)
+        for key, (_, val) in section_options.items():
+            value[key] = values_parser(val)
+        return value
+
+    def parse_section(self, section_options):
+        """Parses configuration file section.
+
+        :param dict section_options:
+        """
+        for (name, (_, value)) in section_options.items():
+            try:
+                self[name] = value
+
+            except KeyError:
+                pass  # Keep silent for a new option may appear anytime.
+
+    def parse(self):
+        """Parses configuration file items from one
+        or more related sections.
+
+        """
+        for section_name, section_options in self.sections.items():
+
+            method_postfix = ''
+            if section_name:  # [section.option] variant
+                method_postfix = '_%s' % section_name
+
+            section_parser_method = getattr(
+                self,
+                # Dots in section names are translated into dunderscores.
+                ('parse_section%s' % method_postfix).replace('.', '__'),
+                None)
+
+            if section_parser_method is None:
+                raise DistutilsOptionError(
+                    'Unsupported distribution option section: [%s.%s]' % (
+                        self.section_prefix, section_name))
+
+            section_parser_method(section_options)
+
+    def _deprecated_config_handler(self, func, msg, warning_class):
+        """ this function will wrap around parameters that are deprecated
+
+        :param msg: deprecation message
+        :param warning_class: class of warning exception to be raised
+        :param func: function to be wrapped around
+        """
+        @wraps(func)
+        def config_handler(*args, **kwargs):
+            warnings.warn(msg, warning_class)
+            return func(*args, **kwargs)
+
+        return config_handler
+
+
+class ConfigMetadataHandler(ConfigHandler):
+
+    section_prefix = 'metadata'
+
+    aliases = {
+        'home_page': 'url',
+        'summary': 'description',
+        'classifier': 'classifiers',
+        'platform': 'platforms',
+    }
+
+    strict_mode = False
+    """We need to keep it loose, to be partially compatible with
+    `pbr` and `d2to1` packages which also uses `metadata` section.
+
+    """
+
+    def __init__(self, target_obj, options, ignore_option_errors=False,
+                 package_dir=None):
+        super(ConfigMetadataHandler, self).__init__(target_obj, options,
+                                                    ignore_option_errors)
+        self.package_dir = package_dir
+
+    @property
+    def parsers(self):
+        """Metadata item name to parser function mapping."""
+        parse_list = self._parse_list
+        parse_file = self._parse_file
+        parse_dict = self._parse_dict
+        exclude_files_parser = self._exclude_files_parser
+
+        return {
+            'platforms': parse_list,
+            'keywords': parse_list,
+            'provides': parse_list,
+            'requires': self._deprecated_config_handler(
+                parse_list,
+                "The requires parameter is deprecated, please use "
+                "install_requires for runtime dependencies.",
+                DeprecationWarning),
+            'obsoletes': parse_list,
+            'classifiers': self._get_parser_compound(parse_file, parse_list),
+            'license': exclude_files_parser('license'),
+            'license_files': parse_list,
+            'description': parse_file,
+            'long_description': parse_file,
+            'version': self._parse_version,
+            'project_urls': parse_dict,
+        }
+
+    def _parse_version(self, value):
+        """Parses `version` option value.
+
+        :param value:
+        :rtype: str
+
+        """
+        version = self._parse_file(value)
+
+        if version != value:
+            version = version.strip()
+            # Be strict about versions loaded from file because it's easy to
+            # accidentally include newlines and other unintended content
+            if isinstance(parse(version), LegacyVersion):
+                tmpl = (
+                    'Version loaded from {value} does not '
+                    'comply with PEP 440: {version}'
+                )
+                raise DistutilsOptionError(tmpl.format(**locals()))
+
+            return version
+
+        version = self._parse_attr(value, self.package_dir)
+
+        if callable(version):
+            version = version()
+
+        if not isinstance(version, string_types):
+            if hasattr(version, '__iter__'):
+                version = '.'.join(map(str, version))
+            else:
+                version = '%s' % version
+
+        return version
+
+
+class ConfigOptionsHandler(ConfigHandler):
+
+    section_prefix = 'options'
+
+    @property
+    def parsers(self):
+        """Metadata item name to parser function mapping."""
+        parse_list = self._parse_list
+        parse_list_semicolon = partial(self._parse_list, separator=';')
+        parse_bool = self._parse_bool
+        parse_dict = self._parse_dict
+
+        return {
+            'zip_safe': parse_bool,
+            'use_2to3': parse_bool,
+            'include_package_data': parse_bool,
+            'package_dir': parse_dict,
+            'use_2to3_fixers': parse_list,
+            'use_2to3_exclude_fixers': parse_list,
+            'convert_2to3_doctests': parse_list,
+            'scripts': parse_list,
+            'eager_resources': parse_list,
+            'dependency_links': parse_list,
+            'namespace_packages': parse_list,
+            'install_requires': parse_list_semicolon,
+            'setup_requires': parse_list_semicolon,
+            'tests_require': parse_list_semicolon,
+            'packages': self._parse_packages,
+            'entry_points': self._parse_file,
+            'py_modules': parse_list,
+            'python_requires': SpecifierSet,
+        }
+
+    def _parse_packages(self, value):
+        """Parses `packages` option value.
+
+        :param value:
+        :rtype: list
+        """
+        find_directives = ['find:', 'find_namespace:']
+        trimmed_value = value.strip()
+
+        if trimmed_value not in find_directives:
+            return self._parse_list(value)
+
+        findns = trimmed_value == find_directives[1]
+        if findns and not PY3:
+            raise DistutilsOptionError(
+                'find_namespace: directive is unsupported on Python < 3.3')
+
+        # Read function arguments from a dedicated section.
+        find_kwargs = self.parse_section_packages__find(
+            self.sections.get('packages.find', {}))
+
+        if findns:
+            from setuptools import find_namespace_packages as find_packages
+        else:
+            from setuptools import find_packages
+
+        return find_packages(**find_kwargs)
+
+    def parse_section_packages__find(self, section_options):
+        """Parses `packages.find` configuration file section.
+
+        To be used in conjunction with _parse_packages().
+
+        :param dict section_options:
+        """
+        section_data = self._parse_section_to_dict(
+            section_options, self._parse_list)
+
+        valid_keys = ['where', 'include', 'exclude']
+
+        find_kwargs = dict(
+            [(k, v) for k, v in section_data.items() if k in valid_keys and v])
+
+        where = find_kwargs.get('where')
+        if where is not None:
+            find_kwargs['where'] = where[0]  # cast list to single val
+
+        return find_kwargs
+
+    def parse_section_entry_points(self, section_options):
+        """Parses `entry_points` configuration file section.
+
+        :param dict section_options:
+        """
+        parsed = self._parse_section_to_dict(section_options, self._parse_list)
+        self['entry_points'] = parsed
+
+    def _parse_package_data(self, section_options):
+        parsed = self._parse_section_to_dict(section_options, self._parse_list)
+
+        root = parsed.get('*')
+        if root:
+            parsed[''] = root
+            del parsed['*']
+
+        return parsed
+
+    def parse_section_package_data(self, section_options):
+        """Parses `package_data` configuration file section.
+
+        :param dict section_options:
+        """
+        self['package_data'] = self._parse_package_data(section_options)
+
+    def parse_section_exclude_package_data(self, section_options):
+        """Parses `exclude_package_data` configuration file section.
+
+        :param dict section_options:
+        """
+        self['exclude_package_data'] = self._parse_package_data(
+            section_options)
+
+    def parse_section_extras_require(self, section_options):
+        """Parses `extras_require` configuration file section.
+
+        :param dict section_options:
+        """
+        parse_list = partial(self._parse_list, separator=';')
+        self['extras_require'] = self._parse_section_to_dict(
+            section_options, parse_list)
+
+    def parse_section_data_files(self, section_options):
+        """Parses `data_files` configuration file section.
+
+        :param dict section_options:
+        """
+        parsed = self._parse_section_to_dict(section_options, self._parse_list)
+        self['data_files'] = [(k, v) for k, v in parsed.items()]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dep_util.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dep_util.py
new file mode 100644
index 0000000000000000000000000000000000000000..2931c13ec35aa60b742ac4c46ceabd4ed32a5511
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dep_util.py
@@ -0,0 +1,23 @@
+from distutils.dep_util import newer_group
+
+# yes, this is was almost entirely copy-pasted from
+# 'newer_pairwise()', this is just another convenience
+# function.
+def newer_pairwise_group(sources_groups, targets):
+    """Walk both arguments in parallel, testing if each source group is newer
+    than its corresponding target. Returns a pair of lists (sources_groups,
+    targets) where sources is newer than target, according to the semantics
+    of 'newer_group()'.
+    """
+    if len(sources_groups) != len(targets):
+        raise ValueError("'sources_group' and 'targets' must be the same length")
+
+    # build a pair of lists (sources_groups, targets) where source is newer
+    n_sources = []
+    n_targets = []
+    for i in range(len(sources_groups)):
+        if newer_group(sources_groups[i], targets[i]):
+            n_sources.append(sources_groups[i])
+            n_targets.append(targets[i])
+
+    return n_sources, n_targets
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/depends.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/depends.py
new file mode 100644
index 0000000000000000000000000000000000000000..a37675cbd9bc9583fd01cc158198e2f4deda321b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/depends.py
@@ -0,0 +1,176 @@
+import sys
+import marshal
+import contextlib
+from distutils.version import StrictVersion
+
+from .py33compat import Bytecode
+
+from .py27compat import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE
+from . import py27compat
+
+
+__all__ = [
+    'Require', 'find_module', 'get_module_constant', 'extract_constant'
+]
+
+
+class Require:
+    """A prerequisite to building or installing a distribution"""
+
+    def __init__(
+            self, name, requested_version, module, homepage='',
+            attribute=None, format=None):
+
+        if format is None and requested_version is not None:
+            format = StrictVersion
+
+        if format is not None:
+            requested_version = format(requested_version)
+            if attribute is None:
+                attribute = '__version__'
+
+        self.__dict__.update(locals())
+        del self.self
+
+    def full_name(self):
+        """Return full package/distribution name, w/version"""
+        if self.requested_version is not None:
+            return '%s-%s' % (self.name, self.requested_version)
+        return self.name
+
+    def version_ok(self, version):
+        """Is 'version' sufficiently up-to-date?"""
+        return self.attribute is None or self.format is None or \
+            str(version) != "unknown" and version >= self.requested_version
+
+    def get_version(self, paths=None, default="unknown"):
+        """Get version number of installed module, 'None', or 'default'
+
+        Search 'paths' for module.  If not found, return 'None'.  If found,
+        return the extracted version attribute, or 'default' if no version
+        attribute was specified, or the value cannot be determined without
+        importing the module.  The version is formatted according to the
+        requirement's version format (if any), unless it is 'None' or the
+        supplied 'default'.
+        """
+
+        if self.attribute is None:
+            try:
+                f, p, i = find_module(self.module, paths)
+                if f:
+                    f.close()
+                return default
+            except ImportError:
+                return None
+
+        v = get_module_constant(self.module, self.attribute, default, paths)
+
+        if v is not None and v is not default and self.format is not None:
+            return self.format(v)
+
+        return v
+
+    def is_present(self, paths=None):
+        """Return true if dependency is present on 'paths'"""
+        return self.get_version(paths) is not None
+
+    def is_current(self, paths=None):
+        """Return true if dependency is present and up-to-date on 'paths'"""
+        version = self.get_version(paths)
+        if version is None:
+            return False
+        return self.version_ok(version)
+
+
+def maybe_close(f):
+    @contextlib.contextmanager
+    def empty():
+        yield
+        return
+    if not f:
+        return empty()
+
+    return contextlib.closing(f)
+
+
+def get_module_constant(module, symbol, default=-1, paths=None):
+    """Find 'module' by searching 'paths', and extract 'symbol'
+
+    Return 'None' if 'module' does not exist on 'paths', or it does not define
+    'symbol'.  If the module defines 'symbol' as a constant, return the
+    constant.  Otherwise, return 'default'."""
+
+    try:
+        f, path, (suffix, mode, kind) = info = find_module(module, paths)
+    except ImportError:
+        # Module doesn't exist
+        return None
+
+    with maybe_close(f):
+        if kind == PY_COMPILED:
+            f.read(8)  # skip magic & date
+            code = marshal.load(f)
+        elif kind == PY_FROZEN:
+            code = py27compat.get_frozen_object(module, paths)
+        elif kind == PY_SOURCE:
+            code = compile(f.read(), path, 'exec')
+        else:
+            # Not something we can parse; we'll have to import it.  :(
+            imported = py27compat.get_module(module, paths, info)
+            return getattr(imported, symbol, None)
+
+    return extract_constant(code, symbol, default)
+
+
+def extract_constant(code, symbol, default=-1):
+    """Extract the constant value of 'symbol' from 'code'
+
+    If the name 'symbol' is bound to a constant value by the Python code
+    object 'code', return that value.  If 'symbol' is bound to an expression,
+    return 'default'.  Otherwise, return 'None'.
+
+    Return value is based on the first assignment to 'symbol'.  'symbol' must
+    be a global, or at least a non-"fast" local in the code block.  That is,
+    only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol'
+    must be present in 'code.co_names'.
+    """
+    if symbol not in code.co_names:
+        # name's not there, can't possibly be an assignment
+        return None
+
+    name_idx = list(code.co_names).index(symbol)
+
+    STORE_NAME = 90
+    STORE_GLOBAL = 97
+    LOAD_CONST = 100
+
+    const = default
+
+    for byte_code in Bytecode(code):
+        op = byte_code.opcode
+        arg = byte_code.arg
+
+        if op == LOAD_CONST:
+            const = code.co_consts[arg]
+        elif arg == name_idx and (op == STORE_NAME or op == STORE_GLOBAL):
+            return const
+        else:
+            const = default
+
+
+def _update_globals():
+    """
+    Patch the globals to remove the objects not available on some platforms.
+
+    XXX it'd be better to test assertions about bytecode instead.
+    """
+
+    if not sys.platform.startswith('java') and sys.platform != 'cli':
+        return
+    incompatible = 'extract_constant', 'get_module_constant'
+    for name in incompatible:
+        del globals()[name]
+        __all__.remove(name)
+
+
+_update_globals()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dist.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dist.py
new file mode 100644
index 0000000000000000000000000000000000000000..f22429e8e191683da2cc83c7cc5eba205a541988
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/dist.py
@@ -0,0 +1,1274 @@
+# -*- coding: utf-8 -*-
+__all__ = ['Distribution']
+
+import io
+import sys
+import re
+import os
+import warnings
+import numbers
+import distutils.log
+import distutils.core
+import distutils.cmd
+import distutils.dist
+from distutils.util import strtobool
+from distutils.debug import DEBUG
+from distutils.fancy_getopt import translate_longopt
+import itertools
+
+from collections import defaultdict
+from email import message_from_file
+
+from distutils.errors import (
+    DistutilsOptionError, DistutilsPlatformError, DistutilsSetupError,
+)
+from distutils.util import rfc822_escape
+from distutils.version import StrictVersion
+
+from setuptools.extern import six
+from setuptools.extern import packaging
+from setuptools.extern import ordered_set
+from setuptools.extern.six.moves import map, filter, filterfalse
+
+from . import SetuptoolsDeprecationWarning
+
+from setuptools.depends import Require
+from setuptools import windows_support
+from setuptools.monkey import get_unpatched
+from setuptools.config import parse_configuration
+import pkg_resources
+
+__import__('setuptools.extern.packaging.specifiers')
+__import__('setuptools.extern.packaging.version')
+
+
+def _get_unpatched(cls):
+    warnings.warn("Do not call this function", DistDeprecationWarning)
+    return get_unpatched(cls)
+
+
+def get_metadata_version(self):
+    mv = getattr(self, 'metadata_version', None)
+
+    if mv is None:
+        if self.long_description_content_type or self.provides_extras:
+            mv = StrictVersion('2.1')
+        elif (self.maintainer is not None or
+              self.maintainer_email is not None or
+              getattr(self, 'python_requires', None) is not None or
+              self.project_urls):
+            mv = StrictVersion('1.2')
+        elif (self.provides or self.requires or self.obsoletes or
+                self.classifiers or self.download_url):
+            mv = StrictVersion('1.1')
+        else:
+            mv = StrictVersion('1.0')
+
+        self.metadata_version = mv
+
+    return mv
+
+
+def read_pkg_file(self, file):
+    """Reads the metadata values from a file object."""
+    msg = message_from_file(file)
+
+    def _read_field(name):
+        value = msg[name]
+        if value == 'UNKNOWN':
+            return None
+        return value
+
+    def _read_list(name):
+        values = msg.get_all(name, None)
+        if values == []:
+            return None
+        return values
+
+    self.metadata_version = StrictVersion(msg['metadata-version'])
+    self.name = _read_field('name')
+    self.version = _read_field('version')
+    self.description = _read_field('summary')
+    # we are filling author only.
+    self.author = _read_field('author')
+    self.maintainer = None
+    self.author_email = _read_field('author-email')
+    self.maintainer_email = None
+    self.url = _read_field('home-page')
+    self.license = _read_field('license')
+
+    if 'download-url' in msg:
+        self.download_url = _read_field('download-url')
+    else:
+        self.download_url = None
+
+    self.long_description = _read_field('description')
+    self.description = _read_field('summary')
+
+    if 'keywords' in msg:
+        self.keywords = _read_field('keywords').split(',')
+
+    self.platforms = _read_list('platform')
+    self.classifiers = _read_list('classifier')
+
+    # PEP 314 - these fields only exist in 1.1
+    if self.metadata_version == StrictVersion('1.1'):
+        self.requires = _read_list('requires')
+        self.provides = _read_list('provides')
+        self.obsoletes = _read_list('obsoletes')
+    else:
+        self.requires = None
+        self.provides = None
+        self.obsoletes = None
+
+
+# Based on Python 3.5 version
+def write_pkg_file(self, file):
+    """Write the PKG-INFO format data to a file object.
+    """
+    version = self.get_metadata_version()
+
+    if six.PY2:
+        def write_field(key, value):
+            file.write("%s: %s\n" % (key, self._encode_field(value)))
+    else:
+        def write_field(key, value):
+            file.write("%s: %s\n" % (key, value))
+
+    write_field('Metadata-Version', str(version))
+    write_field('Name', self.get_name())
+    write_field('Version', self.get_version())
+    write_field('Summary', self.get_description())
+    write_field('Home-page', self.get_url())
+
+    if version < StrictVersion('1.2'):
+        write_field('Author', self.get_contact())
+        write_field('Author-email', self.get_contact_email())
+    else:
+        optional_fields = (
+            ('Author', 'author'),
+            ('Author-email', 'author_email'),
+            ('Maintainer', 'maintainer'),
+            ('Maintainer-email', 'maintainer_email'),
+        )
+
+        for field, attr in optional_fields:
+            attr_val = getattr(self, attr)
+
+            if attr_val is not None:
+                write_field(field, attr_val)
+
+    write_field('License', self.get_license())
+    if self.download_url:
+        write_field('Download-URL', self.download_url)
+    for project_url in self.project_urls.items():
+        write_field('Project-URL',  '%s, %s' % project_url)
+
+    long_desc = rfc822_escape(self.get_long_description())
+    write_field('Description', long_desc)
+
+    keywords = ','.join(self.get_keywords())
+    if keywords:
+        write_field('Keywords', keywords)
+
+    if version >= StrictVersion('1.2'):
+        for platform in self.get_platforms():
+            write_field('Platform', platform)
+    else:
+        self._write_list(file, 'Platform', self.get_platforms())
+
+    self._write_list(file, 'Classifier', self.get_classifiers())
+
+    # PEP 314
+    self._write_list(file, 'Requires', self.get_requires())
+    self._write_list(file, 'Provides', self.get_provides())
+    self._write_list(file, 'Obsoletes', self.get_obsoletes())
+
+    # Setuptools specific for PEP 345
+    if hasattr(self, 'python_requires'):
+        write_field('Requires-Python', self.python_requires)
+
+    # PEP 566
+    if self.long_description_content_type:
+        write_field(
+            'Description-Content-Type',
+            self.long_description_content_type
+        )
+    if self.provides_extras:
+        for extra in sorted(self.provides_extras):
+            write_field('Provides-Extra', extra)
+
+
+sequence = tuple, list
+
+
+def check_importable(dist, attr, value):
+    try:
+        ep = pkg_resources.EntryPoint.parse('x=' + value)
+        assert not ep.extras
+    except (TypeError, ValueError, AttributeError, AssertionError):
+        raise DistutilsSetupError(
+            "%r must be importable 'module:attrs' string (got %r)"
+            % (attr, value)
+        )
+
+
+def assert_string_list(dist, attr, value):
+    """Verify that value is a string list"""
+    try:
+        # verify that value is a list or tuple to exclude unordered
+        # or single-use iterables
+        assert isinstance(value, (list, tuple))
+        # verify that elements of value are strings
+        assert ''.join(value) != value
+    except (TypeError, ValueError, AttributeError, AssertionError):
+        raise DistutilsSetupError(
+            "%r must be a list of strings (got %r)" % (attr, value)
+        )
+
+
+def check_nsp(dist, attr, value):
+    """Verify that namespace packages are valid"""
+    ns_packages = value
+    assert_string_list(dist, attr, ns_packages)
+    for nsp in ns_packages:
+        if not dist.has_contents_for(nsp):
+            raise DistutilsSetupError(
+                "Distribution contains no modules or packages for " +
+                "namespace package %r" % nsp
+            )
+        parent, sep, child = nsp.rpartition('.')
+        if parent and parent not in ns_packages:
+            distutils.log.warn(
+                "WARNING: %r is declared as a package namespace, but %r"
+                " is not: please correct this in setup.py", nsp, parent
+            )
+
+
+def check_extras(dist, attr, value):
+    """Verify that extras_require mapping is valid"""
+    try:
+        list(itertools.starmap(_check_extra, value.items()))
+    except (TypeError, ValueError, AttributeError):
+        raise DistutilsSetupError(
+            "'extras_require' must be a dictionary whose values are "
+            "strings or lists of strings containing valid project/version "
+            "requirement specifiers."
+        )
+
+
+def _check_extra(extra, reqs):
+    name, sep, marker = extra.partition(':')
+    if marker and pkg_resources.invalid_marker(marker):
+        raise DistutilsSetupError("Invalid environment marker: " + marker)
+    list(pkg_resources.parse_requirements(reqs))
+
+
+def assert_bool(dist, attr, value):
+    """Verify that value is True, False, 0, or 1"""
+    if bool(value) != value:
+        tmpl = "{attr!r} must be a boolean value (got {value!r})"
+        raise DistutilsSetupError(tmpl.format(attr=attr, value=value))
+
+
+def check_requirements(dist, attr, value):
+    """Verify that install_requires is a valid requirements list"""
+    try:
+        list(pkg_resources.parse_requirements(value))
+        if isinstance(value, (dict, set)):
+            raise TypeError("Unordered types are not allowed")
+    except (TypeError, ValueError) as error:
+        tmpl = (
+            "{attr!r} must be a string or list of strings "
+            "containing valid project/version requirement specifiers; {error}"
+        )
+        raise DistutilsSetupError(tmpl.format(attr=attr, error=error))
+
+
+def check_specifier(dist, attr, value):
+    """Verify that value is a valid version specifier"""
+    try:
+        packaging.specifiers.SpecifierSet(value)
+    except packaging.specifiers.InvalidSpecifier as error:
+        tmpl = (
+            "{attr!r} must be a string "
+            "containing valid version specifiers; {error}"
+        )
+        raise DistutilsSetupError(tmpl.format(attr=attr, error=error))
+
+
+def check_entry_points(dist, attr, value):
+    """Verify that entry_points map is parseable"""
+    try:
+        pkg_resources.EntryPoint.parse_map(value)
+    except ValueError as e:
+        raise DistutilsSetupError(e)
+
+
+def check_test_suite(dist, attr, value):
+    if not isinstance(value, six.string_types):
+        raise DistutilsSetupError("test_suite must be a string")
+
+
+def check_package_data(dist, attr, value):
+    """Verify that value is a dictionary of package names to glob lists"""
+    if not isinstance(value, dict):
+        raise DistutilsSetupError(
+            "{!r} must be a dictionary mapping package names to lists of "
+            "string wildcard patterns".format(attr))
+    for k, v in value.items():
+        if not isinstance(k, six.string_types):
+            raise DistutilsSetupError(
+                "keys of {!r} dict must be strings (got {!r})"
+                .format(attr, k)
+            )
+        assert_string_list(dist, 'values of {!r} dict'.format(attr), v)
+
+
+def check_packages(dist, attr, value):
+    for pkgname in value:
+        if not re.match(r'\w+(\.\w+)*', pkgname):
+            distutils.log.warn(
+                "WARNING: %r not a valid package name; please use only "
+                ".-separated package names in setup.py", pkgname
+            )
+
+
+_Distribution = get_unpatched(distutils.core.Distribution)
+
+
+class Distribution(_Distribution):
+    """Distribution with support for features, tests, and package data
+
+    This is an enhanced version of 'distutils.dist.Distribution' that
+    effectively adds the following new optional keyword arguments to 'setup()':
+
+     'install_requires' -- a string or sequence of strings specifying project
+        versions that the distribution requires when installed, in the format
+        used by 'pkg_resources.require()'.  They will be installed
+        automatically when the package is installed.  If you wish to use
+        packages that are not available in PyPI, or want to give your users an
+        alternate download location, you can add a 'find_links' option to the
+        '[easy_install]' section of your project's 'setup.cfg' file, and then
+        setuptools will scan the listed web pages for links that satisfy the
+        requirements.
+
+     'extras_require' -- a dictionary mapping names of optional "extras" to the
+        additional requirement(s) that using those extras incurs. For example,
+        this::
+
+            extras_require = dict(reST = ["docutils>=0.3", "reSTedit"])
+
+        indicates that the distribution can optionally provide an extra
+        capability called "reST", but it can only be used if docutils and
+        reSTedit are installed.  If the user installs your package using
+        EasyInstall and requests one of your extras, the corresponding
+        additional requirements will be installed if needed.
+
+     'features' **deprecated** -- a dictionary mapping option names to
+        'setuptools.Feature'
+        objects.  Features are a portion of the distribution that can be
+        included or excluded based on user options, inter-feature dependencies,
+        and availability on the current system.  Excluded features are omitted
+        from all setup commands, including source and binary distributions, so
+        you can create multiple distributions from the same source tree.
+        Feature names should be valid Python identifiers, except that they may
+        contain the '-' (minus) sign.  Features can be included or excluded
+        via the command line options '--with-X' and '--without-X', where 'X' is
+        the name of the feature.  Whether a feature is included by default, and
+        whether you are allowed to control this from the command line, is
+        determined by the Feature object.  See the 'Feature' class for more
+        information.
+
+     'test_suite' -- the name of a test suite to run for the 'test' command.
+        If the user runs 'python setup.py test', the package will be installed,
+        and the named test suite will be run.  The format is the same as
+        would be used on a 'unittest.py' command line.  That is, it is the
+        dotted name of an object to import and call to generate a test suite.
+
+     'package_data' -- a dictionary mapping package names to lists of filenames
+        or globs to use to find data files contained in the named packages.
+        If the dictionary has filenames or globs listed under '""' (the empty
+        string), those names will be searched for in every package, in addition
+        to any names for the specific package.  Data files found using these
+        names/globs will be installed along with the package, in the same
+        location as the package.  Note that globs are allowed to reference
+        the contents of non-package subdirectories, as long as you use '/' as
+        a path separator.  (Globs are automatically converted to
+        platform-specific paths at runtime.)
+
+    In addition to these new keywords, this class also has several new methods
+    for manipulating the distribution's contents.  For example, the 'include()'
+    and 'exclude()' methods can be thought of as in-place add and subtract
+    commands that add or remove packages, modules, extensions, and so on from
+    the distribution.  They are used by the feature subsystem to configure the
+    distribution for the included and excluded features.
+    """
+
+    _DISTUTILS_UNSUPPORTED_METADATA = {
+        'long_description_content_type': None,
+        'project_urls': dict,
+        'provides_extras': ordered_set.OrderedSet,
+        'license_files': ordered_set.OrderedSet,
+    }
+
+    _patched_dist = None
+
+    def patch_missing_pkg_info(self, attrs):
+        # Fake up a replacement for the data that would normally come from
+        # PKG-INFO, but which might not yet be built if this is a fresh
+        # checkout.
+        #
+        if not attrs or 'name' not in attrs or 'version' not in attrs:
+            return
+        key = pkg_resources.safe_name(str(attrs['name'])).lower()
+        dist = pkg_resources.working_set.by_key.get(key)
+        if dist is not None and not dist.has_metadata('PKG-INFO'):
+            dist._version = pkg_resources.safe_version(str(attrs['version']))
+            self._patched_dist = dist
+
+    def __init__(self, attrs=None):
+        have_package_data = hasattr(self, "package_data")
+        if not have_package_data:
+            self.package_data = {}
+        attrs = attrs or {}
+        if 'features' in attrs or 'require_features' in attrs:
+            Feature.warn_deprecated()
+        self.require_features = []
+        self.features = {}
+        self.dist_files = []
+        # Filter-out setuptools' specific options.
+        self.src_root = attrs.pop("src_root", None)
+        self.patch_missing_pkg_info(attrs)
+        self.dependency_links = attrs.pop('dependency_links', [])
+        self.setup_requires = attrs.pop('setup_requires', [])
+        for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'):
+            vars(self).setdefault(ep.name, None)
+        _Distribution.__init__(self, {
+            k: v for k, v in attrs.items()
+            if k not in self._DISTUTILS_UNSUPPORTED_METADATA
+        })
+
+        # Fill-in missing metadata fields not supported by distutils.
+        # Note some fields may have been set by other tools (e.g. pbr)
+        # above; they are taken preferrentially to setup() arguments
+        for option, default in self._DISTUTILS_UNSUPPORTED_METADATA.items():
+            for source in self.metadata.__dict__, attrs:
+                if option in source:
+                    value = source[option]
+                    break
+            else:
+                value = default() if default else None
+            setattr(self.metadata, option, value)
+
+        if isinstance(self.metadata.version, numbers.Number):
+            # Some people apparently take "version number" too literally :)
+            self.metadata.version = str(self.metadata.version)
+
+        if self.metadata.version is not None:
+            try:
+                ver = packaging.version.Version(self.metadata.version)
+                normalized_version = str(ver)
+                if self.metadata.version != normalized_version:
+                    warnings.warn(
+                        "Normalizing '%s' to '%s'" % (
+                            self.metadata.version,
+                            normalized_version,
+                        )
+                    )
+                    self.metadata.version = normalized_version
+            except (packaging.version.InvalidVersion, TypeError):
+                warnings.warn(
+                    "The version specified (%r) is an invalid version, this "
+                    "may not work as expected with newer versions of "
+                    "setuptools, pip, and PyPI. Please see PEP 440 for more "
+                    "details." % self.metadata.version
+                )
+        self._finalize_requires()
+
+    def _finalize_requires(self):
+        """
+        Set `metadata.python_requires` and fix environment markers
+        in `install_requires` and `extras_require`.
+        """
+        if getattr(self, 'python_requires', None):
+            self.metadata.python_requires = self.python_requires
+
+        if getattr(self, 'extras_require', None):
+            for extra in self.extras_require.keys():
+                # Since this gets called multiple times at points where the
+                # keys have become 'converted' extras, ensure that we are only
+                # truly adding extras we haven't seen before here.
+                extra = extra.split(':')[0]
+                if extra:
+                    self.metadata.provides_extras.add(extra)
+
+        self._convert_extras_requirements()
+        self._move_install_requirements_markers()
+
+    def _convert_extras_requirements(self):
+        """
+        Convert requirements in `extras_require` of the form
+        `"extra": ["barbazquux; {marker}"]` to
+        `"extra:{marker}": ["barbazquux"]`.
+        """
+        spec_ext_reqs = getattr(self, 'extras_require', None) or {}
+        self._tmp_extras_require = defaultdict(list)
+        for section, v in spec_ext_reqs.items():
+            # Do not strip empty sections.
+            self._tmp_extras_require[section]
+            for r in pkg_resources.parse_requirements(v):
+                suffix = self._suffix_for(r)
+                self._tmp_extras_require[section + suffix].append(r)
+
+    @staticmethod
+    def _suffix_for(req):
+        """
+        For a requirement, return the 'extras_require' suffix for
+        that requirement.
+        """
+        return ':' + str(req.marker) if req.marker else ''
+
+    def _move_install_requirements_markers(self):
+        """
+        Move requirements in `install_requires` that are using environment
+        markers `extras_require`.
+        """
+
+        # divide the install_requires into two sets, simple ones still
+        # handled by install_requires and more complex ones handled
+        # by extras_require.
+
+        def is_simple_req(req):
+            return not req.marker
+
+        spec_inst_reqs = getattr(self, 'install_requires', None) or ()
+        inst_reqs = list(pkg_resources.parse_requirements(spec_inst_reqs))
+        simple_reqs = filter(is_simple_req, inst_reqs)
+        complex_reqs = filterfalse(is_simple_req, inst_reqs)
+        self.install_requires = list(map(str, simple_reqs))
+
+        for r in complex_reqs:
+            self._tmp_extras_require[':' + str(r.marker)].append(r)
+        self.extras_require = dict(
+            (k, [str(r) for r in map(self._clean_req, v)])
+            for k, v in self._tmp_extras_require.items()
+        )
+
+    def _clean_req(self, req):
+        """
+        Given a Requirement, remove environment markers and return it.
+        """
+        req.marker = None
+        return req
+
+    def _parse_config_files(self, filenames=None):
+        """
+        Adapted from distutils.dist.Distribution.parse_config_files,
+        this method provides the same functionality in subtly-improved
+        ways.
+        """
+        from setuptools.extern.six.moves.configparser import ConfigParser
+
+        # Ignore install directory options if we have a venv
+        if six.PY3 and sys.prefix != sys.base_prefix:
+            ignore_options = [
+                'install-base', 'install-platbase', 'install-lib',
+                'install-platlib', 'install-purelib', 'install-headers',
+                'install-scripts', 'install-data', 'prefix', 'exec-prefix',
+                'home', 'user', 'root']
+        else:
+            ignore_options = []
+
+        ignore_options = frozenset(ignore_options)
+
+        if filenames is None:
+            filenames = self.find_config_files()
+
+        if DEBUG:
+            self.announce("Distribution.parse_config_files():")
+
+        parser = ConfigParser()
+        for filename in filenames:
+            with io.open(filename, encoding='utf-8') as reader:
+                if DEBUG:
+                    self.announce("  reading {filename}".format(**locals()))
+                (parser.read_file if six.PY3 else parser.readfp)(reader)
+            for section in parser.sections():
+                options = parser.options(section)
+                opt_dict = self.get_option_dict(section)
+
+                for opt in options:
+                    if opt != '__name__' and opt not in ignore_options:
+                        val = self._try_str(parser.get(section, opt))
+                        opt = opt.replace('-', '_')
+                        opt_dict[opt] = (filename, val)
+
+            # Make the ConfigParser forget everything (so we retain
+            # the original filenames that options come from)
+            parser.__init__()
+
+        # If there was a "global" section in the config file, use it
+        # to set Distribution options.
+
+        if 'global' in self.command_options:
+            for (opt, (src, val)) in self.command_options['global'].items():
+                alias = self.negative_opt.get(opt)
+                try:
+                    if alias:
+                        setattr(self, alias, not strtobool(val))
+                    elif opt in ('verbose', 'dry_run'):  # ugh!
+                        setattr(self, opt, strtobool(val))
+                    else:
+                        setattr(self, opt, val)
+                except ValueError as msg:
+                    raise DistutilsOptionError(msg)
+
+    @staticmethod
+    def _try_str(val):
+        """
+        On Python 2, much of distutils relies on string values being of
+        type 'str' (bytes) and not unicode text. If the value can be safely
+        encoded to bytes using the default encoding, prefer that.
+
+        Why the default encoding? Because that value can be implicitly
+        decoded back to text if needed.
+
+        Ref #1653
+        """
+        if six.PY3:
+            return val
+        try:
+            return val.encode()
+        except UnicodeEncodeError:
+            pass
+        return val
+
+    def _set_command_options(self, command_obj, option_dict=None):
+        """
+        Set the options for 'command_obj' from 'option_dict'.  Basically
+        this means copying elements of a dictionary ('option_dict') to
+        attributes of an instance ('command').
+
+        'command_obj' must be a Command instance.  If 'option_dict' is not
+        supplied, uses the standard option dictionary for this command
+        (from 'self.command_options').
+
+        (Adopted from distutils.dist.Distribution._set_command_options)
+        """
+        command_name = command_obj.get_command_name()
+        if option_dict is None:
+            option_dict = self.get_option_dict(command_name)
+
+        if DEBUG:
+            self.announce("  setting options for '%s' command:" % command_name)
+        for (option, (source, value)) in option_dict.items():
+            if DEBUG:
+                self.announce("    %s = %s (from %s)" % (option, value,
+                                                         source))
+            try:
+                bool_opts = [translate_longopt(o)
+                             for o in command_obj.boolean_options]
+            except AttributeError:
+                bool_opts = []
+            try:
+                neg_opt = command_obj.negative_opt
+            except AttributeError:
+                neg_opt = {}
+
+            try:
+                is_string = isinstance(value, six.string_types)
+                if option in neg_opt and is_string:
+                    setattr(command_obj, neg_opt[option], not strtobool(value))
+                elif option in bool_opts and is_string:
+                    setattr(command_obj, option, strtobool(value))
+                elif hasattr(command_obj, option):
+                    setattr(command_obj, option, value)
+                else:
+                    raise DistutilsOptionError(
+                        "error in %s: command '%s' has no such option '%s'"
+                        % (source, command_name, option))
+            except ValueError as msg:
+                raise DistutilsOptionError(msg)
+
+    def parse_config_files(self, filenames=None, ignore_option_errors=False):
+        """Parses configuration files from various levels
+        and loads configuration.
+
+        """
+        self._parse_config_files(filenames=filenames)
+
+        parse_configuration(self, self.command_options,
+                            ignore_option_errors=ignore_option_errors)
+        self._finalize_requires()
+
+    def parse_command_line(self):
+        """Process features after parsing command line options"""
+        result = _Distribution.parse_command_line(self)
+        if self.features:
+            self._finalize_features()
+        return result
+
+    def _feature_attrname(self, name):
+        """Convert feature name to corresponding option attribute name"""
+        return 'with_' + name.replace('-', '_')
+
+    def fetch_build_eggs(self, requires):
+        """Resolve pre-setup requirements"""
+        resolved_dists = pkg_resources.working_set.resolve(
+            pkg_resources.parse_requirements(requires),
+            installer=self.fetch_build_egg,
+            replace_conflicting=True,
+        )
+        for dist in resolved_dists:
+            pkg_resources.working_set.add(dist, replace=True)
+        return resolved_dists
+
+    def finalize_options(self):
+        """
+        Allow plugins to apply arbitrary operations to the
+        distribution. Each hook may optionally define a 'order'
+        to influence the order of execution. Smaller numbers
+        go first and the default is 0.
+        """
+        hook_key = 'setuptools.finalize_distribution_options'
+
+        def by_order(hook):
+            return getattr(hook, 'order', 0)
+        eps = pkg_resources.iter_entry_points(hook_key)
+        for ep in sorted(eps, key=by_order):
+            ep.load()(self)
+
+    def _finalize_setup_keywords(self):
+        for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'):
+            value = getattr(self, ep.name, None)
+            if value is not None:
+                ep.require(installer=self.fetch_build_egg)
+                ep.load()(self, ep.name, value)
+
+    def _finalize_2to3_doctests(self):
+        if getattr(self, 'convert_2to3_doctests', None):
+            # XXX may convert to set here when we can rely on set being builtin
+            self.convert_2to3_doctests = [
+                os.path.abspath(p)
+                for p in self.convert_2to3_doctests
+            ]
+        else:
+            self.convert_2to3_doctests = []
+
+    def get_egg_cache_dir(self):
+        egg_cache_dir = os.path.join(os.curdir, '.eggs')
+        if not os.path.exists(egg_cache_dir):
+            os.mkdir(egg_cache_dir)
+            windows_support.hide_file(egg_cache_dir)
+            readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt')
+            with open(readme_txt_filename, 'w') as f:
+                f.write('This directory contains eggs that were downloaded '
+                        'by setuptools to build, test, and run plug-ins.\n\n')
+                f.write('This directory caches those eggs to prevent '
+                        'repeated downloads.\n\n')
+                f.write('However, it is safe to delete this directory.\n\n')
+
+        return egg_cache_dir
+
+    def fetch_build_egg(self, req):
+        """Fetch an egg needed for building"""
+        from setuptools.installer import fetch_build_egg
+        return fetch_build_egg(self, req)
+
+    def _finalize_feature_opts(self):
+        """Add --with-X/--without-X options based on optional features"""
+
+        if not self.features:
+            return
+
+        go = []
+        no = self.negative_opt.copy()
+
+        for name, feature in self.features.items():
+            self._set_feature(name, None)
+            feature.validate(self)
+
+            if feature.optional:
+                descr = feature.description
+                incdef = ' (default)'
+                excdef = ''
+                if not feature.include_by_default():
+                    excdef, incdef = incdef, excdef
+
+                new = (
+                    ('with-' + name, None, 'include ' + descr + incdef),
+                    ('without-' + name, None, 'exclude ' + descr + excdef),
+                )
+                go.extend(new)
+                no['without-' + name] = 'with-' + name
+
+        self.global_options = self.feature_options = go + self.global_options
+        self.negative_opt = self.feature_negopt = no
+
+    def _finalize_features(self):
+        """Add/remove features and resolve dependencies between them"""
+
+        # First, flag all the enabled items (and thus their dependencies)
+        for name, feature in self.features.items():
+            enabled = self.feature_is_included(name)
+            if enabled or (enabled is None and feature.include_by_default()):
+                feature.include_in(self)
+                self._set_feature(name, 1)
+
+        # Then disable the rest, so that off-by-default features don't
+        # get flagged as errors when they're required by an enabled feature
+        for name, feature in self.features.items():
+            if not self.feature_is_included(name):
+                feature.exclude_from(self)
+                self._set_feature(name, 0)
+
+    def get_command_class(self, command):
+        """Pluggable version of get_command_class()"""
+        if command in self.cmdclass:
+            return self.cmdclass[command]
+
+        eps = pkg_resources.iter_entry_points('distutils.commands', command)
+        for ep in eps:
+            ep.require(installer=self.fetch_build_egg)
+            self.cmdclass[command] = cmdclass = ep.load()
+            return cmdclass
+        else:
+            return _Distribution.get_command_class(self, command)
+
+    def print_commands(self):
+        for ep in pkg_resources.iter_entry_points('distutils.commands'):
+            if ep.name not in self.cmdclass:
+                # don't require extras as the commands won't be invoked
+                cmdclass = ep.resolve()
+                self.cmdclass[ep.name] = cmdclass
+        return _Distribution.print_commands(self)
+
+    def get_command_list(self):
+        for ep in pkg_resources.iter_entry_points('distutils.commands'):
+            if ep.name not in self.cmdclass:
+                # don't require extras as the commands won't be invoked
+                cmdclass = ep.resolve()
+                self.cmdclass[ep.name] = cmdclass
+        return _Distribution.get_command_list(self)
+
+    def _set_feature(self, name, status):
+        """Set feature's inclusion status"""
+        setattr(self, self._feature_attrname(name), status)
+
+    def feature_is_included(self, name):
+        """Return 1 if feature is included, 0 if excluded, 'None' if unknown"""
+        return getattr(self, self._feature_attrname(name))
+
+    def include_feature(self, name):
+        """Request inclusion of feature named 'name'"""
+
+        if self.feature_is_included(name) == 0:
+            descr = self.features[name].description
+            raise DistutilsOptionError(
+                descr + " is required, but was excluded or is not available"
+            )
+        self.features[name].include_in(self)
+        self._set_feature(name, 1)
+
+    def include(self, **attrs):
+        """Add items to distribution that are named in keyword arguments
+
+        For example, 'dist.include(py_modules=["x"])' would add 'x' to
+        the distribution's 'py_modules' attribute, if it was not already
+        there.
+
+        Currently, this method only supports inclusion for attributes that are
+        lists or tuples.  If you need to add support for adding to other
+        attributes in this or a subclass, you can add an '_include_X' method,
+        where 'X' is the name of the attribute.  The method will be called with
+        the value passed to 'include()'.  So, 'dist.include(foo={"bar":"baz"})'
+        will try to call 'dist._include_foo({"bar":"baz"})', which can then
+        handle whatever special inclusion logic is needed.
+        """
+        for k, v in attrs.items():
+            include = getattr(self, '_include_' + k, None)
+            if include:
+                include(v)
+            else:
+                self._include_misc(k, v)
+
+    def exclude_package(self, package):
+        """Remove packages, modules, and extensions in named package"""
+
+        pfx = package + '.'
+        if self.packages:
+            self.packages = [
+                p for p in self.packages
+                if p != package and not p.startswith(pfx)
+            ]
+
+        if self.py_modules:
+            self.py_modules = [
+                p for p in self.py_modules
+                if p != package and not p.startswith(pfx)
+            ]
+
+        if self.ext_modules:
+            self.ext_modules = [
+                p for p in self.ext_modules
+                if p.name != package and not p.name.startswith(pfx)
+            ]
+
+    def has_contents_for(self, package):
+        """Return true if 'exclude_package(package)' would do something"""
+
+        pfx = package + '.'
+
+        for p in self.iter_distribution_names():
+            if p == package or p.startswith(pfx):
+                return True
+
+    def _exclude_misc(self, name, value):
+        """Handle 'exclude()' for list/tuple attrs without a special handler"""
+        if not isinstance(value, sequence):
+            raise DistutilsSetupError(
+                "%s: setting must be a list or tuple (%r)" % (name, value)
+            )
+        try:
+            old = getattr(self, name)
+        except AttributeError:
+            raise DistutilsSetupError(
+                "%s: No such distribution setting" % name
+            )
+        if old is not None and not isinstance(old, sequence):
+            raise DistutilsSetupError(
+                name + ": this setting cannot be changed via include/exclude"
+            )
+        elif old:
+            setattr(self, name, [item for item in old if item not in value])
+
+    def _include_misc(self, name, value):
+        """Handle 'include()' for list/tuple attrs without a special handler"""
+
+        if not isinstance(value, sequence):
+            raise DistutilsSetupError(
+                "%s: setting must be a list (%r)" % (name, value)
+            )
+        try:
+            old = getattr(self, name)
+        except AttributeError:
+            raise DistutilsSetupError(
+                "%s: No such distribution setting" % name
+            )
+        if old is None:
+            setattr(self, name, value)
+        elif not isinstance(old, sequence):
+            raise DistutilsSetupError(
+                name + ": this setting cannot be changed via include/exclude"
+            )
+        else:
+            new = [item for item in value if item not in old]
+            setattr(self, name, old + new)
+
+    def exclude(self, **attrs):
+        """Remove items from distribution that are named in keyword arguments
+
+        For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from
+        the distribution's 'py_modules' attribute.  Excluding packages uses
+        the 'exclude_package()' method, so all of the package's contained
+        packages, modules, and extensions are also excluded.
+
+        Currently, this method only supports exclusion from attributes that are
+        lists or tuples.  If you need to add support for excluding from other
+        attributes in this or a subclass, you can add an '_exclude_X' method,
+        where 'X' is the name of the attribute.  The method will be called with
+        the value passed to 'exclude()'.  So, 'dist.exclude(foo={"bar":"baz"})'
+        will try to call 'dist._exclude_foo({"bar":"baz"})', which can then
+        handle whatever special exclusion logic is needed.
+        """
+        for k, v in attrs.items():
+            exclude = getattr(self, '_exclude_' + k, None)
+            if exclude:
+                exclude(v)
+            else:
+                self._exclude_misc(k, v)
+
+    def _exclude_packages(self, packages):
+        if not isinstance(packages, sequence):
+            raise DistutilsSetupError(
+                "packages: setting must be a list or tuple (%r)" % (packages,)
+            )
+        list(map(self.exclude_package, packages))
+
+    def _parse_command_opts(self, parser, args):
+        # Remove --with-X/--without-X options when processing command args
+        self.global_options = self.__class__.global_options
+        self.negative_opt = self.__class__.negative_opt
+
+        # First, expand any aliases
+        command = args[0]
+        aliases = self.get_option_dict('aliases')
+        while command in aliases:
+            src, alias = aliases[command]
+            del aliases[command]  # ensure each alias can expand only once!
+            import shlex
+            args[:1] = shlex.split(alias, True)
+            command = args[0]
+
+        nargs = _Distribution._parse_command_opts(self, parser, args)
+
+        # Handle commands that want to consume all remaining arguments
+        cmd_class = self.get_command_class(command)
+        if getattr(cmd_class, 'command_consumes_arguments', None):
+            self.get_option_dict(command)['args'] = ("command line", nargs)
+            if nargs is not None:
+                return []
+
+        return nargs
+
+    def get_cmdline_options(self):
+        """Return a '{cmd: {opt:val}}' map of all command-line options
+
+        Option names are all long, but do not include the leading '--', and
+        contain dashes rather than underscores.  If the option doesn't take
+        an argument (e.g. '--quiet'), the 'val' is 'None'.
+
+        Note that options provided by config files are intentionally excluded.
+        """
+
+        d = {}
+
+        for cmd, opts in self.command_options.items():
+
+            for opt, (src, val) in opts.items():
+
+                if src != "command line":
+                    continue
+
+                opt = opt.replace('_', '-')
+
+                if val == 0:
+                    cmdobj = self.get_command_obj(cmd)
+                    neg_opt = self.negative_opt.copy()
+                    neg_opt.update(getattr(cmdobj, 'negative_opt', {}))
+                    for neg, pos in neg_opt.items():
+                        if pos == opt:
+                            opt = neg
+                            val = None
+                            break
+                    else:
+                        raise AssertionError("Shouldn't be able to get here")
+
+                elif val == 1:
+                    val = None
+
+                d.setdefault(cmd, {})[opt] = val
+
+        return d
+
+    def iter_distribution_names(self):
+        """Yield all packages, modules, and extension names in distribution"""
+
+        for pkg in self.packages or ():
+            yield pkg
+
+        for module in self.py_modules or ():
+            yield module
+
+        for ext in self.ext_modules or ():
+            if isinstance(ext, tuple):
+                name, buildinfo = ext
+            else:
+                name = ext.name
+            if name.endswith('module'):
+                name = name[:-6]
+            yield name
+
+    def handle_display_options(self, option_order):
+        """If there were any non-global "display-only" options
+        (--help-commands or the metadata display options) on the command
+        line, display the requested info and return true; else return
+        false.
+        """
+        import sys
+
+        if six.PY2 or self.help_commands:
+            return _Distribution.handle_display_options(self, option_order)
+
+        # Stdout may be StringIO (e.g. in tests)
+        if not isinstance(sys.stdout, io.TextIOWrapper):
+            return _Distribution.handle_display_options(self, option_order)
+
+        # Don't wrap stdout if utf-8 is already the encoding. Provides
+        #  workaround for #334.
+        if sys.stdout.encoding.lower() in ('utf-8', 'utf8'):
+            return _Distribution.handle_display_options(self, option_order)
+
+        # Print metadata in UTF-8 no matter the platform
+        encoding = sys.stdout.encoding
+        errors = sys.stdout.errors
+        newline = sys.platform != 'win32' and '\n' or None
+        line_buffering = sys.stdout.line_buffering
+
+        sys.stdout = io.TextIOWrapper(
+            sys.stdout.detach(), 'utf-8', errors, newline, line_buffering)
+        try:
+            return _Distribution.handle_display_options(self, option_order)
+        finally:
+            sys.stdout = io.TextIOWrapper(
+                sys.stdout.detach(), encoding, errors, newline, line_buffering)
+
+
+class Feature:
+    """
+    **deprecated** -- The `Feature` facility was never completely implemented
+    or supported, `has reported issues
+    <https://github.com/pypa/setuptools/issues/58>`_ and will be removed in
+    a future version.
+
+    A subset of the distribution that can be excluded if unneeded/wanted
+
+    Features are created using these keyword arguments:
+
+      'description' -- a short, human readable description of the feature, to
+         be used in error messages, and option help messages.
+
+      'standard' -- if true, the feature is included by default if it is
+         available on the current system.  Otherwise, the feature is only
+         included if requested via a command line '--with-X' option, or if
+         another included feature requires it.  The default setting is 'False'.
+
+      'available' -- if true, the feature is available for installation on the
+         current system.  The default setting is 'True'.
+
+      'optional' -- if true, the feature's inclusion can be controlled from the
+         command line, using the '--with-X' or '--without-X' options.  If
+         false, the feature's inclusion status is determined automatically,
+         based on 'availabile', 'standard', and whether any other feature
+         requires it.  The default setting is 'True'.
+
+      'require_features' -- a string or sequence of strings naming features
+         that should also be included if this feature is included.  Defaults to
+         empty list.  May also contain 'Require' objects that should be
+         added/removed from the distribution.
+
+      'remove' -- a string or list of strings naming packages to be removed
+         from the distribution if this feature is *not* included.  If the
+         feature *is* included, this argument is ignored.  This argument exists
+         to support removing features that "crosscut" a distribution, such as
+         defining a 'tests' feature that removes all the 'tests' subpackages
+         provided by other features.  The default for this argument is an empty
+         list.  (Note: the named package(s) or modules must exist in the base
+         distribution when the 'setup()' function is initially called.)
+
+      other keywords -- any other keyword arguments are saved, and passed to
+         the distribution's 'include()' and 'exclude()' methods when the
+         feature is included or excluded, respectively.  So, for example, you
+         could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be
+         added or removed from the distribution as appropriate.
+
+    A feature must include at least one 'requires', 'remove', or other
+    keyword argument.  Otherwise, it can't affect the distribution in any way.
+    Note also that you can subclass 'Feature' to create your own specialized
+    feature types that modify the distribution in other ways when included or
+    excluded.  See the docstrings for the various methods here for more detail.
+    Aside from the methods, the only feature attributes that distributions look
+    at are 'description' and 'optional'.
+    """
+
+    @staticmethod
+    def warn_deprecated():
+        msg = (
+            "Features are deprecated and will be removed in a future "
+            "version. See https://github.com/pypa/setuptools/issues/65."
+        )
+        warnings.warn(msg, DistDeprecationWarning, stacklevel=3)
+
+    def __init__(
+            self, description, standard=False, available=True,
+            optional=True, require_features=(), remove=(), **extras):
+        self.warn_deprecated()
+
+        self.description = description
+        self.standard = standard
+        self.available = available
+        self.optional = optional
+        if isinstance(require_features, (str, Require)):
+            require_features = require_features,
+
+        self.require_features = [
+            r for r in require_features if isinstance(r, str)
+        ]
+        er = [r for r in require_features if not isinstance(r, str)]
+        if er:
+            extras['require_features'] = er
+
+        if isinstance(remove, str):
+            remove = remove,
+        self.remove = remove
+        self.extras = extras
+
+        if not remove and not require_features and not extras:
+            raise DistutilsSetupError(
+                "Feature %s: must define 'require_features', 'remove', or "
+                "at least one of 'packages', 'py_modules', etc."
+            )
+
+    def include_by_default(self):
+        """Should this feature be included by default?"""
+        return self.available and self.standard
+
+    def include_in(self, dist):
+        """Ensure feature and its requirements are included in distribution
+
+        You may override this in a subclass to perform additional operations on
+        the distribution.  Note that this method may be called more than once
+        per feature, and so should be idempotent.
+
+        """
+
+        if not self.available:
+            raise DistutilsPlatformError(
+                self.description + " is required, "
+                "but is not available on this platform"
+            )
+
+        dist.include(**self.extras)
+
+        for f in self.require_features:
+            dist.include_feature(f)
+
+    def exclude_from(self, dist):
+        """Ensure feature is excluded from distribution
+
+        You may override this in a subclass to perform additional operations on
+        the distribution.  This method will be called at most once per
+        feature, and only after all included features have been asked to
+        include themselves.
+        """
+
+        dist.exclude(**self.extras)
+
+        if self.remove:
+            for item in self.remove:
+                dist.exclude_package(item)
+
+    def validate(self, dist):
+        """Verify that feature makes sense in context of distribution
+
+        This method is called by the distribution just before it parses its
+        command line.  It checks to ensure that the 'remove' attribute, if any,
+        contains only valid package/module names that are present in the base
+        distribution when 'setup()' is called.  You may override it in a
+        subclass to perform any other required validation of the feature
+        against a target distribution.
+        """
+
+        for item in self.remove:
+            if not dist.has_contents_for(item):
+                raise DistutilsSetupError(
+                    "%s wants to be able to remove %s, but the distribution"
+                    " doesn't contain any packages or modules under %s"
+                    % (self.description, item, item)
+                )
+
+
+class DistDeprecationWarning(SetuptoolsDeprecationWarning):
+    """Class for warning about deprecations in dist in
+    setuptools. Not ignored by default, unlike DeprecationWarning."""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/errors.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/errors.py
new file mode 100644
index 0000000000000000000000000000000000000000..2701747f56cc77845159f2c5fee2d0ce114259af
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/errors.py
@@ -0,0 +1,16 @@
+"""setuptools.errors
+
+Provides exceptions used by setuptools modules.
+"""
+
+from distutils.errors import DistutilsError
+
+
+class RemovedCommandError(DistutilsError, RuntimeError):
+    """Error used for commands that have been removed in setuptools.
+
+    Since ``setuptools`` is built on ``distutils``, simply removing a command
+    from ``setuptools`` will make the behavior fall back to ``distutils``; this
+    error is raised if a command exists in ``distutils`` but has been actively
+    removed in ``setuptools``.
+    """
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extension.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extension.py
new file mode 100644
index 0000000000000000000000000000000000000000..29468894f828128f4c36660167dd1f9e68e584be
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extension.py
@@ -0,0 +1,57 @@
+import re
+import functools
+import distutils.core
+import distutils.errors
+import distutils.extension
+
+from setuptools.extern.six.moves import map
+
+from .monkey import get_unpatched
+
+
+def _have_cython():
+    """
+    Return True if Cython can be imported.
+    """
+    cython_impl = 'Cython.Distutils.build_ext'
+    try:
+        # from (cython_impl) import build_ext
+        __import__(cython_impl, fromlist=['build_ext']).build_ext
+        return True
+    except Exception:
+        pass
+    return False
+
+
+# for compatibility
+have_pyrex = _have_cython
+
+_Extension = get_unpatched(distutils.core.Extension)
+
+
+class Extension(_Extension):
+    """Extension that uses '.c' files in place of '.pyx' files"""
+
+    def __init__(self, name, sources, *args, **kw):
+        # The *args is needed for compatibility as calls may use positional
+        # arguments. py_limited_api may be set only via keyword.
+        self.py_limited_api = kw.pop("py_limited_api", False)
+        _Extension.__init__(self, name, sources, *args, **kw)
+
+    def _convert_pyx_sources_to_lang(self):
+        """
+        Replace sources with .pyx extensions to sources with the target
+        language extension. This mechanism allows language authors to supply
+        pre-converted sources but to prefer the .pyx sources.
+        """
+        if _have_cython():
+            # the build has Cython, so allow it to compile the .pyx files
+            return
+        lang = self.language or ''
+        target_ext = '.cpp' if lang.lower() == 'c++' else '.c'
+        sub = functools.partial(re.sub, '.pyx$', target_ext)
+        self.sources = list(map(sub, self.sources))
+
+
+class Library(Extension):
+    """Just like a regular Extension, but built as a library instead"""
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e8c616f910bb9bb874c3d44f1efe5239ecb8f621
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/extern/__init__.py
@@ -0,0 +1,73 @@
+import sys
+
+
+class VendorImporter:
+    """
+    A PEP 302 meta path importer for finding optionally-vendored
+    or otherwise naturally-installed packages from root_name.
+    """
+
+    def __init__(self, root_name, vendored_names=(), vendor_pkg=None):
+        self.root_name = root_name
+        self.vendored_names = set(vendored_names)
+        self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor')
+
+    @property
+    def search_path(self):
+        """
+        Search first the vendor package then as a natural package.
+        """
+        yield self.vendor_pkg + '.'
+        yield ''
+
+    def find_module(self, fullname, path=None):
+        """
+        Return self when fullname starts with root_name and the
+        target module is one vendored through this importer.
+        """
+        root, base, target = fullname.partition(self.root_name + '.')
+        if root:
+            return
+        if not any(map(target.startswith, self.vendored_names)):
+            return
+        return self
+
+    def load_module(self, fullname):
+        """
+        Iterate over the search path to locate and load fullname.
+        """
+        root, base, target = fullname.partition(self.root_name + '.')
+        for prefix in self.search_path:
+            try:
+                extant = prefix + target
+                __import__(extant)
+                mod = sys.modules[extant]
+                sys.modules[fullname] = mod
+                # mysterious hack:
+                # Remove the reference to the extant package/module
+                # on later Python versions to cause relative imports
+                # in the vendor package to resolve the same modules
+                # as those going through this importer.
+                if sys.version_info >= (3, ):
+                    del sys.modules[extant]
+                return mod
+            except ImportError:
+                pass
+        else:
+            raise ImportError(
+                "The '{target}' package is required; "
+                "normally this is bundled with this package so if you get "
+                "this warning, consult the packager of your "
+                "distribution.".format(**locals())
+            )
+
+    def install(self):
+        """
+        Install this importer into sys.meta_path if not already present.
+        """
+        if self not in sys.meta_path:
+            sys.meta_path.append(self)
+
+
+names = 'six', 'packaging', 'pyparsing', 'ordered_set',
+VendorImporter(__name__, names, 'setuptools._vendor').install()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/glob.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/glob.py
new file mode 100644
index 0000000000000000000000000000000000000000..9d7cbc5da68da8605d271b9314befb206b87bca6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/glob.py
@@ -0,0 +1,174 @@
+"""
+Filename globbing utility. Mostly a copy of `glob` from Python 3.5.
+
+Changes include:
+ * `yield from` and PEP3102 `*` removed.
+ * Hidden files are not ignored.
+"""
+
+import os
+import re
+import fnmatch
+
+__all__ = ["glob", "iglob", "escape"]
+
+
+def glob(pathname, recursive=False):
+    """Return a list of paths matching a pathname pattern.
+
+    The pattern may contain simple shell-style wildcards a la
+    fnmatch. However, unlike fnmatch, filenames starting with a
+    dot are special cases that are not matched by '*' and '?'
+    patterns.
+
+    If recursive is true, the pattern '**' will match any files and
+    zero or more directories and subdirectories.
+    """
+    return list(iglob(pathname, recursive=recursive))
+
+
+def iglob(pathname, recursive=False):
+    """Return an iterator which yields the paths matching a pathname pattern.
+
+    The pattern may contain simple shell-style wildcards a la
+    fnmatch. However, unlike fnmatch, filenames starting with a
+    dot are special cases that are not matched by '*' and '?'
+    patterns.
+
+    If recursive is true, the pattern '**' will match any files and
+    zero or more directories and subdirectories.
+    """
+    it = _iglob(pathname, recursive)
+    if recursive and _isrecursive(pathname):
+        s = next(it)  # skip empty string
+        assert not s
+    return it
+
+
+def _iglob(pathname, recursive):
+    dirname, basename = os.path.split(pathname)
+    if not has_magic(pathname):
+        if basename:
+            if os.path.lexists(pathname):
+                yield pathname
+        else:
+            # Patterns ending with a slash should match only directories
+            if os.path.isdir(dirname):
+                yield pathname
+        return
+    if not dirname:
+        if recursive and _isrecursive(basename):
+            for x in glob2(dirname, basename):
+                yield x
+        else:
+            for x in glob1(dirname, basename):
+                yield x
+        return
+    # `os.path.split()` returns the argument itself as a dirname if it is a
+    # drive or UNC path.  Prevent an infinite recursion if a drive or UNC path
+    # contains magic characters (i.e. r'\\?\C:').
+    if dirname != pathname and has_magic(dirname):
+        dirs = _iglob(dirname, recursive)
+    else:
+        dirs = [dirname]
+    if has_magic(basename):
+        if recursive and _isrecursive(basename):
+            glob_in_dir = glob2
+        else:
+            glob_in_dir = glob1
+    else:
+        glob_in_dir = glob0
+    for dirname in dirs:
+        for name in glob_in_dir(dirname, basename):
+            yield os.path.join(dirname, name)
+
+
+# These 2 helper functions non-recursively glob inside a literal directory.
+# They return a list of basenames. `glob1` accepts a pattern while `glob0`
+# takes a literal basename (so it only has to check for its existence).
+
+
+def glob1(dirname, pattern):
+    if not dirname:
+        if isinstance(pattern, bytes):
+            dirname = os.curdir.encode('ASCII')
+        else:
+            dirname = os.curdir
+    try:
+        names = os.listdir(dirname)
+    except OSError:
+        return []
+    return fnmatch.filter(names, pattern)
+
+
+def glob0(dirname, basename):
+    if not basename:
+        # `os.path.split()` returns an empty basename for paths ending with a
+        # directory separator.  'q*x/' should match only directories.
+        if os.path.isdir(dirname):
+            return [basename]
+    else:
+        if os.path.lexists(os.path.join(dirname, basename)):
+            return [basename]
+    return []
+
+
+# This helper function recursively yields relative pathnames inside a literal
+# directory.
+
+
+def glob2(dirname, pattern):
+    assert _isrecursive(pattern)
+    yield pattern[:0]
+    for x in _rlistdir(dirname):
+        yield x
+
+
+# Recursively yields relative pathnames inside a literal directory.
+def _rlistdir(dirname):
+    if not dirname:
+        if isinstance(dirname, bytes):
+            dirname = os.curdir.encode('ASCII')
+        else:
+            dirname = os.curdir
+    try:
+        names = os.listdir(dirname)
+    except os.error:
+        return
+    for x in names:
+        yield x
+        path = os.path.join(dirname, x) if dirname else x
+        for y in _rlistdir(path):
+            yield os.path.join(x, y)
+
+
+magic_check = re.compile('([*?[])')
+magic_check_bytes = re.compile(b'([*?[])')
+
+
+def has_magic(s):
+    if isinstance(s, bytes):
+        match = magic_check_bytes.search(s)
+    else:
+        match = magic_check.search(s)
+    return match is not None
+
+
+def _isrecursive(pattern):
+    if isinstance(pattern, bytes):
+        return pattern == b'**'
+    else:
+        return pattern == '**'
+
+
+def escape(pathname):
+    """Escape all special characters.
+    """
+    # Escaping is done by wrapping any of "*?[" between square brackets.
+    # Metacharacters do not work in the drive part and shouldn't be escaped.
+    drive, pathname = os.path.splitdrive(pathname)
+    if isinstance(pathname, bytes):
+        pathname = magic_check_bytes.sub(br'[\1]', pathname)
+    else:
+        pathname = magic_check.sub(r'[\1]', pathname)
+    return drive + pathname
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-32.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-32.exe
new file mode 100644
index 0000000000000000000000000000000000000000..f8d3509653ba8f80ca7f3aa7f95616142ba83a94
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-32.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-64.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-64.exe
new file mode 100644
index 0000000000000000000000000000000000000000..330c51a5dde15a0bb610a48cd0ca11770c914dae
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui-64.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui.exe b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui.exe
new file mode 100644
index 0000000000000000000000000000000000000000..f8d3509653ba8f80ca7f3aa7f95616142ba83a94
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/gui.exe differ
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/installer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/installer.py
new file mode 100644
index 0000000000000000000000000000000000000000..9f8be2ef8427651e3b0fbef497535e152dde66b1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/installer.py
@@ -0,0 +1,150 @@
+import glob
+import os
+import subprocess
+import sys
+from distutils import log
+from distutils.errors import DistutilsError
+
+import pkg_resources
+from setuptools.command.easy_install import easy_install
+from setuptools.extern import six
+from setuptools.wheel import Wheel
+
+from .py31compat import TemporaryDirectory
+
+
+def _fixup_find_links(find_links):
+    """Ensure find-links option end-up being a list of strings."""
+    if isinstance(find_links, six.string_types):
+        return find_links.split()
+    assert isinstance(find_links, (tuple, list))
+    return find_links
+
+
+def _legacy_fetch_build_egg(dist, req):
+    """Fetch an egg needed for building.
+
+    Legacy path using EasyInstall.
+    """
+    tmp_dist = dist.__class__({'script_args': ['easy_install']})
+    opts = tmp_dist.get_option_dict('easy_install')
+    opts.clear()
+    opts.update(
+        (k, v)
+        for k, v in dist.get_option_dict('easy_install').items()
+        if k in (
+            # don't use any other settings
+            'find_links', 'site_dirs', 'index_url',
+            'optimize', 'site_dirs', 'allow_hosts',
+        ))
+    if dist.dependency_links:
+        links = dist.dependency_links[:]
+        if 'find_links' in opts:
+            links = _fixup_find_links(opts['find_links'][1]) + links
+        opts['find_links'] = ('setup', links)
+    install_dir = dist.get_egg_cache_dir()
+    cmd = easy_install(
+        tmp_dist, args=["x"], install_dir=install_dir,
+        exclude_scripts=True,
+        always_copy=False, build_directory=None, editable=False,
+        upgrade=False, multi_version=True, no_report=True, user=False
+    )
+    cmd.ensure_finalized()
+    return cmd.easy_install(req)
+
+
+def fetch_build_egg(dist, req):
+    """Fetch an egg needed for building.
+
+    Use pip/wheel to fetch/build a wheel."""
+    # Check pip is available.
+    try:
+        pkg_resources.get_distribution('pip')
+    except pkg_resources.DistributionNotFound:
+        dist.announce(
+            'WARNING: The pip package is not available, falling back '
+            'to EasyInstall for handling setup_requires/test_requires; '
+            'this is deprecated and will be removed in a future version.'
+            , log.WARN
+        )
+        return _legacy_fetch_build_egg(dist, req)
+    # Warn if wheel is not.
+    try:
+        pkg_resources.get_distribution('wheel')
+    except pkg_resources.DistributionNotFound:
+        dist.announce('WARNING: The wheel package is not available.', log.WARN)
+    # Ignore environment markers; if supplied, it is required.
+    req = strip_marker(req)
+    # Take easy_install options into account, but do not override relevant
+    # pip environment variables (like PIP_INDEX_URL or PIP_QUIET); they'll
+    # take precedence.
+    opts = dist.get_option_dict('easy_install')
+    if 'allow_hosts' in opts:
+        raise DistutilsError('the `allow-hosts` option is not supported '
+                             'when using pip to install requirements.')
+    if 'PIP_QUIET' in os.environ or 'PIP_VERBOSE' in os.environ:
+        quiet = False
+    else:
+        quiet = True
+    if 'PIP_INDEX_URL' in os.environ:
+        index_url = None
+    elif 'index_url' in opts:
+        index_url = opts['index_url'][1]
+    else:
+        index_url = None
+    if 'find_links' in opts:
+        find_links = _fixup_find_links(opts['find_links'][1])[:]
+    else:
+        find_links = []
+    if dist.dependency_links:
+        find_links.extend(dist.dependency_links)
+    eggs_dir = os.path.realpath(dist.get_egg_cache_dir())
+    environment = pkg_resources.Environment()
+    for egg_dist in pkg_resources.find_distributions(eggs_dir):
+        if egg_dist in req and environment.can_add(egg_dist):
+            return egg_dist
+    with TemporaryDirectory() as tmpdir:
+        cmd = [
+            sys.executable, '-m', 'pip',
+            '--disable-pip-version-check',
+            'wheel', '--no-deps',
+            '-w', tmpdir,
+        ]
+        if quiet:
+            cmd.append('--quiet')
+        if index_url is not None:
+            cmd.extend(('--index-url', index_url))
+        if find_links is not None:
+            for link in find_links:
+                cmd.extend(('--find-links', link))
+        # If requirement is a PEP 508 direct URL, directly pass
+        # the URL to pip, as `req @ url` does not work on the
+        # command line.
+        if req.url:
+            cmd.append(req.url)
+        else:
+            cmd.append(str(req))
+        try:
+            subprocess.check_call(cmd)
+        except subprocess.CalledProcessError as e:
+            raise DistutilsError(str(e))
+        wheel = Wheel(glob.glob(os.path.join(tmpdir, '*.whl'))[0])
+        dist_location = os.path.join(eggs_dir, wheel.egg_name())
+        wheel.install_as_egg(dist_location)
+        dist_metadata = pkg_resources.PathMetadata(
+            dist_location, os.path.join(dist_location, 'EGG-INFO'))
+        dist = pkg_resources.Distribution.from_filename(
+            dist_location, metadata=dist_metadata)
+        return dist
+
+
+def strip_marker(req):
+    """
+    Return a new requirement without the environment marker to avoid
+    calling pip with something like `babel; extra == "i18n"`, which
+    would always be ignored.
+    """
+    # create a copy to avoid mutating the input
+    req = pkg_resources.Requirement.parse(str(req))
+    req.marker = None
+    return req
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/launch.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/launch.py
new file mode 100644
index 0000000000000000000000000000000000000000..308283ea939ed9bced7b099eb8a1879aa9c203d4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/launch.py
@@ -0,0 +1,35 @@
+"""
+Launch the Python script on the command line after
+setuptools is bootstrapped via import.
+"""
+
+# Note that setuptools gets imported implicitly by the
+# invocation of this script using python -m setuptools.launch
+
+import tokenize
+import sys
+
+
+def run():
+    """
+    Run the script in sys.argv[1] as if it had
+    been invoked naturally.
+    """
+    __builtins__
+    script_name = sys.argv[1]
+    namespace = dict(
+        __file__=script_name,
+        __name__='__main__',
+        __doc__=None,
+    )
+    sys.argv[:] = sys.argv[1:]
+
+    open_ = getattr(tokenize, 'open', open)
+    script = open_(script_name).read()
+    norm_script = script.replace('\\r\\n', '\\n')
+    code = compile(norm_script, script_name, 'exec')
+    exec(code, namespace)
+
+
+if __name__ == '__main__':
+    run()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/lib2to3_ex.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/lib2to3_ex.py
new file mode 100644
index 0000000000000000000000000000000000000000..4b1a73feb26fdad65bafdeb21f5ce6abfb905fc0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/lib2to3_ex.py
@@ -0,0 +1,62 @@
+"""
+Customized Mixin2to3 support:
+
+ - adds support for converting doctests
+
+
+This module raises an ImportError on Python 2.
+"""
+
+from distutils.util import Mixin2to3 as _Mixin2to3
+from distutils import log
+from lib2to3.refactor import RefactoringTool, get_fixers_from_package
+
+import setuptools
+
+
+class DistutilsRefactoringTool(RefactoringTool):
+    def log_error(self, msg, *args, **kw):
+        log.error(msg, *args)
+
+    def log_message(self, msg, *args):
+        log.info(msg, *args)
+
+    def log_debug(self, msg, *args):
+        log.debug(msg, *args)
+
+
+class Mixin2to3(_Mixin2to3):
+    def run_2to3(self, files, doctests=False):
+        # See of the distribution option has been set, otherwise check the
+        # setuptools default.
+        if self.distribution.use_2to3 is not True:
+            return
+        if not files:
+            return
+        log.info("Fixing " + " ".join(files))
+        self.__build_fixer_names()
+        self.__exclude_fixers()
+        if doctests:
+            if setuptools.run_2to3_on_doctests:
+                r = DistutilsRefactoringTool(self.fixer_names)
+                r.refactor(files, write=True, doctests_only=True)
+        else:
+            _Mixin2to3.run_2to3(self, files)
+
+    def __build_fixer_names(self):
+        if self.fixer_names:
+            return
+        self.fixer_names = []
+        for p in setuptools.lib2to3_fixer_packages:
+            self.fixer_names.extend(get_fixers_from_package(p))
+        if self.distribution.use_2to3_fixers is not None:
+            for p in self.distribution.use_2to3_fixers:
+                self.fixer_names.extend(get_fixers_from_package(p))
+
+    def __exclude_fixers(self):
+        excluded_fixers = getattr(self, 'exclude_fixers', [])
+        if self.distribution.use_2to3_exclude_fixers is not None:
+            excluded_fixers.extend(self.distribution.use_2to3_exclude_fixers)
+        for fixer_name in excluded_fixers:
+            if fixer_name in self.fixer_names:
+                self.fixer_names.remove(fixer_name)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/monkey.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/monkey.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c77f8cf27f0ab1e71d64cfc114ef9d1bf72295c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/monkey.py
@@ -0,0 +1,179 @@
+"""
+Monkey patching of distutils.
+"""
+
+import sys
+import distutils.filelist
+import platform
+import types
+import functools
+from importlib import import_module
+import inspect
+
+from setuptools.extern import six
+
+import setuptools
+
+__all__ = []
+"""
+Everything is private. Contact the project team
+if you think you need this functionality.
+"""
+
+
+def _get_mro(cls):
+    """
+    Returns the bases classes for cls sorted by the MRO.
+
+    Works around an issue on Jython where inspect.getmro will not return all
+    base classes if multiple classes share the same name. Instead, this
+    function will return a tuple containing the class itself, and the contents
+    of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024.
+    """
+    if platform.python_implementation() == "Jython":
+        return (cls,) + cls.__bases__
+    return inspect.getmro(cls)
+
+
+def get_unpatched(item):
+    lookup = (
+        get_unpatched_class if isinstance(item, six.class_types) else
+        get_unpatched_function if isinstance(item, types.FunctionType) else
+        lambda item: None
+    )
+    return lookup(item)
+
+
+def get_unpatched_class(cls):
+    """Protect against re-patching the distutils if reloaded
+
+    Also ensures that no other distutils extension monkeypatched the distutils
+    first.
+    """
+    external_bases = (
+        cls
+        for cls in _get_mro(cls)
+        if not cls.__module__.startswith('setuptools')
+    )
+    base = next(external_bases)
+    if not base.__module__.startswith('distutils'):
+        msg = "distutils has already been patched by %r" % cls
+        raise AssertionError(msg)
+    return base
+
+
+def patch_all():
+    # we can't patch distutils.cmd, alas
+    distutils.core.Command = setuptools.Command
+
+    has_issue_12885 = sys.version_info <= (3, 5, 3)
+
+    if has_issue_12885:
+        # fix findall bug in distutils (http://bugs.python.org/issue12885)
+        distutils.filelist.findall = setuptools.findall
+
+    needs_warehouse = (
+        sys.version_info < (2, 7, 13)
+        or
+        (3, 4) < sys.version_info < (3, 4, 6)
+        or
+        (3, 5) < sys.version_info <= (3, 5, 3)
+    )
+
+    if needs_warehouse:
+        warehouse = 'https://upload.pypi.org/legacy/'
+        distutils.config.PyPIRCCommand.DEFAULT_REPOSITORY = warehouse
+
+    _patch_distribution_metadata()
+
+    # Install Distribution throughout the distutils
+    for module in distutils.dist, distutils.core, distutils.cmd:
+        module.Distribution = setuptools.dist.Distribution
+
+    # Install the patched Extension
+    distutils.core.Extension = setuptools.extension.Extension
+    distutils.extension.Extension = setuptools.extension.Extension
+    if 'distutils.command.build_ext' in sys.modules:
+        sys.modules['distutils.command.build_ext'].Extension = (
+            setuptools.extension.Extension
+        )
+
+    patch_for_msvc_specialized_compiler()
+
+
+def _patch_distribution_metadata():
+    """Patch write_pkg_file and read_pkg_file for higher metadata standards"""
+    for attr in ('write_pkg_file', 'read_pkg_file', 'get_metadata_version'):
+        new_val = getattr(setuptools.dist, attr)
+        setattr(distutils.dist.DistributionMetadata, attr, new_val)
+
+
+def patch_func(replacement, target_mod, func_name):
+    """
+    Patch func_name in target_mod with replacement
+
+    Important - original must be resolved by name to avoid
+    patching an already patched function.
+    """
+    original = getattr(target_mod, func_name)
+
+    # set the 'unpatched' attribute on the replacement to
+    # point to the original.
+    vars(replacement).setdefault('unpatched', original)
+
+    # replace the function in the original module
+    setattr(target_mod, func_name, replacement)
+
+
+def get_unpatched_function(candidate):
+    return getattr(candidate, 'unpatched')
+
+
+def patch_for_msvc_specialized_compiler():
+    """
+    Patch functions in distutils to use standalone Microsoft Visual C++
+    compilers.
+    """
+    # import late to avoid circular imports on Python < 3.5
+    msvc = import_module('setuptools.msvc')
+
+    if platform.system() != 'Windows':
+        # Compilers only availables on Microsoft Windows
+        return
+
+    def patch_params(mod_name, func_name):
+        """
+        Prepare the parameters for patch_func to patch indicated function.
+        """
+        repl_prefix = 'msvc9_' if 'msvc9' in mod_name else 'msvc14_'
+        repl_name = repl_prefix + func_name.lstrip('_')
+        repl = getattr(msvc, repl_name)
+        mod = import_module(mod_name)
+        if not hasattr(mod, func_name):
+            raise ImportError(func_name)
+        return repl, mod, func_name
+
+    # Python 2.7 to 3.4
+    msvc9 = functools.partial(patch_params, 'distutils.msvc9compiler')
+
+    # Python 3.5+
+    msvc14 = functools.partial(patch_params, 'distutils._msvccompiler')
+
+    try:
+        # Patch distutils.msvc9compiler
+        patch_func(*msvc9('find_vcvarsall'))
+        patch_func(*msvc9('query_vcvarsall'))
+    except ImportError:
+        pass
+
+    try:
+        # Patch distutils._msvccompiler._get_vc_env
+        patch_func(*msvc14('_get_vc_env'))
+    except ImportError:
+        pass
+
+    try:
+        # Patch distutils._msvccompiler.gen_lib_options for Numpy
+        patch_func(*msvc14('gen_lib_options'))
+    except ImportError:
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/msvc.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/msvc.py
new file mode 100644
index 0000000000000000000000000000000000000000..2ffe1c81ee629c98246e9e72bf630431fa7905b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/msvc.py
@@ -0,0 +1,1679 @@
+"""
+Improved support for Microsoft Visual C++ compilers.
+
+Known supported compilers:
+--------------------------
+Microsoft Visual C++ 9.0:
+    Microsoft Visual C++ Compiler for Python 2.7 (x86, amd64)
+    Microsoft Windows SDK 6.1 (x86, x64, ia64)
+    Microsoft Windows SDK 7.0 (x86, x64, ia64)
+
+Microsoft Visual C++ 10.0:
+    Microsoft Windows SDK 7.1 (x86, x64, ia64)
+
+Microsoft Visual C++ 14.X:
+    Microsoft Visual C++ Build Tools 2015 (x86, x64, arm)
+    Microsoft Visual Studio Build Tools 2017 (x86, x64, arm, arm64)
+    Microsoft Visual Studio Build Tools 2019 (x86, x64, arm, arm64)
+
+This may also support compilers shipped with compatible Visual Studio versions.
+"""
+
+import json
+from io import open
+from os import listdir, pathsep
+from os.path import join, isfile, isdir, dirname
+import sys
+import platform
+import itertools
+import distutils.errors
+from setuptools.extern.packaging.version import LegacyVersion
+
+from setuptools.extern.six.moves import filterfalse
+
+from .monkey import get_unpatched
+
+if platform.system() == 'Windows':
+    from setuptools.extern.six.moves import winreg
+    from os import environ
+else:
+    # Mock winreg and environ so the module can be imported on this platform.
+
+    class winreg:
+        HKEY_USERS = None
+        HKEY_CURRENT_USER = None
+        HKEY_LOCAL_MACHINE = None
+        HKEY_CLASSES_ROOT = None
+
+    environ = dict()
+
+_msvc9_suppress_errors = (
+    # msvc9compiler isn't available on some platforms
+    ImportError,
+
+    # msvc9compiler raises DistutilsPlatformError in some
+    # environments. See #1118.
+    distutils.errors.DistutilsPlatformError,
+)
+
+try:
+    from distutils.msvc9compiler import Reg
+except _msvc9_suppress_errors:
+    pass
+
+
+def msvc9_find_vcvarsall(version):
+    """
+    Patched "distutils.msvc9compiler.find_vcvarsall" to use the standalone
+    compiler build for Python
+    (VCForPython / Microsoft Visual C++ Compiler for Python 2.7).
+
+    Fall back to original behavior when the standalone compiler is not
+    available.
+
+    Redirect the path of "vcvarsall.bat".
+
+    Parameters
+    ----------
+    version: float
+        Required Microsoft Visual C++ version.
+
+    Return
+    ------
+    str
+        vcvarsall.bat path
+    """
+    vc_base = r'Software\%sMicrosoft\DevDiv\VCForPython\%0.1f'
+    key = vc_base % ('', version)
+    try:
+        # Per-user installs register the compiler path here
+        productdir = Reg.get_value(key, "installdir")
+    except KeyError:
+        try:
+            # All-user installs on a 64-bit system register here
+            key = vc_base % ('Wow6432Node\\', version)
+            productdir = Reg.get_value(key, "installdir")
+        except KeyError:
+            productdir = None
+
+    if productdir:
+        vcvarsall = join(productdir, "vcvarsall.bat")
+        if isfile(vcvarsall):
+            return vcvarsall
+
+    return get_unpatched(msvc9_find_vcvarsall)(version)
+
+
+def msvc9_query_vcvarsall(ver, arch='x86', *args, **kwargs):
+    """
+    Patched "distutils.msvc9compiler.query_vcvarsall" for support extra
+    Microsoft Visual C++ 9.0 and 10.0 compilers.
+
+    Set environment without use of "vcvarsall.bat".
+
+    Parameters
+    ----------
+    ver: float
+        Required Microsoft Visual C++ version.
+    arch: str
+        Target architecture.
+
+    Return
+    ------
+    dict
+        environment
+    """
+    # Try to get environment from vcvarsall.bat (Classical way)
+    try:
+        orig = get_unpatched(msvc9_query_vcvarsall)
+        return orig(ver, arch, *args, **kwargs)
+    except distutils.errors.DistutilsPlatformError:
+        # Pass error if Vcvarsall.bat is missing
+        pass
+    except ValueError:
+        # Pass error if environment not set after executing vcvarsall.bat
+        pass
+
+    # If error, try to set environment directly
+    try:
+        return EnvironmentInfo(arch, ver).return_env()
+    except distutils.errors.DistutilsPlatformError as exc:
+        _augment_exception(exc, ver, arch)
+        raise
+
+
+def msvc14_get_vc_env(plat_spec):
+    """
+    Patched "distutils._msvccompiler._get_vc_env" for support extra
+    Microsoft Visual C++ 14.X compilers.
+
+    Set environment without use of "vcvarsall.bat".
+
+    Parameters
+    ----------
+    plat_spec: str
+        Target architecture.
+
+    Return
+    ------
+    dict
+        environment
+    """
+    # Try to get environment from vcvarsall.bat (Classical way)
+    try:
+        return get_unpatched(msvc14_get_vc_env)(plat_spec)
+    except distutils.errors.DistutilsPlatformError:
+        # Pass error Vcvarsall.bat is missing
+        pass
+
+    # If error, try to set environment directly
+    try:
+        return EnvironmentInfo(plat_spec, vc_min_ver=14.0).return_env()
+    except distutils.errors.DistutilsPlatformError as exc:
+        _augment_exception(exc, 14.0)
+        raise
+
+
+def msvc14_gen_lib_options(*args, **kwargs):
+    """
+    Patched "distutils._msvccompiler.gen_lib_options" for fix
+    compatibility between "numpy.distutils" and "distutils._msvccompiler"
+    (for Numpy < 1.11.2)
+    """
+    if "numpy.distutils" in sys.modules:
+        import numpy as np
+        if LegacyVersion(np.__version__) < LegacyVersion('1.11.2'):
+            return np.distutils.ccompiler.gen_lib_options(*args, **kwargs)
+    return get_unpatched(msvc14_gen_lib_options)(*args, **kwargs)
+
+
+def _augment_exception(exc, version, arch=''):
+    """
+    Add details to the exception message to help guide the user
+    as to what action will resolve it.
+    """
+    # Error if MSVC++ directory not found or environment not set
+    message = exc.args[0]
+
+    if "vcvarsall" in message.lower() or "visual c" in message.lower():
+        # Special error message if MSVC++ not installed
+        tmpl = 'Microsoft Visual C++ {version:0.1f} is required.'
+        message = tmpl.format(**locals())
+        msdownload = 'www.microsoft.com/download/details.aspx?id=%d'
+        if version == 9.0:
+            if arch.lower().find('ia64') > -1:
+                # For VC++ 9.0, if IA64 support is needed, redirect user
+                # to Windows SDK 7.0.
+                # Note: No download link available from Microsoft.
+                message += ' Get it with "Microsoft Windows SDK 7.0"'
+            else:
+                # For VC++ 9.0 redirect user to Vc++ for Python 2.7 :
+                # This redirection link is maintained by Microsoft.
+                # Contact vspython@microsoft.com if it needs updating.
+                message += ' Get it from http://aka.ms/vcpython27'
+        elif version == 10.0:
+            # For VC++ 10.0 Redirect user to Windows SDK 7.1
+            message += ' Get it with "Microsoft Windows SDK 7.1": '
+            message += msdownload % 8279
+        elif version >= 14.0:
+            # For VC++ 14.X Redirect user to latest Visual C++ Build Tools
+            message += (' Get it with "Build Tools for Visual Studio": '
+                        r'https://visualstudio.microsoft.com/downloads/')
+
+    exc.args = (message, )
+
+
+class PlatformInfo:
+    """
+    Current and Target Architectures information.
+
+    Parameters
+    ----------
+    arch: str
+        Target architecture.
+    """
+    current_cpu = environ.get('processor_architecture', '').lower()
+
+    def __init__(self, arch):
+        self.arch = arch.lower().replace('x64', 'amd64')
+
+    @property
+    def target_cpu(self):
+        """
+        Return Target CPU architecture.
+
+        Return
+        ------
+        str
+            Target CPU
+        """
+        return self.arch[self.arch.find('_') + 1:]
+
+    def target_is_x86(self):
+        """
+        Return True if target CPU is x86 32 bits..
+
+        Return
+        ------
+        bool
+            CPU is x86 32 bits
+        """
+        return self.target_cpu == 'x86'
+
+    def current_is_x86(self):
+        """
+        Return True if current CPU is x86 32 bits..
+
+        Return
+        ------
+        bool
+            CPU is x86 32 bits
+        """
+        return self.current_cpu == 'x86'
+
+    def current_dir(self, hidex86=False, x64=False):
+        """
+        Current platform specific subfolder.
+
+        Parameters
+        ----------
+        hidex86: bool
+            return '' and not '\x86' if architecture is x86.
+        x64: bool
+            return '\x64' and not '\amd64' if architecture is amd64.
+
+        Return
+        ------
+        str
+            subfolder: '\target', or '' (see hidex86 parameter)
+        """
+        return (
+            '' if (self.current_cpu == 'x86' and hidex86) else
+            r'\x64' if (self.current_cpu == 'amd64' and x64) else
+            r'\%s' % self.current_cpu
+        )
+
+    def target_dir(self, hidex86=False, x64=False):
+        r"""
+        Target platform specific subfolder.
+
+        Parameters
+        ----------
+        hidex86: bool
+            return '' and not '\x86' if architecture is x86.
+        x64: bool
+            return '\x64' and not '\amd64' if architecture is amd64.
+
+        Return
+        ------
+        str
+            subfolder: '\current', or '' (see hidex86 parameter)
+        """
+        return (
+            '' if (self.target_cpu == 'x86' and hidex86) else
+            r'\x64' if (self.target_cpu == 'amd64' and x64) else
+            r'\%s' % self.target_cpu
+        )
+
+    def cross_dir(self, forcex86=False):
+        r"""
+        Cross platform specific subfolder.
+
+        Parameters
+        ----------
+        forcex86: bool
+            Use 'x86' as current architecture even if current architecture is
+            not x86.
+
+        Return
+        ------
+        str
+            subfolder: '' if target architecture is current architecture,
+            '\current_target' if not.
+        """
+        current = 'x86' if forcex86 else self.current_cpu
+        return (
+            '' if self.target_cpu == current else
+            self.target_dir().replace('\\', '\\%s_' % current)
+        )
+
+
+class RegistryInfo:
+    """
+    Microsoft Visual Studio related registry information.
+
+    Parameters
+    ----------
+    platform_info: PlatformInfo
+        "PlatformInfo" instance.
+    """
+    HKEYS = (winreg.HKEY_USERS,
+             winreg.HKEY_CURRENT_USER,
+             winreg.HKEY_LOCAL_MACHINE,
+             winreg.HKEY_CLASSES_ROOT)
+
+    def __init__(self, platform_info):
+        self.pi = platform_info
+
+    @property
+    def visualstudio(self):
+        """
+        Microsoft Visual Studio root registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return 'VisualStudio'
+
+    @property
+    def sxs(self):
+        """
+        Microsoft Visual Studio SxS registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return join(self.visualstudio, 'SxS')
+
+    @property
+    def vc(self):
+        """
+        Microsoft Visual C++ VC7 registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return join(self.sxs, 'VC7')
+
+    @property
+    def vs(self):
+        """
+        Microsoft Visual Studio VS7 registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return join(self.sxs, 'VS7')
+
+    @property
+    def vc_for_python(self):
+        """
+        Microsoft Visual C++ for Python registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return r'DevDiv\VCForPython'
+
+    @property
+    def microsoft_sdk(self):
+        """
+        Microsoft SDK registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return 'Microsoft SDKs'
+
+    @property
+    def windows_sdk(self):
+        """
+        Microsoft Windows/Platform SDK registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return join(self.microsoft_sdk, 'Windows')
+
+    @property
+    def netfx_sdk(self):
+        """
+        Microsoft .NET Framework SDK registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return join(self.microsoft_sdk, 'NETFXSDK')
+
+    @property
+    def windows_kits_roots(self):
+        """
+        Microsoft Windows Kits Roots registry key.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        return r'Windows Kits\Installed Roots'
+
+    def microsoft(self, key, x86=False):
+        """
+        Return key in Microsoft software registry.
+
+        Parameters
+        ----------
+        key: str
+            Registry key path where look.
+        x86: str
+            Force x86 software registry.
+
+        Return
+        ------
+        str
+            Registry key
+        """
+        node64 = '' if self.pi.current_is_x86() or x86 else 'Wow6432Node'
+        return join('Software', node64, 'Microsoft', key)
+
+    def lookup(self, key, name):
+        """
+        Look for values in registry in Microsoft software registry.
+
+        Parameters
+        ----------
+        key: str
+            Registry key path where look.
+        name: str
+            Value name to find.
+
+        Return
+        ------
+        str
+            value
+        """
+        key_read = winreg.KEY_READ
+        openkey = winreg.OpenKey
+        ms = self.microsoft
+        for hkey in self.HKEYS:
+            try:
+                bkey = openkey(hkey, ms(key), 0, key_read)
+            except (OSError, IOError):
+                if not self.pi.current_is_x86():
+                    try:
+                        bkey = openkey(hkey, ms(key, True), 0, key_read)
+                    except (OSError, IOError):
+                        continue
+                else:
+                    continue
+            try:
+                return winreg.QueryValueEx(bkey, name)[0]
+            except (OSError, IOError):
+                pass
+
+
+class SystemInfo:
+    """
+    Microsoft Windows and Visual Studio related system information.
+
+    Parameters
+    ----------
+    registry_info: RegistryInfo
+        "RegistryInfo" instance.
+    vc_ver: float
+        Required Microsoft Visual C++ version.
+    """
+
+    # Variables and properties in this class use originals CamelCase variables
+    # names from Microsoft source files for more easy comparison.
+    WinDir = environ.get('WinDir', '')
+    ProgramFiles = environ.get('ProgramFiles', '')
+    ProgramFilesx86 = environ.get('ProgramFiles(x86)', ProgramFiles)
+
+    def __init__(self, registry_info, vc_ver=None):
+        self.ri = registry_info
+        self.pi = self.ri.pi
+
+        self.known_vs_paths = self.find_programdata_vs_vers()
+
+        # Except for VS15+, VC version is aligned with VS version
+        self.vs_ver = self.vc_ver = (
+                vc_ver or self._find_latest_available_vs_ver())
+
+    def _find_latest_available_vs_ver(self):
+        """
+        Find the latest VC version
+
+        Return
+        ------
+        float
+            version
+        """
+        reg_vc_vers = self.find_reg_vs_vers()
+
+        if not (reg_vc_vers or self.known_vs_paths):
+            raise distutils.errors.DistutilsPlatformError(
+                'No Microsoft Visual C++ version found')
+
+        vc_vers = set(reg_vc_vers)
+        vc_vers.update(self.known_vs_paths)
+        return sorted(vc_vers)[-1]
+
+    def find_reg_vs_vers(self):
+        """
+        Find Microsoft Visual Studio versions available in registry.
+
+        Return
+        ------
+        list of float
+            Versions
+        """
+        ms = self.ri.microsoft
+        vckeys = (self.ri.vc, self.ri.vc_for_python, self.ri.vs)
+        vs_vers = []
+        for hkey in self.ri.HKEYS:
+            for key in vckeys:
+                try:
+                    bkey = winreg.OpenKey(hkey, ms(key), 0, winreg.KEY_READ)
+                except (OSError, IOError):
+                    continue
+                subkeys, values, _ = winreg.QueryInfoKey(bkey)
+                for i in range(values):
+                    try:
+                        ver = float(winreg.EnumValue(bkey, i)[0])
+                        if ver not in vs_vers:
+                            vs_vers.append(ver)
+                    except ValueError:
+                        pass
+                for i in range(subkeys):
+                    try:
+                        ver = float(winreg.EnumKey(bkey, i))
+                        if ver not in vs_vers:
+                            vs_vers.append(ver)
+                    except ValueError:
+                        pass
+        return sorted(vs_vers)
+
+    def find_programdata_vs_vers(self):
+        r"""
+        Find Visual studio 2017+ versions from information in
+        "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".
+
+        Return
+        ------
+        dict
+            float version as key, path as value.
+        """
+        vs_versions = {}
+        instances_dir = \
+            r'C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances'
+
+        try:
+            hashed_names = listdir(instances_dir)
+
+        except (OSError, IOError):
+            # Directory not exists with all Visual Studio versions
+            return vs_versions
+
+        for name in hashed_names:
+            try:
+                # Get VS installation path from "state.json" file
+                state_path = join(instances_dir, name, 'state.json')
+                with open(state_path, 'rt', encoding='utf-8') as state_file:
+                    state = json.load(state_file)
+                vs_path = state['installationPath']
+
+                # Raises OSError if this VS installation does not contain VC
+                listdir(join(vs_path, r'VC\Tools\MSVC'))
+
+                # Store version and path
+                vs_versions[self._as_float_version(
+                    state['installationVersion'])] = vs_path
+
+            except (OSError, IOError, KeyError):
+                # Skip if "state.json" file is missing or bad format
+                continue
+
+        return vs_versions
+
+    @staticmethod
+    def _as_float_version(version):
+        """
+        Return a string version as a simplified float version (major.minor)
+
+        Parameters
+        ----------
+        version: str
+            Version.
+
+        Return
+        ------
+        float
+            version
+        """
+        return float('.'.join(version.split('.')[:2]))
+
+    @property
+    def VSInstallDir(self):
+        """
+        Microsoft Visual Studio directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        # Default path
+        default = join(self.ProgramFilesx86,
+                       'Microsoft Visual Studio %0.1f' % self.vs_ver)
+
+        # Try to get path from registry, if fail use default path
+        return self.ri.lookup(self.ri.vs, '%0.1f' % self.vs_ver) or default
+
+    @property
+    def VCInstallDir(self):
+        """
+        Microsoft Visual C++ directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        path = self._guess_vc() or self._guess_vc_legacy()
+
+        if not isdir(path):
+            msg = 'Microsoft Visual C++ directory not found'
+            raise distutils.errors.DistutilsPlatformError(msg)
+
+        return path
+
+    def _guess_vc(self):
+        """
+        Locate Visual C++ for VS2017+.
+
+        Return
+        ------
+        str
+            path
+        """
+        if self.vs_ver <= 14.0:
+            return ''
+
+        try:
+            # First search in known VS paths
+            vs_dir = self.known_vs_paths[self.vs_ver]
+        except KeyError:
+            # Else, search with path from registry
+            vs_dir = self.VSInstallDir
+
+        guess_vc = join(vs_dir, r'VC\Tools\MSVC')
+
+        # Subdir with VC exact version as name
+        try:
+            # Update the VC version with real one instead of VS version
+            vc_ver = listdir(guess_vc)[-1]
+            self.vc_ver = self._as_float_version(vc_ver)
+            return join(guess_vc, vc_ver)
+        except (OSError, IOError, IndexError):
+            return ''
+
+    def _guess_vc_legacy(self):
+        """
+        Locate Visual C++ for versions prior to 2017.
+
+        Return
+        ------
+        str
+            path
+        """
+        default = join(self.ProgramFilesx86,
+                       r'Microsoft Visual Studio %0.1f\VC' % self.vs_ver)
+
+        # Try to get "VC++ for Python" path from registry as default path
+        reg_path = join(self.ri.vc_for_python, '%0.1f' % self.vs_ver)
+        python_vc = self.ri.lookup(reg_path, 'installdir')
+        default_vc = join(python_vc, 'VC') if python_vc else default
+
+        # Try to get path from registry, if fail use default path
+        return self.ri.lookup(self.ri.vc, '%0.1f' % self.vs_ver) or default_vc
+
+    @property
+    def WindowsSdkVersion(self):
+        """
+        Microsoft Windows SDK versions for specified MSVC++ version.
+
+        Return
+        ------
+        tuple of str
+            versions
+        """
+        if self.vs_ver <= 9.0:
+            return '7.0', '6.1', '6.0a'
+        elif self.vs_ver == 10.0:
+            return '7.1', '7.0a'
+        elif self.vs_ver == 11.0:
+            return '8.0', '8.0a'
+        elif self.vs_ver == 12.0:
+            return '8.1', '8.1a'
+        elif self.vs_ver >= 14.0:
+            return '10.0', '8.1'
+
+    @property
+    def WindowsSdkLastVersion(self):
+        """
+        Microsoft Windows SDK last version.
+
+        Return
+        ------
+        str
+            version
+        """
+        return self._use_last_dir_name(join(self.WindowsSdkDir, 'lib'))
+
+    @property
+    def WindowsSdkDir(self):
+        """
+        Microsoft Windows SDK directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        sdkdir = ''
+        for ver in self.WindowsSdkVersion:
+            # Try to get it from registry
+            loc = join(self.ri.windows_sdk, 'v%s' % ver)
+            sdkdir = self.ri.lookup(loc, 'installationfolder')
+            if sdkdir:
+                break
+        if not sdkdir or not isdir(sdkdir):
+            # Try to get "VC++ for Python" version from registry
+            path = join(self.ri.vc_for_python, '%0.1f' % self.vc_ver)
+            install_base = self.ri.lookup(path, 'installdir')
+            if install_base:
+                sdkdir = join(install_base, 'WinSDK')
+        if not sdkdir or not isdir(sdkdir):
+            # If fail, use default new path
+            for ver in self.WindowsSdkVersion:
+                intver = ver[:ver.rfind('.')]
+                path = r'Microsoft SDKs\Windows Kits\%s' % intver
+                d = join(self.ProgramFiles, path)
+                if isdir(d):
+                    sdkdir = d
+        if not sdkdir or not isdir(sdkdir):
+            # If fail, use default old path
+            for ver in self.WindowsSdkVersion:
+                path = r'Microsoft SDKs\Windows\v%s' % ver
+                d = join(self.ProgramFiles, path)
+                if isdir(d):
+                    sdkdir = d
+        if not sdkdir:
+            # If fail, use Platform SDK
+            sdkdir = join(self.VCInstallDir, 'PlatformSDK')
+        return sdkdir
+
+    @property
+    def WindowsSDKExecutablePath(self):
+        """
+        Microsoft Windows SDK executable directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        # Find WinSDK NetFx Tools registry dir name
+        if self.vs_ver <= 11.0:
+            netfxver = 35
+            arch = ''
+        else:
+            netfxver = 40
+            hidex86 = True if self.vs_ver <= 12.0 else False
+            arch = self.pi.current_dir(x64=True, hidex86=hidex86)
+        fx = 'WinSDK-NetFx%dTools%s' % (netfxver, arch.replace('\\', '-'))
+
+        # list all possibles registry paths
+        regpaths = []
+        if self.vs_ver >= 14.0:
+            for ver in self.NetFxSdkVersion:
+                regpaths += [join(self.ri.netfx_sdk, ver, fx)]
+
+        for ver in self.WindowsSdkVersion:
+            regpaths += [join(self.ri.windows_sdk, 'v%sA' % ver, fx)]
+
+        # Return installation folder from the more recent path
+        for path in regpaths:
+            execpath = self.ri.lookup(path, 'installationfolder')
+            if execpath:
+                return execpath
+
+    @property
+    def FSharpInstallDir(self):
+        """
+        Microsoft Visual F# directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        path = join(self.ri.visualstudio, r'%0.1f\Setup\F#' % self.vs_ver)
+        return self.ri.lookup(path, 'productdir') or ''
+
+    @property
+    def UniversalCRTSdkDir(self):
+        """
+        Microsoft Universal CRT SDK directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        # Set Kit Roots versions for specified MSVC++ version
+        vers = ('10', '81') if self.vs_ver >= 14.0 else ()
+
+        # Find path of the more recent Kit
+        for ver in vers:
+            sdkdir = self.ri.lookup(self.ri.windows_kits_roots,
+                                    'kitsroot%s' % ver)
+            if sdkdir:
+                return sdkdir or ''
+
+    @property
+    def UniversalCRTSdkLastVersion(self):
+        """
+        Microsoft Universal C Runtime SDK last version.
+
+        Return
+        ------
+        str
+            version
+        """
+        return self._use_last_dir_name(join(self.UniversalCRTSdkDir, 'lib'))
+
+    @property
+    def NetFxSdkVersion(self):
+        """
+        Microsoft .NET Framework SDK versions.
+
+        Return
+        ------
+        tuple of str
+            versions
+        """
+        # Set FxSdk versions for specified VS version
+        return (('4.7.2', '4.7.1', '4.7',
+                 '4.6.2', '4.6.1', '4.6',
+                 '4.5.2', '4.5.1', '4.5')
+                if self.vs_ver >= 14.0 else ())
+
+    @property
+    def NetFxSdkDir(self):
+        """
+        Microsoft .NET Framework SDK directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        sdkdir = ''
+        for ver in self.NetFxSdkVersion:
+            loc = join(self.ri.netfx_sdk, ver)
+            sdkdir = self.ri.lookup(loc, 'kitsinstallationfolder')
+            if sdkdir:
+                break
+        return sdkdir
+
+    @property
+    def FrameworkDir32(self):
+        """
+        Microsoft .NET Framework 32bit directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        # Default path
+        guess_fw = join(self.WinDir, r'Microsoft.NET\Framework')
+
+        # Try to get path from registry, if fail use default path
+        return self.ri.lookup(self.ri.vc, 'frameworkdir32') or guess_fw
+
+    @property
+    def FrameworkDir64(self):
+        """
+        Microsoft .NET Framework 64bit directory.
+
+        Return
+        ------
+        str
+            path
+        """
+        # Default path
+        guess_fw = join(self.WinDir, r'Microsoft.NET\Framework64')
+
+        # Try to get path from registry, if fail use default path
+        return self.ri.lookup(self.ri.vc, 'frameworkdir64') or guess_fw
+
+    @property
+    def FrameworkVersion32(self):
+        """
+        Microsoft .NET Framework 32bit versions.
+
+        Return
+        ------
+        tuple of str
+            versions
+        """
+        return self._find_dot_net_versions(32)
+
+    @property
+    def FrameworkVersion64(self):
+        """
+        Microsoft .NET Framework 64bit versions.
+
+        Return
+        ------
+        tuple of str
+            versions
+        """
+        return self._find_dot_net_versions(64)
+
+    def _find_dot_net_versions(self, bits):
+        """
+        Find Microsoft .NET Framework versions.
+
+        Parameters
+        ----------
+        bits: int
+            Platform number of bits: 32 or 64.
+
+        Return
+        ------
+        tuple of str
+            versions
+        """
+        # Find actual .NET version in registry
+        reg_ver = self.ri.lookup(self.ri.vc, 'frameworkver%d' % bits)
+        dot_net_dir = getattr(self, 'FrameworkDir%d' % bits)
+        ver = reg_ver or self._use_last_dir_name(dot_net_dir, 'v') or ''
+
+        # Set .NET versions for specified MSVC++ version
+        if self.vs_ver >= 12.0:
+            return ver, 'v4.0'
+        elif self.vs_ver >= 10.0:
+            return 'v4.0.30319' if ver.lower()[:2] != 'v4' else ver, 'v3.5'
+        elif self.vs_ver == 9.0:
+            return 'v3.5', 'v2.0.50727'
+        elif self.vs_ver == 8.0:
+            return 'v3.0', 'v2.0.50727'
+
+    @staticmethod
+    def _use_last_dir_name(path, prefix=''):
+        """
+        Return name of the last dir in path or '' if no dir found.
+
+        Parameters
+        ----------
+        path: str
+            Use dirs in this path
+        prefix: str
+            Use only dirs starting by this prefix
+
+        Return
+        ------
+        str
+            name
+        """
+        matching_dirs = (
+            dir_name
+            for dir_name in reversed(listdir(path))
+            if isdir(join(path, dir_name)) and
+            dir_name.startswith(prefix)
+        )
+        return next(matching_dirs, None) or ''
+
+
+class EnvironmentInfo:
+    """
+    Return environment variables for specified Microsoft Visual C++ version
+    and platform : Lib, Include, Path and libpath.
+
+    This function is compatible with Microsoft Visual C++ 9.0 to 14.X.
+
+    Script created by analysing Microsoft environment configuration files like
+    "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...
+
+    Parameters
+    ----------
+    arch: str
+        Target architecture.
+    vc_ver: float
+        Required Microsoft Visual C++ version. If not set, autodetect the last
+        version.
+    vc_min_ver: float
+        Minimum Microsoft Visual C++ version.
+    """
+
+    # Variables and properties in this class use originals CamelCase variables
+    # names from Microsoft source files for more easy comparison.
+
+    def __init__(self, arch, vc_ver=None, vc_min_ver=0):
+        self.pi = PlatformInfo(arch)
+        self.ri = RegistryInfo(self.pi)
+        self.si = SystemInfo(self.ri, vc_ver)
+
+        if self.vc_ver < vc_min_ver:
+            err = 'No suitable Microsoft Visual C++ version found'
+            raise distutils.errors.DistutilsPlatformError(err)
+
+    @property
+    def vs_ver(self):
+        """
+        Microsoft Visual Studio.
+
+        Return
+        ------
+        float
+            version
+        """
+        return self.si.vs_ver
+
+    @property
+    def vc_ver(self):
+        """
+        Microsoft Visual C++ version.
+
+        Return
+        ------
+        float
+            version
+        """
+        return self.si.vc_ver
+
+    @property
+    def VSTools(self):
+        """
+        Microsoft Visual Studio Tools.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        paths = [r'Common7\IDE', r'Common7\Tools']
+
+        if self.vs_ver >= 14.0:
+            arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
+            paths += [r'Common7\IDE\CommonExtensions\Microsoft\TestWindow']
+            paths += [r'Team Tools\Performance Tools']
+            paths += [r'Team Tools\Performance Tools%s' % arch_subdir]
+
+        return [join(self.si.VSInstallDir, path) for path in paths]
+
+    @property
+    def VCIncludes(self):
+        """
+        Microsoft Visual C++ & Microsoft Foundation Class Includes.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        return [join(self.si.VCInstallDir, 'Include'),
+                join(self.si.VCInstallDir, r'ATLMFC\Include')]
+
+    @property
+    def VCLibraries(self):
+        """
+        Microsoft Visual C++ & Microsoft Foundation Class Libraries.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver >= 15.0:
+            arch_subdir = self.pi.target_dir(x64=True)
+        else:
+            arch_subdir = self.pi.target_dir(hidex86=True)
+        paths = ['Lib%s' % arch_subdir, r'ATLMFC\Lib%s' % arch_subdir]
+
+        if self.vs_ver >= 14.0:
+            paths += [r'Lib\store%s' % arch_subdir]
+
+        return [join(self.si.VCInstallDir, path) for path in paths]
+
+    @property
+    def VCStoreRefs(self):
+        """
+        Microsoft Visual C++ store references Libraries.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 14.0:
+            return []
+        return [join(self.si.VCInstallDir, r'Lib\store\references')]
+
+    @property
+    def VCTools(self):
+        """
+        Microsoft Visual C++ Tools.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        si = self.si
+        tools = [join(si.VCInstallDir, 'VCPackages')]
+
+        forcex86 = True if self.vs_ver <= 10.0 else False
+        arch_subdir = self.pi.cross_dir(forcex86)
+        if arch_subdir:
+            tools += [join(si.VCInstallDir, 'Bin%s' % arch_subdir)]
+
+        if self.vs_ver == 14.0:
+            path = 'Bin%s' % self.pi.current_dir(hidex86=True)
+            tools += [join(si.VCInstallDir, path)]
+
+        elif self.vs_ver >= 15.0:
+            host_dir = (r'bin\HostX86%s' if self.pi.current_is_x86() else
+                        r'bin\HostX64%s')
+            tools += [join(
+                si.VCInstallDir, host_dir % self.pi.target_dir(x64=True))]
+
+            if self.pi.current_cpu != self.pi.target_cpu:
+                tools += [join(
+                    si.VCInstallDir, host_dir % self.pi.current_dir(x64=True))]
+
+        else:
+            tools += [join(si.VCInstallDir, 'Bin')]
+
+        return tools
+
+    @property
+    def OSLibraries(self):
+        """
+        Microsoft Windows SDK Libraries.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver <= 10.0:
+            arch_subdir = self.pi.target_dir(hidex86=True, x64=True)
+            return [join(self.si.WindowsSdkDir, 'Lib%s' % arch_subdir)]
+
+        else:
+            arch_subdir = self.pi.target_dir(x64=True)
+            lib = join(self.si.WindowsSdkDir, 'lib')
+            libver = self._sdk_subdir
+            return [join(lib, '%sum%s' % (libver , arch_subdir))]
+
+    @property
+    def OSIncludes(self):
+        """
+        Microsoft Windows SDK Include.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        include = join(self.si.WindowsSdkDir, 'include')
+
+        if self.vs_ver <= 10.0:
+            return [include, join(include, 'gl')]
+
+        else:
+            if self.vs_ver >= 14.0:
+                sdkver = self._sdk_subdir
+            else:
+                sdkver = ''
+            return [join(include, '%sshared' % sdkver),
+                    join(include, '%sum' % sdkver),
+                    join(include, '%swinrt' % sdkver)]
+
+    @property
+    def OSLibpath(self):
+        """
+        Microsoft Windows SDK Libraries Paths.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        ref = join(self.si.WindowsSdkDir, 'References')
+        libpath = []
+
+        if self.vs_ver <= 9.0:
+            libpath += self.OSLibraries
+
+        if self.vs_ver >= 11.0:
+            libpath += [join(ref, r'CommonConfiguration\Neutral')]
+
+        if self.vs_ver >= 14.0:
+            libpath += [
+                ref,
+                join(self.si.WindowsSdkDir, 'UnionMetadata'),
+                join(ref, 'Windows.Foundation.UniversalApiContract', '1.0.0.0'),
+                join(ref, 'Windows.Foundation.FoundationContract', '1.0.0.0'),
+                join(ref,'Windows.Networking.Connectivity.WwanContract',
+                     '1.0.0.0'),
+                join(self.si.WindowsSdkDir, 'ExtensionSDKs', 'Microsoft.VCLibs',
+                     '%0.1f' % self.vs_ver, 'References', 'CommonConfiguration',
+                     'neutral'),
+            ]
+        return libpath
+
+    @property
+    def SdkTools(self):
+        """
+        Microsoft Windows SDK Tools.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        return list(self._sdk_tools())
+
+    def _sdk_tools(self):
+        """
+        Microsoft Windows SDK Tools paths generator.
+
+        Return
+        ------
+        generator of str
+            paths
+        """
+        if self.vs_ver < 15.0:
+            bin_dir = 'Bin' if self.vs_ver <= 11.0 else r'Bin\x86'
+            yield join(self.si.WindowsSdkDir, bin_dir)
+
+        if not self.pi.current_is_x86():
+            arch_subdir = self.pi.current_dir(x64=True)
+            path = 'Bin%s' % arch_subdir
+            yield join(self.si.WindowsSdkDir, path)
+
+        if self.vs_ver in (10.0, 11.0):
+            if self.pi.target_is_x86():
+                arch_subdir = ''
+            else:
+                arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
+            path = r'Bin\NETFX 4.0 Tools%s' % arch_subdir
+            yield join(self.si.WindowsSdkDir, path)
+
+        elif self.vs_ver >= 15.0:
+            path = join(self.si.WindowsSdkDir, 'Bin')
+            arch_subdir = self.pi.current_dir(x64=True)
+            sdkver = self.si.WindowsSdkLastVersion
+            yield join(path, '%s%s' % (sdkver, arch_subdir))
+
+        if self.si.WindowsSDKExecutablePath:
+            yield self.si.WindowsSDKExecutablePath
+
+    @property
+    def _sdk_subdir(self):
+        """
+        Microsoft Windows SDK version subdir.
+
+        Return
+        ------
+        str
+            subdir
+        """
+        ucrtver = self.si.WindowsSdkLastVersion
+        return ('%s\\' % ucrtver) if ucrtver else ''
+
+    @property
+    def SdkSetup(self):
+        """
+        Microsoft Windows SDK Setup.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver > 9.0:
+            return []
+
+        return [join(self.si.WindowsSdkDir, 'Setup')]
+
+    @property
+    def FxTools(self):
+        """
+        Microsoft .NET Framework Tools.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        pi = self.pi
+        si = self.si
+
+        if self.vs_ver <= 10.0:
+            include32 = True
+            include64 = not pi.target_is_x86() and not pi.current_is_x86()
+        else:
+            include32 = pi.target_is_x86() or pi.current_is_x86()
+            include64 = pi.current_cpu == 'amd64' or pi.target_cpu == 'amd64'
+
+        tools = []
+        if include32:
+            tools += [join(si.FrameworkDir32, ver)
+                      for ver in si.FrameworkVersion32]
+        if include64:
+            tools += [join(si.FrameworkDir64, ver)
+                      for ver in si.FrameworkVersion64]
+        return tools
+
+    @property
+    def NetFxSDKLibraries(self):
+        """
+        Microsoft .Net Framework SDK Libraries.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
+            return []
+
+        arch_subdir = self.pi.target_dir(x64=True)
+        return [join(self.si.NetFxSdkDir, r'lib\um%s' % arch_subdir)]
+
+    @property
+    def NetFxSDKIncludes(self):
+        """
+        Microsoft .Net Framework SDK Includes.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
+            return []
+
+        return [join(self.si.NetFxSdkDir, r'include\um')]
+
+    @property
+    def VsTDb(self):
+        """
+        Microsoft Visual Studio Team System Database.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        return [join(self.si.VSInstallDir, r'VSTSDB\Deploy')]
+
+    @property
+    def MSBuild(self):
+        """
+        Microsoft Build Engine.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 12.0:
+            return []
+        elif self.vs_ver < 15.0:
+            base_path = self.si.ProgramFilesx86
+            arch_subdir = self.pi.current_dir(hidex86=True)
+        else:
+            base_path = self.si.VSInstallDir
+            arch_subdir = ''
+
+        path = r'MSBuild\%0.1f\bin%s' % (self.vs_ver, arch_subdir)
+        build = [join(base_path, path)]
+
+        if self.vs_ver >= 15.0:
+            # Add Roslyn C# & Visual Basic Compiler
+            build += [join(base_path, path, 'Roslyn')]
+
+        return build
+
+    @property
+    def HTMLHelpWorkshop(self):
+        """
+        Microsoft HTML Help Workshop.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 11.0:
+            return []
+
+        return [join(self.si.ProgramFilesx86, 'HTML Help Workshop')]
+
+    @property
+    def UCRTLibraries(self):
+        """
+        Microsoft Universal C Runtime SDK Libraries.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 14.0:
+            return []
+
+        arch_subdir = self.pi.target_dir(x64=True)
+        lib = join(self.si.UniversalCRTSdkDir, 'lib')
+        ucrtver = self._ucrt_subdir
+        return [join(lib, '%sucrt%s' % (ucrtver, arch_subdir))]
+
+    @property
+    def UCRTIncludes(self):
+        """
+        Microsoft Universal C Runtime SDK Include.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if self.vs_ver < 14.0:
+            return []
+
+        include = join(self.si.UniversalCRTSdkDir, 'include')
+        return [join(include, '%sucrt' % self._ucrt_subdir)]
+
+    @property
+    def _ucrt_subdir(self):
+        """
+        Microsoft Universal C Runtime SDK version subdir.
+
+        Return
+        ------
+        str
+            subdir
+        """
+        ucrtver = self.si.UniversalCRTSdkLastVersion
+        return ('%s\\' % ucrtver) if ucrtver else ''
+
+    @property
+    def FSharp(self):
+        """
+        Microsoft Visual F#.
+
+        Return
+        ------
+        list of str
+            paths
+        """
+        if 11.0 > self.vs_ver > 12.0:
+            return []
+
+        return [self.si.FSharpInstallDir]
+
+    @property
+    def VCRuntimeRedist(self):
+        """
+        Microsoft Visual C++ runtime redistributable dll.
+
+        Return
+        ------
+        str
+            path
+        """
+        vcruntime = 'vcruntime%d0.dll' % self.vc_ver
+        arch_subdir = self.pi.target_dir(x64=True).strip('\\')
+
+        # Installation prefixes candidates
+        prefixes = []
+        tools_path = self.si.VCInstallDir
+        redist_path = dirname(tools_path.replace(r'\Tools', r'\Redist'))
+        if isdir(redist_path):
+            # Redist version may not be exactly the same as tools
+            redist_path = join(redist_path, listdir(redist_path)[-1])
+            prefixes += [redist_path, join(redist_path, 'onecore')]
+
+        prefixes += [join(tools_path, 'redist')]  # VS14 legacy path
+
+        # CRT directory
+        crt_dirs = ('Microsoft.VC%d.CRT' % (self.vc_ver * 10),
+                    # Sometime store in directory with VS version instead of VC
+                    'Microsoft.VC%d.CRT' % (int(self.vs_ver) * 10))
+
+        # vcruntime path
+        for prefix, crt_dir in itertools.product(prefixes, crt_dirs):
+            path = join(prefix, arch_subdir, crt_dir, vcruntime)
+            if isfile(path):
+                return path
+
+    def return_env(self, exists=True):
+        """
+        Return environment dict.
+
+        Parameters
+        ----------
+        exists: bool
+            It True, only return existing paths.
+
+        Return
+        ------
+        dict
+            environment
+        """
+        env = dict(
+            include=self._build_paths('include',
+                                      [self.VCIncludes,
+                                       self.OSIncludes,
+                                       self.UCRTIncludes,
+                                       self.NetFxSDKIncludes],
+                                      exists),
+            lib=self._build_paths('lib',
+                                  [self.VCLibraries,
+                                   self.OSLibraries,
+                                   self.FxTools,
+                                   self.UCRTLibraries,
+                                   self.NetFxSDKLibraries],
+                                  exists),
+            libpath=self._build_paths('libpath',
+                                      [self.VCLibraries,
+                                       self.FxTools,
+                                       self.VCStoreRefs,
+                                       self.OSLibpath],
+                                      exists),
+            path=self._build_paths('path',
+                                   [self.VCTools,
+                                    self.VSTools,
+                                    self.VsTDb,
+                                    self.SdkTools,
+                                    self.SdkSetup,
+                                    self.FxTools,
+                                    self.MSBuild,
+                                    self.HTMLHelpWorkshop,
+                                    self.FSharp],
+                                   exists),
+        )
+        if self.vs_ver >= 14 and isfile(self.VCRuntimeRedist):
+            env['py_vcruntime_redist'] = self.VCRuntimeRedist
+        return env
+
+    def _build_paths(self, name, spec_path_lists, exists):
+        """
+        Given an environment variable name and specified paths,
+        return a pathsep-separated string of paths containing
+        unique, extant, directories from those paths and from
+        the environment variable. Raise an error if no paths
+        are resolved.
+
+        Parameters
+        ----------
+        name: str
+            Environment variable name
+        spec_path_lists: list of str
+            Paths
+        exists: bool
+            It True, only return existing paths.
+
+        Return
+        ------
+        str
+            Pathsep-separated paths
+        """
+        # flatten spec_path_lists
+        spec_paths = itertools.chain.from_iterable(spec_path_lists)
+        env_paths = environ.get(name, '').split(pathsep)
+        paths = itertools.chain(spec_paths, env_paths)
+        extant_paths = list(filter(isdir, paths)) if exists else paths
+        if not extant_paths:
+            msg = "%s environment variable is empty" % name.upper()
+            raise distutils.errors.DistutilsPlatformError(msg)
+        unique_paths = self._unique_everseen(extant_paths)
+        return pathsep.join(unique_paths)
+
+    # from Python docs
+    @staticmethod
+    def _unique_everseen(iterable, key=None):
+        """
+        List unique elements, preserving order.
+        Remember all elements ever seen.
+
+        _unique_everseen('AAAABBBCCDAABBB') --> A B C D
+
+        _unique_everseen('ABBCcAD', str.lower) --> A B C D
+        """
+        seen = set()
+        seen_add = seen.add
+        if key is None:
+            for element in filterfalse(seen.__contains__, iterable):
+                seen_add(element)
+                yield element
+        else:
+            for element in iterable:
+                k = key(element)
+                if k not in seen:
+                    seen_add(k)
+                    yield element
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/namespaces.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/namespaces.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc16106d3dc7048a160129745756bbc9b1fb51d9
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/namespaces.py
@@ -0,0 +1,107 @@
+import os
+from distutils import log
+import itertools
+
+from setuptools.extern.six.moves import map
+
+
+flatten = itertools.chain.from_iterable
+
+
+class Installer:
+
+    nspkg_ext = '-nspkg.pth'
+
+    def install_namespaces(self):
+        nsp = self._get_all_ns_packages()
+        if not nsp:
+            return
+        filename, ext = os.path.splitext(self._get_target())
+        filename += self.nspkg_ext
+        self.outputs.append(filename)
+        log.info("Installing %s", filename)
+        lines = map(self._gen_nspkg_line, nsp)
+
+        if self.dry_run:
+            # always generate the lines, even in dry run
+            list(lines)
+            return
+
+        with open(filename, 'wt') as f:
+            f.writelines(lines)
+
+    def uninstall_namespaces(self):
+        filename, ext = os.path.splitext(self._get_target())
+        filename += self.nspkg_ext
+        if not os.path.exists(filename):
+            return
+        log.info("Removing %s", filename)
+        os.remove(filename)
+
+    def _get_target(self):
+        return self.target
+
+    _nspkg_tmpl = (
+        "import sys, types, os",
+        "has_mfs = sys.version_info > (3, 5)",
+        "p = os.path.join(%(root)s, *%(pth)r)",
+        "importlib = has_mfs and __import__('importlib.util')",
+        "has_mfs and __import__('importlib.machinery')",
+        "m = has_mfs and "
+            "sys.modules.setdefault(%(pkg)r, "
+                "importlib.util.module_from_spec("
+                    "importlib.machinery.PathFinder.find_spec(%(pkg)r, "
+                        "[os.path.dirname(p)])))",
+        "m = m or "
+            "sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))",
+        "mp = (m or []) and m.__dict__.setdefault('__path__',[])",
+        "(p not in mp) and mp.append(p)",
+    )
+    "lines for the namespace installer"
+
+    _nspkg_tmpl_multi = (
+        'm and setattr(sys.modules[%(parent)r], %(child)r, m)',
+    )
+    "additional line(s) when a parent package is indicated"
+
+    def _get_root(self):
+        return "sys._getframe(1).f_locals['sitedir']"
+
+    def _gen_nspkg_line(self, pkg):
+        # ensure pkg is not a unicode string under Python 2.7
+        pkg = str(pkg)
+        pth = tuple(pkg.split('.'))
+        root = self._get_root()
+        tmpl_lines = self._nspkg_tmpl
+        parent, sep, child = pkg.rpartition('.')
+        if parent:
+            tmpl_lines += self._nspkg_tmpl_multi
+        return ';'.join(tmpl_lines) % locals() + '\n'
+
+    def _get_all_ns_packages(self):
+        """Return sorted list of all package namespaces"""
+        pkgs = self.distribution.namespace_packages or []
+        return sorted(flatten(map(self._pkg_names, pkgs)))
+
+    @staticmethod
+    def _pkg_names(pkg):
+        """
+        Given a namespace package, yield the components of that
+        package.
+
+        >>> names = Installer._pkg_names('a.b.c')
+        >>> set(names) == set(['a', 'a.b', 'a.b.c'])
+        True
+        """
+        parts = pkg.split('.')
+        while parts:
+            yield '.'.join(parts)
+            parts.pop()
+
+
+class DevelopInstaller(Installer):
+    def _get_root(self):
+        return repr(str(self.egg_path))
+
+    def _get_target(self):
+        return self.egg_link
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/package_index.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/package_index.py
new file mode 100644
index 0000000000000000000000000000000000000000..f419d47167b39a71275744b2f2a78f85c9919a8d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/package_index.py
@@ -0,0 +1,1136 @@
+"""PyPI and direct package downloading"""
+import sys
+import os
+import re
+import shutil
+import socket
+import base64
+import hashlib
+import itertools
+import warnings
+from functools import wraps
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import urllib, http_client, configparser, map
+
+import setuptools
+from pkg_resources import (
+    CHECKOUT_DIST, Distribution, BINARY_DIST, normalize_path, SOURCE_DIST,
+    Environment, find_distributions, safe_name, safe_version,
+    to_filename, Requirement, DEVELOP_DIST, EGG_DIST,
+)
+from setuptools import ssl_support
+from distutils import log
+from distutils.errors import DistutilsError
+from fnmatch import translate
+from setuptools.py27compat import get_all_headers
+from setuptools.py33compat import unescape
+from setuptools.wheel import Wheel
+
+__metaclass__ = type
+
+EGG_FRAGMENT = re.compile(r'^egg=([-A-Za-z0-9_.+!]+)$')
+HREF = re.compile(r"""href\s*=\s*['"]?([^'"> ]+)""", re.I)
+PYPI_MD5 = re.compile(
+    r'<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)'
+    r'href="[^?]+\?:action=show_md5&amp;digest=([0-9a-f]{32})">md5</a>\)'
+)
+URL_SCHEME = re.compile('([-+.a-z0-9]{2,}):', re.I).match
+EXTENSIONS = ".tar.gz .tar.bz2 .tar .zip .tgz".split()
+
+__all__ = [
+    'PackageIndex', 'distros_for_url', 'parse_bdist_wininst',
+    'interpret_distro_name',
+]
+
+_SOCKET_TIMEOUT = 15
+
+_tmpl = "setuptools/{setuptools.__version__} Python-urllib/{py_major}"
+user_agent = _tmpl.format(py_major='{}.{}'.format(*sys.version_info), setuptools=setuptools)
+
+
+def parse_requirement_arg(spec):
+    try:
+        return Requirement.parse(spec)
+    except ValueError:
+        raise DistutilsError(
+            "Not a URL, existing file, or requirement spec: %r" % (spec,)
+        )
+
+
+def parse_bdist_wininst(name):
+    """Return (base,pyversion) or (None,None) for possible .exe name"""
+
+    lower = name.lower()
+    base, py_ver, plat = None, None, None
+
+    if lower.endswith('.exe'):
+        if lower.endswith('.win32.exe'):
+            base = name[:-10]
+            plat = 'win32'
+        elif lower.startswith('.win32-py', -16):
+            py_ver = name[-7:-4]
+            base = name[:-16]
+            plat = 'win32'
+        elif lower.endswith('.win-amd64.exe'):
+            base = name[:-14]
+            plat = 'win-amd64'
+        elif lower.startswith('.win-amd64-py', -20):
+            py_ver = name[-7:-4]
+            base = name[:-20]
+            plat = 'win-amd64'
+    return base, py_ver, plat
+
+
+def egg_info_for_url(url):
+    parts = urllib.parse.urlparse(url)
+    scheme, server, path, parameters, query, fragment = parts
+    base = urllib.parse.unquote(path.split('/')[-1])
+    if server == 'sourceforge.net' and base == 'download':  # XXX Yuck
+        base = urllib.parse.unquote(path.split('/')[-2])
+    if '#' in base:
+        base, fragment = base.split('#', 1)
+    return base, fragment
+
+
+def distros_for_url(url, metadata=None):
+    """Yield egg or source distribution objects that might be found at a URL"""
+    base, fragment = egg_info_for_url(url)
+    for dist in distros_for_location(url, base, metadata):
+        yield dist
+    if fragment:
+        match = EGG_FRAGMENT.match(fragment)
+        if match:
+            for dist in interpret_distro_name(
+                url, match.group(1), metadata, precedence=CHECKOUT_DIST
+            ):
+                yield dist
+
+
+def distros_for_location(location, basename, metadata=None):
+    """Yield egg or source distribution objects based on basename"""
+    if basename.endswith('.egg.zip'):
+        basename = basename[:-4]  # strip the .zip
+    if basename.endswith('.egg') and '-' in basename:
+        # only one, unambiguous interpretation
+        return [Distribution.from_location(location, basename, metadata)]
+    if basename.endswith('.whl') and '-' in basename:
+        wheel = Wheel(basename)
+        if not wheel.is_compatible():
+            return []
+        return [Distribution(
+            location=location,
+            project_name=wheel.project_name,
+            version=wheel.version,
+            # Increase priority over eggs.
+            precedence=EGG_DIST + 1,
+        )]
+    if basename.endswith('.exe'):
+        win_base, py_ver, platform = parse_bdist_wininst(basename)
+        if win_base is not None:
+            return interpret_distro_name(
+                location, win_base, metadata, py_ver, BINARY_DIST, platform
+            )
+    # Try source distro extensions (.zip, .tgz, etc.)
+    #
+    for ext in EXTENSIONS:
+        if basename.endswith(ext):
+            basename = basename[:-len(ext)]
+            return interpret_distro_name(location, basename, metadata)
+    return []  # no extension matched
+
+
+def distros_for_filename(filename, metadata=None):
+    """Yield possible egg or source distribution objects based on a filename"""
+    return distros_for_location(
+        normalize_path(filename), os.path.basename(filename), metadata
+    )
+
+
+def interpret_distro_name(
+        location, basename, metadata, py_version=None, precedence=SOURCE_DIST,
+        platform=None
+):
+    """Generate alternative interpretations of a source distro name
+
+    Note: if `location` is a filesystem filename, you should call
+    ``pkg_resources.normalize_path()`` on it before passing it to this
+    routine!
+    """
+    # Generate alternative interpretations of a source distro name
+    # Because some packages are ambiguous as to name/versions split
+    # e.g. "adns-python-1.1.0", "egenix-mx-commercial", etc.
+    # So, we generate each possible interepretation (e.g. "adns, python-1.1.0"
+    # "adns-python, 1.1.0", and "adns-python-1.1.0, no version").  In practice,
+    # the spurious interpretations should be ignored, because in the event
+    # there's also an "adns" package, the spurious "python-1.1.0" version will
+    # compare lower than any numeric version number, and is therefore unlikely
+    # to match a request for it.  It's still a potential problem, though, and
+    # in the long run PyPI and the distutils should go for "safe" names and
+    # versions in distribution archive names (sdist and bdist).
+
+    parts = basename.split('-')
+    if not py_version and any(re.match(r'py\d\.\d$', p) for p in parts[2:]):
+        # it is a bdist_dumb, not an sdist -- bail out
+        return
+
+    for p in range(1, len(parts) + 1):
+        yield Distribution(
+            location, metadata, '-'.join(parts[:p]), '-'.join(parts[p:]),
+            py_version=py_version, precedence=precedence,
+            platform=platform
+        )
+
+
+# From Python 2.7 docs
+def unique_everseen(iterable, key=None):
+    "List unique elements, preserving order. Remember all elements ever seen."
+    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
+    # unique_everseen('ABBCcAD', str.lower) --> A B C D
+    seen = set()
+    seen_add = seen.add
+    if key is None:
+        for element in six.moves.filterfalse(seen.__contains__, iterable):
+            seen_add(element)
+            yield element
+    else:
+        for element in iterable:
+            k = key(element)
+            if k not in seen:
+                seen_add(k)
+                yield element
+
+
+def unique_values(func):
+    """
+    Wrap a function returning an iterable such that the resulting iterable
+    only ever yields unique items.
+    """
+
+    @wraps(func)
+    def wrapper(*args, **kwargs):
+        return unique_everseen(func(*args, **kwargs))
+
+    return wrapper
+
+
+REL = re.compile(r"""<([^>]*\srel\s*=\s*['"]?([^'">]+)[^>]*)>""", re.I)
+# this line is here to fix emacs' cruddy broken syntax highlighting
+
+
+@unique_values
+def find_external_links(url, page):
+    """Find rel="homepage" and rel="download" links in `page`, yielding URLs"""
+
+    for match in REL.finditer(page):
+        tag, rel = match.groups()
+        rels = set(map(str.strip, rel.lower().split(',')))
+        if 'homepage' in rels or 'download' in rels:
+            for match in HREF.finditer(tag):
+                yield urllib.parse.urljoin(url, htmldecode(match.group(1)))
+
+    for tag in ("<th>Home Page", "<th>Download URL"):
+        pos = page.find(tag)
+        if pos != -1:
+            match = HREF.search(page, pos)
+            if match:
+                yield urllib.parse.urljoin(url, htmldecode(match.group(1)))
+
+
+class ContentChecker:
+    """
+    A null content checker that defines the interface for checking content
+    """
+
+    def feed(self, block):
+        """
+        Feed a block of data to the hash.
+        """
+        return
+
+    def is_valid(self):
+        """
+        Check the hash. Return False if validation fails.
+        """
+        return True
+
+    def report(self, reporter, template):
+        """
+        Call reporter with information about the checker (hash name)
+        substituted into the template.
+        """
+        return
+
+
+class HashChecker(ContentChecker):
+    pattern = re.compile(
+        r'(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)='
+        r'(?P<expected>[a-f0-9]+)'
+    )
+
+    def __init__(self, hash_name, expected):
+        self.hash_name = hash_name
+        self.hash = hashlib.new(hash_name)
+        self.expected = expected
+
+    @classmethod
+    def from_url(cls, url):
+        "Construct a (possibly null) ContentChecker from a URL"
+        fragment = urllib.parse.urlparse(url)[-1]
+        if not fragment:
+            return ContentChecker()
+        match = cls.pattern.search(fragment)
+        if not match:
+            return ContentChecker()
+        return cls(**match.groupdict())
+
+    def feed(self, block):
+        self.hash.update(block)
+
+    def is_valid(self):
+        return self.hash.hexdigest() == self.expected
+
+    def report(self, reporter, template):
+        msg = template % self.hash_name
+        return reporter(msg)
+
+
+class PackageIndex(Environment):
+    """A distribution index that scans web pages for download URLs"""
+
+    def __init__(
+            self, index_url="https://pypi.org/simple/", hosts=('*',),
+            ca_bundle=None, verify_ssl=True, *args, **kw
+    ):
+        Environment.__init__(self, *args, **kw)
+        self.index_url = index_url + "/" [:not index_url.endswith('/')]
+        self.scanned_urls = {}
+        self.fetched_urls = {}
+        self.package_pages = {}
+        self.allows = re.compile('|'.join(map(translate, hosts))).match
+        self.to_scan = []
+        use_ssl = (
+            verify_ssl
+            and ssl_support.is_available
+            and (ca_bundle or ssl_support.find_ca_bundle())
+        )
+        if use_ssl:
+            self.opener = ssl_support.opener_for(ca_bundle)
+        else:
+            self.opener = urllib.request.urlopen
+
+    def process_url(self, url, retrieve=False):
+        """Evaluate a URL as a possible download, and maybe retrieve it"""
+        if url in self.scanned_urls and not retrieve:
+            return
+        self.scanned_urls[url] = True
+        if not URL_SCHEME(url):
+            self.process_filename(url)
+            return
+        else:
+            dists = list(distros_for_url(url))
+            if dists:
+                if not self.url_ok(url):
+                    return
+                self.debug("Found link: %s", url)
+
+        if dists or not retrieve or url in self.fetched_urls:
+            list(map(self.add, dists))
+            return  # don't need the actual page
+
+        if not self.url_ok(url):
+            self.fetched_urls[url] = True
+            return
+
+        self.info("Reading %s", url)
+        self.fetched_urls[url] = True  # prevent multiple fetch attempts
+        tmpl = "Download error on %s: %%s -- Some packages may not be found!"
+        f = self.open_url(url, tmpl % url)
+        if f is None:
+            return
+        self.fetched_urls[f.url] = True
+        if 'html' not in f.headers.get('content-type', '').lower():
+            f.close()  # not html, we can't process it
+            return
+
+        base = f.url  # handle redirects
+        page = f.read()
+        if not isinstance(page, str):
+            # In Python 3 and got bytes but want str.
+            if isinstance(f, urllib.error.HTTPError):
+                # Errors have no charset, assume latin1:
+                charset = 'latin-1'
+            else:
+                charset = f.headers.get_param('charset') or 'latin-1'
+            page = page.decode(charset, "ignore")
+        f.close()
+        for match in HREF.finditer(page):
+            link = urllib.parse.urljoin(base, htmldecode(match.group(1)))
+            self.process_url(link)
+        if url.startswith(self.index_url) and getattr(f, 'code', None) != 404:
+            page = self.process_index(url, page)
+
+    def process_filename(self, fn, nested=False):
+        # process filenames or directories
+        if not os.path.exists(fn):
+            self.warn("Not found: %s", fn)
+            return
+
+        if os.path.isdir(fn) and not nested:
+            path = os.path.realpath(fn)
+            for item in os.listdir(path):
+                self.process_filename(os.path.join(path, item), True)
+
+        dists = distros_for_filename(fn)
+        if dists:
+            self.debug("Found: %s", fn)
+            list(map(self.add, dists))
+
+    def url_ok(self, url, fatal=False):
+        s = URL_SCHEME(url)
+        is_file = s and s.group(1).lower() == 'file'
+        if is_file or self.allows(urllib.parse.urlparse(url)[1]):
+            return True
+        msg = (
+            "\nNote: Bypassing %s (disallowed host; see "
+            "http://bit.ly/2hrImnY for details).\n")
+        if fatal:
+            raise DistutilsError(msg % url)
+        else:
+            self.warn(msg, url)
+
+    def scan_egg_links(self, search_path):
+        dirs = filter(os.path.isdir, search_path)
+        egg_links = (
+            (path, entry)
+            for path in dirs
+            for entry in os.listdir(path)
+            if entry.endswith('.egg-link')
+        )
+        list(itertools.starmap(self.scan_egg_link, egg_links))
+
+    def scan_egg_link(self, path, entry):
+        with open(os.path.join(path, entry)) as raw_lines:
+            # filter non-empty lines
+            lines = list(filter(None, map(str.strip, raw_lines)))
+
+        if len(lines) != 2:
+            # format is not recognized; punt
+            return
+
+        egg_path, setup_path = lines
+
+        for dist in find_distributions(os.path.join(path, egg_path)):
+            dist.location = os.path.join(path, *lines)
+            dist.precedence = SOURCE_DIST
+            self.add(dist)
+
+    def process_index(self, url, page):
+        """Process the contents of a PyPI page"""
+
+        def scan(link):
+            # Process a URL to see if it's for a package page
+            if link.startswith(self.index_url):
+                parts = list(map(
+                    urllib.parse.unquote, link[len(self.index_url):].split('/')
+                ))
+                if len(parts) == 2 and '#' not in parts[1]:
+                    # it's a package page, sanitize and index it
+                    pkg = safe_name(parts[0])
+                    ver = safe_version(parts[1])
+                    self.package_pages.setdefault(pkg.lower(), {})[link] = True
+                    return to_filename(pkg), to_filename(ver)
+            return None, None
+
+        # process an index page into the package-page index
+        for match in HREF.finditer(page):
+            try:
+                scan(urllib.parse.urljoin(url, htmldecode(match.group(1))))
+            except ValueError:
+                pass
+
+        pkg, ver = scan(url)  # ensure this page is in the page index
+        if pkg:
+            # process individual package page
+            for new_url in find_external_links(url, page):
+                # Process the found URL
+                base, frag = egg_info_for_url(new_url)
+                if base.endswith('.py') and not frag:
+                    if ver:
+                        new_url += '#egg=%s-%s' % (pkg, ver)
+                    else:
+                        self.need_version_info(url)
+                self.scan_url(new_url)
+
+            return PYPI_MD5.sub(
+                lambda m: '<a href="%s#md5=%s">%s</a>' % m.group(1, 3, 2), page
+            )
+        else:
+            return ""  # no sense double-scanning non-package pages
+
+    def need_version_info(self, url):
+        self.scan_all(
+            "Page at %s links to .py file(s) without version info; an index "
+            "scan is required.", url
+        )
+
+    def scan_all(self, msg=None, *args):
+        if self.index_url not in self.fetched_urls:
+            if msg:
+                self.warn(msg, *args)
+            self.info(
+                "Scanning index of all packages (this may take a while)"
+            )
+        self.scan_url(self.index_url)
+
+    def find_packages(self, requirement):
+        self.scan_url(self.index_url + requirement.unsafe_name + '/')
+
+        if not self.package_pages.get(requirement.key):
+            # Fall back to safe version of the name
+            self.scan_url(self.index_url + requirement.project_name + '/')
+
+        if not self.package_pages.get(requirement.key):
+            # We couldn't find the target package, so search the index page too
+            self.not_found_in_index(requirement)
+
+        for url in list(self.package_pages.get(requirement.key, ())):
+            # scan each page that might be related to the desired package
+            self.scan_url(url)
+
+    def obtain(self, requirement, installer=None):
+        self.prescan()
+        self.find_packages(requirement)
+        for dist in self[requirement.key]:
+            if dist in requirement:
+                return dist
+            self.debug("%s does not match %s", requirement, dist)
+        return super(PackageIndex, self).obtain(requirement, installer)
+
+    def check_hash(self, checker, filename, tfp):
+        """
+        checker is a ContentChecker
+        """
+        checker.report(
+            self.debug,
+            "Validating %%s checksum for %s" % filename)
+        if not checker.is_valid():
+            tfp.close()
+            os.unlink(filename)
+            raise DistutilsError(
+                "%s validation failed for %s; "
+                "possible download problem?"
+                % (checker.hash.name, os.path.basename(filename))
+            )
+
+    def add_find_links(self, urls):
+        """Add `urls` to the list that will be prescanned for searches"""
+        for url in urls:
+            if (
+                self.to_scan is None  # if we have already "gone online"
+                or not URL_SCHEME(url)  # or it's a local file/directory
+                or url.startswith('file:')
+                or list(distros_for_url(url))  # or a direct package link
+            ):
+                # then go ahead and process it now
+                self.scan_url(url)
+            else:
+                # otherwise, defer retrieval till later
+                self.to_scan.append(url)
+
+    def prescan(self):
+        """Scan urls scheduled for prescanning (e.g. --find-links)"""
+        if self.to_scan:
+            list(map(self.scan_url, self.to_scan))
+        self.to_scan = None  # from now on, go ahead and process immediately
+
+    def not_found_in_index(self, requirement):
+        if self[requirement.key]:  # we've seen at least one distro
+            meth, msg = self.info, "Couldn't retrieve index page for %r"
+        else:  # no distros seen for this name, might be misspelled
+            meth, msg = (
+                self.warn,
+                "Couldn't find index page for %r (maybe misspelled?)")
+        meth(msg, requirement.unsafe_name)
+        self.scan_all()
+
+    def download(self, spec, tmpdir):
+        """Locate and/or download `spec` to `tmpdir`, returning a local path
+
+        `spec` may be a ``Requirement`` object, or a string containing a URL,
+        an existing local filename, or a project/version requirement spec
+        (i.e. the string form of a ``Requirement`` object).  If it is the URL
+        of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one
+        that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is
+        automatically created alongside the downloaded file.
+
+        If `spec` is a ``Requirement`` object or a string containing a
+        project/version requirement spec, this method returns the location of
+        a matching distribution (possibly after downloading it to `tmpdir`).
+        If `spec` is a locally existing file or directory name, it is simply
+        returned unchanged.  If `spec` is a URL, it is downloaded to a subpath
+        of `tmpdir`, and the local filename is returned.  Various errors may be
+        raised if a problem occurs during downloading.
+        """
+        if not isinstance(spec, Requirement):
+            scheme = URL_SCHEME(spec)
+            if scheme:
+                # It's a url, download it to tmpdir
+                found = self._download_url(scheme.group(1), spec, tmpdir)
+                base, fragment = egg_info_for_url(spec)
+                if base.endswith('.py'):
+                    found = self.gen_setup(found, fragment, tmpdir)
+                return found
+            elif os.path.exists(spec):
+                # Existing file or directory, just return it
+                return spec
+            else:
+                spec = parse_requirement_arg(spec)
+        return getattr(self.fetch_distribution(spec, tmpdir), 'location', None)
+
+    def fetch_distribution(
+            self, requirement, tmpdir, force_scan=False, source=False,
+            develop_ok=False, local_index=None):
+        """Obtain a distribution suitable for fulfilling `requirement`
+
+        `requirement` must be a ``pkg_resources.Requirement`` instance.
+        If necessary, or if the `force_scan` flag is set, the requirement is
+        searched for in the (online) package index as well as the locally
+        installed packages.  If a distribution matching `requirement` is found,
+        the returned distribution's ``location`` is the value you would have
+        gotten from calling the ``download()`` method with the matching
+        distribution's URL or filename.  If no matching distribution is found,
+        ``None`` is returned.
+
+        If the `source` flag is set, only source distributions and source
+        checkout links will be considered.  Unless the `develop_ok` flag is
+        set, development and system eggs (i.e., those using the ``.egg-info``
+        format) will be ignored.
+        """
+        # process a Requirement
+        self.info("Searching for %s", requirement)
+        skipped = {}
+        dist = None
+
+        def find(req, env=None):
+            if env is None:
+                env = self
+            # Find a matching distribution; may be called more than once
+
+            for dist in env[req.key]:
+
+                if dist.precedence == DEVELOP_DIST and not develop_ok:
+                    if dist not in skipped:
+                        self.warn(
+                            "Skipping development or system egg: %s", dist,
+                        )
+                        skipped[dist] = 1
+                    continue
+
+                test = (
+                    dist in req
+                    and (dist.precedence <= SOURCE_DIST or not source)
+                )
+                if test:
+                    loc = self.download(dist.location, tmpdir)
+                    dist.download_location = loc
+                    if os.path.exists(dist.download_location):
+                        return dist
+
+        if force_scan:
+            self.prescan()
+            self.find_packages(requirement)
+            dist = find(requirement)
+
+        if not dist and local_index is not None:
+            dist = find(requirement, local_index)
+
+        if dist is None:
+            if self.to_scan is not None:
+                self.prescan()
+            dist = find(requirement)
+
+        if dist is None and not force_scan:
+            self.find_packages(requirement)
+            dist = find(requirement)
+
+        if dist is None:
+            self.warn(
+                "No local packages or working download links found for %s%s",
+                (source and "a source distribution of " or ""),
+                requirement,
+            )
+        else:
+            self.info("Best match: %s", dist)
+            return dist.clone(location=dist.download_location)
+
+    def fetch(self, requirement, tmpdir, force_scan=False, source=False):
+        """Obtain a file suitable for fulfilling `requirement`
+
+        DEPRECATED; use the ``fetch_distribution()`` method now instead.  For
+        backward compatibility, this routine is identical but returns the
+        ``location`` of the downloaded distribution instead of a distribution
+        object.
+        """
+        dist = self.fetch_distribution(requirement, tmpdir, force_scan, source)
+        if dist is not None:
+            return dist.location
+        return None
+
+    def gen_setup(self, filename, fragment, tmpdir):
+        match = EGG_FRAGMENT.match(fragment)
+        dists = match and [
+            d for d in
+            interpret_distro_name(filename, match.group(1), None) if d.version
+        ] or []
+
+        if len(dists) == 1:  # unambiguous ``#egg`` fragment
+            basename = os.path.basename(filename)
+
+            # Make sure the file has been downloaded to the temp dir.
+            if os.path.dirname(filename) != tmpdir:
+                dst = os.path.join(tmpdir, basename)
+                from setuptools.command.easy_install import samefile
+                if not samefile(filename, dst):
+                    shutil.copy2(filename, dst)
+                    filename = dst
+
+            with open(os.path.join(tmpdir, 'setup.py'), 'w') as file:
+                file.write(
+                    "from setuptools import setup\n"
+                    "setup(name=%r, version=%r, py_modules=[%r])\n"
+                    % (
+                        dists[0].project_name, dists[0].version,
+                        os.path.splitext(basename)[0]
+                    )
+                )
+            return filename
+
+        elif match:
+            raise DistutilsError(
+                "Can't unambiguously interpret project/version identifier %r; "
+                "any dashes in the name or version should be escaped using "
+                "underscores. %r" % (fragment, dists)
+            )
+        else:
+            raise DistutilsError(
+                "Can't process plain .py files without an '#egg=name-version'"
+                " suffix to enable automatic setup script generation."
+            )
+
+    dl_blocksize = 8192
+
+    def _download_to(self, url, filename):
+        self.info("Downloading %s", url)
+        # Download the file
+        fp = None
+        try:
+            checker = HashChecker.from_url(url)
+            fp = self.open_url(url)
+            if isinstance(fp, urllib.error.HTTPError):
+                raise DistutilsError(
+                    "Can't download %s: %s %s" % (url, fp.code, fp.msg)
+                )
+            headers = fp.info()
+            blocknum = 0
+            bs = self.dl_blocksize
+            size = -1
+            if "content-length" in headers:
+                # Some servers return multiple Content-Length headers :(
+                sizes = get_all_headers(headers, 'Content-Length')
+                size = max(map(int, sizes))
+                self.reporthook(url, filename, blocknum, bs, size)
+            with open(filename, 'wb') as tfp:
+                while True:
+                    block = fp.read(bs)
+                    if block:
+                        checker.feed(block)
+                        tfp.write(block)
+                        blocknum += 1
+                        self.reporthook(url, filename, blocknum, bs, size)
+                    else:
+                        break
+                self.check_hash(checker, filename, tfp)
+            return headers
+        finally:
+            if fp:
+                fp.close()
+
+    def reporthook(self, url, filename, blocknum, blksize, size):
+        pass  # no-op
+
+    def open_url(self, url, warning=None):
+        if url.startswith('file:'):
+            return local_open(url)
+        try:
+            return open_with_auth(url, self.opener)
+        except (ValueError, http_client.InvalidURL) as v:
+            msg = ' '.join([str(arg) for arg in v.args])
+            if warning:
+                self.warn(warning, msg)
+            else:
+                raise DistutilsError('%s %s' % (url, msg))
+        except urllib.error.HTTPError as v:
+            return v
+        except urllib.error.URLError as v:
+            if warning:
+                self.warn(warning, v.reason)
+            else:
+                raise DistutilsError("Download error for %s: %s"
+                                     % (url, v.reason))
+        except http_client.BadStatusLine as v:
+            if warning:
+                self.warn(warning, v.line)
+            else:
+                raise DistutilsError(
+                    '%s returned a bad status line. The server might be '
+                    'down, %s' %
+                    (url, v.line)
+                )
+        except (http_client.HTTPException, socket.error) as v:
+            if warning:
+                self.warn(warning, v)
+            else:
+                raise DistutilsError("Download error for %s: %s"
+                                     % (url, v))
+
+    def _download_url(self, scheme, url, tmpdir):
+        # Determine download filename
+        #
+        name, fragment = egg_info_for_url(url)
+        if name:
+            while '..' in name:
+                name = name.replace('..', '.').replace('\\', '_')
+        else:
+            name = "__downloaded__"  # default if URL has no path contents
+
+        if name.endswith('.egg.zip'):
+            name = name[:-4]  # strip the extra .zip before download
+
+        filename = os.path.join(tmpdir, name)
+
+        # Download the file
+        #
+        if scheme == 'svn' or scheme.startswith('svn+'):
+            return self._download_svn(url, filename)
+        elif scheme == 'git' or scheme.startswith('git+'):
+            return self._download_git(url, filename)
+        elif scheme.startswith('hg+'):
+            return self._download_hg(url, filename)
+        elif scheme == 'file':
+            return urllib.request.url2pathname(urllib.parse.urlparse(url)[2])
+        else:
+            self.url_ok(url, True)  # raises error if not allowed
+            return self._attempt_download(url, filename)
+
+    def scan_url(self, url):
+        self.process_url(url, True)
+
+    def _attempt_download(self, url, filename):
+        headers = self._download_to(url, filename)
+        if 'html' in headers.get('content-type', '').lower():
+            return self._download_html(url, headers, filename)
+        else:
+            return filename
+
+    def _download_html(self, url, headers, filename):
+        file = open(filename)
+        for line in file:
+            if line.strip():
+                # Check for a subversion index page
+                if re.search(r'<title>([^- ]+ - )?Revision \d+:', line):
+                    # it's a subversion index page:
+                    file.close()
+                    os.unlink(filename)
+                    return self._download_svn(url, filename)
+                break  # not an index page
+        file.close()
+        os.unlink(filename)
+        raise DistutilsError("Unexpected HTML page found at " + url)
+
+    def _download_svn(self, url, filename):
+        warnings.warn("SVN download support is deprecated", UserWarning)
+        url = url.split('#', 1)[0]  # remove any fragment for svn's sake
+        creds = ''
+        if url.lower().startswith('svn:') and '@' in url:
+            scheme, netloc, path, p, q, f = urllib.parse.urlparse(url)
+            if not netloc and path.startswith('//') and '/' in path[2:]:
+                netloc, path = path[2:].split('/', 1)
+                auth, host = _splituser(netloc)
+                if auth:
+                    if ':' in auth:
+                        user, pw = auth.split(':', 1)
+                        creds = " --username=%s --password=%s" % (user, pw)
+                    else:
+                        creds = " --username=" + auth
+                    netloc = host
+                    parts = scheme, netloc, url, p, q, f
+                    url = urllib.parse.urlunparse(parts)
+        self.info("Doing subversion checkout from %s to %s", url, filename)
+        os.system("svn checkout%s -q %s %s" % (creds, url, filename))
+        return filename
+
+    @staticmethod
+    def _vcs_split_rev_from_url(url, pop_prefix=False):
+        scheme, netloc, path, query, frag = urllib.parse.urlsplit(url)
+
+        scheme = scheme.split('+', 1)[-1]
+
+        # Some fragment identification fails
+        path = path.split('#', 1)[0]
+
+        rev = None
+        if '@' in path:
+            path, rev = path.rsplit('@', 1)
+
+        # Also, discard fragment
+        url = urllib.parse.urlunsplit((scheme, netloc, path, query, ''))
+
+        return url, rev
+
+    def _download_git(self, url, filename):
+        filename = filename.split('#', 1)[0]
+        url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True)
+
+        self.info("Doing git clone from %s to %s", url, filename)
+        os.system("git clone --quiet %s %s" % (url, filename))
+
+        if rev is not None:
+            self.info("Checking out %s", rev)
+            os.system("git -C %s checkout --quiet %s" % (
+                filename,
+                rev,
+            ))
+
+        return filename
+
+    def _download_hg(self, url, filename):
+        filename = filename.split('#', 1)[0]
+        url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True)
+
+        self.info("Doing hg clone from %s to %s", url, filename)
+        os.system("hg clone --quiet %s %s" % (url, filename))
+
+        if rev is not None:
+            self.info("Updating to %s", rev)
+            os.system("hg --cwd %s up -C -r %s -q" % (
+                filename,
+                rev,
+            ))
+
+        return filename
+
+    def debug(self, msg, *args):
+        log.debug(msg, *args)
+
+    def info(self, msg, *args):
+        log.info(msg, *args)
+
+    def warn(self, msg, *args):
+        log.warn(msg, *args)
+
+
+# This pattern matches a character entity reference (a decimal numeric
+# references, a hexadecimal numeric reference, or a named reference).
+entity_sub = re.compile(r'&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?').sub
+
+
+def decode_entity(match):
+    what = match.group(0)
+    return unescape(what)
+
+
+def htmldecode(text):
+    """
+    Decode HTML entities in the given text.
+
+    >>> htmldecode(
+    ...     'https://../package_name-0.1.2.tar.gz'
+    ...     '?tokena=A&amp;tokenb=B">package_name-0.1.2.tar.gz')
+    'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz'
+    """
+    return entity_sub(decode_entity, text)
+
+
+def socket_timeout(timeout=15):
+    def _socket_timeout(func):
+        def _socket_timeout(*args, **kwargs):
+            old_timeout = socket.getdefaulttimeout()
+            socket.setdefaulttimeout(timeout)
+            try:
+                return func(*args, **kwargs)
+            finally:
+                socket.setdefaulttimeout(old_timeout)
+
+        return _socket_timeout
+
+    return _socket_timeout
+
+
+def _encode_auth(auth):
+    """
+    A function compatible with Python 2.3-3.3 that will encode
+    auth from a URL suitable for an HTTP header.
+    >>> str(_encode_auth('username%3Apassword'))
+    'dXNlcm5hbWU6cGFzc3dvcmQ='
+
+    Long auth strings should not cause a newline to be inserted.
+    >>> long_auth = 'username:' + 'password'*10
+    >>> chr(10) in str(_encode_auth(long_auth))
+    False
+    """
+    auth_s = urllib.parse.unquote(auth)
+    # convert to bytes
+    auth_bytes = auth_s.encode()
+    encoded_bytes = base64.b64encode(auth_bytes)
+    # convert back to a string
+    encoded = encoded_bytes.decode()
+    # strip the trailing carriage return
+    return encoded.replace('\n', '')
+
+
+class Credential:
+    """
+    A username/password pair. Use like a namedtuple.
+    """
+
+    def __init__(self, username, password):
+        self.username = username
+        self.password = password
+
+    def __iter__(self):
+        yield self.username
+        yield self.password
+
+    def __str__(self):
+        return '%(username)s:%(password)s' % vars(self)
+
+
+class PyPIConfig(configparser.RawConfigParser):
+    def __init__(self):
+        """
+        Load from ~/.pypirc
+        """
+        defaults = dict.fromkeys(['username', 'password', 'repository'], '')
+        configparser.RawConfigParser.__init__(self, defaults)
+
+        rc = os.path.join(os.path.expanduser('~'), '.pypirc')
+        if os.path.exists(rc):
+            self.read(rc)
+
+    @property
+    def creds_by_repository(self):
+        sections_with_repositories = [
+            section for section in self.sections()
+            if self.get(section, 'repository').strip()
+        ]
+
+        return dict(map(self._get_repo_cred, sections_with_repositories))
+
+    def _get_repo_cred(self, section):
+        repo = self.get(section, 'repository').strip()
+        return repo, Credential(
+            self.get(section, 'username').strip(),
+            self.get(section, 'password').strip(),
+        )
+
+    def find_credential(self, url):
+        """
+        If the URL indicated appears to be a repository defined in this
+        config, return the credential for that repository.
+        """
+        for repository, cred in self.creds_by_repository.items():
+            if url.startswith(repository):
+                return cred
+
+
+def open_with_auth(url, opener=urllib.request.urlopen):
+    """Open a urllib2 request, handling HTTP authentication"""
+
+    parsed = urllib.parse.urlparse(url)
+    scheme, netloc, path, params, query, frag = parsed
+
+    # Double scheme does not raise on Mac OS X as revealed by a
+    # failing test. We would expect "nonnumeric port". Refs #20.
+    if netloc.endswith(':'):
+        raise http_client.InvalidURL("nonnumeric port: ''")
+
+    if scheme in ('http', 'https'):
+        auth, address = _splituser(netloc)
+    else:
+        auth = None
+
+    if not auth:
+        cred = PyPIConfig().find_credential(url)
+        if cred:
+            auth = str(cred)
+            info = cred.username, url
+            log.info('Authenticating as %s for %s (from .pypirc)', *info)
+
+    if auth:
+        auth = "Basic " + _encode_auth(auth)
+        parts = scheme, address, path, params, query, frag
+        new_url = urllib.parse.urlunparse(parts)
+        request = urllib.request.Request(new_url)
+        request.add_header("Authorization", auth)
+    else:
+        request = urllib.request.Request(url)
+
+    request.add_header('User-Agent', user_agent)
+    fp = opener(request)
+
+    if auth:
+        # Put authentication info back into request URL if same host,
+        # so that links found on the page will work
+        s2, h2, path2, param2, query2, frag2 = urllib.parse.urlparse(fp.url)
+        if s2 == scheme and h2 == address:
+            parts = s2, netloc, path2, param2, query2, frag2
+            fp.url = urllib.parse.urlunparse(parts)
+
+    return fp
+
+
+# copy of urllib.parse._splituser from Python 3.8
+def _splituser(host):
+    """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'."""
+    user, delim, host = host.rpartition('@')
+    return (user if delim else None), host
+
+
+# adding a timeout to avoid freezing package_index
+open_with_auth = socket_timeout(_SOCKET_TIMEOUT)(open_with_auth)
+
+
+def fix_sf_url(url):
+    return url  # backward compatibility
+
+
+def local_open(url):
+    """Read a local path, with special support for directories"""
+    scheme, server, path, param, query, frag = urllib.parse.urlparse(url)
+    filename = urllib.request.url2pathname(path)
+    if os.path.isfile(filename):
+        return urllib.request.urlopen(url)
+    elif path.endswith('/') and os.path.isdir(filename):
+        files = []
+        for f in os.listdir(filename):
+            filepath = os.path.join(filename, f)
+            if f == 'index.html':
+                with open(filepath, 'r') as fp:
+                    body = fp.read()
+                break
+            elif os.path.isdir(filepath):
+                f += '/'
+            files.append('<a href="{name}">{name}</a>'.format(name=f))
+        else:
+            tmpl = (
+                "<html><head><title>{url}</title>"
+                "</head><body>{files}</body></html>")
+            body = tmpl.format(url=url, files='\n'.join(files))
+        status, message = 200, "OK"
+    else:
+        status, message, body = 404, "Path not found", "Not found"
+
+    headers = {'content-type': 'text/html'}
+    body_stream = six.StringIO(body)
+    return urllib.error.HTTPError(url, status, message, headers, body_stream)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py27compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py27compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1d57360f4eff13cd94a25fec989036a0b0b80523
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py27compat.py
@@ -0,0 +1,60 @@
+"""
+Compatibility Support for Python 2.7 and earlier
+"""
+
+import sys
+import platform
+
+from setuptools.extern import six
+
+
+def get_all_headers(message, key):
+    """
+    Given an HTTPMessage, return all headers matching a given key.
+    """
+    return message.get_all(key)
+
+
+if six.PY2:
+    def get_all_headers(message, key):
+        return message.getheaders(key)
+
+
+linux_py2_ascii = (
+    platform.system() == 'Linux' and
+    six.PY2
+)
+
+rmtree_safe = str if linux_py2_ascii else lambda x: x
+"""Workaround for http://bugs.python.org/issue24672"""
+
+
+try:
+    from ._imp import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE
+    from ._imp import get_frozen_object, get_module
+except ImportError:
+    import imp
+    from imp import PY_COMPILED, PY_FROZEN, PY_SOURCE  # noqa
+
+    def find_module(module, paths=None):
+        """Just like 'imp.find_module()', but with package support"""
+        parts = module.split('.')
+        while parts:
+            part = parts.pop(0)
+            f, path, (suffix, mode, kind) = info = imp.find_module(part, paths)
+
+            if kind == imp.PKG_DIRECTORY:
+                parts = parts or ['__init__']
+                paths = [path]
+
+            elif parts:
+                raise ImportError("Can't find %r in %s" % (parts, module))
+
+        return info
+
+    def get_frozen_object(module, paths):
+        return imp.get_frozen_object(module)
+
+    def get_module(module, paths, info):
+        imp.load_module(module, *info)
+        return sys.modules[module]
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py31compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py31compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..e1da7ee2a2c56e46e09665d98ba1bc5bfedd2c3e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py31compat.py
@@ -0,0 +1,32 @@
+__all__ = []
+
+__metaclass__ = type
+
+
+try:
+    # Python >=3.2
+    from tempfile import TemporaryDirectory
+except ImportError:
+    import shutil
+    import tempfile
+
+    class TemporaryDirectory:
+        """
+        Very simple temporary directory context manager.
+        Will try to delete afterward, but will also ignore OS and similar
+        errors on deletion.
+        """
+
+        def __init__(self, **kwargs):
+            self.name = None  # Handle mkdtemp raising an exception
+            self.name = tempfile.mkdtemp(**kwargs)
+
+        def __enter__(self):
+            return self.name
+
+        def __exit__(self, exctype, excvalue, exctrace):
+            try:
+                shutil.rmtree(self.name, True)
+            except OSError:  # removal errors are not the only possible
+                pass
+            self.name = None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py33compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py33compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb69443638354b46b43da5bbf187b4f7cba301f1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py33compat.py
@@ -0,0 +1,59 @@
+import dis
+import array
+import collections
+
+try:
+    import html
+except ImportError:
+    html = None
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import html_parser
+
+__metaclass__ = type
+
+OpArg = collections.namedtuple('OpArg', 'opcode arg')
+
+
+class Bytecode_compat:
+    def __init__(self, code):
+        self.code = code
+
+    def __iter__(self):
+        """Yield '(op,arg)' pair for each operation in code object 'code'"""
+
+        bytes = array.array('b', self.code.co_code)
+        eof = len(self.code.co_code)
+
+        ptr = 0
+        extended_arg = 0
+
+        while ptr < eof:
+
+            op = bytes[ptr]
+
+            if op >= dis.HAVE_ARGUMENT:
+
+                arg = bytes[ptr + 1] + bytes[ptr + 2] * 256 + extended_arg
+                ptr += 3
+
+                if op == dis.EXTENDED_ARG:
+                    long_type = six.integer_types[-1]
+                    extended_arg = arg * long_type(65536)
+                    continue
+
+            else:
+                arg = None
+                ptr += 1
+
+            yield OpArg(op, arg)
+
+
+Bytecode = getattr(dis, 'Bytecode', Bytecode_compat)
+
+
+unescape = getattr(html, 'unescape', None)
+if unescape is None:
+    # HTMLParser.unescape is deprecated since Python 3.4, and will be removed
+    # from 3.9.
+    unescape = html_parser.HTMLParser().unescape
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py34compat.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py34compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ad917222a4e5bb93fe1c9e8fe1713bcab3630b6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/py34compat.py
@@ -0,0 +1,13 @@
+import importlib
+
+try:
+    import importlib.util
+except ImportError:
+    pass
+
+
+try:
+    module_from_spec = importlib.util.module_from_spec
+except AttributeError:
+    def module_from_spec(spec):
+        return spec.loader.load_module(spec.name)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/sandbox.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/sandbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..685f3f72e3611a5fa99c999e233ffd179c431a6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/sandbox.py
@@ -0,0 +1,491 @@
+import os
+import sys
+import tempfile
+import operator
+import functools
+import itertools
+import re
+import contextlib
+import pickle
+import textwrap
+
+from setuptools.extern import six
+from setuptools.extern.six.moves import builtins, map
+
+import pkg_resources.py31compat
+
+if sys.platform.startswith('java'):
+    import org.python.modules.posix.PosixModule as _os
+else:
+    _os = sys.modules[os.name]
+try:
+    _file = file
+except NameError:
+    _file = None
+_open = open
+from distutils.errors import DistutilsError
+from pkg_resources import working_set
+
+
+__all__ = [
+    "AbstractSandbox", "DirectorySandbox", "SandboxViolation", "run_setup",
+]
+
+
+def _execfile(filename, globals, locals=None):
+    """
+    Python 3 implementation of execfile.
+    """
+    mode = 'rb'
+    with open(filename, mode) as stream:
+        script = stream.read()
+    if locals is None:
+        locals = globals
+    code = compile(script, filename, 'exec')
+    exec(code, globals, locals)
+
+
+@contextlib.contextmanager
+def save_argv(repl=None):
+    saved = sys.argv[:]
+    if repl is not None:
+        sys.argv[:] = repl
+    try:
+        yield saved
+    finally:
+        sys.argv[:] = saved
+
+
+@contextlib.contextmanager
+def save_path():
+    saved = sys.path[:]
+    try:
+        yield saved
+    finally:
+        sys.path[:] = saved
+
+
+@contextlib.contextmanager
+def override_temp(replacement):
+    """
+    Monkey-patch tempfile.tempdir with replacement, ensuring it exists
+    """
+    pkg_resources.py31compat.makedirs(replacement, exist_ok=True)
+
+    saved = tempfile.tempdir
+
+    tempfile.tempdir = replacement
+
+    try:
+        yield
+    finally:
+        tempfile.tempdir = saved
+
+
+@contextlib.contextmanager
+def pushd(target):
+    saved = os.getcwd()
+    os.chdir(target)
+    try:
+        yield saved
+    finally:
+        os.chdir(saved)
+
+
+class UnpickleableException(Exception):
+    """
+    An exception representing another Exception that could not be pickled.
+    """
+
+    @staticmethod
+    def dump(type, exc):
+        """
+        Always return a dumped (pickled) type and exc. If exc can't be pickled,
+        wrap it in UnpickleableException first.
+        """
+        try:
+            return pickle.dumps(type), pickle.dumps(exc)
+        except Exception:
+            # get UnpickleableException inside the sandbox
+            from setuptools.sandbox import UnpickleableException as cls
+            return cls.dump(cls, cls(repr(exc)))
+
+
+class ExceptionSaver:
+    """
+    A Context Manager that will save an exception, serialized, and restore it
+    later.
+    """
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, type, exc, tb):
+        if not exc:
+            return
+
+        # dump the exception
+        self._saved = UnpickleableException.dump(type, exc)
+        self._tb = tb
+
+        # suppress the exception
+        return True
+
+    def resume(self):
+        "restore and re-raise any exception"
+
+        if '_saved' not in vars(self):
+            return
+
+        type, exc = map(pickle.loads, self._saved)
+        six.reraise(type, exc, self._tb)
+
+
+@contextlib.contextmanager
+def save_modules():
+    """
+    Context in which imported modules are saved.
+
+    Translates exceptions internal to the context into the equivalent exception
+    outside the context.
+    """
+    saved = sys.modules.copy()
+    with ExceptionSaver() as saved_exc:
+        yield saved
+
+    sys.modules.update(saved)
+    # remove any modules imported since
+    del_modules = (
+        mod_name for mod_name in sys.modules
+        if mod_name not in saved
+        # exclude any encodings modules. See #285
+        and not mod_name.startswith('encodings.')
+    )
+    _clear_modules(del_modules)
+
+    saved_exc.resume()
+
+
+def _clear_modules(module_names):
+    for mod_name in list(module_names):
+        del sys.modules[mod_name]
+
+
+@contextlib.contextmanager
+def save_pkg_resources_state():
+    saved = pkg_resources.__getstate__()
+    try:
+        yield saved
+    finally:
+        pkg_resources.__setstate__(saved)
+
+
+@contextlib.contextmanager
+def setup_context(setup_dir):
+    temp_dir = os.path.join(setup_dir, 'temp')
+    with save_pkg_resources_state():
+        with save_modules():
+            hide_setuptools()
+            with save_path():
+                with save_argv():
+                    with override_temp(temp_dir):
+                        with pushd(setup_dir):
+                            # ensure setuptools commands are available
+                            __import__('setuptools')
+                            yield
+
+
+def _needs_hiding(mod_name):
+    """
+    >>> _needs_hiding('setuptools')
+    True
+    >>> _needs_hiding('pkg_resources')
+    True
+    >>> _needs_hiding('setuptools_plugin')
+    False
+    >>> _needs_hiding('setuptools.__init__')
+    True
+    >>> _needs_hiding('distutils')
+    True
+    >>> _needs_hiding('os')
+    False
+    >>> _needs_hiding('Cython')
+    True
+    """
+    pattern = re.compile(r'(setuptools|pkg_resources|distutils|Cython)(\.|$)')
+    return bool(pattern.match(mod_name))
+
+
+def hide_setuptools():
+    """
+    Remove references to setuptools' modules from sys.modules to allow the
+    invocation to import the most appropriate setuptools. This technique is
+    necessary to avoid issues such as #315 where setuptools upgrading itself
+    would fail to find a function declared in the metadata.
+    """
+    modules = filter(_needs_hiding, sys.modules)
+    _clear_modules(modules)
+
+
+def run_setup(setup_script, args):
+    """Run a distutils setup script, sandboxed in its directory"""
+    setup_dir = os.path.abspath(os.path.dirname(setup_script))
+    with setup_context(setup_dir):
+        try:
+            sys.argv[:] = [setup_script] + list(args)
+            sys.path.insert(0, setup_dir)
+            # reset to include setup dir, w/clean callback list
+            working_set.__init__()
+            working_set.callbacks.append(lambda dist: dist.activate())
+
+            # __file__ should be a byte string on Python 2 (#712)
+            dunder_file = (
+                setup_script
+                if isinstance(setup_script, str) else
+                setup_script.encode(sys.getfilesystemencoding())
+            )
+
+            with DirectorySandbox(setup_dir):
+                ns = dict(__file__=dunder_file, __name__='__main__')
+                _execfile(setup_script, ns)
+        except SystemExit as v:
+            if v.args and v.args[0]:
+                raise
+            # Normal exit, just return
+
+
+class AbstractSandbox:
+    """Wrap 'os' module and 'open()' builtin for virtualizing setup scripts"""
+
+    _active = False
+
+    def __init__(self):
+        self._attrs = [
+            name for name in dir(_os)
+            if not name.startswith('_') and hasattr(self, name)
+        ]
+
+    def _copy(self, source):
+        for name in self._attrs:
+            setattr(os, name, getattr(source, name))
+
+    def __enter__(self):
+        self._copy(self)
+        if _file:
+            builtins.file = self._file
+        builtins.open = self._open
+        self._active = True
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self._active = False
+        if _file:
+            builtins.file = _file
+        builtins.open = _open
+        self._copy(_os)
+
+    def run(self, func):
+        """Run 'func' under os sandboxing"""
+        with self:
+            return func()
+
+    def _mk_dual_path_wrapper(name):
+        original = getattr(_os, name)
+
+        def wrap(self, src, dst, *args, **kw):
+            if self._active:
+                src, dst = self._remap_pair(name, src, dst, *args, **kw)
+            return original(src, dst, *args, **kw)
+
+        return wrap
+
+    for name in ["rename", "link", "symlink"]:
+        if hasattr(_os, name):
+            locals()[name] = _mk_dual_path_wrapper(name)
+
+    def _mk_single_path_wrapper(name, original=None):
+        original = original or getattr(_os, name)
+
+        def wrap(self, path, *args, **kw):
+            if self._active:
+                path = self._remap_input(name, path, *args, **kw)
+            return original(path, *args, **kw)
+
+        return wrap
+
+    if _file:
+        _file = _mk_single_path_wrapper('file', _file)
+    _open = _mk_single_path_wrapper('open', _open)
+    for name in [
+        "stat", "listdir", "chdir", "open", "chmod", "chown", "mkdir",
+        "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "lstat",
+        "startfile", "mkfifo", "mknod", "pathconf", "access"
+    ]:
+        if hasattr(_os, name):
+            locals()[name] = _mk_single_path_wrapper(name)
+
+    def _mk_single_with_return(name):
+        original = getattr(_os, name)
+
+        def wrap(self, path, *args, **kw):
+            if self._active:
+                path = self._remap_input(name, path, *args, **kw)
+                return self._remap_output(name, original(path, *args, **kw))
+            return original(path, *args, **kw)
+
+        return wrap
+
+    for name in ['readlink', 'tempnam']:
+        if hasattr(_os, name):
+            locals()[name] = _mk_single_with_return(name)
+
+    def _mk_query(name):
+        original = getattr(_os, name)
+
+        def wrap(self, *args, **kw):
+            retval = original(*args, **kw)
+            if self._active:
+                return self._remap_output(name, retval)
+            return retval
+
+        return wrap
+
+    for name in ['getcwd', 'tmpnam']:
+        if hasattr(_os, name):
+            locals()[name] = _mk_query(name)
+
+    def _validate_path(self, path):
+        """Called to remap or validate any path, whether input or output"""
+        return path
+
+    def _remap_input(self, operation, path, *args, **kw):
+        """Called for path inputs"""
+        return self._validate_path(path)
+
+    def _remap_output(self, operation, path):
+        """Called for path outputs"""
+        return self._validate_path(path)
+
+    def _remap_pair(self, operation, src, dst, *args, **kw):
+        """Called for path pairs like rename, link, and symlink operations"""
+        return (
+            self._remap_input(operation + '-from', src, *args, **kw),
+            self._remap_input(operation + '-to', dst, *args, **kw)
+        )
+
+
+if hasattr(os, 'devnull'):
+    _EXCEPTIONS = [os.devnull,]
+else:
+    _EXCEPTIONS = []
+
+
+class DirectorySandbox(AbstractSandbox):
+    """Restrict operations to a single subdirectory - pseudo-chroot"""
+
+    write_ops = dict.fromkeys([
+        "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir",
+        "utime", "lchown", "chroot", "mkfifo", "mknod", "tempnam",
+    ])
+
+    _exception_patterns = [
+        # Allow lib2to3 to attempt to save a pickled grammar object (#121)
+        r'.*lib2to3.*\.pickle$',
+    ]
+    "exempt writing to paths that match the pattern"
+
+    def __init__(self, sandbox, exceptions=_EXCEPTIONS):
+        self._sandbox = os.path.normcase(os.path.realpath(sandbox))
+        self._prefix = os.path.join(self._sandbox, '')
+        self._exceptions = [
+            os.path.normcase(os.path.realpath(path))
+            for path in exceptions
+        ]
+        AbstractSandbox.__init__(self)
+
+    def _violation(self, operation, *args, **kw):
+        from setuptools.sandbox import SandboxViolation
+        raise SandboxViolation(operation, args, kw)
+
+    if _file:
+
+        def _file(self, path, mode='r', *args, **kw):
+            if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path):
+                self._violation("file", path, mode, *args, **kw)
+            return _file(path, mode, *args, **kw)
+
+    def _open(self, path, mode='r', *args, **kw):
+        if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path):
+            self._violation("open", path, mode, *args, **kw)
+        return _open(path, mode, *args, **kw)
+
+    def tmpnam(self):
+        self._violation("tmpnam")
+
+    def _ok(self, path):
+        active = self._active
+        try:
+            self._active = False
+            realpath = os.path.normcase(os.path.realpath(path))
+            return (
+                self._exempted(realpath)
+                or realpath == self._sandbox
+                or realpath.startswith(self._prefix)
+            )
+        finally:
+            self._active = active
+
+    def _exempted(self, filepath):
+        start_matches = (
+            filepath.startswith(exception)
+            for exception in self._exceptions
+        )
+        pattern_matches = (
+            re.match(pattern, filepath)
+            for pattern in self._exception_patterns
+        )
+        candidates = itertools.chain(start_matches, pattern_matches)
+        return any(candidates)
+
+    def _remap_input(self, operation, path, *args, **kw):
+        """Called for path inputs"""
+        if operation in self.write_ops and not self._ok(path):
+            self._violation(operation, os.path.realpath(path), *args, **kw)
+        return path
+
+    def _remap_pair(self, operation, src, dst, *args, **kw):
+        """Called for path pairs like rename, link, and symlink operations"""
+        if not self._ok(src) or not self._ok(dst):
+            self._violation(operation, src, dst, *args, **kw)
+        return (src, dst)
+
+    def open(self, file, flags, mode=0o777, *args, **kw):
+        """Called for low-level os.open()"""
+        if flags & WRITE_FLAGS and not self._ok(file):
+            self._violation("os.open", file, flags, mode, *args, **kw)
+        return _os.open(file, flags, mode, *args, **kw)
+
+
+WRITE_FLAGS = functools.reduce(
+    operator.or_, [getattr(_os, a, 0) for a in
+        "O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARY".split()]
+)
+
+
+class SandboxViolation(DistutilsError):
+    """A setup script attempted to modify the filesystem outside the sandbox"""
+
+    tmpl = textwrap.dedent("""
+        SandboxViolation: {cmd}{args!r} {kwargs}
+
+        The package setup script has attempted to modify files on your system
+        that are not within the EasyInstall build area, and has been aborted.
+
+        This package cannot be safely installed by EasyInstall, and may not
+        support alternate installation locations even if you run its setup
+        script by hand.  Please inform the package's author and the EasyInstall
+        maintainers to find out if a fix or workaround is available.
+        """).lstrip()
+
+    def __str__(self):
+        cmd, args, kwargs = self.args
+        return self.tmpl.format(**locals())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl
new file mode 100644
index 0000000000000000000000000000000000000000..39a24b04888e79df51e2237577b303a2f901be63
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script (dev).tmpl	
@@ -0,0 +1,6 @@
+# EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r
+__requires__ = %(spec)r
+__import__('pkg_resources').require(%(spec)r)
+__file__ = %(dev_path)r
+with open(__file__) as f:
+    exec(compile(f.read(), __file__, 'exec'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script.tmpl b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script.tmpl
new file mode 100644
index 0000000000000000000000000000000000000000..ff5efbcab3b58063dd84787181c26a95fb663d94
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/script.tmpl
@@ -0,0 +1,3 @@
+# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r
+__requires__ = %(spec)r
+__import__('pkg_resources').run_script(%(spec)r, %(script_name)r)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/site-patch.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/site-patch.py
new file mode 100644
index 0000000000000000000000000000000000000000..40b00de0a799686485b266fd92abb9fb100ed718
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/site-patch.py
@@ -0,0 +1,74 @@
+def __boot():
+    import sys
+    import os
+    PYTHONPATH = os.environ.get('PYTHONPATH')
+    if PYTHONPATH is None or (sys.platform == 'win32' and not PYTHONPATH):
+        PYTHONPATH = []
+    else:
+        PYTHONPATH = PYTHONPATH.split(os.pathsep)
+
+    pic = getattr(sys, 'path_importer_cache', {})
+    stdpath = sys.path[len(PYTHONPATH):]
+    mydir = os.path.dirname(__file__)
+
+    for item in stdpath:
+        if item == mydir or not item:
+            continue  # skip if current dir. on Windows, or my own directory
+        importer = pic.get(item)
+        if importer is not None:
+            loader = importer.find_module('site')
+            if loader is not None:
+                # This should actually reload the current module
+                loader.load_module('site')
+                break
+        else:
+            try:
+                import imp  # Avoid import loop in Python 3
+                stream, path, descr = imp.find_module('site', [item])
+            except ImportError:
+                continue
+            if stream is None:
+                continue
+            try:
+                # This should actually reload the current module
+                imp.load_module('site', stream, path, descr)
+            finally:
+                stream.close()
+            break
+    else:
+        raise ImportError("Couldn't find the real 'site' module")
+
+    known_paths = dict([(makepath(item)[1], 1) for item in sys.path])  # 2.2 comp
+
+    oldpos = getattr(sys, '__egginsert', 0)  # save old insertion position
+    sys.__egginsert = 0  # and reset the current one
+
+    for item in PYTHONPATH:
+        addsitedir(item)
+
+    sys.__egginsert += oldpos  # restore effective old position
+
+    d, nd = makepath(stdpath[0])
+    insert_at = None
+    new_path = []
+
+    for item in sys.path:
+        p, np = makepath(item)
+
+        if np == nd and insert_at is None:
+            # We've hit the first 'system' path entry, so added entries go here
+            insert_at = len(new_path)
+
+        if np in known_paths or insert_at is None:
+            new_path.append(item)
+        else:
+            # new path after the insert point, back-insert it
+            new_path.insert(insert_at, item)
+            insert_at += 1
+
+    sys.path[:] = new_path
+
+
+if __name__ == 'site':
+    __boot()
+    del __boot
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/ssl_support.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/ssl_support.py
new file mode 100644
index 0000000000000000000000000000000000000000..226db694bb38791147c6bf2881c4b86025dd2f8f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/ssl_support.py
@@ -0,0 +1,260 @@
+import os
+import socket
+import atexit
+import re
+import functools
+
+from setuptools.extern.six.moves import urllib, http_client, map, filter
+
+from pkg_resources import ResolutionError, ExtractionError
+
+try:
+    import ssl
+except ImportError:
+    ssl = None
+
+__all__ = [
+    'VerifyingHTTPSHandler', 'find_ca_bundle', 'is_available', 'cert_paths',
+    'opener_for'
+]
+
+cert_paths = """
+/etc/pki/tls/certs/ca-bundle.crt
+/etc/ssl/certs/ca-certificates.crt
+/usr/share/ssl/certs/ca-bundle.crt
+/usr/local/share/certs/ca-root.crt
+/etc/ssl/cert.pem
+/System/Library/OpenSSL/certs/cert.pem
+/usr/local/share/certs/ca-root-nss.crt
+/etc/ssl/ca-bundle.pem
+""".strip().split()
+
+try:
+    HTTPSHandler = urllib.request.HTTPSHandler
+    HTTPSConnection = http_client.HTTPSConnection
+except AttributeError:
+    HTTPSHandler = HTTPSConnection = object
+
+is_available = ssl is not None and object not in (HTTPSHandler, HTTPSConnection)
+
+
+try:
+    from ssl import CertificateError, match_hostname
+except ImportError:
+    try:
+        from backports.ssl_match_hostname import CertificateError
+        from backports.ssl_match_hostname import match_hostname
+    except ImportError:
+        CertificateError = None
+        match_hostname = None
+
+if not CertificateError:
+
+    class CertificateError(ValueError):
+        pass
+
+
+if not match_hostname:
+
+    def _dnsname_match(dn, hostname, max_wildcards=1):
+        """Matching according to RFC 6125, section 6.4.3
+
+        https://tools.ietf.org/html/rfc6125#section-6.4.3
+        """
+        pats = []
+        if not dn:
+            return False
+
+        # Ported from python3-syntax:
+        # leftmost, *remainder = dn.split(r'.')
+        parts = dn.split(r'.')
+        leftmost = parts[0]
+        remainder = parts[1:]
+
+        wildcards = leftmost.count('*')
+        if wildcards > max_wildcards:
+            # Issue #17980: avoid denials of service by refusing more
+            # than one wildcard per fragment.  A survey of established
+            # policy among SSL implementations showed it to be a
+            # reasonable choice.
+            raise CertificateError(
+                "too many wildcards in certificate DNS name: " + repr(dn))
+
+        # speed up common case w/o wildcards
+        if not wildcards:
+            return dn.lower() == hostname.lower()
+
+        # RFC 6125, section 6.4.3, subitem 1.
+        # The client SHOULD NOT attempt to match a presented identifier in which
+        # the wildcard character comprises a label other than the left-most label.
+        if leftmost == '*':
+            # When '*' is a fragment by itself, it matches a non-empty dotless
+            # fragment.
+            pats.append('[^.]+')
+        elif leftmost.startswith('xn--') or hostname.startswith('xn--'):
+            # RFC 6125, section 6.4.3, subitem 3.
+            # The client SHOULD NOT attempt to match a presented identifier
+            # where the wildcard character is embedded within an A-label or
+            # U-label of an internationalized domain name.
+            pats.append(re.escape(leftmost))
+        else:
+            # Otherwise, '*' matches any dotless string, e.g. www*
+            pats.append(re.escape(leftmost).replace(r'\*', '[^.]*'))
+
+        # add the remaining fragments, ignore any wildcards
+        for frag in remainder:
+            pats.append(re.escape(frag))
+
+        pat = re.compile(r'\A' + r'\.'.join(pats) + r'\Z', re.IGNORECASE)
+        return pat.match(hostname)
+
+    def match_hostname(cert, hostname):
+        """Verify that *cert* (in decoded format as returned by
+        SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
+        rules are followed, but IP addresses are not accepted for *hostname*.
+
+        CertificateError is raised on failure. On success, the function
+        returns nothing.
+        """
+        if not cert:
+            raise ValueError("empty or no certificate")
+        dnsnames = []
+        san = cert.get('subjectAltName', ())
+        for key, value in san:
+            if key == 'DNS':
+                if _dnsname_match(value, hostname):
+                    return
+                dnsnames.append(value)
+        if not dnsnames:
+            # The subject is only checked when there is no dNSName entry
+            # in subjectAltName
+            for sub in cert.get('subject', ()):
+                for key, value in sub:
+                    # XXX according to RFC 2818, the most specific Common Name
+                    # must be used.
+                    if key == 'commonName':
+                        if _dnsname_match(value, hostname):
+                            return
+                        dnsnames.append(value)
+        if len(dnsnames) > 1:
+            raise CertificateError("hostname %r "
+                "doesn't match either of %s"
+                % (hostname, ', '.join(map(repr, dnsnames))))
+        elif len(dnsnames) == 1:
+            raise CertificateError("hostname %r "
+                "doesn't match %r"
+                % (hostname, dnsnames[0]))
+        else:
+            raise CertificateError("no appropriate commonName or "
+                "subjectAltName fields were found")
+
+
+class VerifyingHTTPSHandler(HTTPSHandler):
+    """Simple verifying handler: no auth, subclasses, timeouts, etc."""
+
+    def __init__(self, ca_bundle):
+        self.ca_bundle = ca_bundle
+        HTTPSHandler.__init__(self)
+
+    def https_open(self, req):
+        return self.do_open(
+            lambda host, **kw: VerifyingHTTPSConn(host, self.ca_bundle, **kw), req
+        )
+
+
+class VerifyingHTTPSConn(HTTPSConnection):
+    """Simple verifying connection: no auth, subclasses, timeouts, etc."""
+
+    def __init__(self, host, ca_bundle, **kw):
+        HTTPSConnection.__init__(self, host, **kw)
+        self.ca_bundle = ca_bundle
+
+    def connect(self):
+        sock = socket.create_connection(
+            (self.host, self.port), getattr(self, 'source_address', None)
+        )
+
+        # Handle the socket if a (proxy) tunnel is present
+        if hasattr(self, '_tunnel') and getattr(self, '_tunnel_host', None):
+            self.sock = sock
+            self._tunnel()
+            # http://bugs.python.org/issue7776: Python>=3.4.1 and >=2.7.7
+            # change self.host to mean the proxy server host when tunneling is
+            # being used. Adapt, since we are interested in the destination
+            # host for the match_hostname() comparison.
+            actual_host = self._tunnel_host
+        else:
+            actual_host = self.host
+
+        if hasattr(ssl, 'create_default_context'):
+            ctx = ssl.create_default_context(cafile=self.ca_bundle)
+            self.sock = ctx.wrap_socket(sock, server_hostname=actual_host)
+        else:
+            # This is for python < 2.7.9 and < 3.4?
+            self.sock = ssl.wrap_socket(
+                sock, cert_reqs=ssl.CERT_REQUIRED, ca_certs=self.ca_bundle
+            )
+        try:
+            match_hostname(self.sock.getpeercert(), actual_host)
+        except CertificateError:
+            self.sock.shutdown(socket.SHUT_RDWR)
+            self.sock.close()
+            raise
+
+
+def opener_for(ca_bundle=None):
+    """Get a urlopen() replacement that uses ca_bundle for verification"""
+    return urllib.request.build_opener(
+        VerifyingHTTPSHandler(ca_bundle or find_ca_bundle())
+    ).open
+
+
+# from jaraco.functools
+def once(func):
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        if not hasattr(func, 'always_returns'):
+            func.always_returns = func(*args, **kwargs)
+        return func.always_returns
+    return wrapper
+
+
+@once
+def get_win_certfile():
+    try:
+        import wincertstore
+    except ImportError:
+        return None
+
+    class CertFile(wincertstore.CertFile):
+        def __init__(self):
+            super(CertFile, self).__init__()
+            atexit.register(self.close)
+
+        def close(self):
+            try:
+                super(CertFile, self).close()
+            except OSError:
+                pass
+
+    _wincerts = CertFile()
+    _wincerts.addstore('CA')
+    _wincerts.addstore('ROOT')
+    return _wincerts.name
+
+
+def find_ca_bundle():
+    """Return an existing CA bundle path, or None"""
+    extant_cert_paths = filter(os.path.isfile, cert_paths)
+    return (
+        get_win_certfile()
+        or next(extant_cert_paths, None)
+        or _certifi_where()
+    )
+
+
+def _certifi_where():
+    try:
+        return __import__('certifi').where()
+    except (ImportError, ResolutionError, ExtractionError):
+        pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c63efd20b350358ab25c079166dbb00ef49f8d2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/unicode_utils.py
@@ -0,0 +1,44 @@
+import unicodedata
+import sys
+
+from setuptools.extern import six
+
+
+# HFS Plus uses decomposed UTF-8
+def decompose(path):
+    if isinstance(path, six.text_type):
+        return unicodedata.normalize('NFD', path)
+    try:
+        path = path.decode('utf-8')
+        path = unicodedata.normalize('NFD', path)
+        path = path.encode('utf-8')
+    except UnicodeError:
+        pass  # Not UTF-8
+    return path
+
+
+def filesys_decode(path):
+    """
+    Ensure that the given path is decoded,
+    NONE when no expected encoding works
+    """
+
+    if isinstance(path, six.text_type):
+        return path
+
+    fs_enc = sys.getfilesystemencoding() or 'utf-8'
+    candidates = fs_enc, 'utf-8'
+
+    for enc in candidates:
+        try:
+            return path.decode(enc)
+        except UnicodeDecodeError:
+            continue
+
+
+def try_encode(string, enc):
+    "turn unicode encoding into a functional routine"
+    try:
+        return string.encode(enc)
+    except UnicodeEncodeError:
+        return None
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..95e1869658566aac3060562d8cd5a6b647887d1e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/version.py
@@ -0,0 +1,6 @@
+import pkg_resources
+
+try:
+    __version__ = pkg_resources.get_distribution('setuptools').version
+except Exception:
+    __version__ = 'unknown'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..025aaa828a24cb7746e5fac9b66984d5b9794bc3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/wheel.py
@@ -0,0 +1,220 @@
+"""Wheels support."""
+
+from distutils.util import get_platform
+from distutils import log
+import email
+import itertools
+import os
+import posixpath
+import re
+import zipfile
+
+import pkg_resources
+import setuptools
+from pkg_resources import parse_version
+from setuptools.extern.packaging.tags import sys_tags
+from setuptools.extern.packaging.utils import canonicalize_name
+from setuptools.extern.six import PY3
+from setuptools.command.egg_info import write_requirements
+
+
+__metaclass__ = type
+
+
+WHEEL_NAME = re.compile(
+    r"""^(?P<project_name>.+?)-(?P<version>\d.*?)
+    ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?)
+    )\.whl$""",
+    re.VERBOSE).match
+
+NAMESPACE_PACKAGE_INIT = '''\
+try:
+    __import__('pkg_resources').declare_namespace(__name__)
+except ImportError:
+    __path__ = __import__('pkgutil').extend_path(__path__, __name__)
+'''
+
+
+def unpack(src_dir, dst_dir):
+    '''Move everything under `src_dir` to `dst_dir`, and delete the former.'''
+    for dirpath, dirnames, filenames in os.walk(src_dir):
+        subdir = os.path.relpath(dirpath, src_dir)
+        for f in filenames:
+            src = os.path.join(dirpath, f)
+            dst = os.path.join(dst_dir, subdir, f)
+            os.renames(src, dst)
+        for n, d in reversed(list(enumerate(dirnames))):
+            src = os.path.join(dirpath, d)
+            dst = os.path.join(dst_dir, subdir, d)
+            if not os.path.exists(dst):
+                # Directory does not exist in destination,
+                # rename it and prune it from os.walk list.
+                os.renames(src, dst)
+                del dirnames[n]
+    # Cleanup.
+    for dirpath, dirnames, filenames in os.walk(src_dir, topdown=True):
+        assert not filenames
+        os.rmdir(dirpath)
+
+
+class Wheel:
+
+    def __init__(self, filename):
+        match = WHEEL_NAME(os.path.basename(filename))
+        if match is None:
+            raise ValueError('invalid wheel name: %r' % filename)
+        self.filename = filename
+        for k, v in match.groupdict().items():
+            setattr(self, k, v)
+
+    def tags(self):
+        '''List tags (py_version, abi, platform) supported by this wheel.'''
+        return itertools.product(
+            self.py_version.split('.'),
+            self.abi.split('.'),
+            self.platform.split('.'),
+        )
+
+    def is_compatible(self):
+        '''Is the wheel is compatible with the current platform?'''
+        supported_tags = set((t.interpreter, t.abi, t.platform) for t in sys_tags())
+        return next((True for t in self.tags() if t in supported_tags), False)
+
+    def egg_name(self):
+        return pkg_resources.Distribution(
+            project_name=self.project_name, version=self.version,
+            platform=(None if self.platform == 'any' else get_platform()),
+        ).egg_name() + '.egg'
+
+    def get_dist_info(self, zf):
+        # find the correct name of the .dist-info dir in the wheel file
+        for member in zf.namelist():
+            dirname = posixpath.dirname(member)
+            if (dirname.endswith('.dist-info') and
+                    canonicalize_name(dirname).startswith(
+                        canonicalize_name(self.project_name))):
+                return dirname
+        raise ValueError("unsupported wheel format. .dist-info not found")
+
+    def install_as_egg(self, destination_eggdir):
+        '''Install wheel as an egg directory.'''
+        with zipfile.ZipFile(self.filename) as zf:
+            self._install_as_egg(destination_eggdir, zf)
+
+    def _install_as_egg(self, destination_eggdir, zf):
+        dist_basename = '%s-%s' % (self.project_name, self.version)
+        dist_info = self.get_dist_info(zf)
+        dist_data = '%s.data' % dist_basename
+        egg_info = os.path.join(destination_eggdir, 'EGG-INFO')
+
+        self._convert_metadata(zf, destination_eggdir, dist_info, egg_info)
+        self._move_data_entries(destination_eggdir, dist_data)
+        self._fix_namespace_packages(egg_info, destination_eggdir)
+
+    @staticmethod
+    def _convert_metadata(zf, destination_eggdir, dist_info, egg_info):
+        def get_metadata(name):
+            with zf.open(posixpath.join(dist_info, name)) as fp:
+                value = fp.read().decode('utf-8') if PY3 else fp.read()
+                return email.parser.Parser().parsestr(value)
+
+        wheel_metadata = get_metadata('WHEEL')
+        # Check wheel format version is supported.
+        wheel_version = parse_version(wheel_metadata.get('Wheel-Version'))
+        wheel_v1 = (
+            parse_version('1.0') <= wheel_version < parse_version('2.0dev0')
+        )
+        if not wheel_v1:
+            raise ValueError(
+                'unsupported wheel format version: %s' % wheel_version)
+        # Extract to target directory.
+        os.mkdir(destination_eggdir)
+        zf.extractall(destination_eggdir)
+        # Convert metadata.
+        dist_info = os.path.join(destination_eggdir, dist_info)
+        dist = pkg_resources.Distribution.from_location(
+            destination_eggdir, dist_info,
+            metadata=pkg_resources.PathMetadata(destination_eggdir, dist_info),
+        )
+
+        # Note: Evaluate and strip markers now,
+        # as it's difficult to convert back from the syntax:
+        # foobar; "linux" in sys_platform and extra == 'test'
+        def raw_req(req):
+            req.marker = None
+            return str(req)
+        install_requires = list(sorted(map(raw_req, dist.requires())))
+        extras_require = {
+            extra: sorted(
+                req
+                for req in map(raw_req, dist.requires((extra,)))
+                if req not in install_requires
+            )
+            for extra in dist.extras
+        }
+        os.rename(dist_info, egg_info)
+        os.rename(
+            os.path.join(egg_info, 'METADATA'),
+            os.path.join(egg_info, 'PKG-INFO'),
+        )
+        setup_dist = setuptools.Distribution(
+            attrs=dict(
+                install_requires=install_requires,
+                extras_require=extras_require,
+            ),
+        )
+        # Temporarily disable info traces.
+        log_threshold = log._global_log.threshold
+        log.set_threshold(log.WARN)
+        try:
+            write_requirements(
+                setup_dist.get_command_obj('egg_info'),
+                None,
+                os.path.join(egg_info, 'requires.txt'),
+            )
+        finally:
+            log.set_threshold(log_threshold)
+
+    @staticmethod
+    def _move_data_entries(destination_eggdir, dist_data):
+        """Move data entries to their correct location."""
+        dist_data = os.path.join(destination_eggdir, dist_data)
+        dist_data_scripts = os.path.join(dist_data, 'scripts')
+        if os.path.exists(dist_data_scripts):
+            egg_info_scripts = os.path.join(
+                destination_eggdir, 'EGG-INFO', 'scripts')
+            os.mkdir(egg_info_scripts)
+            for entry in os.listdir(dist_data_scripts):
+                # Remove bytecode, as it's not properly handled
+                # during easy_install scripts install phase.
+                if entry.endswith('.pyc'):
+                    os.unlink(os.path.join(dist_data_scripts, entry))
+                else:
+                    os.rename(
+                        os.path.join(dist_data_scripts, entry),
+                        os.path.join(egg_info_scripts, entry),
+                    )
+            os.rmdir(dist_data_scripts)
+        for subdir in filter(os.path.exists, (
+            os.path.join(dist_data, d)
+            for d in ('data', 'headers', 'purelib', 'platlib')
+        )):
+            unpack(subdir, destination_eggdir)
+        if os.path.exists(dist_data):
+            os.rmdir(dist_data)
+
+    @staticmethod
+    def _fix_namespace_packages(egg_info, destination_eggdir):
+        namespace_packages = os.path.join(
+            egg_info, 'namespace_packages.txt')
+        if os.path.exists(namespace_packages):
+            with open(namespace_packages) as fp:
+                namespace_packages = fp.read().split()
+            for mod in namespace_packages:
+                mod_dir = os.path.join(destination_eggdir, *mod.split('.'))
+                mod_init = os.path.join(mod_dir, '__init__.py')
+                if not os.path.exists(mod_dir):
+                    os.mkdir(mod_dir)
+                if not os.path.exists(mod_init):
+                    with open(mod_init, 'w') as fp:
+                        fp.write(NAMESPACE_PACKAGE_INIT)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/windows_support.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/windows_support.py
new file mode 100644
index 0000000000000000000000000000000000000000..cb977cff9545ef5d48ad7cf13f2cbe1ebc3e7cd0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/setuptools/windows_support.py
@@ -0,0 +1,29 @@
+import platform
+import ctypes
+
+
+def windows_only(func):
+    if platform.system() != 'Windows':
+        return lambda *args, **kwargs: None
+    return func
+
+
+@windows_only
+def hide_file(path):
+    """
+    Set the hidden attribute on a file or directory.
+
+    From http://stackoverflow.com/questions/19622133/
+
+    `path` must be text.
+    """
+    __import__('ctypes.wintypes')
+    SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW
+    SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD
+    SetFileAttributes.restype = ctypes.wintypes.BOOL
+
+    FILE_ATTRIBUTE_HIDDEN = 0x02
+
+    ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN)
+    if not ret:
+        raise ctypes.WinError()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b9c24c7317332c74c806f2a8d8b16eab73b2e3d3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/METADATA
@@ -0,0 +1,49 @@
+Metadata-Version: 2.1
+Name: six
+Version: 1.14.0
+Summary: Python 2 and 3 compatibility utilities
+Home-page: https://github.com/benjaminp/six
+Author: Benjamin Peterson
+Author-email: benjamin@python.org
+License: MIT
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*
+
+.. image:: https://img.shields.io/pypi/v/six.svg
+   :target: https://pypi.org/project/six/
+   :alt: six on PyPI
+
+.. image:: https://travis-ci.org/benjaminp/six.svg?branch=master
+   :target: https://travis-ci.org/benjaminp/six
+   :alt: six on TravisCI
+
+.. image:: https://readthedocs.org/projects/six/badge/?version=latest
+   :target: https://six.readthedocs.io/
+   :alt: six's documentation on Read the Docs
+
+.. image:: https://img.shields.io/badge/license-MIT-green.svg
+   :target: https://github.com/benjaminp/six/blob/master/LICENSE
+   :alt: MIT License badge
+
+Six is a Python 2 and 3 compatibility library.  It provides utility functions
+for smoothing over the differences between the Python versions with the goal of
+writing Python code that is compatible on both Python versions.  See the
+documentation for more information on what is provided.
+
+Six supports Python 2.7 and 3.3+.  It is contained in only one Python
+file, so it can be easily copied into your project. (The copyright and license
+notice must be retained.)
+
+Online documentation is at https://six.readthedocs.io/.
+
+Bugs can be reported to https://github.com/benjaminp/six.  The code can also
+be found there.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..57e76022c88c7e621bd5012b990470887d0f4f77
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/RECORD
@@ -0,0 +1,11 @@
+six.py,sha256=Q6WvEXZ1DGEASAo3CGNCJkKv2tPy8xkSmK-VHE9PYIA,34074
+six-1.14.0.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+six-1.14.0.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+six-1.14.0.dist-info/METADATA,sha256=nEAc9huAtn13Bna3MQ1ZSswoyaV7GMJdKfGluHFX4DU,1795
+six-1.14.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+six-1.14.0.dist-info/top_level.txt,sha256=_iVH_iYEtEXnD8nYGQYpYFUvkUW9sEO1GYbkeKSAais,4
+six-1.14.0.dist-info/RECORD,,
+six-1.14.0.dist-info/__pycache__,,
+six-1.14.0.virtualenv,,
+six.cpython-38.pyc,,
+six-1.14.0.dist-info/INSTALLER,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ffe2fce498955b628014618b28c6bcf152466a4a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+six
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six-1.14.0.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six.py
new file mode 100644
index 0000000000000000000000000000000000000000..5fe9f8e141ee13756fec536415adc446bfc109d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/six.py
@@ -0,0 +1,980 @@
+# Copyright (c) 2010-2020 Benjamin Peterson
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+"""Utilities for writing code that runs on Python 2 and 3"""
+
+from __future__ import absolute_import
+
+import functools
+import itertools
+import operator
+import sys
+import types
+
+__author__ = "Benjamin Peterson <benjamin@python.org>"
+__version__ = "1.14.0"
+
+
+# Useful for very coarse version differentiation.
+PY2 = sys.version_info[0] == 2
+PY3 = sys.version_info[0] == 3
+PY34 = sys.version_info[0:2] >= (3, 4)
+
+if PY3:
+    string_types = str,
+    integer_types = int,
+    class_types = type,
+    text_type = str
+    binary_type = bytes
+
+    MAXSIZE = sys.maxsize
+else:
+    string_types = basestring,
+    integer_types = (int, long)
+    class_types = (type, types.ClassType)
+    text_type = unicode
+    binary_type = str
+
+    if sys.platform.startswith("java"):
+        # Jython always uses 32 bits.
+        MAXSIZE = int((1 << 31) - 1)
+    else:
+        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
+        class X(object):
+
+            def __len__(self):
+                return 1 << 31
+        try:
+            len(X())
+        except OverflowError:
+            # 32-bit
+            MAXSIZE = int((1 << 31) - 1)
+        else:
+            # 64-bit
+            MAXSIZE = int((1 << 63) - 1)
+        del X
+
+
+def _add_doc(func, doc):
+    """Add documentation to a function."""
+    func.__doc__ = doc
+
+
+def _import_module(name):
+    """Import module, returning the module after the last dot."""
+    __import__(name)
+    return sys.modules[name]
+
+
+class _LazyDescr(object):
+
+    def __init__(self, name):
+        self.name = name
+
+    def __get__(self, obj, tp):
+        result = self._resolve()
+        setattr(obj, self.name, result)  # Invokes __set__.
+        try:
+            # This is a bit ugly, but it avoids running this again by
+            # removing this descriptor.
+            delattr(obj.__class__, self.name)
+        except AttributeError:
+            pass
+        return result
+
+
+class MovedModule(_LazyDescr):
+
+    def __init__(self, name, old, new=None):
+        super(MovedModule, self).__init__(name)
+        if PY3:
+            if new is None:
+                new = name
+            self.mod = new
+        else:
+            self.mod = old
+
+    def _resolve(self):
+        return _import_module(self.mod)
+
+    def __getattr__(self, attr):
+        _module = self._resolve()
+        value = getattr(_module, attr)
+        setattr(self, attr, value)
+        return value
+
+
+class _LazyModule(types.ModuleType):
+
+    def __init__(self, name):
+        super(_LazyModule, self).__init__(name)
+        self.__doc__ = self.__class__.__doc__
+
+    def __dir__(self):
+        attrs = ["__doc__", "__name__"]
+        attrs += [attr.name for attr in self._moved_attributes]
+        return attrs
+
+    # Subclasses should override this
+    _moved_attributes = []
+
+
+class MovedAttribute(_LazyDescr):
+
+    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
+        super(MovedAttribute, self).__init__(name)
+        if PY3:
+            if new_mod is None:
+                new_mod = name
+            self.mod = new_mod
+            if new_attr is None:
+                if old_attr is None:
+                    new_attr = name
+                else:
+                    new_attr = old_attr
+            self.attr = new_attr
+        else:
+            self.mod = old_mod
+            if old_attr is None:
+                old_attr = name
+            self.attr = old_attr
+
+    def _resolve(self):
+        module = _import_module(self.mod)
+        return getattr(module, self.attr)
+
+
+class _SixMetaPathImporter(object):
+
+    """
+    A meta path importer to import six.moves and its submodules.
+
+    This class implements a PEP302 finder and loader. It should be compatible
+    with Python 2.5 and all existing versions of Python3
+    """
+
+    def __init__(self, six_module_name):
+        self.name = six_module_name
+        self.known_modules = {}
+
+    def _add_module(self, mod, *fullnames):
+        for fullname in fullnames:
+            self.known_modules[self.name + "." + fullname] = mod
+
+    def _get_module(self, fullname):
+        return self.known_modules[self.name + "." + fullname]
+
+    def find_module(self, fullname, path=None):
+        if fullname in self.known_modules:
+            return self
+        return None
+
+    def __get_module(self, fullname):
+        try:
+            return self.known_modules[fullname]
+        except KeyError:
+            raise ImportError("This loader does not know module " + fullname)
+
+    def load_module(self, fullname):
+        try:
+            # in case of a reload
+            return sys.modules[fullname]
+        except KeyError:
+            pass
+        mod = self.__get_module(fullname)
+        if isinstance(mod, MovedModule):
+            mod = mod._resolve()
+        else:
+            mod.__loader__ = self
+        sys.modules[fullname] = mod
+        return mod
+
+    def is_package(self, fullname):
+        """
+        Return true, if the named module is a package.
+
+        We need this method to get correct spec objects with
+        Python 3.4 (see PEP451)
+        """
+        return hasattr(self.__get_module(fullname), "__path__")
+
+    def get_code(self, fullname):
+        """Return None
+
+        Required, if is_package is implemented"""
+        self.__get_module(fullname)  # eventually raises ImportError
+        return None
+    get_source = get_code  # same as get_code
+
+_importer = _SixMetaPathImporter(__name__)
+
+
+class _MovedItems(_LazyModule):
+
+    """Lazy loading of moved objects"""
+    __path__ = []  # mark as package
+
+
+_moved_attributes = [
+    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
+    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
+    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
+    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
+    MovedAttribute("intern", "__builtin__", "sys"),
+    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
+    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
+    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
+    MovedAttribute("getoutput", "commands", "subprocess"),
+    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
+    MovedAttribute("reduce", "__builtin__", "functools"),
+    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
+    MovedAttribute("StringIO", "StringIO", "io"),
+    MovedAttribute("UserDict", "UserDict", "collections"),
+    MovedAttribute("UserList", "UserList", "collections"),
+    MovedAttribute("UserString", "UserString", "collections"),
+    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
+    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
+    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
+    MovedModule("builtins", "__builtin__"),
+    MovedModule("configparser", "ConfigParser"),
+    MovedModule("collections_abc", "collections", "collections.abc" if sys.version_info >= (3, 3) else "collections"),
+    MovedModule("copyreg", "copy_reg"),
+    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
+    MovedModule("dbm_ndbm", "dbm", "dbm.ndbm"),
+    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread" if sys.version_info < (3, 9) else "_thread"),
+    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
+    MovedModule("http_cookies", "Cookie", "http.cookies"),
+    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
+    MovedModule("html_parser", "HTMLParser", "html.parser"),
+    MovedModule("http_client", "httplib", "http.client"),
+    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
+    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
+    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
+    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
+    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
+    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
+    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
+    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
+    MovedModule("cPickle", "cPickle", "pickle"),
+    MovedModule("queue", "Queue"),
+    MovedModule("reprlib", "repr"),
+    MovedModule("socketserver", "SocketServer"),
+    MovedModule("_thread", "thread", "_thread"),
+    MovedModule("tkinter", "Tkinter"),
+    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
+    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
+    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
+    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
+    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
+    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
+    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
+    MovedModule("tkinter_colorchooser", "tkColorChooser",
+                "tkinter.colorchooser"),
+    MovedModule("tkinter_commondialog", "tkCommonDialog",
+                "tkinter.commondialog"),
+    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
+    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
+    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
+    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
+                "tkinter.simpledialog"),
+    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
+    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
+    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
+    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
+    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
+    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
+]
+# Add windows specific modules.
+if sys.platform == "win32":
+    _moved_attributes += [
+        MovedModule("winreg", "_winreg"),
+    ]
+
+for attr in _moved_attributes:
+    setattr(_MovedItems, attr.name, attr)
+    if isinstance(attr, MovedModule):
+        _importer._add_module(attr, "moves." + attr.name)
+del attr
+
+_MovedItems._moved_attributes = _moved_attributes
+
+moves = _MovedItems(__name__ + ".moves")
+_importer._add_module(moves, "moves")
+
+
+class Module_six_moves_urllib_parse(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_parse"""
+
+
+_urllib_parse_moved_attributes = [
+    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
+    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
+    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
+    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
+    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
+    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
+    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
+    MovedAttribute("quote", "urllib", "urllib.parse"),
+    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
+    MovedAttribute("unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"),
+    MovedAttribute("urlencode", "urllib", "urllib.parse"),
+    MovedAttribute("splitquery", "urllib", "urllib.parse"),
+    MovedAttribute("splittag", "urllib", "urllib.parse"),
+    MovedAttribute("splituser", "urllib", "urllib.parse"),
+    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
+    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
+    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
+]
+for attr in _urllib_parse_moved_attributes:
+    setattr(Module_six_moves_urllib_parse, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
+                      "moves.urllib_parse", "moves.urllib.parse")
+
+
+class Module_six_moves_urllib_error(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_error"""
+
+
+_urllib_error_moved_attributes = [
+    MovedAttribute("URLError", "urllib2", "urllib.error"),
+    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
+    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
+]
+for attr in _urllib_error_moved_attributes:
+    setattr(Module_six_moves_urllib_error, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
+                      "moves.urllib_error", "moves.urllib.error")
+
+
+class Module_six_moves_urllib_request(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_request"""
+
+
+_urllib_request_moved_attributes = [
+    MovedAttribute("urlopen", "urllib2", "urllib.request"),
+    MovedAttribute("install_opener", "urllib2", "urllib.request"),
+    MovedAttribute("build_opener", "urllib2", "urllib.request"),
+    MovedAttribute("pathname2url", "urllib", "urllib.request"),
+    MovedAttribute("url2pathname", "urllib", "urllib.request"),
+    MovedAttribute("getproxies", "urllib", "urllib.request"),
+    MovedAttribute("Request", "urllib2", "urllib.request"),
+    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
+    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
+    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
+    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
+    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
+    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
+    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
+    MovedAttribute("URLopener", "urllib", "urllib.request"),
+    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
+    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
+    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
+    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
+]
+for attr in _urllib_request_moved_attributes:
+    setattr(Module_six_moves_urllib_request, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
+                      "moves.urllib_request", "moves.urllib.request")
+
+
+class Module_six_moves_urllib_response(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_response"""
+
+
+_urllib_response_moved_attributes = [
+    MovedAttribute("addbase", "urllib", "urllib.response"),
+    MovedAttribute("addclosehook", "urllib", "urllib.response"),
+    MovedAttribute("addinfo", "urllib", "urllib.response"),
+    MovedAttribute("addinfourl", "urllib", "urllib.response"),
+]
+for attr in _urllib_response_moved_attributes:
+    setattr(Module_six_moves_urllib_response, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
+                      "moves.urllib_response", "moves.urllib.response")
+
+
+class Module_six_moves_urllib_robotparser(_LazyModule):
+
+    """Lazy loading of moved objects in six.moves.urllib_robotparser"""
+
+
+_urllib_robotparser_moved_attributes = [
+    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
+]
+for attr in _urllib_robotparser_moved_attributes:
+    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
+del attr
+
+Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes
+
+_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
+                      "moves.urllib_robotparser", "moves.urllib.robotparser")
+
+
+class Module_six_moves_urllib(types.ModuleType):
+
+    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
+    __path__ = []  # mark as package
+    parse = _importer._get_module("moves.urllib_parse")
+    error = _importer._get_module("moves.urllib_error")
+    request = _importer._get_module("moves.urllib_request")
+    response = _importer._get_module("moves.urllib_response")
+    robotparser = _importer._get_module("moves.urllib_robotparser")
+
+    def __dir__(self):
+        return ['parse', 'error', 'request', 'response', 'robotparser']
+
+_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
+                      "moves.urllib")
+
+
+def add_move(move):
+    """Add an item to six.moves."""
+    setattr(_MovedItems, move.name, move)
+
+
+def remove_move(name):
+    """Remove item from six.moves."""
+    try:
+        delattr(_MovedItems, name)
+    except AttributeError:
+        try:
+            del moves.__dict__[name]
+        except KeyError:
+            raise AttributeError("no such move, %r" % (name,))
+
+
+if PY3:
+    _meth_func = "__func__"
+    _meth_self = "__self__"
+
+    _func_closure = "__closure__"
+    _func_code = "__code__"
+    _func_defaults = "__defaults__"
+    _func_globals = "__globals__"
+else:
+    _meth_func = "im_func"
+    _meth_self = "im_self"
+
+    _func_closure = "func_closure"
+    _func_code = "func_code"
+    _func_defaults = "func_defaults"
+    _func_globals = "func_globals"
+
+
+try:
+    advance_iterator = next
+except NameError:
+    def advance_iterator(it):
+        return it.next()
+next = advance_iterator
+
+
+try:
+    callable = callable
+except NameError:
+    def callable(obj):
+        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)
+
+
+if PY3:
+    def get_unbound_function(unbound):
+        return unbound
+
+    create_bound_method = types.MethodType
+
+    def create_unbound_method(func, cls):
+        return func
+
+    Iterator = object
+else:
+    def get_unbound_function(unbound):
+        return unbound.im_func
+
+    def create_bound_method(func, obj):
+        return types.MethodType(func, obj, obj.__class__)
+
+    def create_unbound_method(func, cls):
+        return types.MethodType(func, None, cls)
+
+    class Iterator(object):
+
+        def next(self):
+            return type(self).__next__(self)
+
+    callable = callable
+_add_doc(get_unbound_function,
+         """Get the function out of a possibly unbound function""")
+
+
+get_method_function = operator.attrgetter(_meth_func)
+get_method_self = operator.attrgetter(_meth_self)
+get_function_closure = operator.attrgetter(_func_closure)
+get_function_code = operator.attrgetter(_func_code)
+get_function_defaults = operator.attrgetter(_func_defaults)
+get_function_globals = operator.attrgetter(_func_globals)
+
+
+if PY3:
+    def iterkeys(d, **kw):
+        return iter(d.keys(**kw))
+
+    def itervalues(d, **kw):
+        return iter(d.values(**kw))
+
+    def iteritems(d, **kw):
+        return iter(d.items(**kw))
+
+    def iterlists(d, **kw):
+        return iter(d.lists(**kw))
+
+    viewkeys = operator.methodcaller("keys")
+
+    viewvalues = operator.methodcaller("values")
+
+    viewitems = operator.methodcaller("items")
+else:
+    def iterkeys(d, **kw):
+        return d.iterkeys(**kw)
+
+    def itervalues(d, **kw):
+        return d.itervalues(**kw)
+
+    def iteritems(d, **kw):
+        return d.iteritems(**kw)
+
+    def iterlists(d, **kw):
+        return d.iterlists(**kw)
+
+    viewkeys = operator.methodcaller("viewkeys")
+
+    viewvalues = operator.methodcaller("viewvalues")
+
+    viewitems = operator.methodcaller("viewitems")
+
+_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
+_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
+_add_doc(iteritems,
+         "Return an iterator over the (key, value) pairs of a dictionary.")
+_add_doc(iterlists,
+         "Return an iterator over the (key, [values]) pairs of a dictionary.")
+
+
+if PY3:
+    def b(s):
+        return s.encode("latin-1")
+
+    def u(s):
+        return s
+    unichr = chr
+    import struct
+    int2byte = struct.Struct(">B").pack
+    del struct
+    byte2int = operator.itemgetter(0)
+    indexbytes = operator.getitem
+    iterbytes = iter
+    import io
+    StringIO = io.StringIO
+    BytesIO = io.BytesIO
+    del io
+    _assertCountEqual = "assertCountEqual"
+    if sys.version_info[1] <= 1:
+        _assertRaisesRegex = "assertRaisesRegexp"
+        _assertRegex = "assertRegexpMatches"
+        _assertNotRegex = "assertNotRegexpMatches"
+    else:
+        _assertRaisesRegex = "assertRaisesRegex"
+        _assertRegex = "assertRegex"
+        _assertNotRegex = "assertNotRegex"
+else:
+    def b(s):
+        return s
+    # Workaround for standalone backslash
+
+    def u(s):
+        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
+    unichr = unichr
+    int2byte = chr
+
+    def byte2int(bs):
+        return ord(bs[0])
+
+    def indexbytes(buf, i):
+        return ord(buf[i])
+    iterbytes = functools.partial(itertools.imap, ord)
+    import StringIO
+    StringIO = BytesIO = StringIO.StringIO
+    _assertCountEqual = "assertItemsEqual"
+    _assertRaisesRegex = "assertRaisesRegexp"
+    _assertRegex = "assertRegexpMatches"
+    _assertNotRegex = "assertNotRegexpMatches"
+_add_doc(b, """Byte literal""")
+_add_doc(u, """Text literal""")
+
+
+def assertCountEqual(self, *args, **kwargs):
+    return getattr(self, _assertCountEqual)(*args, **kwargs)
+
+
+def assertRaisesRegex(self, *args, **kwargs):
+    return getattr(self, _assertRaisesRegex)(*args, **kwargs)
+
+
+def assertRegex(self, *args, **kwargs):
+    return getattr(self, _assertRegex)(*args, **kwargs)
+
+
+def assertNotRegex(self, *args, **kwargs):
+    return getattr(self, _assertNotRegex)(*args, **kwargs)
+
+
+if PY3:
+    exec_ = getattr(moves.builtins, "exec")
+
+    def reraise(tp, value, tb=None):
+        try:
+            if value is None:
+                value = tp()
+            if value.__traceback__ is not tb:
+                raise value.with_traceback(tb)
+            raise value
+        finally:
+            value = None
+            tb = None
+
+else:
+    def exec_(_code_, _globs_=None, _locs_=None):
+        """Execute code in a namespace."""
+        if _globs_ is None:
+            frame = sys._getframe(1)
+            _globs_ = frame.f_globals
+            if _locs_ is None:
+                _locs_ = frame.f_locals
+            del frame
+        elif _locs_ is None:
+            _locs_ = _globs_
+        exec("""exec _code_ in _globs_, _locs_""")
+
+    exec_("""def reraise(tp, value, tb=None):
+    try:
+        raise tp, value, tb
+    finally:
+        tb = None
+""")
+
+
+if sys.version_info[:2] > (3,):
+    exec_("""def raise_from(value, from_value):
+    try:
+        raise value from from_value
+    finally:
+        value = None
+""")
+else:
+    def raise_from(value, from_value):
+        raise value
+
+
+print_ = getattr(moves.builtins, "print", None)
+if print_ is None:
+    def print_(*args, **kwargs):
+        """The new-style print function for Python 2.4 and 2.5."""
+        fp = kwargs.pop("file", sys.stdout)
+        if fp is None:
+            return
+
+        def write(data):
+            if not isinstance(data, basestring):
+                data = str(data)
+            # If the file has an encoding, encode unicode with it.
+            if (isinstance(fp, file) and
+                    isinstance(data, unicode) and
+                    fp.encoding is not None):
+                errors = getattr(fp, "errors", None)
+                if errors is None:
+                    errors = "strict"
+                data = data.encode(fp.encoding, errors)
+            fp.write(data)
+        want_unicode = False
+        sep = kwargs.pop("sep", None)
+        if sep is not None:
+            if isinstance(sep, unicode):
+                want_unicode = True
+            elif not isinstance(sep, str):
+                raise TypeError("sep must be None or a string")
+        end = kwargs.pop("end", None)
+        if end is not None:
+            if isinstance(end, unicode):
+                want_unicode = True
+            elif not isinstance(end, str):
+                raise TypeError("end must be None or a string")
+        if kwargs:
+            raise TypeError("invalid keyword arguments to print()")
+        if not want_unicode:
+            for arg in args:
+                if isinstance(arg, unicode):
+                    want_unicode = True
+                    break
+        if want_unicode:
+            newline = unicode("\n")
+            space = unicode(" ")
+        else:
+            newline = "\n"
+            space = " "
+        if sep is None:
+            sep = space
+        if end is None:
+            end = newline
+        for i, arg in enumerate(args):
+            if i:
+                write(sep)
+            write(arg)
+        write(end)
+if sys.version_info[:2] < (3, 3):
+    _print = print_
+
+    def print_(*args, **kwargs):
+        fp = kwargs.get("file", sys.stdout)
+        flush = kwargs.pop("flush", False)
+        _print(*args, **kwargs)
+        if flush and fp is not None:
+            fp.flush()
+
+_add_doc(reraise, """Reraise an exception.""")
+
+if sys.version_info[0:2] < (3, 4):
+    # This does exactly the same what the :func:`py3:functools.update_wrapper`
+    # function does on Python versions after 3.2. It sets the ``__wrapped__``
+    # attribute on ``wrapper`` object and it doesn't raise an error if any of
+    # the attributes mentioned in ``assigned`` and ``updated`` are missing on
+    # ``wrapped`` object.
+    def _update_wrapper(wrapper, wrapped,
+                        assigned=functools.WRAPPER_ASSIGNMENTS,
+                        updated=functools.WRAPPER_UPDATES):
+        for attr in assigned:
+            try:
+                value = getattr(wrapped, attr)
+            except AttributeError:
+                continue
+            else:
+                setattr(wrapper, attr, value)
+        for attr in updated:
+            getattr(wrapper, attr).update(getattr(wrapped, attr, {}))
+        wrapper.__wrapped__ = wrapped
+        return wrapper
+    _update_wrapper.__doc__ = functools.update_wrapper.__doc__
+
+    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
+              updated=functools.WRAPPER_UPDATES):
+        return functools.partial(_update_wrapper, wrapped=wrapped,
+                                 assigned=assigned, updated=updated)
+    wraps.__doc__ = functools.wraps.__doc__
+
+else:
+    wraps = functools.wraps
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a dummy
+    # metaclass for one level of class instantiation that replaces itself with
+    # the actual metaclass.
+    class metaclass(type):
+
+        def __new__(cls, name, this_bases, d):
+            if sys.version_info[:2] >= (3, 7):
+                # This version introduced PEP 560 that requires a bit
+                # of extra care (we mimic what is done by __build_class__).
+                resolved_bases = types.resolve_bases(bases)
+                if resolved_bases is not bases:
+                    d['__orig_bases__'] = bases
+            else:
+                resolved_bases = bases
+            return meta(name, resolved_bases, d)
+
+        @classmethod
+        def __prepare__(cls, name, this_bases):
+            return meta.__prepare__(name, bases)
+    return type.__new__(metaclass, 'temporary_class', (), {})
+
+
+def add_metaclass(metaclass):
+    """Class decorator for creating a class with a metaclass."""
+    def wrapper(cls):
+        orig_vars = cls.__dict__.copy()
+        slots = orig_vars.get('__slots__')
+        if slots is not None:
+            if isinstance(slots, str):
+                slots = [slots]
+            for slots_var in slots:
+                orig_vars.pop(slots_var)
+        orig_vars.pop('__dict__', None)
+        orig_vars.pop('__weakref__', None)
+        if hasattr(cls, '__qualname__'):
+            orig_vars['__qualname__'] = cls.__qualname__
+        return metaclass(cls.__name__, cls.__bases__, orig_vars)
+    return wrapper
+
+
+def ensure_binary(s, encoding='utf-8', errors='strict'):
+    """Coerce **s** to six.binary_type.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> encoded to `bytes`
+      - `bytes` -> `bytes`
+    """
+    if isinstance(s, text_type):
+        return s.encode(encoding, errors)
+    elif isinstance(s, binary_type):
+        return s
+    else:
+        raise TypeError("not expecting type '%s'" % type(s))
+
+
+def ensure_str(s, encoding='utf-8', errors='strict'):
+    """Coerce *s* to `str`.
+
+    For Python 2:
+      - `unicode` -> encoded to `str`
+      - `str` -> `str`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    if not isinstance(s, (text_type, binary_type)):
+        raise TypeError("not expecting type '%s'" % type(s))
+    if PY2 and isinstance(s, text_type):
+        s = s.encode(encoding, errors)
+    elif PY3 and isinstance(s, binary_type):
+        s = s.decode(encoding, errors)
+    return s
+
+
+def ensure_text(s, encoding='utf-8', errors='strict'):
+    """Coerce *s* to six.text_type.
+
+    For Python 2:
+      - `unicode` -> `unicode`
+      - `str` -> `unicode`
+
+    For Python 3:
+      - `str` -> `str`
+      - `bytes` -> decoded to `str`
+    """
+    if isinstance(s, binary_type):
+        return s.decode(encoding, errors)
+    elif isinstance(s, text_type):
+        return s
+    else:
+        raise TypeError("not expecting type '%s'" % type(s))
+
+
+def python_2_unicode_compatible(klass):
+    """
+    A class decorator that defines __unicode__ and __str__ methods under Python 2.
+    Under Python 3 it does nothing.
+
+    To support Python 2 and 3 with a single code base, define a __str__ method
+    returning text and apply this decorator to the class.
+    """
+    if PY2:
+        if '__str__' not in klass.__dict__:
+            raise ValueError("@python_2_unicode_compatible cannot be applied "
+                             "to %s because it doesn't define __str__()." %
+                             klass.__name__)
+        klass.__unicode__ = klass.__str__
+        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
+    return klass
+
+
+# Complete the moves implementation.
+# This code is at the end of this module to speed up module loading.
+# Turn this module into a package.
+__path__ = []  # required for PEP 302 and PEP 451
+__package__ = __name__  # see PEP 366 @ReservedAssignment
+if globals().get("__spec__") is not None:
+    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
+# Remove other six meta path importers, since they cause problems. This can
+# happen if six is removed from sys.modules and then reloaded. (Setuptools does
+# this for some reason.)
+if sys.meta_path:
+    for i, importer in enumerate(sys.meta_path):
+        # Here's some real nastiness: Another "instance" of the six module might
+        # be floating around. Therefore, we can't use isinstance() to check for
+        # the six meta path importer, since the other six instance will have
+        # inserted an importer with different class.
+        if (type(importer).__name__ == "_SixMetaPathImporter" and
+                importer.name == __name__):
+            del sys.meta_path[i]
+            break
+    del i, importer
+# Finally, add the importer to the meta path import hook.
+sys.meta_path.append(_importer)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/LICENSE b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..5a8cd81d4d0af3abdd1d36e0794f0cd2d4e1c96f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2011-2020 Sergey Astanin and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b590576607c29783a0a0003939c3ed0f8c1c79f4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/METADATA
@@ -0,0 +1,764 @@
+Metadata-Version: 2.1
+Name: tabulate
+Version: 0.8.7
+Summary: Pretty-print tabular data
+Home-page: https://github.com/astanin/python-tabulate
+Author: Sergey Astanin
+Author-email: s.astanin@gmail.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Software Development :: Libraries
+Description-Content-Type: text/markdown
+Provides-Extra: widechars
+Requires-Dist: wcwidth ; extra == 'widechars'
+
+python-tabulate
+===============
+
+Pretty-print tabular data in Python, a library and a command-line
+utility.
+
+The main use cases of the library are:
+
+-   printing small tables without hassle: just one function call,
+    formatting is guided by the data itself
+-   authoring tabular data for lightweight plain-text markup: multiple
+    output formats suitable for further editing or transformation
+-   readable presentation of mixed textual and numeric data: smart
+    column alignment, configurable number formatting, alignment by a
+    decimal point
+
+Installation
+------------
+
+To install the Python library and the command line utility, run:
+
+    pip install tabulate
+
+The command line utility will be installed as `tabulate` to `bin` on
+Linux (e.g. `/usr/bin`); or as `tabulate.exe` to `Scripts` in your
+Python installation on Windows (e.g.
+`C:\Python27\Scripts\tabulate.exe`).
+
+You may consider installing the library only for the current user:
+
+    pip install tabulate --user
+
+In this case the command line utility will be installed to
+`~/.local/bin/tabulate` on Linux and to
+`%APPDATA%\Python\Scripts\tabulate.exe` on Windows.
+
+To install just the library on Unix-like operating systems:
+
+    TABULATE_INSTALL=lib-only pip install tabulate
+
+On Windows:
+
+    set TABULATE_INSTALL=lib-only
+    pip install tabulate
+
+The module provides just one function, `tabulate`, which takes a list of
+lists or another tabular data type as the first argument, and outputs a
+nicely formatted plain-text table:
+
+    >>> from tabulate import tabulate
+
+    >>> table = [["Sun",696000,1989100000],["Earth",6371,5973.6],
+    ...          ["Moon",1737,73.5],["Mars",3390,641.85]]
+    >>> print(tabulate(table))
+    -----  ------  -------------
+    Sun    696000     1.9891e+09
+    Earth    6371  5973.6
+    Moon     1737    73.5
+    Mars     3390   641.85
+    -----  ------  -------------
+
+The following tabular data types are supported:
+
+-   list of lists or another iterable of iterables
+-   list or another iterable of dicts (keys as columns)
+-   dict of iterables (keys as columns)
+-   two-dimensional NumPy array
+-   NumPy record arrays (names as columns)
+-   pandas.DataFrame
+
+Examples in this file use Python2. Tabulate supports Python3 too.
+
+### Headers
+
+The second optional argument named `headers` defines a list of column
+headers to be used:
+
+    >>> print(tabulate(table, headers=["Planet","R (km)", "mass (x 10^29 kg)"]))
+    Planet      R (km)    mass (x 10^29 kg)
+    --------  --------  -------------------
+    Sun         696000           1.9891e+09
+    Earth         6371        5973.6
+    Moon          1737          73.5
+    Mars          3390         641.85
+
+If `headers="firstrow"`, then the first row of data is used:
+
+    >>> print(tabulate([["Name","Age"],["Alice",24],["Bob",19]],
+    ...                headers="firstrow"))
+    Name      Age
+    ------  -----
+    Alice      24
+    Bob        19
+
+If `headers="keys"`, then the keys of a dictionary/dataframe, or column
+indices are used. It also works for NumPy record arrays and lists of
+dictionaries or named tuples:
+
+    >>> print(tabulate({"Name": ["Alice", "Bob"],
+    ...                 "Age": [24, 19]}, headers="keys"))
+      Age  Name
+    -----  ------
+       24  Alice
+       19  Bob
+
+### Row Indices
+
+By default, only pandas.DataFrame tables have an additional column
+called row index. To add a similar column to any other type of table,
+pass `showindex="always"` or `showindex=True` argument to `tabulate()`.
+To suppress row indices for all types of data, pass `showindex="never"`
+or `showindex=False`. To add a custom row index column, pass
+`showindex=rowIDs`, where `rowIDs` is some iterable:
+
+    >>> print(tabulate([["F",24],["M",19]], showindex="always"))
+    -  -  --
+    0  F  24
+    1  M  19
+    -  -  --
+
+### Table format
+
+There is more than one way to format a table in plain text. The third
+optional argument named `tablefmt` defines how the table is formatted.
+
+Supported table formats are:
+
+-   "plain"
+-   "simple"
+-   "github"
+-   "grid"
+-   "fancy\_grid"
+-   "pipe"
+-   "orgtbl"
+-   "jira"
+-   "presto"
+-   "pretty"
+-   "psql"
+-   "rst"
+-   "mediawiki"
+-   "moinmoin"
+-   "youtrack"
+-   "html"
+-   "latex"
+-   "latex\_raw"
+-   "latex\_booktabs"
+-   "textile"
+
+`plain` tables do not use any pseudo-graphics to draw lines:
+
+    >>> table = [["spam",42],["eggs",451],["bacon",0]]
+    >>> headers = ["item", "qty"]
+    >>> print(tabulate(table, headers, tablefmt="plain"))
+    item      qty
+    spam       42
+    eggs      451
+    bacon       0
+
+`simple` is the default format (the default may change in future
+versions). It corresponds to `simple_tables` in [Pandoc Markdown
+extensions](http://johnmacfarlane.net/pandoc/README.html#tables):
+
+    >>> print(tabulate(table, headers, tablefmt="simple"))
+    item      qty
+    ------  -----
+    spam       42
+    eggs      451
+    bacon       0
+
+`github` follows the conventions of Github flavored Markdown. It
+corresponds to the `pipe` format without alignment colons:
+
+    >>> print(tabulate(table, headers, tablefmt="github"))
+    | item   | qty   |
+    |--------|-------|
+    | spam   | 42    |
+    | eggs   | 451   |
+    | bacon  | 0     |
+
+`grid` is like tables formatted by Emacs'
+[table.el](http://table.sourceforge.net/) package. It corresponds to
+`grid_tables` in Pandoc Markdown extensions:
+
+    >>> print(tabulate(table, headers, tablefmt="grid"))
+    +--------+-------+
+    | item   |   qty |
+    +========+=======+
+    | spam   |    42 |
+    +--------+-------+
+    | eggs   |   451 |
+    +--------+-------+
+    | bacon  |     0 |
+    +--------+-------+
+
+`fancy_grid` draws a grid using box-drawing characters:
+
+    >>> print(tabulate(table, headers, tablefmt="fancy_grid"))
+    ╒════════╤═══════╕
+    │ item   │   qty │
+    ╞════════╪═══════╡
+    │ spam   │    42 │
+    ├────────┼───────┤
+    │ eggs   │   451 │
+    ├────────┼───────┤
+    │ bacon  │     0 │
+    ╘════════╧═══════╛
+
+`presto` is like tables formatted by Presto cli:
+
+    >>> print(tabulate(table, headers, tablefmt="presto"))
+     item   |   qty
+    --------+-------
+     spam   |    42
+     eggs   |   451
+     bacon  |     0
+
+`pretty` attempts to be close to the format emitted by the PrettyTables
+library:
+
+    >>> print(tabulate(table, headers, tablefmt="pretty"))
+    +-------+-----+
+    | item  | qty |
+    +-------+-----+
+    | spam  | 42  |
+    | eggs  | 451 |
+    | bacon |  0  |
+    +-------+-----+
+
+`psql` is like tables formatted by Postgres' psql cli:
+
+    >>> print(tabulate(table, headers, tablefmt="psql"))
+    +--------+-------+
+    | item   |   qty |
+    |--------+-------|
+    | spam   |    42 |
+    | eggs   |   451 |
+    | bacon  |     0 |
+    +--------+-------+
+
+`pipe` follows the conventions of [PHP Markdown
+Extra](http://michelf.ca/projects/php-markdown/extra/#table) extension.
+It corresponds to `pipe_tables` in Pandoc. This format uses colons to
+indicate column alignment:
+
+    >>> print(tabulate(table, headers, tablefmt="pipe"))
+    | item   |   qty |
+    |:-------|------:|
+    | spam   |    42 |
+    | eggs   |   451 |
+    | bacon  |     0 |
+
+`orgtbl` follows the conventions of Emacs
+[org-mode](http://orgmode.org/manual/Tables.html), and is editable also
+in the minor orgtbl-mode. Hence its name:
+
+    >>> print(tabulate(table, headers, tablefmt="orgtbl"))
+    | item   |   qty |
+    |--------+-------|
+    | spam   |    42 |
+    | eggs   |   451 |
+    | bacon  |     0 |
+
+`jira` follows the conventions of Atlassian Jira markup language:
+
+    >>> print(tabulate(table, headers, tablefmt="jira"))
+    || item   ||   qty ||
+    | spam   |    42 |
+    | eggs   |   451 |
+    | bacon  |     0 |
+
+`rst` formats data like a simple table of the
+[reStructuredText](http://docutils.sourceforge.net/docs/user/rst/quickref.html#tables)
+format:
+
+    >>> print(tabulate(table, headers, tablefmt="rst"))
+    ======  =====
+    item      qty
+    ======  =====
+    spam       42
+    eggs      451
+    bacon       0
+    ======  =====
+
+`mediawiki` format produces a table markup used in
+[Wikipedia](http://www.mediawiki.org/wiki/Help:Tables) and on other
+MediaWiki-based sites:
+
+    >>> print(tabulate(table, headers, tablefmt="mediawiki"))
+    {| class="wikitable" style="text-align: left;"
+    |+ <!-- caption -->
+    |-
+    ! item   !! align="right"|   qty
+    |-
+    | spam   || align="right"|    42
+    |-
+    | eggs   || align="right"|   451
+    |-
+    | bacon  || align="right"|     0
+    |}
+
+`moinmoin` format produces a table markup used in
+[MoinMoin](https://moinmo.in/) wikis:
+
+    >>> print(tabulate(table, headers, tablefmt="moinmoin"))
+    || ''' item   ''' || ''' quantity   ''' ||
+    ||  spam    ||  41.999      ||
+    ||  eggs    ||  451         ||
+    ||  bacon   ||              ||
+
+`youtrack` format produces a table markup used in Youtrack tickets:
+
+    >>> print(tabulate(table, headers, tablefmt="youtrack"))
+    ||  item    ||  quantity   ||
+    |   spam    |  41.999      |
+    |   eggs    |  451         |
+    |   bacon   |              |
+
+`textile` format produces a table markup used in
+[Textile](http://redcloth.org/hobix.com/textile/) format:
+
+    >>> print(tabulate(table, headers, tablefmt="textile"))
+    |_.  item   |_.   qty |
+    |<. spam    |>.    42 |
+    |<. eggs    |>.   451 |
+    |<. bacon   |>.     0 |
+
+`html` produces standard HTML markup as an html.escape'd str
+with a ._repr_html_ method so that Jupyter Lab and Notebook display the HTML
+and a .str property so that the raw HTML remains accessible:
+
+    >>> print(tabulate(table, headers, tablefmt="html"))
+    <table>
+    <tbody>
+    <tr><th>item  </th><th style="text-align: right;">  qty</th></tr>
+    <tr><td>spam  </td><td style="text-align: right;">   42</td></tr>
+    <tr><td>eggs  </td><td style="text-align: right;">  451</td></tr>
+    <tr><td>bacon </td><td style="text-align: right;">    0</td></tr>
+    </tbody>
+    </table>
+
+`latex` format creates a `tabular` environment for LaTeX markup,
+replacing special characters like `_` or `\` to their LaTeX
+correspondents:
+
+    >>> print(tabulate(table, headers, tablefmt="latex"))
+    \begin{tabular}{lr}
+    \hline
+     item   &   qty \\
+    \hline
+     spam   &    42 \\
+     eggs   &   451 \\
+     bacon  &     0 \\
+    \hline
+    \end{tabular}
+
+`latex_raw` behaves like `latex` but does not escape LaTeX commands and
+special characters.
+
+`latex_booktabs` creates a `tabular` environment for LaTeX markup using
+spacing and style from the `booktabs` package.
+
+### Column alignment
+
+`tabulate` is smart about column alignment. It detects columns which
+contain only numbers, and aligns them by a decimal point (or flushes
+them to the right if they appear to be integers). Text columns are
+flushed to the left.
+
+You can override the default alignment with `numalign` and `stralign`
+named arguments. Possible column alignments are: `right`, `center`,
+`left`, `decimal` (only for numbers), and `None` (to disable alignment).
+
+Aligning by a decimal point works best when you need to compare numbers
+at a glance:
+
+    >>> print(tabulate([[1.2345],[123.45],[12.345],[12345],[1234.5]]))
+    ----------
+        1.2345
+      123.45
+       12.345
+    12345
+     1234.5
+    ----------
+
+Compare this with a more common right alignment:
+
+    >>> print(tabulate([[1.2345],[123.45],[12.345],[12345],[1234.5]], numalign="right"))
+    ------
+    1.2345
+    123.45
+    12.345
+     12345
+    1234.5
+    ------
+
+For `tabulate`, anything which can be parsed as a number is a number.
+Even numbers represented as strings are aligned properly. This feature
+comes in handy when reading a mixed table of text and numbers from a
+file:
+
+    >>> import csv ; from StringIO import StringIO
+    >>> table = list(csv.reader(StringIO("spam, 42\neggs, 451\n")))
+    >>> table
+    [['spam', ' 42'], ['eggs', ' 451']]
+    >>> print(tabulate(table))
+    ----  ----
+    spam    42
+    eggs   451
+    ----  ----
+
+
+To disable this feature use `disable_numparse=True`.
+
+    >>> print(tabulate.tabulate([["Ver1", "18.0"], ["Ver2","19.2"]], tablefmt="simple", disable_numparse=True))
+    ----  ----
+    Ver1  18.0
+    Ver2  19.2
+    ----  ----
+
+
+### Custom column alignment
+
+`tabulate` allows a custom column alignment to override the above. The
+`colalign` argument can be a list or a tuple of `stralign` named
+arguments. Possible column alignments are: `right`, `center`, `left`,
+`decimal` (only for numbers), and `None` (to disable alignment).
+Omitting an alignment uses the default. For example:
+
+    >>> print(tabulate([["one", "two"], ["three", "four"]], colalign=("right",))
+    -----  ----
+      one  two
+    three  four
+    -----  ----
+
+### Number formatting
+
+`tabulate` allows to define custom number formatting applied to all
+columns of decimal numbers. Use `floatfmt` named argument:
+
+    >>> print(tabulate([["pi",3.141593],["e",2.718282]], floatfmt=".4f"))
+    --  ------
+    pi  3.1416
+    e   2.7183
+    --  ------
+
+`floatfmt` argument can be a list or a tuple of format strings, one per
+column, in which case every column may have different number formatting:
+
+    >>> print(tabulate([[0.12345, 0.12345, 0.12345]], floatfmt=(".1f", ".3f")))
+    ---  -----  -------
+    0.1  0.123  0.12345
+    ---  -----  -------
+
+### Text formatting
+
+By default, `tabulate` removes leading and trailing whitespace from text
+columns. To disable whitespace removal, set the global module-level flag
+`PRESERVE_WHITESPACE`:
+
+    import tabulate
+    tabulate.PRESERVE_WHITESPACE = True
+
+### Wide (fullwidth CJK) symbols
+
+To properly align tables which contain wide characters (typically
+fullwidth glyphs from Chinese, Japanese or Korean languages), the user
+should install `wcwidth` library. To install it together with
+`tabulate`:
+
+    pip install tabulate[widechars]
+
+Wide character support is enabled automatically if `wcwidth` library is
+already installed. To disable wide characters support without
+uninstalling `wcwidth`, set the global module-level flag
+`WIDE_CHARS_MODE`:
+
+    import tabulate
+    tabulate.WIDE_CHARS_MODE = False
+
+### Multiline cells
+
+Most table formats support multiline cell text (text containing newline
+characters). The newline characters are honored as line break
+characters.
+
+Multiline cells are supported for data rows and for header rows.
+
+Further automatic line breaks are not inserted. Of course, some output
+formats such as latex or html handle automatic formatting of the cell
+content on their own, but for those that don't, the newline characters
+in the input cell text are the only means to break a line in cell text.
+
+Note that some output formats (e.g. simple, or plain) do not represent
+row delimiters, so that the representation of multiline cells in such
+formats may be ambiguous to the reader.
+
+The following examples of formatted output use the following table with
+a multiline cell, and headers with a multiline cell:
+
+    >>> table = [["eggs",451],["more\nspam",42]]
+    >>> headers = ["item\nname", "qty"]
+
+`plain` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="plain"))
+    item      qty
+    name
+    eggs      451
+    more       42
+    spam
+
+`simple` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="simple"))
+    item      qty
+    name
+    ------  -----
+    eggs      451
+    more       42
+    spam
+
+`grid` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="grid"))
+    +--------+-------+
+    | item   |   qty |
+    | name   |       |
+    +========+=======+
+    | eggs   |   451 |
+    +--------+-------+
+    | more   |    42 |
+    | spam   |       |
+    +--------+-------+
+
+`fancy_grid` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="fancy_grid"))
+    ╒════════╤═══════╕
+    │ item   │   qty │
+    │ name   │       │
+    ╞════════╪═══════╡
+    │ eggs   │   451 │
+    ├────────┼───────┤
+    │ more   │    42 │
+    │ spam   │       │
+    ╘════════╧═══════╛
+
+`pipe` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="pipe"))
+    | item   |   qty |
+    | name   |       |
+    |:-------|------:|
+    | eggs   |   451 |
+    | more   |    42 |
+    | spam   |       |
+
+`orgtbl` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="orgtbl"))
+    | item   |   qty |
+    | name   |       |
+    |--------+-------|
+    | eggs   |   451 |
+    | more   |    42 |
+    | spam   |       |
+
+`jira` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="jira"))
+    | item   |   qty |
+    | name   |       |
+    |:-------|------:|
+    | eggs   |   451 |
+    | more   |    42 |
+    | spam   |       |
+
+`presto` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="presto"))
+     item   |   qty
+     name   |
+    --------+-------
+     eggs   |   451
+     more   |    42
+     spam   |
+
+`pretty` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="pretty"))
+    +------+-----+
+    | item | qty |
+    | name |     |
+    +------+-----+
+    | eggs | 451 |
+    | more | 42  |
+    | spam |     |
+    +------+-----+
+
+`psql` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="psql"))
+    +--------+-------+
+    | item   |   qty |
+    | name   |       |
+    |--------+-------|
+    | eggs   |   451 |
+    | more   |    42 |
+    | spam   |       |
+    +--------+-------+
+
+`rst` tables:
+
+    >>> print(tabulate(table, headers, tablefmt="rst"))
+    ======  =====
+    item      qty
+    name
+    ======  =====
+    eggs      451
+    more       42
+    spam
+    ======  =====
+
+Multiline cells are not well supported for the other table formats.
+
+Usage of the command line utility
+---------------------------------
+
+    Usage: tabulate [options] [FILE ...]
+
+    FILE                      a filename of the file with tabular data;
+                              if "-" or missing, read data from stdin.
+
+    Options:
+
+    -h, --help                show this message
+    -1, --header              use the first row of data as a table header
+    -o FILE, --output FILE    print table to FILE (default: stdout)
+    -s REGEXP, --sep REGEXP   use a custom column separator (default: whitespace)
+    -F FPFMT, --float FPFMT   floating point number format (default: g)
+    -f FMT, --format FMT      set output table format; supported formats:
+                              plain, simple, github, grid, fancy_grid, pipe,
+                              orgtbl, rst, mediawiki, html, latex, latex_raw,
+                              latex_booktabs, tsv
+                              (default: simple)
+
+Performance considerations
+--------------------------
+
+Such features as decimal point alignment and trying to parse everything
+as a number imply that `tabulate`:
+
+-   has to "guess" how to print a particular tabular data type
+-   needs to keep the entire table in-memory
+-   has to "transpose" the table twice
+-   does much more work than it may appear
+
+It may not be suitable for serializing really big tables (but who's
+going to do that, anyway?) or printing tables in performance sensitive
+applications. `tabulate` is about two orders of magnitude slower than
+simply joining lists of values with a tab, coma or other separator.
+
+In the same time `tabulate` is comparable to other table
+pretty-printers. Given a 10x10 table (a list of lists) of mixed text and
+numeric data, `tabulate` appears to be slower than `asciitable`, and
+faster than `PrettyTable` and `texttable` The following mini-benchmark
+was run in Python 3.8.1 in Windows 10 x64:
+
+    ===========================  ==========  ===========
+    Table formatter                time, μs    rel. time
+    ===========================  ==========  ===========
+    csv to StringIO                    12.4          1.0
+    join with tabs and newlines        15.7          1.3
+    asciitable (0.8.0)                208.3         16.7
+    tabulate (0.8.7)                  492.1         39.5
+    PrettyTable (0.7.2)               945.5         76.0
+    texttable (1.6.2)                1239.5         99.6
+    ===========================  ==========  ===========
+
+
+Version history
+---------------
+
+The full version history can be found at the [changelog](https://github.com/astanin/python-tabulate/blob/master/CHANGELOG).
+
+How to contribute
+-----------------
+
+Contributions should include tests and an explanation for the changes
+they propose. Documentation (examples, docstrings, README.md) should be
+updated accordingly.
+
+This project uses [nose](https://nose.readthedocs.org/) testing
+framework and [tox](https://tox.readthedocs.io/) to automate testing in
+different environments. Add tests to one of the files in the `test/`
+folder.
+
+To run tests on all supported Python versions, make sure all Python
+interpreters, `nose` and `tox` are installed, then run `tox` in the root
+of the project source tree.
+
+On Linux `tox` expects to find executables like `python2.6`,
+`python2.7`, `python3.4` etc. On Windows it looks for
+`C:\Python26\python.exe`, `C:\Python27\python.exe` and
+`C:\Python34\python.exe` respectively.
+
+To test only some Python environements, use `-e` option. For example, to
+test only against Python 2.7 and Python 3.6, run:
+
+    tox -e py27,py36
+
+in the root of the project source tree.
+
+To enable NumPy and Pandas tests, run:
+
+    tox -e py27-extra,py36-extra
+
+(this may take a long time the first time, because NumPy and Pandas will
+have to be installed in the new virtual environments)
+
+See `tox.ini` file to learn how to use `nosetests` directly to test
+individual Python versions.
+
+Contributors
+------------
+
+Sergey Astanin, Pau Tallada Crespí, Erwin Marsi, Mik Kocikowski, Bill
+Ryder, Zach Dwiel, Frederik Rietdijk, Philipp Bogensberger, Greg
+(anonymous), Stefan Tatschner, Emiel van Miltenburg, Brandon Bennett,
+Amjith Ramanujam, Jan Schulz, Simon Percivall, Javier Santacruz
+López-Cepero, Sam Denton, Alexey Ziyangirov, acaird, Cesar Sanchez,
+naught101, John Vandenberg, Zack Dever, Christian Clauss, Benjamin
+Maier, Andy MacKinlay, Thomas Roten, Jue Wang, Joe King, Samuel Phan,
+Nick Satterly, Daniel Robbins, Dmitry B, Lars Butler, Andreas Maier,
+Dick Marinus, Sébastien Celles, Yago González, Andrew Gaul, Wim Glenn,
+Jean Michel Rouly, Tim Gates, John Vandenberg, Sorin Sbarnea,
+Wes Turner, Andrew Tija, Marco Gorelli, Sean McGinnis.
+
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c6bb87aa23bdb1be4b4e926c7129ed2b714bce2c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/RECORD
@@ -0,0 +1,10 @@
+../../../bin/tabulate,sha256=a1DSV4jkKEFljSDBj1QLGWmWKrCAqFTqyvdvhH1oj9g,288
+__pycache__/tabulate.cpython-38.pyc,,
+tabulate-0.8.7.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+tabulate-0.8.7.dist-info/LICENSE,sha256=6bNViQPkNRfsJ2Pin2Vklflp5xvKRIstLq03fwc0T6U,1100
+tabulate-0.8.7.dist-info/METADATA,sha256=SJhawFy4gRWr7NSQuttcxGdviTDXvVfoViOxXUnX4bk,23289
+tabulate-0.8.7.dist-info/RECORD,,
+tabulate-0.8.7.dist-info/WHEEL,sha256=YUYzQ6UQdoqxXjimOitTqynltBCkwY6qlTfTh2IzqQU,97
+tabulate-0.8.7.dist-info/entry_points.txt,sha256=R-8IlY0RHy0EXNyBPehiL7TYKv66LRyiY4WVphnq3_I,45
+tabulate-0.8.7.dist-info/top_level.txt,sha256=qfqkQ2az7LTxUeRePtX8ggmh294Kf1ERdI-11aWqFZU,9
+tabulate.py,sha256=TeAgSzbArSG3Vl_wCPeLN-0pP7Mt6cxjseznKCjQK-I,58932
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..acdf1b22876da53f69c081bf6e0992f9fcbe15d7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..29393b6c82d66f000e051a27f5d38e68dda3c9e5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+tabulate = tabulate:_main
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a5d51591ebf67bc53acb1c8481da364dae742a02
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate-0.8.7.dist-info/top_level.txt
@@ -0,0 +1 @@
+tabulate
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate.py
new file mode 100644
index 0000000000000000000000000000000000000000..e035a8c95a070be9e3e658c4ffe735f63d2aa278
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/tabulate.py
@@ -0,0 +1,1772 @@
+# -*- coding: utf-8 -*-
+
+"""Pretty-print tabular data."""
+
+from __future__ import print_function
+from __future__ import unicode_literals
+from collections import namedtuple
+from platform import python_version_tuple
+import re
+import math
+
+
+if python_version_tuple() >= ("3", "3", "0"):
+    from collections.abc import Iterable
+else:
+    from collections import Iterable
+
+if python_version_tuple()[0] < "3":
+    from itertools import izip_longest
+    from functools import partial
+
+    _none_type = type(None)
+    _bool_type = bool
+    _int_type = int
+    _long_type = long  # noqa
+    _float_type = float
+    _text_type = unicode  # noqa
+    _binary_type = str
+
+    def _is_file(f):
+        return hasattr(f, "read")
+
+
+else:
+    from itertools import zip_longest as izip_longest
+    from functools import reduce, partial
+
+    _none_type = type(None)
+    _bool_type = bool
+    _int_type = int
+    _long_type = int
+    _float_type = float
+    _text_type = str
+    _binary_type = bytes
+    basestring = str
+
+    import io
+
+    def _is_file(f):
+        return isinstance(f, io.IOBase)
+
+
+try:
+    import wcwidth  # optional wide-character (CJK) support
+except ImportError:
+    wcwidth = None
+
+try:
+    from html import escape as htmlescape
+except ImportError:
+    from cgi import escape as htmlescape
+
+
+__all__ = ["tabulate", "tabulate_formats", "simple_separated_format"]
+__version__ = "0.8.7"
+
+
+# minimum extra space in headers
+MIN_PADDING = 2
+
+# Whether or not to preserve leading/trailing whitespace in data.
+PRESERVE_WHITESPACE = False
+
+_DEFAULT_FLOATFMT = "g"
+_DEFAULT_MISSINGVAL = ""
+
+
+# if True, enable wide-character (CJK) support
+WIDE_CHARS_MODE = wcwidth is not None
+
+
+Line = namedtuple("Line", ["begin", "hline", "sep", "end"])
+
+
+DataRow = namedtuple("DataRow", ["begin", "sep", "end"])
+
+
+# A table structure is suppposed to be:
+#
+#     --- lineabove ---------
+#         headerrow
+#     --- linebelowheader ---
+#         datarow
+#     --- linebewteenrows ---
+#     ... (more datarows) ...
+#     --- linebewteenrows ---
+#         last datarow
+#     --- linebelow ---------
+#
+# TableFormat's line* elements can be
+#
+#   - either None, if the element is not used,
+#   - or a Line tuple,
+#   - or a function: [col_widths], [col_alignments] -> string.
+#
+# TableFormat's *row elements can be
+#
+#   - either None, if the element is not used,
+#   - or a DataRow tuple,
+#   - or a function: [cell_values], [col_widths], [col_alignments] -> string.
+#
+# padding (an integer) is the amount of white space around data values.
+#
+# with_header_hide:
+#
+#   - either None, to display all table elements unconditionally,
+#   - or a list of elements not to be displayed if the table has column headers.
+#
+TableFormat = namedtuple(
+    "TableFormat",
+    [
+        "lineabove",
+        "linebelowheader",
+        "linebetweenrows",
+        "linebelow",
+        "headerrow",
+        "datarow",
+        "padding",
+        "with_header_hide",
+    ],
+)
+
+
+def _pipe_segment_with_colons(align, colwidth):
+    """Return a segment of a horizontal line with optional colons which
+    indicate column's alignment (as in `pipe` output format)."""
+    w = colwidth
+    if align in ["right", "decimal"]:
+        return ("-" * (w - 1)) + ":"
+    elif align == "center":
+        return ":" + ("-" * (w - 2)) + ":"
+    elif align == "left":
+        return ":" + ("-" * (w - 1))
+    else:
+        return "-" * w
+
+
+def _pipe_line_with_colons(colwidths, colaligns):
+    """Return a horizontal line with optional colons to indicate column's
+    alignment (as in `pipe` output format)."""
+    if not colaligns:  # e.g. printing an empty data frame (github issue #15)
+        colaligns = [""] * len(colwidths)
+    segments = [_pipe_segment_with_colons(a, w) for a, w in zip(colaligns, colwidths)]
+    return "|" + "|".join(segments) + "|"
+
+
+def _mediawiki_row_with_attrs(separator, cell_values, colwidths, colaligns):
+    alignment = {
+        "left": "",
+        "right": 'align="right"| ',
+        "center": 'align="center"| ',
+        "decimal": 'align="right"| ',
+    }
+    # hard-coded padding _around_ align attribute and value together
+    # rather than padding parameter which affects only the value
+    values_with_attrs = [
+        " " + alignment.get(a, "") + c + " " for c, a in zip(cell_values, colaligns)
+    ]
+    colsep = separator * 2
+    return (separator + colsep.join(values_with_attrs)).rstrip()
+
+
+def _textile_row_with_attrs(cell_values, colwidths, colaligns):
+    cell_values[0] += " "
+    alignment = {"left": "<.", "right": ">.", "center": "=.", "decimal": ">."}
+    values = (alignment.get(a, "") + v for a, v in zip(colaligns, cell_values))
+    return "|" + "|".join(values) + "|"
+
+
+def _html_begin_table_without_header(colwidths_ignore, colaligns_ignore):
+    # this table header will be suppressed if there is a header row
+    return "<table>\n<tbody>"
+
+
+def _html_row_with_attrs(celltag, cell_values, colwidths, colaligns):
+    alignment = {
+        "left": "",
+        "right": ' style="text-align: right;"',
+        "center": ' style="text-align: center;"',
+        "decimal": ' style="text-align: right;"',
+    }
+    values_with_attrs = [
+        "<{0}{1}>{2}</{0}>".format(celltag, alignment.get(a, ""), htmlescape(c))
+        for c, a in zip(cell_values, colaligns)
+    ]
+    rowhtml = "<tr>{}</tr>".format("".join(values_with_attrs).rstrip())
+    if celltag == "th":  # it's a header row, create a new table header
+        rowhtml = "<table>\n<thead>\n{}\n</thead>\n<tbody>".format(rowhtml)
+    return rowhtml
+
+
+def _moin_row_with_attrs(celltag, cell_values, colwidths, colaligns, header=""):
+    alignment = {
+        "left": "",
+        "right": '<style="text-align: right;">',
+        "center": '<style="text-align: center;">',
+        "decimal": '<style="text-align: right;">',
+    }
+    values_with_attrs = [
+        "{0}{1} {2} ".format(celltag, alignment.get(a, ""), header + c + header)
+        for c, a in zip(cell_values, colaligns)
+    ]
+    return "".join(values_with_attrs) + "||"
+
+
+def _latex_line_begin_tabular(colwidths, colaligns, booktabs=False):
+    alignment = {"left": "l", "right": "r", "center": "c", "decimal": "r"}
+    tabular_columns_fmt = "".join([alignment.get(a, "l") for a in colaligns])
+    return "\n".join(
+        [
+            "\\begin{tabular}{" + tabular_columns_fmt + "}",
+            "\\toprule" if booktabs else "\\hline",
+        ]
+    )
+
+
+LATEX_ESCAPE_RULES = {
+    r"&": r"\&",
+    r"%": r"\%",
+    r"$": r"\$",
+    r"#": r"\#",
+    r"_": r"\_",
+    r"^": r"\^{}",
+    r"{": r"\{",
+    r"}": r"\}",
+    r"~": r"\textasciitilde{}",
+    "\\": r"\textbackslash{}",
+    r"<": r"\ensuremath{<}",
+    r">": r"\ensuremath{>}",
+}
+
+
+def _latex_row(cell_values, colwidths, colaligns, escrules=LATEX_ESCAPE_RULES):
+    def escape_char(c):
+        return escrules.get(c, c)
+
+    escaped_values = ["".join(map(escape_char, cell)) for cell in cell_values]
+    rowfmt = DataRow("", "&", "\\\\")
+    return _build_simple_row(escaped_values, rowfmt)
+
+
+def _rst_escape_first_column(rows, headers):
+    def escape_empty(val):
+        if isinstance(val, (_text_type, _binary_type)) and not val.strip():
+            return ".."
+        else:
+            return val
+
+    new_headers = list(headers)
+    new_rows = []
+    if headers:
+        new_headers[0] = escape_empty(headers[0])
+    for row in rows:
+        new_row = list(row)
+        if new_row:
+            new_row[0] = escape_empty(row[0])
+        new_rows.append(new_row)
+    return new_rows, new_headers
+
+
+_table_formats = {
+    "simple": TableFormat(
+        lineabove=Line("", "-", "  ", ""),
+        linebelowheader=Line("", "-", "  ", ""),
+        linebetweenrows=None,
+        linebelow=Line("", "-", "  ", ""),
+        headerrow=DataRow("", "  ", ""),
+        datarow=DataRow("", "  ", ""),
+        padding=0,
+        with_header_hide=["lineabove", "linebelow"],
+    ),
+    "plain": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("", "  ", ""),
+        datarow=DataRow("", "  ", ""),
+        padding=0,
+        with_header_hide=None,
+    ),
+    "grid": TableFormat(
+        lineabove=Line("+", "-", "+", "+"),
+        linebelowheader=Line("+", "=", "+", "+"),
+        linebetweenrows=Line("+", "-", "+", "+"),
+        linebelow=Line("+", "-", "+", "+"),
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "fancy_grid": TableFormat(
+        lineabove=Line("╒", "═", "╤", "╕"),
+        linebelowheader=Line("╞", "═", "╪", "╡"),
+        linebetweenrows=Line("├", "─", "┼", "┤"),
+        linebelow=Line("╘", "═", "╧", "╛"),
+        headerrow=DataRow("│", "│", "│"),
+        datarow=DataRow("│", "│", "│"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "github": TableFormat(
+        lineabove=Line("|", "-", "|", "|"),
+        linebelowheader=Line("|", "-", "|", "|"),
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=["lineabove"],
+    ),
+    "pipe": TableFormat(
+        lineabove=_pipe_line_with_colons,
+        linebelowheader=_pipe_line_with_colons,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=["lineabove"],
+    ),
+    "orgtbl": TableFormat(
+        lineabove=None,
+        linebelowheader=Line("|", "-", "+", "|"),
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "jira": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("||", "||", "||"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "presto": TableFormat(
+        lineabove=None,
+        linebelowheader=Line("", "-", "+", ""),
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("", "|", ""),
+        datarow=DataRow("", "|", ""),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "pretty": TableFormat(
+        lineabove=Line("+", "-", "+", "+"),
+        linebelowheader=Line("+", "-", "+", "+"),
+        linebetweenrows=None,
+        linebelow=Line("+", "-", "+", "+"),
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "psql": TableFormat(
+        lineabove=Line("+", "-", "+", "+"),
+        linebelowheader=Line("|", "-", "+", "|"),
+        linebetweenrows=None,
+        linebelow=Line("+", "-", "+", "+"),
+        headerrow=DataRow("|", "|", "|"),
+        datarow=DataRow("|", "|", "|"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "rst": TableFormat(
+        lineabove=Line("", "=", "  ", ""),
+        linebelowheader=Line("", "=", "  ", ""),
+        linebetweenrows=None,
+        linebelow=Line("", "=", "  ", ""),
+        headerrow=DataRow("", "  ", ""),
+        datarow=DataRow("", "  ", ""),
+        padding=0,
+        with_header_hide=None,
+    ),
+    "mediawiki": TableFormat(
+        lineabove=Line(
+            '{| class="wikitable" style="text-align: left;"',
+            "",
+            "",
+            "\n|+ <!-- caption -->\n|-",
+        ),
+        linebelowheader=Line("|-", "", "", ""),
+        linebetweenrows=Line("|-", "", "", ""),
+        linebelow=Line("|}", "", "", ""),
+        headerrow=partial(_mediawiki_row_with_attrs, "!"),
+        datarow=partial(_mediawiki_row_with_attrs, "|"),
+        padding=0,
+        with_header_hide=None,
+    ),
+    "moinmoin": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=partial(_moin_row_with_attrs, "||", header="'''"),
+        datarow=partial(_moin_row_with_attrs, "||"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "youtrack": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("|| ", " || ", " || "),
+        datarow=DataRow("| ", " | ", " |"),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "html": TableFormat(
+        lineabove=_html_begin_table_without_header,
+        linebelowheader="",
+        linebetweenrows=None,
+        linebelow=Line("</tbody>\n</table>", "", "", ""),
+        headerrow=partial(_html_row_with_attrs, "th"),
+        datarow=partial(_html_row_with_attrs, "td"),
+        padding=0,
+        with_header_hide=["lineabove"],
+    ),
+    "latex": TableFormat(
+        lineabove=_latex_line_begin_tabular,
+        linebelowheader=Line("\\hline", "", "", ""),
+        linebetweenrows=None,
+        linebelow=Line("\\hline\n\\end{tabular}", "", "", ""),
+        headerrow=_latex_row,
+        datarow=_latex_row,
+        padding=1,
+        with_header_hide=None,
+    ),
+    "latex_raw": TableFormat(
+        lineabove=_latex_line_begin_tabular,
+        linebelowheader=Line("\\hline", "", "", ""),
+        linebetweenrows=None,
+        linebelow=Line("\\hline\n\\end{tabular}", "", "", ""),
+        headerrow=partial(_latex_row, escrules={}),
+        datarow=partial(_latex_row, escrules={}),
+        padding=1,
+        with_header_hide=None,
+    ),
+    "latex_booktabs": TableFormat(
+        lineabove=partial(_latex_line_begin_tabular, booktabs=True),
+        linebelowheader=Line("\\midrule", "", "", ""),
+        linebetweenrows=None,
+        linebelow=Line("\\bottomrule\n\\end{tabular}", "", "", ""),
+        headerrow=_latex_row,
+        datarow=_latex_row,
+        padding=1,
+        with_header_hide=None,
+    ),
+    "tsv": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("", "\t", ""),
+        datarow=DataRow("", "\t", ""),
+        padding=0,
+        with_header_hide=None,
+    ),
+    "textile": TableFormat(
+        lineabove=None,
+        linebelowheader=None,
+        linebetweenrows=None,
+        linebelow=None,
+        headerrow=DataRow("|_. ", "|_.", "|"),
+        datarow=_textile_row_with_attrs,
+        padding=1,
+        with_header_hide=None,
+    ),
+}
+
+
+tabulate_formats = list(sorted(_table_formats.keys()))
+
+# The table formats for which multiline cells will be folded into subsequent
+# table rows. The key is the original format specified at the API. The value is
+# the format that will be used to represent the original format.
+multiline_formats = {
+    "plain": "plain",
+    "simple": "simple",
+    "grid": "grid",
+    "fancy_grid": "fancy_grid",
+    "pipe": "pipe",
+    "orgtbl": "orgtbl",
+    "jira": "jira",
+    "presto": "presto",
+    "pretty": "pretty",
+    "psql": "psql",
+    "rst": "rst",
+}
+
+# TODO: Add multiline support for the remaining table formats:
+#       - mediawiki: Replace \n with <br>
+#       - moinmoin: TBD
+#       - youtrack: TBD
+#       - html: Replace \n with <br>
+#       - latex*: Use "makecell" package: In header, replace X\nY with
+#         \thead{X\\Y} and in data row, replace X\nY with \makecell{X\\Y}
+#       - tsv: TBD
+#       - textile: Replace \n with <br/> (must be well-formed XML)
+
+_multiline_codes = re.compile(r"\r|\n|\r\n")
+_multiline_codes_bytes = re.compile(b"\r|\n|\r\n")
+_invisible_codes = re.compile(
+    r"\x1b\[\d+[;\d]*m|\x1b\[\d*\;\d*\;\d*m"
+)  # ANSI color codes
+_invisible_codes_bytes = re.compile(
+    b"\x1b\\[\\d+\\[;\\d]*m|\x1b\\[\\d*;\\d*;\\d*m"
+)  # ANSI color codes
+
+
+def simple_separated_format(separator):
+    """Construct a simple TableFormat with columns separated by a separator.
+
+    >>> tsv = simple_separated_format("\\t") ; \
+        tabulate([["foo", 1], ["spam", 23]], tablefmt=tsv) == 'foo \\t 1\\nspam\\t23'
+    True
+
+    """
+    return TableFormat(
+        None,
+        None,
+        None,
+        None,
+        headerrow=DataRow("", separator, ""),
+        datarow=DataRow("", separator, ""),
+        padding=0,
+        with_header_hide=None,
+    )
+
+
+def _isconvertible(conv, string):
+    try:
+        conv(string)
+        return True
+    except (ValueError, TypeError):
+        return False
+
+
+def _isnumber(string):
+    """
+    >>> _isnumber("123.45")
+    True
+    >>> _isnumber("123")
+    True
+    >>> _isnumber("spam")
+    False
+    >>> _isnumber("123e45678")
+    False
+    >>> _isnumber("inf")
+    True
+    """
+    if not _isconvertible(float, string):
+        return False
+    elif isinstance(string, (_text_type, _binary_type)) and (
+        math.isinf(float(string)) or math.isnan(float(string))
+    ):
+        return string.lower() in ["inf", "-inf", "nan"]
+    return True
+
+
+def _isint(string, inttype=int):
+    """
+    >>> _isint("123")
+    True
+    >>> _isint("123.45")
+    False
+    """
+    return (
+        type(string) is inttype
+        or (isinstance(string, _binary_type) or isinstance(string, _text_type))
+        and _isconvertible(inttype, string)
+    )
+
+
+def _isbool(string):
+    """
+    >>> _isbool(True)
+    True
+    >>> _isbool("False")
+    True
+    >>> _isbool(1)
+    False
+    """
+    return type(string) is _bool_type or (
+        isinstance(string, (_binary_type, _text_type)) and string in ("True", "False")
+    )
+
+
+def _type(string, has_invisible=True, numparse=True):
+    """The least generic type (type(None), int, float, str, unicode).
+
+    >>> _type(None) is type(None)
+    True
+    >>> _type("foo") is type("")
+    True
+    >>> _type("1") is type(1)
+    True
+    >>> _type('\x1b[31m42\x1b[0m') is type(42)
+    True
+    >>> _type('\x1b[31m42\x1b[0m') is type(42)
+    True
+
+    """
+
+    if has_invisible and (
+        isinstance(string, _text_type) or isinstance(string, _binary_type)
+    ):
+        string = _strip_invisible(string)
+
+    if string is None:
+        return _none_type
+    elif hasattr(string, "isoformat"):  # datetime.datetime, date, and time
+        return _text_type
+    elif _isbool(string):
+        return _bool_type
+    elif _isint(string) and numparse:
+        return int
+    elif _isint(string, _long_type) and numparse:
+        return int
+    elif _isnumber(string) and numparse:
+        return float
+    elif isinstance(string, _binary_type):
+        return _binary_type
+    else:
+        return _text_type
+
+
+def _afterpoint(string):
+    """Symbols after a decimal point, -1 if the string lacks the decimal point.
+
+    >>> _afterpoint("123.45")
+    2
+    >>> _afterpoint("1001")
+    -1
+    >>> _afterpoint("eggs")
+    -1
+    >>> _afterpoint("123e45")
+    2
+
+    """
+    if _isnumber(string):
+        if _isint(string):
+            return -1
+        else:
+            pos = string.rfind(".")
+            pos = string.lower().rfind("e") if pos < 0 else pos
+            if pos >= 0:
+                return len(string) - pos - 1
+            else:
+                return -1  # no point
+    else:
+        return -1  # not a number
+
+
+def _padleft(width, s):
+    """Flush right.
+
+    >>> _padleft(6, '\u044f\u0439\u0446\u0430') == '  \u044f\u0439\u0446\u0430'
+    True
+
+    """
+    fmt = "{0:>%ds}" % width
+    return fmt.format(s)
+
+
+def _padright(width, s):
+    """Flush left.
+
+    >>> _padright(6, '\u044f\u0439\u0446\u0430') == '\u044f\u0439\u0446\u0430  '
+    True
+
+    """
+    fmt = "{0:<%ds}" % width
+    return fmt.format(s)
+
+
+def _padboth(width, s):
+    """Center string.
+
+    >>> _padboth(6, '\u044f\u0439\u0446\u0430') == ' \u044f\u0439\u0446\u0430 '
+    True
+
+    """
+    fmt = "{0:^%ds}" % width
+    return fmt.format(s)
+
+
+def _padnone(ignore_width, s):
+    return s
+
+
+def _strip_invisible(s):
+    "Remove invisible ANSI color codes."
+    if isinstance(s, _text_type):
+        return re.sub(_invisible_codes, "", s)
+    else:  # a bytestring
+        return re.sub(_invisible_codes_bytes, "", s)
+
+
+def _visible_width(s):
+    """Visible width of a printed string. ANSI color codes are removed.
+
+    >>> _visible_width('\x1b[31mhello\x1b[0m'), _visible_width("world")
+    (5, 5)
+
+    """
+    # optional wide-character support
+    if wcwidth is not None and WIDE_CHARS_MODE:
+        len_fn = wcwidth.wcswidth
+    else:
+        len_fn = len
+    if isinstance(s, _text_type) or isinstance(s, _binary_type):
+        return len_fn(_strip_invisible(s))
+    else:
+        return len_fn(_text_type(s))
+
+
+def _is_multiline(s):
+    if isinstance(s, _text_type):
+        return bool(re.search(_multiline_codes, s))
+    else:  # a bytestring
+        return bool(re.search(_multiline_codes_bytes, s))
+
+
+def _multiline_width(multiline_s, line_width_fn=len):
+    """Visible width of a potentially multiline content."""
+    return max(map(line_width_fn, re.split("[\r\n]", multiline_s)))
+
+
+def _choose_width_fn(has_invisible, enable_widechars, is_multiline):
+    """Return a function to calculate visible cell width."""
+    if has_invisible:
+        line_width_fn = _visible_width
+    elif enable_widechars:  # optional wide-character support if available
+        line_width_fn = wcwidth.wcswidth
+    else:
+        line_width_fn = len
+    if is_multiline:
+        width_fn = lambda s: _multiline_width(s, line_width_fn)  # noqa
+    else:
+        width_fn = line_width_fn
+    return width_fn
+
+
+def _align_column_choose_padfn(strings, alignment, has_invisible):
+    if alignment == "right":
+        if not PRESERVE_WHITESPACE:
+            strings = [s.strip() for s in strings]
+        padfn = _padleft
+    elif alignment == "center":
+        if not PRESERVE_WHITESPACE:
+            strings = [s.strip() for s in strings]
+        padfn = _padboth
+    elif alignment == "decimal":
+        if has_invisible:
+            decimals = [_afterpoint(_strip_invisible(s)) for s in strings]
+        else:
+            decimals = [_afterpoint(s) for s in strings]
+        maxdecimals = max(decimals)
+        strings = [s + (maxdecimals - decs) * " " for s, decs in zip(strings, decimals)]
+        padfn = _padleft
+    elif not alignment:
+        padfn = _padnone
+    else:
+        if not PRESERVE_WHITESPACE:
+            strings = [s.strip() for s in strings]
+        padfn = _padright
+    return strings, padfn
+
+
+def _align_column(
+    strings,
+    alignment,
+    minwidth=0,
+    has_invisible=True,
+    enable_widechars=False,
+    is_multiline=False,
+):
+    """[string] -> [padded_string]"""
+    strings, padfn = _align_column_choose_padfn(strings, alignment, has_invisible)
+    width_fn = _choose_width_fn(has_invisible, enable_widechars, is_multiline)
+
+    s_widths = list(map(width_fn, strings))
+    maxwidth = max(max(s_widths), minwidth)
+    # TODO: refactor column alignment in single-line and multiline modes
+    if is_multiline:
+        if not enable_widechars and not has_invisible:
+            padded_strings = [
+                "\n".join([padfn(maxwidth, s) for s in ms.splitlines()])
+                for ms in strings
+            ]
+        else:
+            # enable wide-character width corrections
+            s_lens = [max((len(s) for s in re.split("[\r\n]", ms))) for ms in strings]
+            visible_widths = [maxwidth - (w - l) for w, l in zip(s_widths, s_lens)]
+            # wcswidth and _visible_width don't count invisible characters;
+            # padfn doesn't need to apply another correction
+            padded_strings = [
+                "\n".join([padfn(w, s) for s in (ms.splitlines() or ms)])
+                for ms, w in zip(strings, visible_widths)
+            ]
+    else:  # single-line cell values
+        if not enable_widechars and not has_invisible:
+            padded_strings = [padfn(maxwidth, s) for s in strings]
+        else:
+            # enable wide-character width corrections
+            s_lens = list(map(len, strings))
+            visible_widths = [maxwidth - (w - l) for w, l in zip(s_widths, s_lens)]
+            # wcswidth and _visible_width don't count invisible characters;
+            # padfn doesn't need to apply another correction
+            padded_strings = [padfn(w, s) for s, w in zip(strings, visible_widths)]
+    return padded_strings
+
+
+def _more_generic(type1, type2):
+    types = {
+        _none_type: 0,
+        _bool_type: 1,
+        int: 2,
+        float: 3,
+        _binary_type: 4,
+        _text_type: 5,
+    }
+    invtypes = {
+        5: _text_type,
+        4: _binary_type,
+        3: float,
+        2: int,
+        1: _bool_type,
+        0: _none_type,
+    }
+    moregeneric = max(types.get(type1, 5), types.get(type2, 5))
+    return invtypes[moregeneric]
+
+
+def _column_type(strings, has_invisible=True, numparse=True):
+    """The least generic type all column values are convertible to.
+
+    >>> _column_type([True, False]) is _bool_type
+    True
+    >>> _column_type(["1", "2"]) is _int_type
+    True
+    >>> _column_type(["1", "2.3"]) is _float_type
+    True
+    >>> _column_type(["1", "2.3", "four"]) is _text_type
+    True
+    >>> _column_type(["four", '\u043f\u044f\u0442\u044c']) is _text_type
+    True
+    >>> _column_type([None, "brux"]) is _text_type
+    True
+    >>> _column_type([1, 2, None]) is _int_type
+    True
+    >>> import datetime as dt
+    >>> _column_type([dt.datetime(1991,2,19), dt.time(17,35)]) is _text_type
+    True
+
+    """
+    types = [_type(s, has_invisible, numparse) for s in strings]
+    return reduce(_more_generic, types, _bool_type)
+
+
+def _format(val, valtype, floatfmt, missingval="", has_invisible=True):
+    """Format a value accoding to its type.
+
+    Unicode is supported:
+
+    >>> hrow = ['\u0431\u0443\u043a\u0432\u0430', '\u0446\u0438\u0444\u0440\u0430'] ; \
+        tbl = [['\u0430\u0437', 2], ['\u0431\u0443\u043a\u0438', 4]] ; \
+        good_result = '\\u0431\\u0443\\u043a\\u0432\\u0430      \\u0446\\u0438\\u0444\\u0440\\u0430\\n-------  -------\\n\\u0430\\u0437             2\\n\\u0431\\u0443\\u043a\\u0438           4' ; \
+        tabulate(tbl, headers=hrow) == good_result
+    True
+
+    """  # noqa
+    if val is None:
+        return missingval
+
+    if valtype in [int, _text_type]:
+        return "{0}".format(val)
+    elif valtype is _binary_type:
+        try:
+            return _text_type(val, "ascii")
+        except TypeError:
+            return _text_type(val)
+    elif valtype is float:
+        is_a_colored_number = has_invisible and isinstance(
+            val, (_text_type, _binary_type)
+        )
+        if is_a_colored_number:
+            raw_val = _strip_invisible(val)
+            formatted_val = format(float(raw_val), floatfmt)
+            return val.replace(raw_val, formatted_val)
+        else:
+            return format(float(val), floatfmt)
+    else:
+        return "{0}".format(val)
+
+
+def _align_header(
+    header, alignment, width, visible_width, is_multiline=False, width_fn=None
+):
+    "Pad string header to width chars given known visible_width of the header."
+    if is_multiline:
+        header_lines = re.split(_multiline_codes, header)
+        padded_lines = [
+            _align_header(h, alignment, width, width_fn(h)) for h in header_lines
+        ]
+        return "\n".join(padded_lines)
+    # else: not multiline
+    ninvisible = len(header) - visible_width
+    width += ninvisible
+    if alignment == "left":
+        return _padright(width, header)
+    elif alignment == "center":
+        return _padboth(width, header)
+    elif not alignment:
+        return "{0}".format(header)
+    else:
+        return _padleft(width, header)
+
+
+def _prepend_row_index(rows, index):
+    """Add a left-most index column."""
+    if index is None or index is False:
+        return rows
+    if len(index) != len(rows):
+        print("index=", index)
+        print("rows=", rows)
+        raise ValueError("index must be as long as the number of data rows")
+    rows = [[v] + list(row) for v, row in zip(index, rows)]
+    return rows
+
+
+def _bool(val):
+    "A wrapper around standard bool() which doesn't throw on NumPy arrays"
+    try:
+        return bool(val)
+    except ValueError:  # val is likely to be a numpy array with many elements
+        return False
+
+
+def _normalize_tabular_data(tabular_data, headers, showindex="default"):
+    """Transform a supported data type to a list of lists, and a list of headers.
+
+    Supported tabular data types:
+
+    * list-of-lists or another iterable of iterables
+
+    * list of named tuples (usually used with headers="keys")
+
+    * list of dicts (usually used with headers="keys")
+
+    * list of OrderedDicts (usually used with headers="keys")
+
+    * 2D NumPy arrays
+
+    * NumPy record arrays (usually used with headers="keys")
+
+    * dict of iterables (usually used with headers="keys")
+
+    * pandas.DataFrame (usually used with headers="keys")
+
+    The first row can be used as headers if headers="firstrow",
+    column indices can be used as headers if headers="keys".
+
+    If showindex="default", show row indices of the pandas.DataFrame.
+    If showindex="always", show row indices for all types of data.
+    If showindex="never", don't show row indices for all types of data.
+    If showindex is an iterable, show its values as row indices.
+
+    """
+
+    try:
+        bool(headers)
+        is_headers2bool_broken = False  # noqa
+    except ValueError:  # numpy.ndarray, pandas.core.index.Index, ...
+        is_headers2bool_broken = True  # noqa
+        headers = list(headers)
+
+    index = None
+    if hasattr(tabular_data, "keys") and hasattr(tabular_data, "values"):
+        # dict-like and pandas.DataFrame?
+        if hasattr(tabular_data.values, "__call__"):
+            # likely a conventional dict
+            keys = tabular_data.keys()
+            rows = list(
+                izip_longest(*tabular_data.values())
+            )  # columns have to be transposed
+        elif hasattr(tabular_data, "index"):
+            # values is a property, has .index => it's likely a pandas.DataFrame (pandas 0.11.0)
+            keys = list(tabular_data)
+            if tabular_data.index.name is not None:
+                if isinstance(tabular_data.index.name, list):
+                    keys[:0] = tabular_data.index.name
+                else:
+                    keys[:0] = [tabular_data.index.name]
+            vals = tabular_data.values  # values matrix doesn't need to be transposed
+            # for DataFrames add an index per default
+            index = list(tabular_data.index)
+            rows = [list(row) for row in vals]
+        else:
+            raise ValueError("tabular data doesn't appear to be a dict or a DataFrame")
+
+        if headers == "keys":
+            headers = list(map(_text_type, keys))  # headers should be strings
+
+    else:  # it's a usual an iterable of iterables, or a NumPy array
+        rows = list(tabular_data)
+
+        if headers == "keys" and not rows:
+            # an empty table (issue #81)
+            headers = []
+        elif (
+            headers == "keys"
+            and hasattr(tabular_data, "dtype")
+            and getattr(tabular_data.dtype, "names")
+        ):
+            # numpy record array
+            headers = tabular_data.dtype.names
+        elif (
+            headers == "keys"
+            and len(rows) > 0
+            and isinstance(rows[0], tuple)
+            and hasattr(rows[0], "_fields")
+        ):
+            # namedtuple
+            headers = list(map(_text_type, rows[0]._fields))
+        elif len(rows) > 0 and isinstance(rows[0], dict):
+            # dict or OrderedDict
+            uniq_keys = set()  # implements hashed lookup
+            keys = []  # storage for set
+            if headers == "firstrow":
+                firstdict = rows[0] if len(rows) > 0 else {}
+                keys.extend(firstdict.keys())
+                uniq_keys.update(keys)
+                rows = rows[1:]
+            for row in rows:
+                for k in row.keys():
+                    # Save unique items in input order
+                    if k not in uniq_keys:
+                        keys.append(k)
+                        uniq_keys.add(k)
+            if headers == "keys":
+                headers = keys
+            elif isinstance(headers, dict):
+                # a dict of headers for a list of dicts
+                headers = [headers.get(k, k) for k in keys]
+                headers = list(map(_text_type, headers))
+            elif headers == "firstrow":
+                if len(rows) > 0:
+                    headers = [firstdict.get(k, k) for k in keys]
+                    headers = list(map(_text_type, headers))
+                else:
+                    headers = []
+            elif headers:
+                raise ValueError(
+                    "headers for a list of dicts is not a dict or a keyword"
+                )
+            rows = [[row.get(k) for k in keys] for row in rows]
+
+        elif (
+            headers == "keys"
+            and hasattr(tabular_data, "description")
+            and hasattr(tabular_data, "fetchone")
+            and hasattr(tabular_data, "rowcount")
+        ):
+            # Python Database API cursor object (PEP 0249)
+            # print tabulate(cursor, headers='keys')
+            headers = [column[0] for column in tabular_data.description]
+
+        elif headers == "keys" and len(rows) > 0:
+            # keys are column indices
+            headers = list(map(_text_type, range(len(rows[0]))))
+
+    # take headers from the first row if necessary
+    if headers == "firstrow" and len(rows) > 0:
+        if index is not None:
+            headers = [index[0]] + list(rows[0])
+            index = index[1:]
+        else:
+            headers = rows[0]
+        headers = list(map(_text_type, headers))  # headers should be strings
+        rows = rows[1:]
+
+    headers = list(map(_text_type, headers))
+    rows = list(map(list, rows))
+
+    # add or remove an index column
+    showindex_is_a_str = type(showindex) in [_text_type, _binary_type]
+    if showindex == "default" and index is not None:
+        rows = _prepend_row_index(rows, index)
+    elif isinstance(showindex, Iterable) and not showindex_is_a_str:
+        rows = _prepend_row_index(rows, list(showindex))
+    elif showindex == "always" or (_bool(showindex) and not showindex_is_a_str):
+        if index is None:
+            index = list(range(len(rows)))
+        rows = _prepend_row_index(rows, index)
+    elif showindex == "never" or (not _bool(showindex) and not showindex_is_a_str):
+        pass
+
+    # pad with empty headers for initial columns if necessary
+    if headers and len(rows) > 0:
+        nhs = len(headers)
+        ncols = len(rows[0])
+        if nhs < ncols:
+            headers = [""] * (ncols - nhs) + headers
+
+    return rows, headers
+
+
+def tabulate(
+    tabular_data,
+    headers=(),
+    tablefmt="simple",
+    floatfmt=_DEFAULT_FLOATFMT,
+    numalign="decimal",
+    stralign="left",
+    missingval=_DEFAULT_MISSINGVAL,
+    showindex="default",
+    disable_numparse=False,
+    colalign=None,
+):
+    """Format a fixed width table for pretty printing.
+
+    >>> print(tabulate([[1, 2.34], [-56, "8.999"], ["2", "10001"]]))
+    ---  ---------
+      1      2.34
+    -56      8.999
+      2  10001
+    ---  ---------
+
+    The first required argument (`tabular_data`) can be a
+    list-of-lists (or another iterable of iterables), a list of named
+    tuples, a dictionary of iterables, an iterable of dictionaries,
+    a two-dimensional NumPy array, NumPy record array, or a Pandas'
+    dataframe.
+
+
+    Table headers
+    -------------
+
+    To print nice column headers, supply the second argument (`headers`):
+
+      - `headers` can be an explicit list of column headers
+      - if `headers="firstrow"`, then the first row of data is used
+      - if `headers="keys"`, then dictionary keys or column indices are used
+
+    Otherwise a headerless table is produced.
+
+    If the number of headers is less than the number of columns, they
+    are supposed to be names of the last columns. This is consistent
+    with the plain-text format of R and Pandas' dataframes.
+
+    >>> print(tabulate([["sex","age"],["Alice","F",24],["Bob","M",19]],
+    ...       headers="firstrow"))
+           sex      age
+    -----  -----  -----
+    Alice  F         24
+    Bob    M         19
+
+    By default, pandas.DataFrame data have an additional column called
+    row index. To add a similar column to all other types of data,
+    use `showindex="always"` or `showindex=True`. To suppress row indices
+    for all types of data, pass `showindex="never" or `showindex=False`.
+    To add a custom row index column, pass `showindex=some_iterable`.
+
+    >>> print(tabulate([["F",24],["M",19]], showindex="always"))
+    -  -  --
+    0  F  24
+    1  M  19
+    -  -  --
+
+
+    Column alignment
+    ----------------
+
+    `tabulate` tries to detect column types automatically, and aligns
+    the values properly. By default it aligns decimal points of the
+    numbers (or flushes integer numbers to the right), and flushes
+    everything else to the left. Possible column alignments
+    (`numalign`, `stralign`) are: "right", "center", "left", "decimal"
+    (only for `numalign`), and None (to disable alignment).
+
+
+    Table formats
+    -------------
+
+    `floatfmt` is a format specification used for columns which
+    contain numeric data with a decimal point. This can also be
+    a list or tuple of format strings, one per column.
+
+    `None` values are replaced with a `missingval` string (like
+    `floatfmt`, this can also be a list of values for different
+    columns):
+
+    >>> print(tabulate([["spam", 1, None],
+    ...                 ["eggs", 42, 3.14],
+    ...                 ["other", None, 2.7]], missingval="?"))
+    -----  --  ----
+    spam    1  ?
+    eggs   42  3.14
+    other   ?  2.7
+    -----  --  ----
+
+    Various plain-text table formats (`tablefmt`) are supported:
+    'plain', 'simple', 'grid', 'pipe', 'orgtbl', 'rst', 'mediawiki',
+    'latex', 'latex_raw' and 'latex_booktabs'. Variable `tabulate_formats`
+    contains the list of currently supported formats.
+
+    "plain" format doesn't use any pseudographics to draw tables,
+    it separates columns with a double space:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                 ["strings", "numbers"], "plain"))
+    strings      numbers
+    spam         41.9999
+    eggs        451
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="plain"))
+    spam   41.9999
+    eggs  451
+
+    "simple" format is like Pandoc simple_tables:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                 ["strings", "numbers"], "simple"))
+    strings      numbers
+    ---------  ---------
+    spam         41.9999
+    eggs        451
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="simple"))
+    ----  --------
+    spam   41.9999
+    eggs  451
+    ----  --------
+
+    "grid" is similar to tables produced by Emacs table.el package or
+    Pandoc grid_tables:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "grid"))
+    +-----------+-----------+
+    | strings   |   numbers |
+    +===========+===========+
+    | spam      |   41.9999 |
+    +-----------+-----------+
+    | eggs      |  451      |
+    +-----------+-----------+
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="grid"))
+    +------+----------+
+    | spam |  41.9999 |
+    +------+----------+
+    | eggs | 451      |
+    +------+----------+
+
+    "fancy_grid" draws a grid using box-drawing characters:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "fancy_grid"))
+    ╒═══════════╤═══════════╕
+    │ strings   │   numbers │
+    ╞═══════════╪═══════════╡
+    │ spam      │   41.9999 │
+    ├───────────┼───────────┤
+    │ eggs      │  451      │
+    ╘═══════════╧═══════════╛
+
+    "pipe" is like tables in PHP Markdown Extra extension or Pandoc
+    pipe_tables:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "pipe"))
+    | strings   |   numbers |
+    |:----------|----------:|
+    | spam      |   41.9999 |
+    | eggs      |  451      |
+
+    "presto" is like tables produce by the Presto CLI:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "presto"))
+     strings   |   numbers
+    -----------+-----------
+     spam      |   41.9999
+     eggs      |  451
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="pipe"))
+    |:-----|---------:|
+    | spam |  41.9999 |
+    | eggs | 451      |
+
+    "orgtbl" is like tables in Emacs org-mode and orgtbl-mode. They
+    are slightly different from "pipe" format by not using colons to
+    define column alignment, and using a "+" sign to indicate line
+    intersections:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "orgtbl"))
+    | strings   |   numbers |
+    |-----------+-----------|
+    | spam      |   41.9999 |
+    | eggs      |  451      |
+
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="orgtbl"))
+    | spam |  41.9999 |
+    | eggs | 451      |
+
+    "rst" is like a simple table format from reStructuredText; please
+    note that reStructuredText accepts also "grid" tables:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]],
+    ...                ["strings", "numbers"], "rst"))
+    =========  =========
+    strings      numbers
+    =========  =========
+    spam         41.9999
+    eggs        451
+    =========  =========
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="rst"))
+    ====  ========
+    spam   41.9999
+    eggs  451
+    ====  ========
+
+    "mediawiki" produces a table markup used in Wikipedia and on other
+    MediaWiki-based sites:
+
+    >>> print(tabulate([["strings", "numbers"], ["spam", 41.9999], ["eggs", "451.0"]],
+    ...                headers="firstrow", tablefmt="mediawiki"))
+    {| class="wikitable" style="text-align: left;"
+    |+ <!-- caption -->
+    |-
+    ! strings   !! align="right"|   numbers
+    |-
+    | spam      || align="right"|   41.9999
+    |-
+    | eggs      || align="right"|  451
+    |}
+
+    "html" produces HTML markup as an html.escape'd str
+    with a ._repr_html_ method so that Jupyter Lab and Notebook display the HTML
+    and a .str property so that the raw HTML remains accessible:
+
+    >>> print(tabulate([["strings", "numbers"], ["spam", 41.9999], ["eggs", "451.0"]],
+    ...                headers="firstrow", tablefmt="html"))
+    <table>
+    <thead>
+    <tr><th>strings  </th><th style="text-align: right;">  numbers</th></tr>
+    </thead>
+    <tbody>
+    <tr><td>spam     </td><td style="text-align: right;">  41.9999</td></tr>
+    <tr><td>eggs     </td><td style="text-align: right;"> 451     </td></tr>
+    </tbody>
+    </table>
+
+    "latex" produces a tabular environment of LaTeX document markup:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="latex"))
+    \\begin{tabular}{lr}
+    \\hline
+     spam &  41.9999 \\\\
+     eggs & 451      \\\\
+    \\hline
+    \\end{tabular}
+
+    "latex_raw" is similar to "latex", but doesn't escape special characters,
+    such as backslash and underscore, so LaTeX commands may embedded into
+    cells' values:
+
+    >>> print(tabulate([["spam$_9$", 41.9999], ["\\\\emph{eggs}", "451.0"]], tablefmt="latex_raw"))
+    \\begin{tabular}{lr}
+    \\hline
+     spam$_9$    &  41.9999 \\\\
+     \\emph{eggs} & 451      \\\\
+    \\hline
+    \\end{tabular}
+
+    "latex_booktabs" produces a tabular environment of LaTeX document markup
+    using the booktabs.sty package:
+
+    >>> print(tabulate([["spam", 41.9999], ["eggs", "451.0"]], tablefmt="latex_booktabs"))
+    \\begin{tabular}{lr}
+    \\toprule
+     spam &  41.9999 \\\\
+     eggs & 451      \\\\
+    \\bottomrule
+    \\end{tabular}
+
+    Number parsing
+    --------------
+    By default, anything which can be parsed as a number is a number.
+    This ensures numbers represented as strings are aligned properly.
+    This can lead to weird results for particular strings such as
+    specific git SHAs e.g. "42992e1" will be parsed into the number
+    429920 and aligned as such.
+
+    To completely disable number parsing (and alignment), use
+    `disable_numparse=True`. For more fine grained control, a list column
+    indices is used to disable number parsing only on those columns
+    e.g. `disable_numparse=[0, 2]` would disable number parsing only on the
+    first and third columns.
+    """
+    if tabular_data is None:
+        tabular_data = []
+    list_of_lists, headers = _normalize_tabular_data(
+        tabular_data, headers, showindex=showindex
+    )
+
+    # empty values in the first column of RST tables should be escaped (issue #82)
+    # "" should be escaped as "\\ " or ".."
+    if tablefmt == "rst":
+        list_of_lists, headers = _rst_escape_first_column(list_of_lists, headers)
+
+    # PrettyTable formatting does not use any extra padding.
+    # Numbers are not parsed and are treated the same as strings for alignment.
+    # Check if pretty is the format being used and override the defaults so it
+    # does not impact other formats.
+    min_padding = MIN_PADDING
+    if tablefmt == "pretty":
+        min_padding = 0
+        disable_numparse = True
+        numalign = "center"
+        stralign = "center"
+
+    # optimization: look for ANSI control codes once,
+    # enable smart width functions only if a control code is found
+    plain_text = "\t".join(
+        ["\t".join(map(_text_type, headers))]
+        + ["\t".join(map(_text_type, row)) for row in list_of_lists]
+    )
+
+    has_invisible = re.search(_invisible_codes, plain_text)
+    enable_widechars = wcwidth is not None and WIDE_CHARS_MODE
+    if (
+        not isinstance(tablefmt, TableFormat)
+        and tablefmt in multiline_formats
+        and _is_multiline(plain_text)
+    ):
+        tablefmt = multiline_formats.get(tablefmt, tablefmt)
+        is_multiline = True
+    else:
+        is_multiline = False
+    width_fn = _choose_width_fn(has_invisible, enable_widechars, is_multiline)
+
+    # format rows and columns, convert numeric values to strings
+    cols = list(izip_longest(*list_of_lists))
+    numparses = _expand_numparse(disable_numparse, len(cols))
+    coltypes = [_column_type(col, numparse=np) for col, np in zip(cols, numparses)]
+    if isinstance(floatfmt, basestring):  # old version
+        float_formats = len(cols) * [
+            floatfmt
+        ]  # just duplicate the string to use in each column
+    else:  # if floatfmt is list, tuple etc we have one per column
+        float_formats = list(floatfmt)
+        if len(float_formats) < len(cols):
+            float_formats.extend((len(cols) - len(float_formats)) * [_DEFAULT_FLOATFMT])
+    if isinstance(missingval, basestring):
+        missing_vals = len(cols) * [missingval]
+    else:
+        missing_vals = list(missingval)
+        if len(missing_vals) < len(cols):
+            missing_vals.extend((len(cols) - len(missing_vals)) * [_DEFAULT_MISSINGVAL])
+    cols = [
+        [_format(v, ct, fl_fmt, miss_v, has_invisible) for v in c]
+        for c, ct, fl_fmt, miss_v in zip(cols, coltypes, float_formats, missing_vals)
+    ]
+
+    # align columns
+    aligns = [numalign if ct in [int, float] else stralign for ct in coltypes]
+    if colalign is not None:
+        assert isinstance(colalign, Iterable)
+        for idx, align in enumerate(colalign):
+            aligns[idx] = align
+    minwidths = (
+        [width_fn(h) + min_padding for h in headers] if headers else [0] * len(cols)
+    )
+    cols = [
+        _align_column(c, a, minw, has_invisible, enable_widechars, is_multiline)
+        for c, a, minw in zip(cols, aligns, minwidths)
+    ]
+
+    if headers:
+        # align headers and add headers
+        t_cols = cols or [[""]] * len(headers)
+        t_aligns = aligns or [stralign] * len(headers)
+        minwidths = [
+            max(minw, max(width_fn(cl) for cl in c))
+            for minw, c in zip(minwidths, t_cols)
+        ]
+        headers = [
+            _align_header(h, a, minw, width_fn(h), is_multiline, width_fn)
+            for h, a, minw in zip(headers, t_aligns, minwidths)
+        ]
+        rows = list(zip(*cols))
+    else:
+        minwidths = [max(width_fn(cl) for cl in c) for c in cols]
+        rows = list(zip(*cols))
+
+    if not isinstance(tablefmt, TableFormat):
+        tablefmt = _table_formats.get(tablefmt, _table_formats["simple"])
+
+    return _format_table(tablefmt, headers, rows, minwidths, aligns, is_multiline)
+
+
+def _expand_numparse(disable_numparse, column_count):
+    """
+    Return a list of bools of length `column_count` which indicates whether
+    number parsing should be used on each column.
+    If `disable_numparse` is a list of indices, each of those indices are False,
+    and everything else is True.
+    If `disable_numparse` is a bool, then the returned list is all the same.
+    """
+    if isinstance(disable_numparse, Iterable):
+        numparses = [True] * column_count
+        for index in disable_numparse:
+            numparses[index] = False
+        return numparses
+    else:
+        return [not disable_numparse] * column_count
+
+
+def _pad_row(cells, padding):
+    if cells:
+        pad = " " * padding
+        padded_cells = [pad + cell + pad for cell in cells]
+        return padded_cells
+    else:
+        return cells
+
+
+def _build_simple_row(padded_cells, rowfmt):
+    "Format row according to DataRow format without padding."
+    begin, sep, end = rowfmt
+    return (begin + sep.join(padded_cells) + end).rstrip()
+
+
+def _build_row(padded_cells, colwidths, colaligns, rowfmt):
+    "Return a string which represents a row of data cells."
+    if not rowfmt:
+        return None
+    if hasattr(rowfmt, "__call__"):
+        return rowfmt(padded_cells, colwidths, colaligns)
+    else:
+        return _build_simple_row(padded_cells, rowfmt)
+
+
+def _append_basic_row(lines, padded_cells, colwidths, colaligns, rowfmt):
+    lines.append(_build_row(padded_cells, colwidths, colaligns, rowfmt))
+    return lines
+
+
+def _append_multiline_row(
+    lines, padded_multiline_cells, padded_widths, colaligns, rowfmt, pad
+):
+    colwidths = [w - 2 * pad for w in padded_widths]
+    cells_lines = [c.splitlines() for c in padded_multiline_cells]
+    nlines = max(map(len, cells_lines))  # number of lines in the row
+    # vertically pad cells where some lines are missing
+    cells_lines = [
+        (cl + [" " * w] * (nlines - len(cl))) for cl, w in zip(cells_lines, colwidths)
+    ]
+    lines_cells = [[cl[i] for cl in cells_lines] for i in range(nlines)]
+    for ln in lines_cells:
+        padded_ln = _pad_row(ln, pad)
+        _append_basic_row(lines, padded_ln, colwidths, colaligns, rowfmt)
+    return lines
+
+
+def _build_line(colwidths, colaligns, linefmt):
+    "Return a string which represents a horizontal line."
+    if not linefmt:
+        return None
+    if hasattr(linefmt, "__call__"):
+        return linefmt(colwidths, colaligns)
+    else:
+        begin, fill, sep, end = linefmt
+        cells = [fill * w for w in colwidths]
+        return _build_simple_row(cells, (begin, sep, end))
+
+
+def _append_line(lines, colwidths, colaligns, linefmt):
+    lines.append(_build_line(colwidths, colaligns, linefmt))
+    return lines
+
+
+class JupyterHTMLStr(str):
+    """Wrap the string with a _repr_html_ method so that Jupyter
+    displays the HTML table"""
+
+    def _repr_html_(self):
+        return self
+
+    @property
+    def str(self):
+        """add a .str property so that the raw string is still accessible"""
+        return self
+
+
+def _format_table(fmt, headers, rows, colwidths, colaligns, is_multiline):
+    """Produce a plain-text representation of the table."""
+    lines = []
+    hidden = fmt.with_header_hide if (headers and fmt.with_header_hide) else []
+    pad = fmt.padding
+    headerrow = fmt.headerrow
+
+    padded_widths = [(w + 2 * pad) for w in colwidths]
+    if is_multiline:
+        pad_row = lambda row, _: row  # noqa do it later, in _append_multiline_row
+        append_row = partial(_append_multiline_row, pad=pad)
+    else:
+        pad_row = _pad_row
+        append_row = _append_basic_row
+
+    padded_headers = pad_row(headers, pad)
+    padded_rows = [pad_row(row, pad) for row in rows]
+
+    if fmt.lineabove and "lineabove" not in hidden:
+        _append_line(lines, padded_widths, colaligns, fmt.lineabove)
+
+    if padded_headers:
+        append_row(lines, padded_headers, padded_widths, colaligns, headerrow)
+        if fmt.linebelowheader and "linebelowheader" not in hidden:
+            _append_line(lines, padded_widths, colaligns, fmt.linebelowheader)
+
+    if padded_rows and fmt.linebetweenrows and "linebetweenrows" not in hidden:
+        # initial rows with a line below
+        for row in padded_rows[:-1]:
+            append_row(lines, row, padded_widths, colaligns, fmt.datarow)
+            _append_line(lines, padded_widths, colaligns, fmt.linebetweenrows)
+        # the last row without a line below
+        append_row(lines, padded_rows[-1], padded_widths, colaligns, fmt.datarow)
+    else:
+        for row in padded_rows:
+            append_row(lines, row, padded_widths, colaligns, fmt.datarow)
+
+    if fmt.linebelow and "linebelow" not in hidden:
+        _append_line(lines, padded_widths, colaligns, fmt.linebelow)
+
+    if headers or rows:
+        output = "\n".join(lines)
+        if fmt.lineabove == _html_begin_table_without_header:
+            return JupyterHTMLStr(output)
+        else:
+            return output
+    else:  # a completely empty table
+        return ""
+
+
+def _main():
+    """\
+    Usage: tabulate [options] [FILE ...]
+
+    Pretty-print tabular data.
+    See also https://github.com/astanin/python-tabulate
+
+    FILE                      a filename of the file with tabular data;
+                              if "-" or missing, read data from stdin.
+
+    Options:
+
+    -h, --help                show this message
+    -1, --header              use the first row of data as a table header
+    -o FILE, --output FILE    print table to FILE (default: stdout)
+    -s REGEXP, --sep REGEXP   use a custom column separator (default: whitespace)
+    -F FPFMT, --float FPFMT   floating point number format (default: g)
+    -f FMT, --format FMT      set output table format; supported formats:
+                              plain, simple, grid, fancy_grid, pipe, orgtbl,
+                              rst, mediawiki, html, latex, latex_raw,
+                              latex_booktabs, tsv
+                              (default: simple)
+    """
+    import getopt
+    import sys
+    import textwrap
+
+    usage = textwrap.dedent(_main.__doc__)
+    try:
+        opts, args = getopt.getopt(
+            sys.argv[1:],
+            "h1o:s:F:A:f:",
+            ["help", "header", "output", "sep=", "float=", "align=", "format="],
+        )
+    except getopt.GetoptError as e:
+        print(e)
+        print(usage)
+        sys.exit(2)
+    headers = []
+    floatfmt = _DEFAULT_FLOATFMT
+    colalign = None
+    tablefmt = "simple"
+    sep = r"\s+"
+    outfile = "-"
+    for opt, value in opts:
+        if opt in ["-1", "--header"]:
+            headers = "firstrow"
+        elif opt in ["-o", "--output"]:
+            outfile = value
+        elif opt in ["-F", "--float"]:
+            floatfmt = value
+        elif opt in ["-C", "--colalign"]:
+            colalign = value.split()
+        elif opt in ["-f", "--format"]:
+            if value not in tabulate_formats:
+                print("%s is not a supported table format" % value)
+                print(usage)
+                sys.exit(3)
+            tablefmt = value
+        elif opt in ["-s", "--sep"]:
+            sep = value
+        elif opt in ["-h", "--help"]:
+            print(usage)
+            sys.exit(0)
+    files = [sys.stdin] if not args else args
+    with (sys.stdout if outfile == "-" else open(outfile, "w")) as out:
+        for f in files:
+            if f == "-":
+                f = sys.stdin
+            if _is_file(f):
+                _pprint_file(
+                    f,
+                    headers=headers,
+                    tablefmt=tablefmt,
+                    sep=sep,
+                    floatfmt=floatfmt,
+                    file=out,
+                    colalign=colalign,
+                )
+            else:
+                with open(f) as fobj:
+                    _pprint_file(
+                        fobj,
+                        headers=headers,
+                        tablefmt=tablefmt,
+                        sep=sep,
+                        floatfmt=floatfmt,
+                        file=out,
+                        colalign=colalign,
+                    )
+
+
+def _pprint_file(fobject, headers, tablefmt, sep, floatfmt, file, colalign):
+    rows = fobject.readlines()
+    table = [re.split(sep, r.rstrip()) for r in rows if r.strip()]
+    print(
+        tabulate(table, headers, tablefmt, floatfmt=floatfmt, colalign=colalign),
+        file=file,
+    )
+
+
+if __name__ == "__main__":
+    _main()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..78fb5bfdeef0bf10cb4fb67307c01ad95fe22d12
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/METADATA
@@ -0,0 +1,1238 @@
+Metadata-Version: 2.1
+Name: urllib3
+Version: 1.25.8
+Summary: HTTP library with thread-safe connection pooling, file post, and more.
+Home-page: https://urllib3.readthedocs.io/
+Author: Andrey Petrov
+Author-email: andrey.petrov@shazow.net
+License: MIT
+Project-URL: Documentation, https://urllib3.readthedocs.io/
+Project-URL: Code, https://github.com/urllib3/urllib3
+Project-URL: Issue tracker, https://github.com/urllib3/urllib3/issues
+Keywords: urllib httplib threadsafe filepost http https ssl pooling
+Platform: UNKNOWN
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4
+Provides-Extra: brotli
+Requires-Dist: brotlipy (>=0.6.0) ; extra == 'brotli'
+Provides-Extra: secure
+Requires-Dist: certifi ; extra == 'secure'
+Requires-Dist: cryptography (>=1.3.4) ; extra == 'secure'
+Requires-Dist: idna (>=2.0.0) ; extra == 'secure'
+Requires-Dist: pyOpenSSL (>=0.14) ; extra == 'secure'
+Requires-Dist: ipaddress ; (python_version == "2.7") and extra == 'secure'
+Provides-Extra: socks
+Requires-Dist: PySocks (!=1.5.7,<2.0,>=1.5.6) ; extra == 'socks'
+
+urllib3
+=======
+
+urllib3 is a powerful, *sanity-friendly* HTTP client for Python. Much of the
+Python ecosystem already uses urllib3 and you should too.
+urllib3 brings many critical features that are missing from the Python
+standard libraries:
+
+- Thread safety.
+- Connection pooling.
+- Client-side SSL/TLS verification.
+- File uploads with multipart encoding.
+- Helpers for retrying requests and dealing with HTTP redirects.
+- Support for gzip, deflate, and brotli encoding.
+- Proxy support for HTTP and SOCKS.
+- 100% test coverage.
+
+urllib3 is powerful and easy to use::
+
+    >>> import urllib3
+    >>> http = urllib3.PoolManager()
+    >>> r = http.request('GET', 'http://httpbin.org/robots.txt')
+    >>> r.status
+    200
+    >>> r.data
+    'User-agent: *\nDisallow: /deny\n'
+
+
+Installing
+----------
+
+urllib3 can be installed with `pip <https://pip.pypa.io>`_::
+
+    $ pip install urllib3
+
+Alternatively, you can grab the latest source code from `GitHub <https://github.com/urllib3/urllib3>`_::
+
+    $ git clone git://github.com/urllib3/urllib3.git
+    $ python setup.py install
+
+
+Documentation
+-------------
+
+urllib3 has usage and reference documentation at `urllib3.readthedocs.io <https://urllib3.readthedocs.io>`_.
+
+
+Contributing
+------------
+
+urllib3 happily accepts contributions. Please see our
+`contributing documentation <https://urllib3.readthedocs.io/en/latest/contributing.html>`_
+for some tips on getting started.
+
+
+Security Disclosures
+--------------------
+
+To report a security vulnerability, please use the
+`Tidelift security contact <https://tidelift.com/security>`_.
+Tidelift will coordinate the fix and disclosure with maintainers.
+
+Maintainers
+-----------
+
+- `@sethmlarson <https://github.com/sethmlarson>`_ (Seth M. Larson)
+- `@pquentin <https://github.com/pquentin>`_ (Quentin Pradet)
+- `@theacodes <https://github.com/theacodes>`_ (Thea Flowers)
+- `@haikuginger <https://github.com/haikuginger>`_ (Jess Shapiro)
+- `@lukasa <https://github.com/lukasa>`_ (Cory Benfield)
+- `@sigmavirus24 <https://github.com/sigmavirus24>`_ (Ian Stapleton Cordasco)
+- `@shazow <https://github.com/shazow>`_ (Andrey Petrov)
+
+👋
+
+
+Sponsorship
+-----------
+
+.. |tideliftlogo| image:: https://nedbatchelder.com/pix/Tidelift_Logos_RGB_Tidelift_Shorthand_On-White_small.png
+   :width: 75
+   :alt: Tidelift
+
+.. list-table::
+   :widths: 10 100
+
+   * - |tideliftlogo|
+     - Professional support for urllib3 is available as part of the `Tidelift
+       Subscription`_.  Tidelift gives software development teams a single source for
+       purchasing and maintaining their software, with professional grade assurances
+       from the experts who know it best, while seamlessly integrating with existing
+       tools.
+
+.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme
+
+If your company benefits from this library, please consider `sponsoring its
+development <https://urllib3.readthedocs.io/en/latest/contributing.html#sponsorship-project-grants>`_.
+
+Sponsors include:
+
+- Abbott (2018-2019), sponsored `@sethmlarson <https://github.com/sethmlarson>`_'s work on urllib3.
+- Google Cloud Platform (2018-2019), sponsored `@theacodes <https://github.com/theacodes>`_'s work on urllib3.
+- Akamai (2017-2018), sponsored `@haikuginger <https://github.com/haikuginger>`_'s work on urllib3
+- Hewlett Packard Enterprise (2016-2017), sponsored `@Lukasa’s <https://github.com/Lukasa>`_ work on urllib3.
+
+
+Changes
+=======
+
+1.25.8 (2020-01-20)
+-------------------
+
+* Drop support for EOL Python 3.4 (Pull #1774)
+
+* Optimize _encode_invalid_chars (Pull #1787)
+
+
+1.25.7 (2019-11-11)
+-------------------
+
+* Preserve ``chunked`` parameter on retries (Pull #1715, Pull #1734)
+
+* Allow unset ``SERVER_SOFTWARE`` in App Engine (Pull #1704, Issue #1470)
+
+* Fix issue where URL fragment was sent within the request target. (Pull #1732)
+
+* Fix issue where an empty query section in a URL would fail to parse. (Pull #1732)
+
+* Remove TLS 1.3 support in SecureTransport due to Apple removing support (Pull #1703)
+
+
+1.25.6 (2019-09-24)
+-------------------
+
+* Fix issue where tilde (``~``) characters were incorrectly
+  percent-encoded in the path. (Pull #1692)
+
+
+1.25.5 (2019-09-19)
+-------------------
+
+* Add mitigation for BPO-37428 affecting Python <3.7.4 and OpenSSL 1.1.1+ which
+  caused certificate verification to be enabled when using ``cert_reqs=CERT_NONE``.
+  (Issue #1682)
+
+
+1.25.4 (2019-09-19)
+-------------------
+
+* Propagate Retry-After header settings to subsequent retries. (Pull #1607)
+
+* Fix edge case where Retry-After header was still respected even when
+  explicitly opted out of. (Pull #1607)
+
+* Remove dependency on ``rfc3986`` for URL parsing.
+
+* Fix issue where URLs containing invalid characters within ``Url.auth`` would
+  raise an exception instead of percent-encoding those characters.
+
+* Add support for ``HTTPResponse.auto_close = False`` which makes HTTP responses
+  work well with BufferedReaders and other ``io`` module features. (Pull #1652)
+
+* Percent-encode invalid characters in URL for ``HTTPConnectionPool.request()`` (Pull #1673)
+
+
+1.25.3 (2019-05-23)
+-------------------
+
+* Change ``HTTPSConnection`` to load system CA certificates
+  when ``ca_certs``, ``ca_cert_dir``, and ``ssl_context`` are
+  unspecified. (Pull #1608, Issue #1603)
+
+* Upgrade bundled rfc3986 to v1.3.2. (Pull #1609, Issue #1605)
+
+
+1.25.2 (2019-04-28)
+-------------------
+
+* Change ``is_ipaddress`` to not detect IPvFuture addresses. (Pull #1583)
+
+* Change ``parse_url`` to percent-encode invalid characters within the
+  path, query, and target components. (Pull #1586)
+
+
+1.25.1 (2019-04-24)
+-------------------
+
+* Add support for Google's ``Brotli`` package. (Pull #1572, Pull #1579)
+
+* Upgrade bundled rfc3986 to v1.3.1 (Pull #1578)
+
+
+1.25 (2019-04-22)
+-----------------
+
+* Require and validate certificates by default when using HTTPS (Pull #1507)
+
+* Upgraded ``urllib3.utils.parse_url()`` to be RFC 3986 compliant. (Pull #1487)
+
+* Added support for ``key_password`` for ``HTTPSConnectionPool`` to use
+  encrypted ``key_file`` without creating your own ``SSLContext`` object. (Pull #1489)
+
+* Add TLSv1.3 support to CPython, pyOpenSSL, and SecureTransport ``SSLContext``
+  implementations. (Pull #1496)
+
+* Switched the default multipart header encoder from RFC 2231 to HTML 5 working draft. (Issue #303, PR #1492)
+
+* Fixed issue where OpenSSL would block if an encrypted client private key was
+  given and no password was given. Instead an ``SSLError`` is raised. (Pull #1489)
+
+* Added support for Brotli content encoding. It is enabled automatically if
+  ``brotlipy`` package is installed which can be requested with
+  ``urllib3[brotli]`` extra. (Pull #1532)
+
+* Drop ciphers using DSS key exchange from default TLS cipher suites.
+  Improve default ciphers when using SecureTransport. (Pull #1496)
+
+* Implemented a more efficient ``HTTPResponse.__iter__()`` method. (Issue #1483)
+
+1.24.3 (2019-05-01)
+-------------------
+
+* Apply fix for CVE-2019-9740. (Pull #1591)
+
+1.24.2 (2019-04-17)
+-------------------
+
+* Don't load system certificates by default when any other ``ca_certs``, ``ca_certs_dir`` or
+  ``ssl_context`` parameters are specified.
+
+* Remove Authorization header regardless of case when redirecting to cross-site. (Issue #1510)
+
+* Add support for IPv6 addresses in subjectAltName section of certificates. (Issue #1269)
+
+
+1.24.1 (2018-11-02)
+-------------------
+
+* Remove quadratic behavior within ``GzipDecoder.decompress()`` (Issue #1467)
+
+* Restored functionality of ``ciphers`` parameter for ``create_urllib3_context()``. (Issue #1462)
+
+
+1.24 (2018-10-16)
+-----------------
+
+* Allow key_server_hostname to be specified when initializing a PoolManager to allow custom SNI to be overridden. (Pull #1449)
+
+* Test against Python 3.7 on AppVeyor. (Pull #1453)
+
+* Early-out ipv6 checks when running on App Engine. (Pull #1450)
+
+* Change ambiguous description of backoff_factor (Pull #1436)
+
+* Add ability to handle multiple Content-Encodings (Issue #1441 and Pull #1442)
+
+* Skip DNS names that can't be idna-decoded when using pyOpenSSL (Issue #1405).
+
+* Add a server_hostname parameter to HTTPSConnection which allows for
+  overriding the SNI hostname sent in the handshake. (Pull #1397)
+
+* Drop support for EOL Python 2.6 (Pull #1429 and Pull #1430)
+
+* Fixed bug where responses with header Content-Type: message/* erroneously
+  raised HeaderParsingError, resulting in a warning being logged. (Pull #1439)
+
+* Move urllib3 to src/urllib3 (Pull #1409)
+
+
+1.23 (2018-06-04)
+-----------------
+
+* Allow providing a list of headers to strip from requests when redirecting
+  to a different host. Defaults to the ``Authorization`` header. Different
+  headers can be set via ``Retry.remove_headers_on_redirect``. (Issue #1316)
+
+* Fix ``util.selectors._fileobj_to_fd`` to accept ``long`` (Issue #1247).
+
+* Dropped Python 3.3 support. (Pull #1242)
+
+* Put the connection back in the pool when calling stream() or read_chunked() on
+  a chunked HEAD response. (Issue #1234)
+
+* Fixed pyOpenSSL-specific ssl client authentication issue when clients
+  attempted to auth via certificate + chain (Issue #1060)
+
+* Add the port to the connectionpool connect print (Pull #1251)
+
+* Don't use the ``uuid`` module to create multipart data boundaries. (Pull #1380)
+
+* ``read_chunked()`` on a closed response returns no chunks. (Issue #1088)
+
+* Add Python 2.6 support to ``contrib.securetransport`` (Pull #1359)
+
+* Added support for auth info in url for SOCKS proxy (Pull #1363)
+
+
+1.22 (2017-07-20)
+-----------------
+
+* Fixed missing brackets in ``HTTP CONNECT`` when connecting to IPv6 address via
+  IPv6 proxy. (Issue #1222)
+
+* Made the connection pool retry on ``SSLError``.  The original ``SSLError``
+  is available on ``MaxRetryError.reason``. (Issue #1112)
+
+* Drain and release connection before recursing on retry/redirect.  Fixes
+  deadlocks with a blocking connectionpool. (Issue #1167)
+
+* Fixed compatibility for cookiejar. (Issue #1229)
+
+* pyopenssl: Use vendored version of ``six``. (Issue #1231)
+
+
+1.21.1 (2017-05-02)
+-------------------
+
+* Fixed SecureTransport issue that would cause long delays in response body
+  delivery. (Pull #1154)
+
+* Fixed regression in 1.21 that threw exceptions when users passed the
+  ``socket_options`` flag to the ``PoolManager``.  (Issue #1165)
+
+* Fixed regression in 1.21 that threw exceptions when users passed the
+  ``assert_hostname`` or ``assert_fingerprint`` flag to the ``PoolManager``.
+  (Pull #1157)
+
+
+1.21 (2017-04-25)
+-----------------
+
+* Improved performance of certain selector system calls on Python 3.5 and
+  later. (Pull #1095)
+
+* Resolved issue where the PyOpenSSL backend would not wrap SysCallError
+  exceptions appropriately when sending data. (Pull #1125)
+
+* Selectors now detects a monkey-patched select module after import for modules
+  that patch the select module like eventlet, greenlet. (Pull #1128)
+
+* Reduced memory consumption when streaming zlib-compressed responses
+  (as opposed to raw deflate streams). (Pull #1129)
+
+* Connection pools now use the entire request context when constructing the
+  pool key. (Pull #1016)
+
+* ``PoolManager.connection_from_*`` methods now accept a new keyword argument,
+  ``pool_kwargs``, which are merged with the existing ``connection_pool_kw``.
+  (Pull #1016)
+
+* Add retry counter for ``status_forcelist``. (Issue #1147)
+
+* Added ``contrib`` module for using SecureTransport on macOS:
+  ``urllib3.contrib.securetransport``.  (Pull #1122)
+
+* urllib3 now only normalizes the case of ``http://`` and ``https://`` schemes:
+  for schemes it does not recognise, it assumes they are case-sensitive and
+  leaves them unchanged.
+  (Issue #1080)
+
+
+1.20 (2017-01-19)
+-----------------
+
+* Added support for waiting for I/O using selectors other than select,
+  improving urllib3's behaviour with large numbers of concurrent connections.
+  (Pull #1001)
+
+* Updated the date for the system clock check. (Issue #1005)
+
+* ConnectionPools now correctly consider hostnames to be case-insensitive.
+  (Issue #1032)
+
+* Outdated versions of PyOpenSSL now cause the PyOpenSSL contrib module
+  to fail when it is injected, rather than at first use. (Pull #1063)
+
+* Outdated versions of cryptography now cause the PyOpenSSL contrib module
+  to fail when it is injected, rather than at first use. (Issue #1044)
+
+* Automatically attempt to rewind a file-like body object when a request is
+  retried or redirected. (Pull #1039)
+
+* Fix some bugs that occur when modules incautiously patch the queue module.
+  (Pull #1061)
+
+* Prevent retries from occurring on read timeouts for which the request method
+  was not in the method whitelist. (Issue #1059)
+
+* Changed the PyOpenSSL contrib module to lazily load idna to avoid
+  unnecessarily bloating the memory of programs that don't need it. (Pull
+  #1076)
+
+* Add support for IPv6 literals with zone identifiers. (Pull #1013)
+
+* Added support for socks5h:// and socks4a:// schemes when working with SOCKS
+  proxies, and controlled remote DNS appropriately. (Issue #1035)
+
+
+1.19.1 (2016-11-16)
+-------------------
+
+* Fixed AppEngine import that didn't function on Python 3.5. (Pull #1025)
+
+
+1.19 (2016-11-03)
+-----------------
+
+* urllib3 now respects Retry-After headers on 413, 429, and 503 responses when
+  using the default retry logic. (Pull #955)
+
+* Remove markers from setup.py to assist ancient setuptools versions. (Issue
+  #986)
+
+* Disallow superscripts and other integerish things in URL ports. (Issue #989)
+
+* Allow urllib3's HTTPResponse.stream() method to continue to work with
+  non-httplib underlying FPs. (Pull #990)
+
+* Empty filenames in multipart headers are now emitted as such, rather than
+  being suppressed. (Issue #1015)
+
+* Prefer user-supplied Host headers on chunked uploads. (Issue #1009)
+
+
+1.18.1 (2016-10-27)
+-------------------
+
+* CVE-2016-9015. Users who are using urllib3 version 1.17 or 1.18 along with
+  PyOpenSSL injection and OpenSSL 1.1.0 *must* upgrade to this version. This
+  release fixes a vulnerability whereby urllib3 in the above configuration
+  would silently fail to validate TLS certificates due to erroneously setting
+  invalid flags in OpenSSL's ``SSL_CTX_set_verify`` function. These erroneous
+  flags do not cause a problem in OpenSSL versions before 1.1.0, which
+  interprets the presence of any flag as requesting certificate validation.
+
+  There is no PR for this patch, as it was prepared for simultaneous disclosure
+  and release. The master branch received the same fix in PR #1010.
+
+
+1.18 (2016-09-26)
+-----------------
+
+* Fixed incorrect message for IncompleteRead exception. (PR #973)
+
+* Accept ``iPAddress`` subject alternative name fields in TLS certificates.
+  (Issue #258)
+
+* Fixed consistency of ``HTTPResponse.closed`` between Python 2 and 3.
+  (Issue #977)
+
+* Fixed handling of wildcard certificates when using PyOpenSSL. (Issue #979)
+
+
+1.17 (2016-09-06)
+-----------------
+
+* Accept ``SSLContext`` objects for use in SSL/TLS negotiation. (Issue #835)
+
+* ConnectionPool debug log now includes scheme, host, and port. (Issue #897)
+
+* Substantially refactored documentation. (Issue #887)
+
+* Used URLFetch default timeout on AppEngine, rather than hardcoding our own.
+  (Issue #858)
+
+* Normalize the scheme and host in the URL parser (Issue #833)
+
+* ``HTTPResponse`` contains the last ``Retry`` object, which now also
+  contains retries history. (Issue #848)
+
+* Timeout can no longer be set as boolean, and must be greater than zero.
+  (PR #924)
+
+* Removed pyasn1 and ndg-httpsclient from dependencies used for PyOpenSSL. We
+  now use cryptography and idna, both of which are already dependencies of
+  PyOpenSSL. (PR #930)
+
+* Fixed infinite loop in ``stream`` when amt=None. (Issue #928)
+
+* Try to use the operating system's certificates when we are using an
+  ``SSLContext``. (PR #941)
+
+* Updated cipher suite list to allow ChaCha20+Poly1305. AES-GCM is preferred to
+  ChaCha20, but ChaCha20 is then preferred to everything else. (PR #947)
+
+* Updated cipher suite list to remove 3DES-based cipher suites. (PR #958)
+
+* Removed the cipher suite fallback to allow HIGH ciphers. (PR #958)
+
+* Implemented ``length_remaining`` to determine remaining content
+  to be read. (PR #949)
+
+* Implemented ``enforce_content_length`` to enable exceptions when
+  incomplete data chunks are received. (PR #949)
+
+* Dropped connection start, dropped connection reset, redirect, forced retry,
+  and new HTTPS connection log levels to DEBUG, from INFO. (PR #967)
+
+
+1.16 (2016-06-11)
+-----------------
+
+* Disable IPv6 DNS when IPv6 connections are not possible. (Issue #840)
+
+* Provide ``key_fn_by_scheme`` pool keying mechanism that can be
+  overridden. (Issue #830)
+
+* Normalize scheme and host to lowercase for pool keys, and include
+  ``source_address``. (Issue #830)
+
+* Cleaner exception chain in Python 3 for ``_make_request``.
+  (Issue #861)
+
+* Fixed installing ``urllib3[socks]`` extra. (Issue #864)
+
+* Fixed signature of ``ConnectionPool.close`` so it can actually safely be
+  called by subclasses. (Issue #873)
+
+* Retain ``release_conn`` state across retries. (Issues #651, #866)
+
+* Add customizable ``HTTPConnectionPool.ResponseCls``, which defaults to
+  ``HTTPResponse`` but can be replaced with a subclass. (Issue #879)
+
+
+1.15.1 (2016-04-11)
+-------------------
+
+* Fix packaging to include backports module. (Issue #841)
+
+
+1.15 (2016-04-06)
+-----------------
+
+* Added Retry(raise_on_status=False). (Issue #720)
+
+* Always use setuptools, no more distutils fallback. (Issue #785)
+
+* Dropped support for Python 3.2. (Issue #786)
+
+* Chunked transfer encoding when requesting with ``chunked=True``.
+  (Issue #790)
+
+* Fixed regression with IPv6 port parsing. (Issue #801)
+
+* Append SNIMissingWarning messages to allow users to specify it in
+  the PYTHONWARNINGS environment variable. (Issue #816)
+
+* Handle unicode headers in Py2. (Issue #818)
+
+* Log certificate when there is a hostname mismatch. (Issue #820)
+
+* Preserve order of request/response headers. (Issue #821)
+
+
+1.14 (2015-12-29)
+-----------------
+
+* contrib: SOCKS proxy support! (Issue #762)
+
+* Fixed AppEngine handling of transfer-encoding header and bug
+  in Timeout defaults checking. (Issue #763)
+
+
+1.13.1 (2015-12-18)
+-------------------
+
+* Fixed regression in IPv6 + SSL for match_hostname. (Issue #761)
+
+
+1.13 (2015-12-14)
+-----------------
+
+* Fixed ``pip install urllib3[secure]`` on modern pip. (Issue #706)
+
+* pyopenssl: Fixed SSL3_WRITE_PENDING error. (Issue #717)
+
+* pyopenssl: Support for TLSv1.1 and TLSv1.2. (Issue #696)
+
+* Close connections more defensively on exception. (Issue #734)
+
+* Adjusted ``read_chunked`` to handle gzipped, chunk-encoded bodies without
+  repeatedly flushing the decoder, to function better on Jython. (Issue #743)
+
+* Accept ``ca_cert_dir`` for SSL-related PoolManager configuration. (Issue #758)
+
+
+1.12 (2015-09-03)
+-----------------
+
+* Rely on ``six`` for importing ``httplib`` to work around
+  conflicts with other Python 3 shims. (Issue #688)
+
+* Add support for directories of certificate authorities, as supported by
+  OpenSSL. (Issue #701)
+
+* New exception: ``NewConnectionError``, raised when we fail to establish
+  a new connection, usually ``ECONNREFUSED`` socket error.
+
+
+1.11 (2015-07-21)
+-----------------
+
+* When ``ca_certs`` is given, ``cert_reqs`` defaults to
+  ``'CERT_REQUIRED'``. (Issue #650)
+
+* ``pip install urllib3[secure]`` will install Certifi and
+  PyOpenSSL as dependencies. (Issue #678)
+
+* Made ``HTTPHeaderDict`` usable as a ``headers`` input value
+  (Issues #632, #679)
+
+* Added `urllib3.contrib.appengine <https://urllib3.readthedocs.io/en/latest/contrib.html#google-app-engine>`_
+  which has an ``AppEngineManager`` for using ``URLFetch`` in a
+  Google AppEngine environment. (Issue #664)
+
+* Dev: Added test suite for AppEngine. (Issue #631)
+
+* Fix performance regression when using PyOpenSSL. (Issue #626)
+
+* Passing incorrect scheme (e.g. ``foo://``) will raise
+  ``ValueError`` instead of ``AssertionError`` (backwards
+  compatible for now, but please migrate). (Issue #640)
+
+* Fix pools not getting replenished when an error occurs during a
+  request using ``release_conn=False``. (Issue #644)
+
+* Fix pool-default headers not applying for url-encoded requests
+  like GET. (Issue #657)
+
+* log.warning in Python 3 when headers are skipped due to parsing
+  errors. (Issue #642)
+
+* Close and discard connections if an error occurs during read.
+  (Issue #660)
+
+* Fix host parsing for IPv6 proxies. (Issue #668)
+
+* Separate warning type SubjectAltNameWarning, now issued once
+  per host. (Issue #671)
+
+* Fix ``httplib.IncompleteRead`` not getting converted to
+  ``ProtocolError`` when using ``HTTPResponse.stream()``
+  (Issue #674)
+
+1.10.4 (2015-05-03)
+-------------------
+
+* Migrate tests to Tornado 4. (Issue #594)
+
+* Append default warning configuration rather than overwrite.
+  (Issue #603)
+
+* Fix streaming decoding regression. (Issue #595)
+
+* Fix chunked requests losing state across keep-alive connections.
+  (Issue #599)
+
+* Fix hanging when chunked HEAD response has no body. (Issue #605)
+
+
+1.10.3 (2015-04-21)
+-------------------
+
+* Emit ``InsecurePlatformWarning`` when SSLContext object is missing.
+  (Issue #558)
+
+* Fix regression of duplicate header keys being discarded.
+  (Issue #563)
+
+* ``Response.stream()`` returns a generator for chunked responses.
+  (Issue #560)
+
+* Set upper-bound timeout when waiting for a socket in PyOpenSSL.
+  (Issue #585)
+
+* Work on platforms without `ssl` module for plain HTTP requests.
+  (Issue #587)
+
+* Stop relying on the stdlib's default cipher list. (Issue #588)
+
+
+1.10.2 (2015-02-25)
+-------------------
+
+* Fix file descriptor leakage on retries. (Issue #548)
+
+* Removed RC4 from default cipher list. (Issue #551)
+
+* Header performance improvements. (Issue #544)
+
+* Fix PoolManager not obeying redirect retry settings. (Issue #553)
+
+
+1.10.1 (2015-02-10)
+-------------------
+
+* Pools can be used as context managers. (Issue #545)
+
+* Don't re-use connections which experienced an SSLError. (Issue #529)
+
+* Don't fail when gzip decoding an empty stream. (Issue #535)
+
+* Add sha256 support for fingerprint verification. (Issue #540)
+
+* Fixed handling of header values containing commas. (Issue #533)
+
+
+1.10 (2014-12-14)
+-----------------
+
+* Disabled SSLv3. (Issue #473)
+
+* Add ``Url.url`` property to return the composed url string. (Issue #394)
+
+* Fixed PyOpenSSL + gevent ``WantWriteError``. (Issue #412)
+
+* ``MaxRetryError.reason`` will always be an exception, not string.
+  (Issue #481)
+
+* Fixed SSL-related timeouts not being detected as timeouts. (Issue #492)
+
+* Py3: Use ``ssl.create_default_context()`` when available. (Issue #473)
+
+* Emit ``InsecureRequestWarning`` for *every* insecure HTTPS request.
+  (Issue #496)
+
+* Emit ``SecurityWarning`` when certificate has no ``subjectAltName``.
+  (Issue #499)
+
+* Close and discard sockets which experienced SSL-related errors.
+  (Issue #501)
+
+* Handle ``body`` param in ``.request(...)``. (Issue #513)
+
+* Respect timeout with HTTPS proxy. (Issue #505)
+
+* PyOpenSSL: Handle ZeroReturnError exception. (Issue #520)
+
+
+1.9.1 (2014-09-13)
+------------------
+
+* Apply socket arguments before binding. (Issue #427)
+
+* More careful checks if fp-like object is closed. (Issue #435)
+
+* Fixed packaging issues of some development-related files not
+  getting included. (Issue #440)
+
+* Allow performing *only* fingerprint verification. (Issue #444)
+
+* Emit ``SecurityWarning`` if system clock is waaay off. (Issue #445)
+
+* Fixed PyOpenSSL compatibility with PyPy. (Issue #450)
+
+* Fixed ``BrokenPipeError`` and ``ConnectionError`` handling in Py3.
+  (Issue #443)
+
+
+
+1.9 (2014-07-04)
+----------------
+
+* Shuffled around development-related files. If you're maintaining a distro
+  package of urllib3, you may need to tweak things. (Issue #415)
+
+* Unverified HTTPS requests will trigger a warning on the first request. See
+  our new `security documentation
+  <https://urllib3.readthedocs.io/en/latest/security.html>`_ for details.
+  (Issue #426)
+
+* New retry logic and ``urllib3.util.retry.Retry`` configuration object.
+  (Issue #326)
+
+* All raised exceptions should now wrapped in a
+  ``urllib3.exceptions.HTTPException``-extending exception. (Issue #326)
+
+* All errors during a retry-enabled request should be wrapped in
+  ``urllib3.exceptions.MaxRetryError``, including timeout-related exceptions
+  which were previously exempt. Underlying error is accessible from the
+  ``.reason`` property. (Issue #326)
+
+* ``urllib3.exceptions.ConnectionError`` renamed to
+  ``urllib3.exceptions.ProtocolError``. (Issue #326)
+
+* Errors during response read (such as IncompleteRead) are now wrapped in
+  ``urllib3.exceptions.ProtocolError``. (Issue #418)
+
+* Requesting an empty host will raise ``urllib3.exceptions.LocationValueError``.
+  (Issue #417)
+
+* Catch read timeouts over SSL connections as
+  ``urllib3.exceptions.ReadTimeoutError``. (Issue #419)
+
+* Apply socket arguments before connecting. (Issue #427)
+
+
+1.8.3 (2014-06-23)
+------------------
+
+* Fix TLS verification when using a proxy in Python 3.4.1. (Issue #385)
+
+* Add ``disable_cache`` option to ``urllib3.util.make_headers``. (Issue #393)
+
+* Wrap ``socket.timeout`` exception with
+  ``urllib3.exceptions.ReadTimeoutError``. (Issue #399)
+
+* Fixed proxy-related bug where connections were being reused incorrectly.
+  (Issues #366, #369)
+
+* Added ``socket_options`` keyword parameter which allows to define
+  ``setsockopt`` configuration of new sockets. (Issue #397)
+
+* Removed ``HTTPConnection.tcp_nodelay`` in favor of
+  ``HTTPConnection.default_socket_options``. (Issue #397)
+
+* Fixed ``TypeError`` bug in Python 2.6.4. (Issue #411)
+
+
+1.8.2 (2014-04-17)
+------------------
+
+* Fix ``urllib3.util`` not being included in the package.
+
+
+1.8.1 (2014-04-17)
+------------------
+
+* Fix AppEngine bug of HTTPS requests going out as HTTP. (Issue #356)
+
+* Don't install ``dummyserver`` into ``site-packages`` as it's only needed
+  for the test suite. (Issue #362)
+
+* Added support for specifying ``source_address``. (Issue #352)
+
+
+1.8 (2014-03-04)
+----------------
+
+* Improved url parsing in ``urllib3.util.parse_url`` (properly parse '@' in
+  username, and blank ports like 'hostname:').
+
+* New ``urllib3.connection`` module which contains all the HTTPConnection
+  objects.
+
+* Several ``urllib3.util.Timeout``-related fixes. Also changed constructor
+  signature to a more sensible order. [Backwards incompatible]
+  (Issues #252, #262, #263)
+
+* Use ``backports.ssl_match_hostname`` if it's installed. (Issue #274)
+
+* Added ``.tell()`` method to ``urllib3.response.HTTPResponse`` which
+  returns the number of bytes read so far. (Issue #277)
+
+* Support for platforms without threading. (Issue #289)
+
+* Expand default-port comparison in ``HTTPConnectionPool.is_same_host``
+  to allow a pool with no specified port to be considered equal to to an
+  HTTP/HTTPS url with port 80/443 explicitly provided. (Issue #305)
+
+* Improved default SSL/TLS settings to avoid vulnerabilities.
+  (Issue #309)
+
+* Fixed ``urllib3.poolmanager.ProxyManager`` not retrying on connect errors.
+  (Issue #310)
+
+* Disable Nagle's Algorithm on the socket for non-proxies. A subset of requests
+  will send the entire HTTP request ~200 milliseconds faster; however, some of
+  the resulting TCP packets will be smaller. (Issue #254)
+
+* Increased maximum number of SubjectAltNames in ``urllib3.contrib.pyopenssl``
+  from the default 64 to 1024 in a single certificate. (Issue #318)
+
+* Headers are now passed and stored as a custom
+  ``urllib3.collections_.HTTPHeaderDict`` object rather than a plain ``dict``.
+  (Issue #329, #333)
+
+* Headers no longer lose their case on Python 3. (Issue #236)
+
+* ``urllib3.contrib.pyopenssl`` now uses the operating system's default CA
+  certificates on inject. (Issue #332)
+
+* Requests with ``retries=False`` will immediately raise any exceptions without
+  wrapping them in ``MaxRetryError``. (Issue #348)
+
+* Fixed open socket leak with SSL-related failures. (Issue #344, #348)
+
+
+1.7.1 (2013-09-25)
+------------------
+
+* Added granular timeout support with new ``urllib3.util.Timeout`` class.
+  (Issue #231)
+
+* Fixed Python 3.4 support. (Issue #238)
+
+
+1.7 (2013-08-14)
+----------------
+
+* More exceptions are now pickle-able, with tests. (Issue #174)
+
+* Fixed redirecting with relative URLs in Location header. (Issue #178)
+
+* Support for relative urls in ``Location: ...`` header. (Issue #179)
+
+* ``urllib3.response.HTTPResponse`` now inherits from ``io.IOBase`` for bonus
+  file-like functionality. (Issue #187)
+
+* Passing ``assert_hostname=False`` when creating a HTTPSConnectionPool will
+  skip hostname verification for SSL connections. (Issue #194)
+
+* New method ``urllib3.response.HTTPResponse.stream(...)`` which acts as a
+  generator wrapped around ``.read(...)``. (Issue #198)
+
+* IPv6 url parsing enforces brackets around the hostname. (Issue #199)
+
+* Fixed thread race condition in
+  ``urllib3.poolmanager.PoolManager.connection_from_host(...)`` (Issue #204)
+
+* ``ProxyManager`` requests now include non-default port in ``Host: ...``
+  header. (Issue #217)
+
+* Added HTTPS proxy support in ``ProxyManager``. (Issue #170 #139)
+
+* New ``RequestField`` object can be passed to the ``fields=...`` param which
+  can specify headers. (Issue #220)
+
+* Raise ``urllib3.exceptions.ProxyError`` when connecting to proxy fails.
+  (Issue #221)
+
+* Use international headers when posting file names. (Issue #119)
+
+* Improved IPv6 support. (Issue #203)
+
+
+1.6 (2013-04-25)
+----------------
+
+* Contrib: Optional SNI support for Py2 using PyOpenSSL. (Issue #156)
+
+* ``ProxyManager`` automatically adds ``Host: ...`` header if not given.
+
+* Improved SSL-related code. ``cert_req`` now optionally takes a string like
+  "REQUIRED" or "NONE". Same with ``ssl_version`` takes strings like "SSLv23"
+  The string values reflect the suffix of the respective constant variable.
+  (Issue #130)
+
+* Vendored ``socksipy`` now based on Anorov's fork which handles unexpectedly
+  closed proxy connections and larger read buffers. (Issue #135)
+
+* Ensure the connection is closed if no data is received, fixes connection leak
+  on some platforms. (Issue #133)
+
+* Added SNI support for SSL/TLS connections on Py32+. (Issue #89)
+
+* Tests fixed to be compatible with Py26 again. (Issue #125)
+
+* Added ability to choose SSL version by passing an ``ssl.PROTOCOL_*`` constant
+  to the ``ssl_version`` parameter of ``HTTPSConnectionPool``. (Issue #109)
+
+* Allow an explicit content type to be specified when encoding file fields.
+  (Issue #126)
+
+* Exceptions are now pickleable, with tests. (Issue #101)
+
+* Fixed default headers not getting passed in some cases. (Issue #99)
+
+* Treat "content-encoding" header value as case-insensitive, per RFC 2616
+  Section 3.5. (Issue #110)
+
+* "Connection Refused" SocketErrors will get retried rather than raised.
+  (Issue #92)
+
+* Updated vendored ``six``, no longer overrides the global ``six`` module
+  namespace. (Issue #113)
+
+* ``urllib3.exceptions.MaxRetryError`` contains a ``reason`` property holding
+  the exception that prompted the final retry. If ``reason is None`` then it
+  was due to a redirect. (Issue #92, #114)
+
+* Fixed ``PoolManager.urlopen()`` from not redirecting more than once.
+  (Issue #149)
+
+* Don't assume ``Content-Type: text/plain`` for multi-part encoding parameters
+  that are not files. (Issue #111)
+
+* Pass `strict` param down to ``httplib.HTTPConnection``. (Issue #122)
+
+* Added mechanism to verify SSL certificates by fingerprint (md5, sha1) or
+  against an arbitrary hostname (when connecting by IP or for misconfigured
+  servers). (Issue #140)
+
+* Streaming decompression support. (Issue #159)
+
+
+1.5 (2012-08-02)
+----------------
+
+* Added ``urllib3.add_stderr_logger()`` for quickly enabling STDERR debug
+  logging in urllib3.
+
+* Native full URL parsing (including auth, path, query, fragment) available in
+  ``urllib3.util.parse_url(url)``.
+
+* Built-in redirect will switch method to 'GET' if status code is 303.
+  (Issue #11)
+
+* ``urllib3.PoolManager`` strips the scheme and host before sending the request
+  uri. (Issue #8)
+
+* New ``urllib3.exceptions.DecodeError`` exception for when automatic decoding,
+  based on the Content-Type header, fails.
+
+* Fixed bug with pool depletion and leaking connections (Issue #76). Added
+  explicit connection closing on pool eviction. Added
+  ``urllib3.PoolManager.clear()``.
+
+* 99% -> 100% unit test coverage.
+
+
+1.4 (2012-06-16)
+----------------
+
+* Minor AppEngine-related fixes.
+
+* Switched from ``mimetools.choose_boundary`` to ``uuid.uuid4()``.
+
+* Improved url parsing. (Issue #73)
+
+* IPv6 url support. (Issue #72)
+
+
+1.3 (2012-03-25)
+----------------
+
+* Removed pre-1.0 deprecated API.
+
+* Refactored helpers into a ``urllib3.util`` submodule.
+
+* Fixed multipart encoding to support list-of-tuples for keys with multiple
+  values. (Issue #48)
+
+* Fixed multiple Set-Cookie headers in response not getting merged properly in
+  Python 3. (Issue #53)
+
+* AppEngine support with Py27. (Issue #61)
+
+* Minor ``encode_multipart_formdata`` fixes related to Python 3 strings vs
+  bytes.
+
+
+1.2.2 (2012-02-06)
+------------------
+
+* Fixed packaging bug of not shipping ``test-requirements.txt``. (Issue #47)
+
+
+1.2.1 (2012-02-05)
+------------------
+
+* Fixed another bug related to when ``ssl`` module is not available. (Issue #41)
+
+* Location parsing errors now raise ``urllib3.exceptions.LocationParseError``
+  which inherits from ``ValueError``.
+
+
+1.2 (2012-01-29)
+----------------
+
+* Added Python 3 support (tested on 3.2.2)
+
+* Dropped Python 2.5 support (tested on 2.6.7, 2.7.2)
+
+* Use ``select.poll`` instead of ``select.select`` for platforms that support
+  it.
+
+* Use ``Queue.LifoQueue`` instead of ``Queue.Queue`` for more aggressive
+  connection reusing. Configurable by overriding ``ConnectionPool.QueueCls``.
+
+* Fixed ``ImportError`` during install when ``ssl`` module is not available.
+  (Issue #41)
+
+* Fixed ``PoolManager`` redirects between schemes (such as HTTP -> HTTPS) not
+  completing properly. (Issue #28, uncovered by Issue #10 in v1.1)
+
+* Ported ``dummyserver`` to use ``tornado`` instead of ``webob`` +
+  ``eventlet``. Removed extraneous unsupported dummyserver testing backends.
+  Added socket-level tests.
+
+* More tests. Achievement Unlocked: 99% Coverage.
+
+
+1.1 (2012-01-07)
+----------------
+
+* Refactored ``dummyserver`` to its own root namespace module (used for
+  testing).
+
+* Added hostname verification for ``VerifiedHTTPSConnection`` by vendoring in
+  Py32's ``ssl_match_hostname``. (Issue #25)
+
+* Fixed cross-host HTTP redirects when using ``PoolManager``. (Issue #10)
+
+* Fixed ``decode_content`` being ignored when set through ``urlopen``. (Issue
+  #27)
+
+* Fixed timeout-related bugs. (Issues #17, #23)
+
+
+1.0.2 (2011-11-04)
+------------------
+
+* Fixed typo in ``VerifiedHTTPSConnection`` which would only present as a bug if
+  you're using the object manually. (Thanks pyos)
+
+* Made RecentlyUsedContainer (and consequently PoolManager) more thread-safe by
+  wrapping the access log in a mutex. (Thanks @christer)
+
+* Made RecentlyUsedContainer more dict-like (corrected ``__delitem__`` and
+  ``__getitem__`` behaviour), with tests. Shouldn't affect core urllib3 code.
+
+
+1.0.1 (2011-10-10)
+------------------
+
+* Fixed a bug where the same connection would get returned into the pool twice,
+  causing extraneous "HttpConnectionPool is full" log warnings.
+
+
+1.0 (2011-10-08)
+----------------
+
+* Added ``PoolManager`` with LRU expiration of connections (tested and
+  documented).
+* Added ``ProxyManager`` (needs tests, docs, and confirmation that it works
+  with HTTPS proxies).
+* Added optional partial-read support for responses when
+  ``preload_content=False``. You can now make requests and just read the headers
+  without loading the content.
+* Made response decoding optional (default on, same as before).
+* Added optional explicit boundary string for ``encode_multipart_formdata``.
+* Convenience request methods are now inherited from ``RequestMethods``. Old
+  helpers like ``get_url`` and ``post_url`` should be abandoned in favour of
+  the new ``request(method, url, ...)``.
+* Refactored code to be even more decoupled, reusable, and extendable.
+* License header added to ``.py`` files.
+* Embiggened the documentation: Lots of Sphinx-friendly docstrings in the code
+  and docs in ``docs/`` and on https://urllib3.readthedocs.io/.
+* Embettered all the things!
+* Started writing this file.
+
+
+0.4.1 (2011-07-17)
+------------------
+
+* Minor bug fixes, code cleanup.
+
+
+0.4 (2011-03-01)
+----------------
+
+* Better unicode support.
+* Added ``VerifiedHTTPSConnection``.
+* Added ``NTLMConnectionPool`` in contrib.
+* Minor improvements.
+
+
+0.3.1 (2010-07-13)
+------------------
+
+* Added ``assert_host_name`` optional parameter. Now compatible with proxies.
+
+
+0.3 (2009-12-10)
+----------------
+
+* Added HTTPS support.
+* Minor bug fixes.
+* Refactored, broken backwards compatibility with 0.2.
+* API to be treated as stable from this version forward.
+
+
+0.2 (2008-11-17)
+----------------
+
+* Added unit tests.
+* Bug fixes.
+
+
+0.1 (2008-11-16)
+----------------
+
+* First release.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..f1a3a80497b63995eafb5fd033c0f6941547e007
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/RECORD
@@ -0,0 +1,86 @@
+urllib3/__init__.py,sha256=oVOeFuNyEg33ShIefD4qSeGvbb-aJ3otjcdX2iswkLM,2683
+urllib3/_collections.py,sha256=EASnQyCdD28r214TYFl0_AqhAyTkDyn9xvDxhX_4bDM,10782
+urllib3/connection.py,sha256=c57Su4-o86FZZEHI9u7Ps9wUbybGe1KBELjxsnGgA3Q,14497
+urllib3/connectionpool.py,sha256=I9bSvbCK_RaJg-eWanPhDNeoiyUr-z_KTO1vTWTzfeI,36597
+urllib3/exceptions.py,sha256=m4wjR3tjxpA9UpHDkA17oUveium9Jl9tlq7KiXZNshA,6597
+urllib3/fields.py,sha256=uJD2voWwcbgIUOGpfzHu93vH9h_8YiBMta-Rogp3zQw,8538
+urllib3/filepost.py,sha256=uuQLZmTX7wzByOqkfQblnhZ6Z8NcpQIK5iAFTE9H3IY,2415
+urllib3/poolmanager.py,sha256=ZewLfWn1OE16AxF585MLLEzZ_JHjFf-kNPzWLBAx080,17028
+urllib3/request.py,sha256=kadPA_I1wh0FpFes8v6NNe8ju6IB_C4o7QkpaeyST_A,6008
+urllib3/response.py,sha256=b7o-UR-atlD8igi5eyI-yKwoZaensIIDokvcYfRbCdU,27813
+urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+urllib3/contrib/_appengine_environ.py,sha256=bDbyOEhW2CKLJcQqAKAyrEHN-aklsyHFKq6vF8ZFsmk,957
+urllib3/contrib/appengine.py,sha256=i2JE4PovYjOVf24WJTqyqN1tD23zdETL_dN-heQlzec,10999
+urllib3/contrib/ntlmpool.py,sha256=uY2D_nq3kf1OOFFdjOAwQN0l5KF5V7Jz_EDTUpXlMAM,4149
+urllib3/contrib/pyopenssl.py,sha256=ZMO5enmunSS5PjyMKvg1-pJqxtpQD9IYh5H-p_563Qc,16407
+urllib3/contrib/securetransport.py,sha256=iKzVUAxKnChsADR5YMwc05oEixXDzAk0xPU0g-rc2z8,32275
+urllib3/contrib/socks.py,sha256=nzDMgDIFJWVubKHqvIn2-SKCO91hhJInP92WgHChGzA,7036
+urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+urllib3/contrib/_securetransport/bindings.py,sha256=mullWYFaghBdRWla6HYU-TBgFRTPLBEfxj3jplbeJmQ,16886
+urllib3/contrib/_securetransport/low_level.py,sha256=V7GnujxnWZh2N2sMsV5N4d9Imymokkm3zBwgt77_bSE,11956
+urllib3/packages/__init__.py,sha256=7Edo1aneF4-I-RX4-eBILdRL3Ye6HbAQAvwqFGhgp2I,300
+urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+urllib3/packages/backports/makefile.py,sha256=005wrvH-_pWSnTFqQ2sdzzh4zVCtQUUQ4mR2Yyxwc0A,1418
+urllib3/packages/ssl_match_hostname/__init__.py,sha256=ywgKMtfHi1-DrXlzPfVAhzsLzzqcK7GT6eLgdode1Fg,688
+urllib3/packages/ssl_match_hostname/_implementation.py,sha256=6dZ-q074g7XhsJ27MFCgkct8iVNZB3sMZvKhf-KUVy0,5679
+urllib3/util/__init__.py,sha256=bWNaav_OT-1L7-sxm59cGb59rDORlbhb_4noduM5m0U,1038
+urllib3/util/connection.py,sha256=NsxUAKQ98GKywta--zg57CdVpeTCI6N-GElCq78Dl8U,4637
+urllib3/util/queue.py,sha256=JgM-hj60tHkrsABs9zpONo4QNH8kGOTR7GNGRyOi_80,470
+urllib3/util/request.py,sha256=Ohxx1TaEPzXbHQW1tyocLUs_cyBQBVY9PpS4EacigD8,3804
+urllib3/util/response.py,sha256=WC1TEwNHy2GJMNFzjWmXdzxqaoh4XzwTH2qUMvXiQCw,2562
+urllib3/util/retry.py,sha256=xfWluFSKLlm7GS7OZqGoMc0mXHZaheXTKVdkReGIBTU,15434
+urllib3/util/ssl_.py,sha256=Pw1PJRd37VROQdrCEKnsut3Pm_Wd4uoWU8b9gYOG6Qo,14139
+urllib3/util/timeout.py,sha256=bCtaS_xVKaTDJ5VMlroXBfCnPUDNVGZqik7-z83issg,9871
+urllib3/util/url.py,sha256=XT8PO3bNzd6R_Fx6WTbs6U6yXEtwjJgobj0H7lCgzWg,13946
+urllib3/util/wait.py,sha256=k46KzqIYu3Vnzla5YW3EvtInNlU_QycFqQAghIOxoAg,5406
+urllib3-1.25.8.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+urllib3-1.25.8.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+urllib3-1.25.8.dist-info/METADATA,sha256=AMgz2NLN1OvTguiH_nd51xQJWq6iuAbufr32v2R57Ik,38976
+urllib3-1.25.8.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+urllib3-1.25.8.dist-info/top_level.txt,sha256=EMiXL2sKrTcmrMxIHTqdc3ET54pQI2Y072LexFEemvo,8
+urllib3-1.25.8.dist-info/RECORD,,
+urllib3/packages/backports/__pycache__,,
+urllib3/packages/ssl_match_hostname/__init__.cpython-38.pyc,,
+urllib3/packages/__pycache__,,
+urllib3/util/response.cpython-38.pyc,,
+urllib3/contrib/pyopenssl.cpython-38.pyc,,
+urllib3/_collections.cpython-38.pyc,,
+urllib3/response.cpython-38.pyc,,
+urllib3-1.25.8.virtualenv,,
+urllib3/connection.cpython-38.pyc,,
+urllib3/util/wait.cpython-38.pyc,,
+urllib3/contrib/ntlmpool.cpython-38.pyc,,
+urllib3-1.25.8.dist-info/__pycache__,,
+urllib3/util/request.cpython-38.pyc,,
+urllib3/util/__init__.cpython-38.pyc,,
+urllib3/packages/ssl_match_hostname/__pycache__,,
+urllib3/util/ssl_.cpython-38.pyc,,
+urllib3/util/retry.cpython-38.pyc,,
+urllib3/util/timeout.cpython-38.pyc,,
+urllib3/contrib/securetransport.cpython-38.pyc,,
+urllib3/contrib/_securetransport/__init__.cpython-38.pyc,,
+urllib3/exceptions.cpython-38.pyc,,
+urllib3/contrib/_securetransport/bindings.cpython-38.pyc,,
+urllib3/contrib/__init__.cpython-38.pyc,,
+urllib3/request.cpython-38.pyc,,
+urllib3/__init__.cpython-38.pyc,,
+urllib3/packages/backports/__init__.cpython-38.pyc,,
+urllib3/util/url.cpython-38.pyc,,
+urllib3/packages/ssl_match_hostname/_implementation.cpython-38.pyc,,
+urllib3/contrib/_appengine_environ.cpython-38.pyc,,
+urllib3/fields.cpython-38.pyc,,
+urllib3/packages/__init__.cpython-38.pyc,,
+urllib3/connectionpool.cpython-38.pyc,,
+urllib3-1.25.8.dist-info/INSTALLER,,
+urllib3/util/__pycache__,,
+urllib3/contrib/_securetransport/low_level.cpython-38.pyc,,
+urllib3/poolmanager.cpython-38.pyc,,
+urllib3/packages/backports/makefile.cpython-38.pyc,,
+urllib3/contrib/_securetransport/__pycache__,,
+urllib3/contrib/__pycache__,,
+urllib3/contrib/appengine.cpython-38.pyc,,
+urllib3/contrib/socks.cpython-38.pyc,,
+urllib3/__pycache__,,
+urllib3/util/queue.cpython-38.pyc,,
+urllib3/util/connection.cpython-38.pyc,,
+urllib3/filepost.cpython-38.pyc,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a42590bebea6002a3c81cdbf89443ca1c3578d0b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.dist-info/top_level.txt
@@ -0,0 +1 @@
+urllib3
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3-1.25.8.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..9bd8323f91e8daf72b841633f4706a0167c37330
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/__init__.py
@@ -0,0 +1,86 @@
+"""
+urllib3 - Thread-safe connection pooling and re-using.
+"""
+from __future__ import absolute_import
+import warnings
+
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url
+
+from . import exceptions
+from .filepost import encode_multipart_formdata
+from .poolmanager import PoolManager, ProxyManager, proxy_from_url
+from .response import HTTPResponse
+from .util.request import make_headers
+from .util.url import get_host
+from .util.timeout import Timeout
+from .util.retry import Retry
+
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+from logging import NullHandler
+
+__author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
+__license__ = "MIT"
+__version__ = "1.25.8"
+
+__all__ = (
+    "HTTPConnectionPool",
+    "HTTPSConnectionPool",
+    "PoolManager",
+    "ProxyManager",
+    "HTTPResponse",
+    "Retry",
+    "Timeout",
+    "add_stderr_logger",
+    "connection_from_url",
+    "disable_warnings",
+    "encode_multipart_formdata",
+    "get_host",
+    "make_headers",
+    "proxy_from_url",
+)
+
+logging.getLogger(__name__).addHandler(NullHandler())
+
+
+def add_stderr_logger(level=logging.DEBUG):
+    """
+    Helper for quickly adding a StreamHandler to the logger. Useful for
+    debugging.
+
+    Returns the handler after adding it.
+    """
+    # This method needs to be in this __init__.py to get the __name__ correct
+    # even if urllib3 is vendored within another package.
+    logger = logging.getLogger(__name__)
+    handler = logging.StreamHandler()
+    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s"))
+    logger.addHandler(handler)
+    logger.setLevel(level)
+    logger.debug("Added a stderr logging handler to logger: %s", __name__)
+    return handler
+
+
+# ... Clean up.
+del NullHandler
+
+
+# All warning filters *must* be appended unless you're really certain that they
+# shouldn't be: otherwise, it's very hard for users to use most Python
+# mechanisms to silence them.
+# SecurityWarning's always go off by default.
+warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
+# SubjectAltNameWarning's should go off once per host
+warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
+# InsecurePlatformWarning's don't vary between requests, so we keep it default.
+warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
+# SNIMissingWarnings should go off only once.
+warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)
+
+
+def disable_warnings(category=exceptions.HTTPWarning):
+    """
+    Helper for quickly disabling all urllib3 warnings.
+    """
+    warnings.simplefilter("ignore", category)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/_collections.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/_collections.py
new file mode 100644
index 0000000000000000000000000000000000000000..b84a0ffa9cb11643bda0a0859b9f2f3474a996ae
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/_collections.py
@@ -0,0 +1,336 @@
+from __future__ import absolute_import
+
+try:
+    from collections.abc import Mapping, MutableMapping
+except ImportError:
+    from collections import Mapping, MutableMapping
+try:
+    from threading import RLock
+except ImportError:  # Platform-specific: No threads available
+
+    class RLock:
+        def __enter__(self):
+            pass
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            pass
+
+
+from collections import OrderedDict
+from .exceptions import InvalidHeader
+from six import iterkeys, itervalues, PY3
+
+
+__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]
+
+
+_Null = object()
+
+
+class RecentlyUsedContainer(MutableMapping):
+    """
+    Provides a thread-safe dict-like container which maintains up to
+    ``maxsize`` keys while throwing away the least-recently-used keys beyond
+    ``maxsize``.
+
+    :param maxsize:
+        Maximum number of recent elements to retain.
+
+    :param dispose_func:
+        Every time an item is evicted from the container,
+        ``dispose_func(value)`` is called.  Callback which will get called
+    """
+
+    ContainerCls = OrderedDict
+
+    def __init__(self, maxsize=10, dispose_func=None):
+        self._maxsize = maxsize
+        self.dispose_func = dispose_func
+
+        self._container = self.ContainerCls()
+        self.lock = RLock()
+
+    def __getitem__(self, key):
+        # Re-insert the item, moving it to the end of the eviction line.
+        with self.lock:
+            item = self._container.pop(key)
+            self._container[key] = item
+            return item
+
+    def __setitem__(self, key, value):
+        evicted_value = _Null
+        with self.lock:
+            # Possibly evict the existing value of 'key'
+            evicted_value = self._container.get(key, _Null)
+            self._container[key] = value
+
+            # If we didn't evict an existing value, we might have to evict the
+            # least recently used item from the beginning of the container.
+            if len(self._container) > self._maxsize:
+                _key, evicted_value = self._container.popitem(last=False)
+
+        if self.dispose_func and evicted_value is not _Null:
+            self.dispose_func(evicted_value)
+
+    def __delitem__(self, key):
+        with self.lock:
+            value = self._container.pop(key)
+
+        if self.dispose_func:
+            self.dispose_func(value)
+
+    def __len__(self):
+        with self.lock:
+            return len(self._container)
+
+    def __iter__(self):
+        raise NotImplementedError(
+            "Iteration over this class is unlikely to be threadsafe."
+        )
+
+    def clear(self):
+        with self.lock:
+            # Copy pointers to all values, then wipe the mapping
+            values = list(itervalues(self._container))
+            self._container.clear()
+
+        if self.dispose_func:
+            for value in values:
+                self.dispose_func(value)
+
+    def keys(self):
+        with self.lock:
+            return list(iterkeys(self._container))
+
+
+class HTTPHeaderDict(MutableMapping):
+    """
+    :param headers:
+        An iterable of field-value pairs. Must not contain multiple field names
+        when compared case-insensitively.
+
+    :param kwargs:
+        Additional field-value pairs to pass in to ``dict.update``.
+
+    A ``dict`` like container for storing HTTP Headers.
+
+    Field names are stored and compared case-insensitively in compliance with
+    RFC 7230. Iteration provides the first case-sensitive key seen for each
+    case-insensitive pair.
+
+    Using ``__setitem__`` syntax overwrites fields that compare equal
+    case-insensitively in order to maintain ``dict``'s api. For fields that
+    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
+    in a loop.
+
+    If multiple fields that are equal case-insensitively are passed to the
+    constructor or ``.update``, the behavior is undefined and some will be
+    lost.
+
+    >>> headers = HTTPHeaderDict()
+    >>> headers.add('Set-Cookie', 'foo=bar')
+    >>> headers.add('set-cookie', 'baz=quxx')
+    >>> headers['content-length'] = '7'
+    >>> headers['SET-cookie']
+    'foo=bar, baz=quxx'
+    >>> headers['Content-Length']
+    '7'
+    """
+
+    def __init__(self, headers=None, **kwargs):
+        super(HTTPHeaderDict, self).__init__()
+        self._container = OrderedDict()
+        if headers is not None:
+            if isinstance(headers, HTTPHeaderDict):
+                self._copy_from(headers)
+            else:
+                self.extend(headers)
+        if kwargs:
+            self.extend(kwargs)
+
+    def __setitem__(self, key, val):
+        self._container[key.lower()] = [key, val]
+        return self._container[key.lower()]
+
+    def __getitem__(self, key):
+        val = self._container[key.lower()]
+        return ", ".join(val[1:])
+
+    def __delitem__(self, key):
+        del self._container[key.lower()]
+
+    def __contains__(self, key):
+        return key.lower() in self._container
+
+    def __eq__(self, other):
+        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
+            return False
+        if not isinstance(other, type(self)):
+            other = type(self)(other)
+        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
+            (k.lower(), v) for k, v in other.itermerged()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    if not PY3:  # Python 2
+        iterkeys = MutableMapping.iterkeys
+        itervalues = MutableMapping.itervalues
+
+    __marker = object()
+
+    def __len__(self):
+        return len(self._container)
+
+    def __iter__(self):
+        # Only provide the originally cased names
+        for vals in self._container.values():
+            yield vals[0]
+
+    def pop(self, key, default=__marker):
+        """D.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+          If key is not found, d is returned if given, otherwise KeyError is raised.
+        """
+        # Using the MutableMapping function directly fails due to the private marker.
+        # Using ordinary dict.pop would expose the internal structures.
+        # So let's reinvent the wheel.
+        try:
+            value = self[key]
+        except KeyError:
+            if default is self.__marker:
+                raise
+            return default
+        else:
+            del self[key]
+            return value
+
+    def discard(self, key):
+        try:
+            del self[key]
+        except KeyError:
+            pass
+
+    def add(self, key, val):
+        """Adds a (name, value) pair, doesn't overwrite the value if it already
+        exists.
+
+        >>> headers = HTTPHeaderDict(foo='bar')
+        >>> headers.add('Foo', 'baz')
+        >>> headers['foo']
+        'bar, baz'
+        """
+        key_lower = key.lower()
+        new_vals = [key, val]
+        # Keep the common case aka no item present as fast as possible
+        vals = self._container.setdefault(key_lower, new_vals)
+        if new_vals is not vals:
+            vals.append(val)
+
+    def extend(self, *args, **kwargs):
+        """Generic import function for any type of header-like object.
+        Adapted version of MutableMapping.update in order to insert items
+        with self.add instead of self.__setitem__
+        """
+        if len(args) > 1:
+            raise TypeError(
+                "extend() takes at most 1 positional "
+                "arguments ({0} given)".format(len(args))
+            )
+        other = args[0] if len(args) >= 1 else ()
+
+        if isinstance(other, HTTPHeaderDict):
+            for key, val in other.iteritems():
+                self.add(key, val)
+        elif isinstance(other, Mapping):
+            for key in other:
+                self.add(key, other[key])
+        elif hasattr(other, "keys"):
+            for key in other.keys():
+                self.add(key, other[key])
+        else:
+            for key, value in other:
+                self.add(key, value)
+
+        for key, value in kwargs.items():
+            self.add(key, value)
+
+    def getlist(self, key, default=__marker):
+        """Returns a list of all the values for the named field. Returns an
+        empty list if the key doesn't exist."""
+        try:
+            vals = self._container[key.lower()]
+        except KeyError:
+            if default is self.__marker:
+                return []
+            return default
+        else:
+            return vals[1:]
+
+    # Backwards compatibility for httplib
+    getheaders = getlist
+    getallmatchingheaders = getlist
+    iget = getlist
+
+    # Backwards compatibility for http.cookiejar
+    get_all = getlist
+
+    def __repr__(self):
+        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))
+
+    def _copy_from(self, other):
+        for key in other:
+            val = other.getlist(key)
+            if isinstance(val, list):
+                # Don't need to convert tuples
+                val = list(val)
+            self._container[key.lower()] = [key] + val
+
+    def copy(self):
+        clone = type(self)()
+        clone._copy_from(self)
+        return clone
+
+    def iteritems(self):
+        """Iterate over all header lines, including duplicate ones."""
+        for key in self:
+            vals = self._container[key.lower()]
+            for val in vals[1:]:
+                yield vals[0], val
+
+    def itermerged(self):
+        """Iterate over all headers, merging duplicate ones together."""
+        for key in self:
+            val = self._container[key.lower()]
+            yield val[0], ", ".join(val[1:])
+
+    def items(self):
+        return list(self.iteritems())
+
+    @classmethod
+    def from_httplib(cls, message):  # Python 2
+        """Read headers from a Python 2 httplib message object."""
+        # python2.7 does not expose a proper API for exporting multiheaders
+        # efficiently. This function re-reads raw lines from the message
+        # object and extracts the multiheaders properly.
+        obs_fold_continued_leaders = (" ", "\t")
+        headers = []
+
+        for line in message.headers:
+            if line.startswith(obs_fold_continued_leaders):
+                if not headers:
+                    # We received a header line that starts with OWS as described
+                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
+                    # there exists no previous header to which we can attach it.
+                    raise InvalidHeader(
+                        "Header continuation with no previous header: %s" % line
+                    )
+                else:
+                    key, value = headers[-1]
+                    headers[-1] = (key, value + " " + line.strip())
+                    continue
+
+            key, value = line.split(":", 1)
+            headers.append((key, value.strip()))
+
+        return cls(headers)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connection.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a503338ccf8f6d5138499247d22b6247004aaed
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connection.py
@@ -0,0 +1,428 @@
+from __future__ import absolute_import
+import re
+import datetime
+import logging
+import os
+import socket
+from socket import error as SocketError, timeout as SocketTimeout
+import warnings
+import six
+from six.moves.http_client import HTTPConnection as _HTTPConnection
+from six.moves.http_client import HTTPException  # noqa: F401
+
+try:  # Compiled with SSL?
+    import ssl
+
+    BaseSSLError = ssl.SSLError
+except (ImportError, AttributeError):  # Platform-specific: No SSL.
+    ssl = None
+
+    class BaseSSLError(BaseException):
+        pass
+
+
+try:
+    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
+    ConnectionError = ConnectionError
+except NameError:
+    # Python 2
+    class ConnectionError(Exception):
+        pass
+
+
+from .exceptions import (
+    NewConnectionError,
+    ConnectTimeoutError,
+    SubjectAltNameWarning,
+    SystemTimeWarning,
+)
+from .packages.ssl_match_hostname import match_hostname, CertificateError
+
+from .util.ssl_ import (
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    assert_fingerprint,
+    create_urllib3_context,
+    ssl_wrap_socket,
+)
+
+
+from .util import connection
+
+from ._collections import HTTPHeaderDict
+
+log = logging.getLogger(__name__)
+
+port_by_scheme = {"http": 80, "https": 443}
+
+# When it comes time to update this value as a part of regular maintenance
+# (ie test_recent_date is failing) update it to ~6 months before the current date.
+RECENT_DATE = datetime.date(2019, 1, 1)
+
+_CONTAINS_CONTROL_CHAR_RE = re.compile(r"[^-!#$%&'*+.^_`|~0-9a-zA-Z]")
+
+
+class DummyConnection(object):
+    """Used to detect a failed ConnectionCls import."""
+
+    pass
+
+
+class HTTPConnection(_HTTPConnection, object):
+    """
+    Based on httplib.HTTPConnection but provides an extra constructor
+    backwards-compatibility layer between older and newer Pythons.
+
+    Additional keyword parameters are used to configure attributes of the connection.
+    Accepted parameters include:
+
+      - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
+      - ``source_address``: Set the source address for the current connection.
+      - ``socket_options``: Set specific options on the underlying socket. If not specified, then
+        defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
+        Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.
+
+        For example, if you wish to enable TCP Keep Alive in addition to the defaults,
+        you might pass::
+
+            HTTPConnection.default_socket_options + [
+                (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
+            ]
+
+        Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
+    """
+
+    default_port = port_by_scheme["http"]
+
+    #: Disable Nagle's algorithm by default.
+    #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
+    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]
+
+    #: Whether this connection verifies the host's certificate.
+    is_verified = False
+
+    def __init__(self, *args, **kw):
+        if not six.PY2:
+            kw.pop("strict", None)
+
+        # Pre-set source_address.
+        self.source_address = kw.get("source_address")
+
+        #: The socket options provided by the user. If no options are
+        #: provided, we use the default options.
+        self.socket_options = kw.pop("socket_options", self.default_socket_options)
+
+        _HTTPConnection.__init__(self, *args, **kw)
+
+    @property
+    def host(self):
+        """
+        Getter method to remove any trailing dots that indicate the hostname is an FQDN.
+
+        In general, SSL certificates don't include the trailing dot indicating a
+        fully-qualified domain name, and thus, they don't validate properly when
+        checked against a domain name that includes the dot. In addition, some
+        servers may not expect to receive the trailing dot when provided.
+
+        However, the hostname with trailing dot is critical to DNS resolution; doing a
+        lookup with the trailing dot will properly only resolve the appropriate FQDN,
+        whereas a lookup without a trailing dot will search the system's search domain
+        list. Thus, it's important to keep the original host around for use only in
+        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
+        actual TCP connection across which we're going to send HTTP requests).
+        """
+        return self._dns_host.rstrip(".")
+
+    @host.setter
+    def host(self, value):
+        """
+        Setter for the `host` property.
+
+        We assume that only urllib3 uses the _dns_host attribute; httplib itself
+        only uses `host`, and it seems reasonable that other libraries follow suit.
+        """
+        self._dns_host = value
+
+    def _new_conn(self):
+        """ Establish a socket connection and set nodelay settings on it.
+
+        :return: New socket connection.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = connection.create_connection(
+                (self._dns_host, self.port), self.timeout, **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except SocketError as e:
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+    def _prepare_conn(self, conn):
+        self.sock = conn
+        # Google App Engine's httplib does not define _tunnel_host
+        if getattr(self, "_tunnel_host", None):
+            # TODO: Fix tunnel so it doesn't depend on self.sock state.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+    def connect(self):
+        conn = self._new_conn()
+        self._prepare_conn(conn)
+
+    def putrequest(self, method, url, *args, **kwargs):
+        """Send a request to the server"""
+        match = _CONTAINS_CONTROL_CHAR_RE.search(method)
+        if match:
+            raise ValueError(
+                "Method cannot contain non-token characters %r (found at least %r)"
+                % (method, match.group())
+            )
+
+        return _HTTPConnection.putrequest(self, method, url, *args, **kwargs)
+
+    def request_chunked(self, method, url, body=None, headers=None):
+        """
+        Alternative to the common request method, which sends the
+        body with chunked encoding and not as one block
+        """
+        headers = HTTPHeaderDict(headers if headers is not None else {})
+        skip_accept_encoding = "accept-encoding" in headers
+        skip_host = "host" in headers
+        self.putrequest(
+            method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
+        )
+        for header, value in headers.items():
+            self.putheader(header, value)
+        if "transfer-encoding" not in headers:
+            self.putheader("Transfer-Encoding", "chunked")
+        self.endheaders()
+
+        if body is not None:
+            stringish_types = six.string_types + (bytes,)
+            if isinstance(body, stringish_types):
+                body = (body,)
+            for chunk in body:
+                if not chunk:
+                    continue
+                if not isinstance(chunk, bytes):
+                    chunk = chunk.encode("utf8")
+                len_str = hex(len(chunk))[2:]
+                self.send(len_str.encode("utf-8"))
+                self.send(b"\r\n")
+                self.send(chunk)
+                self.send(b"\r\n")
+
+        # After the if clause, to always have a closed body
+        self.send(b"0\r\n\r\n")
+
+
+class HTTPSConnection(HTTPConnection):
+    default_port = port_by_scheme["https"]
+
+    ssl_version = None
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        key_file=None,
+        cert_file=None,
+        key_password=None,
+        strict=None,
+        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+        ssl_context=None,
+        server_hostname=None,
+        **kw
+    ):
+
+        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.key_password = key_password
+        self.ssl_context = ssl_context
+        self.server_hostname = server_hostname
+
+        # Required property for Google AppEngine 1.9.0 which otherwise causes
+        # HTTPS requests to go out as HTTP. (See Issue #356)
+        self._protocol = "https"
+
+
+class VerifiedHTTPSConnection(HTTPSConnection):
+    """
+    Based on httplib.HTTPSConnection but wraps the socket with
+    SSL certification.
+    """
+
+    cert_reqs = None
+    ca_certs = None
+    ca_cert_dir = None
+    ssl_version = None
+    assert_fingerprint = None
+
+    def set_cert(
+        self,
+        key_file=None,
+        cert_file=None,
+        cert_reqs=None,
+        key_password=None,
+        ca_certs=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+    ):
+        """
+        This method should only be called once, before the connection is used.
+        """
+        # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
+        # have an SSLContext object in which case we'll use its verify_mode.
+        if cert_reqs is None:
+            if self.ssl_context is not None:
+                cert_reqs = self.ssl_context.verify_mode
+            else:
+                cert_reqs = resolve_cert_reqs(None)
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
+        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)
+
+    def connect(self):
+        # Add certificate verification
+        conn = self._new_conn()
+        hostname = self.host
+
+        # Google App Engine's httplib does not define _tunnel_host
+        if getattr(self, "_tunnel_host", None):
+            self.sock = conn
+            # Calls self._set_hostport(), so self.host is
+            # self._tunnel_host below.
+            self._tunnel()
+            # Mark this connection as not reusable
+            self.auto_open = 0
+
+            # Override the host with the one we're requesting data from.
+            hostname = self._tunnel_host
+
+        server_hostname = hostname
+        if self.server_hostname is not None:
+            server_hostname = self.server_hostname
+
+        is_time_off = datetime.date.today() < RECENT_DATE
+        if is_time_off:
+            warnings.warn(
+                (
+                    "System time is way off (before {0}). This will probably "
+                    "lead to SSL verification errors"
+                ).format(RECENT_DATE),
+                SystemTimeWarning,
+            )
+
+        # Wrap socket using verification with the root certs in
+        # trusted_root_certs
+        default_ssl_context = False
+        if self.ssl_context is None:
+            default_ssl_context = True
+            self.ssl_context = create_urllib3_context(
+                ssl_version=resolve_ssl_version(self.ssl_version),
+                cert_reqs=resolve_cert_reqs(self.cert_reqs),
+            )
+
+        context = self.ssl_context
+        context.verify_mode = resolve_cert_reqs(self.cert_reqs)
+
+        # Try to load OS default certs if none are given.
+        # Works well on Windows (requires Python3.4+)
+        if (
+            not self.ca_certs
+            and not self.ca_cert_dir
+            and default_ssl_context
+            and hasattr(context, "load_default_certs")
+        ):
+            context.load_default_certs()
+
+        self.sock = ssl_wrap_socket(
+            sock=conn,
+            keyfile=self.key_file,
+            certfile=self.cert_file,
+            key_password=self.key_password,
+            ca_certs=self.ca_certs,
+            ca_cert_dir=self.ca_cert_dir,
+            server_hostname=server_hostname,
+            ssl_context=context,
+        )
+
+        if self.assert_fingerprint:
+            assert_fingerprint(
+                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
+            )
+        elif (
+            context.verify_mode != ssl.CERT_NONE
+            and not getattr(context, "check_hostname", False)
+            and self.assert_hostname is not False
+        ):
+            # While urllib3 attempts to always turn off hostname matching from
+            # the TLS library, this cannot always be done. So we check whether
+            # the TLS Library still thinks it's matching hostnames.
+            cert = self.sock.getpeercert()
+            if not cert.get("subjectAltName", ()):
+                warnings.warn(
+                    (
+                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
+                        "`commonName` for now. This feature is being removed by major browsers and "
+                        "deprecated by RFC 2818. (See https://github.com/urllib3/urllib3/issues/497 "
+                        "for details.)".format(hostname)
+                    ),
+                    SubjectAltNameWarning,
+                )
+            _match_hostname(cert, self.assert_hostname or server_hostname)
+
+        self.is_verified = (
+            context.verify_mode == ssl.CERT_REQUIRED
+            or self.assert_fingerprint is not None
+        )
+
+
+def _match_hostname(cert, asserted_hostname):
+    try:
+        match_hostname(cert, asserted_hostname)
+    except CertificateError as e:
+        log.warning(
+            "Certificate did not match expected hostname: %s. Certificate: %s",
+            asserted_hostname,
+            cert,
+        )
+        # Add cert to exception and reraise so client code can inspect
+        # the cert when catching the exception, if they want to
+        e._peer_cert = cert
+        raise
+
+
+if ssl:
+    # Make a copy for testing.
+    UnverifiedHTTPSConnection = HTTPSConnection
+    HTTPSConnection = VerifiedHTTPSConnection
+else:
+    HTTPSConnection = DummyConnection
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connectionpool.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connectionpool.py
new file mode 100644
index 0000000000000000000000000000000000000000..d42384ee1afe7ea8543fb95bf19160b270447368
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/connectionpool.py
@@ -0,0 +1,1053 @@
+from __future__ import absolute_import
+import errno
+import logging
+import sys
+import warnings
+
+from socket import error as SocketError, timeout as SocketTimeout
+import socket
+
+
+from .exceptions import (
+    ClosedPoolError,
+    ProtocolError,
+    EmptyPoolError,
+    HeaderParsingError,
+    HostChangedError,
+    LocationValueError,
+    MaxRetryError,
+    ProxyError,
+    ReadTimeoutError,
+    SSLError,
+    TimeoutError,
+    InsecureRequestWarning,
+    NewConnectionError,
+)
+from .packages.ssl_match_hostname import CertificateError
+import six
+from six.moves import queue
+from .connection import (
+    port_by_scheme,
+    DummyConnection,
+    HTTPConnection,
+    HTTPSConnection,
+    VerifiedHTTPSConnection,
+    HTTPException,
+    BaseSSLError,
+)
+from .request import RequestMethods
+from .response import HTTPResponse
+
+from .util.connection import is_connection_dropped
+from .util.request import set_file_position
+from .util.response import assert_header_parsing
+from .util.retry import Retry
+from .util.timeout import Timeout
+from .util.url import (
+    get_host,
+    parse_url,
+    Url,
+    _normalize_host as normalize_host,
+    _encode_target,
+)
+from .util.queue import LifoQueue
+
+
+xrange = six.moves.xrange
+
+log = logging.getLogger(__name__)
+
+_Default = object()
+
+
+# Pool objects
+class ConnectionPool(object):
+    """
+    Base class for all connection pools, such as
+    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
+    """
+
+    scheme = None
+    QueueCls = LifoQueue
+
+    def __init__(self, host, port=None):
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        self.host = _normalize_host(host, scheme=self.scheme)
+        self._proxy_host = host.lower()
+        self.port = port
+
+    def __str__(self):
+        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        pass
+
+
+# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
+_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}
+
+
+class HTTPConnectionPool(ConnectionPool, RequestMethods):
+    """
+    Thread-safe connection pool for one host.
+
+    :param host:
+        Host used for this HTTP Connection (e.g. "localhost"), passed into
+        :class:`httplib.HTTPConnection`.
+
+    :param port:
+        Port used for this HTTP Connection (None is equivalent to 80), passed
+        into :class:`httplib.HTTPConnection`.
+
+    :param strict:
+        Causes BadStatusLine to be raised if the status line can't be parsed
+        as a valid HTTP/1.0 or 1.1 status line, passed into
+        :class:`httplib.HTTPConnection`.
+
+        .. note::
+           Only works in Python 2. This parameter is ignored in Python 3.
+
+    :param timeout:
+        Socket timeout in seconds for each individual connection. This can
+        be a float or integer, which sets the timeout for the HTTP request,
+        or an instance of :class:`urllib3.util.Timeout` which gives you more
+        fine-grained control over request timeouts. After the constructor has
+        been parsed, this is always a `urllib3.util.Timeout` object.
+
+    :param maxsize:
+        Number of connections to save that can be reused. More than 1 is useful
+        in multithreaded situations. If ``block`` is set to False, more
+        connections will be created but they will not be saved once they've
+        been used.
+
+    :param block:
+        If set to True, no more than ``maxsize`` connections will be used at
+        a time. When no free connections are available, the call will block
+        until a connection has been released. This is a useful side effect for
+        particular multithreaded situations where one does not want to use more
+        than maxsize connections per host to prevent flooding.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param retries:
+        Retry configuration to use by default with requests in this pool.
+
+    :param _proxy:
+        Parsed proxy URL, should not be used directly, instead, see
+        :class:`urllib3.connectionpool.ProxyManager`"
+
+    :param _proxy_headers:
+        A dictionary with proxy headers, should not be used directly,
+        instead, see :class:`urllib3.connectionpool.ProxyManager`"
+
+    :param \\**conn_kw:
+        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
+        :class:`urllib3.connection.HTTPSConnection` instances.
+    """
+
+    scheme = "http"
+    ConnectionCls = HTTPConnection
+    ResponseCls = HTTPResponse
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        **conn_kw
+    ):
+        ConnectionPool.__init__(self, host, port)
+        RequestMethods.__init__(self, headers)
+
+        self.strict = strict
+
+        if not isinstance(timeout, Timeout):
+            timeout = Timeout.from_float(timeout)
+
+        if retries is None:
+            retries = Retry.DEFAULT
+
+        self.timeout = timeout
+        self.retries = retries
+
+        self.pool = self.QueueCls(maxsize)
+        self.block = block
+
+        self.proxy = _proxy
+        self.proxy_headers = _proxy_headers or {}
+
+        # Fill the queue up so that doing get() on it will block properly
+        for _ in xrange(maxsize):
+            self.pool.put(None)
+
+        # These are mostly for testing and debugging purposes.
+        self.num_connections = 0
+        self.num_requests = 0
+        self.conn_kw = conn_kw
+
+        if self.proxy:
+            # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
+            # We cannot know if the user has added default socket options, so we cannot replace the
+            # list.
+            self.conn_kw.setdefault("socket_options", [])
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`HTTPConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTP connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "80",
+        )
+
+        conn = self.ConnectionCls(
+            host=self.host,
+            port=self.port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            **self.conn_kw
+        )
+        return conn
+
+    def _get_conn(self, timeout=None):
+        """
+        Get a connection. Will return a pooled connection if one is available.
+
+        If no connections are available and :prop:`.block` is ``False``, then a
+        fresh connection is returned.
+
+        :param timeout:
+            Seconds to wait before giving up and raising
+            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
+            :prop:`.block` is ``True``.
+        """
+        conn = None
+        try:
+            conn = self.pool.get(block=self.block, timeout=timeout)
+
+        except AttributeError:  # self.pool is None
+            raise ClosedPoolError(self, "Pool is closed.")
+
+        except queue.Empty:
+            if self.block:
+                raise EmptyPoolError(
+                    self,
+                    "Pool reached maximum size and no more connections are allowed.",
+                )
+            pass  # Oh well, we'll create a new connection then
+
+        # If this is a persistent connection, check if it got disconnected
+        if conn and is_connection_dropped(conn):
+            log.debug("Resetting dropped connection: %s", self.host)
+            conn.close()
+            if getattr(conn, "auto_open", 1) == 0:
+                # This is a proxied connection that has been mutated by
+                # httplib._tunnel() and cannot be reused (since it would
+                # attempt to bypass the proxy)
+                conn = None
+
+        return conn or self._new_conn()
+
+    def _put_conn(self, conn):
+        """
+        Put a connection back into the pool.
+
+        :param conn:
+            Connection object for the current host and port as returned by
+            :meth:`._new_conn` or :meth:`._get_conn`.
+
+        If the pool is already full, the connection is closed and discarded
+        because we exceeded maxsize. If connections are discarded frequently,
+        then maxsize should be increased.
+
+        If the pool is closed, then the connection will be closed and discarded.
+        """
+        try:
+            self.pool.put(conn, block=False)
+            return  # Everything is dandy, done.
+        except AttributeError:
+            # self.pool is None.
+            pass
+        except queue.Full:
+            # This should never happen if self.block == True
+            log.warning("Connection pool is full, discarding connection: %s", self.host)
+
+        # Connection never got put back into the pool, close it.
+        if conn:
+            conn.close()
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        pass
+
+    def _prepare_proxy(self, conn):
+        # Nothing to do for HTTP connections.
+        pass
+
+    def _get_timeout(self, timeout):
+        """ Helper that always returns a :class:`urllib3.util.Timeout` """
+        if timeout is _Default:
+            return self.timeout.clone()
+
+        if isinstance(timeout, Timeout):
+            return timeout.clone()
+        else:
+            # User passed us an int/float. This is for backwards compatibility,
+            # can be removed later
+            return Timeout.from_float(timeout)
+
+    def _raise_timeout(self, err, url, timeout_value):
+        """Is the error actually a timeout? Will raise a ReadTimeout or pass"""
+
+        if isinstance(err, SocketTimeout):
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # See the above comment about EAGAIN in Python 3. In Python 2 we have
+        # to specifically catch it and throw the timeout error
+        if hasattr(err, "errno") and err.errno in _blocking_errnos:
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+        # Catch possible read timeouts thrown as SSL errors. If not the
+        # case, rethrow the original. We need to do this because of:
+        # http://bugs.python.org/issue10272
+        if "timed out" in str(err) or "did not complete (read)" in str(
+            err
+        ):  # Python < 2.7.4
+            raise ReadTimeoutError(
+                self, url, "Read timed out. (read timeout=%s)" % timeout_value
+            )
+
+    def _make_request(
+        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
+    ):
+        """
+        Perform a request on a given urllib connection object taken from our
+        pool.
+
+        :param conn:
+            a connection from one of our connection pools
+
+        :param timeout:
+            Socket timeout in seconds for the request. This can be a
+            float or integer, which will set the same timeout value for
+            the socket connect and the socket read, or an instance of
+            :class:`urllib3.util.Timeout`, which gives you more fine-grained
+            control over your timeouts.
+        """
+        self.num_requests += 1
+
+        timeout_obj = self._get_timeout(timeout)
+        timeout_obj.start_connect()
+        conn.timeout = timeout_obj.connect_timeout
+
+        # Trigger any extra validation we need to do.
+        try:
+            self._validate_conn(conn)
+        except (SocketTimeout, BaseSSLError) as e:
+            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
+            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
+            raise
+
+        # conn.request() calls httplib.*.request, not the method in
+        # urllib3.request. It also calls makefile (recv) on the socket.
+        if chunked:
+            conn.request_chunked(method, url, **httplib_request_kw)
+        else:
+            conn.request(method, url, **httplib_request_kw)
+
+        # Reset the timeout for the recv() on the socket
+        read_timeout = timeout_obj.read_timeout
+
+        # App Engine doesn't have a sock attr
+        if getattr(conn, "sock", None):
+            # In Python 3 socket.py will catch EAGAIN and return None when you
+            # try and read into the file pointer created by http.client, which
+            # instead raises a BadStatusLine exception. Instead of catching
+            # the exception and assuming all BadStatusLine exceptions are read
+            # timeouts, check for a zero timeout before making the request.
+            if read_timeout == 0:
+                raise ReadTimeoutError(
+                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
+                )
+            if read_timeout is Timeout.DEFAULT_TIMEOUT:
+                conn.sock.settimeout(socket.getdefaulttimeout())
+            else:  # None or a value
+                conn.sock.settimeout(read_timeout)
+
+        # Receive the response from the server
+        try:
+            try:
+                # Python 2.7, use buffering of HTTP responses
+                httplib_response = conn.getresponse(buffering=True)
+            except TypeError:
+                # Python 3
+                try:
+                    httplib_response = conn.getresponse()
+                except BaseException as e:
+                    # Remove the TypeError from the exception chain in
+                    # Python 3 (including for exceptions like SystemExit).
+                    # Otherwise it looks like a bug in the code.
+                    six.raise_from(e, None)
+        except (SocketTimeout, BaseSSLError, SocketError) as e:
+            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
+            raise
+
+        # AppEngine doesn't have a version attr.
+        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
+        log.debug(
+            '%s://%s:%s "%s %s %s" %s %s',
+            self.scheme,
+            self.host,
+            self.port,
+            method,
+            url,
+            http_version,
+            httplib_response.status,
+            httplib_response.length,
+        )
+
+        try:
+            assert_header_parsing(httplib_response.msg)
+        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
+            log.warning(
+                "Failed to parse headers (url=%s): %s",
+                self._absolute_url(url),
+                hpe,
+                exc_info=True,
+            )
+
+        return httplib_response
+
+    def _absolute_url(self, path):
+        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url
+
+    def close(self):
+        """
+        Close all pooled connections and disable the pool.
+        """
+        if self.pool is None:
+            return
+        # Disable access to the pool
+        old_pool, self.pool = self.pool, None
+
+        try:
+            while True:
+                conn = old_pool.get(block=False)
+                if conn:
+                    conn.close()
+
+        except queue.Empty:
+            pass  # Done.
+
+    def is_same_host(self, url):
+        """
+        Check if the given ``url`` is a member of the same host as this
+        connection pool.
+        """
+        if url.startswith("/"):
+            return True
+
+        # TODO: Add optional support for socket.gethostbyname checking.
+        scheme, host, port = get_host(url)
+        if host is not None:
+            host = _normalize_host(host, scheme=scheme)
+
+        # Use explicit default port for comparison when none is given
+        if self.port and not port:
+            port = port_by_scheme.get(scheme)
+        elif not self.port and port == port_by_scheme.get(scheme):
+            port = None
+
+        return (scheme, host, port) == (self.scheme, self.host, self.port)
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        assert_same_host=True,
+        timeout=_Default,
+        pool_timeout=None,
+        release_conn=None,
+        chunked=False,
+        body_pos=None,
+        **response_kw
+    ):
+        """
+        Get a connection from the pool and perform an HTTP request. This is the
+        lowest level call for making a request, so you'll need to specify all
+        the raw details.
+
+        .. note::
+
+           More commonly, it's appropriate to use a convenience method provided
+           by :class:`.RequestMethods`, such as :meth:`request`.
+
+        .. note::
+
+           `release_conn` will only behave as expected if
+           `preload_content=False` because we want to make
+           `preload_content=False` the default behaviour someday soon without
+           breaking backwards compatibility.
+
+        :param method:
+            HTTP request method (such as GET, POST, PUT, etc.)
+
+        :param body:
+            Data to send in the request body (useful for creating
+            POST requests, see HTTPConnectionPool.post_url for
+            more convenience).
+
+        :param headers:
+            Dictionary of custom headers to send, such as User-Agent,
+            If-None-Match, etc. If None, pool headers are used. If provided,
+            these headers completely replace any pool-specific headers.
+
+        :param retries:
+            Configure the number of retries to allow before raising a
+            :class:`~urllib3.exceptions.MaxRetryError` exception.
+
+            Pass ``None`` to retry until you receive a response. Pass a
+            :class:`~urllib3.util.retry.Retry` object for fine-grained control
+            over different types of retries.
+            Pass an integer number to retry connection errors that many times,
+            but no other types of errors. Pass zero to never retry.
+
+            If ``False``, then retries are disabled and any exception is raised
+            immediately. Also, instead of raising a MaxRetryError on redirects,
+            the redirect response will be returned.
+
+        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.
+
+        :param redirect:
+            If True, automatically handle redirects (status codes 301, 302,
+            303, 307, 308). Each redirect counts as a retry. Disabling retries
+            will disable redirect, too.
+
+        :param assert_same_host:
+            If ``True``, will make sure that the host of the pool requests is
+            consistent else will raise HostChangedError. When False, you can
+            use the pool on an HTTP proxy and request foreign hosts.
+
+        :param timeout:
+            If specified, overrides the default timeout for this one
+            request. It may be a float (in seconds) or an instance of
+            :class:`urllib3.util.Timeout`.
+
+        :param pool_timeout:
+            If set and the pool is set to block=True, then this method will
+            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
+            connection is available within the time period.
+
+        :param release_conn:
+            If False, then the urlopen call will not release the connection
+            back into the pool once a response is received (but will release if
+            you read the entire contents of the response such as when
+            `preload_content=True`). This is useful if you're not preloading
+            the response's content immediately. You will need to call
+            ``r.release_conn()`` on the response ``r`` to return the connection
+            back into the pool. If None, it takes the value of
+            ``response_kw.get('preload_content', True)``.
+
+        :param chunked:
+            If True, urllib3 will send the body using chunked transfer
+            encoding. Otherwise, urllib3 will send the body using the standard
+            content-length form. Defaults to False.
+
+        :param int body_pos:
+            Position to seek to in file-like body in the event of a retry or
+            redirect. Typically this won't need to be set because urllib3 will
+            auto-populate the value when needed.
+
+        :param \\**response_kw:
+            Additional parameters are passed to
+            :meth:`urllib3.response.HTTPResponse.from_httplib`
+        """
+        if headers is None:
+            headers = self.headers
+
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if release_conn is None:
+            release_conn = response_kw.get("preload_content", True)
+
+        # Check host
+        if assert_same_host and not self.is_same_host(url):
+            raise HostChangedError(self, url, retries)
+
+        # Ensure that the URL we're connecting to is properly encoded
+        if url.startswith("/"):
+            url = six.ensure_str(_encode_target(url))
+        else:
+            url = six.ensure_str(parse_url(url).url)
+
+        conn = None
+
+        # Track whether `conn` needs to be released before
+        # returning/raising/recursing. Update this variable if necessary, and
+        # leave `release_conn` constant throughout the function. That way, if
+        # the function recurses, the original value of `release_conn` will be
+        # passed down into the recursive call, and its value will be respected.
+        #
+        # See issue #651 [1] for details.
+        #
+        # [1] <https://github.com/urllib3/urllib3/issues/651>
+        release_this_conn = release_conn
+
+        # Merge the proxy headers. Only do this in HTTP. We have to copy the
+        # headers dict so we can safely change it without those changes being
+        # reflected in anyone else's copy.
+        if self.scheme == "http":
+            headers = headers.copy()
+            headers.update(self.proxy_headers)
+
+        # Must keep the exception bound to a separate variable or else Python 3
+        # complains about UnboundLocalError.
+        err = None
+
+        # Keep track of whether we cleanly exited the except block. This
+        # ensures we do proper cleanup in finally.
+        clean_exit = False
+
+        # Rewind body position, if needed. Record current position
+        # for future rewinds in the event of a redirect/retry.
+        body_pos = set_file_position(body, body_pos)
+
+        try:
+            # Request a connection from the queue.
+            timeout_obj = self._get_timeout(timeout)
+            conn = self._get_conn(timeout=pool_timeout)
+
+            conn.timeout = timeout_obj.connect_timeout
+
+            is_new_proxy_conn = self.proxy is not None and not getattr(
+                conn, "sock", None
+            )
+            if is_new_proxy_conn:
+                self._prepare_proxy(conn)
+
+            # Make the request on the httplib connection object.
+            httplib_response = self._make_request(
+                conn,
+                method,
+                url,
+                timeout=timeout_obj,
+                body=body,
+                headers=headers,
+                chunked=chunked,
+            )
+
+            # If we're going to release the connection in ``finally:``, then
+            # the response doesn't need to know about the connection. Otherwise
+            # it will also try to release it and we'll have a double-release
+            # mess.
+            response_conn = conn if not release_conn else None
+
+            # Pass method to Response for length checking
+            response_kw["request_method"] = method
+
+            # Import httplib's response into our own wrapper object
+            response = self.ResponseCls.from_httplib(
+                httplib_response,
+                pool=self,
+                connection=response_conn,
+                retries=retries,
+                **response_kw
+            )
+
+            # Everything went great!
+            clean_exit = True
+
+        except queue.Empty:
+            # Timed out by queue.
+            raise EmptyPoolError(self, "No pool connections are available.")
+
+        except (
+            TimeoutError,
+            HTTPException,
+            SocketError,
+            ProtocolError,
+            BaseSSLError,
+            SSLError,
+            CertificateError,
+        ) as e:
+            # Discard the connection for these exceptions. It will be
+            # replaced during the next _get_conn() call.
+            clean_exit = False
+            if isinstance(e, (BaseSSLError, CertificateError)):
+                e = SSLError(e)
+            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
+                e = ProxyError("Cannot connect to proxy.", e)
+            elif isinstance(e, (SocketError, HTTPException)):
+                e = ProtocolError("Connection aborted.", e)
+
+            retries = retries.increment(
+                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
+            )
+            retries.sleep()
+
+            # Keep track of the error for the retry warning.
+            err = e
+
+        finally:
+            if not clean_exit:
+                # We hit some kind of exception, handled or otherwise. We need
+                # to throw the connection away unless explicitly told not to.
+                # Close the connection, set the variable to None, and make sure
+                # we put the None back in the pool to avoid leaking it.
+                conn = conn and conn.close()
+                release_this_conn = True
+
+            if release_this_conn:
+                # Put the connection back to be reused. If the connection is
+                # expired then it will be None, which will get replaced with a
+                # fresh connection during _get_conn.
+                self._put_conn(conn)
+
+        if not conn:
+            # Try again
+            log.warning(
+                "Retrying (%r) after connection broken by '%r': %s", retries, err, url
+            )
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries,
+                redirect,
+                assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        def drain_and_release_conn(response):
+            try:
+                # discard any remaining response body, the connection will be
+                # released back to the pool once the entire response is read
+                response.read()
+            except (
+                TimeoutError,
+                HTTPException,
+                SocketError,
+                ProtocolError,
+                BaseSSLError,
+                SSLError,
+            ):
+                pass
+
+        # Handle redirect?
+        redirect_location = redirect and response.get_redirect_location()
+        if redirect_location:
+            if response.status == 303:
+                method = "GET"
+
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_redirect:
+                    # Drain and release the connection for this response, since
+                    # we're not returning it to be released manually.
+                    drain_and_release_conn(response)
+                    raise
+                return response
+
+            # drain and return the connection to the pool before recursing
+            drain_and_release_conn(response)
+
+            retries.sleep_for_retry(response)
+            log.debug("Redirecting %s -> %s", url, redirect_location)
+            return self.urlopen(
+                method,
+                redirect_location,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(response.getheader("Retry-After"))
+        if retries.is_retry(method, response.status, has_retry_after):
+            try:
+                retries = retries.increment(method, url, response=response, _pool=self)
+            except MaxRetryError:
+                if retries.raise_on_status:
+                    # Drain and release the connection for this response, since
+                    # we're not returning it to be released manually.
+                    drain_and_release_conn(response)
+                    raise
+                return response
+
+            # drain and return the connection to the pool before recursing
+            drain_and_release_conn(response)
+
+            retries.sleep(response)
+            log.debug("Retry: %s", url)
+            return self.urlopen(
+                method,
+                url,
+                body,
+                headers,
+                retries=retries,
+                redirect=redirect,
+                assert_same_host=assert_same_host,
+                timeout=timeout,
+                pool_timeout=pool_timeout,
+                release_conn=release_conn,
+                chunked=chunked,
+                body_pos=body_pos,
+                **response_kw
+            )
+
+        return response
+
+
+class HTTPSConnectionPool(HTTPConnectionPool):
+    """
+    Same as :class:`.HTTPConnectionPool`, but HTTPS.
+
+    When Python is compiled with the :mod:`ssl` module, then
+    :class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates,
+    instead of :class:`.HTTPSConnection`.
+
+    :class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``,
+    ``assert_hostname`` and ``host`` in this order to verify connections.
+    If ``assert_hostname`` is False, no verification is done.
+
+    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
+    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
+    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
+    the connection socket into an SSL socket.
+
+    On Debian, SSL certificate validation is required by default
+    """
+
+    scheme = "https"
+    ConnectionCls = HTTPSConnection
+
+    def __init__(
+        self,
+        host,
+        port=None,
+        strict=False,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        maxsize=1,
+        block=False,
+        headers=None,
+        retries=None,
+        _proxy=None,
+        _proxy_headers=None,
+        key_file=None,
+        cert_file=None,
+        cert_reqs='CERT_REQUIRED',
+        key_password=None,
+        ca_certs='/etc/ssl/certs/ca-certificates.crt',
+        ssl_version=None,
+        assert_hostname=None,
+        assert_fingerprint=None,
+        ca_cert_dir=None,
+        **conn_kw
+    ):
+
+        HTTPConnectionPool.__init__(
+            self,
+            host,
+            port,
+            strict,
+            timeout,
+            maxsize,
+            block,
+            headers,
+            retries,
+            _proxy,
+            _proxy_headers,
+            **conn_kw
+        )
+
+        self.key_file = key_file
+        self.cert_file = cert_file
+        self.cert_reqs = cert_reqs
+        self.key_password = key_password
+        self.ca_certs = ca_certs
+        self.ca_cert_dir = ca_cert_dir
+        self.ssl_version = ssl_version
+        self.assert_hostname = assert_hostname
+        self.assert_fingerprint = assert_fingerprint
+
+    def _prepare_conn(self, conn):
+        """
+        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
+        and establish the tunnel if proxy is used.
+        """
+
+        if isinstance(conn, VerifiedHTTPSConnection):
+            conn.set_cert(
+                key_file=self.key_file,
+                key_password=self.key_password,
+                cert_file=self.cert_file,
+                cert_reqs=self.cert_reqs,
+                ca_certs=self.ca_certs,
+                ca_cert_dir=self.ca_cert_dir,
+                assert_hostname=self.assert_hostname,
+                assert_fingerprint=self.assert_fingerprint,
+            )
+            conn.ssl_version = self.ssl_version
+        return conn
+
+    def _prepare_proxy(self, conn):
+        """
+        Establish tunnel connection early, because otherwise httplib
+        would improperly set Host: header to proxy's IP:port.
+        """
+        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
+        conn.connect()
+
+    def _new_conn(self):
+        """
+        Return a fresh :class:`httplib.HTTPSConnection`.
+        """
+        self.num_connections += 1
+        log.debug(
+            "Starting new HTTPS connection (%d): %s:%s",
+            self.num_connections,
+            self.host,
+            self.port or "443",
+        )
+
+        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
+            raise SSLError(
+                "Can't connect to HTTPS URL because the SSL module is not available."
+            )
+
+        actual_host = self.host
+        actual_port = self.port
+        if self.proxy is not None:
+            actual_host = self.proxy.host
+            actual_port = self.proxy.port
+
+        conn = self.ConnectionCls(
+            host=actual_host,
+            port=actual_port,
+            timeout=self.timeout.connect_timeout,
+            strict=self.strict,
+            cert_file=self.cert_file,
+            key_file=self.key_file,
+            key_password=self.key_password,
+            **self.conn_kw
+        )
+
+        return self._prepare_conn(conn)
+
+    def _validate_conn(self, conn):
+        """
+        Called right before a request is made, after the socket is created.
+        """
+        super(HTTPSConnectionPool, self)._validate_conn(conn)
+
+        # Force connect early to allow us to validate the connection.
+        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
+            conn.connect()
+
+        if not conn.is_verified:
+            warnings.warn(
+                (
+                    "Unverified HTTPS request is being made to host '%s'. "
+                    "Adding certificate verification is strongly advised. See: "
+                    "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+                    "#ssl-warnings" % conn.host
+                ),
+                InsecureRequestWarning,
+            )
+
+
+def connection_from_url(url, **kw):
+    """
+    Given a url, return an :class:`.ConnectionPool` instance of its host.
+
+    This is a shortcut for not having to parse out the scheme, host, and port
+    of the url before creating an :class:`.ConnectionPool` instance.
+
+    :param url:
+        Absolute URL string that must include the scheme. Port is optional.
+
+    :param \\**kw:
+        Passes additional parameters to the constructor of the appropriate
+        :class:`.ConnectionPool`. Useful for specifying things like
+        timeout, maxsize, headers, etc.
+
+    Example::
+
+        >>> conn = connection_from_url('http://google.com/')
+        >>> r = conn.request('GET', '/')
+    """
+    scheme, host, port = get_host(url)
+    port = port or port_by_scheme.get(scheme, 80)
+    if scheme == "https":
+        return HTTPSConnectionPool(host, port=port, **kw)
+    else:
+        return HTTPConnectionPool(host, port=port, **kw)
+
+
+def _normalize_host(host, scheme):
+    """
+    Normalize hosts for comparisons and use with sockets.
+    """
+
+    host = normalize_host(host, scheme)
+
+    # httplib doesn't like it when we include brackets in IPv6 addresses
+    # Specifically, if we include brackets but also pass the port then
+    # httplib crazily doubles up the square brackets on the Host header.
+    # Instead, we need to make sure we never pass ``None`` as the port.
+    # However, for backward compatibility reasons we can't actually
+    # *assert* that.  See http://bugs.python.org/issue28539
+    if host.startswith("[") and host.endswith("]"):
+        host = host[1:-1]
+    return host
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_appengine_environ.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 0000000000000000000000000000000000000000..8765b907d70c4a530bc90dc88f24b3df73473b01
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_appengine_environ.py
@@ -0,0 +1,36 @@
+"""
+This module provides means to detect the App Engine environment.
+"""
+
+import os
+
+
+def is_appengine():
+    return is_local_appengine() or is_prod_appengine()
+
+
+def is_appengine_sandbox():
+    """Reports if the app is running in the first generation sandbox.
+
+    The second generation runtimes are technically still in a sandbox, but it
+    is much less restrictive, so generally you shouldn't need to check for it.
+    see https://cloud.google.com/appengine/docs/standard/runtimes
+    """
+    return is_appengine() and os.environ["APPENGINE_RUNTIME"] == "python27"
+
+
+def is_local_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Development/")
+
+
+def is_prod_appengine():
+    return "APPENGINE_RUNTIME" in os.environ and os.environ.get(
+        "SERVER_SOFTWARE", ""
+    ).startswith("Google App Engine/")
+
+
+def is_prod_appengine_mvms():
+    """Deprecated."""
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/bindings.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/bindings.py
new file mode 100644
index 0000000000000000000000000000000000000000..d9b6733318812d4e72b601c770beff4d4ecd6923
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/bindings.py
@@ -0,0 +1,493 @@
+"""
+This module uses ctypes to bind a whole bunch of functions and constants from
+SecureTransport. The goal here is to provide the low-level API to
+SecureTransport. These are essentially the C-level functions and constants, and
+they're pretty gross to work with.
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+    Copyright (c) 2015-2016 Will Bond <will@wbond.net>
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import platform
+from ctypes.util import find_library
+from ctypes import (
+    c_void_p,
+    c_int32,
+    c_char_p,
+    c_size_t,
+    c_byte,
+    c_uint32,
+    c_ulong,
+    c_long,
+    c_bool,
+)
+from ctypes import CDLL, POINTER, CFUNCTYPE
+
+
+security_path = find_library("Security")
+if not security_path:
+    raise ImportError("The library Security could not be found")
+
+
+core_foundation_path = find_library("CoreFoundation")
+if not core_foundation_path:
+    raise ImportError("The library CoreFoundation could not be found")
+
+
+version = platform.mac_ver()[0]
+version_info = tuple(map(int, version.split(".")))
+if version_info < (10, 8):
+    raise OSError(
+        "Only OS X 10.8 and newer are supported, not %s.%s"
+        % (version_info[0], version_info[1])
+    )
+
+Security = CDLL(security_path, use_errno=True)
+CoreFoundation = CDLL(core_foundation_path, use_errno=True)
+
+Boolean = c_bool
+CFIndex = c_long
+CFStringEncoding = c_uint32
+CFData = c_void_p
+CFString = c_void_p
+CFArray = c_void_p
+CFMutableArray = c_void_p
+CFDictionary = c_void_p
+CFError = c_void_p
+CFType = c_void_p
+CFTypeID = c_ulong
+
+CFTypeRef = POINTER(CFType)
+CFAllocatorRef = c_void_p
+
+OSStatus = c_int32
+
+CFDataRef = POINTER(CFData)
+CFStringRef = POINTER(CFString)
+CFArrayRef = POINTER(CFArray)
+CFMutableArrayRef = POINTER(CFMutableArray)
+CFDictionaryRef = POINTER(CFDictionary)
+CFArrayCallBacks = c_void_p
+CFDictionaryKeyCallBacks = c_void_p
+CFDictionaryValueCallBacks = c_void_p
+
+SecCertificateRef = POINTER(c_void_p)
+SecExternalFormat = c_uint32
+SecExternalItemType = c_uint32
+SecIdentityRef = POINTER(c_void_p)
+SecItemImportExportFlags = c_uint32
+SecItemImportExportKeyParameters = c_void_p
+SecKeychainRef = POINTER(c_void_p)
+SSLProtocol = c_uint32
+SSLCipherSuite = c_uint32
+SSLContextRef = POINTER(c_void_p)
+SecTrustRef = POINTER(c_void_p)
+SSLConnectionRef = c_uint32
+SecTrustResultType = c_uint32
+SecTrustOptionFlags = c_uint32
+SSLProtocolSide = c_uint32
+SSLConnectionType = c_uint32
+SSLSessionOption = c_uint32
+
+
+try:
+    Security.SecItemImport.argtypes = [
+        CFDataRef,
+        CFStringRef,
+        POINTER(SecExternalFormat),
+        POINTER(SecExternalItemType),
+        SecItemImportExportFlags,
+        POINTER(SecItemImportExportKeyParameters),
+        SecKeychainRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecItemImport.restype = OSStatus
+
+    Security.SecCertificateGetTypeID.argtypes = []
+    Security.SecCertificateGetTypeID.restype = CFTypeID
+
+    Security.SecIdentityGetTypeID.argtypes = []
+    Security.SecIdentityGetTypeID.restype = CFTypeID
+
+    Security.SecKeyGetTypeID.argtypes = []
+    Security.SecKeyGetTypeID.restype = CFTypeID
+
+    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
+    Security.SecCertificateCreateWithData.restype = SecCertificateRef
+
+    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
+    Security.SecCertificateCopyData.restype = CFDataRef
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SecIdentityCreateWithCertificate.argtypes = [
+        CFTypeRef,
+        SecCertificateRef,
+        POINTER(SecIdentityRef),
+    ]
+    Security.SecIdentityCreateWithCertificate.restype = OSStatus
+
+    Security.SecKeychainCreate.argtypes = [
+        c_char_p,
+        c_uint32,
+        c_void_p,
+        Boolean,
+        c_void_p,
+        POINTER(SecKeychainRef),
+    ]
+    Security.SecKeychainCreate.restype = OSStatus
+
+    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
+    Security.SecKeychainDelete.restype = OSStatus
+
+    Security.SecPKCS12Import.argtypes = [
+        CFDataRef,
+        CFDictionaryRef,
+        POINTER(CFArrayRef),
+    ]
+    Security.SecPKCS12Import.restype = OSStatus
+
+    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
+    SSLWriteFunc = CFUNCTYPE(
+        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
+    )
+
+    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
+    Security.SSLSetIOFuncs.restype = OSStatus
+
+    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerID.restype = OSStatus
+
+    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
+    Security.SSLSetCertificate.restype = OSStatus
+
+    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
+    Security.SSLSetCertificateAuthorities.restype = OSStatus
+
+    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
+    Security.SSLSetConnection.restype = OSStatus
+
+    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
+    Security.SSLSetPeerDomainName.restype = OSStatus
+
+    Security.SSLHandshake.argtypes = [SSLContextRef]
+    Security.SSLHandshake.restype = OSStatus
+
+    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLRead.restype = OSStatus
+
+    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
+    Security.SSLWrite.restype = OSStatus
+
+    Security.SSLClose.argtypes = [SSLContextRef]
+    Security.SSLClose.restype = OSStatus
+
+    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberSupportedCiphers.restype = OSStatus
+
+    Security.SSLGetSupportedCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetSupportedCiphers.restype = OSStatus
+
+    Security.SSLSetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        c_size_t,
+    ]
+    Security.SSLSetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
+    Security.SSLGetNumberEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetEnabledCiphers.argtypes = [
+        SSLContextRef,
+        POINTER(SSLCipherSuite),
+        POINTER(c_size_t),
+    ]
+    Security.SSLGetEnabledCiphers.restype = OSStatus
+
+    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
+    Security.SSLGetNegotiatedCipher.restype = OSStatus
+
+    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
+        SSLContextRef,
+        POINTER(SSLProtocol),
+    ]
+    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus
+
+    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
+    Security.SSLCopyPeerTrust.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
+    Security.SecTrustSetAnchorCertificates.restype = OSStatus
+
+    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
+    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus
+
+    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
+    Security.SecTrustEvaluate.restype = OSStatus
+
+    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
+    Security.SecTrustGetCertificateCount.restype = CFIndex
+
+    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
+    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef
+
+    Security.SSLCreateContext.argtypes = [
+        CFAllocatorRef,
+        SSLProtocolSide,
+        SSLConnectionType,
+    ]
+    Security.SSLCreateContext.restype = SSLContextRef
+
+    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
+    Security.SSLSetSessionOption.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMin.restype = OSStatus
+
+    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
+    Security.SSLSetProtocolVersionMax.restype = OSStatus
+
+    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
+    Security.SecCopyErrorMessageString.restype = CFStringRef
+
+    Security.SSLReadFunc = SSLReadFunc
+    Security.SSLWriteFunc = SSLWriteFunc
+    Security.SSLContextRef = SSLContextRef
+    Security.SSLProtocol = SSLProtocol
+    Security.SSLCipherSuite = SSLCipherSuite
+    Security.SecIdentityRef = SecIdentityRef
+    Security.SecKeychainRef = SecKeychainRef
+    Security.SecTrustRef = SecTrustRef
+    Security.SecTrustResultType = SecTrustResultType
+    Security.SecExternalFormat = SecExternalFormat
+    Security.OSStatus = OSStatus
+
+    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
+        Security, "kSecImportExportPassphrase"
+    )
+    Security.kSecImportItemIdentity = CFStringRef.in_dll(
+        Security, "kSecImportItemIdentity"
+    )
+
+    # CoreFoundation time!
+    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
+    CoreFoundation.CFRetain.restype = CFTypeRef
+
+    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
+    CoreFoundation.CFRelease.restype = None
+
+    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
+    CoreFoundation.CFGetTypeID.restype = CFTypeID
+
+    CoreFoundation.CFStringCreateWithCString.argtypes = [
+        CFAllocatorRef,
+        c_char_p,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef
+
+    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
+    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p
+
+    CoreFoundation.CFStringGetCString.argtypes = [
+        CFStringRef,
+        c_char_p,
+        CFIndex,
+        CFStringEncoding,
+    ]
+    CoreFoundation.CFStringGetCString.restype = c_bool
+
+    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
+    CoreFoundation.CFDataCreate.restype = CFDataRef
+
+    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetLength.restype = CFIndex
+
+    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
+    CoreFoundation.CFDataGetBytePtr.restype = c_void_p
+
+    CoreFoundation.CFDictionaryCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFDictionaryKeyCallBacks,
+        CFDictionaryValueCallBacks,
+    ]
+    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef
+
+    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
+    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef
+
+    CoreFoundation.CFArrayCreate.argtypes = [
+        CFAllocatorRef,
+        POINTER(CFTypeRef),
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreate.restype = CFArrayRef
+
+    CoreFoundation.CFArrayCreateMutable.argtypes = [
+        CFAllocatorRef,
+        CFIndex,
+        CFArrayCallBacks,
+    ]
+    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef
+
+    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
+    CoreFoundation.CFArrayAppendValue.restype = None
+
+    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
+    CoreFoundation.CFArrayGetCount.restype = CFIndex
+
+    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
+    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p
+
+    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
+        CoreFoundation, "kCFAllocatorDefault"
+    )
+    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeArrayCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
+    )
+    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
+        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
+    )
+
+    CoreFoundation.CFTypeRef = CFTypeRef
+    CoreFoundation.CFArrayRef = CFArrayRef
+    CoreFoundation.CFStringRef = CFStringRef
+    CoreFoundation.CFDictionaryRef = CFDictionaryRef
+
+except (AttributeError):
+    raise ImportError("Error initializing ctypes")
+
+
+class CFConst(object):
+    """
+    A class object that acts as essentially a namespace for CoreFoundation
+    constants.
+    """
+
+    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)
+
+
+class SecurityConst(object):
+    """
+    A class object that acts as essentially a namespace for Security constants.
+    """
+
+    kSSLSessionOptionBreakOnServerAuth = 0
+
+    kSSLProtocol2 = 1
+    kSSLProtocol3 = 2
+    kTLSProtocol1 = 4
+    kTLSProtocol11 = 7
+    kTLSProtocol12 = 8
+    # SecureTransport does not support TLS 1.3 even if there's a constant for it
+    kTLSProtocol13 = 10
+    kTLSProtocolMaxSupported = 999
+
+    kSSLClientSide = 1
+    kSSLStreamType = 0
+
+    kSecFormatPEMSequence = 10
+
+    kSecTrustResultInvalid = 0
+    kSecTrustResultProceed = 1
+    # This gap is present on purpose: this was kSecTrustResultConfirm, which
+    # is deprecated.
+    kSecTrustResultDeny = 3
+    kSecTrustResultUnspecified = 4
+    kSecTrustResultRecoverableTrustFailure = 5
+    kSecTrustResultFatalTrustFailure = 6
+    kSecTrustResultOtherError = 7
+
+    errSSLProtocol = -9800
+    errSSLWouldBlock = -9803
+    errSSLClosedGraceful = -9805
+    errSSLClosedNoNotify = -9816
+    errSSLClosedAbort = -9806
+
+    errSSLXCertChainInvalid = -9807
+    errSSLCrypto = -9809
+    errSSLInternal = -9810
+    errSSLCertExpired = -9814
+    errSSLCertNotYetValid = -9815
+    errSSLUnknownRootCert = -9812
+    errSSLNoRootCert = -9813
+    errSSLHostNameMismatch = -9843
+    errSSLPeerHandshakeFail = -9824
+    errSSLPeerUserCancelled = -9839
+    errSSLWeakPeerEphemeralDHKey = -9850
+    errSSLServerAuthCompleted = -9841
+    errSSLRecordOverflow = -9847
+
+    errSecVerifyFailed = -67808
+    errSecNoTrustSettings = -25263
+    errSecItemNotFound = -25300
+    errSecInvalidTrustSettings = -25262
+
+    # Cipher suites. We only pick the ones our default cipher string allows.
+    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
+    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
+    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
+    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
+    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
+    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
+    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
+    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
+    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
+    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
+    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
+    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
+    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
+    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
+    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
+    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
+    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
+    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
+    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
+    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+    TLS_AES_128_GCM_SHA256 = 0x1301
+    TLS_AES_256_GCM_SHA384 = 0x1302
+    TLS_AES_128_CCM_8_SHA256 = 0x1305
+    TLS_AES_128_CCM_SHA256 = 0x1304
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/low_level.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/low_level.py
new file mode 100644
index 0000000000000000000000000000000000000000..e60168cac14d080b45ac693b2ceda1ec59f712b5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/_securetransport/low_level.py
@@ -0,0 +1,328 @@
+"""
+Low-level helpers for the SecureTransport bindings.
+
+These are Python functions that are not directly related to the high-level APIs
+but are necessary to get them to work. They include a whole bunch of low-level
+CoreFoundation messing about and memory management. The concerns in this module
+are almost entirely about trying to avoid memory leaks and providing
+appropriate and useful assistance to the higher-level code.
+"""
+import base64
+import ctypes
+import itertools
+import re
+import os
+import ssl
+import tempfile
+
+from .bindings import Security, CoreFoundation, CFConst
+
+
+# This regular expression is used to grab PEM data out of a PEM bundle.
+_PEM_CERTS_RE = re.compile(
+    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
+)
+
+
+def _cf_data_from_bytes(bytestring):
+    """
+    Given a bytestring, create a CFData object from it. This CFData object must
+    be CFReleased by the caller.
+    """
+    return CoreFoundation.CFDataCreate(
+        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
+    )
+
+
+def _cf_dictionary_from_tuples(tuples):
+    """
+    Given a list of Python tuples, create an associated CFDictionary.
+    """
+    dictionary_size = len(tuples)
+
+    # We need to get the dictionary keys and values out in the same order.
+    keys = (t[0] for t in tuples)
+    values = (t[1] for t in tuples)
+    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
+    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)
+
+    return CoreFoundation.CFDictionaryCreate(
+        CoreFoundation.kCFAllocatorDefault,
+        cf_keys,
+        cf_values,
+        dictionary_size,
+        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
+        CoreFoundation.kCFTypeDictionaryValueCallBacks,
+    )
+
+
+def _cf_string_to_unicode(value):
+    """
+    Creates a Unicode string from a CFString object. Used entirely for error
+    reporting.
+
+    Yes, it annoys me quite a lot that this function is this complex.
+    """
+    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))
+
+    string = CoreFoundation.CFStringGetCStringPtr(
+        value_as_void_p, CFConst.kCFStringEncodingUTF8
+    )
+    if string is None:
+        buffer = ctypes.create_string_buffer(1024)
+        result = CoreFoundation.CFStringGetCString(
+            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
+        )
+        if not result:
+            raise OSError("Error copying C string from CFStringRef")
+        string = buffer.value
+    if string is not None:
+        string = string.decode("utf-8")
+    return string
+
+
+def _assert_no_error(error, exception_class=None):
+    """
+    Checks the return code and throws an exception if there is an error to
+    report
+    """
+    if error == 0:
+        return
+
+    cf_error_string = Security.SecCopyErrorMessageString(error, None)
+    output = _cf_string_to_unicode(cf_error_string)
+    CoreFoundation.CFRelease(cf_error_string)
+
+    if output is None or output == u"":
+        output = u"OSStatus %s" % error
+
+    if exception_class is None:
+        exception_class = ssl.SSLError
+
+    raise exception_class(output)
+
+
+def _cert_array_from_pem(pem_bundle):
+    """
+    Given a bundle of certs in PEM format, turns them into a CFArray of certs
+    that can be used to validate a cert chain.
+    """
+    # Normalize the PEM bundle's line endings.
+    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")
+
+    der_certs = [
+        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
+    ]
+    if not der_certs:
+        raise ssl.SSLError("No root certificates specified")
+
+    cert_array = CoreFoundation.CFArrayCreateMutable(
+        CoreFoundation.kCFAllocatorDefault,
+        0,
+        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+    )
+    if not cert_array:
+        raise ssl.SSLError("Unable to allocate memory!")
+
+    try:
+        for der_bytes in der_certs:
+            certdata = _cf_data_from_bytes(der_bytes)
+            if not certdata:
+                raise ssl.SSLError("Unable to allocate memory!")
+            cert = Security.SecCertificateCreateWithData(
+                CoreFoundation.kCFAllocatorDefault, certdata
+            )
+            CoreFoundation.CFRelease(certdata)
+            if not cert:
+                raise ssl.SSLError("Unable to build cert object!")
+
+            CoreFoundation.CFArrayAppendValue(cert_array, cert)
+            CoreFoundation.CFRelease(cert)
+    except Exception:
+        # We need to free the array before the exception bubbles further.
+        # We only want to do that if an error occurs: otherwise, the caller
+        # should free.
+        CoreFoundation.CFRelease(cert_array)
+
+    return cert_array
+
+
+def _is_cert(item):
+    """
+    Returns True if a given CFTypeRef is a certificate.
+    """
+    expected = Security.SecCertificateGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _is_identity(item):
+    """
+    Returns True if a given CFTypeRef is an identity.
+    """
+    expected = Security.SecIdentityGetTypeID()
+    return CoreFoundation.CFGetTypeID(item) == expected
+
+
+def _temporary_keychain():
+    """
+    This function creates a temporary Mac keychain that we can use to work with
+    credentials. This keychain uses a one-time password and a temporary file to
+    store the data. We expect to have one keychain per socket. The returned
+    SecKeychainRef must be freed by the caller, including calling
+    SecKeychainDelete.
+
+    Returns a tuple of the SecKeychainRef and the path to the temporary
+    directory that contains it.
+    """
+    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
+    # means we cannot use mkstemp to use a generic temporary file. Instead,
+    # we're going to create a temporary directory and a filename to use there.
+    # This filename will be 8 random bytes expanded into base64. We also need
+    # some random bytes to password-protect the keychain we're creating, so we
+    # ask for 40 random bytes.
+    random_bytes = os.urandom(40)
+    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
+    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
+    tempdirectory = tempfile.mkdtemp()
+
+    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")
+
+    # We now want to create the keychain itself.
+    keychain = Security.SecKeychainRef()
+    status = Security.SecKeychainCreate(
+        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
+    )
+    _assert_no_error(status)
+
+    # Having created the keychain, we want to pass it off to the caller.
+    return keychain, tempdirectory
+
+
+def _load_items_from_file(keychain, path):
+    """
+    Given a single file, loads all the trust objects from it into arrays and
+    the keychain.
+    Returns a tuple of lists: the first list is a list of identities, the
+    second a list of certs.
+    """
+    certificates = []
+    identities = []
+    result_array = None
+
+    with open(path, "rb") as f:
+        raw_filedata = f.read()
+
+    try:
+        filedata = CoreFoundation.CFDataCreate(
+            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
+        )
+        result_array = CoreFoundation.CFArrayRef()
+        result = Security.SecItemImport(
+            filedata,  # cert data
+            None,  # Filename, leaving it out for now
+            None,  # What the type of the file is, we don't care
+            None,  # what's in the file, we don't care
+            0,  # import flags
+            None,  # key params, can include passphrase in the future
+            keychain,  # The keychain to insert into
+            ctypes.byref(result_array),  # Results
+        )
+        _assert_no_error(result)
+
+        # A CFArray is not very useful to us as an intermediary
+        # representation, so we are going to extract the objects we want
+        # and then free the array. We don't need to keep hold of keys: the
+        # keychain already has them!
+        result_count = CoreFoundation.CFArrayGetCount(result_array)
+        for index in range(result_count):
+            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
+            item = ctypes.cast(item, CoreFoundation.CFTypeRef)
+
+            if _is_cert(item):
+                CoreFoundation.CFRetain(item)
+                certificates.append(item)
+            elif _is_identity(item):
+                CoreFoundation.CFRetain(item)
+                identities.append(item)
+    finally:
+        if result_array:
+            CoreFoundation.CFRelease(result_array)
+
+        CoreFoundation.CFRelease(filedata)
+
+    return (identities, certificates)
+
+
+def _load_client_cert_chain(keychain, *paths):
+    """
+    Load certificates and maybe keys from a number of files. Has the end goal
+    of returning a CFArray containing one SecIdentityRef, and then zero or more
+    SecCertificateRef objects, suitable for use as a client certificate trust
+    chain.
+    """
+    # Ok, the strategy.
+    #
+    # This relies on knowing that macOS will not give you a SecIdentityRef
+    # unless you have imported a key into a keychain. This is a somewhat
+    # artificial limitation of macOS (for example, it doesn't necessarily
+    # affect iOS), but there is nothing inside Security.framework that lets you
+    # get a SecIdentityRef without having a key in a keychain.
+    #
+    # So the policy here is we take all the files and iterate them in order.
+    # Each one will use SecItemImport to have one or more objects loaded from
+    # it. We will also point at a keychain that macOS can use to work with the
+    # private key.
+    #
+    # Once we have all the objects, we'll check what we actually have. If we
+    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
+    # we'll take the first certificate (which we assume to be our leaf) and
+    # ask the keychain to give us a SecIdentityRef with that cert's associated
+    # key.
+    #
+    # We'll then return a CFArray containing the trust chain: one
+    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
+    # responsibility for freeing this CFArray will be with the caller. This
+    # CFArray must remain alive for the entire connection, so in practice it
+    # will be stored with a single SSLSocket, along with the reference to the
+    # keychain.
+    certificates = []
+    identities = []
+
+    # Filter out bad paths.
+    paths = (path for path in paths if path)
+
+    try:
+        for file_path in paths:
+            new_identities, new_certs = _load_items_from_file(keychain, file_path)
+            identities.extend(new_identities)
+            certificates.extend(new_certs)
+
+        # Ok, we have everything. The question is: do we have an identity? If
+        # not, we want to grab one from the first cert we have.
+        if not identities:
+            new_identity = Security.SecIdentityRef()
+            status = Security.SecIdentityCreateWithCertificate(
+                keychain, certificates[0], ctypes.byref(new_identity)
+            )
+            _assert_no_error(status)
+            identities.append(new_identity)
+
+            # We now want to release the original certificate, as we no longer
+            # need it.
+            CoreFoundation.CFRelease(certificates.pop(0))
+
+        # We now need to build a new CFArray that holds the trust chain.
+        trust_chain = CoreFoundation.CFArrayCreateMutable(
+            CoreFoundation.kCFAllocatorDefault,
+            0,
+            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
+        )
+        for item in itertools.chain(identities, certificates):
+            # ArrayAppendValue does a CFRetain on the item. That's fine,
+            # because the finally block will release our other refs to them.
+            CoreFoundation.CFArrayAppendValue(trust_chain, item)
+
+        return trust_chain
+    finally:
+        for obj in itertools.chain(identities, certificates):
+            CoreFoundation.CFRelease(obj)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/appengine.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/appengine.py
new file mode 100644
index 0000000000000000000000000000000000000000..3f98702c9c361912dd4a73f4041d60d8a33145b3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/appengine.py
@@ -0,0 +1,314 @@
+"""
+This module provides a pool manager that uses Google App Engine's
+`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+Example usage::
+
+    from urllib3 import PoolManager
+    from urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox
+
+    if is_appengine_sandbox():
+        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
+        http = AppEngineManager()
+    else:
+        # PoolManager uses a socket-level API behind the scenes
+        http = PoolManager()
+
+    r = http.request('GET', 'https://google.com/')
+
+There are `limitations <https://cloud.google.com/appengine/docs/python/\
+urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
+the best choice for your application. There are three options for using
+urllib3 on Google App Engine:
+
+1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
+   cost-effective in many circumstances as long as your usage is within the
+   limitations.
+2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
+   Sockets also have `limitations and restrictions
+   <https://cloud.google.com/appengine/docs/python/sockets/\
+   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
+   To use sockets, be sure to specify the following in your ``app.yaml``::
+
+        env_variables:
+            GAE_USE_SOCKETS_HTTPLIB : 'true'
+
+3. If you are using `App Engine Flexible
+<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
+:class:`PoolManager` without any configuration or special environment variables.
+"""
+
+from __future__ import absolute_import
+import io
+import logging
+import warnings
+from six.moves.urllib.parse import urljoin
+
+from ..exceptions import (
+    HTTPError,
+    HTTPWarning,
+    MaxRetryError,
+    ProtocolError,
+    TimeoutError,
+    SSLError,
+)
+
+from ..request import RequestMethods
+from ..response import HTTPResponse
+from ..util.timeout import Timeout
+from ..util.retry import Retry
+from . import _appengine_environ
+
+try:
+    from google.appengine.api import urlfetch
+except ImportError:
+    urlfetch = None
+
+
+log = logging.getLogger(__name__)
+
+
+class AppEnginePlatformWarning(HTTPWarning):
+    pass
+
+
+class AppEnginePlatformError(HTTPError):
+    pass
+
+
+class AppEngineManager(RequestMethods):
+    """
+    Connection manager for Google App Engine sandbox applications.
+
+    This manager uses the URLFetch service directly instead of using the
+    emulated httplib, and is subject to URLFetch limitations as described in
+    the App Engine documentation `here
+    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.
+
+    Notably it will raise an :class:`AppEnginePlatformError` if:
+        * URLFetch is not available.
+        * If you attempt to use this on App Engine Flexible, as full socket
+          support is available.
+        * If a request size is more than 10 megabytes.
+        * If a response size is more than 32 megabtyes.
+        * If you use an unsupported request method such as OPTIONS.
+
+    Beyond those cases, it will raise normal urllib3 errors.
+    """
+
+    def __init__(
+        self,
+        headers=None,
+        retries=None,
+        validate_certificate=True,
+        urlfetch_retries=True,
+    ):
+        if not urlfetch:
+            raise AppEnginePlatformError(
+                "URLFetch is not available in this environment."
+            )
+
+        warnings.warn(
+            "urllib3 is using URLFetch on Google App Engine sandbox instead "
+            "of sockets. To use sockets directly instead of URLFetch see "
+            "https://urllib3.readthedocs.io/en/latest/reference/urllib3.contrib.html.",
+            AppEnginePlatformWarning,
+        )
+
+        RequestMethods.__init__(self, headers)
+        self.validate_certificate = validate_certificate
+        self.urlfetch_retries = urlfetch_retries
+
+        self.retries = retries or Retry.DEFAULT
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=None,
+        redirect=True,
+        timeout=Timeout.DEFAULT_TIMEOUT,
+        **response_kw
+    ):
+
+        retries = self._get_retries(retries, redirect)
+
+        try:
+            follow_redirects = redirect and retries.redirect != 0 and retries.total
+            response = urlfetch.fetch(
+                url,
+                payload=body,
+                method=method,
+                headers=headers or {},
+                allow_truncated=False,
+                follow_redirects=self.urlfetch_retries and follow_redirects,
+                deadline=self._get_absolute_timeout(timeout),
+                validate_certificate=self.validate_certificate,
+            )
+        except urlfetch.DeadlineExceededError as e:
+            raise TimeoutError(self, e)
+
+        except urlfetch.InvalidURLError as e:
+            if "too large" in str(e):
+                raise AppEnginePlatformError(
+                    "URLFetch request too large, URLFetch only "
+                    "supports requests up to 10mb in size.",
+                    e,
+                )
+            raise ProtocolError(e)
+
+        except urlfetch.DownloadError as e:
+            if "Too many redirects" in str(e):
+                raise MaxRetryError(self, url, reason=e)
+            raise ProtocolError(e)
+
+        except urlfetch.ResponseTooLargeError as e:
+            raise AppEnginePlatformError(
+                "URLFetch response too large, URLFetch only supports"
+                "responses up to 32mb in size.",
+                e,
+            )
+
+        except urlfetch.SSLCertificateError as e:
+            raise SSLError(e)
+
+        except urlfetch.InvalidMethodError as e:
+            raise AppEnginePlatformError(
+                "URLFetch does not support method: %s" % method, e
+            )
+
+        http_response = self._urlfetch_response_to_http_response(
+            response, retries=retries, **response_kw
+        )
+
+        # Handle redirect?
+        redirect_location = redirect and http_response.get_redirect_location()
+        if redirect_location:
+            # Check for redirect response
+            if self.urlfetch_retries and retries.raise_on_redirect:
+                raise MaxRetryError(self, url, "too many redirects")
+            else:
+                if http_response.status == 303:
+                    method = "GET"
+
+                try:
+                    retries = retries.increment(
+                        method, url, response=http_response, _pool=self
+                    )
+                except MaxRetryError:
+                    if retries.raise_on_redirect:
+                        raise MaxRetryError(self, url, "too many redirects")
+                    return http_response
+
+                retries.sleep_for_retry(http_response)
+                log.debug("Redirecting %s -> %s", url, redirect_location)
+                redirect_url = urljoin(url, redirect_location)
+                return self.urlopen(
+                    method,
+                    redirect_url,
+                    body,
+                    headers,
+                    retries=retries,
+                    redirect=redirect,
+                    timeout=timeout,
+                    **response_kw
+                )
+
+        # Check if we should retry the HTTP response.
+        has_retry_after = bool(http_response.getheader("Retry-After"))
+        if retries.is_retry(method, http_response.status, has_retry_after):
+            retries = retries.increment(method, url, response=http_response, _pool=self)
+            log.debug("Retry: %s", url)
+            retries.sleep(http_response)
+            return self.urlopen(
+                method,
+                url,
+                body=body,
+                headers=headers,
+                retries=retries,
+                redirect=redirect,
+                timeout=timeout,
+                **response_kw
+            )
+
+        return http_response
+
+    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):
+
+        if is_prod_appengine():
+            # Production GAE handles deflate encoding automatically, but does
+            # not remove the encoding header.
+            content_encoding = urlfetch_resp.headers.get("content-encoding")
+
+            if content_encoding == "deflate":
+                del urlfetch_resp.headers["content-encoding"]
+
+        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
+        # We have a full response's content,
+        # so let's make sure we don't report ourselves as chunked data.
+        if transfer_encoding == "chunked":
+            encodings = transfer_encoding.split(",")
+            encodings.remove("chunked")
+            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)
+
+        original_response = HTTPResponse(
+            # In order for decoding to work, we must present the content as
+            # a file-like object.
+            body=io.BytesIO(urlfetch_resp.content),
+            msg=urlfetch_resp.header_msg,
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            **response_kw
+        )
+
+        return HTTPResponse(
+            body=io.BytesIO(urlfetch_resp.content),
+            headers=urlfetch_resp.headers,
+            status=urlfetch_resp.status_code,
+            original_response=original_response,
+            **response_kw
+        )
+
+    def _get_absolute_timeout(self, timeout):
+        if timeout is Timeout.DEFAULT_TIMEOUT:
+            return None  # Defer to URLFetch's default.
+        if isinstance(timeout, Timeout):
+            if timeout._read is not None or timeout._connect is not None:
+                warnings.warn(
+                    "URLFetch does not support granular timeout settings, "
+                    "reverting to total or default URLFetch timeout.",
+                    AppEnginePlatformWarning,
+                )
+            return timeout.total
+        return timeout
+
+    def _get_retries(self, retries, redirect):
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)
+
+        if retries.connect or retries.read or retries.redirect:
+            warnings.warn(
+                "URLFetch only supports total retries and does not "
+                "recognize connect, read, or redirect retry parameters.",
+                AppEnginePlatformWarning,
+            )
+
+        return retries
+
+
+# Alias methods from _appengine_environ to maintain public API interface.
+
+is_appengine = _appengine_environ.is_appengine
+is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
+is_local_appengine = _appengine_environ.is_local_appengine
+is_prod_appengine = _appengine_environ.is_prod_appengine
+is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/ntlmpool.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/ntlmpool.py
new file mode 100644
index 0000000000000000000000000000000000000000..8f3a9c3c2b146a7f086a3497aaf7aabfe3b3412b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/ntlmpool.py
@@ -0,0 +1,121 @@
+"""
+NTLM authenticating pool, contributed by erikcederstran
+
+Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
+"""
+from __future__ import absolute_import
+
+from logging import getLogger
+from ntlm import ntlm
+
+from .. import HTTPSConnectionPool
+from six.moves.http_client import HTTPSConnection
+
+
+log = getLogger(__name__)
+
+
+class NTLMConnectionPool(HTTPSConnectionPool):
+    """
+    Implements an NTLM authentication version of an urllib3 connection pool
+    """
+
+    scheme = "https"
+
+    def __init__(self, user, pw, authurl, *args, **kwargs):
+        """
+        authurl is a random URL on the server that is protected by NTLM.
+        user is the Windows user, probably in the DOMAIN\\username format.
+        pw is the password for the user.
+        """
+        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
+        self.authurl = authurl
+        self.rawuser = user
+        user_parts = user.split("\\", 1)
+        self.domain = user_parts[0].upper()
+        self.user = user_parts[1]
+        self.pw = pw
+
+    def _new_conn(self):
+        # Performs the NTLM handshake that secures the connection. The socket
+        # must be kept open while requests are performed.
+        self.num_connections += 1
+        log.debug(
+            "Starting NTLM HTTPS connection no. %d: https://%s%s",
+            self.num_connections,
+            self.host,
+            self.authurl,
+        )
+
+        headers = {"Connection": "Keep-Alive"}
+        req_header = "Authorization"
+        resp_header = "www-authenticate"
+
+        conn = HTTPSConnection(host=self.host, port=self.port)
+
+        # Send negotiation message
+        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
+            self.rawuser
+        )
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        reshdr = dict(res.getheaders())
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", reshdr)
+        log.debug("Response data: %s [...]", res.read(100))
+
+        # Remove the reference to the socket, so that it can not be closed by
+        # the response object (we want to keep the socket open)
+        res.fp = None
+
+        # Server should respond with a challenge message
+        auth_header_values = reshdr[resp_header].split(", ")
+        auth_header_value = None
+        for s in auth_header_values:
+            if s[:5] == "NTLM ":
+                auth_header_value = s[5:]
+        if auth_header_value is None:
+            raise Exception(
+                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
+            )
+
+        # Send authentication message
+        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
+            auth_header_value
+        )
+        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
+            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
+        )
+        headers[req_header] = "NTLM %s" % auth_msg
+        log.debug("Request headers: %s", headers)
+        conn.request("GET", self.authurl, None, headers)
+        res = conn.getresponse()
+        log.debug("Response status: %s %s", res.status, res.reason)
+        log.debug("Response headers: %s", dict(res.getheaders()))
+        log.debug("Response data: %s [...]", res.read()[:100])
+        if res.status != 200:
+            if res.status == 401:
+                raise Exception("Server rejected request: wrong username or password")
+            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))
+
+        res.fp = None
+        log.debug("Connection established")
+        return conn
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        retries=3,
+        redirect=True,
+        assert_same_host=True,
+    ):
+        if headers is None:
+            headers = {}
+        headers["Connection"] = "Keep-Alive"
+        return super(NTLMConnectionPool, self).urlopen(
+            method, url, body, headers, retries, redirect, assert_same_host
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/pyopenssl.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/pyopenssl.py
new file mode 100644
index 0000000000000000000000000000000000000000..2f35eb9410fa9589213f6b17a1191937ecffa462
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/pyopenssl.py
@@ -0,0 +1,498 @@
+"""
+SSL with SNI_-support for Python 2. Follow these instructions if you would
+like to verify SSL certificates in Python 2. Note, the default libraries do
+*not* do certificate checking; you need to do additional work to validate
+certificates yourself.
+
+This needs the following packages installed:
+
+* pyOpenSSL (tested with 16.0.0)
+* cryptography (minimum 1.3.4, from pyopenssl)
+* idna (minimum 2.0, from cryptography)
+
+However, pyopenssl depends on cryptography, which depends on idna, so while we
+use all three directly here we end up having relatively few packages required.
+
+You can install them with the following command:
+
+    pip install pyopenssl cryptography idna
+
+To activate certificate checking, call
+:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
+before you begin making HTTP requests. This can be done in a ``sitecustomize``
+module, or at any other time before your application begins using ``urllib3``,
+like this::
+
+    try:
+        import urllib3.contrib.pyopenssl
+        urllib3.contrib.pyopenssl.inject_into_urllib3()
+    except ImportError:
+        pass
+
+Now you can use :mod:`urllib3` as you normally would, and it will support SNI
+when the required modules are installed.
+
+Activating this module also has the positive side effect of disabling SSL/TLS
+compression in Python 2 (see `CRIME attack`_).
+
+If you want to configure the default list of supported cipher suites, you can
+set the ``urllib3.contrib.pyopenssl.DEFAULT_SSL_CIPHER_LIST`` variable.
+
+.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
+.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
+"""
+from __future__ import absolute_import
+
+import OpenSSL.SSL
+from cryptography import x509
+from cryptography.hazmat.backends.openssl import backend as openssl_backend
+from cryptography.hazmat.backends.openssl.x509 import _Certificate
+
+try:
+    from cryptography.x509 import UnsupportedExtension
+except ImportError:
+    # UnsupportedExtension is gone in cryptography >= 2.1.0
+    class UnsupportedExtension(Exception):
+        pass
+
+
+from socket import timeout, error as SocketError
+from io import BytesIO
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+import logging
+import ssl
+import six
+import sys
+
+from .. import util
+
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works.
+HAS_SNI = True
+
+# Map from urllib3 to PyOpenSSL compatible parameter-values.
+_openssl_versions = {
+    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
+    ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD
+
+if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"):
+    _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD
+
+
+_stdlib_to_openssl_verify = {
+    ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE,
+    ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER,
+    ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
+    + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
+}
+_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())
+
+# OpenSSL will only write 16K at a time
+SSL_WRITE_BLOCKSIZE = 16384
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+
+log = logging.getLogger(__name__)
+
+
+def inject_into_urllib3():
+    "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."
+
+    _validate_dependencies_met()
+
+    util.SSLContext = PyOpenSSLContext
+    util.ssl_.SSLContext = PyOpenSSLContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_PYOPENSSL = True
+    util.ssl_.IS_PYOPENSSL = True
+
+
+def extract_from_urllib3():
+    "Undo monkey-patching by :func:`inject_into_urllib3`."
+
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_PYOPENSSL = False
+    util.ssl_.IS_PYOPENSSL = False
+
+
+def _validate_dependencies_met():
+    """
+    Verifies that PyOpenSSL's package-level dependencies have been met.
+    Throws `ImportError` if they are not met.
+    """
+    # Method added in `cryptography==1.1`; not available in older versions
+    from cryptography.x509.extensions import Extensions
+
+    if getattr(Extensions, "get_extension_for_class", None) is None:
+        raise ImportError(
+            "'cryptography' module missing required functionality.  "
+            "Try upgrading to v1.3.4 or newer."
+        )
+
+    # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509
+    # attribute is only present on those versions.
+    from OpenSSL.crypto import X509
+
+    x509 = X509()
+    if getattr(x509, "_x509", None) is None:
+        raise ImportError(
+            "'pyOpenSSL' module missing required functionality. "
+            "Try upgrading to v0.14 or newer."
+        )
+
+
+def _dnsname_to_stdlib(name):
+    """
+    Converts a dNSName SubjectAlternativeName field to the form used by the
+    standard library on the given Python version.
+
+    Cryptography produces a dNSName as a unicode string that was idna-decoded
+    from ASCII bytes. We need to idna-encode that string to get it back, and
+    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
+    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).
+
+    If the name cannot be idna-encoded then we return None signalling that
+    the name given should be skipped.
+    """
+
+    def idna_encode(name):
+        """
+        Borrowed wholesale from the Python Cryptography Project. It turns out
+        that we can't just safely call `idna.encode`: it can explode for
+        wildcard names. This avoids that problem.
+        """
+        import idna
+
+        try:
+            for prefix in [u"*.", u"."]:
+                if name.startswith(prefix):
+                    name = name[len(prefix) :]
+                    return prefix.encode("ascii") + idna.encode(name)
+            return idna.encode(name)
+        except idna.core.IDNAError:
+            return None
+
+    # Don't send IPv6 addresses through the IDNA encoder.
+    if ":" in name:
+        return name
+
+    name = idna_encode(name)
+    if name is None:
+        return None
+    elif sys.version_info >= (3, 0):
+        name = name.decode("utf-8")
+    return name
+
+
+def get_subj_alt_name(peer_cert):
+    """
+    Given an PyOpenSSL certificate, provides all the subject alternative names.
+    """
+    # Pass the cert to cryptography, which has much better APIs for this.
+    if hasattr(peer_cert, "to_cryptography"):
+        cert = peer_cert.to_cryptography()
+    else:
+        # This is technically using private APIs, but should work across all
+        # relevant versions before PyOpenSSL got a proper API for this.
+        cert = _Certificate(openssl_backend, peer_cert._x509)
+
+    # We want to find the SAN extension. Ask Cryptography to locate it (it's
+    # faster than looping in Python)
+    try:
+        ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value
+    except x509.ExtensionNotFound:
+        # No such extension, return the empty list.
+        return []
+    except (
+        x509.DuplicateExtension,
+        UnsupportedExtension,
+        x509.UnsupportedGeneralNameType,
+        UnicodeError,
+    ) as e:
+        # A problem has been found with the quality of the certificate. Assume
+        # no SAN field is present.
+        log.warning(
+            "A problem was encountered with the certificate that prevented "
+            "urllib3 from finding the SubjectAlternativeName field. This can "
+            "affect certificate validation. The error was %s",
+            e,
+        )
+        return []
+
+    # We want to return dNSName and iPAddress fields. We need to cast the IPs
+    # back to strings because the match_hostname function wants them as
+    # strings.
+    # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8
+    # decoded. This is pretty frustrating, but that's what the standard library
+    # does with certificates, and so we need to attempt to do the same.
+    # We also want to skip over names which cannot be idna encoded.
+    names = [
+        ("DNS", name)
+        for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName))
+        if name is not None
+    ]
+    names.extend(
+        ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress)
+    )
+
+    return names
+
+
+class WrappedSocket(object):
+    """API-compatibility wrapper for Python OpenSSL's Connection-class.
+
+    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
+    collector of pypy.
+    """
+
+    def __init__(self, connection, socket, suppress_ragged_eofs=True):
+        self.connection = connection
+        self.socket = socket
+        self.suppress_ragged_eofs = suppress_ragged_eofs
+        self._makefile_refs = 0
+        self._closed = False
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, *args, **kwargs):
+        try:
+            data = self.connection.recv(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return b""
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return b""
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+        else:
+            return data
+
+    def recv_into(self, *args, **kwargs):
+        try:
+            return self.connection.recv_into(*args, **kwargs)
+        except OpenSSL.SSL.SysCallError as e:
+            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
+                return 0
+            else:
+                raise SocketError(str(e))
+        except OpenSSL.SSL.ZeroReturnError:
+            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
+                return 0
+            else:
+                raise
+        except OpenSSL.SSL.WantReadError:
+            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
+                raise timeout("The read operation timed out")
+            else:
+                return self.recv_into(*args, **kwargs)
+
+        # TLS 1.3 post-handshake authentication
+        except OpenSSL.SSL.Error as e:
+            raise ssl.SSLError("read error: %r" % e)
+
+    def settimeout(self, timeout):
+        return self.socket.settimeout(timeout)
+
+    def _send_until_done(self, data):
+        while True:
+            try:
+                return self.connection.send(data)
+            except OpenSSL.SSL.WantWriteError:
+                if not util.wait_for_write(self.socket, self.socket.gettimeout()):
+                    raise timeout()
+                continue
+            except OpenSSL.SSL.SysCallError as e:
+                raise SocketError(str(e))
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self._send_until_done(
+                data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]
+            )
+            total_sent += sent
+
+    def shutdown(self):
+        # FIXME rethrow compatible exceptions should we ever use this
+        self.connection.shutdown()
+
+    def close(self):
+        if self._makefile_refs < 1:
+            try:
+                self._closed = True
+                return self.connection.close()
+            except OpenSSL.SSL.Error:
+                return
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        x509 = self.connection.get_peer_certificate()
+
+        if not x509:
+            return x509
+
+        if binary_form:
+            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)
+
+        return {
+            "subject": ((("commonName", x509.get_subject().CN),),),
+            "subjectAltName": get_subj_alt_name(x509),
+        }
+
+    def version(self):
+        return self.connection.get_protocol_version_name()
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+
+else:  # Platform-specific: Python 3
+    makefile = backport_makefile
+
+WrappedSocket.makefile = makefile
+
+
+class PyOpenSSLContext(object):
+    """
+    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
+    for translating the interface of the standard library ``SSLContext`` object
+    to calls into PyOpenSSL.
+    """
+
+    def __init__(self, protocol):
+        self.protocol = _openssl_versions[protocol]
+        self._ctx = OpenSSL.SSL.Context(self.protocol)
+        self._options = 0
+        self.check_hostname = False
+
+    @property
+    def options(self):
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        self._options = value
+        self._ctx.set_options(value)
+
+    @property
+    def verify_mode(self):
+        return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)
+
+    def set_default_verify_paths(self):
+        self._ctx.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        if isinstance(ciphers, six.text_type):
+            ciphers = ciphers.encode("utf-8")
+        self._ctx.set_cipher_list(ciphers)
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        if cafile is not None:
+            cafile = cafile.encode("utf-8")
+        if capath is not None:
+            capath = capath.encode("utf-8")
+        self._ctx.load_verify_locations(cafile, capath)
+        if cadata is not None:
+            self._ctx.load_verify_locations(BytesIO(cadata))
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._ctx.use_certificate_chain_file(certfile)
+        if password is not None:
+            if not isinstance(password, six.binary_type):
+                password = password.encode("utf-8")
+            self._ctx.set_passwd_cb(lambda *_: password)
+        self._ctx.use_privatekey_file(keyfile or certfile)
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        cnx = OpenSSL.SSL.Connection(self._ctx, sock)
+
+        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
+            server_hostname = server_hostname.encode("utf-8")
+
+        if server_hostname is not None:
+            cnx.set_tlsext_host_name(server_hostname)
+
+        cnx.set_connect_state()
+
+        while True:
+            try:
+                cnx.do_handshake()
+            except OpenSSL.SSL.WantReadError:
+                if not util.wait_for_read(sock, sock.gettimeout()):
+                    raise timeout("select timed out")
+                continue
+            except OpenSSL.SSL.Error as e:
+                raise ssl.SSLError("bad handshake: %r" % e)
+            break
+
+        return WrappedSocket(cnx, sock)
+
+
+def _verify_callback(cnx, x509, err_no, err_depth, return_code):
+    return err_no == 0
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/securetransport.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/securetransport.py
new file mode 100644
index 0000000000000000000000000000000000000000..87d844afa78769f0304e4f5953cd3ff8733d0290
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/securetransport.py
@@ -0,0 +1,859 @@
+"""
+SecureTranport support for urllib3 via ctypes.
+
+This makes platform-native TLS available to urllib3 users on macOS without the
+use of a compiler. This is an important feature because the Python Package
+Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
+that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
+this is to give macOS users an alternative solution to the problem, and that
+solution is to use SecureTransport.
+
+We use ctypes here because this solution must not require a compiler. That's
+because pip is not allowed to require a compiler either.
+
+This is not intended to be a seriously long-term solution to this problem.
+The hope is that PEP 543 will eventually solve this issue for us, at which
+point we can retire this contrib module. But in the short term, we need to
+solve the impending tire fire that is Python on Mac without this kind of
+contrib module. So...here we are.
+
+To use this module, simply import and inject it::
+
+    import urllib3.contrib.securetransport
+    urllib3.contrib.securetransport.inject_into_urllib3()
+
+Happy TLSing!
+
+This code is a bastardised version of the code found in Will Bond's oscrypto
+library. An enormous debt is owed to him for blazing this trail for us. For
+that reason, this code should be considered to be covered both by urllib3's
+license and by oscrypto's:
+
+    Copyright (c) 2015-2016 Will Bond <will@wbond.net>
+
+    Permission is hereby granted, free of charge, to any person obtaining a
+    copy of this software and associated documentation files (the "Software"),
+    to deal in the Software without restriction, including without limitation
+    the rights to use, copy, modify, merge, publish, distribute, sublicense,
+    and/or sell copies of the Software, and to permit persons to whom the
+    Software is furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+    DEALINGS IN THE SOFTWARE.
+"""
+from __future__ import absolute_import
+
+import contextlib
+import ctypes
+import errno
+import os.path
+import shutil
+import socket
+import ssl
+import threading
+import weakref
+
+from .. import util
+from ._securetransport.bindings import Security, SecurityConst, CoreFoundation
+from ._securetransport.low_level import (
+    _assert_no_error,
+    _cert_array_from_pem,
+    _temporary_keychain,
+    _load_client_cert_chain,
+)
+
+try:  # Platform-specific: Python 2
+    from socket import _fileobject
+except ImportError:  # Platform-specific: Python 3
+    _fileobject = None
+    from ..packages.backports.makefile import backport_makefile
+
+__all__ = ["inject_into_urllib3", "extract_from_urllib3"]
+
+# SNI always works
+HAS_SNI = True
+
+orig_util_HAS_SNI = util.HAS_SNI
+orig_util_SSLContext = util.ssl_.SSLContext
+
+# This dictionary is used by the read callback to obtain a handle to the
+# calling wrapped socket. This is a pretty silly approach, but for now it'll
+# do. I feel like I should be able to smuggle a handle to the wrapped socket
+# directly in the SSLConnectionRef, but for now this approach will work I
+# guess.
+#
+# We need to lock around this structure for inserts, but we don't do it for
+# reads/writes in the callbacks. The reasoning here goes as follows:
+#
+#    1. It is not possible to call into the callbacks before the dictionary is
+#       populated, so once in the callback the id must be in the dictionary.
+#    2. The callbacks don't mutate the dictionary, they only read from it, and
+#       so cannot conflict with any of the insertions.
+#
+# This is good: if we had to lock in the callbacks we'd drastically slow down
+# the performance of this code.
+_connection_refs = weakref.WeakValueDictionary()
+_connection_ref_lock = threading.Lock()
+
+# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
+# for no better reason than we need *a* limit, and this one is right there.
+SSL_WRITE_BLOCKSIZE = 16384
+
+# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
+# individual cipher suites. We need to do this because this is how
+# SecureTransport wants them.
+CIPHER_SUITES = [
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
+    SecurityConst.TLS_AES_256_GCM_SHA384,
+    SecurityConst.TLS_AES_128_GCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
+    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
+    SecurityConst.TLS_AES_128_CCM_8_SHA256,
+    SecurityConst.TLS_AES_128_CCM_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
+    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
+    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
+]
+
+# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
+# TLSv1 and a high of TLSv1.2. For everything else, we pin to that version.
+# TLSv1 to 1.2 are supported on macOS 10.8+
+_protocol_to_min_max = {
+    util.PROTOCOL_TLS: (SecurityConst.kTLSProtocol1, SecurityConst.kTLSProtocol12)
+}
+
+if hasattr(ssl, "PROTOCOL_SSLv2"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
+        SecurityConst.kSSLProtocol2,
+        SecurityConst.kSSLProtocol2,
+    )
+if hasattr(ssl, "PROTOCOL_SSLv3"):
+    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
+        SecurityConst.kSSLProtocol3,
+        SecurityConst.kSSLProtocol3,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
+        SecurityConst.kTLSProtocol1,
+        SecurityConst.kTLSProtocol1,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_1"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
+        SecurityConst.kTLSProtocol11,
+        SecurityConst.kTLSProtocol11,
+    )
+if hasattr(ssl, "PROTOCOL_TLSv1_2"):
+    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
+        SecurityConst.kTLSProtocol12,
+        SecurityConst.kTLSProtocol12,
+    )
+
+
+def inject_into_urllib3():
+    """
+    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
+    """
+    util.SSLContext = SecureTransportContext
+    util.ssl_.SSLContext = SecureTransportContext
+    util.HAS_SNI = HAS_SNI
+    util.ssl_.HAS_SNI = HAS_SNI
+    util.IS_SECURETRANSPORT = True
+    util.ssl_.IS_SECURETRANSPORT = True
+
+
+def extract_from_urllib3():
+    """
+    Undo monkey-patching by :func:`inject_into_urllib3`.
+    """
+    util.SSLContext = orig_util_SSLContext
+    util.ssl_.SSLContext = orig_util_SSLContext
+    util.HAS_SNI = orig_util_HAS_SNI
+    util.ssl_.HAS_SNI = orig_util_HAS_SNI
+    util.IS_SECURETRANSPORT = False
+    util.ssl_.IS_SECURETRANSPORT = False
+
+
+def _read_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport read callback. This is called by ST to request that data
+    be returned from the socket.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        requested_length = data_length_pointer[0]
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        read_count = 0
+
+        try:
+            while read_count < requested_length:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_read(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+
+                remaining = requested_length - read_count
+                buffer = (ctypes.c_char * remaining).from_address(
+                    data_buffer + read_count
+                )
+                chunk_size = base_socket.recv_into(buffer, remaining)
+                read_count += chunk_size
+                if not chunk_size:
+                    if not read_count:
+                        return SecurityConst.errSSLClosedGraceful
+                    break
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = read_count
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = read_count
+
+        if read_count != requested_length:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+def _write_callback(connection_id, data_buffer, data_length_pointer):
+    """
+    SecureTransport write callback. This is called by ST to request that data
+    actually be sent on the network.
+    """
+    wrapped_socket = None
+    try:
+        wrapped_socket = _connection_refs.get(connection_id)
+        if wrapped_socket is None:
+            return SecurityConst.errSSLInternal
+        base_socket = wrapped_socket.socket
+
+        bytes_to_write = data_length_pointer[0]
+        data = ctypes.string_at(data_buffer, bytes_to_write)
+
+        timeout = wrapped_socket.gettimeout()
+        error = None
+        sent = 0
+
+        try:
+            while sent < bytes_to_write:
+                if timeout is None or timeout >= 0:
+                    if not util.wait_for_write(base_socket, timeout):
+                        raise socket.error(errno.EAGAIN, "timed out")
+                chunk_sent = base_socket.send(data)
+                sent += chunk_sent
+
+                # This has some needless copying here, but I'm not sure there's
+                # much value in optimising this data path.
+                data = data[chunk_sent:]
+        except (socket.error) as e:
+            error = e.errno
+
+            if error is not None and error != errno.EAGAIN:
+                data_length_pointer[0] = sent
+                if error == errno.ECONNRESET or error == errno.EPIPE:
+                    return SecurityConst.errSSLClosedAbort
+                raise
+
+        data_length_pointer[0] = sent
+
+        if sent != bytes_to_write:
+            return SecurityConst.errSSLWouldBlock
+
+        return 0
+    except Exception as e:
+        if wrapped_socket is not None:
+            wrapped_socket._exception = e
+        return SecurityConst.errSSLInternal
+
+
+# We need to keep these two objects references alive: if they get GC'd while
+# in use then SecureTransport could attempt to call a function that is in freed
+# memory. That would be...uh...bad. Yeah, that's the word. Bad.
+_read_callback_pointer = Security.SSLReadFunc(_read_callback)
+_write_callback_pointer = Security.SSLWriteFunc(_write_callback)
+
+
+class WrappedSocket(object):
+    """
+    API-compatibility wrapper for Python's OpenSSL wrapped socket object.
+
+    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
+    collector of PyPy.
+    """
+
+    def __init__(self, socket):
+        self.socket = socket
+        self.context = None
+        self._makefile_refs = 0
+        self._closed = False
+        self._exception = None
+        self._keychain = None
+        self._keychain_dir = None
+        self._client_cert_chain = None
+
+        # We save off the previously-configured timeout and then set it to
+        # zero. This is done because we use select and friends to handle the
+        # timeouts, but if we leave the timeout set on the lower socket then
+        # Python will "kindly" call select on that socket again for us. Avoid
+        # that by forcing the timeout to zero.
+        self._timeout = self.socket.gettimeout()
+        self.socket.settimeout(0)
+
+    @contextlib.contextmanager
+    def _raise_on_error(self):
+        """
+        A context manager that can be used to wrap calls that do I/O from
+        SecureTransport. If any of the I/O callbacks hit an exception, this
+        context manager will correctly propagate the exception after the fact.
+        This avoids silently swallowing those exceptions.
+
+        It also correctly forces the socket closed.
+        """
+        self._exception = None
+
+        # We explicitly don't catch around this yield because in the unlikely
+        # event that an exception was hit in the block we don't want to swallow
+        # it.
+        yield
+        if self._exception is not None:
+            exception, self._exception = self._exception, None
+            self.close()
+            raise exception
+
+    def _set_ciphers(self):
+        """
+        Sets up the allowed ciphers. By default this matches the set in
+        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
+        custom and doesn't allow changing at this time, mostly because parsing
+        OpenSSL cipher strings is going to be a freaking nightmare.
+        """
+        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
+        result = Security.SSLSetEnabledCiphers(
+            self.context, ciphers, len(CIPHER_SUITES)
+        )
+        _assert_no_error(result)
+
+    def _custom_validate(self, verify, trust_bundle):
+        """
+        Called when we have set custom validation. We do this in two cases:
+        first, when cert validation is entirely disabled; and second, when
+        using a custom trust DB.
+        """
+        # If we disabled cert validation, just say: cool.
+        if not verify:
+            return
+
+        # We want data in memory, so load it up.
+        if os.path.isfile(trust_bundle):
+            with open(trust_bundle, "rb") as f:
+                trust_bundle = f.read()
+
+        cert_array = None
+        trust = Security.SecTrustRef()
+
+        try:
+            # Get a CFArray that contains the certs we want.
+            cert_array = _cert_array_from_pem(trust_bundle)
+
+            # Ok, now the hard part. We want to get the SecTrustRef that ST has
+            # created for this connection, shove our CAs into it, tell ST to
+            # ignore everything else it knows, and then ask if it can build a
+            # chain. This is a buuuunch of code.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                raise ssl.SSLError("Failed to copy trust reference")
+
+            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
+            _assert_no_error(result)
+
+            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
+            _assert_no_error(result)
+
+            trust_result = Security.SecTrustResultType()
+            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
+            _assert_no_error(result)
+        finally:
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+            if cert_array is not None:
+                CoreFoundation.CFRelease(cert_array)
+
+        # Ok, now we can look at what the result was.
+        successes = (
+            SecurityConst.kSecTrustResultUnspecified,
+            SecurityConst.kSecTrustResultProceed,
+        )
+        if trust_result.value not in successes:
+            raise ssl.SSLError(
+                "certificate verify failed, error code: %d" % trust_result.value
+            )
+
+    def handshake(
+        self,
+        server_hostname,
+        verify,
+        trust_bundle,
+        min_version,
+        max_version,
+        client_cert,
+        client_key,
+        client_key_passphrase,
+    ):
+        """
+        Actually performs the TLS handshake. This is run automatically by
+        wrapped socket, and shouldn't be needed in user code.
+        """
+        # First, we do the initial bits of connection setup. We need to create
+        # a context, set its I/O funcs, and set the connection reference.
+        self.context = Security.SSLCreateContext(
+            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
+        )
+        result = Security.SSLSetIOFuncs(
+            self.context, _read_callback_pointer, _write_callback_pointer
+        )
+        _assert_no_error(result)
+
+        # Here we need to compute the handle to use. We do this by taking the
+        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
+        # just keep incrementing by one until we find a free space.
+        with _connection_ref_lock:
+            handle = id(self) % 2147483647
+            while handle in _connection_refs:
+                handle = (handle + 1) % 2147483647
+            _connection_refs[handle] = self
+
+        result = Security.SSLSetConnection(self.context, handle)
+        _assert_no_error(result)
+
+        # If we have a server hostname, we should set that too.
+        if server_hostname:
+            if not isinstance(server_hostname, bytes):
+                server_hostname = server_hostname.encode("utf-8")
+
+            result = Security.SSLSetPeerDomainName(
+                self.context, server_hostname, len(server_hostname)
+            )
+            _assert_no_error(result)
+
+        # Setup the ciphers.
+        self._set_ciphers()
+
+        # Set the minimum and maximum TLS versions.
+        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
+        _assert_no_error(result)
+
+        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
+        _assert_no_error(result)
+
+        # If there's a trust DB, we need to use it. We do that by telling
+        # SecureTransport to break on server auth. We also do that if we don't
+        # want to validate the certs at all: we just won't actually do any
+        # authing in that case.
+        if not verify or trust_bundle is not None:
+            result = Security.SSLSetSessionOption(
+                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
+            )
+            _assert_no_error(result)
+
+        # If there's a client cert, we need to use it.
+        if client_cert:
+            self._keychain, self._keychain_dir = _temporary_keychain()
+            self._client_cert_chain = _load_client_cert_chain(
+                self._keychain, client_cert, client_key
+            )
+            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
+            _assert_no_error(result)
+
+        while True:
+            with self._raise_on_error():
+                result = Security.SSLHandshake(self.context)
+
+                if result == SecurityConst.errSSLWouldBlock:
+                    raise socket.timeout("handshake timed out")
+                elif result == SecurityConst.errSSLServerAuthCompleted:
+                    self._custom_validate(verify, trust_bundle)
+                    continue
+                else:
+                    _assert_no_error(result)
+                    break
+
+    def fileno(self):
+        return self.socket.fileno()
+
+    # Copy-pasted from Python 3.5 source code
+    def _decref_socketios(self):
+        if self._makefile_refs > 0:
+            self._makefile_refs -= 1
+        if self._closed:
+            self.close()
+
+    def recv(self, bufsiz):
+        buffer = ctypes.create_string_buffer(bufsiz)
+        bytes_read = self.recv_into(buffer, bufsiz)
+        data = buffer[:bytes_read]
+        return data
+
+    def recv_into(self, buffer, nbytes=None):
+        # Read short on EOF.
+        if self._closed:
+            return 0
+
+        if nbytes is None:
+            nbytes = len(buffer)
+
+        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLRead(
+                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
+            )
+
+        # There are some result codes that we want to treat as "not always
+        # errors". Specifically, those are errSSLWouldBlock,
+        # errSSLClosedGraceful, and errSSLClosedNoNotify.
+        if result == SecurityConst.errSSLWouldBlock:
+            # If we didn't process any bytes, then this was just a time out.
+            # However, we can get errSSLWouldBlock in situations when we *did*
+            # read some data, and in those cases we should just read "short"
+            # and return.
+            if processed_bytes.value == 0:
+                # Timed out, no data read.
+                raise socket.timeout("recv timed out")
+        elif result in (
+            SecurityConst.errSSLClosedGraceful,
+            SecurityConst.errSSLClosedNoNotify,
+        ):
+            # The remote peer has closed this connection. We should do so as
+            # well. Note that we don't actually return here because in
+            # principle this could actually be fired along with return data.
+            # It's unlikely though.
+            self.close()
+        else:
+            _assert_no_error(result)
+
+        # Ok, we read and probably succeeded. We should return whatever data
+        # was actually read.
+        return processed_bytes.value
+
+    def settimeout(self, timeout):
+        self._timeout = timeout
+
+    def gettimeout(self):
+        return self._timeout
+
+    def send(self, data):
+        processed_bytes = ctypes.c_size_t(0)
+
+        with self._raise_on_error():
+            result = Security.SSLWrite(
+                self.context, data, len(data), ctypes.byref(processed_bytes)
+            )
+
+        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
+            # Timed out
+            raise socket.timeout("send timed out")
+        else:
+            _assert_no_error(result)
+
+        # We sent, and probably succeeded. Tell them how much we sent.
+        return processed_bytes.value
+
+    def sendall(self, data):
+        total_sent = 0
+        while total_sent < len(data):
+            sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
+            total_sent += sent
+
+    def shutdown(self):
+        with self._raise_on_error():
+            Security.SSLClose(self.context)
+
+    def close(self):
+        # TODO: should I do clean shutdown here? Do I have to?
+        if self._makefile_refs < 1:
+            self._closed = True
+            if self.context:
+                CoreFoundation.CFRelease(self.context)
+                self.context = None
+            if self._client_cert_chain:
+                CoreFoundation.CFRelease(self._client_cert_chain)
+                self._client_cert_chain = None
+            if self._keychain:
+                Security.SecKeychainDelete(self._keychain)
+                CoreFoundation.CFRelease(self._keychain)
+                shutil.rmtree(self._keychain_dir)
+                self._keychain = self._keychain_dir = None
+            return self.socket.close()
+        else:
+            self._makefile_refs -= 1
+
+    def getpeercert(self, binary_form=False):
+        # Urgh, annoying.
+        #
+        # Here's how we do this:
+        #
+        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
+        #    connection.
+        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
+        # 3. To get the CN, call SecCertificateCopyCommonName and process that
+        #    string so that it's of the appropriate type.
+        # 4. To get the SAN, we need to do something a bit more complex:
+        #    a. Call SecCertificateCopyValues to get the data, requesting
+        #       kSecOIDSubjectAltName.
+        #    b. Mess about with this dictionary to try to get the SANs out.
+        #
+        # This is gross. Really gross. It's going to be a few hundred LoC extra
+        # just to repeat something that SecureTransport can *already do*. So my
+        # operating assumption at this time is that what we want to do is
+        # instead to just flag to urllib3 that it shouldn't do its own hostname
+        # validation when using SecureTransport.
+        if not binary_form:
+            raise ValueError("SecureTransport only supports dumping binary certs")
+        trust = Security.SecTrustRef()
+        certdata = None
+        der_bytes = None
+
+        try:
+            # Grab the trust store.
+            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
+            _assert_no_error(result)
+            if not trust:
+                # Probably we haven't done the handshake yet. No biggie.
+                return None
+
+            cert_count = Security.SecTrustGetCertificateCount(trust)
+            if not cert_count:
+                # Also a case that might happen if we haven't handshaked.
+                # Handshook? Handshaken?
+                return None
+
+            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
+            assert leaf
+
+            # Ok, now we want the DER bytes.
+            certdata = Security.SecCertificateCopyData(leaf)
+            assert certdata
+
+            data_length = CoreFoundation.CFDataGetLength(certdata)
+            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
+            der_bytes = ctypes.string_at(data_buffer, data_length)
+        finally:
+            if certdata:
+                CoreFoundation.CFRelease(certdata)
+            if trust:
+                CoreFoundation.CFRelease(trust)
+
+        return der_bytes
+
+    def version(self):
+        protocol = Security.SSLProtocol()
+        result = Security.SSLGetNegotiatedProtocolVersion(
+            self.context, ctypes.byref(protocol)
+        )
+        _assert_no_error(result)
+        if protocol.value == SecurityConst.kTLSProtocol13:
+            raise ssl.SSLError("SecureTransport does not support TLS 1.3")
+        elif protocol.value == SecurityConst.kTLSProtocol12:
+            return "TLSv1.2"
+        elif protocol.value == SecurityConst.kTLSProtocol11:
+            return "TLSv1.1"
+        elif protocol.value == SecurityConst.kTLSProtocol1:
+            return "TLSv1"
+        elif protocol.value == SecurityConst.kSSLProtocol3:
+            return "SSLv3"
+        elif protocol.value == SecurityConst.kSSLProtocol2:
+            return "SSLv2"
+        else:
+            raise ssl.SSLError("Unknown TLS version: %r" % protocol)
+
+    def _reuse(self):
+        self._makefile_refs += 1
+
+    def _drop(self):
+        if self._makefile_refs < 1:
+            self.close()
+        else:
+            self._makefile_refs -= 1
+
+
+if _fileobject:  # Platform-specific: Python 2
+
+    def makefile(self, mode, bufsize=-1):
+        self._makefile_refs += 1
+        return _fileobject(self, mode, bufsize, close=True)
+
+
+else:  # Platform-specific: Python 3
+
+    def makefile(self, mode="r", buffering=None, *args, **kwargs):
+        # We disable buffering with SecureTransport because it conflicts with
+        # the buffering that ST does internally (see issue #1153 for more).
+        buffering = 0
+        return backport_makefile(self, mode, buffering, *args, **kwargs)
+
+
+WrappedSocket.makefile = makefile
+
+
+class SecureTransportContext(object):
+    """
+    I am a wrapper class for the SecureTransport library, to translate the
+    interface of the standard library ``SSLContext`` object to calls into
+    SecureTransport.
+    """
+
+    def __init__(self, protocol):
+        self._min_version, self._max_version = _protocol_to_min_max[protocol]
+        self._options = 0
+        self._verify = False
+        self._trust_bundle = None
+        self._client_cert = None
+        self._client_key = None
+        self._client_key_passphrase = None
+
+    @property
+    def check_hostname(self):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        return True
+
+    @check_hostname.setter
+    def check_hostname(self, value):
+        """
+        SecureTransport cannot have its hostname checking disabled. For more,
+        see the comment on getpeercert() in this file.
+        """
+        pass
+
+    @property
+    def options(self):
+        # TODO: Well, crap.
+        #
+        # So this is the bit of the code that is the most likely to cause us
+        # trouble. Essentially we need to enumerate all of the SSL options that
+        # users might want to use and try to see if we can sensibly translate
+        # them, or whether we should just ignore them.
+        return self._options
+
+    @options.setter
+    def options(self, value):
+        # TODO: Update in line with above.
+        self._options = value
+
+    @property
+    def verify_mode(self):
+        return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE
+
+    @verify_mode.setter
+    def verify_mode(self, value):
+        self._verify = True if value == ssl.CERT_REQUIRED else False
+
+    def set_default_verify_paths(self):
+        # So, this has to do something a bit weird. Specifically, what it does
+        # is nothing.
+        #
+        # This means that, if we had previously had load_verify_locations
+        # called, this does not undo that. We need to do that because it turns
+        # out that the rest of the urllib3 code will attempt to load the
+        # default verify paths if it hasn't been told about any paths, even if
+        # the context itself was sometime earlier. We resolve that by just
+        # ignoring it.
+        pass
+
+    def load_default_certs(self):
+        return self.set_default_verify_paths()
+
+    def set_ciphers(self, ciphers):
+        # For now, we just require the default cipher string.
+        if ciphers != util.ssl_.DEFAULT_CIPHERS:
+            raise ValueError("SecureTransport doesn't support custom cipher strings")
+
+    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
+        # OK, we only really support cadata and cafile.
+        if capath is not None:
+            raise ValueError("SecureTransport does not support cert directories")
+
+        self._trust_bundle = cafile or cadata
+
+    def load_cert_chain(self, certfile, keyfile=None, password=None):
+        self._client_cert = certfile
+        self._client_key = keyfile
+        self._client_cert_passphrase = password
+
+    def wrap_socket(
+        self,
+        sock,
+        server_side=False,
+        do_handshake_on_connect=True,
+        suppress_ragged_eofs=True,
+        server_hostname=None,
+    ):
+        # So, what do we do here? Firstly, we assert some properties. This is a
+        # stripped down shim, so there is some functionality we don't support.
+        # See PEP 543 for the real deal.
+        assert not server_side
+        assert do_handshake_on_connect
+        assert suppress_ragged_eofs
+
+        # Ok, we're good to go. Now we want to create the wrapped socket object
+        # and store it in the appropriate place.
+        wrapped_socket = WrappedSocket(sock)
+
+        # Now we can handshake
+        wrapped_socket.handshake(
+            server_hostname,
+            self._verify,
+            self._trust_bundle,
+            self._min_version,
+            self._max_version,
+            self._client_cert,
+            self._client_key,
+            self._client_key_passphrase,
+        )
+        return wrapped_socket
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/socks.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/socks.py
new file mode 100644
index 0000000000000000000000000000000000000000..9e97f7aa98f4ccf380af4b9fc32999d01be8af8c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/contrib/socks.py
@@ -0,0 +1,210 @@
+# -*- coding: utf-8 -*-
+"""
+This module contains provisional support for SOCKS proxies from within
+urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
+SOCKS5. To enable its functionality, either install PySocks or install this
+module with the ``socks`` extra.
+
+The SOCKS implementation supports the full range of urllib3 features. It also
+supports the following SOCKS features:
+
+- SOCKS4A (``proxy_url='socks4a://...``)
+- SOCKS4 (``proxy_url='socks4://...``)
+- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
+- SOCKS5 with local DNS (``proxy_url='socks5://...``)
+- Usernames and passwords for the SOCKS proxy
+
+ .. note::
+    It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
+    your ``proxy_url`` to ensure that DNS resolution is done from the remote
+    server instead of client-side when connecting to a domain name.
+
+SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
+supports IPv4, IPv6, and domain names.
+
+When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
+will be sent as the ``userid`` section of the SOCKS request::
+
+    proxy_url="socks4a://<userid>@proxy-host"
+
+When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
+of the ``proxy_url`` will be sent as the username/password to authenticate
+with the proxy::
+
+    proxy_url="socks5h://<username>:<password>@proxy-host"
+
+"""
+from __future__ import absolute_import
+
+try:
+    import socks
+except ImportError:
+    import warnings
+    from ..exceptions import DependencyWarning
+
+    warnings.warn(
+        (
+            "SOCKS support in urllib3 requires the installation of optional "
+            "dependencies: specifically, PySocks.  For more information, see "
+            "https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies"
+        ),
+        DependencyWarning,
+    )
+    raise
+
+from socket import error as SocketError, timeout as SocketTimeout
+
+from ..connection import HTTPConnection, HTTPSConnection
+from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from ..exceptions import ConnectTimeoutError, NewConnectionError
+from ..poolmanager import PoolManager
+from ..util.url import parse_url
+
+try:
+    import ssl
+except ImportError:
+    ssl = None
+
+
+class SOCKSConnection(HTTPConnection):
+    """
+    A plain-text HTTP connection that connects via a SOCKS proxy.
+    """
+
+    def __init__(self, *args, **kwargs):
+        self._socks_options = kwargs.pop("_socks_options")
+        super(SOCKSConnection, self).__init__(*args, **kwargs)
+
+    def _new_conn(self):
+        """
+        Establish a new connection via the SOCKS proxy.
+        """
+        extra_kw = {}
+        if self.source_address:
+            extra_kw["source_address"] = self.source_address
+
+        if self.socket_options:
+            extra_kw["socket_options"] = self.socket_options
+
+        try:
+            conn = socks.create_connection(
+                (self.host, self.port),
+                proxy_type=self._socks_options["socks_version"],
+                proxy_addr=self._socks_options["proxy_host"],
+                proxy_port=self._socks_options["proxy_port"],
+                proxy_username=self._socks_options["username"],
+                proxy_password=self._socks_options["password"],
+                proxy_rdns=self._socks_options["rdns"],
+                timeout=self.timeout,
+                **extra_kw
+            )
+
+        except SocketTimeout:
+            raise ConnectTimeoutError(
+                self,
+                "Connection to %s timed out. (connect timeout=%s)"
+                % (self.host, self.timeout),
+            )
+
+        except socks.ProxyError as e:
+            # This is fragile as hell, but it seems to be the only way to raise
+            # useful errors here.
+            if e.socket_err:
+                error = e.socket_err
+                if isinstance(error, SocketTimeout):
+                    raise ConnectTimeoutError(
+                        self,
+                        "Connection to %s timed out. (connect timeout=%s)"
+                        % (self.host, self.timeout),
+                    )
+                else:
+                    raise NewConnectionError(
+                        self, "Failed to establish a new connection: %s" % error
+                    )
+            else:
+                raise NewConnectionError(
+                    self, "Failed to establish a new connection: %s" % e
+                )
+
+        except SocketError as e:  # Defensive: PySocks should catch all these.
+            raise NewConnectionError(
+                self, "Failed to establish a new connection: %s" % e
+            )
+
+        return conn
+
+
+# We don't need to duplicate the Verified/Unverified distinction from
+# urllib3/connection.py here because the HTTPSConnection will already have been
+# correctly set to either the Verified or Unverified form by that module. This
+# means the SOCKSHTTPSConnection will automatically be the correct type.
+class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection):
+    pass
+
+
+class SOCKSHTTPConnectionPool(HTTPConnectionPool):
+    ConnectionCls = SOCKSConnection
+
+
+class SOCKSHTTPSConnectionPool(HTTPSConnectionPool):
+    ConnectionCls = SOCKSHTTPSConnection
+
+
+class SOCKSProxyManager(PoolManager):
+    """
+    A version of the urllib3 ProxyManager that routes connections via the
+    defined SOCKS proxy.
+    """
+
+    pool_classes_by_scheme = {
+        "http": SOCKSHTTPConnectionPool,
+        "https": SOCKSHTTPSConnectionPool,
+    }
+
+    def __init__(
+        self,
+        proxy_url,
+        username=None,
+        password=None,
+        num_pools=10,
+        headers=None,
+        **connection_pool_kw
+    ):
+        parsed = parse_url(proxy_url)
+
+        if username is None and password is None and parsed.auth is not None:
+            split = parsed.auth.split(":")
+            if len(split) == 2:
+                username, password = split
+        if parsed.scheme == "socks5":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = False
+        elif parsed.scheme == "socks5h":
+            socks_version = socks.PROXY_TYPE_SOCKS5
+            rdns = True
+        elif parsed.scheme == "socks4":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = False
+        elif parsed.scheme == "socks4a":
+            socks_version = socks.PROXY_TYPE_SOCKS4
+            rdns = True
+        else:
+            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)
+
+        self.proxy_url = proxy_url
+
+        socks_options = {
+            "socks_version": socks_version,
+            "proxy_host": parsed.host,
+            "proxy_port": parsed.port,
+            "username": username,
+            "password": password,
+            "rdns": rdns,
+        }
+        connection_pool_kw["_socks_options"] = socks_options
+
+        super(SOCKSProxyManager, self).__init__(
+            num_pools, headers, **connection_pool_kw
+        )
+
+        self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/exceptions.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..a809ae19394d0b375ac84cf7a5a06dcbf91afb63
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/exceptions.py
@@ -0,0 +1,255 @@
+from __future__ import absolute_import
+from six.moves.http_client import IncompleteRead as httplib_IncompleteRead
+
+# Base Exceptions
+
+
+class HTTPError(Exception):
+    "Base exception used by this module."
+    pass
+
+
+class HTTPWarning(Warning):
+    "Base warning used by this module."
+    pass
+
+
+class PoolError(HTTPError):
+    "Base exception for errors caused within a pool."
+
+    def __init__(self, pool, message):
+        self.pool = pool
+        HTTPError.__init__(self, "%s: %s" % (pool, message))
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, None)
+
+
+class RequestError(PoolError):
+    "Base exception for PoolErrors that have associated URLs."
+
+    def __init__(self, pool, url, message):
+        self.url = url
+        PoolError.__init__(self, pool, message)
+
+    def __reduce__(self):
+        # For pickling purposes.
+        return self.__class__, (None, self.url, None)
+
+
+class SSLError(HTTPError):
+    "Raised when SSL certificate fails in an HTTPS connection."
+    pass
+
+
+class ProxyError(HTTPError):
+    "Raised when the connection to a proxy fails."
+    pass
+
+
+class DecodeError(HTTPError):
+    "Raised when automatic decoding based on Content-Type fails."
+    pass
+
+
+class ProtocolError(HTTPError):
+    "Raised when something unexpected happens mid-request/response."
+    pass
+
+
+#: Renamed to ProtocolError but aliased for backwards compatibility.
+ConnectionError = ProtocolError
+
+
+# Leaf Exceptions
+
+
+class MaxRetryError(RequestError):
+    """Raised when the maximum number of retries is exceeded.
+
+    :param pool: The connection pool
+    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
+    :param string url: The requested Url
+    :param exceptions.Exception reason: The underlying error
+
+    """
+
+    def __init__(self, pool, url, reason=None):
+        self.reason = reason
+
+        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)
+
+        RequestError.__init__(self, pool, url, message)
+
+
+class HostChangedError(RequestError):
+    "Raised when an existing pool gets a request for a foreign host."
+
+    def __init__(self, pool, url, retries=3):
+        message = "Tried to open a foreign host with url: %s" % url
+        RequestError.__init__(self, pool, url, message)
+        self.retries = retries
+
+
+class TimeoutStateError(HTTPError):
+    """ Raised when passing an invalid state to a timeout """
+
+    pass
+
+
+class TimeoutError(HTTPError):
+    """ Raised when a socket timeout error occurs.
+
+    Catching this error will catch both :exc:`ReadTimeoutErrors
+    <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
+    """
+
+    pass
+
+
+class ReadTimeoutError(TimeoutError, RequestError):
+    "Raised when a socket timeout occurs while receiving data from a server"
+    pass
+
+
+# This timeout error does not have a URL attached and needs to inherit from the
+# base HTTPError
+class ConnectTimeoutError(TimeoutError):
+    "Raised when a socket timeout occurs while connecting to a server"
+    pass
+
+
+class NewConnectionError(ConnectTimeoutError, PoolError):
+    "Raised when we fail to establish a new connection. Usually ECONNREFUSED."
+    pass
+
+
+class EmptyPoolError(PoolError):
+    "Raised when a pool runs out of connections and no more are allowed."
+    pass
+
+
+class ClosedPoolError(PoolError):
+    "Raised when a request enters a pool after the pool has been closed."
+    pass
+
+
+class LocationValueError(ValueError, HTTPError):
+    "Raised when there is something wrong with a given URL input."
+    pass
+
+
+class LocationParseError(LocationValueError):
+    "Raised when get_host or similar fails to parse the URL input."
+
+    def __init__(self, location):
+        message = "Failed to parse: %s" % location
+        HTTPError.__init__(self, message)
+
+        self.location = location
+
+
+class ResponseError(HTTPError):
+    "Used as a container for an error reason supplied in a MaxRetryError."
+    GENERIC_ERROR = "too many error responses"
+    SPECIFIC_ERROR = "too many {status_code} error responses"
+
+
+class SecurityWarning(HTTPWarning):
+    "Warned when performing security reducing actions"
+    pass
+
+
+class SubjectAltNameWarning(SecurityWarning):
+    "Warned when connecting to a host with a certificate missing a SAN."
+    pass
+
+
+class InsecureRequestWarning(SecurityWarning):
+    "Warned when making an unverified HTTPS request."
+    pass
+
+
+class SystemTimeWarning(SecurityWarning):
+    "Warned when system time is suspected to be wrong"
+    pass
+
+
+class InsecurePlatformWarning(SecurityWarning):
+    "Warned when certain SSL configuration is not available on a platform."
+    pass
+
+
+class SNIMissingWarning(HTTPWarning):
+    "Warned when making a HTTPS request without SNI available."
+    pass
+
+
+class DependencyWarning(HTTPWarning):
+    """
+    Warned when an attempt is made to import a module with missing optional
+    dependencies.
+    """
+
+    pass
+
+
+class ResponseNotChunked(ProtocolError, ValueError):
+    "Response needs to be chunked in order to read it as chunks."
+    pass
+
+
+class BodyNotHttplibCompatible(HTTPError):
+    """
+    Body should be httplib.HTTPResponse like (have an fp attribute which
+    returns raw chunks) for read_chunked().
+    """
+
+    pass
+
+
+class IncompleteRead(HTTPError, httplib_IncompleteRead):
+    """
+    Response length doesn't match expected Content-Length
+
+    Subclass of http_client.IncompleteRead to allow int value
+    for `partial` to avoid creating large objects on streamed
+    reads.
+    """
+
+    def __init__(self, partial, expected):
+        super(IncompleteRead, self).__init__(partial, expected)
+
+    def __repr__(self):
+        return "IncompleteRead(%i bytes read, %i more expected)" % (
+            self.partial,
+            self.expected,
+        )
+
+
+class InvalidHeader(HTTPError):
+    "The header provided was somehow invalid."
+    pass
+
+
+class ProxySchemeUnknown(AssertionError, ValueError):
+    "ProxyManager does not support the supplied scheme"
+    # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.
+
+    def __init__(self, scheme):
+        message = "Not supported proxy scheme %s" % scheme
+        super(ProxySchemeUnknown, self).__init__(message)
+
+
+class HeaderParsingError(HTTPError):
+    "Raised by assert_header_parsing, but we convert it to a log.warning statement."
+
+    def __init__(self, defects, unparsed_data):
+        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
+        super(HeaderParsingError, self).__init__(message)
+
+
+class UnrewindableBodyError(HTTPError):
+    "urllib3 encountered an error when trying to rewind a body"
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/fields.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/fields.py
new file mode 100644
index 0000000000000000000000000000000000000000..29f95ec3e5415754fdf1dfa9fbd292a6f53582c0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/fields.py
@@ -0,0 +1,273 @@
+from __future__ import absolute_import
+import email.utils
+import mimetypes
+import re
+
+import six
+
+
+def guess_content_type(filename, default="application/octet-stream"):
+    """
+    Guess the "Content-Type" of a file.
+
+    :param filename:
+        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
+    :param default:
+        If no "Content-Type" can be guessed, default to `default`.
+    """
+    if filename:
+        return mimetypes.guess_type(filename)[0] or default
+    return default
+
+
+def format_header_param_rfc2231(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    strategy defined in RFC 2231.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows RFC 2388 Section 4.4.
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        An RFC-2231-formatted unicode string.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    if not any(ch in value for ch in '"\\\r\n'):
+        result = u'%s="%s"' % (name, value)
+        try:
+            result.encode("ascii")
+        except (UnicodeEncodeError, UnicodeDecodeError):
+            pass
+        else:
+            return result
+
+    if six.PY2:  # Python 2:
+        value = value.encode("utf-8")
+
+    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
+    # string in Python 2 but accepts and returns unicode strings in Python 3
+    value = email.utils.encode_rfc2231(value, "utf-8")
+    value = "%s*=%s" % (name, value)
+
+    if six.PY2:  # Python 2:
+        value = value.decode("utf-8")
+
+    return value
+
+
+_HTML5_REPLACEMENTS = {
+    u"\u0022": u"%22",
+    # Replace "\" with "\\".
+    u"\u005C": u"\u005C\u005C",
+    u"\u005C": u"\u005C\u005C",
+}
+
+# All control characters from 0x00 to 0x1F *except* 0x1B.
+_HTML5_REPLACEMENTS.update(
+    {
+        six.unichr(cc): u"%{:02X}".format(cc)
+        for cc in range(0x00, 0x1F + 1)
+        if cc not in (0x1B,)
+    }
+)
+
+
+def _replace_multiple(value, needles_and_replacements):
+    def replacer(match):
+        return needles_and_replacements[match.group(0)]
+
+    pattern = re.compile(
+        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
+    )
+
+    result = pattern.sub(replacer, value)
+
+    return result
+
+
+def format_header_param_html5(name, value):
+    """
+    Helper function to format and quote a single header parameter using the
+    HTML5 strategy.
+
+    Particularly useful for header parameters which might contain
+    non-ASCII values, like file names. This follows the `HTML5 Working Draft
+    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.
+
+    .. _HTML5 Working Draft Section 4.10.22.7:
+        https://w3c.github.io/html/sec-forms.html#multipart-form-data
+
+    :param name:
+        The name of the parameter, a string expected to be ASCII only.
+    :param value:
+        The value of the parameter, provided as ``bytes`` or `str``.
+    :ret:
+        A unicode string, stripped of troublesome characters.
+    """
+    if isinstance(value, six.binary_type):
+        value = value.decode("utf-8")
+
+    value = _replace_multiple(value, _HTML5_REPLACEMENTS)
+
+    return u'%s="%s"' % (name, value)
+
+
+# For backwards-compatibility.
+format_header_param = format_header_param_html5
+
+
+class RequestField(object):
+    """
+    A data container for request body parameters.
+
+    :param name:
+        The name of this request field. Must be unicode.
+    :param data:
+        The data/value body.
+    :param filename:
+        An optional filename of the request field. Must be unicode.
+    :param headers:
+        An optional dict-like object of headers to initially use for the field.
+    :param header_formatter:
+        An optional callable that is used to encode and format the headers. By
+        default, this is :func:`format_header_param_html5`.
+    """
+
+    def __init__(
+        self,
+        name,
+        data,
+        filename=None,
+        headers=None,
+        header_formatter=format_header_param_html5,
+    ):
+        self._name = name
+        self._filename = filename
+        self.data = data
+        self.headers = {}
+        if headers:
+            self.headers = dict(headers)
+        self.header_formatter = header_formatter
+
+    @classmethod
+    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
+        """
+        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.
+
+        Supports constructing :class:`~urllib3.fields.RequestField` from
+        parameter of key/value strings AND key/filetuple. A filetuple is a
+        (filename, data, MIME type) tuple where the MIME type is optional.
+        For example::
+
+            'foo': 'bar',
+            'fakefile': ('foofile.txt', 'contents of foofile'),
+            'realfile': ('barfile.txt', open('realfile').read()),
+            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
+            'nonamefile': 'contents of nonamefile field',
+
+        Field names and filenames must be unicode.
+        """
+        if isinstance(value, tuple):
+            if len(value) == 3:
+                filename, data, content_type = value
+            else:
+                filename, data = value
+                content_type = guess_content_type(filename)
+        else:
+            filename = None
+            content_type = None
+            data = value
+
+        request_param = cls(
+            fieldname, data, filename=filename, header_formatter=header_formatter
+        )
+        request_param.make_multipart(content_type=content_type)
+
+        return request_param
+
+    def _render_part(self, name, value):
+        """
+        Overridable helper function to format a single header parameter. By
+        default, this calls ``self.header_formatter``.
+
+        :param name:
+            The name of the parameter, a string expected to be ASCII only.
+        :param value:
+            The value of the parameter, provided as a unicode string.
+        """
+
+        return self.header_formatter(name, value)
+
+    def _render_parts(self, header_parts):
+        """
+        Helper function to format and quote a single header.
+
+        Useful for single headers that are composed of multiple items. E.g.,
+        'Content-Disposition' fields.
+
+        :param header_parts:
+            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
+            as `k1="v1"; k2="v2"; ...`.
+        """
+        parts = []
+        iterable = header_parts
+        if isinstance(header_parts, dict):
+            iterable = header_parts.items()
+
+        for name, value in iterable:
+            if value is not None:
+                parts.append(self._render_part(name, value))
+
+        return u"; ".join(parts)
+
+    def render_headers(self):
+        """
+        Renders the headers for this request field.
+        """
+        lines = []
+
+        sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
+        for sort_key in sort_keys:
+            if self.headers.get(sort_key, False):
+                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))
+
+        for header_name, header_value in self.headers.items():
+            if header_name not in sort_keys:
+                if header_value:
+                    lines.append(u"%s: %s" % (header_name, header_value))
+
+        lines.append(u"\r\n")
+        return u"\r\n".join(lines)
+
+    def make_multipart(
+        self, content_disposition=None, content_type=None, content_location=None
+    ):
+        """
+        Makes this request field into a multipart request field.
+
+        This method overrides "Content-Disposition", "Content-Type" and
+        "Content-Location" headers to the request parameter.
+
+        :param content_type:
+            The 'Content-Type' of the request body.
+        :param content_location:
+            The 'Content-Location' of the request body.
+
+        """
+        self.headers["Content-Disposition"] = content_disposition or u"form-data"
+        self.headers["Content-Disposition"] += u"; ".join(
+            [
+                u"",
+                self._render_parts(
+                    ((u"name", self._name), (u"filename", self._filename))
+                ),
+            ]
+        )
+        self.headers["Content-Type"] = content_type
+        self.headers["Content-Location"] = content_location
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/filepost.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/filepost.py
new file mode 100644
index 0000000000000000000000000000000000000000..3a4d999d8faf9195d8c35212621f5b5be0e3e48b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/filepost.py
@@ -0,0 +1,98 @@
+from __future__ import absolute_import
+import binascii
+import codecs
+import os
+
+from io import BytesIO
+
+import six
+from six import b
+from .fields import RequestField
+
+writer = codecs.lookup("utf-8")[3]
+
+
+def choose_boundary():
+    """
+    Our embarrassingly-simple replacement for mimetools.choose_boundary.
+    """
+    boundary = binascii.hexlify(os.urandom(16))
+    if not six.PY2:
+        boundary = boundary.decode("ascii")
+    return boundary
+
+
+def iter_field_objects(fields):
+    """
+    Iterate over fields.
+
+    Supports list of (k, v) tuples and dicts, and lists of
+    :class:`~urllib3.fields.RequestField`.
+
+    """
+    if isinstance(fields, dict):
+        i = six.iteritems(fields)
+    else:
+        i = iter(fields)
+
+    for field in i:
+        if isinstance(field, RequestField):
+            yield field
+        else:
+            yield RequestField.from_tuples(*field)
+
+
+def iter_fields(fields):
+    """
+    .. deprecated:: 1.6
+
+    Iterate over fields.
+
+    The addition of :class:`~urllib3.fields.RequestField` makes this function
+    obsolete. Instead, use :func:`iter_field_objects`, which returns
+    :class:`~urllib3.fields.RequestField` objects.
+
+    Supports list of (k, v) tuples and dicts.
+    """
+    if isinstance(fields, dict):
+        return ((k, v) for k, v in six.iteritems(fields))
+
+    return ((k, v) for k, v in fields)
+
+
+def encode_multipart_formdata(fields, boundary=None):
+    """
+    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.
+
+    :param fields:
+        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).
+
+    :param boundary:
+        If not specified, then a random boundary will be generated using
+        :func:`urllib3.filepost.choose_boundary`.
+    """
+    body = BytesIO()
+    if boundary is None:
+        boundary = choose_boundary()
+
+    for field in iter_field_objects(fields):
+        body.write(b("--%s\r\n" % (boundary)))
+
+        writer(body).write(field.render_headers())
+        data = field.data
+
+        if isinstance(data, int):
+            data = str(data)  # Backwards compatibility
+
+        if isinstance(data, six.text_type):
+            writer(body).write(data)
+        else:
+            body.write(data)
+
+        body.write(b"\r\n")
+
+    body.write(b("--%s--\r\n" % (boundary)))
+
+    content_type = str("multipart/form-data; boundary=%s" % boundary)
+
+    return body.getvalue(), content_type
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..ffe70a495e8ef0543e17decca5e3aaee5032ca32
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/__init__.py
@@ -0,0 +1,11 @@
+from __future__ import absolute_import
+
+__all__ = ("ssl_match_hostname",)
+
+try:
+    # cPython >= 2.7.9 has ssl features backported from Python3
+    from ssl import CertificateError
+    del CertificateError
+    import ssl as ssl_match_hostname
+except ImportError:
+    from . import ssl_match_hostname
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/backports/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/backports/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/backports/makefile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/backports/makefile.py
new file mode 100644
index 0000000000000000000000000000000000000000..a3156a69c08d635f9969df59cdd9b3d898882c73
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/backports/makefile.py
@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*-
+"""
+backports.makefile
+~~~~~~~~~~~~~~~~~~
+
+Backports the Python 3 ``socket.makefile`` method for use with anything that
+wants to create a "fake" socket object.
+"""
+import io
+
+from socket import SocketIO
+
+
+def backport_makefile(
+    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
+):
+    """
+    Backport of ``socket.makefile`` from Python 3.5.
+    """
+    if not set(mode) <= {"r", "w", "b"}:
+        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
+    writing = "w" in mode
+    reading = "r" in mode or not writing
+    assert reading or writing
+    binary = "b" in mode
+    rawmode = ""
+    if reading:
+        rawmode += "r"
+    if writing:
+        rawmode += "w"
+    raw = SocketIO(self, rawmode)
+    self._makefile_refs += 1
+    if buffering is None:
+        buffering = -1
+    if buffering < 0:
+        buffering = io.DEFAULT_BUFFER_SIZE
+    if buffering == 0:
+        if not binary:
+            raise ValueError("unbuffered streams must be binary")
+        return raw
+    if reading and writing:
+        buffer = io.BufferedRWPair(raw, raw, buffering)
+    elif reading:
+        buffer = io.BufferedReader(raw, buffering)
+    else:
+        assert writing
+        buffer = io.BufferedWriter(raw, buffering)
+    if binary:
+        return buffer
+    text = io.TextIOWrapper(buffer, encoding, errors, newline)
+    text.mode = mode
+    return text
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..75b6bb1cf0d4f0925410dbaf04f3b2cabd8ade2f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/__init__.py
@@ -0,0 +1,19 @@
+import sys
+
+try:
+    # Our match_hostname function is the same as 3.5's, so we only want to
+    # import the match_hostname function if it's at least that good.
+    if sys.version_info < (3, 5):
+        raise ImportError("Fallback to vendored code")
+
+    from ssl import CertificateError, match_hostname
+except ImportError:
+    try:
+        # Backport of the function from a pypi module
+        from backports.ssl_match_hostname import CertificateError, match_hostname
+    except ImportError:
+        # Our vendored copy
+        from ._implementation import CertificateError, match_hostname
+
+# Not needed, but documenting what we provide.
+__all__ = ("CertificateError", "match_hostname")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/_implementation.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/_implementation.py
new file mode 100644
index 0000000000000000000000000000000000000000..689208d3c63f1318e3a9a084a90e6b4532fa49bb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/packages/ssl_match_hostname/_implementation.py
@@ -0,0 +1,160 @@
+"""The match_hostname() function from Python 3.3.3, essential when using SSL."""
+
+# Note: This file is under the PSF license as the code comes from the python
+# stdlib.   http://docs.python.org/3/license.html
+
+import re
+import sys
+
+# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
+# system, use it to handle IPAddress ServerAltnames (this was added in
+# python-3.5) otherwise only do DNS matching.  This allows
+# backports.ssl_match_hostname to continue to be used in Python 2.7.
+try:
+    import ipaddress
+except ImportError:
+    ipaddress = None
+
+__version__ = "3.5.0.1"
+
+
+class CertificateError(ValueError):
+    pass
+
+
+def _dnsname_match(dn, hostname, max_wildcards=1):
+    """Matching according to RFC 6125, section 6.4.3
+
+    http://tools.ietf.org/html/rfc6125#section-6.4.3
+    """
+    pats = []
+    if not dn:
+        return False
+
+    # Ported from python3-syntax:
+    # leftmost, *remainder = dn.split(r'.')
+    parts = dn.split(r".")
+    leftmost = parts[0]
+    remainder = parts[1:]
+
+    wildcards = leftmost.count("*")
+    if wildcards > max_wildcards:
+        # Issue #17980: avoid denials of service by refusing more
+        # than one wildcard per fragment.  A survey of established
+        # policy among SSL implementations showed it to be a
+        # reasonable choice.
+        raise CertificateError(
+            "too many wildcards in certificate DNS name: " + repr(dn)
+        )
+
+    # speed up common case w/o wildcards
+    if not wildcards:
+        return dn.lower() == hostname.lower()
+
+    # RFC 6125, section 6.4.3, subitem 1.
+    # The client SHOULD NOT attempt to match a presented identifier in which
+    # the wildcard character comprises a label other than the left-most label.
+    if leftmost == "*":
+        # When '*' is a fragment by itself, it matches a non-empty dotless
+        # fragment.
+        pats.append("[^.]+")
+    elif leftmost.startswith("xn--") or hostname.startswith("xn--"):
+        # RFC 6125, section 6.4.3, subitem 3.
+        # The client SHOULD NOT attempt to match a presented identifier
+        # where the wildcard character is embedded within an A-label or
+        # U-label of an internationalized domain name.
+        pats.append(re.escape(leftmost))
+    else:
+        # Otherwise, '*' matches any dotless string, e.g. www*
+        pats.append(re.escape(leftmost).replace(r"\*", "[^.]*"))
+
+    # add the remaining fragments, ignore any wildcards
+    for frag in remainder:
+        pats.append(re.escape(frag))
+
+    pat = re.compile(r"\A" + r"\.".join(pats) + r"\Z", re.IGNORECASE)
+    return pat.match(hostname)
+
+
+def _to_unicode(obj):
+    if isinstance(obj, str) and sys.version_info < (3,):
+        obj = unicode(obj, encoding="ascii", errors="strict")
+    return obj
+
+
+def _ipaddress_match(ipname, host_ip):
+    """Exact matching of IP addresses.
+
+    RFC 6125 explicitly doesn't define an algorithm for this
+    (section 1.7.2 - "Out of Scope").
+    """
+    # OpenSSL may add a trailing newline to a subjectAltName's IP address
+    # Divergence from upstream: ipaddress can't handle byte str
+    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
+    return ip == host_ip
+
+
+def match_hostname(cert, hostname):
+    """Verify that *cert* (in decoded format as returned by
+    SSLSocket.getpeercert()) matches the *hostname*.  RFC 2818 and RFC 6125
+    rules are followed, but IP addresses are not accepted for *hostname*.
+
+    CertificateError is raised on failure. On success, the function
+    returns nothing.
+    """
+    if not cert:
+        raise ValueError(
+            "empty or no certificate, match_hostname needs a "
+            "SSL socket or SSL context with either "
+            "CERT_OPTIONAL or CERT_REQUIRED"
+        )
+    try:
+        # Divergence from upstream: ipaddress can't handle byte str
+        host_ip = ipaddress.ip_address(_to_unicode(hostname))
+    except ValueError:
+        # Not an IP address (common case)
+        host_ip = None
+    except UnicodeError:
+        # Divergence from upstream: Have to deal with ipaddress not taking
+        # byte strings.  addresses should be all ascii, so we consider it not
+        # an ipaddress in this case
+        host_ip = None
+    except AttributeError:
+        # Divergence from upstream: Make ipaddress library optional
+        if ipaddress is None:
+            host_ip = None
+        else:
+            raise
+    dnsnames = []
+    san = cert.get("subjectAltName", ())
+    for key, value in san:
+        if key == "DNS":
+            if host_ip is None and _dnsname_match(value, hostname):
+                return
+            dnsnames.append(value)
+        elif key == "IP Address":
+            if host_ip is not None and _ipaddress_match(value, host_ip):
+                return
+            dnsnames.append(value)
+    if not dnsnames:
+        # The subject is only checked when there is no dNSName entry
+        # in subjectAltName
+        for sub in cert.get("subject", ()):
+            for key, value in sub:
+                # XXX according to RFC 2818, the most specific Common Name
+                # must be used.
+                if key == "commonName":
+                    if _dnsname_match(value, hostname):
+                        return
+                    dnsnames.append(value)
+    if len(dnsnames) > 1:
+        raise CertificateError(
+            "hostname %r "
+            "doesn't match either of %s" % (hostname, ", ".join(map(repr, dnsnames)))
+        )
+    elif len(dnsnames) == 1:
+        raise CertificateError("hostname %r doesn't match %r" % (hostname, dnsnames[0]))
+    else:
+        raise CertificateError(
+            "no appropriate commonName or subjectAltName fields were found"
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/poolmanager.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/poolmanager.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d2688b141fa34662d875da503f18116701cf21d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/poolmanager.py
@@ -0,0 +1,470 @@
+from __future__ import absolute_import
+import collections
+import functools
+import logging
+
+from ._collections import RecentlyUsedContainer
+from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool
+from .connectionpool import port_by_scheme
+from .exceptions import LocationValueError, MaxRetryError, ProxySchemeUnknown
+import six
+from six.moves.urllib.parse import urljoin
+from .request import RequestMethods
+from .util.url import parse_url
+from .util.retry import Retry
+
+
+__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]
+
+
+log = logging.getLogger(__name__)
+
+SSL_KEYWORDS = (
+    "key_file",
+    "cert_file",
+    "cert_reqs",
+    "ca_certs",
+    "ssl_version",
+    "ca_cert_dir",
+    "ssl_context",
+    "key_password",
+)
+
+# All known keyword arguments that could be provided to the pool manager, its
+# pools, or the underlying connections. This is used to construct a pool key.
+_key_fields = (
+    "key_scheme",  # str
+    "key_host",  # str
+    "key_port",  # int
+    "key_timeout",  # int or float or Timeout
+    "key_retries",  # int or Retry
+    "key_strict",  # bool
+    "key_block",  # bool
+    "key_source_address",  # str
+    "key_key_file",  # str
+    "key_key_password",  # str
+    "key_cert_file",  # str
+    "key_cert_reqs",  # str
+    "key_ca_certs",  # str
+    "key_ssl_version",  # str
+    "key_ca_cert_dir",  # str
+    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
+    "key_maxsize",  # int
+    "key_headers",  # dict
+    "key__proxy",  # parsed proxy url
+    "key__proxy_headers",  # dict
+    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
+    "key__socks_options",  # dict
+    "key_assert_hostname",  # bool or string
+    "key_assert_fingerprint",  # str
+    "key_server_hostname",  # str
+)
+
+#: The namedtuple class used to construct keys for the connection pool.
+#: All custom key schemes should include the fields in this key at a minimum.
+PoolKey = collections.namedtuple("PoolKey", _key_fields)
+
+
+def _default_key_normalizer(key_class, request_context):
+    """
+    Create a pool key out of a request context dictionary.
+
+    According to RFC 3986, both the scheme and host are case-insensitive.
+    Therefore, this function normalizes both before constructing the pool
+    key for an HTTPS request. If you wish to change this behaviour, provide
+    alternate callables to ``key_fn_by_scheme``.
+
+    :param key_class:
+        The class to use when constructing the key. This should be a namedtuple
+        with the ``scheme`` and ``host`` keys at a minimum.
+    :type  key_class: namedtuple
+    :param request_context:
+        A dictionary-like object that contain the context for a request.
+    :type  request_context: dict
+
+    :return: A namedtuple that can be used as a connection pool key.
+    :rtype:  PoolKey
+    """
+    # Since we mutate the dictionary, make a copy first
+    context = request_context.copy()
+    context["scheme"] = context["scheme"].lower()
+    context["host"] = context["host"].lower()
+
+    # These are both dictionaries and need to be transformed into frozensets
+    for key in ("headers", "_proxy_headers", "_socks_options"):
+        if key in context and context[key] is not None:
+            context[key] = frozenset(context[key].items())
+
+    # The socket_options key may be a list and needs to be transformed into a
+    # tuple.
+    socket_opts = context.get("socket_options")
+    if socket_opts is not None:
+        context["socket_options"] = tuple(socket_opts)
+
+    # Map the kwargs to the names in the namedtuple - this is necessary since
+    # namedtuples can't have fields starting with '_'.
+    for key in list(context.keys()):
+        context["key_" + key] = context.pop(key)
+
+    # Default to ``None`` for keys missing from the context
+    for field in key_class._fields:
+        if field not in context:
+            context[field] = None
+
+    return key_class(**context)
+
+
+#: A dictionary that maps a scheme to a callable that creates a pool key.
+#: This can be used to alter the way pool keys are constructed, if desired.
+#: Each PoolManager makes a copy of this dictionary so they can be configured
+#: globally here, or individually on the instance.
+key_fn_by_scheme = {
+    "http": functools.partial(_default_key_normalizer, PoolKey),
+    "https": functools.partial(_default_key_normalizer, PoolKey),
+}
+
+pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool}
+
+
+class PoolManager(RequestMethods):
+    """
+    Allows for arbitrary requests while transparently keeping track of
+    necessary connection pools for you.
+
+    :param num_pools:
+        Number of connection pools to cache before discarding the least
+        recently used pool.
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+
+    :param \\**connection_pool_kw:
+        Additional parameters are used to create fresh
+        :class:`urllib3.connectionpool.ConnectionPool` instances.
+
+    Example::
+
+        >>> manager = PoolManager(num_pools=2)
+        >>> r = manager.request('GET', 'http://google.com/')
+        >>> r = manager.request('GET', 'http://google.com/mail')
+        >>> r = manager.request('GET', 'http://yahoo.com/')
+        >>> len(manager.pools)
+        2
+
+    """
+
+    proxy = None
+
+    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
+        RequestMethods.__init__(self, headers)
+        self.connection_pool_kw = connection_pool_kw
+        self.pools = RecentlyUsedContainer(num_pools, dispose_func=lambda p: p.close())
+
+        # Locally set the pool classes and keys so other PoolManagers can
+        # override them.
+        self.pool_classes_by_scheme = pool_classes_by_scheme
+        self.key_fn_by_scheme = key_fn_by_scheme.copy()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.clear()
+        # Return False to re-raise any potential exceptions
+        return False
+
+    def _new_pool(self, scheme, host, port, request_context=None):
+        """
+        Create a new :class:`ConnectionPool` based on host, port, scheme, and
+        any additional pool keyword arguments.
+
+        If ``request_context`` is provided, it is provided as keyword arguments
+        to the pool class used. This method is used to actually create the
+        connection pools handed out by :meth:`connection_from_url` and
+        companion methods. It is intended to be overridden for customization.
+        """
+        pool_cls = self.pool_classes_by_scheme[scheme]
+        if request_context is None:
+            request_context = self.connection_pool_kw.copy()
+
+        # Although the context has everything necessary to create the pool,
+        # this function has historically only used the scheme, host, and port
+        # in the positional args. When an API change is acceptable these can
+        # be removed.
+        for key in ("scheme", "host", "port"):
+            request_context.pop(key, None)
+
+        if scheme == "http":
+            for kw in SSL_KEYWORDS:
+                request_context.pop(kw, None)
+
+        return pool_cls(host, port, **request_context)
+
+    def clear(self):
+        """
+        Empty our store of pools and direct them all to close.
+
+        This will not affect in-flight connections, but they will not be
+        re-used after completion.
+        """
+        self.pools.clear()
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        """
+        Get a :class:`ConnectionPool` based on the host, port, and scheme.
+
+        If ``port`` isn't given, it will be derived from the ``scheme`` using
+        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
+        provided, it is merged with the instance's ``connection_pool_kw``
+        variable and used to create the new connection pool, if one is
+        needed.
+        """
+
+        if not host:
+            raise LocationValueError("No host specified.")
+
+        request_context = self._merge_pool_kwargs(pool_kwargs)
+        request_context["scheme"] = scheme or "http"
+        if not port:
+            port = port_by_scheme.get(request_context["scheme"].lower(), 80)
+        request_context["port"] = port
+        request_context["host"] = host
+
+        return self.connection_from_context(request_context)
+
+    def connection_from_context(self, request_context):
+        """
+        Get a :class:`ConnectionPool` based on the request context.
+
+        ``request_context`` must at least contain the ``scheme`` key and its
+        value must be a key in ``key_fn_by_scheme`` instance variable.
+        """
+        scheme = request_context["scheme"].lower()
+        pool_key_constructor = self.key_fn_by_scheme[scheme]
+        pool_key = pool_key_constructor(request_context)
+
+        return self.connection_from_pool_key(pool_key, request_context=request_context)
+
+    def connection_from_pool_key(self, pool_key, request_context=None):
+        """
+        Get a :class:`ConnectionPool` based on the provided pool key.
+
+        ``pool_key`` should be a namedtuple that only contains immutable
+        objects. At a minimum it must have the ``scheme``, ``host``, and
+        ``port`` fields.
+        """
+        with self.pools.lock:
+            # If the scheme, host, or port doesn't match existing open
+            # connections, open a new ConnectionPool.
+            pool = self.pools.get(pool_key)
+            if pool:
+                return pool
+
+            # Make a fresh ConnectionPool of the desired type
+            scheme = request_context["scheme"]
+            host = request_context["host"]
+            port = request_context["port"]
+            pool = self._new_pool(scheme, host, port, request_context=request_context)
+            self.pools[pool_key] = pool
+
+        return pool
+
+    def connection_from_url(self, url, pool_kwargs=None):
+        """
+        Similar to :func:`urllib3.connectionpool.connection_from_url`.
+
+        If ``pool_kwargs`` is not provided and a new pool needs to be
+        constructed, ``self.connection_pool_kw`` is used to initialize
+        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
+        is provided, it is used instead. Note that if a new pool does not
+        need to be created for the request, the provided ``pool_kwargs`` are
+        not used.
+        """
+        u = parse_url(url)
+        return self.connection_from_host(
+            u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _merge_pool_kwargs(self, override):
+        """
+        Merge a dictionary of override values for self.connection_pool_kw.
+
+        This does not modify self.connection_pool_kw and returns a new dict.
+        Any keys in the override dictionary with a value of ``None`` are
+        removed from the merged dictionary.
+        """
+        base_pool_kwargs = self.connection_pool_kw.copy()
+        if override:
+            for key, value in override.items():
+                if value is None:
+                    try:
+                        del base_pool_kwargs[key]
+                    except KeyError:
+                        pass
+                else:
+                    base_pool_kwargs[key] = value
+        return base_pool_kwargs
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        """
+        Same as :meth:`urllib3.connectionpool.HTTPConnectionPool.urlopen`
+        with custom cross-host redirect logic and only sends the request-uri
+        portion of the ``url``.
+
+        The given ``url`` parameter must be absolute, such that an appropriate
+        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
+        """
+        u = parse_url(url)
+        conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)
+
+        kw["assert_same_host"] = False
+        kw["redirect"] = False
+
+        if "headers" not in kw:
+            kw["headers"] = self.headers.copy()
+
+        if self.proxy is not None and u.scheme == "http":
+            response = conn.urlopen(method, url, **kw)
+        else:
+            response = conn.urlopen(method, u.request_uri, **kw)
+
+        redirect_location = redirect and response.get_redirect_location()
+        if not redirect_location:
+            return response
+
+        # Support relative URLs for redirecting.
+        redirect_location = urljoin(url, redirect_location)
+
+        # RFC 7231, Section 6.4.4
+        if response.status == 303:
+            method = "GET"
+
+        retries = kw.get("retries")
+        if not isinstance(retries, Retry):
+            retries = Retry.from_int(retries, redirect=redirect)
+
+        # Strip headers marked as unsafe to forward to the redirected location.
+        # Check remove_headers_on_redirect to avoid a potential network call within
+        # conn.is_same_host() which may use socket.gethostbyname() in the future.
+        if retries.remove_headers_on_redirect and not conn.is_same_host(
+            redirect_location
+        ):
+            headers = list(six.iterkeys(kw["headers"]))
+            for header in headers:
+                if header.lower() in retries.remove_headers_on_redirect:
+                    kw["headers"].pop(header, None)
+
+        try:
+            retries = retries.increment(method, url, response=response, _pool=conn)
+        except MaxRetryError:
+            if retries.raise_on_redirect:
+                raise
+            return response
+
+        kw["retries"] = retries
+        kw["redirect"] = redirect
+
+        log.info("Redirecting %s -> %s", url, redirect_location)
+        return self.urlopen(method, redirect_location, **kw)
+
+
+class ProxyManager(PoolManager):
+    """
+    Behaves just like :class:`PoolManager`, but sends all requests through
+    the defined proxy, using the CONNECT method for HTTPS URLs.
+
+    :param proxy_url:
+        The URL of the proxy to be used.
+
+    :param proxy_headers:
+        A dictionary containing headers that will be sent to the proxy. In case
+        of HTTP they are being sent with each request, while in the
+        HTTPS/CONNECT case they are sent only once. Could be used for proxy
+        authentication.
+
+    Example:
+        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
+        >>> r1 = proxy.request('GET', 'http://google.com/')
+        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
+        >>> len(proxy.pools)
+        1
+        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
+        >>> r4 = proxy.request('GET', 'https://twitter.com/')
+        >>> len(proxy.pools)
+        3
+
+    """
+
+    def __init__(
+        self,
+        proxy_url,
+        num_pools=10,
+        headers=None,
+        proxy_headers=None,
+        **connection_pool_kw
+    ):
+
+        if isinstance(proxy_url, HTTPConnectionPool):
+            proxy_url = "%s://%s:%i" % (
+                proxy_url.scheme,
+                proxy_url.host,
+                proxy_url.port,
+            )
+        proxy = parse_url(proxy_url)
+        if not proxy.port:
+            port = port_by_scheme.get(proxy.scheme, 80)
+            proxy = proxy._replace(port=port)
+
+        if proxy.scheme not in ("http", "https"):
+            raise ProxySchemeUnknown(proxy.scheme)
+
+        self.proxy = proxy
+        self.proxy_headers = proxy_headers or {}
+
+        connection_pool_kw["_proxy"] = self.proxy
+        connection_pool_kw["_proxy_headers"] = self.proxy_headers
+
+        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)
+
+    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
+        if scheme == "https":
+            return super(ProxyManager, self).connection_from_host(
+                host, port, scheme, pool_kwargs=pool_kwargs
+            )
+
+        return super(ProxyManager, self).connection_from_host(
+            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
+        )
+
+    def _set_proxy_headers(self, url, headers=None):
+        """
+        Sets headers needed by proxies: specifically, the Accept and Host
+        headers. Only sets headers not provided by the user.
+        """
+        headers_ = {"Accept": "*/*"}
+
+        netloc = parse_url(url).netloc
+        if netloc:
+            headers_["Host"] = netloc
+
+        if headers:
+            headers_.update(headers)
+        return headers_
+
+    def urlopen(self, method, url, redirect=True, **kw):
+        "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
+        u = parse_url(url)
+
+        if u.scheme == "http":
+            # For proxied HTTPS requests, httplib sets the necessary headers
+            # on the CONNECT to the proxy. For HTTP, we'll definitely
+            # need to set 'Host' at the very least.
+            headers = kw.get("headers", self.headers)
+            kw["headers"] = self._set_proxy_headers(url, headers)
+
+        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)
+
+
+def proxy_from_url(url, **kw):
+    return ProxyManager(proxy_url=url, **kw)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/request.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/request.py
new file mode 100644
index 0000000000000000000000000000000000000000..2698bc0118c38e7a59fb02457fd2f00ddc1c40ee
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/request.py
@@ -0,0 +1,171 @@
+from __future__ import absolute_import
+
+from .filepost import encode_multipart_formdata
+from six.moves.urllib.parse import urlencode
+
+
+__all__ = ["RequestMethods"]
+
+
+class RequestMethods(object):
+    """
+    Convenience mixin for classes who implement a :meth:`urlopen` method, such
+    as :class:`~urllib3.connectionpool.HTTPConnectionPool` and
+    :class:`~urllib3.poolmanager.PoolManager`.
+
+    Provides behavior for making common types of HTTP request methods and
+    decides which type of request field encoding to use.
+
+    Specifically,
+
+    :meth:`.request_encode_url` is for sending requests whose fields are
+    encoded in the URL (such as GET, HEAD, DELETE).
+
+    :meth:`.request_encode_body` is for sending requests whose fields are
+    encoded in the *body* of the request using multipart or www-form-urlencoded
+    (such as for POST, PUT, PATCH).
+
+    :meth:`.request` is for making any kind of request, it will look up the
+    appropriate encoding format and use one of the above two methods to make
+    the request.
+
+    Initializer parameters:
+
+    :param headers:
+        Headers to include with all requests, unless other headers are given
+        explicitly.
+    """
+
+    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}
+
+    def __init__(self, headers=None):
+        self.headers = headers or {}
+
+    def urlopen(
+        self,
+        method,
+        url,
+        body=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **kw
+    ):  # Abstract
+        raise NotImplementedError(
+            "Classes extending RequestMethods must implement "
+            "their own ``urlopen`` method."
+        )
+
+    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the appropriate encoding of
+        ``fields`` based on the ``method`` used.
+
+        This is a convenience method that requires the least amount of manual
+        effort. It can be used in most situations, while still having the
+        option to drop down to more specific methods when necessary, such as
+        :meth:`request_encode_url`, :meth:`request_encode_body`,
+        or even the lowest level :meth:`urlopen`.
+        """
+        method = method.upper()
+
+        urlopen_kw["request_url"] = url
+
+        if method in self._encode_url_methods:
+            return self.request_encode_url(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+        else:
+            return self.request_encode_body(
+                method, url, fields=fields, headers=headers, **urlopen_kw
+            )
+
+    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": headers}
+        extra_kw.update(urlopen_kw)
+
+        if fields:
+            url += "?" + urlencode(fields)
+
+        return self.urlopen(method, url, **extra_kw)
+
+    def request_encode_body(
+        self,
+        method,
+        url,
+        fields=None,
+        headers=None,
+        encode_multipart=True,
+        multipart_boundary=None,
+        **urlopen_kw
+    ):
+        """
+        Make a request using :meth:`urlopen` with the ``fields`` encoded in
+        the body. This is useful for request methods like POST, PUT, PATCH, etc.
+
+        When ``encode_multipart=True`` (default), then
+        :meth:`urllib3.filepost.encode_multipart_formdata` is used to encode
+        the payload with the appropriate content type. Otherwise
+        :meth:`urllib.urlencode` is used with the
+        'application/x-www-form-urlencoded' content type.
+
+        Multipart encoding must be used when posting files, and it's reasonably
+        safe to use it in other times too. However, it may break request
+        signing, such as with OAuth.
+
+        Supports an optional ``fields`` parameter of key/value strings AND
+        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
+        the MIME type is optional. For example::
+
+            fields = {
+                'foo': 'bar',
+                'fakefile': ('foofile.txt', 'contents of foofile'),
+                'realfile': ('barfile.txt', open('realfile').read()),
+                'typedfile': ('bazfile.bin', open('bazfile').read(),
+                              'image/jpeg'),
+                'nonamefile': 'contents of nonamefile field',
+            }
+
+        When uploading a file, providing a filename (the first parameter of the
+        tuple) is optional but recommended to best mimic behavior of browsers.
+
+        Note that if ``headers`` are supplied, the 'Content-Type' header will
+        be overwritten because it depends on the dynamic random boundary string
+        which is used to compose the body of the request. The random boundary
+        string can be explicitly set with the ``multipart_boundary`` parameter.
+        """
+        if headers is None:
+            headers = self.headers
+
+        extra_kw = {"headers": {}}
+
+        if fields:
+            if "body" in urlopen_kw:
+                raise TypeError(
+                    "request got values for both 'fields' and 'body', can only specify one."
+                )
+
+            if encode_multipart:
+                body, content_type = encode_multipart_formdata(
+                    fields, boundary=multipart_boundary
+                )
+            else:
+                body, content_type = (
+                    urlencode(fields),
+                    "application/x-www-form-urlencoded",
+                )
+
+            extra_kw["body"] = body
+            extra_kw["headers"] = {"Content-Type": content_type}
+
+        extra_kw["headers"].update(headers)
+        extra_kw.update(urlopen_kw)
+
+        return self.urlopen(method, url, **extra_kw)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/response.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/response.py
new file mode 100644
index 0000000000000000000000000000000000000000..a884e1d61e414d41a6b1db3996d6950d9eb08ad3
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/response.py
@@ -0,0 +1,809 @@
+from __future__ import absolute_import
+from contextlib import contextmanager
+import zlib
+import io
+import logging
+from socket import timeout as SocketTimeout
+from socket import error as SocketError
+
+try:
+    import brotli
+except ImportError:
+    brotli = None
+
+from ._collections import HTTPHeaderDict
+from .exceptions import (
+    BodyNotHttplibCompatible,
+    ProtocolError,
+    DecodeError,
+    ReadTimeoutError,
+    ResponseNotChunked,
+    IncompleteRead,
+    InvalidHeader,
+)
+from six import string_types as basestring, PY3
+from six.moves import http_client as httplib
+from .connection import HTTPException, BaseSSLError
+from .util.response import is_fp_closed, is_response_to_head
+
+log = logging.getLogger(__name__)
+
+
+class DeflateDecoder(object):
+    def __init__(self):
+        self._first_try = True
+        self._data = b""
+        self._obj = zlib.decompressobj()
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        if not data:
+            return data
+
+        if not self._first_try:
+            return self._obj.decompress(data)
+
+        self._data += data
+        try:
+            decompressed = self._obj.decompress(data)
+            if decompressed:
+                self._first_try = False
+                self._data = None
+            return decompressed
+        except zlib.error:
+            self._first_try = False
+            self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
+            try:
+                return self.decompress(self._data)
+            finally:
+                self._data = None
+
+
+class GzipDecoderState(object):
+
+    FIRST_MEMBER = 0
+    OTHER_MEMBERS = 1
+    SWALLOW_DATA = 2
+
+
+class GzipDecoder(object):
+    def __init__(self):
+        self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+        self._state = GzipDecoderState.FIRST_MEMBER
+
+    def __getattr__(self, name):
+        return getattr(self._obj, name)
+
+    def decompress(self, data):
+        ret = bytearray()
+        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
+            return bytes(ret)
+        while True:
+            try:
+                ret += self._obj.decompress(data)
+            except zlib.error:
+                previous_state = self._state
+                # Ignore data after the first error
+                self._state = GzipDecoderState.SWALLOW_DATA
+                if previous_state == GzipDecoderState.OTHER_MEMBERS:
+                    # Allow trailing garbage acceptable in other gzip clients
+                    return bytes(ret)
+                raise
+            data = self._obj.unused_data
+            if not data:
+                return bytes(ret)
+            self._state = GzipDecoderState.OTHER_MEMBERS
+            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
+
+
+if brotli is not None:
+
+    class BrotliDecoder(object):
+        # Supports both 'brotlipy' and 'Brotli' packages
+        # since they share an import name. The top branches
+        # are for 'brotlipy' and bottom branches for 'Brotli'
+        def __init__(self):
+            self._obj = brotli.Decompressor()
+
+        def decompress(self, data):
+            if hasattr(self._obj, "decompress"):
+                return self._obj.decompress(data)
+            return self._obj.process(data)
+
+        def flush(self):
+            if hasattr(self._obj, "flush"):
+                return self._obj.flush()
+            return b""
+
+
+class MultiDecoder(object):
+    """
+    From RFC7231:
+        If one or more encodings have been applied to a representation, the
+        sender that applied the encodings MUST generate a Content-Encoding
+        header field that lists the content codings in the order in which
+        they were applied.
+    """
+
+    def __init__(self, modes):
+        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]
+
+    def flush(self):
+        return self._decoders[0].flush()
+
+    def decompress(self, data):
+        for d in reversed(self._decoders):
+            data = d.decompress(data)
+        return data
+
+
+def _get_decoder(mode):
+    if "," in mode:
+        return MultiDecoder(mode)
+
+    if mode == "gzip":
+        return GzipDecoder()
+
+    if brotli is not None and mode == "br":
+        return BrotliDecoder()
+
+    return DeflateDecoder()
+
+
+class HTTPResponse(io.IOBase):
+    """
+    HTTP Response container.
+
+    Backwards-compatible to httplib's HTTPResponse but the response ``body`` is
+    loaded and decoded on-demand when the ``data`` property is accessed.  This
+    class is also compatible with the Python standard library's :mod:`io`
+    module, and can hence be treated as a readable object in the context of that
+    framework.
+
+    Extra parameters for behaviour not present in httplib.HTTPResponse:
+
+    :param preload_content:
+        If True, the response's body will be preloaded during construction.
+
+    :param decode_content:
+        If True, will attempt to decode the body based on the
+        'content-encoding' header.
+
+    :param original_response:
+        When this HTTPResponse wrapper is generated from an httplib.HTTPResponse
+        object, it's convenient to include the original for debug purposes. It's
+        otherwise unused.
+
+    :param retries:
+        The retries contains the last :class:`~urllib3.util.retry.Retry` that
+        was used during the request.
+
+    :param enforce_content_length:
+        Enforce content length checking. Body returned by server must match
+        value of Content-Length header, if present. Otherwise, raise error.
+    """
+
+    CONTENT_DECODERS = ["gzip", "deflate"]
+    if brotli is not None:
+        CONTENT_DECODERS += ["br"]
+    REDIRECT_STATUSES = [301, 302, 303, 307, 308]
+
+    def __init__(
+        self,
+        body="",
+        headers=None,
+        status=0,
+        version=0,
+        reason=None,
+        strict=0,
+        preload_content=True,
+        decode_content=True,
+        original_response=None,
+        pool=None,
+        connection=None,
+        msg=None,
+        retries=None,
+        enforce_content_length=False,
+        request_method=None,
+        request_url=None,
+        auto_close=True,
+    ):
+
+        if isinstance(headers, HTTPHeaderDict):
+            self.headers = headers
+        else:
+            self.headers = HTTPHeaderDict(headers)
+        self.status = status
+        self.version = version
+        self.reason = reason
+        self.strict = strict
+        self.decode_content = decode_content
+        self.retries = retries
+        self.enforce_content_length = enforce_content_length
+        self.auto_close = auto_close
+
+        self._decoder = None
+        self._body = None
+        self._fp = None
+        self._original_response = original_response
+        self._fp_bytes_read = 0
+        self.msg = msg
+        self._request_url = request_url
+
+        if body and isinstance(body, (basestring, bytes)):
+            self._body = body
+
+        self._pool = pool
+        self._connection = connection
+
+        if hasattr(body, "read"):
+            self._fp = body
+
+        # Are we using the chunked-style of transfer encoding?
+        self.chunked = False
+        self.chunk_left = None
+        tr_enc = self.headers.get("transfer-encoding", "").lower()
+        # Don't incur the penalty of creating a list and then discarding it
+        encodings = (enc.strip() for enc in tr_enc.split(","))
+        if "chunked" in encodings:
+            self.chunked = True
+
+        # Determine length of response
+        self.length_remaining = self._init_length(request_method)
+
+        # If requested, preload the body.
+        if preload_content and not self._body:
+            self._body = self.read(decode_content=decode_content)
+
+    def get_redirect_location(self):
+        """
+        Should we redirect and where to?
+
+        :returns: Truthy redirect location string if we got a redirect status
+            code and valid location. ``None`` if redirect status and no
+            location. ``False`` if not a redirect status code.
+        """
+        if self.status in self.REDIRECT_STATUSES:
+            return self.headers.get("location")
+
+        return False
+
+    def release_conn(self):
+        if not self._pool or not self._connection:
+            return
+
+        self._pool._put_conn(self._connection)
+        self._connection = None
+
+    @property
+    def data(self):
+        # For backwords-compat with earlier urllib3 0.4 and earlier.
+        if self._body:
+            return self._body
+
+        if self._fp:
+            return self.read(cache_content=True)
+
+    @property
+    def connection(self):
+        return self._connection
+
+    def isclosed(self):
+        return is_fp_closed(self._fp)
+
+    def tell(self):
+        """
+        Obtain the number of bytes pulled over the wire so far. May differ from
+        the amount of content returned by :meth:``HTTPResponse.read`` if bytes
+        are encoded on the wire (e.g, compressed).
+        """
+        return self._fp_bytes_read
+
+    def _init_length(self, request_method):
+        """
+        Set initial length value for Response content if available.
+        """
+        length = self.headers.get("content-length")
+
+        if length is not None:
+            if self.chunked:
+                # This Response will fail with an IncompleteRead if it can't be
+                # received as chunked. This method falls back to attempt reading
+                # the response before raising an exception.
+                log.warning(
+                    "Received response with both Content-Length and "
+                    "Transfer-Encoding set. This is expressly forbidden "
+                    "by RFC 7230 sec 3.3.2. Ignoring Content-Length and "
+                    "attempting to process response as Transfer-Encoding: "
+                    "chunked."
+                )
+                return None
+
+            try:
+                # RFC 7230 section 3.3.2 specifies multiple content lengths can
+                # be sent in a single Content-Length header
+                # (e.g. Content-Length: 42, 42). This line ensures the values
+                # are all valid ints and that as long as the `set` length is 1,
+                # all values are the same. Otherwise, the header is invalid.
+                lengths = set([int(val) for val in length.split(",")])
+                if len(lengths) > 1:
+                    raise InvalidHeader(
+                        "Content-Length contained multiple "
+                        "unmatching values (%s)" % length
+                    )
+                length = lengths.pop()
+            except ValueError:
+                length = None
+            else:
+                if length < 0:
+                    length = None
+
+        # Convert status to int for comparison
+        # In some cases, httplib returns a status of "_UNKNOWN"
+        try:
+            status = int(self.status)
+        except ValueError:
+            status = 0
+
+        # Check for responses that shouldn't include a body
+        if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD":
+            length = 0
+
+        return length
+
+    def _init_decoder(self):
+        """
+        Set-up the _decoder attribute if necessary.
+        """
+        # Note: content-encoding value should be case-insensitive, per RFC 7230
+        # Section 3.2
+        content_encoding = self.headers.get("content-encoding", "").lower()
+        if self._decoder is None:
+            if content_encoding in self.CONTENT_DECODERS:
+                self._decoder = _get_decoder(content_encoding)
+            elif "," in content_encoding:
+                encodings = [
+                    e.strip()
+                    for e in content_encoding.split(",")
+                    if e.strip() in self.CONTENT_DECODERS
+                ]
+                if len(encodings):
+                    self._decoder = _get_decoder(content_encoding)
+
+    DECODER_ERROR_CLASSES = (IOError, zlib.error)
+    if brotli is not None:
+        DECODER_ERROR_CLASSES += (brotli.error,)
+
+    def _decode(self, data, decode_content, flush_decoder):
+        """
+        Decode the data passed in and potentially flush the decoder.
+        """
+        if not decode_content:
+            return data
+
+        try:
+            if self._decoder:
+                data = self._decoder.decompress(data)
+        except self.DECODER_ERROR_CLASSES as e:
+            content_encoding = self.headers.get("content-encoding", "").lower()
+            raise DecodeError(
+                "Received response with content-encoding: %s, but "
+                "failed to decode it." % content_encoding,
+                e,
+            )
+        if flush_decoder:
+            data += self._flush_decoder()
+
+        return data
+
+    def _flush_decoder(self):
+        """
+        Flushes the decoder. Should only be called if the decoder is actually
+        being used.
+        """
+        if self._decoder:
+            buf = self._decoder.decompress(b"")
+            return buf + self._decoder.flush()
+
+        return b""
+
+    @contextmanager
+    def _error_catcher(self):
+        """
+        Catch low-level python exceptions, instead re-raising urllib3
+        variants, so that low-level exceptions are not leaked in the
+        high-level api.
+
+        On exit, release the connection back to the pool.
+        """
+        clean_exit = False
+
+        try:
+            try:
+                yield
+
+            except SocketTimeout:
+                # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
+                # there is yet no clean way to get at it from this context.
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except BaseSSLError as e:
+                # FIXME: Is there a better way to differentiate between SSLErrors?
+                if "read operation timed out" not in str(e):  # Defensive:
+                    # This shouldn't happen but just in case we're missing an edge
+                    # case, let's avoid swallowing SSL errors.
+                    raise
+
+                raise ReadTimeoutError(self._pool, None, "Read timed out.")
+
+            except (HTTPException, SocketError) as e:
+                # This includes IncompleteRead.
+                raise ProtocolError("Connection broken: %r" % e, e)
+
+            # If no exception is thrown, we should avoid cleaning up
+            # unnecessarily.
+            clean_exit = True
+        finally:
+            # If we didn't terminate cleanly, we need to throw away our
+            # connection.
+            if not clean_exit:
+                # The response may not be closed but we're not going to use it
+                # anymore so close it now to ensure that the connection is
+                # released back to the pool.
+                if self._original_response:
+                    self._original_response.close()
+
+                # Closing the response may not actually be sufficient to close
+                # everything, so if we have a hold of the connection close that
+                # too.
+                if self._connection:
+                    self._connection.close()
+
+            # If we hold the original response but it's closed now, we should
+            # return the connection back to the pool.
+            if self._original_response and self._original_response.isclosed():
+                self.release_conn()
+
+    def read(self, amt=None, decode_content=None, cache_content=False):
+        """
+        Similar to :meth:`httplib.HTTPResponse.read`, but with two additional
+        parameters: ``decode_content`` and ``cache_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+
+        :param cache_content:
+            If True, will save the returned data such that the same result is
+            returned despite of the state of the underlying file object. This
+            is useful if you want the ``.data`` property to continue working
+            after having ``.read()`` the file object. (Overridden if ``amt`` is
+            set.)
+        """
+        self._init_decoder()
+        if decode_content is None:
+            decode_content = self.decode_content
+
+        if self._fp is None:
+            return
+
+        flush_decoder = False
+        fp_closed = getattr(self._fp, "closed", False)
+
+        with self._error_catcher():
+            if amt is None:
+                # cStringIO doesn't like amt=None
+                data = self._fp.read() if not fp_closed else b""
+                flush_decoder = True
+            else:
+                cache_content = False
+                data = self._fp.read(amt) if not fp_closed else b""
+                if (
+                    amt != 0 and not data
+                ):  # Platform-specific: Buggy versions of Python.
+                    # Close the connection when no data is returned
+                    #
+                    # This is redundant to what httplib/http.client _should_
+                    # already do.  However, versions of python released before
+                    # December 15, 2012 (http://bugs.python.org/issue16298) do
+                    # not properly close the connection in all cases. There is
+                    # no harm in redundantly calling close.
+                    self._fp.close()
+                    flush_decoder = True
+                    if self.enforce_content_length and self.length_remaining not in (
+                        0,
+                        None,
+                    ):
+                        # This is an edge case that httplib failed to cover due
+                        # to concerns of backward compatibility. We're
+                        # addressing it here to make sure IncompleteRead is
+                        # raised during streaming, so all calls with incorrect
+                        # Content-Length are caught.
+                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)
+
+        if data:
+            self._fp_bytes_read += len(data)
+            if self.length_remaining is not None:
+                self.length_remaining -= len(data)
+
+            data = self._decode(data, decode_content, flush_decoder)
+
+            if cache_content:
+                self._body = data
+
+        return data
+
+    def stream(self, amt=2 ** 16, decode_content=None):
+        """
+        A generator wrapper for the read() method. A call will block until
+        ``amt`` bytes have been read from the connection or until the
+        connection is closed.
+
+        :param amt:
+            How much of the content to read. The generator will return up to
+            much data per iteration, but may return less. This is particularly
+            likely when using compressed data. However, the empty string will
+            never be returned.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        if self.chunked and self.supports_chunked_reads():
+            for line in self.read_chunked(amt, decode_content=decode_content):
+                yield line
+        else:
+            while not is_fp_closed(self._fp):
+                data = self.read(amt=amt, decode_content=decode_content)
+
+                if data:
+                    yield data
+
+    @classmethod
+    def from_httplib(ResponseCls, r, **response_kw):
+        """
+        Given an :class:`httplib.HTTPResponse` instance ``r``, return a
+        corresponding :class:`urllib3.response.HTTPResponse` object.
+
+        Remaining parameters are passed to the HTTPResponse constructor, along
+        with ``original_response=r``.
+        """
+        headers = r.msg
+
+        if not isinstance(headers, HTTPHeaderDict):
+            if PY3:
+                headers = HTTPHeaderDict(headers.items())
+            else:
+                # Python 2.7
+                headers = HTTPHeaderDict.from_httplib(headers)
+
+        # HTTPResponse objects in Python 3 don't have a .strict attribute
+        strict = getattr(r, "strict", 0)
+        resp = ResponseCls(
+            body=r,
+            headers=headers,
+            status=r.status,
+            version=r.version,
+            reason=r.reason,
+            strict=strict,
+            original_response=r,
+            **response_kw
+        )
+        return resp
+
+    # Backwards-compatibility methods for httplib.HTTPResponse
+    def getheaders(self):
+        return self.headers
+
+    def getheader(self, name, default=None):
+        return self.headers.get(name, default)
+
+    # Backwards compatibility for http.cookiejar
+    def info(self):
+        return self.headers
+
+    # Overrides from io.IOBase
+    def close(self):
+        if not self.closed:
+            self._fp.close()
+
+        if self._connection:
+            self._connection.close()
+
+        if not self.auto_close:
+            io.IOBase.close(self)
+
+    @property
+    def closed(self):
+        if not self.auto_close:
+            return io.IOBase.closed.__get__(self)
+        elif self._fp is None:
+            return True
+        elif hasattr(self._fp, "isclosed"):
+            return self._fp.isclosed()
+        elif hasattr(self._fp, "closed"):
+            return self._fp.closed
+        else:
+            return True
+
+    def fileno(self):
+        if self._fp is None:
+            raise IOError("HTTPResponse has no file to get a fileno from")
+        elif hasattr(self._fp, "fileno"):
+            return self._fp.fileno()
+        else:
+            raise IOError(
+                "The file-like object this HTTPResponse is wrapped "
+                "around has no file descriptor"
+            )
+
+    def flush(self):
+        if (
+            self._fp is not None
+            and hasattr(self._fp, "flush")
+            and not getattr(self._fp, "closed", False)
+        ):
+            return self._fp.flush()
+
+    def readable(self):
+        # This method is required for `io` module compatibility.
+        return True
+
+    def readinto(self, b):
+        # This method is required for `io` module compatibility.
+        temp = self.read(len(b))
+        if len(temp) == 0:
+            return 0
+        else:
+            b[: len(temp)] = temp
+            return len(temp)
+
+    def supports_chunked_reads(self):
+        """
+        Checks if the underlying file-like object looks like a
+        httplib.HTTPResponse object. We do this by testing for the fp
+        attribute. If it is present we assume it returns raw chunks as
+        processed by read_chunked().
+        """
+        return hasattr(self._fp, "fp")
+
+    def _update_chunk_length(self):
+        # First, we'll figure out length of a chunk and then
+        # we'll try to read it from socket.
+        if self.chunk_left is not None:
+            return
+        line = self._fp.fp.readline()
+        line = line.split(b";", 1)[0]
+        try:
+            self.chunk_left = int(line, 16)
+        except ValueError:
+            # Invalid chunked protocol response, abort.
+            self.close()
+            raise httplib.IncompleteRead(line)
+
+    def _handle_chunk(self, amt):
+        returned_chunk = None
+        if amt is None:
+            chunk = self._fp._safe_read(self.chunk_left)
+            returned_chunk = chunk
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        elif amt < self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self.chunk_left = self.chunk_left - amt
+            returned_chunk = value
+        elif amt == self.chunk_left:
+            value = self._fp._safe_read(amt)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+            returned_chunk = value
+        else:  # amt > self.chunk_left
+            returned_chunk = self._fp._safe_read(self.chunk_left)
+            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
+            self.chunk_left = None
+        return returned_chunk
+
+    def read_chunked(self, amt=None, decode_content=None):
+        """
+        Similar to :meth:`HTTPResponse.read`, but with an additional
+        parameter: ``decode_content``.
+
+        :param amt:
+            How much of the content to read. If specified, caching is skipped
+            because it doesn't make sense to cache partial content as the full
+            response.
+
+        :param decode_content:
+            If True, will attempt to decode the body based on the
+            'content-encoding' header.
+        """
+        self._init_decoder()
+        # FIXME: Rewrite this method and make it a class with a better structured logic.
+        if not self.chunked:
+            raise ResponseNotChunked(
+                "Response is not chunked. "
+                "Header 'transfer-encoding: chunked' is missing."
+            )
+        if not self.supports_chunked_reads():
+            raise BodyNotHttplibCompatible(
+                "Body should be httplib.HTTPResponse like. "
+                "It should have have an fp attribute which returns raw chunks."
+            )
+
+        with self._error_catcher():
+            # Don't bother reading the body of a HEAD request.
+            if self._original_response and is_response_to_head(self._original_response):
+                self._original_response.close()
+                return
+
+            # If a response is already read and closed
+            # then return immediately.
+            if self._fp.fp is None:
+                return
+
+            while True:
+                self._update_chunk_length()
+                if self.chunk_left == 0:
+                    break
+                chunk = self._handle_chunk(amt)
+                decoded = self._decode(
+                    chunk, decode_content=decode_content, flush_decoder=False
+                )
+                if decoded:
+                    yield decoded
+
+            if decode_content:
+                # On CPython and PyPy, we should never need to flush the
+                # decoder. However, on Jython we *might* need to, so
+                # lets defensively do it anyway.
+                decoded = self._flush_decoder()
+                if decoded:  # Platform-specific: Jython.
+                    yield decoded
+
+            # Chunk content ends with \r\n: discard it.
+            while True:
+                line = self._fp.fp.readline()
+                if not line:
+                    # Some sites may not end with '\r\n'.
+                    break
+                if line == b"\r\n":
+                    break
+
+            # We read everything; close the "file".
+            if self._original_response:
+                self._original_response.close()
+
+    def geturl(self):
+        """
+        Returns the URL that was the source of this response.
+        If the request that generated this response redirected, this method
+        will return the final redirect location.
+        """
+        if self.retries is not None and len(self.retries.history):
+            return self.retries.history[-1].redirect_location
+        else:
+            return self._request_url
+
+    def __iter__(self):
+        buffer = []
+        for chunk in self.stream(decode_content=True):
+            if b"\n" in chunk:
+                chunk = chunk.split(b"\n")
+                yield b"".join(buffer) + chunk[0] + b"\n"
+                for x in chunk[1:-1]:
+                    yield x + b"\n"
+                if chunk[-1]:
+                    buffer = [chunk[-1]]
+                else:
+                    buffer = []
+            else:
+                buffer.append(chunk)
+        if buffer:
+            yield b"".join(buffer)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a96c73a9d85187af6923d548a5cc517f1517e205
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/__init__.py
@@ -0,0 +1,46 @@
+from __future__ import absolute_import
+
+# For backwards compatibility, provide imports that used to be here.
+from .connection import is_connection_dropped
+from .request import make_headers
+from .response import is_fp_closed
+from .ssl_ import (
+    SSLContext,
+    HAS_SNI,
+    IS_PYOPENSSL,
+    IS_SECURETRANSPORT,
+    assert_fingerprint,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+    PROTOCOL_TLS,
+)
+from .timeout import current_time, Timeout
+
+from .retry import Retry
+from .url import get_host, parse_url, split_first, Url
+from .wait import wait_for_read, wait_for_write
+
+__all__ = (
+    "HAS_SNI",
+    "IS_PYOPENSSL",
+    "IS_SECURETRANSPORT",
+    "SSLContext",
+    "PROTOCOL_TLS",
+    "Retry",
+    "Timeout",
+    "Url",
+    "assert_fingerprint",
+    "current_time",
+    "is_connection_dropped",
+    "is_fp_closed",
+    "get_host",
+    "parse_url",
+    "make_headers",
+    "resolve_cert_reqs",
+    "resolve_ssl_version",
+    "split_first",
+    "ssl_wrap_socket",
+    "wait_for_read",
+    "wait_for_write",
+)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/connection.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/connection.py
new file mode 100644
index 0000000000000000000000000000000000000000..86f0a3b00edc11b2a313c9c7b2109d04f02bb5f6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/connection.py
@@ -0,0 +1,138 @@
+from __future__ import absolute_import
+import socket
+from .wait import NoWayToWaitForSocketError, wait_for_read
+from ..contrib import _appengine_environ
+
+
+def is_connection_dropped(conn):  # Platform-specific
+    """
+    Returns True if the connection is dropped and should be closed.
+
+    :param conn:
+        :class:`httplib.HTTPConnection` object.
+
+    Note: For platforms like AppEngine, this will always return ``False`` to
+    let the platform handle connection recycling transparently for us.
+    """
+    sock = getattr(conn, "sock", False)
+    if sock is False:  # Platform-specific: AppEngine
+        return False
+    if sock is None:  # Connection already closed (such as by httplib).
+        return True
+    try:
+        # Returns True if readable, which here means it's been dropped
+        return wait_for_read(sock, timeout=0.0)
+    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
+        return False
+
+
+# This function is copied from socket.py in the Python 2.7 standard
+# library test suite. Added to its signature is only `socket_options`.
+# One additional modification is that we avoid binding to IPv6 servers
+# discovered in DNS if the system doesn't have IPv6 functionality.
+def create_connection(
+    address,
+    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
+    source_address=None,
+    socket_options=None,
+):
+    """Connect to *address* and return the socket object.
+
+    Convenience function.  Connect to *address* (a 2-tuple ``(host,
+    port)``) and return the socket object.  Passing the optional
+    *timeout* parameter will set the timeout on the socket instance
+    before attempting to connect.  If no *timeout* is supplied, the
+    global default timeout setting returned by :func:`getdefaulttimeout`
+    is used.  If *source_address* is set it must be a tuple of (host, port)
+    for the socket to bind as a source address before making the connection.
+    An host of '' or port 0 tells the OS to use the default.
+    """
+
+    host, port = address
+    if host.startswith("["):
+        host = host.strip("[]")
+    err = None
+
+    # Using the value from allowed_gai_family() in the context of getaddrinfo lets
+    # us select whether to work with IPv4 DNS records, IPv6 records, or both.
+    # The original create_connection function always returns all records.
+    family = allowed_gai_family()
+
+    for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
+        af, socktype, proto, canonname, sa = res
+        sock = None
+        try:
+            sock = socket.socket(af, socktype, proto)
+
+            # If provided, set socket level options before connecting.
+            _set_socket_options(sock, socket_options)
+
+            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
+                sock.settimeout(timeout)
+            if source_address:
+                sock.bind(source_address)
+            sock.connect(sa)
+            return sock
+
+        except socket.error as e:
+            err = e
+            if sock is not None:
+                sock.close()
+                sock = None
+
+    if err is not None:
+        raise err
+
+    raise socket.error("getaddrinfo returns an empty list")
+
+
+def _set_socket_options(sock, options):
+    if options is None:
+        return
+
+    for opt in options:
+        sock.setsockopt(*opt)
+
+
+def allowed_gai_family():
+    """This function is designed to work in the context of
+    getaddrinfo, where family=socket.AF_UNSPEC is the default and
+    will perform a DNS search for both IPv6 and IPv4 records."""
+
+    family = socket.AF_INET
+    if HAS_IPV6:
+        family = socket.AF_UNSPEC
+    return family
+
+
+def _has_ipv6(host):
+    """ Returns True if the system can bind an IPv6 address. """
+    sock = None
+    has_ipv6 = False
+
+    # App Engine doesn't support IPV6 sockets and actually has a quota on the
+    # number of sockets that can be used, so just early out here instead of
+    # creating a socket needlessly.
+    # See https://github.com/urllib3/urllib3/issues/1446
+    if _appengine_environ.is_appengine_sandbox():
+        return False
+
+    if socket.has_ipv6:
+        # has_ipv6 returns true if cPython was compiled with IPv6 support.
+        # It does not tell us if the system has IPv6 support enabled. To
+        # determine that we must bind to an IPv6 address.
+        # https://github.com/urllib3/urllib3/pull/611
+        # https://bugs.python.org/issue658327
+        try:
+            sock = socket.socket(socket.AF_INET6)
+            sock.bind((host, 0))
+            has_ipv6 = True
+        except Exception:
+            pass
+
+    if sock:
+        sock.close()
+    return has_ipv6
+
+
+HAS_IPV6 = _has_ipv6("::1")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/queue.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/queue.py
new file mode 100644
index 0000000000000000000000000000000000000000..bade85678271d0717ba5b6f6320d4fa2da1d3651
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/queue.py
@@ -0,0 +1,21 @@
+import collections
+import six
+from six.moves import queue
+
+if six.PY2:
+    # Queue is imported for side effects on MS Windows. See issue #229.
+    import Queue as _unused_module_Queue  # noqa: F401
+
+
+class LifoQueue(queue.Queue):
+    def _init(self, _):
+        self.queue = collections.deque()
+
+    def _qsize(self, len=len):
+        return len(self.queue)
+
+    def _put(self, item):
+        self.queue.append(item)
+
+    def _get(self):
+        return self.queue.pop()
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/request.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/request.py
new file mode 100644
index 0000000000000000000000000000000000000000..56ae1d64f159544c519ecbbc8c47bc320e3317e8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/request.py
@@ -0,0 +1,135 @@
+from __future__ import absolute_import
+from base64 import b64encode
+
+from six import b, integer_types
+from ..exceptions import UnrewindableBodyError
+
+ACCEPT_ENCODING = "gzip,deflate"
+try:
+    import brotli as _unused_module_brotli  # noqa: F401
+except ImportError:
+    pass
+else:
+    ACCEPT_ENCODING += ",br"
+
+_FAILEDTELL = object()
+
+
+def make_headers(
+    keep_alive=None,
+    accept_encoding=None,
+    user_agent=None,
+    basic_auth=None,
+    proxy_basic_auth=None,
+    disable_cache=None,
+):
+    """
+    Shortcuts for generating request headers.
+
+    :param keep_alive:
+        If ``True``, adds 'connection: keep-alive' header.
+
+    :param accept_encoding:
+        Can be a boolean, list, or string.
+        ``True`` translates to 'gzip,deflate'.
+        List will get joined by comma.
+        String will be used as provided.
+
+    :param user_agent:
+        String representing the user-agent you want, such as
+        "python-urllib3/0.6"
+
+    :param basic_auth:
+        Colon-separated username:password string for 'authorization: basic ...'
+        auth header.
+
+    :param proxy_basic_auth:
+        Colon-separated username:password string for 'proxy-authorization: basic ...'
+        auth header.
+
+    :param disable_cache:
+        If ``True``, adds 'cache-control: no-cache' header.
+
+    Example::
+
+        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
+        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
+        >>> make_headers(accept_encoding=True)
+        {'accept-encoding': 'gzip,deflate'}
+    """
+    headers = {}
+    if accept_encoding:
+        if isinstance(accept_encoding, str):
+            pass
+        elif isinstance(accept_encoding, list):
+            accept_encoding = ",".join(accept_encoding)
+        else:
+            accept_encoding = ACCEPT_ENCODING
+        headers["accept-encoding"] = accept_encoding
+
+    if user_agent:
+        headers["user-agent"] = user_agent
+
+    if keep_alive:
+        headers["connection"] = "keep-alive"
+
+    if basic_auth:
+        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")
+
+    if proxy_basic_auth:
+        headers["proxy-authorization"] = "Basic " + b64encode(
+            b(proxy_basic_auth)
+        ).decode("utf-8")
+
+    if disable_cache:
+        headers["cache-control"] = "no-cache"
+
+    return headers
+
+
+def set_file_position(body, pos):
+    """
+    If a position is provided, move file to that point.
+    Otherwise, we'll attempt to record a position for future use.
+    """
+    if pos is not None:
+        rewind_body(body, pos)
+    elif getattr(body, "tell", None) is not None:
+        try:
+            pos = body.tell()
+        except (IOError, OSError):
+            # This differentiates from None, allowing us to catch
+            # a failed `tell()` later when trying to rewind the body.
+            pos = _FAILEDTELL
+
+    return pos
+
+
+def rewind_body(body, body_pos):
+    """
+    Attempt to rewind body to a certain position.
+    Primarily used for request redirects and retries.
+
+    :param body:
+        File-like object that supports seek.
+
+    :param int pos:
+        Position to seek to in file.
+    """
+    body_seek = getattr(body, "seek", None)
+    if body_seek is not None and isinstance(body_pos, integer_types):
+        try:
+            body_seek(body_pos)
+        except (IOError, OSError):
+            raise UnrewindableBodyError(
+                "An error occurred when rewinding request body for redirect/retry."
+            )
+    elif body_pos is _FAILEDTELL:
+        raise UnrewindableBodyError(
+            "Unable to record file position for rewinding "
+            "request body during a redirect/retry."
+        )
+    else:
+        raise ValueError(
+            "body_pos must be of type integer, instead it was %s." % type(body_pos)
+        )
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/response.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/response.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf2ab614780c345eadb0003c667b74fb8565c3bf
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/response.py
@@ -0,0 +1,86 @@
+from __future__ import absolute_import
+from six.moves import http_client as httplib
+
+from ..exceptions import HeaderParsingError
+
+
+def is_fp_closed(obj):
+    """
+    Checks whether a given file-like object is closed.
+
+    :param obj:
+        The file-like object to check.
+    """
+
+    try:
+        # Check `isclosed()` first, in case Python3 doesn't set `closed`.
+        # GH Issue #928
+        return obj.isclosed()
+    except AttributeError:
+        pass
+
+    try:
+        # Check via the official file-like-object way.
+        return obj.closed
+    except AttributeError:
+        pass
+
+    try:
+        # Check if the object is a container for another file-like object that
+        # gets released on exhaustion (e.g. HTTPResponse).
+        return obj.fp is None
+    except AttributeError:
+        pass
+
+    raise ValueError("Unable to determine whether fp is closed.")
+
+
+def assert_header_parsing(headers):
+    """
+    Asserts whether all headers have been successfully parsed.
+    Extracts encountered errors from the result of parsing headers.
+
+    Only works on Python 3.
+
+    :param headers: Headers to verify.
+    :type headers: `httplib.HTTPMessage`.
+
+    :raises urllib3.exceptions.HeaderParsingError:
+        If parsing errors are found.
+    """
+
+    # This will fail silently if we pass in the wrong kind of parameter.
+    # To make debugging easier add an explicit check.
+    if not isinstance(headers, httplib.HTTPMessage):
+        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))
+
+    defects = getattr(headers, "defects", None)
+    get_payload = getattr(headers, "get_payload", None)
+
+    unparsed_data = None
+    if get_payload:
+        # get_payload is actually email.message.Message.get_payload;
+        # we're only interested in the result if it's not a multipart message
+        if not headers.is_multipart():
+            payload = get_payload()
+
+            if isinstance(payload, (bytes, str)):
+                unparsed_data = payload
+
+    if defects or unparsed_data:
+        raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)
+
+
+def is_response_to_head(response):
+    """
+    Checks whether the request of a response has been a HEAD-request.
+    Handles the quirks of AppEngine.
+
+    :param conn:
+    :type conn: :class:`httplib.HTTPResponse`
+    """
+    # FIXME: Can we do this somehow without accessing private httplib _method?
+    method = response._method
+    if isinstance(method, int):  # Platform-specific: Appengine
+        return method == 3
+    return method.upper() == "HEAD"
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/retry.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/retry.py
new file mode 100644
index 0000000000000000000000000000000000000000..ce61e50d5a82473e51493d5d09b7dbac4dcbae3f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/retry.py
@@ -0,0 +1,450 @@
+from __future__ import absolute_import
+import time
+import logging
+from collections import namedtuple
+from itertools import takewhile
+import email
+import re
+
+from ..exceptions import (
+    ConnectTimeoutError,
+    MaxRetryError,
+    ProtocolError,
+    ReadTimeoutError,
+    ResponseError,
+    InvalidHeader,
+)
+import six
+
+
+log = logging.getLogger(__name__)
+
+
+# Data structure for representing the metadata of requests that result in a retry.
+RequestHistory = namedtuple(
+    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
+)
+
+
+class Retry(object):
+    """ Retry configuration.
+
+    Each retry attempt will create a new Retry object with updated values, so
+    they can be safely reused.
+
+    Retries can be defined as a default for a pool::
+
+        retries = Retry(connect=5, read=2, redirect=5)
+        http = PoolManager(retries=retries)
+        response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool)::
+
+        response = http.request('GET', 'http://example.com/', retries=Retry(10))
+
+    Retries can be disabled by passing ``False``::
+
+        response = http.request('GET', 'http://example.com/', retries=False)
+
+    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
+    retries are disabled, in which case the causing exception will be raised.
+
+    :param int total:
+        Total number of retries to allow. Takes precedence over other counts.
+
+        Set to ``None`` to remove this constraint and fall back on other
+        counts. It's a good idea to set this to some sensibly-high value to
+        account for unexpected edge cases and avoid infinite retry loops.
+
+        Set to ``0`` to fail on the first retry.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int connect:
+        How many connection-related errors to retry on.
+
+        These are errors raised before the request is sent to the remote server,
+        which we assume has not triggered the server to process the request.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int read:
+        How many times to retry on read errors.
+
+        These errors are raised after the request was sent to the server, so the
+        request may have side-effects.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param int redirect:
+        How many redirects to perform. Limit this to avoid infinite redirect
+        loops.
+
+        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
+        308.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+        Set to ``False`` to disable and imply ``raise_on_redirect=False``.
+
+    :param int status:
+        How many times to retry on bad status codes.
+
+        These are retries made on responses, where status code matches
+        ``status_forcelist``.
+
+        Set to ``0`` to fail on the first retry of this type.
+
+    :param iterable method_whitelist:
+        Set of uppercased HTTP method verbs that we should retry on.
+
+        By default, we only retry on methods which are considered to be
+        idempotent (multiple requests with the same parameters end with the
+        same state). See :attr:`Retry.DEFAULT_METHOD_WHITELIST`.
+
+        Set to a ``False`` value to retry on any verb.
+
+    :param iterable status_forcelist:
+        A set of integer HTTP status codes that we should force a retry on.
+        A retry is initiated if the request method is in ``method_whitelist``
+        and the response status code is in ``status_forcelist``.
+
+        By default, this is disabled with ``None``.
+
+    :param float backoff_factor:
+        A backoff factor to apply between attempts after the second try
+        (most errors are resolved immediately by a second try without a
+        delay). urllib3 will sleep for::
+
+            {backoff factor} * (2 ** ({number of total retries} - 1))
+
+        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
+        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
+        than :attr:`Retry.BACKOFF_MAX`.
+
+        By default, backoff is disabled (set to 0).
+
+    :param bool raise_on_redirect: Whether, if the number of redirects is
+        exhausted, to raise a MaxRetryError, or to return a response with a
+        response code in the 3xx range.
+
+    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
+        whether we should raise an exception, or return a response,
+        if status falls in ``status_forcelist`` range and retries have
+        been exhausted.
+
+    :param tuple history: The history of the request encountered during
+        each call to :meth:`~Retry.increment`. The list is in the order
+        the requests occurred. Each list item is of class :class:`RequestHistory`.
+
+    :param bool respect_retry_after_header:
+        Whether to respect Retry-After header on status codes defined as
+        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.
+
+    :param iterable remove_headers_on_redirect:
+        Sequence of headers to remove from the request when a response
+        indicating a redirect is returned before firing off the redirected
+        request.
+    """
+
+    DEFAULT_METHOD_WHITELIST = frozenset(
+        ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
+    )
+
+    RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])
+
+    DEFAULT_REDIRECT_HEADERS_BLACKLIST = frozenset(["Authorization"])
+
+    #: Maximum backoff time.
+    BACKOFF_MAX = 120
+
+    def __init__(
+        self,
+        total=10,
+        connect=None,
+        read=None,
+        redirect=None,
+        status=None,
+        method_whitelist=DEFAULT_METHOD_WHITELIST,
+        status_forcelist=None,
+        backoff_factor=0,
+        raise_on_redirect=True,
+        raise_on_status=True,
+        history=None,
+        respect_retry_after_header=True,
+        remove_headers_on_redirect=DEFAULT_REDIRECT_HEADERS_BLACKLIST,
+    ):
+
+        self.total = total
+        self.connect = connect
+        self.read = read
+        self.status = status
+
+        if redirect is False or total is False:
+            redirect = 0
+            raise_on_redirect = False
+
+        self.redirect = redirect
+        self.status_forcelist = status_forcelist or set()
+        self.method_whitelist = method_whitelist
+        self.backoff_factor = backoff_factor
+        self.raise_on_redirect = raise_on_redirect
+        self.raise_on_status = raise_on_status
+        self.history = history or tuple()
+        self.respect_retry_after_header = respect_retry_after_header
+        self.remove_headers_on_redirect = frozenset(
+            [h.lower() for h in remove_headers_on_redirect]
+        )
+
+    def new(self, **kw):
+        params = dict(
+            total=self.total,
+            connect=self.connect,
+            read=self.read,
+            redirect=self.redirect,
+            status=self.status,
+            method_whitelist=self.method_whitelist,
+            status_forcelist=self.status_forcelist,
+            backoff_factor=self.backoff_factor,
+            raise_on_redirect=self.raise_on_redirect,
+            raise_on_status=self.raise_on_status,
+            history=self.history,
+            remove_headers_on_redirect=self.remove_headers_on_redirect,
+            respect_retry_after_header=self.respect_retry_after_header,
+        )
+        params.update(kw)
+        return type(self)(**params)
+
+    @classmethod
+    def from_int(cls, retries, redirect=True, default=None):
+        """ Backwards-compatibility for the old retries format."""
+        if retries is None:
+            retries = default if default is not None else cls.DEFAULT
+
+        if isinstance(retries, Retry):
+            return retries
+
+        redirect = bool(redirect) and None
+        new_retries = cls(retries, redirect=redirect)
+        log.debug("Converted retries value: %r -> %r", retries, new_retries)
+        return new_retries
+
+    def get_backoff_time(self):
+        """ Formula for computing the current backoff
+
+        :rtype: float
+        """
+        # We want to consider only the last consecutive errors sequence (Ignore redirects).
+        consecutive_errors_len = len(
+            list(
+                takewhile(lambda x: x.redirect_location is None, reversed(self.history))
+            )
+        )
+        if consecutive_errors_len <= 1:
+            return 0
+
+        backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
+        return min(self.BACKOFF_MAX, backoff_value)
+
+    def parse_retry_after(self, retry_after):
+        # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
+        if re.match(r"^\s*[0-9]+\s*$", retry_after):
+            seconds = int(retry_after)
+        else:
+            retry_date_tuple = email.utils.parsedate(retry_after)
+            if retry_date_tuple is None:
+                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
+            retry_date = time.mktime(retry_date_tuple)
+            seconds = retry_date - time.time()
+
+        if seconds < 0:
+            seconds = 0
+
+        return seconds
+
+    def get_retry_after(self, response):
+        """ Get the value of Retry-After in seconds. """
+
+        retry_after = response.getheader("Retry-After")
+
+        if retry_after is None:
+            return None
+
+        return self.parse_retry_after(retry_after)
+
+    def sleep_for_retry(self, response=None):
+        retry_after = self.get_retry_after(response)
+        if retry_after:
+            time.sleep(retry_after)
+            return True
+
+        return False
+
+    def _sleep_backoff(self):
+        backoff = self.get_backoff_time()
+        if backoff <= 0:
+            return
+        time.sleep(backoff)
+
+    def sleep(self, response=None):
+        """ Sleep between retry attempts.
+
+        This method will respect a server's ``Retry-After`` response header
+        and sleep the duration of the time requested. If that is not present, it
+        will use an exponential backoff. By default, the backoff factor is 0 and
+        this method will return immediately.
+        """
+
+        if self.respect_retry_after_header and response:
+            slept = self.sleep_for_retry(response)
+            if slept:
+                return
+
+        self._sleep_backoff()
+
+    def _is_connection_error(self, err):
+        """ Errors when we're fairly sure that the server did not receive the
+        request, so it should be safe to retry.
+        """
+        return isinstance(err, ConnectTimeoutError)
+
+    def _is_read_error(self, err):
+        """ Errors that occur after the request has been started, so we should
+        assume that the server began processing it.
+        """
+        return isinstance(err, (ReadTimeoutError, ProtocolError))
+
+    def _is_method_retryable(self, method):
+        """ Checks if a given HTTP method should be retried upon, depending if
+        it is included on the method whitelist.
+        """
+        if self.method_whitelist and method.upper() not in self.method_whitelist:
+            return False
+
+        return True
+
+    def is_retry(self, method, status_code, has_retry_after=False):
+        """ Is this method/status code retryable? (Based on whitelists and control
+        variables such as the number of total retries to allow, whether to
+        respect the Retry-After header, whether this header is present, and
+        whether the returned status code is on the list of status codes to
+        be retried upon on the presence of the aforementioned header)
+        """
+        if not self._is_method_retryable(method):
+            return False
+
+        if self.status_forcelist and status_code in self.status_forcelist:
+            return True
+
+        return (
+            self.total
+            and self.respect_retry_after_header
+            and has_retry_after
+            and (status_code in self.RETRY_AFTER_STATUS_CODES)
+        )
+
+    def is_exhausted(self):
+        """ Are we out of retries? """
+        retry_counts = (self.total, self.connect, self.read, self.redirect, self.status)
+        retry_counts = list(filter(None, retry_counts))
+        if not retry_counts:
+            return False
+
+        return min(retry_counts) < 0
+
+    def increment(
+        self,
+        method=None,
+        url=None,
+        response=None,
+        error=None,
+        _pool=None,
+        _stacktrace=None,
+    ):
+        """ Return a new Retry object with incremented retry counters.
+
+        :param response: A response object, or None, if the server did not
+            return a response.
+        :type response: :class:`~urllib3.response.HTTPResponse`
+        :param Exception error: An error encountered during the request, or
+            None if the response was received successfully.
+
+        :return: A new ``Retry`` object.
+        """
+        if self.total is False and error:
+            # Disabled, indicate to re-raise the error.
+            raise six.reraise(type(error), error, _stacktrace)
+
+        total = self.total
+        if total is not None:
+            total -= 1
+
+        connect = self.connect
+        read = self.read
+        redirect = self.redirect
+        status_count = self.status
+        cause = "unknown"
+        status = None
+        redirect_location = None
+
+        if error and self._is_connection_error(error):
+            # Connect retry?
+            if connect is False:
+                raise six.reraise(type(error), error, _stacktrace)
+            elif connect is not None:
+                connect -= 1
+
+        elif error and self._is_read_error(error):
+            # Read retry?
+            if read is False or not self._is_method_retryable(method):
+                raise six.reraise(type(error), error, _stacktrace)
+            elif read is not None:
+                read -= 1
+
+        elif response and response.get_redirect_location():
+            # Redirect retry?
+            if redirect is not None:
+                redirect -= 1
+            cause = "too many redirects"
+            redirect_location = response.get_redirect_location()
+            status = response.status
+
+        else:
+            # Incrementing because of a server error like a 500 in
+            # status_forcelist and a the given method is in the whitelist
+            cause = ResponseError.GENERIC_ERROR
+            if response and response.status:
+                if status_count is not None:
+                    status_count -= 1
+                cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status)
+                status = response.status
+
+        history = self.history + (
+            RequestHistory(method, url, error, status, redirect_location),
+        )
+
+        new_retry = self.new(
+            total=total,
+            connect=connect,
+            read=read,
+            redirect=redirect,
+            status=status_count,
+            history=history,
+        )
+
+        if new_retry.is_exhausted():
+            raise MaxRetryError(_pool, url, error or ResponseError(cause))
+
+        log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)
+
+        return new_retry
+
+    def __repr__(self):
+        return (
+            "{cls.__name__}(total={self.total}, connect={self.connect}, "
+            "read={self.read}, redirect={self.redirect}, status={self.status})"
+        ).format(cls=type(self), self=self)
+
+
+# For backwards compatibility (equivalent to pre-v1.9):
+Retry.DEFAULT = Retry(3)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/ssl_.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/ssl_.py
new file mode 100644
index 0000000000000000000000000000000000000000..f3079a2bd84c1a88bad25b6bcb1abab29a282167
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/ssl_.py
@@ -0,0 +1,407 @@
+from __future__ import absolute_import
+import errno
+import warnings
+import hmac
+import sys
+
+from binascii import hexlify, unhexlify
+from hashlib import md5, sha1, sha256
+
+from .url import IPV4_RE, BRACELESS_IPV6_ADDRZ_RE
+from ..exceptions import SSLError, InsecurePlatformWarning, SNIMissingWarning
+import six
+
+
+SSLContext = None
+HAS_SNI = False
+IS_PYOPENSSL = False
+IS_SECURETRANSPORT = False
+
+# Maps the length of a digest to a possible hash function producing this digest
+HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256}
+
+
+def _const_compare_digest_backport(a, b):
+    """
+    Compare two digests of equal length in constant time.
+
+    The digests must be of type str/bytes.
+    Returns True if the digests match, and False otherwise.
+    """
+    result = abs(len(a) - len(b))
+    for l, r in zip(bytearray(a), bytearray(b)):
+        result |= l ^ r
+    return result == 0
+
+
+_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)
+
+try:  # Test for SSL features
+    import ssl
+    from ssl import wrap_socket, CERT_REQUIRED
+    from ssl import HAS_SNI  # Has SNI?
+except ImportError:
+    pass
+
+try:  # Platform-specific: Python 3.6
+    from ssl import PROTOCOL_TLS
+
+    PROTOCOL_SSLv23 = PROTOCOL_TLS
+except ImportError:
+    try:
+        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS
+
+        PROTOCOL_SSLv23 = PROTOCOL_TLS
+    except ImportError:
+        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2
+
+
+try:
+    from ssl import OP_NO_SSLv2, OP_NO_SSLv3, OP_NO_COMPRESSION
+except ImportError:
+    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
+    OP_NO_COMPRESSION = 0x20000
+
+
+# A secure default.
+# Sources for more information on TLS ciphers:
+#
+# - https://wiki.mozilla.org/Security/Server_Side_TLS
+# - https://www.ssllabs.com/projects/best-practices/index.html
+# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
+#
+# The general intent is:
+# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
+# - prefer ECDHE over DHE for better performance,
+# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
+#   security,
+# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
+# - disable NULL authentication, MD5 MACs, DSS, and other
+#   insecure ciphers for security reasons.
+# - NOTE: TLS 1.3 cipher suites are managed through a different interface
+#   not exposed by CPython (yet!) and are enabled by default if they're available.
+DEFAULT_CIPHERS = ":".join(
+    [
+        "ECDHE+AESGCM",
+        "ECDHE+CHACHA20",
+        "DHE+AESGCM",
+        "DHE+CHACHA20",
+        "ECDH+AESGCM",
+        "DH+AESGCM",
+        "ECDH+AES",
+        "DH+AES",
+        "RSA+AESGCM",
+        "RSA+AES",
+        "!aNULL",
+        "!eNULL",
+        "!MD5",
+        "!DSS",
+    ]
+)
+
+try:
+    from ssl import SSLContext  # Modern SSL?
+except ImportError:
+
+    class SSLContext(object):  # Platform-specific: Python 2
+        def __init__(self, protocol_version):
+            self.protocol = protocol_version
+            # Use default values from a real SSLContext
+            self.check_hostname = False
+            self.verify_mode = ssl.CERT_NONE
+            self.ca_certs = None
+            self.options = 0
+            self.certfile = None
+            self.keyfile = None
+            self.ciphers = None
+
+        def load_cert_chain(self, certfile, keyfile):
+            self.certfile = certfile
+            self.keyfile = keyfile
+
+        def load_verify_locations(self, cafile=None, capath=None):
+            self.ca_certs = cafile
+
+            if capath is not None:
+                raise SSLError("CA directories not supported in older Pythons")
+
+        def set_ciphers(self, cipher_suite):
+            self.ciphers = cipher_suite
+
+        def wrap_socket(self, socket, server_hostname=None, server_side=False):
+            warnings.warn(
+                "A true SSLContext object is not available. This prevents "
+                "urllib3 from configuring SSL appropriately and may cause "
+                "certain SSL connections to fail. You can upgrade to a newer "
+                "version of Python to solve this. For more information, see "
+                "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+                "#ssl-warnings",
+                InsecurePlatformWarning,
+            )
+            kwargs = {
+                "keyfile": self.keyfile,
+                "certfile": self.certfile,
+                "ca_certs": self.ca_certs,
+                "cert_reqs": self.verify_mode,
+                "ssl_version": self.protocol,
+                "server_side": server_side,
+            }
+            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)
+
+
+def assert_fingerprint(cert, fingerprint):
+    """
+    Checks if given fingerprint matches the supplied certificate.
+
+    :param cert:
+        Certificate as bytes object.
+    :param fingerprint:
+        Fingerprint as string of hexdigits, can be interspersed by colons.
+    """
+
+    fingerprint = fingerprint.replace(":", "").lower()
+    digest_length = len(fingerprint)
+    hashfunc = HASHFUNC_MAP.get(digest_length)
+    if not hashfunc:
+        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))
+
+    # We need encode() here for py32; works on py2 and p33.
+    fingerprint_bytes = unhexlify(fingerprint.encode())
+
+    cert_digest = hashfunc(cert).digest()
+
+    if not _const_compare_digest(cert_digest, fingerprint_bytes):
+        raise SSLError(
+            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
+                fingerprint, hexlify(cert_digest)
+            )
+        )
+
+
+def resolve_cert_reqs(candidate):
+    """
+    Resolves the argument to a numeric constant, which can be passed to
+    the wrap_socket function/method from the ssl module.
+    Defaults to :data:`ssl.CERT_REQUIRED`.
+    If given a string it is assumed to be the name of the constant in the
+    :mod:`ssl` module or its abbreviation.
+    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
+    If it's neither `None` nor a string we assume it is already the numeric
+    constant which can directly be passed to wrap_socket.
+    """
+    if candidate is None:
+        return CERT_REQUIRED
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "CERT_" + candidate)
+        return res
+
+    return candidate
+
+
+def resolve_ssl_version(candidate):
+    """
+    like resolve_cert_reqs
+    """
+    if candidate is None:
+        return PROTOCOL_TLS
+
+    if isinstance(candidate, str):
+        res = getattr(ssl, candidate, None)
+        if res is None:
+            res = getattr(ssl, "PROTOCOL_" + candidate)
+        return res
+
+    return candidate
+
+
+def create_urllib3_context(
+    ssl_version=None, cert_reqs=None, options=None, ciphers=None
+):
+    """All arguments have the same meaning as ``ssl_wrap_socket``.
+
+    By default, this function does a lot of the same work that
+    ``ssl.create_default_context`` does on Python 3.4+. It:
+
+    - Disables SSLv2, SSLv3, and compression
+    - Sets a restricted set of server ciphers
+
+    If you wish to enable SSLv3, you can do::
+
+        from urllib3.util import ssl_
+        context = ssl_.create_urllib3_context()
+        context.options &= ~ssl_.OP_NO_SSLv3
+
+    You can do the same to enable compression (substituting ``COMPRESSION``
+    for ``SSLv3`` in the last line above).
+
+    :param ssl_version:
+        The desired protocol version to use. This will default to
+        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
+        the server and your installation of OpenSSL support.
+    :param cert_reqs:
+        Whether to require the certificate verification. This defaults to
+        ``ssl.CERT_REQUIRED``.
+    :param options:
+        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
+        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``.
+    :param ciphers:
+        Which cipher suites to allow the server to select.
+    :returns:
+        Constructed SSLContext object with specified options
+    :rtype: SSLContext
+    """
+    context = SSLContext(ssl_version or PROTOCOL_TLS)
+
+    context.set_ciphers(ciphers or DEFAULT_CIPHERS)
+
+    # Setting the default here, as we may have no ssl module on import
+    cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs
+
+    if options is None:
+        options = 0
+        # SSLv2 is easily broken and is considered harmful and dangerous
+        options |= OP_NO_SSLv2
+        # SSLv3 has several problems and is now dangerous
+        options |= OP_NO_SSLv3
+        # Disable compression to prevent CRIME attacks for OpenSSL 1.0+
+        # (issue #309)
+        options |= OP_NO_COMPRESSION
+
+    context.options |= options
+
+    # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
+    # necessary for conditional client cert authentication with TLS 1.3.
+    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
+    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
+    # verification is enabled to work around Python issue #37428
+    # See: https://bugs.python.org/issue37428
+    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
+        context, "post_handshake_auth", None
+    ) is not None:
+        context.post_handshake_auth = True
+
+    context.verify_mode = cert_reqs
+    if (
+        getattr(context, "check_hostname", None) is not None
+    ):  # Platform-specific: Python 3.2
+        # We do our own verification, including fingerprints and alternative
+        # hostnames. So disable it here
+        context.check_hostname = False
+    return context
+
+
+def ssl_wrap_socket(
+    sock,
+    keyfile=None,
+    certfile=None,
+    cert_reqs=None,
+    ca_certs=None,
+    server_hostname=None,
+    ssl_version=None,
+    ciphers=None,
+    ssl_context=None,
+    ca_cert_dir=None,
+    key_password=None,
+):
+    """
+    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
+    the same meaning as they do when using :func:`ssl.wrap_socket`.
+
+    :param server_hostname:
+        When SNI is supported, the expected hostname of the certificate
+    :param ssl_context:
+        A pre-made :class:`SSLContext` object. If none is provided, one will
+        be created using :func:`create_urllib3_context`.
+    :param ciphers:
+        A string of ciphers we wish the client to support.
+    :param ca_cert_dir:
+        A directory containing CA certificates in multiple separate files, as
+        supported by OpenSSL's -CApath flag or the capath argument to
+        SSLContext.load_verify_locations().
+    :param key_password:
+        Optional password if the keyfile is encrypted.
+    """
+    context = ssl_context
+    if context is None:
+        # Note: This branch of code and all the variables in it are no longer
+        # used by urllib3 itself. We should consider deprecating and removing
+        # this code.
+        context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)
+
+    if ca_certs or ca_cert_dir:
+        try:
+            context.load_verify_locations(ca_certs, ca_cert_dir)
+        except IOError as e:  # Platform-specific: Python 2.7
+            raise SSLError(e)
+        # Py33 raises FileNotFoundError which subclasses OSError
+        # These are not equivalent unless we check the errno attribute
+        except OSError as e:  # Platform-specific: Python 3.3 and beyond
+            if e.errno == errno.ENOENT:
+                raise SSLError(e)
+            raise
+
+    elif ssl_context is None and hasattr(context, "load_default_certs"):
+        # try to load OS default certs; works well on Windows (require Python3.4+)
+        context.load_default_certs()
+
+    # Attempt to detect if we get the goofy behavior of the
+    # keyfile being encrypted and OpenSSL asking for the
+    # passphrase via the terminal and instead error out.
+    if keyfile and key_password is None and _is_key_file_encrypted(keyfile):
+        raise SSLError("Client private key is encrypted, password is required")
+
+    if certfile:
+        if key_password is None:
+            context.load_cert_chain(certfile, keyfile)
+        else:
+            context.load_cert_chain(certfile, keyfile, key_password)
+
+    # If we detect server_hostname is an IP address then the SNI
+    # extension should not be used according to RFC3546 Section 3.1
+    # We shouldn't warn the user if SNI isn't available but we would
+    # not be using SNI anyways due to IP address for server_hostname.
+    if (
+        server_hostname is not None and not is_ipaddress(server_hostname)
+    ) or IS_SECURETRANSPORT:
+        if HAS_SNI and server_hostname is not None:
+            return context.wrap_socket(sock, server_hostname=server_hostname)
+
+        warnings.warn(
+            "An HTTPS request has been made, but the SNI (Server Name "
+            "Indication) extension to TLS is not available on this platform. "
+            "This may cause the server to present an incorrect TLS "
+            "certificate, which can cause validation failures. You can upgrade to "
+            "a newer version of Python to solve this. For more information, see "
+            "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
+            "#ssl-warnings",
+            SNIMissingWarning,
+        )
+
+    return context.wrap_socket(sock)
+
+
+def is_ipaddress(hostname):
+    """Detects whether the hostname given is an IPv4 or IPv6 address.
+    Also detects IPv6 addresses with Zone IDs.
+
+    :param str hostname: Hostname to examine.
+    :return: True if the hostname is an IP address, False otherwise.
+    """
+    if not six.PY2 and isinstance(hostname, bytes):
+        # IDN A-label bytes are ASCII compatible.
+        hostname = hostname.decode("ascii")
+    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))
+
+
+def _is_key_file_encrypted(key_file):
+    """Detects if a key file is encrypted or not."""
+    with open(key_file, "r") as f:
+        for line in f:
+            # Look for Proc-Type: 4,ENCRYPTED
+            if "ENCRYPTED" in line:
+                return True
+
+    return False
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/timeout.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/timeout.py
new file mode 100644
index 0000000000000000000000000000000000000000..9883700556ef70bd153ae48021c3d6fb410d4122
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/timeout.py
@@ -0,0 +1,258 @@
+from __future__ import absolute_import
+
+# The default socket timeout, used by httplib to indicate that no timeout was
+# specified by the user
+from socket import _GLOBAL_DEFAULT_TIMEOUT
+import time
+
+from ..exceptions import TimeoutStateError
+
+# A sentinel value to indicate that no timeout was specified by the user in
+# urllib3
+_Default = object()
+
+
+# Use time.monotonic if available.
+current_time = getattr(time, "monotonic", time.time)
+
+
+class Timeout(object):
+    """ Timeout configuration.
+
+    Timeouts can be defined as a default for a pool::
+
+        timeout = Timeout(connect=2.0, read=7.0)
+        http = PoolManager(timeout=timeout)
+        response = http.request('GET', 'http://example.com/')
+
+    Or per-request (which overrides the default for the pool)::
+
+        response = http.request('GET', 'http://example.com/', timeout=Timeout(10))
+
+    Timeouts can be disabled by setting all the parameters to ``None``::
+
+        no_timeout = Timeout(connect=None, read=None)
+        response = http.request('GET', 'http://example.com/, timeout=no_timeout)
+
+
+    :param total:
+        This combines the connect and read timeouts into one; the read timeout
+        will be set to the time leftover from the connect attempt. In the
+        event that both a connect timeout and a total are specified, or a read
+        timeout and a total are specified, the shorter timeout will be applied.
+
+        Defaults to None.
+
+    :type total: integer, float, or None
+
+    :param connect:
+        The maximum amount of time (in seconds) to wait for a connection
+        attempt to a server to succeed. Omitting the parameter will default the
+        connect timeout to the system default, probably `the global default
+        timeout in socket.py
+        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
+        None will set an infinite timeout for connection attempts.
+
+    :type connect: integer, float, or None
+
+    :param read:
+        The maximum amount of time (in seconds) to wait between consecutive
+        read operations for a response from the server. Omitting the parameter
+        will default the read timeout to the system default, probably `the
+        global default timeout in socket.py
+        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
+        None will set an infinite timeout.
+
+    :type read: integer, float, or None
+
+    .. note::
+
+        Many factors can affect the total amount of time for urllib3 to return
+        an HTTP response.
+
+        For example, Python's DNS resolver does not obey the timeout specified
+        on the socket. Other factors that can affect total request time include
+        high CPU load, high swap, the program running at a low priority level,
+        or other behaviors.
+
+        In addition, the read and total timeouts only measure the time between
+        read operations on the socket connecting the client and the server,
+        not the total amount of time for the request to return a complete
+        response. For most requests, the timeout is raised because the server
+        has not sent the first byte in the specified time. This is not always
+        the case; if a server streams one byte every fifteen seconds, a timeout
+        of 20 seconds will not trigger, even though the request will take
+        several minutes to complete.
+
+        If your goal is to cut off any request after a set amount of wall clock
+        time, consider having a second "watcher" thread to cut off a slow
+        request.
+    """
+
+    #: A sentinel object representing the default timeout value
+    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT
+
+    def __init__(self, total=None, connect=_Default, read=_Default):
+        self._connect = self._validate_timeout(connect, "connect")
+        self._read = self._validate_timeout(read, "read")
+        self.total = self._validate_timeout(total, "total")
+        self._start_connect = None
+
+    def __str__(self):
+        return "%s(connect=%r, read=%r, total=%r)" % (
+            type(self).__name__,
+            self._connect,
+            self._read,
+            self.total,
+        )
+
+    @classmethod
+    def _validate_timeout(cls, value, name):
+        """ Check that a timeout attribute is valid.
+
+        :param value: The timeout value to validate
+        :param name: The name of the timeout attribute to validate. This is
+            used to specify in error messages.
+        :return: The validated and casted version of the given value.
+        :raises ValueError: If it is a numeric value less than or equal to
+            zero, or the type is not an integer, float, or None.
+        """
+        if value is _Default:
+            return cls.DEFAULT_TIMEOUT
+
+        if value is None or value is cls.DEFAULT_TIMEOUT:
+            return value
+
+        if isinstance(value, bool):
+            raise ValueError(
+                "Timeout cannot be a boolean value. It must "
+                "be an int, float or None."
+            )
+        try:
+            float(value)
+        except (TypeError, ValueError):
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        try:
+            if value <= 0:
+                raise ValueError(
+                    "Attempted to set %s timeout to %s, but the "
+                    "timeout cannot be set to a value less "
+                    "than or equal to 0." % (name, value)
+                )
+        except TypeError:
+            # Python 3
+            raise ValueError(
+                "Timeout value %s was %s, but it must be an "
+                "int, float or None." % (name, value)
+            )
+
+        return value
+
+    @classmethod
+    def from_float(cls, timeout):
+        """ Create a new Timeout from a legacy timeout value.
+
+        The timeout value used by httplib.py sets the same timeout on the
+        connect(), and recv() socket requests. This creates a :class:`Timeout`
+        object that sets the individual timeouts to the ``timeout`` value
+        passed to this function.
+
+        :param timeout: The legacy timeout value.
+        :type timeout: integer, float, sentinel default object, or None
+        :return: Timeout object
+        :rtype: :class:`Timeout`
+        """
+        return Timeout(read=timeout, connect=timeout)
+
+    def clone(self):
+        """ Create a copy of the timeout object
+
+        Timeout properties are stored per-pool but each request needs a fresh
+        Timeout object to ensure each one has its own start/stop configured.
+
+        :return: a copy of the timeout object
+        :rtype: :class:`Timeout`
+        """
+        # We can't use copy.deepcopy because that will also create a new object
+        # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to
+        # detect the user default.
+        return Timeout(connect=self._connect, read=self._read, total=self.total)
+
+    def start_connect(self):
+        """ Start the timeout clock, used during a connect() attempt
+
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to start a timer that has been started already.
+        """
+        if self._start_connect is not None:
+            raise TimeoutStateError("Timeout timer has already been started.")
+        self._start_connect = current_time()
+        return self._start_connect
+
+    def get_connect_duration(self):
+        """ Gets the time elapsed since the call to :meth:`start_connect`.
+
+        :return: Elapsed time in seconds.
+        :rtype: float
+        :raises urllib3.exceptions.TimeoutStateError: if you attempt
+            to get duration for a timer that hasn't been started.
+        """
+        if self._start_connect is None:
+            raise TimeoutStateError(
+                "Can't get connect duration for timer that has not started."
+            )
+        return current_time() - self._start_connect
+
+    @property
+    def connect_timeout(self):
+        """ Get the value to use when setting a connection timeout.
+
+        This will be a positive float or integer, the value None
+        (never timeout), or the default system timeout.
+
+        :return: Connect timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        """
+        if self.total is None:
+            return self._connect
+
+        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
+            return self.total
+
+        return min(self._connect, self.total)
+
+    @property
+    def read_timeout(self):
+        """ Get the value for the read timeout.
+
+        This assumes some time has elapsed in the connection timeout and
+        computes the read timeout appropriately.
+
+        If self.total is set, the read timeout is dependent on the amount of
+        time taken by the connect timeout. If the connection time has not been
+        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
+        raised.
+
+        :return: Value to use for the read timeout.
+        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
+        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
+            has not yet been called on this object.
+        """
+        if (
+            self.total is not None
+            and self.total is not self.DEFAULT_TIMEOUT
+            and self._read is not None
+            and self._read is not self.DEFAULT_TIMEOUT
+        ):
+            # In case the connect timeout has not yet been established.
+            if self._start_connect is None:
+                return self._read
+            return max(0, min(self.total - self.get_connect_duration(), self._read))
+        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
+            return max(0, self.total - self.get_connect_duration())
+        else:
+            return self._read
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/url.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/url.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a8a8f9a35e86e2466acfced607d59b2a616551b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/url.py
@@ -0,0 +1,430 @@
+from __future__ import absolute_import
+import re
+from collections import namedtuple
+
+from ..exceptions import LocationParseError
+import six
+
+
+url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]
+
+# We only want to normalize urls with an HTTP(S) scheme.
+# urllib3 infers URLs without a scheme (None) to be http.
+NORMALIZABLE_SCHEMES = ("http", "https", None)
+
+# Almost all of these patterns were derived from the
+# 'rfc3986' module: https://github.com/python-hyper/rfc3986
+PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
+SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
+URI_RE = re.compile(
+    r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
+    r"(?://([^/?#]*))?"
+    r"([^?#]*)"
+    r"(?:\?([^#]*))?"
+    r"(?:#(.*))?$",
+    re.UNICODE | re.DOTALL,
+)
+
+IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
+HEX_PAT = "[0-9A-Fa-f]{1,4}"
+LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
+_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
+_variations = [
+    #                            6( h16 ":" ) ls32
+    "(?:%(hex)s:){6}%(ls32)s",
+    #                       "::" 5( h16 ":" ) ls32
+    "::(?:%(hex)s:){5}%(ls32)s",
+    # [               h16 ] "::" 4( h16 ":" ) ls32
+    "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s",
+    # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
+    "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s",
+    # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
+    "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s",
+    # [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
+    "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s",
+    # [ *4( h16 ":" ) h16 ] "::"              ls32
+    "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s",
+    # [ *5( h16 ":" ) h16 ] "::"              h16
+    "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s",
+    # [ *6( h16 ":" ) h16 ] "::"
+    "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
+]
+
+UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~"
+IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
+ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
+IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
+REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
+TARGET_RE = re.compile(r"^(/[^?#]*)(?:\?([^#]*))?(?:#.*)?$")
+
+IPV4_RE = re.compile("^" + IPV4_PAT + "$")
+IPV6_RE = re.compile("^" + IPV6_PAT + "$")
+IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
+BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
+ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")
+
+SUBAUTHORITY_PAT = (u"^(?:(.*)@)?(%s|%s|%s)(?::([0-9]{0,5}))?$") % (
+    REG_NAME_PAT,
+    IPV4_PAT,
+    IPV6_ADDRZ_PAT,
+)
+SUBAUTHORITY_RE = re.compile(SUBAUTHORITY_PAT, re.UNICODE | re.DOTALL)
+
+UNRESERVED_CHARS = set(
+    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
+)
+SUB_DELIM_CHARS = set("!$&'()*+,;=")
+USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
+PATH_CHARS = USERINFO_CHARS | {"@", "/"}
+QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}
+
+
+class Url(namedtuple("Url", url_attrs)):
+    """
+    Data structure for representing an HTTP URL. Used as a return value for
+    :func:`parse_url`. Both the scheme and host are normalized as they are
+    both case-insensitive according to RFC 3986.
+    """
+
+    __slots__ = ()
+
+    def __new__(
+        cls,
+        scheme=None,
+        auth=None,
+        host=None,
+        port=None,
+        path=None,
+        query=None,
+        fragment=None,
+    ):
+        if path and not path.startswith("/"):
+            path = "/" + path
+        if scheme is not None:
+            scheme = scheme.lower()
+        return super(Url, cls).__new__(
+            cls, scheme, auth, host, port, path, query, fragment
+        )
+
+    @property
+    def hostname(self):
+        """For backwards-compatibility with urlparse. We're nice like that."""
+        return self.host
+
+    @property
+    def request_uri(self):
+        """Absolute path including the query string."""
+        uri = self.path or "/"
+
+        if self.query is not None:
+            uri += "?" + self.query
+
+        return uri
+
+    @property
+    def netloc(self):
+        """Network location including host and port"""
+        if self.port:
+            return "%s:%d" % (self.host, self.port)
+        return self.host
+
+    @property
+    def url(self):
+        """
+        Convert self into a url
+
+        This function should more or less round-trip with :func:`.parse_url`. The
+        returned url may not be exactly the same as the url inputted to
+        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
+        with a blank port will have : removed).
+
+        Example: ::
+
+            >>> U = parse_url('http://google.com/mail/')
+            >>> U.url
+            'http://google.com/mail/'
+            >>> Url('http', 'username:password', 'host.com', 80,
+            ... '/path', 'query', 'fragment').url
+            'http://username:password@host.com:80/path?query#fragment'
+        """
+        scheme, auth, host, port, path, query, fragment = self
+        url = u""
+
+        # We use "is not None" we want things to happen with empty strings (or 0 port)
+        if scheme is not None:
+            url += scheme + u"://"
+        if auth is not None:
+            url += auth + u"@"
+        if host is not None:
+            url += host
+        if port is not None:
+            url += u":" + str(port)
+        if path is not None:
+            url += path
+        if query is not None:
+            url += u"?" + query
+        if fragment is not None:
+            url += u"#" + fragment
+
+        return url
+
+    def __str__(self):
+        return self.url
+
+
+def split_first(s, delims):
+    """
+    .. deprecated:: 1.25
+
+    Given a string and an iterable of delimiters, split on the first found
+    delimiter. Return two split parts and the matched delimiter.
+
+    If not found, then the first part is the full input string.
+
+    Example::
+
+        >>> split_first('foo/bar?baz', '?/=')
+        ('foo', 'bar?baz', '/')
+        >>> split_first('foo/bar?baz', '123')
+        ('foo/bar?baz', '', None)
+
+    Scales linearly with number of delims. Not ideal for large number of delims.
+    """
+    min_idx = None
+    min_delim = None
+    for d in delims:
+        idx = s.find(d)
+        if idx < 0:
+            continue
+
+        if min_idx is None or idx < min_idx:
+            min_idx = idx
+            min_delim = d
+
+    if min_idx is None or min_idx < 0:
+        return s, "", None
+
+    return s[:min_idx], s[min_idx + 1 :], min_delim
+
+
+def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
+    """Percent-encodes a URI component without reapplying
+    onto an already percent-encoded component.
+    """
+    if component is None:
+        return component
+
+    component = six.ensure_text(component)
+
+    # Normalize existing percent-encoded bytes.
+    # Try to see if the component we're encoding is already percent-encoded
+    # so we can skip all '%' characters but still encode all others.
+    component, percent_encodings = PERCENT_RE.subn(
+        lambda match: match.group(0).upper(), component
+    )
+
+    uri_bytes = component.encode("utf-8", "surrogatepass")
+    is_percent_encoded = percent_encodings == uri_bytes.count(b"%")
+    encoded_component = bytearray()
+
+    for i in range(0, len(uri_bytes)):
+        # Will return a single character bytestring on both Python 2 & 3
+        byte = uri_bytes[i : i + 1]
+        byte_ord = ord(byte)
+        if (is_percent_encoded and byte == b"%") or (
+            byte_ord < 128 and byte.decode() in allowed_chars
+        ):
+            encoded_component += byte
+            continue
+        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))
+
+    return encoded_component.decode(encoding)
+
+
+def _remove_path_dot_segments(path):
+    # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
+    segments = path.split("/")  # Turn the path into a list of segments
+    output = []  # Initialize the variable to use to store output
+
+    for segment in segments:
+        # '.' is the current directory, so ignore it, it is superfluous
+        if segment == ".":
+            continue
+        # Anything other than '..', should be appended to the output
+        elif segment != "..":
+            output.append(segment)
+        # In this case segment == '..', if we can, we should pop the last
+        # element
+        elif output:
+            output.pop()
+
+    # If the path starts with '/' and the output is empty or the first string
+    # is non-empty
+    if path.startswith("/") and (not output or output[0]):
+        output.insert(0, "")
+
+    # If the path starts with '/.' or '/..' ensure we add one more empty
+    # string to add a trailing '/'
+    if path.endswith(("/.", "/..")):
+        output.append("")
+
+    return "/".join(output)
+
+
+def _normalize_host(host, scheme):
+    if host:
+        if isinstance(host, six.binary_type):
+            host = six.ensure_str(host)
+
+        if scheme in NORMALIZABLE_SCHEMES:
+            is_ipv6 = IPV6_ADDRZ_RE.match(host)
+            if is_ipv6:
+                match = ZONE_ID_RE.search(host)
+                if match:
+                    start, end = match.span(1)
+                    zone_id = host[start:end]
+
+                    if zone_id.startswith("%25") and zone_id != "%25":
+                        zone_id = zone_id[3:]
+                    else:
+                        zone_id = zone_id[1:]
+                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
+                    return host[:start].lower() + zone_id + host[end:]
+                else:
+                    return host.lower()
+            elif not IPV4_RE.match(host):
+                return six.ensure_str(
+                    b".".join([_idna_encode(label) for label in host.split(".")])
+                )
+    return host
+
+
+def _idna_encode(name):
+    if name and any([ord(x) > 128 for x in name]):
+        try:
+            import idna
+        except ImportError:
+            six.raise_from(
+                LocationParseError("Unable to parse URL without the 'idna' module"),
+                None,
+            )
+        try:
+            return idna.encode(name.lower(), strict=True, std3_rules=True)
+        except idna.IDNAError:
+            six.raise_from(
+                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
+            )
+    return name.lower().encode("ascii")
+
+
+def _encode_target(target):
+    """Percent-encodes a request target so that there are no invalid characters"""
+    path, query = TARGET_RE.match(target).groups()
+    target = _encode_invalid_chars(path, PATH_CHARS)
+    query = _encode_invalid_chars(query, QUERY_CHARS)
+    if query is not None:
+        target += "?" + query
+    return target
+
+
+def parse_url(url):
+    """
+    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
+    performed to parse incomplete urls. Fields not provided will be None.
+    This parser is RFC 3986 compliant.
+
+    The parser logic and helper functions are based heavily on
+    work done in the ``rfc3986`` module.
+
+    :param str url: URL to parse into a :class:`.Url` namedtuple.
+
+    Partly backwards-compatible with :mod:`urlparse`.
+
+    Example::
+
+        >>> parse_url('http://google.com/mail/')
+        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
+        >>> parse_url('google.com:80')
+        Url(scheme=None, host='google.com', port=80, path=None, ...)
+        >>> parse_url('/foo?bar')
+        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
+    """
+    if not url:
+        # Empty
+        return Url()
+
+    source_url = url
+    if not SCHEME_RE.search(url):
+        url = "//" + url
+
+    try:
+        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
+        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES
+
+        if scheme:
+            scheme = scheme.lower()
+
+        if authority:
+            auth, host, port = SUBAUTHORITY_RE.match(authority).groups()
+            if auth and normalize_uri:
+                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
+            if port == "":
+                port = None
+        else:
+            auth, host, port = None, None, None
+
+        if port is not None:
+            port = int(port)
+            if not (0 <= port <= 65535):
+                raise LocationParseError(url)
+
+        host = _normalize_host(host, scheme)
+
+        if normalize_uri and path:
+            path = _remove_path_dot_segments(path)
+            path = _encode_invalid_chars(path, PATH_CHARS)
+        if normalize_uri and query:
+            query = _encode_invalid_chars(query, QUERY_CHARS)
+        if normalize_uri and fragment:
+            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
+
+    except (ValueError, AttributeError):
+        return six.raise_from(LocationParseError(source_url), None)
+
+    # For the sake of backwards compatibility we put empty
+    # string values for path if there are any defined values
+    # beyond the path in the URL.
+    # TODO: Remove this when we break backwards compatibility.
+    if not path:
+        if query is not None or fragment is not None:
+            path = ""
+        else:
+            path = None
+
+    # Ensure that each part of the URL is a `str` for
+    # backwards compatibility.
+    if isinstance(url, six.text_type):
+        ensure_func = six.ensure_text
+    else:
+        ensure_func = six.ensure_str
+
+    def ensure_type(x):
+        return x if x is None else ensure_func(x)
+
+    return Url(
+        scheme=ensure_type(scheme),
+        auth=ensure_type(auth),
+        host=ensure_type(host),
+        port=port,
+        path=ensure_type(path),
+        query=ensure_type(query),
+        fragment=ensure_type(fragment),
+    )
+
+
+def get_host(url):
+    """
+    Deprecated. Use :func:`parse_url` instead.
+    """
+    p = parse_url(url)
+    return p.scheme or "http", p.hostname, p.port
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/wait.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/wait.py
new file mode 100644
index 0000000000000000000000000000000000000000..d71d2fd722bedb03a45d1f70cdc41d028ffa7d69
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/urllib3/util/wait.py
@@ -0,0 +1,153 @@
+import errno
+from functools import partial
+import select
+import sys
+
+try:
+    from time import monotonic
+except ImportError:
+    from time import time as monotonic
+
+__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]
+
+
+class NoWayToWaitForSocketError(Exception):
+    pass
+
+
+# How should we wait on sockets?
+#
+# There are two types of APIs you can use for waiting on sockets: the fancy
+# modern stateful APIs like epoll/kqueue, and the older stateless APIs like
+# select/poll. The stateful APIs are more efficient when you have a lots of
+# sockets to keep track of, because you can set them up once and then use them
+# lots of times. But we only ever want to wait on a single socket at a time
+# and don't want to keep track of state, so the stateless APIs are actually
+# more efficient. So we want to use select() or poll().
+#
+# Now, how do we choose between select() and poll()? On traditional Unixes,
+# select() has a strange calling convention that makes it slow, or fail
+# altogether, for high-numbered file descriptors. The point of poll() is to fix
+# that, so on Unixes, we prefer poll().
+#
+# On Windows, there is no poll() (or at least Python doesn't provide a wrapper
+# for it), but that's OK, because on Windows, select() doesn't have this
+# strange calling convention; plain select() works fine.
+#
+# So: on Windows we use select(), and everywhere else we use poll(). We also
+# fall back to select() in case poll() is somehow broken or missing.
+
+if sys.version_info >= (3, 5):
+    # Modern Python, that retries syscalls by default
+    def _retry_on_intr(fn, timeout):
+        return fn(timeout)
+
+
+else:
+    # Old and broken Pythons.
+    def _retry_on_intr(fn, timeout):
+        if timeout is None:
+            deadline = float("inf")
+        else:
+            deadline = monotonic() + timeout
+
+        while True:
+            try:
+                return fn(timeout)
+            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
+            except (OSError, select.error) as e:
+                # 'e.args[0]' incantation works for both OSError and select.error
+                if e.args[0] != errno.EINTR:
+                    raise
+                else:
+                    timeout = deadline - monotonic()
+                    if timeout < 0:
+                        timeout = 0
+                    if timeout == float("inf"):
+                        timeout = None
+                    continue
+
+
+def select_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    rcheck = []
+    wcheck = []
+    if read:
+        rcheck.append(sock)
+    if write:
+        wcheck.append(sock)
+    # When doing a non-blocking connect, most systems signal success by
+    # marking the socket writable. Windows, though, signals success by marked
+    # it as "exceptional". We paper over the difference by checking the write
+    # sockets for both conditions. (The stdlib selectors module does the same
+    # thing.)
+    fn = partial(select.select, rcheck, wcheck, wcheck)
+    rready, wready, xready = _retry_on_intr(fn, timeout)
+    return bool(rready or wready or xready)
+
+
+def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
+    if not read and not write:
+        raise RuntimeError("must specify at least one of read=True, write=True")
+    mask = 0
+    if read:
+        mask |= select.POLLIN
+    if write:
+        mask |= select.POLLOUT
+    poll_obj = select.poll()
+    poll_obj.register(sock, mask)
+
+    # For some reason, poll() takes timeout in milliseconds
+    def do_poll(t):
+        if t is not None:
+            t *= 1000
+        return poll_obj.poll(t)
+
+    return bool(_retry_on_intr(do_poll, timeout))
+
+
+def null_wait_for_socket(*args, **kwargs):
+    raise NoWayToWaitForSocketError("no select-equivalent available")
+
+
+def _have_working_poll():
+    # Apparently some systems have a select.poll that fails as soon as you try
+    # to use it, either due to strange configuration or broken monkeypatching
+    # from libraries like eventlet/greenlet.
+    try:
+        poll_obj = select.poll()
+        _retry_on_intr(poll_obj.poll, 0)
+    except (AttributeError, OSError):
+        return False
+    else:
+        return True
+
+
+def wait_for_socket(*args, **kwargs):
+    # We delay choosing which implementation to use until the first time we're
+    # called. We could do it at import time, but then we might make the wrong
+    # decision if someone goes wild with monkeypatching select.poll after
+    # we're imported.
+    global wait_for_socket
+    if _have_working_poll():
+        wait_for_socket = poll_wait_for_socket
+    elif hasattr(select, "select"):
+        wait_for_socket = select_wait_for_socket
+    else:  # Platform-specific: Appengine.
+        wait_for_socket = null_wait_for_socket
+    return wait_for_socket(*args, **kwargs)
+
+
+def wait_for_read(sock, timeout=None):
+    """ Waits for reading to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, read=True, timeout=timeout)
+
+
+def wait_for_write(sock, timeout=None):
+    """ Waits for writing to be available on a given socket.
+    Returns True if the socket is readable, or False if the timeout expired.
+    """
+    return wait_for_socket(sock, write=True, timeout=timeout)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..60fcd11874eb084e956c13a8780052dc93d358cb
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/METADATA
@@ -0,0 +1,54 @@
+Metadata-Version: 2.1
+Name: webencodings
+Version: 0.5.1
+Summary: Character encoding aliases for legacy web content
+Home-page: https://github.com/SimonSapin/python-webencodings
+Author: Simon Sapin
+Author-email: simon.sapin@exyr.org
+Maintainer: Geoffrey Sneddon
+Maintainer-email: me@gsnedders.com
+License: BSD
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP
+
+python-webencodings
+===================
+
+This is a Python implementation of the `WHATWG Encoding standard
+<http://encoding.spec.whatwg.org/>`_.
+
+* Latest documentation: http://packages.python.org/webencodings/
+* Source code and issue tracker:
+  https://github.com/gsnedders/python-webencodings
+* PyPI releases: http://pypi.python.org/pypi/webencodings
+* License: BSD
+* Python 2.6+ and 3.3+
+
+In order to be compatible with legacy web content
+when interpreting something like ``Content-Type: text/html; charset=latin1``,
+tools need to use a particular set of aliases for encoding labels
+as well as some overriding rules.
+For example, ``US-ASCII`` and ``iso-8859-1`` on the web are actually
+aliases for ``windows-1252``, and an UTF-8 or UTF-16 BOM takes precedence
+over any other encoding declaration.
+The Encoding standard defines all such details so that implementations do
+not have to reverse-engineer each other.
+
+This module has encoding labels and BOM detection,
+but the actual implementation for encoders and decoders is Python’s.
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..353a46e9d8e74a2eab7ce0c596f230670d7d075c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/RECORD
@@ -0,0 +1,20 @@
+webencodings/__init__.py,sha256=qOBJIuPy_4ByYH6W_bNgJF-qYQ2DoU-dKsDu5yRWCXg,10579
+webencodings/labels.py,sha256=4AO_KxTddqGtrL9ns7kAPjb0CcN6xsCIxbK37HY9r3E,8979
+webencodings/mklabels.py,sha256=GYIeywnpaLnP0GSic8LFWgd0UVvO_l1Nc6YoF-87R_4,1305
+webencodings/tests.py,sha256=OtGLyjhNY1fvkW1GvLJ_FV9ZoqC9Anyjr7q3kxTbzNs,6563
+webencodings/x_user_defined.py,sha256=yOqWSdmpytGfUgh_Z6JYgDNhoc-BAHyyeeT15Fr42tM,4307
+webencodings-0.5.1.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+webencodings-0.5.1.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+webencodings-0.5.1.dist-info/METADATA,sha256=3twdnuIvUN-fUitwJzXMpnqmyfbCHLd06nrbJ6vmD2w,2126
+webencodings-0.5.1.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+webencodings-0.5.1.dist-info/top_level.txt,sha256=bZs_aZHSf_PNlfIHD4-BETJmRi99BJdKLrOW7rQngeo,13
+webencodings-0.5.1.dist-info/RECORD,,
+webencodings/__pycache__,,
+webencodings/__init__.cpython-38.pyc,,
+webencodings/labels.cpython-38.pyc,,
+webencodings/x_user_defined.cpython-38.pyc,,
+webencodings/mklabels.cpython-38.pyc,,
+webencodings-0.5.1.dist-info/INSTALLER,,
+webencodings-0.5.1.virtualenv,,
+webencodings/tests.cpython-38.pyc,,
+webencodings-0.5.1.dist-info/__pycache__,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..be8fcb779f88222d5b7a74327978e4d9dff94946
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+webencodings
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings-0.5.1.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d21d697c887bed1f8ab7f36d10185e986d9f1e54
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/__init__.py
@@ -0,0 +1,342 @@
+# coding: utf-8
+"""
+
+    webencodings
+    ~~~~~~~~~~~~
+
+    This is a Python implementation of the `WHATWG Encoding standard
+    <http://encoding.spec.whatwg.org/>`. See README for details.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+from __future__ import unicode_literals
+
+import codecs
+
+from .labels import LABELS
+
+
+VERSION = '0.5.1'
+
+
+# Some names in Encoding are not valid Python aliases. Remap these.
+PYTHON_NAMES = {
+    'iso-8859-8-i': 'iso-8859-8',
+    'x-mac-cyrillic': 'mac-cyrillic',
+    'macintosh': 'mac-roman',
+    'windows-874': 'cp874'}
+
+CACHE = {}
+
+
+def ascii_lower(string):
+    r"""Transform (only) ASCII letters to lower case: A-Z is mapped to a-z.
+
+    :param string: An Unicode string.
+    :returns: A new Unicode string.
+
+    This is used for `ASCII case-insensitive
+    <http://encoding.spec.whatwg.org/#ascii-case-insensitive>`_
+    matching of encoding labels.
+    The same matching is also used, among other things,
+    for `CSS keywords <http://dev.w3.org/csswg/css-values/#keywords>`_.
+
+    This is different from the :meth:`~py:str.lower` method of Unicode strings
+    which also affect non-ASCII characters,
+    sometimes mapping them into the ASCII range:
+
+        >>> keyword = u'Bac\N{KELVIN SIGN}ground'
+        >>> assert keyword.lower() == u'background'
+        >>> assert ascii_lower(keyword) != keyword.lower()
+        >>> assert ascii_lower(keyword) == u'bac\N{KELVIN SIGN}ground'
+
+    """
+    # This turns out to be faster than unicode.translate()
+    return string.encode('utf8').lower().decode('utf8')
+
+
+def lookup(label):
+    """
+    Look for an encoding by its label.
+    This is the spec’s `get an encoding
+    <http://encoding.spec.whatwg.org/#concept-encoding-get>`_ algorithm.
+    Supported labels are listed there.
+
+    :param label: A string.
+    :returns:
+        An :class:`Encoding` object, or :obj:`None` for an unknown label.
+
+    """
+    # Only strip ASCII whitespace: U+0009, U+000A, U+000C, U+000D, and U+0020.
+    label = ascii_lower(label.strip('\t\n\f\r '))
+    name = LABELS.get(label)
+    if name is None:
+        return None
+    encoding = CACHE.get(name)
+    if encoding is None:
+        if name == 'x-user-defined':
+            from .x_user_defined import codec_info
+        else:
+            python_name = PYTHON_NAMES.get(name, name)
+            # Any python_name value that gets to here should be valid.
+            codec_info = codecs.lookup(python_name)
+        encoding = Encoding(name, codec_info)
+        CACHE[name] = encoding
+    return encoding
+
+
+def _get_encoding(encoding_or_label):
+    """
+    Accept either an encoding object or label.
+
+    :param encoding: An :class:`Encoding` object or a label string.
+    :returns: An :class:`Encoding` object.
+    :raises: :exc:`~exceptions.LookupError` for an unknown label.
+
+    """
+    if hasattr(encoding_or_label, 'codec_info'):
+        return encoding_or_label
+
+    encoding = lookup(encoding_or_label)
+    if encoding is None:
+        raise LookupError('Unknown encoding label: %r' % encoding_or_label)
+    return encoding
+
+
+class Encoding(object):
+    """Reresents a character encoding such as UTF-8,
+    that can be used for decoding or encoding.
+
+    .. attribute:: name
+
+        Canonical name of the encoding
+
+    .. attribute:: codec_info
+
+        The actual implementation of the encoding,
+        a stdlib :class:`~codecs.CodecInfo` object.
+        See :func:`codecs.register`.
+
+    """
+    def __init__(self, name, codec_info):
+        self.name = name
+        self.codec_info = codec_info
+
+    def __repr__(self):
+        return '<Encoding %s>' % self.name
+
+
+#: The UTF-8 encoding. Should be used for new content and formats.
+UTF8 = lookup('utf-8')
+
+_UTF16LE = lookup('utf-16le')
+_UTF16BE = lookup('utf-16be')
+
+
+def decode(input, fallback_encoding, errors='replace'):
+    """
+    Decode a single string.
+
+    :param input: A byte string
+    :param fallback_encoding:
+        An :class:`Encoding` object or a label string.
+        The encoding to use if :obj:`input` does note have a BOM.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+    :return:
+        A ``(output, encoding)`` tuple of an Unicode string
+        and an :obj:`Encoding`.
+
+    """
+    # Fail early if `encoding` is an invalid label.
+    fallback_encoding = _get_encoding(fallback_encoding)
+    bom_encoding, input = _detect_bom(input)
+    encoding = bom_encoding or fallback_encoding
+    return encoding.codec_info.decode(input, errors)[0], encoding
+
+
+def _detect_bom(input):
+    """Return (bom_encoding, input), with any BOM removed from the input."""
+    if input.startswith(b'\xFF\xFE'):
+        return _UTF16LE, input[2:]
+    if input.startswith(b'\xFE\xFF'):
+        return _UTF16BE, input[2:]
+    if input.startswith(b'\xEF\xBB\xBF'):
+        return UTF8, input[3:]
+    return None, input
+
+
+def encode(input, encoding=UTF8, errors='strict'):
+    """
+    Encode a single string.
+
+    :param input: An Unicode string.
+    :param encoding: An :class:`Encoding` object or a label string.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+    :return: A byte string.
+
+    """
+    return _get_encoding(encoding).codec_info.encode(input, errors)[0]
+
+
+def iter_decode(input, fallback_encoding, errors='replace'):
+    """
+    "Pull"-based decoder.
+
+    :param input:
+        An iterable of byte strings.
+
+        The input is first consumed just enough to determine the encoding
+        based on the precense of a BOM,
+        then consumed on demand when the return value is.
+    :param fallback_encoding:
+        An :class:`Encoding` object or a label string.
+        The encoding to use if :obj:`input` does note have a BOM.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+    :returns:
+        An ``(output, encoding)`` tuple.
+        :obj:`output` is an iterable of Unicode strings,
+        :obj:`encoding` is the :obj:`Encoding` that is being used.
+
+    """
+
+    decoder = IncrementalDecoder(fallback_encoding, errors)
+    generator = _iter_decode_generator(input, decoder)
+    encoding = next(generator)
+    return generator, encoding
+
+
+def _iter_decode_generator(input, decoder):
+    """Return a generator that first yields the :obj:`Encoding`,
+    then yields output chukns as Unicode strings.
+
+    """
+    decode = decoder.decode
+    input = iter(input)
+    for chunck in input:
+        output = decode(chunck)
+        if output:
+            assert decoder.encoding is not None
+            yield decoder.encoding
+            yield output
+            break
+    else:
+        # Input exhausted without determining the encoding
+        output = decode(b'', final=True)
+        assert decoder.encoding is not None
+        yield decoder.encoding
+        if output:
+            yield output
+        return
+
+    for chunck in input:
+        output = decode(chunck)
+        if output:
+            yield output
+    output = decode(b'', final=True)
+    if output:
+        yield output
+
+
+def iter_encode(input, encoding=UTF8, errors='strict'):
+    """
+    “Pull”-based encoder.
+
+    :param input: An iterable of Unicode strings.
+    :param encoding: An :class:`Encoding` object or a label string.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+    :returns: An iterable of byte strings.
+
+    """
+    # Fail early if `encoding` is an invalid label.
+    encode = IncrementalEncoder(encoding, errors).encode
+    return _iter_encode_generator(input, encode)
+
+
+def _iter_encode_generator(input, encode):
+    for chunck in input:
+        output = encode(chunck)
+        if output:
+            yield output
+    output = encode('', final=True)
+    if output:
+        yield output
+
+
+class IncrementalDecoder(object):
+    """
+    “Push”-based decoder.
+
+    :param fallback_encoding:
+        An :class:`Encoding` object or a label string.
+        The encoding to use if :obj:`input` does note have a BOM.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+
+    """
+    def __init__(self, fallback_encoding, errors='replace'):
+        # Fail early if `encoding` is an invalid label.
+        self._fallback_encoding = _get_encoding(fallback_encoding)
+        self._errors = errors
+        self._buffer = b''
+        self._decoder = None
+        #: The actual :class:`Encoding` that is being used,
+        #: or :obj:`None` if that is not determined yet.
+        #: (Ie. if there is not enough input yet to determine
+        #: if there is a BOM.)
+        self.encoding = None  # Not known yet.
+
+    def decode(self, input, final=False):
+        """Decode one chunk of the input.
+
+        :param input: A byte string.
+        :param final:
+            Indicate that no more input is available.
+            Must be :obj:`True` if this is the last call.
+        :returns: An Unicode string.
+
+        """
+        decoder = self._decoder
+        if decoder is not None:
+            return decoder(input, final)
+
+        input = self._buffer + input
+        encoding, input = _detect_bom(input)
+        if encoding is None:
+            if len(input) < 3 and not final:  # Not enough data yet.
+                self._buffer = input
+                return ''
+            else:  # No BOM
+                encoding = self._fallback_encoding
+        decoder = encoding.codec_info.incrementaldecoder(self._errors).decode
+        self._decoder = decoder
+        self.encoding = encoding
+        return decoder(input, final)
+
+
+class IncrementalEncoder(object):
+    """
+    “Push”-based encoder.
+
+    :param encoding: An :class:`Encoding` object or a label string.
+    :param errors: Type of error handling. See :func:`codecs.register`.
+    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
+
+    .. method:: encode(input, final=False)
+
+        :param input: An Unicode string.
+        :param final:
+            Indicate that no more input is available.
+            Must be :obj:`True` if this is the last call.
+        :returns: A byte string.
+
+    """
+    def __init__(self, encoding=UTF8, errors='strict'):
+        encoding = _get_encoding(encoding)
+        self.encode = encoding.codec_info.incrementalencoder(errors).encode
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/labels.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/labels.py
new file mode 100644
index 0000000000000000000000000000000000000000..29cbf91ef79b89971e51db9ddfc3720d8b4db82a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/labels.py
@@ -0,0 +1,231 @@
+"""
+
+    webencodings.labels
+    ~~~~~~~~~~~~~~~~~~~
+
+    Map encoding labels to their name.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+# XXX Do not edit!
+# This file is automatically generated by mklabels.py
+
+LABELS = {
+    'unicode-1-1-utf-8':   'utf-8',
+    'utf-8':               'utf-8',
+    'utf8':                'utf-8',
+    '866':                 'ibm866',
+    'cp866':               'ibm866',
+    'csibm866':            'ibm866',
+    'ibm866':              'ibm866',
+    'csisolatin2':         'iso-8859-2',
+    'iso-8859-2':          'iso-8859-2',
+    'iso-ir-101':          'iso-8859-2',
+    'iso8859-2':           'iso-8859-2',
+    'iso88592':            'iso-8859-2',
+    'iso_8859-2':          'iso-8859-2',
+    'iso_8859-2:1987':     'iso-8859-2',
+    'l2':                  'iso-8859-2',
+    'latin2':              'iso-8859-2',
+    'csisolatin3':         'iso-8859-3',
+    'iso-8859-3':          'iso-8859-3',
+    'iso-ir-109':          'iso-8859-3',
+    'iso8859-3':           'iso-8859-3',
+    'iso88593':            'iso-8859-3',
+    'iso_8859-3':          'iso-8859-3',
+    'iso_8859-3:1988':     'iso-8859-3',
+    'l3':                  'iso-8859-3',
+    'latin3':              'iso-8859-3',
+    'csisolatin4':         'iso-8859-4',
+    'iso-8859-4':          'iso-8859-4',
+    'iso-ir-110':          'iso-8859-4',
+    'iso8859-4':           'iso-8859-4',
+    'iso88594':            'iso-8859-4',
+    'iso_8859-4':          'iso-8859-4',
+    'iso_8859-4:1988':     'iso-8859-4',
+    'l4':                  'iso-8859-4',
+    'latin4':              'iso-8859-4',
+    'csisolatincyrillic':  'iso-8859-5',
+    'cyrillic':            'iso-8859-5',
+    'iso-8859-5':          'iso-8859-5',
+    'iso-ir-144':          'iso-8859-5',
+    'iso8859-5':           'iso-8859-5',
+    'iso88595':            'iso-8859-5',
+    'iso_8859-5':          'iso-8859-5',
+    'iso_8859-5:1988':     'iso-8859-5',
+    'arabic':              'iso-8859-6',
+    'asmo-708':            'iso-8859-6',
+    'csiso88596e':         'iso-8859-6',
+    'csiso88596i':         'iso-8859-6',
+    'csisolatinarabic':    'iso-8859-6',
+    'ecma-114':            'iso-8859-6',
+    'iso-8859-6':          'iso-8859-6',
+    'iso-8859-6-e':        'iso-8859-6',
+    'iso-8859-6-i':        'iso-8859-6',
+    'iso-ir-127':          'iso-8859-6',
+    'iso8859-6':           'iso-8859-6',
+    'iso88596':            'iso-8859-6',
+    'iso_8859-6':          'iso-8859-6',
+    'iso_8859-6:1987':     'iso-8859-6',
+    'csisolatingreek':     'iso-8859-7',
+    'ecma-118':            'iso-8859-7',
+    'elot_928':            'iso-8859-7',
+    'greek':               'iso-8859-7',
+    'greek8':              'iso-8859-7',
+    'iso-8859-7':          'iso-8859-7',
+    'iso-ir-126':          'iso-8859-7',
+    'iso8859-7':           'iso-8859-7',
+    'iso88597':            'iso-8859-7',
+    'iso_8859-7':          'iso-8859-7',
+    'iso_8859-7:1987':     'iso-8859-7',
+    'sun_eu_greek':        'iso-8859-7',
+    'csiso88598e':         'iso-8859-8',
+    'csisolatinhebrew':    'iso-8859-8',
+    'hebrew':              'iso-8859-8',
+    'iso-8859-8':          'iso-8859-8',
+    'iso-8859-8-e':        'iso-8859-8',
+    'iso-ir-138':          'iso-8859-8',
+    'iso8859-8':           'iso-8859-8',
+    'iso88598':            'iso-8859-8',
+    'iso_8859-8':          'iso-8859-8',
+    'iso_8859-8:1988':     'iso-8859-8',
+    'visual':              'iso-8859-8',
+    'csiso88598i':         'iso-8859-8-i',
+    'iso-8859-8-i':        'iso-8859-8-i',
+    'logical':             'iso-8859-8-i',
+    'csisolatin6':         'iso-8859-10',
+    'iso-8859-10':         'iso-8859-10',
+    'iso-ir-157':          'iso-8859-10',
+    'iso8859-10':          'iso-8859-10',
+    'iso885910':           'iso-8859-10',
+    'l6':                  'iso-8859-10',
+    'latin6':              'iso-8859-10',
+    'iso-8859-13':         'iso-8859-13',
+    'iso8859-13':          'iso-8859-13',
+    'iso885913':           'iso-8859-13',
+    'iso-8859-14':         'iso-8859-14',
+    'iso8859-14':          'iso-8859-14',
+    'iso885914':           'iso-8859-14',
+    'csisolatin9':         'iso-8859-15',
+    'iso-8859-15':         'iso-8859-15',
+    'iso8859-15':          'iso-8859-15',
+    'iso885915':           'iso-8859-15',
+    'iso_8859-15':         'iso-8859-15',
+    'l9':                  'iso-8859-15',
+    'iso-8859-16':         'iso-8859-16',
+    'cskoi8r':             'koi8-r',
+    'koi':                 'koi8-r',
+    'koi8':                'koi8-r',
+    'koi8-r':              'koi8-r',
+    'koi8_r':              'koi8-r',
+    'koi8-u':              'koi8-u',
+    'csmacintosh':         'macintosh',
+    'mac':                 'macintosh',
+    'macintosh':           'macintosh',
+    'x-mac-roman':         'macintosh',
+    'dos-874':             'windows-874',
+    'iso-8859-11':         'windows-874',
+    'iso8859-11':          'windows-874',
+    'iso885911':           'windows-874',
+    'tis-620':             'windows-874',
+    'windows-874':         'windows-874',
+    'cp1250':              'windows-1250',
+    'windows-1250':        'windows-1250',
+    'x-cp1250':            'windows-1250',
+    'cp1251':              'windows-1251',
+    'windows-1251':        'windows-1251',
+    'x-cp1251':            'windows-1251',
+    'ansi_x3.4-1968':      'windows-1252',
+    'ascii':               'windows-1252',
+    'cp1252':              'windows-1252',
+    'cp819':               'windows-1252',
+    'csisolatin1':         'windows-1252',
+    'ibm819':              'windows-1252',
+    'iso-8859-1':          'windows-1252',
+    'iso-ir-100':          'windows-1252',
+    'iso8859-1':           'windows-1252',
+    'iso88591':            'windows-1252',
+    'iso_8859-1':          'windows-1252',
+    'iso_8859-1:1987':     'windows-1252',
+    'l1':                  'windows-1252',
+    'latin1':              'windows-1252',
+    'us-ascii':            'windows-1252',
+    'windows-1252':        'windows-1252',
+    'x-cp1252':            'windows-1252',
+    'cp1253':              'windows-1253',
+    'windows-1253':        'windows-1253',
+    'x-cp1253':            'windows-1253',
+    'cp1254':              'windows-1254',
+    'csisolatin5':         'windows-1254',
+    'iso-8859-9':          'windows-1254',
+    'iso-ir-148':          'windows-1254',
+    'iso8859-9':           'windows-1254',
+    'iso88599':            'windows-1254',
+    'iso_8859-9':          'windows-1254',
+    'iso_8859-9:1989':     'windows-1254',
+    'l5':                  'windows-1254',
+    'latin5':              'windows-1254',
+    'windows-1254':        'windows-1254',
+    'x-cp1254':            'windows-1254',
+    'cp1255':              'windows-1255',
+    'windows-1255':        'windows-1255',
+    'x-cp1255':            'windows-1255',
+    'cp1256':              'windows-1256',
+    'windows-1256':        'windows-1256',
+    'x-cp1256':            'windows-1256',
+    'cp1257':              'windows-1257',
+    'windows-1257':        'windows-1257',
+    'x-cp1257':            'windows-1257',
+    'cp1258':              'windows-1258',
+    'windows-1258':        'windows-1258',
+    'x-cp1258':            'windows-1258',
+    'x-mac-cyrillic':      'x-mac-cyrillic',
+    'x-mac-ukrainian':     'x-mac-cyrillic',
+    'chinese':             'gbk',
+    'csgb2312':            'gbk',
+    'csiso58gb231280':     'gbk',
+    'gb2312':              'gbk',
+    'gb_2312':             'gbk',
+    'gb_2312-80':          'gbk',
+    'gbk':                 'gbk',
+    'iso-ir-58':           'gbk',
+    'x-gbk':               'gbk',
+    'gb18030':             'gb18030',
+    'hz-gb-2312':          'hz-gb-2312',
+    'big5':                'big5',
+    'big5-hkscs':          'big5',
+    'cn-big5':             'big5',
+    'csbig5':              'big5',
+    'x-x-big5':            'big5',
+    'cseucpkdfmtjapanese': 'euc-jp',
+    'euc-jp':              'euc-jp',
+    'x-euc-jp':            'euc-jp',
+    'csiso2022jp':         'iso-2022-jp',
+    'iso-2022-jp':         'iso-2022-jp',
+    'csshiftjis':          'shift_jis',
+    'ms_kanji':            'shift_jis',
+    'shift-jis':           'shift_jis',
+    'shift_jis':           'shift_jis',
+    'sjis':                'shift_jis',
+    'windows-31j':         'shift_jis',
+    'x-sjis':              'shift_jis',
+    'cseuckr':             'euc-kr',
+    'csksc56011987':       'euc-kr',
+    'euc-kr':              'euc-kr',
+    'iso-ir-149':          'euc-kr',
+    'korean':              'euc-kr',
+    'ks_c_5601-1987':      'euc-kr',
+    'ks_c_5601-1989':      'euc-kr',
+    'ksc5601':             'euc-kr',
+    'ksc_5601':            'euc-kr',
+    'windows-949':         'euc-kr',
+    'csiso2022kr':         'iso-2022-kr',
+    'iso-2022-kr':         'iso-2022-kr',
+    'utf-16be':            'utf-16be',
+    'utf-16':              'utf-16le',
+    'utf-16le':            'utf-16le',
+    'x-user-defined':      'x-user-defined',
+}
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/mklabels.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/mklabels.py
new file mode 100644
index 0000000000000000000000000000000000000000..295dc928ba71fc00caa52708ac70097abe6dc3e4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/mklabels.py
@@ -0,0 +1,59 @@
+"""
+
+    webencodings.mklabels
+    ~~~~~~~~~~~~~~~~~~~~~
+
+    Regenarate the webencodings.labels module.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+import json
+try:
+    from urllib import urlopen
+except ImportError:
+    from urllib.request import urlopen
+
+
+def assert_lower(string):
+    assert string == string.lower()
+    return string
+
+
+def generate(url):
+    parts = ['''\
+"""
+
+    webencodings.labels
+    ~~~~~~~~~~~~~~~~~~~
+
+    Map encoding labels to their name.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+# XXX Do not edit!
+# This file is automatically generated by mklabels.py
+
+LABELS = {
+''']
+    labels = [
+        (repr(assert_lower(label)).lstrip('u'),
+         repr(encoding['name']).lstrip('u'))
+        for category in json.loads(urlopen(url).read().decode('ascii'))
+        for encoding in category['encodings']
+        for label in encoding['labels']]
+    max_len = max(len(label) for label, name in labels)
+    parts.extend(
+        '    %s:%s %s,\n' % (label, ' ' * (max_len - len(label)), name)
+        for label, name in labels)
+    parts.append('}')
+    return ''.join(parts)
+
+
+if __name__ == '__main__':
+    print(generate('http://encoding.spec.whatwg.org/encodings.json'))
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/tests.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/tests.py
new file mode 100644
index 0000000000000000000000000000000000000000..e12c10d033026f09cf97b81d29555e12aae8c762
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/tests.py
@@ -0,0 +1,153 @@
+# coding: utf-8
+"""
+
+    webencodings.tests
+    ~~~~~~~~~~~~~~~~~~
+
+    A basic test suite for Encoding.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+from __future__ import unicode_literals
+
+from . import (lookup, LABELS, decode, encode, iter_decode, iter_encode,
+               IncrementalDecoder, IncrementalEncoder, UTF8)
+
+
+def assert_raises(exception, function, *args, **kwargs):
+    try:
+        function(*args, **kwargs)
+    except exception:
+        return
+    else:  # pragma: no cover
+        raise AssertionError('Did not raise %s.' % exception)
+
+
+def test_labels():
+    assert lookup('utf-8').name == 'utf-8'
+    assert lookup('Utf-8').name == 'utf-8'
+    assert lookup('UTF-8').name == 'utf-8'
+    assert lookup('utf8').name == 'utf-8'
+    assert lookup('utf8').name == 'utf-8'
+    assert lookup('utf8 ').name == 'utf-8'
+    assert lookup(' \r\nutf8\t').name == 'utf-8'
+    assert lookup('u8') is None  # Python label.
+    assert lookup('utf-8 ') is None  # Non-ASCII white space.
+
+    assert lookup('US-ASCII').name == 'windows-1252'
+    assert lookup('iso-8859-1').name == 'windows-1252'
+    assert lookup('latin1').name == 'windows-1252'
+    assert lookup('LATIN1').name == 'windows-1252'
+    assert lookup('latin-1') is None
+    assert lookup('LATİN1') is None  # ASCII-only case insensitivity.
+
+
+def test_all_labels():
+    for label in LABELS:
+        assert decode(b'', label) == ('', lookup(label))
+        assert encode('', label) == b''
+        for repeat in [0, 1, 12]:
+            output, _ = iter_decode([b''] * repeat, label)
+            assert list(output) == []
+            assert list(iter_encode([''] * repeat, label)) == []
+        decoder = IncrementalDecoder(label)
+        assert decoder.decode(b'') == ''
+        assert decoder.decode(b'', final=True) == ''
+        encoder = IncrementalEncoder(label)
+        assert encoder.encode('') == b''
+        assert encoder.encode('', final=True) == b''
+    # All encoding names are valid labels too:
+    for name in set(LABELS.values()):
+        assert lookup(name).name == name
+
+
+def test_invalid_label():
+    assert_raises(LookupError, decode, b'\xEF\xBB\xBF\xc3\xa9', 'invalid')
+    assert_raises(LookupError, encode, 'é', 'invalid')
+    assert_raises(LookupError, iter_decode, [], 'invalid')
+    assert_raises(LookupError, iter_encode, [], 'invalid')
+    assert_raises(LookupError, IncrementalDecoder, 'invalid')
+    assert_raises(LookupError, IncrementalEncoder, 'invalid')
+
+
+def test_decode():
+    assert decode(b'\x80', 'latin1') == ('€', lookup('latin1'))
+    assert decode(b'\x80', lookup('latin1')) == ('€', lookup('latin1'))
+    assert decode(b'\xc3\xa9', 'utf8') == ('é', lookup('utf8'))
+    assert decode(b'\xc3\xa9', UTF8) == ('é', lookup('utf8'))
+    assert decode(b'\xc3\xa9', 'ascii') == ('é', lookup('ascii'))
+    assert decode(b'\xEF\xBB\xBF\xc3\xa9', 'ascii') == ('é', lookup('utf8'))  # UTF-8 with BOM
+
+    assert decode(b'\xFE\xFF\x00\xe9', 'ascii') == ('é', lookup('utf-16be'))  # UTF-16-BE with BOM
+    assert decode(b'\xFF\xFE\xe9\x00', 'ascii') == ('é', lookup('utf-16le'))  # UTF-16-LE with BOM
+    assert decode(b'\xFE\xFF\xe9\x00', 'ascii') == ('\ue900', lookup('utf-16be'))
+    assert decode(b'\xFF\xFE\x00\xe9', 'ascii') == ('\ue900', lookup('utf-16le'))
+
+    assert decode(b'\x00\xe9', 'UTF-16BE') == ('é', lookup('utf-16be'))
+    assert decode(b'\xe9\x00', 'UTF-16LE') == ('é', lookup('utf-16le'))
+    assert decode(b'\xe9\x00', 'UTF-16') == ('é', lookup('utf-16le'))
+
+    assert decode(b'\xe9\x00', 'UTF-16BE') == ('\ue900', lookup('utf-16be'))
+    assert decode(b'\x00\xe9', 'UTF-16LE') == ('\ue900', lookup('utf-16le'))
+    assert decode(b'\x00\xe9', 'UTF-16') == ('\ue900', lookup('utf-16le'))
+
+
+def test_encode():
+    assert encode('é', 'latin1') == b'\xe9'
+    assert encode('é', 'utf8') == b'\xc3\xa9'
+    assert encode('é', 'utf8') == b'\xc3\xa9'
+    assert encode('é', 'utf-16') == b'\xe9\x00'
+    assert encode('é', 'utf-16le') == b'\xe9\x00'
+    assert encode('é', 'utf-16be') == b'\x00\xe9'
+
+
+def test_iter_decode():
+    def iter_decode_to_string(input, fallback_encoding):
+        output, _encoding = iter_decode(input, fallback_encoding)
+        return ''.join(output)
+    assert iter_decode_to_string([], 'latin1') == ''
+    assert iter_decode_to_string([b''], 'latin1') == ''
+    assert iter_decode_to_string([b'\xe9'], 'latin1') == 'é'
+    assert iter_decode_to_string([b'hello'], 'latin1') == 'hello'
+    assert iter_decode_to_string([b'he', b'llo'], 'latin1') == 'hello'
+    assert iter_decode_to_string([b'hell', b'o'], 'latin1') == 'hello'
+    assert iter_decode_to_string([b'\xc3\xa9'], 'latin1') == 'é'
+    assert iter_decode_to_string([b'\xEF\xBB\xBF\xc3\xa9'], 'latin1') == 'é'
+    assert iter_decode_to_string([
+        b'\xEF\xBB\xBF', b'\xc3', b'\xa9'], 'latin1') == 'é'
+    assert iter_decode_to_string([
+        b'\xEF\xBB\xBF', b'a', b'\xc3'], 'latin1') == 'a\uFFFD'
+    assert iter_decode_to_string([
+        b'', b'\xEF', b'', b'', b'\xBB\xBF\xc3', b'\xa9'], 'latin1') == 'é'
+    assert iter_decode_to_string([b'\xEF\xBB\xBF'], 'latin1') == ''
+    assert iter_decode_to_string([b'\xEF\xBB'], 'latin1') == 'ï»'
+    assert iter_decode_to_string([b'\xFE\xFF\x00\xe9'], 'latin1') == 'é'
+    assert iter_decode_to_string([b'\xFF\xFE\xe9\x00'], 'latin1') == 'é'
+    assert iter_decode_to_string([
+        b'', b'\xFF', b'', b'', b'\xFE\xe9', b'\x00'], 'latin1') == 'é'
+    assert iter_decode_to_string([
+        b'', b'h\xe9', b'llo'], 'x-user-defined') == 'h\uF7E9llo'
+
+
+def test_iter_encode():
+    assert b''.join(iter_encode([], 'latin1')) == b''
+    assert b''.join(iter_encode([''], 'latin1')) == b''
+    assert b''.join(iter_encode(['é'], 'latin1')) == b'\xe9'
+    assert b''.join(iter_encode(['', 'é', '', ''], 'latin1')) == b'\xe9'
+    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16')) == b'\xe9\x00'
+    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16le')) == b'\xe9\x00'
+    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16be')) == b'\x00\xe9'
+    assert b''.join(iter_encode([
+        '', 'h\uF7E9', '', 'llo'], 'x-user-defined')) == b'h\xe9llo'
+
+
+def test_x_user_defined():
+    encoded = b'2,\x0c\x0b\x1aO\xd9#\xcb\x0f\xc9\xbbt\xcf\xa8\xca'
+    decoded = '2,\x0c\x0b\x1aO\uf7d9#\uf7cb\x0f\uf7c9\uf7bbt\uf7cf\uf7a8\uf7ca'
+    encoded = b'aa'
+    decoded = 'aa'
+    assert decode(encoded, 'x-user-defined') == (decoded, lookup('x-user-defined'))
+    assert encode(decoded, 'x-user-defined') == encoded
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/x_user_defined.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/x_user_defined.py
new file mode 100644
index 0000000000000000000000000000000000000000..d16e326024c05a59548619e13258acad781e0a6d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/webencodings/x_user_defined.py
@@ -0,0 +1,325 @@
+# coding: utf-8
+"""
+
+    webencodings.x_user_defined
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    An implementation of the x-user-defined encoding.
+
+    :copyright: Copyright 2012 by Simon Sapin
+    :license: BSD, see LICENSE for details.
+
+"""
+
+from __future__ import unicode_literals
+
+import codecs
+
+
+### Codec APIs
+
+class Codec(codecs.Codec):
+
+    def encode(self, input, errors='strict'):
+        return codecs.charmap_encode(input, errors, encoding_table)
+
+    def decode(self, input, errors='strict'):
+        return codecs.charmap_decode(input, errors, decoding_table)
+
+
+class IncrementalEncoder(codecs.IncrementalEncoder):
+    def encode(self, input, final=False):
+        return codecs.charmap_encode(input, self.errors, encoding_table)[0]
+
+
+class IncrementalDecoder(codecs.IncrementalDecoder):
+    def decode(self, input, final=False):
+        return codecs.charmap_decode(input, self.errors, decoding_table)[0]
+
+
+class StreamWriter(Codec, codecs.StreamWriter):
+    pass
+
+
+class StreamReader(Codec, codecs.StreamReader):
+    pass
+
+
+### encodings module API
+
+codec_info = codecs.CodecInfo(
+    name='x-user-defined',
+    encode=Codec().encode,
+    decode=Codec().decode,
+    incrementalencoder=IncrementalEncoder,
+    incrementaldecoder=IncrementalDecoder,
+    streamreader=StreamReader,
+    streamwriter=StreamWriter,
+)
+
+
+### Decoding Table
+
+# Python 3:
+# for c in range(256): print('    %r' % chr(c if c < 128 else c + 0xF700))
+decoding_table = (
+    '\x00'
+    '\x01'
+    '\x02'
+    '\x03'
+    '\x04'
+    '\x05'
+    '\x06'
+    '\x07'
+    '\x08'
+    '\t'
+    '\n'
+    '\x0b'
+    '\x0c'
+    '\r'
+    '\x0e'
+    '\x0f'
+    '\x10'
+    '\x11'
+    '\x12'
+    '\x13'
+    '\x14'
+    '\x15'
+    '\x16'
+    '\x17'
+    '\x18'
+    '\x19'
+    '\x1a'
+    '\x1b'
+    '\x1c'
+    '\x1d'
+    '\x1e'
+    '\x1f'
+    ' '
+    '!'
+    '"'
+    '#'
+    '$'
+    '%'
+    '&'
+    "'"
+    '('
+    ')'
+    '*'
+    '+'
+    ','
+    '-'
+    '.'
+    '/'
+    '0'
+    '1'
+    '2'
+    '3'
+    '4'
+    '5'
+    '6'
+    '7'
+    '8'
+    '9'
+    ':'
+    ';'
+    '<'
+    '='
+    '>'
+    '?'
+    '@'
+    'A'
+    'B'
+    'C'
+    'D'
+    'E'
+    'F'
+    'G'
+    'H'
+    'I'
+    'J'
+    'K'
+    'L'
+    'M'
+    'N'
+    'O'
+    'P'
+    'Q'
+    'R'
+    'S'
+    'T'
+    'U'
+    'V'
+    'W'
+    'X'
+    'Y'
+    'Z'
+    '['
+    '\\'
+    ']'
+    '^'
+    '_'
+    '`'
+    'a'
+    'b'
+    'c'
+    'd'
+    'e'
+    'f'
+    'g'
+    'h'
+    'i'
+    'j'
+    'k'
+    'l'
+    'm'
+    'n'
+    'o'
+    'p'
+    'q'
+    'r'
+    's'
+    't'
+    'u'
+    'v'
+    'w'
+    'x'
+    'y'
+    'z'
+    '{'
+    '|'
+    '}'
+    '~'
+    '\x7f'
+    '\uf780'
+    '\uf781'
+    '\uf782'
+    '\uf783'
+    '\uf784'
+    '\uf785'
+    '\uf786'
+    '\uf787'
+    '\uf788'
+    '\uf789'
+    '\uf78a'
+    '\uf78b'
+    '\uf78c'
+    '\uf78d'
+    '\uf78e'
+    '\uf78f'
+    '\uf790'
+    '\uf791'
+    '\uf792'
+    '\uf793'
+    '\uf794'
+    '\uf795'
+    '\uf796'
+    '\uf797'
+    '\uf798'
+    '\uf799'
+    '\uf79a'
+    '\uf79b'
+    '\uf79c'
+    '\uf79d'
+    '\uf79e'
+    '\uf79f'
+    '\uf7a0'
+    '\uf7a1'
+    '\uf7a2'
+    '\uf7a3'
+    '\uf7a4'
+    '\uf7a5'
+    '\uf7a6'
+    '\uf7a7'
+    '\uf7a8'
+    '\uf7a9'
+    '\uf7aa'
+    '\uf7ab'
+    '\uf7ac'
+    '\uf7ad'
+    '\uf7ae'
+    '\uf7af'
+    '\uf7b0'
+    '\uf7b1'
+    '\uf7b2'
+    '\uf7b3'
+    '\uf7b4'
+    '\uf7b5'
+    '\uf7b6'
+    '\uf7b7'
+    '\uf7b8'
+    '\uf7b9'
+    '\uf7ba'
+    '\uf7bb'
+    '\uf7bc'
+    '\uf7bd'
+    '\uf7be'
+    '\uf7bf'
+    '\uf7c0'
+    '\uf7c1'
+    '\uf7c2'
+    '\uf7c3'
+    '\uf7c4'
+    '\uf7c5'
+    '\uf7c6'
+    '\uf7c7'
+    '\uf7c8'
+    '\uf7c9'
+    '\uf7ca'
+    '\uf7cb'
+    '\uf7cc'
+    '\uf7cd'
+    '\uf7ce'
+    '\uf7cf'
+    '\uf7d0'
+    '\uf7d1'
+    '\uf7d2'
+    '\uf7d3'
+    '\uf7d4'
+    '\uf7d5'
+    '\uf7d6'
+    '\uf7d7'
+    '\uf7d8'
+    '\uf7d9'
+    '\uf7da'
+    '\uf7db'
+    '\uf7dc'
+    '\uf7dd'
+    '\uf7de'
+    '\uf7df'
+    '\uf7e0'
+    '\uf7e1'
+    '\uf7e2'
+    '\uf7e3'
+    '\uf7e4'
+    '\uf7e5'
+    '\uf7e6'
+    '\uf7e7'
+    '\uf7e8'
+    '\uf7e9'
+    '\uf7ea'
+    '\uf7eb'
+    '\uf7ec'
+    '\uf7ed'
+    '\uf7ee'
+    '\uf7ef'
+    '\uf7f0'
+    '\uf7f1'
+    '\uf7f2'
+    '\uf7f3'
+    '\uf7f4'
+    '\uf7f5'
+    '\uf7f6'
+    '\uf7f7'
+    '\uf7f8'
+    '\uf7f9'
+    '\uf7fa'
+    '\uf7fb'
+    '\uf7fc'
+    '\uf7fd'
+    '\uf7fe'
+    '\uf7ff'
+)
+
+### Encoding table
+encoding_table = codecs.charmap_build(decoding_table)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt
new file mode 100644
index 0000000000000000000000000000000000000000..72c87d7d38ae7bf859717c333a5ee8230f6ce624
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/AUTHORS.txt
@@ -0,0 +1,562 @@
+A_Rog <adam.thomas.rogerson@gmail.com>
+Aakanksha Agrawal <11389424+rasponic@users.noreply.github.com>
+Abhinav Sagar <40603139+abhinavsagar@users.noreply.github.com>
+ABHYUDAY PRATAP SINGH <abhyudaypratap@outlook.com>
+abs51295 <aagams68@gmail.com>
+AceGentile <ventogrigio83@gmail.com>
+Adam Chainz <adam@adamj.eu>
+Adam Tse <adam.tse@me.com>
+Adam Tse <atse@users.noreply.github.com>
+Adam Wentz <awentz@theonion.com>
+admin <admin@admins-MacBook-Pro.local>
+Adrien Morison <adrien.morison@gmail.com>
+ahayrapetyan <ahayrapetya2@bloomberg.net>
+Ahilya <ahilya16009@iiitd.ac.in>
+AinsworthK <yat626@yahoo.com.hk>
+Akash Srivastava <akashsrivastava4927@gmail.com>
+Alan Yee <alyee@ucsd.edu>
+Albert Tugushev <albert@tugushev.ru>
+Albert-Guan <albert.guan94@gmail.com>
+albertg <albert.guan94@gmail.com>
+Aleks Bunin <github@compuix.com>
+Alethea Flowers <magicalgirl@google.com>
+Alex Gaynor <alex.gaynor@gmail.com>
+Alex Grönholm <alex.gronholm@nextday.fi>
+Alex Loosley <a.loosley@reply.de>
+Alex Morega <alex@grep.ro>
+Alex Stachowiak <alexander@computer.org>
+Alexander Shtyrov <rawzausho@gmail.com>
+Alexandre Conrad <alexandre.conrad@gmail.com>
+Alexey Popravka <a.popravka@smartweb.com.ua>
+Alexey Popravka <alexey.popravka@horsedevel.com>
+Alli <alzeih@users.noreply.github.com>
+Ami Fischman <ami@fischman.org>
+Ananya Maiti <ananyoevo@gmail.com>
+Anatoly Techtonik <techtonik@gmail.com>
+Anders Kaseorg <andersk@mit.edu>
+Andreas Lutro <anlutro@gmail.com>
+Andrei Geacar <andrei.geacar@gmail.com>
+Andrew Gaul <andrew@gaul.org>
+Andrey Bulgakov <mail@andreiko.ru>
+Andrés Delfino <34587441+andresdelfino@users.noreply.github.com>
+Andrés Delfino <adelfino@gmail.com>
+Andy Freeland <andy.freeland@redjack.com>
+Andy Freeland <andy@andyfreeland.net>
+Andy Kluger <AndydeCleyre@users.noreply.github.com>
+Ani Hayrapetyan <ahayrapetya2@bloomberg.net>
+Aniruddha Basak <codewithaniruddha@gmail.com>
+Anish Tambe <anish.tambe@yahoo.in>
+Anrs Hu <anrs@douban.com>
+Anthony Sottile <asottile@umich.edu>
+Antoine Musso <hashar@free.fr>
+Anton Ovchinnikov <revolver112@gmail.com>
+Anton Patrushev <apatrushev@gmail.com>
+Antonio Alvarado Hernandez <tnotstar@gmail.com>
+Antony Lee <anntzer.lee@gmail.com>
+Antti Kaihola <akaihol+github@ambitone.com>
+Anubhav Patel <anubhavp28@gmail.com>
+Anuj Godase <godaseanuj@gmail.com>
+AQNOUCH Mohammed <aqnouch.mohammed@gmail.com>
+AraHaan <seandhunt_7@yahoo.com>
+Arindam Choudhury <arindam@live.com>
+Armin Ronacher <armin.ronacher@active-4.com>
+Artem <duketemon@users.noreply.github.com>
+Ashley Manton <ajd.manton@googlemail.com>
+Ashwin Ramaswami <aramaswamis@gmail.com>
+atse <atse@users.noreply.github.com>
+Atsushi Odagiri <aodagx@gmail.com>
+Avner Cohen <israbirding@gmail.com>
+Baptiste Mispelon <bmispelon@gmail.com>
+Barney Gale <barney.gale@gmail.com>
+barneygale <barney.gale@gmail.com>
+Bartek Ogryczak <b.ogryczak@gmail.com>
+Bastian Venthur <mail@venthur.de>
+Ben Darnell <ben@bendarnell.com>
+Ben Hoyt <benhoyt@gmail.com>
+Ben Rosser <rosser.bjr@gmail.com>
+Bence Nagy <bence@underyx.me>
+Benjamin Peterson <benjamin@python.org>
+Benjamin VanEvery <ben@simondata.com>
+Benoit Pierre <benoit.pierre@gmail.com>
+Berker Peksag <berker.peksag@gmail.com>
+Bernardo B. Marques <bernardo.fire@gmail.com>
+Bernhard M. Wiedemann <bwiedemann@suse.de>
+Bertil Hatt <bertil.hatt@farfetch.com>
+Bogdan Opanchuk <bogdan@opanchuk.net>
+BorisZZZ <BorisZZZ@users.noreply.github.com>
+Brad Erickson <eosrei@gmail.com>
+Bradley Ayers <bradley.ayers@gmail.com>
+Brandon L. Reiss <brandon@damyata.co>
+Brandt Bucher <brandtbucher@gmail.com>
+Brett Randall <javabrett@gmail.com>
+Brian Cristante <33549821+brcrista@users.noreply.github.com>
+Brian Cristante <brcrista@microsoft.com>
+Brian Rosner <brosner@gmail.com>
+BrownTruck <BrownTruck@users.noreply.github.com>
+Bruno Oliveira <nicoddemus@gmail.com>
+Bruno Renié <brutasse@gmail.com>
+Bstrdsmkr <bstrdsmkr@gmail.com>
+Buck Golemon <buck@yelp.com>
+burrows <burrows@preveil.com>
+Bussonnier Matthias <bussonniermatthias@gmail.com>
+c22 <c22@users.noreply.github.com>
+Caleb Martinez <accounts@calebmartinez.com>
+Calvin Smith <eukaryote@users.noreply.github.com>
+Carl Meyer <carl@oddbird.net>
+Carlos Liam <carlos@aarzee.me>
+Carol Willing <carolcode@willingconsulting.com>
+Carter Thayer <carterwthayer@gmail.com>
+Cass <cass.petrus@gmail.com>
+Chandrasekhar Atina <chandu.atina@gmail.com>
+Chih-Hsuan Yen <yan12125@gmail.com>
+Chih-Hsuan Yen <yen@chyen.cc>
+Chris Brinker <chris.brinker@gmail.com>
+Chris Hunt <chrahunt@gmail.com>
+Chris Jerdonek <chris.jerdonek@gmail.com>
+Chris McDonough <chrism@plope.com>
+Chris Wolfe <chriswwolfe@gmail.com>
+Christian Heimes <christian@python.org>
+Christian Oudard <christian.oudard@gmail.com>
+Christopher Hunt <chrahunt@gmail.com>
+Christopher Snyder <cnsnyder@users.noreply.github.com>
+Clark Boylan <clark.boylan@gmail.com>
+Clay McClure <clay@daemons.net>
+Cody <Purring@users.noreply.github.com>
+Cody Soyland <codysoyland@gmail.com>
+Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
+Cooper Lees <me@cooperlees.com>
+Cooper Ry Lees <me@cooperlees.com>
+Cory Benfield <lukasaoz@gmail.com>
+Cory Wright <corywright@gmail.com>
+Craig Kerstiens <craig.kerstiens@gmail.com>
+Cristian Sorinel <cristian.sorinel@gmail.com>
+Curtis Doty <Curtis@GreenKey.net>
+cytolentino <ctolentino8@bloomberg.net>
+Damian Quiroga <qdamian@gmail.com>
+Dan Black <dyspop@gmail.com>
+Dan Savilonis <djs@n-cube.org>
+Dan Sully <daniel-github@electricrain.com>
+daniel <mcdonaldd@unimelb.edu.au>
+Daniel Collins <accounts@dac.io>
+Daniel Hahler <git@thequod.de>
+Daniel Holth <dholth@fastmail.fm>
+Daniel Jost <torpedojost@gmail.com>
+Daniel Shaulov <daniel.shaulov@gmail.com>
+Daniele Esposti <expobrain@users.noreply.github.com>
+Daniele Procida <daniele@vurt.org>
+Danny Hermes <daniel.j.hermes@gmail.com>
+Dav Clark <davclark@gmail.com>
+Dave Abrahams <dave@boostpro.com>
+Dave Jones <dave@waveform.org.uk>
+David Aguilar <davvid@gmail.com>
+David Black <db@d1b.org>
+David Bordeynik <david.bordeynik@gmail.com>
+David Bordeynik <david@zebra-med.com>
+David Caro <david@dcaro.es>
+David Evans <d@drhevans.com>
+David Linke <dr.david.linke@gmail.com>
+David Pursehouse <david.pursehouse@gmail.com>
+David Tucker <david@tucker.name>
+David Wales <daviewales@gmail.com>
+Davidovich <david.genest@gmail.com>
+derwolfe <chriswwolfe@gmail.com>
+Desetude <harry@desetude.com>
+Diego Caraballo <diegocaraballo84@gmail.com>
+DiegoCaraballo <diegocaraballo84@gmail.com>
+Dmitry Gladkov <dmitry.gladkov@gmail.com>
+Domen Kožar <domen@dev.si>
+Donald Stufft <donald@stufft.io>
+Dongweiming <dongweiming@admaster.com.cn>
+Douglas Thor <dougthor42@users.noreply.github.com>
+DrFeathers <WilliamGeorgeBurgess@gmail.com>
+Dustin Ingram <di@di.codes>
+Dwayne Bailey <dwayne@translate.org.za>
+Ed Morley <501702+edmorley@users.noreply.github.com>
+Ed Morley <emorley@mozilla.com>
+Eitan Adler <lists@eitanadler.com>
+ekristina <panacejja@gmail.com>
+elainechan <elaine.chan@outlook.com>
+Eli Schwartz <eschwartz93@gmail.com>
+Eli Schwartz <eschwartz@archlinux.org>
+Emil Burzo <contact@emilburzo.com>
+Emil Styrke <emil.styrke@gmail.com>
+Endoh Takanao <djmchl@gmail.com>
+enoch <lanxenet@gmail.com>
+Erdinc Mutlu <erdinc_mutlu@yahoo.com>
+Eric Gillingham <Gillingham@bikezen.net>
+Eric Hanchrow <eric.hanchrow@gmail.com>
+Eric Hopper <hopper@omnifarious.org>
+Erik M. Bray <embray@stsci.edu>
+Erik Rose <erik@mozilla.com>
+Ernest W Durbin III <ewdurbin@gmail.com>
+Ernest W. Durbin III <ewdurbin@gmail.com>
+Erwin Janssen <erwinjanssen@outlook.com>
+Eugene Vereshchagin <evvers@gmail.com>
+everdimension <everdimension@gmail.com>
+Felix Yan <felixonmars@archlinux.org>
+fiber-space <fiber-space@users.noreply.github.com>
+Filip Kokosiński <filip.kokosinski@gmail.com>
+Florian Briand <ownerfrance+github@hotmail.com>
+Florian Rathgeber <florian.rathgeber@gmail.com>
+Francesco <f.guerrieri@gmail.com>
+Francesco Montesano <franz.bergesund@gmail.com>
+Frost Ming <mianghong@gmail.com>
+Gabriel Curio <g.curio@gmail.com>
+Gabriel de Perthuis <g2p.code@gmail.com>
+Garry Polley <garrympolley@gmail.com>
+gdanielson <graeme.danielson@gmail.com>
+Geoffrey Lehée <geoffrey@lehee.name>
+Geoffrey Sneddon <me@gsnedders.com>
+George Song <george@55minutes.com>
+Georgi Valkov <georgi.t.valkov@gmail.com>
+Giftlin Rajaiah <giftlin.rgn@gmail.com>
+gizmoguy1 <gizmoguy1@gmail.com>
+gkdoc <40815324+gkdoc@users.noreply.github.com>
+Gopinath M <31352222+mgopi1990@users.noreply.github.com>
+GOTO Hayato <3532528+gh640@users.noreply.github.com>
+gpiks <gaurav.pikale@gmail.com>
+Guilherme Espada <porcariadagata@gmail.com>
+Guy Rozendorn <guy@rzn.co.il>
+gzpan123 <gzpan123@gmail.com>
+Hanjun Kim <hallazzang@gmail.com>
+Hari Charan <hcharan997@gmail.com>
+Harsh Vardhan <harsh59v@gmail.com>
+Herbert Pfennig <herbert@albinen.com>
+Hsiaoming Yang <lepture@me.com>
+Hugo <hugovk@users.noreply.github.com>
+Hugo Lopes Tavares <hltbra@gmail.com>
+Hugo van Kemenade <hugovk@users.noreply.github.com>
+hugovk <hugovk@users.noreply.github.com>
+Hynek Schlawack <hs@ox.cx>
+Ian Bicking <ianb@colorstudy.com>
+Ian Cordasco <graffatcolmingov@gmail.com>
+Ian Lee <IanLee1521@gmail.com>
+Ian Stapleton Cordasco <graffatcolmingov@gmail.com>
+Ian Wienand <ian@wienand.org>
+Ian Wienand <iwienand@redhat.com>
+Igor Kuzmitshov <kuzmiigo@gmail.com>
+Igor Sobreira <igor@igorsobreira.com>
+Ilya Baryshev <baryshev@gmail.com>
+INADA Naoki <songofacandy@gmail.com>
+Ionel Cristian Mărieș <contact@ionelmc.ro>
+Ionel Maries Cristian <ionel.mc@gmail.com>
+Ivan Pozdeev <vano@mail.mipt.ru>
+Jacob Kim <me@thejacobkim.com>
+jakirkham <jakirkham@gmail.com>
+Jakub Stasiak <kuba.stasiak@gmail.com>
+Jakub Vysoky <jakub@borka.cz>
+Jakub Wilk <jwilk@jwilk.net>
+James Cleveland <jamescleveland@gmail.com>
+James Cleveland <radiosilence@users.noreply.github.com>
+James Firth <hello@james-firth.com>
+James Polley <jp@jamezpolley.com>
+Jan Pokorný <jpokorny@redhat.com>
+Jannis Leidel <jannis@leidel.info>
+jarondl <me@jarondl.net>
+Jason R. Coombs <jaraco@jaraco.com>
+Jay Graves <jay@skabber.com>
+Jean-Christophe Fillion-Robin <jchris.fillionr@kitware.com>
+Jeff Barber <jbarber@computer.org>
+Jeff Dairiki <dairiki@dairiki.org>
+Jelmer Vernooij <jelmer@jelmer.uk>
+jenix21 <devfrog@gmail.com>
+Jeremy Stanley <fungi@yuggoth.org>
+Jeremy Zafran <jzafran@users.noreply.github.com>
+Jiashuo Li <jiasli@microsoft.com>
+Jim Garrison <jim@garrison.cc>
+Jivan Amara <Development@JivanAmara.net>
+John Paton <j.paton@catawiki.nl>
+John-Scott Atlakson <john.scott.atlakson@gmail.com>
+johnthagen <johnthagen@gmail.com>
+johnthagen <johnthagen@users.noreply.github.com>
+Jon Banafato <jon@jonafato.com>
+Jon Dufresne <jon.dufresne@gmail.com>
+Jon Parise <jon@indelible.org>
+Jonas Nockert <jonasnockert@gmail.com>
+Jonathan Herbert <foohyfooh@gmail.com>
+Joost Molenaar <j.j.molenaar@gmail.com>
+Jorge Niedbalski <niedbalski@gmail.com>
+Joseph Long <jdl@fastmail.fm>
+Josh Bronson <jabronson@gmail.com>
+Josh Hansen <josh@skwash.net>
+Josh Schneier <josh.schneier@gmail.com>
+Juanjo Bazán <jjbazan@gmail.com>
+Julian Berman <Julian@GrayVines.com>
+Julian Gethmann <julian.gethmann@kit.edu>
+Julien Demoor <julien@jdemoor.com>
+jwg4 <jack.grahl@yahoo.co.uk>
+Jyrki Pulliainen <jyrki@spotify.com>
+Kai Chen <kaichen120@gmail.com>
+Kamal Bin Mustafa <kamal@smach.net>
+kaustav haldar <hi@kaustav.me>
+keanemind <keanemind@gmail.com>
+Keith Maxwell <keith.maxwell@gmail.com>
+Kelsey Hightower <kelsey.hightower@gmail.com>
+Kenneth Belitzky <kenny@belitzky.com>
+Kenneth Reitz <me@kennethreitz.com>
+Kenneth Reitz <me@kennethreitz.org>
+Kevin Burke <kev@inburke.com>
+Kevin Carter <kevin.carter@rackspace.com>
+Kevin Frommelt <kevin.frommelt@webfilings.com>
+Kevin R Patterson <kevin.r.patterson@intel.com>
+Kexuan Sun <me@kianasun.com>
+Kit Randel <kit@nocturne.net.nz>
+kpinc <kop@meme.com>
+Krishna Oza <krishoza15sep@gmail.com>
+Kumar McMillan <kumar.mcmillan@gmail.com>
+Kyle Persohn <kyle.persohn@gmail.com>
+lakshmanaram <lakshmanaram.n@gmail.com>
+Laszlo Kiss-Kollar <kiss.kollar.laszlo@gmail.com>
+Laurent Bristiel <laurent@bristiel.com>
+Laurie Opperman <laurie@sitesee.com.au>
+Leon Sasson <leonsassonha@gmail.com>
+Lev Givon <lev@columbia.edu>
+Lincoln de Sousa <lincoln@comum.org>
+Lipis <lipiridis@gmail.com>
+Loren Carvalho <lcarvalho@linkedin.com>
+Lucas Cimon <lucas.cimon@gmail.com>
+Ludovic Gasc <gmludo@gmail.com>
+Luke Macken <lmacken@redhat.com>
+Luo Jiebin <luo.jiebin@qq.com>
+luojiebin <luojiebin@users.noreply.github.com>
+luz.paz <luzpaz@users.noreply.github.com>
+László Kiss Kollár <lkisskollar@bloomberg.net>
+László Kiss Kollár <lkollar@users.noreply.github.com>
+Marc Abramowitz <marc@marc-abramowitz.com>
+Marc Tamlyn <marc.tamlyn@gmail.com>
+Marcus Smith <qwcode@gmail.com>
+Mariatta <Mariatta@users.noreply.github.com>
+Mark Kohler <mark.kohler@proteinsimple.com>
+Mark Williams <markrwilliams@gmail.com>
+Mark Williams <mrw@enotuniq.org>
+Markus Hametner <fin+github@xbhd.org>
+Masaki <mk5986@nyu.edu>
+Masklinn <bitbucket.org@masklinn.net>
+Matej Stuchlik <mstuchli@redhat.com>
+Mathew Jennings <mjennings@foursquare.com>
+Mathieu Bridon <bochecha@daitauha.fr>
+Matt Good <matt@matt-good.net>
+Matt Maker <trip@monstro.us>
+Matt Robenolt <matt@ydekproductions.com>
+matthew <matthew@trumbell.net>
+Matthew Einhorn <moiein2000@gmail.com>
+Matthew Gilliard <matthew.gilliard@gmail.com>
+Matthew Iversen <teh.ivo@gmail.com>
+Matthew Trumbell <matthew@thirdstonepartners.com>
+Matthew Willson <matthew@swiftkey.com>
+Matthias Bussonnier <bussonniermatthias@gmail.com>
+mattip <matti.picus@gmail.com>
+Maxim Kurnikov <maxim.kurnikov@gmail.com>
+Maxime Rouyrre <rouyrre+git@gmail.com>
+mayeut <mayeut@users.noreply.github.com>
+mbaluna <44498973+mbaluna@users.noreply.github.com>
+mdebi <17590103+mdebi@users.noreply.github.com>
+memoselyk <memoselyk@gmail.com>
+Michael <michael-k@users.noreply.github.com>
+Michael Aquilina <michaelaquilina@gmail.com>
+Michael E. Karpeles <michael.karpeles@gmail.com>
+Michael Klich <michal@michalklich.com>
+Michael Williamson <mike@zwobble.org>
+michaelpacer <michaelpacer@gmail.com>
+Mickaël Schoentgen <mschoentgen@nuxeo.com>
+Miguel Araujo Perez <miguel.araujo.perez@gmail.com>
+Mihir Singh <git.service@mihirsingh.com>
+Mike <mikeh@blur.com>
+Mike Hendricks <mikeh@blur.com>
+Min RK <benjaminrk@gmail.com>
+MinRK <benjaminrk@gmail.com>
+Miro Hrončok <miro@hroncok.cz>
+Monica Baluna <mbaluna@bloomberg.net>
+montefra <franz.bergesund@gmail.com>
+Monty Taylor <mordred@inaugust.com>
+Nate Coraor <nate@bx.psu.edu>
+Nathaniel J. Smith <njs@pobox.com>
+Nehal J Wani <nehaljw.kkd1@gmail.com>
+Neil Botelho <neil.botelho321@gmail.com>
+Nick Coghlan <ncoghlan@gmail.com>
+Nick Stenning <nick@whiteink.com>
+Nick Timkovich <prometheus235@gmail.com>
+Nicolas Bock <nicolasbock@gmail.com>
+Nikhil Benesch <nikhil.benesch@gmail.com>
+Nitesh Sharma <nbsharma@outlook.com>
+Nowell Strite <nowell@strite.org>
+NtaleGrey <Shadikntale@gmail.com>
+nvdv <modestdev@gmail.com>
+Ofekmeister <ofekmeister@gmail.com>
+ofrinevo <ofrine@gmail.com>
+Oliver Jeeves <oliver.jeeves@ocado.com>
+Oliver Tonnhofer <olt@bogosoft.com>
+Olivier Girardot <ssaboum@gmail.com>
+Olivier Grisel <olivier.grisel@ensta.org>
+Ollie Rutherfurd <orutherfurd@gmail.com>
+OMOTO Kenji <k-omoto@m3.com>
+Omry Yadan <omry@fb.com>
+Oren Held <orenhe@il.ibm.com>
+Oscar Benjamin <oscar.j.benjamin@gmail.com>
+Oz N Tiram <oz.tiram@gmail.com>
+Pachwenko <32424503+Pachwenko@users.noreply.github.com>
+Patrick Dubroy <pdubroy@gmail.com>
+Patrick Jenkins <patrick@socialgrowthtechnologies.com>
+Patrick Lawson <pl@foursquare.com>
+patricktokeeffe <patricktokeeffe@users.noreply.github.com>
+Patrik Kopkan <pkopkan@redhat.com>
+Paul Kehrer <paul.l.kehrer@gmail.com>
+Paul Moore <p.f.moore@gmail.com>
+Paul Nasrat <pnasrat@gmail.com>
+Paul Oswald <pauloswald@gmail.com>
+Paul van der Linden <mail@paultjuh.org>
+Paulus Schoutsen <paulus@paulusschoutsen.nl>
+Pavithra Eswaramoorthy <33131404+QueenCoffee@users.noreply.github.com>
+Pawel Jasinski <pawel.jasinski@gmail.com>
+Pekka Klärck <peke@iki.fi>
+Peter Lisák <peter.lisak@showmax.com>
+Peter Waller <peter.waller@gmail.com>
+petr-tik <petr-tik@users.noreply.github.com>
+Phaneendra Chiruvella <hi@pcx.io>
+Phil Freo <phil@philfreo.com>
+Phil Pennock <phil@pennock-tech.com>
+Phil Whelan <phil123@gmail.com>
+Philip Jägenstedt <philip@foolip.org>
+Philip Molloy <pamolloy@users.noreply.github.com>
+Philippe Ombredanne <pombredanne@gmail.com>
+Pi Delport <pjdelport@gmail.com>
+Pierre-Yves Rofes <github@rofes.fr>
+pip <pypa-dev@googlegroups.com>
+Prabakaran Kumaresshan <k_prabakaran+github@hotmail.com>
+Prabhjyotsing Surjit Singh Sodhi <psinghsodhi@bloomberg.net>
+Prabhu Marappan <prabhum.794@gmail.com>
+Pradyun Gedam <pradyunsg@gmail.com>
+Pratik Mallya <mallya@us.ibm.com>
+Preet Thakkar <preet.thakkar@students.iiit.ac.in>
+Preston Holmes <preston@ptone.com>
+Przemek Wrzos <hetmankp@none>
+Pulkit Goyal <7895pulkit@gmail.com>
+Qiangning Hong <hongqn@gmail.com>
+Quentin Pradet <quentin.pradet@gmail.com>
+R. David Murray <rdmurray@bitdance.com>
+Rafael Caricio <rafael.jacinto@gmail.com>
+Ralf Schmitt <ralf@systemexit.de>
+Razzi Abuissa <razzi53@gmail.com>
+rdb <rdb@users.noreply.github.com>
+Remi Rampin <r@remirampin.com>
+Remi Rampin <remirampin@gmail.com>
+Rene Dudfield <renesd@gmail.com>
+Riccardo Magliocchetti <riccardo.magliocchetti@gmail.com>
+Richard Jones <r1chardj0n3s@gmail.com>
+RobberPhex <robberphex@gmail.com>
+Robert Collins <rbtcollins@hp.com>
+Robert McGibbon <rmcgibbo@gmail.com>
+Robert T. McGibbon <rmcgibbo@gmail.com>
+robin elisha robinson <elisha.rob@gmail.com>
+Roey Berman <roey.berman@gmail.com>
+Rohan Jain <crodjer@gmail.com>
+Rohan Jain <crodjer@users.noreply.github.com>
+Rohan Jain <mail@rohanjain.in>
+Roman Bogorodskiy <roman.bogorodskiy@ericsson.com>
+Romuald Brunet <romuald@chivil.com>
+Ronny Pfannschmidt <Ronny.Pfannschmidt@gmx.de>
+Rory McCann <rory@technomancy.org>
+Ross Brattain <ross.b.brattain@intel.com>
+Roy Wellington Ⅳ <cactus_hugged@yahoo.com>
+Roy Wellington Ⅳ <roy@mybasis.com>
+Ryan Wooden <rygwdn@gmail.com>
+ryneeverett <ryneeverett@gmail.com>
+Sachi King <nakato@nakato.io>
+Salvatore Rinchiera <salvatore@rinchiera.com>
+Savio Jomton <sajo240519@gmail.com>
+schlamar <marc.schlaich@gmail.com>
+Scott Kitterman <sklist@kitterman.com>
+Sean <me@sean.taipei>
+seanj <seanj@xyke.com>
+Sebastian Jordan <sebastian.jordan.mail@googlemail.com>
+Sebastian Schaetz <sschaetz@butterflynetinc.com>
+Segev Finer <segev208@gmail.com>
+SeongSoo Cho <ppiyakk2@printf.kr>
+Sergey Vasilyev <nolar@nolar.info>
+Seth Woodworth <seth@sethish.com>
+Shlomi Fish <shlomif@shlomifish.org>
+Shovan Maity <shovan.maity@mayadata.io>
+Simeon Visser <svisser@users.noreply.github.com>
+Simon Cross <hodgestar@gmail.com>
+Simon Pichugin <simon.pichugin@gmail.com>
+sinoroc <sinoroc.code+git@gmail.com>
+Sorin Sbarnea <sorin.sbarnea@gmail.com>
+Stavros Korokithakis <stavros@korokithakis.net>
+Stefan Scherfke <stefan@sofa-rockers.org>
+Stephan Erb <github@stephanerb.eu>
+stepshal <nessento@openmailbox.org>
+Steve (Gadget) Barnes <gadgetsteve@hotmail.com>
+Steve Barnes <gadgetsteve@hotmail.com>
+Steve Dower <steve.dower@microsoft.com>
+Steve Kowalik <steven@wedontsleep.org>
+Steven Myint <git@stevenmyint.com>
+stonebig <stonebig34@gmail.com>
+Stéphane Bidoul (ACSONE) <stephane.bidoul@acsone.eu>
+Stéphane Bidoul <stephane.bidoul@acsone.eu>
+Stéphane Klein <contact@stephane-klein.info>
+Sumana Harihareswara <sh@changeset.nyc>
+Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
+Sviatoslav Sydorenko <wk@sydorenko.org.ua>
+Swat009 <swatantra.kumar8@gmail.com>
+Takayuki SHIMIZUKAWA <shimizukawa@gmail.com>
+tbeswick <tbeswick@enphaseenergy.com>
+Thijs Triemstra <info@collab.nl>
+Thomas Fenzl <thomas.fenzl@gmail.com>
+Thomas Grainger <tagrain@gmail.com>
+Thomas Guettler <tguettler@tbz-pariv.de>
+Thomas Johansson <devnull@localhost>
+Thomas Kluyver <thomas@kluyver.me.uk>
+Thomas Smith <smithtg@ncbi.nlm.nih.gov>
+Tim D. Smith <github@tim-smith.us>
+Tim Gates <tim.gates@iress.com>
+Tim Harder <radhermit@gmail.com>
+Tim Heap <tim@timheap.me>
+tim smith <github@tim-smith.us>
+tinruufu <tinruufu@gmail.com>
+Tom Forbes <tom@tomforb.es>
+Tom Freudenheim <tom.freudenheim@onepeloton.com>
+Tom V <tom@viner.tv>
+Tomas Orsava <torsava@redhat.com>
+Tomer Chachamu <tomer.chachamu@gmail.com>
+Tony Beswick <tonybeswick@orcon.net.nz>
+Tony Zhaocheng Tan <tony@tonytan.io>
+TonyBeswick <TonyBeswick@users.noreply.github.com>
+toonarmycaptain <toonarmycaptain@hotmail.com>
+Toshio Kuratomi <toshio@fedoraproject.org>
+Travis Swicegood <development@domain51.com>
+Tzu-ping Chung <uranusjr@gmail.com>
+Valentin Haenel <valentin.haenel@gmx.de>
+Victor Stinner <victor.stinner@gmail.com>
+victorvpaulo <victorvpaulo@gmail.com>
+Viktor Szépe <viktor@szepe.net>
+Ville Skyttä <ville.skytta@iki.fi>
+Vinay Sajip <vinay_sajip@yahoo.co.uk>
+Vincent Philippon <sindaewoh@gmail.com>
+Vinicyus Macedo <7549205+vinicyusmacedo@users.noreply.github.com>
+Vitaly Babiy <vbabiy86@gmail.com>
+Vladimir Rutsky <rutsky@users.noreply.github.com>
+W. Trevor King <wking@drexel.edu>
+Wil Tan <wil@dready.org>
+Wilfred Hughes <me@wilfred.me.uk>
+William ML Leslie <william.leslie.ttg@gmail.com>
+William T Olson <trevor@heytrevor.com>
+Wilson Mo <wilsonfv@126.com>
+wim glenn <wim.glenn@gmail.com>
+Wolfgang Maier <wolfgang.maier@biologie.uni-freiburg.de>
+Xavier Fernandez <xav.fernandez@gmail.com>
+Xavier Fernandez <xavier.fernandez@polyconseil.fr>
+xoviat <xoviat@users.noreply.github.com>
+xtreak <tir.karthi@gmail.com>
+YAMAMOTO Takashi <yamamoto@midokura.com>
+Yen Chi Hsuan <yan12125@gmail.com>
+Yeray Diaz Diaz <yeraydiazdiaz@gmail.com>
+Yoval P <yoval@gmx.com>
+Yu Jian <askingyj@gmail.com>
+Yuan Jing Vincent Yan <yyan82@bloomberg.net>
+Zearin <zearin@gonk.net>
+Zearin <Zearin@users.noreply.github.com>
+Zhiping Deng <kofreestyler@gmail.com>
+Zvezdan Petkovic <zpetkovic@acm.org>
+Łukasz Langa <lukasz@langa.pl>
+Семён Марьясин <simeon@maryasin.name>
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..737fec5c5352af3d9a6a47a0670da4bdb52c5725
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/LICENSE.txt
@@ -0,0 +1,20 @@
+Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..49c88b125d1ef2989b233e6250cf58d93f3051fa
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/METADATA
@@ -0,0 +1,66 @@
+Metadata-Version: 2.1
+Name: wheel
+Version: 0.34.2
+Summary: A built-package format for Python
+Home-page: https://github.com/pypa/wheel
+Author: Daniel Holth
+Author-email: dholth@fastmail.fm
+Maintainer: Alex Grönholm
+Maintainer-email: alex.gronholm@nextday.fi
+License: MIT
+Project-URL: Documentation, https://wheel.readthedocs.io/
+Project-URL: Changelog, https://wheel.readthedocs.io/en/stable/news.html
+Project-URL: Issue Tracker, https://github.com/pypa/wheel/issues
+Keywords: wheel,packaging
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: System :: Archiving :: Packaging
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7
+Provides-Extra: test
+Requires-Dist: pytest-cov ; extra == 'test'
+Requires-Dist: pytest (>=3.0.0) ; extra == 'test'
+
+wheel
+=====
+
+This library is the reference implementation of the Python wheel packaging
+standard, as defined in `PEP 427`_.
+
+It has two different roles:
+
+#. A setuptools_ extension for building wheels that provides the
+   ``bdist_wheel`` setuptools command
+#. A command line tool for working with wheel files
+
+It should be noted that wheel is **not** intended to be used as a library, and
+as such there is no stable, public API.
+
+.. _PEP 427: https://www.python.org/dev/peps/pep-0427/
+.. _setuptools: https://pypi.org/project/setuptools/
+
+Documentation
+-------------
+
+The documentation_ can be found on Read The Docs.
+
+.. _documentation: https://wheel.readthedocs.io/
+
+Code of Conduct
+---------------
+
+Everyone interacting in the wheel project's codebases, issue trackers, chat
+rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.
+
+.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/
+
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..90614be9fdea0ecef9ae622fb5d6215414d3473d
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/RECORD
@@ -0,0 +1,43 @@
+wheel/__init__.py,sha256=HnvQS9U0JqVi8rcO-9DbcHRmVtnblu7VwdzoKbMiZDQ,23
+wheel/__main__.py,sha256=lF-YLO4hdQmoWuh4eWZd8YL1U95RSdm76sNLBXa0vjE,417
+wheel/_version.py,sha256=KiDEywHVTrXNxe6ojGe-7gEm6gUYge5r_fThX1den7Y,133
+wheel/bdist_wheel.py,sha256=fgVFnJ2cC3MkU5Wy0nNLCzbJoGorSzSrzM9PFq4HWj0,15840
+wheel/macosx_libfile.py,sha256=NhNz1C3zF_78iMUd4ij0le1jVJNnz93tCAICSKXgYvg,11858
+wheel/metadata.py,sha256=siS-hs_DTT0ScpbzloYbQSGYXUDC_Tim10ixcYWSM-4,4517
+wheel/pep425tags.py,sha256=tuXvpyhYJHDcsXHgSRonny1X3kG3TSn7CN9nL9tZUMA,9071
+wheel/pkginfo.py,sha256=GR76kupQzn1x9sKDaXuE6B6FsZ4OkfRtG7pndlXPvQ4,1257
+wheel/util.py,sha256=mnNZkJCi9DHLI_q4lTudoD0mW97h_AoAWl7prNPLXJc,938
+wheel/wheelfile.py,sha256=WsWfD-OBgHxxeF7SxRi3OX6l_qxtP06b2ZK0NVhT_n0,7298
+wheel/cli/__init__.py,sha256=GWSoGUpRabTf8bk3FsNTPrc5Fsr8YOv2dX55iY2W7eY,2572
+wheel/cli/convert.py,sha256=7F4vj23A2OghDDWn9gX2V-_TeXMza1a5nIejmFGEUJM,9498
+wheel/cli/pack.py,sha256=S-J1iIy1GPDTTDdn-_SwxGa7N729h4iZNI11EDFCqfA,3208
+wheel/cli/unpack.py,sha256=0VWzT7U_xyenTPwEVavxqvdee93GPvAFHnR3Uu91aRc,673
+wheel-0.34.2.dist-info/AUTHORS.txt,sha256=RtqU9KfonVGhI48DAA4-yTOBUhBtQTjFhaDzHoyh7uU,21518
+wheel-0.34.2.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
+wheel-0.34.2.dist-info/METADATA,sha256=Zh9PzJB14h0gUthWq4ghxft8PJiybKKBjvyikMapY_k,2214
+wheel-0.34.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+wheel-0.34.2.dist-info/entry_points.txt,sha256=N8HbYFST3yrNQYeB2wXWBEPUhFsEtKNRPaCFGJPyqyc,108
+wheel-0.34.2.dist-info/top_level.txt,sha256=HxSBIbgEstMPe4eFawhA66Mq-QYHMopXVoAncfjb_1c,6
+wheel-0.34.2.dist-info/RECORD,,
+wheel/cli/__pycache__,,
+wheel/macosx_libfile.cpython-38.pyc,,
+wheel/__pycache__,,
+wheel-0.34.2.dist-info/__pycache__,,
+wheel/pep425tags.cpython-38.pyc,,
+../../../bin/wheel3,,
+wheel/util.cpython-38.pyc,,
+wheel/__main__.cpython-38.pyc,,
+../../../bin/wheel-3.8,,
+wheel/_version.cpython-38.pyc,,
+wheel/pkginfo.cpython-38.pyc,,
+wheel/cli/unpack.cpython-38.pyc,,
+wheel/bdist_wheel.cpython-38.pyc,,
+wheel/cli/convert.cpython-38.pyc,,
+wheel/cli/pack.cpython-38.pyc,,
+wheel-0.34.2.dist-info/INSTALLER,,
+wheel/cli/__init__.cpython-38.pyc,,
+wheel/wheelfile.cpython-38.pyc,,
+wheel/__init__.cpython-38.pyc,,
+wheel/metadata.cpython-38.pyc,,
+wheel-0.34.2.virtualenv,,
+../../../bin/wheel,,
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b27acaddfde8258ee5b9eb70963ff108041bd998
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/entry_points.txt
@@ -0,0 +1,6 @@
+[console_scripts]
+wheel = wheel.cli:main
+
+[distutils.commands]
+bdist_wheel = wheel.bdist_wheel:bdist_wheel
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2309722a93d261ba6840e2a1d18a96ac5b71f7b8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+wheel
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.virtualenv b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel-0.34.2.virtualenv
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..3c92ca223a422413939fe64a1f1a460021b69c64
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__init__.py
@@ -0,0 +1 @@
+__version__ = '0.34.2'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__main__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b3773a20e08b985d4160b624fbfe1742f35472cd
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/__main__.py
@@ -0,0 +1,19 @@
+"""
+Wheel command line tool (enable python -m wheel syntax)
+"""
+
+import sys
+
+
+def main():  # needed for console script
+    if __package__ == '':
+        # To be able to run 'python wheel-0.9.whl/wheel':
+        import os.path
+        path = os.path.dirname(os.path.dirname(__file__))
+        sys.path[0:0] = [path]
+    import wheel.cli
+    sys.exit(wheel.cli.main())
+
+
+if __name__ == "__main__":
+    sys.exit(main())
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/_version.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/_version.py
new file mode 100644
index 0000000000000000000000000000000000000000..5f581f72ae171130492a53981edab2ad0e872ad8
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/_version.py
@@ -0,0 +1,4 @@
+# coding: utf-8
+# file generated by setuptools_scm
+# don't change, don't track in version control
+version = '0.33.6.post32+gd3d7a43'
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py
new file mode 100644
index 0000000000000000000000000000000000000000..5cece1f2a25df012fe3beccea0c27d043b5e0f0c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/bdist_wheel.py
@@ -0,0 +1,403 @@
+"""
+Create a wheel (.whl) distribution.
+
+A wheel is a built archive format.
+"""
+
+import os
+import shutil
+import stat
+import sys
+import re
+from collections import OrderedDict
+from email.generator import Generator
+from distutils.core import Command
+from distutils.sysconfig import get_python_version
+from distutils import log as logger
+from glob import iglob
+from shutil import rmtree
+from warnings import warn
+from zipfile import ZIP_DEFLATED, ZIP_STORED
+
+import pkg_resources
+
+from .pep425tags import get_abbr_impl, get_impl_ver, get_abi_tag, get_platform
+from .pkginfo import write_pkg_info
+from .metadata import pkginfo_to_metadata
+from .wheelfile import WheelFile
+from . import pep425tags
+from . import __version__ as wheel_version
+
+
+safe_name = pkg_resources.safe_name
+safe_version = pkg_resources.safe_version
+
+PY_LIMITED_API_PATTERN = r'cp3\d'
+
+
+def safer_name(name):
+    return safe_name(name).replace('-', '_')
+
+
+def safer_version(version):
+    return safe_version(version).replace('-', '_')
+
+
+def remove_readonly(func, path, excinfo):
+    print(str(excinfo[1]))
+    os.chmod(path, stat.S_IWRITE)
+    func(path)
+
+
+class bdist_wheel(Command):
+
+    description = 'create a wheel distribution'
+
+    supported_compressions = OrderedDict([
+        ('stored', ZIP_STORED),
+        ('deflated', ZIP_DEFLATED)
+    ])
+
+    user_options = [('bdist-dir=', 'b',
+                     "temporary directory for creating the distribution"),
+                    ('plat-name=', 'p',
+                     "platform name to embed in generated filenames "
+                     "(default: %s)" % get_platform(None)),
+                    ('keep-temp', 'k',
+                     "keep the pseudo-installation tree around after " +
+                     "creating the distribution archive"),
+                    ('dist-dir=', 'd',
+                     "directory to put final built distributions in"),
+                    ('skip-build', None,
+                     "skip rebuilding everything (for testing/debugging)"),
+                    ('relative', None,
+                     "build the archive using relative paths "
+                     "(default: false)"),
+                    ('owner=', 'u',
+                     "Owner name used when creating a tar file"
+                     " [default: current user]"),
+                    ('group=', 'g',
+                     "Group name used when creating a tar file"
+                     " [default: current group]"),
+                    ('universal', None,
+                     "make a universal wheel"
+                     " (default: false)"),
+                    ('compression=', None,
+                     "zipfile compression (one of: {})"
+                     " (default: 'deflated')"
+                     .format(', '.join(supported_compressions))),
+                    ('python-tag=', None,
+                     "Python implementation compatibility tag"
+                     " (default: py%s)" % get_impl_ver()[0]),
+                    ('build-number=', None,
+                     "Build number for this particular version. "
+                     "As specified in PEP-0427, this must start with a digit. "
+                     "[default: None]"),
+                    ('py-limited-api=', None,
+                     "Python tag (cp32|cp33|cpNN) for abi3 wheel tag"
+                     " (default: false)"),
+                    ]
+
+    boolean_options = ['keep-temp', 'skip-build', 'relative', 'universal']
+
+    def initialize_options(self):
+        self.bdist_dir = None
+        self.data_dir = None
+        self.plat_name = None
+        self.plat_tag = None
+        self.format = 'zip'
+        self.keep_temp = False
+        self.dist_dir = None
+        self.egginfo_dir = None
+        self.root_is_pure = None
+        self.skip_build = None
+        self.relative = False
+        self.owner = None
+        self.group = None
+        self.universal = False
+        self.compression = 'deflated'
+        self.python_tag = 'py' + get_impl_ver()[0]
+        self.build_number = None
+        self.py_limited_api = False
+        self.plat_name_supplied = False
+
+    def finalize_options(self):
+        if self.bdist_dir is None:
+            bdist_base = self.get_finalized_command('bdist').bdist_base
+            self.bdist_dir = os.path.join(bdist_base, 'wheel')
+
+        self.data_dir = self.wheel_dist_name + '.data'
+        self.plat_name_supplied = self.plat_name is not None
+
+        try:
+            self.compression = self.supported_compressions[self.compression]
+        except KeyError:
+            raise ValueError('Unsupported compression: {}'.format(self.compression))
+
+        need_options = ('dist_dir', 'plat_name', 'skip_build')
+
+        self.set_undefined_options('bdist',
+                                   *zip(need_options, need_options))
+
+        self.root_is_pure = not (self.distribution.has_ext_modules()
+                                 or self.distribution.has_c_libraries())
+
+        if self.py_limited_api and not re.match(PY_LIMITED_API_PATTERN, self.py_limited_api):
+            raise ValueError("py-limited-api must match '%s'" % PY_LIMITED_API_PATTERN)
+
+        # Support legacy [wheel] section for setting universal
+        wheel = self.distribution.get_option_dict('wheel')
+        if 'universal' in wheel:
+            # please don't define this in your global configs
+            logger.warn('The [wheel] section is deprecated. Use [bdist_wheel] instead.')
+            val = wheel['universal'][1].strip()
+            if val.lower() in ('1', 'true', 'yes'):
+                self.universal = True
+
+        if self.build_number is not None and not self.build_number[:1].isdigit():
+            raise ValueError("Build tag (build-number) must start with a digit.")
+
+    @property
+    def wheel_dist_name(self):
+        """Return distribution full name with - replaced with _"""
+        components = (safer_name(self.distribution.get_name()),
+                      safer_version(self.distribution.get_version()))
+        if self.build_number:
+            components += (self.build_number,)
+        return '-'.join(components)
+
+    def get_tag(self):
+        # bdist sets self.plat_name if unset, we should only use it for purepy
+        # wheels if the user supplied it.
+        if self.plat_name_supplied:
+            plat_name = self.plat_name
+        elif self.root_is_pure:
+            plat_name = 'any'
+        else:
+            # macosx contains system version in platform name so need special handle
+            if self.plat_name and not self.plat_name.startswith("macosx"):
+                plat_name = self.plat_name
+            else:
+                plat_name = get_platform(self.bdist_dir)
+
+            if plat_name in ('linux-x86_64', 'linux_x86_64') and sys.maxsize == 2147483647:
+                plat_name = 'linux_i686'
+
+        plat_name = plat_name.replace('-', '_').replace('.', '_')
+
+        if self.root_is_pure:
+            if self.universal:
+                impl = 'py2.py3'
+            else:
+                impl = self.python_tag
+            tag = (impl, 'none', plat_name)
+        else:
+            impl_name = get_abbr_impl()
+            impl_ver = get_impl_ver()
+            impl = impl_name + impl_ver
+            # We don't work on CPython 3.1, 3.0.
+            if self.py_limited_api and (impl_name + impl_ver).startswith('cp3'):
+                impl = self.py_limited_api
+                abi_tag = 'abi3'
+            else:
+                abi_tag = str(get_abi_tag()).lower()
+            tag = (impl, abi_tag, plat_name)
+            supported_tags = pep425tags.get_supported(
+                self.bdist_dir,
+                supplied_platform=plat_name if self.plat_name_supplied else None)
+            # XXX switch to this alternate implementation for non-pure:
+            if not self.py_limited_api:
+                assert tag == supported_tags[0], "%s != %s" % (tag, supported_tags[0])
+            assert tag in supported_tags, "would build wheel with unsupported tag {}".format(tag)
+        return tag
+
+    def run(self):
+        build_scripts = self.reinitialize_command('build_scripts')
+        build_scripts.executable = 'python'
+        build_scripts.force = True
+
+        build_ext = self.reinitialize_command('build_ext')
+        build_ext.inplace = False
+
+        if not self.skip_build:
+            self.run_command('build')
+
+        install = self.reinitialize_command('install',
+                                            reinit_subcommands=True)
+        install.root = self.bdist_dir
+        install.compile = False
+        install.skip_build = self.skip_build
+        install.warn_dir = False
+
+        # A wheel without setuptools scripts is more cross-platform.
+        # Use the (undocumented) `no_ep` option to setuptools'
+        # install_scripts command to avoid creating entry point scripts.
+        install_scripts = self.reinitialize_command('install_scripts')
+        install_scripts.no_ep = True
+
+        # Use a custom scheme for the archive, because we have to decide
+        # at installation time which scheme to use.
+        for key in ('headers', 'scripts', 'data', 'purelib', 'platlib'):
+            setattr(install,
+                    'install_' + key,
+                    os.path.join(self.data_dir, key))
+
+        basedir_observed = ''
+
+        if os.name == 'nt':
+            # win32 barfs if any of these are ''; could be '.'?
+            # (distutils.command.install:change_roots bug)
+            basedir_observed = os.path.normpath(os.path.join(self.data_dir, '..'))
+            self.install_libbase = self.install_lib = basedir_observed
+
+        setattr(install,
+                'install_purelib' if self.root_is_pure else 'install_platlib',
+                basedir_observed)
+
+        logger.info("installing to %s", self.bdist_dir)
+
+        self.run_command('install')
+
+        impl_tag, abi_tag, plat_tag = self.get_tag()
+        archive_basename = "{}-{}-{}-{}".format(self.wheel_dist_name, impl_tag, abi_tag, plat_tag)
+        if not self.relative:
+            archive_root = self.bdist_dir
+        else:
+            archive_root = os.path.join(
+                self.bdist_dir,
+                self._ensure_relative(install.install_base))
+
+        self.set_undefined_options('install_egg_info', ('target', 'egginfo_dir'))
+        distinfo_dirname = '{}-{}.dist-info'.format(
+            safer_name(self.distribution.get_name()),
+            safer_version(self.distribution.get_version()))
+        distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname)
+        self.egg2dist(self.egginfo_dir, distinfo_dir)
+
+        self.write_wheelfile(distinfo_dir)
+
+        # Make the archive
+        if not os.path.exists(self.dist_dir):
+            os.makedirs(self.dist_dir)
+
+        wheel_path = os.path.join(self.dist_dir, archive_basename + '.whl')
+        with WheelFile(wheel_path, 'w', self.compression) as wf:
+            wf.write_files(archive_root)
+
+        # Add to 'Distribution.dist_files' so that the "upload" command works
+        getattr(self.distribution, 'dist_files', []).append(
+            ('bdist_wheel', get_python_version(), wheel_path))
+
+        if not self.keep_temp:
+            logger.info('removing %s', self.bdist_dir)
+            if not self.dry_run:
+                rmtree(self.bdist_dir, onerror=remove_readonly)
+
+    def write_wheelfile(self, wheelfile_base, generator='bdist_wheel (' + wheel_version + ')'):
+        from email.message import Message
+        msg = Message()
+        msg['Wheel-Version'] = '1.0'  # of the spec
+        msg['Generator'] = generator
+        msg['Root-Is-Purelib'] = str(self.root_is_pure).lower()
+        if self.build_number is not None:
+            msg['Build'] = self.build_number
+
+        # Doesn't work for bdist_wininst
+        impl_tag, abi_tag, plat_tag = self.get_tag()
+        for impl in impl_tag.split('.'):
+            for abi in abi_tag.split('.'):
+                for plat in plat_tag.split('.'):
+                    msg['Tag'] = '-'.join((impl, abi, plat))
+
+        wheelfile_path = os.path.join(wheelfile_base, 'WHEEL')
+        logger.info('creating %s', wheelfile_path)
+        with open(wheelfile_path, 'w') as f:
+            Generator(f, maxheaderlen=0).flatten(msg)
+
+    def _ensure_relative(self, path):
+        # copied from dir_util, deleted
+        drive, path = os.path.splitdrive(path)
+        if path[0:1] == os.sep:
+            path = drive + path[1:]
+        return path
+
+    @property
+    def license_paths(self):
+        metadata = self.distribution.get_option_dict('metadata')
+        files = set()
+        patterns = sorted({
+            option for option in metadata.get('license_files', ('', ''))[1].split()
+        })
+
+        if 'license_file' in metadata:
+            warn('The "license_file" option is deprecated. Use "license_files" instead.',
+                 DeprecationWarning)
+            files.add(metadata['license_file'][1])
+
+        if 'license_file' not in metadata and 'license_files' not in metadata:
+            patterns = ('LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*')
+
+        for pattern in patterns:
+            for path in iglob(pattern):
+                if path not in files and os.path.isfile(path):
+                    logger.info('adding license file "%s" (matched pattern "%s")', path, pattern)
+                    files.add(path)
+
+        return files
+
+    def egg2dist(self, egginfo_path, distinfo_path):
+        """Convert an .egg-info directory into a .dist-info directory"""
+        def adios(p):
+            """Appropriately delete directory, file or link."""
+            if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p):
+                shutil.rmtree(p)
+            elif os.path.exists(p):
+                os.unlink(p)
+
+        adios(distinfo_path)
+
+        if not os.path.exists(egginfo_path):
+            # There is no egg-info. This is probably because the egg-info
+            # file/directory is not named matching the distribution name used
+            # to name the archive file. Check for this case and report
+            # accordingly.
+            import glob
+            pat = os.path.join(os.path.dirname(egginfo_path), '*.egg-info')
+            possible = glob.glob(pat)
+            err = "Egg metadata expected at %s but not found" % (egginfo_path,)
+            if possible:
+                alt = os.path.basename(possible[0])
+                err += " (%s found - possible misnamed archive file?)" % (alt,)
+
+            raise ValueError(err)
+
+        if os.path.isfile(egginfo_path):
+            # .egg-info is a single file
+            pkginfo_path = egginfo_path
+            pkg_info = pkginfo_to_metadata(egginfo_path, egginfo_path)
+            os.mkdir(distinfo_path)
+        else:
+            # .egg-info is a directory
+            pkginfo_path = os.path.join(egginfo_path, 'PKG-INFO')
+            pkg_info = pkginfo_to_metadata(egginfo_path, pkginfo_path)
+
+            # ignore common egg metadata that is useless to wheel
+            shutil.copytree(egginfo_path, distinfo_path,
+                            ignore=lambda x, y: {'PKG-INFO', 'requires.txt', 'SOURCES.txt',
+                                                 'not-zip-safe'}
+                            )
+
+            # delete dependency_links if it is only whitespace
+            dependency_links_path = os.path.join(distinfo_path, 'dependency_links.txt')
+            with open(dependency_links_path, 'r') as dependency_links_file:
+                dependency_links = dependency_links_file.read().strip()
+            if not dependency_links:
+                adios(dependency_links_path)
+
+        write_pkg_info(os.path.join(distinfo_path, 'METADATA'), pkg_info)
+
+        for license_path in self.license_paths:
+            filename = os.path.basename(license_path)
+            shutil.copy(license_path, os.path.join(distinfo_path, filename))
+
+        adios(egginfo_path)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..95740bfb650514f6b17005b4bc8220858ebdfdf4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/__init__.py
@@ -0,0 +1,88 @@
+"""
+Wheel command-line utility.
+"""
+
+from __future__ import print_function
+
+import argparse
+import os
+import sys
+
+
+def require_pkgresources(name):
+    try:
+        import pkg_resources  # noqa: F401
+    except ImportError:
+        raise RuntimeError("'{0}' needs pkg_resources (part of setuptools).".format(name))
+
+
+class WheelError(Exception):
+    pass
+
+
+def unpack_f(args):
+    from .unpack import unpack
+    unpack(args.wheelfile, args.dest)
+
+
+def pack_f(args):
+    from .pack import pack
+    pack(args.directory, args.dest_dir, args.build_number)
+
+
+def convert_f(args):
+    from .convert import convert
+    convert(args.files, args.dest_dir, args.verbose)
+
+
+def version_f(args):
+    from .. import __version__
+    print("wheel %s" % __version__)
+
+
+def parser():
+    p = argparse.ArgumentParser()
+    s = p.add_subparsers(help="commands")
+
+    unpack_parser = s.add_parser('unpack', help='Unpack wheel')
+    unpack_parser.add_argument('--dest', '-d', help='Destination directory',
+                               default='.')
+    unpack_parser.add_argument('wheelfile', help='Wheel file')
+    unpack_parser.set_defaults(func=unpack_f)
+
+    repack_parser = s.add_parser('pack', help='Repack wheel')
+    repack_parser.add_argument('directory', help='Root directory of the unpacked wheel')
+    repack_parser.add_argument('--dest-dir', '-d', default=os.path.curdir,
+                               help="Directory to store the wheel (default %(default)s)")
+    repack_parser.add_argument('--build-number', help="Build tag to use in the wheel name")
+    repack_parser.set_defaults(func=pack_f)
+
+    convert_parser = s.add_parser('convert', help='Convert egg or wininst to wheel')
+    convert_parser.add_argument('files', nargs='*', help='Files to convert')
+    convert_parser.add_argument('--dest-dir', '-d', default=os.path.curdir,
+                                help="Directory to store wheels (default %(default)s)")
+    convert_parser.add_argument('--verbose', '-v', action='store_true')
+    convert_parser.set_defaults(func=convert_f)
+
+    version_parser = s.add_parser('version', help='Print version and exit')
+    version_parser.set_defaults(func=version_f)
+
+    help_parser = s.add_parser('help', help='Show this help')
+    help_parser.set_defaults(func=lambda args: p.print_help())
+
+    return p
+
+
+def main():
+    p = parser()
+    args = p.parse_args()
+    if not hasattr(args, 'func'):
+        p.print_help()
+    else:
+        try:
+            args.func(args)
+            return 0
+        except WheelError as e:
+            print(e, file=sys.stderr)
+
+    return 1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/convert.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/convert.py
new file mode 100644
index 0000000000000000000000000000000000000000..154f1b1e2a5b84ade4d44c9a5226b7979d21958b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/convert.py
@@ -0,0 +1,269 @@
+import os.path
+import re
+import shutil
+import sys
+import tempfile
+import zipfile
+from distutils import dist
+from glob import iglob
+
+from ..bdist_wheel import bdist_wheel
+from ..wheelfile import WheelFile
+from . import WheelError, require_pkgresources
+
+egg_info_re = re.compile(r'''
+    (?P<name>.+?)-(?P<ver>.+?)
+    (-(?P<pyver>py\d\.\d+)
+     (-(?P<arch>.+?))?
+    )?.egg$''', re.VERBOSE)
+
+
+class _bdist_wheel_tag(bdist_wheel):
+    # allow the client to override the default generated wheel tag
+    # The default bdist_wheel implementation uses python and abi tags
+    # of the running python process. This is not suitable for
+    # generating/repackaging prebuild binaries.
+
+    full_tag_supplied = False
+    full_tag = None  # None or a (pytag, soabitag, plattag) triple
+
+    def get_tag(self):
+        if self.full_tag_supplied and self.full_tag is not None:
+            return self.full_tag
+        else:
+            return bdist_wheel.get_tag(self)
+
+
+def egg2wheel(egg_path, dest_dir):
+    filename = os.path.basename(egg_path)
+    match = egg_info_re.match(filename)
+    if not match:
+        raise WheelError('Invalid egg file name: {}'.format(filename))
+
+    egg_info = match.groupdict()
+    dir = tempfile.mkdtemp(suffix="_e2w")
+    if os.path.isfile(egg_path):
+        # assume we have a bdist_egg otherwise
+        with zipfile.ZipFile(egg_path) as egg:
+            egg.extractall(dir)
+    else:
+        # support buildout-style installed eggs directories
+        for pth in os.listdir(egg_path):
+            src = os.path.join(egg_path, pth)
+            if os.path.isfile(src):
+                shutil.copy2(src, dir)
+            else:
+                shutil.copytree(src, os.path.join(dir, pth))
+
+    pyver = egg_info['pyver']
+    if pyver:
+        pyver = egg_info['pyver'] = pyver.replace('.', '')
+
+    arch = (egg_info['arch'] or 'any').replace('.', '_').replace('-', '_')
+
+    # assume all binary eggs are for CPython
+    abi = 'cp' + pyver[2:] if arch != 'any' else 'none'
+
+    root_is_purelib = egg_info['arch'] is None
+    if root_is_purelib:
+        bw = bdist_wheel(dist.Distribution())
+    else:
+        bw = _bdist_wheel_tag(dist.Distribution())
+
+    bw.root_is_pure = root_is_purelib
+    bw.python_tag = pyver
+    bw.plat_name_supplied = True
+    bw.plat_name = egg_info['arch'] or 'any'
+    if not root_is_purelib:
+        bw.full_tag_supplied = True
+        bw.full_tag = (pyver, abi, arch)
+
+    dist_info_dir = os.path.join(dir, '{name}-{ver}.dist-info'.format(**egg_info))
+    bw.egg2dist(os.path.join(dir, 'EGG-INFO'), dist_info_dir)
+    bw.write_wheelfile(dist_info_dir, generator='egg2wheel')
+    wheel_name = '{name}-{ver}-{pyver}-{}-{}.whl'.format(abi, arch, **egg_info)
+    with WheelFile(os.path.join(dest_dir, wheel_name), 'w') as wf:
+        wf.write_files(dir)
+
+    shutil.rmtree(dir)
+
+
+def parse_wininst_info(wininfo_name, egginfo_name):
+    """Extract metadata from filenames.
+
+    Extracts the 4 metadataitems needed (name, version, pyversion, arch) from
+    the installer filename and the name of the egg-info directory embedded in
+    the zipfile (if any).
+
+    The egginfo filename has the format::
+
+        name-ver(-pyver)(-arch).egg-info
+
+    The installer filename has the format::
+
+        name-ver.arch(-pyver).exe
+
+    Some things to note:
+
+    1. The installer filename is not definitive. An installer can be renamed
+       and work perfectly well as an installer. So more reliable data should
+       be used whenever possible.
+    2. The egg-info data should be preferred for the name and version, because
+       these come straight from the distutils metadata, and are mandatory.
+    3. The pyver from the egg-info data should be ignored, as it is
+       constructed from the version of Python used to build the installer,
+       which is irrelevant - the installer filename is correct here (even to
+       the point that when it's not there, any version is implied).
+    4. The architecture must be taken from the installer filename, as it is
+       not included in the egg-info data.
+    5. Architecture-neutral installers still have an architecture because the
+       installer format itself (being executable) is architecture-specific. We
+       should therefore ignore the architecture if the content is pure-python.
+    """
+
+    egginfo = None
+    if egginfo_name:
+        egginfo = egg_info_re.search(egginfo_name)
+        if not egginfo:
+            raise ValueError("Egg info filename %s is not valid" % (egginfo_name,))
+
+    # Parse the wininst filename
+    # 1. Distribution name (up to the first '-')
+    w_name, sep, rest = wininfo_name.partition('-')
+    if not sep:
+        raise ValueError("Installer filename %s is not valid" % (wininfo_name,))
+
+    # Strip '.exe'
+    rest = rest[:-4]
+    # 2. Python version (from the last '-', must start with 'py')
+    rest2, sep, w_pyver = rest.rpartition('-')
+    if sep and w_pyver.startswith('py'):
+        rest = rest2
+        w_pyver = w_pyver.replace('.', '')
+    else:
+        # Not version specific - use py2.py3. While it is possible that
+        # pure-Python code is not compatible with both Python 2 and 3, there
+        # is no way of knowing from the wininst format, so we assume the best
+        # here (the user can always manually rename the wheel to be more
+        # restrictive if needed).
+        w_pyver = 'py2.py3'
+    # 3. Version and architecture
+    w_ver, sep, w_arch = rest.rpartition('.')
+    if not sep:
+        raise ValueError("Installer filename %s is not valid" % (wininfo_name,))
+
+    if egginfo:
+        w_name = egginfo.group('name')
+        w_ver = egginfo.group('ver')
+
+    return {'name': w_name, 'ver': w_ver, 'arch': w_arch, 'pyver': w_pyver}
+
+
+def wininst2wheel(path, dest_dir):
+    with zipfile.ZipFile(path) as bdw:
+        # Search for egg-info in the archive
+        egginfo_name = None
+        for filename in bdw.namelist():
+            if '.egg-info' in filename:
+                egginfo_name = filename
+                break
+
+        info = parse_wininst_info(os.path.basename(path), egginfo_name)
+
+        root_is_purelib = True
+        for zipinfo in bdw.infolist():
+            if zipinfo.filename.startswith('PLATLIB'):
+                root_is_purelib = False
+                break
+        if root_is_purelib:
+            paths = {'purelib': ''}
+        else:
+            paths = {'platlib': ''}
+
+        dist_info = "%(name)s-%(ver)s" % info
+        datadir = "%s.data/" % dist_info
+
+        # rewrite paths to trick ZipFile into extracting an egg
+        # XXX grab wininst .ini - between .exe, padding, and first zip file.
+        members = []
+        egginfo_name = ''
+        for zipinfo in bdw.infolist():
+            key, basename = zipinfo.filename.split('/', 1)
+            key = key.lower()
+            basepath = paths.get(key, None)
+            if basepath is None:
+                basepath = datadir + key.lower() + '/'
+            oldname = zipinfo.filename
+            newname = basepath + basename
+            zipinfo.filename = newname
+            del bdw.NameToInfo[oldname]
+            bdw.NameToInfo[newname] = zipinfo
+            # Collect member names, but omit '' (from an entry like "PLATLIB/"
+            if newname:
+                members.append(newname)
+            # Remember egg-info name for the egg2dist call below
+            if not egginfo_name:
+                if newname.endswith('.egg-info'):
+                    egginfo_name = newname
+                elif '.egg-info/' in newname:
+                    egginfo_name, sep, _ = newname.rpartition('/')
+        dir = tempfile.mkdtemp(suffix="_b2w")
+        bdw.extractall(dir, members)
+
+    # egg2wheel
+    abi = 'none'
+    pyver = info['pyver']
+    arch = (info['arch'] or 'any').replace('.', '_').replace('-', '_')
+    # Wininst installers always have arch even if they are not
+    # architecture-specific (because the format itself is).
+    # So, assume the content is architecture-neutral if root is purelib.
+    if root_is_purelib:
+        arch = 'any'
+    # If the installer is architecture-specific, it's almost certainly also
+    # CPython-specific.
+    if arch != 'any':
+        pyver = pyver.replace('py', 'cp')
+    wheel_name = '-'.join((dist_info, pyver, abi, arch))
+    if root_is_purelib:
+        bw = bdist_wheel(dist.Distribution())
+    else:
+        bw = _bdist_wheel_tag(dist.Distribution())
+
+    bw.root_is_pure = root_is_purelib
+    bw.python_tag = pyver
+    bw.plat_name_supplied = True
+    bw.plat_name = info['arch'] or 'any'
+
+    if not root_is_purelib:
+        bw.full_tag_supplied = True
+        bw.full_tag = (pyver, abi, arch)
+
+    dist_info_dir = os.path.join(dir, '%s.dist-info' % dist_info)
+    bw.egg2dist(os.path.join(dir, egginfo_name), dist_info_dir)
+    bw.write_wheelfile(dist_info_dir, generator='wininst2wheel')
+
+    wheel_path = os.path.join(dest_dir, wheel_name)
+    with WheelFile(wheel_path, 'w') as wf:
+        wf.write_files(dir)
+
+    shutil.rmtree(dir)
+
+
+def convert(files, dest_dir, verbose):
+    # Only support wheel convert if pkg_resources is present
+    require_pkgresources('wheel convert')
+
+    for pat in files:
+        for installer in iglob(pat):
+            if os.path.splitext(installer)[1] == '.egg':
+                conv = egg2wheel
+            else:
+                conv = wininst2wheel
+
+            if verbose:
+                print("{}... ".format(installer))
+                sys.stdout.flush()
+
+            conv(installer, dest_dir)
+            if verbose:
+                print("OK")
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/pack.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/pack.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e77fdbd2ccfb17ce1ca65f1834ac1dc927f3047
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/pack.py
@@ -0,0 +1,79 @@
+from __future__ import print_function
+
+import os.path
+import re
+import sys
+
+from wheel.cli import WheelError
+from wheel.wheelfile import WheelFile
+
+DIST_INFO_RE = re.compile(r"^(?P<namever>(?P<name>.+?)-(?P<ver>\d.*?))\.dist-info$")
+BUILD_NUM_RE = re.compile(br'Build: (\d\w*)$')
+
+
+def pack(directory, dest_dir, build_number):
+    """Repack a previously unpacked wheel directory into a new wheel file.
+
+    The .dist-info/WHEEL file must contain one or more tags so that the target
+    wheel file name can be determined.
+
+    :param directory: The unpacked wheel directory
+    :param dest_dir: Destination directory (defaults to the current directory)
+    """
+    # Find the .dist-info directory
+    dist_info_dirs = [fn for fn in os.listdir(directory)
+                      if os.path.isdir(os.path.join(directory, fn)) and DIST_INFO_RE.match(fn)]
+    if len(dist_info_dirs) > 1:
+        raise WheelError('Multiple .dist-info directories found in {}'.format(directory))
+    elif not dist_info_dirs:
+        raise WheelError('No .dist-info directories found in {}'.format(directory))
+
+    # Determine the target wheel filename
+    dist_info_dir = dist_info_dirs[0]
+    name_version = DIST_INFO_RE.match(dist_info_dir).group('namever')
+
+    # Read the tags and the existing build number from .dist-info/WHEEL
+    existing_build_number = None
+    wheel_file_path = os.path.join(directory, dist_info_dir, 'WHEEL')
+    with open(wheel_file_path) as f:
+        tags = []
+        for line in f:
+            if line.startswith('Tag: '):
+                tags.append(line.split(' ')[1].rstrip())
+            elif line.startswith('Build: '):
+                existing_build_number = line.split(' ')[1].rstrip()
+
+        if not tags:
+            raise WheelError('No tags present in {}/WHEEL; cannot determine target wheel filename'
+                             .format(dist_info_dir))
+
+    # Set the wheel file name and add/replace/remove the Build tag in .dist-info/WHEEL
+    build_number = build_number if build_number is not None else existing_build_number
+    if build_number is not None:
+        if build_number:
+            name_version += '-' + build_number
+
+        if build_number != existing_build_number:
+            replacement = ('Build: %s\r\n' % build_number).encode('ascii') if build_number else b''
+            with open(wheel_file_path, 'rb+') as f:
+                wheel_file_content = f.read()
+                if not BUILD_NUM_RE.subn(replacement, wheel_file_content)[1]:
+                    wheel_file_content += replacement
+
+                f.truncate()
+                f.write(wheel_file_content)
+
+    # Reassemble the tags for the wheel file
+    impls = sorted({tag.split('-')[0] for tag in tags})
+    abivers = sorted({tag.split('-')[1] for tag in tags})
+    platforms = sorted({tag.split('-')[2] for tag in tags})
+    tagline = '-'.join(['.'.join(impls), '.'.join(abivers), '.'.join(platforms)])
+
+    # Repack the wheel
+    wheel_path = os.path.join(dest_dir, '{}-{}.whl'.format(name_version, tagline))
+    with WheelFile(wheel_path, 'w') as wf:
+        print("Repacking wheel as {}...".format(wheel_path), end='')
+        sys.stdout.flush()
+        wf.write_files(directory)
+
+    print('OK')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/unpack.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/unpack.py
new file mode 100644
index 0000000000000000000000000000000000000000..2e9857a35088ebec8d0a51c4be09caa66320435e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/cli/unpack.py
@@ -0,0 +1,25 @@
+from __future__ import print_function
+
+import os.path
+import sys
+
+from ..wheelfile import WheelFile
+
+
+def unpack(path, dest='.'):
+    """Unpack a wheel.
+
+    Wheel content will be unpacked to {dest}/{name}-{ver}, where {name}
+    is the package name and {ver} its version.
+
+    :param path: The path to the wheel.
+    :param dest: Destination directory (default to current directory).
+    """
+    with WheelFile(path) as wf:
+        namever = wf.parsed_filename.group('namever')
+        destination = os.path.join(dest, namever)
+        print("Unpacking to: {}...".format(destination), end='')
+        sys.stdout.flush()
+        wf.extractall(destination)
+
+    print('OK')
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9036886734e619d6cff4c10a9fb0cfddf85e136
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/macosx_libfile.py
@@ -0,0 +1,341 @@
+"""
+This module contains function to analyse dynamic library
+headers to extract system information
+
+Currently only for MacOSX
+
+Library file on macosx system starts with Mach-O or Fat field.
+This can be distinguish by first 32 bites and it is called magic number.
+Proper value of magic number is with suffix _MAGIC. Suffix _CIGAM means
+reversed bytes order.
+Both fields can occur in two types: 32 and 64 bytes.
+
+FAT field inform that this library contains few version of library
+(typically for different types version). It contains
+information where Mach-O headers starts.
+
+Each section started with Mach-O header contains one library
+(So if file starts with this field it contains only one version).
+
+After filed Mach-O there are section fields.
+Each of them starts with two fields:
+cmd - magic number for this command
+cmdsize - total size occupied by this section information.
+
+In this case only sections LC_VERSION_MIN_MACOSX (for macosx 10.13 and earlier)
+and LC_BUILD_VERSION (for macosx 10.14 and newer) are interesting,
+because them contains information about minimal system version.
+
+Important remarks:
+- For fat files this implementation looks for maximum number version.
+  It not check if it is 32 or 64 and do not compare it with currently builded package.
+  So it is possible to false report higher version that needed.
+- All structures signatures are taken form macosx header files.
+- I think that binary format will be more stable than `otool` output.
+  and if apple introduce some changes both implementation will need to be updated.
+"""
+
+import ctypes
+import sys
+
+"""here the needed const and struct from mach-o header files"""
+
+FAT_MAGIC = 0xcafebabe
+FAT_CIGAM = 0xbebafeca
+FAT_MAGIC_64 = 0xcafebabf
+FAT_CIGAM_64 = 0xbfbafeca
+MH_MAGIC = 0xfeedface
+MH_CIGAM = 0xcefaedfe
+MH_MAGIC_64 = 0xfeedfacf
+MH_CIGAM_64 = 0xcffaedfe
+
+LC_VERSION_MIN_MACOSX = 0x24
+LC_BUILD_VERSION = 0x32
+
+
+mach_header_fields = [
+        ("magic", ctypes.c_uint32), ("cputype", ctypes.c_int),
+        ("cpusubtype", ctypes.c_int), ("filetype", ctypes.c_uint32),
+        ("ncmds", ctypes.c_uint32), ("sizeofcmds", ctypes.c_uint32),
+        ("flags", ctypes.c_uint32)
+    ]
+"""
+struct mach_header {
+    uint32_t	magic;		/* mach magic number identifier */
+    cpu_type_t	cputype;	/* cpu specifier */
+    cpu_subtype_t	cpusubtype;	/* machine specifier */
+    uint32_t	filetype;	/* type of file */
+    uint32_t	ncmds;		/* number of load commands */
+    uint32_t	sizeofcmds;	/* the size of all the load commands */
+    uint32_t	flags;		/* flags */
+};
+typedef integer_t cpu_type_t;
+typedef integer_t cpu_subtype_t;
+"""
+
+mach_header_fields_64 = mach_header_fields + [("reserved", ctypes.c_uint32)]
+"""
+struct mach_header_64 {
+    uint32_t	magic;		/* mach magic number identifier */
+    cpu_type_t	cputype;	/* cpu specifier */
+    cpu_subtype_t	cpusubtype;	/* machine specifier */
+    uint32_t	filetype;	/* type of file */
+    uint32_t	ncmds;		/* number of load commands */
+    uint32_t	sizeofcmds;	/* the size of all the load commands */
+    uint32_t	flags;		/* flags */
+    uint32_t	reserved;	/* reserved */
+};
+"""
+
+fat_header_fields = [("magic", ctypes.c_uint32), ("nfat_arch", ctypes.c_uint32)]
+"""
+struct fat_header {
+    uint32_t	magic;		/* FAT_MAGIC or FAT_MAGIC_64 */
+    uint32_t	nfat_arch;	/* number of structs that follow */
+};
+"""
+
+fat_arch_fields = [
+    ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int),
+    ("offset", ctypes.c_uint32), ("size", ctypes.c_uint32),
+    ("align", ctypes.c_uint32)
+]
+"""
+struct fat_arch {
+    cpu_type_t	cputype;	/* cpu specifier (int) */
+    cpu_subtype_t	cpusubtype;	/* machine specifier (int) */
+    uint32_t	offset;		/* file offset to this object file */
+    uint32_t	size;		/* size of this object file */
+    uint32_t	align;		/* alignment as a power of 2 */
+};
+"""
+
+fat_arch_64_fields = [
+    ("cputype", ctypes.c_int), ("cpusubtype", ctypes.c_int),
+    ("offset", ctypes.c_uint64), ("size", ctypes.c_uint64),
+    ("align", ctypes.c_uint32), ("reserved", ctypes.c_uint32)
+]
+"""
+struct fat_arch_64 {
+    cpu_type_t	cputype;	/* cpu specifier (int) */
+    cpu_subtype_t	cpusubtype;	/* machine specifier (int) */
+    uint64_t	offset;		/* file offset to this object file */
+    uint64_t	size;		/* size of this object file */
+    uint32_t	align;		/* alignment as a power of 2 */
+    uint32_t	reserved;	/* reserved */
+};
+"""
+
+segment_base_fields = [("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32)]
+"""base for reading segment info"""
+
+segment_command_fields = [
+    ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32),
+    ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint32),
+    ("vmsize", ctypes.c_uint32), ("fileoff", ctypes.c_uint32),
+    ("filesize", ctypes.c_uint32), ("maxprot", ctypes.c_int),
+    ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32),
+    ("flags", ctypes.c_uint32),
+    ]
+"""
+struct segment_command { /* for 32-bit architectures */
+    uint32_t	cmd;		/* LC_SEGMENT */
+    uint32_t	cmdsize;	/* includes sizeof section structs */
+    char		segname[16];	/* segment name */
+    uint32_t	vmaddr;		/* memory address of this segment */
+    uint32_t	vmsize;		/* memory size of this segment */
+    uint32_t	fileoff;	/* file offset of this segment */
+    uint32_t	filesize;	/* amount to map from the file */
+    vm_prot_t	maxprot;	/* maximum VM protection */
+    vm_prot_t	initprot;	/* initial VM protection */
+    uint32_t	nsects;		/* number of sections in segment */
+    uint32_t	flags;		/* flags */
+};
+typedef int vm_prot_t;
+"""
+
+segment_command_fields_64 = [
+    ("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32),
+    ("segname", ctypes.c_char * 16), ("vmaddr", ctypes.c_uint64),
+    ("vmsize", ctypes.c_uint64), ("fileoff", ctypes.c_uint64),
+    ("filesize", ctypes.c_uint64), ("maxprot", ctypes.c_int),
+    ("initprot", ctypes.c_int), ("nsects", ctypes.c_uint32),
+    ("flags", ctypes.c_uint32),
+    ]
+"""
+struct segment_command_64 { /* for 64-bit architectures */
+    uint32_t	cmd;		/* LC_SEGMENT_64 */
+    uint32_t	cmdsize;	/* includes sizeof section_64 structs */
+    char		segname[16];	/* segment name */
+    uint64_t	vmaddr;		/* memory address of this segment */
+    uint64_t	vmsize;		/* memory size of this segment */
+    uint64_t	fileoff;	/* file offset of this segment */
+    uint64_t	filesize;	/* amount to map from the file */
+    vm_prot_t	maxprot;	/* maximum VM protection */
+    vm_prot_t	initprot;	/* initial VM protection */
+    uint32_t	nsects;		/* number of sections in segment */
+    uint32_t	flags;		/* flags */
+};
+"""
+
+version_min_command_fields = segment_base_fields + \
+    [("version", ctypes.c_uint32), ("sdk", ctypes.c_uint32)]
+"""
+struct version_min_command {
+    uint32_t	cmd;		/* LC_VERSION_MIN_MACOSX or
+                               LC_VERSION_MIN_IPHONEOS or
+                               LC_VERSION_MIN_WATCHOS or
+                               LC_VERSION_MIN_TVOS */
+    uint32_t	cmdsize;	/* sizeof(struct min_version_command) */
+    uint32_t	version;	/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
+    uint32_t	sdk;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
+};
+"""
+
+build_version_command_fields = segment_base_fields + \
+    [("platform", ctypes.c_uint32), ("minos", ctypes.c_uint32),
+     ("sdk", ctypes.c_uint32), ("ntools", ctypes.c_uint32)]
+"""
+struct build_version_command {
+    uint32_t	cmd;		/* LC_BUILD_VERSION */
+    uint32_t	cmdsize;	/* sizeof(struct build_version_command) plus */
+                                /* ntools * sizeof(struct build_tool_version) */
+    uint32_t	platform;	/* platform */
+    uint32_t	minos;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
+    uint32_t	sdk;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
+    uint32_t	ntools;		/* number of tool entries following this */
+};
+"""
+
+
+def swap32(x):
+    return (((x << 24) & 0xFF000000) |
+            ((x << 8) & 0x00FF0000) |
+            ((x >> 8) & 0x0000FF00) |
+            ((x >> 24) & 0x000000FF))
+
+
+def get_base_class_and_magic_number(lib_file, seek=None):
+    if seek is None:
+        seek = lib_file.tell()
+    else:
+        lib_file.seek(seek)
+    magic_number = ctypes.c_uint32.from_buffer_copy(
+        lib_file.read(ctypes.sizeof(ctypes.c_uint32))).value
+
+    # Handle wrong byte order
+    if magic_number in [FAT_CIGAM, FAT_CIGAM_64, MH_CIGAM, MH_CIGAM_64]:
+        if sys.byteorder == "little":
+            BaseClass = ctypes.BigEndianStructure
+        else:
+            BaseClass = ctypes.LittleEndianStructure
+
+        magic_number = swap32(magic_number)
+    else:
+        BaseClass = ctypes.Structure
+
+    lib_file.seek(seek)
+    return BaseClass, magic_number
+
+
+def read_data(struct_class, lib_file):
+    return struct_class.from_buffer_copy(lib_file.read(
+                        ctypes.sizeof(struct_class)))
+
+
+def extract_macosx_min_system_version(path_to_lib):
+    with open(path_to_lib, "rb") as lib_file:
+        BaseClass, magic_number = get_base_class_and_magic_number(lib_file, 0)
+        if magic_number not in [FAT_MAGIC, FAT_MAGIC_64, MH_MAGIC, MH_MAGIC_64]:
+            return
+
+        if magic_number in [FAT_MAGIC, FAT_CIGAM_64]:
+            class FatHeader(BaseClass):
+                _fields_ = fat_header_fields
+
+            fat_header = read_data(FatHeader, lib_file)
+            if magic_number == FAT_MAGIC:
+
+                class FatArch(BaseClass):
+                    _fields_ = fat_arch_fields
+            else:
+
+                class FatArch(BaseClass):
+                    _fields_ = fat_arch_64_fields
+
+            fat_arch_list = [read_data(FatArch, lib_file) for _ in range(fat_header.nfat_arch)]
+
+            versions_list = []
+            for el in fat_arch_list:
+                try:
+                    version = read_mach_header(lib_file, el.offset)
+                    if version is not None:
+                        versions_list.append(version)
+                except ValueError:
+                    pass
+
+            if len(versions_list) > 0:
+                return max(versions_list)
+            else:
+                return None
+
+        else:
+            try:
+                return read_mach_header(lib_file, 0)
+            except ValueError:
+                """when some error during read library files"""
+                return None
+
+
+def read_mach_header(lib_file, seek=None):
+    """
+    This funcition parse mach-O header and extract
+    information about minimal system version
+
+    :param lib_file: reference to opened library file with pointer
+    """
+    if seek is not None:
+        lib_file.seek(seek)
+    base_class, magic_number = get_base_class_and_magic_number(lib_file)
+    arch = "32" if magic_number == MH_MAGIC else "64"
+
+    class SegmentBase(base_class):
+        _fields_ = segment_base_fields
+
+    if arch == "32":
+
+        class MachHeader(base_class):
+            _fields_ = mach_header_fields
+
+    else:
+
+        class MachHeader(base_class):
+            _fields_ = mach_header_fields_64
+
+    mach_header = read_data(MachHeader, lib_file)
+    for _i in range(mach_header.ncmds):
+        pos = lib_file.tell()
+        segment_base = read_data(SegmentBase, lib_file)
+        lib_file.seek(pos)
+        if segment_base.cmd == LC_VERSION_MIN_MACOSX:
+            class VersionMinCommand(base_class):
+                _fields_ = version_min_command_fields
+
+            version_info = read_data(VersionMinCommand, lib_file)
+            return parse_version(version_info.version)
+        elif segment_base.cmd == LC_BUILD_VERSION:
+            class VersionBuild(base_class):
+                _fields_ = build_version_command_fields
+
+            version_info = read_data(VersionBuild, lib_file)
+            return parse_version(version_info.minos)
+        else:
+            lib_file.seek(pos + segment_base.cmdsize)
+            continue
+
+
+def parse_version(version):
+    x = (version & 0xffff0000) >> 16
+    y = (version & 0x0000ff00) >> 8
+    z = (version & 0x000000ff)
+    return x, y, z
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/metadata.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/metadata.py
new file mode 100644
index 0000000000000000000000000000000000000000..bbf57a77041d70abff0ba2a1d4e1951d8ec2cc6c
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/metadata.py
@@ -0,0 +1,138 @@
+"""
+Tools for converting old- to new-style metadata.
+"""
+
+import os.path
+import re
+import textwrap
+
+import pkg_resources
+
+from .pkginfo import read_pkg_info
+
+# Support markers syntax with the extra at the end only
+EXTRA_RE = re.compile(
+    r"""^(?P<package>.*?)(;\s*(?P<condition>.*?)(extra == '(?P<extra>.*?)')?)$""")
+
+
+def requires_to_requires_dist(requirement):
+    """Return the version specifier for a requirement in PEP 345/566 fashion."""
+    if getattr(requirement, 'url', None):
+        return " @ " + requirement.url
+
+    requires_dist = []
+    for op, ver in requirement.specs:
+        requires_dist.append(op + ver)
+    if not requires_dist:
+        return ''
+    return " (%s)" % ','.join(sorted(requires_dist))
+
+
+def convert_requirements(requirements):
+    """Yield Requires-Dist: strings for parsed requirements strings."""
+    for req in requirements:
+        parsed_requirement = pkg_resources.Requirement.parse(req)
+        spec = requires_to_requires_dist(parsed_requirement)
+        extras = ",".join(sorted(parsed_requirement.extras))
+        if extras:
+            extras = "[%s]" % extras
+        yield (parsed_requirement.project_name + extras + spec)
+
+
+def generate_requirements(extras_require):
+    """
+    Convert requirements from a setup()-style dictionary to ('Requires-Dist', 'requirement')
+    and ('Provides-Extra', 'extra') tuples.
+
+    extras_require is a dictionary of {extra: [requirements]} as passed to setup(),
+    using the empty extra {'': [requirements]} to hold install_requires.
+    """
+    for extra, depends in extras_require.items():
+        condition = ''
+        extra = extra or ''
+        if ':' in extra:  # setuptools extra:condition syntax
+            extra, condition = extra.split(':', 1)
+
+        extra = pkg_resources.safe_extra(extra)
+        if extra:
+            yield 'Provides-Extra', extra
+            if condition:
+                condition = "(" + condition + ") and "
+            condition += "extra == '%s'" % extra
+
+        if condition:
+            condition = ' ; ' + condition
+
+        for new_req in convert_requirements(depends):
+            yield 'Requires-Dist', new_req + condition
+
+
+def pkginfo_to_metadata(egg_info_path, pkginfo_path):
+    """
+    Convert .egg-info directory with PKG-INFO to the Metadata 2.1 format
+    """
+    pkg_info = read_pkg_info(pkginfo_path)
+    pkg_info.replace_header('Metadata-Version', '2.1')
+    # Those will be regenerated from `requires.txt`.
+    del pkg_info['Provides-Extra']
+    del pkg_info['Requires-Dist']
+    requires_path = os.path.join(egg_info_path, 'requires.txt')
+    if os.path.exists(requires_path):
+        with open(requires_path) as requires_file:
+            requires = requires_file.read()
+
+        parsed_requirements = sorted(pkg_resources.split_sections(requires),
+                                     key=lambda x: x[0] or '')
+        for extra, reqs in parsed_requirements:
+            for key, value in generate_requirements({extra: reqs}):
+                if (key, value) not in pkg_info.items():
+                    pkg_info[key] = value
+
+    description = pkg_info['Description']
+    if description:
+        pkg_info.set_payload(dedent_description(pkg_info))
+        del pkg_info['Description']
+
+    return pkg_info
+
+
+def pkginfo_unicode(pkg_info, field):
+    """Hack to coax Unicode out of an email Message() - Python 3.3+"""
+    text = pkg_info[field]
+    field = field.lower()
+    if not isinstance(text, str):
+        for item in pkg_info.raw_items():
+            if item[0].lower() == field:
+                text = item[1].encode('ascii', 'surrogateescape') \
+                    .decode('utf-8')
+                break
+
+    return text
+
+
+def dedent_description(pkg_info):
+    """
+    Dedent and convert pkg_info['Description'] to Unicode.
+    """
+    description = pkg_info['Description']
+
+    # Python 3 Unicode handling, sorta.
+    surrogates = False
+    if not isinstance(description, str):
+        surrogates = True
+        description = pkginfo_unicode(pkg_info, 'Description')
+
+    description_lines = description.splitlines()
+    description_dedent = '\n'.join(
+        # if the first line of long_description is blank,
+        # the first line here will be indented.
+        (description_lines[0].lstrip(),
+         textwrap.dedent('\n'.join(description_lines[1:])),
+         '\n'))
+
+    if surrogates:
+        description_dedent = description_dedent \
+            .encode("utf8") \
+            .decode("ascii", "surrogateescape")
+
+    return description_dedent
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pep425tags.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pep425tags.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c2576361d9c166d4e3249a718b0c51f963832f6
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pep425tags.py
@@ -0,0 +1,261 @@
+"""Generate and work with PEP 425 Compatibility Tags."""
+
+import distutils.util
+import platform
+import sys
+import os
+import sysconfig
+import warnings
+
+from .macosx_libfile import extract_macosx_min_system_version
+
+
+try:
+    from importlib.machinery import all_suffixes as get_all_suffixes
+except ImportError:
+    from imp import get_suffixes
+
+    def get_all_suffixes():
+        return [suffix[0] for suffix in get_suffixes()]
+
+
+def get_config_var(var):
+    try:
+        return sysconfig.get_config_var(var)
+    except IOError as e:  # pip Issue #1074
+        warnings.warn("{0}".format(e), RuntimeWarning)
+        return None
+
+
+def get_abbr_impl():
+    """Return abbreviated implementation name."""
+    impl = platform.python_implementation()
+    if impl == 'PyPy':
+        return 'pp'
+    elif impl == 'Jython':
+        return 'jy'
+    elif impl == 'IronPython':
+        return 'ip'
+    elif impl == 'CPython':
+        return 'cp'
+
+    raise LookupError('Unknown Python implementation: ' + impl)
+
+
+def get_impl_ver():
+    """Return implementation version."""
+    impl_ver = get_config_var("py_version_nodot")
+    if not impl_ver:
+        impl_ver = ''.join(map(str, get_impl_version_info()))
+    return impl_ver
+
+
+def get_impl_version_info():
+    """Return sys.version_info-like tuple for use in decrementing the minor
+    version."""
+    return sys.version_info[0], sys.version_info[1]
+
+
+def get_flag(var, fallback, expected=True, warn=True):
+    """Use a fallback method for determining SOABI flags if the needed config
+    var is unset or unavailable."""
+    val = get_config_var(var)
+    if val is None:
+        if warn:
+            warnings.warn("Config variable '{0}' is unset, Python ABI tag may "
+                          "be incorrect".format(var), RuntimeWarning, 2)
+        return fallback()
+    return val == expected
+
+
+def get_abi_tag():
+    """Return the ABI tag based on SOABI (if available) or emulate SOABI
+    (CPython 2, PyPy)."""
+    soabi = get_config_var('SOABI')
+    impl = get_abbr_impl()
+    if not soabi and impl in ('cp', 'pp') and hasattr(sys, 'maxunicode'):
+        d = ''
+        m = ''
+        u = ''
+        if get_flag('Py_DEBUG',
+                    lambda: hasattr(sys, 'gettotalrefcount'),
+                    warn=(impl == 'cp')):
+            d = 'd'
+        if get_flag('WITH_PYMALLOC',
+                    lambda: impl == 'cp',
+                    warn=(impl == 'cp' and
+                          sys.version_info < (3, 8))) \
+                and sys.version_info < (3, 8):
+            m = 'm'
+        if get_flag('Py_UNICODE_SIZE',
+                    lambda: sys.maxunicode == 0x10ffff,
+                    expected=4,
+                    warn=(impl == 'cp' and
+                          sys.version_info < (3, 3))) \
+                and sys.version_info < (3, 3):
+            u = 'u'
+        abi = '%s%s%s%s%s' % (impl, get_impl_ver(), d, m, u)
+    elif soabi and soabi.startswith('cpython-'):
+        abi = 'cp' + soabi.split('-')[1]
+    elif soabi:
+        abi = soabi.replace('.', '_').replace('-', '_')
+    else:
+        abi = None
+    return abi
+
+
+def calculate_macosx_platform_tag(archive_root, platform_tag):
+    """
+    Calculate proper macosx platform tag basing on files which are included to wheel
+
+    Example platform tag `macosx-10.14-x86_64`
+    """
+    prefix, base_version, suffix = platform_tag.split('-')
+    base_version = tuple([int(x) for x in base_version.split(".")])
+    if len(base_version) >= 2:
+        base_version = base_version[0:2]
+
+    assert len(base_version) == 2
+    if "MACOSX_DEPLOYMENT_TARGET" in os.environ:
+        deploy_target = tuple([int(x) for x in os.environ[
+            "MACOSX_DEPLOYMENT_TARGET"].split(".")])
+        if len(deploy_target) >= 2:
+            deploy_target = deploy_target[0:2]
+        if deploy_target < base_version:
+            sys.stderr.write(
+                 "[WARNING] MACOSX_DEPLOYMENT_TARGET is set to a lower value ({}) than the "
+                 "version on which the Python interpreter was compiled ({}), and will be "
+                 "ignored.\n".format('.'.join(str(x) for x in deploy_target),
+                                     '.'.join(str(x) for x in base_version))
+                )
+        else:
+            base_version = deploy_target
+
+    assert len(base_version) == 2
+    start_version = base_version
+    versions_dict = {}
+    for (dirpath, dirnames, filenames) in os.walk(archive_root):
+        for filename in filenames:
+            if filename.endswith('.dylib') or filename.endswith('.so'):
+                lib_path = os.path.join(dirpath, filename)
+                min_ver = extract_macosx_min_system_version(lib_path)
+                if min_ver is not None:
+                    versions_dict[lib_path] = min_ver[0:2]
+
+    if len(versions_dict) > 0:
+        base_version = max(base_version, max(versions_dict.values()))
+
+    # macosx platform tag do not support minor bugfix release
+    fin_base_version = "_".join([str(x) for x in base_version])
+    if start_version < base_version:
+        problematic_files = [k for k, v in versions_dict.items() if v > start_version]
+        problematic_files = "\n".join(problematic_files)
+        if len(problematic_files) == 1:
+            files_form = "this file"
+        else:
+            files_form = "these files"
+        error_message = \
+            "[WARNING] This wheel needs a higher macOS version than {}  " \
+            "To silence this warning, set MACOSX_DEPLOYMENT_TARGET to at least " +\
+            fin_base_version + " or recreate " + files_form + " with lower " \
+            "MACOSX_DEPLOYMENT_TARGET:  \n" + problematic_files
+
+        if "MACOSX_DEPLOYMENT_TARGET" in os.environ:
+            error_message = error_message.format("is set in MACOSX_DEPLOYMENT_TARGET variable.")
+        else:
+            error_message = error_message.format(
+                "the version your Python interpreter is compiled against.")
+
+        sys.stderr.write(error_message)
+
+    platform_tag = prefix + "_" + fin_base_version + "_" + suffix
+    return platform_tag
+
+
+def get_platform(archive_root):
+    """Return our platform name 'win32', 'linux_x86_64'"""
+    # XXX remove distutils dependency
+    result = distutils.util.get_platform()
+    if result.startswith("macosx") and archive_root is not None:
+        result = calculate_macosx_platform_tag(archive_root, result)
+    result = result.replace('.', '_').replace('-', '_')
+    if result == "linux_x86_64" and sys.maxsize == 2147483647:
+        # pip pull request #3497
+        result = "linux_i686"
+
+    return result
+
+
+def get_supported(archive_root, versions=None, supplied_platform=None):
+    """Return a list of supported tags for each version specified in
+    `versions`.
+
+    :param versions: a list of string versions, of the form ["33", "32"],
+        or None. The first version will be assumed to support our ABI.
+    """
+    supported = []
+
+    # Versions must be given with respect to the preference
+    if versions is None:
+        versions = []
+        version_info = get_impl_version_info()
+        major = version_info[:-1]
+        # Support all previous minor Python versions.
+        for minor in range(version_info[-1], -1, -1):
+            versions.append(''.join(map(str, major + (minor,))))
+
+    impl = get_abbr_impl()
+
+    abis = []
+
+    abi = get_abi_tag()
+    if abi:
+        abis[0:0] = [abi]
+
+    abi3s = set()
+    for suffix in get_all_suffixes():
+        if suffix.startswith('.abi'):
+            abi3s.add(suffix.split('.', 2)[1])
+
+    abis.extend(sorted(list(abi3s)))
+
+    abis.append('none')
+
+    platforms = []
+    if supplied_platform:
+        platforms.append(supplied_platform)
+    platforms.append(get_platform(archive_root))
+
+    # Current version, current API (built specifically for our Python):
+    for abi in abis:
+        for arch in platforms:
+            supported.append(('%s%s' % (impl, versions[0]), abi, arch))
+
+    # abi3 modules compatible with older version of Python
+    for version in versions[1:]:
+        # abi3 was introduced in Python 3.2
+        if version in ('31', '30'):
+            break
+        for abi in abi3s:   # empty set if not Python 3
+            for arch in platforms:
+                supported.append(("%s%s" % (impl, version), abi, arch))
+
+    # No abi / arch, but requires our implementation:
+    for i, version in enumerate(versions):
+        supported.append(('%s%s' % (impl, version), 'none', 'any'))
+        if i == 0:
+            # Tagged specifically as being cross-version compatible
+            # (with just the major version specified)
+            supported.append(('%s%s' % (impl, versions[0][0]), 'none', 'any'))
+
+    # Major Python version + platform; e.g. binaries not using the Python API
+    for arch in platforms:
+        supported.append(('py%s' % (versions[0][0]), 'none', arch))
+
+    # No abi / arch, generic Python
+    for i, version in enumerate(versions):
+        supported.append(('py%s' % (version,), 'none', 'any'))
+        if i == 0:
+            supported.append(('py%s' % (version[0]), 'none', 'any'))
+
+    return supported
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pkginfo.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pkginfo.py
new file mode 100644
index 0000000000000000000000000000000000000000..115be45bdfb5bf1a6c9dca87471c5ca0839f63b1
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/pkginfo.py
@@ -0,0 +1,43 @@
+"""Tools for reading and writing PKG-INFO / METADATA without caring
+about the encoding."""
+
+from email.parser import Parser
+
+try:
+    unicode
+    _PY3 = False
+except NameError:
+    _PY3 = True
+
+if not _PY3:
+    from email.generator import Generator
+
+    def read_pkg_info_bytes(bytestr):
+        return Parser().parsestr(bytestr)
+
+    def read_pkg_info(path):
+        with open(path, "r") as headers:
+            message = Parser().parse(headers)
+        return message
+
+    def write_pkg_info(path, message):
+        with open(path, 'w') as metadata:
+            Generator(metadata, mangle_from_=False, maxheaderlen=0).flatten(message)
+else:
+    from email.generator import BytesGenerator
+
+    def read_pkg_info_bytes(bytestr):
+        headers = bytestr.decode(encoding="ascii", errors="surrogateescape")
+        message = Parser().parsestr(headers)
+        return message
+
+    def read_pkg_info(path):
+        with open(path, "r",
+                  encoding="ascii",
+                  errors="surrogateescape") as headers:
+            message = Parser().parse(headers)
+        return message
+
+    def write_pkg_info(path, message):
+        with open(path, "wb") as out:
+            BytesGenerator(out, mangle_from_=False, maxheaderlen=0).flatten(message)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/util.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/util.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ae2b4457ca50752977907ec3cd3c0b7d27042ac
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/util.py
@@ -0,0 +1,46 @@
+import base64
+import io
+import sys
+
+
+if sys.version_info[0] < 3:
+    text_type = unicode  # noqa: F821
+
+    StringIO = io.BytesIO
+
+    def native(s, encoding='utf-8'):
+        if isinstance(s, unicode):  # noqa: F821
+            return s.encode(encoding)
+        return s
+else:
+    text_type = str
+
+    StringIO = io.StringIO
+
+    def native(s, encoding='utf-8'):
+        if isinstance(s, bytes):
+            return s.decode(encoding)
+        return s
+
+
+def urlsafe_b64encode(data):
+    """urlsafe_b64encode without padding"""
+    return base64.urlsafe_b64encode(data).rstrip(b'=')
+
+
+def urlsafe_b64decode(data):
+    """urlsafe_b64decode without padding"""
+    pad = b'=' * (4 - (len(data) & 3))
+    return base64.urlsafe_b64decode(data + pad)
+
+
+def as_unicode(s):
+    if isinstance(s, bytes):
+        return s.decode('utf-8')
+    return s
+
+
+def as_bytes(s):
+    if isinstance(s, text_type):
+        return s.encode('utf-8')
+    return s
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/wheelfile.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/wheelfile.py
new file mode 100644
index 0000000000000000000000000000000000000000..acc5dab512b488cc83d8c44cac4ee20310b131ee
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/wheel/wheelfile.py
@@ -0,0 +1,169 @@
+from __future__ import print_function
+
+import csv
+import hashlib
+import os.path
+import re
+import stat
+import time
+from collections import OrderedDict
+from distutils import log as logger
+from zipfile import ZIP_DEFLATED, ZipInfo, ZipFile
+
+from wheel.cli import WheelError
+from wheel.util import urlsafe_b64decode, as_unicode, native, urlsafe_b64encode, as_bytes, StringIO
+
+# Non-greedy matching of an optional build number may be too clever (more
+# invalid wheel filenames will match). Separate regex for .dist-info?
+WHEEL_INFO_RE = re.compile(
+    r"""^(?P<namever>(?P<name>.+?)-(?P<ver>.+?))(-(?P<build>\d[^-]*))?
+     -(?P<pyver>.+?)-(?P<abi>.+?)-(?P<plat>.+?)\.whl$""",
+    re.VERBOSE)
+
+
+def get_zipinfo_datetime(timestamp=None):
+    # Some applications need reproducible .whl files, but they can't do this without forcing
+    # the timestamp of the individual ZipInfo objects. See issue #143.
+    timestamp = int(os.environ.get('SOURCE_DATE_EPOCH', timestamp or time.time()))
+    return time.gmtime(timestamp)[0:6]
+
+
+class WheelFile(ZipFile):
+    """A ZipFile derivative class that also reads SHA-256 hashes from
+    .dist-info/RECORD and checks any read files against those.
+    """
+
+    _default_algorithm = hashlib.sha256
+
+    def __init__(self, file, mode='r', compression=ZIP_DEFLATED):
+        basename = os.path.basename(file)
+        self.parsed_filename = WHEEL_INFO_RE.match(basename)
+        if not basename.endswith('.whl') or self.parsed_filename is None:
+            raise WheelError("Bad wheel filename {!r}".format(basename))
+
+        ZipFile.__init__(self, file, mode, compression=compression, allowZip64=True)
+
+        self.dist_info_path = '{}.dist-info'.format(self.parsed_filename.group('namever'))
+        self.record_path = self.dist_info_path + '/RECORD'
+        self._file_hashes = OrderedDict()
+        self._file_sizes = {}
+        if mode == 'r':
+            # Ignore RECORD and any embedded wheel signatures
+            self._file_hashes[self.record_path] = None, None
+            self._file_hashes[self.record_path + '.jws'] = None, None
+            self._file_hashes[self.record_path + '.p7s'] = None, None
+
+            # Fill in the expected hashes by reading them from RECORD
+            try:
+                record = self.open(self.record_path)
+            except KeyError:
+                raise WheelError('Missing {} file'.format(self.record_path))
+
+            with record:
+                for line in record:
+                    line = line.decode('utf-8')
+                    path, hash_sum, size = line.rsplit(u',', 2)
+                    if hash_sum:
+                        algorithm, hash_sum = hash_sum.split(u'=')
+                        try:
+                            hashlib.new(algorithm)
+                        except ValueError:
+                            raise WheelError('Unsupported hash algorithm: {}'.format(algorithm))
+
+                        if algorithm.lower() in {'md5', 'sha1'}:
+                            raise WheelError(
+                                'Weak hash algorithm ({}) is not permitted by PEP 427'
+                                .format(algorithm))
+
+                        self._file_hashes[path] = (
+                            algorithm, urlsafe_b64decode(hash_sum.encode('ascii')))
+
+    def open(self, name_or_info, mode="r", pwd=None):
+        def _update_crc(newdata, eof=None):
+            if eof is None:
+                eof = ef._eof
+                update_crc_orig(newdata)
+            else:  # Python 2
+                update_crc_orig(newdata, eof)
+
+            running_hash.update(newdata)
+            if eof and running_hash.digest() != expected_hash:
+                raise WheelError("Hash mismatch for file '{}'".format(native(ef_name)))
+
+        ef = ZipFile.open(self, name_or_info, mode, pwd)
+        ef_name = as_unicode(name_or_info.filename if isinstance(name_or_info, ZipInfo)
+                             else name_or_info)
+        if mode == 'r' and not ef_name.endswith('/'):
+            if ef_name not in self._file_hashes:
+                raise WheelError("No hash found for file '{}'".format(native(ef_name)))
+
+            algorithm, expected_hash = self._file_hashes[ef_name]
+            if expected_hash is not None:
+                # Monkey patch the _update_crc method to also check for the hash from RECORD
+                running_hash = hashlib.new(algorithm)
+                update_crc_orig, ef._update_crc = ef._update_crc, _update_crc
+
+        return ef
+
+    def write_files(self, base_dir):
+        logger.info("creating '%s' and adding '%s' to it", self.filename, base_dir)
+        deferred = []
+        for root, dirnames, filenames in os.walk(base_dir):
+            # Sort the directory names so that `os.walk` will walk them in a
+            # defined order on the next iteration.
+            dirnames.sort()
+            for name in sorted(filenames):
+                path = os.path.normpath(os.path.join(root, name))
+                if os.path.isfile(path):
+                    arcname = os.path.relpath(path, base_dir).replace(os.path.sep, '/')
+                    if arcname == self.record_path:
+                        pass
+                    elif root.endswith('.dist-info'):
+                        deferred.append((path, arcname))
+                    else:
+                        self.write(path, arcname)
+
+        deferred.sort()
+        for path, arcname in deferred:
+            self.write(path, arcname)
+
+    def write(self, filename, arcname=None, compress_type=None):
+        with open(filename, 'rb') as f:
+            st = os.fstat(f.fileno())
+            data = f.read()
+
+        zinfo = ZipInfo(arcname or filename, date_time=get_zipinfo_datetime(st.st_mtime))
+        zinfo.external_attr = (stat.S_IMODE(st.st_mode) | stat.S_IFMT(st.st_mode)) << 16
+        zinfo.compress_type = compress_type or self.compression
+        self.writestr(zinfo, data, compress_type)
+
+    def writestr(self, zinfo_or_arcname, bytes, compress_type=None):
+        ZipFile.writestr(self, zinfo_or_arcname, bytes, compress_type)
+        fname = (zinfo_or_arcname.filename if isinstance(zinfo_or_arcname, ZipInfo)
+                 else zinfo_or_arcname)
+        logger.info("adding '%s'", fname)
+        if fname != self.record_path:
+            hash_ = self._default_algorithm(bytes)
+            self._file_hashes[fname] = hash_.name, native(urlsafe_b64encode(hash_.digest()))
+            self._file_sizes[fname] = len(bytes)
+
+    def close(self):
+        # Write RECORD
+        if self.fp is not None and self.mode == 'w' and self._file_hashes:
+            data = StringIO()
+            writer = csv.writer(data, delimiter=',', quotechar='"', lineterminator='\n')
+            writer.writerows((
+                (
+                    fname,
+                    algorithm + "=" + hash_,
+                    self._file_sizes[fname]
+                )
+                for fname, (algorithm, hash_) in self._file_hashes.items()
+            ))
+            writer.writerow((format(self.record_path), "", ""))
+            zinfo = ZipInfo(native(self.record_path), date_time=get_zipinfo_datetime())
+            zinfo.compress_type = self.compression
+            zinfo.external_attr = 0o664 << 16
+            self.writestr(zinfo, as_bytes(data.getvalue()))
+
+        ZipFile.close(self)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/__init__.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..13d687c501c854057404469446c680231fbc92e5
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/__init__.py
@@ -0,0 +1,427 @@
+
+from .error import *
+
+from .tokens import *
+from .events import *
+from .nodes import *
+
+from .loader import *
+from .dumper import *
+
+__version__ = '5.3.1'
+try:
+    from .cyaml import *
+    __with_libyaml__ = True
+except ImportError:
+    __with_libyaml__ = False
+
+import io
+
+#------------------------------------------------------------------------------
+# Warnings control
+#------------------------------------------------------------------------------
+
+# 'Global' warnings state:
+_warnings_enabled = {
+    'YAMLLoadWarning': True,
+}
+
+# Get or set global warnings' state
+def warnings(settings=None):
+    if settings is None:
+        return _warnings_enabled
+
+    if type(settings) is dict:
+        for key in settings:
+            if key in _warnings_enabled:
+                _warnings_enabled[key] = settings[key]
+
+# Warn when load() is called without Loader=...
+class YAMLLoadWarning(RuntimeWarning):
+    pass
+
+def load_warning(method):
+    if _warnings_enabled['YAMLLoadWarning'] is False:
+        return
+
+    import warnings
+
+    message = (
+        "calling yaml.%s() without Loader=... is deprecated, as the "
+        "default Loader is unsafe. Please read "
+        "https://msg.pyyaml.org/load for full details."
+    ) % method
+
+    warnings.warn(message, YAMLLoadWarning, stacklevel=3)
+
+#------------------------------------------------------------------------------
+def scan(stream, Loader=Loader):
+    """
+    Scan a YAML stream and produce scanning tokens.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_token():
+            yield loader.get_token()
+    finally:
+        loader.dispose()
+
+def parse(stream, Loader=Loader):
+    """
+    Parse a YAML stream and produce parsing events.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_event():
+            yield loader.get_event()
+    finally:
+        loader.dispose()
+
+def compose(stream, Loader=Loader):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding representation tree.
+    """
+    loader = Loader(stream)
+    try:
+        return loader.get_single_node()
+    finally:
+        loader.dispose()
+
+def compose_all(stream, Loader=Loader):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding representation trees.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_node():
+            yield loader.get_node()
+    finally:
+        loader.dispose()
+
+def load(stream, Loader=None):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+    """
+    if Loader is None:
+        load_warning('load')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        return loader.get_single_data()
+    finally:
+        loader.dispose()
+
+def load_all(stream, Loader=None):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+    """
+    if Loader is None:
+        load_warning('load_all')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        while loader.check_data():
+            yield loader.get_data()
+    finally:
+        loader.dispose()
+
+def full_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, FullLoader)
+
+def full_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, FullLoader)
+
+def safe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load(stream, SafeLoader)
+
+def safe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load_all(stream, SafeLoader)
+
+def unsafe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, UnsafeLoader)
+
+def unsafe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, UnsafeLoader)
+
+def emit(events, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None):
+    """
+    Emit YAML parsing events into a stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        stream = io.StringIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break)
+    try:
+        for event in events:
+            dumper.emit(event)
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize_all(nodes, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None):
+    """
+    Serialize a sequence of representation trees into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end)
+    try:
+        dumper.open()
+        for node in nodes:
+            dumper.serialize(node)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize(node, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a representation tree into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return serialize_all([node], stream, Dumper=Dumper, **kwds)
+
+def dump_all(documents, stream=None, Dumper=Dumper,
+        default_style=None, default_flow_style=False,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None, sort_keys=True):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, default_style=default_style,
+            default_flow_style=default_flow_style,
+            canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end, sort_keys=sort_keys)
+    try:
+        dumper.open()
+        for data in documents:
+            dumper.represent(data)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def dump(data, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=Dumper, **kwds)
+
+def safe_dump_all(documents, stream=None, **kwds):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all(documents, stream, Dumper=SafeDumper, **kwds)
+
+def safe_dump(data, stream=None, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=SafeDumper, **kwds)
+
+def add_implicit_resolver(tag, regexp, first=None,
+        Loader=None, Dumper=Dumper):
+    """
+    Add an implicit scalar detector.
+    If an implicit scalar value matches the given regexp,
+    the corresponding tag is assigned to the scalar.
+    first is a sequence of possible initial characters or None.
+    """
+    if Loader is None:
+        loader.Loader.add_implicit_resolver(tag, regexp, first)
+        loader.FullLoader.add_implicit_resolver(tag, regexp, first)
+        loader.UnsafeLoader.add_implicit_resolver(tag, regexp, first)
+    else:
+        Loader.add_implicit_resolver(tag, regexp, first)
+    Dumper.add_implicit_resolver(tag, regexp, first)
+
+def add_path_resolver(tag, path, kind=None, Loader=None, Dumper=Dumper):
+    """
+    Add a path based resolver for the given tag.
+    A path is a list of keys that forms a path
+    to a node in the representation tree.
+    Keys can be string values, integers, or None.
+    """
+    if Loader is None:
+        loader.Loader.add_path_resolver(tag, path, kind)
+        loader.FullLoader.add_path_resolver(tag, path, kind)
+        loader.UnsafeLoader.add_path_resolver(tag, path, kind)
+    else:
+        Loader.add_path_resolver(tag, path, kind)
+    Dumper.add_path_resolver(tag, path, kind)
+
+def add_constructor(tag, constructor, Loader=None):
+    """
+    Add a constructor for the given tag.
+    Constructor is a function that accepts a Loader instance
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_constructor(tag, constructor)
+        loader.FullLoader.add_constructor(tag, constructor)
+        loader.UnsafeLoader.add_constructor(tag, constructor)
+    else:
+        Loader.add_constructor(tag, constructor)
+
+def add_multi_constructor(tag_prefix, multi_constructor, Loader=None):
+    """
+    Add a multi-constructor for the given tag prefix.
+    Multi-constructor is called for a node if its tag starts with tag_prefix.
+    Multi-constructor accepts a Loader instance, a tag suffix,
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.FullLoader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.UnsafeLoader.add_multi_constructor(tag_prefix, multi_constructor)
+    else:
+        Loader.add_multi_constructor(tag_prefix, multi_constructor)
+
+def add_representer(data_type, representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Representer is a function accepting a Dumper instance
+    and an instance of the given data type
+    and producing the corresponding representation node.
+    """
+    Dumper.add_representer(data_type, representer)
+
+def add_multi_representer(data_type, multi_representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Multi-representer is a function accepting a Dumper instance
+    and an instance of the given data type or subtype
+    and producing the corresponding representation node.
+    """
+    Dumper.add_multi_representer(data_type, multi_representer)
+
+class YAMLObjectMetaclass(type):
+    """
+    The metaclass for YAMLObject.
+    """
+    def __init__(cls, name, bases, kwds):
+        super(YAMLObjectMetaclass, cls).__init__(name, bases, kwds)
+        if 'yaml_tag' in kwds and kwds['yaml_tag'] is not None:
+            if isinstance(cls.yaml_loader, list):
+                for loader in cls.yaml_loader:
+                    loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+            else:
+                cls.yaml_loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+
+            cls.yaml_dumper.add_representer(cls, cls.to_yaml)
+
+class YAMLObject(metaclass=YAMLObjectMetaclass):
+    """
+    An object that can dump itself to a YAML stream
+    and load itself from a YAML stream.
+    """
+
+    __slots__ = ()  # no direct instantiation, so allow immutable subclasses
+
+    yaml_loader = [Loader, FullLoader, UnsafeLoader]
+    yaml_dumper = Dumper
+
+    yaml_tag = None
+    yaml_flow_style = None
+
+    @classmethod
+    def from_yaml(cls, loader, node):
+        """
+        Convert a representation node to a Python object.
+        """
+        return loader.construct_yaml_object(node, cls)
+
+    @classmethod
+    def to_yaml(cls, dumper, data):
+        """
+        Convert a Python object to a representation node.
+        """
+        return dumper.represent_yaml_object(cls.yaml_tag, data, cls,
+                flow_style=cls.yaml_flow_style)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/composer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/composer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d15cb40e3b4198819c91c6f8d8b32807fcf53b2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/composer.py
@@ -0,0 +1,139 @@
+
+__all__ = ['Composer', 'ComposerError']
+
+from .error import MarkedYAMLError
+from .events import *
+from .nodes import *
+
+class ComposerError(MarkedYAMLError):
+    pass
+
+class Composer:
+
+    def __init__(self):
+        self.anchors = {}
+
+    def check_node(self):
+        # Drop the STREAM-START event.
+        if self.check_event(StreamStartEvent):
+            self.get_event()
+
+        # If there are more documents available?
+        return not self.check_event(StreamEndEvent)
+
+    def get_node(self):
+        # Get the root node of the next document.
+        if not self.check_event(StreamEndEvent):
+            return self.compose_document()
+
+    def get_single_node(self):
+        # Drop the STREAM-START event.
+        self.get_event()
+
+        # Compose a document if the stream is not empty.
+        document = None
+        if not self.check_event(StreamEndEvent):
+            document = self.compose_document()
+
+        # Ensure that the stream contains no more documents.
+        if not self.check_event(StreamEndEvent):
+            event = self.get_event()
+            raise ComposerError("expected a single document in the stream",
+                    document.start_mark, "but found another document",
+                    event.start_mark)
+
+        # Drop the STREAM-END event.
+        self.get_event()
+
+        return document
+
+    def compose_document(self):
+        # Drop the DOCUMENT-START event.
+        self.get_event()
+
+        # Compose the root node.
+        node = self.compose_node(None, None)
+
+        # Drop the DOCUMENT-END event.
+        self.get_event()
+
+        self.anchors = {}
+        return node
+
+    def compose_node(self, parent, index):
+        if self.check_event(AliasEvent):
+            event = self.get_event()
+            anchor = event.anchor
+            if anchor not in self.anchors:
+                raise ComposerError(None, None, "found undefined alias %r"
+                        % anchor, event.start_mark)
+            return self.anchors[anchor]
+        event = self.peek_event()
+        anchor = event.anchor
+        if anchor is not None:
+            if anchor in self.anchors:
+                raise ComposerError("found duplicate anchor %r; first occurrence"
+                        % anchor, self.anchors[anchor].start_mark,
+                        "second occurrence", event.start_mark)
+        self.descend_resolver(parent, index)
+        if self.check_event(ScalarEvent):
+            node = self.compose_scalar_node(anchor)
+        elif self.check_event(SequenceStartEvent):
+            node = self.compose_sequence_node(anchor)
+        elif self.check_event(MappingStartEvent):
+            node = self.compose_mapping_node(anchor)
+        self.ascend_resolver()
+        return node
+
+    def compose_scalar_node(self, anchor):
+        event = self.get_event()
+        tag = event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(ScalarNode, event.value, event.implicit)
+        node = ScalarNode(tag, event.value,
+                event.start_mark, event.end_mark, style=event.style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        return node
+
+    def compose_sequence_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(SequenceNode, None, start_event.implicit)
+        node = SequenceNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        index = 0
+        while not self.check_event(SequenceEndEvent):
+            node.value.append(self.compose_node(node, index))
+            index += 1
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
+    def compose_mapping_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(MappingNode, None, start_event.implicit)
+        node = MappingNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        while not self.check_event(MappingEndEvent):
+            #key_event = self.peek_event()
+            item_key = self.compose_node(node, None)
+            #if item_key in node.value:
+            #    raise ComposerError("while composing a mapping", start_event.start_mark,
+            #            "found duplicate key", key_event.start_mark)
+            item_value = self.compose_node(node, item_key)
+            #node.value[item_key] = item_value
+            node.value.append((item_key, item_value))
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/constructor.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/constructor.py
new file mode 100644
index 0000000000000000000000000000000000000000..1948b125c205261864156b18178c1af3f535ad76
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/constructor.py
@@ -0,0 +1,748 @@
+
+__all__ = [
+    'BaseConstructor',
+    'SafeConstructor',
+    'FullConstructor',
+    'UnsafeConstructor',
+    'Constructor',
+    'ConstructorError'
+]
+
+from .error import *
+from .nodes import *
+
+import collections.abc, datetime, base64, binascii, re, sys, types
+
+class ConstructorError(MarkedYAMLError):
+    pass
+
+class BaseConstructor:
+
+    yaml_constructors = {}
+    yaml_multi_constructors = {}
+
+    def __init__(self):
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.state_generators = []
+        self.deep_construct = False
+
+    def check_data(self):
+        # If there are more documents available?
+        return self.check_node()
+
+    def check_state_key(self, key):
+        """Block special attributes/methods from being set in a newly created
+        object, to prevent user-controlled methods from being called during
+        deserialization"""
+        if self.get_state_keys_blacklist_regexp().match(key):
+            raise ConstructorError(None, None,
+                "blacklisted key '%s' in instance state found" % (key,), None)
+
+    def get_data(self):
+        # Construct and return the next document.
+        if self.check_node():
+            return self.construct_document(self.get_node())
+
+    def get_single_data(self):
+        # Ensure that the stream contains a single document and construct it.
+        node = self.get_single_node()
+        if node is not None:
+            return self.construct_document(node)
+        return None
+
+    def construct_document(self, node):
+        data = self.construct_object(node)
+        while self.state_generators:
+            state_generators = self.state_generators
+            self.state_generators = []
+            for generator in state_generators:
+                for dummy in generator:
+                    pass
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.deep_construct = False
+        return data
+
+    def construct_object(self, node, deep=False):
+        if node in self.constructed_objects:
+            return self.constructed_objects[node]
+        if deep:
+            old_deep = self.deep_construct
+            self.deep_construct = True
+        if node in self.recursive_objects:
+            raise ConstructorError(None, None,
+                    "found unconstructable recursive node", node.start_mark)
+        self.recursive_objects[node] = None
+        constructor = None
+        tag_suffix = None
+        if node.tag in self.yaml_constructors:
+            constructor = self.yaml_constructors[node.tag]
+        else:
+            for tag_prefix in self.yaml_multi_constructors:
+                if tag_prefix is not None and node.tag.startswith(tag_prefix):
+                    tag_suffix = node.tag[len(tag_prefix):]
+                    constructor = self.yaml_multi_constructors[tag_prefix]
+                    break
+            else:
+                if None in self.yaml_multi_constructors:
+                    tag_suffix = node.tag
+                    constructor = self.yaml_multi_constructors[None]
+                elif None in self.yaml_constructors:
+                    constructor = self.yaml_constructors[None]
+                elif isinstance(node, ScalarNode):
+                    constructor = self.__class__.construct_scalar
+                elif isinstance(node, SequenceNode):
+                    constructor = self.__class__.construct_sequence
+                elif isinstance(node, MappingNode):
+                    constructor = self.__class__.construct_mapping
+        if tag_suffix is None:
+            data = constructor(self, node)
+        else:
+            data = constructor(self, tag_suffix, node)
+        if isinstance(data, types.GeneratorType):
+            generator = data
+            data = next(generator)
+            if self.deep_construct:
+                for dummy in generator:
+                    pass
+            else:
+                self.state_generators.append(generator)
+        self.constructed_objects[node] = data
+        del self.recursive_objects[node]
+        if deep:
+            self.deep_construct = old_deep
+        return data
+
+    def construct_scalar(self, node):
+        if not isinstance(node, ScalarNode):
+            raise ConstructorError(None, None,
+                    "expected a scalar node, but found %s" % node.id,
+                    node.start_mark)
+        return node.value
+
+    def construct_sequence(self, node, deep=False):
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError(None, None,
+                    "expected a sequence node, but found %s" % node.id,
+                    node.start_mark)
+        return [self.construct_object(child, deep=deep)
+                for child in node.value]
+
+    def construct_mapping(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        mapping = {}
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            if not isinstance(key, collections.abc.Hashable):
+                raise ConstructorError("while constructing a mapping", node.start_mark,
+                        "found unhashable key", key_node.start_mark)
+            value = self.construct_object(value_node, deep=deep)
+            mapping[key] = value
+        return mapping
+
+    def construct_pairs(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        pairs = []
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            value = self.construct_object(value_node, deep=deep)
+            pairs.append((key, value))
+        return pairs
+
+    @classmethod
+    def add_constructor(cls, tag, constructor):
+        if not 'yaml_constructors' in cls.__dict__:
+            cls.yaml_constructors = cls.yaml_constructors.copy()
+        cls.yaml_constructors[tag] = constructor
+
+    @classmethod
+    def add_multi_constructor(cls, tag_prefix, multi_constructor):
+        if not 'yaml_multi_constructors' in cls.__dict__:
+            cls.yaml_multi_constructors = cls.yaml_multi_constructors.copy()
+        cls.yaml_multi_constructors[tag_prefix] = multi_constructor
+
+class SafeConstructor(BaseConstructor):
+
+    def construct_scalar(self, node):
+        if isinstance(node, MappingNode):
+            for key_node, value_node in node.value:
+                if key_node.tag == 'tag:yaml.org,2002:value':
+                    return self.construct_scalar(value_node)
+        return super().construct_scalar(node)
+
+    def flatten_mapping(self, node):
+        merge = []
+        index = 0
+        while index < len(node.value):
+            key_node, value_node = node.value[index]
+            if key_node.tag == 'tag:yaml.org,2002:merge':
+                del node.value[index]
+                if isinstance(value_node, MappingNode):
+                    self.flatten_mapping(value_node)
+                    merge.extend(value_node.value)
+                elif isinstance(value_node, SequenceNode):
+                    submerge = []
+                    for subnode in value_node.value:
+                        if not isinstance(subnode, MappingNode):
+                            raise ConstructorError("while constructing a mapping",
+                                    node.start_mark,
+                                    "expected a mapping for merging, but found %s"
+                                    % subnode.id, subnode.start_mark)
+                        self.flatten_mapping(subnode)
+                        submerge.append(subnode.value)
+                    submerge.reverse()
+                    for value in submerge:
+                        merge.extend(value)
+                else:
+                    raise ConstructorError("while constructing a mapping", node.start_mark,
+                            "expected a mapping or list of mappings for merging, but found %s"
+                            % value_node.id, value_node.start_mark)
+            elif key_node.tag == 'tag:yaml.org,2002:value':
+                key_node.tag = 'tag:yaml.org,2002:str'
+                index += 1
+            else:
+                index += 1
+        if merge:
+            node.value = merge + node.value
+
+    def construct_mapping(self, node, deep=False):
+        if isinstance(node, MappingNode):
+            self.flatten_mapping(node)
+        return super().construct_mapping(node, deep=deep)
+
+    def construct_yaml_null(self, node):
+        self.construct_scalar(node)
+        return None
+
+    bool_values = {
+        'yes':      True,
+        'no':       False,
+        'true':     True,
+        'false':    False,
+        'on':       True,
+        'off':      False,
+    }
+
+    def construct_yaml_bool(self, node):
+        value = self.construct_scalar(node)
+        return self.bool_values[value.lower()]
+
+    def construct_yaml_int(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '')
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '0':
+            return 0
+        elif value.startswith('0b'):
+            return sign*int(value[2:], 2)
+        elif value.startswith('0x'):
+            return sign*int(value[2:], 16)
+        elif value[0] == '0':
+            return sign*int(value, 8)
+        elif ':' in value:
+            digits = [int(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*int(value)
+
+    inf_value = 1e300
+    while inf_value != inf_value*inf_value:
+        inf_value *= inf_value
+    nan_value = -inf_value/inf_value   # Trying to make a quiet NaN (like C99).
+
+    def construct_yaml_float(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '').lower()
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '.inf':
+            return sign*self.inf_value
+        elif value == '.nan':
+            return self.nan_value
+        elif ':' in value:
+            digits = [float(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0.0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*float(value)
+
+    def construct_yaml_binary(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    timestamp_regexp = re.compile(
+            r'''^(?P<year>[0-9][0-9][0-9][0-9])
+                -(?P<month>[0-9][0-9]?)
+                -(?P<day>[0-9][0-9]?)
+                (?:(?:[Tt]|[ \t]+)
+                (?P<hour>[0-9][0-9]?)
+                :(?P<minute>[0-9][0-9])
+                :(?P<second>[0-9][0-9])
+                (?:\.(?P<fraction>[0-9]*))?
+                (?:[ \t]*(?P<tz>Z|(?P<tz_sign>[-+])(?P<tz_hour>[0-9][0-9]?)
+                (?::(?P<tz_minute>[0-9][0-9]))?))?)?$''', re.X)
+
+    def construct_yaml_timestamp(self, node):
+        value = self.construct_scalar(node)
+        match = self.timestamp_regexp.match(node.value)
+        values = match.groupdict()
+        year = int(values['year'])
+        month = int(values['month'])
+        day = int(values['day'])
+        if not values['hour']:
+            return datetime.date(year, month, day)
+        hour = int(values['hour'])
+        minute = int(values['minute'])
+        second = int(values['second'])
+        fraction = 0
+        tzinfo = None
+        if values['fraction']:
+            fraction = values['fraction'][:6]
+            while len(fraction) < 6:
+                fraction += '0'
+            fraction = int(fraction)
+        if values['tz_sign']:
+            tz_hour = int(values['tz_hour'])
+            tz_minute = int(values['tz_minute'] or 0)
+            delta = datetime.timedelta(hours=tz_hour, minutes=tz_minute)
+            if values['tz_sign'] == '-':
+                delta = -delta
+            tzinfo = datetime.timezone(delta)
+        elif values['tz']:
+            tzinfo = datetime.timezone.utc
+        return datetime.datetime(year, month, day, hour, minute, second, fraction,
+                                 tzinfo=tzinfo)
+
+    def construct_yaml_omap(self, node):
+        # Note: we do not check for duplicate keys, because it's too
+        # CPU-expensive.
+        omap = []
+        yield omap
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing an ordered map", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            omap.append((key, value))
+
+    def construct_yaml_pairs(self, node):
+        # Note: the same code as `construct_yaml_omap`.
+        pairs = []
+        yield pairs
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing pairs", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            pairs.append((key, value))
+
+    def construct_yaml_set(self, node):
+        data = set()
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_yaml_seq(self, node):
+        data = []
+        yield data
+        data.extend(self.construct_sequence(node))
+
+    def construct_yaml_map(self, node):
+        data = {}
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_object(self, node, cls):
+        data = cls.__new__(cls)
+        yield data
+        if hasattr(data, '__setstate__'):
+            state = self.construct_mapping(node, deep=True)
+            data.__setstate__(state)
+        else:
+            state = self.construct_mapping(node)
+            data.__dict__.update(state)
+
+    def construct_undefined(self, node):
+        raise ConstructorError(None, None,
+                "could not determine a constructor for the tag %r" % node.tag,
+                node.start_mark)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:null',
+        SafeConstructor.construct_yaml_null)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:bool',
+        SafeConstructor.construct_yaml_bool)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:int',
+        SafeConstructor.construct_yaml_int)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:float',
+        SafeConstructor.construct_yaml_float)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:binary',
+        SafeConstructor.construct_yaml_binary)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:timestamp',
+        SafeConstructor.construct_yaml_timestamp)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:omap',
+        SafeConstructor.construct_yaml_omap)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:pairs',
+        SafeConstructor.construct_yaml_pairs)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:set',
+        SafeConstructor.construct_yaml_set)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:str',
+        SafeConstructor.construct_yaml_str)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:seq',
+        SafeConstructor.construct_yaml_seq)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:map',
+        SafeConstructor.construct_yaml_map)
+
+SafeConstructor.add_constructor(None,
+        SafeConstructor.construct_undefined)
+
+class FullConstructor(SafeConstructor):
+    # 'extend' is blacklisted because it is used by
+    # construct_python_object_apply to add `listitems` to a newly generate
+    # python instance
+    def get_state_keys_blacklist(self):
+        return ['^extend$', '^__.*__$']
+
+    def get_state_keys_blacklist_regexp(self):
+        if not hasattr(self, 'state_keys_blacklist_regexp'):
+            self.state_keys_blacklist_regexp = re.compile('(' + '|'.join(self.get_state_keys_blacklist()) + ')')
+        return self.state_keys_blacklist_regexp
+
+    def construct_python_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_unicode(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_bytes(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    def construct_python_long(self, node):
+        return self.construct_yaml_int(node)
+
+    def construct_python_complex(self, node):
+       return complex(self.construct_scalar(node))
+
+    def construct_python_tuple(self, node):
+        return tuple(self.construct_sequence(node))
+
+    def find_python_module(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if unsafe:
+            try:
+                __import__(name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python module", mark,
+                        "cannot find module %r (%s)" % (name, exc), mark)
+        if name not in sys.modules:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "module %r is not imported" % name, mark)
+        return sys.modules[name]
+
+    def find_python_name(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if '.' in name:
+            module_name, object_name = name.rsplit('.', 1)
+        else:
+            module_name = 'builtins'
+            object_name = name
+        if unsafe:
+            try:
+                __import__(module_name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python object", mark,
+                        "cannot find module %r (%s)" % (module_name, exc), mark)
+        if module_name not in sys.modules:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "module %r is not imported" % module_name, mark)
+        module = sys.modules[module_name]
+        if not hasattr(module, object_name):
+            raise ConstructorError("while constructing a Python object", mark,
+                    "cannot find %r in the module %r"
+                    % (object_name, module.__name__), mark)
+        return getattr(module, object_name)
+
+    def construct_python_name(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python name", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_name(suffix, node.start_mark)
+
+    def construct_python_module(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python module", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_module(suffix, node.start_mark)
+
+    def make_python_instance(self, suffix, node,
+            args=None, kwds=None, newobj=False, unsafe=False):
+        if not args:
+            args = []
+        if not kwds:
+            kwds = {}
+        cls = self.find_python_name(suffix, node.start_mark)
+        if not (unsafe or isinstance(cls, type)):
+            raise ConstructorError("while constructing a Python instance", node.start_mark,
+                    "expected a class, but found %r" % type(cls),
+                    node.start_mark)
+        if newobj and isinstance(cls, type):
+            return cls.__new__(cls, *args, **kwds)
+        else:
+            return cls(*args, **kwds)
+
+    def set_python_instance_state(self, instance, state, unsafe=False):
+        if hasattr(instance, '__setstate__'):
+            instance.__setstate__(state)
+        else:
+            slotstate = {}
+            if isinstance(state, tuple) and len(state) == 2:
+                state, slotstate = state
+            if hasattr(instance, '__dict__'):
+                if not unsafe and state:
+                    for key in state.keys():
+                        self.check_state_key(key)
+                instance.__dict__.update(state)
+            elif state:
+                slotstate.update(state)
+            for key, value in slotstate.items():
+                if not unsafe:
+                    self.check_state_key(key)
+                setattr(instance, key, value)
+
+    def construct_python_object(self, suffix, node):
+        # Format:
+        #   !!python/object:module.name { ... state ... }
+        instance = self.make_python_instance(suffix, node, newobj=True)
+        yield instance
+        deep = hasattr(instance, '__setstate__')
+        state = self.construct_mapping(node, deep=deep)
+        self.set_python_instance_state(instance, state)
+
+    def construct_python_object_apply(self, suffix, node, newobj=False):
+        # Format:
+        #   !!python/object/apply       # (or !!python/object/new)
+        #   args: [ ... arguments ... ]
+        #   kwds: { ... keywords ... }
+        #   state: ... state ...
+        #   listitems: [ ... listitems ... ]
+        #   dictitems: { ... dictitems ... }
+        # or short format:
+        #   !!python/object/apply [ ... arguments ... ]
+        # The difference between !!python/object/apply and !!python/object/new
+        # is how an object is created, check make_python_instance for details.
+        if isinstance(node, SequenceNode):
+            args = self.construct_sequence(node, deep=True)
+            kwds = {}
+            state = {}
+            listitems = []
+            dictitems = {}
+        else:
+            value = self.construct_mapping(node, deep=True)
+            args = value.get('args', [])
+            kwds = value.get('kwds', {})
+            state = value.get('state', {})
+            listitems = value.get('listitems', [])
+            dictitems = value.get('dictitems', {})
+        instance = self.make_python_instance(suffix, node, args, kwds, newobj)
+        if state:
+            self.set_python_instance_state(instance, state)
+        if listitems:
+            instance.extend(listitems)
+        if dictitems:
+            for key in dictitems:
+                instance[key] = dictitems[key]
+        return instance
+
+    def construct_python_object_new(self, suffix, node):
+        return self.construct_python_object_apply(suffix, node, newobj=True)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/none',
+    FullConstructor.construct_yaml_null)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bool',
+    FullConstructor.construct_yaml_bool)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/str',
+    FullConstructor.construct_python_str)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/unicode',
+    FullConstructor.construct_python_unicode)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bytes',
+    FullConstructor.construct_python_bytes)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/int',
+    FullConstructor.construct_yaml_int)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/long',
+    FullConstructor.construct_python_long)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/float',
+    FullConstructor.construct_yaml_float)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/complex',
+    FullConstructor.construct_python_complex)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/list',
+    FullConstructor.construct_yaml_seq)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/tuple',
+    FullConstructor.construct_python_tuple)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/dict',
+    FullConstructor.construct_yaml_map)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/name:',
+    FullConstructor.construct_python_name)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/module:',
+    FullConstructor.construct_python_module)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object:',
+    FullConstructor.construct_python_object)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/new:',
+    FullConstructor.construct_python_object_new)
+
+class UnsafeConstructor(FullConstructor):
+
+    def find_python_module(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_module(name, mark, unsafe=True)
+
+    def find_python_name(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_name(name, mark, unsafe=True)
+
+    def make_python_instance(self, suffix, node, args=None, kwds=None, newobj=False):
+        return super(UnsafeConstructor, self).make_python_instance(
+            suffix, node, args, kwds, newobj, unsafe=True)
+
+    def set_python_instance_state(self, instance, state):
+        return super(UnsafeConstructor, self).set_python_instance_state(
+            instance, state, unsafe=True)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/apply:',
+    UnsafeConstructor.construct_python_object_apply)
+
+# Constructor is same as UnsafeConstructor. Need to leave this in place in case
+# people have extended it directly.
+class Constructor(UnsafeConstructor):
+    pass
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/cyaml.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/cyaml.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e606c74b9470c3ea0db4bd66629af45d28c2b9a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/cyaml.py
@@ -0,0 +1,101 @@
+
+__all__ = [
+    'CBaseLoader', 'CSafeLoader', 'CFullLoader', 'CUnsafeLoader', 'CLoader',
+    'CBaseDumper', 'CSafeDumper', 'CDumper'
+]
+
+from _yaml import CParser, CEmitter
+
+from .constructor import *
+
+from .serializer import *
+from .representer import *
+
+from .resolver import *
+
+class CBaseLoader(CParser, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class CSafeLoader(CParser, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CFullLoader(CParser, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CUnsafeLoader(CParser, UnsafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        UnsafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CLoader(CParser, Constructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+class CBaseDumper(CEmitter, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CSafeDumper(CEmitter, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CDumper(CEmitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/dumper.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/dumper.py
new file mode 100644
index 0000000000000000000000000000000000000000..6aadba551f3836b02f4752277f4b3027073defad
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/dumper.py
@@ -0,0 +1,62 @@
+
+__all__ = ['BaseDumper', 'SafeDumper', 'Dumper']
+
+from .emitter import *
+from .serializer import *
+from .representer import *
+from .resolver import *
+
+class BaseDumper(Emitter, Serializer, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class SafeDumper(Emitter, Serializer, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class Dumper(Emitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/emitter.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/emitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..a664d011162af69184df2f8e59ab7feec818f7c7
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/emitter.py
@@ -0,0 +1,1137 @@
+
+# Emitter expects events obeying the following grammar:
+# stream ::= STREAM-START document* STREAM-END
+# document ::= DOCUMENT-START node DOCUMENT-END
+# node ::= SCALAR | sequence | mapping
+# sequence ::= SEQUENCE-START node* SEQUENCE-END
+# mapping ::= MAPPING-START (node node)* MAPPING-END
+
+__all__ = ['Emitter', 'EmitterError']
+
+from .error import YAMLError
+from .events import *
+
+class EmitterError(YAMLError):
+    pass
+
+class ScalarAnalysis:
+    def __init__(self, scalar, empty, multiline,
+            allow_flow_plain, allow_block_plain,
+            allow_single_quoted, allow_double_quoted,
+            allow_block):
+        self.scalar = scalar
+        self.empty = empty
+        self.multiline = multiline
+        self.allow_flow_plain = allow_flow_plain
+        self.allow_block_plain = allow_block_plain
+        self.allow_single_quoted = allow_single_quoted
+        self.allow_double_quoted = allow_double_quoted
+        self.allow_block = allow_block
+
+class Emitter:
+
+    DEFAULT_TAG_PREFIXES = {
+        '!' : '!',
+        'tag:yaml.org,2002:' : '!!',
+    }
+
+    def __init__(self, stream, canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None):
+
+        # The stream should have the methods `write` and possibly `flush`.
+        self.stream = stream
+
+        # Encoding can be overridden by STREAM-START.
+        self.encoding = None
+
+        # Emitter is a state machine with a stack of states to handle nested
+        # structures.
+        self.states = []
+        self.state = self.expect_stream_start
+
+        # Current event and the event queue.
+        self.events = []
+        self.event = None
+
+        # The current indentation level and the stack of previous indents.
+        self.indents = []
+        self.indent = None
+
+        # Flow level.
+        self.flow_level = 0
+
+        # Contexts.
+        self.root_context = False
+        self.sequence_context = False
+        self.mapping_context = False
+        self.simple_key_context = False
+
+        # Characteristics of the last emitted character:
+        #  - current position.
+        #  - is it a whitespace?
+        #  - is it an indention character
+        #    (indentation space, '-', '?', or ':')?
+        self.line = 0
+        self.column = 0
+        self.whitespace = True
+        self.indention = True
+
+        # Whether the document requires an explicit document indicator
+        self.open_ended = False
+
+        # Formatting details.
+        self.canonical = canonical
+        self.allow_unicode = allow_unicode
+        self.best_indent = 2
+        if indent and 1 < indent < 10:
+            self.best_indent = indent
+        self.best_width = 80
+        if width and width > self.best_indent*2:
+            self.best_width = width
+        self.best_line_break = '\n'
+        if line_break in ['\r', '\n', '\r\n']:
+            self.best_line_break = line_break
+
+        # Tag prefixes.
+        self.tag_prefixes = None
+
+        # Prepared anchor and tag.
+        self.prepared_anchor = None
+        self.prepared_tag = None
+
+        # Scalar analysis and style.
+        self.analysis = None
+        self.style = None
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def emit(self, event):
+        self.events.append(event)
+        while not self.need_more_events():
+            self.event = self.events.pop(0)
+            self.state()
+            self.event = None
+
+    # In some cases, we wait for a few next events before emitting.
+
+    def need_more_events(self):
+        if not self.events:
+            return True
+        event = self.events[0]
+        if isinstance(event, DocumentStartEvent):
+            return self.need_events(1)
+        elif isinstance(event, SequenceStartEvent):
+            return self.need_events(2)
+        elif isinstance(event, MappingStartEvent):
+            return self.need_events(3)
+        else:
+            return False
+
+    def need_events(self, count):
+        level = 0
+        for event in self.events[1:]:
+            if isinstance(event, (DocumentStartEvent, CollectionStartEvent)):
+                level += 1
+            elif isinstance(event, (DocumentEndEvent, CollectionEndEvent)):
+                level -= 1
+            elif isinstance(event, StreamEndEvent):
+                level = -1
+            if level < 0:
+                return False
+        return (len(self.events) < count+1)
+
+    def increase_indent(self, flow=False, indentless=False):
+        self.indents.append(self.indent)
+        if self.indent is None:
+            if flow:
+                self.indent = self.best_indent
+            else:
+                self.indent = 0
+        elif not indentless:
+            self.indent += self.best_indent
+
+    # States.
+
+    # Stream handlers.
+
+    def expect_stream_start(self):
+        if isinstance(self.event, StreamStartEvent):
+            if self.event.encoding and not hasattr(self.stream, 'encoding'):
+                self.encoding = self.event.encoding
+            self.write_stream_start()
+            self.state = self.expect_first_document_start
+        else:
+            raise EmitterError("expected StreamStartEvent, but got %s"
+                    % self.event)
+
+    def expect_nothing(self):
+        raise EmitterError("expected nothing, but got %s" % self.event)
+
+    # Document handlers.
+
+    def expect_first_document_start(self):
+        return self.expect_document_start(first=True)
+
+    def expect_document_start(self, first=False):
+        if isinstance(self.event, DocumentStartEvent):
+            if (self.event.version or self.event.tags) and self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            if self.event.version:
+                version_text = self.prepare_version(self.event.version)
+                self.write_version_directive(version_text)
+            self.tag_prefixes = self.DEFAULT_TAG_PREFIXES.copy()
+            if self.event.tags:
+                handles = sorted(self.event.tags.keys())
+                for handle in handles:
+                    prefix = self.event.tags[handle]
+                    self.tag_prefixes[prefix] = handle
+                    handle_text = self.prepare_tag_handle(handle)
+                    prefix_text = self.prepare_tag_prefix(prefix)
+                    self.write_tag_directive(handle_text, prefix_text)
+            implicit = (first and not self.event.explicit and not self.canonical
+                    and not self.event.version and not self.event.tags
+                    and not self.check_empty_document())
+            if not implicit:
+                self.write_indent()
+                self.write_indicator('---', True)
+                if self.canonical:
+                    self.write_indent()
+            self.state = self.expect_document_root
+        elif isinstance(self.event, StreamEndEvent):
+            if self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.write_stream_end()
+            self.state = self.expect_nothing
+        else:
+            raise EmitterError("expected DocumentStartEvent, but got %s"
+                    % self.event)
+
+    def expect_document_end(self):
+        if isinstance(self.event, DocumentEndEvent):
+            self.write_indent()
+            if self.event.explicit:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.flush_stream()
+            self.state = self.expect_document_start
+        else:
+            raise EmitterError("expected DocumentEndEvent, but got %s"
+                    % self.event)
+
+    def expect_document_root(self):
+        self.states.append(self.expect_document_end)
+        self.expect_node(root=True)
+
+    # Node handlers.
+
+    def expect_node(self, root=False, sequence=False, mapping=False,
+            simple_key=False):
+        self.root_context = root
+        self.sequence_context = sequence
+        self.mapping_context = mapping
+        self.simple_key_context = simple_key
+        if isinstance(self.event, AliasEvent):
+            self.expect_alias()
+        elif isinstance(self.event, (ScalarEvent, CollectionStartEvent)):
+            self.process_anchor('&')
+            self.process_tag()
+            if isinstance(self.event, ScalarEvent):
+                self.expect_scalar()
+            elif isinstance(self.event, SequenceStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_sequence():
+                    self.expect_flow_sequence()
+                else:
+                    self.expect_block_sequence()
+            elif isinstance(self.event, MappingStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_mapping():
+                    self.expect_flow_mapping()
+                else:
+                    self.expect_block_mapping()
+        else:
+            raise EmitterError("expected NodeEvent, but got %s" % self.event)
+
+    def expect_alias(self):
+        if self.event.anchor is None:
+            raise EmitterError("anchor is not specified for alias")
+        self.process_anchor('*')
+        self.state = self.states.pop()
+
+    def expect_scalar(self):
+        self.increase_indent(flow=True)
+        self.process_scalar()
+        self.indent = self.indents.pop()
+        self.state = self.states.pop()
+
+    # Flow sequence handlers.
+
+    def expect_flow_sequence(self):
+        self.write_indicator('[', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_sequence_item
+
+    def expect_first_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    def expect_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Flow mapping handlers.
+
+    def expect_flow_mapping(self):
+        self.write_indicator('{', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_mapping_key
+
+    def expect_first_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_flow_mapping_value(self):
+        if self.canonical or self.column > self.best_width:
+            self.write_indent()
+        self.write_indicator(':', True)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Block sequence handlers.
+
+    def expect_block_sequence(self):
+        indentless = (self.mapping_context and not self.indention)
+        self.increase_indent(flow=False, indentless=indentless)
+        self.state = self.expect_first_block_sequence_item
+
+    def expect_first_block_sequence_item(self):
+        return self.expect_block_sequence_item(first=True)
+
+    def expect_block_sequence_item(self, first=False):
+        if not first and isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            self.write_indicator('-', True, indention=True)
+            self.states.append(self.expect_block_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Block mapping handlers.
+
+    def expect_block_mapping(self):
+        self.increase_indent(flow=False)
+        self.state = self.expect_first_block_mapping_key
+
+    def expect_first_block_mapping_key(self):
+        return self.expect_block_mapping_key(first=True)
+
+    def expect_block_mapping_key(self, first=False):
+        if not first and isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            if self.check_simple_key():
+                self.states.append(self.expect_block_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True, indention=True)
+                self.states.append(self.expect_block_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_block_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_block_mapping_value(self):
+        self.write_indent()
+        self.write_indicator(':', True, indention=True)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Checkers.
+
+    def check_empty_sequence(self):
+        return (isinstance(self.event, SequenceStartEvent) and self.events
+                and isinstance(self.events[0], SequenceEndEvent))
+
+    def check_empty_mapping(self):
+        return (isinstance(self.event, MappingStartEvent) and self.events
+                and isinstance(self.events[0], MappingEndEvent))
+
+    def check_empty_document(self):
+        if not isinstance(self.event, DocumentStartEvent) or not self.events:
+            return False
+        event = self.events[0]
+        return (isinstance(event, ScalarEvent) and event.anchor is None
+                and event.tag is None and event.implicit and event.value == '')
+
+    def check_simple_key(self):
+        length = 0
+        if isinstance(self.event, NodeEvent) and self.event.anchor is not None:
+            if self.prepared_anchor is None:
+                self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+            length += len(self.prepared_anchor)
+        if isinstance(self.event, (ScalarEvent, CollectionStartEvent))  \
+                and self.event.tag is not None:
+            if self.prepared_tag is None:
+                self.prepared_tag = self.prepare_tag(self.event.tag)
+            length += len(self.prepared_tag)
+        if isinstance(self.event, ScalarEvent):
+            if self.analysis is None:
+                self.analysis = self.analyze_scalar(self.event.value)
+            length += len(self.analysis.scalar)
+        return (length < 128 and (isinstance(self.event, AliasEvent)
+            or (isinstance(self.event, ScalarEvent)
+                    and not self.analysis.empty and not self.analysis.multiline)
+            or self.check_empty_sequence() or self.check_empty_mapping()))
+
+    # Anchor, Tag, and Scalar processors.
+
+    def process_anchor(self, indicator):
+        if self.event.anchor is None:
+            self.prepared_anchor = None
+            return
+        if self.prepared_anchor is None:
+            self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+        if self.prepared_anchor:
+            self.write_indicator(indicator+self.prepared_anchor, True)
+        self.prepared_anchor = None
+
+    def process_tag(self):
+        tag = self.event.tag
+        if isinstance(self.event, ScalarEvent):
+            if self.style is None:
+                self.style = self.choose_scalar_style()
+            if ((not self.canonical or tag is None) and
+                ((self.style == '' and self.event.implicit[0])
+                        or (self.style != '' and self.event.implicit[1]))):
+                self.prepared_tag = None
+                return
+            if self.event.implicit[0] and tag is None:
+                tag = '!'
+                self.prepared_tag = None
+        else:
+            if (not self.canonical or tag is None) and self.event.implicit:
+                self.prepared_tag = None
+                return
+        if tag is None:
+            raise EmitterError("tag is not specified")
+        if self.prepared_tag is None:
+            self.prepared_tag = self.prepare_tag(tag)
+        if self.prepared_tag:
+            self.write_indicator(self.prepared_tag, True)
+        self.prepared_tag = None
+
+    def choose_scalar_style(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.event.style == '"' or self.canonical:
+            return '"'
+        if not self.event.style and self.event.implicit[0]:
+            if (not (self.simple_key_context and
+                    (self.analysis.empty or self.analysis.multiline))
+                and (self.flow_level and self.analysis.allow_flow_plain
+                    or (not self.flow_level and self.analysis.allow_block_plain))):
+                return ''
+        if self.event.style and self.event.style in '|>':
+            if (not self.flow_level and not self.simple_key_context
+                    and self.analysis.allow_block):
+                return self.event.style
+        if not self.event.style or self.event.style == '\'':
+            if (self.analysis.allow_single_quoted and
+                    not (self.simple_key_context and self.analysis.multiline)):
+                return '\''
+        return '"'
+
+    def process_scalar(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.style is None:
+            self.style = self.choose_scalar_style()
+        split = (not self.simple_key_context)
+        #if self.analysis.multiline and split    \
+        #        and (not self.style or self.style in '\'\"'):
+        #    self.write_indent()
+        if self.style == '"':
+            self.write_double_quoted(self.analysis.scalar, split)
+        elif self.style == '\'':
+            self.write_single_quoted(self.analysis.scalar, split)
+        elif self.style == '>':
+            self.write_folded(self.analysis.scalar)
+        elif self.style == '|':
+            self.write_literal(self.analysis.scalar)
+        else:
+            self.write_plain(self.analysis.scalar, split)
+        self.analysis = None
+        self.style = None
+
+    # Analyzers.
+
+    def prepare_version(self, version):
+        major, minor = version
+        if major != 1:
+            raise EmitterError("unsupported YAML version: %d.%d" % (major, minor))
+        return '%d.%d' % (major, minor)
+
+    def prepare_tag_handle(self, handle):
+        if not handle:
+            raise EmitterError("tag handle must not be empty")
+        if handle[0] != '!' or handle[-1] != '!':
+            raise EmitterError("tag handle must start and end with '!': %r" % handle)
+        for ch in handle[1:-1]:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the tag handle: %r"
+                        % (ch, handle))
+        return handle
+
+    def prepare_tag_prefix(self, prefix):
+        if not prefix:
+            raise EmitterError("tag prefix must not be empty")
+        chunks = []
+        start = end = 0
+        if prefix[0] == '!':
+            end = 1
+        while end < len(prefix):
+            ch = prefix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?!:@&=+$,_.~*\'()[]':
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(prefix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ord(ch))
+        if start < end:
+            chunks.append(prefix[start:end])
+        return ''.join(chunks)
+
+    def prepare_tag(self, tag):
+        if not tag:
+            raise EmitterError("tag must not be empty")
+        if tag == '!':
+            return tag
+        handle = None
+        suffix = tag
+        prefixes = sorted(self.tag_prefixes.keys())
+        for prefix in prefixes:
+            if tag.startswith(prefix)   \
+                    and (prefix == '!' or len(prefix) < len(tag)):
+                handle = self.tag_prefixes[prefix]
+                suffix = tag[len(prefix):]
+        chunks = []
+        start = end = 0
+        while end < len(suffix):
+            ch = suffix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?:@&=+$,_.~*\'()[]'   \
+                    or (ch == '!' and handle != '!'):
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(suffix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ch)
+        if start < end:
+            chunks.append(suffix[start:end])
+        suffix_text = ''.join(chunks)
+        if handle:
+            return '%s%s' % (handle, suffix_text)
+        else:
+            return '!<%s>' % suffix_text
+
+    def prepare_anchor(self, anchor):
+        if not anchor:
+            raise EmitterError("anchor must not be empty")
+        for ch in anchor:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the anchor: %r"
+                        % (ch, anchor))
+        return anchor
+
+    def analyze_scalar(self, scalar):
+
+        # Empty scalar is a special case.
+        if not scalar:
+            return ScalarAnalysis(scalar=scalar, empty=True, multiline=False,
+                    allow_flow_plain=False, allow_block_plain=True,
+                    allow_single_quoted=True, allow_double_quoted=True,
+                    allow_block=False)
+
+        # Indicators and special characters.
+        block_indicators = False
+        flow_indicators = False
+        line_breaks = False
+        special_characters = False
+
+        # Important whitespace combinations.
+        leading_space = False
+        leading_break = False
+        trailing_space = False
+        trailing_break = False
+        break_space = False
+        space_break = False
+
+        # Check document indicators.
+        if scalar.startswith('---') or scalar.startswith('...'):
+            block_indicators = True
+            flow_indicators = True
+
+        # First character or preceded by a whitespace.
+        preceded_by_whitespace = True
+
+        # Last character or followed by a whitespace.
+        followed_by_whitespace = (len(scalar) == 1 or
+                scalar[1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # The previous character is a space.
+        previous_space = False
+
+        # The previous character is a break.
+        previous_break = False
+
+        index = 0
+        while index < len(scalar):
+            ch = scalar[index]
+
+            # Check for indicators.
+            if index == 0:
+                # Leading indicators are special characters.
+                if ch in '#,[]{}&*!|>\'\"%@`':
+                    flow_indicators = True
+                    block_indicators = True
+                if ch in '?:':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '-' and followed_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+            else:
+                # Some indicators cannot appear within a scalar as well.
+                if ch in ',?[]{}':
+                    flow_indicators = True
+                if ch == ':':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '#' and preceded_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+
+            # Check for line breaks, special, and unicode characters.
+            if ch in '\n\x85\u2028\u2029':
+                line_breaks = True
+            if not (ch == '\n' or '\x20' <= ch <= '\x7E'):
+                if (ch == '\x85' or '\xA0' <= ch <= '\uD7FF'
+                        or '\uE000' <= ch <= '\uFFFD'
+                        or '\U00010000' <= ch < '\U0010ffff') and ch != '\uFEFF':
+                    unicode_characters = True
+                    if not self.allow_unicode:
+                        special_characters = True
+                else:
+                    special_characters = True
+
+            # Detect important whitespace combinations.
+            if ch == ' ':
+                if index == 0:
+                    leading_space = True
+                if index == len(scalar)-1:
+                    trailing_space = True
+                if previous_break:
+                    break_space = True
+                previous_space = True
+                previous_break = False
+            elif ch in '\n\x85\u2028\u2029':
+                if index == 0:
+                    leading_break = True
+                if index == len(scalar)-1:
+                    trailing_break = True
+                if previous_space:
+                    space_break = True
+                previous_space = False
+                previous_break = True
+            else:
+                previous_space = False
+                previous_break = False
+
+            # Prepare for the next character.
+            index += 1
+            preceded_by_whitespace = (ch in '\0 \t\r\n\x85\u2028\u2029')
+            followed_by_whitespace = (index+1 >= len(scalar) or
+                    scalar[index+1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # Let's decide what styles are allowed.
+        allow_flow_plain = True
+        allow_block_plain = True
+        allow_single_quoted = True
+        allow_double_quoted = True
+        allow_block = True
+
+        # Leading and trailing whitespaces are bad for plain scalars.
+        if (leading_space or leading_break
+                or trailing_space or trailing_break):
+            allow_flow_plain = allow_block_plain = False
+
+        # We do not permit trailing spaces for block scalars.
+        if trailing_space:
+            allow_block = False
+
+        # Spaces at the beginning of a new line are only acceptable for block
+        # scalars.
+        if break_space:
+            allow_flow_plain = allow_block_plain = allow_single_quoted = False
+
+        # Spaces followed by breaks, as well as special character are only
+        # allowed for double quoted scalars.
+        if space_break or special_characters:
+            allow_flow_plain = allow_block_plain =  \
+            allow_single_quoted = allow_block = False
+
+        # Although the plain scalar writer supports breaks, we never emit
+        # multiline plain scalars.
+        if line_breaks:
+            allow_flow_plain = allow_block_plain = False
+
+        # Flow indicators are forbidden for flow plain scalars.
+        if flow_indicators:
+            allow_flow_plain = False
+
+        # Block indicators are forbidden for block plain scalars.
+        if block_indicators:
+            allow_block_plain = False
+
+        return ScalarAnalysis(scalar=scalar,
+                empty=False, multiline=line_breaks,
+                allow_flow_plain=allow_flow_plain,
+                allow_block_plain=allow_block_plain,
+                allow_single_quoted=allow_single_quoted,
+                allow_double_quoted=allow_double_quoted,
+                allow_block=allow_block)
+
+    # Writers.
+
+    def flush_stream(self):
+        if hasattr(self.stream, 'flush'):
+            self.stream.flush()
+
+    def write_stream_start(self):
+        # Write BOM if needed.
+        if self.encoding and self.encoding.startswith('utf-16'):
+            self.stream.write('\uFEFF'.encode(self.encoding))
+
+    def write_stream_end(self):
+        self.flush_stream()
+
+    def write_indicator(self, indicator, need_whitespace,
+            whitespace=False, indention=False):
+        if self.whitespace or not need_whitespace:
+            data = indicator
+        else:
+            data = ' '+indicator
+        self.whitespace = whitespace
+        self.indention = self.indention and indention
+        self.column += len(data)
+        self.open_ended = False
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_indent(self):
+        indent = self.indent or 0
+        if not self.indention or self.column > indent   \
+                or (self.column == indent and not self.whitespace):
+            self.write_line_break()
+        if self.column < indent:
+            self.whitespace = True
+            data = ' '*(indent-self.column)
+            self.column = indent
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+
+    def write_line_break(self, data=None):
+        if data is None:
+            data = self.best_line_break
+        self.whitespace = True
+        self.indention = True
+        self.line += 1
+        self.column = 0
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_version_directive(self, version_text):
+        data = '%%YAML %s' % version_text
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    def write_tag_directive(self, handle_text, prefix_text):
+        data = '%%TAG %s %s' % (handle_text, prefix_text)
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    # Scalar streams.
+
+    def write_single_quoted(self, text, split=True):
+        self.write_indicator('\'', True)
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch is None or ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split   \
+                            and start != 0 and end != len(text):
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029' or ch == '\'':
+                    if start < end:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                        start = end
+            if ch == '\'':
+                data = '\'\''
+                self.column += 2
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                start = end + 1
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+        self.write_indicator('\'', False)
+
+    ESCAPE_REPLACEMENTS = {
+        '\0':       '0',
+        '\x07':     'a',
+        '\x08':     'b',
+        '\x09':     't',
+        '\x0A':     'n',
+        '\x0B':     'v',
+        '\x0C':     'f',
+        '\x0D':     'r',
+        '\x1B':     'e',
+        '\"':       '\"',
+        '\\':       '\\',
+        '\x85':     'N',
+        '\xA0':     '_',
+        '\u2028':   'L',
+        '\u2029':   'P',
+    }
+
+    def write_double_quoted(self, text, split=True):
+        self.write_indicator('"', True)
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if ch is None or ch in '"\\\x85\u2028\u2029\uFEFF' \
+                    or not ('\x20' <= ch <= '\x7E'
+                        or (self.allow_unicode
+                            and ('\xA0' <= ch <= '\uD7FF'
+                                or '\uE000' <= ch <= '\uFFFD'))):
+                if start < end:
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+                if ch is not None:
+                    if ch in self.ESCAPE_REPLACEMENTS:
+                        data = '\\'+self.ESCAPE_REPLACEMENTS[ch]
+                    elif ch <= '\xFF':
+                        data = '\\x%02X' % ord(ch)
+                    elif ch <= '\uFFFF':
+                        data = '\\u%04X' % ord(ch)
+                    else:
+                        data = '\\U%08X' % ord(ch)
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end+1
+            if 0 < end < len(text)-1 and (ch == ' ' or start >= end)    \
+                    and self.column+(end-start) > self.best_width and split:
+                data = text[start:end]+'\\'
+                if start < end:
+                    start = end
+                self.column += len(data)
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                self.write_indent()
+                self.whitespace = False
+                self.indention = False
+                if text[start] == ' ':
+                    data = '\\'
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+            end += 1
+        self.write_indicator('"', False)
+
+    def determine_block_hints(self, text):
+        hints = ''
+        if text:
+            if text[0] in ' \n\x85\u2028\u2029':
+                hints += str(self.best_indent)
+            if text[-1] not in '\n\x85\u2028\u2029':
+                hints += '-'
+            elif len(text) == 1 or text[-2] in '\n\x85\u2028\u2029':
+                hints += '+'
+        return hints
+
+    def write_folded(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('>'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        leading_space = True
+        spaces = False
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if not leading_space and ch is not None and ch != ' '   \
+                            and text[start] == '\n':
+                        self.write_line_break()
+                    leading_space = (ch == ' ')
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            elif spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width:
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+                spaces = (ch == ' ')
+            end += 1
+
+    def write_literal(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('|'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in '\n\x85\u2028\u2029':
+                    data = text[start:end]
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+
+    def write_plain(self, text, split=True):
+        if self.root_context:
+            self.open_ended = True
+        if not text:
+            return
+        if not self.whitespace:
+            data = ' '
+            self.column += len(data)
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+        self.whitespace = False
+        self.indention = False
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split:
+                        self.write_indent()
+                        self.whitespace = False
+                        self.indention = False
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    self.whitespace = False
+                    self.indention = False
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/error.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/error.py
new file mode 100644
index 0000000000000000000000000000000000000000..b796b4dc519512c4825ff539a2e6aa20f4d370d0
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/error.py
@@ -0,0 +1,75 @@
+
+__all__ = ['Mark', 'YAMLError', 'MarkedYAMLError']
+
+class Mark:
+
+    def __init__(self, name, index, line, column, buffer, pointer):
+        self.name = name
+        self.index = index
+        self.line = line
+        self.column = column
+        self.buffer = buffer
+        self.pointer = pointer
+
+    def get_snippet(self, indent=4, max_length=75):
+        if self.buffer is None:
+            return None
+        head = ''
+        start = self.pointer
+        while start > 0 and self.buffer[start-1] not in '\0\r\n\x85\u2028\u2029':
+            start -= 1
+            if self.pointer-start > max_length/2-1:
+                head = ' ... '
+                start += 5
+                break
+        tail = ''
+        end = self.pointer
+        while end < len(self.buffer) and self.buffer[end] not in '\0\r\n\x85\u2028\u2029':
+            end += 1
+            if end-self.pointer > max_length/2-1:
+                tail = ' ... '
+                end -= 5
+                break
+        snippet = self.buffer[start:end]
+        return ' '*indent + head + snippet + tail + '\n'  \
+                + ' '*(indent+self.pointer-start+len(head)) + '^'
+
+    def __str__(self):
+        snippet = self.get_snippet()
+        where = "  in \"%s\", line %d, column %d"   \
+                % (self.name, self.line+1, self.column+1)
+        if snippet is not None:
+            where += ":\n"+snippet
+        return where
+
+class YAMLError(Exception):
+    pass
+
+class MarkedYAMLError(YAMLError):
+
+    def __init__(self, context=None, context_mark=None,
+            problem=None, problem_mark=None, note=None):
+        self.context = context
+        self.context_mark = context_mark
+        self.problem = problem
+        self.problem_mark = problem_mark
+        self.note = note
+
+    def __str__(self):
+        lines = []
+        if self.context is not None:
+            lines.append(self.context)
+        if self.context_mark is not None  \
+            and (self.problem is None or self.problem_mark is None
+                    or self.context_mark.name != self.problem_mark.name
+                    or self.context_mark.line != self.problem_mark.line
+                    or self.context_mark.column != self.problem_mark.column):
+            lines.append(str(self.context_mark))
+        if self.problem is not None:
+            lines.append(self.problem)
+        if self.problem_mark is not None:
+            lines.append(str(self.problem_mark))
+        if self.note is not None:
+            lines.append(self.note)
+        return '\n'.join(lines)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/events.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/events.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79ad389cb6c9517e391dcd25534866bc9ccd36a
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/events.py
@@ -0,0 +1,86 @@
+
+# Abstract classes.
+
+class Event(object):
+    def __init__(self, start_mark=None, end_mark=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in ['anchor', 'tag', 'implicit', 'value']
+                if hasattr(self, key)]
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+class NodeEvent(Event):
+    def __init__(self, anchor, start_mark=None, end_mark=None):
+        self.anchor = anchor
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class CollectionStartEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, start_mark=None, end_mark=None,
+            flow_style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class CollectionEndEvent(Event):
+    pass
+
+# Implementations.
+
+class StreamStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None, encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndEvent(Event):
+    pass
+
+class DocumentStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None, version=None, tags=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+        self.version = version
+        self.tags = tags
+
+class DocumentEndEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+
+class AliasEvent(NodeEvent):
+    pass
+
+class ScalarEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, value,
+            start_mark=None, end_mark=None, style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class SequenceStartEvent(CollectionStartEvent):
+    pass
+
+class SequenceEndEvent(CollectionEndEvent):
+    pass
+
+class MappingStartEvent(CollectionStartEvent):
+    pass
+
+class MappingEndEvent(CollectionEndEvent):
+    pass
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/loader.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..e90c11224c38e559cdf0cb205f0692ebd4fb8681
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/loader.py
@@ -0,0 +1,63 @@
+
+__all__ = ['BaseLoader', 'FullLoader', 'SafeLoader', 'Loader', 'UnsafeLoader']
+
+from .reader import *
+from .scanner import *
+from .parser import *
+from .composer import *
+from .constructor import *
+from .resolver import *
+
+class BaseLoader(Reader, Scanner, Parser, Composer, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class FullLoader(Reader, Scanner, Parser, Composer, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class SafeLoader(Reader, Scanner, Parser, Composer, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class Loader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+# UnsafeLoader is the same as Loader (which is and was always unsafe on
+# untrusted input). Use of either Loader or UnsafeLoader should be rare, since
+# FullLoad should be able to load almost all YAML safely. Loader is left intact
+# to ensure backwards compatibility.
+class UnsafeLoader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/nodes.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4f070c41e1fb1bc01af27d69329e92dded38908
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/nodes.py
@@ -0,0 +1,49 @@
+
+class Node(object):
+    def __init__(self, tag, value, start_mark, end_mark):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        value = self.value
+        #if isinstance(value, list):
+        #    if len(value) == 0:
+        #        value = '<empty>'
+        #    elif len(value) == 1:
+        #        value = '<1 item>'
+        #    else:
+        #        value = '<%d items>' % len(value)
+        #else:
+        #    if len(value) > 75:
+        #        value = repr(value[:70]+u' ... ')
+        #    else:
+        #        value = repr(value)
+        value = repr(value)
+        return '%s(tag=%r, value=%s)' % (self.__class__.__name__, self.tag, value)
+
+class ScalarNode(Node):
+    id = 'scalar'
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class CollectionNode(Node):
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, flow_style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class SequenceNode(CollectionNode):
+    id = 'sequence'
+
+class MappingNode(CollectionNode):
+    id = 'mapping'
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/parser.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..13a5995d292045d0f865a99abf692bd35dc87814
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/parser.py
@@ -0,0 +1,589 @@
+
+# The following YAML grammar is LL(1) and is parsed by a recursive descent
+# parser.
+#
+# stream            ::= STREAM-START implicit_document? explicit_document* STREAM-END
+# implicit_document ::= block_node DOCUMENT-END*
+# explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+# block_node_or_indentless_sequence ::=
+#                       ALIAS
+#                       | properties (block_content | indentless_block_sequence)?
+#                       | block_content
+#                       | indentless_block_sequence
+# block_node        ::= ALIAS
+#                       | properties block_content?
+#                       | block_content
+# flow_node         ::= ALIAS
+#                       | properties flow_content?
+#                       | flow_content
+# properties        ::= TAG ANCHOR? | ANCHOR TAG?
+# block_content     ::= block_collection | flow_collection | SCALAR
+# flow_content      ::= flow_collection | SCALAR
+# block_collection  ::= block_sequence | block_mapping
+# flow_collection   ::= flow_sequence | flow_mapping
+# block_sequence    ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+# indentless_sequence   ::= (BLOCK-ENTRY block_node?)+
+# block_mapping     ::= BLOCK-MAPPING_START
+#                       ((KEY block_node_or_indentless_sequence?)?
+#                       (VALUE block_node_or_indentless_sequence?)?)*
+#                       BLOCK-END
+# flow_sequence     ::= FLOW-SEQUENCE-START
+#                       (flow_sequence_entry FLOW-ENTRY)*
+#                       flow_sequence_entry?
+#                       FLOW-SEQUENCE-END
+# flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+# flow_mapping      ::= FLOW-MAPPING-START
+#                       (flow_mapping_entry FLOW-ENTRY)*
+#                       flow_mapping_entry?
+#                       FLOW-MAPPING-END
+# flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+#
+# FIRST sets:
+#
+# stream: { STREAM-START }
+# explicit_document: { DIRECTIVE DOCUMENT-START }
+# implicit_document: FIRST(block_node)
+# block_node: { ALIAS TAG ANCHOR SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_node: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_content: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# flow_content: { FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# block_collection: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_sequence: { BLOCK-SEQUENCE-START }
+# block_mapping: { BLOCK-MAPPING-START }
+# block_node_or_indentless_sequence: { ALIAS ANCHOR TAG SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START BLOCK-ENTRY }
+# indentless_sequence: { ENTRY }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_sequence: { FLOW-SEQUENCE-START }
+# flow_mapping: { FLOW-MAPPING-START }
+# flow_sequence_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+# flow_mapping_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+
+__all__ = ['Parser', 'ParserError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+from .events import *
+from .scanner import *
+
+class ParserError(MarkedYAMLError):
+    pass
+
+class Parser:
+    # Since writing a recursive-descendant parser is a straightforward task, we
+    # do not give many comments here.
+
+    DEFAULT_TAGS = {
+        '!':   '!',
+        '!!':  'tag:yaml.org,2002:',
+    }
+
+    def __init__(self):
+        self.current_event = None
+        self.yaml_version = None
+        self.tag_handles = {}
+        self.states = []
+        self.marks = []
+        self.state = self.parse_stream_start
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def check_event(self, *choices):
+        # Check the type of the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        if self.current_event is not None:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.current_event, choice):
+                    return True
+        return False
+
+    def peek_event(self):
+        # Get the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        return self.current_event
+
+    def get_event(self):
+        # Get the next event and proceed further.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        value = self.current_event
+        self.current_event = None
+        return value
+
+    # stream    ::= STREAM-START implicit_document? explicit_document* STREAM-END
+    # implicit_document ::= block_node DOCUMENT-END*
+    # explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+
+    def parse_stream_start(self):
+
+        # Parse the stream start.
+        token = self.get_token()
+        event = StreamStartEvent(token.start_mark, token.end_mark,
+                encoding=token.encoding)
+
+        # Prepare the next state.
+        self.state = self.parse_implicit_document_start
+
+        return event
+
+    def parse_implicit_document_start(self):
+
+        # Parse an implicit document.
+        if not self.check_token(DirectiveToken, DocumentStartToken,
+                StreamEndToken):
+            self.tag_handles = self.DEFAULT_TAGS
+            token = self.peek_token()
+            start_mark = end_mark = token.start_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=False)
+
+            # Prepare the next state.
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_block_node
+
+            return event
+
+        else:
+            return self.parse_document_start()
+
+    def parse_document_start(self):
+
+        # Parse any extra document end indicators.
+        while self.check_token(DocumentEndToken):
+            self.get_token()
+
+        # Parse an explicit document.
+        if not self.check_token(StreamEndToken):
+            token = self.peek_token()
+            start_mark = token.start_mark
+            version, tags = self.process_directives()
+            if not self.check_token(DocumentStartToken):
+                raise ParserError(None, None,
+                        "expected '<document start>', but found %r"
+                        % self.peek_token().id,
+                        self.peek_token().start_mark)
+            token = self.get_token()
+            end_mark = token.end_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=True, version=version, tags=tags)
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_document_content
+        else:
+            # Parse the end of the stream.
+            token = self.get_token()
+            event = StreamEndEvent(token.start_mark, token.end_mark)
+            assert not self.states
+            assert not self.marks
+            self.state = None
+        return event
+
+    def parse_document_end(self):
+
+        # Parse the document end.
+        token = self.peek_token()
+        start_mark = end_mark = token.start_mark
+        explicit = False
+        if self.check_token(DocumentEndToken):
+            token = self.get_token()
+            end_mark = token.end_mark
+            explicit = True
+        event = DocumentEndEvent(start_mark, end_mark,
+                explicit=explicit)
+
+        # Prepare the next state.
+        self.state = self.parse_document_start
+
+        return event
+
+    def parse_document_content(self):
+        if self.check_token(DirectiveToken,
+                DocumentStartToken, DocumentEndToken, StreamEndToken):
+            event = self.process_empty_scalar(self.peek_token().start_mark)
+            self.state = self.states.pop()
+            return event
+        else:
+            return self.parse_block_node()
+
+    def process_directives(self):
+        self.yaml_version = None
+        self.tag_handles = {}
+        while self.check_token(DirectiveToken):
+            token = self.get_token()
+            if token.name == 'YAML':
+                if self.yaml_version is not None:
+                    raise ParserError(None, None,
+                            "found duplicate YAML directive", token.start_mark)
+                major, minor = token.value
+                if major != 1:
+                    raise ParserError(None, None,
+                            "found incompatible YAML document (version 1.* is required)",
+                            token.start_mark)
+                self.yaml_version = token.value
+            elif token.name == 'TAG':
+                handle, prefix = token.value
+                if handle in self.tag_handles:
+                    raise ParserError(None, None,
+                            "duplicate tag handle %r" % handle,
+                            token.start_mark)
+                self.tag_handles[handle] = prefix
+        if self.tag_handles:
+            value = self.yaml_version, self.tag_handles.copy()
+        else:
+            value = self.yaml_version, None
+        for key in self.DEFAULT_TAGS:
+            if key not in self.tag_handles:
+                self.tag_handles[key] = self.DEFAULT_TAGS[key]
+        return value
+
+    # block_node_or_indentless_sequence ::= ALIAS
+    #               | properties (block_content | indentless_block_sequence)?
+    #               | block_content
+    #               | indentless_block_sequence
+    # block_node    ::= ALIAS
+    #                   | properties block_content?
+    #                   | block_content
+    # flow_node     ::= ALIAS
+    #                   | properties flow_content?
+    #                   | flow_content
+    # properties    ::= TAG ANCHOR? | ANCHOR TAG?
+    # block_content     ::= block_collection | flow_collection | SCALAR
+    # flow_content      ::= flow_collection | SCALAR
+    # block_collection  ::= block_sequence | block_mapping
+    # flow_collection   ::= flow_sequence | flow_mapping
+
+    def parse_block_node(self):
+        return self.parse_node(block=True)
+
+    def parse_flow_node(self):
+        return self.parse_node()
+
+    def parse_block_node_or_indentless_sequence(self):
+        return self.parse_node(block=True, indentless_sequence=True)
+
+    def parse_node(self, block=False, indentless_sequence=False):
+        if self.check_token(AliasToken):
+            token = self.get_token()
+            event = AliasEvent(token.value, token.start_mark, token.end_mark)
+            self.state = self.states.pop()
+        else:
+            anchor = None
+            tag = None
+            start_mark = end_mark = tag_mark = None
+            if self.check_token(AnchorToken):
+                token = self.get_token()
+                start_mark = token.start_mark
+                end_mark = token.end_mark
+                anchor = token.value
+                if self.check_token(TagToken):
+                    token = self.get_token()
+                    tag_mark = token.start_mark
+                    end_mark = token.end_mark
+                    tag = token.value
+            elif self.check_token(TagToken):
+                token = self.get_token()
+                start_mark = tag_mark = token.start_mark
+                end_mark = token.end_mark
+                tag = token.value
+                if self.check_token(AnchorToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    anchor = token.value
+            if tag is not None:
+                handle, suffix = tag
+                if handle is not None:
+                    if handle not in self.tag_handles:
+                        raise ParserError("while parsing a node", start_mark,
+                                "found undefined tag handle %r" % handle,
+                                tag_mark)
+                    tag = self.tag_handles[handle]+suffix
+                else:
+                    tag = suffix
+            #if tag == '!':
+            #    raise ParserError("while parsing a node", start_mark,
+            #            "found non-specific tag '!'", tag_mark,
+            #            "Please check 'http://pyyaml.org/wiki/YAMLNonSpecificTag' and share your opinion.")
+            if start_mark is None:
+                start_mark = end_mark = self.peek_token().start_mark
+            event = None
+            implicit = (tag is None or tag == '!')
+            if indentless_sequence and self.check_token(BlockEntryToken):
+                end_mark = self.peek_token().end_mark
+                event = SequenceStartEvent(anchor, tag, implicit,
+                        start_mark, end_mark)
+                self.state = self.parse_indentless_sequence_entry
+            else:
+                if self.check_token(ScalarToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    if (token.plain and tag is None) or tag == '!':
+                        implicit = (True, False)
+                    elif tag is None:
+                        implicit = (False, True)
+                    else:
+                        implicit = (False, False)
+                    event = ScalarEvent(anchor, tag, implicit, token.value,
+                            start_mark, end_mark, style=token.style)
+                    self.state = self.states.pop()
+                elif self.check_token(FlowSequenceStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_sequence_first_entry
+                elif self.check_token(FlowMappingStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_mapping_first_key
+                elif block and self.check_token(BlockSequenceStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_sequence_first_entry
+                elif block and self.check_token(BlockMappingStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_mapping_first_key
+                elif anchor is not None or tag is not None:
+                    # Empty scalars are allowed even if a tag or an anchor is
+                    # specified.
+                    event = ScalarEvent(anchor, tag, (implicit, False), '',
+                            start_mark, end_mark)
+                    self.state = self.states.pop()
+                else:
+                    if block:
+                        node = 'block'
+                    else:
+                        node = 'flow'
+                    token = self.peek_token()
+                    raise ParserError("while parsing a %s node" % node, start_mark,
+                            "expected the node content, but found %r" % token.id,
+                            token.start_mark)
+        return event
+
+    # block_sequence ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+
+    def parse_block_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_sequence_entry()
+
+    def parse_block_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken, BlockEndToken):
+                self.states.append(self.parse_block_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_block_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block collection", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    # indentless_sequence ::= (BLOCK-ENTRY block_node?)+
+
+    def parse_indentless_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken,
+                    KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_indentless_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_indentless_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        token = self.peek_token()
+        event = SequenceEndEvent(token.start_mark, token.start_mark)
+        self.state = self.states.pop()
+        return event
+
+    # block_mapping     ::= BLOCK-MAPPING_START
+    #                       ((KEY block_node_or_indentless_sequence?)?
+    #                       (VALUE block_node_or_indentless_sequence?)?)*
+    #                       BLOCK-END
+
+    def parse_block_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_mapping_key()
+
+    def parse_block_mapping_key(self):
+        if self.check_token(KeyToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_value)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_value
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block mapping", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_block_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_key)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_block_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    # flow_sequence     ::= FLOW-SEQUENCE-START
+    #                       (flow_sequence_entry FLOW-ENTRY)*
+    #                       flow_sequence_entry?
+    #                       FLOW-SEQUENCE-END
+    # flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+    #
+    # Note that while production rules for both flow_sequence_entry and
+    # flow_mapping_entry are equal, their interpretations are different.
+    # For `flow_sequence_entry`, the part `KEY flow_node? (VALUE flow_node?)?`
+    # generate an inline mapping (set syntax).
+
+    def parse_flow_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_sequence_entry(first=True)
+
+    def parse_flow_sequence_entry(self, first=False):
+        if not self.check_token(FlowSequenceEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow sequence", self.marks[-1],
+                            "expected ',' or ']', but got %r" % token.id, token.start_mark)
+            
+            if self.check_token(KeyToken):
+                token = self.peek_token()
+                event = MappingStartEvent(None, None, True,
+                        token.start_mark, token.end_mark,
+                        flow_style=True)
+                self.state = self.parse_flow_sequence_entry_mapping_key
+                return event
+            elif not self.check_token(FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_sequence_entry_mapping_key(self):
+        token = self.get_token()
+        if not self.check_token(ValueToken,
+                FlowEntryToken, FlowSequenceEndToken):
+            self.states.append(self.parse_flow_sequence_entry_mapping_value)
+            return self.parse_flow_node()
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_value
+            return self.process_empty_scalar(token.end_mark)
+
+    def parse_flow_sequence_entry_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry_mapping_end)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_sequence_entry_mapping_end
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_end
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_sequence_entry_mapping_end(self):
+        self.state = self.parse_flow_sequence_entry
+        token = self.peek_token()
+        return MappingEndEvent(token.start_mark, token.start_mark)
+
+    # flow_mapping  ::= FLOW-MAPPING-START
+    #                   (flow_mapping_entry FLOW-ENTRY)*
+    #                   flow_mapping_entry?
+    #                   FLOW-MAPPING-END
+    # flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+
+    def parse_flow_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_mapping_key(first=True)
+
+    def parse_flow_mapping_key(self, first=False):
+        if not self.check_token(FlowMappingEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow mapping", self.marks[-1],
+                            "expected ',' or '}', but got %r" % token.id, token.start_mark)
+            if self.check_token(KeyToken):
+                token = self.get_token()
+                if not self.check_token(ValueToken,
+                        FlowEntryToken, FlowMappingEndToken):
+                    self.states.append(self.parse_flow_mapping_value)
+                    return self.parse_flow_node()
+                else:
+                    self.state = self.parse_flow_mapping_value
+                    return self.process_empty_scalar(token.end_mark)
+            elif not self.check_token(FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_empty_value)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_key)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_mapping_empty_value(self):
+        self.state = self.parse_flow_mapping_key
+        return self.process_empty_scalar(self.peek_token().start_mark)
+
+    def process_empty_scalar(self, mark):
+        return ScalarEvent(None, None, (True, False), '', mark, mark)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/reader.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/reader.py
new file mode 100644
index 0000000000000000000000000000000000000000..774b0219b5932a0ee1c27e637371de5ba8d9cb16
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/reader.py
@@ -0,0 +1,185 @@
+# This module contains abstractions for the input stream. You don't have to
+# looks further, there are no pretty code.
+#
+# We define two classes here.
+#
+#   Mark(source, line, column)
+# It's just a record and its only use is producing nice error messages.
+# Parser does not use it for any other purposes.
+#
+#   Reader(source, data)
+# Reader determines the encoding of `data` and converts it to unicode.
+# Reader provides the following methods and attributes:
+#   reader.peek(length=1) - return the next `length` characters
+#   reader.forward(length=1) - move the current position to `length` characters.
+#   reader.index - the number of the current character.
+#   reader.line, stream.column - the line and the column of the current character.
+
+__all__ = ['Reader', 'ReaderError']
+
+from .error import YAMLError, Mark
+
+import codecs, re
+
+class ReaderError(YAMLError):
+
+    def __init__(self, name, position, character, encoding, reason):
+        self.name = name
+        self.character = character
+        self.position = position
+        self.encoding = encoding
+        self.reason = reason
+
+    def __str__(self):
+        if isinstance(self.character, bytes):
+            return "'%s' codec can't decode byte #x%02x: %s\n"  \
+                    "  in \"%s\", position %d"    \
+                    % (self.encoding, ord(self.character), self.reason,
+                            self.name, self.position)
+        else:
+            return "unacceptable character #x%04x: %s\n"    \
+                    "  in \"%s\", position %d"    \
+                    % (self.character, self.reason,
+                            self.name, self.position)
+
+class Reader(object):
+    # Reader:
+    # - determines the data encoding and converts it to a unicode string,
+    # - checks if characters are in allowed range,
+    # - adds '\0' to the end.
+
+    # Reader accepts
+    #  - a `bytes` object,
+    #  - a `str` object,
+    #  - a file-like object with its `read` method returning `str`,
+    #  - a file-like object with its `read` method returning `unicode`.
+
+    # Yeah, it's ugly and slow.
+
+    def __init__(self, stream):
+        self.name = None
+        self.stream = None
+        self.stream_pointer = 0
+        self.eof = True
+        self.buffer = ''
+        self.pointer = 0
+        self.raw_buffer = None
+        self.raw_decode = None
+        self.encoding = None
+        self.index = 0
+        self.line = 0
+        self.column = 0
+        if isinstance(stream, str):
+            self.name = "<unicode string>"
+            self.check_printable(stream)
+            self.buffer = stream+'\0'
+        elif isinstance(stream, bytes):
+            self.name = "<byte string>"
+            self.raw_buffer = stream
+            self.determine_encoding()
+        else:
+            self.stream = stream
+            self.name = getattr(stream, 'name', "<file>")
+            self.eof = False
+            self.raw_buffer = None
+            self.determine_encoding()
+
+    def peek(self, index=0):
+        try:
+            return self.buffer[self.pointer+index]
+        except IndexError:
+            self.update(index+1)
+            return self.buffer[self.pointer+index]
+
+    def prefix(self, length=1):
+        if self.pointer+length >= len(self.buffer):
+            self.update(length)
+        return self.buffer[self.pointer:self.pointer+length]
+
+    def forward(self, length=1):
+        if self.pointer+length+1 >= len(self.buffer):
+            self.update(length+1)
+        while length:
+            ch = self.buffer[self.pointer]
+            self.pointer += 1
+            self.index += 1
+            if ch in '\n\x85\u2028\u2029'  \
+                    or (ch == '\r' and self.buffer[self.pointer] != '\n'):
+                self.line += 1
+                self.column = 0
+            elif ch != '\uFEFF':
+                self.column += 1
+            length -= 1
+
+    def get_mark(self):
+        if self.stream is None:
+            return Mark(self.name, self.index, self.line, self.column,
+                    self.buffer, self.pointer)
+        else:
+            return Mark(self.name, self.index, self.line, self.column,
+                    None, None)
+
+    def determine_encoding(self):
+        while not self.eof and (self.raw_buffer is None or len(self.raw_buffer) < 2):
+            self.update_raw()
+        if isinstance(self.raw_buffer, bytes):
+            if self.raw_buffer.startswith(codecs.BOM_UTF16_LE):
+                self.raw_decode = codecs.utf_16_le_decode
+                self.encoding = 'utf-16-le'
+            elif self.raw_buffer.startswith(codecs.BOM_UTF16_BE):
+                self.raw_decode = codecs.utf_16_be_decode
+                self.encoding = 'utf-16-be'
+            else:
+                self.raw_decode = codecs.utf_8_decode
+                self.encoding = 'utf-8'
+        self.update(1)
+
+    NON_PRINTABLE = re.compile('[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]')
+    def check_printable(self, data):
+        match = self.NON_PRINTABLE.search(data)
+        if match:
+            character = match.group()
+            position = self.index+(len(self.buffer)-self.pointer)+match.start()
+            raise ReaderError(self.name, position, ord(character),
+                    'unicode', "special characters are not allowed")
+
+    def update(self, length):
+        if self.raw_buffer is None:
+            return
+        self.buffer = self.buffer[self.pointer:]
+        self.pointer = 0
+        while len(self.buffer) < length:
+            if not self.eof:
+                self.update_raw()
+            if self.raw_decode is not None:
+                try:
+                    data, converted = self.raw_decode(self.raw_buffer,
+                            'strict', self.eof)
+                except UnicodeDecodeError as exc:
+                    character = self.raw_buffer[exc.start]
+                    if self.stream is not None:
+                        position = self.stream_pointer-len(self.raw_buffer)+exc.start
+                    else:
+                        position = exc.start
+                    raise ReaderError(self.name, position, character,
+                            exc.encoding, exc.reason)
+            else:
+                data = self.raw_buffer
+                converted = len(data)
+            self.check_printable(data)
+            self.buffer += data
+            self.raw_buffer = self.raw_buffer[converted:]
+            if self.eof:
+                self.buffer += '\0'
+                self.raw_buffer = None
+                break
+
+    def update_raw(self, size=4096):
+        data = self.stream.read(size)
+        if self.raw_buffer is None:
+            self.raw_buffer = data
+        else:
+            self.raw_buffer += data
+        self.stream_pointer += len(data)
+        if not data:
+            self.eof = True
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/representer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/representer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b0b192ef32ed7f5b7015456fe883c3327bb841e
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/representer.py
@@ -0,0 +1,389 @@
+
+__all__ = ['BaseRepresenter', 'SafeRepresenter', 'Representer',
+    'RepresenterError']
+
+from .error import *
+from .nodes import *
+
+import datetime, copyreg, types, base64, collections
+
+class RepresenterError(YAMLError):
+    pass
+
+class BaseRepresenter:
+
+    yaml_representers = {}
+    yaml_multi_representers = {}
+
+    def __init__(self, default_style=None, default_flow_style=False, sort_keys=True):
+        self.default_style = default_style
+        self.sort_keys = sort_keys
+        self.default_flow_style = default_flow_style
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent(self, data):
+        node = self.represent_data(data)
+        self.serialize(node)
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent_data(self, data):
+        if self.ignore_aliases(data):
+            self.alias_key = None
+        else:
+            self.alias_key = id(data)
+        if self.alias_key is not None:
+            if self.alias_key in self.represented_objects:
+                node = self.represented_objects[self.alias_key]
+                #if node is None:
+                #    raise RepresenterError("recursive objects are not allowed: %r" % data)
+                return node
+            #self.represented_objects[alias_key] = None
+            self.object_keeper.append(data)
+        data_types = type(data).__mro__
+        if data_types[0] in self.yaml_representers:
+            node = self.yaml_representers[data_types[0]](self, data)
+        else:
+            for data_type in data_types:
+                if data_type in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[data_type](self, data)
+                    break
+            else:
+                if None in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[None](self, data)
+                elif None in self.yaml_representers:
+                    node = self.yaml_representers[None](self, data)
+                else:
+                    node = ScalarNode(None, str(data))
+        #if alias_key is not None:
+        #    self.represented_objects[alias_key] = node
+        return node
+
+    @classmethod
+    def add_representer(cls, data_type, representer):
+        if not 'yaml_representers' in cls.__dict__:
+            cls.yaml_representers = cls.yaml_representers.copy()
+        cls.yaml_representers[data_type] = representer
+
+    @classmethod
+    def add_multi_representer(cls, data_type, representer):
+        if not 'yaml_multi_representers' in cls.__dict__:
+            cls.yaml_multi_representers = cls.yaml_multi_representers.copy()
+        cls.yaml_multi_representers[data_type] = representer
+
+    def represent_scalar(self, tag, value, style=None):
+        if style is None:
+            style = self.default_style
+        node = ScalarNode(tag, value, style=style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        return node
+
+    def represent_sequence(self, tag, sequence, flow_style=None):
+        value = []
+        node = SequenceNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        for item in sequence:
+            node_item = self.represent_data(item)
+            if not (isinstance(node_item, ScalarNode) and not node_item.style):
+                best_style = False
+            value.append(node_item)
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def represent_mapping(self, tag, mapping, flow_style=None):
+        value = []
+        node = MappingNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        if hasattr(mapping, 'items'):
+            mapping = list(mapping.items())
+            if self.sort_keys:
+                try:
+                    mapping = sorted(mapping)
+                except TypeError:
+                    pass
+        for item_key, item_value in mapping:
+            node_key = self.represent_data(item_key)
+            node_value = self.represent_data(item_value)
+            if not (isinstance(node_key, ScalarNode) and not node_key.style):
+                best_style = False
+            if not (isinstance(node_value, ScalarNode) and not node_value.style):
+                best_style = False
+            value.append((node_key, node_value))
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def ignore_aliases(self, data):
+        return False
+
+class SafeRepresenter(BaseRepresenter):
+
+    def ignore_aliases(self, data):
+        if data is None:
+            return True
+        if isinstance(data, tuple) and data == ():
+            return True
+        if isinstance(data, (str, bytes, bool, int, float)):
+            return True
+
+    def represent_none(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:null', 'null')
+
+    def represent_str(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:str', data)
+
+    def represent_binary(self, data):
+        if hasattr(base64, 'encodebytes'):
+            data = base64.encodebytes(data).decode('ascii')
+        else:
+            data = base64.encodestring(data).decode('ascii')
+        return self.represent_scalar('tag:yaml.org,2002:binary', data, style='|')
+
+    def represent_bool(self, data):
+        if data:
+            value = 'true'
+        else:
+            value = 'false'
+        return self.represent_scalar('tag:yaml.org,2002:bool', value)
+
+    def represent_int(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:int', str(data))
+
+    inf_value = 1e300
+    while repr(inf_value) != repr(inf_value*inf_value):
+        inf_value *= inf_value
+
+    def represent_float(self, data):
+        if data != data or (data == 0.0 and data == 1.0):
+            value = '.nan'
+        elif data == self.inf_value:
+            value = '.inf'
+        elif data == -self.inf_value:
+            value = '-.inf'
+        else:
+            value = repr(data).lower()
+            # Note that in some cases `repr(data)` represents a float number
+            # without the decimal parts.  For instance:
+            #   >>> repr(1e17)
+            #   '1e17'
+            # Unfortunately, this is not a valid float representation according
+            # to the definition of the `!!float` tag.  We fix this by adding
+            # '.0' before the 'e' symbol.
+            if '.' not in value and 'e' in value:
+                value = value.replace('e', '.0e', 1)
+        return self.represent_scalar('tag:yaml.org,2002:float', value)
+
+    def represent_list(self, data):
+        #pairs = (len(data) > 0 and isinstance(data, list))
+        #if pairs:
+        #    for item in data:
+        #        if not isinstance(item, tuple) or len(item) != 2:
+        #            pairs = False
+        #            break
+        #if not pairs:
+            return self.represent_sequence('tag:yaml.org,2002:seq', data)
+        #value = []
+        #for item_key, item_value in data:
+        #    value.append(self.represent_mapping(u'tag:yaml.org,2002:map',
+        #        [(item_key, item_value)]))
+        #return SequenceNode(u'tag:yaml.org,2002:pairs', value)
+
+    def represent_dict(self, data):
+        return self.represent_mapping('tag:yaml.org,2002:map', data)
+
+    def represent_set(self, data):
+        value = {}
+        for key in data:
+            value[key] = None
+        return self.represent_mapping('tag:yaml.org,2002:set', value)
+
+    def represent_date(self, data):
+        value = data.isoformat()
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_datetime(self, data):
+        value = data.isoformat(' ')
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_yaml_object(self, tag, data, cls, flow_style=None):
+        if hasattr(data, '__getstate__'):
+            state = data.__getstate__()
+        else:
+            state = data.__dict__.copy()
+        return self.represent_mapping(tag, state, flow_style=flow_style)
+
+    def represent_undefined(self, data):
+        raise RepresenterError("cannot represent an object", data)
+
+SafeRepresenter.add_representer(type(None),
+        SafeRepresenter.represent_none)
+
+SafeRepresenter.add_representer(str,
+        SafeRepresenter.represent_str)
+
+SafeRepresenter.add_representer(bytes,
+        SafeRepresenter.represent_binary)
+
+SafeRepresenter.add_representer(bool,
+        SafeRepresenter.represent_bool)
+
+SafeRepresenter.add_representer(int,
+        SafeRepresenter.represent_int)
+
+SafeRepresenter.add_representer(float,
+        SafeRepresenter.represent_float)
+
+SafeRepresenter.add_representer(list,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(tuple,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(dict,
+        SafeRepresenter.represent_dict)
+
+SafeRepresenter.add_representer(set,
+        SafeRepresenter.represent_set)
+
+SafeRepresenter.add_representer(datetime.date,
+        SafeRepresenter.represent_date)
+
+SafeRepresenter.add_representer(datetime.datetime,
+        SafeRepresenter.represent_datetime)
+
+SafeRepresenter.add_representer(None,
+        SafeRepresenter.represent_undefined)
+
+class Representer(SafeRepresenter):
+
+    def represent_complex(self, data):
+        if data.imag == 0.0:
+            data = '%r' % data.real
+        elif data.real == 0.0:
+            data = '%rj' % data.imag
+        elif data.imag > 0:
+            data = '%r+%rj' % (data.real, data.imag)
+        else:
+            data = '%r%rj' % (data.real, data.imag)
+        return self.represent_scalar('tag:yaml.org,2002:python/complex', data)
+
+    def represent_tuple(self, data):
+        return self.represent_sequence('tag:yaml.org,2002:python/tuple', data)
+
+    def represent_name(self, data):
+        name = '%s.%s' % (data.__module__, data.__name__)
+        return self.represent_scalar('tag:yaml.org,2002:python/name:'+name, '')
+
+    def represent_module(self, data):
+        return self.represent_scalar(
+                'tag:yaml.org,2002:python/module:'+data.__name__, '')
+
+    def represent_object(self, data):
+        # We use __reduce__ API to save the data. data.__reduce__ returns
+        # a tuple of length 2-5:
+        #   (function, args, state, listitems, dictitems)
+
+        # For reconstructing, we calls function(*args), then set its state,
+        # listitems, and dictitems if they are not None.
+
+        # A special case is when function.__name__ == '__newobj__'. In this
+        # case we create the object with args[0].__new__(*args).
+
+        # Another special case is when __reduce__ returns a string - we don't
+        # support it.
+
+        # We produce a !!python/object, !!python/object/new or
+        # !!python/object/apply node.
+
+        cls = type(data)
+        if cls in copyreg.dispatch_table:
+            reduce = copyreg.dispatch_table[cls](data)
+        elif hasattr(data, '__reduce_ex__'):
+            reduce = data.__reduce_ex__(2)
+        elif hasattr(data, '__reduce__'):
+            reduce = data.__reduce__()
+        else:
+            raise RepresenterError("cannot represent an object", data)
+        reduce = (list(reduce)+[None]*5)[:5]
+        function, args, state, listitems, dictitems = reduce
+        args = list(args)
+        if state is None:
+            state = {}
+        if listitems is not None:
+            listitems = list(listitems)
+        if dictitems is not None:
+            dictitems = dict(dictitems)
+        if function.__name__ == '__newobj__':
+            function = args[0]
+            args = args[1:]
+            tag = 'tag:yaml.org,2002:python/object/new:'
+            newobj = True
+        else:
+            tag = 'tag:yaml.org,2002:python/object/apply:'
+            newobj = False
+        function_name = '%s.%s' % (function.__module__, function.__name__)
+        if not args and not listitems and not dictitems \
+                and isinstance(state, dict) and newobj:
+            return self.represent_mapping(
+                    'tag:yaml.org,2002:python/object:'+function_name, state)
+        if not listitems and not dictitems  \
+                and isinstance(state, dict) and not state:
+            return self.represent_sequence(tag+function_name, args)
+        value = {}
+        if args:
+            value['args'] = args
+        if state or not isinstance(state, dict):
+            value['state'] = state
+        if listitems:
+            value['listitems'] = listitems
+        if dictitems:
+            value['dictitems'] = dictitems
+        return self.represent_mapping(tag+function_name, value)
+
+    def represent_ordered_dict(self, data):
+        # Provide uniform representation across different Python versions.
+        data_type = type(data)
+        tag = 'tag:yaml.org,2002:python/object/apply:%s.%s' \
+                % (data_type.__module__, data_type.__name__)
+        items = [[key, value] for key, value in data.items()]
+        return self.represent_sequence(tag, [items])
+
+Representer.add_representer(complex,
+        Representer.represent_complex)
+
+Representer.add_representer(tuple,
+        Representer.represent_tuple)
+
+Representer.add_representer(type,
+        Representer.represent_name)
+
+Representer.add_representer(collections.OrderedDict,
+        Representer.represent_ordered_dict)
+
+Representer.add_representer(types.FunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.BuiltinFunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.ModuleType,
+        Representer.represent_module)
+
+Representer.add_multi_representer(object,
+        Representer.represent_object)
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/resolver.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/resolver.py
new file mode 100644
index 0000000000000000000000000000000000000000..02b82e73eecac9875336617a7ff38300ff4507ef
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/resolver.py
@@ -0,0 +1,227 @@
+
+__all__ = ['BaseResolver', 'Resolver']
+
+from .error import *
+from .nodes import *
+
+import re
+
+class ResolverError(YAMLError):
+    pass
+
+class BaseResolver:
+
+    DEFAULT_SCALAR_TAG = 'tag:yaml.org,2002:str'
+    DEFAULT_SEQUENCE_TAG = 'tag:yaml.org,2002:seq'
+    DEFAULT_MAPPING_TAG = 'tag:yaml.org,2002:map'
+
+    yaml_implicit_resolvers = {}
+    yaml_path_resolvers = {}
+
+    def __init__(self):
+        self.resolver_exact_paths = []
+        self.resolver_prefix_paths = []
+
+    @classmethod
+    def add_implicit_resolver(cls, tag, regexp, first):
+        if not 'yaml_implicit_resolvers' in cls.__dict__:
+            implicit_resolvers = {}
+            for key in cls.yaml_implicit_resolvers:
+                implicit_resolvers[key] = cls.yaml_implicit_resolvers[key][:]
+            cls.yaml_implicit_resolvers = implicit_resolvers
+        if first is None:
+            first = [None]
+        for ch in first:
+            cls.yaml_implicit_resolvers.setdefault(ch, []).append((tag, regexp))
+
+    @classmethod
+    def add_path_resolver(cls, tag, path, kind=None):
+        # Note: `add_path_resolver` is experimental.  The API could be changed.
+        # `new_path` is a pattern that is matched against the path from the
+        # root to the node that is being considered.  `node_path` elements are
+        # tuples `(node_check, index_check)`.  `node_check` is a node class:
+        # `ScalarNode`, `SequenceNode`, `MappingNode` or `None`.  `None`
+        # matches any kind of a node.  `index_check` could be `None`, a boolean
+        # value, a string value, or a number.  `None` and `False` match against
+        # any _value_ of sequence and mapping nodes.  `True` matches against
+        # any _key_ of a mapping node.  A string `index_check` matches against
+        # a mapping value that corresponds to a scalar key which content is
+        # equal to the `index_check` value.  An integer `index_check` matches
+        # against a sequence value with the index equal to `index_check`.
+        if not 'yaml_path_resolvers' in cls.__dict__:
+            cls.yaml_path_resolvers = cls.yaml_path_resolvers.copy()
+        new_path = []
+        for element in path:
+            if isinstance(element, (list, tuple)):
+                if len(element) == 2:
+                    node_check, index_check = element
+                elif len(element) == 1:
+                    node_check = element[0]
+                    index_check = True
+                else:
+                    raise ResolverError("Invalid path element: %s" % element)
+            else:
+                node_check = None
+                index_check = element
+            if node_check is str:
+                node_check = ScalarNode
+            elif node_check is list:
+                node_check = SequenceNode
+            elif node_check is dict:
+                node_check = MappingNode
+            elif node_check not in [ScalarNode, SequenceNode, MappingNode]  \
+                    and not isinstance(node_check, str) \
+                    and node_check is not None:
+                raise ResolverError("Invalid node checker: %s" % node_check)
+            if not isinstance(index_check, (str, int))  \
+                    and index_check is not None:
+                raise ResolverError("Invalid index checker: %s" % index_check)
+            new_path.append((node_check, index_check))
+        if kind is str:
+            kind = ScalarNode
+        elif kind is list:
+            kind = SequenceNode
+        elif kind is dict:
+            kind = MappingNode
+        elif kind not in [ScalarNode, SequenceNode, MappingNode]    \
+                and kind is not None:
+            raise ResolverError("Invalid node kind: %s" % kind)
+        cls.yaml_path_resolvers[tuple(new_path), kind] = tag
+
+    def descend_resolver(self, current_node, current_index):
+        if not self.yaml_path_resolvers:
+            return
+        exact_paths = {}
+        prefix_paths = []
+        if current_node:
+            depth = len(self.resolver_prefix_paths)
+            for path, kind in self.resolver_prefix_paths[-1]:
+                if self.check_resolver_prefix(depth, path, kind,
+                        current_node, current_index):
+                    if len(path) > depth:
+                        prefix_paths.append((path, kind))
+                    else:
+                        exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+        else:
+            for path, kind in self.yaml_path_resolvers:
+                if not path:
+                    exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+                else:
+                    prefix_paths.append((path, kind))
+        self.resolver_exact_paths.append(exact_paths)
+        self.resolver_prefix_paths.append(prefix_paths)
+
+    def ascend_resolver(self):
+        if not self.yaml_path_resolvers:
+            return
+        self.resolver_exact_paths.pop()
+        self.resolver_prefix_paths.pop()
+
+    def check_resolver_prefix(self, depth, path, kind,
+            current_node, current_index):
+        node_check, index_check = path[depth-1]
+        if isinstance(node_check, str):
+            if current_node.tag != node_check:
+                return
+        elif node_check is not None:
+            if not isinstance(current_node, node_check):
+                return
+        if index_check is True and current_index is not None:
+            return
+        if (index_check is False or index_check is None)    \
+                and current_index is None:
+            return
+        if isinstance(index_check, str):
+            if not (isinstance(current_index, ScalarNode)
+                    and index_check == current_index.value):
+                return
+        elif isinstance(index_check, int) and not isinstance(index_check, bool):
+            if index_check != current_index:
+                return
+        return True
+
+    def resolve(self, kind, value, implicit):
+        if kind is ScalarNode and implicit[0]:
+            if value == '':
+                resolvers = self.yaml_implicit_resolvers.get('', [])
+            else:
+                resolvers = self.yaml_implicit_resolvers.get(value[0], [])
+            resolvers += self.yaml_implicit_resolvers.get(None, [])
+            for tag, regexp in resolvers:
+                if regexp.match(value):
+                    return tag
+            implicit = implicit[1]
+        if self.yaml_path_resolvers:
+            exact_paths = self.resolver_exact_paths[-1]
+            if kind in exact_paths:
+                return exact_paths[kind]
+            if None in exact_paths:
+                return exact_paths[None]
+        if kind is ScalarNode:
+            return self.DEFAULT_SCALAR_TAG
+        elif kind is SequenceNode:
+            return self.DEFAULT_SEQUENCE_TAG
+        elif kind is MappingNode:
+            return self.DEFAULT_MAPPING_TAG
+
+class Resolver(BaseResolver):
+    pass
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:bool',
+        re.compile(r'''^(?:yes|Yes|YES|no|No|NO
+                    |true|True|TRUE|false|False|FALSE
+                    |on|On|ON|off|Off|OFF)$''', re.X),
+        list('yYnNtTfFoO'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:float',
+        re.compile(r'''^(?:[-+]?(?:[0-9][0-9_]*)\.[0-9_]*(?:[eE][-+][0-9]+)?
+                    |\.[0-9_]+(?:[eE][-+][0-9]+)?
+                    |[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*
+                    |[-+]?\.(?:inf|Inf|INF)
+                    |\.(?:nan|NaN|NAN))$''', re.X),
+        list('-+0123456789.'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:int',
+        re.compile(r'''^(?:[-+]?0b[0-1_]+
+                    |[-+]?0[0-7_]+
+                    |[-+]?(?:0|[1-9][0-9_]*)
+                    |[-+]?0x[0-9a-fA-F_]+
+                    |[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)$''', re.X),
+        list('-+0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:merge',
+        re.compile(r'^(?:<<)$'),
+        ['<'])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:null',
+        re.compile(r'''^(?: ~
+                    |null|Null|NULL
+                    | )$''', re.X),
+        ['~', 'n', 'N', ''])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:timestamp',
+        re.compile(r'''^(?:[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]
+                    |[0-9][0-9][0-9][0-9] -[0-9][0-9]? -[0-9][0-9]?
+                     (?:[Tt]|[ \t]+)[0-9][0-9]?
+                     :[0-9][0-9] :[0-9][0-9] (?:\.[0-9]*)?
+                     (?:[ \t]*(?:Z|[-+][0-9][0-9]?(?::[0-9][0-9])?))?)$''', re.X),
+        list('0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:value',
+        re.compile(r'^(?:=)$'),
+        ['='])
+
+# The following resolver is only for documentation purposes. It cannot work
+# because plain scalars cannot start with '!', '&', or '*'.
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:yaml',
+        re.compile(r'^(?:!|&|\*)$'),
+        list('!&*'))
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/scanner.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/scanner.py
new file mode 100644
index 0000000000000000000000000000000000000000..7437ede1c608266aaca481955f438844479cab4f
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/scanner.py
@@ -0,0 +1,1435 @@
+
+# Scanner produces tokens of the following types:
+# STREAM-START
+# STREAM-END
+# DIRECTIVE(name, value)
+# DOCUMENT-START
+# DOCUMENT-END
+# BLOCK-SEQUENCE-START
+# BLOCK-MAPPING-START
+# BLOCK-END
+# FLOW-SEQUENCE-START
+# FLOW-MAPPING-START
+# FLOW-SEQUENCE-END
+# FLOW-MAPPING-END
+# BLOCK-ENTRY
+# FLOW-ENTRY
+# KEY
+# VALUE
+# ALIAS(value)
+# ANCHOR(value)
+# TAG(value)
+# SCALAR(value, plain, style)
+#
+# Read comments in the Scanner code for more details.
+#
+
+__all__ = ['Scanner', 'ScannerError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+
+class ScannerError(MarkedYAMLError):
+    pass
+
+class SimpleKey:
+    # See below simple keys treatment.
+
+    def __init__(self, token_number, required, index, line, column, mark):
+        self.token_number = token_number
+        self.required = required
+        self.index = index
+        self.line = line
+        self.column = column
+        self.mark = mark
+
+class Scanner:
+
+    def __init__(self):
+        """Initialize the scanner."""
+        # It is assumed that Scanner and Reader will have a common descendant.
+        # Reader do the dirty work of checking for BOM and converting the
+        # input data to Unicode. It also adds NUL to the end.
+        #
+        # Reader supports the following methods
+        #   self.peek(i=0)       # peek the next i-th character
+        #   self.prefix(l=1)     # peek the next l characters
+        #   self.forward(l=1)    # read the next l characters and move the pointer.
+
+        # Had we reached the end of the stream?
+        self.done = False
+
+        # The number of unclosed '{' and '['. `flow_level == 0` means block
+        # context.
+        self.flow_level = 0
+
+        # List of processed tokens that are not yet emitted.
+        self.tokens = []
+
+        # Add the STREAM-START token.
+        self.fetch_stream_start()
+
+        # Number of tokens that were emitted through the `get_token` method.
+        self.tokens_taken = 0
+
+        # The current indentation level.
+        self.indent = -1
+
+        # Past indentation levels.
+        self.indents = []
+
+        # Variables related to simple keys treatment.
+
+        # A simple key is a key that is not denoted by the '?' indicator.
+        # Example of simple keys:
+        #   ---
+        #   block simple key: value
+        #   ? not a simple key:
+        #   : { flow simple key: value }
+        # We emit the KEY token before all keys, so when we find a potential
+        # simple key, we try to locate the corresponding ':' indicator.
+        # Simple keys should be limited to a single line and 1024 characters.
+
+        # Can a simple key start at the current position? A simple key may
+        # start:
+        # - at the beginning of the line, not counting indentation spaces
+        #       (in block context),
+        # - after '{', '[', ',' (in the flow context),
+        # - after '?', ':', '-' (in the block context).
+        # In the block context, this flag also signifies if a block collection
+        # may start at the current position.
+        self.allow_simple_key = True
+
+        # Keep track of possible simple keys. This is a dictionary. The key
+        # is `flow_level`; there can be no more that one possible simple key
+        # for each level. The value is a SimpleKey record:
+        #   (token_number, required, index, line, column, mark)
+        # A simple key may start with ALIAS, ANCHOR, TAG, SCALAR(flow),
+        # '[', or '{' tokens.
+        self.possible_simple_keys = {}
+
+    # Public methods.
+
+    def check_token(self, *choices):
+        # Check if the next token is one of the given types.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.tokens[0], choice):
+                    return True
+        return False
+
+    def peek_token(self):
+        # Return the next token, but do not delete if from the queue.
+        # Return None if no more tokens.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            return self.tokens[0]
+        else:
+            return None
+
+    def get_token(self):
+        # Return the next token.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            self.tokens_taken += 1
+            return self.tokens.pop(0)
+
+    # Private methods.
+
+    def need_more_tokens(self):
+        if self.done:
+            return False
+        if not self.tokens:
+            return True
+        # The current token may be a potential simple key, so we
+        # need to look further.
+        self.stale_possible_simple_keys()
+        if self.next_possible_simple_key() == self.tokens_taken:
+            return True
+
+    def fetch_more_tokens(self):
+
+        # Eat whitespaces and comments until we reach the next token.
+        self.scan_to_next_token()
+
+        # Remove obsolete possible simple keys.
+        self.stale_possible_simple_keys()
+
+        # Compare the current indentation and column. It may add some tokens
+        # and decrease the current indentation level.
+        self.unwind_indent(self.column)
+
+        # Peek the next character.
+        ch = self.peek()
+
+        # Is it the end of stream?
+        if ch == '\0':
+            return self.fetch_stream_end()
+
+        # Is it a directive?
+        if ch == '%' and self.check_directive():
+            return self.fetch_directive()
+
+        # Is it the document start?
+        if ch == '-' and self.check_document_start():
+            return self.fetch_document_start()
+
+        # Is it the document end?
+        if ch == '.' and self.check_document_end():
+            return self.fetch_document_end()
+
+        # TODO: support for BOM within a stream.
+        #if ch == '\uFEFF':
+        #    return self.fetch_bom()    <-- issue BOMToken
+
+        # Note: the order of the following checks is NOT significant.
+
+        # Is it the flow sequence start indicator?
+        if ch == '[':
+            return self.fetch_flow_sequence_start()
+
+        # Is it the flow mapping start indicator?
+        if ch == '{':
+            return self.fetch_flow_mapping_start()
+
+        # Is it the flow sequence end indicator?
+        if ch == ']':
+            return self.fetch_flow_sequence_end()
+
+        # Is it the flow mapping end indicator?
+        if ch == '}':
+            return self.fetch_flow_mapping_end()
+
+        # Is it the flow entry indicator?
+        if ch == ',':
+            return self.fetch_flow_entry()
+
+        # Is it the block entry indicator?
+        if ch == '-' and self.check_block_entry():
+            return self.fetch_block_entry()
+
+        # Is it the key indicator?
+        if ch == '?' and self.check_key():
+            return self.fetch_key()
+
+        # Is it the value indicator?
+        if ch == ':' and self.check_value():
+            return self.fetch_value()
+
+        # Is it an alias?
+        if ch == '*':
+            return self.fetch_alias()
+
+        # Is it an anchor?
+        if ch == '&':
+            return self.fetch_anchor()
+
+        # Is it a tag?
+        if ch == '!':
+            return self.fetch_tag()
+
+        # Is it a literal scalar?
+        if ch == '|' and not self.flow_level:
+            return self.fetch_literal()
+
+        # Is it a folded scalar?
+        if ch == '>' and not self.flow_level:
+            return self.fetch_folded()
+
+        # Is it a single quoted scalar?
+        if ch == '\'':
+            return self.fetch_single()
+
+        # Is it a double quoted scalar?
+        if ch == '\"':
+            return self.fetch_double()
+
+        # It must be a plain scalar then.
+        if self.check_plain():
+            return self.fetch_plain()
+
+        # No? It's an error. Let's produce a nice error message.
+        raise ScannerError("while scanning for the next token", None,
+                "found character %r that cannot start any token" % ch,
+                self.get_mark())
+
+    # Simple keys treatment.
+
+    def next_possible_simple_key(self):
+        # Return the number of the nearest possible simple key. Actually we
+        # don't need to loop through the whole dictionary. We may replace it
+        # with the following code:
+        #   if not self.possible_simple_keys:
+        #       return None
+        #   return self.possible_simple_keys[
+        #           min(self.possible_simple_keys.keys())].token_number
+        min_token_number = None
+        for level in self.possible_simple_keys:
+            key = self.possible_simple_keys[level]
+            if min_token_number is None or key.token_number < min_token_number:
+                min_token_number = key.token_number
+        return min_token_number
+
+    def stale_possible_simple_keys(self):
+        # Remove entries that are no longer possible simple keys. According to
+        # the YAML specification, simple keys
+        # - should be limited to a single line,
+        # - should be no longer than 1024 characters.
+        # Disabling this procedure will allow simple keys of any length and
+        # height (may cause problems if indentation is broken though).
+        for level in list(self.possible_simple_keys):
+            key = self.possible_simple_keys[level]
+            if key.line != self.line  \
+                    or self.index-key.index > 1024:
+                if key.required:
+                    raise ScannerError("while scanning a simple key", key.mark,
+                            "could not find expected ':'", self.get_mark())
+                del self.possible_simple_keys[level]
+
+    def save_possible_simple_key(self):
+        # The next token may start a simple key. We check if it's possible
+        # and save its position. This function is called for
+        #   ALIAS, ANCHOR, TAG, SCALAR(flow), '[', and '{'.
+
+        # Check if a simple key is required at the current position.
+        required = not self.flow_level and self.indent == self.column
+
+        # The next token might be a simple key. Let's save it's number and
+        # position.
+        if self.allow_simple_key:
+            self.remove_possible_simple_key()
+            token_number = self.tokens_taken+len(self.tokens)
+            key = SimpleKey(token_number, required,
+                    self.index, self.line, self.column, self.get_mark())
+            self.possible_simple_keys[self.flow_level] = key
+
+    def remove_possible_simple_key(self):
+        # Remove the saved possible key position at the current flow level.
+        if self.flow_level in self.possible_simple_keys:
+            key = self.possible_simple_keys[self.flow_level]
+            
+            if key.required:
+                raise ScannerError("while scanning a simple key", key.mark,
+                        "could not find expected ':'", self.get_mark())
+
+            del self.possible_simple_keys[self.flow_level]
+
+    # Indentation functions.
+
+    def unwind_indent(self, column):
+
+        ## In flow context, tokens should respect indentation.
+        ## Actually the condition should be `self.indent >= column` according to
+        ## the spec. But this condition will prohibit intuitively correct
+        ## constructions such as
+        ## key : {
+        ## }
+        #if self.flow_level and self.indent > column:
+        #    raise ScannerError(None, None,
+        #            "invalid indentation or unclosed '[' or '{'",
+        #            self.get_mark())
+
+        # In the flow context, indentation is ignored. We make the scanner less
+        # restrictive then specification requires.
+        if self.flow_level:
+            return
+
+        # In block context, we may need to issue the BLOCK-END tokens.
+        while self.indent > column:
+            mark = self.get_mark()
+            self.indent = self.indents.pop()
+            self.tokens.append(BlockEndToken(mark, mark))
+
+    def add_indent(self, column):
+        # Check if we need to increase indentation.
+        if self.indent < column:
+            self.indents.append(self.indent)
+            self.indent = column
+            return True
+        return False
+
+    # Fetchers.
+
+    def fetch_stream_start(self):
+        # We always add STREAM-START as the first token and STREAM-END as the
+        # last token.
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-START.
+        self.tokens.append(StreamStartToken(mark, mark,
+            encoding=self.encoding))
+        
+
+    def fetch_stream_end(self):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+        self.possible_simple_keys = {}
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-END.
+        self.tokens.append(StreamEndToken(mark, mark))
+
+        # The steam is finished.
+        self.done = True
+
+    def fetch_directive(self):
+        
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Scan and add DIRECTIVE.
+        self.tokens.append(self.scan_directive())
+
+    def fetch_document_start(self):
+        self.fetch_document_indicator(DocumentStartToken)
+
+    def fetch_document_end(self):
+        self.fetch_document_indicator(DocumentEndToken)
+
+    def fetch_document_indicator(self, TokenClass):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys. Note that there could not be a block collection
+        # after '---'.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Add DOCUMENT-START or DOCUMENT-END.
+        start_mark = self.get_mark()
+        self.forward(3)
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_start(self):
+        self.fetch_flow_collection_start(FlowSequenceStartToken)
+
+    def fetch_flow_mapping_start(self):
+        self.fetch_flow_collection_start(FlowMappingStartToken)
+
+    def fetch_flow_collection_start(self, TokenClass):
+
+        # '[' and '{' may start a simple key.
+        self.save_possible_simple_key()
+
+        # Increase the flow level.
+        self.flow_level += 1
+
+        # Simple keys are allowed after '[' and '{'.
+        self.allow_simple_key = True
+
+        # Add FLOW-SEQUENCE-START or FLOW-MAPPING-START.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_end(self):
+        self.fetch_flow_collection_end(FlowSequenceEndToken)
+
+    def fetch_flow_mapping_end(self):
+        self.fetch_flow_collection_end(FlowMappingEndToken)
+
+    def fetch_flow_collection_end(self, TokenClass):
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Decrease the flow level.
+        self.flow_level -= 1
+
+        # No simple keys after ']' or '}'.
+        self.allow_simple_key = False
+
+        # Add FLOW-SEQUENCE-END or FLOW-MAPPING-END.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_entry(self):
+
+        # Simple keys are allowed after ','.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add FLOW-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(FlowEntryToken(start_mark, end_mark))
+
+    def fetch_block_entry(self):
+
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a new entry?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "sequence entries are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-SEQUENCE-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockSequenceStartToken(mark, mark))
+
+        # It's an error for the block entry to occur in the flow context,
+        # but we let the parser detect this.
+        else:
+            pass
+
+        # Simple keys are allowed after '-'.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add BLOCK-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(BlockEntryToken(start_mark, end_mark))
+
+    def fetch_key(self):
+        
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a key (not necessary a simple)?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "mapping keys are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-MAPPING-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockMappingStartToken(mark, mark))
+
+        # Simple keys are allowed after '?' in the block context.
+        self.allow_simple_key = not self.flow_level
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add KEY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(KeyToken(start_mark, end_mark))
+
+    def fetch_value(self):
+
+        # Do we determine a simple key?
+        if self.flow_level in self.possible_simple_keys:
+
+            # Add KEY.
+            key = self.possible_simple_keys[self.flow_level]
+            del self.possible_simple_keys[self.flow_level]
+            self.tokens.insert(key.token_number-self.tokens_taken,
+                    KeyToken(key.mark, key.mark))
+
+            # If this key starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.
+            if not self.flow_level:
+                if self.add_indent(key.column):
+                    self.tokens.insert(key.token_number-self.tokens_taken,
+                            BlockMappingStartToken(key.mark, key.mark))
+
+            # There cannot be two simple keys one after another.
+            self.allow_simple_key = False
+
+        # It must be a part of a complex key.
+        else:
+            
+            # Block context needs additional checks.
+            # (Do we really need them? They will be caught by the parser
+            # anyway.)
+            if not self.flow_level:
+
+                # We are allowed to start a complex value if and only if
+                # we can start a simple key.
+                if not self.allow_simple_key:
+                    raise ScannerError(None, None,
+                            "mapping values are not allowed here",
+                            self.get_mark())
+
+            # If this value starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.  It will be detected as an error later by
+            # the parser.
+            if not self.flow_level:
+                if self.add_indent(self.column):
+                    mark = self.get_mark()
+                    self.tokens.append(BlockMappingStartToken(mark, mark))
+
+            # Simple keys are allowed after ':' in the block context.
+            self.allow_simple_key = not self.flow_level
+
+            # Reset possible simple key on the current level.
+            self.remove_possible_simple_key()
+
+        # Add VALUE.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(ValueToken(start_mark, end_mark))
+
+    def fetch_alias(self):
+
+        # ALIAS could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ALIAS.
+        self.allow_simple_key = False
+
+        # Scan and add ALIAS.
+        self.tokens.append(self.scan_anchor(AliasToken))
+
+    def fetch_anchor(self):
+
+        # ANCHOR could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ANCHOR.
+        self.allow_simple_key = False
+
+        # Scan and add ANCHOR.
+        self.tokens.append(self.scan_anchor(AnchorToken))
+
+    def fetch_tag(self):
+
+        # TAG could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after TAG.
+        self.allow_simple_key = False
+
+        # Scan and add TAG.
+        self.tokens.append(self.scan_tag())
+
+    def fetch_literal(self):
+        self.fetch_block_scalar(style='|')
+
+    def fetch_folded(self):
+        self.fetch_block_scalar(style='>')
+
+    def fetch_block_scalar(self, style):
+
+        # A simple key may follow a block scalar.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_block_scalar(style))
+
+    def fetch_single(self):
+        self.fetch_flow_scalar(style='\'')
+
+    def fetch_double(self):
+        self.fetch_flow_scalar(style='"')
+
+    def fetch_flow_scalar(self, style):
+
+        # A flow scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after flow scalars.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_flow_scalar(style))
+
+    def fetch_plain(self):
+
+        # A plain scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after plain scalars. But note that `scan_plain` will
+        # change this flag if the scan is finished at the beginning of the
+        # line.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR. May change `allow_simple_key`.
+        self.tokens.append(self.scan_plain())
+
+    # Checkers.
+
+    def check_directive(self):
+
+        # DIRECTIVE:        ^ '%' ...
+        # The '%' indicator is already checked.
+        if self.column == 0:
+            return True
+
+    def check_document_start(self):
+
+        # DOCUMENT-START:   ^ '---' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '---'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_document_end(self):
+
+        # DOCUMENT-END:     ^ '...' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '...'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_block_entry(self):
+
+        # BLOCK-ENTRY:      '-' (' '|'\n')
+        return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_key(self):
+
+        # KEY(flow context):    '?'
+        if self.flow_level:
+            return True
+
+        # KEY(block context):   '?' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_value(self):
+
+        # VALUE(flow context):  ':'
+        if self.flow_level:
+            return True
+
+        # VALUE(block context): ':' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_plain(self):
+
+        # A plain scalar may start with any non-space character except:
+        #   '-', '?', ':', ',', '[', ']', '{', '}',
+        #   '#', '&', '*', '!', '|', '>', '\'', '\"',
+        #   '%', '@', '`'.
+        #
+        # It may also start with
+        #   '-', '?', ':'
+        # if it is followed by a non-space character.
+        #
+        # Note that we limit the last rule to the block context (except the
+        # '-' character) because we want the flow context to be space
+        # independent.
+        ch = self.peek()
+        return ch not in '\0 \t\r\n\x85\u2028\u2029-?:,[]{}#&*!|>\'\"%@`'  \
+                or (self.peek(1) not in '\0 \t\r\n\x85\u2028\u2029'
+                        and (ch == '-' or (not self.flow_level and ch in '?:')))
+
+    # Scanners.
+
+    def scan_to_next_token(self):
+        # We ignore spaces, line breaks and comments.
+        # If we find a line break in the block context, we set the flag
+        # `allow_simple_key` on.
+        # The byte order mark is stripped if it's the first character in the
+        # stream. We do not yet support BOM inside the stream as the
+        # specification requires. Any such mark will be considered as a part
+        # of the document.
+        #
+        # TODO: We need to make tab handling rules more sane. A good rule is
+        #   Tabs cannot precede tokens
+        #   BLOCK-SEQUENCE-START, BLOCK-MAPPING-START, BLOCK-END,
+        #   KEY(block), VALUE(block), BLOCK-ENTRY
+        # So the checking code is
+        #   if <TAB>:
+        #       self.allow_simple_keys = False
+        # We also need to add the check for `allow_simple_keys == True` to
+        # `unwind_indent` before issuing BLOCK-END.
+        # Scanners for block, flow, and plain scalars need to be modified.
+
+        if self.index == 0 and self.peek() == '\uFEFF':
+            self.forward()
+        found = False
+        while not found:
+            while self.peek() == ' ':
+                self.forward()
+            if self.peek() == '#':
+                while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                    self.forward()
+            if self.scan_line_break():
+                if not self.flow_level:
+                    self.allow_simple_key = True
+            else:
+                found = True
+
+    def scan_directive(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        self.forward()
+        name = self.scan_directive_name(start_mark)
+        value = None
+        if name == 'YAML':
+            value = self.scan_yaml_directive_value(start_mark)
+            end_mark = self.get_mark()
+        elif name == 'TAG':
+            value = self.scan_tag_directive_value(start_mark)
+            end_mark = self.get_mark()
+        else:
+            end_mark = self.get_mark()
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        self.scan_directive_ignored_line(start_mark)
+        return DirectiveToken(name, value, start_mark, end_mark)
+
+    def scan_directive_name(self, start_mark):
+        # See the specification for details.
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        return value
+
+    def scan_yaml_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        major = self.scan_yaml_directive_number(start_mark)
+        if self.peek() != '.':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or '.', but found %r" % self.peek(),
+                    self.get_mark())
+        self.forward()
+        minor = self.scan_yaml_directive_number(start_mark)
+        if self.peek() not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or ' ', but found %r" % self.peek(),
+                    self.get_mark())
+        return (major, minor)
+
+    def scan_yaml_directive_number(self, start_mark):
+        # See the specification for details.
+        ch = self.peek()
+        if not ('0' <= ch <= '9'):
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit, but found %r" % ch, self.get_mark())
+        length = 0
+        while '0' <= self.peek(length) <= '9':
+            length += 1
+        value = int(self.prefix(length))
+        self.forward(length)
+        return value
+
+    def scan_tag_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        handle = self.scan_tag_directive_handle(start_mark)
+        while self.peek() == ' ':
+            self.forward()
+        prefix = self.scan_tag_directive_prefix(start_mark)
+        return (handle, prefix)
+
+    def scan_tag_directive_handle(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_handle('directive', start_mark)
+        ch = self.peek()
+        if ch != ' ':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_tag_directive_prefix(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_uri('directive', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_directive_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a comment or a line break, but found %r"
+                        % ch, self.get_mark())
+        self.scan_line_break()
+
+    def scan_anchor(self, TokenClass):
+        # The specification does not restrict characters for anchors and
+        # aliases. This may lead to problems, for instance, the document:
+        #   [ *alias, value ]
+        # can be interpreted in two ways, as
+        #   [ "value" ]
+        # and
+        #   [ *alias , "value" ]
+        # Therefore we restrict aliases to numbers and ASCII letters.
+        start_mark = self.get_mark()
+        indicator = self.peek()
+        if indicator == '*':
+            name = 'alias'
+        else:
+            name = 'anchor'
+        self.forward()
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \t\r\n\x85\u2028\u2029?:,]}%@`':
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        end_mark = self.get_mark()
+        return TokenClass(value, start_mark, end_mark)
+
+    def scan_tag(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        ch = self.peek(1)
+        if ch == '<':
+            handle = None
+            self.forward(2)
+            suffix = self.scan_tag_uri('tag', start_mark)
+            if self.peek() != '>':
+                raise ScannerError("while parsing a tag", start_mark,
+                        "expected '>', but found %r" % self.peek(),
+                        self.get_mark())
+            self.forward()
+        elif ch in '\0 \t\r\n\x85\u2028\u2029':
+            handle = None
+            suffix = '!'
+            self.forward()
+        else:
+            length = 1
+            use_handle = False
+            while ch not in '\0 \r\n\x85\u2028\u2029':
+                if ch == '!':
+                    use_handle = True
+                    break
+                length += 1
+                ch = self.peek(length)
+            handle = '!'
+            if use_handle:
+                handle = self.scan_tag_handle('tag', start_mark)
+            else:
+                handle = '!'
+                self.forward()
+            suffix = self.scan_tag_uri('tag', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a tag", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        value = (handle, suffix)
+        end_mark = self.get_mark()
+        return TagToken(value, start_mark, end_mark)
+
+    def scan_block_scalar(self, style):
+        # See the specification for details.
+
+        if style == '>':
+            folded = True
+        else:
+            folded = False
+
+        chunks = []
+        start_mark = self.get_mark()
+
+        # Scan the header.
+        self.forward()
+        chomping, increment = self.scan_block_scalar_indicators(start_mark)
+        self.scan_block_scalar_ignored_line(start_mark)
+
+        # Determine the indentation level and go to the first non-empty line.
+        min_indent = self.indent+1
+        if min_indent < 1:
+            min_indent = 1
+        if increment is None:
+            breaks, max_indent, end_mark = self.scan_block_scalar_indentation()
+            indent = max(min_indent, max_indent)
+        else:
+            indent = min_indent+increment-1
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+        line_break = ''
+
+        # Scan the inner part of the block scalar.
+        while self.column == indent and self.peek() != '\0':
+            chunks.extend(breaks)
+            leading_non_space = self.peek() not in ' \t'
+            length = 0
+            while self.peek(length) not in '\0\r\n\x85\u2028\u2029':
+                length += 1
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            line_break = self.scan_line_break()
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+            if self.column == indent and self.peek() != '\0':
+
+                # Unfortunately, folding rules are ambiguous.
+                #
+                # This is the folding according to the specification:
+                
+                if folded and line_break == '\n'    \
+                        and leading_non_space and self.peek() not in ' \t':
+                    if not breaks:
+                        chunks.append(' ')
+                else:
+                    chunks.append(line_break)
+                
+                # This is Clark Evans's interpretation (also in the spec
+                # examples):
+                #
+                #if folded and line_break == '\n':
+                #    if not breaks:
+                #        if self.peek() not in ' \t':
+                #            chunks.append(' ')
+                #        else:
+                #            chunks.append(line_break)
+                #else:
+                #    chunks.append(line_break)
+            else:
+                break
+
+        # Chomp the tail.
+        if chomping is not False:
+            chunks.append(line_break)
+        if chomping is True:
+            chunks.extend(breaks)
+
+        # We are done.
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    def scan_block_scalar_indicators(self, start_mark):
+        # See the specification for details.
+        chomping = None
+        increment = None
+        ch = self.peek()
+        if ch in '+-':
+            if ch == '+':
+                chomping = True
+            else:
+                chomping = False
+            self.forward()
+            ch = self.peek()
+            if ch in '0123456789':
+                increment = int(ch)
+                if increment == 0:
+                    raise ScannerError("while scanning a block scalar", start_mark,
+                            "expected indentation indicator in the range 1-9, but found 0",
+                            self.get_mark())
+                self.forward()
+        elif ch in '0123456789':
+            increment = int(ch)
+            if increment == 0:
+                raise ScannerError("while scanning a block scalar", start_mark,
+                        "expected indentation indicator in the range 1-9, but found 0",
+                        self.get_mark())
+            self.forward()
+            ch = self.peek()
+            if ch in '+-':
+                if ch == '+':
+                    chomping = True
+                else:
+                    chomping = False
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected chomping or indentation indicators, but found %r"
+                    % ch, self.get_mark())
+        return chomping, increment
+
+    def scan_block_scalar_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected a comment or a line break, but found %r" % ch,
+                    self.get_mark())
+        self.scan_line_break()
+
+    def scan_block_scalar_indentation(self):
+        # See the specification for details.
+        chunks = []
+        max_indent = 0
+        end_mark = self.get_mark()
+        while self.peek() in ' \r\n\x85\u2028\u2029':
+            if self.peek() != ' ':
+                chunks.append(self.scan_line_break())
+                end_mark = self.get_mark()
+            else:
+                self.forward()
+                if self.column > max_indent:
+                    max_indent = self.column
+        return chunks, max_indent, end_mark
+
+    def scan_block_scalar_breaks(self, indent):
+        # See the specification for details.
+        chunks = []
+        end_mark = self.get_mark()
+        while self.column < indent and self.peek() == ' ':
+            self.forward()
+        while self.peek() in '\r\n\x85\u2028\u2029':
+            chunks.append(self.scan_line_break())
+            end_mark = self.get_mark()
+            while self.column < indent and self.peek() == ' ':
+                self.forward()
+        return chunks, end_mark
+
+    def scan_flow_scalar(self, style):
+        # See the specification for details.
+        # Note that we loose indentation rules for quoted scalars. Quoted
+        # scalars don't need to adhere indentation because " and ' clearly
+        # mark the beginning and the end of them. Therefore we are less
+        # restrictive then the specification requires. We only need to check
+        # that document separators are not included in scalars.
+        if style == '"':
+            double = True
+        else:
+            double = False
+        chunks = []
+        start_mark = self.get_mark()
+        quote = self.peek()
+        self.forward()
+        chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        while self.peek() != quote:
+            chunks.extend(self.scan_flow_scalar_spaces(double, start_mark))
+            chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        self.forward()
+        end_mark = self.get_mark()
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    ESCAPE_REPLACEMENTS = {
+        '0':    '\0',
+        'a':    '\x07',
+        'b':    '\x08',
+        't':    '\x09',
+        '\t':   '\x09',
+        'n':    '\x0A',
+        'v':    '\x0B',
+        'f':    '\x0C',
+        'r':    '\x0D',
+        'e':    '\x1B',
+        ' ':    '\x20',
+        '\"':   '\"',
+        '\\':   '\\',
+        '/':    '/',
+        'N':    '\x85',
+        '_':    '\xA0',
+        'L':    '\u2028',
+        'P':    '\u2029',
+    }
+
+    ESCAPE_CODES = {
+        'x':    2,
+        'u':    4,
+        'U':    8,
+    }
+
+    def scan_flow_scalar_non_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            length = 0
+            while self.peek(length) not in '\'\"\\\0 \t\r\n\x85\u2028\u2029':
+                length += 1
+            if length:
+                chunks.append(self.prefix(length))
+                self.forward(length)
+            ch = self.peek()
+            if not double and ch == '\'' and self.peek(1) == '\'':
+                chunks.append('\'')
+                self.forward(2)
+            elif (double and ch == '\'') or (not double and ch in '\"\\'):
+                chunks.append(ch)
+                self.forward()
+            elif double and ch == '\\':
+                self.forward()
+                ch = self.peek()
+                if ch in self.ESCAPE_REPLACEMENTS:
+                    chunks.append(self.ESCAPE_REPLACEMENTS[ch])
+                    self.forward()
+                elif ch in self.ESCAPE_CODES:
+                    length = self.ESCAPE_CODES[ch]
+                    self.forward()
+                    for k in range(length):
+                        if self.peek(k) not in '0123456789ABCDEFabcdef':
+                            raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                                    "expected escape sequence of %d hexdecimal numbers, but found %r" %
+                                        (length, self.peek(k)), self.get_mark())
+                    code = int(self.prefix(length), 16)
+                    chunks.append(chr(code))
+                    self.forward(length)
+                elif ch in '\r\n\x85\u2028\u2029':
+                    self.scan_line_break()
+                    chunks.extend(self.scan_flow_scalar_breaks(double, start_mark))
+                else:
+                    raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                            "found unknown escape character %r" % ch, self.get_mark())
+            else:
+                return chunks
+
+    def scan_flow_scalar_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        length = 0
+        while self.peek(length) in ' \t':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch == '\0':
+            raise ScannerError("while scanning a quoted scalar", start_mark,
+                    "found unexpected end of stream", self.get_mark())
+        elif ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            breaks = self.scan_flow_scalar_breaks(double, start_mark)
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        else:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_flow_scalar_breaks(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            # Instead of checking indentation, we check for document
+            # separators.
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                raise ScannerError("while scanning a quoted scalar", start_mark,
+                        "found unexpected document separator", self.get_mark())
+            while self.peek() in ' \t':
+                self.forward()
+            if self.peek() in '\r\n\x85\u2028\u2029':
+                chunks.append(self.scan_line_break())
+            else:
+                return chunks
+
+    def scan_plain(self):
+        # See the specification for details.
+        # We add an additional restriction for the flow context:
+        #   plain scalars in the flow context cannot contain ',' or '?'.
+        # We also keep track of the `allow_simple_key` flag here.
+        # Indentation rules are loosed for the flow context.
+        chunks = []
+        start_mark = self.get_mark()
+        end_mark = start_mark
+        indent = self.indent+1
+        # We allow zero indentation for scalars, but then we need to check for
+        # document separators at the beginning of the line.
+        #if indent == 0:
+        #    indent = 1
+        spaces = []
+        while True:
+            length = 0
+            if self.peek() == '#':
+                break
+            while True:
+                ch = self.peek(length)
+                if ch in '\0 \t\r\n\x85\u2028\u2029'    \
+                        or (ch == ':' and
+                                self.peek(length+1) in '\0 \t\r\n\x85\u2028\u2029'
+                                      + (u',[]{}' if self.flow_level else u''))\
+                        or (self.flow_level and ch in ',?[]{}'):
+                    break
+                length += 1
+            if length == 0:
+                break
+            self.allow_simple_key = False
+            chunks.extend(spaces)
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            end_mark = self.get_mark()
+            spaces = self.scan_plain_spaces(indent, start_mark)
+            if not spaces or self.peek() == '#' \
+                    or (not self.flow_level and self.column < indent):
+                break
+        return ScalarToken(''.join(chunks), True, start_mark, end_mark)
+
+    def scan_plain_spaces(self, indent, start_mark):
+        # See the specification for details.
+        # The specification is really confusing about tabs in plain scalars.
+        # We just forbid them completely. Do not use tabs in YAML!
+        chunks = []
+        length = 0
+        while self.peek(length) in ' ':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            self.allow_simple_key = True
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return
+            breaks = []
+            while self.peek() in ' \r\n\x85\u2028\u2029':
+                if self.peek() == ' ':
+                    self.forward()
+                else:
+                    breaks.append(self.scan_line_break())
+                    prefix = self.prefix(3)
+                    if (prefix == '---' or prefix == '...')   \
+                            and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                        return
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        elif whitespaces:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_tag_handle(self, name, start_mark):
+        # See the specification for details.
+        # For some strange reasons, the specification does not allow '_' in
+        # tag handles. I have allowed it anyway.
+        ch = self.peek()
+        if ch != '!':
+            raise ScannerError("while scanning a %s" % name, start_mark,
+                    "expected '!', but found %r" % ch, self.get_mark())
+        length = 1
+        ch = self.peek(length)
+        if ch != ' ':
+            while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                    or ch in '-_':
+                length += 1
+                ch = self.peek(length)
+            if ch != '!':
+                self.forward(length)
+                raise ScannerError("while scanning a %s" % name, start_mark,
+                        "expected '!', but found %r" % ch, self.get_mark())
+            length += 1
+        value = self.prefix(length)
+        self.forward(length)
+        return value
+
+    def scan_tag_uri(self, name, start_mark):
+        # See the specification for details.
+        # Note: we do not check if URI is well-formed.
+        chunks = []
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-;/?:@&=+$,_.!~*\'()[]%':
+            if ch == '%':
+                chunks.append(self.prefix(length))
+                self.forward(length)
+                length = 0
+                chunks.append(self.scan_uri_escapes(name, start_mark))
+            else:
+                length += 1
+            ch = self.peek(length)
+        if length:
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            length = 0
+        if not chunks:
+            raise ScannerError("while parsing a %s" % name, start_mark,
+                    "expected URI, but found %r" % ch, self.get_mark())
+        return ''.join(chunks)
+
+    def scan_uri_escapes(self, name, start_mark):
+        # See the specification for details.
+        codes = []
+        mark = self.get_mark()
+        while self.peek() == '%':
+            self.forward()
+            for k in range(2):
+                if self.peek(k) not in '0123456789ABCDEFabcdef':
+                    raise ScannerError("while scanning a %s" % name, start_mark,
+                            "expected URI escape sequence of 2 hexdecimal numbers, but found %r"
+                            % self.peek(k), self.get_mark())
+            codes.append(int(self.prefix(2), 16))
+            self.forward(2)
+        try:
+            value = bytes(codes).decode('utf-8')
+        except UnicodeDecodeError as exc:
+            raise ScannerError("while scanning a %s" % name, start_mark, str(exc), mark)
+        return value
+
+    def scan_line_break(self):
+        # Transforms:
+        #   '\r\n'      :   '\n'
+        #   '\r'        :   '\n'
+        #   '\n'        :   '\n'
+        #   '\x85'      :   '\n'
+        #   '\u2028'    :   '\u2028'
+        #   '\u2029     :   '\u2029'
+        #   default     :   ''
+        ch = self.peek()
+        if ch in '\r\n\x85':
+            if self.prefix(2) == '\r\n':
+                self.forward(2)
+            else:
+                self.forward()
+            return '\n'
+        elif ch in '\u2028\u2029':
+            self.forward()
+            return ch
+        return ''
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/serializer.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe911e67ae7a739abb491fbbc6834b9c37bbda4b
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/serializer.py
@@ -0,0 +1,111 @@
+
+__all__ = ['Serializer', 'SerializerError']
+
+from .error import YAMLError
+from .events import *
+from .nodes import *
+
+class SerializerError(YAMLError):
+    pass
+
+class Serializer:
+
+    ANCHOR_TEMPLATE = 'id%03d'
+
+    def __init__(self, encoding=None,
+            explicit_start=None, explicit_end=None, version=None, tags=None):
+        self.use_encoding = encoding
+        self.use_explicit_start = explicit_start
+        self.use_explicit_end = explicit_end
+        self.use_version = version
+        self.use_tags = tags
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+        self.closed = None
+
+    def open(self):
+        if self.closed is None:
+            self.emit(StreamStartEvent(encoding=self.use_encoding))
+            self.closed = False
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        else:
+            raise SerializerError("serializer is already opened")
+
+    def close(self):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif not self.closed:
+            self.emit(StreamEndEvent())
+            self.closed = True
+
+    #def __del__(self):
+    #    self.close()
+
+    def serialize(self, node):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        self.emit(DocumentStartEvent(explicit=self.use_explicit_start,
+            version=self.use_version, tags=self.use_tags))
+        self.anchor_node(node)
+        self.serialize_node(node, None, None)
+        self.emit(DocumentEndEvent(explicit=self.use_explicit_end))
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+
+    def anchor_node(self, node):
+        if node in self.anchors:
+            if self.anchors[node] is None:
+                self.anchors[node] = self.generate_anchor(node)
+        else:
+            self.anchors[node] = None
+            if isinstance(node, SequenceNode):
+                for item in node.value:
+                    self.anchor_node(item)
+            elif isinstance(node, MappingNode):
+                for key, value in node.value:
+                    self.anchor_node(key)
+                    self.anchor_node(value)
+
+    def generate_anchor(self, node):
+        self.last_anchor_id += 1
+        return self.ANCHOR_TEMPLATE % self.last_anchor_id
+
+    def serialize_node(self, node, parent, index):
+        alias = self.anchors[node]
+        if node in self.serialized_nodes:
+            self.emit(AliasEvent(alias))
+        else:
+            self.serialized_nodes[node] = True
+            self.descend_resolver(parent, index)
+            if isinstance(node, ScalarNode):
+                detected_tag = self.resolve(ScalarNode, node.value, (True, False))
+                default_tag = self.resolve(ScalarNode, node.value, (False, True))
+                implicit = (node.tag == detected_tag), (node.tag == default_tag)
+                self.emit(ScalarEvent(alias, node.tag, implicit, node.value,
+                    style=node.style))
+            elif isinstance(node, SequenceNode):
+                implicit = (node.tag
+                            == self.resolve(SequenceNode, node.value, True))
+                self.emit(SequenceStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                index = 0
+                for item in node.value:
+                    self.serialize_node(item, node, index)
+                    index += 1
+                self.emit(SequenceEndEvent())
+            elif isinstance(node, MappingNode):
+                implicit = (node.tag
+                            == self.resolve(MappingNode, node.value, True))
+                self.emit(MappingStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                for key, value in node.value:
+                    self.serialize_node(key, node, None)
+                    self.serialize_node(value, node, key)
+                self.emit(MappingEndEvent())
+            self.ascend_resolver()
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/tokens.py b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/tokens.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d0b48a394ac8c019b401516a12f688df361cf90
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/lib/python3.8/site-packages/yaml/tokens.py
@@ -0,0 +1,104 @@
+
+class Token(object):
+    def __init__(self, start_mark, end_mark):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in self.__dict__
+                if not key.endswith('_mark')]
+        attributes.sort()
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+#class BOMToken(Token):
+#    id = '<byte order mark>'
+
+class DirectiveToken(Token):
+    id = '<directive>'
+    def __init__(self, name, value, start_mark, end_mark):
+        self.name = name
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class DocumentStartToken(Token):
+    id = '<document start>'
+
+class DocumentEndToken(Token):
+    id = '<document end>'
+
+class StreamStartToken(Token):
+    id = '<stream start>'
+    def __init__(self, start_mark=None, end_mark=None,
+            encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndToken(Token):
+    id = '<stream end>'
+
+class BlockSequenceStartToken(Token):
+    id = '<block sequence start>'
+
+class BlockMappingStartToken(Token):
+    id = '<block mapping start>'
+
+class BlockEndToken(Token):
+    id = '<block end>'
+
+class FlowSequenceStartToken(Token):
+    id = '['
+
+class FlowMappingStartToken(Token):
+    id = '{'
+
+class FlowSequenceEndToken(Token):
+    id = ']'
+
+class FlowMappingEndToken(Token):
+    id = '}'
+
+class KeyToken(Token):
+    id = '?'
+
+class ValueToken(Token):
+    id = ':'
+
+class BlockEntryToken(Token):
+    id = '-'
+
+class FlowEntryToken(Token):
+    id = ','
+
+class AliasToken(Token):
+    id = '<alias>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class AnchorToken(Token):
+    id = '<anchor>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class TagToken(Token):
+    id = '<tag>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class ScalarToken(Token):
+    id = '<scalar>'
+    def __init__(self, value, plain, start_mark, end_mark, style=None):
+        self.value = value
+        self.plain = plain
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/pyvenv.cfg b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/pyvenv.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..b89ae83699598c38c75ea89c31158363490743a4
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/charms/vyos-config/venv/pyvenv.cfg
@@ -0,0 +1,8 @@
+home = /usr
+implementation = CPython
+version_info = 3.8.5.final.0
+virtualenv = 20.0.17
+include-system-site-packages = false
+base-prefix = /usr
+base-exec-prefix = /usr
+base-executable = /usr/bin/python3
diff --git a/SOL004/hackfest_firewall_pnf/charms/vyos-config/vyos-config.charm b/SOL004/hackfest_firewall_pnf/charms/vyos-config/vyos-config.charm
new file mode 100644
index 0000000000000000000000000000000000000000..a9fe143690ef32d6dc66f6c02c0e853b8384cb9e
Binary files /dev/null and b/SOL004/hackfest_firewall_pnf/charms/vyos-config/vyos-config.charm differ
diff --git a/SOL004/hackfest_firewall_pnf/hackfest_firewall_pnfd.yaml b/SOL004/hackfest_firewall_pnf/hackfest_firewall_pnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b39a5ecb6f660c1a0957d122b6102327705d4fb2
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf/hackfest_firewall_pnfd.yaml
@@ -0,0 +1,89 @@
+# Copyright ETSI OSM
+#
+# All Rights Reserved.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+vnfd:
+  description: PNF entry for a firewall router
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: vyos-VM
+    vdu-profile:
+    - id: vyos-VM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: osm
+              required: true
+          id: hackfest_firewall_pnf
+          execution-environment-list:
+          - id: vyos-config-ee
+            juju:
+              charm: vyos-config
+              #cloud: k8s
+          initial-config-primitive:
+          - name: config
+            parameter:
+            - name: ssh-username
+              value: osm
+            - name: ssh-password
+              value: osm2021
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            seq: 1
+          config-primitive:
+          - name: add-port-forward
+            parameter:
+            - name: ruleNumber
+              data-type: STRING
+            - name: sourcePort
+              data-type: STRING
+            - name: destinationAddress
+              data-type: STRING
+            - name: destinationPort
+              data-type: STRING
+          - name: remove-port-forward
+            parameter:
+            - name: ruleNumber
+              data-type: STRING
+  ext-cpd:
+  - id: gateway_public
+    int-cpd:
+      cpd: gateway_public
+      vdu-id: vyos-VM
+  - id: vnf_internal
+    int-cpd:
+      cpd: vnf_internal
+      vdu-id: vyos-VM
+  id: hackfest_firewall_pnf
+  mgmt-cp: gateway_public
+  product-name: hackfest_firewall_pnf
+  vdu:
+  - id: vyos-VM
+    pdu-type: gateway
+    int-cpd:
+    - id: gateway_public
+      virtual-network-interface-requirement:
+      - name: gateway_public
+    - id: vnf_internal
+      virtual-network-interface-requirement:
+      - name: vnf_internal
+    name: vyos-VM
+  version: '1.0'
\ No newline at end of file
diff --git a/SOL004/hackfest_firewall_pnf_ns/README b/SOL004/hackfest_firewall_pnf_ns/README
new file mode 100644
index 0000000000000000000000000000000000000000..77850bb3719ade9bd4a781275d7825178ac113ba
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf_ns/README
@@ -0,0 +1,2 @@
+Descriptor created by OSM descriptor package generated
+Created on Tue Jan 14 17:49:17 UTC 2020
diff --git a/SOL004/hackfest_firewall_pnf_ns/hackfest_firewall_pnf_nsd.yaml b/SOL004/hackfest_firewall_pnf_ns/hackfest_firewall_pnf_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a8f8e924c09370bcae53986ec1417b81c0974f20
--- /dev/null
+++ b/SOL004/hackfest_firewall_pnf_ns/hackfest_firewall_pnf_nsd.yaml
@@ -0,0 +1,43 @@
+# Copyright ETSI OSM
+#
+# All Rights Reserved.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+nsd:
+  nsd:
+  - description: PNF Firewall
+    designer: ETSI OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: VYOS-PNF
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: VYOS-PNF
+            constituent-cpd-id: gateway_public
+          virtual-link-profile-id: mgmt
+        - constituent-cpd-id:
+          - constituent-base-element-id: VYOS-PNF
+            constituent-cpd-id: vnf_internal
+          virtual-link-profile-id: private
+        vnfd-id: hackfest_firewall_pnf
+    id: hackfest_firewall_pnf_ns
+    name: hackfest_firewall_pnf_ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmt
+      mgmt-network: true
+    - id: private
+      vim-network-name: private
+    vnfd-id:
+    - hackfest_firewall_pnf
diff --git a/SOL004/hackfest_k8sproxycharm_ns/hackfest_k8sproxycharm_nsd.yaml b/SOL004/hackfest_k8sproxycharm_ns/hackfest_k8sproxycharm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7cb449be6730b041cc95e667d12f67fa641d9210
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_ns/hackfest_k8sproxycharm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_k8sproxycharm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_k8sproxycharm-vnf
+    id: hackfest_k8sproxycharm-ns
+    name: hackfest_k8sproxycharm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - hackfest_k8sproxycharm-vnf
diff --git a/SOL004/hackfest_k8sproxycharm_ns/icons/osm.png b/SOL004/hackfest_k8sproxycharm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_k8sproxycharm_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/README b/SOL004/hackfest_k8sproxycharm_vnf/README
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitignore b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..722d5e71d93ca0aa0db6fd22452e46be5604a84d
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitignore
@@ -0,0 +1 @@
+.vscode
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitmodules b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitmodules
new file mode 100644
index 0000000000000000000000000000000000000000..fce0171f506bc643bbfa3604c306f6f3f49f72eb
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/.gitmodules
@@ -0,0 +1,9 @@
+[submodule "mod/operator"]
+	path = mod/operator
+	url = https://github.com/canonical/operator
+[submodule "mod/charms.osm"]
+	path = mod/charms.osm
+	url = https://github.com/charmed-osm/charms.osm
+[submodule "mod/charms"]
+	path = mod/charms
+	url = https://github.com/AdamIsrael/charms.requirementstxt
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/README.md b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..21d1a44c39ffa3b32b2d5d9cd0e38866b205641b
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/README.md
@@ -0,0 +1,52 @@
+# charm-simple-k8s
+
+This is a WORK IN PROGRESS example of a simple proxy charm used by Open Source Mano (OSM), written in the [Python Operator Framwork](https://github.com/canonical/operator)
+
+
+## Usage
+
+To get the charm:
+```bash
+git clone https://github.com/charmed-osm/charm-simple-k8s
+cd charm-simple-k8s
+# Install the submodules
+git submodule update --init
+```
+
+To configure the charm, you'll need to have an SSH-accessible machine. You'll need the hostname, and the username and password to login to. Password authentication is useful for testing but key-based authentication is preferred when deploying through OSM.
+
+To deploy to juju:
+```
+juju deploy . --config ssh-hostname=10.135.22.x --config ssh-username=ubuntu --config ssh-password=ubuntu --resource ubuntu_image=ubuntu/ubuntu:latest
+```
+
+```
+# Make sure the charm is in an Active state
+juju status
+```
+
+To test the SSH credentials, run the `verify-ssh-credentials` action and inspect it's output:
+```
+$ juju run-action simple-k8s/0 verify-ssh-credentials
+Action queued with id: "9"
+
+$ juju show-action-output 9
+UnitId: simple-k8s/0
+results:
+  Stdout: |
+    Verified!
+  verified: "True"
+status: completed
+timing:
+  completed: 2020-02-14 19:30:38 +0000 UTC
+  enqueued: 2020-02-14 19:30:33 +0000 UTC
+  started: 2020-02-14 19:30:36 +0000 UTC
+```
+
+To exercise the charm, run the `touch` function
+
+```
+juju run-action simple-k8s/0 touch filename=/home/ubuntu/firsttouch
+```
+
+Then ssh to the remote machine and verify that the file has been created.
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/actions.yaml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..956e1f1960e74cab1d30a5a7a68184339f8d8e09
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/actions.yaml
@@ -0,0 +1,38 @@
+touch:
+    description: "Touch a file on the VNF."
+    params:
+        filename:
+            description: "The name of the file to touch."
+            type: string
+            default: ""
+    required:
+        - filename
+
+# Standard OSM functions
+start:
+  description: "Stop the service on the VNF."
+stop:
+  description: "Stop the service on the VNF."
+restart:
+  description: "Stop the service on the VNF."
+reboot:
+  description: "Reboot the VNF virtual machine."
+upgrade:
+  description: "Upgrade the software on the VNF."
+
+# Required by charms.osm.sshproxy
+run:
+    description: "Run an arbitrary command"
+    params:
+        command:
+            description: "The command to execute."
+            type: string
+            default: ""
+    required:
+        - command
+generate-ssh-key:
+    description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+    description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+    description: "Get the public SSH key for this unit."
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/config.yaml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5b908ae0a19da5d540c59d887ab4ca7939ebdd08
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/config.yaml
@@ -0,0 +1,29 @@
+options:
+    ssh-hostname:
+        type: string
+        default: ""
+        description: "The hostname or IP address of the machine to"
+    ssh-username:
+        type: string
+        default: ""
+        description: "The username to login as."
+    ssh-password:
+        type: string
+        default: ""
+        description: "The password used to authenticate."
+    # ssh-private-key:
+    #     type: string
+    #     default: ""
+    #     description: "DEPRECATED. The private ssh key to be used to authenticate."
+    ssh-public-key:
+        type: string
+        default: ""
+        description: "The public key of this unit."
+    ssh-key-type:
+        type: string
+        default: "rsa"
+        description: "The type of encryption to use for the SSH key."
+    ssh-key-bits:
+        type: int
+        default: 4096
+        description: "The number of bits to use for the SSH key."
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/hooks/start b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/hooks/start
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/osm/sshproxy.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/osm/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..60057c925944a28019e457faee9600b3dea7badc
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/osm/sshproxy.py
@@ -0,0 +1,419 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# from charmhelpers.core import unitdata
+# from charmhelpers.core.hookenv import log
+
+import io
+import ipaddress
+import paramiko
+import os
+import socket
+import shlex
+import traceback
+
+from subprocess import (
+    check_call,
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+
+class SSHProxy:
+    private_key_path = "/root/.ssh/id_sshproxy"
+    public_key_path = "/root/.ssh/id_sshproxy.pub"
+    key_type = "rsa"
+    key_bits = 4096
+
+    def __init__(self, hostname: str, username: str, password: str = ""):
+        self.hostname = hostname
+        self.username = username
+        self.password = password
+
+    @staticmethod
+    def generate_ssh_key():
+        """Generate a 4096-bit rsa keypair."""
+        if not os.path.exists(SSHProxy.private_key_path):
+            cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+                SSHProxy.key_type, SSHProxy.key_bits, SSHProxy.private_key_path,
+            )
+
+            try:
+                check_call(cmd, shell=True)
+            except CalledProcessError:
+                return False
+
+        return True
+
+    @staticmethod
+    def get_ssh_public_key():
+        publickey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.public_key_path, "r") as f:
+                publickey = f.read()
+        return publickey
+
+    @staticmethod
+    def has_ssh_key():
+        if os.path.exists(SSHProxy.private_key_path):
+            return True
+        else:
+            return False
+
+    def run(self, cmd: str) -> (str, str):
+        """Run a command remotely via SSH.
+
+        Note: The previous behavior was to run the command locally if SSH wasn't
+        configured, but that can lead to cases where execution succeeds when you'd
+        expect it not to.
+        """
+        if isinstance(cmd, str):
+            cmd = shlex.split(cmd)
+
+        host = self._get_hostname()
+        user = self.username
+        passwd = self.password
+        key = self.private_key_path
+
+        # Make sure we have everything we need to connect
+        if host and user:
+            return self._ssh(cmd)
+
+        raise Exception("Invalid SSH credentials.")
+
+    def sftp(self, local, remote):
+        client = self._get_ssh_client()
+
+        # Create an sftp connection from the underlying transport
+        sftp = paramiko.SFTPClient.from_transport(client.get_transport())
+        sftp.put(local_file, remote_file)
+        client.close()
+        pass
+
+    def verify_credentials(self):
+        """Verify the SSH credentials."""
+        try:
+            (stdout, stderr) = self.run("hostname")
+        except CalledProcessError as e:
+            stderr = "Command failed: {} ({})".format(" ".join(e.cmd), str(e.output))
+        except paramiko.ssh_exception.AuthenticationException as e:
+            stderr = "{}.".format(e)
+        except paramiko.ssh_exception.BadAuthenticationType as e:
+            stderr = "{}".format(e.explanation)
+        except paramiko.ssh_exception.BadHostKeyException as e:
+            stderr = "Host key mismatch: expected {} but got {}.".format(
+                e.expected_key, e.got_key,
+            )
+        except (TimeoutError, socket.timeout):
+            stderr = "Timeout attempting to reach {}".format(cfg["ssh-hostname"])
+        except Exception as error:
+            tb = traceback.format_exc()
+            stderr = "Unhandled exception: {}".format(tb)
+
+        if len(stderr) == 0:
+            return True, stderr
+        return False, stderr
+
+    ###################
+    # Private methods #
+    ###################
+    def _get_hostname(self):
+        """Get the hostname for the ssh target.
+
+        HACK: This function was added to work around an issue where the
+        ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+        is the floating ip, and the second the non-floating ip, for an Openstack
+        instance.
+        """
+        return self.hostname.split(";")[0]
+
+    def _get_ssh_client(self):
+        """Return a connected Paramiko ssh object."""
+        client = paramiko.SSHClient()
+        client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+
+        pkey = None
+
+        # Otherwise, check for the auto-generated private key
+        if os.path.exists(self.private_key_path):
+            with open(self.private_key_path) as f:
+                pkey = paramiko.RSAKey.from_private_key(f)
+
+        ###########################################################################
+        # There is a bug in some versions of OpenSSH 4.3 (CentOS/RHEL 5) where    #
+        # the server may not send the SSH_MSG_USERAUTH_BANNER message except when #
+        # responding to an auth_none request. For example, paramiko will attempt  #
+        # to use password authentication when a password is set, but the server   #
+        # could deny that, instead requesting keyboard-interactive. The hack to   #
+        # workaround this is to attempt a reconnect, which will receive the right #
+        # banner, and authentication can proceed. See the following for more info #
+        # https://github.com/paramiko/paramiko/issues/432                         #
+        # https://github.com/paramiko/paramiko/pull/438                           #
+        ###########################################################################
+
+        try:
+            client.connect(
+                self.hostname,
+                port=22,
+                username=self.username,
+                password=self.password,
+                pkey=pkey
+        )
+        except paramiko.ssh_exception.SSHException as e:
+            if "Error reading SSH protocol banner" == str(e):
+                # Once more, with feeling
+                client.connect(
+                    host, port=22, username=user, password=password, pkey=pkey
+                )
+            else:
+                # Reraise the original exception
+                raise e
+
+        return client
+
+    def _ssh(self, cmd):
+        """Run an arbitrary command over SSH.
+
+        Returns a tuple of (stdout, stderr)
+        """
+        client = self._get_ssh_client()
+
+        cmds = " ".join(cmd)
+        stdin, stdout, stderr = client.exec_command(cmds, get_pty=True)
+        retcode = stdout.channel.recv_exit_status()
+        client.close()  # @TODO re-use connections
+        if retcode > 0:
+            output = stderr.read().strip()
+            raise CalledProcessError(returncode=retcode, cmd=cmd, output=output)
+        return (
+            stdout.read().decode("utf-8").strip(),
+            stderr.read().decode("utf-8").strip(),
+        )
+
+
+## OLD ##
+
+# def get_config():
+#     """Get the current charm configuration.
+
+#     Get the "live" kv store every time we need to access the charm config, in
+#     case it has recently been changed by a config-changed event.
+#     """
+#     db = unitdata.kv()
+#     return db.get('config')
+
+
+# def get_host_ip():
+#     """Get the IP address for the ssh host.
+
+#     HACK: This function was added to work around an issue where the
+#     ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+#     is the floating ip, and the second the non-floating ip, for an Openstack
+#     instance.
+#     """
+#     cfg = get_config()
+#     return cfg['ssh-hostname'].split(';')[0]
+
+
+# def is_valid_hostname(hostname):
+#     """Validate the ssh-hostname."""
+#     print("Hostname: {}".format(hostname))
+#     if hostname == "0.0.0.0":
+#         return False
+
+#     try:
+#         ipaddress.ip_address(hostname)
+#     except ValueError:
+#         return False
+
+#     return True
+
+
+# def verify_ssh_credentials():
+#     """Verify the ssh credentials have been installed to the VNF.
+
+#     Attempts to run a stock command - `hostname` on the remote host.
+#     """
+#     verified = False
+#     status = ''
+#     cfg = get_config()
+
+#     try:
+#         host = get_host_ip()
+#         if is_valid_hostname(host):
+#             if len(cfg['ssh-hostname']) and len(cfg['ssh-username']):
+#                 cmd = 'hostname'
+#                 status, err = _run(cmd)
+
+#                 if len(err) == 0:
+#                     verified = True
+#         else:
+#             status = "Invalid IP address."
+#     except CalledProcessError as e:
+#         status = 'Command failed: {} ({})'.format(
+#             ' '.join(e.cmd),
+#             str(e.output)
+#         )
+#     except paramiko.ssh_exception.AuthenticationException as e:
+#         status = '{}.'.format(e)
+#     except paramiko.ssh_exception.BadAuthenticationType as e:
+#         status = '{}'.format(e.explanation)
+#     except paramiko.ssh_exception.BadHostKeyException as e:
+#         status = 'Host key mismatch: expected {} but got {}.'.format(
+#             e.expected_key,
+#             e.got_key,
+#         )
+#     except (TimeoutError, socket.timeout):
+#         status = "Timeout attempting to reach {}".format(cfg['ssh-hostname'])
+#     except Exception as error:
+#         tb = traceback.format_exc()
+#         status = 'Unhandled exception: {}'.format(tb)
+
+#     return (verified, status)
+
+
+# def charm_dir():
+#     """Return the root directory of the current charm."""
+#     d = os.environ.get('JUJU_CHARM_DIR')
+#     if d is not None:
+#         return d
+#     return os.environ.get('CHARM_DIR')
+
+
+# def run_local(cmd, env=None):
+#     """Run a command locally."""
+#     if isinstance(cmd, str):
+#         cmd = shlex.split(cmd) if ' ' in cmd else [cmd]
+
+#     if type(cmd) is not list:
+#         cmd = [cmd]
+
+#     p = Popen(cmd,
+#               env=env,
+#               shell=True,
+#               stdout=PIPE,
+#               stderr=PIPE)
+#     stdout, stderr = p.communicate()
+#     retcode = p.poll()
+#     if retcode > 0:
+#         raise CalledProcessError(returncode=retcode,
+#                                  cmd=cmd,
+#                                  output=stderr.decode("utf-8").strip())
+#     return (stdout.decode('utf-8').strip(), stderr.decode('utf-8').strip())
+
+
+# def _run(cmd, env=None):
+#     """Run a command remotely via SSH.
+
+#     Note: The previous behavior was to run the command locally if SSH wasn't
+#     configured, but that can lead to cases where execution succeeds when you'd
+#     expect it not to.
+#     """
+#     if isinstance(cmd, str):
+#         cmd = shlex.split(cmd)
+
+#     if type(cmd) is not list:
+#         cmd = [cmd]
+
+#     cfg = get_config()
+
+#     if cfg:
+#         if all(k in cfg for k in ['ssh-hostname', 'ssh-username',
+#                                   'ssh-password', 'ssh-private-key']):
+#             host = get_host_ip()
+#             user = cfg['ssh-username']
+#             passwd = cfg['ssh-password']
+#             key = cfg['ssh-private-key']  # DEPRECATED
+
+#             if host and user:
+#                 return ssh(cmd, host, user, passwd, key)
+
+#     raise Exception("Invalid SSH credentials.")
+
+
+# def get_ssh_client(host, user, password=None, key=None):
+#     """Return a connected Paramiko ssh object."""
+#     client = paramiko.SSHClient()
+#     client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+
+#     pkey = None
+
+#     # Check for the DEPRECATED private-key
+#     if key:
+#         f = io.StringIO(key)
+#         pkey = paramiko.RSAKey.from_private_key(f)
+#     else:
+#         # Otherwise, check for the auto-generated private key
+#         if os.path.exists('/root/.ssh/id_juju_sshproxy'):
+#             with open('/root/.ssh/id_juju_sshproxy', 'r') as f:
+#                 pkey = paramiko.RSAKey.from_private_key(f)
+
+#     ###########################################################################
+#     # There is a bug in some versions of OpenSSH 4.3 (CentOS/RHEL 5) where    #
+#     # the server may not send the SSH_MSG_USERAUTH_BANNER message except when #
+#     # responding to an auth_none request. For example, paramiko will attempt  #
+#     # to use password authentication when a password is set, but the server   #
+#     # could deny that, instead requesting keyboard-interactive. The hack to   #
+#     # workaround this is to attempt a reconnect, which will receive the right #
+#     # banner, and authentication can proceed. See the following for more info #
+#     # https://github.com/paramiko/paramiko/issues/432                         #
+#     # https://github.com/paramiko/paramiko/pull/438                           #
+#     ###########################################################################
+
+#     try:
+#         client.connect(host, port=22, username=user,
+#                        password=password, pkey=pkey)
+#     except paramiko.ssh_exception.SSHException as e:
+#         if 'Error reading SSH protocol banner' == str(e):
+#             # Once more, with feeling
+#             client.connect(host, port=22, username=user,
+#                            password=password, pkey=pkey)
+#         else:
+#             # Reraise the original exception
+#             raise e
+
+#     return client
+
+
+# def sftp(local_file, remote_file, host, user, password=None, key=None):
+#     """Copy a local file to a remote host."""
+#     client = get_ssh_client(host, user, password, key)
+
+#     # Create an sftp connection from the underlying transport
+#     sftp = paramiko.SFTPClient.from_transport(client.get_transport())
+#     sftp.put(local_file, remote_file)
+#     client.close()
+
+
+# def ssh(cmd, host, user, password=None, key=None):
+#     """Run an arbitrary command over SSH."""
+#     client = get_ssh_client(host, user, password, key)
+
+#     cmds = ' '.join(cmd)
+#     stdin, stdout, stderr = client.exec_command(cmds, get_pty=True)
+#     retcode = stdout.channel.recv_exit_status()
+#     client.close()  # @TODO re-use connections
+#     if retcode > 0:
+#         output = stderr.read().strip()
+#         raise CalledProcessError(returncode=retcode, cmd=cmd,
+#                                  output=output)
+#     return (
+#         stdout.read().decode('utf-8').strip(),
+#         stderr.read().decode('utf-8').strip()
+#     )
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/requirementstxt.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/requirementstxt.py
new file mode 100644
index 0000000000000000000000000000000000000000..298d584530ba46f0d7941b88c870a4fe20b6c44f
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/charms/requirementstxt.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+# Requirements.txt support
+
+import sys
+
+sys.path.append("lib")
+
+from ops.framework import StoredState
+
+import os
+import subprocess
+import sys
+from remote_pdb import RemotePdb
+
+REQUIREMENTS_TXT = "{}/requirements.txt".format(os.environ["JUJU_CHARM_DIR"])
+
+
+def install_requirements():
+    if os.path.exists(REQUIREMENTS_TXT):
+
+        # First, make sure python3 and python3-pip are installed
+        if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+            # Update the apt cache
+            subprocess.check_call(["apt-get", "update"])
+            # Install the Python3 package
+            subprocess.check_call(
+                ["apt-get", "install", "-y", "python3", "python3-pip", "python3-paramiko"],
+                # Eat stdout so it's not returned in an action's stdout
+                # TODO: redirect to a file handle and log to juju log
+                # stdout=subprocess.DEVNULL,
+            )
+
+        # Lastly, install the python requirements
+        cmd = [sys.executable, "-m", "pip", "install", "-r", REQUIREMENTS_TXT]
+        # stdout = subprocess.check_output(cmd)
+        p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=True)
+    
+        stdout, stderr = p.communicate()
+
+        print(stdout)
+        print(stderr)
+        #     subprocess.check_call([sys.executable, "-m", "pip", "install", "-r", REQUIREMENTS_TXT],
+        #     # Eat stdout so it's not returned in an action's stdout
+        #     # TODO: redirect to a file handle and log to juju log
+        #     # stdout=subprocess.DEVNULL,
+        # )
+
+
+# Use StoredState to make sure we're run exactly once automatically
+# RemotePdb('127.0.0.1', 4444).set_trace()
+
+state = StoredState()
+
+installed = getattr(state, "requirements_txt_installed", None)
+if not installed:
+    install_requirements()
+    state.requirements_txt_installed = True
+
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/__init__.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..71472f963a82461a02fe36a0aa47260151f4cafe
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/charm.py
@@ -0,0 +1,306 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, EventsBase
+
+
+class HookEvent(EventBase):
+    pass
+
+
+class ActionEvent(EventBase):
+
+    def defer(self):
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot):
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results):
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message):
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message=''):
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    pass
+
+
+class StartEvent(HookEvent):
+    pass
+
+
+class StopEvent(HookEvent):
+    pass
+
+
+class ConfigChangedEvent(HookEvent):
+    pass
+
+
+class UpdateStatusEvent(HookEvent):
+    pass
+
+
+class UpgradeCharmEvent(HookEvent):
+    pass
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class LeaderElectedEvent(HookEvent):
+    pass
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    pass
+
+
+class RelationEvent(HookEvent):
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit and unit.app != app:
+            raise RuntimeError(f'cannot create RelationEvent with application {app} and unit {unit}')
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self):
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot):
+        self.relation = self.framework.model.get_relation(snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationJoinedEvent(RelationEvent):
+    pass
+
+
+class RelationChangedEvent(RelationEvent):
+    pass
+
+
+class RelationDepartedEvent(RelationEvent):
+    pass
+
+
+class RelationBrokenEvent(RelationEvent):
+    pass
+
+
+class StorageEvent(HookEvent):
+    pass
+
+
+class StorageAttachedEvent(StorageEvent):
+    pass
+
+
+class StorageDetachingEvent(StorageEvent):
+    pass
+
+
+class CharmEvents(EventsBase):
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+
+
+class CharmBase(Object):
+
+    on = CharmEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(f'{relation_name}_relation_joined', RelationJoinedEvent)
+            self.on.define_event(f'{relation_name}_relation_changed', RelationChangedEvent)
+            self.on.define_event(f'{relation_name}_relation_departed', RelationDepartedEvent)
+            self.on.define_event(f'{relation_name}_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(f'{storage_name}_storage_attached', StorageAttachedEvent)
+            self.on.define_event(f'{storage_name}_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(f'{action_name}_action', ActionEvent)
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+    """
+
+    def __init__(self, raw={}, actions_raw={}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta('requires', name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta('provides', name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta('peers', name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', [])
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(cls, metadata, actions=None):
+        meta = yaml.safe_load(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = yaml.safe_load(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition."""
+
+    def __init__(self, role, relation_name, raw):
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/framework.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..d95eb61fae1c8a0207687ab759f15ab6399ca4db
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/framework.py
@@ -0,0 +1,941 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pickle
+import marshal
+import types
+import sqlite3
+import collections
+import collections.abc
+import keyword
+import weakref
+from datetime import timedelta
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = f"{parent}/{kind}[{key}]"
+            else:
+                self._path = f"{parent}/{kind}"
+        else:
+            if key:
+                self._path = f"{kind}[{key}]"
+            else:
+                self._path = f"{kind}"
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {path}")
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(f"Event requires a subclass of EventBase as an argument, got {event_type}")
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def __set_name__(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                f'EventSource({self.event_type.__name__}) reused as '
+                f'{self.emitter_type.__name__}.{self.event_kind} and '
+                f'{emitter_type.__name__}.{event_kind}')
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event rather than charm_instance.on.event,
+        # but in that case it couldn't be emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return (f'<BoundEvent {self.event_type.__name__} bound to '
+                f'{type(self.emitter).__name__}.{self.event_kind} '
+                f'at {hex(id(self))}>')
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class Object:
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+    @property
+    def meta(self):
+        return self.framework.meta
+
+    @property
+    def charm_dir(self):
+        return self.framework.charm_dir
+
+
+class EventsBase(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls -- a type to define an event on.
+        event_kind -- an attribute name that will be used to access the event. Must be a valid python identifier, not be a keyword or an existing attribute.
+        event_type -- a type of the event to define.
+        """
+        if not event_kind.isidentifier():
+            raise RuntimeError(f'unable to define an event with event_kind that is not a valid python identifier: {event_kind}')
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(f'unable to define an event with event_kind that is a python keyword: {event_kind}')
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(f'unable to define an event with event_kind that overlaps with an existing type {cls} attribute: {event_kind}')
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor.__set_name__(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(EventsBase):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f'no snapshot data found for {self.handle_path} object'
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f"cannot restore {self.handle_path} since no class was registered for it"
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename), isolation_level=None, timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed, not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute("CREATE TABLE notice (sequence INTEGER PRIMARY KEY AUTOINCREMENT, event_path TEXT, observer_path TEXT, method_name TEXT)")
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path, snapshot_data):
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, snapshot_data))
+
+    def load_snapshot(self, handle_path):
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return row[0]
+        return None
+
+    def drop_snapshot(self, handle_path):
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def save_notice(self, event_path, observer_path, method_name):
+        self._db.execute("INSERT INTO notice VALUES (NULL, ?, ?, ?)", (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path, observer_path, method_name):
+        self._db.execute("DELETE FROM notice WHERE event_path=? AND observer_path=? AND method_name=?", (event_path, observer_path, method_name))
+
+    def notices(self, event_path):
+        if event_path:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice WHERE event_path=? ORDER BY sequence", (event_path,))
+        else:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice ORDER BY sequence")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, data_path, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self._data_path = data_path
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        self._storage = SQLiteStorage(data_path)
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(f"two objects claiming to be {obj.handle.path} have been created")
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(f"cannot save {type(value).__name__} values before registering that type")
+        data = value.snapshot()
+        # Use marshal as a validator, enforcing the use of simple types.
+        marshal.dumps(data)
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(data)
+        self._storage.save_snapshot(value.handle.path, raw_data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        raw_data = self._storage.load_snapshot(handle.path)
+        if not raw_data:
+            raise NoSnapshotError(handle.path)
+        data = pickle.loads(raw_data)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event, observer):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self.on_something_happened)
+
+        If the method to be called follows the name convention "on_<event name>", it
+        may be omitted from the observe call. That means the above is equivalent to:
+
+            framework.observe(someobj.something_happened, self)
+
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(f'Framework.observe requires a BoundEvent as second parameter, got {bound_event}')
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(f'event emitter {type(emitter).__name__} must have a "handle" attribute')
+
+        method_name = None
+        if isinstance(observer, types.MethodType):
+            method_name = observer.__name__
+            observer = observer.__self__
+        else:
+            method_name = "on_" + event_kind
+            if not hasattr(observer, method_name):
+                raise RuntimeError(f'Observer method not provided explicitly and {type(observer).__name__} type has no "{method_name}" method')
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(getattr(observer, method_name))
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+        if not sig.parameters:
+            raise TypeError(f'{type(observer).__name__}.{method_name} must accept event parameter')
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(f'{type(observer).__name__}.{method_name} has extra required parameter')
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0 means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        # Save the event for all known observers before the first notification
+        # takes place, so that either everyone interested sees it, or nobody does.
+        self.save_snapshot(event)
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred:
+            self._storage.drop_snapshot(last_event_path)
+
+
+class StoredStateChanged(EventBase):
+    pass
+
+
+class StoredStateEvents(EventsBase):
+    changed = EventSource(StoredStateChanged)
+
+
+class StoredStateData(Object):
+
+    on = StoredStateEvents()
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError(f"attribute '{key}' is not stored")
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError(f"attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, str, bytes, list, dict, set)):
+            raise AttributeError(f"attribute '{key}' cannot be set to {type(value).__name__}: must be int/dict/list/etc")
+
+        self._data[key] = _unwrap_stored(self._data, value)
+        self.on.changed.emit()
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is None:
+            self.parent_type = parent_type
+        elif self.parent_type is not parent_type:
+            raise RuntimeError("StoredState shared by {} and {}".format(self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            return self
+
+        bound = parent.__dict__.get(self.attr_name)
+        if bound is None:
+            for attr_name, attr_value in parent_type.__dict__.items():
+                if attr_value is self:
+                    if self.attr_name and attr_name != self.attr_name:
+                        parent_tname = parent_type.__name__
+                        raise RuntimeError(f"StoredState shared by {parent_tname}.{self.attr_name} and {parent_tname}.{attr_name}")
+                    self.attr_name = attr_name
+                    bound = BoundStoredState(parent, attr_name)
+                    parent.__dict__[attr_name] = bound
+                    break
+            else:
+                raise RuntimeError("cannot find StoredVariable attribute in type {}".format(parent_type.__name__))
+
+        return bound
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/jujuversion.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..5256f24ff8fb37a2cbe6162d824e77fb7dca1f45
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/jujuversion.py
@@ -0,0 +1,77 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'^(?P<major>\d{1,9})\.(?P<minor>\d{1,9})((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))?(\.(?P<build>\d{1,9}))?$'
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version)
+        if not m:
+            raise RuntimeError(f'"{version}" is not a valid Juju version string')
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = f'{self.major}.{self.minor}-{self.tag}{self.patch}'
+        else:
+            s = f'{self.major}.{self.minor}.{self.patch}'
+        if self.build > 0:
+            s += f'.{self.build}'
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+        return self.major == other.major and self.minor == other.minor\
+            and self.tag == other.tag and self.build == other.build and self.patch == other.patch
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/main.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..c8d5da2adf1b4f6ccdb3a0b1292dcab8d51c0e9b
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/main.py
@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+def debugf(format, *args, **kwargs):
+    pass
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path(f'{__file__}/../../..').resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _load_metadata(charm_dir):
+    metadata = yaml.safe_load((charm_dir / 'metadata.yaml').read_text())
+
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = yaml.safe_load(actions_meta.read_text())
+    else:
+        actions_metadata = {}
+    return metadata, actions_metadata
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(f"action event name {bound_event.event_kind} needs _action suffix")
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(f'cannot create a symlink: unsupported event type {bound_event.event_type}')
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows. For Windows
+        # it is always an absolute path (any symlinks are resolved) while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), event_dir)
+
+        # Ignore the non-symlink files or directories assuming the charm author knows what they are doing.
+        debugf(f'Creating a new relative symlink at {event_path} pointing to {target_path}')
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file which is determined by inspecting
+    symlinks provided by the charm author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        debugf(f"event {event_name} not defined for {charm}")
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        debugf(f'Emitting Juju event {event_name}')
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError(f'invalid remote unit name: {remote_unit_name}')
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+def main(charm_class):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+
+    charm_dir = _get_charm_dir()
+
+    # Process the Juju event relevant to the current hook execution
+    # JUJU_HOOK_NAME, JUJU_FUNCTION_NAME, and JUJU_ACTION_NAME are not used
+    # in order to support simulation of events from debugging sessions.
+    # TODO: For Windows, when symlinks are used, this is not a valid method of getting an event name (see LP: #1854505).
+    juju_exec_path = Path(sys.argv[0])
+    juju_event_name = juju_exec_path.name.replace('-', '_')
+    if juju_exec_path.parent.name == 'actions':
+        juju_event_name = f'{juju_event_name}_action'
+
+    metadata, actions_metadata = _load_metadata(charm_dir)
+    meta = ops.charm.CharmMeta(metadata, actions_metadata)
+    unit_name = os.environ['JUJU_UNIT_NAME']
+    model = ops.model.Model(unit_name, meta, ops.model.ModelBackend())
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    framework = ops.framework.Framework(charm_state_path, charm_dir, meta, model)
+    try:
+        charm = charm_class(framework, None)
+
+        # When a charm is force-upgraded and a unit is in an error state Juju does not run upgrade-charm and
+        # instead runs the failed hook followed by config-changed. Given the nature of force-upgrading
+        # the hook setup code is not triggered on config-changed.
+        # 'start' event is included as Juju does not fire the install event for K8s charms (see LP: #1854635).
+        if juju_event_name in ('install', 'start', 'upgrade_charm') or juju_event_name.endswith('_storage_attached'):
+            _setup_event_links(charm_dir, charm)
+
+        framework.reemit()
+
+        _emit_charm_event(charm, juju_event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/model.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..a12dcca2b1a85b3ed4a0983b88073f9f8c7bcb42
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/lib/ops/model.py
@@ -0,0 +1,679 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import weakref
+import os
+import shutil
+import tempfile
+import time
+import datetime
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+
+class Model:
+
+    def __init__(self, unit_name, meta, backend):
+        self._cache = ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+
+    def get_unit(self, unit_name):
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name):
+        return self._cache.get(Application, app_name)
+
+    def get_relation(self, relation_name, relation_id=None):
+        """Get a specific Relation instance.
+
+        If relation_id is given, this will return that Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+
+class ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for application {self} status: {value}')
+
+        if not self._is_our_app:
+            raise RuntimeError(f'cannot to set status for a remote application {self}')
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+
+class Unit:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for unit {self} status: {value}')
+
+        if not self._is_our_unit:
+            raise RuntimeError(f'cannot set status for a remote unit {self}')
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+    def is_leader(self):
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(f"cannot determine leadership status for remote applications: {self}")
+
+
+class LazyMapping(Mapping, ABC):
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of Relation instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role == 'peers':
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer, self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError(f'relation name {relation_id} must be int or None not {type(relation_id).__name__}')
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer, self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class Relation:
+    def __init__(self, relation_name, relation_id, is_peer, our_unit, backend, cache):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}:{self.id}>'
+
+
+class RelationData(Mapping):
+    def __init__(self, relation, our_unit, backend):
+        self.relation = weakref.proxy(relation)
+        self._data = {our_unit: RelationDataContent(self.relation, our_unit, backend)}
+        self._data.update({our_unit.app: RelationDataContent(self.relation, our_unit.app, backend)})
+        self._data.update({unit: RelationDataContent(self.relation, unit, backend) for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app:
+            self._data.update({self.relation.app: RelationDataContent(self.relation, self.relation.app, backend)})
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on whether this unit is a leader or not,
+            # but this is not guaranteed to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError(f'cannot set relation data for {self._entity.name}')
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an empty string will
+                # remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty string will
+        # remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units."""
+
+    _statuses = {}
+
+    def __init__(self, message):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        cls._statuses[cls.name] = cls
+        return super().__new__(cls)
+
+    @classmethod
+    def from_name(cls, name, message):
+        return cls._statuses[name](message)
+
+
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message=None):
+        super().__init__(message or '')
+
+
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation for providing those services.
+    This is a "spinning" state, not an error state. It reflects activity on the unit itself, not on peers or related units.
+    """
+    name = 'maintenance'
+
+
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the charm has not called status-set yet.
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which it is related is not running.
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names, backend):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name):
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError(f'invalid resource name: {name}')
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    def __init__(self, backend):
+        self._backend = backend
+
+    def set_spec(self, spec, k8s_resources=None):
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names, backend):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name):
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name, count=1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(f'cannot add storage with {storage_name} as it is not present in the charm metadata')
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            self._location = Path(self._backend.storage_get(f'{self.name}/{self.id}', "location"))
+        return self._location
+
+
+class ModelError(Exception):
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__(f'Too many remote applications on {relation_name} ({num_related} > {max_supported})')
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    pass
+
+
+class RelationNotFoundError(ModelError):
+    pass
+
+
+class InvalidStatusError(ModelError):
+    pass
+
+
+class ModelBackend:
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self):
+        self.unit_name = os.environ['JUJU_UNIT_NAME']
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = 0
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id), return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        try:
+            return self._run('relation-get', '-r', str(relation_id), '-', member_name, f'--app={is_app}', return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        try:
+            return self._run('relation-set', '-r', str(relation_id), f'{key}={value}', f'--app={is_app}')
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+        if time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(tmpdir)
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+        app -- A boolean indicating whether the status should be retrieved for a unit or an application.
+        """
+        return self._run('status-get', '--include-data', f'--application={is_app}')
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+        app -- A boolean indicating whether the status should be set for a unit or an application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', f'--application={is_app}', status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name, return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute, return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError(f'storage count must be integer, got: {count} ({type(count)})')
+        self._run('storage-add', f'{name}={count}')
+
+    def action_get(self):
+        return self._run(f'action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run(f'action-set', *[f"{k}={v}" for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run(f'action-log', f"{message}")
+
+    def action_fail(self, message=''):
+        self._run(f'action-fail', f"{message}")
+
+    def network_get(self, endpoint_name, relation_id=None):
+        """Return network info provided by network-get for a given endpoint.
+
+        endpoint_name -- A name of an endpoint (relation name or extra-binding name).
+        relation_id -- An optional relation id to get network info for.
+        """
+        cmd = ['network-get', endpoint_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/metadata.yaml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..fb67ecbf117ecf6a48be11cf1985861aee60bb89
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/metadata.yaml
@@ -0,0 +1,8 @@
+name: simple-k8s
+summary: A simple example Kubernetes charm
+description: |
+    Simple is an example charm used in OSM Hackfests
+series:
+   - kubernetes
+deployment:
+   mode: operator
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/LICENSE b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/README.md b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..a5d80722e22eaf984532d0f2ac208e3085c4f469
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/README.md
@@ -0,0 +1,67 @@
+# charms.osm
+A Python library to aid the development of charms for Open Source Mano (OSM)
+
+## SSHProxy
+
+Example:
+
+```python
+from charms.osm.sshproxy import SSHProxy
+
+# Check if SSH Proxy has key
+if not SSHProxy.has_ssh_key():
+    # Generate SSH Key
+    SSHProxy.generate_ssh_key()
+
+# Get generated public and private keys
+SSHProxy.get_ssh_public_key()
+SSHProxy.get_ssh_private_key()
+
+# Get Proxy
+proxy = SSHProxy(
+    hostname=config["ssh-hostname"],
+    username=config["ssh-username"],
+    password=config["ssh-password"],
+)
+
+# Verify credentials
+verified = proxy.verify_credentials()
+
+if verified:
+    # Run commands in remote machine
+    proxy.run("touch /home/ubuntu/touch")
+```
+
+## Libansible
+
+```python
+from charms.osm import libansible
+
+# Install ansible packages in the charm
+libansible.install_ansible_support()
+
+result = libansible.execute_playbook(
+    "configure-remote.yaml",  # Name of the playbook <-- Put the playbook in playbooks/ folder
+    config["ssh-hostname"],
+    config["ssh-username"],
+    config["ssh-password"],
+    dict_vars,  # Dictionary with variables to populate in the playbook
+)
+```
+
+## Usage
+
+Import submodules:
+
+```bash
+git submodule add https://github.com/charmed-osm/charms.osm mod/charms.osm
+git submodule add https://github.com/juju/charm-helpers.git mod/charm-helpers  # Only for libansible
+```
+
+Add symlinks:
+
+```bash
+mkdir -p lib/charms
+ln -s ../mod/charms.osm/charms/osm lib/charms/osm
+ln -s ../mod/charm-helpers/charmhelpers lib/charmhelpers  # Only for libansible
+```
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/libansible.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/libansible.py
new file mode 100644
index 0000000000000000000000000000000000000000..32fd26ae7d63d42edef33982d5438669b191a361
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/libansible.py
@@ -0,0 +1,108 @@
+##
+# Copyright 2020 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+import fnmatch
+import os
+import yaml
+import subprocess
+import sys
+
+sys.path.append("lib")
+import charmhelpers.fetch
+
+
+ansible_hosts_path = "/etc/ansible/hosts"
+
+
+def install_ansible_support(from_ppa=True, ppa_location="ppa:ansible/ansible"):
+    """Installs the ansible package.
+
+    By default it is installed from the `PPA`_ linked from
+    the ansible `website`_ or from a ppa specified by a charm config..
+
+    .. _PPA: https://launchpad.net/~rquillo/+archive/ansible
+    .. _website: http://docs.ansible.com/intro_installation.html#latest-releases-via-apt-ubuntu
+
+    If from_ppa is empty, you must ensure that the package is available
+    from a configured repository.
+    """
+    if from_ppa:
+        charmhelpers.fetch.add_source(ppa_location)
+        charmhelpers.fetch.apt_update(fatal=True)
+    charmhelpers.fetch.apt_install("ansible")
+    with open(ansible_hosts_path, "w+") as hosts_file:
+        hosts_file.write("localhost ansible_connection=local")
+
+
+def create_hosts(hostname, username, password, hosts):
+    inventory_path = "/etc/ansible/hosts"
+
+    with open(inventory_path, "w") as f:
+        f.write("[{}]\n".format(hosts))
+        h1 = "host ansible_host={0} ansible_user={1} ansible_password={2}\n".format(
+            hostname, username, password
+        )
+        f.write(h1)
+
+
+def create_ansible_cfg():
+    ansible_config_path = "/etc/ansible/ansible.cfg"
+
+    with open(ansible_config_path, "w") as f:
+        f.write("[defaults]\n")
+        f.write("host_key_checking = False\n")
+
+
+# Function to find the playbook path
+def find(pattern, path):
+    result = ""
+    for root, dirs, files in os.walk(path):
+        for name in files:
+            if fnmatch.fnmatch(name, pattern):
+                result = os.path.join(root, name)
+    return result
+
+
+def execute_playbook(playbook_file, hostname, user, password, vars_dict=None):
+    playbook_path = find(playbook_file, "/var/lib/juju/agents/")
+
+    with open(playbook_path, "r") as f:
+        playbook_data = yaml.load(f)
+
+    hosts = "all"
+    if "hosts" in playbook_data[0].keys() and playbook_data[0]["hosts"]:
+        hosts = playbook_data[0]["hosts"]
+
+    create_ansible_cfg()
+    create_hosts(hostname, user, password, hosts)
+
+    call = "ansible-playbook {} ".format(playbook_path)
+
+    if vars_dict and isinstance(vars_dict, dict) and len(vars_dict) > 0:
+        call += "--extra-vars "
+
+        string_var = ""
+        for k,v in vars_dict.items():
+            string_var += "{}={} ".format(k, v)
+
+        string_var = string_var.strip()
+        call += '"{}"'.format(string_var)
+
+    call = call.strip()
+    result = subprocess.check_output(call, shell=True)
+
+    return result
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/ns.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/ns.py
new file mode 100644
index 0000000000000000000000000000000000000000..25be4056282e48ce946632025be8b466557e3171
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/ns.py
@@ -0,0 +1,301 @@
+# A prototype of a library to aid in the development and operation of
+# OSM Network Service charms
+
+import asyncio
+import logging
+import os
+import os.path
+import re
+import subprocess
+import sys
+import time
+import yaml
+
+try:
+    import juju
+except ImportError:
+    # Not all cloud images are created equal
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # Update the apt cache
+        subprocess.check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        subprocess.check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+
+    # Install the libjuju build dependencies
+    subprocess.check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    subprocess.check_call(
+        [sys.executable, "-m", "pip", "install", "juju"],
+    )
+
+from juju.controller import Controller
+
+# Quiet the debug logging
+logging.getLogger('websockets.protocol').setLevel(logging.INFO)
+logging.getLogger('juju.client.connection').setLevel(logging.WARN)
+logging.getLogger('juju.model').setLevel(logging.WARN)
+logging.getLogger('juju.machine').setLevel(logging.WARN)
+
+
+class NetworkService:
+    """A lightweight interface to the Juju controller.
+
+    This NetworkService client is specifically designed to allow a higher-level
+    "NS" charm to interoperate with "VNF" charms, allowing for the execution of
+    Primitives across other charms within the same model.
+    """
+    endpoint = None
+    user = 'admin'
+    secret = None
+    port = 17070
+    loop = None
+    client = None
+    model = None
+    cacert = None
+
+    def __init__(self, user, secret, endpoint=None):
+
+        self.user = user
+        self.secret = secret
+        if endpoint is None:
+            addresses = os.environ['JUJU_API_ADDRESSES']
+            for address in addresses.split(' '):
+                self.endpoint = address
+        else:
+            self.endpoint = endpoint
+
+        # Stash the name of the model
+        self.model = os.environ['JUJU_MODEL_NAME']
+
+        # Load the ca-cert from agent.conf
+        AGENT_PATH = os.path.dirname(os.environ['JUJU_CHARM_DIR'])
+        with open("{}/agent.conf".format(AGENT_PATH), "r") as f:
+            try:
+                y = yaml.safe_load(f)
+                self.cacert = y['cacert']
+            except yaml.YAMLError as exc:
+                print("Unable to find Juju ca-cert.")
+                raise exc
+
+        # Create our event loop
+        self.loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(self.loop)
+
+    async def connect(self):
+        """Connect to the Juju controller."""
+        controller = Controller()
+
+        print(
+            "Connecting to controller... ws://{}:{} as {}/{}".format(
+                self.endpoint,
+                self.port,
+                self.user,
+                self.secret[-4:].rjust(len(self.secret), "*"),
+            )
+        )
+        await controller.connect(
+            endpoint=self.endpoint,
+            username=self.user,
+            password=self.secret,
+            cacert=self.cacert,
+        )
+
+        return controller
+
+    def __del__(self):
+        self.logout()
+
+    async def disconnect(self):
+        """Disconnect from the Juju controller."""
+        if self.client:
+            print("Disconnecting Juju controller")
+            await self.client.disconnect()
+
+    def login(self):
+        """Login to the Juju controller."""
+        if not self.client:
+            # Connect to the Juju API server
+            self.client = self.loop.run_until_complete(self.connect())
+        return self.client
+
+    def logout(self):
+        """Logout of the Juju controller."""
+
+        if self.loop:
+            print("Disconnecting from API")
+            self.loop.run_until_complete(self.disconnect())
+
+    def FormatApplicationName(self, *args):
+        """
+        Generate a Juju-compatible Application name
+
+        :param args tuple: Positional arguments to be used to construct the
+        application name.
+
+        Limitations::
+        - Only accepts characters a-z and non-consequitive dashes (-)
+        - Application name should not exceed 50 characters
+
+        Examples::
+
+            FormatApplicationName("ping_pong_ns", "ping_vnf", "a")
+        """
+        appname = ""
+        for c in "-".join(list(args)):
+            if c.isdigit():
+                c = chr(97 + int(c))
+            elif not c.isalpha():
+                c = "-"
+            appname += c
+
+        return re.sub('-+', '-', appname.lower())
+
+    def GetApplicationName(self, nsr_name, vnf_name, vnf_member_index):
+        """Get the runtime application name of a VNF/VDU.
+
+        This will generate an application name matching the name of the deployed charm,
+        given the right parameters.
+
+        :param nsr_name str: The name of the running Network Service, as specified at instantiation.
+        :param vnf_name str: The name of the VNF or VDU
+        :param vnf_member_index: The vnf-member-index as specified in the descriptor
+        """
+
+        application_name = self.FormatApplicationName(nsr_name, vnf_member_index, vnf_name)
+
+        # This matches the logic used by the LCM
+        application_name = application_name[0:48]
+        vca_index = int(vnf_member_index) - 1
+        application_name += '-' + chr(97 + vca_index // 26) + chr(97 + vca_index % 26)
+
+        return application_name
+
+    def ExecutePrimitiveGetOutput(self, application, primitive, params={}, timeout=600):
+        """Execute a single primitive and return it's output.
+
+        This is a blocking method that will execute a single primitive and wait
+        for its completion before return it's output.
+
+        :param application str: The application name provided by `GetApplicationName`.
+        :param primitive str: The name of the primitive to execute.
+        :param params list: A list of parameters.
+        :param timeout int: A timeout, in seconds, to wait for the primitive to finish. Defaults to 600 seconds.
+        """
+        uuid = self.ExecutePrimitive(application, primitive, params)
+
+        status = None
+        output = None
+
+        starttime = time.time()
+        while(time.time() < starttime + timeout):
+            status = self.GetPrimitiveStatus(uuid)
+            if status in ['completed', 'failed']:
+                break
+            time.sleep(10)
+
+        # When the primitive is done, get the output
+        if status in ['completed', 'failed']:
+            output = self.GetPrimitiveOutput(uuid)
+
+        return output
+
+    def ExecutePrimitive(self, application, primitive, params={}):
+        """Execute a primitive.
+
+        This is a non-blocking method to execute a primitive. It will return
+        the UUID of the queued primitive execution, which you can use
+        for subsequent calls to `GetPrimitiveStatus` and `GetPrimitiveOutput`.
+
+        :param application string: The name of the application
+        :param primitive string: The name of the Primitive.
+        :param params list: A list of parameters.
+
+        :returns uuid string: The UUID of the executed Primitive
+        """
+        uuid = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        # Get the application
+        if application in model.applications:
+            app = model.applications[application]
+
+            # Execute the primitive
+            unit = app.units[0]
+            if unit:
+                action = self.loop.run_until_complete(
+                    unit.run_action(primitive, **params)
+                )
+                uuid = action.id
+                print("Executing action: {}".format(uuid))
+            self.loop.run_until_complete(
+                model.disconnect()
+            )
+        else:
+            # Invalid mapping: application not found. Raise exception
+            raise Exception("Application not found: {}".format(application))
+
+        return uuid
+
+    def GetPrimitiveStatus(self, uuid):
+        """Get the status of a Primitive execution.
+
+        This will return one of the following strings:
+        - pending
+        - running
+        - completed
+        - failed
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The status of the executed Primitive
+        """
+        status = None
+
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        status = self.loop.run_until_complete(
+            model.get_action_status(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return status[uuid]
+
+    def GetPrimitiveOutput(self, uuid):
+        """Get the output of a completed Primitive execution.
+
+
+        :param uuid string: The UUID of the executed Primitive.
+        :returns: The output of the execution, or None if it's still running.
+        """
+        result = None
+        if not self.client:
+            self.login()
+
+        model = self.loop.run_until_complete(
+            self.client.get_model(self.model)
+        )
+
+        result = self.loop.run_until_complete(
+            model.get_action_output(uuid)
+        )
+
+        self.loop.run_until_complete(
+            model.disconnect()
+        )
+
+        return result
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/sshproxy.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..724b98cfc8e879217ccaf8ba5d255eac1b0c49aa
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms.osm/charms/osm/sshproxy.py
@@ -0,0 +1,250 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# from charmhelpers.core import unitdata
+# from charmhelpers.core.hookenv import log
+
+import io
+import ipaddress
+
+import os
+import socket
+import shlex
+import traceback
+import sys
+
+from subprocess import (
+    check_call,
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+def install_dependencies():
+    # Make sure Python3 + PIP are available
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # This is needed when running as a k8s charm, as the ubuntu:latest
+        # image doesn't include either package.
+
+        # Update the apt cache
+        check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+    # Install the build dependencies for our requirements (paramiko)
+    check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    check_call(
+        [sys.executable, "-m", "pip", "install", "paramiko"],
+    )
+
+try:
+    import paramiko
+except Exception as ex:
+    install_dependencies()
+    import paramiko
+
+class SSHProxy:
+    private_key_path = "/root/.ssh/id_sshproxy"
+    public_key_path = "/root/.ssh/id_sshproxy.pub"
+    key_type = "rsa"
+    key_bits = 4096
+
+    def __init__(self, hostname: str, username: str, password: str = ""):
+        self.hostname = hostname
+        self.username = username
+        self.password = password
+
+    @staticmethod
+    def generate_ssh_key():
+        """Generate a 4096-bit rsa keypair."""
+        if not os.path.exists(SSHProxy.private_key_path):
+            cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+                SSHProxy.key_type, SSHProxy.key_bits, SSHProxy.private_key_path,
+            )
+
+            try:
+                check_call(cmd, shell=True)
+            except CalledProcessError:
+                return False
+
+        return True
+
+    @staticmethod
+    def write_ssh_keys(public, private):
+        """Write a 4096-bit rsa keypair."""
+        with open(SSHProxy.public_key_path, "w") as f:
+            f.write(public)
+            f.close()
+        with open(SSHProxy.private_key_path, "w") as f:
+            f.write(private)
+            f.close()
+
+    @staticmethod
+    def get_ssh_public_key():
+        publickey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.public_key_path, "r") as f:
+                publickey = f.read()
+        return publickey
+
+    @staticmethod
+    def get_ssh_private_key():
+        privatekey = ""
+        if os.path.exists(SSHProxy.private_key_path):
+            with open(SSHProxy.private_key_path, "r") as f:
+                privatekey = f.read()
+        return privatekey
+
+    @staticmethod
+    def has_ssh_key():
+        return True if os.path.exists(SSHProxy.private_key_path) else False
+
+    def run(self, cmd: str) -> (str, str):
+        """Run a command remotely via SSH.
+
+        Note: The previous behavior was to run the command locally if SSH wasn't
+        configured, but that can lead to cases where execution succeeds when you'd
+        expect it not to.
+        """
+        if isinstance(cmd, str):
+            cmd = shlex.split(cmd)
+
+        host = self._get_hostname()
+        user = self.username
+        passwd = self.password
+        key = self.private_key_path
+
+        # Make sure we have everything we need to connect
+        if host and user:
+            return self._ssh(cmd)
+
+        raise Exception("Invalid SSH credentials.")
+
+    def sftp(self, local, remote):
+        client = self._get_ssh_client()
+
+        # Create an sftp connection from the underlying transport
+        sftp = paramiko.SFTPClient.from_transport(client.get_transport())
+        sftp.put(local, remote)
+        client.close()
+        pass
+
+    def verify_credentials(self):
+        """Verify the SSH credentials.
+        
+        :return (bool, str): Verified, Stderr
+        """
+        try:
+            (stdout, stderr) = self.run("hostname")
+        except CalledProcessError as e:
+            stderr = "Command failed: {} ({})".format(" ".join(e.cmd), str(e.output))
+        except paramiko.ssh_exception.AuthenticationException as e:
+            stderr = "{}.".format(e)
+        except paramiko.ssh_exception.BadAuthenticationType as e:
+            stderr = "{}".format(e.explanation)
+        except paramiko.ssh_exception.BadHostKeyException as e:
+            stderr = "Host key mismatch: expected {} but got {}.".format(
+                e.expected_key, e.got_key,
+            )
+        except (TimeoutError, socket.timeout):
+            stderr = "Timeout attempting to reach {}".format(self._get_hostname())
+        except Exception as error:
+            tb = traceback.format_exc()
+            stderr = "Unhandled exception: {}".format(tb)
+
+        if len(stderr) == 0:
+            return True, stderr
+        return False, stderr
+
+    ###################
+    # Private methods #
+    ###################
+    def _get_hostname(self):
+        """Get the hostname for the ssh target.
+
+        HACK: This function was added to work around an issue where the
+        ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+        is the floating ip, and the second the non-floating ip, for an Openstack
+        instance.
+        """
+        return self.hostname.split(";")[0]
+
+    def _get_ssh_client(self):
+        """Return a connected Paramiko ssh object."""
+        client = paramiko.SSHClient()
+        client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+
+        pkey = None
+
+        # Otherwise, check for the auto-generated private key
+        if os.path.exists(self.private_key_path):
+            with open(self.private_key_path) as f:
+                pkey = paramiko.RSAKey.from_private_key(f)
+
+        ###########################################################################
+        # There is a bug in some versions of OpenSSH 4.3 (CentOS/RHEL 5) where    #
+        # the server may not send the SSH_MSG_USERAUTH_BANNER message except when #
+        # responding to an auth_none request. For example, paramiko will attempt  #
+        # to use password authentication when a password is set, but the server   #
+        # could deny that, instead requesting keyboard-interactive. The hack to   #
+        # workaround this is to attempt a reconnect, which will receive the right #
+        # banner, and authentication can proceed. See the following for more info #
+        # https://github.com/paramiko/paramiko/issues/432                         #
+        # https://github.com/paramiko/paramiko/pull/438                           #
+        ###########################################################################
+
+        try:
+            client.connect(
+                self.hostname,
+                port=22,
+                username=self.username,
+                password=self.password,
+                pkey=pkey,
+            )
+        except paramiko.ssh_exception.SSHException as e:
+            if "Error reading SSH protocol banner" == str(e):
+                # Once more, with feeling
+                client.connect(
+                    host, port=22, username=user, password=password, pkey=pkey
+                )
+            else:
+                # Reraise the original exception
+                raise e
+
+        return client
+
+    def _ssh(self, cmd):
+        """Run an arbitrary command over SSH.
+
+        Returns a tuple of (stdout, stderr)
+        """
+        client = self._get_ssh_client()
+
+        cmds = " ".join(cmd)
+        stdin, stdout, stderr = client.exec_command(cmds, get_pty=True)
+        retcode = stdout.channel.recv_exit_status()
+        client.close()  # @TODO re-use connections
+        if retcode > 0:
+            output = stderr.read().strip()
+            raise CalledProcessError(returncode=retcode, cmd=cmd, output=output)
+        return (
+            stdout.read().decode("utf-8").strip(),
+            stderr.read().decode("utf-8").strip(),
+        )
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/LICENSE b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..261eeb9e9f8b2b4b0d119366dda99c6fd7d35c64
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/LICENSE
@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/README.md b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..a56670704b8333f968a78d6b22dcbad5f8873bd7
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/README.md
@@ -0,0 +1,29 @@
+# charms.requirementstxt
+
+A Python library, to aid the development of charms, that will automatically install Python dependencies as declared by a `requirements.txt` file in the root of the charm.
+
+## Usage
+
+Install the charms.requirementstxt library in your charm:
+
+```bash
+git submodule add https://github.com/AdamIsrael/charms.osm mod/charms.osm
+mkdir -p lib/charms
+ln -s ../mod/charms.osm/charms/osm lib/charms/osm
+```
+
+Import the `charms.requirementstxt` library early, before any dependencies it may install.
+
+In `src/charm.py`:
+
+```python
+#!/usr/bin/env python3
+
+import sys
+
+sys.path.append("lib")
+
+import charms.requirementstxt
+...
+
+```
\ No newline at end of file
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/charms/requirementstxt.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/charms/requirementstxt.py
new file mode 100644
index 0000000000000000000000000000000000000000..298d584530ba46f0d7941b88c870a4fe20b6c44f
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/charms/charms/requirementstxt.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+# Requirements.txt support
+
+import sys
+
+sys.path.append("lib")
+
+from ops.framework import StoredState
+
+import os
+import subprocess
+import sys
+from remote_pdb import RemotePdb
+
+REQUIREMENTS_TXT = "{}/requirements.txt".format(os.environ["JUJU_CHARM_DIR"])
+
+
+def install_requirements():
+    if os.path.exists(REQUIREMENTS_TXT):
+
+        # First, make sure python3 and python3-pip are installed
+        if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+            # Update the apt cache
+            subprocess.check_call(["apt-get", "update"])
+            # Install the Python3 package
+            subprocess.check_call(
+                ["apt-get", "install", "-y", "python3", "python3-pip", "python3-paramiko"],
+                # Eat stdout so it's not returned in an action's stdout
+                # TODO: redirect to a file handle and log to juju log
+                # stdout=subprocess.DEVNULL,
+            )
+
+        # Lastly, install the python requirements
+        cmd = [sys.executable, "-m", "pip", "install", "-r", REQUIREMENTS_TXT]
+        # stdout = subprocess.check_output(cmd)
+        p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=True)
+    
+        stdout, stderr = p.communicate()
+
+        print(stdout)
+        print(stderr)
+        #     subprocess.check_call([sys.executable, "-m", "pip", "install", "-r", REQUIREMENTS_TXT],
+        #     # Eat stdout so it's not returned in an action's stdout
+        #     # TODO: redirect to a file handle and log to juju log
+        #     # stdout=subprocess.DEVNULL,
+        # )
+
+
+# Use StoredState to make sure we're run exactly once automatically
+# RemotePdb('127.0.0.1', 4444).set_trace()
+
+state = StoredState()
+
+installed = getattr(state, "requirements_txt_installed", None)
+if not installed:
+    install_requirements()
+    state.requirements_txt_installed = True
+
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.flake8 b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.flake8
new file mode 100644
index 0000000000000000000000000000000000000000..d0224f38cd598a23fef72c097330c9474e8e6f09
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.flake8
@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 160
+exclude = sandbox
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.gitignore b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..cf0f37160ecf99377020ac5508e0db4746ea2608
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.gitignore
@@ -0,0 +1,3 @@
+__pycache__
+/sandbox
+.idea
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.travis.yml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.travis.yml
new file mode 100644
index 0000000000000000000000000000000000000000..adfdcb93cc0086f67fe447515aaddad3dffcba05
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/.travis.yml
@@ -0,0 +1,15 @@
+dist: bionic
+
+language: python
+
+python:
+    - "3.6"
+    - "3.7"
+
+install:
+    - sudo apt update
+    - sudo apt install flake8 make
+    - pip3 install pyyaml autopep8
+
+script:
+    - make test
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/LICENSE.txt b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/Makefile b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/Makefile
new file mode 100644
index 0000000000000000000000000000000000000000..3c82254068ae2be56cbdc0e90d6673a974845fc4
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/Makefile
@@ -0,0 +1,41 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+test: lint
+	@python3 -m unittest
+
+lint: quotelint check-copyright
+	@autopep8 -r --aggressive --diff --exit-code .
+	@flake8 --config=.flake8
+
+quotelint:
+	@x=$$(grep -rnH --include \*.py "\\\\[\"']");                         \
+	if [ "$$x" ]; then                                                    \
+		echo "Please fix the quoting to avoid spurious backslashes:"; \
+		echo "$$x";                                                   \
+		exit 1;                                                       \
+	fi >&2
+
+check-copyright:
+	@x=$$(find . -name \*.py -not -empty -type f -print0 | xargs -0 grep -L "^# Copyright"); \
+	if [ "$$x" ]; then                                                                       \
+		echo "Please add copyright headers to the following files:";                     \
+		echo "$$x";                                                                      \
+		exit 1;                                                                          \
+	fi >&2
+
+
+
+
+.PHONY: lint test quotelint check-copyright
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/README.md b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..f684a8288c8e897990ee0b7aab2be38375464393
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/README.md
@@ -0,0 +1,120 @@
+# Operator Framework for Charms
+
+This framework is not yet stable and is subject to change, but is available
+for early testing.
+
+## Getting Started
+
+The following overall structure for your charm directory is recommended:
+
+```
+.
++-- config.yaml
++-- metadata.yaml
++-- mod/
++-- lib/
+|   +-- ops -> ../mod/operator/ops
++-- src/
+|   +-- charm.py
++-- hooks/
+    +-- install -> ../src/charm.py
+    +-- start -> ../src/charm.py  # for k8s charms per below
+```
+
+The `mod/` directory should contain the operator framework dependency as a git
+submodule:
+
+```
+git submodule add https://github.com/canonical/operator mod/operator
+```
+
+Then symlink from the git submodule for the operator framework into the `lib/`
+directory of your charm so it can be imported at run time:
+
+```
+ln -s ../mod/operator/ops lib/ops
+```
+
+Other dependencies included as git submodules can be added in the `mod/`
+directory and symlinked into `lib/` as well.
+
+You can sync subsequent changes from the framework and other submodule
+dependencies by running:
+
+```
+git submodule update
+```
+
+Those cloning and checking out the source for your charm for the first time
+will need to run:
+
+```
+git submodule update --init
+```
+
+Your `src/charm.py` is the entry point for your charm logic. It should be set
+to executable and use Python 3.6 or greater. At a minimum, it needs to define
+a subclass of `CharmBase` and pass that into the framework's `main` function:
+
+```python
+import sys
+sys.path.append('lib')  # noqa: E402
+
+from ops.charm import CharmBase
+from ops.main import main
+
+
+class MyCharm(CharmBase):
+    pass
+
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+This charm does nothing, because the `MyCharm` class passed to the operator
+framework's `main` function is empty. Functionality can be added to the charm
+by instructing it to observe particular Juju events when the `MyCharm` object
+is initialized. For example,
+
+```python
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.start, self.on_start)
+
+     def on_start(self, event):
+        # Handle the start event here.
+```
+
+Every standard event in Juju may be observed that way, and you can also easily
+define your own events in your custom types.
+
+> The second argument to `observe` can be either the handler as a bound
+> method, or the observer itself if the handler is a method of the observer
+> that follows the conventional naming pattern. That is, in this case, we
+> could have called just `self.framework.obseve(self.on.start, self)`.
+
+The `hooks/` directory must contain a symlink to your `src/charm.py` entry
+point so that Juju can call it. You only need to set up the `hooks/install` link
+(`hooks/start` for K8s charms, until [lp#1854635](https://bugs.launchpad.net/juju/+bug/1854635)
+is resolved), and the framework will create all others at runtime.
+
+Once your charm is ready, upload it to the charm store and deploy it as
+normal with:
+
+```
+# Replace ${CHARM} with the name of the charm.
+charm push . cs:~${USER}/${CHARM}
+# Replace ${VERSION} with the version created by `charm push`.
+charm release cs:~${USER}/${CHARM}-${VERSION}
+charm grant cs:~${USER}/${CHARM}-${VERSION} everyone
+# And now deploy your charm.
+juju deploy cs:~${USER}/$CHARM
+```
+
+Alternatively, to deploy directly from local disk, run:
+
+```
+juju deploy .
+```
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/__init__.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..71472f963a82461a02fe36a0aa47260151f4cafe
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/charm.py
@@ -0,0 +1,306 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, EventsBase
+
+
+class HookEvent(EventBase):
+    pass
+
+
+class ActionEvent(EventBase):
+
+    def defer(self):
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot):
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results):
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message):
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message=''):
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    pass
+
+
+class StartEvent(HookEvent):
+    pass
+
+
+class StopEvent(HookEvent):
+    pass
+
+
+class ConfigChangedEvent(HookEvent):
+    pass
+
+
+class UpdateStatusEvent(HookEvent):
+    pass
+
+
+class UpgradeCharmEvent(HookEvent):
+    pass
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class LeaderElectedEvent(HookEvent):
+    pass
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    pass
+
+
+class RelationEvent(HookEvent):
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit and unit.app != app:
+            raise RuntimeError(f'cannot create RelationEvent with application {app} and unit {unit}')
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self):
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot):
+        self.relation = self.framework.model.get_relation(snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationJoinedEvent(RelationEvent):
+    pass
+
+
+class RelationChangedEvent(RelationEvent):
+    pass
+
+
+class RelationDepartedEvent(RelationEvent):
+    pass
+
+
+class RelationBrokenEvent(RelationEvent):
+    pass
+
+
+class StorageEvent(HookEvent):
+    pass
+
+
+class StorageAttachedEvent(StorageEvent):
+    pass
+
+
+class StorageDetachingEvent(StorageEvent):
+    pass
+
+
+class CharmEvents(EventsBase):
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+
+
+class CharmBase(Object):
+
+    on = CharmEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(f'{relation_name}_relation_joined', RelationJoinedEvent)
+            self.on.define_event(f'{relation_name}_relation_changed', RelationChangedEvent)
+            self.on.define_event(f'{relation_name}_relation_departed', RelationDepartedEvent)
+            self.on.define_event(f'{relation_name}_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(f'{storage_name}_storage_attached', StorageAttachedEvent)
+            self.on.define_event(f'{storage_name}_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(f'{action_name}_action', ActionEvent)
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+    """
+
+    def __init__(self, raw={}, actions_raw={}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta('requires', name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta('provides', name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta('peers', name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', [])
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(cls, metadata, actions=None):
+        meta = yaml.safe_load(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = yaml.safe_load(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition."""
+
+    def __init__(self, role, relation_name, raw):
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/framework.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..d95eb61fae1c8a0207687ab759f15ab6399ca4db
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/framework.py
@@ -0,0 +1,941 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pickle
+import marshal
+import types
+import sqlite3
+import collections
+import collections.abc
+import keyword
+import weakref
+from datetime import timedelta
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = f"{parent}/{kind}[{key}]"
+            else:
+                self._path = f"{parent}/{kind}"
+        else:
+            if key:
+                self._path = f"{kind}[{key}]"
+            else:
+                self._path = f"{kind}"
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {path}")
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(f"Event requires a subclass of EventBase as an argument, got {event_type}")
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def __set_name__(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                f'EventSource({self.event_type.__name__}) reused as '
+                f'{self.emitter_type.__name__}.{self.event_kind} and '
+                f'{emitter_type.__name__}.{event_kind}')
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event rather than charm_instance.on.event,
+        # but in that case it couldn't be emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return (f'<BoundEvent {self.event_type.__name__} bound to '
+                f'{type(self.emitter).__name__}.{self.event_kind} '
+                f'at {hex(id(self))}>')
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class Object:
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+    @property
+    def meta(self):
+        return self.framework.meta
+
+    @property
+    def charm_dir(self):
+        return self.framework.charm_dir
+
+
+class EventsBase(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls -- a type to define an event on.
+        event_kind -- an attribute name that will be used to access the event. Must be a valid python identifier, not be a keyword or an existing attribute.
+        event_type -- a type of the event to define.
+        """
+        if not event_kind.isidentifier():
+            raise RuntimeError(f'unable to define an event with event_kind that is not a valid python identifier: {event_kind}')
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(f'unable to define an event with event_kind that is a python keyword: {event_kind}')
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(f'unable to define an event with event_kind that overlaps with an existing type {cls} attribute: {event_kind}')
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor.__set_name__(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(EventsBase):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f'no snapshot data found for {self.handle_path} object'
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f"cannot restore {self.handle_path} since no class was registered for it"
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename), isolation_level=None, timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed, not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute("CREATE TABLE notice (sequence INTEGER PRIMARY KEY AUTOINCREMENT, event_path TEXT, observer_path TEXT, method_name TEXT)")
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path, snapshot_data):
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, snapshot_data))
+
+    def load_snapshot(self, handle_path):
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return row[0]
+        return None
+
+    def drop_snapshot(self, handle_path):
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def save_notice(self, event_path, observer_path, method_name):
+        self._db.execute("INSERT INTO notice VALUES (NULL, ?, ?, ?)", (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path, observer_path, method_name):
+        self._db.execute("DELETE FROM notice WHERE event_path=? AND observer_path=? AND method_name=?", (event_path, observer_path, method_name))
+
+    def notices(self, event_path):
+        if event_path:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice WHERE event_path=? ORDER BY sequence", (event_path,))
+        else:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice ORDER BY sequence")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, data_path, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self._data_path = data_path
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        self._storage = SQLiteStorage(data_path)
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(f"two objects claiming to be {obj.handle.path} have been created")
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(f"cannot save {type(value).__name__} values before registering that type")
+        data = value.snapshot()
+        # Use marshal as a validator, enforcing the use of simple types.
+        marshal.dumps(data)
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(data)
+        self._storage.save_snapshot(value.handle.path, raw_data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        raw_data = self._storage.load_snapshot(handle.path)
+        if not raw_data:
+            raise NoSnapshotError(handle.path)
+        data = pickle.loads(raw_data)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event, observer):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self.on_something_happened)
+
+        If the method to be called follows the name convention "on_<event name>", it
+        may be omitted from the observe call. That means the above is equivalent to:
+
+            framework.observe(someobj.something_happened, self)
+
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(f'Framework.observe requires a BoundEvent as second parameter, got {bound_event}')
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(f'event emitter {type(emitter).__name__} must have a "handle" attribute')
+
+        method_name = None
+        if isinstance(observer, types.MethodType):
+            method_name = observer.__name__
+            observer = observer.__self__
+        else:
+            method_name = "on_" + event_kind
+            if not hasattr(observer, method_name):
+                raise RuntimeError(f'Observer method not provided explicitly and {type(observer).__name__} type has no "{method_name}" method')
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(getattr(observer, method_name))
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+        if not sig.parameters:
+            raise TypeError(f'{type(observer).__name__}.{method_name} must accept event parameter')
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(f'{type(observer).__name__}.{method_name} has extra required parameter')
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0 means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        # Save the event for all known observers before the first notification
+        # takes place, so that either everyone interested sees it, or nobody does.
+        self.save_snapshot(event)
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred:
+            self._storage.drop_snapshot(last_event_path)
+
+
+class StoredStateChanged(EventBase):
+    pass
+
+
+class StoredStateEvents(EventsBase):
+    changed = EventSource(StoredStateChanged)
+
+
+class StoredStateData(Object):
+
+    on = StoredStateEvents()
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError(f"attribute '{key}' is not stored")
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError(f"attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, str, bytes, list, dict, set)):
+            raise AttributeError(f"attribute '{key}' cannot be set to {type(value).__name__}: must be int/dict/list/etc")
+
+        self._data[key] = _unwrap_stored(self._data, value)
+        self.on.changed.emit()
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is None:
+            self.parent_type = parent_type
+        elif self.parent_type is not parent_type:
+            raise RuntimeError("StoredState shared by {} and {}".format(self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            return self
+
+        bound = parent.__dict__.get(self.attr_name)
+        if bound is None:
+            for attr_name, attr_value in parent_type.__dict__.items():
+                if attr_value is self:
+                    if self.attr_name and attr_name != self.attr_name:
+                        parent_tname = parent_type.__name__
+                        raise RuntimeError(f"StoredState shared by {parent_tname}.{self.attr_name} and {parent_tname}.{attr_name}")
+                    self.attr_name = attr_name
+                    bound = BoundStoredState(parent, attr_name)
+                    parent.__dict__[attr_name] = bound
+                    break
+            else:
+                raise RuntimeError("cannot find StoredVariable attribute in type {}".format(parent_type.__name__))
+
+        return bound
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/jujuversion.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..5256f24ff8fb37a2cbe6162d824e77fb7dca1f45
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/jujuversion.py
@@ -0,0 +1,77 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'^(?P<major>\d{1,9})\.(?P<minor>\d{1,9})((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))?(\.(?P<build>\d{1,9}))?$'
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version)
+        if not m:
+            raise RuntimeError(f'"{version}" is not a valid Juju version string')
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = f'{self.major}.{self.minor}-{self.tag}{self.patch}'
+        else:
+            s = f'{self.major}.{self.minor}.{self.patch}'
+        if self.build > 0:
+            s += f'.{self.build}'
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+        return self.major == other.major and self.minor == other.minor\
+            and self.tag == other.tag and self.build == other.build and self.patch == other.patch
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/main.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..c8d5da2adf1b4f6ccdb3a0b1292dcab8d51c0e9b
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/main.py
@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+def debugf(format, *args, **kwargs):
+    pass
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path(f'{__file__}/../../..').resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _load_metadata(charm_dir):
+    metadata = yaml.safe_load((charm_dir / 'metadata.yaml').read_text())
+
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = yaml.safe_load(actions_meta.read_text())
+    else:
+        actions_metadata = {}
+    return metadata, actions_metadata
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(f"action event name {bound_event.event_kind} needs _action suffix")
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(f'cannot create a symlink: unsupported event type {bound_event.event_type}')
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows. For Windows
+        # it is always an absolute path (any symlinks are resolved) while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), event_dir)
+
+        # Ignore the non-symlink files or directories assuming the charm author knows what they are doing.
+        debugf(f'Creating a new relative symlink at {event_path} pointing to {target_path}')
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file which is determined by inspecting
+    symlinks provided by the charm author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        debugf(f"event {event_name} not defined for {charm}")
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        debugf(f'Emitting Juju event {event_name}')
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError(f'invalid remote unit name: {remote_unit_name}')
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+def main(charm_class):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+
+    charm_dir = _get_charm_dir()
+
+    # Process the Juju event relevant to the current hook execution
+    # JUJU_HOOK_NAME, JUJU_FUNCTION_NAME, and JUJU_ACTION_NAME are not used
+    # in order to support simulation of events from debugging sessions.
+    # TODO: For Windows, when symlinks are used, this is not a valid method of getting an event name (see LP: #1854505).
+    juju_exec_path = Path(sys.argv[0])
+    juju_event_name = juju_exec_path.name.replace('-', '_')
+    if juju_exec_path.parent.name == 'actions':
+        juju_event_name = f'{juju_event_name}_action'
+
+    metadata, actions_metadata = _load_metadata(charm_dir)
+    meta = ops.charm.CharmMeta(metadata, actions_metadata)
+    unit_name = os.environ['JUJU_UNIT_NAME']
+    model = ops.model.Model(unit_name, meta, ops.model.ModelBackend())
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    framework = ops.framework.Framework(charm_state_path, charm_dir, meta, model)
+    try:
+        charm = charm_class(framework, None)
+
+        # When a charm is force-upgraded and a unit is in an error state Juju does not run upgrade-charm and
+        # instead runs the failed hook followed by config-changed. Given the nature of force-upgrading
+        # the hook setup code is not triggered on config-changed.
+        # 'start' event is included as Juju does not fire the install event for K8s charms (see LP: #1854635).
+        if juju_event_name in ('install', 'start', 'upgrade_charm') or juju_event_name.endswith('_storage_attached'):
+            _setup_event_links(charm_dir, charm)
+
+        framework.reemit()
+
+        _emit_charm_event(charm, juju_event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/model.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..a12dcca2b1a85b3ed4a0983b88073f9f8c7bcb42
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/ops/model.py
@@ -0,0 +1,679 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import weakref
+import os
+import shutil
+import tempfile
+import time
+import datetime
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+
+class Model:
+
+    def __init__(self, unit_name, meta, backend):
+        self._cache = ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+
+    def get_unit(self, unit_name):
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name):
+        return self._cache.get(Application, app_name)
+
+    def get_relation(self, relation_name, relation_id=None):
+        """Get a specific Relation instance.
+
+        If relation_id is given, this will return that Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+
+class ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for application {self} status: {value}')
+
+        if not self._is_our_app:
+            raise RuntimeError(f'cannot to set status for a remote application {self}')
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+
+class Unit:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for unit {self} status: {value}')
+
+        if not self._is_our_unit:
+            raise RuntimeError(f'cannot set status for a remote unit {self}')
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+    def is_leader(self):
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(f"cannot determine leadership status for remote applications: {self}")
+
+
+class LazyMapping(Mapping, ABC):
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of Relation instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role == 'peers':
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer, self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError(f'relation name {relation_id} must be int or None not {type(relation_id).__name__}')
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer, self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class Relation:
+    def __init__(self, relation_name, relation_id, is_peer, our_unit, backend, cache):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}:{self.id}>'
+
+
+class RelationData(Mapping):
+    def __init__(self, relation, our_unit, backend):
+        self.relation = weakref.proxy(relation)
+        self._data = {our_unit: RelationDataContent(self.relation, our_unit, backend)}
+        self._data.update({our_unit.app: RelationDataContent(self.relation, our_unit.app, backend)})
+        self._data.update({unit: RelationDataContent(self.relation, unit, backend) for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app:
+            self._data.update({self.relation.app: RelationDataContent(self.relation, self.relation.app, backend)})
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on whether this unit is a leader or not,
+            # but this is not guaranteed to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError(f'cannot set relation data for {self._entity.name}')
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an empty string will
+                # remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty string will
+        # remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units."""
+
+    _statuses = {}
+
+    def __init__(self, message):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        cls._statuses[cls.name] = cls
+        return super().__new__(cls)
+
+    @classmethod
+    def from_name(cls, name, message):
+        return cls._statuses[name](message)
+
+
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message=None):
+        super().__init__(message or '')
+
+
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation for providing those services.
+    This is a "spinning" state, not an error state. It reflects activity on the unit itself, not on peers or related units.
+    """
+    name = 'maintenance'
+
+
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the charm has not called status-set yet.
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which it is related is not running.
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names, backend):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name):
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError(f'invalid resource name: {name}')
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    def __init__(self, backend):
+        self._backend = backend
+
+    def set_spec(self, spec, k8s_resources=None):
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names, backend):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name):
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name, count=1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(f'cannot add storage with {storage_name} as it is not present in the charm metadata')
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            self._location = Path(self._backend.storage_get(f'{self.name}/{self.id}', "location"))
+        return self._location
+
+
+class ModelError(Exception):
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__(f'Too many remote applications on {relation_name} ({num_related} > {max_supported})')
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    pass
+
+
+class RelationNotFoundError(ModelError):
+    pass
+
+
+class InvalidStatusError(ModelError):
+    pass
+
+
+class ModelBackend:
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self):
+        self.unit_name = os.environ['JUJU_UNIT_NAME']
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = 0
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id), return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        try:
+            return self._run('relation-get', '-r', str(relation_id), '-', member_name, f'--app={is_app}', return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        try:
+            return self._run('relation-set', '-r', str(relation_id), f'{key}={value}', f'--app={is_app}')
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+        if time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(tmpdir)
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+        app -- A boolean indicating whether the status should be retrieved for a unit or an application.
+        """
+        return self._run('status-get', '--include-data', f'--application={is_app}')
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+        app -- A boolean indicating whether the status should be set for a unit or an application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', f'--application={is_app}', status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name, return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute, return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError(f'storage count must be integer, got: {count} ({type(count)})')
+        self._run('storage-add', f'{name}={count}')
+
+    def action_get(self):
+        return self._run(f'action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run(f'action-set', *[f"{k}={v}" for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run(f'action-log', f"{message}")
+
+    def action_fail(self, message=''):
+        self._run(f'action-fail', f"{message}")
+
+    def network_get(self, endpoint_name, relation_id=None):
+        """Return network info provided by network-get for a given endpoint.
+
+        endpoint_name -- A name of an endpoint (relation name or extra-binding name).
+        relation_id -- An optional relation id to get network info for.
+        """
+        cmd = ['network-get', endpoint_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/setup.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/setup.py
new file mode 100644
index 0000000000000000000000000000000000000000..44765e2066bc3ea7c7214974dea708a646662617
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/setup.py
@@ -0,0 +1,38 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from setuptools import setup
+
+with open("README.md", "r") as fh:
+    long_description = fh.read()
+
+setup(
+    name="ops",
+    version="0.0.1",
+    description="The Python library behind great charms",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    license="Apache-2.0",
+    url="https://github.com/canonical/operator",
+    packages=["ops"],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+
+        "License :: OSI Approved :: Apache Software License",
+    ],
+)
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/__init__.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-ids b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-ids
new file mode 100755
index 0000000000000000000000000000000000000000..a7e0ead2d3182713bd826696fc403b5a8c54faa6
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-ids
@@ -0,0 +1,11 @@
+#!/bin/bash
+
+case $1 in
+    db) echo '["db:1"]' ;;
+    mon) echo '["mon:2"]' ;;
+    ha) echo '[]' ;;
+    db0) echo '[]' ;;
+    db1) echo '["db1:4"]' ;;
+    db2) echo '["db2:5", "db2:6"]' ;;
+    *) echo '[]' ;;
+esac
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-list b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-list
new file mode 100755
index 0000000000000000000000000000000000000000..88490159775624108766a17a35a77599ddea8f03
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/bin/relation-list
@@ -0,0 +1,16 @@
+#!/bin/bash
+
+fail_not_found() {
+    1>&2 echo "ERROR invalid value \"$1\" for option -r: relation not found"
+    exit 2
+}
+
+case $2 in
+    1) echo '["remote/0"]' ;;
+    2) echo '["remote/0"]' ;;
+    3) fail_not_found $2 ;;
+    4) echo '["remoteapp1/0"]' ;;
+    5) echo '["remoteapp1/0"]' ;;
+    6) echo '["remoteapp2/0"]' ;;
+    *) fail_not_found $2 ;;
+esac
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/config.yaml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ffc0186002391ca52273d39bebcc9c4261c47535
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/config.yaml
@@ -0,0 +1 @@
+"options": {}
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/__init__.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/__init__.py
new file mode 100755
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/__init__.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..71472f963a82461a02fe36a0aa47260151f4cafe
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/charm.py
@@ -0,0 +1,306 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, EventsBase
+
+
+class HookEvent(EventBase):
+    pass
+
+
+class ActionEvent(EventBase):
+
+    def defer(self):
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot):
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results):
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message):
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message=''):
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    pass
+
+
+class StartEvent(HookEvent):
+    pass
+
+
+class StopEvent(HookEvent):
+    pass
+
+
+class ConfigChangedEvent(HookEvent):
+    pass
+
+
+class UpdateStatusEvent(HookEvent):
+    pass
+
+
+class UpgradeCharmEvent(HookEvent):
+    pass
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    pass
+
+
+class LeaderElectedEvent(HookEvent):
+    pass
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    pass
+
+
+class RelationEvent(HookEvent):
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit and unit.app != app:
+            raise RuntimeError(f'cannot create RelationEvent with application {app} and unit {unit}')
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self):
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot):
+        self.relation = self.framework.model.get_relation(snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationJoinedEvent(RelationEvent):
+    pass
+
+
+class RelationChangedEvent(RelationEvent):
+    pass
+
+
+class RelationDepartedEvent(RelationEvent):
+    pass
+
+
+class RelationBrokenEvent(RelationEvent):
+    pass
+
+
+class StorageEvent(HookEvent):
+    pass
+
+
+class StorageAttachedEvent(StorageEvent):
+    pass
+
+
+class StorageDetachingEvent(StorageEvent):
+    pass
+
+
+class CharmEvents(EventsBase):
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+
+
+class CharmBase(Object):
+
+    on = CharmEvents()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(f'{relation_name}_relation_joined', RelationJoinedEvent)
+            self.on.define_event(f'{relation_name}_relation_changed', RelationChangedEvent)
+            self.on.define_event(f'{relation_name}_relation_departed', RelationDepartedEvent)
+            self.on.define_event(f'{relation_name}_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(f'{storage_name}_storage_attached', StorageAttachedEvent)
+            self.on.define_event(f'{storage_name}_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(f'{action_name}_action', ActionEvent)
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    The maintainers, tags, terms, series, and extra_bindings attributes are all
+    lists of strings.  The requires, provides, peers, relations, storage,
+    resources, and payloads attributes are all mappings of names to instances
+    of the respective RelationMeta, StorageMeta, ResourceMeta, or PayloadMeta.
+
+    The relations attribute is a convenience accessor which includes all of the
+    requires, provides, and peers RelationMeta items.  If needed, the role of
+    the relation definition can be obtained from its role attribute.
+    """
+
+    def __init__(self, raw={}, actions_raw={}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta('requires', name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta('provides', name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta('peers', name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', [])
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(cls, metadata, actions=None):
+        meta = yaml.safe_load(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = yaml.safe_load(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition."""
+
+    def __init__(self, role, relation_name, raw):
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition."""
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition."""
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition."""
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/framework.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..d95eb61fae1c8a0207687ab759f15ab6399ca4db
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/framework.py
@@ -0,0 +1,941 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import inspect
+import pickle
+import marshal
+import types
+import sqlite3
+import collections
+import collections.abc
+import keyword
+import weakref
+from datetime import timedelta
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = f"{parent}/{kind}[{key}]"
+            else:
+                self._path = f"{parent}/{kind}"
+        else:
+            if key:
+                self._path = f"{kind}[{key}]"
+            else:
+                self._path = f"{kind}"
+
+    def nest(self, kind, key):
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        return self._parent
+
+    @property
+    def kind(self):
+        return self._kind
+
+    @property
+    def key(self):
+        return self._key
+
+    @property
+    def path(self):
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {path}")
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def defer(self):
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(f"Event requires a subclass of EventBase as an argument, got {event_type}")
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def __set_name__(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                f'EventSource({self.event_type.__name__}) reused as '
+                f'{self.emitter_type.__name__}.{self.event_kind} and '
+                f'{emitter_type.__name__}.{event_kind}')
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event rather than charm_instance.on.event,
+        # but in that case it couldn't be emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+
+    def __repr__(self):
+        return (f'<BoundEvent {self.event_type.__name__} bound to '
+                f'{type(self.emitter).__name__}.{self.event_kind} '
+                f'at {hex(id(self))}>')
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class Object:
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        return self.framework.model
+
+    @property
+    def meta(self):
+        return self.framework.meta
+
+    @property
+    def charm_dir(self):
+        return self.framework.charm_dir
+
+
+class EventsBase(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls -- a type to define an event on.
+        event_kind -- an attribute name that will be used to access the event. Must be a valid python identifier, not be a keyword or an existing attribute.
+        event_type -- a type of the event to define.
+        """
+        if not event_kind.isidentifier():
+            raise RuntimeError(f'unable to define an event with event_kind that is not a valid python identifier: {event_kind}')
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(f'unable to define an event with event_kind that is a python keyword: {event_kind}')
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(f'unable to define an event with event_kind that overlaps with an existing type {cls} attribute: {event_kind}')
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor.__set_name__(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events.
+        """
+        events_map = {}
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kind = attr_name
+                bound_event = getattr(self, event_kind)
+                events_map[event_kind] = bound_event
+        return events_map
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+
+class PrefixedEvents:
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    pass
+
+
+class CommitEvent(EventBase):
+    pass
+
+
+class FrameworkEvents(EventsBase):
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoSnapshotError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f'no snapshot data found for {self.handle_path} object'
+
+
+class NoTypeError(Exception):
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return f"cannot restore {self.handle_path} since no class was registered for it"
+
+
+class SQLiteStorage:
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename), isolation_level=None, timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        # Make sure that the database is locked until the connection is closed, not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute("CREATE TABLE notice (sequence INTEGER PRIMARY KEY AUTOINCREMENT, event_path TEXT, observer_path TEXT, method_name TEXT)")
+            self._db.commit()
+
+    def close(self):
+        self._db.close()
+
+    def commit(self):
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path, snapshot_data):
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, snapshot_data))
+
+    def load_snapshot(self, handle_path):
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return row[0]
+        return None
+
+    def drop_snapshot(self, handle_path):
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def save_notice(self, event_path, observer_path, method_name):
+        self._db.execute("INSERT INTO notice VALUES (NULL, ?, ?, ?)", (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path, observer_path, method_name):
+        self._db.execute("DELETE FROM notice WHERE event_path=? AND observer_path=? AND method_name=?", (event_path, observer_path, method_name))
+
+    def notices(self, event_path):
+        if event_path:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice WHERE event_path=? ORDER BY sequence", (event_path,))
+        else:
+            c = self._db.execute("SELECT event_path, observer_path, method_name FROM notice ORDER BY sequence")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class Framework(Object):
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, data_path, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self._data_path = data_path
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        self._storage = SQLiteStorage(data_path)
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+    def close(self):
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(f"two objects claiming to be {obj.handle.path} have been created")
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(f"cannot save {type(value).__name__} values before registering that type")
+        data = value.snapshot()
+        # Use marshal as a validator, enforcing the use of simple types.
+        marshal.dumps(data)
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(data)
+        self._storage.save_snapshot(value.handle.path, raw_data)
+
+    def load_snapshot(self, handle):
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        raw_data = self._storage.load_snapshot(handle.path)
+        if not raw_data:
+            raise NoSnapshotError(handle.path)
+        data = pickle.loads(raw_data)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event, observer):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style:
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as:
+
+            framework.observe(someobj.something_happened, self.on_something_happened)
+
+        If the method to be called follows the name convention "on_<event name>", it
+        may be omitted from the observe call. That means the above is equivalent to:
+
+            framework.observe(someobj.something_happened, self)
+
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(f'Framework.observe requires a BoundEvent as second parameter, got {bound_event}')
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(f'event emitter {type(emitter).__name__} must have a "handle" attribute')
+
+        method_name = None
+        if isinstance(observer, types.MethodType):
+            method_name = observer.__name__
+            observer = observer.__self__
+        else:
+            method_name = "on_" + event_kind
+            if not hasattr(observer, method_name):
+                raise RuntimeError(f'Observer method not provided explicitly and {type(observer).__name__} type has no "{method_name}" method')
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(getattr(observer, method_name))
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+        if not sig.parameters:
+            raise TypeError(f'{type(observer).__name__}.{method_name} must accept event parameter')
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(f'{type(observer).__name__}.{method_name} has extra required parameter')
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0 means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+
+        # Save the event for all known observers before the first notification
+        # takes place, so that either everyone interested sees it, or nobody does.
+        self.save_snapshot(event)
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred:
+            self._storage.drop_snapshot(last_event_path)
+
+
+class StoredStateChanged(EventBase):
+    pass
+
+
+class StoredStateEvents(EventsBase):
+    changed = EventSource(StoredStateChanged)
+
+
+class StoredStateData(Object):
+
+    on = StoredStateEvents()
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        return self._cache
+
+    def restore(self, snapshot):
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError(f"attribute '{key}' is not stored")
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError(f"attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, str, bytes, list, dict, set)):
+            raise AttributeError(f"attribute '{key}' cannot be set to {type(value).__name__}: must be int/dict/list/etc")
+
+        self._data[key] = _unwrap_stored(self._data, value)
+        self.on.changed.emit()
+
+    def set_default(self, **kwargs):
+        """"Set the value of any given key if it has not already been set"""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is None:
+            self.parent_type = parent_type
+        elif self.parent_type is not parent_type:
+            raise RuntimeError("StoredState shared by {} and {}".format(self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            return self
+
+        bound = parent.__dict__.get(self.attr_name)
+        if bound is None:
+            for attr_name, attr_value in parent_type.__dict__.items():
+                if attr_value is self:
+                    if self.attr_name and attr_name != self.attr_name:
+                        parent_tname = parent_type.__name__
+                        raise RuntimeError(f"StoredState shared by {parent_tname}.{self.attr_name} and {parent_tname}.{attr_name}")
+                    self.attr_name = attr_name
+                    bound = BoundStoredState(parent, attr_name)
+                    parent.__dict__[attr_name] = bound
+                    break
+            else:
+                raise RuntimeError("cannot find StoredVariable attribute in type {}".format(parent_type.__name__))
+
+        return bound
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/jujuversion.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..5256f24ff8fb37a2cbe6162d824e77fb7dca1f45
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/jujuversion.py
@@ -0,0 +1,77 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+
+    PATTERN = r'^(?P<major>\d{1,9})\.(?P<minor>\d{1,9})((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))?(\.(?P<build>\d{1,9}))?$'
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version)
+        if not m:
+            raise RuntimeError(f'"{version}" is not a valid Juju version string')
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = f'{self.major}.{self.minor}-{self.tag}{self.patch}'
+        else:
+            s = f'{self.major}.{self.minor}.{self.patch}'
+        if self.build > 0:
+            s += f'.{self.build}'
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+        return self.major == other.major and self.minor == other.minor\
+            and self.tag == other.tag and self.build == other.build and self.patch == other.patch
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError(f'cannot compare Juju version "{self}" with "{other}"')
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/main.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/main.py
new file mode 100755
index 0000000000000000000000000000000000000000..c8d5da2adf1b4f6ccdb3a0b1292dcab8d51c0e9b
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/main.py
@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import sys
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+def debugf(format, *args, **kwargs):
+    pass
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path(f'{__file__}/../../..').resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _load_metadata(charm_dir):
+    metadata = yaml.safe_load((charm_dir / 'metadata.yaml').read_text())
+
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = yaml.safe_load(actions_meta.read_text())
+    else:
+        actions_metadata = {}
+    return metadata, actions_metadata
+
+
+def _create_event_link(charm, bound_event):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(f"action event name {bound_event.event_kind} needs _action suffix")
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(f'cannot create a symlink: unsupported event type {bound_event.event_type}')
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        # CPython has different implementations for populating sys.argv[0] for Linux and Windows. For Windows
+        # it is always an absolute path (any symlinks are resolved) while for Linux it can be a relative path.
+        target_path = os.path.relpath(os.path.realpath(sys.argv[0]), event_dir)
+
+        # Ignore the non-symlink files or directories assuming the charm author knows what they are doing.
+        debugf(f'Creating a new relative symlink at {event_path} pointing to {target_path}')
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file which is determined by inspecting
+    symlinks provided by the charm author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+    """
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        debugf(f"event {event_name} not defined for {charm}")
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        debugf(f'Emitting Juju event {event_name}')
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError(f'invalid remote unit name: {remote_unit_name}')
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+def main(charm_class):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+    """
+
+    charm_dir = _get_charm_dir()
+
+    # Process the Juju event relevant to the current hook execution
+    # JUJU_HOOK_NAME, JUJU_FUNCTION_NAME, and JUJU_ACTION_NAME are not used
+    # in order to support simulation of events from debugging sessions.
+    # TODO: For Windows, when symlinks are used, this is not a valid method of getting an event name (see LP: #1854505).
+    juju_exec_path = Path(sys.argv[0])
+    juju_event_name = juju_exec_path.name.replace('-', '_')
+    if juju_exec_path.parent.name == 'actions':
+        juju_event_name = f'{juju_event_name}_action'
+
+    metadata, actions_metadata = _load_metadata(charm_dir)
+    meta = ops.charm.CharmMeta(metadata, actions_metadata)
+    unit_name = os.environ['JUJU_UNIT_NAME']
+    model = ops.model.Model(unit_name, meta, ops.model.ModelBackend())
+
+    # TODO: If Juju unit agent crashes after exit(0) from the charm code
+    # the framework will commit the snapshot but Juju will not commit its
+    # operation.
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+    framework = ops.framework.Framework(charm_state_path, charm_dir, meta, model)
+    try:
+        charm = charm_class(framework, None)
+
+        # When a charm is force-upgraded and a unit is in an error state Juju does not run upgrade-charm and
+        # instead runs the failed hook followed by config-changed. Given the nature of force-upgrading
+        # the hook setup code is not triggered on config-changed.
+        # 'start' event is included as Juju does not fire the install event for K8s charms (see LP: #1854635).
+        if juju_event_name in ('install', 'start', 'upgrade_charm') or juju_event_name.endswith('_storage_attached'):
+            _setup_event_links(charm_dir, charm)
+
+        framework.reemit()
+
+        _emit_charm_event(charm, juju_event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/model.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..a12dcca2b1a85b3ed4a0983b88073f9f8c7bcb42
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/lib/ops/model.py
@@ -0,0 +1,679 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+import weakref
+import os
+import shutil
+import tempfile
+import time
+import datetime
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+
+
+class Model:
+
+    def __init__(self, unit_name, meta, backend):
+        self._cache = ModelCache(backend)
+        self._backend = backend
+        self.unit = self.get_unit(unit_name)
+        self.app = self.unit.app
+        self.relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self.config = ConfigData(self._backend)
+        self.resources = Resources(list(meta.resources), self._backend)
+        self.pod = Pod(self._backend)
+        self.storages = StorageMapping(list(meta.storages), self._backend)
+
+    def get_unit(self, unit_name):
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name):
+        return self._cache.get(Application, app_name)
+
+    def get_relation(self, relation_name, relation_id=None):
+        """Get a specific Relation instance.
+
+        If relation_id is given, this will return that Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+
+class ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for application {self} status: {value}')
+
+        if not self._is_our_app:
+            raise RuntimeError(f'cannot to set status for a remote application {self}')
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+
+class Unit:
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    @property
+    def status(self):
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(f'invalid value provided for unit {self} status: {value}')
+
+        if not self._is_our_unit:
+            raise RuntimeError(f'cannot set status for a remote unit {self}')
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}>'
+
+    def is_leader(self):
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(f"cannot determine leadership status for remote applications: {self}")
+
+
+class LazyMapping(Mapping, ABC):
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of Relation instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role == 'peers':
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer, self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError(f'relation name {relation_id} must be int or None not {type(relation_id).__name__}')
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer, self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class Relation:
+    def __init__(self, relation_name, relation_id, is_peer, our_unit, backend, cache):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return f'<{type(self).__module__}.{type(self).__name__} {self.name}:{self.id}>'
+
+
+class RelationData(Mapping):
+    def __init__(self, relation, our_unit, backend):
+        self.relation = weakref.proxy(relation)
+        self._data = {our_unit: RelationDataContent(self.relation, our_unit, backend)}
+        self._data.update({our_unit.app: RelationDataContent(self.relation, our_unit.app, backend)})
+        self._data.update({unit: RelationDataContent(self.relation, unit, backend) for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app:
+            self._data.update({self.relation.app: RelationDataContent(self.relation, self.relation.app, backend)})
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on whether this unit is a leader or not,
+            # but this is not guaranteed to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError(f'cannot set relation data for {self._entity.name}')
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an empty string will
+                # remove the key entirely from the relation data.
+                del self._data[key]
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty string will
+        # remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units."""
+
+    _statuses = {}
+
+    def __init__(self, message):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        cls._statuses[cls.name] = cls
+        return super().__new__(cls)
+
+    @classmethod
+    def from_name(cls, name, message):
+        return cls._statuses[name](message)
+
+
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message=None):
+        super().__init__(message or '')
+
+
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation for providing those services.
+    This is a "spinning" state, not an error state. It reflects activity on the unit itself, not on peers or related units.
+    """
+    name = 'maintenance'
+
+
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the charm has not called status-set yet.
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which it is related is not running.
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm.
+    """
+
+    def __init__(self, names, backend):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name):
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError(f'invalid resource name: {name}')
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    def __init__(self, backend):
+        self._backend = backend
+
+    def set_spec(self, spec, k8s_resources=None):
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names, backend):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name):
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name, count=1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(f'cannot add storage with {storage_name} as it is not present in the charm metadata')
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        if self._location is None:
+            self._location = Path(self._backend.storage_get(f'{self.name}/{self.id}', "location"))
+        return self._location
+
+
+class ModelError(Exception):
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__(f'Too many remote applications on {relation_name} ({num_related} > {max_supported})')
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    pass
+
+
+class RelationNotFoundError(ModelError):
+    pass
+
+
+class InvalidStatusError(ModelError):
+    pass
+
+
+class ModelBackend:
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self):
+        self.unit_name = os.environ['JUJU_UNIT_NAME']
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = 0
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE)
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, check=True, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id), return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        try:
+            return self._run('relation-get', '-r', str(relation_id), '-', member_name, f'--app={is_app}', return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        try:
+            return self._run('relation-set', '-r', str(relation_id), f'{key}={value}', f'--app={is_app}')
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+        if time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.json'
+            spec_path.write_text(json.dumps(spec))
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.json'
+                k8s_res_path.write_text(json.dumps(k8s_resources))
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(tmpdir)
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+        app -- A boolean indicating whether the status should be retrieved for a unit or an application.
+        """
+        return self._run('status-get', '--include-data', f'--application={is_app}')
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+        app -- A boolean indicating whether the status should be set for a unit or an application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', f'--application={is_app}', status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name, return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute, return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError(f'storage count must be integer, got: {count} ({type(count)})')
+        self._run('storage-add', f'{name}={count}')
+
+    def action_get(self):
+        return self._run(f'action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run(f'action-set', *[f"{k}={v}" for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run(f'action-log', f"{message}")
+
+    def action_fail(self, message=''):
+        self._run(f'action-fail', f"{message}")
+
+    def network_get(self, endpoint_name, relation_id=None):
+        """Return network info provided by network-get for a given endpoint.
+
+        endpoint_name -- A name of an endpoint (relation name or extra-binding name).
+        relation_id -- An optional relation id to get network info for.
+        """
+        cmd = ['network-get', endpoint_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/metadata.yaml b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3b3aed87e96121224c63916b04009daf40fcab35
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/metadata.yaml
@@ -0,0 +1,26 @@
+name: main
+summary: A charm used for testing the basic operation of the entrypoint code.
+maintainer: Dmitrii Shcherbakov <dmitrii.shcherbakov@canonical.com>
+description: A charm used for testing the basic operation of the entrypoint code.
+tags:
+    - misc
+series:
+    - bionic
+    - cosmic
+    - disco
+min-juju-version: 2.7.1
+provides:
+    db:
+        interface: db
+requires:
+    mon:
+        interface: monitoring
+peers:
+    ha:
+        interface: cluster
+subordinate: false
+storage:
+    disks:
+        type: block
+        multiple:
+            range: 0-
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/src/charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..c20ae783ded4945b344e7602165e10af0e19c5b0
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/charms/test_main/src/charm.py
@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import base64
+import pickle
+import sys
+sys.path.append('lib')  # noqa
+
+from ops.charm import CharmBase
+from ops.main import main
+
+import logging
+
+logger = logging.getLogger()
+
+
+class Charm(CharmBase):
+
+    def __init__(self, *args):
+        super().__init__(*args)
+
+        # This environment variable controls the test charm behavior.
+        charm_config = os.environ.get('CHARM_CONFIG')
+        if charm_config is not None:
+            self._charm_config = pickle.loads(base64.b64decode(charm_config))
+        else:
+            self._charm_config = {}
+
+        self._state_file = self._charm_config.get('STATE_FILE')
+        self._state = {}
+
+        self._state['on_install'] = []
+        self._state['on_start'] = []
+        self._state['on_config_changed'] = []
+        self._state['on_update_status'] = []
+        self._state['on_leader_settings_changed'] = []
+        self._state['on_db_relation_joined'] = []
+        self._state['on_mon_relation_changed'] = []
+        self._state['on_mon_relation_departed'] = []
+        self._state['on_ha_relation_broken'] = []
+        self._state['on_foo_bar_action'] = []
+        self._state['on_start_action'] = []
+
+        # Observed event types per invocation. A list is used to preserve the order in which charm handlers have observed the events.
+        self._state['observed_event_types'] = []
+
+        self.framework.observe(self.on.install, self)
+        self.framework.observe(self.on.start, self)
+        self.framework.observe(self.on.config_changed, self)
+        self.framework.observe(self.on.update_status, self)
+        self.framework.observe(self.on.leader_settings_changed, self)
+        # Test relation events with endpoints from different
+        # sections (provides, requires, peers) as well.
+        self.framework.observe(self.on.db_relation_joined, self)
+        self.framework.observe(self.on.mon_relation_changed, self)
+        self.framework.observe(self.on.mon_relation_departed, self)
+        self.framework.observe(self.on.ha_relation_broken, self)
+
+        if self._charm_config.get('USE_ACTIONS'):
+            self.framework.observe(self.on.start_action, self)
+            self.framework.observe(self.on.foo_bar_action, self)
+
+    def _write_state(self):
+        """Write state variables so that the parent process can read them.
+
+        Each invocation will override the previous state which is intentional.
+        """
+        if self._state_file is not None:
+            with open(self._state_file, 'wb') as f:
+                pickle.dump(self._state, f)
+
+    def on_install(self, event):
+        self._state['on_install'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def on_start(self, event):
+        self._state['on_start'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def on_config_changed(self, event):
+        self._state['on_config_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        event.defer()
+        self._write_state()
+
+    def on_update_status(self, event):
+        self._state['on_update_status'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def on_leader_settings_changed(self, event):
+        self._state['on_leader_settings_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def on_db_relation_joined(self, event):
+        assert event.app is not None, 'application name cannot be None for a relation-joined event'
+        self._state['on_db_relation_joined'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['db_relation_joined_data'] = event.snapshot()
+        self._write_state()
+
+    def on_mon_relation_changed(self, event):
+        assert event.app is not None, 'application name cannot be None for a relation-changed event'
+        if os.environ.get('JUJU_REMOTE_UNIT'):
+            assert event.unit is not None, 'a unit name cannot be None for a relation-changed event associated with a remote unit'
+        self._state['on_mon_relation_changed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['mon_relation_changed_data'] = event.snapshot()
+        self._write_state()
+
+    def on_mon_relation_departed(self, event):
+        assert event.app is not None, 'application name cannot be None for a relation-departed event'
+        self._state['on_mon_relation_departed'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['mon_relation_departed_data'] = event.snapshot()
+        self._write_state()
+
+    def on_ha_relation_broken(self, event):
+        assert event.app is None, 'relation-broken events cannot have a reference to a remote application'
+        assert event.unit is None, 'relation broken events cannot have a reference to a remote unit'
+        self._state['on_ha_relation_broken'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._state['ha_relation_broken_data'] = event.snapshot()
+        self._write_state()
+
+    def on_start_action(self, event):
+        assert event.handle.kind == 'start_action', 'event action name cannot be different from the one being handled'
+        self._state['on_start_action'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+    def on_foo_bar_action(self, event):
+        assert event.handle.kind == 'foo_bar_action', 'event action name cannot be different from the one being handled'
+        self._state['on_foo_bar_action'].append(type(event))
+        self._state['observed_event_types'].append(type(event))
+        self._write_state()
+
+
+if __name__ == '__main__':
+    main(Charm)
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..26a943c4c0d0235dcc6f13629832dc046087510e
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_charm.py
@@ -0,0 +1,311 @@
+#!/usr/bin/python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import unittest
+import tempfile
+import shutil
+
+from pathlib import Path
+
+from ops.charm import (
+    CharmBase,
+    CharmMeta,
+    CharmEvents,
+)
+from ops.framework import Framework, EventSource, EventBase
+from ops.model import Model, ModelBackend
+
+from .test_helpers import fake_script, fake_script_calls
+
+
+class TestCharm(unittest.TestCase):
+
+    def setUp(self):
+        def restore_env(env):
+            os.environ.clear()
+            os.environ.update(env)
+        self.addCleanup(restore_env, os.environ.copy())
+
+        os.environ['PATH'] = f"{str(Path(__file__).parent / 'bin')}:{os.environ['PATH']}"
+        os.environ['JUJU_UNIT_NAME'] = 'local/0'
+
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, self.tmpdir)
+        self.meta = CharmMeta()
+
+        class CustomEvent(EventBase):
+            pass
+
+        class TestCharmEvents(CharmEvents):
+            custom = EventSource(CustomEvent)
+
+        # Relations events are defined dynamically and modify the class attributes.
+        # We use a subclass temporarily to prevent these side effects from leaking.
+        CharmBase.on = TestCharmEvents()
+
+        def cleanup():
+            CharmBase.on = CharmEvents()
+        self.addCleanup(cleanup)
+
+    def create_framework(self):
+        model = Model('local/0', self.meta, ModelBackend())
+        framework = Framework(self.tmpdir / "framework.data", self.tmpdir, self.meta, model)
+        self.addCleanup(framework.close)
+        return framework
+
+    def test_basic(self):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+
+                self.started = False
+                framework.observe(self.on.start, self)
+
+            def on_start(self, event):
+                self.started = True
+
+        events = list(MyCharm.on.events())
+        self.assertIn('install', events)
+        self.assertIn('custom', events)
+
+        framework = self.create_framework()
+        charm = MyCharm(framework, None)
+        charm.on.start.emit()
+
+        self.assertEqual(charm.started, True)
+
+    def test_relation_events(self):
+
+        class MyCharm(CharmBase):
+            def __init__(self, *args):
+                super().__init__(*args)
+                self.seen = []
+                for rel in ('req1', 'req-2', 'pro1', 'pro-2', 'peer1', 'peer-2'):
+                    # Hook up relation events to generic handler.
+                    self.framework.observe(self.on[rel].relation_joined, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_changed, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_departed, self.on_any_relation)
+                    self.framework.observe(self.on[rel].relation_broken, self.on_any_relation)
+
+            def on_any_relation(self, event):
+                assert event.relation.name == 'req1'
+                assert event.relation.app.name == 'remote'
+                self.seen.append(type(event).__name__)
+
+        # language=YAML
+        self.meta = CharmMeta.from_yaml(metadata='''
+name: my-charm
+requires:
+ req1:
+   interface: req1
+ req-2:
+   interface: req2
+provides:
+ pro1:
+   interface: pro1
+ pro-2:
+   interface: pro2
+peers:
+ peer1:
+   interface: peer1
+ peer-2:
+   interface: peer2
+''')
+
+        charm = MyCharm(self.create_framework(), None)
+
+        rel = charm.framework.model.get_relation('req1', 1)
+        unit = charm.framework.model.get_unit('remote/0')
+        charm.on['req1'].relation_joined.emit(rel, unit)
+        charm.on['req1'].relation_changed.emit(rel, unit)
+        charm.on['req-2'].relation_changed.emit(rel, unit)
+        charm.on['pro1'].relation_departed.emit(rel, unit)
+        charm.on['pro-2'].relation_departed.emit(rel, unit)
+        charm.on['peer1'].relation_broken.emit(rel)
+        charm.on['peer-2'].relation_broken.emit(rel)
+
+        self.assertEqual(charm.seen, [
+            'RelationJoinedEvent',
+            'RelationChangedEvent',
+            'RelationChangedEvent',
+            'RelationDepartedEvent',
+            'RelationDepartedEvent',
+            'RelationBrokenEvent',
+            'RelationBrokenEvent',
+        ])
+
+    def test_storage_events(self):
+
+        class MyCharm(CharmBase):
+            def __init__(self, *args):
+                super().__init__(*args)
+                self.seen = []
+                self.framework.observe(self.on['stor1'].storage_attached, self)
+                self.framework.observe(self.on['stor2'].storage_detaching, self)
+                self.framework.observe(self.on['stor3'].storage_attached, self)
+                self.framework.observe(self.on['stor-4'].storage_attached, self)
+
+            def on_stor1_storage_attached(self, event):
+                self.seen.append(f'{type(event).__name__}')
+
+            def on_stor2_storage_detaching(self, event):
+                self.seen.append(f'{type(event).__name__}')
+
+            def on_stor3_storage_attached(self, event):
+                self.seen.append(f'{type(event).__name__}')
+
+            def on_stor_4_storage_attached(self, event):
+                self.seen.append(f'{type(event).__name__}')
+
+        # language=YAML
+        self.meta = CharmMeta.from_yaml('''
+name: my-charm
+storage:
+  stor-4:
+    multiple:
+      range: 2-4
+    type: filesystem
+  stor1:
+    type: filesystem
+  stor2:
+    multiple:
+      range: "2"
+    type: filesystem
+  stor3:
+    multiple:
+      range: 2-
+    type: filesystem
+''')
+
+        self.assertIsNone(self.meta.storages['stor1'].multiple_range)
+        self.assertEqual(self.meta.storages['stor2'].multiple_range, (2, 2))
+        self.assertEqual(self.meta.storages['stor3'].multiple_range, (2, None))
+        self.assertEqual(self.meta.storages['stor-4'].multiple_range, (2, 4))
+
+        charm = MyCharm(self.create_framework(), None)
+
+        charm.on['stor1'].storage_attached.emit()
+        charm.on['stor2'].storage_detaching.emit()
+        charm.on['stor3'].storage_attached.emit()
+        charm.on['stor-4'].storage_attached.emit()
+
+        self.assertEqual(charm.seen, [
+            'StorageAttachedEvent',
+            'StorageDetachingEvent',
+            'StorageAttachedEvent',
+            'StorageAttachedEvent',
+        ])
+
+    @classmethod
+    def _get_action_test_meta(cls):
+        # language=YAML
+        return CharmMeta.from_yaml(metadata='''
+name: my-charm
+''', actions='''
+foo-bar:
+  description: "Foos the bar."
+  params:
+    foo-name:
+      description: "A foo name to bar"
+      type: string
+    silent:
+      default: false
+      description: ""
+      type: boolean
+  required: foo-bar
+  title: foo-bar
+start:
+  description: "Start the unit."
+''')
+
+    def _test_action_events(self, cmd_type):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+                framework.observe(self.on.foo_bar_action, self)
+                framework.observe(self.on.start_action, self)
+
+            def on_foo_bar_action(self, event):
+                self.seen_action_params = event.params
+                event.log('test-log')
+                event.set_results({'res': 'val with spaces'})
+                event.fail('test-fail')
+
+            def on_start_action(self, event):
+                pass
+
+        fake_script(self, f'{cmd_type}-get', """echo '{"foo-name": "name", "silent": true}'""")
+        fake_script(self, f'{cmd_type}-set', "")
+        fake_script(self, f'{cmd_type}-log', "")
+        fake_script(self, f'{cmd_type}-fail', "")
+        self.meta = self._get_action_test_meta()
+
+        os.environ[f'JUJU_{cmd_type.upper()}_NAME'] = 'foo-bar'
+        framework = self.create_framework()
+        charm = MyCharm(framework, None)
+
+        events = list(MyCharm.on.events())
+        self.assertIn('foo_bar_action', events)
+        self.assertIn('start_action', events)
+
+        charm.on.foo_bar_action.emit()
+        self.assertEqual(charm.seen_action_params, {"foo-name": "name", "silent": True})
+        self.assertEqual(fake_script_calls(self), [
+            [f'{cmd_type}-get', '--format=json'],
+            [f'{cmd_type}-log', "test-log"],
+            [f'{cmd_type}-set', "res=val with spaces"],
+            [f'{cmd_type}-fail', "test-fail"],
+        ])
+
+        # Make sure that action events that do not match the current context are
+        # not possible to emit by hand.
+        with self.assertRaises(RuntimeError):
+            charm.on.start_action.emit()
+
+    def test_action_events(self):
+        self._test_action_events('action')
+
+    def _test_action_event_defer_fails(self, cmd_type):
+
+        class MyCharm(CharmBase):
+
+            def __init__(self, *args):
+                super().__init__(*args)
+                framework.observe(self.on.start_action, self)
+
+            def on_start_action(self, event):
+                event.defer()
+
+        fake_script(self, f'{cmd_type}-get', """echo '{"foo-name": "name", "silent": true}'""")
+        self.meta = self._get_action_test_meta()
+
+        os.environ[f'JUJU_{cmd_type.upper()}_NAME'] = 'start'
+        framework = self.create_framework()
+        charm = MyCharm(framework, None)
+
+        with self.assertRaises(RuntimeError):
+            charm.on.start_action.emit()
+
+    def test_action_event_defer_fails(self):
+        self._test_action_event_defer_fails('action')
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_framework.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_framework.py
new file mode 100755
index 0000000000000000000000000000000000000000..fc364ea84049e544bb36f24b78150e7db86ba334
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_framework.py
@@ -0,0 +1,1200 @@
+#!/usr/bin/python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+import tempfile
+import shutil
+import gc
+import datetime
+
+from pathlib import Path
+
+from ops.framework import (
+    Framework, Handle, EventSource, EventsBase, EventBase, Object, PreCommitEvent, CommitEvent,
+    NoSnapshotError, StoredState, StoredList, BoundStoredState, StoredStateData, SQLiteStorage
+)
+
+
+class TestFramework(unittest.TestCase):
+
+    def setUp(self):
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, self.tmpdir)
+        default_timeout = SQLiteStorage.DB_LOCK_TIMEOUT
+
+        def timeout_cleanup():
+            SQLiteStorage.DB_LOCK_TIMEOUT = default_timeout
+        SQLiteStorage.DB_LOCK_TIMEOUT = datetime.timedelta(0)
+        self.addCleanup(timeout_cleanup)
+
+    def create_framework(self):
+        framework = Framework(self.tmpdir / "framework.data", self.tmpdir, None, None)
+        self.addCleanup(framework.close)
+        return framework
+
+    def test_handle_path(self):
+        cases = [
+            (Handle(None, "root", None), "root"),
+            (Handle(None, "root", "1"), "root[1]"),
+            (Handle(Handle(None, "root", None), "child", None), "root/child"),
+            (Handle(Handle(None, "root", "1"), "child", "2"), "root[1]/child[2]"),
+        ]
+        for handle, path in cases:
+            self.assertEqual(str(handle), path)
+            self.assertEqual(Handle.from_path(path), handle)
+
+    def test_handle_attrs_readonly(self):
+        handle = Handle(None, 'kind', 'key')
+        with self.assertRaises(AttributeError):
+            handle.parent = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.kind = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.key = 'foo'
+        with self.assertRaises(AttributeError):
+            handle.path = 'foo'
+
+    def test_restore_unknown(self):
+        framework = self.create_framework()
+
+        class Foo(Object):
+            pass
+
+        handle = Handle(None, "a_foo", "some_key")
+
+        framework.register_type(Foo, None, handle.kind)
+
+        try:
+            framework.load_snapshot(handle)
+        except NoSnapshotError as e:
+            self.assertEqual(e.handle_path, str(handle))
+            self.assertEqual(str(e), "no snapshot data found for a_foo[some_key] object")
+        else:
+            self.fail("exception NoSnapshotError not raised")
+
+    def test_snapshot_roundtrip(self):
+        class Foo:
+            def __init__(self, handle, n):
+                self.handle = handle
+                self.my_n = n
+
+            def snapshot(self):
+                return {"My N!": self.my_n}
+
+            def restore(self, snapshot):
+                self.my_n = snapshot["My N!"] + 1
+
+        handle = Handle(None, "a_foo", "some_key")
+        event = Foo(handle, 1)
+
+        framework1 = self.create_framework()
+        framework1.register_type(Foo, None, handle.kind)
+        framework1.save_snapshot(event)
+        framework1.commit()
+        framework1.close()
+
+        framework2 = self.create_framework()
+        framework2.register_type(Foo, None, handle.kind)
+        event2 = framework2.load_snapshot(handle)
+        self.assertEqual(event2.my_n, 2)
+
+        framework2.save_snapshot(event2)
+        del event2
+        gc.collect()
+        event3 = framework2.load_snapshot(handle)
+        self.assertEqual(event3.my_n, 3)
+
+        framework2.drop_snapshot(event.handle)
+        framework2.commit()
+        framework2.close()
+
+        framework3 = self.create_framework()
+        framework3.register_type(Foo, None, handle.kind)
+
+        self.assertRaises(NoSnapshotError, framework3.load_snapshot, handle)
+
+    def test_simple_event_observer(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+            baz = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_any(self, event):
+                self.seen.append("on_any:" + event.handle.kind)
+
+            def on_foo(self, event):
+                self.seen.append("on_foo:" + event.handle.kind)
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs.on_any)
+        framework.observe(pub.bar, obs.on_any)
+        framework.observe(pub.foo, obs)  # Method name defaults to on_<event kind>.
+
+        try:
+            framework.observe(pub.baz, obs)
+        except RuntimeError as e:
+            self.assertEqual(str(e), 'Observer method not provided explicitly and MyObserver type has no "on_baz" method')
+        else:
+            self.fail("RuntimeError not raised")
+
+        pub.foo.emit()
+        pub.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_any:foo", "on_foo:foo", "on_any:bar"])
+
+    def test_bad_sig_observer(self):
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+            baz = EventSource(MyEvent)
+            qux = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def on_foo(self):
+                assert False, 'should not be reached'
+
+            def on_bar(self, event, extra):
+                assert False, 'should not be reached'
+
+            def on_baz(self, event, extra=None, *, k):
+                assert False, 'should not be reached'
+
+            def on_qux(self, event, extra=None):
+                assert False, 'should not be reached'
+
+        framework = self.create_framework()
+        pub = MyNotifier(framework, "pub")
+        obs = MyObserver(framework, "obs")
+
+        with self.assertRaises(TypeError):
+            framework.observe(pub.foo, obs)
+        with self.assertRaises(TypeError):
+            framework.observe(pub.bar, obs)
+        with self.assertRaises(TypeError):
+            framework.observe(pub.baz, obs)
+        framework.observe(pub.qux, obs)
+
+    def test_on_pre_commit_emitted(self):
+        framework = self.create_framework()
+
+        class PreCommitObserver(Object):
+
+            state = StoredState()
+
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+                self.state.myinitdata = 40
+
+            def on_pre_commit(self, event):
+                self.state.myinitdata = 41
+                self.state.mydata = 42
+                self.seen.append(type(event))
+
+            def on_commit(self, event):
+                # Modifications made here will not be persisted.
+                self.state.myinitdata = 42
+                self.state.mydata = 43
+                self.state.myotherdata = 43
+                self.seen.append(type(event))
+
+        obs = PreCommitObserver(framework, None)
+
+        framework.observe(framework.on.pre_commit, obs.on_pre_commit)
+
+        framework.commit()
+
+        self.assertEqual(obs.state.myinitdata, 41)
+        self.assertEqual(obs.state.mydata, 42)
+        self.assertTrue(obs.seen, [PreCommitEvent, CommitEvent])
+        framework.close()
+
+        other_framework = self.create_framework()
+
+        new_obs = PreCommitObserver(other_framework, None)
+
+        self.assertEqual(obs.state.myinitdata, 41)
+        self.assertEqual(new_obs.state.mydata, 42)
+
+        with self.assertRaises(AttributeError):
+            new_obs.state.myotherdata
+
+    def test_defer_and_reemit(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier1(Object):
+            a = EventSource(MyEvent)
+            b = EventSource(MyEvent)
+
+        class MyNotifier2(Object):
+            c = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+                self.done = {}
+
+            def on_any(self, event):
+                self.seen.append(event.handle.kind)
+                if not self.done.get(event.handle.kind):
+                    event.defer()
+
+        pub1 = MyNotifier1(framework, "1")
+        pub2 = MyNotifier2(framework, "1")
+        obs1 = MyObserver(framework, "1")
+        obs2 = MyObserver(framework, "2")
+
+        framework.observe(pub1.a, obs1.on_any)
+        framework.observe(pub1.b, obs1.on_any)
+        framework.observe(pub1.a, obs2.on_any)
+        framework.observe(pub1.b, obs2.on_any)
+        framework.observe(pub2.c, obs2.on_any)
+
+        pub1.a.emit()
+        pub1.b.emit()
+        pub2.c.emit()
+
+        # Events remain stored because they were deferred.
+        ev_a_handle = Handle(pub1, "a", "1")
+        framework.load_snapshot(ev_a_handle)
+        ev_b_handle = Handle(pub1, "b", "2")
+        framework.load_snapshot(ev_b_handle)
+        ev_c_handle = Handle(pub2, "c", "3")
+        framework.load_snapshot(ev_c_handle)
+        # make sure the objects are gone before we reemit them
+        gc.collect()
+
+        framework.reemit()
+        obs1.done["a"] = True
+        obs2.done["b"] = True
+        framework.reemit()
+        framework.reemit()
+        obs1.done["b"] = True
+        obs2.done["a"] = True
+        framework.reemit()
+        obs2.done["c"] = True
+        framework.reemit()
+        framework.reemit()
+        framework.reemit()
+
+        self.assertEqual(" ".join(obs1.seen), "a b a b a b b b")
+        self.assertEqual(" ".join(obs2.seen), "a b c a b c a b c a c a c c")
+
+        # Now the event objects must all be gone from storage.
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_a_handle)
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_b_handle)
+        self.assertRaises(NoSnapshotError, framework.load_snapshot, ev_c_handle)
+
+    def test_custom_event_data(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            def __init__(self, handle, n):
+                super().__init__(handle)
+                self.my_n = n
+
+            def snapshot(self):
+                return {"My N!": self.my_n}
+
+            def restore(self, snapshot):
+                super().restore(snapshot)
+                self.my_n = snapshot["My N!"] + 1
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append(f"on_foo:{event.handle.kind}={event.my_n}")
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs)
+
+        pub.foo.emit(1)
+
+        framework.reemit()
+
+        # Two things being checked here:
+        #
+        # 1. There's a restore roundtrip before the event is first observed.
+        #    That means the data is safe before it's ever seen, and the
+        #    roundtrip logic is tested under normal circumstances.
+        #
+        # 2. The renotification restores from the pristine event, not
+        #    from the one modified during the first restore (otherwise
+        #    we'd get a foo=3).
+        #
+        self.assertEqual(obs.seen, ["on_foo:foo=2", "on_foo:foo=2"])
+
+    def test_weak_observer(self):
+        framework = self.create_framework()
+
+        observed_events = []
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyEvents(EventsBase):
+            foo = EventSource(MyEvent)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+
+        class MyObserver(Object):
+            def on_foo(self, event):
+                observed_events.append("foo")
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "2")
+
+        framework.observe(pub.on.foo, obs)
+        pub.on.foo.emit()
+        self.assertEqual(observed_events, ["foo"])
+        # Now delete the observer, and note that when we emit the event, it
+        # doesn't update the local slice again
+        del obs
+        gc.collect()
+        pub.on.foo.emit()
+        self.assertEqual(observed_events, ["foo"])
+
+    def test_forget_and_multiple_objects(self):
+        framework = self.create_framework()
+
+        class MyObject(Object):
+            pass
+
+        o1 = MyObject(framework, "path")
+        # Creating a second object at the same path should fail with RuntimeError
+        with self.assertRaises(RuntimeError):
+            o2 = MyObject(framework, "path")
+        # Unless we _forget the object first
+        framework._forget(o1)
+        o2 = MyObject(framework, "path")
+        self.assertEqual(o1.handle.path, o2.handle.path)
+        # Deleting the tracked object should also work
+        del o2
+        gc.collect()
+        o3 = MyObject(framework, "path")
+        self.assertEqual(o1.handle.path, o3.handle.path)
+        framework.close()
+        # Or using a second framework
+        framework_copy = self.create_framework()
+        o_copy = MyObject(framework_copy, "path")
+        self.assertEqual(o1.handle.path, o_copy.handle.path)
+
+    def test_forget_and_multiple_objects_with_load_snapshot(self):
+        framework = self.create_framework()
+
+        class MyObject(Object):
+            def __init__(self, parent, name):
+                super().__init__(parent, name)
+                self.value = name
+
+            def snapshot(self):
+                return self.value
+
+            def restore(self, value):
+                self.value = value
+
+        framework.register_type(MyObject, None, MyObject.handle_kind)
+        o1 = MyObject(framework, "path")
+        framework.save_snapshot(o1)
+        framework.commit()
+        o_handle = o1.handle
+        del o1
+        gc.collect()
+        o2 = framework.load_snapshot(o_handle)
+        # Trying to load_snapshot a second object at the same path should fail with RuntimeError
+        with self.assertRaises(RuntimeError):
+            framework.load_snapshot(o_handle)
+        # Unless we _forget the object first
+        framework._forget(o2)
+        o3 = framework.load_snapshot(o_handle)
+        self.assertEqual(o2.value, o3.value)
+        # A loaded object also prevents direct creation of an object
+        with self.assertRaises(RuntimeError):
+            MyObject(framework, "path")
+        framework.close()
+        # But we can create an object, or load a snapshot in a copy of the framework
+        framework_copy1 = self.create_framework()
+        o_copy1 = MyObject(framework_copy1, "path")
+        self.assertEqual(o_copy1.value, "path")
+        framework_copy1.close()
+        framework_copy2 = self.create_framework()
+        framework_copy2.register_type(MyObject, None, MyObject.handle_kind)
+        o_copy2 = framework_copy2.load_snapshot(o_handle)
+        self.assertEqual(o_copy2.value, "path")
+
+    def test_events_base(self):
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyEvents(EventsBase):
+            foo = EventSource(MyEvent)
+            bar = EventSource(MyEvent)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append(f"on_foo:{event.handle.kind}")
+                event.defer()
+
+            def on_bar(self, event):
+                self.seen.append(f"on_bar:{event.handle.kind}")
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        # Confirm that temporary persistence of BoundEvents doesn't cause errors,
+        # and that events can be observed.
+        for bound_event in [pub.on.foo, pub.on.bar]:
+            framework.observe(bound_event, obs)
+
+        # Confirm that events can be emitted and seen.
+        pub.on.foo.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:foo"])
+
+    def test_conflicting_event_attributes(self):
+        class MyEvent(EventBase):
+            pass
+
+        event = EventSource(MyEvent)
+
+        class MyEvents(EventsBase):
+            foo = event
+
+        with self.assertRaises(RuntimeError) as cm:
+            class OtherEvents(EventsBase):
+                foo = event
+        self.assertEqual(
+            str(cm.exception.__cause__),
+            "EventSource(MyEvent) reused as MyEvents.foo and OtherEvents.foo")
+
+        with self.assertRaises(RuntimeError) as cm:
+            class MyNotifier(Object):
+                on = MyEvents()
+                bar = event
+        self.assertEqual(
+            str(cm.exception.__cause__),
+            "EventSource(MyEvent) reused as MyEvents.foo and MyNotifier.bar")
+
+    def test_reemit_ignores_unknown_event_type(self):
+        # The event type may have been gone for good, and nobody cares,
+        # so this shouldn't be an error scenario.
+
+        framework = self.create_framework()
+
+        class MyEvent(EventBase):
+            pass
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append(event.handle)
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        framework.observe(pub.foo, obs)
+        pub.foo.emit()
+
+        event_handle = obs.seen[0]
+        self.assertEqual(event_handle.kind, "foo")
+
+        framework.commit()
+        framework.close()
+
+        framework_copy = self.create_framework()
+
+        # No errors on missing event types here.
+        framework_copy.reemit()
+
+        # Register the type and check that the event is gone from storage.
+        framework_copy.register_type(MyEvent, event_handle.parent, event_handle.kind)
+        self.assertRaises(NoSnapshotError, framework_copy.load_snapshot, event_handle)
+
+    def test_auto_register_event_types(self):
+        framework = self.create_framework()
+
+        class MyFoo(EventBase):
+            pass
+
+        class MyBar(EventBase):
+            pass
+
+        class MyEvents(EventsBase):
+            foo = EventSource(MyFoo)
+
+        class MyNotifier(Object):
+            on = MyEvents()
+            bar = EventSource(MyBar)
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append(f"on_foo:{type(event).__name__}:{event.handle.kind}")
+                event.defer()
+
+            def on_bar(self, event):
+                self.seen.append(f"on_bar:{type(event).__name__}:{event.handle.kind}")
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        pub.on.foo.emit()
+        pub.bar.emit()
+
+        framework.observe(pub.on.foo, obs)
+        framework.observe(pub.bar, obs)
+
+        pub.on.foo.emit()
+        pub.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:MyFoo:foo", "on_bar:MyBar:bar"])
+
+    def test_dynamic_event_types(self):
+        framework = self.create_framework()
+
+        class MyEventsA(EventsBase):
+            handle_kind = 'on_a'
+
+        class MyEventsB(EventsBase):
+            handle_kind = 'on_b'
+
+        class MyNotifier(Object):
+            on_a = MyEventsA()
+            on_b = MyEventsB()
+
+        class MyObserver(Object):
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append(f"on_foo:{type(event).__name__}:{event.handle.kind}")
+                event.defer()
+
+            def on_bar(self, event):
+                self.seen.append(f"on_bar:{type(event).__name__}:{event.handle.kind}")
+                event.defer()
+
+        pub = MyNotifier(framework, "1")
+        obs = MyObserver(framework, "1")
+
+        class MyFoo(EventBase):
+            pass
+
+        class MyBar(EventBase):
+            pass
+
+        class DeadBeefEvent(EventBase):
+            pass
+
+        class NoneEvent(EventBase):
+            pass
+
+        pub.on_a.define_event("foo", MyFoo)
+        pub.on_b.define_event("bar", MyBar)
+
+        framework.observe(pub.on_a.foo, obs)
+        framework.observe(pub.on_b.bar, obs)
+
+        pub.on_a.foo.emit()
+        pub.on_b.bar.emit()
+
+        self.assertEqual(obs.seen, ["on_foo:MyFoo:foo", "on_bar:MyBar:bar"])
+
+        # Definitions remained local to the specific type.
+        self.assertRaises(AttributeError, lambda: pub.on_a.bar)
+        self.assertRaises(AttributeError, lambda: pub.on_b.foo)
+
+        # Try to use an event name which is not a valid python identifier.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("dead-beef", DeadBeefEvent)
+
+        # Try to use a python keyword for an event name.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("None", NoneEvent)
+
+        # Try to override an existing attribute.
+        with self.assertRaises(RuntimeError):
+            pub.on_a.define_event("foo", MyFoo)
+
+    def test_event_key_roundtrip(self):
+        class MyEvent(EventBase):
+            def __init__(self, handle, value):
+                super().__init__(handle)
+                self.value = value
+
+            def snapshot(self):
+                return self.value
+
+            def restore(self, value):
+                self.value = value
+
+        class MyNotifier(Object):
+            foo = EventSource(MyEvent)
+
+        class MyObserver(Object):
+            has_deferred = False
+
+            def __init__(self, parent, key):
+                super().__init__(parent, key)
+                self.seen = []
+
+            def on_foo(self, event):
+                self.seen.append((event.handle.key, event.value))
+                # Only defer the first event and once.
+                if not MyObserver.has_deferred:
+                    event.defer()
+                    MyObserver.has_deferred = True
+
+        framework1 = self.create_framework()
+        pub1 = MyNotifier(framework1, "pub")
+        obs1 = MyObserver(framework1, "obs")
+        framework1.observe(pub1.foo, obs1)
+        pub1.foo.emit('first')
+        self.assertEqual(obs1.seen, [('1', 'first')])
+
+        framework1.commit()
+        framework1.close()
+        del framework1
+
+        framework2 = self.create_framework()
+        pub2 = MyNotifier(framework2, "pub")
+        obs2 = MyObserver(framework2, "obs")
+        framework2.observe(pub2.foo, obs2)
+        pub2.foo.emit('second')
+        framework2.reemit()
+
+        # First observer didn't get updated, since framework it was bound to is gone.
+        self.assertEqual(obs1.seen, [('1', 'first')])
+        # Second observer saw the new event plus the reemit of the first event.
+        # (The event key goes up by 2 due to the pre-commit and commit events.)
+        self.assertEqual(obs2.seen, [('4', 'second'), ('1', 'first')])
+
+    def test_helper_properties(self):
+        framework = self.create_framework()
+        framework.model = 'test-model'
+        framework.meta = 'test-meta'
+
+        my_obj = Object(framework, 'my_obj')
+        self.assertEqual(my_obj.model, framework.model)
+        self.assertEqual(my_obj.meta, framework.meta)
+        self.assertEqual(my_obj.charm_dir, framework.charm_dir)
+
+    def test_ban_concurrent_frameworks(self):
+        f = self.create_framework()
+        with self.assertRaises(Exception) as cm:
+            self.create_framework()
+        self.assertIn('database is locked', str(cm.exception))
+        f.close()
+
+
+class TestStoredState(unittest.TestCase):
+
+    def setUp(self):
+        self.tmpdir = Path(tempfile.mkdtemp())
+        self.addCleanup(shutil.rmtree, self.tmpdir)
+
+    def create_framework(self, cls=Framework):
+        framework = cls(self.tmpdir / "framework.data", self.tmpdir, None, None)
+        self.addCleanup(framework.close)
+        return framework
+
+    def test_basic_state_storage(self):
+        framework = self.create_framework()
+
+        class SomeObject(Object):
+            state = StoredState()
+
+        obj = SomeObject(framework, "1")
+
+        try:
+            obj.state.foo
+        except AttributeError as e:
+            self.assertEqual(str(e), "attribute 'foo' is not stored")
+        else:
+            self.fail("AttributeError not raised")
+
+        try:
+            obj.state.on = "nonono"
+        except AttributeError as e:
+            self.assertEqual(str(e), "attribute 'on' is reserved and cannot be set")
+        else:
+            self.fail("AttributeError not raised")
+
+        obj.state.foo = 41
+        obj.state.foo = 42
+        obj.state.bar = "s"
+
+        self.assertEqual(obj.state.foo, 42)
+
+        framework.commit()
+
+        # This won't be committed, and should not be seen.
+        obj.state.foo = 43
+
+        framework.close()
+
+        # Since this has the same absolute object handle, it will get its state back.
+        framework_copy = self.create_framework()
+        obj_copy = SomeObject(framework_copy, "1")
+        self.assertEqual(obj_copy.state.foo, 42)
+        self.assertEqual(obj_copy.state.bar, "s")
+
+    def test_mutable_types_invalid(self):
+        framework = self.create_framework()
+
+        class SomeObject(Object):
+            state = StoredState()
+
+        obj = SomeObject(framework, '1')
+        try:
+            class CustomObject:
+                pass
+            obj.state.foo = CustomObject()
+        except AttributeError as e:
+            self.assertEqual(str(e), "attribute 'foo' cannot be set to CustomObject: must be int/dict/list/etc")
+        else:
+            self.fail('AttributeError not raised')
+
+        framework.commit()
+
+    def test_mutable_types(self):
+        # Test and validation functions in a list of 2-tuples.
+        # Assignment and keywords like del are not supported in lambdas so functions are used instead.
+        test_operations = [(
+            lambda: {},         # Operand A.
+            None,               # Operand B.
+            {},                 # Expected result.
+            lambda a, b: None,  # Operation to perform.
+            lambda res, expected_res: self.assertEqual(res, expected_res)  # Validation to perform.
+        ), (
+            lambda: {},
+            {'a': {}},
+            {'a': {}},
+            lambda a, b: a.update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {}},
+            {'b': 'c'},
+            {'a': {'b': 'c'}},
+            lambda a, b: a['a'].update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {'b': 'c'}},
+            {'d': 'e'},
+            {'a': {'b': 'c', 'd': 'e'}},
+            lambda a, b: a['a'].update(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'a': {'b': 'c', 'd': 'e'}},
+            'd',
+            {'a': {'b': 'c'}},
+            lambda a, b: a['a'].pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'s': set()},
+            'a',
+            {'s': {'a'}},
+            lambda a, b: a['s'].add(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: {'s': {'a'}},
+            'a',
+            {'s': set()},
+            lambda a, b: a['s'].discard(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [],
+            None,
+            [],
+            lambda a, b: None,
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [],
+            'a',
+            ['a'],
+            lambda a, b: a.append(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a'],
+            ['c'],
+            ['a', ['c']],
+            lambda a, b: a.append(b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList),
+            )
+        ), (
+            lambda: ['a', ['c']],
+            'b',
+            ['b', 'a', ['c']],
+            lambda a, b: a.insert(0, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['b', 'a', ['c']],
+            ['d'],
+            ['b', ['d'], 'a', ['c']],
+            lambda a, b: a.insert(1, b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList)
+            ),
+        ), (
+            lambda: ['b', 'a', ['c']],
+            ['d'],
+            ['b', ['d'], ['c']],
+            # a[1] = b
+            lambda a, b: a.__setitem__(1, b),
+            lambda res, expected_res: (
+                self.assertEqual(res, expected_res),
+                self.assertIsInstance(res[1], StoredList)
+            ),
+        ), (
+            lambda: ['b', ['d'], 'a', ['c']],
+            0,
+            [['d'], 'a', ['c']],
+            lambda a, b: a.pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: [['d'], 'a', ['c']],
+            ['d'],
+            ['a', ['c']],
+            lambda a, b: a.remove(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c']],
+            'd',
+            ['a', ['c', 'd']],
+            lambda a, b: a[1].append(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c', 'd']],
+            1,
+            ['a', ['c']],
+            lambda a, b: a[1].pop(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c']],
+            'd',
+            ['a', ['c', 'd']],
+            lambda a, b: a[1].insert(1, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: ['a', ['c', 'd']],
+            'd',
+            ['a', ['c']],
+            lambda a, b: a[1].remove(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            None,
+            set(),
+            lambda a, b: None,
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            'a',
+            set(['a']),
+            lambda a, b: a.add(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(['a']),
+            'a',
+            set(),
+            lambda a, b: a.discard(b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        ), (
+            lambda: set(),
+            {'a'},
+            set(),
+            # Nested sets are not allowed as sets themselves are not hashable.
+            lambda a, b: self.assertRaises(TypeError, a.add, b),
+            lambda res, expected_res: self.assertEqual(res, expected_res)
+        )]
+
+        class SomeObject(Object):
+            state = StoredState()
+
+        class WrappedFramework(Framework):
+            def __init__(self, data_path, charm_dir, meta, model):
+                super().__init__(data_path, charm_dir, meta, model)
+                self.snapshots = []
+
+            def save_snapshot(self, value):
+                if value.handle.path == 'SomeObject[1]/StoredStateData[state]':
+                    self.snapshots.append((type(value), value.snapshot()))
+                return super().save_snapshot(value)
+
+        # Validate correctness of modification operations.
+        for get_a, b, expected_res, op, validate_op in test_operations:
+            framework = self.create_framework(cls=WrappedFramework)
+            obj = SomeObject(framework, '1')
+
+            obj.state.a = get_a()
+            self.assertTrue(isinstance(obj.state, BoundStoredState))
+
+            op(obj.state.a, b)
+            validate_op(obj.state.a, expected_res)
+
+            obj.state.a = get_a()
+            framework.commit()
+            # We should see an update for initializing a
+            self.assertEqual(framework.snapshots, [
+                (StoredStateData, {'a': get_a()}),
+            ])
+            del obj
+            gc.collect()
+            obj_copy1 = SomeObject(framework, '1')
+            self.assertEqual(obj_copy1.state.a, get_a())
+
+            op(obj_copy1.state.a, b)
+            validate_op(obj_copy1.state.a, expected_res)
+            framework.commit()
+            framework.close()
+
+            framework_copy = self.create_framework(cls=WrappedFramework)
+
+            obj_copy2 = SomeObject(framework_copy, '1')
+
+            validate_op(obj_copy2.state.a, expected_res)
+
+            # Commit saves the pre-commit and commit events, and the framework event counter, but shouldn't update the stored state of my object
+            framework.snapshots.clear()
+            framework_copy.commit()
+            self.assertEqual(framework_copy.snapshots, [])
+            framework_copy.close()
+
+    def test_comparison_operations(self):
+        test_operations = [(
+            {"1"},               # Operand A.
+            {"1", "2"},          # Operand B.
+            lambda a, b: a < b,  # Operation to test.
+            True,                # Result of op(A, B).
+            False,               # Result of op(B, A).
+        ), (
+            {"1"},
+            {"1", "2"},
+            lambda a, b: a > b,
+            False,
+            True
+        ), (
+            # Empty set comparison.
+            set(),
+            set(),
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"a", "c"},
+            {"c", "a"},
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            dict(),
+            dict(),
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"1": "2"},
+            {"1": "2"},
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            {"1": "2"},
+            {"1": "3"},
+            lambda a, b: a == b,
+            False,
+            False
+        ), (
+            [],
+            [],
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            [1, 2],
+            [1, 2],
+            lambda a, b: a == b,
+            True,
+            True
+        ), (
+            [1, 2, 5, 6],
+            [1, 2, 5, 8, 10],
+            lambda a, b: a <= b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 6],
+            [1, 2, 5, 8, 10],
+            lambda a, b: a < b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 8],
+            [1, 2, 5, 6, 10],
+            lambda a, b: a > b,
+            True,
+            False
+        ), (
+            [1, 2, 5, 8],
+            [1, 2, 5, 6, 10],
+            lambda a, b: a >= b,
+            True,
+            False
+        )]
+
+        class SomeObject(Object):
+            state = StoredState()
+
+        framework = self.create_framework()
+
+        for i, (a, b, op, op_ab, op_ba) in enumerate(test_operations):
+            obj = SomeObject(framework, str(i))
+            obj.state.a = a
+            self.assertEqual(op(obj.state.a, b), op_ab)
+            self.assertEqual(op(b, obj.state.a), op_ba)
+
+    def test_set_operations(self):
+        test_operations = [(
+            {"1"},  # A set to test an operation against (other_set).
+            lambda a, b: a | b,  # An operation to test.
+            {"1", "a", "b"},  # The expected result of operation(obj.state.set, other_set).
+            {"1", "a", "b"}  # The expected result of operation(other_set, obj.state.set).
+        ), (
+            {"a", "c"},
+            lambda a, b: a - b,
+            {"b"},
+            {"c"}
+        ), (
+            {"a", "c"},
+            lambda a, b: a & b,
+            {"a"},
+            {"a"}
+        ), (
+            {"a", "c", "d"},
+            lambda a, b: a ^ b,
+            {"b", "c", "d"},
+            {"b", "c", "d"}
+        ), (
+            set(),
+            lambda a, b: set(a),
+            {"a", "b"},
+            set()
+        )]
+
+        class SomeObject(Object):
+            state = StoredState()
+
+        framework = self.create_framework()
+
+        # Validate that operations between StoredSet and built-in sets only result in built-in sets being returned.
+        # Make sure that commutativity is preserved and that the original sets are not changed or used as a result.
+        for i, (variable_operand, operation, ab_res, ba_res) in enumerate(test_operations):
+            obj = SomeObject(framework, str(i))
+            obj.state.set = {"a", "b"}
+
+            for a, b, expected in [(obj.state.set, variable_operand, ab_res), (variable_operand, obj.state.set, ba_res)]:
+                old_a = set(a)
+                old_b = set(b)
+
+                result = operation(a, b)
+                self.assertEqual(result, expected)
+
+                # Common sanity checks
+                self.assertIsNot(obj.state.set._under, result)
+                self.assertIsNot(result, a)
+                self.assertIsNot(result, b)
+                self.assertEqual(a, old_a)
+                self.assertEqual(b, old_b)
+
+    def test_set_default(self):
+        framework = self.create_framework()
+
+        class StatefulObject(Object):
+            state = StoredState()
+        parent = StatefulObject(framework, 'key')
+        parent.state.set_default(foo=1)
+        self.assertEqual(parent.state.foo, 1)
+        parent.state.set_default(foo=2)
+        # foo was already set, so it doesn't get replaced
+        self.assertEqual(parent.state.foo, 1)
+        parent.state.set_default(foo=3, bar=4)
+        self.assertEqual(parent.state.foo, 1)
+        self.assertEqual(parent.state.bar, 4)
+        # reloading the state still leaves things at the default values
+        framework.commit()
+        del parent
+        parent = StatefulObject(framework, 'key')
+        parent.state.set_default(foo=5, bar=6)
+        self.assertEqual(parent.state.foo, 1)
+        self.assertEqual(parent.state.bar, 4)
+        # TODO(jam) 2020-01-30: is there a clean way to tell that parent.state._data.dirty is False?
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_helpers.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_helpers.py
new file mode 100644
index 0000000000000000000000000000000000000000..7d7379fec7481a081d7de5fcfe40ecb8a5186dbd
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_helpers.py
@@ -0,0 +1,76 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import pathlib
+import subprocess
+import shutil
+import tempfile
+import unittest
+
+
+def fake_script(test_case, name, content):
+    if not hasattr(test_case, 'fake_script_path'):
+        fake_script_path = tempfile.mkdtemp('-fake_script')
+        os.environ['PATH'] = f'{fake_script_path}:{os.environ["PATH"]}'
+
+        def cleanup():
+            shutil.rmtree(fake_script_path)
+            os.environ['PATH'] = os.environ['PATH'].replace(fake_script_path + ':', '')
+
+        test_case.addCleanup(cleanup)
+        test_case.fake_script_path = pathlib.Path(fake_script_path)
+
+    with open(test_case.fake_script_path / name, "w") as f:
+        # Before executing the provided script, dump the provided arguments in calls.txt.
+        f.write('#!/bin/bash\n{ echo -n $(basename $0); for s in "$@"; do echo -n \\;$s; done; echo; } >> $(dirname $0)/calls.txt\n' + content)
+    os.chmod(test_case.fake_script_path / name, 0o755)
+
+
+def fake_script_calls(test_case, clear=False):
+    with open(test_case.fake_script_path / 'calls.txt', 'r+') as f:
+        calls = [line.split(';') for line in f.read().splitlines()]
+        if clear:
+            f.truncate(0)
+        return calls
+
+
+class FakeScriptTest(unittest.TestCase):
+
+    def test_fake_script_works(self):
+        fake_script(self, 'foo', 'echo foo runs')
+        fake_script(self, 'bar', 'echo bar runs')
+        output = subprocess.getoutput('foo a "b c"; bar "d e" f')
+        self.assertEqual(output, 'foo runs\nbar runs')
+        self.assertEqual(fake_script_calls(self), [
+            ['foo', 'a', 'b c'],
+            ['bar', 'd e', 'f'],
+        ])
+
+    def test_fake_script_clear(self):
+        fake_script(self, 'foo', 'echo foo runs')
+
+        output = subprocess.getoutput('foo a "b c"')
+        self.assertEqual(output, 'foo runs')
+
+        self.assertEqual(fake_script_calls(self, clear=True), [['foo', 'a', 'b c']])
+
+        fake_script(self, 'bar', 'echo bar runs')
+
+        output = subprocess.getoutput('bar "d e" f')
+        self.assertEqual(output, 'bar runs')
+
+        self.assertEqual(fake_script_calls(self, clear=True), [['bar', 'd e', 'f']])
+
+        self.assertEqual(fake_script_calls(self, clear=True), [])
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_jujuversion.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_jujuversion.py
new file mode 100755
index 0000000000000000000000000000000000000000..d19fd60045800c61378bcb0496fc79926bc71110
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_jujuversion.py
@@ -0,0 +1,130 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+
+from ops.jujuversion import JujuVersion
+
+
+class TestJujuVersion(unittest.TestCase):
+
+    def test_parsing(self):
+        test_cases = [
+            ("0.0.0", 0, 0, '', 0, 0),
+            ("0.0.2", 0, 0, '', 2, 0),
+            ("0.1.0", 0, 1, '', 0, 0),
+            ("0.2.3", 0, 2, '', 3, 0),
+            ("10.234.3456", 10, 234, '', 3456, 0),
+            ("10.234.3456.1", 10, 234, '', 3456, 1),
+            ("1.21-alpha12", 1, 21, 'alpha', 12, 0),
+            ("1.21-alpha1.34", 1, 21, 'alpha', 1, 34),
+            ("2.7", 2, 7, '', 0, 0)
+        ]
+
+        for vs, major, minor, tag, patch, build in test_cases:
+            v = JujuVersion(vs)
+            self.assertEqual(v.major, major)
+            self.assertEqual(v.minor, minor)
+            self.assertEqual(v.tag, tag)
+            self.assertEqual(v.patch, patch)
+            self.assertEqual(v.build, build)
+
+    def test_parsing_errors(self):
+        invalid_versions = [
+            "xyz",
+            "foo.bar",
+            "foo.bar.baz",
+            "dead.beef.ca.fe",
+            "1234567890.2.1",     # The major version is too long.
+            "0.2..1",             # Two periods next to each other.
+            "1.21.alpha1",        # Tag comes after period.
+            "1.21-alpha",         # No patch number but a tag is present.
+            "1.21-alpha1beta",    # Non-numeric string after the patch number.
+            "1.21-alpha-dev",     # Tag duplication.
+            "1.21-alpha_dev3",    # Underscore in a tag.
+            "1.21-alpha123dev3",  # Non-numeric string after the patch number.
+        ]
+        for v in invalid_versions:
+            with self.assertRaises(RuntimeError):
+                JujuVersion(v)
+
+    def test_equality(self):
+        test_cases = [
+            ("1.0.0", "1.0.0", True),
+            ("01.0.0", "1.0.0", True),
+            ("10.0.0", "9.0.0", False),
+            ("1.0.0", "1.0.1", False),
+            ("1.0.1", "1.0.0", False),
+            ("1.0.0", "1.1.0", False),
+            ("1.1.0", "1.0.0", False),
+            ("1.0.0", "2.0.0", False),
+            ("1.2-alpha1", "1.2.0", False),
+            ("1.2-alpha2", "1.2-alpha1", False),
+            ("1.2-alpha2.1", "1.2-alpha2", False),
+            ("1.2-alpha2.2", "1.2-alpha2.1", False),
+            ("1.2-beta1", "1.2-alpha1", False),
+            ("1.2-beta1", "1.2-alpha2.1", False),
+            ("1.2-beta1", "1.2.0", False),
+            ("1.2.1", "1.2.0", False),
+            ("2.0.0", "1.0.0", False),
+            ("2.0.0.0", "2.0.0", True),
+            ("2.0.0.0", "2.0.0.0", True),
+            ("2.0.0.1", "2.0.0.0", False),
+            ("2.0.1.10", "2.0.0.0", False),
+        ]
+
+        for a, b, expected in test_cases:
+            self.assertEqual(JujuVersion(a) == JujuVersion(b), expected)
+            self.assertEqual(JujuVersion(a) == b, expected)
+
+    def test_comparison(self):
+        test_cases = [
+            ("1.0.0", "1.0.0", False, True),
+            ("01.0.0", "1.0.0", False, True),
+            ("10.0.0", "9.0.0", False, False),
+            ("1.0.0", "1.0.1", True, True),
+            ("1.0.1", "1.0.0", False, False),
+            ("1.0.0", "1.1.0", True, True),
+            ("1.1.0", "1.0.0", False, False),
+            ("1.0.0", "2.0.0", True, True),
+            ("1.2-alpha1", "1.2.0", True, True),
+            ("1.2-alpha2", "1.2-alpha1", False, False),
+            ("1.2-alpha2.1", "1.2-alpha2", False, False),
+            ("1.2-alpha2.2", "1.2-alpha2.1", False, False),
+            ("1.2-beta1", "1.2-alpha1", False, False),
+            ("1.2-beta1", "1.2-alpha2.1", False, False),
+            ("1.2-beta1", "1.2.0", True, True),
+            ("1.2.1", "1.2.0", False, False),
+            ("2.0.0", "1.0.0", False, False),
+            ("2.0.0.0", "2.0.0", False, True),
+            ("2.0.0.0", "2.0.0.0", False, True),
+            ("2.0.0.1", "2.0.0.0", False, False),
+            ("2.0.1.10", "2.0.0.0", False, False),
+        ]
+
+        for a, b, expected_strict, expected_weak in test_cases:
+            self.assertEqual(JujuVersion(a) < JujuVersion(b), expected_strict)
+            self.assertEqual(JujuVersion(a) <= JujuVersion(b), expected_weak)
+            self.assertEqual(JujuVersion(b) > JujuVersion(a), expected_strict)
+            self.assertEqual(JujuVersion(b) >= JujuVersion(a), expected_weak)
+            # Implicit conversion.
+            self.assertEqual(JujuVersion(a) < b, expected_strict)
+            self.assertEqual(JujuVersion(a) <= b, expected_weak)
+            self.assertEqual(b > JujuVersion(a), expected_strict)
+            self.assertEqual(b >= JujuVersion(a), expected_weak)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_main.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_main.py
new file mode 100755
index 0000000000000000000000000000000000000000..a4ced9485f62ecaa3fa12a9cdbc06bd2327d4a81
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_main.py
@@ -0,0 +1,362 @@
+#!/usr/bin/env python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import unittest
+import logging
+import os
+import sys
+import subprocess
+import pickle
+import base64
+import tempfile
+import shutil
+
+import importlib.util
+
+from pathlib import Path
+
+from ops.charm import (
+    CharmBase,
+    CharmEvents,
+    HookEvent,
+    InstallEvent,
+    StartEvent,
+    ConfigChangedEvent,
+    UpgradeCharmEvent,
+    UpdateStatusEvent,
+    LeaderSettingsChangedEvent,
+    RelationJoinedEvent,
+    RelationChangedEvent,
+    RelationDepartedEvent,
+    RelationBrokenEvent,
+    RelationEvent,
+    StorageAttachedEvent,
+    ActionEvent,
+)
+
+from .test_helpers import fake_script
+
+# This relies on the expected repository structure to find a path to source of the charm under test.
+TEST_CHARM_DIR = Path(f'{__file__}/../charms/test_main').resolve()
+
+logger = logging.getLogger(__name__)
+
+
+class SymlinkTargetError(Exception):
+    pass
+
+
+class EventSpec:
+    def __init__(self, event_type, event_name, env_var=None, relation_id=None, remote_app=None, remote_unit=None,
+                 charm_config=None):
+        self.event_type = event_type
+        self.event_name = event_name
+        self.env_var = env_var
+        self.relation_id = relation_id
+        self.remote_app = remote_app
+        self.remote_unit = remote_unit
+        self.charm_config = charm_config
+
+
+class TestMain(unittest.TestCase):
+
+    def setUp(self):
+        self._setup_charm_dir()
+
+        _, tmp_file = tempfile.mkstemp()
+        self._state_file = Path(tmp_file)
+        self.addCleanup(self._state_file.unlink)
+
+        # Relations events are defined dynamically and modify the class attributes.
+        # We use a subclass temporarily to prevent these side effects from leaking.
+        class TestCharmEvents(CharmEvents):
+            pass
+        CharmBase.on = TestCharmEvents()
+
+        def cleanup():
+            shutil.rmtree(self.JUJU_CHARM_DIR)
+            CharmBase.on = CharmEvents()
+        self.addCleanup(cleanup)
+
+    def _setup_charm_dir(self):
+        self.JUJU_CHARM_DIR = Path(tempfile.mkdtemp()) / 'test_main'
+        self.hooks_dir = self.JUJU_CHARM_DIR / 'hooks'
+        self.charm_exec_path = os.path.relpath(self.JUJU_CHARM_DIR / 'src/charm.py', self.hooks_dir)
+        shutil.copytree(TEST_CHARM_DIR, self.JUJU_CHARM_DIR)
+
+        charm_spec = importlib.util.spec_from_file_location("charm", str(self.JUJU_CHARM_DIR / 'src/charm.py'))
+        self.charm_module = importlib.util.module_from_spec(charm_spec)
+        charm_spec.loader.exec_module(self.charm_module)
+
+        self._prepare_initial_hooks()
+
+    def _prepare_initial_hooks(self):
+        initial_hooks = ('install', 'start', 'upgrade-charm', 'disks-storage-attached')
+        self.hooks_dir.mkdir()
+        for hook in initial_hooks:
+            hook_path = self.hooks_dir / hook
+            hook_path.symlink_to(self.charm_exec_path)
+
+    def _prepare_actions(self):
+        actions_meta = '''
+foo-bar:
+  description: Foos the bar.
+  title: foo-bar
+  params:
+    foo-name:
+      type: string
+      description: A foo name to bar.
+    silent:
+      type: boolean
+      description:
+      default: false
+  required:
+    - foo-name
+start:
+    description: Start the unit.'''
+        actions_dir_name = 'actions'
+        actions_meta_file = 'actions.yaml'
+
+        with open(self.JUJU_CHARM_DIR / actions_meta_file, 'w+') as f:
+            f.write(actions_meta)
+        actions_dir = self.JUJU_CHARM_DIR / actions_dir_name
+        actions_dir.mkdir()
+        for action_name in ('start', 'foo-bar'):
+            action_path = actions_dir / action_name
+            action_path.symlink_to(self.charm_exec_path)
+
+    def _read_and_clear_state(self):
+        state = None
+        if self._state_file.stat().st_size:
+            with open(self._state_file, 'r+b') as state_file:
+                state = pickle.load(state_file)
+                state_file.truncate()
+        return state
+
+    def _simulate_event(self, event_spec):
+        env = {
+            'PATH': f"{str(Path(__file__).parent / 'bin')}:{os.environ['PATH']}",
+            'JUJU_CHARM_DIR': self.JUJU_CHARM_DIR,
+            'JUJU_UNIT_NAME': 'test_main/0',
+            'CHARM_CONFIG': event_spec.charm_config,
+        }
+        if issubclass(event_spec.event_type, RelationEvent):
+            rel_name = event_spec.event_name.split('_')[0]
+            env.update({
+                'JUJU_RELATION': rel_name,
+                'JUJU_RELATION_ID': str(event_spec.relation_id),
+            })
+            remote_app = event_spec.remote_app
+            # For juju < 2.7 app name is extracted from JUJU_REMOTE_UNIT.
+            if remote_app is not None:
+                env['JUJU_REMOTE_APP'] = remote_app
+
+            remote_unit = event_spec.remote_unit
+            if remote_unit is None:
+                remote_unit = ''
+
+            env['JUJU_REMOTE_UNIT'] = remote_unit
+        else:
+            env.update({
+                'JUJU_REMOTE_UNIT': '',
+                'JUJU_REMOTE_APP': '',
+            })
+        if issubclass(event_spec.event_type, ActionEvent):
+            event_filename = event_spec.event_name[:-len('_action')].replace('_', '-')
+            env.update({
+                event_spec.env_var: event_filename,
+            })
+            if event_spec.env_var == 'JUJU_ACTION_NAME':
+                event_dir = 'actions'
+            else:
+                raise RuntimeError('invalid envar name specified for a action event')
+        else:
+            event_filename = event_spec.event_name.replace('_', '-')
+            event_dir = 'hooks'
+        event_file = self.JUJU_CHARM_DIR / event_dir / event_filename
+        # Note that sys.executable is used to make sure we are using the same
+        # interpreter for the child process to support virtual environments.
+        subprocess.check_call([sys.executable, event_file], env=env, cwd=self.JUJU_CHARM_DIR)
+        return self._read_and_clear_state()
+
+    def test_event_reemitted(self):
+        # base64 encoding is used to avoid null bytes.
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        # First run "install" to make sure all hooks are set up.
+        state = self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [InstallEvent])
+
+        state = self._simulate_event(EventSpec(ConfigChangedEvent, 'config-changed', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [ConfigChangedEvent])
+
+        # Re-emit should pick the deferred config-changed.
+        state = self._simulate_event(EventSpec(UpdateStatusEvent, 'update-status', charm_config=charm_config))
+        self.assertEqual(state['observed_event_types'], [ConfigChangedEvent, UpdateStatusEvent])
+
+    def test_multiple_events_handled(self):
+        self._prepare_actions()
+
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        actions_charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+            'USE_ACTIONS': True,
+        }))
+
+        fake_script(self, 'action-get', "echo '{}'")
+
+        # Sample events with a different amount of dashes used
+        # and with endpoints from different sections of metadata.yaml
+        events_under_test = [(
+            EventSpec(InstallEvent, 'install', charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(StartEvent, 'start', charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(UpdateStatusEvent, 'update_status', charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(LeaderSettingsChangedEvent, 'leader_settings_changed', charm_config=charm_config),
+            {},
+        ), (
+            EventSpec(RelationJoinedEvent, 'db_relation_joined', relation_id=1,
+                      remote_app='remote', remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'db', 'relation_id': 1, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed', relation_id=2,
+                      remote_app='remote', remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'mon', 'relation_id': 2, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed', relation_id=2,
+                      remote_app='remote', remote_unit=None, charm_config=charm_config),
+            {'relation_name': 'mon', 'relation_id': 2, 'app_name': 'remote', 'unit_name': None},
+        ), (
+            EventSpec(RelationDepartedEvent, 'mon_relation_departed', relation_id=2,
+                      remote_app='remote', remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'mon', 'relation_id': 2, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationBrokenEvent, 'ha_relation_broken', relation_id=3,
+                      charm_config=charm_config),
+            {'relation_name': 'ha', 'relation_id': 3},
+        ), (
+            # Events without a remote app specified (for Juju < 2.7).
+            EventSpec(RelationJoinedEvent, 'db_relation_joined', relation_id=1,
+                      remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'db', 'relation_id': 1, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationChangedEvent, 'mon_relation_changed', relation_id=2,
+                      remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'mon', 'relation_id': 2, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(RelationDepartedEvent, 'mon_relation_departed', relation_id=2,
+                      remote_unit='remote/0', charm_config=charm_config),
+            {'relation_name': 'mon', 'relation_id': 2, 'app_name': 'remote', 'unit_name': 'remote/0'},
+        ), (
+            EventSpec(ActionEvent, 'start_action', env_var='JUJU_ACTION_NAME', charm_config=actions_charm_config),
+            {},
+        ), (
+            EventSpec(ActionEvent, 'foo_bar_action', env_var='JUJU_ACTION_NAME', charm_config=actions_charm_config),
+            {},
+        )]
+
+        logger.debug(f'Expected events {events_under_test}')
+
+        # First run "install" to make sure all hooks are set up.
+        self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+
+        # Simulate hook executions for every event.
+        for event_spec, expected_event_data in events_under_test:
+            state = self._simulate_event(event_spec)
+
+            state_key = f'on_{event_spec.event_name}'
+            handled_events = state.get(state_key, [])
+
+            # Make sure that a handler for that event was called once.
+            self.assertEqual(len(handled_events), 1)
+            # Make sure the event handled by the Charm has the right type.
+            handled_event_type = handled_events[0]
+            self.assertEqual(handled_event_type, event_spec.event_type)
+
+            self.assertEqual(state['observed_event_types'], [event_spec.event_type])
+
+            if event_spec.event_name in expected_event_data:
+                self.assertEqual(state[f'{event_spec.event_name}_data'], expected_event_data[event_spec.event_name])
+
+    def test_event_not_implemented(self):
+        """Make sure events without implementation do not cause non-zero exit.
+        """
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+
+        # Simulate a scenario where there is a symlink for an event that
+        # a charm does not know how to handle.
+        hook_path = self.JUJU_CHARM_DIR / 'hooks/not-implemented-event'
+        # This will be cleared up in tearDown.
+        hook_path.symlink_to('install')
+
+        try:
+            self._simulate_event(EventSpec(HookEvent, 'not-implemented-event', charm_config=charm_config))
+        except subprocess.CalledProcessError:
+            self.fail('Event simulation for an unsupported event'
+                      ' results in a non-zero exit code returned')
+
+    def test_setup_event_links(self):
+        """Test auto-creation of symlinks caused by initial events.
+        """
+        all_event_hooks = [f'hooks/{e.replace("_", "-")}' for e in self.charm_module.Charm.on.events().keys()]
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        initial_events = {
+            EventSpec(InstallEvent, 'install', charm_config=charm_config),
+            EventSpec(StorageAttachedEvent, 'disks-storage-attached', charm_config=charm_config),
+            EventSpec(StartEvent, 'start', charm_config=charm_config),
+            EventSpec(UpgradeCharmEvent, 'upgrade-charm', charm_config=charm_config),
+        }
+
+        def _assess_event_links(event_spec):
+            self.assertTrue(self.hooks_dir / event_spec.event_name in self.hooks_dir.iterdir())
+            for event_hook in all_event_hooks:
+                self.assertTrue((self.JUJU_CHARM_DIR / event_hook).exists(), f'Missing hook: {event_hook}')
+                self.assertEqual(os.readlink(self.JUJU_CHARM_DIR / event_hook), self.charm_exec_path)
+
+        for initial_event in initial_events:
+            self._setup_charm_dir()
+
+            self._simulate_event(initial_event)
+            _assess_event_links(initial_event)
+            # Make sure it is idempotent.
+            self._simulate_event(initial_event)
+            _assess_event_links(initial_event)
+
+    def test_setup_action_links(self):
+        charm_config = base64.b64encode(pickle.dumps({
+            'STATE_FILE': self._state_file,
+        }))
+        actions_yaml = self.JUJU_CHARM_DIR / 'actions.yaml'
+        actions_yaml.write_text('test: {}')
+        self._simulate_event(EventSpec(InstallEvent, 'install', charm_config=charm_config))
+        action_hook = self.JUJU_CHARM_DIR / 'actions' / 'test'
+        self.assertTrue(action_hook.exists())
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_model.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_model.py
new file mode 100755
index 0000000000000000000000000000000000000000..544f4ff5532e664cfa1ed5f4d1e24b81d7975cab
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/mod/operator/test/test_model.py
@@ -0,0 +1,868 @@
+#!/usr/bin/python3
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import os
+import pathlib
+import unittest
+import time
+import re
+import json
+
+import ops.model
+import ops.charm
+from ops.charm import RelationMeta
+
+from test.test_helpers import fake_script, fake_script_calls
+
+
+class TestModel(unittest.TestCase):
+
+    def setUp(self):
+        def restore_env(env):
+            os.environ.clear()
+            os.environ.update(env)
+        self.addCleanup(restore_env, os.environ.copy())
+
+        os.environ['JUJU_UNIT_NAME'] = 'myapp/0'
+
+        self.backend = ops.model.ModelBackend()
+        meta = ops.charm.CharmMeta()
+        meta.relations = {
+            'db0': RelationMeta('provides', 'db0', {'interface': 'db0', 'scope': 'global'}),
+            'db1': RelationMeta('requires', 'db1', {'interface': 'db1', 'scope': 'global'}),
+            'db2': RelationMeta('peers', 'db2', {'interface': 'db2', 'scope': 'global'}),
+        }
+        self.model = ops.model.Model('myapp/0', meta, self.backend)
+
+    def test_model(self):
+        self.assertIs(self.model.app, self.model.unit.app)
+
+    def test_relations_keys(self):
+        fake_script(self, 'relation-ids',
+                    """[ "$1" = db2 ] && echo '["db2:5", "db2:6"]' || echo '[]'""")
+        fake_script(self, 'relation-list',
+                    """([ "$2" = 5 ] && echo '["remoteapp1/0", "remoteapp1/1"]') || ([ "$2" = 6 ] && echo '["remoteapp2/0"]') || exit 2""")
+
+        for relation in self.model.relations['db2']:
+            self.assertIn(self.model.unit, relation.data)
+            unit_from_rel = next(filter(lambda u: u.name == 'myapp/0', relation.data.keys()))
+            self.assertIs(self.model.unit, unit_from_rel)
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db2', '--format=json'],
+            ['relation-list', '-r', '5', '--format=json'],
+            ['relation-list', '-r', '6', '--format=json']
+        ])
+
+    def test_get_relation(self):
+        err_msg = 'ERROR invalid value "$2" for option -r: relation not found'
+
+        fake_script(self, 'relation-ids',
+                    """([ "$1" = db1 ] && echo '["db1:4"]') || ([ "$1" = db2 ] && echo '["db2:5", "db2:6"]') || echo '[]'""")
+        fake_script(self, 'relation-list',
+                    f"""([ "$2" = 4 ] && echo '["remoteapp1/0"]') || (echo {err_msg} >&2 ; exit 2)""")
+        fake_script(self, 'relation-get',
+                    f"""echo {err_msg} >&2 ; exit 2""")
+
+        with self.assertRaises(ops.model.ModelError):
+            self.model.get_relation('db1', 'db1:4')
+        db1_4 = self.model.get_relation('db1', 4)
+        self.assertIsInstance(db1_4, ops.model.Relation)
+        dead_rel = self.model.get_relation('db1', 7)
+        self.assertIsInstance(dead_rel, ops.model.Relation)
+        self.assertEqual(list(dead_rel.data.keys()), [self.model.unit, self.model.unit.app])
+        self.assertEqual(dead_rel.data[self.model.unit], {})
+        self.assertIsNone(self.model.get_relation('db0'))
+        self.assertIs(self.model.get_relation('db1'), db1_4)
+        with self.assertRaises(ops.model.TooManyRelatedAppsError):
+            self.model.get_relation('db2')
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-list', '-r', '7', '--format=json'],
+            ['relation-get', '-r', '7', '-', 'myapp/0', '--app=False', '--format=json'],
+            ['relation-ids', 'db0', '--format=json'],
+            ['relation-ids', 'db2', '--format=json'],
+            ['relation-list', '-r', '5', '--format=json'],
+            ['relation-list', '-r', '6', '--format=json']
+        ])
+
+    def test_peer_relation_app(self):
+        meta = ops.charm.CharmMeta()
+        meta.relations = {'dbpeer': RelationMeta('peers', 'dbpeer', {'interface': 'dbpeer', 'scope': 'global'})}
+        self.model = ops.model.Model('myapp/0', meta, self.backend)
+
+        err_msg = 'ERROR invalid value "$2" for option -r: relation not found'
+        fake_script(self, 'relation-ids',
+                    '''([ "$1" = dbpeer ] && echo '["dbpeer:0"]') || echo "[]"''')
+        fake_script(self, 'relation-list',
+                    f'''([ "$2" = 0 ] && echo "[]") || (echo {err_msg} >&2 ; exit 2)''')
+
+        db1_4 = self.model.get_relation('dbpeer')
+        self.assertIs(db1_4.app, self.model.app)
+
+    def test_remote_units_is_our(self):
+        fake_script(self, 'relation-ids',
+                    """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list',
+                    """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+
+        for u in self.model.get_relation('db1').units:
+            self.assertFalse(u._is_our_unit)
+            self.assertFalse(u.app._is_our_app)
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json']
+        ])
+
+    def test_our_unit_is_our(self):
+        self.assertTrue(self.model.unit._is_our_unit)
+        self.assertTrue(self.model.unit.app._is_our_app)
+
+    def test_unit_relation_data(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "remoteapp1/0" ]) && echo '{"host": "remoteapp1-0"}' || exit 2""")
+
+        random_unit = self.model._cache.get(ops.model.Unit, 'randomunit/0')
+        with self.assertRaises(KeyError):
+            self.model.get_relation('db1').data[random_unit]
+        remoteapp1_0 = next(filter(lambda u: u.name == 'remoteapp1/0', self.model.get_relation('db1').units))
+        self.assertEqual(self.model.get_relation('db1').data[remoteapp1_0], {'host': 'remoteapp1-0'})
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'remoteapp1/0', '--app=False', '--format=json']
+        ])
+
+    def test_remote_app_relation_data(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+        fake_script(self, 'relation-get', """[ "$2" = 4 ] && [ "$4" = remoteapp1 ] && echo '{"secret": "cafedeadbeef"}' || exit 2""")
+
+        # Try to get relation data for an invalid remote application.
+        random_app = self.model._cache.get(ops.model.Application, 'randomapp')
+        with self.assertRaises(KeyError):
+            self.model.get_relation('db1').data[random_app]
+
+        remoteapp1 = self.model.get_relation('db1').app
+        self.assertEqual(self.model.get_relation('db1').data[remoteapp1], {'secret': 'cafedeadbeef'})
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'remoteapp1', '--app=True', '--format=json'],
+        ])
+
+    def test_relation_data_modify_remote(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "remoteapp1/0" ]) && echo '{"host": "remoteapp1-0"}' || exit 2""")
+
+        rel_db1 = self.model.get_relation('db1')
+        remoteapp1_0 = next(filter(lambda u: u.name == 'remoteapp1/0', self.model.get_relation('db1').units))
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[remoteapp1_0])
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[remoteapp1_0]['foo'] = 'bar'
+        self.assertNotIn('foo', rel_db1.data[remoteapp1_0])
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'remoteapp1/0', '--app=False', '--format=json']
+        ])
+
+    def test_relation_data_modify_our(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-set', '''[ "$2" = 4 ] && exit 0 || exit 2''')
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "myapp/0" ]) && echo '{"host": "bar"}' || exit 2""")
+
+        rel_db1 = self.model.get_relation('db1')
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[self.model.unit])
+        rel_db1.data[self.model.unit]['host'] = 'bar'
+        self.assertEqual(rel_db1.data[self.model.unit]['host'], 'bar')
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'myapp/0', '--app=False', '--format=json'],
+            ['relation-set', '-r', '4', 'host=bar', '--app=False']
+        ])
+
+    def test_app_relation_data_modify_local_as_leader(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+        fake_script(self, 'relation-get', """[ "$2" = 4 ] && [ "$4" = myapp ] && echo '{"password": "deadbeefcafe"}' || exit 2""")
+        fake_script(self, 'relation-set', """[ "$2" = 4 ] && exit 0 || exit 2""")
+        fake_script(self, 'is-leader', 'echo true')
+
+        local_app = self.model.unit.app
+
+        rel_db1 = self.model.get_relation('db1')
+        self.assertEqual(rel_db1.data[local_app], {'password': 'deadbeefcafe'})
+
+        rel_db1.data[local_app]['password'] = 'foo'
+
+        self.assertEqual(rel_db1.data[local_app]['password'], 'foo')
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'myapp', '--app=True', '--format=json'],
+            ['is-leader', '--format=json'],
+            ['relation-set', '-r', '4', 'password=foo', '--app=True'],
+        ])
+
+    def test_app_relation_data_modify_local_as_minion(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+        fake_script(self, 'relation-get', """[ "$2" = 4 ] && [ "$4" = myapp ] && echo '{"password": "deadbeefcafe"}' || exit 2""")
+        fake_script(self, 'is-leader', 'echo false')
+
+        local_app = self.model.unit.app
+
+        rel_db1 = self.model.get_relation('db1')
+        self.assertEqual(rel_db1.data[local_app], {'password': 'deadbeefcafe'})
+
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[local_app]['password'] = 'foobar'
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'myapp', '--app=True', '--format=json'],
+            ['is-leader', '--format=json'],
+        ])
+
+    def test_relation_data_del_key(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-set', '''[ "$2" = 4 ] && exit 0 || exit 2''')
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "myapp/0" ]) && echo '{"host": "bar"}' || exit 2""")
+
+        rel_db1 = self.model.get_relation('db1')
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db1.data[self.model.unit])
+        del rel_db1.data[self.model.unit]['host']
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "myapp/0" ]) && echo '{}' || exit 2""")
+        self.assertNotIn('host', rel_db1.data[self.model.unit])
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['relation-get', '-r', '4', '-', 'myapp/0', '--app=False', '--format=json'],
+            ['relation-set', '-r', '4', 'host=', '--app=False']
+        ])
+
+    def test_relation_set_fail(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db2 ] && echo '["db2:5"]' || echo '[]'""")
+        fake_script(self, 'relation-list',
+                    """[ "$2" = 5 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-get', """([ "$2" = 5 ] && [ "$4" = "myapp/0" ]) && echo '{"host": "myapp-0"}' || exit 2""")
+        fake_script(self, 'relation-set', 'exit 2')
+
+        rel_db2 = self.model.relations['db2'][0]
+        # Force memory cache to be loaded.
+        self.assertIn('host', rel_db2.data[self.model.unit])
+        with self.assertRaises(ops.model.ModelError):
+            rel_db2.data[self.model.unit]['host'] = 'bar'
+        self.assertEqual(rel_db2.data[self.model.unit]['host'], 'myapp-0')
+        with self.assertRaises(ops.model.ModelError):
+            del rel_db2.data[self.model.unit]['host']
+        self.assertIn('host', rel_db2.data[self.model.unit])
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db2', '--format=json'],
+            ['relation-list', '-r', '5', '--format=json'],
+            ['relation-get', '-r', '5', '-', 'myapp/0', '--app=False', '--format=json'],
+            ['relation-set', '-r', '5', 'host=bar', '--app=False'],
+            ['relation-set', '-r', '5', 'host=', '--app=False']
+        ])
+
+    def test_relation_get_set_is_app_arg(self):
+        self.backend = ops.model.ModelBackend()
+
+        # No is_app provided.
+        with self.assertRaises(TypeError):
+            self.backend.relation_set(1, 'fookey', 'barval')
+
+        with self.assertRaises(TypeError):
+            self.backend.relation_get(1, 'fooentity')
+
+        # Invalid types for is_app.
+        for is_app_v in [None, 1, 2.0, 'a', b'beef']:
+            with self.assertRaises(TypeError):
+                self.backend.relation_set(1, 'fookey', 'barval', is_app=is_app_v)
+
+            with self.assertRaises(TypeError):
+                self.backend.relation_get(1, 'fooentity', is_app=is_app_v)
+
+    def test_relation_data_type_check(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list',
+                    """[ "$2" = 4 ] && echo '["remoteapp1/0"]' || exit 2""")
+        fake_script(self, 'relation-get', """([ "$2" = 4 ] && [ "$4" = "myapp/0" ]) && echo '{"host": "myapp-0"}' || exit 2""")
+
+        rel_db1 = self.model.get_relation('db1')
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = 1
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = {'foo': 'bar'}
+        with self.assertRaises(ops.model.RelationDataError):
+            rel_db1.data[self.model.unit]['foo'] = None
+
+        self.assertEqual(fake_script_calls(self), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json']
+        ])
+
+    def test_config(self):
+        fake_script(self, 'config-get', """echo '{"foo":"foo","bar":1,"qux":true}'""")
+        self.assertEqual(self.model.config, {
+            'foo': 'foo',
+            'bar': 1,
+            'qux': True,
+        })
+        with self.assertRaises(TypeError):
+            # Confirm that we cannot modify config values.
+            self.model.config['foo'] = 'bar'
+
+        self.assertEqual(fake_script_calls(self), [['config-get', '--format=json']])
+
+    def test_is_leader(self):
+        def check_remote_units():
+            fake_script(self, 'relation-ids',
+                        """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+
+            fake_script(self, 'relation-list',
+                        """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+
+            # Cannot determine leadership for remote units.
+            for u in self.model.get_relation('db1').units:
+                with self.assertRaises(RuntimeError):
+                    u.is_leader()
+
+        fake_script(self, 'is-leader', 'echo true')
+        self.assertTrue(self.model.unit.is_leader())
+
+        check_remote_units()
+
+        # Create a new model and backend to drop a cached is-leader output.
+        self.backend = ops.model.ModelBackend()
+        meta = ops.charm.CharmMeta()
+        meta.relations = {
+            'db0': RelationMeta('provides', 'db0', {'interface': 'db0', 'scope': 'global'}),
+            'db1': RelationMeta('requires', 'db1', {'interface': 'db1', 'scope': 'global'}),
+            'db2': RelationMeta('peers', 'db2', {'interface': 'db2', 'scope': 'global'}),
+        }
+        self.model = ops.model.Model('myapp/0', meta, self.backend)
+
+        fake_script(self, 'is-leader', 'echo false')
+        self.assertFalse(self.model.unit.is_leader())
+
+        check_remote_units()
+
+        self.assertEqual(fake_script_calls(self), [
+            ['is-leader', '--format=json'],
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+            ['is-leader', '--format=json'],
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+        ])
+
+    def test_is_leader_refresh(self):
+        # A sanity check.
+        self.assertGreater(time.monotonic(), ops.model.ModelBackend.LEASE_RENEWAL_PERIOD.total_seconds())
+
+        fake_script(self, 'is-leader', 'echo false')
+        self.assertFalse(self.model.unit.is_leader())
+
+        # Change the leadership status and force a recheck.
+        fake_script(self, 'is-leader', 'echo true')
+        self.backend._leader_check_time = 0
+        self.assertTrue(self.model.unit.is_leader())
+
+        # Force a recheck without changing the leadership status.
+        fake_script(self, 'is-leader', 'echo true')
+        self.backend._leader_check_time = 0
+        self.assertTrue(self.model.unit.is_leader())
+
+    def test_resources(self):
+        meta = ops.charm.CharmMeta()
+        meta.resources = {'foo': None, 'bar': None}
+        model = ops.model.Model('myapp/0', meta, self.backend)
+
+        with self.assertRaises(RuntimeError):
+            model.resources.fetch('qux')
+
+        fake_script(self, 'resource-get', 'exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            model.resources.fetch('foo')
+
+        fake_script(self, 'resource-get', 'echo /var/lib/juju/agents/unit-test-0/resources/$1/$1.tgz')
+        self.assertEqual(model.resources.fetch('foo').name, 'foo.tgz')
+        self.assertEqual(model.resources.fetch('bar').name, 'bar.tgz')
+
+    def test_pod_spec(self):
+        fake_script(self, 'pod-spec-set', """
+                    cat $2 > $(dirname $0)/spec.json
+                    [[ -n $4 ]] && cat $4 > $(dirname $0)/k8s_res.json || true
+                    """)
+        fake_script(self, 'is-leader', 'echo true')
+        spec_path = self.fake_script_path / 'spec.json'
+        k8s_res_path = self.fake_script_path / 'k8s_res.json'
+
+        def check_calls(calls):
+            # There may 1 or 2 calls because of is-leader.
+            self.assertLessEqual(len(fake_calls), 2)
+            pod_spec_call = next(filter(lambda c: c[0] == 'pod-spec-set', calls))
+            self.assertEqual(pod_spec_call[:2], ['pod-spec-set', '--file'])
+            # 8 bytes are used as of python 3.4.0, see Python bug #12015.
+            # Other characters are from POSIX 3.282 (Portable Filename Character Set) a subset of which Python's mkdtemp uses.
+            self.assertTrue(re.match('/tmp/tmp[A-Za-z0-9._-]{8}-pod-spec-set', pod_spec_call[2]))
+
+        self.model.pod.set_spec({'foo': 'bar'})
+        self.assertEqual(spec_path.read_text(), '{"foo": "bar"}')
+        self.assertFalse(k8s_res_path.exists())
+
+        fake_calls = fake_script_calls(self, clear=True)
+        check_calls(fake_calls)
+
+        self.model.pod.set_spec({'bar': 'foo'}, {'qux': 'baz'})
+        self.assertEqual(spec_path.read_text(), '{"bar": "foo"}')
+        self.assertEqual(k8s_res_path.read_text(), '{"qux": "baz"}')
+
+        fake_calls = fake_script_calls(self, clear=True)
+        check_calls(fake_calls)
+
+        # Create a new model to drop is-leader caching result.
+        self.backend = ops.model.ModelBackend()
+        meta = ops.charm.CharmMeta()
+        self.model = ops.model.Model('myapp/0', meta, self.backend)
+        fake_script(self, 'is-leader', 'echo false')
+        with self.assertRaises(ops.model.ModelError):
+            self.model.pod.set_spec({'foo': 'bar'})
+
+    def test_base_status_instance_raises(self):
+        with self.assertRaises(TypeError):
+            ops.model.StatusBase('test')
+
+    def test_active_message_default(self):
+        self.assertEqual(ops.model.ActiveStatus().message, '')
+
+    def test_local_set_valid_unit_status(self):
+        test_cases = [(
+            ops.model.ActiveStatus('Green'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertEqual(fake_script_calls(self, True), [['status-set', '--application=False', 'active', 'Green']]),
+        ), (
+            ops.model.MaintenanceStatus('Yellow'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertEqual(fake_script_calls(self, True), [['status-set', '--application=False', 'maintenance', 'Yellow']]),
+        ), (
+            ops.model.BlockedStatus('Red'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertEqual(fake_script_calls(self, True), [['status-set', '--application=False', 'blocked', 'Red']]),
+        ), (
+            ops.model.WaitingStatus('White'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertEqual(fake_script_calls(self, True), [['status-set', '--application=False', 'waiting', 'White']]),
+        )]
+
+        for target_status, setup_tools, check_tool_calls in test_cases:
+            setup_tools()
+
+            self.model.unit.status = target_status
+
+            self.assertEqual(self.model.unit.status, target_status)
+
+            check_tool_calls()
+
+    def test_local_set_valid_app_status(self):
+        fake_script(self, 'is-leader', 'echo true')
+        test_cases = [(
+            ops.model.ActiveStatus('Green'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertIn(['status-set', '--application=True', 'active', 'Green'], fake_script_calls(self, True)),
+        ), (
+            ops.model.MaintenanceStatus('Yellow'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertIn(['status-set', '--application=True', 'maintenance', 'Yellow'], fake_script_calls(self, True)),
+        ), (
+            ops.model.BlockedStatus('Red'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertIn(['status-set', '--application=True', 'blocked', 'Red'], fake_script_calls(self, True)),
+        ), (
+            ops.model.WaitingStatus('White'),
+            lambda: fake_script(self, 'status-set', 'exit 0'),
+            lambda: self.assertIn(['status-set', '--application=True', 'waiting', 'White'], fake_script_calls(self, True)),
+        )]
+
+        for target_status, setup_tools, check_tool_calls in test_cases:
+            setup_tools()
+
+            self.model.app.status = target_status
+
+            self.assertEqual(self.model.app.status, target_status)
+
+            check_tool_calls()
+
+    def test_set_app_status_non_leader_raises(self):
+        fake_script(self, 'is-leader', 'echo false')
+
+        with self.assertRaises(RuntimeError):
+            self.model.app.status
+
+        with self.assertRaises(RuntimeError):
+            self.model.app.status = ops.model.ActiveStatus()
+
+    def test_local_set_invalid_status(self):
+        fake_script(self, 'status-set', 'exit 1')
+        fake_script(self, 'is-leader', 'echo true')
+
+        with self.assertRaises(ops.model.ModelError):
+            self.model.unit.status = ops.model.UnknownStatus()
+
+        self.assertEqual(fake_script_calls(self, True), [
+            ['status-set', '--application=False', 'unknown', ''],
+        ])
+
+        with self.assertRaises(ops.model.ModelError):
+            self.model.app.status = ops.model.UnknownStatus()
+
+        # A leadership check is needed for application status.
+        self.assertEqual(fake_script_calls(self, True), [
+            ['is-leader', '--format=json'],
+            ['status-set', '--application=True', 'unknown', ''],
+        ])
+
+    def test_status_set_is_app_not_bool_raises(self):
+        self.backend = ops.model.ModelBackend()
+
+        for is_app_v in [None, 1, 2.0, 'a', b'beef', object]:
+            with self.assertRaises(TypeError):
+                self.backend.status_set(ops.model.ActiveStatus, is_app=is_app_v)
+
+    def test_remote_unit_status(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+
+        remote_unit = next(filter(lambda u: u.name == 'remoteapp1/0', self.model.get_relation('db1').units))
+
+        test_statuses = (
+            ops.model.UnknownStatus(),
+            ops.model.ActiveStatus('Green'),
+            ops.model.MaintenanceStatus('Yellow'),
+            ops.model.BlockedStatus('Red'),
+            ops.model.WaitingStatus('White'),
+        )
+
+        for target_status in test_statuses:
+            with self.assertRaises(RuntimeError):
+                remote_unit.status = target_status
+
+    def test_remote_app_status(self):
+        fake_script(self, 'relation-ids', """[ "$1" = db1 ] && echo '["db1:4"]' || echo '[]'""")
+        fake_script(self, 'relation-list', """[ "$2" = 4 ] && echo '["remoteapp1/0", "remoteapp1/1"]' || exit 2""")
+
+        remoteapp1 = self.model.get_relation('db1').app
+
+        # Remote application status is always unknown.
+        self.assertIsInstance(remoteapp1.status, ops.model.UnknownStatus)
+
+        test_statuses = (
+            ops.model.UnknownStatus(),
+            ops.model.ActiveStatus(),
+            ops.model.MaintenanceStatus('Upgrading software'),
+            ops.model.BlockedStatus('Awaiting manual resolution'),
+            ops.model.WaitingStatus('Awaiting related app updates'),
+        )
+        for target_status in test_statuses:
+            with self.assertRaises(RuntimeError):
+                remoteapp1.status = target_status
+
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['relation-ids', 'db1', '--format=json'],
+            ['relation-list', '-r', '4', '--format=json'],
+        ])
+
+    def test_storage(self):
+        meta = ops.charm.CharmMeta()
+        meta.storages = {'disks': None, 'data': None}
+        self.model = ops.model.Model('myapp/0', meta, self.backend)
+
+        fake_script(self, 'storage-list', """[ "$1" = disks ] && echo '["disks/0", "disks/1"]' || echo '[]'""")
+        fake_script(self, 'storage-get',
+                    """
+                    if [ "$2" = disks/0 ]; then
+                      echo '"/var/srv/disks/0"'
+                    elif [ "$2" = disks/1 ]; then
+                      echo '"/var/srv/disks/1"'
+                    else
+                      exit 2
+                    fi
+                    """)
+        fake_script(self, 'storage-add', '')
+
+        self.assertEqual(len(self.model.storages), 2)
+        self.assertEqual(self.model.storages.keys(), meta.storages.keys())
+        self.assertIn('disks', self.model.storages)
+        test_cases = {
+            0: {'name': 'disks', 'location': pathlib.Path('/var/srv/disks/0')},
+            1: {'name': 'disks', 'location': pathlib.Path('/var/srv/disks/1')},
+        }
+        for storage in self.model.storages['disks']:
+            self.assertEqual(storage.name, 'disks')
+            self.assertIn(storage.id, test_cases)
+            self.assertEqual(storage.name, test_cases[storage.id]['name'])
+            self.assertEqual(storage.location, test_cases[storage.id]['location'])
+
+        self.assertEqual(fake_script_calls(self, clear=True), [
+            ['storage-list', 'disks', '--format=json'],
+            ['storage-get', '-s', 'disks/0', 'location', '--format=json'],
+            ['storage-get', '-s', 'disks/1', 'location', '--format=json'],
+        ])
+
+        self.assertSequenceEqual(self.model.storages['data'], [])
+        self.model.storages.request('data', count=3)
+        self.assertEqual(fake_script_calls(self), [
+            ['storage-list', 'data', '--format=json'],
+            ['storage-add', 'data=3'],
+        ])
+
+        # Try to add storage not present in charm metadata.
+        with self.assertRaises(ops.model.ModelError):
+            self.model.storages.request('deadbeef')
+
+        # Invalid count parameter types.
+        for count_v in [None, False, 2.0, 'a', b'beef', object]:
+            with self.assertRaises(TypeError):
+                self.model.storages.request('data', count_v)
+
+
+class TestModelBackend(unittest.TestCase):
+
+    def setUp(self):
+        os.environ['JUJU_UNIT_NAME'] = 'myapp/0'
+        self.addCleanup(os.environ.pop, 'JUJU_UNIT_NAME')
+
+        self._backend = None
+
+    @property
+    def backend(self):
+        if self._backend is None:
+            self._backend = ops.model.ModelBackend()
+        return self._backend
+
+    def test_relation_tool_errors(self):
+        err_msg = 'ERROR invalid value "$2" for option -r: relation not found'
+
+        test_cases = [(
+            lambda: fake_script(self, 'relation-list', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_list(3),
+            ops.model.ModelError,
+            [['relation-list', '-r', '3', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-list', f'echo {err_msg} >&2 ; exit 2'),
+            lambda: self.backend.relation_list(3),
+            ops.model.RelationNotFoundError,
+            [['relation-list', '-r', '3', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-set', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_set(3, 'foo', 'bar', is_app=False),
+            ops.model.ModelError,
+            [['relation-set', '-r', '3', 'foo=bar', '--app=False']],
+        ), (
+            lambda: fake_script(self, 'relation-set', f'echo {err_msg} >&2 ; exit 2'),
+            lambda: self.backend.relation_set(3, 'foo', 'bar', is_app=False),
+            ops.model.RelationNotFoundError,
+            [['relation-set', '-r', '3', 'foo=bar', '--app=False']],
+        ), (
+            lambda: fake_script(self, 'relation-get', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.relation_get(3, 'remote/0', is_app=False),
+            ops.model.ModelError,
+            [['relation-get', '-r', '3', '-', 'remote/0', '--app=False', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'relation-get', f'echo {err_msg} >&2 ; exit 2'),
+            lambda: self.backend.relation_get(3, 'remote/0', is_app=False),
+            ops.model.RelationNotFoundError,
+            [['relation-get', '-r', '3', '-', 'remote/0', '--app=False', '--format=json']],
+        )]
+
+        for do_fake, run, exception, calls in test_cases:
+            do_fake()
+            with self.assertRaises(exception):
+                run()
+            self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_status_is_app_forced_kwargs(self):
+        fake_script(self, 'status-get', 'exit 1')
+        fake_script(self, 'status-set', 'exit 1')
+
+        test_cases = (
+            lambda: self.backend.status_get(False),
+            lambda: self.backend.status_get(True),
+            lambda: self.backend.status_set('active', '', False),
+            lambda: self.backend.status_set('active', '', True),
+        )
+
+        for case in test_cases:
+            with self.assertRaises(TypeError):
+                case()
+
+    def test_storage_tool_errors(self):
+        test_cases = [(
+            lambda: fake_script(self, 'storage-list', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_list('foobar'),
+            ops.model.ModelError,
+            [['storage-list', 'foobar', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'storage-get', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_get('foobar', 'someattr'),
+            ops.model.ModelError,
+            [['storage-get', '-s', 'foobar', 'someattr', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'storage-add', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=2),
+            ops.model.ModelError,
+            [['storage-add', 'foobar=2']],
+        ), (
+            lambda: fake_script(self, 'storage-add', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=object),
+            TypeError,
+            [],
+        ), (
+            lambda: fake_script(self, 'storage-add', f'echo fooerror >&2 ; exit 1'),
+            lambda: self.backend.storage_add('foobar', count=True),
+            TypeError,
+            [],
+        )]
+        for do_fake, run, exception, calls in test_cases:
+            do_fake()
+            with self.assertRaises(exception):
+                run()
+            self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_network_get(self):
+        network_get_out = '''{
+  "bind-addresses": [
+    {
+      "mac-address": "",
+      "interface-name": "",
+      "addresses": [
+        {
+          "hostname": "",
+          "value": "192.0.2.2",
+          "cidr": ""
+        }
+      ]
+    }
+  ],
+  "egress-subnets": [
+    "192.0.2.2/32"
+  ],
+  "ingress-addresses": [
+    "192.0.2.2"
+  ]
+}'''
+        fake_script(self, 'network-get', f'''[ "$1" = deadbeef ] && echo '{network_get_out}' || exit 1''')
+        network_info = self.backend.network_get('deadbeef')
+        self.assertEqual(network_info, json.loads(network_get_out))
+        self.assertEqual(fake_script_calls(self, clear=True), [['network-get', 'deadbeef', '--format=json']])
+
+        network_info = self.backend.network_get('deadbeef', 1)
+        self.assertEqual(network_info, json.loads(network_get_out))
+        self.assertEqual(fake_script_calls(self, clear=True), [['network-get', 'deadbeef', '-r', '1', '--format=json']])
+
+    def test_network_get_errors(self):
+        err_no_endpoint = 'ERROR no network config found for binding "$2"'
+        err_no_rel = 'ERROR invalid value "$3" for option -r: relation not found'
+
+        test_cases = [(
+            lambda: fake_script(self, 'network-get', f'echo {err_no_endpoint} >&2 ; exit 1'),
+            lambda: self.backend.network_get("deadbeef"),
+            ops.model.ModelError,
+            [['network-get', 'deadbeef', '--format=json']],
+        ), (
+            lambda: fake_script(self, 'network-get', f'echo {err_no_rel} >&2 ; exit 2'),
+            lambda: self.backend.network_get("deadbeef", 3),
+            ops.model.RelationNotFoundError,
+            [['network-get', 'deadbeef', '-r', '3', '--format=json']],
+        )]
+        for do_fake, run, exception, calls in test_cases:
+            do_fake()
+            with self.assertRaises(exception):
+                run()
+            self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_get_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-get', f'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_get()
+        calls = [['action-get', '--format=json']]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_set_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-set', f'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_set({'foo': 'bar', 'dead': 'beef cafe'})
+        calls = [["action-set", "foo=bar", "dead=beef cafe"]]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_log_error(self):
+        fake_script(self, 'action-get', '')
+        fake_script(self, 'action-log', f'echo fooerror >&2 ; exit 1')
+        with self.assertRaises(ops.model.ModelError):
+            self.backend.action_log('log-message')
+        calls = [["action-log", "log-message"]]
+        self.assertEqual(fake_script_calls(self, clear=True), calls)
+
+    def test_action_get(self):
+        fake_script(self, 'action-get', """echo '{"foo-name": "bar", "silent": false}'""")
+        params = self.backend.action_get()
+        self.assertEqual(params['foo-name'], 'bar')
+        self.assertEqual(params['silent'], False)
+        self.assertEqual(fake_script_calls(self), [['action-get', '--format=json']])
+
+    def test_action_set(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-set', 'exit 0')
+        self.backend.action_set({'x': 'dead beef', 'y': 1})
+        self.assertEqual(fake_script_calls(self), [['action-set', 'x=dead beef', 'y=1']])
+
+    def test_action_fail(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-fail', 'exit 0')
+        self.backend.action_fail('error 42')
+        self.assertEqual(fake_script_calls(self), [['action-fail', 'error 42']])
+
+    def test_action_log(self):
+        fake_script(self, 'action-get', 'exit 1')
+        fake_script(self, 'action-log', 'exit 0')
+        self.backend.action_log('progress: 42%')
+        self.assertEqual(fake_script_calls(self), [['action-log', 'progress: 42%']])
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/requirements.txt b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..8608c1b021f8e1b01ba7e0d6698102a06214a452
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/requirements.txt
@@ -0,0 +1 @@
+paramiko
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/src/charm.py b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..eb61f692e46b5fe7b6793f5d9a300718980e2f27
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/charms/charm-simple-k8s/src/charm.py
@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+
+import sys
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+import os
+import subprocess
+
+
+def install_dependencies():
+    # Make sure Python3 + PIP are available
+    if not os.path.exists("/usr/bin/python3") or not os.path.exists("/usr/bin/pip3"):
+        # This is needed when running as a k8s charm, as the ubuntu:latest
+        # image doesn't include either package.
+
+        # Update the apt cache
+        subprocess.check_call(["apt-get", "update"])
+
+        # Install the Python3 package
+        subprocess.check_call(["apt-get", "install", "-y", "python3", "python3-pip"],)
+
+
+    # Install the build dependencies for our requirements (paramiko)
+    subprocess.check_call(["apt-get", "install", "-y", "libffi-dev", "libssl-dev"],)
+
+    REQUIREMENTS_TXT = "{}/requirements.txt".format(os.environ["JUJU_CHARM_DIR"])
+    if os.path.exists(REQUIREMENTS_TXT):
+        subprocess.check_call(
+            ["apt-get", "install", "-y", "python3-paramiko", "openssh-client"],
+        )
+
+
+try:
+    from charms.osm.sshproxy import SSHProxy
+except Exception as ex:
+    install_dependencies()
+    from charms.osm.sshproxy import SSHProxy
+
+
+class SimpleProxyCharm(CharmBase):
+    state = StoredState()
+
+    def __init__(self, *args):
+        super().__init__(*args)
+
+        # An example of setting charm state
+        # that's persistent across events
+        self.state.set_default(is_started=False)
+
+        if not self.state.is_started:
+            self.state.is_started = True
+
+        # Register all of the events we want to observe
+        for event in (
+            # Charm events
+            self.on.config_changed,
+            self.on.start,
+            self.on.upgrade_charm,
+            # Charm actions (primitives)
+            self.on.touch_action,
+            # OSM actions (primitives)
+            self.on.start_action,
+            self.on.stop_action,
+            self.on.restart_action,
+            self.on.reboot_action,
+            self.on.upgrade_action,
+            # SSH Proxy actions (primitives)
+            self.on.generate_ssh_key_action,
+            self.on.get_ssh_public_key_action,
+            self.on.run_action,
+            self.on.verify_ssh_credentials_action,
+        ):
+            self.framework.observe(event, self)
+
+    def get_ssh_proxy(self):
+        """Get the SSHProxy instance"""
+        proxy = SSHProxy(
+            hostname=self.model.config["ssh-hostname"],
+            username=self.model.config["ssh-username"],
+            password=self.model.config["ssh-password"],
+        )
+        return proxy
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        unit = self.model.unit
+
+        # Unit should go into a waiting state until verify_ssh_credentials is successful
+        unit.status = WaitingStatus("Waiting for SSH credentials")
+        proxy = self.get_ssh_proxy()
+
+        verified = proxy.verify_credentials()
+        if verified:
+            unit.status = ActiveStatus()
+        else:
+            unit.status = BlockedStatus("Invalid SSH credentials.")
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        unit = self.model.unit
+
+        if not SSHProxy.has_ssh_key():
+            unit.status = MaintenanceStatus("Generating SSH keys...")
+
+            print("Generating SSH Keys")
+            SSHProxy.generate_ssh_key()
+
+        unit.status = ActiveStatus()
+
+    def on_touch_action(self, event):
+        """Touch a file."""
+        try:
+            filename = event.params["filename"]
+            proxy = self.get_ssh_proxy()
+
+            stdout, stderr = proxy.run("touch {}".format(filename))
+            event.set_results({"output": stdout})
+        except Exception as ex:
+            event.fail(ex)
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+        unit = self.model.unit
+
+        # Mark the unit as under Maintenance.
+        unit.status = MaintenanceStatus("Upgrading charm")
+
+        self.on_install(event)
+
+        # When maintenance is done, return to an Active state
+        unit.status = ActiveStatus()
+
+    ###############
+    # OSM methods #
+    ###############
+    def on_start_action(self, event):
+        """Start the VNF service on the VM."""
+        pass
+
+    def on_stop_action(self, event):
+        """Stop the VNF service on the VM."""
+        pass
+
+    def on_restart_action(self, event):
+        """Restart the VNF service on the VM."""
+        pass
+
+    def on_reboot_action(self, event):
+        """Reboot the VM."""
+        proxy = self.get_ssh_proxy()
+        stdout, stderr = proxy.run("sudo reboot")
+
+        if len(stderr):
+            event.fail(stderr)
+
+    def on_upgrade_action(self, event):
+        """Upgrade the VNF service on the VM."""
+        pass
+
+    #####################
+    # SSH Proxy methods #
+    #####################
+    def on_generate_ssh_key_action(self, event):
+        """Generate a new SSH keypair for this unit."""
+
+        if not SSHProxy.generate_ssh_key():
+            event.fail("Unable to generate ssh key")
+
+    def on_get_ssh_public_key_action(self, event):
+        """Get the SSH public key for this unit."""
+
+        pubkey = SSHProxy.get_ssh_public_key()
+
+        event.set_results({"pubkey": SSHProxy.get_ssh_public_key()})
+
+    def on_run_action(self, event):
+        """Run an arbitrary command on the remote host."""
+
+        cmd = event.params["command"]
+
+        proxy = self.get_ssh_proxy()
+        stdout, stderr = proxy.run(cmd)
+
+        event.set_results({"output": stdout})
+
+        if len(stderr):
+            event.fail(stderr)
+
+    def on_verify_ssh_credentials_action(self, event):
+        """Verify the SSH credentials for this unit."""
+
+        proxy = self.get_ssh_proxy()
+
+        verified, stderr = proxy.verify_credentials()
+        if verified:
+            print("Verified!")
+            event.set_results({"verified": True})
+        else:
+            print("Verification failed!")
+            event.set_results({"verified": False})
+            event.fail(stderr)
+
+
+if __name__ == "__main__":
+    main(SimpleProxyCharm)
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/cloud_init/cloud-config.txt b/SOL004/hackfest_k8sproxycharm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/hackfest_k8sproxycharm_vnfd.yaml b/SOL004/hackfest_k8sproxycharm_vnf/hackfest_k8sproxycharm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cdf103295da96cd171a1232321f0178ab38dc6cb
--- /dev/null
+++ b/SOL004/hackfest_k8sproxycharm_vnf/hackfest_k8sproxycharm_vnfd.yaml
@@ -0,0 +1,95 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - name: touch
+            execution-environment-ref: simple-k8s-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: hackfest_k8sproxycharm-vnf
+          execution-environment-list:
+          - id: simple-k8s-ee
+            juju:
+              charm: charm-simple-k8s
+              cloud: k8s
+              proxy: true
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-k8s-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm4u
+            seq: '1'
+          - name: touch
+            execution-environment-ref: simple-k8s-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: '2'
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: hackfest_k8sproxycharm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_k8sproxycharm-vnf
+  sw-image-desc:
+  - id: bionic
+    image: bionic
+    name: bionic
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: VIRTIO
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: VIRTIO
+    name: mgmtVM
+    sw-image-desc: bionic
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
diff --git a/SOL004/hackfest_k8sproxycharm_vnf/icons/osm.png b/SOL004/hackfest_k8sproxycharm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_k8sproxycharm_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_multivdu_ns/hackfest_multivdu_nsd.yaml b/SOL004/hackfest_multivdu_ns/hackfest_multivdu_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..dcf32908e279d42c039a0820641d786d74943c98
--- /dev/null
+++ b/SOL004/hackfest_multivdu_ns/hackfest_multivdu_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_multivdu-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_multivdu-vnf
+    id: hackfest_multivdu-ns
+    name: hackfest_multivdu-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - hackfest_multivdu-vnf
diff --git a/SOL004/hackfest_multivdu_ns/icons/osm.png b/SOL004/hackfest_multivdu_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_multivdu_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_multivdu_vnf/hackfest_multivdu_vnfd.yaml b/SOL004/hackfest_multivdu_vnf/hackfest_multivdu_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..1ec95702e052f3baeb3c74fb7b19c09a82a3b27f
--- /dev/null
+++ b/SOL004/hackfest_multivdu_vnf/hackfest_multivdu_vnfd.yaml
@@ -0,0 +1,92 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs connected to an internal VL
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: dataVM
+  id: hackfest_multivdu-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_multivdu-vnf
+  sw-image-desc:
+  - id: US1604
+    image: US1604
+    name: US1604
+  vdu:
+  - id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: US1604
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - id: dataVM
+    int-cpd:
+    - id: dataVM-eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: dataVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: dataVM
+    sw-image-desc: US1604
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-memory:
+      size: 1.0
+    virtual-cpu:
+      num-virtual-cpu: 1
+  - id: dataVM-compute
+    virtual-memory:
+      size: 1.0
+    virtual-cpu:
+      num-virtual-cpu: 1
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/hackfest_multivdu_vnf/icons/osm.png b/SOL004/hackfest_multivdu_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_multivdu_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_proxycharm_ns/hackfest_simplecharm_nsd.yaml b/SOL004/hackfest_proxycharm_ns/hackfest_simplecharm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f6dcb6ba305f18da4406d705a1b11b815467641a
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_ns/hackfest_simplecharm_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_proxycharm-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: hackfest_proxycharm-vnf
+    id: hackfest_proxycharm-ns
+    name: hackfest_proxycharm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - hackfest_proxycharm-vnf
diff --git a/SOL004/hackfest_proxycharm_ns/icons/osm.png b/SOL004/hackfest_proxycharm_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_proxycharm_ns/icons/osm.png differ
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/.build.manifest b/SOL004/hackfest_proxycharm_vnf/charms/simple/.build.manifest
new file mode 100644
index 0000000000000000000000000000000000000000..7a223f0e16cc2d8f86cdc5cc4c6a9195395f1854
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/.build.manifest
@@ -0,0 +1,356 @@
+{
+  "layers": [
+    {
+      "rev": "fcdcea4e5de3e1556c24e6704607862d0ba00a56",
+      "url": "layer:options"
+    },
+    {
+      "rev": "1e25cf7d63285f222207efb4b189f8c076b78b2d",
+      "url": "layer:basic"
+    },
+    {
+      "rev": "c1425086885b011da0d37a51e16c07998b656fe6",
+      "url": "layer:sshproxy"
+    },
+    {
+      "rev": "3301247d823a3fe266fb9e435e47d14a9da93779",
+      "url": "layer:vnfproxy"
+    },
+    {
+      "rev": "525d4cb2b5b1db8a56ff3cf3132e101d03dc93b5",
+      "url": "simple"
+    }
+  ],
+  "signatures": {
+    ".build.manifest": [
+      "build",
+      "dynamic",
+      "unchecked"
+    ],
+    ".gitignore": [
+      "layer:sshproxy",
+      "static",
+      "17526a7f7312e7eefb932d1c514b7bc8425fab5bd1ade149e106ecf8bff67358"
+    ],
+    "LICENSE": [
+      "layer:basic",
+      "static",
+      "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30"
+    ],
+    "Makefile": [
+      "layer:basic",
+      "static",
+      "b7ab3a34e5faf79b96a8632039a0ad0aa87f2a9b5f0ba604e007cafb22190301"
+    ],
+    "README.ex": [
+      "simple",
+      "static",
+      "eb25333fb6ee2abc2d5dde329dfd6b4b2a6dd5516094e75354fb6cd84010afad"
+    ],
+    "README.md": [
+      "layer:vnfproxy",
+      "static",
+      "84c9a4232bd1ff8672b5633d329349533dbb3d9c64b2f0ca13ffafd7a3add55b"
+    ],
+    "actions.yaml": [
+      "simple",
+      "dynamic",
+      "ac75f1585b99b536feb6edb0866a5575b8e6390b2cbd7b767b1c573dd83051bd"
+    ],
+    "actions/generate-ssh-key": [
+      "layer:sshproxy",
+      "static",
+      "46bf4be02078a0f5ac60ab81609372a8f9943885b7a4999ce5332ea2f4857036"
+    ],
+    "actions/get-ssh-public-key": [
+      "layer:sshproxy",
+      "static",
+      "46bf4be02078a0f5ac60ab81609372a8f9943885b7a4999ce5332ea2f4857036"
+    ],
+    "actions/reboot": [
+      "layer:vnfproxy",
+      "static",
+      "afc0df4409fb6eb7b7e6595490913c1efe329b393d4860ae226d8aaccc01fcf2"
+    ],
+    "actions/restart": [
+      "layer:vnfproxy",
+      "static",
+      "afc0df4409fb6eb7b7e6595490913c1efe329b393d4860ae226d8aaccc01fcf2"
+    ],
+    "actions/run": [
+      "layer:sshproxy",
+      "static",
+      "46bf4be02078a0f5ac60ab81609372a8f9943885b7a4999ce5332ea2f4857036"
+    ],
+    "actions/start": [
+      "layer:vnfproxy",
+      "static",
+      "afc0df4409fb6eb7b7e6595490913c1efe329b393d4860ae226d8aaccc01fcf2"
+    ],
+    "actions/stop": [
+      "layer:vnfproxy",
+      "static",
+      "afc0df4409fb6eb7b7e6595490913c1efe329b393d4860ae226d8aaccc01fcf2"
+    ],
+    "actions/touch": [
+      "simple",
+      "static",
+      "d88c053583ba9f9f11051bd8162b970e48850c62f5a489f07a631cf4a19da503"
+    ],
+    "actions/upgrade": [
+      "layer:vnfproxy",
+      "static",
+      "afc0df4409fb6eb7b7e6595490913c1efe329b393d4860ae226d8aaccc01fcf2"
+    ],
+    "actions/verify-ssh-credentials": [
+      "layer:sshproxy",
+      "static",
+      "46bf4be02078a0f5ac60ab81609372a8f9943885b7a4999ce5332ea2f4857036"
+    ],
+    "bin/charm-env": [
+      "layer:basic",
+      "static",
+      "75907c1ab3fe6d369c33ee776d32bcb4563948600f0fd4ca01d91193dc3eee50"
+    ],
+    "bin/layer_option": [
+      "layer:options",
+      "static",
+      "e959bf29da4c5edff28b2602c24113c4df9e25cdc9f2aa3b5d46c8577b2a40cc"
+    ],
+    "config.yaml": [
+      "simple",
+      "dynamic",
+      "38d42471f3d0fcaca02aa2f97566542437c7e58fb1b65551afb93598eba19d0d"
+    ],
+    "copyright": [
+      "layer:basic",
+      "static",
+      "f6740d66fd60b60f2533d9fcb53907078d1e20920a0219afce7182e2a1c97629"
+    ],
+    "copyright.layer-options": [
+      "layer:options",
+      "static",
+      "f6740d66fd60b60f2533d9fcb53907078d1e20920a0219afce7182e2a1c97629"
+    ],
+    "hooks/collect-metrics": [
+      "layer:vnfproxy",
+      "static",
+      "6b8e6016f80e401650b07301dc30cdc3d2928aa5f2532a8a92a55b906fa9ef19"
+    ],
+    "hooks/config-changed": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/hook.template": [
+      "layer:basic",
+      "static",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/install": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/leader-elected": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/leader-settings-changed": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/post-series-upgrade": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/pre-series-upgrade": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/start": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/stop": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/update-status": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "hooks/upgrade-charm": [
+      "layer:basic",
+      "dynamic",
+      "2b693cb2a11594a80cc91235c2dc219a0a6303ae62bee8aa87eb35781f7158f7"
+    ],
+    "icon.svg": [
+      "simple",
+      "static",
+      "085f367baa9c4ec724561b6e0d5d167c14c4295d6311b719a57729a17ac025c7"
+    ],
+    "layer.yaml": [
+      "simple",
+      "dynamic",
+      "05443235de5b2744bb5ee2e10663d1a091336c7d1b6390f6e08ac3f578f3947d"
+    ],
+    "lib/charms/layer/__init__.py": [
+      "layer:basic",
+      "static",
+      "dfe0d26c6bf409767de6e2546bc648f150e1b396243619bad3aa0553ab7e0e6f"
+    ],
+    "lib/charms/layer/basic.py": [
+      "layer:basic",
+      "static",
+      "c3a84ecabc893ebdb2178b08daad29596ea8a0dbf6508fd2e45fe4b182e29c1d"
+    ],
+    "lib/charms/layer/execd.py": [
+      "layer:basic",
+      "static",
+      "fda8bd491032db1db8ddaf4e99e7cc878c6fb5432efe1f91cadb5b34765d076d"
+    ],
+    "lib/charms/layer/options.py": [
+      "layer:options",
+      "static",
+      "8ae7a07d22542fc964f2d2bee8219d1c78a68dace70a1b38d36d4aea47b1c3b2"
+    ],
+    "lib/charms/sshproxy.py": [
+      "layer:sshproxy",
+      "static",
+      "d2060cbb756e094f44329bd0a404d47222af304aa75c508001ce0465a3c05974"
+    ],
+    "metadata.yaml": [
+      "simple",
+      "dynamic",
+      "3f2e76c52df7a5323284bf57fca6b4eb5c1fe9b9d89e2183a0552d8f85505e71"
+    ],
+    "reactive/__init__.py": [
+      "layer:basic",
+      "static",
+      "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
+    ],
+    "reactive/simple.py": [
+      "simple",
+      "static",
+      "babb568b4e161a96e4040be28cd18bd4075879382b22326f14d58f7919e89ab5"
+    ],
+    "reactive/sshproxy.py": [
+      "layer:sshproxy",
+      "static",
+      "2a47918df20f5d110b156bd9422ece72a6d54317e6167fef596c76c34bbe745f"
+    ],
+    "reactive/vnfproxy.py": [
+      "layer:vnfproxy",
+      "static",
+      "8e4101a72f02832e5c233b731981ff483675be608321b8eb9743d605b3f7d77a"
+    ],
+    "requirements.txt": [
+      "layer:basic",
+      "static",
+      "0f1c70d27e26005a96d66ad54482877ae20f7737693c833e29dd72bd6ac24892"
+    ],
+    "tests/00-setup": [
+      "simple",
+      "static",
+      "111c079b81d260bbcd716dcf41672372a4cf4aaa14154b6c3055deeedae37a06"
+    ],
+    "tests/10-deploy": [
+      "simple",
+      "static",
+      "3f06110a106f4c911fcf9f4d7a0299e648ead2a49046e78339e995d4e936962e"
+    ],
+    "tox.ini": [
+      "layer:basic",
+      "static",
+      "0350315801b7fc2bd38a1f43a7e31d40d5a3bcfe5f6c8dac2bdf293833bc6d21"
+    ],
+    "version": [
+      "simple",
+      "dynamic",
+      "6b3e4b3738acbb87f8a9a5d3e1276d7b34d9c1c1c416b6680fb02516cfb05438"
+    ],
+    "wheelhouse/Jinja2-2.10.1.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "065c4f02ebe7f7cf559e49ee5a95fb800a9e4528727aec6f24402a5374c65013"
+    ],
+    "wheelhouse/MarkupSafe-1.1.1.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "29872e92839765e546828bb7754a68c418d927cd064fd4708fab9fe9c8bb116b"
+    ],
+    "wheelhouse/PyYAML-5.1.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "436bc774ecf7c103814098159fbb84c2715d25980175292c648f2da143909f95"
+    ],
+    "wheelhouse/Tempita-0.5.2.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "cacecf0baa674d356641f1d406b8bff1d756d739c46b869a54de515d08e6fc9c"
+    ],
+    "wheelhouse/charmhelpers-0.19.13.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "aaaf472ceaf03bec041b7a22ce9f43314e43bb673354942ef70d6708bbcb875a"
+    ],
+    "wheelhouse/charms.reactive-1.2.1.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "011cc5141d2c1c488c1e54b8b3d56f91d48f72b7c3202f1027ab3d0666242503"
+    ],
+    "wheelhouse/ecdsa-0.13.2.tar.gz": [
+      "layer:sshproxy",
+      "dynamic",
+      "5c034ffa23413ac923541ceb3ac14ec15a0d2530690413bff58c12b80e56d884"
+    ],
+    "wheelhouse/netaddr-0.7.19.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "38aeec7cdd035081d3a4c306394b19d677623bf76fa0913f6695127c7753aefd"
+    ],
+    "wheelhouse/paramiko-1.16.3.tar.gz": [
+      "layer:sshproxy",
+      "dynamic",
+      "97d932fdb4fec9aadf6bea368123f3ee15b92199f92eb62666370c7fed62d072"
+    ],
+    "wheelhouse/pip-8.1.2.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "4d24b03ffa67638a3fa931c09fd9e0273ffa904e95ebebe7d4b1a54c93d7b732"
+    ],
+    "wheelhouse/pyaml-19.4.1.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "c79ae98ececda136a034115ca178ee8bf3aa7df236c488c2f55d12f177b88f1e"
+    ],
+    "wheelhouse/pycrypto-2.6.1.tar.gz": [
+      "layer:sshproxy",
+      "dynamic",
+      "f2ce1e989b272cfcb677616763e0a2e7ec659effa67a88aa92b3a65528f60a3c"
+    ],
+    "wheelhouse/setuptools-39.0.1.zip": [
+      "layer:basic",
+      "dynamic",
+      "bec7badf0f60e7fc8153fac47836edc41b74e5d541d7692e614e635720d6a7c7"
+    ],
+    "wheelhouse/setuptools_scm-1.17.0.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "70a4cf5584e966ae92f54a764e6437af992ba42ac4bca7eb37cc5d02b98ec40a"
+    ],
+    "wheelhouse/six-1.12.0.tar.gz": [
+      "layer:basic",
+      "dynamic",
+      "d16a0141ec1a18405cd4ce8b4613101da75da0e9a7aec5bdd4fa804d0e0eba73"
+    ]
+  }
+}
\ No newline at end of file
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/.gitignore b/SOL004/hackfest_proxycharm_vnf/charms/simple/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..b8e7ba3a229bda75224369127d7454019fea641f
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/.gitignore
@@ -0,0 +1 @@
+trusty/
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/LICENSE b/SOL004/hackfest_proxycharm_vnf/charms/simple/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/Makefile b/SOL004/hackfest_proxycharm_vnf/charms/simple/Makefile
new file mode 100644
index 0000000000000000000000000000000000000000..a1ad3a5cd27751144f6bd1a0a7db50f1e11b18eb
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/Makefile
@@ -0,0 +1,24 @@
+#!/usr/bin/make
+
+all: lint unit_test
+
+
+.PHONY: clean
+clean:
+	@rm -rf .tox
+
+.PHONY: apt_prereqs
+apt_prereqs:
+	@# Need tox, but don't install the apt version unless we have to (don't want to conflict with pip)
+	@which tox >/dev/null || (sudo apt-get install -y python-pip && sudo pip install tox)
+
+.PHONY: lint
+lint: apt_prereqs
+	@tox --notest
+	@PATH=.tox/py34/bin:.tox/py35/bin flake8 $(wildcard hooks reactive lib unit_tests tests)
+	@charm proof
+
+.PHONY: unit_test
+unit_test: apt_prereqs
+	@echo Starting tests...
+	tox
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/README.ex b/SOL004/hackfest_proxycharm_vnf/charms/simple/README.ex
new file mode 100644
index 0000000000000000000000000000000000000000..b6816b22ade2fa36326d7e1f612b6f6203768949
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/README.ex
@@ -0,0 +1,65 @@
+# Overview
+
+Describe the intended usage of this charm and anything unique about how this
+charm relates to others here.
+
+This README will be displayed in the Charm Store, it should be either Markdown
+or RST. Ideal READMEs include instructions on how to use the charm, expected
+usage, and charm features that your audience might be interested in. For an
+example of a well written README check out Hadoop:
+http://jujucharms.com/charms/precise/hadoop
+
+Use this as a Markdown reference if you need help with the formatting of this
+README: http://askubuntu.com/editing-help
+
+This charm provides [service][]. Add a description here of what the service
+itself actually does.
+
+Also remember to check the [icon guidelines][] so that your charm looks good
+in the Juju GUI.
+
+# Usage
+
+Step by step instructions on using the charm:
+
+juju deploy servicename
+
+and so on. If you're providing a web service or something that the end user
+needs to go to, tell them here, especially if you're deploying a service that
+might listen to a non-default port.
+
+You can then browse to http://ip-address to configure the service.
+
+## Scale out Usage
+
+If the charm has any recommendations for running at scale, outline them in
+examples here. For example if you have a memcached relation that improves
+performance, mention it here.
+
+## Known Limitations and Issues
+
+This not only helps users but gives people a place to start if they want to help
+you add features to your charm.
+
+# Configuration
+
+The configuration options will be listed on the charm store, however If you're
+making assumptions or opinionated decisions in the charm (like setting a default
+administrator password), you should detail that here so the user knows how to
+change it immediately, etc.
+
+# Contact Information
+
+Though this will be listed in the charm store itself don't assume a user will
+know that, so include that information here:
+
+## Upstream Project Name
+
+  - Upstream website
+  - Upstream bug tracker
+  - Upstream mailing list or contact information
+  - Feel free to add things if it's useful for users
+
+
+[service]: http://example.com
+[icon guidelines]: https://jujucharms.com/docs/stable/authors-charm-icon
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/README.md b/SOL004/hackfest_proxycharm_vnf/charms/simple/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..e4d801cfaf4fd723eea247e6a383c6333ca8e1a3
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/README.md
@@ -0,0 +1,267 @@
+# vnfproxy
+
+A [Juju](https://jujucharms.com/) charm layer. See [how it works](https://jujucharms.com/how-it-works) and the [Getting Started](https://jujucharms.com/docs/stable/developer-getting-started) page for more information about Juju and Charms.
+
+[OSM](https://osm.etsi.org/) is an [ETSI](http://www.etsi.org/)-hosted project to develop an Open Source NFV Management and Orchestration (MANO) software stack aligned with ETSI NFV.
+
+## Overview
+
+The vnfproxy [layer](https://jujucharms.com/docs/stable/developer-layers) is intended for use by vendors who wish to integrate a VNF with OSM. The current release of OSM only supports a lightweight version of Juju charms, which we refer to as VNF Configuration or "proxy" charms.
+
+This document will describe the steps necessary to create a charm for your VNF.
+
+First, consider the diagram below:
+
+```
++---------------------+    +---------------------+
+|                     <----+                     |
+|  Resource           |    |  Service            |
+|  Orchestrator (RO)  +---->  Orchestrator (SO)  |
+|                     |    |                     |
++------------------+--+    +-------+----^--------+
+                   |               |    |
+                   |               |    |
+                   |               |    |
+             +-----v-----+       +-v----+--+
+             |           <-------+         |
+             |  Virtual  |       |  Proxy  |
+             |  Machine  |       |  Charm  |
+             |           +------->         |
+             +-----------+       +---------+
+```
+
+The Virtual Machine (VM) is created by the Resource Orchestrator (RO), at the
+request of the Service Orchestrator (SO). Once the VM has been created, a
+"proxy charm" is deployed in order to facilitate operations between the SO and
+your service running within the VM.
+
+As such, a proxy charm will expose a number of actions -- also known as service primitives -- that are run by the SO. By default, the following actions are exposed:
+
+```bash
+actions
+├── reboot
+├── restart
+├── run
+├── start
+├── stop
+└── upgrade
+```
+
+Some actions, such as `run` and `reboot`, do not require any additional configuration. The rest, however, require you to implement the command(s) required to interact with your VNF.
+
+A charm is composed of multiple layers of code. The layer you create for your VNF is the topmost layer. It will include the basic layer, which provides the framework for building reactive charms, and the vnfproxy layer, which adds functionality specific to operating and configuring VNFs. Finally, these layers are combined to form the charm you'll place inside your VNF Descriptor Package.
+
+## Step 1: Create the layer for your proxy charm:
+
+Create a new charm layer, substituting "myvnf" with the name of your VNF.
+
+```bash
+$ charm create myvnf
+$ cd myvnf
+```
+
+Modify `layer.yaml` to the following:
+```yaml
+includes:
+    - layer:basic
+    - layer:vnfproxy
+```
+
+The `metadata.yaml` describes your service. It should look similar to the following:
+
+```yaml
+name: myvnf
+summary: My VNF provides a specific virtualized network function.
+maintainer: Adam Israel <adam.israel@canonical.com>
+description: |
+  A longer description of your VNF and what it provides to users.
+series:
+  - trusty
+  - xenial
+tags:
+  - osm
+  - vnf
+subordinate: false
+```
+
+### Actions (Service Primitives)
+
+In Juju, Service Primitives are referred to as Actions. These are commands that will be executed on the VNF on request of the Service Orchestrator.
+
+#### Defining Actions
+
+Actions are defined through a yaml file called `actions.yaml` in the root directory of your charm. This file describes the action and the parameters it requires in order to execute.
+
+```yaml
+configure-server:
+    description: "Configure a thing"
+    params:
+      polling-interval:
+        type: int
+        description: "The interval, in seconds, to poll a thing."
+        default: 30
+
+```
+#### Implementing your Actions
+
+We use executable files in the charm's `actions/` directory to invoke a reactive handler for your VNF logic. Each file should have the same name as the action you defined in `actions.yaml`.
+
+Cut and paste the following into `actions/configure-server` and `chmod +x actions/configure-server`:
+
+```bash
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main
+from charms.reactive import set_state
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_state('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
+```
+
+Next, we'll add the code that will be executed inside your VNF via the ssh credentials. Open `reactive/myvnf.py` and add the following reactive handler code:
+
+```python
+# Change configure-server to match the name of the action you want to execute.
+@when('actions.configure-server')
+def configure_server():
+    err = ''
+    try:
+        # Put the code here that you want to execute
+        cmd = ""
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'output': result})
+    finally:
+        remove_flag('actions.start')
+
+```
+
+#### Default Actions (Service Primitives)
+
+The vnfproxy layer defines several default actions that you may implement. If you choose not to implement these, the actions will do nothing.
+
+Add the following code to `reactive/myvnf.py` and fill in the `cmd` variable with the command to be run on your VNF:
+
+```python
+@when('actions.start')
+def start():
+    err = ''
+    try:
+        # Put the code here that you want to execute
+        cmd = ""
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'output': result})
+    finally:
+        remove_flag('actions.start')
+
+
+@when('actions.stop')
+def stop():
+    err = ''
+    try:
+        # Enter the command to stop your service(s)
+        cmd = "service myname stop"
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'output': result})
+    finally:
+        remove_flag('actions.stop')
+
+
+@when('actions.restart')
+def restart():
+    err = ''
+    try:
+        # Enter the command to restart your service(s)
+        cmd = "service myname restart"
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'output': result})
+    finally:
+        remove_flag('actions.restart')
+
+  @when('actions.upgrade')
+  def upgrade_vnf():
+    """Upgrade the software on the VNF.
+
+    This action is intended to be used to perform software upgrades on a running VNF.
+    """
+      err = ''
+      try:
+          # Enter the command (s) to upgrade your VNF software
+          cmd = ""
+          result, err = charms.sshproxy._run(cmd)
+      except:
+          action_fail('command failed:' + err)
+      else:
+          action_set({'output': result})
+      finally:
+          remove_flag('actions.upgrade')        
+```
+
+Rename `README.ex` to `README.md` and describe your application and its usage.
+
+### Configuration
+
+Charms support immutable configuration, defined by the `config.yaml` file. In the case of OSM, it's configuration is primarily driven through service primitives. Feel free to delete `config.yaml`.
+
+### Metrics
+
+Juju supports the polling of metrics. To do this, create the `metrics.yaml` file in the root directory of your charm, following the example below. The command specified will be executed inside your VNF; it should return a positive decimal number. The collected metrics will be made available to OSM, beginning with Release 3.
+
+```yaml
+metrics:
+    uptime:
+        type: gauge
+        description: "Seconds since the machine was rebooted."
+        command: awk '{print $1}' /proc/uptime
+
+```
+
+### Building your VNF charm
+
+Once you've implemented your actions, you need to compile the various charm layers. From the charm's root directory:
+```bash
+$ charm build
+```
+
+This will combine all of the layers required by your VNF layer into a single charm, in the builds/ directory.
+
+### VNF Descriptor Package
+Copy the combined charm into the `charm` directory of your [VNF package]:
+
+```
+├── charm
+│   └── myvnf
+├── cloud_init
+│   └── myvnf_cloud_init.cfg
+├── icons
+│   └── myvnf_logo.png
+└── myvnf_vnfd.yaml
+```
+
+## Contact
+
+Send an email to the OSM_TECH@list.etsi.org mailing list.
+
+[VNF package]: https://osm.etsi.org/wikipub/index.php/Creating_your_own_VNF_package_(Release_TWO)
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions.yaml b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..14f8b3f33ffd908d03b3e8263edfcb10b7c317b3
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions.yaml
@@ -0,0 +1,53 @@
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+"run":
+  "description": "Run an arbitrary command"
+  "params":
+    "command":
+      "description": "The command to execute."
+      "type": "string"
+      "default": ""
+  "required":
+  - "command"
+"generate-ssh-key":
+  "description": "Generate a new SSH keypair for this unit. This will replace any\
+    \ existing previously generated keypair."
+"verify-ssh-credentials":
+  "description": "Verify that this unit can authenticate with server specified by\
+    \ ssh-hostname and ssh-username."
+"get-ssh-public-key":
+  "description": "Get the public SSH key for this unit."
+"start":
+  "description": "Stop the service on the VNF."
+"stop":
+  "description": "Stop the service on the VNF."
+"restart":
+  "description": "Stop the service on the VNF."
+"reboot":
+  "description": "Reboot the VNF virtual machine."
+"upgrade":
+  "description": "Upgrade the software on the VNF."
+"touch":
+  "description": "Touch a file on the VNF."
+  "params":
+    "filename":
+      "description": "The name of the file to touch."
+      "type": "string"
+      "default": ""
+  "required":
+  - "filename"
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/generate-ssh-key b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/generate-ssh-key
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/generate-ssh-key
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/get-ssh-public-key b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/get-ssh-public-key
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/get-ssh-public-key
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/reboot b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/reboot
new file mode 100755
index 0000000000000000000000000000000000000000..9a2ba24b9efdfa3d21457469c503c050196fb170
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/reboot
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/restart b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/restart
new file mode 100755
index 0000000000000000000000000000000000000000..9a2ba24b9efdfa3d21457469c503c050196fb170
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/restart
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/run b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/run
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/run
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/start b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/start
new file mode 100755
index 0000000000000000000000000000000000000000..9a2ba24b9efdfa3d21457469c503c050196fb170
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/start
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/stop b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/stop
new file mode 100755
index 0000000000000000000000000000000000000000..9a2ba24b9efdfa3d21457469c503c050196fb170
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/stop
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/touch b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/touch
new file mode 100755
index 0000000000000000000000000000000000000000..d85d3facc597b486ac5b5cfa26ee9d74089c90cb
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/touch
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main
+from charms.reactive import set_state
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_state('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/upgrade b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/upgrade
new file mode 100755
index 0000000000000000000000000000000000000000..9a2ba24b9efdfa3d21457469c503c050196fb170
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/upgrade
@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+import sys
+sys.path.append('lib')
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/verify-ssh-credentials b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/verify-ssh-credentials
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/actions/verify-ssh-credentials
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/charm-env b/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/charm-env
new file mode 100755
index 0000000000000000000000000000000000000000..c2adc7fbff30d0e062603cc13a1ae30ad05a092b
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/charm-env
@@ -0,0 +1,98 @@
+#!/bin/bash
+
+find_charm_dirs() {
+    # Hopefully, $JUJU_CHARM_DIR is set so which venv to use in unambiguous.
+    if [[ -n "$JUJU_CHARM_DIR" || -n "$CHARM_DIR" ]]; then
+        if [[ -z "$JUJU_CHARM_DIR" ]]; then
+            # accept $CHARM_DIR to be more forgiving
+            export JUJU_CHARM_DIR="$CHARM_DIR"
+        fi
+        if [[ -z "$CHARM_DIR" ]]; then
+            # set CHARM_DIR as well to help with backwards compatibility
+            export CHARM_DIR="$JUJU_CHARM_DIR"
+        fi
+        return
+    fi
+    # Try to guess the value for JUJU_CHARM_DIR by looking for a non-subordinate
+    # (because there's got to be at least one principle) charm directory;
+    # if there are several, pick the first by alpha order.
+    agents_dir="/var/lib/juju/agents"
+    if [[ -d "$agents_dir" ]]; then
+        desired_charm="$1"
+        found_charm_dir=""
+        if [[ -n "$desired_charm" ]]; then
+            for charm_dir in $(/bin/ls -d "$agents_dir"/unit-*/charm); do
+                charm_name="$(JUJU_CHARM_DIR="$charm_dir" charm-env python3 -c 'from charmhelpers.core.hookenv import charm_name; print(charm_name())')"
+                if [[ "$charm_name" == "$desired_charm" ]]; then
+                    if [[ -n "$found_charm_dir" ]]; then
+                        >&2 echo "Ambiguous possibilities for JUJU_CHARM_DIR matching '$desired_charm'; please run within a Juju hook context"
+                        exit 1
+                    fi
+                    found_charm_dir="$charm_dir"
+                fi
+            done
+            if [[ -z "$found_charm_dir" ]]; then
+                >&2 echo "Unable to determine JUJU_CHARM_DIR matching '$desired_charm'; please run within a Juju hook context"
+                exit 1
+            fi
+            export JUJU_CHARM_DIR="$found_charm_dir"
+            export CHARM_DIR="$found_charm_dir"
+            return
+        fi
+        # shellcheck disable=SC2126
+        non_subordinates="$(grep -L 'subordinate:.*true' "$agents_dir"/unit-*/charm/metadata.yaml | wc -l)"
+        if [[ "$non_subordinates" -gt 1 ]]; then
+            >&2 echo 'Ambiguous possibilities for JUJU_CHARM_DIR; please use --charm or run within a Juju hook context'
+            exit 1
+        elif [[ "$non_subordinates" -eq 1 ]]; then
+            for charm_dir in $(/bin/ls -d "$agents_dir"/unit-*/charm); do
+                if grep -q 'subordinate:.*true' "$charm_dir/metadata.yaml"; then
+                    continue
+                fi
+                export JUJU_CHARM_DIR="$charm_dir"
+                export CHARM_DIR="$charm_dir"
+                return
+            done
+        fi
+    fi
+    >&2 echo 'Unable to determine JUJU_CHARM_DIR; please run within a Juju hook context'
+    exit 1
+}
+
+try_activate_venv() {
+    if [[ -d "$JUJU_CHARM_DIR/../.venv" ]]; then
+        . "$JUJU_CHARM_DIR/../.venv/bin/activate"
+    fi
+}
+
+find_wrapped() {
+    PATH="${PATH/\/usr\/local\/sbin:}" which "$(basename "$0")"
+}
+
+
+# allow --charm option to hint which JUJU_CHARM_DIR to choose when ambiguous
+# NB: --charm option must come first
+# NB: option must be processed outside find_charm_dirs to modify $@
+charm_name=""
+if [[ "$1" == "--charm" ]]; then
+    charm_name="$2"
+    shift; shift
+fi
+
+find_charm_dirs "$charm_name"
+try_activate_venv
+export PYTHONPATH="$JUJU_CHARM_DIR/lib:$PYTHONPATH"
+
+if [[ "$(basename "$0")" == "charm-env" ]]; then
+    # being used as a shebang
+    exec "$@"
+elif [[ "$0" == "$BASH_SOURCE" ]]; then
+    # being invoked as a symlink wrapping something to find in the venv
+    exec "$(find_wrapped)" "$@"
+elif [[ "$(basename "$BASH_SOURCE")" == "charm-env" ]]; then
+    # being sourced directly; do nothing
+    /bin/true
+else
+    # being sourced for wrapped bash helpers
+    . "$(find_wrapped)"
+fi
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/layer_option b/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/layer_option
new file mode 100755
index 0000000000000000000000000000000000000000..3253ef8aadb95807f26e5ebd8486adde67e5cbc2
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/bin/layer_option
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+import sys
+import argparse
+from charms import layer
+
+
+parser = argparse.ArgumentParser(description='Access layer options.')
+parser.add_argument('section',
+                    help='the section, or layer, the option is from')
+parser.add_argument('option',
+                    help='the option to access')
+
+args = parser.parse_args()
+value = layer.options.get(args.section, args.option)
+if isinstance(value, bool):
+    sys.exit(0 if value else 1)
+elif isinstance(value, list):
+    for val in value:
+        print(val)
+else:
+    print(value)
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/config.yaml b/SOL004/hackfest_proxycharm_vnf/charms/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e6e8edde939969f15948c60661da9ed8da2f0f05
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/config.yaml
@@ -0,0 +1,41 @@
+"options":
+  "ssh-hostname":
+    "type": "string"
+    "default": ""
+    "description": "The hostname or IP address of the machine to"
+  "ssh-username":
+    "type": "string"
+    "default": ""
+    "description": "The username to login as."
+  "ssh-password":
+    "type": "string"
+    "default": ""
+    "description": "The password used to authenticate."
+  "ssh-private-key":
+    "type": "string"
+    "default": ""
+    "description": "DEPRECATED. The private ssh key to be used to authenticate."
+  "ssh-public-key":
+    "type": "string"
+    "default": ""
+    "description": "The public key of this unit."
+  "ssh-key-type":
+    "type": "string"
+    "default": "rsa"
+    "description": "The type of encryption to use for the SSH key."
+  "ssh-key-bits":
+    "type": "int"
+    "default": !!int "4096"
+    "description": "The number of bits to use for the SSH key."
+  "string-option":
+    "type": "string"
+    "default": "Default Value"
+    "description": "A short description of the configuration option"
+  "boolean-option":
+    "type": "boolean"
+    "default": !!bool "false"
+    "description": "A short description of the configuration option"
+  "int-option":
+    "type": "int"
+    "default": !!int "9001"
+    "description": "A short description of the configuration option"
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright b/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright
new file mode 100644
index 0000000000000000000000000000000000000000..d4fdd18281c632d030a301d26d45b4dabdb308ef
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright
@@ -0,0 +1,16 @@
+Format: http://dep.debian.net/deps/dep5/
+
+Files: *
+Copyright: Copyright 2015-2017, Canonical Ltd., All Rights Reserved.
+License: Apache License 2.0
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+ .
+     http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright.layer-options b/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright.layer-options
new file mode 100644
index 0000000000000000000000000000000000000000..d4fdd18281c632d030a301d26d45b4dabdb308ef
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/copyright.layer-options
@@ -0,0 +1,16 @@
+Format: http://dep.debian.net/deps/dep5/
+
+Files: *
+Copyright: Copyright 2015-2017, Canonical Ltd., All Rights Reserved.
+License: Apache License 2.0
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+ .
+     http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/collect-metrics b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/collect-metrics
new file mode 100755
index 0000000000000000000000000000000000000000..ed69a2e98c7606eac29ddc80ad02e04fb2a6addb
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/collect-metrics
@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+"""Handle the collect-metrics hook via proxy.
+
+The normal metrics layer will only execute metrics collection against the local
+machine. This hook implements the same approach, but runs the collection code
+against the configured ssh proxy.
+
+Because the metrics hook runs in a restricted context, it can't be run as a
+normal reactive event, nor can it access things like config.
+"""
+
+import os
+import shlex
+from subprocess import check_call, CalledProcessError
+import sys
+import yaml
+
+# Load modules from $CHARM_DIR/lib
+sys.path.append('lib')
+import charms.sshproxy
+
+
+def build_command(doc):
+    """Build the commands to report metrics.
+
+    Build a list of `add-metric` commands to report the current metrics
+    back to the Juju controller.
+    """
+    values = {}
+    metrics = doc.get("metrics", {})
+    for metric, mdoc in metrics.items():
+        cmd = mdoc.get("command")
+        if cmd:
+            try:
+                value, err = charms.sshproxy._run(
+                    # The command may contain quotes that need to be preserved,
+                    # i.e., `awk '{print $1}' /proc/uptime`
+                    shlex.split(cmd, posix=False)
+                )
+            except Exception as e:
+                # Ignore all errors
+                with open("metrics.log", "a") as f:
+                    f.write("{}".format(e))
+                continue
+
+            value = value.strip()
+            if value:
+                values[metric] = value
+
+    if not values:
+        return None
+    command = ["add-metric"]
+    for metric, value in values.items():
+        command.append("%s=%s" % (metric, value))
+    return command
+
+
+if __name__ == '__main__':
+    charm_dir = os.path.dirname(os.path.abspath(os.path.join(__file__, "..")))
+    metrics_yaml = os.path.join(charm_dir, "metrics.yaml")
+    with open(metrics_yaml) as f:
+        doc = yaml.load(f)
+        command = build_command(doc)
+        if command:
+            check_call(command)
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/config-changed b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/config-changed
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/config-changed
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/hook.template b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/hook.template
new file mode 100644
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/hook.template
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/install b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/install
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/install
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-elected b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-elected
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-elected
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-settings-changed b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-settings-changed
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/leader-settings-changed
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/post-series-upgrade b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/post-series-upgrade
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/post-series-upgrade
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/pre-series-upgrade b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/pre-series-upgrade
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/pre-series-upgrade
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/start b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/start
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/start
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/stop b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/stop
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/stop
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/update-status b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/update-status
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/update-status
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/upgrade-charm b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/upgrade-charm
new file mode 100755
index 0000000000000000000000000000000000000000..9858c6be15b8a682778ab4727835151e1b693801
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/hooks/upgrade-charm
@@ -0,0 +1,22 @@
+#!/usr/bin/env python3
+
+# Load modules from $JUJU_CHARM_DIR/lib
+import sys
+sys.path.append('lib')
+
+from charms.layer import basic  # noqa
+basic.bootstrap_charm_deps()
+
+from charmhelpers.core import hookenv  # noqa
+hookenv.atstart(basic.init_config_states)
+hookenv.atexit(basic.clear_config_states)
+
+
+# This will load and run the appropriate @hook and other decorated
+# handlers from $JUJU_CHARM_DIR/reactive, $JUJU_CHARM_DIR/hooks/reactive,
+# and $JUJU_CHARM_DIR/hooks/relations.
+#
+# See https://jujucharms.com/docs/stable/authors-charm-building
+# for more information on this pattern.
+from charms.reactive import main  # noqa
+main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/icon.svg b/SOL004/hackfest_proxycharm_vnf/charms/simple/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..e092eef75dc91ec1c1d85ddfcc3ca157a9c02a27
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/layer.yaml b/SOL004/hackfest_proxycharm_vnf/charms/simple/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c851bc323d21f497e85c52ff0dc74f792c6df2b3
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/layer.yaml
@@ -0,0 +1,15 @@
+"includes":
+- "layer:options"
+- "layer:basic"
+- "layer:sshproxy"
+- "layer:vnfproxy"
+"options":
+  "basic":
+    "use_venv": !!bool "false"
+    "packages": []
+    "python_packages": []
+    "include_system_packages": !!bool "true"
+  "simple": {}
+  "sshproxy": {}
+  "vnfproxy": {}
+"is": "simple"
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/__init__.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..a8e0c640642f44cac85df60f3d9b7f73b0bb18bb
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/__init__.py
@@ -0,0 +1,60 @@
+import sys
+from importlib import import_module
+from pathlib import Path
+
+
+def import_layer_libs():
+    """
+    Ensure that all layer libraries are imported.
+
+    This makes it possible to do the following:
+
+        from charms import layer
+
+        layer.foo.do_foo_thing()
+
+    Note: This function must be called after bootstrap.
+    """
+    for module_file in Path('lib/charms/layer').glob('*'):
+        module_name = module_file.stem
+        if module_name in ('__init__', 'basic', 'execd') or not (
+            module_file.suffix == '.py' or module_file.is_dir()
+        ):
+            continue
+        import_module('charms.layer.{}'.format(module_name))
+
+
+# Terrible hack to support the old terrible interface.
+# Try to get people to call layer.options.get() instead so
+# that we can remove this garbage.
+# Cribbed from https://stackoverfLow.com/a/48100440/4941864
+class OptionsBackwardsCompatibilityHack(sys.modules[__name__].__class__):
+    def __call__(self, section=None, layer_file=None):
+        if layer_file is None:
+            return self.get(section=section)
+        else:
+            return self.get(section=section,
+                            layer_file=Path(layer_file))
+
+
+def patch_options_interface():
+    from charms.layer import options
+    if sys.version_info.minor >= 5:
+        options.__class__ = OptionsBackwardsCompatibilityHack
+    else:
+        # Py 3.4 doesn't support changing the __class__, so we have to do it
+        # another way.  The last line is needed because we already have a
+        # reference that doesn't get updated with sys.modules.
+        name = options.__name__
+        hack = OptionsBackwardsCompatibilityHack(name)
+        hack.get = options.get
+        sys.modules[name] = hack
+        sys.modules[__name__].options = hack
+
+
+try:
+    patch_options_interface()
+except ImportError:
+    # This may fail if pyyaml hasn't been installed yet. But in that
+    # case, the bootstrap logic will try it again once it has.
+    pass
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/basic.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/basic.py
new file mode 100644
index 0000000000000000000000000000000000000000..1a6ea9fc620de16c0eb13113158aacc241317aab
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/basic.py
@@ -0,0 +1,259 @@
+import os
+import sys
+import shutil
+from glob import glob
+from subprocess import check_call, CalledProcessError
+from time import sleep
+
+from charms import layer
+from charms.layer.execd import execd_preinstall
+
+
+def lsb_release():
+    """Return /etc/lsb-release in a dict"""
+    d = {}
+    with open('/etc/lsb-release', 'r') as lsb:
+        for l in lsb:
+            k, v = l.split('=')
+            d[k.strip()] = v.strip()
+    return d
+
+
+def bootstrap_charm_deps():
+    """
+    Set up the base charm dependencies so that the reactive system can run.
+    """
+    # execd must happen first, before any attempt to install packages or
+    # access the network, because sites use this hook to do bespoke
+    # configuration and install secrets so the rest of this bootstrap
+    # and the charm itself can actually succeed. This call does nothing
+    # unless the operator has created and populated $JUJU_CHARM_DIR/exec.d.
+    execd_preinstall()
+    # ensure that $JUJU_CHARM_DIR/bin is on the path, for helper scripts
+    charm_dir = os.environ['JUJU_CHARM_DIR']
+    os.environ['PATH'] += ':%s' % os.path.join(charm_dir, 'bin')
+    venv = os.path.abspath('../.venv')
+    vbin = os.path.join(venv, 'bin')
+    vpip = os.path.join(vbin, 'pip')
+    vpy = os.path.join(vbin, 'python')
+    hook_name = os.path.basename(sys.argv[0])
+    is_bootstrapped = os.path.exists('wheelhouse/.bootstrapped')
+    is_charm_upgrade = hook_name == 'upgrade-charm'
+    is_series_upgrade = hook_name == 'post-series-upgrade'
+    post_upgrade = os.path.exists('wheelhouse/.upgrade')
+    is_upgrade = not post_upgrade and (is_charm_upgrade or is_series_upgrade)
+    if is_bootstrapped and not is_upgrade:
+        activate_venv()
+        # the .upgrade file prevents us from getting stuck in a loop
+        # when re-execing to activate the venv; at this point, we've
+        # activated the venv, so it's safe to clear it
+        if post_upgrade:
+            os.unlink('wheelhouse/.upgrade')
+        return
+    if is_series_upgrade and os.path.exists(venv):
+        # series upgrade should do a full clear of the venv, rather than just
+        # updating it, to bring in updates to Python itself
+        shutil.rmtree(venv)
+    if is_upgrade:
+        if os.path.exists('wheelhouse/.bootstrapped'):
+            os.unlink('wheelhouse/.bootstrapped')
+        open('wheelhouse/.upgrade', 'w').close()
+    # bootstrap wheelhouse
+    if os.path.exists('wheelhouse'):
+        with open('/root/.pydistutils.cfg', 'w') as fp:
+            # make sure that easy_install also only uses the wheelhouse
+            # (see https://github.com/pypa/pip/issues/410)
+            fp.writelines([
+                "[easy_install]\n",
+                "allow_hosts = ''\n",
+                "find_links = file://{}/wheelhouse/\n".format(charm_dir),
+            ])
+        apt_install([
+            'python3-pip',
+            'python3-setuptools',
+            'python3-yaml',
+            'python3-dev',
+            'python3-wheel',
+            'build-essential',
+        ])
+        from charms.layer import options
+        cfg = options.get('basic')
+        # include packages defined in layer.yaml
+        apt_install(cfg.get('packages', []))
+        # if we're using a venv, set it up
+        if cfg.get('use_venv'):
+            if not os.path.exists(venv):
+                series = lsb_release()['DISTRIB_CODENAME']
+                if series in ('precise', 'trusty'):
+                    apt_install(['python-virtualenv'])
+                else:
+                    apt_install(['virtualenv'])
+                cmd = ['virtualenv', '-ppython3', '--never-download', venv]
+                if cfg.get('include_system_packages'):
+                    cmd.append('--system-site-packages')
+                check_call(cmd)
+            os.environ['PATH'] = ':'.join([vbin, os.environ['PATH']])
+            pip = vpip
+        else:
+            pip = 'pip3'
+            # save a copy of system pip to prevent `pip3 install -U pip`
+            # from changing it
+            if os.path.exists('/usr/bin/pip'):
+                shutil.copy2('/usr/bin/pip', '/usr/bin/pip.save')
+        # need newer pip, to fix spurious Double Requirement error:
+        # https://github.com/pypa/pip/issues/56
+        check_call([pip, 'install', '-U', '--no-index', '-f', 'wheelhouse',
+                    'pip'])
+        # per https://github.com/juju-solutions/layer-basic/issues/110
+        # this replaces the setuptools that was copied over from the system on
+        # venv create with latest setuptools and adds setuptools_scm
+        check_call([pip, 'install', '-U', '--no-index', '-f', 'wheelhouse',
+                    'setuptools', 'setuptools-scm'])
+        # install the rest of the wheelhouse deps
+        check_call([pip, 'install', '-U', '--no-index', '-f', 'wheelhouse'] +
+                   glob('wheelhouse/*'))
+        # re-enable installation from pypi
+        os.remove('/root/.pydistutils.cfg')
+        # install python packages from layer options
+        if cfg.get('python_packages'):
+            check_call([pip, 'install', '-U'] + cfg.get('python_packages'))
+        if not cfg.get('use_venv'):
+            # restore system pip to prevent `pip3 install -U pip`
+            # from changing it
+            if os.path.exists('/usr/bin/pip.save'):
+                shutil.copy2('/usr/bin/pip.save', '/usr/bin/pip')
+                os.remove('/usr/bin/pip.save')
+        # setup wrappers to ensure envs are used for scripts
+        shutil.copy2('bin/charm-env', '/usr/local/sbin/')
+        for wrapper in ('charms.reactive', 'charms.reactive.sh',
+                        'chlp', 'layer_option'):
+            src = os.path.join('/usr/local/sbin', 'charm-env')
+            dst = os.path.join('/usr/local/sbin', wrapper)
+            if not os.path.exists(dst):
+                os.symlink(src, dst)
+        if cfg.get('use_venv'):
+            shutil.copy2('bin/layer_option', vbin)
+        else:
+            shutil.copy2('bin/layer_option', '/usr/local/bin/')
+        # re-link the charm copy to the wrapper in case charms
+        # call bin/layer_option directly (as was the old pattern)
+        os.remove('bin/layer_option')
+        os.symlink('/usr/local/sbin/layer_option', 'bin/layer_option')
+        # flag us as having already bootstrapped so we don't do it again
+        open('wheelhouse/.bootstrapped', 'w').close()
+        # Ensure that the newly bootstrapped libs are available.
+        # Note: this only seems to be an issue with namespace packages.
+        # Non-namespace-package libs (e.g., charmhelpers) are available
+        # without having to reload the interpreter. :/
+        reload_interpreter(vpy if cfg.get('use_venv') else sys.argv[0])
+
+
+def activate_venv():
+    """
+    Activate the venv if enabled in ``layer.yaml``.
+
+    This is handled automatically for normal hooks, but actions might
+    need to invoke this manually, using something like:
+
+        # Load modules from $JUJU_CHARM_DIR/lib
+        import sys
+        sys.path.append('lib')
+
+        from charms.layer.basic import activate_venv
+        activate_venv()
+
+    This will ensure that modules installed in the charm's
+    virtual environment are available to the action.
+    """
+    from charms.layer import options
+    venv = os.path.abspath('../.venv')
+    vbin = os.path.join(venv, 'bin')
+    vpy = os.path.join(vbin, 'python')
+    use_venv = options.get('basic', 'use_venv')
+    if use_venv and '.venv' not in sys.executable:
+        # activate the venv
+        os.environ['PATH'] = ':'.join([vbin, os.environ['PATH']])
+        reload_interpreter(vpy)
+    layer.patch_options_interface()
+    layer.import_layer_libs()
+
+
+def reload_interpreter(python):
+    """
+    Reload the python interpreter to ensure that all deps are available.
+
+    Newly installed modules in namespace packages sometimes seemt to
+    not be picked up by Python 3.
+    """
+    os.execve(python, [python] + list(sys.argv), os.environ)
+
+
+def apt_install(packages):
+    """
+    Install apt packages.
+
+    This ensures a consistent set of options that are often missed but
+    should really be set.
+    """
+    if isinstance(packages, (str, bytes)):
+        packages = [packages]
+
+    env = os.environ.copy()
+
+    if 'DEBIAN_FRONTEND' not in env:
+        env['DEBIAN_FRONTEND'] = 'noninteractive'
+
+    cmd = ['apt-get',
+           '--option=Dpkg::Options::=--force-confold',
+           '--assume-yes',
+           'install']
+    for attempt in range(3):
+        try:
+            check_call(cmd + packages, env=env)
+        except CalledProcessError:
+            if attempt == 2:  # third attempt
+                raise
+            try:
+                # sometimes apt-get update needs to be run
+                check_call(['apt-get', 'update'])
+            except CalledProcessError:
+                # sometimes it's a dpkg lock issue
+                pass
+            sleep(5)
+        else:
+            break
+
+
+def init_config_states():
+    import yaml
+    from charmhelpers.core import hookenv
+    from charms.reactive import set_state
+    from charms.reactive import toggle_state
+    config = hookenv.config()
+    config_defaults = {}
+    config_defs = {}
+    config_yaml = os.path.join(hookenv.charm_dir(), 'config.yaml')
+    if os.path.exists(config_yaml):
+        with open(config_yaml) as fp:
+            config_defs = yaml.safe_load(fp).get('options', {})
+            config_defaults = {key: value.get('default')
+                               for key, value in config_defs.items()}
+    for opt in config_defs.keys():
+        if config.changed(opt):
+            set_state('config.changed')
+            set_state('config.changed.{}'.format(opt))
+        toggle_state('config.set.{}'.format(opt), config.get(opt))
+        toggle_state('config.default.{}'.format(opt),
+                     config.get(opt) == config_defaults[opt])
+
+
+def clear_config_states():
+    from charmhelpers.core import hookenv, unitdata
+    from charms.reactive import remove_state
+    config = hookenv.config()
+    remove_state('config.changed')
+    for opt in config.keys():
+        remove_state('config.changed.{}'.format(opt))
+        remove_state('config.set.{}'.format(opt))
+        remove_state('config.default.{}'.format(opt))
+    unitdata.kv().flush()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/execd.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/execd.py
new file mode 100644
index 0000000000000000000000000000000000000000..438d9a1bc90042fd8b20517d5ecf358dfbf08afc
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/execd.py
@@ -0,0 +1,114 @@
+# Copyright 2014-2016 Canonical Limited.
+#
+# This file is part of layer-basic, the reactive base layer for Juju.
+#
+# charm-helpers is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# charm-helpers is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with charm-helpers.  If not, see <http://www.gnu.org/licenses/>.
+
+# This module may only import from the Python standard library.
+import os
+import sys
+import subprocess
+import time
+
+'''
+execd/preinstall
+
+Read the layer-basic docs for more info on how to use this feature.
+https://charmsreactive.readthedocs.io/en/latest/layer-basic.html#exec-d-support
+'''
+
+
+def default_execd_dir():
+    return os.path.join(os.environ['JUJU_CHARM_DIR'], 'exec.d')
+
+
+def execd_module_paths(execd_dir=None):
+    """Generate a list of full paths to modules within execd_dir."""
+    if not execd_dir:
+        execd_dir = default_execd_dir()
+
+    if not os.path.exists(execd_dir):
+        return
+
+    for subpath in os.listdir(execd_dir):
+        module = os.path.join(execd_dir, subpath)
+        if os.path.isdir(module):
+            yield module
+
+
+def execd_submodule_paths(command, execd_dir=None):
+    """Generate a list of full paths to the specified command within exec_dir.
+    """
+    for module_path in execd_module_paths(execd_dir):
+        path = os.path.join(module_path, command)
+        if os.access(path, os.X_OK) and os.path.isfile(path):
+            yield path
+
+
+def execd_sentinel_path(submodule_path):
+    module_path = os.path.dirname(submodule_path)
+    execd_path = os.path.dirname(module_path)
+    module_name = os.path.basename(module_path)
+    submodule_name = os.path.basename(submodule_path)
+    return os.path.join(execd_path,
+                        '.{}_{}.done'.format(module_name, submodule_name))
+
+
+def execd_run(command, execd_dir=None, stop_on_error=True, stderr=None):
+    """Run command for each module within execd_dir which defines it."""
+    if stderr is None:
+        stderr = sys.stdout
+    for submodule_path in execd_submodule_paths(command, execd_dir):
+        # Only run each execd once. We cannot simply run them in the
+        # install hook, as potentially storage hooks are run before that.
+        # We cannot rely on them being idempotent.
+        sentinel = execd_sentinel_path(submodule_path)
+        if os.path.exists(sentinel):
+            continue
+
+        try:
+            subprocess.check_call([submodule_path], stderr=stderr,
+                                  universal_newlines=True)
+            with open(sentinel, 'w') as f:
+                f.write('{} ran successfully {}\n'.format(submodule_path,
+                                                          time.ctime()))
+                f.write('Removing this file will cause it to be run again\n')
+        except subprocess.CalledProcessError as e:
+            # Logs get the details. We can't use juju-log, as the
+            # output may be substantial and exceed command line
+            # length limits.
+            print("ERROR ({}) running {}".format(e.returncode, e.cmd),
+                  file=stderr)
+            print("STDOUT<<EOM", file=stderr)
+            print(e.output, file=stderr)
+            print("EOM", file=stderr)
+
+            # Unit workload status gets a shorter fail message.
+            short_path = os.path.relpath(submodule_path)
+            block_msg = "Error ({}) running {}".format(e.returncode,
+                                                       short_path)
+            try:
+                subprocess.check_call(['status-set', 'blocked', block_msg],
+                                      universal_newlines=True)
+                if stop_on_error:
+                    sys.exit(0)  # Leave unit in blocked state.
+            except Exception:
+                pass  # We care about the exec.d/* failure, not status-set.
+
+            if stop_on_error:
+                sys.exit(e.returncode or 1)  # Error state for pre-1.24 Juju
+
+
+def execd_preinstall(execd_dir=None):
+    """Run charm-pre-install for each module within execd_dir."""
+    execd_run('charm-pre-install', execd_dir=execd_dir)
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/options.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/options.py
new file mode 100644
index 0000000000000000000000000000000000000000..d3f273f27c345e0c814958662fa431c42a041b01
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/layer/options.py
@@ -0,0 +1,26 @@
+import os
+from pathlib import Path
+
+import yaml
+
+
+_CHARM_PATH = Path(os.environ.get('JUJU_CHARM_DIR', '.'))
+_DEFAULT_FILE = _CHARM_PATH / 'layer.yaml'
+_CACHE = {}
+
+
+def get(section=None, option=None, layer_file=_DEFAULT_FILE):
+    if option and not section:
+        raise ValueError('Cannot specify option without section')
+
+    layer_file = (_CHARM_PATH / layer_file).resolve()
+    if layer_file not in _CACHE:
+        with layer_file.open() as fp:
+            _CACHE[layer_file] = yaml.safe_load(fp.read())
+
+    data = _CACHE[layer_file].get('options', {})
+    if section:
+        data = data.get(section, {})
+    if option:
+        data = data.get(option)
+    return data
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/sshproxy.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..42e6b8a062200453ce11f93e8f24227e4ebb3c9d
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/lib/charms/sshproxy.py
@@ -0,0 +1,240 @@
+"""Module to help with executing commands over SSH."""
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+from charmhelpers.core import unitdata
+
+import io
+import ipaddress
+import paramiko
+import os
+import socket
+import shlex
+
+from subprocess import (
+    Popen,
+    CalledProcessError,
+    PIPE,
+)
+
+
+def get_config():
+    """Get the current charm configuration.
+
+    Get the "live" kv store every time we need to access the charm config, in
+    case it has recently been changed by a config-changed event.
+    """
+    db = unitdata.kv()
+    return db.get('config')
+
+
+def get_host_ip():
+    """Get the IP address for the ssh host.
+
+    HACK: This function was added to work around an issue where the
+    ssh-hostname was passed in the format of a.b.c.d;a.b.c.d, where the first
+    is the floating ip, and the second the non-floating ip, for an Openstack
+    instance.
+    """
+    cfg = get_config()
+    return cfg['ssh-hostname'].split(';')[0]
+
+
+def is_valid_hostname(hostname):
+    """Validate the ssh-hostname."""
+    if hostname == "0.0.0.0":
+        return False
+
+    try:
+        ipaddress.ip_address(hostname)
+    except ValueError:
+        return False
+
+    return True
+
+
+def verify_ssh_credentials():
+    """Verify the ssh credentials have been installed to the VNF.
+
+    Attempts to run a stock command - `hostname` on the remote host.
+    """
+    verified = False
+    status = ''
+    cfg = get_config()
+
+    try:
+        host = get_host_ip()
+        if is_valid_hostname(host):
+            if len(cfg['ssh-hostname']) and len(cfg['ssh-username']):
+                cmd = 'hostname'
+                status, err = _run(cmd)
+
+                if len(err) == 0:
+                    verified = True
+        else:
+            status = "Invalid IP address."
+    except CalledProcessError as e:
+        status = 'Command failed: {} ({})'.format(
+            ' '.join(e.cmd),
+            str(e.output)
+        )
+    except paramiko.ssh_exception.AuthenticationException as e:
+        status = '{}.'.format(e)
+    except paramiko.ssh_exception.BadAuthenticationType as e:
+        status = '{}'.format(e.explanation)
+    except paramiko.ssh_exception.BadHostKeyException as e:
+        status = 'Host key mismatch: expected {} but got {}.'.format(
+            e.expected_key,
+            e.got_key,
+        )
+    except (TimeoutError, socket.timeout):
+        status = "Timeout attempting to reach {}".format(cfg['ssh-hostname'])
+    except Exception as error:
+        status = 'Unhandled exception: {}'.format(error)
+
+    return (verified, status)
+
+
+def charm_dir():
+    """Return the root directory of the current charm."""
+    d = os.environ.get('JUJU_CHARM_DIR')
+    if d is not None:
+        return d
+    return os.environ.get('CHARM_DIR')
+
+
+def run_local(cmd, env=None):
+    """Run a command locally."""
+    if isinstance(cmd, str):
+        cmd = shlex.split(cmd) if ' ' in cmd else [cmd]
+
+    if type(cmd) is not list:
+        cmd = [cmd]
+
+    p = Popen(cmd,
+              env=env,
+              shell=True,
+              stdout=PIPE,
+              stderr=PIPE)
+    stdout, stderr = p.communicate()
+    retcode = p.poll()
+    if retcode > 0:
+        raise CalledProcessError(returncode=retcode,
+                                 cmd=cmd,
+                                 output=stderr.decode("utf-8").strip())
+    return (stdout.decode('utf-8').strip(), stderr.decode('utf-8').strip())
+
+
+def _run(cmd, env=None):
+    """Run a command remotely via SSH.
+
+    Note: The previous behavior was to run the command locally if SSH wasn't
+    configured, but that can lead to cases where execution succeeds when you'd
+    expect it not to.
+    """
+    if isinstance(cmd, str):
+        cmd = shlex.split(cmd)
+
+    if type(cmd) is not list:
+        cmd = [cmd]
+
+    cfg = get_config()
+
+    if cfg:
+        if all(k in cfg for k in ['ssh-hostname', 'ssh-username',
+                                  'ssh-password', 'ssh-private-key']):
+            host = get_host_ip()
+            user = cfg['ssh-username']
+            passwd = cfg['ssh-password']
+            key = cfg['ssh-private-key']  # DEPRECATED
+
+            if host and user:
+                return ssh(cmd, host, user, passwd, key)
+
+    raise Exception("Invalid SSH credentials.")
+
+
+def get_ssh_client(host, user, password=None, key=None):
+    """Return a connected Paramiko ssh object."""
+    client = paramiko.SSHClient()
+    client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+
+    pkey = None
+
+    # Check for the DEPRECATED private-key
+    if key:
+        f = io.StringIO(key)
+        pkey = paramiko.RSAKey.from_private_key(f)
+    else:
+        # Otherwise, check for the auto-generated private key
+        if os.path.exists('/root/.ssh/id_juju_sshproxy'):
+            with open('/root/.ssh/id_juju_sshproxy', 'r') as f:
+                pkey = paramiko.RSAKey.from_private_key(f)
+
+    ###########################################################################
+    # There is a bug in some versions of OpenSSH 4.3 (CentOS/RHEL 5) where    #
+    # the server may not send the SSH_MSG_USERAUTH_BANNER message except when #
+    # responding to an auth_none request. For example, paramiko will attempt  #
+    # to use password authentication when a password is set, but the server   #
+    # could deny that, instead requesting keyboard-interactive. The hack to   #
+    # workaround this is to attempt a reconnect, which will receive the right #
+    # banner, and authentication can proceed. See the following for more info #
+    # https://github.com/paramiko/paramiko/issues/432                         #
+    # https://github.com/paramiko/paramiko/pull/438                           #
+    ###########################################################################
+
+    try:
+        client.connect(host, port=22, username=user,
+                       password=password, pkey=pkey)
+    except paramiko.ssh_exception.SSHException as e:
+        if 'Error reading SSH protocol banner' == str(e):
+            # Once more, with feeling
+            client.connect(host, port=22, username=user,
+                           password=password, pkey=pkey)
+        else:
+            # Reraise the original exception
+            raise e
+
+    return client
+
+
+def sftp(local_file, remote_file, host, user, password=None, key=None):
+    """Copy a local file to a remote host."""
+    client = get_ssh_client(host, user, password, key)
+
+    # Create an sftp connection from the underlying transport
+    sftp = paramiko.SFTPClient.from_transport(client.get_transport())
+    sftp.put(local_file, remote_file)
+    client.close()
+
+
+def ssh(cmd, host, user, password=None, key=None):
+    """Run an arbitrary command over SSH."""
+    client = get_ssh_client(host, user, password, key)
+
+    cmds = ' '.join(cmd)
+    stdin, stdout, stderr = client.exec_command(cmds, get_pty=True)
+    retcode = stdout.channel.recv_exit_status()
+    client.close()  # @TODO re-use connections
+    if retcode > 0:
+        output = stderr.read().strip()
+        raise CalledProcessError(returncode=retcode, cmd=cmd,
+                                 output=output)
+    return (
+        stdout.read().decode('utf-8').strip(),
+        stderr.read().decode('utf-8').strip()
+    )
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/metadata.yaml b/SOL004/hackfest_proxycharm_vnf/charms/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f55fdd650c3aeb9c17c197c5f98d8d7b392751a8
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/metadata.yaml
@@ -0,0 +1,16 @@
+"name": "simple"
+"summary": "A simple VNF proxy charm"
+"maintainer": "Adam Israel <adam.israel@canonical.com>"
+"description": |
+  VNF "proxy" charms are a lightweight version of a charm that, rather than
+  installing software on the same machine, execute commands over an ssh channel.
+"tags":
+  # Replace "misc" with one or more whitelisted tags from this list:
+  # https://jujucharms.com/docs/stable/authors-charm-metadata
+  - "misc"
+  - "osm"
+  - "vnf"
+"series":
+- "xenial"
+- "trusty"
+"subordinate": !!bool "false"
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/__init__.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/simple.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/simple.py
new file mode 100644
index 0000000000000000000000000000000000000000..21e3ff9175516ff66fa3eeac0cd3d4229a8ed9e8
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/simple.py
@@ -0,0 +1,35 @@
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+)
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+import charms.sshproxy
+
+
+@when('sshproxy.configured')
+@when_not('simple.installed')
+def install_simple_proxy_charm():
+    set_flag('simple.installed')
+    status_set('active', 'Ready!')
+
+
+@when('actions.touch')
+def touch():
+    err = ''
+    try:
+        filename = action_get('filename')
+        cmd = ['touch {}'.format(filename)]
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'outout': result})
+    finally:
+        clear_flag('actions.touch')
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/sshproxy.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/sshproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..cde43bc2193c1c410363d2c81873017d725ad7aa
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/sshproxy.py
@@ -0,0 +1,209 @@
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+from charmhelpers.core import unitdata
+from charmhelpers.core.hookenv import (
+    action_fail,
+    action_get,
+    action_set,
+    config,
+    log,
+    status_set,
+    DEBUG,
+)
+
+from charms.reactive.flags import register_trigger
+
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+    when_any,
+)
+import charms.sshproxy
+import os
+import subprocess
+
+# Register a trigger so that we can respond to config.changed, even if
+# it's being cleared by another handler
+register_trigger(when='config.changed',
+                 set_flag='sshproxy.reconfigure')
+
+
+@when_any('config.changed', 'sshproxy.reconfigure')
+def ssh_configured():
+    """Check if charm is properly configured.
+
+    Check to see if the charm is configured with SSH credentials. If so,
+    set a state flag that can be used to execute ssh-only actions.
+
+    For example:
+
+    @when('sshproxy.configured')
+    def run_remote_command(cmd):
+        ...
+
+    @when_not('sshproxy.configured')
+    def run_local_command(cmd):
+        ...
+    """
+    log("Checking sshproxy configuration", DEBUG)
+    cfg = config()
+    ssh_keys = ['ssh-hostname', 'ssh-username',
+                'ssh-password', 'ssh-private-key']
+
+    if all(k in cfg for k in ssh_keys):
+
+        # Store config in unitdata so it's accessible to sshproxy
+        db = unitdata.kv()
+        db.set('config', cfg)
+
+        # Explicitly flush the kv so it's immediately available
+        db.flush()
+
+        log("Verifying ssh credentials...", DEBUG)
+        (verified, output) = charms.sshproxy.verify_ssh_credentials()
+        if verified:
+            log("SSH credentials verified.", DEBUG)
+            set_flag('sshproxy.configured')
+            status_set('active', 'Ready!')
+        else:
+            clear_flag('sshproxy.configured')
+            status_set('blocked', "Verification failed: {}".format(output))
+    else:
+        log("No ssh credentials configured", DEBUG)
+        clear_flag('sshproxy.configured')
+        status_set('blocked', 'Invalid SSH credentials.')
+
+
+def generate_ssh_key():
+    """Generate a new 4096-bit rsa keypair.
+
+    If there is an existing keypair for this unit, it will be overwritten.
+    """
+    cfg = config()
+    if all(k in cfg for k in ['ssh-key-type', 'ssh-key-bits']):
+        keytype = cfg['ssh-key-type']
+        bits = str(cfg['ssh-key-bits'])
+        privatekey = '/root/.ssh/id_juju_sshproxy'
+        publickey = "{}.pub".format(privatekey)
+
+        if os.path.exists(privatekey):
+            os.remove(privatekey)
+        if os.path.exists(publickey):
+            os.remove(publickey)
+
+        cmd = "ssh-keygen -t {} -b {} -N '' -f {}".format(
+            keytype,
+            bits,
+            privatekey
+        )
+
+        output, err = charms.sshproxy.run_local([cmd])
+        if len(err) == 0:
+            return True
+    return False
+
+
+@when('actions.generate-ssh-key')
+def action_generate_ssh_key():
+    """Generate a new 4096-bit rsa keypair.
+
+    If there is an existing keypair for this unit, it will be overwritten.
+    """
+    try:
+        if not generate_ssh_key():
+            action_fail('Unable to generate ssh key.')
+    except subprocess.CalledProcessError as e:
+        action_fail('Command failed: %s (%s)' %
+                    (' '.join(e.cmd), str(e.output)))
+    finally:
+        clear_flag('actions.generate-ssh-key')
+
+
+def get_ssh_public_key():
+    """Get the public SSH key of this unit."""
+    publickey_path = '/root/.ssh/id_juju_sshproxy.pub'
+    publickey = None
+    if os.path.exists(publickey_path):
+        with open(publickey_path, 'r') as f:
+            publickey = f.read()
+
+    return publickey
+
+
+@when('actions.get-ssh-public-key')
+def action_get_ssh_public_key():
+    """Get the public SSH key of this unit."""
+    try:
+        action_set({'pubkey': get_ssh_public_key()})
+    except subprocess.CalledProcessError as e:
+        action_fail('Command failed: %s (%s)' %
+                    (' '.join(e.cmd), str(e.output)))
+    finally:
+        clear_flag('actions.get-ssh-public-key')
+
+
+@when('actions.verify-ssh-credentials')
+def action_verify_ssh_credentials():
+    """Verify the ssh credentials have been installed to the VNF.
+
+    Attempts to run a stock command - `hostname` on the remote host.
+    """
+    try:
+        (verified, output) = charms.sshproxy.verify_ssh_credentials()
+        action_set({
+            'output': output,
+            'verified': verified,
+        })
+        if not verified:
+            action_fail("Verification failed: {}".format(
+                output,
+            ))
+    finally:
+        clear_flag('actions.verify-ssh-credentials')
+
+
+@when('actions.run')
+def run_command():
+    """Run an arbitrary command.
+
+    Run an arbitrary command, either locally or over SSH with the configured
+    credentials.
+    """
+    try:
+        cmd = action_get('command')
+        output, err = charms.sshproxy._run(cmd)
+        if len(err):
+            action_fail("Command '{}' returned error code {}".format(cmd, err))
+        else:
+            action_set({'output': output})
+    except subprocess.CalledProcessError as e:
+        action_fail('Command failed: %s (%s)' %
+                    (' '.join(e.cmd), str(e.output)))
+    finally:
+        clear_flag('actions.run')
+
+
+@when_not('sshproxy.installed')
+def install_vnf_ubuntu_proxy():
+    """Install and Configure SSH Proxy."""
+
+    log("Generating SSH key...", DEBUG)
+    generate_ssh_key()
+    set_flag('sshproxy.installed')
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/vnfproxy.py b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/vnfproxy.py
new file mode 100644
index 0000000000000000000000000000000000000000..6616991df245a920116b9301b52602f15ba7a9bc
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/reactive/vnfproxy.py
@@ -0,0 +1,89 @@
+from charmhelpers.core.hookenv import (
+    action_fail,
+    action_set,
+)
+
+from charms.reactive import (
+    when,
+    clear_flag,
+)
+import charms.sshproxy
+
+
+@when('actions.reboot')
+def reboot():
+    err = ''
+    try:
+        result, err = charms.sshproxy._run("reboot")
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'outout': result})
+    finally:
+        clear_flag('actions.reboot')
+
+
+###############################################################################
+# Below is an example implementation of the start/stop/restart actions.       #
+# To use this, copy the below code into your layer and add the appropriate    #
+# command(s) necessary to perform the action.                                 #
+###############################################################################
+
+# @when('actions.start')
+# def start():
+#     err = ''
+#     try:
+#         cmd = "service myname start"
+#         result, err = charms.sshproxy._run(cmd)
+#     except:
+#         action_fail('command failed:' + err)
+#     else:
+#         action_set({'outout': result})
+#     finally:
+#         clear_flag('actions.start')
+#
+#
+# @when('actions.stop')
+# def stop():
+#     err = ''
+#     try:
+#         # Enter the command to stop your service(s)
+#         cmd = "service myname stop"
+#         result, err = charms.sshproxy._run(cmd)
+#     except:
+#         action_fail('command failed:' + err)
+#     else:
+#         action_set({'outout': result})
+#     finally:
+#         clear_flag('actions.stop')
+#
+#
+# @when('actions.restart')
+# def restart():
+#     err = ''
+#     try:
+#         # Enter the command to restart your service(s)
+#         cmd = "service myname restart"
+#         result, err = charms.sshproxy._run(cmd)
+#     except:
+#         action_fail('command failed:' + err)
+#     else:
+#         action_set({'outout': result})
+#     finally:
+#         clear_flag('actions.restart')
+#
+#
+# @when('actions.upgrade')
+# def upgrade_vnf():
+#     err = ''
+#     try:
+#         # Add the command(s) to perform a VNF software upgrade
+#         cmd = ''
+#         result, err = charms.sshproxy._run(cmd)
+#     except:
+#         action_fail('command failed:' + err)
+#     else:
+#         action_set({'outout': result})
+#     finally:
+#         clear_flag('actions.upgrade')
+#
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/requirements.txt b/SOL004/hackfest_proxycharm_vnf/charms/simple/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..28ecacab6029381bd43d65f8dcfc0cc704870f71
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/requirements.txt
@@ -0,0 +1,2 @@
+flake8
+pytest
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/00-setup b/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/00-setup
new file mode 100755
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/10-deploy b/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/10-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..9a26117089498423ebba7dda3f7e3acb50ba54e7
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('simple')
+        self.d.expose('simple')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['simple'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/tox.ini b/SOL004/hackfest_proxycharm_vnf/charms/simple/tox.ini
new file mode 100644
index 0000000000000000000000000000000000000000..6f0fa11dee3187367ecd1637bef45533f289fd9e
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/tox.ini
@@ -0,0 +1,15 @@
+[tox]
+skipsdist=True
+envlist = py34, py35
+skip_missing_interpreters = True
+
+[testenv]
+# This is not pretty, but pytest will return 0 if all tests worked and 5 if no tests are found.
+# We want to consider no tests as an indication of success.
+commands = /bin/bash -c 'py.test -v || if [[ $? == 5 ]]; then true; else false; fi'
+
+deps =
+    -r{toxinidir}/requirements.txt
+
+[flake8]
+exclude=docs
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/version b/SOL004/hackfest_proxycharm_vnf/charms/simple/version
new file mode 100644
index 0000000000000000000000000000000000000000..e13a57015aedd85e122d4cc2f4074c614fd6eb68
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/charms/simple/version
@@ -0,0 +1 @@
+525d4cb
\ No newline at end of file
diff --git a/SOL004/hackfest_proxycharm_vnf/charms/simple/wheelhouse/setuptools-39.0.1.zip b/SOL004/hackfest_proxycharm_vnf/charms/simple/wheelhouse/setuptools-39.0.1.zip
new file mode 100644
index 0000000000000000000000000000000000000000..e4b0aaca167d76e92f2ef499e206799366799017
Binary files /dev/null and b/SOL004/hackfest_proxycharm_vnf/charms/simple/wheelhouse/setuptools-39.0.1.zip differ
diff --git a/SOL004/hackfest_proxycharm_vnf/cloud_init/cloud-config.txt b/SOL004/hackfest_proxycharm_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..36c8d1bf2cdebbc4e50d1e8348003f64f419cd0b
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,12 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
diff --git a/SOL004/hackfest_proxycharm_vnf/hackfest_proxycharm_vnfd.yaml b/SOL004/hackfest_proxycharm_vnf/hackfest_proxycharm_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e058bfee7876caf5a23a37693b05f93dbdc30d0e
--- /dev/null
+++ b/SOL004/hackfest_proxycharm_vnf/hackfest_proxycharm_vnfd.yaml
@@ -0,0 +1,97 @@
+vnfd:
+  description: A VNF consisting of 1 VDU connected to two external VL, and one for
+    data and another one for management
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: hackfest_proxycharm-vnf
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+          config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm4u
+            seq: 1
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              name: filename
+              value: /home/ubuntu/first-touch
+            seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: mgmtVM
+  id: hackfest_proxycharm-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_proxycharm-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
diff --git a/SOL004/hackfest_proxycharm_vnf/icons/osm.png b/SOL004/hackfest_proxycharm_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/hackfest_proxycharm_vnf/icons/osm.png differ
diff --git a/SOL004/hackfest_simple_k8s_ns/hackfest_simple_k8s_nsd.yaml b/SOL004/hackfest_simple_k8s_ns/hackfest_simple_k8s_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e8a889ebac881054ad9e8e21db74647d93ac7997
--- /dev/null
+++ b/SOL004/hackfest_simple_k8s_ns/hackfest_simple_k8s_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: NS with 1 KDU connected to the mgmtnet VL
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: hackfest-simple-k8s-vnf
+    id: hackfest-simple-k8s-ns
+    name: hackfest-simple-k8s-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - hackfest-simple-k8s-vnf
diff --git a/SOL004/hackfest_simple_k8s_vnf/hackfest_simple_k8s_vnfd.yaml b/SOL004/hackfest_simple_k8s_vnf/hackfest_simple_k8s_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9d6d8e37d9928c7fb10e1cc51ea31105c0d35394
--- /dev/null
+++ b/SOL004/hackfest_simple_k8s_vnf/hackfest_simple_k8s_vnfd.yaml
@@ -0,0 +1,15 @@
+vnfd:
+  df:
+  - id: default-df
+  ext-cpd:
+  - id: mgmt-ext
+    k8s-cluster-net: mgmtnet
+  id: hackfest-simple-k8s-vnf
+  k8s-cluster:
+    nets:
+    - id: mgmtnet
+  kdu:
+  - name: mykdu
+    juju-bundle: cs:~dominik.f/bundle/hf-k8s-bundle-0
+  mgmt-cp: mgmt-ext
+  product-name: hackfest-simple-k8s-vnf
diff --git a/SOL004/hackfest_virtual-pc_ns/README.md b/SOL004/hackfest_virtual-pc_ns/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..7c2c2af5bfc0cadb01d9b28eaf85fc90c213d023
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_ns/README.md
@@ -0,0 +1,3 @@
+# Descriptor created by OSM descriptor package generated
+
+**Created on 02/18/2021, 05:51:56 **
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_ns/hackfest_virtual-pc_nsd.yaml b/SOL004/hackfest_virtual-pc_ns/hackfest_virtual-pc_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..fb8c4ea309b7a7044a0189d6e503df4a423a4011
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_ns/hackfest_virtual-pc_nsd.yaml
@@ -0,0 +1,42 @@
+# Copyright ETSI OSM
+#
+# All Rights Reserved.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+nsd:
+  nsd:
+  - description: Virtual Desktop Computer with Mate Desktop and RDP
+    designer: OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: virtual-pc-private-ext
+          virtual-link-profile-id: private
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: virtual-pc-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: hackfest_virtual-pc_vnf
+    id: hackfest_virtual-pc_ns
+    name: hackfest_virtual-pc_ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    - id: private
+    vnfd-id:
+    - hackfest_virtual-pc_vnf
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/.jujuignore b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/.jujuignore
new file mode 100644
index 0000000000000000000000000000000000000000..077f15e4b287bb15d8c0223f83c375eb3dd96449
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/.jujuignore
@@ -0,0 +1,4 @@
+/venv
+*.py[cod]
+*.charm
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/LICENSE b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..94a9ed024d3859793618152ea559a168bbcbb5e2
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/LICENSE
@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/README.md b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..834c2b5b5b8b4b0a49a855bfb0c8af9d41b590f7
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/README.md
@@ -0,0 +1,55 @@
+# virtual-pc
+
+## Description
+
+
+## Usage
+
+### Prepare the environment
+
+```bash
+sudo snap install juju --classic --channel 2.8/stable
+sudo snap install lxd
+lxd.init
+juju bootstrap lxd
+juju add-model test-virtual-pc
+```
+
+### Deploy (from the Store)
+
+```bash
+juju deploy cs:~charmed-osm/virtual-pc --channel edge
+```
+
+### Deploy (locally)
+
+Build the charm:
+
+```bash
+virtualenv -p python3 venv
+source venv/bin/activate
+pip install -r requirements-dev.txt
+pip install charmcraft
+./venv/bin/charmcraft build
+```
+
+Deploy:
+
+```bash
+juju deploy ./virtual-pc.charm
+```
+
+## Developing
+
+Create and activate a virtualenv with the development requirements:
+
+    virtualenv -p python3 venv
+    source venv/bin/activate
+    pip install -r requirements-dev.txt
+
+## Testing
+
+The Python operator framework includes a very nice harness for testing
+operator behaviour without full deployment. Just `run_tests`:
+
+    ./run_tests
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/actions.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e4b157ae1c0dfd901e05a717309ca3420171b6fe
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/actions.yaml
@@ -0,0 +1,63 @@
+# Copyright ETSI OSM Contributors
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need actions, you can remove the file entirely.
+# It ties in to the example _on_fortune_action handler in src/charm.py
+
+add-package:
+  description: "Adds software packages from apt."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+add-snap:
+  description: "Adds software packages from snap store."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+announce:
+  description: "Sends a message to logged in users"
+  params:
+    message:
+      description: "Message to send"
+      type: string
+      default: ""
+  required:
+    - message
+
+reboot:
+  description: "Reboots the server."
+
+remove-package:
+  description: "Removes software packages from system."
+  params:
+    package:
+      description: "Names of packages to remove, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+remove-snap:
+  description: "Adds software packages from snap store."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+update-system:
+  description: "Updates all software to latest version."
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/config.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c2c67568178ac63cc757a0a68bb013fb1bfbd404
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/config.yaml
@@ -0,0 +1,6 @@
+# Copyright 2020 ETSI OSM Contributors
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need config, you can remove the file entirely.
+options:
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/metadata.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3d30a5b5d2ce0a8d867fe00ac7974a6133e4d50b
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/metadata.yaml
@@ -0,0 +1,9 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+name: virtual-pc
+description: |
+  TODO: fill out the charm's description
+summary: |
+  TODO: fill out the charm's summary
+series:
+  - focal
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements-dev.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements-dev.txt
new file mode 100644
index 0000000000000000000000000000000000000000..34e6ef82473af5ec6fb293e11ef353d30ddcdca6
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements-dev.txt
@@ -0,0 +1,3 @@
+-r requirements.txt
+flake8
+charmcraft
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/requirements.txt
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/run_tests b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/run_tests
new file mode 100755
index 0000000000000000000000000000000000000000..08ec01e05a8965a5009902a6732adf13c027add6
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/run_tests
@@ -0,0 +1,16 @@
+#!/bin/sh -e
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+if [ -z "$VIRTUAL_ENV" -a -d venv/ ]; then
+    . venv/bin/activate
+fi
+
+if [ -z "$PYTHONPATH" ]; then
+    export PYTHONPATH=src
+else
+    export PYTHONPATH="src:$PYTHONPATH"
+fi
+
+flake8
+python3 -m unittest -v "$@"
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/charm.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..41e3c64201ded3be2b440a423d3db2c47809ad15
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/charm.py
@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+from apt.progress.base import InstallProgress
+import logging
+import os
+import shutil
+import time
+
+from jinja2 import Template
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import (
+    MaintenanceStatus,
+    ActiveStatus,
+    # BlockedStatus,
+)
+from utils import (
+    service_stop,
+    service_restart,
+    install_apt,
+    remove_apt,
+    shell,
+    upgrade_apt,
+)
+
+
+# from typing import Dict, Any
+logger = logging.getLogger(__name__)
+
+APT_PROXY_PATH = "/etc/apt/apt.conf.d/99-HIVE-apt-proxy"
+APT_PROXY_TEMPLATE = "./templates/proxy"
+APT_REQUIREMENTS = [
+    "firefox",
+    "indicator-applet-session",
+    "libnotify-bin",
+    "mate-desktop",
+    "mate-applets",
+    "mate-applet-brisk-menu",
+    "mate-control-center",
+    "mate-indicator-applet",
+    "mate-notification-daemon",
+    "mate-session-manager",
+    "mate-terminal",
+    "xrdp",
+]
+
+POLKIT_PATH = "/etc/polkit-1/localauthority/50-local.d/color.pkla"
+POLKIT_TEMPLATE = "./templates/color.pkla"
+PUBLIC_IP_PATH = "/etc/netplan/60-no-public-ip.yaml"
+PUBLIC_IP_TEMPLATE = "./templates/60-no-public-ip.yaml"
+SNAP_INSTALLS = [
+    #"code --classic",
+]
+STARTWM_PATH = "/etc/xrdp/startwm.sh"
+STARTWM_TEMPLATE = "./templates/startwm.sh"
+# WM_COMMAND = "startxfce4" # xubuntu-desktop
+# WM_COMMAND = "budgie-desktop" # budgie-desktop-environment
+WM_COMMAND = "mate-session"  # mate-desktop
+
+
+class VirtualPCCharm(CharmBase, InstallProgress):
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        super().__init__(*args)
+        InstallProgress.__init__(self)
+
+        self._stored.set_default()
+        self.last_status_update = time.time()
+
+        # Basic hooks
+        self.framework.observe(self.on.install, self._on_install)
+        self.framework.observe(self.on.start, self._on_start)
+        self.framework.observe(self.on.stop, self._on_stop)
+        self.framework.observe(self.on.config_changed, self._on_config_changed)
+        self.framework.observe(self.on.update_status, self._on_update_status)
+
+        # Actions hooks
+        self.framework.observe(self.on["add-package"].action, self._add_package)
+        self.framework.observe(self.on["add-snap"].action, self._add_snap)
+        self.framework.observe(self.on["announce"].action, self._announce)
+        self.framework.observe(self.on["reboot"].action, self._reboot)
+        self.framework.observe(self.on["remove-package"].action, self._remove_package)
+        self.framework.observe(self.on["remove-snap"].action, self._remove_snap)
+        self.framework.observe(self.on["update-system"].action, self._update_system)
+
+        # Relations hooks
+
+    # Override InstallProgress to update our status
+    def status_change(self, pkg, percent, status):
+        if (time.time() - self.last_status_update) < 2:
+            return
+        self.last_status_update = time.time()
+        message = str(int(percent)) + "% " + status
+        self.unit.status = MaintenanceStatus(message)
+
+    # Basic hooks
+    def _on_install(self, _):
+
+        self.unit.status = MaintenanceStatus("Setting up apt proxy")
+        with open(APT_PROXY_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(APT_PROXY_PATH, "w") as proxy:
+                proxy.write(content)
+
+        self.unit.status = MaintenanceStatus("Installing apt packages")
+        install_apt(packages=APT_REQUIREMENTS, update=True, progress=self)
+        service_stop('xrdp')
+
+        self.unit.status = MaintenanceStatus("Installing snaps")
+        for snap in SNAP_INSTALLS:
+            shell("snap install " + snap)
+
+        self.unit.status = MaintenanceStatus("Setting default display manager")
+        shell("echo /usr/sbin/lightdm | sudo tee /etc/X11/default-display-manager")
+
+        self.unit.status = MaintenanceStatus("Adding XRDP to ssl-cert group")
+        shell("adduser xrdp ssl-cert")
+
+        self.unit.status = MaintenanceStatus("Generating Window Manager startup script")
+        with open(STARTWM_TEMPLATE, "r") as template:
+            content = Template(template.read()).render(command=WM_COMMAND)
+            with open(STARTWM_PATH, "w") as startwm:
+                startwm.write(content)
+
+        self.unit.status = MaintenanceStatus("Generating Polkit files")
+        with open(POLKIT_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(POLKIT_PATH, "w") as polkit:
+                polkit.write(content)
+
+        self.unit.status = MaintenanceStatus("Removing public IP interface")
+        with open(PUBLIC_IP_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(PUBLIC_IP_PATH, "w") as public_ip:
+                public_ip.write(content)
+        shell("netplan apply")
+
+        self._stored.installed = True
+        self.unit.status = self._get_current_status()
+
+    def _on_start(self, _):
+        self.unit.status = MaintenanceStatus("Starting XRDP server")
+        service_restart('xrdp')
+        self._stored.started = True
+        self.unit.status = self._get_current_status()
+
+    def _on_stop(self, _):
+        service_stop('xrdp')
+        self._stored.started = False
+        self.unit.status = self._get_current_status()
+
+    def _on_config_changed(self, _):
+        self.unit.status = self._get_current_status()
+
+    def _on_update_status(self, _):
+        self.unit.status = self._get_current_status()
+
+    # Action hooks
+    def _add_package(self, event):
+        self.unit.status = MaintenanceStatus("Installing apt packages")
+        install_apt(packages=event.params["package"].split(','),
+                    update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    def _add_snap(self, event):
+        self.unit.status = MaintenanceStatus("Installing snaps")
+        for snap in event.params["package"].split(','):
+            shell("snap install " + snap)
+        self.unit.status = self._get_current_status()
+
+    def _announce(self, event):
+        self.unit.status = MaintenanceStatus("Announce")
+        message = event.params["message"]
+        shell("su - ubuntu -c 'XDG_RUNTIME_DIR=/run/user/$(id -u) notify-send \"" + message + "\"'")
+        self.unit.status = self._get_current_status()
+
+    def _reboot(self, _):
+        self.unit.status = MaintenanceStatus("Rebooting server")
+        shell("su - ubuntu -c 'XDG_RUNTIME_DIR=/run/user/$(id -u) notify-send \"System is going down for reboot in 60 seconds\" -u critical'")
+        shell("shutdown -r +1")
+        self.unit.status = self._get_current_status()
+
+    def _remove_package(self, event):
+        self.unit.status = MaintenanceStatus("Removing apt packages")
+        remove_apt(packages=event.params["package"].split(','),
+                   update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    def _remove_snap(self, event):
+        self.unit.status = MaintenanceStatus("Removing snaps")
+        for snap in event.params["package"].split(','):
+            shell("snap remove " + snap)
+        self.unit.status = self._get_current_status()
+
+    def _update_system(self, _):
+        self.unit.status = MaintenanceStatus("Updating system")
+        upgrade_apt(update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    # Relation hooks
+
+    # Private functions
+    def _get_current_status(self):
+        status_type = ActiveStatus
+        status_msg = ""
+        if self._stored.installed:
+            status_msg = "Ready"
+        return status_type(status_msg)
+
+
+if __name__ == "__main__":
+    main(VirtualPCCharm)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/test.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/test.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4cb4f758d048e240819dc2dad33ae5d5519e1bc
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/test.py
@@ -0,0 +1,17 @@
+from apt.progress.base import InstallProgress
+
+from utils import (
+    install_apt,
+)
+
+
+class Progress(InstallProgress):
+
+    def status_change(self, pkg, percent, status):
+        print("status change\n")
+        #print(str(int(percent)) + "% \n")
+        True
+
+
+if __name__ == "__main__":
+    install_apt(packages=["mate-backgrounds"], update=True, progress=Progress())
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/utils.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2df3c225b902ed20107eecd8b894067af8831fe
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/src/utils.py
@@ -0,0 +1,86 @@
+import apt
+from apt.progress.base import OpProgress
+import shutil
+import subprocess
+from typing import Dict, List, NoReturn
+
+
+def service_active(service_name: str):
+    result = subprocess.run(
+        ["systemctl", "is-active", service_name],
+        stdout=subprocess.PIPE,
+        encoding="utf-8",
+    )
+    return result.stdout == "active\n"
+
+
+def all_values_set(dictionary: Dict[str, str]) -> bool:
+    return not any(v is None for v in dictionary.values())
+
+
+def install_apt(packages: List, update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    for package in packages:
+        pkg = cache[package]
+        if not pkg.is_installed:
+            pkg.mark_install()
+    cache.commit(install_progress=progress)
+
+
+def remove_apt(packages: List, update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    for package in packages:
+        pkg = cache[package]
+        if pkg.is_installed:
+            pkg.mark_delete()
+    cache.commit(install_progress=progress)
+
+
+def upgrade_apt(update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    cache.upgrade(dist_upgrade=True)
+    cache.commit(install_progress=progress)
+
+
+def shell(command: str) -> NoReturn:
+    subprocess.run(command, shell=True).check_returncode()
+
+
+def copy_files(origin: Dict[str, str], destination: Dict[str, str]) -> NoReturn:
+    for config, origin_path in origin.items():
+        destination_path = destination[config]
+        shutil.copy(origin_path, destination_path)
+
+
+# Service functions
+def _systemctl(action: str, service_name: str) -> NoReturn:
+    subprocess.run(["systemctl", action, service_name]).check_returncode()
+
+
+def service_start(service_name: str) -> NoReturn:
+    _systemctl("start", service_name)
+
+
+def service_restart(service_name: str) -> NoReturn:
+    _systemctl("restart", service_name)
+
+
+def service_stop(service_name: str) -> NoReturn:
+    _systemctl("stop", service_name)
+
+
+def service_enable(service_name: str) -> NoReturn:
+    _systemctl("enable", service_name)
+
+
+def systemctl_daemon_reload():
+    subprocess.run(["systemctl", "daemon-reload"]).check_returncode()
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/60-no-public-ip.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/60-no-public-ip.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a21254ab74f2a0d9127b9dbd372048548979a38e
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/60-no-public-ip.yaml
@@ -0,0 +1,5 @@
+network:
+    version: 2
+    ethernets:
+        ens4:
+            dhcp4: no
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/color.pkla b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/color.pkla
new file mode 100644
index 0000000000000000000000000000000000000000..c8b94041bdd63ede347565cbdbd091c8be1d89ec
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/color.pkla
@@ -0,0 +1,6 @@
+[Allow colord for all users]
+Identity=unix-user:*
+Action=org.freedesktop.color-manager.create-device;org.freedesktop.color-manager.create-profile;org.freedesktop.color-manager.delete-device;org.freedesktop.color-manager.delete-profile;org.freedesktop.color-manager.modify-device;org.freedesktop.color-manager.modify-profile
+ResultAny=yes
+ResultInactive=yes
+ResultActive=yes
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/proxy b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/proxy
new file mode 100644
index 0000000000000000000000000000000000000000..d134ea040a3da1a0ab9f9b4b92a0275d97365d75
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/proxy
@@ -0,0 +1 @@
+Acquire::http { Proxy "http://172.21.18.4:3142"; }
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/startwm.sh b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/startwm.sh
new file mode 100644
index 0000000000000000000000000000000000000000..0f3bdb211420745ce7b4413895c23c621087541a
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/templates/startwm.sh
@@ -0,0 +1,33 @@
+#!/bin/sh
+# xrdp X session start script (c) 2015, 2017 mirabilos
+# published under The MirOS Licence
+
+if test -r /etc/profile; then
+        . /etc/profile
+fi
+
+if test -r /etc/default/locale; then
+        . /etc/default/locale
+        test -z "${LANG+x}" || export LANG
+        test -z "${LANGUAGE+x}" || export LANGUAGE
+        test -z "${LC_ADDRESS+x}" || export LC_ADDRESS
+        test -z "${LC_ALL+x}" || export LC_ALL
+        test -z "${LC_COLLATE+x}" || export LC_COLLATE
+        test -z "${LC_CTYPE+x}" || export LC_CTYPE
+        test -z "${LC_IDENTIFICATION+x}" || export LC_IDENTIFICATION
+        test -z "${LC_MEASUREMENT+x}" || export LC_MEASUREMENT
+        test -z "${LC_MESSAGES+x}" || export LC_MESSAGES
+        test -z "${LC_MONETARY+x}" || export LC_MONETARY
+        test -z "${LC_NAME+x}" || export LC_NAME
+        test -z "${LC_NUMERIC+x}" || export LC_NUMERIC
+        test -z "${LC_PAPER+x}" || export LC_PAPER
+        test -z "${LC_TELEPHONE+x}" || export LC_TELEPHONE
+        test -z "${LC_TIME+x}" || export LC_TIME
+        test -z "${LOCPATH+x}" || export LOCPATH
+fi
+
+if test -r /etc/profile; then
+        . /etc/profile
+fi
+
+{{ command }}
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/tests/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/tests/test_charm.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/tests/test_charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d456ec7fe3ff4b8033ad910c4aa4f4c57f8c873
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc-src/tests/test_charm.py
@@ -0,0 +1,35 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+import unittest
+from unittest.mock import Mock
+
+from ops.testing import Harness
+from charm import SrsLteCharm
+
+
+class TestCharm(unittest.TestCase):
+    def test_config_changed(self):
+        harness = Harness(SrsLteCharm)
+        self.addCleanup(harness.cleanup)
+        harness.begin()
+        self.assertEqual(list(harness.charm._stored.things), [])
+        harness.update_config({"thing": "foo"})
+        self.assertEqual(list(harness.charm._stored.things), ["foo"])
+
+    def test_action(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        # the harness doesn't (yet!) help much with actions themselves
+        action_event = Mock(params={"fail": ""})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertTrue(action_event.set_results.called)
+
+    def test_action_fail(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        action_event = Mock(params={"fail": "fail this"})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertEqual(action_event.fail.call_args, [("fail this",)])
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/LICENSE b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..94a9ed024d3859793618152ea559a168bbcbb5e2
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/LICENSE
@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/README.md b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..834c2b5b5b8b4b0a49a855bfb0c8af9d41b590f7
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/README.md
@@ -0,0 +1,55 @@
+# virtual-pc
+
+## Description
+
+
+## Usage
+
+### Prepare the environment
+
+```bash
+sudo snap install juju --classic --channel 2.8/stable
+sudo snap install lxd
+lxd.init
+juju bootstrap lxd
+juju add-model test-virtual-pc
+```
+
+### Deploy (from the Store)
+
+```bash
+juju deploy cs:~charmed-osm/virtual-pc --channel edge
+```
+
+### Deploy (locally)
+
+Build the charm:
+
+```bash
+virtualenv -p python3 venv
+source venv/bin/activate
+pip install -r requirements-dev.txt
+pip install charmcraft
+./venv/bin/charmcraft build
+```
+
+Deploy:
+
+```bash
+juju deploy ./virtual-pc.charm
+```
+
+## Developing
+
+Create and activate a virtualenv with the development requirements:
+
+    virtualenv -p python3 venv
+    source venv/bin/activate
+    pip install -r requirements-dev.txt
+
+## Testing
+
+The Python operator framework includes a very nice harness for testing
+operator behaviour without full deployment. Just `run_tests`:
+
+    ./run_tests
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/actions.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e4b157ae1c0dfd901e05a717309ca3420171b6fe
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/actions.yaml
@@ -0,0 +1,63 @@
+# Copyright ETSI OSM Contributors
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need actions, you can remove the file entirely.
+# It ties in to the example _on_fortune_action handler in src/charm.py
+
+add-package:
+  description: "Adds software packages from apt."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+add-snap:
+  description: "Adds software packages from snap store."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+announce:
+  description: "Sends a message to logged in users"
+  params:
+    message:
+      description: "Message to send"
+      type: string
+      default: ""
+  required:
+    - message
+
+reboot:
+  description: "Reboots the server."
+
+remove-package:
+  description: "Removes software packages from system."
+  params:
+    package:
+      description: "Names of packages to remove, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+remove-snap:
+  description: "Adds software packages from snap store."
+  params:
+    package:
+      description: "Names of packages to add, comma delimited."
+      type: string
+      default: ""
+  required:
+    - package
+
+update-system:
+  description: "Updates all software to latest version."
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/config.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c2c67568178ac63cc757a0a68bb013fb1bfbd404
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/config.yaml
@@ -0,0 +1,6 @@
+# Copyright 2020 ETSI OSM Contributors
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need config, you can remove the file entirely.
+options:
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/dispatch b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/dispatch
new file mode 100755
index 0000000000000000000000000000000000000000..fe31c0567bdce62a6542a6470997cb6a874e4bd8
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/dispatch
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+JUJU_DISPATCH_PATH="${JUJU_DISPATCH_PATH:-$0}" PYTHONPATH=lib:venv ./src/charm.py
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/install b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/install
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/start b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/start
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/upgrade-charm b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/hooks/upgrade-charm
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/metadata.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3d30a5b5d2ce0a8d867fe00ac7974a6133e4d50b
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/metadata.yaml
@@ -0,0 +1,9 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+name: virtual-pc
+description: |
+  TODO: fill out the charm's description
+summary: |
+  TODO: fill out the charm's summary
+series:
+  - focal
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements-dev.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements-dev.txt
new file mode 100644
index 0000000000000000000000000000000000000000..34e6ef82473af5ec6fb293e11ef353d30ddcdca6
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements-dev.txt
@@ -0,0 +1,3 @@
+-r requirements.txt
+flake8
+charmcraft
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/requirements.txt
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/run_tests b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/run_tests
new file mode 100755
index 0000000000000000000000000000000000000000..08ec01e05a8965a5009902a6732adf13c027add6
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/run_tests
@@ -0,0 +1,16 @@
+#!/bin/sh -e
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+if [ -z "$VIRTUAL_ENV" -a -d venv/ ]; then
+    . venv/bin/activate
+fi
+
+if [ -z "$PYTHONPATH" ]; then
+    export PYTHONPATH=src
+else
+    export PYTHONPATH="src:$PYTHONPATH"
+fi
+
+flake8
+python3 -m unittest -v "$@"
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/charm.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..41e3c64201ded3be2b440a423d3db2c47809ad15
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/charm.py
@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+from apt.progress.base import InstallProgress
+import logging
+import os
+import shutil
+import time
+
+from jinja2 import Template
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import (
+    MaintenanceStatus,
+    ActiveStatus,
+    # BlockedStatus,
+)
+from utils import (
+    service_stop,
+    service_restart,
+    install_apt,
+    remove_apt,
+    shell,
+    upgrade_apt,
+)
+
+
+# from typing import Dict, Any
+logger = logging.getLogger(__name__)
+
+APT_PROXY_PATH = "/etc/apt/apt.conf.d/99-HIVE-apt-proxy"
+APT_PROXY_TEMPLATE = "./templates/proxy"
+APT_REQUIREMENTS = [
+    "firefox",
+    "indicator-applet-session",
+    "libnotify-bin",
+    "mate-desktop",
+    "mate-applets",
+    "mate-applet-brisk-menu",
+    "mate-control-center",
+    "mate-indicator-applet",
+    "mate-notification-daemon",
+    "mate-session-manager",
+    "mate-terminal",
+    "xrdp",
+]
+
+POLKIT_PATH = "/etc/polkit-1/localauthority/50-local.d/color.pkla"
+POLKIT_TEMPLATE = "./templates/color.pkla"
+PUBLIC_IP_PATH = "/etc/netplan/60-no-public-ip.yaml"
+PUBLIC_IP_TEMPLATE = "./templates/60-no-public-ip.yaml"
+SNAP_INSTALLS = [
+    #"code --classic",
+]
+STARTWM_PATH = "/etc/xrdp/startwm.sh"
+STARTWM_TEMPLATE = "./templates/startwm.sh"
+# WM_COMMAND = "startxfce4" # xubuntu-desktop
+# WM_COMMAND = "budgie-desktop" # budgie-desktop-environment
+WM_COMMAND = "mate-session"  # mate-desktop
+
+
+class VirtualPCCharm(CharmBase, InstallProgress):
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        super().__init__(*args)
+        InstallProgress.__init__(self)
+
+        self._stored.set_default()
+        self.last_status_update = time.time()
+
+        # Basic hooks
+        self.framework.observe(self.on.install, self._on_install)
+        self.framework.observe(self.on.start, self._on_start)
+        self.framework.observe(self.on.stop, self._on_stop)
+        self.framework.observe(self.on.config_changed, self._on_config_changed)
+        self.framework.observe(self.on.update_status, self._on_update_status)
+
+        # Actions hooks
+        self.framework.observe(self.on["add-package"].action, self._add_package)
+        self.framework.observe(self.on["add-snap"].action, self._add_snap)
+        self.framework.observe(self.on["announce"].action, self._announce)
+        self.framework.observe(self.on["reboot"].action, self._reboot)
+        self.framework.observe(self.on["remove-package"].action, self._remove_package)
+        self.framework.observe(self.on["remove-snap"].action, self._remove_snap)
+        self.framework.observe(self.on["update-system"].action, self._update_system)
+
+        # Relations hooks
+
+    # Override InstallProgress to update our status
+    def status_change(self, pkg, percent, status):
+        if (time.time() - self.last_status_update) < 2:
+            return
+        self.last_status_update = time.time()
+        message = str(int(percent)) + "% " + status
+        self.unit.status = MaintenanceStatus(message)
+
+    # Basic hooks
+    def _on_install(self, _):
+
+        self.unit.status = MaintenanceStatus("Setting up apt proxy")
+        with open(APT_PROXY_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(APT_PROXY_PATH, "w") as proxy:
+                proxy.write(content)
+
+        self.unit.status = MaintenanceStatus("Installing apt packages")
+        install_apt(packages=APT_REQUIREMENTS, update=True, progress=self)
+        service_stop('xrdp')
+
+        self.unit.status = MaintenanceStatus("Installing snaps")
+        for snap in SNAP_INSTALLS:
+            shell("snap install " + snap)
+
+        self.unit.status = MaintenanceStatus("Setting default display manager")
+        shell("echo /usr/sbin/lightdm | sudo tee /etc/X11/default-display-manager")
+
+        self.unit.status = MaintenanceStatus("Adding XRDP to ssl-cert group")
+        shell("adduser xrdp ssl-cert")
+
+        self.unit.status = MaintenanceStatus("Generating Window Manager startup script")
+        with open(STARTWM_TEMPLATE, "r") as template:
+            content = Template(template.read()).render(command=WM_COMMAND)
+            with open(STARTWM_PATH, "w") as startwm:
+                startwm.write(content)
+
+        self.unit.status = MaintenanceStatus("Generating Polkit files")
+        with open(POLKIT_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(POLKIT_PATH, "w") as polkit:
+                polkit.write(content)
+
+        self.unit.status = MaintenanceStatus("Removing public IP interface")
+        with open(PUBLIC_IP_TEMPLATE, "r") as template:
+            content = Template(template.read()).render()
+            with open(PUBLIC_IP_PATH, "w") as public_ip:
+                public_ip.write(content)
+        shell("netplan apply")
+
+        self._stored.installed = True
+        self.unit.status = self._get_current_status()
+
+    def _on_start(self, _):
+        self.unit.status = MaintenanceStatus("Starting XRDP server")
+        service_restart('xrdp')
+        self._stored.started = True
+        self.unit.status = self._get_current_status()
+
+    def _on_stop(self, _):
+        service_stop('xrdp')
+        self._stored.started = False
+        self.unit.status = self._get_current_status()
+
+    def _on_config_changed(self, _):
+        self.unit.status = self._get_current_status()
+
+    def _on_update_status(self, _):
+        self.unit.status = self._get_current_status()
+
+    # Action hooks
+    def _add_package(self, event):
+        self.unit.status = MaintenanceStatus("Installing apt packages")
+        install_apt(packages=event.params["package"].split(','),
+                    update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    def _add_snap(self, event):
+        self.unit.status = MaintenanceStatus("Installing snaps")
+        for snap in event.params["package"].split(','):
+            shell("snap install " + snap)
+        self.unit.status = self._get_current_status()
+
+    def _announce(self, event):
+        self.unit.status = MaintenanceStatus("Announce")
+        message = event.params["message"]
+        shell("su - ubuntu -c 'XDG_RUNTIME_DIR=/run/user/$(id -u) notify-send \"" + message + "\"'")
+        self.unit.status = self._get_current_status()
+
+    def _reboot(self, _):
+        self.unit.status = MaintenanceStatus("Rebooting server")
+        shell("su - ubuntu -c 'XDG_RUNTIME_DIR=/run/user/$(id -u) notify-send \"System is going down for reboot in 60 seconds\" -u critical'")
+        shell("shutdown -r +1")
+        self.unit.status = self._get_current_status()
+
+    def _remove_package(self, event):
+        self.unit.status = MaintenanceStatus("Removing apt packages")
+        remove_apt(packages=event.params["package"].split(','),
+                   update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    def _remove_snap(self, event):
+        self.unit.status = MaintenanceStatus("Removing snaps")
+        for snap in event.params["package"].split(','):
+            shell("snap remove " + snap)
+        self.unit.status = self._get_current_status()
+
+    def _update_system(self, _):
+        self.unit.status = MaintenanceStatus("Updating system")
+        upgrade_apt(update=True, progress=self)
+        self.unit.status = self._get_current_status()
+
+    # Relation hooks
+
+    # Private functions
+    def _get_current_status(self):
+        status_type = ActiveStatus
+        status_msg = ""
+        if self._stored.installed:
+            status_msg = "Ready"
+        return status_type(status_msg)
+
+
+if __name__ == "__main__":
+    main(VirtualPCCharm)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/test.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/test.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4cb4f758d048e240819dc2dad33ae5d5519e1bc
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/test.py
@@ -0,0 +1,17 @@
+from apt.progress.base import InstallProgress
+
+from utils import (
+    install_apt,
+)
+
+
+class Progress(InstallProgress):
+
+    def status_change(self, pkg, percent, status):
+        print("status change\n")
+        #print(str(int(percent)) + "% \n")
+        True
+
+
+if __name__ == "__main__":
+    install_apt(packages=["mate-backgrounds"], update=True, progress=Progress())
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/utils.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..c2df3c225b902ed20107eecd8b894067af8831fe
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/src/utils.py
@@ -0,0 +1,86 @@
+import apt
+from apt.progress.base import OpProgress
+import shutil
+import subprocess
+from typing import Dict, List, NoReturn
+
+
+def service_active(service_name: str):
+    result = subprocess.run(
+        ["systemctl", "is-active", service_name],
+        stdout=subprocess.PIPE,
+        encoding="utf-8",
+    )
+    return result.stdout == "active\n"
+
+
+def all_values_set(dictionary: Dict[str, str]) -> bool:
+    return not any(v is None for v in dictionary.values())
+
+
+def install_apt(packages: List, update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    for package in packages:
+        pkg = cache[package]
+        if not pkg.is_installed:
+            pkg.mark_install()
+    cache.commit(install_progress=progress)
+
+
+def remove_apt(packages: List, update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    for package in packages:
+        pkg = cache[package]
+        if pkg.is_installed:
+            pkg.mark_delete()
+    cache.commit(install_progress=progress)
+
+
+def upgrade_apt(update: bool = False, progress=None) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    cache.upgrade(dist_upgrade=True)
+    cache.commit(install_progress=progress)
+
+
+def shell(command: str) -> NoReturn:
+    subprocess.run(command, shell=True).check_returncode()
+
+
+def copy_files(origin: Dict[str, str], destination: Dict[str, str]) -> NoReturn:
+    for config, origin_path in origin.items():
+        destination_path = destination[config]
+        shutil.copy(origin_path, destination_path)
+
+
+# Service functions
+def _systemctl(action: str, service_name: str) -> NoReturn:
+    subprocess.run(["systemctl", action, service_name]).check_returncode()
+
+
+def service_start(service_name: str) -> NoReturn:
+    _systemctl("start", service_name)
+
+
+def service_restart(service_name: str) -> NoReturn:
+    _systemctl("restart", service_name)
+
+
+def service_stop(service_name: str) -> NoReturn:
+    _systemctl("stop", service_name)
+
+
+def service_enable(service_name: str) -> NoReturn:
+    _systemctl("enable", service_name)
+
+
+def systemctl_daemon_reload():
+    subprocess.run(["systemctl", "daemon-reload"]).check_returncode()
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/60-no-public-ip.yaml b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/60-no-public-ip.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a21254ab74f2a0d9127b9dbd372048548979a38e
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/60-no-public-ip.yaml
@@ -0,0 +1,5 @@
+network:
+    version: 2
+    ethernets:
+        ens4:
+            dhcp4: no
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/color.pkla b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/color.pkla
new file mode 100644
index 0000000000000000000000000000000000000000..c8b94041bdd63ede347565cbdbd091c8be1d89ec
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/color.pkla
@@ -0,0 +1,6 @@
+[Allow colord for all users]
+Identity=unix-user:*
+Action=org.freedesktop.color-manager.create-device;org.freedesktop.color-manager.create-profile;org.freedesktop.color-manager.delete-device;org.freedesktop.color-manager.delete-profile;org.freedesktop.color-manager.modify-device;org.freedesktop.color-manager.modify-profile
+ResultAny=yes
+ResultInactive=yes
+ResultActive=yes
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/proxy b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/proxy
new file mode 100644
index 0000000000000000000000000000000000000000..d134ea040a3da1a0ab9f9b4b92a0275d97365d75
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/proxy
@@ -0,0 +1 @@
+Acquire::http { Proxy "http://172.21.18.4:3142"; }
\ No newline at end of file
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/startwm.sh b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/startwm.sh
new file mode 100644
index 0000000000000000000000000000000000000000..0f3bdb211420745ce7b4413895c23c621087541a
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/templates/startwm.sh
@@ -0,0 +1,33 @@
+#!/bin/sh
+# xrdp X session start script (c) 2015, 2017 mirabilos
+# published under The MirOS Licence
+
+if test -r /etc/profile; then
+        . /etc/profile
+fi
+
+if test -r /etc/default/locale; then
+        . /etc/default/locale
+        test -z "${LANG+x}" || export LANG
+        test -z "${LANGUAGE+x}" || export LANGUAGE
+        test -z "${LC_ADDRESS+x}" || export LC_ADDRESS
+        test -z "${LC_ALL+x}" || export LC_ALL
+        test -z "${LC_COLLATE+x}" || export LC_COLLATE
+        test -z "${LC_CTYPE+x}" || export LC_CTYPE
+        test -z "${LC_IDENTIFICATION+x}" || export LC_IDENTIFICATION
+        test -z "${LC_MEASUREMENT+x}" || export LC_MEASUREMENT
+        test -z "${LC_MESSAGES+x}" || export LC_MESSAGES
+        test -z "${LC_MONETARY+x}" || export LC_MONETARY
+        test -z "${LC_NAME+x}" || export LC_NAME
+        test -z "${LC_NUMERIC+x}" || export LC_NUMERIC
+        test -z "${LC_PAPER+x}" || export LC_PAPER
+        test -z "${LC_TELEPHONE+x}" || export LC_TELEPHONE
+        test -z "${LC_TIME+x}" || export LC_TIME
+        test -z "${LOCPATH+x}" || export LOCPATH
+fi
+
+if test -r /etc/profile; then
+        . /etc/profile
+fi
+
+{{ command }}
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/tests/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/tests/test_charm.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/tests/test_charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d456ec7fe3ff4b8033ad910c4aa4f4c57f8c873
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/tests/test_charm.py
@@ -0,0 +1,35 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+import unittest
+from unittest.mock import Mock
+
+from ops.testing import Harness
+from charm import SrsLteCharm
+
+
+class TestCharm(unittest.TestCase):
+    def test_config_changed(self):
+        harness = Harness(SrsLteCharm)
+        self.addCleanup(harness.cleanup)
+        harness.begin()
+        self.assertEqual(list(harness.charm._stored.things), [])
+        harness.update_config({"thing": "foo"})
+        self.assertEqual(list(harness.charm._stored.things), ["foo"])
+
+    def test_action(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        # the harness doesn't (yet!) help much with actions themselves
+        action_event = Mock(params={"fail": ""})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertTrue(action_event.set_results.called)
+
+    def test_action_fail(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        action_event = Mock(params={"fail": "fail this"})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertEqual(action_event.fail.call_args, [("fail this",)])
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/INSTALLER b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/LICENSE b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..2f1b8e15e5627d92f0521605c9870bc8e5505cb4
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2017-2021 Ingy döt Net
+Copyright (c) 2006-2016 Kirill Simonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/METADATA b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..565f05b73714eb85d96beb669a1aa42920c21c3a
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/METADATA
@@ -0,0 +1,46 @@
+Metadata-Version: 2.1
+Name: PyYAML
+Version: 5.4.1
+Summary: YAML parser and emitter for Python
+Home-page: https://pyyaml.org/
+Author: Kirill Simonov
+Author-email: xi@resolvent.net
+License: MIT
+Download-URL: https://pypi.org/project/PyYAML/
+Project-URL: Bug Tracker, https://github.com/yaml/pyyaml/issues
+Project-URL: CI, https://github.com/yaml/pyyaml/actions
+Project-URL: Documentation, https://pyyaml.org/wiki/PyYAMLDocumentation
+Project-URL: Mailing lists, http://lists.sourceforge.net/lists/listinfo/yaml-core
+Project-URL: Source Code, https://github.com/yaml/pyyaml
+Platform: Any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
+
+YAML is a data serialization format designed for human readability
+and interaction with scripting languages.  PyYAML is a YAML parser
+and emitter for Python.
+
+PyYAML features a complete YAML 1.1 parser, Unicode support, pickle
+support, capable extension API, and sensible error messages.  PyYAML
+supports standard YAML tags and provides Python-specific tags that
+allow to represent an arbitrary Python object.
+
+PyYAML is applicable for a broad range of tasks from complex
+configuration files to object serialization and persistence.
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/RECORD b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..68ca4da2c4df950a57ff47f60fbcacbb5256d161
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/RECORD
@@ -0,0 +1,43 @@
+PyYAML-5.4.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+PyYAML-5.4.1.dist-info/LICENSE,sha256=jTko-dxEkP1jVwfLiOsmvXZBAqcoKVQwfT5RZ6V36KQ,1101
+PyYAML-5.4.1.dist-info/METADATA,sha256=XnrM5LY-uS85ica26gKUK0dGG-xmPjmGfDTSLpIHQFk,2087
+PyYAML-5.4.1.dist-info/RECORD,,
+PyYAML-5.4.1.dist-info/WHEEL,sha256=Dh4w5P6PPWbqyqoE6MHlzbFQwZXlM-voWJDf2WUsS2g,108
+PyYAML-5.4.1.dist-info/top_level.txt,sha256=rpj0IVMTisAjh_1vG3Ccf9v5jpCQwAz6cD1IVU5ZdhQ,11
+_yaml/__init__.py,sha256=04Ae_5osxahpJHa3XBZUAf4wi6XX32gR8D6X6p64GEA,1402
+_yaml/__pycache__/__init__.cpython-38.pyc,,
+yaml/__init__.py,sha256=gfp2CbRVhzknghkiiJD2l6Z0pI-mv_iZHPSJ4aj0-nY,13170
+yaml/__pycache__/__init__.cpython-38.pyc,sha256=n0YyVkjiOLmcjlR2NXE5TIZf7Z2clZ6sqQ5KlyuTWSI,11845
+yaml/__pycache__/composer.cpython-38.pyc,sha256=OVPzAKAvC2-Tiv4HUwUUG9JHCzG17nvsRQcFTCtY9xs,3563
+yaml/__pycache__/constructor.cpython-38.pyc,sha256=EXPDY7Prtv3F6QbXiJc5F4BvJQyCCGRu83WF4u6X7Vo,20822
+yaml/__pycache__/cyaml.cpython-38.pyc,sha256=wI01UFU-WhUcdnnczL5QpKu0ZNQTttSzXbleIvIfcvM,3411
+yaml/__pycache__/dumper.cpython-38.pyc,sha256=9wIctrlMpF4ksMWuCc5QAyZSenGiRVyrtU-1pAfj54U,1823
+yaml/__pycache__/emitter.cpython-38.pyc,sha256=kd_QGJd0GjpfgQPN9DlG_7HwKfJnJ24JxtdiUOxM9iE,25353
+yaml/__pycache__/error.cpython-38.pyc,sha256=j6mkXgDmzV0y0lo6FeUrvZL2vHN6Vkc52k0_R0oOn6g,2300
+yaml/__pycache__/events.cpython-38.pyc,sha256=NFsoAO36pPL_uxoCO-xRxKndQ3vx47mkStOYjfoQVZ8,3974
+yaml/__pycache__/loader.cpython-38.pyc,sha256=lEMB2brjPrfMjXXTJpCEx6-ct4eI6LYovD4hW5ZuGsw,2164
+yaml/__pycache__/nodes.cpython-38.pyc,sha256=Kkxh_oL04gQg-YFWwnfjpIoYspsXO4GEqKTr3NbxOD8,1725
+yaml/__pycache__/parser.cpython-38.pyc,sha256=0R9Qx0cBMUoOLzMOWeXCyXsC4S4KJ7oPHdmTVPQ4FbQ,11924
+yaml/__pycache__/reader.cpython-38.pyc,sha256=ZpOMJ6rZDc8EWffI4vZR_Fhcu3WmhgT_GAkDrKkEtPo,4537
+yaml/__pycache__/representer.cpython-38.pyc,sha256=tR9wWffCThWXwQe47uYFdHg2bCkqNjBcwmG7RSHmWS4,10069
+yaml/__pycache__/resolver.cpython-38.pyc,sha256=zsLBuCKn8KAJPVGo5J_xZSytifJktdTtkUNnltOt__I,5498
+yaml/__pycache__/scanner.cpython-38.pyc,sha256=N8ubxRd6bZBjoRna6CU8wK1Imb_7TWOsudzPh9JDDkQ,25269
+yaml/__pycache__/serializer.cpython-38.pyc,sha256=9JDH7ONP5zFlep0f2yNWRoOSZr5Y28jL012O1EIbuug,3320
+yaml/__pycache__/tokens.cpython-38.pyc,sha256=haBW6UBDhVFog2xIe63OkrAP_9JRFyNKCROFPRJiyu0,4935
+yaml/_yaml.cpython-38-x86_64-linux-gnu.so,sha256=fxjEXaSdzion1SMwhu9Ikx-JOVNtcl6KvW_pyGBt-cU,2342916
+yaml/composer.py,sha256=_Ko30Wr6eDWUeUpauUGT3Lcg9QPBnOPVlTnIMRGJ9FM,4883
+yaml/constructor.py,sha256=kNgkfaeLUkwQYY_Q6Ff1Tz2XVw_pG1xVE9Ak7z-viLA,28639
+yaml/cyaml.py,sha256=6ZrAG9fAYvdVe2FK_w0hmXoG7ZYsoYUwapG8CiC72H0,3851
+yaml/dumper.py,sha256=PLctZlYwZLp7XmeUdwRuv4nYOZ2UBnDIUy8-lKfLF-o,2837
+yaml/emitter.py,sha256=jghtaU7eFwg31bG0B7RZea_29Adi9CKmXq_QjgQpCkQ,43006
+yaml/error.py,sha256=Ah9z-toHJUbE9j-M8YpxgSRM5CgLCcwVzJgLLRF2Fxo,2533
+yaml/events.py,sha256=50_TksgQiE4up-lKo_V-nBy-tAIxkIPQxY5qDhKCeHw,2445
+yaml/loader.py,sha256=UVa-zIqmkFSCIYq_PgSGm4NSJttHY2Rf_zQ4_b1fHN0,2061
+yaml/nodes.py,sha256=gPKNj8pKCdh2d4gr3gIYINnPOaOxGhJAUiYhGRnPE84,1440
+yaml/parser.py,sha256=ilWp5vvgoHFGzvOZDItFoGjD6D42nhlZrZyjAwa0oJo,25495
+yaml/reader.py,sha256=0dmzirOiDG4Xo41RnuQS7K9rkY3xjHiVasfDMNTqCNw,6794
+yaml/representer.py,sha256=82UM3ZxUQKqsKAF4ltWOxCS6jGPIFtXpGs7mvqyv4Xs,14184
+yaml/resolver.py,sha256=Z1W8AOMA6Proy4gIO2OhUO4IPS_bFNAl0Ca3rwChpPg,8999
+yaml/scanner.py,sha256=KeQIKGNlSyPE8QDwionHxy9CgbqE5teJEz05FR9-nAg,51277
+yaml/serializer.py,sha256=ChuFgmhU01hj4xgI8GaKv6vfM2Bujwa9i7d2FAHj7cA,4165
+yaml/tokens.py,sha256=lTQIzSVw8Mg9wv459-TjiOQe6wVziqaRlqX2_89rp54,2573
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/WHEEL b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..69d594f055a5127401ebe017f8837cef4c76c020
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.36.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-manylinux1_x86_64
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/top_level.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e6475e911f628412049bc4090d86f23ac403adde
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/PyYAML-5.4.1.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_yaml
+yaml
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/_yaml/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/_yaml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7baa8c4b68127d5cdf0be9a799429e61347c2694
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/_yaml/__init__.py
@@ -0,0 +1,33 @@
+# This is a stub package designed to roughly emulate the _yaml
+# extension module, which previously existed as a standalone module
+# and has been moved into the `yaml` package namespace.
+# It does not perfectly mimic its old counterpart, but should get
+# close enough for anyone who's relying on it even when they shouldn't.
+import yaml
+
+# in some circumstances, the yaml module we imoprted may be from a different version, so we need
+# to tread carefully when poking at it here (it may not have the attributes we expect)
+if not getattr(yaml, '__with_libyaml__', False):
+    from sys import version_info
+
+    exc = ModuleNotFoundError if version_info >= (3, 6) else ImportError
+    raise exc("No module named '_yaml'")
+else:
+    from yaml._yaml import *
+    import warnings
+    warnings.warn(
+        'The _yaml extension module is now located at yaml._yaml'
+        ' and its location is subject to change.  To use the'
+        ' LibYAML-based parser and emitter, import from `yaml`:'
+        ' `from yaml import CLoader as Loader, CDumper as Dumper`.',
+        DeprecationWarning
+    )
+    del warnings
+    # Don't `del yaml` here because yaml is actually an existing
+    # namespace member of _yaml.
+
+__name__ = '_yaml'
+# If the module is top-level (i.e. not a part of any specific package)
+# then the attribute should be set to ''.
+# https://docs.python.org/3.8/library/types.html
+__package__ = ''
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/INSTALLER b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/LICENSE.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/METADATA b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..cd45af9374c8209252a546c5a4c5a4221c8fb8af
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/METADATA
@@ -0,0 +1,263 @@
+Metadata-Version: 2.1
+Name: ops
+Version: 1.1.0
+Summary: The Python library behind great charms
+Home-page: https://github.com/canonical/operator
+Author: The Charmcraft team at Canonical Ltd.
+Author-email: charmcraft@lists.launchpad.net
+License: Apache-2.0
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+Requires-Dist: PyYAML
+
+# The Operator Framework
+
+This Operator Framework simplifies [Kubernetes
+operator](https://charmhub.io/about) development for 
+[model-driven application
+management](https://juju.is/model-driven-operations).
+
+A Kubernetes operator is a container that drives lifecycle management,
+configuration, integration and daily actions for an application.
+Operators simplify software management and operations. They capture
+reusable app domain knowledge from experts in a software component that
+can be shared.
+
+This project extends the operator pattern to enable 
+[universal operators](https://juju.is/universal-operators), not just
+for Kubernetes but also operators for traditional Linux or Windows
+application management.
+
+Operators use an [Operator Lifecycle Manager
+(OLM)](https://juju.is/operator-lifecycle-manager) to coordinate their
+work in a cluster. The system uses Golang for concurrent event
+processing under the hood, but enables the operators to be written in
+Python.
+
+## Simple, composable operators
+
+Operators should 'do one thing and do it well'. Each operator drives a
+single microservice and can be [composed with other 
+operators](https://juju.is/integration) to deliver a complex application.
+
+It is better to have small, reusable operators that each drive a single
+microservice very well. The operator handles instantiation, scaling,
+configuration, optimisation, networking, service mesh, observability,
+and day-2 operations specific to that microservice.
+
+Operator composition takes place through declarative integration in
+the OLM. Operators declare integration endpoints, and discover lines of
+integration between those endpoints dynamically at runtime.
+
+## Pure Python operators
+
+The framework provides a standard Python library and object model that
+represents the application graph, and an event distribution mechanism for
+distributed system coordination and communication.
+
+The OLM is written in Golang for efficient concurrency in event handling
+and distribution. Operators can be written in any language. We recommend
+this Python framework for ease of design, development and collaboration.
+
+## Better collaboration
+
+Operator developers publish Python libraries that make it easy to integrate
+your operator with their operator. The framework includes standard tools
+to distribute these integration libraries and keep them up to date.
+
+Development collaboration happens at [Charmhub.io](https://charmhub.io/) where
+operators are published along with integration libraries. Design and
+code review discussions are hosted in the
+[Charmhub forum](https://discourse.charmhub.io/). We recommend the
+[Open Operator Manifesto](https://charmhub.io/manifesto) as a guideline for
+high quality operator engineering.
+
+## Event serialization and operator services
+
+Distributed systems can be hard! So this framework exists to make it much
+simpler to reason about operator behaviour, especially in complex deployments.
+The OLM provides [operator services](https://juju.is/operator-services) such
+as provisioning, event delivery, leader election and model management.
+
+Coordination between operators is provided by a cluster-wide event
+distribution system. Events are serialized to avoid race conditions in any
+given container or machine. This greatly simplifies the development of
+operators for high availability, scale-out and integrated applications.
+
+## Model-driven Operator Lifecycle Manager
+
+A key goal of the project is to improve the user experience for admins
+working with multiple different operators.
+
+We embrace [model-driven operations](https://juju.is/model-driven-operations)
+in the Operator Lifecycle Manager. The model encompasses capacity,
+storage, networking, the application graph and administrative access.
+
+Admins describe the application graph of integrated microservices, and
+the OLM then drives instantiation. A change in the model is propagated
+to all affected operators, reducing the duplication of effort and
+repetition normally found in operating a complex topology of services.
+
+Administrative actions, updates, configuration and integration are all
+driven through the OLM.
+
+# Getting started
+
+A package of operator code is called a charm. You will use `charmcraft`
+to register your operator name, and publish it when you are ready.
+
+```
+$ sudo snap install charmcraft --beta
+charmcraft (beta) 0.6.0 from John Lenton (chipaca) installed
+```
+
+Charms written using the operator framework are just Python code. The goal
+is to feel natural for somebody used to coding in Python, and reasonably
+easy to learn for somebody who is not a pythonista.
+
+The dependencies of the operator framework are kept as minimal as possible;
+currently that's Python 3.5 or greater, and `PyYAML` (both are included by
+default in Ubuntu's cloud images from 16.04 on).
+
+# A quick introduction
+
+Make an empty directory `my-charm` and cd into it. Then start a new charm
+with:
+
+```
+$ charmcraft init
+All done.
+There are some notes about things we think you should do.
+These are marked with ‘TODO:’, as is customary. Namely:
+      README.md: fill out the description
+      README.md: explain how to use the charm
+  metadata.yaml: fill out the charm's description
+  metadata.yaml: fill out the charm's summary
+```
+
+Charmed operators are just Python code. The entry point to your charm can
+be any filename, by default this is `src/charm.py` which must be executable
+(and probably have `#!/usr/bin/env python3` on the first line).
+
+You need a `metadata.yaml` to describe your charm, and if you will support
+configuration of your charm then `config.yaml` files is required too. The
+`requirements.txt` specifies any Python dependencies.
+
+```
+$ tree my-charm/
+my-charm/
+├── actions.yaml
+├── config.yaml
+├── LICENSE
+├── metadata.yaml
+├── README.md
+├── requirements-dev.txt
+├── requirements.txt
+├── run_tests
+├── src
+│   └── charm.py
+├── tests
+│   ├── __init__.py
+│   └── my_charm.py
+```
+
+`src/charm.py` here is the entry point to your charm code. At a minimum, it
+needs to define a subclass of `CharmBase` and pass that into the framework
+`main` function:
+
+```python
+from ops.charm import CharmBase
+from ops.main import main
+
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.start, self.on_start)
+
+    def on_start(self, event):
+        # Handle the start event here.
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+That should be enough for you to be able to run
+
+```
+$ charmcraft build
+Done, charm left in 'my-charm.charm'
+$ juju deploy ./my-charm.charm
+```
+
+> 🛈 More information on [`charmcraft`](https://pypi.org/project/charmcraft/) can
+> also be found on its [github page](https://github.com/canonical/charmcraft).
+
+Happy charming!
+
+# Testing your charms
+
+The operator framework provides a testing harness, so you can check your
+charm does the right thing in different scenarios, without having to create
+a full deployment. `pydoc3 ops.testing` has the details, including this
+example:
+
+```python
+harness = Harness(MyCharm)
+# Do initial setup here
+relation_id = harness.add_relation('db', 'postgresql')
+# Now instantiate the charm to see events as the model changes
+harness.begin()
+harness.add_relation_unit(relation_id, 'postgresql/0')
+harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+# Check that charm has properly handled the relation_joined event for postgresql/0
+self.assertEqual(harness.charm. ...)
+```
+
+## Talk to us
+
+If you need help, have ideas, or would just like to chat with us, reach out on
+IRC: we're in [#smooth-operator] on freenode (or try the [webchat]).
+
+We also pay attention to [Charmhub discourse](https://discourse.charmhub.io/)
+
+You can also deep dive into the [API docs] if that's your thing.
+
+[webchat]: https://webchat.freenode.net/#smooth-operator
+[#smooth-operator]: irc://chat.freenode.net/%23smooth-operator
+[discourse]: https://discourse.juju.is/c/charming
+[API docs]: https://ops.rtfd.io/
+
+## Operator Framework development
+
+To work in the framework itself you will need Python >= 3.5 and the
+dependencies in `requirements-dev.txt` installed in your system, or a
+virtualenv:
+
+    virtualenv --python=python3 env
+    source env/bin/activate
+    pip install -r requirements-dev.txt
+
+Then you can try `./run_tests`, it should all go green.
+
+For improved performance on the tests, ensure that you have PyYAML
+installed with the correct extensions:
+
+    apt-get install libyaml-dev
+    pip install --force-reinstall --no-cache-dir pyyaml
+
+If you want to build the documentation you'll need the requirements from
+`docs/requirements.txt`, or in your virtualenv
+
+    pip install -r docs/requirements.txt
+
+and then you can run `./build_docs`.
+
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/RECORD b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..35eb15f5359c1b967188c151b20fdcbc2d251c27
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/RECORD
@@ -0,0 +1,28 @@
+ops-1.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ops-1.1.0.dist-info/LICENSE.txt,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+ops-1.1.0.dist-info/METADATA,sha256=ffVuqPnEob6-iBYjEf3lPShSbToJL17obFFufoW2F4g,9485
+ops-1.1.0.dist-info/RECORD,,
+ops-1.1.0.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+ops-1.1.0.dist-info/top_level.txt,sha256=enC05wWafSg8iDKIvj3gvtAtEP2kYCyN5Gmd689q-_I,4
+ops/__init__.py,sha256=WaHb0dfp1KEe6jFV8Pm_mcdJ3ModiWujnQ6xLjNzPNQ,819
+ops/__pycache__/__init__.cpython-38.pyc,,
+ops/__pycache__/charm.cpython-38.pyc,,
+ops/__pycache__/framework.cpython-38.pyc,,
+ops/__pycache__/jujuversion.cpython-38.pyc,,
+ops/__pycache__/log.cpython-38.pyc,,
+ops/__pycache__/main.cpython-38.pyc,,
+ops/__pycache__/model.cpython-38.pyc,,
+ops/__pycache__/storage.cpython-38.pyc,,
+ops/__pycache__/testing.cpython-38.pyc,,
+ops/__pycache__/version.cpython-38.pyc,,
+ops/charm.py,sha256=7KyaNNA0t_a0h0hrzehSEWm4xU_Y5JIqGWHTg747qfU,32817
+ops/framework.py,sha256=1ByOtFKRR6kRzOEbfWnGEMNevixOYf18U0oZxKq8LsA,43769
+ops/jujuversion.py,sha256=9wMlUmngcAENV9RkgVVLWtZsyRQaf6XNrQQqUeY_fHA,4139
+ops/lib/__init__.py,sha256=QizPpuRWXjqbH5Gv7mnH8CcPR9BX7q2YNFnxyoSsA0g,9213
+ops/lib/__pycache__/__init__.cpython-38.pyc,,
+ops/log.py,sha256=JVpt_Vkf_lWO2cucUcJfXjAWVTattk4xBscSs65Sn3I,2155
+ops/main.py,sha256=BUJZM4soFpsY4bO6zJ1bSHQeWJcm028gq0MhJT3rC8M,15523
+ops/model.py,sha256=yvM1yhidNyGpVdxkG365jPJRhQuE42EiiojBHJ7tL3c,47930
+ops/storage.py,sha256=jEfszzQGYDrl5wa03I6txvea-7lI661Yq6n7sIPa0fU,14192
+ops/testing.py,sha256=sH8PoNzGmfPdVWM1lBjStxHcNfQHsasFjF-WzHfDhFA,34898
+ops/version.py,sha256=UuaLFU_UN-InNFu4I23Y22huxQdbsOgTQ_d_r623fx4,46
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/WHEEL b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/top_level.txt b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops-1.1.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/charm.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..82ed2fdd8b85d423eb8645bddb4b64426ad180e1
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/charm.py
@@ -0,0 +1,823 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Base objects for the Charm, events and metadata."""
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """Events raised by Juju to progress a charm's lifecycle.
+
+    Hooks are callback methods of a charm class (a subclass of
+    :class:`CharmBase`) that are invoked in response to events raised
+    by Juju. These callback methods are the means by which a charm
+    governs the lifecycle of its application.
+
+    The :class:`HookEvent` class is the base of a type hierarchy of events
+    related to the charm's lifecycle.
+
+    :class:`HookEvent` subtypes are grouped into the following categories
+
+    - Core lifecycle events
+    - Relation events
+    - Storage events
+    - Metric events
+    """
+
+
+class ActionEvent(EventBase):
+    """Events raised by Juju when an administrator invokes a Juju Action.
+
+    This class is the data type of events triggered when an administrator
+    invokes a Juju Action. Callbacks bound to these events may be used
+    for responding to the administrator's Juju Action request.
+
+    To read the parameters for the action, see the instance variable :attr:`params`.
+    To respond with the result of the action, call :meth:`set_results`. To add
+    progress messages that are visible as the action is progressing use
+    :meth:`log`.
+
+    Attributes:
+        params: The parameters passed to the action.
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the administrator
+        is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Event triggered when a charm is installed.
+
+    This event is triggered at the beginning of a charm's
+    lifecycle. Any associated callback method should be used to
+    perform one-time setup operations, such as installing prerequisite
+    software.
+    """
+
+
+class StartEvent(HookEvent):
+    """Event triggered immediately after first configuation change.
+
+    This event is triggered immediately after the first
+    :class:`ConfigChangedEvent`. Callback methods bound to the event should be
+    used to ensure that the charm’s software is in a running state. Note that
+    the charm’s software should be configured so as to persist in this state
+    through reboots without further intervention on Juju’s part.
+    """
+
+
+class StopEvent(HookEvent):
+    """Event triggered when a charm is shut down.
+
+    This event is triggered when an application's removal is requested
+    by the client. The event fires immediately before the end of the
+    unit’s destruction sequence. Callback methods bound to this event
+    should be used to ensure that the charm’s software is not running,
+    and that it will not start again on reboot.
+    """
+
+
+class RemoveEvent(HookEvent):
+    """Event triggered when a unit is about to be terminated.
+
+    This event fires prior to Juju removing the charm and terminating its unit.
+    """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Event triggered when a configuration change is requested.
+
+    This event fires in several different situations.
+
+    - immediately after the :class:`install <InstallEvent>` event.
+    - after a :class:`relation is created <RelationCreatedEvent>`.
+    - after a :class:`leader is elected <LeaderElectedEvent>`.
+    - after changing charm configuration using the GUI or command line
+      interface
+    - when the charm :class:`starts <StartEvent>`.
+    - when a new unit :class:`joins a relation <RelationJoinedEvent>`.
+    - when there is a :class:`change to an existing relation <RelationChangedEvent>`.
+
+    Any callback method bound to this event cannot assume that the
+    software has already been started; it should not start stopped
+    software, but should (if appropriate) restart running software to
+    take configuration changes into account.
+    """
+
+
+class UpdateStatusEvent(HookEvent):
+    """Event triggered by a status update request from Juju.
+
+    This event is periodically triggered by Juju so that it can
+    provide constant feedback to the administrator about the status of
+    the application the charm is modeling. Any callback method bound
+    to this event should determine the "health" of the application and
+    set the status appropriately.
+
+    The interval between :class:`update-status <UpdateStatusEvent>` events can
+    be configured model-wide, e.g.  ``juju model-config
+    update-status-hook-interval=1m``.
+    """
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Event triggered by request to upgrade the charm.
+
+    This event will be triggered when an administrator executes ``juju
+    upgrade-charm``. The event fires after Juju has unpacked the upgraded charm
+    code, and so this event will be handled by the callback method bound to the
+    event in the new codebase. The associated callback method is invoked
+    provided there is no existing error state. The callback method should be
+    used to reconcile current state written by an older version of the charm
+    into whatever form that is needed by the current charm version.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Event triggered to prepare a unit for series upgrade.
+
+    This event triggers when an administrator executes ``juju upgrade-series
+    MACHINE prepare``. The event will fire for each unit that is running on the
+    specified machine. Any callback method bound to this event must prepare the
+    charm for an upgrade to the series. This may include things like exporting
+    database content to a version neutral format, or evacuating running
+    instances to other machines.
+
+    It can be assumed that only after all units on a machine have executed the
+    callback method associated with this event, the administrator will initiate
+    steps to actually upgrade the series.  After the upgrade has been completed,
+    the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Event triggered after a series upgrade.
+
+    This event is triggered after the administrator has done a distribution
+    upgrade (or rolled back and kept the same series). It is called in response
+    to ``juju upgrade-series MACHINE complete``. Associated charm callback
+    methods are expected to do whatever steps are necessary to reconfigure their
+    applications for the new series. This may include things like populating the
+    upgraded version of a database. Note however charms are expected to check if
+    the series has actually changed or whether it was rolled back to the
+    original series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Event triggered when a new leader has been elected.
+
+    Juju will trigger this event when a new leader unit is chosen for
+    a given application.
+
+    This event fires at least once after Juju selects a leader
+    unit. Callback methods bound to this event may take any action
+    required for the elected unit to assert leadership. Note that only
+    the elected leader unit will receive this event.
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Event triggered when leader changes any settings.
+
+    DEPRECATED NOTICE
+
+    This event has been deprecated in favor of using a Peer relation,
+    and having the leader set a value in the Application data bag for
+    that peer relation.  (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Event triggered by Juju to collect metrics.
+
+    Juju fires this event every five minutes for the lifetime of the
+    unit. Callback methods bound to this event may use the :meth:`add_metrics`
+    method of this class to send measurements to Juju.
+
+    Note that associated callback methods are currently sandboxed in
+    how they can interact with Juju.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Relation lifecycle events are generated when application units
+    participate in relations.  Units can only participate in relations
+    after they have been "started", and before they have been
+    "stopped". Within that time window, the unit may participate in
+    several different relations at a time, including multiple
+    relations with the same name.
+
+    Attributes:
+        relation: The :class:`~ops.model.Relation` involved in this event
+        app: The remote :class:`~ops.model.Application` that has triggered this
+             event
+        unit: The remote unit that has triggered this event. This may be
+              ``None`` if the relation event was triggered as an
+              :class:`~ops.model.Application` level event
+
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Event triggered when a new relation is created.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Event triggered when a new unit joins a relation.
+
+    This event is triggered whenever a new unit of a related
+    application joins the relation.  The event fires only when that
+    remote unit is first observed by the unit. Callback methods bound
+    to this event may set any local unit settings that can be
+    determined using no more than the name of the joining unit and the
+    remote ``private-address`` setting, which is always available when
+    the relation is created and is by convention not deleted.
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Event triggered when relation data changes.
+
+    This event is triggered whenever there is a change to the data bucket for a
+    related application or unit. Look at ``event.relation.data[event.unit/app]``
+    to see the new information, where ``event`` is the event object passed to
+    the callback method bound to this event.
+
+    This event always fires once, after :class:`RelationJoinedEvent`, and
+    will subsequently fire whenever that remote unit changes its settings for
+    the relation. Callback methods bound to this event should be the only ones
+    that rely on remote relation settings. They should not error if the settings
+    are incomplete, since it can be guaranteed that when the remote unit or
+    application changes its settings, the event will fire again.
+
+    The settings that may be queried, or set, are determined by the relation’s
+    interface.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Event triggered when a unit leaves a relation.
+
+    This is the inverse of the :class:`RelationJoinedEvent`, representing when a
+    unit is leaving the relation (the unit is being removed, the app is being
+    removed, the relation is being removed). It is fired once for each unit that
+    is going away.
+
+    When the remote unit is known to be leaving the relation, this will result
+    in the :class:`RelationChangedEvent` firing at least once, after which the
+    :class:`RelationDepartedEvent` will fire. The :class:`RelationDepartedEvent`
+    will fire once only. Once the :class:`RelationDepartedEvent` has fired no
+    further :class:`RelationChangedEvent` will fire.
+
+    Callback methods bound to this event may be used to remove all
+    references to the departing remote unit, because there’s no
+    guarantee that it’s still part of the system; it’s perfectly
+    probable (although not guaranteed) that the system running that
+    unit has already shut down.
+
+    Once all callback methods bound to this event have been run for such a
+    relation, the unit agent will fire the :class:`RelationBrokenEvent`.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Event triggered when a relation is removed.
+
+    If a relation is being removed (``juju remove-relation`` or ``juju
+    remove-application``), once all the units have been removed, this event will
+    fire to signal that the relationship has been fully terminated.
+
+    The event indicates that the current relation is no longer valid, and that
+    the charm’s software must be configured as though the relation had never
+    existed. It will only be called after every callback method bound to
+    :class:`RelationDepartedEvent` has been run. If a callback method
+    bound to this event is being executed, it is gauranteed that no remote units
+    are currently known locally.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing storage-related events.
+
+    Juju can provide a variety of storage types to a charms. The
+    charms can define several different types of storage that are
+    allocated from Juju. Changes in state of storage trigger sub-types
+    of :class:`StorageEvent`.
+    """
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Event triggered when new storage becomes available.
+
+    This event is triggered when new storage is available for the
+    charm to use.
+
+    Callback methods bound to this event allow the charm to run code
+    when storage has been added. Such methods will be run before the
+    :class:`InstallEvent` fires, so that the installation routine may
+    use the storage. The name prefix of this hook will depend on the
+    storage key defined in the ``metadata.yaml`` file.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Event triggered prior to removal of storage.
+
+    This event is triggered when storage a charm has been using is
+    going away.
+
+    Callback methods bound to this event allow the charm to run code
+    before storage is removed. Such methods will be run before storage
+    is detached, and always before the :class:`StopEvent` fires, thereby
+    allowing the charm to gracefully release resources before they are
+    removed and before the unit terminates. The name prefix of the
+    hook will depend on the storage key defined in the ``metadata.yaml``
+    file.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """Events generated by Juju pertaining to application lifecycle.
+
+    This class is used to create an event descriptor (``self.on``) attribute for
+    a charm class that inherits from :class:`CharmBase`. The event descriptor
+    may be used to set up event handlers for corresponding events.
+
+    By default the following events will be provided through
+    :class:`CharmBase`::
+
+        self.on.install
+        self.on.start
+        self.on.remove
+        self.on.update_status
+        self.on.config_changed
+        self.on.upgrade_charm
+        self.on.pre_series_upgrade
+        self.on.post_series_upgrade
+        self.on.leader_elected
+        self.on.collect_metrics
+
+
+    In addition to these, depending on the charm's metadata (``metadata.yaml``),
+    named relation and storage events may also be defined.  These named events
+    are created by :class:`CharmBase` using charm metadata.  The named events may be
+    accessed as ``self.on[<name>].<relation_or_storage_event>``
+    """
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the charm overall.
+
+    :class:`CharmBase` is used to create a charm. This is done by inheriting
+    from :class:`CharmBase` and customising the sub class as required. So to
+    create your own charm, say ``MyCharm``, define a charm class and set up the
+    required event handlers (“hooks”) in its constructor::
+
+        import logging
+
+        from ops.charm import CharmBase
+        from ops.main import main
+
+        logger = logging.getLogger(__name__)
+
+        def MyCharm(CharmBase):
+            def __init__(self, *args):
+                logger.debug('Initializing Charm')
+
+                super().__init__(*args)
+
+                self.framework.observe(self.on.config_changed, self._on_config_changed)
+                self.framework.observe(self.on.stop, self._on_stop)
+                # ...
+
+        if __name__ == "__main__":
+            main(MyCharm)
+
+    As shown in the example above, a charm class is instantiated by
+    :func:`~ops.main.main` rather than charm authors directly instantiating a
+    charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+
+    """
+
+    # note that without the #: below, sphinx will copy the whole of CharmEvents
+    # docstring inline which is less than ideal.
+    #: Used to set up event handlers; see :class:`CharmEvents`.
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """Metadata of this charm."""
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the charm as it is running."""
+        return self.framework.charm_dir
+
+    @property
+    def config(self) -> model.ConfigData:
+        """A mapping containing the charm's config and current values."""
+        return self.model.config
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from ``metadata.yaml`` and/or ``actions.yaml``. Generally
+    charms will define this information, rather than reading it at runtime. This
+    class is mostly for the framework to understand what the charm has defined.
+
+    The :attr:`maintainers`, :attr:`tags`, :attr:`terms`, :attr:`series`, and
+    :attr:`extra_bindings` attributes are all lists of strings.  The
+    :attr:`requires`, :attr:`provides`, :attr:`peers`, :attr:`relations`,
+    :attr:`storages`, :attr:`resources`, and :attr:`payloads` attributes are all
+    mappings of names to instances of the respective :class:`RelationMeta`,
+    :class:`StorageMeta`, :class:`ResourceMeta`, or :class:`PayloadMeta`.
+
+    The :attr:`relations` attribute is a convenience accessor which includes all
+    of the ``requires``, ``provides``, and ``peers`` :class:`RelationMeta`
+    items.  If needed, the role of the relation definition can be obtained from
+    its :attr:`role <RelationMeta.role>` attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+            if raw_actions is None:
+                raw_actions = {}
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    """An annotation for a charm's role in a relation.
+
+    For each relation a charm's role may be
+
+    - A Peer
+    - A service consumer in the relation ('requires')
+    - A service provider in the relation ('provides')
+    """
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is :class:`RelationRole`; one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition.
+
+    Attributes:
+        storage_name: Name of storage
+        type: Storage type
+        description: A text description of the storage
+        read_only: Whether or not the storage is read only
+        minimum_size: Minimum size of storage
+        location: Mount point of storage
+        multiple_range: Range of numeric qualifiers when multiple storage units are used
+    """
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition.
+
+    Attributes:
+        resource_name: Name of resource
+        filename: Name of file
+        description: A text description of resource
+    """
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition.
+
+    Attributes:
+        payload_name: Name of payload
+        type: Payload type
+    """
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/framework.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/framework.py
new file mode 100644
index 0000000000000000000000000000000000000000..d20c0007ebcd58456a0bac90ae5dc0eaacb9a407
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/framework.py
@@ -0,0 +1,1199 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework infrastructure."""
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        """Create a new handle as child of the current one."""
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        """Return own parent handle."""
+        return self._parent
+
+    @property
+    def kind(self):
+        """Return the handle's kind."""
+        return self._kind
+
+    @property
+    def key(self):
+        """Return the handle's key."""
+        return self._key
+
+    @property
+    def path(self):
+        """Return the handle's path."""
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        """Build a handle from the indicated path."""
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+    """The base for all the different Events.
+
+    Inherit this and override 'snapshot' and 'restore' methods to build a custom event.
+    """
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def __repr__(self):
+        return "<%s via %s>" % (self.__class__.__name__, self.handle)
+
+    def defer(self):
+        """Defer the event to the future.
+
+        Deferring an event from a handler puts that handler into a queue, to be
+        called again the next time the charm is invoked. This invocation may be
+        the result of an action, or any event other than metric events. The
+        queue of events will be dispatched before the new event is processed.
+
+        From the above you may deduce, but it's important to point out:
+
+        * ``defer()`` does not interrupt the execution of the current event
+          handler. In almost all cases, a call to ``defer()`` should be followed
+          by an explicit ``return`` from the handler;
+
+        * the re-execution of the deferred event handler starts from the top of
+          the handler method (not where defer was called);
+
+        * only the handlers that actually called ``defer()`` are called again
+          (that is: despite talking about “deferring an event” it is actually
+          the handler/event combination that is deferred); and
+
+        * any deferred events get processed before the event (or action) that
+          caused the current invocation of the charm.
+
+        The general desire to call ``defer()`` happens when some precondition
+        isn't yet met. However, care should be exercised as to whether it is
+        better to defer this event so that you see it again, or whether it is
+        better to just wait for the event that indicates the precondition has
+        been met.
+
+        For example, if ``config-changed`` is fired, and you are waiting for
+        different config, there is no reason to defer the event because there
+        will be a *different* ``config-changed`` event when the config actually
+        changes, rather than checking to see if maybe config has changed prior
+        to every other event that occurs.
+
+        Similarly, if you need 2 events to occur before you are ready to
+        proceed (say event A and B). When you see event A, you could chose to
+        ``defer()`` it because you haven't seen B yet. However, that leads to:
+
+        1. event A fires, calls defer()
+
+        2. event B fires, event A handler is called first, still hasn't seen B
+           happen, so is deferred again. Then B happens, which progresses since
+           it has seen A.
+
+        3. At some future time, event C happens, which also checks if A can
+           proceed.
+
+        """
+        logger.debug("Deferring %s.", self)
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+    """Event bound to an Object."""
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+    """Base class of all the charm-related objects."""
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        """Shortcut for more simple access the model."""
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def _event_kinds(self):
+        event_kinds = []
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kinds.append(attr_name)
+        return event_kinds
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events."""
+        return {event_kind: getattr(self, event_kind) for event_kind in self._event_kinds()}
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+    def __repr__(self):
+        k = type(self)
+        event_kinds = ', '.join(sorted(self._event_kinds()))
+        return '<{}.{}: {}>'.format(k.__module__, k.__qualname__, event_kinds)
+
+
+class PrefixedEvents:
+    """Events to be found in all events using a specific prefix."""
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    """Events that will be emited first on commit."""
+
+
+class CommitEvent(EventBase):
+    """Events that will be emited second on commit."""
+
+
+class FrameworkEvents(ObjectEvents):
+    """Manager of all framework events."""
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+    """No class to hold it was found when restoring an event."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+    """Main interface to from the Charm to the Operator Framework internals."""
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse the env var once, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def set_breakpointhook(self):
+        """Hook into sys.breakpointhook so the builtin breakpoint() works as expected.
+
+        This method is called by ``main``, and is not intended to be
+        called by users of the framework itself outside of perhaps
+        some testing scenarios.
+
+        It returns the old value of sys.excepthook.
+
+        The breakpoint function is a Python >= 3.7 feature.
+
+        This method was added in ops 1.0; before that, it was done as
+        part of the Framework's __init__.
+        """
+        old_breakpointhook = getattr(sys, 'breakpointhook', None)
+        if old_breakpointhook is not None:
+            # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+            # breakpoint()
+            sys.breakpointhook = self.breakpoint
+        return old_breakpointhook
+
+    def close(self):
+        """Close the underlying backends."""
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        """Save changes to the underlying backends."""
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        """Register a type to a handle."""
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        """Load a persistent snapshot."""
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        """Discard a persistent snapshot."""
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style::
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as::
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                if single_event_path is None:
+                    logger.debug("Re-emitting %s.", event)
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+    """Manager of the stored data."""
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        """Return the current state."""
+        return self._cache
+
+    def restore(self, snapshot):
+        """Restore current state to the given snapshot."""
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        """Save changes to the storage backend."""
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+    """Stored state data bound to a specific Object."""
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """Set the value of any given key if it has not already been set."""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+def _wrapped_repr(obj):
+    t = type(obj)
+    if obj._under:
+        return "{}.{}({!r})".format(t.__module__, t.__name__, obj._under)
+    else:
+        return "{}.{}()".format(t.__module__, t.__name__)
+
+
+class StoredDict(collections.abc.MutableMapping):
+    """A dict-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
+
+
+class StoredList(collections.abc.MutableSequence):
+    """A list-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        """Insert value before index."""
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        """Append value to the end of the list."""
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
+
+
+class StoredSet(collections.abc.MutableSet):
+    """A set-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        """Add a key to a set.
+
+        This has no effect if the key is already present.
+        """
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        """Remove a key from a set if it is a member.
+
+        If the key is not a member, do nothing.
+        """
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/jujuversion.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/jujuversion.py
new file mode 100644
index 0000000000000000000000000000000000000000..61d420d369d9b0e75b9c2c242574ddcd4b89be51
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/jujuversion.py
@@ -0,0 +1,114 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A helper to work with the Juju version."""
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+    """Helper to work with the Juju version.
+
+    It knows how to parse the ``JUJU_VERSION`` environment variable, and exposes different
+    capabilities according to the specific version, allowing also to compare with other
+    versions.
+    """
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if v is None:
+            v = '0.0.0'
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
+
+    def is_dispatch_aware(self) -> bool:
+        """Determine whether this juju version knows about dispatch."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
+
+    def has_controller_storage(self) -> bool:
+        """Determine whether this juju version supports controller-side storage."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/lib/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..22b5a84e517df8a061b7ca2742678536a481b616
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/lib/__init__.py
@@ -0,0 +1,264 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure for the opslib functionality."""
+
+import logging
+import os
+import re
+import sys
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+from typing import List
+
+__all__ = ('use', 'autoimport')
+
+logger = logging.getLogger(__name__)
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except (FileNotFoundError, NotADirectoryError):
+            continue
+        except OSError as e:
+            logger.debug("Tried to look for ops.lib packages under '%s': %s", sys_dir, e)
+            continue
+        logger.debug("Looking for ops.lib packages under '%s'", sys_dir)
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except (FileNotFoundError, NotADirectoryError):
+                continue
+            except OSError as e:
+                logger.debug("  Tried '%s': %s", opslib, e)  # *lots* of things checked here
+                continue
+            else:
+                logger.debug("  Trying '%s'", opslib)
+            finder = get_importer(opslib)
+            if finder is None:
+                logger.debug("  Finder for '%s' is None", opslib)
+                continue
+            if not hasattr(finder, 'find_spec'):
+                logger.debug("  Finder for '%s' has no find_spec", opslib)
+                continue
+            for lib_dir in lib_dirs:
+                spec_name = "{}.opslib.{}".format(top_dir, lib_dir)
+                spec = finder.find_spec(spec_name)
+                if spec is None:
+                    logger.debug("    No spec for %r", spec_name)
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    logger.debug("    No loader for %r (probably a namespace package)", spec_name)
+                    continue
+
+                logger.debug("    Found %r", spec_name)
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+# these keys, with these types, are needed to have an opslib
+_NEEDED_KEYS = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+
+def _join_and(keys: List[str]) -> str:
+    if len(keys) == 0:
+        return ""
+    if len(keys) == 1:
+        return keys[0]
+    return ", ".join(keys[:-1]) + ", and " + keys[-1]
+
+
+class _Missing:
+    """Helper to get the difference between what was found and what was needed when logging."""
+
+    def __init__(self, found):
+        self._found = found
+
+    def __str__(self):
+        exp = set(_NEEDED_KEYS)
+        got = set(self._found)
+        if len(got) == 0:
+            return "missing {}".format(_join_and(sorted(exp)))
+        return "got {}, but missing {}".format(
+            _join_and(sorted(got)),
+            _join_and(sorted(exp - got)))
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        # "can't happen"
+        logger.warning("No origin for %r (no idea why; please report)", spec.name)
+        return None
+
+    logger.debug("    Parsing %r", spec.name)
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_NEEDED_KEYS):
+                    break
+                if n > _MAX_LIB_LINES:
+                    logger.debug(
+                        "      Missing opslib metadata after reading to line %d: %s",
+                        _MAX_LIB_LINES, _Missing(libinfo))
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _NEEDED_KEYS:
+                    value = literal_eval(value)
+                    if not isinstance(value, _NEEDED_KEYS[key]):
+                        logger.debug(
+                            "      Bad type for %s: expected %s, got %s",
+                            key, _NEEDED_KEYS[key].__name__, type(value).__name__)
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_NEEDED_KEYS):
+                    logger.debug(
+                        "      Missing opslib metadata after reading to end of file: %s",
+                        _Missing(libinfo))
+                    return None
+    except Exception as e:
+        logger.debug("      Failed: %s", e)
+        return None
+
+    lib = _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+    logger.debug("    Success: found library %s", lib)
+
+    return lib
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {}>".format(self)
+
+    def __str__(self):
+        return "{0.name} by {0.author}, API {0.api}, patch {0.patch}".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/log.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..b47013dd597c5500ea763d9e4beada10e6f2ca87
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/log.py
@@ -0,0 +1,58 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Interface to emit messages to the Juju logging system."""
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        """Send the specified logging record to the Juju backend.
+
+        This method is not used directly by the Operator Framework code, but by
+        :class:`logging.Handler` itself as part of the logging machinery.
+        """
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/main.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..f18f88ae0eff807e065e5df778a16cd83ca560eb
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/main.py
@@ -0,0 +1,406 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Main entry point to the Operator Framework."""
+
+import inspect
+import logging
+import os
+import shutil
+import subprocess
+import sys
+import typing
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+from ops.jujuversion import JujuVersion
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _exe_path(path: Path) -> typing.Optional[Path]:
+    """Find and return the full path to the given binary.
+
+    Here path is the absolute path to a binary, but might be missing an extension.
+    """
+    p = shutil.which(path.name, mode=os.F_OK, path=str(path.parent))
+    if p is None:
+        return None
+    return Path(p)
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event, link_to):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    link_to -- What the event link should point to
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        target_path = os.path.relpath(link_to, str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    # XXX: on windows this function does not accomplish what it wants to:
+    #      it creates symlinks with no extension pointing to a .py
+    #      and juju only knows how to handle .exe, .bat, .cmd, and .ps1
+    #      so it does its job, but does not accomplish anything as the
+    #      hooks aren't 'callable'.
+    link_to = os.path.realpath(os.environ.get("JUJU_DISPATCH_PATH", sys.argv[0]))
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event, link_to)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary, and is that binary present?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(os.environ.get('JUJU_DISPATCH_PATH', sys.argv[0]))
+
+        dispatch = charm_dir / 'dispatch'
+        if JujuVersion.from_environ().is_dispatch_aware() and _exe_path(dispatch) is not None:
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk."""
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = _exe_path(self._charm_dir / self._dispatch_path)
+        if dispatch_path is None:
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == Path(sys.argv[0]).resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning("Legacy %s exited with status %d.", self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        except OSError as e:
+            logger.warning("Unable to run legacy %s: %s", self._dispatch_path, e)
+            sys.exit(1)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def _should_use_controller_storage(db_path: Path, meta: ops.charm.CharmMeta) -> bool:
+    """Figure out whether we want to use controller storage or not."""
+    # if you've previously used local state, carry on using that
+    if db_path.exists():
+        logger.debug("Using local storage: %s already exists", db_path)
+        return False
+
+    # if you're not in k8s you don't need controller storage
+    if 'kubernetes' not in meta.series:
+        logger.debug("Using local storage: not a kubernetes charm")
+        return False
+
+    # are we in a new enough Juju?
+    cur_version = JujuVersion.from_environ()
+
+    if cur_version.has_controller_storage():
+        logger.debug("Using controller storage: JUJU_VERSION=%s", cur_version)
+        return True
+    else:
+        logger.debug("Using local storage: JUJU_VERSION=%s", cur_version)
+        return False
+
+
+def main(charm_class: ops.charm.CharmBase, use_juju_for_storage: bool = None):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+
+    Args:
+        charm_class: your charm class.
+        use_juju_for_storage: whether to use controller-side storage. If not specified
+            then kubernetes charms that haven't previously used local storage and that
+            are running on a new enough Juju default to controller-side storage,
+            otherwise local storage is used.
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+
+    if use_juju_for_storage and not ops.storage.juju_backend_available():
+        # raise an exception; the charm is broken and needs fixing.
+        msg = 'charm set use_juju_for_storage=True, but Juju version {} does not support it'
+        raise RuntimeError(msg.format(JujuVersion.from_environ()))
+
+    if use_juju_for_storage is None:
+        use_juju_for_storage = _should_use_controller_storage(charm_state_path, meta)
+
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    framework.set_breakpointhook()
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made. Also adjust the docstring on
+        #       EventBase.defer().
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/model.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..d446d63647807db570192c690a6d245244b8f19d
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/model.py
@@ -0,0 +1,1314 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Representations of Juju's model, application, unit, and other entities."""
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+import yaml
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+if yaml.__with_libyaml__:
+    _DefaultDumper = yaml.CSafeDumper
+else:
+    _DefaultDumper = yaml.SafeDumper
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self._unit = self.get_unit(self._backend.unit_name)
+        self._relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self._config = ConfigData(self._backend)
+        self._resources = Resources(list(meta.resources), self._backend)
+        self._pod = Pod(self._backend)
+        self._storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def unit(self) -> 'Unit':
+        """A :class:`Unit` that represents the unit that is running this code (eg yourself)."""
+        return self._unit
+
+    @property
+    def app(self):
+        """A :class:`Application` that represents the application this unit is a part of."""
+        return self._unit.app
+
+    @property
+    def relations(self) -> 'RelationMapping':
+        """Mapping of endpoint to list of :class:`Relation`.
+
+        Answers the question "what am I currently related to".
+        See also :meth:`.get_relation`.
+        """
+        return self._relations
+
+    @property
+    def config(self) -> 'ConfigData':
+        """Return a mapping of config for the current application."""
+        return self._config
+
+    @property
+    def resources(self) -> 'Resources':
+        """Access to resources for this charm.
+
+        Use ``model.resources.fetch(resource_name)`` to get the path on disk
+        where the resource can be found.
+        """
+        return self._resources
+
+    @property
+    def storages(self) -> 'StorageMapping':
+        """Mapping of storage_name to :class:`Storage` as defined in metadata.yaml."""
+        return self._storages
+
+    @property
+    def pod(self) -> 'Pod':
+        """Use ``model.pod.set_spec`` to set the container specification for Kubernetes charms."""
+        return self._pod
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworkInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info.get('bind-addresses', []):
+            interface_name = interface_info.get('interface-name')
+            for address_info in interface_info.get('addresses', []):
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info.get('ingress-addresses', []):
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info.get('egress-subnets', []):
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        if self.interfaces:
+            return self.interfaces[0].address
+        else:
+            return None
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        if self.ingress_addresses:
+            return self.ingress_addresses[0]
+        else:
+            return None
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        address = address_info.get('value')
+        # The value field may be empty.
+        if address:
+            self.address = ipaddress.ip_address(address)
+        else:
+            self.address = None
+        cidr = address_info.get('cidr')
+        # The cidr field may be empty, see LP: #1864102.
+        if cidr:
+            self.subnet = ipaddress.ip_network(cidr)
+        elif address:
+            # If we have an address, convert it to a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address)
+        else:
+            self.subnet = None
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`ops.charm.RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+    """Data content of a unit or application in a relation."""
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        """Load the data from the current entity / relation."""
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        """Return if the data content can be modified."""
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                self._data.pop(key, None)
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+    """Configuration data.
+
+    This class should not be created directly. It should be accessed via :attr:`Model.config`.
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        """Forbid the usage of StatusBase directly."""
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        """Get the specific Status for the name (or UnknownStatus if not registered)."""
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        """Register a Status for the child's name."""
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm."""
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+            None
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """Represents a storage as defined in metadata.yaml.
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        """Return the location of the storage."""
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE, check=True)
+        args = (shutil.which(args[0]),) + args[1:]
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.yaml'
+            with spec_path.open("wt", encoding="utf8") as f:
+                yaml.dump(spec, stream=f, Dumper=_DefaultDumper)
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.yaml'
+                with k8s_res_path.open("wt", encoding="utf8") as f:
+                    yaml.dump(k8s_resources, stream=f, Dumper=_DefaultDumper)
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            status: The status to set.
+            message: The message to set in the status.
+            is_app: A boolean indicating whether the status should be set for a unit or an
+                    application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, "--", message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/storage.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/storage.py
new file mode 100644
index 0000000000000000000000000000000000000000..562cde770bcc3b5961aa6086372f0a2529bbd317
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/storage.py
@@ -0,0 +1,374 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Structures to offer storage to the charm (through Juju or locally)."""
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+def _run(args, **kw):
+    cmd = shutil.which(args[0])
+    if cmd is None:
+        raise FileNotFoundError(args[0])
+    return subprocess.run([cmd, *args[1:]], **kw)
+
+
+class SQLiteStorage:
+    """Storage using SQLite backend."""
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        """Make the database ready to be used as storage."""
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend."""
+        self._db.close()
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend."""
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)."""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: str = None) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+                might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, record an notice (event and observer)."""
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str = None):
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if event_path and row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        """Load a notice list from current key.
+
+        Returns:
+            List of (event_path, observer_path, method_name) tuples; empty if no key or is None.
+        """
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        """Save a notice list under current key.
+
+        Args:
+            notices: List of (event_path, observer_path, method_name) tuples.
+        """
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'.
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+def juju_backend_available() -> bool:
+    """Check if Juju state storage is available."""
+    p = shutil.which('state-get')
+    return p is not None
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        _run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = _run(["state-get", key], stdout=subprocess.PIPE, check=True, universal_newlines=True)
+        if p.stdout == '' or p.stdout == '\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        _run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+    """Exception to flag that there is no snapshot for the given handle_path."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/testing.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..e70bc98ff661b51cf45c3085ce6a29809a7b3110
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/testing.py
@@ -0,0 +1,826 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure to build unittests for Charms using the Operator Framework."""
+
+import inspect
+import pathlib
+import random
+import tempfile
+import typing
+import yaml
+from contextlib import contextmanager
+from textwrap import dedent
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+        config: A string or file-like object containing the contents of
+            config.yaml. If not supplied, we will look for a 'config.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None,
+            config: OptionalYAML = None):
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._oci_resources = {}
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+        self._update_config(key_values=self._load_config_defaults(config))
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling :meth:`begin`, there is no Charm instance, so changes to the Model won't
+        emit events. You must call :meth:`.begin` before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def begin_with_initial_hooks(self) -> None:
+        """Called when you want the Harness to fire the same hooks that Juju would fire at startup.
+
+        This triggers install, relation-created, config-changed, start, and any relation-joined
+        hooks. Based on what relations have been defined before you called begin().
+        Note that all of these are fired before returning control to the test suite, so if you
+        want to introspect what happens at each step, you need to fire them directly
+        (eg Charm.on.install.emit()).
+
+        To use this with all the normal hooks, you should instantiate the harness, setup any
+        relations that you want active when the charm starts, and then call this method.
+
+        Example::
+
+            harness = Harness(MyCharm)
+            # Do initial setup here
+            relation_id = harness.add_relation('db', 'postgresql')
+            harness.add_relation_unit(relation_id, 'postgresql/0')
+            harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+            harness.set_leader(True)
+            harness.update_config({'initial': 'config'})
+            harness.begin_with_initial_hooks()
+            # This will cause
+            # install, db-relation-created('postgresql'), leader-elected, config-changed, start
+            # db-relation-joined('postrgesql/0'), db-relation-changed('postgresql/0')
+            # To be fired.
+        """
+        self.begin()
+        # TODO: jam 2020-08-03 This should also handle storage-attached hooks once we have support
+        #  for dealing with storage.
+        self._charm.on.install.emit()
+        # Juju itself iterates what relation to fire based on a map[int]relation, so it doesn't
+        # guarantee a stable ordering between relation events. It *does* give a stable ordering
+        # of joined units for a given relation.
+        items = list(self._meta.relations.items())
+        random.shuffle(items)
+        this_app_name = self._meta.name
+        for relname, rel_meta in items:
+            if rel_meta.role == charm.RelationRole.peer:
+                # If the user has directly added a relation, leave it be, but otherwise ensure
+                # that peer relations are always established at before leader-elected.
+                rel_ids = self._backend._relation_ids_map.get(relname)
+                if rel_ids is None:
+                    self.add_relation(relname, self._meta.name)
+                else:
+                    random.shuffle(rel_ids)
+                    for rel_id in rel_ids:
+                        self._emit_relation_created(relname, rel_id, this_app_name)
+            else:
+                rel_ids = self._backend._relation_ids_map.get(relname, [])
+                random.shuffle(rel_ids)
+                for rel_id in rel_ids:
+                    app_name = self._backend._relation_app_and_units[rel_id]["app"]
+                    self._emit_relation_created(relname, rel_id, app_name)
+        if self._backend._is_leader:
+            self._charm.on.leader_elected.emit()
+        else:
+            self._charm.on.leader_settings_changed.emit()
+        self._charm.on.config_changed.emit()
+        self._charm.on.start.emit()
+        all_ids = list(self._backend._relation_names.items())
+        random.shuffle(all_ids)
+        for rel_id, rel_name in all_ids:
+            rel_app_and_units = self._backend._relation_app_and_units[rel_id]
+            app_name = rel_app_and_units["app"]
+            # Note: Juju *does* fire relation events for a given relation in the sorted order of
+            # the unit names. It also always fires relation-changed immediately after
+            # relation-joined for the same unit.
+            # Juju only fires relation-changed (app) if there is data for the related application
+            relation = self._model.get_relation(rel_name, rel_id)
+            if self._backend._relation_data[rel_id].get(app_name):
+                app = self._model.get_app(app_name)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, app, None)
+            for unit_name in sorted(rel_app_and_units["units"]):
+                remote_unit = self._model.get_unit(unit_name)
+                self._charm.on[rel_name].relation_joined.emit(
+                    relation, remote_unit.app, remote_unit)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, remote_unit.app, remote_unit)
+
+    def cleanup(self) -> None:
+        """Called by your test infrastructure to cleanup any temporary directories/files/etc.
+
+        Currently this only needs to be called if you test with resources. But it is reasonable
+        to always include a `testcase.addCleanup(harness.cleanup)` just in case.
+        """
+        self._backend._cleanup()
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def _load_config_defaults(self, charm_config):
+        """Load default values from config.yaml.
+
+        Handle the case where a user doesn't supply explicit config snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_config is None:
+            config_path = charm_dir / 'config.yaml'
+            if config_path.is_file():
+                charm_config = config_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of config that the framework can support
+                charm_config = '{}'
+        elif isinstance(charm_config, str):
+            charm_config = dedent(charm_config)
+        charm_config = yaml.load(charm_config, Loader=yaml.SafeLoader)
+        charm_config = charm_config.get('options', {})
+        return {key: value['default'] for key, value in charm_config.items()
+                if 'default' in value}
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+
+        as_yaml = yaml.dump(contents, Dumper=yaml.SafeDumper)
+        self._backend._resources_map[resource_name] = ('contents.yaml', as_yaml)
+
+    def add_resource(self, resource_name: str, content: typing.AnyStr) -> None:
+        """Add content for a resource to the backend.
+
+        This will register the content, so that a call to `Model.resources.fetch(resource_name)`
+        will return a path to a file containing that content.
+
+        Args:
+            resource_name: The name of the resource being added
+            content: Either string or bytes content, which will be the content of the filename
+                returned by resource-get. If contents is a string, it will be encoded in utf-8
+        """
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        record = self._meta.resources[resource_name]
+        if record.type != "file":
+            raise RuntimeError(
+                'Resource {} is not a file, but actually {}'.format(resource_name, record.type))
+        filename = record.filename
+        if filename is None:
+            filename = resource_name
+
+        self._backend._resources_map[resource_name] = (filename, content)
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    @contextmanager
+    def hooks_disabled(self):
+        """A context manager to run code with hooks disabled.
+
+        Example::
+
+            with harness.hooks_disabled():
+                # things in here don't fire events
+                harness.set_leader(True)
+                harness.update_config(unset=['foo', 'bar'])
+            # things here will again fire events
+        """
+        if self._hooks_enabled:
+            self.disable_hooks()
+            try:
+                yield None
+            finally:
+                self.enable_hooks()
+        else:
+            yield None
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        self._backend._relation_app_and_units[rel_id] = {
+            "app": remote_app,
+            "units": [],
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        self._emit_relation_created(relation_name, rel_id, remote_app)
+        return rel_id
+
+    def _emit_relation_created(self, relation_name: str, relation_id: int,
+                               remote_app: str) -> None:
+        """Trigger relation-created for a given relation with a given remote application."""
+        if self._charm is None or not self._hooks_enabled:
+            return
+        if self._charm is None or not self._hooks_enabled:
+            return
+        relation = self._model.get_relation(relation_name, relation_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event. This would naturally be
+        followed by a `relation_changed` event, which you can trigger with
+        :meth:`.update_relation_data`. This separation is artificial in the
+        sense that Juju will always fire the two, but is intended to make
+        testing relations and their data bags slightly more natural.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        # TODO: jam 2020-08-03 This is where we could assert that the unit name matches the
+        #  application name (eg you don't have a relation to 'foo' but add units of 'bar/0'
+        self._backend._relation_app_and_units[relation_id]["units"].append(remote_unit_name)
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_pod_spec(self) -> (typing.Mapping, typing.Mapping):
+        """Return the content of the pod spec as last set by the charm.
+
+        This returns both the pod spec and any k8s_resources that were supplied.
+        See the signature of Model.pod.set_spec
+        """
+        return self._backend._pod_spec
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def _update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will *not* trigger a `config_changed` event, and is intended for internal use.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        self._update_config(key_values, unset)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+class _ResourceEntry:
+    """Tracks the contents of a Resource."""
+
+    def __init__(self, resource_name):
+        self.name = resource_name
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        # {relation_id: {"app": app_name, "units": ["app/0",...]}
+        self._relation_app_and_units = {}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}  # {resource_name: resource_content}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+        self._resource_dir = None
+
+    def _cleanup(self):
+        if self._resource_dir is not None:
+            self._resource_dir.cleanup()
+            self._resource_dir = None
+
+    def _get_resource_dir(self) -> pathlib.Path:
+        if self._resource_dir is None:
+            # In actual Juju, the resource path for a charm's resource is
+            # $AGENT_DIR/resources/$RESOURCE_NAME/$RESOURCE_FILENAME
+            # However, charms shouldn't depend on this.
+            self._resource_dir = tempfile.TemporaryDirectory(prefix='tmp-ops-test-resource-')
+        return pathlib.Path(self._resource_dir.name)
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        if resource_name not in self._resources_map:
+            raise model.ModelError(
+                "ERROR could not download resource: HTTP request failed: "
+                "Get https://.../units/unit-{}/resources/{}: resource#{}/{} not found".format(
+                    self.unit_name.replace('/', '-'), resource_name, self.app_name, resource_name
+                ))
+        filename, contents = self._resources_map[resource_name]
+        resource_dir = self._get_resource_dir()
+        resource_filename = resource_dir / resource_name / filename
+        if not resource_filename.exists():
+            if isinstance(contents, bytes):
+                mode = 'wb'
+            else:
+                mode = 'wt'
+            resource_filename.parent.mkdir(exist_ok=True)
+            with resource_filename.open(mode=mode) as resource_file:
+                resource_file.write(contents)
+        return resource_filename
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/version.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..db9e98175100d8045815d0ee215d2f5f76ad468f
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/ops/version.py
@@ -0,0 +1,3 @@
+# this is a generated file
+
+version = '1.1.0'
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/__init__.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..86d07b5525d10bf1d543be0e1f5d01af897a4b49
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/__init__.py
@@ -0,0 +1,427 @@
+
+from .error import *
+
+from .tokens import *
+from .events import *
+from .nodes import *
+
+from .loader import *
+from .dumper import *
+
+__version__ = '5.4.1'
+try:
+    from .cyaml import *
+    __with_libyaml__ = True
+except ImportError:
+    __with_libyaml__ = False
+
+import io
+
+#------------------------------------------------------------------------------
+# Warnings control
+#------------------------------------------------------------------------------
+
+# 'Global' warnings state:
+_warnings_enabled = {
+    'YAMLLoadWarning': True,
+}
+
+# Get or set global warnings' state
+def warnings(settings=None):
+    if settings is None:
+        return _warnings_enabled
+
+    if type(settings) is dict:
+        for key in settings:
+            if key in _warnings_enabled:
+                _warnings_enabled[key] = settings[key]
+
+# Warn when load() is called without Loader=...
+class YAMLLoadWarning(RuntimeWarning):
+    pass
+
+def load_warning(method):
+    if _warnings_enabled['YAMLLoadWarning'] is False:
+        return
+
+    import warnings
+
+    message = (
+        "calling yaml.%s() without Loader=... is deprecated, as the "
+        "default Loader is unsafe. Please read "
+        "https://msg.pyyaml.org/load for full details."
+    ) % method
+
+    warnings.warn(message, YAMLLoadWarning, stacklevel=3)
+
+#------------------------------------------------------------------------------
+def scan(stream, Loader=Loader):
+    """
+    Scan a YAML stream and produce scanning tokens.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_token():
+            yield loader.get_token()
+    finally:
+        loader.dispose()
+
+def parse(stream, Loader=Loader):
+    """
+    Parse a YAML stream and produce parsing events.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_event():
+            yield loader.get_event()
+    finally:
+        loader.dispose()
+
+def compose(stream, Loader=Loader):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding representation tree.
+    """
+    loader = Loader(stream)
+    try:
+        return loader.get_single_node()
+    finally:
+        loader.dispose()
+
+def compose_all(stream, Loader=Loader):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding representation trees.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_node():
+            yield loader.get_node()
+    finally:
+        loader.dispose()
+
+def load(stream, Loader=None):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+    """
+    if Loader is None:
+        load_warning('load')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        return loader.get_single_data()
+    finally:
+        loader.dispose()
+
+def load_all(stream, Loader=None):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+    """
+    if Loader is None:
+        load_warning('load_all')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        while loader.check_data():
+            yield loader.get_data()
+    finally:
+        loader.dispose()
+
+def full_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, FullLoader)
+
+def full_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, FullLoader)
+
+def safe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load(stream, SafeLoader)
+
+def safe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load_all(stream, SafeLoader)
+
+def unsafe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, UnsafeLoader)
+
+def unsafe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, UnsafeLoader)
+
+def emit(events, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None):
+    """
+    Emit YAML parsing events into a stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        stream = io.StringIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break)
+    try:
+        for event in events:
+            dumper.emit(event)
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize_all(nodes, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None):
+    """
+    Serialize a sequence of representation trees into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end)
+    try:
+        dumper.open()
+        for node in nodes:
+            dumper.serialize(node)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize(node, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a representation tree into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return serialize_all([node], stream, Dumper=Dumper, **kwds)
+
+def dump_all(documents, stream=None, Dumper=Dumper,
+        default_style=None, default_flow_style=False,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None, sort_keys=True):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, default_style=default_style,
+            default_flow_style=default_flow_style,
+            canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end, sort_keys=sort_keys)
+    try:
+        dumper.open()
+        for data in documents:
+            dumper.represent(data)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def dump(data, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=Dumper, **kwds)
+
+def safe_dump_all(documents, stream=None, **kwds):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all(documents, stream, Dumper=SafeDumper, **kwds)
+
+def safe_dump(data, stream=None, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=SafeDumper, **kwds)
+
+def add_implicit_resolver(tag, regexp, first=None,
+        Loader=None, Dumper=Dumper):
+    """
+    Add an implicit scalar detector.
+    If an implicit scalar value matches the given regexp,
+    the corresponding tag is assigned to the scalar.
+    first is a sequence of possible initial characters or None.
+    """
+    if Loader is None:
+        loader.Loader.add_implicit_resolver(tag, regexp, first)
+        loader.FullLoader.add_implicit_resolver(tag, regexp, first)
+        loader.UnsafeLoader.add_implicit_resolver(tag, regexp, first)
+    else:
+        Loader.add_implicit_resolver(tag, regexp, first)
+    Dumper.add_implicit_resolver(tag, regexp, first)
+
+def add_path_resolver(tag, path, kind=None, Loader=None, Dumper=Dumper):
+    """
+    Add a path based resolver for the given tag.
+    A path is a list of keys that forms a path
+    to a node in the representation tree.
+    Keys can be string values, integers, or None.
+    """
+    if Loader is None:
+        loader.Loader.add_path_resolver(tag, path, kind)
+        loader.FullLoader.add_path_resolver(tag, path, kind)
+        loader.UnsafeLoader.add_path_resolver(tag, path, kind)
+    else:
+        Loader.add_path_resolver(tag, path, kind)
+    Dumper.add_path_resolver(tag, path, kind)
+
+def add_constructor(tag, constructor, Loader=None):
+    """
+    Add a constructor for the given tag.
+    Constructor is a function that accepts a Loader instance
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_constructor(tag, constructor)
+        loader.FullLoader.add_constructor(tag, constructor)
+        loader.UnsafeLoader.add_constructor(tag, constructor)
+    else:
+        Loader.add_constructor(tag, constructor)
+
+def add_multi_constructor(tag_prefix, multi_constructor, Loader=None):
+    """
+    Add a multi-constructor for the given tag prefix.
+    Multi-constructor is called for a node if its tag starts with tag_prefix.
+    Multi-constructor accepts a Loader instance, a tag suffix,
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.FullLoader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.UnsafeLoader.add_multi_constructor(tag_prefix, multi_constructor)
+    else:
+        Loader.add_multi_constructor(tag_prefix, multi_constructor)
+
+def add_representer(data_type, representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Representer is a function accepting a Dumper instance
+    and an instance of the given data type
+    and producing the corresponding representation node.
+    """
+    Dumper.add_representer(data_type, representer)
+
+def add_multi_representer(data_type, multi_representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Multi-representer is a function accepting a Dumper instance
+    and an instance of the given data type or subtype
+    and producing the corresponding representation node.
+    """
+    Dumper.add_multi_representer(data_type, multi_representer)
+
+class YAMLObjectMetaclass(type):
+    """
+    The metaclass for YAMLObject.
+    """
+    def __init__(cls, name, bases, kwds):
+        super(YAMLObjectMetaclass, cls).__init__(name, bases, kwds)
+        if 'yaml_tag' in kwds and kwds['yaml_tag'] is not None:
+            if isinstance(cls.yaml_loader, list):
+                for loader in cls.yaml_loader:
+                    loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+            else:
+                cls.yaml_loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+
+            cls.yaml_dumper.add_representer(cls, cls.to_yaml)
+
+class YAMLObject(metaclass=YAMLObjectMetaclass):
+    """
+    An object that can dump itself to a YAML stream
+    and load itself from a YAML stream.
+    """
+
+    __slots__ = ()  # no direct instantiation, so allow immutable subclasses
+
+    yaml_loader = [Loader, FullLoader, UnsafeLoader]
+    yaml_dumper = Dumper
+
+    yaml_tag = None
+    yaml_flow_style = None
+
+    @classmethod
+    def from_yaml(cls, loader, node):
+        """
+        Convert a representation node to a Python object.
+        """
+        return loader.construct_yaml_object(node, cls)
+
+    @classmethod
+    def to_yaml(cls, dumper, data):
+        """
+        Convert a Python object to a representation node.
+        """
+        return dumper.represent_yaml_object(cls.yaml_tag, data, cls,
+                flow_style=cls.yaml_flow_style)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/_yaml.cpython-38-x86_64-linux-gnu.so b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/_yaml.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..801c0e2a72a862a33d640a576ca969b684dc8e86
Binary files /dev/null and b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/_yaml.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/composer.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/composer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d15cb40e3b4198819c91c6f8d8b32807fcf53b2
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/composer.py
@@ -0,0 +1,139 @@
+
+__all__ = ['Composer', 'ComposerError']
+
+from .error import MarkedYAMLError
+from .events import *
+from .nodes import *
+
+class ComposerError(MarkedYAMLError):
+    pass
+
+class Composer:
+
+    def __init__(self):
+        self.anchors = {}
+
+    def check_node(self):
+        # Drop the STREAM-START event.
+        if self.check_event(StreamStartEvent):
+            self.get_event()
+
+        # If there are more documents available?
+        return not self.check_event(StreamEndEvent)
+
+    def get_node(self):
+        # Get the root node of the next document.
+        if not self.check_event(StreamEndEvent):
+            return self.compose_document()
+
+    def get_single_node(self):
+        # Drop the STREAM-START event.
+        self.get_event()
+
+        # Compose a document if the stream is not empty.
+        document = None
+        if not self.check_event(StreamEndEvent):
+            document = self.compose_document()
+
+        # Ensure that the stream contains no more documents.
+        if not self.check_event(StreamEndEvent):
+            event = self.get_event()
+            raise ComposerError("expected a single document in the stream",
+                    document.start_mark, "but found another document",
+                    event.start_mark)
+
+        # Drop the STREAM-END event.
+        self.get_event()
+
+        return document
+
+    def compose_document(self):
+        # Drop the DOCUMENT-START event.
+        self.get_event()
+
+        # Compose the root node.
+        node = self.compose_node(None, None)
+
+        # Drop the DOCUMENT-END event.
+        self.get_event()
+
+        self.anchors = {}
+        return node
+
+    def compose_node(self, parent, index):
+        if self.check_event(AliasEvent):
+            event = self.get_event()
+            anchor = event.anchor
+            if anchor not in self.anchors:
+                raise ComposerError(None, None, "found undefined alias %r"
+                        % anchor, event.start_mark)
+            return self.anchors[anchor]
+        event = self.peek_event()
+        anchor = event.anchor
+        if anchor is not None:
+            if anchor in self.anchors:
+                raise ComposerError("found duplicate anchor %r; first occurrence"
+                        % anchor, self.anchors[anchor].start_mark,
+                        "second occurrence", event.start_mark)
+        self.descend_resolver(parent, index)
+        if self.check_event(ScalarEvent):
+            node = self.compose_scalar_node(anchor)
+        elif self.check_event(SequenceStartEvent):
+            node = self.compose_sequence_node(anchor)
+        elif self.check_event(MappingStartEvent):
+            node = self.compose_mapping_node(anchor)
+        self.ascend_resolver()
+        return node
+
+    def compose_scalar_node(self, anchor):
+        event = self.get_event()
+        tag = event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(ScalarNode, event.value, event.implicit)
+        node = ScalarNode(tag, event.value,
+                event.start_mark, event.end_mark, style=event.style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        return node
+
+    def compose_sequence_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(SequenceNode, None, start_event.implicit)
+        node = SequenceNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        index = 0
+        while not self.check_event(SequenceEndEvent):
+            node.value.append(self.compose_node(node, index))
+            index += 1
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
+    def compose_mapping_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(MappingNode, None, start_event.implicit)
+        node = MappingNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        while not self.check_event(MappingEndEvent):
+            #key_event = self.peek_event()
+            item_key = self.compose_node(node, None)
+            #if item_key in node.value:
+            #    raise ComposerError("while composing a mapping", start_event.start_mark,
+            #            "found duplicate key", key_event.start_mark)
+            item_value = self.compose_node(node, item_key)
+            #node.value[item_key] = item_value
+            node.value.append((item_key, item_value))
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/constructor.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/constructor.py
new file mode 100644
index 0000000000000000000000000000000000000000..619acd3070a4845c653fcf22a626e05158035bc2
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/constructor.py
@@ -0,0 +1,748 @@
+
+__all__ = [
+    'BaseConstructor',
+    'SafeConstructor',
+    'FullConstructor',
+    'UnsafeConstructor',
+    'Constructor',
+    'ConstructorError'
+]
+
+from .error import *
+from .nodes import *
+
+import collections.abc, datetime, base64, binascii, re, sys, types
+
+class ConstructorError(MarkedYAMLError):
+    pass
+
+class BaseConstructor:
+
+    yaml_constructors = {}
+    yaml_multi_constructors = {}
+
+    def __init__(self):
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.state_generators = []
+        self.deep_construct = False
+
+    def check_data(self):
+        # If there are more documents available?
+        return self.check_node()
+
+    def check_state_key(self, key):
+        """Block special attributes/methods from being set in a newly created
+        object, to prevent user-controlled methods from being called during
+        deserialization"""
+        if self.get_state_keys_blacklist_regexp().match(key):
+            raise ConstructorError(None, None,
+                "blacklisted key '%s' in instance state found" % (key,), None)
+
+    def get_data(self):
+        # Construct and return the next document.
+        if self.check_node():
+            return self.construct_document(self.get_node())
+
+    def get_single_data(self):
+        # Ensure that the stream contains a single document and construct it.
+        node = self.get_single_node()
+        if node is not None:
+            return self.construct_document(node)
+        return None
+
+    def construct_document(self, node):
+        data = self.construct_object(node)
+        while self.state_generators:
+            state_generators = self.state_generators
+            self.state_generators = []
+            for generator in state_generators:
+                for dummy in generator:
+                    pass
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.deep_construct = False
+        return data
+
+    def construct_object(self, node, deep=False):
+        if node in self.constructed_objects:
+            return self.constructed_objects[node]
+        if deep:
+            old_deep = self.deep_construct
+            self.deep_construct = True
+        if node in self.recursive_objects:
+            raise ConstructorError(None, None,
+                    "found unconstructable recursive node", node.start_mark)
+        self.recursive_objects[node] = None
+        constructor = None
+        tag_suffix = None
+        if node.tag in self.yaml_constructors:
+            constructor = self.yaml_constructors[node.tag]
+        else:
+            for tag_prefix in self.yaml_multi_constructors:
+                if tag_prefix is not None and node.tag.startswith(tag_prefix):
+                    tag_suffix = node.tag[len(tag_prefix):]
+                    constructor = self.yaml_multi_constructors[tag_prefix]
+                    break
+            else:
+                if None in self.yaml_multi_constructors:
+                    tag_suffix = node.tag
+                    constructor = self.yaml_multi_constructors[None]
+                elif None in self.yaml_constructors:
+                    constructor = self.yaml_constructors[None]
+                elif isinstance(node, ScalarNode):
+                    constructor = self.__class__.construct_scalar
+                elif isinstance(node, SequenceNode):
+                    constructor = self.__class__.construct_sequence
+                elif isinstance(node, MappingNode):
+                    constructor = self.__class__.construct_mapping
+        if tag_suffix is None:
+            data = constructor(self, node)
+        else:
+            data = constructor(self, tag_suffix, node)
+        if isinstance(data, types.GeneratorType):
+            generator = data
+            data = next(generator)
+            if self.deep_construct:
+                for dummy in generator:
+                    pass
+            else:
+                self.state_generators.append(generator)
+        self.constructed_objects[node] = data
+        del self.recursive_objects[node]
+        if deep:
+            self.deep_construct = old_deep
+        return data
+
+    def construct_scalar(self, node):
+        if not isinstance(node, ScalarNode):
+            raise ConstructorError(None, None,
+                    "expected a scalar node, but found %s" % node.id,
+                    node.start_mark)
+        return node.value
+
+    def construct_sequence(self, node, deep=False):
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError(None, None,
+                    "expected a sequence node, but found %s" % node.id,
+                    node.start_mark)
+        return [self.construct_object(child, deep=deep)
+                for child in node.value]
+
+    def construct_mapping(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        mapping = {}
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            if not isinstance(key, collections.abc.Hashable):
+                raise ConstructorError("while constructing a mapping", node.start_mark,
+                        "found unhashable key", key_node.start_mark)
+            value = self.construct_object(value_node, deep=deep)
+            mapping[key] = value
+        return mapping
+
+    def construct_pairs(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        pairs = []
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            value = self.construct_object(value_node, deep=deep)
+            pairs.append((key, value))
+        return pairs
+
+    @classmethod
+    def add_constructor(cls, tag, constructor):
+        if not 'yaml_constructors' in cls.__dict__:
+            cls.yaml_constructors = cls.yaml_constructors.copy()
+        cls.yaml_constructors[tag] = constructor
+
+    @classmethod
+    def add_multi_constructor(cls, tag_prefix, multi_constructor):
+        if not 'yaml_multi_constructors' in cls.__dict__:
+            cls.yaml_multi_constructors = cls.yaml_multi_constructors.copy()
+        cls.yaml_multi_constructors[tag_prefix] = multi_constructor
+
+class SafeConstructor(BaseConstructor):
+
+    def construct_scalar(self, node):
+        if isinstance(node, MappingNode):
+            for key_node, value_node in node.value:
+                if key_node.tag == 'tag:yaml.org,2002:value':
+                    return self.construct_scalar(value_node)
+        return super().construct_scalar(node)
+
+    def flatten_mapping(self, node):
+        merge = []
+        index = 0
+        while index < len(node.value):
+            key_node, value_node = node.value[index]
+            if key_node.tag == 'tag:yaml.org,2002:merge':
+                del node.value[index]
+                if isinstance(value_node, MappingNode):
+                    self.flatten_mapping(value_node)
+                    merge.extend(value_node.value)
+                elif isinstance(value_node, SequenceNode):
+                    submerge = []
+                    for subnode in value_node.value:
+                        if not isinstance(subnode, MappingNode):
+                            raise ConstructorError("while constructing a mapping",
+                                    node.start_mark,
+                                    "expected a mapping for merging, but found %s"
+                                    % subnode.id, subnode.start_mark)
+                        self.flatten_mapping(subnode)
+                        submerge.append(subnode.value)
+                    submerge.reverse()
+                    for value in submerge:
+                        merge.extend(value)
+                else:
+                    raise ConstructorError("while constructing a mapping", node.start_mark,
+                            "expected a mapping or list of mappings for merging, but found %s"
+                            % value_node.id, value_node.start_mark)
+            elif key_node.tag == 'tag:yaml.org,2002:value':
+                key_node.tag = 'tag:yaml.org,2002:str'
+                index += 1
+            else:
+                index += 1
+        if merge:
+            node.value = merge + node.value
+
+    def construct_mapping(self, node, deep=False):
+        if isinstance(node, MappingNode):
+            self.flatten_mapping(node)
+        return super().construct_mapping(node, deep=deep)
+
+    def construct_yaml_null(self, node):
+        self.construct_scalar(node)
+        return None
+
+    bool_values = {
+        'yes':      True,
+        'no':       False,
+        'true':     True,
+        'false':    False,
+        'on':       True,
+        'off':      False,
+    }
+
+    def construct_yaml_bool(self, node):
+        value = self.construct_scalar(node)
+        return self.bool_values[value.lower()]
+
+    def construct_yaml_int(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '')
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '0':
+            return 0
+        elif value.startswith('0b'):
+            return sign*int(value[2:], 2)
+        elif value.startswith('0x'):
+            return sign*int(value[2:], 16)
+        elif value[0] == '0':
+            return sign*int(value, 8)
+        elif ':' in value:
+            digits = [int(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*int(value)
+
+    inf_value = 1e300
+    while inf_value != inf_value*inf_value:
+        inf_value *= inf_value
+    nan_value = -inf_value/inf_value   # Trying to make a quiet NaN (like C99).
+
+    def construct_yaml_float(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '').lower()
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '.inf':
+            return sign*self.inf_value
+        elif value == '.nan':
+            return self.nan_value
+        elif ':' in value:
+            digits = [float(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0.0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*float(value)
+
+    def construct_yaml_binary(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    timestamp_regexp = re.compile(
+            r'''^(?P<year>[0-9][0-9][0-9][0-9])
+                -(?P<month>[0-9][0-9]?)
+                -(?P<day>[0-9][0-9]?)
+                (?:(?:[Tt]|[ \t]+)
+                (?P<hour>[0-9][0-9]?)
+                :(?P<minute>[0-9][0-9])
+                :(?P<second>[0-9][0-9])
+                (?:\.(?P<fraction>[0-9]*))?
+                (?:[ \t]*(?P<tz>Z|(?P<tz_sign>[-+])(?P<tz_hour>[0-9][0-9]?)
+                (?::(?P<tz_minute>[0-9][0-9]))?))?)?$''', re.X)
+
+    def construct_yaml_timestamp(self, node):
+        value = self.construct_scalar(node)
+        match = self.timestamp_regexp.match(node.value)
+        values = match.groupdict()
+        year = int(values['year'])
+        month = int(values['month'])
+        day = int(values['day'])
+        if not values['hour']:
+            return datetime.date(year, month, day)
+        hour = int(values['hour'])
+        minute = int(values['minute'])
+        second = int(values['second'])
+        fraction = 0
+        tzinfo = None
+        if values['fraction']:
+            fraction = values['fraction'][:6]
+            while len(fraction) < 6:
+                fraction += '0'
+            fraction = int(fraction)
+        if values['tz_sign']:
+            tz_hour = int(values['tz_hour'])
+            tz_minute = int(values['tz_minute'] or 0)
+            delta = datetime.timedelta(hours=tz_hour, minutes=tz_minute)
+            if values['tz_sign'] == '-':
+                delta = -delta
+            tzinfo = datetime.timezone(delta)
+        elif values['tz']:
+            tzinfo = datetime.timezone.utc
+        return datetime.datetime(year, month, day, hour, minute, second, fraction,
+                                 tzinfo=tzinfo)
+
+    def construct_yaml_omap(self, node):
+        # Note: we do not check for duplicate keys, because it's too
+        # CPU-expensive.
+        omap = []
+        yield omap
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing an ordered map", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            omap.append((key, value))
+
+    def construct_yaml_pairs(self, node):
+        # Note: the same code as `construct_yaml_omap`.
+        pairs = []
+        yield pairs
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing pairs", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            pairs.append((key, value))
+
+    def construct_yaml_set(self, node):
+        data = set()
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_yaml_seq(self, node):
+        data = []
+        yield data
+        data.extend(self.construct_sequence(node))
+
+    def construct_yaml_map(self, node):
+        data = {}
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_object(self, node, cls):
+        data = cls.__new__(cls)
+        yield data
+        if hasattr(data, '__setstate__'):
+            state = self.construct_mapping(node, deep=True)
+            data.__setstate__(state)
+        else:
+            state = self.construct_mapping(node)
+            data.__dict__.update(state)
+
+    def construct_undefined(self, node):
+        raise ConstructorError(None, None,
+                "could not determine a constructor for the tag %r" % node.tag,
+                node.start_mark)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:null',
+        SafeConstructor.construct_yaml_null)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:bool',
+        SafeConstructor.construct_yaml_bool)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:int',
+        SafeConstructor.construct_yaml_int)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:float',
+        SafeConstructor.construct_yaml_float)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:binary',
+        SafeConstructor.construct_yaml_binary)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:timestamp',
+        SafeConstructor.construct_yaml_timestamp)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:omap',
+        SafeConstructor.construct_yaml_omap)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:pairs',
+        SafeConstructor.construct_yaml_pairs)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:set',
+        SafeConstructor.construct_yaml_set)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:str',
+        SafeConstructor.construct_yaml_str)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:seq',
+        SafeConstructor.construct_yaml_seq)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:map',
+        SafeConstructor.construct_yaml_map)
+
+SafeConstructor.add_constructor(None,
+        SafeConstructor.construct_undefined)
+
+class FullConstructor(SafeConstructor):
+    # 'extend' is blacklisted because it is used by
+    # construct_python_object_apply to add `listitems` to a newly generate
+    # python instance
+    def get_state_keys_blacklist(self):
+        return ['^extend$', '^__.*__$']
+
+    def get_state_keys_blacklist_regexp(self):
+        if not hasattr(self, 'state_keys_blacklist_regexp'):
+            self.state_keys_blacklist_regexp = re.compile('(' + '|'.join(self.get_state_keys_blacklist()) + ')')
+        return self.state_keys_blacklist_regexp
+
+    def construct_python_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_unicode(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_bytes(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    def construct_python_long(self, node):
+        return self.construct_yaml_int(node)
+
+    def construct_python_complex(self, node):
+       return complex(self.construct_scalar(node))
+
+    def construct_python_tuple(self, node):
+        return tuple(self.construct_sequence(node))
+
+    def find_python_module(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if unsafe:
+            try:
+                __import__(name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python module", mark,
+                        "cannot find module %r (%s)" % (name, exc), mark)
+        if name not in sys.modules:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "module %r is not imported" % name, mark)
+        return sys.modules[name]
+
+    def find_python_name(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if '.' in name:
+            module_name, object_name = name.rsplit('.', 1)
+        else:
+            module_name = 'builtins'
+            object_name = name
+        if unsafe:
+            try:
+                __import__(module_name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python object", mark,
+                        "cannot find module %r (%s)" % (module_name, exc), mark)
+        if module_name not in sys.modules:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "module %r is not imported" % module_name, mark)
+        module = sys.modules[module_name]
+        if not hasattr(module, object_name):
+            raise ConstructorError("while constructing a Python object", mark,
+                    "cannot find %r in the module %r"
+                    % (object_name, module.__name__), mark)
+        return getattr(module, object_name)
+
+    def construct_python_name(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python name", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_name(suffix, node.start_mark)
+
+    def construct_python_module(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python module", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_module(suffix, node.start_mark)
+
+    def make_python_instance(self, suffix, node,
+            args=None, kwds=None, newobj=False, unsafe=False):
+        if not args:
+            args = []
+        if not kwds:
+            kwds = {}
+        cls = self.find_python_name(suffix, node.start_mark)
+        if not (unsafe or isinstance(cls, type)):
+            raise ConstructorError("while constructing a Python instance", node.start_mark,
+                    "expected a class, but found %r" % type(cls),
+                    node.start_mark)
+        if newobj and isinstance(cls, type):
+            return cls.__new__(cls, *args, **kwds)
+        else:
+            return cls(*args, **kwds)
+
+    def set_python_instance_state(self, instance, state, unsafe=False):
+        if hasattr(instance, '__setstate__'):
+            instance.__setstate__(state)
+        else:
+            slotstate = {}
+            if isinstance(state, tuple) and len(state) == 2:
+                state, slotstate = state
+            if hasattr(instance, '__dict__'):
+                if not unsafe and state:
+                    for key in state.keys():
+                        self.check_state_key(key)
+                instance.__dict__.update(state)
+            elif state:
+                slotstate.update(state)
+            for key, value in slotstate.items():
+                if not unsafe:
+                    self.check_state_key(key)
+                setattr(instance, key, value)
+
+    def construct_python_object(self, suffix, node):
+        # Format:
+        #   !!python/object:module.name { ... state ... }
+        instance = self.make_python_instance(suffix, node, newobj=True)
+        yield instance
+        deep = hasattr(instance, '__setstate__')
+        state = self.construct_mapping(node, deep=deep)
+        self.set_python_instance_state(instance, state)
+
+    def construct_python_object_apply(self, suffix, node, newobj=False):
+        # Format:
+        #   !!python/object/apply       # (or !!python/object/new)
+        #   args: [ ... arguments ... ]
+        #   kwds: { ... keywords ... }
+        #   state: ... state ...
+        #   listitems: [ ... listitems ... ]
+        #   dictitems: { ... dictitems ... }
+        # or short format:
+        #   !!python/object/apply [ ... arguments ... ]
+        # The difference between !!python/object/apply and !!python/object/new
+        # is how an object is created, check make_python_instance for details.
+        if isinstance(node, SequenceNode):
+            args = self.construct_sequence(node, deep=True)
+            kwds = {}
+            state = {}
+            listitems = []
+            dictitems = {}
+        else:
+            value = self.construct_mapping(node, deep=True)
+            args = value.get('args', [])
+            kwds = value.get('kwds', {})
+            state = value.get('state', {})
+            listitems = value.get('listitems', [])
+            dictitems = value.get('dictitems', {})
+        instance = self.make_python_instance(suffix, node, args, kwds, newobj)
+        if state:
+            self.set_python_instance_state(instance, state)
+        if listitems:
+            instance.extend(listitems)
+        if dictitems:
+            for key in dictitems:
+                instance[key] = dictitems[key]
+        return instance
+
+    def construct_python_object_new(self, suffix, node):
+        return self.construct_python_object_apply(suffix, node, newobj=True)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/none',
+    FullConstructor.construct_yaml_null)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bool',
+    FullConstructor.construct_yaml_bool)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/str',
+    FullConstructor.construct_python_str)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/unicode',
+    FullConstructor.construct_python_unicode)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bytes',
+    FullConstructor.construct_python_bytes)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/int',
+    FullConstructor.construct_yaml_int)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/long',
+    FullConstructor.construct_python_long)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/float',
+    FullConstructor.construct_yaml_float)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/complex',
+    FullConstructor.construct_python_complex)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/list',
+    FullConstructor.construct_yaml_seq)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/tuple',
+    FullConstructor.construct_python_tuple)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/dict',
+    FullConstructor.construct_yaml_map)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/name:',
+    FullConstructor.construct_python_name)
+
+class UnsafeConstructor(FullConstructor):
+
+    def find_python_module(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_module(name, mark, unsafe=True)
+
+    def find_python_name(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_name(name, mark, unsafe=True)
+
+    def make_python_instance(self, suffix, node, args=None, kwds=None, newobj=False):
+        return super(UnsafeConstructor, self).make_python_instance(
+            suffix, node, args, kwds, newobj, unsafe=True)
+
+    def set_python_instance_state(self, instance, state):
+        return super(UnsafeConstructor, self).set_python_instance_state(
+            instance, state, unsafe=True)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/module:',
+    UnsafeConstructor.construct_python_module)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object:',
+    UnsafeConstructor.construct_python_object)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/new:',
+    UnsafeConstructor.construct_python_object_new)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/apply:',
+    UnsafeConstructor.construct_python_object_apply)
+
+# Constructor is same as UnsafeConstructor. Need to leave this in place in case
+# people have extended it directly.
+class Constructor(UnsafeConstructor):
+    pass
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/cyaml.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/cyaml.py
new file mode 100644
index 0000000000000000000000000000000000000000..0c21345879b298bb8668201bebe7d289586b17f9
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/cyaml.py
@@ -0,0 +1,101 @@
+
+__all__ = [
+    'CBaseLoader', 'CSafeLoader', 'CFullLoader', 'CUnsafeLoader', 'CLoader',
+    'CBaseDumper', 'CSafeDumper', 'CDumper'
+]
+
+from yaml._yaml import CParser, CEmitter
+
+from .constructor import *
+
+from .serializer import *
+from .representer import *
+
+from .resolver import *
+
+class CBaseLoader(CParser, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class CSafeLoader(CParser, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CFullLoader(CParser, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CUnsafeLoader(CParser, UnsafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        UnsafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CLoader(CParser, Constructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+class CBaseDumper(CEmitter, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CSafeDumper(CEmitter, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CDumper(CEmitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/dumper.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/dumper.py
new file mode 100644
index 0000000000000000000000000000000000000000..6aadba551f3836b02f4752277f4b3027073defad
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/dumper.py
@@ -0,0 +1,62 @@
+
+__all__ = ['BaseDumper', 'SafeDumper', 'Dumper']
+
+from .emitter import *
+from .serializer import *
+from .representer import *
+from .resolver import *
+
+class BaseDumper(Emitter, Serializer, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class SafeDumper(Emitter, Serializer, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class Dumper(Emitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/emitter.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/emitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..a664d011162af69184df2f8e59ab7feec818f7c7
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/emitter.py
@@ -0,0 +1,1137 @@
+
+# Emitter expects events obeying the following grammar:
+# stream ::= STREAM-START document* STREAM-END
+# document ::= DOCUMENT-START node DOCUMENT-END
+# node ::= SCALAR | sequence | mapping
+# sequence ::= SEQUENCE-START node* SEQUENCE-END
+# mapping ::= MAPPING-START (node node)* MAPPING-END
+
+__all__ = ['Emitter', 'EmitterError']
+
+from .error import YAMLError
+from .events import *
+
+class EmitterError(YAMLError):
+    pass
+
+class ScalarAnalysis:
+    def __init__(self, scalar, empty, multiline,
+            allow_flow_plain, allow_block_plain,
+            allow_single_quoted, allow_double_quoted,
+            allow_block):
+        self.scalar = scalar
+        self.empty = empty
+        self.multiline = multiline
+        self.allow_flow_plain = allow_flow_plain
+        self.allow_block_plain = allow_block_plain
+        self.allow_single_quoted = allow_single_quoted
+        self.allow_double_quoted = allow_double_quoted
+        self.allow_block = allow_block
+
+class Emitter:
+
+    DEFAULT_TAG_PREFIXES = {
+        '!' : '!',
+        'tag:yaml.org,2002:' : '!!',
+    }
+
+    def __init__(self, stream, canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None):
+
+        # The stream should have the methods `write` and possibly `flush`.
+        self.stream = stream
+
+        # Encoding can be overridden by STREAM-START.
+        self.encoding = None
+
+        # Emitter is a state machine with a stack of states to handle nested
+        # structures.
+        self.states = []
+        self.state = self.expect_stream_start
+
+        # Current event and the event queue.
+        self.events = []
+        self.event = None
+
+        # The current indentation level and the stack of previous indents.
+        self.indents = []
+        self.indent = None
+
+        # Flow level.
+        self.flow_level = 0
+
+        # Contexts.
+        self.root_context = False
+        self.sequence_context = False
+        self.mapping_context = False
+        self.simple_key_context = False
+
+        # Characteristics of the last emitted character:
+        #  - current position.
+        #  - is it a whitespace?
+        #  - is it an indention character
+        #    (indentation space, '-', '?', or ':')?
+        self.line = 0
+        self.column = 0
+        self.whitespace = True
+        self.indention = True
+
+        # Whether the document requires an explicit document indicator
+        self.open_ended = False
+
+        # Formatting details.
+        self.canonical = canonical
+        self.allow_unicode = allow_unicode
+        self.best_indent = 2
+        if indent and 1 < indent < 10:
+            self.best_indent = indent
+        self.best_width = 80
+        if width and width > self.best_indent*2:
+            self.best_width = width
+        self.best_line_break = '\n'
+        if line_break in ['\r', '\n', '\r\n']:
+            self.best_line_break = line_break
+
+        # Tag prefixes.
+        self.tag_prefixes = None
+
+        # Prepared anchor and tag.
+        self.prepared_anchor = None
+        self.prepared_tag = None
+
+        # Scalar analysis and style.
+        self.analysis = None
+        self.style = None
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def emit(self, event):
+        self.events.append(event)
+        while not self.need_more_events():
+            self.event = self.events.pop(0)
+            self.state()
+            self.event = None
+
+    # In some cases, we wait for a few next events before emitting.
+
+    def need_more_events(self):
+        if not self.events:
+            return True
+        event = self.events[0]
+        if isinstance(event, DocumentStartEvent):
+            return self.need_events(1)
+        elif isinstance(event, SequenceStartEvent):
+            return self.need_events(2)
+        elif isinstance(event, MappingStartEvent):
+            return self.need_events(3)
+        else:
+            return False
+
+    def need_events(self, count):
+        level = 0
+        for event in self.events[1:]:
+            if isinstance(event, (DocumentStartEvent, CollectionStartEvent)):
+                level += 1
+            elif isinstance(event, (DocumentEndEvent, CollectionEndEvent)):
+                level -= 1
+            elif isinstance(event, StreamEndEvent):
+                level = -1
+            if level < 0:
+                return False
+        return (len(self.events) < count+1)
+
+    def increase_indent(self, flow=False, indentless=False):
+        self.indents.append(self.indent)
+        if self.indent is None:
+            if flow:
+                self.indent = self.best_indent
+            else:
+                self.indent = 0
+        elif not indentless:
+            self.indent += self.best_indent
+
+    # States.
+
+    # Stream handlers.
+
+    def expect_stream_start(self):
+        if isinstance(self.event, StreamStartEvent):
+            if self.event.encoding and not hasattr(self.stream, 'encoding'):
+                self.encoding = self.event.encoding
+            self.write_stream_start()
+            self.state = self.expect_first_document_start
+        else:
+            raise EmitterError("expected StreamStartEvent, but got %s"
+                    % self.event)
+
+    def expect_nothing(self):
+        raise EmitterError("expected nothing, but got %s" % self.event)
+
+    # Document handlers.
+
+    def expect_first_document_start(self):
+        return self.expect_document_start(first=True)
+
+    def expect_document_start(self, first=False):
+        if isinstance(self.event, DocumentStartEvent):
+            if (self.event.version or self.event.tags) and self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            if self.event.version:
+                version_text = self.prepare_version(self.event.version)
+                self.write_version_directive(version_text)
+            self.tag_prefixes = self.DEFAULT_TAG_PREFIXES.copy()
+            if self.event.tags:
+                handles = sorted(self.event.tags.keys())
+                for handle in handles:
+                    prefix = self.event.tags[handle]
+                    self.tag_prefixes[prefix] = handle
+                    handle_text = self.prepare_tag_handle(handle)
+                    prefix_text = self.prepare_tag_prefix(prefix)
+                    self.write_tag_directive(handle_text, prefix_text)
+            implicit = (first and not self.event.explicit and not self.canonical
+                    and not self.event.version and not self.event.tags
+                    and not self.check_empty_document())
+            if not implicit:
+                self.write_indent()
+                self.write_indicator('---', True)
+                if self.canonical:
+                    self.write_indent()
+            self.state = self.expect_document_root
+        elif isinstance(self.event, StreamEndEvent):
+            if self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.write_stream_end()
+            self.state = self.expect_nothing
+        else:
+            raise EmitterError("expected DocumentStartEvent, but got %s"
+                    % self.event)
+
+    def expect_document_end(self):
+        if isinstance(self.event, DocumentEndEvent):
+            self.write_indent()
+            if self.event.explicit:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.flush_stream()
+            self.state = self.expect_document_start
+        else:
+            raise EmitterError("expected DocumentEndEvent, but got %s"
+                    % self.event)
+
+    def expect_document_root(self):
+        self.states.append(self.expect_document_end)
+        self.expect_node(root=True)
+
+    # Node handlers.
+
+    def expect_node(self, root=False, sequence=False, mapping=False,
+            simple_key=False):
+        self.root_context = root
+        self.sequence_context = sequence
+        self.mapping_context = mapping
+        self.simple_key_context = simple_key
+        if isinstance(self.event, AliasEvent):
+            self.expect_alias()
+        elif isinstance(self.event, (ScalarEvent, CollectionStartEvent)):
+            self.process_anchor('&')
+            self.process_tag()
+            if isinstance(self.event, ScalarEvent):
+                self.expect_scalar()
+            elif isinstance(self.event, SequenceStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_sequence():
+                    self.expect_flow_sequence()
+                else:
+                    self.expect_block_sequence()
+            elif isinstance(self.event, MappingStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_mapping():
+                    self.expect_flow_mapping()
+                else:
+                    self.expect_block_mapping()
+        else:
+            raise EmitterError("expected NodeEvent, but got %s" % self.event)
+
+    def expect_alias(self):
+        if self.event.anchor is None:
+            raise EmitterError("anchor is not specified for alias")
+        self.process_anchor('*')
+        self.state = self.states.pop()
+
+    def expect_scalar(self):
+        self.increase_indent(flow=True)
+        self.process_scalar()
+        self.indent = self.indents.pop()
+        self.state = self.states.pop()
+
+    # Flow sequence handlers.
+
+    def expect_flow_sequence(self):
+        self.write_indicator('[', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_sequence_item
+
+    def expect_first_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    def expect_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Flow mapping handlers.
+
+    def expect_flow_mapping(self):
+        self.write_indicator('{', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_mapping_key
+
+    def expect_first_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_flow_mapping_value(self):
+        if self.canonical or self.column > self.best_width:
+            self.write_indent()
+        self.write_indicator(':', True)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Block sequence handlers.
+
+    def expect_block_sequence(self):
+        indentless = (self.mapping_context and not self.indention)
+        self.increase_indent(flow=False, indentless=indentless)
+        self.state = self.expect_first_block_sequence_item
+
+    def expect_first_block_sequence_item(self):
+        return self.expect_block_sequence_item(first=True)
+
+    def expect_block_sequence_item(self, first=False):
+        if not first and isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            self.write_indicator('-', True, indention=True)
+            self.states.append(self.expect_block_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Block mapping handlers.
+
+    def expect_block_mapping(self):
+        self.increase_indent(flow=False)
+        self.state = self.expect_first_block_mapping_key
+
+    def expect_first_block_mapping_key(self):
+        return self.expect_block_mapping_key(first=True)
+
+    def expect_block_mapping_key(self, first=False):
+        if not first and isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            if self.check_simple_key():
+                self.states.append(self.expect_block_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True, indention=True)
+                self.states.append(self.expect_block_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_block_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_block_mapping_value(self):
+        self.write_indent()
+        self.write_indicator(':', True, indention=True)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Checkers.
+
+    def check_empty_sequence(self):
+        return (isinstance(self.event, SequenceStartEvent) and self.events
+                and isinstance(self.events[0], SequenceEndEvent))
+
+    def check_empty_mapping(self):
+        return (isinstance(self.event, MappingStartEvent) and self.events
+                and isinstance(self.events[0], MappingEndEvent))
+
+    def check_empty_document(self):
+        if not isinstance(self.event, DocumentStartEvent) or not self.events:
+            return False
+        event = self.events[0]
+        return (isinstance(event, ScalarEvent) and event.anchor is None
+                and event.tag is None and event.implicit and event.value == '')
+
+    def check_simple_key(self):
+        length = 0
+        if isinstance(self.event, NodeEvent) and self.event.anchor is not None:
+            if self.prepared_anchor is None:
+                self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+            length += len(self.prepared_anchor)
+        if isinstance(self.event, (ScalarEvent, CollectionStartEvent))  \
+                and self.event.tag is not None:
+            if self.prepared_tag is None:
+                self.prepared_tag = self.prepare_tag(self.event.tag)
+            length += len(self.prepared_tag)
+        if isinstance(self.event, ScalarEvent):
+            if self.analysis is None:
+                self.analysis = self.analyze_scalar(self.event.value)
+            length += len(self.analysis.scalar)
+        return (length < 128 and (isinstance(self.event, AliasEvent)
+            or (isinstance(self.event, ScalarEvent)
+                    and not self.analysis.empty and not self.analysis.multiline)
+            or self.check_empty_sequence() or self.check_empty_mapping()))
+
+    # Anchor, Tag, and Scalar processors.
+
+    def process_anchor(self, indicator):
+        if self.event.anchor is None:
+            self.prepared_anchor = None
+            return
+        if self.prepared_anchor is None:
+            self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+        if self.prepared_anchor:
+            self.write_indicator(indicator+self.prepared_anchor, True)
+        self.prepared_anchor = None
+
+    def process_tag(self):
+        tag = self.event.tag
+        if isinstance(self.event, ScalarEvent):
+            if self.style is None:
+                self.style = self.choose_scalar_style()
+            if ((not self.canonical or tag is None) and
+                ((self.style == '' and self.event.implicit[0])
+                        or (self.style != '' and self.event.implicit[1]))):
+                self.prepared_tag = None
+                return
+            if self.event.implicit[0] and tag is None:
+                tag = '!'
+                self.prepared_tag = None
+        else:
+            if (not self.canonical or tag is None) and self.event.implicit:
+                self.prepared_tag = None
+                return
+        if tag is None:
+            raise EmitterError("tag is not specified")
+        if self.prepared_tag is None:
+            self.prepared_tag = self.prepare_tag(tag)
+        if self.prepared_tag:
+            self.write_indicator(self.prepared_tag, True)
+        self.prepared_tag = None
+
+    def choose_scalar_style(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.event.style == '"' or self.canonical:
+            return '"'
+        if not self.event.style and self.event.implicit[0]:
+            if (not (self.simple_key_context and
+                    (self.analysis.empty or self.analysis.multiline))
+                and (self.flow_level and self.analysis.allow_flow_plain
+                    or (not self.flow_level and self.analysis.allow_block_plain))):
+                return ''
+        if self.event.style and self.event.style in '|>':
+            if (not self.flow_level and not self.simple_key_context
+                    and self.analysis.allow_block):
+                return self.event.style
+        if not self.event.style or self.event.style == '\'':
+            if (self.analysis.allow_single_quoted and
+                    not (self.simple_key_context and self.analysis.multiline)):
+                return '\''
+        return '"'
+
+    def process_scalar(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.style is None:
+            self.style = self.choose_scalar_style()
+        split = (not self.simple_key_context)
+        #if self.analysis.multiline and split    \
+        #        and (not self.style or self.style in '\'\"'):
+        #    self.write_indent()
+        if self.style == '"':
+            self.write_double_quoted(self.analysis.scalar, split)
+        elif self.style == '\'':
+            self.write_single_quoted(self.analysis.scalar, split)
+        elif self.style == '>':
+            self.write_folded(self.analysis.scalar)
+        elif self.style == '|':
+            self.write_literal(self.analysis.scalar)
+        else:
+            self.write_plain(self.analysis.scalar, split)
+        self.analysis = None
+        self.style = None
+
+    # Analyzers.
+
+    def prepare_version(self, version):
+        major, minor = version
+        if major != 1:
+            raise EmitterError("unsupported YAML version: %d.%d" % (major, minor))
+        return '%d.%d' % (major, minor)
+
+    def prepare_tag_handle(self, handle):
+        if not handle:
+            raise EmitterError("tag handle must not be empty")
+        if handle[0] != '!' or handle[-1] != '!':
+            raise EmitterError("tag handle must start and end with '!': %r" % handle)
+        for ch in handle[1:-1]:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the tag handle: %r"
+                        % (ch, handle))
+        return handle
+
+    def prepare_tag_prefix(self, prefix):
+        if not prefix:
+            raise EmitterError("tag prefix must not be empty")
+        chunks = []
+        start = end = 0
+        if prefix[0] == '!':
+            end = 1
+        while end < len(prefix):
+            ch = prefix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?!:@&=+$,_.~*\'()[]':
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(prefix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ord(ch))
+        if start < end:
+            chunks.append(prefix[start:end])
+        return ''.join(chunks)
+
+    def prepare_tag(self, tag):
+        if not tag:
+            raise EmitterError("tag must not be empty")
+        if tag == '!':
+            return tag
+        handle = None
+        suffix = tag
+        prefixes = sorted(self.tag_prefixes.keys())
+        for prefix in prefixes:
+            if tag.startswith(prefix)   \
+                    and (prefix == '!' or len(prefix) < len(tag)):
+                handle = self.tag_prefixes[prefix]
+                suffix = tag[len(prefix):]
+        chunks = []
+        start = end = 0
+        while end < len(suffix):
+            ch = suffix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?:@&=+$,_.~*\'()[]'   \
+                    or (ch == '!' and handle != '!'):
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(suffix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ch)
+        if start < end:
+            chunks.append(suffix[start:end])
+        suffix_text = ''.join(chunks)
+        if handle:
+            return '%s%s' % (handle, suffix_text)
+        else:
+            return '!<%s>' % suffix_text
+
+    def prepare_anchor(self, anchor):
+        if not anchor:
+            raise EmitterError("anchor must not be empty")
+        for ch in anchor:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the anchor: %r"
+                        % (ch, anchor))
+        return anchor
+
+    def analyze_scalar(self, scalar):
+
+        # Empty scalar is a special case.
+        if not scalar:
+            return ScalarAnalysis(scalar=scalar, empty=True, multiline=False,
+                    allow_flow_plain=False, allow_block_plain=True,
+                    allow_single_quoted=True, allow_double_quoted=True,
+                    allow_block=False)
+
+        # Indicators and special characters.
+        block_indicators = False
+        flow_indicators = False
+        line_breaks = False
+        special_characters = False
+
+        # Important whitespace combinations.
+        leading_space = False
+        leading_break = False
+        trailing_space = False
+        trailing_break = False
+        break_space = False
+        space_break = False
+
+        # Check document indicators.
+        if scalar.startswith('---') or scalar.startswith('...'):
+            block_indicators = True
+            flow_indicators = True
+
+        # First character or preceded by a whitespace.
+        preceded_by_whitespace = True
+
+        # Last character or followed by a whitespace.
+        followed_by_whitespace = (len(scalar) == 1 or
+                scalar[1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # The previous character is a space.
+        previous_space = False
+
+        # The previous character is a break.
+        previous_break = False
+
+        index = 0
+        while index < len(scalar):
+            ch = scalar[index]
+
+            # Check for indicators.
+            if index == 0:
+                # Leading indicators are special characters.
+                if ch in '#,[]{}&*!|>\'\"%@`':
+                    flow_indicators = True
+                    block_indicators = True
+                if ch in '?:':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '-' and followed_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+            else:
+                # Some indicators cannot appear within a scalar as well.
+                if ch in ',?[]{}':
+                    flow_indicators = True
+                if ch == ':':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '#' and preceded_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+
+            # Check for line breaks, special, and unicode characters.
+            if ch in '\n\x85\u2028\u2029':
+                line_breaks = True
+            if not (ch == '\n' or '\x20' <= ch <= '\x7E'):
+                if (ch == '\x85' or '\xA0' <= ch <= '\uD7FF'
+                        or '\uE000' <= ch <= '\uFFFD'
+                        or '\U00010000' <= ch < '\U0010ffff') and ch != '\uFEFF':
+                    unicode_characters = True
+                    if not self.allow_unicode:
+                        special_characters = True
+                else:
+                    special_characters = True
+
+            # Detect important whitespace combinations.
+            if ch == ' ':
+                if index == 0:
+                    leading_space = True
+                if index == len(scalar)-1:
+                    trailing_space = True
+                if previous_break:
+                    break_space = True
+                previous_space = True
+                previous_break = False
+            elif ch in '\n\x85\u2028\u2029':
+                if index == 0:
+                    leading_break = True
+                if index == len(scalar)-1:
+                    trailing_break = True
+                if previous_space:
+                    space_break = True
+                previous_space = False
+                previous_break = True
+            else:
+                previous_space = False
+                previous_break = False
+
+            # Prepare for the next character.
+            index += 1
+            preceded_by_whitespace = (ch in '\0 \t\r\n\x85\u2028\u2029')
+            followed_by_whitespace = (index+1 >= len(scalar) or
+                    scalar[index+1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # Let's decide what styles are allowed.
+        allow_flow_plain = True
+        allow_block_plain = True
+        allow_single_quoted = True
+        allow_double_quoted = True
+        allow_block = True
+
+        # Leading and trailing whitespaces are bad for plain scalars.
+        if (leading_space or leading_break
+                or trailing_space or trailing_break):
+            allow_flow_plain = allow_block_plain = False
+
+        # We do not permit trailing spaces for block scalars.
+        if trailing_space:
+            allow_block = False
+
+        # Spaces at the beginning of a new line are only acceptable for block
+        # scalars.
+        if break_space:
+            allow_flow_plain = allow_block_plain = allow_single_quoted = False
+
+        # Spaces followed by breaks, as well as special character are only
+        # allowed for double quoted scalars.
+        if space_break or special_characters:
+            allow_flow_plain = allow_block_plain =  \
+            allow_single_quoted = allow_block = False
+
+        # Although the plain scalar writer supports breaks, we never emit
+        # multiline plain scalars.
+        if line_breaks:
+            allow_flow_plain = allow_block_plain = False
+
+        # Flow indicators are forbidden for flow plain scalars.
+        if flow_indicators:
+            allow_flow_plain = False
+
+        # Block indicators are forbidden for block plain scalars.
+        if block_indicators:
+            allow_block_plain = False
+
+        return ScalarAnalysis(scalar=scalar,
+                empty=False, multiline=line_breaks,
+                allow_flow_plain=allow_flow_plain,
+                allow_block_plain=allow_block_plain,
+                allow_single_quoted=allow_single_quoted,
+                allow_double_quoted=allow_double_quoted,
+                allow_block=allow_block)
+
+    # Writers.
+
+    def flush_stream(self):
+        if hasattr(self.stream, 'flush'):
+            self.stream.flush()
+
+    def write_stream_start(self):
+        # Write BOM if needed.
+        if self.encoding and self.encoding.startswith('utf-16'):
+            self.stream.write('\uFEFF'.encode(self.encoding))
+
+    def write_stream_end(self):
+        self.flush_stream()
+
+    def write_indicator(self, indicator, need_whitespace,
+            whitespace=False, indention=False):
+        if self.whitespace or not need_whitespace:
+            data = indicator
+        else:
+            data = ' '+indicator
+        self.whitespace = whitespace
+        self.indention = self.indention and indention
+        self.column += len(data)
+        self.open_ended = False
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_indent(self):
+        indent = self.indent or 0
+        if not self.indention or self.column > indent   \
+                or (self.column == indent and not self.whitespace):
+            self.write_line_break()
+        if self.column < indent:
+            self.whitespace = True
+            data = ' '*(indent-self.column)
+            self.column = indent
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+
+    def write_line_break(self, data=None):
+        if data is None:
+            data = self.best_line_break
+        self.whitespace = True
+        self.indention = True
+        self.line += 1
+        self.column = 0
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_version_directive(self, version_text):
+        data = '%%YAML %s' % version_text
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    def write_tag_directive(self, handle_text, prefix_text):
+        data = '%%TAG %s %s' % (handle_text, prefix_text)
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    # Scalar streams.
+
+    def write_single_quoted(self, text, split=True):
+        self.write_indicator('\'', True)
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch is None or ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split   \
+                            and start != 0 and end != len(text):
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029' or ch == '\'':
+                    if start < end:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                        start = end
+            if ch == '\'':
+                data = '\'\''
+                self.column += 2
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                start = end + 1
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+        self.write_indicator('\'', False)
+
+    ESCAPE_REPLACEMENTS = {
+        '\0':       '0',
+        '\x07':     'a',
+        '\x08':     'b',
+        '\x09':     't',
+        '\x0A':     'n',
+        '\x0B':     'v',
+        '\x0C':     'f',
+        '\x0D':     'r',
+        '\x1B':     'e',
+        '\"':       '\"',
+        '\\':       '\\',
+        '\x85':     'N',
+        '\xA0':     '_',
+        '\u2028':   'L',
+        '\u2029':   'P',
+    }
+
+    def write_double_quoted(self, text, split=True):
+        self.write_indicator('"', True)
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if ch is None or ch in '"\\\x85\u2028\u2029\uFEFF' \
+                    or not ('\x20' <= ch <= '\x7E'
+                        or (self.allow_unicode
+                            and ('\xA0' <= ch <= '\uD7FF'
+                                or '\uE000' <= ch <= '\uFFFD'))):
+                if start < end:
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+                if ch is not None:
+                    if ch in self.ESCAPE_REPLACEMENTS:
+                        data = '\\'+self.ESCAPE_REPLACEMENTS[ch]
+                    elif ch <= '\xFF':
+                        data = '\\x%02X' % ord(ch)
+                    elif ch <= '\uFFFF':
+                        data = '\\u%04X' % ord(ch)
+                    else:
+                        data = '\\U%08X' % ord(ch)
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end+1
+            if 0 < end < len(text)-1 and (ch == ' ' or start >= end)    \
+                    and self.column+(end-start) > self.best_width and split:
+                data = text[start:end]+'\\'
+                if start < end:
+                    start = end
+                self.column += len(data)
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                self.write_indent()
+                self.whitespace = False
+                self.indention = False
+                if text[start] == ' ':
+                    data = '\\'
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+            end += 1
+        self.write_indicator('"', False)
+
+    def determine_block_hints(self, text):
+        hints = ''
+        if text:
+            if text[0] in ' \n\x85\u2028\u2029':
+                hints += str(self.best_indent)
+            if text[-1] not in '\n\x85\u2028\u2029':
+                hints += '-'
+            elif len(text) == 1 or text[-2] in '\n\x85\u2028\u2029':
+                hints += '+'
+        return hints
+
+    def write_folded(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('>'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        leading_space = True
+        spaces = False
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if not leading_space and ch is not None and ch != ' '   \
+                            and text[start] == '\n':
+                        self.write_line_break()
+                    leading_space = (ch == ' ')
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            elif spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width:
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+                spaces = (ch == ' ')
+            end += 1
+
+    def write_literal(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('|'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in '\n\x85\u2028\u2029':
+                    data = text[start:end]
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+
+    def write_plain(self, text, split=True):
+        if self.root_context:
+            self.open_ended = True
+        if not text:
+            return
+        if not self.whitespace:
+            data = ' '
+            self.column += len(data)
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+        self.whitespace = False
+        self.indention = False
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split:
+                        self.write_indent()
+                        self.whitespace = False
+                        self.indention = False
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    self.whitespace = False
+                    self.indention = False
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/error.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/error.py
new file mode 100644
index 0000000000000000000000000000000000000000..b796b4dc519512c4825ff539a2e6aa20f4d370d0
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/error.py
@@ -0,0 +1,75 @@
+
+__all__ = ['Mark', 'YAMLError', 'MarkedYAMLError']
+
+class Mark:
+
+    def __init__(self, name, index, line, column, buffer, pointer):
+        self.name = name
+        self.index = index
+        self.line = line
+        self.column = column
+        self.buffer = buffer
+        self.pointer = pointer
+
+    def get_snippet(self, indent=4, max_length=75):
+        if self.buffer is None:
+            return None
+        head = ''
+        start = self.pointer
+        while start > 0 and self.buffer[start-1] not in '\0\r\n\x85\u2028\u2029':
+            start -= 1
+            if self.pointer-start > max_length/2-1:
+                head = ' ... '
+                start += 5
+                break
+        tail = ''
+        end = self.pointer
+        while end < len(self.buffer) and self.buffer[end] not in '\0\r\n\x85\u2028\u2029':
+            end += 1
+            if end-self.pointer > max_length/2-1:
+                tail = ' ... '
+                end -= 5
+                break
+        snippet = self.buffer[start:end]
+        return ' '*indent + head + snippet + tail + '\n'  \
+                + ' '*(indent+self.pointer-start+len(head)) + '^'
+
+    def __str__(self):
+        snippet = self.get_snippet()
+        where = "  in \"%s\", line %d, column %d"   \
+                % (self.name, self.line+1, self.column+1)
+        if snippet is not None:
+            where += ":\n"+snippet
+        return where
+
+class YAMLError(Exception):
+    pass
+
+class MarkedYAMLError(YAMLError):
+
+    def __init__(self, context=None, context_mark=None,
+            problem=None, problem_mark=None, note=None):
+        self.context = context
+        self.context_mark = context_mark
+        self.problem = problem
+        self.problem_mark = problem_mark
+        self.note = note
+
+    def __str__(self):
+        lines = []
+        if self.context is not None:
+            lines.append(self.context)
+        if self.context_mark is not None  \
+            and (self.problem is None or self.problem_mark is None
+                    or self.context_mark.name != self.problem_mark.name
+                    or self.context_mark.line != self.problem_mark.line
+                    or self.context_mark.column != self.problem_mark.column):
+            lines.append(str(self.context_mark))
+        if self.problem is not None:
+            lines.append(self.problem)
+        if self.problem_mark is not None:
+            lines.append(str(self.problem_mark))
+        if self.note is not None:
+            lines.append(self.note)
+        return '\n'.join(lines)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/events.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/events.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79ad389cb6c9517e391dcd25534866bc9ccd36a
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/events.py
@@ -0,0 +1,86 @@
+
+# Abstract classes.
+
+class Event(object):
+    def __init__(self, start_mark=None, end_mark=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in ['anchor', 'tag', 'implicit', 'value']
+                if hasattr(self, key)]
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+class NodeEvent(Event):
+    def __init__(self, anchor, start_mark=None, end_mark=None):
+        self.anchor = anchor
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class CollectionStartEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, start_mark=None, end_mark=None,
+            flow_style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class CollectionEndEvent(Event):
+    pass
+
+# Implementations.
+
+class StreamStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None, encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndEvent(Event):
+    pass
+
+class DocumentStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None, version=None, tags=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+        self.version = version
+        self.tags = tags
+
+class DocumentEndEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+
+class AliasEvent(NodeEvent):
+    pass
+
+class ScalarEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, value,
+            start_mark=None, end_mark=None, style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class SequenceStartEvent(CollectionStartEvent):
+    pass
+
+class SequenceEndEvent(CollectionEndEvent):
+    pass
+
+class MappingStartEvent(CollectionStartEvent):
+    pass
+
+class MappingEndEvent(CollectionEndEvent):
+    pass
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/loader.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..e90c11224c38e559cdf0cb205f0692ebd4fb8681
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/loader.py
@@ -0,0 +1,63 @@
+
+__all__ = ['BaseLoader', 'FullLoader', 'SafeLoader', 'Loader', 'UnsafeLoader']
+
+from .reader import *
+from .scanner import *
+from .parser import *
+from .composer import *
+from .constructor import *
+from .resolver import *
+
+class BaseLoader(Reader, Scanner, Parser, Composer, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class FullLoader(Reader, Scanner, Parser, Composer, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class SafeLoader(Reader, Scanner, Parser, Composer, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class Loader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+# UnsafeLoader is the same as Loader (which is and was always unsafe on
+# untrusted input). Use of either Loader or UnsafeLoader should be rare, since
+# FullLoad should be able to load almost all YAML safely. Loader is left intact
+# to ensure backwards compatibility.
+class UnsafeLoader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/nodes.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4f070c41e1fb1bc01af27d69329e92dded38908
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/nodes.py
@@ -0,0 +1,49 @@
+
+class Node(object):
+    def __init__(self, tag, value, start_mark, end_mark):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        value = self.value
+        #if isinstance(value, list):
+        #    if len(value) == 0:
+        #        value = '<empty>'
+        #    elif len(value) == 1:
+        #        value = '<1 item>'
+        #    else:
+        #        value = '<%d items>' % len(value)
+        #else:
+        #    if len(value) > 75:
+        #        value = repr(value[:70]+u' ... ')
+        #    else:
+        #        value = repr(value)
+        value = repr(value)
+        return '%s(tag=%r, value=%s)' % (self.__class__.__name__, self.tag, value)
+
+class ScalarNode(Node):
+    id = 'scalar'
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class CollectionNode(Node):
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, flow_style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class SequenceNode(CollectionNode):
+    id = 'sequence'
+
+class MappingNode(CollectionNode):
+    id = 'mapping'
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/parser.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..13a5995d292045d0f865a99abf692bd35dc87814
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/parser.py
@@ -0,0 +1,589 @@
+
+# The following YAML grammar is LL(1) and is parsed by a recursive descent
+# parser.
+#
+# stream            ::= STREAM-START implicit_document? explicit_document* STREAM-END
+# implicit_document ::= block_node DOCUMENT-END*
+# explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+# block_node_or_indentless_sequence ::=
+#                       ALIAS
+#                       | properties (block_content | indentless_block_sequence)?
+#                       | block_content
+#                       | indentless_block_sequence
+# block_node        ::= ALIAS
+#                       | properties block_content?
+#                       | block_content
+# flow_node         ::= ALIAS
+#                       | properties flow_content?
+#                       | flow_content
+# properties        ::= TAG ANCHOR? | ANCHOR TAG?
+# block_content     ::= block_collection | flow_collection | SCALAR
+# flow_content      ::= flow_collection | SCALAR
+# block_collection  ::= block_sequence | block_mapping
+# flow_collection   ::= flow_sequence | flow_mapping
+# block_sequence    ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+# indentless_sequence   ::= (BLOCK-ENTRY block_node?)+
+# block_mapping     ::= BLOCK-MAPPING_START
+#                       ((KEY block_node_or_indentless_sequence?)?
+#                       (VALUE block_node_or_indentless_sequence?)?)*
+#                       BLOCK-END
+# flow_sequence     ::= FLOW-SEQUENCE-START
+#                       (flow_sequence_entry FLOW-ENTRY)*
+#                       flow_sequence_entry?
+#                       FLOW-SEQUENCE-END
+# flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+# flow_mapping      ::= FLOW-MAPPING-START
+#                       (flow_mapping_entry FLOW-ENTRY)*
+#                       flow_mapping_entry?
+#                       FLOW-MAPPING-END
+# flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+#
+# FIRST sets:
+#
+# stream: { STREAM-START }
+# explicit_document: { DIRECTIVE DOCUMENT-START }
+# implicit_document: FIRST(block_node)
+# block_node: { ALIAS TAG ANCHOR SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_node: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_content: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# flow_content: { FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# block_collection: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_sequence: { BLOCK-SEQUENCE-START }
+# block_mapping: { BLOCK-MAPPING-START }
+# block_node_or_indentless_sequence: { ALIAS ANCHOR TAG SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START BLOCK-ENTRY }
+# indentless_sequence: { ENTRY }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_sequence: { FLOW-SEQUENCE-START }
+# flow_mapping: { FLOW-MAPPING-START }
+# flow_sequence_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+# flow_mapping_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+
+__all__ = ['Parser', 'ParserError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+from .events import *
+from .scanner import *
+
+class ParserError(MarkedYAMLError):
+    pass
+
+class Parser:
+    # Since writing a recursive-descendant parser is a straightforward task, we
+    # do not give many comments here.
+
+    DEFAULT_TAGS = {
+        '!':   '!',
+        '!!':  'tag:yaml.org,2002:',
+    }
+
+    def __init__(self):
+        self.current_event = None
+        self.yaml_version = None
+        self.tag_handles = {}
+        self.states = []
+        self.marks = []
+        self.state = self.parse_stream_start
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def check_event(self, *choices):
+        # Check the type of the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        if self.current_event is not None:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.current_event, choice):
+                    return True
+        return False
+
+    def peek_event(self):
+        # Get the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        return self.current_event
+
+    def get_event(self):
+        # Get the next event and proceed further.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        value = self.current_event
+        self.current_event = None
+        return value
+
+    # stream    ::= STREAM-START implicit_document? explicit_document* STREAM-END
+    # implicit_document ::= block_node DOCUMENT-END*
+    # explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+
+    def parse_stream_start(self):
+
+        # Parse the stream start.
+        token = self.get_token()
+        event = StreamStartEvent(token.start_mark, token.end_mark,
+                encoding=token.encoding)
+
+        # Prepare the next state.
+        self.state = self.parse_implicit_document_start
+
+        return event
+
+    def parse_implicit_document_start(self):
+
+        # Parse an implicit document.
+        if not self.check_token(DirectiveToken, DocumentStartToken,
+                StreamEndToken):
+            self.tag_handles = self.DEFAULT_TAGS
+            token = self.peek_token()
+            start_mark = end_mark = token.start_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=False)
+
+            # Prepare the next state.
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_block_node
+
+            return event
+
+        else:
+            return self.parse_document_start()
+
+    def parse_document_start(self):
+
+        # Parse any extra document end indicators.
+        while self.check_token(DocumentEndToken):
+            self.get_token()
+
+        # Parse an explicit document.
+        if not self.check_token(StreamEndToken):
+            token = self.peek_token()
+            start_mark = token.start_mark
+            version, tags = self.process_directives()
+            if not self.check_token(DocumentStartToken):
+                raise ParserError(None, None,
+                        "expected '<document start>', but found %r"
+                        % self.peek_token().id,
+                        self.peek_token().start_mark)
+            token = self.get_token()
+            end_mark = token.end_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=True, version=version, tags=tags)
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_document_content
+        else:
+            # Parse the end of the stream.
+            token = self.get_token()
+            event = StreamEndEvent(token.start_mark, token.end_mark)
+            assert not self.states
+            assert not self.marks
+            self.state = None
+        return event
+
+    def parse_document_end(self):
+
+        # Parse the document end.
+        token = self.peek_token()
+        start_mark = end_mark = token.start_mark
+        explicit = False
+        if self.check_token(DocumentEndToken):
+            token = self.get_token()
+            end_mark = token.end_mark
+            explicit = True
+        event = DocumentEndEvent(start_mark, end_mark,
+                explicit=explicit)
+
+        # Prepare the next state.
+        self.state = self.parse_document_start
+
+        return event
+
+    def parse_document_content(self):
+        if self.check_token(DirectiveToken,
+                DocumentStartToken, DocumentEndToken, StreamEndToken):
+            event = self.process_empty_scalar(self.peek_token().start_mark)
+            self.state = self.states.pop()
+            return event
+        else:
+            return self.parse_block_node()
+
+    def process_directives(self):
+        self.yaml_version = None
+        self.tag_handles = {}
+        while self.check_token(DirectiveToken):
+            token = self.get_token()
+            if token.name == 'YAML':
+                if self.yaml_version is not None:
+                    raise ParserError(None, None,
+                            "found duplicate YAML directive", token.start_mark)
+                major, minor = token.value
+                if major != 1:
+                    raise ParserError(None, None,
+                            "found incompatible YAML document (version 1.* is required)",
+                            token.start_mark)
+                self.yaml_version = token.value
+            elif token.name == 'TAG':
+                handle, prefix = token.value
+                if handle in self.tag_handles:
+                    raise ParserError(None, None,
+                            "duplicate tag handle %r" % handle,
+                            token.start_mark)
+                self.tag_handles[handle] = prefix
+        if self.tag_handles:
+            value = self.yaml_version, self.tag_handles.copy()
+        else:
+            value = self.yaml_version, None
+        for key in self.DEFAULT_TAGS:
+            if key not in self.tag_handles:
+                self.tag_handles[key] = self.DEFAULT_TAGS[key]
+        return value
+
+    # block_node_or_indentless_sequence ::= ALIAS
+    #               | properties (block_content | indentless_block_sequence)?
+    #               | block_content
+    #               | indentless_block_sequence
+    # block_node    ::= ALIAS
+    #                   | properties block_content?
+    #                   | block_content
+    # flow_node     ::= ALIAS
+    #                   | properties flow_content?
+    #                   | flow_content
+    # properties    ::= TAG ANCHOR? | ANCHOR TAG?
+    # block_content     ::= block_collection | flow_collection | SCALAR
+    # flow_content      ::= flow_collection | SCALAR
+    # block_collection  ::= block_sequence | block_mapping
+    # flow_collection   ::= flow_sequence | flow_mapping
+
+    def parse_block_node(self):
+        return self.parse_node(block=True)
+
+    def parse_flow_node(self):
+        return self.parse_node()
+
+    def parse_block_node_or_indentless_sequence(self):
+        return self.parse_node(block=True, indentless_sequence=True)
+
+    def parse_node(self, block=False, indentless_sequence=False):
+        if self.check_token(AliasToken):
+            token = self.get_token()
+            event = AliasEvent(token.value, token.start_mark, token.end_mark)
+            self.state = self.states.pop()
+        else:
+            anchor = None
+            tag = None
+            start_mark = end_mark = tag_mark = None
+            if self.check_token(AnchorToken):
+                token = self.get_token()
+                start_mark = token.start_mark
+                end_mark = token.end_mark
+                anchor = token.value
+                if self.check_token(TagToken):
+                    token = self.get_token()
+                    tag_mark = token.start_mark
+                    end_mark = token.end_mark
+                    tag = token.value
+            elif self.check_token(TagToken):
+                token = self.get_token()
+                start_mark = tag_mark = token.start_mark
+                end_mark = token.end_mark
+                tag = token.value
+                if self.check_token(AnchorToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    anchor = token.value
+            if tag is not None:
+                handle, suffix = tag
+                if handle is not None:
+                    if handle not in self.tag_handles:
+                        raise ParserError("while parsing a node", start_mark,
+                                "found undefined tag handle %r" % handle,
+                                tag_mark)
+                    tag = self.tag_handles[handle]+suffix
+                else:
+                    tag = suffix
+            #if tag == '!':
+            #    raise ParserError("while parsing a node", start_mark,
+            #            "found non-specific tag '!'", tag_mark,
+            #            "Please check 'http://pyyaml.org/wiki/YAMLNonSpecificTag' and share your opinion.")
+            if start_mark is None:
+                start_mark = end_mark = self.peek_token().start_mark
+            event = None
+            implicit = (tag is None or tag == '!')
+            if indentless_sequence and self.check_token(BlockEntryToken):
+                end_mark = self.peek_token().end_mark
+                event = SequenceStartEvent(anchor, tag, implicit,
+                        start_mark, end_mark)
+                self.state = self.parse_indentless_sequence_entry
+            else:
+                if self.check_token(ScalarToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    if (token.plain and tag is None) or tag == '!':
+                        implicit = (True, False)
+                    elif tag is None:
+                        implicit = (False, True)
+                    else:
+                        implicit = (False, False)
+                    event = ScalarEvent(anchor, tag, implicit, token.value,
+                            start_mark, end_mark, style=token.style)
+                    self.state = self.states.pop()
+                elif self.check_token(FlowSequenceStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_sequence_first_entry
+                elif self.check_token(FlowMappingStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_mapping_first_key
+                elif block and self.check_token(BlockSequenceStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_sequence_first_entry
+                elif block and self.check_token(BlockMappingStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_mapping_first_key
+                elif anchor is not None or tag is not None:
+                    # Empty scalars are allowed even if a tag or an anchor is
+                    # specified.
+                    event = ScalarEvent(anchor, tag, (implicit, False), '',
+                            start_mark, end_mark)
+                    self.state = self.states.pop()
+                else:
+                    if block:
+                        node = 'block'
+                    else:
+                        node = 'flow'
+                    token = self.peek_token()
+                    raise ParserError("while parsing a %s node" % node, start_mark,
+                            "expected the node content, but found %r" % token.id,
+                            token.start_mark)
+        return event
+
+    # block_sequence ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+
+    def parse_block_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_sequence_entry()
+
+    def parse_block_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken, BlockEndToken):
+                self.states.append(self.parse_block_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_block_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block collection", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    # indentless_sequence ::= (BLOCK-ENTRY block_node?)+
+
+    def parse_indentless_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken,
+                    KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_indentless_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_indentless_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        token = self.peek_token()
+        event = SequenceEndEvent(token.start_mark, token.start_mark)
+        self.state = self.states.pop()
+        return event
+
+    # block_mapping     ::= BLOCK-MAPPING_START
+    #                       ((KEY block_node_or_indentless_sequence?)?
+    #                       (VALUE block_node_or_indentless_sequence?)?)*
+    #                       BLOCK-END
+
+    def parse_block_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_mapping_key()
+
+    def parse_block_mapping_key(self):
+        if self.check_token(KeyToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_value)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_value
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block mapping", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_block_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_key)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_block_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    # flow_sequence     ::= FLOW-SEQUENCE-START
+    #                       (flow_sequence_entry FLOW-ENTRY)*
+    #                       flow_sequence_entry?
+    #                       FLOW-SEQUENCE-END
+    # flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+    #
+    # Note that while production rules for both flow_sequence_entry and
+    # flow_mapping_entry are equal, their interpretations are different.
+    # For `flow_sequence_entry`, the part `KEY flow_node? (VALUE flow_node?)?`
+    # generate an inline mapping (set syntax).
+
+    def parse_flow_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_sequence_entry(first=True)
+
+    def parse_flow_sequence_entry(self, first=False):
+        if not self.check_token(FlowSequenceEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow sequence", self.marks[-1],
+                            "expected ',' or ']', but got %r" % token.id, token.start_mark)
+            
+            if self.check_token(KeyToken):
+                token = self.peek_token()
+                event = MappingStartEvent(None, None, True,
+                        token.start_mark, token.end_mark,
+                        flow_style=True)
+                self.state = self.parse_flow_sequence_entry_mapping_key
+                return event
+            elif not self.check_token(FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_sequence_entry_mapping_key(self):
+        token = self.get_token()
+        if not self.check_token(ValueToken,
+                FlowEntryToken, FlowSequenceEndToken):
+            self.states.append(self.parse_flow_sequence_entry_mapping_value)
+            return self.parse_flow_node()
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_value
+            return self.process_empty_scalar(token.end_mark)
+
+    def parse_flow_sequence_entry_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry_mapping_end)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_sequence_entry_mapping_end
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_end
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_sequence_entry_mapping_end(self):
+        self.state = self.parse_flow_sequence_entry
+        token = self.peek_token()
+        return MappingEndEvent(token.start_mark, token.start_mark)
+
+    # flow_mapping  ::= FLOW-MAPPING-START
+    #                   (flow_mapping_entry FLOW-ENTRY)*
+    #                   flow_mapping_entry?
+    #                   FLOW-MAPPING-END
+    # flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+
+    def parse_flow_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_mapping_key(first=True)
+
+    def parse_flow_mapping_key(self, first=False):
+        if not self.check_token(FlowMappingEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow mapping", self.marks[-1],
+                            "expected ',' or '}', but got %r" % token.id, token.start_mark)
+            if self.check_token(KeyToken):
+                token = self.get_token()
+                if not self.check_token(ValueToken,
+                        FlowEntryToken, FlowMappingEndToken):
+                    self.states.append(self.parse_flow_mapping_value)
+                    return self.parse_flow_node()
+                else:
+                    self.state = self.parse_flow_mapping_value
+                    return self.process_empty_scalar(token.end_mark)
+            elif not self.check_token(FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_empty_value)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_key)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_mapping_empty_value(self):
+        self.state = self.parse_flow_mapping_key
+        return self.process_empty_scalar(self.peek_token().start_mark)
+
+    def process_empty_scalar(self, mark):
+        return ScalarEvent(None, None, (True, False), '', mark, mark)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/reader.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/reader.py
new file mode 100644
index 0000000000000000000000000000000000000000..774b0219b5932a0ee1c27e637371de5ba8d9cb16
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/reader.py
@@ -0,0 +1,185 @@
+# This module contains abstractions for the input stream. You don't have to
+# looks further, there are no pretty code.
+#
+# We define two classes here.
+#
+#   Mark(source, line, column)
+# It's just a record and its only use is producing nice error messages.
+# Parser does not use it for any other purposes.
+#
+#   Reader(source, data)
+# Reader determines the encoding of `data` and converts it to unicode.
+# Reader provides the following methods and attributes:
+#   reader.peek(length=1) - return the next `length` characters
+#   reader.forward(length=1) - move the current position to `length` characters.
+#   reader.index - the number of the current character.
+#   reader.line, stream.column - the line and the column of the current character.
+
+__all__ = ['Reader', 'ReaderError']
+
+from .error import YAMLError, Mark
+
+import codecs, re
+
+class ReaderError(YAMLError):
+
+    def __init__(self, name, position, character, encoding, reason):
+        self.name = name
+        self.character = character
+        self.position = position
+        self.encoding = encoding
+        self.reason = reason
+
+    def __str__(self):
+        if isinstance(self.character, bytes):
+            return "'%s' codec can't decode byte #x%02x: %s\n"  \
+                    "  in \"%s\", position %d"    \
+                    % (self.encoding, ord(self.character), self.reason,
+                            self.name, self.position)
+        else:
+            return "unacceptable character #x%04x: %s\n"    \
+                    "  in \"%s\", position %d"    \
+                    % (self.character, self.reason,
+                            self.name, self.position)
+
+class Reader(object):
+    # Reader:
+    # - determines the data encoding and converts it to a unicode string,
+    # - checks if characters are in allowed range,
+    # - adds '\0' to the end.
+
+    # Reader accepts
+    #  - a `bytes` object,
+    #  - a `str` object,
+    #  - a file-like object with its `read` method returning `str`,
+    #  - a file-like object with its `read` method returning `unicode`.
+
+    # Yeah, it's ugly and slow.
+
+    def __init__(self, stream):
+        self.name = None
+        self.stream = None
+        self.stream_pointer = 0
+        self.eof = True
+        self.buffer = ''
+        self.pointer = 0
+        self.raw_buffer = None
+        self.raw_decode = None
+        self.encoding = None
+        self.index = 0
+        self.line = 0
+        self.column = 0
+        if isinstance(stream, str):
+            self.name = "<unicode string>"
+            self.check_printable(stream)
+            self.buffer = stream+'\0'
+        elif isinstance(stream, bytes):
+            self.name = "<byte string>"
+            self.raw_buffer = stream
+            self.determine_encoding()
+        else:
+            self.stream = stream
+            self.name = getattr(stream, 'name', "<file>")
+            self.eof = False
+            self.raw_buffer = None
+            self.determine_encoding()
+
+    def peek(self, index=0):
+        try:
+            return self.buffer[self.pointer+index]
+        except IndexError:
+            self.update(index+1)
+            return self.buffer[self.pointer+index]
+
+    def prefix(self, length=1):
+        if self.pointer+length >= len(self.buffer):
+            self.update(length)
+        return self.buffer[self.pointer:self.pointer+length]
+
+    def forward(self, length=1):
+        if self.pointer+length+1 >= len(self.buffer):
+            self.update(length+1)
+        while length:
+            ch = self.buffer[self.pointer]
+            self.pointer += 1
+            self.index += 1
+            if ch in '\n\x85\u2028\u2029'  \
+                    or (ch == '\r' and self.buffer[self.pointer] != '\n'):
+                self.line += 1
+                self.column = 0
+            elif ch != '\uFEFF':
+                self.column += 1
+            length -= 1
+
+    def get_mark(self):
+        if self.stream is None:
+            return Mark(self.name, self.index, self.line, self.column,
+                    self.buffer, self.pointer)
+        else:
+            return Mark(self.name, self.index, self.line, self.column,
+                    None, None)
+
+    def determine_encoding(self):
+        while not self.eof and (self.raw_buffer is None or len(self.raw_buffer) < 2):
+            self.update_raw()
+        if isinstance(self.raw_buffer, bytes):
+            if self.raw_buffer.startswith(codecs.BOM_UTF16_LE):
+                self.raw_decode = codecs.utf_16_le_decode
+                self.encoding = 'utf-16-le'
+            elif self.raw_buffer.startswith(codecs.BOM_UTF16_BE):
+                self.raw_decode = codecs.utf_16_be_decode
+                self.encoding = 'utf-16-be'
+            else:
+                self.raw_decode = codecs.utf_8_decode
+                self.encoding = 'utf-8'
+        self.update(1)
+
+    NON_PRINTABLE = re.compile('[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]')
+    def check_printable(self, data):
+        match = self.NON_PRINTABLE.search(data)
+        if match:
+            character = match.group()
+            position = self.index+(len(self.buffer)-self.pointer)+match.start()
+            raise ReaderError(self.name, position, ord(character),
+                    'unicode', "special characters are not allowed")
+
+    def update(self, length):
+        if self.raw_buffer is None:
+            return
+        self.buffer = self.buffer[self.pointer:]
+        self.pointer = 0
+        while len(self.buffer) < length:
+            if not self.eof:
+                self.update_raw()
+            if self.raw_decode is not None:
+                try:
+                    data, converted = self.raw_decode(self.raw_buffer,
+                            'strict', self.eof)
+                except UnicodeDecodeError as exc:
+                    character = self.raw_buffer[exc.start]
+                    if self.stream is not None:
+                        position = self.stream_pointer-len(self.raw_buffer)+exc.start
+                    else:
+                        position = exc.start
+                    raise ReaderError(self.name, position, character,
+                            exc.encoding, exc.reason)
+            else:
+                data = self.raw_buffer
+                converted = len(data)
+            self.check_printable(data)
+            self.buffer += data
+            self.raw_buffer = self.raw_buffer[converted:]
+            if self.eof:
+                self.buffer += '\0'
+                self.raw_buffer = None
+                break
+
+    def update_raw(self, size=4096):
+        data = self.stream.read(size)
+        if self.raw_buffer is None:
+            self.raw_buffer = data
+        else:
+            self.raw_buffer += data
+        self.stream_pointer += len(data)
+        if not data:
+            self.eof = True
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/representer.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/representer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b0b192ef32ed7f5b7015456fe883c3327bb841e
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/representer.py
@@ -0,0 +1,389 @@
+
+__all__ = ['BaseRepresenter', 'SafeRepresenter', 'Representer',
+    'RepresenterError']
+
+from .error import *
+from .nodes import *
+
+import datetime, copyreg, types, base64, collections
+
+class RepresenterError(YAMLError):
+    pass
+
+class BaseRepresenter:
+
+    yaml_representers = {}
+    yaml_multi_representers = {}
+
+    def __init__(self, default_style=None, default_flow_style=False, sort_keys=True):
+        self.default_style = default_style
+        self.sort_keys = sort_keys
+        self.default_flow_style = default_flow_style
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent(self, data):
+        node = self.represent_data(data)
+        self.serialize(node)
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent_data(self, data):
+        if self.ignore_aliases(data):
+            self.alias_key = None
+        else:
+            self.alias_key = id(data)
+        if self.alias_key is not None:
+            if self.alias_key in self.represented_objects:
+                node = self.represented_objects[self.alias_key]
+                #if node is None:
+                #    raise RepresenterError("recursive objects are not allowed: %r" % data)
+                return node
+            #self.represented_objects[alias_key] = None
+            self.object_keeper.append(data)
+        data_types = type(data).__mro__
+        if data_types[0] in self.yaml_representers:
+            node = self.yaml_representers[data_types[0]](self, data)
+        else:
+            for data_type in data_types:
+                if data_type in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[data_type](self, data)
+                    break
+            else:
+                if None in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[None](self, data)
+                elif None in self.yaml_representers:
+                    node = self.yaml_representers[None](self, data)
+                else:
+                    node = ScalarNode(None, str(data))
+        #if alias_key is not None:
+        #    self.represented_objects[alias_key] = node
+        return node
+
+    @classmethod
+    def add_representer(cls, data_type, representer):
+        if not 'yaml_representers' in cls.__dict__:
+            cls.yaml_representers = cls.yaml_representers.copy()
+        cls.yaml_representers[data_type] = representer
+
+    @classmethod
+    def add_multi_representer(cls, data_type, representer):
+        if not 'yaml_multi_representers' in cls.__dict__:
+            cls.yaml_multi_representers = cls.yaml_multi_representers.copy()
+        cls.yaml_multi_representers[data_type] = representer
+
+    def represent_scalar(self, tag, value, style=None):
+        if style is None:
+            style = self.default_style
+        node = ScalarNode(tag, value, style=style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        return node
+
+    def represent_sequence(self, tag, sequence, flow_style=None):
+        value = []
+        node = SequenceNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        for item in sequence:
+            node_item = self.represent_data(item)
+            if not (isinstance(node_item, ScalarNode) and not node_item.style):
+                best_style = False
+            value.append(node_item)
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def represent_mapping(self, tag, mapping, flow_style=None):
+        value = []
+        node = MappingNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        if hasattr(mapping, 'items'):
+            mapping = list(mapping.items())
+            if self.sort_keys:
+                try:
+                    mapping = sorted(mapping)
+                except TypeError:
+                    pass
+        for item_key, item_value in mapping:
+            node_key = self.represent_data(item_key)
+            node_value = self.represent_data(item_value)
+            if not (isinstance(node_key, ScalarNode) and not node_key.style):
+                best_style = False
+            if not (isinstance(node_value, ScalarNode) and not node_value.style):
+                best_style = False
+            value.append((node_key, node_value))
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def ignore_aliases(self, data):
+        return False
+
+class SafeRepresenter(BaseRepresenter):
+
+    def ignore_aliases(self, data):
+        if data is None:
+            return True
+        if isinstance(data, tuple) and data == ():
+            return True
+        if isinstance(data, (str, bytes, bool, int, float)):
+            return True
+
+    def represent_none(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:null', 'null')
+
+    def represent_str(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:str', data)
+
+    def represent_binary(self, data):
+        if hasattr(base64, 'encodebytes'):
+            data = base64.encodebytes(data).decode('ascii')
+        else:
+            data = base64.encodestring(data).decode('ascii')
+        return self.represent_scalar('tag:yaml.org,2002:binary', data, style='|')
+
+    def represent_bool(self, data):
+        if data:
+            value = 'true'
+        else:
+            value = 'false'
+        return self.represent_scalar('tag:yaml.org,2002:bool', value)
+
+    def represent_int(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:int', str(data))
+
+    inf_value = 1e300
+    while repr(inf_value) != repr(inf_value*inf_value):
+        inf_value *= inf_value
+
+    def represent_float(self, data):
+        if data != data or (data == 0.0 and data == 1.0):
+            value = '.nan'
+        elif data == self.inf_value:
+            value = '.inf'
+        elif data == -self.inf_value:
+            value = '-.inf'
+        else:
+            value = repr(data).lower()
+            # Note that in some cases `repr(data)` represents a float number
+            # without the decimal parts.  For instance:
+            #   >>> repr(1e17)
+            #   '1e17'
+            # Unfortunately, this is not a valid float representation according
+            # to the definition of the `!!float` tag.  We fix this by adding
+            # '.0' before the 'e' symbol.
+            if '.' not in value and 'e' in value:
+                value = value.replace('e', '.0e', 1)
+        return self.represent_scalar('tag:yaml.org,2002:float', value)
+
+    def represent_list(self, data):
+        #pairs = (len(data) > 0 and isinstance(data, list))
+        #if pairs:
+        #    for item in data:
+        #        if not isinstance(item, tuple) or len(item) != 2:
+        #            pairs = False
+        #            break
+        #if not pairs:
+            return self.represent_sequence('tag:yaml.org,2002:seq', data)
+        #value = []
+        #for item_key, item_value in data:
+        #    value.append(self.represent_mapping(u'tag:yaml.org,2002:map',
+        #        [(item_key, item_value)]))
+        #return SequenceNode(u'tag:yaml.org,2002:pairs', value)
+
+    def represent_dict(self, data):
+        return self.represent_mapping('tag:yaml.org,2002:map', data)
+
+    def represent_set(self, data):
+        value = {}
+        for key in data:
+            value[key] = None
+        return self.represent_mapping('tag:yaml.org,2002:set', value)
+
+    def represent_date(self, data):
+        value = data.isoformat()
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_datetime(self, data):
+        value = data.isoformat(' ')
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_yaml_object(self, tag, data, cls, flow_style=None):
+        if hasattr(data, '__getstate__'):
+            state = data.__getstate__()
+        else:
+            state = data.__dict__.copy()
+        return self.represent_mapping(tag, state, flow_style=flow_style)
+
+    def represent_undefined(self, data):
+        raise RepresenterError("cannot represent an object", data)
+
+SafeRepresenter.add_representer(type(None),
+        SafeRepresenter.represent_none)
+
+SafeRepresenter.add_representer(str,
+        SafeRepresenter.represent_str)
+
+SafeRepresenter.add_representer(bytes,
+        SafeRepresenter.represent_binary)
+
+SafeRepresenter.add_representer(bool,
+        SafeRepresenter.represent_bool)
+
+SafeRepresenter.add_representer(int,
+        SafeRepresenter.represent_int)
+
+SafeRepresenter.add_representer(float,
+        SafeRepresenter.represent_float)
+
+SafeRepresenter.add_representer(list,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(tuple,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(dict,
+        SafeRepresenter.represent_dict)
+
+SafeRepresenter.add_representer(set,
+        SafeRepresenter.represent_set)
+
+SafeRepresenter.add_representer(datetime.date,
+        SafeRepresenter.represent_date)
+
+SafeRepresenter.add_representer(datetime.datetime,
+        SafeRepresenter.represent_datetime)
+
+SafeRepresenter.add_representer(None,
+        SafeRepresenter.represent_undefined)
+
+class Representer(SafeRepresenter):
+
+    def represent_complex(self, data):
+        if data.imag == 0.0:
+            data = '%r' % data.real
+        elif data.real == 0.0:
+            data = '%rj' % data.imag
+        elif data.imag > 0:
+            data = '%r+%rj' % (data.real, data.imag)
+        else:
+            data = '%r%rj' % (data.real, data.imag)
+        return self.represent_scalar('tag:yaml.org,2002:python/complex', data)
+
+    def represent_tuple(self, data):
+        return self.represent_sequence('tag:yaml.org,2002:python/tuple', data)
+
+    def represent_name(self, data):
+        name = '%s.%s' % (data.__module__, data.__name__)
+        return self.represent_scalar('tag:yaml.org,2002:python/name:'+name, '')
+
+    def represent_module(self, data):
+        return self.represent_scalar(
+                'tag:yaml.org,2002:python/module:'+data.__name__, '')
+
+    def represent_object(self, data):
+        # We use __reduce__ API to save the data. data.__reduce__ returns
+        # a tuple of length 2-5:
+        #   (function, args, state, listitems, dictitems)
+
+        # For reconstructing, we calls function(*args), then set its state,
+        # listitems, and dictitems if they are not None.
+
+        # A special case is when function.__name__ == '__newobj__'. In this
+        # case we create the object with args[0].__new__(*args).
+
+        # Another special case is when __reduce__ returns a string - we don't
+        # support it.
+
+        # We produce a !!python/object, !!python/object/new or
+        # !!python/object/apply node.
+
+        cls = type(data)
+        if cls in copyreg.dispatch_table:
+            reduce = copyreg.dispatch_table[cls](data)
+        elif hasattr(data, '__reduce_ex__'):
+            reduce = data.__reduce_ex__(2)
+        elif hasattr(data, '__reduce__'):
+            reduce = data.__reduce__()
+        else:
+            raise RepresenterError("cannot represent an object", data)
+        reduce = (list(reduce)+[None]*5)[:5]
+        function, args, state, listitems, dictitems = reduce
+        args = list(args)
+        if state is None:
+            state = {}
+        if listitems is not None:
+            listitems = list(listitems)
+        if dictitems is not None:
+            dictitems = dict(dictitems)
+        if function.__name__ == '__newobj__':
+            function = args[0]
+            args = args[1:]
+            tag = 'tag:yaml.org,2002:python/object/new:'
+            newobj = True
+        else:
+            tag = 'tag:yaml.org,2002:python/object/apply:'
+            newobj = False
+        function_name = '%s.%s' % (function.__module__, function.__name__)
+        if not args and not listitems and not dictitems \
+                and isinstance(state, dict) and newobj:
+            return self.represent_mapping(
+                    'tag:yaml.org,2002:python/object:'+function_name, state)
+        if not listitems and not dictitems  \
+                and isinstance(state, dict) and not state:
+            return self.represent_sequence(tag+function_name, args)
+        value = {}
+        if args:
+            value['args'] = args
+        if state or not isinstance(state, dict):
+            value['state'] = state
+        if listitems:
+            value['listitems'] = listitems
+        if dictitems:
+            value['dictitems'] = dictitems
+        return self.represent_mapping(tag+function_name, value)
+
+    def represent_ordered_dict(self, data):
+        # Provide uniform representation across different Python versions.
+        data_type = type(data)
+        tag = 'tag:yaml.org,2002:python/object/apply:%s.%s' \
+                % (data_type.__module__, data_type.__name__)
+        items = [[key, value] for key, value in data.items()]
+        return self.represent_sequence(tag, [items])
+
+Representer.add_representer(complex,
+        Representer.represent_complex)
+
+Representer.add_representer(tuple,
+        Representer.represent_tuple)
+
+Representer.add_representer(type,
+        Representer.represent_name)
+
+Representer.add_representer(collections.OrderedDict,
+        Representer.represent_ordered_dict)
+
+Representer.add_representer(types.FunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.BuiltinFunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.ModuleType,
+        Representer.represent_module)
+
+Representer.add_multi_representer(object,
+        Representer.represent_object)
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/resolver.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/resolver.py
new file mode 100644
index 0000000000000000000000000000000000000000..013896d2f10619e0e75d2579cd63220338a7fef1
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/resolver.py
@@ -0,0 +1,227 @@
+
+__all__ = ['BaseResolver', 'Resolver']
+
+from .error import *
+from .nodes import *
+
+import re
+
+class ResolverError(YAMLError):
+    pass
+
+class BaseResolver:
+
+    DEFAULT_SCALAR_TAG = 'tag:yaml.org,2002:str'
+    DEFAULT_SEQUENCE_TAG = 'tag:yaml.org,2002:seq'
+    DEFAULT_MAPPING_TAG = 'tag:yaml.org,2002:map'
+
+    yaml_implicit_resolvers = {}
+    yaml_path_resolvers = {}
+
+    def __init__(self):
+        self.resolver_exact_paths = []
+        self.resolver_prefix_paths = []
+
+    @classmethod
+    def add_implicit_resolver(cls, tag, regexp, first):
+        if not 'yaml_implicit_resolvers' in cls.__dict__:
+            implicit_resolvers = {}
+            for key in cls.yaml_implicit_resolvers:
+                implicit_resolvers[key] = cls.yaml_implicit_resolvers[key][:]
+            cls.yaml_implicit_resolvers = implicit_resolvers
+        if first is None:
+            first = [None]
+        for ch in first:
+            cls.yaml_implicit_resolvers.setdefault(ch, []).append((tag, regexp))
+
+    @classmethod
+    def add_path_resolver(cls, tag, path, kind=None):
+        # Note: `add_path_resolver` is experimental.  The API could be changed.
+        # `new_path` is a pattern that is matched against the path from the
+        # root to the node that is being considered.  `node_path` elements are
+        # tuples `(node_check, index_check)`.  `node_check` is a node class:
+        # `ScalarNode`, `SequenceNode`, `MappingNode` or `None`.  `None`
+        # matches any kind of a node.  `index_check` could be `None`, a boolean
+        # value, a string value, or a number.  `None` and `False` match against
+        # any _value_ of sequence and mapping nodes.  `True` matches against
+        # any _key_ of a mapping node.  A string `index_check` matches against
+        # a mapping value that corresponds to a scalar key which content is
+        # equal to the `index_check` value.  An integer `index_check` matches
+        # against a sequence value with the index equal to `index_check`.
+        if not 'yaml_path_resolvers' in cls.__dict__:
+            cls.yaml_path_resolvers = cls.yaml_path_resolvers.copy()
+        new_path = []
+        for element in path:
+            if isinstance(element, (list, tuple)):
+                if len(element) == 2:
+                    node_check, index_check = element
+                elif len(element) == 1:
+                    node_check = element[0]
+                    index_check = True
+                else:
+                    raise ResolverError("Invalid path element: %s" % element)
+            else:
+                node_check = None
+                index_check = element
+            if node_check is str:
+                node_check = ScalarNode
+            elif node_check is list:
+                node_check = SequenceNode
+            elif node_check is dict:
+                node_check = MappingNode
+            elif node_check not in [ScalarNode, SequenceNode, MappingNode]  \
+                    and not isinstance(node_check, str) \
+                    and node_check is not None:
+                raise ResolverError("Invalid node checker: %s" % node_check)
+            if not isinstance(index_check, (str, int))  \
+                    and index_check is not None:
+                raise ResolverError("Invalid index checker: %s" % index_check)
+            new_path.append((node_check, index_check))
+        if kind is str:
+            kind = ScalarNode
+        elif kind is list:
+            kind = SequenceNode
+        elif kind is dict:
+            kind = MappingNode
+        elif kind not in [ScalarNode, SequenceNode, MappingNode]    \
+                and kind is not None:
+            raise ResolverError("Invalid node kind: %s" % kind)
+        cls.yaml_path_resolvers[tuple(new_path), kind] = tag
+
+    def descend_resolver(self, current_node, current_index):
+        if not self.yaml_path_resolvers:
+            return
+        exact_paths = {}
+        prefix_paths = []
+        if current_node:
+            depth = len(self.resolver_prefix_paths)
+            for path, kind in self.resolver_prefix_paths[-1]:
+                if self.check_resolver_prefix(depth, path, kind,
+                        current_node, current_index):
+                    if len(path) > depth:
+                        prefix_paths.append((path, kind))
+                    else:
+                        exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+        else:
+            for path, kind in self.yaml_path_resolvers:
+                if not path:
+                    exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+                else:
+                    prefix_paths.append((path, kind))
+        self.resolver_exact_paths.append(exact_paths)
+        self.resolver_prefix_paths.append(prefix_paths)
+
+    def ascend_resolver(self):
+        if not self.yaml_path_resolvers:
+            return
+        self.resolver_exact_paths.pop()
+        self.resolver_prefix_paths.pop()
+
+    def check_resolver_prefix(self, depth, path, kind,
+            current_node, current_index):
+        node_check, index_check = path[depth-1]
+        if isinstance(node_check, str):
+            if current_node.tag != node_check:
+                return
+        elif node_check is not None:
+            if not isinstance(current_node, node_check):
+                return
+        if index_check is True and current_index is not None:
+            return
+        if (index_check is False or index_check is None)    \
+                and current_index is None:
+            return
+        if isinstance(index_check, str):
+            if not (isinstance(current_index, ScalarNode)
+                    and index_check == current_index.value):
+                return
+        elif isinstance(index_check, int) and not isinstance(index_check, bool):
+            if index_check != current_index:
+                return
+        return True
+
+    def resolve(self, kind, value, implicit):
+        if kind is ScalarNode and implicit[0]:
+            if value == '':
+                resolvers = self.yaml_implicit_resolvers.get('', [])
+            else:
+                resolvers = self.yaml_implicit_resolvers.get(value[0], [])
+            wildcard_resolvers = self.yaml_implicit_resolvers.get(None, [])
+            for tag, regexp in resolvers + wildcard_resolvers:
+                if regexp.match(value):
+                    return tag
+            implicit = implicit[1]
+        if self.yaml_path_resolvers:
+            exact_paths = self.resolver_exact_paths[-1]
+            if kind in exact_paths:
+                return exact_paths[kind]
+            if None in exact_paths:
+                return exact_paths[None]
+        if kind is ScalarNode:
+            return self.DEFAULT_SCALAR_TAG
+        elif kind is SequenceNode:
+            return self.DEFAULT_SEQUENCE_TAG
+        elif kind is MappingNode:
+            return self.DEFAULT_MAPPING_TAG
+
+class Resolver(BaseResolver):
+    pass
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:bool',
+        re.compile(r'''^(?:yes|Yes|YES|no|No|NO
+                    |true|True|TRUE|false|False|FALSE
+                    |on|On|ON|off|Off|OFF)$''', re.X),
+        list('yYnNtTfFoO'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:float',
+        re.compile(r'''^(?:[-+]?(?:[0-9][0-9_]*)\.[0-9_]*(?:[eE][-+][0-9]+)?
+                    |\.[0-9_]+(?:[eE][-+][0-9]+)?
+                    |[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*
+                    |[-+]?\.(?:inf|Inf|INF)
+                    |\.(?:nan|NaN|NAN))$''', re.X),
+        list('-+0123456789.'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:int',
+        re.compile(r'''^(?:[-+]?0b[0-1_]+
+                    |[-+]?0[0-7_]+
+                    |[-+]?(?:0|[1-9][0-9_]*)
+                    |[-+]?0x[0-9a-fA-F_]+
+                    |[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)$''', re.X),
+        list('-+0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:merge',
+        re.compile(r'^(?:<<)$'),
+        ['<'])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:null',
+        re.compile(r'''^(?: ~
+                    |null|Null|NULL
+                    | )$''', re.X),
+        ['~', 'n', 'N', ''])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:timestamp',
+        re.compile(r'''^(?:[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]
+                    |[0-9][0-9][0-9][0-9] -[0-9][0-9]? -[0-9][0-9]?
+                     (?:[Tt]|[ \t]+)[0-9][0-9]?
+                     :[0-9][0-9] :[0-9][0-9] (?:\.[0-9]*)?
+                     (?:[ \t]*(?:Z|[-+][0-9][0-9]?(?::[0-9][0-9])?))?)$''', re.X),
+        list('0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:value',
+        re.compile(r'^(?:=)$'),
+        ['='])
+
+# The following resolver is only for documentation purposes. It cannot work
+# because plain scalars cannot start with '!', '&', or '*'.
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:yaml',
+        re.compile(r'^(?:!|&|\*)$'),
+        list('!&*'))
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/scanner.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/scanner.py
new file mode 100644
index 0000000000000000000000000000000000000000..7437ede1c608266aaca481955f438844479cab4f
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/scanner.py
@@ -0,0 +1,1435 @@
+
+# Scanner produces tokens of the following types:
+# STREAM-START
+# STREAM-END
+# DIRECTIVE(name, value)
+# DOCUMENT-START
+# DOCUMENT-END
+# BLOCK-SEQUENCE-START
+# BLOCK-MAPPING-START
+# BLOCK-END
+# FLOW-SEQUENCE-START
+# FLOW-MAPPING-START
+# FLOW-SEQUENCE-END
+# FLOW-MAPPING-END
+# BLOCK-ENTRY
+# FLOW-ENTRY
+# KEY
+# VALUE
+# ALIAS(value)
+# ANCHOR(value)
+# TAG(value)
+# SCALAR(value, plain, style)
+#
+# Read comments in the Scanner code for more details.
+#
+
+__all__ = ['Scanner', 'ScannerError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+
+class ScannerError(MarkedYAMLError):
+    pass
+
+class SimpleKey:
+    # See below simple keys treatment.
+
+    def __init__(self, token_number, required, index, line, column, mark):
+        self.token_number = token_number
+        self.required = required
+        self.index = index
+        self.line = line
+        self.column = column
+        self.mark = mark
+
+class Scanner:
+
+    def __init__(self):
+        """Initialize the scanner."""
+        # It is assumed that Scanner and Reader will have a common descendant.
+        # Reader do the dirty work of checking for BOM and converting the
+        # input data to Unicode. It also adds NUL to the end.
+        #
+        # Reader supports the following methods
+        #   self.peek(i=0)       # peek the next i-th character
+        #   self.prefix(l=1)     # peek the next l characters
+        #   self.forward(l=1)    # read the next l characters and move the pointer.
+
+        # Had we reached the end of the stream?
+        self.done = False
+
+        # The number of unclosed '{' and '['. `flow_level == 0` means block
+        # context.
+        self.flow_level = 0
+
+        # List of processed tokens that are not yet emitted.
+        self.tokens = []
+
+        # Add the STREAM-START token.
+        self.fetch_stream_start()
+
+        # Number of tokens that were emitted through the `get_token` method.
+        self.tokens_taken = 0
+
+        # The current indentation level.
+        self.indent = -1
+
+        # Past indentation levels.
+        self.indents = []
+
+        # Variables related to simple keys treatment.
+
+        # A simple key is a key that is not denoted by the '?' indicator.
+        # Example of simple keys:
+        #   ---
+        #   block simple key: value
+        #   ? not a simple key:
+        #   : { flow simple key: value }
+        # We emit the KEY token before all keys, so when we find a potential
+        # simple key, we try to locate the corresponding ':' indicator.
+        # Simple keys should be limited to a single line and 1024 characters.
+
+        # Can a simple key start at the current position? A simple key may
+        # start:
+        # - at the beginning of the line, not counting indentation spaces
+        #       (in block context),
+        # - after '{', '[', ',' (in the flow context),
+        # - after '?', ':', '-' (in the block context).
+        # In the block context, this flag also signifies if a block collection
+        # may start at the current position.
+        self.allow_simple_key = True
+
+        # Keep track of possible simple keys. This is a dictionary. The key
+        # is `flow_level`; there can be no more that one possible simple key
+        # for each level. The value is a SimpleKey record:
+        #   (token_number, required, index, line, column, mark)
+        # A simple key may start with ALIAS, ANCHOR, TAG, SCALAR(flow),
+        # '[', or '{' tokens.
+        self.possible_simple_keys = {}
+
+    # Public methods.
+
+    def check_token(self, *choices):
+        # Check if the next token is one of the given types.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.tokens[0], choice):
+                    return True
+        return False
+
+    def peek_token(self):
+        # Return the next token, but do not delete if from the queue.
+        # Return None if no more tokens.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            return self.tokens[0]
+        else:
+            return None
+
+    def get_token(self):
+        # Return the next token.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            self.tokens_taken += 1
+            return self.tokens.pop(0)
+
+    # Private methods.
+
+    def need_more_tokens(self):
+        if self.done:
+            return False
+        if not self.tokens:
+            return True
+        # The current token may be a potential simple key, so we
+        # need to look further.
+        self.stale_possible_simple_keys()
+        if self.next_possible_simple_key() == self.tokens_taken:
+            return True
+
+    def fetch_more_tokens(self):
+
+        # Eat whitespaces and comments until we reach the next token.
+        self.scan_to_next_token()
+
+        # Remove obsolete possible simple keys.
+        self.stale_possible_simple_keys()
+
+        # Compare the current indentation and column. It may add some tokens
+        # and decrease the current indentation level.
+        self.unwind_indent(self.column)
+
+        # Peek the next character.
+        ch = self.peek()
+
+        # Is it the end of stream?
+        if ch == '\0':
+            return self.fetch_stream_end()
+
+        # Is it a directive?
+        if ch == '%' and self.check_directive():
+            return self.fetch_directive()
+
+        # Is it the document start?
+        if ch == '-' and self.check_document_start():
+            return self.fetch_document_start()
+
+        # Is it the document end?
+        if ch == '.' and self.check_document_end():
+            return self.fetch_document_end()
+
+        # TODO: support for BOM within a stream.
+        #if ch == '\uFEFF':
+        #    return self.fetch_bom()    <-- issue BOMToken
+
+        # Note: the order of the following checks is NOT significant.
+
+        # Is it the flow sequence start indicator?
+        if ch == '[':
+            return self.fetch_flow_sequence_start()
+
+        # Is it the flow mapping start indicator?
+        if ch == '{':
+            return self.fetch_flow_mapping_start()
+
+        # Is it the flow sequence end indicator?
+        if ch == ']':
+            return self.fetch_flow_sequence_end()
+
+        # Is it the flow mapping end indicator?
+        if ch == '}':
+            return self.fetch_flow_mapping_end()
+
+        # Is it the flow entry indicator?
+        if ch == ',':
+            return self.fetch_flow_entry()
+
+        # Is it the block entry indicator?
+        if ch == '-' and self.check_block_entry():
+            return self.fetch_block_entry()
+
+        # Is it the key indicator?
+        if ch == '?' and self.check_key():
+            return self.fetch_key()
+
+        # Is it the value indicator?
+        if ch == ':' and self.check_value():
+            return self.fetch_value()
+
+        # Is it an alias?
+        if ch == '*':
+            return self.fetch_alias()
+
+        # Is it an anchor?
+        if ch == '&':
+            return self.fetch_anchor()
+
+        # Is it a tag?
+        if ch == '!':
+            return self.fetch_tag()
+
+        # Is it a literal scalar?
+        if ch == '|' and not self.flow_level:
+            return self.fetch_literal()
+
+        # Is it a folded scalar?
+        if ch == '>' and not self.flow_level:
+            return self.fetch_folded()
+
+        # Is it a single quoted scalar?
+        if ch == '\'':
+            return self.fetch_single()
+
+        # Is it a double quoted scalar?
+        if ch == '\"':
+            return self.fetch_double()
+
+        # It must be a plain scalar then.
+        if self.check_plain():
+            return self.fetch_plain()
+
+        # No? It's an error. Let's produce a nice error message.
+        raise ScannerError("while scanning for the next token", None,
+                "found character %r that cannot start any token" % ch,
+                self.get_mark())
+
+    # Simple keys treatment.
+
+    def next_possible_simple_key(self):
+        # Return the number of the nearest possible simple key. Actually we
+        # don't need to loop through the whole dictionary. We may replace it
+        # with the following code:
+        #   if not self.possible_simple_keys:
+        #       return None
+        #   return self.possible_simple_keys[
+        #           min(self.possible_simple_keys.keys())].token_number
+        min_token_number = None
+        for level in self.possible_simple_keys:
+            key = self.possible_simple_keys[level]
+            if min_token_number is None or key.token_number < min_token_number:
+                min_token_number = key.token_number
+        return min_token_number
+
+    def stale_possible_simple_keys(self):
+        # Remove entries that are no longer possible simple keys. According to
+        # the YAML specification, simple keys
+        # - should be limited to a single line,
+        # - should be no longer than 1024 characters.
+        # Disabling this procedure will allow simple keys of any length and
+        # height (may cause problems if indentation is broken though).
+        for level in list(self.possible_simple_keys):
+            key = self.possible_simple_keys[level]
+            if key.line != self.line  \
+                    or self.index-key.index > 1024:
+                if key.required:
+                    raise ScannerError("while scanning a simple key", key.mark,
+                            "could not find expected ':'", self.get_mark())
+                del self.possible_simple_keys[level]
+
+    def save_possible_simple_key(self):
+        # The next token may start a simple key. We check if it's possible
+        # and save its position. This function is called for
+        #   ALIAS, ANCHOR, TAG, SCALAR(flow), '[', and '{'.
+
+        # Check if a simple key is required at the current position.
+        required = not self.flow_level and self.indent == self.column
+
+        # The next token might be a simple key. Let's save it's number and
+        # position.
+        if self.allow_simple_key:
+            self.remove_possible_simple_key()
+            token_number = self.tokens_taken+len(self.tokens)
+            key = SimpleKey(token_number, required,
+                    self.index, self.line, self.column, self.get_mark())
+            self.possible_simple_keys[self.flow_level] = key
+
+    def remove_possible_simple_key(self):
+        # Remove the saved possible key position at the current flow level.
+        if self.flow_level in self.possible_simple_keys:
+            key = self.possible_simple_keys[self.flow_level]
+            
+            if key.required:
+                raise ScannerError("while scanning a simple key", key.mark,
+                        "could not find expected ':'", self.get_mark())
+
+            del self.possible_simple_keys[self.flow_level]
+
+    # Indentation functions.
+
+    def unwind_indent(self, column):
+
+        ## In flow context, tokens should respect indentation.
+        ## Actually the condition should be `self.indent >= column` according to
+        ## the spec. But this condition will prohibit intuitively correct
+        ## constructions such as
+        ## key : {
+        ## }
+        #if self.flow_level and self.indent > column:
+        #    raise ScannerError(None, None,
+        #            "invalid indentation or unclosed '[' or '{'",
+        #            self.get_mark())
+
+        # In the flow context, indentation is ignored. We make the scanner less
+        # restrictive then specification requires.
+        if self.flow_level:
+            return
+
+        # In block context, we may need to issue the BLOCK-END tokens.
+        while self.indent > column:
+            mark = self.get_mark()
+            self.indent = self.indents.pop()
+            self.tokens.append(BlockEndToken(mark, mark))
+
+    def add_indent(self, column):
+        # Check if we need to increase indentation.
+        if self.indent < column:
+            self.indents.append(self.indent)
+            self.indent = column
+            return True
+        return False
+
+    # Fetchers.
+
+    def fetch_stream_start(self):
+        # We always add STREAM-START as the first token and STREAM-END as the
+        # last token.
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-START.
+        self.tokens.append(StreamStartToken(mark, mark,
+            encoding=self.encoding))
+        
+
+    def fetch_stream_end(self):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+        self.possible_simple_keys = {}
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-END.
+        self.tokens.append(StreamEndToken(mark, mark))
+
+        # The steam is finished.
+        self.done = True
+
+    def fetch_directive(self):
+        
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Scan and add DIRECTIVE.
+        self.tokens.append(self.scan_directive())
+
+    def fetch_document_start(self):
+        self.fetch_document_indicator(DocumentStartToken)
+
+    def fetch_document_end(self):
+        self.fetch_document_indicator(DocumentEndToken)
+
+    def fetch_document_indicator(self, TokenClass):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys. Note that there could not be a block collection
+        # after '---'.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Add DOCUMENT-START or DOCUMENT-END.
+        start_mark = self.get_mark()
+        self.forward(3)
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_start(self):
+        self.fetch_flow_collection_start(FlowSequenceStartToken)
+
+    def fetch_flow_mapping_start(self):
+        self.fetch_flow_collection_start(FlowMappingStartToken)
+
+    def fetch_flow_collection_start(self, TokenClass):
+
+        # '[' and '{' may start a simple key.
+        self.save_possible_simple_key()
+
+        # Increase the flow level.
+        self.flow_level += 1
+
+        # Simple keys are allowed after '[' and '{'.
+        self.allow_simple_key = True
+
+        # Add FLOW-SEQUENCE-START or FLOW-MAPPING-START.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_end(self):
+        self.fetch_flow_collection_end(FlowSequenceEndToken)
+
+    def fetch_flow_mapping_end(self):
+        self.fetch_flow_collection_end(FlowMappingEndToken)
+
+    def fetch_flow_collection_end(self, TokenClass):
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Decrease the flow level.
+        self.flow_level -= 1
+
+        # No simple keys after ']' or '}'.
+        self.allow_simple_key = False
+
+        # Add FLOW-SEQUENCE-END or FLOW-MAPPING-END.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_entry(self):
+
+        # Simple keys are allowed after ','.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add FLOW-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(FlowEntryToken(start_mark, end_mark))
+
+    def fetch_block_entry(self):
+
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a new entry?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "sequence entries are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-SEQUENCE-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockSequenceStartToken(mark, mark))
+
+        # It's an error for the block entry to occur in the flow context,
+        # but we let the parser detect this.
+        else:
+            pass
+
+        # Simple keys are allowed after '-'.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add BLOCK-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(BlockEntryToken(start_mark, end_mark))
+
+    def fetch_key(self):
+        
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a key (not necessary a simple)?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "mapping keys are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-MAPPING-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockMappingStartToken(mark, mark))
+
+        # Simple keys are allowed after '?' in the block context.
+        self.allow_simple_key = not self.flow_level
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add KEY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(KeyToken(start_mark, end_mark))
+
+    def fetch_value(self):
+
+        # Do we determine a simple key?
+        if self.flow_level in self.possible_simple_keys:
+
+            # Add KEY.
+            key = self.possible_simple_keys[self.flow_level]
+            del self.possible_simple_keys[self.flow_level]
+            self.tokens.insert(key.token_number-self.tokens_taken,
+                    KeyToken(key.mark, key.mark))
+
+            # If this key starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.
+            if not self.flow_level:
+                if self.add_indent(key.column):
+                    self.tokens.insert(key.token_number-self.tokens_taken,
+                            BlockMappingStartToken(key.mark, key.mark))
+
+            # There cannot be two simple keys one after another.
+            self.allow_simple_key = False
+
+        # It must be a part of a complex key.
+        else:
+            
+            # Block context needs additional checks.
+            # (Do we really need them? They will be caught by the parser
+            # anyway.)
+            if not self.flow_level:
+
+                # We are allowed to start a complex value if and only if
+                # we can start a simple key.
+                if not self.allow_simple_key:
+                    raise ScannerError(None, None,
+                            "mapping values are not allowed here",
+                            self.get_mark())
+
+            # If this value starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.  It will be detected as an error later by
+            # the parser.
+            if not self.flow_level:
+                if self.add_indent(self.column):
+                    mark = self.get_mark()
+                    self.tokens.append(BlockMappingStartToken(mark, mark))
+
+            # Simple keys are allowed after ':' in the block context.
+            self.allow_simple_key = not self.flow_level
+
+            # Reset possible simple key on the current level.
+            self.remove_possible_simple_key()
+
+        # Add VALUE.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(ValueToken(start_mark, end_mark))
+
+    def fetch_alias(self):
+
+        # ALIAS could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ALIAS.
+        self.allow_simple_key = False
+
+        # Scan and add ALIAS.
+        self.tokens.append(self.scan_anchor(AliasToken))
+
+    def fetch_anchor(self):
+
+        # ANCHOR could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ANCHOR.
+        self.allow_simple_key = False
+
+        # Scan and add ANCHOR.
+        self.tokens.append(self.scan_anchor(AnchorToken))
+
+    def fetch_tag(self):
+
+        # TAG could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after TAG.
+        self.allow_simple_key = False
+
+        # Scan and add TAG.
+        self.tokens.append(self.scan_tag())
+
+    def fetch_literal(self):
+        self.fetch_block_scalar(style='|')
+
+    def fetch_folded(self):
+        self.fetch_block_scalar(style='>')
+
+    def fetch_block_scalar(self, style):
+
+        # A simple key may follow a block scalar.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_block_scalar(style))
+
+    def fetch_single(self):
+        self.fetch_flow_scalar(style='\'')
+
+    def fetch_double(self):
+        self.fetch_flow_scalar(style='"')
+
+    def fetch_flow_scalar(self, style):
+
+        # A flow scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after flow scalars.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_flow_scalar(style))
+
+    def fetch_plain(self):
+
+        # A plain scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after plain scalars. But note that `scan_plain` will
+        # change this flag if the scan is finished at the beginning of the
+        # line.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR. May change `allow_simple_key`.
+        self.tokens.append(self.scan_plain())
+
+    # Checkers.
+
+    def check_directive(self):
+
+        # DIRECTIVE:        ^ '%' ...
+        # The '%' indicator is already checked.
+        if self.column == 0:
+            return True
+
+    def check_document_start(self):
+
+        # DOCUMENT-START:   ^ '---' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '---'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_document_end(self):
+
+        # DOCUMENT-END:     ^ '...' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '...'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_block_entry(self):
+
+        # BLOCK-ENTRY:      '-' (' '|'\n')
+        return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_key(self):
+
+        # KEY(flow context):    '?'
+        if self.flow_level:
+            return True
+
+        # KEY(block context):   '?' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_value(self):
+
+        # VALUE(flow context):  ':'
+        if self.flow_level:
+            return True
+
+        # VALUE(block context): ':' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_plain(self):
+
+        # A plain scalar may start with any non-space character except:
+        #   '-', '?', ':', ',', '[', ']', '{', '}',
+        #   '#', '&', '*', '!', '|', '>', '\'', '\"',
+        #   '%', '@', '`'.
+        #
+        # It may also start with
+        #   '-', '?', ':'
+        # if it is followed by a non-space character.
+        #
+        # Note that we limit the last rule to the block context (except the
+        # '-' character) because we want the flow context to be space
+        # independent.
+        ch = self.peek()
+        return ch not in '\0 \t\r\n\x85\u2028\u2029-?:,[]{}#&*!|>\'\"%@`'  \
+                or (self.peek(1) not in '\0 \t\r\n\x85\u2028\u2029'
+                        and (ch == '-' or (not self.flow_level and ch in '?:')))
+
+    # Scanners.
+
+    def scan_to_next_token(self):
+        # We ignore spaces, line breaks and comments.
+        # If we find a line break in the block context, we set the flag
+        # `allow_simple_key` on.
+        # The byte order mark is stripped if it's the first character in the
+        # stream. We do not yet support BOM inside the stream as the
+        # specification requires. Any such mark will be considered as a part
+        # of the document.
+        #
+        # TODO: We need to make tab handling rules more sane. A good rule is
+        #   Tabs cannot precede tokens
+        #   BLOCK-SEQUENCE-START, BLOCK-MAPPING-START, BLOCK-END,
+        #   KEY(block), VALUE(block), BLOCK-ENTRY
+        # So the checking code is
+        #   if <TAB>:
+        #       self.allow_simple_keys = False
+        # We also need to add the check for `allow_simple_keys == True` to
+        # `unwind_indent` before issuing BLOCK-END.
+        # Scanners for block, flow, and plain scalars need to be modified.
+
+        if self.index == 0 and self.peek() == '\uFEFF':
+            self.forward()
+        found = False
+        while not found:
+            while self.peek() == ' ':
+                self.forward()
+            if self.peek() == '#':
+                while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                    self.forward()
+            if self.scan_line_break():
+                if not self.flow_level:
+                    self.allow_simple_key = True
+            else:
+                found = True
+
+    def scan_directive(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        self.forward()
+        name = self.scan_directive_name(start_mark)
+        value = None
+        if name == 'YAML':
+            value = self.scan_yaml_directive_value(start_mark)
+            end_mark = self.get_mark()
+        elif name == 'TAG':
+            value = self.scan_tag_directive_value(start_mark)
+            end_mark = self.get_mark()
+        else:
+            end_mark = self.get_mark()
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        self.scan_directive_ignored_line(start_mark)
+        return DirectiveToken(name, value, start_mark, end_mark)
+
+    def scan_directive_name(self, start_mark):
+        # See the specification for details.
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        return value
+
+    def scan_yaml_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        major = self.scan_yaml_directive_number(start_mark)
+        if self.peek() != '.':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or '.', but found %r" % self.peek(),
+                    self.get_mark())
+        self.forward()
+        minor = self.scan_yaml_directive_number(start_mark)
+        if self.peek() not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or ' ', but found %r" % self.peek(),
+                    self.get_mark())
+        return (major, minor)
+
+    def scan_yaml_directive_number(self, start_mark):
+        # See the specification for details.
+        ch = self.peek()
+        if not ('0' <= ch <= '9'):
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit, but found %r" % ch, self.get_mark())
+        length = 0
+        while '0' <= self.peek(length) <= '9':
+            length += 1
+        value = int(self.prefix(length))
+        self.forward(length)
+        return value
+
+    def scan_tag_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        handle = self.scan_tag_directive_handle(start_mark)
+        while self.peek() == ' ':
+            self.forward()
+        prefix = self.scan_tag_directive_prefix(start_mark)
+        return (handle, prefix)
+
+    def scan_tag_directive_handle(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_handle('directive', start_mark)
+        ch = self.peek()
+        if ch != ' ':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_tag_directive_prefix(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_uri('directive', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_directive_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a comment or a line break, but found %r"
+                        % ch, self.get_mark())
+        self.scan_line_break()
+
+    def scan_anchor(self, TokenClass):
+        # The specification does not restrict characters for anchors and
+        # aliases. This may lead to problems, for instance, the document:
+        #   [ *alias, value ]
+        # can be interpreted in two ways, as
+        #   [ "value" ]
+        # and
+        #   [ *alias , "value" ]
+        # Therefore we restrict aliases to numbers and ASCII letters.
+        start_mark = self.get_mark()
+        indicator = self.peek()
+        if indicator == '*':
+            name = 'alias'
+        else:
+            name = 'anchor'
+        self.forward()
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \t\r\n\x85\u2028\u2029?:,]}%@`':
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        end_mark = self.get_mark()
+        return TokenClass(value, start_mark, end_mark)
+
+    def scan_tag(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        ch = self.peek(1)
+        if ch == '<':
+            handle = None
+            self.forward(2)
+            suffix = self.scan_tag_uri('tag', start_mark)
+            if self.peek() != '>':
+                raise ScannerError("while parsing a tag", start_mark,
+                        "expected '>', but found %r" % self.peek(),
+                        self.get_mark())
+            self.forward()
+        elif ch in '\0 \t\r\n\x85\u2028\u2029':
+            handle = None
+            suffix = '!'
+            self.forward()
+        else:
+            length = 1
+            use_handle = False
+            while ch not in '\0 \r\n\x85\u2028\u2029':
+                if ch == '!':
+                    use_handle = True
+                    break
+                length += 1
+                ch = self.peek(length)
+            handle = '!'
+            if use_handle:
+                handle = self.scan_tag_handle('tag', start_mark)
+            else:
+                handle = '!'
+                self.forward()
+            suffix = self.scan_tag_uri('tag', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a tag", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        value = (handle, suffix)
+        end_mark = self.get_mark()
+        return TagToken(value, start_mark, end_mark)
+
+    def scan_block_scalar(self, style):
+        # See the specification for details.
+
+        if style == '>':
+            folded = True
+        else:
+            folded = False
+
+        chunks = []
+        start_mark = self.get_mark()
+
+        # Scan the header.
+        self.forward()
+        chomping, increment = self.scan_block_scalar_indicators(start_mark)
+        self.scan_block_scalar_ignored_line(start_mark)
+
+        # Determine the indentation level and go to the first non-empty line.
+        min_indent = self.indent+1
+        if min_indent < 1:
+            min_indent = 1
+        if increment is None:
+            breaks, max_indent, end_mark = self.scan_block_scalar_indentation()
+            indent = max(min_indent, max_indent)
+        else:
+            indent = min_indent+increment-1
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+        line_break = ''
+
+        # Scan the inner part of the block scalar.
+        while self.column == indent and self.peek() != '\0':
+            chunks.extend(breaks)
+            leading_non_space = self.peek() not in ' \t'
+            length = 0
+            while self.peek(length) not in '\0\r\n\x85\u2028\u2029':
+                length += 1
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            line_break = self.scan_line_break()
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+            if self.column == indent and self.peek() != '\0':
+
+                # Unfortunately, folding rules are ambiguous.
+                #
+                # This is the folding according to the specification:
+                
+                if folded and line_break == '\n'    \
+                        and leading_non_space and self.peek() not in ' \t':
+                    if not breaks:
+                        chunks.append(' ')
+                else:
+                    chunks.append(line_break)
+                
+                # This is Clark Evans's interpretation (also in the spec
+                # examples):
+                #
+                #if folded and line_break == '\n':
+                #    if not breaks:
+                #        if self.peek() not in ' \t':
+                #            chunks.append(' ')
+                #        else:
+                #            chunks.append(line_break)
+                #else:
+                #    chunks.append(line_break)
+            else:
+                break
+
+        # Chomp the tail.
+        if chomping is not False:
+            chunks.append(line_break)
+        if chomping is True:
+            chunks.extend(breaks)
+
+        # We are done.
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    def scan_block_scalar_indicators(self, start_mark):
+        # See the specification for details.
+        chomping = None
+        increment = None
+        ch = self.peek()
+        if ch in '+-':
+            if ch == '+':
+                chomping = True
+            else:
+                chomping = False
+            self.forward()
+            ch = self.peek()
+            if ch in '0123456789':
+                increment = int(ch)
+                if increment == 0:
+                    raise ScannerError("while scanning a block scalar", start_mark,
+                            "expected indentation indicator in the range 1-9, but found 0",
+                            self.get_mark())
+                self.forward()
+        elif ch in '0123456789':
+            increment = int(ch)
+            if increment == 0:
+                raise ScannerError("while scanning a block scalar", start_mark,
+                        "expected indentation indicator in the range 1-9, but found 0",
+                        self.get_mark())
+            self.forward()
+            ch = self.peek()
+            if ch in '+-':
+                if ch == '+':
+                    chomping = True
+                else:
+                    chomping = False
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected chomping or indentation indicators, but found %r"
+                    % ch, self.get_mark())
+        return chomping, increment
+
+    def scan_block_scalar_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected a comment or a line break, but found %r" % ch,
+                    self.get_mark())
+        self.scan_line_break()
+
+    def scan_block_scalar_indentation(self):
+        # See the specification for details.
+        chunks = []
+        max_indent = 0
+        end_mark = self.get_mark()
+        while self.peek() in ' \r\n\x85\u2028\u2029':
+            if self.peek() != ' ':
+                chunks.append(self.scan_line_break())
+                end_mark = self.get_mark()
+            else:
+                self.forward()
+                if self.column > max_indent:
+                    max_indent = self.column
+        return chunks, max_indent, end_mark
+
+    def scan_block_scalar_breaks(self, indent):
+        # See the specification for details.
+        chunks = []
+        end_mark = self.get_mark()
+        while self.column < indent and self.peek() == ' ':
+            self.forward()
+        while self.peek() in '\r\n\x85\u2028\u2029':
+            chunks.append(self.scan_line_break())
+            end_mark = self.get_mark()
+            while self.column < indent and self.peek() == ' ':
+                self.forward()
+        return chunks, end_mark
+
+    def scan_flow_scalar(self, style):
+        # See the specification for details.
+        # Note that we loose indentation rules for quoted scalars. Quoted
+        # scalars don't need to adhere indentation because " and ' clearly
+        # mark the beginning and the end of them. Therefore we are less
+        # restrictive then the specification requires. We only need to check
+        # that document separators are not included in scalars.
+        if style == '"':
+            double = True
+        else:
+            double = False
+        chunks = []
+        start_mark = self.get_mark()
+        quote = self.peek()
+        self.forward()
+        chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        while self.peek() != quote:
+            chunks.extend(self.scan_flow_scalar_spaces(double, start_mark))
+            chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        self.forward()
+        end_mark = self.get_mark()
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    ESCAPE_REPLACEMENTS = {
+        '0':    '\0',
+        'a':    '\x07',
+        'b':    '\x08',
+        't':    '\x09',
+        '\t':   '\x09',
+        'n':    '\x0A',
+        'v':    '\x0B',
+        'f':    '\x0C',
+        'r':    '\x0D',
+        'e':    '\x1B',
+        ' ':    '\x20',
+        '\"':   '\"',
+        '\\':   '\\',
+        '/':    '/',
+        'N':    '\x85',
+        '_':    '\xA0',
+        'L':    '\u2028',
+        'P':    '\u2029',
+    }
+
+    ESCAPE_CODES = {
+        'x':    2,
+        'u':    4,
+        'U':    8,
+    }
+
+    def scan_flow_scalar_non_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            length = 0
+            while self.peek(length) not in '\'\"\\\0 \t\r\n\x85\u2028\u2029':
+                length += 1
+            if length:
+                chunks.append(self.prefix(length))
+                self.forward(length)
+            ch = self.peek()
+            if not double and ch == '\'' and self.peek(1) == '\'':
+                chunks.append('\'')
+                self.forward(2)
+            elif (double and ch == '\'') or (not double and ch in '\"\\'):
+                chunks.append(ch)
+                self.forward()
+            elif double and ch == '\\':
+                self.forward()
+                ch = self.peek()
+                if ch in self.ESCAPE_REPLACEMENTS:
+                    chunks.append(self.ESCAPE_REPLACEMENTS[ch])
+                    self.forward()
+                elif ch in self.ESCAPE_CODES:
+                    length = self.ESCAPE_CODES[ch]
+                    self.forward()
+                    for k in range(length):
+                        if self.peek(k) not in '0123456789ABCDEFabcdef':
+                            raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                                    "expected escape sequence of %d hexdecimal numbers, but found %r" %
+                                        (length, self.peek(k)), self.get_mark())
+                    code = int(self.prefix(length), 16)
+                    chunks.append(chr(code))
+                    self.forward(length)
+                elif ch in '\r\n\x85\u2028\u2029':
+                    self.scan_line_break()
+                    chunks.extend(self.scan_flow_scalar_breaks(double, start_mark))
+                else:
+                    raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                            "found unknown escape character %r" % ch, self.get_mark())
+            else:
+                return chunks
+
+    def scan_flow_scalar_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        length = 0
+        while self.peek(length) in ' \t':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch == '\0':
+            raise ScannerError("while scanning a quoted scalar", start_mark,
+                    "found unexpected end of stream", self.get_mark())
+        elif ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            breaks = self.scan_flow_scalar_breaks(double, start_mark)
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        else:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_flow_scalar_breaks(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            # Instead of checking indentation, we check for document
+            # separators.
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                raise ScannerError("while scanning a quoted scalar", start_mark,
+                        "found unexpected document separator", self.get_mark())
+            while self.peek() in ' \t':
+                self.forward()
+            if self.peek() in '\r\n\x85\u2028\u2029':
+                chunks.append(self.scan_line_break())
+            else:
+                return chunks
+
+    def scan_plain(self):
+        # See the specification for details.
+        # We add an additional restriction for the flow context:
+        #   plain scalars in the flow context cannot contain ',' or '?'.
+        # We also keep track of the `allow_simple_key` flag here.
+        # Indentation rules are loosed for the flow context.
+        chunks = []
+        start_mark = self.get_mark()
+        end_mark = start_mark
+        indent = self.indent+1
+        # We allow zero indentation for scalars, but then we need to check for
+        # document separators at the beginning of the line.
+        #if indent == 0:
+        #    indent = 1
+        spaces = []
+        while True:
+            length = 0
+            if self.peek() == '#':
+                break
+            while True:
+                ch = self.peek(length)
+                if ch in '\0 \t\r\n\x85\u2028\u2029'    \
+                        or (ch == ':' and
+                                self.peek(length+1) in '\0 \t\r\n\x85\u2028\u2029'
+                                      + (u',[]{}' if self.flow_level else u''))\
+                        or (self.flow_level and ch in ',?[]{}'):
+                    break
+                length += 1
+            if length == 0:
+                break
+            self.allow_simple_key = False
+            chunks.extend(spaces)
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            end_mark = self.get_mark()
+            spaces = self.scan_plain_spaces(indent, start_mark)
+            if not spaces or self.peek() == '#' \
+                    or (not self.flow_level and self.column < indent):
+                break
+        return ScalarToken(''.join(chunks), True, start_mark, end_mark)
+
+    def scan_plain_spaces(self, indent, start_mark):
+        # See the specification for details.
+        # The specification is really confusing about tabs in plain scalars.
+        # We just forbid them completely. Do not use tabs in YAML!
+        chunks = []
+        length = 0
+        while self.peek(length) in ' ':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            self.allow_simple_key = True
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return
+            breaks = []
+            while self.peek() in ' \r\n\x85\u2028\u2029':
+                if self.peek() == ' ':
+                    self.forward()
+                else:
+                    breaks.append(self.scan_line_break())
+                    prefix = self.prefix(3)
+                    if (prefix == '---' or prefix == '...')   \
+                            and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                        return
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        elif whitespaces:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_tag_handle(self, name, start_mark):
+        # See the specification for details.
+        # For some strange reasons, the specification does not allow '_' in
+        # tag handles. I have allowed it anyway.
+        ch = self.peek()
+        if ch != '!':
+            raise ScannerError("while scanning a %s" % name, start_mark,
+                    "expected '!', but found %r" % ch, self.get_mark())
+        length = 1
+        ch = self.peek(length)
+        if ch != ' ':
+            while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                    or ch in '-_':
+                length += 1
+                ch = self.peek(length)
+            if ch != '!':
+                self.forward(length)
+                raise ScannerError("while scanning a %s" % name, start_mark,
+                        "expected '!', but found %r" % ch, self.get_mark())
+            length += 1
+        value = self.prefix(length)
+        self.forward(length)
+        return value
+
+    def scan_tag_uri(self, name, start_mark):
+        # See the specification for details.
+        # Note: we do not check if URI is well-formed.
+        chunks = []
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-;/?:@&=+$,_.!~*\'()[]%':
+            if ch == '%':
+                chunks.append(self.prefix(length))
+                self.forward(length)
+                length = 0
+                chunks.append(self.scan_uri_escapes(name, start_mark))
+            else:
+                length += 1
+            ch = self.peek(length)
+        if length:
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            length = 0
+        if not chunks:
+            raise ScannerError("while parsing a %s" % name, start_mark,
+                    "expected URI, but found %r" % ch, self.get_mark())
+        return ''.join(chunks)
+
+    def scan_uri_escapes(self, name, start_mark):
+        # See the specification for details.
+        codes = []
+        mark = self.get_mark()
+        while self.peek() == '%':
+            self.forward()
+            for k in range(2):
+                if self.peek(k) not in '0123456789ABCDEFabcdef':
+                    raise ScannerError("while scanning a %s" % name, start_mark,
+                            "expected URI escape sequence of 2 hexdecimal numbers, but found %r"
+                            % self.peek(k), self.get_mark())
+            codes.append(int(self.prefix(2), 16))
+            self.forward(2)
+        try:
+            value = bytes(codes).decode('utf-8')
+        except UnicodeDecodeError as exc:
+            raise ScannerError("while scanning a %s" % name, start_mark, str(exc), mark)
+        return value
+
+    def scan_line_break(self):
+        # Transforms:
+        #   '\r\n'      :   '\n'
+        #   '\r'        :   '\n'
+        #   '\n'        :   '\n'
+        #   '\x85'      :   '\n'
+        #   '\u2028'    :   '\u2028'
+        #   '\u2029     :   '\u2029'
+        #   default     :   ''
+        ch = self.peek()
+        if ch in '\r\n\x85':
+            if self.prefix(2) == '\r\n':
+                self.forward(2)
+            else:
+                self.forward()
+            return '\n'
+        elif ch in '\u2028\u2029':
+            self.forward()
+            return ch
+        return ''
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/serializer.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe911e67ae7a739abb491fbbc6834b9c37bbda4b
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/serializer.py
@@ -0,0 +1,111 @@
+
+__all__ = ['Serializer', 'SerializerError']
+
+from .error import YAMLError
+from .events import *
+from .nodes import *
+
+class SerializerError(YAMLError):
+    pass
+
+class Serializer:
+
+    ANCHOR_TEMPLATE = 'id%03d'
+
+    def __init__(self, encoding=None,
+            explicit_start=None, explicit_end=None, version=None, tags=None):
+        self.use_encoding = encoding
+        self.use_explicit_start = explicit_start
+        self.use_explicit_end = explicit_end
+        self.use_version = version
+        self.use_tags = tags
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+        self.closed = None
+
+    def open(self):
+        if self.closed is None:
+            self.emit(StreamStartEvent(encoding=self.use_encoding))
+            self.closed = False
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        else:
+            raise SerializerError("serializer is already opened")
+
+    def close(self):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif not self.closed:
+            self.emit(StreamEndEvent())
+            self.closed = True
+
+    #def __del__(self):
+    #    self.close()
+
+    def serialize(self, node):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        self.emit(DocumentStartEvent(explicit=self.use_explicit_start,
+            version=self.use_version, tags=self.use_tags))
+        self.anchor_node(node)
+        self.serialize_node(node, None, None)
+        self.emit(DocumentEndEvent(explicit=self.use_explicit_end))
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+
+    def anchor_node(self, node):
+        if node in self.anchors:
+            if self.anchors[node] is None:
+                self.anchors[node] = self.generate_anchor(node)
+        else:
+            self.anchors[node] = None
+            if isinstance(node, SequenceNode):
+                for item in node.value:
+                    self.anchor_node(item)
+            elif isinstance(node, MappingNode):
+                for key, value in node.value:
+                    self.anchor_node(key)
+                    self.anchor_node(value)
+
+    def generate_anchor(self, node):
+        self.last_anchor_id += 1
+        return self.ANCHOR_TEMPLATE % self.last_anchor_id
+
+    def serialize_node(self, node, parent, index):
+        alias = self.anchors[node]
+        if node in self.serialized_nodes:
+            self.emit(AliasEvent(alias))
+        else:
+            self.serialized_nodes[node] = True
+            self.descend_resolver(parent, index)
+            if isinstance(node, ScalarNode):
+                detected_tag = self.resolve(ScalarNode, node.value, (True, False))
+                default_tag = self.resolve(ScalarNode, node.value, (False, True))
+                implicit = (node.tag == detected_tag), (node.tag == default_tag)
+                self.emit(ScalarEvent(alias, node.tag, implicit, node.value,
+                    style=node.style))
+            elif isinstance(node, SequenceNode):
+                implicit = (node.tag
+                            == self.resolve(SequenceNode, node.value, True))
+                self.emit(SequenceStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                index = 0
+                for item in node.value:
+                    self.serialize_node(item, node, index)
+                    index += 1
+                self.emit(SequenceEndEvent())
+            elif isinstance(node, MappingNode):
+                implicit = (node.tag
+                            == self.resolve(MappingNode, node.value, True))
+                self.emit(MappingStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                for key, value in node.value:
+                    self.serialize_node(key, node, None)
+                    self.serialize_node(value, node, key)
+                self.emit(MappingEndEvent())
+            self.ascend_resolver()
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/tokens.py b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/tokens.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d0b48a394ac8c019b401516a12f688df361cf90
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/charms/virtual-pc/venv/yaml/tokens.py
@@ -0,0 +1,104 @@
+
+class Token(object):
+    def __init__(self, start_mark, end_mark):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in self.__dict__
+                if not key.endswith('_mark')]
+        attributes.sort()
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+#class BOMToken(Token):
+#    id = '<byte order mark>'
+
+class DirectiveToken(Token):
+    id = '<directive>'
+    def __init__(self, name, value, start_mark, end_mark):
+        self.name = name
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class DocumentStartToken(Token):
+    id = '<document start>'
+
+class DocumentEndToken(Token):
+    id = '<document end>'
+
+class StreamStartToken(Token):
+    id = '<stream start>'
+    def __init__(self, start_mark=None, end_mark=None,
+            encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndToken(Token):
+    id = '<stream end>'
+
+class BlockSequenceStartToken(Token):
+    id = '<block sequence start>'
+
+class BlockMappingStartToken(Token):
+    id = '<block mapping start>'
+
+class BlockEndToken(Token):
+    id = '<block end>'
+
+class FlowSequenceStartToken(Token):
+    id = '['
+
+class FlowMappingStartToken(Token):
+    id = '{'
+
+class FlowSequenceEndToken(Token):
+    id = ']'
+
+class FlowMappingEndToken(Token):
+    id = '}'
+
+class KeyToken(Token):
+    id = '?'
+
+class ValueToken(Token):
+    id = ':'
+
+class BlockEntryToken(Token):
+    id = '-'
+
+class FlowEntryToken(Token):
+    id = ','
+
+class AliasToken(Token):
+    id = '<alias>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class AnchorToken(Token):
+    id = '<anchor>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class TagToken(Token):
+    id = '<tag>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class ScalarToken(Token):
+    id = '<scalar>'
+    def __init__(self, value, plain, start_mark, end_mark, style=None):
+        self.value = value
+        self.plain = plain
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
diff --git a/SOL004/hackfest_virtual-pc_vnfd/cloud_init/virtual-pc_init b/SOL004/hackfest_virtual-pc_vnfd/cloud_init/virtual-pc_init
new file mode 100644
index 0000000000000000000000000000000000000000..993b62947a1abebd2eff4754be75fec39bc9d5e0
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/cloud_init/virtual-pc_init
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm2021
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/hackfest_virtual-pc_vnfd/virtual-pc_vnfd.yaml b/SOL004/hackfest_virtual-pc_vnfd/virtual-pc_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..511baf03fda4e2d659a2929fe83580dd6dfac05d
--- /dev/null
+++ b/SOL004/hackfest_virtual-pc_vnfd/virtual-pc_vnfd.yaml
@@ -0,0 +1,108 @@
+vnfd:
+  description: Virtual Desktop Computer with Xubuntu Desktop and RDP
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: virtual-pc
+    vdu-profile:
+    - id: virtual-pc
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          id: hackfest_virtual-pc_vnf
+          execution-environment-list:
+          - id: virtual-pc-ee
+            juju:
+              charm: virtual-pc
+              proxy: false
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: virtual-pc-ee
+            seq: 1
+          config-primitive:
+          - name: add-package
+            execution-environment-ref: virtual-pc-ee
+            parameter:
+            - data-type: STRING
+              name: package
+          - name: add-snap
+            execution-environment-ref: virtual-pc-ee
+            parameter:
+            - data-type: STRING
+              name: package
+          - name: announce
+            execution-environment-ref: virtual-pc-ee
+            parameter:
+            - data-type: STRING
+              name: message
+          - name: reboot
+            execution-environment-ref: virtual-pc-ee
+          - name: remove-package
+            execution-environment-ref: virtual-pc-ee
+            parameter:
+            - data-type: STRING
+              name: package
+          - name: remove-snap
+            execution-environment-ref: virtual-pc-ee
+            parameter:
+            - data-type: STRING
+              name: package
+          - name: update-system
+            execution-environment-ref: virtual-pc-ee
+
+  ext-cpd:
+  - id: virtual-pc-private-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: virtual-pc
+  - id: virtual-pc-mgmt-ext
+    int-cpd:
+      cpd: eth1-int
+      vdu-id: virtual-pc
+  id: hackfest_virtual-pc_vnf
+  mgmt-cp: virtual-pc-mgmt-ext
+
+  product-name: hackfest_virtual-pc_vnf
+  provider: Canonical
+  sw-image-desc:
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  vdu:
+  - cloud-init-file: virtual-pc_init
+    description: virtual-pc
+    id: virtual-pc
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          type: PARAVIRT
+    - id: eth1-int
+      virtual-network-interface-requirement:
+      - name: eth1
+        virtual-interface:
+          type: PARAVIRT
+    name: virtual-pc-vdu
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: virtual-pc-vdu-compute
+    virtual-storage-desc:
+    - virtual-pc-vdu-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: virtual-pc-vdu-compute
+    virtual-cpu:
+      num-virtual-cpu: 8
+    virtual-memory:
+      size: 32.0
+  virtual-storage-desc:
+  - id: virtual-pc-vdu-storage
+    size-of-storage: 120
diff --git a/SOL004/hackfest_vyos_ns/hackfest_vyos_nsd.yaml b/SOL004/hackfest_vyos_ns/hackfest_vyos_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..74d02d296152634662a9faf2399724dd98df8aa6
--- /dev/null
+++ b/SOL004/hackfest_vyos_ns/hackfest_vyos_nsd.yaml
@@ -0,0 +1,34 @@
+nsd:
+  nsd:
+  - description: Simple NS with a single VyOS Router VNF
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+            ip-address: 172.21.250.200
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-internal-ext
+          virtual-link-profile-id: internal
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-external-ext
+          virtual-link-profile-id: external
+        vnfd-id: hackfest_vyos-vnf
+    id: hackfest_vyos-ns
+    name: hackfest_vyos-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: internal
+      mgmt-network: true
+    - id: external
+      mgmt-network: true
+    vnfd-id:
+    - hackfest_vyos-vnf
diff --git a/SOL004/hackfest_vyos_vnf/cloud_init/vyos-userdata b/SOL004/hackfest_vyos_vnf/cloud_init/vyos-userdata
new file mode 100644
index 0000000000000000000000000000000000000000..e888432723fdda1ffbd7a1e129ba0b4bdda5a39d
--- /dev/null
+++ b/SOL004/hackfest_vyos_vnf/cloud_init/vyos-userdata
@@ -0,0 +1,23 @@
+#!/bin/vbash
+source /opt/vyatta/etc/functions/script-template
+# Interface Config eth0
+set interfaces ethernet eth0 address 172.21.250.200/22
+set interfaces ethernet eth0 description VyOS-eth0
+# Interface Config eth1
+set interfaces ethernet eth1 address 10.0.0.1/24
+set interfaces ethernet eth1 description VyOS-eth1
+# Interface Config eth2
+set interfaces ethernet eth2 address 10.1.0.1/24
+set interfaces ethernet eth2 description VyOS-eth2
+# System config
+set system host-name vyos-osmTest
+set service ssh listen-address 0.0.0.0
+set service ssh port 22
+set system login user osm authentication plaintext-password osm2020
+# SNMP
+set service snmp community public authorization ro
+set service snmp location "OSM Labs"
+set service snmp contact "glavado@whitestack.com"
+# Save
+commit
+save
diff --git a/SOL004/hackfest_vyos_vnf/hackfest_vyos_vnfd.yaml b/SOL004/hackfest_vyos_vnf/hackfest_vyos_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..acbf2474287ba2c3f2464197575a9fb030c32b6b
--- /dev/null
+++ b/SOL004/hackfest_vyos_vnf/hackfest_vyos_vnfd.yaml
@@ -0,0 +1,97 @@
+vnfd:
+  description: A basic virtual router
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: vyos-VM
+    vdu-profile:
+    - id: vyos-VM
+      min-number-of-instances: 1
+    vnf-configuration-id: default-vnf-configuration
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: vyos-VM
+  - id: vnf-internal-ext
+    int-cpd:
+      cpd: vdu-eth1-int
+      vdu-id: vyos-VM
+  - id: vnf-external-ext
+    int-cpd:
+      cpd: vdu-eth2-int
+      vdu-id: vyos-VM
+  id: hackfest_vyos-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: hackfest_vyos-vnf
+  sw-image-desc:
+  - id: vyos-1.1.7
+    image: vyos-1.1.7
+    name: vyos-1.1.7
+  vdu:
+  - cloud-init-file: vyos-userdata
+    id: vyos-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        position: 0
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth1-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth1
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth2-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth2
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: vyos-VM
+    supplemental-boot-data:
+      boot-data-drive: true
+    sw-image-desc: vyos-1.1.7
+    virtual-compute-desc: vyos-VM-compute
+    virtual-storage-desc:
+    - vyos-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: vyos-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: vyos-VM-storage
+    size-of-storage: 10
+  vnf-configuration:
+  - config-primitive:
+    - name: configure-remote
+      parameter:
+      - data-type: STRING
+        default-value: 0.0.0.0
+        name: magmaIP
+    id: default-vnf-configuration
+    config-access:
+      ssh-access:
+        default-user: osm
+        required: true
+    initial-config-primitive:
+    - name: config
+      parameter:
+      - name: ssh-username
+        value: osm
+      - name: ssh-password
+        value: osm2020
+      - name: ssh-hostname
+        value: <rw_mgmt_ip>
+      seq: 1
+    juju:
+      charm: vyos-config
+      #cloud: k8s
\ No newline at end of file
diff --git a/SOL004/hackfest_vyos_vnf/snmp/snmp.yml b/SOL004/hackfest_vyos_vnf/snmp/snmp.yml
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/k8s_juju_ns/README.md b/SOL004/k8s_juju_ns/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..535dca2f53c6ed1c89264fd26ac00e771380da31
--- /dev/null
+++ b/SOL004/k8s_juju_ns/README.md
@@ -0,0 +1,96 @@
+# Introduction
+
+The NS (k8s\_juju) consists of 1 deployer (k8s\_jujucontroller\_vnf) and 4 nodes (k8s\_jujumachine\_vnf)
+connected to a single network or vld (mgmtnet).
+
+The deployer is a Kubernetes installer based on Juju: it will configure the other 4 nodes to run a Kubernetes cluster. Behind the scenes, the deployer is a Juju controller where the 4 nodes are manually added to a Juju model, then a juju bundle is deployed on that model.
+
+# Onboarding and instantiation
+
+```bash
+osm nfpkg-create k8s_jujumachine_vnf.tar.gz
+osm nfpkg-create k8s_jujucontroller_vnf.tar.gz
+osm nspkg-create k8s_juju_ns.tar.gz
+```
+
+# Instantiation
+
+Instantiation parameters are controlled by `config.yaml`. The relevant parameters are the network in the VIM where the K8s API will eb exposed and where all nodes will be connected (`mgmt` in the example below) and the IP addresses from that network to be assigned to each machine (in the example below, `192.168.0.X`). Create `config.yaml`as follows:
+
+```yaml
+---
+additionalParamsForVnf:
+  -
+    member-vnf-index: k8s_juju
+    additionalParams:
+        MACHINE1: "192.168.0.161"
+        MACHINE2: "192.168.0.162"
+        MACHINE3: "192.168.0.163"
+        MACHINE4: "192.168.0.164"
+        MACHINE5: ""
+        MACHINE6: ""
+        MACHINE7: ""
+        MACHINE8: ""
+        MACHINE9: ""
+        MACHINE10: ""
+        BUNDLE: ""
+vld:
+  -
+    name: mgmtnet
+    vim-network-name: mgmt              #The network in the VIM to connect all nodes of the clusters
+    vnfd-connection-point-ref:
+      -
+        ip-address: "192.168.0.161"
+        member-vnf-index-ref: k8s_vnf1
+        vnfd-connection-point-ref: mgmt
+      -
+        ip-address: "192.168.0.162"
+        member-vnf-index-ref: k8s_vnf2
+        vnfd-connection-point-ref: mgmt
+      -
+        ip-address: "192.168.0.163"
+        member-vnf-index-ref: k8s_vnf3
+        vnfd-connection-point-ref: mgmt
+      -
+        ip-address: "192.168.0.164"
+        member-vnf-index-ref: k8s_vnf4
+        vnfd-connection-point-ref: mgmt
+      -
+        ip-address: "192.168.0.170"
+        member-vnf-index-ref: k8s_juju
+        vnfd-connection-point-ref: mgmt
+```
+
+Then, instantiate the NS
+
+```bash
+osm ns-create --ns_name k8s-cluster --nsd_name k8s_juju --vim_account <VIM_ACCOUNT> --config_file config.yaml --ssh_keys ${HOME}/.ssh/id_rsa.pub
+```
+
+# Check K8s cluster
+
+Connect to the machine running juju (`k8s_juju` in the NS), check that kubeconfig file exists and test kubectl:
+
+```bash
+osm vnf-list --ns k8s-cluster --filter vnfd-ref=k8s_jujucontroller_vnf
+ssh ubuntu@<JUJU_CONTROLLER_IP_ADDRESS>
+cat .kube/config
+kubectl get all
+```
+
+To access the K8s dashboard:
+
+```bash
+juju config kubernetes-master enable-dashboard-addons=true
+```
+
+The dashboard could be accesible running this kubectl command:
+
+```bash
+kubectl proxy --address <JUJU_CONTROLLER_IP_ADDRESS>
+```
+
+And now a SSH tunnel could be done from the computer to the juju controller, and from the web browser access to the dashboard:
+
+<http://localhost:8001/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy/>
+
diff --git a/SOL004/k8s_juju_ns/bundle/bundle.yaml b/SOL004/k8s_juju_ns/bundle/bundle.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..113e9ecee973bf45a9b94c1f1ee4885904c55957
--- /dev/null
+++ b/SOL004/k8s_juju_ns/bundle/bundle.yaml
@@ -0,0 +1,133 @@
+description: A highly-available, production-grade Kubernetes cluster.
+series: bionic
+machines:
+  "0":
+  "1":
+  "2":
+  "3":
+services:
+  containerd:
+    annotations:
+      gui-x: '475'
+      gui-y: '800'
+    charm: cs:~containers/containerd-20
+    resources: {}
+  easyrsa:
+    annotations:
+      gui-x: '90'
+      gui-y: '420'
+    charm: cs:~containers/easyrsa-270
+    constraints: root-disk=8G
+    num_units: 1
+    resources:
+      easyrsa: 5
+    to:
+    - "0"
+  etcd:
+    annotations:
+      gui-x: '800'
+      gui-y: '420'
+    charm: cs:~containers/etcd-449
+    constraints: root-disk=8G
+    num_units: 3
+    options:
+      channel: 3.2/stable
+    resources:
+      core: 0
+      etcd: 3
+      snapshot: 0
+    to:
+    - "1"
+    - "2"
+    - "3"
+  flannel:
+    annotations:
+      gui-x: '475'
+      gui-y: '605'
+    charm: cs:~containers/flannel-438
+    resources:
+      flannel-amd64: 394
+      flannel-arm64: 390
+      flannel-s390x: 377
+  kubeapi-load-balancer:
+    annotations:
+      gui-x: '450'
+      gui-y: '250'
+    charm: cs:~containers/kubeapi-load-balancer-664
+    constraints: root-disk=8G
+    expose: true
+    num_units: 1
+    resources: {}
+    to:
+    - "0"
+  kubernetes-master:
+    annotations:
+      gui-x: '800'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-master-724
+    constraints: cores=2 mem=4G root-disk=16G
+    num_units: 2
+    options:
+      channel: 1.15/stable
+    resources:
+      cdk-addons: 0
+      core: 0
+      kube-apiserver: 0
+      kube-controller-manager: 0
+      kube-proxy: 0
+      kube-scheduler: 0
+      kubectl: 0
+    to:
+    - "1"
+    - "2"
+  kubernetes-worker:
+    annotations:
+      gui-x: '90'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-worker-571
+    constraints: cores=4 mem=4G root-disk=16G
+    expose: true
+    num_units: 3
+    options:
+      channel: 1.15/stable
+    resources:
+      cni-amd64: 392
+      cni-arm64: 383
+      cni-s390x: 395
+      core: 0
+      kube-proxy: 0
+      kubectl: 0
+      kubelet: 0
+    to:
+    - "1"
+    - "2"
+    - "3"
+relations:
+- - kubernetes-master:kube-api-endpoint
+  - kubeapi-load-balancer:apiserver
+- - kubernetes-master:loadbalancer
+  - kubeapi-load-balancer:loadbalancer
+- - kubernetes-master:kube-control
+  - kubernetes-worker:kube-control
+- - kubernetes-master:certificates
+  - easyrsa:client
+- - etcd:certificates
+  - easyrsa:client
+- - kubernetes-master:etcd
+  - etcd:db
+- - kubernetes-worker:certificates
+  - easyrsa:client
+- - kubernetes-worker:kube-api-endpoint
+  - kubeapi-load-balancer:website
+- - kubeapi-load-balancer:certificates
+  - easyrsa:client
+- - flannel:etcd
+  - etcd:db
+- - flannel:cni
+  - kubernetes-master:cni
+- - flannel:cni
+  - kubernetes-worker:cni
+- - containerd:containerd
+  - kubernetes-worker:container-runtime
+- - containerd:containerd
+  - kubernetes-master:container-runtime
diff --git a/SOL004/k8s_juju_ns/icons/osm.png b/SOL004/k8s_juju_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/k8s_juju_ns/icons/osm.png differ
diff --git a/SOL004/k8s_juju_ns/k8s_juju_nsd.yaml b/SOL004/k8s_juju_ns/k8s_juju_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2d83c3f9dc1e5f115e1065263ac781766bfd9d54
--- /dev/null
+++ b/SOL004/k8s_juju_ns/k8s_juju_nsd.yaml
@@ -0,0 +1,52 @@
+nsd:
+  nsd:
+  - description: NS consisting of a 4 k8s_jujumachine VNFs and 1 k8s_jujucontroller
+      VNF connected to mgmt network
+    designer: OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: k8s_vnf1
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: k8s_vnf1
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: k8s_jujumachine_vnf
+      - id: k8s_vnf2
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: k8s_vnf2
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: k8s_jujumachine_vnf
+      - id: k8s_vnf3
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: k8s_vnf3
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: k8s_jujumachine_vnf
+      - id: k8s_vnf4
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: k8s_vnf4
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: k8s_jujumachine_vnf
+      - id: k8s_juju
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: k8s_juju
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: k8s_jujucontroller_vnf
+    id: k8s_juju
+    name: k8s_juju
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    vnfd-id:
+    - k8s_jujumachine_vnf
+    - k8s_jujucontroller_vnf
diff --git a/SOL004/k8s_jujucontroller_vnf/README b/SOL004/k8s_jujucontroller_vnf/README
new file mode 100644
index 0000000000000000000000000000000000000000..faa5468f46633876e427479aa2f01422114e90a6
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/README
@@ -0,0 +1,3 @@
+This is a VNF with a single small VDU intended to run a juju controller
+that will deploy a K8s cluster using a juju bundle on a set of machines.
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6befd848e258b7a801a449b218aa00f20f9d9ec5
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions.yaml
@@ -0,0 +1,187 @@
+setup-juju:
+  description: "Adds a local manual cloud, bootstraps the controller"
+add-machine:
+  description: "Add one machine to the local cloud"
+  params:
+    machine:
+      description: "IP address of machine"
+      type: string
+      default: ""
+add-machines:
+  description: "Add machines to the local cloud"
+  params:
+    machine1:
+      description: "IP address of machine1"
+      type: string
+      default: ""
+    machine2:
+      description: "IP address of machine2"
+      type: string
+      default: ""
+    machine3:
+      description: "IP address of machine3"
+      type: string
+      default: ""
+    machine4:
+      description: "IP address of machine4"
+      type: string
+      default: ""
+    machine5:
+      description: "IP address of machine5"
+      type: string
+      default: ""
+    machine6:
+      description: "IP address of machine6"
+      type: string
+      default: ""
+    machine7:
+      description: "IP address of machine7"
+      type: string
+      default: ""
+    machine8:
+      description: "IP address of machine8"
+      type: string
+      default: ""
+    machine9:
+      description: "IP address of machine9"
+      type: string
+      default: ""
+    machine10:
+      description: "IP address of machine10"
+      type: string
+      default: ""
+  required:
+  - machine1
+  - machine2
+  - machine3
+  - machine4
+remove-machines:
+  description: "Remove all machines"
+  params:
+    force:
+      description: "Flag to force the removal"
+      type: boolean
+      default: False
+deploy-bundle:
+  description: "Deploys the bundle in the machines"
+  params:
+    bundle:
+      description: "Optional bundle in JSON/YAML string format"
+      type: string
+      default: ""
+undeploy-bundle:
+  description: "Remove all applications of the bundle that was deployed"
+post-deploy:
+  description: "Configuration after deployment (kubectl, juju privileges)"
+init-helm:
+  description: "Initialize helm"
+install-openebs-kubectl:
+  description: "Install OpenEBS with kubectl, required for PVC"
+install-openebs-chart:
+  description: "Install OpenEBS helm chart, required for PVC"
+add-repo:
+  description: "Add repo to helm"
+  params:
+    name:
+      description: "Name of the repo"
+      type: string
+      default: ""
+    url:
+      description: "URL of the repo"
+      type: string
+      default: ""
+  required:
+  - name
+  - url
+remove-repo:
+  description: "Remove repo from helm"
+  params:
+    name:
+      description: "Name of the repo"
+      type: string
+      default: ""
+  required:
+  - name
+install-chart:
+  description: "Install chart"
+  params:
+    chart:
+      description: "Name of the chart"
+      type: string
+      default: ""
+    name:
+      description: "Name of the release"
+      type: string
+      default: ""
+    namespace:
+      description: "Namespace where the release will be set"
+      type: string
+      default: ""
+    atomic:
+      description: "Flag to run it as atomic"
+      type: boolean
+      default: False
+    values:
+      description: "Serialized values of a YAML file in a string"
+      type: string
+      default: ""
+    valuesFile:
+      description: "Values in a YAML file or a URL"
+      type: string
+      default: ""
+  required:
+  - chart
+  - name
+upgrade-release:
+  description: "Upgrade release"
+  params:
+    name:
+      description: "Name of the release"
+      type: string
+      default: ""
+    chart:
+      description: "Name of the chart"
+      type: string
+      default: ""
+    namespace:
+      description: "Namespace where the release will be set"
+      type: string
+      default: ""
+    atomic:
+      description: "Flag to run it as atomic"
+      type: boolean
+      default: ""
+    values:
+      description: "Serialized values of a YAML file in a string"
+      type: string
+      default: ""
+    valuesFile:
+      description: "Values in a YAML file or a URL"
+      type: string
+      default: ""
+  required:
+  - name
+  - chart
+rollback-release:
+  description: "Rollback release"
+  params:
+    name:
+      description: "Name of the release"
+      type: string
+      default: ""
+    revision:
+      description: "Revision of the release"
+      type: string
+      default: "0"
+  required:
+  - name
+delete-release:
+  description: "Delete release"
+  params:
+    name:
+      description: "Name of the release"
+      type: string
+      default: ""
+  required:
+  - name
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machine b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machine
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machine
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machines b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machines
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-machines
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-repo b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-repo
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/add-repo
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/delete-release b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/delete-release
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/delete-release
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/deploy-bundle b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/deploy-bundle
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/deploy-bundle
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/init-helm b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/init-helm
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/init-helm
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-chart b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-chart
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-chart
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-chart b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-chart
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-chart
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-kubectl b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-kubectl
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/install-openebs-kubectl
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/post-deploy b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/post-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/post-deploy
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-machines b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-machines
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-machines
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-repo b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-repo
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/remove-repo
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/rollback-release b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/rollback-release
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/rollback-release
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/setup-juju b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/setup-juju
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/setup-juju
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/undeploy-bundle b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/undeploy-bundle
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/undeploy-bundle
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/upgrade-release b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/upgrade-release
new file mode 100755
index 0000000000000000000000000000000000000000..e13c144d2132556f24eee7225adccbc70400658f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/actions/upgrade-release
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# Copyright 2017-18 Telefonica
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/config.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..51f2ce4a07bddfbc72679ec14280fd6461cb307d
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/config.yaml
@@ -0,0 +1,14 @@
+options:
+  string-option:
+    type: string
+    default: "Default Value"
+    description: "A short description of the configuration option"
+  boolean-option:
+    type: boolean
+    default: False
+    description: "A short description of the configuration option"
+  int-option:
+    type: int
+    default: 9001
+    description: "A short description of the configuration option"
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/icon.svg b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..96a5d0c068d4b3271c7e397f76cf77fdf0651038
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/layer.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..179f3b2a8f06114d6741a3b00e020e5a9e8dc0db
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/layer.yaml
@@ -0,0 +1,5 @@
+includes: ['layer:basic', 'layer:vnfproxy', 'layer:sshproxy'] # if you use any interfaces, add them here
+options:
+  basic:
+    use_venv: false
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/metadata.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0580038fd504615a94900252ef39210cc6ddb9ba
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/metadata.yaml
@@ -0,0 +1,22 @@
+name: tid-jujuk8s
+summary: A charm for k8s_jujucontroller_vnf to deploy a K8s cluster
+description: |
+  A charm to manage k8s_jujucontroller_vnf in order to deploy a k8s cluster.
+  It assumes that juju is already installed via cloud-init, with a manual cloud
+  and a bootstrapped controller.
+  It has an action "create-cluster" that receives the IP addresses of the 4 machines
+  belonging to the cluster and does the following:
+    - Copy ssh key of the juju controller to the machines
+    - Add the machines to juju
+    - Deploys the k8s bundle in the machines.
+series:
+  - bionic
+  - xenial
+maintainers:
+  - garciadeblas <gerardo.garciadeblas@telefonica.com>
+  - garomero <garomero@minsait.com>
+tags:
+  # Replace "misc" with one or more whitelisted tags from this list:
+  # https://jujucharms.com/docs/stable/authors-charm-metadata
+  - misc
+subordinate: false
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/reactive/tid-jujuk8s.py b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/reactive/tid-jujuk8s.py
new file mode 100644
index 0000000000000000000000000000000000000000..21259cc999b8d7dc2c74ec5d8975f84830da6c13
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/reactive/tid-jujuk8s.py
@@ -0,0 +1,699 @@
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+    log,
+)
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+
+import charms.sshproxy
+import sys, traceback
+from jinja2 import Environment, FileSystemLoader
+import time
+import yaml
+
+class TidJujuK8sException(Exception):
+    pass
+
+@when_not('tid-jujuk8s.installed')
+def install_tid_jujuk8s():
+    set_flag('tid-jujuk8s.installed')
+
+@when('actions.setup-juju')
+def setup_juju():
+    err = ''
+    try:
+        cmd = "ip -4 -o a s ens3 | awk \\'{split($4,a,\\\"/\\\"); print a[1]}\\'"
+        log("setup-juju: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        mgmt_ip=result
+
+        env = Environment(loader=FileSystemLoader('.'))
+        template = env.get_template('scripts/k8s-cloud-template.yaml')
+        output_from_parsed_template = template.render (controller_mgmt_ip_address = mgmt_ip)
+        temp_file="k8s-cloud.yaml"
+        with open(temp_file, "w") as fh:
+            fh.write(output_from_parsed_template)
+            fh.close()
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/setup-juju.sh', '/home/ubuntu/setup-juju.sh', host, user)
+        charms.sshproxy.sftp('k8s-cloud.yaml', '/home/ubuntu/k8s-cloud.yaml', host, user)
+
+        cmd = "chmod +x /home/ubuntu/setup-juju.sh; /home/ubuntu/setup-juju.sh > /dev/null && echo 'OK'"
+        log("setup-juju: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("setup-juju: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.setup-juju')
+
+@when('actions.add-machine')
+def add_machines():
+    err = ''
+    try:
+        machine = action_get('machine')
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/add-machine.sh', '/home/ubuntu/add-machine.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/add-machine.sh"
+        log("add-machine: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+
+        cmd = "/home/ubuntu/add-machine.sh {} > /dev/null && echo 'OK'".format(machine)
+        log("add-machine: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("add-machine: added {}".format(machine))
+        log("add-machine: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.add-machine')
+
+@when('actions.add-machines')
+def add_machines():
+    err = ''
+    try:
+        machines = []
+        machines.append(action_get('machine1'))
+        machines.append(action_get('machine2'))
+        machines.append(action_get('machine3'))
+        machines.append(action_get('machine4'))
+        machines.append(action_get('machine5'))
+        machines.append(action_get('machine6'))
+        machines.append(action_get('machine7'))
+        machines.append(action_get('machine8'))
+        machines.append(action_get('machine9'))
+        machines.append(action_get('machine10'))
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/add-machine.sh', '/home/ubuntu/add-machine.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/add-machine.sh"
+        log("add-machines: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+
+        number_of_machines = 0
+        for m in machines:
+            if not m:
+                continue
+            cmd = "/home/ubuntu/add-machine.sh {} > /dev/null && echo 'OK'".format(m)
+            log("add-machines: command to execute: " + cmd)
+            result, err = charms.sshproxy._run(cmd)
+            log("add-machines: added {}".format(m))
+            number_of_machines += 1
+        log("add-machines: Checking whether all machines are ready")
+        timeout = 0
+        while timeout <= 600:
+            try:
+                started = 0
+                cmd = "/snap/bin/juju machines --format yaml"
+                log("add-machines: getting machines: " + cmd)
+                result, err = charms.sshproxy._run(cmd)
+                juju_machines = yaml.safe_load(result)
+                for k,v in juju_machines['machines'].items():
+                    if v.get('juju-status').get('current') == "started":
+                        started += 1
+                if started >= number_of_machines:
+                    log("add-machines: {}/{} machines are ready".format(started,number_of_machines))
+                    break
+                log("add-machines: {}/{} machines are ready".format(started,number_of_machines))
+            except:
+                log("Error. Command Failed." + str(err))
+            time.sleep(20)
+            timeout += 20
+        else:
+            log("add-machines: Machines are not ready after {} seconds.".format(timeout))
+            raise TidJujuK8sException("Timeout when adding machines")
+        log("add-machines: DONE")
+    except TidJujuK8sException as toexception:
+        log("add-machines: TidJujuK8sException:" + str(toexception))
+        action_fail('Timeout reached for adding machines:' + str(toexception))
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.add-machines')
+
+@when('actions.deploy-bundle')
+def deploy_bundle():
+    err = ''
+    try:
+        cmd = "/snap/bin/juju machines --format yaml"
+        log("deploy-bundle: getting machines: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        juju_machines = yaml.safe_load(result)
+        n_machines = len(juju_machines['machines'])
+
+        bundle = action_get('bundle')
+        bundle_dict = {}
+        if bundle:
+            try:
+                bundle_dict = yaml.safe_load(bundle)
+            except yaml.YAMLError as exc:
+                raise TidJujuK8sException("Error loading the provided bundle " + bundle + ": " + str(exc))
+        else:
+            with open("scripts/bundle-empty.yaml", 'r') as stream:
+                try:
+                    bundle_dict = yaml.safe_load(stream)
+                except yaml.YAMLError as exc:
+                    raise TidJujuK8sException("Error loading the default bundle bundle-empty.yaml: " + str(exc))
+            if n_machines < 4:
+                raise TidJujuK8sException("Not possible to deploy a bundle when number of machines is lower than 4")
+            else:
+                n_etcd = 3
+                n_masters = 2
+                n_workers = n_machines - 1
+                bundle_dict["machines"]={}
+                #bundle_dict["machines"].extend(map(str,range(n_machines)))
+                for i in range(n_machines):
+                    bundle_dict["machines"][str(i)] = {}
+                bundle_dict["services"]["easyrsa"]["num_units"]=1
+                bundle_dict["services"]["easyrsa"]["to"]=[]
+                bundle_dict["services"]["easyrsa"]["to"].append("0")
+                bundle_dict["services"]["kubeapi-load-balancer"]["num_units"]=1
+                bundle_dict["services"]["kubeapi-load-balancer"]["to"]=[]
+                bundle_dict["services"]["kubeapi-load-balancer"]["to"].append("0")
+                bundle_dict["services"]["etcd"]["num_units"]=n_etcd
+                bundle_dict["services"]["etcd"]["to"]=[]
+                bundle_dict["services"]["etcd"]["to"].extend(map(str,range(0,n_etcd)))
+                bundle_dict["services"]["kubernetes-master"]["num_units"]=n_masters
+                bundle_dict["services"]["kubernetes-master"]["to"]=[]
+                bundle_dict["services"]["kubernetes-master"]["to"].extend(map(str,range(0,n_masters)))
+                bundle_dict["services"]["kubernetes-worker"]["num_units"]=n_workers
+                bundle_dict["services"]["kubernetes-worker"]["to"]=[]
+                bundle_dict["services"]["kubernetes-worker"]["to"].extend(map(str,range(1,n_workers+1)))
+
+        with open("scripts/bundle.yaml", 'w') as stream:
+            try:
+                yaml.safe_dump(bundle_dict, stream)
+            except yaml.YAMLError as exc:
+                raise TidJujuK8sException("Error while dumping bundle_dict to bundle.yaml: " + str(exc))
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/bundle.yaml', '/home/ubuntu/bundle.yaml', host, user)
+
+        existing_machines = []
+        map_machines = ""
+        bundle_machine = 0
+        for k in sorted(juju_machines['machines'].keys()):
+            map_machines = "{}{}={}".format(map_machines, bundle_machine, k)
+            bundle_machine += 1
+            if bundle_machine < n_machines:
+                map_machines += ","
+        log("deploy-bundle: map_machines: " + map_machines)
+
+        cmd = "/snap/bin/juju deploy ./bundle.yaml --map-machines=existing,{}".format(map_machines)
+        log("deploy-bundle: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("deploy-bundle: Checking whether all applications in the bundle are active")
+        timeout = 0
+        while timeout <= 12000:
+            try:
+                cmd = "/snap/bin/juju status --format yaml"
+                log("deploy-bundle: getting status: " + cmd)
+                result, err = charms.sshproxy._run(cmd)
+                juju_status = yaml.safe_load(result)
+                for k,v in juju_status['applications'].items():
+                    if v.get('application-status').get('current') != 'active':
+                        log('deploy-bundle: Application {} not active'.format(k))
+                        break
+                else:
+                    log('deploy-bundle: All applications are active')
+                    break
+            except:
+                log("Error. Command Failed." + str(err))
+            time.sleep(20)
+            timeout += 20
+        else:
+            log("deploy-bundle: Applications in the bundle are not ready after {} seconds.".format(timeout))
+            raise TidJujuK8sException("Timeout when deploying bundle")
+        log("deploy-bundle: DONE")
+    except TidJujuK8sException as toexception:
+        log("deploy-bundle: TidJujuK8sException:" + str(toexception))
+        action_fail('Timeout reached for deploying the bundle:' + str(toexception))
+        log("deploy-bundle: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.deploy-bundle')
+
+@when('actions.undeploy-bundle')
+def undeploy_bundle():
+    ''' TODO: Not yet properly working
+    '''
+    err = ''
+    try:
+        cmd = "/snap/bin/juju machines --format yaml"
+        log("undeploy-bundle: getting machines: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        juju_machines = yaml.safe_load(result)
+
+        n_machines = len(juju_machines['machines'])
+        cmd = "chmod +x /home/ubuntu/undeploy-bundle.sh; /home/ubuntu/undeploy-bundle.sh > /dev/null && echo 'OK'"
+        log("undeploy-bundle: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("undeploy-bundle: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.undeploy-bundle')
+
+@when('actions.remove-machines')
+def remove_machines():
+    ''' TODO: Not yet properly working
+    '''
+    err = ''
+    try:
+        force = action_get('force')
+
+        cmd = "/snap/bin/juju machines --format yaml"
+        log("remove-machines: getting machines: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        juju_machines = yaml.safe_load(result)
+        number_of_machines = len(juju_machines['machines'])
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/remove-machine.sh', '/home/ubuntu/remove-machine.sh', host, user)
+
+        for m in juju_machines['machines']:
+            #cmd = "chmod +x /home/ubuntu/remove-machine.sh; /home/ubuntu/remove-machine.sh > /dev/null && echo 'OK'"
+            cmd = "/snap/bin/juju remove-machine {}".format(m)
+            if force:
+                cmd += " --force"
+            cmd += " > /dev/null && echo 'OK'"
+            log("remove-machine: command to execute: " + cmd)
+            result, err = charms.sshproxy._run(cmd)
+        log("remove-machines: Checking whether all machines were removed")
+        timeout = 0
+        while timeout <= 600:
+            try:
+                started = 0
+                cmd = "/snap/bin/juju machines --format yaml"
+                log("remove-machines: getting machines: " + cmd)
+                result, err = charms.sshproxy._run(cmd)
+                if result:
+                    juju_machines = yaml.safe_load(result)
+                    n_machines = len(juju_machines['machines'])
+                    log("remove-machines: {}/{} machines are active".format(n_machines,number_of_machines))
+                    if n_machines == 0:
+                        log("remove-machines: no machines".format(n_machines,number_of_machines))
+                        break
+                else:
+                    log("remove-machines: no machines".format(n_machines,number_of_machines))
+                    break
+            except:
+                log("Error. Command Failed." + str(err))
+            time.sleep(20)
+            timeout += 20
+        else:
+            log("remove-machines: Machines were not removed after {} seconds.".format(timeout))
+            raise TidJujuK8sException("Timeout when adding machines")
+        log("remove-machines: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.remove-machines')
+
+@when('actions.post-deploy')
+def post_deploy():
+    err = ''
+    try:
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/post-deploy.sh', '/home/ubuntu/post-deploy.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/post-deploy.sh; /home/ubuntu/post-deploy.sh > /dev/null && echo 'OK'"
+        log("post-deploy: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("post-deploy: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.post-deploy')
+
+@when('actions.init-helm')
+def init_helm():
+    err = ''
+    try:
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/init-helm.sh', '/home/ubuntu/init-helm.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/init-helm.sh; /home/ubuntu/init-helm.sh > /dev/null && echo 'OK'"
+        log("init-helm: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("init-helm: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.init-helm')
+
+@when('actions.install-openebs-chart')
+def install_openebs_chart():
+    err = ''
+    try:
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/openebs-storage-class.yaml', '/home/ubuntu/openebs-storage-class.yaml', host, user)
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/install-openebs-chart.sh', '/home/ubuntu/install-openebs-chart.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/install-openebs-chart.sh; /home/ubuntu/install-openebs-chart.sh > /dev/null && echo 'OK'"
+        log("install-openebs-chart: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("install-openebs-chart: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.install-openebs-chart')
+
+@when('actions.install-openebs-kubectl')
+def install_openebs_kubectl():
+    err = ''
+    try:
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/openebs-storage-class.yaml', '/home/ubuntu/openebs-storage-class.yaml', host, user)
+
+        cfg = charms.sshproxy.get_config()
+        host = charms.sshproxy.get_host_ip()
+        user = cfg['ssh-username']
+        charms.sshproxy.sftp('scripts/install-openebs-kubectl.sh', '/home/ubuntu/install-openebs-kubectl.sh', host, user)
+
+        cmd = "chmod +x /home/ubuntu/install-openebs-kubectl.sh; /home/ubuntu/install-openebs-kubectl.sh > /dev/null && echo 'OK'"
+        log("install-openebs-kubectl: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("install-openebs-kubectl: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.install-openebs-kubectl')
+
+@when('actions.install-chart')
+def install_chart():
+    err = ''
+    try:
+        chart = action_get('chart')
+        name = action_get('name')
+        namespace = action_get('namespace')
+        atomic = action_get('atomic')
+        values = action_get('values')
+        valuesFile = action_get('valuesFile')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/install-chart.sh', '/home/ubuntu/install-chart.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/install-chart.sh; /home/ubuntu/install-chart.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm install {} -n {}".format(chart, name)
+        if namespace:
+            cmd += " --namespace {}".format(namespace)
+        if atomic:
+            cmd += " --atomic"
+        values_dict = {}
+        if values:
+            try:
+                values_dict = yaml.safe_load(stream)
+            except yaml.YAMLError as exc:
+                raise TidJujuK8sException("Error in values: " + str(exc))
+            with open("myvalues.yaml", 'w') as stream:
+                try:
+                    yaml.safe_dump(values_dict, stream)
+                except yaml.YAMLError as exc:
+                    raise TidJujuK8sException("Error while dumping values_dict to myvalues.yaml: " + str(exc))
+            valuesFile = "myvalues.yaml"
+        if valuesFile:
+            cfg = charms.sshproxy.get_config()
+            host = charms.sshproxy.get_host_ip()
+            user = cfg['ssh-username']
+            charms.sshproxy.sftp(valuesFile, '/home/ubuntu/myvalues.yaml', host, user)
+            cmd += " -f /home/ubuntu/myvalues.yaml"
+
+        log("install-chart: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("install-chart: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.install-chart')
+
+@when('actions.upgrade-release')
+def upgrade_release():
+    err = ''
+    try:
+        chart = action_get('chart')
+        name = action_get('name')
+        namespace = action_get('namespace')
+        atomic = action_get('atomic')
+        values = action_get('values')
+        valuesFile = action_get('valuesFile')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/upgrade-release.sh', '/home/ubuntu/upgrade-release.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/upgrade-release.sh; /home/ubuntu/upgrade-release.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm upgrade {} {}".format(name, chart)
+        if namespace:
+            cmd += " --namespace {}".format(namespace)
+        if atomic:
+            cmd += " --atomic"
+        values_dict = {}
+        if values:
+            try:
+                values_dict = yaml.safe_load(stream)
+            except yaml.YAMLError as exc:
+                raise TidJujuK8sException("Error in values: " + str(exc))
+            with open("myvalues.yaml", 'w') as stream:
+                try:
+                    yaml.safe_dump(values_dict, stream)
+                except yaml.YAMLError as exc:
+                    raise TidJujuK8sException("Error while dumping values_dict to myvalues.yaml: " + str(exc))
+            valuesFile = "myvalues.yaml"
+        if valuesFile:
+            cfg = charms.sshproxy.get_config()
+            host = charms.sshproxy.get_host_ip()
+            user = cfg['ssh-username']
+            charms.sshproxy.sftp(valuesFile, '/home/ubuntu/myvalues.yaml', host, user)
+            cmd += " -f /home/ubuntu/myvalues.yaml"
+
+        log("upgrade-release: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("upgrade-release: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.upgrade-release')
+
+@when('actions.rollback-release')
+def rollback_release():
+    err = ''
+    try:
+        name = action_get('name')
+        revision = action_get('revision')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/rollback-release.sh', '/home/ubuntu/rollback-release.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/rollback-release.sh; /home/ubuntu/rollback-release.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm rollback {}".format(name)
+        if revision:
+            cmd += " {}".format(revision)
+        log("rollback-release: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("rollback-release: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.rollback-release')
+
+@when('actions.delete-release')
+def delete_release():
+    err = ''
+    try:
+        name = action_get('name')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/delete-release.sh', '/home/ubuntu/delete-release.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/delete-release.sh; /home/ubuntu/delete-release.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm delete --purge {}".format(name)
+        log("delete-release: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("delete-release: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.delete-release')
+
+@when('actions.add-repo')
+def add_repo():
+    err = ''
+    try:
+        name = action_get('name')
+        url = action_get('url')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/add-repo.sh', '/home/ubuntu/add-repo.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/add-repo.sh; /home/ubuntu/add-repo.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm repo add {} {} > /dev/null && /snap/bin/helm repo update > /dev/null && echo 'OK'".format(name,url)
+        log("add-repo: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("add-repo: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.add-repo')
+
+@when('actions.remove-repo')
+def remove_repo():
+    err = ''
+    try:
+        name = action_get('name')
+
+        #cfg = charms.sshproxy.get_config()
+        #host = charms.sshproxy.get_host_ip()
+        #user = cfg['ssh-username']
+        #charms.sshproxy.sftp('scripts/remove-repo.sh', '/home/ubuntu/remove-repo.sh', host, user)
+
+        #cmd = "chmod +x /home/ubuntu/remove-repo.sh; /home/ubuntu/remove-repo.sh > /dev/null && echo 'OK'"
+        cmd = "/snap/bin/helm repo remove {} > /dev/null && /snap/bin/helm repo update > /dev/null && echo 'OK'".format(name)
+        log("remove-repo: command to execute: " + cmd)
+        result, err = charms.sshproxy._run(cmd)
+        log("remove-repo: DONE")
+    except:
+        log("Error. Command Failed.")
+        action_fail('command failed:' + err)
+        exc_type, exc_value, exc_traceback = sys.exc_info()
+        err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+        log(str(err))
+    else:
+        action_set({'output': result})
+    finally:
+        clear_flag('actions.remove-repo')
+
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-machine.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-machine.sh
new file mode 100755
index 0000000000000000000000000000000000000000..4db9d6c9bc2df6e38d8a7f6f79937629b0444432
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-machine.sh
@@ -0,0 +1,4 @@
+#!/bin/bash
+sshpass -posm4u ssh-copy-id -o "StrictHostKeyChecking no" -i /home/ubuntu/.local/share/juju/ssh/juju_id_rsa ubuntu@$1
+sudo su -l ubuntu -c "nohup /snap/bin/juju add-machine ssh:ubuntu@"$1" > /dev/null 2>&1 &"
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-repo.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-repo.sh
new file mode 100755
index 0000000000000000000000000000000000000000..bfeb8565f335752a208c4cf8605cf0ee8aed4120
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/add-repo.sh
@@ -0,0 +1,6 @@
+#!/bin/bash
+REPO_NAME=$1
+REPO_URL=$2
+helm repo add ${REPO_NAME} ${REPO_URL}
+helm repo update
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-4machines.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-4machines.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9bb42cd9c9cf5f16189a6c4d8d6c27d1ee5c54d5
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-4machines.yaml
@@ -0,0 +1,134 @@
+description: A highly-available, production-grade Kubernetes cluster.
+series: bionic
+machines:
+  "0":
+  "1":
+  "2":
+  "3":
+services:
+  containerd:
+    annotations:
+      gui-x: '475'
+      gui-y: '800'
+    charm: cs:~containers/containerd-20
+    resources: {}
+  easyrsa:
+    annotations:
+      gui-x: '90'
+      gui-y: '420'
+    charm: cs:~containers/easyrsa-270
+    constraints: root-disk=8G
+    num_units: 1
+    resources:
+      easyrsa: 5
+    to:
+    - "0"
+  etcd:
+    annotations:
+      gui-x: '800'
+      gui-y: '420'
+    charm: cs:~containers/etcd-449
+    constraints: root-disk=8G
+    num_units: 3
+    options:
+      channel: 3.2/stable
+    resources:
+      core: 0
+      etcd: 3
+      snapshot: 0
+    to:
+    - "1"
+    - "2"
+    - "3"
+  flannel:
+    annotations:
+      gui-x: '475'
+      gui-y: '605'
+    charm: cs:~containers/flannel-438
+    resources:
+      flannel-amd64: 394
+      flannel-arm64: 390
+      flannel-s390x: 377
+  kubeapi-load-balancer:
+    annotations:
+      gui-x: '450'
+      gui-y: '250'
+    charm: cs:~containers/kubeapi-load-balancer-664
+    constraints: root-disk=8G
+    expose: true
+    num_units: 1
+    resources: {}
+    to:
+    - "0"
+  kubernetes-master:
+    annotations:
+      gui-x: '800'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-master-724
+    constraints: cores=2 mem=4G root-disk=16G
+    num_units: 2
+    options:
+      channel: 1.15/stable
+    resources:
+      cdk-addons: 0
+      core: 0
+      kube-apiserver: 0
+      kube-controller-manager: 0
+      kube-proxy: 0
+      kube-scheduler: 0
+      kubectl: 0
+    to:
+    - "1"
+    - "2"
+  kubernetes-worker:
+    annotations:
+      gui-x: '90'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-worker-571
+    constraints: cores=4 mem=4G root-disk=16G
+    expose: true
+    num_units: 3
+    options:
+      channel: 1.15/stable
+    resources:
+      cni-amd64: 392
+      cni-arm64: 383
+      cni-s390x: 395
+      core: 0
+      kube-proxy: 0
+      kubectl: 0
+      kubelet: 0
+    to:
+    - "1"
+    - "2"
+    - "3"
+relations:
+- - kubernetes-master:kube-api-endpoint
+  - kubeapi-load-balancer:apiserver
+- - kubernetes-master:loadbalancer
+  - kubeapi-load-balancer:loadbalancer
+- - kubernetes-master:kube-control
+  - kubernetes-worker:kube-control
+- - kubernetes-master:certificates
+  - easyrsa:client
+- - etcd:certificates
+  - easyrsa:client
+- - kubernetes-master:etcd
+  - etcd:db
+- - kubernetes-worker:certificates
+  - easyrsa:client
+- - kubernetes-worker:kube-api-endpoint
+  - kubeapi-load-balancer:website
+- - kubeapi-load-balancer:certificates
+  - easyrsa:client
+- - flannel:etcd
+  - etcd:db
+- - flannel:cni
+  - kubernetes-master:cni
+- - flannel:cni
+  - kubernetes-worker:cni
+- - containerd:containerd
+  - kubernetes-worker:container-runtime
+- - containerd:containerd
+  - kubernetes-master:container-runtime
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-empty.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-empty.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7041dbef2990364f7e9e34d7b16161ce737e146a
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle-empty.yaml
@@ -0,0 +1,115 @@
+description: A highly-available, production-grade Kubernetes cluster.
+series: bionic
+machines:
+services:
+  containerd:
+    annotations:
+      gui-x: '475'
+      gui-y: '800'
+    charm: cs:~containers/containerd-33
+    resources: {}
+  easyrsa:
+    annotations:
+      gui-x: '90'
+      gui-y: '420'
+    charm: cs:~containers/easyrsa-278
+    constraints: root-disk=8G
+    resources:
+      easyrsa: 5
+    to:
+  etcd:
+    annotations:
+      gui-x: '800'
+      gui-y: '420'
+    charm: cs:~containers/etcd-460
+    constraints: root-disk=8G
+    options:
+      channel: 3.2/stable
+    resources:
+      core: 0
+      etcd: 3
+      snapshot: 0
+    to:
+  flannel:
+    annotations:
+      gui-x: '475'
+      gui-y: '605'
+    charm: cs:~containers/flannel-450
+    resources:
+      flannel-amd64: 458
+      flannel-arm64: 454
+      flannel-s390x: 441
+  kubeapi-load-balancer:
+    annotations:
+      gui-x: '450'
+      gui-y: '250'
+    charm: cs:~containers/kubeapi-load-balancer-682
+    constraints: root-disk=8G
+    expose: true
+    resources: {}
+    to:
+  kubernetes-master:
+    annotations:
+      gui-x: '800'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-master-754
+    constraints: cores=2 mem=4G root-disk=16G
+    options:
+      channel: 1.15/stable
+    resources:
+      cdk-addons: 0
+      core: 0
+      kube-apiserver: 0
+      kube-controller-manager: 0
+      kube-proxy: 0
+      kube-scheduler: 0
+      kubectl: 0
+    to:
+  kubernetes-worker:
+    annotations:
+      gui-x: '90'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-worker-590
+    constraints: cores=4 mem=4G root-disk=16G
+    expose: true
+    options:
+      channel: 1.15/stable
+    resources:
+      cni-amd64: 455
+      cni-arm64: 446
+      cni-s390x: 458
+      core: 0
+      kube-proxy: 0
+      kubectl: 0
+      kubelet: 0
+    to:
+relations:
+- - kubernetes-master:kube-api-endpoint
+  - kubeapi-load-balancer:apiserver
+- - kubernetes-master:loadbalancer
+  - kubeapi-load-balancer:loadbalancer
+- - kubernetes-master:kube-control
+  - kubernetes-worker:kube-control
+- - kubernetes-master:certificates
+  - easyrsa:client
+- - etcd:certificates
+  - easyrsa:client
+- - kubernetes-master:etcd
+  - etcd:db
+- - kubernetes-worker:certificates
+  - easyrsa:client
+- - kubernetes-worker:kube-api-endpoint
+  - kubeapi-load-balancer:website
+- - kubeapi-load-balancer:certificates
+  - easyrsa:client
+- - flannel:etcd
+  - etcd:db
+- - flannel:cni
+  - kubernetes-master:cni
+- - flannel:cni
+  - kubernetes-worker:cni
+- - containerd:containerd
+  - kubernetes-worker:container-runtime
+- - containerd:containerd
+  - kubernetes-master:container-runtime
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..234393aa0c4ba058986c3ab12d049780d034029f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/bundle.yaml
@@ -0,0 +1,113 @@
+description: A highly-available, production-grade Kubernetes cluster.
+series: bionic
+services:
+  containerd:
+    annotations:
+      gui-x: '475'
+      gui-y: '800'
+    charm: cs:~containers/containerd-33
+    resources: {}
+  easyrsa:
+    annotations:
+      gui-x: '90'
+      gui-y: '420'
+    charm: cs:~containers/easyrsa-278
+    constraints: root-disk=8G
+    num_units: 1
+    resources:
+      easyrsa: 5
+  etcd:
+    annotations:
+      gui-x: '800'
+      gui-y: '420'
+    charm: cs:~containers/etcd-460
+    constraints: root-disk=8G
+    num_units: 3
+    options:
+      channel: 3.2/stable
+    resources:
+      core: 0
+      etcd: 3
+      snapshot: 0
+  flannel:
+    annotations:
+      gui-x: '475'
+      gui-y: '605'
+    charm: cs:~containers/flannel-450
+    resources:
+      flannel-amd64: 458
+      flannel-arm64: 454
+      flannel-s390x: 441
+  kubeapi-load-balancer:
+    annotations:
+      gui-x: '450'
+      gui-y: '250'
+    charm: cs:~containers/kubeapi-load-balancer-682
+    constraints: root-disk=8G
+    expose: true
+    num_units: 1
+    resources: {}
+  kubernetes-master:
+    annotations:
+      gui-x: '800'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-master-754
+    constraints: cores=2 mem=4G root-disk=16G
+    num_units: 2
+    options:
+      channel: 1.16/stable
+    resources:
+      cdk-addons: 0
+      core: 0
+      kube-apiserver: 0
+      kube-controller-manager: 0
+      kube-proxy: 0
+      kube-scheduler: 0
+      kubectl: 0
+  kubernetes-worker:
+    annotations:
+      gui-x: '90'
+      gui-y: '850'
+    charm: cs:~containers/kubernetes-worker-590
+    constraints: cores=4 mem=4G root-disk=16G
+    expose: true
+    num_units: 3
+    options:
+      channel: 1.16/stable
+    resources:
+      cni-amd64: 455
+      cni-arm64: 446
+      cni-s390x: 458
+      core: 0
+      kube-proxy: 0
+      kubectl: 0
+      kubelet: 0
+relations:
+- - kubernetes-master:kube-api-endpoint
+  - kubeapi-load-balancer:apiserver
+- - kubernetes-master:loadbalancer
+  - kubeapi-load-balancer:loadbalancer
+- - kubernetes-master:kube-control
+  - kubernetes-worker:kube-control
+- - kubernetes-master:certificates
+  - easyrsa:client
+- - etcd:certificates
+  - easyrsa:client
+- - kubernetes-master:etcd
+  - etcd:db
+- - kubernetes-worker:certificates
+  - easyrsa:client
+- - kubernetes-worker:kube-api-endpoint
+  - kubeapi-load-balancer:website
+- - kubeapi-load-balancer:certificates
+  - easyrsa:client
+- - flannel:etcd
+  - etcd:db
+- - flannel:cni
+  - kubernetes-master:cni
+- - flannel:cni
+  - kubernetes-worker:cni
+- - containerd:containerd
+  - kubernetes-worker:container-runtime
+- - containerd:containerd
+  - kubernetes-master:container-runtime
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/delete-release.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/delete-release.sh
new file mode 100755
index 0000000000000000000000000000000000000000..bce702572c24c6d1e1a6fc6bda5d2c45b52f9b6c
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/delete-release.sh
@@ -0,0 +1,4 @@
+#!/bin/bash
+RELEASE=$1
+helm delete --purge ${RELEASE}
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/init-helm.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/init-helm.sh
new file mode 100755
index 0000000000000000000000000000000000000000..58089ba7fa899a995a5bec88697af4fbce350035
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/init-helm.sh
@@ -0,0 +1,11 @@
+#!/bin/bash
+curl https://get.helm.sh/helm-v2.15.2-linux-amd64.tar.gz --output helm-v2.15.2.tar.gz
+tar -zxvf helm-v2.15.2.tar.gz
+sudo mv linux-amd64/helm /usr/local/bin/helm
+rm -rf linux-amd64/
+rm -f helm-v2.15.2.tar.gz
+/usr/local/bin/helm init
+# Snap for helm currently uses version 3 of helm
+#sudo snap install helm --classic
+#/snap/bin/helm init
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-chart.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-chart.sh
new file mode 100755
index 0000000000000000000000000000000000000000..d9f501a5f53f5d2c62019aaf6215331857518724
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-chart.sh
@@ -0,0 +1,9 @@
+#!/bin/bash
+CHART=$1
+VALUES_FILE=$2
+ADDITIONAL_OPTS=""
+if [ $# -gt 2 ]; then
+    ADDITIONAL_OPTS="-n $3"
+fi
+helm install ${CHART} -f ${VALUES_FILE} --atomic ${ADDITIONAL_OPTS}
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-chart.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-chart.sh
new file mode 100755
index 0000000000000000000000000000000000000000..8b715bbc370bc839ed79153ddf51d37869252187
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-chart.sh
@@ -0,0 +1,5 @@
+#!/bin/bash
+/snap/bin/helm install --namespace openebs --name openebs stable/openebs
+/snap/bin/kubectl apply -f /home/ubuntu/openebs-storage-class.yaml
+/snap/bin/kubectl patch storageclass openebs-hostpath -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-kubectl.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-kubectl.sh
new file mode 100755
index 0000000000000000000000000000000000000000..2284da07a5731e076a6efb7dd987d096bb1405c2
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/install-openebs-kubectl.sh
@@ -0,0 +1,5 @@
+#!/bin/bash
+/snap/bin/kubectl apply -f https://openebs.github.io/charts/openebs-operator.yaml
+/snap/bin/kubectl apply -f /home/ubuntu/openebs-storage-class.yaml
+/snap/bin/kubectl patch storageclass openebs-hostpath -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/k8s-cloud-template.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/k8s-cloud-template.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2128f704b43a0df27936020fb5e5d75cf3252b92
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/k8s-cloud-template.yaml
@@ -0,0 +1,4 @@
+clouds:
+  k8s:
+    type: manual
+    endpoint: "ubuntu@{{ controller_mgmt_ip_address }}"
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/openebs-storage-class.yaml b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/openebs-storage-class.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9b53b59699ecccaafe06c2261175504b9a902003
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/openebs-storage-class.yaml
@@ -0,0 +1,15 @@
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: openebs-hostpath
+  annotations:
+    openebs.io/cas-type: local
+    cas.openebs.io/config: |
+      - name: BasePath
+        value: "/var/openebs/local"
+      - name: StorageType
+        value: "hostpath"
+provisioner: openebs.io/local
+reclaimPolicy: Delete
+volumeBindingMode: WaitForFirstConsumer
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/post-deploy.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/post-deploy.sh
new file mode 100755
index 0000000000000000000000000000000000000000..bb228ab6b2e37f41b072e1e46ba7df8e6ca6b744
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/post-deploy.sh
@@ -0,0 +1,8 @@
+#!/bin/bash
+# Setup kubectl
+mkdir -p ~/.kube
+/snap/bin/juju scp kubernetes-master/0:config ~/.kube/config
+sudo snap install kubectl --classic
+# Allow privileges
+/snap/bin/juju config kubernetes-master allow-privileged=true
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-machine.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-machine.sh
new file mode 100755
index 0000000000000000000000000000000000000000..05a7907cf5a4a5927d09b1e964aae97a096908f6
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-machine.sh
@@ -0,0 +1,2 @@
+#!/bin/bash
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-repo.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-repo.sh
new file mode 100755
index 0000000000000000000000000000000000000000..48ddabc57cd9399640b8804396a2240eafc89606
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/remove-repo.sh
@@ -0,0 +1,5 @@
+#!/bin/bash
+REPO_NAME=$1
+helm repo remove ${REPO_NAME}
+helm repo update
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/rollback-release.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/rollback-release.sh
new file mode 100755
index 0000000000000000000000000000000000000000..2fb99cea9569eb9e0851732d7b705122f8517590
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/rollback-release.sh
@@ -0,0 +1,8 @@
+#!/bin/bash
+RELEASE=$1
+REVISION="0"
+if [ $# -gt 1 ]; then
+    REVISION=$2
+fi
+helm rollback ${RELEASE} ${REVISION}
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/setup-juju.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/setup-juju.sh
new file mode 100755
index 0000000000000000000000000000000000000000..ae0e8bcc5cfbae3bb469eabb9035bff6ba283560
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/setup-juju.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+timeout=0
+while [ $timeout -lt 900 ]; do
+  if [ -f /home/ubuntu/tmp-cloudinit-installed.txt ]; then
+      break
+  fi
+  sleep 10
+  timeout=$[$timeout + 10]
+done
+if [ timeout -eq 900 ]; then
+  >&2 echo "Cloudinit took longer than expected (> 900s). Not possible to start setup"
+  exit 1
+fi
+cat /dev/zero | ssh-keygen -q -N ""
+MGMT_IP=$(ip -4 -o a s ens3 | awk '{split($4,a,"/"); print a[1]}')
+sshpass -posm4u ssh-copy-id -o "StrictHostKeyChecking no" ubuntu@${MGMT_IP}
+/snap/bin/juju add-cloud --local k8s -f k8s-cloud.yaml
+ssh-copy-id -i /home/ubuntu/.local/share/juju/ssh/juju_id_rsa ubuntu@${MGMT_IP}
+/snap/bin/juju bootstrap k8s jujuk8s
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/undeploy-bundle.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/undeploy-bundle.sh
new file mode 100755
index 0000000000000000000000000000000000000000..05a7907cf5a4a5927d09b1e964aae97a096908f6
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/undeploy-bundle.sh
@@ -0,0 +1,2 @@
+#!/bin/bash
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/upgrade-release.sh b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/upgrade-release.sh
new file mode 100755
index 0000000000000000000000000000000000000000..218e75f793118d33351e6af946410adbbeafe08d
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/scripts/upgrade-release.sh
@@ -0,0 +1,13 @@
+#!/bin/bash
+RELEASE=$1
+CHART=$2
+ADDITIONAL_OPTS="--atomic"
+if [ $# -gt 2 ]; then
+    ADDITIONAL_OPTS="${ADDITIONAL_OPTS} -n $3"
+fi
+if [ $# -gt 3 ]; then
+    ADDITIONAL_OPTS="${ADDITIONAL_OPTS} -f $4"
+fi
+
+helm upgrade ${RELEASE} ${CHART} ${ADDITIONAL_OPTS}
+
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/00-setup b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/00-setup
new file mode 100755
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/10-deploy b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/10-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..9c29cd0ecc89ffd3ff0e61533dcd6d69e7b421d7
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/charms/layers/tid-jujuk8s/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('tid-k8s-master')
+        self.d.expose('tid-k8s-master')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['tid-k8s-master'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/k8s_jujucontroller_vnf/cloud_init/cloud-config.txt b/SOL004/k8s_jujucontroller_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..57d1126d8c487ac70f2bd1c33ac93c4976be3030
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,14 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+package_update: true
+packages:
+- sshpass
+snap:
+  commands:
+    00: snap install juju --classic --channel=2.6/stable
+runcmd:
+- [ su, -l, ubuntu, -c, "touch /home/ubuntu/tmp-cloudinit-installed.txt" ]
+
diff --git a/SOL004/k8s_jujucontroller_vnf/icons/osm.png b/SOL004/k8s_jujucontroller_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/k8s_jujucontroller_vnf/icons/osm.png differ
diff --git a/SOL004/k8s_jujucontroller_vnf/k8s_jujucontroller_vnfd.yaml b/SOL004/k8s_jujucontroller_vnf/k8s_jujucontroller_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aa36621116197adecdd6c7cdf9c704f0b2b66a5f
--- /dev/null
+++ b/SOL004/k8s_jujucontroller_vnf/k8s_jujucontroller_vnfd.yaml
@@ -0,0 +1,216 @@
+vnfd:
+  description: A VNF consisting of 1 VDU for juju to deploy K8s cluster
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: k8svm
+    vdu-profile:
+    - id: k8svm
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          execution-environment-list:
+          - id: tid-jujuk8s-ee
+            juju:
+              charm: tid-jujuk8s
+          config-primitive:
+          - name: setup-juju
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: deploy-bundle
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: bundle
+          - name: undeploy-bundle
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: remove-machines
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: init-helm
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: install-openebs-chart
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: install-openebs-kubectl
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: post-deploy
+            execution-environment-ref: tid-jujuk8s-ee
+          - name: add-machine
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: machine
+          - name: add-machines
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: machine1
+            - data-type: STRING
+              name: machine2
+            - data-type: STRING
+              name: machine3
+            - data-type: STRING
+              name: machine4
+            - data-type: STRING
+              name: machine5
+            - data-type: STRING
+              name: machine6
+            - data-type: STRING
+              name: machine7
+            - data-type: STRING
+              name: machine8
+            - data-type: STRING
+              name: machine9
+            - data-type: STRING
+              name: machine10
+          - name: remove-machines
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: force
+          - name: add-repo
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: name
+            - data-type: STRING
+              name: url
+          - name: remove-repo
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: name
+          - name: install-chart
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: chart
+            - data-type: STRING
+              name: name
+            - data-type: STRING
+              name: namespace
+            - data-type: STRING
+              name: atomic
+            - data-type: STRING
+              name: values
+            - data-type: STRING
+              name: valuesFile
+          - name: upgrade-release
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: chart
+            - data-type: STRING
+              name: name
+            - data-type: STRING
+              name: namespace
+            - data-type: STRING
+              name: atomic
+            - data-type: STRING
+              name: values
+            - data-type: STRING
+              name: valuesFile
+          - name: rollback-release
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: name
+            - data-type: STRING
+              name: revision
+          - name: delete-release
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - data-type: STRING
+              name: name
+          id: k8s_jujucontroller_vnf
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            seq: '1'
+          - name: setup-juju
+            execution-environment-ref: tid-jujuk8s-ee
+            seq: '2'
+          - name: add-machines
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - name: machine1
+              value: <MACHINE1>
+            - name: machine2
+              value: <MACHINE2>
+            - name: machine3
+              value: <MACHINE3>
+            - name: machine4
+              value: <MACHINE4>
+            - name: machine5
+              value: <MACHINE5>
+            - name: machine6
+              value: <MACHINE6>
+            - name: machine7
+              value: <MACHINE7>
+            - name: machine8
+              value: <MACHINE8>
+            - name: machine9
+              value: <MACHINE9>
+            - name: machine10
+              value: <MACHINE10>
+            seq: '3'
+          - name: deploy-bundle
+            execution-environment-ref: tid-jujuk8s-ee
+            parameter:
+            - name: bundle
+              value: <BUNDLE>
+            seq: '4'
+          - name: post-deploy
+            execution-environment-ref: tid-jujuk8s-ee
+            seq: '5'
+          - name: install-openebs-kubectl
+            execution-environment-ref: tid-jujuk8s-ee
+            seq: '6'
+  ext-cpd:
+  - id: mgmt-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: k8svm
+  id: k8s_jujucontroller_vnf
+  mgmt-cp: mgmt-ext
+  product-name: k8s_jujucontroller_vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: k8svm
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: k8svm
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: k8svm-compute
+    virtual-storage-desc:
+    - k8svm-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: k8svm-compute
+    virtual-cpu:
+      num-virtual-cpu: 2
+    virtual-memory:
+      size: 4.0
+  virtual-storage-desc:
+  - id: k8svm-storage
+    size-of-storage: 80
diff --git a/SOL004/k8s_jujumachine_vnf/README.md b/SOL004/k8s_jujumachine_vnf/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..5243dd795d6bdd3c946dd2394586076fb0c21863
--- /dev/null
+++ b/SOL004/k8s_jujumachine_vnf/README.md
@@ -0,0 +1,4 @@
+This is a VNF with 3 big VDUs intended to model 3 VMS that will become 
+a simple K8s cluster. No configuration is applied. Configuration will be
+done offline.
+
diff --git a/SOL004/k8s_jujumachine_vnf/cloud_init/cloud-config.txt b/SOL004/k8s_jujumachine_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..37caad3d4fa2ae0e33ea691bcb2f1be01492a770
--- /dev/null
+++ b/SOL004/k8s_jujumachine_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,5 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
diff --git a/SOL004/k8s_jujumachine_vnf/icons/osm.png b/SOL004/k8s_jujumachine_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/k8s_jujumachine_vnf/icons/osm.png differ
diff --git a/SOL004/k8s_jujumachine_vnf/k8s_jujumachine_vnfd.yaml b/SOL004/k8s_jujumachine_vnf/k8s_jujumachine_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..85d6934d815c76b4687ba80086c2d0dbd1907a98
--- /dev/null
+++ b/SOL004/k8s_jujumachine_vnf/k8s_jujumachine_vnfd.yaml
@@ -0,0 +1,49 @@
+vnfd:
+  description: A VNF consisting of 1 VDUs to be configured as a K8s worker or master
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: k8svm
+    vdu-profile:
+    - id: k8svm
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: mgmt-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: k8svm
+  id: k8s_jujumachine_vnf
+  mgmt-cp: mgmt-ext
+  product-name: k8s_jujumachine_vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: k8svm
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: k8svm
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: k8svm-compute
+    virtual-storage-desc:
+    - k8svm-storage
+  version: 1.0
+  virtual-compute-desc:
+  - id: k8svm-compute
+    virtual-cpu:
+      num-virtual-cpu: 8
+    virtual-memory:
+      size: 16.0
+  virtual-storage-desc:
+  - id: k8svm-storage
+    size-of-storage: 80
diff --git a/SOL004/magma/.gitignore b/SOL004/magma/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..b6ef012c646bcf7674243818d15ef7cd30f48d49
--- /dev/null
+++ b/SOL004/magma/.gitignore
@@ -0,0 +1 @@
+*tar.gz
\ No newline at end of file
diff --git a/SOL004/magma/README.md b/SOL004/magma/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..e55bfdf1f8edb56ab99f4227c406b7619dfcf367
--- /dev/null
+++ b/SOL004/magma/README.md
@@ -0,0 +1,152 @@
+# Hackfest Magma
+
+## Diagram
+
+![magmaHF9](/uploads/c1e07f12824302269ef7d591de8841b0/magmaHF9.png)
+
+## Preparation
+
+### Infrastructure preparation
+
+This example requires a PNF, emulated with a VyOS router (image [here](http://osm-download.etsi.org/ftp/osm-6.0-six/7th-hackfest/images/vyos-1.1.7-cloudinit.qcow2.tgz)), connected to a shared management network (osm-ext in this example) and to a shared internal "sgi" network where the Slice will be placed.
+There is a "build_infra.sh" with some examples of what needs to be prepared.
+
+1. Make sure you add a VIM that has a default management network, for example: `osm vim-create ... --config='{management_network_name: <vim mgmt-net name>}'`
+1. Add the PDU with the yaml file (emulated by a VyOS VM in this environment). You can do it with `osm pdu-create --descriptor_file pdu.yaml` (editing at least the VIM ID first)
+1. Add your K8s Cluster to the VIM.
+
+### Packages preparation
+
+1. If you just cloned the repo, make sure you run `git submodule update --init` under the osm-packages folder.
+1. Take a look at the cloud-init files of the VDUs. They basically remove the default gateway obtained from DHCP and add static routes back to the management networks. Since they map to the ETSI VIM, they might need to be adjusted for your specific use case. The purpose of removing any default gateway acquired from the management interface, is to establish the data path to Internet through the AGW and PNF.
+1. Upload the packages to OSM, the "build_slice.sh" file contain some useful commands, from building to launching.
+1. Make sure you got the images for AGW and srsLTE emulator available [here](http://osm-download.etsi.org/ftp/osm-7.0-seven/OSM9-hackfest/images/).
+
+## Launching the Slice
+
+1. Edit the params.yaml and set an address for your Magma Orc8r-proxy service, which AGW will connect to. Same IP address should go to 'proxyserviceloadBalancerIP' and 'orch_ip', and should belong to your K8 Cluster MetalLB pool. Make sure you assign an IP address not being used in the target cluster.
+1. In the same file, set a name and ID for the first AGW, in parameters agw_id and agw_name (they need to be different each time you launch a new slice)
+1. Launch the slice with:
+`osm nsi-create --nsi_name magma_slice --nst_name magma_slice_hackfest_nst --config_file params.yaml --ssh_keys <your_key> --vim_account <vim_account>`
+
+## Verifying the services
+
+### AG, eNodeB and Subscriber Registration through Day-1 primitives
+
+1. Visit the Orc8r dashboard at the KNF's nginx-proxy svc IP, with https and credentials admin@magma.test / password1234, then check that your AGW has been registered successfully under the list of Gateways in this path: https://<orc8r-nginx-proxy-ip>/nms/osmnet/gateways) (after proxy charms are finished)
+2. Via this same dashboard, check that a test subscriber has been added (as Day-1 primitive), with these parameters:
+    - IMSI: 722070000000008
+    - KEY: c8eba87c1074edd06885cb0486718341
+    - OPC: 17b6c0157895bcaa1efc1cef55033f5f
+
+3. Check that the eNodeB has registered to the AGW (as Day-1 primitive that uses juju-relations), by accesing the Magma AGW via SSH and running "tail -f /var/log/mme.log".
+   Otherwise, you can go to the Magma Orc8r dashboard and look for the "Connected EnodeB" metrics. 
+
+### UE attach through Day-2 primitive
+
+After the eNodeB is connected, UE attachment can be done through the following Day-2 primitive:
+
+`osm ns-action magma_slice.slice_hackfest_nsd_epc --vnf_name MagmaAGWsrsLTE --vdu_id srsLTE-vdu --action_name attach-ue --params '{usim-imsi: "722070000000008", usim-k: "c8eba87c1074edd06885cb0486718341", usim-opc: "17b6c0157895bcaa1efc1cef55033f5f"}'`
+
+## Testing traffic
+
+After UE is attached (at emulator machine), the "tun_srsue" will appear, and a default route should be added automatically to it (script at the image), pointing to the GTP tunnel endpoint:
+
+Make sure the PNF (VyOS Router) is pre-configured to deny all traffic unless explicitely added to a MAGMA_AGW group:
+
+```
+set firewall group network-group MAGMA_AGW network 192.168.239.10 # this rule is added by the primitive
+
+set firewall name MAGMA_FW default-action drop
+set firewall name MAGMA_FW rule 10 action accept
+set firewall name MAGMA_FW rule 10 source group network-group MAGMA_AGW
+
+set interfaces ethernet eth1 firewall in name MAGMA_FW
+```
+
+With this, a Day-2 primitive can be executed against the PNF to allow traffic from the specific Magma SGI IP address, for example, if it's 192.168.239.10:
+
+`osm ns-action magma_slice.slice_hackfest_nsd_epc --vnf_name VYOS-PNF --action_name configure-remote --params '{magmaIP: "192.168.239.10"}'`
+
+After the primitive is executed, the UE machine will have access to Internet through the AGW and then the VyOS PNF.
+
+## Additional tests
+
+### Web Proxy service
+
+A Web Proxy is available via a KNF with primitives, implemented with Squid through juju-bundles mechanism.
+
+Deploy this NS:
+`osm ns-create --ns_name webcache --nsd_name squid-cnf-ns --vim_account <vim_account> --config '{vld: [ {name: mgmtnet, vim-network-name: osm-ext} ]}'`
+
+The UE's browser can be now configured to navigate using this proxy service. Configure it at the browser's preferences, using the K8sCluster exposed IP for this service, and port 3128 (for HTTP, HTTPs and FTP requests)
+
+Primitives are available to add/remove allowed URLs:
+
+`osm ns-action webcache --vnf_name squid-vnf --kdu_name squid-kdu --action_name addurl --params '{application-name: squid, url: wikipedia.org}'`
+
+`osm ns-action webcache --vnf_name squid-vnf --kdu_name squid-kdu --action_name deleteurl --params '{application-name: squid, url: wikipedia.org}'`
+
+### Network Slicing
+
+Additional slice instances can be launched (changing agw_id and agw_name), and we should see that just the AGW+emulator NS is launched, as the Orc8r NS is shared.
+
+### Metrics collection
+
+VIM-level metrics are being collected by default, they can be observed at the Grafana dashboard.
+
+VNF-level metrics are collected through SNMP using a dedicated "execution environment" POD which includes the SNMP Exporter Prometheus module.
+Its specifications can be found inside the "helm" folder in the VNF package. They can be found at Prometheus GUI (look for metrics starting with "if", from the IF-MIB) and added manually to Grafana. 
+
+
+### Placement
+
+A second slice, reusing the same Orc8r, can be launched at different VIM, so that we see AGWs being launched at remotely VIMs. It would need management networks to be reachable between VIMs so the Orc8r's exposed address is reachable from the remote AGWs. The procedure is as follows:
+
+1. [ If PLA not available in setup] Make sure you add the Placement module to your OSM installation.
+1. Prepare the second VIM by ensuring it has the PNF/PDU and the required images.
+1. Edit the `pil_price_list.yaml` and `vnf_price_list.yaml` as desired, ensuring that it's "less expensive" to launch the VNFs at the second VIM.  Examples are available at this repo.     
+1. Copy the files to the placement folder at PLA. A sample using docker is below, which can be made with kubectl in a similar way.
+   `docker cp vnf_price_list.yaml $(docker ps -qf name=osm_pla):/placement/.`
+   `docker cp pil_price_list.yaml $(docker ps -qf name=osm_pla):/placement/.`
+1. Uncomment the placement-engine line and launch as usual! you should see the AGW/srsLTE/PNF subnet being instantiated in the second VIM.
+
+### Auto-scaling
+
+Magma AGW VDU is configured for autoscaling when CPU exceeds a threshold. After scaling, services are not automatically balanced (possible enhancement for the future)
+
+### SDN Assist
+
+The MagmaAGWsrsLTE VNF has been designed so that there can be an SDN-Assisted data-plane in the internal S1 VLD. As long as the interfaces are declared as "SR-IOV" in the descriptor, instead of PARAVIRT/VIRTIO.
+
+Even though it can be tested with any fabric for which there is an SDN Assist plugin in OSM, this documentation will refer to the case where an OpenFlow-based fabric is used to interconnect the servers, so that ONOS VPLS becomes the ideal plugin to use.
+
+Requirements:
+- Each server where an AGW or srsLTE VDU is expected to be launched should have an SR-IOV-enabled port towards the OpenFlow fabric.
+- The VIM must have been created with a reference to the physnet(s) to use for SR-IOV (typically something like: `--config '{dataplane_physical_net: physnet2, microversion: 2.32}'`)
+- An ONOS SDN Controller must be installed and it must be reachable from OSM, for example, you can use the following snippet inside the OSM VM:
+```
+docker run -t -d --restart always --network host --name onos onosproject/onos
+
+docker exec -it onos /bin/bash
+apt update
+apt install -y openssh-server
+
+ssh -p 8101 -o StrictHostKeyChecking=no karaf@localhost
+
+# These entries may require a ctrl+c to escape back to prompt, or rather use the ONOS GUI. 
+onos:app activate org.onosproject.openflow-base
+onos:app activate org.onosproject.openflow
+onos:app activate org.onosproject.ofagent
+onos:app activate org.onosproject.vpls
+
+``` 
+- An "SDN Port Mapping" file must be prepared to include all the possible PCI ports that can be selected by the VIM, per port. An example for ETSI VIM is included in this repo.
+- The VIM user must have admin privileges.
+
+Procedure:
+1. Create the SDN Controller in OSM, for example:
+`osm sdnc-create --name onos01 --type onos_vpls --url http://172.21.248.19:8181 --user karaf --password karaf`
+1. Update the VIM to use the SDN Controller and the port mapping file, for example:
+`osm vim-update etsi-openstack --sdn_controller onos01 --sdn_port_mapping sdn_port_mapping.yaml`
+1. Instantiate with SR-IOV ports. OpenFlow entries will be created and can be seen at the ONOS GUI (http://onos_ip/onos/ui)
diff --git a/SOL004/magma/build_infra.sh b/SOL004/magma/build_infra.sh
new file mode 100755
index 0000000000000000000000000000000000000000..c7d882e0f919f65ee79ed08b5b7579307e63b69b
--- /dev/null
+++ b/SOL004/magma/build_infra.sh
@@ -0,0 +1,26 @@
+
+# Add Helm repo for Magma Orc8r
+osm repo-add --type helm-chart --description "Repository for Facebook Magma helm Chart" magma https://felipevicens.github.io/fb-magma-helm-chart/
+
+# Add first VIM
+osm vim-create --name etsi-openstack --user hackfest --password hackfest20$ --auth_url http://172.21.247.1:5000/v3 --tenant hackfest --account_type openstack --config='{management_network_name: osm-ext, dataplane_physical_net: physnet2, microversion: 2.32}'
+
+# Add first PDU
+VIMID=`osm vim-list | grep "etsi-openstack " | awk '{ print $4 }'`
+sed -i "s/vim_accounts: .*/vim_accounts: [ $VIMID ]/" pdu.yaml
+osm pdu-create --descriptor_file pdu.yaml
+
+# Add second VIM
+osm vim-create --name etsi-openstack-lowcost --user osm_mdl --password osmmdl20$ --auth_url http://172.21.7.5:5000/v3 --tenant osm_mdl --account_type openstack --config='{management_network_name: management}'
+
+# Add second PDU
+VIMID=`osm vim-list | grep "etsi-openstack-lowcost" | awk '{ print $4 }'`
+sed -i "s/vim_accounts: .*/vim_accounts: [ $VIMID ]/" pdu.yaml
+osm pdu-create --descriptor_file pdu.yaml
+
+# Add K8sCluster to first VIM
+osm k8scluster-add --creds ~/kube.yaml --version '1.15' --vim etsi-openstack --description "My K8s cluster" --k8s-nets '{"net1": "osm-ext"}' etsi-k8scluster
+
+# Add SDN Controller
+#osm sdnc-create --name onos01 --type onos_vpls --url http://172.21.248.19:8181 --user karaf --password karaf 
+#osm vim-update whitecloud_highcost_sriov --sdn_controller onos02 --sdn_port_mapping sdn_port_mapping.yaml
\ No newline at end of file
diff --git a/SOL004/magma/build_slice.sh b/SOL004/magma/build_slice.sh
new file mode 100755
index 0000000000000000000000000000000000000000..2fd39a049d78b9dc3fb615836982d149a6567c1d
--- /dev/null
+++ b/SOL004/magma/build_slice.sh
@@ -0,0 +1,22 @@
+osm nst-delete magma_slice_hackfest_nst
+osm nsd-delete hackfest_magma-agw-enb_nsd
+osm nsd-delete fb_magma_ns
+osm vnfd-delete hackfest_magma-agw-enb_vnfd
+osm vnfd-delete hackfest_gateway_vnfd
+osm vnfd-delete fb_magma_knf
+
+osm nfpkg-create hackfest_magma-agw-enb_vnfd
+osm nfpkg-create hackfest_gateway_vnfd
+osm nspkg-create hackfest_magma-agw-enb_nsd
+osm nfpkg-create fb_magma_knf
+osm nspkg-create fb_magma_ns
+
+osm netslice-template-create magma_slice.yaml
+
+osm nsi-create --nsi_name magma_slice --nst_name magma_slice_hackfest_nst \
+--config_file params.yaml --ssh_keys ~/.ssh/id_rsa.pub --vim_account etsi-openstack
+
+sleep 15
+osm ns-list | grep "\<slice_hackfest_nsd_epc\>" | awk '{print $4}' | xargs -l1 juju switch
+juju model-config enable-os-refresh-update=false enable-os-upgrade=false
+juju model-config apt-mirror=http://fr.archive.ubuntu.com/ubuntu/
diff --git a/SOL004/magma/build_webhost.sh b/SOL004/magma/build_webhost.sh
new file mode 100755
index 0000000000000000000000000000000000000000..e9ef0e68764c64dbf3ac81ac3995d4d24bb6db56
--- /dev/null
+++ b/SOL004/magma/build_webhost.sh
@@ -0,0 +1,10 @@
+tar -cvzf hackfest_squid_cnf_ns.tar.gz hackfest_squid_cnf_ns/
+tar -cvzf hackfest_squid_cnf.tar.gz hackfest_squid_cnf/
+
+osm nsd-delete squid-cnf-ns 
+osm vnfd-delete squid-vnf
+
+osm vnfd-create hackfest_squid_cnf.tar.gz
+osm nsd-create hackfest_squid_cnf_ns.tar.gz
+
+osm ns-create --ns_name webcache --nsd_name squid-cnf-ns --vim_account etsi-openstack --config '{vld: [ {name: mgmtnet, vim-network-name: osm-ext} ] }'
\ No newline at end of file
diff --git a/SOL004/magma/delete_slice.sh b/SOL004/magma/delete_slice.sh
new file mode 100755
index 0000000000000000000000000000000000000000..17e60b22f12e6bb274725eb712561f7aeb8d2cc2
--- /dev/null
+++ b/SOL004/magma/delete_slice.sh
@@ -0,0 +1,6 @@
+#!/bin/bash
+osm nsi-delete magma_slice
+osm ns-delete magma_slice.slice_hackfest_nsd_epc
+osm ns-delete magma_slice.slice_hackfest_nsd_epcmgmt
+PROJECT=$(osm project-list | grep $OSM_PROJECT | awk '{print $4}')
+echo "To ensure complete deletion, run this in your K8s cluster: kubectl delete namespace $PROJECT"
\ No newline at end of file
diff --git a/SOL004/magma/fb_magma_knf/fb_magma_vnfd.yaml b/SOL004/magma/fb_magma_knf/fb_magma_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..068ed7499d2ba09bb8ec014f6a6159a9b044d2fb
--- /dev/null
+++ b/SOL004/magma/fb_magma_knf/fb_magma_vnfd.yaml
@@ -0,0 +1,18 @@
+vnfd:
+  description: KNF with KDU using a helm-chart for Facebook magma orc8r
+  df:
+  - id: default-df
+  ext-cpd:
+  - id: mgmt-ext
+    k8s-cluster-net: mgmtnet
+  id: fb_magma_knf
+  k8s-cluster:
+    nets:
+    - id: mgmtnet
+  kdu:
+  - name: orc8r
+    helm-chart: magma/orc8r
+  mgmt-cp: mgmt-ext
+  product-name: fb_magma_knf
+  provider: ATOS
+  version: '1.0'
diff --git a/SOL004/magma/fb_magma_ns/fb_magma_nsd.yaml b/SOL004/magma/fb_magma_ns/fb_magma_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3cd817fc0106011558429fc782c3c98d5e5fffcc
--- /dev/null
+++ b/SOL004/magma/fb_magma_ns/fb_magma_nsd.yaml
@@ -0,0 +1,22 @@
+nsd:
+  nsd:
+  - description: NS consisting of a KNF fb_magma_knf connected to mgmt network
+    designer: ATOS
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: orc8r
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: orc8r
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: fb_magma_knf
+    id: fb_magma_ns
+    name: fb_magma_ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - fb_magma_knf
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/.DS_Store b/SOL004/magma/hackfest_gateway_vnfd/charms/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..9a733bc2bb969d4c2f197caeb8fe16a6d90a128d
Binary files /dev/null and b/SOL004/magma/hackfest_gateway_vnfd/charms/.DS_Store differ
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/README.md b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..2bdcab20c1a6d39aaffe9a450ba3bdbc44044b42
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/README.md
@@ -0,0 +1,3 @@
+# Vyos-config
+
+This is a proxy charm used by Open Source Mano (OSM) to configure Vyos Router PNF, written in the [Python Operator Framwork](https://github.com/canonical/operator)
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/actions.yaml b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..88c15ea0b3dbce171e66ae3d6fb0c13b3068418c
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/actions.yaml
@@ -0,0 +1,27 @@
+# VyOS Action
+configure-remote:
+  description: "Add firewall rule to VyOS PNF."
+  params:
+    magmaIP:
+      description: "Magma AGW allowed IP"
+      type: "string"
+      default": "0.0.0.0"
+  required:
+    - magmaIP
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/config.yaml b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5b908ae0a19da5d540c59d887ab4ca7939ebdd08
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/config.yaml
@@ -0,0 +1,29 @@
+options:
+    ssh-hostname:
+        type: string
+        default: ""
+        description: "The hostname or IP address of the machine to"
+    ssh-username:
+        type: string
+        default: ""
+        description: "The username to login as."
+    ssh-password:
+        type: string
+        default: ""
+        description: "The password used to authenticate."
+    # ssh-private-key:
+    #     type: string
+    #     default: ""
+    #     description: "DEPRECATED. The private ssh key to be used to authenticate."
+    ssh-public-key:
+        type: string
+        default: ""
+        description: "The public key of this unit."
+    ssh-key-type:
+        type: string
+        default: "rsa"
+        description: "The type of encryption to use for the SSH key."
+    ssh-key-bits:
+        type: int
+        default: 4096
+        description: "The number of bits to use for the SSH key."
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/hooks/install b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charmhelpers b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charmhelpers
new file mode 120000
index 0000000000000000000000000000000000000000..cedc09e9124f7168aa9a7decc8a5129293eb88a6
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charmhelpers
@@ -0,0 +1 @@
+../mod/charm-helpers/charmhelpers
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charms/osm b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charms/osm
new file mode 120000
index 0000000000000000000000000000000000000000..385b019dc112a34c6c14d2f77fd25d1d94551ff7
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/charms/osm
@@ -0,0 +1 @@
+../../mod/charms.osm/charms/osm
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/ops b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/metadata.yaml b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c331b60d88dcfc3f1c675e24282dacdf8ec4ffdb
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/metadata.yaml
@@ -0,0 +1,11 @@
+name: vyos-config
+summary: A proxy charm to configure VyOS Router
+maintainer: David García <david.garcia@canonical.com>
+description: |
+  Charm to configure VyOS PNF
+series:
+  - xenial
+  - bionic
+peers:
+  proxypeer:
+    interface: proxypeer
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/playbooks/configure-remote.yaml b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/playbooks/configure-remote.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cc0232fae05dca7c81301a771a07b133f006a75c
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/playbooks/configure-remote.yaml
@@ -0,0 +1,8 @@
+- hosts: vyos-routers
+  connection: local
+  tasks:
+  - name: add a host to the list of allowed in the firewall group
+    vyos_config:
+      lines:
+        - set firewall group network-group MAGMA_AGW network "{{ MAGMA_AGW_IP }}/32"
+
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/requirements.txt b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/src/charm.py b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..b110e1c95fac46445b6f50c5334716fab6705f98
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/charms/vyos-config/src/charm.py
@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+import sys
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+import os
+import subprocess
+import traceback
+
+from charms.osm.sshproxy import SSHProxyCharm
+from charms.osm import libansible
+
+
+class VyosCharm(SSHProxyCharm):
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        # Register all of the events we want to observe
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+        self.framework.observe(self.on.upgrade_charm, self.on_upgrade_charm)
+        # Charm actions (primitives)
+        self.framework.observe(
+            self.on.configure_remote_action, self.on_configure_remote_action
+        )
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+        self.unit.status = MaintenanceStatus("Installing Ansible")
+        libansible.install_ansible_support()
+        self.unit.status = ActiveStatus()
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+
+    def on_configure_remote_action(self, event):
+        """Configure remote."""
+
+        if self.unit.is_leader():
+            try:
+                config = self.model.config
+                magmaIP = event.params["magmaIP"]
+                dict_vars = {"MAGMA_AGW_IP": magmaIP}
+                result = libansible.execute_playbook(
+                    "configure-remote.yaml",
+                    config["ssh-hostname"],
+                    config["ssh-username"],
+                    config["ssh-password"],
+                    dict_vars,
+                )
+                event.set_results({"output": result})
+            except:
+                exc_type, exc_value, exc_traceback = sys.exc_info()
+                err = traceback.format_exception(exc_type, exc_value, exc_traceback)
+                event.fail(message="configure-remote failed: " + str(err))
+
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_upgrade_charm(self, event):
+        """Upgrade the charm."""
+
+
+if __name__ == "__main__":
+    main(VyosCharm)
diff --git a/SOL004/magma/hackfest_gateway_vnfd/hackfest_gateway_vnfd.yaml b/SOL004/magma/hackfest_gateway_vnfd/hackfest_gateway_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f2cf5089214b86e6cc75496dbbe696d4693a909a
--- /dev/null
+++ b/SOL004/magma/hackfest_gateway_vnfd/hackfest_gateway_vnfd.yaml
@@ -0,0 +1,59 @@
+vnfd:
+  description: Gateway PNF
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: gateway_pdu
+    vdu-profile:
+    - id: gateway_pdu
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - name: configure-remote
+            execution-environment-ref: vyos-config-ee
+            parameter:
+            - data-type: STRING
+              default-value: 0.0.0.0
+              name: magmaIP
+          id: hackfest_gateway_vnfd
+          execution-environment-list:
+          - id: vyos-config-ee
+            juju:
+              charm: vyos-config
+          config-access:
+            ssh-access:
+              default-user: osm
+              required: true
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: vyos-config-ee
+            parameter:
+            - name: ssh-username
+              value: osm
+            - name: ssh-password
+              value: osm2020
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            seq: 1
+  ext-cpd:
+  - id: gateway_public-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: gateway_pdu
+  id: hackfest_gateway_vnfd
+  mgmt-cp: gateway_public-ext
+  product-name: hackfest_gateway_vnfd
+  vdu:
+  - description: gateway_pdu
+    id: gateway_pdu
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+    pdu-type: gateway
+  version: '1.0'
diff --git a/SOL004/magma/hackfest_magma-agw-enb_nsd/README b/SOL004/magma/hackfest_magma-agw-enb_nsd/README
new file mode 100644
index 0000000000000000000000000000000000000000..77850bb3719ade9bd4a781275d7825178ac113ba
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_nsd/README
@@ -0,0 +1,2 @@
+Descriptor created by OSM descriptor package generated
+Created on Tue Jan 14 17:49:17 UTC 2020
diff --git a/SOL004/magma/hackfest_magma-agw-enb_nsd/magma-agw-enb_nsd.yaml b/SOL004/magma/hackfest_magma-agw-enb_nsd/magma-agw-enb_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..43717cfe1f7d8796180166f0c9927dbd8fa54bfc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_nsd/magma-agw-enb_nsd.yaml
@@ -0,0 +1,42 @@
+nsd:
+  nsd:
+  - description: Magma AGW 1.0.0 with tools & srsLTE connected to PNF Gateway
+    designer: Whitestack
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: MagmaAGWsrsLTE
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: MagmaAGWsrsLTE
+            constituent-cpd-id: agw-mgmt-ext
+          - constituent-base-element-id: MagmaAGWsrsLTE
+            constituent-cpd-id: srsLTE-mgmt-ext
+          virtual-link-profile-id: mgmt
+        - constituent-cpd-id:
+          - constituent-base-element-id: MagmaAGWsrsLTE
+            constituent-cpd-id: agw-sgi-ext
+          virtual-link-profile-id: sgi
+        vnfd-id: hackfest_magma-agw-enb_vnfd
+      - id: VYOS-PNF
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: VYOS-PNF
+            constituent-cpd-id: gateway_public-ext
+          virtual-link-profile-id: mgmt
+        - constituent-cpd-id:
+          - constituent-base-element-id: VYOS-PNF
+            constituent-cpd-id: gateway_public-ext
+          virtual-link-profile-id: sgi
+        vnfd-id: hackfest_gateway_vnfd
+    id: hackfest_magma-agw-enb_nsd
+    name: hackfest_magma-agw-enb_nsd
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmt
+      mgmt-network: true
+    - id: sgi
+      vim-network-name: sgi
+    vnfd-id:
+    - hackfest_magma-agw-enb_vnfd
+    - hackfest_gateway_vnfd
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/enodeb.zip b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/enodeb.zip
new file mode 100644
index 0000000000000000000000000000000000000000..c46bcf3b4d966e513712297bd9fbbbff27df341b
Binary files /dev/null and b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/enodeb.zip differ
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/README.md b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..0f572b6b57ac95f98bb23bbb901cf4bea089d16f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/README.md
@@ -0,0 +1,3 @@
+# Magma AGW Charm
+
+This is a proxy charm used by Open Source Mano (OSM) to configure Magma AGW, written in the [Python Operator Framwork](https://github.com/canonical/operator)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/actions.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6e82286a804dca633b66e133a215dcbd9ac5ff84
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/actions.yaml
@@ -0,0 +1,85 @@
+# Magma AGW Actions
+add-net:
+  description: "Add AGW Network if needed"
+  params:
+    orch_ip:
+      description: "Orchestrator IP"
+      type: "string"
+      default: ""
+    orch_net:
+      description: "Orchestrator Network"
+      type: "string"
+      default: ""
+add-gw:
+  description: "Self-register for the AGW"
+  params:
+    agw_id:
+      description: "AGW ID"
+      type: "string"
+      default: ""
+    agw_name:
+      description: "AGW NAME"
+      type: "string"
+      default: ""
+    orch_ip:
+      description: "Orchestrator IP"
+      type: "string"
+      default: ""
+    orch_net:
+      description: "Orchestrator Network"
+      type: "string"
+      default: ""
+reset-id:
+  description: "Resets the hardware ID"
+add-hosts:
+  description: "Add Orchestrator host in /etc/hosts"
+  params:
+    orch_id:
+      description: "Orchestrator ID"
+      type: "string"
+      default: ""
+restart-magma:
+  description: "Restarts Magma services"
+del-gw:
+  description: "Deregister for AGW"
+  params:
+    agw_id:
+      description: "AGW ID"
+      type: "string"
+      default: ""
+    orch_ip:
+      description: "Orchestrator IP"
+      type: "string"
+      default: ""
+    orch_net:
+      description: "Orchestrator Network"
+      type: "string"
+      default: ""
+add-test-subscriber:
+  description: "Adds test subscriber to Orc8r HSS"
+  params:
+    orch_ip:
+      description: "Orchestrator IP"
+      type: "string"
+      default: ""
+    orch_net:
+      description: "Orchestrator Network"
+      type: "string"
+      default: ""
+
+# Required by charms.osm.sshproxy
+run:
+  description: "Run an arbitrary command"
+  params:
+    command:
+      description: "The command to execute."
+      type: string
+      default: ""
+  required:
+    - command
+generate-ssh-key:
+  description: "Generate a new SSH keypair for this unit. This will replace any existing previously generated keypair."
+verify-ssh-credentials:
+  description: "Verify that this unit can authenticate with server specified by ssh-hostname and ssh-username."
+get-ssh-public-key:
+  description: "Get the public SSH key for this unit."
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/config.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..56551babcb13b483bff56b55198ae9f8201087b6
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/config.yaml
@@ -0,0 +1,29 @@
+options:
+  ssh-hostname:
+    type: string
+    default: ""
+    description: "The hostname or IP address of the machine to"
+  ssh-username:
+    type: string
+    default: ""
+    description: "The username to login as."
+  ssh-password:
+    type: string
+    default: ""
+    description: "The password used to authenticate."
+  # ssh-private-key:
+  #     type: string
+  #     default: ""
+  #     description: "DEPRECATED. The private ssh key to be used to authenticate."
+  ssh-public-key:
+    type: string
+    default: ""
+    description: "The public key of this unit."
+  ssh-key-type:
+    type: string
+    default: "rsa"
+    description: "The type of encryption to use for the SSH key."
+  ssh-key-bits:
+    type: int
+    default: 4096
+    description: "The number of bits to use for the SSH key."
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/hooks/install b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..25b1f68fa39d58d33c08ca420c3d439d19be0c55
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/hooks/install
@@ -0,0 +1 @@
+../src/charm.py
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/charms/osm b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/charms/osm
new file mode 120000
index 0000000000000000000000000000000000000000..385b019dc112a34c6c14d2f77fd25d1d94551ff7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/charms/osm
@@ -0,0 +1 @@
+../../mod/charms.osm/charms/osm
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/ops b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/ops
new file mode 120000
index 0000000000000000000000000000000000000000..d93419320c2e0d3133a0bc8059e2f259bf5bb213
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/lib/ops
@@ -0,0 +1 @@
+../mod/operator/ops
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/metadata.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d511a3be31518188db38925b337fc91c2712f12e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/metadata.yaml
@@ -0,0 +1,15 @@
+name: magmagw
+summary: Charm for Magma AGW
+maintainer: David García <david.garcia@canonical.com>
+description: |
+  Charm for Magma AGW (version 1.0.0 with extra tools)
+series:
+  - bionic
+  - xenial
+# Needed for proxy charm in HA
+peers:
+  proxypeer:
+    interface: proxypeer
+provides:
+  agw:
+    interface: lte-vepc
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/src/charm.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..bad2d873bca292060058408e9767450a6f64434e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/magmagw/src/charm.py
@@ -0,0 +1,227 @@
+#!/usr/bin/env python3
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+#     Unless required by applicable law or agreed to in writing, software
+#     distributed under the License is distributed on an "AS IS" BASIS,
+#     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#     See the License for the specific language governing permissions and
+#     limitations under the License.
+
+import sys
+
+sys.path.append("lib")
+
+from ops.charm import CharmBase, CharmEvents
+from ops.framework import StoredState, EventBase, EventSource
+from ops.main import main
+from ops.model import (
+    ActiveStatus,
+    BlockedStatus,
+    MaintenanceStatus,
+    WaitingStatus,
+    ModelError,
+)
+
+from charms.osm.sshproxy import SSHProxyCharm
+import subprocess
+
+
+class MagmaAGWProxyCharm(SSHProxyCharm):
+
+    state = StoredState()
+
+    def __init__(self, framework, key):
+        super().__init__(framework, key)
+
+        self.state.set_default(registered=False, ready=False)
+
+        # Listen to charm events
+        self.framework.observe(self.on.config_changed, self.on_config_changed)
+        self.framework.observe(self.on.install, self.on_install)
+        self.framework.observe(self.on.start, self.on_start)
+
+        # Charm actions (primitives)
+        self.framework.observe(self.on.add_net_action, self.on_add_net_action)
+        self.framework.observe(self.on.add_gw_action, self.on_add_gw_action)
+        self.framework.observe(self.on.reset_id_action, self.on_reset_id_action)
+        self.framework.observe(self.on.add_hosts_action, self.on_add_hosts_action)
+        self.framework.observe(
+            self.on.restart_magma_action, self.on_restart_magma_action
+        )
+        self.framework.observe(self.on.del_gw_action, self.on_del_gw_action)
+        self.framework.observe(self.on.reset_id_action, self.on_reset_id_action)
+        self.framework.observe(
+            self.on.add_test_subscriber_action, self.on_add_test_subscriber_action
+        )
+
+        # # Relation
+        self.framework.observe(self.on.agw_relation_joined, self.agw_relation_joined)
+
+    def agw_relation_joined(self, event):
+        if self.unit.is_leader():
+            if not self.state.ready:
+                event.defer()
+                return
+            self.send_relation_data()
+
+    def send_relation_data(self):
+        relation = self.model.get_relation("agw")
+        if relation is not None and self.state.mme_addr and self.state.magmagw:
+            relation.data[self.unit]["mme-addr"] = self.state.mme_addr
+            relation.data[self.unit]["magmagw"] = self.state.magmagw
+
+    def on_config_changed(self, event):
+        """Handle changes in configuration"""
+        super().on_config_changed(event)
+
+    def on_install(self, event):
+        """Called when the charm is being installed"""
+        super().on_install(event)
+
+    def on_start(self, event):
+        """Called when the charm is being started"""
+        super().on_start(event)
+        if not self.verify_credentials():
+            event.defer()
+            return
+        proxy = self.get_ssh_proxy()
+        ips, _ = proxy.run("hostname -I")
+        ip_list = ips.split(" ")
+        self.state.mme_addr = ip_list[0]
+        self.state.magmagw = ip_list[1]
+
+    # Magma AGW Action implementation
+    def on_add_net_action(self, event):
+        """Add AGW Network if needed"""
+        if self.unit.is_leader():
+            orch_ip = event.params["orch_ip"]
+            orch_net = event.params["orch_net"]
+            proxy = self.get_ssh_proxy()
+
+            attempt = 0
+            while attempt < 50:
+                try:
+                    stdout, stderr = proxy.run(
+                        "/home/magma/addnet.py --orch_ip {} --orch_net {}".format(
+                            orch_ip, orch_net
+                        )
+                    )
+                    break
+                except subprocess.CalledProcessError:
+                    attempt += 1
+                    import time
+
+                    time.sleep(5)
+            event.set_results({"output": stdout, "stderr": stderr})
+            self.state.registered = True
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_add_gw_action(self, event):
+        """Self-register for the AGW"""
+        if self.unit.is_leader():
+            agw_id = event.params["agw_id"]
+            agw_name = event.params["agw_name"]
+            orch_ip = event.params["orch_ip"]
+            orch_net = event.params["orch_net"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(
+                "/home/magma/addgw.py --agw_id {} --agw_name {} --orch_ip {} --orch_net {}".format(
+                    agw_id, agw_name, orch_ip, orch_net
+                )
+            )
+            event.set_results({"output": stdout, "stderr": stderr})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_reset_id_action(self, event):
+        """Resets the hardware ID"""
+        if self.unit.is_leader():
+            proxy = self.get_ssh_proxy()
+            attempt = 0
+            while attempt < 50:
+                try:
+                    stdout, stderr = proxy.run("sudo snowflake --force-new-key")
+                    break
+                except subprocess.CalledProcessError:
+                    attempt += 1
+                    import time
+
+                    time.sleep(5)
+            event.set_results({"output": stdout, "stderr": stderr})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_add_hosts_action(self, event):
+        """Add Orchestrator host in /etc/hosts"""
+        if self.unit.is_leader():
+            orch_ip = event.params["orch_ip"]
+            orch_hosts = "ORCH_IP controller.magma.test\nORCH_IP bootstrapper-controller.magma.test\nORCH_IP state-controller.magma.test\nORCH_IP dispatcher-controller.magma.test\nORCH_IP logger-controller.magma.test\nORCH_IP streamer-controller.magma.test\n"
+            orch_hosts = orch_hosts.replace("ORCH_IP", orch_ip)
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(
+                "echo -e {} | sudo tee -a /etc/hosts".format(orch_hosts)
+            )
+            event.set_results({"output": stdout, "stderr": stderr})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_restart_magma_action(self, event):
+        """Resets the hardware ID"""
+        if self.unit.is_leader():
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run("sudo service magma@* restart")
+            event.set_results({"output": stdout, "stderr": stderr})
+            if self.state.registered:
+                self.state.ready = True
+                self.send_relation_data()
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_del_gw_action(self, event):
+        """Deregister from AGW"""
+        if self.unit.is_leader():
+            agw_id = event.params["agw_id"]
+            orch_ip = event.params["orch_ip"]
+            orch_net = event.params["orch_net"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(
+                "/home/magma/delgw.py --agw_id {} --orch_ip {} --orch_net {}".format(
+                    agw_id, orch_ip, orch_net
+                )
+            )
+            event.set_results({"output": stdout, "stderr": stderr})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+    def on_add_test_subscriber_action(self, event):
+        """Adds test subscriber to Orc8r HSS"""
+        if self.unit.is_leader():
+            orch_ip = event.params["orch_ip"]
+            orch_net = event.params["orch_net"]
+            proxy = self.get_ssh_proxy()
+            stdout, stderr = proxy.run(
+                "/home/magma/addtestsub.py --orch_ip {} --orch_net {}".format(
+                    orch_ip, orch_net
+                )
+            )
+            event.set_results({"output": stdout, "stderr": stderr})
+        else:
+            event.fail("Unit is not leader")
+            return
+
+
+if __name__ == "__main__":
+    main(MagmaAGWProxyCharm)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/LICENSE b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..94a9ed024d3859793618152ea559a168bbcbb5e2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/LICENSE
@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<http://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/README.md b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..4529768c597426fcfb7eb7c860047e06115764cc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/README.md
@@ -0,0 +1,56 @@
+# srs-lte
+
+## Description
+
+Operations packages for SRS EnodeB and User Emulator
+
+## Usage
+
+### Prepare the environment
+
+```bash
+sudo snap install juju --classic --channel 2.8/stable
+sudo snap install lxd
+lxd.init
+juju bootstrap lxd
+juju add-model test-srs-enb-ue
+```
+
+### Deploy (from the Store)
+
+```bash
+juju deploy cs:~charmed-osm/srs-enb-ue --channel edge
+```
+
+### Deploy (locally)
+
+Build the charm:
+
+```bash
+virtualenv -p python3 venv
+source venv/bin/activate
+pip install -r requirements-dev.txt
+pip install charmcraft
+./venv/bin/charmcraft build
+```
+
+Deploy:
+
+```bash
+juju deploy ./srs-enb-ue.charm
+```
+
+## Developing
+
+Create and activate a virtualenv with the development requirements:
+
+    virtualenv -p python3 venv
+    source venv/bin/activate
+    pip install -r requirements-dev.txt
+
+## Testing
+
+The Python operator framework includes a very nice harness for testing
+operator behaviour without full deployment. Just `run_tests`:
+
+    ./run_tests
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/actions.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5831a392280ccdbd4518d89118dd20dfa19186fe
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/actions.yaml
@@ -0,0 +1,26 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need actions, you can remove the file entirely.
+# It ties in to the example _on_fortune_action handler in src/charm.py
+attach-ue:
+  description: Attach User Emulator to enodeB
+  params:
+    usim-imsi:
+      description: "USIM IMSI"
+      type: string
+    usim-k:
+      description: "USIM K"
+      type: string
+    usim-opc:
+      description: "USIM OPC"
+      type: string
+  required:
+    - usim-imsi
+    - usim-k
+    - usim-opc
+detach-ue:
+  description: "Detach from AGW."
+remove-default-gw:
+  description: "Remove default gateway"
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/config.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..067e27955602a3fac8c5ebf26088609de2b76091
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/config.yaml
@@ -0,0 +1,57 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+#
+# This is only an example, and you should edit to suit your needs.
+# If you don't need config, you can remove the file entirely.
+options:
+  bind-address-subnet:
+    type: string
+    description: |
+      The selected bind address will need to be part of this subnet.
+      If this is not set, it will use the IP address from the default interface.
+    default: ""
+  enb-name:
+    type: string
+    description: |
+      TODO
+    default: dummyENB01
+  enb-mcc:
+    type: int
+    description: |
+      TODO
+    default: 901
+  enb-mnc:
+    type: int
+    description: |
+      TODO
+    default: 70
+  enb-rf-device-name:
+    type: string
+    description: |
+      TODO
+    default: "zmq"
+  enb-rf-device-args:
+    type: string
+    description: |
+      TODO
+    default: fail_on_disconnect=true,tx_port=tcp://*:2000,rx_port=tcp://localhost:2001,id=enb,base_srate=23.04e6
+  ue-usim-algo:
+    type: string
+    description: |
+      TODO
+    default: milenage
+  ue-nas-apn:
+    type: string
+    description: |
+      TODO
+    default: oai.ipv4
+  ue-device-name:
+    type: string
+    description: |
+      TODO
+    default: zmq
+  ue-device-args:
+    type: string
+    description: |
+      TODO
+    default: tx_port=tcp://*:2001,rx_port=tcp://localhost:2000,id=ue,base_srate=23.04e6
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/dispatch b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/dispatch
new file mode 100755
index 0000000000000000000000000000000000000000..fe31c0567bdce62a6542a6470997cb6a874e4bd8
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/dispatch
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+JUJU_DISPATCH_PATH="${JUJU_DISPATCH_PATH:-$0}" PYTHONPATH=lib:venv ./src/charm.py
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/install b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/install
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/start b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/start
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/upgrade-charm b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/hooks/upgrade-charm
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/metadata.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..bc8b54e232ff7df494ef27b487535316e74724f3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/metadata.yaml
@@ -0,0 +1,12 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+name: srs-enb-ue
+description: |
+  TODO: fill out the charm's description
+summary: |
+  TODO: fill out the charm's summary
+series:
+  - focal
+requires:
+  mme:
+    interface: lte-vepc # s1c
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements-dev.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements-dev.txt
new file mode 100644
index 0000000000000000000000000000000000000000..34e6ef82473af5ec6fb293e11ef353d30ddcdca6
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements-dev.txt
@@ -0,0 +1,3 @@
+-r requirements.txt
+flake8
+charmcraft
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..302c04bdce8cc9ee8c95db1cc30f6bf069105221
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/requirements.txt
@@ -0,0 +1,5 @@
+ops
+psutil
+netifaces
+netaddr
+jinja2
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/run_tests b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/run_tests
new file mode 100755
index 0000000000000000000000000000000000000000..08ec01e05a8965a5009902a6732adf13c027add6
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/run_tests
@@ -0,0 +1,16 @@
+#!/bin/sh -e
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+if [ -z "$VIRTUAL_ENV" -a -d venv/ ]; then
+    . venv/bin/activate
+fi
+
+if [ -z "$PYTHONPATH" ]; then
+    export PYTHONPATH=src
+else
+    export PYTHONPATH="src:$PYTHONPATH"
+fi
+
+flake8
+python3 -m unittest -v "$@"
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/charm.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..09062e1b6f09161e893cb4898253902c2acfe0d1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/charm.py
@@ -0,0 +1,311 @@
+#!/usr/bin/env python3
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+import logging
+import os
+import shutil
+
+from ops.charm import CharmBase
+from ops.main import main
+from ops.framework import StoredState
+from ops.model import (
+    MaintenanceStatus,
+    ActiveStatus,
+    # BlockedStatus,
+)
+
+from jinja2 import Template
+
+# from typing import Dict, Any
+
+from utils import (
+    service_active,
+    service_start,
+    service_stop,
+    service_restart,
+    service_enable,
+    systemctl_daemon_reload,
+    install_apt,
+    git_clone,
+    shell,
+    copy_files,
+    is_ipv4,
+    ip_from_default_iface,
+    ip_from_iface,
+)
+
+logger = logging.getLogger(__name__)
+
+APT_REQUIREMENTS = [
+    "git",
+    "libzmq3-dev",
+    "cmake",
+    "build-essential",
+    "libmbedtls-dev",
+    "libboost-program-options-dev",
+    "libsctp-dev",
+    "libconfig++-dev",
+    "libfftw3-dev",
+    "net-tools",
+]
+
+GIT_REPO = "https://github.com/srsLTE/srsLTE.git"
+GIT_REPO_TAG = "release_20_10"
+
+SRC_PATH = "/srsLTE"
+BUILD_PATH = "/build"
+CONFIG_PATH = "/config"
+SERVICE_PATH = "/service"
+
+CONFIG_PATHS = {
+    "enb": f"{CONFIG_PATH}/enb.conf",
+    "drb": f"{CONFIG_PATH}/drb.conf",
+    "rr": f"{CONFIG_PATH}/rr.conf",
+    "sib": f"{CONFIG_PATH}/sib.conf",
+    "sib.mbsfn": f"{CONFIG_PATH}/sib.mbsfn.conf",
+    "ue": f"{CONFIG_PATH}/ue.conf",
+}
+
+CONFIG_ORIGIN_PATHS = {
+    "enb": f"{SRC_PATH}/srsenb/enb.conf.example",
+    "drb": f"{SRC_PATH}/srsenb/drb.conf.example",
+    "rr": f"{SRC_PATH}/srsenb/rr.conf.example",
+    "sib": f"{SRC_PATH}/srsenb/sib.conf.example",
+    "sib.mbsfn": f"{SRC_PATH}/srsenb/sib.conf.mbsfn.example",
+    "ue": f"{SRC_PATH}/srsue/ue.conf.example",
+}
+
+SRS_ENB_SERVICE = "srsenb"
+SRS_ENB_BINARY = f"{BUILD_PATH}/srsenb/src/srsenb"
+SRS_ENB_SERVICE_TEMPLATE = "./templates/srsenb.service"
+SRS_ENB_SERVICE_PATH = "/etc/systemd/system/srsenb.service"
+
+SRS_UE_SERVICE = "srsue"
+SRS_UE_BINARY = f"{BUILD_PATH}/srsue/src/srsue"
+SRS_UE_SERVICE_TEMPLATE = "./templates/srsue.service"
+SRS_UE_SERVICE_PATH = "/etc/systemd/system/srsue.service"
+
+SRS_ENB_UE_BUILD_COMMAND = (
+    f"cd {BUILD_PATH} && cmake {SRC_PATH} && make -j `nproc` srsenb srsue"
+)
+
+
+class SrsLteCharm(CharmBase):
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        super().__init__(*args)
+
+        self._stored.set_default(
+            mme_addr=None,
+            bind_addr=None,
+            ue_usim_imsi=None,
+            ue_usim_k=None,
+            ue_usim_opc=None,
+            installed=False,
+            started=False,
+            ue_attached=False,
+        )
+
+        # Basic hooks
+        self.framework.observe(self.on.install, self._on_install)
+        self.framework.observe(self.on.start, self._on_start)
+        self.framework.observe(self.on.stop, self._on_stop)
+        self.framework.observe(self.on.config_changed, self._on_config_changed)
+        self.framework.observe(self.on.update_status, self._on_update_status)
+
+        # Actions hooks
+        self.framework.observe(self.on.attach_ue_action, self._on_attach_ue_action)
+        self.framework.observe(self.on.detach_ue_action, self._on_detach_ue_action)
+        self.framework.observe(
+            self.on.remove_default_gw_action, self._on_remove_default_gw_action
+        )
+
+        # Relations hooks
+        self.framework.observe(self.on.mme_relation_changed, self._mme_relation_changed)
+
+    # Basic hooks
+    def _on_install(self, _):
+        self.unit.status = MaintenanceStatus("Installing apt packages")
+        install_apt(packages=APT_REQUIREMENTS, update=True)
+
+        self.unit.status = MaintenanceStatus("Preparing the environment")
+        self._reset_environment()
+
+        self.unit.status = MaintenanceStatus("Downloading srsLTE from Github")
+        git_clone(GIT_REPO, output_folder=SRC_PATH, branch=GIT_REPO_TAG, depth=1)
+
+        self.unit.status = MaintenanceStatus("Building srsLTE")
+        shell(SRS_ENB_UE_BUILD_COMMAND)
+
+        self.unit.status = MaintenanceStatus("Generating configuration files")
+        copy_files(origin=CONFIG_ORIGIN_PATHS, destination=CONFIG_PATHS)
+
+        self.unit.status = MaintenanceStatus("Generating systemd files")
+        self._configure_srsenb_service()
+        self._configure_srsue_service()
+
+        service_enable(SRS_ENB_SERVICE)
+        self._stored.installed = True
+
+    def _on_start(self, _):
+        self.unit.status = MaintenanceStatus("Starting srsenb")
+        service_start(SRS_ENB_SERVICE)
+        self._stored.started = True
+        self.unit.status = self._get_current_status()
+
+    def _on_stop(self, _):
+        self._reset_environment()
+        service_stop(SRS_ENB_SERVICE)
+        self._stored.started = False
+        self.unit.status = self._get_current_status()
+
+    def _on_config_changed(self, _):
+        self._stored.bind_addr = self._get_bind_address()
+        self._configure_srsenb_service()
+        # Restart the service only if it is running
+        if self._stored.started:
+            self.unit.status = MaintenanceStatus("Reloading srsenb")
+            service_restart(SRS_ENB_SERVICE)
+        self.unit.status = self._get_current_status()
+
+    def _on_update_status(self, _):
+        self.unit.status = self._get_current_status()
+
+    # Action hooks
+    def _on_attach_ue_action(self, event):
+        self._stored.ue_usim_imsi = event.params["usim-imsi"]
+        self._stored.ue_usim_k = event.params["usim-k"]
+        self._stored.ue_usim_opc = event.params["usim-opc"]
+        self._configure_srsue_service()
+        service_restart(SRS_UE_SERVICE)
+        self._stored.ue_attached = True
+        self.unit.status = self._get_current_status()
+        event.set_results({"status": "ok", "message": "Attached successfully"})
+
+    def _on_detach_ue_action(self, event):
+        self._stored.ue_usim_imsi = None
+        self._stored.ue_usim_k = None
+        self._stored.ue_usim_opc = None
+        service_stop(SRS_UE_SERVICE)
+        self._configure_srsue_service()
+        self._stored.ue_attached = False
+        self.unit.status = self._get_current_status()
+        event.set_results({"status": "ok", "message": "Detached successfully"})
+
+    def _on_remove_default_gw_action(self, event):
+        shell("route del default")
+        event.set_results({"status": "ok", "message": "Default route removed!"})
+
+    # Relation hooks
+    def _mme_relation_changed(self, event):
+        # Get mme address from relation
+        if event.unit in event.relation.data:
+            mme_addr = event.relation.data[event.unit].get("mme-addr")
+            if not is_ipv4(mme_addr):
+                return
+            self._stored.mme_addr = mme_addr
+            self._configure_srsenb_service()
+            # Restart the service only if it is running
+            if self._stored.started:
+                self.unit.status = MaintenanceStatus("Reloading srsenb")
+                service_restart(SRS_ENB_SERVICE)
+        self.unit.status = self._get_current_status()
+
+    def _configure_srsenb_service(self):
+        self._configure_service(
+            command=self._get_srsenb_command(),
+            service_template=SRS_ENB_SERVICE_TEMPLATE,
+            service_path=SRS_ENB_SERVICE_PATH,
+        )
+
+    def _configure_srsue_service(self):
+        self._configure_service(
+            command=self._get_srsue_command(),
+            service_template=SRS_UE_SERVICE_TEMPLATE,
+            service_path=SRS_UE_SERVICE_PATH,
+        )
+
+    def _configure_service(
+        self, command: str, service_template: str, service_path: str
+    ):
+        with open(service_template, "r") as template:
+            service_content = Template(template.read()).render(command=command)
+            with open(service_path, "w") as service:
+                service.write(service_content)
+            systemctl_daemon_reload()
+
+    def _get_srsenb_command(self):
+        srsenb_command = [SRS_ENB_BINARY]
+        if self._stored.mme_addr:
+            srsenb_command.append(f"--enb.mme_addr={self._stored.mme_addr}")
+        if self._stored.bind_addr:
+            srsenb_command.append(f"--enb.gtp_bind_addr={self._stored.bind_addr}")
+            srsenb_command.append(f"--enb.s1c_bind_addr={self._stored.bind_addr}")
+        srsenb_command.append(f'--enb.name={self.config.get("enb-name")}')
+        srsenb_command.append(f'--enb.mcc={self.config.get("enb-mcc")}')
+        srsenb_command.append(f'--enb.mnc={self.config.get("enb-mnc")}')
+        srsenb_command.append(f'--enb_files.rr_config={CONFIG_PATHS["rr"]}')
+        srsenb_command.append(f'--enb_files.sib_config={CONFIG_PATHS["sib"]}')
+        srsenb_command.append(f'--enb_files.drb_config={CONFIG_PATHS["drb"]}')
+        srsenb_command.append(CONFIG_PATHS["enb"])
+        srsenb_command.append(
+            f'--rf.device_name={self.config.get("enb-rf-device-name")}'
+        )
+        srsenb_command.append(
+            f'--rf.device_args={self.config.get("enb-rf-device-args")}'
+        )
+        return " ".join(srsenb_command)
+
+    def _get_srsue_command(self):
+        srsue_command = [SRS_UE_BINARY]
+        if self._stored.ue_usim_imsi:
+            srsue_command.append(f"--usim.imsi={self._stored.ue_usim_imsi}")
+            srsue_command.append(f"--usim.k={self._stored.ue_usim_k}")
+            srsue_command.append(f"--usim.opc={self._stored.ue_usim_opc}")
+        srsue_command.append(f'--usim.algo={self.config.get("ue-usim-algo")}')
+        srsue_command.append(f'--nas.apn={self.config.get("ue-nas-apn")}')
+        srsue_command.append(f'--rf.device_name={self.config.get("ue-device-name")}')
+        srsue_command.append(f'--rf.device_args={self.config.get("ue-device-args")}')
+        srsue_command.append(CONFIG_PATHS["ue"])
+        return " ".join(srsue_command)
+
+    # Private functions
+    def _reset_environment(self):
+        # Remove old folders (if they exist)
+        shutil.rmtree(SRC_PATH, ignore_errors=True)
+        shutil.rmtree(BUILD_PATH, ignore_errors=True)
+        shutil.rmtree(CONFIG_PATH, ignore_errors=True)
+        shutil.rmtree(SERVICE_PATH, ignore_errors=True)
+        # Create needed folders
+        os.mkdir(SRC_PATH)
+        os.mkdir(BUILD_PATH)
+        os.mkdir(CONFIG_PATH)
+        os.mkdir(SERVICE_PATH)
+
+    def _get_bind_address(self):
+        bind_addr = None
+        bind_address_subnet = self.model.config.get("bind-address-subnet")
+        if bind_address_subnet:
+            bind_addr = ip_from_iface(bind_address_subnet)
+        else:
+            bind_addr = ip_from_default_iface()
+        return bind_addr
+
+    def _get_current_status(self):
+        status_type = ActiveStatus
+        status_msg = ""
+        if self._stored.installed:
+            status_msg = "SW installed."
+        if self._stored.started and service_active(SRS_ENB_SERVICE):
+            status_msg = "srsenb started. "
+            if mme_addr := self._stored.mme_addr:
+                status_msg += f"mme: {mme_addr}. "
+            if self._stored.ue_attached and service_active(SRS_UE_SERVICE):
+                status_msg += "ue attached. "
+        return status_type(status_msg)
+
+
+if __name__ == "__main__":
+    main(SrsLteCharm)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/utils.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..cef5cc41e2e4c3d4f7a36db67654e9281b0929d5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/src/utils.py
@@ -0,0 +1,127 @@
+import subprocess
+import apt
+import netifaces
+import shutil
+
+from typing import Dict, List, NoReturn
+from netaddr import IPNetwork, IPAddress
+from netaddr.core import AddrFormatError
+
+
+def service_active(service_name: str):
+    result = subprocess.run(
+        ["systemctl", "is-active", service_name],
+        stdout=subprocess.PIPE,
+        encoding="utf-8",
+    )
+    return result.stdout == "active\n"
+
+
+def all_values_set(dictionary: Dict[str, str]) -> bool:
+    return not any(v is None for v in dictionary.values())
+
+
+def install_apt(packages: List, update: bool = False) -> NoReturn:
+    cache = apt.cache.Cache()
+    if update:
+        cache.update()
+    cache.open()
+    for package in packages:
+        pkg = cache[package]
+        if not pkg.is_installed:
+            pkg.mark_install()
+    cache.commit()
+
+
+def git_clone(
+    repo: str,
+    output_folder: str = None,
+    branch: str = None,
+    depth: int = None,
+):
+    command = ["git", "clone"]
+    if branch:
+        command.append(f"--branch={branch}")
+    if depth:
+        command.append(f"--depth={depth}")
+    command.append(repo)
+    if output_folder:
+        command.append(output_folder)
+    subprocess.run(command).check_returncode()
+
+
+def shell(command: str) -> NoReturn:
+    subprocess.run(command, shell=True).check_returncode()
+
+
+def copy_files(origin: Dict[str, str], destination: Dict[str, str]) -> NoReturn:
+    for config, origin_path in origin.items():
+        destination_path = destination[config]
+        shutil.copy(origin_path, destination_path)
+
+
+def get_local_ipv4_networks():
+    networks = []
+    interfaces = netifaces.interfaces()
+    for interface in interfaces:
+        addresses = netifaces.ifaddresses(interface)
+        if netifaces.AF_INET in addresses:
+            ipv4_addr = addresses[netifaces.AF_INET][0]
+            network = IPNetwork(f'{ipv4_addr["addr"]}/{ipv4_addr["netmask"]}')
+            networks.append(network)
+    return networks
+
+
+def is_ipv4(ip: str) -> bool:
+    try:
+        if not isinstance(ip, str) or len(ip.split(".")) != 4:
+            return False
+        IPAddress(ip)
+        return True
+    except AddrFormatError:
+        return False
+
+
+# Service functions
+def _systemctl(action: str, service_name: str) -> NoReturn:
+    subprocess.run(["systemctl", action, service_name]).check_returncode()
+
+
+def service_start(service_name: str) -> NoReturn:
+    _systemctl("start", service_name)
+
+
+def service_restart(service_name: str) -> NoReturn:
+    _systemctl("restart", service_name)
+
+
+def service_stop(service_name: str) -> NoReturn:
+    _systemctl("stop", service_name)
+
+
+def service_enable(service_name: str) -> NoReturn:
+    _systemctl("enable", service_name)
+
+
+def systemctl_daemon_reload():
+    subprocess.run(["systemctl", "daemon-reload"]).check_returncode()
+
+
+def ip_from_default_iface() -> str:
+    default_gateway = netifaces.gateways()["default"]
+    if netifaces.AF_INET in default_gateway:
+        _, iface = netifaces.gateways()["default"][netifaces.AF_INET]
+        default_interface = netifaces.ifaddresses(iface)
+        if netifaces.AF_INET in default_interface:
+            return netifaces.ifaddresses(iface)[netifaces.AF_INET][0].get("addr")
+
+
+def ip_from_iface(subnet: str) -> str:
+    try:
+        target_network = IPNetwork(subnet)
+        networks = get_local_ipv4_networks()
+        for network in networks:
+            if network.ip in target_network:
+                return network.ip.format()
+    except AddrFormatError:
+        return
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsenb.service b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsenb.service
new file mode 100644
index 0000000000000000000000000000000000000000..0d45a224e612a338bd06473c3e325a6520d60c9f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsenb.service
@@ -0,0 +1,13 @@
+[Unit]
+Description=Srs EnodeB Service
+After=network.target
+StartLimitIntervalSec=0
+[Service]
+Type=simple
+Restart=always
+RestartSec=1
+User=root
+ExecStart={{ command }}
+
+[Install]
+WantedBy=multi-user.target
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsue.service b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsue.service
new file mode 100644
index 0000000000000000000000000000000000000000..40fff3cfd3088063546559fd224dae505d1e501c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/templates/srsue.service
@@ -0,0 +1,16 @@
+[Unit]
+Description=Srs User Emulator Service
+After=network.target
+StartLimitIntervalSec=0
+[Service]
+Type=simple
+Restart=always
+RestartSec=1
+ExecStart={{ command }}
+User=root
+KillSignal=SIGINT
+TimeoutStopSec=10
+ExecStopPost=service srsenb restart
+
+[Install]
+WantedBy=multi-user.target
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/tests/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/tests/test_charm.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/tests/test_charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d456ec7fe3ff4b8033ad910c4aa4f4c57f8c873
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/tests/test_charm.py
@@ -0,0 +1,35 @@
+# Copyright 2020 David Garcia
+# See LICENSE file for licensing details.
+
+import unittest
+from unittest.mock import Mock
+
+from ops.testing import Harness
+from charm import SrsLteCharm
+
+
+class TestCharm(unittest.TestCase):
+    def test_config_changed(self):
+        harness = Harness(SrsLteCharm)
+        self.addCleanup(harness.cleanup)
+        harness.begin()
+        self.assertEqual(list(harness.charm._stored.things), [])
+        harness.update_config({"thing": "foo"})
+        self.assertEqual(list(harness.charm._stored.things), ["foo"])
+
+    def test_action(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        # the harness doesn't (yet!) help much with actions themselves
+        action_event = Mock(params={"fail": ""})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertTrue(action_event.set_results.called)
+
+    def test_action_fail(self):
+        harness = Harness(SrsLteCharm)
+        harness.begin()
+        action_event = Mock(params={"fail": "fail this"})
+        harness.charm._on_fortune_action(action_event)
+
+        self.assertEqual(action_event.fail.call_args, [("fail this",)])
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/LICENSE.rst b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c37cae49ec77ad6ebb25568c1605f1fee5313cfb
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2007 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..55c0f82692c5a56768a741095b7d4fb3872b4df5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/METADATA
@@ -0,0 +1,106 @@
+Metadata-Version: 2.1
+Name: Jinja2
+Version: 2.11.2
+Summary: A very fast and expressive template engine.
+Home-page: https://palletsprojects.com/p/jinja/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: Pallets
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://jinja.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/jinja
+Project-URL: Issue tracker, https://github.com/pallets/jinja/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Description-Content-Type: text/x-rst
+Requires-Dist: MarkupSafe (>=0.23)
+Provides-Extra: i18n
+Requires-Dist: Babel (>=0.8) ; extra == 'i18n'
+
+Jinja
+=====
+
+Jinja is a fast, expressive, extensible templating engine. Special
+placeholders in the template allow writing code similar to Python
+syntax. Then the template is passed data to render the final document.
+
+It includes:
+
+-   Template inheritance and inclusion.
+-   Define and import macros within templates.
+-   HTML templates can use autoescaping to prevent XSS from untrusted
+    user input.
+-   A sandboxed environment can safely render untrusted templates.
+-   AsyncIO support for generating templates and calling async
+    functions.
+-   I18N support with Babel.
+-   Templates are compiled to optimized Python code just-in-time and
+    cached, or can be compiled ahead-of-time.
+-   Exceptions point to the correct line in templates to make debugging
+    easier.
+-   Extensible filters, tests, functions, and even syntax.
+
+Jinja's philosophy is that while application logic belongs in Python if
+possible, it shouldn't make the template designer's job difficult by
+restricting functionality too much.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    $ pip install -U Jinja2
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+In A Nutshell
+-------------
+
+.. code-block:: jinja
+
+    {% extends "base.html" %}
+    {% block title %}Members{% endblock %}
+    {% block content %}
+      <ul>
+      {% for user in users %}
+        <li><a href="{{ user.url }}">{{ user.username }}</a></li>
+      {% endfor %}
+      </ul>
+    {% endblock %}
+
+
+Links
+-----
+
+-   Website: https://palletsprojects.com/p/jinja/
+-   Documentation: https://jinja.palletsprojects.com/
+-   Releases: https://pypi.org/project/Jinja2/
+-   Code: https://github.com/pallets/jinja
+-   Issue tracker: https://github.com/pallets/jinja/issues
+-   Test status: https://dev.azure.com/pallets/jinja/_build
+-   Official chat: https://discord.gg/t6rrQZH
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..d847a868bb9cf518834b80ee89044ccb29bfb8c5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/RECORD
@@ -0,0 +1,62 @@
+Jinja2-2.11.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+Jinja2-2.11.2.dist-info/LICENSE.rst,sha256=O0nc7kEF6ze6wQ-vG-JgQI_oXSUrjp3y4JefweCUQ3s,1475
+Jinja2-2.11.2.dist-info/METADATA,sha256=5ZHRZoIRAMHsJPnqhlJ622_dRPsYePYJ-9EH4-Ry7yI,3535
+Jinja2-2.11.2.dist-info/RECORD,,
+Jinja2-2.11.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+Jinja2-2.11.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+Jinja2-2.11.2.dist-info/entry_points.txt,sha256=Qy_DkVo6Xj_zzOtmErrATe8lHZhOqdjpt3e4JJAGyi8,61
+Jinja2-2.11.2.dist-info/top_level.txt,sha256=PkeVWtLb3-CqjWi1fO29OCbj55EhX_chhKrCdrVe_zs,7
+jinja2/__init__.py,sha256=0QCM_jKKDM10yzSdHRVV4mQbCbDqf0GN0GirAqibn9Y,1549
+jinja2/__pycache__/__init__.cpython-37.pyc,,
+jinja2/__pycache__/_compat.cpython-37.pyc,,
+jinja2/__pycache__/_identifier.cpython-37.pyc,,
+jinja2/__pycache__/asyncfilters.cpython-37.pyc,,
+jinja2/__pycache__/asyncsupport.cpython-37.pyc,,
+jinja2/__pycache__/bccache.cpython-37.pyc,,
+jinja2/__pycache__/compiler.cpython-37.pyc,,
+jinja2/__pycache__/constants.cpython-37.pyc,,
+jinja2/__pycache__/debug.cpython-37.pyc,,
+jinja2/__pycache__/defaults.cpython-37.pyc,,
+jinja2/__pycache__/environment.cpython-37.pyc,,
+jinja2/__pycache__/exceptions.cpython-37.pyc,,
+jinja2/__pycache__/ext.cpython-37.pyc,,
+jinja2/__pycache__/filters.cpython-37.pyc,,
+jinja2/__pycache__/idtracking.cpython-37.pyc,,
+jinja2/__pycache__/lexer.cpython-37.pyc,,
+jinja2/__pycache__/loaders.cpython-37.pyc,,
+jinja2/__pycache__/meta.cpython-37.pyc,,
+jinja2/__pycache__/nativetypes.cpython-37.pyc,,
+jinja2/__pycache__/nodes.cpython-37.pyc,,
+jinja2/__pycache__/optimizer.cpython-37.pyc,,
+jinja2/__pycache__/parser.cpython-37.pyc,,
+jinja2/__pycache__/runtime.cpython-37.pyc,,
+jinja2/__pycache__/sandbox.cpython-37.pyc,,
+jinja2/__pycache__/tests.cpython-37.pyc,,
+jinja2/__pycache__/utils.cpython-37.pyc,,
+jinja2/__pycache__/visitor.cpython-37.pyc,,
+jinja2/_compat.py,sha256=B6Se8HjnXVpzz9-vfHejn-DV2NjaVK-Iewupc5kKlu8,3191
+jinja2/_identifier.py,sha256=EdgGJKi7O1yvr4yFlvqPNEqV6M1qHyQr8Gt8GmVTKVM,1775
+jinja2/asyncfilters.py,sha256=XJtYXTxFvcJ5xwk6SaDL4S0oNnT0wPYvXBCSzc482fI,4250
+jinja2/asyncsupport.py,sha256=ZBFsDLuq3Gtji3Ia87lcyuDbqaHZJRdtShZcqwpFnSQ,7209
+jinja2/bccache.py,sha256=3Pmp4jo65M9FQuIxdxoDBbEDFwe4acDMQf77nEJfrHA,12139
+jinja2/compiler.py,sha256=Ta9W1Lit542wItAHXlDcg0sEOsFDMirCdlFPHAurg4o,66284
+jinja2/constants.py,sha256=RR1sTzNzUmKco6aZicw4JpQpJGCuPuqm1h1YmCNUEFY,1458
+jinja2/debug.py,sha256=neR7GIGGjZH3_ILJGVUYy3eLQCCaWJMXOb7o0kGInWc,8529
+jinja2/defaults.py,sha256=85B6YUUCyWPSdrSeVhcqFVuu_bHUAQXeey--FIwSeVQ,1126
+jinja2/environment.py,sha256=XDSLKc4SqNLMOwTSq3TbWEyA5WyXfuLuVD0wAVjEFwM,50629
+jinja2/exceptions.py,sha256=VjNLawcmf2ODffqVMCQK1cRmvFaUfQWF4u8ouP3QPcE,5425
+jinja2/ext.py,sha256=AtwL5O5enT_L3HR9-oBvhGyUTdGoyaqG_ICtnR_EVd4,26441
+jinja2/filters.py,sha256=_RpPgAlgIj7ExvyDzcHAC3B36cocfWK-1TEketbNeM0,41415
+jinja2/idtracking.py,sha256=J3O4VHsrbf3wzwiBc7Cro26kHb6_5kbULeIOzocchIU,9211
+jinja2/lexer.py,sha256=nUFLRKhhKmmEWkLI65nQePgcQs7qsRdjVYZETMt_v0g,30331
+jinja2/loaders.py,sha256=C-fST_dmFjgWkp0ZuCkrgICAoOsoSIF28wfAFink0oU,17666
+jinja2/meta.py,sha256=QjyYhfNRD3QCXjBJpiPl9KgkEkGXJbAkCUq4-Ur10EQ,4131
+jinja2/nativetypes.py,sha256=Ul__gtVw4xH-0qvUvnCNHedQeNDwmEuyLJztzzSPeRg,2753
+jinja2/nodes.py,sha256=Mk1oJPVgIjnQw9WOqILvcu3rLepcFZ0ahxQm2mbwDwc,31095
+jinja2/optimizer.py,sha256=gQLlMYzvQhluhzmAIFA1tXS0cwgWYOjprN-gTRcHVsc,1457
+jinja2/parser.py,sha256=fcfdqePNTNyvosIvczbytVA332qpsURvYnCGcjDHSkA,35660
+jinja2/runtime.py,sha256=0y-BRyIEZ9ltByL2Id6GpHe1oDRQAwNeQvI0SKobNMw,30618
+jinja2/sandbox.py,sha256=knayyUvXsZ-F0mk15mO2-ehK9gsw04UhB8td-iUOtLc,17127
+jinja2/tests.py,sha256=iO_Y-9Vo60zrVe1lMpSl5sKHqAxe2leZHC08OoZ8K24,4799
+jinja2/utils.py,sha256=OoVMlQe9S2-lWT6jJbTu9tDuDvGNyWUhHDcE51i5_Do,22522
+jinja2/visitor.py,sha256=DUHupl0a4PGp7nxRtZFttUzAi1ccxzqc2hzetPYUz8U,3240
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/REQUESTED b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/entry_points.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3619483fd4fca7407f3bd462aefcd70d1de69737
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[babel.extractors]
+jinja2 = jinja2.ext:babel_extract [i18n]
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7f7afbf3bf54b346092be6a72070fcbd305ead1e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/Jinja2-2.11.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+jinja2
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..9d227a0cc43c3268d15722b763bd94ad298645a1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt
@@ -0,0 +1,28 @@
+Copyright 2010 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b208d936fe8302367ad469a3eb470a52c86b45bf
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/METADATA
@@ -0,0 +1,103 @@
+Metadata-Version: 2.1
+Name: MarkupSafe
+Version: 1.1.1
+Summary: Safely add untrusted strings to HTML/XML markup.
+Home-page: https://palletsprojects.com/p/markupsafe/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: The Pallets Team
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://markupsafe.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/markupsafe
+Project-URL: Issue tracker, https://github.com/pallets/markupsafe/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
+
+MarkupSafe
+==========
+
+MarkupSafe implements a text object that escapes characters so it is
+safe to use in HTML and XML. Characters that have special meanings are
+replaced so that they display as the actual characters. This mitigates
+injection attacks, meaning untrusted user input can safely be displayed
+on a page.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    pip install -U MarkupSafe
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+Examples
+--------
+
+.. code-block:: pycon
+
+    >>> from markupsafe import Markup, escape
+    >>> # escape replaces special characters and wraps in Markup
+    >>> escape('<script>alert(document.cookie);</script>')
+    Markup(u'&lt;script&gt;alert(document.cookie);&lt;/script&gt;')
+    >>> # wrap in Markup to mark text "safe" and prevent escaping
+    >>> Markup('<strong>Hello</strong>')
+    Markup('<strong>hello</strong>')
+    >>> escape(Markup('<strong>Hello</strong>'))
+    Markup('<strong>hello</strong>')
+    >>> # Markup is a text subclass (str on Python 3, unicode on Python 2)
+    >>> # methods and operators escape their arguments
+    >>> template = Markup("Hello <em>%s</em>")
+    >>> template % '"World"'
+    Markup('Hello <em>&#34;World&#34;</em>')
+
+
+Donate
+------
+
+The Pallets organization develops and supports MarkupSafe and other
+libraries that use it. In order to grow the community of contributors
+and users, and allow the maintainers to devote more time to the
+projects, `please donate today`_.
+
+.. _please donate today: https://palletsprojects.com/donate
+
+
+Links
+-----
+
+*   Website: https://palletsprojects.com/p/markupsafe/
+*   Documentation: https://markupsafe.palletsprojects.com/
+*   License: `BSD-3-Clause <https://github.com/pallets/markupsafe/blob/master/LICENSE.rst>`_
+*   Releases: https://pypi.org/project/MarkupSafe/
+*   Code: https://github.com/pallets/markupsafe
+*   Issue tracker: https://github.com/pallets/markupsafe/issues
+*   Test status:
+
+    *   Linux, Mac: https://travis-ci.org/pallets/markupsafe
+    *   Windows: https://ci.appveyor.com/project/pallets/markupsafe
+
+*   Test coverage: https://codecov.io/gh/pallets/markupsafe
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..207f391891c36380ed4fbcaac9e99df50878251f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/RECORD
@@ -0,0 +1,16 @@
+MarkupSafe-1.1.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+MarkupSafe-1.1.1.dist-info/LICENSE.txt,sha256=SJqOEQhQntmKN7uYPhHg9-HTHwvY-Zp5yESOf_N9B-o,1475
+MarkupSafe-1.1.1.dist-info/METADATA,sha256=nJHwJ4_4ka-V39QH883jPrslj6inNdyyNASBXbYgHXQ,3570
+MarkupSafe-1.1.1.dist-info/RECORD,,
+MarkupSafe-1.1.1.dist-info/WHEEL,sha256=AhV6RMqZ2IDfreRJKo44QWYxYeP-0Jr0bezzBLQ1eog,109
+MarkupSafe-1.1.1.dist-info/top_level.txt,sha256=qy0Plje5IJuvsCBjejJyhDCjEAdcDLK_2agVcex8Z6U,11
+markupsafe/__init__.py,sha256=oTblO5f9KFM-pvnq9bB0HgElnqkJyqHnFN1Nx2NIvnY,10126
+markupsafe/__pycache__/__init__.cpython-37.pyc,,
+markupsafe/__pycache__/_compat.cpython-37.pyc,,
+markupsafe/__pycache__/_constants.cpython-37.pyc,,
+markupsafe/__pycache__/_native.cpython-37.pyc,,
+markupsafe/_compat.py,sha256=uEW1ybxEjfxIiuTbRRaJpHsPFf4yQUMMKaPgYEC5XbU,558
+markupsafe/_constants.py,sha256=zo2ajfScG-l1Sb_52EP3MlDCqO7Y1BVHUXXKRsVDRNk,4690
+markupsafe/_native.py,sha256=d-8S_zzYt2y512xYcuSxq0NeG2DUUvG80wVdTn-4KI8,1873
+markupsafe/_speedups.c,sha256=k0fzEIK3CP6MmMqeY0ob43TP90mVN0DTyn7BAl3RqSg,9884
+markupsafe/_speedups.cpython-37m-x86_64-linux-gnu.so,sha256=pz-ucGdAq6kJtq9lEY1kY2Ed6LQjbRrIicdu_i4HFqU,38875
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..697e4324518901b69631cacf7491e74949229a9d
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.31.1)
+Root-Is-Purelib: false
+Tag: cp37-cp37m-manylinux1_x86_64
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..75bf729258f9daef77370b6df1a57940f90fc23f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/MarkupSafe-1.1.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+markupsafe
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/LICENSE b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..3d82c281ee8ceb45368153139f5935bd8d39c816
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2017-2020 Ingy döt Net
+Copyright (c) 2006-2016 Kirill Simonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a70dd202d485af74ab22294dfbc7710364d0b127
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/METADATA
@@ -0,0 +1,41 @@
+Metadata-Version: 2.1
+Name: PyYAML
+Version: 5.3.1
+Summary: YAML parser and emitter for Python
+Home-page: https://github.com/yaml/pyyaml
+Author: Kirill Simonov
+Author-email: xi@resolvent.net
+License: MIT
+Download-URL: https://pypi.org/project/PyYAML/
+Platform: Any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+
+YAML is a data serialization format designed for human readability
+and interaction with scripting languages.  PyYAML is a YAML parser
+and emitter for Python.
+
+PyYAML features a complete YAML 1.1 parser, Unicode support, pickle
+support, capable extension API, and sensible error messages.  PyYAML
+supports standard YAML tags and provides Python-specific tags that
+allow to represent an arbitrary Python object.
+
+PyYAML is applicable for a broad range of tasks from complex
+configuration files to object serialization and persistence.
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..11ec570e9fe4a3620364035701d5950f51abcdeb
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/RECORD
@@ -0,0 +1,40 @@
+PyYAML-5.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+PyYAML-5.3.1.dist-info/LICENSE,sha256=xAESRJ8lS5dTBFklJIMT6ScO-jbSJrItgtTMbEPFfyk,1101
+PyYAML-5.3.1.dist-info/METADATA,sha256=xTsZFjd8T4M-5rC2M3BHgx_KTTpEPy5vFDIXrbzRXPQ,1758
+PyYAML-5.3.1.dist-info/RECORD,,
+PyYAML-5.3.1.dist-info/WHEEL,sha256=rjs0dbLt66v8mjOfCbR-uj5Usgl2OLAlmRdCEyNo0L4,104
+PyYAML-5.3.1.dist-info/top_level.txt,sha256=rpj0IVMTisAjh_1vG3Ccf9v5jpCQwAz6cD1IVU5ZdhQ,11
+yaml/__init__.py,sha256=XFUNbKTg4afAd0BETjGQ1mKQ97_g5jbE1C0WoKc74dc,13170
+yaml/__pycache__/__init__.cpython-37.pyc,,
+yaml/__pycache__/composer.cpython-37.pyc,,
+yaml/__pycache__/constructor.cpython-37.pyc,,
+yaml/__pycache__/cyaml.cpython-37.pyc,,
+yaml/__pycache__/dumper.cpython-37.pyc,,
+yaml/__pycache__/emitter.cpython-37.pyc,,
+yaml/__pycache__/error.cpython-37.pyc,,
+yaml/__pycache__/events.cpython-37.pyc,,
+yaml/__pycache__/loader.cpython-37.pyc,,
+yaml/__pycache__/nodes.cpython-37.pyc,,
+yaml/__pycache__/parser.cpython-37.pyc,,
+yaml/__pycache__/reader.cpython-37.pyc,,
+yaml/__pycache__/representer.cpython-37.pyc,,
+yaml/__pycache__/resolver.cpython-37.pyc,,
+yaml/__pycache__/scanner.cpython-37.pyc,,
+yaml/__pycache__/serializer.cpython-37.pyc,,
+yaml/__pycache__/tokens.cpython-37.pyc,,
+yaml/composer.py,sha256=_Ko30Wr6eDWUeUpauUGT3Lcg9QPBnOPVlTnIMRGJ9FM,4883
+yaml/constructor.py,sha256=O3Uaf0_J_5GQBoeI9ZNhpJAhtdagr_X2HzDgGbZOMnw,28627
+yaml/cyaml.py,sha256=LiMkvchNonfoy1F6ec9L2BiUz3r0bwF4hympASJX1Ic,3846
+yaml/dumper.py,sha256=PLctZlYwZLp7XmeUdwRuv4nYOZ2UBnDIUy8-lKfLF-o,2837
+yaml/emitter.py,sha256=jghtaU7eFwg31bG0B7RZea_29Adi9CKmXq_QjgQpCkQ,43006
+yaml/error.py,sha256=Ah9z-toHJUbE9j-M8YpxgSRM5CgLCcwVzJgLLRF2Fxo,2533
+yaml/events.py,sha256=50_TksgQiE4up-lKo_V-nBy-tAIxkIPQxY5qDhKCeHw,2445
+yaml/loader.py,sha256=UVa-zIqmkFSCIYq_PgSGm4NSJttHY2Rf_zQ4_b1fHN0,2061
+yaml/nodes.py,sha256=gPKNj8pKCdh2d4gr3gIYINnPOaOxGhJAUiYhGRnPE84,1440
+yaml/parser.py,sha256=ilWp5vvgoHFGzvOZDItFoGjD6D42nhlZrZyjAwa0oJo,25495
+yaml/reader.py,sha256=0dmzirOiDG4Xo41RnuQS7K9rkY3xjHiVasfDMNTqCNw,6794
+yaml/representer.py,sha256=82UM3ZxUQKqsKAF4ltWOxCS6jGPIFtXpGs7mvqyv4Xs,14184
+yaml/resolver.py,sha256=DJCjpQr8YQCEYYjKEYqTl0GrsZil2H4aFOI9b0Oe-U4,8970
+yaml/scanner.py,sha256=KeQIKGNlSyPE8QDwionHxy9CgbqE5teJEz05FR9-nAg,51277
+yaml/serializer.py,sha256=ChuFgmhU01hj4xgI8GaKv6vfM2Bujwa9i7d2FAHj7cA,4165
+yaml/tokens.py,sha256=lTQIzSVw8Mg9wv459-TjiOQe6wVziqaRlqX2_89rp54,2573
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..aa5b41c9bcfd55ac012ff014dff384b052ae4e80
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: false
+Tag: cp37-cp37m-linux_x86_64
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e6475e911f628412049bc4090d86f23ac403adde
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/PyYAML-5.3.1.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_yaml
+yaml
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/bin/netaddr b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/bin/netaddr
new file mode 100755
index 0000000000000000000000000000000000000000..ab4f4d909cc17b1d27f887f7ec8cd4e7a4c6b941
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/bin/netaddr
@@ -0,0 +1,8 @@
+#!/home/mark/git/GitHub/charmed-osm/srs-enb-ue/venv/bin/python3
+# -*- coding: utf-8 -*-
+import re
+import sys
+from netaddr.cli import main
+if __name__ == '__main__':
+    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
+    sys.exit(main())
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1229ba4275a0549e01dd6e7b10e1ccf17f17389f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/__init__.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+"""Jinja is a template engine written in pure Python. It provides a
+non-XML syntax that supports inline expressions and an optional
+sandboxed environment.
+"""
+from markupsafe import escape
+from markupsafe import Markup
+
+from .bccache import BytecodeCache
+from .bccache import FileSystemBytecodeCache
+from .bccache import MemcachedBytecodeCache
+from .environment import Environment
+from .environment import Template
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateError
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .filters import contextfilter
+from .filters import environmentfilter
+from .filters import evalcontextfilter
+from .loaders import BaseLoader
+from .loaders import ChoiceLoader
+from .loaders import DictLoader
+from .loaders import FileSystemLoader
+from .loaders import FunctionLoader
+from .loaders import ModuleLoader
+from .loaders import PackageLoader
+from .loaders import PrefixLoader
+from .runtime import ChainableUndefined
+from .runtime import DebugUndefined
+from .runtime import make_logging_undefined
+from .runtime import StrictUndefined
+from .runtime import Undefined
+from .utils import clear_caches
+from .utils import contextfunction
+from .utils import environmentfunction
+from .utils import evalcontextfunction
+from .utils import is_undefined
+from .utils import select_autoescape
+
+__version__ = "2.11.2"
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_compat.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f044954a02933bcec2277fcdd575821bc18a99a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_compat.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+# flake8: noqa
+import marshal
+import sys
+
+PY2 = sys.version_info[0] == 2
+PYPY = hasattr(sys, "pypy_translation_info")
+_identity = lambda x: x
+
+if not PY2:
+    unichr = chr
+    range_type = range
+    text_type = str
+    string_types = (str,)
+    integer_types = (int,)
+
+    iterkeys = lambda d: iter(d.keys())
+    itervalues = lambda d: iter(d.values())
+    iteritems = lambda d: iter(d.items())
+
+    import pickle
+    from io import BytesIO, StringIO
+
+    NativeStringIO = StringIO
+
+    def reraise(tp, value, tb=None):
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+
+    ifilter = filter
+    imap = map
+    izip = zip
+    intern = sys.intern
+
+    implements_iterator = _identity
+    implements_to_string = _identity
+    encode_filename = _identity
+
+    marshal_dump = marshal.dump
+    marshal_load = marshal.load
+
+else:
+    unichr = unichr
+    text_type = unicode
+    range_type = xrange
+    string_types = (str, unicode)
+    integer_types = (int, long)
+
+    iterkeys = lambda d: d.iterkeys()
+    itervalues = lambda d: d.itervalues()
+    iteritems = lambda d: d.iteritems()
+
+    import cPickle as pickle
+    from cStringIO import StringIO as BytesIO, StringIO
+
+    NativeStringIO = BytesIO
+
+    exec("def reraise(tp, value, tb=None):\n raise tp, value, tb")
+
+    from itertools import imap, izip, ifilter
+
+    intern = intern
+
+    def implements_iterator(cls):
+        cls.next = cls.__next__
+        del cls.__next__
+        return cls
+
+    def implements_to_string(cls):
+        cls.__unicode__ = cls.__str__
+        cls.__str__ = lambda x: x.__unicode__().encode("utf-8")
+        return cls
+
+    def encode_filename(filename):
+        if isinstance(filename, unicode):
+            return filename.encode("utf-8")
+        return filename
+
+    def marshal_dump(code, f):
+        if isinstance(f, file):
+            marshal.dump(code, f)
+        else:
+            f.write(marshal.dumps(code))
+
+    def marshal_load(f):
+        if isinstance(f, file):
+            return marshal.load(f)
+        return marshal.loads(f.read())
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a
+    # dummy metaclass for one level of class instantiation that replaces
+    # itself with the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+try:
+    from urllib.parse import quote_from_bytes as url_quote
+except ImportError:
+    from urllib import quote as url_quote
+
+
+try:
+    from collections import abc
+except ImportError:
+    import collections as abc
+
+
+try:
+    from os import fspath
+except ImportError:
+    try:
+        from pathlib import PurePath
+    except ImportError:
+        PurePath = None
+
+    def fspath(path):
+        if hasattr(path, "__fspath__"):
+            return path.__fspath__()
+
+        # Python 3.5 doesn't have __fspath__ yet, use str.
+        if PurePath is not None and isinstance(path, PurePath):
+            return str(path)
+
+        return path
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_identifier.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_identifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..224d5449d138e75f4f3c25d70cb8f1ea54ccd047
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/_identifier.py
@@ -0,0 +1,6 @@
+import re
+
+# generated by scripts/generate_identifier_pattern.py
+pattern = re.compile(
+    r"[\w·̀-ͯ·҃-֑҇-ׇֽֿׁׂׅׄؐ-ًؚ-ٰٟۖ-ۜ۟-۪ۤۧۨ-ܑۭܰ-݊ަ-ް߫-߳ࠖ-࠙ࠛ-ࠣࠥ-ࠧࠩ-࡙࠭-࡛ࣔ-ࣣ࣡-ःऺ-़ा-ॏ॑-ॗॢॣঁ-ঃ়া-ৄেৈো-্ৗৢৣਁ-ਃ਼ਾ-ੂੇੈੋ-੍ੑੰੱੵઁ-ઃ઼ા-ૅે-ૉો-્ૢૣଁ-ଃ଼ା-ୄେୈୋ-୍ୖୗୢୣஂா-ூெ-ைொ-்ௗఀ-ఃా-ౄె-ైొ-్ౕౖౢౣಁ-ಃ಼ಾ-ೄೆ-ೈೊ-್ೕೖೢೣഁ-ഃാ-ൄെ-ൈൊ-്ൗൢൣංඃ්ා-ුූෘ-ෟෲෳัิ-ฺ็-๎ັິ-ູົຼ່-ໍ༹༘༙༵༷༾༿ཱ-྄྆྇ྍ-ྗྙ-ྼ࿆ါ-ှၖ-ၙၞ-ၠၢ-ၤၧ-ၭၱ-ၴႂ-ႍႏႚ-ႝ፝-፟ᜒ-᜔ᜲ-᜴ᝒᝓᝲᝳ឴-៓៝᠋-᠍ᢅᢆᢩᤠ-ᤫᤰ-᤻ᨗ-ᨛᩕ-ᩞ᩠-᩿᩼᪰-᪽ᬀ-ᬄ᬴-᭄᭫-᭳ᮀ-ᮂᮡ-ᮭ᯦-᯳ᰤ-᰷᳐-᳔᳒-᳨᳭ᳲ-᳴᳸᳹᷀-᷵᷻-᷿‿⁀⁔⃐-⃥⃜⃡-⃰℘℮⳯-⵿⳱ⷠ-〪ⷿ-゙゚〯꙯ꙴ-꙽ꚞꚟ꛰꛱ꠂ꠆ꠋꠣ-ꠧꢀꢁꢴ-ꣅ꣠-꣱ꤦ-꤭ꥇ-꥓ꦀ-ꦃ꦳-꧀ꧥꨩ-ꨶꩃꩌꩍꩻ-ꩽꪰꪲ-ꪴꪷꪸꪾ꪿꫁ꫫ-ꫯꫵ꫶ꯣ-ꯪ꯬꯭ﬞ︀-️︠-︯︳︴﹍-﹏＿𐇽𐋠𐍶-𐍺𐨁-𐨃𐨅𐨆𐨌-𐨏𐨸-𐨿𐨺𐫦𐫥𑀀-𑀂𑀸-𑁆𑁿-𑂂𑂰-𑂺𑄀-𑄂𑄧-𑅳𑄴𑆀-𑆂𑆳-𑇊𑇀-𑇌𑈬-𑈷𑈾𑋟-𑋪𑌀-𑌃𑌼𑌾-𑍄𑍇𑍈𑍋-𑍍𑍗𑍢𑍣𑍦-𑍬𑍰-𑍴𑐵-𑑆𑒰-𑓃𑖯-𑖵𑖸-𑗀𑗜𑗝𑘰-𑙀𑚫-𑚷𑜝-𑜫𑰯-𑰶𑰸-𑰿𑲒-𑲧𑲩-𑲶𖫰-𖫴𖬰-𖬶𖽑-𖽾𖾏-𖾒𛲝𛲞𝅥-𝅩𝅭-𝅲𝅻-𝆂𝆅-𝆋𝆪-𝆭𝉂-𝉄𝨀-𝨶𝨻-𝩬𝩵𝪄𝪛-𝪟𝪡-𝪯𞀀-𞀆𞀈-𞀘𞀛-𞀡𞀣𞀤𞀦-𞣐𞀪-𞣖𞥄-𞥊󠄀-󠇯]+"  # noqa: B950
+)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncfilters.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncfilters.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d98dbcc00de104a584b0707df8f0d4e8bbe1376
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncfilters.py
@@ -0,0 +1,158 @@
+from functools import wraps
+
+from . import filters
+from .asyncsupport import auto_aiter
+from .asyncsupport import auto_await
+
+
+async def auto_to_seq(value):
+    seq = []
+    if hasattr(value, "__aiter__"):
+        async for item in value:
+            seq.append(item)
+    else:
+        for item in value:
+            seq.append(item)
+    return seq
+
+
+async def async_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = filters.prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        async for item in auto_aiter(seq):
+            if func(item):
+                yield item
+
+
+def dualfilter(normal_filter, async_filter):
+    wrap_evalctx = False
+    if getattr(normal_filter, "environmentfilter", False) is True:
+
+        def is_async(args):
+            return args[0].is_async
+
+        wrap_evalctx = False
+    else:
+        has_evalctxfilter = getattr(normal_filter, "evalcontextfilter", False) is True
+        has_ctxfilter = getattr(normal_filter, "contextfilter", False) is True
+        wrap_evalctx = not has_evalctxfilter and not has_ctxfilter
+
+        def is_async(args):
+            return args[0].environment.is_async
+
+    @wraps(normal_filter)
+    def wrapper(*args, **kwargs):
+        b = is_async(args)
+        if wrap_evalctx:
+            args = args[1:]
+        if b:
+            return async_filter(*args, **kwargs)
+        return normal_filter(*args, **kwargs)
+
+    if wrap_evalctx:
+        wrapper.evalcontextfilter = True
+
+    wrapper.asyncfiltervariant = True
+
+    return wrapper
+
+
+def asyncfiltervariant(original):
+    def decorator(f):
+        return dualfilter(original, f)
+
+    return decorator
+
+
+@asyncfiltervariant(filters.do_first)
+async def do_first(environment, seq):
+    try:
+        return await auto_aiter(seq).__anext__()
+    except StopAsyncIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@asyncfiltervariant(filters.do_groupby)
+async def do_groupby(environment, value, attribute):
+    expr = filters.make_attrgetter(environment, attribute)
+    return [
+        filters._GroupTuple(key, await auto_to_seq(values))
+        for key, values in filters.groupby(
+            sorted(await auto_to_seq(value), key=expr), expr
+        )
+    ]
+
+
+@asyncfiltervariant(filters.do_join)
+async def do_join(eval_ctx, value, d=u"", attribute=None):
+    return filters.do_join(eval_ctx, await auto_to_seq(value), d, attribute)
+
+
+@asyncfiltervariant(filters.do_list)
+async def do_list(value):
+    return await auto_to_seq(value)
+
+
+@asyncfiltervariant(filters.do_reject)
+async def do_reject(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@asyncfiltervariant(filters.do_rejectattr)
+async def do_rejectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@asyncfiltervariant(filters.do_select)
+async def do_select(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@asyncfiltervariant(filters.do_selectattr)
+async def do_selectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@asyncfiltervariant(filters.do_map)
+async def do_map(*args, **kwargs):
+    seq, func = filters.prepare_map(args, kwargs)
+    if seq:
+        async for item in auto_aiter(seq):
+            yield await auto_await(func(item))
+
+
+@asyncfiltervariant(filters.do_sum)
+async def do_sum(environment, iterable, attribute=None, start=0):
+    rv = start
+    if attribute is not None:
+        func = filters.make_attrgetter(environment, attribute)
+    else:
+
+        def func(x):
+            return x
+
+    async for item in auto_aiter(iterable):
+        rv += func(item)
+    return rv
+
+
+@asyncfiltervariant(filters.do_slice)
+async def do_slice(value, slices, fill_with=None):
+    return filters.do_slice(await auto_to_seq(value), slices, fill_with)
+
+
+ASYNC_FILTERS = {
+    "first": do_first,
+    "groupby": do_groupby,
+    "join": do_join,
+    "list": do_list,
+    # we intentionally do not support do_last because that would be
+    # ridiculous
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "map": do_map,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "sum": do_sum,
+    "slice": do_slice,
+}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncsupport.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncsupport.py
new file mode 100644
index 0000000000000000000000000000000000000000..78ba3739d8dee1e644f96e32f833279d941c3f65
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/asyncsupport.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""The code for async support. Importing this patches Jinja on supported
+Python versions.
+"""
+import asyncio
+import inspect
+from functools import update_wrapper
+
+from markupsafe import Markup
+
+from .environment import TemplateModule
+from .runtime import LoopContext
+from .utils import concat
+from .utils import internalcode
+from .utils import missing
+
+
+async def concat_async(async_gen):
+    rv = []
+
+    async def collect():
+        async for event in async_gen:
+            rv.append(event)
+
+    await collect()
+    return concat(rv)
+
+
+async def generate_async(self, *args, **kwargs):
+    vars = dict(*args, **kwargs)
+    try:
+        async for event in self.root_render_func(self.new_context(vars)):
+            yield event
+    except Exception:
+        yield self.environment.handle_exception()
+
+
+def wrap_generate_func(original_generate):
+    def _convert_generator(self, loop, args, kwargs):
+        async_gen = self.generate_async(*args, **kwargs)
+        try:
+            while 1:
+                yield loop.run_until_complete(async_gen.__anext__())
+        except StopAsyncIteration:
+            pass
+
+    def generate(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_generate(self, *args, **kwargs)
+        return _convert_generator(self, asyncio.get_event_loop(), args, kwargs)
+
+    return update_wrapper(generate, original_generate)
+
+
+async def render_async(self, *args, **kwargs):
+    if not self.environment.is_async:
+        raise RuntimeError("The environment was not created with async mode enabled.")
+
+    vars = dict(*args, **kwargs)
+    ctx = self.new_context(vars)
+
+    try:
+        return await concat_async(self.root_render_func(ctx))
+    except Exception:
+        return self.environment.handle_exception()
+
+
+def wrap_render_func(original_render):
+    def render(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_render(self, *args, **kwargs)
+        loop = asyncio.get_event_loop()
+        return loop.run_until_complete(self.render_async(*args, **kwargs))
+
+    return update_wrapper(render, original_render)
+
+
+def wrap_block_reference_call(original_call):
+    @internalcode
+    async def async_call(self):
+        rv = await concat_async(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def __call__(self):
+        if not self._context.environment.is_async:
+            return original_call(self)
+        return async_call(self)
+
+    return update_wrapper(__call__, original_call)
+
+
+def wrap_macro_invoke(original_invoke):
+    @internalcode
+    async def async_invoke(self, arguments, autoescape):
+        rv = await self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def _invoke(self, arguments, autoescape):
+        if not self._environment.is_async:
+            return original_invoke(self, arguments, autoescape)
+        return async_invoke(self, arguments, autoescape)
+
+    return update_wrapper(_invoke, original_invoke)
+
+
+@internalcode
+async def get_default_module_async(self):
+    if self._module is not None:
+        return self._module
+    self._module = rv = await self.make_module_async()
+    return rv
+
+
+def wrap_default_module(original_default_module):
+    @internalcode
+    def _get_default_module(self):
+        if self.environment.is_async:
+            raise RuntimeError("Template module attribute is unavailable in async mode")
+        return original_default_module(self)
+
+    return _get_default_module
+
+
+async def make_module_async(self, vars=None, shared=False, locals=None):
+    context = self.new_context(vars, shared, locals)
+    body_stream = []
+    async for item in self.root_render_func(context):
+        body_stream.append(item)
+    return TemplateModule(self, context, body_stream)
+
+
+def patch_template():
+    from . import Template
+
+    Template.generate = wrap_generate_func(Template.generate)
+    Template.generate_async = update_wrapper(generate_async, Template.generate_async)
+    Template.render_async = update_wrapper(render_async, Template.render_async)
+    Template.render = wrap_render_func(Template.render)
+    Template._get_default_module = wrap_default_module(Template._get_default_module)
+    Template._get_default_module_async = get_default_module_async
+    Template.make_module_async = update_wrapper(
+        make_module_async, Template.make_module_async
+    )
+
+
+def patch_runtime():
+    from .runtime import BlockReference, Macro
+
+    BlockReference.__call__ = wrap_block_reference_call(BlockReference.__call__)
+    Macro._invoke = wrap_macro_invoke(Macro._invoke)
+
+
+def patch_filters():
+    from .filters import FILTERS
+    from .asyncfilters import ASYNC_FILTERS
+
+    FILTERS.update(ASYNC_FILTERS)
+
+
+def patch_all():
+    patch_template()
+    patch_runtime()
+    patch_filters()
+
+
+async def auto_await(value):
+    if inspect.isawaitable(value):
+        return await value
+    return value
+
+
+async def auto_aiter(iterable):
+    if hasattr(iterable, "__aiter__"):
+        async for item in iterable:
+            yield item
+        return
+    for item in iterable:
+        yield item
+
+
+class AsyncLoopContext(LoopContext):
+    _to_iterator = staticmethod(auto_aiter)
+
+    @property
+    async def length(self):
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = [x async for x in self._iterator]
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    @property
+    async def revindex0(self):
+        return await self.length - self.index
+
+    @property
+    async def revindex(self):
+        return await self.length - self.index0
+
+    async def _peek_next(self):
+        if self._after is not missing:
+            return self._after
+
+        try:
+            self._after = await self._iterator.__anext__()
+        except StopAsyncIteration:
+            self._after = missing
+
+        return self._after
+
+    @property
+    async def last(self):
+        return await self._peek_next() is missing
+
+    @property
+    async def nextitem(self):
+        rv = await self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def __aiter__(self):
+        return self
+
+    async def __anext__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = await self._iterator.__anext__()
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+
+async def make_async_loop_context(iterable, undefined, recurse=None, depth0=0):
+    import warnings
+
+    warnings.warn(
+        "This template must be recompiled with at least Jinja 2.11, or"
+        " it will fail in 3.0.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return AsyncLoopContext(iterable, undefined, recurse, depth0)
+
+
+patch_all()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/bccache.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/bccache.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c0661030f7af4b2b186b1726341c910194b7cbd
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/bccache.py
@@ -0,0 +1,350 @@
+# -*- coding: utf-8 -*-
+"""The optional bytecode cache system. This is useful if you have very
+complex template situations and the compilation of all those templates
+slows down your application too much.
+
+Situations where this is useful are often forking web applications that
+are initialized on the first request.
+"""
+import errno
+import fnmatch
+import os
+import stat
+import sys
+import tempfile
+from hashlib import sha1
+from os import listdir
+from os import path
+
+from ._compat import BytesIO
+from ._compat import marshal_dump
+from ._compat import marshal_load
+from ._compat import pickle
+from ._compat import text_type
+from .utils import open_if_exists
+
+bc_version = 4
+# Magic bytes to identify Jinja bytecode cache files. Contains the
+# Python major and minor version to avoid loading incompatible bytecode
+# if a project upgrades its Python version.
+bc_magic = (
+    b"j2"
+    + pickle.dumps(bc_version, 2)
+    + pickle.dumps((sys.version_info[0] << 24) | sys.version_info[1], 2)
+)
+
+
+class Bucket(object):
+    """Buckets are used to store the bytecode for one template.  It's created
+    and initialized by the bytecode cache and passed to the loading functions.
+
+    The buckets get an internal checksum from the cache assigned and use this
+    to automatically reject outdated cache material.  Individual bytecode
+    cache subclasses don't have to care about cache invalidation.
+    """
+
+    def __init__(self, environment, key, checksum):
+        self.environment = environment
+        self.key = key
+        self.checksum = checksum
+        self.reset()
+
+    def reset(self):
+        """Resets the bucket (unloads the bytecode)."""
+        self.code = None
+
+    def load_bytecode(self, f):
+        """Loads bytecode from a file or file like object."""
+        # make sure the magic header is correct
+        magic = f.read(len(bc_magic))
+        if magic != bc_magic:
+            self.reset()
+            return
+        # the source code of the file changed, we need to reload
+        checksum = pickle.load(f)
+        if self.checksum != checksum:
+            self.reset()
+            return
+        # if marshal_load fails then we need to reload
+        try:
+            self.code = marshal_load(f)
+        except (EOFError, ValueError, TypeError):
+            self.reset()
+            return
+
+    def write_bytecode(self, f):
+        """Dump the bytecode into the file or file like object passed."""
+        if self.code is None:
+            raise TypeError("can't write empty bucket")
+        f.write(bc_magic)
+        pickle.dump(self.checksum, f, 2)
+        marshal_dump(self.code, f)
+
+    def bytecode_from_string(self, string):
+        """Load bytecode from a string."""
+        self.load_bytecode(BytesIO(string))
+
+    def bytecode_to_string(self):
+        """Return the bytecode as string."""
+        out = BytesIO()
+        self.write_bytecode(out)
+        return out.getvalue()
+
+
+class BytecodeCache(object):
+    """To implement your own bytecode cache you have to subclass this class
+    and override :meth:`load_bytecode` and :meth:`dump_bytecode`.  Both of
+    these methods are passed a :class:`~jinja2.bccache.Bucket`.
+
+    A very basic bytecode cache that saves the bytecode on the file system::
+
+        from os import path
+
+        class MyCache(BytecodeCache):
+
+            def __init__(self, directory):
+                self.directory = directory
+
+            def load_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                if path.exists(filename):
+                    with open(filename, 'rb') as f:
+                        bucket.load_bytecode(f)
+
+            def dump_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                with open(filename, 'wb') as f:
+                    bucket.write_bytecode(f)
+
+    A more advanced version of a filesystem based bytecode cache is part of
+    Jinja.
+    """
+
+    def load_bytecode(self, bucket):
+        """Subclasses have to override this method to load bytecode into a
+        bucket.  If they are not able to find code in the cache for the
+        bucket, it must not do anything.
+        """
+        raise NotImplementedError()
+
+    def dump_bytecode(self, bucket):
+        """Subclasses have to override this method to write the bytecode
+        from a bucket back to the cache.  If it unable to do so it must not
+        fail silently but raise an exception.
+        """
+        raise NotImplementedError()
+
+    def clear(self):
+        """Clears the cache.  This method is not used by Jinja but should be
+        implemented to allow applications to clear the bytecode cache used
+        by a particular environment.
+        """
+
+    def get_cache_key(self, name, filename=None):
+        """Returns the unique hash key for this template name."""
+        hash = sha1(name.encode("utf-8"))
+        if filename is not None:
+            filename = "|" + filename
+            if isinstance(filename, text_type):
+                filename = filename.encode("utf-8")
+            hash.update(filename)
+        return hash.hexdigest()
+
+    def get_source_checksum(self, source):
+        """Returns a checksum for the source."""
+        return sha1(source.encode("utf-8")).hexdigest()
+
+    def get_bucket(self, environment, name, filename, source):
+        """Return a cache bucket for the given template.  All arguments are
+        mandatory but filename may be `None`.
+        """
+        key = self.get_cache_key(name, filename)
+        checksum = self.get_source_checksum(source)
+        bucket = Bucket(environment, key, checksum)
+        self.load_bytecode(bucket)
+        return bucket
+
+    def set_bucket(self, bucket):
+        """Put the bucket into the cache."""
+        self.dump_bytecode(bucket)
+
+
+class FileSystemBytecodeCache(BytecodeCache):
+    """A bytecode cache that stores bytecode on the filesystem.  It accepts
+    two arguments: The directory where the cache items are stored and a
+    pattern string that is used to build the filename.
+
+    If no directory is specified a default cache directory is selected.  On
+    Windows the user's temp directory is used, on UNIX systems a directory
+    is created for the user in the system temp directory.
+
+    The pattern can be used to have multiple separate caches operate on the
+    same directory.  The default pattern is ``'__jinja2_%s.cache'``.  ``%s``
+    is replaced with the cache key.
+
+    >>> bcc = FileSystemBytecodeCache('/tmp/jinja_cache', '%s.cache')
+
+    This bytecode cache supports clearing of the cache using the clear method.
+    """
+
+    def __init__(self, directory=None, pattern="__jinja2_%s.cache"):
+        if directory is None:
+            directory = self._get_default_cache_dir()
+        self.directory = directory
+        self.pattern = pattern
+
+    def _get_default_cache_dir(self):
+        def _unsafe_dir():
+            raise RuntimeError(
+                "Cannot determine safe temp directory.  You "
+                "need to explicitly provide one."
+            )
+
+        tmpdir = tempfile.gettempdir()
+
+        # On windows the temporary directory is used specific unless
+        # explicitly forced otherwise.  We can just use that.
+        if os.name == "nt":
+            return tmpdir
+        if not hasattr(os, "getuid"):
+            _unsafe_dir()
+
+        dirname = "_jinja2-cache-%d" % os.getuid()
+        actual_dir = os.path.join(tmpdir, dirname)
+
+        try:
+            os.mkdir(actual_dir, stat.S_IRWXU)
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+        try:
+            os.chmod(actual_dir, stat.S_IRWXU)
+            actual_dir_stat = os.lstat(actual_dir)
+            if (
+                actual_dir_stat.st_uid != os.getuid()
+                or not stat.S_ISDIR(actual_dir_stat.st_mode)
+                or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+            ):
+                _unsafe_dir()
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+
+        actual_dir_stat = os.lstat(actual_dir)
+        if (
+            actual_dir_stat.st_uid != os.getuid()
+            or not stat.S_ISDIR(actual_dir_stat.st_mode)
+            or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+        ):
+            _unsafe_dir()
+
+        return actual_dir
+
+    def _get_cache_filename(self, bucket):
+        return path.join(self.directory, self.pattern % bucket.key)
+
+    def load_bytecode(self, bucket):
+        f = open_if_exists(self._get_cache_filename(bucket), "rb")
+        if f is not None:
+            try:
+                bucket.load_bytecode(f)
+            finally:
+                f.close()
+
+    def dump_bytecode(self, bucket):
+        f = open(self._get_cache_filename(bucket), "wb")
+        try:
+            bucket.write_bytecode(f)
+        finally:
+            f.close()
+
+    def clear(self):
+        # imported lazily here because google app-engine doesn't support
+        # write access on the file system and the function does not exist
+        # normally.
+        from os import remove
+
+        files = fnmatch.filter(listdir(self.directory), self.pattern % "*")
+        for filename in files:
+            try:
+                remove(path.join(self.directory, filename))
+            except OSError:
+                pass
+
+
+class MemcachedBytecodeCache(BytecodeCache):
+    """This class implements a bytecode cache that uses a memcache cache for
+    storing the information.  It does not enforce a specific memcache library
+    (tummy's memcache or cmemcache) but will accept any class that provides
+    the minimal interface required.
+
+    Libraries compatible with this class:
+
+    -   `cachelib <https://github.com/pallets/cachelib>`_
+    -   `python-memcached <https://pypi.org/project/python-memcached/>`_
+
+    (Unfortunately the django cache interface is not compatible because it
+    does not support storing binary data, only unicode.  You can however pass
+    the underlying cache client to the bytecode cache which is available
+    as `django.core.cache.cache._client`.)
+
+    The minimal interface for the client passed to the constructor is this:
+
+    .. class:: MinimalClientInterface
+
+        .. method:: set(key, value[, timeout])
+
+            Stores the bytecode in the cache.  `value` is a string and
+            `timeout` the timeout of the key.  If timeout is not provided
+            a default timeout or no timeout should be assumed, if it's
+            provided it's an integer with the number of seconds the cache
+            item should exist.
+
+        .. method:: get(key)
+
+            Returns the value for the cache key.  If the item does not
+            exist in the cache the return value must be `None`.
+
+    The other arguments to the constructor are the prefix for all keys that
+    is added before the actual cache key and the timeout for the bytecode in
+    the cache system.  We recommend a high (or no) timeout.
+
+    This bytecode cache does not support clearing of used items in the cache.
+    The clear method is a no-operation function.
+
+    .. versionadded:: 2.7
+       Added support for ignoring memcache errors through the
+       `ignore_memcache_errors` parameter.
+    """
+
+    def __init__(
+        self,
+        client,
+        prefix="jinja2/bytecode/",
+        timeout=None,
+        ignore_memcache_errors=True,
+    ):
+        self.client = client
+        self.prefix = prefix
+        self.timeout = timeout
+        self.ignore_memcache_errors = ignore_memcache_errors
+
+    def load_bytecode(self, bucket):
+        try:
+            code = self.client.get(self.prefix + bucket.key)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
+            code = None
+        if code is not None:
+            bucket.bytecode_from_string(code)
+
+    def dump_bytecode(self, bucket):
+        args = (self.prefix + bucket.key, bucket.bytecode_to_string())
+        if self.timeout is not None:
+            args += (self.timeout,)
+        try:
+            self.client.set(*args)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/compiler.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..63297b42c30f17b0c0ae08547047d070e7a53d3c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/compiler.py
@@ -0,0 +1,1843 @@
+# -*- coding: utf-8 -*-
+"""Compiles nodes from the parser into Python code."""
+from collections import namedtuple
+from functools import update_wrapper
+from itertools import chain
+from keyword import iskeyword as is_python_keyword
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import izip
+from ._compat import NativeStringIO
+from ._compat import range_type
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import TemplateAssertionError
+from .idtracking import Symbols
+from .idtracking import VAR_LOAD_ALIAS
+from .idtracking import VAR_LOAD_PARAMETER
+from .idtracking import VAR_LOAD_RESOLVE
+from .idtracking import VAR_LOAD_UNDEFINED
+from .nodes import EvalContext
+from .optimizer import Optimizer
+from .utils import concat
+from .visitor import NodeVisitor
+
+operators = {
+    "eq": "==",
+    "ne": "!=",
+    "gt": ">",
+    "gteq": ">=",
+    "lt": "<",
+    "lteq": "<=",
+    "in": "in",
+    "notin": "not in",
+}
+
+# what method to iterate over items do we want to use for dict iteration
+# in generated code?  on 2.x let's go with iteritems, on 3.x with items
+if hasattr(dict, "iteritems"):
+    dict_item_iter = "iteritems"
+else:
+    dict_item_iter = "items"
+
+code_features = ["division"]
+
+# does this python version support generator stops? (PEP 0479)
+try:
+    exec("from __future__ import generator_stop")
+    code_features.append("generator_stop")
+except SyntaxError:
+    pass
+
+# does this python version support yield from?
+try:
+    exec("def f(): yield from x()")
+except SyntaxError:
+    supports_yield_from = False
+else:
+    supports_yield_from = True
+
+
+def optimizeconst(f):
+    def new_func(self, node, frame, **kwargs):
+        # Only optimize if the frame is not volatile
+        if self.optimized and not frame.eval_ctx.volatile:
+            new_node = self.optimizer.visit(node, frame.eval_ctx)
+            if new_node != node:
+                return self.visit(new_node, frame)
+        return f(self, node, frame, **kwargs)
+
+    return update_wrapper(new_func, f)
+
+
+def generate(
+    node, environment, name, filename, stream=None, defer_init=False, optimized=True
+):
+    """Generate the python source for a node tree."""
+    if not isinstance(node, nodes.Template):
+        raise TypeError("Can't compile non template nodes")
+    generator = environment.code_generator_class(
+        environment, name, filename, stream, defer_init, optimized
+    )
+    generator.visit(node)
+    if stream is None:
+        return generator.stream.getvalue()
+
+
+def has_safe_repr(value):
+    """Does the node have a safe representation?"""
+    if value is None or value is NotImplemented or value is Ellipsis:
+        return True
+    if type(value) in (bool, int, float, complex, range_type, Markup) + string_types:
+        return True
+    if type(value) in (tuple, list, set, frozenset):
+        for item in value:
+            if not has_safe_repr(item):
+                return False
+        return True
+    elif type(value) is dict:
+        for key, value in iteritems(value):
+            if not has_safe_repr(key):
+                return False
+            if not has_safe_repr(value):
+                return False
+        return True
+    return False
+
+
+def find_undeclared(nodes, names):
+    """Check if the names passed are accessed undeclared.  The return value
+    is a set of all the undeclared names from the sequence of names found.
+    """
+    visitor = UndeclaredNameVisitor(names)
+    try:
+        for node in nodes:
+            visitor.visit(node)
+    except VisitorExit:
+        pass
+    return visitor.undeclared
+
+
+class MacroRef(object):
+    def __init__(self, node):
+        self.node = node
+        self.accesses_caller = False
+        self.accesses_kwargs = False
+        self.accesses_varargs = False
+
+
+class Frame(object):
+    """Holds compile time information for us."""
+
+    def __init__(self, eval_ctx, parent=None, level=None):
+        self.eval_ctx = eval_ctx
+        self.symbols = Symbols(parent and parent.symbols or None, level=level)
+
+        # a toplevel frame is the root + soft frames such as if conditions.
+        self.toplevel = False
+
+        # the root frame is basically just the outermost frame, so no if
+        # conditions.  This information is used to optimize inheritance
+        # situations.
+        self.rootlevel = False
+
+        # in some dynamic inheritance situations the compiler needs to add
+        # write tests around output statements.
+        self.require_output_check = parent and parent.require_output_check
+
+        # inside some tags we are using a buffer rather than yield statements.
+        # this for example affects {% filter %} or {% macro %}.  If a frame
+        # is buffered this variable points to the name of the list used as
+        # buffer.
+        self.buffer = None
+
+        # the name of the block we're in, otherwise None.
+        self.block = parent and parent.block or None
+
+        # the parent of this frame
+        self.parent = parent
+
+        if parent is not None:
+            self.buffer = parent.buffer
+
+    def copy(self):
+        """Create a copy of the current one."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.symbols = self.symbols.copy()
+        return rv
+
+    def inner(self, isolated=False):
+        """Return an inner frame."""
+        if isolated:
+            return Frame(self.eval_ctx, level=self.symbols.level + 1)
+        return Frame(self.eval_ctx, self)
+
+    def soft(self):
+        """Return a soft frame.  A soft frame may not be modified as
+        standalone thing as it shares the resources with the frame it
+        was created of, but it's not a rootlevel frame any longer.
+
+        This is only used to implement if-statements.
+        """
+        rv = self.copy()
+        rv.rootlevel = False
+        return rv
+
+    __copy__ = copy
+
+
+class VisitorExit(RuntimeError):
+    """Exception used by the `UndeclaredNameVisitor` to signal a stop."""
+
+
+class DependencyFinderVisitor(NodeVisitor):
+    """A visitor that collects filter and test calls."""
+
+    def __init__(self):
+        self.filters = set()
+        self.tests = set()
+
+    def visit_Filter(self, node):
+        self.generic_visit(node)
+        self.filters.add(node.name)
+
+    def visit_Test(self, node):
+        self.generic_visit(node)
+        self.tests.add(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting at blocks."""
+
+
+class UndeclaredNameVisitor(NodeVisitor):
+    """A visitor that checks if a name is accessed without being
+    declared.  This is different from the frame visitor as it will
+    not stop at closure frames.
+    """
+
+    def __init__(self, names):
+        self.names = set(names)
+        self.undeclared = set()
+
+    def visit_Name(self, node):
+        if node.ctx == "load" and node.name in self.names:
+            self.undeclared.add(node.name)
+            if self.undeclared == self.names:
+                raise VisitorExit()
+        else:
+            self.names.discard(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting a blocks."""
+
+
+class CompilerExit(Exception):
+    """Raised if the compiler encountered a situation where it just
+    doesn't make sense to further process the code.  Any block that
+    raises such an exception is not further processed.
+    """
+
+
+class CodeGenerator(NodeVisitor):
+    def __init__(
+        self, environment, name, filename, stream=None, defer_init=False, optimized=True
+    ):
+        if stream is None:
+            stream = NativeStringIO()
+        self.environment = environment
+        self.name = name
+        self.filename = filename
+        self.stream = stream
+        self.created_block_context = False
+        self.defer_init = defer_init
+        self.optimized = optimized
+        if optimized:
+            self.optimizer = Optimizer(environment)
+
+        # aliases for imports
+        self.import_aliases = {}
+
+        # a registry for all blocks.  Because blocks are moved out
+        # into the global python scope they are registered here
+        self.blocks = {}
+
+        # the number of extends statements so far
+        self.extends_so_far = 0
+
+        # some templates have a rootlevel extends.  In this case we
+        # can safely assume that we're a child template and do some
+        # more optimizations.
+        self.has_known_extends = False
+
+        # the current line number
+        self.code_lineno = 1
+
+        # registry of all filters and tests (global, not block local)
+        self.tests = {}
+        self.filters = {}
+
+        # the debug information
+        self.debug_info = []
+        self._write_debug_info = None
+
+        # the number of new lines before the next write()
+        self._new_lines = 0
+
+        # the line number of the last written statement
+        self._last_line = 0
+
+        # true if nothing was written so far.
+        self._first_write = True
+
+        # used by the `temporary_identifier` method to get new
+        # unique, temporary identifier
+        self._last_identifier = 0
+
+        # the current indentation
+        self._indentation = 0
+
+        # Tracks toplevel assignments
+        self._assign_stack = []
+
+        # Tracks parameter definition blocks
+        self._param_def_block = []
+
+        # Tracks the current context.
+        self._context_reference_stack = ["context"]
+
+    # -- Various compilation helpers
+
+    def fail(self, msg, lineno):
+        """Fail with a :exc:`TemplateAssertionError`."""
+        raise TemplateAssertionError(msg, lineno, self.name, self.filename)
+
+    def temporary_identifier(self):
+        """Get a new unique identifier."""
+        self._last_identifier += 1
+        return "t_%d" % self._last_identifier
+
+    def buffer(self, frame):
+        """Enable buffering for the frame from that point onwards."""
+        frame.buffer = self.temporary_identifier()
+        self.writeline("%s = []" % frame.buffer)
+
+    def return_buffer_contents(self, frame, force_unescaped=False):
+        """Return the buffer contents of the frame."""
+        if not force_unescaped:
+            if frame.eval_ctx.volatile:
+                self.writeline("if context.eval_ctx.autoescape:")
+                self.indent()
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                self.outdent()
+                self.writeline("else:")
+                self.indent()
+                self.writeline("return concat(%s)" % frame.buffer)
+                self.outdent()
+                return
+            elif frame.eval_ctx.autoescape:
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                return
+        self.writeline("return concat(%s)" % frame.buffer)
+
+    def indent(self):
+        """Indent by one."""
+        self._indentation += 1
+
+    def outdent(self, step=1):
+        """Outdent by step."""
+        self._indentation -= step
+
+    def start_write(self, frame, node=None):
+        """Yield or write into the frame buffer."""
+        if frame.buffer is None:
+            self.writeline("yield ", node)
+        else:
+            self.writeline("%s.append(" % frame.buffer, node)
+
+    def end_write(self, frame):
+        """End the writing process started by `start_write`."""
+        if frame.buffer is not None:
+            self.write(")")
+
+    def simple_write(self, s, frame, node=None):
+        """Simple shortcut for start_write + write + end_write."""
+        self.start_write(frame, node)
+        self.write(s)
+        self.end_write(frame)
+
+    def blockvisit(self, nodes, frame):
+        """Visit a list of nodes as block in a frame.  If the current frame
+        is no buffer a dummy ``if 0: yield None`` is written automatically.
+        """
+        try:
+            self.writeline("pass")
+            for node in nodes:
+                self.visit(node, frame)
+        except CompilerExit:
+            pass
+
+    def write(self, x):
+        """Write a string into the output stream."""
+        if self._new_lines:
+            if not self._first_write:
+                self.stream.write("\n" * self._new_lines)
+                self.code_lineno += self._new_lines
+                if self._write_debug_info is not None:
+                    self.debug_info.append((self._write_debug_info, self.code_lineno))
+                    self._write_debug_info = None
+            self._first_write = False
+            self.stream.write("    " * self._indentation)
+            self._new_lines = 0
+        self.stream.write(x)
+
+    def writeline(self, x, node=None, extra=0):
+        """Combination of newline and write."""
+        self.newline(node, extra)
+        self.write(x)
+
+    def newline(self, node=None, extra=0):
+        """Add one or more newlines before the next write."""
+        self._new_lines = max(self._new_lines, 1 + extra)
+        if node is not None and node.lineno != self._last_line:
+            self._write_debug_info = node.lineno
+            self._last_line = node.lineno
+
+    def signature(self, node, frame, extra_kwargs=None):
+        """Writes a function call to the stream for the current node.
+        A leading comma is added automatically.  The extra keyword
+        arguments may not include python keywords otherwise a syntax
+        error could occur.  The extra keyword arguments should be given
+        as python dict.
+        """
+        # if any of the given keyword arguments is a python keyword
+        # we have to make sure that no invalid call is created.
+        kwarg_workaround = False
+        for kwarg in chain((x.key for x in node.kwargs), extra_kwargs or ()):
+            if is_python_keyword(kwarg):
+                kwarg_workaround = True
+                break
+
+        for arg in node.args:
+            self.write(", ")
+            self.visit(arg, frame)
+
+        if not kwarg_workaround:
+            for kwarg in node.kwargs:
+                self.write(", ")
+                self.visit(kwarg, frame)
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write(", %s=%s" % (key, value))
+        if node.dyn_args:
+            self.write(", *")
+            self.visit(node.dyn_args, frame)
+
+        if kwarg_workaround:
+            if node.dyn_kwargs is not None:
+                self.write(", **dict({")
+            else:
+                self.write(", **{")
+            for kwarg in node.kwargs:
+                self.write("%r: " % kwarg.key)
+                self.visit(kwarg.value, frame)
+                self.write(", ")
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write("%r: %s, " % (key, value))
+            if node.dyn_kwargs is not None:
+                self.write("}, **")
+                self.visit(node.dyn_kwargs, frame)
+                self.write(")")
+            else:
+                self.write("}")
+
+        elif node.dyn_kwargs is not None:
+            self.write(", **")
+            self.visit(node.dyn_kwargs, frame)
+
+    def pull_dependencies(self, nodes):
+        """Pull all the dependencies."""
+        visitor = DependencyFinderVisitor()
+        for node in nodes:
+            visitor.visit(node)
+        for dependency in "filters", "tests":
+            mapping = getattr(self, dependency)
+            for name in getattr(visitor, dependency):
+                if name not in mapping:
+                    mapping[name] = self.temporary_identifier()
+                self.writeline(
+                    "%s = environment.%s[%r]" % (mapping[name], dependency, name)
+                )
+
+    def enter_frame(self, frame):
+        undefs = []
+        for target, (action, param) in iteritems(frame.symbols.loads):
+            if action == VAR_LOAD_PARAMETER:
+                pass
+            elif action == VAR_LOAD_RESOLVE:
+                self.writeline("%s = %s(%r)" % (target, self.get_resolve_func(), param))
+            elif action == VAR_LOAD_ALIAS:
+                self.writeline("%s = %s" % (target, param))
+            elif action == VAR_LOAD_UNDEFINED:
+                undefs.append(target)
+            else:
+                raise NotImplementedError("unknown load instruction")
+        if undefs:
+            self.writeline("%s = missing" % " = ".join(undefs))
+
+    def leave_frame(self, frame, with_python_scope=False):
+        if not with_python_scope:
+            undefs = []
+            for target, _ in iteritems(frame.symbols.loads):
+                undefs.append(target)
+            if undefs:
+                self.writeline("%s = missing" % " = ".join(undefs))
+
+    def func(self, name):
+        if self.environment.is_async:
+            return "async def %s" % name
+        return "def %s" % name
+
+    def macro_body(self, node, frame):
+        """Dump the function def of a macro or call block."""
+        frame = frame.inner()
+        frame.symbols.analyze_node(node)
+        macro_ref = MacroRef(node)
+
+        explicit_caller = None
+        skip_special_params = set()
+        args = []
+        for idx, arg in enumerate(node.args):
+            if arg.name == "caller":
+                explicit_caller = idx
+            if arg.name in ("kwargs", "varargs"):
+                skip_special_params.add(arg.name)
+            args.append(frame.symbols.ref(arg.name))
+
+        undeclared = find_undeclared(node.body, ("caller", "kwargs", "varargs"))
+
+        if "caller" in undeclared:
+            # In older Jinja versions there was a bug that allowed caller
+            # to retain the special behavior even if it was mentioned in
+            # the argument list.  However thankfully this was only really
+            # working if it was the last argument.  So we are explicitly
+            # checking this now and error out if it is anywhere else in
+            # the argument list.
+            if explicit_caller is not None:
+                try:
+                    node.defaults[explicit_caller - len(node.args)]
+                except IndexError:
+                    self.fail(
+                        "When defining macros or call blocks the "
+                        'special "caller" argument must be omitted '
+                        "or be given a default.",
+                        node.lineno,
+                    )
+            else:
+                args.append(frame.symbols.declare_parameter("caller"))
+            macro_ref.accesses_caller = True
+        if "kwargs" in undeclared and "kwargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("kwargs"))
+            macro_ref.accesses_kwargs = True
+        if "varargs" in undeclared and "varargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("varargs"))
+            macro_ref.accesses_varargs = True
+
+        # macros are delayed, they never require output checks
+        frame.require_output_check = False
+        frame.symbols.analyze_node(node)
+        self.writeline("%s(%s):" % (self.func("macro"), ", ".join(args)), node)
+        self.indent()
+
+        self.buffer(frame)
+        self.enter_frame(frame)
+
+        self.push_parameter_definitions(frame)
+        for idx, arg in enumerate(node.args):
+            ref = frame.symbols.ref(arg.name)
+            self.writeline("if %s is missing:" % ref)
+            self.indent()
+            try:
+                default = node.defaults[idx - len(node.args)]
+            except IndexError:
+                self.writeline(
+                    "%s = undefined(%r, name=%r)"
+                    % (ref, "parameter %r was not provided" % arg.name, arg.name)
+                )
+            else:
+                self.writeline("%s = " % ref)
+                self.visit(default, frame)
+            self.mark_parameter_stored(ref)
+            self.outdent()
+        self.pop_parameter_definitions()
+
+        self.blockvisit(node.body, frame)
+        self.return_buffer_contents(frame, force_unescaped=True)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        return frame, macro_ref
+
+    def macro_def(self, macro_ref, frame):
+        """Dump the macro definition for the def created by macro_body."""
+        arg_tuple = ", ".join(repr(x.name) for x in macro_ref.node.args)
+        name = getattr(macro_ref.node, "name", None)
+        if len(macro_ref.node.args) == 1:
+            arg_tuple += ","
+        self.write(
+            "Macro(environment, macro, %r, (%s), %r, %r, %r, "
+            "context.eval_ctx.autoescape)"
+            % (
+                name,
+                arg_tuple,
+                macro_ref.accesses_kwargs,
+                macro_ref.accesses_varargs,
+                macro_ref.accesses_caller,
+            )
+        )
+
+    def position(self, node):
+        """Return a human readable position for the node."""
+        rv = "line %d" % node.lineno
+        if self.name is not None:
+            rv += " in " + repr(self.name)
+        return rv
+
+    def dump_local_context(self, frame):
+        return "{%s}" % ", ".join(
+            "%r: %s" % (name, target)
+            for name, target in iteritems(frame.symbols.dump_stores())
+        )
+
+    def write_commons(self):
+        """Writes a common preamble that is used by root and block functions.
+        Primarily this sets up common local helpers and enforces a generator
+        through a dead branch.
+        """
+        self.writeline("resolve = context.resolve_or_missing")
+        self.writeline("undefined = environment.undefined")
+        # always use the standard Undefined class for the implicit else of
+        # conditional expressions
+        self.writeline("cond_expr_undefined = Undefined")
+        self.writeline("if 0: yield None")
+
+    def push_parameter_definitions(self, frame):
+        """Pushes all parameter targets from the given frame into a local
+        stack that permits tracking of yet to be assigned parameters.  In
+        particular this enables the optimization from `visit_Name` to skip
+        undefined expressions for parameters in macros as macros can reference
+        otherwise unbound parameters.
+        """
+        self._param_def_block.append(frame.symbols.dump_param_targets())
+
+    def pop_parameter_definitions(self):
+        """Pops the current parameter definitions set."""
+        self._param_def_block.pop()
+
+    def mark_parameter_stored(self, target):
+        """Marks a parameter in the current parameter definitions as stored.
+        This will skip the enforced undefined checks.
+        """
+        if self._param_def_block:
+            self._param_def_block[-1].discard(target)
+
+    def push_context_reference(self, target):
+        self._context_reference_stack.append(target)
+
+    def pop_context_reference(self):
+        self._context_reference_stack.pop()
+
+    def get_context_ref(self):
+        return self._context_reference_stack[-1]
+
+    def get_resolve_func(self):
+        target = self._context_reference_stack[-1]
+        if target == "context":
+            return "resolve"
+        return "%s.resolve" % target
+
+    def derive_context(self, frame):
+        return "%s.derived(%s)" % (
+            self.get_context_ref(),
+            self.dump_local_context(frame),
+        )
+
+    def parameter_is_undeclared(self, target):
+        """Checks if a given target is an undeclared parameter."""
+        if not self._param_def_block:
+            return False
+        return target in self._param_def_block[-1]
+
+    def push_assign_tracking(self):
+        """Pushes a new layer for assignment tracking."""
+        self._assign_stack.append(set())
+
+    def pop_assign_tracking(self, frame):
+        """Pops the topmost level for assignment tracking and updates the
+        context variables if necessary.
+        """
+        vars = self._assign_stack.pop()
+        if not frame.toplevel or not vars:
+            return
+        public_names = [x for x in vars if x[:1] != "_"]
+        if len(vars) == 1:
+            name = next(iter(vars))
+            ref = frame.symbols.ref(name)
+            self.writeline("context.vars[%r] = %s" % (name, ref))
+        else:
+            self.writeline("context.vars.update({")
+            for idx, name in enumerate(vars):
+                if idx:
+                    self.write(", ")
+                ref = frame.symbols.ref(name)
+                self.write("%r: %s" % (name, ref))
+            self.write("})")
+        if public_names:
+            if len(public_names) == 1:
+                self.writeline("context.exported_vars.add(%r)" % public_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.update((%s))"
+                    % ", ".join(imap(repr, public_names))
+                )
+
+    # -- Statement Visitors
+
+    def visit_Template(self, node, frame=None):
+        assert frame is None, "no root frame allowed"
+        eval_ctx = EvalContext(self.environment, self.name)
+
+        from .runtime import exported
+
+        self.writeline("from __future__ import %s" % ", ".join(code_features))
+        self.writeline("from jinja2.runtime import " + ", ".join(exported))
+
+        if self.environment.is_async:
+            self.writeline(
+                "from jinja2.asyncsupport import auto_await, "
+                "auto_aiter, AsyncLoopContext"
+            )
+
+        # if we want a deferred initialization we cannot move the
+        # environment into a local name
+        envenv = not self.defer_init and ", environment=environment" or ""
+
+        # do we have an extends tag at all?  If not, we can save some
+        # overhead by just not processing any inheritance code.
+        have_extends = node.find(nodes.Extends) is not None
+
+        # find all blocks
+        for block in node.find_all(nodes.Block):
+            if block.name in self.blocks:
+                self.fail("block %r defined twice" % block.name, block.lineno)
+            self.blocks[block.name] = block
+
+        # find all imports and import them
+        for import_ in node.find_all(nodes.ImportedName):
+            if import_.importname not in self.import_aliases:
+                imp = import_.importname
+                self.import_aliases[imp] = alias = self.temporary_identifier()
+                if "." in imp:
+                    module, obj = imp.rsplit(".", 1)
+                    self.writeline("from %s import %s as %s" % (module, obj, alias))
+                else:
+                    self.writeline("import %s as %s" % (imp, alias))
+
+        # add the load name
+        self.writeline("name = %r" % self.name)
+
+        # generate the root render function.
+        self.writeline(
+            "%s(context, missing=missing%s):" % (self.func("root"), envenv), extra=1
+        )
+        self.indent()
+        self.write_commons()
+
+        # process the root
+        frame = Frame(eval_ctx)
+        if "self" in find_undeclared(node.body, ("self",)):
+            ref = frame.symbols.declare_parameter("self")
+            self.writeline("%s = TemplateReference(context)" % ref)
+        frame.symbols.analyze_node(node)
+        frame.toplevel = frame.rootlevel = True
+        frame.require_output_check = have_extends and not self.has_known_extends
+        if have_extends:
+            self.writeline("parent_template = None")
+        self.enter_frame(frame)
+        self.pull_dependencies(node.body)
+        self.blockvisit(node.body, frame)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        # make sure that the parent root is called.
+        if have_extends:
+            if not self.has_known_extends:
+                self.indent()
+                self.writeline("if parent_template is not None:")
+            self.indent()
+            if supports_yield_from and not self.environment.is_async:
+                self.writeline("yield from parent_template.root_render_func(context)")
+            else:
+                self.writeline(
+                    "%sfor event in parent_template."
+                    "root_render_func(context):"
+                    % (self.environment.is_async and "async " or "")
+                )
+                self.indent()
+                self.writeline("yield event")
+                self.outdent()
+            self.outdent(1 + (not self.has_known_extends))
+
+        # at this point we now have the blocks collected and can visit them too.
+        for name, block in iteritems(self.blocks):
+            self.writeline(
+                "%s(context, missing=missing%s):"
+                % (self.func("block_" + name), envenv),
+                block,
+                1,
+            )
+            self.indent()
+            self.write_commons()
+            # It's important that we do not make this frame a child of the
+            # toplevel template.  This would cause a variety of
+            # interesting issues with identifier tracking.
+            block_frame = Frame(eval_ctx)
+            undeclared = find_undeclared(block.body, ("self", "super"))
+            if "self" in undeclared:
+                ref = block_frame.symbols.declare_parameter("self")
+                self.writeline("%s = TemplateReference(context)" % ref)
+            if "super" in undeclared:
+                ref = block_frame.symbols.declare_parameter("super")
+                self.writeline("%s = context.super(%r, block_%s)" % (ref, name, name))
+            block_frame.symbols.analyze_node(block)
+            block_frame.block = name
+            self.enter_frame(block_frame)
+            self.pull_dependencies(block.body)
+            self.blockvisit(block.body, block_frame)
+            self.leave_frame(block_frame, with_python_scope=True)
+            self.outdent()
+
+        self.writeline(
+            "blocks = {%s}" % ", ".join("%r: block_%s" % (x, x) for x in self.blocks),
+            extra=1,
+        )
+
+        # add a function that returns the debug info
+        self.writeline(
+            "debug_info = %r" % "&".join("%s=%s" % x for x in self.debug_info)
+        )
+
+    def visit_Block(self, node, frame):
+        """Call a block and register it for the template."""
+        level = 0
+        if frame.toplevel:
+            # if we know that we are a child template, there is no need to
+            # check if we are one
+            if self.has_known_extends:
+                return
+            if self.extends_so_far > 0:
+                self.writeline("if parent_template is None:")
+                self.indent()
+                level += 1
+
+        if node.scoped:
+            context = self.derive_context(frame)
+        else:
+            context = self.get_context_ref()
+
+        if (
+            supports_yield_from
+            and not self.environment.is_async
+            and frame.buffer is None
+        ):
+            self.writeline(
+                "yield from context.blocks[%r][0](%s)" % (node.name, context), node
+            )
+        else:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in context.blocks[%r][0](%s):" % (loop, node.name, context),
+                node,
+            )
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        self.outdent(level)
+
+    def visit_Extends(self, node, frame):
+        """Calls the extender."""
+        if not frame.toplevel:
+            self.fail("cannot use extend from a non top-level scope", node.lineno)
+
+        # if the number of extends statements in general is zero so
+        # far, we don't have to add a check if something extended
+        # the template before this one.
+        if self.extends_so_far > 0:
+
+            # if we have a known extends we just add a template runtime
+            # error into the generated code.  We could catch that at compile
+            # time too, but i welcome it not to confuse users by throwing the
+            # same error at different times just "because we can".
+            if not self.has_known_extends:
+                self.writeline("if parent_template is not None:")
+                self.indent()
+            self.writeline("raise TemplateRuntimeError(%r)" % "extended multiple times")
+
+            # if we have a known extends already we don't need that code here
+            # as we know that the template execution will end here.
+            if self.has_known_extends:
+                raise CompilerExit()
+            else:
+                self.outdent()
+
+        self.writeline("parent_template = environment.get_template(", node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        self.writeline(
+            "for name, parent_block in parent_template.blocks.%s():" % dict_item_iter
+        )
+        self.indent()
+        self.writeline("context.blocks.setdefault(name, []).append(parent_block)")
+        self.outdent()
+
+        # if this extends statement was in the root level we can take
+        # advantage of that information and simplify the generated code
+        # in the top level from this point onwards
+        if frame.rootlevel:
+            self.has_known_extends = True
+
+        # and now we have one more
+        self.extends_so_far += 1
+
+    def visit_Include(self, node, frame):
+        """Handles includes."""
+        if node.ignore_missing:
+            self.writeline("try:")
+            self.indent()
+
+        func_name = "get_or_select_template"
+        if isinstance(node.template, nodes.Const):
+            if isinstance(node.template.value, string_types):
+                func_name = "get_template"
+            elif isinstance(node.template.value, (tuple, list)):
+                func_name = "select_template"
+        elif isinstance(node.template, (nodes.Tuple, nodes.List)):
+            func_name = "select_template"
+
+        self.writeline("template = environment.%s(" % func_name, node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        if node.ignore_missing:
+            self.outdent()
+            self.writeline("except TemplateNotFound:")
+            self.indent()
+            self.writeline("pass")
+            self.outdent()
+            self.writeline("else:")
+            self.indent()
+
+        skip_event_yield = False
+        if node.with_context:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in template.root_render_func("
+                "template.new_context(context.get_all(), True, "
+                "%s)):" % (loop, self.dump_local_context(frame))
+            )
+        elif self.environment.is_async:
+            self.writeline(
+                "for event in (await "
+                "template._get_default_module_async())"
+                "._body_stream:"
+            )
+        else:
+            if supports_yield_from:
+                self.writeline("yield from template._get_default_module()._body_stream")
+                skip_event_yield = True
+            else:
+                self.writeline(
+                    "for event in template._get_default_module()._body_stream:"
+                )
+
+        if not skip_event_yield:
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        if node.ignore_missing:
+            self.outdent()
+
+    def visit_Import(self, node, frame):
+        """Visit regular imports."""
+        self.writeline("%s = " % frame.symbols.ref(node.target), node)
+        if frame.toplevel:
+            self.write("context.vars[%r] = " % node.target)
+        if self.environment.is_async:
+            self.write("await ")
+        self.write("environment.get_template(")
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+        if frame.toplevel and not node.target.startswith("_"):
+            self.writeline("context.exported_vars.discard(%r)" % node.target)
+
+    def visit_FromImport(self, node, frame):
+        """Visit named imports."""
+        self.newline(node)
+        self.write(
+            "included_template = %senvironment.get_template("
+            % (self.environment.is_async and "await " or "")
+        )
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+
+        var_names = []
+        discarded_names = []
+        for name in node.names:
+            if isinstance(name, tuple):
+                name, alias = name
+            else:
+                alias = name
+            self.writeline(
+                "%s = getattr(included_template, "
+                "%r, missing)" % (frame.symbols.ref(alias), name)
+            )
+            self.writeline("if %s is missing:" % frame.symbols.ref(alias))
+            self.indent()
+            self.writeline(
+                "%s = undefined(%r %% "
+                "included_template.__name__, "
+                "name=%r)"
+                % (
+                    frame.symbols.ref(alias),
+                    "the template %%r (imported on %s) does "
+                    "not export the requested name %s"
+                    % (self.position(node), repr(name)),
+                    name,
+                )
+            )
+            self.outdent()
+            if frame.toplevel:
+                var_names.append(alias)
+                if not alias.startswith("_"):
+                    discarded_names.append(alias)
+
+        if var_names:
+            if len(var_names) == 1:
+                name = var_names[0]
+                self.writeline(
+                    "context.vars[%r] = %s" % (name, frame.symbols.ref(name))
+                )
+            else:
+                self.writeline(
+                    "context.vars.update({%s})"
+                    % ", ".join(
+                        "%r: %s" % (name, frame.symbols.ref(name)) for name in var_names
+                    )
+                )
+        if discarded_names:
+            if len(discarded_names) == 1:
+                self.writeline("context.exported_vars.discard(%r)" % discarded_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.difference_"
+                    "update((%s))" % ", ".join(imap(repr, discarded_names))
+                )
+
+    def visit_For(self, node, frame):
+        loop_frame = frame.inner()
+        test_frame = frame.inner()
+        else_frame = frame.inner()
+
+        # try to figure out if we have an extended loop.  An extended loop
+        # is necessary if the loop is in recursive mode if the special loop
+        # variable is accessed in the body.
+        extended_loop = node.recursive or "loop" in find_undeclared(
+            node.iter_child_nodes(only=("body",)), ("loop",)
+        )
+
+        loop_ref = None
+        if extended_loop:
+            loop_ref = loop_frame.symbols.declare_parameter("loop")
+
+        loop_frame.symbols.analyze_node(node, for_branch="body")
+        if node.else_:
+            else_frame.symbols.analyze_node(node, for_branch="else")
+
+        if node.test:
+            loop_filter_func = self.temporary_identifier()
+            test_frame.symbols.analyze_node(node, for_branch="test")
+            self.writeline("%s(fiter):" % self.func(loop_filter_func), node.test)
+            self.indent()
+            self.enter_frame(test_frame)
+            self.writeline(self.environment.is_async and "async for " or "for ")
+            self.visit(node.target, loop_frame)
+            self.write(" in ")
+            self.write(self.environment.is_async and "auto_aiter(fiter)" or "fiter")
+            self.write(":")
+            self.indent()
+            self.writeline("if ", node.test)
+            self.visit(node.test, test_frame)
+            self.write(":")
+            self.indent()
+            self.writeline("yield ")
+            self.visit(node.target, loop_frame)
+            self.outdent(3)
+            self.leave_frame(test_frame, with_python_scope=True)
+
+        # if we don't have an recursive loop we have to find the shadowed
+        # variables at that point.  Because loops can be nested but the loop
+        # variable is a special one we have to enforce aliasing for it.
+        if node.recursive:
+            self.writeline(
+                "%s(reciter, loop_render_func, depth=0):" % self.func("loop"), node
+            )
+            self.indent()
+            self.buffer(loop_frame)
+
+            # Use the same buffer for the else frame
+            else_frame.buffer = loop_frame.buffer
+
+        # make sure the loop variable is a special one and raise a template
+        # assertion error if a loop tries to write to loop
+        if extended_loop:
+            self.writeline("%s = missing" % loop_ref)
+
+        for name in node.find_all(nodes.Name):
+            if name.ctx == "store" and name.name == "loop":
+                self.fail(
+                    "Can't assign to special loop variable in for-loop target",
+                    name.lineno,
+                )
+
+        if node.else_:
+            iteration_indicator = self.temporary_identifier()
+            self.writeline("%s = 1" % iteration_indicator)
+
+        self.writeline(self.environment.is_async and "async for " or "for ", node)
+        self.visit(node.target, loop_frame)
+        if extended_loop:
+            if self.environment.is_async:
+                self.write(", %s in AsyncLoopContext(" % loop_ref)
+            else:
+                self.write(", %s in LoopContext(" % loop_ref)
+        else:
+            self.write(" in ")
+
+        if node.test:
+            self.write("%s(" % loop_filter_func)
+        if node.recursive:
+            self.write("reciter")
+        else:
+            if self.environment.is_async and not extended_loop:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async and not extended_loop:
+                self.write(")")
+        if node.test:
+            self.write(")")
+
+        if node.recursive:
+            self.write(", undefined, loop_render_func, depth):")
+        else:
+            self.write(extended_loop and ", undefined):" or ":")
+
+        self.indent()
+        self.enter_frame(loop_frame)
+
+        self.blockvisit(node.body, loop_frame)
+        if node.else_:
+            self.writeline("%s = 0" % iteration_indicator)
+        self.outdent()
+        self.leave_frame(
+            loop_frame, with_python_scope=node.recursive and not node.else_
+        )
+
+        if node.else_:
+            self.writeline("if %s:" % iteration_indicator)
+            self.indent()
+            self.enter_frame(else_frame)
+            self.blockvisit(node.else_, else_frame)
+            self.leave_frame(else_frame)
+            self.outdent()
+
+        # if the node was recursive we have to return the buffer contents
+        # and start the iteration code
+        if node.recursive:
+            self.return_buffer_contents(loop_frame)
+            self.outdent()
+            self.start_write(frame, node)
+            if self.environment.is_async:
+                self.write("await ")
+            self.write("loop(")
+            if self.environment.is_async:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async:
+                self.write(")")
+            self.write(", loop)")
+            self.end_write(frame)
+
+    def visit_If(self, node, frame):
+        if_frame = frame.soft()
+        self.writeline("if ", node)
+        self.visit(node.test, if_frame)
+        self.write(":")
+        self.indent()
+        self.blockvisit(node.body, if_frame)
+        self.outdent()
+        for elif_ in node.elif_:
+            self.writeline("elif ", elif_)
+            self.visit(elif_.test, if_frame)
+            self.write(":")
+            self.indent()
+            self.blockvisit(elif_.body, if_frame)
+            self.outdent()
+        if node.else_:
+            self.writeline("else:")
+            self.indent()
+            self.blockvisit(node.else_, if_frame)
+            self.outdent()
+
+    def visit_Macro(self, node, frame):
+        macro_frame, macro_ref = self.macro_body(node, frame)
+        self.newline()
+        if frame.toplevel:
+            if not node.name.startswith("_"):
+                self.write("context.exported_vars.add(%r)" % node.name)
+            self.writeline("context.vars[%r] = " % node.name)
+        self.write("%s = " % frame.symbols.ref(node.name))
+        self.macro_def(macro_ref, macro_frame)
+
+    def visit_CallBlock(self, node, frame):
+        call_frame, macro_ref = self.macro_body(node, frame)
+        self.writeline("caller = ")
+        self.macro_def(macro_ref, call_frame)
+        self.start_write(frame, node)
+        self.visit_Call(node.call, frame, forward_caller=True)
+        self.end_write(frame)
+
+    def visit_FilterBlock(self, node, frame):
+        filter_frame = frame.inner()
+        filter_frame.symbols.analyze_node(node)
+        self.enter_frame(filter_frame)
+        self.buffer(filter_frame)
+        self.blockvisit(node.body, filter_frame)
+        self.start_write(frame, node)
+        self.visit_Filter(node.filter, filter_frame)
+        self.end_write(frame)
+        self.leave_frame(filter_frame)
+
+    def visit_With(self, node, frame):
+        with_frame = frame.inner()
+        with_frame.symbols.analyze_node(node)
+        self.enter_frame(with_frame)
+        for target, expr in izip(node.targets, node.values):
+            self.newline()
+            self.visit(target, with_frame)
+            self.write(" = ")
+            self.visit(expr, frame)
+        self.blockvisit(node.body, with_frame)
+        self.leave_frame(with_frame)
+
+    def visit_ExprStmt(self, node, frame):
+        self.newline(node)
+        self.visit(node.node, frame)
+
+    _FinalizeInfo = namedtuple("_FinalizeInfo", ("const", "src"))
+    #: The default finalize function if the environment isn't configured
+    #: with one. Or if the environment has one, this is called on that
+    #: function's output for constants.
+    _default_finalize = text_type
+    _finalize = None
+
+    def _make_finalize(self):
+        """Build the finalize function to be used on constants and at
+        runtime. Cached so it's only created once for all output nodes.
+
+        Returns a ``namedtuple`` with the following attributes:
+
+        ``const``
+            A function to finalize constant data at compile time.
+
+        ``src``
+            Source code to output around nodes to be evaluated at
+            runtime.
+        """
+        if self._finalize is not None:
+            return self._finalize
+
+        finalize = default = self._default_finalize
+        src = None
+
+        if self.environment.finalize:
+            src = "environment.finalize("
+            env_finalize = self.environment.finalize
+
+            def finalize(value):
+                return default(env_finalize(value))
+
+            if getattr(env_finalize, "contextfunction", False) is True:
+                src += "context, "
+                finalize = None  # noqa: F811
+            elif getattr(env_finalize, "evalcontextfunction", False) is True:
+                src += "context.eval_ctx, "
+                finalize = None
+            elif getattr(env_finalize, "environmentfunction", False) is True:
+                src += "environment, "
+
+                def finalize(value):
+                    return default(env_finalize(self.environment, value))
+
+        self._finalize = self._FinalizeInfo(finalize, src)
+        return self._finalize
+
+    def _output_const_repr(self, group):
+        """Given a group of constant values converted from ``Output``
+        child nodes, produce a string to write to the template module
+        source.
+        """
+        return repr(concat(group))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        """Try to optimize a child of an ``Output`` node by trying to
+        convert it to constant, finalized data at compile time.
+
+        If :exc:`Impossible` is raised, the node is not constant and
+        will be evaluated at runtime. Any other exception will also be
+        evaluated at runtime for easier debugging.
+        """
+        const = node.as_const(frame.eval_ctx)
+
+        if frame.eval_ctx.autoescape:
+            const = escape(const)
+
+        # Template data doesn't go through finalize.
+        if isinstance(node, nodes.TemplateData):
+            return text_type(const)
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        """Output extra source code before visiting a child of an
+        ``Output`` node.
+        """
+        if frame.eval_ctx.volatile:
+            self.write("(escape if context.eval_ctx.autoescape else to_string)(")
+        elif frame.eval_ctx.autoescape:
+            self.write("escape(")
+        else:
+            self.write("to_string(")
+
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        """Output extra source code after visiting a child of an
+        ``Output`` node.
+        """
+        self.write(")")
+
+        if finalize.src is not None:
+            self.write(")")
+
+    def visit_Output(self, node, frame):
+        # If an extends is active, don't render outside a block.
+        if frame.require_output_check:
+            # A top-level extends is known to exist at compile time.
+            if self.has_known_extends:
+                return
+
+            self.writeline("if parent_template is None:")
+            self.indent()
+
+        finalize = self._make_finalize()
+        body = []
+
+        # Evaluate constants at compile time if possible. Each item in
+        # body will be either a list of static data or a node to be
+        # evaluated at runtime.
+        for child in node.nodes:
+            try:
+                if not (
+                    # If the finalize function requires runtime context,
+                    # constants can't be evaluated at compile time.
+                    finalize.const
+                    # Unless it's basic template data that won't be
+                    # finalized anyway.
+                    or isinstance(child, nodes.TemplateData)
+                ):
+                    raise nodes.Impossible()
+
+                const = self._output_child_to_const(child, frame, finalize)
+            except (nodes.Impossible, Exception):
+                # The node was not constant and needs to be evaluated at
+                # runtime. Or another error was raised, which is easier
+                # to debug at runtime.
+                body.append(child)
+                continue
+
+            if body and isinstance(body[-1], list):
+                body[-1].append(const)
+            else:
+                body.append([const])
+
+        if frame.buffer is not None:
+            if len(body) == 1:
+                self.writeline("%s.append(" % frame.buffer)
+            else:
+                self.writeline("%s.extend((" % frame.buffer)
+
+            self.indent()
+
+        for item in body:
+            if isinstance(item, list):
+                # A group of constant data to join and output.
+                val = self._output_const_repr(item)
+
+                if frame.buffer is None:
+                    self.writeline("yield " + val)
+                else:
+                    self.writeline(val + ",")
+            else:
+                if frame.buffer is None:
+                    self.writeline("yield ", item)
+                else:
+                    self.newline(item)
+
+                # A node to be evaluated at runtime.
+                self._output_child_pre(item, frame, finalize)
+                self.visit(item, frame)
+                self._output_child_post(item, frame, finalize)
+
+                if frame.buffer is not None:
+                    self.write(",")
+
+        if frame.buffer is not None:
+            self.outdent()
+            self.writeline(")" if len(body) == 1 else "))")
+
+        if frame.require_output_check:
+            self.outdent()
+
+    def visit_Assign(self, node, frame):
+        self.push_assign_tracking()
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = ")
+        self.visit(node.node, frame)
+        self.pop_assign_tracking(frame)
+
+    def visit_AssignBlock(self, node, frame):
+        self.push_assign_tracking()
+        block_frame = frame.inner()
+        # This is a special case.  Since a set block always captures we
+        # will disable output checks.  This way one can use set blocks
+        # toplevel even in extended templates.
+        block_frame.require_output_check = False
+        block_frame.symbols.analyze_node(node)
+        self.enter_frame(block_frame)
+        self.buffer(block_frame)
+        self.blockvisit(node.body, block_frame)
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = (Markup if context.eval_ctx.autoescape else identity)(")
+        if node.filter is not None:
+            self.visit_Filter(node.filter, block_frame)
+        else:
+            self.write("concat(%s)" % block_frame.buffer)
+        self.write(")")
+        self.pop_assign_tracking(frame)
+        self.leave_frame(block_frame)
+
+    # -- Expression Visitors
+
+    def visit_Name(self, node, frame):
+        if node.ctx == "store" and frame.toplevel:
+            if self._assign_stack:
+                self._assign_stack[-1].add(node.name)
+        ref = frame.symbols.ref(node.name)
+
+        # If we are looking up a variable we might have to deal with the
+        # case where it's undefined.  We can skip that case if the load
+        # instruction indicates a parameter which are always defined.
+        if node.ctx == "load":
+            load = frame.symbols.find_load(ref)
+            if not (
+                load is not None
+                and load[0] == VAR_LOAD_PARAMETER
+                and not self.parameter_is_undeclared(ref)
+            ):
+                self.write(
+                    "(undefined(name=%r) if %s is missing else %s)"
+                    % (node.name, ref, ref)
+                )
+                return
+
+        self.write(ref)
+
+    def visit_NSRef(self, node, frame):
+        # NSRefs can only be used to store values; since they use the normal
+        # `foo.bar` notation they will be parsed as a normal attribute access
+        # when used anywhere but in a `set` context
+        ref = frame.symbols.ref(node.name)
+        self.writeline("if not isinstance(%s, Namespace):" % ref)
+        self.indent()
+        self.writeline(
+            "raise TemplateRuntimeError(%r)"
+            % "cannot assign attribute on non-namespace object"
+        )
+        self.outdent()
+        self.writeline("%s[%r]" % (ref, node.attr))
+
+    def visit_Const(self, node, frame):
+        val = node.as_const(frame.eval_ctx)
+        if isinstance(val, float):
+            self.write(str(val))
+        else:
+            self.write(repr(val))
+
+    def visit_TemplateData(self, node, frame):
+        try:
+            self.write(repr(node.as_const(frame.eval_ctx)))
+        except nodes.Impossible:
+            self.write(
+                "(Markup if context.eval_ctx.autoescape else identity)(%r)" % node.data
+            )
+
+    def visit_Tuple(self, node, frame):
+        self.write("(")
+        idx = -1
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write(idx == 0 and ",)" or ")")
+
+    def visit_List(self, node, frame):
+        self.write("[")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write("]")
+
+    def visit_Dict(self, node, frame):
+        self.write("{")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item.key, frame)
+            self.write(": ")
+            self.visit(item.value, frame)
+        self.write("}")
+
+    def binop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_binops
+            ):
+                self.write("environment.call_binop(context, %r, " % operator)
+                self.visit(node.left, frame)
+                self.write(", ")
+                self.visit(node.right, frame)
+            else:
+                self.write("(")
+                self.visit(node.left, frame)
+                self.write(" %s " % operator)
+                self.visit(node.right, frame)
+            self.write(")")
+
+        return visitor
+
+    def uaop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_unops
+            ):
+                self.write("environment.call_unop(context, %r, " % operator)
+                self.visit(node.node, frame)
+            else:
+                self.write("(" + operator)
+                self.visit(node.node, frame)
+            self.write(")")
+
+        return visitor
+
+    visit_Add = binop("+")
+    visit_Sub = binop("-")
+    visit_Mul = binop("*")
+    visit_Div = binop("/")
+    visit_FloorDiv = binop("//")
+    visit_Pow = binop("**")
+    visit_Mod = binop("%")
+    visit_And = binop("and", interceptable=False)
+    visit_Or = binop("or", interceptable=False)
+    visit_Pos = uaop("+")
+    visit_Neg = uaop("-")
+    visit_Not = uaop("not ", interceptable=False)
+    del binop, uaop
+
+    @optimizeconst
+    def visit_Concat(self, node, frame):
+        if frame.eval_ctx.volatile:
+            func_name = "(context.eval_ctx.volatile and markup_join or unicode_join)"
+        elif frame.eval_ctx.autoescape:
+            func_name = "markup_join"
+        else:
+            func_name = "unicode_join"
+        self.write("%s((" % func_name)
+        for arg in node.nodes:
+            self.visit(arg, frame)
+            self.write(", ")
+        self.write("))")
+
+    @optimizeconst
+    def visit_Compare(self, node, frame):
+        self.write("(")
+        self.visit(node.expr, frame)
+        for op in node.ops:
+            self.visit(op, frame)
+        self.write(")")
+
+    def visit_Operand(self, node, frame):
+        self.write(" %s " % operators[node.op])
+        self.visit(node.expr, frame)
+
+    @optimizeconst
+    def visit_Getattr(self, node, frame):
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+
+        self.write("environment.getattr(")
+        self.visit(node.node, frame)
+        self.write(", %r)" % node.attr)
+
+        if self.environment.is_async:
+            self.write("))")
+
+    @optimizeconst
+    def visit_Getitem(self, node, frame):
+        # slices bypass the environment getitem method.
+        if isinstance(node.arg, nodes.Slice):
+            self.visit(node.node, frame)
+            self.write("[")
+            self.visit(node.arg, frame)
+            self.write("]")
+        else:
+            if self.environment.is_async:
+                self.write("(await auto_await(")
+
+            self.write("environment.getitem(")
+            self.visit(node.node, frame)
+            self.write(", ")
+            self.visit(node.arg, frame)
+            self.write(")")
+
+            if self.environment.is_async:
+                self.write("))")
+
+    def visit_Slice(self, node, frame):
+        if node.start is not None:
+            self.visit(node.start, frame)
+        self.write(":")
+        if node.stop is not None:
+            self.visit(node.stop, frame)
+        if node.step is not None:
+            self.write(":")
+            self.visit(node.step, frame)
+
+    @optimizeconst
+    def visit_Filter(self, node, frame):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        self.write(self.filters[node.name] + "(")
+        func = self.environment.filters.get(node.name)
+        if func is None:
+            self.fail("no filter named %r" % node.name, node.lineno)
+        if getattr(func, "contextfilter", False) is True:
+            self.write("context, ")
+        elif getattr(func, "evalcontextfilter", False) is True:
+            self.write("context.eval_ctx, ")
+        elif getattr(func, "environmentfilter", False) is True:
+            self.write("environment, ")
+
+        # if the filter node is None we are inside a filter block
+        # and want to write to the current buffer
+        if node.node is not None:
+            self.visit(node.node, frame)
+        elif frame.eval_ctx.volatile:
+            self.write(
+                "(context.eval_ctx.autoescape and"
+                " Markup(concat(%s)) or concat(%s))" % (frame.buffer, frame.buffer)
+            )
+        elif frame.eval_ctx.autoescape:
+            self.write("Markup(concat(%s))" % frame.buffer)
+        else:
+            self.write("concat(%s)" % frame.buffer)
+        self.signature(node, frame)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    @optimizeconst
+    def visit_Test(self, node, frame):
+        self.write(self.tests[node.name] + "(")
+        if node.name not in self.environment.tests:
+            self.fail("no test named %r" % node.name, node.lineno)
+        self.visit(node.node, frame)
+        self.signature(node, frame)
+        self.write(")")
+
+    @optimizeconst
+    def visit_CondExpr(self, node, frame):
+        def write_expr2():
+            if node.expr2 is not None:
+                return self.visit(node.expr2, frame)
+            self.write(
+                "cond_expr_undefined(%r)"
+                % (
+                    "the inline if-"
+                    "expression on %s evaluated to false and "
+                    "no else section was defined." % self.position(node)
+                )
+            )
+
+        self.write("(")
+        self.visit(node.expr1, frame)
+        self.write(" if ")
+        self.visit(node.test, frame)
+        self.write(" else ")
+        write_expr2()
+        self.write(")")
+
+    @optimizeconst
+    def visit_Call(self, node, frame, forward_caller=False):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        if self.environment.sandboxed:
+            self.write("environment.call(context, ")
+        else:
+            self.write("context.call(")
+        self.visit(node.node, frame)
+        extra_kwargs = forward_caller and {"caller": "caller"} or None
+        self.signature(node, frame, extra_kwargs)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    def visit_Keyword(self, node, frame):
+        self.write(node.key + "=")
+        self.visit(node.value, frame)
+
+    # -- Unused nodes for extensions
+
+    def visit_MarkSafe(self, node, frame):
+        self.write("Markup(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_MarkSafeIfAutoescape(self, node, frame):
+        self.write("(context.eval_ctx.autoescape and Markup or identity)(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_EnvironmentAttribute(self, node, frame):
+        self.write("environment." + node.name)
+
+    def visit_ExtensionAttribute(self, node, frame):
+        self.write("environment.extensions[%r].%s" % (node.identifier, node.name))
+
+    def visit_ImportedName(self, node, frame):
+        self.write(self.import_aliases[node.importname])
+
+    def visit_InternalName(self, node, frame):
+        self.write(node.name)
+
+    def visit_ContextReference(self, node, frame):
+        self.write("context")
+
+    def visit_DerivedContextReference(self, node, frame):
+        self.write(self.derive_context(frame))
+
+    def visit_Continue(self, node, frame):
+        self.writeline("continue", node)
+
+    def visit_Break(self, node, frame):
+        self.writeline("break", node)
+
+    def visit_Scope(self, node, frame):
+        scope_frame = frame.inner()
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+
+    def visit_OverlayScope(self, node, frame):
+        ctx = self.temporary_identifier()
+        self.writeline("%s = %s" % (ctx, self.derive_context(frame)))
+        self.writeline("%s.vars = " % ctx)
+        self.visit(node.context, frame)
+        self.push_context_reference(ctx)
+
+        scope_frame = frame.inner(isolated=True)
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+        self.pop_context_reference()
+
+    def visit_EvalContextModifier(self, node, frame):
+        for keyword in node.options:
+            self.writeline("context.eval_ctx.%s = " % keyword.key)
+            self.visit(keyword.value, frame)
+            try:
+                val = keyword.value.as_const(frame.eval_ctx)
+            except nodes.Impossible:
+                frame.eval_ctx.volatile = True
+            else:
+                setattr(frame.eval_ctx, keyword.key, val)
+
+    def visit_ScopedEvalContextModifier(self, node, frame):
+        old_ctx_name = self.temporary_identifier()
+        saved_ctx = frame.eval_ctx.save()
+        self.writeline("%s = context.eval_ctx.save()" % old_ctx_name)
+        self.visit_EvalContextModifier(node, frame)
+        for child in node.body:
+            self.visit(child, frame)
+        frame.eval_ctx.revert(saved_ctx)
+        self.writeline("context.eval_ctx.revert(%s)" % old_ctx_name)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/constants.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf7f2ca721789052f1e227c5e3432e7712134c55
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/constants.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+#: list of lorem ipsum words used by the lipsum() helper function
+LOREM_IPSUM_WORDS = u"""\
+a ac accumsan ad adipiscing aenean aliquam aliquet amet ante aptent arcu at
+auctor augue bibendum blandit class commodo condimentum congue consectetuer
+consequat conubia convallis cras cubilia cum curabitur curae cursus dapibus
+diam dictum dictumst dignissim dis dolor donec dui duis egestas eget eleifend
+elementum elit enim erat eros est et etiam eu euismod facilisi facilisis fames
+faucibus felis fermentum feugiat fringilla fusce gravida habitant habitasse hac
+hendrerit hymenaeos iaculis id imperdiet in inceptos integer interdum ipsum
+justo lacinia lacus laoreet lectus leo libero ligula litora lobortis lorem
+luctus maecenas magna magnis malesuada massa mattis mauris metus mi molestie
+mollis montes morbi mus nam nascetur natoque nec neque netus nibh nisi nisl non
+nonummy nostra nulla nullam nunc odio orci ornare parturient pede pellentesque
+penatibus per pharetra phasellus placerat platea porta porttitor posuere
+potenti praesent pretium primis proin pulvinar purus quam quis quisque rhoncus
+ridiculus risus rutrum sagittis sapien scelerisque sed sem semper senectus sit
+sociis sociosqu sodales sollicitudin suscipit suspendisse taciti tellus tempor
+tempus tincidunt torquent tortor tristique turpis ullamcorper ultrices
+ultricies urna ut varius vehicula vel velit venenatis vestibulum vitae vivamus
+viverra volutpat vulputate"""
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/debug.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d8aec31d05dab0b01b192b9dfe74f2656dc3077
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/debug.py
@@ -0,0 +1,268 @@
+import sys
+from types import CodeType
+
+from . import TemplateSyntaxError
+from ._compat import PYPY
+from .utils import internal_code
+from .utils import missing
+
+
+def rewrite_traceback_stack(source=None):
+    """Rewrite the current exception to replace any tracebacks from
+    within compiled template code with tracebacks that look like they
+    came from the template source.
+
+    This must be called within an ``except`` block.
+
+    :param exc_info: A :meth:`sys.exc_info` tuple. If not provided,
+        the current ``exc_info`` is used.
+    :param source: For ``TemplateSyntaxError``, the original source if
+        known.
+    :return: A :meth:`sys.exc_info` tuple that can be re-raised.
+    """
+    exc_type, exc_value, tb = sys.exc_info()
+
+    if isinstance(exc_value, TemplateSyntaxError) and not exc_value.translated:
+        exc_value.translated = True
+        exc_value.source = source
+
+        try:
+            # Remove the old traceback on Python 3, otherwise the frames
+            # from the compiler still show up.
+            exc_value.with_traceback(None)
+        except AttributeError:
+            pass
+
+        # Outside of runtime, so the frame isn't executing template
+        # code, but it still needs to point at the template.
+        tb = fake_traceback(
+            exc_value, None, exc_value.filename or "<unknown>", exc_value.lineno
+        )
+    else:
+        # Skip the frame for the render function.
+        tb = tb.tb_next
+
+    stack = []
+
+    # Build the stack of traceback object, replacing any in template
+    # code with the source file and line information.
+    while tb is not None:
+        # Skip frames decorated with @internalcode. These are internal
+        # calls that aren't useful in template debugging output.
+        if tb.tb_frame.f_code in internal_code:
+            tb = tb.tb_next
+            continue
+
+        template = tb.tb_frame.f_globals.get("__jinja_template__")
+
+        if template is not None:
+            lineno = template.get_corresponding_lineno(tb.tb_lineno)
+            fake_tb = fake_traceback(exc_value, tb, template.filename, lineno)
+            stack.append(fake_tb)
+        else:
+            stack.append(tb)
+
+        tb = tb.tb_next
+
+    tb_next = None
+
+    # Assign tb_next in reverse to avoid circular references.
+    for tb in reversed(stack):
+        tb_next = tb_set_next(tb, tb_next)
+
+    return exc_type, exc_value, tb_next
+
+
+def fake_traceback(exc_value, tb, filename, lineno):
+    """Produce a new traceback object that looks like it came from the
+    template source instead of the compiled code. The filename, line
+    number, and location name will point to the template, and the local
+    variables will be the current template context.
+
+    :param exc_value: The original exception to be re-raised to create
+        the new traceback.
+    :param tb: The original traceback to get the local variables and
+        code info from.
+    :param filename: The template filename.
+    :param lineno: The line number in the template source.
+    """
+    if tb is not None:
+        # Replace the real locals with the context that would be
+        # available at that point in the template.
+        locals = get_template_locals(tb.tb_frame.f_locals)
+        locals.pop("__jinja_exception__", None)
+    else:
+        locals = {}
+
+    globals = {
+        "__name__": filename,
+        "__file__": filename,
+        "__jinja_exception__": exc_value,
+    }
+    # Raise an exception at the correct line number.
+    code = compile("\n" * (lineno - 1) + "raise __jinja_exception__", filename, "exec")
+
+    # Build a new code object that points to the template file and
+    # replaces the location with a block name.
+    try:
+        location = "template"
+
+        if tb is not None:
+            function = tb.tb_frame.f_code.co_name
+
+            if function == "root":
+                location = "top-level template code"
+            elif function.startswith("block_"):
+                location = 'block "%s"' % function[6:]
+
+        # Collect arguments for the new code object. CodeType only
+        # accepts positional arguments, and arguments were inserted in
+        # new Python versions.
+        code_args = []
+
+        for attr in (
+            "argcount",
+            "posonlyargcount",  # Python 3.8
+            "kwonlyargcount",  # Python 3
+            "nlocals",
+            "stacksize",
+            "flags",
+            "code",  # codestring
+            "consts",  # constants
+            "names",
+            "varnames",
+            ("filename", filename),
+            ("name", location),
+            "firstlineno",
+            "lnotab",
+            "freevars",
+            "cellvars",
+        ):
+            if isinstance(attr, tuple):
+                # Replace with given value.
+                code_args.append(attr[1])
+                continue
+
+            try:
+                # Copy original value if it exists.
+                code_args.append(getattr(code, "co_" + attr))
+            except AttributeError:
+                # Some arguments were added later.
+                continue
+
+        code = CodeType(*code_args)
+    except Exception:
+        # Some environments such as Google App Engine don't support
+        # modifying code objects.
+        pass
+
+    # Execute the new code, which is guaranteed to raise, and return
+    # the new traceback without this frame.
+    try:
+        exec(code, globals, locals)
+    except BaseException:
+        return sys.exc_info()[2].tb_next
+
+
+def get_template_locals(real_locals):
+    """Based on the runtime locals, get the context that would be
+    available at that point in the template.
+    """
+    # Start with the current template context.
+    ctx = real_locals.get("context")
+
+    if ctx:
+        data = ctx.get_all().copy()
+    else:
+        data = {}
+
+    # Might be in a derived context that only sets local variables
+    # rather than pushing a context. Local variables follow the scheme
+    # l_depth_name. Find the highest-depth local that has a value for
+    # each name.
+    local_overrides = {}
+
+    for name, value in real_locals.items():
+        if not name.startswith("l_") or value is missing:
+            # Not a template variable, or no longer relevant.
+            continue
+
+        try:
+            _, depth, name = name.split("_", 2)
+            depth = int(depth)
+        except ValueError:
+            continue
+
+        cur_depth = local_overrides.get(name, (-1,))[0]
+
+        if cur_depth < depth:
+            local_overrides[name] = (depth, value)
+
+    # Modify the context with any derived context.
+    for name, (_, value) in local_overrides.items():
+        if value is missing:
+            data.pop(name, None)
+        else:
+            data[name] = value
+
+    return data
+
+
+if sys.version_info >= (3, 7):
+    # tb_next is directly assignable as of Python 3.7
+    def tb_set_next(tb, tb_next):
+        tb.tb_next = tb_next
+        return tb
+
+
+elif PYPY:
+    # PyPy might have special support, and won't work with ctypes.
+    try:
+        import tputil
+    except ImportError:
+        # Without tproxy support, use the original traceback.
+        def tb_set_next(tb, tb_next):
+            return tb
+
+    else:
+        # With tproxy support, create a proxy around the traceback that
+        # returns the new tb_next.
+        def tb_set_next(tb, tb_next):
+            def controller(op):
+                if op.opname == "__getattribute__" and op.args[0] == "tb_next":
+                    return tb_next
+
+                return op.delegate()
+
+            return tputil.make_proxy(controller, obj=tb)
+
+
+else:
+    # Use ctypes to assign tb_next at the C level since it's read-only
+    # from Python.
+    import ctypes
+
+    class _CTraceback(ctypes.Structure):
+        _fields_ = [
+            # Extra PyObject slots when compiled with Py_TRACE_REFS.
+            ("PyObject_HEAD", ctypes.c_byte * object().__sizeof__()),
+            # Only care about tb_next as an object, not a traceback.
+            ("tb_next", ctypes.py_object),
+        ]
+
+    def tb_set_next(tb, tb_next):
+        c_tb = _CTraceback.from_address(id(tb))
+
+        # Clear out the old tb_next.
+        if tb.tb_next is not None:
+            c_tb_next = ctypes.py_object(tb.tb_next)
+            c_tb.tb_next = ctypes.py_object()
+            ctypes.pythonapi.Py_DecRef(c_tb_next)
+
+        # Assign the new tb_next.
+        if tb_next is not None:
+            c_tb_next = ctypes.py_object(tb_next)
+            ctypes.pythonapi.Py_IncRef(c_tb_next)
+            c_tb.tb_next = c_tb_next
+
+        return tb
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/defaults.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e0e7d771076a8fe0dc71584018338d2caa35fb5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/defaults.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+from ._compat import range_type
+from .filters import FILTERS as DEFAULT_FILTERS  # noqa: F401
+from .tests import TESTS as DEFAULT_TESTS  # noqa: F401
+from .utils import Cycler
+from .utils import generate_lorem_ipsum
+from .utils import Joiner
+from .utils import Namespace
+
+# defaults for the parser / lexer
+BLOCK_START_STRING = "{%"
+BLOCK_END_STRING = "%}"
+VARIABLE_START_STRING = "{{"
+VARIABLE_END_STRING = "}}"
+COMMENT_START_STRING = "{#"
+COMMENT_END_STRING = "#}"
+LINE_STATEMENT_PREFIX = None
+LINE_COMMENT_PREFIX = None
+TRIM_BLOCKS = False
+LSTRIP_BLOCKS = False
+NEWLINE_SEQUENCE = "\n"
+KEEP_TRAILING_NEWLINE = False
+
+# default filters, tests and namespace
+
+DEFAULT_NAMESPACE = {
+    "range": range_type,
+    "dict": dict,
+    "lipsum": generate_lorem_ipsum,
+    "cycler": Cycler,
+    "joiner": Joiner,
+    "namespace": Namespace,
+}
+
+# default policies
+DEFAULT_POLICIES = {
+    "compiler.ascii_str": True,
+    "urlize.rel": "noopener",
+    "urlize.target": None,
+    "truncate.leeway": 5,
+    "json.dumps_function": None,
+    "json.dumps_kwargs": {"sort_keys": True},
+    "ext.i18n.trimmed": False,
+}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/environment.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/environment.py
new file mode 100644
index 0000000000000000000000000000000000000000..8430390eeab412b7f3b92d88a4bdecbe1de5f538
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/environment.py
@@ -0,0 +1,1362 @@
+# -*- coding: utf-8 -*-
+"""Classes for managing templates and their runtime and compile time
+options.
+"""
+import os
+import sys
+import weakref
+from functools import partial
+from functools import reduce
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import encode_filename
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import PYPY
+from ._compat import reraise
+from ._compat import string_types
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import generate
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import DEFAULT_FILTERS
+from .defaults import DEFAULT_NAMESPACE
+from .defaults import DEFAULT_POLICIES
+from .defaults import DEFAULT_TESTS
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .lexer import get_lexer
+from .lexer import TokenStream
+from .nodes import EvalContext
+from .parser import Parser
+from .runtime import Context
+from .runtime import new_context
+from .runtime import Undefined
+from .utils import concat
+from .utils import consume
+from .utils import have_async_gen
+from .utils import import_string
+from .utils import internalcode
+from .utils import LRUCache
+from .utils import missing
+
+# for direct template usage we have up to ten living environments
+_spontaneous_environments = LRUCache(10)
+
+
+def get_spontaneous_environment(cls, *args):
+    """Return a new spontaneous environment. A spontaneous environment
+    is used for templates created directly rather than through an
+    existing environment.
+
+    :param cls: Environment class to create.
+    :param args: Positional arguments passed to environment.
+    """
+    key = (cls, args)
+
+    try:
+        return _spontaneous_environments[key]
+    except KeyError:
+        _spontaneous_environments[key] = env = cls(*args)
+        env.shared = True
+        return env
+
+
+def create_cache(size):
+    """Return the cache class for the given size."""
+    if size == 0:
+        return None
+    if size < 0:
+        return {}
+    return LRUCache(size)
+
+
+def copy_cache(cache):
+    """Create an empty copy of the given cache."""
+    if cache is None:
+        return None
+    elif type(cache) is dict:
+        return {}
+    return LRUCache(cache.capacity)
+
+
+def load_extensions(environment, extensions):
+    """Load the extensions from the list and bind it to the environment.
+    Returns a dict of instantiated environments.
+    """
+    result = {}
+    for extension in extensions:
+        if isinstance(extension, string_types):
+            extension = import_string(extension)
+        result[extension.identifier] = extension(environment)
+    return result
+
+
+def fail_for_missing_callable(string, name):
+    msg = string % name
+    if isinstance(name, Undefined):
+        try:
+            name._fail_with_undefined_error()
+        except Exception as e:
+            msg = "%s (%s; did you forget to quote the callable name?)" % (msg, e)
+    raise TemplateRuntimeError(msg)
+
+
+def _environment_sanity_check(environment):
+    """Perform a sanity check on the environment."""
+    assert issubclass(
+        environment.undefined, Undefined
+    ), "undefined must be a subclass of undefined because filters depend on it."
+    assert (
+        environment.block_start_string
+        != environment.variable_start_string
+        != environment.comment_start_string
+    ), "block, variable and comment start strings must be different"
+    assert environment.newline_sequence in (
+        "\r",
+        "\r\n",
+        "\n",
+    ), "newline_sequence set to unknown line ending string."
+    return environment
+
+
+class Environment(object):
+    r"""The core component of Jinja is the `Environment`.  It contains
+    important shared variables like configuration, filters, tests,
+    globals and others.  Instances of this class may be modified if
+    they are not shared and if no template was loaded so far.
+    Modifications on environments after the first template was loaded
+    will lead to surprising effects and undefined behavior.
+
+    Here are the possible initialization parameters:
+
+        `block_start_string`
+            The string marking the beginning of a block.  Defaults to ``'{%'``.
+
+        `block_end_string`
+            The string marking the end of a block.  Defaults to ``'%}'``.
+
+        `variable_start_string`
+            The string marking the beginning of a print statement.
+            Defaults to ``'{{'``.
+
+        `variable_end_string`
+            The string marking the end of a print statement.  Defaults to
+            ``'}}'``.
+
+        `comment_start_string`
+            The string marking the beginning of a comment.  Defaults to ``'{#'``.
+
+        `comment_end_string`
+            The string marking the end of a comment.  Defaults to ``'#}'``.
+
+        `line_statement_prefix`
+            If given and a string, this will be used as prefix for line based
+            statements.  See also :ref:`line-statements`.
+
+        `line_comment_prefix`
+            If given and a string, this will be used as prefix for line based
+            comments.  See also :ref:`line-statements`.
+
+            .. versionadded:: 2.2
+
+        `trim_blocks`
+            If this is set to ``True`` the first newline after a block is
+            removed (block, not variable tag!).  Defaults to `False`.
+
+        `lstrip_blocks`
+            If this is set to ``True`` leading spaces and tabs are stripped
+            from the start of a line to a block.  Defaults to `False`.
+
+        `newline_sequence`
+            The sequence that starts a newline.  Must be one of ``'\r'``,
+            ``'\n'`` or ``'\r\n'``.  The default is ``'\n'`` which is a
+            useful default for Linux and OS X systems as well as web
+            applications.
+
+        `keep_trailing_newline`
+            Preserve the trailing newline when rendering templates.
+            The default is ``False``, which causes a single newline,
+            if present, to be stripped from the end of the template.
+
+            .. versionadded:: 2.7
+
+        `extensions`
+            List of Jinja extensions to use.  This can either be import paths
+            as strings or extension classes.  For more information have a
+            look at :ref:`the extensions documentation <jinja-extensions>`.
+
+        `optimized`
+            should the optimizer be enabled?  Default is ``True``.
+
+        `undefined`
+            :class:`Undefined` or a subclass of it that is used to represent
+            undefined values in the template.
+
+        `finalize`
+            A callable that can be used to process the result of a variable
+            expression before it is output.  For example one can convert
+            ``None`` implicitly into an empty string here.
+
+        `autoescape`
+            If set to ``True`` the XML/HTML autoescaping feature is enabled by
+            default.  For more details about autoescaping see
+            :class:`~markupsafe.Markup`.  As of Jinja 2.4 this can also
+            be a callable that is passed the template name and has to
+            return ``True`` or ``False`` depending on autoescape should be
+            enabled by default.
+
+            .. versionchanged:: 2.4
+               `autoescape` can now be a function
+
+        `loader`
+            The template loader for this environment.
+
+        `cache_size`
+            The size of the cache.  Per default this is ``400`` which means
+            that if more than 400 templates are loaded the loader will clean
+            out the least recently used template.  If the cache size is set to
+            ``0`` templates are recompiled all the time, if the cache size is
+            ``-1`` the cache will not be cleaned.
+
+            .. versionchanged:: 2.8
+               The cache size was increased to 400 from a low 50.
+
+        `auto_reload`
+            Some loaders load templates from locations where the template
+            sources may change (ie: file system or database).  If
+            ``auto_reload`` is set to ``True`` (default) every time a template is
+            requested the loader checks if the source changed and if yes, it
+            will reload the template.  For higher performance it's possible to
+            disable that.
+
+        `bytecode_cache`
+            If set to a bytecode cache object, this object will provide a
+            cache for the internal Jinja bytecode so that templates don't
+            have to be parsed if they were not changed.
+
+            See :ref:`bytecode-cache` for more information.
+
+        `enable_async`
+            If set to true this enables async template execution which allows
+            you to take advantage of newer Python features.  This requires
+            Python 3.6 or later.
+    """
+
+    #: if this environment is sandboxed.  Modifying this variable won't make
+    #: the environment sandboxed though.  For a real sandboxed environment
+    #: have a look at jinja2.sandbox.  This flag alone controls the code
+    #: generation by the compiler.
+    sandboxed = False
+
+    #: True if the environment is just an overlay
+    overlayed = False
+
+    #: the environment this environment is linked to if it is an overlay
+    linked_to = None
+
+    #: shared environments have this set to `True`.  A shared environment
+    #: must not be modified
+    shared = False
+
+    #: the class that is used for code generation.  See
+    #: :class:`~jinja2.compiler.CodeGenerator` for more information.
+    code_generator_class = CodeGenerator
+
+    #: the context class thatis used for templates.  See
+    #: :class:`~jinja2.runtime.Context` for more information.
+    context_class = Context
+
+    def __init__(
+        self,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        loader=None,
+        cache_size=400,
+        auto_reload=True,
+        bytecode_cache=None,
+        enable_async=False,
+    ):
+        # !!Important notice!!
+        #   The constructor accepts quite a few arguments that should be
+        #   passed by keyword rather than position.  However it's important to
+        #   not change the order of arguments because it's used at least
+        #   internally in those cases:
+        #       -   spontaneous environments (i18n extension and Template)
+        #       -   unittests
+        #   If parameter changes are required only add parameters at the end
+        #   and don't change the arguments (or the defaults!) of the arguments
+        #   existing already.
+
+        # lexer / parser information
+        self.block_start_string = block_start_string
+        self.block_end_string = block_end_string
+        self.variable_start_string = variable_start_string
+        self.variable_end_string = variable_end_string
+        self.comment_start_string = comment_start_string
+        self.comment_end_string = comment_end_string
+        self.line_statement_prefix = line_statement_prefix
+        self.line_comment_prefix = line_comment_prefix
+        self.trim_blocks = trim_blocks
+        self.lstrip_blocks = lstrip_blocks
+        self.newline_sequence = newline_sequence
+        self.keep_trailing_newline = keep_trailing_newline
+
+        # runtime information
+        self.undefined = undefined
+        self.optimized = optimized
+        self.finalize = finalize
+        self.autoescape = autoescape
+
+        # defaults
+        self.filters = DEFAULT_FILTERS.copy()
+        self.tests = DEFAULT_TESTS.copy()
+        self.globals = DEFAULT_NAMESPACE.copy()
+
+        # set the loader provided
+        self.loader = loader
+        self.cache = create_cache(cache_size)
+        self.bytecode_cache = bytecode_cache
+        self.auto_reload = auto_reload
+
+        # configurable policies
+        self.policies = DEFAULT_POLICIES.copy()
+
+        # load extensions
+        self.extensions = load_extensions(self, extensions)
+
+        self.enable_async = enable_async
+        self.is_async = self.enable_async and have_async_gen
+        if self.is_async:
+            # runs patch_all() to enable async support
+            from . import asyncsupport  # noqa: F401
+
+        _environment_sanity_check(self)
+
+    def add_extension(self, extension):
+        """Adds an extension after the environment was created.
+
+        .. versionadded:: 2.5
+        """
+        self.extensions.update(load_extensions(self, [extension]))
+
+    def extend(self, **attributes):
+        """Add the items to the instance of the environment if they do not exist
+        yet.  This is used by :ref:`extensions <writing-extensions>` to register
+        callbacks and configuration values without breaking inheritance.
+        """
+        for key, value in iteritems(attributes):
+            if not hasattr(self, key):
+                setattr(self, key, value)
+
+    def overlay(
+        self,
+        block_start_string=missing,
+        block_end_string=missing,
+        variable_start_string=missing,
+        variable_end_string=missing,
+        comment_start_string=missing,
+        comment_end_string=missing,
+        line_statement_prefix=missing,
+        line_comment_prefix=missing,
+        trim_blocks=missing,
+        lstrip_blocks=missing,
+        extensions=missing,
+        optimized=missing,
+        undefined=missing,
+        finalize=missing,
+        autoescape=missing,
+        loader=missing,
+        cache_size=missing,
+        auto_reload=missing,
+        bytecode_cache=missing,
+    ):
+        """Create a new overlay environment that shares all the data with the
+        current environment except for cache and the overridden attributes.
+        Extensions cannot be removed for an overlayed environment.  An overlayed
+        environment automatically gets all the extensions of the environment it
+        is linked to plus optional extra extensions.
+
+        Creating overlays should happen after the initial environment was set
+        up completely.  Not all attributes are truly linked, some are just
+        copied over so modifications on the original environment may not shine
+        through.
+        """
+        args = dict(locals())
+        del args["self"], args["cache_size"], args["extensions"]
+
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.overlayed = True
+        rv.linked_to = self
+
+        for key, value in iteritems(args):
+            if value is not missing:
+                setattr(rv, key, value)
+
+        if cache_size is not missing:
+            rv.cache = create_cache(cache_size)
+        else:
+            rv.cache = copy_cache(self.cache)
+
+        rv.extensions = {}
+        for key, value in iteritems(self.extensions):
+            rv.extensions[key] = value.bind(rv)
+        if extensions is not missing:
+            rv.extensions.update(load_extensions(rv, extensions))
+
+        return _environment_sanity_check(rv)
+
+    lexer = property(get_lexer, doc="The lexer for this environment.")
+
+    def iter_extensions(self):
+        """Iterates over the extensions by priority."""
+        return iter(sorted(self.extensions.values(), key=lambda x: x.priority))
+
+    def getitem(self, obj, argument):
+        """Get an item or attribute of an object but prefer the item."""
+        try:
+            return obj[argument]
+        except (AttributeError, TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        return getattr(obj, attr)
+                    except AttributeError:
+                        pass
+            return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Get an item or attribute of an object but prefer the attribute.
+        Unlike :meth:`getitem` the attribute *must* be a bytestring.
+        """
+        try:
+            return getattr(obj, attribute)
+        except AttributeError:
+            pass
+        try:
+            return obj[attribute]
+        except (TypeError, LookupError, AttributeError):
+            return self.undefined(obj=obj, name=attribute)
+
+    def call_filter(
+        self, name, value, args=None, kwargs=None, context=None, eval_ctx=None
+    ):
+        """Invokes a filter on a value the same way the compiler does it.
+
+        Note that on Python 3 this might return a coroutine in case the
+        filter is running from an environment in async mode and the filter
+        supports async execution.  It's your responsibility to await this
+        if needed.
+
+        .. versionadded:: 2.7
+        """
+        func = self.filters.get(name)
+        if func is None:
+            fail_for_missing_callable("no filter named %r", name)
+        args = [value] + list(args or ())
+        if getattr(func, "contextfilter", False) is True:
+            if context is None:
+                raise TemplateRuntimeError(
+                    "Attempted to invoke context filter without context"
+                )
+            args.insert(0, context)
+        elif getattr(func, "evalcontextfilter", False) is True:
+            if eval_ctx is None:
+                if context is not None:
+                    eval_ctx = context.eval_ctx
+                else:
+                    eval_ctx = EvalContext(self)
+            args.insert(0, eval_ctx)
+        elif getattr(func, "environmentfilter", False) is True:
+            args.insert(0, self)
+        return func(*args, **(kwargs or {}))
+
+    def call_test(self, name, value, args=None, kwargs=None):
+        """Invokes a test on a value the same way the compiler does it.
+
+        .. versionadded:: 2.7
+        """
+        func = self.tests.get(name)
+        if func is None:
+            fail_for_missing_callable("no test named %r", name)
+        return func(value, *(args or ()), **(kwargs or {}))
+
+    @internalcode
+    def parse(self, source, name=None, filename=None):
+        """Parse the sourcecode and return the abstract syntax tree.  This
+        tree of nodes is used by the compiler to convert the template into
+        executable source- or bytecode.  This is useful for debugging or to
+        extract information from templates.
+
+        If you are :ref:`developing Jinja extensions <writing-extensions>`
+        this gives you a good overview of the node tree generated.
+        """
+        try:
+            return self._parse(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def _parse(self, source, name, filename):
+        """Internal parsing function used by `parse` and `compile`."""
+        return Parser(self, source, name, encode_filename(filename)).parse()
+
+    def lex(self, source, name=None, filename=None):
+        """Lex the given sourcecode and return a generator that yields
+        tokens as tuples in the form ``(lineno, token_type, value)``.
+        This can be useful for :ref:`extension development <writing-extensions>`
+        and debugging templates.
+
+        This does not perform preprocessing.  If you want the preprocessing
+        of the extensions to be applied you have to filter source through
+        the :meth:`preprocess` method.
+        """
+        source = text_type(source)
+        try:
+            return self.lexer.tokeniter(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def preprocess(self, source, name=None, filename=None):
+        """Preprocesses the source with all extensions.  This is automatically
+        called for all parsing and compiling methods but *not* for :meth:`lex`
+        because there you usually only want the actual source tokenized.
+        """
+        return reduce(
+            lambda s, e: e.preprocess(s, name, filename),
+            self.iter_extensions(),
+            text_type(source),
+        )
+
+    def _tokenize(self, source, name, filename=None, state=None):
+        """Called by the parser to do the preprocessing and filtering
+        for all the extensions.  Returns a :class:`~jinja2.lexer.TokenStream`.
+        """
+        source = self.preprocess(source, name, filename)
+        stream = self.lexer.tokenize(source, name, filename, state)
+        for ext in self.iter_extensions():
+            stream = ext.filter_stream(stream)
+            if not isinstance(stream, TokenStream):
+                stream = TokenStream(stream, name, filename)
+        return stream
+
+    def _generate(self, source, name, filename, defer_init=False):
+        """Internal hook that can be overridden to hook a different generate
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return generate(
+            source,
+            self,
+            name,
+            filename,
+            defer_init=defer_init,
+            optimized=self.optimized,
+        )
+
+    def _compile(self, source, filename):
+        """Internal hook that can be overridden to hook a different compile
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return compile(source, filename, "exec")
+
+    @internalcode
+    def compile(self, source, name=None, filename=None, raw=False, defer_init=False):
+        """Compile a node or template source code.  The `name` parameter is
+        the load name of the template after it was joined using
+        :meth:`join_path` if necessary, not the filename on the file system.
+        the `filename` parameter is the estimated filename of the template on
+        the file system.  If the template came from a database or memory this
+        can be omitted.
+
+        The return value of this method is a python code object.  If the `raw`
+        parameter is `True` the return value will be a string with python
+        code equivalent to the bytecode returned otherwise.  This method is
+        mainly used internally.
+
+        `defer_init` is use internally to aid the module code generator.  This
+        causes the generated code to be able to import without the global
+        environment variable to be set.
+
+        .. versionadded:: 2.4
+           `defer_init` parameter added.
+        """
+        source_hint = None
+        try:
+            if isinstance(source, string_types):
+                source_hint = source
+                source = self._parse(source, name, filename)
+            source = self._generate(source, name, filename, defer_init=defer_init)
+            if raw:
+                return source
+            if filename is None:
+                filename = "<template>"
+            else:
+                filename = encode_filename(filename)
+            return self._compile(source, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source_hint)
+
+    def compile_expression(self, source, undefined_to_none=True):
+        """A handy helper method that returns a callable that accepts keyword
+        arguments that appear as variables in the expression.  If called it
+        returns the result of the expression.
+
+        This is useful if applications want to use the same rules as Jinja
+        in template "configuration files" or similar situations.
+
+        Example usage:
+
+        >>> env = Environment()
+        >>> expr = env.compile_expression('foo == 42')
+        >>> expr(foo=23)
+        False
+        >>> expr(foo=42)
+        True
+
+        Per default the return value is converted to `None` if the
+        expression returns an undefined value.  This can be changed
+        by setting `undefined_to_none` to `False`.
+
+        >>> env.compile_expression('var')() is None
+        True
+        >>> env.compile_expression('var', undefined_to_none=False)()
+        Undefined
+
+        .. versionadded:: 2.1
+        """
+        parser = Parser(self, source, state="variable")
+        try:
+            expr = parser.parse_expression()
+            if not parser.stream.eos:
+                raise TemplateSyntaxError(
+                    "chunk after expression", parser.stream.current.lineno, None, None
+                )
+            expr.set_environment(self)
+        except TemplateSyntaxError:
+            if sys.exc_info() is not None:
+                self.handle_exception(source=source)
+
+        body = [nodes.Assign(nodes.Name("result", "store"), expr, lineno=1)]
+        template = self.from_string(nodes.Template(body, lineno=1))
+        return TemplateExpression(template, undefined_to_none)
+
+    def compile_templates(
+        self,
+        target,
+        extensions=None,
+        filter_func=None,
+        zip="deflated",
+        log_function=None,
+        ignore_errors=True,
+        py_compile=False,
+    ):
+        """Finds all the templates the loader can find, compiles them
+        and stores them in `target`.  If `zip` is `None`, instead of in a
+        zipfile, the templates will be stored in a directory.
+        By default a deflate zip algorithm is used. To switch to
+        the stored algorithm, `zip` can be set to ``'stored'``.
+
+        `extensions` and `filter_func` are passed to :meth:`list_templates`.
+        Each template returned will be compiled to the target folder or
+        zipfile.
+
+        By default template compilation errors are ignored.  In case a
+        log function is provided, errors are logged.  If you want template
+        syntax errors to abort the compilation you can set `ignore_errors`
+        to `False` and you will get an exception on syntax errors.
+
+        If `py_compile` is set to `True` .pyc files will be written to the
+        target instead of standard .py files.  This flag does not do anything
+        on pypy and Python 3 where pyc files are not picked up by itself and
+        don't give much benefit.
+
+        .. versionadded:: 2.4
+        """
+        from .loaders import ModuleLoader
+
+        if log_function is None:
+
+            def log_function(x):
+                pass
+
+        if py_compile:
+            if not PY2 or PYPY:
+                import warnings
+
+                warnings.warn(
+                    "'py_compile=True' has no effect on PyPy or Python"
+                    " 3 and will be removed in version 3.0",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                py_compile = False
+            else:
+                import imp
+                import marshal
+
+                py_header = imp.get_magic() + u"\xff\xff\xff\xff".encode("iso-8859-15")
+
+                # Python 3.3 added a source filesize to the header
+                if sys.version_info >= (3, 3):
+                    py_header += u"\x00\x00\x00\x00".encode("iso-8859-15")
+
+        def write_file(filename, data):
+            if zip:
+                info = ZipInfo(filename)
+                info.external_attr = 0o755 << 16
+                zip_file.writestr(info, data)
+            else:
+                if isinstance(data, text_type):
+                    data = data.encode("utf8")
+
+                with open(os.path.join(target, filename), "wb") as f:
+                    f.write(data)
+
+        if zip is not None:
+            from zipfile import ZipFile, ZipInfo, ZIP_DEFLATED, ZIP_STORED
+
+            zip_file = ZipFile(
+                target, "w", dict(deflated=ZIP_DEFLATED, stored=ZIP_STORED)[zip]
+            )
+            log_function('Compiling into Zip archive "%s"' % target)
+        else:
+            if not os.path.isdir(target):
+                os.makedirs(target)
+            log_function('Compiling into folder "%s"' % target)
+
+        try:
+            for name in self.list_templates(extensions, filter_func):
+                source, filename, _ = self.loader.get_source(self, name)
+                try:
+                    code = self.compile(source, name, filename, True, True)
+                except TemplateSyntaxError as e:
+                    if not ignore_errors:
+                        raise
+                    log_function('Could not compile "%s": %s' % (name, e))
+                    continue
+
+                filename = ModuleLoader.get_module_filename(name)
+
+                if py_compile:
+                    c = self._compile(code, encode_filename(filename))
+                    write_file(filename + "c", py_header + marshal.dumps(c))
+                    log_function('Byte-compiled "%s" as %s' % (name, filename + "c"))
+                else:
+                    write_file(filename, code)
+                    log_function('Compiled "%s" as %s' % (name, filename))
+        finally:
+            if zip:
+                zip_file.close()
+
+        log_function("Finished compiling templates")
+
+    def list_templates(self, extensions=None, filter_func=None):
+        """Returns a list of templates for this environment.  This requires
+        that the loader supports the loader's
+        :meth:`~BaseLoader.list_templates` method.
+
+        If there are other files in the template folder besides the
+        actual templates, the returned list can be filtered.  There are two
+        ways: either `extensions` is set to a list of file extensions for
+        templates, or a `filter_func` can be provided which is a callable that
+        is passed a template name and should return `True` if it should end up
+        in the result list.
+
+        If the loader does not support that, a :exc:`TypeError` is raised.
+
+        .. versionadded:: 2.4
+        """
+        names = self.loader.list_templates()
+
+        if extensions is not None:
+            if filter_func is not None:
+                raise TypeError(
+                    "either extensions or filter_func can be passed, but not both"
+                )
+
+            def filter_func(x):
+                return "." in x and x.rsplit(".", 1)[1] in extensions
+
+        if filter_func is not None:
+            names = [name for name in names if filter_func(name)]
+
+        return names
+
+    def handle_exception(self, source=None):
+        """Exception handling helper.  This is used internally to either raise
+        rewritten exceptions or return a rendered traceback for the template.
+        """
+        from .debug import rewrite_traceback_stack
+
+        reraise(*rewrite_traceback_stack(source=source))
+
+    def join_path(self, template, parent):
+        """Join a template with the parent.  By default all the lookups are
+        relative to the loader root so this method returns the `template`
+        parameter unchanged, but if the paths should be relative to the
+        parent template, this function can be used to calculate the real
+        template name.
+
+        Subclasses may override this method and implement template path
+        joining here.
+        """
+        return template
+
+    @internalcode
+    def _load_template(self, name, globals):
+        if self.loader is None:
+            raise TypeError("no loader for this environment specified")
+        cache_key = (weakref.ref(self.loader), name)
+        if self.cache is not None:
+            template = self.cache.get(cache_key)
+            if template is not None and (
+                not self.auto_reload or template.is_up_to_date
+            ):
+                return template
+        template = self.loader.load(self, name, globals)
+        if self.cache is not None:
+            self.cache[cache_key] = template
+        return template
+
+    @internalcode
+    def get_template(self, name, parent=None, globals=None):
+        """Load a template from the loader.  If a loader is configured this
+        method asks the loader for the template and returns a :class:`Template`.
+        If the `parent` parameter is not `None`, :meth:`join_path` is called
+        to get the real template name before loading.
+
+        The `globals` parameter can be used to provide template wide globals.
+        These variables are available in the context at render time.
+
+        If the template does not exist a :exc:`TemplateNotFound` exception is
+        raised.
+
+        .. versionchanged:: 2.4
+           If `name` is a :class:`Template` object it is returned from the
+           function unchanged.
+        """
+        if isinstance(name, Template):
+            return name
+        if parent is not None:
+            name = self.join_path(name, parent)
+        return self._load_template(name, self.make_globals(globals))
+
+    @internalcode
+    def select_template(self, names, parent=None, globals=None):
+        """Works like :meth:`get_template` but tries a number of templates
+        before it fails.  If it cannot find any of the templates, it will
+        raise a :exc:`TemplatesNotFound` exception.
+
+        .. versionchanged:: 2.11
+            If names is :class:`Undefined`, an :exc:`UndefinedError` is
+            raised instead. If no templates were found and names
+            contains :class:`Undefined`, the message is more helpful.
+
+        .. versionchanged:: 2.4
+           If `names` contains a :class:`Template` object it is returned
+           from the function unchanged.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(names, Undefined):
+            names._fail_with_undefined_error()
+
+        if not names:
+            raise TemplatesNotFound(
+                message=u"Tried to select from an empty list " u"of templates."
+            )
+        globals = self.make_globals(globals)
+        for name in names:
+            if isinstance(name, Template):
+                return name
+            if parent is not None:
+                name = self.join_path(name, parent)
+            try:
+                return self._load_template(name, globals)
+            except (TemplateNotFound, UndefinedError):
+                pass
+        raise TemplatesNotFound(names)
+
+    @internalcode
+    def get_or_select_template(self, template_name_or_list, parent=None, globals=None):
+        """Does a typecheck and dispatches to :meth:`select_template`
+        if an iterable of template names is given, otherwise to
+        :meth:`get_template`.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(template_name_or_list, (string_types, Undefined)):
+            return self.get_template(template_name_or_list, parent, globals)
+        elif isinstance(template_name_or_list, Template):
+            return template_name_or_list
+        return self.select_template(template_name_or_list, parent, globals)
+
+    def from_string(self, source, globals=None, template_class=None):
+        """Load a template from a string.  This parses the source given and
+        returns a :class:`Template` object.
+        """
+        globals = self.make_globals(globals)
+        cls = template_class or self.template_class
+        return cls.from_code(self, self.compile(source), globals, None)
+
+    def make_globals(self, d):
+        """Return a dict for the globals."""
+        if not d:
+            return self.globals
+        return dict(self.globals, **d)
+
+
+class Template(object):
+    """The central template object.  This class represents a compiled template
+    and is used to evaluate it.
+
+    Normally the template object is generated from an :class:`Environment` but
+    it also has a constructor that makes it possible to create a template
+    instance directly using the constructor.  It takes the same arguments as
+    the environment constructor but it's not possible to specify a loader.
+
+    Every template object has a few methods and members that are guaranteed
+    to exist.  However it's important that a template object should be
+    considered immutable.  Modifications on the object are not supported.
+
+    Template objects created from the constructor rather than an environment
+    do have an `environment` attribute that points to a temporary environment
+    that is probably shared with other templates created with the constructor
+    and compatible settings.
+
+    >>> template = Template('Hello {{ name }}!')
+    >>> template.render(name='John Doe') == u'Hello John Doe!'
+    True
+    >>> stream = template.stream(name='John Doe')
+    >>> next(stream) == u'Hello John Doe!'
+    True
+    >>> next(stream)
+    Traceback (most recent call last):
+        ...
+    StopIteration
+    """
+
+    #: Type of environment to create when creating a template directly
+    #: rather than through an existing environment.
+    environment_class = Environment
+
+    def __new__(
+        cls,
+        source,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        enable_async=False,
+    ):
+        env = get_spontaneous_environment(
+            cls.environment_class,
+            block_start_string,
+            block_end_string,
+            variable_start_string,
+            variable_end_string,
+            comment_start_string,
+            comment_end_string,
+            line_statement_prefix,
+            line_comment_prefix,
+            trim_blocks,
+            lstrip_blocks,
+            newline_sequence,
+            keep_trailing_newline,
+            frozenset(extensions),
+            optimized,
+            undefined,
+            finalize,
+            autoescape,
+            None,
+            0,
+            False,
+            None,
+            enable_async,
+        )
+        return env.from_string(source, template_class=cls)
+
+    @classmethod
+    def from_code(cls, environment, code, globals, uptodate=None):
+        """Creates a template object from compiled code and the globals.  This
+        is used by the loaders and environment to create a template object.
+        """
+        namespace = {"environment": environment, "__file__": code.co_filename}
+        exec(code, namespace)
+        rv = cls._from_namespace(environment, namespace, globals)
+        rv._uptodate = uptodate
+        return rv
+
+    @classmethod
+    def from_module_dict(cls, environment, module_dict, globals):
+        """Creates a template object from a module.  This is used by the
+        module loader to create a template object.
+
+        .. versionadded:: 2.4
+        """
+        return cls._from_namespace(environment, module_dict, globals)
+
+    @classmethod
+    def _from_namespace(cls, environment, namespace, globals):
+        t = object.__new__(cls)
+        t.environment = environment
+        t.globals = globals
+        t.name = namespace["name"]
+        t.filename = namespace["__file__"]
+        t.blocks = namespace["blocks"]
+
+        # render function and module
+        t.root_render_func = namespace["root"]
+        t._module = None
+
+        # debug and loader helpers
+        t._debug_info = namespace["debug_info"]
+        t._uptodate = None
+
+        # store the reference
+        namespace["environment"] = environment
+        namespace["__jinja_template__"] = t
+
+        return t
+
+    def render(self, *args, **kwargs):
+        """This method accepts the same arguments as the `dict` constructor:
+        A dict, a dict subclass or some keyword arguments.  If no arguments
+        are given the context will be empty.  These two calls do the same::
+
+            template.render(knights='that say nih')
+            template.render({'knights': 'that say nih'})
+
+        This will return the rendered template as unicode string.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            return concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            self.environment.handle_exception()
+
+    def render_async(self, *args, **kwargs):
+        """This works similar to :meth:`render` but returns a coroutine
+        that when awaited returns the entire rendered template string.  This
+        requires the async feature to be enabled.
+
+        Example usage::
+
+            await template.render_async(knights='that say nih; asynchronously')
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def stream(self, *args, **kwargs):
+        """Works exactly like :meth:`generate` but returns a
+        :class:`TemplateStream`.
+        """
+        return TemplateStream(self.generate(*args, **kwargs))
+
+    def generate(self, *args, **kwargs):
+        """For very large templates it can be useful to not render the whole
+        template at once but evaluate each statement after another and yield
+        piece for piece.  This method basically does exactly that and returns
+        a generator that yields one item after another as unicode strings.
+
+        It accepts the same arguments as :meth:`render`.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            for event in self.root_render_func(self.new_context(vars)):
+                yield event
+        except Exception:
+            yield self.environment.handle_exception()
+
+    def generate_async(self, *args, **kwargs):
+        """An async version of :meth:`generate`.  Works very similarly but
+        returns an async iterator instead.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def new_context(self, vars=None, shared=False, locals=None):
+        """Create a new :class:`Context` for this template.  The vars
+        provided will be passed to the template.  Per default the globals
+        are added to the context.  If shared is set to `True` the data
+        is passed as is to the context without adding the globals.
+
+        `locals` can be a dict of local variables for internal usage.
+        """
+        return new_context(
+            self.environment, self.name, self.blocks, vars, shared, self.globals, locals
+        )
+
+    def make_module(self, vars=None, shared=False, locals=None):
+        """This method works like the :attr:`module` attribute when called
+        without arguments but it will evaluate the template on every call
+        rather than caching it.  It's also possible to provide
+        a dict which is then used as context.  The arguments are the same
+        as for the :meth:`new_context` method.
+        """
+        return TemplateModule(self, self.new_context(vars, shared, locals))
+
+    def make_module_async(self, vars=None, shared=False, locals=None):
+        """As template module creation can invoke template code for
+        asynchronous executions this method must be used instead of the
+        normal :meth:`make_module` one.  Likewise the module attribute
+        becomes unavailable in async mode.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    @internalcode
+    def _get_default_module(self):
+        if self._module is not None:
+            return self._module
+        self._module = rv = self.make_module()
+        return rv
+
+    @property
+    def module(self):
+        """The template as module.  This is used for imports in the
+        template runtime but is also useful if one wants to access
+        exported template variables from the Python layer:
+
+        >>> t = Template('{% macro foo() %}42{% endmacro %}23')
+        >>> str(t.module)
+        '23'
+        >>> t.module.foo() == u'42'
+        True
+
+        This attribute is not available if async mode is enabled.
+        """
+        return self._get_default_module()
+
+    def get_corresponding_lineno(self, lineno):
+        """Return the source line number of a line number in the
+        generated bytecode as they are not in sync.
+        """
+        for template_line, code_line in reversed(self.debug_info):
+            if code_line <= lineno:
+                return template_line
+        return 1
+
+    @property
+    def is_up_to_date(self):
+        """If this variable is `False` there is a newer version available."""
+        if self._uptodate is None:
+            return True
+        return self._uptodate()
+
+    @property
+    def debug_info(self):
+        """The debug info mapping."""
+        if self._debug_info:
+            return [tuple(map(int, x.split("="))) for x in self._debug_info.split("&")]
+        return []
+
+    def __repr__(self):
+        if self.name is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.name)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+@implements_to_string
+class TemplateModule(object):
+    """Represents an imported template.  All the exported names of the
+    template are available as attributes on this object.  Additionally
+    converting it into an unicode- or bytestrings renders the contents.
+    """
+
+    def __init__(self, template, context, body_stream=None):
+        if body_stream is None:
+            if context.environment.is_async:
+                raise RuntimeError(
+                    "Async mode requires a body stream "
+                    "to be passed to a template module.  Use "
+                    "the async methods of the API you are "
+                    "using."
+                )
+            body_stream = list(template.root_render_func(context))
+        self._body_stream = body_stream
+        self.__dict__.update(context.get_exported())
+        self.__name__ = template.name
+
+    def __html__(self):
+        return Markup(concat(self._body_stream))
+
+    def __str__(self):
+        return concat(self._body_stream)
+
+    def __repr__(self):
+        if self.__name__ is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.__name__)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+class TemplateExpression(object):
+    """The :meth:`jinja2.Environment.compile_expression` method returns an
+    instance of this object.  It encapsulates the expression-like access
+    to the template with an expression it wraps.
+    """
+
+    def __init__(self, template, undefined_to_none):
+        self._template = template
+        self._undefined_to_none = undefined_to_none
+
+    def __call__(self, *args, **kwargs):
+        context = self._template.new_context(dict(*args, **kwargs))
+        consume(self._template.root_render_func(context))
+        rv = context.vars["result"]
+        if self._undefined_to_none and isinstance(rv, Undefined):
+            rv = None
+        return rv
+
+
+@implements_iterator
+class TemplateStream(object):
+    """A template stream works pretty much like an ordinary python generator
+    but it can buffer multiple items to reduce the number of total iterations.
+    Per default the output is unbuffered which means that for every unbuffered
+    instruction in the template one unicode string is yielded.
+
+    If buffering is enabled with a buffer size of 5, five items are combined
+    into a new unicode string.  This is mainly useful if you are streaming
+    big templates to a client via WSGI which flushes after each iteration.
+    """
+
+    def __init__(self, gen):
+        self._gen = gen
+        self.disable_buffering()
+
+    def dump(self, fp, encoding=None, errors="strict"):
+        """Dump the complete stream into a file or file-like object.
+        Per default unicode strings are written, if you want to encode
+        before writing specify an `encoding`.
+
+        Example usage::
+
+            Template('Hello {{ name }}!').stream(name='foo').dump('hello.html')
+        """
+        close = False
+        if isinstance(fp, string_types):
+            if encoding is None:
+                encoding = "utf-8"
+            fp = open(fp, "wb")
+            close = True
+        try:
+            if encoding is not None:
+                iterable = (x.encode(encoding, errors) for x in self)
+            else:
+                iterable = self
+            if hasattr(fp, "writelines"):
+                fp.writelines(iterable)
+            else:
+                for item in iterable:
+                    fp.write(item)
+        finally:
+            if close:
+                fp.close()
+
+    def disable_buffering(self):
+        """Disable the output buffering."""
+        self._next = partial(next, self._gen)
+        self.buffered = False
+
+    def _buffered_generator(self, size):
+        buf = []
+        c_size = 0
+        push = buf.append
+
+        while 1:
+            try:
+                while c_size < size:
+                    c = next(self._gen)
+                    push(c)
+                    if c:
+                        c_size += 1
+            except StopIteration:
+                if not c_size:
+                    return
+            yield concat(buf)
+            del buf[:]
+            c_size = 0
+
+    def enable_buffering(self, size=5):
+        """Enable buffering.  Buffer `size` items before yielding them."""
+        if size <= 1:
+            raise ValueError("buffer size too small")
+
+        self.buffered = True
+        self._next = partial(next, self._buffered_generator(size))
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        return self._next()
+
+
+# hook in default template class.  if anyone reads this comment: ignore that
+# it's possible to use custom templates ;-)
+Environment.template_class = Template
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/exceptions.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..0bf2003e30e2a24a54640359bb04f3e98b26e3f6
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/exceptions.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+from ._compat import imap
+from ._compat import implements_to_string
+from ._compat import PY2
+from ._compat import text_type
+
+
+class TemplateError(Exception):
+    """Baseclass for all template errors."""
+
+    if PY2:
+
+        def __init__(self, message=None):
+            if message is not None:
+                message = text_type(message).encode("utf-8")
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message.decode("utf-8", "replace")
+
+        def __unicode__(self):
+            return self.message or u""
+
+    else:
+
+        def __init__(self, message=None):
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message
+
+
+@implements_to_string
+class TemplateNotFound(IOError, LookupError, TemplateError):
+    """Raised if a template does not exist.
+
+    .. versionchanged:: 2.11
+        If the given name is :class:`Undefined` and no message was
+        provided, an :exc:`UndefinedError` is raised.
+    """
+
+    # looks weird, but removes the warning descriptor that just
+    # bogusly warns us about message being deprecated
+    message = None
+
+    def __init__(self, name, message=None):
+        IOError.__init__(self, name)
+
+        if message is None:
+            from .runtime import Undefined
+
+            if isinstance(name, Undefined):
+                name._fail_with_undefined_error()
+
+            message = name
+
+        self.message = message
+        self.name = name
+        self.templates = [name]
+
+    def __str__(self):
+        return self.message
+
+
+class TemplatesNotFound(TemplateNotFound):
+    """Like :class:`TemplateNotFound` but raised if multiple templates
+    are selected.  This is a subclass of :class:`TemplateNotFound`
+    exception, so just catching the base exception will catch both.
+
+    .. versionchanged:: 2.11
+        If a name in the list of names is :class:`Undefined`, a message
+        about it being undefined is shown rather than the empty string.
+
+    .. versionadded:: 2.2
+    """
+
+    def __init__(self, names=(), message=None):
+        if message is None:
+            from .runtime import Undefined
+
+            parts = []
+
+            for name in names:
+                if isinstance(name, Undefined):
+                    parts.append(name._undefined_message)
+                else:
+                    parts.append(name)
+
+            message = u"none of the templates given were found: " + u", ".join(
+                imap(text_type, parts)
+            )
+        TemplateNotFound.__init__(self, names and names[-1] or None, message)
+        self.templates = list(names)
+
+
+@implements_to_string
+class TemplateSyntaxError(TemplateError):
+    """Raised to tell the user that there is a problem with the template."""
+
+    def __init__(self, message, lineno, name=None, filename=None):
+        TemplateError.__init__(self, message)
+        self.lineno = lineno
+        self.name = name
+        self.filename = filename
+        self.source = None
+
+        # this is set to True if the debug.translate_syntax_error
+        # function translated the syntax error into a new traceback
+        self.translated = False
+
+    def __str__(self):
+        # for translated errors we only return the message
+        if self.translated:
+            return self.message
+
+        # otherwise attach some stuff
+        location = "line %d" % self.lineno
+        name = self.filename or self.name
+        if name:
+            location = 'File "%s", %s' % (name, location)
+        lines = [self.message, "  " + location]
+
+        # if the source is set, add the line to the output
+        if self.source is not None:
+            try:
+                line = self.source.splitlines()[self.lineno - 1]
+            except IndexError:
+                line = None
+            if line:
+                lines.append("    " + line.strip())
+
+        return u"\n".join(lines)
+
+    def __reduce__(self):
+        # https://bugs.python.org/issue1692335 Exceptions that take
+        # multiple required arguments have problems with pickling.
+        # Without this, raises TypeError: __init__() missing 1 required
+        # positional argument: 'lineno'
+        return self.__class__, (self.message, self.lineno, self.name, self.filename)
+
+
+class TemplateAssertionError(TemplateSyntaxError):
+    """Like a template syntax error, but covers cases where something in the
+    template caused an error at compile time that wasn't necessarily caused
+    by a syntax error.  However it's a direct subclass of
+    :exc:`TemplateSyntaxError` and has the same attributes.
+    """
+
+
+class TemplateRuntimeError(TemplateError):
+    """A generic runtime error in the template engine.  Under some situations
+    Jinja may raise this exception.
+    """
+
+
+class UndefinedError(TemplateRuntimeError):
+    """Raised if a template tries to operate on :class:`Undefined`."""
+
+
+class SecurityError(TemplateRuntimeError):
+    """Raised if a template tries to do something insecure if the
+    sandbox is enabled.
+    """
+
+
+class FilterArgumentError(TemplateRuntimeError):
+    """This error is raised if a filter was called with inappropriate
+    arguments
+    """
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/ext.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..9141be4dace15919a68c09ffbd5f96923224f09a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/ext.py
@@ -0,0 +1,704 @@
+# -*- coding: utf-8 -*-
+"""Extension API for adding custom tags and behavior."""
+import pprint
+import re
+from sys import version_info
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import with_metaclass
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .environment import Environment
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .nodes import ContextReference
+from .runtime import concat
+from .utils import contextfunction
+from .utils import import_string
+
+# the only real useful gettext functions for a Jinja template.  Note
+# that ugettext must be assigned to gettext as Jinja doesn't support
+# non unicode strings.
+GETTEXT_FUNCTIONS = ("_", "gettext", "ngettext")
+
+_ws_re = re.compile(r"\s*\n\s*")
+
+
+class ExtensionRegistry(type):
+    """Gives the extension an unique identifier."""
+
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        rv.identifier = rv.__module__ + "." + rv.__name__
+        return rv
+
+
+class Extension(with_metaclass(ExtensionRegistry, object)):
+    """Extensions can be used to add extra functionality to the Jinja template
+    system at the parser level.  Custom extensions are bound to an environment
+    but may not store environment specific data on `self`.  The reason for
+    this is that an extension can be bound to another environment (for
+    overlays) by creating a copy and reassigning the `environment` attribute.
+
+    As extensions are created by the environment they cannot accept any
+    arguments for configuration.  One may want to work around that by using
+    a factory function, but that is not possible as extensions are identified
+    by their import name.  The correct way to configure the extension is
+    storing the configuration values on the environment.  Because this way the
+    environment ends up acting as central configuration storage the
+    attributes may clash which is why extensions have to ensure that the names
+    they choose for configuration are not too generic.  ``prefix`` for example
+    is a terrible name, ``fragment_cache_prefix`` on the other hand is a good
+    name as includes the name of the extension (fragment cache).
+    """
+
+    #: if this extension parses this is the list of tags it's listening to.
+    tags = set()
+
+    #: the priority of that extension.  This is especially useful for
+    #: extensions that preprocess values.  A lower value means higher
+    #: priority.
+    #:
+    #: .. versionadded:: 2.4
+    priority = 100
+
+    def __init__(self, environment):
+        self.environment = environment
+
+    def bind(self, environment):
+        """Create a copy of this extension bound to another environment."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.environment = environment
+        return rv
+
+    def preprocess(self, source, name, filename=None):
+        """This method is called before the actual lexing and can be used to
+        preprocess the source.  The `filename` is optional.  The return value
+        must be the preprocessed source.
+        """
+        return source
+
+    def filter_stream(self, stream):
+        """It's passed a :class:`~jinja2.lexer.TokenStream` that can be used
+        to filter tokens returned.  This method has to return an iterable of
+        :class:`~jinja2.lexer.Token`\\s, but it doesn't have to return a
+        :class:`~jinja2.lexer.TokenStream`.
+        """
+        return stream
+
+    def parse(self, parser):
+        """If any of the :attr:`tags` matched this method is called with the
+        parser as first argument.  The token the parser stream is pointing at
+        is the name token that matched.  This method has to return one or a
+        list of multiple nodes.
+        """
+        raise NotImplementedError()
+
+    def attr(self, name, lineno=None):
+        """Return an attribute node for the current extension.  This is useful
+        to pass constants on extensions to generated template code.
+
+        ::
+
+            self.attr('_my_attribute', lineno=lineno)
+        """
+        return nodes.ExtensionAttribute(self.identifier, name, lineno=lineno)
+
+    def call_method(
+        self, name, args=None, kwargs=None, dyn_args=None, dyn_kwargs=None, lineno=None
+    ):
+        """Call a method of the extension.  This is a shortcut for
+        :meth:`attr` + :class:`jinja2.nodes.Call`.
+        """
+        if args is None:
+            args = []
+        if kwargs is None:
+            kwargs = []
+        return nodes.Call(
+            self.attr(name, lineno=lineno),
+            args,
+            kwargs,
+            dyn_args,
+            dyn_kwargs,
+            lineno=lineno,
+        )
+
+
+@contextfunction
+def _gettext_alias(__context, *args, **kwargs):
+    return __context.call(__context.resolve("gettext"), *args, **kwargs)
+
+
+def _make_new_gettext(func):
+    @contextfunction
+    def gettext(__context, __string, **variables):
+        rv = __context.call(func, __string)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, even if there are no
+        # variables. This makes translation strings more consistent
+        # and predictable. This requires escaping
+        return rv % variables
+
+    return gettext
+
+
+def _make_new_ngettext(func):
+    @contextfunction
+    def ngettext(__context, __singular, __plural, __num, **variables):
+        variables.setdefault("num", __num)
+        rv = __context.call(func, __singular, __plural, __num)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables
+
+    return ngettext
+
+
+class InternationalizationExtension(Extension):
+    """This extension adds gettext support to Jinja."""
+
+    tags = {"trans"}
+
+    # TODO: the i18n extension is currently reevaluating values in a few
+    # situations.  Take this example:
+    #   {% trans count=something() %}{{ count }} foo{% pluralize
+    #     %}{{ count }} fooss{% endtrans %}
+    # something is called twice here.  One time for the gettext value and
+    # the other time for the n-parameter of the ngettext function.
+
+    def __init__(self, environment):
+        Extension.__init__(self, environment)
+        environment.globals["_"] = _gettext_alias
+        environment.extend(
+            install_gettext_translations=self._install,
+            install_null_translations=self._install_null,
+            install_gettext_callables=self._install_callables,
+            uninstall_gettext_translations=self._uninstall,
+            extract_translations=self._extract,
+            newstyle_gettext=False,
+        )
+
+    def _install(self, translations, newstyle=None):
+        gettext = getattr(translations, "ugettext", None)
+        if gettext is None:
+            gettext = translations.gettext
+        ngettext = getattr(translations, "ungettext", None)
+        if ngettext is None:
+            ngettext = translations.ngettext
+        self._install_callables(gettext, ngettext, newstyle)
+
+    def _install_null(self, newstyle=None):
+        self._install_callables(
+            lambda x: x, lambda s, p, n: (n != 1 and (p,) or (s,))[0], newstyle
+        )
+
+    def _install_callables(self, gettext, ngettext, newstyle=None):
+        if newstyle is not None:
+            self.environment.newstyle_gettext = newstyle
+        if self.environment.newstyle_gettext:
+            gettext = _make_new_gettext(gettext)
+            ngettext = _make_new_ngettext(ngettext)
+        self.environment.globals.update(gettext=gettext, ngettext=ngettext)
+
+    def _uninstall(self, translations):
+        for key in "gettext", "ngettext":
+            self.environment.globals.pop(key, None)
+
+    def _extract(self, source, gettext_functions=GETTEXT_FUNCTIONS):
+        if isinstance(source, string_types):
+            source = self.environment.parse(source)
+        return extract_from_ast(source, gettext_functions)
+
+    def parse(self, parser):
+        """Parse a translatable tag."""
+        lineno = next(parser.stream).lineno
+        num_called_num = False
+
+        # find all the variables referenced.  Additionally a variable can be
+        # defined in the body of the trans block too, but this is checked at
+        # a later state.
+        plural_expr = None
+        plural_expr_assignment = None
+        variables = {}
+        trimmed = None
+        while parser.stream.current.type != "block_end":
+            if variables:
+                parser.stream.expect("comma")
+
+            # skip colon for python compatibility
+            if parser.stream.skip_if("colon"):
+                break
+
+            name = parser.stream.expect("name")
+            if name.value in variables:
+                parser.fail(
+                    "translatable variable %r defined twice." % name.value,
+                    name.lineno,
+                    exc=TemplateAssertionError,
+                )
+
+            # expressions
+            if parser.stream.current.type == "assign":
+                next(parser.stream)
+                variables[name.value] = var = parser.parse_expression()
+            elif trimmed is None and name.value in ("trimmed", "notrimmed"):
+                trimmed = name.value == "trimmed"
+                continue
+            else:
+                variables[name.value] = var = nodes.Name(name.value, "load")
+
+            if plural_expr is None:
+                if isinstance(var, nodes.Call):
+                    plural_expr = nodes.Name("_trans", "load")
+                    variables[name.value] = plural_expr
+                    plural_expr_assignment = nodes.Assign(
+                        nodes.Name("_trans", "store"), var
+                    )
+                else:
+                    plural_expr = var
+                num_called_num = name.value == "num"
+
+        parser.stream.expect("block_end")
+
+        plural = None
+        have_plural = False
+        referenced = set()
+
+        # now parse until endtrans or pluralize
+        singular_names, singular = self._parse_block(parser, True)
+        if singular_names:
+            referenced.update(singular_names)
+            if plural_expr is None:
+                plural_expr = nodes.Name(singular_names[0], "load")
+                num_called_num = singular_names[0] == "num"
+
+        # if we have a pluralize block, we parse that too
+        if parser.stream.current.test("name:pluralize"):
+            have_plural = True
+            next(parser.stream)
+            if parser.stream.current.type != "block_end":
+                name = parser.stream.expect("name")
+                if name.value not in variables:
+                    parser.fail(
+                        "unknown variable %r for pluralization" % name.value,
+                        name.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                plural_expr = variables[name.value]
+                num_called_num = name.value == "num"
+            parser.stream.expect("block_end")
+            plural_names, plural = self._parse_block(parser, False)
+            next(parser.stream)
+            referenced.update(plural_names)
+        else:
+            next(parser.stream)
+
+        # register free names as simple name expressions
+        for var in referenced:
+            if var not in variables:
+                variables[var] = nodes.Name(var, "load")
+
+        if not have_plural:
+            plural_expr = None
+        elif plural_expr is None:
+            parser.fail("pluralize without variables", lineno)
+
+        if trimmed is None:
+            trimmed = self.environment.policies["ext.i18n.trimmed"]
+        if trimmed:
+            singular = self._trim_whitespace(singular)
+            if plural:
+                plural = self._trim_whitespace(plural)
+
+        node = self._make_node(
+            singular,
+            plural,
+            variables,
+            plural_expr,
+            bool(referenced),
+            num_called_num and have_plural,
+        )
+        node.set_lineno(lineno)
+        if plural_expr_assignment is not None:
+            return [plural_expr_assignment, node]
+        else:
+            return node
+
+    def _trim_whitespace(self, string, _ws_re=_ws_re):
+        return _ws_re.sub(" ", string.strip())
+
+    def _parse_block(self, parser, allow_pluralize):
+        """Parse until the next block tag with a given name."""
+        referenced = []
+        buf = []
+        while 1:
+            if parser.stream.current.type == "data":
+                buf.append(parser.stream.current.value.replace("%", "%%"))
+                next(parser.stream)
+            elif parser.stream.current.type == "variable_begin":
+                next(parser.stream)
+                name = parser.stream.expect("name").value
+                referenced.append(name)
+                buf.append("%%(%s)s" % name)
+                parser.stream.expect("variable_end")
+            elif parser.stream.current.type == "block_begin":
+                next(parser.stream)
+                if parser.stream.current.test("name:endtrans"):
+                    break
+                elif parser.stream.current.test("name:pluralize"):
+                    if allow_pluralize:
+                        break
+                    parser.fail(
+                        "a translatable section can have only one pluralize section"
+                    )
+                parser.fail(
+                    "control structures in translatable sections are not allowed"
+                )
+            elif parser.stream.eos:
+                parser.fail("unclosed translation block")
+            else:
+                raise RuntimeError("internal parser error")
+
+        return referenced, concat(buf)
+
+    def _make_node(
+        self, singular, plural, variables, plural_expr, vars_referenced, num_called_num
+    ):
+        """Generates a useful node from the data provided."""
+        # no variables referenced?  no need to escape for old style
+        # gettext invocations only if there are vars.
+        if not vars_referenced and not self.environment.newstyle_gettext:
+            singular = singular.replace("%%", "%")
+            if plural:
+                plural = plural.replace("%%", "%")
+
+        # singular only:
+        if plural_expr is None:
+            gettext = nodes.Name("gettext", "load")
+            node = nodes.Call(gettext, [nodes.Const(singular)], [], None, None)
+
+        # singular and plural
+        else:
+            ngettext = nodes.Name("ngettext", "load")
+            node = nodes.Call(
+                ngettext,
+                [nodes.Const(singular), nodes.Const(plural), plural_expr],
+                [],
+                None,
+                None,
+            )
+
+        # in case newstyle gettext is used, the method is powerful
+        # enough to handle the variable expansion and autoescape
+        # handling itself
+        if self.environment.newstyle_gettext:
+            for key, value in iteritems(variables):
+                # the function adds that later anyways in case num was
+                # called num, so just skip it.
+                if num_called_num and key == "num":
+                    continue
+                node.kwargs.append(nodes.Keyword(key, value))
+
+        # otherwise do that here
+        else:
+            # mark the return value as safe if we are in an
+            # environment with autoescaping turned on
+            node = nodes.MarkSafeIfAutoescape(node)
+            if variables:
+                node = nodes.Mod(
+                    node,
+                    nodes.Dict(
+                        [
+                            nodes.Pair(nodes.Const(key), value)
+                            for key, value in variables.items()
+                        ]
+                    ),
+                )
+        return nodes.Output([node])
+
+
+class ExprStmtExtension(Extension):
+    """Adds a `do` tag to Jinja that works like the print statement just
+    that it doesn't print the return value.
+    """
+
+    tags = set(["do"])
+
+    def parse(self, parser):
+        node = nodes.ExprStmt(lineno=next(parser.stream).lineno)
+        node.node = parser.parse_tuple()
+        return node
+
+
+class LoopControlExtension(Extension):
+    """Adds break and continue to the template engine."""
+
+    tags = set(["break", "continue"])
+
+    def parse(self, parser):
+        token = next(parser.stream)
+        if token.value == "break":
+            return nodes.Break(lineno=token.lineno)
+        return nodes.Continue(lineno=token.lineno)
+
+
+class WithExtension(Extension):
+    pass
+
+
+class AutoEscapeExtension(Extension):
+    pass
+
+
+class DebugExtension(Extension):
+    """A ``{% debug %}`` tag that dumps the available variables,
+    filters, and tests.
+
+    .. code-block:: html+jinja
+
+        <pre>{% debug %}</pre>
+
+    .. code-block:: text
+
+        {'context': {'cycler': <class 'jinja2.utils.Cycler'>,
+                     ...,
+                     'namespace': <class 'jinja2.utils.Namespace'>},
+         'filters': ['abs', 'attr', 'batch', 'capitalize', 'center', 'count', 'd',
+                     ..., 'urlencode', 'urlize', 'wordcount', 'wordwrap', 'xmlattr'],
+         'tests': ['!=', '<', '<=', '==', '>', '>=', 'callable', 'defined',
+                   ..., 'odd', 'sameas', 'sequence', 'string', 'undefined', 'upper']}
+
+    .. versionadded:: 2.11.0
+    """
+
+    tags = {"debug"}
+
+    def parse(self, parser):
+        lineno = parser.stream.expect("name:debug").lineno
+        context = ContextReference()
+        result = self.call_method("_render", [context], lineno=lineno)
+        return nodes.Output([result], lineno=lineno)
+
+    def _render(self, context):
+        result = {
+            "context": context.get_all(),
+            "filters": sorted(self.environment.filters.keys()),
+            "tests": sorted(self.environment.tests.keys()),
+        }
+
+        # Set the depth since the intent is to show the top few names.
+        if version_info[:2] >= (3, 4):
+            return pprint.pformat(result, depth=3, compact=True)
+        else:
+            return pprint.pformat(result, depth=3)
+
+
+def extract_from_ast(node, gettext_functions=GETTEXT_FUNCTIONS, babel_style=True):
+    """Extract localizable strings from the given template node.  Per
+    default this function returns matches in babel style that means non string
+    parameters as well as keyword arguments are returned as `None`.  This
+    allows Babel to figure out what you really meant if you are using
+    gettext functions that allow keyword arguments for placeholder expansion.
+    If you don't want that behavior set the `babel_style` parameter to `False`
+    which causes only strings to be returned and parameters are always stored
+    in tuples.  As a consequence invalid gettext calls (calls without a single
+    string parameter or string parameters after non-string parameters) are
+    skipped.
+
+    This example explains the behavior:
+
+    >>> from jinja2 import Environment
+    >>> env = Environment()
+    >>> node = env.parse('{{ (_("foo"), _(), ngettext("foo", "bar", 42)) }}')
+    >>> list(extract_from_ast(node))
+    [(1, '_', 'foo'), (1, '_', ()), (1, 'ngettext', ('foo', 'bar', None))]
+    >>> list(extract_from_ast(node, babel_style=False))
+    [(1, '_', ('foo',)), (1, 'ngettext', ('foo', 'bar'))]
+
+    For every string found this function yields a ``(lineno, function,
+    message)`` tuple, where:
+
+    * ``lineno`` is the number of the line on which the string was found,
+    * ``function`` is the name of the ``gettext`` function used (if the
+      string was extracted from embedded Python code), and
+    *  ``message`` is the string itself (a ``unicode`` object, or a tuple
+       of ``unicode`` objects for functions with multiple string arguments).
+
+    This extraction function operates on the AST and is because of that unable
+    to extract any comments.  For comment support you have to use the babel
+    extraction interface or extract comments yourself.
+    """
+    for node in node.find_all(nodes.Call):
+        if (
+            not isinstance(node.node, nodes.Name)
+            or node.node.name not in gettext_functions
+        ):
+            continue
+
+        strings = []
+        for arg in node.args:
+            if isinstance(arg, nodes.Const) and isinstance(arg.value, string_types):
+                strings.append(arg.value)
+            else:
+                strings.append(None)
+
+        for _ in node.kwargs:
+            strings.append(None)
+        if node.dyn_args is not None:
+            strings.append(None)
+        if node.dyn_kwargs is not None:
+            strings.append(None)
+
+        if not babel_style:
+            strings = tuple(x for x in strings if x is not None)
+            if not strings:
+                continue
+        else:
+            if len(strings) == 1:
+                strings = strings[0]
+            else:
+                strings = tuple(strings)
+        yield node.lineno, node.node.name, strings
+
+
+class _CommentFinder(object):
+    """Helper class to find comments in a token stream.  Can only
+    find comments for gettext calls forwards.  Once the comment
+    from line 4 is found, a comment for line 1 will not return a
+    usable value.
+    """
+
+    def __init__(self, tokens, comment_tags):
+        self.tokens = tokens
+        self.comment_tags = comment_tags
+        self.offset = 0
+        self.last_lineno = 0
+
+    def find_backwards(self, offset):
+        try:
+            for _, token_type, token_value in reversed(
+                self.tokens[self.offset : offset]
+            ):
+                if token_type in ("comment", "linecomment"):
+                    try:
+                        prefix, comment = token_value.split(None, 1)
+                    except ValueError:
+                        continue
+                    if prefix in self.comment_tags:
+                        return [comment.rstrip()]
+            return []
+        finally:
+            self.offset = offset
+
+    def find_comments(self, lineno):
+        if not self.comment_tags or self.last_lineno > lineno:
+            return []
+        for idx, (token_lineno, _, _) in enumerate(self.tokens[self.offset :]):
+            if token_lineno > lineno:
+                return self.find_backwards(self.offset + idx)
+        return self.find_backwards(len(self.tokens))
+
+
+def babel_extract(fileobj, keywords, comment_tags, options):
+    """Babel extraction method for Jinja templates.
+
+    .. versionchanged:: 2.3
+       Basic support for translation comments was added.  If `comment_tags`
+       is now set to a list of keywords for extraction, the extractor will
+       try to find the best preceding comment that begins with one of the
+       keywords.  For best results, make sure to not have more than one
+       gettext call in one line of code and the matching comment in the
+       same line or the line before.
+
+    .. versionchanged:: 2.5.1
+       The `newstyle_gettext` flag can be set to `True` to enable newstyle
+       gettext calls.
+
+    .. versionchanged:: 2.7
+       A `silent` option can now be provided.  If set to `False` template
+       syntax errors are propagated instead of being ignored.
+
+    :param fileobj: the file-like object the messages should be extracted from
+    :param keywords: a list of keywords (i.e. function names) that should be
+                     recognized as translation functions
+    :param comment_tags: a list of translator tags to search for and include
+                         in the results.
+    :param options: a dictionary of additional options (optional)
+    :return: an iterator over ``(lineno, funcname, message, comments)`` tuples.
+             (comments will be empty currently)
+    """
+    extensions = set()
+    for extension in options.get("extensions", "").split(","):
+        extension = extension.strip()
+        if not extension:
+            continue
+        extensions.add(import_string(extension))
+    if InternationalizationExtension not in extensions:
+        extensions.add(InternationalizationExtension)
+
+    def getbool(options, key, default=False):
+        return options.get(key, str(default)).lower() in ("1", "on", "yes", "true")
+
+    silent = getbool(options, "silent", True)
+    environment = Environment(
+        options.get("block_start_string", BLOCK_START_STRING),
+        options.get("block_end_string", BLOCK_END_STRING),
+        options.get("variable_start_string", VARIABLE_START_STRING),
+        options.get("variable_end_string", VARIABLE_END_STRING),
+        options.get("comment_start_string", COMMENT_START_STRING),
+        options.get("comment_end_string", COMMENT_END_STRING),
+        options.get("line_statement_prefix") or LINE_STATEMENT_PREFIX,
+        options.get("line_comment_prefix") or LINE_COMMENT_PREFIX,
+        getbool(options, "trim_blocks", TRIM_BLOCKS),
+        getbool(options, "lstrip_blocks", LSTRIP_BLOCKS),
+        NEWLINE_SEQUENCE,
+        getbool(options, "keep_trailing_newline", KEEP_TRAILING_NEWLINE),
+        frozenset(extensions),
+        cache_size=0,
+        auto_reload=False,
+    )
+
+    if getbool(options, "trimmed"):
+        environment.policies["ext.i18n.trimmed"] = True
+    if getbool(options, "newstyle_gettext"):
+        environment.newstyle_gettext = True
+
+    source = fileobj.read().decode(options.get("encoding", "utf-8"))
+    try:
+        node = environment.parse(source)
+        tokens = list(environment.lex(environment.preprocess(source)))
+    except TemplateSyntaxError:
+        if not silent:
+            raise
+        # skip templates with syntax errors
+        return
+
+    finder = _CommentFinder(tokens, comment_tags)
+    for lineno, func, message in extract_from_ast(node, keywords):
+        yield lineno, func, message, finder.find_comments(lineno)
+
+
+#: nicer import names
+i18n = InternationalizationExtension
+do = ExprStmtExtension
+loopcontrols = LoopControlExtension
+with_ = WithExtension
+autoescape = AutoEscapeExtension
+debug = DebugExtension
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/filters.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..974156735123b88ed996997cf18e2db03bc3c7be
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/filters.py
@@ -0,0 +1,1382 @@
+# -*- coding: utf-8 -*-
+"""Built-in template filters used with the ``|`` operator."""
+import math
+import random
+import re
+import warnings
+from collections import namedtuple
+from itertools import chain
+from itertools import groupby
+
+from markupsafe import escape
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import FilterArgumentError
+from .runtime import Undefined
+from .utils import htmlsafe_json_dumps
+from .utils import pformat
+from .utils import unicode_urlencode
+from .utils import urlize
+
+_word_re = re.compile(r"\w+", re.UNICODE)
+_word_beginning_split_re = re.compile(r"([-\s\(\{\[\<]+)", re.UNICODE)
+
+
+def contextfilter(f):
+    """Decorator for marking context dependent filters. The current
+    :class:`Context` will be passed as first argument.
+    """
+    f.contextfilter = True
+    return f
+
+
+def evalcontextfilter(f):
+    """Decorator for marking eval-context dependent filters.  An eval
+    context object is passed as first argument.  For more information
+    about the eval context, see :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfilter = True
+    return f
+
+
+def environmentfilter(f):
+    """Decorator for marking environment dependent filters.  The current
+    :class:`Environment` is passed to the filter as first argument.
+    """
+    f.environmentfilter = True
+    return f
+
+
+def ignore_case(value):
+    """For use as a postprocessor for :func:`make_attrgetter`. Converts strings
+    to lowercase and returns other types as-is."""
+    return value.lower() if isinstance(value, string_types) else value
+
+
+def make_attrgetter(environment, attribute, postprocess=None, default=None):
+    """Returns a callable that looks up the given attribute from a
+    passed object with the rules of the environment.  Dots are allowed
+    to access attributes of attributes.  Integer parts in paths are
+    looked up as integers.
+    """
+    attribute = _prepare_attribute_parts(attribute)
+
+    def attrgetter(item):
+        for part in attribute:
+            item = environment.getitem(item, part)
+
+            if default and isinstance(item, Undefined):
+                item = default
+
+        if postprocess is not None:
+            item = postprocess(item)
+
+        return item
+
+    return attrgetter
+
+
+def make_multi_attrgetter(environment, attribute, postprocess=None):
+    """Returns a callable that looks up the given comma separated
+    attributes from a passed object with the rules of the environment.
+    Dots are allowed to access attributes of each attribute.  Integer
+    parts in paths are looked up as integers.
+
+    The value returned by the returned callable is a list of extracted
+    attribute values.
+
+    Examples of attribute: "attr1,attr2", "attr1.inner1.0,attr2.inner2.0", etc.
+    """
+    attribute_parts = (
+        attribute.split(",") if isinstance(attribute, string_types) else [attribute]
+    )
+    attribute = [
+        _prepare_attribute_parts(attribute_part) for attribute_part in attribute_parts
+    ]
+
+    def attrgetter(item):
+        items = [None] * len(attribute)
+        for i, attribute_part in enumerate(attribute):
+            item_i = item
+            for part in attribute_part:
+                item_i = environment.getitem(item_i, part)
+
+            if postprocess is not None:
+                item_i = postprocess(item_i)
+
+            items[i] = item_i
+        return items
+
+    return attrgetter
+
+
+def _prepare_attribute_parts(attr):
+    if attr is None:
+        return []
+    elif isinstance(attr, string_types):
+        return [int(x) if x.isdigit() else x for x in attr.split(".")]
+    else:
+        return [attr]
+
+
+def do_forceescape(value):
+    """Enforce HTML escaping.  This will probably double escape variables."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return escape(text_type(value))
+
+
+def do_urlencode(value):
+    """Quote data for use in a URL path or query using UTF-8.
+
+    Basic wrapper around :func:`urllib.parse.quote` when given a
+    string, or :func:`urllib.parse.urlencode` for a dict or iterable.
+
+    :param value: Data to quote. A string will be quoted directly. A
+        dict or iterable of ``(key, value)`` pairs will be joined as a
+        query string.
+
+    When given a string, "/" is not quoted. HTTP servers treat "/" and
+    "%2F" equivalently in paths. If you need quoted slashes, use the
+    ``|replace("/", "%2F")`` filter.
+
+    .. versionadded:: 2.7
+    """
+    if isinstance(value, string_types) or not isinstance(value, abc.Iterable):
+        return unicode_urlencode(value)
+
+    if isinstance(value, dict):
+        items = iteritems(value)
+    else:
+        items = iter(value)
+
+    return u"&".join(
+        "%s=%s" % (unicode_urlencode(k, for_qs=True), unicode_urlencode(v, for_qs=True))
+        for k, v in items
+    )
+
+
+@evalcontextfilter
+def do_replace(eval_ctx, s, old, new, count=None):
+    """Return a copy of the value with all occurrences of a substring
+    replaced with a new one. The first argument is the substring
+    that should be replaced, the second is the replacement string.
+    If the optional third argument ``count`` is given, only the first
+    ``count`` occurrences are replaced:
+
+    .. sourcecode:: jinja
+
+        {{ "Hello World"|replace("Hello", "Goodbye") }}
+            -> Goodbye World
+
+        {{ "aaaaargh"|replace("a", "d'oh, ", 2) }}
+            -> d'oh, d'oh, aaargh
+    """
+    if count is None:
+        count = -1
+    if not eval_ctx.autoescape:
+        return text_type(s).replace(text_type(old), text_type(new), count)
+    if (
+        hasattr(old, "__html__")
+        or hasattr(new, "__html__")
+        and not hasattr(s, "__html__")
+    ):
+        s = escape(s)
+    else:
+        s = soft_unicode(s)
+    return s.replace(soft_unicode(old), soft_unicode(new), count)
+
+
+def do_upper(s):
+    """Convert a value to uppercase."""
+    return soft_unicode(s).upper()
+
+
+def do_lower(s):
+    """Convert a value to lowercase."""
+    return soft_unicode(s).lower()
+
+
+@evalcontextfilter
+def do_xmlattr(_eval_ctx, d, autospace=True):
+    """Create an SGML/XML attribute string based on the items in a dict.
+    All values that are neither `none` nor `undefined` are automatically
+    escaped:
+
+    .. sourcecode:: html+jinja
+
+        <ul{{ {'class': 'my_list', 'missing': none,
+                'id': 'list-%d'|format(variable)}|xmlattr }}>
+        ...
+        </ul>
+
+    Results in something like this:
+
+    .. sourcecode:: html
+
+        <ul class="my_list" id="list-42">
+        ...
+        </ul>
+
+    As you can see it automatically prepends a space in front of the item
+    if the filter returned something unless the second parameter is false.
+    """
+    rv = u" ".join(
+        u'%s="%s"' % (escape(key), escape(value))
+        for key, value in iteritems(d)
+        if value is not None and not isinstance(value, Undefined)
+    )
+    if autospace and rv:
+        rv = u" " + rv
+    if _eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_capitalize(s):
+    """Capitalize a value. The first character will be uppercase, all others
+    lowercase.
+    """
+    return soft_unicode(s).capitalize()
+
+
+def do_title(s):
+    """Return a titlecased version of the value. I.e. words will start with
+    uppercase letters, all remaining characters are lowercase.
+    """
+    return "".join(
+        [
+            item[0].upper() + item[1:].lower()
+            for item in _word_beginning_split_re.split(soft_unicode(s))
+            if item
+        ]
+    )
+
+
+def do_dictsort(value, case_sensitive=False, by="key", reverse=False):
+    """Sort a dict and yield (key, value) pairs. Because python dicts are
+    unsorted you may want to use this function to order them by either
+    key or value:
+
+    .. sourcecode:: jinja
+
+        {% for item in mydict|dictsort %}
+            sort the dict by key, case insensitive
+
+        {% for item in mydict|dictsort(reverse=true) %}
+            sort the dict by key, case insensitive, reverse order
+
+        {% for item in mydict|dictsort(true) %}
+            sort the dict by key, case sensitive
+
+        {% for item in mydict|dictsort(false, 'value') %}
+            sort the dict by value, case insensitive
+    """
+    if by == "key":
+        pos = 0
+    elif by == "value":
+        pos = 1
+    else:
+        raise FilterArgumentError('You can only sort by either "key" or "value"')
+
+    def sort_func(item):
+        value = item[pos]
+
+        if not case_sensitive:
+            value = ignore_case(value)
+
+        return value
+
+    return sorted(value.items(), key=sort_func, reverse=reverse)
+
+
+@environmentfilter
+def do_sort(environment, value, reverse=False, case_sensitive=False, attribute=None):
+    """Sort an iterable using Python's :func:`sorted`.
+
+    .. sourcecode:: jinja
+
+        {% for city in cities|sort %}
+            ...
+        {% endfor %}
+
+    :param reverse: Sort descending instead of ascending.
+    :param case_sensitive: When sorting strings, sort upper and lower
+        case separately.
+    :param attribute: When sorting objects or dicts, an attribute or
+        key to sort by. Can use dot notation like ``"address.city"``.
+        Can be a list of attributes like ``"age,name"``.
+
+    The sort is stable, it does not change the relative order of
+    elements that compare equal. This makes it is possible to chain
+    sorts on different attributes and ordering.
+
+    .. sourcecode:: jinja
+
+        {% for user in users|sort(attribute="name")
+            |sort(reverse=true, attribute="age") %}
+            ...
+        {% endfor %}
+
+    As a shortcut to chaining when the direction is the same for all
+    attributes, pass a comma separate list of attributes.
+
+    .. sourcecode:: jinja
+
+        {% for user users|sort(attribute="age,name") %}
+            ...
+        {% endfor %}
+
+    .. versionchanged:: 2.11.0
+        The ``attribute`` parameter can be a comma separated list of
+        attributes, e.g. ``"age,name"``.
+
+    .. versionchanged:: 2.6
+       The ``attribute`` parameter was added.
+    """
+    key_func = make_multi_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return sorted(value, key=key_func, reverse=reverse)
+
+
+@environmentfilter
+def do_unique(environment, value, case_sensitive=False, attribute=None):
+    """Returns a list of unique items from the given iterable.
+
+    .. sourcecode:: jinja
+
+        {{ ['foo', 'bar', 'foobar', 'FooBar']|unique|list }}
+            -> ['foo', 'bar', 'foobar']
+
+    The unique items are yielded in the same order as their first occurrence in
+    the iterable passed to the filter.
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Filter objects with unique values for this attribute.
+    """
+    getter = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    seen = set()
+
+    for item in value:
+        key = getter(item)
+
+        if key not in seen:
+            seen.add(key)
+            yield item
+
+
+def _min_or_max(environment, value, func, case_sensitive, attribute):
+    it = iter(value)
+
+    try:
+        first = next(it)
+    except StopIteration:
+        return environment.undefined("No aggregated item, sequence was empty.")
+
+    key_func = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return func(chain([first], it), key=key_func)
+
+
+@environmentfilter
+def do_min(environment, value, case_sensitive=False, attribute=None):
+    """Return the smallest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|min }}
+            -> 1
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the min value of this attribute.
+    """
+    return _min_or_max(environment, value, min, case_sensitive, attribute)
+
+
+@environmentfilter
+def do_max(environment, value, case_sensitive=False, attribute=None):
+    """Return the largest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|max }}
+            -> 3
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the max value of this attribute.
+    """
+    return _min_or_max(environment, value, max, case_sensitive, attribute)
+
+
+def do_default(value, default_value=u"", boolean=False):
+    """If the value is undefined it will return the passed default value,
+    otherwise the value of the variable:
+
+    .. sourcecode:: jinja
+
+        {{ my_variable|default('my_variable is not defined') }}
+
+    This will output the value of ``my_variable`` if the variable was
+    defined, otherwise ``'my_variable is not defined'``. If you want
+    to use default with variables that evaluate to false you have to
+    set the second parameter to `true`:
+
+    .. sourcecode:: jinja
+
+        {{ ''|default('the string was empty', true) }}
+
+    .. versionchanged:: 2.11
+       It's now possible to configure the :class:`~jinja2.Environment` with
+       :class:`~jinja2.ChainableUndefined` to make the `default` filter work
+       on nested elements and attributes that may contain undefined values
+       in the chain without getting an :exc:`~jinja2.UndefinedError`.
+    """
+    if isinstance(value, Undefined) or (boolean and not value):
+        return default_value
+    return value
+
+
+@evalcontextfilter
+def do_join(eval_ctx, value, d=u"", attribute=None):
+    """Return a string which is the concatenation of the strings in the
+    sequence. The separator between elements is an empty string per
+    default, you can define it with the optional parameter:
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|join('|') }}
+            -> 1|2|3
+
+        {{ [1, 2, 3]|join }}
+            -> 123
+
+    It is also possible to join certain attributes of an object:
+
+    .. sourcecode:: jinja
+
+        {{ users|join(', ', attribute='username') }}
+
+    .. versionadded:: 2.6
+       The `attribute` parameter was added.
+    """
+    if attribute is not None:
+        value = imap(make_attrgetter(eval_ctx.environment, attribute), value)
+
+    # no automatic escaping?  joining is a lot easier then
+    if not eval_ctx.autoescape:
+        return text_type(d).join(imap(text_type, value))
+
+    # if the delimiter doesn't have an html representation we check
+    # if any of the items has.  If yes we do a coercion to Markup
+    if not hasattr(d, "__html__"):
+        value = list(value)
+        do_escape = False
+        for idx, item in enumerate(value):
+            if hasattr(item, "__html__"):
+                do_escape = True
+            else:
+                value[idx] = text_type(item)
+        if do_escape:
+            d = escape(d)
+        else:
+            d = text_type(d)
+        return d.join(value)
+
+    # no html involved, to normal joining
+    return soft_unicode(d).join(imap(soft_unicode, value))
+
+
+def do_center(value, width=80):
+    """Centers the value in a field of a given width."""
+    return text_type(value).center(width)
+
+
+@environmentfilter
+def do_first(environment, seq):
+    """Return the first item of a sequence."""
+    try:
+        return next(iter(seq))
+    except StopIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@environmentfilter
+def do_last(environment, seq):
+    """
+    Return the last item of a sequence.
+
+    Note: Does not work with generators. You may want to explicitly
+    convert it to a list:
+
+    .. sourcecode:: jinja
+
+        {{ data | selectattr('name', '==', 'Jinja') | list | last }}
+    """
+    try:
+        return next(iter(reversed(seq)))
+    except StopIteration:
+        return environment.undefined("No last item, sequence was empty.")
+
+
+@contextfilter
+def do_random(context, seq):
+    """Return a random item from the sequence."""
+    try:
+        return random.choice(seq)
+    except IndexError:
+        return context.environment.undefined("No random item, sequence was empty.")
+
+
+def do_filesizeformat(value, binary=False):
+    """Format the value like a 'human-readable' file size (i.e. 13 kB,
+    4.1 MB, 102 Bytes, etc).  Per default decimal prefixes are used (Mega,
+    Giga, etc.), if the second parameter is set to `True` the binary
+    prefixes are used (Mebi, Gibi).
+    """
+    bytes = float(value)
+    base = binary and 1024 or 1000
+    prefixes = [
+        (binary and "KiB" or "kB"),
+        (binary and "MiB" or "MB"),
+        (binary and "GiB" or "GB"),
+        (binary and "TiB" or "TB"),
+        (binary and "PiB" or "PB"),
+        (binary and "EiB" or "EB"),
+        (binary and "ZiB" or "ZB"),
+        (binary and "YiB" or "YB"),
+    ]
+    if bytes == 1:
+        return "1 Byte"
+    elif bytes < base:
+        return "%d Bytes" % bytes
+    else:
+        for i, prefix in enumerate(prefixes):
+            unit = base ** (i + 2)
+            if bytes < unit:
+                return "%.1f %s" % ((base * bytes / unit), prefix)
+        return "%.1f %s" % ((base * bytes / unit), prefix)
+
+
+def do_pprint(value, verbose=False):
+    """Pretty print a variable. Useful for debugging.
+
+    With Jinja 1.2 onwards you can pass it a parameter.  If this parameter
+    is truthy the output will be more verbose (this requires `pretty`)
+    """
+    return pformat(value, verbose=verbose)
+
+
+@evalcontextfilter
+def do_urlize(
+    eval_ctx, value, trim_url_limit=None, nofollow=False, target=None, rel=None
+):
+    """Converts URLs in plain text into clickable links.
+
+    If you pass the filter an additional integer it will shorten the urls
+    to that number. Also a third argument exists that makes the urls
+    "nofollow":
+
+    .. sourcecode:: jinja
+
+        {{ mytext|urlize(40, true) }}
+            links are shortened to 40 chars and defined with rel="nofollow"
+
+    If *target* is specified, the ``target`` attribute will be added to the
+    ``<a>`` tag:
+
+    .. sourcecode:: jinja
+
+       {{ mytext|urlize(40, target='_blank') }}
+
+    .. versionchanged:: 2.8+
+       The *target* parameter was added.
+    """
+    policies = eval_ctx.environment.policies
+    rel = set((rel or "").split() or [])
+    if nofollow:
+        rel.add("nofollow")
+    rel.update((policies["urlize.rel"] or "").split())
+    if target is None:
+        target = policies["urlize.target"]
+    rel = " ".join(sorted(rel)) or None
+    rv = urlize(value, trim_url_limit, rel=rel, target=target)
+    if eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_indent(s, width=4, first=False, blank=False, indentfirst=None):
+    """Return a copy of the string with each line indented by 4 spaces. The
+    first line and blank lines are not indented by default.
+
+    :param width: Number of spaces to indent by.
+    :param first: Don't skip indenting the first line.
+    :param blank: Don't skip indenting empty lines.
+
+    .. versionchanged:: 2.10
+        Blank lines are not indented by default.
+
+        Rename the ``indentfirst`` argument to ``first``.
+    """
+    if indentfirst is not None:
+        warnings.warn(
+            "The 'indentfirst' argument is renamed to 'first' and will"
+            " be removed in version 3.0.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        first = indentfirst
+
+    indention = u" " * width
+    newline = u"\n"
+
+    if isinstance(s, Markup):
+        indention = Markup(indention)
+        newline = Markup(newline)
+
+    s += newline  # this quirk is necessary for splitlines method
+
+    if blank:
+        rv = (newline + indention).join(s.splitlines())
+    else:
+        lines = s.splitlines()
+        rv = lines.pop(0)
+
+        if lines:
+            rv += newline + newline.join(
+                indention + line if line else line for line in lines
+            )
+
+    if first:
+        rv = indention + rv
+
+    return rv
+
+
+@environmentfilter
+def do_truncate(env, s, length=255, killwords=False, end="...", leeway=None):
+    """Return a truncated copy of the string. The length is specified
+    with the first parameter which defaults to ``255``. If the second
+    parameter is ``true`` the filter will cut the text at length. Otherwise
+    it will discard the last word. If the text was in fact
+    truncated it will append an ellipsis sign (``"..."``). If you want a
+    different ellipsis sign than ``"..."`` you can specify it using the
+    third parameter. Strings that only exceed the length by the tolerance
+    margin given in the fourth parameter will not be truncated.
+
+    .. sourcecode:: jinja
+
+        {{ "foo bar baz qux"|truncate(9) }}
+            -> "foo..."
+        {{ "foo bar baz qux"|truncate(9, True) }}
+            -> "foo ba..."
+        {{ "foo bar baz qux"|truncate(11) }}
+            -> "foo bar baz qux"
+        {{ "foo bar baz qux"|truncate(11, False, '...', 0) }}
+            -> "foo bar..."
+
+    The default leeway on newer Jinja versions is 5 and was 0 before but
+    can be reconfigured globally.
+    """
+    if leeway is None:
+        leeway = env.policies["truncate.leeway"]
+    assert length >= len(end), "expected length >= %s, got %s" % (len(end), length)
+    assert leeway >= 0, "expected leeway >= 0, got %s" % leeway
+    if len(s) <= length + leeway:
+        return s
+    if killwords:
+        return s[: length - len(end)] + end
+    result = s[: length - len(end)].rsplit(" ", 1)[0]
+    return result + end
+
+
+@environmentfilter
+def do_wordwrap(
+    environment,
+    s,
+    width=79,
+    break_long_words=True,
+    wrapstring=None,
+    break_on_hyphens=True,
+):
+    """Wrap a string to the given width. Existing newlines are treated
+    as paragraphs to be wrapped separately.
+
+    :param s: Original text to wrap.
+    :param width: Maximum length of wrapped lines.
+    :param break_long_words: If a word is longer than ``width``, break
+        it across lines.
+    :param break_on_hyphens: If a word contains hyphens, it may be split
+        across lines.
+    :param wrapstring: String to join each wrapped line. Defaults to
+        :attr:`Environment.newline_sequence`.
+
+    .. versionchanged:: 2.11
+        Existing newlines are treated as paragraphs wrapped separately.
+
+    .. versionchanged:: 2.11
+        Added the ``break_on_hyphens`` parameter.
+
+    .. versionchanged:: 2.7
+        Added the ``wrapstring`` parameter.
+    """
+
+    import textwrap
+
+    if not wrapstring:
+        wrapstring = environment.newline_sequence
+
+    # textwrap.wrap doesn't consider existing newlines when wrapping.
+    # If the string has a newline before width, wrap will still insert
+    # a newline at width, resulting in a short line. Instead, split and
+    # wrap each paragraph individually.
+    return wrapstring.join(
+        [
+            wrapstring.join(
+                textwrap.wrap(
+                    line,
+                    width=width,
+                    expand_tabs=False,
+                    replace_whitespace=False,
+                    break_long_words=break_long_words,
+                    break_on_hyphens=break_on_hyphens,
+                )
+            )
+            for line in s.splitlines()
+        ]
+    )
+
+
+def do_wordcount(s):
+    """Count the words in that string."""
+    return len(_word_re.findall(soft_unicode(s)))
+
+
+def do_int(value, default=0, base=10):
+    """Convert the value into an integer. If the
+    conversion doesn't work it will return ``0``. You can
+    override this default using the first parameter. You
+    can also override the default base (10) in the second
+    parameter, which handles input with prefixes such as
+    0b, 0o and 0x for bases 2, 8 and 16 respectively.
+    The base is ignored for decimal numbers and non-string values.
+    """
+    try:
+        if isinstance(value, string_types):
+            return int(value, base)
+        return int(value)
+    except (TypeError, ValueError):
+        # this quirk is necessary so that "42.23"|int gives 42.
+        try:
+            return int(float(value))
+        except (TypeError, ValueError):
+            return default
+
+
+def do_float(value, default=0.0):
+    """Convert the value into a floating point number. If the
+    conversion doesn't work it will return ``0.0``. You can
+    override this default using the first parameter.
+    """
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default
+
+
+def do_format(value, *args, **kwargs):
+    """Apply the given values to a `printf-style`_ format string, like
+    ``string % values``.
+
+    .. sourcecode:: jinja
+
+        {{ "%s, %s!"|format(greeting, name) }}
+        Hello, World!
+
+    In most cases it should be more convenient and efficient to use the
+    ``%`` operator or :meth:`str.format`.
+
+    .. code-block:: text
+
+        {{ "%s, %s!" % (greeting, name) }}
+        {{ "{}, {}!".format(greeting, name) }}
+
+    .. _printf-style: https://docs.python.org/library/stdtypes.html
+        #printf-style-string-formatting
+    """
+    if args and kwargs:
+        raise FilterArgumentError(
+            "can't handle positional and keyword arguments at the same time"
+        )
+    return soft_unicode(value) % (kwargs or args)
+
+
+def do_trim(value, chars=None):
+    """Strip leading and trailing characters, by default whitespace."""
+    return soft_unicode(value).strip(chars)
+
+
+def do_striptags(value):
+    """Strip SGML/XML tags and replace adjacent whitespace by one space."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return Markup(text_type(value)).striptags()
+
+
+def do_slice(value, slices, fill_with=None):
+    """Slice an iterator and return a list of lists containing
+    those items. Useful if you want to create a div containing
+    three ul tags that represent columns:
+
+    .. sourcecode:: html+jinja
+
+        <div class="columnwrapper">
+          {%- for column in items|slice(3) %}
+            <ul class="column-{{ loop.index }}">
+            {%- for item in column %}
+              <li>{{ item }}</li>
+            {%- endfor %}
+            </ul>
+          {%- endfor %}
+        </div>
+
+    If you pass it a second argument it's used to fill missing
+    values on the last iteration.
+    """
+    seq = list(value)
+    length = len(seq)
+    items_per_slice = length // slices
+    slices_with_extra = length % slices
+    offset = 0
+    for slice_number in range(slices):
+        start = offset + slice_number * items_per_slice
+        if slice_number < slices_with_extra:
+            offset += 1
+        end = offset + (slice_number + 1) * items_per_slice
+        tmp = seq[start:end]
+        if fill_with is not None and slice_number >= slices_with_extra:
+            tmp.append(fill_with)
+        yield tmp
+
+
+def do_batch(value, linecount, fill_with=None):
+    """
+    A filter that batches items. It works pretty much like `slice`
+    just the other way round. It returns a list of lists with the
+    given number of items. If you provide a second parameter this
+    is used to fill up missing items. See this example:
+
+    .. sourcecode:: html+jinja
+
+        <table>
+        {%- for row in items|batch(3, '&nbsp;') %}
+          <tr>
+          {%- for column in row %}
+            <td>{{ column }}</td>
+          {%- endfor %}
+          </tr>
+        {%- endfor %}
+        </table>
+    """
+    tmp = []
+    for item in value:
+        if len(tmp) == linecount:
+            yield tmp
+            tmp = []
+        tmp.append(item)
+    if tmp:
+        if fill_with is not None and len(tmp) < linecount:
+            tmp += [fill_with] * (linecount - len(tmp))
+        yield tmp
+
+
+def do_round(value, precision=0, method="common"):
+    """Round the number to a given precision. The first
+    parameter specifies the precision (default is ``0``), the
+    second the rounding method:
+
+    - ``'common'`` rounds either up or down
+    - ``'ceil'`` always rounds up
+    - ``'floor'`` always rounds down
+
+    If you don't specify a method ``'common'`` is used.
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round }}
+            -> 43.0
+        {{ 42.55|round(1, 'floor') }}
+            -> 42.5
+
+    Note that even if rounded to 0 precision, a float is returned.  If
+    you need a real integer, pipe it through `int`:
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round|int }}
+            -> 43
+    """
+    if method not in {"common", "ceil", "floor"}:
+        raise FilterArgumentError("method must be common, ceil or floor")
+    if method == "common":
+        return round(value, precision)
+    func = getattr(math, method)
+    return func(value * (10 ** precision)) / (10 ** precision)
+
+
+# Use a regular tuple repr here.  This is what we did in the past and we
+# really want to hide this custom type as much as possible.  In particular
+# we do not want to accidentally expose an auto generated repr in case
+# people start to print this out in comments or something similar for
+# debugging.
+_GroupTuple = namedtuple("_GroupTuple", ["grouper", "list"])
+_GroupTuple.__repr__ = tuple.__repr__
+_GroupTuple.__str__ = tuple.__str__
+
+
+@environmentfilter
+def do_groupby(environment, value, attribute):
+    """Group a sequence of objects by an attribute using Python's
+    :func:`itertools.groupby`. The attribute can use dot notation for
+    nested access, like ``"address.city"``. Unlike Python's ``groupby``,
+    the values are sorted first so only one group is returned for each
+    unique value.
+
+    For example, a list of ``User`` objects with a ``city`` attribute
+    can be rendered in groups. In this example, ``grouper`` refers to
+    the ``city`` value of the group.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for city, items in users|groupby("city") %}
+          <li>{{ city }}
+            <ul>{% for user in items %}
+              <li>{{ user.name }}
+            {% endfor %}</ul>
+          </li>
+        {% endfor %}</ul>
+
+    ``groupby`` yields namedtuples of ``(grouper, list)``, which
+    can be used instead of the tuple unpacking above. ``grouper`` is the
+    value of the attribute, and ``list`` is the items with that value.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for group in users|groupby("city") %}
+          <li>{{ group.grouper }}: {{ group.list|join(", ") }}
+        {% endfor %}</ul>
+
+    .. versionchanged:: 2.6
+        The attribute supports dot notation for nested access.
+    """
+    expr = make_attrgetter(environment, attribute)
+    return [
+        _GroupTuple(key, list(values))
+        for key, values in groupby(sorted(value, key=expr), expr)
+    ]
+
+
+@environmentfilter
+def do_sum(environment, iterable, attribute=None, start=0):
+    """Returns the sum of a sequence of numbers plus the value of parameter
+    'start' (which defaults to 0).  When the sequence is empty it returns
+    start.
+
+    It is also possible to sum up only certain attributes:
+
+    .. sourcecode:: jinja
+
+        Total: {{ items|sum(attribute='price') }}
+
+    .. versionchanged:: 2.6
+       The `attribute` parameter was added to allow suming up over
+       attributes.  Also the `start` parameter was moved on to the right.
+    """
+    if attribute is not None:
+        iterable = imap(make_attrgetter(environment, attribute), iterable)
+    return sum(iterable, start)
+
+
+def do_list(value):
+    """Convert the value into a list.  If it was a string the returned list
+    will be a list of characters.
+    """
+    return list(value)
+
+
+def do_mark_safe(value):
+    """Mark the value as safe which means that in an environment with automatic
+    escaping enabled this variable will not be escaped.
+    """
+    return Markup(value)
+
+
+def do_mark_unsafe(value):
+    """Mark a value as unsafe.  This is the reverse operation for :func:`safe`."""
+    return text_type(value)
+
+
+def do_reverse(value):
+    """Reverse the object or return an iterator that iterates over it the other
+    way round.
+    """
+    if isinstance(value, string_types):
+        return value[::-1]
+    try:
+        return reversed(value)
+    except TypeError:
+        try:
+            rv = list(value)
+            rv.reverse()
+            return rv
+        except TypeError:
+            raise FilterArgumentError("argument must be iterable")
+
+
+@environmentfilter
+def do_attr(environment, obj, name):
+    """Get an attribute of an object.  ``foo|attr("bar")`` works like
+    ``foo.bar`` just that always an attribute is returned and items are not
+    looked up.
+
+    See :ref:`Notes on subscriptions <notes-on-subscriptions>` for more details.
+    """
+    try:
+        name = str(name)
+    except UnicodeError:
+        pass
+    else:
+        try:
+            value = getattr(obj, name)
+        except AttributeError:
+            pass
+        else:
+            if environment.sandboxed and not environment.is_safe_attribute(
+                obj, name, value
+            ):
+                return environment.unsafe_undefined(obj, name)
+            return value
+    return environment.undefined(obj=obj, name=name)
+
+
+@contextfilter
+def do_map(*args, **kwargs):
+    """Applies a filter on a sequence of objects or looks up an attribute.
+    This is useful when dealing with lists of objects but you are really
+    only interested in a certain value of it.
+
+    The basic usage is mapping on an attribute.  Imagine you have a list
+    of users but you are only interested in a list of usernames:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ users|map(attribute='username')|join(', ') }}
+
+    You can specify a ``default`` value to use if an object in the list
+    does not have the given attribute.
+
+    .. sourcecode:: jinja
+
+        {{ users|map(attribute="username", default="Anonymous")|join(", ") }}
+
+    Alternatively you can let it invoke a filter by passing the name of the
+    filter and the arguments afterwards.  A good example would be applying a
+    text conversion filter on a sequence:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ titles|map('lower')|join(', ') }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u.username for u in users)
+        (u.username or "Anonymous" for u in users)
+        (do_lower(x) for x in titles)
+
+    .. versionchanged:: 2.11.0
+        Added the ``default`` parameter.
+
+    .. versionadded:: 2.7
+    """
+    seq, func = prepare_map(args, kwargs)
+    if seq:
+        for item in seq:
+            yield func(item)
+
+
+@contextfilter
+def do_select(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and only selecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|select("odd") }}
+        {{ numbers|select("odd") }}
+        {{ numbers|select("divisibleby", 3) }}
+        {{ numbers|select("lessthan", 42) }}
+        {{ strings|select("equalto", "mystring") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if test_odd(n))
+        (n for n in numbers if test_divisibleby(n, 3))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@contextfilter
+def do_reject(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and rejecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|reject("odd") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if not test_odd(n))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@contextfilter
+def do_selectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and only selecting the objects with the
+    test succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ users|selectattr("is_active") }}
+        {{ users|selectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if user.is_active)
+        (u for user in users if test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@contextfilter
+def do_rejectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and rejecting the objects with the test
+    succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    .. sourcecode:: jinja
+
+        {{ users|rejectattr("is_active") }}
+        {{ users|rejectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if not user.is_active)
+        (u for user in users if not test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@evalcontextfilter
+def do_tojson(eval_ctx, value, indent=None):
+    """Dumps a structure to JSON so that it's safe to use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+
+    The indent parameter can be used to enable pretty printing.  Set it to
+    the number of spaces that the structures should be indented with.
+
+    Note that this filter is for use in HTML contexts only.
+
+    .. versionadded:: 2.9
+    """
+    policies = eval_ctx.environment.policies
+    dumper = policies["json.dumps_function"]
+    options = policies["json.dumps_kwargs"]
+    if indent is not None:
+        options = dict(options)
+        options["indent"] = indent
+    return htmlsafe_json_dumps(value, dumper=dumper, **options)
+
+
+def prepare_map(args, kwargs):
+    context = args[0]
+    seq = args[1]
+    default = None
+
+    if len(args) == 2 and "attribute" in kwargs:
+        attribute = kwargs.pop("attribute")
+        default = kwargs.pop("default", None)
+        if kwargs:
+            raise FilterArgumentError(
+                "Unexpected keyword argument %r" % next(iter(kwargs))
+            )
+        func = make_attrgetter(context.environment, attribute, default=default)
+    else:
+        try:
+            name = args[2]
+            args = args[3:]
+        except LookupError:
+            raise FilterArgumentError("map requires a filter argument")
+
+        def func(item):
+            return context.environment.call_filter(
+                name, item, args, kwargs, context=context
+            )
+
+    return seq, func
+
+
+def prepare_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    context = args[0]
+    seq = args[1]
+    if lookup_attr:
+        try:
+            attr = args[2]
+        except LookupError:
+            raise FilterArgumentError("Missing parameter for attribute name")
+        transfunc = make_attrgetter(context.environment, attr)
+        off = 1
+    else:
+        off = 0
+
+        def transfunc(x):
+            return x
+
+    try:
+        name = args[2 + off]
+        args = args[3 + off :]
+
+        def func(item):
+            return context.environment.call_test(name, item, args, kwargs)
+
+    except LookupError:
+        func = bool
+
+    return seq, lambda item: modfunc(func(transfunc(item)))
+
+
+def select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        for item in seq:
+            if func(item):
+                yield item
+
+
+FILTERS = {
+    "abs": abs,
+    "attr": do_attr,
+    "batch": do_batch,
+    "capitalize": do_capitalize,
+    "center": do_center,
+    "count": len,
+    "d": do_default,
+    "default": do_default,
+    "dictsort": do_dictsort,
+    "e": escape,
+    "escape": escape,
+    "filesizeformat": do_filesizeformat,
+    "first": do_first,
+    "float": do_float,
+    "forceescape": do_forceescape,
+    "format": do_format,
+    "groupby": do_groupby,
+    "indent": do_indent,
+    "int": do_int,
+    "join": do_join,
+    "last": do_last,
+    "length": len,
+    "list": do_list,
+    "lower": do_lower,
+    "map": do_map,
+    "min": do_min,
+    "max": do_max,
+    "pprint": do_pprint,
+    "random": do_random,
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "replace": do_replace,
+    "reverse": do_reverse,
+    "round": do_round,
+    "safe": do_mark_safe,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "slice": do_slice,
+    "sort": do_sort,
+    "string": soft_unicode,
+    "striptags": do_striptags,
+    "sum": do_sum,
+    "title": do_title,
+    "trim": do_trim,
+    "truncate": do_truncate,
+    "unique": do_unique,
+    "upper": do_upper,
+    "urlencode": do_urlencode,
+    "urlize": do_urlize,
+    "wordcount": do_wordcount,
+    "wordwrap": do_wordwrap,
+    "xmlattr": do_xmlattr,
+    "tojson": do_tojson,
+}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/idtracking.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/idtracking.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a0d838017c938fa7a2c4279c4e8edc125608aaf
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/idtracking.py
@@ -0,0 +1,290 @@
+from ._compat import iteritems
+from .visitor import NodeVisitor
+
+VAR_LOAD_PARAMETER = "param"
+VAR_LOAD_RESOLVE = "resolve"
+VAR_LOAD_ALIAS = "alias"
+VAR_LOAD_UNDEFINED = "undefined"
+
+
+def find_symbols(nodes, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    visitor = FrameSymbolVisitor(sym)
+    for node in nodes:
+        visitor.visit(node)
+    return sym
+
+
+def symbols_for_node(node, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    sym.analyze_node(node)
+    return sym
+
+
+class Symbols(object):
+    def __init__(self, parent=None, level=None):
+        if level is None:
+            if parent is None:
+                level = 0
+            else:
+                level = parent.level + 1
+        self.level = level
+        self.parent = parent
+        self.refs = {}
+        self.loads = {}
+        self.stores = set()
+
+    def analyze_node(self, node, **kwargs):
+        visitor = RootVisitor(self)
+        visitor.visit(node, **kwargs)
+
+    def _define_ref(self, name, load=None):
+        ident = "l_%d_%s" % (self.level, name)
+        self.refs[name] = ident
+        if load is not None:
+            self.loads[ident] = load
+        return ident
+
+    def find_load(self, target):
+        if target in self.loads:
+            return self.loads[target]
+        if self.parent is not None:
+            return self.parent.find_load(target)
+
+    def find_ref(self, name):
+        if name in self.refs:
+            return self.refs[name]
+        if self.parent is not None:
+            return self.parent.find_ref(name)
+
+    def ref(self, name):
+        rv = self.find_ref(name)
+        if rv is None:
+            raise AssertionError(
+                "Tried to resolve a name to a reference that "
+                "was unknown to the frame (%r)" % name
+            )
+        return rv
+
+    def copy(self):
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.refs = self.refs.copy()
+        rv.loads = self.loads.copy()
+        rv.stores = self.stores.copy()
+        return rv
+
+    def store(self, name):
+        self.stores.add(name)
+
+        # If we have not see the name referenced yet, we need to figure
+        # out what to set it to.
+        if name not in self.refs:
+            # If there is a parent scope we check if the name has a
+            # reference there.  If it does it means we might have to alias
+            # to a variable there.
+            if self.parent is not None:
+                outer_ref = self.parent.find_ref(name)
+                if outer_ref is not None:
+                    self._define_ref(name, load=(VAR_LOAD_ALIAS, outer_ref))
+                    return
+
+            # Otherwise we can just set it to undefined.
+            self._define_ref(name, load=(VAR_LOAD_UNDEFINED, None))
+
+    def declare_parameter(self, name):
+        self.stores.add(name)
+        return self._define_ref(name, load=(VAR_LOAD_PARAMETER, None))
+
+    def load(self, name):
+        target = self.find_ref(name)
+        if target is None:
+            self._define_ref(name, load=(VAR_LOAD_RESOLVE, name))
+
+    def branch_update(self, branch_symbols):
+        stores = {}
+        for branch in branch_symbols:
+            for target in branch.stores:
+                if target in self.stores:
+                    continue
+                stores[target] = stores.get(target, 0) + 1
+
+        for sym in branch_symbols:
+            self.refs.update(sym.refs)
+            self.loads.update(sym.loads)
+            self.stores.update(sym.stores)
+
+        for name, branch_count in iteritems(stores):
+            if branch_count == len(branch_symbols):
+                continue
+            target = self.find_ref(name)
+            assert target is not None, "should not happen"
+
+            if self.parent is not None:
+                outer_target = self.parent.find_ref(name)
+                if outer_target is not None:
+                    self.loads[target] = (VAR_LOAD_ALIAS, outer_target)
+                    continue
+            self.loads[target] = (VAR_LOAD_RESOLVE, name)
+
+    def dump_stores(self):
+        rv = {}
+        node = self
+        while node is not None:
+            for name in node.stores:
+                if name not in rv:
+                    rv[name] = self.find_ref(name)
+            node = node.parent
+        return rv
+
+    def dump_param_targets(self):
+        rv = set()
+        node = self
+        while node is not None:
+            for target, (instr, _) in iteritems(self.loads):
+                if instr == VAR_LOAD_PARAMETER:
+                    rv.add(target)
+            node = node.parent
+        return rv
+
+
+class RootVisitor(NodeVisitor):
+    def __init__(self, symbols):
+        self.sym_visitor = FrameSymbolVisitor(symbols)
+
+    def _simple_visit(self, node, **kwargs):
+        for child in node.iter_child_nodes():
+            self.sym_visitor.visit(child)
+
+    visit_Template = (
+        visit_Block
+    ) = (
+        visit_Macro
+    ) = (
+        visit_FilterBlock
+    ) = visit_Scope = visit_If = visit_ScopedEvalContextModifier = _simple_visit
+
+    def visit_AssignBlock(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_CallBlock(self, node, **kwargs):
+        for child in node.iter_child_nodes(exclude=("call",)):
+            self.sym_visitor.visit(child)
+
+    def visit_OverlayScope(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_For(self, node, for_branch="body", **kwargs):
+        if for_branch == "body":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            branch = node.body
+        elif for_branch == "else":
+            branch = node.else_
+        elif for_branch == "test":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            if node.test is not None:
+                self.sym_visitor.visit(node.test)
+            return
+        else:
+            raise RuntimeError("Unknown for branch")
+        for item in branch or ():
+            self.sym_visitor.visit(item)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.targets:
+            self.sym_visitor.visit(target)
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def generic_visit(self, node, *args, **kwargs):
+        raise NotImplementedError(
+            "Cannot find symbols for %r" % node.__class__.__name__
+        )
+
+
+class FrameSymbolVisitor(NodeVisitor):
+    """A visitor for `Frame.inspect`."""
+
+    def __init__(self, symbols):
+        self.symbols = symbols
+
+    def visit_Name(self, node, store_as_param=False, **kwargs):
+        """All assignments to names go through this function."""
+        if store_as_param or node.ctx == "param":
+            self.symbols.declare_parameter(node.name)
+        elif node.ctx == "store":
+            self.symbols.store(node.name)
+        elif node.ctx == "load":
+            self.symbols.load(node.name)
+
+    def visit_NSRef(self, node, **kwargs):
+        self.symbols.load(node.name)
+
+    def visit_If(self, node, **kwargs):
+        self.visit(node.test, **kwargs)
+
+        original_symbols = self.symbols
+
+        def inner_visit(nodes):
+            self.symbols = rv = original_symbols.copy()
+            for subnode in nodes:
+                self.visit(subnode, **kwargs)
+            self.symbols = original_symbols
+            return rv
+
+        body_symbols = inner_visit(node.body)
+        elif_symbols = inner_visit(node.elif_)
+        else_symbols = inner_visit(node.else_ or ())
+
+        self.symbols.branch_update([body_symbols, elif_symbols, else_symbols])
+
+    def visit_Macro(self, node, **kwargs):
+        self.symbols.store(node.name)
+
+    def visit_Import(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        self.symbols.store(node.target)
+
+    def visit_FromImport(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        for name in node.names:
+            if isinstance(name, tuple):
+                self.symbols.store(name[1])
+            else:
+                self.symbols.store(name)
+
+    def visit_Assign(self, node, **kwargs):
+        """Visit assignments in the correct order."""
+        self.visit(node.node, **kwargs)
+        self.visit(node.target, **kwargs)
+
+    def visit_For(self, node, **kwargs):
+        """Visiting stops at for blocks.  However the block sequence
+        is visited as part of the outer scope.
+        """
+        self.visit(node.iter, **kwargs)
+
+    def visit_CallBlock(self, node, **kwargs):
+        self.visit(node.call, **kwargs)
+
+    def visit_FilterBlock(self, node, **kwargs):
+        self.visit(node.filter, **kwargs)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.values:
+            self.visit(target)
+
+    def visit_AssignBlock(self, node, **kwargs):
+        """Stop visiting at block assigns."""
+        self.visit(node.target, **kwargs)
+
+    def visit_Scope(self, node, **kwargs):
+        """Stop visiting at scopes."""
+
+    def visit_Block(self, node, **kwargs):
+        """Stop visiting at blocks."""
+
+    def visit_OverlayScope(self, node, **kwargs):
+        """Do not visit into overlay scopes."""
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/lexer.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/lexer.py
new file mode 100644
index 0000000000000000000000000000000000000000..552356a12d1d812397bc5b4f0491a1c115c3797a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/lexer.py
@@ -0,0 +1,848 @@
+# -*- coding: utf-8 -*-
+"""Implements a Jinja / Python combination lexer. The ``Lexer`` class
+is used to do some preprocessing. It filters out invalid operators like
+the bitshift operators we don't allow in templates. It separates
+template code and python code in expressions.
+"""
+import re
+from ast import literal_eval
+from collections import deque
+from operator import itemgetter
+
+from ._compat import implements_iterator
+from ._compat import intern
+from ._compat import iteritems
+from ._compat import text_type
+from .exceptions import TemplateSyntaxError
+from .utils import LRUCache
+
+# cache for the lexers. Exists in order to be able to have multiple
+# environments with the same lexer
+_lexer_cache = LRUCache(50)
+
+# static regular expressions
+whitespace_re = re.compile(r"\s+", re.U)
+newline_re = re.compile(r"(\r\n|\r|\n)")
+string_re = re.compile(
+    r"('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S
+)
+integer_re = re.compile(r"(\d+_)*\d+")
+float_re = re.compile(
+    r"""
+    (?<!\.)  # doesn't start with a .
+    (\d+_)*\d+  # digits, possibly _ separated
+    (
+        (\.(\d+_)*\d+)?  # optional fractional part
+        e[+\-]?(\d+_)*\d+  # exponent part
+    |
+        \.(\d+_)*\d+  # required fractional part
+    )
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+
+try:
+    # check if this Python supports Unicode identifiers
+    compile("föö", "<unknown>", "eval")
+except SyntaxError:
+    # Python 2, no Unicode support, use ASCII identifiers
+    name_re = re.compile(r"[a-zA-Z_][a-zA-Z0-9_]*")
+    check_ident = False
+else:
+    # Unicode support, import generated re pattern and set flag to use
+    # str.isidentifier to validate during lexing.
+    from ._identifier import pattern as name_re
+
+    check_ident = True
+
+# internal the tokens and keep references to them
+TOKEN_ADD = intern("add")
+TOKEN_ASSIGN = intern("assign")
+TOKEN_COLON = intern("colon")
+TOKEN_COMMA = intern("comma")
+TOKEN_DIV = intern("div")
+TOKEN_DOT = intern("dot")
+TOKEN_EQ = intern("eq")
+TOKEN_FLOORDIV = intern("floordiv")
+TOKEN_GT = intern("gt")
+TOKEN_GTEQ = intern("gteq")
+TOKEN_LBRACE = intern("lbrace")
+TOKEN_LBRACKET = intern("lbracket")
+TOKEN_LPAREN = intern("lparen")
+TOKEN_LT = intern("lt")
+TOKEN_LTEQ = intern("lteq")
+TOKEN_MOD = intern("mod")
+TOKEN_MUL = intern("mul")
+TOKEN_NE = intern("ne")
+TOKEN_PIPE = intern("pipe")
+TOKEN_POW = intern("pow")
+TOKEN_RBRACE = intern("rbrace")
+TOKEN_RBRACKET = intern("rbracket")
+TOKEN_RPAREN = intern("rparen")
+TOKEN_SEMICOLON = intern("semicolon")
+TOKEN_SUB = intern("sub")
+TOKEN_TILDE = intern("tilde")
+TOKEN_WHITESPACE = intern("whitespace")
+TOKEN_FLOAT = intern("float")
+TOKEN_INTEGER = intern("integer")
+TOKEN_NAME = intern("name")
+TOKEN_STRING = intern("string")
+TOKEN_OPERATOR = intern("operator")
+TOKEN_BLOCK_BEGIN = intern("block_begin")
+TOKEN_BLOCK_END = intern("block_end")
+TOKEN_VARIABLE_BEGIN = intern("variable_begin")
+TOKEN_VARIABLE_END = intern("variable_end")
+TOKEN_RAW_BEGIN = intern("raw_begin")
+TOKEN_RAW_END = intern("raw_end")
+TOKEN_COMMENT_BEGIN = intern("comment_begin")
+TOKEN_COMMENT_END = intern("comment_end")
+TOKEN_COMMENT = intern("comment")
+TOKEN_LINESTATEMENT_BEGIN = intern("linestatement_begin")
+TOKEN_LINESTATEMENT_END = intern("linestatement_end")
+TOKEN_LINECOMMENT_BEGIN = intern("linecomment_begin")
+TOKEN_LINECOMMENT_END = intern("linecomment_end")
+TOKEN_LINECOMMENT = intern("linecomment")
+TOKEN_DATA = intern("data")
+TOKEN_INITIAL = intern("initial")
+TOKEN_EOF = intern("eof")
+
+# bind operators to token types
+operators = {
+    "+": TOKEN_ADD,
+    "-": TOKEN_SUB,
+    "/": TOKEN_DIV,
+    "//": TOKEN_FLOORDIV,
+    "*": TOKEN_MUL,
+    "%": TOKEN_MOD,
+    "**": TOKEN_POW,
+    "~": TOKEN_TILDE,
+    "[": TOKEN_LBRACKET,
+    "]": TOKEN_RBRACKET,
+    "(": TOKEN_LPAREN,
+    ")": TOKEN_RPAREN,
+    "{": TOKEN_LBRACE,
+    "}": TOKEN_RBRACE,
+    "==": TOKEN_EQ,
+    "!=": TOKEN_NE,
+    ">": TOKEN_GT,
+    ">=": TOKEN_GTEQ,
+    "<": TOKEN_LT,
+    "<=": TOKEN_LTEQ,
+    "=": TOKEN_ASSIGN,
+    ".": TOKEN_DOT,
+    ":": TOKEN_COLON,
+    "|": TOKEN_PIPE,
+    ",": TOKEN_COMMA,
+    ";": TOKEN_SEMICOLON,
+}
+
+reverse_operators = dict([(v, k) for k, v in iteritems(operators)])
+assert len(operators) == len(reverse_operators), "operators dropped"
+operator_re = re.compile(
+    "(%s)" % "|".join(re.escape(x) for x in sorted(operators, key=lambda x: -len(x)))
+)
+
+ignored_tokens = frozenset(
+    [
+        TOKEN_COMMENT_BEGIN,
+        TOKEN_COMMENT,
+        TOKEN_COMMENT_END,
+        TOKEN_WHITESPACE,
+        TOKEN_LINECOMMENT_BEGIN,
+        TOKEN_LINECOMMENT_END,
+        TOKEN_LINECOMMENT,
+    ]
+)
+ignore_if_empty = frozenset(
+    [TOKEN_WHITESPACE, TOKEN_DATA, TOKEN_COMMENT, TOKEN_LINECOMMENT]
+)
+
+
+def _describe_token_type(token_type):
+    if token_type in reverse_operators:
+        return reverse_operators[token_type]
+    return {
+        TOKEN_COMMENT_BEGIN: "begin of comment",
+        TOKEN_COMMENT_END: "end of comment",
+        TOKEN_COMMENT: "comment",
+        TOKEN_LINECOMMENT: "comment",
+        TOKEN_BLOCK_BEGIN: "begin of statement block",
+        TOKEN_BLOCK_END: "end of statement block",
+        TOKEN_VARIABLE_BEGIN: "begin of print statement",
+        TOKEN_VARIABLE_END: "end of print statement",
+        TOKEN_LINESTATEMENT_BEGIN: "begin of line statement",
+        TOKEN_LINESTATEMENT_END: "end of line statement",
+        TOKEN_DATA: "template data / text",
+        TOKEN_EOF: "end of template",
+    }.get(token_type, token_type)
+
+
+def describe_token(token):
+    """Returns a description of the token."""
+    if token.type == TOKEN_NAME:
+        return token.value
+    return _describe_token_type(token.type)
+
+
+def describe_token_expr(expr):
+    """Like `describe_token` but for token expressions."""
+    if ":" in expr:
+        type, value = expr.split(":", 1)
+        if type == TOKEN_NAME:
+            return value
+    else:
+        type = expr
+    return _describe_token_type(type)
+
+
+def count_newlines(value):
+    """Count the number of newline characters in the string.  This is
+    useful for extensions that filter a stream.
+    """
+    return len(newline_re.findall(value))
+
+
+def compile_rules(environment):
+    """Compiles all the rules from the environment into a list of rules."""
+    e = re.escape
+    rules = [
+        (
+            len(environment.comment_start_string),
+            TOKEN_COMMENT_BEGIN,
+            e(environment.comment_start_string),
+        ),
+        (
+            len(environment.block_start_string),
+            TOKEN_BLOCK_BEGIN,
+            e(environment.block_start_string),
+        ),
+        (
+            len(environment.variable_start_string),
+            TOKEN_VARIABLE_BEGIN,
+            e(environment.variable_start_string),
+        ),
+    ]
+
+    if environment.line_statement_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_statement_prefix),
+                TOKEN_LINESTATEMENT_BEGIN,
+                r"^[ \t\v]*" + e(environment.line_statement_prefix),
+            )
+        )
+    if environment.line_comment_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_comment_prefix),
+                TOKEN_LINECOMMENT_BEGIN,
+                r"(?:^|(?<=\S))[^\S\r\n]*" + e(environment.line_comment_prefix),
+            )
+        )
+
+    return [x[1:] for x in sorted(rules, reverse=True)]
+
+
+class Failure(object):
+    """Class that raises a `TemplateSyntaxError` if called.
+    Used by the `Lexer` to specify known errors.
+    """
+
+    def __init__(self, message, cls=TemplateSyntaxError):
+        self.message = message
+        self.error_class = cls
+
+    def __call__(self, lineno, filename):
+        raise self.error_class(self.message, lineno, filename)
+
+
+class Token(tuple):
+    """Token class."""
+
+    __slots__ = ()
+    lineno, type, value = (property(itemgetter(x)) for x in range(3))
+
+    def __new__(cls, lineno, type, value):
+        return tuple.__new__(cls, (lineno, intern(str(type)), value))
+
+    def __str__(self):
+        if self.type in reverse_operators:
+            return reverse_operators[self.type]
+        elif self.type == "name":
+            return self.value
+        return self.type
+
+    def test(self, expr):
+        """Test a token against a token expression.  This can either be a
+        token type or ``'token_type:token_value'``.  This can only test
+        against string values and types.
+        """
+        # here we do a regular string equality check as test_any is usually
+        # passed an iterable of not interned strings.
+        if self.type == expr:
+            return True
+        elif ":" in expr:
+            return expr.split(":", 1) == [self.type, self.value]
+        return False
+
+    def test_any(self, *iterable):
+        """Test against multiple token expressions."""
+        for expr in iterable:
+            if self.test(expr):
+                return True
+        return False
+
+    def __repr__(self):
+        return "Token(%r, %r, %r)" % (self.lineno, self.type, self.value)
+
+
+@implements_iterator
+class TokenStreamIterator(object):
+    """The iterator for tokenstreams.  Iterate over the stream
+    until the eof token is reached.
+    """
+
+    def __init__(self, stream):
+        self.stream = stream
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        token = self.stream.current
+        if token.type is TOKEN_EOF:
+            self.stream.close()
+            raise StopIteration()
+        next(self.stream)
+        return token
+
+
+@implements_iterator
+class TokenStream(object):
+    """A token stream is an iterable that yields :class:`Token`\\s.  The
+    parser however does not iterate over it but calls :meth:`next` to go
+    one token ahead.  The current active token is stored as :attr:`current`.
+    """
+
+    def __init__(self, generator, name, filename):
+        self._iter = iter(generator)
+        self._pushed = deque()
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.current = Token(1, TOKEN_INITIAL, "")
+        next(self)
+
+    def __iter__(self):
+        return TokenStreamIterator(self)
+
+    def __bool__(self):
+        return bool(self._pushed) or self.current.type is not TOKEN_EOF
+
+    __nonzero__ = __bool__  # py2
+
+    @property
+    def eos(self):
+        """Are we at the end of the stream?"""
+        return not self
+
+    def push(self, token):
+        """Push a token back to the stream."""
+        self._pushed.append(token)
+
+    def look(self):
+        """Look at the next token."""
+        old_token = next(self)
+        result = self.current
+        self.push(result)
+        self.current = old_token
+        return result
+
+    def skip(self, n=1):
+        """Got n tokens ahead."""
+        for _ in range(n):
+            next(self)
+
+    def next_if(self, expr):
+        """Perform the token test and return the token if it matched.
+        Otherwise the return value is `None`.
+        """
+        if self.current.test(expr):
+            return next(self)
+
+    def skip_if(self, expr):
+        """Like :meth:`next_if` but only returns `True` or `False`."""
+        return self.next_if(expr) is not None
+
+    def __next__(self):
+        """Go one token ahead and return the old one.
+
+        Use the built-in :func:`next` instead of calling this directly.
+        """
+        rv = self.current
+        if self._pushed:
+            self.current = self._pushed.popleft()
+        elif self.current.type is not TOKEN_EOF:
+            try:
+                self.current = next(self._iter)
+            except StopIteration:
+                self.close()
+        return rv
+
+    def close(self):
+        """Close the stream."""
+        self.current = Token(self.current.lineno, TOKEN_EOF, "")
+        self._iter = None
+        self.closed = True
+
+    def expect(self, expr):
+        """Expect a given token type and return it.  This accepts the same
+        argument as :meth:`jinja2.lexer.Token.test`.
+        """
+        if not self.current.test(expr):
+            expr = describe_token_expr(expr)
+            if self.current.type is TOKEN_EOF:
+                raise TemplateSyntaxError(
+                    "unexpected end of template, expected %r." % expr,
+                    self.current.lineno,
+                    self.name,
+                    self.filename,
+                )
+            raise TemplateSyntaxError(
+                "expected token %r, got %r" % (expr, describe_token(self.current)),
+                self.current.lineno,
+                self.name,
+                self.filename,
+            )
+        try:
+            return self.current
+        finally:
+            next(self)
+
+
+def get_lexer(environment):
+    """Return a lexer which is probably cached."""
+    key = (
+        environment.block_start_string,
+        environment.block_end_string,
+        environment.variable_start_string,
+        environment.variable_end_string,
+        environment.comment_start_string,
+        environment.comment_end_string,
+        environment.line_statement_prefix,
+        environment.line_comment_prefix,
+        environment.trim_blocks,
+        environment.lstrip_blocks,
+        environment.newline_sequence,
+        environment.keep_trailing_newline,
+    )
+    lexer = _lexer_cache.get(key)
+    if lexer is None:
+        lexer = Lexer(environment)
+        _lexer_cache[key] = lexer
+    return lexer
+
+
+class OptionalLStrip(tuple):
+    """A special tuple for marking a point in the state that can have
+    lstrip applied.
+    """
+
+    __slots__ = ()
+
+    # Even though it looks like a no-op, creating instances fails
+    # without this.
+    def __new__(cls, *members, **kwargs):
+        return super(OptionalLStrip, cls).__new__(cls, members)
+
+
+class Lexer(object):
+    """Class that implements a lexer for a given environment. Automatically
+    created by the environment class, usually you don't have to do that.
+
+    Note that the lexer is not automatically bound to an environment.
+    Multiple environments can share the same lexer.
+    """
+
+    def __init__(self, environment):
+        # shortcuts
+        e = re.escape
+
+        def c(x):
+            return re.compile(x, re.M | re.S)
+
+        # lexing rules for tags
+        tag_rules = [
+            (whitespace_re, TOKEN_WHITESPACE, None),
+            (float_re, TOKEN_FLOAT, None),
+            (integer_re, TOKEN_INTEGER, None),
+            (name_re, TOKEN_NAME, None),
+            (string_re, TOKEN_STRING, None),
+            (operator_re, TOKEN_OPERATOR, None),
+        ]
+
+        # assemble the root lexing rule. because "|" is ungreedy
+        # we have to sort by length so that the lexer continues working
+        # as expected when we have parsing rules like <% for block and
+        # <%= for variables. (if someone wants asp like syntax)
+        # variables are just part of the rules if variable processing
+        # is required.
+        root_tag_rules = compile_rules(environment)
+
+        # block suffix if trimming is enabled
+        block_suffix_re = environment.trim_blocks and "\\n?" or ""
+
+        # If lstrip is enabled, it should not be applied if there is any
+        # non-whitespace between the newline and block.
+        self.lstrip_unless_re = c(r"[^ \t]") if environment.lstrip_blocks else None
+
+        self.newline_sequence = environment.newline_sequence
+        self.keep_trailing_newline = environment.keep_trailing_newline
+
+        # global lexing rules
+        self.rules = {
+            "root": [
+                # directives
+                (
+                    c(
+                        "(.*?)(?:%s)"
+                        % "|".join(
+                            [
+                                r"(?P<raw_begin>%s(\-|\+|)\s*raw\s*(?:\-%s\s*|%s))"
+                                % (
+                                    e(environment.block_start_string),
+                                    e(environment.block_end_string),
+                                    e(environment.block_end_string),
+                                )
+                            ]
+                            + [
+                                r"(?P<%s>%s(\-|\+|))" % (n, r)
+                                for n, r in root_tag_rules
+                            ]
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, "#bygroup"),
+                    "#bygroup",
+                ),
+                # data
+                (c(".+"), TOKEN_DATA, None),
+            ],
+            # comments
+            TOKEN_COMMENT_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:\-%s\s*|%s)%s)"
+                        % (
+                            e(environment.comment_end_string),
+                            e(environment.comment_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    (TOKEN_COMMENT, TOKEN_COMMENT_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of comment tag"),), None),
+            ],
+            # blocks
+            TOKEN_BLOCK_BEGIN: [
+                (
+                    c(
+                        r"(?:\-%s\s*|%s)%s"
+                        % (
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    TOKEN_BLOCK_END,
+                    "#pop",
+                ),
+            ]
+            + tag_rules,
+            # variables
+            TOKEN_VARIABLE_BEGIN: [
+                (
+                    c(
+                        r"\-%s\s*|%s"
+                        % (
+                            e(environment.variable_end_string),
+                            e(environment.variable_end_string),
+                        )
+                    ),
+                    TOKEN_VARIABLE_END,
+                    "#pop",
+                )
+            ]
+            + tag_rules,
+            # raw block
+            TOKEN_RAW_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:%s(\-|\+|))\s*endraw\s*(?:\-%s\s*|%s%s))"
+                        % (
+                            e(environment.block_start_string),
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, TOKEN_RAW_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of raw directive"),), None),
+            ],
+            # line statements
+            TOKEN_LINESTATEMENT_BEGIN: [
+                (c(r"\s*(\n|$)"), TOKEN_LINESTATEMENT_END, "#pop")
+            ]
+            + tag_rules,
+            # line comments
+            TOKEN_LINECOMMENT_BEGIN: [
+                (
+                    c(r"(.*?)()(?=\n|$)"),
+                    (TOKEN_LINECOMMENT, TOKEN_LINECOMMENT_END),
+                    "#pop",
+                )
+            ],
+        }
+
+    def _normalize_newlines(self, value):
+        """Called for strings and template data to normalize it to unicode."""
+        return newline_re.sub(self.newline_sequence, value)
+
+    def tokenize(self, source, name=None, filename=None, state=None):
+        """Calls tokeniter + tokenize and wraps it in a token stream."""
+        stream = self.tokeniter(source, name, filename, state)
+        return TokenStream(self.wrap(stream, name, filename), name, filename)
+
+    def wrap(self, stream, name=None, filename=None):
+        """This is called with the stream as returned by `tokenize` and wraps
+        every token in a :class:`Token` and converts the value.
+        """
+        for lineno, token, value in stream:
+            if token in ignored_tokens:
+                continue
+            elif token == TOKEN_LINESTATEMENT_BEGIN:
+                token = TOKEN_BLOCK_BEGIN
+            elif token == TOKEN_LINESTATEMENT_END:
+                token = TOKEN_BLOCK_END
+            # we are not interested in those tokens in the parser
+            elif token in (TOKEN_RAW_BEGIN, TOKEN_RAW_END):
+                continue
+            elif token == TOKEN_DATA:
+                value = self._normalize_newlines(value)
+            elif token == "keyword":
+                token = value
+            elif token == TOKEN_NAME:
+                value = str(value)
+                if check_ident and not value.isidentifier():
+                    raise TemplateSyntaxError(
+                        "Invalid character in identifier", lineno, name, filename
+                    )
+            elif token == TOKEN_STRING:
+                # try to unescape string
+                try:
+                    value = (
+                        self._normalize_newlines(value[1:-1])
+                        .encode("ascii", "backslashreplace")
+                        .decode("unicode-escape")
+                    )
+                except Exception as e:
+                    msg = str(e).split(":")[-1].strip()
+                    raise TemplateSyntaxError(msg, lineno, name, filename)
+            elif token == TOKEN_INTEGER:
+                value = int(value.replace("_", ""))
+            elif token == TOKEN_FLOAT:
+                # remove all "_" first to support more Python versions
+                value = literal_eval(value.replace("_", ""))
+            elif token == TOKEN_OPERATOR:
+                token = operators[value]
+            yield Token(lineno, token, value)
+
+    def tokeniter(self, source, name, filename=None, state=None):
+        """This method tokenizes the text and returns the tokens in a
+        generator.  Use this method if you just want to tokenize a template.
+        """
+        source = text_type(source)
+        lines = source.splitlines()
+        if self.keep_trailing_newline and source:
+            for newline in ("\r\n", "\r", "\n"):
+                if source.endswith(newline):
+                    lines.append("")
+                    break
+        source = "\n".join(lines)
+        pos = 0
+        lineno = 1
+        stack = ["root"]
+        if state is not None and state != "root":
+            assert state in ("variable", "block"), "invalid state"
+            stack.append(state + "_begin")
+        statetokens = self.rules[stack[-1]]
+        source_length = len(source)
+        balancing_stack = []
+        lstrip_unless_re = self.lstrip_unless_re
+        newlines_stripped = 0
+        line_starting = True
+
+        while 1:
+            # tokenizer loop
+            for regex, tokens, new_state in statetokens:
+                m = regex.match(source, pos)
+                # if no match we try again with the next rule
+                if m is None:
+                    continue
+
+                # we only match blocks and variables if braces / parentheses
+                # are balanced. continue parsing with the lower rule which
+                # is the operator rule. do this only if the end tags look
+                # like operators
+                if balancing_stack and tokens in (
+                    TOKEN_VARIABLE_END,
+                    TOKEN_BLOCK_END,
+                    TOKEN_LINESTATEMENT_END,
+                ):
+                    continue
+
+                # tuples support more options
+                if isinstance(tokens, tuple):
+                    groups = m.groups()
+
+                    if isinstance(tokens, OptionalLStrip):
+                        # Rule supports lstrip. Match will look like
+                        # text, block type, whitespace control, type, control, ...
+                        text = groups[0]
+
+                        # Skipping the text and first type, every other group is the
+                        # whitespace control for each type. One of the groups will be
+                        # -, +, or empty string instead of None.
+                        strip_sign = next(g for g in groups[2::2] if g is not None)
+
+                        if strip_sign == "-":
+                            # Strip all whitespace between the text and the tag.
+                            stripped = text.rstrip()
+                            newlines_stripped = text[len(stripped) :].count("\n")
+                            groups = (stripped,) + groups[1:]
+                        elif (
+                            # Not marked for preserving whitespace.
+                            strip_sign != "+"
+                            # lstrip is enabled.
+                            and lstrip_unless_re is not None
+                            # Not a variable expression.
+                            and not m.groupdict().get(TOKEN_VARIABLE_BEGIN)
+                        ):
+                            # The start of text between the last newline and the tag.
+                            l_pos = text.rfind("\n") + 1
+                            if l_pos > 0 or line_starting:
+                                # If there's only whitespace between the newline and the
+                                # tag, strip it.
+                                if not lstrip_unless_re.search(text, l_pos):
+                                    groups = (text[:l_pos],) + groups[1:]
+
+                    for idx, token in enumerate(tokens):
+                        # failure group
+                        if token.__class__ is Failure:
+                            raise token(lineno, filename)
+                        # bygroup is a bit more complex, in that case we
+                        # yield for the current token the first named
+                        # group that matched
+                        elif token == "#bygroup":
+                            for key, value in iteritems(m.groupdict()):
+                                if value is not None:
+                                    yield lineno, key, value
+                                    lineno += value.count("\n")
+                                    break
+                            else:
+                                raise RuntimeError(
+                                    "%r wanted to resolve "
+                                    "the token dynamically"
+                                    " but no group matched" % regex
+                                )
+                        # normal group
+                        else:
+                            data = groups[idx]
+                            if data or token not in ignore_if_empty:
+                                yield lineno, token, data
+                            lineno += data.count("\n") + newlines_stripped
+                            newlines_stripped = 0
+
+                # strings as token just are yielded as it.
+                else:
+                    data = m.group()
+                    # update brace/parentheses balance
+                    if tokens == TOKEN_OPERATOR:
+                        if data == "{":
+                            balancing_stack.append("}")
+                        elif data == "(":
+                            balancing_stack.append(")")
+                        elif data == "[":
+                            balancing_stack.append("]")
+                        elif data in ("}", ")", "]"):
+                            if not balancing_stack:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s'" % data, lineno, name, filename
+                                )
+                            expected_op = balancing_stack.pop()
+                            if expected_op != data:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s', "
+                                    "expected '%s'" % (data, expected_op),
+                                    lineno,
+                                    name,
+                                    filename,
+                                )
+                    # yield items
+                    if data or tokens not in ignore_if_empty:
+                        yield lineno, tokens, data
+                    lineno += data.count("\n")
+
+                line_starting = m.group()[-1:] == "\n"
+
+                # fetch new position into new variable so that we can check
+                # if there is a internal parsing error which would result
+                # in an infinite loop
+                pos2 = m.end()
+
+                # handle state changes
+                if new_state is not None:
+                    # remove the uppermost state
+                    if new_state == "#pop":
+                        stack.pop()
+                    # resolve the new state by group checking
+                    elif new_state == "#bygroup":
+                        for key, value in iteritems(m.groupdict()):
+                            if value is not None:
+                                stack.append(key)
+                                break
+                        else:
+                            raise RuntimeError(
+                                "%r wanted to resolve the "
+                                "new state dynamically but"
+                                " no group matched" % regex
+                            )
+                    # direct state name given
+                    else:
+                        stack.append(new_state)
+                    statetokens = self.rules[stack[-1]]
+                # we are still at the same position and no stack change.
+                # this means a loop without break condition, avoid that and
+                # raise error
+                elif pos2 == pos:
+                    raise RuntimeError(
+                        "%r yielded empty string without stack change" % regex
+                    )
+                # publish new function and start again
+                pos = pos2
+                break
+            # if loop terminated without break we haven't found a single match
+            # either we are at the end of the file or we have a problem
+            else:
+                # end of text
+                if pos >= source_length:
+                    return
+                # something went wrong
+                raise TemplateSyntaxError(
+                    "unexpected char %r at %d" % (source[pos], pos),
+                    lineno,
+                    name,
+                    filename,
+                )
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/loaders.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/loaders.py
new file mode 100644
index 0000000000000000000000000000000000000000..457c4b59a72173f726a6aa9e980d2d321ce1e183
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/loaders.py
@@ -0,0 +1,504 @@
+# -*- coding: utf-8 -*-
+"""API and implementations for loading templates from different data
+sources.
+"""
+import os
+import sys
+import weakref
+from hashlib import sha1
+from os import path
+from types import ModuleType
+
+from ._compat import abc
+from ._compat import fspath
+from ._compat import iteritems
+from ._compat import string_types
+from .exceptions import TemplateNotFound
+from .utils import internalcode
+from .utils import open_if_exists
+
+
+def split_template_path(template):
+    """Split a path into segments and perform a sanity check.  If it detects
+    '..' in the path it will raise a `TemplateNotFound` error.
+    """
+    pieces = []
+    for piece in template.split("/"):
+        if (
+            path.sep in piece
+            or (path.altsep and path.altsep in piece)
+            or piece == path.pardir
+        ):
+            raise TemplateNotFound(template)
+        elif piece and piece != ".":
+            pieces.append(piece)
+    return pieces
+
+
+class BaseLoader(object):
+    """Baseclass for all loaders.  Subclass this and override `get_source` to
+    implement a custom loading mechanism.  The environment provides a
+    `get_template` method that calls the loader's `load` method to get the
+    :class:`Template` object.
+
+    A very basic example for a loader that looks up templates on the file
+    system could look like this::
+
+        from jinja2 import BaseLoader, TemplateNotFound
+        from os.path import join, exists, getmtime
+
+        class MyLoader(BaseLoader):
+
+            def __init__(self, path):
+                self.path = path
+
+            def get_source(self, environment, template):
+                path = join(self.path, template)
+                if not exists(path):
+                    raise TemplateNotFound(template)
+                mtime = getmtime(path)
+                with file(path) as f:
+                    source = f.read().decode('utf-8')
+                return source, path, lambda: mtime == getmtime(path)
+    """
+
+    #: if set to `False` it indicates that the loader cannot provide access
+    #: to the source of templates.
+    #:
+    #: .. versionadded:: 2.4
+    has_source_access = True
+
+    def get_source(self, environment, template):
+        """Get the template source, filename and reload helper for a template.
+        It's passed the environment and template name and has to return a
+        tuple in the form ``(source, filename, uptodate)`` or raise a
+        `TemplateNotFound` error if it can't locate the template.
+
+        The source part of the returned tuple must be the source of the
+        template as unicode string or a ASCII bytestring.  The filename should
+        be the name of the file on the filesystem if it was loaded from there,
+        otherwise `None`.  The filename is used by python for the tracebacks
+        if no loader extension is used.
+
+        The last item in the tuple is the `uptodate` function.  If auto
+        reloading is enabled it's always called to check if the template
+        changed.  No arguments are passed so the function must store the
+        old state somewhere (for example in a closure).  If it returns `False`
+        the template will be reloaded.
+        """
+        if not self.has_source_access:
+            raise RuntimeError(
+                "%s cannot provide access to the source" % self.__class__.__name__
+            )
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        """Iterates over all templates.  If the loader does not support that
+        it should raise a :exc:`TypeError` which is the default behavior.
+        """
+        raise TypeError("this loader cannot iterate over all templates")
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        """Loads a template.  This method looks up the template in the cache
+        or loads one by calling :meth:`get_source`.  Subclasses should not
+        override this method as loaders working on collections of other
+        loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
+        will not call this method but `get_source` directly.
+        """
+        code = None
+        if globals is None:
+            globals = {}
+
+        # first we try to get the source for this template together
+        # with the filename and the uptodate function.
+        source, filename, uptodate = self.get_source(environment, name)
+
+        # try to load the code from the bytecode cache if there is a
+        # bytecode cache configured.
+        bcc = environment.bytecode_cache
+        if bcc is not None:
+            bucket = bcc.get_bucket(environment, name, filename, source)
+            code = bucket.code
+
+        # if we don't have code so far (not cached, no longer up to
+        # date) etc. we compile the template
+        if code is None:
+            code = environment.compile(source, name, filename)
+
+        # if the bytecode cache is available and the bucket doesn't
+        # have a code so far, we give the bucket the new code and put
+        # it back to the bytecode cache.
+        if bcc is not None and bucket.code is None:
+            bucket.code = code
+            bcc.set_bucket(bucket)
+
+        return environment.template_class.from_code(
+            environment, code, globals, uptodate
+        )
+
+
+class FileSystemLoader(BaseLoader):
+    """Loads templates from the file system.  This loader can find templates
+    in folders on the file system and is the preferred way to load them.
+
+    The loader takes the path to the templates as string, or if multiple
+    locations are wanted a list of them which is then looked up in the
+    given order::
+
+    >>> loader = FileSystemLoader('/path/to/templates')
+    >>> loader = FileSystemLoader(['/path/to/templates', '/other/path'])
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.
+
+    To follow symbolic links, set the *followlinks* parameter to ``True``::
+
+    >>> loader = FileSystemLoader('/path/to/templates', followlinks=True)
+
+    .. versionchanged:: 2.8
+       The ``followlinks`` parameter was added.
+    """
+
+    def __init__(self, searchpath, encoding="utf-8", followlinks=False):
+        if not isinstance(searchpath, abc.Iterable) or isinstance(
+            searchpath, string_types
+        ):
+            searchpath = [searchpath]
+
+        # In Python 3.5, os.path.join doesn't support Path. This can be
+        # simplified to list(searchpath) when Python 3.5 is dropped.
+        self.searchpath = [fspath(p) for p in searchpath]
+
+        self.encoding = encoding
+        self.followlinks = followlinks
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        for searchpath in self.searchpath:
+            filename = path.join(searchpath, *pieces)
+            f = open_if_exists(filename)
+            if f is None:
+                continue
+            try:
+                contents = f.read().decode(self.encoding)
+            finally:
+                f.close()
+
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+            return contents, filename, uptodate
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        found = set()
+        for searchpath in self.searchpath:
+            walk_dir = os.walk(searchpath, followlinks=self.followlinks)
+            for dirpath, _, filenames in walk_dir:
+                for filename in filenames:
+                    template = (
+                        os.path.join(dirpath, filename)[len(searchpath) :]
+                        .strip(os.path.sep)
+                        .replace(os.path.sep, "/")
+                    )
+                    if template[:2] == "./":
+                        template = template[2:]
+                    if template not in found:
+                        found.add(template)
+        return sorted(found)
+
+
+class PackageLoader(BaseLoader):
+    """Load templates from python eggs or packages.  It is constructed with
+    the name of the python package and the path to the templates in that
+    package::
+
+        loader = PackageLoader('mypackage', 'views')
+
+    If the package path is not given, ``'templates'`` is assumed.
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.  Due to the nature
+    of eggs it's only possible to reload templates if the package was loaded
+    from the file system and not a zip file.
+    """
+
+    def __init__(self, package_name, package_path="templates", encoding="utf-8"):
+        from pkg_resources import DefaultProvider
+        from pkg_resources import get_provider
+        from pkg_resources import ResourceManager
+
+        provider = get_provider(package_name)
+        self.encoding = encoding
+        self.manager = ResourceManager()
+        self.filesystem_bound = isinstance(provider, DefaultProvider)
+        self.provider = provider
+        self.package_path = package_path
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        p = "/".join((self.package_path,) + tuple(pieces))
+
+        if not self.provider.has_resource(p):
+            raise TemplateNotFound(template)
+
+        filename = uptodate = None
+
+        if self.filesystem_bound:
+            filename = self.provider.get_resource_filename(self.manager, p)
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+        source = self.provider.get_resource_string(self.manager, p)
+        return source.decode(self.encoding), filename, uptodate
+
+    def list_templates(self):
+        path = self.package_path
+
+        if path[:2] == "./":
+            path = path[2:]
+        elif path == ".":
+            path = ""
+
+        offset = len(path)
+        results = []
+
+        def _walk(path):
+            for filename in self.provider.resource_listdir(path):
+                fullname = path + "/" + filename
+
+                if self.provider.resource_isdir(fullname):
+                    _walk(fullname)
+                else:
+                    results.append(fullname[offset:].lstrip("/"))
+
+        _walk(path)
+        results.sort()
+        return results
+
+
+class DictLoader(BaseLoader):
+    """Loads a template from a python dict.  It's passed a dict of unicode
+    strings bound to template names.  This loader is useful for unittesting:
+
+    >>> loader = DictLoader({'index.html': 'source here'})
+
+    Because auto reloading is rarely useful this is disabled per default.
+    """
+
+    def __init__(self, mapping):
+        self.mapping = mapping
+
+    def get_source(self, environment, template):
+        if template in self.mapping:
+            source = self.mapping[template]
+            return source, None, lambda: source == self.mapping.get(template)
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        return sorted(self.mapping)
+
+
+class FunctionLoader(BaseLoader):
+    """A loader that is passed a function which does the loading.  The
+    function receives the name of the template and has to return either
+    an unicode string with the template source, a tuple in the form ``(source,
+    filename, uptodatefunc)`` or `None` if the template does not exist.
+
+    >>> def load_template(name):
+    ...     if name == 'index.html':
+    ...         return '...'
+    ...
+    >>> loader = FunctionLoader(load_template)
+
+    The `uptodatefunc` is a function that is called if autoreload is enabled
+    and has to return `True` if the template is still up to date.  For more
+    details have a look at :meth:`BaseLoader.get_source` which has the same
+    return value.
+    """
+
+    def __init__(self, load_func):
+        self.load_func = load_func
+
+    def get_source(self, environment, template):
+        rv = self.load_func(template)
+        if rv is None:
+            raise TemplateNotFound(template)
+        elif isinstance(rv, string_types):
+            return rv, None, None
+        return rv
+
+
+class PrefixLoader(BaseLoader):
+    """A loader that is passed a dict of loaders where each loader is bound
+    to a prefix.  The prefix is delimited from the template by a slash per
+    default, which can be changed by setting the `delimiter` argument to
+    something else::
+
+        loader = PrefixLoader({
+            'app1':     PackageLoader('mypackage.app1'),
+            'app2':     PackageLoader('mypackage.app2')
+        })
+
+    By loading ``'app1/index.html'`` the file from the app1 package is loaded,
+    by loading ``'app2/index.html'`` the file from the second.
+    """
+
+    def __init__(self, mapping, delimiter="/"):
+        self.mapping = mapping
+        self.delimiter = delimiter
+
+    def get_loader(self, template):
+        try:
+            prefix, name = template.split(self.delimiter, 1)
+            loader = self.mapping[prefix]
+        except (ValueError, KeyError):
+            raise TemplateNotFound(template)
+        return loader, name
+
+    def get_source(self, environment, template):
+        loader, name = self.get_loader(template)
+        try:
+            return loader.get_source(environment, name)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        loader, local_name = self.get_loader(name)
+        try:
+            return loader.load(environment, local_name, globals)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(name)
+
+    def list_templates(self):
+        result = []
+        for prefix, loader in iteritems(self.mapping):
+            for template in loader.list_templates():
+                result.append(prefix + self.delimiter + template)
+        return result
+
+
+class ChoiceLoader(BaseLoader):
+    """This loader works like the `PrefixLoader` just that no prefix is
+    specified.  If a template could not be found by one loader the next one
+    is tried.
+
+    >>> loader = ChoiceLoader([
+    ...     FileSystemLoader('/path/to/user/templates'),
+    ...     FileSystemLoader('/path/to/system/templates')
+    ... ])
+
+    This is useful if you want to allow users to override builtin templates
+    from a different location.
+    """
+
+    def __init__(self, loaders):
+        self.loaders = loaders
+
+    def get_source(self, environment, template):
+        for loader in self.loaders:
+            try:
+                return loader.get_source(environment, template)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        for loader in self.loaders:
+            try:
+                return loader.load(environment, name, globals)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(name)
+
+    def list_templates(self):
+        found = set()
+        for loader in self.loaders:
+            found.update(loader.list_templates())
+        return sorted(found)
+
+
+class _TemplateModule(ModuleType):
+    """Like a normal module but with support for weak references"""
+
+
+class ModuleLoader(BaseLoader):
+    """This loader loads templates from precompiled templates.
+
+    Example usage:
+
+    >>> loader = ChoiceLoader([
+    ...     ModuleLoader('/path/to/compiled/templates'),
+    ...     FileSystemLoader('/path/to/templates')
+    ... ])
+
+    Templates can be precompiled with :meth:`Environment.compile_templates`.
+    """
+
+    has_source_access = False
+
+    def __init__(self, path):
+        package_name = "_jinja2_module_templates_%x" % id(self)
+
+        # create a fake module that looks for the templates in the
+        # path given.
+        mod = _TemplateModule(package_name)
+
+        if not isinstance(path, abc.Iterable) or isinstance(path, string_types):
+            path = [path]
+
+        mod.__path__ = [fspath(p) for p in path]
+
+        sys.modules[package_name] = weakref.proxy(
+            mod, lambda x: sys.modules.pop(package_name, None)
+        )
+
+        # the only strong reference, the sys.modules entry is weak
+        # so that the garbage collector can remove it once the
+        # loader that created it goes out of business.
+        self.module = mod
+        self.package_name = package_name
+
+    @staticmethod
+    def get_template_key(name):
+        return "tmpl_" + sha1(name.encode("utf-8")).hexdigest()
+
+    @staticmethod
+    def get_module_filename(name):
+        return ModuleLoader.get_template_key(name) + ".py"
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        key = self.get_template_key(name)
+        module = "%s.%s" % (self.package_name, key)
+        mod = getattr(self.module, module, None)
+        if mod is None:
+            try:
+                mod = __import__(module, None, None, ["root"])
+            except ImportError:
+                raise TemplateNotFound(name)
+
+            # remove the entry from sys.modules, we only want the attribute
+            # on the module object we have stored on the loader.
+            sys.modules.pop(module, None)
+
+        return environment.template_class.from_module_dict(
+            environment, mod.__dict__, globals
+        )
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/meta.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..3795aace59da12815544dfcd5bb9973e196f7a43
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/meta.py
@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*-
+"""Functions that expose information about templates that might be
+interesting for introspection.
+"""
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from .compiler import CodeGenerator
+
+
+class TrackingCodeGenerator(CodeGenerator):
+    """We abuse the code generator for introspection."""
+
+    def __init__(self, environment):
+        CodeGenerator.__init__(self, environment, "<introspection>", "<introspection>")
+        self.undeclared_identifiers = set()
+
+    def write(self, x):
+        """Don't write."""
+
+    def enter_frame(self, frame):
+        """Remember all undeclared identifiers."""
+        CodeGenerator.enter_frame(self, frame)
+        for _, (action, param) in iteritems(frame.symbols.loads):
+            if action == "resolve" and param not in self.environment.globals:
+                self.undeclared_identifiers.add(param)
+
+
+def find_undeclared_variables(ast):
+    """Returns a set of all variables in the AST that will be looked up from
+    the context at runtime.  Because at compile time it's not known which
+    variables will be used depending on the path the execution takes at
+    runtime, all variables are returned.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% set foo = 42 %}{{ bar + foo }}')
+    >>> meta.find_undeclared_variables(ast) == set(['bar'])
+    True
+
+    .. admonition:: Implementation
+
+       Internally the code generator is used for finding undeclared variables.
+       This is good to know because the code generator might raise a
+       :exc:`TemplateAssertionError` during compilation and as a matter of
+       fact this function can currently raise that exception as well.
+    """
+    codegen = TrackingCodeGenerator(ast.environment)
+    codegen.visit(ast)
+    return codegen.undeclared_identifiers
+
+
+def find_referenced_templates(ast):
+    """Finds all the referenced templates from the AST.  This will return an
+    iterator over all the hardcoded template extensions, inclusions and
+    imports.  If dynamic inheritance or inclusion is used, `None` will be
+    yielded.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% extends "layout.html" %}{% include helper %}')
+    >>> list(meta.find_referenced_templates(ast))
+    ['layout.html', None]
+
+    This function is useful for dependency tracking.  For example if you want
+    to rebuild parts of the website after a layout template has changed.
+    """
+    for node in ast.find_all(
+        (nodes.Extends, nodes.FromImport, nodes.Import, nodes.Include)
+    ):
+        if not isinstance(node.template, nodes.Const):
+            # a tuple with some non consts in there
+            if isinstance(node.template, (nodes.Tuple, nodes.List)):
+                for template_name in node.template.items:
+                    # something const, only yield the strings and ignore
+                    # non-string consts that really just make no sense
+                    if isinstance(template_name, nodes.Const):
+                        if isinstance(template_name.value, string_types):
+                            yield template_name.value
+                    # something dynamic in there
+                    else:
+                        yield None
+            # something dynamic we don't know about here
+            else:
+                yield None
+            continue
+        # constant is a basestring, direct template name
+        if isinstance(node.template.value, string_types):
+            yield node.template.value
+        # a tuple or list (latter *should* not happen) made of consts,
+        # yield the consts that are strings.  We could warn here for
+        # non string values
+        elif isinstance(node, nodes.Include) and isinstance(
+            node.template.value, (tuple, list)
+        ):
+            for template_name in node.template.value:
+                if isinstance(template_name, string_types):
+                    yield template_name
+        # something else we don't care about, we could warn here
+        else:
+            yield None
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nativetypes.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nativetypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9ead4e2bbf09b881993b4c7112d83c684604c5c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nativetypes.py
@@ -0,0 +1,94 @@
+from ast import literal_eval
+from itertools import chain
+from itertools import islice
+
+from . import nodes
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import has_safe_repr
+from .environment import Environment
+from .environment import Template
+
+
+def native_concat(nodes):
+    """Return a native Python type from the list of compiled nodes. If
+    the result is a single node, its value is returned. Otherwise, the
+    nodes are concatenated as strings. If the result can be parsed with
+    :func:`ast.literal_eval`, the parsed value is returned. Otherwise,
+    the string is returned.
+
+    :param nodes: Iterable of nodes to concatenate.
+    """
+    head = list(islice(nodes, 2))
+
+    if not head:
+        return None
+
+    if len(head) == 1:
+        raw = head[0]
+    else:
+        raw = u"".join([text_type(v) for v in chain(head, nodes)])
+
+    try:
+        return literal_eval(raw)
+    except (ValueError, SyntaxError, MemoryError):
+        return raw
+
+
+class NativeCodeGenerator(CodeGenerator):
+    """A code generator which renders Python types by not adding
+    ``to_string()`` around output nodes.
+    """
+
+    @staticmethod
+    def _default_finalize(value):
+        return value
+
+    def _output_const_repr(self, group):
+        return repr(u"".join([text_type(v) for v in group]))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        const = node.as_const(frame.eval_ctx)
+
+        if not has_safe_repr(const):
+            raise nodes.Impossible()
+
+        if isinstance(node, nodes.TemplateData):
+            return const
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(")")
+
+
+class NativeEnvironment(Environment):
+    """An environment that renders templates to native Python types."""
+
+    code_generator_class = NativeCodeGenerator
+
+
+class NativeTemplate(Template):
+    environment_class = NativeEnvironment
+
+    def render(self, *args, **kwargs):
+        """Render the template to produce a native Python type. If the
+        result is a single node, its value is returned. Otherwise, the
+        nodes are concatenated as strings. If the result can be parsed
+        with :func:`ast.literal_eval`, the parsed value is returned.
+        Otherwise, the string is returned.
+        """
+        vars = dict(*args, **kwargs)
+
+        try:
+            return native_concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            return self.environment.handle_exception()
+
+
+NativeEnvironment.template_class = NativeTemplate
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nodes.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..95bd614a140a8cd8da3642831650215c7e8ac105
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/nodes.py
@@ -0,0 +1,1088 @@
+# -*- coding: utf-8 -*-
+"""AST nodes generated by the parser for the compiler. Also provides
+some node tree helper functions used by the parser and compiler in order
+to normalize nodes.
+"""
+import operator
+from collections import deque
+
+from markupsafe import Markup
+
+from ._compat import izip
+from ._compat import PY2
+from ._compat import text_type
+from ._compat import with_metaclass
+
+_binop_to_func = {
+    "*": operator.mul,
+    "/": operator.truediv,
+    "//": operator.floordiv,
+    "**": operator.pow,
+    "%": operator.mod,
+    "+": operator.add,
+    "-": operator.sub,
+}
+
+_uaop_to_func = {"not": operator.not_, "+": operator.pos, "-": operator.neg}
+
+_cmpop_to_func = {
+    "eq": operator.eq,
+    "ne": operator.ne,
+    "gt": operator.gt,
+    "gteq": operator.ge,
+    "lt": operator.lt,
+    "lteq": operator.le,
+    "in": lambda a, b: a in b,
+    "notin": lambda a, b: a not in b,
+}
+
+
+class Impossible(Exception):
+    """Raised if the node could not perform a requested action."""
+
+
+class NodeType(type):
+    """A metaclass for nodes that handles the field and attribute
+    inheritance.  fields and attributes from the parent class are
+    automatically forwarded to the child."""
+
+    def __new__(mcs, name, bases, d):
+        for attr in "fields", "attributes":
+            storage = []
+            storage.extend(getattr(bases[0], attr, ()))
+            storage.extend(d.get(attr, ()))
+            assert len(bases) == 1, "multiple inheritance not allowed"
+            assert len(storage) == len(set(storage)), "layout conflict"
+            d[attr] = tuple(storage)
+        d.setdefault("abstract", False)
+        return type.__new__(mcs, name, bases, d)
+
+
+class EvalContext(object):
+    """Holds evaluation time information.  Custom attributes can be attached
+    to it in extensions.
+    """
+
+    def __init__(self, environment, template_name=None):
+        self.environment = environment
+        if callable(environment.autoescape):
+            self.autoescape = environment.autoescape(template_name)
+        else:
+            self.autoescape = environment.autoescape
+        self.volatile = False
+
+    def save(self):
+        return self.__dict__.copy()
+
+    def revert(self, old):
+        self.__dict__.clear()
+        self.__dict__.update(old)
+
+
+def get_eval_context(node, ctx):
+    if ctx is None:
+        if node.environment is None:
+            raise RuntimeError(
+                "if no eval context is passed, the "
+                "node must have an attached "
+                "environment."
+            )
+        return EvalContext(node.environment)
+    return ctx
+
+
+class Node(with_metaclass(NodeType, object)):
+    """Baseclass for all Jinja nodes.  There are a number of nodes available
+    of different types.  There are four major types:
+
+    -   :class:`Stmt`: statements
+    -   :class:`Expr`: expressions
+    -   :class:`Helper`: helper nodes
+    -   :class:`Template`: the outermost wrapper node
+
+    All nodes have fields and attributes.  Fields may be other nodes, lists,
+    or arbitrary values.  Fields are passed to the constructor as regular
+    positional arguments, attributes as keyword arguments.  Each node has
+    two attributes: `lineno` (the line number of the node) and `environment`.
+    The `environment` attribute is set at the end of the parsing process for
+    all nodes automatically.
+    """
+
+    fields = ()
+    attributes = ("lineno", "environment")
+    abstract = True
+
+    def __init__(self, *fields, **attributes):
+        if self.abstract:
+            raise TypeError("abstract nodes are not instantiable")
+        if fields:
+            if len(fields) != len(self.fields):
+                if not self.fields:
+                    raise TypeError("%r takes 0 arguments" % self.__class__.__name__)
+                raise TypeError(
+                    "%r takes 0 or %d argument%s"
+                    % (
+                        self.__class__.__name__,
+                        len(self.fields),
+                        len(self.fields) != 1 and "s" or "",
+                    )
+                )
+            for name, arg in izip(self.fields, fields):
+                setattr(self, name, arg)
+        for attr in self.attributes:
+            setattr(self, attr, attributes.pop(attr, None))
+        if attributes:
+            raise TypeError("unknown attribute %r" % next(iter(attributes)))
+
+    def iter_fields(self, exclude=None, only=None):
+        """This method iterates over all fields that are defined and yields
+        ``(key, value)`` tuples.  Per default all fields are returned, but
+        it's possible to limit that to some fields by providing the `only`
+        parameter or to exclude some using the `exclude` parameter.  Both
+        should be sets or tuples of field names.
+        """
+        for name in self.fields:
+            if (
+                (exclude is only is None)
+                or (exclude is not None and name not in exclude)
+                or (only is not None and name in only)
+            ):
+                try:
+                    yield name, getattr(self, name)
+                except AttributeError:
+                    pass
+
+    def iter_child_nodes(self, exclude=None, only=None):
+        """Iterates over all direct child nodes of the node.  This iterates
+        over all fields and yields the values of they are nodes.  If the value
+        of a field is a list all the nodes in that list are returned.
+        """
+        for _, item in self.iter_fields(exclude, only):
+            if isinstance(item, list):
+                for n in item:
+                    if isinstance(n, Node):
+                        yield n
+            elif isinstance(item, Node):
+                yield item
+
+    def find(self, node_type):
+        """Find the first node of a given type.  If no such node exists the
+        return value is `None`.
+        """
+        for result in self.find_all(node_type):
+            return result
+
+    def find_all(self, node_type):
+        """Find all the nodes of a given type.  If the type is a tuple,
+        the check is performed for any of the tuple items.
+        """
+        for child in self.iter_child_nodes():
+            if isinstance(child, node_type):
+                yield child
+            for result in child.find_all(node_type):
+                yield result
+
+    def set_ctx(self, ctx):
+        """Reset the context of a node and all child nodes.  Per default the
+        parser will all generate nodes that have a 'load' context as it's the
+        most common one.  This method is used in the parser to set assignment
+        targets and other nodes to a store context.
+        """
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "ctx" in node.fields:
+                node.ctx = ctx
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_lineno(self, lineno, override=False):
+        """Set the line numbers of the node and children."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "lineno" in node.attributes:
+                if node.lineno is None or override:
+                    node.lineno = lineno
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_environment(self, environment):
+        """Set the environment for all nodes."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            node.environment = environment
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def __eq__(self, other):
+        return type(self) is type(other) and tuple(self.iter_fields()) == tuple(
+            other.iter_fields()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    # Restore Python 2 hashing behavior on Python 3
+    __hash__ = object.__hash__
+
+    def __repr__(self):
+        return "%s(%s)" % (
+            self.__class__.__name__,
+            ", ".join("%s=%r" % (arg, getattr(self, arg, None)) for arg in self.fields),
+        )
+
+    def dump(self):
+        def _dump(node):
+            if not isinstance(node, Node):
+                buf.append(repr(node))
+                return
+
+            buf.append("nodes.%s(" % node.__class__.__name__)
+            if not node.fields:
+                buf.append(")")
+                return
+            for idx, field in enumerate(node.fields):
+                if idx:
+                    buf.append(", ")
+                value = getattr(node, field)
+                if isinstance(value, list):
+                    buf.append("[")
+                    for idx, item in enumerate(value):
+                        if idx:
+                            buf.append(", ")
+                        _dump(item)
+                    buf.append("]")
+                else:
+                    _dump(value)
+            buf.append(")")
+
+        buf = []
+        _dump(self)
+        return "".join(buf)
+
+
+class Stmt(Node):
+    """Base node for all statements."""
+
+    abstract = True
+
+
+class Helper(Node):
+    """Nodes that exist in a specific context only."""
+
+    abstract = True
+
+
+class Template(Node):
+    """Node that represents a template.  This must be the outermost node that
+    is passed to the compiler.
+    """
+
+    fields = ("body",)
+
+
+class Output(Stmt):
+    """A node that holds multiple expressions which are then printed out.
+    This is used both for the `print` statement and the regular template data.
+    """
+
+    fields = ("nodes",)
+
+
+class Extends(Stmt):
+    """Represents an extends statement."""
+
+    fields = ("template",)
+
+
+class For(Stmt):
+    """The for loop.  `target` is the target for the iteration (usually a
+    :class:`Name` or :class:`Tuple`), `iter` the iterable.  `body` is a list
+    of nodes that are used as loop-body, and `else_` a list of nodes for the
+    `else` block.  If no else node exists it has to be an empty list.
+
+    For filtered nodes an expression can be stored as `test`, otherwise `None`.
+    """
+
+    fields = ("target", "iter", "body", "else_", "test", "recursive")
+
+
+class If(Stmt):
+    """If `test` is true, `body` is rendered, else `else_`."""
+
+    fields = ("test", "body", "elif_", "else_")
+
+
+class Macro(Stmt):
+    """A macro definition.  `name` is the name of the macro, `args` a list of
+    arguments and `defaults` a list of defaults if there are any.  `body` is
+    a list of nodes for the macro body.
+    """
+
+    fields = ("name", "args", "defaults", "body")
+
+
+class CallBlock(Stmt):
+    """Like a macro without a name but a call instead.  `call` is called with
+    the unnamed macro as `caller` argument this node holds.
+    """
+
+    fields = ("call", "args", "defaults", "body")
+
+
+class FilterBlock(Stmt):
+    """Node for filter sections."""
+
+    fields = ("body", "filter")
+
+
+class With(Stmt):
+    """Specific node for with statements.  In older versions of Jinja the
+    with statement was implemented on the base of the `Scope` node instead.
+
+    .. versionadded:: 2.9.3
+    """
+
+    fields = ("targets", "values", "body")
+
+
+class Block(Stmt):
+    """A node that represents a block."""
+
+    fields = ("name", "body", "scoped")
+
+
+class Include(Stmt):
+    """A node that represents the include tag."""
+
+    fields = ("template", "with_context", "ignore_missing")
+
+
+class Import(Stmt):
+    """A node that represents the import tag."""
+
+    fields = ("template", "target", "with_context")
+
+
+class FromImport(Stmt):
+    """A node that represents the from import tag.  It's important to not
+    pass unsafe names to the name attribute.  The compiler translates the
+    attribute lookups directly into getattr calls and does *not* use the
+    subscript callback of the interface.  As exported variables may not
+    start with double underscores (which the parser asserts) this is not a
+    problem for regular Jinja code, but if this node is used in an extension
+    extra care must be taken.
+
+    The list of names may contain tuples if aliases are wanted.
+    """
+
+    fields = ("template", "names", "with_context")
+
+
+class ExprStmt(Stmt):
+    """A statement that evaluates an expression and discards the result."""
+
+    fields = ("node",)
+
+
+class Assign(Stmt):
+    """Assigns an expression to a target."""
+
+    fields = ("target", "node")
+
+
+class AssignBlock(Stmt):
+    """Assigns a block to a target."""
+
+    fields = ("target", "filter", "body")
+
+
+class Expr(Node):
+    """Baseclass for all expressions."""
+
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        """Return the value of the expression as constant or raise
+        :exc:`Impossible` if this was not possible.
+
+        An :class:`EvalContext` can be provided, if none is given
+        a default context is created which requires the nodes to have
+        an attached environment.
+
+        .. versionchanged:: 2.4
+           the `eval_ctx` parameter was added.
+        """
+        raise Impossible()
+
+    def can_assign(self):
+        """Check if it's possible to assign something to this node."""
+        return False
+
+
+class BinExpr(Expr):
+    """Baseclass for all binary expressions."""
+
+    fields = ("left", "right")
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_binops
+        ):
+            raise Impossible()
+        f = _binop_to_func[self.operator]
+        try:
+            return f(self.left.as_const(eval_ctx), self.right.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class UnaryExpr(Expr):
+    """Baseclass for all unary expressions."""
+
+    fields = ("node",)
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_unops
+        ):
+            raise Impossible()
+        f = _uaop_to_func[self.operator]
+        try:
+            return f(self.node.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class Name(Expr):
+    """Looks up a name or stores a value in a name.
+    The `ctx` of the node can be one of the following values:
+
+    -   `store`: store a value in the name
+    -   `load`: load that name
+    -   `param`: like `store` but if the name was defined as function parameter.
+    """
+
+    fields = ("name", "ctx")
+
+    def can_assign(self):
+        return self.name not in ("true", "false", "none", "True", "False", "None")
+
+
+class NSRef(Expr):
+    """Reference to a namespace value assignment"""
+
+    fields = ("name", "attr")
+
+    def can_assign(self):
+        # We don't need any special checks here; NSRef assignments have a
+        # runtime check to ensure the target is a namespace object which will
+        # have been checked already as it is created using a normal assignment
+        # which goes through a `Name` node.
+        return True
+
+
+class Literal(Expr):
+    """Baseclass for literals."""
+
+    abstract = True
+
+
+class Const(Literal):
+    """All constant values.  The parser will return this node for simple
+    constants such as ``42`` or ``"foo"`` but it can be used to store more
+    complex values such as lists too.  Only constants with a safe
+    representation (objects where ``eval(repr(x)) == x`` is true).
+    """
+
+    fields = ("value",)
+
+    def as_const(self, eval_ctx=None):
+        rv = self.value
+        if (
+            PY2
+            and type(rv) is text_type
+            and self.environment.policies["compiler.ascii_str"]
+        ):
+            try:
+                rv = rv.encode("ascii")
+            except UnicodeError:
+                pass
+        return rv
+
+    @classmethod
+    def from_untrusted(cls, value, lineno=None, environment=None):
+        """Return a const object if the value is representable as
+        constant value in the generated code, otherwise it will raise
+        an `Impossible` exception.
+        """
+        from .compiler import has_safe_repr
+
+        if not has_safe_repr(value):
+            raise Impossible()
+        return cls(value, lineno=lineno, environment=environment)
+
+
+class TemplateData(Literal):
+    """A constant template string."""
+
+    fields = ("data",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        if eval_ctx.autoescape:
+            return Markup(self.data)
+        return self.data
+
+
+class Tuple(Literal):
+    """For loop unpacking and some other things like multiple arguments
+    for subscripts.  Like for :class:`Name` `ctx` specifies if the tuple
+    is used for loading the names or storing.
+    """
+
+    fields = ("items", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return tuple(x.as_const(eval_ctx) for x in self.items)
+
+    def can_assign(self):
+        for item in self.items:
+            if not item.can_assign():
+                return False
+        return True
+
+
+class List(Literal):
+    """Any list literal such as ``[1, 2, 3]``"""
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return [x.as_const(eval_ctx) for x in self.items]
+
+
+class Dict(Literal):
+    """Any dict literal such as ``{1: 2, 3: 4}``.  The items must be a list of
+    :class:`Pair` nodes.
+    """
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return dict(x.as_const(eval_ctx) for x in self.items)
+
+
+class Pair(Helper):
+    """A key, value pair for dicts."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key.as_const(eval_ctx), self.value.as_const(eval_ctx)
+
+
+class Keyword(Helper):
+    """A key, value pair for keyword arguments where key is a string."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key, self.value.as_const(eval_ctx)
+
+
+class CondExpr(Expr):
+    """A conditional expression (inline if expression).  (``{{
+    foo if bar else baz }}``)
+    """
+
+    fields = ("test", "expr1", "expr2")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.test.as_const(eval_ctx):
+            return self.expr1.as_const(eval_ctx)
+
+        # if we evaluate to an undefined object, we better do that at runtime
+        if self.expr2 is None:
+            raise Impossible()
+
+        return self.expr2.as_const(eval_ctx)
+
+
+def args_as_const(node, eval_ctx):
+    args = [x.as_const(eval_ctx) for x in node.args]
+    kwargs = dict(x.as_const(eval_ctx) for x in node.kwargs)
+
+    if node.dyn_args is not None:
+        try:
+            args.extend(node.dyn_args.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    if node.dyn_kwargs is not None:
+        try:
+            kwargs.update(node.dyn_kwargs.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    return args, kwargs
+
+
+class Filter(Expr):
+    """This node applies a filter on an expression.  `name` is the name of
+    the filter, the rest of the fields are the same as for :class:`Call`.
+
+    If the `node` of a filter is `None` the contents of the last buffer are
+    filtered.  Buffers are created by macros and filter blocks.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        if eval_ctx.volatile or self.node is None:
+            raise Impossible()
+
+        # we have to be careful here because we call filter_ below.
+        # if this variable would be called filter, 2to3 would wrap the
+        # call in a list because it is assuming we are talking about the
+        # builtin filter function here which no longer returns a list in
+        # python 3.  because of that, do not rename filter_ to filter!
+        filter_ = self.environment.filters.get(self.name)
+
+        if filter_ is None or getattr(filter_, "contextfilter", False) is True:
+            raise Impossible()
+
+        # We cannot constant handle async filters, so we need to make sure
+        # to not go down this path.
+        if eval_ctx.environment.is_async and getattr(
+            filter_, "asyncfiltervariant", False
+        ):
+            raise Impossible()
+
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        if getattr(filter_, "evalcontextfilter", False) is True:
+            args.insert(0, eval_ctx)
+        elif getattr(filter_, "environmentfilter", False) is True:
+            args.insert(0, self.environment)
+
+        try:
+            return filter_(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Test(Expr):
+    """Applies a test on an expression.  `name` is the name of the test, the
+    rest of the fields are the same as for :class:`Call`.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        test = self.environment.tests.get(self.name)
+
+        if test is None:
+            raise Impossible()
+
+        eval_ctx = get_eval_context(self, eval_ctx)
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        try:
+            return test(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Call(Expr):
+    """Calls an expression.  `args` is a list of arguments, `kwargs` a list
+    of keyword arguments (list of :class:`Keyword` nodes), and `dyn_args`
+    and `dyn_kwargs` has to be either `None` or a node that is used as
+    node for dynamic positional (``*args``) or keyword (``**kwargs``)
+    arguments.
+    """
+
+    fields = ("node", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+
+class Getitem(Expr):
+    """Get an attribute or item from an expression and prefer the item."""
+
+    fields = ("node", "arg", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            return self.environment.getitem(
+                self.node.as_const(eval_ctx), self.arg.as_const(eval_ctx)
+            )
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Getattr(Expr):
+    """Get an attribute or item from an expression that is a ascii-only
+    bytestring and prefer the attribute.
+    """
+
+    fields = ("node", "attr", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            eval_ctx = get_eval_context(self, eval_ctx)
+            return self.environment.getattr(self.node.as_const(eval_ctx), self.attr)
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Slice(Expr):
+    """Represents a slice object.  This must only be used as argument for
+    :class:`Subscript`.
+    """
+
+    fields = ("start", "stop", "step")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        def const(obj):
+            if obj is None:
+                return None
+            return obj.as_const(eval_ctx)
+
+        return slice(const(self.start), const(self.stop), const(self.step))
+
+
+class Concat(Expr):
+    """Concatenates the list of expressions provided after converting them to
+    unicode.
+    """
+
+    fields = ("nodes",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return "".join(text_type(x.as_const(eval_ctx)) for x in self.nodes)
+
+
+class Compare(Expr):
+    """Compares an expression with some other expressions.  `ops` must be a
+    list of :class:`Operand`\\s.
+    """
+
+    fields = ("expr", "ops")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        result = value = self.expr.as_const(eval_ctx)
+
+        try:
+            for op in self.ops:
+                new_value = op.expr.as_const(eval_ctx)
+                result = _cmpop_to_func[op.op](value, new_value)
+
+                if not result:
+                    return False
+
+                value = new_value
+        except Exception:
+            raise Impossible()
+
+        return result
+
+
+class Operand(Helper):
+    """Holds an operator and an expression."""
+
+    fields = ("op", "expr")
+
+
+if __debug__:
+    Operand.__doc__ += "\nThe following operators are available: " + ", ".join(
+        sorted(
+            "``%s``" % x
+            for x in set(_binop_to_func) | set(_uaop_to_func) | set(_cmpop_to_func)
+        )
+    )
+
+
+class Mul(BinExpr):
+    """Multiplies the left with the right node."""
+
+    operator = "*"
+
+
+class Div(BinExpr):
+    """Divides the left by the right node."""
+
+    operator = "/"
+
+
+class FloorDiv(BinExpr):
+    """Divides the left by the right node and truncates conver the
+    result into an integer by truncating.
+    """
+
+    operator = "//"
+
+
+class Add(BinExpr):
+    """Add the left to the right node."""
+
+    operator = "+"
+
+
+class Sub(BinExpr):
+    """Subtract the right from the left node."""
+
+    operator = "-"
+
+
+class Mod(BinExpr):
+    """Left modulo right."""
+
+    operator = "%"
+
+
+class Pow(BinExpr):
+    """Left to the power of right."""
+
+    operator = "**"
+
+
+class And(BinExpr):
+    """Short circuited AND."""
+
+    operator = "and"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) and self.right.as_const(eval_ctx)
+
+
+class Or(BinExpr):
+    """Short circuited OR."""
+
+    operator = "or"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) or self.right.as_const(eval_ctx)
+
+
+class Not(UnaryExpr):
+    """Negate the expression."""
+
+    operator = "not"
+
+
+class Neg(UnaryExpr):
+    """Make the expression negative."""
+
+    operator = "-"
+
+
+class Pos(UnaryExpr):
+    """Make the expression positive (noop for most expressions)"""
+
+    operator = "+"
+
+
+# Helpers for extensions
+
+
+class EnvironmentAttribute(Expr):
+    """Loads an attribute from the environment object.  This is useful for
+    extensions that want to call a callback stored on the environment.
+    """
+
+    fields = ("name",)
+
+
+class ExtensionAttribute(Expr):
+    """Returns the attribute of an extension bound to the environment.
+    The identifier is the identifier of the :class:`Extension`.
+
+    This node is usually constructed by calling the
+    :meth:`~jinja2.ext.Extension.attr` method on an extension.
+    """
+
+    fields = ("identifier", "name")
+
+
+class ImportedName(Expr):
+    """If created with an import name the import name is returned on node
+    access.  For example ``ImportedName('cgi.escape')`` returns the `escape`
+    function from the cgi module on evaluation.  Imports are optimized by the
+    compiler so there is no need to assign them to local variables.
+    """
+
+    fields = ("importname",)
+
+
+class InternalName(Expr):
+    """An internal name in the compiler.  You cannot create these nodes
+    yourself but the parser provides a
+    :meth:`~jinja2.parser.Parser.free_identifier` method that creates
+    a new identifier for you.  This identifier is not available from the
+    template and is not threated specially by the compiler.
+    """
+
+    fields = ("name",)
+
+    def __init__(self):
+        raise TypeError(
+            "Can't create internal names.  Use the "
+            "`free_identifier` method on a parser."
+        )
+
+
+class MarkSafe(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`)."""
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return Markup(self.expr.as_const(eval_ctx))
+
+
+class MarkSafeIfAutoescape(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`) but
+    only if autoescaping is active.
+
+    .. versionadded:: 2.5
+    """
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        expr = self.expr.as_const(eval_ctx)
+        if eval_ctx.autoescape:
+            return Markup(expr)
+        return expr
+
+
+class ContextReference(Expr):
+    """Returns the current template context.  It can be used like a
+    :class:`Name` node, with a ``'load'`` ctx and will return the
+    current :class:`~jinja2.runtime.Context` object.
+
+    Here an example that assigns the current template name to a
+    variable named `foo`::
+
+        Assign(Name('foo', ctx='store'),
+               Getattr(ContextReference(), 'name'))
+
+    This is basically equivalent to using the
+    :func:`~jinja2.contextfunction` decorator when using the
+    high-level API, which causes a reference to the context to be passed
+    as the first argument to a function.
+    """
+
+
+class DerivedContextReference(Expr):
+    """Return the current template context including locals. Behaves
+    exactly like :class:`ContextReference`, but includes local
+    variables, such as from a ``for`` loop.
+
+    .. versionadded:: 2.11
+    """
+
+
+class Continue(Stmt):
+    """Continue a loop."""
+
+
+class Break(Stmt):
+    """Break a loop."""
+
+
+class Scope(Stmt):
+    """An artificial scope."""
+
+    fields = ("body",)
+
+
+class OverlayScope(Stmt):
+    """An overlay scope for extensions.  This is a largely unoptimized scope
+    that however can be used to introduce completely arbitrary variables into
+    a sub scope from a dictionary or dictionary like object.  The `context`
+    field has to evaluate to a dictionary object.
+
+    Example usage::
+
+        OverlayScope(context=self.call_method('get_context'),
+                     body=[...])
+
+    .. versionadded:: 2.10
+    """
+
+    fields = ("context", "body")
+
+
+class EvalContextModifier(Stmt):
+    """Modifies the eval context.  For each option that should be modified,
+    a :class:`Keyword` has to be added to the :attr:`options` list.
+
+    Example to change the `autoescape` setting::
+
+        EvalContextModifier(options=[Keyword('autoescape', Const(True))])
+    """
+
+    fields = ("options",)
+
+
+class ScopedEvalContextModifier(EvalContextModifier):
+    """Modifies the eval context and reverts it later.  Works exactly like
+    :class:`EvalContextModifier` but will only modify the
+    :class:`~jinja2.nodes.EvalContext` for nodes in the :attr:`body`.
+    """
+
+    fields = ("body",)
+
+
+# make sure nobody creates custom nodes
+def _failing_new(*args, **kwargs):
+    raise TypeError("can't create custom node types")
+
+
+NodeType.__new__ = staticmethod(_failing_new)
+del _failing_new
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/optimizer.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/optimizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bc78c4524ab59dd7218cfe5f23b5de29a4a170c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/optimizer.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""The optimizer tries to constant fold expressions and modify the AST
+in place so that it should be faster to evaluate.
+
+Because the AST does not contain all the scoping information and the
+compiler has to find that out, we cannot do all the optimizations we
+want. For example, loop unrolling doesn't work because unrolled loops
+would have a different scope. The solution would be a second syntax tree
+that stored the scoping rules.
+"""
+from . import nodes
+from .visitor import NodeTransformer
+
+
+def optimize(node, environment):
+    """The context hint can be used to perform an static optimization
+    based on the context given."""
+    optimizer = Optimizer(environment)
+    return optimizer.visit(node)
+
+
+class Optimizer(NodeTransformer):
+    def __init__(self, environment):
+        self.environment = environment
+
+    def generic_visit(self, node, *args, **kwargs):
+        node = super(Optimizer, self).generic_visit(node, *args, **kwargs)
+
+        # Do constant folding. Some other nodes besides Expr have
+        # as_const, but folding them causes errors later on.
+        if isinstance(node, nodes.Expr):
+            try:
+                return nodes.Const.from_untrusted(
+                    node.as_const(args[0] if args else None),
+                    lineno=node.lineno,
+                    environment=self.environment,
+                )
+            except nodes.Impossible:
+                pass
+
+        return node
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/parser.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5881066f7461b01291067f19c356d39dc75d38b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/parser.py
@@ -0,0 +1,939 @@
+# -*- coding: utf-8 -*-
+"""Parse tokens from the lexer into nodes for the compiler."""
+from . import nodes
+from ._compat import imap
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .lexer import describe_token
+from .lexer import describe_token_expr
+
+_statement_keywords = frozenset(
+    [
+        "for",
+        "if",
+        "block",
+        "extends",
+        "print",
+        "macro",
+        "include",
+        "from",
+        "import",
+        "set",
+        "with",
+        "autoescape",
+    ]
+)
+_compare_operators = frozenset(["eq", "ne", "lt", "lteq", "gt", "gteq"])
+
+_math_nodes = {
+    "add": nodes.Add,
+    "sub": nodes.Sub,
+    "mul": nodes.Mul,
+    "div": nodes.Div,
+    "floordiv": nodes.FloorDiv,
+    "mod": nodes.Mod,
+}
+
+
+class Parser(object):
+    """This is the central parsing class Jinja uses.  It's passed to
+    extensions and can be used to parse expressions or statements.
+    """
+
+    def __init__(self, environment, source, name=None, filename=None, state=None):
+        self.environment = environment
+        self.stream = environment._tokenize(source, name, filename, state)
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.extensions = {}
+        for extension in environment.iter_extensions():
+            for tag in extension.tags:
+                self.extensions[tag] = extension.parse
+        self._last_identifier = 0
+        self._tag_stack = []
+        self._end_token_stack = []
+
+    def fail(self, msg, lineno=None, exc=TemplateSyntaxError):
+        """Convenience method that raises `exc` with the message, passed
+        line number or last line number as well as the current name and
+        filename.
+        """
+        if lineno is None:
+            lineno = self.stream.current.lineno
+        raise exc(msg, lineno, self.name, self.filename)
+
+    def _fail_ut_eof(self, name, end_token_stack, lineno):
+        expected = []
+        for exprs in end_token_stack:
+            expected.extend(imap(describe_token_expr, exprs))
+        if end_token_stack:
+            currently_looking = " or ".join(
+                "'%s'" % describe_token_expr(expr) for expr in end_token_stack[-1]
+            )
+        else:
+            currently_looking = None
+
+        if name is None:
+            message = ["Unexpected end of template."]
+        else:
+            message = ["Encountered unknown tag '%s'." % name]
+
+        if currently_looking:
+            if name is not None and name in expected:
+                message.append(
+                    "You probably made a nesting mistake. Jinja "
+                    "is expecting this tag, but currently looking "
+                    "for %s." % currently_looking
+                )
+            else:
+                message.append(
+                    "Jinja was looking for the following tags: "
+                    "%s." % currently_looking
+                )
+
+        if self._tag_stack:
+            message.append(
+                "The innermost block that needs to be "
+                "closed is '%s'." % self._tag_stack[-1]
+            )
+
+        self.fail(" ".join(message), lineno)
+
+    def fail_unknown_tag(self, name, lineno=None):
+        """Called if the parser encounters an unknown tag.  Tries to fail
+        with a human readable error message that could help to identify
+        the problem.
+        """
+        return self._fail_ut_eof(name, self._end_token_stack, lineno)
+
+    def fail_eof(self, end_tokens=None, lineno=None):
+        """Like fail_unknown_tag but for end of template situations."""
+        stack = list(self._end_token_stack)
+        if end_tokens is not None:
+            stack.append(end_tokens)
+        return self._fail_ut_eof(None, stack, lineno)
+
+    def is_tuple_end(self, extra_end_rules=None):
+        """Are we at the end of a tuple?"""
+        if self.stream.current.type in ("variable_end", "block_end", "rparen"):
+            return True
+        elif extra_end_rules is not None:
+            return self.stream.current.test_any(extra_end_rules)
+        return False
+
+    def free_identifier(self, lineno=None):
+        """Return a new free identifier as :class:`~jinja2.nodes.InternalName`."""
+        self._last_identifier += 1
+        rv = object.__new__(nodes.InternalName)
+        nodes.Node.__init__(rv, "fi%d" % self._last_identifier, lineno=lineno)
+        return rv
+
+    def parse_statement(self):
+        """Parse a single statement."""
+        token = self.stream.current
+        if token.type != "name":
+            self.fail("tag name expected", token.lineno)
+        self._tag_stack.append(token.value)
+        pop_tag = True
+        try:
+            if token.value in _statement_keywords:
+                return getattr(self, "parse_" + self.stream.current.value)()
+            if token.value == "call":
+                return self.parse_call_block()
+            if token.value == "filter":
+                return self.parse_filter_block()
+            ext = self.extensions.get(token.value)
+            if ext is not None:
+                return ext(self)
+
+            # did not work out, remove the token we pushed by accident
+            # from the stack so that the unknown tag fail function can
+            # produce a proper error message.
+            self._tag_stack.pop()
+            pop_tag = False
+            self.fail_unknown_tag(token.value, token.lineno)
+        finally:
+            if pop_tag:
+                self._tag_stack.pop()
+
+    def parse_statements(self, end_tokens, drop_needle=False):
+        """Parse multiple statements into a list until one of the end tokens
+        is reached.  This is used to parse the body of statements as it also
+        parses template data if appropriate.  The parser checks first if the
+        current token is a colon and skips it if there is one.  Then it checks
+        for the block end and parses until if one of the `end_tokens` is
+        reached.  Per default the active token in the stream at the end of
+        the call is the matched end token.  If this is not wanted `drop_needle`
+        can be set to `True` and the end token is removed.
+        """
+        # the first token may be a colon for python compatibility
+        self.stream.skip_if("colon")
+
+        # in the future it would be possible to add whole code sections
+        # by adding some sort of end of statement token and parsing those here.
+        self.stream.expect("block_end")
+        result = self.subparse(end_tokens)
+
+        # we reached the end of the template too early, the subparser
+        # does not check for this, so we do that now
+        if self.stream.current.type == "eof":
+            self.fail_eof(end_tokens)
+
+        if drop_needle:
+            next(self.stream)
+        return result
+
+    def parse_set(self):
+        """Parse an assign statement."""
+        lineno = next(self.stream).lineno
+        target = self.parse_assign_target(with_namespace=True)
+        if self.stream.skip_if("assign"):
+            expr = self.parse_tuple()
+            return nodes.Assign(target, expr, lineno=lineno)
+        filter_node = self.parse_filter(None)
+        body = self.parse_statements(("name:endset",), drop_needle=True)
+        return nodes.AssignBlock(target, filter_node, body, lineno=lineno)
+
+    def parse_for(self):
+        """Parse a for loop."""
+        lineno = self.stream.expect("name:for").lineno
+        target = self.parse_assign_target(extra_end_rules=("name:in",))
+        self.stream.expect("name:in")
+        iter = self.parse_tuple(
+            with_condexpr=False, extra_end_rules=("name:recursive",)
+        )
+        test = None
+        if self.stream.skip_if("name:if"):
+            test = self.parse_expression()
+        recursive = self.stream.skip_if("name:recursive")
+        body = self.parse_statements(("name:endfor", "name:else"))
+        if next(self.stream).value == "endfor":
+            else_ = []
+        else:
+            else_ = self.parse_statements(("name:endfor",), drop_needle=True)
+        return nodes.For(target, iter, body, else_, test, recursive, lineno=lineno)
+
+    def parse_if(self):
+        """Parse an if construct."""
+        node = result = nodes.If(lineno=self.stream.expect("name:if").lineno)
+        while 1:
+            node.test = self.parse_tuple(with_condexpr=False)
+            node.body = self.parse_statements(("name:elif", "name:else", "name:endif"))
+            node.elif_ = []
+            node.else_ = []
+            token = next(self.stream)
+            if token.test("name:elif"):
+                node = nodes.If(lineno=self.stream.current.lineno)
+                result.elif_.append(node)
+                continue
+            elif token.test("name:else"):
+                result.else_ = self.parse_statements(("name:endif",), drop_needle=True)
+            break
+        return result
+
+    def parse_with(self):
+        node = nodes.With(lineno=next(self.stream).lineno)
+        targets = []
+        values = []
+        while self.stream.current.type != "block_end":
+            if targets:
+                self.stream.expect("comma")
+            target = self.parse_assign_target()
+            target.set_ctx("param")
+            targets.append(target)
+            self.stream.expect("assign")
+            values.append(self.parse_expression())
+        node.targets = targets
+        node.values = values
+        node.body = self.parse_statements(("name:endwith",), drop_needle=True)
+        return node
+
+    def parse_autoescape(self):
+        node = nodes.ScopedEvalContextModifier(lineno=next(self.stream).lineno)
+        node.options = [nodes.Keyword("autoescape", self.parse_expression())]
+        node.body = self.parse_statements(("name:endautoescape",), drop_needle=True)
+        return nodes.Scope([node])
+
+    def parse_block(self):
+        node = nodes.Block(lineno=next(self.stream).lineno)
+        node.name = self.stream.expect("name").value
+        node.scoped = self.stream.skip_if("name:scoped")
+
+        # common problem people encounter when switching from django
+        # to jinja.  we do not support hyphens in block names, so let's
+        # raise a nicer error message in that case.
+        if self.stream.current.type == "sub":
+            self.fail(
+                "Block names in Jinja have to be valid Python "
+                "identifiers and may not contain hyphens, use an "
+                "underscore instead."
+            )
+
+        node.body = self.parse_statements(("name:endblock",), drop_needle=True)
+        self.stream.skip_if("name:" + node.name)
+        return node
+
+    def parse_extends(self):
+        node = nodes.Extends(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        return node
+
+    def parse_import_context(self, node, default):
+        if self.stream.current.test_any(
+            "name:with", "name:without"
+        ) and self.stream.look().test("name:context"):
+            node.with_context = next(self.stream).value == "with"
+            self.stream.skip()
+        else:
+            node.with_context = default
+        return node
+
+    def parse_include(self):
+        node = nodes.Include(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        if self.stream.current.test("name:ignore") and self.stream.look().test(
+            "name:missing"
+        ):
+            node.ignore_missing = True
+            self.stream.skip(2)
+        else:
+            node.ignore_missing = False
+        return self.parse_import_context(node, True)
+
+    def parse_import(self):
+        node = nodes.Import(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:as")
+        node.target = self.parse_assign_target(name_only=True).name
+        return self.parse_import_context(node, False)
+
+    def parse_from(self):
+        node = nodes.FromImport(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:import")
+        node.names = []
+
+        def parse_context():
+            if self.stream.current.value in (
+                "with",
+                "without",
+            ) and self.stream.look().test("name:context"):
+                node.with_context = next(self.stream).value == "with"
+                self.stream.skip()
+                return True
+            return False
+
+        while 1:
+            if node.names:
+                self.stream.expect("comma")
+            if self.stream.current.type == "name":
+                if parse_context():
+                    break
+                target = self.parse_assign_target(name_only=True)
+                if target.name.startswith("_"):
+                    self.fail(
+                        "names starting with an underline can not be imported",
+                        target.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                if self.stream.skip_if("name:as"):
+                    alias = self.parse_assign_target(name_only=True)
+                    node.names.append((target.name, alias.name))
+                else:
+                    node.names.append(target.name)
+                if parse_context() or self.stream.current.type != "comma":
+                    break
+            else:
+                self.stream.expect("name")
+        if not hasattr(node, "with_context"):
+            node.with_context = False
+        return node
+
+    def parse_signature(self, node):
+        node.args = args = []
+        node.defaults = defaults = []
+        self.stream.expect("lparen")
+        while self.stream.current.type != "rparen":
+            if args:
+                self.stream.expect("comma")
+            arg = self.parse_assign_target(name_only=True)
+            arg.set_ctx("param")
+            if self.stream.skip_if("assign"):
+                defaults.append(self.parse_expression())
+            elif defaults:
+                self.fail("non-default argument follows default argument")
+            args.append(arg)
+        self.stream.expect("rparen")
+
+    def parse_call_block(self):
+        node = nodes.CallBlock(lineno=next(self.stream).lineno)
+        if self.stream.current.type == "lparen":
+            self.parse_signature(node)
+        else:
+            node.args = []
+            node.defaults = []
+
+        node.call = self.parse_expression()
+        if not isinstance(node.call, nodes.Call):
+            self.fail("expected call", node.lineno)
+        node.body = self.parse_statements(("name:endcall",), drop_needle=True)
+        return node
+
+    def parse_filter_block(self):
+        node = nodes.FilterBlock(lineno=next(self.stream).lineno)
+        node.filter = self.parse_filter(None, start_inline=True)
+        node.body = self.parse_statements(("name:endfilter",), drop_needle=True)
+        return node
+
+    def parse_macro(self):
+        node = nodes.Macro(lineno=next(self.stream).lineno)
+        node.name = self.parse_assign_target(name_only=True).name
+        self.parse_signature(node)
+        node.body = self.parse_statements(("name:endmacro",), drop_needle=True)
+        return node
+
+    def parse_print(self):
+        node = nodes.Output(lineno=next(self.stream).lineno)
+        node.nodes = []
+        while self.stream.current.type != "block_end":
+            if node.nodes:
+                self.stream.expect("comma")
+            node.nodes.append(self.parse_expression())
+        return node
+
+    def parse_assign_target(
+        self,
+        with_tuple=True,
+        name_only=False,
+        extra_end_rules=None,
+        with_namespace=False,
+    ):
+        """Parse an assignment target.  As Jinja allows assignments to
+        tuples, this function can parse all allowed assignment targets.  Per
+        default assignments to tuples are parsed, that can be disable however
+        by setting `with_tuple` to `False`.  If only assignments to names are
+        wanted `name_only` can be set to `True`.  The `extra_end_rules`
+        parameter is forwarded to the tuple parsing function.  If
+        `with_namespace` is enabled, a namespace assignment may be parsed.
+        """
+        if with_namespace and self.stream.look().type == "dot":
+            token = self.stream.expect("name")
+            next(self.stream)  # dot
+            attr = self.stream.expect("name")
+            target = nodes.NSRef(token.value, attr.value, lineno=token.lineno)
+        elif name_only:
+            token = self.stream.expect("name")
+            target = nodes.Name(token.value, "store", lineno=token.lineno)
+        else:
+            if with_tuple:
+                target = self.parse_tuple(
+                    simplified=True, extra_end_rules=extra_end_rules
+                )
+            else:
+                target = self.parse_primary()
+            target.set_ctx("store")
+        if not target.can_assign():
+            self.fail(
+                "can't assign to %r" % target.__class__.__name__.lower(), target.lineno
+            )
+        return target
+
+    def parse_expression(self, with_condexpr=True):
+        """Parse an expression.  Per default all expressions are parsed, if
+        the optional `with_condexpr` parameter is set to `False` conditional
+        expressions are not parsed.
+        """
+        if with_condexpr:
+            return self.parse_condexpr()
+        return self.parse_or()
+
+    def parse_condexpr(self):
+        lineno = self.stream.current.lineno
+        expr1 = self.parse_or()
+        while self.stream.skip_if("name:if"):
+            expr2 = self.parse_or()
+            if self.stream.skip_if("name:else"):
+                expr3 = self.parse_condexpr()
+            else:
+                expr3 = None
+            expr1 = nodes.CondExpr(expr2, expr1, expr3, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return expr1
+
+    def parse_or(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_and()
+        while self.stream.skip_if("name:or"):
+            right = self.parse_and()
+            left = nodes.Or(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_and(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_not()
+        while self.stream.skip_if("name:and"):
+            right = self.parse_not()
+            left = nodes.And(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_not(self):
+        if self.stream.current.test("name:not"):
+            lineno = next(self.stream).lineno
+            return nodes.Not(self.parse_not(), lineno=lineno)
+        return self.parse_compare()
+
+    def parse_compare(self):
+        lineno = self.stream.current.lineno
+        expr = self.parse_math1()
+        ops = []
+        while 1:
+            token_type = self.stream.current.type
+            if token_type in _compare_operators:
+                next(self.stream)
+                ops.append(nodes.Operand(token_type, self.parse_math1()))
+            elif self.stream.skip_if("name:in"):
+                ops.append(nodes.Operand("in", self.parse_math1()))
+            elif self.stream.current.test("name:not") and self.stream.look().test(
+                "name:in"
+            ):
+                self.stream.skip(2)
+                ops.append(nodes.Operand("notin", self.parse_math1()))
+            else:
+                break
+            lineno = self.stream.current.lineno
+        if not ops:
+            return expr
+        return nodes.Compare(expr, ops, lineno=lineno)
+
+    def parse_math1(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_concat()
+        while self.stream.current.type in ("add", "sub"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_concat()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_concat(self):
+        lineno = self.stream.current.lineno
+        args = [self.parse_math2()]
+        while self.stream.current.type == "tilde":
+            next(self.stream)
+            args.append(self.parse_math2())
+        if len(args) == 1:
+            return args[0]
+        return nodes.Concat(args, lineno=lineno)
+
+    def parse_math2(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_pow()
+        while self.stream.current.type in ("mul", "div", "floordiv", "mod"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_pow()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_pow(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_unary()
+        while self.stream.current.type == "pow":
+            next(self.stream)
+            right = self.parse_unary()
+            left = nodes.Pow(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_unary(self, with_filter=True):
+        token_type = self.stream.current.type
+        lineno = self.stream.current.lineno
+        if token_type == "sub":
+            next(self.stream)
+            node = nodes.Neg(self.parse_unary(False), lineno=lineno)
+        elif token_type == "add":
+            next(self.stream)
+            node = nodes.Pos(self.parse_unary(False), lineno=lineno)
+        else:
+            node = self.parse_primary()
+        node = self.parse_postfix(node)
+        if with_filter:
+            node = self.parse_filter_expr(node)
+        return node
+
+    def parse_primary(self):
+        token = self.stream.current
+        if token.type == "name":
+            if token.value in ("true", "false", "True", "False"):
+                node = nodes.Const(token.value in ("true", "True"), lineno=token.lineno)
+            elif token.value in ("none", "None"):
+                node = nodes.Const(None, lineno=token.lineno)
+            else:
+                node = nodes.Name(token.value, "load", lineno=token.lineno)
+            next(self.stream)
+        elif token.type == "string":
+            next(self.stream)
+            buf = [token.value]
+            lineno = token.lineno
+            while self.stream.current.type == "string":
+                buf.append(self.stream.current.value)
+                next(self.stream)
+            node = nodes.Const("".join(buf), lineno=lineno)
+        elif token.type in ("integer", "float"):
+            next(self.stream)
+            node = nodes.Const(token.value, lineno=token.lineno)
+        elif token.type == "lparen":
+            next(self.stream)
+            node = self.parse_tuple(explicit_parentheses=True)
+            self.stream.expect("rparen")
+        elif token.type == "lbracket":
+            node = self.parse_list()
+        elif token.type == "lbrace":
+            node = self.parse_dict()
+        else:
+            self.fail("unexpected '%s'" % describe_token(token), token.lineno)
+        return node
+
+    def parse_tuple(
+        self,
+        simplified=False,
+        with_condexpr=True,
+        extra_end_rules=None,
+        explicit_parentheses=False,
+    ):
+        """Works like `parse_expression` but if multiple expressions are
+        delimited by a comma a :class:`~jinja2.nodes.Tuple` node is created.
+        This method could also return a regular expression instead of a tuple
+        if no commas where found.
+
+        The default parsing mode is a full tuple.  If `simplified` is `True`
+        only names and literals are parsed.  The `no_condexpr` parameter is
+        forwarded to :meth:`parse_expression`.
+
+        Because tuples do not require delimiters and may end in a bogus comma
+        an extra hint is needed that marks the end of a tuple.  For example
+        for loops support tuples between `for` and `in`.  In that case the
+        `extra_end_rules` is set to ``['name:in']``.
+
+        `explicit_parentheses` is true if the parsing was triggered by an
+        expression in parentheses.  This is used to figure out if an empty
+        tuple is a valid expression or not.
+        """
+        lineno = self.stream.current.lineno
+        if simplified:
+            parse = self.parse_primary
+        elif with_condexpr:
+            parse = self.parse_expression
+        else:
+
+            def parse():
+                return self.parse_expression(with_condexpr=False)
+
+        args = []
+        is_tuple = False
+        while 1:
+            if args:
+                self.stream.expect("comma")
+            if self.is_tuple_end(extra_end_rules):
+                break
+            args.append(parse())
+            if self.stream.current.type == "comma":
+                is_tuple = True
+            else:
+                break
+            lineno = self.stream.current.lineno
+
+        if not is_tuple:
+            if args:
+                return args[0]
+
+            # if we don't have explicit parentheses, an empty tuple is
+            # not a valid expression.  This would mean nothing (literally
+            # nothing) in the spot of an expression would be an empty
+            # tuple.
+            if not explicit_parentheses:
+                self.fail(
+                    "Expected an expression, got '%s'"
+                    % describe_token(self.stream.current)
+                )
+
+        return nodes.Tuple(args, "load", lineno=lineno)
+
+    def parse_list(self):
+        token = self.stream.expect("lbracket")
+        items = []
+        while self.stream.current.type != "rbracket":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbracket":
+                break
+            items.append(self.parse_expression())
+        self.stream.expect("rbracket")
+        return nodes.List(items, lineno=token.lineno)
+
+    def parse_dict(self):
+        token = self.stream.expect("lbrace")
+        items = []
+        while self.stream.current.type != "rbrace":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbrace":
+                break
+            key = self.parse_expression()
+            self.stream.expect("colon")
+            value = self.parse_expression()
+            items.append(nodes.Pair(key, value, lineno=key.lineno))
+        self.stream.expect("rbrace")
+        return nodes.Dict(items, lineno=token.lineno)
+
+    def parse_postfix(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "dot" or token_type == "lbracket":
+                node = self.parse_subscript(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_filter_expr(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "pipe":
+                node = self.parse_filter(node)
+            elif token_type == "name" and self.stream.current.value == "is":
+                node = self.parse_test(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_subscript(self, node):
+        token = next(self.stream)
+        if token.type == "dot":
+            attr_token = self.stream.current
+            next(self.stream)
+            if attr_token.type == "name":
+                return nodes.Getattr(
+                    node, attr_token.value, "load", lineno=token.lineno
+                )
+            elif attr_token.type != "integer":
+                self.fail("expected name or number", attr_token.lineno)
+            arg = nodes.Const(attr_token.value, lineno=attr_token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        if token.type == "lbracket":
+            args = []
+            while self.stream.current.type != "rbracket":
+                if args:
+                    self.stream.expect("comma")
+                args.append(self.parse_subscribed())
+            self.stream.expect("rbracket")
+            if len(args) == 1:
+                arg = args[0]
+            else:
+                arg = nodes.Tuple(args, "load", lineno=token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        self.fail("expected subscript expression", token.lineno)
+
+    def parse_subscribed(self):
+        lineno = self.stream.current.lineno
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            args = [None]
+        else:
+            node = self.parse_expression()
+            if self.stream.current.type != "colon":
+                return node
+            next(self.stream)
+            args = [node]
+
+        if self.stream.current.type == "colon":
+            args.append(None)
+        elif self.stream.current.type not in ("rbracket", "comma"):
+            args.append(self.parse_expression())
+        else:
+            args.append(None)
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            if self.stream.current.type not in ("rbracket", "comma"):
+                args.append(self.parse_expression())
+            else:
+                args.append(None)
+        else:
+            args.append(None)
+
+        return nodes.Slice(lineno=lineno, *args)
+
+    def parse_call(self, node):
+        token = self.stream.expect("lparen")
+        args = []
+        kwargs = []
+        dyn_args = dyn_kwargs = None
+        require_comma = False
+
+        def ensure(expr):
+            if not expr:
+                self.fail("invalid syntax for function call expression", token.lineno)
+
+        while self.stream.current.type != "rparen":
+            if require_comma:
+                self.stream.expect("comma")
+                # support for trailing comma
+                if self.stream.current.type == "rparen":
+                    break
+            if self.stream.current.type == "mul":
+                ensure(dyn_args is None and dyn_kwargs is None)
+                next(self.stream)
+                dyn_args = self.parse_expression()
+            elif self.stream.current.type == "pow":
+                ensure(dyn_kwargs is None)
+                next(self.stream)
+                dyn_kwargs = self.parse_expression()
+            else:
+                if (
+                    self.stream.current.type == "name"
+                    and self.stream.look().type == "assign"
+                ):
+                    # Parsing a kwarg
+                    ensure(dyn_kwargs is None)
+                    key = self.stream.current.value
+                    self.stream.skip(2)
+                    value = self.parse_expression()
+                    kwargs.append(nodes.Keyword(key, value, lineno=value.lineno))
+                else:
+                    # Parsing an arg
+                    ensure(dyn_args is None and dyn_kwargs is None and not kwargs)
+                    args.append(self.parse_expression())
+
+            require_comma = True
+        self.stream.expect("rparen")
+
+        if node is None:
+            return args, kwargs, dyn_args, dyn_kwargs
+        return nodes.Call(node, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno)
+
+    def parse_filter(self, node, start_inline=False):
+        while self.stream.current.type == "pipe" or start_inline:
+            if not start_inline:
+                next(self.stream)
+            token = self.stream.expect("name")
+            name = token.value
+            while self.stream.current.type == "dot":
+                next(self.stream)
+                name += "." + self.stream.expect("name").value
+            if self.stream.current.type == "lparen":
+                args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+            else:
+                args = []
+                kwargs = []
+                dyn_args = dyn_kwargs = None
+            node = nodes.Filter(
+                node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+            )
+            start_inline = False
+        return node
+
+    def parse_test(self, node):
+        token = next(self.stream)
+        if self.stream.current.test("name:not"):
+            next(self.stream)
+            negated = True
+        else:
+            negated = False
+        name = self.stream.expect("name").value
+        while self.stream.current.type == "dot":
+            next(self.stream)
+            name += "." + self.stream.expect("name").value
+        dyn_args = dyn_kwargs = None
+        kwargs = []
+        if self.stream.current.type == "lparen":
+            args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+        elif self.stream.current.type in (
+            "name",
+            "string",
+            "integer",
+            "float",
+            "lparen",
+            "lbracket",
+            "lbrace",
+        ) and not self.stream.current.test_any("name:else", "name:or", "name:and"):
+            if self.stream.current.test("name:is"):
+                self.fail("You cannot chain multiple tests with is")
+            arg_node = self.parse_primary()
+            arg_node = self.parse_postfix(arg_node)
+            args = [arg_node]
+        else:
+            args = []
+        node = nodes.Test(
+            node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+        )
+        if negated:
+            node = nodes.Not(node, lineno=token.lineno)
+        return node
+
+    def subparse(self, end_tokens=None):
+        body = []
+        data_buffer = []
+        add_data = data_buffer.append
+
+        if end_tokens is not None:
+            self._end_token_stack.append(end_tokens)
+
+        def flush_data():
+            if data_buffer:
+                lineno = data_buffer[0].lineno
+                body.append(nodes.Output(data_buffer[:], lineno=lineno))
+                del data_buffer[:]
+
+        try:
+            while self.stream:
+                token = self.stream.current
+                if token.type == "data":
+                    if token.value:
+                        add_data(nodes.TemplateData(token.value, lineno=token.lineno))
+                    next(self.stream)
+                elif token.type == "variable_begin":
+                    next(self.stream)
+                    add_data(self.parse_tuple(with_condexpr=True))
+                    self.stream.expect("variable_end")
+                elif token.type == "block_begin":
+                    flush_data()
+                    next(self.stream)
+                    if end_tokens is not None and self.stream.current.test_any(
+                        *end_tokens
+                    ):
+                        return body
+                    rv = self.parse_statement()
+                    if isinstance(rv, list):
+                        body.extend(rv)
+                    else:
+                        body.append(rv)
+                    self.stream.expect("block_end")
+                else:
+                    raise AssertionError("internal parsing error")
+
+            flush_data()
+        finally:
+            if end_tokens is not None:
+                self._end_token_stack.pop()
+
+        return body
+
+    def parse(self):
+        """Parse the whole template into a `Template` node."""
+        result = nodes.Template(self.subparse(), lineno=1)
+        result.set_environment(self.environment)
+        return result
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/runtime.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/runtime.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ad79686242d35b2ce587ac8267259621d4769e4
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/runtime.py
@@ -0,0 +1,1011 @@
+# -*- coding: utf-8 -*-
+"""The runtime functions and state used by compiled templates."""
+import sys
+from itertools import chain
+from types import MethodType
+
+from markupsafe import escape  # noqa: F401
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import with_metaclass
+from .exceptions import TemplateNotFound  # noqa: F401
+from .exceptions import TemplateRuntimeError  # noqa: F401
+from .exceptions import UndefinedError
+from .nodes import EvalContext
+from .utils import concat
+from .utils import evalcontextfunction
+from .utils import internalcode
+from .utils import missing
+from .utils import Namespace  # noqa: F401
+from .utils import object_type_repr
+
+# these variables are exported to the template runtime
+exported = [
+    "LoopContext",
+    "TemplateReference",
+    "Macro",
+    "Markup",
+    "TemplateRuntimeError",
+    "missing",
+    "concat",
+    "escape",
+    "markup_join",
+    "unicode_join",
+    "to_string",
+    "identity",
+    "TemplateNotFound",
+    "Namespace",
+    "Undefined",
+]
+
+#: the name of the function that is used to convert something into
+#: a string.  We can just use the text type here.
+to_string = text_type
+
+
+def identity(x):
+    """Returns its argument. Useful for certain things in the
+    environment.
+    """
+    return x
+
+
+def markup_join(seq):
+    """Concatenation that escapes if necessary and converts to unicode."""
+    buf = []
+    iterator = imap(soft_unicode, seq)
+    for arg in iterator:
+        buf.append(arg)
+        if hasattr(arg, "__html__"):
+            return Markup(u"").join(chain(buf, iterator))
+    return concat(buf)
+
+
+def unicode_join(seq):
+    """Simple args to unicode conversion and concatenation."""
+    return concat(imap(text_type, seq))
+
+
+def new_context(
+    environment,
+    template_name,
+    blocks,
+    vars=None,
+    shared=None,
+    globals=None,
+    locals=None,
+):
+    """Internal helper for context creation."""
+    if vars is None:
+        vars = {}
+    if shared:
+        parent = vars
+    else:
+        parent = dict(globals or (), **vars)
+    if locals:
+        # if the parent is shared a copy should be created because
+        # we don't want to modify the dict passed
+        if shared:
+            parent = dict(parent)
+        for key, value in iteritems(locals):
+            if value is not missing:
+                parent[key] = value
+    return environment.context_class(environment, parent, template_name, blocks)
+
+
+class TemplateReference(object):
+    """The `self` in templates."""
+
+    def __init__(self, context):
+        self.__context = context
+
+    def __getitem__(self, name):
+        blocks = self.__context.blocks[name]
+        return BlockReference(name, self.__context, blocks, 0)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self.__context.name)
+
+
+def _get_func(x):
+    return getattr(x, "__func__", x)
+
+
+class ContextMeta(type):
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        if bases == ():
+            return rv
+
+        resolve = _get_func(rv.resolve)
+        default_resolve = _get_func(Context.resolve)
+        resolve_or_missing = _get_func(rv.resolve_or_missing)
+        default_resolve_or_missing = _get_func(Context.resolve_or_missing)
+
+        # If we have a changed resolve but no changed default or missing
+        # resolve we invert the call logic.
+        if (
+            resolve is not default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._legacy_resolve_mode = True
+        elif (
+            resolve is default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._fast_resolve_mode = True
+
+        return rv
+
+
+def resolve_or_missing(context, key, missing=missing):
+    if key in context.vars:
+        return context.vars[key]
+    if key in context.parent:
+        return context.parent[key]
+    return missing
+
+
+class Context(with_metaclass(ContextMeta)):
+    """The template context holds the variables of a template.  It stores the
+    values passed to the template and also the names the template exports.
+    Creating instances is neither supported nor useful as it's created
+    automatically at various stages of the template evaluation and should not
+    be created by hand.
+
+    The context is immutable.  Modifications on :attr:`parent` **must not**
+    happen and modifications on :attr:`vars` are allowed from generated
+    template code only.  Template filters and global functions marked as
+    :func:`contextfunction`\\s get the active context passed as first argument
+    and are allowed to access the context read-only.
+
+    The template context supports read only dict operations (`get`,
+    `keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`,
+    `__getitem__`, `__contains__`).  Additionally there is a :meth:`resolve`
+    method that doesn't fail with a `KeyError` but returns an
+    :class:`Undefined` object for missing variables.
+    """
+
+    # XXX: we want to eventually make this be a deprecation warning and
+    # remove it.
+    _legacy_resolve_mode = False
+    _fast_resolve_mode = False
+
+    def __init__(self, environment, parent, name, blocks):
+        self.parent = parent
+        self.vars = {}
+        self.environment = environment
+        self.eval_ctx = EvalContext(self.environment, name)
+        self.exported_vars = set()
+        self.name = name
+
+        # create the initial mapping of blocks.  Whenever template inheritance
+        # takes place the runtime will update this mapping with the new blocks
+        # from the template.
+        self.blocks = dict((k, [v]) for k, v in iteritems(blocks))
+
+        # In case we detect the fast resolve mode we can set up an alias
+        # here that bypasses the legacy code logic.
+        if self._fast_resolve_mode:
+            self.resolve_or_missing = MethodType(resolve_or_missing, self)
+
+    def super(self, name, current):
+        """Render a parent block."""
+        try:
+            blocks = self.blocks[name]
+            index = blocks.index(current) + 1
+            blocks[index]
+        except LookupError:
+            return self.environment.undefined(
+                "there is no parent block called %r." % name, name="super"
+            )
+        return BlockReference(name, self, blocks, index)
+
+    def get(self, key, default=None):
+        """Returns an item from the template context, if it doesn't exist
+        `default` is returned.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def resolve(self, key):
+        """Looks up a variable like `__getitem__` or `get` but returns an
+        :class:`Undefined` object with the name of the name looked up.
+        """
+        if self._legacy_resolve_mode:
+            rv = resolve_or_missing(self, key)
+        else:
+            rv = self.resolve_or_missing(key)
+        if rv is missing:
+            return self.environment.undefined(name=key)
+        return rv
+
+    def resolve_or_missing(self, key):
+        """Resolves a variable like :meth:`resolve` but returns the
+        special `missing` value if it cannot be found.
+        """
+        if self._legacy_resolve_mode:
+            rv = self.resolve(key)
+            if isinstance(rv, Undefined):
+                rv = missing
+            return rv
+        return resolve_or_missing(self, key)
+
+    def get_exported(self):
+        """Get a new dict with the exported variables."""
+        return dict((k, self.vars[k]) for k in self.exported_vars)
+
+    def get_all(self):
+        """Return the complete context as dict including the exported
+        variables.  For optimizations reasons this might not return an
+        actual copy so be careful with using it.
+        """
+        if not self.vars:
+            return self.parent
+        if not self.parent:
+            return self.vars
+        return dict(self.parent, **self.vars)
+
+    @internalcode
+    def call(__self, __obj, *args, **kwargs):  # noqa: B902
+        """Call the callable with the arguments and keyword arguments
+        provided but inject the active context or environment as first
+        argument if the callable is a :func:`contextfunction` or
+        :func:`environmentfunction`.
+        """
+        if __debug__:
+            __traceback_hide__ = True  # noqa
+
+        # Allow callable classes to take a context
+        if hasattr(__obj, "__call__"):  # noqa: B004
+            fn = __obj.__call__
+            for fn_type in (
+                "contextfunction",
+                "evalcontextfunction",
+                "environmentfunction",
+            ):
+                if hasattr(fn, fn_type):
+                    __obj = fn
+                    break
+
+        if callable(__obj):
+            if getattr(__obj, "contextfunction", False) is True:
+                args = (__self,) + args
+            elif getattr(__obj, "evalcontextfunction", False) is True:
+                args = (__self.eval_ctx,) + args
+            elif getattr(__obj, "environmentfunction", False) is True:
+                args = (__self.environment,) + args
+        try:
+            return __obj(*args, **kwargs)
+        except StopIteration:
+            return __self.environment.undefined(
+                "value was undefined because "
+                "a callable raised a "
+                "StopIteration exception"
+            )
+
+    def derived(self, locals=None):
+        """Internal helper function to create a derived context.  This is
+        used in situations where the system needs a new context in the same
+        template that is independent.
+        """
+        context = new_context(
+            self.environment, self.name, {}, self.get_all(), True, None, locals
+        )
+        context.eval_ctx = self.eval_ctx
+        context.blocks.update((k, list(v)) for k, v in iteritems(self.blocks))
+        return context
+
+    def _all(meth):  # noqa: B902
+        def proxy(self):
+            return getattr(self.get_all(), meth)()
+
+        proxy.__doc__ = getattr(dict, meth).__doc__
+        proxy.__name__ = meth
+        return proxy
+
+    keys = _all("keys")
+    values = _all("values")
+    items = _all("items")
+
+    # not available on python 3
+    if PY2:
+        iterkeys = _all("iterkeys")
+        itervalues = _all("itervalues")
+        iteritems = _all("iteritems")
+    del _all
+
+    def __contains__(self, name):
+        return name in self.vars or name in self.parent
+
+    def __getitem__(self, key):
+        """Lookup a variable or raise `KeyError` if the variable is
+        undefined.
+        """
+        item = self.resolve_or_missing(key)
+        if item is missing:
+            raise KeyError(key)
+        return item
+
+    def __repr__(self):
+        return "<%s %s of %r>" % (
+            self.__class__.__name__,
+            repr(self.get_all()),
+            self.name,
+        )
+
+
+abc.Mapping.register(Context)
+
+
+class BlockReference(object):
+    """One block on a template reference."""
+
+    def __init__(self, name, context, stack, depth):
+        self.name = name
+        self._context = context
+        self._stack = stack
+        self._depth = depth
+
+    @property
+    def super(self):
+        """Super the block."""
+        if self._depth + 1 >= len(self._stack):
+            return self._context.environment.undefined(
+                "there is no parent block called %r." % self.name, name="super"
+            )
+        return BlockReference(self.name, self._context, self._stack, self._depth + 1)
+
+    @internalcode
+    def __call__(self):
+        rv = concat(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+
+@implements_iterator
+class LoopContext:
+    """A wrapper iterable for dynamic ``for`` loops, with information
+    about the loop and iteration.
+    """
+
+    #: Current iteration of the loop, starting at 0.
+    index0 = -1
+
+    _length = None
+    _after = missing
+    _current = missing
+    _before = missing
+    _last_changed_value = missing
+
+    def __init__(self, iterable, undefined, recurse=None, depth0=0):
+        """
+        :param iterable: Iterable to wrap.
+        :param undefined: :class:`Undefined` class to use for next and
+            previous items.
+        :param recurse: The function to render the loop body when the
+            loop is marked recursive.
+        :param depth0: Incremented when looping recursively.
+        """
+        self._iterable = iterable
+        self._iterator = self._to_iterator(iterable)
+        self._undefined = undefined
+        self._recurse = recurse
+        #: How many levels deep a recursive loop currently is, starting at 0.
+        self.depth0 = depth0
+
+    @staticmethod
+    def _to_iterator(iterable):
+        return iter(iterable)
+
+    @property
+    def length(self):
+        """Length of the iterable.
+
+        If the iterable is a generator or otherwise does not have a
+        size, it is eagerly evaluated to get a size.
+        """
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = list(self._iterator)
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    def __len__(self):
+        return self.length
+
+    @property
+    def depth(self):
+        """How many levels deep a recursive loop currently is, starting at 1."""
+        return self.depth0 + 1
+
+    @property
+    def index(self):
+        """Current iteration of the loop, starting at 1."""
+        return self.index0 + 1
+
+    @property
+    def revindex0(self):
+        """Number of iterations from the end of the loop, ending at 0.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index
+
+    @property
+    def revindex(self):
+        """Number of iterations from the end of the loop, ending at 1.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index0
+
+    @property
+    def first(self):
+        """Whether this is the first iteration of the loop."""
+        return self.index0 == 0
+
+    def _peek_next(self):
+        """Return the next element in the iterable, or :data:`missing`
+        if the iterable is exhausted. Only peeks one item ahead, caching
+        the result in :attr:`_last` for use in subsequent checks. The
+        cache is reset when :meth:`__next__` is called.
+        """
+        if self._after is not missing:
+            return self._after
+
+        self._after = next(self._iterator, missing)
+        return self._after
+
+    @property
+    def last(self):
+        """Whether this is the last iteration of the loop.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        return self._peek_next() is missing
+
+    @property
+    def previtem(self):
+        """The item in the previous iteration. Undefined during the
+        first iteration.
+        """
+        if self.first:
+            return self._undefined("there is no previous item")
+
+        return self._before
+
+    @property
+    def nextitem(self):
+        """The item in the next iteration. Undefined during the last
+        iteration.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        rv = self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def cycle(self, *args):
+        """Return a value from the given args, cycling through based on
+        the current :attr:`index0`.
+
+        :param args: One or more values to cycle through.
+        """
+        if not args:
+            raise TypeError("no items for cycling given")
+
+        return args[self.index0 % len(args)]
+
+    def changed(self, *value):
+        """Return ``True`` if previously called with a different value
+        (including when called for the first time).
+
+        :param value: One or more values to compare to the last call.
+        """
+        if self._last_changed_value != value:
+            self._last_changed_value = value
+            return True
+
+        return False
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = next(self._iterator)
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+    @internalcode
+    def __call__(self, iterable):
+        """When iterating over nested data, render the body of the loop
+        recursively with the given inner iterable data.
+
+        The loop must have the ``recursive`` marker for this to work.
+        """
+        if self._recurse is None:
+            raise TypeError(
+                "The loop must have the 'recursive' marker to be called recursively."
+            )
+
+        return self._recurse(iterable, self._recurse, depth=self.depth)
+
+    def __repr__(self):
+        return "<%s %d/%d>" % (self.__class__.__name__, self.index, self.length)
+
+
+class Macro(object):
+    """Wraps a macro function."""
+
+    def __init__(
+        self,
+        environment,
+        func,
+        name,
+        arguments,
+        catch_kwargs,
+        catch_varargs,
+        caller,
+        default_autoescape=None,
+    ):
+        self._environment = environment
+        self._func = func
+        self._argument_count = len(arguments)
+        self.name = name
+        self.arguments = arguments
+        self.catch_kwargs = catch_kwargs
+        self.catch_varargs = catch_varargs
+        self.caller = caller
+        self.explicit_caller = "caller" in arguments
+        if default_autoescape is None:
+            default_autoescape = environment.autoescape
+        self._default_autoescape = default_autoescape
+
+    @internalcode
+    @evalcontextfunction
+    def __call__(self, *args, **kwargs):
+        # This requires a bit of explanation,  In the past we used to
+        # decide largely based on compile-time information if a macro is
+        # safe or unsafe.  While there was a volatile mode it was largely
+        # unused for deciding on escaping.  This turns out to be
+        # problematic for macros because whether a macro is safe depends not
+        # on the escape mode when it was defined, but rather when it was used.
+        #
+        # Because however we export macros from the module system and
+        # there are historic callers that do not pass an eval context (and
+        # will continue to not pass one), we need to perform an instance
+        # check here.
+        #
+        # This is considered safe because an eval context is not a valid
+        # argument to callables otherwise anyway.  Worst case here is
+        # that if no eval context is passed we fall back to the compile
+        # time autoescape flag.
+        if args and isinstance(args[0], EvalContext):
+            autoescape = args[0].autoescape
+            args = args[1:]
+        else:
+            autoescape = self._default_autoescape
+
+        # try to consume the positional arguments
+        arguments = list(args[: self._argument_count])
+        off = len(arguments)
+
+        # For information why this is necessary refer to the handling
+        # of caller in the `macro_body` handler in the compiler.
+        found_caller = False
+
+        # if the number of arguments consumed is not the number of
+        # arguments expected we start filling in keyword arguments
+        # and defaults.
+        if off != self._argument_count:
+            for name in self.arguments[len(arguments) :]:
+                try:
+                    value = kwargs.pop(name)
+                except KeyError:
+                    value = missing
+                if name == "caller":
+                    found_caller = True
+                arguments.append(value)
+        else:
+            found_caller = self.explicit_caller
+
+        # it's important that the order of these arguments does not change
+        # if not also changed in the compiler's `function_scoping` method.
+        # the order is caller, keyword arguments, positional arguments!
+        if self.caller and not found_caller:
+            caller = kwargs.pop("caller", None)
+            if caller is None:
+                caller = self._environment.undefined("No caller defined", name="caller")
+            arguments.append(caller)
+
+        if self.catch_kwargs:
+            arguments.append(kwargs)
+        elif kwargs:
+            if "caller" in kwargs:
+                raise TypeError(
+                    "macro %r was invoked with two values for "
+                    "the special caller argument.  This is "
+                    "most likely a bug." % self.name
+                )
+            raise TypeError(
+                "macro %r takes no keyword argument %r"
+                % (self.name, next(iter(kwargs)))
+            )
+        if self.catch_varargs:
+            arguments.append(args[self._argument_count :])
+        elif len(args) > self._argument_count:
+            raise TypeError(
+                "macro %r takes not more than %d argument(s)"
+                % (self.name, len(self.arguments))
+            )
+
+        return self._invoke(arguments, autoescape)
+
+    def _invoke(self, arguments, autoescape):
+        """This method is being swapped out by the async implementation."""
+        rv = self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    def __repr__(self):
+        return "<%s %s>" % (
+            self.__class__.__name__,
+            self.name is None and "anonymous" or repr(self.name),
+        )
+
+
+@implements_to_string
+class Undefined(object):
+    """The default undefined type.  This undefined type can be printed and
+    iterated over, but every other access will raise an :exc:`UndefinedError`:
+
+    >>> foo = Undefined(name='foo')
+    >>> str(foo)
+    ''
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = (
+        "_undefined_hint",
+        "_undefined_obj",
+        "_undefined_name",
+        "_undefined_exception",
+    )
+
+    def __init__(self, hint=None, obj=missing, name=None, exc=UndefinedError):
+        self._undefined_hint = hint
+        self._undefined_obj = obj
+        self._undefined_name = name
+        self._undefined_exception = exc
+
+    @property
+    def _undefined_message(self):
+        """Build a message about the undefined value based on how it was
+        accessed.
+        """
+        if self._undefined_hint:
+            return self._undefined_hint
+
+        if self._undefined_obj is missing:
+            return "%r is undefined" % self._undefined_name
+
+        if not isinstance(self._undefined_name, string_types):
+            return "%s has no element %r" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+
+        return "%r has no attribute %r" % (
+            object_type_repr(self._undefined_obj),
+            self._undefined_name,
+        )
+
+    @internalcode
+    def _fail_with_undefined_error(self, *args, **kwargs):
+        """Raise an :exc:`UndefinedError` when operations are performed
+        on the undefined value.
+        """
+        raise self._undefined_exception(self._undefined_message)
+
+    @internalcode
+    def __getattr__(self, name):
+        if name[:2] == "__":
+            raise AttributeError(name)
+        return self._fail_with_undefined_error()
+
+    __add__ = (
+        __radd__
+    ) = (
+        __mul__
+    ) = (
+        __rmul__
+    ) = (
+        __div__
+    ) = (
+        __rdiv__
+    ) = (
+        __truediv__
+    ) = (
+        __rtruediv__
+    ) = (
+        __floordiv__
+    ) = (
+        __rfloordiv__
+    ) = (
+        __mod__
+    ) = (
+        __rmod__
+    ) = (
+        __pos__
+    ) = (
+        __neg__
+    ) = (
+        __call__
+    ) = (
+        __getitem__
+    ) = (
+        __lt__
+    ) = (
+        __le__
+    ) = (
+        __gt__
+    ) = (
+        __ge__
+    ) = (
+        __int__
+    ) = (
+        __float__
+    ) = (
+        __complex__
+    ) = __pow__ = __rpow__ = __sub__ = __rsub__ = _fail_with_undefined_error
+
+    def __eq__(self, other):
+        return type(self) is type(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __hash__(self):
+        return id(type(self))
+
+    def __str__(self):
+        return u""
+
+    def __len__(self):
+        return 0
+
+    def __iter__(self):
+        if 0:
+            yield None
+
+    def __nonzero__(self):
+        return False
+
+    __bool__ = __nonzero__
+
+    def __repr__(self):
+        return "Undefined"
+
+
+def make_logging_undefined(logger=None, base=None):
+    """Given a logger object this returns a new undefined class that will
+    log certain failures.  It will log iterations and printing.  If no
+    logger is given a default logger is created.
+
+    Example::
+
+        logger = logging.getLogger(__name__)
+        LoggingUndefined = make_logging_undefined(
+            logger=logger,
+            base=Undefined
+        )
+
+    .. versionadded:: 2.8
+
+    :param logger: the logger to use.  If not provided, a default logger
+                   is created.
+    :param base: the base class to add logging functionality to.  This
+                 defaults to :class:`Undefined`.
+    """
+    if logger is None:
+        import logging
+
+        logger = logging.getLogger(__name__)
+        logger.addHandler(logging.StreamHandler(sys.stderr))
+    if base is None:
+        base = Undefined
+
+    def _log_message(undef):
+        if undef._undefined_hint is None:
+            if undef._undefined_obj is missing:
+                hint = "%s is undefined" % undef._undefined_name
+            elif not isinstance(undef._undefined_name, string_types):
+                hint = "%s has no element %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+            else:
+                hint = "%s has no attribute %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+        else:
+            hint = undef._undefined_hint
+        logger.warning("Template variable warning: %s", hint)
+
+    class LoggingUndefined(base):
+        def _fail_with_undefined_error(self, *args, **kwargs):
+            try:
+                return base._fail_with_undefined_error(self, *args, **kwargs)
+            except self._undefined_exception as e:
+                logger.error("Template variable error: %s", str(e))
+                raise e
+
+        def __str__(self):
+            rv = base.__str__(self)
+            _log_message(self)
+            return rv
+
+        def __iter__(self):
+            rv = base.__iter__(self)
+            _log_message(self)
+            return rv
+
+        if PY2:
+
+            def __nonzero__(self):
+                rv = base.__nonzero__(self)
+                _log_message(self)
+                return rv
+
+            def __unicode__(self):
+                rv = base.__unicode__(self)
+                _log_message(self)
+                return rv
+
+        else:
+
+            def __bool__(self):
+                rv = base.__bool__(self)
+                _log_message(self)
+                return rv
+
+    return LoggingUndefined
+
+
+# No @implements_to_string decorator here because __str__
+# is not overwritten from Undefined in this class.
+# This would cause a recursion error in Python 2.
+class ChainableUndefined(Undefined):
+    """An undefined that is chainable, where both ``__getattr__`` and
+    ``__getitem__`` return itself rather than raising an
+    :exc:`UndefinedError`.
+
+    >>> foo = ChainableUndefined(name='foo')
+    >>> str(foo.bar['baz'])
+    ''
+    >>> foo.bar['baz'] + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+
+    .. versionadded:: 2.11.0
+    """
+
+    __slots__ = ()
+
+    def __html__(self):
+        return self.__str__()
+
+    def __getattr__(self, _):
+        return self
+
+    __getitem__ = __getattr__
+
+
+@implements_to_string
+class DebugUndefined(Undefined):
+    """An undefined that returns the debug info when printed.
+
+    >>> foo = DebugUndefined(name='foo')
+    >>> str(foo)
+    '{{ foo }}'
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+
+    def __str__(self):
+        if self._undefined_hint is None:
+            if self._undefined_obj is missing:
+                return u"{{ %s }}" % self._undefined_name
+            return "{{ no such element: %s[%r] }}" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+        return u"{{ undefined value printed: %s }}" % self._undefined_hint
+
+
+@implements_to_string
+class StrictUndefined(Undefined):
+    """An undefined that barks on print and iteration as well as boolean
+    tests and all kinds of comparisons.  In other words: you can do nothing
+    with it except checking if it's defined using the `defined` test.
+
+    >>> foo = StrictUndefined(name='foo')
+    >>> str(foo)
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> not foo
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+    __iter__ = (
+        __str__
+    ) = (
+        __len__
+    ) = (
+        __nonzero__
+    ) = __eq__ = __ne__ = __bool__ = __hash__ = Undefined._fail_with_undefined_error
+
+
+# remove remaining slots attributes, after the metaclass did the magic they
+# are unneeded and irritating as they contain wrong data for the subclasses.
+del (
+    Undefined.__slots__,
+    ChainableUndefined.__slots__,
+    DebugUndefined.__slots__,
+    StrictUndefined.__slots__,
+)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/sandbox.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/sandbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..cfd7993aee3358d332495cbcbcc46336a191006f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/sandbox.py
@@ -0,0 +1,510 @@
+# -*- coding: utf-8 -*-
+"""A sandbox layer that ensures unsafe operations cannot be performed.
+Useful when the template itself comes from an untrusted source.
+"""
+import operator
+import types
+import warnings
+from collections import deque
+from string import Formatter
+
+from markupsafe import EscapeFormatter
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import PY2
+from ._compat import range_type
+from ._compat import string_types
+from .environment import Environment
+from .exceptions import SecurityError
+
+#: maximum number of items a range may produce
+MAX_RANGE = 100000
+
+#: attributes of function objects that are considered unsafe.
+if PY2:
+    UNSAFE_FUNCTION_ATTRIBUTES = {
+        "func_closure",
+        "func_code",
+        "func_dict",
+        "func_defaults",
+        "func_globals",
+    }
+else:
+    # On versions > python 2 the special attributes on functions are gone,
+    # but they remain on methods and generators for whatever reason.
+    UNSAFE_FUNCTION_ATTRIBUTES = set()
+
+#: unsafe method attributes.  function attributes are unsafe for methods too
+UNSAFE_METHOD_ATTRIBUTES = {"im_class", "im_func", "im_self"}
+
+#: unsafe generator attributes.
+UNSAFE_GENERATOR_ATTRIBUTES = {"gi_frame", "gi_code"}
+
+#: unsafe attributes on coroutines
+UNSAFE_COROUTINE_ATTRIBUTES = {"cr_frame", "cr_code"}
+
+#: unsafe attributes on async generators
+UNSAFE_ASYNC_GENERATOR_ATTRIBUTES = {"ag_code", "ag_frame"}
+
+# make sure we don't warn in python 2.6 about stuff we don't care about
+warnings.filterwarnings(
+    "ignore", "the sets module", DeprecationWarning, module=__name__
+)
+
+_mutable_set_types = (set,)
+_mutable_mapping_types = (dict,)
+_mutable_sequence_types = (list,)
+
+# on python 2.x we can register the user collection types
+try:
+    from UserDict import UserDict, DictMixin
+    from UserList import UserList
+
+    _mutable_mapping_types += (UserDict, DictMixin)
+    _mutable_set_types += (UserList,)
+except ImportError:
+    pass
+
+# if sets is still available, register the mutable set from there as well
+try:
+    from sets import Set
+
+    _mutable_set_types += (Set,)
+except ImportError:
+    pass
+
+#: register Python 2.6 abstract base classes
+_mutable_set_types += (abc.MutableSet,)
+_mutable_mapping_types += (abc.MutableMapping,)
+_mutable_sequence_types += (abc.MutableSequence,)
+
+_mutable_spec = (
+    (
+        _mutable_set_types,
+        frozenset(
+            [
+                "add",
+                "clear",
+                "difference_update",
+                "discard",
+                "pop",
+                "remove",
+                "symmetric_difference_update",
+                "update",
+            ]
+        ),
+    ),
+    (
+        _mutable_mapping_types,
+        frozenset(["clear", "pop", "popitem", "setdefault", "update"]),
+    ),
+    (
+        _mutable_sequence_types,
+        frozenset(["append", "reverse", "insert", "sort", "extend", "remove"]),
+    ),
+    (
+        deque,
+        frozenset(
+            [
+                "append",
+                "appendleft",
+                "clear",
+                "extend",
+                "extendleft",
+                "pop",
+                "popleft",
+                "remove",
+                "rotate",
+            ]
+        ),
+    ),
+)
+
+
+class _MagicFormatMapping(abc.Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See https://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+def inspect_format_method(callable):
+    if not isinstance(
+        callable, (types.MethodType, types.BuiltinMethodType)
+    ) or callable.__name__ not in ("format", "format_map"):
+        return None
+    obj = callable.__self__
+    if isinstance(obj, string_types):
+        return obj
+
+
+def safe_range(*args):
+    """A range that can't generate ranges with a length of more than
+    MAX_RANGE items.
+    """
+    rng = range_type(*args)
+
+    if len(rng) > MAX_RANGE:
+        raise OverflowError(
+            "Range too big. The sandbox blocks ranges larger than"
+            " MAX_RANGE (%d)." % MAX_RANGE
+        )
+
+    return rng
+
+
+def unsafe(f):
+    """Marks a function or method as unsafe.
+
+    ::
+
+        @unsafe
+        def delete(self):
+            pass
+    """
+    f.unsafe_callable = True
+    return f
+
+
+def is_internal_attribute(obj, attr):
+    """Test if the attribute given is an internal python attribute.  For
+    example this function returns `True` for the `func_code` attribute of
+    python objects.  This is useful if the environment method
+    :meth:`~SandboxedEnvironment.is_safe_attribute` is overridden.
+
+    >>> from jinja2.sandbox import is_internal_attribute
+    >>> is_internal_attribute(str, "mro")
+    True
+    >>> is_internal_attribute(str, "upper")
+    False
+    """
+    if isinstance(obj, types.FunctionType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES:
+            return True
+    elif isinstance(obj, types.MethodType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES or attr in UNSAFE_METHOD_ATTRIBUTES:
+            return True
+    elif isinstance(obj, type):
+        if attr == "mro":
+            return True
+    elif isinstance(obj, (types.CodeType, types.TracebackType, types.FrameType)):
+        return True
+    elif isinstance(obj, types.GeneratorType):
+        if attr in UNSAFE_GENERATOR_ATTRIBUTES:
+            return True
+    elif hasattr(types, "CoroutineType") and isinstance(obj, types.CoroutineType):
+        if attr in UNSAFE_COROUTINE_ATTRIBUTES:
+            return True
+    elif hasattr(types, "AsyncGeneratorType") and isinstance(
+        obj, types.AsyncGeneratorType
+    ):
+        if attr in UNSAFE_ASYNC_GENERATOR_ATTRIBUTES:
+            return True
+    return attr.startswith("__")
+
+
+def modifies_known_mutable(obj, attr):
+    """This function checks if an attribute on a builtin mutable object
+    (list, dict, set or deque) would modify it if called.  It also supports
+    the "user"-versions of the objects (`sets.Set`, `UserDict.*` etc.) and
+    with Python 2.6 onwards the abstract base classes `MutableSet`,
+    `MutableMapping`, and `MutableSequence`.
+
+    >>> modifies_known_mutable({}, "clear")
+    True
+    >>> modifies_known_mutable({}, "keys")
+    False
+    >>> modifies_known_mutable([], "append")
+    True
+    >>> modifies_known_mutable([], "index")
+    False
+
+    If called with an unsupported object (such as unicode) `False` is
+    returned.
+
+    >>> modifies_known_mutable("foo", "upper")
+    False
+    """
+    for typespec, unsafe in _mutable_spec:
+        if isinstance(obj, typespec):
+            return attr in unsafe
+    return False
+
+
+class SandboxedEnvironment(Environment):
+    """The sandboxed environment.  It works like the regular environment but
+    tells the compiler to generate sandboxed code.  Additionally subclasses of
+    this environment may override the methods that tell the runtime what
+    attributes or functions are safe to access.
+
+    If the template tries to access insecure code a :exc:`SecurityError` is
+    raised.  However also other exceptions may occur during the rendering so
+    the caller has to ensure that all exceptions are caught.
+    """
+
+    sandboxed = True
+
+    #: default callback table for the binary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`binop_table`
+    default_binop_table = {
+        "+": operator.add,
+        "-": operator.sub,
+        "*": operator.mul,
+        "/": operator.truediv,
+        "//": operator.floordiv,
+        "**": operator.pow,
+        "%": operator.mod,
+    }
+
+    #: default callback table for the unary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`unop_table`
+    default_unop_table = {"+": operator.pos, "-": operator.neg}
+
+    #: a set of binary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_binop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`binop_table`.
+    #:
+    #: The following binary operators are interceptable:
+    #: ``//``, ``%``, ``+``, ``*``, ``-``, ``/``, and ``**``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_binops = frozenset()
+
+    #: a set of unary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_unop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`unop_table`.
+    #:
+    #: The following unary operators are interceptable: ``+``, ``-``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_unops = frozenset()
+
+    def intercept_unop(self, operator):
+        """Called during template compilation with the name of a unary
+        operator to check if it should be intercepted at runtime.  If this
+        method returns `True`, :meth:`call_unop` is executed for this unary
+        operator.  The default implementation of :meth:`call_unop` will use
+        the :attr:`unop_table` dictionary to perform the operator with the
+        same logic as the builtin one.
+
+        The following unary operators are interceptable: ``+`` and ``-``
+
+        Intercepted calls are always slower than the native operator call,
+        so make sure only to intercept the ones you are interested in.
+
+        .. versionadded:: 2.6
+        """
+        return False
+
+    def __init__(self, *args, **kwargs):
+        Environment.__init__(self, *args, **kwargs)
+        self.globals["range"] = safe_range
+        self.binop_table = self.default_binop_table.copy()
+        self.unop_table = self.default_unop_table.copy()
+
+    def is_safe_attribute(self, obj, attr, value):
+        """The sandboxed environment will call this method to check if the
+        attribute of an object is safe to access.  Per default all attributes
+        starting with an underscore are considered private as well as the
+        special attributes of internal python objects as returned by the
+        :func:`is_internal_attribute` function.
+        """
+        return not (attr.startswith("_") or is_internal_attribute(obj, attr))
+
+    def is_safe_callable(self, obj):
+        """Check if an object is safely callable.  Per default a function is
+        considered safe unless the `unsafe_callable` attribute exists and is
+        True.  Override this method to alter the behavior, but this won't
+        affect the `unsafe` decorator from this module.
+        """
+        return not (
+            getattr(obj, "unsafe_callable", False) or getattr(obj, "alters_data", False)
+        )
+
+    def call_binop(self, context, operator, left, right):
+        """For intercepted binary operator calls (:meth:`intercepted_binops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.binop_table[operator](left, right)
+
+    def call_unop(self, context, operator, arg):
+        """For intercepted unary operator calls (:meth:`intercepted_unops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.unop_table[operator](arg)
+
+    def getitem(self, obj, argument):
+        """Subscribe an object from sandboxed code."""
+        try:
+            return obj[argument]
+        except (TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        value = getattr(obj, attr)
+                    except AttributeError:
+                        pass
+                    else:
+                        if self.is_safe_attribute(obj, argument, value):
+                            return value
+                        return self.unsafe_undefined(obj, argument)
+        return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Subscribe an object from sandboxed code and prefer the
+        attribute.  The attribute passed *must* be a bytestring.
+        """
+        try:
+            value = getattr(obj, attribute)
+        except AttributeError:
+            try:
+                return obj[attribute]
+            except (TypeError, LookupError):
+                pass
+        else:
+            if self.is_safe_attribute(obj, attribute, value):
+                return value
+            return self.unsafe_undefined(obj, attribute)
+        return self.undefined(obj=obj, name=attribute)
+
+    def unsafe_undefined(self, obj, attribute):
+        """Return an undefined object for unsafe attributes."""
+        return self.undefined(
+            "access to attribute %r of %r "
+            "object is unsafe." % (attribute, obj.__class__.__name__),
+            name=attribute,
+            obj=obj,
+            exc=SecurityError,
+        )
+
+    def format_string(self, s, args, kwargs, format_func=None):
+        """If a format call is detected, then this is routed through this
+        method so that our safety sandbox can be used for it.
+        """
+        if isinstance(s, Markup):
+            formatter = SandboxedEscapeFormatter(self, s.escape)
+        else:
+            formatter = SandboxedFormatter(self)
+
+        if format_func is not None and format_func.__name__ == "format_map":
+            if len(args) != 1 or kwargs:
+                raise TypeError(
+                    "format_map() takes exactly one argument %d given"
+                    % (len(args) + (kwargs is not None))
+                )
+
+            kwargs = args[0]
+            args = None
+
+        kwargs = _MagicFormatMapping(args, kwargs)
+        rv = formatter.vformat(s, args, kwargs)
+        return type(s)(rv)
+
+    def call(__self, __context, __obj, *args, **kwargs):  # noqa: B902
+        """Call an object from sandboxed code."""
+        fmt = inspect_format_method(__obj)
+        if fmt is not None:
+            return __self.format_string(fmt, args, kwargs, __obj)
+
+        # the double prefixes are to avoid double keyword argument
+        # errors when proxying the call.
+        if not __self.is_safe_callable(__obj):
+            raise SecurityError("%r is not safely callable" % (__obj,))
+        return __context.call(__obj, *args, **kwargs)
+
+
+class ImmutableSandboxedEnvironment(SandboxedEnvironment):
+    """Works exactly like the regular `SandboxedEnvironment` but does not
+    permit modifications on the builtin mutable objects `list`, `set`, and
+    `dict` by using the :func:`modifies_known_mutable` function.
+    """
+
+    def is_safe_attribute(self, obj, attr, value):
+        if not SandboxedEnvironment.is_safe_attribute(self, obj, attr, value):
+            return False
+        return not modifies_known_mutable(obj, attr)
+
+
+# This really is not a public API apparently.
+try:
+    from _string import formatter_field_name_split
+except ImportError:
+
+    def formatter_field_name_split(field_name):
+        return field_name._formatter_field_name_split()
+
+
+class SandboxedFormatterMixin(object):
+    def __init__(self, env):
+        self._env = env
+
+    def get_field(self, field_name, args, kwargs):
+        first, rest = formatter_field_name_split(field_name)
+        obj = self.get_value(first, args, kwargs)
+        for is_attr, i in rest:
+            if is_attr:
+                obj = self._env.getattr(obj, i)
+            else:
+                obj = self._env.getitem(obj, i)
+        return obj, first
+
+
+class SandboxedFormatter(SandboxedFormatterMixin, Formatter):
+    def __init__(self, env):
+        SandboxedFormatterMixin.__init__(self, env)
+        Formatter.__init__(self)
+
+
+class SandboxedEscapeFormatter(SandboxedFormatterMixin, EscapeFormatter):
+    def __init__(self, env, escape):
+        SandboxedFormatterMixin.__init__(self, env)
+        EscapeFormatter.__init__(self, escape)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/tests.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/tests.py
new file mode 100644
index 0000000000000000000000000000000000000000..fabd4ce51b6a049955d903762986974f59c625d0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/tests.py
@@ -0,0 +1,215 @@
+# -*- coding: utf-8 -*-
+"""Built-in template tests used with the ``is`` operator."""
+import decimal
+import operator
+import re
+
+from ._compat import abc
+from ._compat import integer_types
+from ._compat import string_types
+from ._compat import text_type
+from .runtime import Undefined
+
+number_re = re.compile(r"^-?\d+(\.\d+)?$")
+regex_type = type(number_re)
+test_callable = callable
+
+
+def test_odd(value):
+    """Return true if the variable is odd."""
+    return value % 2 == 1
+
+
+def test_even(value):
+    """Return true if the variable is even."""
+    return value % 2 == 0
+
+
+def test_divisibleby(value, num):
+    """Check if a variable is divisible by a number."""
+    return value % num == 0
+
+
+def test_defined(value):
+    """Return true if the variable is defined:
+
+    .. sourcecode:: jinja
+
+        {% if variable is defined %}
+            value of variable: {{ variable }}
+        {% else %}
+            variable is not defined
+        {% endif %}
+
+    See the :func:`default` filter for a simple way to set undefined
+    variables.
+    """
+    return not isinstance(value, Undefined)
+
+
+def test_undefined(value):
+    """Like :func:`defined` but the other way round."""
+    return isinstance(value, Undefined)
+
+
+def test_none(value):
+    """Return true if the variable is none."""
+    return value is None
+
+
+def test_boolean(value):
+    """Return true if the object is a boolean value.
+
+    .. versionadded:: 2.11
+    """
+    return value is True or value is False
+
+
+def test_false(value):
+    """Return true if the object is False.
+
+    .. versionadded:: 2.11
+    """
+    return value is False
+
+
+def test_true(value):
+    """Return true if the object is True.
+
+    .. versionadded:: 2.11
+    """
+    return value is True
+
+
+# NOTE: The existing 'number' test matches booleans and floats
+def test_integer(value):
+    """Return true if the object is an integer.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, integer_types) and value is not True and value is not False
+
+
+# NOTE: The existing 'number' test matches booleans and integers
+def test_float(value):
+    """Return true if the object is a float.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, float)
+
+
+def test_lower(value):
+    """Return true if the variable is lowercased."""
+    return text_type(value).islower()
+
+
+def test_upper(value):
+    """Return true if the variable is uppercased."""
+    return text_type(value).isupper()
+
+
+def test_string(value):
+    """Return true if the object is a string."""
+    return isinstance(value, string_types)
+
+
+def test_mapping(value):
+    """Return true if the object is a mapping (dict etc.).
+
+    .. versionadded:: 2.6
+    """
+    return isinstance(value, abc.Mapping)
+
+
+def test_number(value):
+    """Return true if the variable is a number."""
+    return isinstance(value, integer_types + (float, complex, decimal.Decimal))
+
+
+def test_sequence(value):
+    """Return true if the variable is a sequence. Sequences are variables
+    that are iterable.
+    """
+    try:
+        len(value)
+        value.__getitem__
+    except Exception:
+        return False
+    return True
+
+
+def test_sameas(value, other):
+    """Check if an object points to the same memory address than another
+    object:
+
+    .. sourcecode:: jinja
+
+        {% if foo.attribute is sameas false %}
+            the foo attribute really is the `False` singleton
+        {% endif %}
+    """
+    return value is other
+
+
+def test_iterable(value):
+    """Check if it's possible to iterate over an object."""
+    try:
+        iter(value)
+    except TypeError:
+        return False
+    return True
+
+
+def test_escaped(value):
+    """Check if the value is escaped."""
+    return hasattr(value, "__html__")
+
+
+def test_in(value, seq):
+    """Check if value is in seq.
+
+    .. versionadded:: 2.10
+    """
+    return value in seq
+
+
+TESTS = {
+    "odd": test_odd,
+    "even": test_even,
+    "divisibleby": test_divisibleby,
+    "defined": test_defined,
+    "undefined": test_undefined,
+    "none": test_none,
+    "boolean": test_boolean,
+    "false": test_false,
+    "true": test_true,
+    "integer": test_integer,
+    "float": test_float,
+    "lower": test_lower,
+    "upper": test_upper,
+    "string": test_string,
+    "mapping": test_mapping,
+    "number": test_number,
+    "sequence": test_sequence,
+    "iterable": test_iterable,
+    "callable": test_callable,
+    "sameas": test_sameas,
+    "escaped": test_escaped,
+    "in": test_in,
+    "==": operator.eq,
+    "eq": operator.eq,
+    "equalto": operator.eq,
+    "!=": operator.ne,
+    "ne": operator.ne,
+    ">": operator.gt,
+    "gt": operator.gt,
+    "greaterthan": operator.gt,
+    "ge": operator.ge,
+    ">=": operator.ge,
+    "<": operator.lt,
+    "lt": operator.lt,
+    "lessthan": operator.lt,
+    "<=": operator.le,
+    "le": operator.le,
+}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/utils.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b422ba9686fa5f3224564c7af4db7f4ce7ca3368
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/utils.py
@@ -0,0 +1,732 @@
+# -*- coding: utf-8 -*-
+import json
+import os
+import re
+import warnings
+from collections import deque
+from random import choice
+from random import randrange
+from threading import Lock
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import url_quote
+
+_word_split_re = re.compile(r"(\s+)")
+_punctuation_re = re.compile(
+    "^(?P<lead>(?:%s)*)(?P<middle>.*?)(?P<trail>(?:%s)*)$"
+    % (
+        "|".join(map(re.escape, ("(", "<", "&lt;"))),
+        "|".join(map(re.escape, (".", ",", ")", ">", "\n", "&gt;"))),
+    )
+)
+_simple_email_re = re.compile(r"^\S+@[a-zA-Z0-9._-]+\.[a-zA-Z0-9._-]+$")
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^;]+);")
+_letters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
+_digits = "0123456789"
+
+# special singleton representing missing values for the runtime
+missing = type("MissingType", (), {"__repr__": lambda x: "missing"})()
+
+# internal code
+internal_code = set()
+
+concat = u"".join
+
+_slash_escape = "\\/" not in json.dumps("/")
+
+
+def contextfunction(f):
+    """This decorator can be used to mark a function or method context callable.
+    A context callable is passed the active :class:`Context` as first argument when
+    called from the template.  This is useful if a function wants to get access
+    to the context or functions provided on the context object.  For example
+    a function that returns a sorted list of template variables the current
+    template exports could look like this::
+
+        @contextfunction
+        def get_exported_names(context):
+            return sorted(context.exported_vars)
+    """
+    f.contextfunction = True
+    return f
+
+
+def evalcontextfunction(f):
+    """This decorator can be used to mark a function or method as an eval
+    context callable.  This is similar to the :func:`contextfunction`
+    but instead of passing the context, an evaluation context object is
+    passed.  For more information about the eval context, see
+    :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfunction = True
+    return f
+
+
+def environmentfunction(f):
+    """This decorator can be used to mark a function or method as environment
+    callable.  This decorator works exactly like the :func:`contextfunction`
+    decorator just that the first argument is the active :class:`Environment`
+    and not context.
+    """
+    f.environmentfunction = True
+    return f
+
+
+def internalcode(f):
+    """Marks the function as internally used"""
+    internal_code.add(f.__code__)
+    return f
+
+
+def is_undefined(obj):
+    """Check if the object passed is undefined.  This does nothing more than
+    performing an instance check against :class:`Undefined` but looks nicer.
+    This can be used for custom filters or tests that want to react to
+    undefined variables.  For example a custom default filter can look like
+    this::
+
+        def default(var, default=''):
+            if is_undefined(var):
+                return default
+            return var
+    """
+    from .runtime import Undefined
+
+    return isinstance(obj, Undefined)
+
+
+def consume(iterable):
+    """Consumes an iterable without doing anything with it."""
+    for _ in iterable:
+        pass
+
+
+def clear_caches():
+    """Jinja keeps internal caches for environments and lexers.  These are
+    used so that Jinja doesn't have to recreate environments and lexers all
+    the time.  Normally you don't have to care about that but if you are
+    measuring memory consumption you may want to clean the caches.
+    """
+    from .environment import _spontaneous_environments
+    from .lexer import _lexer_cache
+
+    _spontaneous_environments.clear()
+    _lexer_cache.clear()
+
+
+def import_string(import_name, silent=False):
+    """Imports an object based on a string.  This is useful if you want to
+    use import paths as endpoints or something similar.  An import path can
+    be specified either in dotted notation (``xml.sax.saxutils.escape``)
+    or with a colon as object delimiter (``xml.sax.saxutils:escape``).
+
+    If the `silent` is True the return value will be `None` if the import
+    fails.
+
+    :return: imported object
+    """
+    try:
+        if ":" in import_name:
+            module, obj = import_name.split(":", 1)
+        elif "." in import_name:
+            module, _, obj = import_name.rpartition(".")
+        else:
+            return __import__(import_name)
+        return getattr(__import__(module, None, None, [obj]), obj)
+    except (ImportError, AttributeError):
+        if not silent:
+            raise
+
+
+def open_if_exists(filename, mode="rb"):
+    """Returns a file descriptor for the filename if that file exists,
+    otherwise ``None``.
+    """
+    if not os.path.isfile(filename):
+        return None
+
+    return open(filename, mode)
+
+
+def object_type_repr(obj):
+    """Returns the name of the object's type.  For some recognized
+    singletons the name of the object is returned instead. (For
+    example for `None` and `Ellipsis`).
+    """
+    if obj is None:
+        return "None"
+    elif obj is Ellipsis:
+        return "Ellipsis"
+
+    cls = type(obj)
+
+    # __builtin__ in 2.x, builtins in 3.x
+    if cls.__module__ in ("__builtin__", "builtins"):
+        name = cls.__name__
+    else:
+        name = cls.__module__ + "." + cls.__name__
+
+    return "%s object" % name
+
+
+def pformat(obj, verbose=False):
+    """Prettyprint an object.  Either use the `pretty` library or the
+    builtin `pprint`.
+    """
+    try:
+        from pretty import pretty
+
+        return pretty(obj, verbose=verbose)
+    except ImportError:
+        from pprint import pformat
+
+        return pformat(obj)
+
+
+def urlize(text, trim_url_limit=None, rel=None, target=None):
+    """Converts any URLs in text into clickable links. Works on http://,
+    https:// and www. links. Links can have trailing punctuation (periods,
+    commas, close-parens) and leading punctuation (opening parens) and
+    it'll still do the right thing.
+
+    If trim_url_limit is not None, the URLs in link text will be limited
+    to trim_url_limit characters.
+
+    If nofollow is True, the URLs in link text will get a rel="nofollow"
+    attribute.
+
+    If target is not None, a target attribute will be added to the link.
+    """
+    trim_url = (
+        lambda x, limit=trim_url_limit: limit is not None
+        and (x[:limit] + (len(x) >= limit and "..." or ""))
+        or x
+    )
+    words = _word_split_re.split(text_type(escape(text)))
+    rel_attr = rel and ' rel="%s"' % text_type(escape(rel)) or ""
+    target_attr = target and ' target="%s"' % escape(target) or ""
+
+    for i, word in enumerate(words):
+        match = _punctuation_re.match(word)
+        if match:
+            lead, middle, trail = match.groups()
+            if middle.startswith("www.") or (
+                "@" not in middle
+                and not middle.startswith("http://")
+                and not middle.startswith("https://")
+                and len(middle) > 0
+                and middle[0] in _letters + _digits
+                and (
+                    middle.endswith(".org")
+                    or middle.endswith(".net")
+                    or middle.endswith(".com")
+                )
+            ):
+                middle = '<a href="http://%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if middle.startswith("http://") or middle.startswith("https://"):
+                middle = '<a href="%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if (
+                "@" in middle
+                and not middle.startswith("www.")
+                and ":" not in middle
+                and _simple_email_re.match(middle)
+            ):
+                middle = '<a href="mailto:%s">%s</a>' % (middle, middle)
+            if lead + middle + trail != word:
+                words[i] = lead + middle + trail
+    return u"".join(words)
+
+
+def generate_lorem_ipsum(n=5, html=True, min=20, max=100):
+    """Generate some lorem ipsum for the template."""
+    from .constants import LOREM_IPSUM_WORDS
+
+    words = LOREM_IPSUM_WORDS.split()
+    result = []
+
+    for _ in range(n):
+        next_capitalized = True
+        last_comma = last_fullstop = 0
+        word = None
+        last = None
+        p = []
+
+        # each paragraph contains out of 20 to 100 words.
+        for idx, _ in enumerate(range(randrange(min, max))):
+            while True:
+                word = choice(words)
+                if word != last:
+                    last = word
+                    break
+            if next_capitalized:
+                word = word.capitalize()
+                next_capitalized = False
+            # add commas
+            if idx - randrange(3, 8) > last_comma:
+                last_comma = idx
+                last_fullstop += 2
+                word += ","
+            # add end of sentences
+            if idx - randrange(10, 20) > last_fullstop:
+                last_comma = last_fullstop = idx
+                word += "."
+                next_capitalized = True
+            p.append(word)
+
+        # ensure that the paragraph ends with a dot.
+        p = u" ".join(p)
+        if p.endswith(","):
+            p = p[:-1] + "."
+        elif not p.endswith("."):
+            p += "."
+        result.append(p)
+
+    if not html:
+        return u"\n\n".join(result)
+    return Markup(u"\n".join(u"<p>%s</p>" % escape(x) for x in result))
+
+
+def unicode_urlencode(obj, charset="utf-8", for_qs=False):
+    """Quote a string for use in a URL using the given charset.
+
+    This function is misnamed, it is a wrapper around
+    :func:`urllib.parse.quote`.
+
+    :param obj: String or bytes to quote. Other types are converted to
+        string then encoded to bytes using the given charset.
+    :param charset: Encode text to bytes using this charset.
+    :param for_qs: Quote "/" and use "+" for spaces.
+    """
+    if not isinstance(obj, string_types):
+        obj = text_type(obj)
+
+    if isinstance(obj, text_type):
+        obj = obj.encode(charset)
+
+    safe = b"" if for_qs else b"/"
+    rv = url_quote(obj, safe)
+
+    if not isinstance(rv, text_type):
+        rv = rv.decode("utf-8")
+
+    if for_qs:
+        rv = rv.replace("%20", "+")
+
+    return rv
+
+
+class LRUCache(object):
+    """A simple LRU Cache implementation."""
+
+    # this is fast for small capacities (something below 1000) but doesn't
+    # scale.  But as long as it's only used as storage for templates this
+    # won't do any harm.
+
+    def __init__(self, capacity):
+        self.capacity = capacity
+        self._mapping = {}
+        self._queue = deque()
+        self._postinit()
+
+    def _postinit(self):
+        # alias all queue methods for faster lookup
+        self._popleft = self._queue.popleft
+        self._pop = self._queue.pop
+        self._remove = self._queue.remove
+        self._wlock = Lock()
+        self._append = self._queue.append
+
+    def __getstate__(self):
+        return {
+            "capacity": self.capacity,
+            "_mapping": self._mapping,
+            "_queue": self._queue,
+        }
+
+    def __setstate__(self, d):
+        self.__dict__.update(d)
+        self._postinit()
+
+    def __getnewargs__(self):
+        return (self.capacity,)
+
+    def copy(self):
+        """Return a shallow copy of the instance."""
+        rv = self.__class__(self.capacity)
+        rv._mapping.update(self._mapping)
+        rv._queue.extend(self._queue)
+        return rv
+
+    def get(self, key, default=None):
+        """Return an item from the cache dict or `default`"""
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def setdefault(self, key, default=None):
+        """Set `default` if the key is not in the cache otherwise
+        leave unchanged. Return the value of this key.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            self[key] = default
+            return default
+
+    def clear(self):
+        """Clear the cache."""
+        self._wlock.acquire()
+        try:
+            self._mapping.clear()
+            self._queue.clear()
+        finally:
+            self._wlock.release()
+
+    def __contains__(self, key):
+        """Check if a key exists in this cache."""
+        return key in self._mapping
+
+    def __len__(self):
+        """Return the current size of the cache."""
+        return len(self._mapping)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self._mapping)
+
+    def __getitem__(self, key):
+        """Get an item from the cache. Moves the item up so that it has the
+        highest priority then.
+
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            rv = self._mapping[key]
+            if self._queue[-1] != key:
+                try:
+                    self._remove(key)
+                except ValueError:
+                    # if something removed the key from the container
+                    # when we read, ignore the ValueError that we would
+                    # get otherwise.
+                    pass
+                self._append(key)
+            return rv
+        finally:
+            self._wlock.release()
+
+    def __setitem__(self, key, value):
+        """Sets the value for an item. Moves the item up so that it
+        has the highest priority then.
+        """
+        self._wlock.acquire()
+        try:
+            if key in self._mapping:
+                self._remove(key)
+            elif len(self._mapping) == self.capacity:
+                del self._mapping[self._popleft()]
+            self._append(key)
+            self._mapping[key] = value
+        finally:
+            self._wlock.release()
+
+    def __delitem__(self, key):
+        """Remove an item from the cache dict.
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            del self._mapping[key]
+            try:
+                self._remove(key)
+            except ValueError:
+                pass
+        finally:
+            self._wlock.release()
+
+    def items(self):
+        """Return a list of items."""
+        result = [(key, self._mapping[key]) for key in list(self._queue)]
+        result.reverse()
+        return result
+
+    def iteritems(self):
+        """Iterate over all items."""
+        warnings.warn(
+            "'iteritems()' will be removed in version 3.0. Use"
+            " 'iter(cache.items())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.items())
+
+    def values(self):
+        """Return a list of all values."""
+        return [x[1] for x in self.items()]
+
+    def itervalue(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalue()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def itervalues(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalues()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def keys(self):
+        """Return a list of all keys ordered by most recent usage."""
+        return list(self)
+
+    def iterkeys(self):
+        """Iterate over all keys in the cache dict, ordered by
+        the most recent usage.
+        """
+        warnings.warn(
+            "'iterkeys()' will be removed in version 3.0. Use"
+            " 'iter(cache.keys())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self)
+
+    def __iter__(self):
+        return reversed(tuple(self._queue))
+
+    def __reversed__(self):
+        """Iterate over the keys in the cache dict, oldest items
+        coming first.
+        """
+        return iter(tuple(self._queue))
+
+    __copy__ = copy
+
+
+abc.MutableMapping.register(LRUCache)
+
+
+def select_autoescape(
+    enabled_extensions=("html", "htm", "xml"),
+    disabled_extensions=(),
+    default_for_string=True,
+    default=False,
+):
+    """Intelligently sets the initial value of autoescaping based on the
+    filename of the template.  This is the recommended way to configure
+    autoescaping if you do not want to write a custom function yourself.
+
+    If you want to enable it for all templates created from strings or
+    for all templates with `.html` and `.xml` extensions::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            enabled_extensions=('html', 'xml'),
+            default_for_string=True,
+        ))
+
+    Example configuration to turn it on at all times except if the template
+    ends with `.txt`::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            disabled_extensions=('txt',),
+            default_for_string=True,
+            default=True,
+        ))
+
+    The `enabled_extensions` is an iterable of all the extensions that
+    autoescaping should be enabled for.  Likewise `disabled_extensions` is
+    a list of all templates it should be disabled for.  If a template is
+    loaded from a string then the default from `default_for_string` is used.
+    If nothing matches then the initial value of autoescaping is set to the
+    value of `default`.
+
+    For security reasons this function operates case insensitive.
+
+    .. versionadded:: 2.9
+    """
+    enabled_patterns = tuple("." + x.lstrip(".").lower() for x in enabled_extensions)
+    disabled_patterns = tuple("." + x.lstrip(".").lower() for x in disabled_extensions)
+
+    def autoescape(template_name):
+        if template_name is None:
+            return default_for_string
+        template_name = template_name.lower()
+        if template_name.endswith(enabled_patterns):
+            return True
+        if template_name.endswith(disabled_patterns):
+            return False
+        return default
+
+    return autoescape
+
+
+def htmlsafe_json_dumps(obj, dumper=None, **kwargs):
+    """Works exactly like :func:`dumps` but is safe for use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+    """
+    if dumper is None:
+        dumper = json.dumps
+    rv = (
+        dumper(obj, **kwargs)
+        .replace(u"<", u"\\u003c")
+        .replace(u">", u"\\u003e")
+        .replace(u"&", u"\\u0026")
+        .replace(u"'", u"\\u0027")
+    )
+    return Markup(rv)
+
+
+class Cycler(object):
+    """Cycle through values by yield them one at a time, then restarting
+    once the end is reached. Available as ``cycler`` in templates.
+
+    Similar to ``loop.cycle``, but can be used outside loops or across
+    multiple loops. For example, render a list of folders and files in a
+    list, alternating giving them "odd" and "even" classes.
+
+    .. code-block:: html+jinja
+
+        {% set row_class = cycler("odd", "even") %}
+        <ul class="browser">
+        {% for folder in folders %}
+          <li class="folder {{ row_class.next() }}">{{ folder }}
+        {% endfor %}
+        {% for file in files %}
+          <li class="file {{ row_class.next() }}">{{ file }}
+        {% endfor %}
+        </ul>
+
+    :param items: Each positional argument will be yielded in the order
+        given for each cycle.
+
+    .. versionadded:: 2.1
+    """
+
+    def __init__(self, *items):
+        if not items:
+            raise RuntimeError("at least one item has to be provided")
+        self.items = items
+        self.pos = 0
+
+    def reset(self):
+        """Resets the current item to the first item."""
+        self.pos = 0
+
+    @property
+    def current(self):
+        """Return the current item. Equivalent to the item that will be
+        returned next time :meth:`next` is called.
+        """
+        return self.items[self.pos]
+
+    def next(self):
+        """Return the current item, then advance :attr:`current` to the
+        next item.
+        """
+        rv = self.current
+        self.pos = (self.pos + 1) % len(self.items)
+        return rv
+
+    __next__ = next
+
+
+class Joiner(object):
+    """A joining helper for templates."""
+
+    def __init__(self, sep=u", "):
+        self.sep = sep
+        self.used = False
+
+    def __call__(self):
+        if not self.used:
+            self.used = True
+            return u""
+        return self.sep
+
+
+class Namespace(object):
+    """A namespace object that can hold arbitrary attributes.  It may be
+    initialized from a dictionary or with keyword arguments."""
+
+    def __init__(*args, **kwargs):  # noqa: B902
+        self, args = args[0], args[1:]
+        self.__attrs = dict(*args, **kwargs)
+
+    def __getattribute__(self, name):
+        # __class__ is needed for the awaitable check in async mode
+        if name in {"_Namespace__attrs", "__class__"}:
+            return object.__getattribute__(self, name)
+        try:
+            return self.__attrs[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setitem__(self, name, value):
+        self.__attrs[name] = value
+
+    def __repr__(self):
+        return "<Namespace %r>" % self.__attrs
+
+
+# does this python version support async for in and async generators?
+try:
+    exec("async def _():\n async for _ in ():\n  yield _")
+    have_async_gen = True
+except SyntaxError:
+    have_async_gen = False
+
+
+def soft_unicode(s):
+    from markupsafe import soft_unicode
+
+    warnings.warn(
+        "'jinja2.utils.soft_unicode' will be removed in version 3.0."
+        " Use 'markupsafe.soft_unicode' instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return soft_unicode(s)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/visitor.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/visitor.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1365bf10e5346a60df625faa5e118d4086b1395
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/jinja2/visitor.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""API for traversing the AST nodes. Implemented by the compiler and
+meta introspection.
+"""
+from .nodes import Node
+
+
+class NodeVisitor(object):
+    """Walks the abstract syntax tree and call visitor functions for every
+    node found.  The visitor functions may return values which will be
+    forwarded by the `visit` method.
+
+    Per default the visitor functions for the nodes are ``'visit_'`` +
+    class name of the node.  So a `TryFinally` node visit function would
+    be `visit_TryFinally`.  This behavior can be changed by overriding
+    the `get_visitor` function.  If no visitor function exists for a node
+    (return value `None`) the `generic_visit` visitor is used instead.
+    """
+
+    def get_visitor(self, node):
+        """Return the visitor function for this node or `None` if no visitor
+        exists for this node.  In that case the generic visit function is
+        used instead.
+        """
+        method = "visit_" + node.__class__.__name__
+        return getattr(self, method, None)
+
+    def visit(self, node, *args, **kwargs):
+        """Visit a node."""
+        f = self.get_visitor(node)
+        if f is not None:
+            return f(node, *args, **kwargs)
+        return self.generic_visit(node, *args, **kwargs)
+
+    def generic_visit(self, node, *args, **kwargs):
+        """Called if no explicit visitor function exists for a node."""
+        for node in node.iter_child_nodes():
+            self.visit(node, *args, **kwargs)
+
+
+class NodeTransformer(NodeVisitor):
+    """Walks the abstract syntax tree and allows modifications of nodes.
+
+    The `NodeTransformer` will walk the AST and use the return value of the
+    visitor functions to replace or remove the old node.  If the return
+    value of the visitor function is `None` the node will be removed
+    from the previous location otherwise it's replaced with the return
+    value.  The return value may be the original node in which case no
+    replacement takes place.
+    """
+
+    def generic_visit(self, node, *args, **kwargs):
+        for field, old_value in node.iter_fields():
+            if isinstance(old_value, list):
+                new_values = []
+                for value in old_value:
+                    if isinstance(value, Node):
+                        value = self.visit(value, *args, **kwargs)
+                        if value is None:
+                            continue
+                        elif not isinstance(value, Node):
+                            new_values.extend(value)
+                            continue
+                    new_values.append(value)
+                old_value[:] = new_values
+            elif isinstance(old_value, Node):
+                new_node = self.visit(old_value, *args, **kwargs)
+                if new_node is None:
+                    delattr(node, field)
+                else:
+                    setattr(node, field, new_node)
+        return node
+
+    def visit_list(self, node, *args, **kwargs):
+        """As transformers may return lists in some places this method
+        can be used to enforce a list as return value.
+        """
+        rv = self.visit(node, *args, **kwargs)
+        if not isinstance(rv, list):
+            rv = [rv]
+        return rv
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..da05ed328a476bdcea7c0bd4d335d9e721cbab77
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/__init__.py
@@ -0,0 +1,327 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe
+~~~~~~~~~~
+
+Implements an escape function and a Markup string to replace HTML
+special characters with safe representations.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import re
+import string
+
+from ._compat import int_types
+from ._compat import iteritems
+from ._compat import Mapping
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import unichr
+
+__version__ = "1.1.1"
+
+__all__ = ["Markup", "soft_unicode", "escape", "escape_silent"]
+
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^& ;]+);")
+
+
+class Markup(text_type):
+    """A string that is ready to be safely inserted into an HTML or XML
+    document, either because it was escaped or because it was marked
+    safe.
+
+    Passing an object to the constructor converts it to text and wraps
+    it to mark it safe without escaping. To escape the text, use the
+    :meth:`escape` class method instead.
+
+    >>> Markup('Hello, <em>World</em>!')
+    Markup('Hello, <em>World</em>!')
+    >>> Markup(42)
+    Markup('42')
+    >>> Markup.escape('Hello, <em>World</em>!')
+    Markup('Hello &lt;em&gt;World&lt;/em&gt;!')
+
+    This implements the ``__html__()`` interface that some frameworks
+    use. Passing an object that implements ``__html__()`` will wrap the
+    output of that method, marking it safe.
+
+    >>> class Foo:
+    ...     def __html__(self):
+    ...         return '<a href="/foo">foo</a>'
+    ...
+    >>> Markup(Foo())
+    Markup('<a href="/foo">foo</a>')
+
+    This is a subclass of the text type (``str`` in Python 3,
+    ``unicode`` in Python 2). It has the same methods as that type, but
+    all methods escape their arguments and return a ``Markup`` instance.
+
+    >>> Markup('<em>%s</em>') % 'foo & bar'
+    Markup('<em>foo &amp; bar</em>')
+    >>> Markup('<em>Hello</em> ') + '<foo>'
+    Markup('<em>Hello</em> &lt;foo&gt;')
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, base=u"", encoding=None, errors="strict"):
+        if hasattr(base, "__html__"):
+            base = base.__html__()
+        if encoding is None:
+            return text_type.__new__(cls, base)
+        return text_type.__new__(cls, base, encoding, errors)
+
+    def __html__(self):
+        return self
+
+    def __add__(self, other):
+        if isinstance(other, string_types) or hasattr(other, "__html__"):
+            return self.__class__(super(Markup, self).__add__(self.escape(other)))
+        return NotImplemented
+
+    def __radd__(self, other):
+        if hasattr(other, "__html__") or isinstance(other, string_types):
+            return self.escape(other).__add__(self)
+        return NotImplemented
+
+    def __mul__(self, num):
+        if isinstance(num, int_types):
+            return self.__class__(text_type.__mul__(self, num))
+        return NotImplemented
+
+    __rmul__ = __mul__
+
+    def __mod__(self, arg):
+        if isinstance(arg, tuple):
+            arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
+        else:
+            arg = _MarkupEscapeHelper(arg, self.escape)
+        return self.__class__(text_type.__mod__(self, arg))
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, text_type.__repr__(self))
+
+    def join(self, seq):
+        return self.__class__(text_type.join(self, map(self.escape, seq)))
+
+    join.__doc__ = text_type.join.__doc__
+
+    def split(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.split(self, *args, **kwargs)))
+
+    split.__doc__ = text_type.split.__doc__
+
+    def rsplit(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.rsplit(self, *args, **kwargs)))
+
+    rsplit.__doc__ = text_type.rsplit.__doc__
+
+    def splitlines(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.splitlines(self, *args, **kwargs)))
+
+    splitlines.__doc__ = text_type.splitlines.__doc__
+
+    def unescape(self):
+        """Convert escaped markup back into a text string. This replaces
+        HTML entities with the characters they represent.
+
+        >>> Markup('Main &raquo; <em>About</em>').unescape()
+        'Main » <em>About</em>'
+        """
+        from ._constants import HTML_ENTITIES
+
+        def handle_match(m):
+            name = m.group(1)
+            if name in HTML_ENTITIES:
+                return unichr(HTML_ENTITIES[name])
+            try:
+                if name[:2] in ("#x", "#X"):
+                    return unichr(int(name[2:], 16))
+                elif name.startswith("#"):
+                    return unichr(int(name[1:]))
+            except ValueError:
+                pass
+            # Don't modify unexpected input.
+            return m.group()
+
+        return _entity_re.sub(handle_match, text_type(self))
+
+    def striptags(self):
+        """:meth:`unescape` the markup, remove tags, and normalize
+        whitespace to single spaces.
+
+        >>> Markup('Main &raquo;\t<em>About</em>').striptags()
+        'Main » About'
+        """
+        stripped = u" ".join(_striptags_re.sub("", self).split())
+        return Markup(stripped).unescape()
+
+    @classmethod
+    def escape(cls, s):
+        """Escape a string. Calls :func:`escape` and ensures that for
+        subclasses the correct type is returned.
+        """
+        rv = escape(s)
+        if rv.__class__ is not cls:
+            return cls(rv)
+        return rv
+
+    def make_simple_escaping_wrapper(name):  # noqa: B902
+        orig = getattr(text_type, name)
+
+        def func(self, *args, **kwargs):
+            args = _escape_argspec(list(args), enumerate(args), self.escape)
+            _escape_argspec(kwargs, iteritems(kwargs), self.escape)
+            return self.__class__(orig(self, *args, **kwargs))
+
+        func.__name__ = orig.__name__
+        func.__doc__ = orig.__doc__
+        return func
+
+    for method in (
+        "__getitem__",
+        "capitalize",
+        "title",
+        "lower",
+        "upper",
+        "replace",
+        "ljust",
+        "rjust",
+        "lstrip",
+        "rstrip",
+        "center",
+        "strip",
+        "translate",
+        "expandtabs",
+        "swapcase",
+        "zfill",
+    ):
+        locals()[method] = make_simple_escaping_wrapper(method)
+
+    def partition(self, sep):
+        return tuple(map(self.__class__, text_type.partition(self, self.escape(sep))))
+
+    def rpartition(self, sep):
+        return tuple(map(self.__class__, text_type.rpartition(self, self.escape(sep))))
+
+    def format(self, *args, **kwargs):
+        formatter = EscapeFormatter(self.escape)
+        kwargs = _MagicFormatMapping(args, kwargs)
+        return self.__class__(formatter.vformat(self, args, kwargs))
+
+    def __html_format__(self, format_spec):
+        if format_spec:
+            raise ValueError("Unsupported format specification " "for Markup.")
+        return self
+
+    # not in python 3
+    if hasattr(text_type, "__getslice__"):
+        __getslice__ = make_simple_escaping_wrapper("__getslice__")
+
+    del method, make_simple_escaping_wrapper
+
+
+class _MagicFormatMapping(Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See http://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+if hasattr(text_type, "format"):
+
+    class EscapeFormatter(string.Formatter):
+        def __init__(self, escape):
+            self.escape = escape
+
+        def format_field(self, value, format_spec):
+            if hasattr(value, "__html_format__"):
+                rv = value.__html_format__(format_spec)
+            elif hasattr(value, "__html__"):
+                if format_spec:
+                    raise ValueError(
+                        "Format specifier {0} given, but {1} does not"
+                        " define __html_format__. A class that defines"
+                        " __html__ must define __html_format__ to work"
+                        " with format specifiers.".format(format_spec, type(value))
+                    )
+                rv = value.__html__()
+            else:
+                # We need to make sure the format spec is unicode here as
+                # otherwise the wrong callback methods are invoked.  For
+                # instance a byte string there would invoke __str__ and
+                # not __unicode__.
+                rv = string.Formatter.format_field(self, value, text_type(format_spec))
+            return text_type(self.escape(rv))
+
+
+def _escape_argspec(obj, iterable, escape):
+    """Helper for various string-wrapped functions."""
+    for key, value in iterable:
+        if hasattr(value, "__html__") or isinstance(value, string_types):
+            obj[key] = escape(value)
+    return obj
+
+
+class _MarkupEscapeHelper(object):
+    """Helper for Markup.__mod__"""
+
+    def __init__(self, obj, escape):
+        self.obj = obj
+        self.escape = escape
+
+    def __getitem__(self, item):
+        return _MarkupEscapeHelper(self.obj[item], self.escape)
+
+    def __str__(self):
+        return text_type(self.escape(self.obj))
+
+    __unicode__ = __str__
+
+    def __repr__(self):
+        return str(self.escape(repr(self.obj)))
+
+    def __int__(self):
+        return int(self.obj)
+
+    def __float__(self):
+        return float(self.obj)
+
+
+# we have to import it down here as the speedups and native
+# modules imports the markup type which is define above.
+try:
+    from ._speedups import escape, escape_silent, soft_unicode
+except ImportError:
+    from ._native import escape, escape_silent, soft_unicode
+
+if not PY2:
+    soft_str = soft_unicode
+    __all__.append("soft_str")
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_compat.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc05090f9e88da2c16a75844bcb6d5043025581b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_compat.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._compat
+~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import sys
+
+PY2 = sys.version_info[0] == 2
+
+if not PY2:
+    text_type = str
+    string_types = (str,)
+    unichr = chr
+    int_types = (int,)
+
+    def iteritems(x):
+        return iter(x.items())
+
+    from collections.abc import Mapping
+
+else:
+    text_type = unicode
+    string_types = (str, unicode)
+    unichr = unichr
+    int_types = (int, long)
+
+    def iteritems(x):
+        return x.iteritems()
+
+    from collections import Mapping
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_constants.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c57c2d29452a94c22708e1b749f0b7e8c14bf1b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_constants.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._constants
+~~~~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+
+HTML_ENTITIES = {
+    "AElig": 198,
+    "Aacute": 193,
+    "Acirc": 194,
+    "Agrave": 192,
+    "Alpha": 913,
+    "Aring": 197,
+    "Atilde": 195,
+    "Auml": 196,
+    "Beta": 914,
+    "Ccedil": 199,
+    "Chi": 935,
+    "Dagger": 8225,
+    "Delta": 916,
+    "ETH": 208,
+    "Eacute": 201,
+    "Ecirc": 202,
+    "Egrave": 200,
+    "Epsilon": 917,
+    "Eta": 919,
+    "Euml": 203,
+    "Gamma": 915,
+    "Iacute": 205,
+    "Icirc": 206,
+    "Igrave": 204,
+    "Iota": 921,
+    "Iuml": 207,
+    "Kappa": 922,
+    "Lambda": 923,
+    "Mu": 924,
+    "Ntilde": 209,
+    "Nu": 925,
+    "OElig": 338,
+    "Oacute": 211,
+    "Ocirc": 212,
+    "Ograve": 210,
+    "Omega": 937,
+    "Omicron": 927,
+    "Oslash": 216,
+    "Otilde": 213,
+    "Ouml": 214,
+    "Phi": 934,
+    "Pi": 928,
+    "Prime": 8243,
+    "Psi": 936,
+    "Rho": 929,
+    "Scaron": 352,
+    "Sigma": 931,
+    "THORN": 222,
+    "Tau": 932,
+    "Theta": 920,
+    "Uacute": 218,
+    "Ucirc": 219,
+    "Ugrave": 217,
+    "Upsilon": 933,
+    "Uuml": 220,
+    "Xi": 926,
+    "Yacute": 221,
+    "Yuml": 376,
+    "Zeta": 918,
+    "aacute": 225,
+    "acirc": 226,
+    "acute": 180,
+    "aelig": 230,
+    "agrave": 224,
+    "alefsym": 8501,
+    "alpha": 945,
+    "amp": 38,
+    "and": 8743,
+    "ang": 8736,
+    "apos": 39,
+    "aring": 229,
+    "asymp": 8776,
+    "atilde": 227,
+    "auml": 228,
+    "bdquo": 8222,
+    "beta": 946,
+    "brvbar": 166,
+    "bull": 8226,
+    "cap": 8745,
+    "ccedil": 231,
+    "cedil": 184,
+    "cent": 162,
+    "chi": 967,
+    "circ": 710,
+    "clubs": 9827,
+    "cong": 8773,
+    "copy": 169,
+    "crarr": 8629,
+    "cup": 8746,
+    "curren": 164,
+    "dArr": 8659,
+    "dagger": 8224,
+    "darr": 8595,
+    "deg": 176,
+    "delta": 948,
+    "diams": 9830,
+    "divide": 247,
+    "eacute": 233,
+    "ecirc": 234,
+    "egrave": 232,
+    "empty": 8709,
+    "emsp": 8195,
+    "ensp": 8194,
+    "epsilon": 949,
+    "equiv": 8801,
+    "eta": 951,
+    "eth": 240,
+    "euml": 235,
+    "euro": 8364,
+    "exist": 8707,
+    "fnof": 402,
+    "forall": 8704,
+    "frac12": 189,
+    "frac14": 188,
+    "frac34": 190,
+    "frasl": 8260,
+    "gamma": 947,
+    "ge": 8805,
+    "gt": 62,
+    "hArr": 8660,
+    "harr": 8596,
+    "hearts": 9829,
+    "hellip": 8230,
+    "iacute": 237,
+    "icirc": 238,
+    "iexcl": 161,
+    "igrave": 236,
+    "image": 8465,
+    "infin": 8734,
+    "int": 8747,
+    "iota": 953,
+    "iquest": 191,
+    "isin": 8712,
+    "iuml": 239,
+    "kappa": 954,
+    "lArr": 8656,
+    "lambda": 955,
+    "lang": 9001,
+    "laquo": 171,
+    "larr": 8592,
+    "lceil": 8968,
+    "ldquo": 8220,
+    "le": 8804,
+    "lfloor": 8970,
+    "lowast": 8727,
+    "loz": 9674,
+    "lrm": 8206,
+    "lsaquo": 8249,
+    "lsquo": 8216,
+    "lt": 60,
+    "macr": 175,
+    "mdash": 8212,
+    "micro": 181,
+    "middot": 183,
+    "minus": 8722,
+    "mu": 956,
+    "nabla": 8711,
+    "nbsp": 160,
+    "ndash": 8211,
+    "ne": 8800,
+    "ni": 8715,
+    "not": 172,
+    "notin": 8713,
+    "nsub": 8836,
+    "ntilde": 241,
+    "nu": 957,
+    "oacute": 243,
+    "ocirc": 244,
+    "oelig": 339,
+    "ograve": 242,
+    "oline": 8254,
+    "omega": 969,
+    "omicron": 959,
+    "oplus": 8853,
+    "or": 8744,
+    "ordf": 170,
+    "ordm": 186,
+    "oslash": 248,
+    "otilde": 245,
+    "otimes": 8855,
+    "ouml": 246,
+    "para": 182,
+    "part": 8706,
+    "permil": 8240,
+    "perp": 8869,
+    "phi": 966,
+    "pi": 960,
+    "piv": 982,
+    "plusmn": 177,
+    "pound": 163,
+    "prime": 8242,
+    "prod": 8719,
+    "prop": 8733,
+    "psi": 968,
+    "quot": 34,
+    "rArr": 8658,
+    "radic": 8730,
+    "rang": 9002,
+    "raquo": 187,
+    "rarr": 8594,
+    "rceil": 8969,
+    "rdquo": 8221,
+    "real": 8476,
+    "reg": 174,
+    "rfloor": 8971,
+    "rho": 961,
+    "rlm": 8207,
+    "rsaquo": 8250,
+    "rsquo": 8217,
+    "sbquo": 8218,
+    "scaron": 353,
+    "sdot": 8901,
+    "sect": 167,
+    "shy": 173,
+    "sigma": 963,
+    "sigmaf": 962,
+    "sim": 8764,
+    "spades": 9824,
+    "sub": 8834,
+    "sube": 8838,
+    "sum": 8721,
+    "sup": 8835,
+    "sup1": 185,
+    "sup2": 178,
+    "sup3": 179,
+    "supe": 8839,
+    "szlig": 223,
+    "tau": 964,
+    "there4": 8756,
+    "theta": 952,
+    "thetasym": 977,
+    "thinsp": 8201,
+    "thorn": 254,
+    "tilde": 732,
+    "times": 215,
+    "trade": 8482,
+    "uArr": 8657,
+    "uacute": 250,
+    "uarr": 8593,
+    "ucirc": 251,
+    "ugrave": 249,
+    "uml": 168,
+    "upsih": 978,
+    "upsilon": 965,
+    "uuml": 252,
+    "weierp": 8472,
+    "xi": 958,
+    "yacute": 253,
+    "yen": 165,
+    "yuml": 255,
+    "zeta": 950,
+    "zwj": 8205,
+    "zwnj": 8204,
+}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_native.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_native.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd08752cd8940f01f85e51a6477cf72b3e5e517e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_native.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._native
+~~~~~~~~~~~~~~~~~~
+
+Native Python implementation used when the C module is not compiled.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+from . import Markup
+from ._compat import text_type
+
+
+def escape(s):
+    """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
+    the string with HTML-safe sequences. Use this if you need to display
+    text that might contain such characters in HTML.
+
+    If the object has an ``__html__`` method, it is called and the
+    return value is assumed to already be safe for HTML.
+
+    :param s: An object to be converted to a string and escaped.
+    :return: A :class:`Markup` string with the escaped text.
+    """
+    if hasattr(s, "__html__"):
+        return Markup(s.__html__())
+    return Markup(
+        text_type(s)
+        .replace("&", "&amp;")
+        .replace(">", "&gt;")
+        .replace("<", "&lt;")
+        .replace("'", "&#39;")
+        .replace('"', "&#34;")
+    )
+
+
+def escape_silent(s):
+    """Like :func:`escape` but treats ``None`` as the empty string.
+    Useful with optional values, as otherwise you get the string
+    ``'None'`` when the value is ``None``.
+
+    >>> escape(None)
+    Markup('None')
+    >>> escape_silent(None)
+    Markup('')
+    """
+    if s is None:
+        return Markup()
+    return escape(s)
+
+
+def soft_unicode(s):
+    """Convert an object to a string if it isn't already. This preserves
+    a :class:`Markup` string rather than converting it back to a basic
+    string, so it will still be marked as safe and won't be escaped
+    again.
+
+    >>> value = escape('<User 1>')
+    >>> value
+    Markup('&lt;User 1&gt;')
+    >>> escape(str(value))
+    Markup('&amp;lt;User 1&amp;gt;')
+    >>> escape(soft_unicode(value))
+    Markup('&lt;User 1&gt;')
+    """
+    if not isinstance(s, text_type):
+        s = text_type(s)
+    return s
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.c b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.c
new file mode 100644
index 0000000000000000000000000000000000000000..12d2c4a7d8352f6bf1deb19790453eb529827a78
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.c
@@ -0,0 +1,423 @@
+/**
+ * markupsafe._speedups
+ * ~~~~~~~~~~~~~~~~~~~~
+ *
+ * C implementation of escaping for better performance. Used instead of
+ * the native Python implementation when compiled.
+ *
+ * :copyright: 2010 Pallets
+ * :license: BSD-3-Clause
+ */
+#include <Python.h>
+
+#if PY_MAJOR_VERSION < 3
+#define ESCAPED_CHARS_TABLE_SIZE 63
+#define UNICHR(x) (PyUnicode_AS_UNICODE((PyUnicodeObject*)PyUnicode_DecodeASCII(x, strlen(x), NULL)));
+
+static Py_ssize_t escaped_chars_delta_len[ESCAPED_CHARS_TABLE_SIZE];
+static Py_UNICODE *escaped_chars_repl[ESCAPED_CHARS_TABLE_SIZE];
+#endif
+
+static PyObject* markup;
+
+static int
+init_constants(void)
+{
+	PyObject *module;
+
+#if PY_MAJOR_VERSION < 3
+	/* mapping of characters to replace */
+	escaped_chars_repl['"'] = UNICHR("&#34;");
+	escaped_chars_repl['\''] = UNICHR("&#39;");
+	escaped_chars_repl['&'] = UNICHR("&amp;");
+	escaped_chars_repl['<'] = UNICHR("&lt;");
+	escaped_chars_repl['>'] = UNICHR("&gt;");
+
+	/* lengths of those characters when replaced - 1 */
+	memset(escaped_chars_delta_len, 0, sizeof (escaped_chars_delta_len));
+	escaped_chars_delta_len['"'] = escaped_chars_delta_len['\''] = \
+		escaped_chars_delta_len['&'] = 4;
+	escaped_chars_delta_len['<'] = escaped_chars_delta_len['>'] = 3;
+#endif
+
+	/* import markup type so that we can mark the return value */
+	module = PyImport_ImportModule("markupsafe");
+	if (!module)
+		return 0;
+	markup = PyObject_GetAttrString(module, "Markup");
+	Py_DECREF(module);
+
+	return 1;
+}
+
+#if PY_MAJOR_VERSION < 3
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	PyUnicodeObject *out;
+	Py_UNICODE *inp = PyUnicode_AS_UNICODE(in);
+	const Py_UNICODE *inp_end = PyUnicode_AS_UNICODE(in) + PyUnicode_GET_SIZE(in);
+	Py_UNICODE *next_escp;
+	Py_UNICODE *outp;
+	Py_ssize_t delta=0, erepl=0, delta_len=0;
+
+	/* First we need to figure out how long the escaped string will be */
+	while (*(inp) || inp < inp_end) {
+		if (*inp < ESCAPED_CHARS_TABLE_SIZE) {
+			delta += escaped_chars_delta_len[*inp];
+			erepl += !!escaped_chars_delta_len[*inp];
+		}
+		++inp;
+	}
+
+	/* Do we need to escape anything at all? */
+	if (!erepl) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = (PyUnicodeObject*)PyUnicode_FromUnicode(NULL, PyUnicode_GET_SIZE(in) + delta);
+	if (!out)
+		return NULL;
+
+	outp = PyUnicode_AS_UNICODE(out);
+	inp = PyUnicode_AS_UNICODE(in);
+	while (erepl-- > 0) {
+		/* look for the next substitution */
+		next_escp = inp;
+		while (next_escp < inp_end) {
+			if (*next_escp < ESCAPED_CHARS_TABLE_SIZE &&
+			    (delta_len = escaped_chars_delta_len[*next_escp])) {
+				++delta_len;
+				break;
+			}
+			++next_escp;
+		}
+
+		if (next_escp > inp) {
+			/* copy unescaped chars between inp and next_escp */
+			Py_UNICODE_COPY(outp, inp, next_escp-inp);
+			outp += next_escp - inp;
+		}
+
+		/* escape 'next_escp' */
+		Py_UNICODE_COPY(outp, escaped_chars_repl[*next_escp], delta_len);
+		outp += delta_len;
+
+		inp = next_escp + 1;
+	}
+	if (inp < inp_end)
+		Py_UNICODE_COPY(outp, inp, PyUnicode_GET_SIZE(in) - (inp - PyUnicode_AS_UNICODE(in)));
+
+	return (PyObject*)out;
+}
+#else /* PY_MAJOR_VERSION < 3 */
+
+#define GET_DELTA(inp, inp_end, delta) \
+	while (inp < inp_end) {	 \
+		switch (*inp++) {	   \
+		case '"':			   \
+		case '\'':			  \
+		case '&':			   \
+			delta += 4;		 \
+			break;			  \
+		case '<':			   \
+		case '>':			   \
+			delta += 3;		 \
+			break;			  \
+		}					   \
+	}
+
+#define DO_ESCAPE(inp, inp_end, outp) \
+	{  \
+		Py_ssize_t ncopy = 0;  \
+		while (inp < inp_end) {  \
+			switch (*inp) {  \
+			case '"':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '4';  \
+				*outp++ = ';';  \
+				break;  \
+			case '\'':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '9';  \
+				*outp++ = ';';  \
+				break;  \
+			case '&':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'a';  \
+				*outp++ = 'm';  \
+				*outp++ = 'p';  \
+				*outp++ = ';';  \
+				break;  \
+			case '<':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'l';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			case '>':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'g';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			default:  \
+				ncopy++; \
+			}  \
+            inp++; \
+		}  \
+		memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+	}
+
+static PyObject*
+escape_unicode_kind1(PyUnicodeObject *in)
+{
+	Py_UCS1 *inp = PyUnicode_1BYTE_DATA(in);
+	Py_UCS1 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS1 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta,
+						PyUnicode_IS_ASCII(in) ? 127 : 255);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_1BYTE_DATA(in);
+	outp = PyUnicode_1BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode_kind2(PyUnicodeObject *in)
+{
+	Py_UCS2 *inp = PyUnicode_2BYTE_DATA(in);
+	Py_UCS2 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS2 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 65535);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_2BYTE_DATA(in);
+	outp = PyUnicode_2BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+
+static PyObject*
+escape_unicode_kind4(PyUnicodeObject *in)
+{
+	Py_UCS4 *inp = PyUnicode_4BYTE_DATA(in);
+	Py_UCS4 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS4 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 1114111);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_4BYTE_DATA(in);
+	outp = PyUnicode_4BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	if (PyUnicode_READY(in))
+		return NULL;
+
+	switch (PyUnicode_KIND(in)) {
+	case PyUnicode_1BYTE_KIND:
+		return escape_unicode_kind1(in);
+	case PyUnicode_2BYTE_KIND:
+		return escape_unicode_kind2(in);
+	case PyUnicode_4BYTE_KIND:
+		return escape_unicode_kind4(in);
+	}
+	assert(0);  /* shouldn't happen */
+	return NULL;
+}
+#endif /* PY_MAJOR_VERSION < 3 */
+
+static PyObject*
+escape(PyObject *self, PyObject *text)
+{
+	static PyObject *id_html;
+	PyObject *s = NULL, *rv = NULL, *html;
+
+	if (id_html == NULL) {
+#if PY_MAJOR_VERSION < 3
+		id_html = PyString_InternFromString("__html__");
+#else
+		id_html = PyUnicode_InternFromString("__html__");
+#endif
+		if (id_html == NULL) {
+			return NULL;
+		}
+	}
+
+	/* we don't have to escape integers, bools or floats */
+	if (PyLong_CheckExact(text) ||
+#if PY_MAJOR_VERSION < 3
+	    PyInt_CheckExact(text) ||
+#endif
+	    PyFloat_CheckExact(text) || PyBool_Check(text) ||
+	    text == Py_None)
+		return PyObject_CallFunctionObjArgs(markup, text, NULL);
+
+	/* if the object has an __html__ method that performs the escaping */
+	html = PyObject_GetAttr(text ,id_html);
+	if (html) {
+		s = PyObject_CallObject(html, NULL);
+		Py_DECREF(html);
+		if (s == NULL) {
+			return NULL;
+		}
+		/* Convert to Markup object */
+		rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+		Py_DECREF(s);
+		return rv;
+	}
+
+	/* otherwise make the object unicode if it isn't, then escape */
+	PyErr_Clear();
+	if (!PyUnicode_Check(text)) {
+#if PY_MAJOR_VERSION < 3
+		PyObject *unicode = PyObject_Unicode(text);
+#else
+		PyObject *unicode = PyObject_Str(text);
+#endif
+		if (!unicode)
+			return NULL;
+		s = escape_unicode((PyUnicodeObject*)unicode);
+		Py_DECREF(unicode);
+	}
+	else
+		s = escape_unicode((PyUnicodeObject*)text);
+
+	/* convert the unicode string into a markup object. */
+	rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+	Py_DECREF(s);
+	return rv;
+}
+
+
+static PyObject*
+escape_silent(PyObject *self, PyObject *text)
+{
+	if (text != Py_None)
+		return escape(self, text);
+	return PyObject_CallFunctionObjArgs(markup, NULL);
+}
+
+
+static PyObject*
+soft_unicode(PyObject *self, PyObject *s)
+{
+	if (!PyUnicode_Check(s))
+#if PY_MAJOR_VERSION < 3
+		return PyObject_Unicode(s);
+#else
+		return PyObject_Str(s);
+#endif
+	Py_INCREF(s);
+	return s;
+}
+
+
+static PyMethodDef module_methods[] = {
+	{"escape", (PyCFunction)escape, METH_O,
+	 "escape(s) -> markup\n\n"
+	 "Convert the characters &, <, >, ', and \" in string s to HTML-safe\n"
+	 "sequences.  Use this if you need to display text that might contain\n"
+	 "such characters in HTML.  Marks return value as markup string."},
+	{"escape_silent", (PyCFunction)escape_silent, METH_O,
+	 "escape_silent(s) -> markup\n\n"
+	 "Like escape but converts None to an empty string."},
+	{"soft_unicode", (PyCFunction)soft_unicode, METH_O,
+	 "soft_unicode(object) -> string\n\n"
+         "Make a string unicode if it isn't already.  That way a markup\n"
+         "string is not converted back to unicode."},
+	{NULL, NULL, 0, NULL}		/* Sentinel */
+};
+
+
+#if PY_MAJOR_VERSION < 3
+
+#ifndef PyMODINIT_FUNC	/* declarations for DLL import/export */
+#define PyMODINIT_FUNC void
+#endif
+PyMODINIT_FUNC
+init_speedups(void)
+{
+	if (!init_constants())
+		return;
+
+	Py_InitModule3("markupsafe._speedups", module_methods, "");
+}
+
+#else /* Python 3.x module initialization */
+
+static struct PyModuleDef module_definition = {
+        PyModuleDef_HEAD_INIT,
+	"markupsafe._speedups",
+	NULL,
+	-1,
+	module_methods,
+	NULL,
+	NULL,
+	NULL,
+	NULL
+};
+
+PyMODINIT_FUNC
+PyInit__speedups(void)
+{
+	if (!init_constants())
+		return NULL;
+
+	return PyModule_Create(&module_definition);
+}
+
+#endif
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.cpython-37m-x86_64-linux-gnu.so b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.cpython-37m-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..373fd8ffd21414f7e126d2d9d070d0b71edf21b8
Binary files /dev/null and b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/markupsafe/_speedups.cpython-37m-x86_64-linux-gnu.so differ
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/AUTHORS b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/AUTHORS
new file mode 100644
index 0000000000000000000000000000000000000000..442460a17c048ef767fbff5f2b2cb355f513ba53
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/AUTHORS
@@ -0,0 +1,5 @@
+- David P. D. Moss (author, maintainer) drkjam@gmail.com
+- Stefan Nordhausen (maintainer) stefan.nordhausen@immobilienscout24.de
+- Jakub Stasiak (maintainer) jakub@stasiak.at
+
+Released under the BSD License (see :doc:`license` for details).
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/LICENSE b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..995457aa9b7da008daa6964e27aad1490d8107ea
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/LICENSE
@@ -0,0 +1,36 @@
+Here are the licenses applicable to the use of the netaddr library.
+
+-------
+netaddr
+-------
+
+COPYRIGHT AND LICENSE
+
+Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright 
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+* Neither the name of David P. D. Moss nor the names of contributors
+  may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..414f3ce8df9781380e02356c451a67c07e7a2e9a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/METADATA
@@ -0,0 +1,118 @@
+Metadata-Version: 2.1
+Name: netaddr
+Version: 0.8.0
+Summary: A network address manipulation library for Python
+Home-page: https://github.com/drkjam/netaddr/
+Author: David P. D. Moss, Stefan Nordhausen et al
+Author-email: drkjam@gmail.com
+License: BSD License
+Download-URL: https://pypi.org/project/netaddr/
+Keywords: Networking,Systems Administration,IANA,IEEE,CIDR,IP,IPv4,IPv6,CIDR,EUI,MAC,MAC-48,EUI-48,EUI-64
+Platform: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Topic :: Communications
+Classifier: Topic :: Documentation
+Classifier: Topic :: Education
+Classifier: Topic :: Education :: Testing
+Classifier: Topic :: Home Automation
+Classifier: Topic :: Internet
+Classifier: Topic :: Internet :: Log Analysis
+Classifier: Topic :: Internet :: Name Service (DNS)
+Classifier: Topic :: Internet :: Proxy Servers
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Traffic Generation
+Classifier: Topic :: System :: Benchmark
+Classifier: Topic :: System :: Clustering
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Networking :: Firewalls
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Topic :: System :: Networking :: Time Synchronization
+Classifier: Topic :: System :: Recovery Tools
+Classifier: Topic :: System :: Shells
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: System :: System Shells
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Text Processing :: Filters
+Classifier: Topic :: Utilities
+Requires-Dist: importlib-resources ; python_version < "3.7"
+
+netaddr
+=======
+
+A system-independent network address manipulation library for Python 2.7 and 3.5+.
+(Python 2.7 and 3.5 support is deprecated).
+
+.. image:: https://codecov.io/gh/netaddr/netaddr/branch/master/graph/badge.svg
+   :target: https://codecov.io/gh/netaddr/netaddr
+.. image:: https://github.com/netaddr/netaddr/workflows/CI/badge.svg
+   :target: https://github.com/netaddr/netaddr/actions?query=workflow%3ACI+branch%3Amaster
+.. image:: https://img.shields.io/pypi/v/netaddr.svg
+   :target: https://pypi.org/project/netaddr/
+.. image:: https://img.shields.io/pypi/pyversions/netaddr.svg
+   :target: pypi.python.org/pypi/netaddr
+
+Provides support for:
+
+Layer 3 addresses
+
+-  IPv4 and IPv6 addresses, subnets, masks, prefixes
+-  iterating, slicing, sorting, summarizing and classifying IP networks
+-  dealing with various ranges formats (CIDR, arbitrary ranges and
+   globs, nmap)
+-  set based operations (unions, intersections etc) over IP addresses
+   and subnets
+-  parsing a large variety of different formats and notations
+-  looking up IANA IP block information
+-  generating DNS reverse lookups
+-  supernetting and subnetting
+
+Layer 2 addresses
+
+-  representation and manipulation MAC addresses and EUI-64 identifiers
+-  looking up IEEE organisational information (OUI, IAB)
+-  generating derived IPv6 addresses
+
+Starting with Python 3.3 there's an `ipaddress <https://docs.python.org/3/library/ipaddress.html>`_
+module in the Python standard library which provides layer 3 address manipulation
+capabilities overlapping ``netaddr``.
+
+Documentation
+-------------
+
+Latest documentation https://netaddr.readthedocs.io/en/latest/
+
+Share and enjoy!
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..5e268b93401beec22772f8cf356d4dbfba905fb0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/RECORD
@@ -0,0 +1,58 @@
+../../bin/netaddr,sha256=umd9JwvHAtvgYly8YkfMtNPuy2R7jt-2O61dpcix270,255
+netaddr-0.8.0.dist-info/AUTHORS,sha256=ukJIe5KKm4I3UsXdPRTflQj-wISd8--amGiTe8PAVco,241
+netaddr-0.8.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+netaddr-0.8.0.dist-info/LICENSE,sha256=DlPeYlR3h0YvQe77XO4xoU9-p2e6A2LG-TBPF0JIbUc,1606
+netaddr-0.8.0.dist-info/METADATA,sha256=0kO1sE_BkLIoTmbDur34u3t45VoiqdBIG9LqX7fV168,4884
+netaddr-0.8.0.dist-info/RECORD,,
+netaddr-0.8.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+netaddr-0.8.0.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+netaddr-0.8.0.dist-info/entry_points.txt,sha256=TGfqa95bQEnE9BUe3rrr0Hq1Y1rw49ZVkVDjKg7nE90,46
+netaddr-0.8.0.dist-info/top_level.txt,sha256=GlouRmUZSQCg0kloRWKY6qxTHAsQo_rE8QvlxYBHwOE,8
+netaddr/__init__.py,sha256=de86OhloTul8BJpkkwh1yn4iK-tEVRRGm_kXIfNXcE8,1849
+netaddr/__pycache__/__init__.cpython-37.pyc,,
+netaddr/__pycache__/cli.cpython-37.pyc,,
+netaddr/__pycache__/compat.cpython-37.pyc,,
+netaddr/__pycache__/core.cpython-37.pyc,,
+netaddr/__pycache__/fbsocket.cpython-37.pyc,,
+netaddr/cli.py,sha256=_r5UPGR2hAZhyD4d_KbmHQDBz_eRoWFlqFJ3xtcLxAc,1278
+netaddr/compat.py,sha256=o4F9ROM_oAz4tIj8qeGB6viWBaXVxyOEtTPy6J4svA0,2209
+netaddr/contrib/__init__.py,sha256=tHDAWK5T0l3IxMjlnlXRZmBVEWe_JnYu6GmdSeP8slQ,567
+netaddr/contrib/__pycache__/__init__.cpython-37.pyc,,
+netaddr/contrib/__pycache__/subnet_splitter.cpython-37.pyc,,
+netaddr/contrib/subnet_splitter.py,sha256=FloAxzvcMMXXHaesGJiyJWug1R8Wrxh-00Cvv6UfDAY,1769
+netaddr/core.py,sha256=AhQhwutql11wSUWN5_ip6cM9gHjP_zr3c7I3BIrCwIw,5898
+netaddr/eui/__init__.py,sha256=tET2m6vht-x8WUStqv7wOfVEPtPfYPZBppcAm8-5np8,25688
+netaddr/eui/__pycache__/__init__.cpython-37.pyc,,
+netaddr/eui/__pycache__/ieee.cpython-37.pyc,,
+netaddr/eui/iab.idx,sha256=sQ-fBZjeCGVbYT4jYwPMzMsktJ70b8kQJhr58NVpK1g,95464
+netaddr/eui/iab.txt,sha256=gXX96cz8zxlCvWd7SNwRiwmf6OLsbnvOVcDoNGNUMLQ,2453223
+netaddr/eui/ieee.py,sha256=f0SxL3s6jxXysovoCw948vFzW_qDY8Q8M7p0v1FXZ6U,9303
+netaddr/eui/oui.idx,sha256=hE0dZwt-G72WK569n7AphTpwyUNlsPdsRJ90r8SUPNI,523486
+netaddr/eui/oui.txt,sha256=w6qHufJSUn1ZQEx2TcqW11gP39McK5c6NTumiFIYK0E,4458411
+netaddr/fbsocket.py,sha256=L2yZtJVBhAR-Hxfx5pROfJiE2V9XkjLtYf6ONElUJnE,8247
+netaddr/ip/__init__.py,sha256=rzSNhw4H_ElQSD8-Gmm3bqbMqxGB4NdV2WijqksEs1Y,68492
+netaddr/ip/__pycache__/__init__.cpython-37.pyc,,
+netaddr/ip/__pycache__/glob.cpython-37.pyc,,
+netaddr/ip/__pycache__/iana.cpython-37.pyc,,
+netaddr/ip/__pycache__/nmap.cpython-37.pyc,,
+netaddr/ip/__pycache__/rfc1924.cpython-37.pyc,,
+netaddr/ip/__pycache__/sets.cpython-37.pyc,,
+netaddr/ip/glob.py,sha256=tlxePyqAA_JrNGj2A8_9vRgzbMIxJXScs7A0Sx1xNhI,10474
+netaddr/ip/iana.py,sha256=Cdzo4XuKq6cKJB6JxrM9SevKz9afMHrLOseEkdFQghw,14052
+netaddr/ip/ipv4-address-space.xml,sha256=QkOuS1T5_UYzzCehV-c715ukZkipxSersFJnAZXwd0E,75998
+netaddr/ip/ipv6-address-space.xml,sha256=U14bpxkCfEc5JCOogbw33uLCVbzZd49WmgXxD89Atxk,9581
+netaddr/ip/ipv6-unicast-address-assignments.xml,sha256=NTc9d0XDdSIxzmeoB37mfNY46r2Mig6aOCJh0k8Ydiw,14852
+netaddr/ip/multicast-addresses.xml,sha256=uV2J89XT2rfvb9WopNUkETY5MlsB5a8Ct9mZOKCY1qI,153025
+netaddr/ip/nmap.py,sha256=6OEyTSrxUUNvEZdhX0I27c9aV7GPKf1oJMT50toS_ro,4078
+netaddr/ip/rfc1924.py,sha256=GCLZKg6VUhBuqZlN6JHPP-M0VaaEVysoyhx4AeZTNUM,1750
+netaddr/ip/sets.py,sha256=SG_aO9KJ13Td3YPqsFvlmRDceMwblDWcSTER_wly54Q,26586
+netaddr/strategy/__init__.py,sha256=QI-vJBK4wCJGp-c6iQSkbRDE4wqy1YW44ioFa2pCJ3U,7479
+netaddr/strategy/__pycache__/__init__.cpython-37.pyc,,
+netaddr/strategy/__pycache__/eui48.cpython-37.pyc,,
+netaddr/strategy/__pycache__/eui64.cpython-37.pyc,,
+netaddr/strategy/__pycache__/ipv4.cpython-37.pyc,,
+netaddr/strategy/__pycache__/ipv6.cpython-37.pyc,,
+netaddr/strategy/eui48.py,sha256=w-ClUG8ie34GsVfNY8vHVXiTWU303v_RPjP76s_HynE,8640
+netaddr/strategy/eui64.py,sha256=nipcYqN5XYWu7L8gEkbeVdfqBU5CJ592uz3yFSIlD_k,7711
+netaddr/strategy/ipv4.py,sha256=T-dK0926vh-FWso2M7GLNTliKSteLzbZfEH37tjupHc,8095
+netaddr/strategy/ipv6.py,sha256=OuwhcXbtReuI6KYtO6Nsc9kdEjThVqmY4XmvnTKBunU,7632
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/REQUESTED b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/entry_points.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b0b5509a1a83eb540e25236761ac3543453df606
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[console_scripts]
+netaddr = netaddr.cli:main
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4f6a277e37b18d366a70a03cb0079a94e5836ac1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr-0.8.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+netaddr
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..54a656671972e35d3cc8dfd1879ecdeeded382b2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/__init__.py
@@ -0,0 +1,48 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""A Python library for manipulating IP and EUI network addresses."""
+
+#: Version info (major, minor, maintenance, status)
+__version__ = '0.8.0'
+VERSION = tuple(int(part) for part in __version__.split('.'))
+STATUS = ''
+
+import sys as _sys
+
+if _sys.version_info[0:2] < (2, 4):
+    raise RuntimeError('Python 2.4.x or higher is required!')
+
+from netaddr.core import (AddrConversionError, AddrFormatError,
+    NotRegisteredError, ZEROFILL, Z, INET_PTON, P, NOHOST, N)
+
+from netaddr.ip import (IPAddress, IPNetwork, IPRange, all_matching_cidrs,
+    cidr_abbrev_to_verbose, cidr_exclude, cidr_merge, iprange_to_cidrs,
+    iter_iprange, iter_unique_ips, largest_matching_cidr,
+    smallest_matching_cidr, spanning_cidr)
+
+from netaddr.ip.sets import IPSet
+
+from netaddr.ip.glob import (IPGlob, cidr_to_glob, glob_to_cidrs,
+    glob_to_iprange, glob_to_iptuple, iprange_to_globs, valid_glob)
+
+from netaddr.ip.nmap import valid_nmap_range, iter_nmap_range
+
+from netaddr.ip.rfc1924 import base85_to_ipv6, ipv6_to_base85
+
+from netaddr.eui import EUI, IAB, OUI
+
+from netaddr.strategy.ipv4 import valid_str as valid_ipv4
+
+from netaddr.strategy.ipv6 import (valid_str as valid_ipv6, ipv6_compact,
+    ipv6_full, ipv6_verbose)
+
+from netaddr.strategy.eui48 import (mac_eui48, mac_unix, mac_unix_expanded,
+        mac_cisco, mac_bare, mac_pgsql, valid_str as valid_mac)
+
+from netaddr.strategy.eui64 import (eui64_base, eui64_unix, eui64_unix_expanded,
+        eui64_cisco, eui64_bare, valid_str as valid_eui64)
+
+from netaddr.contrib.subnet_splitter import SubnetSplitter
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/cli.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/cli.py
new file mode 100644
index 0000000000000000000000000000000000000000..c97eab994bb85544fbc8867b71c4c7d1e2d059ce
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/cli.py
@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""an interactive shell for the netaddr library"""
+
+import os
+import sys
+import netaddr
+from netaddr import *
+
+#   aliases to save some typing ...
+from netaddr import IPAddress as IP, IPNetwork as CIDR
+from netaddr import EUI as MAC
+
+def main():
+    argv = sys.argv[1:]
+
+    banner = "\nnetaddr shell %s - %s\n" % (netaddr.__version__, __doc__)
+    exit_msg = "\nShare and enjoy!"
+    rc_override = None
+
+    try:
+        try:
+            # ipython >= 0.11
+            from IPython.terminal.embed import InteractiveShellEmbed
+            ipshell = InteractiveShellEmbed(banner1=banner, exit_msg=exit_msg)
+        except ImportError:
+            # ipython < 0.11
+            from IPython.Shell import IPShellEmbed
+            ipshell = IPShellEmbed(argv, banner, exit_msg, rc_override)
+    except ImportError:
+        sys.stderr.write('IPython (http://ipython.scipy.org/) not found!\n')
+        sys.exit(1)
+
+    ipshell()
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/compat.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..201dca6388bd075b9e1ffc28eb79f47ceb8ad897
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/compat.py
@@ -0,0 +1,93 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+Compatibility wrappers providing uniform behaviour for Python code required to
+run under both Python 2.x and 3.x.
+
+All operations emulate 2.x behaviour where applicable.
+"""
+import sys as _sys
+
+if _sys.version_info[0] == 3:
+    # Python 3.x specific logic.
+    _sys_maxint = _sys.maxsize
+
+    _int_type = int
+
+    _str_type = str
+
+    _bytes_type = lambda x: bytes(x, 'UTF-8')
+
+    _is_str = lambda x: isinstance(x, (str, type(''.encode())))
+
+    _is_int = lambda x: isinstance(x, int)
+
+    _callable = lambda x: hasattr(x, '__call__')
+
+    _dict_keys = lambda x: list(x.keys())
+
+    _dict_items = lambda x: list(x.items())
+
+    _iter_dict_keys = lambda x: x.keys()
+
+    def _bytes_join(*args):
+        return ''.encode().join(*args)
+
+    def _zip(*args):
+        return list(zip(*args))
+
+    def _range(*args, **kwargs):
+        return list(range(*args, **kwargs))
+
+    _iter_range = range
+
+    def _iter_next(x):
+        return next(x)
+
+elif _sys.version_info[0:2] > [2, 3]:
+    # Python 2.4 or higher.
+    _sys_maxint = _sys.maxint
+
+    _int_type = (int, long)
+
+    _str_type = basestring
+
+    _bytes_type = str
+
+    _is_str = lambda x: isinstance(x, basestring)
+
+    _is_int = lambda x: isinstance(x, (int, long))
+
+    _callable = lambda x: callable(x)
+
+    _dict_keys = lambda x: x.keys()
+
+    _dict_items = lambda x: x.items()
+
+    _iter_dict_keys = lambda x: iter(x.keys())
+
+    def _bytes_join(*args):
+        return ''.join(*args)
+
+    def _zip(*args):
+        return zip(*args)
+
+    def _range(*args, **kwargs):
+        return range(*args, **kwargs)
+
+    _iter_range = xrange
+
+    def _iter_next(x):
+        return x.next()
+else:
+    # Unsupported versions.
+    raise RuntimeError(
+        'this module only supports Python 2.4.x or higher (including 3.x)!')
+
+try:
+    from importlib import resources as _importlib_resources
+except ImportError:
+    import importlib_resources as _importlib_resources
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7449cd67cf4e0c07ba71bc7ea8db07f5d2096974
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/__init__.py
@@ -0,0 +1,12 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+The netaddr.contrib namespace for non-core code contributed by users.
+
+It is a testing ground for new ideas. Depending on the interest in
+functionality found here, code may find its way into the core in various
+ways, either as is or as additions to existing APIs.
+"""
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/subnet_splitter.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/subnet_splitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..875b1131ede3447f3a451ee1ade7621582bc559b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/contrib/subnet_splitter.py
@@ -0,0 +1,46 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+from netaddr.ip import IPNetwork, cidr_exclude, cidr_merge
+
+
+class SubnetSplitter(object):
+    """
+    A handy utility class that takes a single (large) subnet and allows
+    smaller subnet within its range to be extracted by CIDR prefix. Any
+    leaving address space is available for subsequent extractions until
+    all space is exhausted.
+    """
+    def __init__(self, base_cidr):
+        """
+        Constructor.
+
+        :param base_cidr: an IPv4 or IPv6 address with a CIDR prefix.
+            (see IPNetwork.__init__ for full details).
+        """
+        self._subnets = set([IPNetwork(base_cidr)])
+
+    def extract_subnet(self, prefix, count=None):
+        """Extract 1 or more subnets of size specified by CIDR prefix."""
+        for cidr in self.available_subnets():
+            subnets = list(cidr.subnet(prefix, count=count))
+            if not subnets:
+                continue
+            self.remove_subnet(cidr)
+            self._subnets = self._subnets.union(
+                set(
+                    cidr_exclude(cidr, cidr_merge(subnets)[0])
+                )
+            )
+            return subnets
+        return []
+
+    def available_subnets(self):
+        """Returns a list of the currently available subnets."""
+        return sorted(self._subnets, key=lambda x: x.prefixlen, reverse=True)
+
+    def remove_subnet(self, ip_network):
+        """Remove a specified IPNetwork from available address space."""
+        self._subnets.remove(ip_network)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/core.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/core.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17eaba0f660c7bda6ff45c5c1709ce9720f3a59
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/core.py
@@ -0,0 +1,206 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""Common code shared between various netaddr sub modules"""
+
+import sys as _sys
+import pprint as _pprint
+
+from netaddr.compat import _callable, _iter_dict_keys
+
+#: True if platform is natively big endian, False otherwise.
+BIG_ENDIAN_PLATFORM = _sys.byteorder == 'big'
+
+#:  Use inet_pton() semantics instead of inet_aton() when parsing IPv4.
+P = INET_PTON = 1
+
+#:  Remove any preceding zeros from IPv4 address octets before parsing.
+Z = ZEROFILL = 2
+
+#:  Remove any host bits found to the right of an applied CIDR prefix.
+N = NOHOST = 4
+
+#-----------------------------------------------------------------------------
+#   Custom exceptions.
+#-----------------------------------------------------------------------------
+class AddrFormatError(Exception):
+    """
+    An Exception indicating a network address is not correctly formatted.
+    """
+    pass
+
+
+class AddrConversionError(Exception):
+    """
+    An Exception indicating a failure to convert between address types or
+    notations.
+    """
+    pass
+
+
+class NotRegisteredError(Exception):
+    """
+    An Exception indicating that an OUI or IAB was not found in the IEEE
+    Registry.
+    """
+    pass
+
+
+try:
+    a = 42
+    a.bit_length()
+    # No exception, must be Python 2.7 or 3.1+ -> can use bit_length()
+    def num_bits(int_val):
+        """
+        :param int_val: an unsigned integer.
+
+        :return: the minimum number of bits needed to represent value provided.
+        """
+        return int_val.bit_length()
+except AttributeError:
+    # a.bit_length() excepted, must be an older Python version.
+    def num_bits(int_val):
+        """
+        :param int_val: an unsigned integer.
+
+        :return: the minimum number of bits needed to represent value provided.
+        """
+        numbits = 0
+        while int_val:
+            numbits += 1
+            int_val >>= 1
+        return numbits
+
+
+class Subscriber(object):
+    """
+    An abstract class defining the interface expected by a Publisher.
+    """
+
+    def update(self, data):
+        """
+        A callback method used by a Publisher to notify this Subscriber about
+        updates.
+
+        :param data: a Python object containing data provided by Publisher.
+        """
+        raise NotImplementedError('cannot invoke virtual method!')
+
+
+class PrettyPrinter(Subscriber):
+    """
+    A concrete Subscriber that employs the pprint in the standard library to
+    format all data from updates received, writing them to a file-like
+    object.
+
+    Useful as a debugging aid.
+    """
+
+    def __init__(self, fh=_sys.stdout, write_eol=True):
+        """
+        Constructor.
+
+        :param fh: a file-like object to write updates to.
+            Default: sys.stdout.
+
+
+        :param write_eol: if ``True`` this object will write newlines to
+            output, if ``False`` it will not.
+        """
+        self.fh = fh
+        self.write_eol = write_eol
+
+    def update(self, data):
+        """
+        A callback method used by a Publisher to notify this Subscriber about
+        updates.
+
+        :param data: a Python object containing data provided by Publisher.
+        """
+        self.fh.write(_pprint.pformat(data))
+        if self.write_eol:
+            self.fh.write("\n")
+
+
+class Publisher(object):
+    """
+    A 'push' Publisher that maintains a list of Subscriber objects notifying
+    them of state changes by passing them update data when it encounter events
+    of interest.
+    """
+
+    def __init__(self):
+        """Constructor"""
+        self.subscribers = []
+
+    def attach(self, subscriber):
+        """
+        Add a new subscriber.
+
+        :param subscriber: a new object that implements the Subscriber object
+            interface.
+        """
+        if hasattr(subscriber, 'update') and _callable(eval('subscriber.update')):
+            if subscriber not in self.subscribers:
+                self.subscribers.append(subscriber)
+        else:
+            raise TypeError('%r does not support required interface!' % subscriber)
+
+    def detach(self, subscriber):
+        """
+        Remove an existing subscriber.
+
+        :param subscriber: a new object that implements the Subscriber object
+            interface.
+        """
+        try:
+            self.subscribers.remove(subscriber)
+        except ValueError:
+            pass
+
+    def notify(self, data):
+        """
+        Send update data to to all registered Subscribers.
+
+        :param data: the data to be passed to each registered Subscriber.
+        """
+        for subscriber in self.subscribers:
+            subscriber.update(data)
+
+
+class DictDotLookup(object):
+    """
+    Creates objects that behave much like a dictionaries, but allow nested
+    key access using object '.' (dot) lookups.
+
+    Recipe 576586: Dot-style nested lookups over dictionary based data
+    structures - http://code.activestate.com/recipes/576586/
+
+    """
+
+    def __init__(self, d):
+        for k in d:
+            if isinstance(d[k], dict):
+                self.__dict__[k] = DictDotLookup(d[k])
+            elif isinstance(d[k], (list, tuple)):
+                l = []
+                for v in d[k]:
+                    if isinstance(v, dict):
+                        l.append(DictDotLookup(v))
+                    else:
+                        l.append(v)
+                self.__dict__[k] = l
+            else:
+                self.__dict__[k] = d[k]
+
+    def __getitem__(self, name):
+        if name in self.__dict__:
+            return self.__dict__[name]
+
+    def __iter__(self):
+        return _iter_dict_keys(self.__dict__)
+
+    def __repr__(self):
+        return _pprint.pformat(self.__dict__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..56396769179d15e0722611e5f69b9716acd07286
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/__init__.py
@@ -0,0 +1,749 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+Classes and functions for dealing with MAC addresses, EUI-48, EUI-64, OUI, IAB
+identifiers.
+"""
+
+from netaddr.core import NotRegisteredError, AddrFormatError, DictDotLookup
+from netaddr.strategy import eui48 as _eui48, eui64 as _eui64
+from netaddr.strategy.eui48 import mac_eui48
+from netaddr.strategy.eui64 import eui64_base
+from netaddr.ip import IPAddress
+from netaddr.compat import _importlib_resources, _is_int, _is_str
+
+
+class BaseIdentifier(object):
+    """Base class for all IEEE identifiers."""
+    __slots__ = ('_value', '__weakref__')
+
+    def __init__(self):
+        self._value = None
+
+    def __int__(self):
+        """:return: integer value of this identifier"""
+        return self._value
+
+    def __long__(self):
+        """:return: integer value of this identifier"""
+        return self._value
+
+    def __oct__(self):
+        """:return: octal string representation of this identifier."""
+        #   Python 2.x only.
+        if self._value == 0:
+            return '0'
+        return '0%o' % self._value
+
+    def __hex__(self):
+        """:return: hexadecimal string representation of this identifier."""
+        #   Python 2.x only.
+        return '0x%x' % self._value
+
+    def __index__(self):
+        """
+        :return: return the integer value of this identifier when passed to
+            hex(), oct() or bin().
+        """
+        #   Python 3.x only.
+        return self._value
+
+
+class OUI(BaseIdentifier):
+    """
+    An individual IEEE OUI (Organisationally Unique Identifier).
+
+    For online details see - http://standards.ieee.org/regauth/oui/
+
+    """
+    __slots__ = ('records',)
+
+    def __init__(self, oui):
+        """
+        Constructor
+
+        :param oui: an OUI string ``XX-XX-XX`` or an unsigned integer. \
+            Also accepts and parses full MAC/EUI-48 address strings (but not \
+            MAC/EUI-48 integers)!
+        """
+        super(OUI, self).__init__()
+
+        #   Lazy loading of IEEE data structures.
+        from netaddr.eui import ieee
+
+        self.records = []
+
+        if isinstance(oui, str):
+            #TODO: Improve string parsing here.
+            #TODO: Accept full MAC/EUI-48 addressses as well as XX-XX-XX
+            #TODO: and just take /16 (see IAB for details)
+            self._value = int(oui.replace('-', ''), 16)
+        elif _is_int(oui):
+            if 0 <= oui <= 0xffffff:
+                self._value = oui
+            else:
+                raise ValueError('OUI int outside expected range: %r' % (oui,))
+        else:
+            raise TypeError('unexpected OUI format: %r' % (oui,))
+
+        #   Discover offsets.
+        if self._value in ieee.OUI_INDEX:
+            fh = _importlib_resources.open_binary(__package__, 'oui.txt')
+            for (offset, size) in ieee.OUI_INDEX[self._value]:
+                fh.seek(offset)
+                data = fh.read(size).decode('UTF-8')
+                self._parse_data(data, offset, size)
+            fh.close()
+        else:
+            raise NotRegisteredError('OUI %r not registered!' % (oui,))
+
+    def __eq__(self, other):
+        if not isinstance(other, OUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return self._value == other._value
+
+    def __ne__(self, other):
+        if not isinstance(other, OUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return self._value != other._value
+
+    def __getstate__(self):
+        """:returns: Pickled state of an `OUI` object."""
+        return self._value, self.records
+
+    def __setstate__(self, state):
+        """:param state: data used to unpickle a pickled `OUI` object."""
+        self._value, self.records = state
+
+    def _parse_data(self, data, offset, size):
+        """Returns a dict record from raw OUI record data"""
+        record = {
+            'idx': 0,
+            'oui': '',
+            'org': '',
+            'address': [],
+            'offset': offset,
+            'size': size,
+        }
+
+        for line in data.split("\n"):
+            line = line.strip()
+            if not line:
+                continue
+
+            if '(hex)' in line:
+                record['idx'] = self._value
+                record['org'] = line.split(None, 2)[2]
+                record['oui'] = str(self)
+            elif '(base 16)' in line:
+                continue
+            else:
+                record['address'].append(line)
+
+        self.records.append(record)
+
+    @property
+    def reg_count(self):
+        """Number of registered organisations with this OUI"""
+        return len(self.records)
+
+    def registration(self, index=0):
+        """
+        The IEEE registration details for this OUI.
+
+        :param index: the index of record (may contain multiple registrations)
+            (Default: 0 - first registration)
+
+        :return: Objectified Python data structure containing registration
+            details.
+        """
+        return DictDotLookup(self.records[index])
+
+    def __str__(self):
+        """:return: string representation of this OUI"""
+        int_val = self._value
+        return "%02X-%02X-%02X" % (
+                (int_val >> 16) & 0xff,
+                (int_val >> 8) & 0xff,
+                int_val & 0xff)
+
+    def __repr__(self):
+        """:return: executable Python string to recreate equivalent object."""
+        return "OUI('%s')" % self
+
+
+class IAB(BaseIdentifier):
+    IAB_EUI_VALUES = (0x0050c2, 0x40d855)
+
+    """
+    An individual IEEE IAB (Individual Address Block) identifier.
+
+    For online details see - http://standards.ieee.org/regauth/oui/
+
+    """
+    __slots__ = ('record',)
+
+    @classmethod
+    def split_iab_mac(cls, eui_int, strict=False):
+        """
+        :param eui_int: a MAC IAB as an unsigned integer.
+
+        :param strict: If True, raises a ValueError if the last 12 bits of
+            IAB MAC/EUI-48 address are non-zero, ignores them otherwise.
+            (Default: False)
+        """
+        if (eui_int >> 12) in cls.IAB_EUI_VALUES:
+            return eui_int, 0
+
+        user_mask = 2 ** 12 - 1
+        iab_mask = (2 ** 48 - 1) ^ user_mask
+        iab_bits = eui_int >> 12
+        user_bits = (eui_int | iab_mask) - iab_mask
+
+        if (iab_bits >> 12) in cls.IAB_EUI_VALUES:
+            if strict and user_bits != 0:
+                raise ValueError('%r is not a strict IAB!' % hex(user_bits))
+        else:
+            raise ValueError('%r is not an IAB address!' % hex(eui_int))
+
+        return iab_bits, user_bits
+
+    def __init__(self, iab, strict=False):
+        """
+        Constructor
+
+        :param iab: an IAB string ``00-50-C2-XX-X0-00`` or an unsigned \
+            integer. This address looks like an EUI-48 but it should not \
+            have any non-zero bits in the last 3 bytes.
+
+        :param strict: If True, raises a ValueError if the last 12 bits \
+            of IAB MAC/EUI-48 address are non-zero, ignores them otherwise. \
+            (Default: False)
+        """
+        super(IAB, self).__init__()
+
+        #   Lazy loading of IEEE data structures.
+        from netaddr.eui import ieee
+
+        self.record = {
+            'idx': 0,
+            'iab': '',
+            'org': '',
+            'address': [],
+            'offset': 0,
+            'size': 0,
+        }
+
+        if isinstance(iab, str):
+            #TODO: Improve string parsing here.
+            #TODO: '00-50-C2' is actually invalid.
+            #TODO: Should be '00-50-C2-00-00-00' (i.e. a full MAC/EUI-48)
+            int_val = int(iab.replace('-', ''), 16)
+            iab_int, user_int = self.split_iab_mac(int_val, strict=strict)
+            self._value = iab_int
+        elif _is_int(iab):
+            iab_int, user_int = self.split_iab_mac(iab, strict=strict)
+            self._value = iab_int
+        else:
+            raise TypeError('unexpected IAB format: %r!' % (iab,))
+
+        #   Discover offsets.
+        if self._value in ieee.IAB_INDEX:
+            fh = _importlib_resources.open_binary(__package__, 'iab.txt')
+            (offset, size) = ieee.IAB_INDEX[self._value][0]
+            self.record['offset'] = offset
+            self.record['size'] = size
+            fh.seek(offset)
+            data = fh.read(size).decode('UTF-8')
+            self._parse_data(data, offset, size)
+            fh.close()
+        else:
+            raise NotRegisteredError('IAB %r not unregistered!' % (iab,))
+
+    def __eq__(self, other):
+        if not isinstance(other, IAB):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return self._value == other._value
+
+    def __ne__(self, other):
+        if not isinstance(other, IAB):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return self._value != other._value
+
+    def __getstate__(self):
+        """:returns: Pickled state of an `IAB` object."""
+        return self._value, self.record
+
+    def __setstate__(self, state):
+        """:param state: data used to unpickle a pickled `IAB` object."""
+        self._value, self.record = state
+
+    def _parse_data(self, data, offset, size):
+        """Returns a dict record from raw IAB record data"""
+        for line in data.split("\n"):
+            line = line.strip()
+            if not line:
+                continue
+
+            if '(hex)' in line:
+                self.record['idx'] = self._value
+                self.record['org'] = line.split(None, 2)[2]
+                self.record['iab'] = str(self)
+            elif '(base 16)' in line:
+                continue
+            else:
+                self.record['address'].append(line)
+
+    def registration(self):
+        """The IEEE registration details for this IAB"""
+        return DictDotLookup(self.record)
+
+    def __str__(self):
+        """:return: string representation of this IAB"""
+        int_val = self._value << 4
+
+        return "%02X-%02X-%02X-%02X-%02X-00" % (
+                (int_val >> 32) & 0xff,
+                (int_val >> 24) & 0xff,
+                (int_val >> 16) & 0xff,
+                (int_val >> 8) & 0xff,
+                int_val & 0xff)
+
+    def __repr__(self):
+        """:return: executable Python string to recreate equivalent object."""
+        return "IAB('%s')" % self
+
+
+class EUI(BaseIdentifier):
+    """
+    An IEEE EUI (Extended Unique Identifier).
+
+    Both EUI-48 (used for layer 2 MAC addresses) and EUI-64 are supported.
+
+    Input parsing for EUI-48 addresses is flexible, supporting many MAC
+    variants.
+
+    """
+    __slots__ = ('_module', '_dialect')
+
+    def __init__(self, addr, version=None, dialect=None):
+        """
+        Constructor.
+
+        :param addr: an EUI-48 (MAC) or EUI-64 address in string format or \
+            an unsigned integer. May also be another EUI object (copy \
+            construction).
+
+        :param version: (optional) the explicit EUI address version, either \
+            48 or 64. Mainly used to distinguish EUI-48 and EUI-64 identifiers \
+            specified as integers which may be numerically equivalent.
+
+        :param dialect: (optional) the mac_* dialect to be used to configure \
+            the formatting of EUI-48 (MAC) addresses.
+        """
+        super(EUI, self).__init__()
+
+        self._module = None
+
+        if isinstance(addr, EUI):
+            #   Copy constructor.
+            if version is not None and version != addr._module.version:
+                raise ValueError('cannot switch EUI versions using '
+                    'copy constructor!')
+            self._module = addr._module
+            self._value = addr._value
+            self.dialect = addr.dialect
+            return
+
+        if version is not None:
+            if version == 48:
+                self._module = _eui48
+            elif version == 64:
+                self._module = _eui64
+            else:
+                raise ValueError('unsupported EUI version %r' % version)
+        else:
+        #   Choose a default version when addr is an integer and version is
+        #   not specified.
+            if _is_int(addr):
+                if 0 <= addr <= 0xffffffffffff:
+                    self._module = _eui48
+                elif 0xffffffffffff < addr <= 0xffffffffffffffff:
+                    self._module = _eui64
+
+        self.value = addr
+
+        #   Choose a dialect for MAC formatting.
+        self.dialect = dialect
+
+    def __getstate__(self):
+        """:returns: Pickled state of an `EUI` object."""
+        return self._value, self._module.version, self.dialect
+
+    def __setstate__(self, state):
+        """
+        :param state: data used to unpickle a pickled `EUI` object.
+
+        """
+        value, version, dialect = state
+
+        self._value = value
+
+        if version == 48:
+            self._module = _eui48
+        elif version == 64:
+            self._module = _eui64
+        else:
+            raise ValueError('unpickling failed for object state: %s' \
+                % (state,))
+
+        self.dialect = dialect
+
+    def _get_value(self):
+        return self._value
+
+    def _set_value(self, value):
+        if self._module is None:
+            #   EUI version is implicit, detect it from value.
+            for module in (_eui48, _eui64):
+                try:
+                    self._value = module.str_to_int(value)
+                    self._module = module
+                    break
+                except AddrFormatError:
+                    try:
+                        if 0 <= int(value) <= module.max_int:
+                            self._value = int(value)
+                            self._module = module
+                            break
+                    except ValueError:
+                        pass
+
+            if self._module is None:
+                raise AddrFormatError('failed to detect EUI version: %r'
+                    % (value,))
+        else:
+            #   EUI version is explicit.
+            if _is_str(value):
+                try:
+                    self._value = self._module.str_to_int(value)
+                except AddrFormatError:
+                    raise AddrFormatError('address %r is not an EUIv%d'
+                        % (value, self._module.version))
+            else:
+                if 0 <= int(value) <= self._module.max_int:
+                    self._value = int(value)
+                else:
+                    raise AddrFormatError('bad address format: %r' % (value,))
+
+    value = property(_get_value, _set_value, None,
+        'a positive integer representing the value of this EUI indentifier.')
+
+    def _get_dialect(self):
+        return self._dialect
+
+    def _validate_dialect(self, value):
+        if value is None:
+            if self._module is _eui64:
+               return eui64_base
+            else:
+                return mac_eui48
+        else:
+            if hasattr(value, 'word_size') and hasattr(value, 'word_fmt'):
+                return value
+            else:
+                raise TypeError('custom dialects should subclass mac_eui48!')
+
+    def _set_dialect(self, value):
+        self._dialect = self._validate_dialect(value)
+
+    dialect = property(_get_dialect, _set_dialect, None,
+        "a Python class providing support for the interpretation of "
+        "various MAC\n address formats.")
+
+    @property
+    def oui(self):
+        """The OUI (Organisationally Unique Identifier) for this EUI."""
+        if self._module == _eui48:
+            return OUI(self.value >> 24)
+        elif self._module == _eui64:
+            return OUI(self.value >> 40)
+
+    @property
+    def ei(self):
+        """The EI (Extension Identifier) for this EUI"""
+        if self._module == _eui48:
+            return '%02X-%02X-%02X' % tuple(self[3:6])
+        elif self._module == _eui64:
+            return '%02X-%02X-%02X-%02X-%02X' % tuple(self[3:8])
+
+    def is_iab(self):
+        """:return: True if this EUI is an IAB address, False otherwise"""
+        return (self._value >> 24) in IAB.IAB_EUI_VALUES
+
+    @property
+    def iab(self):
+        """
+        If is_iab() is True, the IAB (Individual Address Block) is returned,
+        ``None`` otherwise.
+        """
+        if self.is_iab():
+            return IAB(self._value >> 12)
+
+    @property
+    def version(self):
+        """The EUI version represented by this EUI object."""
+        return self._module.version
+
+    def __getitem__(self, idx):
+        """
+        :return: The integer value of the word referenced by index (both \
+            positive and negative). Raises ``IndexError`` if index is out \
+            of bounds. Also supports Python list slices for accessing \
+            word groups.
+        """
+        if _is_int(idx):
+            #   Indexing, including negative indexing goodness.
+            num_words = self._dialect.num_words
+            if not (-num_words) <= idx <= (num_words - 1):
+                raise IndexError('index out range for address type!')
+            return self._module.int_to_words(self._value, self._dialect)[idx]
+        elif isinstance(idx, slice):
+            words = self._module.int_to_words(self._value, self._dialect)
+            return [words[i] for i in range(*idx.indices(len(words)))]
+        else:
+            raise TypeError('unsupported type %r!' % (idx,))
+
+    def __setitem__(self, idx, value):
+        """Set the value of the word referenced by index in this address"""
+        if isinstance(idx, slice):
+            #   TODO - settable slices.
+            raise NotImplementedError('settable slices are not supported!')
+
+        if not _is_int(idx):
+            raise TypeError('index not an integer!')
+
+        if not 0 <= idx <= (self._dialect.num_words - 1):
+            raise IndexError('index %d outside address type boundary!' % (idx,))
+
+        if not _is_int(value):
+            raise TypeError('value not an integer!')
+
+        if not 0 <= value <= self._dialect.max_word:
+            raise IndexError('value %d outside word size maximum of %d bits!'
+                % (value, self._dialect.word_size))
+
+        words = list(self._module.int_to_words(self._value, self._dialect))
+        words[idx] = value
+        self._value = self._module.words_to_int(words)
+
+    def __hash__(self):
+        """:return: hash of this EUI object suitable for dict keys, sets etc"""
+        return hash((self.version, self._value))
+
+    def __eq__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically the same as other, \
+            ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) == (other.version, other._value)
+
+    def __ne__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically the same as other, \
+            ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) != (other.version, other._value)
+
+    def __lt__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically lower in value than \
+            other, ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) < (other.version, other._value)
+
+    def __le__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically lower or equal in \
+            value to other, ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) <= (other.version, other._value)
+
+    def __gt__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically greater in value \
+            than other, ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) > (other.version, other._value)
+
+    def __ge__(self, other):
+        """
+        :return: ``True`` if this EUI object is numerically greater or equal \
+            in value to other, ``False`` otherwise.
+        """
+        if not isinstance(other, EUI):
+            try:
+                other = self.__class__(other)
+            except Exception:
+                return NotImplemented
+        return (self.version, self._value) >= (other.version, other._value)
+
+    def bits(self, word_sep=None):
+        """
+        :param word_sep: (optional) the separator to insert between words. \
+            Default: None - use default separator for address type.
+
+        :return: human-readable binary digit string of this address.
+        """
+        return self._module.int_to_bits(self._value, word_sep)
+
+    @property
+    def packed(self):
+        """The value of this EUI address as a packed binary string."""
+        return self._module.int_to_packed(self._value)
+
+    @property
+    def words(self):
+        """A list of unsigned integer octets found in this EUI address."""
+        return self._module.int_to_words(self._value)
+
+    @property
+    def bin(self):
+        """
+        The value of this EUI adddress in standard Python binary
+        representational form (0bxxx). A back port of the format provided by
+        the builtin bin() function found in Python 2.6.x and higher.
+        """
+        return self._module.int_to_bin(self._value)
+
+    def eui64(self):
+        """
+        - If this object represents an EUI-48 it is converted to EUI-64 \
+            as per the standard.
+        - If this object is already an EUI-64, a new, numerically \
+            equivalent object is returned instead.
+
+        :return: The value of this EUI object as a new 64-bit EUI object.
+        """
+        if self.version == 48:
+            # Convert 11:22:33:44:55:66 into 11:22:33:FF:FE:44:55:66.
+            first_three = self._value >> 24
+            last_three = self._value & 0xffffff
+            new_value = (first_three << 40) | 0xfffe000000 | last_three
+        else:
+            # is already a EUI64
+            new_value = self._value
+        return self.__class__(new_value, version=64)
+
+    def modified_eui64(self):
+        """
+        - create a new EUI object with a modified EUI-64 as described in RFC 4291 section 2.5.1
+
+        :return: a new and modified 64-bit EUI object.
+        """
+        # Modified EUI-64 format interface identifiers are formed by inverting
+        # the "u" bit (universal/local bit in IEEE EUI-64 terminology) when
+        # forming the interface identifier from IEEE EUI-64 identifiers.  In
+        # the resulting Modified EUI-64 format, the "u" bit is set to one (1)
+        # to indicate universal scope, and it is set to zero (0) to indicate
+        # local scope.
+        eui64 = self.eui64()
+        eui64._value ^= 0x00000000000000000200000000000000
+        return eui64
+
+    def ipv6(self, prefix):
+        """
+        .. note:: This poses security risks in certain scenarios. \
+            Please read RFC 4941 for details. Reference: RFCs 4291 and 4941.
+
+        :param prefix: ipv6 prefix
+
+        :return: new IPv6 `IPAddress` object based on this `EUI` \
+            using the technique described in RFC 4291.
+        """
+        int_val = int(prefix) + int(self.modified_eui64())
+        return IPAddress(int_val, version=6)
+
+    def ipv6_link_local(self):
+        """
+        .. note:: This poses security risks in certain scenarios. \
+            Please read RFC 4941 for details. Reference: RFCs 4291 and 4941.
+
+        :return: new link local IPv6 `IPAddress` object based on this `EUI` \
+            using the technique described in RFC 4291.
+        """
+        return self.ipv6(0xfe800000000000000000000000000000)
+
+    @property
+    def info(self):
+        """
+        A record dict containing IEEE registration details for this EUI
+        (MAC-48) if available, None otherwise.
+        """
+        data = {'OUI': self.oui.registration()}
+        if self.is_iab():
+            data['IAB'] = self.iab.registration()
+
+        return DictDotLookup(data)
+
+    def format(self, dialect=None):
+        """
+        Format the EUI into the representational format according to the given
+        dialect
+
+        :param dialect: the mac_* dialect defining the formatting of EUI-48 \
+            (MAC) addresses.
+
+        :return: EUI in representational format according to the given dialect
+        """
+        validated_dialect = self._validate_dialect(dialect)
+        return self._module.int_to_str(self._value, validated_dialect)
+
+    def __str__(self):
+        """:return: EUI in representational format"""
+        return self._module.int_to_str(self._value, self._dialect)
+
+    def __repr__(self):
+        """:return: executable Python string to recreate equivalent object."""
+        return "EUI('%s')" % self
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.idx b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.idx
new file mode 100644
index 0000000000000000000000000000000000000000..126c2a57f24803b5667829cf82be6a5d6426e149
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.idx
@@ -0,0 +1,4575 @@
+84682709,323,537
+17406710044,860,538
+17406710177,1398,537
+84684025,1935,537
+84684651,2472,537
+84681210,3009,537
+84682769,3546,537
+17406709776,4083,537
+84681294,4620,537
+84684660,5157,537
+84683001,5694,537
+84682262,6231,537
+84682866,6768,537
+84683551,7305,540
+17406710004,7845,539
+84683557,8384,537
+84683987,8921,537
+84684391,9458,537
+84682996,9995,537
+84681604,10532,538
+84683491,11070,537
+84681106,11607,537
+84681311,12144,537
+84682438,12681,537
+84681264,13218,537
+17406709975,13755,537
+84681658,14292,537
+84681028,14829,537
+84682992,15366,537
+84680748,15903,537
+84683504,16440,537
+84681012,16977,537
+84681108,17514,537
+84684364,18051,537
+84684400,18588,537
+84683884,19125,538
+84682646,19663,537
+84684254,20200,537
+84681074,20737,537
+84682109,21274,537
+17406710101,21811,541
+84684388,22352,537
+84683403,22889,537
+84681664,23426,537
+84682369,23963,537
+84683575,24500,537
+17406709912,25037,537
+84684099,25574,537
+84684688,26111,537
+84682554,26648,537
+84681080,27185,537
+84682173,27722,537
+84684312,28259,610
+84681230,28869,537
+84681826,29406,537
+84684462,29943,537
+84683050,30480,550
+84683770,31030,550
+84684103,31580,550
+84684461,32130,550
+84682150,32680,537
+17406710146,33217,537
+84684715,33754,550
+84681701,34304,537
+84681530,34841,537
+84682066,35378,537
+84683873,35915,537
+84683332,36452,537
+84680888,36989,537
+84684679,37526,537
+84681698,38063,537
+84683094,38600,537
+84682178,39137,537
+84684709,39674,537
+84681007,40211,537
+84681027,40748,537
+84683278,41285,537
+84682047,41822,537
+84681850,42359,537
+84682665,42896,537
+84683136,43433,537
+84681654,43970,537
+84680832,44507,537
+84683091,45044,537
+17406710147,45581,537
+84681568,46118,537
+84683124,46655,537
+17406710242,47192,537
+17406710212,47729,537
+17406710198,48266,537
+17406710209,48803,537
+17406710224,49340,537
+17406710176,49877,537
+17406710175,50414,537
+17406710190,50951,537
+17406710171,51488,537
+17406710172,52025,537
+17406710169,52562,537
+17406710174,53099,537
+17406710186,53636,537
+17406710183,54173,537
+17406710184,54710,537
+17406710159,55247,537
+17406710143,55784,537
+17406710145,56321,537
+17406710120,56858,537
+17406710105,57395,537
+17406710109,57932,537
+17406710128,58469,537
+17406710083,59006,537
+17406710095,59543,537
+17406710078,60080,537
+17406710082,60617,537
+17406710076,61154,547
+17406710077,61701,559
+17406710055,62260,537
+17406710071,62797,537
+17406710063,63334,216
+17406710073,63550,557
+17406710059,64107,537
+17406710013,64644,537
+17406710012,65181,537
+17406710042,65718,537
+17406710039,66255,537
+17406710023,66792,537
+17406710048,67329,537
+17406709997,67866,537
+17406709994,68403,537
+17406709992,68940,537
+17406709998,69477,537
+17406709982,70014,537
+17406709974,70551,537
+17406709972,71088,537
+17406709970,71625,537
+17406709980,72162,537
+17406709956,72699,537
+17406709926,73236,544
+17406709928,73780,539
+17406709941,74319,537
+17406709933,74856,537
+17406709936,75393,537
+17406709935,75930,537
+17406709934,76467,537
+17406709938,77004,537
+17406709915,77541,537
+17406709909,78078,537
+17406709905,78615,547
+17406709902,79162,537
+17406709903,79699,537
+17406709898,80236,537
+17406709870,80773,537
+17406709867,81310,539
+17406709865,81849,537
+17406709869,82386,537
+17406709874,82923,537
+17406709875,83460,537
+17406709890,83997,537
+17406709886,84534,537
+17406709847,85071,537
+17406709843,85608,537
+17406709830,86145,537
+17406709854,86682,537
+17406709826,87219,537
+17406709820,87756,537
+17406709811,88293,537
+17406709801,88830,537
+17406709832,89367,537
+17406709816,89904,537
+17406709824,90441,537
+17406709763,90978,537
+17406709779,91515,537
+17406709781,92052,537
+17406709773,92589,549
+17406709791,93138,537
+17406709786,93675,537
+17406709774,94212,537
+84684794,94749,537
+17406709766,95286,537
+84684772,95823,537
+84684778,96360,537
+84684781,96897,537
+84684780,97434,537
+84684760,97971,537
+84684762,98508,537
+84684747,99045,556
+84684735,99601,537
+84684734,100138,537
+84684741,100675,537
+84684723,101212,537
+84684722,101749,537
+84684718,102286,557
+84684719,102843,539
+84684724,103382,537
+84684702,103919,537
+84684714,104456,537
+84684717,104993,537
+84684691,105530,539
+84684681,106069,537
+84684690,106606,537
+84684699,107143,537
+84684657,107680,537
+84684653,108217,538
+84684654,108755,537
+84684624,109292,537
+84684638,109829,537
+84684636,110366,537
+84684619,110903,537
+84684634,111440,537
+84684642,111977,537
+84684614,112514,537
+84684630,113051,537
+84684601,113588,537
+84684605,114125,537
+84684604,114662,537
+84684599,115199,537
+84684593,115736,537
+84684609,116273,537
+84684587,116810,537
+84684581,117347,537
+84684580,117884,537
+84684555,118421,537
+84684549,118958,537
+84684567,119495,600
+84684565,120095,537
+84684568,120632,538
+84684553,121170,537
+84684536,121707,537
+84684507,122244,537
+84684506,122781,537
+84684505,123318,537
+84684478,123855,539
+84684497,124394,537
+84684472,124931,537
+84684495,125468,537
+84684466,126005,537
+84684467,126542,537
+84684452,127079,537
+84684449,127616,537
+84684455,128153,537
+84684444,128690,537
+84684409,129227,537
+84684429,129764,537
+84684428,130301,538
+84684427,130839,537
+84684413,131376,537
+84684414,131913,538
+84684397,132451,537
+84684398,132988,537
+84684395,133525,539
+84684393,134064,537
+84684373,134601,537
+84684372,135138,537
+84684387,135675,539
+84684380,136214,552
+84684403,136766,537
+84684384,137303,537
+84684366,137840,537
+84684370,138377,537
+84684347,138914,537
+84684345,139451,537
+84684344,139988,537
+84684357,140525,537
+84684328,141062,537
+84684327,141599,537
+84684336,142136,537
+84684322,142673,537
+84684309,143210,537
+84684303,143747,537
+84684326,144284,537
+84684318,144821,537
+84684304,145358,537
+84684280,145895,537
+84684274,146432,537
+84684248,146969,545
+84684253,147514,537
+84684249,148051,537
+84684240,148588,537
+84684228,149125,537
+84684222,149662,537
+84684224,150199,537
+84684219,150736,537
+84684234,151273,537
+84684197,151810,537
+84684195,152347,537
+84684198,152884,537
+84684208,153421,537
+84684192,153958,537
+84684191,154495,537
+84684184,155032,545
+84684211,155577,539
+84684199,156116,537
+84684167,156653,537
+84684180,157190,537
+84684176,157727,539
+84684178,158266,537
+84684174,158803,537
+84684173,159340,539
+84684158,159879,537
+84684156,160416,537
+84684136,160953,537
+84684121,161490,538
+84684130,162028,537
+84684131,162565,538
+84684124,163103,537
+84684115,163640,537
+84684145,164177,537
+84684111,164714,537
+84684077,165251,537
+84684108,165788,537
+84684084,166325,537
+84684035,166862,537
+84684034,167399,537
+84684071,167936,537
+84684070,168473,537
+84684060,169010,537
+84684052,169547,538
+84684048,170085,537
+84684050,170622,537
+84684047,171159,537
+84684043,171696,537
+84684042,172233,537
+84684064,172770,537
+84684006,173307,537
+84684007,173844,537
+84684029,174381,537
+84684023,174918,537
+84684022,175455,538
+84684009,175993,216
+84683988,176209,537
+84683989,176746,537
+84683978,177283,537
+84683970,177820,537
+84683995,178357,537
+84683994,178894,537
+84683953,179431,537
+84683951,179968,537
+84683927,180505,537
+84683931,181042,537
+84683947,181579,538
+84683945,182117,537
+84683924,182654,537
+84683921,183191,537
+84683893,183728,537
+84683885,184265,537
+84683882,184802,537
+84683887,185339,537
+84683889,185876,537
+84683876,186413,537
+84683871,186950,537
+84683913,187487,537
+84683907,188024,537
+84683909,188561,537
+84683908,189098,537
+84683867,189635,537
+84683848,190172,537
+84683839,190709,537
+84683800,191246,537
+84683816,191783,539
+84683762,192322,537
+84683758,192859,216
+84683766,193075,537
+84683767,193612,538
+84683764,194150,537
+84683754,194687,537
+84683744,195224,537
+84683746,195761,537
+84683742,196298,537
+84683779,196835,537
+84683740,197372,537
+84683735,197909,539
+84683750,198448,537
+84683709,198985,537
+84683727,199522,537
+84683720,200059,537
+84683728,200596,537
+84683711,201133,538
+84683655,201671,537
+84683652,202208,537
+84683675,202745,537
+84683658,203282,537
+84683657,203819,537
+84683681,204356,538
+84683682,204894,537
+84683664,205431,537
+84683668,205968,537
+84683663,206505,537
+84683693,207042,537
+84683691,207579,552
+84683646,208131,537
+84683620,208668,537
+84683621,209205,537
+84683629,209742,537
+84683609,210279,537
+84683607,210816,538
+84683589,211354,537
+84683584,211891,537
+84683605,212428,537
+84683581,212965,537
+84683556,213502,537
+84683553,214039,539
+84683554,214578,537
+84683538,215115,538
+84683559,215653,537
+84683567,216190,537
+84683574,216727,537
+84683530,217264,539
+84683536,217803,537
+84683517,218340,537
+84683514,218877,537
+84683522,219414,537
+84683498,219951,537
+84683499,220488,537
+84683493,221025,587
+84683490,221612,537
+84683489,222149,537
+84683477,222686,537
+84683507,223223,537
+84683482,223760,537
+84683432,224297,537
+84683437,224834,537
+84683464,225371,537
+84683451,225908,537
+84683409,226445,537
+84683408,226982,537
+84683426,227519,537
+84683425,228056,537
+84683404,228593,537
+84683430,229130,537
+84683399,229667,537
+84683400,230204,537
+84683401,230741,537
+84683434,231278,537
+84683352,231815,537
+84683353,232352,537
+84683348,232889,537
+84683347,233426,537
+84683379,233963,537
+84683357,234500,537
+84683388,235037,537
+84683370,235574,537
+84683315,236111,537
+84683313,236648,537
+84683311,237185,537
+84683306,237722,537
+84683329,238259,537
+84683289,238796,537
+84683323,239333,537
+84683340,239870,537
+84683249,240407,537
+84683241,240944,537
+84683245,241481,537
+84683286,242018,539
+84683272,242557,537
+84683268,243094,537
+84683237,243631,537
+84683233,244168,537
+84683193,244705,538
+84683212,245243,552
+84683206,245795,537
+84683191,246332,537
+84683188,246869,537
+84683176,247406,537
+84683160,247943,538
+84683154,248481,537
+84683149,249018,537
+84683146,249555,537
+84683131,250092,537
+84683120,250629,537
+84683144,251166,537
+84683132,251703,537
+84683110,252240,537
+84683139,252777,537
+84683098,253314,537
+84683083,253851,539
+84683082,254390,537
+84683101,254927,537
+84683078,255464,537
+84683076,256001,537
+84683057,256538,537
+84683060,257075,537
+84683058,257612,537
+84683062,258149,537
+84683049,258686,537
+84683054,259223,537
+84683006,259760,537
+84683025,260297,537
+84683011,260834,537
+84683008,261371,537
+84683012,261908,537
+84683021,262445,537
+84683028,262982,537
+84683036,263519,537
+84683029,264056,537
+84682995,264593,537
+84683004,265130,537
+84683000,265667,537
+84682993,266204,537
+84682983,266741,539
+84682970,267280,537
+84682985,267817,537
+84682953,268354,537
+84682940,268891,537
+84682941,269428,537
+84682939,269965,538
+84682936,270503,537
+84682937,271040,537
+84682935,271577,537
+84682965,272114,537
+84682969,272651,537
+84682964,273188,540
+84682963,273728,537
+84682947,274265,538
+84682943,274803,537
+84682929,275340,537
+84682926,275877,547
+84682927,276424,537
+84682909,276961,539
+84682907,277500,537
+84682895,278037,539
+84682897,278576,537
+84682881,279113,537
+84682528,279650,537
+84682856,280187,537
+84682854,280724,537
+84682871,281261,537
+84682869,281798,538
+84682877,282336,537
+84682873,282873,537
+84682824,283410,598
+84682828,284008,537
+84682834,284545,537
+84682807,285082,537
+84682785,285619,537
+84682800,286156,537
+84682797,286693,537
+84682790,287230,537
+84682778,287767,537
+84682787,288304,537
+84682755,288841,537
+84682734,289378,537
+84682771,289915,537
+84682765,290452,537
+84682708,290989,537
+84682701,291526,537
+84682717,292063,538
+84682722,292601,537
+84682724,293138,537
+84682710,293675,537
+84682686,294212,537
+84682689,294749,537
+84682670,295286,537
+84682672,295823,537
+84682640,296360,537
+84682636,296897,537
+84682639,297434,537
+84682638,297971,537
+84682637,298508,537
+84682631,299045,537
+84682661,299582,537
+84682643,300119,537
+84682655,300656,537
+84682599,301193,537
+84682605,301730,537
+84682589,302267,537
+84682572,302804,537
+84682557,303341,537
+84682539,303878,537
+84682526,304415,537
+84682543,304952,537
+84682550,305489,537
+84682516,306026,537
+84682514,306563,538
+84682486,307101,538
+84682488,307639,537
+84682501,308176,537
+84682512,308713,537
+84682506,309250,537
+84682466,309787,538
+84682468,310325,537
+84682462,310862,537
+84682454,311399,537
+84682477,311936,537
+84682481,312473,537
+84682422,313010,537
+84682443,313547,537
+84682449,314084,538
+84682431,314622,537
+84682415,315159,537
+84682375,315696,537
+84682373,316233,537
+84682371,316770,537
+84682406,317307,537
+84682402,317844,537
+84682404,318381,537
+84682401,318918,537
+84682379,319455,537
+84682380,319992,537
+84682397,320529,537
+84682394,321066,537
+84682366,321603,537
+84682387,322140,537
+84682335,322677,537
+84682355,323214,537
+84682352,323751,537
+84682363,324288,537
+84682320,324825,537
+84682319,325362,537
+84682318,325899,537
+84682315,326436,537
+84682306,326973,537
+84682300,327510,537
+84682297,328047,537
+84682284,328584,537
+84682314,329121,537
+84682321,329658,537
+84682286,330195,540
+84682263,330735,537
+84682281,331272,537
+84682279,331809,537
+84682275,332346,537
+84682268,332883,537
+84682274,333420,537
+84682248,333957,537
+84682237,334494,537
+84682239,335031,537
+84682234,335568,537
+84682236,336105,537
+84682228,336642,537
+84682225,337179,537
+84682181,337716,537
+84682212,338253,537
+84682162,338790,537
+84682154,339327,537
+84682180,339864,537
+84682143,340401,543
+84682169,340944,537
+84682161,341481,537
+84682131,342018,537
+84682129,342555,537
+84682100,343092,544
+84682138,343636,537
+84682111,344173,537
+84682127,344710,537
+84682099,345247,537
+84682110,345784,537
+84682101,346321,537
+84682085,346858,538
+84682083,347396,538
+84682084,347934,537
+84682079,348471,537
+84682088,349008,537
+84682072,349545,537
+84682082,350082,537
+84682063,350619,538
+84682036,351157,537
+84682037,351694,537
+84682029,352231,537
+84682026,352768,537
+84682045,353305,537
+84682040,353842,537
+84682049,354379,537
+84681999,354916,538
+84682011,355454,537
+84682006,355991,537
+84682025,356528,538
+84682022,357066,537
+84681979,357603,537
+84681978,358140,537
+84681973,358677,537
+84681972,359214,539
+84681995,359753,537
+84681993,360290,537
+84681969,360827,537
+84681963,361364,537
+84681986,361901,537
+84681921,362438,537
+84681917,362975,537
+84681918,363512,537
+84681926,364049,537
+84681924,364586,537
+84681923,365123,537
+84681956,365660,537
+84681931,366197,537
+84681941,366734,537
+84681903,367271,537
+84681902,367808,543
+84681887,368351,537
+84681490,368888,537
+84681888,369425,537
+84681892,369962,537
+84681914,370499,537
+84681891,371036,537
+84681852,371573,537
+84681868,372110,537
+84681866,372647,537
+84681867,373184,543
+84681870,373727,537
+84681871,374264,537
+84681876,374801,537
+84681855,375338,537
+84681884,375875,537
+84681859,376412,537
+84681842,376949,537
+84681839,377486,537
+84681846,378023,537
+84681848,378560,537
+84681847,379097,538
+84681827,379635,537
+84681820,380172,537
+84681819,380709,537
+84681815,381246,537
+84681794,381783,537
+84681796,382320,537
+84681797,382857,537
+84681801,383394,537
+84681793,383931,537
+84681791,384468,537
+84681784,385005,537
+84681765,385542,537
+84681759,386079,537
+84681743,386616,537
+84681745,387153,537
+84681760,387690,537
+84681764,388227,538
+84681774,388765,537
+84681749,389302,537
+84681748,389839,537
+84681777,390376,537
+84681739,390913,537
+84681738,391450,538
+84681741,391988,537
+84681709,392525,537
+84681723,393062,537
+84681702,393599,537
+84681700,394136,537
+84681735,394673,537
+84681728,395210,539
+84681730,395749,537
+84681695,396286,537
+84681691,396823,537
+84681693,397360,537
+84681690,397897,537
+84681685,398434,541
+84681682,398975,537
+84681687,399512,539
+84681678,400051,537
+84681665,400588,537
+84681661,401125,537
+84681631,401662,537
+84681646,402199,537
+84681647,402736,537
+84681648,403273,538
+84681632,403811,537
+84681652,404348,540
+84681637,404888,537
+84681649,405425,537
+84681598,405962,537
+84681594,406499,537
+84681602,407036,537
+84681613,407573,537
+84681607,408110,537
+84681551,408647,537
+84681579,409184,537
+84681573,409721,537
+84681577,410258,537
+84681549,410795,537
+84681537,411332,537
+84681560,411869,537
+84681557,412406,537
+84681570,412943,537
+84681565,413480,537
+84681518,414017,537
+84681524,414554,537
+84681525,415091,537
+84681500,415628,537
+84681508,416165,538
+84681534,416703,537
+84681504,417240,537
+84681465,417777,537
+84681461,418314,537
+84681472,418851,537
+84681450,419388,537
+84681458,419925,537
+84681454,420462,537
+84681419,420999,537
+84681436,421536,537
+84681429,422073,537
+84681431,422610,537
+84681444,423147,537
+84681405,423684,537
+84681401,424221,537
+84681394,424758,537
+84681384,425295,537
+84681398,425832,537
+84681362,426369,537
+84681359,426906,537
+84681360,427443,537
+84681332,427980,544
+84681331,428524,540
+84681316,429064,537
+84681349,429601,537
+84681346,430138,537
+84681344,430675,537
+84681340,431212,537
+84681291,431749,537
+84681317,432286,537
+84681300,432823,537
+84681297,433360,537
+84681287,433897,537
+84681306,434434,537
+84681261,434971,537
+84681281,435508,537
+84681273,436045,537
+84681242,436582,537
+84681246,437119,537
+84681238,437656,537
+84681237,438193,539
+84681255,438732,537
+84681256,439269,537
+84681226,439806,537
+84681229,440343,537
+84681250,440880,537
+84681205,441417,537
+84681206,441954,537
+84681204,442491,537
+84681199,443028,537
+84681214,443565,537
+84681165,444102,537
+84681168,444639,537
+84681178,445176,537
+84681173,445713,537
+84681159,446250,537
+84681135,446787,537
+84681152,447324,537
+84681153,447861,537
+84681154,448398,537
+84681118,448935,537
+84681115,449472,537
+84681121,450009,537
+84681128,450546,537
+84681111,451083,539
+84681091,451622,538
+84681093,452160,537
+84681089,452697,537
+84681088,453234,537
+84681098,453771,537
+84681083,454308,537
+84681081,454845,537
+84681084,455382,537
+84681086,455919,537
+84680723,456456,537
+84680705,456993,537
+84680728,457530,537
+84681030,458067,537
+84680704,458604,537
+84681053,459141,537
+84681051,459678,537
+84681052,460215,537
+84681031,460752,537
+84681029,461289,537
+84681043,461826,537
+84681042,462363,537
+84680997,462900,537
+84681025,463437,537
+84681026,463974,537
+84681023,464511,537
+84681021,465048,537
+84681013,465585,537
+84681003,466122,537
+84681008,466659,537
+84681005,467196,537
+84680987,467733,537
+84680988,468270,537
+84680991,468807,537
+84680981,469344,537
+84680983,469881,537
+84680973,470418,537
+84680982,470955,537
+84680953,471492,537
+84680965,472029,537
+84680963,472566,537
+84680957,473103,537
+84680934,473640,537
+84680935,474177,537
+84680948,474714,537
+84680930,475251,537
+84680924,475788,537
+84680902,476325,541
+84680901,476866,537
+84680909,477403,537
+84680907,477940,537
+84680868,478477,537
+84680862,479014,537
+84680864,479551,537
+84680856,480088,537
+84680854,480625,537
+84680842,481162,537
+84680850,481699,537
+84680828,482236,537
+84680824,482773,537
+84680819,483310,537
+84680817,483847,537
+84680812,484384,537
+84680807,484921,537
+84680810,485458,537
+84680777,485995,537
+84680774,486532,216
+84680770,486748,537
+84680769,487285,537
+84680767,487822,537
+84680756,488359,537
+84680750,488896,537
+84680747,489433,537
+84680752,489970,539
+84680739,490509,537
+84680738,491046,537
+84680732,491583,537
+84680712,492120,537
+84680805,492657,537
+84683252,493194,537
+84681301,493731,537
+84683899,494268,537
+84684181,494805,537
+84683478,495342,537
+84684456,495879,539
+84684012,496418,537
+84681811,496955,537
+84682276,497492,537
+17406709966,498029,537
+84681442,498566,537
+84680835,499103,537
+84680895,499640,216
+84684168,499856,538
+84681593,500394,537
+84683027,500931,545
+84684733,501476,538
+84681694,502014,569
+84684756,502583,537
+17406710140,503120,537
+84681529,503657,537
+84681408,504194,537
+84682925,504731,537
+84683336,505268,537
+84683444,505805,539
+84682615,506344,537
+84682906,506881,537
+84682364,507418,537
+84682702,507955,537
+84684463,508492,537
+17406709771,509029,537
+84684687,509566,537
+84680885,510103,537
+84684440,510640,537
+84683875,511177,537
+84683231,511714,537
+84683524,512251,537
+84684262,512788,537
+84684564,513325,537
+84681905,513862,537
+84684346,514399,537
+84681434,514936,537
+84683786,515473,610
+84681731,516083,550
+84681772,516633,537
+84681203,517170,537
+17406709772,517707,550
+84684394,518257,550
+84684288,518807,550
+84684203,519357,550
+84681775,519907,537
+84683703,520444,537
+84681950,520981,537
+84681533,521518,537
+84683972,522055,537
+84681463,522592,537
+84684764,523129,537
+84681019,523666,537
+84681239,524203,537
+84681520,524740,537
+84682253,525277,537
+17406709884,525814,537
+84681033,526351,538
+84680800,526889,216
+84684187,527105,537
+84682188,527642,537
+84683680,528179,537
+84681195,528716,537
+84681592,529253,537
+84681258,529790,537
+84681004,530327,537
+84683748,530864,537
+84682839,531401,537
+84682666,531938,537
+84682232,532475,537
+84682090,533012,537
+17406709799,533549,537
+17406709873,534086,537
+84683601,534623,537
+17406710065,535160,537
+84682979,535697,539
+17406713574,536236,537
+17406710240,536773,537
+17406710243,537310,537
+17406710220,537847,537
+17406710225,538384,537
+17406710227,538921,537
+17406710201,539458,537
+17406710218,539995,537
+17406710213,540532,216
+17406710237,540748,537
+17406710181,541285,537
+17406710189,541822,537
+17406710142,542359,537
+17406710149,542896,537
+17406710153,543433,537
+17406710152,543970,537
+17406710131,544507,538
+17406710135,545045,537
+17406710129,545582,537
+17406710112,546119,537
+17406710115,546656,537
+17406710116,547193,537
+17406710119,547730,537
+17406710121,548267,537
+17406710099,548804,537
+17406710104,549341,537
+17406710103,549878,537
+17406710092,550415,537
+17406710054,550952,537
+17406710068,551489,537
+17406710061,552026,537
+17406710066,552563,537
+17406710027,553100,537
+17406710029,553637,537
+17406710036,554174,537
+17406710017,554711,537
+17406709989,555248,537
+17406709979,555785,538
+17406709996,556323,537
+17406710007,556860,538
+17406709953,557398,537
+17406709954,557935,537
+17406709976,558472,537
+17406709957,559009,537
+17406709971,559546,537
+17406709924,560083,537
+17406709930,560620,537
+17406709892,561157,537
+17406709914,561694,537
+17406709883,562231,543
+17406709864,562774,537
+17406709860,563311,537
+17406709853,563848,537
+17406709841,564385,537
+17406709840,564922,537
+17406709835,565459,537
+17406709852,565996,537
+17406709848,566533,537
+17406709806,567070,537
+17406709825,567607,537
+17406709813,568144,537
+17406709818,568681,537
+17406709819,569218,537
+17406709785,569755,537
+17406709789,570292,537
+17406709802,570829,537
+84684790,571366,537
+17406709782,571903,537
+17406709769,572440,537
+84684798,572977,537
+84684792,573514,537
+84684768,574051,537
+84684761,574588,537
+84684758,575125,537
+84684751,575662,537
+84684755,576199,537
+84684743,576736,537
+84684740,577273,537
+84684750,577810,537
+84684703,578347,537
+84684707,578884,537
+84684729,579421,537
+84684706,579958,537
+84684694,580495,537
+84684684,581032,537
+84684683,581569,537
+84684671,582106,537
+84684676,582643,537
+84684678,583180,537
+84684669,583717,537
+84684665,584254,537
+84684648,584791,539
+84684667,585330,537
+84684664,585867,538
+84684659,586405,537
+84684645,586942,537
+84684635,587479,537
+84684622,588016,537
+84684625,588553,537
+84684637,589090,551
+84684617,589641,537
+84684611,590178,537
+84684608,590715,537
+84684577,591252,537
+84684588,591789,537
+84684594,592326,538
+84684558,592864,537
+84684541,593401,537
+84684545,593938,537
+84684544,594475,537
+84684550,595012,537
+84684547,595549,537
+84684532,596086,537
+84684528,596623,537
+84684511,597160,537
+84684508,597697,537
+84684523,598234,538
+84684521,598772,537
+84684534,599309,537
+84684517,599846,538
+84684500,600384,537
+84684498,600921,537
+84684503,601458,537
+84684502,601995,537
+84684499,602532,537
+84684489,603069,537
+84684481,603606,537
+84684480,604143,537
+84684479,604680,537
+84684464,605217,537
+84684459,605754,537
+84684458,606291,537
+84684450,606828,537
+84684448,607365,537
+84684469,607902,537
+84684435,608439,537
+84684432,608976,539
+84684433,609515,537
+84684420,610052,600
+84684430,610652,537
+84684410,611189,537
+84684424,611726,537
+84684442,612263,537
+84684438,612800,538
+84684445,613338,537
+84684441,613875,537
+84684385,614412,537
+84684399,614949,537
+84684381,615486,537
+84684401,616023,538
+84684392,616561,537
+84684354,617098,539
+84684337,617637,537
+84684359,618174,537
+84684334,618711,537
+84684319,619248,537
+84684311,619785,537
+84684314,620322,537
+84684289,620859,537
+84684286,621396,537
+84684285,621933,537
+84684293,622470,537
+84684292,623007,537
+84684277,623544,537
+84684258,624081,537
+84684238,624618,537
+84684242,625155,537
+84684252,625692,537
+84684216,626229,537
+84684221,626766,537
+84684207,627303,537
+84684230,627840,537
+84684188,628377,537
+84684185,628914,537
+84684202,629451,537
+84684177,629988,537
+84684142,630525,537
+84684157,631062,537
+84684159,631599,537
+84684155,632136,537
+84684154,632673,537
+84684149,633210,537
+84684150,633747,537
+84684140,634284,549
+84684139,634833,537
+84684162,635370,537
+84684163,635907,537
+84684148,636444,537
+84684147,636981,537
+84684134,637518,537
+84684118,638055,537
+84684117,638592,537
+84684101,639129,537
+84684100,639666,537
+84684123,640203,537
+84684128,640740,537
+84684126,641277,537
+84684114,641814,537
+84684105,642351,537
+84684097,642888,537
+84684093,643425,537
+84684091,643962,537
+84684063,644499,537
+84684059,645036,537
+84684089,645573,537
+84684032,646110,538
+84684028,646648,537
+84684046,647185,537
+84684015,647722,537
+84683967,648259,538
+84684005,648797,537
+84683998,649334,538
+84683936,649872,537
+84683949,650409,537
+84683948,650946,537
+84683957,651483,216
+84683959,651699,537
+84683941,652236,537
+84683954,652773,537
+84683952,653310,537
+84683919,653847,537
+84683917,654384,537
+84683904,654921,537
+84683900,655458,537
+84683897,655995,537
+84683879,656532,537
+84683860,657069,537
+84683858,657606,537
+84683869,658143,540
+84683866,658683,538
+84683855,659221,537
+84683894,659758,537
+84683890,660295,537
+84683841,660832,537
+84683838,661369,538
+84683825,661907,537
+84683820,662444,537
+84683835,662981,538
+84683833,663519,537
+84683814,664056,537
+84683810,664593,537
+84683801,665130,537
+84683802,665667,537
+84683803,666204,539
+84683826,666743,537
+84683849,667280,537
+84683795,667817,537
+84683793,668354,537
+84683787,668891,537
+84683759,669428,563
+84683774,669991,537
+84683798,670528,537
+84683712,671065,537
+84683708,671602,537
+84683710,672139,537
+84683755,672676,537
+84683721,673213,537
+84683726,673750,537
+84683732,674287,537
+84683699,674824,537
+84683698,675361,537
+84683660,675898,537
+84683661,676435,537
+84683687,676972,539
+84683705,677511,537
+84683649,678048,538
+84683656,678586,541
+84683653,679127,537
+84683622,679664,538
+84683642,680202,537
+84683635,680739,537
+84683632,681276,537
+84683647,681813,537
+84683628,682350,538
+84683583,682888,538
+84683572,683426,537
+84683599,683963,537
+84683596,684500,537
+84683591,685037,537
+84683614,685574,537
+84683549,686111,537
+84683547,686648,537
+84683544,687185,537
+84683560,687722,537
+84683558,688259,537
+84683533,688796,537
+84683520,689333,537
+84683467,689870,537
+84683505,690407,537
+84683488,690944,538
+84683473,691482,538
+84683506,692020,537
+84683461,692557,537
+84683449,693094,537
+84683431,693631,537
+84683442,694168,537
+84683398,694705,539
+84683424,695244,537
+84683417,695781,537
+84683418,696318,537
+84683411,696855,537
+84683412,697392,537
+84683414,697929,537
+84683344,698466,537
+84683343,699003,538
+84683342,699541,537
+84683387,700078,537
+84683368,700615,537
+84683366,701152,537
+84683359,701689,537
+84683301,702226,537
+84683296,702763,537
+84683294,703300,537
+84683295,703837,537
+84683293,704374,537
+84683338,704911,537
+84683284,705448,545
+84683287,705993,547
+84683333,706540,537
+84683321,707077,537
+84683262,707614,549
+84683264,708163,537
+84683285,708700,537
+84683279,709237,537
+84683273,709774,537
+84683232,710311,537
+84683260,710848,537
+84683238,711385,537
+84683258,711922,537
+84683253,712459,537
+84683210,712996,538
+84683214,713534,537
+84683192,714071,537
+84683187,714608,537
+84683185,715145,537
+84683208,715682,537
+84683216,716219,548
+84683172,716767,537
+84683164,717304,537
+84683167,717841,537
+84683181,718378,537
+84683178,718915,537
+84683163,719452,537
+84683159,719989,541
+84683158,720530,537
+84683171,721067,537
+84683174,721604,537
+84683141,722141,537
+84683140,722678,537
+84683137,723215,537
+84683134,723752,537
+84683125,724289,537
+84683113,724826,537
+84683111,725363,537
+84683118,725900,537
+84683127,726437,537
+84683093,726974,537
+84683079,727511,537
+84683073,728048,537
+84683067,728585,537
+84683055,729122,538
+84683037,729660,537
+84683059,730197,537
+84683053,730734,537
+84683070,731271,537
+84683010,731808,537
+84683023,732345,537
+84683022,732882,538
+84683014,733420,537
+84682988,733957,537
+84682989,734494,537
+84682982,735031,537
+84682974,735568,537
+84682972,736105,537
+84682990,736642,537
+84682948,737179,567
+84682950,737746,537
+84682945,738283,537
+84682931,738820,537
+84682932,739357,537
+84682967,739894,537
+84682968,740431,537
+84682962,740968,537
+84682956,741505,537
+84682910,742042,537
+84682879,742579,537
+84682890,743116,537
+84682923,743653,537
+84682902,744190,537
+84682900,744727,537
+84682896,745264,545
+84682875,745809,537
+84682874,746346,537
+84682855,746883,537
+84682852,747420,537
+84682835,747957,537
+84682848,748494,537
+84682863,749031,537
+84682859,749568,537
+84682845,750105,537
+84682827,750642,537
+84682832,751179,537
+84682803,751716,537
+84682820,752253,537
+84682816,752790,537
+84682811,753327,537
+84682774,753864,537
+84682775,754401,537
+84682780,754938,537
+84682779,755475,537
+84682782,756012,537
+84682786,756549,537
+84682723,757086,537
+84682756,757623,537
+84682762,758160,538
+84682725,758698,537
+84682744,759235,544
+84682743,759779,537
+84682748,760316,537
+84682760,760853,537
+84682693,761390,537
+84682707,761927,537
+84682720,762464,537
+84682695,763001,538
+84682697,763539,537
+84682660,764076,537
+84682658,764613,537
+84682685,765150,537
+84682684,765687,537
+84682682,766224,537
+84682680,766761,537
+84682688,767298,537
+84682675,767835,537
+84682676,768372,537
+84682623,768909,537
+84682650,769446,537
+84682648,769983,537
+84682649,770520,537
+84682609,771057,537
+84682607,771594,537
+84682608,772131,537
+84682645,772668,537
+84682642,773205,546
+84682620,773751,537
+84682618,774288,537
+84682594,774825,537
+84682591,775362,537
+84682590,775899,537
+84682601,776436,537
+84682585,776973,537
+84682553,777510,537
+84682567,778047,537
+84682518,778584,537
+84682530,779121,537
+84682535,779658,537
+84682534,780195,537
+84682507,780732,537
+84682483,781269,537
+84682497,781806,537
+84682459,782343,537
+84682461,782880,537
+84682451,783417,537
+84682455,783954,537
+84682458,784491,537
+84682463,785028,537
+84682473,785565,537
+84682465,786102,537
+84682432,786639,539
+84682444,787178,537
+84682428,787715,537
+84682408,788252,537
+84682441,788789,537
+84682440,789326,537
+84682417,789863,537
+84682376,790400,537
+84682377,790937,537
+84682382,791474,537
+84682374,792011,537
+84682357,792548,537
+84682400,793085,537
+84682393,793622,537
+84682389,794159,537
+84682337,794696,537
+84682353,795233,537
+84682349,795770,537
+84682342,796307,537
+84682338,796844,556
+84682351,797400,537
+84682325,797937,537
+84682326,798474,537
+84682299,799011,537
+84682301,799548,537
+84682305,800085,552
+84682308,800637,538
+84682283,801175,542
+84682293,801717,537
+84682288,802254,537
+84682317,802791,537
+84682258,803328,537
+84682265,803865,537
+84682254,804402,537
+84682251,804939,539
+84682269,805478,537
+84682245,806015,537
+84682259,806552,537
+84682229,807089,537
+84682230,807626,537
+84682240,808163,537
+84682246,808700,537
+84682219,809237,539
+84682202,809776,537
+84682198,810313,537
+84682213,810850,537
+84682194,811387,537
+84682170,811924,537
+84682171,812461,537
+84682172,812998,556
+84682167,813554,537
+84682158,814091,537
+84682156,814628,537
+84682114,815165,537
+84682125,815702,537
+84682142,816239,537
+84682128,816776,537
+84682130,817313,537
+84682108,817850,539
+84682122,818389,537
+84682123,818926,537
+84682119,819463,537
+84682070,820000,537
+84682069,820537,537
+84682081,821074,537
+84682087,821611,539
+84682078,822150,537
+84682094,822687,537
+84682095,823224,537
+84682075,823761,537
+84682062,824298,537
+84682051,824835,537
+84682012,825372,537
+84682009,825909,537
+84682024,826446,537
+84682017,826983,537
+84681997,827520,537
+84681998,828057,537
+84681992,828594,537
+84681994,829131,537
+84681981,829668,537
+84681964,830205,537
+84681961,830742,537
+84681983,831279,537
+84681988,831816,537
+84681989,832353,537
+84681966,832890,537
+84681925,833427,537
+84681919,833964,537
+84681959,834501,537
+84681949,835038,537
+84681958,835575,537
+84681955,836112,537
+84681932,836649,537
+84681948,837186,537
+84681940,837723,537
+84681939,838260,538
+84681889,838798,537
+84681915,839335,537
+84681904,839872,537
+84681920,840409,537
+84681854,840946,537
+84681865,841483,537
+84681869,842020,537
+84681873,842557,537
+84681583,843094,537
+84681845,843631,539
+84681821,844170,537
+84681836,844707,537
+84681829,845244,537
+84681828,845781,537
+84681816,846318,537
+84681814,846855,538
+84681789,847393,537
+84681788,847930,537
+84681792,848467,538
+84681812,849005,537
+84681805,849542,537
+84681806,850079,543
+84681771,850622,537
+84681767,851159,537
+84681766,851696,537
+84681769,852233,537
+84681778,852770,537
+84681776,853307,537
+84681786,853844,537
+84681763,854381,537
+84681751,854918,538
+84681747,855456,537
+84681740,855993,537
+84681713,856530,537
+84681712,857067,537
+84681724,857604,537
+84681716,858141,537
+84681727,858678,537
+84681734,859215,537
+84681671,859752,537
+84681669,860289,537
+84681672,860826,537
+84681663,861363,537
+84681679,861900,537
+84681640,862437,537
+84681636,862974,537
+84681603,863511,537
+84681653,864048,537
+84681633,864585,537
+84681643,865122,538
+84681612,865660,537
+84681616,866197,537
+84681589,866734,537
+84681599,867271,537
+84681608,867808,537
+84681621,868345,537
+84681596,868882,537
+84681548,869419,537
+84681545,869956,537
+84681531,870493,537
+84681576,871030,537
+84681509,871567,537
+84681511,872104,538
+84681512,872642,537
+84681517,873179,537
+84681521,873716,537
+84681544,874253,537
+84681539,874790,555
+84681495,875345,537
+84681494,875882,538
+84681470,876420,541
+84681483,876961,537
+84681486,877498,537
+84681502,878035,537
+84681451,878572,537
+84681446,879109,537
+84681447,879646,537
+84681443,880183,538
+84681466,880721,537
+84681438,881258,537
+84681424,881795,537
+84681393,882332,216
+84681421,882548,537
+84681400,883085,537
+84681382,883622,537
+84681385,884159,539
+84681387,884698,537
+84681369,885235,537
+84681356,885772,537
+84681353,886309,537
+84681357,886846,537
+84681348,887383,537
+84681343,887920,537
+84681334,888457,537
+84681364,888994,540
+84681299,889534,539
+84681302,890073,537
+84681295,890610,537
+84681266,891147,537
+84681286,891684,537
+84681252,892221,541
+84681257,892762,537
+84681235,893299,537
+84681267,893836,537
+84681269,894373,537
+84681211,894910,537
+84681207,895447,539
+84681217,895986,537
+84681234,896523,537
+84681224,897060,537
+84681197,897597,539
+84681198,898136,544
+84681190,898680,537
+84681191,899217,537
+84681202,899754,537
+84681188,900291,537
+84681186,900828,537
+84681185,901365,537
+84681175,901902,537
+84681158,902439,537
+84681160,902976,537
+84681161,903513,537
+84681157,904050,537
+84681172,904587,537
+84681149,905124,537
+84681141,905661,537
+84681144,906198,537
+84681124,906735,539
+84681137,907274,537
+84681113,907811,537
+84681099,908348,537
+84681100,908885,537
+84681117,909422,537
+84681087,909959,537
+84681082,910496,537
+84681071,911033,537
+84680713,911570,537
+84681076,912107,537
+84681066,912644,537
+84680706,913181,537
+84681055,913718,537
+84681050,914255,537
+84681044,914792,537
+84680853,915329,537
+84681037,915866,542
+84681022,916408,537
+84681020,916945,537
+84681018,917482,537
+84681011,918019,537
+84681002,918556,537
+84681010,919093,537
+84680984,919630,537
+84680986,920167,537
+84680972,920704,537
+84680974,921241,537
+84680969,921778,537
+84680979,922315,537
+84680945,922852,537
+84680947,923389,537
+84680938,923926,537
+84680951,924463,537
+84680933,925000,537
+84680936,925537,537
+84680915,926074,537
+84680913,926611,537
+84680912,927148,537
+84680910,927685,537
+84680905,928222,537
+84680897,928759,537
+84680904,929296,537
+84680903,929833,537
+84680893,930370,537
+84680891,930907,537
+84680896,931444,537
+84680884,931981,537
+84680881,932518,537
+84680878,933055,537
+84680852,933592,537
+84680848,934129,537
+84680829,934666,537
+84680813,935203,537
+84680801,935740,537
+84680793,936277,537
+84680768,936814,537
+84680764,937351,537
+84680766,937888,537
+84680779,938425,537
+84680771,938962,537
+84680757,939499,537
+84680763,940036,537
+84680758,940573,537
+84680754,941110,537
+84680742,941647,537
+84680730,942184,537
+84680731,942721,537
+84680735,943258,537
+84680722,943795,537
+84680709,944332,537
+84681293,944869,537
+84683445,945406,537
+17406709836,945943,537
+84684759,946480,537
+84684730,947017,537
+84681181,947554,537
+84683604,948091,537
+84682596,948628,537
+17406710138,949165,537
+84682574,949702,538
+17406709838,950240,537
+17406709888,950777,537
+84682115,951314,538
+17406710079,951852,537
+84683310,952389,537
+84682519,952926,537
+84684777,953463,539
+84684041,954002,537
+84681176,954539,537
+84681501,955076,537
+84684775,955613,537
+84684324,956150,537
+84683392,956687,537
+84684753,957224,537
+84683186,957761,537
+84683360,958298,537
+17406709796,958835,537
+84684701,959372,537
+84681885,959909,537
+84682592,960446,537
+84681861,960983,538
+84681817,961521,537
+84681155,962058,537
+84682241,962595,537
+84681016,963132,537
+84683568,963669,537
+17406709907,964206,537
+84684595,964743,537
+84681244,965280,537
+17406710106,965817,538
+17406709871,966355,538
+84683239,966893,538
+17406710053,967431,537
+84682418,967968,537
+17406710008,968505,537
+84681064,969042,537
+17406709897,969579,537
+84683384,970116,537
+84682888,970653,537
+84680889,971190,537
+84684589,971727,537
+84682238,972264,538
+84682343,972802,537
+17406710091,973339,537
+84681326,973876,537
+84683257,974413,610
+84684164,975023,610
+84684257,975633,610
+84682210,976243,537
+84682952,976780,538
+17406709868,977318,550
+17406710154,977868,550
+17406710032,978418,550
+84683593,978968,550
+17406710018,979518,537
+84684501,980055,537
+84682978,980592,537
+84682491,981129,537
+84681164,981666,537
+84681243,982203,537
+84683177,982740,537
+84683350,983277,537
+84681036,983814,537
+84680880,984351,537
+84683069,984888,537
+84684695,985425,537
+84680866,985962,542
+84683638,986504,540
+84683215,987044,537
+84681453,987581,537
+84681922,988118,537
+84681460,988655,537
+84683962,989192,537
+84681324,989729,537
+84683751,990266,537
+84681148,990803,537
+84681744,991340,537
+84681985,991877,537
+17406710067,992414,537
+84681799,992951,537
+17406710033,993488,537
+84681440,994025,537
+84680928,994562,537
+17406709917,995099,537
+17406711053,995636,589
+17406710234,996225,537
+17406710230,996762,537
+17406710231,997299,537
+17406710233,997836,539
+17406710223,998375,537
+17406710222,998912,537
+17406710241,999449,539
+17406710238,999988,537
+17406710228,1000525,537
+17406710195,1001062,537
+17406710194,1001599,537
+17406710193,1002136,537
+17406710191,1002673,537
+17406710188,1003210,537
+17406710187,1003747,537
+17406710202,1004284,537
+17406710192,1004821,537
+17406710208,1005358,541
+17406710214,1005899,537
+17406710168,1006436,537
+17406710182,1006973,537
+17406710161,1007510,537
+17406710136,1008047,537
+17406710127,1008584,537
+17406710155,1009121,537
+17406710118,1009658,597
+17406710113,1010255,537
+17406710111,1010792,537
+17406710110,1011329,537
+17406710126,1011866,537
+17406710085,1012403,538
+17406710086,1012941,537
+17406710093,1013478,538
+17406710097,1014016,563
+17406710090,1014579,537
+17406710084,1015116,537
+17406710052,1015653,537
+17406710070,1016190,537
+17406710064,1016727,537
+17406710051,1017264,537
+17406710047,1017801,537
+17406710049,1018338,547
+17406710010,1018885,537
+17406710009,1019422,537
+17406710035,1019959,537
+17406710031,1020496,537
+17406710028,1021033,540
+17406710016,1021573,537
+17406710006,1022110,216
+17406709981,1022326,537
+17406709983,1022863,537
+17406709991,1023400,537
+17406709968,1023937,538
+17406709967,1024475,537
+17406709969,1025012,537
+17406709963,1025549,537
+17406709925,1026086,537
+17406709949,1026623,537
+17406709950,1027160,537
+17406709942,1027697,537
+17406709947,1028234,537
+17406709944,1028771,537
+17406709932,1029308,537
+17406709906,1029845,538
+17406709904,1030383,537
+17406709913,1030920,537
+17406709920,1031457,537
+17406709916,1031994,537
+17406709893,1032531,537
+17406709885,1033068,551
+17406709872,1033619,537
+17406709891,1034156,537
+17406709850,1034693,537
+17406709857,1035230,537
+17406709849,1035767,537
+17406709845,1036304,537
+17406709846,1036841,537
+17406709859,1037378,537
+17406709839,1037915,537
+17406709842,1038452,537
+17406709812,1038989,537
+17406709833,1039526,537
+17406709829,1040063,537
+17406709798,1040600,537
+17406709817,1041137,537
+17406709809,1041674,537
+17406709837,1042211,537
+17406709762,1042748,537
+17406709767,1043285,537
+17406709764,1043822,537
+17406709775,1044359,537
+17406709784,1044896,537
+17406709787,1045433,537
+17406709793,1045970,537
+17406709768,1046507,537
+17406709777,1047044,537
+84684787,1047581,537
+84684784,1048118,537
+84684783,1048655,537
+84684776,1049192,537
+84684774,1049729,537
+84684795,1050266,537
+84684754,1050803,537
+84684752,1051340,539
+84684713,1051879,537
+84684712,1052416,537
+84684725,1052953,537
+84684728,1053490,537
+84684692,1054027,537
+84684672,1054564,537
+84684704,1055101,537
+84684680,1055638,537
+84684646,1056175,537
+84684661,1056712,537
+84684652,1057249,537
+84684666,1057786,537
+84684628,1058323,537
+84684639,1058860,537
+84684621,1059397,537
+84684607,1059934,537
+84684615,1060471,537
+84684623,1061008,537
+84684592,1061545,537
+84684591,1062082,537
+84684584,1062619,537
+84684578,1063156,537
+84684561,1063693,537
+84684566,1064230,540
+84684542,1064770,537
+84684540,1065307,216
+84684572,1065523,537
+84684539,1066060,537
+84684515,1066597,537
+84684527,1067134,537
+84684529,1067671,537
+84684525,1068208,537
+84684509,1068745,537
+84684530,1069282,537
+84684513,1069819,537
+84684468,1070356,537
+84684484,1070893,537
+84684482,1071430,537
+84684488,1071967,537
+84684460,1072504,537
+84684437,1073041,566
+84684453,1073607,537
+84684415,1074144,537
+84684416,1074681,537
+84684426,1075218,537
+84684425,1075755,537
+84684422,1076292,537
+84684423,1076829,537
+84684408,1077366,537
+84684404,1077903,537
+84684417,1078440,537
+84684418,1078977,537
+84684362,1079514,537
+84684361,1080051,538
+84684383,1080589,537
+84684379,1081126,537
+84684386,1081663,538
+84684376,1082201,537
+84684377,1082738,537
+84684332,1083275,537
+84684343,1083812,537
+84684335,1084349,537
+84684339,1084886,537
+84684316,1085423,537
+84684310,1085960,537
+84684299,1086497,537
+84684290,1087034,537
+84684300,1087571,537
+84684305,1088108,537
+84684306,1088645,537
+84684296,1089182,537
+84684279,1089719,537
+84684287,1090256,537
+84684275,1090793,537
+84684261,1091330,537
+84684265,1091867,537
+84684250,1092404,537
+84684260,1092941,537
+84684227,1093478,537
+84684231,1094015,537
+84684255,1094552,537
+84684247,1095089,537
+84684241,1095626,537
+84684217,1096163,537
+84684220,1096700,537
+84684183,1097237,537
+84684165,1097774,537
+84684141,1098311,537
+84684138,1098848,545
+84684133,1099393,537
+84684129,1099930,537
+84684161,1100467,537
+84684112,1101004,537
+84684110,1101541,537
+84684106,1102078,537
+84684137,1102615,537
+84684087,1103152,537
+84684083,1103689,537
+84684086,1104226,537
+84684082,1104763,537
+84684080,1105300,537
+84684079,1105837,537
+84684069,1106374,537
+84684066,1106911,537
+84684078,1107448,549
+84684090,1107997,537
+84684096,1108534,537
+84684092,1109071,537
+84684056,1109608,538
+84684055,1110146,537
+84684051,1110683,537
+84684044,1111220,537
+84684045,1111757,537
+84684058,1112294,537
+84684039,1112831,537
+84684036,1113368,537
+84683986,1113905,537
+84683981,1114442,537
+84683983,1114979,537
+84683984,1115516,537
+84683992,1116053,537
+84683993,1116590,537
+84684011,1117127,537
+84684010,1117664,537
+84683991,1118201,537
+84684024,1118738,537
+84684001,1119275,537
+84683976,1119812,216
+84683973,1120028,537
+84683971,1120565,537
+84683963,1121102,537
+84683965,1121639,537
+84683961,1122176,537
+84683969,1122713,537
+84683979,1123250,537
+84683950,1123787,537
+84683942,1124324,537
+84683943,1124861,537
+84683926,1125398,537
+84683928,1125935,537
+84683939,1126472,537
+84683933,1127009,537
+84683922,1127546,537
+84683883,1128083,538
+84683886,1128621,537
+84683881,1129158,537
+84683874,1129695,537
+84683865,1130232,540
+84683862,1130772,537
+84683868,1131309,539
+84683910,1131848,537
+84683914,1132385,537
+84683896,1132922,537
+84683906,1133459,537
+84683863,1133996,537
+84683853,1134533,537
+84683845,1135070,537
+84683840,1135607,538
+84683843,1136145,537
+84683837,1136682,537
+84683818,1137219,537
+84683815,1137756,537
+84683824,1138293,537
+84683804,1138830,537
+84683799,1139367,538
+84683782,1139905,537
+84683775,1140442,537
+84683790,1140979,537
+84683796,1141516,537
+84683780,1142053,537
+84683808,1142590,537
+84683785,1143127,537
+84683768,1143664,537
+84683739,1144201,537
+84683749,1144738,537
+84683747,1145275,537
+84683763,1145812,537
+84683756,1146349,537
+84683734,1146886,537
+84683745,1147423,537
+84683731,1147960,537
+84683717,1148497,541
+84683713,1149038,537
+84683719,1149575,537
+84683704,1150112,537
+84683707,1150649,537
+84683684,1151186,537
+84683685,1151723,537
+84683696,1152260,537
+84683640,1152797,537
+84683636,1153334,538
+84683665,1153872,537
+84683645,1154409,537
+84683677,1154946,537
+84683679,1155483,537
+84683672,1156020,537
+84683673,1156557,537
+84683662,1157094,537
+84683648,1157631,537
+84683602,1158168,537
+84683600,1158705,537
+84683598,1159242,537
+84683610,1159779,537
+84683630,1160316,216
+84683624,1160532,537
+84683623,1161069,537
+84683619,1161606,537
+84683582,1162143,537
+84683580,1162680,537
+84683570,1163217,537
+84683587,1163754,537
+84683585,1164291,547
+84683586,1164838,537
+84683555,1165375,538
+84683577,1165913,537
+84683576,1166450,537
+84683548,1166987,538
+84683546,1167525,537
+84683539,1168062,558
+84683550,1168620,537
+84683532,1169157,551
+84683503,1169708,537
+84683512,1170245,537
+84683513,1170782,537
+84683528,1171319,537
+84683519,1171856,537
+84683526,1172393,537
+84683495,1172930,537
+84683496,1173467,537
+84683494,1174004,537
+84683471,1174541,537
+84683472,1175078,537
+84683476,1175615,537
+84683475,1176152,537
+84683458,1176689,537
+84683466,1177226,537
+84683465,1177763,561
+84683462,1178324,537
+84683455,1178861,537
+84683480,1179398,537
+84683487,1179935,537
+84683483,1180472,539
+84683421,1181011,537
+84683420,1181548,539
+84683427,1182087,537
+84683422,1182624,537
+84683439,1183161,537
+84683448,1183698,537
+84683447,1184235,537
+84683416,1184772,537
+84683386,1185309,537
+84683406,1185846,537
+84683382,1186383,537
+84683381,1186920,537
+84683397,1187457,537
+84683396,1187994,537
+84683335,1188531,537
+84683331,1189068,537
+84683334,1189605,537
+84683327,1190142,537
+84683325,1190679,538
+84683326,1191217,537
+84683349,1191754,537
+84683351,1192291,537
+84683346,1192828,537
+84683372,1193365,537
+84683365,1193902,537
+84683361,1194439,537
+84683341,1194976,537
+84683276,1195513,538
+84683308,1196051,537
+84683305,1196588,537
+84683304,1197125,537
+84683320,1197662,537
+84683319,1198199,537
+84683302,1198736,537
+84683298,1199273,573
+84683281,1199846,537
+84683290,1200383,537
+84683224,1200920,537
+84683222,1201457,537
+84683223,1201994,537
+84683254,1202531,537
+84683256,1203068,537
+84683269,1203605,537
+84683265,1204142,537
+84683259,1204679,540
+84683229,1205219,537
+84683235,1205756,537
+84683203,1206293,537
+84683199,1206830,537
+84683175,1207367,538
+84683204,1207905,537
+84683198,1208442,537
+84683180,1208979,537
+84683189,1209516,537
+84683217,1210053,537
+84683211,1210590,537
+84683207,1211127,539
+84683183,1211666,537
+84683162,1212203,537
+84683161,1212740,537
+84683138,1213277,537
+84683156,1213814,537
+84683153,1214351,537
+84683157,1214888,549
+84683129,1215437,537
+84683173,1215974,537
+84683096,1216511,537
+84683117,1217048,537
+84683108,1217585,537
+84683103,1218122,537
+84683100,1218659,537
+84683123,1219196,541
+84683071,1219737,537
+84683064,1220274,537
+84683065,1220811,537
+84683063,1221348,537
+84683086,1221885,537
+84683072,1222422,537
+84683090,1222959,537
+84683048,1223496,537
+84683045,1224033,538
+84683047,1224571,538
+84683042,1225109,539
+84683043,1225648,537
+84683041,1226185,537
+84683056,1226722,537
+84683035,1227259,537
+84683038,1227796,537
+84683052,1228333,537
+84683034,1228870,537
+84683030,1229407,537
+84683015,1229944,537
+84682999,1230481,537
+84683007,1231018,537
+84683005,1231555,546
+84683013,1232101,537
+84682991,1232638,539
+84682955,1233177,537
+84682954,1233714,537
+84682987,1234251,537
+84682973,1234788,538
+84682960,1235326,537
+84682971,1235863,537
+84682924,1236400,537
+84682921,1236937,552
+84682944,1237489,537
+84682946,1238026,537
+84682920,1238563,537
+84682922,1239100,538
+84682919,1239638,537
+84682933,1240175,537
+84682918,1240712,537
+84682911,1241249,537
+84682914,1241786,537
+84682928,1242323,537
+84682862,1242860,537
+84682861,1243397,537
+84682864,1243934,537
+84682892,1244471,537
+84682894,1245008,537
+84682883,1245545,545
+84682872,1246090,537
+84682901,1246627,537
+84682853,1247164,537
+84682840,1247701,537
+84682833,1248238,537
+84682849,1248775,537
+84682819,1249312,537
+84682815,1249849,538
+84682812,1250387,540
+84682808,1250927,537
+84682821,1251464,537
+84682825,1252001,537
+84682754,1252538,216
+84682767,1252754,537
+84682792,1253291,537
+84682770,1253828,537
+84682784,1254365,537
+84682747,1254902,537
+84682745,1255439,537
+84682726,1255976,537
+84682721,1256513,537
+84682730,1257050,537
+84682711,1257587,539
+84682698,1258126,537
+84682690,1258663,540
+84682674,1259203,537
+84682681,1259740,537
+84682683,1260277,537
+84682667,1260814,537
+84682647,1261351,539
+84682653,1261890,537
+84682654,1262427,537
+84682663,1262964,537
+84682635,1263501,537
+84682634,1264038,538
+84682656,1264576,537
+84682669,1265113,537
+84682597,1265650,538
+84682595,1266188,537
+84682630,1266725,537
+84682625,1267262,537
+84682624,1267799,537
+84682633,1268336,537
+84682611,1268873,537
+84682602,1269410,537
+84682598,1269947,537
+84682613,1270484,537
+84682583,1271021,537
+84682582,1271558,537
+84682581,1272095,537
+84682578,1272632,537
+84682587,1273169,537
+84682577,1273706,539
+84682566,1274245,537
+84682564,1274782,537
+84682563,1275319,540
+84682552,1275859,537
+84682542,1276396,537
+84682548,1276933,537
+84682532,1277470,537
+84682533,1278007,537
+84682560,1278544,572
+84682500,1279116,537
+84682498,1279653,539
+84682499,1280192,538
+84682496,1280730,537
+84682515,1281267,537
+84682511,1281804,537
+84682508,1282341,538
+84682503,1282879,537
+84682492,1283416,537
+84682521,1283953,540
+84682460,1284493,537
+84682474,1285030,537
+84682475,1285567,537
+84682469,1286104,537
+84682471,1286641,537
+84682467,1287178,537
+84682479,1287715,538
+84682480,1288253,537
+84682464,1288790,537
+84682484,1289327,537
+84682456,1289864,537
+84682457,1290401,537
+84682410,1290938,539
+84682452,1291477,537
+84682435,1292014,537
+84682429,1292551,538
+84682433,1293089,537
+84682420,1293626,538
+84682442,1294164,537
+84682436,1294701,537
+84682390,1295238,537
+84682396,1295775,537
+84682384,1296312,537
+84682383,1296849,537
+84682378,1297386,549
+84682403,1297935,537
+84682395,1298472,537
+84682367,1299009,538
+84682332,1299547,537
+84682336,1300084,537
+84682327,1300621,538
+84682340,1301159,537
+84682339,1301696,537
+84682361,1302233,537
+84682344,1302770,537
+84682347,1303307,542
+84682329,1303849,537
+84682302,1304386,537
+84682316,1304923,537
+84682309,1305460,537
+84682311,1305997,537
+84682292,1306534,537
+84682322,1307071,539
+84682261,1307610,537
+84682266,1308147,537
+84682278,1308684,538
+84682271,1309222,537
+84682235,1309759,537
+84682231,1310296,539
+84682227,1310835,537
+84682252,1311372,537
+84682207,1311909,537
+84682193,1312446,537
+84682217,1312983,537
+84682195,1313520,537
+84682218,1314057,537
+84682200,1314594,537
+84682176,1315131,537
+84682185,1315668,537
+84682168,1316205,537
+84682160,1316742,537
+84682157,1317279,537
+84682191,1317816,539
+84682175,1318355,537
+84682165,1318892,537
+84682149,1319429,551
+84682148,1319980,567
+84682144,1320547,537
+84682118,1321084,537
+84682152,1321621,537
+84682086,1322158,537
+84682102,1322695,537
+84682096,1323232,537
+84682097,1323769,537
+84682073,1324306,537
+84682071,1324843,537
+84682077,1325380,537
+84682074,1325917,537
+84682064,1326454,537
+84682038,1326991,537
+84682041,1327528,537
+84682039,1328065,538
+84682056,1328603,537
+84682035,1329140,537
+84682053,1329677,537
+84682048,1330214,537
+84682007,1330751,537
+84682015,1331288,537
+84682014,1331825,537
+84682010,1332362,537
+84682019,1332899,537
+84682032,1333436,537
+84682034,1333973,537
+84682020,1334510,537
+84681970,1335047,537
+84682004,1335584,537
+84681990,1336121,541
+84682003,1336662,537
+84682000,1337199,537
+84681974,1337736,537
+84681980,1338273,537
+84681952,1338810,537
+84681944,1339347,537
+84681953,1339884,537
+84681951,1340421,537
+84681898,1340958,539
+84681896,1341497,537
+84681928,1342034,537
+84681916,1342571,537
+84681872,1343108,537
+84681879,1343645,537
+84681877,1344182,537
+84681864,1344719,537
+84681863,1345256,537
+84681894,1345793,537
+84681878,1346330,537
+84681840,1346867,537
+84681837,1347404,537
+84681835,1347941,537
+84681856,1348478,539
+84681851,1349017,537
+84681822,1349554,537
+84681824,1350091,537
+84681825,1350628,537
+84681823,1351165,537
+84681785,1351702,537
+84681790,1352239,537
+84681803,1352776,537
+84681800,1353313,537
+84681798,1353850,537
+84681780,1354387,537
+84681770,1354924,537
+84681755,1355461,537
+84681753,1355998,537
+84681752,1356535,537
+84681746,1357072,537
+84681742,1357609,543
+84681737,1358152,537
+84681692,1358689,537
+84681680,1359226,537
+84681683,1359763,537
+84681721,1360300,537
+84681717,1360837,537
+84681707,1361374,537
+84681704,1361911,537
+84681667,1362448,537
+84681677,1362985,537
+84681673,1363522,537
+84681670,1364059,537
+84681651,1364596,537
+84681657,1365133,537
+84681609,1365670,537
+84681601,1366207,537
+84681606,1366744,537
+84681638,1367281,537
+84681566,1367818,537
+84681567,1368355,537
+84681563,1368892,537
+84681582,1369429,537
+84681571,1369966,537
+84681532,1370503,537
+84681540,1371040,537
+84681538,1371577,537
+84681541,1372114,537
+84681542,1372651,537
+84681553,1373188,537
+84681528,1373725,537
+84681523,1374262,537
+84681479,1374799,537
+84681481,1375336,537
+84681510,1375873,537
+84681487,1376410,539
+84681485,1376949,537
+84681488,1377486,537
+84681513,1378023,537
+84681505,1378560,537
+84681515,1379097,537
+84681464,1379634,537
+84681467,1380171,541
+84681476,1380712,537
+84681457,1381249,537
+84681428,1381786,551
+84681422,1382337,537
+84681427,1382874,537
+84681410,1383411,537
+84681406,1383948,537
+84681403,1384485,537
+84681402,1385022,537
+84681432,1385559,537
+84681383,1386096,537
+84681379,1386633,537
+84681390,1387170,537
+84681386,1387707,537
+84681373,1388244,537
+84681374,1388781,537
+84681375,1389318,537
+84681354,1389855,537
+84681352,1390392,537
+84681355,1390929,537
+84681368,1391466,537
+84681365,1392003,537
+84681363,1392540,537
+84681361,1393077,537
+84681339,1393614,538
+84681322,1394152,537
+84681323,1394689,537
+84681320,1395226,537
+84681342,1395763,537
+84681335,1396300,537
+84681315,1396837,537
+84681318,1397374,537
+84681284,1397911,537
+84681289,1398448,539
+84681308,1398987,537
+84681309,1399524,537
+84681298,1400061,537
+84681296,1400598,537
+84681288,1401135,538
+84681310,1401673,537
+84681307,1402210,537
+84681305,1402747,537
+84681303,1403284,537
+84681277,1403821,537
+84681263,1404358,537
+84681271,1404895,537
+84681268,1405432,537
+84681279,1405969,537
+84681274,1406506,537
+84681260,1407043,537
+84681241,1407580,537
+84681233,1408117,567
+84681227,1408684,537
+84681254,1409221,537
+84681251,1409758,539
+84681223,1410297,550
+84681219,1410847,537
+84681218,1411384,537
+84681193,1411921,537
+84681201,1412458,537
+84681221,1412995,537
+84681174,1413532,537
+84681183,1414069,537
+84681145,1414606,537
+84681143,1415143,537
+84681134,1415680,537
+84681136,1416217,537
+84681147,1416754,537
+84681163,1417291,537
+84681133,1417828,537
+84681116,1418365,537
+84681127,1418902,537
+84681130,1419439,537
+84681120,1419976,537
+84681125,1420513,537
+84681102,1421050,537
+84681105,1421587,537
+84681101,1422124,537
+84680727,1422661,537
+84680717,1423198,537
+84681069,1423735,537
+84680804,1424272,216
+84681070,1424488,537
+84680802,1425025,216
+84681047,1425241,537
+84681048,1425778,537
+84681045,1426315,537
+84681015,1426852,537
+84681032,1427389,537
+84680950,1427926,537
+84681038,1428463,537
+84681040,1429000,537
+84681014,1429537,537
+84680998,1430074,537
+84681000,1430611,537
+84680989,1431148,537
+84680993,1431685,537
+84680990,1432222,537
+84680996,1432759,537
+84680970,1433296,537
+84680977,1433833,537
+84680821,1434370,537
+84680978,1434907,537
+84680966,1435444,537
+84680962,1435981,537
+84680949,1436518,537
+84680939,1437055,537
+84680932,1437592,537
+84680927,1438129,537
+84680923,1438666,537
+84680917,1439203,537
+84680914,1439740,537
+84680921,1440277,537
+84680898,1440814,537
+84680860,1441351,537
+84680906,1441888,537
+84680908,1442425,537
+84680911,1442962,537
+84680877,1443499,537
+84680886,1444036,537
+84680894,1444573,537
+84680871,1445110,537
+84680858,1445647,543
+84680857,1446190,537
+84680863,1446727,537
+84680840,1447264,537
+84680834,1447801,537
+84680827,1448338,537
+84680811,1448875,537
+84680815,1449412,537
+84680816,1449949,537
+84680814,1450486,537
+84680799,1451023,537
+84680808,1451560,537
+84680809,1452097,537
+84680791,1452634,537
+84680789,1453171,537
+84680794,1453708,537
+84680790,1454245,537
+84680782,1454782,537
+84680765,1455319,537
+84680776,1455856,537
+84680762,1456393,537
+84680743,1456930,537
+84680744,1457467,537
+84680751,1458004,537
+84680733,1458541,537
+84680719,1459078,537
+84683390,1459615,537
+84683468,1460152,537
+17406709844,1460689,537
+84684196,1461226,538
+84684356,1461764,538
+84682746,1462302,538
+84684186,1462840,537
+84680741,1463377,537
+84682593,1463914,537
+17406710239,1464451,537
+84683531,1464988,537
+84684629,1465525,537
+84681706,1466062,537
+17406710015,1466599,537
+84684524,1467136,537
+84681810,1467673,538
+17406710117,1468211,537
+84681180,1468748,537
+84683046,1469285,537
+84680843,1469822,537
+84683564,1470359,537
+84683077,1470896,537
+17406709961,1471433,537
+84684643,1471970,537
+84682151,1472507,538
+17406709965,1473045,537
+84683829,1473582,537
+84680900,1474119,537
+84684742,1474656,537
+17406709828,1475193,537
+84681473,1475730,537
+84682104,1476267,537
+84681968,1476804,537
+84681407,1477341,537
+17406710205,1477878,537
+84684537,1478415,537
+84684021,1478952,537
+84682159,1479489,537
+84681189,1480026,538
+84684514,1480564,537
+84682555,1481101,537
+84683592,1481638,537
+84682490,1482175,537
+84681588,1482712,537
+84681194,1483249,537
+84681139,1483786,537
+84683515,1484323,537
+17406709943,1484860,537
+84683219,1485397,537
+84683244,1485934,550
+84683934,1486484,550
+84684243,1487034,550
+84682837,1487584,550
+84684330,1488134,550
+84684516,1488684,550
+17406710170,1489234,550
+17406709948,1489784,550
+17406709856,1490334,550
+84684552,1490884,550
+84680952,1491434,537
+84682740,1491971,537
+84684204,1492508,537
+84684582,1493045,537
+84683920,1493582,537
+84681399,1494119,538
+84682067,1494657,537
+84681676,1495194,537
+84682729,1495731,537
+84683410,1496268,537
+84684757,1496805,537
+84684002,1497342,537
+84684298,1497879,537
+84681624,1498416,537
+84680967,1498953,537
+17406709807,1499490,537
+84682023,1500027,537
+84682913,1500564,537
+84682664,1501101,537
+84681600,1501638,537
+84683270,1502175,538
+17406710001,1502713,537
+84681971,1503250,537
+84683760,1503787,537
+84684026,1504324,537
+84683300,1504861,537
+84684632,1505398,537
+84683248,1505935,537
+17406710235,1506472,537
+17406710229,1507009,537
+17406710199,1507546,537
+17406710200,1508083,537
+17406710219,1508620,537
+17406710204,1509157,586
+17406710196,1509743,537
+17406710178,1510280,537
+17406710180,1510817,537
+17406710179,1511354,537
+17406710139,1511891,538
+17406710130,1512429,537
+17406710160,1512966,538
+17406710158,1513504,537
+17406710164,1514041,537
+17406710163,1514578,537
+17406710148,1515115,537
+17406710150,1515652,537
+17406710125,1516189,537
+17406710123,1516726,537
+17406710137,1517263,537
+17406710133,1517800,538
+17406710114,1518338,537
+17406710100,1518875,537
+17406710107,1519412,537
+17406710108,1519949,537
+17406710094,1520486,537
+17406710088,1521023,537
+17406710098,1521560,537
+17406710069,1522097,537
+17406710056,1522634,537
+17406710057,1523171,537
+17406710060,1523708,537
+17406710081,1524245,537
+17406710080,1524782,537
+17406710020,1525319,537
+17406710034,1525856,537
+17406710050,1526393,537
+17406710019,1526930,537
+17406710041,1527467,537
+17406710024,1528004,537
+17406710043,1528541,537
+17406710038,1529078,537
+17406710025,1529615,537
+17406709986,1530152,540
+17406709985,1530692,537
+17406710005,1531229,537
+17406710003,1531766,537
+17406709990,1532303,537
+17406709987,1532840,537
+17406709988,1533377,539
+17406709995,1533916,538
+17406709993,1534454,537
+17406709999,1534991,537
+17406709977,1535528,537
+17406709927,1536065,537
+17406709951,1536602,537
+17406709952,1537139,537
+17406709939,1537676,537
+17406709937,1538213,548
+17406709959,1538761,537
+17406709940,1539298,537
+17406709946,1539835,537
+17406709921,1540372,537
+17406709918,1540909,537
+17406709919,1541446,537
+17406709899,1541983,537
+17406709910,1542520,537
+17406709923,1543057,537
+17406709900,1543594,537
+17406709881,1544131,538
+17406709889,1544669,537
+17406709894,1545206,537
+17406709877,1545743,537
+17406709866,1546280,537
+17406709887,1546817,537
+17406709855,1547354,537
+17406709858,1547891,537
+17406709863,1548428,537
+17406709862,1548965,537
+17406709795,1549502,555
+17406709794,1550057,537
+17406709805,1550594,537
+17406709803,1551131,537
+17406709827,1551668,537
+17406709814,1552205,537
+17406709804,1552742,537
+84684799,1553279,539
+17406709790,1553818,537
+17406709788,1554355,537
+17406709778,1554892,537
+17406709760,1555429,537
+17406709761,1555966,537
+17406709783,1556503,537
+84684797,1557040,537
+84684796,1557577,537
+84684782,1558114,537
+84684779,1558651,538
+84684773,1559189,537
+84684765,1559726,537
+84684748,1560263,537
+84684739,1560800,537
+84684710,1561337,537
+84684705,1561874,537
+84684716,1562411,537
+84684721,1562948,537
+84684689,1563485,537
+84684686,1564022,537
+84684682,1564559,537
+84684656,1565096,537
+84684658,1565633,537
+84684662,1566170,537
+84684650,1566707,537
+84684633,1567244,537
+84684631,1567781,537
+84684613,1568318,537
+84684620,1568855,537
+84684583,1569392,537
+84684575,1569929,537
+84684602,1570466,537
+84684603,1571003,537
+84684585,1571540,537
+84684571,1572077,537
+84684569,1572614,546
+84684548,1573160,537
+84684546,1573697,537
+84684562,1574234,537
+84684563,1574771,537
+84684556,1575308,537
+84684520,1575845,537
+84684518,1576382,537
+84684519,1576919,537
+84684522,1577456,537
+84684510,1577993,537
+84684531,1578530,538
+84684491,1579068,537
+84684487,1579605,537
+84684504,1580142,537
+84684496,1580679,537
+84684485,1581216,537
+84684446,1581753,537
+84684476,1582290,537
+84684475,1582827,537
+84684473,1583364,537
+84684451,1583901,537
+84684470,1584438,537
+84684421,1584975,537
+84684412,1585512,537
+84684411,1586049,537
+84684443,1586586,537
+84684436,1587123,537
+84684374,1587660,537
+84684396,1588197,537
+84684375,1588734,537
+84684405,1589271,539
+84684406,1589810,537
+84684351,1590347,537
+84684350,1590884,537
+84684367,1591421,537
+84684368,1591958,537
+84684369,1592495,537
+84684353,1593032,537
+84684355,1593569,537
+84684333,1594106,537
+84684331,1594643,537
+84684325,1595180,537
+84684315,1595717,537
+84684329,1596254,537
+84684295,1596791,537
+84684283,1597328,537
+84684281,1597865,537
+84684282,1598402,537
+84684263,1598939,537
+84684264,1599476,537
+84684273,1600013,537
+84684266,1600550,537
+84684245,1601087,537
+84684259,1601624,537
+84684218,1602161,537
+84684237,1602698,537
+84684225,1603235,551
+84684189,1603786,546
+84684213,1604332,537
+84684205,1604869,537
+84684193,1605406,537
+84684175,1605943,537
+84684170,1606480,537
+84684182,1607017,537
+84684166,1607554,537
+84684153,1608091,537
+84684135,1608628,537
+84684120,1609165,537
+84684075,1609702,537
+84684076,1610239,537
+84684072,1610776,565
+84684102,1611341,537
+84684098,1611878,538
+84684085,1612416,537
+84684081,1612953,537
+84684065,1613490,537
+84684062,1614027,537
+84684109,1614564,537
+84684033,1615101,537
+84684031,1615638,537
+84684030,1616175,537
+84684038,1616712,537
+84683982,1617249,537
+84683985,1617786,537
+84684003,1618323,537
+84683999,1618860,537
+84683990,1619397,537
+84683977,1619934,537
+84684016,1620471,537
+84683956,1621008,537
+84683966,1621545,537
+84683968,1622082,537
+84683958,1622619,537
+84683960,1623156,537
+84683944,1623693,537
+84683915,1624230,537
+84683916,1624767,537
+84683930,1625304,537
+84683925,1625841,537
+84683877,1626378,537
+84683878,1626915,537
+84683891,1627452,537
+84683902,1627989,537
+84683898,1628526,537
+84683872,1629063,537
+84683854,1629600,537
+84683857,1630137,537
+84683852,1630674,537
+84683850,1631211,537
+84683851,1631748,537
+84683831,1632285,537
+84683830,1632822,537
+84683859,1633359,537
+84683856,1633896,537
+84683842,1634433,537
+84683822,1634970,537
+84683821,1635507,565
+84683864,1636072,539
+84683817,1636611,537
+84683794,1637148,537
+84683789,1637685,537
+84683811,1638222,537
+84683807,1638759,537
+84683805,1639296,537
+84683765,1639833,537
+84683761,1640370,537
+84683753,1640907,537
+84683781,1641444,537
+84683776,1641981,537
+84683772,1642518,537
+84683771,1643055,537
+84683730,1643592,537
+84683736,1644129,538
+84683733,1644667,538
+84683725,1645205,537
+84683724,1645742,537
+84683706,1646279,537
+84683695,1646816,537
+84683692,1647353,537
+84683718,1647890,545
+84683722,1648435,537
+84683688,1648972,537
+84683686,1649509,537
+84683671,1650046,537
+84683670,1650583,537
+84683674,1651120,537
+84683639,1651657,537
+84683627,1652194,538
+84683644,1652732,537
+84683643,1653269,537
+84683616,1653806,537
+84683617,1654343,537
+84683608,1654880,537
+84683606,1655417,537
+84683611,1655954,537
+84683562,1656491,538
+84683569,1657029,537
+84683566,1657566,537
+84683594,1658103,537
+84683535,1658640,537
+84683541,1659177,537
+84683552,1659714,537
+84683527,1660251,537
+84683501,1660788,537
+84683525,1661325,537
+84683508,1661862,537
+84683470,1662399,537
+84683497,1662936,537
+84683459,1663473,537
+84683460,1664010,537
+84683469,1664547,537
+84683486,1665084,537
+84683429,1665621,537
+84683456,1666158,537
+84683454,1666695,537
+84683423,1667232,537
+84683436,1667769,537
+84683394,1668306,537
+84683413,1668843,554
+84683389,1669397,537
+84683385,1669934,537
+84683405,1670471,537
+84683407,1671008,537
+84683402,1671545,537
+84683358,1672082,537
+84683354,1672619,538
+84683355,1673157,538
+84683376,1673695,537
+84683374,1674232,537
+84683375,1674769,537
+84683373,1675306,537
+84683330,1675843,537
+84683378,1676380,537
+84683339,1676917,537
+84683337,1677454,537
+84683345,1677991,537
+84683367,1678528,537
+84683364,1679065,537
+84683322,1679602,537
+84683324,1680139,539
+84683271,1680678,537
+84683266,1681215,537
+84683282,1681752,537
+84683280,1682289,537
+84683312,1682826,537
+84683309,1683363,537
+84683303,1683900,537
+84683297,1684437,537
+84683292,1684974,537
+84683307,1685511,537
+84683314,1686048,537
+84683291,1686585,537
+84683288,1687122,537
+84683261,1687659,537
+84683213,1688196,537
+84683221,1688733,537
+84683225,1689270,537
+84683242,1689807,539
+84683227,1690346,539
+84683234,1690885,537
+84683230,1691422,538
+84683246,1691960,537
+84683169,1692497,537
+84683196,1693034,539
+84683195,1693573,537
+84683209,1694110,537
+84683205,1694647,538
+84683202,1695185,537
+84683201,1695722,537
+84683197,1696259,537
+84683190,1696796,540
+84683155,1697336,537
+84682080,1697873,537
+84683145,1698410,537
+84683142,1698947,537
+84682814,1699484,538
+84683128,1700022,537
+84683166,1700559,537
+84683168,1701096,537
+84683135,1701633,537
+84683143,1702170,541
+84683151,1702711,537
+84683150,1703248,537
+84683092,1703785,538
+84683115,1704323,537
+84683114,1704860,537
+84683106,1705397,537
+84683107,1705934,539
+84683102,1706473,537
+84683122,1707010,537
+84683097,1707547,537
+84683081,1708084,537
+84683080,1708621,537
+84683074,1709158,537
+84683068,1709695,537
+84683066,1710232,537
+84683089,1710769,537
+84683088,1711306,537
+84683084,1711843,537
+84683039,1712380,537
+84683024,1712917,537
+84683026,1713454,537
+84683032,1713991,537
+84683044,1714528,537
+84683002,1715065,537
+84682998,1715602,537
+84683009,1716139,537
+84682997,1716676,537
+84683016,1717213,537
+84682994,1717750,537
+84682980,1718287,537
+84682977,1718824,537
+84682958,1719361,538
+84682957,1719899,537
+84682976,1720436,544
+84682981,1720980,537
+84682949,1721517,537
+84682912,1722054,537
+84682908,1722591,539
+84682904,1723130,537
+84682930,1723667,537
+84682934,1724204,537
+84682887,1724741,537
+84682889,1725278,537
+84682885,1725815,537
+84682884,1726352,537
+84682870,1726889,537
+84682868,1727426,537
+84682903,1727963,537
+84682880,1728500,537
+84682878,1729037,537
+84682898,1729574,537
+84682850,1730111,537
+84682829,1730648,537
+84682846,1731185,537
+84682826,1731722,537
+84682788,1732259,537
+84682806,1732796,537
+84682805,1733333,537
+84682801,1733870,537
+84682817,1734407,537
+84682818,1734944,537
+84682796,1735481,537
+84682794,1736018,537
+84682809,1736555,540
+84682763,1737095,537
+84682758,1737632,537
+84682751,1738169,590
+84682777,1738759,537
+84682783,1739296,537
+84682757,1739833,537
+84682753,1740370,537
+84682749,1740907,537
+84682750,1741444,537
+84682741,1741981,537
+84682735,1742518,537
+84682736,1743055,537
+84682737,1743592,537
+84682742,1744129,537
+84682731,1744666,537
+84682733,1745203,537
+84682716,1745740,537
+84682712,1746277,538
+84682705,1746815,538
+84682706,1747353,537
+84682679,1747890,537
+84682677,1748427,537
+84682671,1748964,537
+84682699,1749501,537
+84682694,1750038,537
+84682632,1750575,537
+84682641,1751112,537
+84682614,1751649,537
+84682610,1752186,537
+84682629,1752723,537
+84682606,1753260,537
+84682600,1753797,538
+84682588,1754335,543
+84682575,1754878,537
+84682586,1755415,537
+84682568,1755952,537
+84682570,1756489,537
+84682584,1757026,537
+84682556,1757563,537
+84682536,1758100,537
+84682549,1758637,537
+84682561,1759174,547
+84682558,1759721,537
+84682559,1760258,537
+84682540,1760795,537
+84682541,1761332,537
+84682546,1761869,537
+84682545,1762406,537
+84682544,1762943,537
+84682529,1763480,537
+84682525,1764017,537
+84682504,1764554,537
+84682502,1765091,538
+84682513,1765629,537
+84682509,1766166,537
+84682524,1766703,537
+84682520,1767240,537
+84682494,1767777,537
+84682489,1768314,538
+84682487,1768852,548
+84682485,1769400,539
+84682495,1769939,537
+84682482,1770476,537
+84682472,1771013,537
+84682434,1771550,537
+84682426,1772087,537
+84682427,1772624,537
+84682425,1773161,537
+84682439,1773698,537
+84682448,1774235,537
+84682421,1774772,537
+84682437,1775309,537
+84682416,1775846,537
+84682413,1776383,540
+84682411,1776923,539
+84682381,1777462,537
+84682399,1777999,537
+84682365,1778536,537
+84682368,1779073,537
+84682348,1779610,537
+84682350,1780147,537
+84682359,1780684,537
+84682360,1781221,537
+84682362,1781758,537
+84682358,1782295,537
+84682341,1782832,537
+84682307,1783369,537
+84682310,1783906,537
+84682289,1784443,537
+84682330,1784980,540
+84682323,1785520,537
+84682324,1786057,537
+84682257,1786594,537
+84682256,1787131,537
+84682273,1787668,537
+84682280,1788205,537
+84682282,1788742,537
+84682255,1789279,557
+84682277,1789836,537
+84682270,1790373,537
+84682233,1790910,537
+84682208,1791447,538
+84682209,1791985,537
+84682220,1792522,537
+84682205,1793059,537
+84682214,1793596,538
+84682215,1794134,537
+84682187,1794671,537
+84682189,1795208,537
+84682190,1795745,537
+84682186,1796282,537
+84682184,1796819,537
+84682179,1797356,537
+84682174,1797893,537
+84682177,1798430,537
+84682164,1798967,537
+84682134,1799504,537
+84682133,1800041,537
+84682137,1800578,537
+84682153,1801115,537
+84682139,1801652,537
+84682140,1802189,537
+84682126,1802726,537
+84682121,1803263,537
+84682124,1803800,539
+84682091,1804339,537
+84682089,1804876,537
+84682105,1805413,537
+84682113,1805950,537
+84682057,1806487,537
+84682055,1807024,537
+84682058,1807561,537
+84682042,1808098,537
+84682033,1808635,537
+84682030,1809172,537
+84682028,1809709,537
+84681982,1810246,537
+84681967,1810783,537
+84681987,1811320,537
+84681935,1811857,539
+84681934,1812396,538
+84681942,1812934,540
+84681936,1813474,537
+84681937,1814011,537
+84681960,1814548,538
+84681945,1815086,537
+84681901,1815623,537
+84681911,1816160,537
+84681912,1816697,537
+84681913,1817234,537
+84681900,1817771,537
+84681899,1818308,537
+84681897,1818845,537
+84681929,1819382,537
+84681882,1819919,537
+84681890,1820456,537
+84681862,1820993,538
+84681881,1821531,537
+84681857,1822068,537
+84681843,1822605,537
+84681853,1823142,537
+84681830,1823679,537
+84681804,1824216,537
+84681831,1824753,537
+84681781,1825290,537
+84681773,1825827,537
+84681782,1826364,537
+84681757,1826901,537
+84681736,1827438,537
+84681768,1827975,537
+84681714,1828512,539
+84681710,1829051,537
+84681722,1829588,537
+84681718,1830125,537
+84681711,1830662,541
+84681726,1831203,537
+84681720,1831740,537
+84681689,1832277,537
+84681688,1832814,537
+84681660,1833351,537
+84681662,1833888,537
+84681666,1834425,537
+84681668,1834962,537
+84681674,1835499,537
+84681620,1836036,537
+84681615,1836573,537
+84681617,1837110,537
+84681635,1837647,537
+84681628,1838184,537
+84681645,1838721,537
+84681578,1839258,537
+84681575,1839795,537
+84681574,1840332,537
+84681597,1840869,537
+84681595,1841406,537
+84681572,1841943,537
+84681584,1842480,537
+84681585,1843017,537
+84681605,1843554,548
+84681581,1844102,537
+84681586,1844639,537
+84681535,1845176,537
+84681543,1845713,537
+84681556,1846250,537
+84681546,1846787,537
+84681550,1847324,569
+84681559,1847893,537
+84681498,1848430,537
+84681497,1848967,537
+84681496,1849504,537
+84681516,1850041,537
+84681506,1850578,537
+84681507,1851115,537
+84681493,1851652,537
+84681478,1852189,537
+84681480,1852726,537
+84681449,1853263,537
+84681477,1853800,537
+84681471,1854337,537
+84681489,1854874,537
+84681484,1855411,538
+84681468,1855949,537
+84681455,1856486,537
+84681417,1857023,537
+84681418,1857560,537
+84681423,1858097,539
+84681425,1858636,537
+84681426,1859173,537
+84681435,1859710,537
+84681439,1860247,537
+84681437,1860784,537
+84681441,1861321,537
+84681448,1861858,538
+84681409,1862396,568
+84681395,1862964,537
+84681420,1863501,537
+84681412,1864038,537
+84681380,1864575,537
+84681377,1865112,537
+84681366,1865649,537
+84681378,1866186,537
+84681325,1866723,537
+84681328,1867260,537
+84681350,1867797,537
+84681345,1868334,537
+84681347,1868871,537
+84681341,1869408,537
+84681329,1869945,537
+84681351,1870482,537
+84681333,1871019,537
+84681336,1871556,537
+84681313,1872093,537
+84681312,1872630,537
+84681314,1873167,549
+84681278,1873716,537
+84681265,1874253,537
+84681259,1874790,539
+84681290,1875329,537
+84681283,1875866,537
+84681276,1876403,537
+84681280,1876940,537
+84681231,1877477,537
+84681232,1878014,537
+84681236,1878551,537
+84681240,1879088,541
+84681248,1879629,537
+84681208,1880166,537
+84681209,1880703,537
+84681216,1881240,537
+84681215,1881777,537
+84681228,1882314,559
+84681170,1882873,537
+84681169,1883410,537
+84681182,1883947,537
+84681200,1884484,537
+84681177,1885021,537
+84681192,1885558,537
+84681156,1886095,537
+84681151,1886632,547
+84681142,1887179,537
+84681140,1887716,537
+84681119,1888253,537
+84681132,1888790,539
+84681138,1889329,537
+84681110,1889866,537
+84681114,1890403,537
+84681109,1890940,537
+84681107,1891477,537
+84681097,1892014,537
+84681103,1892551,537
+84681112,1893088,537
+84681077,1893625,537
+84681075,1894162,537
+84681092,1894699,537
+84681095,1895236,537
+84681062,1895773,537
+84681061,1896310,537
+84681063,1896847,537
+84681054,1897384,537
+84680707,1897921,537
+84681065,1898458,537
+84680803,1898995,537
+84681039,1899532,537
+84681035,1900069,537
+84681034,1900606,537
+84681024,1901143,537
+84681006,1901680,537
+84681001,1902217,537
+84680992,1902754,537
+84680975,1903291,537
+84680980,1903828,537
+84680958,1904365,537
+84680968,1904902,537
+84680971,1905439,537
+84680954,1905976,537
+84680964,1906513,537
+84680956,1907050,537
+84680940,1907587,537
+84680943,1908124,537
+84680931,1908661,537
+84680920,1909198,537
+84680919,1909735,537
+84680922,1910272,537
+84680925,1910809,537
+84680929,1911346,537
+84680892,1911883,537
+84680882,1912420,537
+84680883,1912957,537
+84680875,1913494,537
+84680874,1914031,537
+84680876,1914568,537
+84680872,1915105,537
+84680870,1915642,537
+84680847,1916179,537
+84680855,1916716,537
+84680849,1917253,537
+84680861,1917790,537
+84680831,1918327,537
+84680837,1918864,537
+84680823,1919401,537
+84680822,1919938,537
+84680820,1920475,537
+84680826,1921012,537
+84680818,1921549,537
+84680798,1922086,537
+84680797,1922623,537
+84680775,1923160,537
+84680796,1923697,537
+84680788,1924234,537
+84680785,1924771,537
+84680783,1925308,537
+84680795,1925845,537
+84680780,1926382,537
+84680761,1926919,537
+84680753,1927456,537
+84680749,1927993,537
+84680737,1928530,537
+84680736,1929067,537
+84684246,1929604,537
+84684457,1930141,537
+17406710232,1930678,537
+84681715,1931215,541
+84683955,1931756,538
+84684256,1932294,537
+17406709878,1932831,537
+84683247,1933368,537
+84682046,1933905,537
+84681220,1934442,537
+84684095,1934979,537
+17406709955,1935516,537
+84681732,1936053,537
+84684726,1936590,537
+84681627,1937127,537
+84681675,1937664,539
+84682166,1938203,537
+84684785,1938740,537
+17406709792,1939277,537
+84684349,1939814,539
+84683729,1940353,537
+84681807,1940890,537
+84682331,1941427,537
+84681626,1941964,537
+84682303,1942501,537
+84682626,1943038,538
+84681618,1943576,537
+84681514,1944113,538
+84681705,1944651,537
+84682622,1945188,537
+84682244,1945725,537
+84684644,1946262,537
+84681996,1946799,537
+84681813,1947336,537
+84681059,1947873,537
+84683017,1948410,537
+84684276,1948947,537
+84683676,1949484,537
+84684606,1950021,537
+84681456,1950558,537
+84683714,1951095,537
+84681096,1951632,538
+84684190,1952170,537
+84682405,1952707,538
+84682346,1953245,593
+84682659,1953838,610
+84683666,1954448,610
+84683996,1955058,610
+84684526,1955668,600
+84684685,1956268,556
+84684363,1956824,550
+84684626,1957374,550
+84684736,1957924,550
+84683003,1958474,537
+84682132,1959011,537
+84681094,1959548,537
+84684727,1960085,537
+17406710236,1960622,550
+17406710122,1961172,550
+17406710087,1961722,550
+84684655,1962272,550
+84684483,1962822,550
+84684049,1963372,550
+84682842,1963922,539
+84682117,1964461,537
+84682531,1964998,537
+84681975,1965535,537
+84683463,1966072,537
+84683485,1966609,537
+84683545,1967146,537
+84683371,1967683,537
+84682759,1968220,538
+84684057,1968758,555
+84682027,1969313,537
+84681619,1969850,537
+84681275,1970387,537
+84680725,1970924,537
+84681561,1971461,537
+84683834,1971998,537
+84684171,1972535,537
+84682619,1973072,537
+84682155,1973609,567
+84682272,1974176,539
+84684127,1974715,537
+84681802,1975252,537
+84684627,1975789,537
+84681943,1976326,537
+84680755,1976863,537
+84680745,1977400,537
+84683362,1977937,537
+84684573,1978474,537
+84683788,1979011,537
+84680806,1979548,216
+84681875,1979764,537
+84682813,1980301,537
+84684597,1980838,537
+84684348,1981375,537
+84682951,1981912,537
+17406710173,1982449,537
+84683975,1982986,542
+84681933,1983528,537
+17406710244,1984065,537
+17406710226,1984602,537
+17406710221,1985139,537
+17406710217,1985676,537
+17406710215,1986213,537
+17406710203,1986750,537
+17406710211,1987287,537
+17406710210,1987824,537
+17406710197,1988361,537
+17406710216,1988898,537
+17406710207,1989435,537
+17406710206,1989972,537
+17406710185,1990509,537
+17406710162,1991046,537
+17406710141,1991583,537
+17406710144,1992120,537
+17406710166,1992657,537
+17406710167,1993194,537
+17406710151,1993731,537
+17406710157,1994268,537
+17406710156,1994805,537
+17406710165,1995342,537
+17406710124,1995879,216
+17406710134,1996095,537
+17406710132,1996632,539
+17406710096,1997171,537
+17406710089,1997708,537
+17406710102,1998245,537
+17406710058,1998782,544
+17406710062,1999326,537
+17406710075,1999863,537
+17406710074,2000400,542
+17406710072,2000942,537
+17406710030,2001479,537
+17406710021,2002016,537
+17406710014,2002553,537
+17406710026,2003090,537
+17406710022,2003627,537
+17406710040,2004164,537
+17406710037,2004701,537
+17406710046,2005238,537
+17406710045,2005775,537
+17406710002,2006312,539
+17406709984,2006851,537
+17406710011,2007388,537
+17406710000,2007925,537
+17406709964,2008462,537
+17406709973,2008999,537
+17406709962,2009536,537
+17406709978,2010073,538
+17406709931,2010611,538
+17406709958,2011149,537
+17406709945,2011686,538
+17406709908,2012224,537
+17406709911,2012761,537
+17406709929,2013298,537
+17406709922,2013835,537
+17406709901,2014372,537
+17406709896,2014909,547
+17406709882,2015456,537
+17406709879,2015993,537
+17406709880,2016530,537
+17406709895,2017067,537
+17406709851,2017604,537
+17406709861,2018141,537
+17406709876,2018678,537
+17406709823,2019215,543
+17406709821,2019758,537
+17406709822,2020295,539
+17406709810,2020834,537
+17406709808,2021371,537
+17406709834,2021908,537
+17406709831,2022445,537
+17406709815,2022982,537
+17406709780,2023519,537
+17406709800,2024056,537
+17406709797,2024593,537
+17406709765,2025130,537
+84684789,2025667,620
+84684788,2026287,537
+17406709770,2026824,537
+84684791,2027361,537
+84684793,2027898,541
+84684786,2028439,537
+84684771,2028976,216
+84684770,2029192,537
+84684769,2029729,537
+84684766,2030266,537
+84684767,2030803,537
+84684763,2031340,537
+84684737,2031877,537
+84684744,2032414,537
+84684732,2032951,538
+84684731,2033489,537
+84684738,2034026,537
+84684746,2034563,537
+84684745,2035100,537
+84684749,2035637,537
+84684711,2036174,537
+84684697,2036711,537
+84684696,2037248,537
+84684698,2037785,537
+84684720,2038322,537
+84684700,2038859,537
+84684674,2039396,537
+84684675,2039933,537
+84684677,2040470,537
+84684668,2041007,537
+84684670,2041544,537
+84684673,2042081,537
+84684693,2042618,537
+84684649,2043155,537
+84684647,2043692,537
+84684640,2044229,537
+84684641,2044766,537
+84684663,2045303,537
+84684612,2045840,537
+84684610,2046377,537
+84684598,2046914,537
+84684618,2047451,537
+84684590,2047988,537
+84684586,2048525,537
+84684596,2049062,539
+84684600,2049601,537
+84684579,2050138,537
+84684576,2050675,537
+84684570,2051212,537
+84684574,2051749,537
+84684535,2052286,537
+84684543,2052823,537
+84684533,2053360,537
+84684538,2053897,537
+84684560,2054434,537
+84684557,2054971,537
+84684559,2055508,537
+84684554,2056045,537
+84684551,2056582,537
+84684512,2057119,538
+84684493,2057657,537
+84684490,2058194,537
+84684474,2058731,537
+84684494,2059268,537
+84684492,2059805,537
+84684477,2060342,537
+84684486,2060879,537
+84684471,2061416,541
+84684439,2061957,537
+84684434,2062494,537
+84684465,2063031,537
+84684454,2063568,537
+84684447,2064105,537
+84684419,2064642,546
+84684431,2065188,537
+84684407,2065725,537
+84684390,2066262,537
+84684389,2066799,539
+84684371,2067338,555
+84684382,2067893,537
+84684378,2068430,537
+84684341,2068967,537
+84684342,2069504,537
+84684338,2070041,537
+84684340,2070578,537
+84684360,2071115,537
+84684358,2071652,537
+84684352,2072189,538
+84684365,2072727,537
+84684323,2073264,537
+84684313,2073801,537
+84684317,2074338,537
+84684321,2074875,537
+84684320,2075412,537
+84684294,2075949,537
+84684302,2076486,537
+84684301,2077023,537
+84684308,2077560,537
+84684307,2078097,537
+84684297,2078634,537
+84684291,2079171,537
+84684284,2079708,537
+84684278,2080245,537
+84684272,2080782,537
+84684271,2081319,537
+84684268,2081856,537
+84684269,2082393,537
+84684267,2082930,537
+84684223,2083467,537
+84684239,2084004,538
+84684233,2084542,537
+84684235,2085079,537
+84684232,2085616,537
+84684236,2086153,537
+84684229,2086690,537
+84684226,2087227,537
+84684244,2087764,537
+84684251,2088301,538
+84684209,2088839,537
+84684210,2089376,537
+84684214,2089913,537
+84684215,2090450,537
+84684212,2090987,537
+84684194,2091524,537
+84684201,2092061,537
+84684200,2092598,537
+84684206,2093135,537
+84684152,2093672,538
+84684146,2094210,537
+84684160,2094747,537
+84684151,2095284,537
+84684169,2095821,537
+84684179,2096358,537
+84684172,2096895,537
+84684116,2097432,537
+84684113,2097969,537
+84684107,2098506,537
+84684104,2099043,537
+84684144,2099580,537
+84684125,2100117,537
+84684132,2100654,537
+84684122,2101191,537
+84684119,2101728,537
+84684143,2102265,539
+84684074,2102804,537
+84684073,2103341,538
+84684068,2103879,537
+84684067,2104416,537
+84684094,2104953,543
+84684061,2105496,537
+84684088,2106033,537
+84684053,2106570,539
+84684054,2107109,537
+84684040,2107646,537
+84684027,2108183,537
+84684019,2108720,537
+84684020,2109257,539
+84684014,2109796,537
+84684008,2110333,537
+84684013,2110870,537
+84684004,2111407,537
+84684018,2111944,538
+84684017,2112482,537
+84683997,2113019,537
+84684000,2113556,537
+84683980,2114093,537
+84683964,2114630,537
+84683974,2115167,537
+84683937,2115704,537
+84683946,2116241,537
+84683938,2116778,537
+84683940,2117315,537
+84683905,2117852,537
+84683903,2118389,537
+84683935,2118926,537
+84683932,2119463,537
+84683901,2120000,537
+84683895,2120537,537
+84683911,2121074,537
+84683912,2121611,538
+84683923,2122149,537
+84683929,2122686,537
+84683918,2123223,537
+84683846,2123760,538
+84683847,2124298,581
+84683844,2124879,551
+84683870,2125430,537
+84683880,2125967,537
+84683861,2126504,537
+84683888,2127041,537
+84683892,2127578,537
+84683819,2128115,537
+84683813,2128652,216
+84683812,2128868,537
+84683809,2129405,216
+84683806,2129621,537
+84683797,2130158,537
+84683792,2130695,537
+84683832,2131232,537
+84683828,2131769,537
+84683823,2132306,537
+84683836,2132843,537
+84683784,2133380,537
+84683783,2133917,537
+84683752,2134454,540
+84683773,2134994,537
+84683791,2135531,537
+84683778,2136068,537
+84683777,2136605,537
+84683757,2137142,537
+84683769,2137679,537
+84683723,2138216,538
+84683743,2138754,537
+84683737,2139291,537
+84683716,2139828,537
+84683715,2140365,538
+84683738,2140903,537
+84683694,2141440,537
+84683690,2141977,537
+84683683,2142514,537
+84683678,2143051,537
+84683701,2143588,537
+84683697,2144125,537
+84683700,2144662,537
+84683702,2145199,537
+84683669,2145736,537
+84683689,2146273,545
+84683667,2146818,537
+84683618,2147355,537
+84683633,2147892,565
+84683634,2148457,537
+84683631,2148994,537
+84683650,2149531,537
+84683651,2150068,537
+84683626,2150605,538
+84683625,2151143,537
+84683637,2151680,537
+84683641,2152217,537
+84683659,2152754,537
+84683654,2153291,537
+84683613,2153828,537
+84683597,2154365,537
+84683588,2154902,537
+84683578,2155439,537
+84683590,2155976,537
+84683615,2156513,537
+84683612,2157050,537
+84683595,2157587,537
+84683603,2158124,537
+84683542,2158661,537
+84683540,2159198,537
+84683579,2159735,537
+84683571,2160272,537
+84683573,2160809,537
+84683563,2161346,538
+84683561,2161884,537
+84683565,2162421,537
+84683543,2162958,537
+84683537,2163495,537
+84683534,2164032,537
+84683523,2164569,538
+84683521,2165107,537
+84683529,2165644,537
+84683518,2166181,537
+84683516,2166718,537
+84683484,2167255,537
+84683481,2167792,537
+84683510,2168329,537
+84683509,2168866,537
+84683511,2169403,537
+84683492,2169940,537
+84683479,2170477,537
+84683502,2171014,537
+84683500,2171551,537
+84683474,2172088,537
+84683441,2172625,537
+84683443,2173162,542
+84683452,2173704,537
+84683453,2174241,537
+84683440,2174778,537
+84683438,2175315,538
+84683446,2175853,537
+84683435,2176390,539
+84683433,2176929,537
+84683450,2177466,537
+84683457,2178003,537
+84683428,2178540,537
+84683419,2179077,537
+84683415,2179614,537
+84683395,2180151,537
+84683393,2180688,537
+84683380,2181225,537
+84683369,2181762,537
+84683363,2182299,537
+84683391,2182836,538
+84683377,2183374,537
+84683383,2183911,537
+84683356,2184448,537
+84683317,2184985,537
+84683318,2185522,548
+84683316,2186070,537
+84683328,2186607,537
+84683299,2187144,537
+84683236,2187681,537
+84683243,2188218,537
+84683240,2188755,537
+84683255,2189292,537
+84683251,2189829,537
+84683250,2190366,537
+84683277,2190903,537
+84683275,2191440,537
+84683263,2191977,537
+84683274,2192514,537
+84683267,2193051,537
+84683283,2193588,537
+84683228,2194125,537
+84683200,2194662,537
+84683226,2195199,537
+84683220,2195736,537
+84683218,2196273,537
+84683184,2196810,538
+84683194,2197348,537
+84683170,2197885,537
+84683165,2198422,537
+84683182,2198959,537
+84683152,2199496,537
+84683147,2200033,537
+84683148,2200570,538
+84683179,2201108,537
+84683105,2201645,537
+84683133,2202182,537
+84683130,2202719,537
+84683121,2203256,537
+84683119,2203793,537
+84683109,2204330,548
+84683104,2204878,537
+84683112,2205415,537
+84683126,2205952,537
+84683116,2206489,537
+84683095,2207026,539
+84683087,2207565,537
+84683085,2208102,537
+84683099,2208639,537
+84683075,2209176,550
+84683061,2209726,537
+84683040,2210263,537
+84683051,2210800,537
+84683020,2211337,537
+84683018,2211874,537
+84683019,2212411,538
+84683033,2212949,537
+84683031,2213486,537
+84682966,2214023,537
+84682984,2214560,537
+84682986,2215097,537
+84682975,2215634,537
+84682959,2216171,537
+84682938,2216708,537
+84682961,2217245,537
+84682942,2217782,537
+84682916,2218319,537
+84682917,2218856,537
+84682893,2219393,537
+84682891,2219930,537
+84682905,2220467,537
+84682899,2221004,537
+84682915,2221541,538
+84682876,2222079,537
+84682882,2222616,537
+84682836,2223153,538
+84682838,2223691,537
+84682858,2224228,537
+84682860,2224765,537
+84682857,2225302,537
+84682844,2225839,537
+84682843,2226376,537
+84682851,2226913,537
+84682847,2227450,537
+84682865,2227987,537
+84682867,2228524,537
+84682841,2229061,537
+84682799,2229598,537
+84682802,2230135,538
+84682804,2230673,538
+84682798,2231211,537
+84682831,2231748,537
+84682830,2232285,537
+84682822,2232822,537
+84682823,2233359,537
+84682810,2233896,537
+84682781,2234433,537
+84682776,2234970,537
+84682772,2235507,537
+84682773,2236044,537
+84682793,2236581,537
+84682791,2237118,537
+84682789,2237655,543
+84682768,2238198,537
+84682766,2238735,537
+84682795,2239272,537
+84682764,2239809,537
+84682761,2240346,537
+84682728,2240883,537
+84682727,2241420,537
+84682739,2241957,537
+84682738,2242494,538
+84682718,2243032,537
+84682713,2243569,537
+84682752,2244106,537
+84682732,2244643,537
+84682719,2245180,216
+84682714,2245396,537
+84682715,2245933,539
+84682703,2246472,537
+84682704,2247009,540
+84682700,2247549,539
+84682692,2248088,537
+84682691,2248625,537
+84682678,2249162,537
+84682146,2249699,537
+84682628,2250236,537
+84682687,2250773,537
+84682696,2251310,537
+84682673,2251847,537
+84682668,2252384,537
+84682657,2252921,537
+84682651,2253458,537
+84682652,2253995,537
+84682662,2254532,537
+84682644,2255069,537
+84682617,2255606,537
+84682616,2256143,537
+84682612,2256680,538
+84682603,2257218,537
+84682604,2257755,538
+84682627,2258293,537
+84682621,2258830,537
+84682573,2259367,537
+84682569,2259904,537
+84682571,2260441,537
+84682576,2260978,537
+84682580,2261515,537
+84682579,2262052,537
+84682565,2262589,537
+84682562,2263126,537
+84682538,2263663,538
+84682537,2264201,537
+84682551,2264738,537
+84682547,2265275,537
+84682522,2265812,537
+84682517,2266349,538
+84682505,2266887,537
+84682510,2267424,537
+84682523,2267961,537
+84682527,2268498,539
+84682478,2269037,537
+84682476,2269574,537
+84682470,2270111,537
+84682493,2270648,537
+84682447,2271185,537
+84682450,2271722,537
+84682453,2272259,537
+84682423,2272796,537
+84682445,2273333,537
+84682446,2273870,539
+84682430,2274409,537
+84682424,2274946,539
+84682414,2275485,537
+84682407,2276022,537
+84682392,2276559,537
+84682391,2277096,537
+84682388,2277633,537
+84682398,2278170,538
+84682372,2278708,538
+84682419,2279246,537
+84682386,2279783,537
+84682385,2280320,537
+84682412,2280857,537
+84682409,2281394,537
+84682354,2281931,538
+84682370,2282469,537
+84682356,2283006,537
+84682345,2283543,537
+84682298,2284080,537
+84682295,2284617,537
+84682296,2285154,537
+84682294,2285691,537
+84682334,2286228,537
+84682333,2286765,537
+84682328,2287302,537
+84682313,2287839,537
+84682312,2288376,537
+84682290,2288913,539
+84682291,2289452,537
+84682287,2289989,537
+84682304,2290526,537
+84682250,2291063,537
+84682249,2291600,537
+84682267,2292137,537
+84682264,2292674,537
+84682285,2293211,537
+84682260,2293748,537
+84682226,2294285,541
+84682221,2294826,537
+84682224,2295363,537
+84682216,2295900,537
+84682247,2296437,537
+84682242,2296974,538
+84682243,2297512,537
+84682223,2298049,537
+84682222,2298586,537
+84682204,2299123,537
+84682203,2299660,537
+84682197,2300197,537
+84682196,2300734,537
+84682192,2301271,537
+84682199,2301808,537
+84682206,2302345,537
+84682201,2302882,537
+84682182,2303419,537
+84682183,2303956,537
+84682147,2304493,538
+84682145,2305031,537
+84682163,2305568,548
+84682120,2306116,537
+84682107,2306653,537
+84682103,2307190,538
+84682106,2307728,537
+84682116,2308265,538
+84682141,2308803,537
+84682112,2309340,537
+84682098,2309877,537
+84682136,2310414,540
+84682135,2310954,537
+84682065,2311491,537
+84682061,2312028,537
+84682092,2312565,537
+84682093,2313102,537
+84682068,2313639,537
+84682076,2314176,543
+84682044,2314719,537
+84682043,2315256,537
+84682050,2315793,537
+84682052,2316330,537
+84682054,2316867,537
+84682031,2317404,563
+84682059,2317967,537
+84682060,2318504,537
+84682018,2319041,537
+84682016,2319578,537
+84682021,2320115,537
+84682005,2320652,537
+84682001,2321189,537
+84682002,2321726,537
+84682013,2322263,537
+84682008,2322800,538
+84681984,2323338,537
+84681965,2323875,537
+84681976,2324412,537
+84681977,2324949,537
+84681991,2325486,537
+84681930,2326023,537
+84681927,2326560,537
+84681946,2327097,537
+84681947,2327634,539
+84681957,2328173,537
+84681962,2328710,537
+84681938,2329247,537
+84681954,2329784,537
+84681886,2330321,538
+84681883,2330859,537
+84681908,2331396,537
+84681910,2331933,537
+84681907,2332470,537
+84681909,2333007,538
+84681906,2333545,537
+84681893,2334082,537
+84681895,2334619,537
+84681860,2335156,537
+84681858,2335693,537
+84681874,2336230,537
+84681849,2336767,537
+84681880,2337304,537
+84681834,2337841,537
+84681832,2338378,537
+84681833,2338915,537
+84681818,2339452,537
+84681844,2339989,537
+84681838,2340526,537
+84681841,2341063,537
+84681808,2341600,537
+84681795,2342137,537
+84681787,2342674,537
+84681809,2343211,537
+84681761,2343748,538
+84681762,2344286,543
+84681758,2344829,538
+84681756,2345367,537
+84681779,2345904,539
+84681783,2346443,537
+84681729,2346980,537
+84681750,2347517,537
+84681754,2348054,537
+84681733,2348591,537
+84681725,2349128,537
+84681703,2349665,537
+84681708,2350202,537
+84681719,2350739,537
+84681699,2351276,537
+84681697,2351813,537
+84681681,2352350,537
+84681684,2352887,537
+84681686,2353424,537
+84681659,2353961,537
+84681696,2354498,537
+84681655,2355035,537
+84681656,2355572,537
+84681650,2356109,537
+84681630,2356646,537
+84681629,2357183,537
+84681641,2357720,537
+84681642,2358257,537
+84681634,2358794,537
+84681639,2359331,537
+84681644,2359868,537
+84681623,2360405,537
+84681622,2360942,537
+84681625,2361479,537
+84681591,2362016,537
+84681590,2362553,537
+84681587,2363090,537
+84681610,2363627,537
+84681614,2364164,538
+84681611,2364702,537
+84681564,2365239,537
+84681569,2365776,537
+84681562,2366313,537
+84681558,2366850,537
+84681554,2367387,538
+84681552,2367925,537
+84681555,2368462,537
+84681547,2368999,537
+84681580,2369536,537
+84681526,2370073,537
+84681527,2370610,537
+84681519,2371147,537
+84681522,2371684,537
+84681536,2372221,537
+84681492,2372758,537
+84681491,2373295,537
+84681474,2373832,538
+84681475,2374370,537
+84681469,2374907,537
+84681503,2375444,537
+84681482,2375981,537
+84681499,2376518,537
+84681452,2377055,537
+84681459,2377592,537
+84681462,2378129,537
+84681433,2378666,216
+84681445,2378882,537
+84681413,2379419,537
+84681414,2379956,537
+84681430,2380493,537
+84681411,2381030,537
+84681404,2381567,537
+84681415,2382104,537
+84681416,2382641,537
+84681396,2383178,537
+84681397,2383715,537
+84681391,2384252,537
+84681389,2384789,537
+84681388,2385326,537
+84681392,2385863,545
+84681381,2386408,537
+84681376,2386945,537
+84680740,2387482,537
+84681370,2388019,537
+84681371,2388556,537
+84681372,2389093,537
+84681358,2389630,537
+84681367,2390167,537
+84681319,2390704,537
+84681338,2391241,537
+84681337,2391778,537
+84681327,2392315,537
+84681321,2392852,537
+84681330,2393389,537
+84681292,2393926,537
+84681285,2394463,537
+84681304,2395000,537
+84681282,2395537,537
+84681253,2396074,537
+84681262,2396611,537
+84681272,2397148,538
+84681270,2397686,537
+84681225,2398223,537
+84681222,2398760,537
+84681245,2399297,537
+84681247,2399834,537
+84681249,2400371,537
+84681187,2400908,537
+84681212,2401445,537
+84681213,2401982,537
+84681196,2402519,537
+84681179,2403056,537
+84681166,2403593,537
+84681162,2404130,537
+84681167,2404667,537
+84681184,2405204,537
+84681171,2405741,537
+84681126,2406278,537
+84681129,2406815,538
+84681150,2407353,537
+84681146,2407890,537
+84681131,2408427,537
+84681123,2408964,537
+84681122,2409501,537
+84681085,2410038,537
+84681079,2410575,537
+84681078,2411112,539
+84681090,2411651,537
+84681104,2412188,537
+84680715,2412725,537
+84680724,2413262,537
+84681067,2413799,537
+84680718,2414336,537
+84680716,2414873,537
+84681072,2415410,537
+84680772,2415947,216
+84680708,2416163,537
+84681068,2416700,543
+84681073,2417243,537
+84680726,2417780,537
+84680714,2418317,537
+84681046,2418854,537
+84681057,2419391,537
+84681056,2419928,537
+84681058,2420465,537
+84681060,2421002,537
+84681049,2421539,537
+84681041,2422076,537
+84681009,2422613,537
+84680999,2423150,537
+84680994,2423687,537
+84680995,2424224,537
+84680985,2424761,537
+84680960,2425298,537
+84680961,2425835,537
+84680959,2426372,537
+84680941,2426909,537
+84680955,2427446,537
+84680976,2427983,537
+84680946,2428520,537
+84680944,2429057,537
+84680942,2429594,537
+84680937,2430131,537
+84680926,2430668,537
+84680918,2431205,538
+84680916,2431743,537
+84680890,2432280,537
+84680899,2432817,537
+84680887,2433354,537
+84680879,2433891,537
+84680869,2434428,537
+84680873,2434965,537
+84680867,2435502,538
+84680851,2436040,537
+84680865,2436577,537
+84680859,2437114,537
+84680839,2437651,537
+84680838,2438188,537
+84680846,2438725,537
+84680841,2439262,537
+84680845,2439799,537
+84680844,2440336,537
+84680836,2440873,537
+84680830,2441410,537
+84680833,2441947,538
+84680825,2442485,537
+84680784,2443022,537
+84680792,2443559,537
+84680786,2444096,537
+84680760,2444633,537
+84680778,2445170,537
+84680773,2445707,537
+84680759,2446244,537
+84680746,2446781,537
+84680729,2447318,537
+84680734,2447855,537
+84680720,2448392,537
+84680721,2448929,537
+84680710,2449466,537
+84680711,2450003,537
+84682886,2450540,537
+17406709960,2451077,537
+84684616,2451614,537
+84681017,2452151,537
+84682211,2452688,535
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.txt
new file mode 100644
index 0000000000000000000000000000000000000000..02e7a9bd0f217c8d8dc64c472629348f549477fa
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/iab.txt
@@ -0,0 +1,27381 @@
+OUI                                                         Organization                                 
+IAB Range                                                   Organization                                 
+                                                            Address                                      
+
+00-50-C2                      (hex)                         DEUTA-WERKE GmbH                             
+7D5000-7D5FFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather Strasse 140                       
+                                                            Bergisch-Gladbach  NRW  51465                
+                                                            DE                                           
+
+40-D8-55                      (hex)                         DEUTA-WERKE GmbH                             
+11C000-11CFFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather Strasse 140                       
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+40-D8-55                      (hex)                         KRONOTECH SRL                                
+1A1000-1A1FFF                 (base 16)                     KRONOTECH SRL                                
+                                                            VIALE UNGHERIA 125 - UDINE                   
+                                                            CAMPOFORMIDO    33030                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elbit Systems of America                     
+CF9000-CF9FFF                 (base 16)                     Elbit Systems of America                     
+                                                            4700 Marine Creek Parkway                    
+                                                            Fort Worth   TX  76179                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Algodue Elettronica Srl                      
+F6B000-F6BFFF                 (base 16)                     Algodue Elettronica Srl                      
+                                                            Via Passerina 3/a                            
+                                                            Fontaneto d'Agogna    28010                  
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SP Controls, Inc                             
+1FA000-1FAFFF                 (base 16)                     SP Controls, Inc                             
+                                                            930 Linden Avenue                            
+                                                            San Francisco  CA  94080                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Open System Solutions Limited                
+811000-811FFF                 (base 16)                     Open System Solutions Limited                
+                                                            Saltmakers House                             
+                                                            Southampton  Hampshire  SO31 4NB             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         APG Cash Drawer, LLC                         
+010000-010FFF                 (base 16)                     APG Cash Drawer, LLC                         
+                                                            5250 INDUSTRIAL BLVD NE                      
+                                                            MINNEAPOLIS    55421                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Scharff Weisberg Systems Integration Inc     
+24E000-24EFFF                 (base 16)                     Scharff Weisberg Systems Integration Inc     
+                                                            36-36 33rd St.                               
+                                                            Long Island City  NY  11106                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Thor Technologies Pty Ltd                    
+F74000-F74FFF                 (base 16)                     Thor Technologies Pty Ltd                    
+                                                            PO Box 95                                    
+                                                            Karrinyup  Western Australia  6921           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+8F9000-8F9FFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Hwy 19 N                            
+                                                            Clearwater    33764-7290                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+616000-616FFF                 (base 16)                     Honeywell                                    
+                                                            13350 U.S. Hwy 19 North                      
+                                                            Clearwater  FL  33764-7290                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Oliotalo Oy                                  
+872000-872FFF                 (base 16)                     Oliotalo Oy                                  
+                                                            Sinikalliontie 18 B                          
+                                                            02630 Espoo    000                           
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Atlas Copco IAS GmbH                         
+B1F000-B1FFFF                 (base 16)                     Atlas Copco IAS GmbH                         
+                                                            Gewerbestraße 52                             
+                                                            Bretten-Gölshausen  Baden-Württemberg  75015 
+                                                            DE                                           
+
+40-D8-55                      (hex)                         MB connect line GmbH Fernwartungssysteme     
+0F4000-0F4FFF                 (base 16)                     MB connect line GmbH Fernwartungssysteme     
+                                                            Winnettener Straße 5                         
+                                                            Dinkelsbühl  Bavaria  91550                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Triax A/S                                    
+B25000-B25FFF                 (base 16)                     Triax A/S                                    
+                                                            Bjornkaervej 3                               
+                                                            Hornsyld  Denmark  8783                      
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Covidence A/S                                
+CD3000-CD3FFF                 (base 16)                     Covidence A/S                                
+                                                            Strandvejen 2A                               
+                                                            Roende    8410                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Critical Link LLC                            
+E67000-E67FFF                 (base 16)                     Critical Link LLC                            
+                                                            251 Salina Meadows Pkwy                      
+                                                            Syracuse    13212                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Critical Link LLC                            
+8F4000-8F4FFF                 (base 16)                     Critical Link LLC                            
+                                                            6712 Brooklawn Parkway                       
+                                                            Syracuse  NY  13211                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wireless Reading Systems Holding ASA         
+384000-384FFF                 (base 16)                     Wireless Reading Systems Holding ASA         
+                                                            Skredderveien 9                              
+                                                            Moss  Østfold  1537                          
+                                                            NO                                           
+
+00-50-C2                      (hex)                         PSD                                          
+AE3000-AE3FFF                 (base 16)                     PSD                                          
+                                                            Boerkensleen 31                              
+                                                            Roosendaal    4705 RL                        
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Advanced Concepts, Inc.                      
+192000-192FFF                 (base 16)                     Advanced Concepts, Inc.                      
+                                                            158 W. Johnstown Rd.                         
+                                                            Gahanna  Ohio  43230                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Albert Handtmann Maschinenfabrik GmbH&Co.KG  
+25F000-25FFFF                 (base 16)                     Albert Handtmann Maschinenfabrik GmbH&Co.KG  
+                                                            Hubertus Liebrecht Str. 10-12                
+                                                            Biberach  D-BW  88483                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MedAvant Healthcare                          
+6C6000-6C6FFF                 (base 16)                     MedAvant Healthcare                          
+                                                            2533 Centennial Blvd., Suite B               
+                                                            Jeffersonville  IN  47130                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         AutoTOOLS group Co. Ltd.                     
+230000-230FFF                 (base 16)                     AutoTOOLS group Co. Ltd.                     
+                                                            15F, No. 88, Chung Hsiao E. Rd., Sec. 2,     
+                                                            Taipei    100                                
+                                                            TW                                           
+
+40-D8-55                      (hex)                         Avant Technologies                           
+0D7000-0D7FFF                 (base 16)                     Avant Technologies                           
+                                                            Road 156 Caguas West Ind. Park               
+                                                            Caguas    00726                              
+                                                            PR                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+3BA000-3BAFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Strasse 39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+144000-144FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Strasse 39                       
+                                                            Mainz    D-55129                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Xentras Communications                       
+8F0000-8F0FFF                 (base 16)                     Xentras Communications                       
+                                                            1381 S Central Dr.                           
+                                                            Chandler  AZ  85248                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Narrowband Telecommunications                
+02C000-02CFFF                 (base 16)                     Narrowband Telecommunications                
+                                                            Unit 1A - 3751                               
+                                                            Burnaby  BC  V5J 5G4                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+AF0000-AF0FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel    CH4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DRS Photronics                               
+134000-134FFF                 (base 16)                     DRS Photronics                               
+                                                            133 Bauer Dr.                                
+                                                            Oakland  NJ  07436                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cominfo, Inc.                                
+194000-194FFF                 (base 16)                     Cominfo, Inc.                                
+                                                            Lesetin 651                                  
+                                                            Zlin    760 01                               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Applied Micro Electronics AME bv             
+E4C000-E4CFFF                 (base 16)                     Applied Micro Electronics AME bv             
+                                                            Esp 100                                      
+                                                            Eindhoven  Noord Brabant  5633 AA            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+E70000-E70FFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Vitoria  Alava  01510                        
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+C6C000-C6CFFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Miñano  Mayor  Alava  01510                  
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+796000-796FFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Vitoria-gasteiz  Alava  01510                
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DRS Imaging and Targeting Solutions          
+DDE000-DDEFFF                 (base 16)                     DRS Imaging and Targeting Solutions          
+                                                            100 N. Babcock St.                           
+                                                            Melbourne    32935                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SAET I.S. S.r.l.                             
+172000-172FFF                 (base 16)                     SAET I.S. S.r.l.                             
+                                                            Via Leini l/b                                
+                                                            San Maurizio  Canavese  10077 TO             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sierra Video Systems                         
+57D000-57DFFF                 (base 16)                     Sierra Video Systems                         
+                                                            104B New Mohawk Rd                           
+                                                            Nevada City  CA  95959                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         Telefrang AB                                 
+155000-155FFF                 (base 16)                     Telefrang AB                                 
+                                                            Victor Hasselblads gata 9                    
+                                                            Västra Frölunda  Västra Götaland  42131      
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Edgeware AB                                  
+E64000-E64FFF                 (base 16)                     Edgeware AB                                  
+                                                            Master Samuelsgatan 42                       
+                                                            Stockholm    11157                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Navicron Oy                                  
+A8B000-A8BFFF                 (base 16)                     Navicron Oy                                  
+                                                            Teknologiantie 7A                            
+                                                            Oulu    90570                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         EDA Industries Pte. Ltd                      
+3C0000-3C0FFF                 (base 16)                     EDA Industries Pte. Ltd                      
+                                                            Via dell'elettronica                         
+                                                            Cittaducale  Rieti  02015                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Owasys Advanced Wireless Devices             
+681000-681FFF                 (base 16)                     Owasys Advanced Wireless Devices             
+                                                            Parque Tecnologico, 207-B                    
+                                                            Zamudio  Vizcaya  E-48170                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         IAdea Corporation                            
+B37000-B37FFF                 (base 16)                     IAdea Corporation                            
+                                                            3F, NO.33, Lane 77, Xing-ai Road,            
+                                                            Taipei    114                                
+                                                            TW                                           
+
+40-D8-55                      (hex)                         DAVE SRL                                     
+098000-098FFF                 (base 16)                     DAVE SRL                                     
+                                                            Via Talponedo 29a                            
+                                                            Porcia  Pordenone  33080                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         DSP4YOU LTd                                  
+D43000-D43FFF                 (base 16)                     DSP4YOU LTd                                  
+                                                            Unit 1204, 106 How Ming Street               
+                                                            Hong Kong    0000                            
+                                                            HK                                           
+
+00-50-C2                      (hex)                         SecureTech Systems, Inc.                     
+F90000-F90FFF                 (base 16)                     SecureTech Systems, Inc.                     
+                                                            4108 Amon Carter Blvd, ste 206               
+                                                            Fort Worth  TX  76155                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Naturela Ltd.                                
+73A000-73AFFF                 (base 16)                     Naturela Ltd.                                
+                                                            Ana Feliksova 13                             
+                                                            Varna    9020                                
+                                                            BG                                           
+
+00-50-C2                      (hex)                         Partner Voxstream A/S                        
+178000-178FFF                 (base 16)                     Partner Voxstream A/S                        
+                                                            Trekanten 17                                 
+                                                            Vojens    D-6500                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         NOMUS COMM SYSTEMS                           
+5BD000-5BDFFF                 (base 16)                     NOMUS COMM SYSTEMS                           
+                                                            Plot 9A, Commercial Complex                  
+                                                            Hyderabad  AP  500073                        
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+E18000-E18FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         PYRAMID Computer GmbH                        
+20E000-20EFFF                 (base 16)                     PYRAMID Computer GmbH                        
+                                                            Boetzinger Strasse 60                        
+                                                            Freiburg  BW  79111                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+462000-462FFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st., 35.                 
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Alyrica Networks                             
+EAE000-EAEFFF                 (base 16)                     Alyrica Networks                             
+                                                            521B N 19th ST                               
+                                                            Philomath  OREGON  97370                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+92A000-92AFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+BFA000-BFAFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+D47000-D47FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+EAD000-EADFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Plastic Logic                                
+5A6000-5A6FFF                 (base 16)                     Plastic Logic                                
+                                                            34 Cambridge Science Park                    
+                                                            Cambridge  Cambridgeshire  CB4 0FX           
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Georg Neumann GmbH                           
+182000-182FFF                 (base 16)                     Georg Neumann GmbH                           
+                                                            Ollenhauerstrasse 98                         
+                                                            Berlin    13403                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+FAB000-FABFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Vacon Plc                                    
+3E5000-3E5FFF                 (base 16)                     Vacon Plc                                    
+                                                            P.O.Box 25                                   
+                                                            Vaasa    65381                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         United Telecoms Ltd                          
+33A000-33AFFF                 (base 16)                     United Telecoms Ltd                          
+                                                            18A/19  Doddanagundi Indl area               
+                                                            Banagalore  Karnataka  560048                
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Elfiq Inc.                                   
+552000-552FFF                 (base 16)                     Elfiq Inc.                                   
+                                                            1125 university                              
+                                                            Montreal  Quebec  H3B 3A7                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         HaiVision Systems Incorporated               
+C61000-C61FFF                 (base 16)                     HaiVision Systems Incorporated               
+                                                            4445 Garand                                  
+                                                            Montreal  QC  H4R 2H9                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         TORC Technologies                            
+A44000-A44FFF                 (base 16)                     TORC Technologies                            
+                                                            2200 Kraft Dr, Ste 1325                      
+                                                            Blacksburg  VA  24060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         LAN Controls, Inc.                           
+0B8000-0B8FFF                 (base 16)                     LAN Controls, Inc.                           
+                                                            10 Woodvue Road                              
+                                                            Windham  NH  03087                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vaisala Oyj                                  
+F87000-F87FFF                 (base 16)                     Vaisala Oyj                                  
+                                                            Vanha Nurmijarventie 21                      
+                                                            VANTAA    Fin-01670                          
+                                                            FI                                           
+
+00-50-C2                      (hex)                         SysNova                                      
+3E2000-3E2FFF                 (base 16)                     SysNova                                      
+                                                            Herweg 24                                    
+                                                            Maennedorf  Zurich  8708                     
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+956000-956FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Intuitive Surgical, Inc                      
+5C2000-5C2FFF                 (base 16)                     Intuitive Surgical, Inc                      
+                                                            950 Kifer Road                               
+                                                            Sunnyvale  CA  94040                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Intuitive Surgical, Inc                      
+FA5000-FA5FFF                 (base 16)                     Intuitive Surgical, Inc                      
+                                                            1250 Kifer Road, Building 103                
+                                                            Sunnyvale  CA  94086                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Haag-Streit AG                               
+12F000-12FFFF                 (base 16)                     Haag-Streit AG                               
+                                                            Gartenstadtstrasse 10                        
+                                                            Koeniz    CH-3098                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         AARTESYS AG                                  
+143000-143FFF                 (base 16)                     AARTESYS AG                                  
+                                                            Bahnhofplatz 7                               
+                                                            Biel    CH-2502                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ENGICAM s.r.l.                               
+A0E000-A0EFFF                 (base 16)                     ENGICAM s.r.l.                               
+                                                            Via dei pratoni, 16 int. 13                  
+                                                            Scandicci  Firenze  50018                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Ellips B.V.                                  
+53F000-53FFFF                 (base 16)                     Ellips B.V.                                  
+                                                            Urkhovenseweg 11                             
+                                                            Eindhoven  Noord-Brabant  5641 KA            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Efficient Channel Coding                     
+47A000-47AFFF                 (base 16)                     Efficient Channel Coding                     
+                                                            600 Safeguard Plaza                          
+                                                            Brooklyn Heights    44131                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         DELTA TAU DATA SYSTEMS, INC.                 
+7A9000-7A9FFF                 (base 16)                     DELTA TAU DATA SYSTEMS, INC.                 
+                                                            21314 Lassen St                              
+                                                            Chatsworth  CA  91311                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital Payment Technologies                 
+980000-980FFF                 (base 16)                     Digital Payment Technologies                 
+                                                            4105 Grandview Highway                       
+                                                            Burnaby  BC  V5C 6B4                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Arecont Vision                               
+3B6000-3B6FFF                 (base 16)                     Arecont Vision                               
+                                                            754 Brookside Lane                           
+                                                            Sierra Madre  CA  91024                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         AIM                                          
+080000-080FFF                 (base 16)                     AIM                                          
+                                                            21 Avenue de la plaine fleure                
+                                                            38240 Meylon    12345                        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+953000-953FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+40-D8-55                      (hex)                         EMAC, Inc.                                   
+183000-183FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62901                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital Receiver Technology                  
+360000-360FFF                 (base 16)                     Digital Receiver Technology                  
+                                                            20250 Century Blvd., #300                    
+                                                            Germantown  MD  20874                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+974000-974FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC WAY                                
+                                                            CARBONDALE  IL  62902                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         ELNEC s.r.o.                                 
+1E2000-1E2FFF                 (base 16)                     ELNEC s.r.o.                                 
+                                                            Jana Bottu 5                                 
+                                                            Presov  Presov  08001                        
+                                                            SK                                           
+
+40-D8-55                      (hex)                         QED Advanced Systems Limited                 
+1C4000-1C4FFF                 (base 16)                     QED Advanced Systems Limited                 
+                                                            8 Oakwood Business Park                      
+                                                            Weston-s-Mare  Somerset  BS249AY             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Magic Systems                                
+1B6000-1B6FFF                 (base 16)                     Magic Systems                                
+                                                            Mendeleevskaya 2                             
+                                                              Saint-Petersburg  194044                   
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Triamec Motion AG                            
+1C1000-1C1FFF                 (base 16)                     Triamec Motion AG                            
+                                                            Industriestr. 49                             
+                                                            Zug  Zug  6300                               
+                                                            CH                                           
+
+40-D8-55                      (hex)                         Webeasy BV                                   
+1D0000-1D0FFF                 (base 16)                     Webeasy BV                                   
+                                                            Sportlaan 53                                 
+                                                            Sliedrecht  ZH  3364DK                       
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Futaba Corporation                           
+1A0000-1A0FFF                 (base 16)                     Futaba Corporation                           
+                                                            1080 Yabutsuka,Chosei-mura,                  
+                                                            Chosei-gun  Chiba-ken  299-4395              
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Patria Aviation Oy                           
+19F000-19FFFF                 (base 16)                     Patria Aviation Oy                           
+                                                            Naulakatu 3                                  
+                                                            Tampere    33100                             
+                                                            FI                                           
+
+40-D8-55                      (hex)                         Autonomous Solutions, Inc                    
+1AE000-1AEFFF                 (base 16)                     Autonomous Solutions, Inc                    
+                                                            990 North 8000 West                          
+                                                            Petersboro  Utah  84325                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         Northern Star Technologies                   
+19B000-19BFFF                 (base 16)                     Northern Star Technologies                   
+                                                            5211 Harris Trace Court                      
+                                                            Mint Hill  NC  28227                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Parris Service Corporation                   
+19C000-19CFFF                 (base 16)                     Parris Service Corporation                   
+                                                            14841 N Hwy 41                               
+                                                            Rathdrum  ID  83858                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         PRESSOL Schmiergeraete GmbH                  
+199000-199FFF                 (base 16)                     PRESSOL Schmiergeraete GmbH                  
+                                                            Parkstrasse 7                                
+                                                            Falkenstein  Bavaria  93167                  
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Thirdwayv Inc.                               
+19E000-19EFFF                 (base 16)                     Thirdwayv Inc.                               
+                                                            8218 Torrey Gardens Place                    
+                                                            San Diego  CA  92129                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Broachlink Technology Co.,Limited            
+1AA000-1AAFFF                 (base 16)                     Broachlink Technology Co.,Limited            
+                                                            Room B402,Building No.28,Danhebei Road       
+                                                            Shenzhen  GuangDong  518100                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         ENTEC Electric & Electronic CO., LTD         
+1A7000-1A7FFF                 (base 16)                     ENTEC Electric & Electronic CO., LTD         
+                                                            78-2 Buncheon-ri                             
+                                                            Hwaseong-city  Gyungki-do  445-894           
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Multiobrabotka                               
+1A8000-1A8FFF                 (base 16)                     Multiobrabotka                               
+                                                            Lermontova,74                                
+                                                            Kamensk-Uralsky  Sverdlovsk region  623400   
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Beat Sensing co. , ltd.                      
+18F000-18FFFF                 (base 16)                     Beat Sensing co. , ltd.                      
+                                                            1072-1                                       
+                                                            Sunto-gun  Shizuoka  411-0917                
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Telvent                                      
+17F000-17FFFF                 (base 16)                     Telvent                                      
+                                                            P.I. Alcobendas C/ Valgrande, 6              
+                                                            Alcobendas  Madrid  28108                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         eROCCA                                       
+181000-181FFF                 (base 16)                     eROCCA                                       
+                                                            196A rue du Rocher de Lorzier                
+                                                            MOIRANS    38430                             
+                                                            FR                                           
+
+40-D8-55                      (hex)                         OPASCA Systems GmbH                          
+168000-168FFF                 (base 16)                     OPASCA Systems GmbH                          
+                                                            Julius-Hatry-Str. 1                          
+                                                            Mannheim    68163                            
+                                                            DE                                           
+
+40-D8-55                      (hex)                         PLATINUM GmbH                                
+159000-159FFF                 (base 16)                     PLATINUM GmbH                                
+                                                            Pfannerstrasse 75                            
+                                                            Wangen    88239                              
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Actronic Technologies                        
+15D000-15DFFF                 (base 16)                     Actronic Technologies                        
+                                                            45 Patiki Rd                                 
+                                                              Auckland  1026                             
+                                                            NZ                                           
+
+40-D8-55                      (hex)                         ICS Eletronics                               
+170000-170FFF                 (base 16)                     ICS Eletronics                               
+                                                            7034 Commerce Circle                         
+                                                            Pleasanton  CA  94588                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Tokyo Drawing Ltd.                           
+143000-143FFF                 (base 16)                     Tokyo Drawing Ltd.                           
+                                                            103 Ni Terai-machi                           
+                                                            Nomi-shi  Ishikawa  923-1121                 
+                                                            JP                                           
+
+40-D8-55                      (hex)                         TDS Software Solutions Pty Ltd               
+14F000-14FFFF                 (base 16)                     TDS Software Solutions Pty Ltd               
+                                                            5 The Crest                                  
+                                                            Chandlers Hill  South Australia  5160        
+                                                            AU                                           
+
+40-D8-55                      (hex)                         hanatech                                     
+13E000-13EFFF                 (base 16)                     hanatech                                     
+                                                            D-1412 gwangmyeong techno park               
+                                                            gwangmyeong-si  gyeonggi-do  423-795         
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Tetracore, Inc.                              
+142000-142FFF                 (base 16)                     Tetracore, Inc.                              
+                                                            9901 Belward Campus Drive                    
+                                                            Rockville  Maryland  20850                   
+                                                            US                                           
+
+40-D8-55                      (hex)                         shanghai Anjian Information technology co. , ltd.
+13C000-13CFFF                 (base 16)                     shanghai Anjian Information technology co. , ltd.
+                                                            Room 413，Block B ,                           
+                                                            shanghai  shanghai  200235                   
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Perm Scientific-Industrial Instrument Making Company JSC
+13D000-13DFFF                 (base 16)                     Perm Scientific-Industrial Instrument Making Company JSC
+                                                            25th of October Str, 106                     
+                                                            Perm  Privolgsky Federal District  614990    
+                                                            RU                                           
+
+40-D8-55                      (hex)                         LIGHTSTAR                                    
+127000-127FFF                 (base 16)                     LIGHTSTAR                                    
+                                                            18,CHASEONGDONGRO, 142BEONGIL                
+                                                            BUSAN    619-905                             
+                                                            KR                                           
+
+40-D8-55                      (hex)                         GDE Polska                                   
+137000-137FFF                 (base 16)                     GDE Polska                                   
+                                                            Swiatnicka 88 Str.                           
+                                                            Wlosan    32-031 Mogilany                    
+                                                            PL                                           
+
+40-D8-55                      (hex)                         Private                                      
+12F000-12FFFF                 (base 16)                     Private                                      
+
+40-D8-55                      (hex)                         WOW System                                   
+139000-139FFF                 (base 16)                     WOW System                                   
+                                                            #411, MEGA Center, SKn Techno Park, Sangdaewon 1-dong, Jungwon-gu
+                                                            Seongnam-si  Gyeonggi-do  462-721            
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Mango DSP, Inc.                              
+12B000-12BFFF                 (base 16)                     Mango DSP, Inc.                              
+                                                            83 East Ave.                                 
+                                                            Norwalk  CT  06877                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         MONOGRAM technologies ltd                    
+0FD000-0FDFFF                 (base 16)                     MONOGRAM technologies ltd                    
+                                                            Ilkovicova 6276                              
+                                                            Bratislava    84216                          
+                                                            SK                                           
+
+40-D8-55                      (hex)                         eumig industrie-tv GmbH                      
+0FC000-0FCFFF                 (base 16)                     eumig industrie-tv GmbH                      
+                                                            Gewerbeparkstr.9                             
+                                                            Salzburg  Anif  5081                         
+                                                            AT                                           
+
+40-D8-55                      (hex)                         Sicon srl                                    
+11A000-11AFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+40-D8-55                      (hex)                         RCS Energy Management Limited                
+117000-117FFF                 (base 16)                     RCS Energy Management Limited                
+                                                            RMS House                                    
+                                                            Newbury  Berkshire  RG14 5PX                 
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Smith Meter, Inc                             
+107000-107FFF                 (base 16)                     Smith Meter, Inc                             
+                                                            1602 Wagner Ave                              
+                                                            Erie  PA  16514                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         ObjectFab GmbH                               
+120000-120FFF                 (base 16)                     ObjectFab GmbH                               
+                                                            Pohlandstrasse 19                            
+                                                            Dresden    D-01309                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         IntelliDesign Pty Ltd                        
+0ED000-0EDFFF                 (base 16)                     IntelliDesign Pty Ltd                        
+                                                            99 Bluestone Circuit                         
+                                                            Seventeen Mile Rocks  Qld  4073              
+                                                            AU                                           
+
+40-D8-55                      (hex)                         A-Z-E                                        
+0EA000-0EAFFF                 (base 16)                     A-Z-E                                        
+                                                            Brendelweg 98                                
+                                                            Delmenhorst  Niedersachsen  27755            
+                                                            DE                                           
+
+40-D8-55                      (hex)                         HEITEC AG                                    
+0E8000-0E8FFF                 (base 16)                     HEITEC AG                                    
+                                                            Dr.-Otto-Leich-Str. 16                       
+                                                            Eckental  Bavaria  90542                     
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Siegmar Zander HuSWare                       
+0EE000-0EEFFF                 (base 16)                     Siegmar Zander HuSWare                       
+                                                            Wilmsstr.12                                  
+                                                            Berlin    10961                              
+                                                            DE                                           
+
+40-D8-55                      (hex)                         VPG                                          
+0DE000-0DEFFF                 (base 16)                     VPG                                          
+                                                            Box 423                                      
+                                                            Karlskoga    SE-691 27                       
+                                                            SE                                           
+
+40-D8-55                      (hex)                         deskontrol electronics                       
+0D6000-0D6FFF                 (base 16)                     deskontrol electronics                       
+                                                            Avinguda del port 158 - 9                    
+                                                            Valencia  Comunidad Valenciana  46023        
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Mitsubishi Heavy Industries, Ltd.            
+0D4000-0D4FFF                 (base 16)                     Mitsubishi Heavy Industries, Ltd.            
+                                                            3-1, ASAHI, NISHIBIWAJIMA-CHO                
+                                                            KIYOSU  AICHI  452-8561                      
+                                                            JP                                           
+
+40-D8-55                      (hex)                         ELAN SYSTEMS                                 
+0D2000-0D2FFF                 (base 16)                     ELAN SYSTEMS                                 
+                                                            10 IHASZ STR                                 
+                                                            BUDAPEST    1105                             
+                                                            HU                                           
+
+40-D8-55                      (hex)                         NVS Technologies Inc                         
+0DC000-0DCFFF                 (base 16)                     NVS Technologies Inc                         
+                                                            1505 Adams Dr Suite D                        
+                                                            Menlo Park  CA  94025                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Inspired Systems                             
+0C4000-0C4FFF                 (base 16)                     Inspired Systems                             
+                                                            70 Mordaunt Cct                              
+                                                            Canning Vale  WA  6155                       
+                                                            AU                                           
+
+40-D8-55                      (hex)                         Alumbra Produtos Elétricos e Eletrônicos Ltda
+0A6000-0A6FFF                 (base 16)                     Alumbra Produtos Elétricos e Eletrônicos Ltda
+                                                            Rua Guimarães Rosa, 450                      
+                                                            São Bernardo do Campo  São Paulo  09851-380  
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Baudisch Electronic GmbH                     
+0A8000-0A8FFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7-9                         
+                                                            Wäschenbeuren  Baden-Württemberg  73116      
+                                                            DE                                           
+
+40-D8-55                      (hex)                         DATA SHARING CONSULTING                      
+0B5000-0B5FFF                 (base 16)                     DATA SHARING CONSULTING                      
+                                                            815 AV IRENE ET FREDERIC JOLIOT CURIE        
+                                                            LA GARDE  PACA  83130                        
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Space Micro                                  
+0AD000-0ADFFF                 (base 16)                     Space Micro                                  
+                                                            10237 Flanders Court                         
+                                                            San Diego  California  92121                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         Micrologic                                   
+0B0000-0B0FFF                 (base 16)                     Micrologic                                   
+                                                            Via Brodolini, 6                             
+                                                            Crevoladossola  Verbania  28865              
+                                                            IT                                           
+
+40-D8-55                      (hex)                         EnVerv Inc.                                  
+0AF000-0AFFFF                 (base 16)                     EnVerv Inc.                                  
+                                                            680 N. McCarthy Blvd., Suite 220             
+                                                            MILPITAS  CA  95035                          
+                                                            US                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+0AE000-0AEFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Ever Trend Technology Development Limited    
+0B2000-0B2FFF                 (base 16)                     Ever Trend Technology Development Limited    
+                                                            Pokfulam 86D Floor 1 Room D                  
+                                                            Hong Kong  Hong Kong  000                    
+                                                            HK                                           
+
+40-D8-55                      (hex)                         Tokyo Denki Gijutsu Kogyo                    
+09B000-09BFFF                 (base 16)                     Tokyo Denki Gijutsu Kogyo                    
+                                                            2-12-2 Nakane Meguro-ku                      
+                                                            TOKYO    152-0031                            
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Heart Force Medical                          
+095000-095FFF                 (base 16)                     Heart Force Medical                          
+                                                            212 - 2112 West Broadway                     
+                                                            Vancouver  BC  V6K 2C8                       
+                                                            CA                                           
+
+40-D8-55                      (hex)                         KDT                                          
+091000-091FFF                 (base 16)                     KDT                                          
+                                                            203-902, bucheon Techno-park 192, Yakdae-dong, Wonmi-gu
+                                                            Bucheon-si  Gyeonggi-do  420-733             
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Lyngsoe Systems                              
+08E000-08EFFF                 (base 16)                     Lyngsoe Systems                              
+                                                            5570 Kennedy Rd                              
+                                                            Mississauga  On  L4Z 2A9                     
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Excelitas                                    
+08F000-08FFFF                 (base 16)                     Excelitas                                    
+                                                            1330 E Cypress St                            
+                                                            Covina  CA  91724                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Leder Elektronik Design                      
+08A000-08AFFF                 (base 16)                     Leder Elektronik Design                      
+                                                            Bruchweg 10                                  
+                                                            Ketsch  Baden-Wuerttemberg  68775            
+                                                            DE                                           
+
+40-D8-55                      (hex)                         C-COM Satellite Systems Inc.                 
+06E000-06EFFF                 (base 16)                     C-COM Satellite Systems Inc.                 
+                                                            2574 Sheffield Road                          
+                                                            Ottawa  ONTARIO  K1B3V7                      
+                                                            CA                                           
+
+40-D8-55                      (hex)                         BRS Sistemas Eletrônicos                     
+06B000-06BFFF                 (base 16)                     BRS Sistemas Eletrônicos                     
+                                                            Rua Gomes de Freitas, 491 / 204              
+                                                            Porto Alegre  RS  91380-000                  
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Smartcom-Bulgaria AD                         
+069000-069FFF                 (base 16)                     Smartcom-Bulgaria AD                         
+                                                            Office 414A, BIC IZOT Building 1             
+                                                              SOFIA  1784                                
+                                                            BG                                           
+
+40-D8-55                      (hex)                         BroadSoft, INC                               
+06D000-06DFFF                 (base 16)                     BroadSoft, INC                               
+                                                            550 S Winchester Blvd                        
+                                                            San Jose  CA  95128                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         CT Company                                   
+072000-072FFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st.,35                   
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Diamond Technologies, Inc                    
+073000-073FFF                 (base 16)                     Diamond Technologies, Inc                    
+                                                            6 Clock Tower Place, Suite 100               
+                                                            Maynard  MA  01754                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         ard sa                                       
+082000-082FFF                 (base 16)                     ard sa                                       
+                                                            Micropolis Bat Clematis                      
+                                                            Gap  France  05000                           
+                                                            FR                                           
+
+40-D8-55                      (hex)                         TESCOM CORPORATION                           
+07E000-07EFFF                 (base 16)                     TESCOM CORPORATION                           
+                                                            29-8 Teramachi                               
+                                                            Hachioji  Tokyo  192-0073                    
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Tammermatic Group Oy                         
+057000-057FFF                 (base 16)                     Tammermatic Group Oy                         
+                                                            Tesomanvaltatie 28                           
+                                                            Tampere    33300                             
+                                                            FI                                           
+
+40-D8-55                      (hex)                         Amantys Ltd                                  
+053000-053FFF                 (base 16)                     Amantys Ltd                                  
+                                                            Platinum Building, St John's Innovation Park 
+                                                            Cambridge  Cambridgeshire  CB4 0WS           
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Circuitlink Pty Ltd                          
+046000-046FFF                 (base 16)                     Circuitlink Pty Ltd                          
+                                                            4 / 87 Station Road                          
+                                                            Seven Hills  NSW  2147                       
+                                                            AU                                           
+
+40-D8-55                      (hex)                         inoage GmbH                                  
+05E000-05EFFF                 (base 16)                     inoage GmbH                                  
+                                                            Fetscherplatz 5                              
+                                                            Dresden  Sachsen  01307                      
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Mango Communicaitons Inc.                    
+042000-042FFF                 (base 16)                     Mango Communicaitons Inc.                    
+                                                            4606 Morningside Dr.                         
+                                                            Houston  TX  77005                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         Computer System Co.,Ltd                      
+03C000-03CFFF                 (base 16)                     Computer System Co.,Ltd                      
+                                                            Matsuyama-Daiichi-Seimei Bldg 8F             
+                                                            Matsuyama  EHIME  790-0001                   
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Ermes Elettronica s.r.l.                     
+033000-033FFF                 (base 16)                     Ermes Elettronica s.r.l.                     
+                                                            Via Treviso, 36                              
+                                                            San Vendemiano  TV  31020                    
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Depro Electronique                           
+029000-029FFF                 (base 16)                     Depro Electronique                           
+                                                            755 cure-boivin                              
+                                                            Boisbriand  Quebec  J7G 2J2                  
+                                                            US                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+048000-048FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Special Measurements Labs LLC                
+038000-038FFF                 (base 16)                     Special Measurements Labs LLC                
+                                                            ul. Nartova, 6                               
+                                                            Nizhny Novgorod    603104                    
+                                                            RU                                           
+
+40-D8-55                      (hex)                         GHL Systems Berhad                           
+040000-040FFF                 (base 16)                     GHL Systems Berhad                           
+                                                            L5-E-7B  Enterprise 4                        
+                                                            Bukit Jalil  Kuala Lumpur  57000             
+                                                            MY                                           
+
+40-D8-55                      (hex)                         AlphaNavigation coltd                        
+003000-003FFF                 (base 16)                     AlphaNavigation coltd                        
+                                                            3-1-22 hitahonmachi                          
+                                                            YAO  OSAKA  581-0802                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Grande Vitesse Systems                       
+013000-013FFF                 (base 16)                     Grande Vitesse Systems                       
+                                                            390 Fremont St.                              
+                                                            San Francisco  CA  94105                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         BITMILL srl                                  
+015000-015FFF                 (base 16)                     BITMILL srl                                  
+                                                            Corso Vercelli 125A                          
+                                                            IVREA    10015                               
+                                                            IT                                           
+
+40-D8-55                      (hex)                         HuNS                                         
+00D000-00DFFF                 (base 16)                     HuNS                                         
+                                                            Pyeongchon-dong, Dongan-gu, Anyang-si, Gyeonggi-do, Korea
+                                                            Anyang-si  Gyeonggi-do  431-755              
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Sitep Italia Spa                             
+01F000-01FFFF                 (base 16)                     Sitep Italia Spa                             
+                                                            Via Vincinella 14                            
+                                                            Santo Stefano Magra  La Spezia  19037        
+                                                            IT                                           
+
+40-D8-55                      (hex)                         MEGGITT DEFENSE SYSTEMS INC.                 
+01A000-01AFFF                 (base 16)                     MEGGITT DEFENSE SYSTEMS INC.                 
+                                                            9801 MUIRLANDS BLVD.                         
+                                                            IRVINE  CA  92618                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Brightwell Dispensers                        
+00E000-00EFFF                 (base 16)                     Brightwell Dispensers                        
+                                                            Brightwell Industrial Estate                 
+                                                            Newhaven  East Sussex  BN9 0JF               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Nupoint Systems Inc.                         
+FFA000-FFAFFF                 (base 16)                     Nupoint Systems Inc.                         
+                                                            4821 Colbrook Court                          
+                                                            Burnaby  BC  V5G 3Y3                         
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Bactest Limited                              
+006000-006FFF                 (base 16)                     Bactest Limited                              
+                                                            St John's Innovation Centre                  
+                                                            Cambridge  Cambridgeshire  CB4 0WS           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         RTT Mobile Interpretation                    
+FE4000-FE4FFF                 (base 16)                     RTT Mobile Interpretation                    
+                                                            1107 Hazeltine Blvd.                         
+                                                            Chaska  MN  55318                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Brunel GmbH Section Communications           
+FEA000-FEAFFF                 (base 16)                     Brunel GmbH Section Communications           
+                                                            Daimlerring 9                                
+                                                            Hildesheim  Niedersachsen  31135             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LOGISOL Kft.                                 
+FED000-FEDFFF                 (base 16)                     LOGISOL Kft.                                 
+                                                            Bocskai u. 21.                               
+                                                            Tinnye  Pest-megye  H-2086                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         First System Technology Co., Ltd.            
+FEC000-FECFFF                 (base 16)                     First System Technology Co., Ltd.            
+                                                            1F., No.8, Alley 6, Lane 19, Fuhe Rd         
+                                                            New Taipei City    23449                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ease Inc.                                    
+FD8000-FD8FFF                 (base 16)                     Ease Inc.                                    
+                                                            Feliceappear 1F                              
+                                                            Sano-shi  Tochigi  327-0004                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         ELAN SYSTEMS                                 
+FDA000-FDAFFF                 (base 16)                     ELAN SYSTEMS                                 
+                                                            10 IHASZ STR                                 
+                                                            BUDAPEST    1105                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Propagation Systems Limited                  
+FCB000-FCBFFF                 (base 16)                     Propagation Systems Limited                  
+                                                            Unit219A, 2/F, Enterprise Place, No.5 Science Park Science Park,
+                                                            Shatin                                       
+                                                            HK                                           
+
+00-50-C2                      (hex)                         MYLOGIC                                      
+FBF000-FBFFFF                 (base 16)                     MYLOGIC                                      
+                                                            #106 Deayoung golden vally,290-2             
+                                                            Uiwang-si  Gyeonggi-do  437-801              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         senTec Elektronik GmbH                       
+FBE000-FBEFFF                 (base 16)                     senTec Elektronik GmbH                       
+                                                            Werner-von-Siemens-Strasse 6                 
+                                                            Ilmenau    98693                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sakura Seiki Co.,Ltd.                        
+FC5000-FC5FFF                 (base 16)                     Sakura Seiki Co.,Ltd.                        
+                                                            75-5, Imojiya                                
+                                                            Chikuma-city  Nagano Prefecture  387-0015    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+FB3000-FB3FFF                 (base 16)                     CT Company                                   
+                                                            Godovikova 9, Moscow                         
+                                                            Moscow  RUSSIA  129085                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Preston Industries dba PolyScience           
+FB2000-FB2FFF                 (base 16)                     Preston Industries dba PolyScience           
+                                                            6600 W. Touhy Ave                            
+                                                            Niles  IL  60714-4588                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ATI Automação Telecomunicações e Informática Ltda
+FAE000-FAEFFF                 (base 16)                     ATI Automação Telecomunicações e Informática Ltda
+                                                            Rua Professor José Vieira de Mendonça, 770   
+                                                            Belo Horizonte  Minas Gerais  31130-20       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Vremya-CH JSC                                
+FAF000-FAFFFF                 (base 16)                     Vremya-CH JSC                                
+                                                            67, Osharskaya Str                           
+                                                            Nizhny Novgorod  Nizhny Novgorod region  603105
+                                                            RU                                           
+
+00-50-C2                      (hex)                         MC-monitoring SA                             
+FB4000-FB4FFF                 (base 16)                     MC-monitoring SA                             
+                                                            Route des Daillettes 6                       
+                                                            Fribourg  FR  1709                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Matsusada Precision Inc.                     
+F9E000-F9EFFF                 (base 16)                     Matsusada Precision Inc.                     
+                                                            745 Aoji                                     
+                                                            Kusatsu  Shiga  525-0041                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         YJSYSTEM                                     
+FAA000-FAAFFF                 (base 16)                     YJSYSTEM                                     
+                                                            #902, E&C Venture Tower                      
+                                                            GuroDong, GuroGu  Seoul  152-719             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Finishing Brands                             
+FAD000-FADFFF                 (base 16)                     Finishing Brands                             
+                                                            1910 North Wayne Street                      
+                                                            Angola  IN  46703                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Baudisch Electronic GmbH                     
+F93000-F93FFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7-9                         
+                                                            Wäschenbeuren  Baden-Württemberg  73116      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CSA Engineering AG                           
+F89000-F89FFF                 (base 16)                     CSA Engineering AG                           
+                                                            Hans Huber-Strasse 38                        
+                                                            Solothurn  SO  4500                          
+                                                            CH                                           
+
+00-50-C2                      (hex)                         CONET Solutions GmbH                         
+F92000-F92FFF                 (base 16)                     CONET Solutions GmbH                         
+                                                            Theodor-Heuss-Allee 19                       
+                                                            Hennef  NRW  53773                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         NEWELL TECHNOLOGIES LIMITED                  
+F9B000-F9BFFF                 (base 16)                     NEWELL TECHNOLOGIES LIMITED                  
+                                                            Unit 13, 4/F, New City Centre,               
+                                                            Kowloon                                      
+                                                            HK                                           
+
+00-50-C2                      (hex)                         RF Code, Inc                                 
+F71000-F71FFF                 (base 16)                     RF Code, Inc                                 
+                                                            9229 Waterford Centre                        
+                                                            Austin  TX  78758                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pro Design Electronic GmbH                   
+F6D000-F6DFFF                 (base 16)                     Pro Design Electronic GmbH                   
+                                                            Albert-Mayer-Straße 14-16                    
+                                                            Bruckmuehl  Bavaria  83052                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Smith Meter, Inc.                            
+F6E000-F6EFFF                 (base 16)                     Smith Meter, Inc.                            
+                                                            1602 Wagner Ave.                             
+                                                            Erie  PA  16514                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Moritex Corporation                          
+F50000-F50FFF                 (base 16)                     Moritex Corporation                          
+                                                            9-21-4                                       
+                                                            saitama city  saitama prefecture  3380837    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Y-cam Solutions Ltd                          
+F5E000-F5EFFF                 (base 16)                     Y-cam Solutions Ltd                          
+                                                            Vision House                                 
+                                                            Richmond  Surrey  TW9 2JN                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+F5C000-F5CFFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Supranet                                     
+F4B000-F4BFFF                 (base 16)                     Supranet                                     
+                                                            Majstorska 5                                 
+                                                            Zagreb    10000                              
+                                                            HR                                           
+
+00-50-C2                      (hex)                         Sentry 360 Security                          
+F5A000-F5AFFF                 (base 16)                     Sentry 360 Security                          
+                                                            1280 Iroquois Ave                            
+                                                            Naperville  IL  60563                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+F62000-F62FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Reason Tecnologia S.A.                       
+F46000-F46FFF                 (base 16)                     Reason Tecnologia S.A.                       
+                                                            Rua Delminda Silveira, 855                   
+                                                            Florianopolis  Santa Catarina  88025-500     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Monsoon Solutions, Inc.                      
+F56000-F56FFF                 (base 16)                     Monsoon Solutions, Inc.                      
+                                                            2405 140th Ave NE                            
+                                                            Bellevue  WA  98005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         InForce Computing, Inc.                      
+F39000-F39FFF                 (base 16)                     InForce Computing, Inc.                      
+                                                            48860 Milmont Drive, Suite 101C              
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Project service S.a.s                        
+F3D000-F3DFFF                 (base 16)                     Project service S.a.s                        
+                                                            Via Paderno 31/C                             
+                                                            Seriate  Bergamo  24100                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Vemco Sp. z o. o.                            
+F3C000-F3CFFF                 (base 16)                     Vemco Sp. z o. o.                            
+                                                            ul. Broniewskiego 3                          
+                                                            Sopot  pomorskie  81-837                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Rosslare Enterprises Limited                 
+F37000-F37FFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Ruetz Technologies GmbH                      
+F31000-F31FFF                 (base 16)                     Ruetz Technologies GmbH                      
+                                                            Walter Gropius Str. 17                       
+                                                            Munich  Bayern  80807                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         FairyDevices Inc.                            
+F41000-F41FFF                 (base 16)                     FairyDevices Inc.                            
+                                                            Entrepreneur Plaza Bldg  5F                  
+                                                            Bunkyou-ku  Tokyo  113-0033                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Bio Guard component & technologies           
+F2B000-F2BFFF                 (base 16)                     Bio Guard component & technologies           
+                                                            4 Ha'harash St.                              
+                                                            Hod Hasharon    45240                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Samway Electronic SRL                        
+F25000-F25FFF                 (base 16)                     Samway Electronic SRL                        
+                                                            Campia Libertatii 46, ap 33                  
+                                                            Bucuresti    030375                          
+                                                            RO                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+F24000-F24FFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st.,35                   
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Treehaven Technologies, Inc.                 
+F0B000-F0BFFF                 (base 16)                     Treehaven Technologies, Inc.                 
+                                                            3960 Presidential Pkwy Suite B               
+                                                            Powell  OH  43065-9033                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         ESI Ventures                                 
+F05000-F05FFF                 (base 16)                     ESI Ventures                                 
+                                                            902 Incentive Drive                          
+                                                            Fort Wayne  Indiana  46825                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+F17000-F17FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Development Zone.
+                                                            Xiamen  Fujian  361006                       
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Sascal Displays Ltd                          
+F15000-F15FFF                 (base 16)                     Sascal Displays Ltd                          
+                                                            16 The Metro Centre                          
+                                                            Hayes  London  UB4 0LE                       
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Vitec Multimedia                             
+F18000-F18FFF                 (base 16)                     Vitec Multimedia                             
+                                                            99 rue Pierre Sémard                         
+                                                            CHATILLON    92320                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Wheatstone Corporation                       
+F09000-F09FFF                 (base 16)                     Wheatstone Corporation                       
+                                                            600 Industrial Drive                         
+                                                            New Bern  NC  28562                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         HCL Technologies                             
+EF8000-EF8FFF                 (base 16)                     HCL Technologies                             
+                                                            A5, Sector 24                                
+                                                            Noida  Uttar Pradesh  201301                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         BELIK S.P.R.L.                               
+EDB000-EDBFFF                 (base 16)                     BELIK S.P.R.L.                               
+                                                            Rue du Roussart 147                          
+                                                            Waterloo  Brabant  1410                      
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Joint Stock Company Svyaz Inginiring M       
+EDA000-EDAFFF                 (base 16)                     Joint Stock Company Svyaz Inginiring M       
+                                                            42, Varshavskoye Shosse,                     
+                                                              Moscow region  115230                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Plasmatronics pty ltd                        
+ED9000-ED9FFF                 (base 16)                     Plasmatronics pty ltd                        
+                                                            75 Newman Street                             
+                                                            Thornbury  Victoria  3071                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Global Tecnologia LTDA.                      
+EBE000-EBEFFF                 (base 16)                     Global Tecnologia LTDA.                      
+                                                            Av. das Araucárias, n.2558                   
+                                                            Araucária  PR  81530-020                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Arcontia Technology AB                       
+ED1000-ED1FFF                 (base 16)                     Arcontia Technology AB                       
+                                                            Gruvgatan 35A                                
+                                                            Vastra Frolunda    42130                     
+                                                            SE                                           
+
+00-50-C2                      (hex)                         dspnor                                       
+EB8000-EB8FFF                 (base 16)                     dspnor                                       
+                                                            Vaagsgaten 22                                
+                                                            Bergen  Hordaland  5162                      
+                                                            NO                                           
+
+00-50-C2                      (hex)                         TAIWAN HIPLUS CORPORATION                    
+ECF000-ECFFFF                 (base 16)                     TAIWAN HIPLUS CORPORATION                    
+                                                            13F-9 NO.2 CHENG PA RD. ZHONGHE DIST.,       
+                                                            NEW TAIPEI     23511                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Otaki Electric Corporation                   
+EB2000-EB2FFF                 (base 16)                     Otaki Electric Corporation                   
+                                                            6-6,Aza-Kamibukuro,Syakanai                  
+                                                            Ohdate  Akita  017-0012                      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         AR RF/Microwave Instrumentation              
+EB3000-EB3FFF                 (base 16)                     AR RF/Microwave Instrumentation              
+                                                            160 School House Road                        
+                                                            Souderton  PA  18964                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         head                                         
+EA4000-EA4FFF                 (base 16)                     head                                         
+                                                            kita-ku tenjinbashi 2-2-25                   
+                                                            Osaka-shi  Osaka  5300041                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         TEX COMPUTER SRL                             
+EA1000-EA1FFF                 (base 16)                     TEX COMPUTER SRL                             
+                                                            VIA MERCADANTE 35                            
+                                                            CATTOLICA   RIMINI   47841                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+EA7000-EA7FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         SPARQ systems                                
+E9C000-E9CFFF                 (base 16)                     SPARQ systems                                
+                                                            166 barrie st                                
+                                                            kingston  ontario  k7l3n6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         MCS MICRONIC Computer Systeme GmbH           
+E79000-E79FFF                 (base 16)                     MCS MICRONIC Computer Systeme GmbH           
+                                                            Ullsteinstrasse 114, Tower C                 
+                                                            Berlin    12109                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SystemAdvanced Co,Ltd                        
+E8D000-E8DFFF                 (base 16)                     SystemAdvanced Co,Ltd                        
+                                                            Adachi 1-9-3                                 
+                                                            Adachi-Ku  Tokyo  1200015                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Epec Oy                                      
+E8C000-E8CFFF                 (base 16)                     Epec Oy                                      
+                                                            P.O. Box 194                                 
+                                                            Seinäjoki    60101                           
+                                                            FI                                           
+
+00-50-C2                      (hex)                         RPA Electronic Solutions, Inc.               
+E8B000-E8BFFF                 (base 16)                     RPA Electronic Solutions, Inc.               
+                                                            1285 Chenango St.                            
+                                                            Binghamton  New York  13901                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         AEL Microsystems Limited                     
+E7D000-E7DFFF                 (base 16)                     AEL Microsystems Limited                     
+                                                            12 Pixiefield                                
+                                                            Malvern  Worcestershire  WR13 5ND            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Swareflex GmbH                               
+E7E000-E7EFFF                 (base 16)                     Swareflex GmbH                               
+                                                            Josef-Heiss-Straße 1                         
+                                                            Vomp  Tyrol  6134                            
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Allerta Inc                                  
+E6D000-E6DFFF                 (base 16)                     Allerta Inc                                  
+                                                            314 Batavia Pl                               
+                                                            Waterloo  ON  N2L3W2                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Power-One Italia S.p.A                       
+E6E000-E6EFFF                 (base 16)                     Power-One Italia S.p.A                       
+                                                            Via San Giorgio 642                          
+                                                            Terranuova Bracciolini  Arezzo  52028        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sika Technology AG                           
+E6B000-E6BFFF                 (base 16)                     Sika Technology AG                           
+                                                            Tüffenwies 16                                
+                                                            Zürich  ZH  8048                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Netmaker                                     
+E69000-E69FFF                 (base 16)                     Netmaker                                     
+                                                            Mega Valley SB111,Gwanyang2,Dongan           
+                                                            Anyang  Gyeonggi  431-767                    
+                                                            KR                                           
+
+00-50-C2                      (hex)                         TTi Ltd                                      
+E55000-E55FFF                 (base 16)                     TTi Ltd                                      
+                                                            Glebe Road                                   
+                                                            Huntingdon  Cambridgeshire  PE29 7DR         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Arcos Technologies LTD                       
+E54000-E54FFF                 (base 16)                     Arcos Technologies LTD                       
+                                                            26 Hasivim  St.                              
+                                                            Petach-Tikva  Israel  49517                  
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Prima sistemi                                
+E63000-E63FFF                 (base 16)                     Prima sistemi                                
+                                                            Å orlijeva 7                                 
+                                                            Kranj  Gorenjska  4000                       
+                                                            SI                                           
+
+00-50-C2                      (hex)                         MCOPIA Co., Ltd                              
+E5C000-E5CFFF                 (base 16)                     MCOPIA Co., Ltd                              
+                                                            4th Floor, Jinhyun  Building, Neong-dong, 246-2, Kwangjin-Gu
+                                                            SEOUL    143-849                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ACS Motion Control Ltd.                      
+E73000-E73FFF                 (base 16)                     ACS Motion Control Ltd.                      
+                                                            Ramat Gabriel Industrial Park                
+                                                            Migdal Ha'Emek    10500                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         TAIYO SEIKI CO.,LTD.                         
+E60000-E60FFF                 (base 16)                     TAIYO SEIKI CO.,LTD.                         
+                                                            1600 Aza-Shironoshita Asahi                  
+                                                            Shin Asahi-cho  Takashima, Shiga  520-1501   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Institute For Information Industry           
+E4E000-E4EFFF                 (base 16)                     Institute For Information Industry           
+                                                            7F., No.133, Sec. 4, Minsheng E. Rd.         
+                                                            Taipei City                                  
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Famas System S.p.A.                          
+E52000-E52FFF                 (base 16)                     Famas System S.p.A.                          
+                                                            Via degli artigiani sud, 19                  
+                                                            Egna  BZ  39044                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Nanosolution Inc.                            
+E3B000-E3BFFF                 (base 16)                     Nanosolution Inc.                            
+                                                            Room 110, Woolim Lions Valley                
+                                                            Seongnam-si  Gyeonggi-do  462-806            
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Telemetrics Inc.                             
+E39000-E39FFF                 (base 16)                     Telemetrics Inc.                             
+                                                            6 LEIGHTON PL                                
+                                                            MAHWAH  NJ  074303198                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Aesir Copenhagen                             
+E38000-E38FFF                 (base 16)                     Aesir Copenhagen                             
+                                                            Elektroniikkatie 10                          
+                                                            Oulu    90590                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Stichting Sunrise                            
+E45000-E45FFF                 (base 16)                     Stichting Sunrise                            
+                                                            Daltonstraat 51                              
+                                                            DEN Haag  Zuid Holland  2561 SR              
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Teplovodokhran                               
+E28000-E28FFF                 (base 16)                     Teplovodokhran                               
+                                                            Novaya, 51v                                  
+                                                            Ryazan    390027                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         CONTROL SYSTEMS Srl                          
+E27000-E27FFF                 (base 16)                     CONTROL SYSTEMS Srl                          
+                                                            Via del Brolo, 14                            
+                                                            Cremona  CR  26100                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Goennheimer Elektronic GmbH                  
+E30000-E30FFF                 (base 16)                     Goennheimer Elektronic GmbH                  
+                                                            Dr. Julius leber Str. 2                      
+                                                            Neustadt    67433                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Michael Riedel Transformatorenbau GmbH       
+E22000-E22FFF                 (base 16)                     Michael Riedel Transformatorenbau GmbH       
+                                                            Max-Eyth-Str. 10                             
+                                                            Ilshofen  BW  74532                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IHI Scube Co.,Ltd                            
+E15000-E15FFF                 (base 16)                     IHI Scube Co.,Ltd                            
+                                                            Takamatsu-cyo 1-100                          
+                                                            Tachikawa-shi  Tokyo  190-0011               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Trentino Systems                             
+E0F000-E0FFFF                 (base 16)                     Trentino Systems                             
+                                                            Damgade 71                                   
+                                                            Sonderborg    6400                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Cinetix s.r.l.                               
+E26000-E26FFF                 (base 16)                     Cinetix s.r.l.                               
+                                                            Via LIsbona 1                                
+                                                            Padova  PD  35127                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Lo-Q plc                                     
+E1E000-E1EFFF                 (base 16)                     Lo-Q plc                                     
+                                                            Unit 2, The Pavilions                        
+                                                            Twyford    RG10 9NN                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Radinetworks Co., Ltd                        
+E10000-E10FFF                 (base 16)                     Radinetworks Co., Ltd                        
+                                                            7F-5, No.229, Fuhsing 2nd Rd                 
+                                                            Jubei  Hsinchu County  30271                 
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Tommotek (WA) Pty Ltd.                       
+DF8000-DF8FFF                 (base 16)                     Tommotek (WA) Pty Ltd.                       
+                                                            72 Achievement Way                           
+                                                            Wangara  Western Australia  6065             
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Ocean Sonics                                 
+DF2000-DF2FFF                 (base 16)                     Ocean Sonics                                 
+                                                            Hill House                                   
+                                                            Great Village  Nova Scotia  B0M 1L0          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Leonardo MW Ltd (Land & Naval Defence Electronic)
+DD8000-DD8FFF                 (base 16)                     Leonardo MW Ltd (Land & Naval Defence Electronic)
+                                                            11300 W 89th St                              
+                                                            Overland Park    66214                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         A&A GENERAL SRL                              
+DDD000-DDDFFF                 (base 16)                     A&A GENERAL SRL                              
+                                                            Calea Victoriei 85, bl.1, ap.30              
+                                                            Bucuresti    010066                          
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Metraware                                    
+DD9000-DD9FFF                 (base 16)                     Metraware                                    
+                                                            Quartier Cime de Vieres                      
+                                                            CABRIERES D AIGUES    84240                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         IDC Solutions Pty Ltd                        
+DD0000-DD0FFF                 (base 16)                     IDC Solutions Pty Ltd                        
+                                                            Suite 8, 21 Regent Street                    
+                                                            Sydney   NSW  2016                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+DC4000-DC4FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         WITHSYSTEM Co.,Ltd                           
+DBE000-DBEFFF                 (base 16)                     WITHSYSTEM Co.,Ltd                           
+                                                            C/603, Digital empire, #980-3                
+                                                            suwon-si  gyeonggi-do  443-470               
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Security Services Group (SSG)                
+DC0000-DC0FFF                 (base 16)                     Security Services Group (SSG)                
+                                                            Unit 12, Taurus Business Park                
+                                                            Warrington  Cheshire  WA5 7ZT                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Esensors, Inc.                               
+DBB000-DBBFFF                 (base 16)                     Esensors, Inc.                               
+                                                            4240 Ridge Lea Road                          
+                                                            Amherst  NY  14226                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tele Data Control                            
+DCA000-DCAFFF                 (base 16)                     Tele Data Control                            
+                                                            Pod Jarovem 2236                             
+                                                            Praha    13000                               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         megatec electronic GmbH                      
+DA5000-DA5FFF                 (base 16)                     megatec electronic GmbH                      
+                                                            Lehenhammer 14                               
+                                                            Etzelwang  Bayern  92268                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+DA3000-DA3FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Manitowoc Ice                                
+DA6000-DA6FFF                 (base 16)                     Manitowoc Ice                                
+                                                            2110 South 26th Street                       
+                                                            Manitowoc  Wisconsin  54220                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         IMAGO Technologies GmbH                      
+DB0000-DB0FFF                 (base 16)                     IMAGO Technologies GmbH                      
+                                                            Strassheimer Strasse 45                      
+                                                            Friedberg  Hessen  D-61169                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Precision Remotes                            
+DA0000-DA0FFF                 (base 16)                     Precision Remotes                            
+                                                            860 Harbour Way South, Suite A               
+                                                            Richmond  CA  94804                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         BitWise Controls                             
+D9F000-D9FFFF                 (base 16)                     BitWise Controls                             
+                                                            98 Inverness Dr East                         
+                                                            Englewood  CO  80112                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Rong Shun Xuan Corp.                         
+D98000-D98FFF                 (base 16)                     Rong Shun Xuan Corp.                         
+                                                            1F, No. 5, Aly. 1, Ln 297, Ancing St., Sanchong City,
+                                                            Taipei    24162                              
+                                                            TW                                           
+
+00-50-C2                      (hex)                         LAUDA DR. R. WOBSER GMBH & CO. KG            
+DB3000-DB3FFF                 (base 16)                     LAUDA DR. R. WOBSER GMBH & CO. KG            
+                                                            Pfarrstraße 41/43                            
+                                                            Lauda-Koenigshofen  Baden-Württemberg  97922 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Capton                                       
+DA7000-DA7FFF                 (base 16)                     Capton                                       
+                                                            3001 Bridgeway                               
+                                                            Sausalito  CA  94965                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Electrolight Shivuk (1994) Ltd.              
+D87000-D87FFF                 (base 16)                     Electrolight Shivuk (1994) Ltd.              
+                                                            P.O BOX 258, Moshav Bazra 60944              
+                                                            Moshav Bazra    60944                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Software Effect Enterprises, Inc             
+D94000-D94FFF                 (base 16)                     Software Effect Enterprises, Inc             
+                                                            PO Box 1514                                  
+                                                            Newnan  GA  30264                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dumps Electronic                             
+D90000-D90FFF                 (base 16)                     Dumps Electronic                             
+                                                            Passauer Straße 45                           
+                                                            Röhrnbach    94133                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Manz                                         
+D92000-D92FFF                 (base 16)                     Manz                                         
+                                                            21D Yagia Kapayim St.                        
+                                                            Petach-Tikva    49130                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         LSD Science&Technology Co.,Ltd.              
+D8E000-D8EFFF                 (base 16)                     LSD Science&Technology Co.,Ltd.              
+                                                            Lierda Building,No.425 Dengyun Road          
+                                                            Hangzhou  Zhejiang  310011                   
+                                                            CN                                           
+
+00-50-C2                      (hex)                         CS-Instruments                               
+D8D000-D8DFFF                 (base 16)                     CS-Instruments                               
+                                                            Zindelsteiner Straße 15                      
+                                                            VS-Tannheim  Baden-Württemberg  78052        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LYNX Technik AG                              
+D7E000-D7EFFF                 (base 16)                     LYNX Technik AG                              
+                                                            Brunnenweg 3                                 
+                                                            Weiterstadt  Hessen  64331                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Microcubs Systems Pvt Ltd                    
+D7C000-D7CFFF                 (base 16)                     Microcubs Systems Pvt Ltd                    
+                                                            S.no.25/4/5, Vijaya Chembers,                
+                                                            PUNE  Maharastra  411051                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         HiSpeed Data, Inc.                           
+D68000-D68FFF                 (base 16)                     HiSpeed Data, Inc.                           
+                                                            4 Dakota Trail                               
+                                                            Branchburg  NJ  08876                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         BUANCO SYSTEM A/S                            
+D59000-D59FFF                 (base 16)                     BUANCO SYSTEM A/S                            
+                                                            Agerhatten 25                                
+                                                            Odense SØ    5220                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+D62000-D62FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         DATAREGIS S.A.                               
+D63000-D63FFF                 (base 16)                     DATAREGIS S.A.                               
+                                                            Rua Dom Aguirre, 190                         
+                                                            São Paulo  SP  04671-245                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Ibetor S.L.                                  
+D5C000-D5CFFF                 (base 16)                     Ibetor S.L.                                  
+                                                            Belgrado, 26.                                
+                                                            Las Rozas  Madrid  28232                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Telemerkki Oy                                
+D53000-D53FFF                 (base 16)                     Telemerkki Oy                                
+                                                            Raturinkuja 10-12                            
+                                                            Jokela  Tuusula  05400                       
+                                                            FI                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+D71000-D71FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SECOM GmbH                                   
+D4F000-D4FFFF                 (base 16)                     SECOM GmbH                                   
+                                                            Saseler Bogen 4a                             
+                                                            Hamburg    22393                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Cadi Scientific Pte Ltd                      
+D2D000-D2DFFF                 (base 16)                     Cadi Scientific Pte Ltd                      
+                                                            31 Ubi Road 1 Aztech Building                
+                                                            Singapore    408694                          
+                                                            SG                                           
+
+00-50-C2                      (hex)                         DALOG Diagnosesysteme GmbH                   
+D4C000-D4CFFF                 (base 16)                     DALOG Diagnosesysteme GmbH                   
+                                                            Siemensstrasse 2a                            
+                                                            Neusaess  Bavaria  86356                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GAON TECH corp.                              
+D34000-D34FFF                 (base 16)                     GAON TECH corp.                              
+                                                            #509, 199 Tekeuno2(i)-ro, Yuseong-gu         
+                                                            Daejeon  Yuseong-gu  305-500                 
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Peekel Instruments B.V.                      
+D03000-D03FFF                 (base 16)                     Peekel Instruments B.V.                      
+                                                            Industrieweg 161                             
+                                                            Rotterdam  ZH  3044 AS                       
+                                                            NL                                           
+
+00-50-C2                      (hex)                         SURVALENT TECHNOLOGY CORP                    
+D02000-D02FFF                 (base 16)                     SURVALENT TECHNOLOGY CORP                    
+                                                            2600 ARGENTIA ROAD                           
+                                                            MISSISSAUGA  ONTARIO  L5N 5V4                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Fr.Sauter AG                                 
+D27000-D27FFF                 (base 16)                     Fr.Sauter AG                                 
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH4016                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         RCH GROUP                                    
+D26000-D26FFF                 (base 16)                     RCH GROUP                                    
+                                                            VIA CENDON, 39                               
+                                                            SILEA  TREVISO  31057                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Recon Dynamics, LLC                          
+D1C000-D1CFFF                 (base 16)                     Recon Dynamics, LLC                          
+                                                            2300 Carillon Point                          
+                                                            Kirkland  WA  98033                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SAET I.S.                                    
+D14000-D14FFF                 (base 16)                     SAET I.S.                                    
+                                                            Via Leinì 1/b                                
+                                                            San maurizio Canavese  TO  10077             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Rosslare Enterprises Ltd.                    
+D10000-D10FFF                 (base 16)                     Rosslare Enterprises Ltd.                    
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon  00000                  
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Tokyo Weld Co.,Ltd.                          
+D12000-D12FFF                 (base 16)                     Tokyo Weld Co.,Ltd.                          
+                                                            2-28-1, Kitamagome                           
+                                                            Ota-ku  Tokyo  143-0021                      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+D0F000-D0FFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         CODACO ELECTRONIC s.r.o.                     
+D0B000-D0BFFF                 (base 16)                     CODACO ELECTRONIC s.r.o.                     
+                                                            Hemy 825                                     
+                                                            Valasske Mezirici    75701                   
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Airpoint Co., Ltd.                           
+D0A000-D0AFFF                 (base 16)                     Airpoint Co., Ltd.                           
+                                                            3rd fl. KDB Bldg. 946 unsan-dong             
+                                                            Daejeon    302-120                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         7+ Kft                                       
+D20000-D20FFF                 (base 16)                     7+ Kft                                       
+                                                            Homorod 17                                   
+                                                            Budapest    1118                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         APLICA TECHNOLOGIES                          
+CE6000-CE6FFF                 (base 16)                     APLICA TECHNOLOGIES                          
+                                                            10 HALAPID                                   
+                                                            PETECH- TIKVA    49170                       
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Echola Systems                               
+CE7000-CE7FFF                 (base 16)                     Echola Systems                               
+                                                            1971 Wayne Cir                               
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         AIRFOLC,INC.                                 
+CFD000-CFDFFF                 (base 16)                     AIRFOLC,INC.                                 
+                                                            4F CHOYO-BLDG.,225 SANMONJI-CHO              
+                                                            KYOTO    604-8135                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Armour Home Electronics LTD                  
+CF7000-CF7FFF                 (base 16)                     Armour Home Electronics LTD                  
+                                                            Unit B3 Kingswey Business Park               
+                                                            Woking  Surrey  GU21 5SA                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Epec Oy                                      
+CF6000-CF6FFF                 (base 16)                     Epec Oy                                      
+                                                            P.L. Box 194                                 
+                                                            Seinäjoki    60101                           
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Private                                      
+CE9000-CE9FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         SCHRAML GmbH                                 
+CD4000-CD4FFF                 (base 16)                     SCHRAML GmbH                                 
+                                                            Herxheimer Str. 7                            
+                                                            Vagen  Bavaria  83620                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Arcos Technologies Ltd.                      
+CD5000-CD5FFF                 (base 16)                     Arcos Technologies Ltd.                      
+                                                            26 Hasivim  St.                              
+                                                            Petach-Tikva    49517                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         SANMINA SHENZHEN                             
+CCA000-CCAFFF                 (base 16)                     SANMINA SHENZHEN                             
+                                                            1 NAN LING ROAD                              
+                                                            SHENZHEN    518125                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ConectaIP Tecnologia S.L.                    
+CC2000-CC2FFF                 (base 16)                     ConectaIP Tecnologia S.L.                    
+                                                            Novell 58                                    
+                                                            Barcelona    08014                           
+                                                            ES                                           
+
+00-50-C2                      (hex)                         RUTTER INC                                   
+CDB000-CDBFFF                 (base 16)                     RUTTER INC                                   
+                                                            63 THORBURN ROAD                             
+                                                            ST. JOHN'S  NEWFOUNDLAND  A1B 3M2            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         taskit GmbH                                  
+CDA000-CDAFFF                 (base 16)                     taskit GmbH                                  
+                                                            Seelenbinderstrasse 33                       
+                                                            Berlin    12555                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ZK Celltest Inc                              
+CB1000-CB1FFF                 (base 16)                     ZK Celltest Inc                              
+                                                            256 Gibraltar Drive                          
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+CAF000-CAFFFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH 4016                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         MSTRONIC CO., LTD.                           
+C97000-C97FFF                 (base 16)                     MSTRONIC CO., LTD.                           
+                                                            2F, No#12 Gongshang Rd.                      
+                                                            Taipei County    248                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Sm electronic co.                            
+C9B000-C9BFFF                 (base 16)                     Sm electronic co.                            
+                                                            338-2, Gwangpyeong-dong,                     
+                                                            Gumi-si  Gyeongsangbuk-do,  730-080          
+                                                            KR                                           
+
+00-50-C2                      (hex)                         SAE IT-systems GmbH & Co. KG                 
+CAB000-CABFFF                 (base 16)                     SAE IT-systems GmbH & Co. KG                 
+                                                            Im Gewerbegebiet Pesch 14                    
+                                                            Köln  NRW  50767                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Intelligent Devices                          
+CA9000-CA9FFF                 (base 16)                     Intelligent Devices                          
+                                                            300 Redland Ct.                              
+                                                            Owings Mills  MD  21117                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         ISIS ENGINEERING, S.A.                       
+C94000-C94FFF                 (base 16)                     ISIS ENGINEERING, S.A.                       
+                                                            C/ JOSE JESUS GARCIA DIAZ, 2                 
+                                                            SEVILLA    41020                             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Media Technologies Ltd.                      
+C91000-C91FFF                 (base 16)                     Media Technologies Ltd.                      
+                                                            361 Mill Road                                
+                                                            Colchester  Essex  CO4 5GG                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Rovsing A/S                                  
+C75000-C75FFF                 (base 16)                     Rovsing A/S                                  
+                                                            Dyregaardsvej 2                              
+                                                            Skovlunde  Copenhagen  2740                  
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Deansoft CO., Ltd.                           
+C6D000-C6DFFF                 (base 16)                     Deansoft CO., Ltd.                           
+                                                            3f,No.25,Alley 15, Lane 120, Neihu Rd.,      
+                                                            Taipei    11493                              
+                                                            TW                                           
+
+00-50-C2                      (hex)                         ELECTRONICA KELD                             
+C6A000-C6AFFF                 (base 16)                     ELECTRONICA KELD                             
+                                                            C/Lentisco 15                                
+                                                            LA CARTUJA BAJA  ZARAGOZA  50720             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         MSB Elektronik und Geraetebau GmbH           
+C6F000-C6FFFF                 (base 16)                     MSB Elektronik und Geraetebau GmbH           
+                                                            Hofwiesenstr. 23                             
+                                                            Crailsheim  BaWue  74564                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sequoia Technology Group Ltd                 
+C71000-C71FFF                 (base 16)                     Sequoia Technology Group Ltd                 
+                                                            Tekelec House                                
+                                                            Reading  Berkshire  RG7 1PW                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Pal Software Service Co.,Ltd.                
+C64000-C64FFF                 (base 16)                     Pal Software Service Co.,Ltd.                
+                                                            2ND TSUKUNA BULD. 3-10-31 AMAYAMA            
+                                                            MATSUYAMA  EHIME  7900951                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Icon Time Systems                            
+C5F000-C5FFFF                 (base 16)                     Icon Time Systems                            
+                                                            15201 NW Greenbrier Parkway                  
+                                                            Beaverton  OR  97006                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Creative Micro Design                        
+C89000-C89FFF                 (base 16)                     Creative Micro Design                        
+                                                            645B Dawson drive                            
+                                                            Newark  DE  19713                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gronic Systems GmbH                          
+C83000-C83FFF                 (base 16)                     Gronic Systems GmbH                          
+                                                            Hilpertswiese 7                              
+                                                            Birstein    63633                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+C85000-C85FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         DOMIS                                        
+C84000-C84FFF                 (base 16)                     DOMIS                                        
+                                                            10 avenue Jean Moulin                        
+                                                            RUMILLY    74150                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         MICRO TECHNICA                               
+C5B000-C5BFFF                 (base 16)                     MICRO TECHNICA                               
+                                                            5-12-1                                       
+                                                            Tsurugasima  SAITAMA  350-2211               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Cytek Media Systems, INC.                    
+C48000-C48FFF                 (base 16)                     Cytek Media Systems, INC.                    
+                                                            126 NW Jackson                               
+                                                            Topeka  KS  66603                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ANXeBusiness Corporation                     
+C3F000-C3FFFF                 (base 16)                     ANXeBusiness Corporation                     
+                                                            4106 Reas Lane                               
+                                                            New Albany  IN  47150                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Linuxstamp Designs, LLC                      
+C18000-C18FFF                 (base 16)                     Linuxstamp Designs, LLC                      
+                                                            3807 S Jewel Dr                              
+                                                            Flagstaff  AZ  86001                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ELREHA GmbH                                  
+C28000-C28FFF                 (base 16)                     ELREHA GmbH                                  
+                                                            Schwetzinger Straße 104                      
+                                                            Hockenheim  Baden-Württemberg  68766         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+BF2000-BF2FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Private                                      
+BEE000-BEEFFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         NOLAM EMBEDDED SYSTEMS                       
+BF6000-BF6FFF                 (base 16)                     NOLAM EMBEDDED SYSTEMS                       
+                                                            8 Rue d'estienne d'orves                     
+                                                            CRETEIL    94000                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+BF7000-BF7FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Monarch Innovative Technologies Pvt Ltd      
+BF4000-BF4FFF                 (base 16)                     Monarch Innovative Technologies Pvt Ltd      
+                                                            Monarch House, Master Mind II,               
+                                                            Mumbai  Maharashtra  400065                  
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Daeyoung inc.                                
+BEA000-BEAFFF                 (base 16)                     Daeyoung inc.                                
+                                                            596-1, Baegun-dong, Nam-gu                   
+                                                            Gwang-Ju    503-300                          
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Phaedrus Limited                             
+BE0000-BE0FFF                 (base 16)                     Phaedrus Limited                             
+                                                            5 Marsh House Mill                           
+                                                            Darwen  Lancashire  BB3 3JJ                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Convergent Bioscience Ltd.                   
+BE2000-BE2FFF                 (base 16)                     Convergent Bioscience Ltd.                   
+                                                            27 Coronet Road                              
+                                                            Toronto  ON  M8Z 2L8                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Evo-Teh d.o.o.                               
+BDE000-BDEFFF                 (base 16)                     Evo-Teh d.o.o.                               
+                                                            Mariborska cesta 3                           
+                                                            Dravograd  Slovenija  SI2370                 
+                                                            SI                                           
+
+00-50-C2                      (hex)                         Volumatic Limited.                           
+C03000-C03FFF                 (base 16)                     Volumatic Limited.                           
+                                                            Taurus House                                 
+                                                            Coventry  West Midlands  CV6 5PY             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SS Systems LLC                               
+BDC000-BDCFFF                 (base 16)                     SS Systems LLC                               
+                                                            104 Kurtner Ct                               
+                                                            Morrisville  NC  27560                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         SLAT                                         
+BD7000-BD7FFF                 (base 16)                     SLAT                                         
+                                                            11 Rue Jean-Elysée DUPUY                     
+                                                            Champagne au Mont d'Or  Rhône  69543         
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Docobo Ltd                                   
+BE6000-BE6FFF                 (base 16)                     Docobo Ltd                                   
+                                                            The Old Granary                              
+                                                            Bookham  Surrey  KT23 4AA                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ITS Telecom                                  
+BBD000-BBDFFF                 (base 16)                     ITS Telecom                                  
+                                                            29 Hametzuda st.                             
+                                                            Azur    58001                                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Epiko, elektronski sistemi d.o.o.            
+BCF000-BCFFFF                 (base 16)                     Epiko, elektronski sistemi d.o.o.            
+                                                            Izanska cesta 146a                           
+                                                            Ljubljana  Slovenija  1108                   
+                                                            SI                                           
+
+00-50-C2                      (hex)                         AGWTech Ltd                                  
+BC8000-BC8FFF                 (base 16)                     AGWTech Ltd                                  
+                                                            22 Nederdale Close                           
+                                                            Yarm  Stockton-on-Tees  TS15 9UE             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         EDC wifi                                     
+BD0000-BD0FFF                 (base 16)                     EDC wifi                                     
+                                                            Bao An Nan Lu                                
+                                                            ShenZhen  GuangDong  518001                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+BBF000-BBFFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+B87000-B87FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Innovate Software Solutions Pvt Ltd          
+B84000-B84FFF                 (base 16)                     Innovate Software Solutions Pvt Ltd          
+                                                            #333 ,18th G Main Road,6th Block             
+                                                            Bangalore  Karnataka  560095                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Telventy Energia S.A.                        
+B9B000-B9BFFF                 (base 16)                     Telventy Energia S.A.                        
+                                                            Valgrande, 6                                 
+                                                            Alcobendas  Madrid  28108                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         MicroPoise                                   
+B8A000-B8AFFF                 (base 16)                     MicroPoise                                   
+                                                            1624 Englewood Ave                           
+                                                            Akron  Ohio  44305                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ENTEC Electric & Electronic Co., LTD.        
+B89000-B89FFF                 (base 16)                     ENTEC Electric & Electronic Co., LTD.        
+                                                            78-2 Buncheon-ri, Bongdam-eup                
+                                                            Hwaseong-city  Gyungki-do  445-894           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Transtechnik GmbH & Co.KG                    
+BA1000-BA1FFF                 (base 16)                     Transtechnik GmbH & Co.KG                    
+                                                            Ohmstraße 1                                  
+                                                            Holzkirchen  Bavaria  83607                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Logical Tools s.r.l.                         
+BA2000-BA2FFF                 (base 16)                     Logical Tools s.r.l.                         
+                                                            Via di Giorgio Scalia, 46                    
+                                                            Rome    00136                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         NAONWORKS Co., Ltd                           
+B90000-B90FFF                 (base 16)                     NAONWORKS Co., Ltd                           
+                                                            Rm710, Byucksan Digitalvalley 3,             
+                                                            Seoul    152-775                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Tritech International Ltd                    
+B94000-B94FFF                 (base 16)                     Tritech International Ltd                    
+                                                            Morecambe Road                               
+                                                            Ulverston  Cumbria  LA12 0BH                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Gentec                                       
+B8F000-B8FFFF                 (base 16)                     Gentec                                       
+                                                            2625 Dalton                                  
+                                                            Quebec    G1P 3S9                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Prediktor AS                                 
+BAD000-BADFFF                 (base 16)                     Prediktor AS                                 
+                                                            Habornveien 48B                              
+                                                            Gamle Fredrikstad  .  1630                   
+                                                            NO                                           
+
+00-50-C2                      (hex)                         iDeal Teknoloji Bilisim Cozumleri A.S.       
+BAB000-BABFFF                 (base 16)                     iDeal Teknoloji Bilisim Cozumleri A.S.       
+                                                            Cumhuriyet Cad. Yeni Parseller Sok. B Blok Giris Kat KAVACIK
+                                                            ISTANBUL    34805                            
+                                                            TR                                           
+
+00-50-C2                      (hex)                         NARETRENDS                                   
+B7E000-B7EFFF                 (base 16)                     NARETRENDS                                   
+                                                            #406, Hyunhaetop B/D, 1144-4                 
+                                                            BUCHEON  GYEONGGI-DO  420-852                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         FEW Bauer GmbH                               
+B64000-B64FFF                 (base 16)                     FEW Bauer GmbH                               
+                                                            Silvanastr. 3                                
+                                                            Muenchen  Bayern  D-81927                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+B65000-B65FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sound Metrics Corp                           
+B6D000-B6DFFF                 (base 16)                     Sound Metrics Corp                           
+                                                            15029 Bothell Way NE                         
+                                                            Lake Forest Park  WA  98155                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         SLICAN sp. z o.o.                            
+B59000-B59FFF                 (base 16)                     SLICAN sp. z o.o.                            
+                                                            ul.M.Konopnickiej 18                         
+                                                            Bydgoszcz  Kujawsko-Pomorskie  85-124        
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+B57000-B57FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Efftronics Systems (P) Ltd                   
+B45000-B45FFF                 (base 16)                     Efftronics Systems (P) Ltd                   
+                                                            40-15-9                                      
+                                                            Vijayawada  Andhra Pradesh  520010           
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Tecnint HTE SRL                              
+B40000-B40FFF                 (base 16)                     Tecnint HTE SRL                              
+                                                            Via della Tecnica 16/18                      
+                                                            Osnago  Lecco  23875                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SANYO ELECTRONIC INDUSTRIES CO.,LTD          
+B55000-B55FFF                 (base 16)                     SANYO ELECTRONIC INDUSTRIES CO.,LTD          
+                                                            Nagaoka4-73,Nakaku                           
+                                                            Okayama    703-8221                          
+                                                            JP                                           
+
+00-50-C2                      (hex)                         AMS                                          
+B3D000-B3DFFF                 (base 16)                     AMS                                          
+                                                            2-4-3,Kikawahigashi,Yodogawaku               
+                                                            Osaka City    532-0012                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Teledyne Defence Limited                     
+B24000-B24FFF                 (base 16)                     Teledyne Defence Limited                     
+                                                            Airedale House, Acorn Park                   
+                                                            Shipley  West Yorkshire  BD17 7SW            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Phytron-Elektronik GmbH                      
+B21000-B21FFF                 (base 16)                     Phytron-Elektronik GmbH                      
+                                                            Industriestraße 12                           
+                                                            Gröbenzell  Bavaria  82194                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FarSite Communications Limited               
+B22000-B22FFF                 (base 16)                     FarSite Communications Limited               
+                                                            Tempus Business Centre                       
+                                                            Basingstoke  Hampshire  RG21 6XG             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         CM Elektronik GmbH                           
+B12000-B12FFF                 (base 16)                     CM Elektronik GmbH                           
+                                                            Im Kleinfeldele 17                           
+                                                            Riegel a.K.  Baden-Württemberg  79359        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ATEME                                        
+B27000-B27FFF                 (base 16)                     ATEME                                        
+                                                            26 BUROSPACE                                 
+                                                            BIEVRES CEDEX    91573                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         IntelliVision Technologies, Corp             
+B2F000-B2FFFF                 (base 16)                     IntelliVision Technologies, Corp             
+                                                            5225 Hellyer Ave, Suite 200                  
+                                                            San Jose  CA  95138                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         CRDE                                         
+B36000-B36FFF                 (base 16)                     CRDE                                         
+                                                            ZI DES GRANDS CAMPS                          
+                                                            MERCUES  LOT  46090                          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Indutherm Giesstechnologie GmbH              
+B0A000-B0AFFF                 (base 16)                     Indutherm Giesstechnologie GmbH              
+                                                            Brettener Straße 32                          
+                                                            Walzbachtal  Baden-Württemberg  75045        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Marine Entertainment Systems Ltd             
+B10000-B10FFF                 (base 16)                     Marine Entertainment Systems Ltd             
+                                                            LSC House                                    
+                                                            Orpington  Kent  BR5 3QY                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HomeScenario, Inc.                           
+AFD000-AFDFFF                 (base 16)                     HomeScenario, Inc.                           
+                                                            5F No. 9 Sec. 2 Ho-Ping W. Rd.               
+                                                            Taipei    100                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Absolute Fire Solutions Inc.                 
+AFA000-AFAFFF                 (base 16)                     Absolute Fire Solutions Inc.                 
+                                                            1338 - 36 Ave NE                             
+                                                            Calgary  Alberta  T2E 6T6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         MASTER CO LTD                                
+B02000-B02FFF                 (base 16)                     MASTER CO LTD                                
+                                                            42-20, Palyong-Dong                          
+                                                            Changwon-City  Gyeongnam  641-847            
+                                                            KR                                           
+
+00-50-C2                      (hex)                         EMBEDIA                                      
+AEA000-AEAFFF                 (base 16)                     EMBEDIA                                      
+                                                            11 Avenue Albert EINSTEIN                    
+                                                            VILLEURBANNE    69100                        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         UMLogics Corporation                         
+AEB000-AEBFFF                 (base 16)                     UMLogics Corporation                         
+                                                            EXPOTEL 924, 381 Manyeon-dong, Seo-gu        
+                                                            Daejeon    302-150                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ABS Gesellschaft f. Automatisierung, Bildverarbeitung und Software mbH
+AE5000-AE5FFF                 (base 16)                     ABS Gesellschaft f. Automatisierung, Bildverarbeitung und Software mbH
+                                                            Erlanger Allee 103                           
+                                                            Jena  Thueringen  07747                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Power Medical Interventions                  
+AE2000-AE2FFF                 (base 16)                     Power Medical Interventions                  
+                                                            2021 Cabot Blvd. West                        
+                                                            Langhorne  PA  19047                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         EVERCARE                                     
+AE1000-AE1FFF                 (base 16)                     EVERCARE                                     
+                                                            4fl., 620-1 Shinsa-dong                      
+                                                            Seoul    135-890                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Mighty Lube Systematic Lubrication, Inc.     
+AD5000-AD5FFF                 (base 16)                     Mighty Lube Systematic Lubrication, Inc.     
+                                                            9569 West 40th Street                        
+                                                            Fremont  MI  49412                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Palomar Products, Inc.                       
+AF3000-AF3FFF                 (base 16)                     Palomar Products, Inc.                       
+                                                            23042 Arroyo Vista                           
+                                                            Rancho Santa Margarita  California  92688    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Essepie Srl                                  
+ADA000-ADAFFF                 (base 16)                     Essepie Srl                                  
+                                                            Via Artigianato,5                            
+                                                            DALMINE  BERGAMO  24044                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Nexans Cabling Solutions                     
+AA8000-AA8FFF                 (base 16)                     Nexans Cabling Solutions                     
+                                                            Alsembergsesteenweg 2 B3                     
+                                                            Buizingen    1501                            
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Update Systems Inc.                          
+AAD000-AADFFF                 (base 16)                     Update Systems Inc.                          
+                                                            10545 Baur Blvd.                             
+                                                            Saint Louis  MO  63132                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Palladio Systeme GmbH                        
+AC8000-AC8FFF                 (base 16)                     Palladio Systeme GmbH                        
+                                                            Thalkirchner Str. 76                         
+                                                            80337  BY  80337                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Volantic AB                                  
+ABB000-ABBFFF                 (base 16)                     Volantic AB                                  
+                                                            Gymnasievagen 16                             
+                                                            Skelleftea  Vasterbotten  931 53             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Ceron Tech Co.,LTD                           
+A91000-A91FFF                 (base 16)                     Ceron Tech Co.,LTD                           
+                                                            #809-1, Kranz Techno, 5442-1,                
+                                                            Seongnam-si    462-819                       
+                                                            KR                                           
+
+00-50-C2                      (hex)                         S.two Corporation                            
+A90000-A90FFF                 (base 16)                     S.two Corporation                            
+                                                            9475 Double R Blvd.                          
+                                                            Reno  NV  89521                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         ELPA sas                                     
+AA2000-AA2FFF                 (base 16)                     ELPA sas                                     
+                                                            via Rocciamelone 3                           
+                                                            Caprie  TO  10040                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ELREM ELECTRONIC AG                          
+AA1000-AA1FFF                 (base 16)                     ELREM ELECTRONIC AG                          
+                                                            Unterstrasse 35                              
+                                                            Herzogenbuchsee  Bern  3360                  
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Redwire, LLC                                 
+A8C000-A8CFFF                 (base 16)                     Redwire, LLC                                 
+                                                            8 Thorndike St                               
+                                                            Everett  MA  02149                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bassett Electronic Systems ltd               
+AA6000-AA6FFF                 (base 16)                     Bassett Electronic Systems ltd               
+                                                            Unit 24 Whitehill Ind Park                   
+                                                            Wootton Bassett  Wiltshire  SN4 7DB          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Littlemore Scientific                        
+A87000-A87FFF                 (base 16)                     Littlemore Scientific                        
+                                                            Gutchpool Farm                               
+                                                            Gillingham  Dorset  SP8 5QP                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         S-SYS                                        
+A88000-A88FFF                 (base 16)                     S-SYS                                        
+                                                            Dijkstraat 8                                 
+                                                            Ham  Limburg  3945                           
+                                                            BE                                           
+
+00-50-C2                      (hex)                         CA Traffic Ltd                               
+A89000-A89FFF                 (base 16)                     CA Traffic Ltd                               
+                                                            Griffin Lane                                 
+                                                            Aylesbury  Buckinghamshire  HP198BP          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Flexible Picture Systems                     
+AAA000-AAAFFF                 (base 16)                     Flexible Picture Systems                     
+                                                            174 West Beaver Creek Road                   
+                                                            Richmond Hill  Ontario  L4B 1B4              
+                                                            CA                                           
+
+00-50-C2                      (hex)                         EPL                                          
+A58000-A58FFF                 (base 16)                     EPL                                          
+                                                            4 IMPASSE DES SAULES                         
+                                                            FAREMOUTIERS  SEINE ET MARNE  77515          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         GSP Sprachtechnologie GmbH                   
+A59000-A59FFF                 (base 16)                     GSP Sprachtechnologie GmbH                   
+                                                            Teltowkanalstr. 1                            
+                                                              Berlin  12247                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Diamond Point International (Europe) Ltd     
+A54000-A54FFF                 (base 16)                     Diamond Point International (Europe) Ltd     
+                                                            13 Ashford House, Beaufort Court             
+                                                            Rochester  Kent  ME2 4FA                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Quality & Design                             
+A53000-A53FFF                 (base 16)                     Quality & Design                             
+                                                            Bergweg 32                                   
+                                                            Rhenen    3911 VB                            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         KYOEI ENGINEERING Co.,Ltd.                   
+A73000-A73FFF                 (base 16)                     KYOEI ENGINEERING Co.,Ltd.                   
+                                                            1-3-35 ATSUBETSU HIGASHI 5 JYO               
+                                                            SAPPORO-SHI  HOKKAIDO  004-0005              
+                                                            JP                                           
+
+00-50-C2                      (hex)                         MECC CO., LTD.                               
+A5D000-A5DFFF                 (base 16)                     MECC CO., LTD.                               
+                                                            196-1 FUKUDO                                 
+                                                            OGORI-SHI  FUKUOKA  838-0137                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Pneu-Logic Corporation                       
+A7C000-A7CFFF                 (base 16)                     Pneu-Logic Corporation                       
+                                                            6650 SW Redwood Lane                         
+                                                            Portland  OR  97224                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Infocrossing                                 
+A6A000-A6AFFF                 (base 16)                     Infocrossing                                 
+                                                            11800 Ridge Parkway                          
+                                                            Broomfield  CO  80021                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fuji Firmware                                
+A33000-A33FFF                 (base 16)                     Fuji Firmware                                
+                                                            535-211 Nakayamacyou-Nishi                   
+                                                            Nara-City  Nara-Prefecture  631-0013         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Coolit Systems, Inc.                         
+A31000-A31FFF                 (base 16)                     Coolit Systems, Inc.                         
+                                                            3920 - 29th St. N.E.                         
+                                                            Calgary  AB  T1Y6B6                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         DragonFly Scientific LLC                     
+A2F000-A2FFFF                 (base 16)                     DragonFly Scientific LLC                     
+                                                            RR2 Box 467A                                 
+                                                            Harveys Lake  PA  18618                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Custom Control Concepts                      
+A2A000-A2AFFF                 (base 16)                     Custom Control Concepts                      
+                                                            6020 S 190th St                              
+                                                            Kent  WA  98032                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Meiryo Denshi Corp.                          
+A41000-A41FFF                 (base 16)                     Meiryo Denshi Corp.                          
+                                                            38-23 higashi maeda                          
+                                                            Nishin City  Aichi  470-0124                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Icon Time Systems                            
+A19000-A19FFF                 (base 16)                     Icon Time Systems                            
+                                                            15201 NW Greenbrier Parkway #A1              
+                                                            Beaverton  OR  97006                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         IPcontrols GmbH                              
+A3B000-A3BFFF                 (base 16)                     IPcontrols GmbH                              
+                                                            Neue Kasseler Str. 50                        
+                                                            Marburg    35039                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         VasoNova, Inc.                               
+A4C000-A4CFFF                 (base 16)                     VasoNova, Inc.                               
+                                                            1368 Bordeaux Drive                          
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         IDEAS s.r.l.                                 
+9F1000-9F1FFF                 (base 16)                     IDEAS s.r.l.                                 
+                                                            Via XXV Aprile 9/A                           
+                                                            Cassina de pecchi  Milan  20060              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Ciemme Sistemi Spa                           
+9E9000-9E9FFF                 (base 16)                     Ciemme Sistemi Spa                           
+                                                            Viale Ariosto, 492/A                         
+                                                            Sesto Fiorentino  (FIRENZE)  50019           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Picell B.V.                                  
+9ED000-9EDFFF                 (base 16)                     Picell B.V.                                  
+                                                            Liede 35                                     
+                                                            Rotterdam    3068GP                          
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Baudisch Electronic GmbH                     
+A16000-A16FFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7-9                         
+                                                            Wäschenbeuren  Baden-Württemberg  73116      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LabJack Corporation                          
+A08000-A08FFF                 (base 16)                     LabJack Corporation                          
+                                                            3232 S Vance St STE 100                      
+                                                            Lakewood  CO  80227                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         TP Radio                                     
+A04000-A04FFF                 (base 16)                     TP Radio                                     
+                                                            Agenavej 37                                  
+                                                            Greve  .  2670                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Halliburton Far East Pte Ltd                 
+9E5000-9E5FFF                 (base 16)                     Halliburton Far East Pte Ltd                 
+                                                            315 Jalan Ahmad Ibrahim                      
+                                                                639940                                   
+                                                            SG                                           
+
+00-50-C2                      (hex)                         Enreduce Energy Control AB                   
+9E1000-9E1FFF                 (base 16)                     Enreduce Energy Control AB                   
+                                                            Box 459                                      
+                                                            UPPSALA    751 06                            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ISA - Intelligent Sensing Anywhere, S.A.     
+9B9000-9B9FFF                 (base 16)                     ISA - Intelligent Sensing Anywhere, S.A.     
+                                                            Estádio Cidade de Coimbra                    
+                                                            Coimbra    3030-320                          
+                                                            PT                                           
+
+00-50-C2                      (hex)                         Hirotech, Inc                                
+9CC000-9CCFFF                 (base 16)                     Hirotech, Inc                                
+                                                            Shinyokohama I.O Bldg. #602, 1-3-10, Shinyokohama, Kohoku-ku
+                                                            Yokohama City  Kanagawa  222-0033            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Protronic GmbH                               
+9C6000-9C6FFF                 (base 16)                     Protronic GmbH                               
+                                                            Am Schwarzwasser 2b                          
+                                                            Bennewitz  Sachsen  04828                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         St. Michael Strategies                       
+9B7000-9B7FFF                 (base 16)                     St. Michael Strategies                       
+                                                            701 Salaberry                                
+                                                            Chambly  Quebec  J3L 1R2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         EUKREA ELECTROMATIQUE SARL                   
+9B4000-9B4FFF                 (base 16)                     EUKREA ELECTROMATIQUE SARL                   
+                                                            74 AVENUE JEAN JAURES                        
+                                                            PESSAC  GIRONDE  33600                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         DOMIS SA                                     
+9A8000-9A8FFF                 (base 16)                     DOMIS SA                                     
+                                                            10 AV jean Moulin                            
+                                                            RUMILLY    74150                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+998000-998FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IDT Sound Processing Corporation             
+992000-992FFF                 (base 16)                     IDT Sound Processing Corporation             
+                                                            917 chemin Pierre Drevet                     
+                                                            CALUIRE  Rhone  69300                        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Mecos AG                                     
+98D000-98DFFF                 (base 16)                     Mecos AG                                     
+                                                            Industriestrasse 26                          
+                                                            Winterthur    8404                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         MEV Limited                                  
+98A000-98AFFF                 (base 16)                     MEV Limited                                  
+                                                            Unit 8, Baxall Business Centre               
+                                                            STOCKPORT  Cheshire  SK3 8LF                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SMARTQUANTUM SA                              
+97B000-97BFFF                 (base 16)                     SMARTQUANTUM SA                              
+                                                            4 rue Louis de Broglie                       
+                                                            Lannion    22300                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Tsuji Electronics Co.,Ltd                    
+970000-970FFF                 (base 16)                     Tsuji Electronics Co.,Ltd                    
+                                                            3739 Kandatsu-machi                          
+                                                            Tsuchiura-city  Ibafaki Pref.  3000013       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Pantel International                         
+988000-988FFF                 (base 16)                     Pantel International                         
+                                                            125 Joseph Zatzma Drive                      
+                                                            Dartmouth  Nova Scotia  B3B1W1               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Creacon Technologies B.V.                    
+97C000-97CFFF                 (base 16)                     Creacon Technologies B.V.                    
+                                                            Cornelis Houtmanstraat 26                    
+                                                            Emmen    7825 VG                             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         PCM Industries                               
+966000-966FFF                 (base 16)                     PCM Industries                               
+                                                            46 Shaggy Mt. Drive                          
+                                                            Herriman  Utah  84096                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bogart Engineering                           
+983000-983FFF                 (base 16)                     Bogart Engineering                           
+                                                            19020 Two Bar Road                           
+                                                            Boulder Creek  CA  95006                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         TechnoAP                                     
+95A000-95AFFF                 (base 16)                     TechnoAP                                     
+                                                            Takaba 2247-4                                
+                                                            Hitachinaka  Ibaraki  312-0062               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Piller engineering Ltd.                      
+94B000-94BFFF                 (base 16)                     Piller engineering Ltd.                      
+                                                            Stauffenbergstraße 15                        
+                                                            Ostfildern  Baden-Württemberg  73760         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TruMedia Measurement Ltd.                    
+94A000-94AFFF                 (base 16)                     TruMedia Measurement Ltd.                    
+                                                            7 Leshem St., Kiriat-Matalon                 
+                                                            Petah-Tikva 4951768                          
+                                                            IL                                           
+
+00-50-C2                      (hex)                         full electronic system                       
+95D000-95DFFF                 (base 16)                     full electronic system                       
+                                                            parc des ruires                              
+                                                            eybens    38320                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         MEGWARE Computer GmbH                        
+946000-946FFF                 (base 16)                     MEGWARE Computer GmbH                        
+                                                            Nordstrasse 19                               
+                                                            Chemnitz-Roehrsdorf  Sachsen  09247          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Wireonair A/S                                
+944000-944FFF                 (base 16)                     Wireonair A/S                                
+                                                            Skudehavnsvej 17                             
+                                                            Copenhagen    2100                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Korea Telecom Internet Solutions (KTIS)      
+931000-931FFF                 (base 16)                     Korea Telecom Internet Solutions (KTIS)      
+                                                            Room 208, Lotte Gold Rose Tower II, 890-59,  
+                                                            Seoul    135-280                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Xilar Corp.                                  
+934000-934FFF                 (base 16)                     Xilar Corp.                                  
+                                                            2160 South M-15 Hwy.                         
+                                                            Ortonville  MI  48462                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SMAVIS Inc.                                  
+932000-932FFF                 (base 16)                     SMAVIS Inc.                                  
+                                                            914 JEI Platz, 459-11 Gasan-dong,            
+                                                            Seoul    153-803                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Margaritis Engineering                       
+936000-936FFF                 (base 16)                     Margaritis Engineering                       
+                                                            370 Verano Drive                             
+                                                            Los Altos  CA  94022                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Flight Deck Resources                        
+929000-929FFF                 (base 16)                     Flight Deck Resources                        
+                                                            16 Technology Drive                          
+                                                            Irvine  California  92618                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Goanna Technologies Pty Ltd                  
+92E000-92EFFF                 (base 16)                     Goanna Technologies Pty Ltd                  
+                                                            204 / 396 Scarborough Beach Rd               
+                                                            Osborne Park  WA  6017                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Cross Country Systems AB                     
+8FE000-8FEFFF                 (base 16)                     Cross Country Systems AB                     
+                                                            Box 83                                       
+                                                            Alfta    822 22                              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Vapor Rail                                   
+911000-911FFF                 (base 16)                     Vapor Rail                                   
+                                                            10655 Henri-Bourassa West                    
+                                                            Saint-Laurent  Quebec  H4S 1A1               
+                                                            CA                                           
+
+00-50-C2                      (hex)                         EcoAxis Systems Pvt. Ltd.                    
+903000-903FFF                 (base 16)                     EcoAxis Systems Pvt. Ltd.                    
+                                                            3, Shreeniwas Classic,                       
+                                                            Pune  Maharashtra  411045                    
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Magor Communications Corp                    
+900000-900FFF                 (base 16)                     Magor Communications Corp                    
+                                                            350 Legget Drive                             
+                                                            Ottawa  ON  K2K 2W7                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         R2Sonic, LLC                                 
+904000-904FFF                 (base 16)                     R2Sonic, LLC                                 
+                                                            5307 Industrial Oaks Blvd                    
+                                                            Austin  TX  78735                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         EVK DI Kerschhaggl GmbH                      
+90D000-90DFFF                 (base 16)                     EVK DI Kerschhaggl GmbH                      
+                                                            Josef Krainer Str. 35                        
+                                                            Graz  Styria  A8074                          
+                                                            AT                                           
+
+00-50-C2                      (hex)                         IO-Connect                                   
+914000-914FFF                 (base 16)                     IO-Connect                                   
+                                                            Ahlmannsvej 41B                              
+                                                            Sonderborg    6400                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+91C000-91CFFF                 (base 16)                     MangoDSP                                     
+                                                            Hartom 8                                     
+                                                            Jerusalem  ISRAEL  45116                     
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Verint Systems Ltd.                          
+915000-915FFF                 (base 16)                     Verint Systems Ltd.                          
+                                                            33 Maskit St.                                
+                                                            Herzliya  Israel  46733                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Curtis Door Systems Inc                      
+8F3000-8F3FFF                 (base 16)                     Curtis Door Systems Inc                      
+                                                            104 Sharron Avenue                           
+                                                            Plattsburgh  NY  12901                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Symetrics Industries                         
+8FC000-8FCFFF                 (base 16)                     Symetrics Industries                         
+                                                            1615 West Nasa Blvd                          
+                                                            West Melbourne  Fl  32901                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         RMSD LTD                                     
+8F8000-8F8FFF                 (base 16)                     RMSD LTD                                     
+                                                            30A Uppingham Cres                           
+                                                            North Shore City  Auckland  0627             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Detection Technologies Ltd.                  
+8F1000-8F1FFF                 (base 16)                     Detection Technologies Ltd.                  
+                                                            Fairview Building                            
+                                                            Ripley  Derbyshire  DE5 3GH                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         MKT Systemtechnik                            
+8E7000-8E7FFF                 (base 16)                     MKT Systemtechnik                            
+                                                            Hasskampstraße 75-77                         
+                                                            Bünde  NRW  32257                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DOCUTEMP, INC                                
+8DA000-8DAFFF                 (base 16)                     DOCUTEMP, INC                                
+                                                            19 CROSBY DRIVE                              
+                                                            BEDFORD  MA  01730                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         UNIDATA                                      
+8E9000-8E9FFF                 (base 16)                     UNIDATA                                      
+                                                            Office 610, Antonova 5                       
+                                                            Kiev    03186                                
+                                                            UA                                           
+
+00-50-C2                      (hex)                         A+S Aktuatorik und Sensorik GmbH             
+8C9000-8C9FFF                 (base 16)                     A+S Aktuatorik und Sensorik GmbH             
+                                                            Franz-Wienholz-Str. 16                       
+                                                            Prenzlau  Brandenburg  17291                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Honeywell Sensotec                           
+8BC000-8BCFFF                 (base 16)                     Honeywell Sensotec                           
+                                                            2080 Arlingate Ln.                           
+                                                            Columbus  Ohio  43228                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Matrix Switch Corporation                    
+8BD000-8BDFFF                 (base 16)                     Matrix Switch Corporation                    
+                                                            17720 Retrac Way                             
+                                                            Grass Valley  CA  95949                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         smtag international ag                       
+8BB000-8BBFFF                 (base 16)                     smtag international ag                       
+                                                            Bahnhofstrasse 198                           
+                                                            Wetzikon  Zürich  8620                       
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DSS Networks, Inc.                           
+8B8000-8B8FFF                 (base 16)                     DSS Networks, Inc.                           
+                                                            23 Spectrum Pointe Drive                     
+                                                            Lake Forest  CA  92630                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+8B9000-8B9FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Calnex Solutions Limited                     
+8B7000-8B7FFF                 (base 16)                     Calnex Solutions Limited                     
+                                                            Springfield                                  
+                                                            Linlithgow  West Lothian  EH49 7NX           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corp                            
+8D5000-8D5FFF                 (base 16)                     Peek Traffic Corp                            
+                                                            2511 Corporate Way                           
+                                                            Palmetto  Fl  34221                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrial Control and Communication Limited 
+8D9000-8D9FFF                 (base 16)                     Industrial Control and Communication Limited 
+                                                            Unit 1 Manor Park                            
+                                                            Nailsea  Bristol  BS48 4DD                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Internet Protocolo Lógica SL                 
+8D4000-8D4FFF                 (base 16)                     Internet Protocolo Lógica SL                 
+                                                            Ramón y Cajal 5                              
+                                                            Alcobendas  Madrid  28100                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         IFAM GmbH                                    
+8D3000-8D3FFF                 (base 16)                     IFAM GmbH                                    
+                                                            Parselvalstr. 2                              
+                                                            Erfurt  Thuringia  99092                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Byte Paradigm                                
+8C3000-8C3FFF                 (base 16)                     Byte Paradigm                                
+                                                            Chaussée de Namur, 119                       
+                                                            Nivelles (Thines)  Brabant  1402             
+                                                            BE                                           
+
+00-50-C2                      (hex)                         ARISTO Graphic Systeme GmbH & Co. KG         
+8BF000-8BFFFF                 (base 16)                     ARISTO Graphic Systeme GmbH & Co. KG         
+                                                            Schnackenburgallee 117                       
+                                                            Hamburg    22525                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RingCube Technologies, Inc.                  
+8B1000-8B1FFF                 (base 16)                     RingCube Technologies, Inc.                  
+                                                            3990 Freedom Circle, Suite 200               
+                                                            Santa Clara  CA  95050                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         DESARROLLO DE SISTEMAS INTEGRADOS DE CONTROL S.A.
+8AE000-8AEFFF                 (base 16)                     DESARROLLO DE SISTEMAS INTEGRADOS DE CONTROL S.A.
+                                                            C/FEDANCI 8-10, 3º-3ª                        
+                                                            SANT CUGAT DEL VALLES  BARCELONA  08174      
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Xelerated                                    
+8AF000-8AFFFF                 (base 16)                     Xelerated                                    
+                                                            Olof Palmes gata 29                          
+                                                            Stockholm    SE-11122                        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Systemtechnik GmbH                           
+89D000-89DFFF                 (base 16)                     Systemtechnik GmbH                           
+                                                            Wielandstraße 12                             
+                                                            Sömmerda  Thuringia  99610                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sensata Technologies, Inc.                   
+89B000-89BFFF                 (base 16)                     Sensata Technologies, Inc.                   
+                                                            4467 White Bear Parkway                      
+                                                            White Bear Lake  MN  55110                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keynote SIGOS GmbH                           
+88F000-88FFFF                 (base 16)                     Keynote SIGOS GmbH                           
+                                                            Klingenhofstraße 50d                         
+                                                            Nürnberg  Bayern  90411                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Admiral Secure Products, Ltd.                
+891000-891FFF                 (base 16)                     Admiral Secure Products, Ltd.                
+                                                            15-6400 Millcreek Drive                      
+                                                            Mississauga  Ontario  L5N 3E7                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         InnoTrans Communications, Inc.               
+881000-881FFF                 (base 16)                     InnoTrans Communications, Inc.               
+                                                            6840 Via Del Oro, Ste#210                    
+                                                            San Jose  CA  95119                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Colorado Engineering Inc.                    
+720000-720FFF                 (base 16)                     Colorado Engineering Inc.                    
+                                                            1915 Jamboree Drive                          
+                                                            Colorado Springs  CO  80920                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Aethon, Inc.                                 
+868000-868FFF                 (base 16)                     Aethon, Inc.                                 
+                                                            100 Business Center Drive                    
+                                                            Pittsburgh  PA  15205                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia Burgess Controls AG                     
+866000-866FFF                 (base 16)                     Saia Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Motion Analysis Corp                         
+877000-877FFF                 (base 16)                     Motion Analysis Corp                         
+                                                            3617 Westwind Blvd                           
+                                                            Santa Rosa  CA  95403                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+875000-875FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AT&T Government Solutions                    
+87D000-87DFFF                 (base 16)                     AT&T Government Solutions                    
+                                                            11301 Corporate Blvd.                        
+                                                            Orlando  FL  32817                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         MILESYS                                      
+879000-879FFF                 (base 16)                     MILESYS                                      
+                                                            7 Ter rue de la porte de buc                 
+                                                            VERSAILLES  YVELINES  78000                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         DASA ROBOT Co., Ltd.                         
+848000-848FFF                 (base 16)                     DASA ROBOT Co., Ltd.                         
+                                                            11th Floor Bucheon Techno Park Bldg. 401 Yakdae0dong, Wonmi-gu, Bucheon-city Gyunggi-do, Republic of Korea
+                                                            Bucheon  Gyunggi-do  420-734                 
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Performance Motion Devices                   
+84C000-84CFFF                 (base 16)                     Performance Motion Devices                   
+                                                            1 Technology Park Drive                      
+                                                            Westford  MA  01886                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         eInfochips Ltd.                              
+852000-852FFF                 (base 16)                     eInfochips Ltd.                              
+                                                            11 A/B, Karmabhumi, Off C.G. Road,           
+                                                            Ahmedabad  Gujarat  380006                   
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ID-KARTA s.r.o.                              
+837000-837FFF                 (base 16)                     ID-KARTA s.r.o.                              
+                                                            Hlavni 3                                     
+                                                            Opava    747 70                              
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         MISCO Refractometer                          
+821000-821FFF                 (base 16)                     MISCO Refractometer                          
+                                                            3401 Virginia Rd.                            
+                                                            Cleveland  OH  44122                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         CompuShop Services LLC                       
+830000-830FFF                 (base 16)                     CompuShop Services LLC                       
+                                                            7517 Washington Ave S                        
+                                                            Edina   MN  55439                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elmec, Inc.                                  
+82D000-82DFFF                 (base 16)                     Elmec, Inc.                                  
+                                                            61 Hayotzrim Street                          
+                                                            Karmiel  Haifa  20101                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         HEWI Heinrich Wilke GmbH                     
+826000-826FFF                 (base 16)                     HEWI Heinrich Wilke GmbH                     
+                                                            Prof.-Bier-Str. 1-5                          
+                                                            Bad Arolsen  Hessen  34454                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         InfoGLOBAL                                   
+81A000-81AFFF                 (base 16)                     InfoGLOBAL                                   
+                                                            Manuel Pombo Angulo, 20                      
+                                                            Madrid    28050                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Robot Visual Systems GmbH                    
+823000-823FFF                 (base 16)                     Robot Visual Systems GmbH                    
+                                                            Opladener Strasse 202                        
+                                                            Monheim    40789                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         dB Broadcast Limited                         
+803000-803FFF                 (base 16)                     dB Broadcast Limited                         
+                                                            Kestrel House                                
+                                                            Witchford  Cambridgeshire  CB6 2HY           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         NH Research                                  
+7EE000-7EEFFF                 (base 16)                     NH Research                                  
+                                                            16601 Hale Ave.                              
+                                                            Irvine  CA  92606                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Intelleflex Corporation                      
+813000-813FFF                 (base 16)                     Intelleflex Corporation                      
+                                                            2465 Augustine Dr                            
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Acube Systems s.r.l.                         
+80D000-80DFFF                 (base 16)                     Acube Systems s.r.l.                         
+                                                            via Tabacco, 58                              
+                                                            Bassano del Grappa  Vicenza  36061           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         WR Systems, Ltd.                             
+7D4000-7D4FFF                 (base 16)                     WR Systems, Ltd.                             
+                                                            2500 Almeda Ave.                             
+                                                            Norfolk  VA  23513                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Precision MicroControl Corporation           
+7CD000-7CDFFF                 (base 16)                     Precision MicroControl Corporation           
+                                                            2075 Corte del Nogal                         
+                                                            Carlsbad  CA  92011                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         LS Elektronik AB                             
+7DD000-7DDFFF                 (base 16)                     LS Elektronik AB                             
+                                                            Avestagatan 35                               
+                                                            Spånga    163 08                             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         DIGITROL LTD                                 
+7E2000-7E2FFF                 (base 16)                     DIGITROL LTD                                 
+                                                            CORONET WAY                                  
+                                                            SWANSEA  WALES  SA6 8RH                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Meta Vision Systems Ltd.                     
+7E4000-7E4FFF                 (base 16)                     Meta Vision Systems Ltd.                     
+                                                            Oakfield House                               
+                                                            Eynsham  Oxfordshire  OX29 4TH               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         International Mining Technologies            
+7D6000-7D6FFF                 (base 16)                     International Mining Technologies            
+                                                            19 Collingwood St.                           
+                                                            Osborne Park  Western Australia  6916        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Powerlinx, Inc.                              
+7BE000-7BEFFF                 (base 16)                     Powerlinx, Inc.                              
+                                                            10901-A Roosevelt Blvd. North                
+                                                            St Petersburg  Florida  33716                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Primary Integration Encorp LLC               
+7C1000-7C1FFF                 (base 16)                     Primary Integration Encorp LLC               
+                                                            1825 Sharp Point Drive, Suite 118            
+                                                            Fort Collins  CO  80525                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Global Tel-Link                              
+7AE000-7AEFFF                 (base 16)                     Global Tel-Link                              
+                                                            6612 E. 75th Street                          
+                                                            Indianapolis  IN  46250                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         IMP Telekom                                  
+7B0000-7B0FFF                 (base 16)                     IMP Telekom                                  
+                                                            Vojkova 58                                   
+                                                            Ljubljana    1000                            
+                                                            SI                                           
+
+00-50-C2                      (hex)                         GE Security-Kampro                           
+790000-790FFF                 (base 16)                     GE Security-Kampro                           
+                                                            2F, No.8, Lane97, Wugong Rd.,                
+                                                            Hsin-Chuang City  Taipei County  248         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Giga-tronics, Inc.                           
+78C000-78CFFF                 (base 16)                     Giga-tronics, Inc.                           
+                                                            4650 Norris Canyon Road                      
+                                                            San Ramon  CA  94583                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ELMAR electronic                             
+78F000-78FFFF                 (base 16)                     ELMAR electronic                             
+                                                            Hrvatske mornarice 1F                        
+                                                            Split    21000                               
+                                                            HR                                           
+
+00-50-C2                      (hex)                         GLOBALCOM ENGINEERING SRL                    
+78E000-78EFFF                 (base 16)                     GLOBALCOM ENGINEERING SRL                    
+                                                            Via Volta 9                                  
+                                                            MORNAGO  VA  21020                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Telairity                                    
+78D000-78DFFF                 (base 16)                     Telairity                                    
+                                                            3375 Scott Blvd. #300                        
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Austco Communication Systems Pty Ltd         
+787000-787FFF                 (base 16)                     Austco Communication Systems Pty Ltd         
+                                                            40 O'Malley Street                           
+                                                            Osborne Park  Western Australia  6017        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Quantum Medical Imaging                      
+7A5000-7A5FFF                 (base 16)                     Quantum Medical Imaging                      
+                                                            2002 Orville Drive, North                    
+                                                            Ronkonkoma  NY  11779                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Enertex Bayern GmbH                          
+793000-793FFF                 (base 16)                     Enertex Bayern GmbH                          
+                                                            Erlachstrasse 13                             
+                                                            Forchheim  Bayern  91301                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ZAO NPC                                      
+79F000-79FFFF                 (base 16)                     ZAO NPC                                      
+                                                            Ostrovskogo, 65                              
+                                                            Perm  Perm region  614007                    
+                                                            RU                                           
+
+00-50-C2                      (hex)                         EID                                          
+767000-767FFF                 (base 16)                     EID                                          
+                                                            Quinta dos Medronheiros                      
+                                                            Caparica    2826-851                         
+                                                            PT                                           
+
+00-50-C2                      (hex)                         Mobilisme                                    
+76D000-76DFFF                 (base 16)                     Mobilisme                                    
+                                                            RN536, Sungwoo Starus, 189-1                 
+                                                            Sungnam-si  Gyunggi-do  463-860              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Fluid Analytics, Inc.                        
+75D000-75DFFF                 (base 16)                     Fluid Analytics, Inc.                        
+                                                            3525 SE 17th Ave.                            
+                                                            Portland  OR  97202                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+74C000-74CFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         cryptiris                                    
+73D000-73DFFF                 (base 16)                     cryptiris                                    
+                                                            235 avenue du coulins                        
+                                                            gemenos  bdr  13420                          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Sequestered Solutions                        
+72B000-72BFFF                 (base 16)                     Sequestered Solutions                        
+                                                            801 B Street                                 
+                                                            Anchorage  Alaska  99501                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         ASKI Industrie Elektronik Ges.m.b.H.         
+71E000-71EFFF                 (base 16)                     ASKI Industrie Elektronik Ges.m.b.H.         
+                                                            Irrseeblick 47                               
+                                                            4893  Zell am Moos                           
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Priority Electronics Ltd                     
+72F000-72FFFF                 (base 16)                     Priority Electronics Ltd                     
+                                                            55 Trottier Bay                              
+                                                            Winnipeg  Manitoba  R3T 3R3                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Nika Ltd                                     
+736000-736FFF                 (base 16)                     Nika Ltd                                     
+                                                            Kievskaja 14B                                
+                                                            Vinnitsa    21009                            
+                                                            UA                                           
+
+00-50-C2                      (hex)                         T.E.AM., S. A.                               
+714000-714FFF                 (base 16)                     T.E.AM., S. A.                               
+                                                            PARQUE TECNOLOGICO EDIFICIO 108              
+                                                            ZAMUDIO  BIZKAIA  48170                      
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Pasan SA                                     
+712000-712FFF                 (base 16)                     Pasan SA                                     
+                                                            Rue Jaquet-Droz 8                            
+                                                            Neuchâtel  NE  2000                          
+                                                            CH                                           
+
+00-50-C2                      (hex)                         AV SatCom AS                                 
+6F6000-6F6FFF                 (base 16)                     AV SatCom AS                                 
+                                                            Martin Linges v 25                           
+                                                            Fornebu  Bærum  1364                         
+                                                            NO                                           
+
+00-50-C2                      (hex)                         RV Technology Limited                        
+6F8000-6F8FFF                 (base 16)                     RV Technology Limited                        
+                                                            12/F, Wilson House                           
+                                                                                                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Hauch & Bach ApS                             
+705000-705FFF                 (base 16)                     Hauch & Bach ApS                             
+                                                            Femstykket 6                                 
+                                                            Lynge    3540                                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Wharton Electronics Ltd                      
+710000-710FFF                 (base 16)                     Wharton Electronics Ltd                      
+                                                            Unit 15, Thame Park Business Centre          
+                                                            Thame  Oxfordshire  OX9 3XA                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Efficient Channel Coding                     
+70A000-70AFFF                 (base 16)                     Efficient Channel Coding                     
+                                                            4830 E. 49th St.                             
+                                                            Cuyahoga Heights  Ohio  44125                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+6E2000-6E2FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+6E4000-6E4FFF                 (base 16)                     MangoDSP                                     
+                                                            Hartom 8                                     
+                                                            Jerusalem    45116                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Laser Tools & Technics Corp.                 
+6DE000-6DEFFF                 (base 16)                     Laser Tools & Technics Corp.                 
+                                                            No.121, Lane 99                              
+                                                            Hsin Chu    300                              
+                                                            TW                                           
+
+00-50-C2                      (hex)                         ADL Electronics Ltd.                         
+6D6000-6D6FFF                 (base 16)                     ADL Electronics Ltd.                         
+                                                            Bukharestskaya 31-3-85                       
+                                                            Saint-Petersburg    192071                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Sechan Electronics, Inc.                     
+6ED000-6EDFFF                 (base 16)                     Sechan Electronics, Inc.                     
+                                                            525 Furnace Hills Pike                       
+                                                            Lititz  PA  17543                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ITS Telecom                                  
+6F1000-6F1FFF                 (base 16)                     ITS Telecom                                  
+                                                            29 Hametzuda Street                          
+                                                            Azur    58001                                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         CommoDaS GmbH                                
+6B6000-6B6FFF                 (base 16)                     CommoDaS GmbH                                
+                                                            Rosengarten 10                               
+                                                            Wedel  Schlewig Holstein  22880              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Stream Processors                            
+6CB000-6CBFFF                 (base 16)                     Stream Processors                            
+                                                            455 DeGuigne Drive                           
+                                                            Sunnyvale,  CA  94085                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Schnick-Schnack-Systems GmbH                 
+6D1000-6D1FFF                 (base 16)                     Schnick-Schnack-Systems GmbH                 
+                                                            Mathias-Brüggen Str. 79                      
+                                                            Koeln    50829                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Optoplan as                                  
+6BF000-6BFFFF                 (base 16)                     Optoplan as                                  
+                                                            Haakon VII's gt. 17                          
+                                                            Trondheim    7041                            
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Nanoradio AB                                 
+6AF000-6AFFFF                 (base 16)                     Nanoradio AB                                 
+                                                            Torshamnsgatan 39                            
+                                                            Kista-Stockholm    SE-16482                  
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Access Specialties, Inc                      
+687000-687FFF                 (base 16)                     Access Specialties, Inc                      
+                                                            10255 Inver Grove Trail                      
+                                                            Inver Grove Heights  MN  55077               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Datamars SA                                  
+685000-685FFF                 (base 16)                     Datamars SA                                  
+                                                            via ai Prati                                 
+                                                            Bedano  Ticino  6930                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         MEGGITT Safety System                        
+683000-683FFF                 (base 16)                     MEGGITT Safety System                        
+                                                            1915 Voyager Avenue                          
+                                                            Simi Valley  Ca.  93063-3349                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Victory Concept Industries Ltd.              
+6A6000-6A6FFF                 (base 16)                     Victory Concept Industries Ltd.              
+                                                            4/F., CAC Tower                              
+                                                            Kwun Tong  Kowloon                           
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Cadi Scientific Pte Ltd                      
+6A2000-6A2FFF                 (base 16)                     Cadi Scientific Pte Ltd                      
+                                                            31 Ubi Road 1 Aztech Building                
+                                                            Singapore    408694                          
+                                                            SG                                           
+
+00-50-C2                      (hex)                         TELETASK                                     
+6A4000-6A4FFF                 (base 16)                     TELETASK                                     
+                                                            Ottergemsesteenweg-Zuid 729                  
+                                                            GENT  Ooost-Vlaanderen  9000                 
+                                                            BE                                           
+
+00-50-C2                      (hex)                         PRICOL LIMITED                               
+6A1000-6A1FFF                 (base 16)                     PRICOL LIMITED                               
+                                                            7-1-59/4, TURNING POINT COMPLEX              
+                                                            HYDERABAD  ANDHRA PRADESH  500016            
+                                                            IN                                           
+
+00-50-C2                      (hex)                         SIMTEK INC.                                  
+68B000-68BFFF                 (base 16)                     SIMTEK INC.                                  
+                                                            1505 ROYAL PARKWAY                           
+                                                            EULESS  TEXAS  76040                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Isochron Inc                                 
+68C000-68CFFF                 (base 16)                     Isochron Inc                                 
+                                                            11044 Research Blvd                          
+                                                            Austin  TX  78759                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dvation.co.,Ltd                              
+69D000-69DFFF                 (base 16)                     Dvation.co.,Ltd                              
+                                                            Room506,5F Solive Bldg,333-2                 
+                                                            SEOUL    153-010                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         StoreTech Limited                            
+69A000-69AFFF                 (base 16)                     StoreTech Limited                            
+                                                            73 - 75 Upper Richmond Road                  
+                                                            Putney  London  SW15 2SR                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SAIA Burgess Controls AG                     
+67E000-67EFFF                 (base 16)                     SAIA Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Tech Comm, Inc.                              
+693000-693FFF                 (base 16)                     Tech Comm, Inc.                              
+                                                            5010 No. Hiatus Road                         
+                                                            Sunrise  FL  33351                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Invocon, Inc.                                
+65F000-65FFFF                 (base 16)                     Invocon, Inc.                                
+                                                            19221 IH-45 South Ste. 530                   
+                                                            Conroe  TX  77385                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ferrari electronic AG                        
+673000-673FFF                 (base 16)                     Ferrari electronic AG                        
+                                                            Ruhlsdorfer Str. 138                         
+                                                            TELTOW    14513                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Naim Audio                                   
+670000-670FFF                 (base 16)                     Naim Audio                                   
+                                                            Southampton Road                             
+                                                            Salisbury  Wiltshire  SP1 2LN                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Sparton Electronics                          
+67B000-67BFFF                 (base 16)                     Sparton Electronics                          
+                                                            2400 East Ganson Street                      
+                                                            Jackson  MI  49202                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Liquid Breaker, LLC                          
+650000-650FFF                 (base 16)                     Liquid Breaker, LLC                          
+                                                            2221 Rutherford Rd.                          
+                                                            Carlsbad  California  92008                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         MA Lighting Technology GmbH                  
+64F000-64FFFF                 (base 16)                     MA Lighting Technology GmbH                  
+                                                            Dachdeckerstr. 16                            
+                                                            Waldbuettelbrunn  Bayern  97297              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Northern Power                               
+64E000-64EFFF                 (base 16)                     Northern Power                               
+                                                            182 Mad River Park                           
+                                                            Waitsfield  VT  05673                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+64B000-64BFFF                 (base 16)                     MangoDSP                                     
+                                                            Hartom 8                                     
+                                                            Jerusalem    45116                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Stanton Technologies Sdn Bhd                 
+642000-642FFF                 (base 16)                     Stanton Technologies Sdn Bhd                 
+                                                            Suite 3, 4th Floor, NB Place,                
+                                                            Penang    10350                              
+                                                            MY                                           
+
+00-50-C2                      (hex)                         dPict Imaging, Inc.                          
+63C000-63CFFF                 (base 16)                     dPict Imaging, Inc.                          
+                                                            3815 River Crossing Pkwy                     
+                                                            Indianapolis  IN  46240                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Qstreams Networks Inc.                       
+639000-639FFF                 (base 16)                     Qstreams Networks Inc.                       
+                                                            2301 Dorsey Rd.                              
+                                                            Glen Burnie  MD  21061                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         AirMatrix, Inc.                              
+62C000-62CFFF                 (base 16)                     AirMatrix, Inc.                              
+                                                            12775 LBJ Drive                              
+                                                            Brenham  Texas  77833                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         CPqD                                         
+64A000-64AFFF                 (base 16)                     CPqD                                         
+                                                            Rod. SP-340 Campinas Mogi-Mirim              
+                                                            Campinas  SP  13086902                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         STAER SPA                                    
+651000-651FFF                 (base 16)                     STAER SPA                                    
+                                                            VIA TIBURTINA,1266                           
+                                                            ROMA    00131                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         TDM Ingénierie                               
+62E000-62EFFF                 (base 16)                     TDM Ingénierie                               
+                                                            6 av H. Becquerel                            
+                                                            Mérignac  Aquitaine  33700                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         NARINET, INC.                                
+617000-617FFF                 (base 16)                     NARINET, INC.                                
+                                                            Dept of Comp. Eng. CNU                       
+                                                            Daejeon    305-764                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         MacDonald Humfrey (Products) Ltd             
+629000-629FFF                 (base 16)                     MacDonald Humfrey (Products) Ltd             
+                                                            Progress Manor,                              
+                                                            Luton  Beds  LU13HY                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         JungleSystem Co., Ltd.                       
+627000-627FFF                 (base 16)                     JungleSystem Co., Ltd.                       
+                                                            4F Naewae Bldg.382-5                         
+                                                            Sungnam  Gyeonggi  463-827                   
+                                                            KR                                           
+
+00-50-C2                      (hex)                         SAFELINE SL                                  
+623000-623FFF                 (base 16)                     SAFELINE SL                                  
+                                                            EDIFICIO SAFELINE                            
+                                                            MATARO  BARCELONA  08302                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         TestPro Systems, Inc.                        
+61C000-61CFFF                 (base 16)                     TestPro Systems, Inc.                        
+                                                            2119 Metro Circle                            
+                                                            Huntsville  Alabama  35801                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         2N TELEKOMUNIKACE a.s.                       
+622000-622FFF                 (base 16)                     2N TELEKOMUNIKACE a.s.                       
+                                                            Modranska 621                                
+                                                            Prague    143 01                             
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Silex Industrial Automation Ltd.             
+608000-608FFF                 (base 16)                     Silex Industrial Automation Ltd.             
+                                                            Gyepsor u. 1.                                
+                                                            Budapest  Pest megye  1211                   
+                                                            HU                                           
+
+00-50-C2                      (hex)                         MEG Electronic Inc.                          
+5FD000-5FDFFF                 (base 16)                     MEG Electronic Inc.                          
+                                                            Bogazici Universitesi Kuzey Kampus           
+                                                            Bebek  Besiktas                              
+                                                            TR                                           
+
+00-50-C2                      (hex)                         Gazelle Monitoring Systems                   
+5FF000-5FFFFF                 (base 16)                     Gazelle Monitoring Systems                   
+                                                            Level 11, Tower B, 821 Pacific Hwy           
+                                                            Chatswood  NSW  2067                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         LEA d.o.o.                                   
+5FA000-5FAFFF                 (base 16)                     LEA d.o.o.                                   
+                                                            Finzgarjeva ulica 1a                         
+                                                            Lesce    4248                                
+                                                            SI                                           
+
+00-50-C2                      (hex)                         FilmLight Limited                            
+5FC000-5FCFFF                 (base 16)                     FilmLight Limited                            
+                                                            14-15 Manette Street                         
+                                                            London    W1D 4AP                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         TeamProjects BV                              
+5F4000-5F4FFF                 (base 16)                     TeamProjects BV                              
+                                                            Zonnebaan 42                                 
+                                                            Utrecht    3542 EG                           
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Technomarine JSC                             
+5F1000-5F1FFF                 (base 16)                     Technomarine JSC                             
+                                                            3, Gapsalskaja Str.                          
+                                                            Saint-Petersburg    198035                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Radiant Imaging, Inc.                        
+5C5000-5C5FFF                 (base 16)                     Radiant Imaging, Inc.                        
+                                                            15321 Main St NE, Suite 310                  
+                                                            Duvall  WA  98019                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Buyang Electronics Industrial Co., Ltd.      
+5E4000-5E4FFF                 (base 16)                     Buyang Electronics Industrial Co., Ltd.      
+                                                            434-140 Oryu-Dong                            
+                                                            Incheon    404-300                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Syntronic AB                                 
+5B2000-5B2FFF                 (base 16)                     Syntronic AB                                 
+                                                            Utmarksvagen 33C                             
+                                                            Gavle    802 91                              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Transenna AB                                 
+5AA000-5AAFFF                 (base 16)                     Transenna AB                                 
+                                                            Roslinvagen 48                               
+                                                            Bromma  Stockholm  SE-16851                  
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ProMik GmbH                                  
+5C4000-5C4FFF                 (base 16)                     ProMik GmbH                                  
+                                                            Suedwestpark 100                             
+                                                            Nuernberg  Bayern  90449                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+59F000-59FFFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            US                                           
+
+00-50-C2                      (hex)                         Taiwan Video & Monitor                       
+5B9000-5B9FFF                 (base 16)                     Taiwan Video & Monitor                       
+                                                            3F, 141 Jen Ai Rd Sec. 3                     
+                                                            Taipei City    106                           
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Rosta Ltd                                    
+5B1000-5B1FFF                 (base 16)                     Rosta Ltd                                    
+                                                            Office 17,                                   
+                                                            Moscow    123103                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Broadlight                                   
+593000-593FFF                 (base 16)                     Broadlight                                   
+                                                            7 Begin st                                   
+                                                            Ramat Gan    52521                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Grosvenor Technology Ltd                     
+591000-591FFF                 (base 16)                     Grosvenor Technology Ltd                     
+                                                            Millars Three                                
+                                                            Bishop's Stortford  Hertfordshire  CM23 3DH  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Ingeniería Almudí S.L.                      
+574000-574FFF                 (base 16)                     Ingeniería Almudí S.L.                      
+                                                            c/ San Luis, 8 bajo 1ş                       
+                                                            Murcia  Alcantarilla  30820                  
+                                                            ES                                           
+
+00-50-C2                      (hex)                         MultiTrode Pty Ltd                           
+59A000-59AFFF                 (base 16)                     MultiTrode Pty Ltd                           
+                                                            18 Brandl Street                             
+                                                            Brisbane  QLD  4113                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Orderite, Inc.                               
+57F000-57FFFF                 (base 16)                     Orderite, Inc.                               
+                                                            P. O. Box 48004                              
+                                                            Athens  GA  30604                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         XoIP Systems Pty Ltd                         
+58F000-58FFFF                 (base 16)                     XoIP Systems Pty Ltd                         
+                                                            Unit 17, 538 Gardeners Rd                    
+                                                            Alexandria  NSW  2015                        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         DATAMICRO Co., Ltd.                          
+573000-573FFF                 (base 16)                     DATAMICRO Co., Ltd.                          
+                                                            P.O. Box 17                                  
+                                                            Taganrog  Rostov Region  347916              
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Digital Way                                  
+57E000-57EFFF                 (base 16)                     Digital Way                                  
+                                                            1 Chemin des CHAUX                           
+                                                            Saint-Etienne  Loire  42000                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         SOLYSTIC                                     
+575000-575FFF                 (base 16)                     SOLYSTIC                                     
+                                                            14 Avenue de Raspail                         
+                                                            GENTILLY Cedex  Val de Marne  94257          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         WORKPOWER TECNOLOGIA ELETRONICA LTDA-EPP     
+565000-565FFF                 (base 16)                     WORKPOWER TECNOLOGIA ELETRONICA LTDA-EPP     
+                                                            RUA OTAVIO PASSOS, 132                       
+                                                            São Paulo  SP  05590-190                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         ORTRAT, S.L.                                 
+563000-563FFF                 (base 16)                     ORTRAT, S.L.                                 
+                                                            Calle de la Sófora 15                        
+                                                            E-28020  Madrid                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Last Mile Gear                               
+564000-564FFF                 (base 16)                     Last Mile Gear                               
+                                                            1324 Vandercook Way                          
+                                                            Longview  WA  98632                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Moog Broad Reach                             
+55F000-55FFFF                 (base 16)                     Moog Broad Reach                             
+                                                            1113 Washington Ave #200                     
+                                                            Golden  CO  80401                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         GeoFocus, LLC                                
+568000-568FFF                 (base 16)                     GeoFocus, LLC                                
+                                                            3651 FAU Blvd., Suite 215                    
+                                                            Boca Raton  FL  33431                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bedo Elektronik GmbH                         
+558000-558FFF                 (base 16)                     Bedo Elektronik GmbH                         
+                                                            Ennsstrasse 19                               
+                                                            Krefeld  NRW  47809                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         C21 Systems Limited                          
+562000-562FFF                 (base 16)                     C21 Systems Limited                          
+                                                            Dunston Innovation Centre                    
+                                                            Chesterfield  Derbyshire  S41 8NG            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Valtronic SA                                 
+54F000-54FFFF                 (base 16)                     Valtronic SA                                 
+                                                            Rue de Bon Port                              
+                                                            Les Charbonničres  Vaud  1343                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Hyundai J. Comm                              
+534000-534FFF                 (base 16)                     Hyundai J. Comm                              
+                                                            254-1, Makok-Ri, Hopub-Myoun                 
+                                                            Ichun-Si  Kyungki-Do  467-820                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         MMS Servis s.r.o.                            
+535000-535FFF                 (base 16)                     MMS Servis s.r.o.                            
+                                                            Hodzova 261/1                                
+                                                            Myjava  Slovak Republic  907 01              
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Smartcom-Bulgaria AD                         
+52D000-52DFFF                 (base 16)                     Smartcom-Bulgaria AD                         
+                                                            Office 414A, BIC IZOT Building 1             
+                                                              SOFIA  1784                                
+                                                            BG                                           
+
+00-50-C2                      (hex)                         OMNITRONICS PTY LTD                          
+52A000-52AFFF                 (base 16)                     OMNITRONICS PTY LTD                          
+                                                            15 HECTOR STREET                             
+                                                            OSBORNE PARK  WESTERN AUSTRALIA  6017        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Digital communications Technologies          
+53D000-53DFFF                 (base 16)                     Digital communications Technologies          
+                                                            5201 Blue Lagoon Dr.  #843                   
+                                                            Miami  Florida  33126                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         EtherTek Circuits                            
+538000-538FFF                 (base 16)                     EtherTek Circuits                            
+                                                            #38 - 473 Corina Ave.                        
+                                                            Princeton  British Columbia  V0X1W0          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         WAVES SYSTEM                                 
+541000-541FFF                 (base 16)                     WAVES SYSTEM                                 
+                                                            La Ville en Bois                             
+                                                            BOUAYE  Loire Atlantique  44830              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Polystar Instruments AB                      
+50F000-50FFFF                 (base 16)                     Polystar Instruments AB                      
+                                                            Mårbackagatan 19                             
+                                                            Stockholm    11559                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Beta Lasermike Ltd                           
+51B000-51BFFF                 (base 16)                     Beta Lasermike Ltd                           
+                                                            Stirling Road                                
+                                                            High Wycombe  Bucks  HP12 3RT                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SOWA ELECTRIC CO., LTD.                      
+516000-516FFF                 (base 16)                     SOWA ELECTRIC CO., LTD.                      
+                                                            92 Kitanokuchi-cho Shimotoba                 
+                                                            Kyoto-City    612-8392                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+529000-529FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AC SYSTEMS, s.r.o.                           
+526000-526FFF                 (base 16)                     AC SYSTEMS, s.r.o.                           
+                                                            Srobarova 3                                  
+                                                            Praha 3    130 00                            
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         BES Technology Group                         
+4FB000-4FBFFF                 (base 16)                     BES Technology Group                         
+                                                            3080 Olcott str ste 205a                     
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cambridge Technology, Inc.                   
+4FA000-4FAFFF                 (base 16)                     Cambridge Technology, Inc.                   
+                                                            25 Hartwell Ave                              
+                                                            Lexington  MA  02421-3102                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Monroe Electronics, Inc.                     
+4F5000-4F5FFF                 (base 16)                     Monroe Electronics, Inc.                     
+                                                            100 Housel Avenue                            
+                                                            Lyndonville  NY  14098                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         O2RUN                                        
+4F4000-4F4FFF                 (base 16)                     O2RUN                                        
+                                                            8F/Hagye Techno Town.,250-3,Hagye-dong,Nowon-gu
+                                                            SEOUL    139-727                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Logic Beach Inc                              
+50B000-50BFFF                 (base 16)                     Logic Beach Inc                              
+                                                            8363-6F Center Drive                         
+                                                            La Mesa  CA  91942                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Hillcrest Laboratories, Inc.                 
+509000-509FFF                 (base 16)                     Hillcrest Laboratories, Inc.                 
+                                                            15245 Shady Grove Road                       
+                                                            Rockville  Maryland  20850                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Packet Island Inc.                           
+4F1000-4F1FFF                 (base 16)                     Packet Island Inc.                           
+                                                            2332B Walsh Ave                              
+                                                            Santa Clara  California  95051               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mandozzi Elettronica SA                      
+4EB000-4EBFFF                 (base 16)                     Mandozzi Elettronica SA                      
+                                                            Via Volta 2                                  
+                                                            Ponte Capriasca    6946                      
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Criterion Systems Limited                    
+502000-502FFF                 (base 16)                     Criterion Systems Limited                    
+                                                            Criterion House                              
+                                                            Stockport  Cheshire  SK1 1YH                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Movaz Networks, Inc.                         
+4C1000-4C1FFF                 (base 16)                     Movaz Networks, Inc.                         
+                                                            One Technology Parkway South                 
+                                                            Norcross  GA  30092                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Argon ST                                     
+4BD000-4BDFFF                 (base 16)                     Argon ST                                     
+                                                            8419 Terminal Road                           
+                                                            Newington  VA  22122                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital Dynamics, Inc.                       
+4BE000-4BEFFF                 (base 16)                     Digital Dynamics, Inc.                       
+                                                            5 Victor Square                              
+                                                            Scotts Valley  CA  95066                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Rubin Ltd.                                   
+4C6000-4C6FFF                 (base 16)                     Rubin Ltd.                                   
+                                                            Egressy St. 17.                              
+                                                            Budapest  Budapest  H-1149                   
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Black Diamond Video, Inc.                    
+4C4000-4C4FFF                 (base 16)                     Black Diamond Video, Inc.                    
+                                                            1151 Harbor Bay Parkway Suite 101            
+                                                            Alameda  CA  94502                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Quantum3D, Inc.                              
+4C3000-4C3FFF                 (base 16)                     Quantum3D, Inc.                              
+                                                            6330 San Ignacio Avenue                      
+                                                            San Jose  CA  95051                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Embigence GmbH                               
+4E4000-4E4FFF                 (base 16)                     Embigence GmbH                               
+                                                            Goethestrasse 52                             
+                                                            Ladbergen  NRW  49549                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Verint Systems Ltd                           
+4CB000-4CBFFF                 (base 16)                     Verint Systems Ltd                           
+                                                            23 Habarzel St.                              
+                                                            Tel Aviv    69710                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         SEBA Design Pty Ltd                          
+4D5000-4D5FFF                 (base 16)                     SEBA Design Pty Ltd                          
+                                                            164 Princes Highway                          
+                                                            Dandenong  VIC  3175                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Orbis Oy                                     
+4AF000-4AFFFF                 (base 16)                     Orbis Oy                                     
+                                                            Taivaltie 5                                  
+                                                            Vantaa    01610                              
+                                                            FI                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+4AE000-4AEFFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GCS, Inc                                     
+49F000-49FFFF                 (base 16)                     GCS, Inc                                     
+                                                            2665 Pine Grove Rd.                          
+                                                            Cumming  Georgia  30041                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dese Technologies SL                         
+312000-312FFF                 (base 16)                     Dese Technologies SL                         
+                                                            Av. Benjamin Franklin 12 , Edif CEEI         
+                                                            Paterna  Valencia  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Advanced technologies & Engineering (pty) Ltd
+4A0000-4A0FFF                 (base 16)                     Advanced technologies & Engineering (pty) Ltd
+                                                            998 16 th Road                               
+                                                            Midrand  Gauteng                             
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         IEEE P1609 WG                                
+4A4000-4A4FFF                 (base 16)                     IEEE P1609 WG                                
+                                                            3800 N Fairfax Drive #207                    
+                                                            Arlington  VA  22203-1759                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mistletoe Technologies                       
+4BA000-4BAFFF                 (base 16)                     Mistletoe Technologies                       
+                                                            20450 Stevens Creek Blvd. Suite 200          
+                                                            Cupertino  CA  95014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Protium Technologies, Inc.                   
+4A3000-4A3FFF                 (base 16)                     Protium Technologies, Inc.                   
+                                                            10 Bearfoot Rd.                              
+                                                            Northborough  MA  01532                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         AUCONET GmbH                                 
+47C000-47CFFF                 (base 16)                     AUCONET GmbH                                 
+                                                            Rudower Chaussee 31                          
+                                                              Berlin  12489                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         UNITON AG                                    
+48C000-48CFFF                 (base 16)                     UNITON AG                                    
+                                                            Pumpwerkstrasse 18                           
+                                                            Regensdorf  ZH  8105                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Mobile Matrix, Inc.                          
+48A000-48AFFF                 (base 16)                     Mobile Matrix, Inc.                          
+                                                            125 Half Mile Road                           
+                                                            Red Bank  New Jersey  07701                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+48B000-48BFFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            US                                           
+
+00-50-C2                      (hex)                         Teledyne Tekmar                              
+48E000-48EFFF                 (base 16)                     Teledyne Tekmar                              
+                                                            4736 Socialville Foster Rd                   
+                                                            Mason  Ohio  45040                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         DENGYOSHA co.,LTD.                           
+48F000-48FFFF                 (base 16)                     DENGYOSHA co.,LTD.                           
+                                                            7-17, Midorigaoka 3 Tyome                    
+                                                            Hamura-shi  Tokyo  205-0003                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Ultimate Technology, Inc.                    
+494000-494FFF                 (base 16)                     Ultimate Technology, Inc.                    
+                                                            30 Waverly St.                               
+                                                            Taunton  MA  02780-1460                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         BRIT Inc.                                    
+47F000-47FFFF                 (base 16)                     BRIT Inc.                                    
+                                                            703, Aves Bld,1452 Dunsan-Dong               
+                                                            Seo-ku  Daejeon  302-120                     
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Envisacor Technologies Inc.                  
+49C000-49CFFF                 (base 16)                     Envisacor Technologies Inc.                  
+                                                            237 Romina Drive                             
+                                                            Concord  Ontario  L4K 4V3                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         SES                                          
+483000-483FFF                 (base 16)                     SES                                          
+                                                            35-39 avenue du Danemark                     
+                                                            Tours Cedex 2    37072                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         KOP Ltd                                      
+472000-472FFF                 (base 16)                     KOP Ltd                                      
+                                                            Howe Moss Ave                                
+                                                            Aberdeen  Scotland  AB21 0NA                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Neuroware                                    
+46F000-46FFFF                 (base 16)                     Neuroware                                    
+                                                            6726 Golden Hills Way                        
+                                                            Mississauga  Ontario  L5W1P1                 
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Ascon S.p.a.                                 
+476000-476FFF                 (base 16)                     Ascon S.p.a.                                 
+                                                            Via Falzarego 9/11                           
+                                                            Bollate  Milano  20021                       
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Metafix Inc.                                 
+478000-478FFF                 (base 16)                     Metafix Inc.                                 
+                                                            1925, 46 th. Avenue                          
+                                                            Lachine  Quebec  H8T 2P1                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         SEV Tidsystem AB                             
+477000-477FFF                 (base 16)                     SEV Tidsystem AB                             
+                                                            Box 121                                      
+                                                            Västerhaninge  Stockholm  137 22             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Codem Systems, Inc.                          
+463000-463FFF                 (base 16)                     Codem Systems, Inc.                          
+                                                            7 Executive Park Drive                       
+                                                            Merrimack  NH  03054                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Deister Electronic GmbH                      
+45C000-45CFFF                 (base 16)                     Deister Electronic GmbH                      
+                                                            Hermann-Bahlsen-Str. 11                      
+                                                            Barsinghausen  Niedersachsen  30890          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Matra Electronique                           
+45B000-45BFFF                 (base 16)                     Matra Electronique                           
+                                                            6, rue Ferdinand Meunier                     
+                                                            La Croix St Ouen  Oise  60610                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Danbridge                                    
+457000-457FFF                 (base 16)                     Danbridge                                    
+                                                            Hirsemarken 5                                
+                                                            Farum    DK-3520                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Pico Computing, Inc.                         
+442000-442FFF                 (base 16)                     Pico Computing, Inc.                         
+                                                            9747 Businesspark Ave.                       
+                                                            San Diego  CA  92131                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Offshore Systems Ltd                         
+444000-444FFF                 (base 16)                     Offshore Systems Ltd                         
+                                                            107 - 930 West 1st Street                    
+                                                            North Vancouver  B.C.  V7P 3N4               
+                                                            CA                                           
+
+00-50-C2                      (hex)                         MICRONIC s.r.o.                              
+445000-445FFF                 (base 16)                     MICRONIC s.r.o.                              
+                                                            Trebejov 41                                  
+                                                            Kysak  Kosice okolie  044 81                 
+                                                            SK                                           
+
+00-50-C2                      (hex)                         BLEILE DATENTECHNIK GmbH                     
+449000-449FFF                 (base 16)                     BLEILE DATENTECHNIK GmbH                     
+                                                            AM KREBSBACH 2                               
+                                                            IHRINGEN    D-79241                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sammi Information Systems Co.,Ltd            
+441000-441FFF                 (base 16)                     Sammi Information Systems Co.,Ltd            
+                                                            103-15, Galwor-dong, Yongsan-gu              
+                                                            Seoul    140-807                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ARVOO Imaging Products BV                    
+43F000-43FFFF                 (base 16)                     ARVOO Imaging Products BV                    
+                                                            Tasveld 13                                   
+                                                            Montfoort  UT  3417 XS                       
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Telecom Protection Technologies Limited      
+438000-438FFF                 (base 16)                     Telecom Protection Technologies Limited      
+                                                            Unit 1A, Garden Close                        
+                                                            Plymouth  Devon  PL7 5EU                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Pinnacle Technology                          
+425000-425FFF                 (base 16)                     Pinnacle Technology                          
+                                                            619 E. 8th street suite D                    
+                                                            Lawrence  KS  66044                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Avionica, Inc                                
+41F000-41FFFF                 (base 16)                     Avionica, Inc                                
+                                                            9941 W. Jessamine St                         
+                                                            Miami  FL  33157                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         BIR,INC.                                     
+40F000-40FFFF                 (base 16)                     BIR,INC.                                     
+                                                            425 BARCLAY BLVD                             
+                                                            LINCOLNSHIRE  IL  60069                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Multimessage Systems Ltd.                    
+411000-411FFF                 (base 16)                     Multimessage Systems Ltd.                    
+                                                            Units 1 / 2, Cranbourne Ind. Est.            
+                                                            Potters Bar  Hertfordshire  EN6 3JH          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Boundless Technologies                       
+420000-420FFF                 (base 16)                     Boundless Technologies                       
+                                                            100 Marcus Blvd                              
+                                                            Hauppauge  NY  11788                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Metrolab Technology SA                       
+424000-424FFF                 (base 16)                     Metrolab Technology SA                       
+                                                            ch. du Pont-du-Centenaire 110                
+                                                            Plan-les-Ouates  Genève  1228                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Oelmann Elektronik GmbH                      
+42E000-42EFFF                 (base 16)                     Oelmann Elektronik GmbH                      
+                                                            Allerfeldstr. 17                             
+                                                            Springe  Niedersachsen  31832                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SensoTech GmbH                               
+415000-415FFF                 (base 16)                     SensoTech GmbH                               
+                                                            Steinfeldstr. 3                              
+                                                            Magdeburg-Barleben  Sachsen-Anhalt  39179    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Talleres de Escoriaza SA                     
+414000-414FFF                 (base 16)                     Talleres de Escoriaza SA                     
+                                                            Barrio Ventas, 35                            
+                                                            Irun  Gipuzkoa  20305                        
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Octatron, Inc.                               
+431000-431FFF                 (base 16)                     Octatron, Inc.                               
+                                                            1925 McKinley Ave.                           
+                                                            La Verne  CA  91750                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Center VOSPI JSC                             
+40B000-40BFFF                 (base 16)                     Center VOSPI JSC                             
+                                                            Obrucheva 52                                 
+                                                            Moscow    117393                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Contec Steuerungstechnik & Automation GmbH   
+40A000-40AFFF                 (base 16)                     Contec Steuerungstechnik & Automation GmbH   
+                                                            Wildbichkerstraße 2e                         
+                                                            Ebbs  Tirol  6341                            
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Afonics Fibreoptics Ltd                      
+40D000-40DFFF                 (base 16)                     Afonics Fibreoptics Ltd                      
+                                                            Unit 16,                                     
+                                                            Witney  Oxfordshire  OX28 4GW                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         The Board Room Inc.                          
+3ED000-3EDFFF                 (base 16)                     The Board Room Inc.                          
+                                                            1220 Lakeview Ct.                            
+                                                            Romeoville  IL  60446                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         nVent, Schroff GmbH                          
+3FB000-3FBFFF                 (base 16)                     nVent, Schroff GmbH                          
+                                                            Langenalber Strasse 96-100                   
+                                                            Straubenhardt    75334                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CRDE                                         
+3E6000-3E6FFF                 (base 16)                     CRDE                                         
+                                                            ZI DES GRANDS CAMPS                          
+                                                            MERCUES  LOT  46090                          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CUE, a.s.                                    
+3E4000-3E4FFF                 (base 16)                     CUE, a.s.                                    
+                                                            K Nouzovu 2090/6                             
+                                                            Praha 4    143 00                            
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         AIE Etudes                                   
+407000-407FFF                 (base 16)                     AIE Etudes                                   
+                                                            2 rue du Charles DE GAULLE                   
+                                                            27220  PREY                                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         SmartMotor AS                                
+400000-400FFF                 (base 16)                     SmartMotor AS                                
+                                                            Stiklestadveien 1                            
+                                                            Trondheim  Sør-Trøndelag  7041               
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Numeron Sp. z o.o.                           
+402000-402FFF                 (base 16)                     Numeron Sp. z o.o.                           
+                                                            Bronislawa Czecha 16                         
+                                                            Czestochowa    42-200                        
+                                                            PL                                           
+
+00-50-C2                      (hex)                         BiODE Inc.                                   
+3DF000-3DFFFF                 (base 16)                     BiODE Inc.                                   
+                                                            100 Larrabee Rd.                             
+                                                            Westbrook  ME  04092                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Osmetech Inc.                                
+3DB000-3DBFFF                 (base 16)                     Osmetech Inc.                                
+                                                            235 Hembree Park Drive                       
+                                                            Roswell  GA  30076                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ELMIC GmbH                                   
+3DD000-3DDFFF                 (base 16)                     ELMIC GmbH                                   
+                                                            Grabenstr. 149a                              
+                                                            Duisburg  NRW  47057                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         M5 Data Limited                              
+3DA000-3DAFFF                 (base 16)                     M5 Data Limited                              
+                                                            Mendip Court                                 
+                                                            Wells  Somerset  BA5 3DG                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Fluke Biomedical, Radiation Management Services
+3D5000-3D5FFF                 (base 16)                     Fluke Biomedical, Radiation Management Services
+                                                            6045 Cochran Rd.                             
+                                                            Solon  Ohio  44139                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Adilec Enginyeria SL                         
+3D2000-3D2FFF                 (base 16)                     Adilec Enginyeria SL                         
+                                                            Francesc Macia, 1                            
+                                                            Molins de Rei  Barcelona  08750              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         TTC TELEKOMUNIKACE Ltd                       
+3D7000-3D7FFF                 (base 16)                     TTC TELEKOMUNIKACE Ltd                       
+                                                            Tøebohostická  987/5, Prague 10              
+                                                            Prague    CZ-100 00                          
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Ward Leonard Electric Company                
+3CE000-3CEFFF                 (base 16)                     Ward Leonard Electric Company                
+                                                            401 Watertown Road                           
+                                                            Thomaston  CT  06787                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         MicroTek Electronics, Inc.                   
+3C1000-3C1FFF                 (base 16)                     MicroTek Electronics, Inc.                   
+                                                            1020 Calle Cordillera, #105                  
+                                                            San Clemente  CA  92673                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bigbang L.T.D.                               
+3BD000-3BDFFF                 (base 16)                     Bigbang L.T.D.                               
+                                                            Shikahama 8-7-18                             
+                                                            Adachi  Tokyo  123-0864                      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Isensix                                      
+39F000-39FFFF                 (base 16)                     Isensix                                      
+                                                            8555 Aero Dr Suite 201                       
+                                                            San Diego  CA  92111                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Hankuk Tapi Computer Co., Ltd                
+3AE000-3AEFFF                 (base 16)                     Hankuk Tapi Computer Co., Ltd                
+                                                            357-1, Jangdae-Dong, Yusung-Gu               
+                                                            Daejeon    305-308                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Norbit ODM AS                                
+3AF000-3AFFFF                 (base 16)                     Norbit ODM AS                                
+                                                            Stiklestadveien 1                            
+                                                            Trondheim    7041                            
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Microtarget Tecnologia Digital Ltda.         
+3B0000-3B0FFF                 (base 16)                     Microtarget Tecnologia Digital Ltda.         
+                                                            Rua Eng. Mesquita Sampaio, 54-FDS            
+                                                            São Paulo    04711-000                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         StreetFire Sound Labs, LLC                   
+3A0000-3A0FFF                 (base 16)                     StreetFire Sound Labs, LLC                   
+                                                            795 Folsom St., First Floor                  
+                                                            San Francisco  CA  94107                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Contrôle Analytique inc.                     
+3B4000-3B4FFF                 (base 16)                     Contrôle Analytique inc.                     
+                                                            1076 rue Johnson                             
+                                                            Thetford Mines  Québec  G6G 5W6              
+                                                            CA                                           
+
+00-50-C2                      (hex)                         LabJack Corporation                          
+3A5000-3A5FFF                 (base 16)                     LabJack Corporation                          
+                                                            3232 S Vance St STE 100                      
+                                                            Lakewood  CO  80227                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Specstroy-Svyaz Ltd                          
+3B1000-3B1FFF                 (base 16)                     Specstroy-Svyaz Ltd                          
+                                                            Bolshaya Bulvarnaya Street 13-26             
+                                                            Taganrog    347913                           
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Ni.Co. S.r.l.                                
+37E000-37EFFF                 (base 16)                     Ni.Co. S.r.l.                                
+                                                            C.so Torino, 91/B                            
+                                                            Buttigliera Alta  Torino  10090              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         IDA Corporation                              
+37A000-37AFFF                 (base 16)                     IDA Corporation                              
+                                                            1345 Main Ave                                
+                                                            Fargo  North Dakota  58103                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Colorado vNet                                
+382000-382FFF                 (base 16)                     Colorado vNet                                
+                                                            255 East 6th Street                          
+                                                            Loveland  Colorado  80537                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         A&G Soluzioni Digitali                       
+38D000-38DFFF                 (base 16)                     A&G Soluzioni Digitali                       
+                                                            Palazzo S.Elisabetta                         
+                                                            Livorno  LI  57126                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Inoteska s.r.o.                              
+387000-387FFF                 (base 16)                     Inoteska s.r.o.                              
+                                                            Podturen-Roven 221                           
+                                                            Liptovsky Hradok  Zilina region  033 01      
+                                                            SK                                           
+
+00-50-C2                      (hex)                         North Pole Engineering, Inc.                 
+34F000-34FFFF                 (base 16)                     North Pole Engineering, Inc.                 
+                                                            221 N. 1st. St., Suite 310                   
+                                                            Minneapolis  MN  55401                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Minerva Technology Inc                       
+36B000-36BFFF                 (base 16)                     Minerva Technology Inc                       
+                                                            645 Island Rd                                
+                                                            Victoria  BC  V8S2T7                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         VPG                                          
+365000-365FFF                 (base 16)                     VPG                                          
+                                                            Box 423                                      
+                                                            Karlskoga    SE-691 27                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Always On Wireless                           
+369000-369FFF                 (base 16)                     Always On Wireless                           
+                                                            410 Pierce                                   
+                                                            Houston  TX  77002                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         BMK professional electronics GmbH            
+34D000-34DFFF                 (base 16)                     BMK professional electronics GmbH            
+                                                            Werner-von-Siemens-Str. 6                    
+                                                            Augsburg  Bavaria  86156                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Novx Systems                                 
+341000-341FFF                 (base 16)                     Novx Systems                                 
+                                                            Suite 100                                    
+                                                            Richmond Hill  Ontario  L4B 4N1              
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ALCEA                                        
+358000-358FFF                 (base 16)                     ALCEA                                        
+                                                            3 Rue Joly de Bammeville                     
+                                                            91460  Marcoussis                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         IHM                                          
+355000-355FFF                 (base 16)                     IHM                                          
+                                                            Vandtaarnsvej 87                             
+                                                            Soborg  Copenhagen  2860                     
+                                                            DK                                           
+
+00-50-C2                      (hex)                         AZD Praha s.r.o.                             
+362000-362FFF                 (base 16)                     AZD Praha s.r.o.                             
+                                                            Zirovnicka 2/3146                            
+                                                            Prague    106 17                             
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         NetTest A/S                                  
+35D000-35DFFF                 (base 16)                     NetTest A/S                                  
+                                                            Kirkebjerg Alle 90                           
+                                                            Brondby  CPH  2605                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         MANUSA-GEST, S.L.                            
+32E000-32EFFF                 (base 16)                     MANUSA-GEST, S.L.                            
+                                                            Avinguda Via Augusta, 71-73                  
+                                                            Sant Cugat del Valles  Barcelona  08174      
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Picture Elements, Inc.                       
+334000-334FFF                 (base 16)                     Picture Elements, Inc.                       
+                                                            777 Panoramic Way                            
+                                                            Berkeley  CA  94704                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nimcat Networks                              
+335000-335FFF                 (base 16)                     Nimcat Networks                              
+                                                            1135 Innovation Drive                        
+                                                            Ottawa  Ontario  K2K 3G7                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Casa Systems Inc.                            
+31C000-31CFFF                 (base 16)                     Casa Systems Inc.                            
+                                                            500 Clark Road                               
+                                                            Tewksbury  MA  01876                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ODIXION                                      
+324000-324FFF                 (base 16)                     ODIXION                                      
+                                                            188 rue de la Liberté                        
+                                                            AVRANCHES  France  50300                     
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CA Technology, Inc                           
+33E000-33EFFF                 (base 16)                     CA Technology, Inc                           
+                                                            533 Fellowship Rd                            
+                                                            Mt Laurel  NJ  08054                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         DTASENSOR S.p.A.                             
+320000-320FFF                 (base 16)                     DTASENSOR S.p.A.                             
+                                                            Via Lavino 265                               
+                                                            Monte San Pietro  BOLOGNA  40050             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Digilent Inc.                                
+2F9000-2F9FFF                 (base 16)                     Digilent Inc.                                
+                                                            PO BOX 428                                   
+                                                            Pullman  WA  99163                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ADChips                                      
+2F5000-2F5FFF                 (base 16)                     ADChips                                      
+                                                            4th floor SamKwang Bldg.                     
+                                                            Seoul  Seoul  135-508                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Soredex Instrumentarium Oyj                  
+300000-300FFF                 (base 16)                     Soredex Instrumentarium Oyj                  
+                                                            PL 250                                       
+                                                            Helsinki    00031                            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         QUBIsoft S.r.l.                              
+2EA000-2EAFFF                 (base 16)                     QUBIsoft S.r.l.                              
+                                                            C.so del POpolo 8/C                          
+                                                            PADOVA    35131                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Eurotek Srl                                  
+2F2000-2F2FFF                 (base 16)                     Eurotek Srl                                  
+                                                            Strada Comunale Savonesa, 9                  
+                                                            Rivalta Scrivia  AL  15050                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SHF Communication Technologies AG            
+2EE000-2EEFFF                 (base 16)                     SHF Communication Technologies AG            
+                                                            Wilhelm-von-Siemens-Str. 23 d                
+                                                            Berlin  Berlin  12277                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FACTS Engineering LLC                        
+2CB000-2CBFFF                 (base 16)                     FACTS Engineering LLC                        
+                                                            8049 Photonics Drive                         
+                                                            New Port Richey  Fl  34655                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wiener, Plein & Baus GmbH                    
+2DC000-2DCFFF                 (base 16)                     Wiener, Plein & Baus GmbH                    
+                                                            Muellersbaum 20                              
+                                                            Burscheid    51399                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PIXY AG                                      
+2D5000-2D5FFF                 (base 16)                     PIXY AG                                      
+                                                            Bruggerstrasse 37                            
+                                                            Baden    5400                                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Neo Electronics Ltd                          
+2D7000-2D7FFF                 (base 16)                     Neo Electronics Ltd                          
+                                                            Neo House                                    
+                                                            Oldham  Lancashire  OL1 4AW                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         iamba LTD.                                   
+2E4000-2E4FFF                 (base 16)                     iamba LTD.                                   
+                                                            Hatidhar 3                                   
+                                                            Ra'anana    43000                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         StorLink Semi                                
+2BD000-2BDFFF                 (base 16)                     StorLink Semi                                
+                                                            1804 N. Shoreline Blvd, Suite 240            
+                                                            Mountain View  CA  94043                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Richmond Sound Design Ltd.                   
+2B9000-2B9FFF                 (base 16)                     Richmond Sound Design Ltd.                   
+                                                            205-11780 River Road                         
+                                                            Richmond  BC  V6X 1Z7                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Smiths Detection                             
+2B2000-2B2FFF                 (base 16)                     Smiths Detection                             
+                                                            1730 Aimco Blvd                              
+                                                            Mississauga  Ontario  L4W 1V1                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         DVTel Israel Ltd.                            
+2A8000-2A8FFF                 (base 16)                     DVTel Israel Ltd.                            
+                                                            4 Hamelacha St.                              
+                                                            Lod    71520                                 
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Softier Inc.                                 
+2B6000-2B6FFF                 (base 16)                     Softier Inc.                                 
+                                                            3 HaTidhar St                                
+                                                            Raanana    43665                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         AMIRIX Systems                               
+292000-292FFF                 (base 16)                     AMIRIX Systems                               
+                                                            20 Angus Morton Drive                        
+                                                            Bedford  NS  B4B 0L9                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Spellman High Voltage Electronics Corp       
+28F000-28FFFF                 (base 16)                     Spellman High Voltage Electronics Corp       
+                                                            475 Wireless Blvd                            
+                                                            Hauppauge  NY  11788                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         EBNEURO SPA                                  
+290000-290FFF                 (base 16)                     EBNEURO SPA                                  
+                                                            VIA PIETRO FANFANI 97a                       
+                                                            FIRENZE    50127                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Fundación TECNALIA Research & Innovation     
+274000-274FFF                 (base 16)                     Fundación TECNALIA Research & Innovation     
+                                                            C/ Geldo Edificio 700, Parque Tecnológico Bizkaia
+                                                            Derio  Vizcaya  48160                        
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Servicios Condumex, S. A. de C. V.           
+273000-273FFF                 (base 16)                     Servicios Condumex, S. A. de C. V.           
+                                                            Carretera a San Luis Potosí­ km. 9.6         
+                                                            Querétaro    76120                           
+                                                            MX                                           
+
+00-50-C2                      (hex)                         Confidence Direct Ltd                        
+264000-264FFF                 (base 16)                     Confidence Direct Ltd                        
+                                                            17-20 Napier Road                            
+                                                            Luton  Beds  LU1 1RF                         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Littwin GmbH & Co KG                         
+285000-285FFF                 (base 16)                     Littwin GmbH & Co KG                         
+                                                            Am Strehl 153-155                            
+                                                            Oldenburg  Niedersachsen  26125              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Telvent                                      
+282000-282FFF                 (base 16)                     Telvent                                      
+                                                            Tamarguillo, 29                              
+                                                            Seville    41006                             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         AGECODAGIS SARL                              
+280000-280FFF                 (base 16)                     AGECODAGIS SARL                              
+                                                            16, rue d'Auriac                             
+                                                            Rieux  Haute Garonne  31310                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Danlaw Inc                                   
+27C000-27CFFF                 (base 16)                     Danlaw Inc                                   
+                                                            23700 research Dr.                           
+                                                            Farmington Hills  MI  48335                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Azimuth Systems, Inc.                        
+24B000-24BFFF                 (base 16)                     Azimuth Systems, Inc.                        
+                                                            31 Nagog Park                                
+                                                            Acton  MA  01720                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         BELIK S.P.R.L.                               
+265000-265FFF                 (base 16)                     BELIK S.P.R.L.                               
+                                                            Rue du Roussart 147                          
+                                                            Waterloo  Brabant  B-1410                    
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Thales Communications Ltd                    
+254000-254FFF                 (base 16)                     Thales Communications Ltd                    
+                                                            Newton Road                                  
+                                                            Crawley  West Sussex  RH10 9TS               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DGT Sp. z o.o.                               
+251000-251FFF                 (base 16)                     DGT Sp. z o.o.                               
+                                                            ul. Jaskowa Dolina 15                        
+                                                            Gdansk  woj. pomorskie  80-252               
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Gradual Tecnologia Ltda.                     
+247000-247FFF                 (base 16)                     Gradual Tecnologia Ltda.                     
+                                                            Rua Attilio Giaretta, 110                    
+                                                            Itatiba  SP  13257-584                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Zendex Corporation                           
+25A000-25AFFF                 (base 16)                     Zendex Corporation                           
+                                                            6780 Sierra Court                            
+                                                            Dublin  CA  94568                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         asetek Inc.                                  
+22D000-22DFFF                 (base 16)                     asetek Inc.                                  
+                                                            Saltumvej 27                                 
+                                                            Broenderslev    9700                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Contronics Automacao Ltda                    
+241000-241FFF                 (base 16)                     Contronics Automacao Ltda                    
+                                                            R. Lauro Linhares 589                        
+                                                            Florianopolis  SC  88036-002                 
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Stins Coman                                  
+239000-239FFF                 (base 16)                     Stins Coman                                  
+                                                            Pervomayskaya street build 126               
+                                                            Moscow                                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         MST SYSTEMS LIMITED                          
+21A000-21AFFF                 (base 16)                     MST SYSTEMS LIMITED                          
+                                                            The Haysfield                                
+                                                            Malvern  Worcestershire  WR14 1GF            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Applied Technologies Associates              
+21E000-21EFFF                 (base 16)                     Applied Technologies Associates              
+                                                            3025 Buena Vista Drive                       
+                                                            Paso Robles  CA  93446                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Level Control Systems                        
+216000-216FFF                 (base 16)                     Level Control Systems                        
+                                                            #42 - 100 Kal Lake Rd.                       
+                                                            Vernon  B.C.  V1T 9G1                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         VoiceCom AG                                  
+215000-215FFF                 (base 16)                     VoiceCom AG                                  
+                                                            Südwestpark 65                               
+                                                            Nürnberg  Germany  90449                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Intelligent Photonics Control                
+227000-227FFF                 (base 16)                     Intelligent Photonics Control                
+                                                            200-350 Palladium Rd                         
+                                                            Kanata  On  K2V 1A8                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Intelligent Media Technologies, Inc.         
+228000-228FFF                 (base 16)                     Intelligent Media Technologies, Inc.         
+                                                            9460 Delegates Drive                         
+                                                            Orlando  Florida  32837                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ferrari electronic AG                        
+20A000-20AFFF                 (base 16)                     Ferrari electronic AG                        
+                                                            Ruhlsdorfer Str. 138                         
+                                                            TELTOW    14513                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Varisys Ltd                                  
+20D000-20DFFF                 (base 16)                     Varisys Ltd                                  
+                                                            17 Manor Courtyard                           
+                                                            Great Haseley  High Wycombe  BUCKS HP13 5    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         imo-elektronik GmbH                          
+222000-222FFF                 (base 16)                     imo-elektronik GmbH                          
+                                                            Edisonstr. 19                                
+                                                            Bielefeld    33689                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Abest Communication Corp.                    
+1F5000-1F5FFF                 (base 16)                     Abest Communication Corp.                    
+                                                            19-7 Ting-Tien-Liao, Hsien-Jenli Tamshui     
+                                                            Taipei    251                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         BAE SYSTEMS Controls                         
+1F6000-1F6FFF                 (base 16)                     BAE SYSTEMS Controls                         
+                                                            Rm 373                                       
+                                                            Johnson City  NY  13790                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Covia, Inc                                   
+1F4000-1F4FFF                 (base 16)                     Covia, Inc                                   
+                                                            2F-1,No.166,Chien-Yi Rd.,                    
+                                                            Chung Ho City  Taipei  235                   
+                                                            TW                                           
+
+00-50-C2                      (hex)                         M2 Technology Pty Ltd                        
+1EF000-1EFFFF                 (base 16)                     M2 Technology Pty Ltd                        
+                                                            26 Greenhill Road                            
+                                                            Wayville  South Australia  5034              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Safetran Traffic Systems Inc.                
+1FE000-1FEFFF                 (base 16)                     Safetran Traffic Systems Inc.                
+                                                            1485 Garden of the Gods Rd.                  
+                                                            Colorado Springs  Colorado  80907            
+                                                            US                                           
+
+00-50-C2                      (hex)                         INCAA Informatica Italia  srl                
+1CD000-1CDFFF                 (base 16)                     INCAA Informatica Italia  srl                
+                                                            Via dei Castagni, 84/2                       
+                                                            MALGESSO  VARESE  21023                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Yazaki North America, Inc.                   
+1D0000-1D0FFF                 (base 16)                     Yazaki North America, Inc.                   
+                                                            6801 Haggerty Road                           
+                                                            Canton  MI  48187                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         GFI Chrono Time                              
+1DA000-1DAFFF                 (base 16)                     GFI Chrono Time                              
+                                                            121 rue des Guillees                         
+                                                            CHAURAY    79180                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Redpoint Controls                            
+1D5000-1D5FFF                 (base 16)                     Redpoint Controls                            
+                                                            364 Patteson Drive                           
+                                                            Morgantown  WV  26505                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         TWIN DEVELOPMENT S.A.                        
+1C7000-1C7FFF                 (base 16)                     TWIN DEVELOPMENT S.A.                        
+                                                            Av. General Michel, 1E                       
+                                                            CHARLEROI  Hainaut  B6000                    
+                                                            BE                                           
+
+00-50-C2                      (hex)                         PESA Switching Systems, Inc.                 
+1AF000-1AFFFF                 (base 16)                     PESA Switching Systems, Inc.                 
+                                                            330A Wynn Drive                              
+                                                            Huntsville  AL  35805                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         WillMonius Inc.                              
+1C0000-1C0FFF                 (base 16)                     WillMonius Inc.                              
+                                                            425-1 Kil1-dong, Kangdong-gu                 
+                                                            Seoul    134-011                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         InfinitiNetworks Inc.                        
+1C1000-1C1FFF                 (base 16)                     InfinitiNetworks Inc.                        
+                                                            1095 E. Duane Ave.                           
+                                                            Sunnyvale  CA  94085                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Weltronics Corp.                             
+1C2000-1C2FFF                 (base 16)                     Weltronics Corp.                             
+                                                            1414 Fair Oaks Ave.                          
+                                                            South Pasadena  CA  91030                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Paltronics, Inc.                             
+19E000-19EFFF                 (base 16)                     Paltronics, Inc.                             
+                                                            9246 Trinity Drive                           
+                                                            Lake in the Hills  IL  60156                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wilcoxon Research, Inc.                      
+19B000-19BFFF                 (base 16)                     Wilcoxon Research, Inc.                      
+                                                            20511 Seneca Meadows Pkwy                    
+                                                            Germanton  MD   20876                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Portalplayer, Inc                            
+1A1000-1A1FFF                 (base 16)                     Portalplayer, Inc                            
+                                                            3255 Scott Blvd                              
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         ANOVA BROADBAND                              
+1A8000-1A8FFF                 (base 16)                     ANOVA BROADBAND                              
+                                                            4501 SINGER CT #201                          
+                                                            CHANTILLY  VA  20151                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         EPM Tecnologia e Equipamentos                
+197000-197FFF                 (base 16)                     EPM Tecnologia e Equipamentos                
+                                                            Av Com Gumercindo Barranqueiros, 285         
+                                                            Jundiaí  São Paulo  13211-410                
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Mixbaal S.A. de C.V.                         
+183000-183FFF                 (base 16)                     Mixbaal S.A. de C.V.                         
+                                                            Blvd. José Guadalupe Zuno #48-MIX            
+                                                            Zapopan  Jalisco  45101                      
+                                                            MX                                           
+
+00-50-C2                      (hex)                         Optical Wireless Link Inc.                   
+185000-185FFF                 (base 16)                     Optical Wireless Link Inc.                   
+                                                            9 Cushing Suite 100                          
+                                                            Irvine  California  92618                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Task 84 Spa                                  
+181000-181FFF                 (base 16)                     Task 84 Spa                                  
+                                                            Via Boschetti N. 61                          
+                                                            Grassobbio (BG)    24050                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Zultys Technologies                          
+180000-180FFF                 (base 16)                     Zultys Technologies                          
+                                                            771 Vagueros Ave.                            
+                                                            Sunnyvale  CA  94085-5327                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Basler Electric Company                      
+18A000-18AFFF                 (base 16)                     Basler Electric Company                      
+                                                            12570 State Route 143                        
+                                                            Highland  Illinois  62249                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Broadstorm Telecom                           
+17B000-17BFFF                 (base 16)                     Broadstorm Telecom                           
+                                                            400 - 112th Ave. NE                          
+                                                            Bellevue  WA  98004                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Verifiber LLC                                
+179000-179FFF                 (base 16)                     Verifiber LLC                                
+                                                            49 Buford Highway                            
+                                                            Suwanne  GA  30024                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Jeffress Engineering Pty Ltd                 
+17C000-17CFFF                 (base 16)                     Jeffress Engineering Pty Ltd                 
+                                                            PO Box 195                                   
+                                                            Dry Creek  SA  5094                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Binary Wave Technologies Inc.                
+17E000-17EFFF                 (base 16)                     Binary Wave Technologies Inc.                
+                                                            106 Schneider Road, Unit C                   
+                                                            Ottawa  Ontario  K2K 1Y2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Sensys Technologies Inc.                     
+013000-013FFF                 (base 16)                     Sensys Technologies Inc.                     
+                                                            8419 Terminal Rd.                            
+                                                            Newington  VA  22122                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         JMBS Developpements                          
+001000-001FFF                 (base 16)                     JMBS Developpements                          
+                                                            5, rue de la Verrerie                        
+                                                                                                         
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CAD-UL GmbH                                  
+018000-018FFF                 (base 16)                     CAD-UL GmbH                                  
+                                                            Laemmerweg 32                                
+                                                                                                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         APCON, Inc.                                  
+146000-146FFF                 (base 16)                     APCON, Inc.                                  
+                                                            17938 SW Upper Bones Ferry Road              
+                                                            Portland  OR  97224                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         T.L.S. Corp.                                 
+000000-000FFF                 (base 16)                     T.L.S. Corp.                                 
+                                                            1241 Superieor Ave E                         
+                                                            Cleveland  OH  44114                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cepheid                                      
+15D000-15DFFF                 (base 16)                     Cepheid                                      
+                                                            904 Caribbean Drive                          
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dune Networks                                
+15B000-15BFFF                 (base 16)                     Dune Networks                                
+                                                            France Bldg.                                 
+                                                            Kibutz  Yakum  60972                         
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Aoptix Technologies                          
+15C000-15CFFF                 (base 16)                     Aoptix Technologies                          
+                                                            580 Division St.                             
+                                                            Campbell  CA  95008                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         UniSUR                                       
+147000-147FFF                 (base 16)                     UniSUR                                       
+                                                            7F, No.2-1, Industry E. Rd.                  
+                                                            Hsinchu    300                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         ELC Lighting                                 
+145000-145FFF                 (base 16)                     ELC Lighting                                 
+                                                            Vic vd Asdocnstraat 14                       
+                                                            Gemert    5421VB                             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Advanced Devices SpA                         
+153000-153FFF                 (base 16)                     Advanced Devices SpA                         
+                                                            Via Spagna, 50                               
+                                                            Rende  (Cosenza)                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         AirVast Technology Inc.                      
+152000-152FFF                 (base 16)                     AirVast Technology Inc.                      
+                                                            22F, No. 1247, Chung-Chang Rd.               
+                                                            Tao Yuan                                     
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Tecwings GmBh                                
+125000-125FFF                 (base 16)                     Tecwings GmBh                                
+                                                            A-2100 Korneuburg                            
+                                                                                                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Time Terminal Adductor Group AB              
+141000-141FFF                 (base 16)                     Time Terminal Adductor Group AB              
+                                                            Norrbergrgatan 8                             
+                                                            Vaxholm    18532                             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Instrumeter A/S                              
+142000-142FFF                 (base 16)                     Instrumeter A/S                              
+                                                            Linde Alle 29                                
+                                                            Naerum    DK-2850                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Sentito Networks                             
+13F000-13FFFF                 (base 16)                     Sentito Networks                             
+                                                            2096 Gaither Rd., Suite 100                  
+                                                            Rockville  MD  20850                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Formula One Management Ltd.                  
+13D000-13DFFF                 (base 16)                     Formula One Management Ltd.                  
+                                                            Sapphire House                               
+                                                            Biggin Hill  Kent TN16 3BW                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ELAD SRL                                     
+135000-135FFF                 (base 16)                     ELAD SRL                                     
+                                                            via col de rust, 11                          
+                                                            CANEVA PN    33070                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Dong A Eltek Co., Ltd.                       
+12B000-12BFFF                 (base 16)                     Dong A Eltek Co., Ltd.                       
+                                                            7704 Dongil Techno Town #7, 823              
+                                                            Kyungki-Do, 431-062                          
+                                                            KR                                           
+
+00-50-C2                      (hex)                         U.S. Traffic Corporation                     
+130000-130FFF                 (base 16)                     U.S. Traffic Corporation                     
+                                                            9603 John St.                                
+                                                            Santa Fe Springs  CA  90670                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Megisto Systems, Inc.                        
+12D000-12DFFF                 (base 16)                     Megisto Systems, Inc.                        
+                                                            20251 Century Blvd.                          
+                                                            Germantown  MD  20874                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital Vision AB                            
+11B000-11BFFF                 (base 16)                     Digital Vision AB                            
+                                                            Upplagsvagen 1                               
+                                                            SE-117 43 Stockholm                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Stonefly Networks                            
+11C000-11CFFF                 (base 16)                     Stonefly Networks                            
+                                                            10170 Huennekens St.                         
+                                                            San Diego  CA  92121                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         CSS Industrie Computer GmbH                  
+11F000-11FFFF                 (base 16)                     CSS Industrie Computer GmbH                  
+                                                            Osterhofstr. 14                              
+                                                            87600 Kaufbeuren                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Vidco, Inc.                                  
+115000-115FFF                 (base 16)                     Vidco, Inc.                                  
+                                                            6175 SW 112th Ave                            
+                                                            Beaverton  OR  97008                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wintegra Ltd.                                
+117000-117FFF                 (base 16)                     Wintegra Ltd.                                
+                                                            PO Box 3048                                  
+                                                            Ra'anana 43654                               
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Implementa GmbH                              
+10D000-10DFFF                 (base 16)                     Implementa GmbH                              
+                                                            Leineweg 26                                  
+                                                            30823 Garbsen                                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSP Design, Ltd.                             
+116000-116FFF                 (base 16)                     DSP Design, Ltd.                             
+                                                            Tapton Park Innovation Centre                
+                                                            Derbyshire S41 0TZ                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Raven Industries                             
+0F9000-0F9FFF                 (base 16)                     Raven Industries                             
+                                                            PO Box 1007                                  
+                                                            Sioux Falls  SD  57104                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lumentis AB                                  
+105000-105FFF                 (base 16)                     Lumentis AB                                  
+                                                            Jakobsdalsvagen 17                           
+                                                            SE-126 53 Hagersten                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Green Hills Software, Inc.                   
+103000-103FFF                 (base 16)                     Green Hills Software, Inc.                   
+                                                            30 W. Sola Street                            
+                                                            Santa Barbara  CA  93101                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Inducomp Corporation                         
+0FD000-0FDFFF                 (base 16)                     Inducomp Corporation                         
+                                                            1265 Jefferson St.                           
+                                                            Pacific  MO  63069                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         RouteFree, Inc.                              
+0E6000-0E6FFF                 (base 16)                     RouteFree, Inc.                              
+                                                            3400 Hillview Ave., Building 5               
+                                                            Palo Alto  CA  94304                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Century Geophysical Corp.                    
+0E7000-0E7FFF                 (base 16)                     Century Geophysical Corp.                    
+                                                            1223 S. 71st E. Ave.                         
+                                                            Tulsa  OK  74112                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sysnet Co., Ltd.                             
+0F4000-0F4FFF                 (base 16)                     Sysnet Co., Ltd.                             
+                                                            78 Ikenouchicho, Kishoin                     
+                                                                                                         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Visual Circuits Corp.                        
+0E2000-0E2FFF                 (base 16)                     Visual Circuits Corp.                        
+                                                            5155 East River Road                         
+                                                            Minneapolis  MN  55421                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elbit Systems Ltd.                           
+0DC000-0DCFFF                 (base 16)                     Elbit Systems Ltd.                           
+                                                            P.O.B. 539                                   
+                                                            Matam  Haifa  31053                          
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Advanced Medical Information Technologies, Inc.
+0C6000-0C6FFF                 (base 16)                     Advanced Medical Information Technologies, Inc.
+                                                            PO Box 870                                   
+                                                            Hermosa Beach  CA  90254-0870                
+                                                            US                                           
+
+00-50-C2                      (hex)                         SAIA Burgess Controls AG                     
+0C5000-0C5FFF                 (base 16)                     SAIA Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            3280 Murten                                  
+                                                            CH                                           
+
+00-50-C2                      (hex)                         LINET OY                                     
+0CD000-0CDFFF                 (base 16)                     LINET OY                                     
+                                                            Riihitie 8                                   
+                                                            00330 Helsinki                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         STUDIEL                                      
+0CB000-0CBFFF                 (base 16)                     STUDIEL                                      
+                                                            1027 Avenue Dactan Lefebvre                  
+                                                            06271 Villenaur Lou Pet cedex                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Bounty Systems Pty Ltd.                      
+0A4000-0A4FFF                 (base 16)                     Bounty Systems Pty Ltd.                      
+                                                            PO Box 499                                   
+                                                            Coffs Harbour NSW 2450                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Infinitec Networks, Inc.                     
+09E000-09EFFF                 (base 16)                     Infinitec Networks, Inc.                     
+                                                            4343 S. 118 E. Ave.                          
+                                                            Tulsa  OK  74146                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         CYNAPS                                       
+0A0000-0A0FFF                 (base 16)                     CYNAPS                                       
+                                                            PO Box 131276                                
+                                                            Bryanston    2021                            
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         EPEL Industrial, S.A.                        
+098000-098FFF                 (base 16)                     EPEL Industrial, S.A.                        
+                                                            CRTA. STA. Cruz Calafell No. 35              
+                                                            08830 - Sant Boi                             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Utronix Elektronikutreckling AB              
+096000-096FFF                 (base 16)                     Utronix Elektronikutreckling AB              
+                                                            Teknikringen 1                               
+                                                            SE-583 30 Linkoping                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Rising Edge Technologies                     
+08A000-08AFFF                 (base 16)                     Rising Edge Technologies                     
+                                                            500-D Huntmar Park Dr                        
+                                                            Herndon  VA  20170                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         DigitAll World Co., Ltd                      
+092000-092FFF                 (base 16)                     DigitAll World Co., Ltd                      
+                                                            248-4, YouSeong Twin Plaza Bldg, 4F          
+                                                            Kyungki-Do 463 050                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         PLLB elettronica spa                         
+07C000-07CFFF                 (base 16)                     PLLB elettronica spa                         
+                                                            via Carducci 39                              
+                                                            20099 Sesto San Giovanni  Milano             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Reselec AG                                   
+078000-078FFF                 (base 16)                     Reselec AG                                   
+                                                            Schlosserstr. 4                              
+                                                            CH-8180 Buelach                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Alstom Signalling Ltd.                       
+073000-073FFF                 (base 16)                     Alstom Signalling Ltd.                       
+                                                            Borehamwood Industrial Park                  
+                                                            Borehamwood  Herts WD6 5PZ                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         NetVision Telecom                            
+071000-071FFF                 (base 16)                     NetVision Telecom                            
+                                                            117-11, Jungchon-Dong, Jung-Gu               
+                                                            Taejon, 301-080                              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         WaveCom Electronics, Inc.                    
+06C000-06CFFF                 (base 16)                     WaveCom Electronics, Inc.                    
+                                                            222 Cardinal Crescent                        
+                                                            Saskatcon, SK    S7L 6H8                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Riverlink Computers, Ltd.                    
+067000-067FFF                 (base 16)                     Riverlink Computers, Ltd.                    
+                                                            Pixmore Centre                               
+                                                            Letchworth, SG6 1JG                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Unimark                                      
+06A000-06AFFF                 (base 16)                     Unimark                                      
+                                                            9910 Widner Road                             
+                                                            Lenexa  KS  66215                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computer Concepts Corp                       
+049000-049FFF                 (base 16)                     Computer Concepts Corp                       
+                                                            8375 Melrose                                 
+                                                            Lenexa  KS  66214                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+046000-046FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         B.E.A.R. Solutions (Australasia) Pty, Ltd    
+042000-042FFF                 (base 16)                     B.E.A.R. Solutions (Australasia) Pty, Ltd    
+                                                            Unit 226                                     
+                                                            Bella Vista  NSW                             
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Damler Chrysler Rail System (Signal) AB      
+041000-041FFF                 (base 16)                     Damler Chrysler Rail System (Signal) AB      
+                                                            Box 42505                                    
+                                                            SE-12616 Stockholm                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Celotek Corp                                 
+03F000-03FFFF                 (base 16)                     Celotek Corp                                 
+                                                            PO Box 14285                                 
+                                                            RTP  NC  27709                               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ing. Buero W. Kanis GmbH                     
+034000-034FFF                 (base 16)                     Ing. Buero W. Kanis GmbH                     
+                                                            Ortsteil Traubing                            
+                                                            Brueckenweg 2  D-82327 Tutzing               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Turtle Mountain Corp                         
+02E000-02EFFF                 (base 16)                     Turtle Mountain Corp                         
+                                                            Box 940                                      
+                                                            Dunseith  ND  58329                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nova Engineering Inc.                        
+02B000-02BFFF                 (base 16)                     Nova Engineering Inc.                        
+                                                            5 Circle Freeway Dr.                         
+                                                            Cincinnati  OH  45426                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lockheed Martin Tactical Defense Systems Eagan
+030000-030FFF                 (base 16)                     Lockheed Martin Tactical Defense Systems Eagan
+                                                            3333 Pilot Knob Rd                           
+                                                            Eagan  MN  55121                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Zabacom, Inc.                                
+023000-023FFF                 (base 16)                     Zabacom, Inc.                                
+                                                            5 Choke Cherry Road                          
+                                                            Rockville  MD  20850                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ashling Microsystems Ltd.                    
+022000-022FFF                 (base 16)                     Ashling Microsystems Ltd.                    
+                                                            National Technology Park                     
+                                                                                                         
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Tadiran Scopus                               
+01C000-01CFFF                 (base 16)                     Tadiran Scopus                               
+                                                            5 Hatzorf St.                                
+                                                                                                         
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Portable Add-Ons                             
+008000-008FFF                 (base 16)                     Portable Add-Ons                             
+                                                            Chineham Court, Lutyens Close                
+                                                            Hampshire    RG24 8AH                        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Clever Devices                               
+065000-065FFF                 (base 16)                     Clever Devices                               
+                                                            1662 Route 300                               
+                                                            Newburgh  NY  12550                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         FSR, INC.                                    
+9F4000-9F4FFF                 (base 16)                     FSR, INC.                                    
+                                                            244 Bergen Blvd                              
+                                                            West Paterson    07424                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         STMicroelectronics SRL                       
+255000-255FFF                 (base 16)                     STMicroelectronics SRL                       
+                                                            Stradale Primosole, 50                       
+                                                            CATANIA    95121                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+C7B000-C7BFFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Hwy 19 North                        
+                                                            Clearwater  FL  33764-7290                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+D95000-D95FFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Highway 19 N                        
+                                                            Clearwater    33764                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Unisensor A/S                                
+AD6000-AD6FFF                 (base 16)                     Unisensor A/S                                
+                                                            Gydevang 42                                  
+                                                            Alleroed    3450                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         MB connect line GmbH Fernwartungssysteme     
+EA8000-EA8FFF                 (base 16)                     MB connect line GmbH Fernwartungssysteme     
+                                                            Winnettener Straße 5                         
+                                                            Dinkelsbühl  Bavaria  91550                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Erhardt+Leimer GmbH                          
+CEC000-CECFFF                 (base 16)                     Erhardt+Leimer GmbH                          
+                                                            Albert-Leimer-Platz 1                        
+                                                            Stadtbergen  Bavaria  86391                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Erhardt+Leimer GmbH                          
+453000-453FFF                 (base 16)                     Erhardt+Leimer GmbH                          
+                                                            Albert-Leimer-Platz 1                        
+                                                            Stadtbergen  Bavaria  86391                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Comtest Networks                             
+624000-624FFF                 (base 16)                     Comtest Networks                             
+                                                            1 Raymond Street                             
+                                                            Ottawa  Ontario  K1R 1A2                     
+                                                            CA                                           
+
+40-D8-55                      (hex)                         EST Analytical                               
+0CE000-0CEFFF                 (base 16)                     EST Analytical                               
+                                                            503 Commercial Dr                            
+                                                            Fairfield  OH  45014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ballard Technology, Inc,                     
+2E2000-2E2FFF                 (base 16)                     Ballard Technology, Inc,                     
+                                                            11400 Airport Road                           
+                                                            Everett  WA  98204                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ard sa                                       
+083000-083FFF                 (base 16)                     ard sa                                       
+                                                            Micropolis Bat Clematis                      
+                                                            Gap  France  05000                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Private                                      
+0BF000-0BFFFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         T+A elektroakustik GmbH & Co.KG              
+D88000-D88FFF                 (base 16)                     T+A elektroakustik GmbH & Co.KG              
+                                                            Planckstraße 9-11                            
+                                                            Herford  NRW  32052                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Control LAN S.A.                             
+379000-379FFF                 (base 16)                     Control LAN S.A.                             
+                                                            Ortiz de Ocampo 3060 - Piso 2                
+                                                            Buenos Aires  CF  1425                       
+                                                            AR                                           
+
+00-50-C2                      (hex)                         Leonardo MW Ltd (Land & Naval Defence Electronic)
+913000-913FFF                 (base 16)                     Leonardo MW Ltd (Land & Naval Defence Electronic)
+                                                            A Finmeccanica Company                       
+                                                            Basildon  Essex  SS14 3EL                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         EATON FHF Funke + Huster Fernsig GmbH        
+FBD000-FBDFFF                 (base 16)                     EATON FHF Funke + Huster Fernsig GmbH        
+                                                            Gewerbeallee 15-19                           
+                                                            Mülheim an der Ruhr  NRW  D-45478            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ABB Power Technologies S.p.A.  Unità  Operativa SACE (PTMV)
+3DE000-3DEFFF                 (base 16)                     ABB Power Technologies S.p.A.  Unità  Operativa SACE (PTMV)
+                                                            via Friuli 4                                 
+                                                            Dalmine  Bergamo  24044                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Insitu, Inc                                  
+FD4000-FD4FFF                 (base 16)                     Insitu, Inc                                  
+                                                            118 E Columbia River Way                     
+                                                            Bingen  WA  98605                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Critical Link LLC                            
+17C000-17CFFF                 (base 16)                     Critical Link LLC                            
+                                                            6712 Brooklawn Parkway                       
+                                                            Syracuse  NY  13211                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Secure Systems & Services                    
+339000-339FFF                 (base 16)                     Secure Systems & Services                    
+                                                            24, Chemin de la Pouranque                   
+                                                            F-13752  LES PENNES MIRABEAU  CS30084        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Magellan Technology Pty Limited              
+2C0000-2C0FFF                 (base 16)                     Magellan Technology Pty Limited              
+                                                            65 Johnston Street                           
+                                                            Annandale  NSW  2038                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Thales Communications Inc                    
+8AD000-8ADFFF                 (base 16)                     Thales Communications Inc                    
+                                                            22605 Gateway Center Drive                   
+                                                            Clarksburg  MD  20871                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Thales UK Limited                            
+A48000-A48FFF                 (base 16)                     Thales UK Limited                            
+                                                            1 Linthouse Road                             
+                                                            Glasgow    G51 4BZ                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         n3k Informatik GmbH                          
+AB4000-AB4FFF                 (base 16)                     n3k Informatik GmbH                          
+                                                            Ferdinand-Braun-Straße 3                     
+                                                            Heilbronn  Baden-Württemberg  74074          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Euro Display Srl                             
+777000-777FFF                 (base 16)                     Euro Display Srl                             
+                                                            Via Gandhi, 21                               
+                                                            Avigliana  Torino  10051                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Neptune Technology Group Inc.                
+89A000-89AFFF                 (base 16)                     Neptune Technology Group Inc.                
+                                                            1600 AL HWY 229 S                            
+                                                            Tallassee    36078                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gogo BA                                      
+67C000-67CFFF                 (base 16)                     Gogo BA                                      
+                                                            1172 Century Drive                           
+                                                            Louisville    80027                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gogo BA                                      
+7CE000-7CEFFF                 (base 16)                     Gogo BA                                      
+                                                            303 S. Technology Dr.                        
+                                                            Broomfield  CO  80021                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gogo BA                                      
+EAF000-EAFFFF                 (base 16)                     Gogo BA                                      
+                                                            303 S. Technology Ct.                        
+                                                            Broomfield  Co  80021                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Gogo BA                                      
+00B000-00BFFF                 (base 16)                     Gogo BA                                      
+                                                            303 S Technology Ct                          
+                                                            Broomfield  CO  80021                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computerwise, Inc.                           
+F8F000-F8FFFF                 (base 16)                     Computerwise, Inc.                           
+                                                            302 N. Winchester                            
+                                                            Olathe  KS  66062                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         EXTREME COPPER,  INC.                        
+0B5000-0B5FFF                 (base 16)                     EXTREME COPPER,  INC.                        
+                                                            4342 Avenida Gregory                         
+                                                            Spring Valley  CA  91977                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         i3 International Inc.                        
+E98000-E98FFF                 (base 16)                     i3 International Inc.                        
+                                                            780 Birchmount Road                          
+                                                            Toronto  Ontario  M1K5H4                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Potter Electric Signal Co. LLC               
+C63000-C63FFF                 (base 16)                     Potter Electric Signal Co. LLC               
+                                                            11790 Troy Lane North                        
+                                                            Maple Grove  MN  55369                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         CODEC Co., Ltd.                              
+9DF000-9DFFFF                 (base 16)                     CODEC Co., Ltd.                              
+                                                            1-29-18 Tamagawa                             
+                                                            Choufu-shi  Tokyo  182-0025                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Ubiquiti Networks Inc.                       
+B04000-B04FFF                 (base 16)                     Ubiquiti Networks Inc.                       
+                                                            91 E Tasman Dr                               
+                                                            San Jose  CA  95134                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+DE6000-DE6FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH 4016                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         VISION SYSTEMS AERONAUTIC                    
+F14000-F14FFF                 (base 16)                     VISION SYSTEMS AERONAUTIC                    
+                                                            ROUTE D'IRIGNY                               
+                                                            BRIGNAIS    69530                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         NSFOCUS Information Technology Co., Ltd.     
+4B1000-4B1FFF                 (base 16)                     NSFOCUS Information Technology Co., Ltd.     
+                                                            5F Either Building, No 4 Beiwa Rd            
+                                                            Beijing    100089                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Vocality International Ltd                   
+E3A000-E3AFFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Guildford  Surrey  GU86AP                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PYRAMID Computer GmbH                        
+2DA000-2DAFFF                 (base 16)                     PYRAMID Computer GmbH                        
+                                                            Boetzinger Strasse 60                        
+                                                            Freiburg  BW  79111                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+C0A000-C0AFFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+403000-403FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Trapeze Software Group Inc                   
+42C000-42CFFF                 (base 16)                     Trapeze Software Group Inc                   
+                                                            5265 Rockwell Drive NE                       
+                                                            Cedar Rapids  IA  52402                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Radionor Communications                      
+1F3000-1F3FFF                 (base 16)                     Radionor Communications                      
+                                                            Ingvald Ystgaards vei 23                     
+                                                            N-7047  Trondheim  0000                      
+                                                            NO                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+00C000-00CFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+E6A000-E6AFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+E00000-E00FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+DAB000-DABFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Win4NET                                      
+42F000-42FFFF                 (base 16)                     Win4NET                                      
+                                                            KOLON Digital Tower 1301, 222-7              
+                                                            Seoul  Kuro-dong, Kuro-gu  152-848           
+                                                            KR                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+BB7000-BB7FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+4DE000-4DEFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+33D000-33DFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt Street                     
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+CC4000-CC4FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 East Roosevelt St. R1122                
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         GILLAM-FEI S.A.                              
+2F7000-2F7FFF                 (base 16)                     GILLAM-FEI S.A.                              
+                                                            Mont St Martin 58                            
+                                                            LIEGE    4000                                
+                                                            BE                                           
+
+00-50-C2                      (hex)                         QUERCUS TECHNOLOGIES, S.L.                   
+FDC000-FDCFFF                 (base 16)                     QUERCUS TECHNOLOGIES, S.L.                   
+                                                            Antoni Isern 4 baixos                        
+                                                            Reus  Tarragona  43205                       
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Vaisala Oyj                                  
+13B000-13BFFF                 (base 16)                     Vaisala Oyj                                  
+                                                            Vanha Nurmijarventie 21                      
+                                                            VANTAA    Fin-01670                          
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Linn Products Ltd                            
+217000-217FFF                 (base 16)                     Linn Products Ltd                            
+                                                            Glasgow Road                                 
+                                                            Glasgow  Scotland  G76 0EQ                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+330000-330FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+60D000-60DFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Agramkow Fluid Systems A/S                   
+07C000-07CFFF                 (base 16)                     Agramkow Fluid Systems A/S                   
+                                                            Augustenborg Landevej 19                     
+                                                            Soenderborg  DK  6400                        
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Haag-Streit AG                               
+149000-149FFF                 (base 16)                     Haag-Streit AG                               
+                                                            Gartenstadtstrasse 10                        
+                                                            Köniz    CH-3098                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Private                                      
+060000-060FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Intuitive Surgical, Inc                      
+D9B000-D9BFFF                 (base 16)                     Intuitive Surgical, Inc                      
+                                                            1266 Kifer Road                              
+                                                            Sunnyvale  CA  94086                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Enseo, Inc.                                  
+5CC000-5CCFFF                 (base 16)                     Enseo, Inc.                                  
+                                                            401 International Pkwy                       
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         txtr GmbH                                    
+BA0000-BA0FFF                 (base 16)                     txtr GmbH                                    
+                                                            Rosenthaler Str. 13                          
+                                                            Berlin    10119                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Data Respons A/S                             
+1EB000-1EBFFF                 (base 16)                     Data Respons A/S                             
+                                                            Horkaer 18, 1. floor                         
+                                                            Herlev    DK-2730                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Daintree Networks Pty                        
+378000-378FFF                 (base 16)                     Daintree Networks Pty                        
+                                                            111 N. Market St, Suite 615                  
+                                                            San Jose  CA  95113-1101                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crescendo Networks                           
+22A000-22AFFF                 (base 16)                     Crescendo Networks                           
+                                                            28 Hacharoshet St.                           
+                                                            Or-Yehuda    60375                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         DELTA TAU DATA SYSTEMS, INC.                 
+12C000-12CFFF                 (base 16)                     DELTA TAU DATA SYSTEMS, INC.                 
+                                                            21314 Lassen St.                             
+                                                            Chatsworth  CA  91311                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+BE4000-BE4FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+857000-857FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+7AA000-7AAFFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+5F8000-5F8FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+56A000-56AFFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Grupo Epelsa S.L.                            
+027000-027FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            CALLE PUNTO NET, 3                           
+                                                            ALCALA DE HENARES    28805                   
+                                                            US                                           
+
+40-D8-55                      (hex)                         TATTILE SRL                                  
+071000-071FFF                 (base 16)                     TATTILE SRL                                  
+                                                            via Donizetti 1/3/5                          
+                                                            Mairano  Brescia  25030                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Aeroflex GmbH                                
+B51000-B51FFF                 (base 16)                     Aeroflex GmbH                                
+                                                            Gutenbergstrasse 2-4                         
+                                                            Ismaning  Bavaria  85737                     
+                                                            DE                                           
+
+40-D8-55                      (hex)                         EMAC, Inc.                                   
+131000-131FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62901                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         bioMérieux Italia S.p.A.                     
+8E3000-8E3FFF                 (base 16)                     bioMérieux Italia S.p.A.                     
+                                                            via di Campigliano, 58                       
+                                                            Ponte a Ema  FI  50015                       
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Narinet, Inc.                                
+EE6000-EE6FFF                 (base 16)                     Narinet, Inc.                                
+                                                            C-303, Bundang Techno-Park                   
+                                                            Seongnam  Gyunggi-Do  463-816                
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Embedded Technology Corporation              
+1E0000-1E0FFF                 (base 16)                     Embedded Technology Corporation              
+                                                            Uryudou 3-8-13                               
+                                                            Higashiosaka city  Osakafu  578-0946         
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Mega Electronics Ltd                         
+1E3000-1E3FFF                 (base 16)                     Mega Electronics Ltd                         
+                                                            Pioneerinkatu 6                              
+                                                            Kuopio  Pohjois-Savo  70800                  
+                                                            FI                                           
+
+40-D8-55                      (hex)                         NKT Photonics A/S                            
+1CC000-1CCFFF                 (base 16)                     NKT Photonics A/S                            
+                                                            Blokken 84                                   
+                                                            Birkerod    3460                             
+                                                            DK                                           
+
+40-D8-55                      (hex)                         Founder Broadband Network Service Co.,Ltd.   
+1D1000-1D1FFF                 (base 16)                     Founder Broadband Network Service Co.,Ltd.   
+                                                            5/F, Building B, 15 Xueyuan South Rd,        
+                                                            Haidian District  Beijing  100088            
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Kaluga Teletypes Manufacturing Plant         
+1D3000-1D3FFF                 (base 16)                     Kaluga Teletypes Manufacturing Plant         
+                                                            141, Saltykova-Schedrina Street              
+                                                            Kaluga  Kaluga region  248002                
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Beking Industrieele automatisering           
+1B9000-1B9FFF                 (base 16)                     Beking Industrieele automatisering           
+                                                            Kraaienjagersweg 8                           
+                                                            Beemte-Broekland    7341PS                   
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Rigel Engineering                            
+1CA000-1CAFFF                 (base 16)                     Rigel Engineering                            
+                                                            1690 S Tropical Trail                        
+                                                            Merritt Island  FL  32952                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         Private                                      
+1C5000-1C5FFF                 (base 16)                     Private                                      
+
+40-D8-55                      (hex)                         BaOpt Benelux bv                             
+1DD000-1DDFFF                 (base 16)                     BaOpt Benelux bv                             
+                                                            Wilhelminastraat 51                          
+                                                            Haarlem    2011 VL                           
+                                                            NL                                           
+
+40-D8-55                      (hex)                         DemoPad                                      
+1A5000-1A5FFF                 (base 16)                     DemoPad                                      
+                                                            Unit 5 Albert Edward House                   
+                                                            Preston  Lancashire  PR2 2YB                 
+                                                            GB                                           
+
+40-D8-55                      (hex)                         WICHER DIGITAL TECHNIK                       
+1AD000-1ADFFF                 (base 16)                     WICHER DIGITAL TECHNIK                       
+                                                            Am Huettberg 38                              
+                                                            Floersbachtal  Hessen  63639                 
+                                                            DE                                           
+
+40-D8-55                      (hex)                         TOKHATEC                                     
+17E000-17EFFF                 (base 16)                     TOKHATEC                                     
+                                                            2 Rue Georges Melies                         
+                                                            Bois D&#39;Arcy    78390                     
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Standard Change Makers                       
+185000-185FFF                 (base 16)                     Standard Change Makers                       
+                                                            3130 North Mitthoeffer                       
+                                                            Indianapolis  Indiana  46235-0550            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Yoozma Corporation                           
+189000-189FFF                 (base 16)                     Yoozma Corporation                           
+                                                            Shinkawa                                     
+                                                            Chuo-ku  Tokyo  104-0033                     
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Array Corporation                            
+188000-188FFF                 (base 16)                     Array Corporation                            
+                                                            3-42-10 Yoyogi                               
+                                                            Shibuya-ku  Tokyo  151-0053                  
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Contec Steuerungstechnik & Automation GmbH   
+173000-173FFF                 (base 16)                     Contec Steuerungstechnik & Automation GmbH   
+                                                            Wildbichler Straße 2E                        
+                                                            Ebbs    6341                                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         TRI Engineering co.,ltd.                     
+177000-177FFF                 (base 16)                     TRI Engineering co.,ltd.                     
+                                                            23-30 Goban-cho                              
+                                                            Ageo  Saitama  362-0024                      
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Sicon srl                                    
+171000-171FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Thermo Fisher Sceintific                     
+160000-160FFF                 (base 16)                     Thermo Fisher Sceintific                     
+                                                            1410 Gillingham Lane                         
+                                                            Sugar Land  Texas  77478                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         KMtronic LTD                                 
+163000-163FFF                 (base 16)                     KMtronic LTD                                 
+                                                            Dobry Czintulov 28A                          
+                                                            Gorna Oriahovitca  VT  5100                  
+                                                            BG                                           
+
+40-D8-55                      (hex)                         NFT Automatisierungssysteme GmbH             
+164000-164FFF                 (base 16)                     NFT Automatisierungssysteme GmbH             
+                                                            Ignatz-Wiemeler-Str. 16                      
+                                                            Ibbenbueren  NRW  49477                      
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Assembly Contracts Ltd                       
+167000-167FFF                 (base 16)                     Assembly Contracts Ltd                       
+                                                            Ledson Road                                  
+                                                            Manchester  Lancashire  M23 9GP              
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Photop Koncent                               
+169000-169FFF                 (base 16)                     Photop Koncent                               
+                                                            5 Houyu Rd.,P.O.Box 206                      
+                                                            fuzhou  fujian  350001                       
+                                                            CN                                           
+
+40-D8-55                      (hex)                         BlinkPipe Ltd                                
+153000-153FFF                 (base 16)                     BlinkPipe Ltd                                
+                                                            Wellington House                             
+                                                            Cambridge  Cambs  CB11BH                     
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Exibea AB                                    
+158000-158FFF                 (base 16)                     Exibea AB                                    
+                                                            Ekmansgatan 3                                
+                                                            411  SE-  41132                              
+                                                            SE                                           
+
+40-D8-55                      (hex)                         Hitachi Power Solutions Co., Ltd.            
+157000-157FFF                 (base 16)                     Hitachi Power Solutions Co., Ltd.            
+                                                            38 shinkoutyou                               
+                                                            hitachinaka  ibaraki  312-0005               
+                                                            JP                                           
+
+40-D8-55                      (hex)                         PLT                                          
+14C000-14CFFF                 (base 16)                     PLT                                          
+                                                            Partiyniy pereulok d.1 build. 58             
+                                                              Moscow  115093                             
+                                                            RU                                           
+
+40-D8-55                      (hex)                         TTI LTD                                      
+126000-126FFF                 (base 16)                     TTI LTD                                      
+                                                            Glebe Road                                   
+                                                            Cambridge  Cambridgeshire  PE29 7DR          
+                                                            GB                                           
+
+40-D8-55                      (hex)                         digitech GmbH &amp; Co. KG                   
+134000-134FFF                 (base 16)                     digitech GmbH &amp; Co. KG                   
+                                                            Martinsplatz 3                               
+                                                            Patersdorf  Bavaria  94265                   
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Biotage Sweden AB                            
+12D000-12DFFF                 (base 16)                     Biotage Sweden AB                            
+                                                            Vimpelgatan 5                                
+                                                            Uppsala    753 18                            
+                                                            SE                                           
+
+40-D8-55                      (hex)                         AeroVision Avionics, Inc                     
+132000-132FFF                 (base 16)                     AeroVision Avionics, Inc                     
+                                                            2F, No.30, R&D Rd. II,                       
+                                                            Hsinchu  Taiwan, R.O.C  30076                
+                                                            US                                           
+
+40-D8-55                      (hex)                         So-Cool Corporation.                         
+10B000-10BFFF                 (base 16)                     So-Cool Corporation.                         
+                                                            1F., No.130, Shipin Rd., East Dist.          
+                                                            Hsinchu City  Taiwan  30062                  
+                                                            TW                                           
+
+40-D8-55                      (hex)                         Rite-Tech Industrial Co., Ltd.               
+10D000-10DFFF                 (base 16)                     Rite-Tech Industrial Co., Ltd.               
+                                                            10F, No. 5, Sec. 1, Tun-Hua S. Rd.,          
+                                                              Taipei  105                                
+                                                            TW                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+114000-114FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         e.p.g. Elettronica Srl                       
+101000-101FFF                 (base 16)                     e.p.g. Elettronica Srl                       
+                                                            Via Ungaretti 2                              
+                                                            BULGAROGRASSO  COMO  22070                   
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Triton Electronics LTD                       
+0E5000-0E5FFF                 (base 16)                     Triton Electronics LTD                       
+                                                            Hanarkisim 225 st.                           
+                                                            Bitzaron  Israel  60946                      
+                                                            IL                                           
+
+40-D8-55                      (hex)                         Top Connect OU                               
+0DB000-0DBFFF                 (base 16)                     Top Connect OU                               
+                                                            Väike-Paala 1                               
+                                                            Tallinn    11415                             
+                                                            EE                                           
+
+40-D8-55                      (hex)                         Sentry 360 Security                          
+0EC000-0ECFFF                 (base 16)                     Sentry 360 Security                          
+                                                            1280 Iroquois Ave                            
+                                                            Naperville  IL  60563                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Comline Elektronik Elektrotechnik GmbH       
+0F7000-0F7FFF                 (base 16)                     Comline Elektronik Elektrotechnik GmbH       
+                                                            Karl-Rapp-Straße 1                           
+                                                            Wackersdorf  Bayern  92442                   
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Xepto Computing Inc                          
+0C1000-0C1FFF                 (base 16)                     Xepto Computing Inc                          
+                                                            Unit 2202, 22F Asian Star Building           
+                                                            Alabang  Muntinlupa  1781                    
+                                                            PH                                           
+
+40-D8-55                      (hex)                         SC Techswarm SRL                             
+0C2000-0C2FFF                 (base 16)                     SC Techswarm SRL                             
+                                                            Lapusului Street, Nr. 17, Sc. A,             
+                                                            Oradea  Bihor  410271                        
+                                                            RO                                           
+
+40-D8-55                      (hex)                         NEXT! s.c. S.Piela B.Dryja                   
+0D8000-0D8FFF                 (base 16)                     NEXT! s.c. S.Piela B.Dryja                   
+                                                            Cieszynska 365                               
+                                                            Bielsko-Biala  Slask  43-300                 
+                                                            PL                                           
+
+40-D8-55                      (hex)                         M.M. Elektrolab                              
+0C5000-0C5FFF                 (base 16)                     M.M. Elektrolab                              
+                                                            Dzona Kenedija 11                            
+                                                            Beograd  Srbija  11000                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         LECO Corporation                             
+0D3000-0D3FFF                 (base 16)                     LECO Corporation                             
+                                                            3000 Lakeview Ave.                           
+                                                            St. Joseph  Michigan  49085                  
+                                                            US                                           
+
+40-D8-55                      (hex)                         Resch Electronic Innovation GmbH             
+0A4000-0A4FFF                 (base 16)                     Resch Electronic Innovation GmbH             
+                                                            Neustadter Ring 5                            
+                                                            Wernigerode  Sachsen-Anhalt  38855           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Thermal Imaging Radar, LLC                   
+0AA000-0AAFFF                 (base 16)                     Thermal Imaging Radar, LLC                   
+                                                            1304 N. Redwood Rd. Unit 122                 
+                                                            Saratoga Springs  Utah  84045                
+                                                            US                                           
+
+40-D8-55                      (hex)                         Papendorf Software Engineering GmbH          
+084000-084FFF                 (base 16)                     Papendorf Software Engineering GmbH          
+                                                            Robert-Bosch-Str. 10                         
+                                                            Gaertringen  Baden-Wuerttemberg  71116       
+                                                            DE                                           
+
+40-D8-55                      (hex)                         CoherentPlus Sdn Bhd                         
+09A000-09AFFF                 (base 16)                     CoherentPlus Sdn Bhd                         
+                                                            B-8-9, Megan Avenue 2                        
+                                                            Kuala Lumpur  Kuala Lumpur  50450            
+                                                            MY                                           
+
+40-D8-55                      (hex)                         IPS Technology Limited                       
+07B000-07BFFF                 (base 16)                     IPS Technology Limited                       
+                                                            7 Floor,E block,Dong Hai Wang Building,BuLong Road,
+                                                            Shenzhen  Guangdong  518000                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Oki Seatec Co., Ltd.                         
+068000-068FFF                 (base 16)                     Oki Seatec Co., Ltd.                         
+                                                            UchiuraMito 537-5                            
+                                                            Numazu  Shizuoka  410-0223                   
+                                                            JP                                           
+
+40-D8-55                      (hex)                         HIPODROMO DE AGUA CALIENTE, S.A. DE C.V.     
+064000-064FFF                 (base 16)                     HIPODROMO DE AGUA CALIENTE, S.A. DE C.V.     
+                                                            BLVD. AGUA CALIENTE 12027                    
+                                                            TIJUANA  BAJA CALIFORNIA  22420              
+                                                            MX                                           
+
+40-D8-55                      (hex)                         Leica Biosystems                             
+05D000-05DFFF                 (base 16)                     Leica Biosystems                             
+                                                            5205 Route 12                                
+                                                            Richmond  Illinois  60071                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         CS Instruments Asia                          
+051000-051FFF                 (base 16)                     CS Instruments Asia                          
+                                                            Room 31, Cambridge Plaza, Tower B            
+                                                              Hong Kong  000008                          
+                                                            HK                                           
+
+40-D8-55                      (hex)                         ATG UV Technology                            
+050000-050FFF                 (base 16)                     ATG UV Technology                            
+                                                            Genesis House                                
+                                                            Wigan    WN5 8AA                             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Vital Tech Industria e Comercio Ltda         
+04B000-04BFFF                 (base 16)                     Vital Tech Industria e Comercio Ltda         
+                                                            Rua Jose Villar Granjel, 22-24               
+                                                            Camipnas - San Paulo    13030680             
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Rosslare Enterprises Limited                 
+05C000-05CFFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+40-D8-55                      (hex)                         Energy Team S.p.A.                           
+058000-058FFF                 (base 16)                     Energy Team S.p.A.                           
+                                                            Via della Repubblica, 9                      
+                                                            Trezzano sul Naviglio  Milano  20090         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Circuitec Ind. Equip. Eletr. Ltda            
+02E000-02EFFF                 (base 16)                     Circuitec Ind. Equip. Eletr. Ltda            
+                                                            Rua Gustavo Zimmermann, 2431                 
+                                                            Blumenau  Santa Catarina  89062-100          
+                                                            BR                                           
+
+40-D8-55                      (hex)                         T.Q.M. Itaca Technology s.r.l.               
+041000-041FFF                 (base 16)                     T.Q.M. Itaca Technology s.r.l.               
+                                                            Via E. Mattei  1                             
+                                                            Mazzano  Brescia  25080                      
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Mesotech International, Inc.                 
+035000-035FFF                 (base 16)                     Mesotech International, Inc.                 
+                                                            4531 Harlin Drive                            
+                                                            Sacramento  CA  95826                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Socus networks                               
+03A000-03AFFF                 (base 16)                     Socus networks                               
+                                                            2F.-2, No.215, Sec. 2, Chengde Rd.           
+                                                            Taipei City    103                           
+                                                            TW                                           
+
+40-D8-55                      (hex)                         Telcomkorea                                  
+03B000-03BFFF                 (base 16)                     Telcomkorea                                  
+                                                            #710-8, Lee-Dong, Sanglok-Gu,                
+                                                            Ansan-Si  Kyunggi-Do  426863                 
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Nautel Limited                               
+019000-019FFF                 (base 16)                     Nautel Limited                               
+                                                            10089 Peggy's Cove Road                      
+                                                            Hackett's Cove  Nova Scotia  B3Z 3J4         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Scharco Elektronik GmbH                      
+01D000-01DFFF                 (base 16)                     Scharco Elektronik GmbH                      
+                                                            Tilsiter Strasse 8                           
+                                                            Wuppertal  NRW  42277                        
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Tinkerforge GmbH                             
+02A000-02AFFF                 (base 16)                     Tinkerforge GmbH                             
+                                                            Roemerstr. 18                                
+                                                            Stukenbrock  NRW  33758                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Booyco Electronics                           
+FF6000-FF6FFF                 (base 16)                     Booyco Electronics                           
+                                                            Unit 9, Innes Park                           
+                                                            Jetpark Ext 14  Gauteng  1549                
+                                                            ZA                                           
+
+40-D8-55                      (hex)                         Par-Tech, Inc.                               
+016000-016FFF                 (base 16)                     Par-Tech, Inc.                               
+                                                            139 Premier Drive                            
+                                                            Lake Orion  MI  48359                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         ClearSite Communications Inc.                
+009000-009FFF                 (base 16)                     ClearSite Communications Inc.                
+                                                            6004 Clark Center Ave.                       
+                                                            Sarasota  Florida  34238                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sensata Technologies                         
+FFE000-FFEFFF                 (base 16)                     Sensata Technologies                         
+                                                            4467 White Bear Parkway                      
+                                                            White Bear Lake  MN  55110                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         KST technology                               
+FF8000-FF8FFF                 (base 16)                     KST technology                               
+                                                            Bangi-dong, songpa-gu                        
+                                                              Seoul  138-050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Azurtest                                     
+FE0000-FE0FFF                 (base 16)                     Azurtest                                     
+                                                            4-11-17 Hatiman Kawajima                     
+                                                            Hikigun  Saitama  3500151                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Figment Design Laboratories                  
+FD9000-FD9FFF                 (base 16)                     Figment Design Laboratories                  
+                                                            113 11th Avenue                              
+                                                            Fairland  Johannesburg Guateng  2170         
+                                                            US                                           
+
+00-50-C2                      (hex)                         City Computing Ltd                           
+FD6000-FD6FFF                 (base 16)                     City Computing Ltd                           
+                                                            City House                                   
+                                                            Sutton  Surrey  SM1 2AE                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DINTEK Shanghai Electronic Ltd               
+FCF000-FCFFFF                 (base 16)                     DINTEK Shanghai Electronic Ltd               
+                                                            Room 404 Tianlin Road NO 142                 
+                                                            Shanghai    200233                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aster Electric Co.,Ltd.                      
+FD3000-FD3FFF                 (base 16)                     Aster Electric Co.,Ltd.                      
+                                                            6-40 Minamiyamata3-chome,Tudukiku            
+                                                            Yokohama  Kanagawa  2240029                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SERCOM Regeltechniek                         
+FC7000-FC7FFF                 (base 16)                     SERCOM Regeltechniek                         
+                                                            Heerweg 9                                    
+                                                            Lisse  ZN  2161 AB`                          
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Kyowadensi                                   
+FC4000-FC4FFF                 (base 16)                     Kyowadensi                                   
+                                                            Saiwai-cyo 2-1-17                            
+                                                            Chikusei  Ibaraki  308-0848                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         KOYO ELECTRIC                                
+FCE000-FCEFFF                 (base 16)                     KOYO ELECTRIC                                
+                                                            2-11-7 Hacchobori                            
+                                                            Chuo-ku  TOKYO  104-0032                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Nanjing SAC Power Grid Automation Co., Ltd.  
+F9F000-F9FFFF                 (base 16)                     Nanjing SAC Power Grid Automation Co., Ltd.  
+                                                            No.11 Phoenix Road                           
+                                                            Nanjing  Jiangsu Provience  211100           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Xemex NV                                     
+FA3000-FA3FFF                 (base 16)                     Xemex NV                                     
+                                                            Metropoolstraat 11a                          
+                                                            Schoten  Antwerp  BE-2900                    
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Coral Telecom Ltd                            
+FB9000-FB9FFF                 (base 16)                     Coral Telecom Ltd                            
+                                                            E-02 Sector 63                               
+                                                            Noida  UP  201301                            
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Power-One                                    
+FA2000-FA2FFF                 (base 16)                     Power-One                                    
+                                                            Via San Giorgio 642                          
+                                                            Terranuova Bracciolini  Arezzo  52028        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         JLCooper Electronics                         
+F96000-F96FFF                 (base 16)                     JLCooper Electronics                         
+                                                            142 Arena St                                 
+                                                            El Segundo  CA  90245                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         UBSTechnology Co., Ltd                       
+F8C000-F8CFFF                 (base 16)                     UBSTechnology Co., Ltd                       
+                                                            505-Ho, Changmi B/D                          
+                                                            Seoul City    133-120                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         comlet Verteilte Systeme GmbH                
+F8B000-F8BFFF                 (base 16)                     comlet Verteilte Systeme GmbH                
+                                                            Amerikastr. 27                               
+                                                            Zweibruecken  Rheinland-Pfalz  66482         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Dynamic Design                               
+F7F000-F7FFFF                 (base 16)                     Dynamic Design                               
+                                                            500 W Harbor Dr Unit 311                     
+                                                            San Diego  California  92101                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dynon Instruments                            
+F84000-F84FFF                 (base 16)                     Dynon Instruments                            
+                                                            19825 141st PL NE                            
+                                                            Woodinville  WA  98072                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Audio Power Labs                             
+F86000-F86FFF                 (base 16)                     Audio Power Labs                             
+                                                            7020 Huntley Road                            
+                                                            Columbus  Ohio  43229                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         D-Hike Electroncs Technology Co.,Ltd         
+F7D000-F7DFFF                 (base 16)                     D-Hike Electroncs Technology Co.,Ltd         
+                                                            Room 5277, Block A, Building 2,              
+                                                            Shanghai  Shanghai  201315                   
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+F79000-F79FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Newtec A/S                                   
+F68000-F68FFF                 (base 16)                     Newtec A/S                                   
+                                                            Stærmosegårdsvej  18                         
+                                                            Odense SV  Region Syd  5230                  
+                                                            DK                                           
+
+00-50-C2                      (hex)                         MCM Electronics                              
+F7B000-F7BFFF                 (base 16)                     MCM Electronics                              
+                                                            Unit 3 / 10 Abel St                          
+                                                            Sydney  NSW  2750                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Gets MSS S.A.                                
+F78000-F78FFF                 (base 16)                     Gets MSS S.A.                                
+                                                            Avenue des Boveresses n°52                   
+                                                            Lausanne  Vaud  1010                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DELTACAST.TV                                 
+F73000-F73FFF                 (base 16)                     DELTACAST.TV                                 
+                                                            Rue Gilles Magnee 92/6                       
+                                                            ANS    4430                                  
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Telebyte Inc.                                
+F65000-F65FFF                 (base 16)                     Telebyte Inc.                                
+                                                            355 Marcus Blvd.                             
+                                                            Hauppauge  NY  11788                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+F5B000-F5BFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Heinzinger electronic GmbH                   
+F4E000-F4EFFF                 (base 16)                     Heinzinger electronic GmbH                   
+                                                            Anton Jakob Str.4                            
+                                                            Rosenheim  BY  83026                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         NDC Infrared Engineering, Inc.               
+F51000-F51FFF                 (base 16)                     NDC Infrared Engineering, Inc.               
+                                                            5314 N. Irwindale Avenue                     
+                                                            Irwindale  CA  91706                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         SMARTB TECHNOLOGIES                          
+F5D000-F5DFFF                 (base 16)                     SMARTB TECHNOLOGIES                          
+                                                            #625 1ST FLOOR 3 RD CROSS CBI MAIN ROAD HMT LAYOUT RT NAGAR
+                                                            BANAGALORE  KARNATAKA  560032                
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Green Instruments A/S                        
+F49000-F49FFF                 (base 16)                     Green Instruments A/S                        
+                                                            Erhvervsparken 29                            
+                                                            Broenderslev    9700                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Special Systems Engineering Center LLC       
+F43000-F43FFF                 (base 16)                     Special Systems Engineering Center LLC       
+                                                            33 VARSHAVSKOE SHOSSE                        
+                                                            Moscow    117105                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         iBWorld co.,ltd.                             
+F40000-F40FFF                 (base 16)                     iBWorld co.,ltd.                             
+                                                            5-2-15                                       
+                                                            Tokorozawa  Saitama  359-0021                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SEITEC Co. Ltd                               
+F21000-F21FFF                 (base 16)                     SEITEC Co. Ltd                               
+                                                            580 kamashimo                                
+                                                            akaiwa-city  okayama-pref.  709-0732         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Terratel Technology s.r.o.                   
+F2C000-F2CFFF                 (base 16)                     Terratel Technology s.r.o.                   
+                                                            Dukelska 2192                                
+                                                            Benesov  CZ  25601                           
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Net4Things                                   
+F32000-F32FFF                 (base 16)                     Net4Things                                   
+                                                            Paseo de la Florida, nº 2                    
+                                                            Madrid    28008                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Micro Technic A/S                            
+F0E000-F0EFFF                 (base 16)                     Micro Technic A/S                            
+                                                            Smedevaenget 5                               
+                                                            Aarup    5560                                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Sanmina                                      
+EFD000-EFDFFF                 (base 16)                     Sanmina                                      
+                                                            PO 106                                       
+                                                            Ornskoldsvik    89123                        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Mango DSP, Inc                               
+F01000-F01FFF                 (base 16)                     Mango DSP, Inc                               
+                                                            83 East Ave                                  
+                                                            Norwalk  CT  06851                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Syscom Instruments                           
+F00000-F00FFF                 (base 16)                     Syscom Instruments                           
+                                                            Rue de l'Industrie 21                        
+                                                            Sainte-Croix  VD  1450                       
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Micro-Key BV                                 
+F06000-F06FFF                 (base 16)                     Micro-Key BV                                 
+                                                            Industrieweg 28                              
+                                                            Noordhorn  Groningen  9804 TG                
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Wren Sound Systems                           
+F03000-F03FFF                 (base 16)                     Wren Sound Systems                           
+                                                            169 Gateshead Way                            
+                                                            Phoenixville  PA  19460                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         RO.VE.R. Laboratories S.p.A                  
+EF4000-EF4FFF                 (base 16)                     RO.VE.R. Laboratories S.p.A                  
+                                                            Via Parini 2/4                               
+                                                            Colombare di SIrmione  BS  25019             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Homaetrix Ltd                                
+EF0000-EF0FFF                 (base 16)                     Homaetrix Ltd                                
+                                                            St Johns Innovation Centre                   
+                                                            Cambridge  Cambs  CB4 0WS                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines                    
+EDF000-EDFFFF                 (base 16)                     Monitor Business Machines                    
+                                                            56-58 Grafton Road                           
+                                                            Auckland    1035                             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Eyelock Corporation                          
+EDC000-EDCFFF                 (base 16)                     Eyelock Corporation                          
+                                                            355 Lexington Ave                            
+                                                            New York  New York  10017                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         fibrisTerre GmbH                             
+EEB000-EEBFFF                 (base 16)                     fibrisTerre GmbH                             
+                                                            Köpenicker Str. 154                          
+                                                            Berlin  Deutschland  10997                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         QUANTA S.r.l.                                
+EE9000-EE9FFF                 (base 16)                     QUANTA S.r.l.                                
+                                                            Via A. Ferrarin, 19-23                       
+                                                            Firenze  FI  50145                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Netline Communication Technologies           
+EF6000-EF6FFF                 (base 16)                     Netline Communication Technologies           
+                                                            Azrieli Circular Tower, 132 Menachem Begin Rd
+                                                            Tel Aviv  Israel  67021                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Cytec Zylindertechnik GmbH                   
+EE5000-EE5FFF                 (base 16)                     Cytec Zylindertechnik GmbH                   
+                                                            Steffensrott 1                               
+                                                            Jülich  NRW  52428                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TAMAGAWA ELECTRONICS CO.,LTD.                
+ED4000-ED4FFF                 (base 16)                     TAMAGAWA ELECTRONICS CO.,LTD.                
+                                                            3-11-23 Kamitsuchidana-naka                  
+                                                            Ayase-shi  Kanagawa  252-1113                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Klangspektrum GmbH                           
+ED2000-ED2FFF                 (base 16)                     Klangspektrum GmbH                           
+                                                            Postweg 14                                   
+                                                            Erwitte  NRW  59597                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FBT Elettronica spa                          
+ED7000-ED7FFF                 (base 16)                     FBT Elettronica spa                          
+                                                            Via P. Soprani 1                             
+                                                            Recanati  Macerata  62019                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Cat AB                                       
+ED6000-ED6FFF                 (base 16)                     Cat AB                                       
+                                                            P.o. box 2038                                
+                                                            Sundbyberg    SE-174 02                      
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ECO MONITORING UTILITY SYSTEMS LTD           
+ED3000-ED3FFF                 (base 16)                     ECO MONITORING UTILITY SYSTEMS LTD           
+                                                            ST BEDES CHAMBERS                            
+                                                            JARROW  TYNE AND WEAR  NE32 5JU              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Amsterdam Scientific Instruments BV          
+EC9000-EC9FFF                 (base 16)                     Amsterdam Scientific Instruments BV          
+                                                            Science Park 105                             
+                                                            Amsterdam    1098XG                          
+                                                            NL                                           
+
+00-50-C2                      (hex)                         ANT Group s.r.l                              
+EC1000-EC1FFF                 (base 16)                     ANT Group s.r.l                              
+                                                            Via Giroli 76                                
+                                                            Gavardo  (BS)  25085                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         UgMO Technologies                            
+EC0000-EC0FFF                 (base 16)                     UgMO Technologies                            
+                                                            840 First Avenue                             
+                                                            King of Prussia  PA  19406                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         CIVOLUTION                                   
+EBF000-EBFFFF                 (base 16)                     CIVOLUTION                                   
+                                                            HIGH TECH CAMPUS 9                           
+                                                            EINDHOVEN    5656 AE                         
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Pulse Communication Systems Pvt. Ltd.        
+EB0000-EB0FFF                 (base 16)                     Pulse Communication Systems Pvt. Ltd.        
+                                                            F-90/22                                      
+                                                            New Delhi  Delhi  110020                     
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Warp9 Tech Design, Inc.                      
+EAB000-EABFFF                 (base 16)                     Warp9 Tech Design, Inc.                      
+                                                            3650 Pheasant Run N.E.                       
+                                                            Blaine  MN  55449                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         BAE Systems                                  
+EAA000-EAAFFF                 (base 16)                     BAE Systems                                  
+                                                            65 Spir Brook Rd.                            
+                                                            Nashua  New Hamshire  03060                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         ThinkRF Corp                                 
+EA2000-EA2FFF                 (base 16)                     ThinkRF Corp                                 
+                                                            390 Legget Drive                             
+                                                            Ottawa  Ontario  K2K 0G7                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Robert Bosch Healthcare Systems, Inc.        
+EA0000-EA0FFF                 (base 16)                     Robert Bosch Healthcare Systems, Inc.        
+                                                            2400 Geng Road                               
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Covidence A/S                                
+EB5000-EB5FFF                 (base 16)                     Covidence A/S                                
+                                                            Strandvejen 2A                               
+                                                            Roende    8410                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Perceptive Pixel Inc.                        
+E93000-E93FFF                 (base 16)                     Perceptive Pixel Inc.                        
+                                                            102 Madison Ave.                             
+                                                            New York  NY  10016                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         GS Elektromedizinische Geraete G. Stemple GmbH
+E90000-E90FFF                 (base 16)                     GS Elektromedizinische Geraete G. Stemple GmbH
+                                                            Hauswiesenstr. 26                            
+                                                            Kaufering  Bayern  86916                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+E91000-E91FFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+E84000-E84FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Development Zone.
+                                                            Xiamen  Fujian  361006                       
+                                                            CN                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+E8E000-E8EFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lightel                                      
+E7A000-E7AFFF                 (base 16)                     Lightel                                      
+                                                            2210 Lind Ave SW. Suite 100                  
+                                                            Renton  WA  98057                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pivitec, LLC                                 
+E88000-E88FFF                 (base 16)                     Pivitec, LLC                                 
+                                                            116 Research Dr.                             
+                                                            Bethlehem  PA  18015                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Solace Systems                               
+E9A000-E9AFFF                 (base 16)                     Solace Systems                               
+                                                            535 Legget Drive                             
+                                                            Kanata,  Ontario  K2K 3B8                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         PROYECSON S.A.                               
+E96000-E96FFF                 (base 16)                     PROYECSON S.A.                               
+                                                            RONDA GUGLIELMO MARCONI Nº4                  
+                                                            PATERNA  VALENCIA  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         nicai-systems                                
+E9D000-E9DFFF                 (base 16)                     nicai-systems                                
+                                                            Am Denkmal 8                                 
+                                                            Stolberg  NRW  52223                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         UV Networks, Inc.                            
+E99000-E99FFF                 (base 16)                     UV Networks, Inc.                            
+                                                            20370 Town Center Lane, Suite 150            
+                                                            Cupertino  CA  95014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Detech Electronics ApS                       
+E61000-E61FFF                 (base 16)                     Detech Electronics ApS                       
+                                                            Oestervej 11                                 
+                                                            Ullerslev  Funen  5540                       
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Leyden Engineering                           
+E6F000-E6FFFF                 (base 16)                     Leyden Engineering                           
+                                                            PO Box 1193                                  
+                                                            San Luis Obispo  CA  93406                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         T8 Ltd                                       
+E5D000-E5DFFF                 (base 16)                     T8 Ltd                                       
+                                                            Krasnobogatyrskaya str., 44/1                
+                                                            Moscow  Moscow  107076                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         traffic network solutions s.l                
+E71000-E71FFF                 (base 16)                     traffic network solutions s.l                
+                                                            Bruc 120, pral 1ºB                           
+                                                            Barcelona    08009                           
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Kyoritsu Electric Corporation                
+E68000-E68FFF                 (base 16)                     Kyoritsu Electric Corporation                
+                                                            61-1 NAKADAHONCHO                            
+                                                            SHIZUOKA-SHI  SHIZUOKA-KEN  422-8686         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Wings for Media SL                           
+E42000-E42FFF                 (base 16)                     Wings for Media SL                           
+                                                            C/Rosari 47 4º 1ª                            
+                                                            Barcelona    08017                           
+                                                            ES                                           
+
+00-50-C2                      (hex)                         ENSIS Co., Ltd.                              
+E31000-E31FFF                 (base 16)                     ENSIS Co., Ltd.                              
+                                                            506-508 Doosanventuredigm, 1307-37           
+                                                            Dongan-gu  Anyang  431-810                   
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ENIKA.CZ                                     
+E47000-E47FFF                 (base 16)                     ENIKA.CZ                                     
+                                                            Nadrazni 609                                 
+                                                            Nova Paka    50901                           
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         DS! Ingenieurbuero                           
+E2E000-E2EFFF                 (base 16)                     DS! Ingenieurbuero                           
+                                                            Fuchsweg 17                                  
+                                                            Elchingen    89275                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ELVEES                                       
+E1F000-E1FFFF                 (base 16)                     ELVEES                                       
+                                                            Proezd  4922, dom 4, str. 2                  
+                                                            Zelenograd  Moscow  124498                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Gall Tankdatensysteme GmbH                   
+E17000-E17FFF                 (base 16)                     Gall Tankdatensysteme GmbH                   
+                                                            Schuetzenweg 6                               
+                                                            Knittlingen    75438                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rosslare Enterprises Limited                 
+E1A000-E1AFFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Tyco Traffic & Transportation                
+E01000-E01FFF                 (base 16)                     Tyco Traffic & Transportation                
+                                                            137 McCredie Rd                              
+                                                            Guildford   NSW  2161                        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Xitek Design Limited                         
+DFE000-DFEFFF                 (base 16)                     Xitek Design Limited                         
+                                                            54 Henaghans Road                            
+                                                            Palmerston North  Manawatu  4470             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Wotbox ltd                                   
+DFD000-DFDFFF                 (base 16)                     Wotbox ltd                                   
+                                                            Unit 75 Joseph Wilson Ind Est                
+                                                            Whitstable  Kent  CT5 3PS                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         NOCOSIUM                                     
+E05000-E05FFF                 (base 16)                     NOCOSIUM                                     
+                                                            15 rue Jules Romains                         
+                                                            Vaulx-en-Velin    69120                      
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Sec.Eng Systems Pty Ltd                      
+E04000-E04FFF                 (base 16)                     Sec.Eng Systems Pty Ltd                      
+                                                            20/65-75 Captain Cook drive                  
+                                                            Sydney  NSW  2229                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         EtherLight                                   
+DF5000-DF5FFF                 (base 16)                     EtherLight                                   
+                                                            12/11 Soi Prommitr                           
+                                                            Bangkok    10110                             
+                                                            TH                                           
+
+00-50-C2                      (hex)                         SEQUTEC INC                                  
+DE2000-DE2FFF                 (base 16)                     SEQUTEC INC                                  
+                                                            2958 SCOTT BLVD                              
+                                                            SANTA CLARA  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mecsel Oy                                    
+DCE000-DCEFFF                 (base 16)                     Mecsel Oy                                    
+                                                            Laitilankuja 5                               
+                                                            Helsinki    00420                            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Electronic Applications, Inc.                
+DD2000-DD2FFF                 (base 16)                     Electronic Applications, Inc.                
+                                                            2513 W via de Pedro Miguel                   
+                                                            Phoenix  AZ  85086                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vision  & Control GmbH                       
+DDC000-DDCFFF                 (base 16)                     Vision  & Control GmbH                       
+                                                            Mittelbergstrasse 16                         
+                                                            Suhl    98527                                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Comsat VertriebsgmbH                         
+DB8000-DB8FFF                 (base 16)                     Comsat VertriebsgmbH                         
+                                                            Sonnenhang 29                                
+                                                            Thalheim  Steiermark  8754                   
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Margento R&D                                 
+DBD000-DBDFFF                 (base 16)                     Margento R&D                                 
+                                                            Gosposvetska 84                              
+                                                            Maribor    2000                              
+                                                            SI                                           
+
+00-50-C2                      (hex)                         eumig industrie-tv GmbH                      
+DAF000-DAFFFF                 (base 16)                     eumig industrie-tv GmbH                      
+                                                            Gewerbeparkstr.9                             
+                                                            Salzburg  Anif  5081                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Fluid Components International               
+DC6000-DC6FFF                 (base 16)                     Fluid Components International               
+                                                            1755 La Costa Meadows Dr.                    
+                                                            San Marcos  CA  92078                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gamber Johnson LLC                           
+D9C000-D9CFFF                 (base 16)                     Gamber Johnson LLC                           
+                                                            3001 Borham Ave                              
+                                                            Stevens Point  Wisconsin   54481             
+                                                            US                                           
+
+00-50-C2                      (hex)                         T-Industry, s.r.o.                           
+D99000-D99FFF                 (base 16)                     T-Industry, s.r.o.                           
+                                                            Hostaky 910/49                               
+                                                            Myjava  Trenciansky Kraj  90701              
+                                                            SK                                           
+
+00-50-C2                      (hex)                         M & PAUL, INC                                
+DAA000-DAAFFF                 (base 16)                     M & PAUL, INC                                
+                                                            #602, Jugong Bldg.,                          
+                                                            Seoul    138-120                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         CHAUVIN ARNOUX                               
+D91000-D91FFF                 (base 16)                     CHAUVIN ARNOUX                               
+                                                            LA QUEUE DEVEE                               
+                                                            REUX  PONT L EVEQUE  14130                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         BC Illumination, Inc.                        
+D6E000-D6EFFF                 (base 16)                     BC Illumination, Inc.                        
+                                                            209 Westbury Lane                            
+                                                            Georgetown  Texas  78633                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Voltech Instruments                          
+D7D000-D7DFFF                 (base 16)                     Voltech Instruments                          
+                                                            148 Sixth Street                             
+                                                            Didcot  Oxon  OX11 0TR                       
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HMI Technologies                             
+D7F000-D7FFFF                 (base 16)                     HMI Technologies                             
+                                                            PO Box 38164                                 
+                                                            Howick  Auckland  2145                       
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         OWITA GmbH                                   
+D7B000-D7BFFF                 (base 16)                     OWITA GmbH                                   
+                                                            Langenbruch 6                                
+                                                            Lemgo  NRW  D-32657                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Transbit Sp. z o.o.                          
+D7A000-D7AFFF                 (base 16)                     Transbit Sp. z o.o.                          
+                                                            Przyczolkowa 109A                            
+                                                            Warsaw     02-968                            
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Collectric AB                                
+D75000-D75FFF                 (base 16)                     Collectric AB                                
+                                                            Regementsvagen 4                             
+                                                            Sundsvall  Medelpad  85238                   
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Telvent                                      
+D76000-D76FFF                 (base 16)                     Telvent                                      
+                                                            Valgrande, 6                                 
+                                                            Alcobendas  Madrid  28108                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ALPHA Corporation                            
+D6C000-D6CFFF                 (base 16)                     ALPHA Corporation                            
+                                                            Product Development Department, Housing Hardware Devision
+                                                            Yokohama  Kanagawa  236-0004                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Nemec Automation                             
+D6B000-D6BFFF                 (base 16)                     Nemec Automation                             
+                                                            Waldkircher Str. 12                          
+                                                            Freiburg  BW  79106                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Audio Authority Corp                         
+D82000-D82FFF                 (base 16)                     Audio Authority Corp                         
+                                                            2048 Mercer Road                             
+                                                            Lexington  Kentucky  40514                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Blankom                                      
+D83000-D83FFF                 (base 16)                     Blankom                                      
+                                                            Hermann-Petersilge-Str. 1                    
+                                                            Bad Blankenburg  TH  07422                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Computech International                      
+D74000-D74FFF                 (base 16)                     Computech International                      
+                                                            525 Northern Boulevard                       
+                                                            Great Neck  NY  11021                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+D73000-D73FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Uvax Concepts                                
+D66000-D66FFF                 (base 16)                     Uvax Concepts                                
+                                                            Parque Empresarial Tactica                   
+                                                            Paterna  Valencia  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         SELEX Communications Limited                 
+D56000-D56FFF                 (base 16)                     SELEX Communications Limited                 
+                                                            Lambda House                                 
+                                                            Basildon  Essex  SS14 3EL                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Sterna Security                              
+D55000-D55FFF                 (base 16)                     Sterna Security                              
+                                                            100 West Sambandam road                      
+                                                            Coimbatore  TN  641002                       
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Technagon GmbH                               
+D45000-D45FFF                 (base 16)                     Technagon GmbH                               
+                                                            Grafenauer Str. 22                           
+                                                            Freyung  Bavaria  94078                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+D44000-D44FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Infinition Inc.                              
+D5B000-D5BFFF                 (base 16)                     Infinition Inc.                              
+                                                            3630 Jean Talon                              
+                                                            Trois-Rivieres  QC  G8Y 2G7                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Nihon Kessho Koogaku Co., Ltd.               
+D60000-D60FFF                 (base 16)                     Nihon Kessho Koogaku Co., Ltd.               
+                                                            318-19 Kondo-cho                             
+                                                            Tatebayashi  Gunma  374-0042                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         infinitec co., ltd.                          
+D5E000-D5EFFF                 (base 16)                     infinitec co., ltd.                          
+                                                            2-6-35, Honcho                               
+                                                            Yonezawasi  Yamagata  992-0037               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         F+D Feinwerk- und Drucktechnik GmbH          
+D52000-D52FFF                 (base 16)                     F+D Feinwerk- und Drucktechnik GmbH          
+                                                            Kirchenstr. 38                               
+                                                            Neckarsteinach    69239                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Smith Meter, Inc                             
+D49000-D49FFF                 (base 16)                     Smith Meter, Inc                             
+                                                            1602 Wagner Ave                              
+                                                            Erie  PA  16514                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         AREA ENERGY, INC.                            
+D41000-D41FFF                 (base 16)                     AREA ENERGY, INC.                            
+                                                            4F-3, No.2 , Lane 258, Rui Guang Rd.         
+                                                            Taipei    114                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Tellabs Operations Inc.                      
+D3D000-D3DFFF                 (base 16)                     Tellabs Operations Inc.                      
+                                                            One Tellabs Center                           
+                                                            Naperville  Illinois  60563                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gitsn Inc.                                   
+D3B000-D3BFFF                 (base 16)                     Gitsn Inc.                                   
+                                                            #811, Woolim Ebiz Center First, 170-5        
+                                                            Seoul    152-769                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Olympus NDT Canada Inc.                      
+D1F000-D1FFFF                 (base 16)                     Olympus NDT Canada Inc.                      
+                                                            505, boul Parc Technologique                 
+                                                            Quebec    G1P 4S9                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         TECHKON GmbH                                 
+D1B000-D1BFFF                 (base 16)                     TECHKON GmbH                                 
+                                                            Wiesbadener Str. 27                          
+                                                            Koenigstein  Hessen  61462                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Apex NV                                      
+D39000-D39FFF                 (base 16)                     Apex NV                                      
+                                                            Schoebroekstraat, 62                         
+                                                            Beringen  Limburg  3583                      
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Bodensee Gravitymeter Geosystem GmbH         
+D00000-D00FFF                 (base 16)                     Bodensee Gravitymeter Geosystem GmbH         
+                                                            Im Gehren 15                                 
+                                                            Uberlingen  Baden-Württemberg  88662         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tritium Pty Ltd                              
+CFC000-CFCFFF                 (base 16)                     Tritium Pty Ltd                              
+                                                            1/31 Archimedes PL.                          
+                                                            Murarrie  QLD   4172                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Weinert Engineering GmbH                     
+D0E000-D0EFFF                 (base 16)                     Weinert Engineering GmbH                     
+                                                            An den Kolonaten 27                          
+                                                            Bad Zwischenahn  Niedersachsen  26160        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Lupatecnologia e Sistemas Ltda               
+CEF000-CEFFFF                 (base 16)                     Lupatecnologia e Sistemas Ltda               
+                                                            Rua Viscondessa Di Cavalcante, 75/301        
+                                                            Juiz de Fora  Minas Gerais  36020-070        
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Megacon AB                                   
+CBF000-CBFFFF                 (base 16)                     Megacon AB                                   
+                                                            Ranhammarsvägen 20                           
+                                                            Bromma  Stockholm  168 67                    
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Maretron, LLP                                
+CE5000-CE5FFF                 (base 16)                     Maretron, LLP                                
+                                                            9014 N. 23rd Ave #10                         
+                                                            Phoenix  AZ  85021                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Axotec Technologies GmbH                     
+CDE000-CDEFFF                 (base 16)                     Axotec Technologies GmbH                     
+                                                            Sudetenstraße 88                             
+                                                            Geretsried  Bavaria  82538                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kiefer technic GmbH                          
+CA0000-CA0FFF                 (base 16)                     Kiefer technic GmbH                          
+                                                            Feldbacher Strasse 77                        
+                                                            Bad Gleichenberg  Styria  8344               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Pacific Coast Engineering                    
+CAD000-CADFFF                 (base 16)                     Pacific Coast Engineering                    
+                                                            1524 Fernwood Drive                          
+                                                            Oakland  CA  94611                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         PURVIS Systems Incorporated                  
+CAC000-CACFFF                 (base 16)                     PURVIS Systems Incorporated                  
+                                                            1272 West Main Rd                            
+                                                            Middletown  Rhode Island  02842              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+CB5000-CB5FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         inotech GmbH                                 
+CB7000-CB7FFF                 (base 16)                     inotech GmbH                                 
+                                                            Siemensallee 84                              
+                                                            Karlsruhe  BW  76187                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         YOKOWO CO.,LTD                               
+CA5000-CA5FFF                 (base 16)                     YOKOWO CO.,LTD                               
+                                                            5-11 Takinogawa 7-Chome Kita-ku              
+                                                            Tokyo    114-8515                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Moravian Instruments                         
+CB2000-CB2FFF                 (base 16)                     Moravian Instruments                         
+                                                            Masarykova 1148                              
+                                                            Zlin    763 02                               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Konsmetal S.A.                               
+CB0000-CB0FFF                 (base 16)                     Konsmetal S.A.                               
+                                                            Bracka 25 St.                                
+                                                            Warsaw    00-028                             
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+C8F000-C8FFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Emergency Message Controls LLC               
+C8D000-C8DFFF                 (base 16)                     Emergency Message Controls LLC               
+                                                            5 Canterbury Rd                              
+                                                            Charlottesville  VA  22903                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Reko-vek                                     
+C80000-C80FFF                 (base 16)                     Reko-vek                                     
+                                                            Gornaya str. 17A                             
+                                                              Nizhni Novgorod Region  603062             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Keysight Technologies Inc.                   
+C7C000-C7CFFF                 (base 16)                     Keysight Technologies Inc.                   
+                                                            Lise-Meitner-Allee 27                        
+                                                            Bochum    44801                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CODESYSTEM Co.,Ltd                           
+C79000-C79FFF                 (base 16)                     CODESYSTEM Co.,Ltd                           
+                                                            #705 Ace Techno Tower-9th 345-30             
+                                                            Seoul    153-802                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Practical Control Ltd                        
+C67000-C67FFF                 (base 16)                     Practical Control Ltd                        
+                                                            443 Brightside Lane                          
+                                                            Sheffield  South Yorkshire  S9 2RS           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HPC Platform                                 
+C54000-C54FFF                 (base 16)                     HPC Platform                                 
+                                                            63 rue Madeleine Michelis                    
+                                                            Neuilly Sur Seine    92200                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Smartfield, Inc.                             
+C52000-C52FFF                 (base 16)                     Smartfield, Inc.                             
+                                                            2601 SE Loop 289                             
+                                                            Lubbock  TX  79404                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SweMet AB                                    
+C5D000-C5DFFF                 (base 16)                     SweMet AB                                    
+                                                            Östgötagatan 19                              
+                                                            Linköping    58232                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Commotive A/S                                
+C5A000-C5AFFF                 (base 16)                     Commotive A/S                                
+                                                            Rebildskovhusevej 17                         
+                                                            Skørping    DK-9520                          
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Powersense A/S                               
+C4F000-C4FFFF                 (base 16)                     Powersense A/S                               
+                                                            Skovlytoften 33                              
+                                                            Holte  Sealand  2840                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         GridManager A/S                              
+C76000-C76FFF                 (base 16)                     GridManager A/S                              
+                                                            Livovej 21                                   
+                                                            Viborg    8800                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Quail                                        
+C72000-C72FFF                 (base 16)                     Quail                                        
+                                                            92 Lots Road                                 
+                                                            London    SW10 0QD                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         COMPRION GmbH                                
+C41000-C41FFF                 (base 16)                     COMPRION GmbH                                
+                                                            Technologiepark 25                           
+                                                            Paderborn    33100                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sysacom                                      
+C3E000-C3EFFF                 (base 16)                     Sysacom                                      
+                                                            324 St-Paul                                  
+                                                            Le Gardeur  Québec  J5Z4H9                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         4D Technology Corporation                    
+C31000-C31FFF                 (base 16)                     4D Technology Corporation                    
+                                                            3280 E. Hemisphere Loop,                     
+                                                            Tucson  Arizona  85706                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         bach-messtechnik gmbh                        
+C2C000-C2CFFF                 (base 16)                     bach-messtechnik gmbh                        
+                                                            Gotzweg 103                                  
+                                                            Monchengladbach    41238                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ELEKTRO-AUTOMATIK GmbH & Co. KG              
+C3B000-C3BFFF                 (base 16)                     ELEKTRO-AUTOMATIK GmbH & Co. KG              
+                                                            Helmholtzstraße 31-33                        
+                                                            Viersen  NRW  41747                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SECAD SA                                     
+C39000-C39FFF                 (base 16)                     SECAD SA                                     
+                                                            Zac des Pellants                             
+                                                            St Martin du Fresne    01430                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Austco Communication Systems Pty Ltd         
+C26000-C26FFF                 (base 16)                     Austco Communication Systems Pty Ltd         
+                                                            40 O'Malley Street                           
+                                                            Osborne Park  Western Australia  6017        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Audient Ltd                                  
+C22000-C22FFF                 (base 16)                     Audient Ltd                                  
+                                                            1 Stable Court                               
+                                                            Herriard  Hampshire  RG25 2PL                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Ibercomp SA                                  
+C19000-C19FFF                 (base 16)                     Ibercomp SA                                  
+                                                            C/Lluis Alemany i Pujol 4                    
+                                                            Palma de Mallorca  Baleares  07010           
+                                                            ES                                           
+
+00-50-C2                      (hex)                         SAM Co., Ltd.                                
+C1A000-C1AFFF                 (base 16)                     SAM Co., Ltd.                                
+                                                            Meguro F2 Building                           
+                                                            Meguro-ku  Tokyo  153-0061                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Graesslin GmbH                               
+C1B000-C1BFFF                 (base 16)                     Graesslin GmbH                               
+                                                            Bundesstraße 36                              
+                                                            St. Georgen  Baden-Württemberg  78112        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Procon Electronics                           
+C32000-C32FFF                 (base 16)                     Procon Electronics                           
+                                                            PO Box 164                                   
+                                                            Sydney  NSW  1730                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Elektronic Thoma GmbH                        
+C49000-C49FFF                 (base 16)                     Elektronic Thoma GmbH                        
+                                                            Friedhofweg 5                                
+                                                            Dentlein a/F.    91599                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Dantec Dynamics A/S                          
+C13000-C13FFF                 (base 16)                     Dantec Dynamics A/S                          
+                                                            Tonsbakken 16-18                             
+                                                            Skovlunde    2740                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         ART Antriebs- und Regeltechnik GmbH          
+C11000-C11FFF                 (base 16)                     ART Antriebs- und Regeltechnik GmbH          
+                                                            2.Industriestrasse 8                         
+                                                            Hockenheim    68766                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ProSourcing GmbH                             
+C0B000-C0BFFF                 (base 16)                     ProSourcing GmbH                             
+                                                            Dorfmatt 1                                   
+                                                            Muntelier  Freiburg  3286                    
+                                                            CH                                           
+
+00-50-C2                      (hex)                         SOCIEDAD IBERICA DE CONSTRUCCIONES ELECTRICAS, S.A. (SICE)
+BEF000-BEFFFF                 (base 16)                     SOCIEDAD IBERICA DE CONSTRUCCIONES ELECTRICAS, S.A. (SICE)
+                                                            C/Sepulveda, 6                               
+                                                            ALCOBENDAS  MADRID  28108                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Ingeteam Paneles S.A.U.                      
+BFE000-BFEFFF                 (base 16)                     Ingeteam Paneles S.A.U.                      
+                                                            Pol Ind El Juncarillo, nave 1                
+                                                            Sesma  Navarra  31293                        
+                                                            ES                                           
+
+00-50-C2                      (hex)                         OMICRON electronics GmbH                     
+C16000-C16FFF                 (base 16)                     OMICRON electronics GmbH                     
+                                                            Oberes Ried 1                                
+                                                            Klaus    A-6833                              
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Galaxia Electronics                          
+BC0000-BC0FFF                 (base 16)                     Galaxia Electronics                          
+                                                            #1307 Tech Center, SK Technopark             
+                                                            Seongnamsi  Gyeonggido  462-721              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ImpactSystems                                
+BBC000-BBCFFF                 (base 16)                     ImpactSystems                                
+                                                            15-10-206 Satsukigaoka-Minami                
+                                                            Suita  Osaka  565-0832                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Onlinepizza Norden AB                        
+BBE000-BBEFFF                 (base 16)                     Onlinepizza Norden AB                        
+                                                            Strandbergsgatan 61                          
+                                                            Stockholm    112 51                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+BEB000-BEBFFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nextmove Technologies                        
+BC9000-BC9FFF                 (base 16)                     Nextmove Technologies                        
+                                                            38 Taylor Drive                              
+                                                            Brookline  New Hampshire  03033              
+                                                            US                                           
+
+00-50-C2                      (hex)                         TV Portal Co., Ltd.                          
+BCE000-BCEFFF                 (base 16)                     TV Portal Co., Ltd.                          
+                                                            5F TATENO, 6-4-13 Kiba Koto                  
+                                                            Tokyo    135-0042                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Global Security Devices                      
+BD4000-BD4FFF                 (base 16)                     Global Security Devices                      
+                                                            S12-S14 Synergy Centre                       
+                                                            Dublin    D24                                
+                                                            IE                                           
+
+00-50-C2                      (hex)                         ClimateWell AB (publ)                        
+BB3000-BB3FFF                 (base 16)                     ClimateWell AB (publ)                        
+                                                            Instrumentvagen 20                           
+                                                            Hagersten    12653                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         St Michael Strategies Inc                    
+BB2000-BB2FFF                 (base 16)                     St Michael Strategies Inc                    
+                                                            701 Salaberry suite 201                      
+                                                            Chambly  Quebec  J3L 1R2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+B8C000-B8CFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CEMSI                                        
+B8D000-B8DFFF                 (base 16)                     CEMSI                                        
+                                                            780 Keezletown Road                          
+                                                            Weyers Cave  VA  24486                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         RaumComputer Entwicklungs- und Vertriebs GmbH
+BA7000-BA7FFF                 (base 16)                     RaumComputer Entwicklungs- und Vertriebs GmbH
+                                                            Augartenstraße 1                             
+                                                            Karlsruhe  Baden-Württemberg  76137          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Toptech Systems, Inc.                        
+BB9000-BB9FFF                 (base 16)                     Toptech Systems, Inc.                        
+                                                            280 Hunt Park Cove                           
+                                                            Longwood  FL  32750                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         GHL Advanced Technolgy GmbH & Co. KG         
+B81000-B81FFF                 (base 16)                     GHL Advanced Technolgy GmbH & Co. KG         
+                                                            Jung-Stilling-Straße 21                      
+                                                            Kaiserslautern  Rheinland-Pfalz  67663       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Gigatronik  Köln GmbH                        
+B88000-B88FFF                 (base 16)                     Gigatronik  Köln GmbH                        
+                                                            Ruth-Hallensleben-Straße 4                   
+                                                            Köln    50739                                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SilverNet                                    
+B85000-B85FFF                 (base 16)                     SilverNet                                    
+                                                            16 Cochran Close                             
+                                                            Milton Keynes  Bucks  MK8 0AJ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         8185                                         
+B66000-B66FFF                 (base 16)                     8185                                         
+                                                            Paffrather Str. 140                          
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Schnoor Industrieelektronik GmbH & Co. KG    
+B7A000-B7AFFF                 (base 16)                     Schnoor Industrieelektronik GmbH & Co. KG    
+                                                            Fehmarnstr. 6                                
+                                                            Buedelsdorf  Schleswig-Holstein  24782       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ARKRAY, Inc. Kyoto Laboratory                
+B73000-B73FFF                 (base 16)                     ARKRAY, Inc. Kyoto Laboratory                
+                                                            Yousuien-nai                                 
+                                                            Kyoto  Kamigyo-ku  602-0008                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Nisshin Electronics co.,ltd.                 
+B70000-B70FFF                 (base 16)                     Nisshin Electronics co.,ltd.                 
+                                                            2-1-7 Taiho                                  
+                                                            Nagoya-shi  Aichi-ken  4560062               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Enatel                                       
+B7F000-B7FFFF                 (base 16)                     Enatel                                       
+                                                            321 Tuam Street                              
+                                                            Christchurch    8032                         
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Drinelec                                     
+B6C000-B6CFFF                 (base 16)                     Drinelec                                     
+                                                            Les Chovets                                  
+                                                            Barbières    26300                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         M-Tronic Design and Technology GmbH          
+B3F000-B3FFFF                 (base 16)                     M-Tronic Design and Technology GmbH          
+                                                            Im Großen Gunterstal 8                       
+                                                            Blieskastel  Saarland  66440                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Meisol co.,ltd                               
+B34000-B34FFF                 (base 16)                     Meisol co.,ltd                               
+                                                            NAKA-KU YAMASHITA-CHO 74-1                   
+                                                            YOKOHAMA-SHI  KANAGAWA-KEN  231-0023         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Sencon UK Ltd.                               
+B4F000-B4FFFF                 (base 16)                     Sencon UK Ltd.                               
+                                                            Stonebridge Cross Business Park              
+                                                            Droitwich  Worcestershire  WR9 0LW           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ElectroCom                                   
+B4C000-B4CFFF                 (base 16)                     ElectroCom                                   
+                                                            Torvet 5                                     
+                                                            Svendborg  Fyn  5700                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         MCS MICRONIC Computer Systeme GmbH           
+B47000-B47FFF                 (base 16)                     MCS MICRONIC Computer Systeme GmbH           
+                                                            Ullsteinstr. 114, Turm C                     
+                                                            Berlin    12109                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Palgiken Co.,Ltd.                            
+B5E000-B5EFFF                 (base 16)                     Palgiken Co.,Ltd.                            
+                                                            2217-2 Hayashicho                            
+                                                            Takamatsu  Kagawa  761-0301                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Telegenix                                    
+B1D000-B1DFFF                 (base 16)                     Telegenix                                    
+                                                            71 Indel Ave.                                
+                                                            Rancocas  NJ  08073                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Integrated  Control Corp.                    
+B1B000-B1BFFF                 (base 16)                     Integrated  Control Corp.                    
+                                                            748 Park Ave                                 
+                                                            Huntington  NY  11743                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Rosslare Enterprises Limited                 
+B18000-B18FFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Micromax Pty. Ltd.                           
+B28000-B28FFF                 (base 16)                     Micromax Pty. Ltd.                           
+                                                            5 Orangegrove Ave                            
+                                                            Unanderra  NSW  2526                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Elko Systems                                 
+B26000-B26FFF                 (base 16)                     Elko Systems                                 
+                                                            11 clair road Lynnwood Glen                  
+                                                            Pretoria  Gauteng  0081                      
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Japan Electronics System, Inc                
+B0D000-B0DFFF                 (base 16)                     Japan Electronics System, Inc                
+                                                            Sanno 3-45-3                                 
+                                                            Ota ku  Tokyo  143-0023                      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+B00000-B00FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         U-CARE INC.                                  
+ACB000-ACBFFF                 (base 16)                     U-CARE INC.                                  
+                                                            Room no. 407, Medical industry venture center
+                                                            Kangwon-do    220-842                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Green Goose                                  
+AF1000-AF1FFF                 (base 16)                     Green Goose                                  
+                                                            6025 SW Taylor St.                           
+                                                            Portland  OR  97221                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         AT4 wireless.S.A                             
+AE0000-AE0FFF                 (base 16)                     AT4 wireless.S.A                             
+                                                            c/ Severo Ochoa 2                            
+                                                            Campanillas  Málaga  29590                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+AD1000-AD1FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+AF2000-AF2FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         E-Motion System, Inc.                        
+AC5000-AC5FFF                 (base 16)                     E-Motion System, Inc.                        
+                                                            5-21-3 Nishi-Gotanda Shinagawa-ku            
+                                                            Tokyo    141-0031                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Showtacle                                    
+AB9000-AB9FFF                 (base 16)                     Showtacle                                    
+                                                            Pecnianska 21                                
+                                                            Bratislava    85101                          
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Endeas Oy                                    
+AA7000-AA7FFF                 (base 16)                     Endeas Oy                                    
+                                                            Heimolantie 6                                
+                                                            Espoo    02330                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         ProCom Systems, Inc.                         
+AB2000-AB2FFF                 (base 16)                     ProCom Systems, Inc.                         
+                                                            5100 Coachman Road                           
+                                                            Bettendorf  IA  52722                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         LIMAB AB                                     
+A86000-A86FFF                 (base 16)                     LIMAB AB                                     
+                                                            Almedalsvägen                                
+                                                            Göteborg    41263                            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Smith Meter, Inc.                            
+AA0000-AA0FFF                 (base 16)                     Smith Meter, Inc.                            
+                                                            1602 Wagner Ave.                             
+                                                            Erie  PA  16514                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Haivision Systems Inc                        
+A99000-A99FFF                 (base 16)                     Haivision Systems Inc                        
+                                                            4445 Garand                                  
+                                                            Montreal  QC  H4R 2H9                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Absolutron. LLC                              
+A9A000-A9AFFF                 (base 16)                     Absolutron. LLC                              
+                                                            1107 Fair Oaks Ave. #476                     
+                                                            South Pasadena  CA  91030                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         SPX Dehydration & Filtration                 
+A93000-A93FFF                 (base 16)                     SPX Dehydration & Filtration                 
+                                                            4647 S.W. 40th Ave.                          
+                                                            Ocala  FL  34474                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Par-Tech, Inc.                               
+A94000-A94FFF                 (base 16)                     Par-Tech, Inc.                               
+                                                            139 Premier Dr.                              
+                                                            Lake Orion  MI  48359                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         FEP SRL                                      
+A96000-A96FFF                 (base 16)                     FEP SRL                                      
+                                                            VIA MODENA, 68                               
+                                                            SAN GIOVANNI IN PERSICETO  BOLOGNA  40017    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         i-RED Infrarot Systeme GmbH                  
+A50000-A50FFF                 (base 16)                     i-RED Infrarot Systeme GmbH                  
+                                                            Hafenstr. 47-51                              
+                                                            Linz  Upper Austria  4020                    
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Deuta GmbH                                   
+A4F000-A4FFFF                 (base 16)                     Deuta GmbH                                   
+                                                            Paffrather Str. 140                          
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Conduant Corporation                         
+A4E000-A4EFFF                 (base 16)                     Conduant Corporation                         
+                                                            1501 S. Sunset St.                           
+                                                            Longmont  CO  80501                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Orange Tree Technologies                     
+A7B000-A7BFFF                 (base 16)                     Orange Tree Technologies                     
+                                                            Harwell Innovation Centre                    
+                                                            Didcot  Oxfordshire  OX110QG                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         X-Pert Paint Mixing Systems                  
+A68000-A68FFF                 (base 16)                     X-Pert Paint Mixing Systems                  
+                                                            2715 Lincoln Drive                           
+                                                            Roseville  MN  55113                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         DVTech                                       
+A66000-A66FFF                 (base 16)                     DVTech                                       
+                                                            10 Kehilat Venezia st.                       
+                                                            Tel Aviv  Israel  69400                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Alga Microwave Inc                           
+A5F000-A5FFFF                 (base 16)                     Alga Microwave Inc                           
+                                                            2109 St Regis                                
+                                                            Dollard-des-Ormeaux  QC  H9B 2M9             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+A25000-A25FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Quorum Technologies Ltd                      
+A20000-A20FFF                 (base 16)                     Quorum Technologies Ltd                      
+                                                            South Stour Avenue                           
+                                                            Ashford  Kent  TN23 7RS                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         MAMAC Systems, Inc.                          
+A1E000-A1EFFF                 (base 16)                     MAMAC Systems, Inc.                          
+                                                            8189 Century Blvd.                           
+                                                            Chanhassen  Minnesota  55317-8002            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Flight Data Systems Pty Ltd                  
+A1F000-A1FFFF                 (base 16)                     Flight Data Systems Pty Ltd                  
+                                                            31 Mc Gregors Drive                          
+                                                            Keilor Park  Victoria  3042                  
+                                                            AU                                           
+
+00-50-C2                      (hex)                         SAMH Engineering Services                    
+A1D000-A1DFFF                 (base 16)                     SAMH Engineering Services                    
+                                                            1 Leopardstown Drive                         
+                                                            Dublin    Co.                                
+                                                            IE                                           
+
+00-50-C2                      (hex)                         DITRON S.r.l.                                
+A4A000-A4AFFF                 (base 16)                     DITRON S.r.l.                                
+                                                            Via Antiniana, 115                           
+                                                            Pozzuoli  Napoli  80078                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Elbit Systems of America - Tallahassee Operations
+A14000-A14FFF                 (base 16)                     Elbit Systems of America - Tallahassee Operations
+                                                            1721 W. Paul Dirac Drive                     
+                                                            Tallahassee  Florida  32310                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Winners Satellite Electronics Corp.          
+A17000-A17FFF                 (base 16)                     Winners Satellite Electronics Corp.          
+                                                            3F, NO. 4, LANE 263, CHUNG YANG RD., TAIPEI 115, TAIWAN
+                                                            TAIPEI    115                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Sofradir-EC                                  
+A45000-A45FFF                 (base 16)                     Sofradir-EC                                  
+                                                            373 Route 46 West                            
+                                                            Fairfield  NJ  07004                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrial Data Products Ltd                 
+A39000-A39FFF                 (base 16)                     Industrial Data Products Ltd                 
+                                                            The Studio                                   
+                                                            Cwmbran  Gwent  NP44 3JU                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SPECTRA EMBEDDED SYSTEMS                     
+9FE000-9FEFFF                 (base 16)                     SPECTRA EMBEDDED SYSTEMS                     
+                                                            Khasra No. 24, Village Ghumman,1st Floor, Chawla Mansion,
+                                                            Parwanoo  Himachal Pradesh  173 220          
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Technovare Systems                           
+A00000-A00FFF                 (base 16)                     Technovare Systems                           
+                                                            1675 Scenic Ave. Suite 200                   
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrial Computing Ltd                     
+A15000-A15FFF                 (base 16)                     Industrial Computing Ltd                     
+                                                            Elmcroft                                     
+                                                            Gillingham  Dorset  SP8 4NG                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Visualware Inc                               
+A0F000-A0FFFF                 (base 16)                     Visualware Inc                               
+                                                            PO Box 668                                   
+                                                            Turlock  California  95381                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Innovative American Technology               
+A09000-A09FFF                 (base 16)                     Innovative American Technology               
+                                                            4800 Lyons Technology Pkwy, Ste 3            
+                                                            Coconut Creek  FL  33073                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         DST Swiss AG                                 
+9E0000-9E0FFF                 (base 16)                     DST Swiss AG                                 
+                                                            Schuebelbachstrasse 3                        
+                                                            Eglisau  ZH  8193                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ECTEC INC.                                   
+9FC000-9FCFFF                 (base 16)                     ECTEC INC.                                   
+                                                            632 Rancho Vista Blvd.                       
+                                                            Palmdale  CA  93550                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kumho Electric, Inc.                         
+9E6000-9E6FFF                 (base 16)                     Kumho Electric, Inc.                         
+                                                            211-1, Jangji-Ri, Dongtan-myun,              
+                                                            Hwasung City  Kyonggi-Do  445-812            
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Teranex A Division of Silicon Optix          
+9FA000-9FAFFF                 (base 16)                     Teranex A Division of Silicon Optix          
+                                                            12600 Challenger Parkway                     
+                                                            Orlando  FL  32826-2700                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Commex Technologies                          
+9F5000-9F5FFF                 (base 16)                     Commex Technologies                          
+                                                            4 Hanechoshet St.                            
+                                                            Tel Aviv    69719                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         ESAB-ATAS GmbH                               
+9CA000-9CAFFF                 (base 16)                     ESAB-ATAS GmbH                               
+                                                            Liebigstraße 16                              
+                                                            Seligenstadt  Hessen  63500                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ronan Engineering                            
+9CE000-9CEFFF                 (base 16)                     Ronan Engineering                            
+                                                            21200 Oxnard St.                             
+                                                            Woodland Hills  CA  91367                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sound Player Systems e.K.                    
+9B8000-9B8FFF                 (base 16)                     Sound Player Systems e.K.                    
+                                                            Max-Volmer-Strasse 27                        
+                                                            Hilden  NRW  40721                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kahler Automation                            
+9B3000-9B3FFF                 (base 16)                     Kahler Automation                            
+                                                            808 Timberlake Rd                            
+                                                            Fairmont  MN  56031                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bon Hora GmbH                                
+9B1000-9B1FFF                 (base 16)                     Bon Hora GmbH                                
+                                                            Steinbuehlstrasse 15b                        
+                                                            Wetzlar  Hessen  35578                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ethermetrics                                 
+9C8000-9C8FFF                 (base 16)                     ethermetrics                                 
+                                                            1223 peoples ave                             
+                                                            Troy  New York  12180                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         J. DITTRICH ELEKTRONIC GmbH & Co. KG         
+9D0000-9D0FFF                 (base 16)                     J. DITTRICH ELEKTRONIC GmbH & Co. KG         
+                                                            Bahnhofstraße 67                             
+                                                            Baden-Baden / Haueneberstein  Baden-Württemberg  76532
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Entwicklung Hard- & Software                 
+9A4000-9A4FFF                 (base 16)                     Entwicklung Hard- & Software                 
+                                                            Berlinerstr. 9                               
+                                                            Schoenaich  BW  71101                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CaTs3 Limited                                
+99C000-99CFFF                 (base 16)                     CaTs3 Limited                                
+                                                            21 Lindisfarne Drive                         
+                                                            Kenilworth  Warwickshire  CV8 2PQ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Sietron Elektronik                           
+99F000-99FFFF                 (base 16)                     Sietron Elektronik                           
+                                                            Mittere Feldstrasse 5                        
+                                                            Freilassing    83395                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Chronos Technology Ltd.                      
+9AD000-9ADFFF                 (base 16)                     Chronos Technology Ltd.                      
+                                                            Stowfield House                              
+                                                            Lydbrook  Gloucestershire  GL17 9PD          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         TEKO TELECOM SpA                             
+9AA000-9AAFFF                 (base 16)                     TEKO TELECOM SpA                             
+                                                            Via dell' Industria, 5                       
+                                                            San Lazzaro di Savena  Bologna  40068        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Bettini srl                                  
+99B000-99BFFF                 (base 16)                     Bettini srl                                  
+                                                            Via Cesare Battisti 22                       
+                                                            Cesano Maderno  Milano  I - 20031            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Depro Électronique                           
+997000-997FFF                 (base 16)                     Depro Électronique                           
+                                                            755 Curé-Boivin                              
+                                                            Boisbriand  Québec  J7G2J2                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Commercial Timesharing Inc.                  
+996000-996FFF                 (base 16)                     Commercial Timesharing Inc.                  
+                                                            2740 Cory Ave.                               
+                                                            Akron  OH  44314                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computerwise, Inc.                           
+9A3000-9A3FFF                 (base 16)                     Computerwise, Inc.                           
+                                                            302 N. Winchester                            
+                                                            Olathe  KS  66062                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Metodo2                                      
+9A6000-9A6FFF                 (base 16)                     Metodo2                                      
+                                                            Via IV Novembre 11                           
+                                                            Cologno Monzese  MI  20093                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Earnestcom Sdn Bhd                           
+985000-985FFF                 (base 16)                     Earnestcom Sdn Bhd                           
+                                                            57B, JLN PU 7/4, Bandar Puchong Utama,       
+                                                            47100  Selangor                              
+                                                            MY                                           
+
+00-50-C2                      (hex)                         Atel Corporation                             
+984000-984FFF                 (base 16)                     Atel Corporation                             
+                                                            2-18-10, NISHISHINGAI-CHO                    
+                                                            FUKUYAMA-SHI  HIROSHIMA  721-0958            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Novotronik GmbH                              
+981000-981FFF                 (base 16)                     Novotronik GmbH                              
+                                                            Baeumenheimer Strasse 3                      
+                                                            Mertingen  Bavaria  86690                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RF Industries                                
+97E000-97EFFF                 (base 16)                     RF Industries                                
+                                                            PO Box 5                                     
+                                                            Welland  SA  5007                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Pyramid Technical Consultants                
+975000-975FFF                 (base 16)                     Pyramid Technical Consultants                
+                                                            1050 Waltham St                              
+                                                            Lexington  MA  02421                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gehrke Kommunikationssysteme GmbH            
+969000-969FFF                 (base 16)                     Gehrke Kommunikationssysteme GmbH            
+                                                            Seligenportenerstr. 30                       
+                                                            Allersberg    90584                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Watthour Engineering Co., Inc.               
+967000-967FFF                 (base 16)                     Watthour Engineering Co., Inc.               
+                                                            333 Crosspark Dr                             
+                                                            Pearl  MS  39208                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+96E000-96EFFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+977000-977FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Roessmann Engineering                        
+955000-955FFF                 (base 16)                     Roessmann Engineering                        
+                                                            Pachernweg 11                                
+                                                            Hart bei Graz  Steiermark  8075              
+                                                            AT                                           
+
+00-50-C2                      (hex)                         IMEXHIGHWAY cvba                             
+947000-947FFF                 (base 16)                     IMEXHIGHWAY cvba                             
+                                                            Port Arthurlaan 15                           
+                                                            GHENT  Oost-Vlaanderen  9000                 
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Rolbit                                       
+941000-941FFF                 (base 16)                     Rolbit                                       
+                                                            Shoham 21                                    
+                                                            Barkan  Israel  44820                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Reliatronics Inc.                            
+93B000-93BFFF                 (base 16)                     Reliatronics Inc.                            
+                                                            1858 Ranch Road 3232                         
+                                                            Johnson City  TX  78636                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+92F000-92FFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rosendahl Studiotechnik GmbH                 
+91D000-91DFFF                 (base 16)                     Rosendahl Studiotechnik GmbH                 
+                                                            Andechser Str. 5                             
+                                                            Utting am Ammersee  Bayern  86919            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+933000-933FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         APProSoftware.com                            
+92D000-92DFFF                 (base 16)                     APProSoftware.com                            
+                                                            Bulwar Ikara 29A/2                           
+                                                            Wroclaw  Dolnoslaskie  54-130                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         RCS Communication Test Systems Ltd.          
+93E000-93EFFF                 (base 16)                     RCS Communication Test Systems Ltd.          
+                                                            4 Nahal Yavniel Str.                         
+                                                            Modiin    71700                              
+                                                            IL                                           
+
+00-50-C2                      (hex)                         China Railway Signal & Communication Corp.   
+902000-902FFF                 (base 16)                     China Railway Signal & Communication Corp.   
+                                                            B49 Xisihuan Nanlu,Fengtai District,         
+                                                              Beijing  100071                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         INTEGRA Biosciences AG                       
+90F000-90FFFF                 (base 16)                     INTEGRA Biosciences AG                       
+                                                            Schoenbuehlstrasse 8                         
+                                                            Chur  Graubuenden  7000                      
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+90E000-90EFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Gidel                                        
+906000-906FFF                 (base 16)                     Gidel                                        
+                                                            Hailan St 2                                  
+                                                            Or Akiva    30600                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Balfour Beatty Rail GmbH                     
+8EC000-8ECFFF                 (base 16)                     Balfour Beatty Rail GmbH                     
+                                                            Garmischer Str. 35                           
+                                                            Munich  Germany  81373                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AT-Automation Technology GmbH                
+8ED000-8EDFFF                 (base 16)                     AT-Automation Technology GmbH                
+                                                            Hermann-Boessow-Str. 6-8                     
+                                                            Bad Oldesloe    D-23843                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sandel Avionics, Inc.                        
+8E6000-8E6FFF                 (base 16)                     Sandel Avionics, Inc.                        
+                                                            2401 Dogwood Way                             
+                                                            Vista  CA  92081                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Coherix, Inc                                 
+8DE000-8DEFFF                 (base 16)                     Coherix, Inc                                 
+                                                            3980 Ranchero Dr                             
+                                                            Ann Arbor  MI  48108                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Frame Systems Limited                        
+8DC000-8DCFFF                 (base 16)                     Frame Systems Limited                        
+                                                            The Yard                                     
+                                                            Hungerford  Berkshire  RG17 0BP              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PCSC                                         
+8EE000-8EEFFF                 (base 16)                     PCSC                                         
+                                                            3541 Challenger Street                       
+                                                            Torrance  CA  90503                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Soldig Industria e Comercio de Equipamentos Eletronicos LTDA
+8C4000-8C4FFF                 (base 16)                     Soldig Industria e Comercio de Equipamentos Eletronicos LTDA
+                                                            Av. Ipiranga 6681 Building 94 Room 7         
+                                                            Porto Alegre  RS  90619-900                  
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Gradual Tecnologia Ltda.                     
+8C6000-8C6FFF                 (base 16)                     Gradual Tecnologia Ltda.                     
+                                                            Rua Attilio Giaretta, 110                    
+                                                            Itatiba  SP  13257-584                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Heraeus Noblelight GmbH                      
+8C1000-8C1FFF                 (base 16)                     Heraeus Noblelight GmbH                      
+                                                            Heraeusstrasse 12-14                         
+                                                            Hanau  Hessen  63450                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         VTQ Videtronik GmbH                          
+8B3000-8B3FFF                 (base 16)                     VTQ Videtronik GmbH                          
+                                                            Gruene Str. 2                                
+                                                            Querfurt  Saxon-Anhalt  06268                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sandar Telecast AS                           
+8B4000-8B4FFF                 (base 16)                     Sandar Telecast AS                           
+                                                            Borgeskogen                                  
+                                                            Stokke    3160                               
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Polygon Informatics Ltd.                     
+8D7000-8D7FFF                 (base 16)                     Polygon Informatics Ltd.                     
+                                                            Kalvaria sgt. 24.                            
+                                                            Szeged    H-6722                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Array Technologies Inc                       
+8D8000-8D8FFF                 (base 16)                     Array Technologies Inc                       
+                                                            160 Oak Street                               
+                                                            Glastonbury  CT  06033                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         TTi Ltd                                      
+8D2000-8D2FFF                 (base 16)                     TTi Ltd                                      
+                                                            Glebe Road                                   
+                                                            Huntingdon  Cambridgeshire  PE29 7DR         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         LyconSys GmbH & Co.KG                        
+8CC000-8CCFFF                 (base 16)                     LyconSys GmbH & Co.KG                        
+                                                            Schleusenstr. 9                              
+                                                            Frankfurt am Main  Hesse  60327              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Broadcast Electronics                        
+89E000-89EFFF                 (base 16)                     Broadcast Electronics                        
+                                                            4100 N. 24th                                 
+                                                            Quincy  IL  62305                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Optoelettronica Italia S.r.l.                
+87F000-87FFFF                 (base 16)                     Optoelettronica Italia S.r.l.                
+                                                            via Vienna 8                                 
+                                                            Trento  Trento  38121                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Continental Electronics Corp.                
+88A000-88AFFF                 (base 16)                     Continental Electronics Corp.                
+                                                            4212 S. Buckner Blvd.                        
+                                                            Dallas  TX  75227                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nanomotion Ltd.                              
+8AB000-8ABFFF                 (base 16)                     Nanomotion Ltd.                              
+                                                            Mordot HaCarmel Industrial Park              
+                                                            Yokneam    20692                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Blankom                                      
+896000-896FFF                 (base 16)                     Blankom                                      
+                                                            Hermann-Petersilge-Str. 1                    
+                                                            Bad Blankenburg  Thuringia  07422            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Shockfish SA                                 
+894000-894FFF                 (base 16)                     Shockfish SA                                 
+                                                            Parc Scientifique                            
+                                                            Lausanne  VD  1015                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         BAE Systems Hägglunds AB                     
+890000-890FFF                 (base 16)                     BAE Systems Hägglunds AB                     
+                                                            Björnavägen 41                               
+                                                            Örnsköldsvik  Västernorrland  891 82        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         UAVNavigation S.L.                           
+87B000-87BFFF                 (base 16)                     UAVNavigation S.L.                           
+                                                            Av. Doctor Severo Ochoa                      
+                                                            Alcobendas  Madrid  28100                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Spectrum Management, LC                      
+87A000-87AFFF                 (base 16)                     Spectrum Management, LC                      
+                                                            1020 Hoosier Dr.                             
+                                                            Larkspur  CO  80118                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Syntronics                                   
+867000-867FFF                 (base 16)                     Syntronics                                   
+                                                            3500 Shannon Park Dr.                        
+                                                            Fredericksburg  VA  22408                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ATG Automatisierungstechnik GERA GmbH        
+864000-864FFF                 (base 16)                     ATG Automatisierungstechnik GERA GmbH        
+                                                            Keplerstr. 10-12                             
+                                                            Gera  Thuringia  07549                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ettus Research LLC                           
+853000-853FFF                 (base 16)                     Ettus Research LLC                           
+                                                            1043 N Shoreline Blvd                        
+                                                            Mountain View  CA  94043                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Eutron S.p.A.                                
+860000-860FFF                 (base 16)                     Eutron S.p.A.                                
+                                                            Via Gandhi, 12 (Head office)                 
+                                                            Treviolo  Bergamo  24048                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         b-plus GmbH                                  
+86F000-86FFFF                 (base 16)                     b-plus GmbH                                  
+                                                            Ulrichsbergerstr. 17                         
+                                                            Deggendorf  Bavaria  94469                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         OMB Sistemas Electronicos S.A.               
+86B000-86BFFF                 (base 16)                     OMB Sistemas Electronicos S.A.               
+                                                            Avd San Antonio                              
+                                                            Cuarte de Huerva  Zaragoza  50410            
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Ing. Knauseder Mechatronik GmbH              
+85D000-85DFFF                 (base 16)                     Ing. Knauseder Mechatronik GmbH              
+                                                            Maierhof 12                                  
+                                                            Aurolzmuenster  AUSTRIA  4971                
+                                                            AT                                           
+
+00-50-C2                      (hex)                         TASK SISTEMAS DE COMPUTACAO LTDA             
+84B000-84BFFF                 (base 16)                     TASK SISTEMAS DE COMPUTACAO LTDA             
+                                                            Rua Visconde de Ouro Preto                   
+                                                            rio de janeiro    22250-180                  
+                                                            BR                                           
+
+00-50-C2                      (hex)                         K.K. Rocky                                   
+850000-850FFF                 (base 16)                     K.K. Rocky                                   
+                                                            NK bldg. 2F                                  
+                                                            Shinjyuku-Ku,  Tokyo,  161-0034              
+                                                            JP                                           
+
+00-50-C2                      (hex)                         LaserLinc, Inc.                              
+833000-833FFF                 (base 16)                     LaserLinc, Inc.                              
+                                                            777 Zapata Drive                             
+                                                            Fairborn  OH  45324                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Prodigy Electronics Limited                  
+844000-844FFF                 (base 16)                     Prodigy Electronics Limited                  
+                                                            808 Futura Plaza, 111-113 How Ming St.       
+                                                              Guangdong                                  
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Residential Control Systems                  
+840000-840FFF                 (base 16)                     Residential Control Systems                  
+                                                            11460 Sunrise Gold Circle                    
+                                                            Rancho Cordova  CA  95742                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         O. Bay AG                                    
+83B000-83BFFF                 (base 16)                     O. Bay AG                                    
+                                                            Luzernstrasse 45                             
+                                                            Subingen  Solothurn  4553                    
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Intelight Inc.                               
+816000-816FFF                 (base 16)                     Intelight Inc.                               
+                                                            3450 S Broadmont Drive  #126                 
+                                                            Tucson  Arizona  85713                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Odin TeleSystems Inc                         
+817000-817FFF                 (base 16)                     Odin TeleSystems Inc                         
+                                                            800 E. Campbell Rd                           
+                                                            Richardson  TX  75081-1873                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Telcom                                       
+81C000-81CFFF                 (base 16)                     Telcom                                       
+                                                            Svetog Nikole 27                             
+                                                            Beograd  Serbia  11060                       
+                                                            YU                                           
+
+00-50-C2                      (hex)                         Brain Tech Co., Ltd                          
+81B000-81BFFF                 (base 16)                     Brain Tech Co., Ltd                          
+                                                            5th Floor, Dong-Young Bldg., 580,            
+                                                            Suwon-City  Kyunggi-Do  440-853              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Channelot Ltd.                               
+81E000-81EFFF                 (base 16)                     Channelot Ltd.                               
+                                                            24 Raoul Wallenberg                          
+                                                            Tel Aviv    69719                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Winner Technology Co, Ltd.                   
+822000-822FFF                 (base 16)                     Winner Technology Co, Ltd.                   
+                                                            Rm707 GITEC 1121-9 Jungri                    
+                                                            Masan  Gyeng-Nam  GN 630-857                 
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Progentech Limited                           
+7E3000-7E3FFF                 (base 16)                     Progentech Limited                           
+                                                            Shenergy International Building              
+                                                            Shanghai    200021                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         SoftSwitching Technologies                   
+804000-804FFF                 (base 16)                     SoftSwitching Technologies                   
+                                                            8155 Forsythia Street                        
+                                                            Middleton  WI  53562                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+80A000-80AFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Nystrom Engineering                          
+7E5000-7E5FFF                 (base 16)                     Nystrom Engineering                          
+                                                            211 NE 365th Ave                             
+                                                            Corbett  OR  97019                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wise Industria de Telecomunicações Ldta.     
+7F8000-7F8FFF                 (base 16)                     Wise Industria de Telecomunicações Ldta.     
+                                                            SIBS Quadra 01 conjunto                      
+                                                            Núcleo Bandeirante  Distrito Federal  71736-104
+                                                            BR                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+7F7000-7F7FFF                 (base 16)                     MangoDSP                                     
+                                                            Hartom 8                                     
+                                                            Jerusalem    45116                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         TIS Dialog LLC                               
+7FC000-7FCFFF                 (base 16)                     TIS Dialog LLC                               
+                                                            ul. Gen. Tolstikova 75                       
+                                                            Kaliningrad    236011                        
+                                                            RU                                           
+
+00-50-C2                      (hex)                         ITB CompuPhase                               
+808000-808FFF                 (base 16)                     ITB CompuPhase                               
+                                                            Eerste Industriestraat 19-21                 
+                                                            Bussum  NH  NL-1401VL                        
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Venture Research Inc.                        
+7C5000-7C5FFF                 (base 16)                     Venture Research Inc.                        
+                                                            3001 Summit Ave                              
+                                                            Plano  TX  75074                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Highrail Systems Limited                     
+7D3000-7D3FFF                 (base 16)                     Highrail Systems Limited                     
+                                                            4 Morfa Lodge                                
+                                                            Porthmadog  GWYNEDD  LL49 9PF                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         C&D Technologies, Inc                        
+7E0000-7E0FFF                 (base 16)                     C&D Technologies, Inc                        
+                                                            65 Industrial Park Rd                        
+                                                            Dunlap  TN  37327                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pyrosequencing AB                            
+7C7000-7C7FFF                 (base 16)                     Pyrosequencing AB                            
+                                                            Kungsgatan 76                                
+                                                            Uppsala  Uppsala län  SE-753 18              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Bluebell Opticom Limited                     
+7C9000-7C9FFF                 (base 16)                     Bluebell Opticom Limited                     
+                                                            Unit 2 The Quadrant                          
+                                                            Maidenhead  Berkshire  SL6 1AP               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Calibre UK LTD                               
+7A4000-7A4FFF                 (base 16)                     Calibre UK LTD                               
+                                                            Cornwall House                               
+                                                            Bradford  West Yorkshire  BD8 7JS            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         RaySat Israel LTD                            
+7A2000-7A2FFF                 (base 16)                     RaySat Israel LTD                            
+                                                            Bareket 1 Building, 1st Golan street         
+                                                            Airport City  Lod  70100                     
+                                                            IL                                           
+
+00-50-C2                      (hex)                         PROMATE ELECTRONIC CO.LTD                    
+7BD000-7BDFFF                 (base 16)                     PROMATE ELECTRONIC CO.LTD                    
+                                                            4F 32,SEC.1 HUAN SHAN RD.,NEI HU,            
+                                                            TAIPEI    114                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         EIDOS SPA                                    
+7BC000-7BCFFF                 (base 16)                     EIDOS SPA                                    
+                                                            CORSO MATTEOTTI, 25                          
+                                                            CHIERI  TORINO  10023                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Infodev Electronic Designers Intl.           
+7BA000-7BAFFF                 (base 16)                     Infodev Electronic Designers Intl.           
+                                                            CP 1222 HV                                   
+                                                            Quebec    G1R 5A7                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Design 2000 Pty Ltd                          
+7B8000-7B8FFF                 (base 16)                     Design 2000 Pty Ltd                          
+                                                            9-11 Rose Street                             
+                                                            Melbourne  Victoria  3156                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         European Industrial Electronics B.V.         
+7C0000-7C0FFF                 (base 16)                     European Industrial Electronics B.V.         
+                                                            De Run 5116B                                 
+                                                            Veldhoven  Noord-Brabant  5503 LV            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Elmec,  Inc.                                 
+7B3000-7B3FFF                 (base 16)                     Elmec,  Inc.                                 
+                                                            229 Billerica Road                           
+                                                            Chelmsford  Mass  01824                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         T 1 Engineering                              
+7B4000-7B4FFF                 (base 16)                     T 1 Engineering                              
+                                                            5923 Thorntree Drive                         
+                                                            San Jose  CA  95120                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+77F000-77FFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         JMC America, LLC                             
+79A000-79AFFF                 (base 16)                     JMC America, LLC                             
+                                                            520 E 770 N                                  
+                                                            Orem  Utah  84097                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Indefia                                      
+798000-798FFF                 (base 16)                     Indefia                                      
+                                                            Sehit Ismet Armagan sokak No:4/12            
+                                                            Istanbul    34363                            
+                                                            TR                                           
+
+00-50-C2                      (hex)                         AAVD                                         
+799000-799FFF                 (base 16)                     AAVD                                         
+                                                            parc de gavaniere                            
+                                                            saint egreve  isere  38120                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ZigBee Alliance                              
+771000-771FFF                 (base 16)                     ZigBee Alliance                              
+                                                            508 Second Street, Suite 206                 
+                                                            Davis  CA  95626                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Control and Robotics Solutions               
+76F000-76FFFF                 (base 16)                     Control and Robotics Solutions               
+                                                            5 Mazal Eliezer St.                          
+                                                            Rishon Le-Zion    75653                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Cadex Electronics Inc.                       
+770000-770FFF                 (base 16)                     Cadex Electronics Inc.                       
+                                                            22000 Fraserwood Way                         
+                                                            Richmond  BC  V6W 1J6                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Ameli Spa                                    
+795000-795FFF                 (base 16)                     Ameli Spa                                    
+                                                            Via Guido Rossa, 10                          
+                                                            Impruneta (FI)    50023                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SMARTRO Co.,Ltd.                             
+792000-792FFF                 (base 16)                     SMARTRO Co.,Ltd.                             
+                                                            B-dong,SK TwinTechTower,#345-9,Gasan-dong,Geumcheon-gu
+                                                            Seoul    153-773                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         ATEC SRL                                     
+77C000-77CFFF                 (base 16)                     ATEC SRL                                     
+                                                            VIA NOBEL No. 8                              
+                                                            NOVENTA DI PIAVE  VENICE  30020              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Smith Meter, Inc                             
+77A000-77AFFF                 (base 16)                     Smith Meter, Inc                             
+                                                            1602 Wagner Ave                              
+                                                            Erie  PA  16514                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Assembly Contracts Limited                   
+762000-762FFF                 (base 16)                     Assembly Contracts Limited                   
+                                                            Ledson Road                                  
+                                                            Wythenshawe  Manchester  M23 9GP             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         B. Rexroth the identity company GmbH         
+75F000-75FFFF                 (base 16)                     B. Rexroth the identity company GmbH         
+                                                            Im Gruendchen 14                             
+                                                            Bessenbach  Bavaria  63856                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sky-Skan, Incorporated                       
+75E000-75EFFF                 (base 16)                     Sky-Skan, Incorporated                       
+                                                            51 Lake Street                               
+                                                            Nashua  NH  03060-4513                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         BES GmbH                                     
+769000-769FFF                 (base 16)                     BES GmbH                                     
+                                                            Spitzenmeer 1                                
+                                                            Westerstede  D 26655                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sequentric Energy Systems, LLC               
+759000-759FFF                 (base 16)                     Sequentric Energy Systems, LLC               
+                                                            4651 Woodstock Rd 208-150                    
+                                                            Roswell  GA  30075                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+739000-739FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         CDSA Dam Neck                                
+747000-747FFF                 (base 16)                     CDSA Dam Neck                                
+                                                            1922 Regulus Avenue                          
+                                                            Virginia Beach  VA  23461-2097               
+                                                            US                                           
+
+00-50-C2                      (hex)                         MITROL S.R.L.                                
+716000-716FFF                 (base 16)                     MITROL S.R.L.                                
+                                                            VIA G. MATTEOTTI, 19                         
+                                                            GAZZADA SCHIANNO  VARESE  21045              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Centric TSolve BV                            
+722000-722FFF                 (base 16)                     Centric TSolve BV                            
+                                                            Science Park Eindhoven 5644                  
+                                                            SON  Noord-Brabant  5692 EN                  
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Pelweckyj Videotechnik GmbH                  
+727000-727FFF                 (base 16)                     Pelweckyj Videotechnik GmbH                  
+                                                            Gueterstrasse 2                              
+                                                            Dieburg    64807                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         eta systemi CKB                              
+726000-726FFF                 (base 16)                     eta systemi CKB                              
+                                                            Via Arno 108,                                
+                                                            Sesto Fiorentino  FI  50019                  
+                                                            IT                                           
+
+00-50-C2                      (hex)                         B.E.A.R. Solutions (Australasia) Pty, Ltd    
+70B000-70BFFF                 (base 16)                     B.E.A.R. Solutions (Australasia) Pty, Ltd    
+                                                            Unit 226                                     
+                                                            Bella Vista  NSW                             
+                                                            AU                                           
+
+00-50-C2                      (hex)                         E3Switch LLC                                 
+6F3000-6F3FFF                 (base 16)                     E3Switch LLC                                 
+                                                            80 Coronado Ave                              
+                                                            San Carlos  CA  94070                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+701000-701FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Gebhardt Ventilatoren GmbH                   
+6DB000-6DBFFF                 (base 16)                     Gebhardt Ventilatoren GmbH                   
+                                                            Bahnhofstrasse 43                            
+                                                            Netzschkau  Sachsen  08491                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Zmicro Systems Inc                           
+6DD000-6DDFFF                 (base 16)                     Zmicro Systems Inc                           
+                                                            9830 Summersridge Rd                         
+                                                            San Diego  CA  92121                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         DigiSensory technologies Pty Ltd             
+6D3000-6D3FFF                 (base 16)                     DigiSensory technologies Pty Ltd             
+                                                            Suite 54, Level 3                            
+                                                            Ultimo  New South Wales  2007                
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Mavenir System, Inc.                         
+6D7000-6D7FFF                 (base 16)                     Mavenir System, Inc.                         
+                                                            1651 N. Glenville Dr., Suite 201             
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Techno Fittings S.r.l.                       
+6DA000-6DAFFF                 (base 16)                     Techno Fittings S.r.l.                       
+                                                            Via Michelangelo Tilli 53/A/6                
+                                                            Rome    00156                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         QR Sciences Ltd                              
+6DF000-6DFFFF                 (base 16)                     QR Sciences Ltd                              
+                                                            8-10 Hamilton St                             
+                                                            Cannington    6107                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Bando electronic communication Co.Lltd       
+6E9000-6E9FFF                 (base 16)                     Bando electronic communication Co.Lltd       
+                                                            152-4,chuneui-dong,wonmi-gu                  
+                                                            buchon  kyoungki-do  420-859                 
+                                                            KR                                           
+
+00-50-C2                      (hex)                         NewOnSys Ltd.                                
+6E1000-6E1FFF                 (base 16)                     NewOnSys Ltd.                                
+                                                            #607 Ilsan TechnoTown 1141-1                 
+                                                            Goyang  Gyunggi-Do  410-722                  
+                                                            KR                                           
+
+00-50-C2                      (hex)                         GLOSTER SANTE EUROPE                         
+6C0000-6C0FFF                 (base 16)                     GLOSTER SANTE EUROPE                         
+                                                            Prologue 1 - La Pyrénéenne                   
+                                                            LABEGE  HAUTE GARONNE  31672                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Widmer Time Recorder Co., Inc.               
+6CC000-6CCFFF                 (base 16)                     Widmer Time Recorder Co., Inc.               
+                                                            p.o. box 588                                 
+                                                            hackensack  nj  07602                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Paraytec Ltd                                 
+6BC000-6BCFFF                 (base 16)                     Paraytec Ltd                                 
+                                                            1a St George's Place                         
+                                                            York  N Yorkshire  YO24 1GN                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Delcan Technologies, Inc                     
+6A8000-6A8FFF                 (base 16)                     Delcan Technologies, Inc                     
+                                                            2055 Sugarloaf Circle, Suite 500             
+                                                            Duluth  GA  30097                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         NETAMI                                       
+6C9000-6C9FFF                 (base 16)                     NETAMI                                       
+                                                            139-6,DORIM 1DONG                            
+                                                            SEOUL  YOUNG DUNG PO GU  150-081             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         B&S MEDIA Co., LTD.                          
+6C8000-6C8FFF                 (base 16)                     B&S MEDIA Co., LTD.                          
+                                                            #702 JNK DIGITAL TOWER                       
+                                                            Seoul    152-848                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Burk Technology                              
+6B1000-6B1FFF                 (base 16)                     Burk Technology                              
+                                                            7 Beaver Brook road                          
+                                                            Littleton  MA  01460                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elk Products                                 
+688000-688FFF                 (base 16)                     Elk Products                                 
+                                                            3266 Highway 70 West                         
+                                                            Hildebran  NC  28637                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         RF Code, Inc.                                
+689000-689FFF                 (base 16)                     RF Code, Inc.                                
+                                                            1250 S. Clearview Ave.                       
+                                                            Mesa  AZ  85209                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         SELCO                                        
+68E000-68EFFF                 (base 16)                     SELCO                                        
+                                                            ZI DU VAL D OMBREE                           
+                                                            COMBREE    49520                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ANNAX Anzeigesysteme GmbH                    
+686000-686FFF                 (base 16)                     ANNAX Anzeigesysteme GmbH                    
+                                                            Wettersteinstrasse 18                        
+                                                            Taufkirchen    82024                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kenton Research Ltd                          
+675000-675FFF                 (base 16)                     Kenton Research Ltd                          
+                                                            Unit 19 Bourne Industrial Park               
+                                                            Crayford  Kent  DA1 4BZ                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         GFP Lab S.r.l.                               
+6A0000-6A0FFF                 (base 16)                     GFP Lab S.r.l.                               
+                                                            via Casalecchio 5                            
+                                                            Rimini  RN  47924                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Bulletendpoints Enterprises Inc              
+699000-699FFF                 (base 16)                     Bulletendpoints Enterprises Inc              
+                                                            16 finch ave                                 
+                                                            Dollars des ormeaux  quebec  H9a 3g8         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Purelink Technology, inc.                    
+695000-695FFF                 (base 16)                     Purelink Technology, inc.                    
+                                                            3333 Queen Mary, suite 525                   
+                                                            Montreal  Quebec  H3V1A2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         P.C.E.                                       
+661000-661FFF                 (base 16)                     P.C.E.                                       
+                                                            Via Pietro Menis 14                          
+                                                            Treppo Grande  UD  33010                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Skyline Products, Inc                        
+671000-671FFF                 (base 16)                     Skyline Products, Inc                        
+                                                            2903 Delta Drive                             
+                                                            Colorado Springs  CO  80910                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         DIGITEK S.p.A.                               
+66D000-66DFFF                 (base 16)                     DIGITEK S.p.A.                               
+                                                            via Romagnoli, 24                            
+                                                            Concordia sulla Secchia  MODENA  41033       
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Xworks NZ Limited                            
+666000-666FFF                 (base 16)                     Xworks NZ Limited                            
+                                                            Level 1                                      
+                                                            Te Awamutu  North Island  3800               
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Asia Pacific Card & System Sdn Bhd           
+662000-662FFF                 (base 16)                     Asia Pacific Card & System Sdn Bhd           
+                                                            No 2, Jalan 1, Bandar Sultan Suleiman, Taiwanese Industrial Park
+                                                            Port Klang  Selangor  42000                  
+                                                            MY                                           
+
+00-50-C2                      (hex)                         Nilan A/S                                    
+66F000-66FFFF                 (base 16)                     Nilan A/S                                    
+                                                            Nilanvej 2                                   
+                                                            Hedensted  Vejle amt  8722                   
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Physik Instrumente (PI) GmbH&Co.KG           
+655000-655FFF                 (base 16)                     Physik Instrumente (PI) GmbH&Co.KG           
+                                                            Auf der Roemerstrasse 1                      
+                                                            Karlsruhe    76228                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LDA Audio Video Profesional                  
+656000-656FFF                 (base 16)                     LDA Audio Video Profesional                  
+                                                            C/Severo Ochoa, 31                           
+                                                            Campanillas  Malaga  29590                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Powis Corporation                            
+63B000-63BFFF                 (base 16)                     Powis Corporation                            
+                                                            2301 NW. Jefferson                           
+                                                            Blue Springs  MO  64015                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         IDERs Inc                                    
+63D000-63DFFF                 (base 16)                     IDERs Inc                                    
+                                                            100-137 Innovation Drive                     
+                                                            Winnipeg  Manitoba  R3T6B6                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         NEO Information Systems Co., Ltd.            
+641000-641FFF                 (base 16)                     NEO Information Systems Co., Ltd.            
+                                                            609, Junganginduspia, #517-13, Sangdaeweon-Dong, Jungweon-Gu
+                                                            Seongnam  Gyunggi-Do  462-713                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+644000-644FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         First Control Systems AB                     
+62B000-62BFFF                 (base 16)                     First Control Systems AB                     
+                                                            Ängsgärdg 4                                  
+                                                            Västerås  Västmanland  SE-72130              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Shockfish SA                                 
+635000-635FFF                 (base 16)                     Shockfish SA                                 
+                                                            Parc Scientifique                            
+                                                            Lausanne  VD  1015                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Aurora Flight Sciences                       
+630000-630FFF                 (base 16)                     Aurora Flight Sciences                       
+                                                            9950 Wakeman Drive                           
+                                                            Manassas  VA  20110                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tera Information System Labs                 
+64D000-64DFFF                 (base 16)                     Tera Information System Labs                 
+                                                            198 Allendale Road Suite 401                 
+                                                            King of Prussia  PA  19406                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         IHP-GmbH                                     
+612000-612FFF                 (base 16)                     IHP-GmbH                                     
+                                                            Im Technologiepark 25                        
+                                                            Frankfurt (Oder)  Brandenburg  15236         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Linkbit, Inc.                                
+619000-619FFF                 (base 16)                     Linkbit, Inc.                                
+                                                            3180 De La Cruz Blvd., Suite 200             
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Automation and Control Technology, Inc.      
+60E000-60EFFF                 (base 16)                     Automation and Control Technology, Inc.      
+                                                            6141 Avery Rd                                
+                                                            Dublin  OH  43016                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Shanghai QianJin Electronic Equipment Co. Ltd.
+60B000-60BFFF                 (base 16)                     Shanghai QianJin Electronic Equipment Co. Ltd.
+                                                            7028 Rockrose Ter                            
+                                                            Carlsbad  CA  92011                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sutus Inc                                    
+61D000-61DFFF                 (base 16)                     Sutus Inc                                    
+                                                            50-1055 West 14th Street                     
+                                                            North Vancouver  British Columbia  V7P 3P2   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Swistec GmbH                                 
+605000-605FFF                 (base 16)                     Swistec GmbH                                 
+                                                            Graue-Burg-Strasse 24-26                     
+                                                            Bornheim    D-53332                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TATTILE SRL                                  
+613000-613FFF                 (base 16)                     TATTILE SRL                                  
+                                                            VIA TRENTO,127/129                           
+                                                            CAPRIANO DEL COLLE  BRESCIA  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Genesis inc                                  
+5F5000-5F5FFF                 (base 16)                     Genesis inc                                  
+                                                            #517 Ilsan-midas,775-1 Janghang-Dong,        
+                                                            Goyang  Gyeonggi  410-837                    
+                                                            KR                                           
+
+00-50-C2                      (hex)                         CAMBRIDGE CONSULTANTS LTD                    
+5F6000-5F6FFF                 (base 16)                     CAMBRIDGE CONSULTANTS LTD                    
+                                                            SCIENCE PARK                                 
+                                                            CAMBRIDGE  ENGLAND  CB4 0DW                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Protec Fire Detection plc                    
+600000-600FFF                 (base 16)                     Protec Fire Detection plc                    
+                                                            Protec House                                 
+                                                            Nelson  Lancashire  BB9 6LQ                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Shenzhen Huazhong Technology Inc             
+606000-606FFF                 (base 16)                     Shenzhen Huazhong Technology Inc             
+                                                            Room 1710,17/F,Tower B,phase 1,              
+                                                            shenzhen  Guangdong  518048                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Garper Telecomunicaciones, S.L.              
+5EB000-5EBFFF                 (base 16)                     Garper Telecomunicaciones, S.L.              
+                                                            Calle Antoñita Jiménez, 8 Local              
+                                                            Madrid    28019                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         TONNA ELECTRONIQUE                           
+5DA000-5DAFFF                 (base 16)                     TONNA ELECTRONIQUE                           
+                                                            449, route de METZ                           
+                                                            MONDELANGE  MOSELLE  57303                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         BioAccess Tecnologia em Biometria Ltda.      
+5D6000-5D6FFF                 (base 16)                     BioAccess Tecnologia em Biometria Ltda.      
+                                                            Av. Pres. Kennedy, 47                        
+                                                            Curitiba  PR  80220-200                      
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Stresstech OY                                
+5E5000-5E5FFF                 (base 16)                     Stresstech OY                                
+                                                            Tikkutehtaantie 1                            
+                                                            Vaajakoski    40800                          
+                                                            FI                                           
+
+00-50-C2                      (hex)                         DA-Design Oy                                 
+5D2000-5D2FFF                 (base 16)                     DA-Design Oy                                 
+                                                            Keskuskatu 29                                
+                                                            Jokioinen    FIN-31600                       
+                                                            FI                                           
+
+00-50-C2                      (hex)                         SAIA Burgess Controls AG                     
+5BA000-5BAFFF                 (base 16)                     SAIA Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         UNIC TECHNOLOGIES INC                        
+5BB000-5BBFFF                 (base 16)                     UNIC TECHNOLOGIES INC                        
+                                                            NO.7, 5TH AVE. SHANGDI                       
+                                                            HAIDIAN  BEIJING  100085                     
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Guangzhou Hui Si Information Technologies Inc.
+5BC000-5BCFFF                 (base 16)                     Guangzhou Hui Si Information Technologies Inc.
+                                                            A-406, GD Soft Science Park, No.11 CaiPin Rd, GZ Science City,
+                                                            GuangZhou  GuangDong  510663                 
+                                                            CN                                           
+
+00-50-C2                      (hex)                         AVerMedia Technologies, Inc.                 
+5B7000-5B7FFF                 (base 16)                     AVerMedia Technologies, Inc.                 
+                                                            7F.,No. 137, Jian Yi Rd.                     
+                                                            Chung Ho City  Taipei Hsien  23585           
+                                                            TW                                           
+
+00-50-C2                      (hex)                         CPS EUROPE B.V.                              
+5AE000-5AEFFF                 (base 16)                     CPS EUROPE B.V.                              
+                                                            Boxtelseweg 26                               
+                                                            Vught    5261NE                              
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Kinemetrics, Inc.                            
+5AC000-5ACFFF                 (base 16)                     Kinemetrics, Inc.                            
+                                                            222 Vista Avenue                             
+                                                            Pasadena  CA  91107                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         AllSun A/S                                   
+582000-582FFF                 (base 16)                     AllSun A/S                                   
+                                                            Brundtlandparken 2                           
+                                                            Toftlund  Jutland  DK-6520                   
+                                                            DK                                           
+
+00-50-C2                      (hex)                         ZAO                                          
+58D000-58DFFF                 (base 16)                     ZAO                                          
+                                                            Frunze, 40                                   
+                                                            Omsk  Omskaia district  644099               
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Legerity                                     
+59E000-59EFFF                 (base 16)                     Legerity                                     
+                                                            4509 Freidrich Lane                          
+                                                            Austin  TX  78744                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         EM Motorsport Ltd                            
+590000-590FFF                 (base 16)                     EM Motorsport Ltd                            
+                                                            Church Farmhouse                             
+                                                            Oxford  Oxfordshire  OX33 1PR                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PaloDEx Group Oy                             
+592000-592FFF                 (base 16)                     PaloDEx Group Oy                             
+                                                            Nahkelantie 160                              
+                                                            TUUSULA    FIN 04301                         
+                                                            FI                                           
+
+00-50-C2                      (hex)                         éolane                                       
+57C000-57CFFF                 (base 16)                     éolane                                       
+                                                            667 rue Aristide Berges                      
+                                                            38330 Montbonnot St Martin                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Dixell S.p.a.                                
+58A000-58AFFF                 (base 16)                     Dixell S.p.a.                                
+                                                            Via Dell'Industria 27                        
+                                                            Pieve D'Alpago    32010                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Innovative Dynamics GmbH                     
+58B000-58BFFF                 (base 16)                     Innovative Dynamics GmbH                     
+                                                            Wiesenweg 9                                  
+                                                            Vordorf / Rethen  Lower Saxony  38533        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Dynalco                                      
+587000-587FFF                 (base 16)                     Dynalco                                      
+                                                            3690 NW 53rd St                              
+                                                            Ft. Lauderdale  Florida  33309               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Freiburger BlickZentrum                      
+556000-556FFF                 (base 16)                     Freiburger BlickZentrum                      
+                                                            Hans-Sachs-Gasse 6                           
+                                                            79098  Freiburg                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Control Alternative Solutions, Inc.          
+555000-555FFF                 (base 16)                     Control Alternative Solutions, Inc.          
+                                                            1001 Barton Creek Drive                      
+                                                            Dripping Springs  Texas  78620               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Seitec Elektronik GmbH                       
+561000-561FFF                 (base 16)                     Seitec Elektronik GmbH                       
+                                                            Kastanienweg 4                               
+                                                            Troeglitz    06729                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tess GmbH                                    
+567000-567FFF                 (base 16)                     Tess GmbH                                    
+                                                            Schumanstraße 33d                            
+                                                            Würselen  NRW  52146                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         HANZAS ELEKTRONIKA, SIA                      
+55E000-55EFFF                 (base 16)                     HANZAS ELEKTRONIKA, SIA                      
+                                                            Akmenu iela 72                               
+                                                            OGRE    LV5001                               
+                                                            LV                                           
+
+00-50-C2                      (hex)                         LAB-EL ELEKTRONIKA LABORATORYJNA S.J.        
+56E000-56EFFF                 (base 16)                     LAB-EL ELEKTRONIKA LABORATORYJNA S.J.        
+                                                            Bodycha 68B                                  
+                                                            Warszawa  Mazowieckie  02-495                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         GMA, LLC                                     
+56F000-56FFFF                 (base 16)                     GMA, LLC                                     
+                                                            18314 Kinzie St.                             
+                                                            Los Angeles  CA  91325                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         MATRIX TELECOM PVT. LTD.                     
+55B000-55BFFF                 (base 16)                     MATRIX TELECOM PVT. LTD.                     
+                                                            394-GIDC                                     
+                                                            VADODARA  GUJARAT  390010                    
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Convergent Design                            
+54E000-54EFFF                 (base 16)                     Convergent Design                            
+                                                            4465 Northpark Dr. Suite 400                 
+                                                            Colorado Springs  Colorado  80907            
+                                                            US                                           
+
+00-50-C2                      (hex)                         DIGI SESN AG                                 
+543000-543FFF                 (base 16)                     DIGI SESN AG                                 
+                                                            Freiburgstr. 65                              
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TOA Systems                                  
+51C000-51CFFF                 (base 16)                     TOA Systems                                  
+                                                            305 East Dr.                                 
+                                                            Melbourne  Florida  32904                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         DBMCORP, Inc.                                
+519000-519FFF                 (base 16)                     DBMCORP, Inc.                                
+                                                            32A Spruce Street                            
+                                                            Oakland  New Jersey  07436                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+528000-528FFF                 (base 16)                     Tattile srl                                  
+                                                            Via Trento 127/129                           
+                                                            Capriano del Colle  Brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ARIS TECHNOLOGIES                            
+521000-521FFF                 (base 16)                     ARIS TECHNOLOGIES                            
+                                                            20 RUE DU FONDS PERNANT                      
+                                                            COMPIEGNE  OISE  60200                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Clearsonics Pty. Ltd.                        
+50D000-50DFFF                 (base 16)                     Clearsonics Pty. Ltd.                        
+                                                            Level 1                                      
+                                                            Adelaide  SA  5000                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Fibresavers Corporation                      
+50E000-50EFFF                 (base 16)                     Fibresavers Corporation                      
+                                                            14252 Culver Dr.  Ste. A356                  
+                                                            Irvine  Ca  92604                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         PUTERCOM ENTERPRISE CO., LTD.                
+508000-508FFF                 (base 16)                     PUTERCOM ENTERPRISE CO., LTD.                
+                                                            5F-3, NO. 130 JIAN KANG ROAD                 
+                                                            CHUNGHO CITY  TAIPEI HSIEN  235              
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines Ltd                
+50A000-50AFFF                 (base 16)                     Monitor Business Machines Ltd                
+                                                            PO Box 108042                                
+                                                            Auckland                                     
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Network Automation mxc AB                    
+4FD000-4FDFFF                 (base 16)                     Network Automation mxc AB                    
+                                                            P.O Box 7294                                 
+                                                            Stockholm    103 90                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Thales Defence and Security Systems GmbH     
+4EC000-4ECFFF                 (base 16)                     Thales Defence and Security Systems GmbH     
+                                                            Edisonstr. 3                                 
+                                                            24145  Keil                                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Seachange international                      
+4E9000-4E9FFF                 (base 16)                     Seachange international                      
+                                                            32 Mill st.                                  
+                                                            Greenville  NH  03048                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dakty GmbH                                   
+4FF000-4FFFFF                 (base 16)                     Dakty GmbH                                   
+                                                            Campusallee 9927                             
+                                                            Hoppstaedten-Weiersbach    D-55768           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Aphex Systems Ltd.                           
+504000-504FFF                 (base 16)                     Aphex Systems Ltd.                           
+                                                            11068 Randall St                             
+                                                            Sun Valley  CA  91352                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computerwise, Inc.                           
+505000-505FFF                 (base 16)                     Computerwise, Inc.                           
+                                                            302 N. Winchester                            
+                                                            Olathe  KS  66062                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Beijing Corelogic Communication Co., Ltd.    
+4EE000-4EEFFF                 (base 16)                     Beijing Corelogic Communication Co., Ltd.    
+                                                            F-5,Huayuelong Mansion,                      
+                                                              Beijing  100043                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         eXray Broadband Inc.                         
+4C5000-4C5FFF                 (base 16)                     eXray Broadband Inc.                         
+                                                            31 Broadway Avenue                           
+                                                            Ottawa  Ontario  K1S 2V4                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Westinghouse Rail Systems Ltd                
+4BF000-4BFFFF                 (base 16)                     Westinghouse Rail Systems Ltd                
+                                                            Pew Hill                                     
+                                                            Chippenham  Wiltshire  SN151JD               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Computerized Elevator Contol                 
+4E7000-4E7FFF                 (base 16)                     Computerized Elevator Contol                 
+                                                            24 Empire Blvd                               
+                                                            Moonachie  New Jersey  07074                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Truteq Wireless (PTY) Ltd.                   
+4DD000-4DDFFF                 (base 16)                     Truteq Wireless (PTY) Ltd.                   
+                                                            Unit 6, Falcon Village Office Park           
+                                                            Centurion  Gauteng  0157                     
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Photonic Bridges  Inc.                       
+4E6000-4E6FFF                 (base 16)                     Photonic Bridges  Inc.                       
+                                                            405 Fawns Run                                
+                                                            Morganville  New Jersey  07751               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Romteck Pty Ltd                              
+4E3000-4E3FFF                 (base 16)                     Romteck Pty Ltd                              
+                                                            37 Collingwood Street, Osborne Park          
+                                                            Osborne Park   Perth  6017                   
+                                                            AU                                           
+
+00-50-C2                      (hex)                         ImpediMed Limited                            
+4CC000-4CCFFF                 (base 16)                     ImpediMed Limited                            
+                                                            4B/2404 Logan Road                           
+                                                            Eight Mile Plains  Queensland  4113          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ace Electronics, Inc.                        
+4DC000-4DCFFF                 (base 16)                     Ace Electronics, Inc.                        
+                                                            27574 Commerce ctr. dr.                      
+                                                            Temecula  CA  92590                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Herholdt Controls srl                        
+4D4000-4D4FFF                 (base 16)                     Herholdt Controls srl                        
+                                                            Via Mestre 13                                
+                                                            Milan    20132                               
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ELPROC sp. z o.o.                            
+4D3000-4D3FFF                 (base 16)                     ELPROC sp. z o.o.                            
+                                                            Skwer Ks. Krd. St. Wyszyńskiego 2/62         
+                                                            Warsaw  Mazowieckie  01-015                  
+                                                            PL                                           
+
+00-50-C2                      (hex)                         nVent, Schroff GmbH                          
+4A1000-4A1FFF                 (base 16)                     nVent, Schroff GmbH                          
+                                                            Langenalber Strasse 96-100                   
+                                                            Straubenhardt    75334                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Protonic Holland                             
+4BB000-4BBFFF                 (base 16)                     Protonic Holland                             
+                                                            Factorij 36                                  
+                                                            Zwaag    1689 AL                             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Esmart Distribution Pte Ltd                  
+4B0000-4B0FFF                 (base 16)                     Esmart Distribution Pte Ltd                  
+                                                            17 Kallang Junction #04-03                   
+                                                                339274                                   
+                                                            SG                                           
+
+00-50-C2                      (hex)                         Bio-logic Systems Corp                       
+4C0000-4C0FFF                 (base 16)                     Bio-logic Systems Corp                       
+                                                            One Bio-logic Plaza                          
+                                                            Mundelein  IL  60060                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Energie Umwelt Systemtechnik GmbH            
+47E000-47EFFF                 (base 16)                     Energie Umwelt Systemtechnik GmbH            
+                                                            Friedrich-Barnewitz-Str. 3a                  
+                                                              Rostock  18119                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EREE Electronique                            
+489000-489FFF                 (base 16)                     EREE Electronique                            
+                                                            6 avenu Dr Schweitzer                        
+                                                            MEYZIEU    69882                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Metron Sp. z o.o.                            
+48D000-48DFFF                 (base 16)                     Metron Sp. z o.o.                            
+                                                            ul. Targowa 12/22                            
+                                                            Torun  Kuj-pom  87-100                       
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+491000-491FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH4016                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         XIMEA s.r.o.                                 
+36F000-36FFFF                 (base 16)                     XIMEA s.r.o.                                 
+                                                            Lesna 52                                     
+                                                            Marianka  SK  900 33                         
+                                                            SK                                           
+
+00-50-C2                      (hex)                         ISEPOS GmbH                                  
+475000-475FFF                 (base 16)                     ISEPOS GmbH                                  
+                                                            Untere Straße 33                             
+                                                            Tuebingen  Baden-Württemberg  72070          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Digital Engineering, Inc.                    
+45D000-45DFFF                 (base 16)                     Digital Engineering, Inc.                    
+                                                            740 Harold Crescent                          
+                                                            Thunder Bay  Ontario  P7C 5H7                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         CAMCO GmbH                                   
+46C000-46CFFF                 (base 16)                     CAMCO GmbH                                   
+                                                            Fischpicke 5                                 
+                                                            Wenden  NRW  57482                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PDTS GmbH                                    
+465000-465FFF                 (base 16)                     PDTS GmbH                                    
+                                                            Moeringgasse 20                              
+                                                            Vienna    1150                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         XYTAC system technologies                    
+464000-464FFF                 (base 16)                     XYTAC system technologies                    
+                                                            3755-1-2-212 Totsukacho                      
+                                                            Yokohama  Kanagawa  244-0003                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         HRZ data GmbH                                
+458000-458FFF                 (base 16)                     HRZ data GmbH                                
+                                                            Oberkrone 20e                                
+                                                            Witten  NRW  58455                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DRDC Valcartier                              
+456000-456FFF                 (base 16)                     DRDC Valcartier                              
+                                                            2459 blvd. Pie XI North                      
+                                                            Val-Belair  Québec  G3J 1X5                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Ann Arbor Sensor Systems LLC                 
+43D000-43DFFF                 (base 16)                     Ann Arbor Sensor Systems LLC                 
+                                                            7300 Huron River Drive                       
+                                                            Dexter  MI  48130                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ducommun LaBarge Technologies, Inc           
+43C000-43CFFF                 (base 16)                     Ducommun LaBarge Technologies, Inc           
+                                                            700 Braddock Avenue                          
+                                                            East Pittsburgh  PA  15112                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Modular Computers Ltd.              
+440000-440FFF                 (base 16)                     Advanced Modular Computers Ltd.              
+                                                            Union House, Unit B1, Deseronto Trading Estate
+                                                            Langley, Slough  Berkshire  SL3 7EW          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Brivo Systems, LLC                           
+454000-454FFF                 (base 16)                     Brivo Systems, LLC                           
+                                                            4330 East-West Highway                       
+                                                            Bethesda  MD  20814                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Electro-Matic Products, Inc.                 
+44D000-44DFFF                 (base 16)                     Electro-Matic Products, Inc.                 
+                                                            23409 Industrial Park Ct.                    
+                                                            Farmington Hills  MI  48335                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         QQ Technology,Inc                            
+44E000-44EFFF                 (base 16)                     QQ Technology,Inc                            
+                                                            8F TowerB,wantong new world plaza,No.2 Fuwai street
+                                                            BeiJing    100037                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         VLSIP TECHNOLOGIES, INC.                     
+42B000-42BFFF                 (base 16)                     VLSIP TECHNOLOGIES, INC.                     
+                                                            750 PRESIDENTIAL DRIVE                       
+                                                            RICHARDSON  TEXAS  75081                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Scheidt & Bachmann GmbH                      
+427000-427FFF                 (base 16)                     Scheidt & Bachmann GmbH                      
+                                                            Breite Strasse 132                           
+                                                            Moenchengladbach  NRW  41238                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         STOM System                                  
+426000-426FFF                 (base 16)                     STOM System                                  
+                                                            Yangjae-dong 316-9, OSL B/D 5F               
+                                                            Seoul    137-876                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Matthews Australasia                         
+429000-429FFF                 (base 16)                     Matthews Australasia                         
+                                                            35 Laser Drive                               
+                                                            Rowville  Victoria  3178                     
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Topway Industries Ltd.                       
+432000-432FFF                 (base 16)                     Topway Industries Ltd.                       
+                                                            Rm 1506, Cheung Fung Ind. Bldg.,             
+                                                            Tsuen Wan, N.T.                              
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Arcom Digital                                
+430000-430FFF                 (base 16)                     Arcom Digital                                
+                                                            PO Box 6729                                  
+                                                            Syracuse  NY  13217                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ProDesign GmbH                               
+43A000-43AFFF                 (base 16)                     ProDesign GmbH                               
+                                                            Hochheimer Str. 47                           
+                                                            Erfurt    99094                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Power-One Inc.                               
+423000-423FFF                 (base 16)                     Power-One Inc.                               
+                                                            via san giorgio 642                          
+                                                            Terranuova Bracciolini  Arezzo  52028        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         QT systems ab                                
+417000-417FFF                 (base 16)                     QT systems ab                                
+                                                            Finnbacksgatan 11                            
+                                                            Lycksele  Västerbotten  921 32               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Goodrich                                     
+413000-413FFF                 (base 16)                     Goodrich                                     
+                                                            Fuels & Utility Systems                      
+                                                            Vergennes  Vermont  05491                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Applied Materials UK Ltd                     
+40C000-40CFFF                 (base 16)                     Applied Materials UK Ltd                     
+                                                            Foundry Lane                                 
+                                                            Horsham  West Sussex  RH13 5PY               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Salland Electronics Holding BV               
+3F1000-3F1FFF                 (base 16)                     Salland Electronics Holding BV               
+                                                            Katwolderweg 15                              
+                                                            Zwolle  Overijssel  NL8041AC                 
+                                                            NL                                           
+
+00-50-C2                      (hex)                         megatec electronic GmbH                      
+3F0000-3F0FFF                 (base 16)                     megatec electronic GmbH                      
+                                                            Lehenhammer 14                               
+                                                            Etzelwang  Bayern  92268                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Weinberger Deutschland GmbH                  
+3FC000-3FCFFF                 (base 16)                     Weinberger Deutschland GmbH                  
+                                                            Am Weichselgarten 3                          
+                                                            Erlangen  Bayern  91058                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MC TECHNOLOGY GmbH                           
+3F4000-3F4FFF                 (base 16)                     MC TECHNOLOGY GmbH                           
+                                                            Ottilienweg 9                                
+                                                            Blumberg  BW  78176                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Cast Iron Systems                            
+3FF000-3FFFFF                 (base 16)                     Cast Iron Systems                            
+                                                            2593 Coast Ave Suite 200                     
+                                                            Mountain View  CA  94043                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         CoreStreet, Ltd                              
+406000-406FFF                 (base 16)                     CoreStreet, Ltd                              
+                                                            One Alewife Center, Suite 200                
+                                                            Cambridge  MA  02140                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Salent Technologies Ltd                      
+3C7000-3C7FFF                 (base 16)                     Salent Technologies Ltd                      
+                                                            Rowan House                                  
+                                                            Philpstoun  Linlithgow  EH49 6RN             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Silicon Optix Canada Inc.                    
+3C5000-3C5FFF                 (base 16)                     Silicon Optix Canada Inc.                    
+                                                            2005 Sheppard Ave. East, Suite 100           
+                                                            Toronto  Ontario  L2J 5B4                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Wheels of Zeus Inc.                          
+3C8000-3C8FFF                 (base 16)                     Wheels of Zeus Inc.                          
+                                                            15595 Los Gatos Blvd                         
+                                                            Los Gatos  CA  95032                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Audio Processing Technology Ltd              
+3BF000-3BFFFF                 (base 16)                     Audio Processing Technology Ltd              
+                                                            Whiterock Business Park                      
+                                                            Belfast    BT12 7FP                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Technovare Systems, Inc.                     
+3CF000-3CFFFF                 (base 16)                     Technovare Systems, Inc.                     
+                                                            1675 Scenic Avenue                           
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Engim, Inc.                                  
+3A8000-3A8FFF                 (base 16)                     Engim, Inc.                                  
+                                                            40 Nagog Park                                
+                                                            Acton  MA  01720                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Silvertree Engineering Ltd                   
+3A4000-3A4FFF                 (base 16)                     Silvertree Engineering Ltd                   
+                                                            Unit 9  Heron Way                            
+                                                            Truro  Cornwall  TR1 2XN                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ICS Electronics                              
+383000-383FFF                 (base 16)                     ICS Electronics                              
+                                                            7034 Commerce Circle                         
+                                                            Pleasanton  CA  94588                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         NEC TOKIN Corporation                        
+3B5000-3B5FFF                 (base 16)                     NEC TOKIN Corporation                        
+                                                            1-1,Asahi-Cho 7-chome,Shiroishi,             
+                                                            Miyagi    989-0223                           
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Samsoft                                      
+3A1000-3A1FFF                 (base 16)                     Samsoft                                      
+                                                            Linde alle 20                                
+                                                            Glostrup  DK  2600                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         taskit Rechnertechnik GmbH                   
+3AB000-3ABFFF                 (base 16)                     taskit Rechnertechnik GmbH                   
+                                                            Seelenbinder Straße 33                       
+                                                            Berlin    12 555                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EPSILON SRL                                  
+38C000-38CFFF                 (base 16)                     EPSILON SRL                                  
+                                                            VIA DELLE GEROLE 24                          
+                                                            CAPONAGO  MILANO  20040                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         TC Communications                            
+390000-390FFF                 (base 16)                     TC Communications                            
+                                                            17575 Cartwright Road                        
+                                                            Irvine  CA  92614                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         TIR Systems Ltd.                             
+375000-375FFF                 (base 16)                     TIR Systems Ltd.                             
+                                                            7700 Riverfront Gate                         
+                                                            Burnaby  British Columbia  V5J 5M4           
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Foresearch                                   
+37F000-37FFFF                 (base 16)                     Foresearch                                   
+                                                            Kwanak-ku, Shinrim-dong 56-1 Bldg 138 Rm 302 
+                                                            Seoul  Korea  151-742                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         IEE Inc                                      
+388000-388FFF                 (base 16)                     IEE Inc                                      
+                                                            7740 Lemona Ave                              
+                                                            Van Nuys  California  91409                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         vidisys gmbh                                 
+395000-395FFF                 (base 16)                     vidisys gmbh                                 
+                                                            Rudolf-Diesel-Ring 30                        
+                                                            Sauerlach  Bavaria  D-82054                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MODIA SYSTEMS Co., Ltd                       
+37C000-37CFFF                 (base 16)                     MODIA SYSTEMS Co., Ltd                       
+                                                            1-14-12, Ohsawa                              
+                                                            Koshigaya-shi  Saitama-ken  343-0025         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Chuo Electric Works Co., LTD.                
+34C000-34CFFF                 (base 16)                     Chuo Electric Works Co., LTD.                
+                                                            51 Tateminami                                
+                                                            Watari-Gun  Miyagi  989-2361                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SSI Schaefer Peem                            
+349000-349FFF                 (base 16)                     SSI Schaefer Peem                            
+                                                            Fischeraustrasse 27                          
+                                                            Graz  Steiermark  A-8051                     
+                                                            AT                                           
+
+00-50-C2                      (hex)                         MultimediaLED                                
+33B000-33BFFF                 (base 16)                     MultimediaLED                                
+                                                            11370 Sunrise Park Drive                     
+                                                            Rancho Cordova  CA  95742                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ASPEL S.A.                                   
+368000-368FFF                 (base 16)                     ASPEL S.A.                                   
+                                                            os. Sienkiewicza 33                          
+                                                            Zabierzow  Malopolska  32080                 
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Federal Aviation Administration              
+325000-325FFF                 (base 16)                     Federal Aviation Administration              
+                                                            FAA Technical Center                         
+                                                            Atlantic City  New Jersey  08405             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dornier GmbH                                 
+327000-327FFF                 (base 16)                     Dornier GmbH                                 
+                                                            an der B31                                   
+                                                            Friedrichshafen  Baden-Württemberg  88039    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         I.C.S. Electronics Limited                   
+328000-328FFF                 (base 16)                     I.C.S. Electronics Limited                   
+                                                            Unit V Rudford Industrial Est.               
+                                                            Arundel  West Sussex  BN18 0BF               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Consens Zeiterfassung GMBH                   
+32D000-32DFFF                 (base 16)                     Consens Zeiterfassung GMBH                   
+                                                            Ambachweg 1                                  
+                                                            Rietz  Tirol  6421                           
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Broadcast Sports Inc                         
+331000-331FFF                 (base 16)                     Broadcast Sports Inc                         
+                                                            1360 Blair Drive                             
+                                                            Odenton  MD  21113                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         KoolSpan, Inc.                               
+348000-348FFF                 (base 16)                     KoolSpan, Inc.                               
+                                                            11134 Stephalee Lane                         
+                                                            North Bethesda  MD  20852                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB Xiamen Switchgear Co. Ltd.               
+343000-343FFF                 (base 16)                     ABB Xiamen Switchgear Co. Ltd.               
+                                                            ABB Industrial Park,  Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen S.E.Z.  Fujian Province  361006       
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Cosine Systems, Inc.                         
+317000-317FFF                 (base 16)                     Cosine Systems, Inc.                         
+                                                            736 West Algonquin Road                      
+                                                            Arlington Heights  IL  60005                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dataline AB                                  
+316000-316FFF                 (base 16)                     Dataline AB                                  
+                                                            Katrinedalsgatan 53                          
+                                                            BORÅS    S-50451                             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Saab AB                                      
+2FE000-2FEFFF                 (base 16)                     Saab AB                                      
+                                                            Nobymalmsvägen                               
+                                                            Linköping  Östergötland  581 82              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         VX Technologies Inc.                         
+30B000-30BFFF                 (base 16)                     VX Technologies Inc.                         
+                                                            #2000, 777-8 Avenue SW                       
+                                                            Calgary  Alberta  T2P 3R5                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Obvius                                       
+30E000-30EFFF                 (base 16)                     Obvius                                       
+                                                            20811 NW Cornell Road                        
+                                                            Hillsboro  OR  97124                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         C3-ilex, LLC                                 
+31E000-31EFFF                 (base 16)                     C3-ilex, LLC                                 
+                                                            47009 Benicia St.                            
+                                                            Fremont  California  94538                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lingg & Janke OHG                            
+2EB000-2EBFFF                 (base 16)                     Lingg & Janke OHG                            
+                                                            Zeppelinstr. 30                              
+                                                            Radolfzell  BW  78315                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DALSA                                        
+2E6000-2E6FFF                 (base 16)                     DALSA                                        
+                                                            605 McMurray Rd.                             
+                                                            Waterloo  Ontario  N2V 2E9                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         SafeView, Inc.                               
+2E7000-2E7FFF                 (base 16)                     SafeView, Inc.                               
+                                                            469 El Camino Real                           
+                                                            Santa Clara  CA  95050                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         MG Industrieelektronik GmbH                  
+2E3000-2E3FFF                 (base 16)                     MG Industrieelektronik GmbH                  
+                                                            Nobelstraße 7                                
+                                                            Ettlingen    76275                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tornado Modular Systems, Ltd                 
+2FA000-2FAFFF                 (base 16)                     Tornado Modular Systems, Ltd                 
+                                                            p.b. 709                                     
+                                                            Novosibirsk    630090                        
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Research Applications                        
+2DE000-2DEFFF                 (base 16)                     Research Applications                        
+                                                            650 S 79th St                                
+                                                            Chandler  Az  85226                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Worth Data, Inc.                             
+2D0000-2D0FFF                 (base 16)                     Worth Data, Inc.                             
+                                                            623 Swift Street                             
+                                                            Santa Cruz  CA  95060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+2B1000-2B1FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         DataWind Research                            
+2CD000-2CDFFF                 (base 16)                     DataWind Research                            
+                                                            555 Rene-Levesque West                       
+                                                            Montreal  Quebec  H2Z 1B1                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Admiral Secure Products, Ltd.                
+2B8000-2B8FFF                 (base 16)                     Admiral Secure Products, Ltd.                
+                                                            866 Mantle Crescent                          
+                                                            Mississauga  Ontario  L5V 2G3                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Brannstroms Elektronik AB                    
+2A6000-2A6FFF                 (base 16)                     Brannstroms Elektronik AB                    
+                                                            Uddevallagatan 14                            
+                                                            Goteborg  Vastra Gotaland  41670             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Dr. Staiger, Mohilo + Co GmbH                
+2A9000-2A9FFF                 (base 16)                     Dr. Staiger, Mohilo + Co GmbH                
+                                                            Maierhofstraße 35                            
+                                                            Lorch  Baden-Württemberg  D 73547            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AUM Infotech Private Limited                 
+2AB000-2ABFFF                 (base 16)                     AUM Infotech Private Limited                 
+                                                            306,17c main Road,                           
+                                                            Bangalore  Karnataka  560010                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         CAD-UL GmbH                                  
+299000-299FFF                 (base 16)                     CAD-UL GmbH                                  
+                                                            Nicolaus-Otto Str. 4                         
+                                                            Ulm  BW  89079                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Futaba Corporation                           
+28C000-28CFFF                 (base 16)                     Futaba Corporation                           
+                                                            1080 Yabutsuka                               
+                                                            Chosei-gun,Chosei-mura  Chiba-ken  299-4395  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Rototype S.p.A.                              
+289000-289FFF                 (base 16)                     Rototype S.p.A.                              
+                                                            Via Bessi, 15                                
+                                                            Calenzano  Firenze  50041                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         AXODE SA                                     
+28D000-28DFFF                 (base 16)                     AXODE SA                                     
+                                                            7 RUE FLEMING                                
+                                                            ANGERS    F-49000                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Micronet Ltd.                                
+284000-284FFF                 (base 16)                     Micronet Ltd.                                
+                                                            27 Hametzuda st.                             
+                                                            Azor    58001                                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Air Broadband Communications, Inc.           
+27F000-27FFFF                 (base 16)                     Air Broadband Communications, Inc.           
+                                                            2620 Albany Dr. Suite 245                    
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tieline Research Pty Ltd                     
+276000-276FFF                 (base 16)                     Tieline Research Pty Ltd                     
+                                                            PO Box 2092                                  
+                                                            MALAGA  Western Australia  6944              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         EPSa GmbH                                    
+294000-294FFF                 (base 16)                     EPSa GmbH                                    
+                                                            Göschwitzer Straße 32                        
+                                                            Jena  Thüringen  D-07745                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSM-Messtechnik GmbH                         
+253000-253FFF                 (base 16)                     DSM-Messtechnik GmbH                         
+                                                            Dieselstraße 16                              
+                                                            Aalen  Baden-Württemberg  73431              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Information Technology Corp.                 
+256000-256FFF                 (base 16)                     Information Technology Corp.                 
+                                                            647 Sanctuary Dr.                            
+                                                            Boca Raton  FL  33431                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Macronet s.r.l.                              
+24F000-24FFFF                 (base 16)                     Macronet s.r.l.                              
+                                                            Alsina 2965                                  
+                                                            Buenos Aires    1207                         
+                                                            AR                                           
+
+00-50-C2                      (hex)                         SIMET                                        
+232000-232FFF                 (base 16)                     SIMET                                        
+                                                            Via Rivoli 122                               
+                                                            Villarbasse  Torino  10090                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Hardmeier                                    
+246000-246FFF                 (base 16)                     Hardmeier                                    
+                                                                                                         
+                                                            Tallinn                                      
+                                                            EE                                           
+
+00-50-C2                      (hex)                         PANNOCOM Ltd.                                
+224000-224FFF                 (base 16)                     PANNOCOM Ltd.                                
+                                                            Törökvész út 98/b                            
+                                                            Budapest  Pest Megye  1025                   
+                                                            HU                                           
+
+00-50-C2                      (hex)                         eko systems inc.                             
+229000-229FFF                 (base 16)                     eko systems inc.                             
+                                                            2750 Prosperity Ave                          
+                                                            Fairfax  VA  22031                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SysAware S.A.R.L.                            
+213000-213FFF                 (base 16)                     SysAware S.A.R.L.                            
+                                                            Mas David                                    
+                                                            Vezenobres  Gard  30360                      
+                                                            FR                                           
+
+00-50-C2                      (hex)                         EdenTree Technologies, Inc.                  
+233000-233FFF                 (base 16)                     EdenTree Technologies, Inc.                  
+                                                            1040 Flynn Road                              
+                                                            Camarillo  California  93012                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         POLIMAR ELEKTRONIK LTD.                      
+235000-235FFF                 (base 16)                     POLIMAR ELEKTRONIK LTD.                      
+                                                            AEGEAN FREE ZONE - ESBAS                     
+                                                            IZMIR  ESBAS  35410                          
+                                                            TR                                           
+
+00-50-C2                      (hex)                         Willowglen Systems Inc.                      
+1FB000-1FBFFF                 (base 16)                     Willowglen Systems Inc.                      
+                                                            8522 - Davies Road                           
+                                                            Edmonton  AB  T6E 4Y5                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ARC'Créations                                
+1F7000-1F7FFF                 (base 16)                     ARC'Créations                                
+                                                            ZI les Milles 100 rue Pierre DUHEM           
+                                                            Aix en Provence  BDR  13856                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         OlympusNDT                                   
+201000-201FFF                 (base 16)                     OlympusNDT                                   
+                                                            421 N Quay                                   
+                                                            Kennewick  WA  99336                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         4Links Limited                               
+212000-212FFF                 (base 16)                     4Links Limited                               
+                                                            PO Box 816, The Mansion                      
+                                                            Milton Keynes  Buckinghamshire  MK3 6ZP      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         nNovia, Inc.                                 
+208000-208FFF                 (base 16)                     nNovia, Inc.                                 
+                                                            1620 Oakland Rd.                             
+                                                            San jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMKA-electronic AG                           
+1ED000-1EDFFF                 (base 16)                     EMKA-electronic AG                           
+                                                            Lohmühlenweg 18a                             
+                                                            Arnstadt  Thüringen  99310                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Perto Periféricos de Automação S.A.          
+1EE000-1EEFFF                 (base 16)                     Perto Periféricos de Automação S.A.          
+                                                            Rua Nissin Castiel, 640                      
+                                                            Gravataí  RS  94000-970                      
+                                                            BR                                           
+
+00-50-C2                      (hex)                         United Tri-Tech Corporation                  
+1E6000-1E6FFF                 (base 16)                     United Tri-Tech Corporation                  
+                                                            550 Campbell Street                          
+                                                            Cornwall  Ontario  K6H 6T7                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Smith Meter, Inc.                            
+1E7000-1E7FFF                 (base 16)                     Smith Meter, Inc.                            
+                                                            1602 Wagner Ave.                             
+                                                            Erie  PA  16510                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+1F2000-1F2FFF                 (base 16)                     Tattile srl                                  
+                                                            Via Trento 127/129                           
+                                                            Capriano del Colle  Brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Soronti, Inc.                                
+1E4000-1E4FFF                 (base 16)                     Soronti, Inc.                                
+                                                            12159 Business Park Dr, suite 140            
+                                                            Draper  Utah  84020                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         DIGITRONIC Automationsanlagen GmbH           
+1E2000-1E2FFF                 (base 16)                     DIGITRONIC Automationsanlagen GmbH           
+                                                            Auf der Langwies 1                           
+                                                            Huenstetten-Wallbach  Hessen  65510          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Automaatiotekniikka Seppo Saari Oy           
+1E1000-1E1FFF                 (base 16)                     Automaatiotekniikka Seppo Saari Oy           
+                                                            Tilhenkatu 1                                 
+                                                            Turku    20610                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Pleora Technologies Inc.                     
+1D7000-1D7FFF                 (base 16)                     Pleora Technologies Inc.                     
+                                                            359 Terry Fox Drive, Suite 230               
+                                                            Kanata  ON  K2K 2E7                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Remco Italia Spa                             
+1C6000-1C6FFF                 (base 16)                     Remco Italia Spa                             
+                                                            Strada Rivoltana Nuova 53                    
+                                                            Vignate  MI  20060                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Euphony technology CO., LTD.                 
+1C8000-1C8FFF                 (base 16)                     Euphony technology CO., LTD.                 
+                                                            7FI.-4, No.131, Lane235, Bauchiau RD., S     
+                                                            Shindian City  Taipei  231                   
+                                                            TW                                           
+
+00-50-C2                      (hex)                         modas GmbH                                   
+1C9000-1C9FFF                 (base 16)                     modas GmbH                                   
+                                                            Buelowstr. 90                                
+                                                            Berlin    10783                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Flander Oy                                   
+1C5000-1C5FFF                 (base 16)                     Flander Oy                                   
+                                                            Satakunnankatu 18B                           
+                                                            Tampere    33 210                            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Phase IV Engineering Inc.                    
+1D4000-1D4FFF                 (base 16)                     Phase IV Engineering Inc.                    
+                                                            2820 Wilderness Place, Suite C               
+                                                            Bolder  Colorado  80301                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         AIOI Systems Co., Ltd.                       
+1BD000-1BDFFF                 (base 16)                     AIOI Systems Co., Ltd.                       
+                                                            KDX Omori, Bldg 8F                           
+                                                            Tokyo    140-0016                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Thrane & Thrane A/S                          
+1B5000-1B5FFF                 (base 16)                     Thrane & Thrane A/S                          
+                                                            Lundtoftegaardsvej 93D                       
+                                                            Kgl. Lyngby  DK  2800                        
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Electronic Systems Development               
+1B8000-1B8FFF                 (base 16)                     Electronic Systems Development               
+                                                            39 Batavia St                                
+                                                            Somerset West  Cape Province  7130           
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Protech Optronics Co. Ltd.                   
+1A4000-1A4FFF                 (base 16)                     Protech Optronics Co. Ltd.                   
+                                                            5th Floor, No. 82-3 Dongsung Street, Sulin City
+                                                            Taipei County    235                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Axes Technologies                            
+1B1000-1B1FFF                 (base 16)                     Axes Technologies                            
+                                                            14333 Proton Rd                              
+                                                            Dallas  TX  75244                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Survalent Technology Corporation             
+199000-199FFF                 (base 16)                     Survalent Technology Corporation             
+                                                            7965 Heritage Road                           
+                                                            Brampton  Ontario  L6Y 5X5                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Teradyne Inc.                                
+18B000-18BFFF                 (base 16)                     Teradyne Inc.                                
+                                                            30801 Agoura Rd.                             
+                                                            Agoura Hills  CA  91301                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Technodrive srl                              
+18C000-18CFFF                 (base 16)                     Technodrive srl                              
+                                                            Via Leonardo da Vinci  162                   
+                                                            Trezzano S/N  Milan  20090                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ELECTREX S.R.L                               
+19D000-19DFFF                 (base 16)                     ELECTREX S.R.L                               
+                                                            VIA CLAUDIA 96                               
+                                                            SAVIGNANO SUL PANARO  MODENA  41056          
+                                                            IT                                           
+
+00-50-C2                      (hex)                         PDQ Manufacturing                            
+17F000-17FFFF                 (base 16)                     PDQ Manufacturing                            
+                                                            1698 Scheuring Road                          
+                                                            De Pere  WI  54115                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         WOLF Advanced Technology.                    
+17A000-17AFFF                 (base 16)                     WOLF Advanced Technology.                    
+                                                            2 Campbell Drive, Suite 200                  
+                                                            Uxbridge  Ontario  L9P 1H6                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Dickson Technologies                         
+16F000-16FFFF                 (base 16)                     Dickson Technologies                         
+                                                            930 Westwood Ave.                            
+                                                            Addison  IL  60101                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Datakinetics Ltd.                            
+009000-009FFF                 (base 16)                     Datakinetics Ltd.                            
+                                                            21 Green Lane                                
+                                                                SP6 1HU                                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         N&P Technologies                             
+174000-174FFF                 (base 16)                     N&P Technologies                             
+                                                            Samsung Jangchung Branch                     
+                                                            Dong lga Jung-gu  Seoul                      
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Time Domain                                  
+16A000-16AFFF                 (base 16)                     Time Domain                                  
+                                                            7057 Old Madison Pike                        
+                                                            Huntsville  AL  35806                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Integrated Automation Solutions              
+002000-002FFF                 (base 16)                     Integrated Automation Solutions              
+                                                            111 Lakefront Drive                          
+                                                            Hunt Valley  MD  21030                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pulsar GmbH                                  
+15F000-15FFFF                 (base 16)                     Pulsar GmbH                                  
+                                                            Hollenstedter Strasse 43                     
+                                                            Heidenau    21258                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Plextek Limited                              
+15A000-15AFFF                 (base 16)                     Plextek Limited                              
+                                                            London Road                                  
+                                                            Essex    CB10 1NY                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Jostra AB                                    
+154000-154FFF                 (base 16)                     Jostra AB                                    
+                                                            Annedalsv. 2B                                
+                                                            Lund    22764                                
+                                                            SE                                           
+
+00-50-C2                      (hex)                         SEATECH                                      
+095000-095FFF                 (base 16)                     SEATECH                                      
+                                                            101 N. Beach Rd.                             
+                                                            Dania Beach  FL  33004                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         wellink, Ltd.                                
+14D000-14DFFF                 (base 16)                     wellink, Ltd.                                
+                                                            R&D Center, #307, A-Dong,                    
+                                                            Yatop-Dong, Pundang-Ku,  Sungnam-Si, Kyungki-Do,  
+                                                            KR                                           
+
+00-50-C2                      (hex)                         AVerMedia Systems, Inc.                      
+13E000-13EFFF                 (base 16)                     AVerMedia Systems, Inc.                      
+                                                            7F.,No. 137,Jian Yi Rd                       
+                                                            Chung-Ho City  Taipei                        
+                                                            TW                                           
+
+00-50-C2                      (hex)                         NBG Industrial Automation B.V.               
+13C000-13CFFF                 (base 16)                     NBG Industrial Automation B.V.               
+                                                            Hulsenweg 19                                 
+                                                            6031 SP Nederweert                           
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Tex Computer SRL                             
+13A000-13AFFF                 (base 16)                     Tex Computer SRL                             
+                                                            Via Mercadante, 35                           
+                                                            47841 Cattocica (RN)                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ChipWrights, Inc.                            
+133000-133FFF                 (base 16)                     ChipWrights, Inc.                            
+                                                            2150 Washington St.                          
+                                                            Newton  MA  02462                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Symbolic Sound Corp.                         
+12A000-12AFFF                 (base 16)                     Symbolic Sound Corp.                         
+                                                            PO Box 2549                                  
+                                                            Champaign  IL  61825-2549                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Procon Electronics                           
+132000-132FFF                 (base 16)                     Procon Electronics                           
+                                                            PO Box 164                                   
+                                                            Sydney  NSW  1730                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Microbit 2.0 AB                              
+118000-118FFF                 (base 16)                     Microbit 2.0 AB                              
+                                                            Nystaden 1                                   
+                                                            SE-952 61 Kalix                              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Teamaxess Ticketing GmbH                     
+11A000-11AFFF                 (base 16)                     Teamaxess Ticketing GmbH                     
+                                                            Gewerbepark Habach1                          
+                                                            A-5321 Koppl                                 
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Photonic Bridges, Inc.                       
+10C000-10CFFF                 (base 16)                     Photonic Bridges, Inc.                       
+                                                            249 Mountain Road                            
+                                                            Basking Ridge  NJ  07920                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Unipower AB                                  
+10E000-10EFFF                 (base 16)                     Unipower AB                                  
+                                                            PO Box 411                                   
+                                                            SE-441 28 Alingsas                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ITK Dr. Kassen GmbH                          
+109000-109FFF                 (base 16)                     ITK Dr. Kassen GmbH                          
+                                                            Beim Eberacker 3                             
+                                                            D-35633 Lahnau                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ace Electronics, Inc.                        
+113000-113FFF                 (base 16)                     Ace Electronics, Inc.                        
+                                                            PO Box 890955                                
+                                                            Temecula  CA  92590                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Polyvision Corporation                       
+0F1000-0F1FFF                 (base 16)                     Polyvision Corporation                       
+                                                            14523 SW Milliken Way                        
+                                                            Beaverton  OR  97005                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Young Computer Co., Ltd.                     
+0F3000-0F3FFF                 (base 16)                     Young Computer Co., Ltd.                     
+                                                            6th Fl. Bojung Bldg.                         
+                                                            Seoul 138-190                                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         iReady Corporation                           
+0EA000-0EAFFF                 (base 16)                     iReady Corporation                           
+                                                            2903 Bunker Hill Lane                        
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Foss NIRSystems, Inc.                        
+0F7000-0F7FFF                 (base 16)                     Foss NIRSystems, Inc.                        
+                                                            7703 Montpelier Road                         
+                                                            Laurel  MD  20723                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Clearwater Networks                          
+0E5000-0E5FFF                 (base 16)                     Clearwater Networks                          
+                                                            160 Knowles Dr.                              
+                                                            Los Gatos  CA  95032                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Audio Design Associates, Inc.                
+0E8000-0E8FFF                 (base 16)                     Audio Design Associates, Inc.                
+                                                            602-610 Mamaroneck Ave.                      
+                                                            White Plains  NY  10605                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lake Technology, Ltd.                        
+0D3000-0D3FFF                 (base 16)                     Lake Technology, Ltd.                        
+                                                            PO Box 736                                   
+                                                            Broadway, 2007                               
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Renaissance Networking, Inc.                 
+0D1000-0D1FFF                 (base 16)                     Renaissance Networking, Inc.                 
+                                                            415 S. McClintock Dr.                        
+                                                            Tempe  AZ  85281                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Telefrang AB                                 
+0D0000-0D0FFF                 (base 16)                     Telefrang AB                                 
+                                                            Varbergsgatan 8                              
+                                                            S-412 65 Gothenburg                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         RFL Electronics, Inc.                        
+0CE000-0CEFFF                 (base 16)                     RFL Electronics, Inc.                        
+                                                            353 Powerville Road                          
+                                                            Booton Twp.  NJ  07005                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSS Networks, Inc.                           
+0C9000-0C9FFF                 (base 16)                     DSS Networks, Inc.                           
+                                                            111 Pacifica                                 
+                                                            Irvine  CA  92618                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Casabyte                                     
+0C1000-0C1FFF                 (base 16)                     Casabyte                                     
+                                                            4012 SW 327th St.                            
+                                                            Federal Way  WA  98023                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         The Trane Company                            
+0C8000-0C8FFF                 (base 16)                     The Trane Company                            
+                                                            4833 White Bear Parkway                      
+                                                            St. Paul  MN  55110                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         TransComm Technology System, Inc.            
+0C7000-0C7FFF                 (base 16)                     TransComm Technology System, Inc.            
+                                                            4221 Technology Drive                        
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile                                      
+0BD000-0BDFFF                 (base 16)                     Tattile                                      
+                                                            via Trento 127                               
+                                                            Capriano Del Colle  25020 Brescia            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         MAZet GmbH                                   
+0BB000-0BBFFF                 (base 16)                     MAZet GmbH                                   
+                                                            Goeschwitzer Str.32                          
+                                                            D-07745 Jena                                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Imigix Ltd.                                  
+0C0000-0C0FFF                 (base 16)                     Imigix Ltd.                                  
+                                                            Cardiff Gate Business Park                   
+                                                            Cardiff CF23 8RD                             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Wavefly Corporation                          
+0B4000-0B4FFF                 (base 16)                     Wavefly Corporation                          
+                                                            9420 Research Blvd.                          
+                                                            Austin  TX  78759                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Beeline Networks, Inc.                       
+0B1000-0B1FFF                 (base 16)                     Beeline Networks, Inc.                       
+                                                            2025 Stierlin Court                          
+                                                            Mountain View  CA  94043                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Zarak Systems Corp.                          
+0AE000-0AEFFF                 (base 16)                     Zarak Systems Corp.                          
+                                                            1175 Borregas Ave.                           
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Analytical Spectral Devices, Inc.            
+094000-094FFF                 (base 16)                     Analytical Spectral Devices, Inc.            
+                                                            5335 Sterling Dr.                            
+                                                            Boulder  CO  80301                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Invensys Controls Network Systems            
+090000-090FFF                 (base 16)                     Invensys Controls Network Systems            
+                                                            1701 Byrd Ave.                               
+                                                            Richmond  VA  23230                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Caspian Networks                             
+07D000-07DFFF                 (base 16)                     Caspian Networks                             
+                                                            2880 West Bayshore Rd                        
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Signal Corp.                        
+06D000-06DFFF                 (base 16)                     Advanced Signal Corp.                        
+                                                            PO Box 713                                   
+                                                            Quincy  IL  62306-0713                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Simple Network Magic Corporation             
+061000-061FFF                 (base 16)                     Simple Network Magic Corporation             
+                                                            401 Kentucky Lane                            
+                                                            McKinney  TX  75069                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Austco Communication Systems Pty, Ltd        
+059000-059FFF                 (base 16)                     Austco Communication Systems Pty, Ltd        
+                                                            40 O'Malley St                               
+                                                            Osborne Park  Western Australia 6017         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         MiSPO Co., Ltd.                              
+040000-040FFF                 (base 16)                     MiSPO Co., Ltd.                              
+                                                            Kanagawa Prefecture,                         
+                                                            Kawasaki City,    213-0002                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         BrainBoxes Ltd                               
+03C000-03CFFF                 (base 16)                     BrainBoxes Ltd                               
+                                                            Unit 3C, Wavertree Boulevard South           
+                                                            Liverpool  L7 9PF, England                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         MSU UK Ltd                                   
+03E000-03EFFF                 (base 16)                     MSU UK Ltd                                   
+                                                            526-528 Elder House                          
+                                                            Milton Keynes MK9 1LR                        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Tecstar Demo Systems Division                
+04B000-04BFFF                 (base 16)                     Tecstar Demo Systems Division                
+                                                            379 Science Dr.                              
+                                                            Moorpark  CA  93021                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Curtis, Inc.                                 
+043000-043FFF                 (base 16)                     Curtis, Inc.                                 
+                                                            2155 Niagara Lane, North                     
+                                                            Minneapolis  MN  55447                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Alliant Techsystems, Inc.                    
+035000-035FFF                 (base 16)                     Alliant Techsystems, Inc.                    
+                                                            600 Second St NE                             
+                                                            Hopkins  MN  55343-8384                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         VNR Electronique SA                          
+03B000-03BFFF                 (base 16)                     VNR Electronique SA                          
+                                                            Avenue de France 90                          
+                                                            CH-1004 Lausanne                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Arcturus Networks Inc.                       
+036000-036FFF                 (base 16)                     Arcturus Networks Inc.                       
+                                                            701 Evans Ave. - Suite 300                   
+                                                            Toronto  Ontario  M9C 1A3                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         MotionIO                                     
+032000-032FFF                 (base 16)                     MotionIO                                     
+                                                            650 Saratoga Ave                             
+                                                            San Jose  CA  95129                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Abatis Systems Corp.                         
+026000-026FFF                 (base 16)                     Abatis Systems Corp.                         
+                                                            4190 Still Creek Drive                       
+                                                            Burnaby B.C.    V5C 6C6                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Skylake Talix                                
+01A000-01AFFF                 (base 16)                     Skylake Talix                                
+                                                            Unit 3, Lulworth Business Ctr.               
+                                                            S040 Southampton 3WW                         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Cross Products Ltd.                          
+01B000-01BFFF                 (base 16)                     Cross Products Ltd.                          
+                                                            23 The Calls, Leeds                          
+                                                                England                                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         KBS Industrieelektronik GmbH                 
+01F000-01FFFF                 (base 16)                     KBS Industrieelektronik GmbH                 
+                                                            Burkheimer Str. 3                            
+                                                                                                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Floware System Solutions Ltd.                
+012000-012FFF                 (base 16)                     Floware System Solutions Ltd.                
+                                                            28 Hacharoshet St., P.O.B. 812               
+                                                                                                         
+                                                            IL                                           
+
+00-50-C2                      (hex)                         GD California, Inc.                          
+005000-005FFF                 (base 16)                     GD California, Inc.                          
+                                                            1799 Portola Ave.                            
+                                                            Livermore  CA  94550                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mettler Toledo                               
+24D000-24DFFF                 (base 16)                     Mettler Toledo                               
+                                                            1571 Northpointe Parkway                     
+                                                            Lutz  FL  33558                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mettler Toledo                               
+AB5000-AB5FFF                 (base 16)                     Mettler Toledo                               
+                                                            1571 Northpointe Parkway                     
+                                                            Lutz  FL  33558                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         Serveron Corporation                         
+04C000-04CFFF                 (base 16)                     Serveron Corporation                         
+                                                            13550 SW Karl Braun Drive                    
+                                                            Beaverton  OR  97077                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         DEUTA-WERKE GmbH                             
+FD7000-FD7FFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather str. 140                          
+                                                            Bergisch Gladbach    51465                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elbit Systems of America                     
+FBA000-FBAFFF                 (base 16)                     Elbit Systems of America                     
+                                                            4700 Marine Creek Parkway                    
+                                                            Fort Worth  TX  76179                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         peiker acustic GmbH                          
+1DD000-1DDFFF                 (base 16)                     peiker acustic GmbH                          
+                                                            Max-Planck-Strasse 28-32                     
+                                                            Friedrichsdorf    61381                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         APG Cash Drawer, LLC                         
+B54000-B54FFF                 (base 16)                     APG Cash Drawer, LLC                         
+                                                            5250 Industrial Blvd NE                      
+                                                            Minneapolis  MN  55421                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         ARGUS-SPECTRUM                               
+764000-764FFF                 (base 16)                     ARGUS-SPECTRUM                               
+                                                            65, Serdobolskaya str.                       
+                                                            St-Peterburg    197342                       
+                                                            RU                                           
+
+40-D8-55                      (hex)                         ARGUS-SPECTRUM                               
+17A000-17AFFF                 (base 16)                     ARGUS-SPECTRUM                               
+                                                            Serdobolskaya str.,65A                       
+                                                            Saint-Petersburg    197342                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         TRONICO                                      
+74E000-74EFFF                 (base 16)                     TRONICO                                      
+                                                            26 rue du Bocage                             
+                                                            St Philbert de Bouaine  Vendée  85660        
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Honeywell International                      
+04E000-04EFFF                 (base 16)                     Honeywell International                      
+                                                            13125 Danielson Street                       
+                                                            Poway    92064                               
+                                                            US                                           
+
+40-D8-55                      (hex)                         Honeywell                                    
+080000-080FFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Highway 19 N                        
+                                                            Clearwater  FL  33764                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Junger Audio-Studiotechnik GmbH              
+583000-583FFF                 (base 16)                     Junger Audio-Studiotechnik GmbH              
+                                                            Justus-von-Liebig-Straße 7                   
+                                                            Berlin    12489                              
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Zhejiang Wellsun Electric Meter Co.,Ltd      
+13F000-13FFFF                 (base 16)                     Zhejiang Wellsun Electric Meter Co.,Ltd      
+                                                            No 189 East Xixia Road                       
+                                                            Taizhou  Zhejiang  317200                    
+                                                            CN                                           
+
+00-50-C2                      (hex)                         YUYAMA MFG Co.,Ltd                           
+A2E000-A2EFFF                 (base 16)                     YUYAMA MFG Co.,Ltd                           
+                                                            3-3-1                                        
+                                                            TOYONAKASHI  OSAKA  561-0841                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         MB connect line GmbH Fernwartungssysteme     
+717000-717FFF                 (base 16)                     MB connect line GmbH Fernwartungssysteme     
+                                                            Winnettener Str.6                            
+                                                            Dinkelsbuehl  bavaria  91550                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MB connect line GmbH Fernwartungssysteme     
+FE9000-FE9FFF                 (base 16)                     MB connect line GmbH Fernwartungssysteme     
+                                                            Winnettener Straße 5                         
+                                                            Dinkelsbühl  Bavaria  91550                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Guardtec,Inc                                 
+D09000-D09FFF                 (base 16)                     Guardtec,Inc                                 
+                                                            #1203, Hansin IT Tower, 235,                 
+                                                            Seoul    152-768                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Guardian Controls International Ltd          
+1D8000-1D8FFF                 (base 16)                     Guardian Controls International Ltd          
+                                                            56, Crewe Road,                              
+                                                            Sandbach  Cheshire  CW11 4NN                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Imarda New Zealand Limited                   
+31D000-31DFFF                 (base 16)                     Imarda New Zealand Limited                   
+                                                            Suite G16, National Innovation Centre,       
+                                                            Eveleigh NSW     2015                        
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Erhardt+Leimer GmbH                          
+FE7000-FE7FFF                 (base 16)                     Erhardt+Leimer GmbH                          
+                                                            Albert-Leimer-Platz 1                        
+                                                            Stadtbergen    86391                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DiTEST Fahrzeugdiagnose GmbH                 
+E24000-E24FFF                 (base 16)                     DiTEST Fahrzeugdiagnose GmbH                 
+                                                            Alte Poststrasse 152                         
+                                                            Graz  Steiermark  8020                       
+                                                            AT                                           
+
+00-50-C2                      (hex)                         ard sa                                       
+A80000-A80FFF                 (base 16)                     ard sa                                       
+                                                            Micropolis Bat Clematis                      
+                                                            Gap  France  05000                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Enyx SA                                      
+FD1000-FD1FFF                 (base 16)                     Enyx SA                                      
+                                                            8 rue greneta                                
+                                                            Paris    75003                               
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Mesa Labs, Inc.                              
+9B2000-9B2FFF                 (base 16)                     Mesa Labs, Inc.                              
+                                                            12100 West 6th Ave                           
+                                                            Lakewood  CO  80228                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Arrow Central Europe GmbH - Division Spoerle 
+A60000-A60FFF                 (base 16)                     Arrow Central Europe GmbH - Division Spoerle 
+                                                            Max-Planck-Str. 1-3                          
+                                                            Dreieich    D-63303                          
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Electrical Geodesics Incorporated            
+024000-024FFF                 (base 16)                     Electrical Geodesics Incorporated            
+                                                            1600 Millrace Drive                          
+                                                            Eugene  Oregon  97403-1995                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         JSC Kaluga Teletypes Manufacturing Plant     
+F9D000-F9DFFF                 (base 16)                     JSC Kaluga Teletypes Manufacturing Plant     
+                                                            141, Saltykova-Schedrina Street              
+                                                            Kaluga  Kaluga region  248002                
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Critical Link LLC                            
+49D000-49DFFF                 (base 16)                     Critical Link LLC                            
+                                                            6712 Brooklawn Parkway                       
+                                                            Syracuse  NY  13211                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         AR'S CO., LTD.                               
+760000-760FFF                 (base 16)                     AR'S CO., LTD.                               
+                                                            Yokohama Creation Square,                    
+                                                            Yokohama  Kanagawa  221-0052                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+485000-485FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße  39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+459000-459FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Strasse 39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TT electronics plc                           
+1C3000-1C3FFF                 (base 16)                     TT electronics plc                           
+                                                            Kitty Brewster Estate                        
+                                                            Blyth  Northumberland  NE3 2AX               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         MedAvant Healthcare                          
+601000-601FFF                 (base 16)                     MedAvant Healthcare                          
+                                                            2533 Centennial Blvd                         
+                                                            Jeffersonville  IN  47130                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Delphin Technology AG                        
+138000-138FFF                 (base 16)                     Delphin Technology AG                        
+                                                            Offsermannsheider Str. 184                   
+                                                            51515 Kurten    000                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Applied Micro Electronics AME bv             
+B30000-B30FFF                 (base 16)                     Applied Micro Electronics AME bv             
+                                                            ESP 100                                      
+                                                            Eindhoven  NoordBrabant  5633 AA             
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Sentry 360 Security                          
+093000-093FFF                 (base 16)                     Sentry 360 Security                          
+                                                            24012 W Renwick Road                         
+                                                            Plainfield  IL  60544                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Applied Micro Electronics AME bv             
+F33000-F33FFF                 (base 16)                     Applied Micro Electronics AME bv             
+                                                            Esp 100                                      
+                                                            Eindhoven  Noord Brabant  5633AA             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Fracarro srl                                 
+21C000-21CFFF                 (base 16)                     Fracarro srl                                 
+                                                            Via Cazzaro 3                                
+                                                            Castelfranco Veneto  Treviso  31033          
+                                                            IT                                           
+
+40-D8-55                      (hex)                         DORLET SAU                                   
+15A000-15AFFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Miñano Mayor  Alava  01510                  
+                                                            ES                                           
+
+40-D8-55                      (hex)                         DORLET SAU                                   
+06F000-06FFFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Eistein 34                            
+                                                            Miñano Mayor  Alava  01510                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+9E7000-9E7FFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Miñanoo Mayor  ALAVA  01510                  
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Scandyna A/S                                 
+125000-125FFF                 (base 16)                     Scandyna A/S                                 
+                                                            Jegindoevej 4                                
+                                                            Viborg    8800                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Edgeware AB                                  
+6B2000-6B2FFF                 (base 16)                     Edgeware AB                                  
+                                                            Master Samuelsgatan 42                       
+                                                            Stockholm    11157                           
+                                                            SE                                           
+
+40-D8-55                      (hex)                         Better Place                                 
+0F8000-0F8FFF                 (base 16)                     Better Place                                 
+                                                            Amal 13B, Afek Industrial park               
+                                                            Rosh Ha'ain,                                 
+                                                            IL                                           
+
+00-50-C2                      (hex)                         ExtremeSpeed Inc.                            
+168000-168FFF                 (base 16)                     ExtremeSpeed Inc.                            
+                                                            PO Box 600                                   
+                                                            Mannville  Alberta  T0B 2W0                  
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Wuhan Xingtuxinke ELectronic Co.,Ltd         
+089000-089FFF                 (base 16)                     Wuhan Xingtuxinke ELectronic Co.,Ltd         
+                                                            NO.C3-8F,SOFTWARE PARK                       
+                                                            Wuhan  Hubei  430074                         
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Apantac LLC                                  
+A78000-A78FFF                 (base 16)                     Apantac LLC                                  
+                                                            13500 SW Pacific HWY                         
+                                                            Portland  OR  97223                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         IAdea Corporation                            
+888000-888FFF                 (base 16)                     IAdea Corporation                            
+                                                            3F, NO.33, LANE 77, XING-AI ROAD             
+                                                            TAIPEI    114                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Helmut Mauell GmbH Werk Weida                
+0B9000-0B9FFF                 (base 16)                     Helmut Mauell GmbH Werk Weida                
+                                                            Am Rosenhugel 1-7                            
+                                                            42553 Velbert    0000                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Robert Bosch Healthcare Systems, Inc.        
+F2D000-F2DFFF                 (base 16)                     Robert Bosch Healthcare Systems, Inc.        
+                                                            2400 Geng Road                               
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         NOVACOMM LTDA                                
+5FE000-5FEFFF                 (base 16)                     NOVACOMM LTDA                                
+                                                            R. Benjui , 79                               
+                                                            São Paulo  SP  04689-000                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Vocality International Ltd                   
+667000-667FFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Shackleford  Surrey  GU8 6AP                 
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Vocality International Ltd                   
+14B000-14BFFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Guildford  Surrey  GU86AP                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ZP Engineering SEL                           
+26E000-26EFFF                 (base 16)                     ZP Engineering SEL                           
+                                                            via Ardito Desio, 60                         
+                                                            ROME    00131                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+9F9000-9F9FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+D84000-D84FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+DE1000-DE1FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         PYRAMID Computer GmbH                        
+5E2000-5E2FFF                 (base 16)                     PYRAMID Computer GmbH                        
+                                                            Boetzinger Strasse 60                        
+                                                            Freiburg  BW  79111                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Pumatronix Equipamentos Eletronicos Ltda.    
+8C8000-8C8FFF                 (base 16)                     Pumatronix Equipamentos Eletronicos Ltda.    
+                                                            Rua Algacyr Munhoz Mader, 3775               
+                                                            Curitiba  Paraná  81350-010                  
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Rohde&Schwarz Topex SA                       
+06C000-06CFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+18A000-18AFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+110000-110FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+B49000-B49FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Power Electronics Espana, S.L.               
+102000-102FFF                 (base 16)                     Power Electronics Espana, S.L.               
+                                                            Leonardo Da Vinci, 24-26                     
+                                                            Paterna  Valencia  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         RFL Electronics, Inc.                        
+ED5000-ED5FFF                 (base 16)                     RFL Electronics, Inc.                        
+                                                            353 Powerville Road                          
+                                                            Boonton Township  NJ  07005                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wireless Cables Inc.                         
+8E2000-8E2FFF                 (base 16)                     Wireless Cables Inc.                         
+                                                            1414 Soquel Ave, Ste 212                     
+                                                            Santa Cruz  CA  95062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         WaveIP                                       
+6FB000-6FBFFF                 (base 16)                     WaveIP                                       
+                                                            Teradion Industrial Park                     
+                                                            Misgav    20179                              
+                                                            IL                                           
+
+00-50-C2                      (hex)                         WaveIP                                       
+1CC000-1CCFFF                 (base 16)                     WaveIP                                       
+                                                            Teradion Industrial Park                     
+                                                            Misgav    20179                              
+                                                            IL                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+21B000-21BFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt Street                     
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+9A9000-9A9FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ReaMetrix, Inc.                              
+A56000-A56FFF                 (base 16)                     ReaMetrix, Inc.                              
+                                                            1585 Industrial Road                         
+                                                            San Carlos  CA  94070                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Optibase Ltd.                                
+14C000-14CFFF                 (base 16)                     Optibase Ltd.                                
+                                                            Shenkar 7                                    
+                                                            Herzlya    46725                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         LMI Technologies                             
+0B0000-0B0FFF                 (base 16)                     LMI Technologies                             
+                                                            1673 Cliveden Avenue                         
+                                                            Delta  British Columbia  V3M 6V5             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Lighting Science Group                       
+93D000-93DFFF                 (base 16)                     Lighting Science Group                       
+                                                            11390 Sunrise Gold Circle #800               
+                                                            Rancho Cordova  CA  95742                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+F97000-F97FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Jäger Computergesteuerte Meßtechnik GmbH.    
+0A2000-0A2FFF                 (base 16)                     Jäger Computergesteuerte Meßtechnik GmbH.    
+                                                            Rheinstratraße 2-4                           
+                                                            Lorsch  Hessen  64653                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ITF Fröschl GmbH                             
+B76000-B76FFF                 (base 16)                     ITF Fröschl GmbH                             
+                                                            Hauserbachstraße 9                           
+                                                            Walderbach  Bavaria  93194                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Intuitive Surgical, Inc                      
+9CF000-9CFFFF                 (base 16)                     Intuitive Surgical, Inc                      
+                                                            950 Kifer Road                               
+                                                            Sunnyvale  CA  94040                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         4RF Communications Ltd                       
+2ED000-2EDFFF                 (base 16)                     4RF Communications Ltd                       
+                                                            26 Glover Street                             
+                                                            Wellington    6032                           
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Elbit Systems Ltd.                           
+4C2000-4C2FFF                 (base 16)                     Elbit Systems Ltd.                           
+                                                            p.o.b. 539                                   
+                                                            Haifa    36925                               
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Efficient Channel Coding                     
+2F4000-2F4FFF                 (base 16)                     Efficient Channel Coding                     
+                                                            600 Safeguard Plaza                          
+                                                            Brooklyn Heights    44131                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         DELTA TAU DATA SYSTEMS, INC.                 
+CBA000-CBAFFF                 (base 16)                     DELTA TAU DATA SYSTEMS, INC.                 
+                                                            21314 LASSEN ST                              
+                                                            CHATSWORTH  CA  91311                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crystal Vision Ltd                           
+26C000-26CFFF                 (base 16)                     Crystal Vision Ltd                           
+                                                            Lion Technology Park, Station Road East      
+                                                            Cambridge  Cambs  CB2 4NL                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Genetec Inc.                                 
+BE7000-BE7FFF                 (base 16)                     Genetec Inc.                                 
+                                                            2280 Alfred-Nobel Blvd., Suite 400           
+                                                            Saint-Laurent  Quebec  H4S 2A4               
+                                                            CA                                           
+
+00-50-C2                      (hex)                         DINEC International                          
+1BC000-1BCFFF                 (base 16)                     DINEC International                          
+                                                            Rue de la Gare, 30                           
+                                                            BRAINE L'ALLEUD   BW  1420                   
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Grossenbacher Systeme AG                     
+410000-410FFF                 (base 16)                     Grossenbacher Systeme AG                     
+                                                            Spinnereistrasse 10                          
+                                                            St. Gallen  SG  9008                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         IBEX UK Limited                              
+501000-501FFF                 (base 16)                     IBEX UK Limited                              
+                                                            32A Station Road West                        
+                                                            Oxted  Kent  RH8 9EU                         
+                                                            GB                                           
+
+40-D8-55                      (hex)                         TATTILE SRL                                  
+133000-133FFF                 (base 16)                     TATTILE SRL                                  
+                                                            via G.Donizetti 1/3/5                        
+                                                            Brescia    25030                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+447000-447FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Grupo Epelsa S.L.                            
+111000-111FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Punto Net,3                               
+                                                            Alcala de Henares  Madrid  28805             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Baxter International Inc                     
+2E0000-2E0FFF                 (base 16)                     Baxter International Inc                     
+                                                            One Baxter Parkway                           
+                                                            Deerfield  IL  60015                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+0E0000-0E0FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62901                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         EMAC, Inc.                                   
+09D000-09DFFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62901                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Shenzhen MaiWei Cable TV Equipment CO.,LTD.  
+50D000-50DFFF                 (base 16)                     Shenzhen MaiWei Cable TV Equipment CO.,LTD.  
+                                                            13/F,Fiyta Hi-tech Building,GaoXinnanyi Avenue,Southern District of Hi-tech Park,Nanshan District
+                                                            Shenzhen  Guangdong  518057                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Energy Technology and Control Ltd.           
+1DA000-1DAFFF                 (base 16)                     Energy Technology and Control Ltd.           
+                                                            25 North Street                              
+                                                            Lewes  East Sussex  BN7 2PE                  
+                                                            GB                                           
+
+40-D8-55                      (hex)                         EMS Computers Pty Ltd                        
+1D6000-1D6FFF                 (base 16)                     EMS Computers Pty Ltd                        
+                                                            Unit 9 / 171 Power St                        
+                                                            Glendenning  NSW  2177                       
+                                                            AU                                           
+
+40-D8-55                      (hex)                         Wheatstone Corporation                       
+1D7000-1D7FFF                 (base 16)                     Wheatstone Corporation                       
+                                                            600 Industrial Drive                         
+                                                            New Bern  NC  28562                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Commercial Wireless Systems International LLC.
+1D9000-1D9FFF                 (base 16)                     Commercial Wireless Systems International LLC.
+                                                            10798 N.W. 53 Street                         
+                                                            Sunrise  Florida  33351                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         Omnik New Energy Co., Ltd                    
+1CF000-1CFFFF                 (base 16)                     Omnik New Energy Co., Ltd                    
+                                                            A4-414 No.218 Xinghu Road bioBAY Park        
+                                                            suzhou  jiangsu  215123                      
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Peter Huber                                  
+1CE000-1CEFFF                 (base 16)                     Peter Huber                                  
+                                                            Kaeltemaschinenbau GmbH                      
+                                                            Offenburg  Ba-Wue  77656                     
+                                                            DE                                           
+
+40-D8-55                      (hex)                         AD QUALITE                                   
+1E1000-1E1FFF                 (base 16)                     AD QUALITE                                   
+                                                            75, allée Louis Blériot                      
+                                                            BOOS  Haute Normandie  76520                 
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Vidisys GmbH                                 
+1DE000-1DEFFF                 (base 16)                     Vidisys GmbH                                 
+                                                            Rudolf-Diesel-Ring 30                        
+                                                            Sauerlach  Bavaria  82054                    
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Prisma Engineering srl                       
+1D4000-1D4FFF                 (base 16)                     Prisma Engineering srl                       
+                                                            Via Petrocchi, 4                             
+                                                            Milano  MI  20127                            
+                                                            IT                                           
+
+40-D8-55                      (hex)                         BETTINI SRL                                  
+1B3000-1B3FFF                 (base 16)                     BETTINI SRL                                  
+                                                            VIA GRIEG 23                                 
+                                                            SARONNO  VARESE  20147                       
+                                                            IT                                           
+
+40-D8-55                      (hex)                         AGE A. Gilg Elektronik                       
+1B2000-1B2FFF                 (base 16)                     AGE A. Gilg Elektronik                       
+                                                            Wellenburger Str. 53                         
+                                                            Augsburg  Bayern  D-86199                    
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Logos 01 S.r.l.                              
+1B1000-1B1FFF                 (base 16)                     Logos 01 S.r.l.                              
+                                                            Via Parini, 8                                
+                                                            Porto Mantovano  MN  46047                   
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Vigitron Inc.                                
+1AF000-1AFFFF                 (base 16)                     Vigitron Inc.                                
+                                                            7620 Miramar Road, Suite 4100                
+                                                            San Diego  California  92126                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         ELAN SYSTEMS                                 
+1AC000-1ACFFF                 (base 16)                     ELAN SYSTEMS                                 
+                                                            10 IHASZ STR                                 
+                                                            BUDAPEST    1105                             
+                                                            HU                                           
+
+40-D8-55                      (hex)                         Rosslare Enterprises Limited                 
+1AB000-1ABFFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+40-D8-55                      (hex)                         Creative Lighting And Sound Systems Pty Ltd  
+1BA000-1BAFFF                 (base 16)                     Creative Lighting And Sound Systems Pty Ltd  
+                                                            4 Pine Street                                
+                                                            North Ipswich  QLD  4305                     
+                                                            AU                                           
+
+40-D8-55                      (hex)                         Shin-ei Electronic Measuring Co.,Ltd.        
+1B0000-1B0FFF                 (base 16)                     Shin-ei Electronic Measuring Co.,Ltd.        
+                                                            2636                                         
+                                                            Fujisawa-shi  Kanagawa  252-0816             
+                                                            JP                                           
+
+40-D8-55                      (hex)                         NPB Automation AB                            
+1C0000-1C0FFF                 (base 16)                     NPB Automation AB                            
+                                                            Industrigatan 14B                            
+                                                            Jönköping  Jönköping  55302              
+                                                            SE                                           
+
+40-D8-55                      (hex)                         Device Solutions Ltd                         
+1C6000-1C6FFF                 (base 16)                     Device Solutions Ltd                         
+                                                            PO Box 131                                   
+                                                            Rolleston  Canterbury  7614                  
+                                                            NZ                                           
+
+40-D8-55                      (hex)                         devboards GmbH                               
+198000-198FFF                 (base 16)                     devboards GmbH                               
+                                                            Birkerstrasse 67                             
+                                                            Lohmar  NRW  33106                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         RB-LINK Wireless                             
+1A6000-1A6FFF                 (base 16)                     RB-LINK Wireless                             
+                                                            Parque Comercial Europa Loja 20              
+                                                            Pombal    3100-371                           
+                                                            PT                                           
+
+40-D8-55                      (hex)                         Soukai Electric                              
+191000-191FFF                 (base 16)                     Soukai Electric                              
+                                                            316-9 kubara                                 
+                                                            Kasuya-gun  Fukuoka  811-2501                
+                                                            JP                                           
+
+40-D8-55                      (hex)                         REDER Domotic GmbH                           
+178000-178FFF                 (base 16)                     REDER Domotic GmbH                           
+                                                            Gutensteinerstrasse 42                       
+                                                            Pottenstein  Austria  2563                   
+                                                            AT                                           
+
+40-D8-55                      (hex)                         BrightLeaf Power                             
+16F000-16FFFF                 (base 16)                     BrightLeaf Power                             
+                                                            121 Apollo Road                              
+                                                            Montrose  Colorado  81401                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         Diagnosys Test Systems Ltd                   
+18B000-18BFFF                 (base 16)                     Diagnosys Test Systems Ltd                   
+                                                            Riverside One                                
+                                                              Dublin  2                                  
+                                                            IE                                           
+
+40-D8-55                      (hex)                         Anhui Jiante Network Technology Co., Ltd.    
+166000-166FFF                 (base 16)                     Anhui Jiante Network Technology Co., Ltd.    
+                                                            513 Room, new Bai Sha business center,NO.9 ,LiuAn Road ,LuYang District, Hefei City ,Anhui Province,China
+                                                            Hefei  Anhui  230000                         
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Solidscape Inc                               
+161000-161FFF                 (base 16)                     Solidscape Inc                               
+                                                            316 Daniel Webster Hwy                       
+                                                            Merrimack  NH  03054                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         CT Company                                   
+15F000-15FFFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st.,35                   
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Prodco International Inc.                    
+15E000-15EFFF                 (base 16)                     Prodco International Inc.                    
+                                                            9408 boul. du Gulf                           
+                                                            Montreal  Quebec  H1J3A1                     
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Secuinfo Co.Ltd                              
+16E000-16EFFF                 (base 16)                     Secuinfo Co.Ltd                              
+                                                            1411, Kranz Techno, 5442-1, Sangdaewon dong  
+                                                            Seongnam  Gyeonggi-do  462-729               
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Weber Marking Systems GmbH                   
+145000-145FFF                 (base 16)                     Weber Marking Systems GmbH                   
+                                                            Taschenmacherstrasse 2                       
+                                                            Lübeck   Schleswig-Holstein  23556           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Pleiger Elektronik GmbH  and Co. KG          
+146000-146FFF                 (base 16)                     Pleiger Elektronik GmbH  and Co. KG          
+                                                            Im Hammertal 51                              
+                                                            Witten  NRW  58456                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         SOMFY SAS                                    
+14D000-14DFFF                 (base 16)                     SOMFY SAS                                    
+                                                            400, avenue de la République                 
+                                                            CLUSES   -  74307                            
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Progress Rail Services, Inspection and Information Systems
+151000-151FFF                 (base 16)                     Progress Rail Services, Inspection and Information Systems
+                                                            3801-1 South Selsa Road                      
+                                                            Independence  Missouri  64057                
+                                                            US                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+14A000-14AFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Venco                                        
+144000-144FFF                 (base 16)                     Venco                                        
+                                                            Carretera del Mig 75                         
+                                                            Hospitalet de Llobregat  Barcelona  08907    
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Debug s.r.l.                                 
+124000-124FFF                 (base 16)                     Debug s.r.l.                                 
+                                                            Via della Meccanica,14                       
+                                                            Vicenza  ITALY  36100                        
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Devriecom B.V.                               
+136000-136FFF                 (base 16)                     Devriecom B.V.                               
+                                                            Oosteinde 219                                
+                                                            Vriezenveen  Ov  7671AX                      
+                                                            NL                                           
+
+40-D8-55                      (hex)                         GSP Sprachtechnologie GmbH                   
+130000-130FFF                 (base 16)                     GSP Sprachtechnologie GmbH                   
+                                                            Teltowkanalstr.1                             
+                                                            Berlin    12247                              
+                                                            DE                                           
+
+40-D8-55                      (hex)                         ZAO NPC  Kompjuternie Technologii            
+123000-123FFF                 (base 16)                     ZAO NPC  Kompjuternie Technologii            
+                                                            Komsomolsky avenue, 90-17                    
+                                                            Perm  Perm Region  614010                    
+                                                            RU                                           
+
+40-D8-55                      (hex)                         KOMPAN Pawel Sokolowski                      
+11F000-11FFFF                 (base 16)                     KOMPAN Pawel Sokolowski                      
+                                                            Radomska 29                                  
+                                                            Starachowice  Swietokrzyskie  27-200         
+                                                            PL                                           
+
+40-D8-55                      (hex)                         shanghai Anjian Information technology co. , ltd.
+121000-121FFF                 (base 16)                     shanghai Anjian Information technology co. , ltd.
+                                                            Room 413，Block B ,                           
+                                                            shanghai  shanghai  200235                   
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Marmitek BV                                  
+0FA000-0FAFFF                 (base 16)                     Marmitek BV                                  
+                                                            Postbus 4257                                 
+                                                            Eindhoven  NB  5604 EG                       
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Invisua Lighting BV                          
+0F9000-0F9FFF                 (base 16)                     Invisua Lighting BV                          
+                                                            Nuenenseweg 167                              
+                                                            Geldrop  NB  5667KP                          
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Testbook Ltd                                 
+113000-113FFF                 (base 16)                     Testbook Ltd                                 
+                                                            7 Midshires Business Park                    
+                                                            Alyesbury  Bucks  HP19 8HL                   
+                                                            GB                                           
+
+40-D8-55                      (hex)                         CAVALRY STORAGE INC                          
+10F000-10FFFF                 (base 16)                     CAVALRY STORAGE INC                          
+                                                            4251 E BRICKELL ST                           
+                                                            ONTARIO  CA  91761                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         Contrans TI sp. z o.o.                       
+10C000-10CFFF                 (base 16)                     Contrans TI sp. z o.o.                       
+                                                            Polanowicka 66                               
+                                                            Wrocław  dolnośląskie  51-180                
+                                                            PL                                           
+
+40-D8-55                      (hex)                         TASK SISTEMAS DE COMPUTACAO S.A.             
+100000-100FFF                 (base 16)                     TASK SISTEMAS DE COMPUTACAO S.A.             
+                                                            RUA VISCONDE DE OURO PRETO                   
+                                                              RIO DE JANEIRO  22621-100                  
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Private                                      
+0F6000-0F6FFF                 (base 16)                     Private                                      
+
+40-D8-55                      (hex)                         Embed Limited                                
+0DD000-0DDFFF                 (base 16)                     Embed Limited                                
+                                                            Sovereign Court One                          
+                                                            Coventry  West Midlands  CV4 7EZ             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Xadi Inc                                     
+0DF000-0DFFFF                 (base 16)                     Xadi Inc                                     
+                                                            100 - 321 McDermot Ave                       
+                                                            Winnipeg  Manitoba  R3A 0A3                  
+                                                            CA                                           
+
+40-D8-55                      (hex)                         LIGHTSTAR                                    
+0E7000-0E7FFF                 (base 16)                     LIGHTSTAR                                    
+                                                            18,CHASEONGDONGRO, 142BEONGIL                
+                                                            BUSAN    619-905                             
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Icraft Oy                                    
+0D0000-0D0FFF                 (base 16)                     Icraft Oy                                    
+                                                            Åkerlundinkatu 3                            
+                                                              Tampere  33100                             
+                                                            FI                                           
+
+40-D8-55                      (hex)                         Clark-MXR, Inc.                              
+0CF000-0CFFFF                 (base 16)                     Clark-MXR, Inc.                              
+                                                            7300 W. Huron River Dr.                      
+                                                            Dexter  MI  48130                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Cantada Inc                                  
+0D1000-0D1FFF                 (base 16)                     Cantada Inc                                  
+                                                            5742 Oakton Court                            
+                                                            Sarasota  Florida  34233                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         ReliOn Inc                                   
+0CB000-0CBFFF                 (base 16)                     ReliOn Inc                                   
+                                                            15913 E Euclid Ave                           
+                                                            Spokane  Wa  99216                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         WooshCom Corporation                         
+0A5000-0A5FFF                 (base 16)                     WooshCom Corporation                         
+                                                            16095 Ridge Tee Dr.                          
+                                                            Morrison  CO  80465-2140                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         iCOGNIZE GmbH                                
+0BD000-0BDFFF                 (base 16)                     iCOGNIZE GmbH                                
+                                                            Justus-von-Liebig Str. 9                     
+                                                            Dietzenbach  Hesse  63128                    
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Manufacturing System Insights Inc            
+0BE000-0BEFFF                 (base 16)                     Manufacturing System Insights Inc            
+                                                            2560 Ninth Street, Suite 123A                
+                                                            Berkeley  CA  94710                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Telvent                                      
+0B6000-0B6FFF                 (base 16)                     Telvent                                      
+                                                            P.I. Alcobendas C/ Valgrande, 6              
+                                                            Alcobendas  Madrid  28108                    
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Whiptail                                     
+0BB000-0BBFFF                 (base 16)                     Whiptail                                     
+                                                            9 Whippany Rd                                
+                                                            Whippany  NJ  07981                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Ferlin Trading BV                            
+0B8000-0B8FFF                 (base 16)                     Ferlin Trading BV                            
+                                                            Galileistraat 29                             
+                                                            Dedemsvaart  Overijssel  7701 SK             
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Fraunhofer HHI                               
+0AC000-0ACFFF                 (base 16)                     Fraunhofer HHI                               
+                                                            Einsteinufer 37                              
+                                                              Berlin  10587                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         Wasserbauer GmbH                             
+092000-092FFF                 (base 16)                     Wasserbauer GmbH                             
+                                                            Gewerbestraße 1                              
+                                                            Waldneukirchen    4595                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         Axxess Identification Ltd                    
+090000-090FFF                 (base 16)                     Axxess Identification Ltd                    
+                                                            27-28 Shrivenham Hundred Business Park       
+                                                            Swindon  Wiltshire  SN6 8TZ                  
+                                                            GB                                           
+
+40-D8-55                      (hex)                         idcell co.ltd                                
+099000-099FFF                 (base 16)                     idcell co.ltd                                
+                                                            565 Iteco, Deokpung 3-dong                   
+                                                            Hanam-si    465-736                          
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Quantronix, Inc.                             
+0A0000-0A0FFF                 (base 16)                     Quantronix, Inc.                             
+                                                            380 S. 200 W.                                
+                                                            Farmington  UT  84025                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Keyware Solutions Inc.                       
+09C000-09CFFF                 (base 16)                     Keyware Solutions Inc.                       
+                                                            5-37-18 Kamikitazawa                         
+                                                            Setagaya-ku  Tokyo  156-8588                 
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Peek Traffic Corporation                     
+085000-085FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Fl  34221                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Wuxi SiNeng New Energy Co., Ltd.             
+07D000-07DFFF                 (base 16)                     Wuxi SiNeng New Energy Co., Ltd.             
+                                                            No.1 Wind power Road, Wind Power Technology Industrial Park
+                                                            Wuxi  Jiangsu Province  214000               
+                                                            CN                                           
+
+40-D8-55                      (hex)                         JSC Electrical Equipment Factory             
+070000-070FFF                 (base 16)                     JSC Electrical Equipment Factory             
+                                                            Otradnaya str, 6                             
+                                                            Moscow    129626                             
+                                                            RU                                           
+
+40-D8-55                      (hex)                         DELOPT                                       
+083000-083FFF                 (base 16)                     DELOPT                                       
+                                                            #3&4, 1st Cross, 7th Main                    
+                                                            Bangalore  Karnataka  560062                 
+                                                            IN                                           
+
+40-D8-55                      (hex)                         Ultra Electronics Flightline Systems         
+05A000-05AFFF                 (base 16)                     Ultra Electronics Flightline Systems         
+                                                            7625 Omnitech Place                          
+                                                            Victor  NY  14564-9795                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         Cominfo, Inc.                                
+061000-061FFF                 (base 16)                     Cominfo, Inc.                                
+                                                            Nabrezi 695                                  
+                                                            Zlin    760 01                               
+                                                            CZ                                           
+
+40-D8-55                      (hex)                         COLONIAL ASSEMBLY and  DESIGN                
+059000-059FFF                 (base 16)                     COLONIAL ASSEMBLY and  DESIGN                
+                                                            3361 SHANNON AIRPORT CIRCLE                  
+                                                            FREDERICKSBURG  VIRGINIA  22408              
+                                                            US                                           
+
+40-D8-55                      (hex)                         Helmholtz Zentrum Dresden Rossendorf e.V.    
+055000-055FFF                 (base 16)                     Helmholtz Zentrum Dresden Rossendorf e.V.    
+                                                            Bautzner Landstrasse 400                     
+                                                            Dresden  Sachsen  01328                      
+                                                            DE                                           
+
+40-D8-55                      (hex)                         GROUP 57                                     
+056000-056FFF                 (base 16)                     GROUP 57                                     
+                                                            Burgemeestersrand 37                         
+                                                            Delft  ZH  2625 NV                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         Protonic Holland                             
+063000-063FFF                 (base 16)                     Protonic Holland                             
+                                                            Factorij 36                                  
+                                                            Zwaag NH  Netherlands  1689 AL               
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Haein S&S Co., Ltd                           
+04F000-04FFFF                 (base 16)                     Haein S&S Co., Ltd                           
+                                                            #1213  12th FL Daeryoung Teco town           
+                                                              Seoul  153-802                             
+                                                            KR                                           
+
+40-D8-55                      (hex)                         DAN ELECTRONICS SYSTEM (P) LIMITED           
+052000-052FFF                 (base 16)                     DAN ELECTRONICS SYSTEM (P) LIMITED           
+                                                            546A, SECTOR - 37                            
+                                                            GURGAON  HARYANA  122001                     
+                                                            IN                                           
+
+40-D8-55                      (hex)                         Dacom West GmbH                              
+034000-034FFF                 (base 16)                     Dacom West GmbH                              
+                                                            Schallbruch 19-21                            
+                                                            Haan  NRW  42781                             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Thermo Fisher Scientific                     
+049000-049FFF                 (base 16)                     Thermo Fisher Scientific                     
+                                                            1410 Gillingham Lane                         
+                                                            Sugar Land  Texas  77478                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         Genadsystem                                  
+045000-045FFF                 (base 16)                     Genadsystem                                  
+                                                            #522 Innoplex Bldg. 1-613, Wonchen-dong      
+                                                            Suwon  Gyeonggi-do  443-380                  
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Symetrics Industries                         
+026000-026FFF                 (base 16)                     Symetrics Industries                         
+                                                            1615 West Nasa Blvd                          
+                                                            West Melbourne  Fl  32901                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         CI Systems Ltd                               
+039000-039FFF                 (base 16)                     CI Systems Ltd                               
+                                                            HaMehkar 6 Str.                              
+                                                            Migdal HaEmek  IL  10551                     
+                                                            IL                                           
+
+40-D8-55                      (hex)                         Dommel GmbH                                  
+031000-031FFF                 (base 16)                     Dommel GmbH                                  
+                                                            Westring 15                                  
+                                                            Wassertruedingen  bavaria  91717             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         MACHINEPERFORMANCE ApS                       
+04D000-04DFFF                 (base 16)                     MACHINEPERFORMANCE ApS                       
+                                                            Firskovej 23,1                               
+                                                            Kgs. Lyngby  Denmark  DK-2800                
+                                                            DK                                           
+
+40-D8-55                      (hex)                         Hangzhou Chenxiao Technologies Co. Ltd.      
+002000-002FFF                 (base 16)                     Hangzhou Chenxiao Technologies Co. Ltd.      
+                                                            7th Floor,No51,Huanxing Road,Bingjiang       
+                                                            Hangzhou  Zhejiang  310052                   
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Digital Audio SA                             
+007000-007FFF                 (base 16)                     Digital Audio SA                             
+                                                            3, chemin du Pre-Fleuri                      
+                                                            PLAN-LES-OUATES  GENEVA  1228                
+                                                            CH                                           
+
+40-D8-55                      (hex)                         CR Magnetics, Inc.                           
+004000-004FFF                 (base 16)                     CR Magnetics, Inc.                           
+                                                            3500 Scarlet Oak Blvd                        
+                                                            Saint Louis  Missouri  63122                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         DIGITAL DYNAMICS, INC.                       
+00F000-00FFFF                 (base 16)                     DIGITAL DYNAMICS, INC.                       
+                                                            5 VICTOR SQUARE                              
+                                                            SCOTTS VALLEY  CA.  95066                    
+                                                            US                                           
+
+40-D8-55                      (hex)                         STANEO SAS                                   
+018000-018FFF                 (base 16)                     STANEO SAS                                   
+                                                            90 rue des trente-six ponts                  
+                                                            Toulouse    31400                            
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Audio Enhancement                            
+01B000-01BFFF                 (base 16)                     Audio Enhancement                            
+                                                            14241 S. Redwood Road                        
+                                                            Bluffdale  UT  84065                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         SMT D.O.O.                                   
+021000-021FFF                 (base 16)                     SMT D.O.O.                                   
+                                                            LIMINJANSKA 96                               
+                                                            PORTORO  PORTORO  6320                       
+                                                            SI                                           
+
+40-D8-55                      (hex)                         Kaori Industria Eletronica Ltda              
+008000-008FFF                 (base 16)                     Kaori Industria Eletronica Ltda              
+                                                            1021, Dr. Reynaldo Machado                   
+                                                            Curitiba  Parana  80215010                   
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Flexim Security Oy                           
+011000-011FFF                 (base 16)                     Flexim Security Oy                           
+                                                            P.O.Box 700                                  
+                                                            Helsinki  Southern Finland  00381            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         CONTROL SYSTEMS Srl                          
+FF3000-FF3FFF                 (base 16)                     CONTROL SYSTEMS Srl                          
+                                                            Via del Brolo, 14                            
+                                                            Cremona  CR  26100                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+FF0000-FF0FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Task Sistemas de Computacao                  
+FEF000-FEFFFF                 (base 16)                     Task Sistemas de Computacao                  
+                                                            Rua Visconde de Ouro Preto, 5                
+                                                            Rio de Janeiro  RJ  22250-180                
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Mango DSP, Inc.                              
+FE8000-FE8FFF                 (base 16)                     Mango DSP, Inc.                              
+                                                            83 East Ave.                                 
+                                                            Norwalk  CT  06877                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Exibea AB                                    
+FE6000-FE6FFF                 (base 16)                     Exibea AB                                    
+                                                            Ekmansgatan 3                                
+                                                            Gothenburg  Sweden  411 32                   
+                                                            SE                                           
+
+00-50-C2                      (hex)                         SEFRAM                                       
+FFB000-FFBFFF                 (base 16)                     SEFRAM                                       
+                                                            32 rue E MARTEL                              
+                                                            SAINT-ETIENNE  FRANCE  42009                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Autonomic Controls. Inc                      
+FD2000-FD2FFF                 (base 16)                     Autonomic Controls. Inc                      
+                                                            28 Kaysal Court                              
+                                                            Armonk  NY  10504                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Simple Solutions                             
+FD0000-FD0FFF                 (base 16)                     Simple Solutions                             
+                                                            Alleenstr. 18                                
+                                                            Kirchheim unter Teck  Baden-Württemberg  73230
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Hijet Print d.o.o.                           
+FA9000-FA9FFF                 (base 16)                     Hijet Print d.o.o.                           
+                                                            Majstorska 3                                 
+                                                            Zagreb  Croatia  10000                       
+                                                            HR                                           
+
+00-50-C2                      (hex)                         Yash SiQure Technologies India Pvt. Ltd.     
+FA8000-FA8FFF                 (base 16)                     Yash SiQure Technologies India Pvt. Ltd.     
+                                                            C 262, Sector - 63,                          
+                                                            Noida,  UP  201307                           
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Assembly Contracts Limited                   
+FB5000-FB5FFF                 (base 16)                     Assembly Contracts Limited                   
+                                                            Ledson Road                                  
+                                                            Manchester  Lancashire  M23 9GP              
+                                                            US                                           
+
+00-50-C2                      (hex)                         TECHNO CO.,LTD.                              
+FB8000-FB8FFF                 (base 16)                     TECHNO CO.,LTD.                              
+                                                            1304-5                                       
+                                                            Iruma City  Saitama Pref.  358-0011          
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Digital Barriers                             
+F94000-F94FFF                 (base 16)                     Digital Barriers                             
+                                                            Photon House                                 
+                                                            Leeds  West Yorkshire  LS121EG               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SYS TEC electronic GmbH                      
+F80000-F80FFF                 (base 16)                     SYS TEC electronic GmbH                      
+                                                            Am Windrad 2                                 
+                                                            Heinsdorfergrund     D-08468                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Amplus Communication Pte Ltd                 
+FA0000-FA0FFF                 (base 16)                     Amplus Communication Pte Ltd                 
+                                                            19A Serangoon North Ave 5                    
+                                                              Singapore  554859                          
+                                                            SG                                           
+
+00-50-C2                      (hex)                         RTC Manufacturing Inc.                       
+F88000-F88FFF                 (base 16)                     RTC Manufacturing Inc.                       
+                                                            1016 Enterprise Place                        
+                                                            Arlington  TX  76001                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         GWT LLC                                      
+F66000-F66FFF                 (base 16)                     GWT LLC                                      
+                                                            101 Gibraltar Drive                          
+                                                            Morris Plains   NJ   07950                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         PumpWell Solutions Ltd.                      
+F75000-F75FFF                 (base 16)                     PumpWell Solutions Ltd.                      
+                                                            10, 2150-29th St. NE                         
+                                                            Calgary  AB  T1Y 7G4                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Pro Design Electronic GmbH                   
+F6C000-F6CFFF                 (base 16)                     Pro Design Electronic GmbH                   
+                                                            Albert-Mayer-Str. 14-16                      
+                                                            Bruckmuehl  Bavaria  83052                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         C3 LLC                                       
+F7A000-F7AFFF                 (base 16)                     C3 LLC                                       
+                                                            1305 N Savannah Terrace                      
+                                                            Mustang  OK  73064                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Hella Gutmann Solutions GmbH                 
+F54000-F54FFF                 (base 16)                     Hella Gutmann Solutions GmbH                 
+                                                            Am Krebsbach 2                               
+                                                            Ihringen    79241                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         BORYEU TECHNOLOGY CO.,LTD                    
+F5F000-F5FFFF                 (base 16)                     BORYEU TECHNOLOGY CO.,LTD                    
+                                                            2F.,No756,Zhongzheng Road                    
+                                                            Zhonghe City  Taipei Hsien23586  23586       
+                                                            US                                           
+
+00-50-C2                      (hex)                         KNOWHOW INFOCOM INC.                         
+F4D000-F4DFFF                 (base 16)                     KNOWHOW INFOCOM INC.                         
+                                                            32-1, YOUNGMUN-DONG,                         
+                                                            SEOUL                                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         DENSEI COMMUNICATION Inc.                    
+F3F000-F3FFFF                 (base 16)                     DENSEI COMMUNICATION Inc.                    
+                                                            8-13,Koei-cho                                
+                                                            Ebetsu-shi  Hokkaido  067-0051               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         cadac,inc.                                   
+F47000-F47FFF                 (base 16)                     cadac,inc.                                   
+                                                            Ho10-3,Ouramachi                             
+                                                            Kanazawa-shi  Ishikawa  920-0205             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         BAP Precision Ltd.                           
+F4F000-F4FFFF                 (base 16)                     BAP Precision Ltd.                           
+                                                            1F., No.5, Ln. 147, Chengzhang 1st St.       
+                                                            Zhongli City  Taoyuan County  320            
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Miris AB                                     
+F30000-F30FFF                 (base 16)                     Miris AB                                     
+                                                            Kungsgatan 115                               
+                                                              UPPSALA  75318                             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Arcos Technologies LTD                       
+F2F000-F2FFFF                 (base 16)                     Arcos Technologies LTD                       
+                                                            26 Hasivim                                   
+                                                            Petach Tikva    49517                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Vertex Antennentechnik GmbH                  
+F28000-F28FFF                 (base 16)                     Vertex Antennentechnik GmbH                  
+                                                            Baumstrasse 50                               
+                                                            Duisburg  NRW  47198                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Harland Simon plc                            
+F22000-F22FFF                 (base 16)                     Harland Simon plc                            
+                                                            Bond Avenue                                  
+                                                            Milton Keynes  Bucks  MK1 1TJ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Organis GmbH                                 
+F11000-F11FFF                 (base 16)                     Organis GmbH                                 
+                                                            Schulstrasse 76                              
+                                                            Landquart    7302                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Peter Huber Kältemaschinenbau GmbH           
+F16000-F16FFF                 (base 16)                     Peter Huber Kältemaschinenbau GmbH           
+                                                            Werner-von-Siemens-Str. 1                    
+                                                            Offenburg  Baden-Württemberg  77656          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PLR Information Systems Ltd.                 
+EFE000-EFEFFF                 (base 16)                     PLR Information Systems Ltd.                 
+                                                            POB 8130, Poleg Industrial Zone              
+                                                            Netanya    42160                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Private                                      
+EFC000-EFCFFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+F1C000-F1CFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Norbit ODM AS                                
+EFB000-EFBFFF                 (base 16)                     Norbit ODM AS                                
+                                                            Stiklestadveien 1                            
+                                                            Trondheim    7041                            
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Tecnint HTE SRL                              
+EE3000-EE3FFF                 (base 16)                     Tecnint HTE SRL                              
+                                                            Via della Tecnica 16/18                      
+                                                            Osnago  Lecco  23875                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         IDTRONIC GmbH                                
+EEF000-EEFFFF                 (base 16)                     IDTRONIC GmbH                                
+                                                            Donnersbergweg 1                             
+                                                            Ludwigshafen  NonUS  D67059                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+EF1000-EF1FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Future Design Controls, Inc                  
+EED000-EEDFFF                 (base 16)                     Future Design Controls, Inc                  
+                                                            7524 W 98th Place                            
+                                                            Bridgeview  IL  60455                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         EBNEURO SPA                                  
+EDD000-EDDFFF                 (base 16)                     EBNEURO SPA                                  
+                                                            VIA PIETRO FANFANI 97a                       
+                                                            FIRENZE    50127                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Specialty Microwave Corp                     
+EF2000-EF2FFF                 (base 16)                     Specialty Microwave Corp                     
+                                                            120 Raynor Ave                               
+                                                            Ronkonkoma  New York  11779                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Procon Electronics                           
+EE1000-EE1FFF                 (base 16)                     Procon Electronics                           
+                                                            PO Box 164                                   
+                                                            Sydney  NSW  1730                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Wishtek Technology, Inc.                     
+EB4000-EB4FFF                 (base 16)                     Wishtek Technology, Inc.                     
+                                                            10F., No. 178-1, Syuecin Rd., Sansia Dist.,  
+                                                            New Taipei    23741                          
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Logical Electromechanical Sys Inc.           
+EC4000-EC4FFF                 (base 16)                     Logical Electromechanical Sys Inc.           
+                                                            885 Freemanwood Lane                         
+                                                            Alpharetta  GA  30004                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ixonos Plc                                   
+EC2000-EC2FFF                 (base 16)                     Ixonos Plc                                   
+                                                            Hermiankatu 6-8H                             
+                                                            Tampere    FI-33721                          
+                                                            FI                                           
+
+00-50-C2                      (hex)                         IBERNEX INGENIERIA, S.L.                     
+EC8000-EC8FFF                 (base 16)                     IBERNEX INGENIERIA, S.L.                     
+                                                            Carretera de Cogullada, 11                   
+                                                            ZARAGOZA  Zaragoza  50001                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Alias ip                                     
+EAC000-EACFFF                 (base 16)                     Alias ip                                     
+                                                            300 ROUTE DES CRETES                         
+                                                            SOPHIA ANTIPOLIS  ALPES-MARITIMES  06560     
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Dlite Comercio, Importadora e Serviços de Automação Ltda
+E95000-E95FFF                 (base 16)                     Dlite Comercio, Importadora e Serviços de Automação Ltda
+                                                            423, Rocio Street cj1811                     
+                                                              São Paulo  04552 000                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Aerodata AG                                  
+EA5000-EA5FFF                 (base 16)                     Aerodata AG                                  
+                                                            Hermann-Blenk-Strasse 36                     
+                                                            Braunschweig  Niedersachsen  38108           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LS Control A/S                               
+E7F000-E7FFFF                 (base 16)                     LS Control A/S                               
+                                                            Indrustivej  12                              
+                                                            Gelsted  Herlufmagle  DK-4160                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+E80000-E80FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Macronet s.r.l.                              
+E8A000-E8AFFF                 (base 16)                     Macronet s.r.l.                              
+                                                            Alsina 2965                                  
+                                                            Buenos Aires    1207                         
+                                                            AR                                           
+
+00-50-C2                      (hex)                         PROTEQSEN                                    
+E89000-E89FFF                 (base 16)                     PROTEQSEN                                    
+                                                            Av. Gov. Amaral Peixoto, 800                 
+                                                            Nova Iguacu  Rio de Janeiro  26210-060       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Multisuns Corporation                        
+E86000-E86FFF                 (base 16)                     Multisuns Corporation                        
+                                                            12F, No. 19-3, San Chung Road,               
+                                                            Taipei    115                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Lamson Safes & Security                      
+E87000-E87FFF                 (base 16)                     Lamson Safes & Security                      
+                                                            3-5 Awun Court                               
+                                                            Springvale    Victoria                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         TASK SISTEMAS DE COMPUTACAO LTDA             
+E78000-E78FFF                 (base 16)                     TASK SISTEMAS DE COMPUTACAO LTDA             
+                                                            Rua 2 / 112 Jardim Itatiaia                  
+                                                            Itatiaia  Rio de Janeiro  27580-000          
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Will corp.                                   
+E74000-E74FFF                 (base 16)                     Will corp.                                   
+                                                            3-1-47                                       
+                                                            Yamato city  Kanagawa pref.  242-0018        
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Adaptive Technologies, Inc.                  
+E81000-E81FFF                 (base 16)                     Adaptive Technologies, Inc.                  
+                                                            2020 Kraft Drive                             
+                                                            Blacksburg  VA  24060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xplore Technologies Corp                     
+E82000-E82FFF                 (base 16)                     Xplore Technologies Corp                     
+                                                            14000 Sumit Dr                               
+                                                            Austin  TX  78728                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         GHL Systems Bhd                              
+E4A000-E4AFFF                 (base 16)                     GHL Systems Bhd                              
+                                                            L5-E-7B, Enterprise 4                        
+                                                            Bukit Jalil   Kuala Lumpur   57000           
+                                                            MY                                           
+
+00-50-C2                      (hex)                         CTF TECHNOLOGIES DO BRASIL LTDA              
+E49000-E49FFF                 (base 16)                     CTF TECHNOLOGIES DO BRASIL LTDA              
+                                                            AV. IMPERATRIZ LEOPOLDINA, 1661              
+                                                            São Paulo    05305-007                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Pantec Engineering AG                        
+E5F000-E5FFFF                 (base 16)                     Pantec Engineering AG                        
+                                                            Inustriering 21                              
+                                                            Ruggell  Principality of Liechtenstein  9491 
+                                                            LI                                           
+
+00-50-C2                      (hex)                         CAIPO Automazione Industriale s.r.l.         
+E5B000-E5BFFF                 (base 16)                     CAIPO Automazione Industriale s.r.l.         
+                                                            Fraz. Violetto, 39                           
+                                                            Valle Mosso  Biella  13825                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SAE IT-systems GmbH & Co. KG                 
+E62000-E62FFF                 (base 16)                     SAE IT-systems GmbH & Co. KG                 
+                                                            Im Gewerbegebiet Pesch 14                    
+                                                            Köln  NRW  50767                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Agri-hitech LLC                              
+E58000-E58FFF                 (base 16)                     Agri-hitech LLC                              
+                                                            599-20                                       
+                                                            Kawagoe  Saitama  3501101                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+E59000-E59FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         EN ElectronicNetwork Hamburg GmbH            
+E2C000-E2CFFF                 (base 16)                     EN ElectronicNetwork Hamburg GmbH            
+                                                            Meiendorfer Strasse 205                      
+                                                            Hamburg    22145                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FUJI DATA SYSTEM Co., Ltd                    
+E37000-E37FFF                 (base 16)                     FUJI DATA SYSTEM Co., Ltd                    
+                                                            5-21-14                                      
+                                                            AMAGASAKI-Shi  HYOGO Pref.  660-0892         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Beam Ltd                                     
+E2F000-E2FFFF                 (base 16)                     Beam Ltd                                     
+                                                            Northavon Buisness Centre                    
+                                                            Yate  South Gloucestershire  BS37 5NH        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Morita Technical Center Company              
+E33000-E33FFF                 (base 16)                     Morita Technical Center Company              
+                                                            3-8-1, Kurigidai, Asao-ku, Kawasaki-shi,     
+                                                            Kanagawa    215-0032                         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+E1C000-E1CFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Jetstream Ltd.                               
+E16000-E16FFF                 (base 16)                     Jetstream Ltd.                               
+                                                            97 Granby Street                             
+                                                                                                         
+                                                            VC                                           
+
+00-50-C2                      (hex)                         Seartech                                     
+E0B000-E0BFFF                 (base 16)                     Seartech                                     
+                                                            C2 Newlands Plaza                            
+                                                            Newlands  Gauteng  0049                      
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Cleverscope                                  
+E02000-E02FFF                 (base 16)                     Cleverscope                                  
+                                                            28 Ranfurly Rd                               
+                                                            Auckland  NI  1023                           
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         YOUHO ELECTRIC IND.,LTD.                     
+E0C000-E0CFFF                 (base 16)                     YOUHO ELECTRIC IND.,LTD.                     
+                                                            800-8,DEOKDO-RI,GWANGJEOK-MYEON,             
+                                                            YANGJOO-SI  GYEONGGI-DO  482-843             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         RadioMobile Inc                              
+E11000-E11FFF                 (base 16)                     RadioMobile Inc                              
+                                                            8801 Kenamar Drive                           
+                                                            San Diego  CA  92121                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kago Electronics BV                          
+E12000-E12FFF                 (base 16)                     Kago Electronics BV                          
+                                                            Molenlei 2-A                                 
+                                                            Akersloot  Noord Holland  1921 CZ            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         KST Technology                               
+E08000-E08FFF                 (base 16)                     KST Technology                               
+                                                            KST B/D 164-1,Bangi-dong,Songpa-gu,          
+                                                            Seoul    138-050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Combilent                                    
+DF7000-DF7FFF                 (base 16)                     Combilent                                    
+                                                            Gydevang 21D                                 
+                                                            Alleroed    3450                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         TANTAL ELECTRONICA, SL                       
+DFF000-DFFFFF                 (base 16)                     TANTAL ELECTRONICA, SL                       
+                                                            Major, 306                                   
+                                                            SALT  GIRONA  17190                          
+                                                            ES                                           
+
+00-50-C2                      (hex)                         INSEVIS GmbH                                 
+DF3000-DF3FFF                 (base 16)                     INSEVIS GmbH                                 
+                                                            Am Weichselgarten 7                          
+                                                            Erlangen    D-91058                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Neets                                        
+DE5000-DE5FFF                 (base 16)                     Neets                                        
+                                                            Langballe 4                                  
+                                                            Horsens    8700                              
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Dacom West GmbH                              
+DE9000-DE9FFF                 (base 16)                     Dacom West GmbH                              
+                                                            Schallbruch 19-21                            
+                                                            Haan  NRW  42781                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         rbz robot design s.l.                        
+DDA000-DDAFFF                 (base 16)                     rbz robot design s.l.                        
+                                                            avda via lactea 4, local 1                   
+                                                            san fernando de henares  madrid  28830       
+                                                            ES                                           
+
+00-50-C2                      (hex)                         EGS Technologies Ltd                         
+DE4000-DE4FFF                 (base 16)                     EGS Technologies Ltd                         
+                                                            6 Waterside Business Park                    
+                                                            Rugeley  Staffordshire  WS15 1LJ             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ZED Ziegler Electronic Devices GmbH          
+DC3000-DC3FFF                 (base 16)                     ZED Ziegler Electronic Devices GmbH          
+                                                            In den Folgen 7                              
+                                                            Langewiesen    98704                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AGT Holdings Limited                         
+DC7000-DC7FFF                 (base 16)                     AGT Holdings Limited                         
+                                                            Shangling Industrial Area, Hengli Town       
+                                                            Dongguan    523467                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Device GmbH                                  
+DDF000-DDFFFF                 (base 16)                     Device GmbH                                  
+                                                            Thieshoper Strasse 16                        
+                                                            Brackel    21438                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tornado Modular Systems                      
+DD7000-DD7FFF                 (base 16)                     Tornado Modular Systems                      
+                                                            Inzhenernaya str. 4a                         
+                                                            Novosibirsk    630090                        
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Brankamp GmbH                                
+DD1000-DD1FFF                 (base 16)                     Brankamp GmbH                                
+                                                            Max.-Plank Str. 9-13                         
+                                                            Erkrath  NRW  40699                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+DB9000-DB9FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nantes Systems Private Limited               
+DBC000-DBCFFF                 (base 16)                     Nantes Systems Private Limited               
+                                                            B-822 SOBHAWINDFALL                          
+                                                            BANGALORE  KARNATAKA  560092                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ERS electronic GmbH                          
+D97000-D97FFF                 (base 16)                     ERS electronic GmbH                          
+                                                            Stettiner Str. 3                             
+                                                            Germering  Bavaraia  82110                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         VITEC                                        
+D85000-D85FFF                 (base 16)                     VITEC                                        
+                                                            99, rue Pierre Semard                        
+                                                            CHATILLON    92320                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Pro-Digital Industria Eletronica             
+D6D000-D6DFFF                 (base 16)                     Pro-Digital Industria Eletronica             
+                                                            Rua Senador Saraiva, 200                     
+                                                            Curitiba  Parana  80510300                   
+                                                            BR                                           
+
+00-50-C2                      (hex)                         A&T Corporation, Electrics Group , LAS R&D Unit, 
+D6A000-D6AFFF                 (base 16)                     A&T Corporation, Electrics Group , LAS R&D Unit, 
+                                                            2023-1 Endo                                  
+                                                            Fujisawa-shi  Kanagawa-Pref.  252-0816       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         TX Technology Corp                           
+D65000-D65FFF                 (base 16)                     TX Technology Corp                           
+                                                            7 Emery Ave                                  
+                                                            Randolph  New Jersey  07869                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         system2 GmbH                                 
+D61000-D61FFF                 (base 16)                     system2 GmbH                                 
+                                                            Gewerbering 8                                
+                                                            Dorfen  Bavaria  84405                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+D81000-D81FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Solbrig Electronics, Inc.                    
+D50000-D50FFF                 (base 16)                     Solbrig Electronics, Inc.                    
+                                                            1201 Clubhouse Dr.                           
+                                                            Broomfield  CO  80020                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+D4E000-D4EFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ATH system                                   
+D4A000-D4AFFF                 (base 16)                     ATH system                                   
+                                                            Osady Lezaku 498                             
+                                                            Chrast    53851                              
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         GHL Systems Bhd                              
+D69000-D69FFF                 (base 16)                     GHL Systems Bhd                              
+                                                            L5-E-7B, Enterprise 4                        
+                                                            Bukit Jalil  Kuala Lumpur  57000             
+                                                            MY                                           
+
+00-50-C2                      (hex)                         LJT & Associates, Inc.                       
+D37000-D37FFF                 (base 16)                     LJT & Associates, Inc.                       
+                                                            9881 Brokenland Pkwy, Suite 400              
+                                                            Columbia  MD  21046                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Maddalena S.p.A                              
+D33000-D33FFF                 (base 16)                     Maddalena S.p.A                              
+                                                            via G.B. Maddalena 2/4                       
+                                                            Povoletto  UD  33040                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Enatel Limited                               
+D36000-D36FFF                 (base 16)                     Enatel Limited                               
+                                                            66 Treffers Road                             
+                                                            Christchurch  Canterbury  8042               
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         RealTime Systems Ltd                         
+D32000-D32FFF                 (base 16)                     RealTime Systems Ltd                         
+                                                            A-49 Okhla Ind Area                          
+                                                            New Delhi  Delhi  110020                     
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ACTIV Financial Systems, Inc.                
+D30000-D30FFF                 (base 16)                     ACTIV Financial Systems, Inc.                
+                                                            120 East Liberty Drive                       
+                                                            Wheaton  IL  60187                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Key Systems, Inc.                            
+D2F000-D2FFFF                 (base 16)                     Key Systems, Inc.                            
+                                                            PO Box G                                     
+                                                            Fishers  New York  14453                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         VAF Instruments BV                           
+D25000-D25FFF                 (base 16)                     VAF Instruments BV                           
+                                                            PO Box 40                                    
+                                                            Dordrecht    3300 AA                         
+                                                            NL                                           
+
+00-50-C2                      (hex)                         eMDee Technology, Inc.                       
+D22000-D22FFF                 (base 16)                     eMDee Technology, Inc.                       
+                                                            4450 Pet Lane                                
+                                                            Lutz  FL  33559                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         RS Gesellschaft fur Informationstechnik mbH & Co KG
+D2E000-D2EFFF                 (base 16)                     RS Gesellschaft fur Informationstechnik mbH & Co KG
+                                                            Bergische Fachbuchhandlung                   
+                                                            Remscheid  NRW  42853                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         WellSense Technologies                       
+D3A000-D3AFFF                 (base 16)                     WellSense Technologies                       
+                                                            Communication Center                         
+                                                            Neve Ilan    90850                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         demmel products                              
+D40000-D40FFF                 (base 16)                     demmel products                              
+                                                            Radnitzkygasse 43                            
+                                                            Vienna    1100                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         ASSYSTEM France                              
+D3C000-D3CFFF                 (base 16)                     ASSYSTEM France                              
+                                                            13 rue Marie Louise Dissard                  
+                                                            TOULOUSE    31024                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Glyn GmbH & Co.KG                            
+D18000-D18FFF                 (base 16)                     Glyn GmbH & Co.KG                            
+                                                            Am Wörtzgarten 8                             
+                                                            Idstein  Hessen  65510                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CUE, a.s.                                    
+D17000-D17FFF                 (base 16)                     CUE, a.s.                                    
+                                                            K Nouzovu 2090/6                             
+                                                              Praha  143 00                              
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         GUNMA ELECTRONICS CO LTD                     
+D13000-D13FFF                 (base 16)                     GUNMA ELECTRONICS CO LTD                     
+                                                            760 OOMAMA                                   
+                                                            MIDORI-CITY  GUNMA  376-0101                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         JVL Industri Elektronik                      
+D0C000-D0CFFF                 (base 16)                     JVL Industri Elektronik                      
+                                                            Blokken 42                                   
+                                                            Birkeroed  Sjaelland  DK-3460                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         DECA Card Engineering GmbH                   
+D0D000-D0DFFF                 (base 16)                     DECA Card Engineering GmbH                   
+                                                            Bahnstrasse 29-31                            
+                                                            Ratingen  NW  40878                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GILLAM-FEI S.A.                              
+D1A000-D1AFFF                 (base 16)                     GILLAM-FEI S.A.                              
+                                                            Mont St Martin 58                            
+                                                            LIEGE    B4000                               
+                                                            BE                                           
+
+00-50-C2                      (hex)                         IAF GmbH                                     
+D07000-D07FFF                 (base 16)                     IAF GmbH                                     
+                                                            Berliner Str. 52j                            
+                                                            Braunschweig    38104                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tehama Wireless                              
+D04000-D04FFF                 (base 16)                     Tehama Wireless                              
+                                                            423 Tehama Street                            
+                                                            San Francisco  CA  94103                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         SIM2 Multimedia S.p.A.                       
+CD2000-CD2FFF                 (base 16)                     SIM2 Multimedia S.p.A.                       
+                                                            Viale Lino Zanussi 11                        
+                                                            PORDENONE    33170                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         FUJI DATA SYSTEM Co.,Ltd.                    
+CCD000-CCDFFF                 (base 16)                     FUJI DATA SYSTEM Co.,Ltd.                    
+                                                            5-21-14                                      
+                                                            AMAGASAKI-Shi  HYOGO-Prf.  660-0892          
+                                                            JP                                           
+
+00-50-C2                      (hex)                         TASK SISTEMAS DE COMPUTACAO LTDA             
+CCF000-CCFFFF                 (base 16)                     TASK SISTEMAS DE COMPUTACAO LTDA             
+                                                            Rua 2 / 112 Jardim Itatiaia                  
+                                                            Itatiaia  Rio de Janeiro  27580-000          
+                                                            BR                                           
+
+00-50-C2                      (hex)                         MME Mueller Mikroelektronik                  
+CD0000-CD0FFF                 (base 16)                     MME Mueller Mikroelektronik                  
+                                                            Hauptstr. 8                                  
+                                                            Berlin    10827                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IT-IS International Ltd.                     
+CD8000-CD8FFF                 (base 16)                     IT-IS International Ltd.                     
+                                                            1 Wainstones Court                           
+                                                            Stokesley  North Yorkshire  TS95JY           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         NDC Infrared Engineering, Inc.               
+CD9000-CD9FFF                 (base 16)                     NDC Infrared Engineering, Inc.               
+                                                            5314 N. Irwindale Avenue                     
+                                                            Irwindale  CA  91706                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Toyon Research Corporation                   
+CEB000-CEBFFF                 (base 16)                     Toyon Research Corporation                   
+                                                            6800 Cortona Drive                           
+                                                            Goleta  CA  93117                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+CEA000-CEAFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+CD7000-CD7FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         beks Kommunikacios Technika kft              
+CF8000-CF8FFF                 (base 16)                     beks Kommunikacios Technika kft              
+                                                            Rakoczi utca 21                              
+                                                            Debrecen    4024                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Satellink Inc.                               
+CE1000-CE1FFF                 (base 16)                     Satellink Inc.                               
+                                                            3525 Miller Park Dr.                         
+                                                            Garland  TX  75042                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+CC8000-CC8FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Tecnovum AG                                  
+CC5000-CC5FFF                 (base 16)                     Tecnovum AG                                  
+                                                            Nobelring 26                                 
+                                                            Frankfurt Main  Hessen  60598                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         viscount systems inc.                        
+CC3000-CC3FFF                 (base 16)                     viscount systems inc.                        
+                                                            4585 tillicum street                         
+                                                            burnaby  bc  v5j5k9                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Coptonix GmbH                                
+CBB000-CBBFFF                 (base 16)                     Coptonix GmbH                                
+                                                            Luxemburger Str. 31                          
+                                                            Berlin    13353                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Hi Tech Electronics Ltd                      
+CBD000-CBDFFF                 (base 16)                     Hi Tech Electronics Ltd                      
+                                                            93 Osvobozdenie Blvd.                        
+                                                            Plovdiv    4023                              
+                                                            BG                                           
+
+00-50-C2                      (hex)                         Micro Technic A/S                            
+CB9000-CB9FFF                 (base 16)                     Micro Technic A/S                            
+                                                            Smedevaenget 5                               
+                                                            Aarup    5560                                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Level 3 Communications                       
+CC1000-CC1FFF                 (base 16)                     Level 3 Communications                       
+                                                            1025 Eldorado Blvd                           
+                                                            Broomfield  Colorado  80021                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         CaptiveAire Systems Inc.                     
+CCB000-CCBFFF                 (base 16)                     CaptiveAire Systems Inc.                     
+                                                            4641 Paragon Park                            
+                                                            Raleigh  NC  27616                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Campbell Scientific Canada Corp.             
+CAE000-CAEFFF                 (base 16)                     Campbell Scientific Canada Corp.             
+                                                            11564 149 Street                             
+                                                            Edmonton  Alberta  T5M 1W7                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Vidisys GmbH                                 
+CA6000-CA6FFF                 (base 16)                     Vidisys GmbH                                 
+                                                            Rudolf-Diesel-Ring 30                        
+                                                            Sauerlach  Bavaria  82054                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Thermo Fisher Scientific                     
+CA7000-CA7FFF                 (base 16)                     Thermo Fisher Scientific                     
+                                                            1410 Gillingham Lane                         
+                                                            Sugar Land  Texas  77478                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         CyberCraft                                   
+C96000-C96FFF                 (base 16)                     CyberCraft                                   
+                                                            20-33 mathuyacho                             
+                                                            Neyagawa-Chi  Osaka-fu  572-0086             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Criticare Systems, Inc                       
+C98000-C98FFF                 (base 16)                     Criticare Systems, Inc                       
+                                                            20925 Crossroads Circle, Suite 100           
+                                                            Waukesha  WI  53186-4054                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+CA3000-CA3FFF                 (base 16)                     CT Company                                   
+                                                            Godovikova 9, Moscow                         
+                                                            Moscow  RUSSIA  129085                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Radius Sweden AB                             
+C9D000-C9DFFF                 (base 16)                     Radius Sweden AB                             
+                                                            Tennvagen 1                                  
+                                                            Karlskrona  Blekinge  37150                  
+                                                            SE                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+C92000-C92FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SiGarden Sp z o.o.                           
+C6B000-C6BFFF                 (base 16)                     SiGarden Sp z o.o.                           
+                                                            ul. Trzy Lipy 3                              
+                                                            Gdańsk  woj. Pomorskie  80-034               
+                                                            PL                                           
+
+00-50-C2                      (hex)                         TBS Holding AG                               
+C6E000-C6EFFF                 (base 16)                     TBS Holding AG                               
+                                                            Rietbrunnen 2                                
+                                                            Pfaeffikon  SZ  8808                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         REBO CO.,LTD.                                
+C69000-C69FFF                 (base 16)                     REBO CO.,LTD.                                
+                                                            310 AceMill #1146 JangRim-Dong               
+                                                            BUSAN    604-842                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Zeus Systems Private Limited                 
+C62000-C62FFF                 (base 16)                     Zeus Systems Private Limited                 
+                                                            B1 201 Center Point                          
+                                                            Mumbai  Maharashtra  400013                  
+                                                            IN                                           
+
+00-50-C2                      (hex)                         SKD System AB                                
+C59000-C59FFF                 (base 16)                     SKD System AB                                
+                                                            Rädisvägen 46                                
+                                                            Hässelby    16573                            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Spirent Communications                       
+C56000-C56FFF                 (base 16)                     Spirent Communications                       
+                                                            541 Industrial Way West                      
+                                                            Eatontown  NJ  07724                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         WAVECOM ELEKTRONIK AG                        
+C5C000-C5CFFF                 (base 16)                     WAVECOM ELEKTRONIK AG                        
+                                                            Hammerstrasse 8                              
+                                                            Bülach  Zürich  8180                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Bruckner & Jarosch Ingenieurgesellschaft mbH 
+C86000-C86FFF                 (base 16)                     Bruckner & Jarosch Ingenieurgesellschaft mbH 
+                                                            Nonnengasse 5a                               
+                                                            Erfurt  Thuringia  99084                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Automated Media Services, Inc.               
+C8A000-C8AFFF                 (base 16)                     Automated Media Services, Inc.               
+                                                            110 Commerce Drive                           
+                                                            Allendale  NJ  07401                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         9Solutions Oy                                
+C78000-C78FFF                 (base 16)                     9Solutions Oy                                
+                                                            Teknologiantie 2                             
+                                                            Oulu    90590                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Kyosha Industries                            
+C82000-C82FFF                 (base 16)                     Kyosha Industries                            
+                                                            11 rue parmentier                            
+                                                            Bezons  Val d'Oise  95870                    
+                                                            FR                                           
+
+00-50-C2                      (hex)                         High Speed Design, Inc.                      
+C57000-C57FFF                 (base 16)                     High Speed Design, Inc.                      
+                                                            11929 NW Old Quarry Rd                       
+                                                            Portland  OR  97229                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrial Automation Systems                
+C4D000-C4DFFF                 (base 16)                     Industrial Automation Systems                
+                                                            32 Almanac Way                               
+                                                            West Boylston  MA  01583                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Galvamat & Unican Technologies SA            
+C45000-C45FFF                 (base 16)                     Galvamat & Unican Technologies SA            
+                                                            Alexis-Marie-Piaget 71-73                    
+                                                            La Chaux-de-Fonds  NE  2300                  
+                                                            CH                                           
+
+00-50-C2                      (hex)                         BAE Systems Bofors AB                        
+C40000-C40FFF                 (base 16)                     BAE Systems Bofors AB                        
+                                                            SE-69180 Karlskoga                           
+                                                            Karlskoga  Värmland  69180                   
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Cammegh Limited                              
+C43000-C43FFF                 (base 16)                     Cammegh Limited                              
+                                                            Old Surrenden Manor                          
+                                                            Bethersden   Kent   TN263DL                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PLA ELECTRO APPLIANCES PVT. LTD.             
+C3D000-C3DFFF                 (base 16)                     PLA ELECTRO APPLIANCES PVT. LTD.             
+                                                            THAKOR IND. ESTATE                           
+                                                            MUMBAI  MAHARASHTRA  400086                  
+                                                            IN                                           
+
+00-50-C2                      (hex)                         RealTime Systems Ltd                         
+C2A000-C2AFFF                 (base 16)                     RealTime Systems Ltd                         
+                                                            A-49 Okhla Industrial area Phase -1          
+                                                            New Delhi  Delhi  110020                     
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Qtechnology A/S                              
+C27000-C27FFF                 (base 16)                     Qtechnology A/S                              
+                                                            Valby Langgade 142, 1.                       
+                                                            Valby  DK  2500                              
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Wagner Group GmbH                            
+C30000-C30FFF                 (base 16)                     Wagner Group GmbH                            
+                                                            Schleswigstrasse 1-5                         
+                                                            Langenhagen    30853                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Becton Dickinson                             
+C1C000-C1CFFF                 (base 16)                     Becton Dickinson                             
+                                                            7 Loveton Circle                             
+                                                            Sparks  MD  21152                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Axis-Shield PoC AS                           
+C17000-C17FFF                 (base 16)                     Axis-Shield PoC AS                           
+                                                            Kjelsåsveien 161                             
+                                                            Oslo    0504                                 
+                                                            NO                                           
+
+00-50-C2                      (hex)                         ANALOG WAY                                   
+C06000-C06FFF                 (base 16)                     ANALOG WAY                                   
+                                                            2 rue Georges Besse                          
+                                                            Antony    92160                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         I.S.A. S.r.l.                                
+BFF000-BFFFFF                 (base 16)                     I.S.A. S.r.l.                                
+                                                            Via Prati Bassi ,22                          
+                                                            TAINO  VA  21020                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         AVItronic GmbH                               
+C0E000-C0EFFF                 (base 16)                     AVItronic GmbH                               
+                                                            Kreischaer Str. 1a                           
+                                                            Bannewitz  Sachsen  01728                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Spectronix Corporation                       
+C14000-C14FFF                 (base 16)                     Spectronix Corporation                       
+                                                            Kunisato-bldg 5F,8-8,Eidai-cho               
+                                                            Ibaraki  Osaka  567-0816                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SoGEME                                       
+C04000-C04FFF                 (base 16)                     SoGEME                                       
+                                                            1 rue Jules Michelet                         
+                                                            BEAUVAIS    60000                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         SRC Computers, LLC                           
+C20000-C20FFF                 (base 16)                     SRC Computers, LLC                           
+                                                            4240 N. Nevada Avenue                        
+                                                            Colorado Springs  CO  80907                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Globe Wireless                               
+C09000-C09FFF                 (base 16)                     Globe Wireless                               
+                                                            1571 Robert J Conlan Blvd                    
+                                                            Palm Bay  Florida  32905                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crtiical Link                                
+BF8000-BF8FFF                 (base 16)                     Crtiical Link                                
+                                                            6712 Brooklawn Parkway                       
+                                                            Syracuse  NY  13211                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         GasTOPS Ltd.                                 
+BDB000-BDBFFF                 (base 16)                     GasTOPS Ltd.                                 
+                                                            1011 Polytek Street                          
+                                                            Ottawa  Ontario  K1J9J3                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         RF Code, Inc                                 
+BE5000-BE5FFF                 (base 16)                     RF Code, Inc                                 
+                                                            9229 Waterford Centre                        
+                                                            Austin  TX  78758                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Jiskoot Ltd                                  
+BE3000-BE3FFF                 (base 16)                     Jiskoot Ltd                                  
+                                                            85 Goods Station Road                        
+                                                            Tunbridge Wells  Kent  TN1 2DJ               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Wanco Inc.                                   
+BF3000-BF3FFF                 (base 16)                     Wanco Inc.                                   
+                                                            5870 Tennyson St.                            
+                                                            Arvada  CO  80003                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         DRS Laruel Technologies                      
+BEC000-BECFFF                 (base 16)                     DRS Laruel Technologies                      
+                                                            246 Airport Road                             
+                                                            Johnstown  Pa  15904                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         BG Systems, Inc.                             
+BD6000-BD6FFF                 (base 16)                     BG Systems, Inc.                             
+                                                            931 Commercial St.                           
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+BE1000-BE1FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Postjet Systems Ltd                          
+BD3000-BD3FFF                 (base 16)                     Postjet Systems Ltd                          
+                                                            6B Beechwood                                 
+                                                            Basingstoke  Hants  RG24 8WA                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Toptechnology SRL                            
+BC5000-BC5FFF                 (base 16)                     Toptechnology SRL                            
+                                                            Guise 1774 2B                                
+                                                            Ciudad de Buenos Aires  Capital Federal  C1425DPD
+                                                            AR                                           
+
+00-50-C2                      (hex)                         Sentec Ltd                                   
+BC1000-BC1FFF                 (base 16)                     Sentec Ltd                                   
+                                                            Brunswick House                              
+                                                            Cambridge  Cambridgeshire  CB5 8EG           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PTS GmbH                                     
+BC7000-BC7FFF                 (base 16)                     PTS GmbH                                     
+                                                            Gottfried-Schenker-Str. 2                    
+                                                            Lichtenau  Saxony  09244                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MoeTronix                                    
+BB8000-BB8FFF                 (base 16)                     MoeTronix                                    
+                                                            3342 Canary Trl                              
+                                                            Duluth  GA  30096                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         GHL Systems Berhad                           
+BBB000-BBBFFF                 (base 16)                     GHL Systems Berhad                           
+                                                            L5-E-7B, Enterprise 4                        
+                                                            Bukit Jalil  Kuala Lumpur  57000             
+                                                            MY                                           
+
+00-50-C2                      (hex)                         CUSTOS MOBILE S.L.                           
+BA4000-BA4FFF                 (base 16)                     CUSTOS MOBILE S.L.                           
+                                                            SOCIEDAD DE CONDUENOS 21                     
+                                                            ALCALA DE HENARES  MADRID  28804             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         InterCel Pty Ltd                             
+BA5000-BA5FFF                 (base 16)                     InterCel Pty Ltd                             
+                                                            33 Glenvale Crescent                         
+                                                            Mulgrave  Victoria  3170                     
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Gainbrain                                    
+BB0000-BB0FFF                 (base 16)                     Gainbrain                                    
+                                                            Auweg 32                                     
+                                                            Senden    89250                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Folink                                       
+B78000-B78FFF                 (base 16)                     Folink                                       
+                                                            4F 647-39Deungchon-Dong Kangseo-Gu           
+                                                            Seoul    157-840                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         AXED Jakubowski Wojciechowski sp.j.          
+B74000-B74FFF                 (base 16)                     AXED Jakubowski Wojciechowski sp.j.          
+                                                            ul. Fredry 7                                 
+                                                            Poznań  Wielkopolska  61-701                 
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Finnet-Service Ltd.                          
+B91000-B91FFF                 (base 16)                     Finnet-Service Ltd.                          
+                                                            Serebrianicheskyi per., b.2/5 str. 4.        
+                                                            Moscow    109028                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         ELETECH Srl                                  
+B7D000-B7DFFF                 (base 16)                     ELETECH Srl                                  
+                                                            S.P.231 Km 3,500                             
+                                                            BITONTO  BARI  70032                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         W. Vershoven GmbH                            
+B9D000-B9DFFF                 (base 16)                     W. Vershoven GmbH                            
+                                                            Riedinger Strasse 10                         
+                                                            Essen    45141                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AUDIOSCOPE 2K SRL                            
+B9F000-B9FFFF                 (base 16)                     AUDIOSCOPE 2K SRL                            
+                                                            31, VIA CAIANELLO                            
+                                                            ROMA    00177                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Southwest Research Institute                 
+B98000-B98FFF                 (base 16)                     Southwest Research Institute                 
+                                                            6220 Culebra Road                            
+                                                            San Antonio  TX  78238                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Greenlight Innovation Corp.                  
+B99000-B99FFF                 (base 16)                     Greenlight Innovation Corp.                  
+                                                            Unit 104A                                    
+                                                            Burnaby,  B.C.  V5A 3H4                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         WAC (Israel) Ltd.                            
+B8E000-B8EFFF                 (base 16)                     WAC (Israel) Ltd.                            
+                                                            Shefa Tal 12                                 
+                                                            Tel-Aviv    61070                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         iScreen LLC                                  
+B80000-B80FFF                 (base 16)                     iScreen LLC                                  
+                                                            3181 Poplar Avenue, Ste. 200                 
+                                                            Memphis  TN  38111-4717                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         SMH Technologies                             
+B52000-B52FFF                 (base 16)                     SMH Technologies                             
+                                                            Via Giovanni Agnelli, 1                      
+                                                            Villotta di Chions  Pordenone  33083         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SELCO                                        
+B50000-B50FFF                 (base 16)                     SELCO                                        
+                                                            ZI DU VAL D OMBREE                           
+                                                            COMBREE    49520                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         AixControl GmbH                              
+B4E000-B4EFFF                 (base 16)                     AixControl GmbH                              
+                                                            Jaegerstr. 17-19                             
+                                                            Aachen  NRW  52066                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GREEN Center s.r.o.                          
+B5A000-B5AFFF                 (base 16)                     GREEN Center s.r.o.                          
+                                                            Zenklova 39                                  
+                                                            Praha 8    180 00                            
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Private                                      
+B6E000-B6EFFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Electronic Systems Protection, Inc.          
+B68000-B68FFF                 (base 16)                     Electronic Systems Protection, Inc.          
+                                                            8001 Knightdale Blvd.                        
+                                                            Knightdale  NC  27545                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         RC Systems Co. Inc.                          
+B67000-B67FFF                 (base 16)                     RC Systems Co. Inc.                          
+                                                            8621 Hwy. 6                                  
+                                                            Hitchcock  TX  77563                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         RO.VE.R. Laboratories S.p.A                  
+B63000-B63FFF                 (base 16)                     RO.VE.R. Laboratories S.p.A                  
+                                                            Via Parini 2/4                               
+                                                            Colombare di SIrmione  BS  25019             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sage Consultants                             
+B3E000-B3EFFF                 (base 16)                     Sage Consultants                             
+                                                            Level 1, 169 Kelvin Grove Rd                 
+                                                            Kelvin Grove  QLD  4059                      
+                                                            AU                                           
+
+00-50-C2                      (hex)                         JanasCard                                    
+B3C000-B3CFFF                 (base 16)                     JanasCard                                    
+                                                            1. pluku 12                                  
+                                                            Praha 8  CR  18600                           
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Byres Security Inc                           
+B32000-B32FFF                 (base 16)                     Byres Security Inc                           
+                                                            #5-7217 Lantzville Road                      
+                                                            Lantzville  BC  V0R 2H0                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         J-Systems Inc.                               
+B43000-B43FFF                 (base 16)                     J-Systems Inc.                               
+                                                            1S678 School Ave.                            
+                                                            Lombard  IL  60148                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tata Power Company, Strategic Electronics Division
+B41000-B41FFF                 (base 16)                     Tata Power Company, Strategic Electronics Division
+                                                            42/43, Electronics City,                     
+                                                            Bangalore  Karnataka  560100                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ETM Electromatic Incorporated                
+B42000-B42FFF                 (base 16)                     ETM Electromatic Incorporated                
+                                                            35451 Dumbarton Court                        
+                                                            NEWARK  CA  94560                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ronyo Technologies s.r.o.                    
+B23000-B23FFF                 (base 16)                     Ronyo Technologies s.r.o.                    
+                                                            Martinovska 3168/48                          
+                                                            Ostrava  Moravskoslezský kraj  72300         
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         siXis, Inc.                                  
+B39000-B39FFF                 (base 16)                     siXis, Inc.                                  
+                                                            PO Box 14245                                 
+                                                            Research Triangle Park  NC  27709-4245       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Grenmore Ltd                                 
+B38000-B38FFF                 (base 16)                     Grenmore Ltd                                 
+                                                            Unit 12, Northpoint Business Park            
+                                                            Cork                                         
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+B1C000-B1CFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ELCUS                                        
+B1A000-B1AFFF                 (base 16)                     ELCUS                                        
+                                                            Varshavskaia st. 5a, liter 'L'               
+                                                            St. Petersburg    196128                     
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Measy Electronics Co., Ltd.                  
+B13000-B13FFF                 (base 16)                     Measy Electronics Co., Ltd.                  
+                                                            Rm 1506, Block B, Haisong Bldg, Tairan 9th Rd, Chegongmiao, Futian
+                                                            Shenzhen  Guangdong  518040                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Abbott Medical Optics                        
+B1E000-B1EFFF                 (base 16)                     Abbott Medical Optics                        
+                                                            1700 East St. Andrew Place                   
+                                                            Santa Ana  CA  92705                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         SMARTB TECHNOLOGIES                          
+B0C000-B0CFFF                 (base 16)                     SMARTB TECHNOLOGIES                          
+                                                            #625 1ST FLOOR 3 RD CROSS CBI MAIN ROAD HMT LAYOUT RT NAGAR
+                                                            BANAGALORE  KARNATAKA  560032                
+                                                            IN                                           
+
+00-50-C2                      (hex)                         National CineMedia                           
+AEF000-AEFFFF                 (base 16)                     National CineMedia                           
+                                                            9110 East Nichols Ave.                       
+                                                            Centennial  CO  80112                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Global Satellite Engineering                 
+AF8000-AF8FFF                 (base 16)                     Global Satellite Engineering                 
+                                                            1831 Cordova Road                            
+                                                            Fort Lauderdale  FL  33316                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ingenieurbuero Bickele und Buehler GmbH      
+AF9000-AF9FFF                 (base 16)                     Ingenieurbuero Bickele und Buehler GmbH      
+                                                            St.Poeltener Str. 70                         
+                                                            Stuttgart  BW  70469                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Goerlitz AG                                  
+B08000-B08FFF                 (base 16)                     Goerlitz AG                                  
+                                                            August-Thyssen-Str. 32                       
+                                                            Koblenz  Rheinland-Pfalz  56077              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         XoByte LLC                                   
+AFF000-AFFFFF                 (base 16)                     XoByte LLC                                   
+                                                            235 Peconic Street                           
+                                                            Ronkonkoma  New York  11779                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         CompuDesigns, Inc.                           
+B06000-B06FFF                 (base 16)                     CompuDesigns, Inc.                           
+                                                            1655 Redbourne Drive                         
+                                                            Sandy Springs  GA  30350-5640                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Redwood Systems                              
+AE7000-AE7FFF                 (base 16)                     Redwood Systems                              
+                                                            3839 Spinnaker Ct.                           
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bit-Lab PTY LTD                              
+AE8000-AE8FFF                 (base 16)                     Bit-Lab PTY LTD                              
+                                                            4 Ferrer Place                               
+                                                            Woodlands  WA  6018                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         VECOM USA                                    
+AE6000-AE6FFF                 (base 16)                     VECOM USA                                    
+                                                            4803 George Road                             
+                                                            Tampa  FL  33634                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         SP Controls, Inc                             
+ACF000-ACFFFF                 (base 16)                     SP Controls, Inc                             
+                                                            930 Linden Ave                               
+                                                            South San Francisco  CA  94086               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Geonautics Australia Pty Ltd                 
+AD0000-AD0FFF                 (base 16)                     Geonautics Australia Pty Ltd                 
+                                                            60 Morley Street                             
+                                                            Brisbane  Queensland  4151                   
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Global Rainmakers Inc.                       
+AD4000-AD4FFF                 (base 16)                     Global Rainmakers Inc.                       
+                                                            10 East 53rd St.                             
+                                                            New York  NY  10022                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+AD3000-AD3FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         OpenXS B.V.                                  
+AC2000-AC2FFF                 (base 16)                     OpenXS B.V.                                  
+                                                            Koaibosk 3                                   
+                                                            Terwispel  Friesland  8407ED                 
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Soft & Control Technology s.r.o.             
+ACA000-ACAFFF                 (base 16)                     Soft & Control Technology s.r.o.             
+                                                            Magnezitarska 10                             
+                                                            Kosice  Kosice mesto  04013                  
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Steinbeis-Transferzentrum Embedded Design und Networking
+AC9000-AC9FFF                 (base 16)                     Steinbeis-Transferzentrum Embedded Design und Networking
+                                                            Poststraße 35                                
+                                                            Heitersheim  Baden-Württemberg  79423        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Marathon Products, Inc.                      
+AC6000-AC6FFF                 (base 16)                     Marathon Products, Inc.                      
+                                                            P.O. Box 21579                               
+                                                            Oakland  CA  94620-1579                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         MCC Computer Company                         
+ABF000-ABFFFF                 (base 16)                     MCC Computer Company                         
+                                                            505 E. Palm Valley Blvd                      
+                                                            Round Rock  Texas  78664                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Incyma                                       
+AD8000-AD8FFF                 (base 16)                     Incyma                                       
+                                                            Victor-Duret 18                              
+                                                            Onex  GE  1213                               
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Altinex, Inc                                 
+ADF000-ADFFFF                 (base 16)                     Altinex, Inc                                 
+                                                            592 Apollo Street                            
+                                                            Brea  CA  92821                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         GO engineering GmbH                          
+ADB000-ADBFFF                 (base 16)                     GO engineering GmbH                          
+                                                            Stolzenbergstraße 13/IV                      
+                                                              Baden-Württemberg  76532                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Joehl & Koeferli AG                          
+A9D000-A9DFFF                 (base 16)                     Joehl & Koeferli AG                          
+                                                            Wittenwilerstrasse 31                        
+                                                            Aadorf  TG  8355                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Star Electronics GmbH & Co. KG               
+A9C000-A9CFFF                 (base 16)                     Star Electronics GmbH & Co. KG               
+                                                            Jahnstraße 86                                
+                                                            Göppingen  BW  73037                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+AA3000-AA3FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Procon Engineering Limited                   
+A9E000-A9EFFF                 (base 16)                     Procon Engineering Limited                   
+                                                            Vestry Estate                                
+                                                            Sevenoaks  Kent  TN14 5EL                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Santa Barbara Instrument Group               
+AAF000-AAFFFF                 (base 16)                     Santa Barbara Instrument Group               
+                                                            147A Castilian Drive                         
+                                                            Santa Barbara  CA  93117                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         AHM Limited (CLiKAPAD)                       
+AB8000-AB8FFF                 (base 16)                     AHM Limited (CLiKAPAD)                       
+                                                            Arlington House, Dittons Bus. Pk             
+                                                            POLEGATE  East Sussex  BN266HY               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Twinfalls Technologies                       
+AB7000-AB7FFF                 (base 16)                     Twinfalls Technologies                       
+                                                            604 - 500 W 10th Ave                         
+                                                            Vancouver  BC  V5Z4P1                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Sentry 360 Security                          
+A98000-A98FFF                 (base 16)                     Sentry 360 Security                          
+                                                            1280 Iroquois Ave                            
+                                                            Naperville  IL  60563                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         DetNet South Africa PTY (LTD)                
+A7A000-A7AFFF                 (base 16)                     DetNet South Africa PTY (LTD)                
+                                                            1 Platinum Drive                             
+                                                            Modderfontein  Gauteng  1645                 
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         BFI Industrie-Elektronik GmbH & Co.KG        
+A8E000-A8EFFF                 (base 16)                     BFI Industrie-Elektronik GmbH & Co.KG        
+                                                            Winchenbachstrasse 3b                        
+                                                            Wuppertal  NRW  42281                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Roesch & Walter Industrie-Elektronik GmbH    
+A76000-A76FFF                 (base 16)                     Roesch & Walter Industrie-Elektronik GmbH    
+                                                            Woertelweg 2b/c                              
+                                                            Schwanau    77963                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         JTL Systems Ltd.                             
+A75000-A75FFF                 (base 16)                     JTL Systems Ltd.                             
+                                                            41 Kingfisher Court                          
+                                                            Newbury  Berks  RG14 5SJ                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         JOYSYSTEM                                    
+A85000-A85FFF                 (base 16)                     JOYSYSTEM                                    
+                                                            2-3-21 DAIKAIDORI                            
+                                                            KOBE  HYOUGO  652-0803                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Lino Manfrotto +Co spa                       
+A84000-A84FFF                 (base 16)                     Lino Manfrotto +Co spa                       
+                                                            via sasso rosso 19                           
+                                                            Bassano del Grappa  Vicenza  36061           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         PRIMETECH ENGINEERING CORP.                  
+A47000-A47FFF                 (base 16)                     PRIMETECH ENGINEERING CORP.                  
+                                                             Koishikawadaikoku Bldg. 3F, 1-3-25          
+                                                             Koishikawa, Bunkyo-ku  Tokyo  112-0002      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         NKS Co.Ltd.                                  
+A43000-A43FFF                 (base 16)                     NKS Co.Ltd.                                  
+                                                            Yodogawa-ku Niitaka                          
+                                                            Osaka    532-0033                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Softronics Ltd.                              
+A46000-A46FFF                 (base 16)                     Softronics Ltd.                              
+                                                            6920 Bowman Lane NE                          
+                                                            Cedar Rapids  IA  52402                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         LHA Systems CC                               
+A3F000-A3FFFF                 (base 16)                     LHA Systems CC                               
+                                                            1 Innovation Centre 2                        
+                                                            Stellenbosch  Western cape  7600             
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         OWANDY                                       
+A3D000-A3DFFF                 (base 16)                     OWANDY                                       
+                                                            6 Allée Kepler                               
+                                                            Champs sur Marne    77420                    
+                                                            FR                                           
+
+00-50-C2                      (hex)                         DUEVI SNC DI MORA E SANTESE                  
+A3E000-A3EFFF                 (base 16)                     DUEVI SNC DI MORA E SANTESE                  
+                                                            Via Gioberti 7                               
+                                                            Piossasco  Torino  10045                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Arrowvale Electronics                        
+A55000-A55FFF                 (base 16)                     Arrowvale Electronics                        
+                                                            Shawbank Road                                
+                                                            Redditch  Worcestershire  B98 8YN            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Juice Technologies, LLC                      
+A57000-A57FFF                 (base 16)                     Juice Technologies, LLC                      
+                                                            930 Kinnear Rd                               
+                                                            Columbus  OH  43212                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         The VON Corporation                          
+A52000-A52FFF                 (base 16)                     The VON Corporation                          
+                                                            1038 Lomb Ave. SW                            
+                                                            Birmingham  AL  35211                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Figment Design Laboratories                  
+A6C000-A6CFFF                 (base 16)                     Figment Design Laboratories                  
+                                                            113 11th Avenue                              
+                                                            Johannesburg  Guateng  2170                  
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Mark-O-Print GmbH                            
+A65000-A65FFF                 (base 16)                     Mark-O-Print GmbH                            
+                                                            Reepschlaeger Strasse 11a                    
+                                                            Luebeck  Schleswig-Holstein  23556           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+A61000-A61FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel    CH4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         LevelStar LLC.                               
+A4D000-A4DFFF                 (base 16)                     LevelStar LLC.                               
+                                                            685 S. Arthur Ave.                           
+                                                            Louisville  CO  80027                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+A0C000-A0CFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         KWS-Electronic GmbH                          
+A2C000-A2CFFF                 (base 16)                     KWS-Electronic GmbH                          
+                                                            Sportplatzstrasse 1                          
+                                                            Grosskarolinenfeld    D-83109                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Luminex Corporation                          
+A29000-A29FFF                 (base 16)                     Luminex Corporation                          
+                                                            12212 Technology Blvd.                       
+                                                            Austin  Texas  78727                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         KENDA ELECTRONIC SYSTEMS LIMITED             
+A28000-A28FFF                 (base 16)                     KENDA ELECTRONIC SYSTEMS LIMITED             
+                                                            NUTSEY LANE                                  
+                                                            SOUTHAMPTON  HAMPSHIRE  SO40 3NB             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Tred Displays                                
+A38000-A38FFF                 (base 16)                     Tred Displays                                
+                                                            5201 Eagle Rock Rd NE                        
+                                                            Albuquerque  NM  87113                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Software Systems Plus                        
+A37000-A37FFF                 (base 16)                     Software Systems Plus                        
+                                                            9924 N. Ash Avenue                           
+                                                            Kansas City  Missouri  64157                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Preferred Oil, LLC                           
+A26000-A26FFF                 (base 16)                     Preferred Oil, LLC                           
+                                                            1819 Moen Ave                                
+                                                            Joliet  IL  60436                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nippon Manufacturing Service Corporation (abbreviated as 'nms')
+A22000-A22FFF                 (base 16)                     Nippon Manufacturing Service Corporation (abbreviated as 'nms')
+                                                            Tokyo Opera City Tower 11F                   
+                                                            Shinjuku-ku  Tokyo  163-1411                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         OJSC Rawenstvo                               
+A11000-A11FFF                 (base 16)                     OJSC Rawenstvo                               
+                                                            19, Promyshlennaya str,                      
+                                                            Saint-Petersburg    198099                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         DDL                                          
+A1A000-A1AFFF                 (base 16)                     DDL                                          
+                                                            6F AFT BLDG.                                 
+                                                            SAPPORO  HOKKAIDO  060-0035                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SAMSUNG HEAVY INDUSTRIES CO.,LTD.            
+9D8000-9D8FFF                 (base 16)                     SAMSUNG HEAVY INDUSTRIES CO.,LTD.            
+                                                            Institute of industrial Technology           
+                                                            Daejeon    305-380                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Innovation, Institute, Inc                   
+9D6000-9D6FFF                 (base 16)                     Innovation, Institute, Inc                   
+                                                            P.O. Box 9359                                
+                                                            Caguas  Puerto Rico  00726-9359              
+                                                            PR                                           
+
+00-50-C2                      (hex)                         Melex Inc.                                   
+9D7000-9D7FFF                 (base 16)                     Melex Inc.                                   
+                                                            1417-27 Toke-cho Midori-ku                   
+                                                              CHIBA  2670061                             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Ion Sense Inc.                               
+9F6000-9F6FFF                 (base 16)                     Ion Sense Inc.                               
+                                                            999 Broadway                                 
+                                                            Saugus  MA  01906                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Austco Communication Systems Pty Ltd         
+9F8000-9F8FFF                 (base 16)                     Austco Communication Systems Pty Ltd         
+                                                            40 O'Malley Street                           
+                                                            Osborne Park  Western Australia  6017        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Adgil Design Inc.                            
+A05000-A05FFF                 (base 16)                     Adgil Design Inc.                            
+                                                            12915 Brault                                 
+                                                            Mirabel  Quebec  J7J 1P3                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Patronics International LTD                  
+A01000-A01FFF                 (base 16)                     Patronics International LTD                  
+                                                            Eurotech House                               
+                                                            Plymouth  Devon  PL5 3LZ                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Villbau Kft.                                 
+9FB000-9FBFFF                 (base 16)                     Villbau Kft.                                 
+                                                            Üllői út 611.                                
+                                                            BUdapest    H-1182                           
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Institut Dr. Foerster                        
+9DD000-9DDFFF                 (base 16)                     Institut Dr. Foerster                        
+                                                            In Laisen 70                                 
+                                                            Reutlingen    72766                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SAI Informationstechnik                      
+9E3000-9E3FFF                 (base 16)                     SAI Informationstechnik                      
+                                                            Hackhofergasse 1                             
+                                                            Vienna    1190                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         GE Security-Kampro                           
+9C3000-9C3FFF                 (base 16)                     GE Security-Kampro                           
+                                                            2F, No.8, Lane97, Wugong Rd.,                
+                                                            Hsin-Chuang City  Taipei County  248         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         2N TELEKOMUNIKACE a.s.                       
+9BF000-9BFFFF                 (base 16)                     2N TELEKOMUNIKACE a.s.                       
+                                                            Modranska 621                                
+                                                            Prague    143 01                             
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Thales Communications & Security S.A.        
+9A7000-9A7FFF                 (base 16)                     Thales Communications & Security S.A.        
+                                                            20-22 Rue Grange Dame Rose                   
+                                                            Vélizy    78141                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Vitel Net                                    
+9C4000-9C4FFF                 (base 16)                     Vitel Net                                    
+                                                            8201 Greensboro Dr.                          
+                                                            McLean  VA  22102                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xad Communications Ltd                       
+9BE000-9BEFFF                 (base 16)                     Xad Communications Ltd                       
+                                                            Weir House                                   
+                                                            Bristol  UK  BS4 4AR                         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Questek Australia Pty Ltd                    
+9AC000-9ACFFF                 (base 16)                     Questek Australia Pty Ltd                    
+                                                            22 Brodie St                                 
+                                                            Rydalmere  NSW  2116                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Telegamma srl                                
+9B5000-9B5FFF                 (base 16)                     Telegamma srl                                
+                                                            Via Noalese, 63/B                            
+                                                            Treviso  TV  31100                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Bladelius Design Group AB                    
+9D1000-9D1FFF                 (base 16)                     Bladelius Design Group AB                    
+                                                            Kallakersvagen 10                            
+                                                            Alingsas    44196                            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         NIS-time GmbH                                
+9CB000-9CBFFF                 (base 16)                     NIS-time GmbH                                
+                                                            Valterweg 10                                 
+                                                            Bremthal    65817                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kumera Drives Oy                             
+9C7000-9C7FFF                 (base 16)                     Kumera Drives Oy                             
+                                                            Kumerankatu 2                                
+                                                            Riihimäki  Häme  11100                       
+                                                            FI                                           
+
+00-50-C2                      (hex)                         KRESS-NET Krzysztof Rutecki                  
+9AF000-9AFFFF                 (base 16)                     KRESS-NET Krzysztof Rutecki                  
+                                                            Stawowa 8a                                   
+                                                            Gaszowice    44-293                          
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Miromico AG                                  
+99A000-99AFFF                 (base 16)                     Miromico AG                                  
+                                                            Gallusstrasse 4                              
+                                                            Zuerich    CH-8006                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Cambustion Ltd                               
+999000-999FFF                 (base 16)                     Cambustion Ltd                               
+                                                            J6, The Paddocks                             
+                                                            Cambridge  Cambridgeshire  CB1 8DH           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Triple Ring Technologies, Inc.               
+982000-982FFF                 (base 16)                     Triple Ring Technologies, Inc.               
+                                                            39655 Eureka Ave                             
+                                                            Newark  Ca  94560                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xafax Nederland bv                           
+994000-994FFF                 (base 16)                     Xafax Nederland bv                           
+                                                            Postbus 107                                  
+                                                            Alkmaar  NH  1800AC                          
+                                                            NL                                           
+
+00-50-C2                      (hex)                         UGL Limited                                  
+991000-991FFF                 (base 16)                     UGL Limited                                  
+                                                            3 Bridge Street                              
+                                                            Pymble  NSW  2073                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Inter Control Hermann Köhler  Elektrik GmbH&Co.KG
+995000-995FFF                 (base 16)                     Inter Control Hermann Köhler  Elektrik GmbH&Co.KG
+                                                            Schafhofstraße 30                            
+                                                            Nürnberg  Bavaria  90411                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Far South Networks (Pty) Ltd                 
+979000-979FFF                 (base 16)                     Far South Networks (Pty) Ltd                 
+                                                            3 Milagro Lane                               
+                                                            Noordhoek  Western Cape  7975                
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Conolog Corporation                          
+9A5000-9A5FFF                 (base 16)                     Conolog Corporation                          
+                                                            5 Columbia Road                              
+                                                            Somerville  NJ  08876                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sensoptics Ltd                               
+958000-958FFF                 (base 16)                     Sensoptics Ltd                               
+                                                            3 Gordano Court                              
+                                                            Portishead  Bristol  BS20 7FS                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Keene Electronics Ltd.                       
+96D000-96DFFF                 (base 16)                     Keene Electronics Ltd.                       
+                                                            unit 9 old hall mills business park          
+                                                            derby    de21 5dz                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         IQ Automation GmbH                           
+964000-964FFF                 (base 16)                     IQ Automation GmbH                           
+                                                            Breslauer Str. 3                             
+                                                            Eching    85386                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         METRONIC APARATURA KONTROLNO - POMIAROWA     
+95F000-95FFFF                 (base 16)                     METRONIC APARATURA KONTROLNO - POMIAROWA     
+                                                            WYBICKIEGO 7                                 
+                                                            KRAKOW  MALOPOLSKA  31-261                   
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Resurgent Health & Medical                   
+95C000-95CFFF                 (base 16)                     Resurgent Health & Medical                   
+                                                            600 Corporate Circle                         
+                                                            Golden  CO  80401                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Systèmes Pran                                
+973000-973FFF                 (base 16)                     Systèmes Pran                                
+                                                            2245, Rue Léon  Harmel                       
+                                                            Québec    G1N4J6                             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         TSB Solutions Inc.                           
+93F000-93FFFF                 (base 16)                     TSB Solutions Inc.                           
+                                                            5399 Eglinton Ave West.                      
+                                                            Toronto  Ontario  M9C 5K6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Postec Data Systems Ltd                      
+938000-938FFF                 (base 16)                     Postec Data Systems Ltd                      
+                                                            P O Box 302 230                              
+                                                            North Shore  Auckland  0632                  
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Mosaic Dynamic Solutions                     
+939000-939FFF                 (base 16)                     Mosaic Dynamic Solutions                     
+                                                            1259 Route 113 Suite 203                     
+                                                            Perkasie  PA  18917                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         BigBear                                      
+937000-937FFF                 (base 16)                     BigBear                                      
+                                                            Borgerdiget 130                              
+                                                            Herlev    2730                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Zynix Original Sdn. Bhd.                     
+94E000-94EFFF                 (base 16)                     Zynix Original Sdn. Bhd.                     
+                                                            43-1, Jalan 1/149J, Sri Petaling,            
+                                                            Kuala Lumpur  Wilayah Persekutuan  57000     
+                                                            MY                                           
+
+00-50-C2                      (hex)                         Phitek Systems Ltd.                          
+940000-940FFF                 (base 16)                     Phitek Systems Ltd.                          
+                                                            Level 4                                      
+                                                            Auckland  ---  1141                          
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Tech Fass s.r.o.                             
+952000-952FFF                 (base 16)                     Tech Fass s.r.o.                             
+                                                            Plavecka 503                                 
+                                                            Jesenice    252 42                           
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Cinetix GmbH                                 
+928000-928FFF                 (base 16)                     Cinetix GmbH                                 
+                                                            Gemuendener Str. 27                          
+                                                            D-60599  Frankfurt/Main                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PHB Eletronica Ltda.                         
+925000-925FFF                 (base 16)                     PHB Eletronica Ltda.                         
+                                                            Aroaba St., 129                              
+                                                            São Paulo    05315-020                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         ATIS group s.r.o.                            
+927000-927FFF                 (base 16)                     ATIS group s.r.o.                            
+                                                            Za Strašnickou vozovnou 7                    
+                                                            Prague  Czech Republic  110 00               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Metrum Sweden AB                             
+922000-922FFF                 (base 16)                     Metrum Sweden AB                             
+                                                            Vestagatan 2A                                
+                                                            Göteborg  Vastra Götland  41664              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Amicus Wireless                              
+923000-923FFF                 (base 16)                     Amicus Wireless                              
+                                                            295 Santa Ana Court                          
+                                                            Sunnyvale  CA  94085                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         iQue RFID Technologies BV                    
+921000-921FFF                 (base 16)                     iQue RFID Technologies BV                    
+                                                            Hogerwoerdstraat 30                          
+                                                            Haarlem  NH  2023 VD                         
+                                                            NL                                           
+
+00-50-C2                      (hex)                         NETA Elektronik AS                           
+930000-930FFF                 (base 16)                     NETA Elektronik AS                           
+                                                            Yukari Dudullu Organize Sanayi Bolgesi       
+                                                            Istanbul    34775                            
+                                                            TR                                           
+
+00-50-C2                      (hex)                         Embedded Data Systems, LLC                   
+91B000-91BFFF                 (base 16)                     Embedded Data Systems, LLC                   
+                                                            1446 Gilberts Creek Rd                       
+                                                            Lawrenceburg  KY  40342                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Automation Tec                               
+91E000-91EFFF                 (base 16)                     Automation Tec                               
+                                                            1970 Hwy 265                                 
+                                                            Hollister  MO  65672                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Exatrol Corporation                          
+92C000-92CFFF                 (base 16)                     Exatrol Corporation                          
+                                                            1308 West 635 South                          
+                                                            Orem  UT  84058                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xtone Networks                               
+91A000-91AFFF                 (base 16)                     Xtone Networks                               
+                                                            11190 Sunrise Valley Dr                      
+                                                            Reston  VA  20191                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         CHK GridSense P/L                            
+916000-916FFF                 (base 16)                     CHK GridSense P/L                            
+                                                            Unit 3, 20 36 Nancarrow Avenue               
+                                                            MEADOWBANK  NSW  2114                        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Cristal Controles Ltee                       
+907000-907FFF                 (base 16)                     Cristal Controles Ltee                       
+                                                            2025 Lavoisier #135                          
+                                                            Quebec    G1N 4L6                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         TGE Co., Ltd.                                
+8F7000-8F7FFF                 (base 16)                     TGE Co., Ltd.                                
+                                                            204-3, Anyang-7Dong, Manan-Gu,               
+                                                            Anyang-City  Gyeonggi-Do  430-017            
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Luceat                                       
+8FF000-8FFFFF                 (base 16)                     Luceat                                       
+                                                            Via A. Canossi 18                            
+                                                            Torbole Casaglia  BS  25030                  
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sindoma Müh Mim Ýnþ Elk San Tic Ltd.         
+8FD000-8FDFFF                 (base 16)                     Sindoma Müh Mim Ýnþ Elk San Tic Ltd.         
+                                                            Dereboyu cad. Þair Necati sok.               
+                                                            Ýstanbul  TR  34347                         
+                                                            TR                                           
+
+00-50-C2                      (hex)                         Link Communications, Inc                     
+905000-905FFF                 (base 16)                     Link Communications, Inc                     
+                                                            1035 Cerise Road                             
+                                                            Billings  Montana  59101                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Technologies Sensio Inc                      
+8EF000-8EFFFF                 (base 16)                     Technologies Sensio Inc                      
+                                                            1751 Richardson, Suite 4.206                 
+                                                            Montréal  Québec  H3K 1G6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Beonic Corporation                           
+8CB000-8CBFFF                 (base 16)                     Beonic Corporation                           
+                                                            141 Gilbert Street                           
+                                                            Adelaide  S.A.  5000                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Altair semiconductor Ltd                     
+8CA000-8CAFFF                 (base 16)                     Altair semiconductor Ltd                     
+                                                            6 Ha'arash St.                               
+                                                            Hod Hasharon    45240                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         C-COM Satellite Systems Inc.                 
+8EB000-8EBFFF                 (base 16)                     C-COM Satellite Systems Inc.                 
+                                                            2574 Sheffield Road                          
+                                                            Ottawa  Ontario  K1B3V7                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         GIMCON                                       
+8DD000-8DDFFF                 (base 16)                     GIMCON                                       
+                                                            Reininghausstraße 5                          
+                                                            Graz  Styria  8020                           
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+8D0000-8D0FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DCOM Network Technology (Pty) Ltd            
+8DB000-8DBFFF                 (base 16)                     DCOM Network Technology (Pty) Ltd            
+                                                            Unit A18, Bellville Business Park            
+                                                            Cape Town  Western Province  7530            
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Telsa s.r.l                                  
+8AC000-8ACFFF                 (base 16)                     Telsa s.r.l                                  
+                                                            Via C.Colombo 29\31                          
+                                                            Osio Sotto  Bergamo  24046                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Intelligent Security Systems                 
+8A9000-8A9FFF                 (base 16)                     Intelligent Security Systems                 
+                                                            Office 102, str. 77, vl. 1, Leninskie Gory, MSU Science Park
+                                                            Moscow    119234                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         S.C.E. s.r.l.                                
+8C0000-8C0FFF                 (base 16)                     S.C.E. s.r.l.                                
+                                                            Via Giardini 1271/A                          
+                                                            Modena  Mo  41100                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Access Control Systems JSC                   
+8C2000-8C2FFF                 (base 16)                     Access Control Systems JSC                   
+                                                             65, Serdobolskaya st.                       
+                                                            St-Petersburg    197342                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         ALTEK ELECTRONICS                            
+8A8000-8A8FFF                 (base 16)                     ALTEK ELECTRONICS                            
+                                                            89 Commercial Blvd                           
+                                                            Torrington  CT  06790                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ATS Elektronik GmbH                          
+8AA000-8AAFFF                 (base 16)                     ATS Elektronik GmbH                          
+                                                            Albert-Einstein-Straße 3                     
+                                                            Wunstorf  Lower saxony  31515                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PIXEYE LTD                                   
+8A7000-8A7FFF                 (base 16)                     PIXEYE LTD                                   
+                                                            #75 Dondukov blvd.                           
+                                                            Sofia    1504                                
+                                                            BG                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+8B5000-8B5FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SELCO                                        
+8A6000-8A6FFF                 (base 16)                     SELCO                                        
+                                                            ZI DU VAL D'OMBREE                           
+                                                            COMBREE  SA  49520                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Datalink Technologies Gateways Inc.          
+89F000-89FFFF                 (base 16)                     Datalink Technologies Gateways Inc.          
+                                                            3888 Sound Way                               
+                                                            Bellingham  WA  98226                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         UAVISION Engenharia de Sistemas              
+8A2000-8A2FFF                 (base 16)                     UAVISION Engenharia de Sistemas              
+                                                            Ed Inovisa Inst. Sup. Agro Tapada da Ajuda   
+                                                            Lisbon    1349-017                           
+                                                            PT                                           
+
+00-50-C2                      (hex)                         BK Innovation, Inc.                          
+8B0000-8B0FFF                 (base 16)                     BK Innovation, Inc.                          
+                                                            1016 Morse Ave                               
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         HANYANG ELECTRIC CP., LTD                    
+86E000-86EFFF                 (base 16)                     HANYANG ELECTRIC CP., LTD                    
+                                                            603-2, Janggok-ri, Jori-eup                  
+                                                            Paju  Gyeonggi-do  413-825                   
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Tieline Research Pty Ltd                     
+86D000-86DFFF                 (base 16)                     Tieline Research Pty Ltd                     
+                                                            PO Box 2092                                  
+                                                            Malaga  Western Australia  6944              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         LOGEL S.R.L.                                 
+870000-870FFF                 (base 16)                     LOGEL S.R.L.                                 
+                                                            VIA DELLA TECNICA 13/A-13/B                  
+                                                            CASTELNUOVO RANGONE  MODENA  41051           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Z-App Systems                                
+88C000-88CFFF                 (base 16)                     Z-App Systems                                
+                                                            2210 North First St                          
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cardinal Scale Mfg Co                        
+88E000-88EFFF                 (base 16)                     Cardinal Scale Mfg Co                        
+                                                            203 E. Daugherty                             
+                                                            Webb City  MO  64870                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Neocontrol Soluções em Automação             
+883000-883FFF                 (base 16)                     Neocontrol Soluções em Automação             
+                                                            Rua Alagoas 1160, 10. andar                  
+                                                            Belo Horizonte  Minas Gerais  30130-912      
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Acoustic Research Laboratories Pty Ltd       
+878000-878FFF                 (base 16)                     Acoustic Research Laboratories Pty Ltd       
+                                                            Level 7, Building 2, 423 Pennant Hills Road  
+                                                            Pennant Hills  NSW  2120                     
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Marine Communications Limited                
+895000-895FFF                 (base 16)                     Marine Communications Limited                
+                                                            59, Bownham Park                             
+                                                            Stroud  Glos  GL5 5BZ                        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Persy Control Services B.v.                  
+865000-865FFF                 (base 16)                     Persy Control Services B.v.                  
+                                                            Veldoven 4a                                  
+                                                            Hendrik Ido Ambacht  Zuid Holland  3223PJ    
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Wireless Acquisition LLC                     
+858000-858FFF                 (base 16)                     Wireless Acquisition LLC                     
+                                                            1635 West 12th Place                         
+                                                            Tempe,  AZ  85281                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         SPJ Embedded Technologies Pvt. Ltd.          
+851000-851FFF                 (base 16)                     SPJ Embedded Technologies Pvt. Ltd.          
+                                                            101, Beaver Grandeur, Baner Road             
+                                                            Pune  Maharashtra  411045                    
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Grantronics Pty Ltd                          
+861000-861FFF                 (base 16)                     Grantronics Pty Ltd                          
+                                                            45 Monash Street                             
+                                                            Wentworthville  NSW  2145                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Xtensor Systems Inc.                         
+843000-843FFF                 (base 16)                     Xtensor Systems Inc.                         
+                                                            2624 Citronella Ct.                          
+                                                            Simi Valley  California  93063-2232          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+83F000-83FFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         hema electronic GmbH                         
+83C000-83CFFF                 (base 16)                     hema electronic GmbH                         
+                                                            Röntgenstraße 31                             
+                                                            Aalen  Baden-Württemberg  73431              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         T PROJE MUHENDISLIK DIS. TIC. LTD. STI.      
+838000-838FFF                 (base 16)                     T PROJE MUHENDISLIK DIS. TIC. LTD. STI.      
+                                                            RIHTIM CAD. NEMLIZADE SOK. DUYGU APT.        
+                                                            ISTANBUL    34716                            
+                                                            TR                                           
+
+00-50-C2                      (hex)                         VisualSonics Inc.                            
+845000-845FFF                 (base 16)                     VisualSonics Inc.                            
+                                                            3080 Yonge St                                
+                                                            Toronto  Ontario  M4N3N1                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Design Analysis Associates, Inc.             
+849000-849FFF                 (base 16)                     Design Analysis Associates, Inc.             
+                                                            75 West 100 South                            
+                                                            Logan  UT  84321                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+802000-802FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Selekron Microcontrol s.l.                   
+80F000-80FFFF                 (base 16)                     Selekron Microcontrol s.l.                   
+                                                            C/ Peru, 8                                   
+                                                            Guadalajara    19005                         
+                                                            ES                                           
+
+00-50-C2                      (hex)                         SLICAN sp. z o.o.                            
+828000-828FFF                 (base 16)                     SLICAN sp. z o.o.                            
+                                                            ul.M.Konopnickiej 18                         
+                                                            Bydgoszcz  Kujawsko-Pomorskie  85-124        
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Femto SA                                     
+812000-812FFF                 (base 16)                     Femto SA                                     
+                                                            Rue des Pres 137                             
+                                                            Biel/Bienne  BE  2503                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TESCAN, s.r.o.                               
+820000-820FFF                 (base 16)                     TESCAN, s.r.o.                               
+                                                            Libusina tr. 21                              
+                                                            Brno    623 00                               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Qtron Pty Ltd                                
+7FB000-7FBFFF                 (base 16)                     Qtron Pty Ltd                                
+                                                            Unit 3/59 Township Drive                     
+                                                            West Burleigh  Queensland  4219              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Karl DUNGS GmbH & Co. KG                     
+7F9000-7F9FFF                 (base 16)                     Karl DUNGS GmbH & Co. KG                     
+                                                            Siemensstrasse 6-10                          
+                                                            Urbach  BW  73660                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Empirix Italy S.p.A.                         
+7E6000-7E6FFF                 (base 16)                     Empirix Italy S.p.A.                         
+                                                            Via Giorgio Perlasca, 20                     
+                                                            Modena    41126                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Zeltiq Aesthetics, Inc.                      
+7E1000-7E1FFF                 (base 16)                     Zeltiq Aesthetics, Inc.                      
+                                                            4698 Willow Road                             
+                                                            Pleasanton  CA  94588                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines Ltd.               
+7EA000-7EAFFF                 (base 16)                     Monitor Business Machines Ltd.               
+                                                            PO Box 108 042                               
+                                                            Auckland                                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Newtec A/S                                   
+7D7000-7D7FFF                 (base 16)                     Newtec A/S                                   
+                                                            Stærmosegårdsvej  18                         
+                                                            Odense SV  Region Syd  5230                  
+                                                            DK                                           
+
+00-50-C2                      (hex)                         CEDAR Audio Limited                          
+7CA000-7CAFFF                 (base 16)                     CEDAR Audio Limited                          
+                                                            20 Home End                                  
+                                                            Cambridge    CB21 5BS                        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DSR Information Technologies Ltd.            
+7C2000-7C2FFF                 (base 16)                     DSR Information Technologies Ltd.            
+                                                            Fehérvári út. 50-52                          
+                                                            Budapest    1117                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         A.D.I Video technologies                     
+7B2000-7B2FFF                 (base 16)                     A.D.I Video technologies                     
+                                                            7 Hamarpe st,                                
+                                                            Jerusalem    45190                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Technovare Systems, Inc.                     
+7B9000-7B9FFF                 (base 16)                     Technovare Systems, Inc.                     
+                                                            1675 Scenic Avenue                           
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         InRay Solutions Ltd.                         
+7BB000-7BBFFF                 (base 16)                     InRay Solutions Ltd.                         
+                                                            125 Tzarigradsko shosse blvd.,               
+                                                            Sofia    1113                                
+                                                            BG                                           
+
+00-50-C2                      (hex)                         General Microsystems Sdn Bhd                 
+7AB000-7ABFFF                 (base 16)                     General Microsystems Sdn Bhd                 
+                                                            3-17, Jalan USJ 7/3B                         
+                                                            UEP Subang Jaya  Selangor D. E.  47610       
+                                                            MY                                           
+
+00-50-C2                      (hex)                         Tiefenbach Control Systems GmbH              
+797000-797FFF                 (base 16)                     Tiefenbach Control Systems GmbH              
+                                                            Brückenstraße 8                              
+                                                            Erlangen  Bayern  91056                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MiraTrek                                     
+79D000-79DFFF                 (base 16)                     MiraTrek                                     
+                                                            7985 Raytheon Road #200                      
+                                                            San Diego  CA  92111                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Benshaw Canada Controls, Inc.                
+79E000-79EFFF                 (base 16)                     Benshaw Canada Controls, Inc.                
+                                                            550 Bright Street                            
+                                                            Listowel  Ontario  N4W 3W3                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Guidance Navigation Limited                  
+7A7000-7A7FFF                 (base 16)                     Guidance Navigation Limited                  
+                                                            4 Dominus Way                                
+                                                            Leicester  Leicestershire  LE19 1RP          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         OMICRON electronics GmbH                     
+78B000-78BFFF                 (base 16)                     OMICRON electronics GmbH                     
+                                                            Oberes Ried 1                                
+                                                            Klaus    6833                                
+                                                            AT                                           
+
+00-50-C2                      (hex)                         LEVEL TELECOM                                
+78A000-78AFFF                 (base 16)                     LEVEL TELECOM                                
+                                                            Parque Empresarial NovoMilladoiro            
+                                                            Milladoiro - Ames  A Coruña  15895           
+                                                            ES                                           
+
+00-50-C2                      (hex)                         MedAvant Healthcare                          
+7A0000-7A0FFF                 (base 16)                     MedAvant Healthcare                          
+                                                            2533 Centennial Blvd                         
+                                                            Jeffersonville  IN  47130                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Turun Turvatekniikka Oy                      
+7AD000-7ADFFF                 (base 16)                     Turun Turvatekniikka Oy                      
+                                                            Orikedonkatu 22 B                            
+                                                            Turku    20380                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+765000-765FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         XtendWave                                    
+763000-763FFF                 (base 16)                     XtendWave                                    
+                                                            8111 LBJ Freeway                             
+                                                            Dallas  Texas  75251                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+786000-786FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Starling Advanced Communications             
+781000-781FFF                 (base 16)                     Starling Advanced Communications             
+                                                            2 Tavor House                                
+                                                            Yoqneam    20692                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         IQ Solutions GmbH & Co. KG                   
+780000-780FFF                 (base 16)                     IQ Solutions GmbH & Co. KG                   
+                                                            Gewerbepark 7A                               
+                                                            Bisssendorf  Niedersachsen  49143            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rosslare Enterprises Limited                 
+789000-789FFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay,  Kowloon                        
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Pointe Conception Medical Inc.               
+773000-773FFF                 (base 16)                     Pointe Conception Medical Inc.               
+                                                            121 East Mason Street                        
+                                                            Santa Barbara  California  93101             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digidrive Audio Limited                      
+76A000-76AFFF                 (base 16)                     Digidrive Audio Limited                      
+                                                            Spenglerstrasse 6                            
+                                                            Hamm  NRW  59067                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Gutermann Technology GmbH                    
+766000-766FFF                 (base 16)                     Gutermann Technology GmbH                    
+                                                            Gottlieb-Daimler-Strasse 10                  
+                                                            Ravensburg    88214                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Laserdyne Technologies                       
+775000-775FFF                 (base 16)                     Laserdyne Technologies                       
+                                                            PO Box 6541                                  
+                                                            GOLD COAST  QLD  9726                        
+                                                            AU                                           
+
+00-50-C2                      (hex)                         E S P Technologies Ltd                       
+757000-757FFF                 (base 16)                     E S P Technologies Ltd                       
+                                                            The Stables Deans Farm Estate                
+                                                            Fareham  Hampshire  SO30 2DX                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Chesapeake Sciences Corp                     
+756000-756FFF                 (base 16)                     Chesapeake Sciences Corp                     
+                                                            1127 B Benfield Blvd                         
+                                                            Millersville  MD  21108                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Teletek Electronics                          
+755000-755FFF                 (base 16)                     Teletek Electronics                          
+                                                            14A Srebarna Str.                            
+                                                            Sofia    1407                                
+                                                            BG                                           
+
+00-50-C2                      (hex)                         LOBER, S.A.                                  
+752000-752FFF                 (base 16)                     LOBER, S.A.                                  
+                                                            MARIA TUBAU, 4                               
+                                                            MADRID    28050                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DMT System S.p.A.                            
+75B000-75BFFF                 (base 16)                     DMT System S.p.A.                            
+                                                            Via Zanella 21                               
+                                                            Lissone  Milan  20035                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         e&s Engineering & Software GmbH              
+751000-751FFF                 (base 16)                     e&s Engineering & Software GmbH              
+                                                            Schmücker Straße 82a                         
+                                                            MANEBACH  Thueringen  D98693                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Realtronix Company                           
+746000-746FFF                 (base 16)                     Realtronix Company                           
+                                                            FLT A 16/F BLK 8 JUBILEE GARDEN              
+                                                                                                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Avonaco Systems, Inc.                        
+744000-744FFF                 (base 16)                     Avonaco Systems, Inc.                        
+                                                            A305, International Tech Park                
+                                                            Suzhou  Jiangsu  215021                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Elektro-Top 3000 Ltd.                        
+743000-743FFF                 (base 16)                     Elektro-Top 3000 Ltd.                        
+                                                            Bartók Béla út 75.                           
+                                                            Budapest    1114                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Miracom Technology Co., Ltd.                 
+738000-738FFF                 (base 16)                     Miracom Technology Co., Ltd.                 
+                                                            401, 4F. COREBUILDING, 8-1, SUNAE-DONG       
+                                                            SUNGNAM-SI  GYUNGGI-DO  463-825              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         SNCF EIM PAYS DE LOIRE                       
+72E000-72EFFF                 (base 16)                     SNCF EIM PAYS DE LOIRE                       
+                                                            2 AVENUE DE BRETAGNE                         
+                                                            LE MANS  SARTHE  72100                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CardioMEMS Inc.                              
+734000-734FFF                 (base 16)                     CardioMEMS Inc.                              
+                                                            75 Fifth St NW                               
+                                                            Atlanta  Ga  30308                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         HSC-Regelungstechnik GmbH                    
+724000-724FFF                 (base 16)                     HSC-Regelungstechnik GmbH                    
+                                                            An der Lehmkaute 13                          
+                                                            Bad Marienberg  Rheinland Pfalz  56470       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+725000-725FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PK INNOVATION CENTRE                  
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         McQuay China                                 
+740000-740FFF                 (base 16)                     McQuay China                                 
+                                                            Pinghu Village,Pinghu Town,Shenzhen,Guangdong Province,Peoples Republic of China
+                                                            Shenzhen  Guangdong  518111                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         The Dini Group, La Jolla inc.                
+704000-704FFF                 (base 16)                     The Dini Group, La Jolla inc.                
+                                                            7469 Draper Ave.                             
+                                                            La Jolla  CA  92037                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SPM Instrument AB                            
+702000-702FFF                 (base 16)                     SPM Instrument AB                            
+                                                            Box 504                                      
+                                                            Strängnäs    SE-64525                        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         SAE IT-systems GmbH & Co. KG                 
+703000-703FFF                 (base 16)                     SAE IT-systems GmbH & Co. KG                 
+                                                            Im Gewerbegebiet Pesch 14                    
+                                                            Köln  NRW  50767                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GEM-MED SL                                   
+700000-700FFF                 (base 16)                     GEM-MED SL                                   
+                                                            C/ Cartagena  245  5e  Of. 5-6               
+                                                            Barcelona    ES08025                         
+                                                            ES                                           
+
+00-50-C2                      (hex)                         3DX-Ray Limited                              
+713000-713FFF                 (base 16)                     3DX-Ray Limited                              
+                                                            Pera Innovation park                         
+                                                            Melton Mowbray  Leicestershire  LE13 0PB     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Zumbach Electronic AG                        
+70F000-70FFFF                 (base 16)                     Zumbach Electronic AG                        
+                                                            Hauptstrasse 93                              
+                                                            Orpund  Bern  2552                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Exertus                                      
+70C000-70CFFF                 (base 16)                     Exertus                                      
+                                                            Kampusranta 9                                
+                                                            Seinäjoki    FI-60320                        
+                                                            FI                                           
+
+00-50-C2                      (hex)                         DTech Labs Inc                               
+707000-707FFF                 (base 16)                     DTech Labs Inc                               
+                                                            22876 Shaw Road                              
+                                                            Sterling  VA  20166                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Acte Sp. z o.o.                              
+6FC000-6FCFFF                 (base 16)                     Acte Sp. z o.o.                              
+                                                            ul. Krancowa 49                              
+                                                            Warsaw    02-493                             
+                                                            PL                                           
+
+00-50-C2                      (hex)                         ennovatis GmbH                               
+719000-719FFF                 (base 16)                     ennovatis GmbH                               
+                                                            Dechwitzer Straße 11                         
+                                                            Großpösna  Sachsen  04463                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         L-3 Communications Mobile-Vision, Inc.       
+6DC000-6DCFFF                 (base 16)                     L-3 Communications Mobile-Vision, Inc.       
+                                                            90 Fanny Rd.                                 
+                                                            Boonton  NJ  07005                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         FIRSTEC SA                                   
+6EA000-6EAFFF                 (base 16)                     FIRSTEC SA                                   
+                                                            CH. DU PONT DU CENTENAIRE 108                
+                                                            PLAN LES OUATES  GENEVA  1228                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Harrison Audio, LLC                          
+6EB000-6EBFFF                 (base 16)                     Harrison Audio, LLC                          
+                                                            1024 Firestone Pkwy                          
+                                                            La Vergne  TN  37086                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Boeckeler Instruments, Inc.                  
+6E5000-6E5FFF                 (base 16)                     Boeckeler Instruments, Inc.                  
+                                                            4650 S. Butterfield Dr.                      
+                                                            Tucson  AZ  85714                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ace Axis Limited                             
+6E7000-6E7FFF                 (base 16)                     Ace Axis Limited                             
+                                                            602 Delta Business Park, Welton Road         
+                                                            Swindon    SN5 7XP                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Miros AS                                     
+6E3000-6E3FFF                 (base 16)                     Miros AS                                     
+                                                            Solbraaveien 20                              
+                                                            Asker  Akershus  1383                        
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Pneumopartners LaenneXT SA                   
+6EF000-6EFFFF                 (base 16)                     Pneumopartners LaenneXT SA                   
+                                                            91b route des Romains                        
+                                                            STRASBOURG  Région Alsace  F-67200           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Stanley Security Solutions, Inc.             
+6F0000-6F0FFF                 (base 16)                     Stanley Security Solutions, Inc.             
+                                                            14670 Cumberland Road                        
+                                                            Noblesville  IN  46060                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         FIRSTTRUST Co.,Ltd.                          
+6E0000-6E0FFF                 (base 16)                     FIRSTTRUST Co.,Ltd.                          
+                                                            2-10-25 Yokogawa-Cho                         
+                                                            Hiroshima    733-0011                        
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Cryogenic Control Systems, Inc.              
+6F4000-6F4FFF                 (base 16)                     Cryogenic Control Systems, Inc.              
+                                                            PO Box 7012                                  
+                                                            Rancho Santa Fe  CA  92067-7012              
+                                                            US                                           
+
+00-50-C2                      (hex)                         BL Healthcare, Inc.                          
+6D8000-6D8FFF                 (base 16)                     BL Healthcare, Inc.                          
+                                                            33 Commercial Street                         
+                                                            Foxboro  MA  02035                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ajeco Oy                                     
+6D9000-6D9FFF                 (base 16)                     Ajeco Oy                                     
+                                                            Koronakatu 1A                                
+                                                            Espoo  Uusimaa  Fi-02210 Esp                 
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Ifox - Industria e Comercio Ltda             
+6AA000-6AAFFF                 (base 16)                     Ifox - Industria e Comercio Ltda             
+                                                            Rua Chico Pontes, 329                        
+                                                            São Paulo  São Paulo  02067-000              
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Etani Electronics Co.,Ltd.                   
+6D4000-6D4FFF                 (base 16)                     Etani Electronics Co.,Ltd.                   
+                                                            1-10-15,Ohmori-Honcho,                       
+                                                            Ohta-ku,  Tokyo  143-0011                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         iTRACS Corporation                           
+6C3000-6C3FFF                 (base 16)                     iTRACS Corporation                           
+                                                            1501 W. Fountainhead Parkway                 
+                                                            Tempe  AZ  85282                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mitron Oy                                    
+6BD000-6BDFFF                 (base 16)                     Mitron Oy                                    
+                                                            P.O. Box 113                                 
+                                                            FORSSA  HÄME  FIN-30101                      
+                                                            FI                                           
+
+00-50-C2                      (hex)                         RADIUS Sweden AB                             
+6C1000-6C1FFF                 (base 16)                     RADIUS Sweden AB                             
+                                                            Tennv. 1                                     
+                                                            Karlskrona    371 50                         
+                                                            SE                                           
+
+00-50-C2                      (hex)                         SOMESCA                                      
+6B4000-6B4FFF                 (base 16)                     SOMESCA                                      
+                                                            80 rue Jean Jaurès                           
+                                                            BOIS-COLOMBES    92270                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Dynamic Hearing Pty Ltd                      
+6CA000-6CAFFF                 (base 16)                     Dynamic Hearing Pty Ltd                      
+                                                            2 Chapel Street                              
+                                                            Richmond  VIC  3121                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         REXXON GmbH                                  
+6C4000-6C4FFF                 (base 16)                     REXXON GmbH                                  
+                                                            Zum Kesselort 53                             
+                                                            Kiel  Schleswig-Holstein  24149              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Casabyte Inc.                                
+696000-696FFF                 (base 16)                     Casabyte Inc.                                
+                                                            POB 10127                                    
+                                                            Blacksburg  VA  24062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bug Labs, Inc.                               
+69C000-69CFFF                 (base 16)                     Bug Labs, Inc.                               
+                                                            915 Broadway                                 
+                                                            New York  NY  10010                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         GHL Systems Berhad                           
+690000-690FFF                 (base 16)                     GHL Systems Berhad                           
+                                                            L5-E-7B, Enterprise 4                        
+                                                            Kuala Lumpur  Wilayah  57000                 
+                                                            MY                                           
+
+00-50-C2                      (hex)                         BERTRONIC SRL                                
+68F000-68FFFF                 (base 16)                     BERTRONIC SRL                                
+                                                            VIA SILVIO PELLICO 26                        
+                                                            STEZZANO  BERGAMO  24040                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Zhuhai Jiahe Electronics Co.,LTD             
+68A000-68AFFF                 (base 16)                     Zhuhai Jiahe Electronics Co.,LTD             
+                                                            8/F,BlockA,Tsinghua Science Park,101 College Road,TangJia
+                                                            Zhuahi  Guangdong  519080                    
+                                                            CN                                           
+
+00-50-C2                      (hex)                         CreaTech Electronics Co.                     
+6A3000-6A3FFF                 (base 16)                     CreaTech Electronics Co.                     
+                                                            6126 Carlisle Ln.                            
+                                                            League City  TX  77573                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tsien (UK) Ltd                               
+69B000-69BFFF                 (base 16)                     Tsien (UK) Ltd                               
+                                                            Zion Building                                
+                                                            Chatteris  Cambs  PE16 6AE                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+67F000-67FFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         VTZ d.o.o.                                   
+65C000-65CFFF                 (base 16)                     VTZ d.o.o.                                   
+                                                            Koprska 96                                   
+                                                            Ljubljana    1000                            
+                                                            SI                                           
+
+00-50-C2                      (hex)                         IZISOFT                                      
+660000-660FFF                 (base 16)                     IZISOFT                                      
+                                                            1116 Hanshin IT Tower 235                    
+                                                            Seoul    152-768                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         MONYTEL S.A.                                 
+657000-657FFF                 (base 16)                     MONYTEL S.A.                                 
+                                                            Estrada dos Romeiros Km 38,5 n.162           
+                                                            Santana de Parnaiba  São Paulo  06501001     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Westel Wireless Systems                      
+664000-664FFF                 (base 16)                     Westel Wireless Systems                      
+                                                            Level 5, 25 Bligh St                         
+                                                            Sydney  NSW  2000                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         COE Limited                                  
+663000-663FFF                 (base 16)                     COE Limited                                  
+                                                            Photon House                                 
+                                                            Leeds  West Yorkshire  LS12 1EG              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Industrial Vacuum Systems                    
+679000-679FFF                 (base 16)                     Industrial Vacuum Systems                    
+                                                            3974 Linden Avenue SE                        
+                                                            Grand Rapids  Michigan  49548                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+668000-668FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         flsystem                                     
+66B000-66BFFF                 (base 16)                     flsystem                                     
+                                                            Rm911,RegentOfficetel,547-8,Kuui-dong,Kwangjjin-gu
+                                                            seoul    143-709                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Dorsett Technologies, Inc.                   
+659000-659FFF                 (base 16)                     Dorsett Technologies, Inc.                   
+                                                            100 Woodlyn Drive                            
+                                                            Yadkinville  North Carolina  27055           
+                                                            US                                           
+
+00-50-C2                      (hex)                         T2 Communication Ltd                         
+63E000-63EFFF                 (base 16)                     T2 Communication Ltd                         
+                                                            Unit A, Wellfleet Industrial Park            
+                                                            Birmingham  West Midlands  B25 8LH           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         CIS Corporation                              
+64C000-64CFFF                 (base 16)                     CIS Corporation                              
+                                                            539-5, Higashiasakawa-machi                  
+                                                            Hachioji-shi  Tokyo  193-0834                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         The Software Group Limited                   
+645000-645FFF                 (base 16)                     The Software Group Limited                   
+                                                            11 Pemberton Lane                            
+                                                            Shanty Bay  Ontario  L0L 2L0                 
+                                                            CA                                           
+
+00-50-C2                      (hex)                         R&D Technology Solutionz Limited             
+647000-647FFF                 (base 16)                     R&D Technology Solutionz Limited             
+                                                            1st Floor                                    
+                                                            Palmerston North  Manawatu  4440             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Sohon Inc                                    
+634000-634FFF                 (base 16)                     Sohon Inc                                    
+                                                            4-12-13-201 chigasaki-minami                 
+                                                            yokohama  kanagawa-prf  224-0037             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Wideco Sweden AB                             
+652000-652FFF                 (base 16)                     Wideco Sweden AB                             
+                                                            Företagsgatan 7                              
+                                                            Borås  Viared  50494                         
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Axis Electronics                             
+615000-615FFF                 (base 16)                     Axis Electronics                             
+                                                            Bedford Heights,                             
+                                                            Bedford  Bedfordshire  MK41 7NY              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Communication Components Inc.                
+61A000-61AFFF                 (base 16)                     Communication Components Inc.                
+                                                            89 Leuning Street                            
+                                                            South Hackensack  NJ  07606                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Winsys Informatica ltda                      
+626000-626FFF                 (base 16)                     Winsys Informatica ltda                      
+                                                            rua luis goes , 672                          
+                                                            São Paulo    04043-050                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Imagine Communications                       
+61F000-61FFFF                 (base 16)                     Imagine Communications                       
+                                                            45 Hamelacha St. P.O.Box 8447                
+                                                            Netanya    42504                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         All-Systems Electronics Pty Ltd              
+5FB000-5FBFFF                 (base 16)                     All-Systems Electronics Pty Ltd              
+                                                            16 Hope Street                               
+                                                            SEVEN HILLS  New South Wales  2147           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Metrologic Group                             
+5F7000-5F7FFF                 (base 16)                     Metrologic Group                             
+                                                            6 ch du vieux chêne                          
+                                                            Meylan  Isère  38700                         
+                                                            FJ                                           
+
+00-50-C2                      (hex)                         POSNET Polska S.A.                           
+5F3000-5F3FFF                 (base 16)                     POSNET Polska S.A.                           
+                                                            ul. Municypalna 33                           
+                                                            Warszawa    02-281                           
+                                                            PL                                           
+
+00-50-C2                      (hex)                         IDENTIC AB                                   
+60C000-60CFFF                 (base 16)                     IDENTIC AB                                   
+                                                            Box 143                                      
+                                                            Vallentuna    18630                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Gnutek Ltd.                                  
+5DF000-5DFFFF                 (base 16)                     Gnutek Ltd.                                  
+                                                            3, Strathavon Close,                         
+                                                            Cranleigh  Surrey  GU6 8PW                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Meucci Solutions                             
+5D1000-5D1FFF                 (base 16)                     Meucci Solutions                             
+                                                            Bellevue 5                                   
+                                                            Gent Ledeberg  Oost Vlaanderen  B9050        
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Micro Technology Services Inc.               
+5E9000-5E9FFF                 (base 16)                     Micro Technology Services Inc.               
+                                                            1819 Firman Drive                            
+                                                            Richardson  Texas  75081                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wexiodisk AB                                 
+5D3000-5D3FFF                 (base 16)                     Wexiodisk AB                                 
+                                                            Mardvagen 4                                  
+                                                            Vaxjo  Kronoberg  352 45                     
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Micro Elektronische Producten                
+5EA000-5EAFFF                 (base 16)                     Micro Elektronische Producten                
+                                                            Noordeinde 124F                              
+                                                            Landsmeer  NH  1121AL                        
+                                                            NL                                           
+
+00-50-C2                      (hex)                         TECHNIFOR SAS                                
+5D8000-5D8FFF                 (base 16)                     TECHNIFOR SAS                                
+                                                            114 QUAI DU RHONE                            
+                                                            MIRIBEL  RHONE-ALPES  01708                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Pyott-Boone Electronics                      
+5C0000-5C0FFF                 (base 16)                     Pyott-Boone Electronics                      
+                                                            P. O. Box 809                                
+                                                            Tazewell  VA  24651                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Shenzhen Quanlong Technique Co.Ltd           
+5C9000-5C9FFF                 (base 16)                     Shenzhen Quanlong Technique Co.Ltd           
+                                                            No.215, Building Langfeng, Road Kefa no.2    
+                                                              Hong Kong  25175 852                       
+                                                            CN                                           
+
+00-50-C2                      (hex)                         WestfaliaSurge GmbH                          
+5B8000-5B8FFF                 (base 16)                     WestfaliaSurge GmbH                          
+                                                            Siemenstr.25-27                              
+                                                            Boenen  NRW  59199                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         INCOTEC GmbH                                 
+5B0000-5B0FFF                 (base 16)                     INCOTEC GmbH                                 
+                                                            Blomestrasse 25 - 27                         
+                                                            Bielefeld  NRW  33609                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Emcom Systems                                
+5AD000-5ADFFF                 (base 16)                     Emcom Systems                                
+                                                            127 Route 206 South, Suite 27                
+                                                            Trenton  New Jersey  08610                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Innomed Medical Inc                          
+5CF000-5CFFFF                 (base 16)                     Innomed Medical Inc                          
+                                                            Szabó József utca 12                         
+                                                            Budapest    1146                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Techimp Systems S.r.l.                       
+5BF000-5BFFFF                 (base 16)                     Techimp Systems S.r.l.                       
+                                                            Via Toscana, 11/C                            
+                                                            Zola Predosa  Bologna  40069                 
+                                                            IT                                           
+
+00-50-C2                      (hex)                         RAFAEL                                       
+5B5000-5B5FFF                 (base 16)                     RAFAEL                                       
+                                                            P.O.B. 2250                                  
+                                                            HAIFA                                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Equipos de Telecomunicación  Optoelectronicos, S.A.
+5A5000-5A5FFF                 (base 16)                     Equipos de Telecomunicación  Optoelectronicos, S.A.
+                                                            Poligono Malpica G. Quejido, 74              
+                                                            Zaragoza    50007                            
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Federal State Unitary Enterprise Experimental Factory for Sc
+5A4000-5A4FFF                 (base 16)                     Federal State Unitary Enterprise Experimental Factory for Sc
+                                                            EZAN, Academician Semenov Avenue, 9,         
+                                                            Chernogolovka  Moscow Region  142432         
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Rudolph Technologies, Inc.                   
+5A0000-5A0FFF                 (base 16)                     Rudolph Technologies, Inc.                   
+                                                            4900 West 78th Street                        
+                                                            Bloomington  MN  55435                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Genetix Ltd                                  
+586000-586FFF                 (base 16)                     Genetix Ltd                                  
+                                                            Queensway                                    
+                                                            New Milton  Hampshire  BH25 5NN              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ETAP NV                                      
+5A8000-5A8FFF                 (base 16)                     ETAP NV                                      
+                                                            Antwerpsesteenweg 130                        
+                                                            Malle  Antwerp  2390                         
+                                                            BE                                           
+
+00-50-C2                      (hex)                         ubinetsys.co..ltd                            
+566000-566FFF                 (base 16)                     ubinetsys.co..ltd                            
+                                                            3F Sang-gal B.D,220-3                        
+                                                            Yongin-Si  Gyunggi-Do  449-905               
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Visi-tech Systems Ltd                        
+576000-576FFF                 (base 16)                     Visi-tech Systems Ltd                        
+                                                            Unit X Cerphilly Bus Pk                      
+                                                            Caerphilly  Mid Glamorgan  CF83 3ED          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Ellex Medical Pty Ltd                        
+570000-570FFF                 (base 16)                     Ellex Medical Pty Ltd                        
+                                                            82 Gilbert Street                            
+                                                            Adelaide  South Australia  5000              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Oberon Service srl                           
+571000-571FFF                 (base 16)                     Oberon Service srl                           
+                                                            Via Meda 28                                  
+                                                            Milan  MI  20141                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Fail Safe Solutions LLC                      
+559000-559FFF                 (base 16)                     Fail Safe Solutions LLC                      
+                                                            950 Salem Ave.                               
+                                                            Hillside  NJ  07205                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Netcomsec Co Ltd                             
+557000-557FFF                 (base 16)                     Netcomsec Co Ltd                             
+                                                            10 Nisshinco 2-chome                         
+                                                            Fuchu City  Tokyo  253-0197                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+55D000-55DFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Valde Systems, Inc.                          
+55A000-55AFFF                 (base 16)                     Valde Systems, Inc.                          
+                                                            26 Iron Works Ln                             
+                                                            Brookline  NH  03033                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         LJU Automatisierungstechnik GmbH             
+550000-550FFF                 (base 16)                     LJU Automatisierungstechnik GmbH             
+                                                            Am Schlahn 1                                 
+                                                            Potsdam  Brandenburg  D-14476                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         C2 DIAGNOSTICS                               
+536000-536FFF                 (base 16)                     C2 DIAGNOSTICS                               
+                                                            Parc Euromedecine II                         
+                                                            MONTPELLIER Cedex5  Herault  34099           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Detection Technology Inc.                    
+539000-539FFF                 (base 16)                     Detection Technology Inc.                    
+                                                            Micropolis                                   
+                                                            Ii    91100                                  
+                                                            FI                                           
+
+00-50-C2                      (hex)                         DST CONTROL AB                               
+537000-537FFF                 (base 16)                     DST CONTROL AB                               
+                                                            Akerbogatan 10                               
+                                                            Linköping    58254                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         I.T.W. Betaprint                             
+548000-548FFF                 (base 16)                     I.T.W. Betaprint                             
+                                                            Ponce de Leon  4                             
+                                                            Sant Just Desvern  Barcelona  08960          
+                                                            ES                                           
+
+00-50-C2                      (hex)                         NanShanBridge Co.Ltd                         
+533000-533FFF                 (base 16)                     NanShanBridge Co.Ltd                         
+                                                            C241, National Hi-Tech(westzone)             
+                                                            ChengDu  SiChuan  611731                     
+                                                            CN                                           
+
+00-50-C2                      (hex)                         SecuInfo Co., Ltd.                           
+545000-545FFF                 (base 16)                     SecuInfo Co., Ltd.                           
+                                                            1411, Kranz Techno, 5442-1,                  
+                                                            Seongnam-si  Gyeonggi-do  462729             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Mesure Controle Commande                     
+540000-540FFF                 (base 16)                     Mesure Controle Commande                     
+                                                            Rue Guillaume MASSICOT                       
+                                                            ISSOUDUN  CENTRE  36100                      
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Solid State Logic                            
+517000-517FFF                 (base 16)                     Solid State Logic                            
+                                                            25 Springhill Road                           
+                                                            Oxford  Oxfordshire  OX5 1RU                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Traquair Data Systems, Inc.                  
+51F000-51FFFF                 (base 16)                     Traquair Data Systems, Inc.                  
+                                                            114 Sheldon Rd                               
+                                                            Ithaca  NY  14850                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Alcon Technologies                           
+51E000-51EFFF                 (base 16)                     Alcon Technologies                           
+                                                            11201 Hampshire Ave. South                   
+                                                            Bloomington  MN  55438                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         SpeasTech, Inc.                              
+51A000-51AFFF                 (base 16)                     SpeasTech, Inc.                              
+                                                            1527 S. Bowman Road                          
+                                                            Little Rock  Arkansas  72211                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         AMRDEC Prototype Integration Facility        
+523000-523FFF                 (base 16)                     AMRDEC Prototype Integration Facility        
+                                                            SES INC. AMSRD-AMR-SE-PI                     
+                                                            REDSTONE ARSENAL  AL  35898                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Innovation, Institute, Inc                   
+530000-530FFF                 (base 16)                     Innovation, Institute, Inc                   
+                                                            P.O. Box 9359                                
+                                                            Caguas  Puerto Rico  00726-9359              
+                                                            PR                                           
+
+00-50-C2                      (hex)                         NVE Corporation                              
+532000-532FFF                 (base 16)                     NVE Corporation                              
+                                                            11409 Valley View Road                       
+                                                            Eden Prairie  MN  55344-3617                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Motec Pty Ltd                                
+524000-524FFF                 (base 16)                     Motec Pty Ltd                                
+                                                            121 Merrindale Drive                         
+                                                            Croydon South  Victoria  3136                
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Tantronic AG                                 
+4F2000-4F2FFF                 (base 16)                     Tantronic AG                                 
+                                                            Allmendweg 5                                 
+                                                            Zufikon  AG  5621                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Tadian Electronics Systems LTD               
+514000-514FFF                 (base 16)                     Tadian Electronics Systems LTD               
+                                                            Hamerkava 29                                 
+                                                            Holon    58101                               
+                                                            IL                                           
+
+00-50-C2                      (hex)                         7+ Kft                                       
+506000-506FFF                 (base 16)                     7+ Kft                                       
+                                                            Homoród 17                                  
+                                                            Budapest  magyarország  1118                
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Genie Network Resource Management Inc.       
+513000-513FFF                 (base 16)                     Genie Network Resource Management Inc.       
+                                                            5F., No. 150, Lane 360,                      
+                                                            Taipei city    114                           
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Summit Developmen                            
+510000-510FFF                 (base 16)                     Summit Developmen                            
+                                                            Karlstejnska 162                             
+                                                            Orech  Jinocany  25225                       
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         REAL D                                       
+4F6000-4F6FFF                 (base 16)                     REAL D                                       
+                                                            100 N. CRESCENT DR. #120                     
+                                                            BEVERLY HILLS  CA  90210                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Hwayoung RF Solution Inc                     
+4FC000-4FCFFF                 (base 16)                     Hwayoung RF Solution Inc                     
+                                                            152-050 514, Woolim e-BIZ Center, 170-5      
+                                                              Seoul  152-050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Telematrix                                   
+4E0000-4E0FFF                 (base 16)                     Telematrix                                   
+                                                            2948 Woodside Terrace                        
+                                                            Fremont  Ca.  94539                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Avantry Ltd.                                 
+4D8000-4D8FFF                 (base 16)                     Avantry Ltd.                                 
+                                                            New Industrial Park, Bldg 7A                 
+                                                            Yokneam  Israel  20692                       
+                                                            IL                                           
+
+00-50-C2                      (hex)                         SS Telecoms CC                               
+4E1000-4E1FFF                 (base 16)                     SS Telecoms CC                               
+                                                            23 Botha Avenue                              
+                                                            Lyttelton  Gauteng  0157                     
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Thermo Electron                              
+4DF000-4DFFFF                 (base 16)                     Thermo Electron                              
+                                                            9303 W. Sam Houston Parkway South            
+                                                            Houston  TX  77099                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         HEINEN ELEKTRONIK GmbH                       
+4AA000-4AAFFF                 (base 16)                     HEINEN ELEKTRONIK GmbH                       
+                                                            Hunsrückstraße 7                             
+                                                            HAAN  NRW  42781                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CYJAYA Korea                                 
+4A8000-4A8FFF                 (base 16)                     CYJAYA Korea                                 
+                                                            1209, Manhattan21 Livingtel, Yoido-dong      
+                                                            Seoul    150-870                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Neets                                        
+4C8000-4C8FFF                 (base 16)                     Neets                                        
+                                                            Langballe 4                                  
+                                                            Horsens    8700                              
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Saia Burgess Controls AG                     
+4BC000-4BCFFF                 (base 16)                     Saia Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  Freiburg  3280                       
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Cloanto Corporation                          
+490000-490FFF                 (base 16)                     Cloanto Corporation                          
+                                                            P.O. Box 27740                               
+                                                            Las Vegas  NV  89126-7740                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Driver Information Technology GmbH  
+497000-497FFF                 (base 16)                     Advanced Driver Information Technology GmbH  
+                                                            Robert Bosch Strasse 200                     
+                                                            Hildesheim  .  31139                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         VAZA Elektronik AB                           
+495000-495FFF                 (base 16)                     VAZA Elektronik AB                           
+                                                            Furuheds vagen 1                             
+                                                            Kalix  Norrbotten  952 31                    
+                                                            SE                                           
+
+00-50-C2                      (hex)                         DA SISTEMI SPA                               
+488000-488FFF                 (base 16)                     DA SISTEMI SPA                               
+                                                            Via Cadorna, 73                              
+                                                            Vimodrone  Milano  20090                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Eridon Corporation                           
+487000-487FFF                 (base 16)                     Eridon Corporation                           
+                                                            901 Twelve Oaks Center Drive                 
+                                                            Wayzata  MN  55391                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         BUYANG ELECTRONICS INDUSTRIAL CO., LTD.      
+4A6000-4A6FFF                 (base 16)                     BUYANG ELECTRONICS INDUSTRIAL CO., LTD.      
+                                                            ORYU-DONG                                    
+                                                            INCHEON    434-140                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Acutelogic Corporation                       
+496000-496FFF                 (base 16)                     Acutelogic Corporation                       
+                                                            3-7-1                                        
+                                                            Chiyoda-ku  Tokyo  101-0052                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Cybectec inc.                                
+470000-470FFF                 (base 16)                     Cybectec inc.                                
+                                                            730 Commerciale St.                          
+                                                            Saint-Jean-Chrysostome  Quebec  G6Z 2C5      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Paul Scherrer Institut (PSI)                 
+46D000-46DFFF                 (base 16)                     Paul Scherrer Institut (PSI)                 
+                                                            WHGA/U130                                    
+                                                            Villigen-PSI  Aargau  CH-5232                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         EASYTECH GmbH                                
+46B000-46BFFF                 (base 16)                     EASYTECH GmbH                                
+                                                            Sommerauerstr.18                             
+                                                            St.Georgen  BW  78112                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SELKOM GmbH                                  
+480000-480FFF                 (base 16)                     SELKOM GmbH                                  
+                                                            Jahnstraße 4                                 
+                                                            Muggensturm  Baden-Württemberg  76461        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Pitney Bowes, Inc                            
+47B000-47BFFF                 (base 16)                     Pitney Bowes, Inc                            
+                                                            35 Waterview Drive                           
+                                                            Shelton  CT  06484                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Halliburton - Sperry Drilling Service        
+45E000-45EFFF                 (base 16)                     Halliburton - Sperry Drilling Service        
+                                                            3000 N. Sam Houston Pkwy E.                  
+                                                            Houston  TX  77032                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vitelnet                                     
+460000-460FFF                 (base 16)                     Vitelnet                                     
+                                                            221 Elizabeth St                             
+                                                            Utica  NY  13501                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         TATTILE SRL                                  
+461000-461FFF                 (base 16)                     TATTILE SRL                                  
+                                                            VIA TRENTO 127/129                           
+                                                              BRESCIA  25020                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         T2C Marketing AB                             
+45F000-45FFFF                 (base 16)                     T2C Marketing AB                             
+                                                            Sjovagen 1                                   
+                                                            Upplands Vasby  Stockholm  194 67            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Peleton Photonic Systems                     
+439000-439FFF                 (base 16)                     Peleton Photonic Systems                     
+                                                            2355 St. Laurent BLVD                        
+                                                            Ottawa  Ontario  K1G 6C3                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Coppercom                                    
+43E000-43EFFF                 (base 16)                     Coppercom                                    
+                                                            3600 FAU Blvd                                
+                                                            Boca Raton  Florida  33431                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Solace Systems, Inc.                         
+44B000-44BFFF                 (base 16)                     Solace Systems, Inc.                         
+                                                            555 Legget Drive                             
+                                                            Kanata  Ontario  K2K 2X3                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Comtech Systems Inc.                         
+448000-448FFF                 (base 16)                     Comtech Systems Inc.                         
+                                                            2900 Titan Row                               
+                                                            Orlando  Florida  32809                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Micro Technic A-S                            
+446000-446FFF                 (base 16)                     Micro Technic A-S                            
+                                                            Smedevaenget 5                               
+                                                            Aarup    5560                                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         ImperativeNetworks                           
+434000-434FFF                 (base 16)                     ImperativeNetworks                           
+                                                            Hatamar 2                                    
+                                                            Yokneam    20692                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+42A000-42AFFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         LogiM GmbH Software und Entwicklung          
+41B000-41BFFF                 (base 16)                     LogiM GmbH Software und Entwicklung          
+                                                            Mahonienweg 22b                              
+                                                            Berlin    12437                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Mecsel Oy                                    
+419000-419FFF                 (base 16)                     Mecsel Oy                                    
+                                                            Soittajantie 1                               
+                                                            Helsinki    FI-00420                         
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Planea Oy                                    
+418000-418FFF                 (base 16)                     Planea Oy                                    
+                                                            Lantinen Pitkakatu 23A                       
+                                                            Turku    20100                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         TSB Solutions Inc.                           
+412000-412FFF                 (base 16)                     TSB Solutions Inc.                           
+                                                            5399 Eglinton Ave West.                      
+                                                            Toronto  Ontario  M9C 5K6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+40E000-40EFFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            DE                                           
+
+00-50-C2                      (hex)                         KTEC LTD                                     
+409000-409FFF                 (base 16)                     KTEC LTD                                     
+                                                            13 Giborei Israel ST                         
+                                                            Netanya    P.O BOX 8709                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         3D perception                                
+3DC000-3DCFFF                 (base 16)                     3D perception                                
+                                                            PO Box 455                                   
+                                                            Asker    N-1373                              
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Micro-Robotics Limited                       
+3D0000-3D0FFF                 (base 16)                     Micro-Robotics Limited                       
+                                                            135 Ditton Walk                              
+                                                            CAMBRIDGE  Cambs.  CB5 8QB                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         American LED-gible Inc.                      
+3D3000-3D3FFF                 (base 16)                     American LED-gible Inc.                      
+                                                            1776 Lone Eagle St.                          
+                                                            Columbus  Ohio  43228                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sintium Ltd                                  
+3F9000-3F9FFF                 (base 16)                     Sintium Ltd                                  
+                                                            PO Box 14-273                                
+                                                            Auckland    1134                             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Phaedrus Limited                             
+3F5000-3F5FFF                 (base 16)                     Phaedrus Limited                             
+                                                            5 Marsh House Mill                           
+                                                            Darwen  Lancashire  BB3 3JJ                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ISS International                            
+3EB000-3EBFFF                 (base 16)                     ISS International                            
+                                                            P.O Box 12063                                
+                                                            Stellenbosch  Western Cape  7613             
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Conformative Systems, Inc.                   
+3E8000-3E8FFF                 (base 16)                     Conformative Systems, Inc.                   
+                                                            4516 Seton Center Parkway                    
+                                                            Austin  TX  78759                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         4g Technologies, L.P.                        
+3C3000-3C3FFF                 (base 16)                     4g Technologies, L.P.                        
+                                                            1900 Industrial Blvd.                        
+                                                            Colleyville  TX  76034                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Micro-Measurements                           
+3CD000-3CDFFF                 (base 16)                     Micro-Measurements                           
+                                                            961 Wendell Blvd                             
+                                                            Wendell  NC  27591                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dilax Intelcom AG                            
+3C9000-3C9FFF                 (base 16)                     Dilax Intelcom AG                            
+                                                            Fidlerstr. 2                                 
+                                                            Ermatingen  Thurgau  8272                    
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Net Optics                                   
+3C6000-3C6FFF                 (base 16)                     Net Optics                                   
+                                                            5303 Betsy Ross Drive                        
+                                                            Santa Clara  California  95054               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Media Lab., Inc.                             
+3B3000-3B3FFF                 (base 16)                     Media Lab., Inc.                             
+                                                            3-6-7 Sotokanda Chiyoda-ku                   
+                                                            Tokyo    101-0021                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Gilbarco Autotank AB                         
+3B9000-3B9FFF                 (base 16)                     Gilbarco Autotank AB                         
+                                                            P.O. Box 11059                               
+                                                            BROMMA    SE-16111                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Exavio Inc.                                  
+389000-389FFF                 (base 16)                     Exavio Inc.                                  
+                                                            3121 Jay Street                              
+                                                            Santa Clara  California  95054               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Realtime Engineering AG                      
+381000-381FFF                 (base 16)                     Realtime Engineering AG                      
+                                                            Rickenbacherstr. 29                          
+                                                            Gelterkinden  BL  4460                       
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Precision System Science Co.,Ltd             
+386000-386FFF                 (base 16)                     Precision System Science Co.,Ltd             
+                                                            88                                           
+                                                            Kamihongou,Matsudo-shi  Chiba  271-0064      
+                                                            JP                                           
+
+00-50-C2                      (hex)                         IntelliDesign Pty Ltd                        
+3A6000-3A6FFF                 (base 16)                     IntelliDesign Pty Ltd                        
+                                                            99 Bluestone Circuit                         
+                                                            Seventeen Mile Rocks  Queensland  4076       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Jobin Yvon,Inc                               
+35E000-35EFFF                 (base 16)                     Jobin Yvon,Inc                               
+                                                            3880 Park Ave                                
+                                                            Edison  NJ  08820                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         F.Imm. S.r.L.                                
+35F000-35FFFF                 (base 16)                     F.Imm. S.r.L.                                
+                                                            Viale delle Industrie 13/a                   
+                                                            ROVIGO  RO  45100                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         VLSIP TECHNOLOGIES, INC                      
+35B000-35BFFF                 (base 16)                     VLSIP TECHNOLOGIES, INC                      
+                                                            750 PRESIDENTIAL DR                          
+                                                            RICHARDSON  TEXAS  75081                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Minicom Advanced Systems Ltd                 
+36E000-36EFFF                 (base 16)                     Minicom Advanced Systems Ltd                 
+                                                            16 Hartom str                                
+                                                            Jerusalem    91450                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Septentrio nv/sa                             
+363000-363FFF                 (base 16)                     Septentrio nv/sa                             
+                                                            Ubicenter                                    
+                                                            Leuven    BE-3001                            
+                                                            BE                                           
+
+00-50-C2                      (hex)                         SkipJam                                      
+33C000-33CFFF                 (base 16)                     SkipJam                                      
+                                                            386 North Street                             
+                                                            Greenwich  CT  06830                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+344000-344FFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstrasse 14                         
+                                                            Leinfelden-Echterdingen  BW  70771           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         St. Michael Strategies                       
+342000-342FFF                 (base 16)                     St. Michael Strategies                       
+                                                            701, Salaberry                               
+                                                            Chambly  Quebec  J3L 1R2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ACT                                          
+345000-345FFF                 (base 16)                     ACT                                          
+                                                            Unit C1, South City Business Center          
+                                                            Tallaght  Dublin                             
+                                                            IE                                           
+
+00-50-C2                      (hex)                         biokeysystem                                 
+346000-346FFF                 (base 16)                     biokeysystem                                 
+                                                            2f, 170-13, guro3-dong, guro-gu              
+                                                            seoul    152-847                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Finesystem Co., Ltd                          
+351000-351FFF                 (base 16)                     Finesystem Co., Ltd                          
+                                                            FINE BLDG. 2F                                
+                                                            HACHIOUJI  TOKYO-TO  192-0032                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Ernitec A/S                                  
+338000-338FFF                 (base 16)                     Ernitec A/S                                  
+                                                            Hoerkaer 24                                  
+                                                            Herlev    2730                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Radix Corporation                            
+333000-333FFF                 (base 16)                     Radix Corporation                            
+                                                            4855 Wiley Post Way                          
+                                                            Salt Lake City  Utah  84116                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         UNIONDIGITAL.,CO.LTD                         
+307000-307FFF                 (base 16)                     UNIONDIGITAL.,CO.LTD                         
+                                                            34F,TM21,546-4 Gueui-dong,                   
+                                                              Seoul  143-721                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Rackmaster Systems, Inc.                     
+309000-309FFF                 (base 16)                     Rackmaster Systems, Inc.                     
+                                                            5244 Valley Industrial Blvd. S.              
+                                                            Shakopee  MN  55379                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Navionics S.p.A.                             
+326000-326FFF                 (base 16)                     Navionics S.p.A.                             
+                                                            via Vespucci 289                             
+                                                            Viareggio  Lucca  I-55049                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Digicontrole Lda                             
+30F000-30FFFF                 (base 16)                     Digicontrole Lda                             
+                                                            Av. Eng. Arantes e Oliveira N°5 2° D         
+                                                            Lisboa    1900-221 LIS                       
+                                                            PT                                           
+
+00-50-C2                      (hex)                         SETARAM                                      
+30D000-30DFFF                 (base 16)                     SETARAM                                      
+                                                            7 Rue de l'oratoire                          
+                                                            CALUIRE  rhone  69300                        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CYBERTRON CO., LTD.                          
+310000-310FFF                 (base 16)                     CYBERTRON CO., LTD.                          
+                                                            14F Hansihn IT Tower #235 Guro-Dong Guro-gu  
+                                                            Seoul    152-050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Imax                                         
+329000-329FFF                 (base 16)                     Imax                                         
+                                                            2525 Speakman Drive                          
+                                                            Mississauga  Ontario  L5K 1B1                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         UXP                                          
+321000-321FFF                 (base 16)                     UXP                                          
+                                                            12 AVENUE PIERRE DE COUBERTIN                
+                                                            SEYSSINET PARISET CEDEX  ISERE  38174        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Digital Multimedia Technologies Spa          
+32B000-32BFFF                 (base 16)                     Digital Multimedia Technologies Spa          
+                                                            Via Zanella, 21                              
+                                                            Lissone  Milan  20035                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SavvyCorp.com Ltd                            
+2F8000-2F8FFF                 (base 16)                     SavvyCorp.com Ltd                            
+                                                            4040 Palmer Court                            
+                                                            Naperville  IL  60564                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Arthur Industries Inc., dba On Hold Media Group
+2FB000-2FBFFF                 (base 16)                     Arthur Industries Inc., dba On Hold Media Group
+                                                            6836 Dallas Pkwy                             
+                                                            Plano  TX  75024                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         COMERSON S.r.l.                              
+304000-304FFF                 (base 16)                     COMERSON S.r.l.                              
+                                                            Via Lombardia, 15                            
+                                                            Carate Brianza  MILANO  20048                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Geometrics, Inc.                             
+2F1000-2F1FFF                 (base 16)                     Geometrics, Inc.                             
+                                                            2190 Fortune Drive                           
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Integrated System Solution Corp.             
+2D4000-2D4FFF                 (base 16)                     Integrated System Solution Corp.             
+                                                            3F,No.2-1, Industry E Rd., I, Science-based Industrial Park
+                                                            Hsinchu    300                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Ross Video Limited                           
+2CE000-2CEFFF                 (base 16)                     Ross Video Limited                           
+                                                            8 John Street                                
+                                                            Iroquois  Ontario                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Gerber Scientific Products, Inc.             
+2D3000-2D3FFF                 (base 16)                     Gerber Scientific Products, Inc.             
+                                                            83 Gerber  Road                              
+                                                            South Windsor  CT  06074                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Smarteye Corporation                         
+2C2000-2C2FFF                 (base 16)                     Smarteye Corporation                         
+                                                            2637 Bond Street                             
+                                                            Rochester Hills  Michigan  48309             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lipowsky Industrie-Elektronik GmbH           
+2BE000-2BEFFF                 (base 16)                     Lipowsky Industrie-Elektronik GmbH           
+                                                            Roemerstr. 57                                
+                                                            Darmstadt  Hessen  64291                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TA Instruments Ltd                           
+2BB000-2BBFFF                 (base 16)                     TA Instruments Ltd                           
+                                                            159 Lukens Drive                             
+                                                            New Castle  Delaware  19720                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         NORCO INDUSTRIAL TECHNOLOGY INC              
+2BA000-2BAFFF                 (base 16)                     NORCO INDUSTRIAL TECHNOLOGY INC              
+                                                            UNIT 211-739 BIRCHMOUNT ROAD                 
+                                                            TORONTO  ON  M1K 1R6                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         SYN-TECH SYSTEMS INC                         
+2D8000-2D8FFF                 (base 16)                     SYN-TECH SYSTEMS INC                         
+                                                            PO BOX 5258                                  
+                                                            TALLAHASSEE  FLORIDA  32314                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Micro System Architecturing srl              
+2A7000-2A7FFF                 (base 16)                     Micro System Architecturing srl              
+                                                            Via della Tecnica 8/P                        
+                                                            Agrate Brianza  Milano  20041                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         West-Com Nurse Call Systems, Inc.            
+2A3000-2A3FFF                 (base 16)                     West-Com Nurse Call Systems, Inc.            
+                                                            PO Box 640                                   
+                                                            Danville  CA  94526                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Quest Retail Technology Pty Ltd              
+2AE000-2AEFFF                 (base 16)                     Quest Retail Technology Pty Ltd              
+                                                            37-39 Walsh Street                           
+                                                            Thebarton  South Australia  5031             
+                                                            AU                                           
+
+00-50-C2                      (hex)                         DEUTA Werke GmbH                             
+2AA000-2AAFFF                 (base 16)                     DEUTA Werke GmbH                             
+                                                            ET                                           
+                                                            Bergisch Gladbach  NRW  51465                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Globe Wireless                               
+29D000-29DFFF                 (base 16)                     Globe Wireless                               
+                                                            2300 Commerce Park Drive                     
+                                                            Palm Bay  Florida  32905                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         SELEX Communications Ltd                     
+29E000-29EFFF                 (base 16)                     SELEX Communications Ltd                     
+                                                            Liverpool Digital, Baird House               
+                                                            Liverpool  Fairfield  L7 9NJ                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Baudisch Electronic GmbH                     
+29F000-29FFFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7                           
+                                                            Waeschenbeuren    73116                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Real Time Systems                            
+28A000-28AFFF                 (base 16)                     Real Time Systems                            
+                                                            108 E. Austin St                             
+                                                            Fredericksburg  Tx  78624                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         RPM Systems Corporation                      
+288000-288FFF                 (base 16)                     RPM Systems Corporation                      
+                                                            17371 NE 67th Court                          
+                                                            Redmond  Washington  98052                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Orion Technologies,LLC                       
+28B000-28BFFF                 (base 16)                     Orion Technologies,LLC                       
+                                                            12605 Challenger Parkway Suite 130           
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Harvad University                            
+298000-298FFF                 (base 16)                     Harvad University                            
+                                                            17 Oxford St.                                
+                                                            Cambridge  MA  01238                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         LOGOSOL, INC.                                
+295000-295FFF                 (base 16)                     LOGOSOL, INC.                                
+                                                            5041 Robert J. Mathews Parkway               
+                                                            El Dorado Hills  CA  95762                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         IP Unity                                     
+293000-293FFF                 (base 16)                     IP Unity                                     
+                                                            475 Sycamore Drive                           
+                                                            Milpitas  CA  94535                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         CHAUVIN ARNOUX                               
+291000-291FFF                 (base 16)                     CHAUVIN ARNOUX                               
+                                                            LA QUEUE DEVEE                               
+                                                            REUX  PONT L EVEQUE  14130                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         LinkSecurity A/S                             
+27B000-27BFFF                 (base 16)                     LinkSecurity A/S                             
+                                                            Glerupvej 20                                 
+                                                            Rødovre    2610                              
+                                                            DK                                           
+
+00-50-C2                      (hex)                         FG SYNERYS                                   
+26A000-26AFFF                 (base 16)                     FG SYNERYS                                   
+                                                            19, impasse Fourcaran                        
+                                                            TOULOUSE    31021                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Continental Gateway Limited                  
+26B000-26BFFF                 (base 16)                     Continental Gateway Limited                  
+                                                            Unit A, 6/F., Two Chinachem Plaza,           
+                                                            Central                                      
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Parabit Systems                              
+268000-268FFF                 (base 16)                     Parabit Systems                              
+                                                            One Shore Road                               
+                                                            Glenwood Landing  NY  11547                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         AnaLogic Computers Ltd.                      
+27E000-27EFFF                 (base 16)                     AnaLogic Computers Ltd.                      
+                                                            13-17 Kende Str.                             
+                                                            Budapest    H-1111                           
+                                                            HU                                           
+
+00-50-C2                      (hex)                         T/R Systems, Inc.                            
+277000-277FFF                 (base 16)                     T/R Systems, Inc.                            
+                                                            1300 Oakbrook Drive                          
+                                                            Norcross  GA  30093                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vansco Electronics Oy                        
+263000-263FFF                 (base 16)                     Vansco Electronics Oy                        
+                                                            PO Box 86                                    
+                                                            FORSSA    FIN-30101                          
+                                                            FI                                           
+
+00-50-C2                      (hex)                         ATOM GIKEN Co.,Ltd.                          
+266000-266FFF                 (base 16)                     ATOM GIKEN Co.,Ltd.                          
+                                                            92-2 KATASE                                  
+                                                            FUJISAWA  KANAGAWA  251-0032                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         intec GmbH                                   
+244000-244FFF                 (base 16)                     intec GmbH                                   
+                                                            Rahmedestr. 90                               
+                                                            Luedenscheid  NRW  58507                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Bender GmbH & Co. KG                         
+249000-249FFF                 (base 16)                     Bender GmbH & Co. KG                         
+                                                            Londorfer Straße 65                          
+                                                            35305 Grünberg    1161                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Softhill Technologies Ltd.                   
+25C000-25CFFF                 (base 16)                     Softhill Technologies Ltd.                   
+                                                            1329 Una Way                                 
+                                                            Port Coquitlam  British Columbia  V3C 2V1    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         RDTECH                                       
+25D000-25DFFF                 (base 16)                     RDTECH                                       
+                                                            505, boul Parc Technologique                 
+                                                            Quebec    G1P 4S9                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+252000-252FFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstr. 14                            
+                                                            Leinfelden-Echterdingen  BW  70771           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+250000-250FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Industriegebiet Engelberg 2                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Dixtal Biomedica Ind. Com. Ltda.             
+248000-248FFF                 (base 16)                     Dixtal Biomedica Ind. Com. Ltda.             
+                                                            R. Eng. Francisco Pitta Brito, 703           
+                                                            São Paulo  SP  04753080                      
+                                                            BR                                           
+
+00-50-C2                      (hex)                         MITE Hradec Kralove, s.r.o.                  
+25E000-25EFFF                 (base 16)                     MITE Hradec Kralove, s.r.o.                  
+                                                            Veverkova 1343                               
+                                                            Hradec Kralove  CZ  500 02                   
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Winford Engineering                          
+25B000-25BFFF                 (base 16)                     Winford Engineering                          
+                                                            4169 Four Mile Road                          
+                                                            Bay City  MI  48706                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Omicron Ceti AB                              
+259000-259FFF                 (base 16)                     Omicron Ceti AB                              
+                                                            Borgarfjordsgatan 7                          
+                                                            KISTA  STOCKHOLM  SE-16440                   
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Digicast Networks                            
+257000-257FFF                 (base 16)                     Digicast Networks                            
+                                                            204 Rod Circle                               
+                                                            Middletown  MD  21769                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gauging Systems Inc                          
+23D000-23DFFF                 (base 16)                     Gauging Systems Inc                          
+                                                            910A Industrial Blvd                         
+                                                            Sugar Land  TX  77478-2828                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         HTEC Limited                                 
+22F000-22FFFF                 (base 16)                     HTEC Limited                                 
+                                                            George Curl Way                              
+                                                            Southampton  Hampshire  SO18 2RX             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Tandata Systems Ltd                          
+237000-237FFF                 (base 16)                     Tandata Systems Ltd                          
+                                                            Richmond House                               
+                                                            Newbury  Berkshire  RG14 1QY                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Silverback Systems                           
+234000-234FFF                 (base 16)                     Silverback Systems                           
+                                                            695 Campbell Technology Pkwy                 
+                                                            Campbell  CA  95008                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Halliburton - NUMAR                          
+23F000-23FFFF                 (base 16)                     Halliburton - NUMAR                          
+                                                            710 Stockton Drive                           
+                                                            Exton  PA  19341                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Chantry Networks                             
+23A000-23AFFF                 (base 16)                     Chantry Networks                             
+                                                            1900 Minnesota Court                         
+                                                            Mississauga  Ontario  L5N 3C9                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Intrinsity                                   
+22C000-22CFFF                 (base 16)                     Intrinsity                                   
+                                                            11612 Bee Caves Road                         
+                                                            Austin  TX  78738                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Aeroflex GmbH                                
+219000-219FFF                 (base 16)                     Aeroflex GmbH                                
+                                                            Gutenbergstrasse 2-4                         
+                                                            Ismaning  Bavaria  85737                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Hochschule für Technik, Wirtschaft und Kultur Leipzig (FH)
+211000-211FFF                 (base 16)                     Hochschule für Technik, Wirtschaft und Kultur Leipzig (FH)
+                                                            Wächterstraße 13                             
+                                                            Leipzig  Saxonia  D-04107                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rafael                                       
+20B000-20BFFF                 (base 16)                     Rafael                                       
+                                                            Library dep. C0-900                          
+                                                            Haifa    31009                               
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Ross Video Limited                           
+226000-226FFF                 (base 16)                     Ross Video Limited                           
+                                                            8 John St.                                   
+                                                            Iroquois   ON  K0E 1K0                       
+                                                            CA                                           
+
+00-50-C2                      (hex)                         visicontrol GmbH                             
+223000-223FFF                 (base 16)                     visicontrol GmbH                             
+                                                            Ettishofer Straße 8                          
+                                                            Weingarten  Baden-Württemberg  88250         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Solectron Ind.Com.Servs.Exportadora do Brasil Ltda.
+207000-207FFF                 (base 16)                     Solectron Ind.Com.Servs.Exportadora do Brasil Ltda.
+                                                            ROD. CAMPINAS-MOGI MIRIM, KM 133             
+                                                            JAGUARIUNA  São Paulo  13820-000             
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Vocality International Ltd                   
+203000-203FFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Shackleford  Surrey  GU8 6AP                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Audio Riders Oy                              
+202000-202FFF                 (base 16)                     Audio Riders Oy                              
+                                                            Jarvihaantie 4                               
+                                                            Klaukkala    01800                           
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Ranch Networks                               
+1E9000-1E9FFF                 (base 16)                     Ranch Networks                               
+                                                            65 Rt. 34                                    
+                                                            Morganville  NJ  07751                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         SKY Computers, Inc.                          
+1F1000-1F1FFF                 (base 16)                     SKY Computers, Inc.                          
+                                                            27 Industrial Ave                            
+                                                            Chelmsford  Mass  01824                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         SystIng                                      
+205000-205FFF                 (base 16)                     SystIng                                      
+                                                            Schmalholzstr. 17                            
+                                                            Kaufering  bavaria  86916                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         shanghai trend intelligent systems CO.,LTD   
+1D6000-1D6FFF                 (base 16)                     shanghai trend intelligent systems CO.,LTD   
+                                                            floor 10,xinan building,NO.200,zhennin R     
+                                                            shanghai    200040                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Lulea University of Technology               
+1DF000-1DFFFF                 (base 16)                     Lulea University of Technology               
+                                                            University Campus                            
+                                                            Lulea  Norrbotten  SE-971 87                 
+                                                            SE                                           
+
+00-50-C2                      (hex)                         EmCom Technology Inc.                        
+1B9000-1B9FFF                 (base 16)                     EmCom Technology Inc.                        
+                                                            7F, 219, Sec. 3, Nanking E. Rd.,             
+                                                            Taipei    104                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         MosChip USA                                  
+1B7000-1B7FFF                 (base 16)                     MosChip USA                                  
+                                                            3335 Kifer Rd                                
+                                                            Santa Clara  CA  95051                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Home Director, Inc                           
+1AE000-1AEFFF                 (base 16)                     Home Director, Inc                           
+                                                            3751-A South Alston Ave.                     
+                                                            Durham  NC  27713                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         BLANKOM Antennentechnik GmbH                 
+1B0000-1B0FFF                 (base 16)                     BLANKOM Antennentechnik GmbH                 
+                                                            Bahnhofstr. 39                               
+                                                            Bad Blankenburg  Deutschland  D-07422        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Email Metering                               
+1BB000-1BBFFF                 (base 16)                     Email Metering                               
+                                                            Joynton Avenue                               
+                                                            Zetland  New South Wales  2017               
+                                                            AU                                           
+
+00-50-C2                      (hex)                         quantumBEAM Limited                          
+1CB000-1CBFFF                 (base 16)                     quantumBEAM Limited                          
+                                                            Abbey Barns                                  
+                                                            Ickleton  Cambridgeshire  CB10 1SX           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Remia s.r.o.                                 
+1AD000-1ADFFF                 (base 16)                     Remia s.r.o.                                 
+                                                            Letna 42                                     
+                                                            Kosice  KE  04001                            
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Artec Design                                 
+19C000-19CFFF                 (base 16)                     Artec Design                                 
+                                                            Teaduspargi 6/1                              
+                                                            Tallinn    12618                             
+                                                            EE                                           
+
+00-50-C2                      (hex)                         Alpha Beta Technologies, Inc.                
+1A7000-1A7FFF                 (base 16)                     Alpha Beta Technologies, Inc.                
+                                                            3112 12th Ave. S.W.                          
+                                                            Huntsville  AL  35805                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         BitBox Ltd                                   
+1AA000-1AAFFF                 (base 16)                     BitBox Ltd                                   
+                                                            Whitney Road                                 
+                                                            Basingstoke  Hampshire  RG24 8NS             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SCA Data Systems                             
+1A0000-1A0FFF                 (base 16)                     SCA Data Systems                             
+                                                            3400 Airport Ave                             
+                                                            Santa Monica  CA  90405                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         NORCO                                        
+1A5000-1A5FFF                 (base 16)                     NORCO                                        
+                                                            5# QUNYINGKEJIYUAN                           
+                                                            BEIJIN    100084                             
+                                                            CN                                           
+
+00-50-C2                      (hex)                         SPARR ELECTRONICS LTD                        
+18E000-18EFFF                 (base 16)                     SPARR ELECTRONICS LTD                        
+                                                            43, HMT MAIN RD                              
+                                                            BANGALORE  KARNATAKA  560054                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Partner Voxstream A/S                        
+191000-191FFF                 (base 16)                     Partner Voxstream A/S                        
+                                                            Trekanten 17                                 
+                                                            Vojens    DK-6500                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         CCII Systems (Pty) Ltd                       
+18D000-18DFFF                 (base 16)                     CCII Systems (Pty) Ltd                       
+                                                            Unit 3, 67 Rosmead Avenue                    
+                                                            Cape Town  Cape  7708                        
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Hunter Technology Inc.                       
+017000-017FFF                 (base 16)                     Hunter Technology Inc.                       
+                                                            1408, Woolim e-biz Center,                   
+                                                            Seoul                                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Opus Telecom Inc.                            
+00D000-00DFFF                 (base 16)                     Opus Telecom Inc.                            
+                                                            11 Herbert St.                               
+                                                            Framingham  MA  01702                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Postec Data Systems Ltd.                     
+16D000-16DFFF                 (base 16)                     Postec Data Systems Ltd.                     
+                                                            PO Box 302-230                               
+                                                                                                         
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Private                                      
+064000-064FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         PMC                                          
+16E000-16EFFF                 (base 16)                     PMC                                          
+                                                            56, Avenue Raspail                           
+                                                            Saint Maur                                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Private                                      
+062000-062FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         nCore, Inc.                                  
+157000-157FFF                 (base 16)                     nCore, Inc.                                  
+                                                            2870 Perrowville Rd.                         
+                                                            Forest  VA  24551                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Communication Solutions, Inc.                
+158000-158FFF                 (base 16)                     Communication Solutions, Inc.                
+                                                            P.O. Box 43550                               
+                                                            Baltimore  MD  21236-0550                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Enea Real Time AB                            
+155000-155FFF                 (base 16)                     Enea Real Time AB                            
+                                                            Drauegatan 7                                 
+                                                            Goteborg    SE-41250                         
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Uniwell Systems (UK) Ltd.                    
+137000-137FFF                 (base 16)                     Uniwell Systems (UK) Ltd.                    
+                                                            Uniwell Building, Challenge Way              
+                                                            Blackburn  Lancashire BB1 5US                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Alltec GmbH                                  
+148000-148FFF                 (base 16)                     Alltec GmbH                                  
+                                                            Seelandstr. 67                               
+                                                            Lubeck    23569                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Carl Baasel Lasertechnik GmbH                
+0F6000-0F6FFF                 (base 16)                     Carl Baasel Lasertechnik GmbH                
+                                                            Petersbrunner Str. 1b                        
+                                                            82319 Starnberg                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Corinex Global                               
+14E000-14EFFF                 (base 16)                     Corinex Global                               
+                                                            Klukata 6, P.O. Box 160                      
+                                                            Bratislava    820 05                         
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Torse                                        
+150000-150FFF                 (base 16)                     Torse                                        
+                                                            Waldrainstrasse 11                           
+                                                            Koeniz    3098                               
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Tensilica, Inc.                              
+136000-136FFF                 (base 16)                     Tensilica, Inc.                              
+                                                            3255-G Scott Blvd.                           
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         MaxLinear Hispania S.L.U.                    
+126000-126FFF                 (base 16)                     MaxLinear Hispania S.L.U.                    
+                                                            Ronda Narcis Monturiol                       
+                                                            Estarriol, 11D  Paterna  46980               
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Pycon, Inc.                                  
+128000-128FFF                 (base 16)                     Pycon, Inc.                                  
+                                                            3301 Leonard Ct.                             
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Destiny Networks, Inc.                       
+11D000-11DFFF                 (base 16)                     Destiny Networks, Inc.                       
+                                                            15790 Monterey Rd., Suite 300                
+                                                            Morgan Hill  CA  95037                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         COE Limited                                  
+121000-121FFF                 (base 16)                     COE Limited                                  
+                                                            Photon House                                 
+                                                            Leeds LS12 1EG                               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Volvo Car Corporation                        
+11E000-11EFFF                 (base 16)                     Volvo Car Corporation                        
+                                                            Dept. 50910, TJA2N                           
+                                                            SE-40508 Goteborg                            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Tokai Soft Corporation                       
+124000-124FFF                 (base 16)                     Tokai Soft Corporation                       
+                                                            6-55 Nagaosacho, Nakamuraku                  
+                                                            Nagoya City, Aichi                           
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Quinx AG                                     
+10A000-10AFFF                 (base 16)                     Quinx AG                                     
+                                                            Hauptstrasse 115                             
+                                                            CH-5732 Zetzwil                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Endusis Limited                              
+111000-111FFF                 (base 16)                     Endusis Limited                              
+                                                            Strawberry How Business Centre               
+                                                            Cockermouth  Cumbria CA13 9XQ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ENTTEC Pty Ltd.                              
+075000-075FFF                 (base 16)                     ENTTEC Pty Ltd.                              
+                                                            po box 4051                                  
+                                                            ringwood  vic  3134                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Compuworx                                    
+112000-112FFF                 (base 16)                     Compuworx                                    
+                                                            141-143 Szabadsag U.                         
+                                                            2040 Budaors                                 
+                                                            HU                                           
+
+00-50-C2                      (hex)                         MATSUOKA                                     
+106000-106FFF                 (base 16)                     MATSUOKA                                     
+                                                            kishimachi 2-9-17-102                        
+                                                            Tokyo-to                                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Million Tech Development Ltd.                
+102000-102FFF                 (base 16)                     Million Tech Development Ltd.                
+                                                            Unit D, s/F., Leroy Plaza                    
+                                                            Cheung Sha Wan, Kowloon                      
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Spectra Technologies Holding Co., Ltd.       
+0F5000-0F5FFF                 (base 16)                     Spectra Technologies Holding Co., Ltd.       
+                                                            Unit 1301-09, 19-20                          
+                                                            193 Prince Edward Road West                  
+                                                            HK                                           
+
+00-50-C2                      (hex)                         iREZ Technologies LLC                        
+0EB000-0EBFFF                 (base 16)                     iREZ Technologies LLC                        
+                                                            15020 N 74th St.                             
+                                                            Scottsdale  AZ  85260                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Collabo Tec. Co., Ltd.                       
+0E4000-0E4FFF                 (base 16)                     Collabo Tec. Co., Ltd.                       
+                                                            5-2, 2-chome, Shinryoudai                    
+                                                            Hyougo-Ken    655-0041                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Innovation Institute, Inc.                   
+0DF000-0DFFFF                 (base 16)                     Innovation Institute, Inc.                   
+                                                            PO Box 9359                                  
+                                                            Caguas  PR  00726-9359                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cyberex                                      
+0DB000-0DBFFF                 (base 16)                     Cyberex                                      
+                                                            5335 Avion Park Dr.                          
+                                                            Highland Heights  OH  44143                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Zelax                                        
+0D5000-0D5FFF                 (base 16)                     Zelax                                        
+                                                            Office 8, 146, Zelenograd                    
+                                                            Moscow 103305                                
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Real World Computing Partnership             
+0D2000-0D2FFF                 (base 16)                     Real World Computing Partnership             
+                                                            2-5-12 Higashi-Kanda Chiyoda-ku              
+                                                            Tokyo 101-0031                               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Loewe Opta GmbH                              
+0D9000-0D9FFF                 (base 16)                     Loewe Opta GmbH                              
+                                                            Industriestrasse 11                          
+                                                            Kronach    96317                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Alchemy Semiconductor, Inc.                  
+0C2000-0C2FFF                 (base 16)                     Alchemy Semiconductor, Inc.                  
+                                                            7800 Shoal Creek Blvd.                       
+                                                            Austin  TX  78757                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         RF Applications, Inc.                        
+09C000-09CFFF                 (base 16)                     RF Applications, Inc.                        
+                                                            7345 Production Drive                        
+                                                            Mentor  OH  44060                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         J D Richards                                 
+0CA000-0CAFFF                 (base 16)                     J D Richards                                 
+                                                            12840 Earhart Ave.                           
+                                                            Auburn  CA  95602                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         AlphaMedia Co., Ltd                          
+0CC000-0CCFFF                 (base 16)                     AlphaMedia Co., Ltd                          
+                                                            Technical Center                             
+                                                            Shimoyamatedori Chuoku  Kobe Hyogo           
+                                                            JP                                           
+
+00-50-C2                      (hex)                         PCSC                                         
+0CF000-0CFFFF                 (base 16)                     PCSC                                         
+                                                            3541 Challenger St.                          
+                                                            Torrance  CA  90503                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         BMC Messsysteme GmbH                         
+0AD000-0ADFFF                 (base 16)                     BMC Messsysteme GmbH                         
+                                                            Peter-Henlein-Str. 4                         
+                                                            82140 Olching                                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ApSecure Technologies (Canada), Inc.         
+0B6000-0B6FFF                 (base 16)                     ApSecure Technologies (Canada), Inc.         
+                                                            4603 Kinsway, Suite 402                      
+                                                            Burnby  British Columbia  V5H 4M4            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Stella Electronics & Tagging                 
+0BE000-0BEFFF                 (base 16)                     Stella Electronics & Tagging                 
+                                                            Technopole de Chateau Gombert                
+                                                            13013 Marseille                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         WaterCove Networks                           
+0A7000-0A7FFF                 (base 16)                     WaterCove Networks                           
+                                                            6 New England Executive Park                 
+                                                            Burlington  MA  01803                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         NBO Development Center Sekusui Chemical Co. Ltd.
+09A000-09AFFF                 (base 16)                     NBO Development Center Sekusui Chemical Co. Ltd.
+                                                            32 Wadai, Tsukuba-shi                        
+                                                            Ibaraki,  300-4292                           
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Case Information & Communications            
+099000-099FFF                 (base 16)                     Case Information & Communications            
+                                                            18F Daishin Bldg., 395-68                    
+                                                            Seoul                                        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         MetaWave Vedeo Systems                       
+09F000-09FFFF                 (base 16)                     MetaWave Vedeo Systems                       
+                                                            11 Kingsclere Park                           
+                                                            Kingsclere, Newbury  Berkshire  RG20 4SW     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         TELINC Corporation                           
+088000-088FFF                 (base 16)                     TELINC Corporation                           
+                                                            22 Springdale Rd.                            
+                                                            Cherry Hill  NJ  08003                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         GFI Chrono Time                              
+082000-082FFF                 (base 16)                     GFI Chrono Time                              
+                                                            121 rue des Guillees                         
+                                                            CHAURAY    79180                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Trikon Technologies Ltd.                     
+07B000-07BFFF                 (base 16)                     Trikon Technologies Ltd.                     
+                                                            Ringland Way                                 
+                                                            Gwent    NP18 2TA                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         NCast Corporation                            
+06B000-06BFFF                 (base 16)                     NCast Corporation                            
+                                                            4677 Old Ironsides Drive, Suite 430          
+                                                            Santa Clara  CA   95054-1826                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital Services Group                       
+06F000-06FFFF                 (base 16)                     Digital Services Group                       
+                                                            PO Box 36848                                 
+                                                            Birmingham  AL  35236                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Katchall Technologies Group                  
+070000-070FFF                 (base 16)                     Katchall Technologies Group                  
+                                                            5800 Creek Road                              
+                                                            Cincinnati  OH  45242                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Avtron Manufacturing Inc.                    
+06E000-06EFFF                 (base 16)                     Avtron Manufacturing Inc.                    
+                                                            7900 East Pleasant Valley Rd.                
+                                                            Independence  OH  44131                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Malden Electronics Ltd                       
+05F000-05FFFF                 (base 16)                     Malden Electronics Ltd                       
+                                                            2 High Street                                
+                                                            Ewell  Surrey  KT17 1SJ                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Seabridge                                    
+068000-068FFF                 (base 16)                     Seabridge                                    
+                                                            PO Box 470                                   
+                                                            Hod Hasharon    45800                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         EC Elettronica S.R.L.                        
+069000-069FFF                 (base 16)                     EC Elettronica S.R.L.                        
+                                                            Via Industriale TR. 3, 15                    
+                                                            25060 Cellatica (BS)                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Lite F GmBH                                  
+057000-057FFF                 (base 16)                     Lite F GmBH                                  
+                                                            PO Box 774                                   
+                                                            79007 Freiburg                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         San Castle Technologies, Inc.                
+055000-055FFF                 (base 16)                     San Castle Technologies, Inc.                
+                                                            2375 Zanker Rd.                              
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sonifex Ltd                                  
+05A000-05AFFF                 (base 16)                     Sonifex Ltd                                  
+                                                            61 Station Road                              
+                                                            Irthlingborough  Northants NN9 5QE England   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Base 2                                       
+056000-056FFF                 (base 16)                     Base 2                                       
+                                                            3/28 Pritchard Rd.                           
+                                                            Virginia  Queensland  4014                   
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Industrial Electronic Engineers, Inc.        
+04E000-04EFFF                 (base 16)                     Industrial Electronic Engineers, Inc.        
+                                                            7740 Lemona Ave.                             
+                                                            Van Nuys  CA  91409-9234                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         ISDN Gateway Technology AG                   
+03D000-03DFFF                 (base 16)                     ISDN Gateway Technology AG                   
+                                                            Karlstrasse 5                                
+                                                            CH-8610 Uster                                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Cybectec Inc.                                
+048000-048FFF                 (base 16)                     Cybectec Inc.                                
+                                                            8165 rue du Mistral #100                     
+                                                            Charny  Quebec  G6X 3R8                      
+                                                            CA                                           
+
+00-50-C2                      (hex)                         PLLB Elettronica SPA                         
+03A000-03AFFF                 (base 16)                     PLLB Elettronica SPA                         
+                                                            Via Carducce 39                              
+                                                            20099 Sesto San Giovanni  Milano             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Industrial Control Links                     
+027000-027FFF                 (base 16)                     Industrial Control Links                     
+                                                            12840 Earhart Ave.                           
+                                                            Auburn  CA  95602                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         The Frensch Corporation (Pty) Ltd.           
+028000-028FFF                 (base 16)                     The Frensch Corporation (Pty) Ltd.           
+                                                            P.O. Box 21008                               
+                                                            GICP  Gabrone                                
+                                                            BW                                           
+
+00-50-C2                      (hex)                         Sinetica Corp                                
+02F000-02FFFF                 (base 16)                     Sinetica Corp                                
+                                                            Singleton Court                              
+                                                            Monmouth    NP53AH                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Princeton Gamma Tech                         
+01D000-01DFFF                 (base 16)                     Princeton Gamma Tech                         
+                                                            1010 Commerce Park Dr.                       
+                                                            Old Ridge  TN  37830                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         XLN-t                                        
+00F000-00FFFF                 (base 16)                     XLN-t                                        
+                                                            Waran De Straat 9B                           
+                                                                                                         
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Densitron Technologies Ltd                   
+A7E000-A7EFFF                 (base 16)                     Densitron Technologies Ltd                   
+                                                            Saxon Way                                    
+                                                            Royston  Herts  SG8 6DN                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ProPhotonix                                  
+ACC000-ACCFFF                 (base 16)                     ProPhotonix                                  
+                                                            3020 Euro Business Park                      
+                                                            Co Cork  Little Island  n/A                  
+                                                            IE                                           
+
+40-D8-55                      (hex)                         VITEC                                        
+054000-054FFF                 (base 16)                     VITEC                                        
+                                                            99, rue Pierre Semard                        
+                                                            Chatillon  Ile de France  92324              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         DEUTA-WERKE GmbH                             
+DA4000-DA4FFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather Str. 140                          
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DEUTA-WERKE GmbH                             
+E44000-E44FFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather Str. 140                          
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AutomationX GmbH                             
+7FA000-7FAFFF                 (base 16)                     AutomationX GmbH                             
+                                                            Teslastraße 8                                
+                                                            Grambach  Stmk  8074                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+D9A000-D9AFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TERACOM TELEMATICA S.A                       
+025000-025FFF                 (base 16)                     TERACOM TELEMATICA S.A                       
+                                                            RUA AMERICA N.1000                           
+                                                            Eldorado do Sul - RS    Brazil               
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Elbit Systems of America                     
+761000-761FFF                 (base 16)                     Elbit Systems of America                     
+                                                            4700 Marine Creek Parkway                    
+                                                            Fort Worth  TX  76179                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Chengdu Meihuan Technology Co., Ltd          
+1DF000-1DFFFF                 (base 16)                     Chengdu Meihuan Technology Co., Ltd          
+                                                            Floor 17,Building D6,Tianfu Software Park,   
+                                                            Chengdu  Sichuan  610041                     
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+B0B000-B0BFFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Hwy 19 North                        
+                                                            Clearwater  FL  33764-7290                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+F55000-F55FFF                 (base 16)                     Honeywell                                    
+                                                            13350 US Hwy 19 N                            
+                                                            Clearwater    33764                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Alro Information Systems SA                  
+3EA000-3EAFFF                 (base 16)                     Alro Information Systems SA                  
+                                                            Route d'Onnens 1                             
+                                                            Neyruz  FR  CH-1740                          
+                                                            CH                                           
+
+40-D8-55                      (hex)                         YUYAMA MFG Co.,Ltd                           
+0FF000-0FFFFF                 (base 16)                     YUYAMA MFG Co.,Ltd                           
+                                                            3-3-1                                        
+                                                            TOYONAKASHI  OSAKA  561-0841                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         YUYAMA MFG Co.,Ltd                           
+EEC000-EECFFF                 (base 16)                     YUYAMA MFG Co.,Ltd                           
+                                                            3-3-1                                        
+                                                            TOYONAKASHI  OSAKA  561-0841                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Scame Sistemi srl                            
+452000-452FFF                 (base 16)                     Scame Sistemi srl                            
+                                                            Via Lombardia N°5                            
+                                                            ARLUNO  MI  20010                            
+                                                            IT                                           
+
+40-D8-55                      (hex)                         TECHBOARD SRL                                
+165000-165FFF                 (base 16)                     TECHBOARD SRL                                
+                                                            VIA DELLA SCIENZA 50                         
+                                                            MODENA  Modena  41122                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Imarda New Zealand Limited                   
+1DC000-1DCFFF                 (base 16)                     Imarda New Zealand Limited                   
+                                                            Suite G16, National Innovation Centre,       
+                                                            Eveleigh NSW     2015                        
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         DiTEST Fahrzeugdiagnose GmbH                 
+926000-926FFF                 (base 16)                     DiTEST Fahrzeugdiagnose GmbH                 
+                                                            ALTE POSTSTRASSE 152                         
+                                                            A-8020  GRAZ  STEIERMARK                     
+                                                            AT                                           
+
+00-50-C2                      (hex)                         HYPERCHIP Inc.                               
+08B000-08BFFF                 (base 16)                     HYPERCHIP Inc.                               
+                                                            180 Peel St.                                 
+                                                            Montreal  Quebec  H3C 2G7                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Concepteers, LLC                             
+B2C000-B2CFFF                 (base 16)                     Concepteers, LLC                             
+                                                            880 Bergen Ave                               
+                                                            Jersey City  NJ  07306                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Exi Flow Measurement Ltd                     
+945000-945FFF                 (base 16)                     Exi Flow Measurement Ltd                     
+                                                            Hawthorn Road                                
+                                                            Littlehampton  West Sussex  BN17 7LT         
+                                                            GB                                           
+
+40-D8-55                      (hex)                         QUANTAFLOW                                   
+0C9000-0C9FFF                 (base 16)                     QUANTAFLOW                                   
+                                                            AVENUE DUPONT GRAVE                          
+                                                            HONFLEUR    14600                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Triax A/S                                    
+F63000-F63FFF                 (base 16)                     Triax A/S                                    
+                                                            Bjornkaervej 3                               
+                                                            Hornsyld  Denmark  8783                      
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+5A7000-5A7FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße  39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Logical Product                              
+0CD000-0CDFFF                 (base 16)                     Logical Product                              
+                                                            2-25-5,matoba,minamiku                       
+                                                            Fukuoka  Fukuoka  811-1314                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Insitu, Inc                                  
+C35000-C35FFF                 (base 16)                     Insitu, Inc                                  
+                                                            118 E Columbia River Way                     
+                                                            Bingen  WA  98605                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         InterEpoch Technology,INC.                   
+0C4000-0C4FFF                 (base 16)                     InterEpoch Technology,INC.                   
+                                                            &f, No. 3, Alley 6, Lane 235                 
+                                                            Taipei Hsien    000                          
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Critical Link LLC                            
+FC6000-FC6FFF                 (base 16)                     Critical Link LLC                            
+                                                            6712 Brooklawn  Parkway                      
+                                                            Syracuse    13211                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         An Chen Computer Co., Ltd.                   
+044000-044FFF                 (base 16)                     An Chen Computer Co., Ltd.                   
+                                                            2F.,No.37,Sec. 2, San Min Rd.,               
+                                                            New Taipei City    220                       
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Delphi Display Systems, Inc.                 
+301000-301FFF                 (base 16)                     Delphi Display Systems, Inc.                 
+                                                            3160 Pullman Street                          
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Delphi Display Systems, Inc.                 
+578000-578FFF                 (base 16)                     Delphi Display Systems, Inc.                 
+                                                            3160 Pullman Street                          
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         MedAvant Healthcare                          
+4F0000-4F0FFF                 (base 16)                     MedAvant Healthcare                          
+                                                            2533 Centennial Blvd                         
+                                                            Jeffersonville  IN  47150                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         PERAX                                        
+2BF000-2BFFFF                 (base 16)                     PERAX                                        
+                                                            48 rue de Fenouillet                         
+                                                            Saint ALBAN  Haute garonne  31140            
+                                                            FR                                           
+
+40-D8-55                      (hex)                         HORIBA ABX SAS                               
+1BD000-1BDFFF                 (base 16)                     HORIBA ABX SAS                               
+                                                            rue du caducee                               
+                                                            Montpellier  Herault  34000                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         HORIBA ABX SAS                               
+EF9000-EF9FFF                 (base 16)                     HORIBA ABX SAS                               
+                                                            rue du caducee                               
+                                                            Montpellier  Herault  34000                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Gogo BA                                      
+CF5000-CF5FFF                 (base 16)                     Gogo BA                                      
+                                                            303 S. Technology Dr.                        
+                                                            Broomfield  CO  80021                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+5AF000-5AFFFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Vitoria  Alava  01510                        
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DORLET SAU                                   
+1E5000-1E5FFF                 (base 16)                     DORLET SAU                                   
+                                                            Albert Einstein 34                           
+                                                            Miñanoo Mayor  ALAVA  01510                  
+                                                            ES                                           
+
+00-50-C2                      (hex)                         System Industrie Electronic GmbH             
+EE2000-EE2FFF                 (base 16)                     System Industrie Electronic GmbH             
+                                                            Millennium Park 12                           
+                                                            Lustenau  Vorarlberg  6890                   
+                                                            AT                                           
+
+00-50-C2                      (hex)                         On Air Networks                              
+73B000-73BFFF                 (base 16)                     On Air Networks                              
+                                                            302,Ansan Software Center                    
+                                                            Ansan-Si  Gyenonggi-Do  425-130              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         MTD GmbH                                     
+B48000-B48FFF                 (base 16)                     MTD GmbH                                     
+                                                            Bahnhofstr. 24                               
+                                                            Uffing am Staffelsee  Bavaria  82449         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DCNS                                         
+6FA000-6FAFFF                 (base 16)                     DCNS                                         
+                                                            DCN Services Brest                           
+                                                            BREST    29228                               
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Owasys Advanced Wireless Devices             
+374000-374FFF                 (base 16)                     Owasys Advanced Wireless Devices             
+                                                            Parque Tecnologico, 207-B                    
+                                                            Zamudio  Vizcaya  E-48170                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DAVE SRL                                     
+1EA000-1EAFFF                 (base 16)                     DAVE SRL                                     
+                                                            via Talponedo 29/A                           
+                                                            Porcia  PN  33170                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+1B3000-1B3FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PK INNOVATION CENTRE                  
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Vocality International Ltd                   
+AFB000-AFBFFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Shackleford  Surrey  GU8 6AP                 
+                                                            GB                                           
+
+40-D8-55                      (hex)                         ACD Elektronik GmbH                          
+0B7000-0B7FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Telemetrie Elektronik GmbH                   
+9D3000-9D3FFF                 (base 16)                     Telemetrie Elektronik GmbH                   
+                                                            Berliner Allee 42                            
+                                                            Langenhagen  Niedersachsen  30855            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+9EC000-9ECFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+C9E000-C9EFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+DD3000-DD3FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+855000-855FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+E2A000-E2AFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+EE4000-EE4FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+40-D8-55                      (hex)                         Rohde&Schwarz Topex SA                       
+19A000-19AFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+0BC000-0BCFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+060000-060FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+F08000-F08FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Tecnint HTE SRL                              
+0F8000-0F8FFF                 (base 16)                     Tecnint HTE SRL                              
+                                                            Via della tecnica 16/18                      
+                                                            Osnago (Lecco)    23875                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Wireless Cables Inc.                         
+7F4000-7F4FFF                 (base 16)                     Wireless Cables Inc.                         
+                                                            1414 Soquel Ave, Ste 212                     
+                                                            Santa Cruz  CA  95062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         RFL Electronics, Inc.                        
+DAC000-DACFFF                 (base 16)                     RFL Electronics, Inc.                        
+                                                            353 Powerville Rd                            
+                                                            Boonton  NJ  07005                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         WaveIP                                       
+F26000-F26FFF                 (base 16)                     WaveIP                                       
+                                                            Teradion Ind Park                            
+                                                            Misgav  Israel  20692                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         RealD                                        
+C90000-C90FFF                 (base 16)                     RealD                                        
+                                                            5335 STERLING DRIVE                          
+                                                            BOULDER  CO  80301                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         RAFI GmbH & Co.KG                            
+2B7000-2B7FFF                 (base 16)                     RAFI GmbH & Co.KG                            
+                                                            P.O. Box 2060                                
+                                                            Ravensburg  Baden-Württemberg  88190         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ATH system                                   
+553000-553FFF                 (base 16)                     ATH system                                   
+                                                            Osady Lezaku 498                             
+                                                            Chrast    53851                              
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Linkwell Telesystems Pvt Ltd                 
+3CC000-3CCFFF                 (base 16)                     Linkwell Telesystems Pvt Ltd                 
+                                                            B45, ELECTRONIC, COMPLEX,                    
+                                                            HYDERABAD  ANDHRA PRADESH  500062            
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+7E9000-7E9FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+A92000-A92FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         American Microsystems, Ltd.                  
+FD5000-FD5FFF                 (base 16)                     American Microsystems, Ltd.                  
+                                                            2190 Regal Pkwy                              
+                                                            Euless  TX  76040                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+CE2000-CE2FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+E0A000-E0AFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Inhand Electronics, Inc.                     
+398000-398FFF                 (base 16)                     Inhand Electronics, Inc.                     
+                                                            30 W. Gude Drive                             
+                                                            Rockville  MD  20850                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         NewHer Systems                               
+107000-107FFF                 (base 16)                     NewHer Systems                               
+                                                            Rivierensingel 598                           
+                                                            5704 NV Helmond                              
+                                                            NL                                           
+
+40-D8-55                      (hex)                         Advatek Lighting Pty Ltd                     
+02F000-02FFFF                 (base 16)                     Advatek Lighting Pty Ltd                     
+                                                            16 / 62 Ramset Drive                         
+                                                            Chirnside Park  VIC  3116                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         IRTrans GmbH                                 
+527000-527FFF                 (base 16)                     IRTrans GmbH                                 
+                                                            Hagener Strasse 512                          
+                                                            Dortmund  NRW  44227                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Intune Networks                              
+8A1000-8A1FFF                 (base 16)                     Intune Networks                              
+                                                            9b Beckett Way                               
+                                                            Dublin    12                                 
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Integrated Design Tools, Inc.                
+7A8000-7A8FFF                 (base 16)                     Integrated Design Tools, Inc.                
+                                                            1804 Miccosukee Commons Drive Suite 208      
+                                                            Tallahassee  FL  32308                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         EKE-Electronics Ltd.                         
+380000-380FFF                 (base 16)                     EKE-Electronics Ltd.                         
+                                                            Piispanportti 7                              
+                                                            ESPOO  -  02240                              
+                                                            FI                                           
+
+00-50-C2                      (hex)                         CLOOS ELECTRONIC GMBH                        
+A06000-A06FFF                 (base 16)                     CLOOS ELECTRONIC GMBH                        
+                                                            Industriestraße 34-36                        
+                                                            Haiger  Hessen  35708                        
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Grossenbacher Systeme AG                     
+0F1000-0F1FFF                 (base 16)                     Grossenbacher Systeme AG                     
+                                                            Spinnereistrasse 10                          
+                                                            St. Gallen    9008                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Autronica Fire And Securirty                 
+4F3000-4F3FFF                 (base 16)                     Autronica Fire And Securirty                 
+                                                            Haakon VII's gate 4                          
+                                                            Trondheim    7483                            
+                                                            NO                                           
+
+00-50-C2                      (hex)                         AIM                                          
+BF0000-BF0FFF                 (base 16)                     AIM                                          
+                                                            21, avenue de la Plaine Fleurie              
+                                                            MEYLAN    38240                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+CFA000-CFAFFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+A24000-A24FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         IEEE Registration Authority                  
+F58000-F58FFF                 (base 16)                     IEEE Registration Authority                  
+                                                            445 Hoes Lane                                
+                                                            Piscataway  NJ  08554                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Veracity UK Ltd                              
+9F0000-9F0FFF                 (base 16)                     Veracity UK Ltd                              
+                                                            6 Barns Street                               
+                                                            Ayr  South Ayrshire  KA7 1XA                 
+                                                            GB                                           
+
+40-D8-55                      (hex)                         NIPPON TECHNO LAB.,INC,                      
+1DB000-1DBFFF                 (base 16)                     NIPPON TECHNO LAB.,INC,                      
+                                                            Hirakawacho Daiichi Seimai Building 5F       
+                                                            Chiyoda-ku  Tokyo  102-0093                  
+                                                            JP                                           
+
+40-D8-55                      (hex)                         FST21 Ltd.                                   
+1D5000-1D5FFF                 (base 16)                     FST21 Ltd.                                   
+                                                            33 Lazarov St.                               
+                                                            Rishon Le Zion  Israel  75654                
+                                                            US                                           
+
+40-D8-55                      (hex)                         TEWS Elektronik GmbH & Co. KG                
+1B7000-1B7FFF                 (base 16)                     TEWS Elektronik GmbH & Co. KG                
+                                                            Sperberhorst 10                              
+                                                              Hamburg  22459                             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Orion Systems, Inc                           
+1B8000-1B8FFF                 (base 16)                     Orion Systems, Inc                           
+                                                            3401 Masons Mill Rd                          
+                                                            Huntingdon Valley  PA  19006                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         MG S.r.l.                                    
+1CB000-1CBFFF                 (base 16)                     MG S.r.l.                                    
+                                                            via Monte Bianco, 1                          
+                                                            SOlbiate Olona  VA  21058                    
+                                                            IT                                           
+
+40-D8-55                      (hex)                         KbDevice,Inc.                                
+1BC000-1BCFFF                 (base 16)                     KbDevice,Inc.                                
+                                                             Takakura building F3 465-2  Senshouji-chou takatujitouri yanaginobannba nishiiru shimogyou-ku
+                                                            kyoto-shi  kyoto-fu  600-8076                
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Inforce Computing Inc.                       
+1B4000-1B4FFF                 (base 16)                     Inforce Computing Inc.                       
+                                                            48820 Kato Road                              
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         HIPODROMO DE AGUA CALIENTE, S.A. DE C.V.     
+1A2000-1A2FFF                 (base 16)                     HIPODROMO DE AGUA CALIENTE, S.A. DE C.V.     
+                                                            BLVD. AGUA CALIENTE 12027                    
+                                                            TIJUANA  BAJA CALIFORNIA  22420              
+                                                            MX                                           
+
+40-D8-55                      (hex)                         cibite AG                                    
+1A4000-1A4FFF                 (base 16)                     cibite AG                                    
+                                                            Posthof 4                                    
+                                                            Donauwoerth  BY  D-86609                     
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Noritake Itron Corporation                   
+1A3000-1A3FFF                 (base 16)                     Noritake Itron Corporation                   
+                                                            670-5 Uchimi Taiki-cho                       
+                                                            Watarai-gun  Mie-ken  519-2736               
+                                                            JP                                           
+
+40-D8-55                      (hex)                         LUCEO                                        
+17B000-17BFFF                 (base 16)                     LUCEO                                        
+                                                            16 Rue Laënnec                               
+                                                            Vern Sur Seiche    35770                     
+                                                            FR                                           
+
+40-D8-55                      (hex)                         YAWATA ELECTRIC INDUSTRIAL CO.,LTD.          
+172000-172FFF                 (base 16)                     YAWATA ELECTRIC INDUSTRIAL CO.,LTD.          
+                                                            1-17-1 Ohmorihigashi                         
+                                                            Ohta-ku  Tokyo  143-0012                     
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Spider Tecnologia Ind. e Com Ltda            
+190000-190FFF                 (base 16)                     Spider Tecnologia Ind. e Com Ltda            
+                                                            Rua Alencar Araripe,1440                     
+                                                            São Paulo  SP  04253-000                    
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Kerun Visual Technology Co., Ltd.(Shenzhen)  
+18E000-18EFFF                 (base 16)                     Kerun Visual Technology Co., Ltd.(Shenzhen)  
+                                                             Bldg 2, F/6, Zone S2                        
+                                                            Shenzhen  China  518000                      
+                                                            CN                                           
+
+40-D8-55                      (hex)                         RF Code                                      
+194000-194FFF                 (base 16)                     RF Code                                      
+                                                            9229 Waterford Centre                        
+                                                            Austin  Tx  78758                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         FORZA SILICON CORP.                          
+193000-193FFF                 (base 16)                     FORZA SILICON CORP.                          
+                                                            2947 BRADLEY ST.                             
+                                                            PASADENA  CALIFORNIA  91107                  
+                                                            US                                           
+
+40-D8-55                      (hex)                         Satkirit Ltd                                 
+184000-184FFF                 (base 16)                     Satkirit Ltd                                 
+                                                            5 Chance St                                  
+                                                              London  E1 6GT                             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         KST technology                               
+186000-186FFF                 (base 16)                     KST technology                               
+                                                            164-1, KST b/d., Bangi-dong, songpa-gu       
+                                                            SEOUL  N/A  138-050                          
+                                                            KR                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+16D000-16DFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         TECHWAY                                      
+16B000-16BFFF                 (base 16)                     TECHWAY                                      
+                                                            19 avenue de Norvege                         
+                                                            Villebon sur Yvette  France  91140           
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Servo-Robot Inc.                             
+179000-179FFF                 (base 16)                     Servo-Robot Inc.                             
+                                                            1370 Hocquart                                
+                                                            St-Bruno  QC  J3V 6E1                        
+                                                            CA                                           
+
+40-D8-55                      (hex)                         AHB Systeme GmbH                             
+175000-175FFF                 (base 16)                     AHB Systeme GmbH                             
+                                                            Julius-Hatry-Str. 1                          
+                                                            Mannheim  Baden-Württemberg  68163          
+                                                            DE                                           
+
+40-D8-55                      (hex)                         LUNA-NEXUS                                   
+162000-162FFF                 (base 16)                     LUNA-NEXUS                                   
+                                                            Terasaki 2nd 6F, 1-8-29                      
+                                                              Osaka  532-0004                            
+                                                            JP                                           
+
+40-D8-55                      (hex)                         iart                                         
+154000-154FFF                 (base 16)                     iart                                         
+                                                            Muelhauserstrasse 111                        
+                                                            Basel  Basel-Stadt  4056                     
+                                                            CH                                           
+
+40-D8-55                      (hex)                         SQF Spezialelektronik GmbH                   
+15B000-15BFFF                 (base 16)                     SQF Spezialelektronik GmbH                   
+                                                            Achimer Str.56                               
+                                                            Oyten    28876                               
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Spectratech Inc.                             
+15C000-15CFFF                 (base 16)                     Spectratech Inc.                             
+                                                            4-22-3-101 Kaminoge                          
+                                                            Setagayaku  Tokyo  158-0093                  
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Marposs S.p.A                                
+14E000-14EFFF                 (base 16)                     Marposs S.p.A                                
+                                                            Via Saliceto 13                              
+                                                            Bentivoglio  Bologna  40010                  
+                                                            IT                                           
+
+40-D8-55                      (hex)                         SEIKO TIME SYSTEMS INC.                      
+148000-148FFF                 (base 16)                     SEIKO TIME SYSTEMS INC.                      
+                                                            2-4-3 Fukuzumi                               
+                                                            Koto-ku  TOKYO  135-8610                     
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Home Automation Europe                       
+152000-152FFF                 (base 16)                     Home Automation Europe                       
+                                                            Joan Muyskenweg 22                           
+                                                            Amsterdam    1096CJ                          
+                                                            NL                                           
+
+40-D8-55                      (hex)                         GLOBALCOM ENGINEERING SRL                    
+135000-135FFF                 (base 16)                     GLOBALCOM ENGINEERING SRL                    
+                                                            Via Volta 9                                  
+                                                            MORNAGO  VA  21020                           
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Akse srl                                     
+128000-128FFF                 (base 16)                     Akse srl                                     
+                                                            Via Aldo Moro, 39                            
+                                                            Reggio Emilia  Italy  42124                  
+                                                            IT                                           
+
+40-D8-55                      (hex)                         DSP DESIGN                                   
+129000-129FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+40-D8-55                      (hex)                         NSP Europe Ltd                               
+12C000-12CFFF                 (base 16)                     NSP Europe Ltd                               
+                                                            Unit 5, Devonshire Business Park             
+                                                            Borehamwood  Hert  WD6 1NA                   
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Key Systems, Inc.                            
+141000-141FFF                 (base 16)                     Key Systems, Inc.                            
+                                                            PO Box G                                     
+                                                            Fishers  New York  14453                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         InnoTrans Communications, Inc                
+140000-140FFF                 (base 16)                     InnoTrans Communications, Inc                
+                                                            22 Great Oaks Blvd, Ste #100                 
+                                                            San Jose  CA  95119                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         IMPLE SISTEMAS ELETRONICOS EMBARCADOS LTDA   
+104000-104FFF                 (base 16)                     IMPLE SISTEMAS ELETRONICOS EMBARCADOS LTDA   
+                                                            RUA DIVA GARVIA 1663                         
+                                                            JUIZ DE FORA  MINAS GERIAS  36060-300        
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Halliburton - Sperry Drilling Service        
+112000-112FFF                 (base 16)                     Halliburton - Sperry Drilling Service        
+                                                            3000 N. Sam Houston Pkwy E.                  
+                                                            Houston  Texas  77032                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         ATX Networks Ltd.                            
+122000-122FFF                 (base 16)                     ATX Networks Ltd.                            
+                                                            12 Halapid St.                               
+                                                            Petach-Tikva    49517                        
+                                                            IL                                           
+
+40-D8-55                      (hex)                         Peek Traffic Corporation                     
+103000-103FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         OOO Group of Industrial Technologies         
+119000-119FFF                 (base 16)                     OOO Group of Industrial Technologies         
+                                                            Profsoyuznaya st. 124A                       
+                                                            Moscow  Moscow  117321                       
+                                                            RU                                           
+
+40-D8-55                      (hex)                         ALPHA DESIGN CO.,LTD.                        
+108000-108FFF                 (base 16)                     ALPHA DESIGN CO.,LTD.                        
+                                                            1963-4                                       
+                                                            itoshima-city  Fukuoka  819-1122             
+                                                            JP                                           
+
+40-D8-55                      (hex)                         nanoTRONIC GmbH                              
+11B000-11BFFF                 (base 16)                     nanoTRONIC GmbH                              
+                                                            Werkstrasse 27                               
+                                                            Lyss  Bern  3250                             
+                                                            CH                                           
+
+40-D8-55                      (hex)                         Uniscan LLC                                  
+116000-116FFF                 (base 16)                     Uniscan LLC                                  
+                                                            Arbyzova st. 4/26                            
+                                                            Novosibirsk  NSO  630117                     
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Rosslare Enterprises Limited                 
+109000-109FFF                 (base 16)                     Rosslare Enterprises Limited                 
+                                                            Flat 912 Wing Fat Industrial Building        
+                                                            Kowloon Bay  Kowloon                         
+                                                            HK                                           
+
+40-D8-55                      (hex)                         Keocko Holding Kft.                          
+0E2000-0E2FFF                 (base 16)                     Keocko Holding Kft.                          
+                                                            6000 Kecskemét                               
+                                                             Petőfi Sándor utca    11. 9. em. 11.        
+                                                            HU                                           
+
+40-D8-55                      (hex)                         STV Electronic GmbH                          
+0E1000-0E1FFF                 (base 16)                     STV Electronic GmbH                          
+                                                            Hellweg 203-205                              
+                                                            Schloss Holte  Nordrhein Westfalen  33758    
+                                                            DE                                           
+
+40-D8-55                      (hex)                         CST Group                                    
+0F5000-0F5FFF                 (base 16)                     CST Group                                    
+                                                            3012 Rodgerdale Road                         
+                                                            Houston  TX  77042                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         ECON Systems Inc.                            
+0F3000-0F3FFF                 (base 16)                     ECON Systems Inc.                            
+                                                            5414 Lamco Street                            
+                                                            Montgomery  Alabama  36117                   
+                                                            US                                           
+
+40-D8-55                      (hex)                         Kyoritsu Electric Corp.                      
+0E6000-0E6FFF                 (base 16)                     Kyoritsu Electric Corp.                      
+                                                            60 Granton Drive                             
+                                                            Richmond Hill  Ontario  L4B 2N6              
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Medigus Ltd                                  
+0E3000-0E3FFF                 (base 16)                     Medigus Ltd                                  
+                                                            Omer Industrial Park,Building 7A             
+                                                            Omer    8496500                              
+                                                            IL                                           
+
+40-D8-55                      (hex)                         ARAGO SYSTEMS                                
+0E4000-0E4FFF                 (base 16)                     ARAGO SYSTEMS                                
+                                                            5, rue Soutrane                              
+                                                            Sophia Antipolis  France métropolitaine  06560
+                                                            FR                                           
+
+40-D8-55                      (hex)                         WANTECH Networks                             
+0EB000-0EBFFF                 (base 16)                     WANTECH Networks                             
+                                                            7, rue Jemmapes                              
+                                                            MARSEILLE  Bouches-du-Rhône  13001           
+                                                            FR                                           
+
+40-D8-55                      (hex)                         HAMEG GmbH                                   
+0E9000-0E9FFF                 (base 16)                     HAMEG GmbH                                   
+                                                            Industriestr. 6                              
+                                                            Mainhausen    63533                          
+                                                            DE                                           
+
+40-D8-55                      (hex)                         GeneSys Elektronik GmbH                      
+0EF000-0EFFFF                 (base 16)                     GeneSys Elektronik GmbH                      
+                                                            In der Spoeck 10                             
+                                                            77656 Offenburg                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         YUKO ELECTRIC CO.,LTD                        
+0D9000-0D9FFF                 (base 16)                     YUKO ELECTRIC CO.,LTD                        
+                                                            ICHIGAYA BUILDING 2002-12                    
+                                                            TODA CITY  SAITAMA  335-0021                 
+                                                            JP                                           
+
+40-D8-55                      (hex)                         First Design System Inc.                     
+0A7000-0A7FFF                 (base 16)                     First Design System Inc.                     
+                                                            Tachibana Shinjyuku Bldg. 4F                 
+                                                            Shinjyuku-ku,  Tokyo  1600023                
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Shenzhen SETEC Power Co.,Ltd                 
+0BF000-0BFFFF                 (base 16)                     Shenzhen SETEC Power Co.,Ltd                 
+                                                            #199, Setec Industrial Park                  
+                                                            Nanshan District, Shenzhen  Guangdong  518055
+                                                            CN                                           
+
+40-D8-55                      (hex)                         ACT                                          
+0C0000-0C0FFF                 (base 16)                     ACT                                          
+                                                            Unit C1, South City Business Center          
+                                                            Dublin                                       
+                                                            IE                                           
+
+40-D8-55                      (hex)                         T.W.S. srl                                   
+0B3000-0B3FFF                 (base 16)                     T.W.S. srl                                   
+                                                            Viale Zaccagna 6                             
+                                                            Carrara  MS  54033                           
+                                                            IT                                           
+
+40-D8-55                      (hex)                         Nanjing TIANSU Automation Control System Co., Ltd.
+0B1000-0B1FFF                 (base 16)                     Nanjing TIANSU Automation Control System Co., Ltd.
+                                                            Building 5, New Town Science & Technology Park
+                                                            Nanjing    210019                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         insensiv GmbH                                
+0C7000-0C7FFF                 (base 16)                     insensiv GmbH                                
+                                                            Heidsieker Heide 114                         
+                                                            Bielefeld  Nordrhein-Westfalen  33739        
+                                                            DE                                           
+
+40-D8-55                      (hex)                         MITSUBISHI ELECTRIC SYSTEM & SERVICE CO.,LTD.
+0B4000-0B4FFF                 (base 16)                     MITSUBISHI ELECTRIC SYSTEM & SERVICE CO.,LTD.
+                                                            26-43,1-Chome,Yata,Higashi-ku                
+                                                            Nagoya  Aichi  461-0040                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         PCH Engineering A/S                          
+0BA000-0BAFFF                 (base 16)                     PCH Engineering A/S                          
+                                                            Ved Klaedebo 4                               
+                                                            Horsholm    2970                             
+                                                            DK                                           
+
+40-D8-55                      (hex)                         ADVALY SYSTEM Inc.                           
+0A1000-0A1FFF                 (base 16)                     ADVALY SYSTEM Inc.                           
+                                                            7 KITA2 NISHI2 CYUO-KU                       
+                                                            SAPPORO  HOKKAIDO  060-0002                  
+                                                            JP                                           
+
+40-D8-55                      (hex)                         NanoPulse, Inc.                              
+09E000-09EFFF                 (base 16)                     NanoPulse, Inc.                              
+                                                            1 Krasnoselskiy per., 3 pom. I, of. 75       
+                                                              Moscow  107140                             
+                                                            RU                                           
+
+40-D8-55                      (hex)                         Bascules Robbe nv                            
+09F000-09FFFF                 (base 16)                     Bascules Robbe nv                            
+                                                            Noordlaan 7                                  
+                                                            Torhout  West-Vlaanderen  8820               
+                                                            BE                                           
+
+40-D8-55                      (hex)                         MeshWorks Wireless Oy                        
+08B000-08BFFF                 (base 16)                     MeshWorks Wireless Oy                        
+                                                            Hermiankatu 6-8 H                            
+                                                            Tampere  Suomi  33720                        
+                                                            FI                                           
+
+40-D8-55                      (hex)                         Comtel Electronics GmbH                      
+096000-096FFF                 (base 16)                     Comtel Electronics GmbH                      
+                                                            Bretonischer Ring 11                         
+                                                            Grasbrunn    85630                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Telefrank GmbH                               
+0A3000-0A3FFF                 (base 16)                     Telefrank GmbH                               
+                                                            Am Wildengrund 1                             
+                                                            Altenambach  TH  98553                       
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Magnescale Co.,Ltd                           
+08C000-08CFFF                 (base 16)                     Magnescale Co.,Ltd                           
+                                                            45,Suzukawa                                  
+                                                            Isehara  Kanagawa  259-1146                  
+                                                            JP                                           
+
+40-D8-55                      (hex)                         DelfiSolutions A/S                           
+079000-079FFF                 (base 16)                     DelfiSolutions A/S                           
+                                                            Augustenborglandevej 7                       
+                                                            Sønderborg  Denmark  6400                    
+                                                            DK                                           
+
+40-D8-55                      (hex)                         Sicon srl                                    
+081000-081FFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+40-D8-55                      (hex)                         DSP DESIGN                                   
+086000-086FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Teraflops                                    
+075000-075FFF                 (base 16)                     Teraflops                                    
+                                                            1326 Monde                                   
+                                                            Sojya city  Okayama prefecture  7191156      
+                                                            JP                                           
+
+40-D8-55                      (hex)                         elgris                                       
+06A000-06AFFF                 (base 16)                     elgris                                       
+                                                            Krantzstr 7                                  
+                                                            Aachen  NRW  52070                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Wheatstone Corporation                       
+07F000-07FFFF                 (base 16)                     Wheatstone Corporation                       
+                                                            600 Industrial Drive                         
+                                                            New Bern  NC  28562                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         EPSa GmbH                                    
+05F000-05FFFF                 (base 16)                     EPSa GmbH                                    
+                                                            Remschuetzer Strasse 1                       
+                                                            Saalfeld/Saale  Thuringia  07318             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Tech Source Inc                              
+062000-062FFF                 (base 16)                     Tech Source Inc                              
+                                                            442 Northlake Blvd                           
+                                                            Altamonte Springs  FL  32701                 
+                                                            US                                           
+
+40-D8-55                      (hex)                         Tronic Control ltd.                          
+067000-067FFF                 (base 16)                     Tronic Control ltd.                          
+                                                            Nad Safinou I, 449                           
+                                                            Vestec u Prahy    25242                      
+                                                            CZ                                           
+
+40-D8-55                      (hex)                         TeraTron GmbH                                
+066000-066FFF                 (base 16)                     TeraTron GmbH                                
+                                                            Bunsenstr. 10                                
+                                                            Gummersbach  DE  51647                       
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Shanghai o-solution electronics & Technology Co., Ltd.
+023000-023FFF                 (base 16)                     Shanghai o-solution electronics & Technology Co., Ltd.
+                                                            4226 Duzhuang Rd, Minhang District           
+                                                            Shanghai  Shanghai  201108                   
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Digimerge Technology Inc                     
+022000-022FFF                 (base 16)                     Digimerge Technology Inc                     
+                                                            250 Royal Crest Court                        
+                                                            Markham  Ontario  L3R 3S1                    
+                                                            CA                                           
+
+40-D8-55                      (hex)                         Elgama Sistemos                              
+02D000-02DFFF                 (base 16)                     Elgama Sistemos                              
+                                                            Visoriu g. 2                                 
+                                                              Vilniaus  LT-08300                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Nomatronics                                  
+02B000-02BFFF                 (base 16)                     Nomatronics                                  
+                                                            Kastanienweg 35E                             
+                                                            Diedrichshagen  M/V  17498                   
+                                                            DE                                           
+
+40-D8-55                      (hex)                         SchulerControl GmbH                          
+043000-043FFF                 (base 16)                     SchulerControl GmbH                          
+                                                            Richard-Schirrmannstr. 29                    
+                                                            Titisee-Neustadt  BW  79822                  
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Schweers informationstechnologie GmbH        
+036000-036FFF                 (base 16)                     Schweers informationstechnologie GmbH        
+                                                            Rudolf-Diesel-Str. 18                        
+                                                            Meerbusch    40670                           
+                                                            DE                                           
+
+40-D8-55                      (hex)                         InventLab s.c.                               
+02C000-02CFFF                 (base 16)                     InventLab s.c.                               
+                                                            ul. Czarodziejska 22                         
+                                                            Wolka Kozodawska  Masovian  05-502           
+                                                            PL                                           
+
+00-50-C2                      (hex)                         MSR-Solutions GmbH                           
+FFF000-FFFFFF                 (base 16)                     MSR-Solutions GmbH                           
+                                                            Friedrich-Ebert-Straße 20/2                  
+                                                            Wangen  Baden-Württemberg  88239             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         A2S                                          
+01E000-01EFFF                 (base 16)                     A2S                                          
+                                                            ZA Le Rival 2                                
+                                                            Lafran    82130                              
+                                                            FR                                           
+
+40-D8-55                      (hex)                         BERG Cloud Limited                           
+01C000-01CFFF                 (base 16)                     BERG Cloud Limited                           
+                                                            Epworth House                                
+                                                              London  EC1Y 1AA                           
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Sencon Inc.                                  
+012000-012FFF                 (base 16)                     Sencon Inc.                                  
+                                                            6385 W. 74th Street                          
+                                                            Bedford Park  IL  60638                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         XRONOS.INC                                   
+000000-000FFF                 (base 16)                     XRONOS.INC                                   
+                                                            SENDAGAYA1-9-6                               
+                                                            TOKYO    151-0051                            
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Vemotion                                     
+001000-001FFF                 (base 16)                     Vemotion                                     
+                                                            Teleware House                               
+                                                            Thirsk  North Yorkshire  YO7 3BX             
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Franke Aquarotter GmbH                       
+017000-017FFF                 (base 16)                     Franke Aquarotter GmbH                       
+                                                            Parkstra                                     
+                                                            Ludwigsfelde    14974                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Touchless Biometric Systems AG               
+FFD000-FFDFFF                 (base 16)                     Touchless Biometric Systems AG               
+                                                            Rietbrunnen 2                                
+                                                            Pfaeffikon SZ    8808                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Spirent Communications                       
+FFC000-FFCFFF                 (base 16)                     Spirent Communications                       
+                                                            541 Industrial Way West                      
+                                                            Eatontown  New Jersey  07724                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sparks Instruments SA                        
+FEE000-FEEFFF                 (base 16)                     Sparks Instruments SA                        
+                                                            Bodematta 12                                 
+                                                            Heitenried  FR  1714                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Axible Technologies                          
+FEB000-FEBFFF                 (base 16)                     Axible Technologies                          
+                                                            425 Rue Jean Rostand                         
+                                                            Labège    31670                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Scandinova Systems AB                        
+FE5000-FE5FFF                 (base 16)                     Scandinova Systems AB                        
+                                                            Ulltunaallen 2A                              
+                                                              UPPSALA  75651                             
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Toptech Systems, Inc.                        
+FDD000-FDDFFF                 (base 16)                     Toptech Systems, Inc.                        
+                                                            1124 Florida Central Parkway                 
+                                                            Longwood  FL  32750                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Soudronic AG                                 
+FCC000-FCCFFF                 (base 16)                     Soudronic AG                                 
+                                                            Industriestrasse 35                          
+                                                            Bergdietikon    CH-8962                      
+                                                            CH                                           
+
+00-50-C2                      (hex)                         HSDC Sp. z o.o.                              
+FC3000-FC3FFF                 (base 16)                     HSDC Sp. z o.o.                              
+                                                            SNIADECKICH 10 VP                            
+                                                            Warszawa  Mazowieckie  00-656                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Hilkom digital GmbH                          
+FA6000-FA6FFF                 (base 16)                     Hilkom digital GmbH                          
+                                                            TecCenter 1                                  
+                                                            Bad Salzdetfurth  Niedersachsen  D-31162     
+                                                            US                                           
+
+00-50-C2                      (hex)                         N-Hands GmbH und Co KG                       
+FA1000-FA1FFF                 (base 16)                     N-Hands GmbH und Co KG                       
+                                                            Kreuzgaerten 2                               
+                                                            Idstein    65510                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ADETEL GROUP                                 
+FAC000-FACFFF                 (base 16)                     ADETEL GROUP                                 
+                                                            4, Chemin du Ruisseau                        
+                                                            ECULLY    69130                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         MATELEX                                      
+FB1000-FB1FFF                 (base 16)                     MATELEX                                      
+                                                            2 RUE GUSTAVE EIFFEL                         
+                                                            TROYES    10430                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         RE2 Inc                                      
+F91000-F91FFF                 (base 16)                     RE2 Inc                                      
+                                                            4925 Harrison St                             
+                                                            Pittsburgh  Pennsylvania  15201              
+                                                            US                                           
+
+00-50-C2                      (hex)                         GPO                                          
+F8E000-F8EFFF                 (base 16)                     GPO                                          
+                                                            SK-Technopark B/D D-1007,8 #1345             
+                                                            Gwangmyeong-Si  Gyeonggi-Do  423-050         
+                                                            KR                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+F8A000-F8AFFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Noralta Technologies Inc                     
+F70000-F70FFF                 (base 16)                     Noralta Technologies Inc                     
+                                                            2350, 444 - 5 Ave S.W.                       
+                                                            Calgary  Alberta  T2P 2T8                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         MaxDeTec AG                                  
+F72000-F72FFF                 (base 16)                     MaxDeTec AG                                  
+                                                            Dorfstrasse 54                               
+                                                            Thalwil  Zurich  8800                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Rong Jie(FuZhou)Electronics Co.,Ltd          
+F76000-F76FFF                 (base 16)                     Rong Jie(FuZhou)Electronics Co.,Ltd          
+                                                            No. 38, Jinqiao Road, Wuhan City,            
+                                                            wuhan  hubei  430000                         
+                                                            CN                                           
+
+00-50-C2                      (hex)                         OFI Inc. (dba 2D2C)                          
+F6A000-F6AFFF                 (base 16)                     OFI Inc. (dba 2D2C)                          
+                                                            100 Hanson Avenue                            
+                                                            Kitchener  Ontario  N2C2E2                   
+                                                            CA                                           
+
+00-50-C2                      (hex)                         G3 Technologies                              
+F59000-F59FFF                 (base 16)                     G3 Technologies                              
+                                                            2904 Back Acre Circle                        
+                                                            Mount Airy  MD  21771                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Reach Technologies Inc.                      
+F57000-F57FFF                 (base 16)                     Reach Technologies Inc.                      
+                                                            106 - 3025 Shakespeare Street                
+                                                            Victoria  BC  V8R 4H6                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         HUSTY M.Styczen J.Hupert Sp.J.               
+F45000-F45FFF                 (base 16)                     HUSTY M.Styczen J.Hupert Sp.J.               
+                                                            Rzepakowa 5e                                 
+                                                            Krakow  malopolska  31-989                   
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Enistic Limited                              
+F4C000-F4CFFF                 (base 16)                     Enistic Limited                              
+                                                            Unit 4, Isis Business Centre                 
+                                                            Oxford  Oxfordshire  OX4 2RD                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ELAN SYSTEMS                                 
+F27000-F27FFF                 (base 16)                     ELAN SYSTEMS                                 
+                                                            10 IHASZ STR                                 
+                                                            BUDAPEST    1105                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Verified Energy, LLC.                        
+F1F000-F1FFFF                 (base 16)                     Verified Energy, LLC.                        
+                                                            PO Box 111                                   
+                                                            Oneida  New York  13421                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+F3A000-F3AFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TAMS firmware co.                            
+F3B000-F3BFFF                 (base 16)                     TAMS firmware co.                            
+                                                            aota5-15-26                                  
+                                                            yamagata    990-2435                         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         RADYNE CORPORATION                           
+F29000-F29FFF                 (base 16)                     RADYNE CORPORATION                           
+                                                            211 West Boden Street                        
+                                                            Milwaukee  Wisconsin  53207                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+F1B000-F1BFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Netlink Bilisim Sistemleri San. ve Tic. Ltd. Sti.
+F19000-F19FFF                 (base 16)                     Netlink Bilisim Sistemleri San. ve Tic. Ltd. Sti.
+                                                            Caferaða mah. Sakiz sk. no:8/10 Kadikoy      
+                                                            Istanbul    34710                            
+                                                            TR                                           
+
+00-50-C2                      (hex)                         KINKI ROENTGEN INDUSTRIAL CO.,LTD            
+F04000-F04FFF                 (base 16)                     KINKI ROENTGEN INDUSTRIAL CO.,LTD            
+                                                            259 Kamidachiuri-Agaru Muromachidori,        
+                                                            Kyoto    6020029                             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         BMR                                          
+F02000-F02FFF                 (base 16)                     BMR                                          
+                                                            Balbinova 252                                
+                                                            Rychnov nad Kneznou    51601                 
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         General Industrial Controls Pvt Ltd          
+F12000-F12FFF                 (base 16)                     General Industrial Controls Pvt Ltd          
+                                                            T107, M.I.D.C.                               
+                                                            Pune  Maharashtra  411026                    
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Packet Plus, Inc.                            
+F13000-F13FFF                 (base 16)                     Packet Plus, Inc.                            
+                                                            1320 SW Hall St                              
+                                                            Portland  OR  97201                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SKYCHANNEL LTD                               
+F0C000-F0CFFF                 (base 16)                     SKYCHANNEL LTD                               
+                                                            567 - 5 TH FLOOR BUILDING 1                  
+                                                            SHENZHEN   GUANGDONG   518054                
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Kamacho Scale Co., Ltd.                      
+EE8000-EE8FFF                 (base 16)                     Kamacho Scale Co., Ltd.                      
+                                                            2246 Mure                                    
+                                                            Takamatsu-shi  Kagawa-ken  761-0196          
+                                                            JP                                           
+
+00-50-C2                      (hex)                         B:TECH, a. s.                                
+EE6000-EE6FFF                 (base 16)                     B:TECH, a. s.                                
+                                                            U Borove 69                                  
+                                                            Havlickuv Brod    580 01                     
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         syes srl                                     
+EE7000-EE7FFF                 (base 16)                     syes srl                                     
+                                                            via zanella,21                               
+                                                            lissone ( MB )  monza Brianza  20851         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Positioneering Limited                       
+EEA000-EEAFFF                 (base 16)                     Positioneering Limited                       
+                                                            Gordon House                                 
+                                                            Aberdeen  Aberdeenshire  AB12 3BR            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Smart Grid Networks                          
+EDE000-EDEFFF                 (base 16)                     Smart Grid Networks                          
+                                                            Rombvagen 7                                  
+                                                            Lyckeby  Blekinge  37165                     
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Smart Power Electronics GmbH & Co. KG        
+EF3000-EF3FFF                 (base 16)                     Smart Power Electronics GmbH & Co. KG        
+                                                            Lise-Meitner-Straße 21                       
+                                                            Itzehoe  Schleswig-Holstein  25524           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FAL Corp                                     
+ECB000-ECBFFF                 (base 16)                     FAL Corp                                     
+                                                            205 3-7-2                                    
+                                                            Katsushikaku  Tokyo  124-0013                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         LIQUID ROBOTICS, INC                         
+EC7000-EC7FFF                 (base 16)                     LIQUID ROBOTICS, INC                         
+                                                            1329 MOFFETT PARK DRIVE                      
+                                                            SUNNYVALE  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         AVocation Systems, Inc.                      
+ED8000-ED8FFF                 (base 16)                     AVocation Systems, Inc.                      
+                                                            7130 W. 117th Ave.                           
+                                                            Broomfield  CO  80020                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nippon Systemware Co.,Ltd.                   
+ED0000-ED0FFF                 (base 16)                     Nippon Systemware Co.,Ltd.                   
+                                                            Shibuya Office 9F                            
+                                                            Shibuya-ku  Tokyo  150-0036                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         RSUPPORT Co., Ltd.                           
+EC5000-EC5FFF                 (base 16)                     RSUPPORT Co., Ltd.                           
+                                                            45, Bangi2-dong, Songpa-gu                   
+                                                            Seoul  Soul-t|ukpyolsi  138724               
+                                                            KR                                           
+
+00-50-C2                      (hex)                         American Microsystems, Ltd.                  
+E9E000-E9EFFF                 (base 16)                     American Microsystems, Ltd.                  
+                                                            2190 Regal Parkway                           
+                                                            Euless  Texas  76040                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Diehl AKO Stiftung & Co. KG                  
+EBC000-EBCFFF                 (base 16)                     Diehl AKO Stiftung & Co. KG                  
+                                                            Pfannerstr. 75                               
+                                                            Wangen    88239                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TimeTerminal Adductor Group AB               
+EBB000-EBBFFF                 (base 16)                     TimeTerminal Adductor Group AB               
+                                                            Hammarbacken 4 A                             
+                                                            Sollentuna    SE-19149                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ALPHA-MOS                                    
+EB9000-EB9FFF                 (base 16)                     ALPHA-MOS                                    
+                                                            20 Avenue Didier Daurat                      
+                                                            Toulouse    31400                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Subsea Systems, Inc.                         
+EA3000-EA3FFF                 (base 16)                     Subsea Systems, Inc.                         
+                                                            2290 Eastman Avenue                          
+                                                            Ventura  CA  93003                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Monsoon Solutions, Inc.                      
+EB6000-EB6FFF                 (base 16)                     Monsoon Solutions, Inc.                      
+                                                            2405 140th Ave NE                            
+                                                            Bellevue  WA  98005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cosmo Life Co.,Ltd                           
+E85000-E85FFF                 (base 16)                     Cosmo Life Co.,Ltd                           
+                                                            Kounan2-16-7                                 
+                                                            Minato-ku  Tokyo  108-0075                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         sp controls, inc                             
+E7C000-E7CFFF                 (base 16)                     sp controls, inc                             
+                                                            930 linden ave                               
+                                                            south san francisco  ca  94080               
+                                                            US                                           
+
+00-50-C2                      (hex)                         ATOM GIKEN Co.,Ltd.                          
+E7B000-E7BFFF                 (base 16)                     ATOM GIKEN Co.,Ltd.                          
+                                                            92-2 KATASE                                  
+                                                            FUJISAWA  KANAGAWA  251-0032                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Hentschel System GmbH                        
+E9B000-E9BFFF                 (base 16)                     Hentschel System GmbH                        
+                                                            Carl-Buderus-Str. 5                          
+                                                            Hannover  Lower Saxony  30455                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ANA-U GmbH                                   
+E94000-E94FFF                 (base 16)                     ANA-U GmbH                                   
+                                                            Moosgrabenstrasse 32                         
+                                                            Gleisdorf  Steiermark  8200                  
+                                                            AT                                           
+
+00-50-C2                      (hex)                         RFENGINE CO., LTD.                           
+E56000-E56FFF                 (base 16)                     RFENGINE CO., LTD.                           
+                                                            2/809, ITCASTLE, 550-1 GASAN-DONG            
+                                                            SEOUL    153-768                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         SAMSUNG Electronics Co.,Ltd.(LED Division)   
+E6C000-E6CFFF                 (base 16)                     SAMSUNG Electronics Co.,Ltd.(LED Division)   
+                                                            San #24 Nongseo-Dong                         
+                                                            Yongin-City, Suwon-City  Gyeonggi-do  446-711
+                                                            KR                                           
+
+00-50-C2                      (hex)                         EOLANE MONTCEAU                              
+E57000-E57FFF                 (base 16)                     EOLANE MONTCEAU                              
+                                                            ZI STE ELIZABETH                             
+                                                            MONTCEAU LES MINES  SA  71300                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         FSM AG                                       
+E75000-E75FFF                 (base 16)                     FSM AG                                       
+                                                            Scheffelstraße 49                            
+                                                            Kirchzarten  Baden-Württemberg  79199        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Embedded Solution Bank Co., Ltd.             
+E76000-E76FFF                 (base 16)                     Embedded Solution Bank Co., Ltd.             
+                                                            #905 A, Woolim Lions Valley 5, 144-3         
+                                                            Seongnam-Si  Kyunggi-Do  462-120             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         VISITO S.R.L.                                
+E3F000-E3FFFF                 (base 16)                     VISITO S.R.L.                                
+                                                            Corso Duca Degli Abruzzi 2                   
+                                                            TORINO                                       
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Monnit Corp.                                 
+E3E000-E3EFFF                 (base 16)                     Monnit Corp.                                 
+                                                            450 South Simmons Way                        
+                                                            Kaysville  UT   84037                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wine Technology Marlborough                  
+E4F000-E4FFFF                 (base 16)                     Wine Technology Marlborough                  
+                                                            28 High Street                               
+                                                            Renwick  Marlborough  7204                   
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+E50000-E50FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Motec Pty Ltd                                
+E51000-E51FFF                 (base 16)                     Motec Pty Ltd                                
+                                                            121 Merrindale Drive                         
+                                                            Croydon South  Victoria  3136                
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Higeco S.r.l.                                
+E41000-E41FFF                 (base 16)                     Higeco S.r.l.                                
+                                                            Via Cal De Formiga 12                        
+                                                            Santa Giustina  Veneto  32035                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Technica Engineering GmbH                    
+E43000-E43FFF                 (base 16)                     Technica Engineering GmbH                    
+                                                            Olschewskibogen 18                           
+                                                            Munich    80935                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Funkwerk IT Karlsfeld GmbH                   
+E2D000-E2DFFF                 (base 16)                     Funkwerk IT Karlsfeld GmbH                   
+                                                            Liebigstrasse 1a                             
+                                                            Karlsfeld  Bavaria  85757                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Plant Integrity Limited                      
+E2B000-E2BFFF                 (base 16)                     Plant Integrity Limited                      
+                                                            Granta Park                                  
+                                                            Cambridge  Cambridgeshire  CB21 6AL          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+E25000-E25FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Embedded Labs                                
+E1B000-E1BFFF                 (base 16)                     Embedded Labs                                
+                                                            Unit 31 Waterford Business Park              
+                                                            Waterford                                    
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+E29000-E29FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Protagon Process Technologies GmbH           
+E07000-E07FFF                 (base 16)                     Protagon Process Technologies GmbH           
+                                                            Ringstrasse 11                               
+                                                            Rengsdorf  RLP  56579                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         BETTINI SRL                                  
+DFB000-DFBFFF                 (base 16)                     BETTINI SRL                                  
+                                                            VIA CESARE BATTISTI 22                       
+                                                            CESANO MADERNO  MILAN  20031                 
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Jenny Science AG                             
+DF9000-DF9FFF                 (base 16)                     Jenny Science AG                             
+                                                            D4 Platz 4                                   
+                                                            Root    6039                                 
+                                                            CH                                           
+
+00-50-C2                      (hex)                         MAC Valves, Inc.                             
+DFA000-DFAFFF                 (base 16)                     MAC Valves, Inc.                             
+                                                            30569 Beck Rd                                
+                                                            Wixom  MI  48393                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elan Systems                                 
+DE7000-DE7FFF                 (base 16)                     Elan Systems                                 
+                                                            10 Ihasz utca                                
+                                                            BUDAPEST    1105                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         Visual Productions                           
+DE8000-DE8FFF                 (base 16)                     Visual Productions                           
+                                                            Rollandstraat 55ZW                           
+                                                            Haarlem    2013SM                            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+DF1000-DF1FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Cerner Corporation                           
+DEA000-DEAFFF                 (base 16)                     Cerner Corporation                           
+                                                            2800 Rockcreek Parkway                       
+                                                            Kansas City   MO  64117                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Friend Spring Industrial Co., Ltd.           
+DD5000-DD5FFF                 (base 16)                     Friend Spring Industrial Co., Ltd.           
+                                                            4F., No. 8, Lane 50, Sec. 3                  
+                                                            Taipei    115                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Breakaway Systems LLC                        
+DE3000-DE3FFF                 (base 16)                     Breakaway Systems LLC                        
+                                                            10307 Sugar Hill Dr                          
+                                                            Houston  TX  77042                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         M.P. Electronics                             
+DBA000-DBAFFF                 (base 16)                     M.P. Electronics                             
+                                                            2464 Vulcan Road                             
+                                                            Apopka  Florida  32703                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         dilitronics GmbH                             
+DCD000-DCDFFF                 (base 16)                     dilitronics GmbH                             
+                                                            Felsbachstr. 5                               
+                                                            Jena  Thuringia  07745                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Acrux Technology Limited                     
+DC1000-DC1FFF                 (base 16)                     Acrux Technology Limited                     
+                                                            Rm 2A6, 3/F, Sing Win Factory Building,15-17 Shing Yip St, 
+                                                            Kwun Tong                                    
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Mistral Solutions Pvt. Ltd                   
+D9D000-D9DFFF                 (base 16)                     Mistral Solutions Pvt. Ltd                   
+                                                            #60, Adarsh Regent, 100 Ft. Ring Road,Domlur Extension
+                                                            BANGALORE  KARNATAKA   560071                
+                                                            IN                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+DB5000-DB5FFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+DAD000-DADFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+DA1000-DA1FFF                 (base 16)                     MangoDSP                                     
+                                                            8 Hartom St. Beck Science Center             
+                                                            Jerusalem     91450                          
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Syes srl                                     
+D8F000-D8FFFF                 (base 16)                     Syes srl                                     
+                                                            Via Zanella 21                               
+                                                            Lissone  MB  20035                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         OptoLink  Industria e Comercio Ltda          
+D8A000-D8AFFF                 (base 16)                     OptoLink  Industria e Comercio Ltda          
+                                                            R.Alfredo da Costa Figo 280                  
+                                                            Campinas  SP  13087-534                      
+                                                            BR                                           
+
+00-50-C2                      (hex)                         CONTEC GmbH                                  
+D96000-D96FFF                 (base 16)                     CONTEC GmbH                                  
+                                                            Wildbichler Strasse 2e                       
+                                                            Ebbs  TIROL  6341                            
+                                                            AT                                           
+
+00-50-C2                      (hex)                         ECOMM ERA                                    
+D86000-D86FFF                 (base 16)                     ECOMM ERA                                    
+                                                            Flat H, 14/F, Kim Tak Building               
+                                                                201203                                   
+                                                            HK                                           
+
+00-50-C2                      (hex)                         DSI RF Systems, Inc.                         
+D79000-D79FFF                 (base 16)                     DSI RF Systems, Inc.                         
+                                                            26H Worlds Fair Drive                        
+                                                            Somerset  NJ  08873                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         KLING & FREITAG GmbH                         
+D67000-D67FFF                 (base 16)                     KLING & FREITAG GmbH                         
+                                                            Junkersstrasse 14                            
+                                                            Hannover  NDS  30179                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         NIK-ELEKTRONIKA Ltd                          
+D58000-D58FFF                 (base 16)                     NIK-ELEKTRONIKA Ltd                          
+                                                            L.Kurbasa Ave 2-B                            
+                                                            Kiev    03148                                
+                                                            UA                                           
+
+00-50-C2                      (hex)                         Video Tech Laboratories, Inc.                
+D2B000-D2BFFF                 (base 16)                     Video Tech Laboratories, Inc.                
+                                                            2761-1 Togo, Shimokanuki                     
+                                                            Numazu  Shizuoka Prefecture  410-0822        
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Schneider Electric Motion USA                
+D2C000-D2CFFF                 (base 16)                     Schneider Electric Motion USA                
+                                                            370 N. Main St.                              
+                                                            Marlborough  CT  06447                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+D28000-D28FFF                 (base 16)                     Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+                                                            Schallbruch 19-21                            
+                                                            Haan  NRW  42781                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Thales Nederland BV                          
+D46000-D46FFF                 (base 16)                     Thales Nederland BV                          
+                                                            Haaksbergerstraat 49                         
+                                                            Hengelo  Overijssel  7554PA                  
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Hagenuk KMT GmbH                             
+D42000-D42FFF                 (base 16)                     Hagenuk KMT GmbH                             
+                                                            Röderaue 41                                  
+                                                            Radeburg  Sachsen  01471                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         UG Systems GmbH & Co. KG                     
+D35000-D35FFF                 (base 16)                     UG Systems GmbH & Co. KG                     
+                                                            Kronacher Str. 41                            
+                                                            Bamberg  Bayern  96052                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         UNGAVA Technologies Inc.                     
+D31000-D31FFF                 (base 16)                     UNGAVA Technologies Inc.                     
+                                                            2750 rue Einstein                            
+                                                            Quebec    G1P 4R1                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Innovative Circuit Technology                
+D21000-D21FFF                 (base 16)                     Innovative Circuit Technology                
+                                                            26921 Gloucester Way                         
+                                                            Langley  BC  V4W 3Y3                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Tobila Systems, Inc.                         
+D1E000-D1EFFF                 (base 16)                     Tobila Systems, Inc.                         
+                                                            1-8-23-6A                                    
+                                                            Nagoya  Aichi  4600002                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Yardney Technical Products Inc.              
+D4D000-D4DFFF                 (base 16)                     Yardney Technical Products Inc.              
+                                                            82 Mechanic Street                           
+                                                            Pawcatuck  Connecticut  06379                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Aanderaa Data Instruments                    
+D01000-D01FFF                 (base 16)                     Aanderaa Data Instruments                    
+                                                            Nesttunalsringen 5B                          
+                                                            Midtun  Hordaland  5828                      
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Infrasafe, Inc.                              
+CFF000-CFFFFF                 (base 16)                     Infrasafe, Inc.                              
+                                                            12612 Challenger Pkwy                        
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Techleader                                   
+CFE000-CFEFFF                 (base 16)                     Techleader                                   
+                                                            HYEON BLDG 4TH FL 157-1 CHUNUI-DONG          
+                                                            BUCHEON-SHI  KYONGGI-DO  420-859             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         nCk Research LLC                             
+D06000-D06FFF                 (base 16)                     nCk Research LLC                             
+                                                            106 Cobblestone Court Drive                  
+                                                            Victor  NY  14564                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mac-Gray Corporation                         
+CCE000-CCEFFF                 (base 16)                     Mac-Gray Corporation                         
+                                                            404 Wyman Street                             
+                                                            Waltham  MA  02451                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+CD1000-CD1FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Industrial Automatics Design Bureau          
+CE3000-CE3FFF                 (base 16)                     Industrial Automatics Design Bureau          
+                                                            239 Bolshaya Sadovaya St                     
+                                                            Saratov  Saratovskaya oblast  410005         
+                                                            RU                                           
+
+00-50-C2                      (hex)                         CoreEL TEchnologies (I) Pvt Ltd              
+CDF000-CDFFFF                 (base 16)                     CoreEL TEchnologies (I) Pvt Ltd              
+                                                            No.21,7th Main                               
+                                                            Bangalore  Karntaka  560034                  
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Arktan Systems                               
+CD6000-CD6FFF                 (base 16)                     Arktan Systems                               
+                                                            580 California Street, Suite 1200            
+                                                            San Francisco  CA  94104                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Promess GmbH                                 
+CC9000-CC9FFF                 (base 16)                     Promess GmbH                                 
+                                                            Schaffhausener Str. 44                       
+                                                            Berlin    12099                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Inviso B.V.                                  
+CF0000-CF0FFF                 (base 16)                     Inviso B.V.                                  
+                                                            Kouter 106                                   
+                                                            Gemert  Noord Brabant  5422AD                
+                                                            NL                                           
+
+00-50-C2                      (hex)                         GEA Farm Technologies GmbH                   
+CB4000-CB4FFF                 (base 16)                     GEA Farm Technologies GmbH                   
+                                                            Siemensstr. 25-27                            
+                                                            Bonen  NRW  59199                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CODE BLUE CORPORATION                        
+CBE000-CBEFFF                 (base 16)                     CODE BLUE CORPORATION                        
+                                                            259 Hedcor St                                
+                                                            HOLLAND  MI  49423                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         World Time Solutions Limited                 
+CC0000-CC0FFF                 (base 16)                     World Time Solutions Limited                 
+                                                            6 Clinton Crescent                           
+                                                            Aylesbury  Buckinghamshire  HP21 7JW         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Krontek Pty Ltd                              
+CB6000-CB6FFF                 (base 16)                     Krontek Pty Ltd                              
+                                                            2 Carinya Close                              
+                                                            Allambie  NSW  2100                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Raith GmbH                                   
+CB8000-CB8FFF                 (base 16)                     Raith GmbH                                   
+                                                            Konrad-Adenauer-Allee 8                      
+                                                            Dortmund    44263                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Systems With Intelligence Inc.               
+CA8000-CA8FFF                 (base 16)                     Systems With Intelligence Inc.               
+                                                            1215 Meyerside Drive, Unit 7                 
+                                                            Mississauga  Ontario  L5T 1H3                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         OCAS AS                                      
+C8B000-C8BFFF                 (base 16)                     OCAS AS                                      
+                                                            Brobekkvn 80A                                
+                                                            Oslo    0582                                 
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Lanmark Controls Inc.                        
+C8C000-C8CFFF                 (base 16)                     Lanmark Controls Inc.                        
+                                                            125 Nagog Park                               
+                                                            Acton  MA  01720                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         PACOMP Sp. z o.o.                            
+C9A000-C9AFFF                 (base 16)                     PACOMP Sp. z o.o.                            
+                                                            Pulawska 34                                  
+                                                            Piaseczno  mazowieckie  05-500               
+                                                            PL                                           
+
+00-50-C2                      (hex)                         IPSES S.r.l.                                 
+C95000-C95FFF                 (base 16)                     IPSES S.r.l.                                 
+                                                            Via Trieste, 48                              
+                                                            Cesate  Milano  20020                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Micro I/O Servicos de Electronica, Lda       
+C65000-C65FFF                 (base 16)                     Micro I/O Servicos de Electronica, Lda       
+                                                            Zona Industrial da Taboeira, Lote 31D        
+                                                            Aveiro    3800-055 - AVEIRO                  
+                                                            PT                                           
+
+00-50-C2                      (hex)                         KS Beschallungstechnik GmbH                  
+C66000-C66FFF                 (base 16)                     KS Beschallungstechnik GmbH                  
+                                                            Westendstr.1                                 
+                                                            Hettenleidelheim  Rhineland-Palatinate  67310
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Industry Controls, Inc.                      
+C73000-C73FFF                 (base 16)                     Industry Controls, Inc.                      
+                                                            16124 Rosecrans Ave. Suite E5                
+                                                            La Mirada  CA  90638                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Buerkert Werke GmbH                          
+C7E000-C7EFFF                 (base 16)                     Buerkert Werke GmbH                          
+                                                            Christian-Buerkert-Strasse 13-17             
+                                                            Ingelfingen    74653                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Protonic Holland                             
+C7A000-C7AFFF                 (base 16)                     Protonic Holland                             
+                                                            Factorij 36                                  
+                                                            Zwaag    1689 AL                             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Integration Technologies Limited             
+C60000-C60FFF                 (base 16)                     Integration Technologies Limited             
+                                                            Level 4 City Council Building                
+                                                            Palmerston North  Manawatu  4410             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Elaso AG                                     
+C4E000-C4EFFF                 (base 16)                     Elaso AG                                     
+                                                            Gewerbestrasse 14                            
+                                                            Zuchwil  Solothurn  4528                     
+                                                            CH                                           
+
+00-50-C2                      (hex)                         InForce Computing, Inc.                      
+C51000-C51FFF                 (base 16)                     InForce Computing, Inc.                      
+                                                            48860 Milmont Drive, Suite 101C              
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lancier Monitoring GmbH                      
+C4C000-C4CFFF                 (base 16)                     Lancier Monitoring GmbH                      
+                                                            Gustav-Stresemann-Weg 11                     
+                                                            Muenster  NRW  48155                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Herrick Technology Laboratories, Inc.        
+C4A000-C4AFFF                 (base 16)                     Herrick Technology Laboratories, Inc.        
+                                                            670 North Commercial Street                  
+                                                            Manchester  New Hampshire  03101             
+                                                            US                                           
+
+00-50-C2                      (hex)                         R.V.R. elettronica s.p.a.                    
+C4B000-C4BFFF                 (base 16)                     R.V.R. elettronica s.p.a.                    
+                                                            via del Fonditore 2/2c                       
+                                                            Bologna    40138                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         B.E.A.R. Solutions (Australasia) Pty, Ltd    
+C37000-C37FFF                 (base 16)                     B.E.A.R. Solutions (Australasia) Pty, Ltd    
+                                                            Unit 226                                     
+                                                            Bella Vista  NSW                             
+                                                            AU                                           
+
+00-50-C2                      (hex)                         SET GmbH                                     
+C36000-C36FFF                 (base 16)                     SET GmbH                                     
+                                                            August-Braun-Str. 1                          
+                                                            Wangen i.A.    88239                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Eilersen Electric A/S                        
+C53000-C53FFF                 (base 16)                     Eilersen Electric A/S                        
+                                                            Kokkedal Industripark 4                      
+                                                            Kokkedal    2980                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Beceem Communications, Inc.                  
+C50000-C50FFF                 (base 16)                     Beceem Communications, Inc.                  
+                                                            3960 Freedom Cir., 1st Floor                 
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+C42000-C42FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DISMUNTEL SAL                                
+C2E000-C2EFFF                 (base 16)                     DISMUNTEL SAL                                
+                                                            Pol ind cotes                                
+                                                            Algemesi  Valencia  46680                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+C2D000-C2DFFF                 (base 16)                     Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+                                                            Schallbruch 19-21                            
+                                                            Haan  NRW  42781                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Foerster-Technik GmbH                        
+C58000-C58FFF                 (base 16)                     Foerster-Technik GmbH                        
+                                                            Gerwigstraße 25                              
+                                                            Engen  Baden-Württemberg  78234              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Newtel Engineering S.r.l.                    
+C29000-C29FFF                 (base 16)                     Newtel Engineering S.r.l.                    
+                                                            via Strecciola, 7                            
+                                                            Malgrate  LC  23864                          
+                                                            IT                                           
+
+00-50-C2                      (hex)                         OKI DENKI BOHSAI CO.,LTD.                    
+C12000-C12FFF                 (base 16)                     OKI DENKI BOHSAI CO.,LTD.                    
+                                                            Oomori-Hinoshita 9-1                         
+                                                            Fukushima-City  Fukushima  960-1101          
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Fr. SauterAG                                 
+C0D000-C0DFFF                 (base 16)                     Fr. SauterAG                                 
+                                                            Im Surinam 55                                
+                                                            Basel  BS  4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Vidicon LLC                                  
+C23000-C23FFF                 (base 16)                     Vidicon LLC                                  
+                                                            300 Harvestore Drive                         
+                                                            DeKalb  IL  60115                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Specialist Electronics Services Ltd          
+C1F000-C1FFFF                 (base 16)                     Specialist Electronics Services Ltd          
+                                                            Craven Court                                 
+                                                            Camberley  Surrey  GU15 3BS                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Powerbase Energy Systems Inc.                
+C1D000-C1DFFF                 (base 16)                     Powerbase Energy Systems Inc.                
+                                                            150 Rosamond Street                          
+                                                            Carleton Place  Ontario  K7C 1V2             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         AILES ELECTRONICS CO., LTD.                  
+BF5000-BF5FFF                 (base 16)                     AILES ELECTRONICS CO., LTD.                  
+                                                            840 ASSO                                     
+                                                            KAINAN CITY  WAKAYAMA  642-0015              
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Amatic Industries GmbH                       
+BF1000-BF1FFF                 (base 16)                     Amatic Industries GmbH                       
+                                                            Traunsteinstrasse 12                         
+                                                            Rutzenmoos  Upper Austria  4845              
+                                                            AT                                           
+
+00-50-C2                      (hex)                         ZUCCHETTI SPA                                
+BE9000-BE9FFF                 (base 16)                     ZUCCHETTI SPA                                
+                                                            Via Adriatica, 282                           
+                                                            Campoformido  UDINE  33030                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Doppler Systems LLC                          
+C05000-C05FFF                 (base 16)                     Doppler Systems LLC                          
+                                                            37202 N Bloody Basin Road                    
+                                                            Carefree  Arizona  853877                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+C00000-C00FFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Altronix Corporation                         
+BFC000-BFCFFF                 (base 16)                     Altronix Corporation                         
+                                                            140 58th street                              
+                                                            Brooklyn  NY  11220                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ECS Srl                                      
+BFB000-BFBFFF                 (base 16)                     ECS Srl                                      
+                                                            Via del Candel 55/d                          
+                                                            Belluno    32100                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Percello Ltd.                                
+BD2000-BD2FFF                 (base 16)                     Percello Ltd.                                
+                                                            14 Hatidhar St.                              
+                                                            Raanana    43650                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         b.a.b-technologie gmbh                       
+BD8000-BD8FFF                 (base 16)                     b.a.b-technologie gmbh                       
+                                                            Rosemeyerstraße 14                           
+                                                            Dortmund  NRW  44139                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RF-Embedded GmbH                             
+BD5000-BD5FFF                 (base 16)                     RF-Embedded GmbH                             
+                                                            Salzburger Straße 60                         
+                                                            Stephanskirchen  Bayern  83071               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Highlight Parking Systems Ltd                
+BCD000-BCDFFF                 (base 16)                     Highlight Parking Systems Ltd                
+                                                            14 Ullathorne Road                           
+                                                            London    SW16 1SN                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         VVDN TECHNOLOGIES PVT. LTD.                  
+BCC000-BCCFFF                 (base 16)                     VVDN TECHNOLOGIES PVT. LTD.                  
+                                                            1241/36,ATUL KATARIA CHOWK                   
+                                                            GURGAON  HARYANA  122001                     
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Systemteq Limited                            
+BBA000-BBAFFF                 (base 16)                     Systemteq Limited                            
+                                                            Unit B, Lynwood House                        
+                                                            Watford  Hertfordshire  WD24 7UF             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         MangoDSP                                     
+BAF000-BAFFFF                 (base 16)                     MangoDSP                                     
+                                                            Hartom 8                                     
+                                                            Jerusalem    45116                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         VITECO VNPT JSC                              
+BAC000-BACFFF                 (base 16)                     VITECO VNPT JSC                              
+                                                            No35, Lane 61, lac Trung Streets             
+                                                            Ha Noi    10000                              
+                                                            VN                                           
+
+00-50-C2                      (hex)                         MireroTack                                   
+BC6000-BC6FFF                 (base 16)                     MireroTack                                   
+                                                            dodang-dong,wonmi-gu, bucheon-si, gyeonggi-do
+                                                            dodang-dong,wonmi-gu  bucheon-si/gyeonggi-do  420-806
+                                                            KP                                           
+
+00-50-C2                      (hex)                         Aitecsystem Co.,Ltd.                         
+BCA000-BCAFFF                 (base 16)                     Aitecsystem Co.,Ltd.                         
+                                                            1532,Shinohara-Cho,                          
+                                                            Yokohama  Kanagawa  222-0026                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+BA8000-BA8FFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Jomitek                                      
+BA6000-BA6FFF                 (base 16)                     Jomitek                                      
+                                                            Skovlytoften 22                              
+                                                            Holte    DK-2840                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         ikerlan                                      
+B97000-B97FFF                 (base 16)                     ikerlan                                      
+                                                            jm arizmendiarrieta, 2                       
+                                                            mondragon  guipuzcoa  20500                  
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Onix Electronic Systems Inc                  
+B96000-B96FFF                 (base 16)                     Onix Electronic Systems Inc                  
+                                                            205 Travelers Rest Blvd                      
+                                                            Summerville  SC  29485                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Talo, NV Inc                                 
+B9A000-B9AFFF                 (base 16)                     Talo, NV Inc                                 
+                                                            1930 Village Center Cir #3 - 454             
+                                                            Las Vegas  Nevada  89134                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         KRISTECH                                     
+B77000-B77FFF                 (base 16)                     KRISTECH                                     
+                                                            Porzeczkowa 12                               
+                                                            Ustron  Slaskie  43-450                      
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+B6B000-B6BFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Bettini srl                                  
+B7C000-B7CFFF                 (base 16)                     Bettini srl                                  
+                                                            Via Cesare Battisti 22                       
+                                                            Cesano Maderno  Milano  I - 20031            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         QUARTECH CORPORATION                         
+B7B000-B7BFFF                 (base 16)                     QUARTECH CORPORATION                         
+                                                            15923 ANGELO DRIVE                           
+                                                            MACOMB TWP.  MI  48042-4050                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         OOO NPF ATIS                                 
+B60000-B60FFF                 (base 16)                     OOO NPF ATIS                                 
+                                                            ul. Rangeva, 11-24                           
+                                                            Kovrov  Vladimir region  601916              
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Nayos LTD                                    
+B61000-B61FFF                 (base 16)                     Nayos LTD                                    
+                                                            7 Golda Meir                                 
+                                                            Nes Ziona    74036                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Real D                                       
+B58000-B58FFF                 (base 16)                     Real D                                       
+                                                            5335 Sterling Drive                          
+                                                            Boulder  CO  80301                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SINOVIA SA                                   
+B56000-B56FFF                 (base 16)                     SINOVIA SA                                   
+                                                            3 RUE DE CHEVILLY                            
+                                                            FRESNES  VAL DE MARNE  94260                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Timberline Mfg Company                       
+B5B000-B5BFFF                 (base 16)                     Timberline Mfg Company                       
+                                                            1050 Lyons Lane                              
+                                                            Marion   IA  52302                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Trench Austria GmbH                          
+B2A000-B2AFFF                 (base 16)                     Trench Austria GmbH                          
+                                                            Paschinger Straße 49                         
+                                                            Leonding  Austria  4060                      
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Shop Safe AG                                 
+B31000-B31FFF                 (base 16)                     Shop Safe AG                                 
+                                                            Businesspark Giessenmatt 2                   
+                                                            Sins  AG  CH-5643                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ACT                                          
+B2E000-B2EFFF                 (base 16)                     ACT                                          
+                                                            Unit C1, South City Business Center          
+                                                            Dublin                                       
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+B4A000-B4AFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         NARA Controls Inc.                           
+B0F000-B0FFFF                 (base 16)                     NARA Controls Inc.                           
+                                                            Nara Bldg. 71-22 Chungdamdong Kangnamku      
+                                                            Seoul    135-100                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         PhotoTelesis LP                              
+B15000-B15FFF                 (base 16)                     PhotoTelesis LP                              
+                                                            4801 NW Loop 410                             
+                                                            San Antonio  Texas  78229                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         FIVE9 NETWORK SYSTEMS LLC                    
+B20000-B20FFF                 (base 16)                     FIVE9 NETWORK SYSTEMS LLC                    
+                                                            3600 W. Bayshore Road                        
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         FARECO                                       
+B07000-B07FFF                 (base 16)                     FARECO                                       
+                                                            8 EUROPARC de la Sainte Victoire             
+                                                            MEYREUIL    13590                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         3Roam                                        
+AED000-AEDFFF                 (base 16)                     3Roam                                        
+                                                            Parc Haute Technologie, Bat 6                
+                                                            Mougins    06250                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         POLA s.r.l.                                  
+B05000-B05FFF                 (base 16)                     POLA s.r.l.                                  
+                                                            via Del Perolo 13                            
+                                                            Soncino  CR  26029                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Dixell S.p.A.                                
+AF4000-AF4FFF                 (base 16)                     Dixell S.p.A.                                
+                                                            Via dell'Industria, 27                       
+                                                            Pieve d'Alpago  Belluno  32010               
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ChronoLogic Pty. Ltd.                        
+ACE000-ACEFFF                 (base 16)                     ChronoLogic Pty. Ltd.                        
+                                                            227 Gouger Street                            
+                                                            Adelaide  South Australia  5000              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         ClearCorp Enterprises, Inc                   
+AE9000-AE9FFF                 (base 16)                     ClearCorp Enterprises, Inc                   
+                                                            7485 Park Lane Rd                            
+                                                            Longmont  CO  80503                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Diversified Control, Inc.                    
+AC3000-AC3FFF                 (base 16)                     Diversified Control, Inc.                    
+                                                            3333 California Rd.                          
+                                                            Orchard Park  New York  14127                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Orion Technologies,LLC                       
+AC4000-AC4FFF                 (base 16)                     Orion Technologies,LLC                       
+                                                            12605 Challenger Parkway Suite 130           
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         MeshWorks Wireless Oy                        
+ACD000-ACDFFF                 (base 16)                     MeshWorks Wireless Oy                        
+                                                            Hermiankatu 6-8 H                            
+                                                            Tampere  Suomi  33720                        
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Neoptix Inc.                                 
+ADE000-ADEFFF                 (base 16)                     Neoptix Inc.                                 
+                                                            1415 Frank-Carrel                            
+                                                            Quebec    G1N4N7                             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Tampere University of Technology             
+AA5000-AA5FFF                 (base 16)                     Tampere University of Technology             
+                                                            Korkeakoulunkatu 10                          
+                                                            Tampere  Pirkanmaa  33720                    
+                                                            FI                                           
+
+00-50-C2                      (hex)                         DS PRO Audio Ltda                            
+AC0000-AC0FFF                 (base 16)                     DS PRO Audio Ltda                            
+                                                            Rua Washington Luiz 675 sala 1116            
+                                                            Porto Alegre  RS  90.010-460                 
+                                                            BR                                           
+
+00-50-C2                      (hex)                         AP Labs                                      
+ABE000-ABEFFF                 (base 16)                     AP Labs                                      
+                                                            10864 THORNMINT ROAD                         
+                                                            SAN DIEGO  CALIFORNIA  92127                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         YellowSoft Co., Ltd.                         
+A9F000-A9FFFF                 (base 16)                     YellowSoft Co., Ltd.                         
+                                                            624-7 Takahagi                               
+                                                            Hidaka  Saitama  350-1213                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         VisiCon GmbH                                 
+AAC000-AACFFF                 (base 16)                     VisiCon GmbH                                 
+                                                            Gottf.-Aug.-Buerger-Str. 30                  
+                                                            Gleichen  Lower Saxony  D-37130              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+A82000-A82FFF                 (base 16)                     CT Company                                   
+                                                            Godovikova 9, Moscow                         
+                                                            Moscow  RUSSIA  129085                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         INNOVACIONES Microelectrónicas SL (AnaFocus) 
+A95000-A95FFF                 (base 16)                     INNOVACIONES Microelectrónicas SL (AnaFocus) 
+                                                            C/Isaac Newton, nº 4-Pabellón de Italia-7ªPlanta çtico
+                                                            Sevilla    41092                             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Vitel Net                                    
+A7D000-A7DFFF                 (base 16)                     Vitel Net                                    
+                                                            8201 Greensboro Dr.                          
+                                                            McLean  VA  22102                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saintronic                                   
+A79000-A79FFF                 (base 16)                     Saintronic                                   
+                                                            Parc Atlantique                              
+                                                            Saintes  France  17100                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Frontier Electronic Systems Corp.            
+A8D000-A8DFFF                 (base 16)                     Frontier Electronic Systems Corp.            
+                                                            4500 W 6th Ave                               
+                                                            Stillwater  OK  74074                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Quantum3D, Inc.                              
+A8F000-A8FFFF                 (base 16)                     Quantum3D, Inc.                              
+                                                            6330 San Ignacio Avenue                      
+                                                            San Jose  CA  95051                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Audio Engineering Ltd.                       
+A8A000-A8AFFF                 (base 16)                     Audio Engineering Ltd.                       
+                                                            75 Parnell Rise                              
+                                                            Auckland    1052                             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Ansen Investment Holdings Ltd.               
+A5E000-A5EFFF                 (base 16)                     Ansen Investment Holdings Ltd.               
+                                                            Room 78, 2/F, Sino Industrial Plaza,         
+                                                              Kowloon Bay                                
+                                                            HK                                           
+
+00-50-C2                      (hex)                         ITAS A/S                                     
+A5A000-A5AFFF                 (base 16)                     ITAS A/S                                     
+                                                            Klosterport 4A                               
+                                                            Århus C    DK-8000                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+A5B000-A5BFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Reliable System Services Corp                
+A70000-A70FFF                 (base 16)                     Reliable System Services Corp                
+                                                            746 North Drive                              
+                                                            Melbourne  Florida  32934                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Screen Technics Pty Limited                  
+A6E000-A6EFFF                 (base 16)                     Screen Technics Pty Limited                  
+                                                            Corner Vale & Suttor Roads                   
+                                                            Moss Vale  NSW  2577                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+A6F000-A6FFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DTV Innovations                              
+A6D000-A6DFFF                 (base 16)                     DTV Innovations                              
+                                                            1252 W. Northwest Highway                    
+                                                            Palatine  IL  60067                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         RealVision Inc.                              
+A42000-A42FFF                 (base 16)                     RealVision Inc.                              
+                                                            3-1-4 Shin-Yokohama, Kouhoku-Ku              
+                                                            Yokohama  Kanagawa  222-0033                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Gamber-Johnson LLC.                          
+A72000-A72FFF                 (base 16)                     Gamber-Johnson LLC.                          
+                                                            3001 Borham Avenue                           
+                                                            Stevens Point  WI  54481                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         L-3 Communications Mobile-Vision, Inc.       
+A4B000-A4BFFF                 (base 16)                     L-3 Communications Mobile-Vision, Inc.       
+                                                            90 Fanny Rd.                                 
+                                                            Boonton  NJ  07005                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wayne Dalton Corp.                           
+A49000-A49FFF                 (base 16)                     Wayne Dalton Corp.                           
+                                                            3395 addison Dr.                             
+                                                            Pensacola  FL  32514                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Y-products co.ltd.                           
+A51000-A51FFF                 (base 16)                     Y-products co.ltd.                           
+                                                            Yamato-higashi1-11-24                        
+                                                            Yamato-city  Kanagawa-pref  242-0017         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         GSS Avionics Limited                         
+A67000-A67FFF                 (base 16)                     GSS Avionics Limited                         
+                                                            Thorne House                                 
+                                                            Yeovil  Somerset  BA214JD                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         tetronik GmbH AEN                            
+A64000-A64FFF                 (base 16)                     tetronik GmbH AEN                            
+                                                            Silberbachstr.10                             
+                                                            Taunusstein  Hessen  65232                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Telecor Inc.                                 
+A3A000-A3AFFF                 (base 16)                     Telecor Inc.                                 
+                                                            6205 Kestrel Road                            
+                                                            Mississauga  Ontario  L5T 2A1                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Brähler ICS Konferenztechnik AG              
+A3C000-A3CFFF                 (base 16)                     Brähler ICS Konferenztechnik AG              
+                                                            Auf der Alten Burg 6                         
+                                                            Koenigswinter  NRW  53639                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Dynon Instruments                            
+A07000-A07FFF                 (base 16)                     Dynon Instruments                            
+                                                            19825 141st PL NE                            
+                                                            Woodinville  WA  98072                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Reference, LLC.                              
+A02000-A02FFF                 (base 16)                     Reference, LLC.                              
+                                                            690 E Bridge St.                             
+                                                            Elkader  IA  52043-0158                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         HCE Engineering S.r.l.                       
+A12000-A12FFF                 (base 16)                     HCE Engineering S.r.l.                       
+                                                            Via Lamarmora 2L                             
+                                                            Livorno  LI  57122                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Essential Design & Integration P/L           
+A10000-A10FFF                 (base 16)                     Essential Design & Integration P/L           
+                                                            PO Box 3110                                  
+                                                            Narellan DC  NSW  2567                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         D-TA Systems                                 
+A30000-A30FFF                 (base 16)                     D-TA Systems                                 
+                                                            2500 Lancaster Road                          
+                                                            Ottawa  ON  K1B 4S5                          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Inventure Inc.                               
+A2D000-A2DFFF                 (base 16)                     Inventure Inc.                               
+                                                            3-1-1, Shin-yokohama, Kouhoku-ku             
+                                                            Yokohama  Kanagawa-ken  222-8505             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         meconet e. K.                                
+A27000-A27FFF                 (base 16)                     meconet e. K.                                
+                                                            Bottenbacher Str. 78                         
+                                                            Kreuztal  NRW  57223                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ISAC SRL                                     
+A21000-A21FFF                 (base 16)                     ISAC SRL                                     
+                                                            via Maestri del Lavoro 30                    
+                                                            CASCINA  PISA  56021                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Microtechnica                                
+A1C000-A1CFFF                 (base 16)                     Microtechnica                                
+                                                            1-3-10-501 Tamagawa                          
+                                                            Setagayaku  Tokyo  1580094                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         APRILIA RACING S.R.L.                        
+A2B000-A2BFFF                 (base 16)                     APRILIA RACING S.R.L.                        
+                                                            VIA MARCONI, 9                               
+                                                            NOALE  VENEZIA  30033                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Harris Designs of NRV, Inc.                  
+A32000-A32FFF                 (base 16)                     Harris Designs of NRV, Inc.                  
+                                                            1902 Lacy Lane                               
+                                                            Blacksburg  VA  24060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Realtime Systems Ltd.                        
+A1B000-A1BFFF                 (base 16)                     Realtime Systems Ltd.                        
+                                                            A-49, Okhla Industrial Area                  
+                                                            New Delhi    110020                          
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Eoslink                                      
+A18000-A18FFF                 (base 16)                     Eoslink                                      
+                                                            #602, 900-1                                  
+                                                            Anyang-City  Kyonggi-Do  431-060             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Bitt technology-A Ltd.                       
+9FD000-9FDFFF                 (base 16)                     Bitt technology-A Ltd.                       
+                                                            Wiener Strasse 70                            
+                                                            Spillern  Lower Austria  2104                
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Uwe Schneider GmbH                           
+9CD000-9CDFFF                 (base 16)                     Uwe Schneider GmbH                           
+                                                            Heegwaldring 12                              
+                                                            Limeshain    63694                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Netpower Labs AB                             
+9D5000-9D5FFF                 (base 16)                     Netpower Labs AB                             
+                                                            Stubbsundsv 17                               
+                                                            Stockholm    13141                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         CNS Systems, Inc.                            
+9D9000-9D9FFF                 (base 16)                     CNS Systems, Inc.                            
+                                                            363 Hawick Court                             
+                                                            Severna Park  Maryland  21146                
+                                                            US                                           
+
+00-50-C2                      (hex)                         SISMODULAR - Engenharia, Lda                 
+9EA000-9EAFFF                 (base 16)                     SISMODULAR - Engenharia, Lda                 
+                                                            Lrg. S. Paulo Nº13, 1º - E2                  
+                                                            Braga    4700-042                            
+                                                            PT                                           
+
+00-50-C2                      (hex)                         Walter Grotkasten                            
+9DB000-9DBFFF                 (base 16)                     Walter Grotkasten                            
+                                                            Grabäckerstraße 14                           
+                                                            Schorndorf  BW  73614                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         E-ViEWS SAFETY SYSTEMS, INC                  
+9E2000-9E2FFF                 (base 16)                     E-ViEWS SAFETY SYSTEMS, INC                  
+                                                            5331 DERRY AVE                               
+                                                            AGOURA HILLS  CA  91301                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         CHAUVIN ARNOUX                               
+9DE000-9DEFFF                 (base 16)                     CHAUVIN ARNOUX                               
+                                                            la queue Devée                               
+                                                            REUX  PONT L'EVEQUE  14130                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Michael Stevens & Partners Ltd               
+9EE000-9EEFFF                 (base 16)                     Michael Stevens & Partners Ltd               
+                                                            Invicta Works                                
+                                                            Bromley  Kent  BR2 9NT                       
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ComAp s.r.o                                  
+9A1000-9A1FFF                 (base 16)                     ComAp s.r.o                                  
+                                                            Kundratka 17                                 
+                                                            Prague    18000                              
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Vester Elektronik GmbH                       
+9BC000-9BCFFF                 (base 16)                     Vester Elektronik GmbH                       
+                                                            Otto-Hahn-Straße 14                          
+                                                            Straubenhardt  Baden-Württemberg  75334      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         OMICRON electronics GmbH                     
+9BB000-9BBFFF                 (base 16)                     OMICRON electronics GmbH                     
+                                                            Oberes Ried 1                                
+                                                            Klaus    A-6833                              
+                                                            AT                                           
+
+00-50-C2                      (hex)                         LUMINEX Lighting Control Equipment           
+9C9000-9C9FFF                 (base 16)                     LUMINEX Lighting Control Equipment           
+                                                            Berkenlaan 8 A                               
+                                                            Hechtel - Eksel  Limburg  3940               
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Scansonic MI GmbH                            
+9C5000-9C5FFF                 (base 16)                     Scansonic MI GmbH                            
+                                                            Rudolf-Baschant-Straße 2                     
+                                                            Berlin    13086                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Team Enginers                                
+9C2000-9C2FFF                 (base 16)                     Team Enginers                                
+                                                            3-18-3, First floor Pragati Nagar            
+                                                            Hyderabad  Andrapradesh  500013              
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+9C1000-9C1FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sensitron Semiconductor                      
+9BD000-9BDFFF                 (base 16)                     Sensitron Semiconductor                      
+                                                            221 West Industry Court                      
+                                                            Deer Park  New York  11729                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACTECH                                       
+9B6000-9B6FFF                 (base 16)                     ACTECH                                       
+                                                            Parc d'activités Angers-Beaucouzé            
+                                                            Beaucouzé    49070                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         UNETCONVERGENCE CO., LTD                     
+993000-993FFF                 (base 16)                     UNETCONVERGENCE CO., LTD                     
+                                                            101-511 DIGITAL EMPIRE 2                     
+                                                            SUWON-SI  KYUNGGI-DO,  443-390               
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Procon Electronics                           
+560000-560FFF                 (base 16)                     Procon Electronics                           
+                                                            PO Box 164                                   
+                                                            Sydney  NSW  1730                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Psigenics Corporation                        
+989000-989FFF                 (base 16)                     Psigenics Corporation                        
+                                                            PO Box 2160                                  
+                                                            Gainesville  FL  32602                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSCI                                         
+986000-986FFF                 (base 16)                     DSCI                                         
+                                                            12249 Science Drive                          
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         KPE spol. s r.o.                             
+83E000-83EFFF                 (base 16)                     KPE spol. s r.o.                             
+                                                            Blattného 2313                               
+                                                            Praha  CZ  15800                             
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         LOGITAL DIGITAL MEDIA srl                    
+978000-978FFF                 (base 16)                     LOGITAL DIGITAL MEDIA srl                    
+                                                            via Palazzetti, 5/f                          
+                                                            San Lazzaro di Savena  Bologna  40068        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Engage Technologies                          
+99E000-99EFFF                 (base 16)                     Engage Technologies                          
+                                                            7041 Boone Avenue North                      
+                                                            Brooklyn Park  MN  55428                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Trs Systems, Inc.                            
+9A0000-9A0FFF                 (base 16)                     Trs Systems, Inc.                            
+                                                            601 Carlson Parkway, #1050                   
+                                                            Minnetonka  MN  55305                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         C&I  Co.Ltd                                  
+97F000-97FFFF                 (base 16)                     C&I  Co.Ltd                                  
+                                                            Shinkawa 2-24-4                              
+                                                            ChyuouKu  Tokyo  104-0033                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Joinsoon Electronics MFG. Co., Ltd           
+987000-987FFF                 (base 16)                     Joinsoon Electronics MFG. Co., Ltd           
+                                                            19F., No. 79, Sec. 1, Sintai 5th Rd., Sijhih City
+                                                            Taipei County  Taiwan  221                   
+                                                            TW                                           
+
+00-50-C2                      (hex)                         BELIK S.P.R.L.                               
+98F000-98FFFF                 (base 16)                     BELIK S.P.R.L.                               
+                                                            Rue du Roussart 147                          
+                                                            Waterloo  Brabant  1410                      
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Link Technologies, Inc                       
+98E000-98EFFF                 (base 16)                     Link Technologies, Inc                       
+                                                            6560 Satke Drive                             
+                                                            House Springs  MO  63051                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+954000-954FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Electronic Media Services Ltd                
+96B000-96BFFF                 (base 16)                     Electronic Media Services Ltd                
+                                                            Passfield Business Centre                    
+                                                            Liphook  Hampshire  GU30 7SB                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Bittium Wireless Ltd                         
+96A000-96AFFF                 (base 16)                     Bittium Wireless Ltd                         
+                                                            Tutkijantie 8                                
+                                                            Oulu    50590                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Shockfish SA                                 
+962000-962FFF                 (base 16)                     Shockfish SA                                 
+                                                            Parc Scientifique                            
+                                                            Lausanne  VD  1015                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Lécureux SA                                  
+963000-963FFF                 (base 16)                     Lécureux SA                                  
+                                                            Rue des Pres 137                             
+                                                            Biel/Bienne  BE  2503                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         BEEcube Inc.                                 
+95E000-95EFFF                 (base 16)                     BEEcube Inc.                                 
+                                                            39465 Paseo Padre Pkwy                       
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Switch Science (Panini Keikaku)              
+972000-972FFF                 (base 16)                     Switch Science (Panini Keikaku)              
+                                                            2-12-1 Kohjimachi, #805                      
+                                                            Chiyoda-ku  Tokyo  1020083                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         DECTRIS Ltd.                                 
+959000-959FFF                 (base 16)                     DECTRIS Ltd.                                 
+                                                            Neuenhoferstrasse 107                        
+                                                            Baden    5400                                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         taskit GmbH                                  
+949000-949FFF                 (base 16)                     taskit GmbH                                  
+                                                            Seelenbinder Strasse 33                      
+                                                            Berlin    12555                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ELECTRONIA                                   
+948000-948FFF                 (base 16)                     ELECTRONIA                                   
+                                                            P.O. 180                                     
+                                                            Alkhobar  Eastern Province  31952            
+                                                            SA                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+942000-942FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FractureCode Corporation                     
+93C000-93CFFF                 (base 16)                     FractureCode Corporation                     
+                                                            Amager Strandvej 390, 2. etage               
+                                                            Kastrup    2770                              
+                                                            DK                                           
+
+00-50-C2                      (hex)                         ALPHATRONICS nv                              
+93A000-93AFFF                 (base 16)                     ALPHATRONICS nv                              
+                                                            Brandstraat 8a                               
+                                                            Lokeren  Oost Vlaanderen  B-9160             
+                                                            BE                                           
+
+00-50-C2                      (hex)                         EL.C.A. soc. coop.                           
+951000-951FFF                 (base 16)                     EL.C.A. soc. coop.                           
+                                                            61, Via delle Industrie                      
+                                                            Fonte  TV  31010                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Tele and Radio Research Institute            
+950000-950FFF                 (base 16)                     Tele and Radio Research Institute            
+                                                            Ratuszowa 11                                 
+                                                            Warsaw    03-450                             
+                                                            PL                                           
+
+00-50-C2                      (hex)                         TEMIX                                        
+94C000-94CFFF                 (base 16)                     TEMIX                                        
+                                                            Corso Michelangelo Buonarroti, 61B           
+                                                            Trecastagni  Catania  95039                  
+                                                            IT                                           
+
+00-50-C2                      (hex)                         2NCOMM DESIGN SRL                            
+91F000-91FFFF                 (base 16)                     2NCOMM DESIGN SRL                            
+                                                            Str. Amiral I. Murgescu, Nr. 1               
+                                                            Bucuresti  sector 2  021753                  
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Autotank AB                                  
+910000-910FFF                 (base 16)                     Autotank AB                                  
+                                                            P.O. Box 11059                               
+                                                            BROMMA  STOCKHOLM  SE-16111                  
+                                                            SE                                           
+
+00-50-C2                      (hex)                         ASSET InterTech, Inc.                        
+912000-912FFF                 (base 16)                     ASSET InterTech, Inc.                        
+                                                            2201 N. Central Expressway                   
+                                                            Richardson  TX  75080                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Design Lightning Corp                        
+918000-918FFF                 (base 16)                     Design Lightning Corp                        
+                                                            1006 W. College Ave  Suite 204               
+                                                            State College  PA  16801                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Link Electric & Safety Control Co.           
+924000-924FFF                 (base 16)                     Link Electric & Safety Control Co.           
+                                                            444 McNally Drive                            
+                                                            Nashville  TN  37211                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         TELIUM s.c.                                  
+8FA000-8FAFFF                 (base 16)                     TELIUM s.c.                                  
+                                                            ul. Plochocinska 19                          
+                                                            Warszawa  Mazowieckie  03-191                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         K-MAC Corp.                                  
+8F6000-8F6FFF                 (base 16)                     K-MAC Corp.                                  
+                                                            104-11, Munji-Dong                           
+                                                            Daejeon    305-380                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Research Applications Incorp                 
+901000-901FFF                 (base 16)                     Research Applications Incorp                 
+                                                            650 South 79th Street                        
+                                                            Chandler  Arizona  85226                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         tec5 AG                                      
+8F5000-8F5FFF                 (base 16)                     tec5 AG                                      
+                                                            In der Au 27                                 
+                                                            Oberursel    61440                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Codex Digital Ltd                            
+908000-908FFF                 (base 16)                     Codex Digital Ltd                            
+                                                            60 Poland Street                             
+                                                            London    W1F 7NT                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Schneider Electric GmbH                      
+8F2000-8F2FFF                 (base 16)                     Schneider Electric GmbH                      
+                                                            Gothaer Str. 29                              
+                                                            Ratingen    40880                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MaCaPS International Limited                 
+8E4000-8E4FFF                 (base 16)                     MaCaPS International Limited                 
+                                                            Rm. 1408, Block B, Hoi Luen Industrial Centre
+                                                                                                         
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Deutscher Weterdienst                        
+8E1000-8E1FFF                 (base 16)                     Deutscher Weterdienst                        
+                                                            Kaiserleistrasse 44                          
+                                                            Offenbach    63067                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+8CE000-8CEFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Cambridge Sound Management, LLC              
+8CD000-8CDFFF                 (base 16)                     Cambridge Sound Management, LLC              
+                                                            27 Moulton Street                            
+                                                            Cambridge  MA  02138                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Shenzhen Pennda Technologies Co., Ltd.       
+8E0000-8E0FFF                 (base 16)                     Shenzhen Pennda Technologies Co., Ltd.       
+                                                            Room 1801, Overseas Chinese Scholar Venture Building
+                                                            Shenzhen  Guangdong  518057                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Berthel GmbH                                 
+8E5000-8E5FFF                 (base 16)                     Berthel GmbH                                 
+                                                            Karl-Zucker-Str. 12                          
+                                                            Erlangen  GERMANY  D-91052                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Vortex Engineering pvt ltd                   
+8C5000-8C5FFF                 (base 16)                     Vortex Engineering pvt ltd                   
+                                                            no 14, Palayakaran street,Ekkaduthangal      
+                                                            Chennai  Tamilnadu  600097                   
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Specialized Communications Corp.             
+8A0000-8A0FFF                 (base 16)                     Specialized Communications Corp.             
+                                                            20940 Twin Springs Drive                     
+                                                            Smithsburg  Maryland  21783                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mediana                                      
+89C000-89CFFF                 (base 16)                     Mediana                                      
+                                                            Wonju Medical Industry Park, 1650-1 Donghwa-Ri,
+                                                            Wonju-Si  Gangwon-Do  220-801                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Veeco Process Equipment, Inc.                
+898000-898FFF                 (base 16)                     Veeco Process Equipment, Inc.                
+                                                            2330 E. Prospect Rd.                         
+                                                            Fort Collins  Colorado  80526                
+                                                            US                                           
+
+00-50-C2                      (hex)                         SERVAIND SA.                                 
+8B2000-8B2FFF                 (base 16)                     SERVAIND SA.                                 
+                                                            Colombres 873                                
+                                                            Capital Federal  Buenos Aires  C1218ABI      
+                                                            AR                                           
+
+00-50-C2                      (hex)                         Shadrinskiy Telefonny Zavod                  
+8B6000-8B6FFF                 (base 16)                     Shadrinskiy Telefonny Zavod                  
+                                                            16, Komsomolskaya str.                       
+                                                            Shadrinsk  Kurganskaya obl.  641870          
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Inventis Technology Pty Limited              
+887000-887FFF                 (base 16)                     Inventis Technology Pty Limited              
+                                                            Block A, Unit 40                             
+                                                            Caringbah  NSW  2229                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         ACS Motion Control Ltd.                      
+889000-889FFF                 (base 16)                     ACS Motion Control Ltd.                      
+                                                            SHAUL AMOR BLV RAMAT GABRIEL                 
+                                                            MIGDAL HA'EMEQ  ISRAEL  10500                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         OOO NTK IMOS                                 
+885000-885FFF                 (base 16)                     OOO NTK IMOS                                 
+                                                            Politekhnicheskaia str. 22                   
+                                                            Saint-Petersburg  Nord-West  194021          
+                                                            RU                                           
+
+00-50-C2                      (hex)                         IP Thinking A/S                              
+884000-884FFF                 (base 16)                     IP Thinking A/S                              
+                                                            Karl Bjarnhofsvej 13                         
+                                                            Vejle  Jylland  7120                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Privatquelle Gruber GmbH & CO KG             
+876000-876FFF                 (base 16)                     Privatquelle Gruber GmbH & CO KG             
+                                                            Innsbrucker Strasse 38                       
+                                                            Brixlegg  Austria/Tirol  6230                
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Arcos Technologies Ltd.                      
+874000-874FFF                 (base 16)                     Arcos Technologies Ltd.                      
+                                                            26 Hasivim St.                               
+                                                            Petakh-Tikva    49517                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         ODF Optronics, Inc.                          
+897000-897FFF                 (base 16)                     ODF Optronics, Inc.                          
+                                                            6112 Trotter Ridge Road                      
+                                                            Summerfield  NC  27358                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Creation Technologies Chicago                
+880000-880FFF                 (base 16)                     Creation Technologies Chicago                
+                                                            1475 S. Wheeling Rd.                         
+                                                            Wheeling  IL  60090                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SCM PRODUCTS, INC.                           
+87E000-87EFFF                 (base 16)                     SCM PRODUCTS, INC.                           
+                                                            155 RICEFIELD LANE                           
+                                                            HAUPPAUGE  NEW YORK  11788                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Trakce a.s.                                  
+892000-892FFF                 (base 16)                     Trakce a.s.                                  
+                                                            Hlavkova 3                                   
+                                                            Ostrava  Privoz  70200                       
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Elsys AG                                     
+862000-862FFF                 (base 16)                     Elsys AG                                     
+                                                            Mellingerstrasse 12                          
+                                                            Niederrohrdorf  AG  5443                     
+                                                            CH                                           
+
+00-50-C2                      (hex)                         BMTI                                         
+84D000-84DFFF                 (base 16)                     BMTI                                         
+                                                            ZI Camp Laurent                              
+                                                            La Seyne  Var  83500                         
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Radiometer Medical ApS                       
+85E000-85EFFF                 (base 16)                     Radiometer Medical ApS                       
+                                                            Aakandevej 21                                
+                                                            Broenshoej  Copenhagen  2700                 
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Keystone Electronic Solutions                
+84A000-84AFFF                 (base 16)                     Keystone Electronic Solutions                
+                                                            103 Club Avenue                              
+                                                            Pretoria  Gauteng  0181                      
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         SMT d.o.o.                                   
+824000-824FFF                 (base 16)                     SMT d.o.o.                                   
+                                                            Liminjanska 96                               
+                                                            Portoroz  Slovenia  6320                     
+                                                            SI                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+836000-836FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Communications Laboratories Inc              
+835000-835FFF                 (base 16)                     Communications Laboratories Inc              
+                                                            750 North Drive                              
+                                                            Melbourne  Florida  32934-9281               
+                                                            US                                           
+
+00-50-C2                      (hex)                         St Jude Medical, Inc.                        
+831000-831FFF                 (base 16)                     St Jude Medical, Inc.                        
+                                                            One St Jude Medical Dr                       
+                                                            St Paul  MN  55117                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Connection Electronics Ltd.                  
+841000-841FFF                 (base 16)                     Connection Electronics Ltd.                  
+                                                            Unit 6A, 28/F, Cable TV Tower,               
+                                                            Tsuen Wan,  NT                               
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Quantum Controls BV                          
+842000-842FFF                 (base 16)                     Quantum Controls BV                          
+                                                            Industriestraat 5                            
+                                                            Nuth  Limburg  6361 HD                       
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Vitel Net                                    
+82C000-82CFFF                 (base 16)                     Vitel Net                                    
+                                                            8701 Greensboro Dr.                          
+                                                            McLean  VA  22102                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         VDC Display Systems                          
+82A000-82AFFF                 (base 16)                     VDC Display Systems                          
+                                                            7177 N. Atlantic Avenue                      
+                                                            Cape Canaveral  FL  32920                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         IMS Röntgensysteme GmbH                      
+839000-839FFF                 (base 16)                     IMS Röntgensysteme GmbH                      
+                                                            Dieselstraße 52                              
+                                                            Heiligenhaus  Nordrhein-Westfalen  42579     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Open Video, Inc.                             
+80B000-80BFFF                 (base 16)                     Open Video, Inc.                             
+                                                            65 Enterprise                                
+                                                            Aliso Viejo  CA  92656                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         CET                                          
+806000-806FFF                 (base 16)                     CET                                          
+                                                            via Enrico Fermi 1                           
+                                                            Zenson di Piave  Treviso  31050              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Shenzhen MaiWei Cable TV Equipment CO.,LTD.  
+7FF000-7FFFFF                 (base 16)                     Shenzhen MaiWei Cable TV Equipment CO.,LTD.  
+                                                            13/F,Fiyta Hi-tech Building,GaoXinnanyi Avenue,Southern District of Hi-tech Park,Nanshan District,
+                                                            Shenzhen  Guangdong  518057                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Cabinplant A/S                               
+819000-819FFF                 (base 16)                     Cabinplant A/S                               
+                                                            Roesbjergvej 9                               
+                                                            Haarby  Fyn  5683                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         2N TELEKOMUNIKACE a.s.                       
+81F000-81FFFF                 (base 16)                     2N TELEKOMUNIKACE a.s.                       
+                                                            Modranska 621                                
+                                                            Prague    143 01                             
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         MultimediaLED                                
+805000-805FFF                 (base 16)                     MultimediaLED                                
+                                                            11370 Sunrise Park Drive                     
+                                                            Rancho Cordova  California  95742            
+                                                            US                                           
+
+00-50-C2                      (hex)                         JANUS srl                                    
+801000-801FFF                 (base 16)                     JANUS srl                                    
+                                                            Via Palu', 70                                
+                                                            San Vendemiano  TV  31020                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Adeneo                                       
+7FD000-7FDFFF                 (base 16)                     Adeneo                                       
+                                                            2 chemin du ruisseau                         
+                                                            Ecully    69136                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Wireless Cables Inc.                         
+7FE000-7FEFFF                 (base 16)                     Wireless Cables Inc.                         
+                                                            1414 Soquel Ave, Ste 212                     
+                                                            Santa Cruz  CA  95062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACE Carwash Systems                          
+7F5000-7F5FFF                 (base 16)                     ACE Carwash Systems                          
+                                                            Gouwzeestraat 11                             
+                                                            Weesp  NH  1382 KD                           
+                                                            NL                                           
+
+00-50-C2                      (hex)                         GFI Chrono Time                              
+7EF000-7EFFFF                 (base 16)                     GFI Chrono Time                              
+                                                            121 rue des Guillees                         
+                                                            CHAURAY    79180                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Network Harbor, Inc.                         
+7F0000-7F0FFF                 (base 16)                     Network Harbor, Inc.                         
+                                                            4006 N. Becker Drive                         
+                                                            Bartonville  IL  61607                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         STUHL Regelsysteme GmbH                      
+7F1000-7F1FFF                 (base 16)                     STUHL Regelsysteme GmbH                      
+                                                            Am Wasserturm 1                              
+                                                            Spalt  BY  91174                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+7F6000-7F6FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Sesol Industrial Computer                    
+7EB000-7EBFFF                 (base 16)                     Sesol Industrial Computer                    
+                                                            #509 High-End Tower, Seoul Digital           
+                                                            Guro-Gu  Seoul  152-848                      
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Genesis Automation Inc.                      
+7ED000-7EDFFF                 (base 16)                     Genesis Automation Inc.                      
+                                                            3480 Swenson Ave.                            
+                                                            Saint Charles  IL  60174                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         aiXtrusion GmbH                              
+7DC000-7DCFFF                 (base 16)                     aiXtrusion GmbH                              
+                                                            Pirolweg 21                                  
+                                                            Aachen  NRW  52076                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         InnoScan K/S                                 
+7D8000-7D8FFF                 (base 16)                     InnoScan K/S                                 
+                                                            Sødalsparken 11                              
+                                                            Brabrand    8220                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+7D1000-7D1FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Bittitalo Oy                                 
+7D2000-7D2FFF                 (base 16)                     Bittitalo Oy                                 
+                                                            Lausmaentie 14                               
+                                                            RAISIO  Finland  21210                       
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+7B7000-7B7FFF                 (base 16)                     Tattile srl                                  
+                                                            via gaetano donizetti,1/3/5                  
+                                                            capriano del colle  brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         DIT-MCO International                        
+7B5000-7B5FFF                 (base 16)                     DIT-MCO International                        
+                                                            5612 Brighton Terrace                        
+                                                            Kansas City  Missouri  64130                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         C2 Microsystems                              
+7AF000-7AFFFF                 (base 16)                     C2 Microsystems                              
+                                                            2833 Junction Ave                            
+                                                            San Jose  CA  95134-1224                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         ViewPlus Technologies, Inc.                  
+7CB000-7CBFFF                 (base 16)                     ViewPlus Technologies, Inc.                  
+                                                            1853 SW Airport Ave.                         
+                                                            Corvallis  OR  97333                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lyngdorf Audio Aps                           
+7C6000-7C6FFF                 (base 16)                     Lyngdorf Audio Aps                           
+                                                            Ulvevej 28                                   
+                                                            Skive  Jylland  DK-7800                      
+                                                            DK                                           
+
+00-50-C2                      (hex)                         HOSA TECHNOLOGY, INC.                        
+788000-788FFF                 (base 16)                     HOSA TECHNOLOGY, INC.                        
+                                                            6650 CABALLERO BLVD.                         
+                                                            BUENA PARK  CA  90620                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         M Squared Lasers Limited                     
+791000-791FFF                 (base 16)                     M Squared Lasers Limited                     
+                                                            1 Technology Terrace                         
+                                                            Glasgow  Scotland  G20 0XA                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Integrated Security Corporation              
+776000-776FFF                 (base 16)                     Integrated Security Corporation              
+                                                            46755 Magellan Drive                         
+                                                            Novi  MI  48377                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         IES Elektronikentwicklung                    
+772000-772FFF                 (base 16)                     IES Elektronikentwicklung                    
+                                                            Osterholzweg 26                              
+                                                            Braunschweig  Niedersachsen  38110           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Icon Time Systems                            
+785000-785FFF                 (base 16)                     Icon Time Systems                            
+                                                            15201 NW Greenbrier Pkwy, Suite A1           
+                                                            Beaverton  Oregon  97006                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crinia Corporation                           
+76E000-76EFFF                 (base 16)                     Crinia Corporation                           
+                                                            PO Box 364                                   
+                                                            Cherrybrook  NSW  2126                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Control Service do Brasil Ltda               
+768000-768FFF                 (base 16)                     Control Service do Brasil Ltda               
+                                                            Rua Funchal, 551 cj. 62                      
+                                                            São Paulo    04551060                        
+                                                            BR                                           
+
+00-50-C2                      (hex)                         STÖRK-TRONIC Störk GmbH&Co. KG               
+75C000-75CFFF                 (base 16)                     STÖRK-TRONIC Störk GmbH&Co. KG               
+                                                            Untere Waldplätze 6                          
+                                                            Stuttgart  Baden-Württemberg  D-70569        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         German Technologies                          
+74F000-74FFFF                 (base 16)                     German Technologies                          
+                                                            Chaqiao Industrial District, Shiqi           
+                                                            Zhongshan City  Guangdong Province  528404   
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Gaisler Research AB                          
+75A000-75AFFF                 (base 16)                     Gaisler Research AB                          
+                                                            Forsta Langgatan 19                          
+                                                            Goteborg  VG  41327                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Letechnic Ltd                                
+748000-748FFF                 (base 16)                     Letechnic Ltd                                
+                                                            143 Ladies Mile                              
+                                                            Auckland    1051                             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         MONITOR ELECTRONICS LTD                      
+74A000-74AFFF                 (base 16)                     MONITOR ELECTRONICS LTD                      
+                                                            VOULIAGMENIS AV. 403, ILIOUPOLI              
+                                                            ATHENS  ATTIKI  16346                        
+                                                            GR                                           
+
+00-50-C2                      (hex)                         AixSolve GmbH                                
+758000-758FFF                 (base 16)                     AixSolve GmbH                                
+                                                            Kaiserstrasse 100                            
+                                                            Herzogenrath  NRW  52134                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Simicon                                      
+73C000-73CFFF                 (base 16)                     Simicon                                      
+                                                            Mendeleevskay str. 8                         
+                                                            Saint-Petersburg    194044                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         InterDigital Canada Ltd                      
+728000-728FFF                 (base 16)                     InterDigital Canada Ltd                      
+                                                            1000 Sherbrooke West, 10th floor             
+                                                            Montreal  Quebec  H3A 3G4                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Ant Lamp, Inc                                
+735000-735FFF                 (base 16)                     Ant Lamp, Inc                                
+                                                            16420 SE McGillivray                         
+                                                            Vancouver  WA  98683-3461                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dain                                         
+741000-741FFF                 (base 16)                     Dain                                         
+                                                            Dongmun Vision Building, Sinjeong 6-dong, Yangcheon-gu,
+                                                            Seoul  Yangcheon-gu,  158-740                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Quantec Networks GmbH                        
+73E000-73EFFF                 (base 16)                     Quantec Networks GmbH                        
+                                                            Rieselwiese 1                                
+                                                            Vienenburg  Niedersachsen  38690             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MEDAV GmbH                                   
+73F000-73FFFF                 (base 16)                     MEDAV GmbH                                   
+                                                            Graefenberger Strasse 32 - 34                
+                                                            Uttenreuth  Bayern  91080                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Richard Griessbach Feinmechanik GmbH         
+72C000-72CFFF                 (base 16)                     Richard Griessbach Feinmechanik GmbH         
+                                                            Im Biotechnologiepark                        
+                                                            Luckenwalde  Brandenburg  14943              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Physical Acoustics Corporation               
+72D000-72DFFF                 (base 16)                     Physical Acoustics Corporation               
+                                                            195 Clarksville Road                         
+                                                            Princeton Junction  NJ  08550                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Schlumberger K.K.                            
+732000-732FFF                 (base 16)                     Schlumberger K.K.                            
+                                                            2-2-1 Fuchinobe, Chuo                        
+                                                            Sagamihara  Kanagawa  252-0206               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Spirent Communications                       
+731000-731FFF                 (base 16)                     Spirent Communications                       
+                                                            541 Industrial Way West                      
+                                                            Eatontown  New Jersey  07724                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         haber & koenig electronics gmbh              
+730000-730FFF                 (base 16)                     haber & koenig electronics gmbh              
+                                                            Rechtes Salzachufer 42                       
+                                                            Bergheim  Salzburg  5101                     
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Spectrum Communications FZE                  
+721000-721FFF                 (base 16)                     Spectrum Communications FZE                  
+                                                            A4-42                                        
+                                                            Sharjah                                      
+                                                            AE                                           
+
+00-50-C2                      (hex)                         MG s.r.l.                                    
+71D000-71DFFF                 (base 16)                     MG s.r.l.                                    
+                                                            via Monte Bianco, 1                          
+                                                            Solbiate Olona  VA  21058                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Smartek d.o.o.                               
+708000-708FFF                 (base 16)                     Smartek d.o.o.                               
+                                                            Ziskovec 141                                 
+                                                            Cakovec  Medjimurje  40000                   
+                                                            HR                                           
+
+00-50-C2                      (hex)                         DioDigiWorks. CO., LTD.                      
+706000-706FFF                 (base 16)                     DioDigiWorks. CO., LTD.                      
+                                                            12F, 1208, Byucksan/Kyungin Digital Valley II,
+                                                            SEOUL    153-803                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         LINKIT S.R.L.                                
+711000-711FFF                 (base 16)                     LINKIT S.R.L.                                
+                                                            Via Lavoratori Autobianchi, 1                
+                                                            Desio  MI  20033                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         ela-soft GmbH & Co. KG                       
+70D000-70DFFF                 (base 16)                     ela-soft GmbH & Co. KG                       
+                                                            Breitenbachstraye 10                         
+                                                            Berlin    13509                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Elmec Inc.                                   
+71C000-71CFFF                 (base 16)                     Elmec Inc.                                   
+                                                            229 Billerica Road                           
+                                                            Chelmsford  MA  01824                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         illunis LLC                                  
+718000-718FFF                 (base 16)                     illunis LLC                                  
+                                                            14700 Excelsior Blvd                         
+                                                            Minnetonka  MN  55345                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Blue Origin                                  
+6FE000-6FEFFF                 (base 16)                     Blue Origin                                  
+                                                            21218 76th Ave. S                            
+                                                            Kent  WA  98032                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Revox GmbH                                   
+6F9000-6F9FFF                 (base 16)                     Revox GmbH                                   
+                                                            Am Krebsgraben 15                            
+                                                            VS-Villingen  Baden-Württemberg  78048       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         infoplan Gesellschaftfür  Informationssysteme mbH
+6F7000-6F7FFF                 (base 16)                     infoplan Gesellschaftfür  Informationssysteme mbH
+                                                            Wallbergstraße 1                             
+                                                            Taufkirchen  Bayern  D-82024                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kitron Microelectronics AB                   
+6F5000-6F5FFF                 (base 16)                     Kitron Microelectronics AB                   
+                                                            P.O. Box 1052                                
+                                                            Jönköping    SE-551 10                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         St. Michael Strategies Inc.                  
+6FF000-6FFFFF                 (base 16)                     St. Michael Strategies Inc.                  
+                                                            701 Salaberry                                
+                                                            Chambly  Quebec  J3L 1R2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Laser Electronics Ltd                        
+6F2000-6F2FFF                 (base 16)                     Laser Electronics Ltd                        
+                                                            Gunby Road                                   
+                                                            Skegness  Lincolnshire  PE24 5HT             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Anymax                                       
+6E8000-6E8FFF                 (base 16)                     Anymax                                       
+                                                            9200 Voie des Clouets                        
+                                                            Val de Reuil  Eure  27100                    
+                                                            FR                                           
+
+00-50-C2                      (hex)                         HoseoTelnet Inc...                           
+6C2000-6C2FFF                 (base 16)                     HoseoTelnet Inc...                           
+                                                            Hoseo Plaza B/D 7F, 416                      
+                                                            Gangseo-ro, Gangseo-gu  Seoul   07583        
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Fertron Controle e Automacao Industrial Ltda.
+6BA000-6BAFFF                 (base 16)                     Fertron Controle e Automacao Industrial Ltda.
+                                                            Av. Cesar Mingossi, 108                      
+                                                            Sertaozinho  SP  14177-293                   
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Ele.Mag S.r.l.                               
+6BB000-6BBFFF                 (base 16)                     Ele.Mag S.r.l.                               
+                                                            via Milano14                                 
+                                                            Gorgonzola  Milan  20064                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         unipo GmbH                                   
+6B9000-6B9FFF                 (base 16)                     unipo GmbH                                   
+                                                            Pelarstrasse 21                              
+                                                            Michelstadt  Hessen  64720                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         QuickCircuit Ltd.                            
+6C7000-6C7FFF                 (base 16)                     QuickCircuit Ltd.                            
+                                                            2 Piermark Drive                             
+                                                            Auckland  Auckland  0269                     
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         EDS Systemtechnik                            
+6D0000-6D0FFF                 (base 16)                     EDS Systemtechnik                            
+                                                            Alexianergraben 23                           
+                                                            Aachen  NRW  52064                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TRIUMF                                       
+6B5000-6B5FFF                 (base 16)                     TRIUMF                                       
+                                                            4004 Wesbrook Mall                           
+                                                            Vancouver  BC  V6T 2A3                       
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Oerlikon Contraves AG                        
+6C5000-6C5FFF                 (base 16)                     Oerlikon Contraves AG                        
+                                                            Birchstrasse 155                             
+                                                            Zuerich    CH-8050                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Smart Key International Limited              
+6B0000-6B0FFF                 (base 16)                     Smart Key International Limited              
+                                                            Unit F46, 5/F., Wah Lok Ind Ctr              
+                                                            Shatin  NT  HK                               
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Heim- & Bürokommunikation                    
+6AD000-6ADFFF                 (base 16)                     Heim- & Bürokommunikation                    
+                                                            Markt 6                                      
+                                                            Altdöbern  Brandenburg  03229                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Softwareentwicklung                          
+6AB000-6ABFFF                 (base 16)                     Softwareentwicklung                          
+                                                            Bluecherstraße 32                            
+                                                            Pforzheim  Baden-Württemberg  75177          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CXR Larus Corporation                        
+68D000-68DFFF                 (base 16)                     CXR Larus Corporation                        
+                                                            894 Faulstich Court                          
+                                                            San Jose  CA  95112                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Total RF, LLC                                
+69F000-69FFFF                 (base 16)                     Total RF, LLC                                
+                                                            777 American Drive                           
+                                                            Bensalem  PA  19020                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ESA  Messtechnik GmbH                        
+67D000-67DFFF                 (base 16)                     ESA  Messtechnik GmbH                        
+                                                            Schlossstrasse 119                           
+                                                            Olching    D-82140                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Honey Network Research Limited               
+680000-680FFF                 (base 16)                     Honey Network Research Limited               
+                                                            Bedford i-Lab                                
+                                                            Bedford  Bedfordshire  MK44 3RZ              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DESY                                         
+66C000-66CFFF                 (base 16)                     DESY                                         
+                                                            Notkestrasse 85                              
+                                                            Hamburg  Hamburg  22607                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Linear Systems Ltd.                          
+66E000-66EFFF                 (base 16)                     Linear Systems Ltd.                          
+                                                            Unit# 1 - 1717 Dublin Avenue                 
+                                                            Winnipeg  MB  R3H 0H2                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ProconX Pty Ltd                              
+677000-677FFF                 (base 16)                     ProconX Pty Ltd                              
+                                                            PO Box 791                                   
+                                                            Sumner Park BC  QLD  4074                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         IHM                                          
+678000-678FFF                 (base 16)                     IHM                                          
+                                                            Vandtaarnsvej 87                             
+                                                            Soborg  Copenhagen  2860                     
+                                                            DK                                           
+
+00-50-C2                      (hex)                         CC Systems AB                                
+67A000-67AFFF                 (base 16)                     CC Systems AB                                
+                                                            Box 83                                       
+                                                            Alfta    82222                               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         EDS                                          
+676000-676FFF                 (base 16)                     EDS                                          
+                                                            100 Winchester Cir                           
+                                                            Los Gatos  Ca  95032                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         NetworkSound, Inc                            
+665000-665FFF                 (base 16)                     NetworkSound, Inc                            
+                                                            2381 Zanker Road, Ste 120                    
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Enatel Limited                               
+643000-643FFF                 (base 16)                     Enatel Limited                               
+                                                            66 Treffers Road                             
+                                                            Christchurch    8042                         
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         TRUTOUCH TECHNOLOGIES INC                    
+646000-646FFF                 (base 16)                     TRUTOUCH TECHNOLOGIES INC                    
+                                                            800 BRADBURY DR SE                           
+                                                            ALBUQUERQUE  NM  87106-4310                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fraunhofer IIS                               
+631000-631FFF                 (base 16)                     Fraunhofer IIS                               
+                                                            Am Wolfsmantel 33                            
+                                                            Erlangen  Bayern  91058                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Hisstema AB                                  
+65A000-65AFFF                 (base 16)                     Hisstema AB                                  
+                                                            Hantverksvägen 13                            
+                                                            Södertälje    S-151 65                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Doble Engineering                            
+653000-653FFF                 (base 16)                     Doble Engineering                            
+                                                            85 Walnut St                                 
+                                                            Watertown  MA  02472                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         PaloDEx Group Oy                             
+654000-654FFF                 (base 16)                     PaloDEx Group Oy                             
+                                                            Nahkelantie 160                              
+                                                            TUUSULA    FIN 04301                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Brookhaven National Laboratory               
+611000-611FFF                 (base 16)                     Brookhaven National Laboratory               
+                                                            Bldg 911B                                    
+                                                            Upton  NY  11973                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         FDT Manufacturing, LLC                       
+610000-610FFF                 (base 16)                     FDT Manufacturing, LLC                       
+                                                            1005 Alderman Dr                             
+                                                            Alpharetta  GA  30005                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Version-T                                    
+621000-621FFF                 (base 16)                     Version-T                                    
+                                                            1 per. Pestelya 50A                          
+                                                            Kaluga  Kaluga region  248003                
+                                                            RU                                           
+
+00-50-C2                      (hex)                         DARE Development                             
+628000-628FFF                 (base 16)                     DARE Development                             
+                                                            Vijzelmolenlaan 7                            
+                                                            Woerden  UT  3447 GX                         
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Prisma Engineering srl                       
+62A000-62AFFF                 (base 16)                     Prisma Engineering srl                       
+                                                            Via Petrocchi, 4                             
+                                                            Milano  MI  20127                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Kommunikations- & Sicherheitssysteme Gesellschaft m.b.H
+60F000-60FFFF                 (base 16)                     Kommunikations- & Sicherheitssysteme Gesellschaft m.b.H
+                                                            Computerstr. 6                               
+                                                            Vienna    1100                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         EBNeuro SpA                                  
+625000-625FFF                 (base 16)                     EBNeuro SpA                                  
+                                                            VIA PIETRO FANFANI 97/a                      
+                                                            FIRENZE    50127                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         LESTER ELECTRONICS LTD                       
+61E000-61EFFF                 (base 16)                     LESTER ELECTRONICS LTD                       
+                                                            UNIT 3, WYCLIFFE INDUSTRIAL EST              
+                                                            LEICESTER  UK  LE17 4HG                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ROTHARY Solutions AG                         
+5F9000-5F9FFF                 (base 16)                     ROTHARY Solutions AG                         
+                                                            Hauptstrasse 84                              
+                                                            Kreuzlingen  TG  8280                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+5E0000-5E0FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ittiam Systems (P) Ltd                       
+5E1000-5E1FFF                 (base 16)                     Ittiam Systems (P) Ltd                       
+                                                            Consulate 1,                                 
+                                                            Bangalore  Karnataka  560025                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         ASiS Technologies Pte Ltd                    
+5EC000-5ECFFF                 (base 16)                     ASiS Technologies Pte Ltd                    
+                                                            71 Ubi Crescent                              
+                                                            Singapore    408571                          
+                                                            SG                                           
+
+00-50-C2                      (hex)                         SomerData ltd                                
+5DD000-5DDFFF                 (base 16)                     SomerData ltd                                
+                                                            Underwood Business Park                      
+                                                            Wells  Somerset  BA5 1AF                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Musatel                                      
+5E6000-5E6FFF                 (base 16)                     Musatel                                      
+                                                            c/Caridad, 1 BIS                             
+                                                            Pozuelo de Alarcón  Madrid  28224            
+                                                            ES                                           
+
+00-50-C2                      (hex)                         EADS TEST & SERVICES                         
+5E7000-5E7FFF                 (base 16)                     EADS TEST & SERVICES                         
+                                                            5, avenue guynemer BP 86                     
+                                                            colomiers    31772                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Kobold Sistemi s.r.l.                        
+5CB000-5CBFFF                 (base 16)                     Kobold Sistemi s.r.l.                        
+                                                            Via Giuseppe Di Vittorio 307/28              
+                                                            Sesto San Giovanni  Milano  20099            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         RADA Electronics Industries Ltd.             
+5CD000-5CDFFF                 (base 16)                     RADA Electronics Industries Ltd.             
+                                                            7 Gibory Israel St.                          
+                                                            Netanya    42504                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Roke Manor Research Ltd                      
+5CE000-5CEFFF                 (base 16)                     Roke Manor Research Ltd                      
+                                                            Roke Manor                                   
+                                                            ROMSEY  Hampshire  SO51 0ZN                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Buyang Electronics Industrial Co., Ltd.      
+5CA000-5CAFFF                 (base 16)                     Buyang Electronics Industrial Co., Ltd.      
+                                                            434-140 Oryu-Dong                            
+                                                            Incheon    404-300                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Georgia Tech Research Institute              
+5C8000-5C8FFF                 (base 16)                     Georgia Tech Research Institute              
+                                                            400 Tenth St. NW                             
+                                                            Atlanta  Georgia  30332                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         KS System GmbH                               
+5C3000-5C3FFF                 (base 16)                     KS System GmbH                               
+                                                            Alexanderstr. 37                             
+                                                            Muelheim  NRW  45472                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Card Access Services Pty Ltd                 
+5BE000-5BEFFF                 (base 16)                     Card Access Services Pty Ltd                 
+                                                            Level 2, 7-9 Albany St                       
+                                                            Sydney  New South Wales  2065                
+                                                            AU                                           
+
+00-50-C2                      (hex)                         R. L. Drake Company                          
+5C1000-5C1FFF                 (base 16)                     R. L. Drake Company                          
+                                                            230 Industrial Drive                         
+                                                            Franklin  OH  45005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Terrascience Systems Ltd.                    
+5B4000-5B4FFF                 (base 16)                     Terrascience Systems Ltd.                    
+                                                            2040 West 10th Ave.                          
+                                                            Vancouver  B.C.  V6J 2B3                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         SPANSION                                     
+596000-596FFF                 (base 16)                     SPANSION                                     
+                                                            PO Box 3453, Mail Stop 9                     
+                                                            Sunnyvale  CA  94088                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Callpod, Inc.                                
+595000-595FFF                 (base 16)                     Callpod, Inc.                                
+                                                            850 W. Jackson                               
+                                                            Chicago  IL  60607                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fen Technology Limited                       
+599000-599FFF                 (base 16)                     Fen Technology Limited                       
+                                                            4 Oakington Business Park                    
+                                                            Oakington  Cambridge  CB24 3DQ               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         AYC Telecom Ltd                              
+5A9000-5A9FFF                 (base 16)                     AYC Telecom Ltd                              
+                                                            Unit 2 Fleet Business Park                   
+                                                            Church Crookham  Hampshire  GU52 8BF         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SAPEC                                        
+59B000-59BFFF                 (base 16)                     SAPEC                                        
+                                                            Rufino Gonzalez, 15                          
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DELSAT GROUP S.A.                            
+59C000-59CFFF                 (base 16)                     DELSAT GROUP S.A.                            
+                                                            CORDOBA 3197                                 
+                                                            MAR DEL PLATA  BUENOS AIRES  7600            
+                                                            AR                                           
+
+00-50-C2                      (hex)                         Penny & Giles Aerospace Ltd                  
+58E000-58EFFF                 (base 16)                     Penny & Giles Aerospace Ltd                  
+                                                            1 Airfield Road                              
+                                                            Christchurch  Dorset  BH23 3TH               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HORIBA ABX SAS                               
+589000-589FFF                 (base 16)                     HORIBA ABX SAS                               
+                                                            rue du caducee                               
+                                                            Montpellier  Herault  34000                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Lattice Semiconductor Corp. (LPA)            
+58C000-58CFFF                 (base 16)                     Lattice Semiconductor Corp. (LPA)            
+                                                            2115 O’Nel Drive                             
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dataton Utvecklings AB                       
+56B000-56BFFF                 (base 16)                     Dataton Utvecklings AB                       
+                                                            Box 454                                      
+                                                            Linkoping  .  58105                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Twinwin Technplogy Co.,Ltd.                  
+569000-569FFF                 (base 16)                     Twinwin Technplogy Co.,Ltd.                  
+                                                            6F-2 ,No.400,Sec 1,Changping Rd.,Beirict,    
+                                                                406                                      
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Gastager Systemtechnik GmbH                  
+579000-579FFF                 (base 16)                     Gastager Systemtechnik GmbH                  
+                                                            Gerating 10                                  
+                                                            Traunstein  Bayern  83278                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Devitech ApS                                 
+581000-581FFF                 (base 16)                     Devitech ApS                                 
+                                                            Sundsholmen 12                               
+                                                            Noerresundby  DK  9400                       
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Netsynt S.p.A.                               
+549000-549FFF                 (base 16)                     Netsynt S.p.A.                               
+                                                            Via G. A. Resti 53                           
+                                                            Roma    00143                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         BLANKOM Antennentechnik GmbH                 
+547000-547FFF                 (base 16)                     BLANKOM Antennentechnik GmbH                 
+                                                            Bahnhofstr. 39                               
+                                                            Bad Blankenburg  Deutschland  D-07422        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IPTC Tech. Comm. AB                          
+54A000-54AFFF                 (base 16)                     IPTC Tech. Comm. AB                          
+                                                            Pyramidbacken 6                              
+                                                            Kungens Kurva  Stockholm  14175              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Image Control Design Limited                 
+53A000-53AFFF                 (base 16)                     Image Control Design Limited                 
+                                                            78 London Road                               
+                                                            Waterlooville  Hampshire  PO7 5AB            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Orion Technologies,LLC                       
+531000-531FFF                 (base 16)                     Orion Technologies,LLC                       
+                                                            12605 Challenger Parkway Suite 130           
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+52E000-52EFFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         VITEC MULTIMEDIA                             
+52C000-52CFFF                 (base 16)                     VITEC MULTIMEDIA                             
+                                                            99, rue Pierre Semard                        
+                                                            CHATILLON    92324                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         GEM ELETTRONICA Srl                          
+4FE000-4FEFFF                 (base 16)                     GEM ELETTRONICA Srl                          
+                                                            Via A. Vespucci, 9                           
+                                                            San Benedetto del Tronto  AP  63074          
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Creative Retail Entertainment                
+4EF000-4EFFFF                 (base 16)                     Creative Retail Entertainment                
+                                                            Unit 2                                       
+                                                            Calcot  Reading  RG31 7SD                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         RESPIRONICS INC.                             
+503000-503FFF                 (base 16)                     RESPIRONICS INC.                             
+                                                            1001 MURRY RIDGE LANE                        
+                                                            MURRYSVILLE  PENNSYLVANIA  15668             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ziehl-Abegg AG                               
+4CF000-4CFFFF                 (base 16)                     Ziehl-Abegg AG                               
+                                                            Heinz-Ziehl-Straße                           
+                                                            Kuenzelsau  Baden-Württemberg  74653         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Open Date Equipment Limited                  
+4CE000-4CEFFF                 (base 16)                     Open Date Equipment Limited                  
+                                                            Units 7 & 8 Furmston Court                   
+                                                            Letchworth Garden City  Hertfordshire  SG6 1UJ
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ingenieurbüro Schober                        
+4D6000-4D6FFF                 (base 16)                     Ingenieurbüro Schober                        
+                                                            Schloßgarten 16                              
+                                                            Cadolzburg  Bayern  90556                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RCS Energy Management Ltd                    
+4D0000-4D0FFF                 (base 16)                     RCS Energy Management Ltd                    
+                                                            RMS House                                    
+                                                            Newbury  Berkshire  RG14 5PX                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         SLICAN sp. z o.o.                            
+4D1000-4D1FFF                 (base 16)                     SLICAN sp. z o.o.                            
+                                                            ul.M.Konopnickiej 18                         
+                                                            Bydgoszcz  Kujawsko-Pomorskie  85-124        
+                                                            PL                                           
+
+00-50-C2                      (hex)                         SATEL sp. z o.o.                             
+4E8000-4E8FFF                 (base 16)                     SATEL sp. z o.o.                             
+                                                            Schuberta 79                                 
+                                                            Gdańsk  pomorskie  80-172                    
+                                                            PL                                           
+
+00-50-C2                      (hex)                         GE Security Kampro                           
+4D9000-4D9FFF                 (base 16)                     GE Security Kampro                           
+                                                            2F, No.8,Lane 97,Wugong Rd.,Wu-Ku Ind. Park  
+                                                            Hsin-Chuang City  Taipei County  248         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         OpenPeak, Inc.                               
+4AD000-4ADFFF                 (base 16)                     OpenPeak, Inc.                               
+                                                            5355 Town Center Rd                          
+                                                            Boca Raton  FL  33486                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         GFI Chrono Time                              
+4B7000-4B7FFF                 (base 16)                     GFI Chrono Time                              
+                                                            121 rue des Guillees                         
+                                                            CHAURAY    79180                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Shenzhen Hongdian Technologies.,Ltd          
+4B8000-4B8FFF                 (base 16)                     Shenzhen Hongdian Technologies.,Ltd          
+                                                            15H,Jinsong Building,Chegongmiao             
+                                                            Shenzhen  Guangdong  518040                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Rose Technologies                            
+4B9000-4B9FFF                 (base 16)                     Rose Technologies                            
+                                                            13400 NE 20th Street, #32                    
+                                                            Bellevue  WA  98005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Doramu Co.,Ltd.                              
+4AC000-4ACFFF                 (base 16)                     Doramu Co.,Ltd.                              
+                                                            4F Oyama Bldg.                               
+                                                            Taito-ku,  Tokyo  110-0015                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         JVF Communications Ltd                       
+4AB000-4ABFFF                 (base 16)                     JVF Communications Ltd                       
+                                                            30 Loughborough Road                         
+                                                            Mountsorrel  Leics  LE12 7AT                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Faber Electronics BV                         
+4A9000-4A9FFF                 (base 16)                     Faber Electronics BV                         
+                                                            Th. Dobbeweg 1                               
+                                                            Velp  Gelderland  6883 GN Velp               
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Scirocco AB                                  
+4C9000-4C9FFF                 (base 16)                     Scirocco AB                                  
+                                                            Electrum 217                                 
+                                                            Kista    SE-164 40                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         TelASIC Communications, Inc.                 
+49A000-49AFFF                 (base 16)                     TelASIC Communications, Inc.                 
+                                                            1940 E Mariposa Avenue                       
+                                                            El Segundo  CA  90245                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SPECS GmbH                                   
+4A2000-4A2FFF                 (base 16)                     SPECS GmbH                                   
+                                                            Voltastrasse 5                               
+                                                            Berlin    13355                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Safegate International AB                    
+486000-486FFF                 (base 16)                     Safegate International AB                    
+                                                            Djurhagegatan 19                             
+                                                            Malmö    21376                               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Trellia Networks                             
+499000-499FFF                 (base 16)                     Trellia Networks                             
+                                                            774 Decarie                                  
+                                                            Montreal  Quebec  H4L 3L5                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Computer Sciences Corp                       
+481000-481FFF                 (base 16)                     Computer Sciences Corp                       
+                                                            2315 Meredith Lane, Ste. A                   
+                                                            Santa Maria  CA  93455-1145                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sensus Metering Systems Israel               
+473000-473FFF                 (base 16)                     Sensus Metering Systems Israel               
+                                                            16 Hamelacha st                              
+                                                            Rosh Haayin    48091                         
+                                                            IL                                           
+
+00-50-C2                      (hex)                         WIT Inc                                      
+47D000-47DFFF                 (base 16)                     WIT Inc                                      
+                                                            420 E Lana Ct                                
+                                                            Draper  UT  84020                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         LONAP Limited                                
+466000-466FFF                 (base 16)                     LONAP Limited                                
+                                                            5 Fleet Place                                
+                                                              London  EC4M 7RD                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Computime Systems UK Ltd.                    
+44C000-44CFFF                 (base 16)                     Computime Systems UK Ltd.                    
+                                                            4 Woodside Mews                              
+                                                            Leeds  West Yorkshire  LS16 6QE              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         United Western Technologies                  
+467000-467FFF                 (base 16)                     United Western Technologies                  
+                                                            330 West Clark Street                        
+                                                            Pasco  Washington  99301                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         ADATEL TELECOMUNICACIONES S.A.               
+435000-435FFF                 (base 16)                     ADATEL TELECOMUNICACIONES S.A.               
+                                                            Manuel Tovar, 38                             
+                                                            Madrid    28034                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Argo-Tech                                    
+42D000-42DFFF                 (base 16)                     Argo-Tech                                    
+                                                            23555 Euclid Ave.                            
+                                                            Cleveland  OH  44117                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Satellite Services BV                        
+436000-436FFF                 (base 16)                     Satellite Services BV                        
+                                                            Scheepmakerstraat 40                         
+                                                            Katwijk aan Zee  Zuid-Holland  2222 AC       
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Altronic, Inc.                               
+41D000-41DFFF                 (base 16)                     Altronic, Inc.                               
+                                                            712 Trumbull Ave                             
+                                                            Girard  OHIO  44420                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         TERN, Inc.                                   
+408000-408FFF                 (base 16)                     TERN, Inc.                                   
+                                                            1724 Picasso Ave.                            
+                                                            Davis  CA  95616                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Roxar A/S                                    
+428000-428FFF                 (base 16)                     Roxar A/S                                    
+                                                            Bjellandveien 24.                            
+                                                            Toensberg    3103                            
+                                                            NO                                           
+
+00-50-C2                      (hex)                         STL GmbH                                     
+3F2000-3F2FFF                 (base 16)                     STL GmbH                                     
+                                                            Max-Stromeyer-Straße 116                     
+                                                            Konstanz  Baden-Württemberg  78467           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Commoca, Inc                                 
+3EE000-3EEFFF                 (base 16)                     Commoca, Inc                                 
+                                                            #68 East Mendez Vigo Suite 3                 
+                                                            Mayaguez  PR  00680                          
+                                                            PR                                           
+
+00-50-C2                      (hex)                         Tumsan                                       
+3FA000-3FAFFF                 (base 16)                     Tumsan                                       
+                                                            Sturenatu 27                                 
+                                                            Helsinki    00510                            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         dAFTdATA Limited                             
+3F6000-3F6FFF                 (base 16)                     dAFTdATA Limited                             
+                                                            dAFT HQ                                      
+                                                            Colchester  Essex  CO3 3UN                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PAT Industries, DBA Pacific Advanced Technology
+3EF000-3EFFFF                 (base 16)                     PAT Industries, DBA Pacific Advanced Technology
+                                                            85 Industrial Way, Unit A                    
+                                                            Buellton  CA  93427                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         HaiVision Systems Inc                        
+3FE000-3FEFFF                 (base 16)                     HaiVision Systems Inc                        
+                                                            4445 Garand                                  
+                                                            Ville St-Laurent  Quebec  H4R2H9             
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Superna Ltd                                  
+3F8000-3F8FFF                 (base 16)                     Superna Ltd                                  
+                                                            102 Donald Dr                                
+                                                            Hamilton  NJ  08619                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bavaria Digital Technik GmbH                 
+3D9000-3D9FFF                 (base 16)                     Bavaria Digital Technik GmbH                 
+                                                            Rehbichler Weg 26                            
+                                                            Pfronten  Bayern  87459                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Key Systems , Inc.                           
+3D8000-3D8FFF                 (base 16)                     Key Systems , Inc.                           
+                                                            7635 Glacier Hill                            
+                                                            Victor  NY  14564                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tyzx, Inc.                                   
+3BC000-3BCFFF                 (base 16)                     Tyzx, Inc.                                   
+                                                            3895 Bohannon Drive                          
+                                                            Menlo Park  CA  94025                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pauly Steuer- und Regelanlagen GmbH & Co. KG 
+3BE000-3BEFFF                 (base 16)                     Pauly Steuer- und Regelanlagen GmbH & Co. KG 
+                                                            Pfingstweide 8                               
+                                                            Friedberg  Hessen  61169                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Casabyte Inc.                                
+3C2000-3C2FFF                 (base 16)                     Casabyte Inc.                                
+                                                            POB 10127                                    
+                                                            Blacksburg  VA  24062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sypris Electronics                           
+3C4000-3C4FFF                 (base 16)                     Sypris Electronics                           
+                                                            10901N McKinley Dr                           
+                                                            Tampa  Florida  33612                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB Inc.                                     
+3CA000-3CAFFF                 (base 16)                     ABB Inc.                                     
+                                                            843 North Jefferson St.                      
+                                                            Lewisburg  West Virginia  24901              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Embedit A/S                                  
+394000-394FFF                 (base 16)                     Embedit A/S                                  
+                                                            Generatorvej 8A                              
+                                                            Herlev    2730                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         TTC Telecom                                  
+38F000-38FFFF                 (base 16)                     TTC Telecom                                  
+                                                            Jiskrova 4                                   
+                                                            Kosice    040 01                             
+                                                            SK                                           
+
+00-50-C2                      (hex)                         Esensors, Inc.                               
+391000-391FFF                 (base 16)                     Esensors, Inc.                               
+                                                            4240 Ridge Lea Road                          
+                                                            Amherst  NY  14226                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Star Link Communication Pvt. Ltd.            
+3A3000-3A3FFF                 (base 16)                     Star Link Communication Pvt. Ltd.            
+                                                            HR114/6 & Hr132/6, Pulprehladpur,            
+                                                            New Delhi    110044                          
+                                                            IN                                           
+
+00-50-C2                      (hex)                         TIYODA MFG CO.,LTD.                          
+39C000-39CFFF                 (base 16)                     TIYODA MFG CO.,LTD.                          
+                                                            75-5 Imojiya                                 
+                                                            Chikuma-city  NAGANO  387-0015               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Spirent Communications (Scotland) Limited    
+3AD000-3ADFFF                 (base 16)                     Spirent Communications (Scotland) Limited    
+                                                            Hamilton International Technology Park       
+                                                            Glasgow  South Lanarkshire  G72 0FF          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Optronic Partner pr AB                       
+36A000-36AFFF                 (base 16)                     Optronic Partner pr AB                       
+                                                            Box 733                                      
+                                                            SKELLEFTEA  SE  93127                        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         CANMAX Technology Ltd.                       
+367000-367FFF                 (base 16)                     CANMAX Technology Ltd.                       
+                                                            7F, No.183. Section 1, Tatung Road           
+                                                            Hsi Chih  Taipei Hsien  221                  
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Vanguard Technology Corp.                    
+366000-366FFF                 (base 16)                     Vanguard Technology Corp.                    
+                                                            5633 Paradise Blvd. NW                       
+                                                            Albuquerque  NM  87114                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         VeroTrak Inc.                                
+37D000-37DFFF                 (base 16)                     VeroTrak Inc.                                
+                                                            6062 Hollow Tree Court                       
+                                                            Colorado Springs  CO  80918                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Freescale Semiconductor                      
+37B000-37BFFF                 (base 16)                     Freescale Semiconductor                      
+                                                            2100 East  Elliot                            
+                                                            Tempe  AZ  85284                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+364000-364FFF                 (base 16)                     Tattile srl                                  
+                                                            Via Trento 127/129                           
+                                                            Capriano del Colle  Brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Europe Technologies                          
+370000-370FFF                 (base 16)                     Europe Technologies                          
+                                                            1681, Route des Dolines                      
+                                                            Valbonne    06560                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         DIGITAL ART SYSTEM                           
+371000-371FFF                 (base 16)                     DIGITAL ART SYSTEM                           
+                                                            838 rue de l'Aiguelongue                     
+                                                            Montpellier  HR  34090                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         SUNGJIN NEOTECH Co.Ltd.                      
+385000-385FFF                 (base 16)                     SUNGJIN NEOTECH Co.Ltd.                      
+                                                            #105,Suntechcity Bldg,513-15 Sangdaewon-Dong, Jungwon-Gu
+                                                            Seongnam  Kyonggi-Do  462-806                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Oplink Communications                        
+36D000-36DFFF                 (base 16)                     Oplink Communications                        
+                                                            3469 North First St.                         
+                                                            San Jose  California  95134                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         ELV Elektronik AG                            
+372000-372FFF                 (base 16)                     ELV Elektronik AG                            
+                                                            Maiburger Str. 32-36                         
+                                                            Leer  Niedersachsen  26789                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EXYS bvba                                    
+33F000-33FFFF                 (base 16)                     EXYS bvba                                    
+                                                            Populierenlaan 6                             
+                                                            Tildonk    3150                              
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Row Seven Ltd                                
+347000-347FFF                 (base 16)                     Row Seven Ltd                                
+                                                            13 Swan Yard                                 
+                                                            London    N1 1SD                             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Advanced IP Communications                   
+354000-354FFF                 (base 16)                     Advanced IP Communications                   
+                                                            1909 N. Glenville Suite 100                  
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         NIE Corporation                              
+34A000-34AFFF                 (base 16)                     NIE Corporation                              
+                                                            Ohara-Sanden Bldg. 7-F                       
+                                                            Shinagawa-ku  Tokyo  141-0022                
+                                                            JP                                           
+
+00-50-C2                      (hex)                         ABB Power Technologies S.p.A.  Unità  Operativa SACE (PTMV)
+34E000-34EFFF                 (base 16)                     ABB Power Technologies S.p.A.  Unità  Operativa SACE (PTMV)
+                                                            vai Friuli 4                                 
+                                                            Dalmine  (Bergamo)  20044                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Athena Semiconductor                         
+357000-357FFF                 (base 16)                     Athena Semiconductor                         
+                                                            47538 Fremont Blvd.                          
+                                                            Fremont  CA  94358                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Zodiak Data Systems                          
+31A000-31AFFF                 (base 16)                     Zodiak Data Systems                          
+                                                            5, Avenue des Andes                          
+                                                            91978 Courtaboeuf Cedex                      
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Invatron Systems Corp.                       
+319000-319FFF                 (base 16)                     Invatron Systems Corp.                       
+                                                            5710 Timberlea Blvd.                         
+                                                            Mississauga  Ontario  L4W 4W1                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Milmega Ltd                                  
+318000-318FFF                 (base 16)                     Milmega Ltd                                  
+                                                            Ryde Business Park                           
+                                                            Ryde  Isle of WIght  PO33 1BQ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Integrated Silicon Solution (Taiwan), Inc.   
+32C000-32CFFF                 (base 16)                     Integrated Silicon Solution (Taiwan), Inc.   
+                                                            5F, No.1, Creation Rd. II,                   
+                                                            Hsinchu    300                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         BQT Solutions (Australia) Limited            
+322000-322FFF                 (base 16)                     BQT Solutions (Australia) Limited            
+                                                            Unit 5, 12-18 Victoria Street East           
+                                                            Lidcombe  NSW  2141                          
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Red Rock Networks                            
+323000-323FFF                 (base 16)                     Red Rock Networks                            
+                                                            P.O. Box 3465                                
+                                                            Sonora  CA  95370                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ifak system GmbH                             
+315000-315FFF                 (base 16)                     ifak system GmbH                             
+                                                            Schleinufer 11                               
+                                                            Magdeburg  Saxony-Anhalt  39104              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Noran Tel Communications Ltd.                
+306000-306FFF                 (base 16)                     Noran Tel Communications Ltd.                
+                                                            3033 Saskatchewan Drive                      
+                                                            Regina  Saskatchewan  S4T 1H5                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         FiveCo                                       
+308000-308FFF                 (base 16)                     FiveCo                                       
+                                                            Ch. de la Rueyre 116                         
+                                                              Renens  1020                               
+                                                            CH                                           
+
+00-50-C2                      (hex)                         SRI International                            
+2E9000-2E9FFF                 (base 16)                     SRI International                            
+                                                            333 Ravenswood Avenue                        
+                                                            Menlo Park  CA  94025                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Symbium Corporation                          
+305000-305FFF                 (base 16)                     Symbium Corporation                          
+                                                            603 March Road, Suite 100                    
+                                                            Kanata  Ontario  K2K 2M5                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Patria Advanced Solutions                    
+2FF000-2FFFFF                 (base 16)                     Patria Advanced Solutions                    
+                                                            Naulakatu 3                                  
+                                                            Tampere    FIN-33100                         
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Comodo                                       
+311000-311FFF                 (base 16)                     Comodo                                       
+                                                            10 Hey Street                                
+                                                            Bradford  West Yorkshire  BD7 1DQ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         TEAMLOG                                      
+30C000-30CFFF                 (base 16)                     TEAMLOG                                      
+                                                            10, rue Lavoisier                            
+                                                            Montbonnot  Isère (38)  38330                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Blackline Systems Corporation                
+2FC000-2FCFFF                 (base 16)                     Blackline Systems Corporation                
+                                                            2794 Fenton Road                             
+                                                            Ottawa  Ontario  K1T 3T7                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Profline B.V.                                
+2EF000-2EFFFF                 (base 16)                     Profline B.V.                                
+                                                            Marga Klompeelaan 18                         
+                                                            Arnhem  Gelderland  6836 BH                  
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Roseman Engineering Ltd.                     
+2C9000-2C9FFF                 (base 16)                     Roseman Engineering Ltd.                     
+                                                            65 Weizman St.                               
+                                                            Givataim    53468                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         PUTERCOM CO., LTD                            
+2CA000-2CAFFF                 (base 16)                     PUTERCOM CO., LTD                            
+                                                            5F-3, NO. 130 JIAN KANG ROAD                 
+                                                            CHUNG HO CITY,  Taipei Hsien  235            
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Diseño de Sistemas en Silicio S.A.           
+2CF000-2CFFFF                 (base 16)                     Diseño de Sistemas en Silicio S.A.           
+                                                            Charles Robert Darwin, 2                     
+                                                            Paterna  Valencia  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Miritek, Inc.                                
+2D1000-2D1FFF                 (base 16)                     Miritek, Inc.                                
+                                                            32321 TBI, ICU                               
+                                                            Daejon    305-732                            
+                                                            KR                                           
+
+00-50-C2                      (hex)                         AIRNET COMMUNICATIONS CORP                   
+2D2000-2D2FFF                 (base 16)                     AIRNET COMMUNICATIONS CORP                   
+                                                            3950 DOW RD                                  
+                                                            MELBOURNE  FL  32934                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         AutoTOOLS group Co. Ltd.                     
+2DB000-2DBFFF                 (base 16)                     AutoTOOLS group Co. Ltd.                     
+                                                            15F, No. 88, Chung Hsiao E. Rd., Sec. 2,     
+                                                            Taipei    100                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         MICREL-NKE                                   
+2DF000-2DFFFF                 (base 16)                     MICREL-NKE                                   
+                                                            rue gutenberg                                
+                                                            HENNEBONT    56700                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Westek Technology Ltd                        
+2DD000-2DDFFF                 (base 16)                     Westek Technology Ltd                        
+                                                            Unit 1, Lancaster Road                       
+                                                            Melksham  Wiltshire  SN12 6TT                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Access IS                                    
+2E1000-2E1FFF                 (base 16)                     Access IS                                    
+                                                            18 Suttons Business Park                     
+                                                            READING  Berks  RG6 1AZ                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         S.M.V. Systemelektronik GmbH                 
+2E8000-2E8FFF                 (base 16)                     S.M.V. Systemelektronik GmbH                 
+                                                            Firkenweg 7                                  
+                                                            Unterföhring  Bayern  85774                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Stage Tec Entwicklungsgesellschaft für professionelle Audio
+2C1000-2C1FFF                 (base 16)                     Stage Tec Entwicklungsgesellschaft für professionelle Audio
+                                                            Tabbertstraße 10                             
+                                                            Berlin  Berlin  12459                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Embedded Systems Design                      
+2B3000-2B3FFF                 (base 16)                     Embedded Systems Design                      
+                                                            1064 Tabernacle                              
+                                                            Sequin  TX  78155                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMBEDDED TOOLSMITHS                          
+2CC000-2CCFFF                 (base 16)                     EMBEDDED TOOLSMITHS                          
+                                                            3007 RIDGE VALE CIRCLE                       
+                                                            TAMPA  FL  33594                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Invensys Energy Systens (NZ) Limited         
+2C4000-2C4FFF                 (base 16)                     Invensys Energy Systens (NZ) Limited         
+                                                            39 Princess Street                           
+                                                            Christchurch    8030                         
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Xipher Embedded Networking                   
+2A4000-2A4FFF                 (base 16)                     Xipher Embedded Networking                   
+                                                            434 Turnpike Road                            
+                                                            Ashford  CT  06278                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Infinetix Corp                               
+2A1000-2A1FFF                 (base 16)                     Infinetix Corp                               
+                                                            2721  N. Van Marter #3                       
+                                                            Spokane  WA  99206                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         OpVista                                      
+296000-296FFF                 (base 16)                     OpVista                                      
+                                                            25A Technology Dr.                           
+                                                            Irvine  CA  92618                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Epelsa, SL                                   
+2A2000-2A2FFF                 (base 16)                     Epelsa, SL                                   
+                                                            C/albasanz, 6 y 8                            
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+26D000-26DFFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PK INNOVATION CENTRE                  
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         S4 Technology Pty Ltd                        
+270000-270FFF                 (base 16)                     S4 Technology Pty Ltd                        
+                                                            325 Pitt Street                              
+                                                            Sydney  NSW 2000                             
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         ATEME                                        
+286000-286FFF                 (base 16)                     ATEME                                        
+                                                            26 Burospace                                 
+                                                            BIEVRES Cedex    91573                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CabTronix GmbH                               
+281000-281FFF                 (base 16)                     CabTronix GmbH                               
+                                                            Hohstrass 1                                  
+                                                            Kloten  Zuerich  8302                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ANSITEX CORP.                                
+283000-283FFF                 (base 16)                     ANSITEX CORP.                                
+                                                            24F., No.56, Liansing Rd., Sijhih City,      
+                                                            Taipei County    221                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         ALLIED TELESIS K.K.                          
+27D000-27DFFF                 (base 16)                     ALLIED TELESIS K.K.                          
+                                                            PIAZZA TIRANA N. 24/4 B                      
+                                                            MILANO    20147                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         VLSIP TECHNOLOGIES INC.                      
+271000-271FFF                 (base 16)                     VLSIP TECHNOLOGIES INC.                      
+                                                            750 PRESIDENTIAL DR                          
+                                                            RICHARDSON  TEXAS  75081                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         TECNEW Electronics Engineering Cr., Ltd.     
+287000-287FFF                 (base 16)                     TECNEW Electronics Engineering Cr., Ltd.     
+                                                            16F, No. 75, Shin Tai Wu Rd., Sec. 1, Sh     
+                                                            Taipei    221                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Extreme Engineering Solutions                
+275000-275FFF                 (base 16)                     Extreme Engineering Solutions                
+                                                            7878 Big Sky Drive                           
+                                                            Madison  WI  53719                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Replicom Ltd.                                
+278000-278FFF                 (base 16)                     Replicom Ltd.                                
+                                                            2 Hailan Street                              
+                                                            Or Akiva    30600                            
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Tattile Srl                                  
+261000-261FFF                 (base 16)                     Tattile Srl                                  
+                                                            Via Trento 127/129                           
+                                                            Capriano del Colle  Brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         BIOTAGE                                      
+260000-260FFF                 (base 16)                     BIOTAGE                                      
+                                                            1725 DISCOVERY DR.                           
+                                                            CHARLOTTESVILLE  VIRGINIA  22911             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Shanghai Gaozhi Science&Technology Development Ltd.
+262000-262FFF                 (base 16)                     Shanghai Gaozhi Science&Technology Development Ltd.
+                                                            No.283 QingJiang Rd.                         
+                                                            Shanghai    200233                           
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Kallastra Inc.                               
+23E000-23EFFF                 (base 16)                     Kallastra Inc.                               
+                                                            5190 de Mentana                              
+                                                            Montreal  QC  H2J 3C4                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Legra Systems, Inc.                          
+231000-231FFF                 (base 16)                     Legra Systems, Inc.                          
+                                                            3 Burlington Woods Drive                     
+                                                            Burlington  MA  01803                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Riegl Laser Measurement Systems GmbH         
+22B000-22BFFF                 (base 16)                     Riegl Laser Measurement Systems GmbH         
+                                                            Riedenburgstraße 48                          
+                                                            Horn  Niederösterreich  A-3580               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         CDS Rail                                     
+24A000-24AFFF                 (base 16)                     CDS Rail                                     
+                                                            Unit 1, Fulcrum 4                            
+                                                            Fareham  Hampshire  PO15 7FT                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         RGB Spectrum                                 
+243000-243FFF                 (base 16)                     RGB Spectrum                                 
+                                                            950 Marina Village Pkwy                      
+                                                            Alameda  CA  94501                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wheatstone Corporation                       
+23C000-23CFFF                 (base 16)                     Wheatstone Corporation                       
+                                                            600 Industrial Drive                         
+                                                            New Bern  NC  28562                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Geoquip Ltd                                  
+240000-240FFF                 (base 16)                     Geoquip Ltd                                  
+                                                            Cromford Road                                
+                                                            Matlock  Derbyshire  D4 4FR                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         OMICRON electronics GmbH                     
+20F000-20FFFF                 (base 16)                     OMICRON electronics GmbH                     
+                                                            Oberes Ried 1                                
+                                                            Klaus    A-6833                              
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Innovics Wireless Inc                        
+210000-210FFF                 (base 16)                     Innovics Wireless Inc                        
+                                                            11500 W Olympic Blvd                         
+                                                            Los Angeles  CA  90064                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Oshimi System Design Inc.                    
+214000-214FFF                 (base 16)                     Oshimi System Design Inc.                    
+                                                            2-55-2                                       
+                                                            Arakawa-ku  Tokyo  116-0002                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Nansen S. A. - Instrumentos de Precisão      
+218000-218FFF                 (base 16)                     Nansen S. A. - Instrumentos de Precisão      
+                                                            José Pedro Araújo, 960                       
+                                                            Contagem  Minas Gerais  32341560             
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Serveron Corporation                         
+220000-220FFF                 (base 16)                     Serveron Corporation                         
+                                                            3305 NW Aloclek Dr                           
+                                                            Hillsboro  OR  97124-7101                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         ULTRACKER TECHNOLOGY                         
+1F8000-1F8FFF                 (base 16)                     ULTRACKER TECHNOLOGY                         
+                                                            3F-2,No.1247 ,Chung-Cheng Rd,Taoyuan cit     
+                                                            Taoyuan    330                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+1F9000-1F9FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam                                   
+                                                            Basel  BL  4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Whittier Mailing Products, Inc.              
+200000-200FFF                 (base 16)                     Whittier Mailing Products, Inc.              
+                                                            13019 Park Street                            
+                                                            Santa Fe Springs  California  90670          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Product Design Dept., Sohwa Corporation      
+1FF000-1FFFFF                 (base 16)                     Product Design Dept., Sohwa Corporation      
+                                                            Shinyokohama Tobu AK Bldg.                   
+                                                            Yokohama  Kanagawa  222-0033                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Communication and Telemechanical Systems Company Limited
+20C000-20CFFF                 (base 16)                     Communication and Telemechanical Systems Company Limited
+                                                            Gragdanski str. 111                          
+                                                            St.Petersburg    195256                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Shenyang Internet Technology Inc             
+1D2000-1D2FFF                 (base 16)                     Shenyang Internet Technology Inc             
+                                                            2413 Frosted Green Ln                        
+                                                            Plano  Texas  75025                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Benchmark Electronics                        
+1D1000-1D1FFF                 (base 16)                     Benchmark Electronics                        
+                                                            4065 Theurer Blvd.                           
+                                                            Winona  MN  55987                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ReliOn Inc.                                  
+1DE000-1DEFFF                 (base 16)                     ReliOn Inc.                                  
+                                                            15913 E Euclid Ave                           
+                                                            Spokane  WA  99216                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         EXI Wireless Systems Inc.                    
+1F0000-1F0FFF                 (base 16)                     EXI Wireless Systems Inc.                    
+                                                            #100-13551 Commerce Parkway                  
+                                                            Richmond  BC  V6V 2L1                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         EDC                                          
+1D9000-1D9FFF                 (base 16)                     EDC                                          
+                                                            Hansestr. 24                                 
+                                                            Muenster  NRW  48163                         
+                                                            GH                                           
+
+00-50-C2                      (hex)                         Metrotech                                    
+1E8000-1E8FFF                 (base 16)                     Metrotech                                    
+                                                            901-Ho, 21 Century City Building, 55-1 B     
+                                                            Busan  KyungNam  608-743                     
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Palm Solutions Group                         
+1C4000-1C4FFF                 (base 16)                     Palm Solutions Group                         
+                                                            400 N. McCarthy Blvd                         
+                                                            Milpitas  CA  95035-5112                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         International Test & Engineering Services Co.,Ltd.
+1BF000-1BFFFF                 (base 16)                     International Test & Engineering Services Co.,Ltd.
+                                                            800, Ichimiyake,                             
+                                                            Yasu-cho, Yasu-gun,  Shiga-ken,  520-2392    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         DTS, Inc.                                    
+1B6000-1B6FFF                 (base 16)                     DTS, Inc.                                    
+                                                            4920 Grisham Dr.                             
+                                                            Rowlett  TX  75093                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSP Group Inc.                               
+1B4000-1B4FFF                 (base 16)                     DSP Group Inc.                               
+                                                            937D Plum Grove rd.                          
+                                                            Shaumburg  IL  60173                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fleetwood Electronics Ltd                    
+19F000-19FFFF                 (base 16)                     Fleetwood Electronics Ltd                    
+                                                            The Irwin Centre                             
+                                                            Cambridge  Cambridgeshire  CB3 8AR           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Beckmann+Egle GmbH                           
+1AC000-1ACFFF                 (base 16)                     Beckmann+Egle GmbH                           
+                                                            Auf der Höhe 10                              
+                                                            Kernen-Rommelshausen  BaWü  71394            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SIGOS Systemintegration GmbH                 
+1B2000-1B2FFF                 (base 16)                     SIGOS Systemintegration GmbH                 
+                                                            Klingenhofstrasse 50d                        
+                                                            Nuernberg  Bayern  90411                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Netsynt Spa                                  
+196000-196FFF                 (base 16)                     Netsynt Spa                                  
+                                                            Via A. G. Resti, 53                          
+                                                            Roma    00143                                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         AZIO TECHNOLOGY CO.                          
+19A000-19AFFF                 (base 16)                     AZIO TECHNOLOGY CO.                          
+                                                            1F, 215-7, Poi-dong, Kangnam-Gu              
+                                                              Seoul  135-260                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Momentum Data Systems                        
+195000-195FFF                 (base 16)                     Momentum Data Systems                        
+                                                            17330 Brookhurst Street                      
+                                                            Fountain Valley  CA  92708                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         LaserBit Communications Corp.                
+193000-193FFF                 (base 16)                     LaserBit Communications Corp.                
+                                                            Kunigunda u. 45                              
+                                                            Budapest    1037                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         CC Systems AB                                
+189000-189FFF                 (base 16)                     CC Systems AB                                
+                                                            Box 83                                       
+                                                            Alfta    822 22                              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         MATSUI MFG CO.,LTD                           
+18F000-18FFFF                 (base 16)                     MATSUI MFG CO.,LTD                           
+                                                            2-19 Shodai-Tadika                           
+                                                            Hirakata-City  Osaka  573-1132               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         PotsTek, Inc                                 
+198000-198FFF                 (base 16)                     PotsTek, Inc                                 
+                                                            100 Saint Albans Dr.                         
+                                                            Raleigh  NC  27609-5872                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sei S.p.A.                                   
+175000-175FFF                 (base 16)                     Sei S.p.A.                                   
+                                                            Via Ruffilli, 1                              
+                                                            Curno  (Bergamo)  24035                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         DeMeTec GmbH                                 
+173000-173FFF                 (base 16)                     DeMeTec GmbH                                 
+                                                            Luetzelwiessen 5                             
+                                                            Langgoens    35428                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         H M Computing Limited                        
+184000-184FFF                 (base 16)                     H M Computing Limited                        
+                                                            Harmac House                                 
+                                                            Malvern  Worcestershire  WR14 1GP            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Cyan Technology Ltd                          
+187000-187FFF                 (base 16)                     Cyan Technology Ltd                          
+                                                            Unit 2, Buckingway Business Park             
+                                                            Swavesey  Cambridge  CB24 4UQ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Infineer Ltd.                                
+166000-166FFF                 (base 16)                     Infineer Ltd.                                
+                                                            Balloo Avenue                                
+                                                            Bangor    BT22 2SE                           
+                                                            IE                                           
+
+00-50-C2                      (hex)                         IPCAST                                       
+165000-165FFF                 (base 16)                     IPCAST                                       
+                                                            2F, Youngwon B/D, 305-11,                    
+                                                            Seoul    137-130                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Precision Filters, Inc.                      
+167000-167FFF                 (base 16)                     Precision Filters, Inc.                      
+                                                            240 Cherry Street                            
+                                                            Ithica  NY  14850                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Celite Systems, Inc.                         
+15E000-15EFFF                 (base 16)                     Celite Systems, Inc.                         
+                                                            7600B Capital of Texas Hwy. N.               
+                                                            Austin  TX  78731                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Microsoft                                    
+003000-003FFF                 (base 16)                     Microsoft                                    
+                                                            Bldg 32/2316                                 
+                                                            Redmond  WA  98052                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Nordson Corp.                                
+169000-169FFF                 (base 16)                     Nordson Corp.                                
+                                                            11475 Lakefield Dr.                          
+                                                            Daluth  GA  30097                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ticketmaster Corp                            
+063000-063FFF                 (base 16)                     Ticketmaster Corp                            
+                                                            8181 S. 48th St.                             
+                                                            Phoenix  AZ  85044                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Telephonics Corp.                            
+14F000-14FFFF                 (base 16)                     Telephonics Corp.                            
+                                                            815 Broad Hollow Road                        
+                                                            Farmingdale  NY  11735                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         HECUBA Elektronik                            
+14B000-14BFFF                 (base 16)                     HECUBA Elektronik                            
+                                                            Kranichweg 14                                
+                                                            St. Marien    A-4502                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         DYCEC, S.A.                                  
+14A000-14AFFF                 (base 16)                     DYCEC, S.A.                                  
+                                                            Torres Quevedo, 1-P.T.M.                     
+                                                            Tres Cantos  Madrid  28760                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         ITS, Inc.                                    
+140000-140FFF                 (base 16)                     ITS, Inc.                                    
+                                                            3109 Poplarwood Ct.                          
+                                                            Raleigh  NC  27604                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         RUNCOM                                       
+12E000-12EFFF                 (base 16)                     RUNCOM                                       
+                                                            2 Hachoma St. 75655                          
+                                                            Rishon Lezion                                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         TTPCom Ltd.                                  
+129000-129FFF                 (base 16)                     TTPCom Ltd.                                  
+                                                            Melbourn Science Park                        
+                                                            Royston, Herts SG8 6EE                       
+                                                            GB                                           
+
+00-50-C2                      (hex)                         XStore, Inc.                                 
+120000-120FFF                 (base 16)                     XStore, Inc.                                 
+                                                            1200 N. Federal Highway #200                 
+                                                            Boca Raton  FL  33432                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Perceptics Corp.                             
+10F000-10FFFF                 (base 16)                     Perceptics Corp.                             
+                                                            9737 Cogdill Road                            
+                                                            Knoxville  TN  37932                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Quest Innovations                            
+114000-114FFF                 (base 16)                     Quest Innovations                            
+                                                            Dr Sicco Mansholstraat 7                     
+                                                            Wieringerwerf                                
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Energy ICT                                   
+0FE000-0FEFFF                 (base 16)                     Energy ICT                                   
+                                                            Zandbergstraat 19                            
+                                                            8500 Kortrijk                                
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Balogh S.A.                                  
+108000-108FFF                 (base 16)                     Balogh S.A.                                  
+                                                            189, rue d'Aubervilliers                     
+                                                            CP97 75886 Paris cedex 18                    
+                                                            FR                                           
+
+00-50-C2                      (hex)                         MarekMicro GmbH                              
+10B000-10BFFF                 (base 16)                     MarekMicro GmbH                              
+                                                            Fuggerstrasse 9                              
+                                                            D-92224 Amberg                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GE Transportation Systems                    
+0FA000-0FAFFF                 (base 16)                     GE Transportation Systems                    
+                                                            2901 East Lake Road                          
+                                                            Erie  PA  16531                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Adescom Inc.                                 
+104000-104FFF                 (base 16)                     Adescom Inc.                                 
+                                                            256 Calvin Place                             
+                                                            Santa Cruz  CA  95060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kimmon Manufacturing Co., Ltd.               
+0FC000-0FCFFF                 (base 16)                     Kimmon Manufacturing Co., Ltd.               
+                                                            2-3-6 Mukogaoka, Bunkyo-Ku                   
+                                                            Tokyo 113-0023                               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+0EC000-0ECFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Koenigsberger Str. 2                         
+                                                            D-42277 Wuppertal                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Movaz Networks, Inc.                         
+0EF000-0EFFFF                 (base 16)                     Movaz Networks, Inc.                         
+                                                            One Technology Parkway South                 
+                                                            Norcross  GA  30092                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lanex S.A.                                   
+0E3000-0E3FFF                 (base 16)                     Lanex S.A.                                   
+                                                            Ceramiczna 8 Str.                            
+                                                            20-150 Lublin                                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Charlotte's Web Networks                     
+0D8000-0D8FFF                 (base 16)                     Charlotte's Web Networks                     
+                                                            PO Box 333                                   
+                                                            Industrial Park Yokneam 20600                
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Summit Avionics, Inc.                        
+0D7000-0D7FFF                 (base 16)                     Summit Avionics, Inc.                        
+                                                            2224 E. Enterprise Pkwy                      
+                                                            Twinsburg  OH  44087                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Motion Analysis Corp.                        
+0DA000-0DAFFF                 (base 16)                     Motion Analysis Corp.                        
+                                                            3617 Westwind Blvd.                          
+                                                            Santa Rosa  CA  95403                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Interisa Electronica, S.A.                   
+0DD000-0DDFFF                 (base 16)                     Interisa Electronica, S.A.                   
+                                                            Avda. de los Artesanos, 46                   
+                                                            Madrid                                       
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Inspiration Technology P/L                   
+0E1000-0E1FFF                 (base 16)                     Inspiration Technology P/L                   
+                                                            PO Box 165, Goodwood                         
+                                                            SA 5034                                      
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Infolink Software AG                         
+0BC000-0BCFFF                 (base 16)                     Infolink Software AG                         
+                                                            Bernstrasse 49                               
+                                                            CH-3018 Bern                                 
+                                                            CH                                           
+
+00-50-C2                      (hex)                         R F Micro Devices                            
+0B2000-0B2FFF                 (base 16)                     R F Micro Devices                            
+                                                            5500 Scotts Valley Dr., Suite 400            
+                                                            Scotts Valley  CA  95066                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         SMX Corporation                              
+0B3000-0B3FFF                 (base 16)                     SMX Corporation                              
+                                                            222 Gale Lane                                
+                                                            Kennett Square  PA  19348                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fastware.Net, LLC                            
+0AB000-0ABFFF                 (base 16)                     Fastware.Net, LLC                            
+                                                            7985 S. Bemis St.                            
+                                                            Littleton  CO  80120                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Log-In, Inc.                                 
+0AA000-0AAFFF                 (base 16)                     Log-In, Inc.                                 
+                                                            3419 N. Kennicott                            
+                                                            Arlington Heights  IL  60004                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Honeywell GNO                                
+0AC000-0ACFFF                 (base 16)                     Honeywell GNO                                
+                                                            13051 66th St. N                             
+                                                            Largo  FL  33773                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kaveri Networks                              
+0A8000-0A8FFF                 (base 16)                     Kaveri Networks                              
+                                                            600 East Diehl Rd.                           
+                                                            Naperville  Il  60563                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Arula Systems, Inc.                          
+0A6000-0A6FFF                 (base 16)                     Arula Systems, Inc.                          
+                                                            10670 N. Tantau Ave.                         
+                                                            Cupertino  CA  95014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         General Industries Argentina                 
+08F000-08FFFF                 (base 16)                     General Industries Argentina                 
+                                                            Herrera 1175                                 
+                                                            C1295 Abu Buenos Aires                       
+                                                            AR                                           
+
+00-50-C2                      (hex)                         IMV Invertomatic                             
+097000-097FFF                 (base 16)                     IMV Invertomatic                             
+                                                            via Cantonale                                
+                                                            CH-6595 Riazzino                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         StorLogic, Inc.                              
+091000-091FFF                 (base 16)                     StorLogic, Inc.                              
+                                                            100 Technology Park                          
+                                                            Lake Mary  FL  32746                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ZELPOS                                       
+09D000-09DFFF                 (base 16)                     ZELPOS                                       
+                                                            Rosickeho 25                                 
+                                                            77900 Olomouc                                
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Dunti Corporation                            
+07F000-07FFFF                 (base 16)                     Dunti Corporation                            
+                                                            3925 West Braker Lane                        
+                                                            Austin  TX  78759                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crossport Systems                            
+085000-085FFF                 (base 16)                     Crossport Systems                            
+                                                            10940 NE 33rd Place                          
+                                                            Bellevue  WA  98005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saco Smartvision Inc.                        
+077000-077FFF                 (base 16)                     Saco Smartvision Inc.                        
+                                                            7809 Trans Canada                            
+                                                            Montreal  Quebec  H4S 1L3                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Litton Guidance & Control Systems            
+076000-076FFF                 (base 16)                     Litton Guidance & Control Systems            
+                                                            5500 Canoga Ave                              
+                                                            Woodland Hills  CA  91367                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Edge Tech Co., Ltd.                          
+074000-074FFF                 (base 16)                     Edge Tech Co., Ltd.                          
+                                                            6th-F. Dae Rewing Techo Town-1, 327-24       
+                                                            Kasan-dong, Kumchon-gu  Seoul                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         RadioTel                                     
+07A000-07AFFF                 (base 16)                     RadioTel                                     
+                                                            17 Hatasiya St.                              
+                                                            Or Yehuda    60373                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Neuberger Gebaeudeautomation GmbH & Co.      
+072000-072FFF                 (base 16)                     Neuberger Gebaeudeautomation GmbH & Co.      
+                                                            Oberer Kaiserweg 6                           
+                                                            91541 Rothenburg o.d.T.                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DIVA Systems                                 
+05E000-05EFFF                 (base 16)                     DIVA Systems                                 
+                                                            800 Saginaw Drive                            
+                                                            Redwood City  CA  94063                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ignitus Communications, LLC                  
+05D000-05DFFF                 (base 16)                     Ignitus Communications, LLC                  
+                                                            43 Nagog Park                                
+                                                            Acton  MA  01720                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         B. R. Electronics                            
+047000-047FFF                 (base 16)                     B. R. Electronics                            
+                                                            PO Box 717                                   
+                                                            Pinegowrie 2123                              
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Nortel Networks PLC (UK)                     
+05C000-05CFFF                 (base 16)                     Nortel Networks PLC (UK)                     
+                                                            Harlow Labs                                  
+                                                            Harlow  Essex CM179NA                        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Optionexist Limited                          
+054000-054FFF                 (base 16)                     Optionexist Limited                          
+                                                            Nixon's Hall, 1 Chapel Road                  
+                                                            Cambridge CB3 7HP                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         JSR Ultrasonics                              
+051000-051FFF                 (base 16)                     JSR Ultrasonics                              
+                                                            3800 Monroe Ave.                             
+                                                            Pittsford  NY  14534                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Luma Corporation                             
+04F000-04FFFF                 (base 16)                     Luma Corporation                             
+                                                            311 Courthouse Road                          
+                                                            Princeton  WV  24740                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Radiometer Medical A/S                       
+05B000-05BFFF                 (base 16)                     Radiometer Medical A/S                       
+                                                            Akandevej 21                                 
+                                                            DK 2700 Bronshoj                             
+                                                            DK                                           
+
+00-50-C2                      (hex)                         New Standard Engineering NV                  
+04C000-04CFFF                 (base 16)                     New Standard Engineering NV                  
+                                                            Inter Leu Ven Laan 3                         
+                                                            3001 Leuven                                  
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Apex Signal Corp                             
+039000-039FFF                 (base 16)                     Apex Signal Corp                             
+                                                            3285 Vets Memorial Highway                   
+                                                            Ronkonkoma  NY  11779                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Eloquence Ltd                                
+031000-031FFF                 (base 16)                     Eloquence Ltd                                
+                                                            Unit 4, Progress Business Centre             
+                                                            Berkshire SL1 6DQ                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Innocor LTD                                  
+02D000-02DFFF                 (base 16)                     Innocor LTD                                  
+                                                            210 - 362 Terry Fox Drive                    
+                                                            Kanata  Ontario  K2K 2P5                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         DRS Technologies Canada Co.                  
+021000-021FFF                 (base 16)                     DRS Technologies Canada Co.                  
+                                                            115 Emily Place                              
+                                                            Ontario    K7C 4J5                           
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Icon Research Ltd.                           
+020000-020FFF                 (base 16)                     Icon Research Ltd.                           
+                                                            3 Raw Holdings                               
+                                                                EH53 0HY                                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Wartsila Voyage Limited                      
+DD6000-DD6FFF                 (base 16)                     Wartsila Voyage Limited                      
+                                                            13-18 City Quay                              
+                                                            Dublin 2    D02 ED70                         
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Mettler Toledo                               
+EA9000-EA9FFF                 (base 16)                     Mettler Toledo                               
+                                                            1571 Northpointe Parkway                     
+                                                            Lutz  FL  33558                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         Owl Cyber Defense Solutions, LLC             
+1D8000-1D8FFF                 (base 16)                     Owl Cyber Defense Solutions, LLC             
+                                                            38A Grove Street                             
+                                                            Ridgefield  CT  06877                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB Power Grids Germany AG – Grid Automation 
+3F3000-3F3FFF                 (base 16)                     ABB Power Grids Germany AG – Grid Automation 
+                                                            Kallstadter Strasse 1                        
+                                                            Mannheim    68309                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DEUTA-WERKE GmbH                             
+CB3000-CB3FFF                 (base 16)                     DEUTA-WERKE GmbH                             
+                                                            Paffrather Str. 140                          
+                                                            Bergisch Gladbach  Northrhine Westfalia  51465
+                                                            DE                                           
+
+00-50-C2                      (hex)                         INTERNET PROTOCOLO LOGICA SL                 
+DE0000-DE0FFF                 (base 16)                     INTERNET PROTOCOLO LOGICA SL                 
+                                                            Sector Foresta 43. Edificio Oficentro        
+                                                            Tres Cantos  Madrid  28760                   
+                                                            ES                                           
+
+40-D8-55                      (hex)                         INTERNET PROTOCOLO LOGICA SL                 
+076000-076FFF                 (base 16)                     INTERNET PROTOCOLO LOGICA SL                 
+                                                            Sector Foresta 43. local 26                  
+                                                            Tres Cantos  Madrid  28760                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         WoKa-Elektronik GmbH                         
+9EF000-9EFFFF                 (base 16)                     WoKa-Elektronik GmbH                         
+                                                            Zeller-Str.7                                 
+                                                            Romrod  Hessen  36329                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Honeywell                                    
+53E000-53EFFF                 (base 16)                     Honeywell                                    
+                                                            13350 us hwy 19 n                            
+                                                            clearwater    33764                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Algodue Elettronica Srl                      
+204000-204FFF                 (base 16)                     Algodue Elettronica Srl                      
+                                                            Via Passerina 3                              
+                                                            Fontaneto d'Agogna  Novara  28010            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Communication Systems Solutions              
+D3F000-D3FFFF                 (base 16)                     Communication Systems Solutions              
+                                                            6030 S 58th St, STE C                        
+                                                            Lincoln  NE  68516                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         APG Cash Drawer, LLC                         
+0C3000-0C3FFF                 (base 16)                     APG Cash Drawer, LLC                         
+                                                            5250 INDUSTRIAL BLVD NE                      
+                                                            MINNEAPOLIS    55421                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         NanShanBridge Co.Ltd                         
+404000-404FFF                 (base 16)                     NanShanBridge Co.Ltd                         
+                                                            C241, National Hi-Tech(westzone)             
+                                                            ChengDu  SiChuan  611731                     
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ARGUS-SPECTRUM                               
+FB6000-FB6FFF                 (base 16)                     ARGUS-SPECTRUM                               
+                                                            Serdobolskaya street 65A                     
+                                                            St.Petersburg    197342                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         YUYAMA MFG Co.,Ltd                           
+39B000-39BFFF                 (base 16)                     YUYAMA MFG Co.,Ltd                           
+                                                            3-3-1                                        
+                                                            TOYONAKASHI  OSAKA  561-0841                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Analytica GmbH                               
+3CB000-3CBFFF                 (base 16)                     Analytica GmbH                               
+                                                            Vorholzstraße 36                             
+                                                            Karlsruhe  Baden-Württemberg  76137          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kontron (BeiJing) Technology Co.,Ltd         
+5B6000-5B6FFF                 (base 16)                     Kontron (BeiJing) Technology Co.,Ltd         
+                                                            5F,NO5,Haiying Road, Fengtai Science Park    
+                                                            Beijing    100070                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         DiTEST Fahrzeugdiagnose GmbH                 
+FF1000-FF1FFF                 (base 16)                     DiTEST Fahrzeugdiagnose GmbH                 
+                                                            ALTE POSTSTRASSE 152                         
+                                                            GRAZ  STEIERMARK  8020                       
+                                                            AT                                           
+
+40-D8-55                      (hex)                         ENTEC Electric & Electronic CO., LTD.        
+020000-020FFF                 (base 16)                     ENTEC Electric & Electronic CO., LTD.        
+                                                            225-38 Choirubaekro, Bongdam-eup             
+                                                            Hwaseong-city  Gyeonggi-do  445-894          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Baudisch Electronic GmbH                     
+E3D000-E3DFFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7-9                         
+                                                            Wäschenbeuren  Baden-Württemberg  73116      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ariem Technologies Pvt Ltd                   
+BD1000-BD1FFF                 (base 16)                     Ariem Technologies Pvt Ltd                   
+                                                            201/202, Trump Towers                        
+                                                            Bangalore  Karnataka  560025                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         kippdata GmbH                                
+44F000-44FFFF                 (base 16)                     kippdata GmbH                                
+                                                            Bornheimer Str. 33a                          
+                                                            Bonn  NRW  D-53111                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Silverbrook Research                         
+65B000-65BFFF                 (base 16)                     Silverbrook Research                         
+                                                            393 Darling St                               
+                                                            Balmain  NSW  2041                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Optical Air Data Systems                     
+39A000-39AFFF                 (base 16)                     Optical Air Data Systems                     
+                                                            10531 Terminal road                          
+                                                            Manassas  VA  20110                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SPEECH TECHNOLOGY CENTER LIMITED             
+63F000-63FFFF                 (base 16)                     SPEECH TECHNOLOGY CENTER LIMITED             
+                                                            4 Krasutskogo st.                            
+                                                            St.Petersburg    196084                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+782000-782FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+392000-392FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Strasse 39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+32A000-32AFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße  39                       
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MedAvant Healthcare                          
+3E9000-3E9FFF                 (base 16)                     MedAvant Healthcare                          
+                                                            2533 Centennial Blvd                         
+                                                            Jeffersonville  IN  47150                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cominfo, Inc.                                
+77E000-77EFFF                 (base 16)                     Cominfo, Inc.                                
+                                                            Nabrezi 695                                  
+                                                            Zlin  Czech Republic  76001                  
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         HCJB Global                                  
+604000-604FFF                 (base 16)                     HCJB Global                                  
+                                                            2830 South 17th St.                          
+                                                            Elkhart  IN  46517-4008                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Chrisso Technologies LLC                     
+F64000-F64FFF                 (base 16)                     Chrisso Technologies LLC                     
+                                                            700 E Firmin Street                          
+                                                            Kokomo  Indiana  46902                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         AIRWISE TECHNOLOGY CO., LTD.                 
+50C000-50CFFF                 (base 16)                     AIRWISE TECHNOLOGY CO., LTD.                 
+                                                            21 Fl-3, No. 107, Sec. Jhongshan Road        
+                                                            Sinjhuang City  Taipei County  24250         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Gogo BA                                      
+455000-455FFF                 (base 16)                     Gogo BA                                      
+                                                            1172 Century Drive                           
+                                                            Louisville    80027                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computerwise, Inc.                           
+163000-163FFF                 (base 16)                     Computerwise, Inc.                           
+                                                            302 N. Winchester                            
+                                                            Olathe  KS  66062                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elisra                                       
+909000-909FFF                 (base 16)                     Elisra                                       
+                                                            48, Mivtza Kadesh                            
+                                                            Bene Beraq    51203                          
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Potter Electric Signal Co. LLC               
+DF4000-DF4FFF                 (base 16)                     Potter Electric Signal Co. LLC               
+                                                            1609 Park 370 Place                          
+                                                            Hazelwood    63042                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         DAVE SRL                                     
+B9C000-B9CFFF                 (base 16)                     DAVE SRL                                     
+                                                            Via  Talponedo 29                            
+                                                            Porcia  PN  A-33080                          
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Vtron Pty Ltd                                
+F3E000-F3EFFF                 (base 16)                     Vtron Pty Ltd                                
+                                                            Unit 2, 62 Township Drive West               
+                                                            West Burleigh  Queensland  4219              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         LECO Corporation                             
+2F0000-2F0FFF                 (base 16)                     LECO Corporation                             
+                                                            3000 Lakeview Ave., CC1                      
+                                                            St. Joseph  MI  49085                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xslent Energy Technologies. LLC              
+BC2000-BC2FFF                 (base 16)                     Xslent Energy Technologies. LLC              
+                                                            7428 Redwood Blvd Suite 102                  
+                                                            Novato  CA  94945                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         dresden-elektronik                           
+188000-188FFF                 (base 16)                     dresden-elektronik                           
+                                                            Glasewaldtstraße 22                          
+                                                            Dresden    D-01277                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Vocality International Ltd                   
+D9E000-D9EFFF                 (base 16)                     Vocality International Ltd                   
+                                                            Lydling Barn                                 
+                                                            Guildford  Surrey  GU86AP                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         EATON FHF Funke + Huster Fernsig GmbH        
+6A5000-6A5FFF                 (base 16)                     EATON FHF Funke + Huster Fernsig GmbH        
+                                                            Gewerbeallee 15-19                           
+                                                            Mülheim an der Ruhr  NRW  D-45478            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+66A000-66AFFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park                          
+                                                            Xiamen  Fujian  361005                       
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+7A3000-7A3FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+B92000-B92FFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+CDC000-CDCFFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Industrial Development Zone
+                                                            Xiamen   Fujian  361006                      
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+EEE000-EEEFFF                 (base 16)                     ABB Transmission and Distribution Automation Equipment (Xiamen) Co., Ltd.
+                                                            ABB Industrial Park, Torch Hi-Tech Development Zone.
+                                                            Xiamen  Fujian  361006                       
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Guangdong East Power Co.,                    
+F8D000-F8DFFF                 (base 16)                     Guangdong East Power Co.,                    
+                                                            No 6 Northern Industry Road,Songshan lake SCI&TECH Industry Park
+                                                            DongGuan  GuangDong  P.R.China 523808        
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+E4B000-E4BFFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+F52000-F52FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Rohde&Schwarz Topex SA                       
+FC0000-FC0FFF                 (base 16)                     Rohde&Schwarz Topex SA                       
+                                                            71th-73th Nicolae Caramfil street, 2nd floor, 1th district
+                                                            Bucuresti  Romania  014142                   
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Alfred Kuhse GmbH                            
+8FB000-8FBFFF                 (base 16)                     Alfred Kuhse GmbH                            
+                                                            An der Kleinbahn 39                          
+                                                            Winsen (Luhe)  Niedersachsen  21423          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Pixel Velocity, Inc                          
+594000-594FFF                 (base 16)                     Pixel Velocity, Inc                          
+                                                            3917 Research Park Drive                     
+                                                            Ann Arbor  MI  48108                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pantec Engineering AG                        
+186000-186FFF                 (base 16)                     Pantec Engineering AG                        
+                                                            Industriezone                                
+                                                            Mauren  Liechtenstein  9493                  
+                                                            LI                                           
+
+00-50-C2                      (hex)                         Pounce Consulting                            
+FB7000-FB7FFF                 (base 16)                     Pounce Consulting                            
+                                                            Av 8 de Julio 1295                           
+                                                            Guadalajara   Jalisco  44190                 
+                                                            MX                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+1DC000-1DCFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+16A000-16AFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Aplex Technology Inc.                        
+147000-147FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+F6F000-F6FFFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+EC3000-EC3FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Aplex Technology Inc.                        
+D11000-D11FFF                 (base 16)                     Aplex Technology Inc.                        
+                                                            2Q , NanYouTianAn industrial park Tower4 ,Nanshan District
+                                                            Shenzhen  Guangdong  518054                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         ART SPA                                      
+85A000-85AFFF                 (base 16)                     ART SPA                                      
+                                                            Voc.Pischiello                               
+                                                            20 06065 Passignano sul Trasimeno (PG)    00000
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Wireless Cables Inc.                         
+585000-585FFF                 (base 16)                     Wireless Cables Inc.                         
+                                                            1414 Soquel Ave, Ste 212                     
+                                                            Santa Cruz  CA  95062                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Power Electronics Espana, S.L.               
+723000-723FFF                 (base 16)                     Power Electronics Espana, S.L.               
+                                                            C/ Leonardo Da Vinci, 24-26                  
+                                                            Paterna  Valencia  46980                     
+                                                            ES                                           
+
+00-50-C2                      (hex)                         WaveIP                                       
+4F7000-4F7FFF                 (base 16)                     WaveIP                                       
+                                                            Teradion Industrial Park                     
+                                                            Misgav    20179                              
+                                                            IL                                           
+
+00-50-C2                      (hex)                         WaveIP                                       
+AC7000-AC7FFF                 (base 16)                     WaveIP                                       
+                                                            Teradion Ind Park                            
+                                                            Misgav  Israel  20692                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+ADD000-ADDFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 East Rooseevelt St.                     
+                                                            Scottsdale    85157-3812                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Polytron Corporation                         
+B19000-B19FFF                 (base 16)                     Polytron Corporation                         
+                                                            4400 Wyland Dr,                              
+                                                            Elkhart  IN  46516                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Explorer Inc.                                
+A6B000-A6BFFF                 (base 16)                     Explorer Inc.                                
+                                                            379-22 kikyou-cho                            
+                                                            Hakodate  Hokkaido  041-0801                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         TECHNOMARK                                   
+807000-807FFF                 (base 16)                     TECHNOMARK                                   
+                                                            Parc  d'activités STELYTEC                   
+                                                            Saint-Chamond  RA  F-42400                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Applied Medical Technologies, Inc DBA AirClean Systems
+D19000-D19FFF                 (base 16)                     Applied Medical Technologies, Inc DBA AirClean Systems
+                                                            3248 Lake Woodard Dr.                        
+                                                            Raleigh  NC  27604                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+52B000-52BFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SYS TEC electronic GmbH                      
+393000-393FFF                 (base 16)                     SYS TEC electronic GmbH                      
+                                                            Am Windrad 2                                 
+                                                            Heinsdorfergrund     D-08468                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Envara                                       
+23B000-23BFFF                 (base 16)                     Envara                                       
+                                                            3 Ha'Tidhar St.                              
+                                                            Raanana    43000                             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         LEROY AUTOMATION                             
+015000-015FFF                 (base 16)                     LEROY AUTOMATION                             
+                                                            Boulevard du Libre - Echange                 
+                                                            ccc    00000                                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Kramer Electronics Ltd.                      
+359000-359FFF                 (base 16)                     Kramer Electronics Ltd.                      
+                                                            3 Am VeOlamo St.                             
+                                                            Jerusalem    95463                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+C3A000-C3AFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Sicon srl                                    
+D8B000-D8BFFF                 (base 16)                     Sicon srl                                    
+                                                            Via Sila 1/3                                 
+                                                            Isola Vicentina  Vicenza  36033              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Itibia Technologies                          
+77B000-77BFFF                 (base 16)                     Itibia Technologies                          
+                                                            100 Menlo Park, Suite 212                    
+                                                            Edison  NJ  08837                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Eaton Corp. Electrical Group Data Center Solutions - Pulizzi
+5AB000-5ABFFF                 (base 16)                     Eaton Corp. Electrical Group Data Center Solutions - Pulizzi
+                                                            3200 S. Susan Street                         
+                                                            Santa Ana    92704                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Harman/Becker Automotive Systems GmbH        
+620000-620FFF                 (base 16)                     Harman/Becker Automotive Systems GmbH        
+                                                            Becker-Göring-Straße 16                      
+                                                            Karlsbad    76307                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Embedded Solution Bank Co., Ltd.             
+D5F000-D5FFFF                 (base 16)                     Embedded Solution Bank Co., Ltd.             
+                                                            #905 A, Woolim Lions Valley, 144-3           
+                                                            Seongnam-Si  Kyungi-Do  462-120              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Elettronica Santerno SpA                     
+44A000-44AFFF                 (base 16)                     Elettronica Santerno SpA                     
+                                                            S. SELICE, 47                                
+                                                            IMOLA  BOLOGNA  40026                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         BAYCOM OPTO-ELECTRONICS TECHNOLGY CO., LTD.  
+F53000-F53FFF                 (base 16)                     BAYCOM OPTO-ELECTRONICS TECHNOLGY CO., LTD.  
+                                                            1F,NO.9, INDUSTRIAL EAST 9th RD.,            
+                                                            HSINCHU  TAIWAN  30075                       
+                                                            TW                                           
+
+00-50-C2                      (hex)                         DELTA TAU DATA SYSTEMS, INC.                 
+4D7000-4D7FFF                 (base 16)                     DELTA TAU DATA SYSTEMS, INC.                 
+                                                            21314 Lassen St                              
+                                                            Chatsworth  CA  91311                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Doble Engineering                            
+033000-033FFF                 (base 16)                     Doble Engineering                            
+                                                            85 Walnut St                                 
+                                                            Watertown  MA  02472                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Grossenbacher Systeme AG                     
+029000-029FFF                 (base 16)                     Grossenbacher Systeme AG                     
+                                                            Spinnereistrasse 40                          
+                                                            St Gallan    12345                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Grossenbacher Systeme AG                     
+A62000-A62FFF                 (base 16)                     Grossenbacher Systeme AG                     
+                                                            Spinnereistrasse 10                          
+                                                            St. Gallen    9008                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Grossenbacher Systeme AG                     
+F1D000-F1DFFF                 (base 16)                     Grossenbacher Systeme AG                     
+                                                            Spinnereistrasse 10                          
+                                                            St. Gallen    9008                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Altierre                                     
+C0C000-C0CFFF                 (base 16)                     Altierre                                     
+                                                            1980 Concourse Drive                         
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+066000-066FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Artis GmbH                                   
+493000-493FFF                 (base 16)                     Artis GmbH                                   
+                                                            Buchenring 40                                
+                                                            Egestorf    21272                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         beroNet GmbH                                 
+83D000-83DFFF                 (base 16)                     beroNet GmbH                                 
+                                                            Friedrichstr. 231                            
+                                                            Berlin    10969                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+F35000-F35FFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Grupo Epelsa S.L.                            
+E3C000-E3CFFF                 (base 16)                     Grupo Epelsa S.L.                            
+                                                            C/ Albasanz, 6 y 8                           
+                                                            Madrid    28037                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         TATTILE SRL                                  
+8C7000-8C7FFF                 (base 16)                     TATTILE SRL                                  
+                                                            via G.Donizetti 1/3/5                        
+                                                            Brescia    25030                             
+                                                            IT                                           
+
+40-D8-55                      (hex)                         EMAC, Inc.                                   
+19D000-19DFFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62901                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         TOPROOTTechnology Corp. Ltd.                 
+CC7000-CC7FFF                 (base 16)                     TOPROOTTechnology Corp. Ltd.                 
+                                                            10F , No. 192, Sec. 3, Datong Rd., Sijhih City, , 
+                                                            Taipei     221                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Securiton AG                                 
+4CD000-4CDFFF                 (base 16)                     Securiton AG                                 
+                                                            Alpenstrasse 20, P.O. Box 127                
+                                                            Zollikofen    CH-3052                        
+                                                            CH                                           
+
+40-D8-55                      (hex)                         STEK Ltd                                     
+1E4000-1E4FFF                 (base 16)                     STEK Ltd                                     
+                                                            Metallistov pr. 23-4-10                      
+                                                            Saint-Petersburg  -  195176                  
+                                                            RU                                           
+
+40-D8-55                      (hex)                         InventLab s.c.                               
+1D2000-1D2FFF                 (base 16)                     InventLab s.c.                               
+                                                            ul. Czarodziejska 22                         
+                                                            Wolka Kozodawska  Masovian  05-502           
+                                                            PL                                           
+
+40-D8-55                      (hex)                         YXLON International A/S                      
+1CD000-1CDFFF                 (base 16)                     YXLON International A/S                      
+                                                            Helgeshoej Alle 38                           
+                                                            Taastrup    2630                             
+                                                            DK                                           
+
+40-D8-55                      (hex)                         Andy-L Ltd.                                  
+1C9000-1C9FFF                 (base 16)                     Andy-L Ltd.                                  
+                                                            16B Karlovsko Shosse Str.                    
+                                                            Plovdiv  Plovdiv  4003                       
+                                                            BG                                           
+
+40-D8-55                      (hex)                         Wexiodisk AB                                 
+1C7000-1C7FFF                 (base 16)                     Wexiodisk AB                                 
+                                                            Mardvagen 4                                  
+                                                            Vaxjo  Kronoberg  352 45                     
+                                                            SE                                           
+
+40-D8-55                      (hex)                         Micromega Dynamics SA                        
+1BB000-1BBFFF                 (base 16)                     Micromega Dynamics SA                        
+                                                            10 rue du Trou du Sart                       
+                                                            FERNELMONT  Namur  B-5380                    
+                                                            BE                                           
+
+40-D8-55                      (hex)                         Cornfed Systems LLC                          
+1C3000-1C3FFF                 (base 16)                     Cornfed Systems LLC                          
+                                                            3476 Dayton Street                           
+                                                            Denver  CO  80238                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Digital Display Systems                      
+1C2000-1C2FFF                 (base 16)                     Digital Display Systems                      
+                                                            780 Montague expy. Suite 502                 
+                                                            San Jose  California  95131                  
+                                                            US                                           
+
+40-D8-55                      (hex)                         A+EC Klein Ingenieurbuero                    
+1B5000-1B5FFF                 (base 16)                     A+EC Klein Ingenieurbuero                    
+                                                            Eppsteiner Strasse 13                        
+                                                            Eppstein  Hessen  65817                      
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Sensata Technologies                         
+1C8000-1C8FFF                 (base 16)                     Sensata Technologies                         
+                                                            4467 White Bear Parkway                      
+                                                            St. Paul  Minnesota  55110                   
+                                                            US                                           
+
+40-D8-55                      (hex)                         shanghai mingding information tech co.Ltd    
+1BF000-1BFFFF                 (base 16)                     shanghai mingding information tech co.Ltd    
+                                                            Room 304 building 3, No 439 Jinglian road,   
+                                                            Shanghai    201018                           
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Peek Traffic                                 
+1BE000-1BEFFF                 (base 16)                     Peek Traffic                                 
+                                                            2906 Corporate Way                           
+                                                            Palmetto  FL  34235                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Lubino s.r.o.                                
+1A9000-1A9FFF                 (base 16)                     Lubino s.r.o.                                
+                                                            Podnikatelska 553                            
+                                                            Praha 9 - Bechovice  Czech Republic  190 11  
+                                                            CZ                                           
+
+40-D8-55                      (hex)                          GD Mission Systems                          
+192000-192FFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Kiwigrid GmbH                                
+17D000-17DFFF                 (base 16)                     Kiwigrid GmbH                                
+                                                            Kleiststrasse 10c                            
+                                                            Dresden  Sachsen  01129                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         BroadSoft Inc                                
+180000-180FFF                 (base 16)                     BroadSoft Inc                                
+                                                            550 S Winchester Blvd                        
+                                                            San Jose  CA  95128                          
+                                                            US                                           
+
+40-D8-55                      (hex)                         Advanced Micro Controls Inc.                 
+196000-196FFF                 (base 16)                     Advanced Micro Controls Inc.                 
+                                                            20 Gear Dr.                                  
+                                                            Terryville  CT  06786                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Berg Cloud Limited                           
+197000-197FFF                 (base 16)                     Berg Cloud Limited                           
+                                                            Epworth House                                
+                                                              London  EC1Y 1AA                           
+                                                            GB                                           
+
+40-D8-55                      (hex)                         CDEX Corp.                                   
+187000-187FFF                 (base 16)                     CDEX Corp.                                   
+                                                            Pastoral Heim Inagi Bldg. 2F                 
+                                                            Inagi  Tokyo  206-0804                       
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Zoe Medical                                  
+18D000-18DFFF                 (base 16)                     Zoe Medical                                  
+                                                            460 Boston Street                            
+                                                            Topsfield  Massachusetts  01983              
+                                                            US                                           
+
+40-D8-55                      (hex)                         EOS S.r.l.                                   
+18C000-18CFFF                 (base 16)                     EOS S.r.l.                                   
+                                                            Via Monte Aquila 2                           
+                                                              Parma  43124                               
+                                                            IT                                           
+
+40-D8-55                      (hex)                         TONNA ELECTRONIQUE                           
+195000-195FFF                 (base 16)                     TONNA ELECTRONIQUE                           
+                                                            36 Avenue Hoche                              
+                                                            REIMS  Champagne-Ardenne  51100              
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Private                                      
+16C000-16CFFF                 (base 16)                     Private                                      
+
+40-D8-55                      (hex)                         Schneider Electric Motion, Inc. USA          
+176000-176FFF                 (base 16)                     Schneider Electric Motion, Inc. USA          
+                                                            370 N. Main St.                              
+                                                            Marlborough  CT  06447                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         EcoGuard AB                                  
+174000-174FFF                 (base 16)                     EcoGuard AB                                  
+                                                            Radiatorvägen 11                            
+                                                            ÖREBRO  -  70227                            
+                                                            SE                                           
+
+40-D8-55                      (hex)                         SHIKINO HIGH-TECH                            
+150000-150FFF                 (base 16)                     SHIKINO HIGH-TECH                            
+                                                            Shibakoen Denki Bldg, 9F                     
+                                                            Minato-ku  Tokyo  1050011                    
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Engage Technologies                          
+149000-149FFF                 (base 16)                     Engage Technologies                          
+                                                            7041 Boone Ave. N                            
+                                                            Brooklyn Park  MN  55428                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         Emphysys, Inc.                               
+156000-156FFF                 (base 16)                     Emphysys, Inc.                               
+                                                            2X Gill Street                               
+                                                            Woburn  MA  01801                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Jadpod Communication Company Limited         
+12A000-12AFFF                 (base 16)                     Jadpod Communication Company Limited         
+                                                            Buidling B2, Xujingchang Industrial Park, Haoye Road
+                                                            Shenzhen  Guangdong  518000                  
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Canfield Scientific, Inc.                    
+12E000-12EFFF                 (base 16)                     Canfield Scientific, Inc.                    
+                                                            253 Passaic Avenue                           
+                                                            Fairfield  NJ  07004                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Davin Technologies Co.,Ltd                   
+13B000-13BFFF                 (base 16)                     Davin Technologies Co.,Ltd                   
+                                                            1203-Ho, World Merdiang 1 Cha                
+                                                            Seoul  Seoul  153-781                        
+                                                            KR                                           
+
+40-D8-55                      (hex)                         Supplier Ind. e Com de Eletroeletrônicos     
+13A000-13AFFF                 (base 16)                     Supplier Ind. e Com de Eletroeletrônicos     
+                                                            Av. Edgar Nelson Meister, 1242, Bloco i Sala 402
+                                                            Joinville  Santa Catarina  89219501          
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Calon Associates Limited                     
+138000-138FFF                 (base 16)                     Calon Associates Limited                     
+                                                            2 Whitworth Court                            
+                                                            Runcorn  Cheshire  WA7 1WA                   
+                                                            GB                                           
+
+40-D8-55                      (hex)                         HKS-Prozesstechnik GmbH                      
+10E000-10EFFF                 (base 16)                     HKS-Prozesstechnik GmbH                      
+                                                            Heinrich-Damerow-Str. 2                      
+                                                            Halle  Sachsen-Anhalt  06120                 
+                                                            DE                                           
+
+40-D8-55                      (hex)                         Tieline Research Pty Ltd                     
+105000-105FFF                 (base 16)                     Tieline Research Pty Ltd                     
+                                                            PO Box 2092                                  
+                                                            Malaga  Western Australia  6944              
+                                                            AU                                           
+
+40-D8-55                      (hex)                         Cytech Technology Pte Ltd                    
+0FE000-0FEFFF                 (base 16)                     Cytech Technology Pte Ltd                    
+                                                            55 Ubi Avenue 1 #07-04                       
+                                                            Singapore    408935                          
+                                                            SG                                           
+
+40-D8-55                      (hex)                         DAVIS DERBY LIMITED                          
+10A000-10AFFF                 (base 16)                     DAVIS DERBY LIMITED                          
+                                                            Chequers Lane                                
+                                                            Derby  Derby  DE21 6AW                       
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Orbital A/S                                  
+106000-106FFF                 (base 16)                     Orbital A/S                                  
+                                                            Trykkerivej 5                                
+                                                            Skjern    6900                               
+                                                            DK                                           
+
+40-D8-55                      (hex)                         University of Nebraska -- Lincoln            
+118000-118FFF                 (base 16)                     University of Nebraska -- Lincoln            
+                                                            208 Jorgensen Hall                           
+                                                            Lincoln  NE  68588-0299                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         MESA Electronic GmbH                         
+115000-115FFF                 (base 16)                     MESA Electronic GmbH                         
+                                                            Leitenstr. 26                                
+                                                            Geretsried    82538                          
+                                                            DE                                           
+
+40-D8-55                      (hex)                         CEMSI, Inc.                                  
+11E000-11EFFF                 (base 16)                     CEMSI, Inc.                                  
+                                                            780 Keezletown Road                          
+                                                            Weyers Cave  VA  24486                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         ACD Elektronik GmbH                          
+11D000-11DFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+40-D8-55                      (hex)                         SigmaPhi Electronics                         
+0F2000-0F2FFF                 (base 16)                     SigmaPhi Electronics                         
+                                                            34 rue de l’Industrie                        
+                                                            WISSEMBOURG  ALSACE  67160                   
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Richter                                      
+0E0000-0E0FFF                 (base 16)                     Richter                                      
+                                                            Griesborner Str. 13                          
+                                                              Sarland  66806                             
+                                                            DE                                           
+
+40-D8-55                      (hex)                         InfoMac Sp. z o. o. Sp. k.                   
+0FB000-0FBFFF                 (base 16)                     InfoMac Sp. z o. o. Sp. k.                   
+                                                            ul Wojska Polskiego 6                        
+                                                            Szczecinek  Zachodniopomorskie  78-400       
+                                                            PL                                           
+
+40-D8-55                      (hex)                         Redwood Systems                              
+0F0000-0F0FFF                 (base 16)                     Redwood Systems                              
+                                                            3839 Spinnaker Ct.                           
+                                                            Fremont  CA  94538                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         ATEME                                        
+0CC000-0CCFFF                 (base 16)                     ATEME                                        
+                                                            26 Burospace                                 
+                                                            Bievres    91570                             
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Shimizu Electric Co., Ltd.                   
+0D5000-0D5FFF                 (base 16)                     Shimizu Electric Co., Ltd.                   
+                                                            Nakayabe-cho 10-10 Shimizu-ku                
+                                                            Shizuoka-shi  Shizuoka-ken  424-0854         
+                                                            JP                                           
+
+40-D8-55                      (hex)                         NEUTRIK AG                                   
+0CA000-0CAFFF                 (base 16)                     NEUTRIK AG                                   
+                                                            Im Alten Riet 143                            
+                                                            SCHAAN    9494                               
+                                                            LI                                           
+
+40-D8-55                      (hex)                         Devialet SA                                  
+0DA000-0DAFFF                 (base 16)                     Devialet SA                                  
+                                                            126 rue Réaumur                              
+                                                            Paris    75002                               
+                                                            FR                                           
+
+40-D8-55                      (hex)                         Enel doo Belgrade                            
+0AB000-0ABFFF                 (base 16)                     Enel doo Belgrade                            
+                                                            Petrovaradinska no. 26, 11000 Belgrade, Serbia
+                                                            Belgrade  Serbia  11000                      
+                                                            RS                                           
+
+40-D8-55                      (hex)                         comtime GmbH                                 
+0C6000-0C6FFF                 (base 16)                     comtime GmbH                                 
+                                                            Gutenbergring 22                             
+                                                            Norderstedt    22848                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         WxBR Sistemas de Telecomunicacoes Ltda       
+0B9000-0B9FFF                 (base 16)                     WxBR Sistemas de Telecomunicacoes Ltda       
+                                                            Rua Dr Ricardo Benetton Martins, S/N         
+                                                            Campinas  São Paulo  13086902                
+                                                            BR                                           
+
+40-D8-55                      (hex)                         Nomad Digital Limited                        
+094000-094FFF                 (base 16)                     Nomad Digital Limited                        
+                                                            3 Broad Chare                                
+                                                            Newcastle  Tye & Wear  NE1 3DQ               
+                                                            GB                                           
+
+40-D8-55                      (hex)                         Burton Technical Services LLC                
+097000-097FFF                 (base 16)                     Burton Technical Services LLC                
+                                                            1214 Metro Park Blvd                         
+                                                            Lewisville  Texas  75057                     
+                                                            US                                           
+
+40-D8-55                      (hex)                         Apantac LLC                                  
+0A9000-0A9FFF                 (base 16)                     Apantac LLC                                  
+                                                            7556 SW Bridgeport Road                      
+                                                            Durham  OR  97224                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Xemex NV                                     
+0A2000-0A2FFF                 (base 16)                     Xemex NV                                     
+                                                            Metropoolstraat 11a                          
+                                                            Schoten  Antwerp  BE-2900                    
+                                                            BE                                           
+
+40-D8-55                      (hex)                         Boehme Nachrichtentechnik                    
+08D000-08DFFF                 (base 16)                     Boehme Nachrichtentechnik                    
+                                                            Hauptstrasse 32                              
+                                                            Siek  Schleswig-Holstein  22962              
+                                                            DE                                           
+
+40-D8-55                      (hex)                         JEL SYSTEM CO., LTD.                         
+088000-088FFF                 (base 16)                     JEL SYSTEM CO., LTD.                         
+                                                            14-1, IKENOIRIYAMA, FUMASE                   
+                                                            IZUMIZAKI-MURA, NISHISHIRAKAWA-GUN  FUKUSHIMA  969-0105
+                                                            JP                                           
+
+40-D8-55                      (hex)                         4embedded                                    
+07A000-07AFFF                 (base 16)                     4embedded                                    
+                                                            1679 N 850 W                                 
+                                                            Orem  UT  84057                              
+                                                            US                                           
+
+40-D8-55                      (hex)                         TOEC TECHNOLOGY CO.,LTD                      
+077000-077FFF                 (base 16)                     TOEC TECHNOLOGY CO.,LTD                      
+                                                            6 Taishan Road Hexi District                 
+                                                              Tianjin  300211                            
+                                                            CN                                           
+
+40-D8-55                      (hex)                         NACHI-FUJIKOSHI CORP                         
+078000-078FFF                 (base 16)                     NACHI-FUJIKOSHI CORP                         
+                                                            1-1-1 Fujikoshi honmachi                     
+                                                              Toyama  930-8511                           
+                                                            JP                                           
+
+40-D8-55                      (hex)                         Bestel China                                 
+087000-087FFF                 (base 16)                     Bestel China                                 
+                                                            GaoLiangQia 19th                             
+                                                              Beijing  100081                            
+                                                            CN                                           
+
+40-D8-55                      (hex)                         Data Flow Systems, Inc.                      
+05B000-05BFFF                 (base 16)                     Data Flow Systems, Inc.                      
+                                                            605 N. John Rodes Blvd.                      
+                                                            Melbourne  Fl  32934                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Parallel Wireless                            
+065000-065FFF                 (base 16)                     Parallel Wireless                            
+                                                            1 Tara Blvd                                  
+                                                            Nashua  NH  03062                            
+                                                            US                                           
+
+40-D8-55                      (hex)                         Sphere Medical Ltd                           
+074000-074FFF                 (base 16)                     Sphere Medical Ltd                           
+                                                            Harston Mill                                 
+                                                            Cambridge    CB22 7GG                        
+                                                            GB                                           
+
+40-D8-55                      (hex)                         UniSVR Global Information Technology Corp.   
+03F000-03FFFF                 (base 16)                     UniSVR Global Information Technology Corp.   
+                                                            3F., No.6, Gongye E. 3rd Rd., Hsinchu Science Park.
+                                                            Hsinchu    30075                             
+                                                            TW                                           
+
+40-D8-55                      (hex)                         Tekelek Europe Ltd                           
+03D000-03DFFF                 (base 16)                     Tekelek Europe Ltd                           
+                                                            Unit 118 Shannon Free zone                   
+                                                            Shannon  Co. Clare                           
+                                                            IE                                           
+
+40-D8-55                      (hex)                         Vishay Celtron Technologies, Inc.            
+03E000-03EFFF                 (base 16)                     Vishay Celtron Technologies, Inc.            
+                                                            8F, No. 171-1, Sec. 2, Datong Rd., Sijhih City,
+                                                            Taipei    22183                              
+                                                            TW                                           
+
+40-D8-55                      (hex)                         BETTINI SRL                                  
+032000-032FFF                 (base 16)                     BETTINI SRL                                  
+                                                            VIA GRIEG 23                                 
+                                                            SARONNO  VARESE  21047                       
+                                                            US                                           
+
+40-D8-55                      (hex)                         Tecnologias Plexus                           
+030000-030FFF                 (base 16)                     Tecnologias Plexus                           
+                                                            Rua Jose Villar Granjel, 22-24               
+                                                            Santiago de Compostela  A Coruna  15890      
+                                                            ES                                           
+
+40-D8-55                      (hex)                         Gateway Technologies SA de CV                
+04A000-04AFFF                 (base 16)                     Gateway Technologies SA de CV                
+                                                            40 North Central Ave, Suite 1400             
+                                                            Phoenix  Arizona  85004                      
+                                                            US                                           
+
+40-D8-55                      (hex)                         Dos&Donts SRL                                
+047000-047FFF                 (base 16)                     Dos&Donts SRL                                
+                                                            Via Italo Calvino,7                          
+                                                            Rho  Milano  20017                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         Software Workshop                            
+037000-037FFF                 (base 16)                     Software Workshop                            
+                                                            402B Steel Chambers                          
+                                                            Mumbai  Maharashtra  400009                  
+                                                            IN                                           
+
+40-D8-55                      (hex)                         Toni Studio                                  
+014000-014FFF                 (base 16)                     Toni Studio                                  
+                                                            2F., No.10, Aly. 4, Ln. 198                  
+                                                            New Taipei City    234                       
+                                                            TW                                           
+
+40-D8-55                      (hex)                         Integrated Control Corp.                     
+028000-028FFF                 (base 16)                     Integrated Control Corp.                     
+                                                            748 Park Ave                                 
+                                                            Huntington  NY  11743                        
+                                                            US                                           
+
+40-D8-55                      (hex)                         Rosemount Analytical                         
+025000-025FFF                 (base 16)                     Rosemount Analytical                         
+                                                            10241 West Little York                       
+                                                            Houston  TX  77040                           
+                                                            US                                           
+
+40-D8-55                      (hex)                         Monarch Instrument                           
+005000-005FFF                 (base 16)                     Monarch Instrument                           
+                                                            15 Columbia drive                            
+                                                            Amherst  NH  03031                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Flexkom Internet Pazarlama Bilipim ve Eoitim Hiz.Inp.Mim.Muh.Oto.Enerji San. Tic. A.p.
+FF5000-FF5FFF                 (base 16)                     Flexkom Internet Pazarlama Bilipim ve Eoitim Hiz.Inp.Mim.Muh.Oto.Enerji San. Tic. A.p.
+                                                            Aþkan Mh. Atakent Sk. No:15 Meram            
+                                                            Konya    42090                               
+                                                            TR                                           
+
+00-50-C2                      (hex)                         Burk Technology                              
+FF4000-FF4FFF                 (base 16)                     Burk Technology                              
+                                                            7 Beaver Brook road                          
+                                                            Littleton  MA  01460                         
+                                                            US                                           
+
+40-D8-55                      (hex)                         Sarana Sistem Mikro                          
+00A000-00AFFF                 (base 16)                     Sarana Sistem Mikro                          
+                                                            JL.KEJAKSAAN NO 18                           
+                                                            JAKARTA  Click to Select  13430              
+                                                            ID                                           
+
+00-50-C2                      (hex)                         Human Intech                                 
+FF7000-FF7FFF                 (base 16)                     Human Intech                                 
+                                                            #1213 JnK Dijital Tower, 222-3               
+                                                            Guro-dong, Guro-gu  Seoul  152-053           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         AVA Monitoring AB                            
+FF9000-FF9FFF                 (base 16)                     AVA Monitoring AB                            
+                                                            Vädursgatan 6                                
+                                                            Göteborg  Västra götaland  412 50            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         GLOBALCOM ENGINEERING SRL                    
+FF2000-FF2FFF                 (base 16)                     GLOBALCOM ENGINEERING SRL                    
+                                                            Via Volta 9                                  
+                                                            MORNAGO  VA  21020                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Private                                      
+FE3000-FE3FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Pulsotronic Anlagentechnik GmbH              
+FE2000-FE2FFF                 (base 16)                     Pulsotronic Anlagentechnik GmbH              
+                                                            Neue Schichtstrasse 7                        
+                                                            Niederdorf  Saxony  09366                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         dotOcean                                     
+FE1000-FE1FFF                 (base 16)                     dotOcean                                     
+                                                            Lieven Bauwensstraat 20                      
+                                                            Brugge  West-Vlaanderen  8200                
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Peek Traffic                                 
+FDE000-FDEFFF                 (base 16)                     Peek Traffic                                 
+                                                            2906 Corporate Way                           
+                                                            Palmetto  FL  34235                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+FDF000-FDFFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         The Security Center Inc                      
+FDB000-FDBFFF                 (base 16)                     The Security Center Inc                      
+                                                            10750 Forest Lane                            
+                                                            Dallas  TX  75243                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Motec Pty Ltd                                
+FC1000-FC1FFF                 (base 16)                     Motec Pty Ltd                                
+                                                            121 Merrindale Drive                         
+                                                            Croydon South  Victoria  3136                
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Far South Networks                           
+FC8000-FC8FFF                 (base 16)                     Far South Networks                           
+                                                            49 Bell Crescent                             
+                                                            Westlake  Western Cape  7945                 
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Leroy Somer                                  
+FBC000-FBCFFF                 (base 16)                     Leroy Somer                                  
+                                                            Usine des Agriers - RDE                      
+                                                            Angoulême Cedex 9    16915                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ACIDA GmbH                                   
+FBB000-FBBFFF                 (base 16)                     ACIDA GmbH                                   
+                                                            Uersfeld 24                                  
+                                                            Aachen    52072                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ELTA                                         
+FC2000-FC2FFF                 (base 16)                     ELTA                                         
+                                                            14 place Marcel Dassault                     
+                                                            Blagnac    31700                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Telemisis Ltd                                
+FCA000-FCAFFF                 (base 16)                     Telemisis Ltd                                
+                                                            7 Blenheim Court                             
+                                                            Almondsbury  Bristol  BS32 4NE               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mehta Tech, Inc.                             
+FC9000-FC9FFF                 (base 16)                     Mehta Tech, Inc.                             
+                                                            208 N. 12th Avenue                           
+                                                            Eldridge  IA  52748                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Jinyoung Contech                             
+FCD000-FCDFFF                 (base 16)                     Jinyoung Contech                             
+                                                            #501 , MARIO TOWER, 222-12                   
+                                                              Seoul  152 050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Exelis Inc.                                  
+FA7000-FA7FFF                 (base 16)                     Exelis Inc.                                  
+                                                            430 W 5th Street                             
+                                                            Panama City  FL  32401                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dr. Neumann elektronik GmbH                  
+F99000-F99FFF                 (base 16)                     Dr. Neumann elektronik GmbH                  
+                                                            Schiffgesweg 9                               
+                                                            Pulheim  North Rhine-Westphalia  50259       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Infotech North America                       
+F98000-F98FFF                 (base 16)                     Infotech North America                       
+                                                            109 E. 17th Street                           
+                                                            Cheyenne  WY  82001                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Telvent                                      
+F9A000-F9AFFF                 (base 16)                     Telvent                                      
+                                                            Valgrande, 6                                 
+                                                            Alcobendas  Madrid  28108                    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Tateishi Kobisha Co.LTD                      
+FB0000-FB0FFF                 (base 16)                     Tateishi Kobisha Co.LTD                      
+                                                            114 Kana-cho                                 
+                                                            Fuchu-city  HIroshima  726-0025              
+                                                            JP                                           
+
+00-50-C2                      (hex)                         R&D KOMETEH                                  
+F9C000-F9CFFF                 (base 16)                     R&D KOMETEH                                  
+                                                            Lermontovsky pr. 54                          
+                                                              Saint-Petersburg  190103                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Sincair Systems International                
+F82000-F82FFF                 (base 16)                     Sincair Systems International                
+                                                            3115 S. Willow Avenue                        
+                                                            Fresno  CA  93725                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         GSP Sprachtechnologie GmbH                   
+F83000-F83FFF                 (base 16)                     GSP Sprachtechnologie GmbH                   
+                                                            Teltowkanalstr. 1                            
+                                                              Berlin  12247                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Enetics, Inc.                                
+F85000-F85FFF                 (base 16)                     Enetics, Inc.                                
+                                                            830 Canning Parkway                          
+                                                            Victor  NY  14564                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Atonometrics, Inc.                           
+F7C000-F7CFFF                 (base 16)                     Atonometrics, Inc.                           
+                                                            8900 Shoal Creek Blvd Ste 116                
+                                                            Austin  Texas  78757                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         TruTeq Wireless (Pty) Ltd                    
+F7E000-F7EFFF                 (base 16)                     TruTeq Wireless (Pty) Ltd                    
+                                                            Ameton House                                 
+                                                            Centurion  Gauteng  0157                     
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         PLDA                                         
+F81000-F81FFF                 (base 16)                     PLDA                                         
+                                                            Parc du Golf Bat 11A, Rue Guillibert         
+                                                            Aix en Provence  PACA  13856                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         TTi LTD (Thurlby Thandar Instruments LTD)    
+F95000-F95FFF                 (base 16)                     TTi LTD (Thurlby Thandar Instruments LTD)    
+                                                            Glebe Road                                   
+                                                            Cambridge  Cambridgeshire  PE29 7DR          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Safe Place Solutions Ltd                     
+F69000-F69FFF                 (base 16)                     Safe Place Solutions Ltd                     
+                                                            Eden House                                   
+                                                            Edenbridge  Kent  TN8 6HF                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Celestial Audio                              
+F67000-F67FFF                 (base 16)                     Celestial Audio                              
+                                                            4441 Albert St.                              
+                                                            Oakland  CA  94619                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Deckma GmbH                                  
+F60000-F60FFF                 (base 16)                     Deckma GmbH                                  
+                                                            Bahnhofstr.79                                
+                                                            Rosengarten-Klecken  Lower Saxonie  21224    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Brauch Elektronik GmbH&Co.KG                 
+F61000-F61FFF                 (base 16)                     Brauch Elektronik GmbH&Co.KG                 
+                                                            Hirschbachstrasse 47                         
+                                                            Reinheim  Hessen  64354                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SYSTEMTECHNIK GmbH                           
+F77000-F77FFF                 (base 16)                     SYSTEMTECHNIK GmbH                           
+                                                            Wielandstrasse 12                            
+                                                            Soemmerda  Thueringia  99610                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Steinbichler Optotechnik GmbH                
+F44000-F44FFF                 (base 16)                     Steinbichler Optotechnik GmbH                
+                                                            Georg-Wiesboeck-Ring 12                      
+                                                            Neubeuern  Bavaria  83115                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSPCon                                       
+F42000-F42FFF                 (base 16)                     DSPCon                                       
+                                                            380 Foothill Road                            
+                                                            Bridgewater  NJ  08807                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Visitech AS                                  
+F36000-F36FFF                 (base 16)                     Visitech AS                                  
+                                                            Kjellstadveien 5                             
+                                                            Lier  Lier  3400                             
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Z-App Systems, Inc.                          
+F4A000-F4AFFF                 (base 16)                     Z-App Systems, Inc.                          
+                                                            1732 N. First St.                            
+                                                            San Jose  CA  95112                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         H&L Instruments, LLC                         
+F2E000-F2EFFF                 (base 16)                     H&L Instruments, LLC                         
+                                                            34 Post Road                                 
+                                                            North Hampton  NH  03862                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+F2A000-F2AFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sequip S+E GmbH                              
+F34000-F34FFF                 (base 16)                     Sequip S+E GmbH                              
+                                                            Angermunder Straße 22                        
+                                                            Düsseldorf  NRW  40489                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AeroControl, Inc.                            
+F38000-F38FFF                 (base 16)                     AeroControl, Inc.                            
+                                                            595 Utica Ave.                               
+                                                            Boulder  CO  80304                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Electro-Motive Diesel                        
+F23000-F23FFF                 (base 16)                     Electro-Motive Diesel                        
+                                                            9301 West 55th Street                        
+                                                            LaGrange  IL  60525                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Unfors Instruments AB                        
+F20000-F20FFF                 (base 16)                     Unfors Instruments AB                        
+                                                            Uggledalsvagen 29                            
+                                                            Gothenburg   Billdal  42740                  
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Aqua Management                              
+F1A000-F1AFFF                 (base 16)                     Aqua Management                              
+                                                            6280 S Valley View BLVD                      
+                                                            Las Vegas  NV  89118                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Dell'Orto S.P.A.                             
+F1E000-F1EFFF                 (base 16)                     Dell'Orto S.P.A.                             
+                                                            Via Kennedy, 7                               
+                                                            Cabiate  Como  22060                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Amstelland Electronic BV                     
+EF7000-EF7FFF                 (base 16)                     Amstelland Electronic BV                     
+                                                            Amsteldijk Noord 194                         
+                                                            Uithoorn  Noord Holland  1422 XZ             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Zephyrus Electronics LTD.                    
+EFF000-EFFFFF                 (base 16)                     Zephyrus Electronics LTD.                    
+                                                            168 S. 122nd E. Ave.                         
+                                                            Tulsa  Oklahoma  74128                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Human Network Labs, Inc.                     
+EF5000-EF5FFF                 (base 16)                     Human Network Labs, Inc.                     
+                                                            4548 Market St. M19                          
+                                                            PHILADELPHIA  Pennsylvania  19139            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Predictive Sensor Technology                 
+EFA000-EFAFFF                 (base 16)                     Predictive Sensor Technology                 
+                                                            316 N Main St                                
+                                                            Lynchburg  Ohio  45142                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wincor Nixdorf Sp. z o.o.                    
+F10000-F10FFF                 (base 16)                     Wincor Nixdorf Sp. z o.o.                    
+                                                            ul. Popularna 82                             
+                                                            Warszawa  Poland  02-226                     
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Bluetest AB                                  
+F0D000-F0DFFF                 (base 16)                     Bluetest AB                                  
+                                                            Gotaverksgatan 1                             
+                                                            Gothenburg    SE-41755                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         AeroVision Avionics, Inc.                    
+F0F000-F0FFFF                 (base 16)                     AeroVision Avionics, Inc.                    
+                                                            2F, 30 R&D Rd. II,                           
+                                                            Hsinchu    300                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         HASCOM International Pty Ltd                 
+F0A000-F0AFFF                 (base 16)                     HASCOM International Pty Ltd                 
+                                                            15 Marloo Lane                               
+                                                            Quinns Rocks  Western Australia  6030        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Icon Research Ltd                            
+F07000-F07FFF                 (base 16)                     Icon Research Ltd                            
+                                                            3 Raw Holdings                               
+                                                            East Calder  West Lothian  EH53 0HY          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         osf Hansjuergen Meier GmbH & Co. KG          
+EE0000-EE0FFF                 (base 16)                     osf Hansjuergen Meier GmbH & Co. KG          
+                                                            Eichendorffstraße 6                          
+                                                            Espelkamp    32339                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Peek Traffic Corporation                     
+ECD000-ECDFFF                 (base 16)                     Peek Traffic Corporation                     
+                                                            2906 Corporate Way                           
+                                                            Palmetto  Florida  34221                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         BitWise Controls                             
+ECA000-ECAFFF                 (base 16)                     BitWise Controls                             
+                                                            98 Inverness Dr East                         
+                                                            Englewood  CO  80112                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         West-Com Nurse Call Systems, Inc.            
+EBA000-EBAFFF                 (base 16)                     West-Com Nurse Call Systems, Inc.            
+                                                            2200 Cordelia Road                           
+                                                            Fairfield  CA  94534                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         easii ic adiis                               
+ECE000-ECEFFF                 (base 16)                     easii ic adiis                               
+                                                            90 avenue leon blum                          
+                                                            grenoble  isere  38036                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+ECC000-ECCFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Droplet Measurement Technologies             
+EBD000-EBDFFF                 (base 16)                     Droplet Measurement Technologies             
+                                                            2545 Central Avenue                          
+                                                            Boulder  CO  80301                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         INFRONICS SYSTEMS LIMITED                    
+EC6000-EC6FFF                 (base 16)                     INFRONICS SYSTEMS LIMITED                    
+                                                            PLOT NO: 2 & 3, EKTHA TOWERS                 
+                                                            HYDERABAD  ANDHRA PRADESH  500084            
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Saab AB                                      
+EB7000-EB7FFF                 (base 16)                     Saab AB                                      
+                                                            Nobymalmsvägen                               
+                                                            Linköping  Östergötland  58182               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Arista Systems Corporation                   
+E97000-E97FFF                 (base 16)                     Arista Systems Corporation                   
+                                                            5th Floor,No.82-8,GuangFu Road,Sec. 1        
+                                                            San Chung  Taipei  241                       
+                                                            TW                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+E92000-E92FFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st.,35                   
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         PDU EXPERT UK LTD                            
+EB1000-EB1FFF                 (base 16)                     PDU EXPERT UK LTD                            
+                                                            11 b  THE CHERRIES                           
+                                                            SLOUGH    SL2 5TS                            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Powersense A/S                               
+EA6000-EA6FFF                 (base 16)                     Powersense A/S                               
+                                                            Skovlytoften 33                              
+                                                            Holte    2840                                
+                                                            DK                                           
+
+00-50-C2                      (hex)                         DataSoft Corporation                         
+E9F000-E9FFFF                 (base 16)                     DataSoft Corporation                         
+                                                            1475 N. Scottsdale Road                      
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Witree Co.,Ltd                               
+E83000-E83FFF                 (base 16)                     Witree Co.,Ltd                               
+                                                            621 Hyundai venture ville, 713  Suseo-dong, Gangnam-gu
+                                                            Seoul    135-539                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         STT Condigi A/S                              
+E8F000-E8FFFF                 (base 16)                     STT Condigi A/S                              
+                                                            Niels Bohrs vej 42,                          
+                                                            Stilling  Skanderborg  8660                  
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+E77000-E77FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  4016                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         EMAC, Inc.                                   
+E66000-E66FFF                 (base 16)                     EMAC, Inc.                                   
+                                                            2390 EMAC Way                                
+                                                            Carbondale  IL  62902                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         IB Elektronik GmbH                           
+E65000-E65FFF                 (base 16)                     IB Elektronik GmbH                           
+                                                            Daimlerstraße 51                             
+                                                            Karlsruhe  Baden-Württemberg  76185          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         NEXT video systems Hard- and Software Development GmbH
+E53000-E53FFF                 (base 16)                     NEXT video systems Hard- and Software Development GmbH
+                                                            Oderstr. 47                                  
+                                                            Neumuenster  SH  24539                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         OREP                                         
+E5E000-E5EFFF                 (base 16)                     OREP                                         
+                                                            39 AVENUE SIDOINE APOLLINAIRE                
+                                                            LYON    69009                                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         FUTEC INC.                                   
+E5A000-E5AFFF                 (base 16)                     FUTEC INC.                                   
+                                                            1217 Hayashi-cho                             
+                                                            Takamatushi  Kagawa  7610301                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Omnica Corporation                           
+E35000-E35FFF                 (base 16)                     Omnica Corporation                           
+                                                            15560-D Rockfield Blvd.                      
+                                                            Irvine  CA  92618                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+E36000-E36FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Oshoksh Corporation                          
+E32000-E32FFF                 (base 16)                     Oshoksh Corporation                          
+                                                            2307 Oregon Street                           
+                                                            Oshkosh  WI  54902                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         HGL Dynamics                                 
+E34000-E34FFF                 (base 16)                     HGL Dynamics                                 
+                                                            Hamilton Barr House                          
+                                                            GODALMING  Surrey  GU7 1HZ                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ITW Reyflex North America                    
+E48000-E48FFF                 (base 16)                     ITW Reyflex North America                    
+                                                            195 E Algonquin Road                         
+                                                            Des Plaines  IL  60090                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrea Mining Technology                  
+E46000-E46FFF                 (base 16)                     Industrea Mining Technology                  
+                                                            3 Co-Wyn Close                               
+                                                            Fountaindale  NSW  2258                      
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Ecrin Systems                                
+E40000-E40FFF                 (base 16)                     Ecrin Systems                                
+                                                            143 Rue Louis Neel                           
+                                                            Crolles  Isère  38920                        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         PCSC                                         
+E4D000-E4DFFF                 (base 16)                     PCSC                                         
+                                                            3541 Challenger Street                       
+                                                            Torrance  CA  90503                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         VITEC                                        
+E23000-E23FFF                 (base 16)                     VITEC                                        
+                                                            99, rue Pierre Semard                        
+                                                            CHATILLON    92320                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Zoe Medical                                  
+E19000-E19FFF                 (base 16)                     Zoe Medical                                  
+                                                            460 Boston Street                            
+                                                            Topsfield  MA  01983                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Holdline Tecnologia e Sistemas Ltda          
+E1D000-E1DFFF                 (base 16)                     Holdline Tecnologia e Sistemas Ltda          
+                                                            Rua Turfa, 1257                              
+                                                            Belo Horizonte  Minas Gerais  30430380       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Norwia AS                                    
+E21000-E21FFF                 (base 16)                     Norwia AS                                    
+                                                            PO Box 14                                    
+                                                            Sandefjord    3201                           
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Divelbiss Corporation                        
+E20000-E20FFF                 (base 16)                     Divelbiss Corporation                        
+                                                            9778 Mount Gilead Road                       
+                                                            Fredericktown  OH  43019                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ebner Electronic GmbH                        
+E06000-E06FFF                 (base 16)                     Ebner Electronic GmbH                        
+                                                            Neuhofenstrasse 35                           
+                                                            Gmunden  Upper   4810                        
+                                                            AT                                           
+
+00-50-C2                      (hex)                         PMAC JAPAN                                   
+E0E000-E0EFFF                 (base 16)                     PMAC JAPAN                                   
+                                                            Ningyoucho Bldg. 6F                          
+                                                            Chuo-ku  Tokyo  103-0013                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Unixmedia Srl                                
+E0D000-E0DFFF                 (base 16)                     Unixmedia Srl                                
+                                                            Via Cosimo del Fante, 4                      
+                                                            Milano    20122                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Calixto Systems Pvt Ltd                      
+E14000-E14FFF                 (base 16)                     Calixto Systems Pvt Ltd                      
+                                                            #111, First Floor, 2H Main Road              
+                                                            Bangalore  Karnataka  560043                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Automation Assist Japan Company              
+E13000-E13FFF                 (base 16)                     Automation Assist Japan Company              
+                                                            2-8-20 Kamatahonmachi                        
+                                                            Ota  Tokyo  144-0053                         
+                                                            JP                                           
+
+00-50-C2                      (hex)                         ATEME                                        
+E09000-E09FFF                 (base 16)                     ATEME                                        
+                                                            26 BUROSPACE                                 
+                                                            BIEVRES Cedex    91570                       
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ICU Scandinavia Schweiz GmbH                 
+E03000-E03FFF                 (base 16)                     ICU Scandinavia Schweiz GmbH                 
+                                                            Bahnhofstrasse 2                             
+                                                            Signau  Bern  3534                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         I-Evo Ltd                                    
+DFC000-DFCFFF                 (base 16)                     I-Evo Ltd                                    
+                                                            Henson House                                 
+                                                            Newcastle Upon Tyne  Tyne & Wear  NE12 6RZ   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HINO ENGINEERING, INC                        
+DF6000-DF6FFF                 (base 16)                     HINO ENGINEERING, INC                        
+                                                            60-7 Takakuramachi                           
+                                                            Hachiouji  Tokyo  192-0033                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Koncar Electrical Engineering Institute      
+DF0000-DF0FFF                 (base 16)                     Koncar Electrical Engineering Institute      
+                                                            Fallerovo setaliste 22                       
+                                                            Zagreb    10000                              
+                                                            HR                                           
+
+00-50-C2                      (hex)                         Powersense A/S                               
+DEF000-DEFFFF                 (base 16)                     Powersense A/S                               
+                                                            Skovlytoften 33                              
+                                                            Holte  Sealand  2840                         
+                                                            DK                                           
+
+00-50-C2                      (hex)                         VendNovation LLC                             
+DEC000-DECFFF                 (base 16)                     VendNovation LLC                             
+                                                            13400 NE 20th Street                         
+                                                            Bellevue  WA  98005                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lee Laser                                    
+DED000-DEDFFF                 (base 16)                     Lee Laser                                    
+                                                            7605 Presidents Drive                        
+                                                            Orlando  FL  32809                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ruwisch & Kollegen GmbH                      
+DEB000-DEBFFF                 (base 16)                     Ruwisch & Kollegen GmbH                      
+                                                            Ostendstr. 25                                
+                                                            Berlin    12459                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         One-Nemoto Engineering Corporation           
+DBF000-DBFFFF                 (base 16)                     One-Nemoto Engineering Corporation           
+                                                                                                         
+                                                              Tokyo  158-0096                            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         MCS Engenharia ltda                          
+DCF000-DCFFFF                 (base 16)                     MCS Engenharia ltda                          
+                                                            Al. Caiapos, 596                             
+                                                            Barueri  São Paulo  06460-110                
+                                                            BR                                           
+
+00-50-C2                      (hex)                         KinotonGmbH                                  
+DC9000-DC9FFF                 (base 16)                     KinotonGmbH                                  
+                                                            Industriestrasse 20a                         
+                                                            Germering  Bavaria  82110                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+DCB000-DCBFFF                 (base 16)                     CT Company                                   
+                                                            Godovikova 9, Moscow                         
+                                                            Moscow  RUSSIA  129085                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         T2M2 GmbH                                    
+DC8000-DC8FFF                 (base 16)                     T2M2 GmbH                                    
+                                                            Gruenberger Str. 140                         
+                                                            Giessen  Hessen  35394                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Instrumentel Limited                         
+DCC000-DCCFFF                 (base 16)                     Instrumentel Limited                         
+                                                            Leeds Innovation center                      
+                                                            Leeds  West Yorkshire  LS2 9DF               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+DC5000-DC5FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TESSERA TECHNOLOGY INC.                      
+DC2000-DC2FFF                 (base 16)                     TESSERA TECHNOLOGY INC.                      
+                                                            2710-1 4F, Noborito, Tama-ku                 
+                                                            Kawasaki-shi  Kanagawa  214-0014             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         SYSTECH                                      
+DD4000-DD4FFF                 (base 16)                     SYSTECH                                      
+                                                                                                         
+                                                            Ishimori-cyo  Fukui-ken Fukui-si  910-0122   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         LUCEO                                        
+DDB000-DDBFFF                 (base 16)                     LUCEO                                        
+                                                            16 Rue Laënnec                               
+                                                            Vern Sur Seiche    35770                     
+                                                            FR                                           
+
+00-50-C2                      (hex)                         RF Code, Inc                                 
+DB1000-DB1FFF                 (base 16)                     RF Code, Inc                                 
+                                                            9229 Waterford Centre                        
+                                                            Austin  TX  78758                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         SoftwareCannery                              
+DB2000-DB2FFF                 (base 16)                     SoftwareCannery                              
+                                                            1660 Sandalwood Lane                         
+                                                            Carlsbad  CA  92008                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         PROSOFT-SYSTEMS LTD                          
+DB6000-DB6FFF                 (base 16)                     PROSOFT-SYSTEMS LTD                          
+                                                            Volgogradskaya, 194 a                        
+                                                            Ekaterinburg  Sverdlovskaya region  620102   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         SOREL GmbH Mikroelektronik                   
+DB7000-DB7FFF                 (base 16)                     SOREL GmbH Mikroelektronik                   
+                                                            Jahnstrasse 36                               
+                                                            Sprockhovel    45549                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ZAO NPC Kompjuternie Technologii             
+DB4000-DB4FFF                 (base 16)                     ZAO NPC Kompjuternie Technologii             
+                                                            Komsomolskiy av., 90-17                      
+                                                            Perm  Perm Region  614010                    
+                                                            RU                                           
+
+00-50-C2                      (hex)                         metraTec GmbH                                
+DA2000-DA2FFF                 (base 16)                     metraTec GmbH                                
+                                                            Niels-Bohr-Str. 5                            
+                                                            Magdeburg  Sachsen-Anh.  39106               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tieline Research Pty Ltd                     
+DA9000-DA9FFF                 (base 16)                     Tieline Research Pty Ltd                     
+                                                            PO Box 2092                                  
+                                                            Malaga  Western Australia  6944              
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Sine Systems, Inc.                           
+DA8000-DA8FFF                 (base 16)                     Sine Systems, Inc.                           
+                                                            972 Main St.                                 
+                                                            Nashville  TN  37206-3614                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Spang Power Electronics                      
+DAE000-DAEFFF                 (base 16)                     Spang Power Electronics                      
+                                                            9305 Progress Parkway                        
+                                                            Mentor  Ohio  44060                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         P4Q Electronics                              
+D78000-D78FFF                 (base 16)                     P4Q Electronics                              
+                                                            Alonsotegi Elkartegia, Mód. 27               
+                                                            Alonsotegi  Bizkaia  48810                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Scale-Tron, Inc.                             
+D72000-D72FFF                 (base 16)                     Scale-Tron, Inc.                             
+                                                            6428 Trans-Canada Highway                    
+                                                            St-Laurent  Quebec  H4T 1X4                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+D80000-D80FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Fr.SauterAG                                  
+D77000-D77FFF                 (base 16)                     Fr.SauterAG                                  
+                                                            Im Surinam 55                                
+                                                            BASEL  BS  CH                                
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Visual Telecommunication Network, Inc        
+D89000-D89FFF                 (base 16)                     Visual Telecommunication Network, Inc        
+                                                            2400 Geng Road                               
+                                                            Palo Alto  CA  94303                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Axlon AB                                     
+D93000-D93FFF                 (base 16)                     Axlon AB                                     
+                                                            Ulvsundavagen 110                            
+                                                            BROMMA    16867                              
+                                                            SE                                           
+
+00-50-C2                      (hex)                         iRphotonics                                  
+D8C000-D8CFFF                 (base 16)                     iRphotonics                                  
+                                                            627, McCaffrey                               
+                                                            St-Laurent  Quebec  H4T 1N3                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         ABtrack s.r.l.                               
+D54000-D54FFF                 (base 16)                     ABtrack s.r.l.                               
+                                                            Autoporto di Gorizia Pad B                   
+                                                            Gorizia    34170                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         BETTINI SRL                                  
+D51000-D51FFF                 (base 16)                     BETTINI SRL                                  
+                                                            VIA CESARE BATTISTI 22                       
+                                                            CESANO MADERNO  MILAN  20031                 
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Indra Australia                              
+D4B000-D4BFFF                 (base 16)                     Indra Australia                              
+                                                            Unit 21                                      
+                                                            Rydalmere  NSW  2116                         
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Watermark Estate Management Services, LLC    
+D48000-D48FFF                 (base 16)                     Watermark Estate Management Services, LLC    
+                                                            10230 NE Points Dr.                          
+                                                            Kirkland  WA  98033                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         C. Rob. Hammerstein GmbH & Co. KG            
+D70000-D70FFF                 (base 16)                     C. Rob. Hammerstein GmbH & Co. KG            
+                                                            Merscheider Strasse 167                      
+                                                            Solingen  NRW  42699                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GLOBALCOM ENGINEERING SRL                    
+D5D000-D5DFFF                 (base 16)                     GLOBALCOM ENGINEERING SRL                    
+                                                            Via Volta 9                                  
+                                                            MORNAGO  VA  21020                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         TV1 GmbH                                     
+D64000-D64FFF                 (base 16)                     TV1 GmbH                                     
+                                                            Betastr. 9a                                  
+                                                            Unterfoehring  Bavaria  85774                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Embedded Monitoring Systems Ltd.             
+D5A000-D5AFFF                 (base 16)                     Embedded Monitoring Systems Ltd.             
+                                                            Suite 103, LEO                               
+                                                            Lisburn  Co Antrim  BT28 2BP                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Hijikata Denki Corp.                         
+D57000-D57FFF                 (base 16)                     Hijikata Denki Corp.                         
+                                                            1-13-1 Minami Denen                          
+                                                            Fussa  Tokyo  197-0004                       
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Imtron Messtechnik GmbH                      
+D6F000-D6FFFF                 (base 16)                     Imtron Messtechnik GmbH                      
+                                                            Carl-Benz-Straße 11                          
+                                                            Owingen  Baden-Württemberg  88696            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Millennium Electronics Pty.Ltd.              
+D2A000-D2AFFF                 (base 16)                     Millennium Electronics Pty.Ltd.              
+                                                            12 Webber Parade                             
+                                                            East Keilor  Victoria  3033                  
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Axible Technologies                          
+D29000-D29FFF                 (base 16)                     Axible Technologies                          
+                                                            425 rue Jean Rostand                         
+                                                            Labège    31670                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Expro North Sea                              
+D24000-D24FFF                 (base 16)                     Expro North Sea                              
+                                                            Units 4-6, 9 Bessemer Close                  
+                                                            Verwood  Dorset  BH31 6AZ                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Bluestone Technology GmbH                    
+D23000-D23FFF                 (base 16)                     Bluestone Technology GmbH                    
+                                                            Mikroforum Ring 2                            
+                                                            Wendelsheim  Rhineland-Palatinate  55234     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Synatec Electronic GmbH                      
+D3E000-D3EFFF                 (base 16)                     Synatec Electronic GmbH                      
+                                                            Bruehlhofstraße 4                            
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Moco Media Pty Ltd                           
+D1D000-D1DFFF                 (base 16)                     Moco Media Pty Ltd                           
+                                                            Ground Floor                                 
+                                                            Fitzroy  VIC  3065                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Kyowa Electronics Co.,Ltd.                   
+D38000-D38FFF                 (base 16)                     Kyowa Electronics Co.,Ltd.                   
+                                                            4-3-31 Takatsukasa                           
+                                                            Takarazuka  Hyogo  665-0051                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         MSR-Office GmbH                              
+D15000-D15FFF                 (base 16)                     MSR-Office GmbH                              
+                                                            Ravensburger Straße 71                       
+                                                            Wangen  Baden-Württemberg  88239             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Imricor Medical Systems, Inc.                
+D16000-D16FFF                 (base 16)                     Imricor Medical Systems, Inc.                
+                                                            400 Gateway Boulevard                        
+                                                            Burnsville  MN  55337                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Reimesch Kommunikationssysteme GmbH          
+D08000-D08FFF                 (base 16)                     Reimesch Kommunikationssysteme GmbH          
+                                                            Friedrich-Ebert-Str.                         
+                                                            Bergisch Gladbach  NRW  51429                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         New Embedded Technology                      
+CFB000-CFBFFF                 (base 16)                     New Embedded Technology                      
+                                                            204 N El Camino Real                         
+                                                            Encinitas  Ca  92024                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Daiken Automacao Ltda                        
+CF3000-CF3FFF                 (base 16)                     Daiken Automacao Ltda                        
+                                                            Av Sao Gabriel 481 - Campo Pequeno           
+                                                            Colombo  Pr  83404000                        
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Baudisch Electronic GmbH                     
+CF4000-CF4FFF                 (base 16)                     Baudisch Electronic GmbH                     
+                                                            Im Gewerbegebiet 7-9                         
+                                                            Wäschenbeuren  Baden-Württemberg  73116      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EMBED-IT OG                                  
+CEE000-CEEFFF                 (base 16)                     EMBED-IT OG                                  
+                                                            Phorusgasse 8                                
+                                                            Vienna    1040                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Thomas & Betts                               
+CE8000-CE8FFF                 (base 16)                     Thomas & Betts                               
+                                                            5900 Eastport Blvd                           
+                                                            Richmond  Virginia  23231                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         AeroMechanical Services Ltd, FLYHT           
+CED000-CEDFFF                 (base 16)                     AeroMechanical Services Ltd, FLYHT           
+                                                            Suite 200W                                   
+                                                            Calgary  Alberta  T2E7P1                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         TEKTRONIK                                    
+CE4000-CE4FFF                 (base 16)                     TEKTRONIK                                    
+                                                            44-48 Rocco Drive                            
+                                                            Melbourne  VICTORIA  3179                    
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Weiss Robotics GmbH & Co. KG                 
+CF2000-CF2FFF                 (base 16)                     Weiss Robotics GmbH & Co. KG                 
+                                                            In der Gerste 2                              
+                                                            Ludwigsburg  Baden-Württemberg  71636        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TelGaAs, Inc.                                
+CF1000-CF1FFF                 (base 16)                     TelGaAs, Inc.                                
+                                                            125 N. Central Dr.                           
+                                                            O'Fallon  MO  63366                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         K.C.C. SHOKAI LIMITED                        
+CDD000-CDDFFF                 (base 16)                     K.C.C. SHOKAI LIMITED                        
+                                                            1-2-1                                        
+                                                            Kobe  Hyougo-ken  651-2241                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Industrial Control Links, Inc.               
+CE0000-CE0FFF                 (base 16)                     Industrial Control Links, Inc.               
+                                                            12840 Earhart Ave.                           
+                                                            Auburn  CA  95602                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Smartech-technology                          
+CCC000-CCCFFF                 (base 16)                     Smartech-technology                          
+                                                            Stachek 107-J office 16H                     
+                                                            Saint-Petersburg    198303                   
+                                                            RU                                           
+
+00-50-C2                      (hex)                         CP ELETRONICA SA                             
+CBC000-CBCFFF                 (base 16)                     CP ELETRONICA SA                             
+                                                            RUA VARZEA, 379                              
+                                                            PORTO ALEGRE  RIO GRANDE DO SUL  91040600    
+                                                            BR                                           
+
+00-50-C2                      (hex)                         KDT                                          
+CC6000-CC6FFF                 (base 16)                     KDT                                          
+                                                            203-902, Bucheon Techno-Park                 
+                                                            Bucheon-si  Gyeonggi-do  420-733             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Wayne Kerr Electronics                       
+CA1000-CA1FFF                 (base 16)                     Wayne Kerr Electronics                       
+                                                            Unit 4, Vinnetrow Business Park              
+                                                            Chichester  West Sussex  PO20 1QH            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+CAA000-CAAFFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         The Logical Company                          
+CA2000-CA2FFF                 (base 16)                     The Logical Company                          
+                                                            75 Gateway Blvd.                             
+                                                            Cottage Grove  OR  97424                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vox Technologies                             
+CA4000-CA4FFF                 (base 16)                     Vox Technologies                             
+                                                            1180 Commerce Dr.                            
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Odyssee Systemes SAS                         
+C81000-C81FFF                 (base 16)                     Odyssee Systemes SAS                         
+                                                            840 Route de la Roquette                     
+                                                            MOUANS-SARTOUX    06370                      
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Kinects Solutions Inc                        
+C7F000-C7FFFF                 (base 16)                     Kinects Solutions Inc                        
+                                                            800 Kipling Avenue - Unit 3                  
+                                                            Toronto  Ontario  M8Z 6C4                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         xxter b.v.                                   
+C9F000-C9FFFF                 (base 16)                     xxter b.v.                                   
+                                                            Elandsgracht 73 I                            
+                                                            Amsterdam  NH  1016 TR                       
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+C9C000-C9CFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TAE Antriebstechnik GmbH                     
+C7D000-C7DFFF                 (base 16)                     TAE Antriebstechnik GmbH                     
+                                                            Am Kappengraben 20                           
+                                                            Wehrheim  Hessen  61273                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AIM Co.,Ltd                                  
+C77000-C77FFF                 (base 16)                     AIM Co.,Ltd                                  
+                                                            333-9 Nishi Miyukicho Hamachi                
+                                                            Toyohashi  Aichi  441-8113                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         LECO Corporation                             
+C87000-C87FFF                 (base 16)                     LECO Corporation                             
+                                                            3000 Lakeview Ave.                           
+                                                            St. Joseph  Michigan  49085                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         CSI Controles e Sistemas Industriais Ltda.   
+C88000-C88FFF                 (base 16)                     CSI Controles e Sistemas Industriais Ltda.   
+                                                            Av. Piraporinha, 506                         
+                                                            Diadema  São Paulo  09950000                 
+                                                            BR                                           
+
+00-50-C2                      (hex)                         SENSAIR Pty Ltd                              
+C93000-C93FFF                 (base 16)                     SENSAIR Pty Ltd                              
+                                                            79 Crooke Road                               
+                                                            Castella  Victoria  3777                     
+                                                            AU                                           
+
+00-50-C2                      (hex)                         HJPC Corporation dba Pactron                 
+C99000-C99FFF                 (base 16)                     HJPC Corporation dba Pactron                 
+                                                            1149 Tasman Drive                            
+                                                            Sunnyvale   CA  94089                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SDD ITG                                      
+C8E000-C8EFFF                 (base 16)                     SDD ITG                                      
+                                                            Volgina 15                                   
+                                                            Belgrade    11060                            
+                                                            RS                                           
+
+00-50-C2                      (hex)                         QNE GmbH & Co. KG                            
+C46000-C46FFF                 (base 16)                     QNE GmbH & Co. KG                            
+                                                            Alexanderstraße 124                          
+                                                            Oldenburg  Niedersachsen  26121              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Weltek Technologies Co. Ltd.                 
+C47000-C47FFF                 (base 16)                     Weltek Technologies Co. Ltd.                 
+                                                            Flat A-B, 12/F, Block 1, Wah Fung Ind. Centre, 33-39 Kwai Fung Crescent, Kwai Chung, N.T.
+                                                                852                                      
+                                                            HK                                           
+
+00-50-C2                      (hex)                         Beijing Zhongherongzhi Elec.&Tech.Co.,Ltd.   
+C44000-C44FFF                 (base 16)                     Beijing Zhongherongzhi Elec.&Tech.Co.,Ltd.   
+                                                            Rm.605 Astronautic Exactitude Plaza No.30 South Haidian Rd.
+                                                            Beijing    100080                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         CellPlus technologies, Inc.                  
+C5E000-C5EFFF                 (base 16)                     CellPlus technologies, Inc.                  
+                                                            3959 Idaho Street                            
+                                                            San Diego   California  92104                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Broadsoft PacketSmart, Inc.                  
+C68000-C68FFF                 (base 16)                     Broadsoft PacketSmart, Inc.                  
+                                                            10080 N Wolfe Rd, SW 3-300                   
+                                                            Cupertino  CA  95014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Watterott electronic                         
+C55000-C55FFF                 (base 16)                     Watterott electronic                         
+                                                            Winkelstr. 12a                               
+                                                            Hausen  Thueringen  37327                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Wilke Technology GmbH                        
+C70000-C70FFF                 (base 16)                     Wilke Technology GmbH                        
+                                                            Krefelder Strasse 147                        
+                                                            Aachen    52070                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Wapice Ltd.                                  
+C74000-C74FFF                 (base 16)                     Wapice Ltd.                                  
+                                                            Yliopistonranta 5                            
+                                                            Vaasa    65200                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Z-App Systems, Inc.                          
+C2B000-C2BFFF                 (base 16)                     Z-App Systems, Inc.                          
+                                                            1732 N. First St.                            
+                                                            San Jose  CA  95112                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+C25000-C25FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Qualnetics Corporation                       
+C24000-C24FFF                 (base 16)                     Qualnetics Corporation                       
+                                                            2183 Alpine Way                              
+                                                            Bellingham  WA  98226                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Private                                      
+C21000-C21FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Peperoni-Light                               
+C1E000-C1EFFF                 (base 16)                     Peperoni-Light                               
+                                                            Wiesenrautenstieg 42                         
+                                                            Hamburg    22607                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         INO - Institut National d'Optique            
+C15000-C15FFF                 (base 16)                     INO - Institut National d'Optique            
+                                                            2740, Einstein Street                        
+                                                            Quebec    G1P 4S4                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+C10000-C10FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Computer Automation Technology Inc           
+C38000-C38FFF                 (base 16)                     Computer Automation Technology Inc           
+                                                            3397 NW 23 Court                             
+                                                            Boca Raton  Florida  33431                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kyuhen                                       
+C34000-C34FFF                 (base 16)                     Kyuhen                                       
+                                                            hanamigahama2-1-1                            
+                                                            fukutsu  fukuoka  811-3216                   
+                                                            JP                                           
+
+00-50-C2                      (hex)                         REFLEX CES                                   
+C2F000-C2FFFF                 (base 16)                     REFLEX CES                                   
+                                                            2 RUE DU GEVAUDAN                            
+                                                            EVRY    91047                                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ELSIST S.r.l.                                
+C3C000-C3CFFF                 (base 16)                     ELSIST S.r.l.                                
+                                                            Via Giacomo Brodolini, 15                    
+                                                            CASALE MONFERRATO    15033                   
+                                                            IT                                           
+
+00-50-C2                      (hex)                         juiceboss                                    
+C08000-C08FFF                 (base 16)                     juiceboss                                    
+                                                            1946 Pescadero Creek Road                    
+                                                            Pescadero  CA  94060                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         CIO Informatique Industrielle                
+C07000-C07FFF                 (base 16)                     CIO Informatique Industrielle                
+                                                            1 Rue de la Presse                           
+                                                            SAINT-ETIENNE  LOIRE  42950                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         VEHICLE TESTING EQUIPMENT, S.L.              
+BE8000-BE8FFF                 (base 16)                     VEHICLE TESTING EQUIPMENT, S.L.              
+                                                            C/ Conca de Barberá  19                      
+                                                            Castellar del Vallès  Barcelona  08211       
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Ernemann Cine Tec GmbH                       
+BFD000-BFDFFF                 (base 16)                     Ernemann Cine Tec GmbH                       
+                                                            Mecklenburger Str. 32 - 36                   
+                                                            Kiel  Schleswig Holstein  24106              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DYCEC, S.A.                                  
+C0F000-C0FFFF                 (base 16)                     DYCEC, S.A.                                  
+                                                            Torres Quevedo, 1-P.T.M.                     
+                                                            Tres Cantos  Madrid  28760                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Hanning Elektro-Werke GmbH & Co. KG          
+C02000-C02FFF                 (base 16)                     Hanning Elektro-Werke GmbH & Co. KG          
+                                                            Holter Strasse 90                            
+                                                            Oerlinghausen  NRW  33813                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         QUERCUS TECHNOLOGIES, S.L.                   
+C01000-C01FFF                 (base 16)                     QUERCUS TECHNOLOGIES, S.L.                   
+                                                            Antoni Isern 4 baixos                        
+                                                            Reus  Tarragona  43205                       
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Touch Revolution Inc.                        
+BED000-BEDFFF                 (base 16)                     Touch Revolution Inc.                        
+                                                            101 California St.                           
+                                                            San Francisco  CA  94065                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vitel Net                                    
+BF9000-BF9FFF                 (base 16)                     Vitel Net                                    
+                                                            8201 Greensboro Dr.                          
+                                                            McLean  VA  22102                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ARTEIXO TELECOM                              
+BCB000-BCBFFF                 (base 16)                     ARTEIXO TELECOM                              
+                                                            P.E. Penapurreira                            
+                                                            As Pontes  A Coruña  15320                   
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Euro-Konsult Sp. z o.o.                      
+BDF000-BDFFFF                 (base 16)                     Euro-Konsult Sp. z o.o.                      
+                                                            Swidnicka 19/315                             
+                                                            Wroclaw  dolnoslaskie  50-066                
+                                                            PL                                           
+
+00-50-C2                      (hex)                         AMS Controls, Inc.                           
+BD9000-BD9FFF                 (base 16)                     AMS Controls, Inc.                           
+                                                            12180 Prichard Farm Road                     
+                                                            Maryland Heights  MO  63043                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wheatstone Corporation                       
+BC4000-BC4FFF                 (base 16)                     Wheatstone Corporation                       
+                                                            600 Industrial Drive                         
+                                                            New Bern  NC  28562                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+BC3000-BC3FFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Digital Lumens                               
+BDA000-BDAFFF                 (base 16)                     Digital Lumens                               
+                                                            129 Portland Street                          
+                                                            Boston  Massachusetts  02114                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fiber Connections Inc.                       
+BAE000-BAEFFF                 (base 16)                     Fiber Connections Inc.                       
+                                                            5878 Highway # 9                             
+                                                            Schomberg  ON  L0G 1T0                       
+                                                            CA                                           
+
+00-50-C2                      (hex)                         NetworkFX Communications, LLC                
+BAA000-BAAFFF                 (base 16)                     NetworkFX Communications, LLC                
+                                                            95-1036 Auina St.                            
+                                                            Mililani  HI  96789                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+BA3000-BA3FFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+B9E000-B9EFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         MROAD INFORMATION SYSTEM                     
+BB5000-BB5FFF                 (base 16)                     MROAD INFORMATION SYSTEM                     
+                                                            3F, SUNGDO BD. 689-1                         
+                                                            Seongnam-si  GYeongi-do  461-200             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Pro4tech                                     
+BB1000-BB1FFF                 (base 16)                     Pro4tech                                     
+                                                            Kochav Yokneam bldg 5 floor                  
+                                                            Yokneam Illit    20692                       
+                                                            IL                                           
+
+00-50-C2                      (hex)                         JSC Electrical Equipment Factory             
+BB4000-BB4FFF                 (base 16)                     JSC Electrical Equipment Factory             
+                                                            Otradnaya str, 6                             
+                                                            Moscow    129626                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Quarch Technology Ltd                        
+BB6000-BB6FFF                 (base 16)                     Quarch Technology Ltd                        
+                                                            4C Dalfaber Industrial Estate                
+                                                            Aviemore  Inverness-Shire  PH22 1ST          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Rx Monitoring Services                       
+B95000-B95FFF                 (base 16)                     Rx Monitoring Services                       
+                                                            22A Eastman Ave                              
+                                                            Bedford  NH  03110                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SISS Technology Inc.                         
+BA9000-BA9FFF                 (base 16)                     SISS Technology Inc.                         
+                                                            601 Ace-Technotower, 684-1 Deungchon-dong, Gangseo-gu
+                                                            Seoul    157-030                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMC PARTNER AG                               
+B93000-B93FFF                 (base 16)                     EMC PARTNER AG                               
+                                                            Baselstrasse 160                             
+                                                            Laufen  Baselland  4242                      
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Measurement Technology NW                    
+B62000-B62FFF                 (base 16)                     Measurement Technology NW                    
+                                                            4211 24th Avenue West                        
+                                                            Seattle  WA  98199                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+B71000-B71FFF                 (base 16)                     Digitale Analoge COMponenten West Electronic Vertriebs GmbH
+                                                            Schallbruch 19-21                            
+                                                            Haan  NRW  42781                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Advanced Desktop Systems Ltd                 
+B72000-B72FFF                 (base 16)                     Advanced Desktop Systems Ltd                 
+                                                            36 Haldan Road                               
+                                                            London    E4 9JJ                             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+B6F000-B6FFFF                 (base 16)                     CT Company                                   
+                                                            Godovikova 9, Moscow                         
+                                                            Moscow  RUSSIA  129085                       
+                                                            RU                                           
+
+00-50-C2                      (hex)                         TANABIKI Inc.                                
+B82000-B82FFF                 (base 16)                     TANABIKI Inc.                                
+                                                            1-4-6-305                                    
+                                                            Kunitachi  Tokyo  1860002                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Advanced Storage Concepts, Inc.              
+B83000-B83FFF                 (base 16)                     Advanced Storage Concepts, Inc.              
+                                                            2200 Market Street                           
+                                                            Galveston  TX  77550                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+B6A000-B6AFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Thetis S.p.A.                                
+B69000-B69FFF                 (base 16)                     Thetis S.p.A.                                
+                                                            Castello, 2737/f                             
+                                                            Venezia  VE  30122                           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Blankom                                      
+B75000-B75FFF                 (base 16)                     Blankom                                      
+                                                            Hermann-Petersilge-Str. 1                    
+                                                            Bad Blankenburg  TH  07422                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         MITSUYA LABORATORIES INC.                    
+B79000-B79FFF                 (base 16)                     MITSUYA LABORATORIES INC.                    
+                                                            6-31-18                                      
+                                                            KAWASAKI-CITY  KANAGAWA  215-0021            
+                                                            JP                                           
+
+00-50-C2                      (hex)                         FBB                                          
+B8B000-B8BFFF                 (base 16)                     FBB                                          
+                                                            Hei en Boeicopseweg 118                      
+                                                            Hei en Boeicop    4126RL                     
+                                                            NL                                           
+
+00-50-C2                      (hex)                         ASTO                                         
+B86000-B86FFF                 (base 16)                     ASTO                                         
+                                                            22 Mei Hwan Drive                            
+                                                            Singapore    568357                          
+                                                            SG                                           
+
+00-50-C2                      (hex)                         Plitron Manufacturing Inc.                   
+B5D000-B5DFFF                 (base 16)                     Plitron Manufacturing Inc.                   
+                                                            8-601 Magnetic Drive                         
+                                                            Toronto  Ontario  M3J 3J2                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Troll Systems Corporation                    
+B4D000-B4DFFF                 (base 16)                     Troll Systems Corporation                    
+                                                            24950 Anza Drive                             
+                                                            Valencia  CA  91355                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Ampcontrol Pty Ltd                           
+B44000-B44FFF                 (base 16)                     Ampcontrol Pty Ltd                           
+                                                            7 Billbrooke Close                           
+                                                            Cameron Park  NSW  2285                      
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Nikon Systems Inc.                           
+B3A000-B3AFFF                 (base 16)                     Nikon Systems Inc.                           
+                                                            16F Queen's Tower-B, 3-3                     
+                                                            Yokohama  Kanagawa  220-6116                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Mobileye                                     
+B46000-B46FFF                 (base 16)                     Mobileye                                     
+                                                            13 Hartom st.                                
+                                                            Jerusalem    91450                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         North Bridge Technologies                    
+B5F000-B5FFFF                 (base 16)                     North Bridge Technologies                    
+                                                            Jean Ave 84                                  
+                                                            Centurion  Gauteng  0157                     
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         ADI Video Technologies                       
+B5C000-B5CFFF                 (base 16)                     ADI Video Technologies                       
+                                                            13a Hamelacha st,                            
+                                                            Lod    71520                                 
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Chitose Co.,Ltd                              
+B4B000-B4BFFF                 (base 16)                     Chitose Co.,Ltd                              
+                                                            Fiato202                                     
+                                                            Koga-City  Fukuoka  8113101                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Prodco                                       
+B53000-B53FFF                 (base 16)                     Prodco                                       
+                                                            4529 De castille                             
+                                                            Montreal  Quebec  H1H 1Y3                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Neothings, Inc.                              
+B16000-B16FFF                 (base 16)                     Neothings, Inc.                              
+                                                            1594 Fayette St                              
+                                                            El Cajon  CA  92020                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+B14000-B14FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sportvision Inc.                             
+B3B000-B3BFFF                 (base 16)                     Sportvision Inc.                             
+                                                            1240 La Avenida                              
+                                                            Mountain View  CA  94043                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Numcore Ltd                                  
+B33000-B33FFF                 (base 16)                     Numcore Ltd                                  
+                                                            Microkatu 1                                  
+                                                            Kuopio    70211                              
+                                                            FI                                           
+
+00-50-C2                      (hex)                         haneron                                      
+B35000-B35FFF                 (base 16)                     haneron                                      
+                                                            2-22 ota                                     
+                                                            yao  oosaka  581-0037                        
+                                                            JP                                           
+
+00-50-C2                      (hex)                         CosmoData Informatica Ltda.                  
+B2B000-B2BFFF                 (base 16)                     CosmoData Informatica Ltda.                  
+                                                            Rua Artur de Azevedo, 2103                   
+                                                            São Paulo    05404-015                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Integra LifeSciences (Ireland) Ltd           
+B29000-B29FFF                 (base 16)                     Integra LifeSciences (Ireland) Ltd           
+                                                            Sragh Industrial Estate                      
+                                                            Tullamore  Co Offaly  IRELAND                
+                                                            IE                                           
+
+00-50-C2                      (hex)                         Datasat Digital Entertainment                
+B2D000-B2DFFF                 (base 16)                     Datasat Digital Entertainment                
+                                                            9361 Topanga Cyn. Place                      
+                                                            Chatsworth  California  91311                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elcoteq Design Center Oy                     
+B17000-B17FFF                 (base 16)                     Elcoteq Design Center Oy                     
+                                                            Joensuunkatu 13                              
+                                                            Salo    24100                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         EXEL s.r.l                                   
+B11000-B11FFF                 (base 16)                     EXEL s.r.l                                   
+                                                            Via di Corticella 201                        
+                                                            Bologna    40128                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         KYAB Lulea AB                                
+B0E000-B0EFFF                 (base 16)                     KYAB Lulea AB                                
+                                                            Aurorum 6                                    
+                                                            Lulea  Norrbotten  97775                     
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Spider Tecnologia Ind. e Com. Ltda.          
+B03000-B03FFF                 (base 16)                     Spider Tecnologia Ind. e Com. Ltda.          
+                                                            Rua Alencar Araripe, 1440                    
+                                                            São Paulo    04253-000                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         HSR Harald L. Reuter                         
+B01000-B01FFF                 (base 16)                     HSR Harald L. Reuter                         
+                                                            Entwicklung - Reparatur - Fertigung          
+                                                            Bielefeld  NRW  33607                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Harper Chalice Group Limited                 
+B09000-B09FFF                 (base 16)                     Harper Chalice Group Limited                 
+                                                            8 Binns Close                                
+                                                            Coventry  West Midlands  CV4 9TB             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Trolex Limited                               
+AFE000-AFEFFF                 (base 16)                     Trolex Limited                               
+                                                            Newby Road,                                  
+                                                            Stockport.  Cheshire  SK7 5DY                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Odus Technologies SA                         
+AFC000-AFCFFF                 (base 16)                     Odus Technologies SA                         
+                                                            Rue des bosquets 18                          
+                                                            VEVEY  VAUD  1800                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Synthesechemie Dr. Penth GmbH                
+ADC000-ADCFFF                 (base 16)                     Synthesechemie Dr. Penth GmbH                
+                                                            Lebacher Strasse 60                          
+                                                            Heusweiler  Saarland  66822                  
+                                                            DE                                           
+
+00-50-C2                      (hex)                         elettrondata srl                             
+AD9000-AD9FFF                 (base 16)                     elettrondata srl                             
+                                                            via del canaletto 79                         
+                                                            spezzano di fiorano  modena  41042           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Energid                                      
+AF6000-AF6FFF                 (base 16)                     Energid                                      
+                                                            One Mifflin Place                            
+                                                            Cambridge  MA  02138                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Kramara s.r.o.                               
+AF5000-AF5FFF                 (base 16)                     Kramara s.r.o.                               
+                                                            Cisovicka 246                                
+                                                            Mnisek pod Brdy  Stredocesky kraj  25210     
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Midwest Microwave Solutions Inc.             
+AF7000-AF7FFF                 (base 16)                     Midwest Microwave Solutions Inc.             
+                                                            2000 Progress Drive                          
+                                                            Hiawatha  IA  52233                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Electronic Designs, Inc.            
+AE4000-AE4FFF                 (base 16)                     Advanced Electronic Designs, Inc.            
+                                                            233 Enterprise Blvd                          
+                                                            Bozeman  MT  59718                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Air Monitors Ltd                             
+AD7000-AD7FFF                 (base 16)                     Air Monitors Ltd                             
+                                                            Unit 2 Bredon Court                          
+                                                            Tewkesbury  Gloucestershire  GL20 6FF        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         IPtec, Inc.                                  
+AEE000-AEEFFF                 (base 16)                     IPtec, Inc.                                  
+                                                            5673 W. Las Positas Blvd.                    
+                                                            Pleasanton  CA  94588                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fritz Pauker Ingenieure GmbH                 
+AEC000-AECFFF                 (base 16)                     Fritz Pauker Ingenieure GmbH                 
+                                                            Paul-Lenz-Str. 5                             
+                                                            Friedberg  Bayern  86316                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Rafael                                       
+AD2000-AD2FFF                 (base 16)                     Rafael                                       
+                                                            P.o.b. 962 31009                             
+                                                            Haifa  31009    31009                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Bitmanufaktur GmbH                           
+AB1000-AB1FFF                 (base 16)                     Bitmanufaktur GmbH                           
+                                                            Schwedter Str. 23                            
+                                                            Berlin    10119                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Compañía de Instrumentacion y control, S.L.  
+AB3000-AB3FFF                 (base 16)                     Compañía de Instrumentacion y control, S.L.  
+                                                            C/Maria Auxiliadora 5, 1ºI                   
+                                                            Madrid    28040                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Barrick                                      
+ABC000-ABCFFF                 (base 16)                     Barrick                                      
+                                                            Balsamos Norte 324B y calle quinta           
+                                                            Guayaquil  Guayas  593                       
+                                                            EC                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines Ltd.               
+ABD000-ABDFFF                 (base 16)                     Monitor Business Machines Ltd.               
+                                                            PO Box 108 042                               
+                                                            Auckland                                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         FRAKO Kondensatoren- und Anlagenbau GmbH     
+AB0000-AB0FFF                 (base 16)                     FRAKO Kondensatoren- und Anlagenbau GmbH     
+                                                            Tscheulinstrasse 21 a                        
+                                                            Teningen    79331                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         OUTLINE srl                                  
+AAE000-AAEFFF                 (base 16)                     OUTLINE srl                                  
+                                                            VIA LEONARDO DA VINCI N°56                   
+                                                            FLERO  BRESCIA  25020                        
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Gygax Embedded Engineering GEE.ch            
+AB6000-AB6FFF                 (base 16)                     Gygax Embedded Engineering GEE.ch            
+                                                            Nuovo AG   -  Greuter Elektrotechnik         
+                                                            Wetzikon    CH-8620                          
+                                                            CH                                           
+
+00-50-C2                      (hex)                         BRS Sistemas Eletrônicos                     
+AAB000-AABFFF                 (base 16)                     BRS Sistemas Eletrônicos                     
+                                                            Rua Gomes de Freitas, 491 / 204              
+                                                            Porto Alegre  RS  91380-000                  
+                                                            BR                                           
+
+00-50-C2                      (hex)                         SAN GIORGIO S.E.I.N. srl                     
+AA9000-AA9FFF                 (base 16)                     SAN GIORGIO S.E.I.N. srl                     
+                                                            Via Pedulla' 59                              
+                                                            Genova    16165                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+ABA000-ABAFFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         DAISHIN-DENSHI Co., Ltd                      
+AC1000-AC1FFF                 (base 16)                     DAISHIN-DENSHI Co., Ltd                      
+                                                            2-38-14                                      
+                                                            Bunkyou-ku  Tokyo  113-0033                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         PSi Printer Systems international GmbH       
+AA4000-AA4FFF                 (base 16)                     PSi Printer Systems international GmbH       
+                                                            Eiserfelder Strasse 316                      
+                                                            Siegen    57080                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         PDQ Manufacturing  Inc.                      
+A9B000-A9BFFF                 (base 16)                     PDQ Manufacturing  Inc.                      
+                                                            1698 Scheuring Road                          
+                                                            De Pere  WI  54115                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         MICROSYSTEMES                                
+A97000-A97FFF                 (base 16)                     MICROSYSTEMES                                
+                                                            14 rue Jean Perrin                           
+                                                            TOULOUSE    31100                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Techno Sobi Co. Ltd.                         
+A83000-A83FFF                 (base 16)                     Techno Sobi Co. Ltd.                         
+                                                            Tsurunoso 6-11                               
+                                                            Takarazuka-shi  Hyogo-ken  6650833           
+                                                            JP                                           
+
+00-50-C2                      (hex)                         BPC circuits Ltd                             
+A81000-A81FFF                 (base 16)                     BPC circuits Ltd                             
+                                                            Omni House                                   
+                                                            Leicester    LE4 1BF                         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DSP DESIGN LTD                               
+A74000-A74FFF                 (base 16)                     DSP DESIGN LTD                               
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD    S41 0TZ                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Advanced Integrated Systems                  
+A69000-A69FFF                 (base 16)                     Advanced Integrated Systems                  
+                                                            81 David Love Pl.                            
+                                                            Goleta  CA  93117                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         EMS Industries                               
+A63000-A63FFF                 (base 16)                     EMS Industries                               
+                                                            PO Box 38822                                 
+                                                            Pretoria  Gauteng  0043                      
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+A7F000-A7FFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Purite Ltd                                   
+A71000-A71FFF                 (base 16)                     Purite Ltd                                   
+                                                            Bandet Way                                   
+                                                            Thame  Oxfordshire  OX9 3SJ                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+A77000-A77FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         JSC Component-ASU                            
+A5C000-A5CFFF                 (base 16)                     JSC Component-ASU                            
+                                                            Severnyi proezd 1, k.5/6                     
+                                                            Chernogolovka  Moscow Region  142432         
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Appareo Systems, LLC                         
+A35000-A35FFF                 (base 16)                     Appareo Systems, LLC                         
+                                                            1854 NDSU Research Circle North              
+                                                            Fargo  ND  58102                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Shenzhen Shangji electronic Co.Ltd           
+A36000-A36FFF                 (base 16)                     Shenzhen Shangji electronic Co.Ltd           
+                                                            Room 2017, Tianan Digital Era Building, Futian District,
+                                                            Shenzhen  Guangdong  518048                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Casabyte Inc.                                
+A34000-A34FFF                 (base 16)                     Casabyte Inc.                                
+                                                            200 Country Club Drive                       
+                                                            Blacksburg  VA  24060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mosberger Consulting LLC                     
+A40000-A40FFF                 (base 16)                     Mosberger Consulting LLC                     
+                                                            1935 Stony Hill Rd                           
+                                                            Boulder  CO  80305                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Agility Mfg, Inc.                            
+A23000-A23FFF                 (base 16)                     Agility Mfg, Inc.                            
+                                                            279 Locust Street                            
+                                                            Dover  NH  03820                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pyxis Controls WLL                           
+9E4000-9E4FFF                 (base 16)                     Pyxis Controls WLL                           
+                                                            Kingdom Tower                                
+                                                            Manama  Bahrain  0000                        
+                                                            BH                                           
+
+00-50-C2                      (hex)                         AFORE Solutions Inc.                         
+9EB000-9EBFFF                 (base 16)                     AFORE Solutions Inc.                         
+                                                            2680 Queensview Drive                        
+                                                            Ottawa  Ontario  K2B 8J9                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Hammock Corporation                          
+9E8000-9E8FFF                 (base 16)                     Hammock Corporation                          
+                                                            7-8-F 30SANKYO-Building                      
+                                                            SHINJUKU-WARD  TOKYO  169-0075               
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Dave Jones Design                            
+9F7000-9F7FFF                 (base 16)                     Dave Jones Design                            
+                                                            34 Lake St.                                  
+                                                            Owego  NY  13827                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vision Technologies, Inc.                    
+9F3000-9F3FFF                 (base 16)                     Vision Technologies, Inc.                    
+                                                            609 W Dyke Rd                                
+                                                            Rogers  AR  72756                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+9F2000-9F2FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CHARLYROBOT                                  
+A0D000-A0DFFF                 (base 16)                     CHARLYROBOT                                  
+                                                            192, route de l'usine                        
+                                                            CRUSEILLES  HAUTE-SAVOIE  74350              
+                                                            FR                                           
+
+00-50-C2                      (hex)                          IDS GeoRadar s.r.l.                         
+A0B000-A0BFFF                 (base 16)                      IDS GeoRadar s.r.l.                         
+                                                            Via E. Calabresi, 24                         
+                                                            PISA  PI  56121                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Humphrey Products                            
+9FF000-9FFFFF                 (base 16)                     Humphrey Products                            
+                                                            5070 East 'N' Ave                            
+                                                            Kalamazoo  MI  49048                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+A0A000-A0AFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Engelberg 2                                  
+                                                            Achstetten  bawu  88480                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EEG Enterprises Inc                          
+A03000-A03FFF                 (base 16)                     EEG Enterprises Inc                          
+                                                            586 Main Street                              
+                                                            Farmingdale  NY  11735                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Talyst, Inc.                                 
+A13000-A13FFF                 (base 16)                     Talyst, Inc.                                 
+                                                            13555 SE 36th Avenue                         
+                                                            Bellevue  WA  98006                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         FTM Marketing Limited                        
+9DC000-9DCFFF                 (base 16)                     FTM Marketing Limited                        
+                                                            Unit 26 Enterprise Estate                    
+                                                            Guildford  Surrey  GU1 1RB                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Stuyts Engineering Haarlem BV                
+9C0000-9C0FFF                 (base 16)                     Stuyts Engineering Haarlem BV                
+                                                            Hogeweg 40                                   
+                                                            Zandvoort  Noord-Holland  2042GH             
+                                                            NL                                           
+
+00-50-C2                      (hex)                         NEUTRONIK e.K.                               
+9DA000-9DAFFF                 (base 16)                     NEUTRONIK e.K.                               
+                                                            Taitinger Str. 14                            
+                                                            Dasing  Bayern  86453                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         FIRST                                        
+9D4000-9D4FFF                 (base 16)                     FIRST                                        
+                                                            200 Bedford Street                           
+                                                            Manchester  New Hampshire  03101             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Saia-Burgess Controls AG                     
+9D2000-9D2FFF                 (base 16)                     Saia-Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Ebru GmbH                                    
+9B0000-9B0FFF                 (base 16)                     Ebru GmbH                                    
+                                                            In den Kreuzwiesen                           
+                                                            Schönau    69250                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Connor-Winfield                              
+9BA000-9BAFFF                 (base 16)                     Connor-Winfield                              
+                                                            2111 Comprehensive Dr                        
+                                                            Aurora  Illinois  60505                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         SAMsystems GmbH                              
+9A2000-9A2FFF                 (base 16)                     SAMsystems GmbH                              
+                                                            Bannwaldallee 46                             
+                                                            Karlsruhe    76139                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Powersense A/S                               
+99D000-99DFFF                 (base 16)                     Powersense A/S                               
+                                                            Skovlytoften 33                              
+                                                            Holte  Rudersdal  2840                       
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Esensors, Inc.                               
+9AE000-9AEFFF                 (base 16)                     Esensors, Inc.                               
+                                                            4240 Ridge Lea Road                          
+                                                            Amherst  NY  14226                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+990000-990FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         TI2000 TECNOLOGIA INFORMATICA 2000           
+98B000-98BFFF                 (base 16)                     TI2000 TECNOLOGIA INFORMATICA 2000           
+                                                            CARDENAL HERRERA ORIA 165                    
+                                                            MADRID    28034                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         MGM-Devices Oy                               
+98C000-98CFFF                 (base 16)                     MGM-Devices Oy                               
+                                                            Länsikatuu 15                                
+                                                            Joensuu  Pohjois-Karjala  80110              
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Electrodata Inc.                             
+9AB000-9ABFFF                 (base 16)                     Electrodata Inc.                             
+                                                            P.O. Box 31780                               
+                                                            Independence  OHIO  44131                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Picsolve International Limited               
+961000-961FFF                 (base 16)                     Picsolve International Limited               
+                                                            Woodlands Lodge                              
+                                                            Derby  Derbyshire  DE223NL                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Soehnle Professional GmbH & Co.KG            
+97D000-97DFFF                 (base 16)                     Soehnle Professional GmbH & Co.KG            
+                                                            Manfred-von-Ardenne-Allee 12                 
+                                                            Backnang    71522                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         KST Technology Co., Ltd                      
+97A000-97AFFF                 (base 16)                     KST Technology Co., Ltd                      
+                                                            # 506, ACE TWIN TOWER I                      
+                                                              SEOUL  152-779                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         IPITEK                                       
+971000-971FFF                 (base 16)                     IPITEK                                       
+                                                            2330 Faraday Ave                             
+                                                            Carlsbad  CA  920                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Varec Inc.                                   
+96F000-96FFFF                 (base 16)                     Varec Inc.                                   
+                                                            5834 Peachtree Corners East                  
+                                                            Norcross  GA  30092                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Emitech Corporation                          
+965000-965FFF                 (base 16)                     Emitech Corporation                          
+                                                            2F,NO.7-1,Industry E.Rd.9,Science-Based Industrial Park,
+                                                            Hsinchu  Taiwan  308                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         kuroneko dennnou kenkyuushitsu               
+960000-960FFF                 (base 16)                     kuroneko dennnou kenkyuushitsu               
+                                                            671-1 obinata minakamimachi                  
+                                                            tonegun  gunma  379-1612                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         BuLogics, Inc.                               
+968000-968FFF                 (base 16)                     BuLogics, Inc.                               
+                                                            70 E Swedesford Rd, Suite 120                
+                                                            Malvern  PA  19355                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SANDS INSTRUMENTATION INDIA PVT LTD          
+976000-976FFF                 (base 16)                     SANDS INSTRUMENTATION INDIA PVT LTD          
+                                                            MF-7 CIPET HOSTEL ROAD, TVK INDUS ESTATE     
+                                                            CHENNAI  TAMIL NADU  600097                  
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Aqua Cooler Pty Ltd                          
+96C000-96CFFF                 (base 16)                     Aqua Cooler Pty Ltd                          
+                                                            161 Orchard Rd                               
+                                                            Chester Hill  NSW  2162                      
+                                                            AU                                           
+
+00-50-C2                      (hex)                         STRATEC Control Systems                      
+957000-957FFF                 (base 16)                     STRATEC Control Systems                      
+                                                            Ankerstraße 73                               
+                                                            Koenigsbach  Baden-Württemberg  75203        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IT-Designers GmbH                            
+94F000-94FFFF                 (base 16)                     IT-Designers GmbH                            
+                                                            Entennest 2                                  
+                                                            Esslingen    73730                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         C&H technology  ltd.                         
+94D000-94DFFF                 (base 16)                     C&H technology  ltd.                         
+                                                            No.108, Fuzhong Rd                           
+                                                            Banqiao  Taipei  220                         
+                                                            TW                                           
+
+00-50-C2                      (hex)                         AS Solar GmbH                                
+95B000-95BFFF                 (base 16)                     AS Solar GmbH                                
+                                                            Am Toenniesberg 4A                           
+                                                            Hanover  Lower Saxony  30453                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         QuanZhou TDX Electronics Co., Ltd.           
+943000-943FFF                 (base 16)                     QuanZhou TDX Electronics Co., Ltd.           
+                                                            Hi-tech Park, Quanzhou Economic and Tech Development Zone,
+                                                            QuanZhou  FuJian  362000                     
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Image Video                                  
+935000-935FFF                 (base 16)                     Image Video                                  
+                                                            1620 Midland Ave.                            
+                                                            Toronto  Ontario  M1P 3C2                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Rogue Engineering Inc.                       
+920000-920FFF                 (base 16)                     Rogue Engineering Inc.                       
+                                                            3860 S. Jason St                             
+                                                            Englewood  Colorado  80110                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+92B000-92BFFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         LSS GmbH                                     
+90C000-90CFFF                 (base 16)                     LSS GmbH                                     
+                                                            Am Eichenberg 1                              
+                                                            Altenburg  Thuringia  D-04610                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Board Level Limited                          
+90A000-90AFFF                 (base 16)                     Board Level Limited                          
+                                                            Finches                                      
+                                                            Wadhurst  East Sussex  TN5 6HE               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         E.ON ES Sverige AB                           
+90B000-90BFFF                 (base 16)                     E.ON ES Sverige AB                           
+                                                            Box 50529                                    
+                                                            Malmö    20250                               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         AHV Systems, Inc.                            
+919000-919FFF                 (base 16)                     AHV Systems, Inc.                            
+                                                            27 Ichabod Ln                                
+                                                            Marion  MA  02738                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         CIRTEM                                       
+917000-917FFF                 (base 16)                     CIRTEM                                       
+                                                            4, avenue Louis Bleriot                      
+                                                            31570  Ste FOY D'AIGREFEUILLE                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         UltraVision Security Systems, Inc.           
+8D6000-8D6FFF                 (base 16)                     UltraVision Security Systems, Inc.           
+                                                            88 Stiles Road                               
+                                                            Salem  NH  03079                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Friedrich Kuhnt GmbH                         
+8E8000-8E8FFF                 (base 16)                     Friedrich Kuhnt GmbH                         
+                                                            Stubbenweg 15                                
+                                                            Oldenburg  Niedersachsen  26125              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ATEME                                        
+8EA000-8EAFFF                 (base 16)                     ATEME                                        
+                                                            26 Burospace - route de GIZY -               
+                                                            Bievres cedex  Bievres  91570                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Dipl.-Ing. W. Nophut GmbH                    
+8DF000-8DFFFF                 (base 16)                     Dipl.-Ing. W. Nophut GmbH                    
+                                                            Steigerwaldstrasse 11                        
+                                                            Viereth/Trunstadt  Bayern  96191             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         GigaLinx Ltd.                                
+8CF000-8CFFFF                 (base 16)                     GigaLinx Ltd.                                
+                                                            6A Massada St.                               
+                                                            Hod Hasharon    45294                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+8BA000-8BAFFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH 4016                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Bachmann Monitoring GmbH                     
+8D1000-8D1FFF                 (base 16)                     Bachmann Monitoring GmbH                     
+                                                            Weimarische Strasse 10                       
+                                                            Rudolstadt  Thueringen  07407                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         The Pennsylvania State University            
+8BE000-8BEFFF                 (base 16)                     The Pennsylvania State University            
+                                                            0165 ARL Building                            
+                                                            State College  PA  16804-0030                
+                                                            US                                           
+
+00-50-C2                      (hex)                         BALOGH T.A.G Corporation                     
+8A4000-8A4FFF                 (base 16)                     BALOGH T.A.G Corporation                     
+                                                            7699 Kensington Court                        
+                                                            Brighton  Michigan  48116-8561               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mocon, Inc.                                  
+8A5000-8A5FFF                 (base 16)                     Mocon, Inc.                                  
+                                                            7500 Boone Avenue North                      
+                                                            Minneapolis  MN  55428                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         L3 Communications Nova Engineering           
+88D000-88DFFF                 (base 16)                     L3 Communications Nova Engineering           
+                                                            5 Circle Freeway Drive                       
+                                                            Cincinnati  OH  45246                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Hollis Electronics Company LLC               
+88B000-88BFFF                 (base 16)                     Hollis Electronics Company LLC               
+                                                            5 Northern Blvd., Unit #13                   
+                                                            Amherst  NH  03031                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Inico Technologies Ltd.                      
+899000-899FFF                 (base 16)                     Inico Technologies Ltd.                      
+                                                            #119 - 3553 31st Street NW                   
+                                                            Calgary  Alberta  T2L 2K7                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         EIZO Technologies GmbH                       
+893000-893FFF                 (base 16)                     EIZO Technologies GmbH                       
+                                                            BGM-Seidl-Strasse 8                          
+                                                            Wolfratshausen  Bavaria / Bayern  82515      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RTW GmbH & Co.KG                             
+8A3000-8A3FFF                 (base 16)                     RTW GmbH & Co.KG                             
+                                                            Elbeallee 19                                 
+                                                            Köln  NRW  50765                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Arcontia AB                                  
+87C000-87CFFF                 (base 16)                     Arcontia AB                                  
+                                                            Gruvgatan 35A                                
+                                                            Gothenburg  Vastra Frolunda  S-421 30        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         WARECUBE,INC.                                
+882000-882FFF                 (base 16)                     WARECUBE,INC.                                
+                                                            36-12                                        
+                                                            Gunpo-Si  Gyeonggi-Do  435-010               
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Ratioplast-Optoelectronics GmbH              
+854000-854FFF                 (base 16)                     Ratioplast-Optoelectronics GmbH              
+                                                            Jockweg 66                                   
+                                                            Lübbecke  NRW  D-32312                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CT Company                                   
+856000-856FFF                 (base 16)                     CT Company                                   
+                                                            Nizhni Krasnoselsky st., 35.                 
+                                                            Moscow    140070                             
+                                                            RU                                           
+
+00-50-C2                      (hex)                         USM Systems, Ltd                             
+86A000-86AFFF                 (base 16)                     USM Systems, Ltd                             
+                                                            Suite 1                                      
+                                                            Berkley  Michigan  48072                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Condigi Televagt A/S                         
+86C000-86CFFF                 (base 16)                     Condigi Televagt A/S                         
+                                                            Niels Bohrs vej 42, Stilling                 
+                                                            Skanderborg  jylland  8660                   
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Funkwerk plettac electronic GmbH             
+869000-869FFF                 (base 16)                     Funkwerk plettac electronic GmbH             
+                                                            Wuerzburger Strasse 150                      
+                                                            Fuerth  Bavaria  90760                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         B S E                                        
+85C000-85CFFF                 (base 16)                     B S E                                        
+                                                            BP 87                                        
+                                                            LE CREUSOT    71200                          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Boreste                                      
+85B000-85BFFF                 (base 16)                     Boreste                                      
+                                                            Rua Lauro Linhares, 589                      
+                                                            Florianopolis  SC  88036-001                 
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Advanced Technology Solutions                
+863000-863FFF                 (base 16)                     Advanced Technology Solutions                
+                                                            Seybelgasse 13                               
+                                                            Vienna    1100                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                          GD Mission Systems                          
+85F000-85FFFF                 (base 16)                      GD Mission Systems                          
+                                                            8220 E. Roosevelt St.                        
+                                                            Scottsdale  AZ  85257                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         R-S-I Elektrotechnik GmbH & Co. KG           
+871000-871FFF                 (base 16)                     R-S-I Elektrotechnik GmbH & Co. KG           
+                                                            Woelkestrasse 11                             
+                                                            Schweitenkirchen  Bayern  85301              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         XRONET Corporation                           
+873000-873FFF                 (base 16)                     XRONET Corporation                           
+                                                            3rd flr., Sunae Bldg., 6-4, Sunae-dong,      
+                                                            Seongnam  Gyeonggi  463-020                  
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Nuvation                                     
+859000-859FFF                 (base 16)                     Nuvation                                     
+                                                            3590 North First St.                         
+                                                            San Jose  CA  95134                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Momentum Data Systems                        
+82F000-82FFFF                 (base 16)                     Momentum Data Systems                        
+                                                            17330 Brookhurst Street                      
+                                                            Fountain Valley  CA  92708                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         S1nn GmbH & Co. KG                           
+832000-832FFF                 (base 16)                     S1nn GmbH & Co. KG                           
+                                                            Entennest 1                                  
+                                                            Esslingen  Baden-Württemberg  73730          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ANTEK GmbH                                   
+834000-834FFF                 (base 16)                     ANTEK GmbH                                   
+                                                            Im Koechersgrund 3                           
+                                                            Beilstein  Baden-Württemberg  71717          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LogiCom GmbH                                 
+82E000-82EFFF                 (base 16)                     LogiCom GmbH                                 
+                                                            Gautinger Strasse 51                         
+                                                            Krailling  Bayern  82152                     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Gamber-Johnson LLC                           
+84F000-84FFFF                 (base 16)                     Gamber-Johnson LLC                           
+                                                            3001 Borham Avenue                           
+                                                            Stevens Point  WI  54481                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         DRACO SYSTEMS                                
+84E000-84EFFF                 (base 16)                     DRACO SYSTEMS                                
+                                                            Edifici CIM Valles of. 61-62                 
+                                                            Sta. Perpetua de Mogoda  Barcelona  08130    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         ESP-Planning Co.                             
+846000-846FFF                 (base 16)                     ESP-Planning Co.                             
+                                                            Hukujucho Hirakata 2-51                      
+                                                            Hashima-shi  Gifu-ken  501-6257              
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Lars Morich Kommunikationstechnik GmbH       
+847000-847FFF                 (base 16)                     Lars Morich Kommunikationstechnik GmbH       
+                                                            Friedrich-Ebert-Str. 27                      
+                                                                65604 Elz                                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Syr-Tec Engineering & Marketing              
+83A000-83AFFF                 (base 16)                     Syr-Tec Engineering & Marketing              
+                                                            13 Hayahalom St.                             
+                                                            Holon  Tel-Aviv  58678                       
+                                                            IL                                           
+
+00-50-C2                      (hex)                         IT SALUX CO., LTD.                           
+81D000-81DFFF                 (base 16)                     IT SALUX CO., LTD.                           
+                                                            Suite 201, Woorim e-Biz center, 170-5,       
+                                                            Seoul    152-050                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Wireless Value BV                            
+818000-818FFF                 (base 16)                     Wireless Value BV                            
+                                                            Waanderweg 30A                               
+                                                            Emmen  Dr.  7827 KJ                          
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Telvent                                      
+814000-814FFF                 (base 16)                     Telvent                                      
+                                                            Tamarguillo, 29                              
+                                                            Seville  Seville  41006                      
+                                                            ES                                           
+
+00-50-C2                      (hex)                         microC Design SRL                            
+815000-815FFF                 (base 16)                     microC Design SRL                            
+                                                            Str. Laptari Tei, Nr. 1                      
+                                                            Bucuresti    023626                          
+                                                            RO                                           
+
+00-50-C2                      (hex)                         Intellectronika                              
+829000-829FFF                 (base 16)                     Intellectronika                              
+                                                            Semchenko st., 6                             
+                                                            Perm  Perm region  614022                    
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Enero Solutions inc.                         
+827000-827FFF                 (base 16)                     Enero Solutions inc.                         
+                                                            5764 Monkland Ave., Suite 100,               
+                                                            Montreal  Quebec  H4A 1E9                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Funkwerk Information Technologies Karlsfeld GmbH
+825000-825FFF                 (base 16)                     Funkwerk Information Technologies Karlsfeld GmbH
+                                                            Dieselstr. 8                                 
+                                                            Karlsfeld    85757                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Alphion Corporation                          
+810000-810FFF                 (base 16)                     Alphion Corporation                          
+                                                            196 Princeton Hightstown Rd.                 
+                                                            Princeton Junction  NJ  08550                
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bruno International Ltd.                     
+80E000-80EFFF                 (base 16)                     Bruno International Ltd.                     
+                                                            14 Bar Kochva st.                            
+                                                            Bney Berak  TA  51261                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+82B000-82BFFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Uellendahler Str. 199                        
+                                                            Wuppertal  NRW  42109                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Luxpert Technologies Co., Ltd.               
+80C000-80CFFF                 (base 16)                     Luxpert Technologies Co., Ltd.               
+                                                            #812 Hanshin IT Tower, 235, Gurodong, Gurogu,
+                                                            Seoul    152-768                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Varma Electronics Oy                         
+809000-809FFF                 (base 16)                     Varma Electronics Oy                         
+                                                            Jarrumiehenkatu, 2B                          
+                                                            Helsinki    FIN-00520                        
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Mistral Solutions Pvt. Ltd                   
+7E8000-7E8FFF                 (base 16)                     Mistral Solutions Pvt. Ltd                   
+                                                            #60, Adarsh Regent, 100 Ft. Ring Road        
+                                                            BANGALORE  KARNATAKA  560071                 
+                                                            IN                                           
+
+00-50-C2                      (hex)                         V2Green, Inc.                                
+7E7000-7E7FFF                 (base 16)                     V2Green, Inc.                                
+                                                            1725 Westlake Ave. N                         
+                                                            Seattle  WA  98109                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         SOREC                                        
+7F3000-7F3FFF                 (base 16)                     SOREC                                        
+                                                            ZA Le Patureau de la Grange                  
+                                                            PRUNIERS EN SOLOGNE  LOIR ET CHER  41200     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Logotherm Regelsysteme GmbH                  
+7F2000-7F2FFF                 (base 16)                     Logotherm Regelsysteme GmbH                  
+                                                            Erlauftalstraße 28                           
+                                                            Purgstall  Lower Austria  AT-3251            
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Cascade Technologies Ltd                     
+7DE000-7DEFFF                 (base 16)                     Cascade Technologies Ltd                     
+                                                            Unit A Logie Court                           
+                                                            Stirling  Stirlingshire  FK9 4NF             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Volumatic Limited                            
+7D9000-7D9FFF                 (base 16)                     Volumatic Limited                            
+                                                            Taurus House                                 
+                                                            Coventry  Warwickshire  CV6 5PY              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Delphi Display Systems, Inc.                 
+800000-800FFF                 (base 16)                     Delphi Display Systems, Inc.                 
+                                                            3160 Pullman Street                          
+                                                            Costa Mesa  CA  92626                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lyngsoe Systems                              
+7EC000-7ECFFF                 (base 16)                     Lyngsoe Systems                              
+                                                            5570 Kennedy RD                              
+                                                            Mississauga  Ontario  L4Z 2A9                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Private                                      
+7DF000-7DFFFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         HTEC Limited                                 
+7DA000-7DAFFF                 (base 16)                     HTEC Limited                                 
+                                                            Southampton International Park               
+                                                            Southampton  Hampshire  SO18 2RX             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Mueller Elektronik                           
+7DB000-7DBFFF                 (base 16)                     Mueller Elektronik                           
+                                                            Hauptstraße 86                               
+                                                            Spaichingen  Baden-Württemberg  78549        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Emitech Corporation                          
+7CF000-7CFFFF                 (base 16)                     Emitech Corporation                          
+                                                            2F, No.7-1, Industry. Er.9                   
+                                                            Hsinchu    308                               
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Radar Tronic ltd.                            
+7D0000-7D0FFF                 (base 16)                     Radar Tronic ltd.                            
+                                                            Törökkö  u. 5-7.                             
+                                                            Budapest  Pest  1037                         
+                                                            HU                                           
+
+00-50-C2                      (hex)                         SWECO JAPS AB                                
+7CC000-7CCFFF                 (base 16)                     SWECO JAPS AB                                
+                                                            Metallverksgatan 8                           
+                                                            Västerås    SE-721 30                        
+                                                            SE                                           
+
+00-50-C2                      (hex)                         MoBaCon                                      
+7C4000-7C4FFF                 (base 16)                     MoBaCon                                      
+                                                            Ludwig-Wilhelm-Str. 6                        
+                                                            Karlsruhe  BW  76131                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AST INCORPORATED                             
+7C3000-7C3FFF                 (base 16)                     AST INCORPORATED                             
+                                                            4150 GRANGE HALL ROAD                        
+                                                            HOLLY  MICHIGAN  48442                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Alstom (Schweiz) AG                          
+7B6000-7B6FFF                 (base 16)                     Alstom (Schweiz) AG                          
+                                                                                                         
+                                                            Baden  AG  5401                              
+                                                            CH                                           
+
+00-50-C2                      (hex)                         iNET Systems Inc.                            
+5A2000-5A2FFF                 (base 16)                     iNET Systems Inc.                            
+                                                            4633 Old Ironsides Dr. Suite 418             
+                                                            Santa  Clara  CA  95054                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lewis Controls Inc.                          
+784000-784FFF                 (base 16)                     Lewis Controls Inc.                          
+                                                            260 N. 26th Ave                              
+                                                            Corneliu  OR  97229                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Zoe Medical                                  
+7BF000-7BFFFF                 (base 16)                     Zoe Medical                                  
+                                                            460 Boston Street                            
+                                                            Topsfield  MA  01983                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fr. Sauter AG                                
+7C8000-7C8FFF                 (base 16)                     Fr. Sauter AG                                
+                                                            Im Surinam 55                                
+                                                            Basel  BS  CH4016                            
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ATEME                                        
+7B1000-7B1FFF                 (base 16)                     ATEME                                        
+                                                            26 Burospace - route de GIZY -               
+                                                            Bievres cedex  Bievres  91570                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         IUSA SA DE CV                                
+7AC000-7ACFFF                 (base 16)                     IUSA SA DE CV                                
+                                                            Km 109 CARRETERA PANAMERICANA MEX-QRO        
+                                                            PASTEJE JOCOTITLAN  ESTADO DE MEXICO  50700  
+                                                            MX                                           
+
+00-50-C2                      (hex)                         Field Design Service                         
+7A1000-7A1FFF                 (base 16)                     Field Design Service                         
+                                                            4-5-40, Showa-cho                            
+                                                            Akishima  Tokyo  196-0015                    
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Schniewindt GmbH & Co. KG                    
+79B000-79BFFF                 (base 16)                     Schniewindt GmbH & Co. KG                    
+                                                            Schoentaler Weg 46                           
+                                                            Neuenrade  NRW  58809                        
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Vital Systems Inc                            
+79C000-79CFFF                 (base 16)                     Vital Systems Inc                            
+                                                            21630 N 19th Ave. Suite B8                   
+                                                            Phoenix  AZ  85027                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         ASIANA IDT                                   
+7A6000-7A6FFF                 (base 16)                     ASIANA IDT                                   
+                                                            5th Fl., B-Dong, Asiana Town                 
+                                                            Seoul    157-713                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         COMSONICS, INC.                              
+794000-794FFF                 (base 16)                     COMSONICS, INC.                              
+                                                            1350 PORT REPUBLIC ROAD                      
+                                                            HARRISONBURG  VA  22801                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Coral Telecom Ltd                            
+779000-779FFF                 (base 16)                     Coral Telecom Ltd                            
+                                                            E-02 Sector 63                               
+                                                            Noida  UP  201301                            
+                                                            IN                                           
+
+00-50-C2                      (hex)                         SunGard Vivista                              
+778000-778FFF                 (base 16)                     SunGard Vivista                              
+                                                            Tormarton Road                               
+                                                            Chippenham  Wiltshire  SN14 8SR              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         GeoSIG Ltd.                                  
+774000-774FFF                 (base 16)                     GeoSIG Ltd.                                  
+                                                            Europastrasse 11                             
+                                                            Glattbrugg  Zürich  8152                     
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Putercom Enterprise Co., LTD.                
+76B000-76BFFF                 (base 16)                     Putercom Enterprise Co., LTD.                
+                                                            5F-3, No. 130, Jian Kang Road                
+                                                            Chung-Ho City  Taipei Hsien  235             
+                                                            TW                                           
+
+00-50-C2                      (hex)                         EFG CZ spol. s r.o.                          
+76C000-76CFFF                 (base 16)                     EFG CZ spol. s r.o.                          
+                                                            Na Jarově 4                                  
+                                                            Praha 3  Czech republic  13000               
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         NORMA systems GmbH                           
+783000-783FFF                 (base 16)                     NORMA systems GmbH                           
+                                                            Eidersteder Str.24                           
+                                                            Bordesholm  Schl.-Holstein  24582            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Lincoln Industrial                           
+77D000-77DFFF                 (base 16)                     Lincoln Industrial                           
+                                                            One Lincoln Way                              
+                                                            Saint Louis  MO  63120                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Beceem Communications, Inc.                  
+74D000-74DFFF                 (base 16)                     Beceem Communications, Inc.                  
+                                                            3960 Freedom Cir., 1st Floor                 
+                                                            Santa Clara  CA  95054                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Affolter Technologies SA                     
+749000-749FFF                 (base 16)                     Affolter Technologies SA                     
+                                                            Grand-Rue 76                                 
+                                                            Malleray  BE  2735                           
+                                                            CH                                           
+
+00-50-C2                      (hex)                         STAR-Dundee Ltd                              
+74B000-74BFFF                 (base 16)                     STAR-Dundee Ltd                              
+                                                            C/o School of Computing                      
+                                                            Dundee  Tayside  DD1 4HN                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Brightlights Intellectual Property Ltd       
+750000-750FFF                 (base 16)                     Brightlights Intellectual Property Ltd       
+                                                            Unit 19A Perseverance Works                  
+                                                            London    E2 8DD                             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Abeo Corporation                             
+754000-754FFF                 (base 16)                     Abeo Corporation                             
+                                                            13611 Legacy Circle                          
+                                                            Herndon  VA  20171-4701                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB                                          
+753000-753FFF                 (base 16)                     ABB                                          
+                                                            Service                                      
+                                                            Tampere    33840                             
+                                                            FI                                           
+
+00-50-C2                      (hex)                         ACISA                                        
+745000-745FFF                 (base 16)                     ACISA                                        
+                                                            Isaac Newton s/n                             
+                                                              Sevilla  41092                             
+                                                            ES                                           
+
+00-50-C2                      (hex)                         Fantuzzi Reggiane                            
+742000-742FFF                 (base 16)                     Fantuzzi Reggiane                            
+                                                            Via Renata Bianchi, 40                       
+                                                            Genoa  GE  16152                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Phytec Messtechnik GmbH                      
+72A000-72AFFF                 (base 16)                     Phytec Messtechnik GmbH                      
+                                                            Robert-Koch-Straße 39                        
+                                                            Mainz  Rheinland-Pfalz  55129                
+                                                            DE                                           
+
+00-50-C2                      (hex)                         SP Controls, Inc                             
+729000-729FFF                 (base 16)                     SP Controls, Inc                             
+                                                            930 Linden Avenue                            
+                                                            San Francisco  CA  94080                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Teradici Corporation                         
+737000-737FFF                 (base 16)                     Teradici Corporation                         
+                                                            101 4621 Canada Way,                         
+                                                            Burnaby  BC  V6G 4X8                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Cimetrics Research Pty Ltd                   
+733000-733FFF                 (base 16)                     Cimetrics Research Pty Ltd                   
+                                                            36 Bushland Close                            
+                                                            Tolmie  VIC  3723                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Logus Broadband Wireless Solutions Inc.      
+71A000-71AFFF                 (base 16)                     Logus Broadband Wireless Solutions Inc.      
+                                                            1501 Ellesmere Road                          
+                                                            Toronto  Ontario  M1P 4T6                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         RIEXINGER Elektronik                         
+715000-715FFF                 (base 16)                     RIEXINGER Elektronik                         
+                                                            Horschelweg 15                               
+                                                            Oberrot  Baden-Württemberg  D-74420          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         RO.VE.R. Laboratories S.p.A                  
+709000-709FFF                 (base 16)                     RO.VE.R. Laboratories S.p.A                  
+                                                            Via Parini 2/4                               
+                                                            Colombare di SIrmione  BS  25019             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         AUDICO SYSTEMS OY                            
+70E000-70EFFF                 (base 16)                     AUDICO SYSTEMS OY                            
+                                                            RUUNIKKOKATU 2                               
+                                                            TURKU    20380                               
+                                                            FI                                           
+
+00-50-C2                      (hex)                         ADVA Optical Networking                      
+71B000-71BFFF                 (base 16)                     ADVA Optical Networking                      
+                                                            One Technology Parkway South                 
+                                                            Norcross  Ga  30092                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         ASC telecom AG                               
+71F000-71FFFF                 (base 16)                     ASC telecom AG                               
+                                                            Seibelstraße 2                               
+                                                            Hösbach  Bavaria  63768                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Interactive Electronic Systems               
+6EE000-6EEFFF                 (base 16)                     Interactive Electronic Systems               
+                                                            193-23 Salerno Ave.                          
+                                                            Jamaica  NY  11423                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Netistix Technologies Corporation            
+6EC000-6ECFFF                 (base 16)                     Netistix Technologies Corporation            
+                                                            275 Michael Cowpland Drive                   
+                                                            Kanata  Ontario  K2M 2G2                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Lanetco                                      
+6E6000-6E6FFF                 (base 16)                     Lanetco                                      
+                                                            International Business Park                  
+                                                            Archamps  Haute savoie  74160                
+                                                            FR                                           
+
+00-50-C2                      (hex)                         SAIA Burgess Controls AG                     
+6FD000-6FDFFF                 (base 16)                     SAIA Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            Murten  FR  3280                             
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Microway                                     
+6CF000-6CFFFF                 (base 16)                     Microway                                     
+                                                            12 Richards Rd                               
+                                                            Plymouth  MA  02360                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lumistar Incorporated                        
+6D2000-6D2FFF                 (base 16)                     Lumistar Incorporated                        
+                                                            2701 Loker Ave West                          
+                                                            Carlsbad  CA  92010                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Becker Electronics GmbH                      
+6D5000-6D5FFF                 (base 16)                     Becker Electronics GmbH                      
+                                                            Barbarastrasse 3                             
+                                                            Friedrichsthal    66299                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         System LSI CO.Ltd.                           
+6B7000-6B7FFF                 (base 16)                     System LSI CO.Ltd.                           
+                                                            Nisso 15 Bld. 4F                             
+                                                            Yokohama  Kanagawa  222-0033                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         RGM SPA                                      
+6CD000-6CDFFF                 (base 16)                     RGM SPA                                      
+                                                            VIA BUCCARI 19-21                            
+                                                            GENOVA  GE  16156                            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         EMITALL Surveillance S.A,                    
+6CE000-6CEFFF                 (base 16)                     EMITALL Surveillance S.A,                    
+                                                            Rue du Théâtre 5                             
+                                                            Montreux  Vaud  1820                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         ESTEC Co.,Ltd.                               
+6BE000-6BEFFF                 (base 16)                     ESTEC Co.,Ltd.                               
+                                                            369-1, Kugu, Kasakake-cho                    
+                                                            Midori-city  Gunma  379-2312                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Epec Oy                                      
+6B8000-6B8FFF                 (base 16)                     Epec Oy                                      
+                                                            P.O. Box 194                                 
+                                                            Seinäjoki  Etelä-Pohjanmaa  60101            
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Qualisys AB                                  
+6AE000-6AEFFF                 (base 16)                     Qualisys AB                                  
+                                                            Packhusgatan 6                               
+                                                            Gothenburg    41113                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Hoer GmbH & Co. Industrie-Electronic KG      
+6A7000-6A7FFF                 (base 16)                     Hoer GmbH & Co. Industrie-Electronic KG      
+                                                            Mistelweg 8                                  
+                                                            Berlin    12357                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Navtech Radar Ltd                            
+698000-698FFF                 (base 16)                     Navtech Radar Ltd                            
+                                                            16 Home Farm                                 
+                                                            Wantage  Oxon  OX12 8PD                      
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Monarch Instrument                           
+697000-697FFF                 (base 16)                     Monarch Instrument                           
+                                                            15 Columbia Drive                            
+                                                            Amherst  NH  03031                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Initel srl                                   
+694000-694FFF                 (base 16)                     Initel srl                                   
+                                                            Via Battisti 22                              
+                                                            Cesano Maderno  Milano  20031                
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Ideus AB                                     
+69E000-69EFFF                 (base 16)                     Ideus AB                                     
+                                                            Box 133                                      
+                                                            Skövde    SE-54123                           
+                                                            SE                                           
+
+00-50-C2                      (hex)                         REASON Tecnologia S.A.                       
+684000-684FFF                 (base 16)                     REASON Tecnologia S.A.                       
+                                                            R. Delminda Silveira, 855                    
+                                                            Florianópolis  Santa Catarina  88025-500     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         4RF Communications Ltd                       
+6B3000-6B3FFF                 (base 16)                     4RF Communications Ltd                       
+                                                            26 Glover Street                             
+                                                            Ngauranga  Wellington  6031                  
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Mate Media Access Technologies               
+692000-692FFF                 (base 16)                     Mate Media Access Technologies               
+                                                            4, Hachoresh Street                          
+                                                            Yahud  Center  56470                         
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Interopix, Inc.                              
+691000-691FFF                 (base 16)                     Interopix, Inc.                              
+                                                            5050 Robert J Mathews Pkwy                   
+                                                            El Dorado Hills  CA  95762                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Thales UK                                    
+6AC000-6ACFFF                 (base 16)                     Thales UK                                    
+                                                            Manor Royal                                  
+                                                            London  West Sussex  RH10 9PZ                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Armida Technologies Corporation              
+6A9000-6A9FFF                 (base 16)                     Armida Technologies Corporation              
+                                                            2313 Lockhill Selma Rd #242                  
+                                                            San Antonio  TX  78230                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         DDS Elettronica srl                          
+672000-672FFF                 (base 16)                     DDS Elettronica srl                          
+                                                            Via Nicolò Biondo 171                        
+                                                            Modena    41100                              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Commet AB                                    
+682000-682FFF                 (base 16)                     Commet AB                                    
+                                                            Box 706                                      
+                                                            Sollentuna    19127                          
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Protech Optronics Co., Ltd.                  
+674000-674FFF                 (base 16)                     Protech Optronics Co., Ltd.                  
+                                                            4th Floor, No.82-3, Dongshun Street          
+                                                            Shulin City  Taipei county  238              
+                                                            TW                                           
+
+00-50-C2                      (hex)                         DSP DESIGN                                   
+669000-669FFF                 (base 16)                     DSP DESIGN                                   
+                                                            TAPTON PARK INNOVATION CENTRE                
+                                                            CHESTERFIELD  DERBYSHIRE  S41 0TZ            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         3DSP Corporation                             
+63A000-63AFFF                 (base 16)                     3DSP Corporation                             
+                                                            16271 Laguna Canyon Road                     
+                                                            Irvine  California  92618                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Omnitrol Networks, Inc.                      
+637000-637FFF                 (base 16)                     Omnitrol Networks, Inc.                      
+                                                            2063 Landings Drive                          
+                                                            Mountainview  CA  94043                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         HUNGAROCOM Telecommunication Ltd.            
+638000-638FFF                 (base 16)                     HUNGAROCOM Telecommunication Ltd.            
+                                                            Petzval Jozsef u. 52.                        
+                                                            Budapest    1119                             
+                                                            HU                                           
+
+00-50-C2                      (hex)                         dSPACE GmbH                                  
+636000-636FFF                 (base 16)                     dSPACE GmbH                                  
+                                                            Techologiepark 25                            
+                                                            Paderborn  North Rhine-Westphalia  33100     
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Cantion A/S                                  
+65E000-65EFFF                 (base 16)                     Cantion A/S                                  
+                                                            Skjernvej 4A                                 
+                                                            Aalborg  DK  9220                            
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Redfone Communications LLC                   
+65D000-65DFFF                 (base 16)                     Redfone Communications LLC                   
+                                                            9941 West Jessamine Street                   
+                                                            Miami  Fl.  33157                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         OpenPKG GmbH                                 
+658000-658FFF                 (base 16)                     OpenPKG GmbH                                 
+                                                            Weblinger Weg 28                             
+                                                            Dachau    85221                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Pan-STARRS                                   
+649000-649FFF                 (base 16)                     Pan-STARRS                                   
+                                                            2680 Woodlawn Dr.                            
+                                                            Honolulu  HI  96822                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fidelity Comtech, Inc.                       
+648000-648FFF                 (base 16)                     Fidelity Comtech, Inc.                       
+                                                            2400 Trade Centre Avenue                     
+                                                            Longmont  CO  80503                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         RoseTechnology A/S                           
+632000-632FFF                 (base 16)                     RoseTechnology A/S                           
+                                                            Ellegårdvej 36                               
+                                                            Sønderborg    6400                           
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Rice University                              
+633000-633FFF                 (base 16)                     Rice University                              
+                                                            6100 Main Street MS 380                      
+                                                            Houston  Texas  77005                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         QES                                          
+62F000-62FFFF                 (base 16)                     QES                                          
+                                                            Joensuunkatu 13                              
+                                                            Salo    24100                                
+                                                            FI                                           
+
+00-50-C2                      (hex)                         IAC                                          
+640000-640FFF                 (base 16)                     IAC                                          
+                                                            13029 Danielson Suite 200                    
+                                                            Poway  Ca.  92064                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Gradual Tecnologia Ltda.                     
+60A000-60AFFF                 (base 16)                     Gradual Tecnologia Ltda.                     
+                                                            Rua Attilio Giaretta, 110                    
+                                                            Itatiba  SP  13257-584                       
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Toptech Systems, Inc.                        
+609000-609FFF                 (base 16)                     Toptech Systems, Inc.                        
+                                                            280 Hunt Park Cove                           
+                                                            Longwood  FL  32750                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         NCI Technologies Inc.                        
+61B000-61BFFF                 (base 16)                     NCI Technologies Inc.                        
+                                                            636 Cure Boivin Blvd.                        
+                                                            Boisbriand  Quebec  J7G 2A7                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Intergrated Security Mfg. Ltd                
+618000-618FFF                 (base 16)                     Intergrated Security Mfg. Ltd                
+                                                            25-29 The Bell Centre                        
+                                                            Crawley  West Sussex  RH10 9FZ               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Procon Electronics                           
+62D000-62DFFF                 (base 16)                     Procon Electronics                           
+                                                            PO Box 164                                   
+                                                            Sydney  NSW  1730                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Proserv                                      
+614000-614FFF                 (base 16)                     Proserv                                      
+                                                            Strandveien 43                               
+                                                                                                         
+                                                            NO                                           
+
+00-50-C2                      (hex)                         ESEM Grünau GmbH & Co. KG                    
+5F2000-5F2FFF                 (base 16)                     ESEM Grünau GmbH & Co. KG                    
+                                                            Dornierstraße 6                              
+                                                            Markdorf  Baden-Württemberg  88677           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         AQUAROTTER A FRANKE COMPANY                  
+5ED000-5EDFFF                 (base 16)                     AQUAROTTER A FRANKE COMPANY                  
+                                                            Parkstrasse 1-5                              
+                                                            Ludwigsfelde  Brandenburg  14974             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DIAS Infrared GmbH                           
+5F0000-5F0FFF                 (base 16)                     DIAS Infrared GmbH                           
+                                                            Gostritzer Str. 63                           
+                                                            Dresden  Saxony  01217                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Info-Chip Communications Ltd.                
+5E8000-5E8FFF                 (base 16)                     Info-Chip Communications Ltd.                
+                                                            4403 Rupert Street                           
+                                                            Vancouver  BC  V5R2J1                        
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Telecom FM                                   
+607000-607FFF                 (base 16)                     Telecom FM                                   
+                                                            895 Plymouth Road                            
+                                                            Slough  Berkshire  SL1 4LP                   
+                                                            GB                                           
+
+00-50-C2                      (hex)                         CHAUVIN ARNOUX                               
+602000-602FFF                 (base 16)                     CHAUVIN ARNOUX                               
+                                                            la queue Devée                               
+                                                            REUX  PONT L'EVEQUE  14130                   
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Cerus Corp                                   
+603000-603FFF                 (base 16)                     Cerus Corp                                   
+                                                            2411 Stanwell Dr                             
+                                                            Concord  CA  94520                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         pikkerton GmbH                               
+5EF000-5EFFFF                 (base 16)                     pikkerton GmbH                               
+                                                            Lessingstrasse 79                            
+                                                            Berlin    13158                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Condre Corporation                           
+5EE000-5EEFFF                 (base 16)                     Condre Corporation                           
+                                                            15151 Technology Drive                       
+                                                            Eden Prairie  Minnesota  55344               
+                                                            US                                           
+
+00-50-C2                      (hex)                         RM Michaelides Software & Elektronik GmbH    
+5DC000-5DCFFF                 (base 16)                     RM Michaelides Software & Elektronik GmbH    
+                                                            Donaustrasse 14                              
+                                                            Fulda    36043                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Secure Systems & Services                    
+5DB000-5DBFFF                 (base 16)                     Secure Systems & Services                    
+                                                            24, Chemin de la Pouranque                   
+                                                            F-13752  LES PENNES MIRABEAU  CS30084        
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Cannon Technologies                          
+5D5000-5D5FFF                 (base 16)                     Cannon Technologies                          
+                                                            Queensway                                    
+                                                            Bournmouth  Hampshire  BH25 5NU              
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Buyang Electronics Industrial Co., Ltd.      
+5D4000-5D4FFF                 (base 16)                     Buyang Electronics Industrial Co., Ltd.      
+                                                            434-140 Oryu-Dong                            
+                                                            Incheon    404-300                           
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Automata Spa                                 
+5D0000-5D0FFF                 (base 16)                     Automata Spa                                 
+                                                            Via Carducci 705                             
+                                                            Caronno Pertusella  Varese  21042            
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Synrad, Inc.                                 
+5D7000-5D7FFF                 (base 16)                     Synrad, Inc.                                 
+                                                            4600 Campus Place                            
+                                                            Mukilteo  WA  98275                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Magal Senstar Inc.                           
+5DE000-5DEFFF                 (base 16)                     Magal Senstar Inc.                           
+                                                            43180 Osgood Rd.                             
+                                                            Fremont  CA  94539                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Crimson Microsystems, Inc.                   
+5D9000-5D9FFF                 (base 16)                     Crimson Microsystems, Inc.                   
+                                                            1277 N. Borregas Ave                         
+                                                            Sunnyvale  CA  94089                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Technische Alternative GmbH                  
+5C6000-5C6FFF                 (base 16)                     Technische Alternative GmbH                  
+                                                            Langestrasse 124                             
+                                                            Amaliendorf  Lower Austria  A-3872           
+                                                            AT                                           
+
+00-50-C2                      (hex)                         InSync Technology Ltd                        
+5C7000-5C7FFF                 (base 16)                     InSync Technology Ltd                        
+                                                            Festival Hall                                
+                                                            Petersfield  Hampshire  GU31 4DZ             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         LUMEL S.A.                                   
+5A3000-5A3FFF                 (base 16)                     LUMEL S.A.                                   
+                                                            UL. SULECHOWSKA 1                            
+                                                            ZIELONA Góra  WOJ. LUBUSKIE  65-022          
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Vestfold Butikkdata AS                       
+5A1000-5A1FFF                 (base 16)                     Vestfold Butikkdata AS                       
+                                                            Wirgenesveg 1                                
+                                                            BARKAKER  VESTFOLD  N-3157                   
+                                                            NO                                           
+
+00-50-C2                      (hex)                         HITECOM System                               
+5B3000-5B3FFF                 (base 16)                     HITECOM System                               
+                                                            (6F Kolon-Techno valley) 60-4, Gasan-Dong, Geumcheon-gu,
+                                                            Seoul    153-023                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Federal Electronics                          
+588000-588FFF                 (base 16)                     Federal Electronics                          
+                                                            75 Stamp Farm Road                           
+                                                            Cranston  Rhode Island  02921                
+                                                            US                                           
+
+00-50-C2                      (hex)                         ptswitch                                     
+57B000-57BFFF                 (base 16)                     ptswitch                                     
+                                                            1416 Tanaka Dr                               
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Software Technologies               
+577000-577FFF                 (base 16)                     Advanced Software Technologies               
+                                                            c/ Caleruega, 102 2° Planta                  
+                                                            Madrid    28033                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         nVent, Schroff GmbH                          
+57A000-57AFFF                 (base 16)                     nVent, Schroff GmbH                          
+                                                            Langenalber Strasse 96-100                   
+                                                            Straubenhardt    75334                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Toyota Motorsport GmbH                       
+584000-584FFF                 (base 16)                     Toyota Motorsport GmbH                       
+                                                            Toyota-Allee 7                               
+                                                            Köln  NRW  50858                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         DSS Networks, Inc.                           
+59D000-59DFFF                 (base 16)                     DSS Networks, Inc.                           
+                                                            23 Spectrum Pointe Drive                     
+                                                            Lake Forest  CA  92630                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Buyang Electronics Industrial co.,Ltd.       
+580000-580FFF                 (base 16)                     Buyang Electronics Industrial co.,Ltd.       
+                                                            Oryu-Dong                                    
+                                                            Seo-Ku  Incheon  404-300                     
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Chell Instruments Ltd                        
+572000-572FFF                 (base 16)                     Chell Instruments Ltd                        
+                                                            Folgate House                                
+                                                            North Walsham  Norfolk  NR28 0AJ             
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Bundesamt für Strahlenschutz                 
+598000-598FFF                 (base 16)                     Bundesamt für Strahlenschutz                 
+                                                            Rosastraße 9                                 
+                                                            Freiburg  NA  79098                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Nautel Limited                               
+597000-597FFF                 (base 16)                     Nautel Limited                               
+                                                            10089 Peggy's Cove Road                      
+                                                            Hackett's Cove  Nova Scotia  B3Z3J4          
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Innovative Neurotroncs                       
+551000-551FFF                 (base 16)                     Innovative Neurotroncs                       
+                                                            2 Bethesda Metro Center                      
+                                                            Bethesda  MD  20814                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Silent System                                
+54D000-54DFFF                 (base 16)                     Silent System                                
+                                                            Sumikawa 5-5-1-6 Minamiku                    
+                                                            Sapporo  Hokkaido  005-0005                  
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Targeted Technologies, LLC                   
+56C000-56CFFF                 (base 16)                     Targeted Technologies, LLC                   
+                                                            273 Azalea Road                              
+                                                            Mobile  AL  36609                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Computrol Fuel Systems Inc.                  
+56D000-56DFFF                 (base 16)                     Computrol Fuel Systems Inc.                  
+                                                            8537 Commerce Court                          
+                                                            Burnaby  BC  V5A 4N4                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Weinzierl Engineering GmbH                   
+554000-554FFF                 (base 16)                     Weinzierl Engineering GmbH                   
+                                                            Bahnhofstrasse 6                             
+                                                            Tyrlaching  Bayern  84558                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+55C000-55CFFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            US                                           
+
+00-50-C2                      (hex)                         Marposs SPA                                  
+53C000-53CFFF                 (base 16)                     Marposs SPA                                  
+                                                            Via Saliceto 13                              
+                                                            Bentivoglio  Bologna  40010                  
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Teleks Co. Ltd.                              
+53B000-53BFFF                 (base 16)                     Teleks Co. Ltd.                              
+                                                            ul. Dostojevskogo, 15                        
+                                                            St.Petersburg    191002                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         AVerMedia Technologies, Inc.                 
+542000-542FFF                 (base 16)                     AVerMedia Technologies, Inc.                 
+                                                            7F.,No. 137, Jian Yi Rd.                     
+                                                            Chung Ho City  Taipei Hsien  23585           
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Zetera                                       
+544000-544FFF                 (base 16)                     Zetera                                       
+                                                            16842 Von Karman Ave., Suite 100             
+                                                            Irvine  CA  92606                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Universidad de Chile Facultad de Medicina    
+546000-546FFF                 (base 16)                     Universidad de Chile Facultad de Medicina    
+                                                            Avda. Independencia 1027                     
+                                                            Santiago  RM  8380453                        
+                                                            CL                                           
+
+00-50-C2                      (hex)                         Gesellschaft für  Rationalisierung und Rechentechnik mbH
+52F000-52FFFF                 (base 16)                     Gesellschaft für  Rationalisierung und Rechentechnik mbH
+                                                            Ob der Eck 4                                 
+                                                            Gütenbach  Baden-Württemberg  78148          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Innopsys                                     
+54B000-54BFFF                 (base 16)                     Innopsys                                     
+                                                            ZA Activestre                                
+                                                            Carbonne    31390                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Sintecnos srl                                
+54C000-54CFFF                 (base 16)                     Sintecnos srl                                
+                                                            Via Boncompagni, 34                          
+                                                            Milan    20139                               
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Mark IV IDS Corp.                            
+522000-522FFF                 (base 16)                     Mark IV IDS Corp.                            
+                                                            5959 Ambler Drive                            
+                                                            Mississauga  Ontario  L4W 2N3                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         McCain Traffic Supply                        
+520000-520FFF                 (base 16)                     McCain Traffic Supply                        
+                                                            2365 Oak Ridge Way                           
+                                                            Vista  CA  92081                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         VASTech                                      
+525000-525FFF                 (base 16)                     VASTech                                      
+                                                            PO Box 36124                                 
+                                                            Menlo Park  Gauteng  0102                    
+                                                            ZA                                           
+
+00-50-C2                      (hex)                         Monaghan Engineering, Inc.                   
+515000-515FFF                 (base 16)                     Monaghan Engineering, Inc.                   
+                                                            862 Las Colinas Drive                        
+                                                            Dripping Springs  Texas  78620               
+                                                            US                                           
+
+00-50-C2                      (hex)                         Tecna Srl                                    
+511000-511FFF                 (base 16)                     Tecna Srl                                    
+                                                            Via Statale Sud 115                          
+                                                            Mirandola  Modena  41037                     
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Linear Acoustic, Inc                         
+512000-512FFF                 (base 16)                     Linear Acoustic, Inc                         
+                                                            354 N Prince St                              
+                                                            Lancaster  PA  17603                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         VELUX                                        
+51D000-51DFFF                 (base 16)                     VELUX                                        
+                                                            Baekgaardsvej 40                             
+                                                            Skjern    6900                               
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Christ Elektronik GmbH                       
+518000-518FFF                 (base 16)                     Christ Elektronik GmbH                       
+                                                            Alpenstraße 34                               
+                                                            Memmingen  Bavaria  87700                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Orenco Systems, Inc.                         
+500000-500FFF                 (base 16)                     Orenco Systems, Inc.                         
+                                                            814 Airway Ave.                              
+                                                            Sutherlin  OR  97479                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Lab X Technologies, LLC                      
+4ED000-4EDFFF                 (base 16)                     Lab X Technologies, LLC                      
+                                                            176 Anderson Avenue                          
+                                                            Rochester  New York  14607                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Prodco International Inc.                    
+4F8000-4F8FFF                 (base 16)                     Prodco International Inc.                    
+                                                            4529 De Castille                             
+                                                            Montreal  Quebec  H1H1Y3                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         RTDS Technologies Inc.                       
+4F9000-4F9FFF                 (base 16)                     RTDS Technologies Inc.                       
+                                                            100-150 Innovation Drive                     
+                                                            Winnipeg  Manitoba  R3T 2E1                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Micro Connect Pty Ltd                        
+507000-507FFF                 (base 16)                     Micro Connect Pty Ltd                        
+                                                            22 Gardenia Place                            
+                                                            FOREST GLEN  QLD  4556                       
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Yarg Biometrics Limited                      
+4CA000-4CAFFF                 (base 16)                     Yarg Biometrics Limited                      
+                                                            141 St James Road                            
+                                                            Glasgow  Scotland  G4 0LT                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Transbit Sp.z o.o.                           
+4C7000-4C7FFF                 (base 16)                     Transbit Sp.z o.o.                           
+                                                            ul. Przyczolkowa 109A                        
+                                                            Warsaw  Mazowieckie  02-968                  
+                                                            PL                                           
+
+00-50-C2                      (hex)                         MEDIORNET GmbH                               
+4DA000-4DAFFF                 (base 16)                     MEDIORNET GmbH                               
+                                                            Hietzinger Kai 67                            
+                                                            Vienna    1130                               
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Alfing Montagetechnik GmbH                   
+4DB000-4DBFFF                 (base 16)                     Alfing Montagetechnik GmbH                   
+                                                            Auguste-Kessler-Straße 20                    
+                                                            Aalen  Baden-Württemberg  73433              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sedo Systems Ltd                             
+4E5000-4E5FFF                 (base 16)                     Sedo Systems Ltd                             
+                                                            19 Hertford Road                             
+                                                            Stevenage  HERTS  SG2 8RS                    
+                                                            GB                                           
+
+00-50-C2                      (hex)                         PMC                                          
+4EA000-4EAFFF                 (base 16)                     PMC                                          
+                                                            56, Avenue Raspail                           
+                                                            Saint Maur    94100                          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Twoway CATV SERVICE INC.                     
+4D2000-4D2FFF                 (base 16)                     Twoway CATV SERVICE INC.                     
+                                                            41 Wu Kung 6 Rd., Wu Ku Industrial Park,     
+                                                            TPI Hsien    248                             
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Applied Research Laboratories: UT            
+4E2000-4E2FFF                 (base 16)                     Applied Research Laboratories: UT            
+                                                            10000 Burnet Rd.                             
+                                                            Austin  TX  78758                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Armorlink Co .Ltd                            
+49E000-49EFFF                 (base 16)                     Armorlink Co .Ltd                            
+                                                            No. 515 of Xinzhuang Industry Park Shenfu Road
+                                                            Shanghai Province  Shanghai  201108          
+                                                            CN                                           
+
+00-50-C2                      (hex)                         vg controls, inc                             
+49B000-49BFFF                 (base 16)                     vg controls, inc                             
+                                                            11 butternut drive                           
+                                                            vernon  new jersey  07462                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Matrix Audio Designs                         
+4B4000-4B4FFF                 (base 16)                     Matrix Audio Designs                         
+                                                            20 Hamilton Rd                               
+                                                            Barrie  Ontario  L4N 8Y5                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         General Resources Co., LTD.                  
+4B6000-4B6FFF                 (base 16)                     General Resources Co., LTD.                  
+                                                            B1,No. 15,Lane 174,Hsin-Ming Rd.,Nei Hu      
+                                                            Taipei    114                                
+                                                            TW                                           
+
+00-50-C2                      (hex)                         ANSA Corporation                             
+4B3000-4B3FFF                 (base 16)                     ANSA Corporation                             
+                                                            17F, No. 738, Chung Cheng Road               
+                                                            Chung Ho City  Taipei County  235            
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Valley Tecnologia                            
+4B5000-4B5FFF                 (base 16)                     Valley Tecnologia                            
+                                                             R. Manoel Soares Sebastiao, 410             
+                                                            São Paulo  SP  04775-160                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         TESLA, a.s.                                  
+4B2000-4B2FFF                 (base 16)                     TESLA, a.s.                                  
+                                                            Podebradska 56/186                           
+                                                              Praha 9  180 66                            
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Teledyne Monitor Labs                        
+4A5000-4A5FFF                 (base 16)                     Teledyne Monitor Labs                        
+                                                            5310 N. Pioneer Road                         
+                                                            Gibsonia  PA  15044                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         iseg Spezialelektronik GmbH                  
+4A7000-4A7FFF                 (base 16)                     iseg Spezialelektronik GmbH                  
+                                                            Bautzner Landstr. 23                         
+                                                            Radeberg OT Rossendorf    01454              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Kooltech LLC                                 
+484000-484FFF                 (base 16)                     Kooltech LLC                                 
+                                                            336 Atlantic Avenue                          
+                                                            East Rockaway  NY  11518                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         PRIAMUS SYSTEM TECHNOLOGIES AG               
+482000-482FFF                 (base 16)                     PRIAMUS SYSTEM TECHNOLOGIES AG               
+                                                            Rheinweg 4                                   
+                                                              Schaffhausen  8200                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         TRAFSYS AS                                   
+492000-492FFF                 (base 16)                     TRAFSYS AS                                   
+                                                            Fabrikkgaten 5                               
+                                                            Bergen  Hordaland  5059                      
+                                                            NO                                           
+
+00-50-C2                      (hex)                         Unlimited Bandwidth LLC                      
+479000-479FFF                 (base 16)                     Unlimited Bandwidth LLC                      
+                                                            1320 W. Northwest Highway                    
+                                                            Palatine  Illinois  60067                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Quartet Technology, Inc.                     
+498000-498FFF                 (base 16)                     Quartet Technology, Inc.                     
+                                                            1934 Lakeview Avenue                         
+                                                            Dracut  MA  01826                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         ISE GmbH                                     
+46A000-46AFFF                 (base 16)                     ISE GmbH                                     
+                                                            Kaiserstrasse 14                             
+                                                            Oldenburg  Niedersachsen  26122              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Network I/O                                  
+468000-468FFF                 (base 16)                     Network I/O                                  
+                                                            6703 Rain Creek Parkway                      
+                                                            Austin  TX  78759                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         BiPOM Electronics, Inc.                      
+469000-469FFF                 (base 16)                     BiPOM Electronics, Inc.                      
+                                                            16301 Blue Ridge Road                        
+                                                            Missouri City  TEXAS  77489                  
+                                                            US                                           
+
+00-50-C2                      (hex)                         Funkwerk plettac electronic GmbH             
+45A000-45AFFF                 (base 16)                     Funkwerk plettac electronic GmbH             
+                                                            Wuerzburger Strasse 150                      
+                                                            Fuerth  Bavaria  90766                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Venue 1, Inc.                                
+474000-474FFF                 (base 16)                     Venue 1, Inc.                                
+                                                            5000 SW 52nd Street                          
+                                                            Davie  Florida  33314                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Avenir Technologies Inc.                     
+46E000-46EFFF                 (base 16)                     Avenir Technologies Inc.                     
+                                                            20 Riverview Drive                           
+                                                            Norwalk  CT  06850                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pixtree Technologies, inc.                   
+471000-471FFF                 (base 16)                     Pixtree Technologies, inc.                   
+                                                            ShinChon-Dong SeoDaeMun-Gu                   
+                                                            Seoul    120-749                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Enconair Ecological Chambers Inc.            
+450000-450FFF                 (base 16)                     Enconair Ecological Chambers Inc.            
+                                                            474 Jarvis Avenue                            
+                                                            Winnipeg  Manitoba  R2W 3A8                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Pickering Laboratories                       
+443000-443FFF                 (base 16)                     Pickering Laboratories                       
+                                                            1280 space park way                          
+                                                            mountain view  california  94943             
+                                                            US                                           
+
+00-50-C2                      (hex)                         A3IP                                         
+43B000-43BFFF                 (base 16)                     A3IP                                         
+                                                            Batiment Placel, route de vannes             
+                                                            SAUTRON  Pays de la loire  44880             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         HAMEG GmbH                                   
+451000-451FFF                 (base 16)                     HAMEG GmbH                                   
+                                                            Industriestr. 6                              
+                                                            Mainhausen    63533                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         EFSYS                                        
+421000-421FFF                 (base 16)                     EFSYS                                        
+                                                            60, rue de la bolle                          
+                                                            Saint-Dié des Vosges  Vosges  88100          
+                                                            FR                                           
+
+00-50-C2                      (hex)                         ads-tec GmbH                                 
+422000-422FFF                 (base 16)                     ads-tec GmbH                                 
+                                                            Raiffeisenstraße 14                          
+                                                            Leinfelden-Echterdingen  Baden-Württemberg  70771
+                                                            US                                           
+
+00-50-C2                      (hex)                         Videotek Sistemas Eletronicos Ltda.          
+41E000-41EFFF                 (base 16)                     Videotek Sistemas Eletronicos Ltda.          
+                                                            Rua Atilio Piffer, 513                       
+                                                            São Paulo  SP  02516-000                     
+                                                            BR                                           
+
+00-50-C2                      (hex)                         Infrasafe, Inc.                              
+41C000-41CFFF                 (base 16)                     Infrasafe, Inc.                              
+                                                            12612 Challenger Pkwy                        
+                                                            Orlando  FL  32826                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Idetech Europe S.A.                          
+433000-433FFF                 (base 16)                     Idetech Europe S.A.                          
+                                                            Pedrosa C nº23 (Polígono Pedrosa)            
+                                                            Hospitalet de Llobregat  BARCELONA  08908    
+                                                            ES                                           
+
+00-50-C2                      (hex)                         PowerWAN, Inc                                
+437000-437FFF                 (base 16)                     PowerWAN, Inc                                
+                                                            2445 Faber Place                             
+                                                            Palo Alto  California  94303                 
+                                                            US                                           
+
+00-50-C2                      (hex)                         Promess Incorporated                         
+401000-401FFF                 (base 16)                     Promess Incorporated                         
+                                                            11429 Grand River Road                       
+                                                            Brighton  MI  48116                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         SELCO s.r.l.                                 
+416000-416FFF                 (base 16)                     SELCO s.r.l.                                 
+                                                            Via Palladio 19                              
+                                                            Onara di Tombolo  PADOVA  35010              
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Bluewater Systems Ltd                        
+41A000-41AFFF                 (base 16)                     Bluewater Systems Ltd                        
+                                                            119 Armagh Street                            
+                                                            Christchurch  Canterbury  8001               
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Guralp Systems Limited                       
+405000-405FFF                 (base 16)                     Guralp Systems Limited                       
+                                                            3 Midas House                                
+                                                            Reading  Berkshire  RG7 8EA                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         HARTMANN software GbR                        
+3FD000-3FDFFF                 (base 16)                     HARTMANN software GbR                        
+                                                            Johann-Feilner-Str.1                         
+                                                            Mistelbach  Bayern  95511                    
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Revolution Education Ltd                     
+3E7000-3E7FFF                 (base 16)                     Revolution Education Ltd                     
+                                                            4 Old Dairy Business Centre                  
+                                                            Bath  BNES  BA2 3LR                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Teneros                                      
+3EC000-3ECFFF                 (base 16)                     Teneros                                      
+                                                            215 Castro Street - 3rd Floor                
+                                                            Mountain View  California  94041             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advantage R&D                                
+3F7000-3F7FFF                 (base 16)                     Advantage R&D                                
+                                                            16210 West Hardy                             
+                                                            Houston  Texas  77060                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         CSIRO - Division of Exploration and Mining   
+3E3000-3E3FFF                 (base 16)                     CSIRO - Division of Exploration and Mining   
+                                                            PO Box 883                                   
+                                                            Kenmore  QLD  4069                           
+                                                            AU                                           
+
+00-50-C2                      (hex)                         NeuLion Incorporated                         
+3E1000-3E1FFF                 (base 16)                     NeuLion Incorporated                         
+                                                            1600 Old Country Road                        
+                                                            Plainview  NY  11803                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Braintronics BV                              
+3D1000-3D1FFF                 (base 16)                     Braintronics BV                              
+                                                            Gildemark 130                                
+                                                            Almere    1351 HL                            
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Wisnu and Supak Co.Ltd.                      
+3D4000-3D4FFF                 (base 16)                     Wisnu and Supak Co.Ltd.                      
+                                                            102/111-112 Moo-Ban Sinpattanathanee         
+                                                            Jatujak  Bangkok  10900                      
+                                                            TH                                           
+
+00-50-C2                      (hex)                         Comlab Inc.                                  
+3D6000-3D6FFF                 (base 16)                     Comlab Inc.                                  
+                                                            2300, Leon-Harmel                            
+                                                            Quebec    G1N 4L2                            
+                                                            CA                                           
+
+00-50-C2                      (hex)                         IMAGO Technologies GmbH                      
+3BB000-3BBFFF                 (base 16)                     IMAGO Technologies GmbH                      
+                                                            Strassheimer Strasse 45                      
+                                                            Friedberg    D-61169                         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Oy Stinghorn Ltd                             
+3E0000-3E0FFF                 (base 16)                     Oy Stinghorn Ltd                             
+                                                            Stinghorn                                    
+                                                            LAPPEENRANTA    53101                        
+                                                            FI                                           
+
+00-50-C2                      (hex)                         Mindspeed Technologies                       
+3B7000-3B7FFF                 (base 16)                     Mindspeed Technologies                       
+                                                            8 Technology Drive                           
+                                                            Westborough  Massachusetts  01581            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Keith & Koep GmbH                            
+3B8000-3B8FFF                 (base 16)                     Keith & Koep GmbH                            
+                                                            Koenigsberger Str. 2                         
+                                                            Wuppertal  D  42277                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Tennessee Valley Authority                   
+3B2000-3B2FFF                 (base 16)                     Tennessee Valley Authority                   
+                                                            Computer Engineering TVAN                    
+                                                            Chattanooga  TN  37402                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         A.R.G ElectroDesign Ltd                      
+39E000-39EFFF                 (base 16)                     A.R.G ElectroDesign Ltd                      
+                                                            Querns Business Centre                       
+                                                            Cirencester  Gloucestershire  GL7 1RT        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         DigitalDeck, Inc.                            
+39D000-39DFFF                 (base 16)                     DigitalDeck, Inc.                            
+                                                            3 Twin Dolphin Drive, Suite 160              
+                                                            Redwood City  CA  94065                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Westronic Systems Inc.                       
+3A9000-3A9FFF                 (base 16)                     Westronic Systems Inc.                       
+                                                            #1, 1715 - 27th Ave NE                       
+                                                            Calgary  AB  T2E 7E1                         
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Networked Robotics Corporation               
+3AA000-3AAFFF                 (base 16)                     Networked Robotics Corporation               
+                                                            825 Chicago Avenue Suite F                   
+                                                            Evanston  Illinois  60202                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vegas Amusement                              
+3A2000-3A2FFF                 (base 16)                     Vegas Amusement                              
+                                                            P.O. Box 11                                  
+                                                            Mountain Rest  SC  29664                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Elektrotechnik & Elektronik Oltmann GmbH     
+3A7000-3A7FFF                 (base 16)                     Elektrotechnik & Elektronik Oltmann GmbH     
+                                                            Gartenfelder Str. 29                         
+                                                            Berlin    D-13599                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         InAccess Networks                            
+3AC000-3ACFFF                 (base 16)                     InAccess Networks                            
+                                                            230 Sigrou Avenue                            
+                                                            Kalithea  Athens  17672                      
+                                                            GR                                           
+
+00-50-C2                      (hex)                         MANGO DSP Ltd.                               
+397000-397FFF                 (base 16)                     MANGO DSP Ltd.                               
+                                                            8 HARATOM St.                                
+                                                            JERUSALEM    91450                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         RapidWave Inc.                               
+396000-396FFF                 (base 16)                     RapidWave Inc.                               
+                                                            6296A San Ignacio Ave.                       
+                                                            San Jose  CA  95119                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Advanced Micro Controls Inc.                 
+399000-399FFF                 (base 16)                     Advanced Micro Controls Inc.                 
+                                                            20 Gear Drive                                
+                                                            Terryville  CT  06786                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Xycom VME                                    
+377000-377FFF                 (base 16)                     Xycom VME                                    
+                                                            710 N. Maple Road                            
+                                                            Saline  MI  48176                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         CLEODE                                       
+376000-376FFF                 (base 16)                     CLEODE                                       
+                                                            5 rue Louis de Broglie                       
+                                                            LANNION    22300                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Companion Worlds, inc.                       
+373000-373FFF                 (base 16)                     Companion Worlds, inc.                       
+                                                            10171 Carmen Road                            
+                                                            Cupertino  CA  95014                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Embedtronics Enterprise                      
+38A000-38AFFF                 (base 16)                     Embedtronics Enterprise                      
+                                                            16 Jalan Krian                               
+                                                            10400  Penang                                
+                                                            MY                                           
+
+00-50-C2                      (hex)                         Nordic Alarm AB                              
+38E000-38EFFF                 (base 16)                     Nordic Alarm AB                              
+                                                            Englundavägen 11                             
+                                                            Solna    17141                               
+                                                            SE                                           
+
+00-50-C2                      (hex)                         InterBridge,Inc.                             
+38B000-38BFFF                 (base 16)                     InterBridge,Inc.                             
+                                                            Inabe                                        
+                                                            Ina  Nagano  396-0011                        
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Ratotec GmbH                                 
+35C000-35CFFF                 (base 16)                     Ratotec GmbH                                 
+                                                            Steinfurt 39                                 
+                                                            Stolberg    522222                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Contec                                       
+361000-361FFF                 (base 16)                     Contec                                       
+                                                            Burleska 3a                                  
+                                                            Warsaw    01-939                             
+                                                            PL                                           
+
+00-50-C2                      (hex)                         Advanced Si-Net Co., LTD.                    
+35A000-35AFFF                 (base 16)                     Advanced Si-Net Co., LTD.                    
+                                                            9F-2, No. 245, Sec. 3, Roosevelt Rd.         
+                                                            Taipei  Da-an District  106                  
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Baytech Cinema                               
+356000-356FFF                 (base 16)                     Baytech Cinema                               
+                                                            2755 Campus Drive                            
+                                                            San Mateo  CA  94403                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         LUCEO                                        
+352000-352FFF                 (base 16)                     LUCEO                                        
+                                                            16 Rue Laënnec                               
+                                                            Vern Sur Seiche    35770                     
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Kinesys Projects Limited                     
+350000-350FFF                 (base 16)                     Kinesys Projects Limited                     
+                                                            The Business Village                         
+                                                            LONDON    SW18 4JQ                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Crossing Informationssysteme GmbH            
+353000-353FFF                 (base 16)                     Crossing Informationssysteme GmbH            
+                                                            Schlesische Str. 26                          
+                                                            Berlin    10997                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Ecutel Systems, Inc.                         
+34B000-34BFFF                 (base 16)                     Ecutel Systems, Inc.                         
+                                                            2300 Corporate Park Drive                    
+                                                            Herndon  VA  20171                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         RISCO Group                                  
+36C000-36CFFF                 (base 16)                     RISCO Group                                  
+                                                            14 Hachoma                                   
+                                                            Rishon Letzion    75655                      
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Golden River Traffic                         
+336000-336FFF                 (base 16)                     Golden River Traffic                         
+                                                            6 Talisman Business Centre                   
+                                                            Bicester  OXON  OX26 6HR                     
+                                                            GB                                           
+
+00-50-C2                      (hex)                         ETI                                          
+337000-337FFF                 (base 16)                     ETI                                          
+                                                            272-20 Taejun-Dong                           
+                                                            Kwang Joo  Kyung Ki-Do  464-808              
+                                                            KR                                           
+
+00-50-C2                      (hex)                         PULTRONICS                                   
+32F000-32FFFF                 (base 16)                     PULTRONICS                                   
+                                                            5375, PARE str.  #200                        
+                                                            MONTREAL  QUEBEC  H4P 1P7                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         PUNJAB COMMUNICATIONS LTD                    
+332000-332FFF                 (base 16)                     PUNJAB COMMUNICATIONS LTD                    
+                                                            B-91,INDUSTRIAL AREA, PHASE 8,               
+                                                            SAS NAGAR  PUNJAB  160059                    
+                                                            IN                                           
+
+00-50-C2                      (hex)                         Virtu                                        
+340000-340FFF                 (base 16)                     Virtu                                        
+                                                            Auke Vleerstraat 1                           
+                                                            Enschede  OV  7521 PE                        
+                                                            NL                                           
+
+00-50-C2                      (hex)                         MicroBee Systems, Inc                        
+314000-314FFF                 (base 16)                     MicroBee Systems, Inc                        
+                                                            9414 Danese Lane SE                          
+                                                            Huntsville  AL  35803                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         SAIA Burgess Controls AG                     
+313000-313FFF                 (base 16)                     SAIA Burgess Controls AG                     
+                                                            Bahnhofstrasse 18                            
+                                                            3280 Murten                                  
+                                                            CH                                           
+
+00-50-C2                      (hex)                         EuroDesign embedded technologies GmbH        
+302000-302FFF                 (base 16)                     EuroDesign embedded technologies GmbH        
+                                                            Waldstraße 4A                                
+                                                            Kirchdorf a.d. Amper  Bayern  85414          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         CI Systems Ltd.                              
+303000-303FFF                 (base 16)                     CI Systems Ltd.                              
+                                                            P.O.Box 147                                  
+                                                            Migdal HaEmek    10551                       
+                                                            IL                                           
+
+00-50-C2                      (hex)                         American Microsystems, Ltd.                  
+2FD000-2FDFFF                 (base 16)                     American Microsystems, Ltd.                  
+                                                            2190 Regal Parkway                           
+                                                            Euless  Texas  76040                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Geotech Instruments, LLC                     
+31F000-31FFFF                 (base 16)                     Geotech Instruments, LLC                     
+                                                            10755 Sanden Drive                           
+                                                            Dallas  TX  75238                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Innings Telecom Inc.                         
+30A000-30AFFF                 (base 16)                     Innings Telecom Inc.                         
+                                                            1241 Denison Street                          
+                                                            Markham  Ontario  L3R 4B4                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Datacon                                      
+31B000-31BFFF                 (base 16)                     Datacon                                      
+                                                            Instrasse 6                                  
+                                                            Radfeld  Tirol  6240                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         CHENGDU  BOOK DIGITAL CO., LTD               
+2EC000-2ECFFF                 (base 16)                     CHENGDU  BOOK DIGITAL CO., LTD               
+                                                            9/F, BLOCK C, SKYWORTH BLD. SCI &            
+                                                            SHENZHEN  GUANGDONG  518057                  
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Crossbow Technology, Inc.                    
+2F3000-2F3FFF                 (base 16)                     Crossbow Technology, Inc.                    
+                                                            41 Daggett Drive                             
+                                                            San Jose  CA  95134                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Clifford Chance LLP                          
+2F6000-2F6FFF                 (base 16)                     Clifford Chance LLP                          
+                                                            Canary Wharf                                 
+                                                            London  UK  E14 5JJ                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Private                                      
+2D9000-2D9FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         Transtech DSP                                
+2E5000-2E5FFF                 (base 16)                     Transtech DSP                                
+                                                            Manor Courtyard                              
+                                                            High Wycombe  Bucks  HP13 5RE                
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Elman srl                                    
+2C5000-2C5FFF                 (base 16)                     Elman srl                                    
+                                                            Via di Valle Caia, km 4.700                  
+                                                            Pomezia  Roma  00040                         
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Initial Electronic Security Systems          
+2C6000-2C6FFF                 (base 16)                     Initial Electronic Security Systems          
+                                                            Shadsworth Road                              
+                                                            Blackburn  Lancashire  BB1 2PR               
+                                                            GB                                           
+
+00-50-C2                      (hex)                         WIS Technologies                             
+2D6000-2D6FFF                 (base 16)                     WIS Technologies                             
+                                                            683 River Oaks Parkway                       
+                                                            San Jose  CA  95134                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Digital SP Ltd                               
+2C3000-2C3FFF                 (base 16)                     Digital SP Ltd                               
+                                                            Heathcourt                                   
+                                                            Ballater    AB355SF                          
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Uster Technologies AG                        
+2BC000-2BCFFF                 (base 16)                     Uster Technologies AG                        
+                                                            Wilstrasse 11                                
+                                                            Uster                                        
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Siliquent Technologies Ltd                   
+2C7000-2C7FFF                 (base 16)                     Siliquent Technologies Ltd                   
+                                                            33 Bezalel St.                               
+                                                            Ramat-Gan    52521                           
+                                                            IL                                           
+
+00-50-C2                      (hex)                         SELCO                                        
+2C8000-2C8FFF                 (base 16)                     SELCO                                        
+                                                            ZI DU VAL D OMBREE                           
+                                                            COMBREE    49520                             
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Polatis Ltd                                  
+2B4000-2B4FFF                 (base 16)                     Polatis Ltd                                  
+                                                            332/2 Cambridge Science Park,                
+                                                            Cambridge    CB4 0BZ                         
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Hobbes Computer Network Accessories          
+2B5000-2B5FFF                 (base 16)                     Hobbes Computer Network Accessories          
+                                                            2015 S. Myrtle Ave.                          
+                                                            Monrovia  CA  91016                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         CSA  Computer & Antriebstechnik GmbH         
+2AF000-2AFFFF                 (base 16)                     CSA  Computer & Antriebstechnik GmbH         
+                                                            RHEINSTRASSE  7E                             
+                                                            TELTOW  BRANDENBURG  D-14513                 
+                                                            DE                                           
+
+00-50-C2                      (hex)                         ABB T&D Spa                                  
+2AD000-2ADFFF                 (base 16)                     ABB T&D Spa                                  
+                                                            division SACE T.M.S.                         
+                                                            Dalmine  Bergamo  24044                      
+                                                            IT                                           
+
+00-50-C2                      (hex)                         BBI Engineering, Inc.                        
+2AC000-2ACFFF                 (base 16)                     BBI Engineering, Inc.                        
+                                                            241 Quint Street                             
+                                                            San Francisco  CA  94124                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Telda Electronics                            
+2B0000-2B0FFF                 (base 16)                     Telda Electronics                            
+                                                            #102 Electronics Bldg. 220-10, Buen 2Dong, Kangbuk-Ku
+                                                            Seoul    142-705                             
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Septier Communication Ltd                    
+2A5000-2A5FFF                 (base 16)                     Septier Communication Ltd                    
+                                                            POB 7603                                     
+                                                            Petach Tikva    49170                        
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Sterling Industry Consult GmbH               
+2A0000-2A0FFF                 (base 16)                     Sterling Industry Consult GmbH               
+                                                            Lindenstr. 170                               
+                                                            Itzehoe    D 25524                           
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IPITEK                                       
+024000-024FFF                 (base 16)                     IPITEK                                       
+                                                            2330 Faraday Ave                             
+                                                            Carlsbad  CA  920                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Packet Techniques Inc.                       
+29A000-29AFFF                 (base 16)                     Packet Techniques Inc.                       
+                                                            223 North 12th St #314B                      
+                                                            Tampa  Florida  33602                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ACD Elektronik GmbH                          
+29B000-29BFFF                 (base 16)                     ACD Elektronik GmbH                          
+                                                            Industriegebiet Engelberg 2                  
+                                                            Achstetten    88480                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         2N TELEKOMUNIKACE a.s.                       
+29C000-29CFFF                 (base 16)                     2N TELEKOMUNIKACE a.s.                       
+                                                            Modranska 621                                
+                                                            Prague 4  Prague  143 01                     
+                                                            CZ                                           
+
+00-50-C2                      (hex)                         Tattile srl                                  
+28E000-28EFFF                 (base 16)                     Tattile srl                                  
+                                                            Via Trento 127/129                           
+                                                            Capriano del Colle  Brescia  25020           
+                                                            IT                                           
+
+00-50-C2                      (hex)                         KINETICS                                     
+297000-297FFF                 (base 16)                     KINETICS                                     
+                                                            P.O.BOX 50                                   
+                                                            BEN-GURION AIRPORT    79100                  
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Allen Martin Conservation Ltd                
+267000-267FFF                 (base 16)                     Allen Martin Conservation Ltd                
+                                                            504 Dudley Road                              
+                                                            Wolverhampton  West Midlands  WV2 3AA        
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Maestro Pty Ltd                              
+27A000-27AFFF                 (base 16)                     Maestro Pty Ltd                              
+                                                            925 Macs Reef Raod                           
+                                                            Bywong  NSW  2621                            
+                                                            AU                                           
+
+00-50-C2                      (hex)                         PATLITE Corporation                          
+279000-279FFF                 (base 16)                     PATLITE Corporation                          
+                                                            3-50 Wakabayashi-cho                         
+                                                            Yao-shi  Osaka  581-0038                     
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Digital Recorders Inc                        
+26F000-26FFFF                 (base 16)                     Digital Recorders Inc                        
+                                                            4018 Patriot Drive                           
+                                                            Durham  NC  27703                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Technisyst Pty Ltd                           
+269000-269FFF                 (base 16)                     Technisyst Pty Ltd                           
+                                                            Level 4, 175 Eagle Street                    
+                                                            Brisbane  Queensland  4001                   
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Verex Technology                             
+272000-272FFF                 (base 16)                     Verex Technology                             
+                                                            5201 Explorer Drive                          
+                                                            Mississauga  Ontario  L4W 4H1                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Supertel                                     
+24C000-24CFFF                 (base 16)                     Supertel                                     
+                                                            38a, Petrogradskaya emb.                     
+                                                            St.Petersburg    197101                      
+                                                            RU                                           
+
+00-50-C2                      (hex)                         Hauppauge Computer Works, Inc.               
+245000-245FFF                 (base 16)                     Hauppauge Computer Works, Inc.               
+                                                            91 Cabot Court                               
+                                                            Hauppauge  New York  11788                   
+                                                            US                                           
+
+00-50-C2                      (hex)                         Spacesaver Corporation                       
+258000-258FFF                 (base 16)                     Spacesaver Corporation                       
+                                                            1450 Janesville Avenue                       
+                                                            Fort Atkinson  Wisconsin  53538              
+                                                            US                                           
+
+00-50-C2                      (hex)                         MDS SCIEX                                    
+242000-242FFF                 (base 16)                     MDS SCIEX                                    
+                                                            71 Four Valley Drive                         
+                                                            Concord  Ontario  L4K 4V8                    
+                                                            CA                                           
+
+00-50-C2                      (hex)                         nVent, Schroff GmbH                          
+225000-225FFF                 (base 16)                     nVent, Schroff GmbH                          
+                                                            Langenalber Strasse 96-100                   
+                                                            Straubenhardt    75334                       
+                                                            DE                                           
+
+00-50-C2                      (hex)                         LORD INGENIERIE                              
+22E000-22EFFF                 (base 16)                     LORD INGENIERIE                              
+                                                            ZA de Marly BP110                            
+                                                            CORBREUSE    91410                           
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Schwer+Kopka GmbH                            
+238000-238FFF                 (base 16)                     Schwer+Kopka GmbH                            
+                                                            Herknerstr. 4                                
+                                                            Weingarten  Baden-Württemberg  88250         
+                                                            DE                                           
+
+00-50-C2                      (hex)                         JLCooper Electronics                         
+236000-236FFF                 (base 16)                     JLCooper Electronics                         
+                                                            142 Arena St                                 
+                                                            El Segundo  CA  90245                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         LK Ltd                                       
+209000-209FFF                 (base 16)                     LK Ltd                                       
+                                                            Argosy Road                                  
+                                                            Castle Donington  Derby  DE74 2SA            
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Windmill Innovations                         
+206000-206FFF                 (base 16)                     Windmill Innovations                         
+                                                            Beurtschipper 20                             
+                                                            Nijkerk  GLD  3861SC                         
+                                                            NL                                           
+
+00-50-C2                      (hex)                         ESG Elektroniksystem u. Logistik GmbH        
+21D000-21DFFF                 (base 16)                     ESG Elektroniksystem u. Logistik GmbH        
+                                                            Einsteinstr. 174                             
+                                                            Muenchen  Bayern  81675                      
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines Ltd                
+21F000-21FFFF                 (base 16)                     Monitor Business Machines Ltd                
+                                                            PO Box 108042                                
+                                                            Auckland                                     
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Getinge IT Solutions ApS                     
+221000-221FFF                 (base 16)                     Getinge IT Solutions ApS                     
+                                                            Tordenskjoldsgade 27                         
+                                                            Copenhagen K  DK  1055                       
+                                                            DK                                           
+
+00-50-C2                      (hex)                         Bluesocket, Inc.                             
+1E3000-1E3FFF                 (base 16)                     Bluesocket, Inc.                             
+                                                            7 New England Executive Park                 
+                                                            Burlington  MA  01803                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         EDD Srl                                      
+1FC000-1FCFFF                 (base 16)                     EDD Srl                                      
+                                                            Via della Repubblica,27 - Levata             
+                                                            Curtatone  Mantova  46010                    
+                                                            IT                                           
+
+00-50-C2                      (hex)                         SouthWing S.L.                               
+1FD000-1FDFFF                 (base 16)                     SouthWing S.L.                               
+                                                            Calle Llacuna 162                            
+                                                            Barcelona  Catalunya  08018                  
+                                                            ES                                           
+
+00-50-C2                      (hex)                         COSMO co.,ltd.                               
+1EC000-1ECFFF                 (base 16)                     COSMO co.,ltd.                               
+                                                            TAKARAMACHI 1-BANCHI                         
+                                                            YOKKAICHI-SHI  MIE  510-0844                 
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Applied Systems Engineering, Inc.            
+1DB000-1DBFFF                 (base 16)                     Applied Systems Engineering, Inc.            
+                                                            1671 Dell Ave.                               
+                                                            Campbell  CA  95008                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Datatek Applications, Inc.                   
+1CE000-1CEFFF                 (base 16)                     Datatek Applications, Inc.                   
+                                                            399 Campus Drive                             
+                                                            Somerset  NJ  08873                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         EVER Sp. z o.o.                              
+1CA000-1CAFFF                 (base 16)                     EVER Sp. z o.o.                              
+                                                            ul. Grudzinskiego 30                         
+                                                            Swarzedz  wielkopolskie  62-020              
+                                                            PL                                           
+
+00-50-C2                      (hex)                         LIFETIME MEMORY PRODUCTS, INC.               
+1CF000-1CFFFF                 (base 16)                     LIFETIME MEMORY PRODUCTS, INC.               
+                                                            2505 DAVINCI STREET                          
+                                                            IRVINE  CA  92614                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Cognex Corporation                           
+1E0000-1E0FFF                 (base 16)                     Cognex Corporation                           
+                                                            1 Vision Drive                               
+                                                            Natick  MA  01760                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Synopsys                                     
+1D3000-1D3FFF                 (base 16)                     Synopsys                                     
+                                                            Le Symphonie Sud                             
+                                                            Montpellier    34000                         
+                                                            FR                                           
+
+00-50-C2                      (hex)                         RF Code                                      
+1A6000-1A6FFF                 (base 16)                     RF Code                                      
+                                                            1250 S. Clearview Ave.                       
+                                                            Mesa  AZ  85208-3378                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Axotec Technologies GmbH                     
+1A9000-1A9FFF                 (base 16)                     Axotec Technologies GmbH                     
+                                                            Sudetenstraße 88                             
+                                                            Geretsried  Bavaria  82538                   
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Sedia Electronics                            
+1BE000-1BEFFF                 (base 16)                     Sedia Electronics                            
+                                                            Omilio Monteiro Soares, 1590                 
+                                                            Curitiba  Parana  80320-210                  
+                                                            BR                                           
+
+00-50-C2                      (hex)                         INTERZEAG AG                                 
+1BA000-1BAFFF                 (base 16)                     INTERZEAG AG                                 
+                                                            Rietbachstrasse 5                            
+                                                            Schlieren    CH-8952                         
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Streaming Networks                           
+1AB000-1ABFFF                 (base 16)                     Streaming Networks                           
+                                                            House # 8 St # 31 F-7/1                      
+                                                            Islamabad    44000                           
+                                                            PK                                           
+
+00-50-C2                      (hex)                         Tidel Engineering, L.P.                      
+1A3000-1A3FFF                 (base 16)                     Tidel Engineering, L.P.                      
+                                                            2310 McDaniel Dr                             
+                                                            Carrollton  TX  75006                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         ABB Switzerland Inc                          
+1A2000-1A2FFF                 (base 16)                     ABB Switzerland Inc                          
+                                                            Dept. Dw/ATBN                                
+                                                            Baden  Aargau  CH 5401                       
+                                                            CH                                           
+
+00-50-C2                      (hex)                         Cognex Corporation                           
+17D000-17DFFF                 (base 16)                     Cognex Corporation                           
+                                                            15865 SW 74th Suite 105                      
+                                                            Portland  OR  97224                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Unicoi Systems                               
+177000-177FFF                 (base 16)                     Unicoi Systems                               
+                                                            410 Peachtree Parkway                        
+                                                            Cumming  GA  30041                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Wavium AB                                    
+176000-176FFF                 (base 16)                     Wavium AB                                    
+                                                            Västberga Allé 60                            
+                                                            Stockholm    SE-126 75                       
+                                                            SE                                           
+
+00-50-C2                      (hex)                         wolf-inf-tec                                 
+182000-182FFF                 (base 16)                     wolf-inf-tec                                 
+                                                            Heinrich-Hertz-Strasse 19                    
+                                                            Bremen    28211                              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Goerlitz AG                                  
+190000-190FFF                 (base 16)                     Goerlitz AG                                  
+                                                            August-Thyssen-Str. 32                       
+                                                            Koblenz  Rheinland-Pfalz  56070              
+                                                            DE                                           
+
+00-50-C2                      (hex)                         IO Limited                                   
+00B000-00BFFF                 (base 16)                     IO Limited                                   
+                                                            Woodhouse Barn,                              
+                                                            Cambridge  England  CB5 QHT                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Canal +                                      
+014000-014FFF                 (base 16)                     Canal +                                      
+                                                            23, rue leblanc                              
+                                                            Paris    75015                               
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Masterclock, Inc.                            
+16B000-16BFFF                 (base 16)                     Masterclock, Inc.                            
+                                                            2484 W. Clay St.                             
+                                                            St. Charles  MO  63301                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         TTTech                                       
+00E000-00EFFF                 (base 16)                     TTTech                                       
+                                                            Schoenbrunnerstrasse 7                       
+                                                                                                         
+                                                            AT                                           
+
+00-50-C2                      (hex)                         Vbrick Systems Inc.                          
+00C000-00CFFF                 (base 16)                     Vbrick Systems Inc.                          
+                                                            101 N. Plains Industrial Rd.                 
+                                                            Wallingford  CT  06492                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Taishodo Seiko Co., Ltd.                     
+170000-170FFF                 (base 16)                     Taishodo Seiko Co., Ltd.                     
+                                                            1-34, Kawahana-Chou, Toyokawa-shi,           
+                                                            Aich    442-0837                             
+                                                            JP                                           
+
+00-50-C2                      (hex)                         Private                                      
+044000-044FFF                 (base 16)                     Private                                      
+
+00-50-C2                      (hex)                         SCI Technology Inc.                          
+004000-004FFF                 (base 16)                     SCI Technology Inc.                          
+                                                            P.O. Box 1000                                
+                                                            Huntsville  AL  35807                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Brijing Embedor Embedded Internet Tech. Co. Ltd.
+16C000-16CFFF                 (base 16)                     Brijing Embedor Embedded Internet Tech. Co. Ltd.
+                                                            Room 401, Library Building, Noo. 35,         
+                                                            Beijing    100101                            
+                                                            CN                                           
+
+00-50-C2                      (hex)                         Quantronix, Inc.                             
+171000-171FFF                 (base 16)                     Quantronix, Inc.                             
+                                                            380 S. 200 W.                                
+                                                            Farmington  UT  84025                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         DSP Design Ltd.                              
+016000-016FFF                 (base 16)                     DSP Design Ltd.                              
+                                                            Tapton Park Innovation Centre                
+                                                            Derbyshire  England  S41 0TZ                 
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Tharsys                                      
+00A000-00AFFF                 (base 16)                     Tharsys                                      
+                                                            3 rue Ariane-Parl                            
+                                                            31520 Rationville                            
+                                                            FR                                           
+
+00-50-C2                      (hex)                         CommServ Solutions Inc.                      
+156000-156FFF                 (base 16)                     CommServ Solutions Inc.                      
+                                                            2217 Princess Anne Street                    
+                                                            Fredericksburg  VA  22401                    
+                                                            US                                           
+
+00-50-C2                      (hex)                         J&B Engineering Group S.L.                   
+161000-161FFF                 (base 16)                     J&B Engineering Group S.L.                   
+                                                            c/Francisco Silvela 36 Of. 5                 
+                                                            Madrid    28028                              
+                                                            ES                                           
+
+00-50-C2                      (hex)                         TTI - Telecom International Ltd.             
+160000-160FFF                 (base 16)                     TTI - Telecom International Ltd.             
+                                                            7 Martin Gehl St.                            
+                                                            Petach-Tikva  P.O.B. 3050  49512             
+                                                            IL                                           
+
+00-50-C2                      (hex)                         Teseda Corporation                           
+162000-162FFF                 (base 16)                     Teseda Corporation                           
+                                                            812 SW Washington St.                        
+                                                            Portland  OR  97205-3232                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         Acunia N.V.                                  
+164000-164FFF                 (base 16)                     Acunia N.V.                                  
+                                                            Philips-Site 5 Box 3                         
+                                                            Leoven    3001                               
+                                                            BE                                           
+
+00-50-C2                      (hex)                         Standard Comm. Corp.                         
+159000-159FFF                 (base 16)                     Standard Comm. Corp.                         
+                                                            1111 Knox Street                             
+                                                            Torrance  CA  90502                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Redux Communications Ltd.                    
+151000-151FFF                 (base 16)                     Redux Communications Ltd.                    
+                                                            POB 101                                      
+                                                            Modiin    71700                              
+                                                            IL                                           
+
+00-50-C2                      (hex)                         InBus Engineering, Inc.                      
+131000-131FFF                 (base 16)                     InBus Engineering, Inc.                      
+                                                            6233 Industrial Way                          
+                                                            Livermore  CA  94550                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         TPA Traffic & Parking Automation BV          
+127000-127FFF                 (base 16)                     TPA Traffic & Parking Automation BV          
+                                                            PO Box 5000                                  
+                                                            6802EA, Arnhem                               
+                                                            NL                                           
+
+00-50-C2                      (hex)                         Diva Systems                                 
+122000-122FFF                 (base 16)                     Diva Systems                                 
+                                                            800 Saginaw Dr.                              
+                                                            Redwood City  CA  94963                      
+                                                            US                                           
+
+00-50-C2                      (hex)                         Seranoa Networks, Inc.                       
+123000-123FFF                 (base 16)                     Seranoa Networks, Inc.                       
+                                                            Concord Office Center                        
+                                                            Concord  MA  01742                           
+                                                            US                                           
+
+00-50-C2                      (hex)                         Global Opto Communication Tech. Corp         
+119000-119FFF                 (base 16)                     Global Opto Communication Tech. Corp         
+                                                            7F, 162-31, Sec. 3,                          
+                                                            Taipei 106                                   
+                                                            TW                                           
+
+00-50-C2                      (hex)                         Corelatus A.B.                               
+100000-100FFF                 (base 16)                     Corelatus A.B.                               
+                                                            Ulf Svarte Bagge                             
+                                                            Tegnerg. 37  Stockholm  SE-111 61            
+                                                            SE                                           
+
+00-50-C2                      (hex)                         LAUD Electronic Design AS                    
+101000-101FFF                 (base 16)                     LAUD Electronic Design AS                    
+                                                            Froyhovveien 37                              
+                                                            N-3269 Larvik                                
+                                                            NO                                           
+
+00-50-C2                      (hex)                         IPAXS Corporation                            
+0FF000-0FFFFF                 (base 16)                     IPAXS Corporation                            
+                                                            5802 Benjamin Center Drive                   
+                                                            Tampa  FL  33634                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Valley Products Corporation                  
+0ED000-0EDFFF                 (base 16)                     Valley Products Corporation                  
+                                                            PO Box 668                                   
+                                                            Valley  NE  68064                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         PIUSYS Co., Ltd.                             
+0FB000-0FBFFF                 (base 16)                     PIUSYS Co., Ltd.                             
+                                                            Daemyoung Bldg, 5F                           
+                                                            Seoul 137-886                                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         QuesCom                                      
+110000-110FFF                 (base 16)                     QuesCom                                      
+                                                            Arche des Dolines                            
+                                                             92100 Boulogne Billancourt                  
+                                                            FR                                           
+
+00-50-C2                      (hex)                         KMS Systems, Inc.                            
+0F2000-0F2FFF                 (base 16)                     KMS Systems, Inc.                            
+                                                            PO Box 7264                                  
+                                                            The Woodlands  TX  77387                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         VHB Technologies, Inc.                       
+0F0000-0F0FFF                 (base 16)                     VHB Technologies, Inc.                       
+                                                            405 International Parkway                    
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Industrial Indexing Systems, Inc.            
+0EE000-0EEFFF                 (base 16)                     Industrial Indexing Systems, Inc.            
+                                                            626 Fishers Run                              
+                                                            Victor  NY  14564                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         Smartmedia LLC                               
+0E9000-0E9FFF                 (base 16)                     Smartmedia LLC                               
+                                                            1625 W. Olympic Blvd.                        
+                                                            Los Angeles  CA  90015                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Frederick Engineering                        
+0DE000-0DEFFF                 (base 16)                     Frederick Engineering                        
+                                                            3620 Commerce Dr.                            
+                                                            Baltimore  MD  21227                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Inco Startec GmbH                            
+0D6000-0D6FFF                 (base 16)                     Inco Startec GmbH                            
+                                                            Potsdamer Straße 8                           
+                                                            D-14513 Teltow                               
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Palm, Inc.                                   
+0D4000-0D4FFF                 (base 16)                     Palm, Inc.                                   
+                                                            5470 Great America Parkway                   
+                                                            Santa Clara  CA  95052                       
+                                                            US                                           
+
+00-50-C2                      (hex)                         Pro-Active                                   
+0BA000-0BAFFF                 (base 16)                     Pro-Active                                   
+                                                            Parc Gutenberg                               
+                                                            91120 Palaiseau                              
+                                                            FR                                           
+
+00-50-C2                      (hex)                         Tonbu, Inc.                                  
+0C3000-0C3FFF                 (base 16)                     Tonbu, Inc.                                  
+                                                            871 Fox Lane                                 
+                                                            San Jose  CA  95131                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         RYMIC                                        
+0B7000-0B7FFF                 (base 16)                     RYMIC                                        
+                                                            102-A Wynn Drive                             
+                                                            Huntsville  AL  35805                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Latus Lightworks, Inc.                       
+0AF000-0AFFFF                 (base 16)                     Latus Lightworks, Inc.                       
+                                                            250 East Arapaho Rd.                         
+                                                            Richardson  TX  75081                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mobiltex Data Ltd.                           
+0A5000-0A5FFF                 (base 16)                     Mobiltex Data Ltd.                           
+                                                            3640 - 26th St. NE                           
+                                                            Calgary  Alberta T1Y 4T7                     
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Radiant Networks Plc                         
+0A9000-0A9FFF                 (base 16)                     Radiant Networks Plc                         
+                                                            The Mansion                                  
+                                                            Little Chesterford  Essex CB10 1XL           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         BaSyTec GmbH                                 
+0A3000-0A3FFF                 (base 16)                     BaSyTec GmbH                                 
+                                                            Karlstraße 14                                
+                                                            89561 Dischingen                             
+                                                            DE                                           
+
+00-50-C2                      (hex)                         KOREALINK                                    
+093000-093FFF                 (base 16)                     KOREALINK                                    
+                                                            10F CCMM Bldg. 12 Yoido-dong                 
+                                                            Seoul 150-010                                
+                                                            KR                                           
+
+00-50-C2                      (hex)                         Visable Genetics, Inc.                       
+0A1000-0A1FFF                 (base 16)                     Visable Genetics, Inc.                       
+                                                            291/295 Evans Ave.                           
+                                                            Etobicoke  Ontario  M8Z 1K2                  
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Seffle Instrument AB                         
+09B000-09BFFF                 (base 16)                     Seffle Instrument AB                         
+                                                            PO Box 25                                    
+                                                            661 21 Saffle                                
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Monitor Business Machines Ltd.               
+087000-087FFF                 (base 16)                     Monitor Business Machines Ltd.               
+                                                            PO Box 108042                                
+                                                            Auckland                                     
+                                                            NZ                                           
+
+00-50-C2                      (hex)                         Validyne Engineering Corp.                   
+086000-086FFF                 (base 16)                     Validyne Engineering Corp.                   
+                                                            8626 Wilbur Ave.                             
+                                                            Northridge  CA  91324                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         BSQUARE                                      
+08E000-08EFFF                 (base 16)                     BSQUARE                                      
+                                                            1136 W. Evelyn Ave.                          
+                                                            Sunnyvale  CA  94086                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Fenwal Italia S.P.A.                         
+089000-089FFF                 (base 16)                     Fenwal Italia S.P.A.                         
+                                                            Viale A. De Gasperi, 44                      
+                                                            20010 Bareggio (MI)                          
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Kylink Communications Corp.                  
+08D000-08DFFF                 (base 16)                     Kylink Communications Corp.                  
+                                                            No. 31, Tzyh Chyang St.                      
+                                                            Taipei                                       
+                                                            TW                                           
+
+00-50-C2                      (hex)                         IP Unity                                     
+08C000-08CFFF                 (base 16)                     IP Unity                                     
+                                                            1575 McCandless Dr.                          
+                                                            Milpitas  CA  95035                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         DIALOG4 System Engineering GmbH              
+084000-084FFF                 (base 16)                     DIALOG4 System Engineering GmbH              
+                                                            Monreposstr. 55                              
+                                                            71634 Ludwigsburg                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         JL-teknik                                    
+07E000-07EFFF                 (base 16)                     JL-teknik                                    
+                                                            Isbjornsvagen 3                              
+                                                                                                         
+                                                            SE                                           
+
+00-50-C2                      (hex)                         Matuschek Messtechnik GmbH                   
+081000-081FFF                 (base 16)                     Matuschek Messtechnik GmbH                   
+                                                            Werner-Heisenberg-Straße 14                  
+                                                            Alsdorf  NRW  52477                          
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Flextel S.p.A                                
+079000-079FFF                 (base 16)                     Flextel S.p.A                                
+                                                            Corso Vercelli 328                           
+                                                            10015 Ivrea (To)                             
+                                                            IT                                           
+
+00-50-C2                      (hex)                         Dataprobe, Inc.                              
+050000-050FFF                 (base 16)                     Dataprobe, Inc.                              
+                                                            1B Pearl Court                               
+                                                            Allendale  NJ  07401                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Vision Research, Inc.                        
+058000-058FFF                 (base 16)                     Vision Research, Inc.                        
+                                                            190 Parish Drive                             
+                                                            Wayne  NJ  07470                             
+                                                            US                                           
+
+00-50-C2                      (hex)                         Mayo Foundation                              
+052000-052FFF                 (base 16)                     Mayo Foundation                              
+                                                            Division of Engineering                      
+                                                            Rochester  MN  55905                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Etheira Technologies                         
+038000-038FFF                 (base 16)                     Etheira Technologies                         
+                                                            104 Macintosh Street                         
+                                                            Shepparton  Victoria  3630                   
+                                                            AU                                           
+
+00-50-C2                      (hex)                         Telecom Analysis Systems, LP                 
+04A000-04AFFF                 (base 16)                     Telecom Analysis Systems, LP                 
+                                                            34 Industrial Way East                       
+                                                            Eatontown  NJ  07724                         
+                                                            US                                           
+
+00-50-C2                      (hex)                         Chase Manhattan Bank                         
+045000-045FFF                 (base 16)                     Chase Manhattan Bank                         
+                                                            380 Madison Ave                              
+                                                            New York City  NY  10817                     
+                                                            US                                           
+
+00-50-C2                      (hex)                         E.I.S.M.                                     
+037000-037FFF                 (base 16)                     E.I.S.M.                                     
+                                                            Z.I. des Paluds                              
+                                                            BP 1441  13782 Aubagne Cedex                 
+                                                            FR                                           
+
+00-50-C2                      (hex)                         VersaLogic Corp.                             
+02A000-02AFFF                 (base 16)                     VersaLogic Corp.                             
+                                                            12100 SW Tualatin Rd                         
+                                                            Tualatin  OR  97062                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Emtac Technology Corp.                       
+019000-019FFF                 (base 16)                     Emtac Technology Corp.                       
+                                                            1F No. 22 Industry East 9 Road               
+                                                            Hsin-Chu 300                                 
+                                                            TW                                           
+
+00-50-C2                      (hex)                         CallTech International Limited               
+01E000-01EFFF                 (base 16)                     CallTech International Limited               
+                                                            Telford Point Telford Rd.                    
+                                                                RG2 6X2                                  
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Moisture Systems                             
+010000-010FFF                 (base 16)                     Moisture Systems                             
+                                                            220 Mill Rd.                                 
+                                                            Chelmsford  MA  01824                        
+                                                            US                                           
+
+00-50-C2                      (hex)                         Bihl + Wiedemann GmbH                        
+011000-011FFF                 (base 16)                     Bihl + Wiedemann GmbH                        
+                                                            Flosswoerthstr 41                            
+                                                            Mannheim    68199                            
+                                                            DE                                           
+
+00-50-C2                      (hex)                         Project Management Enterprises, Inc.         
+006000-006FFF                 (base 16)                     Project Management Enterprises, Inc.         
+                                                            7900 Wisconsin Avenue                        
+                                                            Bethesda  MD  20817                          
+                                                            US                                           
+
+00-50-C2                      (hex)                         Clive Green & Co. Ltd.                       
+007000-007FFF                 (base 16)                     Clive Green & Co. Ltd.                       
+                                                            1 New Street                                 
+                                                              England  LU1 SDX                           
+                                                            GB                                           
+
+00-50-C2                      (hex)                         Wartsila Voyage Limited                      
+886000-886FFF                 (base 16)                     Wartsila Voyage Limited                      
+                                                            13-18 City Quay                              
+                                                            Dublin 2    D02 ED70                         
+                                                            IE                                           
+
+40-D8-55                      (hex)                         Mettler Toledo                               
+0C8000-0C8FFF                 (base 16)                     Mettler Toledo                               
+                                                            1571 Northpointe Parkway                     
+                                                            Lutz  FL  33558                              
+                                                            US                                           
+
+00-50-C2                      (hex)                         Phoenix Audio Technologies                   
+F48000-F48FFF                 (base 16)                     Phoenix Audio Technologies                   
+                                                            2552 White Road, Suite A                     
+                                                            Irvine  CA  92614                            
+                                                            US                                           
+
+00-50-C2                      (hex)                         SR RESEARCH LTD                              
+139000-139FFF                 (base 16)                     SR RESEARCH LTD                              
+                                                            740 Meadow Wood Road                         
+                                                            Mississauga  Ontario  L5J 2S6                
+                                                            CA                                           
+
+00-50-C2                      (hex)                         Computechnic AG                              
+5E3000-5E3FFF                 (base 16)                     Computechnic AG                              
+                                                            Rietlistrasse 3                              
+                                                            Rorschacherberg  Goldach  9403               
+                                                            CH                                           
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/ieee.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/ieee.py
new file mode 100644
index 0000000000000000000000000000000000000000..3e66d553e229261e6d9128b954ba3dade2982494
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/ieee.py
@@ -0,0 +1,293 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+#
+#   DISCLAIMER
+#
+#   netaddr is not sponsored nor endorsed by the IEEE.
+#
+#   Use of data from the IEEE (Institute of Electrical and Electronics
+#   Engineers) is subject to copyright. See the following URL for
+#   details :-
+#
+#       - http://www.ieee.org/web/publications/rights/legal.html
+#
+#   IEEE data files included with netaddr are not modified in any way but are
+#   parsed and made available to end users through an API. There is no
+#   guarantee that referenced files are not out of date.
+#
+#   See README file and source code for URLs to latest copies of the relevant
+#   files.
+#
+#-----------------------------------------------------------------------------
+"""
+Provides access to public OUI and IAB registration data published by the IEEE.
+
+More details can be found at the following URLs :-
+
+    - IEEE Home Page - http://www.ieee.org/
+    - Registration Authority Home Page - http://standards.ieee.org/regauth/
+"""
+
+import os.path as _path
+import csv as _csv
+
+from netaddr.compat import _bytes_type, _importlib_resources
+from netaddr.core import Subscriber, Publisher
+
+
+#: OUI index lookup dictionary.
+OUI_INDEX = {}
+
+#: IAB index lookup dictionary.
+IAB_INDEX = {}
+
+
+class FileIndexer(Subscriber):
+    """
+    A concrete Subscriber that receives OUI record offset information that is
+    written to an index data file as a set of comma separated records.
+    """
+    def __init__(self, index_file):
+        """
+        Constructor.
+
+        :param index_file: a file-like object or name of index file where
+            index records will be written.
+        """
+        if hasattr(index_file, 'readline') and hasattr(index_file, 'tell'):
+            self.fh = index_file
+        else:
+            self.fh = open(index_file, 'w')
+
+        self.writer = _csv.writer(self.fh, lineterminator="\n")
+
+    def update(self, data):
+        """
+        Receives and writes index data to a CSV data file.
+
+        :param data: record containing offset record information.
+        """
+        self.writer.writerow(data)
+
+
+class OUIIndexParser(Publisher):
+    """
+    A concrete Publisher that parses OUI (Organisationally Unique Identifier)
+    records from IEEE text-based registration files
+
+    It notifies registered Subscribers as each record is encountered, passing
+    on the record's position relative to the start of the file (offset) and
+    the size of the record (in bytes).
+
+    The file processed by this parser is available online from this URL :-
+
+        - http://standards.ieee.org/regauth/oui/oui.txt
+
+    This is a sample of the record structure expected::
+
+        00-CA-FE   (hex)        ACME CORPORATION
+        00CAFE     (base 16)        ACME CORPORATION
+                        1 MAIN STREET
+                        SPRINGFIELD
+                        UNITED STATES
+    """
+    def __init__(self, ieee_file):
+        """
+        Constructor.
+
+        :param ieee_file: a file-like object or name of file containing OUI
+            records. When using a file-like object always open it in binary
+            mode otherwise offsets will probably misbehave.
+        """
+        super(OUIIndexParser, self).__init__()
+
+        if hasattr(ieee_file, 'readline') and hasattr(ieee_file, 'tell'):
+            self.fh = ieee_file
+        else:
+            self.fh = open(ieee_file, 'rb')
+
+    def parse(self):
+        """
+        Starts the parsing process which detects records and notifies
+        registered subscribers as it finds each OUI record.
+        """
+        skip_header = True
+        record = None
+        size = 0
+
+        marker = _bytes_type('(hex)')
+        hyphen = _bytes_type('-')
+        empty_string = _bytes_type('')
+
+        while True:
+            line = self.fh.readline()
+
+            if not line:
+                break   # EOF, we're done
+
+            if skip_header and marker in line:
+                skip_header = False
+
+            if skip_header:
+                #   ignoring header section
+                continue
+
+            if marker in line:
+                #   record start
+                if record is not None:
+                    #   a complete record.
+                    record.append(size)
+                    self.notify(record)
+
+                size = len(line)
+                offset = (self.fh.tell() - len(line))
+                oui = line.split()[0]
+                index = int(oui.replace(hyphen, empty_string), 16)
+                record = [index, offset]
+            else:
+                #   within record
+                size += len(line)
+
+        #   process final record on loop exit
+        record.append(size)
+        self.notify(record)
+
+
+class IABIndexParser(Publisher):
+    """
+    A concrete Publisher that parses IAB (Individual Address Block) records
+    from IEEE text-based registration files
+
+    It notifies registered Subscribers as each record is encountered, passing
+    on the record's position relative to the start of the file (offset) and
+    the size of the record (in bytes).
+
+    The file processed by this parser is available online from this URL :-
+
+        - http://standards.ieee.org/regauth/oui/iab.txt
+
+    This is a sample of the record structure expected::
+
+        00-50-C2   (hex)        ACME CORPORATION
+        ABC000-ABCFFF     (base 16)        ACME CORPORATION
+                        1 MAIN STREET
+                        SPRINGFIELD
+                        UNITED STATES
+    """
+    def __init__(self, ieee_file):
+        """
+        Constructor.
+
+        :param ieee_file: a file-like object or name of file containing IAB
+            records. When using a file-like object always open it in binary
+            mode otherwise offsets will probably misbehave.
+        """
+        super(IABIndexParser, self).__init__()
+
+        if hasattr(ieee_file, 'readline') and hasattr(ieee_file, 'tell'):
+            self.fh = ieee_file
+        else:
+            self.fh = open(ieee_file, 'rb')
+
+    def parse(self):
+        """
+        Starts the parsing process which detects records and notifies
+        registered subscribers as it finds each IAB record.
+        """
+        skip_header = True
+        record = None
+        size = 0
+
+        hex_marker = _bytes_type('(hex)')
+        base16_marker = _bytes_type('(base 16)')
+        hyphen = _bytes_type('-')
+        empty_string = _bytes_type('')
+
+        while True:
+            line = self.fh.readline()
+
+            if not line:
+                break   # EOF, we're done
+
+            if skip_header and hex_marker in line:
+                skip_header = False
+
+            if skip_header:
+                #   ignoring header section
+                continue
+
+            if hex_marker in line:
+                #   record start
+                if record is not None:
+                    record.append(size)
+                    self.notify(record)
+
+                offset = (self.fh.tell() - len(line))
+                iab_prefix = line.split()[0]
+                index = iab_prefix
+                record = [index, offset]
+                size = len(line)
+            elif base16_marker in line:
+                #   within record
+                size += len(line)
+                prefix = record[0].replace(hyphen, empty_string)
+                suffix = line.split()[0]
+                suffix = suffix.split(hyphen)[0]
+                record[0] = (int(prefix + suffix, 16)) >> 12
+            else:
+                #   within record
+                size += len(line)
+
+        #   process final record on loop exit
+        record.append(size)
+        self.notify(record)
+
+
+def create_index_from_registry(registry_fh, index_path, parser):
+    """Generate an index files from the IEEE registry file."""
+    oui_parser = parser(registry_fh)
+    oui_parser.attach(FileIndexer(index_path))
+    oui_parser.parse()
+
+
+def create_indices():
+    """Create indices for OUI and IAB file based lookups"""
+    create_index_from_registry(
+        _path.join(_path.dirname(__file__), 'oui.txt'),
+        _path.join(_path.dirname(__file__), 'oui.idx'),
+        OUIIndexParser,
+    )
+    create_index_from_registry(
+        _path.join(_path.dirname(__file__), 'iab.txt'),
+        _path.join(_path.dirname(__file__), 'iab.idx'),
+        IABIndexParser,
+    )
+
+
+def load_index(index, fp):
+    """Load index from file into index data structure."""
+    try:
+        for row in _csv.reader([x.decode('UTF-8') for x in fp]):
+            (key, offset, size) = [int(_) for _ in row]
+            index.setdefault(key, [])
+            index[key].append((offset, size))
+    finally:
+        fp.close()
+
+
+def load_indices():
+    """Load OUI and IAB lookup indices into memory"""
+    load_index(OUI_INDEX, _importlib_resources.open_binary(__package__, 'oui.idx'))
+    load_index(IAB_INDEX, _importlib_resources.open_binary(__package__, 'iab.idx'))
+
+
+if __name__ == '__main__':
+    #   Generate indices when module is executed as a script.
+    create_indices()
+else:
+    #   On module load read indices in memory to enable lookups.
+    load_indices()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.idx b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.idx
new file mode 100644
index 0000000000000000000000000000000000000000..e81545cd672dcc029ecb0add460feef0f3635a26
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.idx
@@ -0,0 +1,28112 @@
+8818,323,167
+53487,490,107
+549269,597,155
+16039326,752,141
+5801449,893,256
+12329874,1149,241
+4216194,1390,114
+10806043,1504,114
+14194576,1618,217
+8927792,1835,189
+12101005,2024,144
+5295843,2168,140
+10020675,2308,117
+12851665,2425,201
+8945189,2626,145
+548995,2771,178
+14686548,2949,178
+1061502,3127,180
+16255055,3307,178
+3210168,3485,196
+16029634,3681,123
+10765593,3804,219
+6872053,4023,141
+2377416,4164,193
+1573550,4357,197
+794835,4554,197
+4511633,4751,196
+8668926,4947,196
+14166296,5143,196
+13684739,5339,175
+6599197,5514,166
+12855702,5680,127
+9963063,5807,154
+9222218,5961,221
+10021114,6182,156
+3720424,6338,124
+3464574,6462,250
+13421924,6712,138
+2416551,6850,277
+11560433,7127,177
+9441844,7304,254
+5515803,7558,126
+6066782,7684,270
+544681,7954,141
+544761,8095,141
+5281976,8236,185
+1114282,8421,60
+12078574,8481,195
+11047762,8676,223
+14994589,8899,214
+11063523,9113,161
+10009145,9274,122
+13921190,9396,196
+13370743,9592,196
+3181490,9788,141
+14740322,9929,176
+551053,10105,185
+15232824,10290,234
+4727148,10524,209
+9223716,10733,280
+570287,11013,197
+3180077,11210,154
+7137478,11364,207
+1851766,11571,192
+6327054,11763,123
+1602005,11886,314
+11317742,12200,208
+16297419,12408,127
+13918954,12535,196
+5552854,12731,196
+9755726,12927,139
+1327868,13066,130
+11296092,13196,226
+10792465,13422,174
+5562064,13596,126
+7102011,13722,141
+4200736,13863,166
+13645637,14029,252
+6306428,14281,252
+376,14533,153
+833393,14686,139
+5818486,14825,261
+2891343,15086,256
+36946,15342,156
+6787,15498,158
+2365037,15656,197
+9702169,15853,197
+7391218,16050,197
+3708141,16247,122
+7341107,16369,144
+14460466,16513,170
+8975726,16683,197
+12359649,16880,134
+2675127,17014,254
+13157114,17268,197
+8958818,17465,212
+542672,17677,212
+564358,17889,212
+8161622,18101,161
+10261476,18262,60
+8923548,18322,161
+13406355,18483,165
+13395110,18648,196
+3158397,18844,148
+15772008,18992,223
+4776425,19215,189
+14160793,19404,222
+5562393,19626,117
+1344560,19743,201
+12100687,19944,138
+9451,20082,155
+5287757,20237,178
+13167352,20415,178
+7380781,20593,178
+3685158,20771,163
+6093563,20934,116
+10255343,21050,139
+7614171,21189,130
+2103106,21319,151
+13404198,21470,139
+15489907,21609,216
+14732061,21825,60
+8686541,21885,154
+1359934,22039,139
+12618155,22178,139
+13913508,22317,178
+16311759,22495,149
+6849266,22644,130
+13902000,22774,156
+585197,22930,186
+6329077,23116,139
+8879,23255,149
+10523042,23404,278
+32949,23682,143
+1862010,23825,200
+4986692,24025,142
+11546709,24167,185
+9460788,24352,165
+13920821,24517,141
+13671546,24658,219
+13118507,24877,154
+8397018,25031,178
+6849662,25209,160
+12421,25369,141
+6315917,25510,136
+12890986,25646,141
+7403348,25787,203
+7113683,25990,141
+6854475,26131,211
+3465681,26342,154
+8631,26496,164
+41136,26660,154
+2390515,26814,213
+8430133,27027,156
+13157962,27183,236
+3205670,27419,132
+10242431,27551,214
+12903327,27765,213
+16292472,27978,196
+8976498,28174,196
+15488547,28370,196
+5539516,28566,141
+4203331,28707,234
+1634702,28941,158
+1058,29099,153
+8444435,29252,122
+5303376,29374,242
+6316511,29616,136
+7362495,29752,185
+9234248,29937,60
+1081990,29997,250
+1356887,30247,149
+14456364,30396,137
+1573421,30533,196
+14203993,30729,264
+563096,30993,221
+2387752,31214,170
+9206261,31384,175
+4782299,31559,196
+4650,31755,177
+11555214,31932,194
+2642656,32126,316
+5819218,32442,139
+8151398,32581,141
+10001355,32722,206
+9762733,32928,137
+6317049,33065,128
+11309048,33193,114
+6292390,33307,169
+8147545,33476,220
+4502165,33696,207
+9708769,33903,156
+16304729,34059,157
+8958609,34216,123
+12856016,34339,123
+13423233,34462,123
+2100656,34585,312
+14163677,34897,213
+13909963,35110,139
+6059669,35249,166
+16272691,35415,199
+12618445,35614,249
+11335415,35863,189
+15244812,36052,60
+4777664,36112,207
+3685532,36319,232
+12594725,36551,213
+1079063,36764,285
+11038047,37049,191
+5827821,37240,214
+10774716,37454,60
+20601,37514,60
+1051755,37574,122
+5267381,37696,165
+12906732,37861,199
+15208392,38060,161
+14966071,38221,137
+61099,38358,141
+5547779,38499,252
+9468504,38751,205
+14682559,38956,286
+4894,39242,151
+8677777,39393,114
+7159,39507,133
+7878151,39640,174
+11534451,39814,178
+14192072,39992,189
+8969852,40181,169
+11068097,40350,130
+9476727,40480,130
+323075,40610,130
+4990104,40740,130
+8182108,40870,139
+13150924,41009,60
+8551,41069,184
+2950,41253,189
+14430673,41442,197
+13170512,41639,117
+13931060,41756,139
+1995,41895,128
+1351606,42023,198
+4442,42221,135
+5025443,42356,158
+1846811,42514,240
+1844459,42754,123
+4115,42877,141
+2894841,43018,139
+14206920,43157,189
+7354894,43346,189
+2116611,43535,189
+5818096,43724,213
+8691822,43937,178
+10763936,44115,169
+6603486,44284,189
+9192527,44473,166
+26466,44639,199
+2933767,44838,119
+11857177,44957,154
+4251394,45111,173
+13427092,45284,137
+9437720,45421,121
+1330730,45542,133
+8655775,45675,178
+15749610,45853,141
+5256176,45994,259
+16526258,46253,155
+14720810,46408,203
+5038494,46611,253
+7640556,46864,144
+11295470,47008,192
+7388176,47200,143
+8931864,47343,124
+1783,47467,164
+1796,47631,164
+1781,47795,164
+3458865,47959,164
+10250676,48123,154
+5243012,48277,141
+6608061,48418,149
+301299,48567,153
+8527,48720,167
+4502579,48887,177
+14198525,49064,151
+14426553,49215,164
+7135227,49379,154
+2391373,49533,130
+8933622,49663,287
+14981307,49950,184
+6332702,50134,263
+12868599,50397,121
+9232285,50518,137
+6046042,50655,144
+7364181,50799,256
+11588968,51055,236
+15732415,51291,173
+7353609,51464,141
+4463354,51605,185
+263982,51790,193
+7868113,51983,175
+4517070,52158,137
+16264968,52295,121
+4463634,52416,166
+4466851,52582,237
+1099157,52819,116
+2110003,52935,238
+6826460,53173,196
+9721055,53369,144
+8174724,53513,154
+16256497,53667,118
+10785830,53785,145
+15003980,53930,60
+11056214,53990,141
+2927088,54131,213
+5544818,54344,127
+10504151,54471,203
+6855117,54674,142
+1065203,54816,123
+5794580,54939,123
+12367971,55062,123
+2890998,55185,149
+7088985,55334,117
+4515438,55451,123
+12642402,55574,123
+15992342,55697,123
+851549,55820,154
+3968288,55974,139
+6299025,56113,193
+13945163,56306,193
+537883,56499,271
+11277701,56770,195
+11292819,56965,192
+7388137,57157,219
+5284004,57376,114
+53293,57490,121
+8415552,57611,198
+6617116,57809,212
+1087683,58021,178
+10275068,58199,139
+11566609,58338,130
+1099603,58468,211
+16028955,58679,228
+7092293,58907,199
+2908420,59106,204
+12358437,59310,192
+13678090,59502,238
+299558,59740,167
+15248806,59907,178
+793625,60085,254
+9496336,60339,185
+3156306,60524,206
+14685109,60730,197
+14711134,60927,215
+45539,61142,141
+10752404,61283,116
+51968,61399,60
+14480385,61459,117
+803073,61576,245
+46961,61821,141
+14988027,61962,123
+2935308,62085,178
+8663663,62263,285
+13147155,62548,185
+9209318,62733,129
+8420628,62862,196
+2107454,63058,196
+10812535,63254,196
+5002909,63450,123
+3691420,63573,123
+4204057,63696,123
+7137372,63819,123
+299362,63942,157
+16267392,64099,123
+2914775,64222,178
+46325,64400,225
+12336974,64625,165
+1587374,64790,157
+315276,64947,194
+816402,65141,282
+7635906,65423,146
+14705626,65569,146
+5265308,65715,166
+5515149,65881,204
+11583094,66085,252
+4474828,66337,202
+5036431,66539,117
+11578917,66656,146
+4987782,66802,158
+15516685,66960,156
+4456521,67116,141
+15231588,67257,189
+1090126,67446,191
+13420005,67637,117
+7127924,67754,130
+6833993,67884,130
+16308664,68014,137
+8153451,68151,153
+6083083,68304,189
+7340926,68493,166
+13632479,68659,175
+12854178,68834,198
+11848535,69032,213
+4985445,69245,139
+20492,69384,141
+4743065,69525,242
+8926462,69767,246
+8976319,70013,197
+14187903,70210,178
+1306,70388,129
+524366,70517,129
+12318,70646,130
+20484,70776,115
+259,70891,115
+5813608,71006,172
+4737769,71178,158
+8677990,71336,161
+1627927,71497,213
+8435236,71710,151
+14480645,71861,169
+13431037,72030,281
+8686060,72311,154
+8917135,72465,196
+16016159,72661,196
+10787663,72857,196
+1850,73053,110
+9836,73163,175
+36090,73338,162
+6093692,73500,288
+16515999,73788,175
+180364,73963,115
+22465,74078,189
+8135692,74267,170
+8253,74437,198
+16516,74635,159
+10803600,74794,161
+24711,74955,164
+14481177,75119,141
+10523916,75260,185
+13923355,75445,231
+7104,75676,137
+2889185,75813,182
+3199339,75995,174
+10006129,76169,168
+10770124,76337,166
+11300378,76503,261
+33003,76764,119
+747,76883,149
+3419830,77032,196
+11309618,77228,196
+4016,77424,172
+575,77596,172
+6858977,77768,185
+3199789,77953,127
+12382895,78080,127
+14724943,78207,142
+12085748,78349,128
+2636365,78477,242
+12090479,78719,204
+3169702,78923,151
+12333273,79074,158
+293303,79232,130
+12636415,79362,185
+8970142,79547,185
+2915556,79732,218
+5768187,79950,202
+1329154,80152,183
+16534249,80335,161
+4206908,80496,194
+16532886,80690,220
+10544436,80910,161
+4475741,81071,125
+5461,81196,129
+1864968,81325,223
+6968,81548,203
+9050,81751,190
+2414443,81941,122
+12910306,82063,194
+7867632,82257,141
+822308,82398,238
+9203063,82636,196
+15254906,82832,163
+14684803,82995,237
+10538843,83232,141
+9249,83373,152
+24785,83525,152
+8702406,83677,171
+8959595,83848,150
+2422142,83998,170
+9216072,84168,236
+2413554,84404,178
+13920677,84582,174
+9208102,84756,119
+13925444,84875,154
+8412751,85029,226
+8656879,85255,165
+3692213,85420,152
+8165074,85572,215
+12600016,85787,137
+13682136,85924,153
+7361716,86077,169
+2139660,86246,219
+4754130,86465,246
+14477368,86711,237
+11064472,86948,175
+5265767,87123,154
+1664,87277,145
+3954540,87422,161
+8656742,87583,220
+2903417,87803,181
+3138,87984,122
+9917,88106,210
+6344748,88316,135
+13654268,88451,121
+1333151,88572,196
+11813670,88768,196
+305944,88964,149
+7918228,89113,122
+7380905,89235,253
+786907,89488,230
+574945,89718,221
+1599175,89939,209
+6075382,90148,148
+2902069,90296,154
+4729571,90450,230
+16557773,90680,199
+4507764,90879,192
+7651663,91071,196
+11594583,91267,196
+1599962,91463,192
+16276557,91655,114
+2906191,91769,139
+15747898,91908,137
+5554020,92045,117
+11033452,92162,146
+13152750,92308,137
+64698,92445,141
+52148,92586,265
+5029898,92851,197
+10283051,93048,197
+7371187,93245,141
+14162131,93386,137
+1350447,93523,319
+3683835,93842,178
+4775325,94020,214
+10515946,94234,137
+15748309,94371,139
+430,94510,131
+57353,94641,156
+15002243,94797,171
+7662658,94968,199
+13958163,95167,199
+8420666,95366,170
+15511447,95536,152
+10530885,95688,183
+14727860,95871,134
+5806859,96005,163
+14161418,96168,168
+1097852,96336,165
+4236919,96501,137
+14987297,96638,160
+10256215,96798,205
+11853853,97003,162
+1835074,97165,163
+4469927,97328,139
+3989921,97467,228
+16292079,97695,196
+5831047,97891,196
+11072940,98087,196
+5814996,98283,196
+7347464,98479,208
+7606971,98687,199
+4135,98886,157
+12330563,99043,140
+320041,99183,208
+3443573,99391,207
+10283157,99598,185
+22591,99783,188
+9452904,99971,183
+1086651,100154,123
+7871818,100277,178
+9757100,100455,202
+3467412,100657,252
+16281537,100909,123
+2686780,101032,123
+15767990,101155,123
+8972798,101278,123
+3705132,101401,123
+7642799,101524,123
+9748269,101647,123
+6867684,101770,141
+48699,101911,196
+8167799,102107,196
+2371074,102303,196
+7911148,102499,182
+8402369,102681,219
+5813244,102900,217
+2115546,103117,219
+2370046,103336,140
+8145387,103476,194
+12858118,103670,192
+581579,103862,134
+10785599,103996,196
+2665630,104192,141
+2930925,104333,132
+6870146,104465,171
+9979234,104636,212
+14992515,104848,213
+8122,105061,136
+10761175,105197,158
+11578578,105355,178
+2101104,105533,125
+2108707,105658,151
+9470795,105809,224
+1593386,106033,146
+11023994,106179,173
+7136474,106352,151
+1107910,106503,139
+1585599,106642,167
+13171425,106809,134
+14459699,106943,254
+7900244,107197,145
+12103527,107342,137
+12622042,107479,185
+15732716,107664,196
+11274079,107860,196
+12601574,108056,175
+8924762,108231,100
+28999,108331,141
+48757,108472,141
+6609803,108613,202
+7873914,108815,140
+1090745,108955,241
+5250224,109196,141
+306244,109337,165
+16047269,109502,161
+8441442,109663,139
+8396562,109802,157
+5270718,109959,199
+2391570,110158,141
+311873,110299,114
+3950491,110413,167
+6319103,110580,156
+9238288,110736,185
+3177388,110921,185
+7888328,111106,151
+3933281,111257,139
+8928548,111396,139
+15253944,111535,217
+14210933,111752,178
+15217421,111930,130
+13918435,112060,159
+11839673,112219,141
+5299431,112360,141
+6592553,112501,214
+531908,112715,190
+7885668,112905,134
+3728906,113039,219
+4246464,113258,123
+12870027,113381,123
+13397668,113504,175
+8403545,113679,112
+5803364,113791,242
+23923,114033,141
+6319420,114174,289
+4517940,114463,168
+10128,114631,141
+3455544,114772,184
+9972134,114956,221
+13389112,115177,152
+583305,115329,123
+14440167,115452,123
+11015888,115575,161
+10775793,115736,161
+569046,115897,161
+14467049,116058,193
+11808086,116251,145
+4220068,116396,169
+7123630,116565,141
+11573291,116706,178
+3472031,116884,135
+15754690,117019,225
+7387106,117244,196
+8424887,117440,158
+10526086,117598,196
+49407,117794,154
+13917663,117948,168
+16299368,118116,154
+2911101,118270,130
+8966513,118400,172
+10526145,118572,189
+2900485,118761,117
+11019755,118878,208
+3466112,119086,126
+6051865,119212,166
+12110340,119378,165
+12895587,119543,253
+8435464,119796,162
+572448,119958,203
+9710143,120161,134
+2109931,120295,130
+16304492,120425,213
+8669219,120638,166
+15998558,120804,129
+7108192,120933,152
+8450,121085,147
+5265408,121232,167
+13160746,121399,182
+846537,121581,139
+15215172,121720,174
+1090750,121894,238
+9731006,122132,126
+15515754,122258,144
+9718166,122402,137
+16260367,122539,208
+5818677,122747,198
+38049,122945,137
+12382866,123082,139
+282842,123221,296
+15212770,123517,166
+9896,123683,200
+7887912,123883,139
+9198576,124022,139
+1609944,124161,178
+8946525,124339,206
+15507213,124545,154
+14710947,124699,248
+1447,124947,135
+558182,125082,130
+3186683,125212,187
+2630515,125399,116
+6593032,125515,238
+6858370,125753,254
+5798498,126007,130
+5536338,126137,143
+15756811,126280,141
+3436525,126421,140
+5518283,126561,123
+3410108,126684,123
+1849019,126807,123
+3944191,126930,123
+57381,127053,140
+11306182,127193,252
+5424,127445,118
+832183,127563,130
+2422391,127693,123
+11586152,127816,123
+13122693,127939,123
+7898893,128062,223
+11043328,128285,160
+3678376,128445,148
+7362710,128593,198
+1417,128791,146
+3974678,128937,197
+10281059,129134,161
+13644137,129295,161
+2421375,129456,158
+12322115,129614,110
+46751,129724,109
+8662144,129833,204
+3981433,130037,319
+10012123,130356,127
+1351484,130483,161
+16576230,130644,221
+8708903,130865,178
+8632,131043,164
+823648,131207,222
+14216476,131429,156
+14168372,131585,125
+4230134,131710,223
+107,131933,153
+7616315,132086,181
+8152150,132267,175
+16018980,132442,186
+8946297,132628,259
+6866490,132887,170
+10511503,133057,164
+13127913,133221,191
+1110371,133412,166
+8968730,133578,149
+10022811,133727,141
+1363853,133868,104
+1065984,133972,196
+11592062,134168,196
+14985157,134364,196
+6065453,134560,251
+9502111,134811,146
+11808960,134957,169
+15211944,135126,135
+15744259,135261,253
+14479504,135514,275
+10550881,135789,136
+6040565,135925,136
+13392467,136061,141
+24712,136202,150
+543439,136352,213
+2893726,136565,154
+9199432,136719,208
+9731769,136927,227
+6581865,137154,174
+7367609,137328,141
+13908124,137469,183
+49390,137652,154
+2383839,137806,153
+10249197,137959,178
+7665249,138137,174
+12084045,138311,123
+2409519,138434,134
+2929178,138568,182
+10807669,138750,123
+3159469,138873,123
+8667495,138996,123
+9961670,139119,123
+11280244,139242,123
+11033644,139365,123
+56176,139488,123
+16573783,139611,134
+4769165,139745,150
+10399,139895,240
+10235995,140135,193
+1068681,140328,139
+14206103,140467,173
+12370754,140640,191
+7123,140831,188
+13401831,141019,193
+2148075,141212,188
+6600134,141400,156
+2633900,141556,151
+13947621,141707,191
+20661,141898,152
+5177,142050,168
+2139853,142218,158
+8683565,142376,142
+6535,142518,216
+7609383,142734,214
+41132,142948,149
+9737,143097,170
+2684215,143267,154
+9755059,143421,252
+13123625,143673,199
+16281326,143872,196
+7865009,144068,141
+11800379,144209,230
+6285,144439,132
+5547,144571,142
+5797573,144713,132
+11055834,144845,160
+4948,145005,147
+7919616,145152,154
+538034,145306,181
+4999651,145487,219
+2381952,145706,117
+5531244,145823,254
+11048565,146077,193
+3709686,146270,161
+14723734,146431,161
+5273349,146592,161
+2675766,146753,213
+13939322,146966,139
+4516427,147105,129
+12897131,147234,148
+1605776,147382,141
+7889494,147523,196
+11556104,147719,196
+12088768,147915,138
+7281,148053,150
+6803,148203,149
+9762405,148352,135
+11571412,148487,242
+12630758,148729,213
+9215803,148942,189
+5304,149131,123
+11332956,149254,139
+8659094,149393,217
+11846000,149610,228
+11298566,149838,135
+282538,149973,135
+5804950,150108,135
+8001,150243,135
+12849290,150378,135
+15773778,150513,135
+7397167,150648,141
+3708128,150789,194
+3470923,150983,139
+16018415,151122,178
+1101238,151300,152
+10810343,151452,214
+14957166,151666,234
+8184522,151900,137
+9462190,152037,139
+7141842,152176,226
+3192365,152402,148
+5249100,152550,158
+16037811,152708,197
+13370329,152905,142
+16557671,153047,141
+13115370,153188,122
+10211,153310,141
+6318,153451,148
+8950237,153599,121
+1852819,153720,144
+9497680,153864,128
+14735432,153992,117
+6301468,154109,153
+60426,154262,219
+13162416,154481,161
+7102699,154642,225
+7658202,154867,189
+14217712,155056,199
+14469365,155255,188
+8968182,155443,167
+9476083,155610,161
+8133736,155771,161
+12617707,155932,161
+291147,156093,154
+2900385,156247,136
+4995288,156383,139
+4488123,156522,254
+10255314,156776,134
+13695116,156910,271
+2928917,157181,214
+1101946,157395,185
+13943240,157580,178
+8966772,157758,178
+9289,157936,230
+57740,158166,139
+8681779,158305,134
+8918340,158439,128
+12889010,158567,197
+8434228,158764,165
+4502546,158929,110
+833810,159039,128
+3973896,159167,130
+16006753,159297,182
+11813242,159479,208
+1593863,159687,248
+98,159935,165
+15253975,160100,124
+5013792,160224,151
+2664155,160375,196
+1351928,160571,196
+13170797,160767,196
+6309323,160963,167
+4491,161130,158
+57521,161288,158
+57562,161446,158
+16301581,161604,192
+14959270,161796,139
+3958668,161935,196
+13914175,162131,213
+3705936,162344,151
+14420054,162495,156
+1890855,162651,197
+9499397,162848,166
+4232637,163014,160
+10005244,163174,154
+5183,163328,195
+13653426,163523,214
+1331159,163737,154
+12080400,163891,255
+300403,164146,178
+15783850,164324,193
+16318219,164517,151
+8154103,164668,155
+54040,164823,150
+3184379,164973,161
+4728810,165134,161
+8157310,165295,161
+2382759,165456,123
+7401607,165579,123
+14730812,165702,248
+3142,165950,158
+8050,166108,178
+9061,166286,142
+6328819,166428,197
+2636126,166625,175
+3680602,166800,213
+8971816,167013,302
+5776268,167315,165
+13402859,167480,166
+1349757,167646,165
+13946679,167811,130
+13925884,167941,253
+4235064,168194,169
+12332861,168363,197
+4258431,168560,137
+3515,168697,139
+2915969,168836,139
+4226319,168975,196
+6868078,169171,196
+3159250,169367,185
+5259361,169552,114
+4238,169666,182
+14700899,169848,158
+5563382,170006,143
+4239412,170149,139
+12064475,170288,188
+4240589,170476,141
+13926871,170617,117
+16001864,170734,109
+5304650,170843,130
+319218,170973,243
+7913895,171216,178
+5011570,171394,188
+9237923,171582,221
+9226484,171803,154
+16024545,171957,206
+540253,172163,178
+3980606,172341,242
+6560290,172583,121
+10519755,172704,135
+13925090,172839,175
+6837501,173014,141
+956,173155,101
+13939049,173256,270
+14960528,173526,213
+3687756,173739,132
+2633,173871,137
+41160,174008,130
+16029265,174138,132
+4481606,174270,107
+3472569,174377,158
+7377295,174535,155
+14213345,174690,175
+8130581,174865,167
+14206833,175032,196
+14690946,175228,218
+11598179,175446,214
+13930720,175660,167
+11026497,175827,201
+14688770,176028,139
+14165424,176167,175
+7627083,176342,317
+10015379,176659,139
+13416616,176798,185
+1079216,176983,199
+15736252,177182,143
+3409054,177325,154
+9763625,177479,148
+11563053,177627,123
+7084480,177750,123
+8271,177873,151
+56287,178024,139
+9740366,178163,178
+9232663,178341,178
+6851312,178519,178
+12591373,178697,217
+5038833,178914,117
+5262171,179031,135
+11826247,179166,125
+8443045,179291,196
+307431,179487,196
+4483630,179683,196
+822747,179879,142
+11595387,180021,125
+11294843,180146,147
+1073899,180293,189
+2196,180482,166
+4718643,180648,165
+10514346,180813,139
+9899,180952,151
+16519366,181103,151
+2912201,181254,193
+5828456,181447,167
+2895,181614,117
+6342552,181731,130
+13133356,181861,294
+8427210,182155,193
+1598833,182348,202
+16269137,182550,175
+5298003,182725,125
+836730,182850,160
+3461744,183010,141
+5273947,183151,202
+5849,183353,155
+7120890,183508,178
+9207475,183686,144
+11842436,183830,231
+7874762,184061,126
+49155,184187,153
+9034,184340,60
+2900011,184400,223
+6056783,184623,129
+2922788,184752,139
+13654184,184891,178
+13660612,185069,178
+10538027,185247,178
+5243353,185425,196
+10012,185621,142
+14735843,185763,147
+8412864,185910,231
+31512,186141,159
+1330535,186300,270
+5038451,186570,154
+841836,186724,248
+300944,186972,174
+2682579,187146,329
+2409546,187475,178
+9983003,187653,139
+1851624,187792,224
+9170,188016,158
+14420788,188174,189
+4214326,188363,156
+11069189,188519,199
+9978043,188718,117
+24790,188835,151
+5257888,188986,260
+11572622,189246,252
+12592617,189498,252
+8399528,189750,149
+15769538,189899,149
+1608469,190048,291
+7899680,190339,146
+8940303,190485,144
+11306185,190629,178
+2383039,190807,157
+2896737,190964,123
+6333648,191087,161
+34561,191248,161
+6068576,191409,161
+10248875,191570,223
+13171014,191793,193
+4750187,191986,196
+8929235,192182,196
+2362725,192378,273
+2836,192651,153
+13107855,192804,228
+10772497,193032,119
+6072627,193151,111
+4990,193262,150
+14161110,193412,146
+7139270,193558,236
+1056192,193794,161
+9025,193955,169
+4226173,194124,114
+2382091,194238,177
+6876078,194415,161
+4476442,194576,161
+1323877,194737,210
+8394820,194947,117
+7882525,195064,161
+10515857,195225,161
+843684,195386,161
+11563711,195547,178
+7347652,195725,168
+6609568,195893,162
+1357879,196055,254
+6063635,196309,210
+13398804,196519,221
+12119653,196740,192
+9984944,196932,173
+14681830,197105,193
+12354902,197298,193
+3416967,197491,193
+9783,197684,178
+8473,197862,180
+16046587,198042,179
+3957248,198221,184
+12851198,198405,193
+9714149,198598,193
+6563639,198791,193
+10753841,198984,193
+6071197,199177,183
+9443452,199360,193
+5295352,199553,192
+8763,199745,155
+12646618,199900,193
+4607,200093,194
+7060,200287,154
+15790082,200441,193
+12634936,200634,193
+15760331,200827,193
+5289923,201020,174
+1858110,201194,166
+10494357,201360,169
+11565168,201529,129
+14974201,201658,177
+4736247,201835,177
+4983,202012,174
+9300,202186,174
+15208754,202360,174
+12608921,202534,160
+12351917,202694,160
+4996118,202854,160
+29664,203014,160
+6101,203174,155
+7805,203329,161
+7670,203490,161
+15730929,203651,161
+5817227,203812,161
+58290,203973,160
+3152230,204133,160
+15787902,204293,161
+9712906,204454,160
+7461,204614,161
+14991857,204775,287
+2362052,205062,170
+3420433,205232,160
+589070,205392,160
+269242,205552,160
+8952633,205712,160
+14955211,205872,160
+12356813,206032,173
+13640382,206205,173
+15506419,206378,185
+15993304,206563,185
+1103170,206748,160
+10519071,206908,160
+15756234,207068,160
+11286035,207228,160
+9745,207388,118
+20628,207506,139
+14727089,207645,139
+14165282,207784,139
+15729548,207923,169
+1626742,208092,196
+21016,208288,179
+7809,208467,154
+8169853,208621,115
+11052616,208736,181
+9985453,208917,130
+13907513,209047,130
+12331052,209177,171
+10751420,209348,179
+8711960,209527,139
+8700353,209666,137
+11017066,209803,130
+3423684,209933,159
+11597971,210092,243
+12849632,210335,207
+2672762,210542,139
+4783502,210681,196
+8128035,210877,190
+2665575,211067,202
+1344091,211269,265
+6558313,211534,139
+713,211673,171
+524369,211844,119
+4716,211963,158
+11297141,212121,196
+2376743,212317,196
+32967,212513,115
+312,212628,167
+5741,212795,267
+3969367,213062,262
+216,213324,136
+8006,213460,133
+12435,213593,139
+843,213732,132
+9569,213864,150
+32856,214014,148
+5501,214162,146
+4737479,214308,161
+8689766,214469,161
+7324,214630,132
+6949,214762,132
+6625,214894,132
+7490,215026,132
+5133,215158,132
+3648,215290,132
+16560324,215422,194
+11050450,215616,194
+57359,215810,194
+2670083,216004,172
+9452262,216176,118
+10524909,216294,284
+3828,216578,175
+5754,216753,175
+10758464,216928,245
+14984071,217173,138
+1605877,217311,196
+1108088,217507,114
+1112431,217621,189
+12862351,217810,189
+10522985,217999,189
+2649095,218188,194
+8832,218382,126
+4213460,218508,120
+9999308,218628,167
+3984787,218795,164
+2105765,218959,189
+7132810,219148,189
+13400527,219337,231
+6437,219568,165
+9729719,219733,161
+2905295,219894,189
+4741417,220083,189
+5808821,220272,189
+9347,220461,189
+8163,220650,189
+15745564,220839,139
+3938,220978,154
+7384,221132,148
+6571,221280,154
+4993870,221434,154
+8155324,221588,154
+15210595,221742,154
+2937153,221896,154
+3946983,222050,154
+12346945,222204,154
+8447194,222358,154
+8936848,222512,154
+13143761,222666,154
+11542401,222820,154
+5544465,222974,154
+12113938,223128,154
+1843665,223282,154
+2635320,223436,154
+16025030,223590,141
+13894911,223731,137
+13137243,223868,177
+8917582,224045,132
+5160,224177,126
+27550,224303,111
+5006913,224414,221
+6072426,224635,196
+6962,224831,149
+6090,224980,142
+7402389,225122,218
+4782016,225340,165
+5559,225505,109
+15244679,225614,114
+14718329,225728,180
+10530209,225908,157
+12369935,226065,199
+10266048,226264,196
+8439467,226460,165
+9479390,226625,172
+7398020,226797,258
+11031730,227055,193
+3163297,227248,239
+13370362,227487,165
+14724337,227652,142
+347,227794,140
+41128,227934,141
+49323,228075,143
+9208,228218,187
+6603,228405,187
+2885965,228592,149
+11286339,228741,156
+7550,228897,143
+15006607,229040,219
+1097045,229259,136
+12863931,229395,158
+16526686,229553,178
+11797528,229731,198
+9490301,229929,189
+15993418,230118,220
+16275968,230338,132
+16537052,230470,200
+524559,230670,245
+9705602,230915,158
+6306016,231073,163
+8933597,231236,163
+9552,231399,160
+13677252,231559,165
+5286718,231724,115
+3700426,231839,242
+272216,232081,196
+10281844,232277,196
+9229033,232473,167
+12106671,232640,175
+6342061,232815,175
+4467717,232990,185
+9210234,233175,144
+16270765,233319,189
+4066,233508,220
+8451630,233728,207
+6327575,233935,206
+15510968,234141,123
+9961895,234264,123
+6846957,234387,155
+9090,234542,205
+2420884,234747,123
+552257,234870,123
+11851197,234993,139
+10005052,235132,180
+12365096,235312,204
+16027934,235516,254
+9554,235770,129
+7137667,235899,165
+2679583,236064,219
+9998486,236283,117
+14432082,236400,114
+14473494,236514,196
+558,236710,117
+24752,236827,123
+8156043,236950,140
+16256900,237090,142
+4498477,237232,172
+7403885,237404,207
+12347972,237611,161
+15789656,237772,144
+540604,237916,178
+49392,238094,178
+9714609,238272,168
+6359,238440,149
+7945,238589,134
+11297293,238723,180
+524301,238903,152
+1864560,239055,130
+3203962,239185,139
+201,239324,140
+16554,239464,151
+13676749,239615,120
+7360687,239735,121
+16052126,239856,195
+1864717,240051,187
+6307530,240238,197
+7967,240435,169
+526,240604,138
+2099806,240742,225
+10253338,240967,196
+14985398,241163,196
+2378759,241359,196
+7630839,241555,178
+12103405,241733,184
+3504,241917,168
+3208889,242085,190
+8682475,242275,117
+5525787,242392,196
+6837100,242588,159
+1894939,242747,114
+13918510,242861,196
+11592421,243057,213
+8103,243270,173
+9455266,243443,138
+6584743,243581,158
+13414682,243739,175
+7355395,243914,171
+49508,244085,141
+14429643,244226,240
+2922082,244466,138
+13423586,244604,201
+15006445,244805,161
+2655029,244966,161
+14471062,245127,161
+11289842,245288,157
+1859371,245445,189
+1874156,245634,158
+7366171,245792,119
+11567033,245911,122
+294474,246033,151
+32997,246184,116
+10247310,246300,167
+13141794,246467,138
+8677438,246605,139
+14732797,246744,199
+2197,246943,160
+6335688,247103,178
+13415339,247281,350
+14988056,247631,139
+7618091,247770,135
+14731111,247905,123
+8449324,248028,123
+15741956,248151,172
+8442208,248323,214
+3176540,248537,208
+2386280,248745,252
+9216765,248997,119
+8698427,249116,135
+1413,249251,137
+2117233,249388,137
+6479,249525,135
+48442,249660,142
+8409115,249802,142
+10505732,249944,142
+4706,250086,135
+5287,250221,135
+5536,250356,135
+5820,250491,135
+5963,250626,135
+9833,250761,135
+11297258,250896,123
+3716429,251019,123
+1858802,251142,123
+11042355,251265,135
+9219,251400,135
+9220,251535,135
+6583,251670,135
+6064,251805,135
+8457,251940,135
+8456,252075,135
+6963,252210,135
+5598,252345,135
+750,252480,145
+14219024,252625,169
+3954974,252794,284
+12858965,253078,230
+14727653,253308,136
+12506,253444,182
+6580236,253626,182
+3699392,253808,182
+11011584,253990,160
+9858,254150,182
+2529,254332,155
+1360166,254487,142
+6291860,254629,170
+15751689,254799,160
+5255797,254959,160
+588936,255119,160
+159923,255279,132
+310,255411,149
+13651244,255560,123
+11577143,255683,123
+1313910,255806,129
+7145,255935,118
+6599,256053,183
+7395633,256236,190
+171406,256426,145
+16426,256571,163
+10799070,256734,192
+14203126,256926,135
+32887,257061,151
+2422186,257212,175
+9995145,257387,175
+8692838,257562,175
+12867438,257737,175
+5277033,257912,175
+24763,258087,154
+16306365,258241,160
+7887198,258401,160
+791584,258561,160
+9744650,258721,160
+3980285,258881,160
+10781745,259041,160
+10532005,259201,161
+15005935,259362,161
+14435437,259523,187
+7625386,259710,196
+327309,259906,196
+4915,260102,163
+5793562,260265,129
+9845,260394,150
+9470,260544,110
+12592390,260654,110
+4218242,260764,122
+14479113,260886,122
+14443704,261008,268
+3474,261276,173
+8547,261449,156
+11064311,261605,181
+5005534,261786,122
+12860871,261908,122
+4758820,262030,133
+572739,262163,122
+4517378,262285,158
+5789416,262443,139
+16255934,262582,139
+14435607,262721,139
+13150753,262860,139
+6126,262999,139
+4378,263138,139
+3999,263277,139
+1213,263416,139
+9794,263555,139
+9377,263694,139
+8720,263833,139
+8884,263972,139
+5274,264111,139
+5352,264250,139
+6592,264389,139
+57455,264528,139
+8427185,264667,139
+7372355,264806,139
+5423,264945,139
+8132,265084,139
+7419,265223,139
+9109,265362,139
+9135,265501,139
+16284538,265640,139
+244,265779,137
+5495,265916,146
+6891,266062,169
+7355449,266231,136
+9476053,266367,170
+11325556,266537,170
+3728325,266707,151
+5582,266858,139
+5538,266997,139
+5539,267136,139
+5540,267275,139
+202,267414,139
+7380521,267553,173
+10804016,267726,192
+4255791,267918,192
+7651910,268110,141
+4003,268251,169
+7530,268420,158
+9029,268578,183
+7081485,268761,183
+7087033,268944,183
+3151816,269127,183
+4846,269310,183
+5664,269493,183
+6499,269676,183
+8164,269859,183
+2118774,270042,183
+6784,270225,149
+8929788,270374,179
+12499,270553,162
+41007,270715,141
+9991229,270856,275
+10548313,271131,223
+5792598,271354,223
+9222244,271577,152
+6087412,271729,161
+12083567,271890,177
+4815,272067,177
+12529,272244,148
+7363087,272392,139
+4494842,272531,289
+9683,272820,160
+1854422,272980,175
+567642,273155,175
+9755593,273330,174
+2361956,273504,164
+4252208,273668,170
+8442397,273838,169
+13947268,274007,134
+10506196,274141,136
+13635289,274277,159
+5510259,274436,210
+8423154,274646,139
+14718055,274785,139
+578572,274924,139
+7112724,275063,139
+3160676,275202,139
+11337166,275341,139
+8178872,275480,139
+15992425,275619,139
+7649,275758,139
+9495226,275897,139
+9927,276036,139
+9926,276175,139
+838694,276314,128
+14720305,276442,139
+8934190,276581,139
+7653786,276720,127
+6078995,276847,122
+2625563,276969,120
+5750,277089,139
+5866,277228,139
+7031,277367,139
+7360,277506,139
+1067645,277645,139
+6816,277784,127
+6585,277911,117
+45264,278028,117
+49231,278145,133
+11565460,278278,186
+10776790,278464,200
+7636602,278664,117
+1573747,278781,117
+1375925,278898,117
+7875531,279015,117
+7995,279132,139
+8541,279271,139
+8554,279410,139
+7203,279549,127
+10795739,279676,126
+9572,279802,126
+10755954,279928,116
+12871321,280044,197
+13169200,280241,210
+9178851,280451,225
+13159794,280676,177
+16264216,280853,126
+1573245,280979,176
+5462,281155,148
+12636228,281303,158
+10492713,281461,177
+7659850,281638,154
+847791,281792,154
+16253560,281946,154
+10533694,282100,154
+8932074,282254,130
+8868,282384,126
+9972926,282510,123
+6557480,282633,127
+4671,282760,117
+3035,282877,117
+2115399,282994,117
+5269,283111,126
+3443374,283237,177
+8127448,283414,177
+12627028,283591,171
+2898326,283762,171
+15762017,283933,171
+12485,284104,163
+13667509,284267,144
+6191,284411,144
+6122,284555,144
+8634,284699,144
+12324261,284843,144
+13405411,284987,144
+14735290,285131,144
+1893068,285275,144
+9984325,285419,144
+9716818,285563,163
+11580488,285726,144
+13931681,285870,144
+5311,286014,133
+13414997,286147,176
+2625659,286323,176
+16545046,286499,176
+8702386,286675,176
+13161379,286851,180
+3980147,287031,268
+804809,287299,141
+20666,287440,145
+6042,287585,154
+7408,287739,157
+7768,287896,157
+8880,288053,157
+9217,288210,157
+1880055,288367,157
+1365581,288524,154
+9475300,288678,176
+11835834,288854,137
+292963,288991,243
+4235143,289234,219
+850368,289453,121
+5046034,289574,184
+11311650,289758,142
+2653403,289900,246
+8415920,290146,232
+4762888,290378,196
+5045061,290574,206
+39629,290780,206
+3955380,290986,137
+16053736,291123,137
+9759532,291260,137
+837425,291397,130
+7386069,291527,154
+2682218,291681,123
+12605155,291804,204
+15482615,292008,137
+850067,292145,139
+3989417,292284,139
+8675744,292423,139
+5585,292562,139
+7632,292701,139
+7635,292840,139
+11318035,292979,139
+3732030,293118,134
+15005852,293252,139
+7119104,293391,139
+2900280,293530,137
+4464289,293667,137
+7923665,293804,137
+6066144,293941,139
+9488274,294080,139
+12372661,294219,139
+13646259,294358,139
+4044,294497,139
+4848,294636,139
+1856,294775,161
+9381,294936,161
+13427157,295097,159
+10748601,295256,139
+14439264,295395,139
+7364,295534,137
+7691,295671,137
+8804,295808,137
+9651,295945,137
+3313,296082,131
+7882841,296213,137
+5823597,296350,178
+9445717,296528,135
+6566224,296663,137
+8171869,296800,206
+9822,297006,193
+9260,297199,193
+14201719,297392,136
+11596195,297528,229
+3433641,297757,137
+3695547,297894,137
+6076673,298031,137
+14436926,298168,137
+11557594,298305,137
+4227,298442,130
+10531788,298572,137
+15512023,298709,137
+10270292,298846,137
+7093221,298983,137
+11577910,299120,210
+7883655,299330,177
+14994946,299507,175
+4256520,299682,177
+8423703,299859,231
+10523463,300090,250
+15252392,300340,250
+9710771,300590,166
+10009,300756,203
+4200095,300959,207
+16051256,301166,207
+1311847,301373,209
+8401116,301582,130
+10802552,301712,130
+1363858,301842,207
+2153702,302049,207
+1362976,302256,229
+2384001,302485,159
+10801548,302644,123
+9500242,302767,266
+2367211,303033,123
+13379055,303156,123
+8966040,303279,196
+16256323,303475,193
+3733641,303668,196
+13662901,303864,196
+6598,304060,157
+7641,304217,193
+6525,304410,193
+8146085,304603,121
+5284,304724,193
+7920904,304917,193
+10277406,305110,193
+11808850,305303,196
+8442011,305499,196
+1871452,305695,196
+8680490,305891,159
+10277451,306050,159
+13138779,306209,159
+2008,306368,152
+12598799,306520,121
+9457195,306641,196
+2099437,306837,196
+13566,307033,196
+13128085,307229,196
+4246440,307425,213
+13921884,307638,213
+8934356,307851,236
+311407,308087,236
+2108353,308323,236
+5547291,308559,236
+9576,308795,236
+7871930,309031,186
+9630,309217,215
+27534,309432,203
+13920936,309635,189
+12365227,309824,122
+16558145,309946,122
+3977563,310068,122
+3438023,310190,122
+11578794,310312,122
+11814750,310434,122
+12106779,310556,196
+5778167,310752,196
+2414881,310948,122
+8684401,311070,122
+6991,311192,122
+5016559,311314,184
+5244587,311498,139
+16533743,311637,191
+7371752,311828,191
+4988876,312019,191
+36973,312210,141
+37035,312351,141
+20564,312492,143
+20491,312635,143
+989,312778,152
+20563,312930,141
+20560,313071,141
+13938960,313212,198
+14968995,313410,198
+2388361,313608,128
+9993203,313736,128
+10548989,313864,128
+13678018,313992,128
+7906564,314120,130
+7138539,314250,128
+3408035,314378,172
+36907,314550,143
+57487,314693,147
+6248,314840,134
+8942934,314974,142
+16554311,315116,142
+7086166,315258,142
+5618,315400,167
+9496250,315567,165
+9752,315732,165
+16018692,315897,141
+57368,316038,144
+3182,316182,143
+3750,316325,143
+7520,316468,140
+7094634,316608,142
+15524265,316750,142
+12609455,316892,142
+11334341,317034,142
+2359751,317176,142
+6850215,317318,142
+12592476,317460,142
+3935779,317602,142
+576616,317744,142
+796452,317886,142
+7142025,318028,142
+57507,318170,147
+6302416,318317,131
+7626268,318448,160
+287347,318608,142
+14201232,318750,142
+8448111,318892,142
+11304586,319034,142
+1894493,319176,142
+11050273,319318,142
+6855906,319460,142
+9150,319602,131
+1595699,319733,134
+4479017,319867,131
+16010757,319998,142
+8920572,320140,142
+4113,320282,147
+12,320429,147
+2674665,320576,123
+41024,320699,123
+10549321,320822,142
+3985656,320964,123
+6818087,321087,123
+7127659,321210,123
+4511876,321333,123
+9736,321456,123
+9904,321579,123
+9915,321702,123
+13933088,321825,123
+16260831,321948,123
+13117972,322071,123
+3934036,322194,123
+10793367,322317,123
+15774841,322440,123
+1086441,322563,123
+4467296,322686,123
+10801618,322809,123
+2674650,322932,123
+12389,323055,123
+5201,323178,123
+7762,323301,123
+8681,323424,123
+13371616,323547,123
+283731,323670,123
+16054609,323793,123
+12608404,323916,123
+1617807,324039,123
+13153719,324162,123
+9482783,324285,123
+3209157,324408,123
+4240277,324531,123
+4520770,324654,123
+15240488,324777,123
+9737254,324900,123
+2129268,325023,123
+16052570,325146,123
+13135645,325269,123
+3182763,325392,123
+9186730,325515,123
+8684806,325638,123
+10026644,325761,123
+14155853,325884,123
+6561804,326007,123
+13120331,326130,123
+6612610,326253,123
+12118102,326376,123
+14194325,326499,123
+1350114,326622,123
+11802833,326745,123
+10231931,326868,123
+11560381,326991,123
+5514902,327114,123
+6595531,327237,123
+9452690,327360,123
+14163314,327483,123
+3412632,327606,123
+7399212,327729,123
+7400676,327852,123
+6860320,327975,123
+11306915,328098,123
+14203692,328221,123
+13651838,328344,123
+2128112,328467,123
+14724299,328590,123
+10525083,328713,123
+2368526,328836,123
+15784952,328959,123
+4748398,329082,123
+5549607,329205,123
+16574872,329328,123
+834719,329451,123
+3421755,329574,123
+13674039,329697,123
+7905136,329820,123
+10285959,329943,123
+11033464,330066,123
+13170256,330189,123
+11046436,330312,123
+7096889,330435,127
+8682832,330562,156
+5297564,330718,178
+2132335,330896,199
+3166923,331095,174
+300613,331269,274
+1887717,331543,256
+6820865,331799,193
+5286366,331992,169
+11280343,332161,196
+8962626,332357,136
+1311468,332493,158
+14693604,332651,157
+3459568,332808,150
+6858792,332958,196
+13377768,333154,123
+4767604,333277,223
+7115604,333500,268
+14474247,333768,138
+3707349,333906,214
+9233114,334120,157
+3678599,334277,152
+7919282,334429,114
+15261398,334543,178
+14451446,334721,119
+7358479,334840,123
+3979051,334963,133
+4758082,335096,129
+2150752,335225,60
+12360753,335285,196
+14191436,335481,129
+3689616,335610,139
+15773927,335749,123
+3677219,335872,223
+6593042,336095,222
+11307413,336317,169
+289272,336486,123
+3156414,336609,176
+2147236,336785,132
+14992081,336917,196
+13956286,337113,150
+4765216,337263,112
+14190798,337375,143
+3177650,337518,142
+8681843,337660,212
+15250632,337872,161
+13666274,338033,161
+15752059,338194,161
+11552703,338355,161
+8129478,338516,161
+8191632,338677,171
+8674066,338848,196
+2118961,339044,161
+1083020,339205,139
+4521379,339344,151
+11052949,339495,193
+9465769,339688,234
+6356310,339922,171
+9990376,340093,156
+4482410,340249,226
+7924537,340475,203
+816492,340678,153
+13925296,340831,164
+15737422,340995,152
+13393855,341147,251
+13171144,341398,220
+8439270,341618,149
+1105803,341767,312
+12849909,342079,189
+6047015,342268,137
+14691506,342405,264
+6319559,342669,193
+6876580,342862,213
+2934227,343075,135
+16013118,343210,199
+13648670,343409,117
+5557520,343526,203
+4230492,343729,182
+16572923,343911,139
+15241504,344050,193
+13957537,344243,196
+5521581,344439,161
+10757341,344600,154
+1333891,344754,131
+8408705,344885,161
+12622449,345046,244
+6559359,345290,124
+3410752,345414,159
+4720234,345573,150
+12384273,345723,183
+9439801,345906,136
+13680831,346042,208
+15229374,346250,137
+5796038,346387,215
+16551824,346602,175
+7603243,346777,264
+16284399,347041,169
+2107580,347210,172
+2366468,347382,241
+13655162,347623,120
+12344396,347743,149
+8941619,347892,181
+14440166,348073,213
+13407797,348286,127
+4489451,348413,193
+4204564,348606,137
+1327430,348743,183
+9761182,348926,207
+12080829,349133,126
+4236783,349259,312
+12882508,349571,159
+7642339,349730,140
+13915478,349870,140
+5263402,350010,130
+7640631,350140,251
+8971779,350391,163
+2927891,350554,239
+7908543,350793,126
+12881551,350919,193
+12858988,351112,134
+5519003,351246,225
+4248202,351471,163
+4219574,351634,155
+6296203,351789,135
+8700904,351924,136
+10277723,352060,161
+11050938,352221,161
+12095174,352382,143
+12374373,352525,134
+2679926,352659,140
+5022997,352799,224
+8142006,353023,253
+1867042,353276,159
+2146413,353435,249
+4753128,353684,149
+7643978,353833,183
+11035653,354016,137
+3200391,354153,169
+6826230,354322,148
+14442657,354470,177
+1091161,354647,141
+5801326,354788,116
+9212169,354904,213
+5507469,355117,170
+13654952,355287,178
+14990041,355465,132
+15489511,355597,149
+12596677,355746,158
+10527714,355904,155
+7623805,356059,134
+59112,356193,242
+5305404,356435,118
+15239075,356553,170
+1099390,356723,207
+566728,356930,168
+16286841,357098,216
+2894231,357314,149
+13918514,357463,189
+5546064,357652,167
+4992131,357819,262
+9473033,358081,123
+14429955,358204,182
+3673723,358386,167
+2897814,358553,140
+5799863,358693,179
+584489,358872,190
+4233997,359062,262
+14207882,359324,160
+7404684,359484,146
+5771404,359630,141
+5010435,359771,137
+9198944,359908,167
+12348237,360075,114
+13160473,360189,204
+9445761,360393,230
+8689281,360623,215
+2925326,360838,226
+8685299,361064,171
+1856022,361235,179
+6330833,361414,152
+11552021,361566,152
+1329291,361718,200
+2101973,361918,213
+7106302,362131,153
+3672317,362284,132
+7882081,362416,165
+9752113,362581,126
+8452331,362707,168
+13907927,362875,178
+2883851,363053,166
+319195,363219,152
+1853504,363371,145
+6312129,363516,137
+2890289,363653,179
+9483910,363832,178
+15522257,364010,220
+7078515,364230,204
+5562112,364434,162
+2157940,364596,216
+10507954,364812,200
+4482670,365012,120
+2379549,365132,118
+9744099,365250,202
+6076108,365452,173
+7363374,365625,175
+6034709,365800,180
+13654500,365980,161
+1352548,366141,161
+11799238,366302,136
+14182126,366438,207
+2632140,366645,162
+1591919,366807,196
+1098619,367003,167
+15228267,367170,155
+11799364,367325,185
+3420612,367510,116
+5308146,367626,155
+3458512,367781,180
+10490587,367961,137
+4725380,368098,159
+14444090,368257,187
+581407,368444,136
+5775207,368580,189
+4728552,368769,139
+13654769,368908,243
+16572806,369151,141
+5566354,369292,196
+15525138,369488,121
+3182991,369609,136
+6091947,369745,187
+570019,369932,145
+7352413,370077,177
+4751940,370254,174
+13119848,370428,172
+4240333,370600,157
+2372460,370757,60
+2106724,370817,168
+13161872,370985,149
+8191842,371134,226
+8697244,371360,137
+12623142,371497,147
+4467000,371644,215
+10541714,371859,184
+15529771,372043,181
+5043291,372224,139
+11561329,372363,123
+1608159,372486,145
+5556239,372631,252
+14996274,372883,252
+794662,373135,134
+2636694,373269,136
+6589854,373405,186
+13407703,373591,111
+16517622,373702,233
+12383772,373935,217
+16552507,374152,131
+14696265,374283,167
+8955708,374450,162
+8968546,374612,165
+13671472,374777,177
+9740095,374954,249
+15210492,375203,213
+7929570,375416,175
+552434,375591,165
+6846536,375756,178
+4772047,375934,161
+10239658,376095,166
+1899707,376261,133
+16314373,376394,157
+2647403,376551,185
+13410101,376736,138
+14469011,376874,131
+4475025,377005,151
+6038860,377156,143
+13905699,377299,141
+10010859,377440,157
+15745016,377597,122
+11584852,377719,189
+4779654,377908,206
+8947988,378114,163
+15741466,378277,144
+11043313,378421,121
+12904836,378542,252
+13658576,378794,173
+16520009,378967,147
+8684595,379114,151
+4506374,379265,147
+6299907,379412,148
+16517024,379560,140
+1896168,379700,150
+9449933,379850,147
+14975364,379997,114
+1360009,380111,137
+16037605,380248,148
+6356957,380396,144
+2360591,380540,183
+11283875,380723,118
+8952998,380841,142
+9470842,380983,200
+8436454,381183,109
+16294580,381292,200
+14702324,381492,149
+8672924,381641,143
+7908876,381784,146
+11543795,381930,136
+808101,382066,168
+9194937,382234,125
+7916126,382359,115
+2906629,382474,131
+13926858,382605,123
+14178519,382728,124
+11589573,382852,123
+10762857,382975,111
+10241190,383086,142
+5036484,383228,240
+5300423,383468,162
+11829883,383630,135
+14442038,383765,139
+14462366,383904,140
+12115819,384044,149
+10258568,384193,132
+1094251,384325,157
+5042222,384482,131
+2656796,384613,137
+14470844,384750,215
+1624295,384965,205
+10500891,385170,154
+8179004,385324,189
+9978842,385513,149
+576069,385662,185
+3984007,385847,144
+8153779,385991,162
+1580011,386153,155
+8693635,386308,133
+268804,386441,105
+6846031,386546,183
+3450337,386729,130
+8419758,386859,169
+8174854,387028,138
+9747030,387166,212
+3726267,387378,182
+4491867,387560,145
+7097215,387705,160
+9473092,387865,184
+6851253,388049,144
+2397130,388193,144
+838541,388337,145
+9468304,388482,173
+7605979,388655,156
+7111526,388811,204
+16268622,389015,192
+7656501,389207,182
+7920031,389389,168
+1321938,389557,134
+10264842,389691,135
+8943772,389826,138
+10783067,389964,162
+13671690,390126,119
+15475103,390245,136
+11062469,390381,130
+5785231,390511,178
+9985350,390689,155
+16293816,390844,174
+15791534,391018,135
+16531371,391153,282
+9997898,391435,229
+15477488,391664,122
+16274607,391786,132
+5553911,391918,168
+5290120,392086,169
+8160006,392255,141
+4467455,392396,170
+1314127,392566,192
+4482901,392758,132
+14744300,392890,152
+8185195,393042,209
+13913244,393251,260
+2150084,393511,153
+13387523,393664,191
+11324046,393855,148
+560719,394003,163
+5506358,394166,119
+7114929,394285,137
+13400885,394422,178
+316471,394600,183
+13431815,394783,161
+14423954,394944,159
+2662977,395103,129
+5281905,395232,191
+297987,395423,204
+8930858,395627,161
+13107800,395788,121
+3176555,395909,213
+2154303,396122,194
+16273773,396316,158
+4475493,396474,144
+7621609,396618,162
+16539672,396780,177
+15998994,396957,122
+10006585,397079,114
+12071080,397193,183
+5035575,397376,209
+9713376,397585,310
+5513976,397895,178
+4746867,398073,136
+6555070,398209,127
+6581994,398336,130
+13661055,398466,150
+15252285,398616,176
+2631773,398792,187
+847897,398979,174
+9740212,399153,213
+4220966,399366,142
+16264136,399508,192
+6341527,399700,126
+14712712,399826,133
+1866951,399959,130
+3414818,400089,199
+4216332,400288,148
+5824556,400436,127
+7910350,400563,146
+8918059,400709,139
+10812622,400848,166
+3450508,401014,180
+3414604,401194,199
+297186,401393,161
+10779343,401554,165
+12330525,401719,178
+15257094,401897,163
+13169542,402060,211
+14736544,402271,208
+8662901,402479,128
+13384767,402607,148
+2910650,402755,142
+13942655,402897,117
+2912963,403014,133
+12863544,403147,142
+13163977,403289,204
+7112326,403493,127
+13937742,403620,136
+2116717,403756,177
+4244694,403933,247
+11020620,404180,177
+7390892,404357,163
+8127751,404520,168
+8915205,404688,150
+3200106,404838,151
+2632882,404989,252
+6612377,405241,158
+3180953,405399,207
+13144902,405606,161
+16036737,405767,126
+7663874,405893,231
+10520093,406124,203
+5279087,406327,135
+15261223,406462,252
+9743562,406714,150
+10262310,406864,136
+9470560,407000,152
+13954567,407152,165
+16559375,407317,137
+9980932,407454,223
+10807697,407677,192
+3966632,407869,157
+8713363,408026,127
+12374391,408153,252
+11328474,408405,199
+13903697,408604,149
+1064426,408753,188
+15752648,408941,141
+13393239,409082,213
+6604391,409295,129
+15790688,409424,113
+281839,409537,185
+5013583,409722,156
+8181602,409878,171
+9444647,410049,178
+10236280,410227,261
+11585883,410488,182
+5032531,410670,129
+9502585,410799,161
+11539464,410960,181
+531963,411141,238
+9977759,411379,210
+12073162,411589,176
+12865196,411765,221
+11010432,411986,156
+808225,412142,141
+6857742,412283,149
+16041687,412432,128
+13945454,412560,117
+6046674,412677,124
+14158275,412801,126
+14729911,412927,128
+10492183,413055,149
+6863065,413204,137
+9489444,413341,135
+2943089,413476,153
+16284514,413629,251
+4204299,413880,180
+7667272,414060,140
+8436060,414200,165
+3716541,414365,131
+2134410,414496,124
+15003389,414620,154
+1072319,414774,138
+10776185,414912,154
+13142659,415066,249
+9225697,415315,215
+6595393,415530,213
+7903485,415743,140
+13657012,415883,128
+10245148,416011,202
+9188144,416213,151
+555946,416364,145
+2421469,416509,152
+2143686,416661,148
+15000585,416809,133
+12089283,416942,127
+19762,417069,155
+16558512,417224,238
+9756288,417462,145
+2901019,417607,166
+15485331,417773,209
+11578618,417982,160
+9232513,418142,178
+10767917,418320,162
+839163,418482,146
+10259738,418628,161
+4719458,418789,194
+1599295,418983,148
+8129104,419131,137
+5247467,419268,136
+5562211,419404,162
+4256489,419566,125
+7622009,419691,150
+10224755,419841,177
+11853818,420018,166
+6823074,420184,137
+6309398,420321,200
+14964244,420521,136
+3965877,420657,208
+2662802,420865,138
+1077231,421003,158
+7094470,421161,145
+1067185,421306,213
+13931424,421519,132
+584685,421651,204
+14458788,421855,132
+4506523,421987,132
+12862823,422119,192
+4782259,422311,143
+14209660,422454,144
+11538947,422598,180
+9995953,422778,195
+7377912,422973,144
+2667435,423117,137
+12904382,423254,145
+5801804,423399,187
+2658768,423586,240
+12631362,423826,138
+16536270,423964,127
+6048294,424091,159
+6353647,424250,171
+12599082,424421,141
+3677258,424562,208
+14206609,424770,174
+14958498,424944,200
+16037674,425144,133
+7641461,425277,138
+2908762,425415,176
+2127055,425591,203
+14742986,425794,207
+11071270,426001,130
+2153619,426131,160
+4465578,426291,143
+8191528,426434,135
+15208494,426569,159
+808540,426728,209
+9202404,426937,144
+5519720,427081,157
+4459773,427238,148
+9229218,427386,117
+14167521,427503,136
+1324427,427639,168
+62467,427807,124
+5534616,427931,167
+14721807,428098,114
+8969366,428212,190
+2114618,428402,192
+12859706,428594,123
+6038649,428717,127
+15504167,428844,166
+10547076,429010,170
+6574462,429180,271
+13909374,429451,163
+11327958,429614,133
+4728879,429747,178
+6343675,429925,125
+8132109,430050,147
+10786747,430197,201
+5002279,430398,147
+8442251,430545,185
+4229344,430730,315
+15225988,431045,221
+7646838,431266,148
+15473241,431414,167
+8917046,431581,208
+6862588,431789,208
+15508123,431997,115
+314900,432112,129
+12892825,432241,214
+10785612,432455,141
+13685266,432596,124
+11551581,432720,126
+526570,432846,117
+15258755,432963,203
+1868900,433166,196
+3436170,433362,140
+6615618,433502,159
+6353537,433661,179
+9707927,433840,205
+10535902,434045,199
+13658526,434244,178
+835776,434422,199
+538524,434621,163
+14159331,434784,138
+11588341,434922,151
+7379467,435073,158
+15793568,435231,176
+11818352,435407,102
+1051951,435509,155
+1322485,435664,128
+5265320,435792,141
+57083,435933,141
+3973909,436074,201
+16265364,436275,174
+1091890,436449,248
+3472495,436697,119
+12628823,436816,181
+3971263,436997,148
+13676268,437145,200
+15209252,437345,219
+14972884,437564,226
+3727502,437790,172
+14993414,437962,226
+14743998,438188,142
+12095252,438330,147
+8164530,438477,145
+4467459,438622,141
+16020426,438763,149
+16316415,438912,147
+11016024,439059,158
+8921106,439217,150
+6351190,439367,138
+15470880,439505,168
+16291791,439673,210
+570575,439883,163
+12883362,440046,268
+9201784,440314,116
+2106776,440430,125
+3733687,440555,155
+16307298,440710,208
+10542084,440918,166
+4218970,441084,166
+10505409,441250,148
+3450810,441398,201
+287712,441599,122
+11837158,441721,159
+12340089,441880,146
+10784773,442026,252
+12847819,442278,141
+15232366,442419,192
+6821381,442611,201
+13934634,442812,141
+3952199,442953,133
+16025457,443086,136
+5526509,443222,146
+14189,443368,178
+5243020,443546,185
+9448244,443731,159
+8962926,443890,256
+5021312,444146,167
+6089550,444313,157
+3451545,444470,114
+6575459,444584,144
+9714416,444728,132
+6575138,444860,155
+527748,445015,117
+8972050,445132,151
+13898427,445283,175
+2406540,445458,135
+12385932,445593,127
+6594291,445720,141
+2407361,445861,156
+10275545,446017,132
+290114,446149,134
+14214979,446283,151
+6573424,446434,124
+14467329,446558,188
+3991076,446746,165
+14217458,446911,132
+8413191,447043,112
+3713105,447155,124
+9756880,447279,169
+14157102,447448,162
+8426604,447610,175
+13684574,447785,127
+1573882,447912,133
+3173980,448045,155
+13145298,448200,183
+13149728,448383,125
+15491684,448508,173
+61521,448681,131
+16553068,448812,150
+4225819,448962,150
+4248921,449112,154
+3173566,449266,173
+1587237,449439,156
+8145784,449595,138
+6594791,449733,141
+14481496,449874,191
+9702189,450065,211
+8404829,450276,216
+4243223,450492,168
+7866168,450660,137
+2111420,450797,184
+9712027,450981,132
+57717,451113,140
+13389852,451253,152
+317315,451405,160
+5548500,451565,134
+11592974,451699,131
+6586507,451830,135
+4768172,451965,139
+9984138,452104,146
+2373615,452250,180
+2666700,452430,125
+2120542,452555,209
+12605607,452764,151
+15482629,452915,275
+4758498,453190,159
+8454056,453349,141
+14956027,453490,173
+13122373,453663,112
+15235233,453775,144
+13430600,453919,141
+15747946,454060,228
+6598156,454288,141
+15260310,454429,253
+11851998,454682,154
+13144126,454836,134
+5557671,454970,230
+8940406,455200,270
+7927760,455470,153
+2127360,455623,155
+15733699,455778,208
+305194,455986,132
+14962200,456118,160
+2115233,456278,162
+16515533,456440,142
+10259441,456582,185
+14429802,456767,154
+1346160,456921,122
+45880,457043,208
+8660109,457251,150
+16574610,457401,232
+1077753,457633,151
+12083743,457784,141
+15729195,457925,128
+13915055,458053,157
+1617229,458210,168
+9750251,458378,156
+8666958,458534,160
+13120050,458694,143
+5543032,458837,163
+10514000,459000,179
+5011279,459179,168
+13681282,459347,141
+1342899,459488,187
+15514889,459675,142
+9717398,459817,154
+5538939,459971,136
+3942243,460107,186
+11596220,460293,171
+12069003,460464,196
+9490715,460660,159
+3450205,460819,161
+8400404,460980,133
+13943292,461113,132
+3456166,461245,216
+5780953,461461,141
+6609170,461602,140
+12876591,461742,233
+5278411,461975,208
+3985774,462183,233
+16526893,462416,158
+4195340,462574,126
+14433412,462700,156
+13636382,462856,165
+64624,463021,175
+7355096,463196,233
+7359150,463429,167
+4240380,463596,149
+10752846,463745,116
+11573544,463861,160
+319944,464021,193
+9736174,464214,136
+5297879,464350,134
+8974455,464484,141
+5797153,464625,124
+12848905,464749,146
+4781181,464895,200
+15761839,465095,168
+7345156,465263,171
+11810295,465434,198
+9987818,465632,182
+9973760,465814,209
+9490197,466023,132
+9734915,466155,229
+2883635,466384,131
+11278751,466515,213
+8145538,466728,131
+9758792,466859,142
+11296396,467001,173
+1630856,467174,130
+1848817,467304,213
+8402007,467517,157
+6032571,467674,174
+12854318,467848,168
+2410606,468016,146
+15773265,468162,122
+12061597,468284,192
+3170584,468476,142
+5010279,468618,172
+9497184,468790,144
+5271781,468934,221
+8397429,469155,191
+13431717,469346,173
+1354211,469519,143
+16312842,469662,155
+3682732,469817,145
+5786649,469962,251
+6580668,470213,211
+11858723,470424,152
+2642226,470576,221
+14954486,470797,196
+8706504,470993,156
+9743032,471149,177
+2683736,471326,155
+1360413,471481,148
+13141049,471629,144
+15777687,471773,146
+12864208,471919,136
+15498653,472055,122
+13115022,472177,140
+11044754,472317,189
+1372357,472506,116
+15254057,472622,155
+3974955,472777,160
+3152424,472937,137
+321122,473074,134
+16284556,473208,138
+2634768,473346,166
+845871,473512,156
+4257004,473668,141
+1357629,473809,144
+9735504,473953,131
+10761169,474084,188
+6077854,474272,238
+583282,474510,154
+12117385,474664,129
+8970400,474793,213
+16519357,475006,158
+15778428,475164,230
+2366092,475394,146
+13913984,475540,166
+10755008,475706,165
+2120490,475871,60
+15991585,475931,125
+10514857,476056,132
+10806062,476188,178
+13156646,476366,162
+6610460,476528,129
+11035298,476657,167
+9981591,476824,171
+6609921,476995,165
+16523200,477160,113
+12347268,477273,120
+6872296,477393,152
+4755010,477545,124
+6321800,477669,121
+7916942,477790,123
+2916453,477913,161
+3981510,478074,163
+4483243,478237,171
+16257079,478408,140
+7906947,478548,104
+15738226,478652,141
+327505,478793,164
+5027050,478957,164
+13913124,479121,225
+16303736,479346,129
+7121741,479475,160
+2928863,479635,169
+15525205,479804,176
+5831054,479980,127
+11846734,480107,159
+7372510,480266,137
+12615232,480403,240
+14962473,480643,171
+11826335,480814,164
+8145576,480978,183
+8425920,481161,140
+14704569,481301,141
+14685246,481442,134
+9492562,481576,158
+3670423,481734,201
+11272911,481935,240
+13898390,482175,156
+4724556,482331,157
+3447309,482488,136
+9457787,482624,178
+554751,482802,157
+1866769,482959,135
+2140709,483094,123
+12906229,483217,173
+14733101,483390,164
+13930927,483554,175
+12891410,483729,164
+13553,483893,146
+9712605,484039,121
+14689592,484160,148
+13400624,484308,171
+12095034,484479,166
+5803273,484645,141
+12632512,484786,143
+6297031,484929,112
+14426120,485041,178
+1868720,485219,137
+10801617,485356,146
+12882707,485502,174
+8141088,485676,156
+2670810,485832,137
+10254250,485969,146
+1108206,486115,131
+10779679,486246,134
+13921498,486380,140
+6085016,486520,160
+6838655,486680,133
+15754717,486813,152
+7366018,486965,194
+3461828,487159,155
+13945775,487314,132
+286038,487446,172
+6824779,487618,150
+1850855,487768,143
+5815335,487911,141
+2151943,488052,132
+7135408,488184,112
+10289086,488296,135
+63584,488431,176
+12106354,488607,109
+4472097,488716,125
+3164475,488841,217
+10771495,489058,163
+7079008,489221,164
+7365655,489385,160
+1634147,489545,141
+2125804,489686,129
+1051954,489815,142
+8957121,489957,156
+8919214,490113,150
+8187277,490263,125
+10796641,490388,173
+13663717,490561,163
+318796,490724,120
+10751171,490844,141
+5028515,490985,181
+11055572,491166,141
+15498356,491307,213
+13434033,491520,161
+3938937,491681,199
+8188056,491880,159
+15492817,492039,127
+3694531,492166,164
+8948573,492330,173
+7915195,492503,148
+8694161,492651,146
+6846540,492797,146
+16308054,492943,157
+304115,493100,116
+1841107,493216,141
+8183876,493357,122
+2640979,493479,123
+6606893,493602,172
+9457983,493774,159
+8929729,493933,200
+10253588,494133,119
+5044023,494252,164
+15783783,494416,144
+13126773,494560,141
+13107878,494701,155
+5016405,494856,153
+7101662,495009,136
+3470235,495145,114
+15232218,495259,218
+2362154,495477,140
+46550,495617,134
+5540130,495751,138
+5293453,495889,137
+2401324,496026,124
+4993161,496150,169
+4723273,496319,155
+2402615,496474,126
+3441410,496600,132
+11812274,496732,138
+8713804,496870,129
+12618607,496999,200
+16281295,497199,122
+9208833,497321,60
+4228243,497381,122
+7907005,497503,200
+3938581,497703,132
+15511814,497835,150
+13120952,497985,131
+16293133,498116,157
+2899774,498273,132
+565143,498405,161
+3455569,498566,151
+7106617,498717,144
+9973078,498861,141
+1340275,499002,118
+16568162,499120,130
+544284,499250,139
+8959527,499389,140
+15755347,499529,153
+10792376,499682,187
+10793249,499869,159
+14689846,500028,146
+6051784,500174,132
+13921471,500306,127
+14689840,500433,159
+15517826,500592,141
+7142841,500733,223
+1054878,500956,137
+9197253,501093,163
+13416584,501256,130
+7102074,501386,217
+11807934,501603,161
+13378072,501764,163
+13134878,501927,142
+10491993,502069,201
+15205741,502270,146
+12867958,502416,143
+9480129,502559,168
+8436396,502727,129
+5254644,502856,163
+2936103,503019,129
+1065833,503148,195
+12610575,503343,134
+13135030,503477,138
+5786042,503615,178
+53532,503793,128
+6298895,503921,132
+11073867,504053,147
+819760,504200,232
+7629698,504432,118
+10272887,504550,129
+3977599,504679,144
+13390937,504823,125
+16309370,504948,134
+13955395,505082,142
+12121906,505224,147
+15261682,505371,156
+11857236,505527,143
+25664,505670,141
+9749737,505811,197
+8930273,506008,141
+3442218,506149,157
+11330376,506306,127
+5544470,506433,153
+9443502,506586,194
+300193,506780,144
+15001,506924,141
+15002,507065,141
+15000,507206,141
+5285603,507347,140
+5280591,507487,161
+12104135,507648,143
+14429222,507791,168
+13898198,507959,145
+10268618,508104,141
+1839055,508245,145
+10243726,508390,121
+7369423,508511,125
+15519758,508636,166
+10792192,508802,141
+5021412,508943,163
+13136456,509106,134
+12877135,509240,141
+3989278,509381,141
+9989576,509522,243
+7122016,509765,131
+15748082,509896,157
+273339,510053,144
+16517239,510197,140
+6617456,510337,225
+13119124,510562,176
+8394621,510738,146
+8158180,510884,180
+15785585,511064,213
+6345482,511277,160
+2412321,511437,259
+1096357,511696,166
+12361125,511862,140
+2685907,512002,190
+5795542,512192,60
+15478929,512252,141
+6601745,512393,115
+13156668,512508,187
+16035009,512695,141
+4233169,512836,142
+846134,512978,135
+10497779,513113,194
+10524677,513307,185
+6306079,513492,128
+15246529,513620,164
+13161153,513784,183
+14717267,513967,175
+8955325,514142,121
+13944678,514263,129
+10002,514392,128
+10015,514520,149
+9996,514669,141
+9935,514810,124
+9959,514934,216
+9952,515150,146
+9987,515296,158
+9971,515454,115
+9893,515569,153
+9891,515722,178
+9885,515900,175
+9879,516075,150
+9866,516225,135
+9865,516360,167
+9925,516527,249
+9924,516776,155
+9928,516931,132
+9850,517063,249
+9922,517312,150
+9861,517462,134
+9897,517596,159
+9842,517755,138
+9725,517893,161
+9728,518054,156
+9727,518210,199
+9732,518409,170
+9817,518579,163
+9809,518742,141
+9746,518883,159
+9750,519042,136
+9739,519178,141
+9763,519319,187
+9767,519506,130
+9806,519636,150
+9807,519786,158
+9761,519944,156
+9756,520100,135
+9828,520235,149
+9785,520384,139
+9670,520523,150
+9669,520673,184
+9671,520857,167
+9702,521024,165
+9696,521189,160
+9694,521349,151
+9648,521500,128
+9645,521628,182
+9644,521810,152
+9643,521962,167
+9708,522129,137
+9709,522266,142
+9705,522408,181
+9658,522589,148
+9659,522737,173
+9656,522910,165
+9649,523075,181
+9633,523256,129
+9715,523385,192
+9693,523577,170
+9678,523747,120
+9545,523867,220
+9529,524087,130
+9527,524217,165
+9528,524382,221
+9540,524603,136
+9522,524739,135
+9565,524874,151
+9560,525025,133
+9546,525158,174
+9551,525332,145
+9603,525477,141
+9617,525618,127
+9613,525745,116
+9585,525861,213
+9626,526074,132
+9474,526206,121
+9464,526327,165
+9465,526492,141
+9458,526633,218
+9492,526851,193
+9483,527044,150
+9478,527194,161
+9500,527355,107
+9498,527462,157
+9441,527619,150
+9454,527769,158
+9443,527927,129
+9479,528056,122
+9433,528178,120
+9358,528298,121
+9364,528419,186
+9353,528605,141
+9327,528746,144
+9321,528890,130
+9343,529020,135
+9333,529155,166
+9411,529321,141
+9397,529462,135
+9392,529597,110
+9412,529707,141
+9373,529848,161
+9316,530009,142
+9314,530151,145
+9248,530296,128
+9246,530424,163
+9247,530587,161
+9230,530748,178
+9312,530926,173
+9308,531099,171
+9277,531270,170
+9271,531440,136
+9284,531576,163
+9235,531739,141
+9295,531880,158
+9181,532038,135
+9182,532173,140
+9177,532313,138
+9178,532451,194
+9221,532645,137
+9192,532782,149
+9187,532931,138
+9143,533069,166
+9213,533235,159
+9199,533394,149
+9132,533543,141
+9176,533684,115
+9119,533799,157
+9117,533956,164
+9116,534120,137
+9112,534257,124
+9051,534381,120
+9049,534501,242
+9047,534743,192
+9045,534935,177
+9075,535112,145
+9063,535257,130
+9064,535387,150
+9070,535537,156
+9062,535693,207
+9103,535900,155
+9088,536055,116
+9021,536171,136
+9023,536307,131
+8987,536438,154
+8990,536592,177
+8991,536769,268
+8816,537037,149
+8979,537186,166
+8976,537352,171
+8909,537523,186
+8908,537709,143
+8907,537852,136
+8902,537988,140
+8936,538128,167
+8937,538295,149
+8934,538444,204
+8931,538648,128
+8939,538776,122
+8943,538898,134
+8946,539032,133
+8930,539165,149
+8961,539314,193
+8951,539507,131
+8972,539638,165
+9012,539803,141
+8904,539944,155
+8896,540099,235
+8870,540334,194
+8871,540528,158
+8865,540686,230
+8861,540916,144
+8854,541060,159
+8772,541219,244
+8784,541463,154
+8815,541617,221
+8824,541838,253
+8826,542091,121
+8800,542212,145
+8687,542357,142
+8685,542499,121
+8683,542620,141
+8759,542761,147
+8751,542908,163
+8694,543071,140
+8710,543211,138
+8706,543349,155
+8743,543504,161
+8734,543665,162
+8741,543827,136
+8736,543963,161
+8718,544124,175
+8711,544299,169
+8766,544468,140
+8654,544608,136
+8650,544744,150
+8651,544894,173
+8648,545067,135
+8667,545202,227
+8639,545429,199
+8636,545628,115
+8628,545743,164
+8616,545907,161
+8617,546068,168
+8589,546236,174
+8592,546410,144
+8581,546554,162
+8607,546716,130
+8598,546846,141
+8578,546987,150
+8579,547137,136
+8671,547273,155
+8660,547428,152
+8662,547580,128
+8614,547708,123
+8537,547831,137
+8533,547968,141
+8535,548109,161
+8507,548270,141
+8503,548411,137
+8505,548548,142
+8492,548690,207
+8491,548897,114
+8564,549011,150
+8569,549161,116
+8552,549277,124
+8528,549401,152
+8525,549553,224
+8490,549777,141
+8542,549918,142
+8182,550060,147
+8464,550207,139
+8460,550346,147
+8459,550493,163
+8157,550656,127
+8154,550783,135
+8452,550918,152
+8187,551070,184
+8169,551254,131
+8176,551385,130
+8170,551515,185
+8153,551700,156
+8142,551856,143
+8075,551999,133
+8069,552132,136
+8071,552268,143
+8072,552411,161
+8070,552572,117
+8097,552689,124
+8095,552813,157
+8089,552970,139
+8064,553109,125
+7000,553234,185
+8112,553419,128
+8110,553547,160
+8057,553707,143
+8049,553850,146
+8101,553996,154
+8093,554150,141
+8086,554291,150
+8044,554441,141
+8047,554582,275
+8032,554857,165
+8042,555022,155
+8037,555177,176
+7959,555353,163
+7963,555516,172
+8030,555688,174
+8021,555862,261
+8020,556123,153
+7982,556276,174
+8011,556450,127
+7949,556577,169
+7932,556746,156
+7971,556902,125
+7942,557027,158
+7866,557185,152
+7864,557337,189
+7860,557526,157
+7898,557683,169
+7895,557852,155
+7893,558007,132
+7912,558139,117
+7918,558256,150
+7930,558406,150
+7931,558556,166
+7928,558722,136
+7883,558858,158
+7848,559016,192
+7851,559208,126
+7839,559334,164
+7787,559498,134
+7792,559632,170
+7777,559802,120
+7742,559922,142
+7736,560064,189
+7751,560253,188
+7752,560441,114
+7818,560555,114
+7835,560669,142
+7830,560811,131
+7769,560942,165
+7761,561107,142
+7793,561249,161
+7620,561410,145
+7616,561555,138
+7613,561693,131
+7672,561824,185
+7673,562009,168
+7671,562177,170
+7685,562347,158
+7687,562505,179
+7690,562684,146
+7683,562830,154
+7707,562984,176
+7703,563160,113
+7704,563273,136
+7701,563409,164
+7728,563573,126
+7726,563699,121
+7644,563820,191
+7659,564011,159
+7578,564170,182
+7575,564352,157
+7569,564509,140
+7573,564649,128
+7581,564777,195
+7582,564972,153
+7536,565125,141
+7544,565266,212
+7535,565478,189
+7551,565667,168
+7545,565835,143
+7598,565978,199
+7590,566177,152
+7522,566329,145
+7523,566474,136
+7607,566610,151
+7565,566761,163
+7455,566924,159
+7491,567083,259
+7487,567342,120
+7481,567462,166
+7479,567628,200
+7443,567828,134
+7444,567962,197
+7440,568159,154
+7428,568313,143
+7410,568456,197
+7472,568653,143
+7346,568796,129
+7349,568925,200
+7348,569125,145
+7350,569270,146
+7367,569416,199
+7355,569615,123
+7309,569738,125
+7305,569863,154
+7303,570017,157
+7373,570174,157
+7404,570331,166
+7400,570497,122
+7376,570619,142
+7327,570761,142
+7293,570903,164
+7260,571067,170
+7250,571237,140
+7239,571377,207
+7190,571584,151
+7193,571735,160
+7276,571895,180
+7265,572075,184
+7227,572259,165
+7231,572424,182
+7208,572606,168
+7199,572774,165
+7218,572939,166
+7211,573105,153
+7287,573258,131
+7279,573389,119
+7241,573508,150
+7267,573658,114
+7135,573772,136
+7129,573908,173
+7111,574081,187
+7148,574268,179
+7177,574447,172
+7180,574619,135
+7078,574754,185
+7076,574939,125
+7092,575064,140
+7094,575204,143
+7144,575347,129
+7137,575476,115
+7059,575591,136
+7067,575727,174
+7068,575901,135
+7058,576036,145
+7054,576181,134
+6981,576315,174
+6975,576489,146
+6977,576635,151
+6992,576786,231
+6983,577017,115
+7020,577132,150
+7019,577282,150
+7017,577432,165
+7030,577597,133
+7024,577730,152
+7016,577882,177
+7010,578059,197
+7050,578256,127
+7040,578383,137
+6974,578520,131
+6967,578651,121
+6919,578772,137
+6920,578909,127
+6913,579036,172
+6914,579208,141
+6908,579349,149
+6928,579498,181
+6923,579679,138
+6924,579817,141
+6880,579958,169
+6882,580127,141
+6871,580268,180
+6947,580448,139
+6902,580587,146
+6905,580733,150
+6960,580883,131
+6936,581014,172
+6887,581186,142
+6805,581328,205
+6785,581533,122
+6791,581655,183
+6792,581838,164
+6849,582002,129
+6843,582131,196
+6845,582327,137
+6830,582464,150
+6861,582614,158
+6857,582772,145
+6777,582917,164
+6826,583081,130
+6795,583211,203
+6797,583414,149
+6836,583563,137
+6837,583700,157
+6820,583857,168
+6815,584025,120
+6772,584145,168
+6846,584313,149
+6681,584462,150
+6680,584612,177
+6744,584789,197
+6750,584986,178
+6748,585164,158
+6747,585322,158
+6692,585480,181
+6688,585661,150
+6734,585811,135
+6738,585946,151
+6675,586097,149
+6671,586246,176
+6723,586422,166
+6727,586588,152
+6701,586740,132
+6703,586872,141
+6569,587013,141
+6574,587154,157
+6575,587311,166
+6622,587477,128
+6629,587605,161
+6619,587766,182
+6659,587948,172
+6649,588120,118
+6606,588238,164
+6589,588402,156
+6642,588558,146
+6567,588704,113
+6559,588817,110
+6541,588927,135
+6530,589062,119
+6533,589181,143
+6481,589324,142
+6487,589466,152
+6488,589618,151
+6486,589769,141
+6507,589910,149
+6461,590059,148
+6534,590207,160
+6558,590367,107
+6506,590474,116
+6399,590590,130
+6388,590720,152
+6396,590872,150
+6390,591022,157
+6389,591179,248
+6393,591427,130
+6459,591557,123
+6453,591680,167
+6416,591847,187
+6419,592034,200
+6394,592234,176
+6378,592410,146
+6376,592556,139
+6420,592695,140
+6406,592835,141
+6401,592976,175
+6449,593151,128
+6371,593279,160
+6303,593439,153
+6297,593592,265
+6253,593857,209
+6255,594066,182
+6261,594248,149
+6337,594397,181
+6340,594578,161
+6345,594739,151
+6360,594890,148
+6361,595038,162
+6351,595200,148
+6332,595348,142
+6327,595490,124
+6293,595614,190
+6275,595804,142
+6286,595946,125
+6164,596071,163
+6167,596234,160
+6161,596394,171
+6110,596565,135
+6103,596700,165
+6199,596865,158
+6178,597023,170
+6176,597193,122
+6237,597315,229
+6238,597544,135
+6184,597679,163
+6197,597842,130
+6145,597972,155
+6131,598127,141
+6218,598268,126
+6219,598394,166
+6158,598560,135
+6076,598695,168
+6081,598863,183
+6066,599046,165
+6065,599211,166
+6051,599377,117
+6054,599494,168
+6044,599662,159
+6038,599821,128
+6113,599949,181
+6112,600130,141
+6098,600271,146
+6021,600417,157
+6005,600574,171
+6072,600745,182
+6075,600927,167
+6012,601094,177
+6017,601271,162
+6029,601433,148
+6030,601581,152
+6087,601733,156
+5981,601889,150
+5968,602039,145
+5973,602184,129
+5917,602313,124
+5912,602437,141
+5913,602578,144
+6006,602722,159
+6009,602881,121
+5991,603002,110
+5945,603112,192
+5932,603304,141
+5969,603445,154
+5964,603599,123
+5905,603722,156
+5957,603878,155
+5960,604033,160
+5987,604193,145
+5889,604338,139
+5878,604477,150
+5870,604627,147
+5854,604774,118
+5850,604892,178
+5844,605070,169
+5847,605239,139
+5887,605378,163
+5841,605541,114
+5829,605655,210
+5836,605865,160
+5911,606025,155
+5909,606180,121
+5902,606301,141
+5893,606442,136
+5802,606578,164
+5800,606742,136
+5798,606878,131
+5869,607009,141
+5831,607150,141
+5745,607291,167
+5737,607458,157
+5736,607615,161
+5696,607776,193
+5692,607969,136
+5757,608105,170
+5751,608275,142
+5717,608417,164
+5702,608581,141
+5704,608722,152
+5746,608874,169
+5722,609043,144
+5721,609187,134
+5794,609321,147
+5781,609468,182
+5592,609650,142
+5588,609792,120
+5589,609912,116
+5644,610028,154
+5650,610182,169
+5643,610351,135
+5635,610486,153
+5610,610639,151
+5602,610790,149
+5601,610939,124
+5599,611063,130
+5661,611193,178
+5649,611371,131
+5641,611502,191
+5621,611693,162
+5617,611855,179
+5667,612034,129
+5657,612163,167
+5669,612330,138
+5510,612468,196
+5502,612664,173
+5504,612837,166
+5500,613003,141
+5503,613144,226
+5555,613370,119
+5546,613489,177
+5542,613666,185
+5533,613851,124
+5590,613975,127
+5522,614102,155
+5515,614257,140
+5494,614397,175
+5566,614572,125
+5575,614697,141
+5470,614838,127
+5387,614965,166
+5383,615131,165
+5384,615296,189
+5378,615485,115
+5373,615600,177
+5372,615777,145
+5368,615922,148
+5367,616070,137
+5397,616207,135
+5391,616342,146
+5468,616488,128
+5465,616616,163
+5463,616779,115
+5460,616894,141
+5435,617035,163
+5431,617198,133
+5427,617331,135
+5428,617466,215
+5439,617681,167
+5400,617848,227
+5414,618075,158
+5361,618233,141
+5354,618374,178
+5349,618552,127
+5279,618679,166
+5299,618845,154
+5297,618999,155
+5344,619154,164
+5346,619318,145
+5348,619463,130
+5324,619593,130
+5323,619723,170
+5318,619893,129
+5272,620022,145
+5270,620167,127
+5267,620294,146
+5339,620440,160
+5178,620600,155
+5174,620755,128
+5227,620883,133
+5217,621016,149
+5218,621165,170
+5219,621335,120
+5221,621455,124
+5236,621579,135
+5231,621714,119
+5222,621833,145
+5247,621978,157
+5237,622135,144
+5254,622279,167
+5250,622446,139
+5205,622585,180
+5198,622765,115
+5261,622880,169
+5181,623049,138
+5141,623187,159
+5136,623346,165
+5143,623511,176
+5171,623687,196
+5172,623883,133
+5086,624016,125
+5085,624141,148
+5079,624289,164
+5063,624453,138
+5155,624591,139
+5157,624730,138
+5145,624868,124
+5102,624992,132
+5093,625124,140
+5090,625264,124
+5122,625388,126
+5119,625514,148
+5052,625662,134
+5128,625796,137
+5031,625933,153
+5030,626086,114
+5026,626200,139
+5023,626339,186
+5024,626525,150
+5016,626675,156
+5019,626831,132
+5014,626963,150
+5011,627113,157
+5003,627270,159
+5000,627429,135
+4974,627564,148
+4973,627712,138
+4970,627850,136
+5042,627986,144
+5037,628130,133
+5034,628263,145
+5028,628408,140
+4941,628548,110
+4939,628658,155
+4996,628813,159
+4987,628972,132
+4947,629104,159
+4963,629263,145
+4867,629408,123
+4868,629531,161
+4857,629692,139
+4851,629831,131
+4919,629962,158
+4916,630120,132
+4914,630252,216
+4895,630468,142
+4828,630610,178
+4863,630788,151
+4922,630939,139
+4906,631078,165
+4837,631243,139
+4878,631382,180
+4873,631562,167
+4889,631729,141
+4892,631870,143
+4938,632013,117
+4823,632130,150
+4804,632280,131
+4755,632411,118
+4756,632529,209
+4758,632738,107
+4787,632845,189
+4784,633034,142
+4735,633176,141
+4774,633317,125
+4772,633442,128
+4777,633570,129
+4816,633699,158
+4761,633857,170
+4748,634027,140
+4792,634167,128
+4731,634295,180
+4736,634475,141
+4725,634616,148
+4726,634764,171
+4721,634935,150
+4723,635085,127
+4713,635212,141
+4688,635353,180
+4690,635533,137
+4672,635670,169
+4654,635839,153
+4708,635992,154
+4705,636146,127
+4704,636273,149
+4657,636422,152
+4683,636574,130
+4682,636704,152
+4675,636856,141
+4569,636997,109
+4562,637106,154
+4559,637260,150
+4564,637410,129
+4565,637539,266
+4600,637805,125
+4596,637930,155
+4598,638085,191
+4592,638276,149
+4593,638425,130
+4589,638555,134
+4625,638689,176
+4633,638865,152
+4630,639017,178
+4629,639195,147
+4611,639342,140
+4556,639482,199
+4551,639681,138
+4553,639819,126
+4571,639945,155
+4644,640100,137
+4541,640237,161
+4522,640398,181
+4473,640579,166
+4490,640745,194
+4484,640939,155
+4529,641094,178
+4518,641272,131
+4533,641403,240
+4539,641643,141
+4454,641784,179
+4452,641963,167
+4514,642130,165
+4510,642295,147
+4467,642442,148
+4389,642590,142
+4380,642732,163
+4383,642895,137
+4381,643032,154
+4377,643186,141
+4432,643327,147
+4422,643474,144
+4365,643618,153
+4358,643771,141
+4084,643912,148
+4088,644060,141
+4396,644201,125
+4372,644326,182
+4366,644508,172
+4428,644680,165
+4417,644845,180
+4437,645025,141
+4434,645166,149
+4047,645315,147
+4050,645462,150
+4046,645612,164
+4075,645776,135
+4060,645911,173
+3982,646084,174
+3985,646258,150
+3975,646408,152
+4001,646560,157
+3993,646717,187
+4085,646904,161
+4072,647065,149
+4018,647214,213
+4055,647427,138
+4052,647565,136
+4015,647701,120
+4005,647821,140
+3968,647961,181
+3890,648142,175
+3882,648317,149
+3881,648466,144
+3879,648610,164
+3907,648774,140
+3912,648914,163
+3920,649077,150
+3918,649227,129
+3911,649356,130
+3864,649486,167
+3869,649653,155
+3867,649808,141
+3960,649949,143
+3952,650092,150
+3956,650242,135
+3949,650377,146
+3935,650523,179
+3930,650702,135
+3889,650837,185
+3955,651022,175
+3900,651197,137
+3755,651334,116
+3757,651450,158
+3759,651608,135
+3832,651743,147
+3833,651890,147
+3814,652037,141
+3830,652178,186
+3818,652364,197
+3855,652561,167
+3862,652728,165
+3782,652893,147
+3775,653040,131
+3839,653171,136
+3808,653307,133
+3743,653440,128
+3734,653568,169
+3726,653737,186
+3729,653923,140
+3656,654063,156
+3646,654219,154
+3635,654373,176
+3701,654549,151
+3708,654700,149
+3686,654849,201
+3688,655050,158
+3678,655208,177
+3670,655385,146
+3669,655531,116
+3699,655647,131
+3698,655778,134
+3694,655912,180
+3716,656092,141
+3719,656233,139
+3730,656372,149
+3667,656521,162
+3577,656683,142
+3581,656825,166
+3579,656991,118
+3584,657109,169
+3572,657278,146
+3578,657424,155
+3580,657579,126
+3582,657705,166
+3542,657871,162
+3541,658033,172
+3599,658205,113
+3600,658318,134
+3594,658452,139
+3598,658591,136
+3608,658727,130
+3604,658857,158
+3611,659015,112
+3603,659127,149
+3550,659276,150
+3554,659426,170
+3546,659596,142
+3533,659738,151
+3530,659889,143
+3535,660032,129
+3642,660161,123
+3643,660284,158
+3564,660442,141
+3570,660583,60
+3623,660643,156
+3488,660799,118
+3470,660917,158
+3466,661075,184
+3454,661259,152
+3441,661411,132
+3418,661543,110
+3512,661653,114
+3524,661767,152
+3483,661919,178
+3452,662097,128
+3435,662225,136
+3395,662361,154
+3396,662515,149
+3382,662664,189
+3389,662853,161
+3390,663014,162
+3341,663176,139
+3334,663315,168
+3402,663483,134
+3407,663617,155
+3399,663772,133
+3425,663905,178
+3387,664083,160
+3373,664243,150
+3358,664393,133
+3410,664526,145
+3354,664671,157
+3256,664828,115
+3259,664943,121
+3264,665064,118
+3240,665182,157
+3331,665339,129
+3327,665468,163
+3322,665631,154
+3325,665785,179
+3283,665964,173
+3287,666137,131
+3284,666268,172
+3286,666440,142
+3257,666582,103
+3261,666685,163
+3250,666848,149
+3307,666997,147
+3276,667144,123
+3271,667267,170
+3262,667437,170
+3239,667607,218
+3311,667825,180
+3172,668005,145
+3232,668150,159
+3225,668309,152
+3162,668461,182
+3166,668643,144
+3169,668787,186
+3167,668973,122
+3147,669095,143
+3141,669238,172
+3132,669410,142
+3196,669552,181
+3195,669733,167
+3191,669900,140
+3177,670040,166
+3174,670206,139
+3208,670345,163
+3202,670508,148
+3213,670656,155
+3209,670811,147
+3150,670958,160
+3070,671118,172
+3061,671290,199
+3111,671489,166
+3114,671655,175
+3100,671830,173
+3039,672003,182
+3046,672185,143
+3058,672328,196
+3051,672524,124
+3055,672648,147
+3077,672795,157
+3106,672952,160
+3087,673112,151
+3128,673263,140
+2991,673403,178
+2998,673581,178
+2995,673759,148
+2999,673907,158
+3002,674065,134
+2914,674199,119
+2916,674318,155
+2919,674473,199
+2941,674672,184
+2964,674856,189
+2990,675045,173
+3033,675218,151
+2987,675369,194
+2925,675563,155
+3012,675718,134
+2903,675852,149
+2897,676001,168
+2899,676169,165
+2811,676334,131
+2815,676465,148
+2890,676613,144
+2888,676757,133
+2846,676890,159
+2844,677049,118
+2871,677167,168
+2808,677335,159
+2839,677494,131
+2861,677625,127
+2723,677752,167
+2727,677919,140
+2726,678059,140
+2714,678199,151
+2708,678350,174
+2711,678524,144
+2706,678668,153
+2693,678821,130
+2768,678951,216
+2772,679167,151
+2762,679318,156
+2766,679474,152
+2759,679626,149
+2782,679775,173
+2786,679948,194
+2779,680142,132
+2744,680274,141
+2732,680415,144
+2751,680559,134
+2748,680693,134
+2640,680827,168
+2648,680995,198
+2638,681193,142
+2658,681335,160
+2666,681495,136
+2662,681631,198
+2609,681829,125
+16978,681954,144
+2672,682098,127
+2674,682225,125
+2621,682350,171
+2630,682521,170
+2673,682691,158
+2660,682849,151
+2691,683000,148
+2694,683148,116
+2623,683264,158
+2572,683422,170
+2550,683592,195
+2592,683787,139
+2596,683926,147
+2585,684073,142
+2533,684215,174
+2526,684389,206
+2528,684595,144
+2561,684739,135
+2540,684874,130
+2542,685004,156
+2506,685160,193
+2511,685353,149
+2577,685502,182
+2575,685684,154
+2535,685838,158
+2451,685996,152
+2457,686148,143
+2452,686291,146
+2489,686437,183
+2476,686620,133
+2481,686753,166
+2480,686919,139
+2425,687058,189
+2403,687247,154
+2406,687401,128
+2497,687529,126
+2491,687655,136
+2408,687791,145
+2401,687936,178
+2428,688114,141
+2427,688255,141
+2461,688396,144
+2462,688540,165
+2440,688705,162
+2446,688867,124
+2475,688991,127
+2400,689118,141
+2390,689259,178
+2304,689437,115
+2305,689552,227
+2323,689779,167
+2318,689946,161
+2364,690107,155
+2357,690262,148
+2358,690410,164
+2359,690574,162
+2374,690736,135
+2367,690871,189
+2376,691060,162
+2377,691222,150
+2346,691372,142
+2341,691514,134
+2272,691648,157
+2276,691805,134
+2275,691939,141
+2277,692080,128
+2265,692208,149
+2193,692357,128
+2194,692485,129
+2188,692614,160
+2186,692774,132
+2301,692906,160
+2296,693066,118
+2261,693184,167
+2253,693351,132
+2252,693483,132
+2257,693615,124
+2215,693739,144
+2201,693883,129
+2208,694012,157
+2236,694169,119
+2237,694288,119
+2222,694407,181
+2243,694588,114
+2291,694702,115
+2270,694817,121
+2082,694938,119
+2083,695057,133
+2077,695190,145
+2093,695335,165
+2080,695500,141
+2088,695641,138
+2084,695779,157
+2156,695936,136
+2152,696072,123
+2153,696195,172
+2146,696367,169
+2051,696536,122
+2053,696658,152
+2056,696810,142
+2068,696952,128
+2140,697080,191
+2092,697271,114
+2081,697385,141
+2183,697526,174
+2167,697700,160
+2171,697860,111
+2145,697971,133
+2127,698104,152
+2132,698256,126
+2166,698382,140
+2160,698522,146
+2158,698668,103
+2045,698771,106
+2046,698877,140
+1149,699017,107
+1983,699124,165
+1979,699289,133
+1981,699422,108
+1988,699530,124
+1974,699654,149
+1975,699803,177
+1968,699980,138
+2009,700118,126
+2010,700244,146
+1997,700390,146
+1999,700536,99
+2002,700635,142
+1993,700777,143
+1991,700920,147
+1987,701067,119
+1957,701186,125
+1948,701311,166
+2020,701477,136
+1934,701613,121
+1876,701734,155
+1879,701889,130
+1875,702019,190
+1868,702209,124
+1869,702333,164
+1842,702497,152
+1829,702649,159
+1827,702808,138
+1821,702946,211
+1824,703157,138
+1902,703295,162
+1903,703457,132
+1907,703589,151
+1900,703740,134
+1885,703874,118
+1855,703992,157
+1832,704149,128
+1836,704277,109
+1837,704386,108
+1839,704494,124
+1920,704618,144
+1911,704762,114
+1828,704876,149
+1819,705025,147
+1813,705172,181
+1847,705353,138
+1844,705491,129
+1893,705620,158
+1514,705778,123
+1737,705901,184
+1736,706085,170
+1777,706255,101
+1703,706356,122
+1705,706478,151
+1694,706629,121
+1713,706750,121
+1709,706871,132
+1711,707003,131
+1751,707134,141
+1749,707275,144
+1789,707419,164
+1785,707583,163
+1728,707746,163
+1760,707909,132
+53433,708041,182
+53343,708223,128
+1653,708351,142
+1688,708493,126
+1692,708619,147
+1603,708766,152
+1609,708918,138
+1598,709056,123
+1595,709179,161
+1659,709340,163
+1648,709503,108
+1647,709611,147
+1640,709758,142
+1645,709900,127
+1574,710027,104
+1568,710131,128
+1560,710259,158
+1587,710417,149
+1670,710566,143
+1673,710709,150
+1665,710859,137
+1624,710996,209
+1491,711205,166
+1540,711371,153
+1542,711524,131
+1539,711655,133
+1543,711788,189
+1527,711977,150
+1436,712127,140
+1454,712267,141
+1456,712408,169
+1458,712577,130
+1431,712707,158
+1461,712865,133
+1483,712998,149
+1480,713147,113
+1485,713260,162
+1442,713422,145
+1450,713567,178
+1511,713745,161
+1524,713906,135
+1505,714041,125
+1506,714166,163
+1555,714329,189
+1559,714518,139
+1361,714657,163
+1357,714820,143
+1351,714963,140
+1358,715103,127
+1350,715230,168
+1344,715398,130
+1340,715528,127
+1348,715655,162
+1326,715817,136
+1327,715953,156
+1339,716109,175
+1320,716284,133
+1387,716417,152
+1376,716569,144
+1374,716713,141
+1430,716854,140
+1401,716994,167
+1407,717161,141
+1395,717302,141
+1397,717443,121
+1366,717564,132
+1369,717696,126
+1420,717822,130
+1225,717952,153
+1214,718105,144
+1220,718249,176
+1217,718425,141
+1238,718566,166
+1233,718732,153
+1232,718885,124
+32903,719009,151
+1241,719160,158
+1240,719318,128
+1316,719446,150
+1314,719596,130
+1312,719726,140
+1259,719866,158
+1263,720024,134
+1300,720158,141
+1291,720299,142
+1285,720441,176
+1278,720617,144
+1304,720761,120
+1207,720881,132
+1209,721013,136
+1211,721149,144
+1212,721293,142
+1199,721435,149
+1110,721584,170
+1112,721754,139
+1103,721893,153
+1094,722046,145
+1098,722191,147
+1088,722338,135
+1084,722473,154
+1202,722627,112
+1204,722739,96
+1197,722835,132
+1193,722967,161
+1121,723128,158
+1122,723286,188
+1119,723474,158
+1180,723632,156
+1181,723788,131
+1120,723919,150
+1167,724069,143
+1173,724212,174
+1135,724386,175
+1129,724561,135
+1159,724696,154
+1128,724850,126
+993,724976,157
+996,725133,141
+988,725274,139
+984,725413,141
+981,725554,162
+1015,725716,128
+1020,725844,116
+1007,725960,108
+1009,726068,157
+1072,726225,98
+1068,726323,118
+1066,726441,151
+1067,726592,168
+982,726760,122
+980,726882,139
+974,727021,169
+968,727190,142
+963,727332,125
+1049,727457,160
+1052,727617,134
+1048,727751,121
+880,727872,133
+1026,728005,146
+1005,728151,138
+957,728289,167
+960,728456,136
+952,728592,145
+951,728737,144
+928,728881,141
+930,729022,154
+924,729176,172
+944,729348,163
+938,729511,111
+936,729622,150
+853,729772,160
+873,729932,150
+883,730082,114
+887,730196,137
+869,730333,167
+901,730500,139
+852,730639,162
+848,730801,108
+849,730909,132
+846,731041,135
+840,731176,143
+838,731319,146
+836,731465,132
+742,731597,166
+740,731763,147
+734,731910,133
+738,732043,154
+737,732197,165
+759,732362,101
+53284,732463,152
+753,732615,133
+749,732748,136
+748,732884,160
+822,733044,126
+823,733170,121
+827,733291,138
+813,733429,132
+45138,733561,154
+835,733715,135
+821,733850,129
+760,733979,154
+788,734133,153
+815,734286,146
+732,734432,150
+727,734582,109
+723,734691,130
+730,734821,150
+724,734971,142
+726,735113,116
+637,735229,141
+636,735370,138
+651,735508,115
+652,735623,164
+653,735787,164
+664,735951,149
+663,736100,123
+657,736223,157
+705,736380,178
+704,736558,182
+665,736740,125
+629,736865,162
+710,737027,151
+678,737178,141
+607,737319,131
+604,737450,166
+135,737616,129
+600,737745,165
+590,737910,135
+578,738045,148
+580,738193,163
+574,738356,136
+577,738492,119
+519,738611,159
+520,738770,149
+516,738919,158
+553,739077,128
+557,739205,108
+550,739313,136
+549,739449,140
+529,739589,177
+530,739766,119
+535,739885,141
+378,740026,190
+568,740216,155
+617,740371,145
+612,740516,133
+597,740649,142
+594,740791,147
+544,740938,148
+525,741086,124
+468,741210,146
+477,741356,139
+469,741495,193
+471,741688,143
+478,741831,140
+476,741971,126
+505,742097,171
+507,742268,149
+504,742417,156
+446,742573,143
+433,742716,141
+447,742857,137
+436,742994,131
+442,743125,139
+463,743264,163
+464,743427,132
+432,743559,178
+425,743737,105
+426,743842,154
+414,743996,143
+381,744139,129
+385,744268,142
+404,744410,176
+408,744586,123
+488,744709,148
+489,744857,154
+485,745011,125
+418,745136,130
+389,745266,153
+455,745419,141
+289,745560,163
+297,745723,130
+281,745853,138
+290,745991,156
+282,746147,160
+266,746307,152
+359,746459,154
+360,746613,139
+354,746752,158
+340,746910,151
+338,747061,120
+336,747181,147
+337,747328,163
+277,747491,153
+257,747644,60
+269,747704,144
+261,747848,144
+45079,747992,157
+300,748149,157
+322,748306,141
+356,748447,141
+351,748588,133
+299,748721,102
+319,748823,166
+292,748989,134
+12424,749123,115
+12320,749238,123
+12437,749361,160
+12490,749521,132
+12494,749653,124
+12411,749777,141
+12469,749918,158
+12472,750076,149
+12401,750225,141
+12346,750366,114
+12366,750480,152
+12452,750632,178
+12347,750810,150
+12476,750960,124
+45101,751084,157
+12526,751241,142
+12446,751383,147
+12510,751530,145
+12350,751675,127
+12503,751802,158
+45262,751960,153
+45084,752113,151
+45130,752264,141
+45128,752405,158
+12315,752563,121
+12321,752684,166
+12332,752850,157
+12511,753007,149
+12336,753156,148
+12387,753304,154
+12451,753458,141
+12509,753599,146
+12441,753745,135
+12530,753880,141
+12369,754021,141
+12430,754162,173
+12327,754335,144
+12339,754479,143
+12296,754622,142
+12317,754764,139
+12474,754903,153
+12541,755056,162
+12473,755218,115
+12413,755333,134
+12527,755467,154
+12438,755621,141
+12345,755762,133
+53496,755895,151
+53485,756046,109
+53399,756155,141
+53390,756296,172
+53334,756468,137
+53472,756605,153
+53248,756758,158
+53456,756916,135
+53331,757051,146
+53299,757197,128
+53462,757325,138
+53347,757463,141
+53319,757604,125
+53333,757729,129
+53307,757858,163
+53427,758021,163
+53423,758184,135
+53330,758319,161
+53421,758480,127
+53412,758607,158
+53424,758765,136
+53296,758901,151
+12330,759052,142
+12513,759194,180
+12331,759374,121
+12289,759495,99
+53387,759594,153
+53476,759747,141
+53338,759888,135
+53369,760023,141
+53281,760164,164
+53407,760328,141
+53502,760469,131
+53460,760600,130
+53380,760730,162
+53401,760892,149
+53479,761041,140
+53275,761181,147
+53261,761328,149
+53332,761477,137
+53257,761614,170
+53492,761784,142
+53373,761926,150
+53379,762076,139
+53434,762215,141
+53400,762356,150
+53438,762506,119
+53394,762625,158
+20637,762783,121
+53432,762904,136
+20683,763040,98
+20568,763138,154
+20596,763292,151
+20490,763443,160
+20589,763603,140
+20682,763743,158
+53447,763901,133
+53370,764034,144
+20543,764178,130
+20530,764308,155
+53322,764463,126
+53364,764589,149
+20557,764738,185
+20592,764923,162
+20515,765085,165
+20638,765250,153
+20593,765403,159
+20575,765562,130
+20660,765692,176
+20694,765868,128
+20610,765996,136
+20703,766132,134
+20677,766266,148
+20622,766414,133
+20520,766547,154
+20527,766701,161
+20734,766862,121
+20651,766983,150
+20535,767133,150
+20648,767283,142
+20636,767425,125
+20657,767550,139
+20486,767689,111
+20489,767800,160
+20528,767960,141
+20600,768101,146
+20482,768247,121
+20586,768368,136
+20650,768504,159
+20536,768663,171
+20663,768834,160
+37000,768994,157
+36972,769151,150
+37028,769301,136
+37113,769437,157
+37001,769594,157
+37102,769751,168
+36992,769919,152
+37096,770071,173
+37025,770244,184
+36985,770428,132
+37018,770560,155
+37058,770715,144
+20688,770859,140
+20696,770999,154
+20658,771153,121
+36982,771274,162
+36887,771436,132
+36937,771568,151
+37094,771719,135
+36976,771854,143
+36912,771997,146
+36872,772143,123
+37036,772266,138
+36942,772404,120
+37101,772524,181
+36894,772705,149
+36981,772854,166
+37037,773020,149
+36865,773169,195
+36931,773364,132
+37067,773496,158
+4195,773654,163
+4131,773817,174
+4139,773991,142
+37002,774133,157
+36878,774290,167
+37057,774457,128
+4237,774585,149
+4165,774734,146
+4221,774880,145
+37092,775025,140
+36928,775165,177
+37064,775342,170
+36891,775512,141
+37111,775653,135
+36882,775788,159
+37047,775947,162
+37024,776109,130
+36935,776239,143
+37089,776382,123
+36914,776505,131
+4194,776636,137
+4336,776773,170
+4097,776943,130
+4188,777073,168
+4303,777241,155
+4201,777396,168
+4287,777564,138
+4134,777702,168
+4150,777870,162
+4153,778032,139
+4278,778171,158
+4332,778329,126
+4185,778455,149
+4348,778604,161
+4145,778765,164
+4205,778929,162
+4172,779091,144
+4300,779235,172
+4144,779407,117
+4304,779524,117
+4243,779641,134
+4239,779775,127
+4260,779902,127
+4337,780029,141
+4198,780170,168
+4268,780338,141
+4273,780479,127
+4334,780606,141
+4161,780747,150
+4266,780897,135
+4328,781032,151
+4258,781183,118
+4197,781301,139
+4255,781440,117
+4125,781557,151
+4228,781708,135
+4096,781843,178
+4105,782021,150
+4344,782171,156
+4288,782327,134
+4187,782461,136
+4098,782597,130
+4331,782727,148
+4183,782875,153
+4345,783028,149
+4213,783177,148
+57347,783325,164
+57587,783489,164
+572364,783653,161
+57563,783814,163
+57510,783977,148
+57503,784125,119
+57548,784244,157
+57472,784401,163
+57348,784564,142
+57403,784706,156
+57589,784862,110
+57559,784972,166
+57525,785138,165
+57448,785303,145
+57417,785448,146
+57493,785594,184
+57358,785778,156
+57416,785934,144
+57547,786078,119
+57544,786197,169
+57350,786366,154
+57516,786520,127
+57352,786647,148
+57518,786795,143
+57568,786938,146
+57424,787084,177
+57379,787261,102
+57388,787363,126
+57447,787489,162
+57594,787651,159
+57386,787810,149
+57422,787959,153
+57362,788112,174
+57420,788286,165
+57425,788451,135
+24683,788586,125
+24635,788711,131
+57401,788842,133
+24587,788975,122
+57543,789097,132
+57519,789229,189
+57428,789418,144
+57529,789562,137
+24651,789699,149
+57583,789848,114
+57389,789962,157
+57397,790119,158
+57488,790277,158
+24577,790435,134
+24830,790569,161
+24765,790730,152
+2048,790882,152
+57477,791034,153
+57534,791187,154
+57526,791341,146
+57588,791487,144
+57504,791631,126
+57585,791757,137
+24789,791894,148
+24639,792042,137
+24757,792179,117
+24596,792296,138
+24748,792434,160
+24654,792594,175
+24801,792769,161
+24786,792930,210
+24642,793140,130
+24697,793270,157
+24730,793427,127
+24619,793554,129
+24817,793683,134
+24806,793817,170
+24831,793987,128
+24679,794115,140
+24735,794255,154
+24640,794409,126
+24780,794535,160
+24620,794695,158
+24702,794853,133
+24781,794986,133
+24746,795119,167
+24613,795286,146
+24743,795432,144
+1448,795576,143
+24805,795719,158
+24670,795877,165
+24774,796042,113
+24606,796155,125
+24677,796280,187
+24669,796467,142
+24687,796609,163
+40976,796772,148
+41049,796920,136
+41017,797056,154
+41133,797210,131
+41174,797341,126
+41006,797467,177
+24650,797644,144
+41149,797788,135
+24720,797923,187
+24589,798110,140
+24624,798250,146
+41101,798396,148
+41102,798544,168
+41212,798712,141
+41116,798853,126
+40973,798979,147
+41193,799126,188
+41150,799314,216
+40982,799530,140
+41032,799670,130
+40963,799800,205
+41209,800005,152
+41205,800157,131
+41162,800288,139
+40994,800427,212
+41142,800639,142
+41081,800781,156
+41152,800937,140
+40990,801077,130
+41134,801207,142
+41058,801349,129
+41078,801478,144
+41121,801622,123
+41028,801745,105
+40977,801850,129
+41146,801979,156
+41141,802135,135
+41037,802270,143
+41094,802413,154
+41135,802567,130
+41047,802697,145
+41008,802842,104
+41182,802946,157
+41092,803103,136
+41033,803239,145
+41117,803384,165
+41067,803549,139
+41208,803688,150
+41119,803838,136
+41070,803974,128
+8226,804102,145
+8366,804247,142
+8362,804389,186
+8356,804575,141
+615,804716,137
+8369,804853,143
+8242,804996,136
+8425,805132,114
+8248,805246,196
+8355,805442,134
+8281,805576,157
+8244,805733,146
+8313,805879,121
+8197,806000,137
+8216,806137,150
+8344,806287,117
+8445,806404,158
+8442,806562,150
+8385,806712,138
+8320,806850,141
+49187,806991,151
+49291,807142,165
+8388,807307,129
+8308,807436,122
+8252,807558,99
+8232,807657,156
+8296,807813,112
+8392,807925,152
+8349,808077,138
+8348,808215,149
+8301,808364,142
+8250,808506,160
+8264,808666,151
+8412,808817,131
+8204,808948,154
+8209,809102,127
+8273,809229,142
+8251,809371,124
+8378,809495,155
+8437,809650,105
+8206,809755,154
+8423,809909,170
+8432,810079,178
+8329,810257,159
+8289,810416,138
+49280,810554,140
+49332,810694,148
+49221,810842,145
+28851,810987,127
+28848,811114,153
+59091,811267,157
+49347,811424,167
+49331,811591,165
+49381,811756,112
+49229,811868,113
+49223,811981,150
+49284,812131,126
+49217,812257,163
+49183,812420,102
+24710,812522,156
+49241,812678,143
+49393,812821,155
+49313,812976,145
+49198,813121,98
+49165,813219,154
+49281,813373,135
+49211,813508,169
+49282,813677,140
+49305,813817,151
+49153,813968,152
+49396,814120,148
+49378,814268,137
+49275,814405,161
+49212,814566,119
+49181,814685,166
+49205,814851,141
+49264,814992,142
+49261,815134,145
+49386,815279,142
+49161,815421,144
+49366,815565,140
+49372,815705,161
+49266,815866,124
+49326,815990,163
+49346,816153,151
+49327,816304,133
+49274,816437,101
+49398,816538,153
+49400,816691,136
+49272,816827,159
+49306,816986,155
+49178,817141,172
+49256,817313,144
+49368,817457,155
+16438,817612,137
+16406,817749,194
+16490,817943,165
+16394,818108,166
+16537,818274,152
+16401,818426,161
+16545,818587,136
+16513,818723,148
+49292,818871,165
+49159,819036,161
+49304,819197,172
+49342,819369,106
+49262,819475,131
+49290,819606,149
+49399,819755,156
+16567,819911,151
+16556,820062,149
+1048666,820211,142
+16593,820353,138
+16489,820491,147
+16443,820638,166
+32827,820804,154
+32874,820958,155
+49320,821113,139
+16608,821252,124
+16552,821376,152
+16496,821528,153
+16522,821681,150
+16637,821831,109
+16447,821940,145
+16514,822085,142
+16625,822227,142
+16553,822369,138
+16611,822507,139
+16529,822646,151
+16618,822797,137
+16551,822934,128
+16484,823062,158
+16451,823220,205
+16474,823425,158
+16403,823583,168
+16396,823751,160
+16478,823911,119
+16634,824030,152
+16404,824182,109
+16384,824291,156
+16492,824447,115
+16501,824562,132
+16467,824694,135
+32824,824829,170
+32862,824999,150
+32864,825149,161
+32963,825310,170
+32836,825480,152
+32774,825632,134
+32923,825766,135
+32991,825901,165
+32808,826066,128
+32865,826194,143
+33013,826337,129
+32953,826466,145
+16483,826611,146
+32906,826757,157
+32935,826914,178
+32870,827092,157
+32971,827249,147
+32775,827396,134
+32866,827530,124
+32798,827654,134
+32994,827788,132
+32841,827920,144
+32961,828064,140
+32931,828204,123
+32956,828327,142
+32822,828469,160
+32899,828629,126
+32952,828755,189
+32845,828944,153
+32980,829097,139
+32829,829236,136
+32907,829372,140
+32946,829512,168
+32886,829680,102
+32779,829782,132
+32792,829914,126
+32872,830040,139
+32936,830179,148
+32819,830327,144
+32892,830471,133
+32913,830604,142
+142,830746,153
+220,830899,155
+99,831054,151
+78,831205,137
+189,831342,225
+46,831567,124
+63,831691,135
+32925,831826,110
+33012,831936,132
+32802,832068,125
+205,832193,159
+32989,832352,134
+33019,832486,150
+32948,832636,131
+32895,832767,131
+32813,832898,126
+97,833024,144
+234,833168,95
+67,833263,133
+23,833396,119
+178,833515,154
+238,833669,158
+229,833827,117
+137,833944,143
+255,834087,138
+183,834225,159
+242,834384,127
+204,834511,122
+164,834633,151
+219,834784,151
+193,834935,128
+246,835063,162
+119,835225,139
+162,835364,129
+236,835493,117
+194,835610,166
+252,835776,107
+109,835883,157
+218,836040,107
+221,836147,135
+174,836282,136
+160,836418,173
+192,836591,161
+51,836752,153
+157,836905,155
+253,837060,139
+101,837199,154
+17,837353,118
+16,837471,130
+188,837601,155
+524414,837756,160
+524415,837916,161
+153,838077,121
+196,838198,147
+235,838345,142
+40,838487,160
+524347,838647,137
+524348,838784,167
+524340,838951,145
+524342,839096,158
+524339,839254,138
+524360,839392,166
+524355,839558,141
+524357,839699,152
+524408,839851,138
+524397,839989,152
+524336,840141,158
+524337,840299,144
+524334,840443,158
+524374,840601,163
+524367,840764,133
+524368,840897,139
+524382,841036,157
+524406,841193,154
+524405,841347,132
+524331,841479,160
+524329,841639,149
+159920,841788,153
+83,841941,127
+524432,842068,154
+524298,842222,163
+32783,842385,145
+16491,842530,116
+524303,842646,132
+524323,842778,177
+11554755,842955,239
+524316,843194,161
+56588,843355,145
+524312,843500,133
+166,843633,168
+48112,843801,145
+16526,843946,131
+4,844077,129
+56590,844206,145
+8935197,844351,170
+8188699,844521,189
+456,844710,139
+13430531,844849,241
+1060771,845090,194
+7358711,845284,156
+1630666,845440,110
+15515357,845550,178
+49334,845728,135
+3182966,845863,212
+7915649,846075,173
+13913960,846248,154
+7642789,846402,141
+9226315,846543,234
+798640,846777,161
+11797014,846938,141
+5547155,847079,154
+7085169,847233,186
+13396496,847419,155
+15744917,847574,196
+1594948,847770,196
+10250705,847966,196
+1595992,848162,117
+12859957,848279,226
+315758,848505,154
+265788,848659,112
+12902622,848771,265
+9443919,849036,147
+13127438,849183,214
+7131834,849397,178
+3160762,849575,222
+14191324,849797,180
+1108307,849977,180
+8145074,850157,175
+2927411,850332,130
+12093382,850462,191
+15506482,850653,207
+5025192,850860,168
+16522401,851028,114
+13905349,851142,204
+15257660,851346,288
+1841887,851634,143
+13956423,851777,139
+9968565,851916,200
+3459866,852116,159
+15773959,852275,127
+7884699,852402,137
+7879276,852539,253
+14696455,852792,180
+3686323,852972,166
+7392908,853138,161
+4223221,853299,123
+11548085,853422,123
+9482193,853545,175
+8391783,853720,123
+9470250,853843,123
+7870398,853966,196
+15758058,854162,139
+12090309,854301,123
+15749430,854424,172
+1071410,854596,125
+2126932,854721,197
+12110261,854918,213
+8957120,855131,187
+9502067,855318,178
+1842744,855496,163
+3948814,855659,141
+8968591,855800,137
+17890,855937,165
+26983,856102,154
+16281566,856256,241
+6579748,856497,178
+11597104,856675,208
+7604961,856883,180
+11839640,857063,180
+844960,857243,180
+12327652,857423,180
+278386,857603,171
+1854822,857774,141
+5254342,857915,197
+16056059,858112,175
+9980180,858287,178
+847513,858465,141
+4478,858606,128
+13641914,858734,256
+10758327,858990,238
+9736914,859228,153
+14985439,859381,221
+9196483,859602,242
+7352117,859844,196
+12588216,860040,114
+30269,860154,110
+3183548,860264,178
+16577988,860442,170
+15214262,860612,188
+5557865,860800,165
+7128635,860965,151
+5803649,861116,149
+4763693,861265,149
+5038454,861414,141
+7122678,861555,122
+16551534,861677,142
+14691046,861819,199
+6558262,862018,166
+7899946,862184,263
+11297999,862447,226
+15755048,862673,213
+12375911,862886,60
+10281334,862946,139
+1059161,863085,123
+14972548,863208,123
+11803165,863331,161
+15752405,863492,123
+3988077,863615,224
+16256496,863839,178
+10283292,864017,178
+6035407,864195,212
+10812022,864407,185
+7400026,864592,123
+3996371,864715,154
+9199736,864869,129
+56613,864998,257
+8397025,865255,155
+279969,865410,203
+9213930,865613,132
+3189610,865745,221
+7642088,865966,208
+6077167,866174,234
+5006193,866408,219
+14175673,866627,202
+10506117,866829,189
+14157750,867018,252
+6581911,867270,252
+7884924,867522,137
+4696,867659,158
+7083570,867817,196
+2890241,868013,196
+3438649,868209,178
+2365085,868387,141
+15997410,868528,131
+5021699,868659,114
+6615803,868773,220
+3178651,868993,185
+7611067,869178,180
+7081268,869358,114
+4998518,869472,257
+11813028,869729,123
+4765859,869852,123
+16047075,869975,123
+12337804,870098,159
+15760583,870257,137
+13917932,870394,242
+7653673,870636,186
+13946873,870822,206
+6075038,871028,150
+10275307,871178,122
+9751556,871300,154
+9497719,871454,120
+8962967,871574,242
+15791809,871816,126
+6318158,871942,161
+8397053,872103,161
+11849280,872264,161
+5505924,872425,235
+310719,872660,161
+12352191,872821,161
+11798833,872982,196
+9758698,873178,196
+9757882,873374,180
+3436870,873554,180
+2934086,873734,180
+820122,873914,180
+14737660,874094,180
+3166325,874274,123
+16037773,874397,196
+10753767,874593,196
+3193264,874789,184
+800254,874973,199
+9208799,875172,114
+11291422,875286,156
+11592917,875442,139
+13949645,875581,121
+6842826,875702,147
+11291222,875849,141
+16050869,875990,147
+6519,876137,147
+584260,876284,147
+11580867,876431,213
+7358990,876644,203
+536683,876847,140
+34460,876987,140
+5028113,877127,189
+4212586,877316,139
+5033517,877455,131
+12324762,877586,189
+3191351,877775,229
+12343894,878004,141
+12090610,878145,147
+8924052,878292,157
+8187745,878449,172
+6596965,878621,149
+2384590,878770,189
+6873609,878959,196
+4195721,879155,128
+12622836,879283,154
+16003211,879437,219
+14445330,879656,147
+7340959,879803,170
+10542607,879973,180
+16025541,880153,180
+524424,880333,172
+271,880505,172
+569429,880677,164
+286649,880841,141
+13389348,880982,172
+57426,881154,172
+10018690,881326,202
+3995218,881528,178
+6033403,881706,168
+7624947,881874,141
+1585,882015,122
+11011447,882137,123
+14957157,882260,135
+567893,882395,193
+5513629,882588,161
+13143016,882749,128
+15745478,882877,157
+4210728,883034,129
+16280579,883163,273
+14184781,883436,130
+846976,883566,130
+1072604,883696,180
+14447493,883876,180
+5526997,884056,180
+5586,884236,143
+8000,884379,139
+1590675,884518,151
+12884102,884669,139
+13409994,884808,132
+3944559,884940,196
+3468007,885136,249
+13937613,885385,222
+8446399,885607,196
+4730064,885803,196
+6450,885999,142
+10537637,886141,259
+6053735,886400,140
+807957,886540,140
+3154994,886680,140
+14453544,886820,140
+1842101,886960,140
+16266305,887100,140
+14971064,887240,140
+14683876,887380,217
+15238475,887597,123
+2682005,887720,123
+5832113,887843,151
+14691222,887994,123
+11028125,888117,138
+7134889,888255,138
+9228029,888393,268
+5307161,888661,245
+13675477,888906,140
+6821673,889046,140
+12060879,889186,140
+14446998,889326,140
+5300357,889466,140
+9701575,889606,180
+13159011,889786,180
+9976719,889966,140
+13682231,890106,140
+322134,890246,140
+13908740,890386,140
+3696787,890526,140
+14171071,890666,140
+1373912,890806,140
+14734568,890946,140
+9758455,891086,140
+4988310,891226,140
+7355046,891366,185
+9713655,891551,180
+289881,891731,140
+9453546,891871,196
+2141000,892067,196
+13424444,892263,196
+13910224,892459,167
+9758475,892626,140
+7904,892766,120
+14473646,892886,189
+10008764,893075,161
+1592854,893236,161
+12598531,893397,161
+10786737,893558,234
+12364179,893792,170
+1078383,893962,225
+37501,894187,232
+4462114,894419,143
+4515504,894562,185
+7633552,894747,178
+2419146,894925,180
+1310845,895105,178
+9744112,895283,141
+1837249,895424,141
+3442493,895565,231
+10286618,895796,142
+5813795,895938,227
+10494686,896165,197
+16544763,896362,196
+279906,896558,130
+9886,896688,175
+12866628,896863,203
+49311,897066,151
+6948,897217,168
+13109929,897385,153
+6351721,897538,155
+12619552,897693,219
+7665654,897912,243
+12635202,898155,240
+2366182,898395,180
+6338414,898575,139
+11805488,898714,123
+544447,898837,176
+11010779,899013,178
+1858944,899191,205
+8394245,899396,152
+3972111,899548,140
+6046782,899688,127
+16286208,899815,132
+588778,899947,203
+3411814,900150,126
+5793254,900276,139
+20721,900415,131
+16049528,900546,220
+545979,900766,285
+6351706,901051,231
+14996339,901282,196
+12631194,901478,196
+7351305,901674,156
+9441953,901830,164
+6600227,901994,171
+12091445,902165,303
+11846250,902468,139
+10289090,902607,150
+4511864,902757,222
+10541063,902979,180
+2914318,903159,180
+3453450,903339,180
+10024107,903519,170
+14204864,903689,170
+2107009,903859,253
+16045600,904112,213
+6618002,904325,142
+1315654,904467,212
+9736244,904679,285
+9992720,904964,127
+5516254,905091,185
+10024833,905276,139
+7903171,905415,204
+5017819,905619,121
+12097966,905740,272
+15257785,906012,151
+3968774,906163,195
+11536501,906358,196
+9236754,906554,193
+8681015,906747,196
+16553013,906943,196
+14689409,907139,196
+11059434,907335,195
+1583827,907530,137
+8433787,907667,178
+13130399,907845,178
+4501163,908023,213
+10809438,908236,213
+1861758,908449,303
+12596822,908752,199
+5801378,908951,256
+2947227,909207,141
+1820,909348,113
+14739686,909461,228
+5243537,909689,170
+7647,909859,177
+9179130,910036,148
+11337221,910184,214
+7875193,910398,214
+7890265,910612,178
+5296885,910790,242
+2380394,911032,186
+2154425,911218,139
+6081235,911357,245
+2627199,911602,219
+11550289,911821,121
+6088835,911942,196
+1048951,912138,196
+4497809,912334,196
+6300580,912530,207
+10769166,912737,141
+16442,912878,125
+16287729,913003,123
+10234047,913126,199
+8417813,913325,121
+7657015,913446,141
+13655908,913587,154
+12370715,913741,115
+6610704,913856,160
+12870651,914016,132
+819494,914148,137
+3168020,914285,123
+6308986,914408,129
+13152717,914537,123
+1335499,914660,123
+12120362,914783,123
+306026,914906,165
+5525061,915071,60
+313351,915131,219
+303650,915350,158
+4758485,915508,145
+3968147,915653,137
+2686565,915790,225
+1574645,916015,164
+7636193,916179,203
+4520794,916382,178
+4479459,916560,196
+14439639,916756,141
+4510666,916897,141
+8953770,917038,174
+14963944,917212,117
+2135690,917329,261
+9181264,917590,261
+14210278,917851,147
+6831902,917998,157
+13823,918155,130
+16312224,918285,197
+2949102,918482,197
+8653692,918679,208
+4761404,918887,240
+13131064,919127,166
+16295779,919293,259
+10786835,919552,139
+7088528,919691,191
+9975277,919882,197
+544522,920079,196
+11028813,920275,196
+4456525,920471,196
+1625892,920667,196
+14195515,920863,197
+8929339,921060,197
+16549699,921257,197
+8418963,921454,132
+12359488,921586,154
+297055,921740,197
+13127886,921937,197
+5306533,922134,145
+1329596,922279,167
+2159736,922446,219
+9466714,922665,193
+1868377,922858,154
+1247,923012,158
+7616695,923170,134
+9176250,923304,117
+64033,923421,161
+8135426,923582,161
+1619703,923743,211
+6074719,923954,183
+1616586,924137,258
+13934016,924395,175
+13637994,924570,133
+4461520,924703,178
+2384555,924881,170
+8959030,925051,60
+7121669,925111,141
+3044,925252,133
+6345288,925385,139
+4742635,925524,132
+5247893,925656,207
+1628655,925863,131
+8968755,925994,268
+8701839,926262,124
+5259705,926386,153
+8444604,926539,175
+12623841,926714,178
+1590852,926892,161
+11563021,927053,114
+3435355,927167,185
+8710290,927352,153
+7922365,927505,154
+16271613,927659,192
+2152994,927851,196
+13115866,928047,254
+14726741,928301,242
+8565,928543,178
+8951622,928721,207
+1891927,928928,199
+14736639,929127,219
+6327519,929346,60
+30605,929406,141
+3724,929547,122
+34660,929669,141
+16528194,929810,137
+12871888,929947,187
+1355483,930134,187
+7920431,930321,130
+9179040,930451,143
+14465032,930594,145
+11593501,930739,191
+16300991,930930,131
+8679374,931061,213
+2123150,931274,196
+1588574,931470,196
+14446903,931666,178
+8682651,931844,229
+3424680,932073,146
+3464092,932219,178
+7618750,932397,139
+316612,932536,167
+15783138,932703,117
+11068099,932820,254
+9445570,933074,189
+827500,933263,186
+16569014,933449,154
+8407572,933603,123
+7355497,933726,123
+11283881,933849,253
+16561762,934102,124
+4719775,934226,162
+556952,934388,197
+13128289,934585,139
+12599585,934724,109
+7637179,934833,141
+10800914,934974,170
+5008118,935144,127
+4758993,935271,161
+11562976,935432,161
+4503956,935593,157
+4237631,935750,147
+7389074,935897,123
+12618865,936020,193
+16019278,936213,138
+2899723,936351,142
+6064150,936493,155
+12124,936648,141
+16016477,936789,114
+3733598,936903,166
+11320161,937069,195
+2390520,937264,147
+8191362,937411,213
+1576236,937624,141
+273844,937765,277
+319664,938042,254
+584949,938296,141
+13661776,938437,154
+6344873,938591,161
+8965882,938752,196
+9990,938948,131
+52049,939079,178
+12870839,939257,199
+15483160,939456,194
+14190091,939650,154
+3416067,939804,212
+15760744,940016,159
+4252630,940175,189
+11820368,940364,189
+7920290,940553,259
+3715486,940812,154
+3727982,940966,182
+53328,941148,130
+7391686,941278,141
+13941039,941419,166
+6855303,941585,141
+6598280,941726,127
+11313950,941853,189
+6011,942042,142
+10017476,942184,252
+5254040,942436,194
+13117490,942630,242
+9726583,942872,166
+12858475,943038,137
+8422569,943175,140
+16019093,943315,143
+5031894,943458,259
+13109363,943717,135
+7347195,943852,214
+292462,944066,164
+11303501,944230,149
+7093,944379,139
+9795,944518,167
+3719318,944685,149
+13652311,944834,170
+2654344,945004,122
+6606446,945126,135
+1848439,945261,144
+12336647,945405,208
+4783523,945613,219
+5783,945832,147
+12307,945979,140
+302590,946119,153
+846980,946272,257
+10279687,946529,148
+14478185,946677,166
+20021,946843,158
+16257800,947001,114
+16294614,947115,174
+1583684,947289,155
+16553166,947444,178
+9471643,947622,178
+14686367,947800,147
+7616109,947947,152
+8706863,948099,134
+9722059,948233,156
+2682010,948389,130
+16563835,948519,197
+11800499,948716,197
+15490152,948913,234
+12903686,949147,142
+3205978,949289,148
+16256879,949437,141
+32995,949578,161
+11847214,949739,121
+12068250,949860,144
+2630966,950004,211
+12099957,950215,123
+13423553,950338,169
+839928,950507,141
+7626640,950648,159
+10757717,950807,204
+6334256,951011,237
+3972054,951248,111
+16276380,951359,178
+7121192,951537,127
+55393,951664,160
+7651709,951824,230
+8942001,952054,139
+15773573,952193,139
+16559668,952332,139
+14473856,952471,185
+13398662,952656,227
+6614711,952883,196
+3703255,953079,130
+1574125,953209,130
+13906528,953339,114
+5299007,953453,171
+1081780,953624,219
+17017,953843,181
+47283,954024,141
+16047518,954165,114
+13949209,954279,114
+1315092,954393,253
+10768454,954646,219
+1844429,954865,169
+31789,955034,175
+11827016,955209,246
+16273436,955455,220
+4458251,955675,139
+16302665,955814,60
+12071349,955874,143
+15529661,956017,143
+3716307,956160,143
+13125506,956303,190
+15242083,956493,114
+8129782,956607,240
+7642489,956847,159
+55038,957006,141
+835444,957147,134
+16551805,957281,171
+2407960,957452,196
+11803947,957648,254
+1360403,957902,123
+7394067,958025,196
+10231094,958221,196
+13417470,958417,196
+10803505,958613,123
+12386009,958736,123
+8421923,958859,123
+3148384,958982,154
+8441957,959136,137
+2634086,959273,197
+12599300,959470,164
+2141526,959634,178
+5253621,959812,213
+13371643,960025,252
+12365713,960277,173
+15783900,960450,217
+29188,960667,188
+4245535,960855,268
+1333696,961123,122
+9200035,961245,139
+11014279,961384,130
+10496051,961514,154
+13157109,961668,259
+15751241,961927,158
+3466732,962085,140
+10808643,962225,154
+9709965,962379,228
+43630,962607,141
+818216,962748,109
+6833111,962857,231
+2152459,963088,137
+9211787,963225,196
+12085911,963421,156
+2654,963577,120
+4186,963697,115
+24727,963812,115
+24584,963927,115
+7022,964042,165
+1035,964207,130
+258,964337,115
+9240180,964452,135
+11010413,964587,133
+278697,964720,185
+4981059,964905,122
+14955667,965027,196
+3418386,965223,196
+6310826,965419,146
+4994638,965565,223
+12363147,965788,161
+8441529,965949,161
+13685756,966110,122
+7105747,966232,141
+14698989,966373,121
+8401120,966494,158
+15228294,966652,207
+1324825,966859,170
+5779264,967029,156
+561338,967185,129
+9741258,967314,141
+2378979,967455,139
+12107508,967594,127
+343,967721,134
+5832126,967855,228
+16052631,968083,152
+7138641,968235,176
+312294,968411,154
+2646838,968565,130
+1364329,968695,196
+1073893,968891,139
+8373,969030,182
+14705255,969212,219
+7387050,969431,197
+8696603,969628,127
+533797,969755,219
+12883200,969974,141
+16015586,970115,219
+14995748,970334,148
+5027,970482,166
+11581543,970648,158
+12583808,970806,137
+10009497,970943,202
+9762,971145,220
+16262958,971365,124
+10275152,971489,135
+16292112,971624,214
+5300463,971838,114
+8686221,971952,141
+1885163,972093,213
+5262462,972306,200
+5139,972506,233
+1945,972739,175
+13638843,972914,238
+7636923,973152,133
+6872358,973285,227
+2647779,973512,169
+6353290,973681,196
+15480947,973877,137
+7865459,974014,130
+11025934,974144,127
+1098098,974271,196
+5406,974467,220
+4382,974687,215
+16541,974902,130
+13390051,975032,170
+14476037,975202,127
+10803762,975329,130
+3822,975459,136
+8133710,975595,139
+14202551,975734,182
+8454,975916,145
+9180340,976061,178
+3971186,976239,159
+4244422,976398,136
+6067798,976534,169
+14704742,976703,159
+1348422,976862,149
+14475499,977011,218
+15502490,977229,196
+11830869,977425,196
+2901849,977621,258
+10753382,977879,194
+1873498,978073,226
+4201311,978299,224
+11068754,978523,164
+6081916,978687,187
+5002,978874,216
+11022509,979090,194
+12345334,979284,246
+13166552,979530,250
+6345244,979780,168
+13390260,979948,214
+50164,980162,175
+12094188,980337,156
+13686659,980493,196
+11287415,980689,178
+11598861,980867,141
+13420844,981008,158
+7737,981166,148
+7893597,981314,141
+16574058,981455,160
+7878348,981615,213
+9228124,981828,134
+7391283,981962,113
+816107,982075,154
+297697,982229,259
+15775185,982488,130
+57344,982618,160
+9471115,982778,153
+13162361,982931,203
+1094511,983134,189
+16554950,983323,223
+13117738,983546,161
+14975692,983707,126
+4743263,983833,189
+11551087,984022,226
+5250451,984248,196
+2627240,984444,143
+16315698,984587,139
+11568086,984726,139
+8439749,984865,199
+14959435,985064,117
+849316,985181,142
+10235553,985323,219
+562996,985542,158
+15768791,985700,321
+12378435,986021,123
+6582323,986144,123
+8677496,986267,123
+13160579,986390,123
+813756,986513,199
+32954,986712,151
+4721586,986863,154
+13418617,987017,178
+14686680,987195,126
+6303956,987321,123
+16291306,987444,123
+1634776,987567,123
+3984733,987690,196
+8156776,987886,196
+7092280,988082,185
+3201497,988267,123
+7868279,988390,272
+10762444,988662,156
+7631390,988818,137
+9194716,988955,210
+5268979,989165,137
+3970313,989302,174
+12364668,989476,158
+6605661,989634,159
+5775849,989793,121
+12885836,989914,196
+815178,990110,196
+15786972,990306,134
+11065857,990440,392
+8136070,990832,137
+15745480,990969,154
+13408534,991123,214
+15499206,991337,179
+5024764,991516,178
+4312,991694,122
+8596,991816,145
+6052586,991961,115
+2939,992076,125
+3210552,992201,139
+4998,992340,126
+15376,992466,141
+5547612,992607,165
+12377538,992772,170
+10016867,992942,272
+848710,993214,219
+8191821,993433,206
+13143846,993639,212
+7354995,993851,256
+1112555,994107,217
+8432918,994324,219
+282287,994543,139
+1610950,994682,247
+4242738,994929,130
+13405809,995059,141
+3732820,995200,162
+8972559,995362,126
+12404,995488,125
+15506315,995613,158
+11580333,995771,166
+1614474,995937,176
+2111067,996113,175
+15261184,996288,228
+7391566,996516,174
+7393409,996690,245
+16540730,996935,161
+11030875,997096,161
+5552101,997257,183
+9724786,997440,197
+12324775,997637,115
+16302368,997752,220
+15780305,997972,229
+3440220,998201,126
+11860985,998327,196
+5271415,998523,196
+803305,998719,196
+3991588,998915,196
+3430918,999111,149
+6454,999260,182
+12099337,999442,178
+262858,999620,236
+3996508,999856,199
+7618747,1000055,193
+1839457,1000248,133
+11853361,1000381,141
+10764327,1000522,178
+11859873,1000700,189
+2682336,1000889,185
+8961349,1001074,161
+5569776,1001235,161
+3172997,1001396,161
+5037361,1001557,161
+8959726,1001718,152
+7402016,1001870,155
+13664634,1002025,123
+10013235,1002148,123
+6859550,1002271,123
+7401216,1002394,123
+13137765,1002517,110
+2897861,1002627,243
+13385936,1002870,122
+8156720,1002992,254
+9970415,1003246,174
+7897144,1003420,157
+12386283,1003577,193
+304,1003770,150
+16517761,1003920,150
+15746522,1004070,130
+12060438,1004200,197
+11071174,1004397,128
+15003714,1004525,139
+4212989,1004664,154
+2143129,1004818,117
+13380897,1004935,230
+16535,1005165,125
+10244047,1005290,172
+14194400,1005462,236
+6242,1005698,136
+1896137,1005834,146
+3152,1005980,131
+3418865,1006111,130
+2127954,1006241,109
+13164233,1006350,117
+4511141,1006467,128
+3733309,1006595,141
+12623885,1006736,139
+811281,1006875,156
+8900,1007031,114
+1848078,1007145,137
+12121930,1007282,112
+6574342,1007394,137
+791865,1007531,123
+7100055,1007654,141
+1535,1007795,127
+16284448,1007922,141
+14723803,1008063,228
+15529041,1008291,158
+5771843,1008449,162
+11050988,1008611,139
+48798,1008750,199
+5555578,1008949,168
+5816698,1009117,170
+3670431,1009287,248
+2383051,1009535,142
+6331336,1009677,225
+4221582,1009902,204
+1839023,1010106,147
+8959142,1010253,193
+2674440,1010446,103
+8488,1010549,140
+7283,1010689,139
+2919026,1010828,156
+3714446,1010984,185
+3461304,1011169,154
+13657894,1011323,158
+15530740,1011481,177
+14192502,1011658,123
+4234280,1011781,123
+6070646,1011904,248
+5781625,1012152,158
+16010352,1012310,212
+13166576,1012522,137
+11572059,1012659,139
+16009711,1012798,149
+5562148,1012947,199
+11279839,1013146,154
+15259673,1013300,169
+7875966,1013469,134
+7609056,1013603,154
+2404873,1013757,122
+16541150,1013879,141
+11562687,1014020,167
+6307110,1014187,165
+12357690,1014352,130
+13676840,1014482,161
+12342353,1014643,161
+7636491,1014804,141
+1584536,1014945,171
+14198068,1015116,156
+15487420,1015272,213
+15759848,1015485,213
+7877147,1015698,189
+6297603,1015887,239
+41110,1016126,158
+7889276,1016284,158
+9703019,1016442,196
+6617936,1016638,140
+7662280,1016778,185
+11851342,1016963,162
+16293307,1017125,118
+14196765,1017243,170
+12907282,1017413,130
+9457297,1017543,154
+6088887,1017697,235
+3936690,1017932,137
+1067846,1018069,160
+14421037,1018229,225
+13658085,1018454,117
+9240244,1018571,232
+13395634,1018803,114
+10249710,1018917,200
+7916036,1019117,132
+3418511,1019249,154
+6089245,1019403,193
+1578070,1019596,134
+6088,1019730,156
+3728093,1019886,178
+8936955,1020064,178
+5813293,1020242,195
+14698707,1020437,182
+5825167,1020619,123
+7895946,1020742,123
+4986620,1020865,137
+4766886,1021002,193
+11536858,1021195,141
+1359,1021336,139
+23686,1021475,248
+3147071,1021723,160
+12114716,1021883,214
+3936486,1022097,132
+9454854,1022229,158
+8609,1022387,141
+16561816,1022528,197
+461,1022725,95
+6050925,1022820,196
+8692177,1023016,178
+9477501,1023194,139
+7900237,1023333,151
+7912474,1023484,141
+3673,1023625,171
+1056081,1023796,174
+14478163,1023970,243
+15502023,1024213,199
+8926815,1024412,189
+2657464,1024601,178
+16547670,1024779,164
+2900051,1024943,175
+823295,1025118,196
+5550369,1025314,196
+7897346,1025510,159
+8694428,1025669,158
+15790034,1025827,197
+2405086,1026024,170
+16028575,1026194,174
+1830,1026368,258
+16550807,1026626,261
+2927397,1026887,261
+1877298,1027148,217
+8082,1027365,161
+3075,1027526,145
+8174284,1027671,154
+9761064,1027825,156
+1055572,1027981,191
+11013219,1028172,196
+6079239,1028368,196
+14684287,1028564,135
+12845436,1028699,135
+326207,1028834,155
+5505591,1028989,122
+5025800,1029111,282
+15233010,1029393,155
+20504,1029548,142
+7397113,1029690,244
+11594428,1029934,164
+9750161,1030098,200
+3995025,1030298,213
+6299905,1030511,213
+8186751,1030724,181
+9209216,1030905,152
+4211241,1031057,136
+16527211,1031193,173
+2652937,1031366,178
+9668,1031544,135
+12633376,1031679,135
+7910029,1031814,184
+11042872,1031998,237
+16260496,1032235,172
+10512964,1032407,111
+14466682,1032518,189
+3422391,1032707,166
+13370999,1032873,199
+7881985,1033072,129
+3185699,1033201,160
+5560145,1033361,121
+1341451,1033482,186
+11317177,1033668,161
+8958225,1033829,139
+9189724,1033968,121
+13903243,1034089,139
+269165,1034228,189
+16007510,1034417,129
+32962,1034546,155
+6852022,1034701,149
+15528770,1034850,213
+5308192,1035063,167
+14964544,1035230,139
+16291010,1035369,139
+7394169,1035508,141
+63532,1035649,141
+49585,1035790,141
+16055473,1035931,113
+14207209,1036044,182
+8173920,1036226,225
+11550102,1036451,145
+9989212,1036596,302
+2390314,1036898,135
+3199878,1037033,178
+7396248,1037211,141
+11807246,1037352,165
+10274990,1037517,171
+11548063,1037688,139
+12638562,1037827,173
+16255947,1038000,141
+5297023,1038141,258
+1577490,1038399,141
+7395619,1038540,196
+12073480,1038736,230
+2667592,1038966,196
+1049857,1039162,168
+2947746,1039330,156
+10787829,1039486,163
+5258657,1039649,175
+15767525,1039824,159
+4987453,1039983,213
+524942,1040196,122
+15263538,1040318,158
+11828380,1040476,141
+16033593,1040617,137
+16019627,1040754,197
+2906639,1040951,141
+2896164,1041092,141
+5255735,1041233,123
+11552794,1041356,123
+11836639,1041479,123
+4767595,1041602,123
+2891192,1041725,139
+5800477,1041864,131
+14196997,1041995,220
+12361794,1042215,226
+3933464,1042441,161
+9438760,1042602,161
+11839998,1042763,183
+569944,1042946,137
+10257599,1043083,123
+1876179,1043206,154
+10288337,1043360,215
+13422110,1043575,206
+849109,1043781,135
+8136292,1043916,178
+11299599,1044094,151
+13153709,1044245,158
+8140902,1044403,130
+811471,1044533,130
+10231128,1044663,130
+3671468,1044793,127
+3436189,1044920,127
+6837441,1045047,148
+4379,1045195,174
+7107853,1045369,151
+12337039,1045520,196
+1323012,1045716,196
+16047169,1045912,205
+12878703,1046117,133
+8177348,1046250,169
+3919,1046419,140
+11013322,1046559,256
+3713596,1046815,183
+770,1046998,157
+5285072,1047155,154
+8388624,1047309,113
+9457,1047422,239
+1323005,1047661,141
+801997,1047802,228
+1354693,1048030,139
+5296659,1048169,177
+7721,1048346,130
+5244088,1048476,196
+53426,1048672,150
+6094645,1048822,164
+13410170,1048986,198
+7926430,1049184,168
+6584189,1049352,208
+10244334,1049560,208
+4255128,1049768,154
+13144569,1049922,171
+11328741,1050093,159
+45922,1050252,123
+15000747,1050375,123
+6345314,1050498,134
+8651986,1050632,159
+5569174,1050791,109
+6304587,1050900,123
+3715031,1051023,160
+2660666,1051183,144
+6613900,1051327,160
+16026704,1051487,139
+14471765,1051626,174
+10497078,1051800,226
+800,1052026,125
+5278223,1052151,284
+8178658,1052435,154
+11052514,1052589,202
+12363942,1052791,139
+7667532,1052930,212
+6860563,1053142,141
+6822578,1053283,159
+14700477,1053442,245
+8186798,1053687,162
+14700683,1053849,186
+10231445,1054035,155
+6308479,1054190,285
+15244980,1054475,193
+13920874,1054668,193
+10026356,1054861,138
+6609731,1054999,271
+3672,1055270,126
+9616,1055396,160
+11280235,1055556,149
+2862,1055705,227
+4744686,1055932,154
+13694779,1056086,158
+1574517,1056244,133
+4034,1056377,150
+7138394,1056527,252
+4506438,1056779,196
+3175574,1056975,196
+7375369,1057171,196
+13420015,1057367,189
+9437865,1057556,180
+12593293,1057736,135
+805171,1057871,220
+100,1058091,203
+5270413,1058294,129
+14559,1058423,141
+16042725,1058564,131
+9437262,1058695,193
+8136244,1058888,139
+4256787,1059027,115
+13161471,1059142,139
+12893828,1059281,128
+16053540,1059409,193
+48065,1059602,135
+2408893,1059737,195
+41710,1059932,141
+23004,1060073,141
+64837,1060214,158
+5282035,1060372,145
+11850037,1060517,139
+5029,1060656,153
+10239439,1060809,122
+2394260,1060931,241
+11553727,1061172,258
+13380995,1061430,213
+13921806,1061643,252
+8926828,1061895,158
+4774550,1062053,179
+15758564,1062232,228
+10514988,1062460,166
+16570440,1062626,123
+15470715,1062749,161
+1844012,1062910,161
+14683577,1063071,121
+14421296,1063192,234
+15772887,1063426,154
+9737632,1063580,139
+42698,1063719,141
+3724615,1063860,167
+16548806,1064027,200
+3192399,1064227,137
+1875262,1064364,214
+15740839,1064578,196
+1629911,1064774,196
+13123028,1064970,165
+14727501,1065135,238
+14173483,1065373,214
+14948459,1065587,187
+34609,1065774,141
+8969897,1065915,123
+7899274,1066038,130
+8657,1066168,161
+8140,1066329,161
+10758531,1066490,151
+15501458,1066641,200
+7636905,1066841,178
+19063,1067019,178
+10753079,1067197,204
+6332682,1067401,161
+9204216,1067562,161
+13370651,1067723,161
+9205522,1067884,161
+9724881,1068045,161
+8658,1068206,161
+6048125,1068367,175
+9970510,1068542,121
+5259160,1068663,155
+7872633,1068818,113
+811126,1068931,193
+847590,1069124,193
+14996797,1069317,193
+12588093,1069510,193
+12589189,1069703,193
+29852,1069896,198
+5805263,1070094,160
+2160734,1070254,147
+7873965,1070401,179
+15523995,1070580,184
+9188,1070764,136
+7394546,1070900,112
+7919344,1071012,192
+12329124,1071204,161
+578603,1071365,161
+7904976,1071526,161
+11584743,1071687,161
+10487704,1071848,161
+8141,1072009,161
+3730660,1072170,161
+9720067,1072331,161
+9360,1072492,161
+9175,1072653,161
+5544722,1072814,161
+16556350,1072975,161
+2410134,1073136,160
+9754481,1073296,160
+15224452,1073456,160
+5682,1073616,163
+14999749,1073779,177
+13112441,1073956,160
+1879813,1074116,160
+5851,1074276,155
+7906,1074431,161
+2151871,1074592,177
+6088939,1074769,161
+12631505,1074930,185
+11827623,1075115,185
+8131019,1075300,196
+1844705,1075496,185
+12645942,1075681,232
+6690,1075913,153
+11591482,1076066,160
+8410905,1076226,160
+3456512,1076386,160
+5563104,1076546,139
+3439200,1076685,139
+7363,1076824,139
+2362818,1076963,172
+7885338,1077135,160
+7374278,1077295,139
+2145222,1077434,158
+327329,1077592,196
+15502498,1077788,135
+12058648,1077923,130
+7631536,1078053,219
+5532686,1078272,130
+15503022,1078402,144
+10503131,1078546,133
+14739387,1078679,134
+32908,1078813,118
+302977,1078931,118
+4231,1079049,134
+45235,1079183,129
+303050,1079312,196
+5243243,1079508,196
+11290669,1079704,268
+9059,1079972,217
+27,1080189,125
+36952,1080314,218
+7421,1080532,154
+524423,1080686,127
+14424577,1080813,231
+21663,1081044,122
+2630911,1081166,178
+3679595,1081344,134
+7407,1081478,152
+630,1081630,166
+5026332,1081796,216
+2121463,1082012,161
+1318776,1082173,161
+14173968,1082334,190
+6514,1082524,157
+9031,1082681,150
+9384,1082831,150
+12620084,1082981,150
+6505,1083131,132
+6320,1083263,132
+5834,1083395,132
+4045,1083527,132
+7098,1083659,132
+1244,1083791,132
+3319,1083923,132
+5134,1084055,132
+7711,1084187,132
+2112239,1084319,140
+22905,1084459,154
+2129039,1084613,152
+2868,1084765,185
+7648638,1084950,178
+12106531,1085128,266
+3467828,1085394,259
+3183350,1085653,222
+11054397,1085875,196
+2404170,1086071,148
+8134756,1086219,140
+4512913,1086359,184
+14720440,1086543,184
+3929,1086727,113
+5240,1086840,189
+4782305,1087029,114
+9212115,1087143,114
+10488,1087257,139
+5815439,1087396,162
+13915582,1087558,248
+6557134,1087806,260
+5558898,1088066,147
+15476475,1088213,130
+8436,1088343,157
+323217,1088500,122
+11826243,1088622,161
+16578119,1088783,213
+1599594,1088996,178
+12864465,1089174,225
+7125445,1089399,155
+3176047,1089554,189
+11047468,1089743,189
+16256243,1089932,189
+12884482,1090121,189
+8043,1090310,189
+9954,1090499,189
+14435367,1090688,154
+12334080,1090842,154
+15239276,1090996,225
+9471,1091221,149
+7713,1091370,142
+925,1091512,140
+2061,1091652,114
+3707,1091766,115
+946,1091881,107
+10248481,1091988,245
+41158,1092233,126
+6593665,1092359,132
+6762,1092491,140
+10776948,1092631,196
+16042834,1092827,196
+12060887,1093023,196
+9724190,1093219,216
+49380,1093435,140
+3344,1093575,125
+8104,1093700,173
+4059,1093873,149
+3934065,1094022,135
+8405326,1094157,208
+2397250,1094365,152
+12870675,1094517,141
+4298,1094658,144
+57502,1094802,145
+2568,1094947,169
+2124426,1095116,218
+7881846,1095334,270
+4453,1095604,141
+2664,1095745,178
+8582,1095923,212
+1587481,1096135,130
+15261879,1096265,114
+6817557,1096379,139
+3978935,1096518,196
+12855189,1096714,165
+10494118,1096879,170
+5788298,1097049,172
+12906961,1097221,252
+11331451,1097473,245
+2897568,1097718,122
+11580124,1097840,187
+13393230,1098027,187
+4213251,1098214,187
+13134983,1098401,187
+7872,1098588,157
+6577554,1098745,262
+3718170,1099007,190
+8399252,1099197,165
+14714973,1099362,165
+3410687,1099527,189
+5799521,1099716,189
+12624290,1099905,129
+577719,1100034,189
+15521418,1100223,252
+5264082,1100475,258
+9498329,1100733,198
+6317139,1100931,174
+7117035,1101105,155
+40478,1101260,141
+9534,1101401,154
+13152227,1101555,228
+13410912,1101783,245
+8148814,1102028,124
+2683150,1102152,117
+284164,1102269,232
+3457273,1102501,155
+65224,1102656,141
+2906765,1102797,185
+1097461,1102982,189
+14973759,1103171,205
+821895,1103376,155
+5565859,1103531,126
+4256800,1103657,245
+3449506,1103902,196
+7642511,1104098,196
+9722119,1104294,255
+6216,1104549,146
+5883,1104695,165
+10502494,1104860,159
+11034806,1105019,123
+12890881,1105142,123
+14704453,1105265,123
+7654457,1105388,199
+3678934,1105587,207
+9758917,1105794,139
+7093099,1105933,128
+8935,1106061,149
+4739511,1106210,139
+12117881,1106349,121
+13132999,1106470,159
+4733752,1106629,123
+1872200,1106752,123
+9461550,1106875,172
+16262066,1107047,196
+3412624,1107243,144
+8191566,1107387,263
+6574000,1107650,135
+57574,1107785,131
+2683750,1107916,246
+14721964,1108162,196
+12350836,1108358,196
+2139776,1108554,196
+8923315,1108750,196
+10806679,1108946,121
+27836,1109067,141
+6058147,1109208,189
+7432,1109397,181
+7554,1109578,127
+4887,1109705,132
+41124,1109837,147
+7640961,1109984,178
+500,1110162,121
+4251,1110283,140
+5162,1110423,184
+4443,1110607,191
+12599253,1110798,182
+15509611,1110980,183
+13147356,1111163,183
+9489,1111346,189
+4491260,1111535,189
+11037613,1111724,193
+14159769,1111917,193
+11841882,1112110,179
+9317,1112289,136
+2207,1112425,152
+20732,1112577,169
+10280707,1112746,200
+4488,1112946,121
+5882,1113067,132
+16294280,1113199,144
+10519212,1113343,169
+11037377,1113512,158
+13919230,1113670,158
+6853473,1113828,214
+12326316,1114042,152
+48514,1114194,254
+9720125,1114448,147
+4468,1114595,148
+6484,1114743,146
+9725671,1114889,175
+5028021,1115064,254
+7374274,1115318,174
+15504365,1115492,137
+3210344,1115629,252
+35478,1115881,141
+12345511,1116022,173
+8424599,1116195,168
+14478854,1116363,196
+283335,1116559,136
+15738693,1116695,140
+5558452,1116835,236
+4988,1117071,166
+15226457,1117237,185
+3456912,1117422,213
+13415416,1117635,170
+14984305,1117805,139
+1110021,1117944,139
+6605870,1118083,219
+8913394,1118302,174
+1364255,1118476,196
+14420300,1118672,196
+1861464,1118868,196
+2407672,1119064,196
+10486846,1119260,214
+13124905,1119474,154
+8144764,1119628,154
+16283576,1119782,175
+15782641,1119957,141
+11068398,1120098,173
+9357,1120271,173
+1055,1120444,173
+2140430,1120617,172
+15483787,1120789,115
+9964709,1120904,271
+4460802,1121175,161
+11034340,1121336,155
+1581461,1121491,161
+4487230,1121652,161
+828148,1121813,201
+12338352,1122014,115
+7651255,1122129,189
+5298688,1122318,214
+16051551,1122532,164
+57572,1122696,183
+2198,1122879,144
+2383550,1123023,162
+263402,1123185,167
+8392151,1123352,144
+13677885,1123496,144
+53484,1123640,164
+5033066,1123804,160
+3171179,1123964,123
+7374925,1124087,157
+10809832,1124244,123
+5531473,1124367,189
+2362122,1124556,150
+13670869,1124706,143
+1360834,1124849,158
+1079387,1125007,155
+14418039,1125162,252
+16053669,1125414,127
+15506267,1125541,142
+2935829,1125683,142
+1358702,1125825,175
+1607340,1126000,136
+8028,1126136,136
+7936,1126272,136
+9543,1126408,135
+6341,1126543,132
+5710,1126675,135
+9832,1126810,135
+9341,1126945,135
+8805,1127080,135
+16285846,1127215,229
+11014652,1127444,139
+7594,1127583,128
+14981329,1127711,134
+7087993,1127845,134
+53020,1127979,172
+2673665,1128151,160
+14220126,1128311,164
+8998,1128475,160
+835349,1128635,140
+3403,1128775,126
+16635,1128901,156
+13653037,1129057,192
+7621284,1129249,178
+7081,1129427,195
+3187232,1129622,138
+7140211,1129760,160
+10238639,1129920,160
+7872475,1130080,160
+5023085,1130240,161
+12086504,1130401,161
+832281,1130562,161
+1589063,1130723,160
+11821715,1130883,160
+5285064,1131043,160
+29,1131203,149
+1599408,1131352,175
+7111478,1131527,160
+14473340,1131687,233
+12900989,1131920,156
+2922,1132076,185
+37014,1132261,145
+7070,1132406,150
+14731924,1132556,163
+9910,1132719,163
+9559,1132882,138
+7372,1133020,138
+12298,1133158,150
+7999,1133308,110
+2385169,1133418,110
+12648404,1133528,122
+7123150,1133650,122
+36594,1133772,122
+10277741,1133894,122
+12846101,1134016,122
+15269039,1134138,122
+8657758,1134260,122
+2928733,1134382,122
+10494391,1134504,122
+9394,1134626,122
+6959,1134748,122
+9805,1134870,177
+8690854,1135047,169
+14696004,1135216,120
+7987,1135336,122
+8256,1135458,139
+3697595,1135597,139
+15232338,1135736,139
+3962186,1135875,139
+14975897,1136014,139
+8515,1136153,139
+7665170,1136292,139
+9365,1136431,139
+9376,1136570,139
+2062,1136709,139
+37020,1136848,139
+4645,1136987,139
+1334225,1137126,139
+7127506,1137265,139
+1840200,1137404,139
+6020,1137543,139
+7185,1137682,139
+7750,1137821,139
+6308,1137960,139
+6336,1138099,139
+9076,1138238,139
+11329552,1138377,183
+7632200,1138560,141
+177,1138701,122
+6146,1138823,174
+7749,1138997,183
+7332,1139180,183
+6773,1139363,183
+7898172,1139546,148
+5033,1139694,149
+2777,1139843,183
+3591,1140026,183
+9752108,1140209,183
+16519142,1140392,173
+7659051,1140565,192
+8799,1140757,192
+6067106,1140949,186
+2424146,1141135,180
+2936922,1141315,180
+7660867,1141495,180
+5583,1141675,139
+7142055,1141814,142
+9201,1141956,183
+5563581,1142139,223
+5510397,1142362,177
+9440193,1142539,246
+7336,1142785,179
+4742496,1142964,175
+14452190,1143139,173
+11595333,1143312,181
+9102,1143493,136
+7563,1143629,136
+5064,1143765,136
+14420762,1143901,134
+813798,1144035,162
+8660501,1144197,136
+15762479,1144333,136
+5515038,1144469,163
+2671325,1144632,170
+8430985,1144802,170
+12847416,1144972,201
+7248,1145173,206
+43522,1145379,124
+11331056,1145503,131
+16027192,1145634,117
+7652923,1145751,169
+8157841,1145920,139
+11303841,1146059,139
+7088533,1146198,139
+9981934,1146337,139
+15215338,1146476,139
+6313752,1146615,139
+12900743,1146754,139
+16578734,1146893,139
+6305501,1147032,139
+1051561,1147171,139
+9203802,1147310,139
+6317856,1147449,139
+8150264,1147588,139
+11854276,1147727,134
+14710141,1147861,190
+3455782,1148051,190
+8416283,1148241,200
+5867,1148441,139
+6366,1148580,139
+6086853,1148719,139
+5810233,1148858,139
+7783,1148997,139
+8954,1149136,139
+5376,1149275,139
+10520756,1149414,139
+6586521,1149553,139
+13663797,1149692,139
+7781,1149831,139
+3441734,1149970,127
+282118,1150097,127
+9998,1150224,139
+9913,1150363,127
+6553706,1150490,117
+53406,1150607,119
+6628,1150726,126
+6852,1150852,126
+7003,1150978,126
+3992143,1151104,124
+14450596,1151228,124
+11589068,1151352,130
+3680733,1151482,134
+7879,1151616,122
+9808,1151738,126
+9041,1151864,126
+7759,1151990,126
+6039050,1152116,127
+7882180,1152243,115
+13115238,1152358,117
+5573,1152475,117
+5154,1152592,117
+1087542,1152709,117
+8391296,1152826,154
+16309128,1152980,117
+3973960,1153097,197
+14965410,1153294,197
+13384510,1153491,132
+2130624,1153623,219
+14446029,1153842,213
+12855341,1154055,168
+5785313,1154223,152
+5951,1154375,161
+7391,1154536,163
+12604967,1154699,163
+4986859,1154862,177
+13382587,1155039,195
+14183657,1155234,177
+15266224,1155411,177
+6056754,1155588,144
+8707360,1155732,144
+6193,1155876,144
+2424155,1156020,141
+2651853,1156161,236
+2118962,1156397,235
+2948965,1156632,162
+2893783,1156794,137
+9980897,1156931,137
+10534,1157068,206
+2406931,1157274,161
+6117,1157435,144
+6124,1157579,144
+6119,1157723,144
+6121,1157867,144
+1882764,1158011,144
+5609,1158155,153
+6929,1158308,157
+9818,1158465,145
+13155865,1158610,176
+10795638,1158786,206
+20674,1158992,154
+4456464,1159146,123
+22221,1159269,123
+24631,1159392,148
+14467307,1159540,154
+2669654,1159694,120
+52734,1159814,123
+10549397,1159937,233
+30925,1160170,144
+11810473,1160314,190
+7391821,1160504,181
+6673,1160685,139
+4774736,1160824,206
+13125516,1161030,228
+10285013,1161258,152
+10236966,1161410,139
+2911877,1161549,139
+7633,1161688,139
+7631,1161827,139
+7637,1161966,139
+7636,1162105,139
+14981334,1162244,123
+8835,1162367,137
+4315,1162504,137
+4638,1162641,137
+13411426,1162778,139
+4736288,1162917,139
+13110903,1163056,287
+1077055,1163343,161
+9456122,1163504,139
+12324708,1163643,139
+197,1163782,139
+6575537,1163921,139
+691,1164060,133
+839,1164193,133
+3596,1164326,140
+14209925,1164466,137
+1616133,1164603,137
+7032,1164740,137
+15006461,1164877,139
+9725340,1165016,139
+11585349,1165155,159
+1363938,1165314,139
+4514103,1165453,139
+4896,1165592,139
+32993,1165731,140
+16309119,1165871,135
+6596457,1166006,135
+15243716,1166141,156
+12373964,1166297,150
+1258,1166447,130
+4729,1166577,137
+4897,1166714,137
+2050,1166851,137
+677,1166988,137
+6257,1167125,137
+3711,1167262,137
+4485,1167399,137
+1073227,1167536,137
+13159352,1167673,137
+8664215,1167810,137
+7127575,1167947,137
+1333456,1168084,137
+6064696,1168221,137
+15506036,1168358,137
+2906597,1168495,137
+14220344,1168632,192
+11282956,1168824,178
+2910104,1169002,136
+9037,1169138,193
+9558,1169331,193
+6297736,1169524,178
+14180528,1169702,168
+5564156,1169870,207
+7662138,1170077,203
+16259687,1170280,264
+15472431,1170544,264
+8681336,1170808,146
+8945411,1170954,195
+6624,1171149,181
+9606,1171330,203
+16003523,1171533,123
+6596035,1171656,123
+2643546,1171779,193
+7124331,1171972,171
+12335850,1172143,250
+14951077,1172393,139
+13945266,1172532,151
+6300096,1172683,177
+8925322,1172860,177
+6085332,1173037,184
+9960,1173221,184
+9490,1173405,195
+7206,1173600,193
+1369828,1173793,266
+3427152,1174059,158
+16566423,1174217,159
+5838,1174376,193
+8808,1174569,193
+6274,1174762,201
+13953550,1174963,122
+7141976,1175085,122
+2159523,1175207,236
+800732,1175443,236
+12351088,1175679,236
+2415532,1175915,236
+1842535,1176151,236
+3149525,1176387,193
+4741814,1176580,193
+5518640,1176773,193
+16279249,1176966,193
+2386341,1177159,182
+15475517,1177341,184
+7927293,1177525,184
+6061406,1177709,184
+9463580,1177893,196
+12330464,1178089,196
+16049147,1178285,196
+13643187,1178481,213
+15256877,1178694,213
+8693988,1178907,236
+825023,1179143,196
+6350593,1179339,196
+15206539,1179535,196
+10506694,1179731,122
+15789008,1179853,203
+6569612,1180056,172
+4818,1180228,133
+11035634,1180361,141
+8151191,1180502,198
+13390773,1180700,198
+6348356,1180898,198
+1069426,1181096,172
+583759,1181268,172
+8947203,1181440,189
+325944,1181629,198
+11306301,1181827,198
+4736763,1182025,198
+13696848,1182223,130
+2147215,1182353,130
+8152733,1182483,130
+14212605,1182613,130
+13655992,1182743,128
+14689407,1182871,191
+17995,1183062,191
+8452870,1183253,191
+7120969,1183444,122
+6603604,1183566,122
+5295394,1183688,122
+11839834,1183810,122
+8710936,1183932,128
+15470887,1184060,128
+5772838,1184188,122
+7398434,1184310,139
+20495,1184449,141
+8134105,1184590,219
+10520262,1184809,219
+10262944,1185028,219
+5784728,1185247,219
+57520,1185466,147
+57598,1185613,147
+57396,1185760,147
+57593,1185907,147
+13162265,1186054,133
+4217,1186187,143
+4137,1186330,143
+3592,1186473,140
+4457383,1186613,142
+11598571,1186755,142
+8170868,1186897,142
+24638,1187039,147
+24623,1187186,147
+24647,1187333,147
+20642,1187480,141
+573,1187621,142
+2112007,1187763,142
+20522,1187905,143
+12326645,1188048,142
+16538425,1188190,142
+3436432,1188332,142
+6093926,1188474,142
+13921616,1188616,142
+7643183,1188758,142
+8949901,1188900,142
+15759382,1189042,142
+8762,1189184,134
+8638,1189318,134
+1366761,1189452,141
+16044002,1189593,142
+11013133,1189735,142
+12614588,1189877,142
+2419123,1190019,142
+4568,1190161,146
+12618848,1190307,142
+15265267,1190449,142
+14993186,1190591,142
+6613328,1190733,142
+15998914,1190875,142
+4500953,1191017,142
+813059,1191159,142
+1892007,1191301,142
+15761158,1191443,142
+8974385,1191585,142
+6387,1191727,140
+6802,1191867,140
+3137,1192007,133
+5814,1192140,133
+6392,1192273,135
+9518,1192408,131
+5559407,1192539,131
+10789450,1192670,134
+4513934,1192804,134
+57398,1192938,159
+57423,1193097,147
+4351,1193244,147
+4180,1193391,147
+4342,1193538,147
+4262,1193685,147
+12371984,1193832,134
+8172059,1193966,132
+2389629,1194098,131
+4726128,1194229,134
+15774437,1194363,142
+9010,1194505,123
+9068,1194628,123
+9183,1194751,123
+9472,1194874,123
+9660,1194997,123
+5806013,1195120,142
+6062991,1195262,142
+15514909,1195404,142
+6627,1195546,123
+7011,1195669,123
+7874,1195792,123
+8179,1195915,123
+4346,1196038,123
+20708,1196161,123
+3475,1196284,123
+8190687,1196407,123
+7906276,1196530,123
+1347526,1196653,123
+2648760,1196776,123
+2678828,1196899,123
+14727610,1197022,123
+50704,1197145,123
+12121777,1197268,123
+9239226,1197391,123
+8180163,1197514,123
+15785186,1197637,123
+2403201,1197760,123
+14743623,1197883,123
+2680783,1198006,123
+14995087,1198129,123
+11018342,1198252,123
+12341943,1198375,123
+6052168,1198498,123
+13155528,1198621,123
+15205387,1198744,123
+1333765,1198867,123
+1878951,1198990,123
+12616826,1199113,123
+3413406,1199236,123
+5812277,1199359,123
+14452440,1199482,123
+9484593,1199605,123
+13689152,1199728,123
+2400993,1199851,123
+270668,1199974,155
+16265956,1200129,167
+8448662,1200296,123
+6292232,1200419,123
+323902,1200542,123
+10023083,1200665,123
+7877057,1200788,123
+7879300,1200911,123
+6065486,1201034,123
+8938463,1201157,123
+8920993,1201280,123
+13164779,1201403,123
+10008803,1201526,123
+8934293,1201649,123
+7891996,1201772,123
+5016953,1201895,123
+1893931,1202018,123
+798753,1202141,123
+802463,1202264,123
+16579656,1202387,123
+10234175,1202510,123
+8429995,1202633,129
+8661082,1202762,146
+13940991,1202908,177
+553986,1203085,123
+9762467,1203208,123
+10019033,1203331,123
+13380085,1203454,123
+2644715,1203577,123
+15737973,1203700,123
+2891555,1203823,123
+5545747,1203946,123
+15784930,1204069,123
+7635220,1204192,123
+1635907,1204315,123
+10772064,1204438,123
+10491944,1204561,123
+13632331,1204684,123
+1065343,1204807,123
+11036287,1204930,123
+13641112,1205053,123
+8437253,1205176,123
+2400372,1205299,123
+8681611,1205422,123
+8692771,1205545,178
+3962995,1205723,124
+10258605,1205847,199
+8950910,1206046,199
+13148878,1206245,153
+5829782,1206398,140
+5799767,1206538,123
+13663277,1206661,229
+15492327,1206890,144
+4228654,1207034,167
+12893162,1207201,165
+9996100,1207366,220
+15217726,1207586,214
+3434887,1207800,178
+10023976,1207978,178
+10800178,1208156,199
+27986,1208355,123
+10498713,1208478,171
+4216036,1208649,135
+14457486,1208784,205
+11333278,1208989,161
+12081112,1209150,161
+7388990,1209311,165
+11061375,1209476,140
+3965726,1209616,136
+9494523,1209752,138
+3168826,1209890,167
+2885660,1210057,109
+12616840,1210166,125
+3732823,1210291,126
+5547002,1210417,175
+2387082,1210592,145
+11322651,1210737,243
+3694438,1210980,134
+12076249,1211114,123
+10254851,1211237,133
+6082431,1211370,170
+6820501,1211540,163
+7344558,1211703,149
+269946,1211852,128
+8693640,1211980,116
+11296950,1212096,127
+1356656,1212223,277
+6851009,1212500,196
+1853819,1212696,230
+2936664,1212926,196
+13669248,1213122,176
+6879574,1213298,188
+13150716,1213486,178
+16580290,1213664,164
+6855351,1213828,163
+4476072,1213991,144
+8137697,1214135,199
+5255597,1214334,224
+1326783,1214558,178
+16527343,1214736,182
+10797368,1214918,207
+2159888,1215125,155
+11039773,1215280,172
+15768145,1215452,248
+5027884,1215700,176
+14983983,1215876,268
+16017197,1216144,218
+11065384,1216362,148
+12085698,1216510,188
+8965029,1216698,242
+8167998,1216940,196
+5249701,1217136,133
+10784059,1217269,111
+1857278,1217380,193
+12097968,1217573,145
+14179823,1217718,160
+8954583,1217878,196
+12858,1218074,119
+8429483,1218193,199
+14680944,1218392,233
+287081,1218625,170
+12381023,1218795,238
+11295252,1219033,161
+15772500,1219194,158
+3944824,1219352,123
+584873,1219475,161
+14699333,1219636,165
+16018066,1219801,248
+15783511,1220049,129
+10237940,1220178,196
+3950353,1220374,196
+6089576,1220570,184
+11294252,1220754,175
+16554746,1220929,138
+1316220,1221067,163
+2155527,1221230,125
+13671851,1221355,172
+8942468,1221527,114
+2386238,1221641,179
+12639338,1221820,247
+2404521,1222067,218
+1885574,1222285,160
+4227040,1222445,248
+13164848,1222693,155
+4747003,1222848,196
+11572844,1223044,161
+1896510,1223205,128
+12860094,1223333,183
+8928139,1223516,186
+15006009,1223702,179
+1338226,1223881,219
+12120192,1224100,126
+8409191,1224226,178
+7928132,1224404,60
+2389590,1224464,246
+16306117,1224710,193
+10779525,1224903,136
+6052661,1225039,156
+15514366,1225195,122
+3943572,1225317,307
+2366276,1225624,207
+8431709,1225831,156
+11324075,1225987,138
+4740117,1226125,185
+7880932,1226310,161
+14719345,1226471,161
+7395996,1226632,120
+2925236,1226752,179
+1102730,1226931,161
+14976257,1227092,146
+2122356,1227238,149
+15210027,1227387,187
+11826006,1227574,228
+3434645,1227802,193
+8680195,1227995,328
+3982049,1228323,185
+9209659,1228508,133
+4519031,1228641,137
+1321329,1228778,202
+7924096,1228980,166
+14745591,1229146,136
+3959453,1229282,165
+3448372,1229447,225
+7344071,1229672,236
+12350679,1229908,228
+7924500,1230136,248
+3950903,1230384,159
+8668260,1230543,123
+13664,1230666,135
+16301121,1230801,181
+3979154,1230982,202
+16298739,1231184,217
+2677130,1231401,192
+14193473,1231593,167
+1875659,1231760,269
+13929945,1232029,143
+14468642,1232172,155
+9448647,1232327,151
+8941807,1232478,183
+9748536,1232661,133
+6829749,1232794,147
+12847232,1232941,183
+14188601,1233124,157
+6067818,1233281,125
+12368966,1233406,170
+9967340,1233576,128
+13656736,1233704,258
+9443227,1233962,124
+1374355,1234086,192
+5775670,1234278,153
+8390914,1234431,165
+301542,1234596,205
+7405404,1234801,229
+4999386,1235030,204
+2120954,1235234,214
+8688396,1235448,150
+1876657,1235598,155
+3689334,1235753,132
+3715547,1235885,193
+3471058,1236078,155
+3175698,1236233,183
+6553645,1236416,139
+11828265,1236555,268
+13930291,1236823,149
+5568630,1236972,123
+3454973,1237095,288
+11802496,1237383,143
+4758808,1237526,142
+9445434,1237668,201
+8448714,1237869,167
+2140571,1238036,149
+6309926,1238185,161
+3732287,1238346,147
+14159055,1238493,144
+5028696,1238637,210
+10752578,1238847,145
+13634219,1238992,203
+12845062,1239195,165
+3679787,1239360,155
+4721737,1239515,164
+3987918,1239679,124
+6322146,1239803,161
+16521488,1239964,161
+16546059,1240125,183
+6324729,1240308,145
+8651175,1240453,162
+10023280,1240615,178
+6843976,1240793,221
+313745,1241014,151
+3973389,1241165,161
+6581426,1241326,161
+6817137,1241487,161
+1356932,1241648,161
+16041031,1241809,227
+13165615,1242036,183
+12896748,1242219,154
+3466282,1242373,154
+3168695,1242527,125
+2140039,1242652,176
+10550382,1242828,126
+2118602,1242954,160
+10763640,1243114,213
+284463,1243327,169
+14194556,1243496,131
+12356878,1243627,114
+10788741,1243741,146
+7901758,1243887,131
+11315616,1244018,140
+10781166,1244158,131
+7919215,1244289,208
+4464273,1244497,211
+12870251,1244708,134
+15472486,1244842,156
+10539306,1244998,166
+2136809,1245164,229
+3431696,1245393,111
+7083255,1245504,145
+11589021,1245649,240
+6826170,1245889,103
+11556614,1245992,117
+4779527,1246109,178
+5294015,1246287,252
+2120192,1246539,119
+11052648,1246658,178
+61117,1246836,156
+3733256,1246992,177
+14736264,1247169,222
+11058490,1247391,177
+11019499,1247568,160
+12848709,1247728,158
+3967398,1247886,130
+10775745,1248016,159
+11057587,1248175,139
+7080406,1248314,147
+4724802,1248461,187
+4485272,1248648,227
+10272157,1248875,146
+7652897,1249021,210
+13906333,1249231,128
+11561142,1249359,188
+10249721,1249547,157
+4748804,1249704,60
+2904906,1249764,199
+10795951,1249963,136
+16027850,1250099,130
+14961772,1250229,197
+11032398,1250426,252
+12076004,1250678,127
+2630214,1250805,177
+4766071,1250982,122
+7369139,1251104,138
+6612517,1251242,163
+1095443,1251405,60
+1052286,1251465,137
+2132358,1251602,178
+4506991,1251780,265
+12097783,1252045,235
+8684342,1252280,157
+1581074,1252437,151
+12068460,1252588,141
+3944460,1252729,154
+10026960,1252883,202
+11040226,1253085,151
+12090057,1253236,131
+15753520,1253367,161
+7093331,1253528,136
+540711,1253664,135
+3718959,1253799,141
+4506793,1253940,166
+12878414,1254106,172
+10778464,1254278,131
+13129315,1254409,143
+8978134,1254552,226
+8155876,1254778,137
+8134728,1254915,129
+9222135,1255044,230
+3716941,1255274,125
+1575956,1255399,138
+10267108,1255537,178
+9499575,1255715,258
+12904751,1255973,127
+11046267,1256100,177
+3995464,1256277,232
+11565320,1256509,149
+14972707,1256658,178
+1860535,1256836,151
+11817598,1256987,183
+9746868,1257170,155
+7083513,1257325,135
+1616453,1257460,137
+9445507,1257597,168
+1356070,1257765,160
+14176486,1257925,167
+14434040,1258092,131
+10788745,1258223,205
+7364830,1258428,148
+5254748,1258576,156
+16580215,1258732,158
+7361343,1258890,193
+4225664,1259083,131
+6570516,1259214,156
+829076,1259370,181
+1590370,1259551,164
+12596608,1259715,115
+13666901,1259830,122
+3428159,1259952,157
+1335424,1260109,178
+10271640,1260287,193
+5292657,1260480,159
+13398543,1260639,162
+7613282,1260801,160
+6569823,1260961,106
+9187129,1261067,141
+12624059,1261208,189
+2936169,1261397,112
+16015209,1261509,218
+2662891,1261727,301
+12122152,1262028,235
+3938903,1262263,140
+5512029,1262403,133
+10282941,1262536,147
+3687078,1262683,175
+2905404,1262858,135
+2392064,1262993,124
+1854393,1263117,143
+3432824,1263260,154
+1328868,1263414,132
+13669831,1263546,160
+13642821,1263706,158
+282507,1263864,136
+11839531,1264000,179
+2641298,1264179,117
+5569368,1264296,173
+9702357,1264469,161
+14733798,1264630,154
+14167451,1264784,288
+7379964,1265072,145
+11330606,1265217,157
+7929409,1265374,161
+2119457,1265535,166
+8926738,1265701,150
+537969,1265851,179
+9991862,1266030,114
+5258436,1266144,236
+2915204,1266380,151
+10797255,1266531,254
+3170578,1266785,123
+7905100,1266908,175
+1577038,1267083,118
+10228837,1267201,190
+5002700,1267391,136
+50651,1267527,186
+9238853,1267713,146
+16270075,1267859,138
+8942488,1267997,188
+2921004,1268185,185
+14221027,1268370,189
+5829511,1268559,113
+3970942,1268672,176
+10812301,1268848,182
+16043408,1269030,147
+8416395,1269177,154
+277912,1269331,201
+14696010,1269532,168
+269204,1269700,154
+10538696,1269854,163
+9468456,1270017,228
+1049034,1270245,137
+2386603,1270382,155
+16534460,1270537,169
+5284031,1270706,153
+12072664,1270859,141
+14446336,1271000,143
+5563312,1271143,151
+8407840,1271294,169
+2652564,1271463,238
+1079942,1271701,150
+4242846,1271851,141
+7100281,1271992,139
+12638836,1272131,206
+1627855,1272337,136
+16023865,1272473,135
+1586940,1272608,169
+10801300,1272777,168
+8921956,1272945,147
+5774525,1273092,139
+2641870,1273231,235
+298296,1273466,176
+2921572,1273642,163
+3171820,1273805,165
+5516522,1273970,124
+9746629,1274094,141
+14451291,1274235,145
+10265975,1274380,146
+12600065,1274526,111
+14711906,1274637,160
+15761164,1274797,165
+5005909,1274962,215
+534297,1275177,150
+5266118,1275327,183
+10254764,1275510,177
+5019156,1275687,137
+12084156,1275824,148
+9964846,1275972,156
+12851692,1276128,121
+6310428,1276249,131
+13919479,1276380,188
+7655467,1276568,167
+6299138,1276735,124
+14730931,1276859,118
+6583000,1276977,196
+6316063,1277173,181
+6063238,1277354,169
+5295410,1277523,234
+12368609,1277757,147
+1636975,1277904,152
+10492933,1278056,160
+6348814,1278216,150
+5526548,1278366,174
+2419557,1278540,140
+13693567,1278680,160
+15242486,1278840,252
+1606672,1279092,158
+16523932,1279250,161
+1585826,1279411,182
+13935769,1279593,162
+542764,1279755,170
+14429130,1279925,125
+9738402,1280050,168
+14740935,1280218,261
+11853077,1280479,155
+14425556,1280634,149
+16571733,1280783,193
+11540291,1280976,156
+13680172,1281132,155
+4215148,1281287,193
+12617819,1281480,160
+3996566,1281640,146
+8675875,1281786,212
+1899112,1281998,252
+532287,1282250,130
+1594336,1282380,186
+49487,1282566,129
+2893509,1282695,178
+1072902,1282873,155
+555417,1283028,119
+12587430,1283147,128
+12601856,1283275,252
+286631,1283527,228
+9750882,1283755,123
+14428692,1283878,183
+6850279,1284061,127
+12607087,1284188,157
+12630193,1284345,130
+16264923,1284475,135
+8424284,1284610,261
+14162382,1284871,150
+14732995,1285021,164
+3732887,1285185,131
+8420126,1285316,145
+11840300,1285461,178
+7616303,1285639,250
+15737245,1285889,227
+1578789,1286116,170
+8676006,1286286,139
+15004517,1286425,135
+14467291,1286560,233
+11296016,1286793,134
+16540270,1286927,153
+8702129,1287080,188
+15246180,1287268,196
+12341758,1287464,159
+8975504,1287623,135
+1872249,1287758,185
+10533560,1287943,133
+7660580,1288076,150
+2363856,1288226,251
+11821567,1288477,133
+10527024,1288610,169
+3154267,1288779,238
+3471936,1289017,210
+1858155,1289227,163
+11040214,1289390,210
+15526165,1289600,115
+8443699,1289715,152
+3161352,1289867,140
+11018159,1290007,144
+3199831,1290151,156
+12335526,1290307,179
+15512897,1290486,155
+13897935,1290641,217
+7123729,1290858,197
+1091395,1291055,147
+5537704,1291202,166
+5534950,1291368,137
+12873201,1291505,117
+3163209,1291622,117
+9764142,1291739,183
+14991686,1291922,170
+13893719,1292092,141
+6086902,1292233,237
+13122967,1292470,132
+848737,1292602,161
+6295415,1292763,135
+11548045,1292898,132
+16311547,1293030,155
+9194222,1293185,160
+3459485,1293345,223
+11331147,1293568,214
+7905159,1293782,157
+583130,1293939,197
+5801188,1294136,140
+281599,1294276,217
+15233421,1294493,206
+13661070,1294699,187
+6605124,1294886,155
+824315,1295041,120
+14962527,1295161,185
+15232340,1295346,181
+9482524,1295527,117
+23811,1295644,123
+8400862,1295767,141
+6043872,1295908,204
+569208,1296112,158
+13158289,1296270,132
+15522085,1296402,120
+1873042,1296522,132
+12093898,1296654,165
+6616334,1296819,170
+13651137,1296989,217
+5259094,1297206,172
+9236166,1297378,141
+1053256,1297519,148
+1591512,1297667,144
+15782887,1297811,130
+11539046,1297941,135
+8177872,1298076,189
+8972567,1298265,124
+8937818,1298389,145
+7397964,1298534,164
+64844,1298698,107
+1327897,1298805,208
+14200635,1299013,257
+6304496,1299270,143
+2632153,1299413,226
+1884950,1299639,191
+6821331,1299830,201
+1111003,1300031,142
+3169592,1300173,121
+6345401,1300294,201
+3210513,1300495,148
+12900902,1300643,143
+8177835,1300786,142
+6297897,1300928,298
+4764243,1301226,146
+7640125,1301372,122
+5820235,1301494,147
+6861882,1301641,172
+5011607,1301813,164
+4516005,1301977,176
+14200817,1302153,171
+2908809,1302324,164
+5827809,1302488,144
+4983220,1302632,178
+6345130,1302810,189
+7379877,1302999,245
+16012339,1303244,155
+11831568,1303399,160
+11585599,1303559,188
+3994514,1303747,142
+11829957,1303889,130
+9985563,1304019,172
+13929653,1304191,141
+9477600,1304332,161
+1351656,1304493,275
+12376384,1304768,133
+302178,1304901,144
+797289,1305045,174
+12867010,1305219,126
+59563,1305345,158
+11805066,1305503,128
+11838645,1305631,151
+14432210,1305782,295
+4223092,1306077,261
+2158594,1306338,163
+3705527,1306501,129
+12370490,1306630,155
+1897674,1306785,60
+11322092,1306845,142
+11036082,1306987,253
+15257850,1307240,160
+9971242,1307400,179
+3969396,1307579,195
+11333179,1307774,146
+1862602,1307920,157
+6562816,1308077,131
+15220475,1308208,148
+15520154,1308356,204
+3440951,1308560,133
+3715373,1308693,150
+5545349,1308843,138
+11564300,1308981,116
+11854315,1309097,60
+3946045,1309157,132
+8423064,1309289,168
+10281230,1309457,123
+10513673,1309580,167
+6353882,1309747,154
+16535696,1309901,139
+6338946,1310040,159
+11821624,1310199,124
+13155283,1310323,137
+9199695,1310460,141
+10795392,1310601,144
+10779668,1310745,130
+8396975,1310875,123
+2913551,1310998,233
+6049813,1311231,141
+9962116,1311372,146
+1889292,1311518,180
+11638,1311698,130
+16309068,1311828,157
+826710,1311985,150
+3979386,1312135,60
+11277409,1312195,158
+14993126,1312353,126
+5254429,1312479,132
+16027145,1312611,132
+5785792,1312743,128
+9197565,1312871,126
+5563967,1312997,229
+2161339,1313226,180
+1317457,1313406,173
+5799880,1313579,109
+2098437,1313688,187
+12596669,1313875,134
+2650500,1314009,157
+8171582,1314166,126
+3972993,1314292,260
+4480890,1314552,219
+4461337,1314771,155
+1619345,1314926,132
+12356437,1315058,184
+12601661,1315242,177
+13124932,1315419,185
+14741285,1315604,190
+5303700,1315794,129
+4760109,1315923,219
+13131776,1316142,167
+11275774,1316309,153
+16538406,1316462,131
+4256775,1316593,163
+11541649,1316756,162
+323965,1316918,145
+8669461,1317063,158
+2932375,1317221,184
+7382634,1317405,135
+14433873,1317540,138
+9439802,1317678,150
+2673948,1317828,120
+13910952,1317948,170
+12379551,1318118,233
+7356855,1318351,146
+14461135,1318497,146
+11028901,1318643,149
+10509931,1318792,147
+14186725,1318939,120
+14165181,1319059,141
+3446779,1319200,165
+15743573,1319365,137
+10009687,1319502,153
+14433326,1319655,168
+16266579,1319823,149
+15991884,1319972,145
+12871605,1320117,124
+4995344,1320241,187
+9452192,1320428,114
+11562175,1320542,158
+5558509,1320700,177
+8664593,1320877,195
+3424437,1321072,125
+13948744,1321197,141
+3428201,1321338,130
+16265534,1321468,130
+1324549,1321598,132
+13114110,1321730,119
+15492069,1321849,149
+9755465,1321998,105
+15753741,1322103,190
+2910203,1322293,273
+3990964,1322566,205
+577695,1322771,141
+6573040,1322912,132
+6614370,1323044,178
+2883628,1323222,108
+6080979,1323330,201
+13139132,1323531,169
+12063763,1323700,205
+11834446,1323905,148
+14682920,1324053,117
+4719146,1324170,230
+1632271,1324400,147
+13396977,1324547,152
+2922263,1324699,130
+2899768,1324829,141
+4215008,1324970,157
+7391899,1325127,141
+10516666,1325268,160
+6863884,1325428,141
+3431185,1325569,115
+7912144,1325684,177
+2418362,1325861,158
+13411188,1326019,255
+5793663,1326274,144
+809497,1326418,159
+11058458,1326577,178
+2393863,1326755,168
+12894623,1326923,265
+2096,1327188,141
+12906158,1327329,140
+16307113,1327469,149
+12351391,1327618,150
+4221611,1327768,112
+10265530,1327880,154
+9210478,1328034,174
+9994775,1328208,146
+10247309,1328354,260
+13901933,1328614,156
+8134226,1328770,125
+14464196,1328895,125
+11324169,1329020,152
+1599203,1329172,145
+7667104,1329317,171
+13416689,1329488,202
+10758583,1329690,173
+4780823,1329863,60
+13433072,1329923,285
+297100,1330208,163
+13916850,1330371,151
+3202694,1330522,160
+1623121,1330682,149
+7358018,1330831,183
+13900828,1331014,136
+5804557,1331150,155
+11272943,1331305,107
+12104750,1331412,252
+4472498,1331664,140
+13654467,1331804,184
+1584273,1331988,157
+16521108,1332145,172
+11799418,1332317,140
+2624696,1332457,178
+3983774,1332635,174
+2891498,1332809,128
+1871502,1332937,199
+2419865,1333136,164
+10767125,1333300,168
+4769890,1333468,179
+7913142,1333647,147
+4496565,1333794,129
+11861109,1333923,185
+11583385,1334108,134
+12069596,1334242,186
+4256076,1334428,119
+15242316,1334547,156
+9463795,1334703,133
+13955252,1334836,156
+6879381,1334992,139
+7387425,1335131,199
+10543765,1335330,144
+10491484,1335474,127
+10240380,1335601,240
+10250942,1335841,129
+10261326,1335970,137
+280165,1336107,178
+2892146,1336285,137
+9439511,1336422,179
+2919410,1336601,154
+14194491,1336755,171
+3679949,1336926,124
+8962005,1337050,143
+2411495,1337193,132
+11575562,1337325,159
+8400353,1337484,157
+16033066,1337641,152
+814671,1337793,154
+15251272,1337947,141
+12360124,1338088,171
+7880469,1338259,141
+1626225,1338400,175
+5825654,1338575,247
+4488853,1338822,141
+9986082,1338963,134
+12113053,1339097,174
+3958572,1339271,128
+14457630,1339399,156
+12345332,1339555,170
+15250606,1339725,233
+5307051,1339958,123
+3707387,1340081,137
+11067416,1340218,132
+7871997,1340350,153
+1617595,1340503,198
+11582881,1340701,167
+7385701,1340868,143
+13420075,1341011,159
+14205032,1341170,160
+6295961,1341330,149
+7111166,1341479,132
+12593081,1341611,307
+1340433,1341918,112
+16296414,1342030,137
+11046126,1342167,173
+14429030,1342340,160
+12093214,1342500,162
+13955111,1342662,132
+284106,1342794,234
+1324467,1343028,143
+11309871,1343171,132
+21679,1343303,178
+11324090,1343481,155
+819474,1343636,60
+10262008,1343696,157
+7870967,1343853,137
+6555980,1343990,202
+8158529,1344192,175
+4985984,1344367,159
+10782059,1344526,158
+2151851,1344684,154
+848878,1344838,147
+6607267,1344985,146
+16006813,1345131,142
+320248,1345273,159
+15507149,1345432,173
+9195781,1345605,232
+13115534,1345837,127
+6053547,1345964,137
+10256509,1346101,162
+2679447,1346263,204
+3454321,1346467,117
+3961911,1346584,112
+15503923,1346696,143
+7616649,1346839,164
+4510410,1347003,118
+3698209,1347121,202
+2650864,1347323,104
+1841630,1347427,130
+6332004,1347557,137
+12326310,1347694,210
+14474954,1347904,145
+10529533,1348049,173
+7121158,1348222,170
+7873085,1348392,129
+3932849,1348521,155
+14959078,1348676,148
+12349889,1348824,133
+14739688,1348957,170
+6312656,1349127,148
+11569553,1349275,125
+3150893,1349400,131
+5287795,1349531,300
+6068952,1349831,160
+10797281,1349991,163
+4995956,1350154,158
+6832978,1350312,132
+15526155,1350444,204
+10521755,1350648,155
+11024708,1350803,155
+7659630,1350958,132
+848052,1351090,240
+4775708,1351330,210
+13933710,1351540,138
+16314388,1351678,129
+2631334,1351807,161
+11806961,1351968,149
+12587586,1352117,159
+12329146,1352276,205
+1900199,1352481,155
+3165891,1352636,214
+11849691,1352850,247
+16569586,1353097,145
+6056573,1353242,200
+4479391,1353442,152
+3944250,1353594,122
+7654998,1353716,212
+11284392,1353928,150
+1074402,1354078,147
+13382871,1354225,135
+15739489,1354360,151
+13149962,1354511,134
+6347299,1354645,153
+4512971,1354798,191
+10542597,1354989,120
+530420,1355109,129
+13424657,1355238,192
+16005140,1355430,189
+9462028,1355619,158
+3956481,1355777,147
+15514542,1355924,200
+3449219,1356124,129
+9991108,1356253,160
+11796802,1356413,184
+7604924,1356597,192
+1089851,1356789,145
+16048450,1356934,139
+11305234,1357073,230
+6841177,1357303,166
+2623006,1357469,190
+6613222,1357659,169
+14733578,1357828,164
+12864324,1357992,134
+1610284,1358126,146
+10787603,1358272,137
+13168136,1358409,172
+7631602,1358581,176
+4769974,1358757,139
+3957368,1358896,267
+13161982,1359163,211
+2895976,1359374,156
+48423,1359530,118
+6045784,1359648,196
+5820559,1359844,152
+7118057,1359996,129
+13371848,1360125,128
+10241379,1360253,133
+13909351,1360386,147
+14722672,1360533,132
+5823373,1360665,138
+14960317,1360803,180
+9231757,1360983,171
+2138855,1361154,143
+16575929,1361297,132
+4517207,1361429,150
+15505601,1361579,228
+3713375,1361807,122
+16047322,1361929,235
+15205474,1362164,141
+14471415,1362305,147
+13936936,1362452,142
+14705296,1362594,218
+1052203,1362812,176
+7397689,1362988,120
+1589807,1363108,133
+12870484,1363241,126
+4218814,1363367,116
+6837493,1363483,129
+8172866,1363612,139
+9458758,1363751,143
+5523973,1363894,139
+10019173,1364033,122
+7886610,1364155,168
+3672586,1364323,271
+841366,1364594,113
+16047181,1364707,206
+4199385,1364913,114
+11292668,1365027,133
+11810625,1365160,133
+9733498,1365293,157
+4228062,1365450,150
+8951775,1365600,186
+2404180,1365786,159
+15792194,1365945,136
+14438110,1366081,181
+14714801,1366262,150
+4488319,1366412,163
+13932255,1366575,134
+6063690,1366709,135
+15773006,1366844,196
+9452890,1367040,241
+8168091,1367281,138
+10502209,1367419,137
+4210795,1367556,112
+7086763,1367668,165
+3152079,1367833,149
+588512,1367982,132
+5814753,1368114,164
+2152710,1368278,133
+16012693,1368411,188
+1849935,1368599,161
+10243616,1368760,141
+14185779,1368901,132
+9975224,1369033,162
+2656533,1369195,136
+5004749,1369331,186
+7394686,1369517,144
+11592605,1369661,163
+8138253,1369824,141
+1576055,1369965,186
+6867456,1370151,139
+14702750,1370290,134
+794050,1370424,162
+5535184,1370586,141
+6326711,1370727,273
+3166810,1371000,142
+2926464,1371142,157
+8154886,1371299,184
+6296195,1371483,237
+10018009,1371720,148
+12636067,1371868,178
+9708398,1372046,217
+1107630,1372263,159
+16572818,1372422,244
+4229786,1372666,143
+16008685,1372809,174
+6087302,1372983,146
+9200651,1373129,159
+9739349,1373288,161
+13924803,1373449,155
+7394791,1373604,141
+3995434,1373745,132
+5529513,1373877,143
+7090910,1374020,182
+1353260,1374202,146
+5537774,1374348,141
+11332202,1374489,154
+14728259,1374643,155
+2926645,1374798,116
+12852942,1374914,158
+11072624,1375072,268
+9204590,1375340,160
+12084369,1375500,172
+5304323,1375672,165
+14436809,1375837,138
+7395456,1375975,148
+10509761,1376123,134
+5782726,1376257,140
+11585709,1376397,140
+1578772,1376537,156
+15789113,1376693,114
+4484132,1376807,203
+2115321,1377010,180
+4747545,1377190,154
+327295,1377344,141
+10793454,1377485,141
+8659265,1377626,195
+10494747,1377821,148
+12100576,1377969,179
+3994924,1378148,134
+15484022,1378282,141
+7084049,1378423,139
+16312680,1378562,115
+11049308,1378677,112
+4199140,1378789,120
+5506037,1378909,173
+311387,1379082,122
+8403197,1379204,156
+11321014,1379360,199
+2920743,1379559,156
+11294779,1379715,144
+15263606,1379859,219
+6823896,1380078,149
+4194758,1380227,144
+10247795,1380371,141
+6034487,1380512,168
+10245556,1380680,144
+5006315,1380824,213
+7352215,1381037,125
+1100417,1381162,110
+4236964,1381272,136
+9746993,1381408,183
+12096722,1381591,153
+11594110,1381744,172
+15778380,1381916,235
+14972190,1382151,136
+10247062,1382287,159
+6353213,1382446,135
+5252395,1382581,157
+16285978,1382738,105
+3695606,1382843,193
+7911450,1383036,124
+13369472,1383160,138
+6572995,1383298,195
+9711203,1383493,119
+11305751,1383612,254
+11325824,1383866,167
+13421646,1384033,178
+6849856,1384211,132
+10525274,1384343,123
+6596663,1384466,159
+2108599,1384625,259
+6332317,1384884,123
+4731965,1385007,132
+13937407,1385139,129
+7660855,1385268,119
+9961,1385387,116
+9963,1385503,189
+9953,1385692,174
+10007,1385866,175
+10006,1386041,161
+9948,1386202,145
+9984,1386347,216
+9964,1386563,156
+9940,1386719,147
+9827,1386866,182
+9825,1387048,169
+9819,1387217,208
+9814,1387425,159
+9853,1387584,222
+9852,1387806,142
+9843,1387948,154
+9837,1388102,148
+9920,1388250,118
+9921,1388368,148
+9918,1388516,194
+9909,1388710,136
+9868,1388846,138
+9867,1388984,263
+9839,1389247,192
+9838,1389439,142
+9923,1389581,154
+9857,1389735,114
+9859,1389849,153
+9855,1390002,123
+9880,1390125,141
+9883,1390266,118
+9889,1390384,113
+9796,1390497,157
+9798,1390654,227
+9791,1390881,147
+9787,1391028,136
+9816,1391164,174
+9804,1391338,183
+9775,1391521,150
+9777,1391671,117
+9723,1391788,143
+9716,1391931,131
+9734,1392062,129
+9735,1392191,176
+9764,1392367,134
+9733,1392501,113
+9730,1392614,144
+9754,1392758,194
+9780,1392952,141
+9625,1393093,141
+9623,1393234,220
+9618,1393454,190
+9620,1393644,153
+9631,1393797,169
+9629,1393966,60
+9624,1394026,263
+9699,1394289,153
+9684,1394442,165
+9666,1394607,140
+9639,1394747,116
+9641,1394863,247
+9674,1395110,141
+9652,1395251,141
+9650,1395392,156
+9711,1395548,164
+9512,1395712,143
+9510,1395855,172
+9579,1396027,139
+9582,1396166,137
+9573,1396303,141
+9566,1396444,201
+9531,1396645,191
+9533,1396836,154
+9525,1396990,151
+9604,1397141,141
+9593,1397282,131
+9599,1397413,178
+9591,1397591,147
+9586,1397738,138
+9513,1397876,157
+9514,1398033,168
+9610,1398201,154
+9567,1398355,113
+9452,1398468,245
+9446,1398713,166
+9447,1398879,143
+9444,1399022,138
+9438,1399160,172
+9436,1399332,137
+9435,1399469,160
+9505,1399629,170
+9503,1399799,138
+9502,1399937,149
+9497,1400086,129
+9429,1400215,156
+9437,1400371,125
+9450,1400496,179
+9453,1400675,174
+9475,1400849,130
+9476,1400979,167
+9491,1401146,126
+9380,1401272,149
+9370,1401421,260
+9374,1401681,140
+9375,1401821,150
+9410,1401971,144
+9407,1402115,114
+9408,1402229,160
+9403,1402389,156
+9404,1402545,144
+9389,1402689,150
+9383,1402839,172
+9387,1403011,150
+9318,1403161,123
+9311,1403284,171
+9301,1403455,131
+9352,1403586,195
+9359,1403781,127
+9337,1403908,158
+9399,1404066,136
+9390,1404202,114
+9320,1404316,223
+9274,1404539,147
+9273,1404686,179
+9268,1404865,136
+9306,1405001,195
+9307,1405196,194
+9305,1405390,163
+9294,1405553,142
+9229,1405695,137
+9227,1405832,138
+9218,1405970,137
+9263,1406107,112
+9254,1406219,140
+9240,1406359,151
+9234,1406510,193
+9257,1406703,166
+9179,1406869,131
+9160,1407000,128
+9195,1407128,141
+9196,1407269,143
+9153,1407412,132
+9130,1407544,132
+9125,1407676,131
+9118,1407807,211
+9212,1408018,153
+9147,1408171,143
+9101,1408314,148
+9095,1408462,130
+9092,1408592,142
+9105,1408734,138
+9106,1408872,151
+9107,1409023,124
+9087,1409147,139
+9071,1409286,162
+9008,1409448,146
+9065,1409594,143
+8952,1409737,150
+8988,1409887,141
+8989,1410028,166
+8919,1410194,163
+8918,1410357,114
+8912,1410471,134
+8970,1410605,142
+8899,1410747,158
+8982,1410905,142
+8975,1411047,168
+9005,1411215,135
+8995,1411350,115
+8926,1411465,145
+8945,1411610,60
+8866,1411670,165
+8862,1411835,176
+8837,1412011,143
+8833,1412154,147
+8789,1412301,141
+8782,1412442,130
+8839,1412572,147
+8840,1412719,125
+8819,1412844,144
+8811,1412988,143
+8807,1413131,135
+8853,1413266,165
+8794,1413431,127
+8770,1413558,124
+8756,1413682,149
+8695,1413831,137
+8692,1413968,150
+8693,1414118,172
+8754,1414290,174
+8747,1414464,127
+8742,1414591,137
+8737,1414728,143
+8733,1414871,175
+8740,1415046,162
+8773,1415208,140
+8777,1415348,134
+8768,1415482,164
+8719,1415646,182
+8714,1415828,140
+8707,1415968,159
+8708,1416127,124
+8703,1416251,136
+8676,1416387,138
+8677,1416525,139
+8731,1416664,145
+8626,1416809,125
+8620,1416934,186
+8590,1417120,159
+8591,1417279,215
+8574,1417494,166
+8583,1417660,136
+8577,1417796,192
+8642,1417988,151
+8674,1418139,194
+8669,1418333,146
+8661,1418479,131
+8610,1418610,135
+8649,1418745,181
+8522,1418926,146
+8518,1419072,137
+8558,1419209,250
+8557,1419459,133
+8549,1419592,138
+8479,1419730,160
+8484,1419890,128
+8499,1420018,151
+8500,1420169,148
+8506,1420317,153
+8494,1420470,149
+8496,1420619,146
+8539,1420765,124
+8526,1420889,184
+8514,1421073,172
+8186,1421245,143
+8181,1421388,163
+8178,1421551,157
+8449,1421708,179
+8451,1421887,151
+8184,1422038,256
+8144,1422294,145
+8145,1422439,121
+8137,1422560,141
+8156,1422701,135
+8150,1422836,141
+8471,1422977,141
+8463,1423118,127
+8177,1423245,139
+8166,1423384,161
+8143,1423545,163
+8092,1423708,115
+8080,1423823,155
+8081,1423978,160
+8088,1424138,136
+8083,1424274,150
+8017,1424424,145
+8019,1424569,149
+8016,1424718,122
+8012,1424840,152
+8105,1424992,140
+8099,1425132,188
+8098,1425320,177
+8048,1425497,163
+8036,1425660,183
+8045,1425843,141
+7972,1425984,166
+7969,1426150,233
+7970,1426383,152
+7965,1426535,181
+7957,1426716,135
+7979,1426851,138
+7978,1426989,144
+7984,1427133,109
+8008,1427242,132
+7998,1427374,146
+7920,1427520,134
+7922,1427654,138
+7991,1427792,134
+7980,1427926,142
+7985,1428068,123
+7954,1428191,137
+7914,1428328,143
+7940,1428471,128
+7828,1428599,179
+7823,1428778,116
+7845,1428894,164
+7847,1429058,155
+7840,1429213,110
+7832,1429323,168
+7834,1429491,142
+7903,1429633,179
+7907,1429812,212
+7897,1430024,183
+7891,1430207,186
+7846,1430393,190
+7811,1430583,194
+7804,1430777,155
+7887,1430932,158
+7714,1431090,148
+7706,1431238,183
+7705,1431421,100
+7700,1431521,141
+7748,1431662,133
+7778,1431795,121
+7772,1431916,151
+7773,1432067,119
+7800,1432186,167
+7802,1432353,141
+7719,1432494,193
+7776,1432687,165
+7788,1432852,127
+7727,1432979,135
+7734,1433114,105
+7591,1433219,152
+7589,1433371,132
+7592,1433503,184
+7593,1433687,179
+7627,1433866,143
+7626,1434009,156
+7618,1434165,130
+7694,1434295,191
+7695,1434486,150
+7651,1434636,118
+7646,1434754,239
+7653,1434993,141
+7660,1435134,112
+7656,1435246,187
+7642,1435433,161
+7600,1435594,247
+7608,1435841,137
+7669,1435978,140
+7664,1436118,147
+7678,1436265,122
+7506,1436387,138
+7498,1436525,150
+7574,1436675,130
+7567,1436805,141
+7564,1436946,154
+7524,1437100,175
+7518,1437275,143
+7509,1437418,135
+7585,1437553,141
+7537,1437694,141
+7525,1437835,177
+7504,1438012,146
+7493,1438158,141
+7529,1438299,160
+7416,1438459,165
+7415,1438624,135
+7414,1438759,141
+7413,1438900,212
+7406,1439112,155
+7431,1439267,222
+7430,1439489,139
+7425,1439628,147
+7475,1439775,159
+7468,1439934,184
+7375,1440118,151
+7460,1440269,162
+7448,1440431,144
+7451,1440575,174
+7447,1440749,156
+7463,1440905,138
+7395,1441043,144
+7390,1441187,177
+7478,1441364,213
+7296,1441577,223
+7299,1441800,150
+7286,1441950,150
+7282,1442100,170
+7341,1442270,199
+7335,1442469,168
+7339,1442637,164
+7326,1442801,146
+7368,1442947,214
+7366,1443161,139
+7358,1443300,163
+7316,1443463,140
+7308,1443603,182
+7370,1443785,223
+7369,1444008,194
+7315,1444202,123
+7301,1444325,136
+7271,1444461,172
+7264,1444633,167
+7274,1444800,140
+7178,1444940,188
+7181,1445128,145
+7171,1445273,142
+7238,1445415,135
+7234,1445550,130
+7230,1445680,135
+7249,1445815,141
+7252,1445956,147
+7257,1446103,125
+7202,1446228,160
+7197,1446388,201
+7225,1446589,151
+7223,1446740,124
+7219,1446864,115
+7158,1446979,200
+7160,1447179,134
+7215,1447313,139
+7207,1447452,164
+7183,1447616,141
+7240,1447757,127
+7085,1447884,153
+7079,1448037,139
+7077,1448176,169
+7153,1448345,227
+7151,1448572,195
+7147,1448767,154
+7074,1448921,173
+7069,1449094,165
+7113,1449259,169
+7107,1449428,136
+7118,1449564,149
+7096,1449713,171
+7090,1449884,173
+7143,1450057,180
+7139,1450237,157
+7132,1450394,156
+7125,1450550,141
+7061,1450691,143
+7056,1450834,141
+7039,1450975,181
+7038,1451156,128
+7034,1451284,163
+6964,1451447,161
+6970,1451608,147
+6958,1451755,147
+7007,1451902,143
+7009,1452045,150
+7006,1452195,126
+7004,1452321,185
+7026,1452506,123
+7028,1452629,140
+7021,1452769,135
+7023,1452904,119
+6987,1453023,173
+6957,1453196,152
+7047,1453348,182
+6989,1453530,166
+6883,1453696,141
+6879,1453837,158
+6881,1453995,137
+6888,1454132,193
+6889,1454325,163
+6885,1454488,150
+6884,1454638,176
+6904,1454814,148
+6901,1454962,184
+6893,1455146,131
+6894,1455277,148
+6862,1455425,172
+6860,1455597,192
+6866,1455789,173
+6941,1455962,183
+6938,1456145,150
+6930,1456295,137
+6910,1456432,134
+6897,1456566,138
+6925,1456704,141
+6922,1456845,191
+6833,1457036,227
+6839,1457263,132
+6834,1457395,157
+6807,1457552,160
+6800,1457712,258
+6804,1457970,139
+6790,1458109,158
+6855,1458267,134
+6848,1458401,182
+6814,1458583,170
+6808,1458753,194
+6770,1458947,150
+6760,1459097,158
+6850,1459255,127
+6821,1459382,141
+6818,1459523,141
+6812,1459664,160
+6782,1459824,177
+6746,1460001,224
+6751,1460225,130
+6709,1460355,129
+6711,1460484,139
+6712,1460623,137
+6699,1460760,183
+6696,1460943,178
+6700,1461121,152
+6695,1461273,123
+6689,1461396,160
+6655,1461556,123
+6650,1461679,192
+6749,1461871,135
+6733,1462006,145
+6728,1462151,154
+6667,1462305,147
+6662,1462452,143
+6702,1462595,144
+6706,1462739,141
+6656,1462880,119
+6573,1462999,117
+6562,1463116,146
+6565,1463262,166
+6547,1463428,228
+6641,1463656,235
+6636,1463891,156
+6604,1464047,119
+6600,1464166,139
+6596,1464305,148
+6588,1464453,148
+6555,1464601,184
+6544,1464785,153
+6543,1464938,130
+6616,1465068,141
+6613,1465209,135
+6563,1465344,184
+6634,1465528,175
+6510,1465703,154
+6501,1465857,192
+6502,1466049,183
+6523,1466232,143
+6515,1466375,124
+6517,1466499,204
+6464,1466703,135
+6460,1466838,174
+6492,1467012,140
+6495,1467152,160
+6472,1467312,148
+6467,1467460,131
+6446,1467591,151
+6443,1467742,142
+6430,1467884,151
+6529,1468035,120
+6469,1468155,138
+6431,1468293,189
+6432,1468482,147
+6438,1468629,170
+6441,1468799,213
+6385,1469012,148
+6386,1469160,201
+6380,1469361,174
+6381,1469535,177
+6411,1469712,170
+6403,1469882,144
+6400,1470026,169
+6402,1470195,153
+6442,1470348,145
+6415,1470493,142
+6417,1470635,283
+6368,1470918,136
+6423,1471054,127
+6424,1471181,151
+6347,1471332,174
+6350,1471506,167
+6292,1471673,137
+6296,1471810,193
+6290,1472003,144
+6289,1472147,234
+6317,1472381,163
+6316,1472544,217
+6315,1472761,201
+6309,1472962,167
+6264,1473129,141
+6250,1473270,189
+6251,1473459,167
+6254,1473626,129
+6310,1473755,153
+6299,1473908,139
+6322,1474047,119
+6323,1474166,153
+6333,1474319,221
+6247,1474540,131
+6245,1474671,201
+6263,1474872,116
+6281,1474988,162
+6137,1475150,128
+6132,1475278,161
+6135,1475439,153
+6125,1475592,155
+6211,1475747,138
+6188,1475885,169
+6173,1476054,150
+6175,1476204,183
+6171,1476387,158
+6149,1476545,225
+6157,1476770,182
+6228,1476952,142
+6215,1477094,143
+6198,1477237,142
+6092,1477379,122
+6084,1477501,171
+6046,1477672,122
+6055,1477794,174
+6047,1477968,122
+6068,1478090,170
+6060,1478260,152
+6061,1478412,148
+6109,1478560,157
+6105,1478717,136
+6108,1478853,147
+6079,1479000,168
+6077,1479168,148
+6049,1479316,146
+6034,1479462,176
+6039,1479638,147
+6028,1479785,159
+6091,1479944,137
+6099,1480081,154
+6024,1480235,156
+5948,1480391,160
+5942,1480551,124
+5943,1480675,163
+5939,1480838,139
+5976,1480977,143
+5967,1481120,141
+5962,1481261,118
+5966,1481379,151
+5999,1481530,247
+6001,1481777,140
+5979,1481917,165
+5929,1482082,140
+5927,1482222,164
+5930,1482386,219
+5925,1482605,141
+5988,1482746,140
+5982,1482886,109
+5990,1482995,155
+5840,1483150,151
+5827,1483301,129
+5872,1483430,108
+5880,1483538,164
+5864,1483702,142
+5891,1483844,157
+5884,1484001,134
+5865,1484135,133
+5852,1484268,112
+5908,1484380,153
+5915,1484533,158
+5897,1484691,144
+5825,1484835,124
+5801,1484959,140
+5808,1485099,157
+5809,1485256,127
+5806,1485383,113
+5804,1485496,148
+5763,1485644,176
+5764,1485820,158
+5767,1485978,131
+5759,1486109,136
+5708,1486245,148
+5705,1486393,130
+5703,1486523,141
+5733,1486664,144
+5727,1486808,153
+5756,1486961,147
+5747,1487108,144
+5780,1487252,166
+5788,1487418,141
+5719,1487559,135
+5772,1487694,119
+5659,1487813,163
+5656,1487976,156
+5662,1488132,126
+5663,1488258,166
+5652,1488424,142
+5646,1488566,154
+5699,1488720,152
+5700,1488872,163
+5694,1489035,129
+5629,1489164,154
+5622,1489318,183
+5684,1489501,149
+5676,1489650,118
+5637,1489768,159
+5625,1489927,141
+5603,1490068,175
+5600,1490243,115
+5619,1490358,124
+5607,1490482,139
+5587,1490621,185
+5549,1490806,147
+5548,1490953,139
+5545,1491092,147
+57512,1491239,125
+5492,1491364,152
+5514,1491516,177
+5518,1491693,144
+5513,1491837,172
+5556,1492009,155
+5578,1492164,144
+5528,1492308,118
+5394,1492426,181
+5386,1492607,143
+5488,1492750,150
+5486,1492900,164
+5480,1493064,141
+5451,1493205,194
+5448,1493399,152
+5471,1493551,140
+5466,1493691,193
+5405,1493884,210
+5436,1494094,175
+5434,1494269,182
+5426,1494451,162
+5275,1494613,161
+5281,1494774,185
+5278,1494959,160
+5282,1495119,186
+5293,1495305,177
+5295,1495482,141
+5289,1495623,141
+5375,1495764,156
+5370,1495920,140
+5371,1496060,153
+5330,1496213,174
+5340,1496387,196
+5325,1496583,155
+5312,1496738,175
+5313,1496913,162
+5316,1497075,180
+5356,1497255,152
+5355,1497407,157
+5291,1497564,208
+5296,1497772,149
+5364,1497921,156
+5365,1498077,151
+5262,1498228,133
+5263,1498361,160
+5260,1498521,165
+5255,1498686,163
+5188,1498849,140
+5175,1498989,148
+5169,1499137,140
+5197,1499277,145
+5194,1499422,164
+5189,1499586,163
+5224,1499749,159
+5244,1499908,129
+5249,1500037,123
+5220,1500160,125
+5214,1500285,142
+5208,1500427,130
+5153,1500557,187
+5152,1500744,168
+5144,1500912,127
+5147,1501039,141
+5104,1501180,146
+5103,1501326,199
+5099,1501525,147
+5100,1501672,176
+5163,1501848,162
+5164,1502010,165
+5156,1502175,153
+5072,1502328,130
+5074,1502458,151
+5073,1502609,128
+5135,1502737,227
+5127,1502964,176
+5126,1503140,123
+5130,1503263,150
+5114,1503413,151
+5115,1503564,151
+5084,1503715,126
+5050,1503841,140
+5048,1503981,181
+5046,1504162,139
+4989,1504301,133
+4995,1504434,236
+4999,1504670,142
+4979,1504812,221
+4966,1505033,155
+4955,1505188,145
+4975,1505333,141
+4968,1505474,127
+5044,1505601,119
+5038,1505720,158
+5015,1505878,147
+5059,1506025,141
+5053,1506166,129
+5009,1506295,140
+4899,1506435,145
+4884,1506580,150
+4886,1506730,186
+4882,1506916,147
+4918,1507063,213
+4958,1507276,121
+4942,1507397,171
+4932,1507568,156
+4936,1507724,201
+4847,1507925,137
+4841,1508062,140
+4864,1508202,156
+4898,1508358,156
+4821,1508514,145
+4824,1508659,194
+4762,1508853,147
+4749,1509000,145
+4827,1509145,186
+4822,1509331,174
+4826,1509505,141
+4819,1509646,144
+4770,1509790,111
+4773,1509901,163
+4776,1510064,127
+4766,1510191,208
+4794,1510399,140
+4786,1510539,125
+4782,1510664,161
+4783,1510825,148
+4838,1510973,166
+4662,1511139,140
+4661,1511279,140
+4677,1511419,162
+4674,1511581,134
+4673,1511715,174
+4667,1511889,126
+4743,1512015,206
+4738,1512221,119
+4741,1512340,156
+4727,1512496,178
+4717,1512674,173
+4711,1512847,155
+4709,1513002,157
+4695,1513159,228
+4689,1513387,110
+4750,1513497,121
+4754,1513618,141
+4595,1513759,145
+4585,1513904,153
+4588,1514057,141
+4583,1514198,181
+4610,1514379,201
+4606,1514580,172
+4605,1514752,128
+4602,1514880,144
+4558,1515024,145
+4560,1515169,129
+4547,1515298,190
+4546,1515488,189
+4648,1515677,115
+4639,1515792,135
+4640,1515927,128
+4649,1516055,185
+4646,1516240,161
+4642,1516401,142
+4584,1516543,114
+4576,1516657,158
+4621,1516815,210
+4622,1517025,129
+4594,1517154,189
+4624,1517343,130
+4516,1517473,180
+4504,1517653,175
+4503,1517828,182
+4505,1518010,135
+4519,1518145,158
+4521,1518303,152
+4515,1518455,175
+4470,1518630,171
+4471,1518801,153
+4464,1518954,125
+4459,1519079,209
+4457,1519288,133
+4450,1519421,156
+4481,1519577,164
+4500,1519741,180
+4543,1519921,133
+4535,1520054,126
+4537,1520180,150
+4361,1520330,158
+4356,1520488,123
+4449,1520611,132
+4438,1520743,148
+4441,1520891,148
+4444,1521039,141
+4445,1521180,141
+4390,1521321,131
+4398,1521452,123
+4386,1521575,169
+4375,1521744,103
+4374,1521847,148
+4368,1521995,170
+4411,1522165,174
+4413,1522339,181
+4404,1522520,124
+4405,1522644,129
+4385,1522773,141
+4425,1522914,124
+4032,1523038,113
+4026,1523151,119
+4024,1523270,145
+4023,1523415,116
+4051,1523531,121
+4049,1523652,202
+4033,1523854,136
+4352,1523990,141
+4090,1524131,144
+4093,1524275,155
+4089,1524430,142
+4036,1524572,137
+4041,1524709,125
+4038,1524834,139
+4030,1524973,141
+4009,1525114,126
+4000,1525240,179
+3994,1525419,137
+4074,1525556,181
+4087,1525737,141
+4056,1525878,128
+3981,1526006,147
+3973,1526153,183
+3970,1526336,150
+3913,1526486,159
+3915,1526645,140
+3908,1526785,129
+3914,1526914,159
+3969,1527073,135
+3967,1527208,159
+3989,1527367,180
+3925,1527547,190
+3926,1527737,147
+3936,1527884,151
+3931,1528035,174
+3978,1528209,147
+3984,1528356,141
+3959,1528497,133
+3963,1528630,153
+3944,1528783,181
+3810,1528964,143
+3811,1529107,158
+3813,1529265,171
+3802,1529436,170
+3791,1529606,188
+3819,1529794,205
+3820,1529999,115
+3823,1530114,60
+3825,1530174,134
+3815,1530308,216
+3868,1530524,168
+3866,1530692,140
+3850,1530832,144
+3842,1530976,165
+3887,1531141,177
+3885,1531318,219
+3831,1531537,148
+3824,1531685,134
+3817,1531819,157
+3904,1531976,160
+3891,1532136,146
+3845,1532282,137
+3785,1532419,165
+3773,1532584,155
+3769,1532739,186
+3762,1532925,155
+3792,1533080,159
+3779,1533239,147
+3780,1533386,138
+3777,1533524,146
+3714,1533670,143
+3721,1533813,125
+3705,1533938,150
+3745,1534088,151
+3736,1534239,144
+3737,1534383,158
+3733,1534541,199
+3735,1534740,181
+3751,1534921,135
+3695,1535056,164
+3765,1535220,172
+3664,1535392,157
+3659,1535549,144
+3627,1535693,134
+3624,1535827,159
+3620,1535986,150
+3647,1536136,144
+3653,1536280,191
+3613,1536471,169
+3602,1536640,159
+3663,1536799,125
+3640,1536924,141
+3638,1537065,150
+3607,1537215,60
+3605,1537275,131
+3585,1537406,158
+3531,1537564,177
+3532,1537741,154
+3534,1537895,144
+3560,1538039,157
+3561,1538196,123
+3558,1538319,190
+3523,1538509,158
+3513,1538667,131
+3511,1538798,163
+3500,1538961,149
+3551,1539110,157
+3547,1539267,158
+3588,1539425,142
+3370,1539567,112
+3369,1539679,141
+3366,1539820,186
+3398,1540006,148
+3393,1540154,166
+3394,1540320,151
+3388,1540471,148
+3413,1540619,175
+3415,1540794,190
+3416,1540984,60
+3409,1541044,139
+3385,1541183,141
+3381,1541324,153
+3477,1541477,149
+3473,1541626,160
+3426,1541786,159
+3429,1541945,141
+3397,1542086,184
+3489,1542270,163
+3456,1542433,146
+3347,1542579,163
+3353,1542742,145
+3356,1542887,148
+3309,1543035,142
+3312,1543177,121
+3316,1543298,170
+3315,1543468,131
+3279,1543599,141
+3288,1543740,155
+3270,1543895,143
+3329,1544038,165
+3328,1544203,145
+3321,1544348,123
+3268,1544471,119
+3258,1544590,125
+3281,1544715,180
+3278,1544895,141
+3296,1545036,148
+3298,1545184,130
+3340,1545314,150
+3350,1545464,136
+3359,1545600,130
+3245,1545730,139
+3242,1545869,175
+3244,1546044,163
+3246,1546207,126
+3235,1546333,155
+3228,1546488,194
+3223,1546682,169
+3215,1546851,124
+3218,1546975,126
+3219,1547101,140
+3199,1547241,144
+3201,1547385,167
+3230,1547552,144
+3221,1547696,138
+3190,1547834,184
+3200,1548018,137
+3197,1548155,159
+3255,1548314,180
+3176,1548494,126
+3079,1548620,123
+3084,1548743,159
+3086,1548902,141
+3090,1549043,173
+3088,1549216,137
+3136,1549353,143
+3134,1549496,127
+3130,1549623,127
+3125,1549750,170
+3158,1549920,170
+3159,1550090,190
+3107,1550280,187
+3109,1550467,145
+3096,1550612,137
+3082,1550749,252
+3083,1551001,157
+3146,1551158,174
+3156,1551332,149
+3127,1551481,137
+3048,1551618,118
+3036,1551736,133
+3032,1551869,155
+3031,1552024,166
+3037,1552190,154
+3045,1552344,156
+3049,1552500,139
+3043,1552639,170
+3027,1552809,108
+3029,1552917,152
+3025,1553069,134
+3026,1553203,159
+3015,1553362,142
+3000,1553504,157
+3008,1553661,174
+2992,1553835,139
+2996,1553974,166
+3020,1554140,112
+2988,1554252,129
+3065,1554381,165
+3068,1554546,141
+3050,1554687,140
+2975,1554827,121
+2968,1554948,152
+2965,1555100,163
+2974,1555263,164
+2952,1555427,129
+2900,1555556,148
+2956,1555704,120
+2954,1555824,127
+2960,1555951,153
+2937,1556104,123
+2891,1556227,134
+2870,1556361,161
+2869,1556522,162
+2933,1556684,129
+2928,1556813,149
+2927,1556962,178
+2883,1557140,143
+2885,1557283,141
+2892,1557424,137
+2915,1557561,141
+2920,1557702,172
+2904,1557874,144
+2901,1558018,125
+2951,1558143,145
+2829,1558288,149
+2827,1558437,146
+2824,1558583,142
+2855,1558725,142
+2849,1558867,177
+2778,1559044,158
+2761,1559202,131
+2853,1559333,131
+2842,1559464,155
+2840,1559619,60
+2837,1559679,141
+2810,1559820,172
+2812,1559992,163
+2796,1560155,166
+2791,1560321,127
+2792,1560448,198
+2781,1560646,137
+2785,1560783,125
+2783,1560908,141
+2879,1561049,151
+2876,1561200,166
+2801,1561366,149
+2803,1561515,141
+2701,1561656,144
+2719,1561800,157
+2703,1561957,143
+2720,1562100,154
+2702,1562254,151
+2753,1562405,139
+2750,1562544,176
+2755,1562720,151
+2756,1562871,158
+2752,1563029,184
+2734,1563213,162
+2739,1563375,136
+2746,1563511,163
+2742,1563674,136
+2735,1563810,135
+2678,1563945,206
+2738,1564151,152
+2730,1564303,157
+2713,1564460,181
+2707,1564641,150
+2697,1564791,162
+2688,1564953,138
+2681,1565091,144
+2652,1565235,135
+2650,1565370,193
+2646,1565563,163
+2641,1565726,180
+2604,1565906,168
+2602,1566074,130
+2595,1566204,139
+2591,1566343,185
+2570,1566528,142
+2565,1566670,124
+2612,1566794,174
+2608,1566968,152
+2607,1567120,140
+2581,1567260,150
+2587,1567410,129
+2586,1567539,144
+2656,1567683,171
+2653,1567854,172
+2617,1568026,181
+2615,1568207,148
+2643,1568355,163
+2634,1568518,138
+2518,1568656,121
+2503,1568777,135
+2505,1568912,160
+2516,1569072,134
+2507,1569206,138
+2545,1569344,164
+2548,1569508,153
+2549,1569661,191
+2538,1569852,118
+2501,1569970,174
+2509,1570144,153
+2496,1570297,133
+2495,1570430,163
+2531,1570593,159
+2484,1570752,169
+2478,1570921,159
+2490,1571080,158
+2564,1571238,129
+2417,1571367,150
+2420,1571517,162
+2443,1571679,165
+2430,1571844,173
+2410,1572017,166
+2394,1572183,154
+2382,1572337,185
+2375,1572522,141
+2385,1572663,148
+2365,1572811,131
+2407,1572942,133
+2454,1573075,105
+2316,1573180,146
+2317,1573326,168
+2302,1573494,136
+2303,1573630,158
+2308,1573788,148
+2335,1573936,134
+2340,1574070,143
+2337,1574213,127
+2329,1574340,131
+2328,1574471,141
+2351,1574612,160
+2287,1574772,124
+2288,1574896,158
+2281,1575054,125
+2320,1575179,148
+2324,1575327,127
+2279,1575454,151
+2263,1575605,141
+2300,1575746,138
+2360,1575884,141
+2239,1576025,124
+2232,1576149,123
+2235,1576272,128
+2238,1576400,152
+2241,1576552,170
+2246,1576722,153
+2149,1576875,164
+2148,1577039,126
+2144,1577165,169
+2199,1577334,137
+2192,1577471,140
+2189,1577611,140
+2216,1577751,138
+2212,1577889,141
+524395,1578030,149
+2180,1578179,109
+2024,1578288,125
+2027,1578413,141
+2028,1578554,141
+2129,1578695,154
+2137,1578849,175
+2126,1579024,132
+2073,1579156,105
+2074,1579261,204
+2064,1579465,141
+2055,1579606,143
+2044,1579749,140
+2085,1579889,120
+2012,1580009,133
+2079,1580142,158
+1990,1580300,122
+2037,1580422,109
+1940,1580531,152
+1943,1580683,134
+1932,1580817,154
+1996,1580971,119
+1984,1581090,137
+1150,1581227,112
+1980,1581339,123
+1961,1581462,123
+1953,1581585,151
+1950,1581736,144
+1952,1581880,127
+1928,1582007,133
+1921,1582140,125
+1899,1582265,106
+1896,1582371,115
+1887,1582486,156
+1976,1582642,153
+1915,1582795,159
+1897,1582954,123
+1818,1583077,154
+1822,1583231,167
+1815,1583398,132
+1809,1583530,119
+1794,1583649,140
+1797,1583789,151
+1791,1583940,151
+1857,1584091,148
+1861,1584239,175
+1854,1584414,212
+1843,1584626,129
+1835,1584755,162
+1816,1584917,160
+1814,1585077,141
+1884,1585218,148
+1878,1585366,134
+1882,1585500,174
+1864,1585674,139
+1862,1585813,124
+1851,1585937,126
+1841,1586063,136
+1802,1586199,154
+1801,1586353,125
+1771,1586478,130
+1747,1586608,156
+1607,1586764,112
+1700,1586876,126
+1750,1587002,141
+1739,1587143,120
+1741,1587263,135
+1685,1587398,153
+1681,1587551,120
+1682,1587671,142
+1675,1587813,166
+1672,1587979,161
+1707,1588140,141
+1708,1588281,127
+1684,1588408,146
+1735,1588554,168
+1721,1588722,127
+1715,1588849,154
+1763,1589003,155
+1764,1589158,157
+1697,1589315,158
+1753,1589473,113
+1635,1589586,159
+1637,1589745,147
+1641,1589892,161
+1646,1590053,142
+1563,1590195,186
+1551,1590381,136
+1552,1590517,143
+1553,1590660,141
+1516,1590801,140
+1634,1590941,120
+1626,1591061,140
+1618,1591201,141
+1622,1591342,106
+1601,1591448,118
+1608,1591566,139
+1612,1591705,150
+1652,1591855,145
+1592,1592000,155
+1589,1592155,155
+1562,1592310,131
+1567,1592441,127
+1671,1592568,163
+1538,1592731,161
+1472,1592892,181
+1464,1593073,174
+1466,1593247,150
+1471,1593397,157
+1493,1593554,151
+1477,1593705,98
+1482,1593803,147
+1490,1593950,128
+1457,1594078,116
+1433,1594194,183
+1434,1594377,141
+1451,1594518,139
+1426,1594657,122
+1419,1594779,124
+1452,1594903,154
+1453,1595057,162
+1489,1595219,139
+1531,1595358,135
+1534,1595493,115
+1520,1595608,99
+1328,1595707,144
+1336,1595851,123
+1323,1595974,128
+1309,1596102,127
+1301,1596229,156
+1302,1596385,153
+1399,1596538,154
+1392,1596692,104
+1390,1596796,170
+1389,1596966,135
+1409,1597101,117
+1405,1597218,145
+1414,1597363,145
+1403,1597508,172
+1393,1597680,148
+1353,1597828,165
+1356,1597993,142
+1347,1598135,122
+1372,1598257,131
+1296,1598388,187
+1279,1598575,124
+1281,1598699,141
+1288,1598840,136
+1307,1598976,171
+1299,1599147,173
+1294,1599320,129
+1239,1599449,153
+1236,1599602,153
+1243,1599755,156
+1248,1599911,136
+1245,1600047,141
+32902,1600188,157
+1284,1600345,196
+1289,1600541,124
+1275,1600665,136
+1216,1600801,141
+1210,1600942,147
+1206,1601089,140
+1229,1601229,155
+1257,1601384,153
+1256,1601537,126
+1203,1601663,131
+1100,1601794,112
+1092,1601906,164
+1081,1602070,175
+1082,1602245,177
+1170,1602422,184
+1164,1602606,138
+1169,1602744,139
+1171,1602883,161
+1172,1603044,122
+1161,1603166,140
+1162,1603306,132
+1153,1603438,169
+1132,1603607,168
+1137,1603775,103
+1134,1603878,141
+1140,1604019,104
+1069,1604123,151
+1070,1604274,142
+1061,1604416,155
+1087,1604571,164
+1075,1604735,115
+1076,1604850,145
+1143,1604995,148
+1139,1605143,140
+1136,1605283,107
+1117,1605390,130
+1113,1605520,140
+1188,1605660,133
+1046,1605793,152
+1039,1605945,186
+1034,1606131,131
+1028,1606262,184
+976,1606446,125
+975,1606571,146
+977,1606717,126
+941,1606843,132
+935,1606975,151
+942,1607126,192
+931,1607318,120
+950,1607438,147
+945,1607585,128
+947,1607713,159
+1003,1607872,118
+999,1607990,149
+995,1608139,141
+1012,1608280,124
+1010,1608404,132
+1008,1608536,146
+987,1608682,160
+978,1608842,150
+1029,1608992,143
+1025,1609135,147
+1051,1609282,146
+929,1609428,184
+918,1609612,137
+922,1609749,111
+867,1609860,139
+863,1609999,186
+864,1610185,170
+865,1610355,130
+916,1610485,108
+906,1610593,143
+909,1610736,174
+904,1610910,172
+857,1611082,120
+850,1611202,130
+844,1611332,178
+888,1611510,121
+884,1611631,146
+886,1611777,151
+894,1611928,176
+877,1612104,129
+878,1612233,139
+881,1612372,152
+841,1612524,142
+830,1612666,173
+828,1612839,132
+805,1612971,127
+799,1613098,114
+671,1613212,170
+795,1613382,151
+796,1613533,147
+424,1613680,170
+780,1613850,152
+776,1614002,151
+775,1614153,138
+774,1614291,162
+764,1614453,141
+762,1614594,129
+763,1614723,155
+758,1614878,138
+547,1615016,123
+715,1615139,144
+714,1615283,129
+810,1615412,163
+804,1615575,181
+703,1615756,140
+791,1615896,145
+792,1616041,143
+739,1616184,162
+733,1616346,157
+583,1616503,206
+579,1616709,158
+561,1616867,133
+614,1617000,153
+616,1617153,166
+606,1617319,145
+608,1617464,158
+643,1617622,142
+644,1617764,179
+640,1617943,126
+36964,1618069,139
+634,1618208,163
+628,1618371,149
+670,1618520,181
+667,1618701,135
+661,1618836,143
+626,1618979,181
+621,1619160,114
+619,1619274,154
+659,1619428,150
+649,1619578,136
+303,1619714,174
+679,1619888,135
+434,1620023,159
+440,1620182,131
+441,1620313,172
+435,1620485,173
+445,1620658,189
+521,1620847,200
+514,1621047,141
+513,1621188,121
+564,1621309,153
+566,1621462,105
+555,1621567,147
+548,1621714,115
+543,1621829,132
+538,1621961,132
+458,1622093,167
+465,1622260,151
+546,1622411,134
+531,1622545,98
+475,1622643,139
+479,1622782,151
+495,1622933,161
+522,1623094,104
+518,1623198,129
+377,1623327,147
+352,1623474,113
+334,1623587,155
+12403,1623742,159
+12351,1623901,141
+388,1624042,122
+405,1624164,140
+420,1624304,158
+398,1624462,132
+365,1624594,143
+367,1624737,132
+368,1624869,149
+362,1625018,107
+339,1625125,166
+309,1625291,113
+321,1625404,113
+357,1625517,145
+342,1625662,163
+439,1625825,134
+437,1625959,150
+387,1626109,132
+382,1626241,161
+268,1626402,141
+273,1626543,136
+263,1626679,116
+276,1626795,170
+45301,1626965,167
+45275,1627132,130
+45230,1627262,127
+45287,1627389,148
+45198,1627537,141
+12380,1627678,163
+12292,1627841,143
+12537,1627984,150
+280,1628134,138
+284,1628272,164
+296,1628436,137
+326,1628573,147
+329,1628720,113
+305,1628833,161
+12478,1628994,160
+12290,1629154,139
+12408,1629293,141
+45292,1629434,119
+45279,1629553,154
+267,1629707,140
+12444,1629847,149
+12414,1629996,174
+12367,1630170,187
+12322,1630357,189
+12400,1630546,149
+12536,1630695,169
+12471,1630864,148
+12467,1631012,164
+12297,1631176,145
+12410,1631321,173
+12385,1631494,125
+12372,1631619,160
+12299,1631779,149
+12431,1631928,137
+12368,1632065,145
+12480,1632210,150
+12293,1632360,159
+12512,1632519,154
+12388,1632673,161
+12507,1632834,156
+12519,1632990,156
+12468,1633146,126
+12465,1633272,123
+12384,1633395,139
+12448,1633534,165
+12309,1633699,132
+12319,1633831,150
+12538,1633981,133
+12363,1634114,147
+12521,1634261,165
+12453,1634426,135
+12420,1634561,151
+12355,1634712,154
+12288,1634866,157
+12305,1635023,143
+12392,1635166,159
+12433,1635325,159
+12493,1635484,152
+12314,1635636,142
+12329,1635778,115
+12419,1635893,111
+12470,1636004,141
+12487,1636145,141
+12516,1636286,132
+12390,1636418,107
+12337,1636525,164
+53255,1636689,143
+53503,1636832,141
+53288,1636973,134
+53285,1637107,125
+53316,1637232,158
+12379,1637390,130
+53321,1637520,158
+53339,1637678,136
+53314,1637814,123
+53297,1637937,167
+53304,1638104,141
+53446,1638245,163
+53367,1638408,149
+53310,1638557,141
+53395,1638698,133
+53311,1638831,163
+53495,1638994,134
+53359,1639128,122
+53500,1639250,148
+53414,1639398,156
+53251,1639554,161
+53458,1639715,146
+53497,1639861,152
+53454,1640013,121
+53272,1640134,143
+423,1640277,155
+53388,1640432,145
+53337,1640577,156
+53501,1640733,151
+53417,1640884,147
+53469,1641031,146
+53478,1641177,130
+53457,1641307,132
+53383,1641439,132
+53376,1641571,138
+53393,1641709,159
+53326,1641868,108
+53287,1641976,155
+53362,1642131,126
+53474,1642257,142
+53354,1642399,163
+53385,1642562,145
+53292,1642707,151
+53453,1642858,150
+53312,1643008,132
+53274,1643140,128
+20735,1643268,176
+20690,1643444,154
+20729,1643598,155
+20552,1643753,137
+20558,1643890,141
+20726,1644031,171
+20588,1644202,152
+20695,1644354,109
+20548,1644463,145
+20710,1644608,132
+20540,1644740,143
+20576,1644883,142
+20718,1645025,157
+20549,1645182,155
+20523,1645337,131
+20526,1645468,141
+20590,1645609,175
+20524,1645784,146
+20599,1645930,143
+20531,1646073,143
+20494,1646216,156
+53452,1646372,148
+20716,1646520,102
+20681,1646622,127
+20667,1646749,137
+20578,1646886,152
+20693,1647038,146
+20723,1647184,171
+20670,1647355,140
+20591,1647495,115
+20728,1647610,166
+20546,1647776,173
+20672,1647949,127
+20561,1648076,169
+20605,1648245,107
+20631,1648352,174
+20496,1648526,160
+20634,1648686,158
+20514,1648844,151
+20487,1648995,194
+20544,1649189,187
+20508,1649376,149
+20626,1649525,174
+20602,1649699,134
+20585,1649833,148
+20584,1649981,169
+20668,1650150,150
+36977,1650300,155
+20715,1650455,139
+20719,1650594,138
+20632,1650732,131
+20559,1650863,143
+37119,1651006,156
+36926,1651162,151
+37050,1651313,138
+36888,1651451,182
+37069,1651633,234
+37115,1651867,125
+37012,1651992,167
+37043,1652159,130
+36924,1652289,148
+36957,1652437,144
+37073,1652581,155
+36934,1652736,131
+37082,1652867,133
+37088,1653000,127
+37072,1653127,151
+37019,1653278,123
+36898,1653401,117
+36886,1653518,109
+37031,1653627,141
+36947,1653768,166
+37084,1653934,142
+37090,1654076,167
+36997,1654243,160
+37063,1654403,122
+36917,1654525,138
+36879,1654663,157
+37098,1654820,149
+36983,1654969,157
+37017,1655126,171
+4269,1655297,148
+4263,1655445,155
+4309,1655600,148
+4181,1655748,173
+36986,1655921,132
+37104,1656053,176
+36896,1656229,151
+4259,1656380,135
+36956,1656515,113
+37091,1656628,148
+37033,1656776,135
+37107,1656911,154
+36943,1657065,159
+36960,1657224,134
+36883,1657358,145
+4178,1657503,159
+4203,1657662,140
+4291,1657802,134
+36949,1657936,207
+4317,1658143,158
+4141,1658301,160
+4147,1658461,163
+4114,1658624,161
+4117,1658785,114
+4216,1658899,164
+4175,1659063,147
+4218,1659210,136
+4281,1659346,131
+4189,1659477,136
+4241,1659613,135
+4123,1659748,160
+4316,1659908,181
+4106,1660089,161
+4146,1660250,142
+4224,1660392,152
+4340,1660544,163
+4215,1660707,156
+4275,1660863,166
+4126,1661029,202
+4173,1661231,147
+4177,1661378,149
+4151,1661527,170
+57531,1661697,135
+57482,1661832,141
+57478,1661973,185
+57371,1662158,155
+57433,1662313,160
+57541,1662473,150
+57582,1662623,111
+57486,1662734,119
+57407,1662853,143
+57556,1662996,145
+57471,1663141,140
+57363,1663281,156
+57597,1663437,171
+57533,1663608,157
+57454,1663765,137
+57453,1663902,144
+57578,1664046,161
+57444,1664207,141
+57545,1664348,164
+57400,1664512,152
+57500,1664664,115
+57577,1664779,143
+57356,1664922,125
+57354,1665047,122
+57540,1665169,153
+57449,1665322,121
+57508,1665443,129
+57566,1665572,111
+57509,1665683,168
+57365,1665851,141
+57576,1665992,159
+57366,1666151,154
+57349,1666305,129
+57537,1666434,154
+57513,1666588,157
+57476,1666745,145
+57494,1666890,156
+57367,1667046,124
+24703,1667170,151
+57385,1667321,145
+24692,1667466,120
+24694,1667586,210
+24737,1667796,138
+24615,1667934,163
+24764,1668097,200
+24741,1668297,156
+24581,1668453,135
+24622,1668588,144
+24758,1668732,150
+24684,1668882,128
+24803,1669010,145
+24689,1669155,121
+24673,1669276,168
+24603,1669444,140
+24773,1669584,129
+24745,1669713,121
+24818,1669834,127
+24771,1669961,135
+24617,1670096,163
+24744,1670259,107
+24828,1670366,184
+24600,1670550,160
+24586,1670710,149
+24740,1670859,146
+24676,1671005,131
+24825,1671136,162
+24810,1671298,130
+24706,1671428,167
+24807,1671595,113
+24793,1671708,152
+24607,1671860,148
+24660,1672008,133
+24770,1672141,114
+24788,1672255,152
+41038,1672407,156
+41050,1672563,143
+41042,1672706,168
+41054,1672874,142
+41109,1673016,146
+41043,1673162,145
+41065,1673307,140
+41082,1673447,178
+24731,1673625,140
+24795,1673765,130
+24658,1673895,167
+24754,1674062,142
+24705,1674204,144
+40965,1674348,151
+41202,1674499,163
+41183,1674662,156
+41108,1674818,146
+41199,1674964,142
+40992,1675106,134
+41166,1675240,115
+41000,1675355,142
+41118,1675497,116
+41113,1675613,128
+41196,1675741,136
+41063,1675877,161
+41184,1676038,165
+41213,1676203,160
+40975,1676363,163
+40962,1676526,176
+41188,1676702,123
+41198,1676825,136
+41155,1676961,122
+40970,1677083,136
+41191,1677219,151
+41088,1677370,132
+41003,1677502,153
+41192,1677655,133
+40968,1677788,125
+41040,1677913,142
+41181,1678055,144
+41077,1678199,152
+40969,1678351,138
+40972,1678489,146
+41062,1678635,123
+41131,1678758,153
+41176,1678911,122
+41210,1679033,138
+41163,1679171,166
+41012,1679337,98
+40961,1679435,157
+8370,1679592,208
+8274,1679800,140
+8444,1679940,120
+8446,1680060,151
+8307,1680211,157
+8245,1680368,142
+40983,1680510,130
+40997,1680640,137
+41147,1680777,112
+41105,1680889,130
+41125,1681019,142
+8375,1681161,123
+8419,1681284,160
+8211,1681444,161
+8363,1681605,157
+8333,1681762,123
+8413,1681885,149
+8422,1682034,129
+41122,1682163,110
+8326,1682273,149
+8227,1682422,139
+41044,1682561,60
+8282,1682621,131
+8192,1682752,159
+8221,1682911,146
+8195,1683057,146
+8262,1683203,139
+8347,1683342,127
+8220,1683469,134
+8319,1683603,148
+8393,1683751,99
+8311,1683850,147
+8314,1683997,153
+8254,1684150,166
+8280,1684316,130
+8417,1684446,140
+8230,1684586,146
+8293,1684732,155
+8234,1684887,115
+8323,1685002,151
+8217,1685153,122
+8350,1685275,204
+8334,1685479,162
+8343,1685641,152
+49163,1685793,113
+8368,1685906,145
+8283,1686051,134
+8438,1686185,149
+8390,1686334,94
+8200,1686428,162
+8403,1686590,148
+49166,1686738,140
+49201,1686878,174
+1793,1687052,141
+49308,1687193,151
+49322,1687344,159
+49254,1687503,132
+49197,1687635,146
+49394,1687781,145
+49341,1687926,150
+49288,1688076,127
+49169,1688203,173
+49214,1688376,135
+49405,1688511,100
+49172,1688611,168
+43580,1688779,170
+49353,1688949,136
+49224,1689085,158
+49270,1689243,135
+49222,1689378,156
+49303,1689534,107
+49156,1689641,158
+49248,1689799,117
+16588,1689916,166
+49310,1690082,147
+49324,1690229,152
+49204,1690381,141
+49299,1690522,155
+16615,1690677,164
+16519,1690841,150
+16391,1690991,128
+16507,1691119,148
+16428,1691267,166
+49375,1691433,148
+49397,1691581,132
+49297,1691713,146
+49225,1691859,152
+49309,1692011,173
+49385,1692184,129
+49349,1692313,130
+49233,1692443,165
+49285,1692608,161
+49330,1692769,142
+49236,1692911,152
+49186,1693063,168
+49189,1693231,162
+16591,1693393,148
+16503,1693541,151
+49196,1693692,166
+49403,1693858,163
+49195,1694021,148
+16500,1694169,144
+16568,1694313,130
+16616,1694443,165
+16576,1694608,156
+49312,1694764,161
+49168,1694925,140
+49207,1695065,118
+16515,1695183,136
+16475,1695319,136
+16499,1695455,143
+16509,1695598,155
+32983,1695753,121
+32890,1695874,144
+32988,1696018,140
+16461,1696158,148
+16397,1696306,160
+16409,1696466,148
+16574,1696614,146
+16494,1696760,124
+16502,1696884,168
+16418,1697052,150
+16575,1697202,169
+16414,1697371,113
+16538,1697484,149
+16532,1697633,147
+16469,1697780,126
+16423,1697906,152
+16523,1698058,145
+16623,1698203,135
+16531,1698338,140
+16517,1698478,121
+16419,1698599,133
+16548,1698732,136
+16392,1698868,152
+16565,1699020,158
+16402,1699178,128
+16597,1699306,159
+16400,1699465,150
+16586,1699615,167
+16580,1699782,147
+16477,1699929,129
+16610,1700058,172
+16524,1700230,129
+16453,1700359,149
+16424,1700508,138
+16605,1700646,137
+16587,1700783,144
+16562,1700927,116
+16614,1701043,103
+16624,1701146,138
+16521,1701284,142
+16405,1701426,118
+32917,1701544,150
+32942,1701694,153
+32826,1701847,138
+32796,1701985,160
+32854,1702145,143
+32817,1702288,127
+32987,1702415,145
+32898,1702560,147
+32825,1702707,131
+32803,1702838,170
+32875,1703008,133
+32857,1703141,134
+32833,1703275,150
+32896,1703425,149
+32831,1703574,145
+32998,1703719,151
+32992,1703870,147
+32904,1704017,154
+32984,1704171,159
+32926,1704330,109
+32811,1704439,151
+32769,1704590,166
+32919,1704756,139
+32881,1704895,142
+32920,1705037,143
+32970,1705180,159
+32981,1705339,148
+32795,1705487,134
+32979,1705621,125
+32947,1705746,138
+32999,1705884,184
+32800,1706068,147
+32880,1706215,126
+32776,1706341,164
+228,1706505,132
+32787,1706637,151
+32878,1706788,140
+32784,1706928,152
+32839,1707080,140
+32871,1707220,143
+32837,1707363,149
+32959,1707512,155
+33017,1707667,144
+32929,1707811,138
+32937,1707949,137
+32791,1708086,133
+33016,1708219,124
+20,1708343,120
+114,1708463,127
+161,1708590,152
+245,1708742,148
+92,1708890,170
+172,1709060,144
+148,1709204,135
+144,1709339,126
+71,1709465,150
+33,1709615,167
+48,1709782,141
+53,1709923,146
+38,1710069,122
+182,1710191,130
+130,1710321,124
+43,1710445,144
+81,1710589,148
+167,1710737,168
+152,1710905,156
+198,1711061,132
+112,1711193,119
+143,1711312,113
+241,1711425,152
+84,1711577,126
+32,1711703,122
+122,1711825,140
+69,1711965,175
+156,1712140,147
+124,1712287,133
+104,1712420,141
+233,1712561,136
+159,1712697,154
+227,1712851,176
+173,1713027,144
+116,1713171,131
+70,1713302,149
+141,1713451,124
+59,1713575,141
+179,1713716,137
+211,1713853,112
+208,1713965,140
+147,1714105,120
+139,1714225,117
+524375,1714342,122
+524381,1714464,139
+524379,1714603,147
+524401,1714750,120
+524396,1714870,151
+524391,1715021,96
+524428,1715117,158
+524417,1715275,136
+524333,1715411,131
+56576,1715542,145
+170,1715687,129
+264928,1715816,142
+524305,1715958,133
+524326,1716091,119
+524325,1716210,136
+1048576,1716346,60
+215,1716406,140
+11141124,1716546,160
+524300,1716706,145
+56581,1716851,145
+524317,1716996,157
+56587,1717153,145
+524291,1717298,157
+56579,1717455,145
+56591,1717600,145
+1,1717745,129
+524311,1717874,156
+5513568,1718030,117
+1094598,1718147,141
+1094614,1718288,141
+5805616,1718429,166
+16274616,1718595,141
+7870261,1718736,189
+3967309,1718925,152
+8701959,1719077,153
+11811129,1719230,257
+10529617,1719487,225
+6605057,1719712,185
+7642869,1719897,161
+6864836,1720058,161
+11034181,1720219,167
+307617,1720386,161
+13387342,1720547,161
+16288060,1720708,200
+10542869,1720908,196
+12889396,1721104,128
+3174151,1721232,170
+2389239,1721402,114
+8181094,1721516,141
+6841168,1721657,226
+6087948,1721883,242
+1601595,1722125,180
+14196321,1722305,180
+3440128,1722485,180
+12434,1722665,142
+8418591,1722807,121
+15227531,1722928,219
+4465301,1723147,218
+6058253,1723365,139
+43848,1723504,122
+16274893,1723626,152
+4462663,1723778,251
+1884604,1724029,238
+11297209,1724267,193
+12900595,1724460,115
+12374,1724575,149
+6818530,1724724,149
+11307932,1724873,161
+2898685,1725034,206
+3426651,1725240,178
+13169433,1725418,189
+8394249,1725607,135
+286372,1725742,216
+1884096,1725958,234
+7910506,1726192,196
+7138230,1726388,196
+5043547,1726584,196
+15220583,1726780,180
+3426028,1726960,180
+6566201,1727140,154
+10767317,1727294,219
+6591852,1727513,151
+1345386,1727664,123
+14726495,1727787,123
+16318402,1727910,123
+14740288,1728033,123
+6580558,1728156,130
+9754331,1728286,159
+11857138,1728445,206
+1632119,1728651,197
+4224937,1728848,185
+16266033,1729033,130
+12883277,1729163,154
+12884088,1729317,251
+7103388,1729568,139
+6040303,1729707,149
+10795885,1729856,117
+7079638,1729973,180
+822825,1730153,158
+10494542,1730311,154
+3155919,1730465,60
+3687397,1730525,137
+13392190,1730662,164
+6056144,1730826,150
+1062474,1730976,124
+47120,1731100,238
+10793529,1731338,141
+14210489,1731479,170
+7088,1731649,160
+6860799,1731809,253
+14426594,1732062,196
+16522193,1732258,196
+5776757,1732454,196
+2678501,1732650,196
+13638716,1732846,253
+1622093,1733099,182
+9218741,1733281,170
+4205686,1733451,154
+4507644,1733605,180
+7898612,1733785,180
+16009557,1733965,191
+526791,1734156,189
+8934431,1734345,139
+9440456,1734484,139
+269767,1734623,178
+6824287,1734801,156
+3942566,1734957,199
+5263524,1735156,161
+8423129,1735317,161
+15996856,1735478,175
+3981152,1735653,123
+11277812,1735776,123
+3697271,1735899,161
+1315929,1736060,152
+5260217,1736212,165
+6039508,1736377,303
+8955001,1736680,123
+291477,1736803,123
+13911777,1736926,123
+7917922,1737049,123
+587964,1737172,123
+9478747,1737295,123
+1585164,1737418,160
+4498798,1737578,122
+1872285,1737700,270
+16577183,1737970,218
+16260914,1738188,193
+11537109,1738381,178
+2101582,1738559,134
+2905921,1738693,141
+11029834,1738834,186
+7902440,1739020,139
+4738812,1739159,139
+11580243,1739298,154
+5537724,1739452,118
+8183713,1739570,170
+9961578,1739740,178
+9844,1739918,129
+1873861,1740047,126
+6078935,1740173,175
+3670342,1740348,236
+8951381,1740584,186
+16032982,1740770,196
+16572751,1740966,134
+7648950,1741100,122
+15505330,1741222,218
+2685562,1741440,259
+8662548,1741699,149
+1050081,1741848,114
+586840,1741962,180
+6076972,1742142,158
+3422100,1742300,142
+7133516,1742442,197
+15479149,1742639,116
+4460798,1742755,232
+8170336,1742987,123
+4507229,1743110,123
+1605305,1743233,123
+5023309,1743356,141
+13401973,1743497,141
+2156660,1743638,123
+13647786,1743761,123
+833847,1743884,180
+13949961,1744064,156
+35002,1744220,94
+16020277,1744314,132
+9481724,1744446,170
+6071853,1744616,141
+4205417,1744757,171
+15264142,1744928,132
+6616763,1745060,193
+12326549,1745253,178
+14431729,1745431,161
+10749953,1745592,141
+11280080,1745733,171
+2943615,1745904,117
+3428736,1746021,290
+10801106,1746311,191
+11051159,1746502,131
+551889,1746633,275
+11287143,1746908,141
+3978557,1747049,206
+9964881,1747255,180
+44501,1747435,180
+9461116,1747615,185
+10025639,1747800,173
+4750174,1747973,169
+12116913,1748142,196
+47016,1748338,155
+15497545,1748493,160
+13947606,1748653,226
+1069170,1748879,159
+9439876,1749038,171
+11291239,1749209,141
+7391895,1749350,135
+3191318,1749485,196
+2449,1749681,163
+13133405,1749844,147
+14687297,1749991,147
+14177442,1750138,147
+550431,1750285,140
+12382992,1750425,147
+2643057,1750572,180
+12095106,1750752,180
+14431037,1750932,180
+14186623,1751112,191
+13901169,1751303,140
+559046,1751443,147
+7886707,1751590,196
+11296905,1751786,196
+8666770,1751982,196
+7376054,1752178,196
+5260874,1752374,196
+12887042,1752570,196
+5631,1752766,178
+2654370,1752944,178
+6828844,1753122,181
+1334853,1753303,167
+7364987,1753470,141
+9984329,1753611,146
+11298738,1753757,170
+10272110,1753927,162
+4993833,1754089,111
+6611314,1754200,262
+4755290,1754462,128
+1050181,1754590,178
+5321,1754768,172
+9272,1754940,172
+7638776,1755112,172
+10232,1755284,172
+5303066,1755456,172
+16272892,1755628,202
+8690240,1755830,202
+14163916,1756032,172
+12880365,1756204,149
+6353978,1756353,183
+5810299,1756536,141
+6056919,1756677,291
+1591498,1756968,178
+9498311,1757146,161
+1059243,1757307,161
+1593035,1757468,161
+8397479,1757629,151
+6613121,1757780,189
+10001757,1757969,166
+6038294,1758135,170
+270660,1758305,181
+10495926,1758486,161
+1063191,1758647,161
+9994478,1758808,161
+13372914,1758969,193
+9748372,1759162,137
+9716557,1759299,133
+11026469,1759432,147
+1074595,1759579,128
+13130656,1759707,303
+14728707,1760010,265
+6066194,1760275,167
+3733453,1760442,154
+10013604,1760596,165
+4835,1760761,159
+4945,1760920,151
+1588407,1761071,180
+10782835,1761251,141
+12091471,1761392,130
+16557520,1761522,213
+314248,1761735,288
+10510944,1762023,60
+10796484,1762083,196
+6066519,1762279,196
+4724371,1762475,150
+11827527,1762625,129
+325880,1762754,156
+3731656,1762910,119
+6094494,1763029,184
+8920213,1763213,214
+16017730,1763427,164
+2364423,1763591,268
+584182,1763859,203
+15740497,1764062,141
+13419105,1764203,154
+7631101,1764357,140
+8137265,1764497,140
+11824124,1764637,140
+1331082,1764777,140
+12629753,1764917,140
+4760690,1765057,140
+14217930,1765197,140
+4780415,1765337,140
+4478690,1765477,240
+6876357,1765717,140
+8156725,1765857,140
+6556631,1765997,123
+11047229,1766120,123
+5032286,1766243,175
+801616,1766418,123
+7875398,1766541,140
+3440118,1766681,140
+13425068,1766821,140
+10234230,1766961,140
+12098090,1767101,140
+5805597,1767241,140
+7657534,1767381,140
+578110,1767521,140
+11042538,1767661,140
+4254873,1767801,140
+12342319,1767941,140
+3461110,1768081,140
+13139617,1768221,190
+6564879,1768411,197
+10506507,1768608,140
+14482248,1768748,140
+8715729,1768888,140
+4224224,1769028,140
+553360,1769168,140
+6081883,1769308,140
+10006373,1769448,140
+4236983,1769588,140
+817685,1769728,140
+5541210,1769868,140
+3172048,1770008,180
+3977779,1770188,180
+2137721,1770368,161
+11296746,1770529,212
+281286,1770741,207
+6084021,1770948,291
+8950927,1771239,214
+1611090,1771453,176
+12648360,1771629,196
+12603774,1771825,202
+16520345,1772027,239
+10012580,1772266,277
+48853,1772543,185
+708,1772728,204
+11333896,1772932,139
+585117,1773071,253
+15232459,1773324,161
+3164496,1773485,154
+1481,1773639,139
+842878,1773778,170
+2136280,1773948,234
+8177534,1774182,199
+10538997,1774381,178
+1835309,1774559,153
+3974703,1774712,206
+10007535,1774918,180
+5306712,1775098,180
+12624750,1775278,121
+6304433,1775399,252
+8191339,1775651,219
+14950267,1775870,141
+1582665,1776011,140
+8913897,1776151,213
+3430464,1776364,196
+6055034,1776560,196
+12353403,1776756,180
+15792839,1776936,180
+14479232,1777116,196
+11824941,1777312,135
+6063486,1777447,154
+8678216,1777601,229
+11821293,1777830,242
+3197985,1778072,178
+6581376,1778250,234
+564737,1778484,150
+11017860,1778634,164
+12589136,1778798,173
+4466675,1778971,171
+294267,1779142,180
+9692,1779322,176
+13955895,1779498,167
+4760248,1779665,248
+12630246,1779913,226
+9212959,1780139,141
+6847924,1780280,141
+5826675,1780421,209
+11546824,1780630,145
+14434729,1780775,140
+560940,1780915,166
+11023634,1781081,180
+13936209,1781261,231
+9500228,1781492,180
+4501288,1781672,140
+7095338,1781812,196
+10779849,1782008,196
+12848534,1782204,196
+10512412,1782400,229
+8661757,1782629,112
+16276605,1782741,252
+8683668,1782993,127
+1094613,1783120,141
+3187394,1783261,180
+14475222,1783441,178
+11315342,1783619,149
+9978204,1783768,156
+15748988,1783924,60
+7361573,1783984,139
+6032330,1784123,136
+2634548,1784259,180
+15770149,1784439,60
+5284146,1784499,272
+8419441,1784771,164
+5026253,1784935,135
+16030738,1785070,121
+8933754,1785191,127
+11318197,1785318,196
+539272,1785514,228
+536971,1785742,196
+16037512,1785938,139
+5012040,1786077,149
+8704346,1786226,172
+294670,1786398,192
+12121683,1786590,288
+6335252,1786878,139
+12346066,1787017,170
+7118460,1787187,199
+4511218,1787386,154
+3206,1787540,141
+16268479,1787681,183
+16537754,1787864,141
+15762976,1788005,158
+14470285,1788163,214
+15752311,1788377,139
+1118481,1788516,60
+7132959,1788576,213
+15755365,1788789,151
+10773409,1788940,207
+3972438,1789147,196
+7404869,1789343,196
+4482887,1789539,196
+8931952,1789735,185
+16037307,1789920,141
+5274309,1790061,123
+5008360,1790184,123
+9209374,1790307,123
+5516173,1790430,123
+7465,1790553,113
+15508958,1790666,142
+9193826,1790808,125
+1061823,1790933,166
+3437923,1791099,217
+1322590,1791316,159
+9675,1791475,140
+4465532,1791615,242
+12608740,1791857,141
+5275722,1791998,220
+3183669,1792218,197
+13913014,1792415,259
+3676236,1792674,213
+14168038,1792887,259
+1314626,1793146,114
+28001,1793260,266
+12889177,1793526,178
+5773015,1793704,159
+16557178,1793863,154
+14948801,1794017,196
+12084869,1794213,178
+3676754,1794391,166
+2583,1794557,154
+14200705,1794711,136
+15007137,1794847,196
+11817641,1795043,130
+5566276,1795173,265
+4205392,1795438,139
+7916587,1795577,175
+12060502,1795752,142
+13682775,1795894,154
+16563409,1796048,197
+7627002,1796245,197
+13384415,1796442,60
+3731427,1796502,153
+5297399,1796655,252
+8007,1796907,141
+9239832,1797048,197
+11818073,1797245,261
+2416,1797506,163
+1352352,1797669,141
+14986121,1797810,158
+7914259,1797968,192
+7615662,1798160,182
+7646647,1798342,175
+6329806,1798517,154
+9233856,1798671,161
+15764086,1798832,161
+15510053,1798993,161
+6847851,1799154,161
+4739433,1799315,161
+12846723,1799476,197
+9752589,1799673,197
+12880474,1799870,123
+11836053,1799993,276
+11305961,1800269,212
+14207494,1800481,160
+1843419,1800641,196
+13682267,1800837,196
+9468082,1801033,219
+11849696,1801252,240
+12353444,1801492,219
+16533805,1801711,141
+7663146,1801852,238
+556644,1802090,166
+524345,1802256,133
+9455420,1802389,192
+8953395,1802581,172
+7113452,1802753,182
+8700644,1802935,163
+8135128,1803098,252
+16575056,1803350,214
+57451,1803564,137
+285804,1803701,137
+14217563,1803838,170
+13955159,1804008,156
+7139710,1804164,198
+539183,1804362,266
+1849952,1804628,135
+13907229,1804763,136
+6293955,1804899,117
+4753252,1805016,197
+6036665,1805213,197
+12647812,1805410,178
+4475774,1805588,199
+14453815,1805787,141
+15257852,1805928,174
+15263927,1806102,179
+1064254,1806281,192
+8147162,1806473,60
+6605858,1806533,158
+5017943,1806691,241
+10233278,1806932,164
+13646314,1807096,116
+16310241,1807212,142
+6345437,1807354,267
+7900279,1807621,159
+3935357,1807780,131
+3438277,1807911,154
+2415155,1808065,196
+16558992,1808261,196
+5805016,1808457,130
+5263785,1808587,130
+10786652,1808717,183
+11545119,1808900,221
+14444556,1809121,158
+15991408,1809279,117
+1844996,1809396,178
+5273779,1809574,178
+15783159,1809752,152
+14732410,1809904,196
+7087051,1810100,163
+6335335,1810263,219
+11301132,1810482,192
+11066115,1810674,221
+3180868,1810895,149
+16021856,1811044,196
+1331856,1811240,169
+6042309,1811409,123
+11333232,1811532,165
+11330259,1811697,139
+64802,1811836,141
+4462845,1811977,123
+46592,1812100,153
+10025627,1812253,189
+23444,1812442,123
+14715262,1812565,123
+11537617,1812688,137
+4736705,1812825,226
+11849897,1813051,192
+16525811,1813243,146
+16297947,1813389,199
+10534173,1813588,186
+14982942,1813774,139
+9749,1813913,128
+10260188,1814041,130
+401,1814171,138
+11326820,1814309,234
+9752693,1814543,119
+2667771,1814662,229
+4258261,1814891,132
+13380739,1815023,134
+14478724,1815157,146
+8148796,1815303,189
+2884021,1815492,141
+2682625,1815633,60
+12604214,1815693,356
+6319824,1816049,112
+2936038,1816161,212
+14961863,1816373,154
+13953152,1816527,141
+11023466,1816668,161
+3940598,1816829,161
+8140973,1816990,161
+13933789,1817151,203
+5306146,1817354,141
+9980385,1817495,151
+317349,1817646,185
+5000550,1817831,220
+10781050,1818051,165
+9459793,1818216,166
+9963983,1818382,212
+12115550,1818594,195
+8935942,1818789,213
+5523411,1819002,113
+13430236,1819115,158
+13424671,1819273,223
+6851343,1819496,185
+16265066,1819681,214
+11561190,1819895,234
+10807268,1820129,120
+12119947,1820249,194
+12064879,1820443,153
+6719,1820596,141
+12638260,1820737,124
+12108371,1820861,137
+15752217,1820998,189
+310664,1821187,189
+10230802,1821376,189
+1630132,1821565,178
+327,1821743,139
+2144128,1821882,256
+14694167,1822138,166
+1365246,1822304,139
+3166069,1822443,200
+15510010,1822643,197
+933,1822840,149
+12379772,1822989,170
+8134150,1823159,185
+15774494,1823344,161
+16290163,1823505,166
+13127558,1823671,129
+6564333,1823800,142
+4471944,1823942,204
+8658032,1824146,178
+5523265,1824324,181
+13432629,1824505,141
+12908601,1824646,134
+13170498,1824780,259
+28658,1825039,158
+3202957,1825197,171
+13945148,1825368,141
+7920914,1825509,158
+2907444,1825667,213
+10228835,1825880,186
+9267,1826066,167
+8966,1826233,167
+11856898,1826400,144
+6578232,1826544,194
+7346343,1826738,141
+13423517,1826879,154
+14710026,1827033,138
+6593,1827171,167
+5886,1827338,167
+10259836,1827505,144
+13903308,1827649,154
+9203140,1827803,123
+12350774,1827926,159
+14724702,1828085,164
+13940577,1828249,207
+8127326,1828456,219
+4521531,1828675,158
+14170869,1828833,144
+3725733,1828977,171
+5015389,1829148,136
+11593694,1829284,179
+6593945,1829463,138
+5789,1829601,141
+5019181,1829742,116
+53881,1829858,192
+4737584,1830050,161
+4743587,1830211,150
+3164710,1830361,275
+5039534,1830636,296
+14996394,1830932,201
+13920211,1831133,213
+10752562,1831346,213
+4776899,1831559,173
+13383002,1831732,152
+8410218,1831884,171
+11814901,1832055,207
+16041928,1832262,142
+11050148,1832404,184
+76,1832588,134
+9228175,1832722,123
+2651608,1832845,214
+9495042,1833059,130
+3155064,1833189,178
+8161729,1833367,140
+8694078,1833507,139
+11584391,1833646,127
+551895,1833773,149
+3445570,1833922,196
+5807814,1834118,155
+6604627,1834273,123
+6576301,1834396,185
+1897114,1834581,139
+7637517,1834720,139
+13399522,1834859,139
+10527672,1834998,125
+3733971,1835123,123
+16521276,1835246,123
+10751078,1835369,310
+4478385,1835679,196
+10025415,1835875,154
+7342927,1836029,141
+14956684,1836170,159
+1592287,1836329,127
+12098202,1836456,284
+9206768,1836740,213
+14722313,1836953,244
+3955908,1837197,141
+14198614,1837338,178
+14210803,1837516,214
+7089372,1837730,212
+7878048,1837942,143
+16005385,1838085,139
+2105137,1838224,169
+2935876,1838393,173
+16023023,1838566,161
+8162229,1838727,161
+5538618,1838888,187
+7893074,1839075,121
+14199179,1839196,130
+4460,1839326,182
+1096183,1839508,121
+1372111,1839629,112
+3682553,1839741,189
+11026337,1839930,154
+7882723,1840084,238
+7117760,1840322,140
+16047078,1840462,141
+2393240,1840603,264
+12612781,1840867,156
+15767025,1841023,132
+62605,1841155,174
+7352025,1841329,217
+7346479,1841546,196
+1098287,1841742,145
+12335205,1841887,140
+322368,1842027,141
+1615857,1842168,208
+9494907,1842376,123
+14163065,1842499,123
+5826234,1842622,123
+4515054,1842745,178
+14434789,1842923,235
+42431,1843158,141
+13155049,1843299,139
+1573361,1843438,219
+12865331,1843657,170
+5532376,1843827,172
+12616829,1843999,185
+264613,1844184,132
+9736575,1844316,164
+10226911,1844480,213
+2367780,1844693,114
+9739052,1844807,143
+8180490,1844950,156
+7731,1845106,156
+16522628,1845262,199
+1617054,1845461,214
+15500468,1845675,165
+53398,1845840,130
+9812,1845970,120
+20698,1846090,115
+1142,1846205,115
+1141,1846320,115
+4465393,1846435,137
+3148281,1846572,154
+11853264,1846726,171
+4780071,1846897,189
+1361559,1847086,213
+8127403,1847299,219
+14423730,1847518,196
+2423653,1847714,196
+832807,1847910,196
+11808409,1848106,182
+3419332,1848288,189
+1370546,1848477,199
+13128779,1848676,187
+13664160,1848863,161
+37011,1849024,143
+4985177,1849167,185
+1183,1849352,145
+53371,1849497,167
+7885386,1849664,125
+15006850,1849789,137
+46544,1849926,161
+1349349,1850087,161
+12873339,1850248,217
+12601595,1850465,268
+2156674,1850733,178
+15769596,1850911,149
+832990,1851060,133
+2875,1851193,127
+2360712,1851320,139
+5299452,1851459,172
+7342849,1851631,178
+6039075,1851809,194
+3160149,1852003,134
+46704,1852137,141
+11297815,1852278,130
+3438870,1852408,196
+3434218,1852604,233
+2635868,1852837,142
+793687,1852979,130
+8417200,1853109,130
+8929177,1853239,127
+15494923,1853366,142
+1772,1853508,141
+8154534,1853649,185
+13637300,1853834,196
+2140345,1854030,155
+15790223,1854185,178
+9220329,1854363,170
+1849671,1854533,220
+3418002,1854753,132
+4235528,1854885,271
+7363254,1855156,220
+2103814,1855376,220
+16296291,1855596,220
+14421665,1855816,246
+12087540,1856062,221
+40299,1856283,178
+7625011,1856461,189
+15489258,1856650,135
+8165972,1856785,166
+3705689,1856951,139
+8913176,1857090,137
+10757656,1857227,214
+10772881,1857441,146
+8692301,1857587,263
+8154012,1857850,213
+6070,1858063,141
+1071383,1858204,112
+13692865,1858316,196
+13914705,1858512,171
+6325,1858683,134
+14188209,1858817,149
+4740866,1858966,196
+6573890,1859162,153
+14462824,1859315,225
+2419793,1859540,216
+7375308,1859756,192
+2907105,1859948,174
+14479306,1860122,178
+48224,1860300,141
+13400929,1860441,184
+10252602,1860625,196
+2922417,1860821,196
+11049321,1861017,117
+10807950,1861134,145
+8924499,1861279,260
+53429,1861539,165
+7629739,1861704,212
+833234,1861916,189
+7875053,1862105,164
+5267903,1862269,141
+2527,1862410,169
+15991599,1862579,131
+9718284,1862710,159
+4002,1862869,118
+1085152,1862987,161
+16557601,1863148,161
+9237032,1863309,246
+7343978,1863555,141
+2994,1863696,163
+12382,1863859,121
+16542704,1863980,288
+5239,1864268,120
+1947,1864388,144
+5523472,1864532,117
+5550595,1864649,168
+3696861,1864817,138
+12105713,1864955,178
+8409334,1865133,214
+11061945,1865347,193
+2111830,1865540,127
+7909348,1865667,125
+9478455,1865792,259
+8389276,1866051,162
+13682131,1866213,169
+1316510,1866382,221
+16303006,1866603,196
+15257753,1866799,199
+1080228,1866998,190
+8143266,1867188,114
+12333663,1867302,186
+5266370,1867488,174
+7086498,1867662,185
+10235763,1867847,260
+14168803,1868107,219
+9734112,1868326,219
+3714857,1868545,186
+13141545,1868731,255
+13419232,1868986,191
+3148485,1869177,250
+57445,1869427,166
+4482812,1869593,213
+10496237,1869806,127
+11293812,1869933,185
+9182426,1870118,154
+1960,1870272,166
+9966802,1870438,113
+1313244,1870551,196
+15504229,1870747,142
+12892835,1870889,244
+10288801,1871133,199
+14191163,1871332,120
+15489670,1871452,287
+12644021,1871739,173
+6348531,1871912,196
+5283849,1872108,219
+8951374,1872327,139
+8929098,1872466,130
+10266133,1872596,252
+14962294,1872848,222
+16536,1873070,125
+7674,1873195,241
+10282590,1873436,123
+12884096,1873559,123
+14693262,1873682,123
+587420,1873805,123
+326275,1873928,208
+7928244,1874136,109
+13661927,1874245,252
+5285503,1874497,123
+13918682,1874620,123
+15734936,1874743,123
+8919304,1874866,123
+6031687,1874989,123
+1319006,1875112,123
+12075428,1875235,123
+5724,1875358,146
+6560942,1875504,175
+16311374,1875679,128
+4246906,1875807,189
+14438132,1875996,257
+15761779,1876253,139
+15492556,1876392,207
+9738640,1876599,183
+16039063,1876782,232
+2686686,1877014,137
+9468176,1877151,214
+15848,1877365,189
+6880986,1877554,199
+15243373,1877753,140
+1330740,1877893,149
+20619,1878042,137
+1338268,1878179,238
+9735663,1878417,132
+2939252,1878549,222
+13956998,1878771,199
+3408862,1878970,130
+2361955,1879100,139
+16288567,1879239,139
+2123644,1879378,158
+3462930,1879536,212
+10511888,1879748,160
+4521914,1879908,178
+14738990,1880086,172
+3700834,1880258,183
+14953851,1880441,185
+12870883,1880626,130
+8918947,1880756,214
+8956327,1880970,154
+15501588,1881124,196
+12096566,1881320,196
+5248121,1881516,136
+6325437,1881652,159
+3440330,1881811,153
+11808504,1881964,201
+10802354,1882165,193
+9238387,1882358,114
+14474532,1882472,168
+6560944,1882640,175
+9452146,1882815,135
+13384536,1882950,144
+5042112,1883094,141
+9197939,1883235,187
+2365469,1883422,221
+5822297,1883643,196
+16289894,1883839,151
+7341740,1883990,245
+2622168,1884235,161
+14476595,1884396,154
+14173276,1884550,189
+5281105,1884739,139
+8405286,1884878,196
+11336048,1885074,196
+8141139,1885270,178
+3727786,1885448,178
+4769686,1885626,161
+16040520,1885787,161
+16019856,1885948,161
+12910524,1886109,154
+795497,1886263,135
+313817,1886398,152
+7362040,1886550,151
+7099597,1886701,168
+2185,1886869,152
+15775159,1887021,184
+11853535,1887205,178
+2636674,1887383,189
+13930652,1887572,123
+14999718,1887695,123
+5768276,1887818,161
+3971703,1887979,165
+12875695,1888144,165
+9709836,1888309,263
+10236622,1888572,135
+2154652,1888707,114
+2948513,1888821,167
+3672020,1888988,157
+268671,1889145,130
+6029368,1889275,145
+9235531,1889420,117
+20625,1889537,130
+12079105,1889667,146
+8399865,1889813,193
+5552130,1890006,161
+1101481,1890167,130
+8412684,1890297,231
+7096769,1890528,181
+7401123,1890709,181
+7358441,1890890,197
+6050334,1891087,156
+1328202,1891243,139
+3943577,1891382,156
+8966201,1891538,213
+6831618,1891751,205
+609,1891956,114
+5315,1892070,131
+1231,1892201,131
+8247,1892332,147
+6062503,1892479,145
+6032398,1892624,266
+5258474,1892890,213
+13670139,1893103,200
+57489,1893303,138
+3687293,1893441,189
+5271448,1893630,260
+5025308,1893890,209
+1321090,1894099,192
+15499667,1894291,135
+7134512,1894426,141
+7097990,1894567,201
+6063809,1894768,178
+6059894,1894946,172
+7398766,1895118,130
+5537229,1895248,130
+44749,1895378,149
+16555480,1895527,269
+14428212,1895796,153
+8671386,1895949,187
+5936,1896136,143
+3204238,1896279,132
+4493664,1896411,178
+11858394,1896589,189
+13132785,1896778,173
+14475693,1896951,351
+9734228,1897302,135
+7437,1897437,173
+11598902,1897610,165
+7668,1897775,166
+7079381,1897941,147
+6594,1898088,157
+15511777,1898245,133
+7921113,1898378,219
+16300002,1898597,141
+16261205,1898738,174
+7659930,1898912,199
+151,1899111,118
+9228041,1899229,114
+9208733,1899343,260
+11583902,1899603,178
+800583,1899781,178
+11314791,1899959,178
+33273,1900137,130
+15513082,1900267,156
+4508942,1900423,259
+15237723,1900682,139
+7379228,1900821,241
+8433725,1901062,123
+14981852,1901185,123
+11330741,1901308,123
+13685424,1901431,123
+7342,1901554,141
+8183158,1901695,194
+2386048,1901889,159
+15766196,1902048,248
+15261552,1902296,206
+2665790,1902502,271
+7254,1902773,157
+15756664,1902930,213
+7881981,1903143,252
+15530219,1903395,248
+7372181,1903643,223
+2900762,1903866,254
+11064264,1904120,167
+13654421,1904287,199
+1625224,1904486,189
+8439637,1904675,171
+15777070,1904846,144
+7630564,1904990,205
+16612,1905195,152
+9980746,1905347,139
+14714099,1905486,168
+3712718,1905654,121
+3430142,1905775,142
+7368843,1905917,141
+3710810,1906058,143
+14173165,1906201,133
+12337409,1906334,257
+277005,1906591,159
+4493079,1906750,188
+64651,1906938,141
+30385,1907079,173
+7127367,1907252,222
+10515172,1907474,193
+4985701,1907667,154
+13433175,1907821,117
+811686,1907938,222
+1577773,1908160,178
+7655965,1908338,196
+1603796,1908534,121
+12114253,1908655,178
+3707045,1908833,141
+12612651,1908974,237
+6055798,1909211,173
+4516568,1909384,130
+1612709,1909514,154
+10785201,1909668,136
+1863714,1909804,178
+13408401,1909982,141
+2670473,1910123,199
+9452989,1910322,171
+8852,1910493,152
+3705308,1910645,165
+9192704,1910810,178
+1891818,1910988,213
+9699334,1911201,125
+2098191,1911326,117
+10761234,1911443,141
+9209232,1911584,123
+12355779,1911707,251
+3722503,1911958,235
+53344,1912193,129
+15530499,1912322,110
+7116495,1912432,123
+6823744,1912555,201
+9481719,1912756,197
+4247076,1912953,141
+3420902,1913094,182
+4194682,1913276,141
+7899245,1913417,123
+2158120,1913540,123
+11859484,1913663,123
+586923,1913786,123
+16515452,1913909,193
+9450059,1914102,193
+6303264,1914295,196
+14971618,1914491,196
+4733,1914687,135
+16278629,1914822,175
+8288,1914997,146
+5279564,1915143,219
+10778456,1915362,217
+5808331,1915579,139
+3308,1915718,141
+14704777,1915859,144
+7878288,1916003,287
+12342524,1916290,260
+805716,1916550,252
+15003652,1916802,117
+9757549,1916919,130
+15792370,1917049,130
+3413267,1917179,130
+7635354,1917309,157
+2635077,1917466,285
+282444,1917751,196
+1619999,1917947,139
+1840415,1918086,196
+35836,1918282,158
+11021237,1918440,156
+15262178,1918596,122
+7868892,1918718,194
+13919174,1918912,193
+16270563,1919105,151
+2401588,1919256,179
+12862624,1919435,141
+1602606,1919576,139
+9479013,1919715,127
+14435510,1919842,161
+1050550,1920003,161
+3419405,1920164,161
+10767560,1920325,117
+14170046,1920442,181
+13920333,1920623,135
+9178256,1920758,135
+7121587,1920893,135
+5010,1921028,135
+545044,1921163,207
+13654528,1921370,165
+7370891,1921535,197
+4741540,1921732,178
+5553529,1921910,175
+10502719,1922085,142
+7401756,1922227,222
+7366051,1922449,231
+1315915,1922680,185
+7655644,1922865,124
+12618462,1922989,135
+7470,1923124,135
+11855402,1923259,139
+10536434,1923398,154
+11037564,1923552,204
+11549014,1923756,122
+3935451,1923878,177
+15483572,1924055,157
+6347395,1924212,214
+2905905,1924426,221
+13387321,1924647,120
+11312663,1924767,167
+6559334,1924934,132
+14212986,1925066,141
+1334241,1925207,118
+10494879,1925325,141
+7402330,1925466,141
+10499099,1925607,119
+10530749,1925726,139
+8162250,1925865,252
+11554342,1926117,252
+11569602,1926369,124
+15737785,1926493,154
+16534996,1926647,229
+10810562,1926876,134
+9180285,1927010,154
+3147597,1927164,221
+1843156,1927385,169
+39634,1927554,141
+4489079,1927695,132
+15251138,1927827,137
+9731047,1927964,161
+5280441,1928125,161
+14447784,1928286,161
+15218997,1928447,137
+6154,1928584,134
+6056576,1928718,187
+14180531,1928905,269
+6567196,1929174,187
+6339096,1929361,121
+4500048,1929482,137
+8703330,1929619,212
+11064697,1929831,272
+4475073,1930103,158
+4722787,1930261,184
+10522232,1930445,178
+8967436,1930623,213
+13904085,1930836,172
+10268527,1931008,214
+16536478,1931222,260
+6312727,1931482,144
+9465957,1931626,130
+1616216,1931756,164
+7653795,1931920,199
+15501900,1932119,178
+13917989,1932297,254
+4245707,1932551,186
+2927595,1932737,141
+13122155,1932878,125
+11847416,1933003,198
+10283345,1933201,283
+12113163,1933484,181
+12347102,1933665,258
+1599691,1933923,204
+12889618,1934127,175
+8100,1934302,209
+13950157,1934511,123
+4737962,1934634,123
+14461188,1934757,123
+7121713,1934880,123
+5010623,1935003,123
+300139,1935126,253
+10505307,1935379,257
+4753411,1935636,160
+11810531,1935796,168
+9753241,1935964,198
+3414581,1936162,199
+2884255,1936361,150
+6607188,1936511,128
+5822933,1936639,230
+7097232,1936869,134
+1295,1937003,133
+10002019,1937136,123
+8940398,1937259,123
+16049325,1937382,178
+2686782,1937560,178
+12113839,1937738,178
+13938181,1937916,161
+14698671,1938077,192
+2896657,1938269,141
+5276373,1938410,123
+15789584,1938533,161
+12873739,1938694,254
+3973223,1938948,174
+12321354,1939122,127
+9738497,1939249,253
+16275825,1939502,139
+1050058,1939641,142
+7902388,1939783,159
+4470536,1939942,123
+2645807,1940065,157
+5246965,1940222,230
+12338478,1940452,187
+14468683,1940639,196
+275337,1940835,196
+41064,1941031,143
+7355083,1941174,139
+7368172,1941313,125
+11584005,1941438,142
+9762129,1941580,170
+1071863,1941750,122
+12066218,1941872,189
+58368,1942061,204
+2905555,1942265,196
+49188,1942461,156
+8144517,1942617,271
+1842915,1942888,222
+4457260,1943110,139
+7891191,1943249,195
+19443,1943444,260
+576679,1943704,141
+562861,1943845,141
+533426,1943986,197
+8962995,1944183,125
+14700836,1944308,142
+7587,1944450,125
+5517194,1944575,245
+6296755,1944820,165
+1070609,1944985,139
+3438711,1945124,225
+8396,1945349,141
+6856688,1945490,178
+6074118,1945668,189
+6043,1945857,171
+1849738,1946028,199
+15230420,1946227,230
+2413852,1946457,222
+15483894,1946679,187
+6342232,1946866,151
+16561546,1947017,119
+10773215,1947136,159
+4986516,1947295,210
+13112401,1947505,196
+4510775,1947701,169
+15524180,1947870,267
+7083534,1948137,124
+8403466,1948261,214
+816062,1948475,275
+2649983,1948750,141
+15779920,1948891,196
+335,1949087,130
+2642529,1949217,141
+13150805,1949358,238
+2127883,1949596,149
+8915375,1949745,126
+2936877,1949871,141
+10275971,1950012,137
+2909043,1950149,248
+2402268,1950397,121
+6609824,1950518,131
+16291898,1950649,218
+5041391,1950867,130
+1896398,1950997,149
+10008297,1951146,156
+15734201,1951302,149
+6598822,1951451,123
+8127696,1951574,123
+8715436,1951697,123
+14421084,1951820,123
+7368717,1951943,123
+3203441,1952066,139
+1598864,1952205,123
+16278036,1952328,123
+7884611,1952451,123
+4214143,1952574,123
+7538,1952697,164
+14162298,1952861,127
+4995285,1952988,201
+5551468,1953189,215
+3427528,1953404,129
+6558572,1953533,178
+308808,1953711,112
+10023321,1953823,151
+1589412,1953974,277
+1853646,1954251,213
+13110472,1954464,196
+271813,1954660,196
+6307451,1954856,133
+5010567,1954989,274
+11305971,1955263,185
+13405402,1955448,256
+13907675,1955704,206
+2940077,1955910,178
+7101460,1956088,213
+15206725,1956301,214
+11576039,1956515,257
+8136071,1956772,154
+2892081,1956926,137
+20510,1957063,172
+15469978,1957235,171
+9492414,1957406,158
+2379387,1957564,154
+3190436,1957718,170
+3996227,1957888,196
+1335188,1958084,196
+8066,1958280,227
+8928284,1958507,142
+8516,1958649,127
+27633,1958776,141
+2634914,1958917,142
+7873454,1959059,139
+2126238,1959198,227
+2933344,1959425,131
+3948369,1959556,121
+3943156,1959677,159
+12617036,1959836,190
+9388,1960026,232
+5265487,1960258,182
+548317,1960440,142
+9199847,1960582,154
+13407344,1960736,177
+11811286,1960913,150
+3470234,1961063,139
+14161601,1961202,236
+13394405,1961438,193
+9210555,1961631,225
+923,1961856,153
+4512231,1962009,149
+2401340,1962158,143
+10259360,1962301,123
+13371533,1962424,123
+3712237,1962547,219
+12097817,1962766,144
+4259341,1962910,154
+11298013,1963064,154
+9746457,1963218,114
+7896392,1963332,214
+8942053,1963546,141
+12335577,1963687,109
+6331073,1963796,123
+7638280,1963919,123
+45294,1964042,140
+268502,1964182,143
+2153387,1964325,182
+3684897,1964507,154
+14170125,1964661,199
+8957251,1964860,168
+11857914,1965028,251
+7107005,1965279,154
+6352838,1965433,229
+8134,1965662,165
+11583784,1965827,160
+3180505,1965987,135
+16566980,1966122,130
+15784370,1966252,119
+14993409,1966371,134
+15767608,1966505,196
+13110804,1966701,206
+11297726,1966907,141
+16260472,1967048,154
+3733426,1967202,169
+1053264,1967371,214
+7865015,1967585,236
+6578564,1967821,106
+15263190,1967927,161
+13139573,1968088,161
+9823,1968249,161
+9018,1968410,161
+551434,1968571,164
+10020852,1968735,139
+1963,1968874,161
+9350,1969035,135
+9336,1969170,180
+3681745,1969350,161
+6956,1969511,154
+9450748,1969665,193
+5159,1969858,130
+7812,1969988,150
+1105329,1970138,123
+9001,1970261,125
+9901,1970386,141
+16523033,1970527,183
+8653613,1970710,193
+2122802,1970903,193
+11798521,1971096,191
+8953850,1971287,193
+9206965,1971480,193
+12863001,1971673,193
+5268243,1971866,193
+6346777,1972059,193
+16265128,1972252,193
+820444,1972445,193
+5740,1972638,177
+1580720,1972815,160
+2391840,1972975,178
+15205274,1973153,174
+3198375,1973327,157
+4679,1973484,167
+5529,1973651,169
+4859,1973820,183
+13657723,1974003,177
+12082811,1974180,160
+14979835,1974340,160
+7124980,1974500,160
+2900993,1974660,161
+12114382,1974821,161
+1861290,1974982,161
+3967998,1975143,161
+13953202,1975304,161
+1346045,1975465,161
+12354847,1975626,161
+5561,1975787,155
+9361,1975942,161
+9017,1976103,161
+5243323,1976264,161
+12845378,1976425,187
+8663269,1976612,165
+1865718,1976777,213
+5825318,1976990,175
+6954,1977165,141
+7642588,1977306,124
+1367525,1977430,139
+6665,1977569,158
+7611204,1977727,219
+5539854,1977946,185
+15738295,1978131,185
+15745863,1978316,196
+10269362,1978512,196
+11061306,1978708,196
+12350129,1978904,160
+7927742,1979064,160
+6834328,1979224,160
+3417018,1979384,173
+13942,1979557,139
+16551550,1979696,139
+16543671,1979835,139
+13904911,1979974,139
+4198021,1980113,173
+13154964,1980286,185
+8665144,1980471,185
+10507742,1980656,139
+8451331,1980795,139
+4500213,1980934,139
+14720506,1981073,232
+6044711,1981305,160
+7383116,1981465,166
+8701930,1981631,183
+2417727,1981814,229
+2652910,1982043,139
+8943998,1982182,193
+3168400,1982375,137
+7375821,1982512,167
+9611,1982679,171
+22059,1982850,141
+15269264,1982991,126
+2927684,1983117,158
+13636605,1983275,189
+12346443,1983464,139
+6317061,1983603,130
+1612277,1983733,204
+9667,1983937,126
+3927,1984063,162
+834,1984225,132
+10781289,1984357,134
+1107599,1984491,183
+5044938,1984674,208
+1616885,1984882,172
+11550384,1985054,183
+5521,1985237,120
+6190,1985357,121
+4739,1985478,132
+4601,1985610,132
+4440,1985742,132
+3946,1985874,132
+3682,1986006,132
+3320,1986138,132
+9969,1986270,150
+3673556,1986420,159
+10026420,1986579,166
+14206058,1986745,178
+14220136,1986923,194
+6837128,1987117,136
+9973564,1987253,190
+1360383,1987443,274
+1047,1987717,95
+15530666,1987812,135
+15730566,1987947,184
+53494,1988131,114
+5547545,1988245,196
+2455,1988441,132
+7403,1988573,132
+7191,1988705,132
+6799,1988837,132
+6097,1988969,132
+8946466,1989101,161
+15241993,1989262,161
+5319,1989423,132
+7599,1989555,132
+8955590,1989687,178
+9753705,1989865,141
+8924119,1990006,178
+37068,1990184,168
+2119599,1990352,275
+5561373,1990627,287
+11313683,1990914,196
+3945216,1991110,232
+7131186,1991342,138
+3980760,1991480,164
+3427831,1991644,189
+5783380,1991833,189
+8911,1992022,177
+14948312,1992199,232
+10277682,1992431,148
+3733706,1992579,140
+4469580,1992719,167
+6588826,1992886,189
+8453,1993075,148
+7109,1993223,154
+4775735,1993377,158
+12641325,1993535,252
+9217759,1993787,252
+8656633,1994039,252
+1627847,1994291,252
+7914473,1994543,161
+9181887,1994704,161
+3197944,1994865,161
+10537981,1995026,161
+14966133,1995187,161
+57421,1995348,166
+16296400,1995514,189
+13433344,1995703,189
+7644962,1995892,189
+15735827,1996081,189
+5831899,1996270,154
+11584970,1996424,154
+7608824,1996578,154
+11015858,1996732,189
+6601740,1996921,189
+9488002,1997110,154
+12589786,1997264,123
+49,1997387,152
+3614,1997539,149
+5329,1997688,134
+13390511,1997822,209
+7188,1998031,130
+20566,1998161,130
+4636,1998291,118
+9438135,1998409,118
+2131798,1998527,155
+7648370,1998682,134
+16576850,1998816,135
+4733964,1998951,196
+3185581,1999147,208
+7089,1999355,177
+33015,1999532,166
+12333181,1999698,193
+4762066,1999891,193
+8448547,2000084,193
+10003,2000277,218
+12333182,2000495,153
+562474,2000648,165
+4469448,2000813,165
+3711628,2000978,217
+11838959,2001195,159
+8691044,2001354,152
+4289,2001506,149
+2670235,2001655,165
+16536205,2001820,166
+5268867,2001986,130
+11571490,2002116,130
+16535972,2002246,139
+9983955,2002385,190
+16577832,2002575,187
+41157,2002762,187
+10526234,2002949,134
+1889981,2003083,189
+13687119,2003272,154
+7684,2003426,157
+6340799,2003583,139
+11273345,2003722,242
+6861662,2003964,216
+4229125,2004180,193
+2417265,2004373,189
+12345360,2004562,189
+13696204,2004751,161
+9976206,2004912,161
+4510202,2005073,217
+15791684,2005290,190
+2158972,2005480,196
+3435202,2005676,196
+12852479,2005872,111
+12621607,2005983,221
+14428474,2006204,262
+8153843,2006466,214
+14967377,2006680,208
+4216365,2006888,174
+3700433,2007062,155
+12871998,2007217,149
+38249,2007366,196
+11587405,2007562,169
+2661114,2007731,172
+6708,2007903,189
+4604,2008092,175
+9097,2008267,256
+3990950,2008523,203
+6086000,2008726,207
+3968064,2008933,215
+10512318,2009148,127
+14164127,2009275,155
+9205526,2009430,195
+6880126,2009625,123
+8692020,2009748,123
+10539909,2009871,164
+1316070,2010035,166
+9602,2010201,161
+807169,2010362,123
+2945186,2010485,123
+4767817,2010608,142
+11300795,2010750,154
+7233,2010904,169
+1336072,2011073,173
+7717,2011246,168
+57551,2011414,148
+9456970,2011562,178
+282202,2011740,139
+24753,2011879,148
+5537620,2012027,137
+7087235,2012164,134
+6853072,2012298,154
+14700355,2012452,228
+3698700,2012680,139
+3630,2012819,169
+1631,2012988,129
+8335,2013117,140
+8667254,2013257,111
+7383,2013368,200
+14973,2013568,141
+9488344,2013709,178
+6236,2013887,144
+6725,2014031,134
+8328,2014165,165
+5510009,2014330,193
+6433,2014523,194
+5868,2014717,200
+1941,2014917,177
+16518987,2015094,130
+13928511,2015224,180
+1083598,2015404,213
+6338071,2015617,213
+14458015,2015830,254
+7659455,2016084,174
+15744656,2016258,135
+14210851,2016393,125
+8695128,2016518,196
+5791839,2016714,196
+41204,2016910,94
+11275547,2017004,189
+15782328,2017193,121
+9989429,2017314,154
+8943963,2017468,189
+532337,2017657,252
+6081050,2017909,134
+16527274,2018043,114
+11566704,2018157,141
+32945,2018298,108
+2108920,2018406,170
+1101995,2018576,178
+1222,2018754,154
+1614824,2018908,213
+7610003,2019121,213
+2108679,2019334,161
+14188604,2019495,234
+13530,2019729,189
+3674325,2019918,206
+1623297,2020124,171
+41144,2020295,116
+51339,2020411,141
+2409465,2020552,132
+2892247,2020684,146
+2514,2020830,145
+24598,2020975,114
+9969585,2021089,277
+809630,2021366,147
+11815890,2021513,123
+14434655,2021636,123
+6558245,2021759,142
+7890150,2021901,214
+3981025,2022115,168
+1059507,2022283,219
+4248407,2022502,207
+10753416,2022709,139
+16014473,2022848,123
+2127503,2022971,123
+10247417,2023094,183
+4561,2023277,150
+10016390,2023427,170
+9225825,2023597,156
+8953988,2023753,164
+15250092,2023917,123
+14981753,2024040,123
+3189214,2024163,139
+15735660,2024302,197
+10533357,2024499,118
+9750880,2024617,250
+7652144,2024867,248
+4210572,2025115,252
+14463924,2025367,235
+7483,2025602,135
+7677,2025737,135
+7739,2025872,135
+7844,2026007,135
+9932,2026142,135
+3821,2026277,135
+4990328,2026412,129
+12371675,2026541,129
+6334718,2026670,102
+4511,2026772,135
+6678,2026907,135
+6793,2027042,135
+6876,2027177,135
+9679,2027312,135
+8619,2027447,135
+8158,2027582,135
+8159,2027717,135
+5536117,2027852,128
+11041593,2027980,142
+9340,2028122,135
+8806,2028257,135
+8702,2028392,136
+12875691,2028528,243
+3018,2028771,152
+7349593,2028923,178
+6323933,2029101,134
+11051145,2029235,147
+4732511,2029382,214
+7456,2029596,182
+538429,2029778,160
+816573,2029938,141
+3149123,2030079,140
+14,2030219,160
+2909,2030379,160
+12880101,2030539,160
+525697,2030699,123
+3571,2030822,122
+8432812,2030944,137
+3510,2031081,117
+2807,2031198,118
+13893929,2031316,119
+7424,2031435,143
+8406,2031578,143
+57443,2031721,154
+16566068,2031875,160
+8660443,2032035,160
+11594865,2032195,160
+14964920,2032355,160
+560172,2032515,160
+6600787,2032675,161
+3708054,2032836,161
+5265087,2032997,175
+9499050,2033172,175
+1079217,2033347,175
+8135,2033522,210
+10787416,2033732,161
+585355,2033893,161
+828458,2034054,197
+7619978,2034251,160
+6085782,2034411,181
+7614832,2034592,171
+6698,2034763,170
+8922412,2034933,169
+4242017,2035102,184
+4597,2035286,155
+5859,2035441,154
+15219167,2035595,163
+1885756,2035758,169
+1606591,2035927,169
+6876483,2036096,133
+7383730,2036229,133
+5228,2036362,122
+7722,2036484,122
+6221,2036606,122
+1038,2036728,110
+10274726,2036838,116
+10511249,2036954,122
+2155818,2037076,122
+4494588,2037198,122
+2100424,2037320,122
+12863295,2037442,196
+7619585,2037638,122
+14717429,2037760,122
+3974,2037882,138
+9426,2038020,163
+11857588,2038183,177
+14967881,2038360,139
+4258953,2038499,139
+2924127,2038638,139
+9782,2038777,139
+7361,2038916,139
+7770,2039055,139
+4977,2039194,139
+9198,2039333,139
+6878,2039472,139
+7624210,2039611,139
+20707,2039750,139
+8502,2039889,139
+5670,2040028,139
+6566,2040167,139
+15255375,2040306,179
+13652809,2040485,182
+15267620,2040667,158
+6075684,2040825,183
+9486613,2041008,183
+13652322,2041191,183
+1572909,2041374,183
+2625020,2041557,173
+4881,2041730,139
+13688730,2041869,192
+1861021,2042061,192
+3150003,2042253,186
+7346692,2042439,163
+4772388,2042602,180
+2123933,2042782,180
+9455,2042962,183
+9703,2043145,183
+5773068,2043328,183
+5816,2043511,183
+8175537,2043694,139
+524358,2043833,149
+15527950,2043982,134
+57496,2044116,117
+7658218,2044233,130
+9734165,2044363,161
+13689930,2044524,178
+3690480,2044702,170
+15234278,2044872,136
+8416,2045008,155
+9826,2045163,155
+9555,2045318,136
+6462,2045454,136
+2087,2045590,147
+7614312,2045737,163
+4986019,2045900,218
+5026024,2046118,276
+14190549,2046394,178
+62091,2046572,141
+3466925,2046713,139
+528790,2046852,139
+1588642,2046991,139
+8428320,2047130,139
+8980,2047269,139
+3408518,2047408,139
+7359,2047547,139
+11843190,2047686,139
+3975668,2047825,139
+12094048,2047964,139
+7929687,2048103,139
+10243638,2048242,139
+3412968,2048381,139
+10000,2048520,139
+10784266,2048659,152
+11283310,2048811,139
+10237315,2048950,156
+12607768,2049106,252
+12069490,2049358,117
+16310393,2049475,190
+13419498,2049665,190
+4225130,2049855,200
+6609,2050055,139
+6610,2050194,139
+6945,2050333,139
+1638159,2050472,139
+3464730,2050611,139
+15249916,2050750,139
+13385090,2050889,139
+7996,2051028,139
+8981,2051167,139
+5743,2051306,139
+2698,2051445,141
+7433,2051586,127
+9134,2051713,126
+12333147,2051839,126
+3704322,2051965,128
+4220323,2052093,178
+13640210,2052271,154
+1050403,2052425,154
+10768169,2052579,154
+7665883,2052733,154
+10763258,2052887,154
+12110394,2053041,117
+15529147,2053158,117
+13942489,2053275,117
+6475,2053392,148
+7796,2053540,148
+3685320,2053688,124
+6356512,2053812,126
+9302,2053938,126
+12616458,2054064,123
+6207,2054187,126
+3414,2054313,117
+1580664,2054430,171
+14263,2054601,171
+21693,2054772,123
+7756,2054895,193
+2145142,2055088,158
+3988873,2055246,178
+1573347,2055424,132
+1347970,2055556,163
+1597996,2055719,177
+3965400,2055896,177
+4256257,2056073,171
+13665456,2056244,171
+14177338,2056415,144
+6593678,2056559,144
+1060527,2056703,144
+8163044,2056847,144
+11857620,2056991,144
+13645665,2057135,144
+13123225,2057279,144
+4233294,2057423,144
+6123,2057567,144
+6118,2057711,144
+12905914,2057855,144
+6194,2057999,144
+3943863,2058143,144
+5530841,2058287,177
+6491,2058464,157
+3901,2058621,181
+2415121,2058802,120
+15475328,2058922,167
+10260121,2059089,137
+9460143,2059226,144
+12347945,2059370,144
+8683072,2059514,144
+5941,2059658,158
+7646303,2059816,279
+3721946,2060095,123
+13677375,2060218,242
+12374483,2060460,224
+14171241,2060684,240
+16053720,2060924,139
+9197467,2061063,178
+22956,2061241,127
+4249685,2061368,154
+3451703,2061522,123
+2359482,2061645,206
+2416490,2061851,206
+7900023,2062057,134
+11583632,2062191,210
+9469793,2062401,193
+787765,2062594,127
+12354471,2062721,241
+12381219,2062962,254
+1617761,2063216,123
+6093112,2063339,123
+36969,2063462,137
+6579355,2063599,137
+15735853,2063736,137
+3177566,2063873,137
+11273927,2064010,144
+15220476,2064154,139
+9440715,2064293,139
+7629,2064432,139
+7634,2064571,139
+9177588,2064710,139
+8935406,2064849,159
+1056628,2065008,137
+39938,2065145,137
+16043590,2065282,137
+14482178,2065419,159
+5685,2065578,137
+2247,2065715,137
+4323,2065852,137
+2179,2065989,130
+10496952,2066119,137
+6587,2066256,137
+7977,2066393,137
+8538,2066530,137
+9085,2066667,137
+15265029,2066804,139
+7902852,2066943,139
+13395373,2067082,139
+9813,2067221,137
+3485,2067358,137
+5472,2067495,137
+8315,2067632,139
+4469,2067771,147
+7867576,2067918,139
+1596943,2068057,139
+2916696,2068196,193
+8389343,2068389,150
+12398,2068539,146
+3951250,2068685,137
+8158525,2068822,206
+4489957,2069028,196
+9038,2069224,193
+2892602,2069417,137
+2647,2069554,135
+487,2069689,147
+486,2069836,147
+9078,2069983,135
+3729368,2070118,135
+1607574,2070253,156
+11849462,2070409,156
+9231572,2070565,137
+13945327,2070702,137
+16520628,2070839,137
+3975210,2070976,137
+15490851,2071113,261
+294224,2071374,276
+5566462,2071650,162
+9701687,2071812,175
+15224272,2071987,196
+804282,2072183,196
+2134127,2072379,234
+7136182,2072613,166
+14471969,2072779,172
+7107303,2072951,123
+7609266,2073074,123
+7137395,2073197,235
+12873247,2073432,229
+5307012,2073661,231
+4502317,2073892,231
+13386851,2074123,123
+8922515,2074246,231
+8161,2074477,193
+14179660,2074670,203
+10548161,2074873,264
+7439,2075137,167
+9165,2075304,198
+9455770,2075502,193
+29132,2075695,193
+11557735,2075888,196
+13410851,2076084,196
+7891593,2076280,196
+3687944,2076476,158
+5024778,2076634,158
+11842402,2076792,158
+11564501,2076950,158
+13636938,2077108,159
+9965,2077267,195
+24663,2077462,172
+7880275,2077634,121
+6651,2077755,121
+1358184,2077876,196
+6093162,2078072,196
+540302,2078268,193
+8851,2078461,195
+1091024,2078656,177
+5285675,2078833,196
+841405,2079029,196
+63516,2079225,196
+555596,2079421,213
+11330069,2079634,184
+3435475,2079818,184
+7369276,2080002,184
+11331707,2080186,236
+16268799,2080422,236
+2645979,2080658,236
+4214158,2080894,236
+5002393,2081130,236
+16031731,2081366,196
+2361749,2081562,196
+8706988,2081758,196
+9729835,2081954,196
+13910256,2082150,196
+262687,2082346,196
+1101230,2082542,122
+297493,2082664,122
+11841559,2082786,122
+9501531,2082908,122
+13169670,2083030,122
+7361221,2083152,122
+16258375,2083274,122
+5267844,2083396,122
+1595702,2083518,219
+2140035,2083737,149
+2100167,2083886,198
+16272063,2084084,198
+7919442,2084282,191
+1066880,2084473,191
+5540248,2084664,191
+1037,2084855,122
+7383267,2084977,189
+16312337,2085166,198
+16295007,2085364,219
+6556032,2085583,219
+9700508,2085802,172
+6852484,2085974,172
+3199358,2086146,198
+20669,2086344,141
+36975,2086485,141
+7657194,2086626,128
+2134344,2086754,128
+5523990,2086882,128
+14692205,2087010,142
+5805854,2087152,142
+11856304,2087294,142
+2098,2087436,142
+1612893,2087578,142
+6071434,2087720,142
+1842566,2087862,142
+6320988,2088004,142
+3450958,2088146,142
+5535770,2088288,142
+24668,2088430,147
+1729,2088577,147
+57364,2088724,147
+14460404,2088871,142
+5249023,2089013,142
+7344220,2089155,142
+1110801,2089297,142
+20720,2089439,145
+20500,2089584,143
+37106,2089727,143
+844004,2089870,139
+7643878,2090009,142
+12382706,2090151,142
+13107332,2090293,142
+4237032,2090435,142
+3179945,2090577,141
+12073057,2090718,142
+5769760,2090860,142
+2899663,2091002,142
+11557191,2091144,303
+3433096,2091447,142
+13424833,2091589,142
+8130254,2091731,142
+10546425,2091873,142
+5277577,2092015,142
+3677210,2092157,142
+12347164,2092299,142
+6471,2092441,134
+6201,2092575,133
+8725,2092708,141
+14732110,2092849,165
+5536873,2093014,142
+5937,2093156,167
+14470849,2093323,142
+10246061,2093465,142
+6356677,2093607,123
+14951911,2093730,123
+12358251,2093853,123
+1055756,2093976,123
+524295,2094099,123
+16534,2094222,140
+3208973,2094362,142
+15230281,2094504,142
+11566407,2094646,142
+3730712,2094788,142
+3678294,2094930,142
+4248365,2095072,123
+12856323,2095195,123
+9447396,2095318,123
+1088221,2095441,123
+5775274,2095564,123
+8963683,2095687,123
+8027,2095810,123
+9270,2095933,123
+9547,2096056,123
+5835,2096179,123
+6130,2096302,123
+8154466,2096425,123
+2148816,2096548,123
+6854267,2096671,123
+8715518,2096794,123
+14977919,2096917,123
+34917,2097040,123
+12336047,2097163,123
+3989618,2097286,123
+3688524,2097409,123
+10774278,2097532,123
+9197687,2097655,123
+8187999,2097778,123
+8407409,2097901,123
+7093869,2098024,123
+12347256,2098147,123
+14209483,2098270,123
+11074264,2098393,123
+12064706,2098516,123
+8131006,2098639,123
+2635575,2098762,123
+5302998,2098885,123
+10016443,2099008,123
+1613564,2099131,123
+11325276,2099254,123
+8388718,2099377,123
+8687116,2099500,123
+3937730,2099623,123
+7106719,2099746,123
+12645115,2099869,123
+2417428,2099992,123
+8447568,2100115,123
+9502049,2100238,123
+553029,2100361,123
+11044872,2100484,123
+10797921,2100607,123
+2945262,2100730,123
+6068211,2100853,123
+13956207,2100976,123
+6583994,2101099,123
+3465981,2101222,123
+280730,2101345,123
+15791644,2101468,123
+9185591,2101591,123
+11575226,2101714,123
+806377,2101837,123
+14742982,2101960,123
+10546637,2102083,123
+15790665,2102206,208
+2643902,2102414,204
+6092250,2102618,123
+1633897,2102741,123
+6593214,2102864,123
+15767999,2102987,123
+9759082,2103110,123
+11282746,2103233,123
+10288129,2103356,123
+10237419,2103479,123
+4735868,2103602,123
+3449749,2103725,123
+7896673,2103848,123
+6354973,2103971,123
+3721606,2104094,123
+13644561,2104217,123
+5274197,2104340,123
+13157062,2104463,266
+7904389,2104729,149
+7657418,2104878,166
+5800616,2105044,125
+5793885,2105169,155
+5524364,2105324,137
+14482951,2105461,168
+7371064,2105629,234
+2371972,2105863,155
+5778395,2106018,107
+14694006,2106125,196
+15480975,2106321,196
+13647452,2106517,196
+12885569,2106713,140
+12063721,2106853,149
+8435465,2107002,147
+15732060,2107149,185
+5553747,2107334,178
+2625163,2107512,211
+16010544,2107723,181
+820752,2107904,137
+3724299,2108041,161
+15219218,2108202,161
+2415259,2108363,193
+3203216,2108556,154
+10804414,2108710,196
+15513712,2108906,198
+9747374,2109104,130
+13896361,2109234,139
+2112870,2109373,139
+13931752,2109512,196
+11565296,2109708,267
+2137037,2109975,123
+3184099,2110098,228
+8414573,2110326,161
+16576822,2110487,175
+12093063,2110662,174
+1608027,2110836,161
+5785893,2110997,138
+9761400,2111135,135
+2635539,2111270,309
+562415,2111579,258
+14692766,2111837,142
+3955907,2111979,238
+12886003,2112217,196
+7900723,2112413,197
+15527640,2112610,177
+8448887,2112787,180
+4733300,2112967,257
+3211254,2113224,254
+14217165,2113478,109
+5031553,2113587,197
+4776516,2113784,193
+8170277,2113977,166
+11551005,2114143,165
+16301833,2114308,196
+8172124,2114504,145
+14474096,2114649,211
+8391505,2114860,196
+16256352,2115056,135
+15734827,2115191,135
+3441140,2115326,150
+8167991,2115476,172
+13894861,2115648,139
+5785634,2115787,183
+7631670,2115970,140
+3681144,2116110,197
+10779436,2116307,114
+2418090,2116421,167
+7912892,2116588,175
+3447643,2116763,139
+8929623,2116902,241
+14195252,2117143,193
+10528348,2117336,151
+4739187,2117487,149
+15218554,2117636,187
+8403754,2117823,202
+12904989,2118025,136
+8190222,2118161,161
+5304531,2118322,161
+42884,2118483,164
+8655262,2118647,161
+1350160,2118808,149
+3734218,2118957,212
+6075454,2119169,196
+7370625,2119365,193
+5562688,2119558,122
+14979198,2119680,193
+7629370,2119873,136
+9742263,2120009,178
+1590502,2120187,178
+3984917,2120365,147
+2651664,2120512,117
+2152282,2120629,181
+15996259,2120810,146
+9210755,2120956,130
+4198876,2121086,133
+1868609,2121219,276
+532459,2121495,133
+7888716,2121628,196
+3460136,2121824,166
+5563080,2121990,301
+7085680,2122291,220
+5552138,2122511,189
+14200285,2122700,146
+8926142,2122846,124
+14978444,2122970,128
+7366777,2123098,185
+1093496,2123283,226
+13375912,2123509,179
+11842149,2123688,159
+14693728,2123847,174
+3984252,2124021,172
+2399915,2124193,196
+2378499,2124389,175
+14995056,2124564,167
+8131021,2124731,144
+13411503,2124875,197
+1059971,2125072,103
+7120735,2125175,178
+9206119,2125353,178
+7887091,2125531,177
+7380111,2125708,118
+32342,2125826,189
+7660172,2126015,149
+29122,2126164,168
+8159860,2126332,211
+9753623,2126543,152
+2378625,2126695,161
+7360102,2126856,248
+14177699,2127104,178
+3725359,2127282,178
+15759705,2127460,167
+14716476,2127627,160
+8670135,2127787,232
+6877372,2128019,206
+3149539,2128225,141
+1634629,2128366,162
+11316159,2128528,160
+2655482,2128688,149
+6336365,2128837,161
+12081779,2128998,161
+3939844,2129159,189
+6347168,2129348,238
+6863235,2129586,135
+7910329,2129721,249
+311452,2129970,135
+9969146,2130105,175
+1599618,2130280,172
+15499273,2130452,132
+5287381,2130584,139
+11552025,2130723,172
+14191964,2130895,149
+7612847,2131044,193
+3938831,2131237,125
+15256600,2131362,189
+11571511,2131551,174
+9176401,2131725,127
+14194618,2131852,168
+11065482,2132020,105
+4254414,2132125,219
+8687327,2132344,183
+10788169,2132527,133
+12597398,2132660,193
+2904201,2132853,222
+9735817,2133075,183
+44794,2133258,178
+8656934,2133436,128
+16312579,2133564,189
+15242758,2133753,245
+1867345,2133998,139
+6845148,2134137,179
+3176395,2134316,195
+2398189,2134511,216
+9477939,2134727,158
+6292503,2134885,149
+2127507,2135034,187
+542294,2135221,128
+15481946,2135349,255
+4491467,2135604,144
+7126965,2135748,186
+5253453,2135934,222
+839633,2136156,189
+7650011,2136345,291
+12120855,2136636,216
+9238547,2136852,135
+5545781,2136987,117
+2376380,2137104,157
+16262209,2137261,151
+1083931,2137412,186
+1060715,2137598,149
+9220244,2137747,161
+9720979,2137908,128
+6877293,2138036,180
+16001107,2138216,270
+13954182,2138486,213
+1874982,2138699,146
+288645,2138845,240
+13695517,2139085,182
+11276755,2139267,242
+8663786,2139509,180
+14687544,2139689,197
+14974898,2139886,160
+16543168,2140046,131
+2412863,2140177,138
+7873711,2140315,167
+16556001,2140482,206
+12098532,2140688,172
+11017053,2140860,156
+5263461,2141016,138
+4245034,2141154,268
+15209742,2141422,131
+12861954,2141553,161
+11841135,2141714,188
+9493098,2141902,164
+14439292,2142066,189
+4499173,2142255,211
+10771873,2142466,139
+830469,2142605,183
+5009006,2142788,182
+9188183,2142970,225
+3975743,2143195,127
+800830,2143322,200
+6344105,2143522,152
+12102974,2143674,125
+1585161,2143799,197
+7658449,2143996,117
+3192305,2144113,171
+11538497,2144284,193
+8432999,2144477,190
+1627574,2144667,134
+6041177,2144801,161
+11068729,2144962,154
+5551955,2145116,208
+1060935,2145324,161
+16286962,2145485,161
+11564365,2145646,114
+14732270,2145760,161
+4995337,2145921,186
+9469626,2146107,246
+10486492,2146353,141
+5515938,2146494,200
+8688780,2146694,208
+11073504,2146902,175
+4490945,2147077,166
+4212186,2147243,227
+3428778,2147470,171
+10010260,2147641,125
+7084431,2147766,189
+13172599,2147955,135
+11837100,2148090,138
+13371364,2148228,303
+12872628,2148531,115
+812028,2148646,190
+13951118,2148836,220
+13147933,2149056,221
+1326578,2149277,206
+2898369,2149483,133
+5566069,2149616,230
+554230,2149846,180
+14174511,2150026,135
+8392228,2150161,126
+3941847,2150287,131
+3188955,2150418,183
+1638190,2150601,282
+8679943,2150883,210
+13411860,2151093,182
+9499056,2151275,189
+5016368,2151464,155
+525773,2151619,217
+5558627,2151836,143
+4765095,2151979,186
+806746,2152165,133
+13902414,2152298,133
+10258138,2152431,155
+2885436,2152586,149
+8133123,2152735,163
+11319385,2152898,154
+2923172,2153052,130
+8958433,2153182,148
+9493318,2153330,173
+3428188,2153503,122
+6309844,2153625,188
+16578743,2153813,156
+3208239,2153969,135
+7360001,2154104,173
+7629455,2154277,160
+5546779,2154437,195
+13384076,2154632,122
+1581222,2154754,152
+2157255,2154906,270
+6599536,2155176,162
+6092045,2155338,182
+7642194,2155520,193
+12855581,2155713,215
+7102236,2155928,205
+8185002,2156133,60
+540478,2156193,121
+2921855,2156314,178
+3935304,2156492,130
+1105636,2156622,147
+15743563,2156769,139
+10544211,2156908,183
+4213272,2157091,149
+12633449,2157240,184
+12894382,2157424,148
+11322773,2157572,149
+8184319,2157721,209
+14161165,2157930,252
+5787819,2158182,134
+8178961,2158316,110
+10026858,2158426,171
+12327527,2158597,161
+5035958,2158758,149
+8660388,2158907,134
+4734258,2159041,168
+13403500,2159209,216
+11299756,2159425,129
+14216824,2159554,140
+2363720,2159694,130
+12862956,2159824,162
+14738993,2159986,182
+7910866,2160168,179
+5303672,2160347,194
+9437834,2160541,229
+1884442,2160770,120
+16517592,2160890,128
+7618251,2161018,140
+8143948,2161158,178
+279713,2161336,143
+2147853,2161479,199
+3721879,2161678,139
+12332440,2161817,131
+1604002,2161948,146
+14731370,2162094,178
+12381819,2162272,167
+3412904,2162439,151
+8165219,2162590,145
+4760247,2162735,123
+13399192,2162858,141
+547552,2162999,175
+2156433,2163174,171
+563032,2163345,250
+16521680,2163595,191
+9733844,2163786,201
+10278467,2163987,189
+3938464,2164176,289
+9219721,2164465,139
+9759116,2164604,114
+16572889,2164718,163
+5251179,2164881,207
+8175496,2165088,119
+6347562,2165207,158
+11552069,2165365,146
+13168245,2165511,167
+13382697,2165678,252
+6601405,2165930,150
+2410568,2166080,131
+13433701,2166211,163
+10527292,2166374,104
+6880435,2166478,171
+9749476,2166649,148
+3442781,2166797,132
+8935277,2166929,165
+12337408,2167094,148
+16570391,2167242,223
+6827484,2167465,243
+15229215,2167708,187
+2639786,2167895,131
+6084127,2168026,135
+7362903,2168161,170
+10241085,2168331,179
+11805927,2168510,177
+5517193,2168687,158
+9476374,2168845,158
+41727,2169003,130
+6300865,2169133,198
+10490941,2169331,118
+16522239,2169449,112
+16001174,2169561,194
+7916339,2169755,150
+6334896,2169905,168
+5253063,2170073,139
+7101109,2170212,218
+3693224,2170430,220
+16032404,2170650,196
+15482377,2170846,183
+9731134,2171029,146
+3449791,2171175,161
+9177227,2171336,149
+11812411,2171485,133
+810200,2171618,142
+3937770,2171760,157
+15205392,2171917,60
+16039292,2171977,238
+14468130,2172215,166
+13169515,2172381,135
+10025153,2172516,167
+7131568,2172683,203
+10810658,2172886,153
+8674451,2173039,144
+6873446,2173183,60
+12331991,2173243,179
+2649495,2173422,159
+2419926,2173581,210
+13380224,2173791,211
+6356729,2174002,131
+12115079,2174133,140
+8155128,2174273,215
+14481237,2174488,135
+6029930,2174623,159
+824065,2174782,172
+7628336,2174954,125
+7123792,2175079,168
+3693048,2175247,134
+5037885,2175381,203
+15241752,2175584,154
+30177,2175738,134
+13920913,2175872,133
+10014132,2176005,145
+10756869,2176150,158
+1853689,2176308,133
+11599549,2176441,60
+6318491,2176501,133
+13948173,2176634,146
+3460461,2176780,149
+15004643,2176929,176
+9455287,2177105,126
+315173,2177231,146
+8436715,2177377,147
+46989,2177524,198
+6356510,2177722,168
+11555004,2177890,234
+8658470,2178124,175
+11809900,2178299,227
+34464,2178526,60
+10509089,2178586,121
+5290146,2178707,160
+11553797,2178867,175
+11565372,2179042,122
+10243775,2179164,121
+3450947,2179285,168
+7653925,2179453,136
+6071275,2179589,137
+13153139,2179726,143
+797415,2179869,237
+9973873,2180106,155
+13931812,2180261,144
+9719879,2180405,158
+14692816,2180563,189
+5509423,2180752,172
+5002680,2180924,161
+557113,2181085,134
+14956786,2181219,142
+12896085,2181361,200
+798089,2181561,170
+11063862,2181731,156
+9965716,2181887,204
+10810305,2182091,184
+1315632,2182275,124
+848901,2182399,196
+5267926,2182595,132
+14446612,2182727,60
+7900663,2182787,208
+2892895,2182995,119
+9459346,2183114,120
+311208,2183234,153
+9226192,2183387,187
+12103278,2183574,163
+13691651,2183737,264
+6831852,2184001,120
+12854824,2184121,128
+3189437,2184249,225
+10795032,2184474,242
+12602871,2184716,124
+820356,2184840,162
+22791,2185002,151
+5285653,2185153,127
+787456,2185280,130
+6847701,2185410,159
+9468657,2185569,109
+2930323,2185678,120
+11035050,2185798,146
+16519558,2185944,128
+14686327,2186072,160
+14964648,2186232,168
+7903590,2186400,195
+2673643,2186595,115
+8167773,2186710,130
+3934238,2186840,202
+16537850,2187042,238
+5033012,2187280,151
+13685873,2187431,162
+551120,2187593,143
+13902399,2187736,276
+13168294,2188012,208
+2392490,2188220,181
+11288866,2188401,168
+6854632,2188569,210
+15263861,2188779,164
+13110933,2188943,127
+3147100,2189070,165
+528040,2189235,143
+12108911,2189378,157
+14200878,2189535,232
+12902450,2189767,152
+5827348,2189919,169
+12867778,2190088,231
+13684193,2190319,162
+6086858,2190481,233
+14713207,2190714,139
+10262545,2190853,231
+12083345,2191084,201
+9205441,2191285,143
+9176972,2191428,138
+16310184,2191566,178
+11048368,2191744,142
+1068407,2191886,171
+12869080,2192057,140
+12905443,2192197,126
+9729390,2192323,144
+4987541,2192467,162
+6339340,2192629,215
+10759176,2192844,152
+1096190,2192996,122
+3151128,2193118,169
+8656661,2193287,163
+8687254,2193450,156
+6592928,2193606,129
+586167,2193735,148
+12600547,2193883,204
+1594639,2194087,134
+1604243,2194221,177
+8947677,2194398,149
+3196970,2194547,140
+8954828,2194687,155
+12624071,2194842,150
+14461321,2194992,119
+10486627,2195111,175
+13677720,2195286,185
+14701975,2195471,197
+8143759,2195668,170
+10543706,2195838,141
+13897650,2195979,159
+4496248,2196138,119
+15791721,2196257,160
+7903580,2196417,234
+8691141,2196651,153
+5769539,2196804,60
+15531093,2196864,155
+1583739,2197019,163
+6880149,2197182,183
+16314498,2197365,141
+6064596,2197506,195
+5509471,2197701,124
+9219660,2197825,147
+837205,2197972,198
+2371578,2198170,156
+14980782,2198326,140
+4989528,2198466,133
+16028774,2198599,151
+16011796,2198750,171
+1873311,2198921,183
+557556,2199104,137
+1111194,2199241,127
+3954621,2199368,148
+322021,2199516,133
+6339985,2199649,130
+13388795,2199779,138
+7122415,2199917,170
+7626670,2200087,135
+6836663,2200222,153
+7613706,2200375,144
+7401957,2200519,124
+12626536,2200643,152
+8968124,2200795,126
+4741695,2200921,123
+6339660,2201044,173
+1839585,2201217,146
+5260893,2201363,167
+7651233,2201530,168
+13379117,2201698,129
+3967717,2201827,217
+2906787,2202044,162
+3465423,2202206,178
+571192,2202384,157
+16296586,2202541,202
+8126855,2202743,149
+5568102,2202892,179
+3459075,2203071,132
+15753050,2203203,191
+8396202,2203394,122
+8128811,2203516,115
+8661948,2203631,140
+11796636,2203771,127
+2662111,2203898,182
+8404950,2204080,134
+7881733,2204214,218
+281168,2204432,274
+842177,2204706,152
+3712438,2204858,211
+6859658,2205069,125
+2420282,2205194,209
+837226,2205403,132
+7612220,2205535,196
+556222,2205731,132
+15205619,2205863,148
+551146,2206011,162
+16261765,2206173,187
+12889377,2206360,179
+15227888,2206539,132
+10750957,2206671,176
+7349139,2206847,133
+6608916,2206980,141
+16277290,2207121,132
+12859603,2207253,162
+5254862,2207415,154
+11277522,2207569,130
+10243246,2207699,117
+2146735,2207816,187
+8432292,2208003,116
+3190518,2208119,130
+547598,2208249,136
+15483632,2208385,159
+15256481,2208544,132
+7136462,2208676,151
+6594551,2208827,118
+13406507,2208945,192
+12607097,2209137,234
+5816298,2209371,141
+12845489,2209512,134
+12634438,2209646,156
+16015373,2209802,155
+11021270,2209957,174
+11325219,2210131,194
+6328452,2210325,119
+16522585,2210444,148
+7914667,2210592,210
+11577454,2210802,137
+8399610,2210939,148
+1589789,2211087,60
+2672916,2211147,146
+7639972,2211293,169
+14971269,2211462,138
+527561,2211600,170
+6557332,2211770,159
+832751,2211929,224
+1337867,2212153,203
+16027882,2212356,146
+6090361,2212502,175
+5024278,2212677,214
+11288810,2212891,175
+10927,2213066,146
+1892709,2213212,175
+4200186,2213387,127
+791307,2213514,131
+2905133,2213645,141
+12325889,2213786,208
+9751055,2213994,143
+7873860,2214137,141
+10754165,2214278,141
+13151900,2214419,196
+11288484,2214615,147
+7122571,2214762,138
+4238477,2214900,145
+8441521,2215045,167
+16525908,2215212,144
+285702,2215356,160
+7633786,2215516,150
+4778595,2215666,203
+15240693,2215869,141
+9500463,2216010,177
+13653893,2216187,160
+4229895,2216347,155
+2638113,2216502,147
+3687820,2216649,186
+1107119,2216835,120
+16050791,2216955,141
+2895176,2217096,142
+2669080,2217238,129
+11287925,2217367,228
+10522846,2217595,143
+6565303,2217738,150
+10858,2217888,141
+16004833,2218029,154
+7871578,2218183,155
+15207541,2218338,126
+8391174,2218464,151
+6327339,2218615,147
+9699440,2218762,132
+12332117,2218894,144
+816419,2219038,187
+323617,2219225,139
+2627837,2219364,164
+14203150,2219528,185
+3420014,2219713,150
+13430489,2219863,151
+23729,2220014,220
+11570714,2220234,169
+14215506,2220403,126
+12362977,2220529,108
+9473999,2220637,177
+4253587,2220814,253
+2097,2221067,141
+3461275,2221208,174
+15728767,2221382,175
+3191714,2221557,259
+5267496,2221816,144
+37370,2221960,150
+10508964,2222110,157
+15789755,2222267,143
+7137543,2222410,132
+15006237,2222542,173
+1858645,2222715,147
+3455642,2222862,169
+5268545,2223031,112
+10231773,2223143,142
+8183057,2223285,218
+12123442,2223503,201
+7401040,2223704,129
+9980487,2223833,137
+1329528,2223970,153
+2887873,2224123,163
+9228667,2224286,167
+5251687,2224453,122
+3959421,2224575,172
+3960921,2224747,136
+5252752,2224883,160
+2405975,2225043,141
+13152064,2225184,191
+4233292,2225375,139
+6035637,2225514,150
+6611297,2225664,130
+8922110,2225794,152
+12098285,2225946,155
+13139319,2226101,279
+9743969,2226380,133
+6082221,2226513,150
+11293932,2226663,168
+7378774,2226831,163
+12067047,2226994,311
+52624,2227305,132
+8153938,2227437,128
+25766,2227565,144
+9997229,2227709,139
+13912926,2227848,151
+6557238,2227999,98
+9706780,2228097,149
+14964202,2228246,156
+11558117,2228402,132
+3441374,2228534,115
+5005266,2228649,143
+2672408,2228792,132
+8146008,2228924,158
+1053678,2229082,182
+9185053,2229264,121
+3694711,2229385,168
+7373061,2229553,141
+14740762,2229694,186
+13956671,2229880,128
+5812436,2230008,164
+6575487,2230172,214
+2095,2230386,141
+10274769,2230527,155
+1347728,2230682,195
+3726944,2230877,145
+2636263,2231022,192
+6839915,2231214,179
+2148531,2231393,181
+16312245,2231574,173
+13946552,2231747,132
+8419967,2231879,243
+2415286,2232122,204
+11566434,2232326,160
+12121575,2232486,133
+12065177,2232619,111
+3417437,2232730,210
+5023563,2232940,133
+13644048,2233073,247
+1892754,2233320,140
+7368577,2233460,60
+16515090,2233520,281
+1578016,2233801,121
+11305459,2233922,132
+3172492,2234054,154
+1109721,2234208,159
+9756174,2234367,120
+12593651,2234487,124
+11291390,2234611,235
+5567926,2234846,187
+9450539,2235033,143
+9222188,2235176,158
+8420835,2235334,210
+14423898,2235544,202
+13148602,2235746,133
+12860063,2235879,136
+6843939,2236015,115
+14479453,2236130,148
+6035143,2236278,140
+8687465,2236418,117
+3934573,2236535,136
+9440614,2236671,172
+823886,2236843,157
+16028769,2237000,135
+12111271,2237135,146
+5518815,2237281,137
+16006528,2237418,163
+15784752,2237581,132
+10236342,2237713,165
+10793834,2237878,158
+14998905,2238036,143
+15256626,2238179,117
+13908713,2238296,206
+5806133,2238502,136
+9198753,2238638,146
+1635920,2238784,165
+6849648,2238949,150
+4775163,2239099,132
+2144192,2239231,140
+8411333,2239371,172
+12109590,2239543,199
+13904957,2239742,210
+10770972,2239952,165
+8414297,2240117,138
+9210277,2240255,151
+11838889,2240406,125
+15254304,2240531,193
+12859098,2240724,155
+275188,2240879,131
+1841226,2241010,242
+801110,2241252,161
+14460605,2241413,213
+1099142,2241626,177
+1078922,2241803,123
+16011005,2241926,231
+2406610,2242157,200
+10787201,2242357,184
+12073595,2242541,164
+1312736,2242705,126
+14471060,2242831,207
+10804014,2243038,161
+13172272,2243199,215
+14997277,2243414,147
+2410974,2243561,162
+5506399,2243723,133
+7101795,2243856,253
+9705075,2244109,159
+6051565,2244268,201
+7864975,2244469,215
+14423714,2244684,142
+3181819,2244826,120
+13691806,2244946,152
+12373317,2245098,118
+1326688,2245216,114
+7353045,2245330,168
+7885068,2245498,118
+4500200,2245616,171
+13904050,2245787,137
+8660942,2245924,292
+4774142,2246216,177
+13931610,2246393,152
+3165310,2246545,224
+6091271,2246769,144
+11807289,2246913,151
+7399491,2247064,246
+2916047,2247310,122
+1062673,2247432,125
+5301577,2247557,145
+11843725,2247702,131
+5010341,2247833,111
+7382044,2247944,193
+12368841,2248137,158
+14953171,2248295,165
+15220406,2248460,112
+12334565,2248572,153
+10247573,2248725,170
+12101807,2248895,132
+6354547,2249027,163
+2673919,2249190,159
+9764125,2249349,142
+4982729,2249491,161
+16283291,2249652,158
+7647244,2249810,168
+15220800,2249978,141
+14196153,2250119,193
+4217499,2250312,108
+14707093,2250420,168
+8707645,2250588,162
+13661630,2250750,122
+12349046,2250872,180
+15214805,2251052,162
+16308980,2251214,220
+579008,2251434,186
+7091113,2251620,135
+1084623,2251755,141
+14214062,2251896,147
+571372,2252043,135
+1617823,2252178,175
+45890,2252353,177
+1897959,2252530,163
+9965284,2252693,60
+4488613,2252753,206
+839123,2252959,169
+14969889,2253128,132
+45107,2253260,165
+530229,2253425,141
+13147165,2253566,141
+14956503,2253707,146
+14721495,2253853,142
+9732516,2253995,142
+12378269,2254137,123
+10232334,2254260,143
+8183184,2254403,212
+801893,2254615,128
+13164412,2254743,132
+11816130,2254875,146
+4770670,2255021,162
+12338039,2255183,221
+13399657,2255404,129
+11280554,2255533,157
+16559978,2255690,120
+3436434,2255810,150
+3456505,2255960,188
+13418097,2256148,130
+804509,2256278,125
+11573986,2256403,144
+1371805,2256547,170
+7917572,2256717,174
+8951225,2256891,178
+14220943,2257069,167
+8948761,2257236,152
+4492370,2257388,148
+28155,2257536,185
+8657032,2257721,137
+9463733,2257858,143
+14742393,2258001,122
+7911105,2258123,159
+578202,2258282,132
+13144963,2258414,152
+7905361,2258566,128
+8408920,2258694,129
+292341,2258823,160
+9194986,2258983,160
+2406960,2259143,165
+1609429,2259308,201
+15207480,2259509,185
+14715518,2259694,125
+11055278,2259819,127
+14952305,2259946,123
+3465002,2260069,189
+2940172,2260258,130
+4240072,2260388,146
+7381393,2260534,152
+7375736,2260686,176
+6566270,2260862,164
+3971575,2261026,138
+5274882,2261164,124
+11838691,2261288,141
+9183124,2261429,155
+4493787,2261584,230
+1365870,2261814,148
+11305968,2261962,158
+13396888,2262120,156
+3933375,2262276,175
+9755967,2262451,187
+16007719,2262638,138
+13149993,2262776,171
+4478144,2262947,132
+12907620,2263079,138
+6302292,2263217,143
+12386220,2263360,148
+4480755,2263508,157
+6871958,2263665,218
+8148455,2263883,128
+7385228,2264011,221
+12598159,2264232,144
+2162395,2264376,151
+822680,2264527,192
+4245449,2264719,127
+8174447,2264846,166
+9742268,2265012,139
+13148598,2265151,254
+11031914,2265405,185
+11847696,2265590,132
+6595122,2265722,129
+6618252,2265851,133
+13653836,2265984,141
+16308962,2266125,135
+7364266,2266260,130
+3471720,2266390,139
+2142455,2266529,132
+5517617,2266661,143
+13689671,2266804,114
+15789342,2266918,197
+12850938,2267115,128
+5271450,2267243,130
+8661268,2267373,209
+12352977,2267582,160
+5787766,2267742,185
+15792631,2267927,138
+3692556,2268065,144
+4477403,2268209,153
+14482133,2268362,132
+7114085,2268494,175
+9962400,2268669,159
+13386723,2268828,122
+16302225,2268950,146
+11312004,2269096,187
+9499256,2269283,127
+8414761,2269410,196
+2367276,2269606,148
+15777265,2269754,138
+6579975,2269892,194
+5831968,2270086,139
+11313174,2270225,141
+5826375,2270366,123
+4210722,2270489,129
+11033520,2270618,198
+4499081,2270816,171
+4219278,2270987,137
+6874143,2271124,154
+5005525,2271278,156
+8947479,2271434,116
+7134314,2271550,140
+9459118,2271690,137
+1052854,2271827,120
+37731,2271947,204
+13926974,2272151,158
+13618,2272309,165
+532467,2272474,141
+4470639,2272615,139
+3710851,2272754,127
+12347926,2272881,119
+15005,2273000,145
+2673996,2273145,150
+9196535,2273295,171
+8156787,2273466,133
+7106328,2273599,140
+8701735,2273739,126
+554645,2273865,164
+11325071,2274029,187
+9212470,2274216,200
+1099583,2274416,170
+16290090,2274586,163
+4514970,2274749,139
+586484,2274888,162
+818556,2275050,219
+3159974,2275269,141
+14425503,2275410,163
+14214955,2275573,118
+7887986,2275691,196
+5768534,2275887,140
+11571316,2276027,196
+9762450,2276223,169
+6877117,2276392,141
+15737864,2276533,143
+8421797,2276676,253
+11830014,2276929,164
+3177520,2277093,116
+12340796,2277209,185
+5253771,2277394,195
+15483878,2277589,146
+7869112,2277735,216
+10009753,2277951,165
+15740888,2278116,147
+5521993,2278263,146
+9455382,2278409,158
+1066074,2278567,174
+16021030,2278741,130
+792561,2278871,128
+15003,2278999,141
+2896935,2279140,135
+8425770,2279275,204
+8138624,2279479,144
+1095670,2279623,165
+4492929,2279788,142
+8951033,2279930,189
+5253758,2280119,145
+6063992,2280264,149
+3717923,2280413,145
+820241,2280558,143
+14724094,2280701,135
+4490002,2280836,118
+10509799,2280954,133
+554520,2281087,177
+13689867,2281264,129
+7634458,2281393,161
+1353835,2281554,239
+836519,2281793,117
+14475948,2281910,173
+10016908,2282083,146
+7870766,2282229,138
+4778800,2282367,159
+4993581,2282526,136
+11306622,2282662,246
+9197963,2282908,136
+13913255,2283044,175
+11059746,2283219,147
+15681,2283366,142
+13389942,2283508,164
+5030994,2283672,191
+8178445,2283863,156
+12590747,2284019,116
+8403866,2284135,138
+7615062,2284273,153
+12902780,2284426,158
+2146267,2284584,107
+2113882,2284691,123
+10803775,2284814,126
+10502181,2284940,136
+5000040,2285076,178
+2101847,2285254,183
+15260330,2285437,181
+6585729,2285618,166
+8179663,2285784,202
+6859474,2285986,132
+10804816,2286118,136
+1896545,2286254,130
+11047910,2286384,273
+12888737,2286657,168
+3158740,2286825,164
+14705851,2286989,130
+14431056,2287119,121
+15776968,2287240,140
+2392714,2287380,162
+6868124,2287542,145
+1338890,2287687,60
+845577,2287747,126
+11842991,2287873,151
+308150,2288024,150
+9995,2288174,142
+9997,2288316,141
+10011,2288457,170
+10008,2288627,208
+7081834,2288835,161
+308326,2288996,129
+14210686,2289125,288
+9902,2289413,146
+9905,2289559,199
+9898,2289758,190
+9938,2289948,140
+9933,2290088,148
+9991,2290236,147
+9943,2290383,221
+9936,2290604,117
+9982,2290721,148
+9888,2290869,147
+9957,2291016,147
+9955,2291163,110
+9916,2291273,190
+9878,2291463,158
+9882,2291621,151
+9877,2291772,144
+9875,2291916,162
+9829,2292078,152
+9824,2292230,118
+9840,2292348,132
+9841,2292480,155
+9800,2292635,154
+9797,2292789,131
+9790,2292920,154
+9788,2293074,173
+9789,2293247,153
+9848,2293400,141
+9847,2293541,111
+9870,2293652,152
+9864,2293804,137
+9690,2293941,125
+9691,2294066,205
+9685,2294271,146
+9698,2294417,195
+9697,2294612,240
+9742,2294852,150
+9744,2295002,155
+9741,2295157,140
+9738,2295297,141
+9778,2295438,170
+9774,2295608,204
+9772,2295812,162
+9769,2295974,165
+9765,2296139,130
+9766,2296269,163
+9676,2296432,215
+9721,2296647,169
+9719,2296816,138
+9755,2296954,154
+9748,2297108,129
+9731,2297237,204
+9638,2297441,193
+9642,2297634,180
+9608,2297814,144
+9600,2297958,138
+9661,2298096,178
+9655,2298274,171
+9597,2298445,183
+9634,2298628,164
+9581,2298792,137
+9580,2298929,178
+9571,2299107,130
+9619,2299237,166
+9614,2299403,135
+9635,2299538,144
+9628,2299682,143
+9672,2299825,139
+9664,2299964,143
+9499,2300107,156
+9496,2300263,175
+9493,2300438,126
+9485,2300564,162
+9486,2300726,148
+9521,2300874,149
+9517,2301023,157
+9541,2301180,141
+9538,2301321,150
+9526,2301471,169
+9537,2301640,146
+9515,2301786,167
+9508,2301953,185
+9550,2302138,201
+9542,2302339,141
+9506,2302480,174
+9568,2302654,182
+9400,2302836,148
+9395,2302984,167
+9462,2303151,180
+9456,2303331,115
+9419,2303446,140
+9425,2303586,134
+9417,2303720,161
+9418,2303881,137
+9480,2304018,155
+9468,2304173,192
+9467,2304365,60
+9466,2304425,166
+9424,2304591,222
+9420,2304813,180
+9415,2304993,134
+9439,2305127,141
+9285,2305268,130
+9279,2305398,122
+9367,2305520,141
+9379,2305661,148
+9386,2305809,152
+9385,2305961,141
+9382,2306102,147
+9371,2306249,193
+9329,2306442,183
+9332,2306625,157
+9286,2306782,146
+9315,2306928,133
+9330,2307061,142
+9244,2307203,176
+9241,2307379,60
+9237,2307439,149
+9191,2307588,120
+9186,2307708,160
+9253,2307868,283
+9255,2308151,155
+9233,2308306,133
+9231,2308439,175
+9210,2308614,126
+9202,2308740,138
+9226,2308878,137
+9223,2309015,128
+9280,2309143,145
+9167,2309288,152
+9154,2309440,172
+9156,2309612,127
+9157,2309739,195
+9158,2309934,152
+9096,2310086,159
+9094,2310245,127
+9091,2310372,147
+9089,2310519,235
+9151,2310754,135
+9138,2310889,178
+9141,2311067,130
+9145,2311197,201
+9149,2311398,148
+9173,2311546,152
+9161,2311698,247
+9166,2311945,171
+9129,2312116,230
+9127,2312346,151
+9115,2312497,159
+9083,2312656,130
+8996,2312786,176
+9184,2312962,140
+9104,2313102,172
+8977,2313274,152
+8969,2313426,152
+8964,2313578,141
+9053,2313719,141
+9052,2313860,125
+9042,2313985,145
+9007,2314130,179
+9043,2314309,159
+9026,2314468,147
+9015,2314615,154
+8985,2314769,125
+9066,2314894,135
+9009,2315029,163
+9013,2315192,139
+8997,2315331,126
+8993,2315457,156
+9072,2315613,112
+8889,2315725,171
+8888,2315896,151
+8887,2316047,167
+8883,2316214,122
+8860,2316336,149
+8858,2316485,130
+8942,2316615,166
+8938,2316781,136
+8944,2316917,158
+8940,2317075,189
+8925,2317264,152
+8875,2317416,221
+8859,2317637,191
+8894,2317828,141
+8895,2317969,157
+8923,2318126,153
+8922,2318279,130
+8953,2318409,145
+8901,2318554,160
+8802,2318714,126
+8810,2318840,131
+8803,2318971,164
+8812,2319135,166
+8796,2319301,199
+8836,2319500,197
+8838,2319697,125
+8834,2319822,137
+8774,2319959,233
+8776,2320192,156
+8848,2320348,141
+8842,2320489,185
+8846,2320674,122
+8788,2320796,144
+8791,2320940,144
+8822,2321084,126
+8820,2321210,127
+8758,2321337,126
+8752,2321463,146
+8750,2321609,126
+8724,2321735,153
+8715,2321888,172
+8716,2322060,141
+8682,2322201,139
+8701,2322340,142
+8653,2322482,133
+8656,2322615,170
+8744,2322785,163
+8745,2322948,146
+8726,2323094,183
+8673,2323277,135
+8704,2323412,130
+8646,2323542,162
+8643,2323704,168
+8647,2323872,115
+8641,2323987,157
+8640,2324144,159
+8635,2324303,150
+8550,2324453,131
+8548,2324584,214
+8544,2324798,199
+8625,2324997,153
+8624,2325150,159
+8621,2325309,123
+8575,2325432,164
+8573,2325596,161
+8559,2325757,133
+8611,2325890,119
+8613,2326009,175
+8605,2326184,128
+8597,2326312,147
+8584,2326459,143
+8474,2326602,146
+8470,2326748,186
+8469,2326934,174
+8513,2327108,114
+8512,2327222,168
+8509,2327390,167
+8465,2327557,131
+8468,2327688,162
+8498,2327850,138
+8497,2327988,134
+8489,2328122,143
+8477,2328265,124
+8480,2328389,144
+8530,2328533,229
+8536,2328762,206
+8520,2328968,162
+8508,2329130,129
+8117,2329259,146
+8167,2329405,123
+8155,2329528,150
+8127,2329678,192
+8126,2329870,180
+8130,2330050,180
+8146,2330230,219
+8120,2330449,166
+8148,2330615,129
+8139,2330744,139
+8183,2330883,179
+8171,2331062,149
+8041,2331211,225
+8013,2331436,138
+8065,2331574,163
+8067,2331737,185
+8091,2331922,135
+8056,2332057,158
+8040,2332215,151
+8035,2332366,140
+8109,2332506,146
+8102,2332652,112
+8087,2332764,134
+8076,2332898,123
+7952,2333021,213
+7951,2333234,153
+7938,2333387,158
+7934,2333545,119
+7962,2333664,159
+7960,2333823,167
+7955,2333990,133
+7973,2334123,133
+7975,2334256,141
+7974,2334397,141
+7919,2334538,256
+7902,2334794,182
+7901,2334976,123
+7899,2335099,162
+8002,2335261,137
+7989,2335398,124
+7988,2335522,174
+7915,2335696,135
+7786,2335831,183
+7782,2336014,175
+7779,2336189,130
+7807,2336319,155
+7810,2336474,139
+7857,2336613,148
+7855,2336761,131
+7853,2336892,173
+7889,2337065,138
+7888,2337203,120
+7822,2337323,120
+7815,2337443,143
+7885,2337586,185
+7871,2337771,138
+7868,2337909,167
+7791,2338076,158
+7841,2338234,118
+7763,2338352,165
+7758,2338517,189
+7753,2338706,141
+7720,2338847,147
+7716,2338994,189
+7712,2339183,178
+7708,2339361,154
+7698,2339515,112
+7702,2339627,120
+7730,2339747,113
+7733,2339860,163
+7723,2340023,161
+7746,2340184,115
+7747,2340299,137
+7688,2340436,176
+7675,2340612,167
+7609,2340779,143
+7611,2340922,201
+7603,2341123,137
+7601,2341260,140
+7604,2341400,138
+7588,2341538,211
+7583,2341749,163
+7568,2341912,136
+7571,2342048,118
+7572,2342166,167
+7566,2342333,137
+7643,2342470,143
+7654,2342613,141
+7655,2342754,191
+7547,2342945,145
+7532,2343090,169
+7621,2343259,232
+7622,2343491,147
+7556,2343638,146
+7557,2343784,182
+7615,2343966,158
+7476,2344124,165
+7474,2344289,233
+7466,2344522,207
+7469,2344729,155
+7515,2344884,162
+7517,2345046,159
+7513,2345205,162
+7467,2345367,207
+7458,2345574,144
+7459,2345718,123
+7486,2345841,159
+7488,2346000,171
+7511,2346171,142
+7505,2346313,204
+7500,2346517,122
+7450,2346639,134
+7351,2346773,188
+7343,2346961,141
+7345,2347102,141
+7422,2347243,131
+7435,2347374,154
+7426,2347528,167
+7401,2347695,189
+7402,2347884,155
+7399,2348039,144
+7387,2348183,149
+7381,2348332,125
+7356,2348457,147
+7396,2348604,129
+7394,2348733,156
+7338,2348889,143
+7328,2349032,168
+7379,2349200,135
+7371,2349335,191
+7285,2349526,135
+7284,2349661,161
+7272,2349822,182
+7270,2350004,158
+7320,2350162,221
+7297,2350383,145
+7290,2350528,166
+7291,2350694,163
+7251,2350857,150
+7245,2351007,170
+7314,2351177,109
+7306,2351286,153
+7224,2351439,150
+7216,2351589,155
+7214,2351744,137
+7210,2351881,161
+7170,2352042,138
+7173,2352180,143
+7174,2352323,215
+7146,2352538,163
+7141,2352701,154
+7140,2352855,123
+7172,2352978,133
+7169,2353111,123
+7167,2353234,146
+7154,2353380,163
+7152,2353543,173
+7195,2353716,149
+7184,2353865,143
+7122,2354008,159
+7053,2354167,166
+7046,2354333,158
+7106,2354491,184
+7099,2354675,154
+7082,2354829,130
+7036,2354959,137
+7005,2355096,155
+7002,2355251,167
+6998,2355418,138
+7110,2355556,145
+7108,2355701,129
+7073,2355830,118
+7062,2355948,131
+6890,2356079,165
+6877,2356244,134
+6870,2356378,207
+6868,2356585,171
+6932,2356756,189
+6933,2356945,131
+6921,2357076,160
+6915,2357236,220
+6907,2357456,124
+6909,2357580,120
+6942,2357700,150
+6988,2357850,135
+6869,2357985,174
+6864,2358159,148
+6867,2358307,108
+6872,2358415,129
+6874,2358544,137
+6767,2358681,140
+6769,2358821,163
+6761,2358984,186
+6759,2359170,176
+6851,2359346,155
+6847,2359501,155
+6840,2359656,140
+6844,2359796,136
+6859,2359932,180
+6863,2360112,159
+6819,2360271,117
+6811,2360388,139
+6813,2360527,162
+6789,2360689,159
+6798,2360848,162
+6724,2361010,161
+6729,2361171,147
+6717,2361318,145
+6721,2361463,154
+6707,2361617,149
+6691,2361766,127
+6685,2361893,147
+6679,2362040,160
+6684,2362200,174
+6687,2362374,164
+6756,2362538,142
+6737,2362680,151
+6741,2362831,180
+6630,2363011,148
+6626,2363159,137
+6632,2363296,141
+6623,2363437,139
+6621,2363576,132
+6578,2363708,176
+6564,2363884,197
+6570,2364081,141
+6577,2364222,146
+6579,2364368,155
+6666,2364523,155
+6661,2364678,126
+6612,2364804,139
+6607,2364943,144
+6652,2365087,186
+6644,2365273,142
+6550,2365415,170
+6551,2365585,143
+6552,2365728,144
+6556,2365872,144
+6470,2366016,211
+6473,2366227,173
+6468,2366400,152
+6513,2366552,205
+6500,2366757,128
+6518,2366885,149
+6508,2367034,144
+6503,2367178,143
+6482,2367321,166
+6539,2367487,164
+6497,2367651,164
+6466,2367815,177
+6463,2367992,259
+6465,2368251,136
+6397,2368387,180
+6384,2368567,151
+6377,2368718,151
+6408,2368869,164
+6412,2369033,156
+6425,2369189,136
+6445,2369325,135
+6383,2369460,166
+6374,2369626,151
+6448,2369777,141
+6439,2369918,116
+6391,2370034,141
+6277,2370175,161
+6280,2370336,119
+6282,2370455,152
+6278,2370607,143
+6279,2370750,132
+6334,2370882,161
+6330,2371043,141
+6324,2371184,165
+6326,2371349,128
+6307,2371477,162
+6304,2371639,153
+6291,2371792,235
+6321,2372027,129
+6267,2372156,130
+6271,2372286,129
+6270,2372415,131
+6301,2372546,146
+6358,2372692,120
+6349,2372812,180
+6363,2372992,155
+6344,2373147,124
+6217,2373271,152
+6214,2373423,122
+6213,2373545,132
+6174,2373677,163
+6172,2373840,161
+6243,2374001,177
+6234,2374178,134
+6226,2374312,175
+6224,2374487,122
+6232,2374609,133
+6180,2374742,163
+6205,2374905,173
+6181,2375078,60
+6265,2375138,107
+6147,2375245,189
+6127,2375434,130
+6133,2375564,133
+6093,2375697,156
+6096,2375853,168
+6086,2376021,162
+6142,2376183,149
+6136,2376332,163
+6083,2376495,184
+6071,2376679,143
+6059,2376822,163
+6151,2376985,143
+6152,2377128,136
+6094,2377264,138
+6107,2377402,154
+6102,2377556,163
+6023,2377719,160
+6025,2377879,168
+5984,2378047,177
+5985,2378224,60
+5992,2378284,147
+5993,2378431,142
+5986,2378573,148
+6031,2378721,218
+6036,2378939,141
+6026,2379080,166
+5940,2379246,164
+5934,2379410,142
+5931,2379552,170
+6002,2379722,186
+5950,2379908,198
+6040,2380106,166
+5959,2380272,116
+6010,2380388,133
+5876,2380521,160
+5863,2380681,158
+5861,2380839,200
+5862,2381039,152
+5920,2381191,162
+5914,2381353,139
+5832,2381492,141
+5828,2381633,141
+5875,2381774,164
+5877,2381938,206
+5873,2382144,135
+5853,2382279,144
+5916,2382423,153
+5910,2382576,148
+5926,2382724,179
+5921,2382903,123
+5881,2383026,140
+5898,2383166,159
+5821,2383325,168
+5824,2383493,144
+5826,2383637,153
+5818,2383790,129
+5810,2383919,133
+5811,2384052,171
+5805,2384223,165
+5742,2384388,136
+5807,2384524,241
+5790,2384765,135
+5738,2384900,135
+5731,2385035,165
+5791,2385200,185
+5786,2385385,126
+5778,2385511,157
+5777,2385668,126
+5768,2385794,143
+5771,2385937,139
+5762,2386076,133
+5642,2386209,135
+5634,2386344,181
+5632,2386525,164
+5620,2386689,116
+5673,2386805,131
+5665,2386936,125
+5658,2387061,126
+5653,2387187,162
+5654,2387349,190
+5655,2387539,120
+5678,2387659,184
+5674,2387843,174
+5718,2388017,163
+5713,2388180,142
+5648,2388322,141
+5638,2388463,144
+5639,2388607,150
+5716,2388757,170
+5681,2388927,146
+5707,2389073,155
+5524,2389228,164
+5520,2389392,146
+5516,2389538,115
+5519,2389653,208
+5613,2389861,155
+5616,2390016,126
+5614,2390142,164
+5576,2390306,122
+5568,2390428,177
+5570,2390605,121
+5512,2390726,172
+5507,2390898,149
+5509,2391047,188
+5541,2391235,135
+5554,2391370,181
+5594,2391551,127
+5450,2391678,168
+5452,2391846,148
+5453,2391994,157
+5449,2392151,187
+5437,2392338,154
+5444,2392492,126
+5433,2392618,148
+5425,2392766,114
+5429,2392880,113
+5430,2392993,168
+5419,2393161,141
+5420,2393302,141
+5416,2393443,193
+5415,2393636,132
+5409,2393768,124
+5408,2393892,122
+5478,2394014,183
+5483,2394197,155
+5447,2394352,158
+5497,2394510,166
+5335,2394676,176
+5341,2394852,146
+5332,2394998,155
+5327,2395153,140
+5310,2395293,198
+5393,2395491,140
+5390,2395631,208
+5389,2395839,143
+5404,2395982,145
+5401,2396127,162
+5382,2396289,133
+5380,2396422,163
+5381,2396585,155
+5374,2396740,144
+5342,2396884,143
+5343,2397027,162
+5350,2397189,147
+5363,2397336,145
+5246,2397481,138
+5245,2397619,159
+5238,2397778,170
+5235,2397948,125
+5257,2398073,157
+5248,2398230,180
+5302,2398410,152
+5298,2398562,172
+5294,2398734,149
+5286,2398883,139
+5225,2399022,141
+5306,2399163,150
+5258,2399313,144
+5265,2399457,205
+5230,2399662,148
+5290,2399810,131
+5129,2399941,171
+5131,2400112,191
+5117,2400303,135
+5120,2400438,173
+5116,2400611,130
+5110,2400741,122
+5199,2400863,147
+5206,2401010,132
+5200,2401142,152
+5202,2401294,143
+5186,2401437,129
+5191,2401566,173
+5182,2401739,160
+5213,2401899,153
+5179,2402052,146
+5165,2402198,117
+5161,2402315,176
+5140,2402491,151
+5150,2402642,143
+5067,2402785,127
+5071,2402912,144
+5054,2403056,156
+5049,2403212,110
+5035,2403322,141
+5065,2403463,190
+5062,2403653,145
+5107,2403798,177
+5108,2403975,154
+5036,2404129,177
+5032,2404306,138
+5082,2404444,135
+5080,2404579,148
+5017,2404727,143
+5097,2404870,128
+5013,2404998,124
+4950,2405122,136
+4954,2405258,160
+4961,2405418,173
+4962,2405591,168
+4943,2405759,189
+4984,2405948,156
+4986,2406104,167
+4993,2406271,162
+4985,2406433,202
+4908,2406635,144
+4900,2406779,167
+4902,2406946,139
+4903,2407085,148
+4967,2407233,141
+4956,2407374,152
+4959,2407526,141
+4923,2407667,181
+4920,2407848,125
+4909,2407973,143
+4980,2408116,165
+4969,2408281,164
+4930,2408445,140
+4928,2408585,132
+4876,2408717,161
+4879,2408878,191
+4883,2409069,188
+4811,2409257,128
+4814,2409385,161
+4810,2409546,134
+4807,2409680,180
+4813,2409860,116
+4840,2409976,130
+4829,2410106,233
+4893,2410339,163
+4888,2410502,232
+4890,2410734,141
+4852,2410875,178
+4853,2411053,177
+4832,2411230,127
+4830,2411357,146
+4865,2411503,135
+4854,2411638,138
+4849,2411776,110
+4856,2411886,151
+4732,2412037,129
+4728,2412166,146
+4730,2412312,172
+4712,2412484,131
+4780,2412615,143
+4796,2412758,123
+4797,2412881,168
+4779,2413049,133
+4763,2413182,182
+4760,2413364,155
+4722,2413519,138
+4714,2413657,174
+4800,2413831,144
+4791,2413975,127
+4769,2414102,190
+4614,2414292,132
+4615,2414424,176
+4617,2414600,116
+4619,2414716,184
+4613,2414900,183
+4664,2415083,173
+4668,2415256,137
+4670,2415393,162
+4692,2415555,177
+4687,2415732,128
+4641,2415860,155
+4626,2416015,142
+4627,2416157,121
+4632,2416278,152
+4681,2416430,142
+4685,2416572,119
+4710,2416691,164
+4702,2416855,112
+4701,2416967,149
+4643,2417116,120
+4666,2417236,153
+4660,2417389,122
+4579,2417511,136
+4572,2417647,125
+4502,2417772,151
+4487,2417923,146
+4496,2418069,164
+4548,2418233,212
+4555,2418445,119
+4599,2418564,204
+4563,2418768,148
+4523,2418916,181
+4517,2419097,161
+4412,2419258,132
+4401,2419390,150
+4391,2419540,119
+4394,2419659,124
+4395,2419783,124
+4463,2419907,170
+4465,2420077,166
+4455,2420243,177
+4461,2420420,150
+4448,2420570,165
+4436,2420735,166
+4421,2420901,152
+4433,2421053,119
+4430,2421172,150
+4397,2421322,154
+4475,2421476,147
+4078,2421623,145
+4068,2421768,150
+4071,2421918,163
+4070,2422081,143
+4058,2422224,150
+4079,2422374,170
+4073,2422544,166
+4065,2422710,231
+4063,2422941,161
+4094,2423102,190
+4363,2423292,152
+4357,2423444,183
+4354,2423627,167
+4387,2423794,137
+4367,2423931,157
+4054,2424088,150
+4373,2424238,144
+4039,2424382,131
+3940,2424513,143
+3957,2424656,148
+3964,2424804,164
+3962,2424968,202
+4013,2425170,155
+4011,2425325,204
+4012,2425529,133
+3954,2425662,116
+4019,2425778,155
+3996,2425933,137
+4040,2426070,147
+4027,2426217,205
+4028,2426422,162
+4022,2426584,163
+4025,2426747,138
+3992,2426885,145
+3991,2427030,145
+3990,2427175,143
+3979,2427318,157
+3980,2427475,136
+3896,2427611,131
+3898,2427742,135
+3888,2427877,158
+3923,2428035,178
+3921,2428213,154
+3847,2428367,150
+3840,2428517,149
+3841,2428666,125
+3843,2428791,141
+3892,2428932,141
+3886,2429073,177
+3878,2429250,128
+3909,2429378,130
+3899,2429508,164
+3895,2429672,143
+3924,2429815,156
+3877,2429971,132
+3865,2430103,138
+3856,2430241,132
+3752,2430373,197
+3754,2430570,149
+3756,2430719,175
+3758,2430894,177
+3770,2431071,170
+3772,2431241,147
+3781,2431388,169
+3783,2431557,153
+3723,2431710,162
+3807,2431872,129
+3809,2432001,137
+3799,2432138,141
+3795,2432279,141
+3741,2432420,130
+3655,2432550,191
+3654,2432741,178
+3615,2432919,184
+3622,2433103,174
+3692,2433277,144
+3691,2433421,155
+3679,2433576,145
+3671,2433721,155
+3665,2433876,162
+3687,2434038,171
+3685,2434209,126
+3651,2434335,177
+3652,2434512,140
+3700,2434652,150
+3706,2434802,190
+3712,2434992,143
+3717,2435135,155
+3634,2435290,129
+3595,2435419,212
+3601,2435631,192
+3573,2435823,165
+3575,2435988,149
+3563,2436137,138
+3566,2436275,164
+3567,2436439,150
+3559,2436589,145
+3526,2436734,177
+3521,2436911,132
+3568,2437043,171
+3557,2437214,146
+3520,2437360,125
+3549,2437485,212
+3576,2437697,165
+3606,2437862,126
+3495,2437988,60
+3501,2438048,130
+3497,2438178,146
+3499,2438324,233
+3496,2438557,182
+3449,2438739,170
+3437,2438909,162
+3503,2439071,148
+3505,2439219,169
+3459,2439388,167
+3455,2439555,240
+3445,2439795,185
+3448,2439980,155
+3486,2440135,180
+3491,2440315,171
+3492,2440486,153
+3482,2440639,143
+3438,2440782,118
+3434,2440900,155
+3514,2441055,171
+3517,2441226,141
+3509,2441367,170
+3479,2441537,149
+3478,2441686,153
+3467,2441839,138
+3472,2441977,157
+3461,2442134,135
+3458,2442269,127
+3363,2442396,149
+3367,2442545,152
+3355,2442697,213
+3357,2442910,181
+3330,2443091,145
+3335,2443236,150
+3392,2443386,171
+3361,2443557,138
+3337,2443695,197
+3383,2443892,136
+3379,2444028,133
+3375,2444161,154
+3421,2444315,146
+3427,2444461,143
+3430,2444604,141
+3277,2444745,120
+3275,2444865,143
+3273,2445008,176
+3305,2445184,136
+3306,2445320,165
+3290,2445485,142
+3317,2445627,140
+3310,2445767,119
+3247,2445886,146
+3251,2446032,139
+3293,2446171,150
+3237,2446321,117
+3241,2446438,122
+3323,2446560,156
+3194,2446716,163
+3193,2446879,164
+3189,2447043,184
+3165,2447227,191
+3151,2447418,162
+3170,2447580,140
+3148,2447720,138
+3143,2447858,177
+3181,2448035,136
+3184,2448171,119
+3178,2448290,118
+3179,2448408,183
+3229,2448591,155
+3231,2448746,162
+3204,2448908,141
+3205,2449049,141
+3135,2449190,181
+3120,2449371,141
+3226,2449512,172
+3217,2449684,132
+3034,2449816,155
+3030,2449971,142
+3028,2450113,227
+3103,2450340,157
+3104,2450497,134
+3093,2450631,160
+3064,2450791,121
+3071,2450912,160
+3094,2451072,167
+3081,2451239,176
+3047,2451415,158
+3052,2451573,178
+3074,2451751,106
+2929,2451857,163
+2932,2452020,172
+2931,2452192,153
+2934,2452345,151
+2910,2452496,182
+2912,2452678,141
+2917,2452819,119
+2911,2452938,141
+2913,2453079,187
+2905,2453266,130
+2908,2453396,147
+2942,2453543,158
+2944,2453701,134
+2983,2453835,135
+2986,2453970,137
+2980,2454107,187
+3024,2454294,165
+3013,2454459,127
+3014,2454586,114
+3009,2454700,149
+2955,2454849,141
+2953,2454990,178
+2969,2455168,156
+2972,2455324,175
+2940,2455499,146
+2947,2455645,125
+2848,2455770,150
+2850,2455920,180
+2843,2456100,137
+2819,2456237,183
+2817,2456420,167
+2878,2456587,128
+2857,2456715,181
+2873,2456896,148
+2874,2457044,151
+2867,2457195,141
+2821,2457336,178
+2816,2457514,206
+2907,2457720,154
+2806,2457874,207
+2833,2458081,149
+2881,2458230,147
+2794,2458377,172
+2787,2458549,156
+2780,2458705,138
+2743,2458843,141
+2733,2458984,144
+2737,2459128,155
+2745,2459283,157
+2704,2459440,150
+2717,2459590,179
+2721,2459769,141
+2724,2459910,188
+2718,2460098,155
+2784,2460253,134
+2699,2460387,141
+2696,2460528,125
+2747,2460653,169
+2684,2460822,129
+2670,2460951,134
+2669,2461085,166
+2627,2461251,158
+2629,2461409,142
+2613,2461551,113
+2619,2461664,149
+2676,2461813,155
+2671,2461968,162
+2659,2462130,123
+2606,2462253,140
+2605,2462393,168
+2597,2462561,141
+2593,2462702,150
+2590,2462852,163
+2635,2463015,156
+2611,2463171,144
+2663,2463315,120
+2553,2463435,151
+2556,2463586,135
+2557,2463721,159
+2551,2463880,177
+2530,2464057,182
+2522,2464239,139
+2519,2464378,156
+2520,2464534,142
+2580,2464676,115
+2571,2464791,148
+2576,2464939,161
+2523,2465100,120
+2517,2465220,153
+2515,2465373,152
+2492,2465525,141
+2494,2465666,158
+2534,2465824,149
+2555,2465973,158
+2447,2466131,140
+2439,2466271,186
+2441,2466457,139
+2438,2466596,137
+2444,2466733,145
+2437,2466878,177
+2445,2467055,155
+2433,2467210,147
+2389,2467357,193
+2378,2467550,139
+2379,2467689,135
+2381,2467824,159
+2384,2467983,173
+2388,2468156,130
+2450,2468286,183
+2453,2468469,156
+2456,2468625,169
+2486,2468794,141
+2483,2468935,131
+2396,2469066,234
+2392,2469300,134
+2467,2469434,161
+2469,2469595,220
+2402,2469815,152
+2397,2469967,177
+2458,2470144,164
+2460,2470308,151
+2436,2470459,145
+2347,2470604,158
+2342,2470762,164
+2343,2470926,138
+2339,2471064,178
+2333,2471242,182
+2283,2471424,142
+2280,2471566,163
+2268,2471729,119
+2269,2471848,160
+2273,2472008,118
+2313,2472126,142
+2314,2472268,172
+2319,2472440,127
+2348,2472567,145
+2307,2472712,149
+2311,2472861,155
+2310,2473016,137
+2386,2473153,164
+2372,2473317,141
+2299,2473458,131
+2286,2473589,176
+2327,2473765,153
+2177,2473918,156
+2178,2474074,145
+2163,2474219,138
+2170,2474357,114
+2161,2474471,157
+2226,2474628,225
+2225,2474853,133
+2223,2474986,153
+2214,2475139,156
+2174,2475295,159
+2176,2475454,190
+2157,2475644,142
+2260,2475786,166
+2262,2475952,140
+2254,2476092,146
+2242,2476238,141
+2240,2476379,167
+2211,2476546,141
+2206,2476687,146
+2228,2476833,134
+2227,2476967,114
+2190,2477081,162
+2266,2477243,149
+2005,2477392,163
+2011,2477555,150
+2154,2477705,131
+2147,2477836,139
+2150,2477975,149
+2031,2478124,166
+2036,2478290,134
+2013,2478424,143
+2075,2478567,137
+2047,2478704,134
+2039,2478838,133
+2143,2478971,107
+2130,2479078,144
+2060,2479222,143
+2052,2479365,98
+2135,2479463,152
+1931,2479615,162
+1923,2479777,148
+1927,2479925,140
+1929,2480065,166
+1977,2480231,156
+1151,2480387,131
+1147,2480518,136
+1972,2480654,141
+1971,2480795,141
+1973,2480936,141
+1925,2481077,141
+1909,2481218,149
+1939,2481367,171
+1942,2481538,141
+1919,2481679,151
+1905,2481830,151
+1904,2481981,134
+2001,2482115,156
+1954,2482271,140
+1784,2482411,148
+1787,2482559,171
+1788,2482730,126
+1780,2482856,190
+1848,2483046,177
+1833,2483223,130
+1834,2483353,124
+1866,2483477,124
+1852,2483601,126
+1846,2483727,167
+1872,2483894,141
+1858,2484035,132
+1867,2484167,131
+1892,2484298,160
+1894,2484458,166
+1889,2484624,125
+1877,2484749,117
+1881,2484866,149
+1873,2485015,139
+1817,2485154,131
+1805,2485285,141
+1806,2485426,141
+1803,2485567,146
+1808,2485713,121
+1768,2485834,158
+1774,2485992,234
+1762,2486226,151
+1701,2486377,129
+1693,2486506,149
+1704,2486655,142
+1696,2486797,125
+1726,2486922,123
+1722,2487045,151
+1732,2487196,140
+1717,2487336,149
+1679,2487485,138
+1754,2487623,157
+1744,2487780,151
+1740,2487931,152
+1727,2488083,171
+1680,2488254,140
+1761,2488394,128
+1582,2488522,151
+1572,2488673,164
+1573,2488837,149
+1575,2488986,170
+1578,2489156,141
+1580,2489297,132
+1569,2489429,135
+1614,2489564,155
+1581,2489719,165
+1606,2489884,194
+1611,2490078,119
+1596,2490197,194
+1584,2490391,110
+1591,2490501,190
+1564,2490691,164
+1571,2490855,139
+1547,2490994,168
+1662,2491162,151
+1655,2491313,116
+1638,2491429,137
+1639,2491566,123
+1613,2491689,118
+1632,2491807,135
+1657,2491942,133
+1644,2492075,144
+1557,2492219,146
+1546,2492365,103
+1486,2492468,174
+1474,2492642,144
+1503,2492786,165
+1502,2492951,132
+1504,2493083,127
+1496,2493210,128
+1508,2493338,149
+1522,2493487,123
+1523,2493610,99
+1537,2493709,138
+1541,2493847,150
+1530,2493997,134
+1509,2494131,122
+1525,2494253,139
+1533,2494392,148
+1492,2494540,160
+1476,2494700,132
+1443,2494832,119
+1438,2494951,134
+1445,2495085,104
+1459,2495189,163
+1437,2495352,160
+1444,2495512,121
+1379,2495633,131
+1367,2495764,147
+1371,2495911,155
+1364,2496066,146
+1363,2496212,133
+1382,2496345,154
+1388,2496499,129
+1375,2496628,141
+1373,2496769,138
+1377,2496907,149
+1428,2497056,136
+1391,2497192,155
+1396,2497347,141
+1383,2497488,134
+1381,2497622,180
+1422,2497802,187
+1330,2497989,141
+1334,2498130,151
+1346,2498281,111
+1335,2498392,157
+1404,2498549,107
+1411,2498656,134
+1355,2498790,140
+1224,2498930,131
+1228,2499061,119
+1215,2499180,137
+1219,2499317,138
+1270,2499455,116
+1268,2499571,135
+1265,2499706,126
+1313,2499832,146
+1315,2499978,121
+1311,2500099,145
+1292,2500244,155
+1260,2500399,111
+1252,2500510,142
+1290,2500652,97
+1297,2500749,170
+1286,2500919,119
+1250,2501038,127
+1227,2501165,146
+1318,2501311,104
+1127,2501415,171
+1114,2501586,149
+1123,2501735,154
+1116,2501889,129
+1107,2502018,137
+1104,2502155,119
+1091,2502274,168
+1097,2502442,142
+1071,2502584,201
+1065,2502785,155
+1062,2502940,115
+1208,2503055,144
+1205,2503199,143
+1201,2503342,152
+1105,2503494,126
+1155,2503620,160
+1089,2503780,157
+1189,2503937,135
+1154,2504072,124
+970,2504196,134
+967,2504330,146
+962,2504476,127
+1011,2504603,151
+1004,2504754,132
+1001,2504886,136
+997,2505022,115
+1057,2505137,138
+1060,2505275,106
+1053,2505381,135
+1050,2505516,180
+1054,2505696,164
+1043,2505860,134
+948,2505994,163
+934,2506157,147
+932,2506304,130
+939,2506434,156
+1027,2506590,139
+1030,2506729,113
+1016,2506842,164
+1018,2507006,135
+966,2507141,146
+955,2507287,157
+958,2507444,126
+991,2507570,133
+986,2507703,152
+985,2507855,106
+1019,2507961,143
+1014,2508104,152
+1045,2508256,146
+920,2508402,126
+917,2508528,145
+914,2508673,168
+910,2508841,141
+794,2508982,162
+859,2509144,154
+855,2509298,148
+895,2509446,170
+752,2509616,173
+926,2509789,145
+919,2509934,185
+831,2510119,130
+807,2510249,103
+814,2510352,183
+892,2510535,128
+872,2510663,147
+837,2510810,166
+712,2510976,199
+696,2511175,131
+681,2511306,148
+699,2511454,159
+700,2511613,136
+783,2511749,194
+785,2511943,143
+781,2512086,148
+777,2512234,130
+771,2512364,156
+773,2512520,139
+766,2512659,130
+415,2512789,120
+767,2512909,143
+756,2513052,129
+745,2513181,150
+741,2513331,125
+736,2513456,104
+718,2513560,143
+707,2513703,108
+790,2513811,167
+809,2513978,122
+801,2514100,133
+757,2514233,152
+725,2514385,90
+683,2514475,168
+676,2514643,165
+675,2514808,160
+672,2514968,111
+690,2515079,136
+695,2515215,171
+687,2515386,148
+680,2515534,141
+618,2515675,161
+620,2515836,109
+610,2515945,184
+613,2516129,150
+603,2516279,152
+598,2516431,147
+601,2516578,219
+660,2516797,139
+662,2516936,153
+654,2517089,151
+591,2517240,125
+625,2517365,139
+650,2517504,165
+506,2517669,101
+642,2517770,134
+645,2517904,152
+633,2518056,142
+593,2518198,144
+501,2518342,104
+511,2518446,158
+508,2518604,133
+509,2518737,157
+528,2518894,128
+523,2519022,125
+536,2519147,161
+494,2519308,134
+496,2519442,132
+497,2519574,154
+482,2519728,149
+559,2519877,108
+551,2519985,171
+541,2520156,161
+537,2520317,149
+515,2520466,147
+467,2520613,123
+481,2520736,174
+556,2520910,134
+572,2521044,160
+12396,2521204,141
+12427,2521345,128
+375,2521473,102
+333,2521575,176
+474,2521751,150
+466,2521901,156
+454,2522057,153
+366,2522210,151
+372,2522361,159
+350,2522520,140
+353,2522660,168
+417,2522828,130
+390,2522958,108
+422,2523066,153
+370,2523219,129
+416,2523348,160
+406,2523508,141
+409,2523649,132
+395,2523781,132
+397,2523913,125
+413,2524038,157
+462,2524195,155
+443,2524350,112
+444,2524462,125
+448,2524587,109
+380,2524696,107
+264,2524803,152
+1579,2524955,152
+256,2525107,127
+45213,2525234,173
+272,2525407,128
+274,2525535,153
+278,2525688,173
+45165,2525861,138
+45204,2525999,131
+12528,2526130,148
+315,2526278,126
+308,2526404,125
+313,2526529,164
+318,2526693,108
+302,2526801,135
+306,2526936,129
+275,2527065,153
+286,2527218,159
+341,2527377,150
+12436,2527527,141
+12426,2527668,150
+12402,2527818,153
+12352,2527971,141
+12338,2528112,134
+12522,2528246,171
+12443,2528417,114
+12357,2528531,168
+12517,2528699,134
+12294,2528833,139
+12344,2528972,114
+12409,2529086,126
+12300,2529212,136
+12364,2529348,158
+12520,2529506,132
+12489,2529638,115
+12328,2529753,127
+12393,2529880,158
+12483,2530038,138
+12378,2530176,145
+12304,2530321,160
+12505,2530481,152
+12326,2530633,132
+12407,2530765,133
+12359,2530898,150
+12500,2531048,145
+53463,2531193,126
+53363,2531319,135
+53335,2531454,134
+12459,2531588,148
+12361,2531736,141
+12397,2531877,155
+12311,2532032,131
+12316,2532163,131
+12416,2532294,141
+12535,2532435,122
+12496,2532557,123
+12308,2532680,128
+12417,2532808,115
+53488,2532923,132
+53264,2533055,152
+53323,2533207,117
+53262,2533324,129
+53266,2533453,132
+53325,2533585,173
+53294,2533758,169
+53445,2533927,160
+53318,2534087,161
+53470,2534248,134
+53260,2534382,127
+53271,2534509,171
+53302,2534680,154
+53475,2534834,177
+53430,2535011,151
+53444,2535162,151
+53345,2535313,161
+53477,2535474,135
+53317,2535609,96
+53252,2535705,114
+53253,2535819,142
+53459,2535961,141
+53286,2536102,139
+53466,2536241,152
+53308,2536393,124
+53428,2536517,124
+53382,2536641,137
+53416,2536778,145
+53419,2536923,126
+53480,2537049,146
+53355,2537195,138
+53468,2537333,162
+53278,2537495,130
+53450,2537625,194
+53349,2537819,121
+53402,2537940,142
+53422,2538082,164
+53490,2538246,144
+53268,2538390,138
+53283,2538528,153
+53410,2538681,138
+53300,2538819,138
+53386,2538957,131
+53415,2539088,166
+53277,2539254,150
+20556,2539404,142
+20598,2539546,142
+20692,2539688,147
+20646,2539835,118
+20649,2539953,147
+20635,2540100,110
+20606,2540210,141
+20686,2540351,143
+20727,2540494,171
+20505,2540665,154
+20733,2540819,144
+20671,2540963,156
+20534,2541119,129
+20699,2541248,143
+20604,2541391,117
+20551,2541508,60
+53356,2541568,143
+20647,2541711,141
+20565,2541852,101
+20594,2541953,139
+53486,2542092,156
+20507,2542248,148
+36951,2542396,148
+36995,2542544,154
+36925,2542698,144
+37079,2542842,139
+20611,2542981,124
+20700,2543105,171
+20488,2543276,163
+20562,2543439,142
+20519,2543581,155
+20570,2543736,150
+20537,2543886,144
+20580,2544030,140
+20664,2544170,160
+20571,2544330,157
+20684,2544487,155
+20502,2544642,142
+20511,2544784,149
+20547,2544933,158
+20629,2545091,133
+20730,2545224,124
+36920,2545348,155
+37040,2545503,109
+37103,2545612,144
+37061,2545756,153
+37004,2545909,145
+36936,2546054,148
+37049,2546202,157
+37060,2546359,142
+37029,2546501,129
+37027,2546630,141
+36994,2546771,129
+36864,2546900,144
+36974,2547044,125
+36948,2547169,172
+36961,2547341,190
+36875,2547531,150
+37070,2547681,178
+36871,2547859,145
+36909,2548004,166
+37076,2548170,159
+36905,2548329,107
+37087,2548436,165
+37056,2548601,152
+36895,2548753,150
+36900,2548903,143
+36922,2549046,138
+37042,2549184,141
+37046,2549325,135
+36963,2549460,192
+36962,2549652,164
+4307,2549816,143
+4347,2549959,171
+4179,2550130,158
+4333,2550288,161
+4204,2550449,126
+4329,2550575,129
+4099,2550704,142
+4209,2550846,116
+36885,2550962,165
+37013,2551127,146
+36929,2551273,148
+36954,2551421,153
+36881,2551574,131
+36965,2551705,144
+36899,2551849,127
+37110,2551976,137
+37032,2552113,158
+4138,2552271,150
+4325,2552421,142
+4253,2552563,150
+4110,2552713,151
+37100,2552864,116
+37059,2552980,152
+4296,2553132,215
+4339,2553347,178
+4230,2553525,146
+4319,2553671,143
+4210,2553814,147
+4314,2553961,137
+4324,2554098,130
+4222,2554228,151
+4256,2554379,157
+4118,2554536,122
+4240,2554658,128
+4341,2554786,140
+4157,2554926,127
+4246,2555053,154
+4226,2555207,160
+4248,2555367,154
+4162,2555521,137
+4200,2555658,150
+4330,2555808,137
+4270,2555945,164
+4292,2556109,183
+4350,2556292,177
+4182,2556469,153
+4301,2556622,136
+4193,2556758,128
+4249,2556886,144
+4321,2557030,125
+4283,2557155,175
+4128,2557330,160
+4154,2557490,138
+4100,2557628,161
+4335,2557789,142
+4232,2557931,156
+4130,2558087,154
+4214,2558241,122
+4159,2558363,159
+4169,2558522,129
+4190,2558651,189
+4271,2558840,149
+4236,2558989,155
+4343,2559144,152
+4267,2559296,185
+4112,2559481,145
+4338,2559626,117
+57351,2559743,156
+4286,2559899,163
+4184,2560062,153
+4111,2560215,148
+4284,2560363,135
+57535,2560498,182
+57571,2560680,141
+57542,2560821,134
+57573,2560955,152
+57441,2561107,154
+57427,2561261,140
+57555,2561401,134
+57411,2561535,117
+57523,2561652,148
+57581,2561800,124
+57528,2561924,131
+57468,2562055,147
+57382,2562202,136
+57376,2562338,118
+57357,2562456,134
+57564,2562590,136
+57399,2562726,138
+57538,2562864,120
+57595,2562984,129
+57499,2563113,158
+57413,2563271,130
+57408,2563401,158
+57370,2563559,160
+57464,2563719,141
+57479,2563860,190
+57409,2564050,108
+57570,2564158,131
+57473,2564289,139
+57431,2564428,176
+57532,2564604,166
+57474,2564770,110
+57463,2564880,129
+57430,2565009,147
+57393,2565156,177
+57355,2565333,156
+57522,2565489,159
+57391,2565648,155
+57470,2565803,148
+57497,2565951,121
+24750,2566072,150
+24659,2566222,165
+24662,2566387,155
+24588,2566542,134
+24604,2566676,144
+24671,2566820,152
+24721,2566972,153
+24605,2567125,146
+24699,2567271,138
+57452,2567409,218
+57418,2567627,154
+24777,2567781,135
+57466,2567916,125
+24626,2568041,131
+24627,2568172,138
+24595,2568310,141
+24610,2568451,147
+24814,2568598,129
+24792,2568727,141
+24815,2568868,174
+24709,2569042,133
+24593,2569175,151
+24821,2569326,140
+24674,2569466,140
+24809,2569606,163
+24643,2569769,135
+24616,2569904,159
+24816,2570063,157
+24800,2570220,150
+24726,2570370,142
+24634,2570512,154
+648,2570666,163
+24628,2570829,131
+24656,2570960,123
+24826,2571083,179
+24794,2571262,147
+24804,2571409,144
+24719,2571553,158
+24772,2571711,146
+41020,2571857,150
+41156,2572007,153
+41059,2572160,133
+41004,2572293,172
+41207,2572465,146
+41104,2572611,152
+41194,2572763,132
+41180,2572895,151
+40971,2573046,170
+41186,2573216,160
+41011,2573376,136
+41129,2573512,162
+41073,2573674,165
+24576,2573839,115
+24645,2573954,142
+41053,2574096,148
+41057,2574244,134
+24742,2574378,154
+24618,2574532,191
+41069,2574723,156
+41206,2574879,138
+24766,2575017,124
+24767,2575141,151
+24704,2575292,170
+41015,2575462,142
+41036,2575604,186
+41009,2575790,165
+41025,2575955,120
+41127,2576075,149
+41086,2576224,156
+41071,2576380,165
+41159,2576545,151
+40986,2576696,122
+41096,2576818,163
+41154,2576981,134
+41112,2577115,116
+41035,2577231,140
+41060,2577371,123
+41022,2577494,133
+40991,2577627,156
+41211,2577783,157
+41068,2577940,179
+41179,2578119,139
+41089,2578258,151
+41137,2578409,165
+8208,2578574,170
+8351,2578744,165
+41075,2578909,131
+41018,2579040,138
+41138,2579178,116
+41099,2579294,162
+41111,2579456,154
+40999,2579610,155
+41030,2579765,115
+41172,2579880,140
+41106,2580020,152
+8205,2580172,103
+8237,2580275,128
+8337,2580403,167
+8381,2580570,151
+8276,2580721,132
+8359,2580853,163
+8277,2581016,133
+8202,2581149,143
+8399,2581292,161
+8372,2581453,135
+8420,2581588,160
+8300,2581748,156
+8286,2581904,144
+8210,2582048,149
+8309,2582197,163
+8357,2582360,134
+8292,2582494,161
+8243,2582655,163
+8395,2582818,150
+8427,2582968,158
+8352,2583126,140
+8418,2583266,170
+8199,2583436,123
+8284,2583559,164
+8354,2583723,147
+8241,2583870,130
+8400,2584000,146
+8377,2584146,135
+8249,2584281,121
+8306,2584402,147
+8428,2584549,146
+8302,2584695,114
+8433,2584809,131
+8257,2584940,123
+8310,2585063,118
+8424,2585181,141
+8389,2585322,133
+8201,2585455,154
+8231,2585609,175
+8330,2585784,143
+8402,2585927,148
+8194,2586075,164
+8267,2586239,153
+8426,2586392,159
+8298,2586551,134
+8411,2586685,148
+8379,2586833,124
+8360,2586957,154
+8261,2587111,149
+8265,2587260,122
+8272,2587382,131
+8324,2587513,136
+8332,2587649,148
+8236,2587797,158
+8225,2587955,154
+49401,2588109,168
+49269,2588277,136
+7292,2588413,154
+49209,2588567,166
+49321,2588733,130
+49227,2588863,151
+49337,2589014,140
+49173,2589154,147
+49283,2589301,164
+49300,2589465,117
+49177,2589582,131
+49359,2589713,105
+49277,2589818,138
+49219,2589956,123
+49333,2590079,173
+49389,2590252,139
+49202,2590391,143
+49317,2590534,154
+49391,2590688,122
+49249,2590810,155
+49325,2590965,147
+49279,2591112,149
+49239,2591261,118
+49238,2591379,99
+49191,2591478,149
+49244,2591627,115
+49192,2591742,124
+49293,2591866,165
+49194,2592031,151
+49404,2592182,144
+49339,2592326,125
+49376,2592451,154
+49243,2592605,146
+49160,2592751,104
+49335,2592855,170
+49363,2593025,164
+49384,2593189,135
+49370,2593324,124
+49361,2593448,172
+49208,2593620,169
+16539,2593789,151
+16619,2593940,158
+16573,2594098,159
+16621,2594257,162
+16417,2594419,133
+16577,2594552,168
+16609,2594720,152
+16638,2594872,146
+16613,2595018,146
+16549,2595164,146
+16389,2595310,136
+16601,2595446,153
+16460,2595599,117
+49200,2595716,146
+49318,2595862,141
+49355,2596003,161
+49387,2596164,129
+16603,2596293,168
+49298,2596461,145
+49234,2596606,122
+16398,2596728,139
+49213,2596867,131
+16584,2596998,166
+16570,2597164,163
+16440,2597327,173
+16600,2597500,162
+16520,2597662,154
+16434,2597816,145
+16578,2597961,148
+16596,2598109,139
+16590,2598248,139
+16482,2598387,159
+16436,2598546,141
+16412,2598687,126
+16399,2598813,145
+16390,2598958,169
+32938,2599127,118
+49232,2599245,156
+16582,2599401,150
+16455,2599551,140
+16464,2599691,140
+32914,2599831,143
+32915,2599974,135
+32858,2600109,146
+16449,2600255,116
+32846,2600371,147
+32853,2600518,120
+32810,2600638,179
+32821,2600817,148
+32894,2600965,145
+33007,2601110,124
+33008,2601234,177
+32797,2601411,159
+32885,2601570,118
+32849,2601688,128
+32966,2601816,189
+32960,2602005,144
+32814,2602149,148
+33010,2602297,143
+32957,2602440,156
+32805,2602596,161
+33002,2602757,153
+30,2602910,154
+80,2603064,152
+32772,2603216,145
+32976,2603361,164
+32804,2603525,135
+32832,2603660,163
+32801,2603823,147
+33000,2603970,147
+32873,2604117,142
+32781,2604259,115
+32977,2604374,142
+32834,2604516,158
+32922,2604674,129
+32768,2604803,152
+33005,2604955,148
+32842,2605103,122
+102,2605225,154
+73,2605379,137
+250,2605516,160
+212,2605676,130
+25,2605806,173
+21,2605979,150
+28,2606129,135
+52,2606264,164
+34,2606428,148
+181,2606576,162
+47,2606738,140
+184,2606878,131
+230,2607009,153
+132,2607162,120
+154,2607282,114
+39,2607396,118
+232,2607514,154
+75,2607668,107
+224,2607775,123
+171,2607898,158
+32940,2608056,170
+79,2608226,127
+111,2608353,128
+120,2608481,127
+90,2608608,117
+91,2608725,134
+113,2608859,136
+115,2608995,147
+185,2609142,166
+191,2609308,167
+45,2609475,140
+24,2609615,171
+200,2609786,149
+213,2609935,157
+58,2610092,138
+89,2610230,133
+105,2610363,157
+231,2610520,143
+77,2610663,152
+35,2610815,136
+190,2610951,138
+217,2611089,156
+128,2611245,131
+524330,2611376,154
+524425,2611530,100
+524422,2611630,159
+524419,2611789,163
+524385,2611952,127
+524383,2612079,151
+524376,2612230,138
+524361,2612368,129
+524324,2612497,163
+524322,2612660,118
+524320,2612778,140
+524319,2612918,138
+524308,2613056,121
+11141120,2613177,160
+11141121,2613337,160
+11141122,2613497,160
+7,2613657,129
+32799,2613786,139
+524294,2613925,155
+319684,2614080,120
+132865,2614200,141
+524307,2614341,80
+56584,2614421,145
+5,2614566,129
+138364,2614695,154
+524389,2614849,122
+8694250,2614971,154
+14943736,2615125,213
+9,2615338,129
+33001,2615467,128
+16598,2615595,118
+524363,2615713,148
+174652,2615861,172
+524377,2616033,101
+524296,2616134,159
+16020616,2616293,185
+16564787,2616478,167
+4198773,2616645,154
+8401392,2616799,175
+5780774,2616974,179
+3454371,2617153,165
+7085547,2617318,117
+2642681,2617435,263
+12122195,2617698,158
+14733443,2617856,161
+7617560,2618017,151
+5013690,2618168,218
+9175802,2618386,214
+15738444,2618600,144
+13647186,2618744,147
+14158746,2618891,161
+11308340,2619052,196
+6574745,2619248,155
+16283044,2619403,189
+53937,2619592,233
+12641332,2619825,169
+7106829,2619994,139
+2387852,2620133,180
+1840006,2620313,180
+12332790,2620493,180
+4478404,2620673,180
+2089,2620853,199
+1852501,2621052,136
+16288350,2621188,130
+6088608,2621318,114
+14688136,2621432,219
+9231362,2621651,178
+11844732,2621829,130
+14723760,2621959,191
+6830403,2622150,149
+1099358,2622299,133
+8169392,2622432,236
+2109724,2622668,197
+1068888,2622865,189
+11855938,2623054,202
+971,2623256,145
+15771570,2623401,146
+6331181,2623547,192
+1352495,2623739,180
+316341,2623919,180
+47900,2624099,180
+8432764,2624279,207
+14437374,2624486,179
+5268053,2624665,154
+5821706,2624819,178
+8954627,2624997,161
+16572048,2625158,161
+1594575,2625319,161
+8419677,2625480,230
+15238342,2625710,196
+6565036,2625906,196
+576551,2626102,193
+316309,2626295,193
+14718982,2626488,170
+16043938,2626658,170
+16260719,2626828,159
+15770458,2626987,123
+6325107,2627110,123
+8695181,2627233,123
+7619211,2627356,123
+1347896,2627479,141
+7094542,2627620,141
+7090446,2627761,139
+2652145,2627900,123
+11069309,2628023,130
+14439485,2628153,214
+820295,2628367,199
+10251122,2628566,256
+5293741,2628822,199
+7637544,2629021,127
+13902995,2629148,183
+9190,2629331,154
+15509824,2629485,139
+16549270,2629624,127
+6075618,2629751,164
+3952910,2629915,141
+14200528,2630056,220
+14714266,2630276,217
+803489,2630493,171
+11827953,2630664,158
+3448699,2630822,135
+16046534,2630957,198
+3469648,2631155,222
+13390473,2631377,232
+13393272,2631609,151
+12384754,2631760,129
+3748,2631889,127
+20612,2632016,127
+8429467,2632143,207
+11021261,2632350,196
+4774957,2632546,196
+11332433,2632742,161
+6295714,2632903,147
+12890681,2633050,141
+11576404,2633191,138
+6590657,2633329,242
+13393118,2633571,192
+6344326,2633763,159
+5001198,2633922,212
+5038453,2634134,141
+11019448,2634275,114
+3302,2634389,126
+9459166,2634515,199
+15241487,2634714,199
+13632996,2634913,180
+3189476,2635093,180
+1354582,2635273,212
+15259857,2635485,112
+2674116,2635597,234
+3295,2635831,151
+2920875,2635982,206
+8420158,2636188,161
+16314854,2636349,161
+8956343,2636510,123
+15519447,2636633,123
+4778850,2636756,178
+6087030,2636934,139
+11309189,2637073,123
+3426541,2637196,117
+3954481,2637313,141
+7099880,2637454,166
+3420093,2637620,156
+10497299,2637776,172
+8677576,2637948,201
+10234103,2638149,219
+1069596,2638368,170
+7094955,2638538,160
+6616823,2638698,170
+9706582,2638868,155
+14158795,2639023,201
+15790244,2639224,141
+12637826,2639365,144
+13380891,2639509,145
+8447296,2639654,139
+3508,2639793,132
+2945117,2639925,160
+9714608,2640085,185
+9454562,2640270,139
+8400969,2640409,174
+15223107,2640583,214
+5248008,2640797,121
+2661111,2640918,153
+11579796,2641071,178
+1098667,2641249,196
+2626028,2641445,196
+14952070,2641641,217
+26925,2641858,168
+3730247,2642026,196
+800662,2642222,153
+15991594,2642375,141
+1341248,2642516,180
+11801982,2642696,134
+1628559,2642830,180
+6577708,2643010,157
+57580,2643167,154
+7354385,2643321,164
+6578790,2643485,154
+4750070,2643639,230
+4746864,2643869,259
+6299037,2644128,186
+14180215,2644314,201
+2922477,2644515,179
+2130538,2644694,213
+12095559,2644907,123
+9477194,2645030,123
+9473091,2645153,123
+1608298,2645276,144
+3964170,2645420,123
+13929017,2645543,161
+15004612,2645704,161
+10235726,2645865,178
+15732880,2646043,185
+573344,2646228,161
+7348028,2646389,161
+2117863,2646550,203
+14198984,2646753,178
+3678946,2646931,112
+573675,2647043,171
+14999826,2647214,130
+3413173,2647344,130
+13632491,2647474,130
+9755478,2647604,213
+8953448,2647817,166
+6556076,2647983,172
+7617263,2648155,168
+1613356,2648323,180
+6051192,2648503,110
+7141138,2648613,109
+5031230,2648722,187
+9459452,2648909,253
+12084114,2649162,213
+6863315,2649375,275
+12109482,2649650,207
+5549776,2649857,198
+1077501,2650055,171
+3732993,2650226,198
+4251309,2650424,137
+4257056,2650561,170
+7907970,2650731,185
+2124938,2650916,147
+3442052,2651063,147
+4200625,2651210,147
+8936413,2651357,147
+10022236,2651504,126
+12862056,2651630,152
+5534173,2651782,180
+14985033,2651962,140
+8705733,2652102,142
+14192950,2652244,145
+13140756,2652389,136
+12116974,2652525,161
+2410707,2652686,167
+6313060,2652853,171
+16553322,2653024,152
+4240158,2653176,161
+8929331,2653337,196
+14743221,2653533,156
+11303510,2653689,141
+4492735,2653830,138
+9734854,2653968,257
+12625517,2654225,153
+7401622,2654378,141
+8358,2654519,132
+5787885,2654651,202
+1310,2654853,172
+9997066,2655025,202
+12368578,2655227,202
+11324241,2655429,202
+14734434,2655631,180
+9476152,2655811,180
+8703144,2655991,170
+12907900,2656161,172
+4850,2656333,172
+7090058,2656505,161
+15773730,2656666,170
+9993930,2656836,207
+2924539,2657043,178
+5257263,2657221,166
+791762,2657387,192
+13957161,2657579,178
+14705204,2657757,130
+7376059,2657887,153
+12077226,2658040,147
+14169326,2658187,127
+16275246,2658314,137
+7313,2658451,123
+2378750,2658574,167
+8183273,2658741,177
+16280537,2658918,141
+12588286,2659059,141
+8170831,2659200,141
+536996,2659341,180
+11069816,2659521,180
+16265061,2659701,180
+2667377,2659881,135
+568516,2660016,102
+14438458,2660118,183
+1591101,2660301,234
+13924274,2660535,169
+7386600,2660704,117
+9708851,2660821,196
+6313569,2661017,182
+809372,2661199,137
+4519143,2661336,121
+7367033,2661457,154
+16539803,2661611,185
+15245816,2661796,178
+10004802,2661974,300
+3162688,2662274,178
+4989203,2662452,189
+8400319,2662641,141
+2421072,2662782,254
+1084266,2663036,223
+1362059,2663259,123
+15476305,2663382,123
+1588975,2663505,123
+6323913,2663628,123
+4229167,2663751,145
+14957850,2663896,134
+6573110,2664030,140
+4753895,2664170,140
+2420378,2664310,140
+6064028,2664450,140
+5303153,2664590,140
+843044,2664730,140
+9746541,2664870,140
+2102969,2665010,140
+3717880,2665150,140
+3959463,2665290,140
+3465517,2665430,140
+47968,2665570,140
+6354551,2665710,140
+10520681,2665850,140
+7661049,2665990,140
+8388619,2666130,140
+3424605,2666270,140
+16545652,2666410,140
+9972924,2666550,140
+3993617,2666690,140
+2654159,2666830,140
+8401491,2666970,140
+14205094,2667110,169
+10288360,2667279,140
+16297061,2667419,140
+1053435,2667559,202
+588409,2667761,197
+15768504,2667958,196
+12326840,2668154,140
+12110633,2668294,117
+4504379,2668411,139
+1360206,2668550,139
+9199293,2668689,180
+2924610,2668869,180
+15515675,2669049,196
+9979086,2669245,196
+13422723,2669441,189
+12616649,2669630,180
+12590128,2669810,262
+14206584,2670072,158
+4463743,2670230,193
+47286,2670423,193
+1893917,2670616,161
+8393439,2670777,275
+12886353,2671052,240
+1107834,2671292,196
+8448519,2671488,252
+12321703,2671740,142
+9467551,2671882,260
+9973752,2672142,180
+4250789,2672322,180
+2912081,2672502,202
+303859,2672704,199
+13425555,2672903,141
+1627676,2673044,257
+5523686,2673301,227
+6345961,2673528,213
+3196175,2673741,196
+2648274,2673937,196
+9480501,2674133,143
+10782382,2674276,192
+1889982,2674468,178
+2674983,2674646,242
+13134046,2674888,180
+13635063,2675068,180
+4720098,2675248,180
+16259844,2675428,269
+14191737,2675697,139
+1061915,2675836,119
+3187794,2675955,144
+7784,2676099,172
+9099,2676271,180
+2908172,2676451,150
+9225652,2676601,178
+2978,2676779,176
+2294,2676955,176
+95,2677131,176
+1633511,2677307,159
+16017877,2677466,154
+539378,2677620,170
+7617056,2677790,185
+3197355,2677975,275
+3938974,2678250,124
+12900152,2678374,180
+13141153,2678554,141
+14186379,2678695,134
+1000,2678829,150
+7125688,2678979,178
+14734436,2679157,140
+12646082,2679297,196
+13938679,2679493,144
+6293372,2679637,147
+6330470,2679784,130
+16306215,2679914,166
+6055532,2680080,213
+5000185,2680293,154
+1894923,2680447,156
+4517823,2680603,189
+12066654,2680792,146
+14160485,2680938,234
+5026890,2681172,162
+298138,2681334,180
+15482043,2681514,180
+9190014,2681694,161
+7357468,2681855,194
+11828313,2682049,211
+3149214,2682260,198
+15530588,2682458,242
+16299114,2682700,139
+12366055,2682839,196
+5518575,2683035,196
+8967592,2683231,214
+2131347,2683445,154
+11330370,2683599,196
+9443272,2683795,196
+14979626,2683991,200
+2909215,2684191,111
+2127705,2684302,282
+5564373,2684584,168
+1609864,2684752,122
+5002975,2684874,134
+2364688,2685008,154
+7097681,2685162,226
+8953240,2685388,153
+14481593,2685541,178
+1621788,2685719,190
+11329096,2685909,60
+20679,2685969,60
+8295,2686029,60
+4719045,2686089,212
+11857445,2686301,179
+13118358,2686480,170
+9982525,2686650,181
+13637030,2686831,189
+355,2687020,141
+6316876,2687161,189
+2121533,2687350,204
+295323,2687554,121
+14680196,2687675,196
+2926748,2687871,165
+5037069,2688036,150
+19969,2688186,117
+12902817,2688303,213
+11322200,2688516,199
+3992815,2688715,149
+1594851,2688864,123
+14962923,2688987,123
+8938560,2689110,123
+6320320,2689233,123
+15778673,2689356,123
+6618890,2689479,178
+15767833,2689657,139
+222,2689796,97
+16006758,2689893,198
+14432623,2690091,206
+11846774,2690297,216
+6829193,2690513,140
+11824199,2690653,171
+4473391,2690824,156
+5544999,2690980,171
+13651536,2691151,238
+9748352,2691389,178
+9992724,2691567,143
+13123036,2691710,219
+10238618,2691929,286
+11580904,2692215,141
+316816,2692356,130
+5510537,2692486,185
+8673075,2692671,141
+9251,2692812,188
+9197884,2693000,154
+6302165,2693154,147
+5281604,2693301,214
+5829532,2693515,142
+12861726,2693657,167
+30692,2693824,109
+44387,2693933,170
+14947830,2694103,130
+11289128,2694233,133
+15998315,2694366,197
+8187035,2694563,233
+13406320,2694796,141
+2638278,2694937,197
+3670296,2695134,128
+1355210,2695262,218
+8425779,2695480,169
+11859342,2695649,196
+12881857,2695845,167
+16262023,2696012,179
+15214785,2696191,147
+7918407,2696338,127
+10789241,2696465,230
+6871911,2696695,175
+1579478,2696870,161
+12359903,2697031,193
+7404687,2697224,132
+5249842,2697356,151
+9964903,2697507,187
+728,2697694,180
+11577077,2697874,129
+11335142,2698003,141
+14463106,2698144,114
+16302999,2698258,151
+7396776,2698409,213
+5009308,2698622,213
+7875625,2698835,185
+12361700,2699020,189
+7351936,2699209,163
+11314286,2699372,171
+13153314,2699543,164
+9760415,2699707,127
+14428833,2699834,131
+15004648,2699965,276
+16003645,2700241,258
+16299927,2700499,151
+11578066,2700650,258
+1086359,2700908,139
+5273073,2701047,139
+12870934,2701186,139
+14949898,2701325,154
+13410603,2701479,290
+11272400,2701769,178
+15254551,2701947,199
+7843,2702146,135
+3732270,2702281,126
+9969177,2702407,178
+8697958,2702585,236
+1621082,2702821,232
+12894520,2703053,138
+11286473,2703191,139
+2119785,2703330,135
+13383595,2703465,165
+1319643,2703630,119
+13132564,2703749,154
+2371924,2703903,196
+2906344,2704099,196
+7392657,2704295,171
+2889845,2704466,212
+13659870,2704678,178
+1587612,2704856,149
+9749181,2705005,125
+4752308,2705130,213
+8698040,2705343,271
+13648329,2705614,199
+15204749,2705813,199
+1090488,2706012,130
+15264931,2706142,218
+566972,2706360,141
+7347816,2706501,150
+1881065,2706651,241
+9213535,2706892,219
+12584778,2707111,127
+15250174,2707238,166
+8453498,2707404,134
+6138,2707538,156
+9704997,2707694,123
+5520176,2707817,121
+4256284,2707938,145
+11582347,2708083,217
+3451115,2708300,123
+9748420,2708423,135
+10781671,2708558,123
+16035815,2708681,123
+11307261,2708804,123
+5258876,2708927,274
+2381934,2709201,178
+11838213,2709379,181
+8404552,2709560,171
+2375472,2709731,160
+3969408,2709891,174
+2110060,2710065,161
+6588913,2710226,161
+2110715,2710387,219
+11050221,2710606,219
+7120388,2710825,139
+6093277,2710964,115
+13691957,2711079,141
+1093216,2711220,60
+9695,2711280,60
+12373839,2711340,187
+12587185,2711527,127
+9472351,2711654,225
+4773957,2711879,204
+843841,2712083,114
+12095412,2712197,154
+21186,2712351,151
+9196498,2712502,192
+13915011,2712694,178
+10502726,2712872,179
+849013,2713051,140
+6881147,2713191,252
+8425245,2713443,252
+4686,2713695,147
+8970292,2713842,199
+4766990,2714041,166
+3945,2714207,158
+14964967,2714365,161
+4170,2714526,156
+13654208,2714682,215
+16307320,2714897,236
+4768688,2715133,139
+14440636,2715272,137
+4133,2715409,128
+3678663,2715537,189
+10772379,2715726,157
+7399962,2715883,141
+8424075,2716024,197
+9979062,2716221,124
+3703706,2716345,217
+14444323,2716562,155
+4502626,2716717,236
+9745423,2716953,189
+6686,2717142,189
+9324,2717331,189
+2104265,2717520,137
+13170376,2717657,199
+1850255,2717856,150
+15001417,2718006,139
+15517055,2718145,220
+3719866,2718365,138
+10549687,2718503,254
+11025611,2718757,107
+8941524,2718864,117
+13385706,2718981,130
+5042879,2719111,192
+13409954,2719303,139
+11289392,2719442,149
+15227831,2719591,150
+9725822,2719741,216
+11294581,2719957,127
+13908526,2720084,235
+5287314,2720319,155
+3195865,2720474,144
+12823,2720618,141
+7163,2720759,167
+9756886,2720926,189
+11839996,2721115,173
+7121206,2721288,169
+7374144,2721457,212
+586218,2721669,158
+15732213,2721827,169
+6833649,2721996,203
+9219803,2722199,141
+7909907,2722340,217
+5816882,2722557,156
+3677460,2722713,124
+8182680,2722837,164
+3672892,2723001,130
+10259672,2723131,158
+10783936,2723289,151
+3942509,2723440,139
+2362,2723579,127
+326105,2723706,210
+14419983,2723916,123
+16312654,2724039,123
+15477986,2724162,123
+4242528,2724285,123
+15218199,2724408,123
+10249355,2724531,123
+3424866,2724654,123
+1363981,2724777,123
+8966673,2724900,144
+12108327,2725044,147
+7665463,2725191,134
+4760723,2725325,147
+15215725,2725472,139
+4777621,2725611,135
+11827656,2725746,135
+11799416,2725881,140
+12598745,2726021,158
+2927246,2726179,144
+7354961,2726323,219
+14436530,2726542,140
+11316761,2726682,125
+1580693,2726807,115
+824641,2726922,245
+11335772,2727167,60
+10250551,2727227,139
+3946374,2727366,122
+4732206,2727488,205
+320920,2727693,219
+1053364,2727912,238
+12070048,2728150,121
+7129068,2728271,221
+11547558,2728492,137
+14194309,2728629,114
+3932655,2728743,183
+12631496,2728926,161
+6585294,2729087,161
+11044787,2729248,161
+7077995,2729409,161
+4192,2729570,146
+12899465,2729716,215
+11860297,2729931,194
+14957696,2730125,157
+3943472,2730282,117
+7367957,2730399,141
+10789348,2730540,186
+9759466,2730726,245
+1899784,2730971,154
+12081567,2731125,171
+3150729,2731296,179
+289573,2731475,238
+10015719,2731713,117
+15754233,2731830,196
+8176517,2732026,196
+9440947,2732222,247
+5545902,2732469,168
+1337762,2732637,238
+5537832,2732875,158
+44324,2733033,189
+5506699,2733222,215
+6344338,2733437,219
+1072045,2733656,196
+7651264,2733852,135
+13162962,2733987,139
+2424037,2734126,175
+8427041,2734301,116
+7865695,2734417,220
+60093,2734637,141
+4753197,2734778,266
+15211096,2735044,150
+2142209,2735194,136
+12631975,2735330,137
+15750292,2735467,164
+6080921,2735631,185
+11545155,2735816,139
+12875000,2735955,147
+1319475,2736102,199
+7615488,2736301,167
+14432087,2736468,214
+20633,2736682,134
+310407,2736816,283
+5555006,2737099,133
+15497714,2737232,214
+12366379,2737446,161
+13937538,2737607,139
+7360440,2737746,139
+24811,2737885,144
+1598180,2738029,130
+6305216,2738159,145
+12884060,2738304,222
+3187194,2738526,196
+2371216,2738722,171
+10267163,2738893,143
+11049619,2739036,178
+6853,2739214,165
+8222,2739379,155
+6578826,2739534,131
+267737,2739665,114
+15512339,2739779,171
+11570127,2739950,141
+24716,2740091,115
+40996,2740206,115
+8367,2740321,115
+4171,2740436,115
+11033331,2740551,277
+7404870,2740828,161
+9208801,2740989,161
+8953711,2741150,161
+6054857,2741311,140
+825062,2741451,242
+3967380,2741693,121
+14683873,2741814,164
+3139,2741978,159
+9212486,2742137,164
+3732,2742301,165
+4757706,2742466,207
+2391633,2742673,178
+15250753,2742851,178
+826770,2743029,167
+9998036,2743196,214
+15247240,2743410,205
+5778740,2743615,241
+2154120,2743856,143
+15992461,2743999,127
+6705,2744126,129
+7044,2744255,147
+4730016,2744402,219
+3412729,2744621,196
+12378725,2744817,196
+5034401,2745013,196
+8962020,2745209,196
+4200418,2745405,161
+838533,2745566,193
+10806805,2745759,285
+7610233,2746044,229
+10523473,2746273,141
+9962395,2746414,170
+2132356,2746584,236
+11849470,2746820,129
+16305262,2746949,180
+16266907,2747129,130
+8957469,2747259,220
+12093667,2747479,246
+2662140,2747725,178
+49237,2747903,160
+14950377,2748063,151
+12865933,2748214,254
+4745268,2748468,163
+4403,2748631,136
+2851,2748767,166
+6558513,2748933,193
+1587784,2749126,122
+7876375,2749248,137
+11534974,2749385,140
+2423539,2749525,256
+8966847,2749781,137
+2102845,2749918,214
+14709599,2750132,108
+20973,2750240,139
+4250781,2750379,140
+3410584,2750519,196
+6581612,2750715,196
+12892340,2750911,196
+15776969,2751107,133
+4748675,2751240,136
+9456769,2751376,158
+9188729,2751534,158
+3720970,2751692,153
+14185994,2751845,136
+6041298,2751981,195
+16579579,2752176,141
+32405,2752317,141
+10246724,2752458,221
+1362592,2752679,110
+578666,2752789,189
+6830622,2752978,142
+4119,2753120,173
+16051732,2753293,246
+7100736,2753539,246
+13640982,2753785,246
+1859806,2754031,246
+14165111,2754277,166
+36991,2754443,163
+5004812,2754606,124
+13945453,2754730,125
+5234,2754855,222
+8435061,2755077,196
+10796587,2755273,196
+6875074,2755469,161
+5812495,2755630,161
+4196000,2755791,130
+16264640,2755921,139
+1612839,2756060,139
+3995084,2756199,185
+13666961,2756384,165
+2625957,2756549,136
+14218203,2756685,113
+14464172,2756798,259
+10785483,2757057,114
+12636915,2757171,222
+12092163,2757393,158
+2112957,2757551,139
+10769285,2757690,224
+16431,2757914,143
+322747,2758057,199
+6595321,2758256,212
+11042066,2758468,196
+13902114,2758664,159
+49154,2758823,159
+12359953,2758982,187
+2622021,2759169,203
+14978917,2759372,187
+168,2759559,156
+1276,2759715,156
+3941616,2759871,154
+47930,2760025,141
+832335,2760166,318
+3994873,2760484,171
+9705786,2760655,116
+12615989,2760771,211
+8654222,2760982,170
+8322,2761152,143
+11845877,2761295,257
+4219441,2761552,173
+16562160,2761725,157
+2894007,2761882,257
+1074480,2762139,117
+289563,2762256,219
+11576190,2762475,193
+3992313,2762668,205
+5823253,2762873,253
+5263566,2763126,255
+16542023,2763381,130
+14712298,2763511,130
+14474831,2763641,224
+5034187,2763865,196
+5266860,2764061,196
+15268599,2764257,246
+9739607,2764503,160
+8967035,2764663,129
+1861229,2764792,193
+8713195,2764985,170
+6984,2765155,202
+9484,2765357,135
+819299,2765492,252
+29304,2765744,141
+6576877,2765885,123
+12629592,2766008,123
+4761884,2766131,123
+5291158,2766254,123
+16525980,2766377,123
+6827131,2766500,141
+4464280,2766641,135
+10508019,2766776,123
+5544291,2766899,123
+9493853,2767022,123
+14428441,2767145,249
+8937448,2767394,154
+12249,2767548,199
+11848999,2767747,196
+13113847,2767943,161
+6603734,2768104,137
+40993,2768241,165
+15773520,2768406,149
+12856399,2768555,221
+2411211,2768776,199
+5520996,2768975,199
+6554315,2769174,139
+16048414,2769313,130
+3703007,2769443,193
+12347951,2769636,140
+788660,2769776,166
+9989,2769942,135
+4767037,2770077,185
+1592328,2770262,155
+14418533,2770417,122
+1576822,2770539,189
+1353515,2770728,220
+10803746,2770948,154
+3938064,2771102,178
+14447259,2771280,196
+9475223,2771476,196
+3408539,2771672,193
+9438066,2771865,319
+8706974,2772184,114
+837324,2772298,196
+7886944,2772494,196
+15248371,2772690,196
+3988668,2772886,161
+8408688,2773047,161
+13952695,2773208,161
+9194669,2773369,126
+9238871,2773495,259
+5011309,2773754,141
+7659906,2773895,130
+4497145,2774025,197
+7128277,2774222,127
+8439112,2774349,309
+1098330,2774658,165
+15261435,2774823,136
+12845229,2774959,194
+9764509,2775153,171
+7124682,2775324,110
+315706,2775434,219
+5030406,2775653,117
+264563,2775770,158
+3447255,2775928,166
+822227,2776094,214
+12626160,2776308,166
+10240798,2776474,154
+9391,2776628,152
+2632706,2776780,154
+16556419,2776934,139
+7088843,2777073,142
+5782489,2777215,199
+14459494,2777414,193
+12878950,2777607,123
+3439653,2777730,123
+13381047,2777853,123
+10534349,2777976,121
+12358069,2778097,230
+2633666,2778327,161
+9961588,2778488,191
+1622429,2778679,214
+825400,2778893,219
+7662283,2779112,185
+13900351,2779297,213
+14201122,2779510,137
+11847577,2779647,150
+6581868,2779797,132
+15240800,2779929,130
+3995,2780059,141
+9402,2780200,144
+6312236,2780344,172
+6609793,2780516,150
+4500761,2780666,229
+3714494,2780895,185
+6073718,2781080,276
+6063708,2781356,175
+323880,2781531,127
+307559,2781658,219
+15500112,2781877,143
+13633482,2782020,137
+1892178,2782157,130
+3196167,2782287,132
+13125007,2782419,117
+7097,2782536,198
+9313,2782734,138
+807427,2782872,192
+2905233,2783064,143
+3676099,2783207,158
+7709,2783365,159
+7882436,2783524,187
+6087308,2783711,187
+14990667,2783898,178
+3725258,2784076,126
+324,2784202,115
+524315,2784317,118
+8126730,2784435,130
+14953268,2784565,123
+3944185,2784688,123
+10505895,2784811,123
+15767709,2784934,123
+16570045,2785057,128
+7348051,2785185,141
+1587566,2785326,233
+15498513,2785559,197
+4722412,2785756,252
+5258922,2786008,252
+5767355,2786260,137
+4766286,2786397,139
+14157873,2786536,161
+9716161,2786697,145
+5263068,2786842,145
+550734,2786987,195
+5246848,2787182,141
+1110514,2787323,189
+9201864,2787512,178
+15499875,2787690,178
+6831229,2787868,232
+793632,2788100,125
+2422178,2788225,167
+7650259,2788392,259
+9709614,2788651,185
+10024361,2788836,104
+14196467,2788940,117
+3690313,2789057,137
+5029263,2789194,202
+15526840,2789396,158
+7124809,2789554,196
+10001495,2789750,196
+1593986,2789946,199
+9190474,2790145,164
+7374529,2790309,130
+16046002,2790439,153
+5418,2790592,135
+10242683,2790727,134
+14180706,2790861,178
+2655246,2791039,170
+8413535,2791209,255
+2937575,2791464,134
+3698338,2791598,197
+9973096,2791795,166
+12332616,2791961,139
+6327526,2792100,139
+524400,2792239,148
+4475568,2792387,239
+14445290,2792626,230
+12853704,2792856,153
+8418207,2793009,152
+4779099,2793161,109
+7362578,2793270,188
+270490,2793458,193
+3408010,2793651,154
+10752277,2793805,256
+4249148,2794061,241
+16053162,2794302,132
+9457866,2794434,208
+4233506,2794642,169
+12610842,2794811,278
+1080132,2795089,167
+8660287,2795256,151
+2249,2795407,161
+14201130,2795568,203
+11540934,2795771,123
+3696368,2795894,123
+32777,2796017,156
+49252,2796173,152
+15231001,2796325,196
+1878836,2796521,185
+3962947,2796706,196
+6031737,2796902,196
+15006557,2797098,196
+460,2797294,188
+12488,2797482,120
+5856,2797602,129
+14212814,2797731,143
+7356076,2797874,123
+4544,2797997,166
+1521,2798163,121
+11292972,2798284,230
+3184949,2798514,178
+815833,2798692,178
+1073872,2798870,165
+5268523,2799035,194
+2637850,2799229,144
+3194907,2799373,288
+8947394,2799661,149
+567457,2799810,165
+16037152,2799975,217
+13381489,2800192,139
+7365,2800331,129
+8944177,2800460,197
+9178991,2800657,168
+9184517,2800825,196
+9190317,2801021,122
+6606809,2801143,130
+7634212,2801273,182
+13669478,2801455,117
+3728789,2801572,261
+12359296,2801833,261
+10779549,2802094,170
+12122302,2802264,125
+9346,2802389,135
+6853172,2802524,135
+5285683,2802659,135
+2907539,2802794,135
+3735350,2802929,135
+8656954,2803064,135
+2410913,2803199,135
+8138461,2803334,161
+3995556,2803495,161
+1060916,2803656,185
+254,2803841,170
+53279,2804011,158
+14732220,2804169,142
+6572000,2804311,209
+11816854,2804520,211
+5006760,2804731,154
+11591617,2804885,230
+10252114,2805115,178
+15232357,2805293,179
+7368301,2805472,141
+6309730,2805613,258
+12328065,2805871,191
+9439770,2806062,151
+5271186,2806213,204
+3210801,2806417,114
+10023603,2806531,158
+12867359,2806689,132
+8940259,2806821,200
+1854832,2807021,139
+14164724,2807160,116
+3444519,2807276,135
+2924268,2807411,202
+7418,2807613,119
+6304059,2807732,168
+7123495,2807900,188
+9989984,2808088,213
+3243,2808301,157
+7623719,2808458,248
+6320651,2808706,134
+3180918,2808840,189
+2893335,2809029,127
+3463508,2809156,156
+4741085,2809312,121
+4750638,2809433,252
+11590393,2809685,139
+1586641,2809824,139
+12625373,2809963,260
+4754742,2810223,158
+12375827,2810381,122
+15262177,2810503,162
+2623245,2810665,234
+41937,2810899,141
+16534924,2811040,250
+16516845,2811290,190
+15783158,2811480,122
+16034199,2811602,135
+6610921,2811737,120
+1099516,2811857,146
+11280901,2812003,189
+8429622,2812192,243
+15758469,2812435,139
+4218109,2812574,117
+2159698,2812691,228
+5282380,2812919,117
+10488140,2813036,124
+11811124,2813160,162
+7612076,2813322,142
+11544104,2813464,135
+9991386,2813599,230
+4240624,2813829,137
+1326887,2813966,115
+1071239,2814081,199
+7359653,2814280,130
+10225179,2814410,214
+5256075,2814624,130
+6825514,2814754,248
+15261326,2815002,214
+14211174,2815216,218
+14205034,2815434,295
+11280430,2815729,208
+10236585,2815937,248
+1858059,2816185,138
+290306,2816323,130
+9440899,2816453,150
+6296678,2816603,178
+6837485,2816781,139
+6816309,2816920,175
+3714109,2817095,126
+14694335,2817221,178
+15209319,2817399,140
+4498,2817539,141
+3731765,2817680,143
+11301897,2817823,214
+12885485,2818037,143
+10003470,2818180,119
+15991619,2818299,158
+15766469,2818457,138
+9965800,2818595,123
+12636178,2818718,123
+12364064,2818841,123
+4759957,2818964,123
+16253815,2819087,123
+16029236,2819210,139
+1080602,2819349,117
+7384868,2819466,147
+10752355,2819613,154
+12898711,2819767,169
+2918098,2819936,141
+8186236,2820077,214
+8411384,2820291,193
+14460106,2820484,123
+9211881,2820607,123
+7384869,2820730,149
+15257883,2820879,164
+12067407,2821043,248
+9961665,2821291,222
+5562797,2821513,189
+10015698,2821702,149
+810805,2821851,169
+16294735,2822020,178
+6418,2822198,181
+9205975,2822379,248
+12118698,2822627,174
+12122243,2822801,252
+14482968,2823053,252
+7360343,2823305,252
+11584620,2823557,138
+673,2823695,132
+57378,2823827,150
+1357816,2823977,165
+9452907,2824142,188
+11550857,2824330,153
+5514730,2824483,196
+3964783,2824679,170
+6076983,2824849,147
+49350,2824996,134
+2686669,2825130,251
+13145275,2825381,196
+1094136,2825577,196
+564744,2825773,139
+8461,2825912,141
+13136676,2826053,183
+7958,2826236,164
+9773,2826400,164
+300518,2826564,230
+5301862,2826794,257
+5843,2827051,164
+5000707,2827215,172
+9471604,2827387,248
+9443089,2827635,168
+4318,2827803,186
+12638711,2827989,227
+24715,2828216,162
+7351684,2828378,148
+2891787,2828526,123
+8939173,2828649,123
+631,2828772,134
+13410841,2828906,259
+4987450,2829165,197
+1356575,2829362,117
+11321838,2829479,219
+5511624,2829698,197
+11581834,2829895,122
+8411652,2830017,189
+9217441,2830206,181
+12119203,2830387,187
+12354437,2830574,143
+5176,2830717,159
+14987269,2830876,266
+72,2831142,156
+11593874,2831298,151
+11278374,2831449,151
+10808919,2831600,151
+10268371,2831751,160
+7371881,2831911,122
+5245841,2832033,154
+16270876,2832187,173
+7359867,2832360,167
+6596239,2832527,241
+3718145,2832768,196
+3415659,2832964,196
+8939065,2833160,196
+16986,2833356,141
+1629170,2833497,117
+1636474,2833614,155
+4990695,2833769,144
+24641,2833913,203
+13112997,2834116,128
+786983,2834244,165
+4985279,2834409,218
+2906506,2834627,189
+11555350,2834816,193
+10544331,2835009,187
+2641623,2835196,149
+1353611,2835345,187
+10533112,2835532,144
+8930423,2835676,196
+1350921,2835872,196
+6842741,2836068,133
+2151007,2836201,153
+14974397,2836354,175
+10288085,2836529,197
+1636203,2836726,206
+5779730,2836932,114
+10257343,2837046,149
+7925580,2837195,196
+5794156,2837391,198
+4772675,2837589,139
+49242,2837728,169
+2041,2837897,117
+7347,2838014,123
+4223363,2838137,137
+13114204,2838274,153
+6087438,2838427,139
+1884385,2838566,154
+6713,2838720,132
+16575706,2838852,146
+45281,2838998,141
+20627,2839139,121
+9460804,2839260,189
+4504134,2839449,245
+14711827,2839694,178
+15998856,2839872,178
+1371579,2840050,126
+1630879,2840176,197
+2682450,2840373,252
+6845009,2840625,143
+11860964,2840768,146
+7371152,2840914,196
+10505729,2841110,184
+2673161,2841294,232
+8660249,2841526,161
+6038595,2841687,169
+2396686,2841856,161
+16531971,2842017,161
+10489985,2842178,161
+3967949,2842339,196
+5044573,2842535,196
+8659441,2842731,196
+61996,2842927,223
+1518,2843150,169
+15759712,2843319,123
+10540949,2843442,123
+37095,2843565,135
+14958295,2843700,158
+5526735,2843858,199
+16278335,2844057,139
+558624,2844196,253
+15783359,2844449,139
+6583542,2844588,157
+9966387,2844745,178
+2115565,2844923,121
+7637609,2845044,180
+12339040,2845224,161
+268303,2845385,161
+2102240,2845546,161
+9574,2845707,161
+13687602,2845868,132
+15204406,2846000,156
+12623621,2846156,213
+6048121,2846369,206
+12646725,2846575,194
+7403751,2846769,154
+13904964,2846923,141
+8666566,2847064,141
+9349,2847205,133
+2686198,2847338,250
+8024,2847588,152
+6853667,2847740,193
+8670197,2847933,193
+585145,2848126,193
+3962854,2848319,193
+7346315,2848512,193
+6057248,2848705,193
+6073420,2848898,193
+5855,2849091,126
+7436,2849217,153
+12095199,2849370,249
+14446916,2849619,183
+9964674,2849802,192
+10488762,2849994,191
+6319037,2850185,180
+8524,2850365,163
+575155,2850528,143
+6319,2850671,155
+7905,2850826,161
+5739,2850987,181
+240,2851168,163
+9226445,2851331,177
+11072116,2851508,161
+13928408,2851669,161
+1590807,2851830,161
+3672724,2851991,161
+13688775,2852152,161
+13681073,2852313,161
+8394919,2852474,177
+16022366,2852651,177
+7403815,2852828,161
+3467036,2852989,254
+8940209,2853243,197
+7085712,2853440,173
+23059,2853613,196
+12865542,2853809,160
+8925851,2853969,173
+1329632,2854142,173
+13641028,2854315,185
+12338310,2854500,160
+2151312,2854660,160
+9699778,2854820,160
+5307551,2854980,160
+3672896,2855140,160
+12124001,2855300,123
+9724196,2855423,138
+15757964,2855561,160
+3451531,2855721,160
+2415597,2855881,160
+13164113,2856041,132
+10023000,2856173,143
+6865997,2856316,193
+4197648,2856509,139
+9715145,2856648,134
+4457540,2856782,213
+6014,2856995,151
+10486880,2857146,122
+9995491,2857268,130
+3723881,2857398,130
+13171993,2857528,130
+5278897,2857658,130
+12907941,2857788,143
+7385422,2857931,139
+3163271,2858070,226
+2923806,2858296,196
+33220,2858492,141
+5826678,2858633,154
+13645634,2858787,312
+5989,2859099,132
+5608,2859231,132
+5531,2859363,132
+3846,2859495,132
+8697153,2859627,161
+28516,2859788,161
+14444146,2859949,161
+15503029,2860110,139
+7384938,2860249,204
+2159939,2860453,222
+14736832,2860675,197
+5709,2860872,148
+6896,2861020,148
+3691034,2861168,114
+7744,2861282,212
+9754403,2861494,186
+12846203,2861680,228
+2159643,2861908,209
+16579319,2862117,180
+14165689,2862297,223
+11312356,2862520,196
+9022,2862716,148
+7126761,2862864,148
+5440,2863012,132
+7882,2863144,132
+4874,2863276,132
+7946,2863408,132
+16311834,2863540,161
+10523080,2863701,178
+7120984,2863879,199
+13381004,2864078,162
+10016503,2864240,189
+7341332,2864429,189
+15241892,2864618,189
+1075263,2864807,189
+4239610,2864996,189
+9701,2865185,189
+8699,2865374,189
+3472623,2865563,189
+12383660,2865752,189
+11030079,2865941,208
+804997,2866149,189
+8873,2866338,189
+2910831,2866527,154
+579635,2866681,260
+10772530,2866941,166
+4220538,2867107,168
+6856950,2867275,196
+3676,2867471,139
+8674775,2867610,220
+45156,2867830,141
+10234499,2867971,161
+13107728,2868132,134
+10500599,2868266,189
+1886947,2868455,154
+14980462,2868609,154
+11810769,2868763,154
+21978,2868917,154
+7914176,2869071,154
+3816,2869225,224
+49301,2869449,141
+8229,2869590,155
+6763,2869745,218
+5697,2869963,218
+4294,2870181,218
+9342,2870399,216
+56586,2870615,145
+6829411,2870760,209
+16498,2870969,155
+6456,2871124,191
+4471236,2871315,204
+4205812,2871519,229
+7735,2871748,218
+1857496,2871966,156
+8984,2872122,114
+12086051,2872236,114
+2289,2872350,114
+6557,2872464,111
+57483,2872575,146
+14216087,2872721,134
+7294,2872855,109
+9495,2872964,126
+24591,2873090,149
+6202,2873239,149
+6292148,2873388,150
+9756494,2873538,210
+10022603,2873748,258
+6568625,2874006,262
+7166,2874268,150
+5509356,2874418,157
+1187,2874575,157
+7904487,2874732,196
+5283643,2874928,149
+4484837,2875077,196
+8976327,2875273,165
+8407205,2875438,203
+6831668,2875641,190
+13137803,2875831,206
+1099,2876037,115
+11311882,2876152,135
+1068968,2876287,135
+2923,2876422,169
+11273227,2876591,154
+4783286,2876745,207
+11592245,2876952,219
+4245289,2877171,178
+1362195,2877349,151
+16294039,2877500,139
+16524069,2877639,197
+16530835,2877836,195
+14213304,2878031,128
+6304151,2878159,187
+12634486,2878346,257
+5802995,2878603,187
+5269488,2878790,187
+4937,2878977,187
+14719073,2879164,193
+10260173,2879357,138
+10488301,2879495,122
+5300,2879617,191
+10531895,2879808,153
+9203024,2879961,235
+63075,2880196,141
+10510480,2880337,161
+12351070,2880498,161
+14723256,2880659,270
+16014195,2880929,294
+12091800,2881223,139
+11589580,2881362,149
+2940323,2881511,173
+32927,2881684,134
+4769379,2881818,152
+24454,2881970,141
+3677657,2882111,226
+1882564,2882337,135
+9198019,2882472,122
+12068080,2882594,260
+14179114,2882854,161
+16558234,2883015,181
+1866531,2883196,189
+3038,2883385,125
+13423390,2883510,154
+3453780,2883664,196
+1863286,2883860,148
+9486790,2884008,123
+7081702,2884131,236
+13389834,2884367,199
+13649628,2884566,164
+7381683,2884730,123
+15994660,2884853,123
+5003210,2884976,123
+1891,2885099,176
+25324,2885275,141
+13375102,2885416,141
+12872375,2885557,219
+2797,2885776,160
+2361873,2885936,172
+14214509,2886108,172
+5506451,2886280,211
+12595185,2886491,137
+15247346,2886628,159
+7968,2886787,151
+7610186,2886938,215
+14949677,2887153,171
+842305,2887324,207
+7611786,2887531,207
+10532450,2887738,184
+14954326,2887922,129
+16308748,2888051,193
+1841933,2888244,182
+4778481,2888426,123
+9451529,2888549,127
+40966,2888676,177
+13123366,2888853,143
+3446774,2888996,167
+5269514,2889163,196
+8760,2889359,127
+3145,2889486,153
+2233,2889639,165
+6337415,2889804,161
+10803402,2889965,260
+8395262,2890225,184
+6337783,2890409,136
+4750042,2890545,214
+8005,2890759,119
+7824,2890878,181
+8881,2891059,126
+180,2891185,169
+5775,2891354,132
+3463,2891486,191
+1079506,2891677,189
+8599,2891866,183
+15004661,2892049,260
+10521853,2892309,139
+3587,2892448,140
+51941,2892588,141
+17000,2892729,141
+4752327,2892870,178
+4199995,2893048,175
+4482317,2893223,141
+13955591,2893364,221
+13937965,2893585,213
+15764731,2893798,213
+4740447,2894011,213
+16531324,2894224,196
+3689551,2894420,196
+835391,2894616,234
+5308313,2894850,154
+8708899,2895004,224
+7363230,2895228,165
+303894,2895393,130
+1313883,2895523,164
+5894,2895687,226
+16517194,2895913,160
+12359817,2896073,213
+2384218,2896286,192
+4218593,2896478,267
+9592,2896745,148
+3191966,2896893,252
+13121648,2897145,161
+1856826,2897306,164
+3467019,2897470,181
+30856,2897651,141
+9437989,2897792,196
+10020853,2897988,196
+547802,2898184,131
+1884213,2898315,210
+3429436,2898525,171
+1599194,2898696,117
+5780087,2898813,157
+2394631,2898970,171
+10263901,2899141,117
+14437667,2899258,123
+9139,2899381,112
+4206120,2899493,149
+7114677,2899642,134
+36467,2899776,141
+5569,2899917,173
+10526097,2900090,172
+4241032,2900262,143
+10278027,2900405,156
+9479727,2900561,156
+12633378,2900717,139
+1875526,2900856,123
+12903696,2900979,148
+1615607,2901127,252
+13594,2901379,141
+44831,2901520,141
+8403094,2901661,149
+24812,2901810,167
+12635384,2901977,123
+10244058,2902100,123
+8685997,2902223,123
+11287162,2902346,121
+12074585,2902467,124
+14432862,2902591,124
+6771,2902715,184
+36939,2902899,168
+6783,2903067,184
+6159,2903251,140
+13146015,2903391,142
+15528795,2903533,142
+5522440,2903675,142
+3981891,2903817,129
+8700,2903946,136
+8029,2904082,136
+7937,2904218,136
+7150,2904354,135
+6521,2904489,135
+9680,2904624,135
+9428,2904759,131
+3440185,2904890,135
+20607,2905025,126
+6584209,2905151,160
+10282727,2905311,160
+10224280,2905471,160
+2660475,2905631,160
+5569086,2905791,175
+821520,2905966,175
+7908283,2906141,175
+14206185,2906316,160
+12374303,2906476,160
+16007823,2906636,160
+37026,2906796,149
+37078,2906945,137
+4484460,2907082,161
+62575,2907243,161
+815453,2907404,160
+10256607,2907564,169
+8968,2907733,169
+8913749,2907902,168
+3455775,2908070,133
+4222762,2908203,138
+8133873,2908341,196
+7927127,2908537,196
+14690401,2908733,196
+13684811,2908929,196
+4718641,2909125,196
+13924074,2909321,178
+5978,2909499,141
+562903,2909640,116
+5270019,2909756,122
+1052031,2909878,122
+5261934,2910000,122
+4983252,2910122,169
+1622150,2910291,121
+4120,2910412,123
+13172520,2910535,174
+12064281,2910709,139
+11564972,2910848,139
+16561382,2910987,164
+6444,2911151,139
+6494,2911290,139
+6683,2911429,139
+6758,2911568,139
+6775,2911707,139
+6614359,2911846,139
+10808654,2911985,139
+8478,2912124,139
+8576,2912263,139
+7133,2912402,139
+7531,2912541,139
+7614,2912680,139
+4809,2912819,139
+9122,2912958,139
+9197,2913097,139
+6994,2913236,139
+7821,2913375,139
+14698138,2913514,122
+3163802,2913636,122
+9363,2913758,139
+9793,2913897,139
+5584,2914036,139
+5526,2914175,139
+321142,2914314,142
+8948,2914456,155
+7610,2914611,148
+9406,2914759,148
+4062,2914907,183
+851525,2915090,173
+2103000,2915263,180
+14705637,2915443,183
+16306348,2915626,173
+2367915,2915799,183
+12122420,2915982,183
+9200674,2916165,183
+2155876,2916348,139
+9482548,2916487,139
+4241395,2916626,139
+7001,2916765,183
+8856,2916948,183
+6114,2917131,139
+5749,2917270,139
+3301,2917409,139
+992,2917548,139
+53449,2917687,143
+6588375,2917830,136
+14725873,2917966,223
+805945,2918189,159
+7637131,2918348,134
+35924,2918482,136
+9339,2918618,155
+1251,2918773,157
+4277,2918930,152
+6516,2919082,134
+15229310,2919216,192
+1625950,2919408,192
+15738669,2919600,141
+8705744,2919741,141
+1637940,2919882,170
+3678877,2920052,136
+10769007,2920188,134
+6314932,2920322,170
+6609236,2920492,160
+6043320,2920652,284
+43521,2920936,124
+9986003,2921060,143
+55893,2921203,141
+1631164,2921344,172
+13377476,2921516,115
+43520,2921631,146
+49862,2921777,139
+6083300,2921916,139
+2667197,2922055,139
+8771,2922194,163
+110,2922357,128
+4491043,2922485,153
+14183426,2922638,220
+6340277,2922858,190
+16314806,2923048,190
+3997182,2923238,139
+10798228,2923377,139
+9448988,2923516,139
+10761433,2923655,139
+6839619,2923794,139
+10499743,2923933,139
+6608090,2924072,139
+4203970,2924211,139
+5254562,2924350,139
+7901852,2924489,139
+8665675,2924628,139
+6050127,2924767,139
+10767921,2924906,139
+5040962,2925045,139
+16258644,2925184,139
+6319206,2925323,139
+5013651,2925462,139
+11301513,2925601,139
+4490496,2925740,139
+840338,2925879,139
+14461297,2926018,139
+5805163,2926157,139
+9431,2926296,139
+9430,2926435,139
+7648,2926574,139
+5011898,2926713,139
+8693448,2926852,139
+5804495,2926991,139
+822269,2927130,139
+8540,2927269,139
+8555,2927408,139
+8955,2927547,139
+5399,2927686,139
+10528973,2927825,139
+6079956,2927964,139
+7780,2928103,139
+16052705,2928242,200
+10279191,2928442,200
+9464003,2928642,200
+3938685,2928842,127
+11854095,2928969,117
+8729,2929086,127
+9448,2929213,126
+11568126,2929339,115
+3413995,2929454,117
+16301074,2929571,117
+1616283,2929688,117
+4978,2929805,117
+4419,2929922,117
+5010981,2930039,117
+4499522,2930156,117
+9532,2930273,126
+3469124,2930399,123
+11593556,2930522,124
+15736751,2930646,117
+6283,2930763,117
+2164,2930880,117
+12117541,2930997,124
+7514,2931121,125
+1852441,2931246,252
+6042939,2931498,189
+2685600,2931687,197
+15523642,2931884,197
+16001409,2932081,197
+8713978,2932278,179
+7344239,2932457,158
+16312094,2932615,135
+558651,2932750,165
+2391116,2932915,152
+14970643,2933067,189
+2905820,2933256,167
+12614,2933423,137
+24652,2933560,146
+8085,2933706,148
+9032,2933854,148
+9873,2934002,148
+9997149,2934150,157
+9437499,2934307,177
+8127308,2934484,177
+7089797,2934661,177
+9764596,2934838,177
+3453431,2935015,144
+2948407,2935159,151
+811303,2935310,155
+3987755,2935465,137
+7921380,2935602,144
+6195,2935746,144
+6196,2935890,144
+6115,2936034,144
+6192,2936178,144
+9172,2936322,144
+12383877,2936466,176
+7885870,2936642,167
+12888093,2936809,167
+8593,2936976,157
+11334111,2937133,176
+12641314,2937309,144
+13633424,2937453,144
+3964337,2937597,144
+16055346,2937741,144
+9492459,2937885,144
+6120,2938029,144
+6019,2938173,144
+63601,2938317,124
+2373068,2938441,252
+2895923,2938693,122
+13387478,2938815,141
+16850,2938956,141
+2927360,2939097,196
+11061883,2939293,196
+12338228,2939489,257
+311149,2939746,187
+16289738,2939933,137
+3709144,2940070,170
+9733837,2940240,191
+3708886,2940431,214
+1877872,2940645,240
+4463030,2940885,204
+6872010,2941089,123
+550552,2941212,123
+12342326,2941335,123
+281581,2941458,123
+7114177,2941581,123
+8695035,2941704,149
+8174474,2941853,163
+16580522,2942016,154
+841542,2942170,123
+6333309,2942293,123
+8954462,2942416,137
+5512790,2942553,137
+8951478,2942690,193
+8960208,2942883,283
+6297969,2943166,139
+16304824,2943305,117
+4369,2943422,139
+4866,2943561,139
+7129608,2943700,139
+7893404,2943839,139
+13895064,2943978,139
+15217537,2944117,139
+9207611,2944256,139
+6051610,2944395,139
+15239468,2944534,139
+9734012,2944673,139
+4222985,2944812,139
+540172,2944951,139
+3946212,2945090,139
+1842024,2945229,139
+1059,2945368,133
+2126677,2945501,139
+16313765,2945640,139
+5531102,2945779,139
+5811320,2945918,139
+7867079,2946057,194
+3339,2946251,127
+7539,2946378,144
+5633,2946522,161
+7603133,2946683,166
+12123290,2946849,270
+10771766,2947119,137
+15766044,2947256,137
+10504220,2947393,137
+10493256,2947530,137
+4237552,2947667,137
+8933883,2947804,137
+536159,2947941,137
+14946651,2948078,137
+2658890,2948215,137
+2654243,2948352,137
+13385311,2948489,137
+14196071,2948626,137
+5314,2948763,137
+32863,2948900,137
+6398,2949037,137
+6731,2949174,137
+9345,2949311,137
+3937,2949448,137
+4722639,2949585,137
+13896474,2949722,142
+9720624,2949864,193
+10521878,2950057,206
+5034122,2950263,160
+13389548,2950423,175
+4210156,2950598,175
+15486279,2950773,196
+12861508,2950969,148
+5022049,2951117,150
+9218958,2951267,224
+16540858,2951491,219
+9462001,2951710,123
+16306449,2951833,207
+11552890,2952040,207
+9702509,2952247,203
+10768751,2952450,134
+5515096,2952584,271
+9259,2952855,193
+530458,2953048,195
+7795,2953243,195
+5611,2953438,191
+7205,2953629,193
+6526,2953822,193
+9501606,2954015,193
+4470758,2954208,193
+13414264,2954401,193
+16037858,2954594,193
+6582274,2954787,266
+1113837,2955053,235
+6575617,2955288,229
+15738725,2955517,177
+6092961,2955694,177
+4499407,2955871,184
+5088,2956055,184
+15476426,2956239,231
+9728428,2956470,172
+2885772,2956642,166
+1874252,2956808,177
+16012700,2956985,236
+8435334,2957221,236
+1099295,2957457,236
+13407904,2957693,236
+16253203,2957929,182
+10787143,2958111,184
+13160798,2958295,236
+7887208,2958531,193
+12611593,2958724,196
+8403132,2958920,196
+12846895,2959116,196
+16027282,2959312,196
+26187,2959508,196
+10273138,2959704,196
+2391868,2959900,196
+5775144,2960096,196
+15518512,2960292,196
+16047353,2960488,196
+3180336,2960684,236
+12605372,2960920,122
+6596573,2961042,122
+2367392,2961164,196
+1623434,2961360,172
+524328,2961532,133
+4218818,2961665,135
+14738895,2961800,128
+6873053,2961928,219
+7361781,2962147,198
+14471932,2962345,198
+9443244,2962543,172
+3460542,2962715,213
+14174475,2962928,189
+4469290,2963117,122
+7354606,2963239,122
+7352344,2963361,122
+10234095,2963483,198
+15475896,2963681,128
+8187001,2963809,128
+6856217,2963937,128
+2149689,2964065,130
+11835724,2964195,130
+10757403,2964325,122
+6580818,2964447,122
+4107,2964569,143
+5947,2964712,145
+318162,2964857,142
+15739177,2964999,142
+2145216,2965141,142
+5000757,2965283,142
+10025699,2965425,219
+15774761,2965644,219
+20608,2965863,143
+20595,2966006,143
+36876,2966149,143
+36959,2966292,143
+57591,2966435,147
+7127,2966582,134
+24707,2966716,147
+24585,2966863,147
+1660,2967010,147
+4219,2967157,148
+20706,2967305,141
+14996465,2967446,142
+8681644,2967588,142
+37030,2967730,141
+36998,2967871,141
+9356,2968012,165
+9044,2968177,165
+1869612,2968342,143
+6297646,2968485,183
+12850236,2968668,142
+3934454,2968810,142
+7820,2968952,140
+5076,2969092,150
+2150192,2969242,165
+12326501,2969407,142
+16282346,2969549,142
+13682569,2969691,142
+16273239,2969833,142
+5250239,2969975,142
+11534516,2970117,142
+5523968,2970259,142
+57709,2970401,142
+7912185,2970543,142
+8910,2970685,134
+14733683,2970819,142
+14715293,2970961,142
+12874389,2971103,142
+8153590,2971245,142
+7920238,2971387,142
+12089390,2971529,123
+1282,2971652,123
+2709,2971775,123
+3456456,2971898,142
+14478228,2972040,142
+8697111,2972182,142
+1863244,2972324,236
+3942,2972560,133
+2373452,2972693,134
+1608605,2972827,142
+14985821,2972969,142
+16015316,2973111,131
+2927524,2973242,134
+9802,2973376,123
+269924,2973499,123
+4388,2973622,123
+8769,2973745,123
+8176951,2973868,123
+7916089,2973991,123
+1632244,2974114,123
+7392608,2974237,123
+9206685,2974360,123
+14196287,2974483,123
+12109661,2974606,123
+816322,2974729,123
+4206596,2974852,123
+8661401,2974975,123
+7660277,2975098,123
+14731642,2975221,123
+6858861,2975344,123
+8176545,2975467,123
+7369675,2975590,123
+9470989,2975713,123
+15206024,2975836,123
+15500591,2975959,123
+62649,2976082,123
+6067630,2976205,123
+9962456,2976328,123
+6341959,2976451,123
+6839093,2976574,123
+2929722,2976697,123
+6855792,2976820,123
+3673930,2976943,123
+3150052,2977066,123
+11044573,2977189,123
+4475916,2977312,123
+11858091,2977435,123
+8426143,2977558,123
+10224875,2977681,123
+6067869,2977804,123
+6328855,2977927,123
+8696147,2978050,123
+14706296,2978173,123
+4773637,2978296,123
+267602,2978419,123
+13400159,2978542,123
+8964999,2978665,123
+15778289,2978788,123
+8665141,2978911,123
+9175149,2979034,123
+11048586,2979157,123
+15997857,2979280,123
+6347207,2979403,123
+3976078,2979526,123
+16263059,2979649,123
+9466432,2979772,123
+9473388,2979895,123
+12061066,2980018,123
+5012575,2980141,123
+6841419,2980264,123
+13115111,2980387,123
+10760501,2980510,123
+6871356,2980633,123
+63343,2980756,123
+13141328,2980879,123
+7345318,2981002,123
+9984747,2981125,123
+7919455,2981248,123
+14726445,2981371,123
+7116024,2981494,123
+12635853,2981617,123
+16010026,2981740,134
+7630617,2981874,295
+2928171,2982169,161
+12889585,2982330,173
+5831795,2982503,151
+793104,2982654,135
+12906352,2982789,146
+6087606,2982935,199
+8149607,2983134,172
+10549728,2983306,160
+13134285,2983466,123
+10795013,2983589,123
+9488795,2983712,151
+6073807,2983863,123
+526926,2983986,181
+11836683,2984167,113
+3968248,2984280,134
+15209315,2984414,130
+7608421,2984544,188
+12348449,2984732,123
+16302962,2984855,139
+13922824,2984994,134
+11039365,2985128,130
+7865665,2985258,205
+278889,2985463,114
+12594670,2985577,113
+7138226,2985690,193
+3963530,2985883,139
+15994402,2986022,161
+8919961,2986183,225
+5525136,2986408,123
+10790569,2986531,60
+9179348,2986591,178
+16292025,2986769,196
+6075737,2986965,126
+12073629,2987091,132
+6838469,2987223,144
+12587379,2987367,161
+7885810,2987528,130
+12379711,2987658,161
+8163618,2987819,161
+11320370,2987980,123
+9446380,2988103,185
+4463784,2988288,193
+11807037,2988481,229
+5570434,2988710,185
+5300117,2988895,117
+10266269,2989012,172
+5788608,2989184,342
+2925881,2989526,138
+13400394,2989664,161
+16050470,2989825,211
+9465624,2990036,60
+10013479,2990096,177
+15266530,2990273,139
+2388576,2990412,194
+2382832,2990606,135
+15226292,2990741,151
+3411181,2990892,129
+2631615,2991021,161
+9754713,2991182,172
+2948324,2991354,143
+12643904,2991497,136
+16038055,2991633,178
+3148835,2991811,178
+12629779,2991989,192
+1050033,2992181,139
+2122591,2992320,125
+539228,2992445,161
+12104668,2992606,167
+7350909,2992773,117
+5025329,2992890,215
+1609465,2993105,155
+4518966,2993260,178
+12877126,2993438,160
+1596826,2993598,137
+16050644,2993735,152
+5027693,2993887,119
+7135262,2994006,116
+7636266,2994122,168
+10270416,2994290,130
+4241562,2994420,193
+1881900,2994613,167
+4241463,2994780,183
+5041840,2994963,165
+8388996,2995128,156
+4507291,2995284,233
+16573244,2995517,196
+12592487,2995713,137
+11043455,2995850,282
+13650163,2996132,121
+12108735,2996253,272
+4494891,2996525,122
+14710480,2996647,149
+11536575,2996796,154
+13914666,2996950,130
+15206335,2997080,232
+8712489,2997312,131
+12098253,2997443,253
+13920442,2997696,237
+549478,2997933,167
+10236006,2998100,135
+1621421,2998235,153
+6350524,2998388,182
+13157646,2998570,241
+13658655,2998811,139
+7340342,2998950,169
+16556586,2999119,178
+10769922,2999297,242
+9757437,2999539,193
+15736372,2999732,198
+14475302,2999930,130
+11797862,3000060,181
+1885997,3000241,238
+11046920,3000479,181
+1587300,3000660,203
+7140840,3000863,170
+9224102,3001033,161
+13150243,3001194,161
+11584857,3001355,161
+16002134,3001516,147
+16571466,3001663,173
+1840307,3001836,150
+10783963,3001986,116
+14179810,3002102,193
+3969323,3002295,133
+3435535,3002428,170
+12326021,3002598,175
+10251285,3002773,149
+4480717,3002922,123
+5024040,3003045,128
+15221886,3003173,140
+12596062,3003313,125
+11591740,3003438,172
+11553119,3003610,163
+6353289,3003773,178
+7614204,3003951,164
+8703935,3004115,134
+11325880,3004249,193
+10535646,3004442,150
+8970593,3004592,290
+42249,3004882,126
+7639485,3005008,163
+15793771,3005171,272
+3976809,3005443,173
+13906534,3005616,139
+9440436,3005755,201
+4767891,3005956,139
+14420244,3006095,134
+13669022,3006229,149
+12341940,3006378,114
+9700790,3006492,231
+62427,3006723,127
+7876907,3006850,178
+13114219,3007028,158
+3422383,3007186,148
+11839528,3007334,302
+41717,3007636,215
+1050801,3007851,193
+14978063,3008044,132
+14951252,3008176,244
+9748373,3008420,210
+4509309,3008630,104
+3427818,3008734,178
+4986609,3008912,178
+1112782,3009090,205
+9728210,3009295,140
+10767059,3009435,202
+8171895,3009637,125
+13381760,3009762,137
+5798889,3009899,172
+9181401,3010071,211
+12893546,3010282,131
+12845518,3010413,152
+1601815,3010565,148
+15470276,3010713,193
+3209911,3010906,169
+526774,3011075,114
+5043616,3011189,174
+14220049,3011363,124
+5040435,3011487,135
+13427071,3011622,137
+14992939,3011759,127
+15474047,3011886,178
+11286640,3012064,238
+5028930,3012302,261
+7401878,3012563,155
+1606169,3012718,236
+2663918,3012954,181
+13672662,3013135,201
+15513863,3013336,137
+16001075,3013473,149
+822415,3013622,174
+10790099,3013796,189
+11023002,3013985,180
+16044082,3014165,283
+6292114,3014448,168
+11843673,3014616,133
+6093296,3014749,151
+7351761,3014900,220
+1340816,3015120,252
+5291359,3015372,252
+9993798,3015624,156
+3950296,3015780,252
+5014494,3016032,134
+11015028,3016166,193
+540040,3016359,161
+12340829,3016520,183
+3938463,3016703,131
+8153795,3016834,133
+6052802,3016967,157
+3168603,3017124,129
+8684810,3017253,193
+576923,3017446,208
+2680553,3017654,181
+16055595,3017835,146
+16053830,3017981,165
+3149098,3018146,201
+285838,3018347,167
+8176879,3018514,118
+14179835,3018632,60
+14479632,3018692,131
+6328156,3018823,161
+14432481,3018984,137
+9473123,3019121,202
+15265673,3019323,178
+1086054,3019501,161
+15478350,3019662,197
+3441092,3019859,116
+9975571,3019975,168
+10780217,3020143,178
+13416081,3020321,155
+4200062,3020476,167
+16271987,3020643,146
+1321942,3020789,191
+16564958,3020980,178
+9974941,3021158,164
+8916918,3021322,203
+11822744,3021525,143
+6847688,3021668,162
+7665757,3021830,162
+11559367,3021992,163
+37626,3022155,238
+5013346,3022393,131
+1052440,3022524,230
+13682624,3022754,252
+4460994,3023006,176
+8411645,3023182,116
+4194567,3023298,131
+3196752,3023429,147
+1625123,3023576,169
+4225141,3023745,220
+14189006,3023965,144
+2672677,3024109,225
+8413583,3024334,295
+14166549,3024629,127
+4488822,3024756,168
+11594895,3024924,109
+2678518,3025033,131
+5768488,3025164,143
+14734106,3025307,182
+9992048,3025489,230
+6869575,3025719,135
+5289621,3025854,188
+11813645,3026042,167
+10511640,3026209,129
+8162705,3026338,222
+7638811,3026560,147
+540534,3026707,172
+13404669,3026879,131
+3425903,3027010,137
+3697819,3027147,144
+11807890,3027291,219
+10516337,3027510,120
+1105396,3027630,196
+6088639,3027826,292
+7103514,3028118,143
+5283924,3028261,126
+11830599,3028387,164
+5265064,3028551,120
+15263600,3028671,151
+6329888,3028822,60
+12646801,3028882,177
+14187741,3029059,178
+7371800,3029237,166
+1372814,3029403,191
+12326127,3029594,178
+525169,3029772,123
+2100885,3029895,133
+13170317,3030028,169
+3986646,3030197,149
+791138,3030346,178
+7924852,3030524,126
+10017426,3030650,158
+3701575,3030808,147
+12608710,3030955,131
+14943289,3031086,144
+13681711,3031230,178
+5542745,3031408,201
+9450862,3031609,160
+2638896,3031769,165
+6033811,3031934,136
+7880027,3032070,182
+13677859,3032252,166
+2401429,3032418,145
+8680982,3032563,128
+14419317,3032691,152
+14718962,3032843,132
+7352414,3032975,227
+12622053,3033202,154
+5300554,3033356,60
+7376137,3033416,131
+10025746,3033547,175
+3936320,3033722,147
+4471964,3033869,154
+2686033,3034023,201
+4224150,3034224,163
+7347583,3034387,179
+7362950,3034566,127
+8670979,3034693,170
+9463575,3034863,176
+6317217,3035039,126
+5814625,3035165,132
+804669,3035297,208
+9227682,3035505,121
+8660523,3035626,114
+9989365,3035740,178
+4488132,3035918,194
+10224542,3036112,236
+6818519,3036348,222
+12355731,3036570,126
+7364979,3036696,123
+8145337,3036819,155
+10287323,3036974,214
+2150943,3037188,166
+16291152,3037354,152
+5792666,3037506,125
+1605333,3037631,190
+8657720,3037821,230
+5032949,3038051,178
+4485131,3038229,150
+5547339,3038379,162
+12331883,3038541,216
+10015537,3038757,218
+3730449,3038975,164
+1851736,3039139,133
+10233920,3039272,199
+1866529,3039471,183
+14724939,3039654,159
+8654661,3039813,203
+2908147,3040016,141
+7883037,3040157,144
+16018108,3040301,162
+2672241,3040463,127
+14182752,3040590,125
+585531,3040715,170
+15264474,3040885,170
+16276425,3041055,119
+8173435,3041174,155
+11587096,3041329,200
+7141756,3041529,127
+16318303,3041656,255
+1057401,3041911,157
+8133372,3042068,221
+16022094,3042289,129
+296074,3042418,212
+15475287,3042630,237
+15742881,3042867,253
+7359725,3043120,124
+15765211,3043244,141
+12624798,3043385,140
+1088185,3043525,117
+1322379,3043642,148
+6876822,3043790,134
+7918477,3043924,220
+14462468,3044144,124
+8390111,3044268,183
+6823268,3044451,198
+4989392,3044649,183
+9468426,3044832,146
+10536684,3044978,203
+7923894,3045181,178
+1079502,3045359,154
+14211666,3045513,142
+5798477,3045655,142
+8709673,3045797,120
+12877649,3045917,133
+11048924,3046050,114
+13423259,3046164,212
+10525629,3046376,177
+13896633,3046553,137
+15996413,3046690,239
+7397415,3046929,208
+16528870,3047137,132
+15222815,3047269,176
+3446235,3047445,140
+10270611,3047585,168
+6042460,3047753,152
+319337,3047905,163
+7920307,3048068,139
+7344108,3048207,175
+15737861,3048382,182
+13897872,3048564,134
+7919029,3048698,134
+14974298,3048832,181
+15005601,3049013,138
+1072187,3049151,129
+3448208,3049280,160
+14181083,3049440,126
+12877310,3049566,140
+13417781,3049706,137
+7138465,3049843,199
+11548752,3050042,178
+7638536,3050220,145
+7927269,3050365,151
+9190407,3050516,147
+3713131,3050663,115
+15759205,3050778,146
+1327586,3050924,153
+15519808,3051077,173
+16256490,3051250,159
+11569159,3051409,139
+2397444,3051548,141
+16013378,3051689,131
+1074818,3051820,145
+2384504,3051965,192
+15762633,3052157,178
+13893997,3052335,252
+9985171,3052587,160
+10521223,3052747,194
+2674076,3052941,225
+12633014,3053166,137
+10546038,3053303,124
+16532633,3053427,127
+14443644,3053554,158
+1345170,3053712,252
+11015501,3053964,252
+6091632,3054216,151
+10805478,3054367,183
+3676006,3054550,132
+1632477,3054682,182
+13661141,3054864,157
+1348680,3055021,131
+4782373,3055152,118
+3696531,3055270,166
+819816,3055436,252
+14163678,3055688,135
+2419264,3055823,152
+13904362,3055975,132
+3452388,3056107,175
+3970261,3056282,137
+6849306,3056419,162
+16571286,3056581,159
+1319895,3056740,151
+14446344,3056891,156
+9493070,3057047,116
+2627704,3057163,156
+7354548,3057319,134
+7626496,3057453,155
+14730227,3057608,178
+6037712,3057786,208
+11314224,3057994,132
+8682120,3058126,156
+10803286,3058282,130
+7886103,3058412,131
+11829086,3058543,169
+10550929,3058712,146
+7662833,3058858,144
+5769701,3059002,140
+5263252,3059142,165
+6336901,3059307,117
+12346015,3059424,163
+3674084,3059587,153
+4780592,3059740,157
+7877199,3059897,141
+3687273,3060038,168
+4462671,3060206,139
+8694948,3060345,220
+5513173,3060565,138
+11331967,3060703,137
+15227559,3060840,154
+10263581,3060994,146
+13686476,3061140,134
+5820529,3061274,131
+1856214,3061405,188
+13688754,3061593,164
+3696197,3061757,159
+12081911,3061916,128
+3470893,3062044,149
+5017509,3062193,134
+8711475,3062327,142
+15216164,3062469,171
+8452699,3062640,126
+12628793,3062766,119
+2131340,3062885,129
+6344133,3063014,172
+14161963,3063186,172
+8441665,3063358,276
+10281430,3063634,171
+4766146,3063805,135
+5822163,3063940,143
+290377,3064083,262
+2898941,3064345,206
+11287732,3064551,120
+11836852,3064671,171
+11331710,3064842,164
+8390562,3065006,183
+12624098,3065189,122
+528378,3065311,149
+15248378,3065460,241
+14463064,3065701,174
+7100980,3065875,252
+9451743,3066127,199
+1593939,3066326,148
+6830878,3066474,146
+11313708,3066620,159
+3158676,3066779,156
+8159789,3066935,110
+1113072,3067045,130
+7117513,3067175,152
+11308308,3067327,131
+2134489,3067458,121
+11301430,3067579,178
+3987418,3067757,214
+325826,3067971,192
+1317872,3068163,159
+5801954,3068322,212
+6842866,3068534,117
+12081918,3068651,217
+16018914,3068868,178
+15772836,3069046,147
+6321293,3069193,162
+12105687,3069355,143
+8422023,3069498,177
+2662790,3069675,123
+5257557,3069798,134
+7917865,3069932,122
+8707852,3070054,124
+3706599,3070178,132
+6083611,3070310,189
+13428632,3070499,133
+10499824,3070632,152
+1576108,3070784,116
+7908192,3070900,116
+8684276,3071016,219
+56094,3071235,136
+1607226,3071371,150
+842956,3071521,151
+9971997,3071672,176
+3452716,3071848,163
+8182270,3072011,166
+14979177,3072177,155
+13418756,3072332,150
+10793449,3072482,136
+6309214,3072618,127
+14157521,3072745,205
+6583895,3072950,156
+9465893,3073106,171
+1102300,3073277,166
+3447151,3073443,145
+9718281,3073588,138
+12331222,3073726,173
+1096984,3073899,141
+5794297,3074040,140
+13901365,3074180,170
+5010105,3074350,168
+2944491,3074518,185
+842134,3074703,141
+3207994,3074844,126
+808939,3074970,140
+7623463,3075110,167
+13667583,3075277,113
+6868558,3075390,175
+6869501,3075565,205
+10225262,3075770,236
+3992315,3076006,114
+9226154,3076120,184
+4207468,3076304,210
+16293949,3076514,178
+2937924,3076692,160
+12353823,3076852,127
+14182361,3076979,141
+10807089,3077120,132
+10004400,3077252,134
+4982410,3077386,158
+15226582,3077544,123
+12616048,3077667,146
+6562326,3077813,178
+4470841,3077991,164
+297794,3078155,196
+5273254,3078351,177
+10767377,3078528,141
+6325307,3078669,133
+11291592,3078802,137
+2136997,3078939,206
+10548304,3079145,156
+6326705,3079301,143
+4510046,3079444,203
+14078,3079647,122
+7380614,3079769,127
+10548249,3079896,132
+1873725,3080028,123
+12321280,3080151,139
+4755795,3080290,185
+11310083,3080475,158
+6871333,3080633,154
+8686980,3080787,140
+5523051,3080927,238
+4502402,3081165,218
+6338867,3081383,165
+17407,3081548,134
+8170674,3081682,173
+1627754,3081855,112
+1866821,3081967,181
+3946632,3082148,145
+4773887,3082293,173
+12874032,3082466,161
+14168959,3082627,144
+14072,3082771,163
+10811344,3082934,178
+13129285,3083112,135
+4469903,3083247,177
+13954060,3083424,172
+2680328,3083596,114
+7667581,3083710,152
+11333810,3083862,179
+5515932,3084041,144
+5261918,3084185,136
+7121263,3084321,123
+11272514,3084444,142
+12876707,3084586,124
+16009288,3084710,145
+5296756,3084855,145
+13170436,3085000,149
+5278274,3085149,183
+12380715,3085332,124
+827704,3085456,143
+6057807,3085599,140
+9444110,3085739,188
+16273507,3085927,118
+2897656,3086045,141
+8673159,3086186,177
+5769466,3086363,190
+11287813,3086553,146
+2646164,3086699,127
+10769968,3086826,141
+12860476,3086967,128
+12068564,3087095,201
+12088391,3087296,161
+7627743,3087457,126
+12325470,3087583,209
+1369324,3087792,125
+3680490,3087917,212
+13638311,3088129,127
+8678125,3088256,163
+14704038,3088419,189
+285333,3088608,132
+324796,3088740,142
+8444721,3088882,217
+1855925,3089099,118
+7092868,3089217,210
+54834,3089427,141
+827025,3089568,159
+3686160,3089727,158
+11326308,3089885,152
+2944550,3090037,151
+13171193,3090188,141
+10809170,3090329,142
+11019993,3090471,156
+2659343,3090627,141
+12114679,3090768,171
+1325802,3090939,154
+10520300,3091093,169
+9711127,3091262,175
+12869700,3091437,143
+10026499,3091580,147
+14695515,3091727,273
+13407306,3092000,143
+820517,3092143,141
+11851945,3092284,129
+8177879,3092413,110
+10268680,3092523,200
+11040623,3092723,113
+6588296,3092836,137
+64059,3092973,140
+5512699,3093113,155
+6338054,3093268,129
+9474740,3093397,174
+2140747,3093571,143
+13397487,3093714,120
+11033587,3093834,128
+12097370,3093962,191
+4731869,3094153,170
+554354,3094323,114
+1098426,3094437,113
+9492303,3094550,115
+6604202,3094665,190
+10005207,3094855,175
+10245069,3095030,139
+6325829,3095169,151
+16551876,3095320,187
+1113172,3095507,167
+12593523,3095674,169
+7929405,3095843,137
+2635983,3095980,136
+2407554,3096116,155
+11799589,3096271,150
+16316371,3096421,189
+2675119,3096610,132
+2408627,3096742,129
+16532831,3096871,246
+15747627,3097117,148
+3157480,3097265,142
+4761298,3097407,218
+5245746,3097625,331
+6305107,3097956,173
+14694871,3098129,136
+8139630,3098265,157
+13951807,3098422,114
+6868239,3098536,185
+6307781,3098721,133
+10806161,3098854,135
+11300825,3098989,154
+14425763,3099143,130
+10748208,3099273,150
+9480067,3099423,183
+16270893,3099606,149
+7906781,3099755,200
+15525700,3099955,132
+2666250,3100087,150
+6083755,3100237,121
+588882,3100358,122
+4993753,3100480,180
+565547,3100660,199
+10488993,3100859,135
+6613071,3100994,196
+2924284,3101190,116
+1583877,3101306,147
+2362289,3101453,186
+2158278,3101639,192
+14687751,3101831,148
+8153907,3101979,162
+1342917,3102141,178
+47606,3102319,239
+16564797,3102558,151
+8972198,3102709,171
+10766074,3102880,140
+13428703,3103020,150
+2622688,3103170,148
+6570822,3103318,222
+13894218,3103540,148
+16820,3103688,226
+16008272,3103914,136
+287447,3104050,140
+13914234,3104190,135
+6609289,3104325,141
+6577623,3104466,259
+15484528,3104725,165
+13654543,3104890,168
+15505025,3105058,146
+6031215,3105204,167
+3936193,3105371,135
+5826102,3105506,154
+1112558,3105660,132
+7613199,3105792,148
+13171073,3105940,123
+2378107,3106063,168
+10020762,3106231,210
+10545627,3106441,224
+7899507,3106665,133
+1323130,3106798,129
+10513644,3106927,112
+2111238,3107039,141
+16036196,3107180,253
+7385141,3107433,204
+8921571,3107637,161
+9484669,3107798,202
+8188969,3108000,144
+13415770,3108144,155
+11307725,3108299,167
+9978438,3108466,140
+3418602,3108606,152
+9208488,3108758,168
+6297868,3108926,112
+13656014,3109038,150
+16253746,3109188,138
+2663796,3109326,157
+1066430,3109483,119
+9484496,3109602,136
+11290403,3109738,105
+15252080,3109843,141
+13935653,3109984,172
+2626673,3110156,138
+2377486,3110294,116
+13671173,3110410,115
+9179595,3110525,188
+16548649,3110713,142
+1370931,3110855,178
+16037193,3111033,224
+8958312,3111257,146
+6850411,3111403,142
+1878535,3111545,141
+6839094,3111686,192
+2682412,3111878,162
+7876335,3112040,132
+8188090,3112172,182
+11306612,3112354,137
+6607425,3112491,142
+1619870,3112633,145
+9192501,3112778,239
+16260499,3113017,237
+9754940,3113254,123
+12107455,3113377,141
+6600266,3113518,134
+3723573,3113652,179
+13432897,3113831,116
+3205925,3113947,155
+4515033,3114102,141
+11323988,3114243,143
+9443584,3114386,104
+13917506,3114490,132
+11548713,3114622,201
+8154169,3114823,127
+1618874,3114950,133
+9199583,3115083,175
+13925237,3115258,176
+14212877,3115434,125
+11336062,3115559,138
+2113541,3115697,125
+13922114,3115822,134
+3148700,3115956,163
+7122239,3116119,166
+11541372,3116285,139
+312740,3116424,141
+12331078,3116565,176
+12324651,3116741,166
+6586661,3116907,148
+9238985,3117055,222
+12608107,3117277,141
+9757222,3117418,162
+14207389,3117580,143
+1082322,3117723,161
+3434570,3117884,152
+13433965,3118036,130
+14696061,3118166,150
+837292,3118316,129
+271877,3118445,221
+2420991,3118666,159
+10272978,3118825,152
+13432442,3118977,159
+8414697,3119136,130
+15505516,3119266,186
+13669368,3119452,152
+10249310,3119604,145
+1848141,3119749,125
+14473343,3119874,239
+11854029,3120113,138
+2646086,3120251,206
+1106645,3120457,141
+6343040,3120598,136
+10499834,3120734,147
+15500140,3120881,158
+3160405,3121039,225
+16538404,3121264,134
+7887166,3121398,155
+5281650,3121553,149
+5258725,3121702,141
+5506198,3121843,140
+15484484,3121983,116
+5028296,3122099,142
+9221711,3122241,141
+2116266,3122382,146
+2162381,3122528,180
+15766330,3122708,123
+12075359,3122831,120
+2930333,3122951,153
+5779266,3123104,166
+292001,3123270,179
+6056324,3123449,125
+7396769,3123574,125
+9752601,3123699,170
+9185162,3123869,126
+13372634,3123995,127
+14949451,3124122,152
+6091772,3124274,142
+11037295,3124416,112
+6820397,3124528,197
+9762592,3124725,210
+14457938,3124935,178
+4755958,3125113,276
+6593316,3125389,161
+8679089,3125550,131
+7098445,3125681,141
+12111983,3125822,249
+15471862,3126071,126
+15243610,3126197,189
+4201817,3126386,149
+12124015,3126535,184
+1883406,3126719,156
+10547735,3126875,181
+15771492,3127056,154
+1836630,3127210,146
+5246573,3127356,150
+15481840,3127506,108
+5041630,3127614,164
+15261839,3127778,163
+11316109,3127941,132
+6325170,3128073,122
+8441881,3128195,120
+6876101,3128315,168
+10532314,3128483,181
+8947360,3128664,190
+10768469,3128854,121
+11049744,3128975,124
+11801737,3129099,141
+10790927,3129240,232
+16299417,3129472,303
+12096029,3129775,121
+13666713,3129896,131
+13141063,3130027,162
+5569983,3130189,158
+13679488,3130347,166
+6035411,3130513,125
+1892111,3130638,141
+6864299,3130779,141
+10268143,3130920,154
+13142855,3131074,185
+12897605,3131259,238
+9234355,3131497,172
+560584,3131669,174
+8439498,3131843,127
+7370480,3131970,211
+12594172,3132181,158
+9750447,3132339,161
+14162964,3132500,172
+35856,3132672,130
+9474108,3132802,212
+14705074,3133014,231
+9703898,3133245,145
+8403429,3133390,134
+14449556,3133524,141
+6081074,3133665,140
+7607778,3133805,168
+15516554,3133973,164
+13930410,3134137,153
+11567576,3134290,139
+1375919,3134429,144
+11581653,3134573,200
+9758481,3134773,130
+7117570,3134903,132
+6561409,3135035,157
+15488046,3135192,205
+16569590,3135397,167
+13919912,3135564,140
+15787459,3135704,163
+14166406,3135867,180
+4481330,3136047,137
+15998731,3136184,153
+10519239,3136337,141
+275972,3136478,143
+10793639,3136621,144
+13684989,3136765,141
+14703472,3136906,172
+1317821,3137078,121
+15235827,3137199,123
+13393013,3137322,224
+1863525,3137546,145
+9494768,3137691,150
+4215309,3137841,160
+8420635,3138001,145
+1618441,3138146,160
+14175018,3138306,164
+6835080,3138470,152
+10026001,3138622,143
+3465431,3138765,224
+14173702,3138989,168
+16297069,3139157,139
+16011499,3139296,152
+9998045,3139448,177
+10792602,3139625,156
+13125877,3139781,153
+7907092,3139934,120
+16290803,3140054,123
+7890606,3140177,151
+4981294,3140328,157
+3451630,3140485,150
+4511293,3140635,134
+7905952,3140769,163
+4783288,3140932,146
+13893645,3141078,182
+11292981,3141260,116
+7649771,3141376,195
+13914775,3141571,183
+1605838,3141754,143
+2406072,3141897,118
+10769947,3142015,158
+8439359,3142173,171
+4248590,3142344,124
+819818,3142468,241
+14690074,3142709,194
+38911,3142903,146
+14986054,3143049,126
+9722750,3143175,133
+320840,3143308,169
+7369148,3143477,168
+7898350,3143645,139
+8127774,3143784,121
+1050892,3143905,174
+14687470,3144079,140
+2659326,3144219,141
+16041877,3144360,144
+7868805,3144504,156
+13654133,3144660,171
+13168430,3144831,207
+587512,3145038,128
+3951721,3145166,188
+7876833,3145354,136
+11571508,3145490,117
+10797739,3145607,221
+4762205,3145828,151
+274262,3145979,171
+15228499,3146150,153
+8960639,3146303,143
+6609688,3146446,143
+9478874,3146589,113
+9996781,3146702,166
+14162942,3146868,160
+16532579,3147028,152
+1060246,3147180,128
+6043098,3147308,137
+10512774,3147445,156
+15503021,3147601,124
+3458714,3147725,135
+14200464,3147860,139
+12084539,3147999,136
+3729631,3148135,163
+1839773,3148298,171
+14731853,3148469,227
+838086,3148696,157
+1073865,3148853,152
+6337476,3149005,123
+313472,3149128,125
+16289263,3149253,118
+270900,3149371,170
+15775467,3149541,162
+8439906,3149703,137
+1871754,3149840,147
+16567524,3149987,146
+5787878,3150133,145
+3939518,3150278,132
+12375478,3150410,144
+16541758,3150554,158
+2680724,3150712,163
+840962,3150875,149
+7373454,3151024,134
+10762492,3151158,141
+1637535,3151299,229
+9722157,3151528,166
+13396400,3151694,179
+10508602,3151873,168
+13429276,3152041,152
+8128729,3152193,157
+2120096,3152350,159
+3729804,3152509,134
+10534821,3152643,123
+11557663,3152766,171
+2413260,3152937,150
+847740,3153087,119
+15526392,3153206,281
+3460756,3153487,157
+3469195,3153644,172
+6848372,3153816,143
+13685382,3153959,172
+12851595,3154131,179
+13122101,3154310,218
+7113947,3154528,153
+4257070,3154681,174
+15007709,3154855,154
+6857143,3155009,217
+841666,3155226,159
+15224526,3155385,163
+1066488,3155548,167
+14477084,3155715,153
+11038885,3155868,156
+16271149,3156024,152
+8687616,3156176,163
+530508,3156339,139
+1083407,3156478,237
+16540056,3156715,178
+7657552,3156893,139
+5551648,3157032,189
+7914510,3157221,118
+2885155,3157339,130
+796501,3157469,178
+7903631,3157647,156
+4254968,3157803,119
+12366209,3157922,137
+13141819,3158059,129
+11062928,3158188,114
+14950163,3158302,142
+7346925,3158444,162
+6579648,3158606,135
+8134323,3158741,139
+4478647,3158880,130
+4508066,3159010,144
+9465288,3159154,191
+5786862,3159345,183
+10017,3159528,188
+10515250,3159716,166
+6604463,3159882,156
+4478605,3160038,166
+4219270,3160204,159
+9973,3160363,136
+9976,3160499,272
+9972,3160771,144
+9966,3160915,128
+9967,3161043,169
+9906,3161212,130
+9903,3161342,133
+9907,3161475,163
+9895,3161638,117
+9892,3161755,177
+9944,3161932,207
+9942,3162139,192
+9999,3162331,150
+9994,3162481,113
+9993,3162594,163
+9939,3162757,213
+9937,3162970,154
+9931,3163124,141
+9985,3163265,135
+9979,3163400,188
+10010,3163588,175
+10004,3163763,167
+10005,3163930,178
+9958,3164108,155
+9951,3164263,188
+9834,3164451,132
+9835,3164583,186
+9831,3164769,126
+9890,3164895,182
+9887,3165077,60
+9881,3165137,141
+9799,3165278,146
+9792,3165424,172
+9811,3165596,149
+9851,3165745,207
+9863,3165952,144
+9869,3166096,131
+9768,3166227,203
+9759,3166430,186
+9758,3166616,213
+9753,3166829,119
+9706,3166948,119
+9712,3167067,183
+9704,3167250,137
+9700,3167387,133
+9724,3167520,195
+9722,3167715,144
+9779,3167859,175
+9687,3168034,99
+9688,3168133,151
+9682,3168284,154
+9776,3168438,132
+9770,3168570,130
+9726,3168700,199
+9595,3168899,172
+9596,3169071,210
+9589,3169281,170
+9584,3169451,187
+9627,3169638,239
+9622,3169877,130
+9621,3170007,159
+9673,3170166,208
+9615,3170374,158
+9609,3170532,148
+9605,3170680,138
+9601,3170818,151
+9653,3170969,141
+9662,3171110,144
+9632,3171254,163
+9549,3171417,173
+9548,3171590,146
+9539,3171736,135
+9563,3171871,133
+9494,3172004,164
+9488,3172168,160
+9578,3172328,174
+9570,3172502,160
+9504,3172662,155
+9511,3172817,144
+9509,3172961,138
+9553,3173099,135
+9530,3173234,119
+9378,3173353,206
+9401,3173559,248
+9405,3173807,164
+9398,3173971,136
+9463,3174107,141
+9445,3174248,149
+9442,3174397,156
+9440,3174553,128
+9459,3174681,163
+9473,3174844,136
+9416,3174980,161
+9413,3175141,151
+9366,3175292,170
+9369,3175462,151
+9354,3175613,146
+9269,3175759,168
+9265,3175927,144
+9266,3176071,179
+9283,3176250,135
+9281,3176385,167
+9275,3176552,136
+9297,3176688,141
+9290,3176829,143
+9287,3176972,127
+9335,3177099,162
+9326,3177261,137
+9309,3177398,174
+9296,3177572,141
+9304,3177713,146
+9331,3177859,144
+9323,3178003,175
+9205,3178178,132
+9215,3178310,207
+9206,3178517,182
+9203,3178699,137
+9200,3178836,241
+9232,3179077,161
+9224,3179238,141
+9264,3179379,153
+9262,3179532,129
+9245,3179661,145
+9242,3179806,142
+9236,3179948,141
+9228,3180089,132
+9209,3180221,165
+9193,3180386,137
+9194,3180523,141
+9189,3180664,148
+9142,3180812,172
+9144,3180984,201
+9146,3181185,146
+9148,3181331,156
+9137,3181487,186
+9110,3181673,172
+9108,3181845,151
+9079,3181996,146
+9073,3182142,157
+9121,3182299,151
+9126,3182450,124
+9128,3182574,142
+9114,3182716,152
+9164,3182868,163
+9081,3183031,202
+9100,3183233,60
+9152,3183293,159
+9048,3183452,114
+9046,3183566,136
+9040,3183702,141
+9039,3183843,183
+9035,3184026,151
+9033,3184177,189
+9030,3184366,112
+8967,3184478,198
+8965,3184676,141
+8959,3184817,116
+9028,3184933,183
+9020,3185116,117
+9011,3185233,141
+9006,3185374,165
+8992,3185539,136
+9060,3185675,172
+8983,3185847,132
+8974,3185979,123
+9058,3186102,140
+9054,3186242,141
+8994,3186383,166
+8886,3186549,160
+8885,3186709,130
+8882,3186839,153
+8876,3186992,189
+8877,3187181,159
+8878,3187340,130
+8917,3187470,223
+8913,3187693,159
+8914,3187852,210
+8898,3188062,196
+8893,3188258,141
+8890,3188399,169
+8891,3188568,154
+8867,3188722,172
+8962,3188894,150
+8949,3189044,164
+8906,3189208,173
+8903,3189381,172
+8897,3189553,144
+8847,3189697,106
+8855,3189803,135
+8850,3189938,119
+8933,3190057,163
+8932,3190220,164
+8783,3190384,172
+8785,3190556,148
+8798,3190704,153
+8792,3190857,125
+8795,3190982,146
+8793,3191128,234
+8787,3191362,146
+8748,3191508,141
+8749,3191649,125
+8746,3191774,138
+8830,3191912,202
+8828,3192114,158
+8823,3192272,153
+8765,3192425,148
+8761,3192573,178
+8757,3192751,138
+8825,3192889,155
+8817,3193044,189
+8775,3193233,148
+8735,3193381,174
+8678,3193555,152
+8672,3193707,138
+8670,3193845,155
+8697,3194000,151
+8698,3194151,146
+8688,3194297,142
+8659,3194439,182
+8652,3194621,192
+8633,3194813,150
+8627,3194963,122
+8630,3195085,175
+8727,3195260,142
+8721,3195402,131
+8655,3195533,135
+8645,3195668,126
+8722,3195794,143
+8717,3195937,141
+8712,3196078,146
+8686,3196224,162
+8684,3196386,128
+8709,3196514,153
+8713,3196667,161
+8588,3196828,133
+8586,3196961,186
+8587,3197147,170
+8580,3197317,131
+8568,3197448,165
+8563,3197613,150
+8567,3197763,143
+8562,3197906,136
+8531,3198042,129
+8570,3198171,136
+8612,3198307,127
+8601,3198434,108
+8608,3198542,141
+8600,3198683,145
+8622,3198828,162
+8623,3198990,141
+8532,3199131,160
+8553,3199291,145
+8523,3199436,252
+8517,3199688,167
+8190,3199855,137
+8191,3199992,146
+8188,3200138,131
+8189,3200269,209
+8481,3200478,125
+8483,3200603,128
+8458,3200731,144
+8455,3200875,154
+8510,3201029,131
+8511,3201160,164
+8475,3201324,141
+8493,3201465,164
+8149,3201629,144
+8113,3201773,126
+8114,3201899,182
+8174,3202081,151
+8175,3202232,162
+8172,3202394,152
+8138,3202546,141
+8131,3202687,132
+8160,3202819,131
+8152,3202950,185
+8151,3203135,134
+8147,3203269,139
+8129,3203408,197
+8123,3203605,161
+8168,3203766,189
+8107,3203955,166
+8108,3204121,144
+7990,3204265,172
+7997,3204437,128
+7992,3204565,153
+7981,3204718,176
+8073,3204894,128
+8074,3205022,196
+8063,3205218,146
+8054,3205364,147
+8051,3205511,186
+8034,3205697,124
+8039,3205821,142
+8022,3205963,173
+8018,3206136,208
+8015,3206344,140
+7983,3206484,143
+7986,3206627,163
+8004,3206790,150
+7993,3206940,210
+8060,3207150,118
+8058,3207268,125
+8055,3207393,124
+8084,3207517,154
+8078,3207671,141
+8033,3207812,222
+7886,3208034,180
+7880,3208214,167
+7884,3208381,132
+7877,3208513,160
+7939,3208673,113
+7935,3208786,172
+7941,3208958,149
+7943,3209107,139
+7926,3209246,141
+7929,3209387,180
+7923,3209567,108
+7961,3209675,162
+7953,3209837,138
+7908,3209975,157
+7917,3210132,133
+7890,3210265,185
+7892,3210450,132
+7933,3210582,120
+7911,3210702,134
+7913,3210836,162
+7964,3210998,156
+7801,3211154,141
+7798,3211295,159
+7794,3211454,121
+7775,3211575,127
+7771,3211702,142
+7774,3211844,128
+7837,3211972,154
+7829,3212126,140
+7827,3212266,140
+7842,3212406,142
+7849,3212548,163
+7838,3212711,189
+7870,3212900,141
+7875,3213041,129
+7869,3213170,141
+7865,3213311,183
+7863,3213494,157
+7785,3213651,139
+7826,3213790,111
+7825,3213901,166
+7817,3214067,139
+7814,3214206,156
+7816,3214362,174
+7692,3214536,184
+7682,3214720,171
+7681,3214891,166
+7679,3215057,170
+7680,3215227,197
+7764,3215424,153
+7740,3215577,135
+7757,3215712,159
+7755,3215871,138
+7754,3216009,141
+7699,3216150,141
+7693,3216291,132
+7689,3216423,140
+7686,3216563,145
+7724,3216708,159
+7718,3216867,140
+7715,3217007,168
+7667,3217175,192
+7662,3217367,239
+7658,3217606,169
+7645,3217775,184
+7652,3217959,170
+7650,3218129,156
+7639,3218285,118
+7625,3218403,126
+7558,3218529,229
+7560,3218758,128
+7553,3218886,234
+7549,3219120,145
+7623,3219265,186
+7561,3219451,146
+7526,3219597,173
+7543,3219770,124
+7586,3219894,141
+7577,3220035,138
+7579,3220173,149
+7612,3220322,163
+7606,3220485,151
+7596,3220636,142
+7445,3220778,206
+7446,3220984,145
+7441,3221129,165
+7442,3221294,142
+7495,3221436,133
+7489,3221569,140
+7485,3221709,135
+7484,3221844,141
+7482,3221985,129
+7497,3222114,154
+7494,3222268,141
+7496,3222409,164
+7542,3222573,137
+7546,3222710,159
+7528,3222869,157
+7462,3223026,187
+7477,3223213,159
+7473,3223372,176
+7521,3223548,154
+7516,3223702,193
+7510,3223895,149
+7502,3224044,135
+7457,3224179,135
+7452,3224314,125
+7393,3224439,163
+7392,3224602,162
+7385,3224764,190
+7386,3224954,173
+7378,3225127,182
+7334,3225309,128
+7337,3225437,133
+7329,3225570,154
+7321,3225724,139
+7417,3225863,141
+7409,3226004,178
+7374,3226182,139
+7411,3226321,149
+7412,3226470,167
+7398,3226637,123
+7353,3226760,200
+7427,3226960,144
+7331,3227104,112
+7312,3227216,151
+7310,3227367,148
+7311,3227515,189
+7304,3227704,162
+7302,3227866,144
+7247,3228010,117
+7246,3228127,209
+7243,3228336,134
+7323,3228470,144
+7317,3228614,145
+7319,3228759,153
+7280,3228912,129
+7278,3229041,146
+7275,3229187,150
+7273,3229337,134
+7229,3229471,142
+7295,3229613,167
+7288,3229780,127
+7256,3229907,141
+7258,3230048,151
+7269,3230199,137
+7263,3230336,150
+7232,3230486,136
+7226,3230622,144
+7192,3230766,132
+7194,3230898,165
+7182,3231063,141
+7187,3231204,184
+7179,3231388,157
+7120,3231545,132
+7117,3231677,146
+7114,3231823,186
+7116,3232009,176
+7156,3232185,150
+7161,3232335,173
+7162,3232508,130
+7155,3232638,166
+7201,3232804,139
+7198,3232943,146
+7134,3233089,141
+7131,3233230,140
+7128,3233370,147
+7124,3233517,141
+7213,3233658,134
+7212,3233792,118
+7176,3233910,128
+7112,3234038,137
+7105,3234175,147
+7100,3234322,156
+7027,3234478,141
+7025,3234619,132
+7063,3234751,138
+7080,3234889,153
+7041,3235042,150
+7037,3235192,141
+7033,3235333,149
+7013,3235482,185
+7048,3235667,177
+7043,3235844,125
+7083,3235969,148
+7086,3236117,167
+7072,3236284,124
+6993,3236408,157
+6996,3236565,141
+6986,3236706,157
+6906,3236863,149
+6903,3237012,141
+6899,3237153,173
+6895,3237326,176
+6892,3237502,182
+6980,3237684,145
+6982,3237829,195
+6976,3238024,142
+6978,3238166,142
+6965,3238308,235
+6966,3238543,186
+6969,3238729,123
+6971,3238852,123
+6944,3238975,130
+6946,3239105,181
+6940,3239286,124
+6937,3239410,164
+7012,3239574,170
+6950,3239744,153
+6931,3239897,173
+6927,3240070,124
+6825,3240194,214
+6824,3240408,176
+6809,3240584,234
+6822,3240818,221
+6806,3241039,118
+6801,3241157,147
+6796,3241304,129
+6835,3241433,143
+6858,3241576,144
+6788,3241720,145
+6841,3241865,109
+6842,3241974,154
+6865,3242128,128
+6714,3242256,158
+6715,3242414,143
+6716,3242557,142
+6720,3242699,159
+6704,3242858,141
+6779,3242999,127
+6710,3243126,152
+6694,3243278,139
+6765,3243417,141
+6766,3243558,145
+6764,3243703,141
+6730,3243844,138
+6718,3243982,139
+6755,3244121,149
+6745,3244270,129
+6726,3244399,205
+6693,3244604,123
+6654,3244727,182
+6653,3244909,163
+6669,3245072,174
+6670,3245246,218
+6605,3245464,238
+6617,3245702,134
+6657,3245836,134
+6602,3245970,162
+6611,3246132,130
+6595,3246262,127
+6590,3246389,199
+6580,3246588,121
+6586,3246709,169
+6561,3246878,153
+6568,3247031,149
+6637,3247180,129
+6646,3247309,145
+6677,3247454,135
+6504,3247589,211
+6527,3247800,139
+6522,3247939,121
+6520,3248060,141
+6537,3248201,150
+6542,3248351,114
+6528,3248465,154
+6531,3248619,145
+6476,3248764,237
+6474,3249001,133
+6538,3249134,171
+6496,3249305,164
+6490,3249469,160
+6509,3249629,148
+6512,3249777,132
+6480,3249909,138
+6382,3250047,186
+6379,3250233,203
+6436,3250436,134
+6426,3250570,114
+6422,3250684,126
+6414,3250810,165
+6457,3250975,153
+6458,3251128,150
+6370,3251278,185
+6434,3251463,162
+6429,3251625,163
+6447,3251788,141
+6405,3251929,145
+6407,3252074,141
+6395,3252215,155
+6339,3252370,172
+6346,3252542,133
+6343,3252675,150
+6331,3252825,158
+6335,3252983,192
+6284,3253175,186
+6287,3253361,165
+6276,3253526,161
+6272,3253687,149
+6352,3253836,165
+6354,3254001,152
+6355,3254153,130
+6342,3254283,164
+6268,3254447,132
+6256,3254579,141
+6258,3254720,162
+6364,3254882,160
+6353,3255042,170
+6314,3255212,155
+6294,3255367,169
+6288,3255536,129
+6329,3255665,141
+6328,3255806,153
+6305,3255959,149
+6162,3256108,232
+6155,3256340,161
+6241,3256501,127
+6235,3256628,150
+6229,3256778,160
+6225,3256938,133
+6260,3257071,141
+6249,3257212,123
+6230,3257335,129
+6222,3257464,177
+6220,3257641,136
+6182,3257777,120
+6189,3257897,121
+6186,3258018,152
+6203,3258170,138
+6204,3258308,154
+6209,3258462,141
+6169,3258603,141
+6156,3258744,158
+6160,3258902,134
+6153,3259036,120
+6148,3259156,213
+6144,3259369,135
+6141,3259504,132
+6140,3259636,143
+6139,3259779,116
+6104,3259895,155
+6106,3260050,134
+6095,3260184,133
+6073,3260317,132
+6067,3260449,147
+6050,3260596,147
+5983,3260743,175
+5980,3260918,152
+6045,3261070,137
+6032,3261207,162
+6033,3261369,129
+6037,3261498,141
+5977,3261639,141
+5972,3261780,190
+5970,3261970,161
+5974,3262131,140
+6007,3262271,177
+5994,3262448,140
+6022,3262588,143
+6018,3262731,130
+6008,3262861,149
+5995,3263010,127
+6041,3263137,138
+6015,3263275,144
+5998,3263419,138
+6004,3263557,131
+5900,3263688,121
+5901,3263809,140
+5899,3263949,148
+5903,3264097,141
+5892,3264238,173
+5895,3264411,119
+5906,3264530,150
+5848,3264680,119
+5846,3264799,151
+5845,3264950,155
+5833,3265105,135
+5830,3265240,150
+5924,3265390,171
+5890,3265561,162
+5879,3265723,178
+5933,3265901,173
+5953,3266074,119
+5944,3266193,161
+5918,3266354,160
+5842,3266514,116
+5796,3266630,109
+5785,3266739,161
+5787,3266900,148
+5776,3267048,161
+5779,3267209,198
+5784,3267407,163
+5730,3267570,167
+5729,3267737,175
+5732,3267912,122
+5726,3268034,145
+5720,3268179,169
+5797,3268348,122
+5793,3268470,133
+5734,3268603,165
+5761,3268768,166
+47808,3268934,154
+5765,3269088,115
+5760,3269203,142
+5782,3269345,180
+5822,3269525,137
+5803,3269662,125
+5715,3269787,176
+5714,3269963,171
+5712,3270134,149
+5626,3270283,141
+5628,3270424,142
+5623,3270566,161
+5680,3270727,141
+5679,3270868,129
+5675,3270997,164
+5698,3271161,135
+5691,3271296,164
+5687,3271460,123
+5640,3271583,168
+5668,3271751,125
+5624,3271876,165
+5660,3272041,119
+5560,3272160,111
+5558,3272271,162
+5552,3272433,170
+5553,3272603,134
+5535,3272737,129
+5534,3272866,178
+5537,3273044,132
+5523,3273176,147
+5505,3273323,148
+5498,3273471,126
+5571,3273597,132
+5606,3273729,161
+5595,3273890,139
+5517,3274029,129
+5508,3274158,153
+5580,3274311,135
+5574,3274446,141
+5591,3274587,153
+5579,3274740,160
+5543,3274900,116
+5411,3275016,170
+5412,3275186,130
+5403,3275316,141
+5491,3275457,172
+5493,3275629,145
+5484,3275774,176
+5482,3275950,191
+5417,3276141,144
+5421,3276285,146
+5487,3276431,165
+5490,3276596,127
+5479,3276723,124
+5467,3276847,139
+5459,3276986,137
+5457,3277123,136
+5458,3277259,131
+5438,3277390,128
+5442,3277518,149
+5454,3277667,111
+5456,3277778,180
+5446,3277958,166
+5469,3278124,148
+5474,3278272,141
+5345,3278413,138
+5347,3278551,126
+5337,3278677,143
+5334,3278820,171
+5369,3278991,132
+5351,3279123,141
+5353,3279264,165
+5357,3279429,134
+5326,3279563,148
+5328,3279711,139
+5379,3279850,136
+5385,3279986,163
+5360,3280149,136
+5362,3280285,141
+5392,3280426,168
+5395,3280594,103
+5259,3280697,171
+5264,3280868,139
+5252,3281007,174
+5241,3281181,174
+5243,3281355,131
+5307,3281486,165
+5232,3281651,154
+5223,3281805,148
+5215,3281953,130
+5256,3282083,116
+5242,3282199,145
+5229,3282344,136
+5292,3282480,136
+5288,3282616,141
+5280,3282757,140
+5209,3282897,151
+5207,3283048,115
+5203,3283163,171
+5204,3283334,128
+5112,3283462,161
+5113,3283623,138
+5106,3283761,123
+5111,3283884,127
+5195,3284011,124
+5185,3284135,204
+5180,3284339,175
+5146,3284514,144
+5148,3284658,141
+5132,3284799,150
+5118,3284949,168
+5173,3285117,145
+5192,3285262,188
+5142,3285450,142
+5158,3285592,135
+5061,3285727,180
+5060,3285907,141
+5058,3286048,155
+5055,3286203,168
+5051,3286371,148
+5045,3286519,129
+5039,3286648,143
+5040,3286791,125
+5018,3286916,140
+5022,3287056,167
+5021,3287223,169
+5077,3287392,142
+5078,3287534,162
+5083,3287696,156
+5069,3287852,130
+5075,3287982,182
+5066,3288164,129
+5094,3288293,127
+5087,3288420,124
+5005,3288544,127
+5101,3288671,111
+5041,3288782,182
+4924,3288964,159
+4925,3289123,165
+4927,3289288,151
+4929,3289439,214
+4912,3289653,156
+4901,3289809,155
+4913,3289964,129
+4917,3290093,148
+4911,3290241,147
+4940,3290388,163
+4953,3290551,167
+4944,3290718,162
+4991,3290880,141
+4994,3291021,179
+5008,3291200,171
+4981,3291371,162
+4952,3291533,141
+4801,3291674,165
+4795,3291839,224
+4790,3292063,170
+4793,3292233,167
+4845,3292400,158
+4842,3292558,118
+4839,3292676,211
+4803,3292887,142
+4808,3293029,136
+4806,3293165,148
+4812,3293313,157
+4858,3293470,128
+4870,3293598,133
+4861,3293731,139
+4869,3293870,125
+4836,3293995,186
+4759,3294181,138
+4765,3294319,194
+4764,3294513,143
+4752,3294656,174
+4753,3294830,151
+4757,3294981,124
+4747,3295105,151
+4751,3295256,112
+4771,3295368,168
+4775,3295536,157
+4778,3295693,122
+4767,3295815,130
+4789,3295945,127
+4785,3296072,167
+4745,3296239,170
+4740,3296409,118
+4737,3296527,164
+4734,3296691,175
+4715,3296866,165
+4659,3297031,164
+4699,3297195,169
+4697,3297364,167
+4698,3297531,156
+4669,3297687,144
+4665,3297831,148
+4655,3297979,156
+4656,3298135,202
+4678,3298337,157
+4694,3298494,154
+4628,3298648,148
+4623,3298796,103
+4637,3298899,144
+4620,3299043,129
+4531,3299172,142
+4534,3299314,155
+4528,3299469,141
+4524,3299610,145
+4525,3299755,158
+4557,3299913,137
+4549,3300050,135
+4542,3300185,142
+4538,3300327,145
+4540,3300472,141
+4520,3300613,157
+4513,3300770,157
+4578,3300927,176
+4570,3301103,177
+4573,3301280,149
+4587,3301429,149
+4586,3301578,129
+4580,3301707,149
+4577,3301856,140
+4603,3301996,177
+4566,3302173,127
+4554,3302300,153
+4591,3302453,155
+4431,3302608,163
+4482,3302771,139
+4474,3302910,177
+4424,3303087,155
+4416,3303242,138
+4420,3303380,162
+4451,3303542,178
+4495,3303720,170
+4493,3303890,170
+4447,3304060,190
+4435,3304250,143
+4466,3304393,149
+4512,3304542,167
+4507,3304709,155
+4497,3304864,183
+4489,3305047,125
+4091,3305172,172
+4082,3305344,153
+4081,3305497,132
+4353,3305629,149
+4095,3305778,122
+4092,3305900,138
+4371,3306038,138
+4370,3306176,130
+4064,3306306,163
+4067,3306469,151
+4392,3306620,119
+4415,3306739,118
+4407,3306857,150
+4083,3307007,203
+4410,3307210,142
+3977,3307352,180
+4004,3307532,157
+4006,3307689,145
+4010,3307834,137
+4008,3307971,146
+4029,3308117,159
+4020,3308276,157
+3997,3308433,160
+4037,3308593,129
+4031,3308722,145
+3986,3308867,147
+4043,3309014,129
+4053,3309143,134
+3943,3309277,161
+3950,3309438,107
+3951,3309545,165
+3939,3309710,137
+3873,3309847,158
+3857,3310005,122
+3859,3310127,140
+3860,3310267,165
+3941,3310432,157
+3933,3310589,124
+3928,3310713,163
+3858,3310876,141
+3854,3311017,170
+3852,3311187,148
+3851,3311335,147
+3910,3311482,117
+3905,3311599,140
+3917,3311739,126
+3953,3311865,158
+3947,3312023,175
+3797,3312198,143
+3786,3312341,121
+3788,3312462,143
+3787,3312605,155
+3794,3312760,133
+3784,3312893,134
+3801,3313027,127
+3764,3313154,210
+3761,3313364,147
+3753,3313511,213
+3766,3313724,155
+3767,3313879,141
+3834,3314020,178
+3837,3314198,157
+3829,3314355,162
+3835,3314517,129
+3849,3314646,60
+3804,3314706,141
+3789,3314847,109
+3803,3314956,128
+3805,3315084,136
+3778,3315220,155
+3747,3315375,193
+3746,3315568,132
+3739,3315700,189
+3704,3315889,117
+3697,3316006,225
+3696,3316231,116
+3639,3316347,152
+3633,3316499,172
+3631,3316671,174
+3626,3316845,60
+3742,3316905,172
+3649,3317077,181
+3644,3317258,153
+3683,3317411,154
+3675,3317565,160
+3680,3317725,182
+3668,3317907,144
+3662,3318051,162
+3658,3318213,177
+3731,3318390,205
+3725,3318595,171
+3702,3318766,148
+3709,3318914,162
+3628,3319076,141
+3619,3319217,128
+3621,3319345,174
+3616,3319519,167
+3617,3319686,169
+3540,3319855,135
+3538,3319990,159
+3537,3320149,137
+3543,3320286,125
+3545,3320411,129
+3548,3320540,119
+3552,3320659,148
+3555,3320807,130
+3562,3320937,177
+3565,3321114,141
+3556,3321255,134
+3593,3321389,217
+3589,3321606,157
+3618,3321763,60
+3612,3321823,129
+3586,3321952,138
+3529,3322090,161
+3457,3322251,140
+3450,3322391,169
+3447,3322560,136
+3446,3322696,170
+3451,3322866,149
+3471,3323015,165
+3465,3323180,148
+3462,3323328,137
+3528,3323465,134
+3518,3323599,153
+3516,3323752,141
+3487,3323893,133
+3493,3324026,150
+3525,3324176,153
+3481,3324329,191
+3436,3324520,116
+3440,3324636,148
+3417,3324784,139
+3406,3324923,146
+3408,3325069,134
+3351,3325203,150
+3352,3325353,201
+3360,3325554,177
+3401,3325731,170
+3400,3325901,175
+3364,3326076,144
+3362,3326220,140
+3348,3326360,212
+3419,3326572,194
+3386,3326766,132
+3376,3326898,141
+3377,3327039,171
+3372,3327210,157
+3365,3327367,145
+3439,3327512,132
+3422,3327644,167
+3391,3327811,168
+3299,3327979,159
+3303,3328138,136
+3304,3328274,172
+3300,3328446,162
+3253,3328608,144
+3254,3328752,232
+3267,3328984,166
+3252,3329150,173
+3249,3329323,167
+3260,3329490,144
+3332,3329634,183
+3336,3329817,148
+3333,3329965,146
+3326,3330111,173
+3342,3330284,138
+3345,3330422,149
+3272,3330571,177
+3274,3330748,166
+3280,3330914,126
+3289,3331040,147
+3285,3331187,125
+3282,3331312,131
+2567,3331443,140
+3248,3331583,166
+3124,3331749,149
+3160,3331898,126
+3153,3332024,161
+3187,3332185,185
+3173,3332370,152
+3180,3332522,128
+3183,3332650,158
+3198,3332808,150
+3207,3332958,117
+3224,3333075,171
+3214,3333246,154
+3234,3333400,155
+3236,3333555,172
+3163,3333727,174
+3168,3333901,134
+3203,3334035,140
+3222,3334175,128
+3080,3334303,167
+3085,3334470,211
+3076,3334681,121
+3073,3334802,120
+3129,3334922,151
+3123,3335073,181
+3126,3335254,206
+3062,3335460,150
+3069,3335610,141
+3066,3335751,125
+3060,3335876,60
+3067,3335936,187
+3101,3336123,135
+3102,3336258,139
+3098,3336397,169
+3108,3336566,133
+3097,3336699,145
+3091,3336844,119
+3078,3336963,162
+3117,3337125,169
+3110,3337294,161
+3115,3337455,159
+3056,3337614,147
+3057,3337761,159
+3054,3337920,144
+2957,3338064,125
+2949,3338189,141
+2943,3338330,152
+2982,3338482,156
+2963,3338638,142
+2971,3338780,148
+3042,3338928,153
+3041,3339081,173
+2984,3339254,167
+2985,3339421,166
+2977,3339587,165
+2958,3339752,167
+2959,3339919,198
+3019,3340117,150
+3016,3340267,135
+3022,3340402,130
+3023,3340532,135
+3011,3340667,135
+3006,3340802,141
+3040,3340943,127
+3005,3341070,130
+2880,3341200,167
+2884,3341367,149
+2882,3341516,166
+2887,3341682,147
+2945,3341829,146
+2946,3341975,156
+2926,3342131,148
+2930,3342279,127
+2865,3342406,242
+2863,3342648,130
+2877,3342778,126
+2894,3342904,207
+2893,3343111,128
+2852,3343239,145
+2936,3343384,139
+2924,3343523,139
+37334,3343662,137
+2906,3343799,127
+2831,3343926,143
+2828,3344069,143
+2826,3344212,130
+2825,3344342,168
+2845,3344510,171
+2841,3344681,157
+2838,3344838,180
+2834,3345018,171
+2757,3345189,135
+2749,3345324,154
+2763,3345478,145
+2773,3345623,164
+2774,3345787,152
+2814,3345939,117
+2813,3346056,144
+2799,3346200,112
+2789,3346312,152
+2736,3346464,149
+2741,3346613,178
+2770,3346791,151
+2712,3346942,143
+2715,3347085,161
+2668,3347246,138
+2655,3347384,150
+2667,3347534,173
+2657,3347707,156
+2680,3347863,106
+2729,3347969,155
+2725,3348124,170
+2722,3348294,154
+2651,3348448,118
+2645,3348566,137
+2675,3348703,148
+2665,3348851,176
+2692,3349027,180
+2686,3349207,143
+2636,3349350,162
+2637,3349512,145
+2705,3349657,125
+2546,3349782,170
+2537,3349952,141
+2524,3350093,160
+2618,3350253,212
+2631,3350465,159
+2620,3350624,126
+2628,3350750,155
+2552,3350905,153
+2559,3351058,134
+2563,3351192,147
+2558,3351339,161
+2600,3351500,121
+2601,3351621,154
+2539,3351775,124
+2536,3351899,141
+2541,3352040,146
+2624,3352186,176
+2598,3352362,139
+2589,3352501,174
+2582,3352675,131
+2584,3352806,144
+2566,3352950,130
+2473,3353080,144
+2463,3353224,125
+2466,3353349,155
+2465,3353504,163
+2429,3353667,131
+2422,3353798,165
+2502,3353963,146
+2513,3354109,145
+2510,3354254,165
+2488,3354419,131
+2479,3354550,130
+2477,3354680,163
+2493,3354843,154
+2498,3354997,127
+2499,3355124,112
+2485,3355236,153
+2434,3355389,131
+2435,3355520,151
+2525,3355671,160
+2426,3355831,170
+2411,3356001,142
+2413,3356143,166
+2404,3356309,144
+2405,3356453,171
+2361,3356624,149
+2355,3356773,150
+2354,3356923,115
+2332,3357038,137
+2330,3357175,202
+2331,3357377,175
+2345,3357552,163
+2344,3357715,123
+2350,3357838,151
+2415,3357989,213
+2398,3358202,158
+2383,3358360,156
+2371,3358516,141
+2306,3358657,160
+2298,3358817,136
+2393,3358953,137
+2391,3359090,140
+2258,3359230,179
+2245,3359409,154
+2220,3359563,158
+2218,3359721,122
+2219,3359843,147
+2221,3359990,146
+2290,3360136,142
+2282,3360278,174
+2285,3360452,170
+2184,3360622,181
+2181,3360803,128
+2162,3360931,162
+2202,3361093,152
+2209,3361245,161
+2195,3361406,188
+2224,3361594,164
+2250,3361758,177
+2230,3361935,146
+2264,3362081,135
+2271,3362216,133
+2267,3362349,131
+2172,3362480,141
+2169,3362621,127
+2173,3362748,141
+2165,3362889,166
+2070,3363055,107
+2065,3363162,150
+2054,3363312,156
+2159,3363468,170
+2151,3363638,133
+2040,3363771,132
+2035,3363903,146
+2076,3364049,124
+2078,3364173,103
+2134,3364276,160
+2131,3364436,166
+2086,3364602,134
+2142,3364736,94
+1946,3364830,149
+1908,3364979,185
+1944,3365164,106
+1937,3365270,181
+2030,3365451,145
+2018,3365596,133
+2022,3365729,131
+2021,3365860,134
+2014,3365994,106
+1992,3366100,138
+1989,3366238,120
+1985,3366358,150
+1959,3366508,105
+1958,3366613,167
+1955,3366780,154
+1986,3366934,148
+1935,3367082,158
+1922,3367240,147
+1966,3367387,155
+1969,3367542,144
+1529,3367686,131
+1994,3367817,188
+2015,3368005,142
+1860,3368147,128
+1865,3368275,125
+1853,3368400,186
+1849,3368586,151
+1870,3368737,118
+1874,3368855,156
+1871,3369011,141
+1859,3369152,157
+1863,3369309,93
+1913,3369402,144
+1918,3369546,109
+1912,3369655,156
+1901,3369811,122
+1840,3369933,185
+1826,3370118,145
+1888,3370263,181
+1845,3370444,162
+1886,3370606,156
+1823,3370762,150
+1825,3370912,127
+1926,3371039,145
+1724,3371184,132
+1730,3371316,161
+1620,3371477,179
+1716,3371656,151
+1710,3371807,182
+1765,3371989,180
+1758,3372169,132
+1759,3372301,147
+1757,3372448,169
+1776,3372617,126
+1792,3372743,149
+1733,3372892,162
+1734,3373054,113
+1719,3373167,111
+1775,3373278,146
+1769,3373424,117
+1770,3373541,150
+1800,3373691,135
+1810,3373826,166
+1811,3373992,124
+1799,3374116,126
+1778,3374242,148
+1786,3374390,146
+1795,3374536,117
+1798,3374653,134
+1745,3374787,143
+1748,3374930,152
+1738,3375082,211
+1742,3375293,101
+1678,3375394,136
+1674,3375530,161
+1669,3375691,142
+1616,3375833,145
+1630,3375978,139
+1663,3376117,127
+1667,3376244,165
+1621,3376409,135
+1654,3376544,162
+1636,3376706,147
+1658,3376853,129
+1651,3376982,168
+1691,3377150,155
+1683,3377305,174
+1629,3377479,145
+1712,3377624,139
+1686,3377763,133
+1495,3377896,139
+1499,3378035,133
+1501,3378168,141
+1576,3378309,141
+1565,3378450,139
+1561,3378589,165
+1600,3378754,131
+1604,3378885,224
+1605,3379109,151
+10512896,3379260,142
+1528,3379402,150
+1515,3379552,158
+1512,3379710,126
+1526,3379836,140
+1532,3379976,139
+1594,3380115,132
+1586,3380247,133
+1588,3380380,133
+1548,3380513,145
+1550,3380658,141
+1556,3380799,118
+1544,3380917,113
+1475,3381030,148
+1465,3381178,131
+1468,3381309,161
+1470,3381470,119
+1469,3381589,101
+1473,3381690,134
+1460,3381824,141
+1432,3381965,111
+1463,3382076,143
+1435,3382219,141
+1406,3382360,154
+1408,3382514,137
+1410,3382651,149
+1497,3382800,141
+1500,3382941,141
+1488,3383082,125
+1439,3383207,135
+1415,3383342,146
+1424,3383488,119
+1429,3383607,141
+1400,3383748,60
+1394,3383808,133
+1398,3383941,135
+1386,3384076,146
+1384,3384222,135
+1462,3384357,148
+1365,3384505,163
+1362,3384668,138
+1354,3384806,160
+1352,3384966,147
+1271,3385113,146
+1262,3385259,161
+1264,3385420,141
+1319,3385561,128
+1321,3385689,210
+1324,3385899,156
+1342,3386055,123
+1343,3386178,130
+1341,3386308,130
+1280,3386438,141
+1305,3386579,153
+1293,3386732,163
+1332,3386895,133
+1333,3387028,130
+1287,3387158,124
+1277,3387282,176
+1378,3387458,137
+1253,3387595,139
+1234,3387734,124
+1235,3387858,136
+1194,3387994,157
+1184,3388151,154
+1182,3388305,145
+1178,3388450,141
+1145,3388591,119
+1200,3388710,134
+1195,3388844,137
+1191,3388981,158
+1176,3389139,133
+1175,3389272,146
+1237,3389418,241
+1226,3389659,128
+1160,3389787,138
+1157,3389925,127
+1242,3390052,151
+1221,3390203,141
+1078,3390344,170
+1074,3390514,167
+1077,3390681,138
+1079,3390819,178
+1036,3390997,122
+1032,3391119,151
+1031,3391270,176
+1033,3391446,135
+1109,3391581,120
+1111,3391701,182
+1101,3391883,141
+1108,3392024,110
+1096,3392134,140
+1095,3392274,165
+1086,3392439,123
+1133,3392562,141
+1126,3392703,129
+994,3392832,141
+1023,3392973,141
+1044,3393114,173
+1064,3393287,141
+902,3393428,128
+893,3393556,130
+899,3393686,148
+972,3393834,153
+983,3393987,151
+979,3394138,157
+973,3394295,143
+907,3394438,135
+908,3394573,125
+1006,3394698,137
+1002,3394835,168
+998,3395003,133
+937,3395136,118
+927,3395254,141
+912,3395395,171
+949,3395566,150
+868,3395716,160
+862,3395876,179
+860,3396055,137
+861,3396192,138
+889,3396330,168
+879,3396498,123
+882,3396621,121
+820,3396742,141
+826,3396883,142
+818,3397025,141
+782,3397166,177
+786,3397343,147
+833,3397490,128
+32823,3397618,117
+829,3397735,124
+870,3397859,142
+866,3398001,152
+845,3398153,149
+802,3398302,127
+797,3398429,146
+806,3398575,153
+656,3398728,133
+658,3398861,152
+646,3399013,135
+722,3399148,120
+717,3399268,133
+720,3399401,149
+716,3399550,119
+688,3399669,196
+682,3399865,141
+693,3400006,125
+692,3400131,104
+684,3400235,123
+729,3400358,143
+751,3400501,167
+744,3400668,98
+754,3400766,131
+669,3400897,129
+709,3401026,153
+586,3401179,141
+585,3401320,154
+581,3401474,136
+562,3401610,139
+565,3401749,164
+567,3401913,129
+552,3402042,117
+582,3402159,168
+570,3402327,141
+639,3402468,137
+638,3402605,141
+4245,3402746,139
+605,3402885,138
+635,3403023,139
+627,3403162,140
+599,3403302,142
+595,3403444,130
+623,3403574,163
+560,3403737,126
+540,3403863,151
+524,3404014,117
+534,3404131,141
+532,3404272,115
+527,3404387,100
+451,3404487,127
+450,3404614,144
+490,3404758,129
+480,3404887,134
+428,3405021,142
+493,3405163,126
+502,3405289,194
+459,3405483,111
+470,3405594,112
+429,3405706,210
+392,3405916,126
+411,3406042,161
+383,3406203,165
+346,3406368,156
+298,3406524,166
+358,3406690,121
+374,3406811,164
+344,3406975,160
+301,3407135,137
+328,3407272,149
+391,3407421,123
+384,3407544,133
+407,3407677,141
+410,3407818,115
+345,3407933,130
+369,3408063,133
+12460,3408196,165
+12539,3408361,144
+12462,3408505,146
+12291,3408651,136
+12514,3408787,142
+314,3408929,139
+320,3409068,131
+291,3409199,215
+293,3409414,165
+294,3409579,124
+283,3409703,156
+285,3409859,154
+287,3410013,151
+45184,3410164,149
+45086,3410313,140
+45296,3410453,132
+45210,3410585,158
+12334,3410743,138
+12525,3410881,182
+12303,3411063,159
+12418,3411222,165
+12457,3411387,139
+12542,3411526,114
+12484,3411640,170
+12365,3411810,109
+529475,3411919,120
+45065,3412039,172
+45228,3412211,178
+12323,3412389,168
+12432,3412557,148
+12455,3412705,146
+12412,3412851,133
+12373,3412984,163
+12335,3413147,150
+12302,3413297,141
+12501,3413438,130
+12312,3413568,172
+12447,3413740,134
+12456,3413874,151
+12497,3414025,140
+12475,3414165,133
+12463,3414298,134
+12458,3414432,160
+12425,3414592,160
+12442,3414752,146
+12423,3414898,123
+12386,3415021,142
+12333,3415163,163
+12491,3415326,165
+12395,3415491,150
+12461,3415641,137
+12495,3415778,142
+12466,3415920,130
+12341,3416050,135
+12415,3416185,106
+53269,3416291,154
+53320,3416445,132
+53413,3416577,130
+12381,3416707,140
+12342,3416847,152
+53455,3416999,111
+53375,3417110,170
+12518,3417280,154
+12477,3417434,140
+12295,3417574,124
+53442,3417698,132
+53282,3417830,165
+53361,3417995,137
+53327,3418132,139
+53353,3418271,158
+53392,3418429,141
+53493,3418570,141
+53481,3418711,178
+53396,3418889,141
+53499,3419030,163
+53350,3419193,156
+53378,3419349,130
+53377,3419479,172
+53250,3419651,149
+53381,3419800,147
+53265,3419947,148
+53471,3420095,144
+53403,3420239,123
+53351,3420362,154
+53336,3420516,141
+53298,3420657,142
+53489,3420799,142
+53306,3420941,138
+53249,3421079,140
+20542,3421219,141
+20512,3421360,129
+53365,3421489,161
+53324,3421650,137
+53473,3421787,126
+53256,3421913,138
+53465,3422051,154
+53259,3422205,141
+53404,3422346,148
+53491,3422494,125
+53305,3422619,137
+53408,3422756,111
+53258,3422867,133
+53276,3423000,145
+53461,3423145,109
+53313,3423254,170
+53405,3423424,133
+53357,3423557,127
+53291,3423684,140
+53346,3423824,105
+53389,3423929,140
+53309,3424069,130
+20678,3424199,189
+20639,3424388,132
+20645,3424520,175
+20480,3424695,158
+20624,3424853,97
+20539,3424950,151
+20550,3425101,176
+20545,3425277,132
+20656,3425409,163
+20701,3425572,134
+20579,3425706,141
+20621,3425847,151
+20640,3425998,174
+20582,3426172,194
+20569,3426366,127
+20697,3426493,218
+20481,3426711,142
+20583,3426853,131
+20662,3426984,146
+20555,3427130,113
+20714,3427243,150
+20680,3427393,158
+20676,3427551,105
+20617,3427656,162
+20724,3427818,138
+20513,3427956,152
+20574,3428108,139
+20712,3428247,143
+20654,3428390,126
+20711,3428516,148
+20731,3428664,114
+36979,3428778,148
+36987,3428926,115
+36993,3429041,156
+36892,3429197,131
+20614,3429328,125
+20506,3429453,137
+20623,3429590,158
+20501,3429748,146
+20567,3429894,155
+20616,3430049,127
+20529,3430176,161
+37083,3430337,160
+36950,3430497,146
+36968,3430643,132
+36958,3430775,149
+37039,3430924,161
+20483,3431085,129
+20691,3431214,155
+20653,3431369,161
+20655,3431530,133
+36916,3431663,127
+37034,3431790,184
+36955,3431974,170
+37052,3432144,136
+36874,3432280,169
+37112,3432449,130
+36880,3432579,165
+37062,3432744,151
+36910,3432895,137
+36919,3433032,143
+36984,3433175,158
+37048,3433333,171
+36890,3433504,138
+37045,3433642,158
+36869,3433800,153
+36953,3433953,145
+37066,3434098,194
+37097,3434292,136
+37099,3434428,150
+37118,3434578,173
+37051,3434751,179
+37008,3434930,115
+37077,3435045,130
+36938,3435175,165
+37007,3435340,136
+37022,3435476,137
+4242,3435613,118
+4124,3435731,164
+4166,3435895,145
+4136,3436040,156
+4279,3436196,164
+37093,3436360,133
+37108,3436493,146
+36980,3436639,140
+37023,3436779,154
+36923,3436933,155
+4297,3437088,183
+1024,3437271,159
+4293,3437430,156
+4122,3437586,141
+4167,3437727,156
+36927,3437883,140
+4163,3438023,121
+4261,3438144,141
+4311,3438285,140
+4140,3438425,129
+4349,3438554,114
+36889,3438668,166
+37080,3438834,153
+4174,3438987,114
+4290,3439101,124
+4160,3439225,147
+4142,3439372,214
+4272,3439586,166
+4129,3439752,153
+4196,3439905,131
+4212,3440036,167
+4254,3440203,118
+4101,3440321,121
+4280,3440442,147
+4235,3440589,158
+4295,3440747,160
+4208,3440907,154
+4282,3441061,168
+4276,3441229,143
+1196,3441372,142
+4199,3441514,115
+57469,3441629,123
+57384,3441752,139
+57484,3441891,157
+57505,3442048,176
+57480,3442224,158
+57437,3442382,149
+57438,3442531,166
+57501,3442697,136
+57432,3442833,147
+57462,3442980,157
+57592,3443137,132
+57567,3443269,126
+57586,3443395,146
+57569,3443541,148
+57405,3443689,163
+57414,3443852,131
+57467,3443983,120
+57373,3444103,141
+57549,3444244,157
+57485,3444401,145
+57369,3444546,156
+57415,3444702,154
+57539,3444856,169
+57490,3445025,139
+57599,3445164,171
+57515,3445335,121
+57392,3445456,166
+57395,3445622,134
+57506,3445756,140
+57465,3445896,109
+57461,3446005,142
+24633,3446147,151
+24649,3446298,143
+24717,3446441,129
+57390,3446570,160
+57498,3446730,137
+57406,3446867,124
+24729,3446991,126
+24755,3447117,129
+24578,3447246,168
+24713,3447414,122
+24609,3447536,135
+24760,3447671,130
+57514,3447801,149
+57360,3447950,159
+57554,3448109,170
+24782,3448279,156
+24630,3448435,182
+24718,3448617,204
+24602,3448821,142
+24682,3448963,183
+24749,3449146,139
+24661,3449285,139
+24685,3449424,147
+24761,3449571,149
+24732,3449720,153
+24783,3449873,146
+24693,3450019,129
+24759,3450148,144
+24582,3450292,137
+24762,3450429,144
+24728,3450573,140
+24798,3450713,141
+24784,3450854,170
+24597,3451024,140
+24733,3451164,145
+24738,3451309,146
+24708,3451455,133
+24621,3451588,156
+24824,3451744,192
+24696,3451936,161
+24808,3452097,187
+24822,3452284,197
+24690,3452481,169
+24657,3452650,147
+24722,3452797,136
+24734,3452933,224
+24592,3453157,164
+24644,3453321,153
+24580,3453474,153
+24802,3453627,170
+24756,3453797,145
+40989,3453942,147
+41126,3454089,151
+41041,3454240,154
+40979,3454394,149
+41145,3454543,157
+40985,3454700,152
+41197,3454852,151
+24778,3455003,169
+24612,3455172,159
+24751,3455331,152
+24632,3455483,151
+24655,3455634,124
+41168,3455758,163
+41148,3455921,144
+41051,3456065,133
+41100,3456198,155
+41048,3456353,130
+41079,3456483,141
+41120,3456624,137
+41016,3456761,133
+41061,3456894,151
+41123,3457045,154
+40987,3457199,161
+41045,3457360,146
+41076,3457506,145
+41087,3457651,145
+41001,3457796,141
+41095,3457937,140
+41027,3458077,168
+41026,3458245,142
+41153,3458387,113
+41039,3458500,133
+41167,3458633,130
+41074,3458763,141
+41090,3458904,117
+41200,3459021,156
+41175,3459177,153
+41201,3459330,113
+41139,3459443,123
+41215,3459566,143
+41189,3459709,147
+41014,3459856,170
+41170,3460026,180
+41115,3460206,152
+40960,3460358,159
+41098,3460517,166
+41083,3460683,146
+41052,3460829,155
+8207,3460984,127
+41171,3461111,152
+41140,3461263,152
+41056,3461415,144
+41091,3461559,128
+41130,3461687,134
+41019,3461821,152
+41203,3461973,102
+8415,3462075,157
+8391,3462232,156
+40964,3462388,133
+8233,3462521,171
+8297,3462692,154
+8331,3462846,156
+8235,3463002,169
+8299,3463171,159
+8196,3463330,161
+8213,3463491,122
+8345,3463613,142
+8441,3463755,150
+8338,3463905,130
+8259,3464035,158
+8305,3464193,114
+8316,3464307,121
+8279,3464428,152
+8421,3464580,133
+8327,3464713,139
+8380,3464852,168
+49344,3465020,154
+49164,3465174,150
+49267,3465324,143
+49364,3465467,141
+49357,3465608,120
+8429,3465728,163
+8325,3465891,136
+8397,3466027,148
+8238,3466175,141
+8371,3466316,108
+8430,3466424,142
+8268,3466566,161
+8215,3466727,101
+8339,3466828,149
+8291,3466977,132
+8214,3467109,159
+8269,3467268,114
+8287,3467382,132
+8223,3467514,150
+8374,3467664,140
+8401,3467804,155
+8398,3467959,157
+8212,3468116,144
+8386,3468260,164
+49395,3468424,172
+8278,3468596,109
+8258,3468705,139
+8312,3468844,135
+8198,3468979,163
+8228,3469142,164
+8285,3469306,112
+49157,3469418,172
+49271,3469590,146
+49352,3469736,141
+49257,3469877,165
+49255,3470042,161
+49315,3470203,170
+49176,3470373,139
+40334,3470512,145
+47873,3470657,138
+49203,3470795,140
+49296,3470935,113
+49374,3471048,132
+49171,3471180,125
+49259,3471305,127
+49228,3471432,135
+49276,3471567,129
+49336,3471696,141
+49250,3471837,141
+49388,3471978,145
+49286,3472123,148
+49240,3472271,146
+49360,3472417,124
+49343,3472541,146
+49338,3472687,137
+49246,3472824,126
+49365,3472950,158
+49251,3473108,164
+49185,3473272,137
+49371,3473409,159
+49307,3473568,144
+49258,3473712,141
+49379,3473853,157
+49406,3474010,159
+49174,3474169,155
+49340,3474324,129
+49345,3474453,138
+49289,3474591,131
+49328,3474722,143
+49162,3474865,112
+49268,3474977,126
+16462,3475103,134
+16525,3475237,165
+16411,3475402,153
+16547,3475555,168
+16563,3475723,133
+16413,3475856,152
+49354,3476008,123
+49260,3476131,151
+16639,3476282,152
+16415,3476434,138
+16559,3476572,149
+16631,3476721,140
+16439,3476861,137
+49190,3476998,160
+16510,3477158,152
+16633,3477310,131
+49263,3477441,122
+49319,3477563,110
+49226,3477673,108
+16468,3477781,163
+16388,3477944,120
+16472,3478064,124
+16408,3478188,148
+16458,3478336,150
+16444,3478486,108
+16450,3478594,104
+16626,3478698,151
+16546,3478849,159
+16604,3479008,133
+16480,3479141,136
+16470,3479277,118
+16432,3479395,110
+16448,3479505,142
+32855,3479647,123
+32955,3479770,146
+16445,3479916,145
+16592,3480061,149
+16566,3480210,146
+16550,3480356,121
+16446,3480477,149
+16454,3480626,146
+49367,3480772,154
+16602,3480926,120
+16583,3481046,152
+16466,3481198,144
+16430,3481342,166
+16427,3481508,149
+16410,3481657,134
+16479,3481791,136
+16512,3481927,142
+16465,3482069,143
+16506,3482212,157
+16433,3482369,144
+16595,3482513,168
+16622,3482681,131
+16421,3482812,149
+16487,3482961,152
+16579,3483113,154
+16620,3483267,129
+32815,3483396,168
+32852,3483564,166
+32851,3483730,140
+32806,3483870,165
+32944,3484035,126
+33018,3484161,106
+33021,3484267,134
+33022,3484401,154
+32828,3484555,123
+32838,3484678,123
+16386,3484801,140
+16457,3484941,169
+16425,3485110,82
+16542,3485192,157
+32941,3485349,143
+32782,3485492,152
+32939,3485644,157
+33009,3485801,131
+32809,3485932,157
+32882,3486089,153
+16385,3486242,184
+16497,3486426,134
+32785,3486560,160
+32820,3486720,108
+32996,3486828,158
+33004,3486986,168
+32812,3487154,147
+32982,3487301,139
+32778,3487440,135
+32843,3487575,136
+32968,3487711,138
+32786,3487849,166
+32807,3488015,153
+33020,3488168,137
+32790,3488305,136
+32930,3488441,150
+32972,3488591,163
+32933,3488754,140
+32889,3488894,139
+121,3489033,146
+145,3489179,118
+117,3489297,151
+165,3489448,127
+54,3489575,140
+248,3489715,160
+32860,3489875,152
+32965,3490027,156
+32888,3490183,167
+33014,3490350,158
+32891,3490508,159
+32788,3490667,134
+32951,3490801,128
+237,3490929,98
+163,3491027,161
+57,3491188,133
+60,3491321,149
+126,3491470,142
+203,3491612,158
+19,3491770,111
+149,3491881,135
+87,3492016,128
+214,3492144,132
+158,3492276,107
+66,3492383,156
+125,3492539,140
+150,3492679,155
+94,3492834,167
+56,3493001,120
+68,3493121,150
+206,3493271,128
+123,3493399,122
+15,3493521,126
+187,3493647,136
+26,3493783,143
+127,3493926,116
+96,3494042,139
+524399,3494181,129
+64,3494310,141
+93,3494451,120
+18,3494571,171
+138,3494742,164
+50,3494906,132
+133,3495038,117
+74,3495155,165
+524431,3495320,151
+106,3495471,153
+524350,3495624,143
+524352,3495767,163
+524346,3495930,129
+524349,3496059,145
+524344,3496204,139
+524403,3496343,121
+524402,3496464,165
+524394,3496629,113
+524410,3496742,100
+524409,3496842,133
+524365,3496975,140
+524335,3497115,143
+524332,3497258,139
+524386,3497397,114
+524380,3497511,142
+524378,3497653,142
+524370,3497795,123
+524318,3497918,145
+524313,3498063,161
+159745,3498224,141
+524302,3498365,131
+56585,3498496,145
+2,3498641,129
+3,3498770,129
+6,3498899,129
+524289,3499028,158
+524293,3499186,131
+56583,3499317,145
+8,3499462,129
+61,3499591,109
+56589,3499700,145
+524388,3499845,109
+524290,3499954,161
+524314,3500115,143
+524427,3500258,158
+524306,3500416,162
+1352127,3500578,204
+9733060,3500782,185
+524336,3500967,155
+11,3501122,149
+155,3501271,165
+10261424,3501436,263
+6598385,3501699,184
+524310,3501883,151
+4508555,3502034,139
+11797853,3502173,201
+9979943,3502374,252
+13956591,3502626,158
+2669961,3502784,139
+15473597,3502923,147
+14197525,3503070,197
+8414330,3503267,126
+7403563,3503393,217
+1320053,3503610,134
+1105078,3503744,154
+16293416,3503898,138
+16303347,3504036,259
+13924139,3504295,267
+6617536,3504562,138
+1626309,3504700,213
+3468571,3504913,141
+12363025,3505054,122
+2683,3505176,136
+12904714,3505312,189
+12862589,3505501,196
+3205518,3505697,196
+7637812,3505893,253
+11320688,3506146,180
+12594726,3506326,60
+3461730,3506386,181
+529061,3506567,141
+8421368,3506708,137
+4457335,3506845,154
+9351,3506999,149
+11856291,3507148,167
+3729646,3507315,203
+9484512,3507518,256
+10286385,3507774,213
+8447061,3507987,185
+2903238,3508172,178
+8134925,3508350,139
+5028978,3508489,134
+6816440,3508623,189
+3433428,3508812,216
+587753,3509028,186
+9222693,3509214,198
+13934139,3509412,259
+14474466,3509671,161
+10529897,3509832,161
+1083899,3509993,161
+14437341,3510154,275
+12629453,3510429,180
+5001335,3510609,180
+5254587,3510789,229
+8710807,3511018,243
+6044221,3511261,178
+3210597,3511439,196
+8167854,3511635,123
+3941115,3511758,123
+5827324,3511881,120
+9442266,3512001,130
+1315165,3512131,212
+15004455,3512343,141
+6822316,3512484,239
+15216140,3512723,155
+1610404,3512878,133
+1050668,3513011,130
+11563869,3513141,180
+15774930,3513321,189
+6044229,3513510,234
+10501169,3513744,179
+11048909,3513923,139
+4213879,3514062,139
+2941712,3514201,129
+8864,3514330,146
+10760314,3514476,175
+16551515,3514651,218
+1321492,3514869,282
+14188150,3515151,214
+3689307,3515365,190
+12083522,3515555,211
+2099725,3515766,154
+14974053,3515920,251
+10245338,3516171,142
+4999503,3516313,178
+12874782,3516491,178
+53368,3516669,141
+6060280,3516810,180
+12068805,3516990,180
+14453123,3517170,161
+6081433,3517331,161
+13918325,3517492,241
+7915000,3517733,180
+13917540,3517913,167
+9482564,3518080,161
+4775180,3518241,122
+9702552,3518363,123
+15268841,3518486,123
+3730445,3518609,123
+5777292,3518732,159
+1313477,3518891,141
+2130936,3519032,164
+13158224,3519196,193
+2940119,3519389,169
+3466202,3519558,139
+14728094,3519697,166
+4772431,3519863,178
+14985964,3520041,232
+9748038,3520273,271
+11335884,3520544,139
+9198117,3520683,139
+4734938,3520822,170
+7101754,3520992,141
+13423662,3521133,158
+13128673,3521291,267
+1316509,3521558,141
+4760294,3521699,121
+9495292,3521820,154
+15730897,3521974,170
+5805234,3522144,117
+11572597,3522261,252
+11841621,3522513,196
+298006,3522709,196
+10018139,3522905,170
+3955953,3523075,122
+1355397,3523197,154
+9467037,3523351,157
+9190194,3523508,133
+13685728,3523641,189
+6577395,3523830,166
+11586814,3523996,180
+5508601,3524176,180
+26137,3524356,180
+16529764,3524536,214
+1328941,3524750,213
+14979325,3524963,123
+8694554,3525086,123
+2125105,3525209,140
+13657412,3525349,123
+1601325,3525472,286
+16273325,3525758,222
+4983357,3525980,127
+3965035,3526107,230
+6348341,3526337,157
+2634110,3526494,227
+11026722,3526721,259
+7134652,3526980,161
+13401974,3527141,141
+4242536,3527282,282
+14456896,3527564,141
+4486740,3527705,196
+8182176,3527901,196
+15741925,3528097,196
+11858316,3528293,180
+12111606,3528473,171
+12059300,3528644,169
+14975782,3528813,196
+9700795,3529009,154
+9199533,3529163,199
+11321949,3529362,199
+9178247,3529561,114
+1599960,3529675,226
+12858065,3529901,221
+13386126,3530122,148
+13412289,3530270,139
+3703929,3530409,138
+8167101,3530547,170
+1835545,3530717,213
+13162360,3530930,143
+10248477,3531073,179
+12621274,3531252,208
+11805184,3531460,159
+6834610,3531619,153
+4750079,3531772,103
+4241127,3531875,180
+13677661,3532055,180
+8926927,3532235,180
+10798414,3532415,180
+13941734,3532595,180
+40686,3532775,161
+9484338,3532936,147
+4206470,3533083,139
+13902541,3533222,143
+13133662,3533365,147
+10247442,3533512,147
+15768809,3533659,147
+12850146,3533806,147
+16051103,3533953,157
+15243458,3534110,142
+13900488,3534252,179
+5267958,3534431,161
+3122,3534592,132
+2573,3534724,119
+16012320,3534843,245
+4997256,3535088,164
+6610409,3535252,219
+819581,3535471,175
+325108,3535646,132
+13155557,3535778,154
+15250544,3535932,154
+7149,3536086,172
+3291,3536258,172
+1152,3536430,172
+6331551,3536602,172
+136,3536774,172
+24799,3536946,172
+24681,3537118,172
+1331,3537290,172
+11552002,3537462,180
+1843185,3537642,180
+11857692,3537822,211
+1367609,3538033,180
+12120073,3538213,170
+16544250,3538383,133
+13418073,3538516,122
+8692661,3538638,141
+3210475,3538779,189
+2386096,3538968,161
+1839928,3539129,160
+10284538,3539289,124
+15492077,3539413,158
+13920097,3539571,172
+14958882,3539743,212
+10230210,3539955,270
+12330657,3540225,166
+7654387,3540391,163
+15782223,3540554,125
+4456,3540679,131
+1630145,3540810,136
+16563214,3540946,250
+2936934,3541196,219
+11558106,3541415,112
+14466426,3541527,259
+9443002,3541786,196
+6335215,3541982,180
+13693941,3542162,180
+13911625,3542342,196
+9699504,3542538,196
+2390511,3542734,232
+11281204,3542966,230
+11111,3543196,189
+16301070,3543385,122
+5300281,3543507,187
+12081014,3543694,138
+2359546,3543832,259
+13123068,3544091,191
+14686613,3544282,129
+16273704,3544411,120
+11280137,3544531,256
+12325800,3544787,254
+9467886,3545041,141
+3937228,3545182,141
+9757678,3545323,178
+14212160,3545501,123
+8413125,3545624,123
+1112352,3545747,141
+2124160,3545888,123
+6566568,3546011,140
+8395060,3546151,140
+4236236,3546291,140
+14985120,3546431,140
+3952062,3546571,123
+4728364,3546694,123
+1342938,3546817,123
+12882188,3546940,123
+7117153,3547063,178
+5293833,3547241,137
+8416663,3547378,60
+6577542,3547438,140
+1580522,3547578,140
+1595008,3547718,140
+10527941,3547858,140
+16044296,3547998,140
+2128152,3548138,140
+11038122,3548278,140
+3670053,3548418,140
+12641184,3548558,192
+16040212,3548750,166
+9233512,3548916,238
+13152923,3549154,140
+7105143,3549294,140
+10793409,3549434,140
+3419831,3549574,140
+9225857,3549714,140
+13433316,3549854,140
+3954882,3549994,140
+14966327,3550134,140
+2376076,3550274,140
+6353506,3550414,140
+12630147,3550554,140
+13109672,3550694,140
+9467969,3550834,140
+5808163,3550974,140
+13947474,3551114,140
+2640103,3551254,180
+316336,3551434,140
+14707878,3551574,169
+4483084,3551743,185
+9965092,3551928,209
+11022524,3552137,161
+25566,3552298,210
+6333475,3552508,149
+7882452,3552657,161
+14958278,3552818,196
+3704862,3553014,196
+2939655,3553210,140
+9997638,3553350,140
+14952075,3553490,180
+6850721,3553670,161
+7858,3553831,155
+12617395,3553986,249
+4500913,3554235,178
+1874113,3554413,275
+10525463,3554688,151
+4456891,3554839,236
+10541117,3555075,199
+5829372,3555274,180
+6568682,3555454,141
+5271619,3555595,121
+13636625,3555716,154
+3953623,3555870,116
+58852,3555986,240
+15209326,3556226,196
+5025299,3556422,196
+4992766,3556618,258
+1096855,3556876,197
+14472260,3557073,180
+14725728,3557253,232
+10766004,3557485,180
+837700,3557665,176
+15260192,3557841,156
+4727605,3557997,175
+9209281,3558172,189
+2138481,3558361,141
+8190368,3558502,199
+7120081,3558701,199
+5548858,3558900,203
+15243919,3559103,162
+15494298,3559265,158
+3435932,3559423,144
+13956950,3559567,178
+14707002,3559745,143
+5540062,3559888,141
+7875428,3560029,136
+2424077,3560165,134
+3429780,3560299,214
+10251063,3560513,192
+11024217,3560705,180
+4237910,3560885,189
+6837338,3561074,140
+3990503,3561214,192
+13387709,3561406,137
+5018534,3561543,154
+7729,3561697,142
+5306349,3561839,180
+5028251,3562019,225
+12353163,3562244,175
+799196,3562419,196
+4251089,3562615,150
+12642239,3562765,186
+5535626,3562951,158
+2388306,3563109,117
+4788,3563226,144
+16555,3563370,172
+6566875,3563542,130
+10749673,3563672,130
+11579667,3563802,130
+5025516,3563932,247
+8162017,3564179,221
+5563561,3564400,138
+2130008,3564538,133
+6834862,3564671,196
+6346581,3564867,196
+10765773,3565063,142
+9724521,3565205,139
+13688137,3565344,137
+13132796,3565481,139
+1887446,3565620,219
+11059794,3565839,180
+10502471,3566019,180
+1879755,3566199,196
+5042590,3566395,152
+2111191,3566547,227
+6817546,3566774,160
+5041085,3566934,234
+8177958,3567168,258
+6059439,3567426,141
+3717808,3567567,117
+7374750,3567684,228
+11817058,3567912,163
+281196,3568075,196
+3734292,3568271,196
+15787170,3568467,196
+8147337,3568663,177
+1074120,3568840,174
+5775449,3569014,219
+9447211,3569233,135
+5029044,3569368,146
+9753861,3569514,199
+7659958,3569713,123
+2401580,3569836,196
+4728665,3570032,152
+11302675,3570184,236
+558237,3570420,141
+9485798,3570561,220
+1615017,3570781,119
+8448044,3570900,139
+13938109,3571039,141
+2375854,3571180,193
+15994369,3571373,123
+1349070,3571496,123
+5299718,3571619,123
+6082869,3571742,157
+7891412,3571899,195
+534167,3572094,187
+13421772,3572281,149
+13395466,3572430,123
+16522563,3572553,123
+6605727,3572676,253
+5045246,3572929,178
+12635121,3573107,238
+16547180,3573345,178
+14974618,3573523,178
+2889405,3573701,154
+3188873,3573855,144
+11838187,3573999,154
+1889762,3574153,254
+9449,3574407,183
+6830968,3574590,141
+16277744,3574731,189
+6070752,3574920,172
+8705042,3575092,140
+6859529,3575232,114
+16043574,3575346,154
+11821175,3575500,204
+63008,3575704,139
+16003880,3575843,139
+8164394,3575982,196
+1882006,3576178,196
+3688380,3576374,196
+5542409,3576570,196
+7624969,3576766,196
+6052551,3576962,141
+3979083,3577103,166
+60856,3577269,140
+10262989,3577409,127
+12895747,3577536,141
+12362042,3577677,123
+2630645,3577800,261
+15732907,3578061,262
+11852809,3578323,249
+9995869,3578572,189
+8172955,3578761,252
+2903890,3579013,141
+6856766,3579154,197
+12108677,3579351,197
+5040612,3579548,185
+11328328,3579733,139
+13110578,3579872,130
+13653908,3580002,178
+317941,3580180,167
+12095945,3580347,161
+13150070,3580508,196
+10748130,3580704,196
+11846908,3580900,219
+13162141,3581119,163
+4217816,3581282,234
+5565487,3581516,135
+2660807,3581651,157
+16563559,3581808,144
+9598,3581952,184
+16297511,3582136,158
+7620046,3582294,120
+12908501,3582414,141
+1860761,3582555,182
+1104970,3582737,199
+8974102,3582936,139
+9218415,3583075,163
+8181345,3583238,219
+11599115,3583457,154
+10008762,3583611,189
+846234,3583800,152
+4985262,3583952,170
+9210362,3584122,206
+5028936,3584328,141
+8441930,3584469,166
+4774005,3584635,240
+13924507,3584875,141
+4734953,3585016,196
+1326275,3585212,196
+11068740,3585408,196
+1581269,3585604,139
+3166461,3585743,212
+16572,3585955,125
+16485,3586080,127
+8971851,3586207,137
+14209168,3586344,117
+5293277,3586461,159
+34029,3586620,60
+14680741,3586680,124
+16002687,3586804,189
+11848708,3586993,137
+12113190,3587130,187
+15776104,3587317,214
+320878,3587531,155
+1867564,3587686,196
+8961217,3587882,196
+1884110,3588078,254
+16265218,3588332,130
+11051353,3588462,174
+15511008,3588636,189
+7920135,3588825,232
+4498974,3589057,147
+3723978,3589204,259
+1089082,3589463,232
+9457091,3589695,118
+3569,3589813,184
+1916,3589997,161
+9192045,3590158,196
+9500817,3590354,168
+4480350,3590522,207
+5287281,3590729,228
+2108101,3590957,121
+11059004,3591078,223
+13956391,3591301,155
+12104440,3591456,123
+9979402,3591579,123
+12082442,3591702,123
+8165917,3591825,123
+1060901,3591948,123
+7384279,3592071,254
+5530338,3592325,123
+1351065,3592448,123
+1342380,3592571,114
+9465093,3592685,174
+13941704,3592859,197
+4756743,3593056,213
+2408308,3593269,60
+13425749,3593329,225
+2686898,3593554,140
+1859794,3593694,199
+16037290,3593893,178
+15248557,3594071,178
+538313,3594249,122
+7625669,3594371,154
+9715913,3594525,158
+10502567,3594683,157
+14960346,3594840,219
+1839792,3595059,141
+5032097,3595200,142
+5029016,3595342,154
+2946098,3595496,170
+6583142,3595666,252
+270074,3595918,151
+14177653,3596069,161
+13898147,3596230,161
+309901,3596391,161
+7621928,3596552,128
+41093,3596680,60
+14703263,3596740,154
+9198328,3596894,242
+13916160,3597136,199
+9471019,3597335,123
+9854,3597458,118
+2905468,3597576,254
+16039130,3597830,288
+2325,3598118,128
+5822915,3598246,193
+2913184,3598439,141
+4472327,3598580,131
+8685030,3598711,243
+3965813,3598954,149
+2728,3599103,135
+10690,3599238,141
+1604619,3599379,135
+13925173,3599514,133
+2168,3599647,162
+7140223,3599809,189
+1312520,3599998,60
+7907307,3600058,174
+4742454,3600232,121
+2146375,3600353,119
+3435334,3600472,178
+8151114,3600650,105
+1598578,3600755,189
+8705150,3600944,189
+2416326,3601133,189
+6048,3601322,127
+1064202,3601449,222
+9709456,3601671,172
+10753937,3601843,242
+3463863,3602085,178
+1088624,3602263,141
+15223894,3602404,178
+10754312,3602582,199
+3715024,3602781,60
+8442678,3602841,107
+6563166,3602948,173
+9475082,3603121,166
+4239478,3603287,167
+13909305,3603454,193
+5285,3603647,158
+12629463,3603805,234
+13938033,3604039,141
+7351069,3604180,150
+15762881,3604330,217
+6305806,3604547,158
+16540345,3604705,149
+711,3604854,153
+7741,3605007,167
+2662787,3605174,144
+5037437,3605318,146
+4780155,3605464,144
+12106843,3605608,175
+1085114,3605783,124
+4989324,3605907,195
+2903677,3606102,237
+10810469,3606339,214
+5017978,3606553,154
+16026859,3606707,189
+7617125,3606896,142
+9564,3607038,156
+6836068,3607194,117
+13398253,3607311,141
+9469488,3607452,107
+8710974,3607559,130
+41173,3607689,146
+1620774,3607835,226
+1620229,3608061,202
+15528190,3608263,178
+9741324,3608441,139
+7385879,3608580,141
+11534919,3608721,201
+12380054,3608922,158
+9736143,3609080,139
+11072989,3609219,139
+4510637,3609358,257
+10257013,3609615,238
+6081482,3609853,214
+2681230,3610067,172
+3471591,3610239,141
+11571326,3610380,141
+2913120,3610521,207
+5278965,3610728,192
+1856670,3610920,161
+14993938,3611081,178
+13934085,3611259,178
+5791734,3611437,178
+4240142,3611615,214
+315006,3611829,185
+12622544,3612014,123
+9744415,3612137,123
+10013773,3612260,217
+12589859,3612477,237
+12109642,3612714,213
+14208570,3612927,219
+1059947,3613146,218
+7636420,3613364,185
+9762518,3613549,123
+16264572,3613672,123
+13679332,3613795,212
+4772701,3614007,60
+8453104,3614067,220
+12587819,3614287,204
+832676,3614491,286
+9462587,3614777,161
+16558774,3614938,161
+13119047,3615099,229
+12591696,3615328,146
+10532169,3615474,158
+8026,3615632,146
+9985410,3615778,144
+2380735,3615922,181
+275333,3616103,254
+8709592,3616357,234
+11058332,3616591,222
+11046978,3616813,253
+1621650,3617066,155
+9487690,3617221,197
+12350870,3617418,274
+1848538,3617692,171
+2924591,3617863,145
+7101501,3618008,154
+7873319,3618162,161
+14481238,3618323,161
+6857853,3618484,187
+1592077,3618671,135
+13898307,3618806,185
+4761272,3618991,126
+12089382,3619117,156
+14470056,3619273,151
+12613752,3619424,259
+14989690,3619683,117
+3463873,3619800,237
+7364044,3620037,158
+13669114,3620195,199
+15227601,3620394,199
+11019262,3620593,151
+14703964,3620744,116
+6852398,3620860,208
+14698213,3621068,224
+1857947,3621292,196
+13942046,3621488,174
+12360552,3621662,166
+13423777,3621828,158
+571999,3621986,184
+1105916,3622170,122
+8683325,3622292,214
+12910054,3622506,147
+13408395,3622653,157
+3204054,3622810,136
+10265893,3622946,245
+14697837,3623191,192
+2636070,3623383,165
+9239712,3623548,243
+1852029,3623791,213
+8415539,3624004,196
+12330695,3624200,141
+12344993,3624341,128
+9719628,3624469,127
+9967752,3624596,142
+1605902,3624738,123
+6327370,3624861,123
+7648647,3624984,123
+16561880,3625107,123
+3959340,3625230,154
+2366330,3625384,123
+9240151,3625507,123
+12625408,3625630,123
+1632297,3625753,146
+14729862,3625899,195
+7603621,3626094,252
+2649549,3626346,227
+5509169,3626573,124
+4498534,3626697,141
+14159127,3626838,252
+1622719,3627090,159
+15211706,3627249,130
+15773716,3627379,206
+1608096,3627585,282
+797318,3627867,199
+16540137,3628066,199
+4216418,3628265,214
+14998381,3628479,242
+41169,3628721,145
+6348,3628866,119
+6183,3628985,177
+36868,3629162,145
+1676,3629307,115
+155788,3629422,115
+53464,3629537,117
+1610623,3629654,185
+10761507,3629839,234
+11839823,3630073,142
+8403700,3630215,199
+4759800,3630414,199
+16277052,3630613,250
+2637430,3630863,145
+14432633,3631008,141
+5821806,3631149,189
+807729,3631338,144
+14454920,3631482,196
+5538093,3631678,247
+825922,3631925,226
+2057,3632151,117
+9191924,3632268,142
+7360264,3632410,258
+8926657,3632668,149
+3162785,3632817,154
+9911,3632971,175
+2674891,3633146,204
+4219626,3633350,192
+4984775,3633542,191
+8431510,3633733,135
+13377817,3633868,161
+3154691,3634029,167
+10286813,3634196,154
+7808,3634350,122
+4753438,3634472,134
+3961279,3634606,170
+915,3634776,123
+195,3634899,141
+3164935,3635040,193
+3431098,3635233,172
+5255080,3635405,141
+9448402,3635546,196
+578973,3635742,178
+12616537,3635920,154
+15500245,3636074,147
+1348655,3636221,156
+16560397,3636377,261
+2160508,3636638,197
+7916,3636835,203
+15758876,3637038,220
+1198,3637258,151
+17693,3637409,141
+10540597,3637550,170
+3440653,3637720,124
+11815894,3637844,154
+14192938,3637998,187
+3949182,3638185,154
+2979,3638339,139
+3210,3638478,151
+2374274,3638629,140
+8915207,3638769,167
+5809294,3638936,165
+3200601,3639101,163
+7350997,3639264,175
+8951653,3639439,123
+3698312,3639562,178
+12092804,3639740,117
+4255453,3639857,196
+11540614,3640053,119
+11302173,3640172,196
+2662039,3640368,196
+5413,3640564,164
+7856,3640728,141
+6560871,3640869,198
+6292874,3641067,177
+12329723,3641244,117
+32950,3641361,207
+545070,3641568,140
+10003460,3641708,127
+52287,3641835,161
+7649566,3641996,238
+10492338,3642234,154
+9180615,3642388,196
+6355613,3642584,196
+14457108,3642780,196
+4997075,3642976,130
+11555685,3643106,185
+3180609,3643291,207
+4517839,3643498,161
+3163542,3643659,196
+12645606,3643855,196
+7662464,3644051,161
+843996,3644212,161
+14182595,3644373,161
+12882905,3644534,161
+11021241,3644695,161
+11337107,3644856,224
+6838061,3645080,226
+47298,3645306,143
+16039808,3645449,196
+3727,3645645,159
+10544663,3645804,144
+7340469,3645948,141
+8009,3646089,130
+8967762,3646219,165
+16552186,3646384,147
+13677076,3646531,130
+12854358,3646661,140
+11843206,3646801,139
+5041659,3646940,167
+8138429,3647107,139
+7122709,3647246,131
+14999856,3647377,172
+794936,3647549,128
+14966873,3647677,164
+14686493,3647841,196
+6869434,3648037,254
+1841856,3648291,123
+3176642,3648414,204
+4214965,3648618,260
+3937787,3648878,196
+13407050,3649074,141
+53184,3649215,192
+14430989,3649407,203
+6850933,3649610,160
+4255822,3649770,214
+8690,3649984,187
+5572,3650171,162
+4582,3650333,148
+2421032,3650481,113
+14694463,3650594,178
+13922854,3650772,178
+4227869,3650950,123
+14472098,3651073,123
+6036953,3651196,123
+8390024,3651319,198
+15732253,3651517,175
+8957447,3651692,123
+6881015,3651815,123
+11285998,3651938,226
+8917398,3652164,196
+14946030,3652360,196
+2677143,3652556,168
+3153818,3652724,154
+797780,3652878,196
+13943198,3653074,135
+7367002,3653209,141
+49015,3653350,141
+13661972,3653491,193
+3192788,3653684,208
+11829695,3653892,181
+9726640,3654073,158
+4724986,3654231,162
+5798506,3654393,213
+10500344,3654606,125
+6846756,3654731,133
+2686336,3654864,154
+831101,3655018,130
+3163409,3655148,130
+15211180,3655278,169
+1880,3655447,143
+15793352,3655590,139
+16310037,3655729,181
+7605,3655910,137
+11544192,3656047,141
+13931416,3656188,131
+6455,3656319,131
+16546818,3656450,182
+11034890,3656632,122
+6330333,3656754,144
+293232,3656898,196
+10508259,3657094,196
+1880132,3657290,164
+11278280,3657454,142
+16024652,3657596,130
+11858664,3657726,139
+3954511,3657865,192
+13933812,3658057,140
+9180741,3658197,189
+6854753,3658386,147
+6330387,3658533,237
+5270347,3658770,171
+11803696,3658941,178
+7363244,3659119,161
+2921833,3659280,139
+10500590,3659419,178
+14994265,3659597,255
+11855405,3659852,170
+8680544,3660022,178
+5014223,3660200,152
+2643815,3660352,152
+7345823,3660504,148
+6876995,3660652,123
+13642528,3660775,123
+2908662,3660898,123
+13935421,3661021,123
+15758959,3661144,123
+4233389,3661267,123
+7097715,3661390,123
+1876152,3661513,174
+14189670,3661687,143
+1174,3661830,150
+57387,3661980,149
+6033035,3662129,150
+7628791,3662279,144
+14954530,3662423,232
+282391,3662655,166
+6048287,3662821,248
+14978868,3663069,152
+6838991,3663221,161
+829607,3663382,161
+11560751,3663543,147
+1101166,3663690,164
+14181237,3663854,219
+14195815,3664073,193
+6561951,3664266,114
+10763857,3664380,127
+7349765,3664507,157
+37105,3664664,154
+8673921,3664818,118
+13402586,3664936,182
+32876,3665118,179
+29283,3665297,164
+1845213,3665461,250
+12110059,3665711,214
+8439282,3665925,169
+6617226,3666094,185
+6871892,3666279,182
+11817555,3666461,136
+4550,3666597,131
+7480,3666728,131
+20499,3666859,160
+13164420,3667019,130
+2362732,3667149,138
+4740444,3667287,192
+1634532,3667479,229
+5802586,3667708,117
+10259566,3667825,175
+14438178,3668000,170
+16280801,3668170,151
+1864488,3668321,132
+14213124,3668453,130
+2948523,3668583,271
+3191992,3668854,151
+3673677,3669005,141
+3699690,3669146,154
+5001826,3669300,188
+8403958,3669488,196
+3205919,3669684,243
+5544524,3669927,240
+15474059,3670167,141
+15495319,3670308,139
+5773816,3670447,139
+13664196,3670586,291
+1341939,3670877,192
+839414,3671069,286
+1574655,3671355,200
+12897666,3671555,237
+3210132,3671792,265
+9120,3672057,171
+15992485,3672228,239
+10794286,3672467,214
+3974529,3672681,197
+3467537,3672878,197
+6605731,3673075,166
+15530684,3673241,170
+571938,3673411,139
+2670908,3673550,174
+11594977,3673724,60
+6350730,3673784,142
+2632070,3673926,149
+7372217,3674075,141
+573100,3674216,169
+2395104,3674385,248
+9252,3674633,152
+5294496,3674785,111
+7635951,3674896,144
+57590,3675040,157
+13381088,3675197,128
+48993,3675325,175
+7890903,3675500,123
+12108049,3675623,123
+1066676,3675746,150
+10281791,3675896,123
+3697436,3676019,260
+14439811,3676279,213
+4680,3676492,118
+24648,3676610,116
+8178010,3676726,118
+13632513,3676844,193
+7612503,3677037,141
+5804099,3677178,178
+11838338,3677356,202
+10263616,3677558,248
+10749878,3677806,161
+4213130,3677967,129
+3710354,3678096,166
+9179011,3678262,154
+14444779,3678416,156
+15218205,3678572,139
+555016,3678711,161
+8943000,3678872,161
+12588877,3679033,161
+2159006,3679194,139
+13147970,3679333,147
+7377395,3679480,161
+524393,3679641,150
+8849,3679791,141
+1113270,3679932,212
+317098,3680144,221
+5285946,3680365,215
+6555113,3680580,236
+10514585,3680816,287
+4773589,3681103,139
+809026,3681242,158
+12062932,3681400,128
+12354141,3681528,158
+13657709,3681686,253
+529711,3681939,188
+16053723,3682127,219
+16048644,3682346,115
+13378103,3682461,154
+3724832,3682615,186
+7665946,3682801,141
+10761457,3682942,130
+1597476,3683072,139
+12336517,3683211,196
+2118906,3683407,196
+3684235,3683603,196
+7625803,3683799,123
+5277,3683922,143
+11069476,3684065,190
+1067363,3684255,154
+9229454,3684409,214
+6564746,3684623,201
+12119566,3684824,178
+15519903,3685002,219
+7921923,3685221,141
+1625,3685362,143
+15002640,3685505,134
+9874,3685639,171
+9224481,3685810,188
+15467585,3685998,238
+11320949,3686236,182
+49295,3686418,168
+11547915,3686586,182
+2664108,3686768,146
+11058727,3686914,123
+12625214,3687037,123
+4476525,3687160,206
+9482720,3687366,228
+7080202,3687594,125
+7397885,3687719,142
+7661071,3687861,253
+6823,3688114,142
+832601,3688256,176
+8393896,3688432,266
+4234189,3688698,189
+11975,3688887,196
+4755183,3689083,196
+5535125,3689279,252
+12874068,3689531,252
+5792099,3689783,176
+15482365,3689959,238
+9752617,3690197,213
+3179604,3690410,213
+6030137,3690623,196
+16263193,3690819,174
+5605,3690993,162
+5302641,3691155,122
+3209087,3691277,215
+14183523,3691492,139
+540915,3691631,230
+9763762,3691861,220
+7833,3692081,177
+5813811,3692258,135
+6050177,3692393,161
+6327816,3692554,161
+5520695,3692715,135
+2942668,3692850,135
+8831,3692985,135
+7639322,3693120,135
+49245,3693255,151
+5817731,3693406,214
+1581132,3693620,130
+1626661,3693750,199
+1618992,3693949,132
+3191140,3694081,175
+16288316,3694256,154
+10749008,3694410,167
+16538141,3694577,208
+9704570,3694785,197
+3676129,3694982,165
+9971878,3695147,221
+9715650,3695368,158
+6823407,3695526,230
+11796502,3695756,153
+11280446,3695909,218
+11542313,3696127,149
+8916752,3696276,215
+1335599,3696491,122
+12445,3696613,164
+9183498,3696777,264
+4987034,3697041,213
+13388659,3697254,185
+5596,3697439,137
+6269,3697576,181
+16003257,3697757,139
+6640,3697896,177
+13163302,3698073,116
+10751531,3698189,123
+11292206,3698312,268
+5017868,3698580,182
+10778758,3698762,122
+263126,3698884,156
+6036079,3699040,208
+3951824,3699248,141
+15994499,3699389,139
+10024919,3699528,139
+11845622,3699667,161
+2898664,3699828,170
+8961400,3699998,231
+5817803,3700229,161
+2124775,3700390,252
+1584308,3700642,149
+5556703,3700791,226
+7665180,3701017,156
+12124083,3701173,158
+15475579,3701331,178
+10537376,3701509,178
+9973178,3701687,161
+8700143,3701848,175
+41870,3702023,141
+14734686,3702164,182
+10502304,3702346,122
+3371,3702468,134
+16486,3702602,190
+4761422,3702792,178
+12356328,3702970,173
+16047628,3703143,169
+3953282,3703312,139
+584962,3703451,154
+15269352,3703605,181
+2672191,3703786,139
+8965189,3703925,212
+6293559,3704137,254
+15480383,3704391,150
+5768395,3704541,212
+6346723,3704753,154
+1610711,3704907,130
+11057262,3705037,189
+13406440,3705226,254
+8146813,3705480,129
+10267757,3705609,161
+584256,3705770,238
+53397,3706008,158
+8410,3706166,158
+7100790,3706324,258
+8158091,3706582,150
+8694212,3706732,196
+10487919,3706928,196
+3460608,3707124,194
+13660034,3707318,196
+10548345,3707514,196
+8669029,3707710,196
+12910367,3707906,196
+10536101,3708102,155
+12072805,3708257,213
+3431355,3708470,229
+12848075,3708699,219
+8695788,3708918,159
+6080233,3709077,183
+10018282,3709260,230
+7492,3709490,115
+11051416,3709605,172
+14729425,3709777,237
+8606,3710014,183
+11318653,3710197,174
+13918621,3710371,123
+13650315,3710494,123
+534478,3710617,142
+12637120,3710759,161
+9735105,3710920,161
+1332878,3711081,161
+1359201,3711242,123
+5562465,3711365,248
+5257853,3711613,209
+16041174,3711822,207
+6830057,3712029,141
+2924925,3712170,139
+14168596,3712309,230
+1086795,3712539,210
+14168666,3712749,254
+10279486,3713003,139
+2637673,3713142,183
+11464,3713325,141
+12583565,3713466,214
+15245292,3713680,208
+8398473,3713888,189
+16296709,3714077,178
+8147017,3714255,123
+14974443,3714378,254
+12892621,3714632,141
+13918718,3714773,214
+2903380,3714987,167
+3446386,3715154,252
+6599795,3715406,219
+7623098,3715625,219
+7124135,3715844,127
+7865080,3715971,219
+9098,3716190,140
+4225,3716330,122
+4256645,3716452,154
+8943731,3716606,139
+16283016,3716745,196
+16010367,3716941,196
+2662987,3717137,137
+524327,3717274,141
+16295365,3717415,141
+8149532,3717556,129
+11596268,3717685,185
+5516119,3717870,120
+5250605,3717990,168
+14966097,3718158,145
+15466990,3718303,213
+6310337,3718516,122
+7348356,3718638,174
+10249808,3718812,224
+10527547,3719036,196
+8152994,3719232,139
+57434,3719371,168
+4760448,3719539,232
+9725229,3719771,212
+1882199,3719983,191
+6825783,3720174,175
+15756850,3720349,159
+5555221,3720508,204
+3995746,3720712,139
+2627245,3720851,139
+24787,3720990,113
+8687047,3721103,134
+6546,3721237,130
+286027,3721367,135
+7909208,3721502,125
+9457754,3721627,129
+9212753,3721756,133
+14170364,3721889,135
+3438807,3722024,232
+6081696,3722256,154
+6828542,3722410,138
+5767395,3722548,174
+2886633,3722722,141
+12857368,3722863,170
+13696920,3723033,196
+11593197,3723229,196
+12879593,3723425,196
+2788,3723621,157
+3427133,3723778,213
+16530665,3723991,211
+10750197,3724202,178
+45201,3724380,137
+11322978,3724517,158
+8940356,3724675,168
+10770447,3724843,154
+13170483,3724997,139
+14722816,3725136,139
+5783630,3725275,123
+13682163,3725398,123
+12361711,3725521,123
+2140983,3725644,123
+6353989,3725767,123
+4782460,3725890,199
+4241724,3726089,158
+12632000,3726247,196
+10279371,3726443,162
+9759097,3726605,174
+10501487,3726779,141
+10543279,3726920,141
+1602866,3727061,248
+5027868,3727309,144
+12360,3727453,157
+4510276,3727610,160
+10521848,3727770,196
+8190300,3727966,140
+1053489,3728106,136
+10806961,3728242,220
+12622852,3728462,238
+11327063,3728700,234
+30342,3728934,141
+9187238,3729075,130
+9181485,3729205,154
+44256,3729359,139
+30002,3729498,113
+6583266,3729611,157
+8963622,3729768,132
+13656204,3729900,178
+11281215,3730078,209
+8127433,3730287,254
+12118327,3730541,126
+14966098,3730667,122
+9207,3730789,60
+3965098,3730849,182
+11835025,3731031,139
+13115736,3731170,139
+2367687,3731309,178
+13945008,3731487,190
+4483767,3731677,139
+7347431,3731816,139
+10234480,3731955,193
+7355669,3732148,214
+14982674,3732362,132
+295342,3732494,136
+10228651,3732630,187
+10019958,3732817,159
+1352986,3732976,196
+292099,3733172,196
+3993484,3733368,218
+16529195,3733586,245
+10803620,3733831,142
+4738430,3733973,117
+13953291,3734090,139
+13414618,3734229,174
+8178719,3734403,245
+1634962,3734648,176
+9234971,3734824,156
+14691571,3734980,140
+5288803,3735120,181
+2887229,3735301,221
+5824876,3735522,268
+10255779,3735790,196
+10798671,3735986,196
+13434135,3736182,172
+14458843,3736354,149
+10018,3736503,143
+5485,3736646,148
+55183,3736794,141
+2931386,3736935,161
+4248494,3737096,161
+2940309,3737257,151
+8972415,3737408,123
+10286222,3737531,123
+6092774,3737654,123
+12080044,3737777,123
+2112686,3737900,123
+10501091,3738023,123
+4993653,3738146,123
+4749909,3738269,134
+7854,3738403,181
+5254003,3738584,230
+309814,3738814,197
+1077795,3739011,245
+14706797,3739256,131
+1597895,3739387,126
+10280049,3739513,158
+11859998,3739671,125
+13647299,3739796,158
+15466978,3739954,203
+11855746,3740157,129
+4458936,3740286,219
+3675857,3740505,161
+13637482,3740666,161
+13928592,3740827,161
+5542590,3740988,161
+2121031,3741149,197
+1099276,3741346,140
+274704,3741486,153
+9738921,3741639,143
+11316014,3741782,197
+6294275,3741979,214
+10529563,3742193,189
+14172898,3742382,143
+13152798,3742525,245
+1656,3742770,162
+14690413,3742932,206
+8932559,3743138,143
+5245273,3743281,165
+14946840,3743446,215
+6532,3743661,152
+5672,3743813,129
+7351842,3743942,178
+13166454,3744120,162
+632,3744282,173
+9113,3744455,179
+6089,3744634,178
+9465531,3744812,193
+1635434,3745005,193
+4984686,3745198,193
+7922688,3745391,193
+8495,3745584,131
+3693049,3745715,193
+15488505,3745908,193
+12874526,3746101,177
+6031963,3746278,183
+8186323,3746461,193
+1851012,3746654,193
+12088895,3746847,193
+6354068,3747040,193
+8410866,3747233,193
+8190036,3747426,199
+7064,3747625,162
+6794,3747787,167
+3955255,3747954,161
+16031572,3748115,161
+3457964,3748276,161
+4519001,3748437,161
+9821,3748598,161
+13433320,3748759,161
+14178287,3748920,161
+1630914,3749081,161
+9982641,3749242,161
+14958818,3749403,160
+1063769,3749563,160
+14192872,3749723,160
+12870378,3749883,160
+1373226,3750043,161
+526530,3750204,161
+13434428,3750365,161
+2669237,3750526,160
+1582694,3750686,160
+3200713,3750846,160
+13371307,3751006,160
+9575,3751166,161
+12366323,3751327,161
+1860280,3751488,161
+11811368,3751649,160
+7907443,3751809,160
+7235,3751969,161
+9174,3752130,161
+14946845,3752291,160
+4511457,3752451,192
+16552212,3752643,165
+4746683,3752808,169
+10768,3752977,141
+41609,3753118,141
+4516317,3753259,177
+3934,3753436,108
+4904,3753544,148
+12107651,3753692,139
+9199874,3753831,231
+5541024,3754062,174
+8157672,3754236,140
+10760465,3754376,129
+32883,3754505,139
+8430039,3754644,208
+15474546,3754852,186
+9178486,3755038,196
+8699474,3755234,196
+8691637,3755430,196
+10799776,3755626,196
+8708340,3755822,154
+14168162,3755976,123
+13690189,3756099,139
+10536290,3756238,139
+8689368,3756377,139
+9945,3756516,139
+15224971,3756655,185
+16253998,3756840,185
+53303,3757025,139
+8708184,3757164,139
+7370288,3757303,139
+310265,3757442,154
+14991085,3757596,164
+5831556,3757760,139
+40974,3757899,118
+49175,3758017,128
+6074470,3758145,139
+12356259,3758284,178
+11058471,3758462,158
+3430240,3758620,158
+12637073,3758778,154
+13933404,3758932,205
+15264529,3759137,130
+4505571,3759267,256
+3960810,3759523,191
+8801,3759714,137
+6536,3759851,123
+1629270,3759974,267
+5874,3760241,162
+3409743,3760403,169
+11839876,3760572,146
+11580047,3760718,178
+4461633,3760896,155
+13143427,3761051,196
+57361,3761247,144
+9557,3761391,160
+5806191,3761551,136
+13115326,3761687,196
+2112946,3761883,196
+4773177,3762079,196
+8090,3762275,140
+2574,3762415,151
+5728,3762566,132
+7806,3762698,132
+4965,3762830,132
+1080,3762962,132
+3776,3763094,132
+14176184,3763226,155
+2795,3763381,169
+2897713,3763550,253
+6352476,3763803,248
+6588671,3764051,190
+8546,3764241,132
+190163,3764373,157
+5817,3764530,155
+12847178,3764685,114
+2049,3764799,150
+1906,3764949,196
+14692357,3765145,196
+3948623,3765341,202
+828418,3765543,140
+10548196,3765683,140
+8707068,3765823,114
+8191036,3765937,152
+9969167,3766089,227
+4753610,3766316,271
+3692048,3766587,139
+42818,3766726,141
+43632,3766867,189
+16291271,3767056,189
+8706353,3767245,214
+4462,3767459,167
+5507413,3767626,178
+7797,3767804,189
+7266,3767993,189
+5264679,3768182,189
+8964560,3768371,189
+12599798,3768560,162
+9190115,3768722,189
+9479274,3768911,162
+1370056,3769073,214
+15519085,3769287,143
+1586077,3769430,141
+1335554,3769571,169
+5515116,3769740,195
+10265513,3769935,291
+8177417,3770226,223
+10501739,3770449,154
+9962200,3770603,154
+6617985,3770757,154
+532975,3770911,161
+3413087,3771072,161
+2893407,3771233,154
+13632810,3771387,158
+14962842,3771545,137
+7350528,3771682,246
+15510176,3771928,168
+57565,3772096,166
+5295733,3772262,195
+1115,3772457,151
+1978,3772608,130
+9478672,3772738,169
+7080836,3772907,222
+5527,3773129,159
+9111,3773288,149
+6349740,3773437,189
+9498706,3773626,190
+5689,3773816,153
+3113,3773969,130
+1385,3774099,130
+2830,3774229,143
+9240048,3774372,132
+12893004,3774504,190
+10014547,3774694,208
+13934920,3774902,196
+13657546,3775098,196
+4746028,3775294,208
+7087545,3775502,208
+2893869,3775710,208
+4723699,3775918,208
+16543,3776126,144
+31,3776270,143
+40978,3776413,143
+9235398,3776556,196
+11569408,3776752,196
+7916392,3776948,188
+3468555,3777136,196
+15785713,3777332,175
+16256833,3777507,219
+3970830,3777726,175
+3150922,3777901,193
+4983742,3778094,125
+796022,3778219,195
+14210108,3778414,135
+13910373,3778549,246
+14942875,3778795,139
+14424773,3778934,196
+16015019,3779130,130
+11074743,3779260,166
+49152,3779426,129
+8671617,3779555,160
+11584135,3779715,165
+13382976,3779880,165
+9176319,3780045,165
+16553187,3780210,165
+12094738,3780375,123
+9498472,3780498,187
+13113021,3780685,189
+60373,3780874,141
+12881671,3781015,326
+14448692,3781341,118
+13421697,3781459,191
+7116066,3781650,110
+11818681,3781760,240
+10280223,3782000,277
+3958806,3782277,129
+15208906,3782406,214
+7350411,3782620,161
+3443323,3782781,161
+13653883,3782942,139
+7864478,3783081,161
+11322170,3783242,161
+5566977,3783403,161
+12886886,3783564,178
+6321084,3783742,178
+8140104,3783920,161
+1618281,3784081,124
+4473936,3784205,129
+5305818,3784334,141
+1053202,3784475,180
+13130614,3784655,189
+7929802,3784844,253
+288101,3785097,136
+11058000,3785233,146
+573473,3785379,196
+6293520,3785575,196
+4735834,3785771,196
+9211634,3785967,123
+9482477,3786090,123
+15744703,3786213,151
+3969756,3786364,159
+1048829,3786523,151
+12876941,3786674,154
+7625887,3786828,172
+9214438,3787000,172
+4497279,3787172,165
+8684313,3787337,212
+11015513,3787549,149
+7387887,3787698,215
+5794481,3787913,215
+36870,3788128,147
+6900,3788275,124
+316367,3788399,123
+4752114,3788522,152
+7911499,3788674,245
+8171714,3788919,139
+6035,3789058,137
+856,3789195,163
+12896985,3789358,207
+5793466,3789565,207
+14731165,3789772,144
+4983610,3789916,172
+14953730,3790088,172
+834897,3790260,172
+4194528,3790432,175
+16563356,3790607,125
+1351375,3790732,117
+15206745,3790849,186
+14193667,3791035,158
+14683866,3791193,141
+13673649,3791334,147
+16031471,3791481,151
+12906625,3791632,196
+8393602,3791828,196
+9764386,3792024,196
+16043093,3792220,137
+5299535,3792357,159
+3416036,3792516,139
+9460,3792655,139
+6697,3792794,209
+37038,3793003,147
+6013,3793150,154
+41029,3793304,166
+9080,3793470,127
+5294449,3793597,127
+15745147,3793724,199
+9734238,3793923,255
+13116897,3794178,266
+9719945,3794444,164
+273122,3794608,141
+14726901,3794749,154
+37114,3794903,140
+57557,3795043,140
+4149,3795183,179
+2790,3795362,191
+7612394,3795553,185
+6592872,3795738,128
+16540,3795866,109
+11541458,3795975,270
+5523612,3796245,203
+14983654,3796448,196
+8650797,3796644,146
+4227670,3796790,160
+6080471,3796950,203
+9988925,3797153,139
+14681883,3797292,158
+1878976,3797450,208
+1850078,3797658,175
+9056,3797833,166
+8715996,3797999,206
+6325044,3798205,196
+14974566,3798401,196
+9755610,3798597,196
+5560804,3798793,142
+16016080,3798935,131
+10018512,3799066,252
+5278053,3799318,260
+23457,3799578,244
+5822074,3799822,146
+9963309,3799968,130
+15779711,3800098,130
+2754,3800228,212
+1104451,3800440,122
+12060075,3800562,178
+7902850,3800740,178
+13920231,3800918,213
+14954278,3801131,213
+311737,3801344,213
+12893908,3801557,122
+13637570,3801679,167
+3447153,3801846,166
+10244856,3802012,196
+15471579,3802208,137
+6091398,3802345,154
+15269234,3802499,221
+10009374,3802720,229
+11296574,3802949,221
+5533010,3803170,197
+311555,3803367,144
+2624552,3803511,226
+10796801,3803737,139
+2132791,3803876,212
+573047,3804088,136
+5283495,3804224,161
+11043221,3804385,161
+8957394,3804546,161
+52476,3804707,141
+6597,3804848,173
+4885,3805021,173
+1844047,3805194,161
+10765521,3805355,221
+27901,3805576,204
+5528230,3805780,170
+16521745,3805950,197
+6743,3806147,150
+10536329,3806297,139
+7710,3806436,147
+9024,3806583,148
+11832089,3806731,123
+3735038,3806854,154
+2886091,3807008,105
+12381277,3807113,123
+2662443,3807236,123
+11027585,3807359,129
+8930550,3807488,129
+16010519,3807617,209
+3717355,3807826,154
+10000337,3807980,158
+12071489,3808138,218
+24796,3808356,178
+9466498,3808534,178
+7221,3808712,135
+7322,3808847,135
+7382,3808982,135
+7380,3809117,135
+7576,3809252,135
+7657,3809387,135
+7738,3809522,135
+9544,3809657,135
+8956,3809792,135
+8957,3809927,135
+8618,3810062,135
+7534,3810197,134
+9140,3810331,135
+4976,3810466,135
+10229876,3810601,136
+7087,3810737,135
+13160715,3810872,127
+6080208,3810999,212
+6810,3811211,212
+13397408,3811423,124
+5860,3811547,182
+3967344,3811729,126
+5954,3811855,160
+6553,3812015,182
+23097,3812197,229
+10521060,3812426,212
+7916163,3812638,154
+790887,3812792,141
+7662312,3812933,139
+16289413,3813072,182
+184092,3813254,172
+37109,3813426,124
+12543,3813550,152
+4086,3813702,148
+8448,3813850,182
+5305632,3814032,160
+6599440,3814192,160
+10808275,3814352,160
+13111411,3814512,207
+3422041,3814719,178
+16527168,3814897,136
+12345870,3815033,196
+7644456,3815229,196
+6092508,3815425,175
+9956,3815600,133
+279,3815733,123
+14687547,3815856,203
+7391087,3816059,123
+3676463,3816182,132
+12109454,3816314,160
+327217,3816474,160
+5029029,3816634,160
+14168527,3816794,160
+1606449,3816954,161
+10249648,3817115,161
+8672677,3817276,161
+11041793,3817437,161
+11587740,3817598,160
+5294309,3817758,160
+8404,3817918,153
+57402,3818071,161
+4327,3818232,125
+9736892,3818357,244
+7449,3818601,170
+4799,3818771,167
+5275229,3818938,169
+8146869,3819107,169
+8767,3819276,122
+4021,3819398,122
+2395,3819520,122
+6735,3819642,110
+7242,3819752,110
+5388,3819862,110
+9983,3819972,138
+10806456,3820110,138
+12391,3820248,190
+15993747,3820438,133
+1862053,3820571,133
+9759693,3820704,137
+2672270,3820841,122
+303441,3820963,122
+16282516,3821085,122
+2117247,3821207,122
+12599054,3821329,122
+9970,3821451,122
+5007,3821573,188
+8402803,3821761,122
+10759052,3821883,122
+13401399,3822005,139
+10779300,3822144,139
+5888,3822283,139
+5813,3822422,139
+5544,3822561,139
+5530,3822700,139
+4480,3822839,139
+2822,3822978,139
+53384,3823117,139
+4746,3823256,139
+9077,3823395,139
+9123,3823534,139
+6875,3823673,139
+8062,3823812,139
+4526,3823951,139
+9751737,3824090,139
+3949454,3824229,139
+9409,3824368,139
+9714,3824507,139
+9713,3824646,139
+5124,3824785,139
+6829,3824924,139
+9914,3825063,139
+8971,3825202,139
+7661510,3825341,139
+7186,3825480,139
+6042510,3825619,158
+2369,3825777,181
+2679623,3825958,192
+4484439,3826150,192
+10270477,3826342,192
+6857668,3826534,192
+7401889,3826726,192
+8650962,3826918,183
+3160358,3827101,183
+60205,3827284,183
+11817597,3827467,183
+55761,3827650,173
+11535764,3827823,180
+15468651,3828003,252
+9740706,3828255,147
+330,3828402,149
+7900,3828551,183
+7464,3828734,183
+6163,3828917,183
+4205473,3829100,183
+9976598,3829283,142
+4232536,3829425,143
+1583201,3829568,179
+7107033,3829747,175
+13690754,3829922,170
+7122424,3830092,170
+11017494,3830262,169
+3458002,3830431,226
+5568197,3830657,214
+13685778,3830871,136
+9912,3831007,155
+9980,3831162,166
+5551,3831328,162
+7663725,3831490,163
+4511794,3831653,163
+14727589,3831816,175
+7870593,3831991,164
+11552508,3832155,158
+14696758,3832313,164
+7330,3832477,136
+8755,3832613,136
+3160562,3832749,139
+6082,3832888,132
+6855774,3833020,161
+10227274,3833181,254
+11032640,3833435,208
+10539898,3833643,139
+8951538,3833782,182
+4211,3833964,143
+2134861,3834107,201
+36903,3834308,126
+12879112,3834434,139
+6817226,3834573,139
+2389763,3834712,139
+7660811,3834851,139
+12059397,3834990,139
+41161,3835129,146
+1316983,3835275,115
+14718870,3835390,198
+1851428,3835588,117
+1637243,3835705,117
+16298326,3835822,117
+1317539,3835939,200
+3409915,3836139,127
+10789314,3836266,127
+1627,3836393,117
+8661803,3836510,127
+15748514,3836637,127
+14736213,3836764,115
+3871,3836879,117
+2406141,3836996,117
+7661282,3837113,117
+3466967,3837230,117
+7881,3837347,127
+8560,3837474,127
+8603,3837601,127
+12102767,3837728,127
+9218434,3837855,139
+12351287,3837994,139
+1323206,3838133,190
+14220435,3838323,139
+13938258,3838462,117
+2627118,3838579,124
+16259223,3838703,124
+9748816,3838827,126
+6092833,3838953,130
+8914763,3839083,189
+3442,3839272,126
+4744,3839398,126
+30878,3839524,177
+15253121,3839701,177
+6821264,3839878,195
+16051000,3840073,159
+7103,3840232,151
+9577,3840383,148
+1318842,3840531,154
+8420229,3840685,154
+13376480,3840839,154
+15994385,3840993,154
+1111681,3841147,197
+8572,3841344,126
+8115,3841470,126
+8821,3841596,163
+22482,3841759,141
+3958550,3841900,130
+53437,3842030,169
+7994,3842199,193
+13148208,3842392,144
+7914981,3842536,144
+851255,3842680,137
+2892427,3842817,118
+815004,3842935,169
+6116,3843104,144
+320593,3843248,144
+5264995,3843392,144
+8925972,3843536,144
+6585300,3843680,144
+14193967,3843824,144
+12124158,3843968,144
+2941970,3844112,177
+4505948,3844289,144
+8869,3844433,144
+14697435,3844577,255
+3985243,3844832,161
+2360821,3844993,214
+3945814,3845207,152
+3969126,3845359,139
+3464,3845498,158
+4501,3845656,150
+4934,3845806,153
+7922613,3845959,137
+7908544,3846096,137
+6862233,3846233,137
+1884638,3846370,137
+12100486,3846507,176
+1867493,3846683,176
+1883577,3846859,157
+5167,3847016,134
+2669592,3847150,183
+9743326,3847333,160
+10280881,3847493,238
+11325317,3847731,206
+3699166,3847937,123
+7373291,3848060,123
+29581,3848183,233
+3455605,3848416,161
+8132813,3848577,144
+57596,3848721,184
+6559472,3848905,215
+15991556,3849120,131
+5529609,3849251,139
+10778419,3849390,136
+8420031,3849526,156
+7927938,3849682,189
+12594298,3849871,191
+1887129,3850062,172
+10759088,3850234,252
+1608517,3850486,141
+6318404,3850627,123
+11585178,3850750,137
+2911221,3850887,137
+12857232,3851024,204
+16042532,3851228,157
+53431,3851385,146
+7638,3851531,139
+9453227,3851670,139
+3170339,3851809,139
+1354736,3851948,139
+5366,3852087,137
+9444042,3852224,139
+13123508,3852363,139
+14726922,3852502,139
+7630,3852641,139
+5096,3852780,139
+5070,3852919,139
+2913930,3853058,137
+13120654,3853195,139
+4994184,3853334,139
+1049269,3853473,139
+16422,3853612,161
+5039734,3853773,161
+3021,3853934,137
+3872,3854071,137
+4362,3854208,137
+12105758,3854345,139
+11824515,3854484,139
+3637,3854623,136
+2025,3854759,139
+5896,3854898,137
+6052,3855035,137
+12584386,3855172,139
+12481,3855311,132
+32928,3855443,132
+13927780,3855575,137
+2407941,3855712,139
+16531419,3855851,139
+3181977,3855990,137
+5775537,3856127,137
+9721765,3856264,137
+3763,3856401,130
+524297,3856531,146
+9489846,3856677,193
+4213007,3856870,193
+9820,3857063,193
+8809,3857256,193
+14186888,3857449,193
+7645070,3857642,178
+2349,3857820,137
+4469138,3857957,137
+10539969,3858094,137
+3730087,3858231,137
+11277869,3858368,137
+8438126,3858505,137
+11842863,3858642,137
+13663784,3858779,137
+13680540,3858916,137
+8151443,3859053,138
+9496516,3859191,142
+12380922,3859333,137
+7620256,3859470,137
+2901245,3859607,137
+283605,3859744,163
+15487708,3859907,180
+9745100,3860087,160
+283379,3860247,123
+8962645,3860370,130
+13400235,3860500,130
+1865785,3860630,233
+16570163,3860863,231
+6064538,3861094,231
+11017050,3861325,250
+2907064,3861575,250
+584564,3861825,172
+14681541,3861997,203
+3703621,3862200,267
+15501455,3862467,235
+6579891,3862702,235
+2634437,3862937,171
+15790902,3863108,229
+12338841,3863337,229
+16024525,3863566,231
+8487,3863797,198
+6054847,3863995,207
+1322279,3864202,193
+8971179,3864395,196
+12846376,3864591,196
+3989437,3864787,196
+5283623,3864983,196
+8417658,3865179,196
+8680,3865375,184
+3693,3865559,184
+9445638,3865743,121
+13641608,3865864,193
+9456869,3866057,193
+8162,3866250,193
+5839,3866443,193
+2097839,3866636,177
+10024247,3866813,159
+6048937,3866972,236
+16041748,3867208,236
+2649812,3867444,186
+7696,3867630,199
+13924438,3867829,122
+14172844,3867951,218
+5519839,3868169,198
+2637028,3868367,236
+2946245,3868603,122
+3947123,3868725,122
+16548761,3868847,122
+5799782,3868969,196
+6596177,3869165,196
+549729,3869361,213
+10490512,3869574,122
+3717948,3869696,122
+16282530,3869818,122
+13433172,3869940,122
+9188605,3870062,196
+11335667,3870258,219
+13932299,3870477,219
+9223870,3870696,219
+1373786,3870915,219
+40648,3871134,219
+794031,3871353,219
+530854,3871572,191
+3995656,3871763,198
+4743798,3871961,198
+11801875,3872159,198
+11292305,3872357,198
+2634066,3872555,198
+3440819,3872753,219
+16026418,3872972,219
+36897,3873191,141
+37041,3873332,141
+6838,3873473,139
+4817,3873612,134
+4663,3873746,134
+10544888,3873880,130
+7405430,3874010,130
+13646194,3874140,130
+6041918,3874270,128
+16037982,3874398,128
+6867211,3874526,128
+7637034,3874654,191
+5026156,3874845,191
+310640,3875036,172
+13956371,3875208,128
+5272100,3875336,128
+37081,3875464,143
+37010,3875607,143
+4143,3875750,143
+4109,3875893,143
+4103,3876036,143
+4116,3876179,143
+37055,3876322,141
+20689,3876463,143
+1894087,3876606,142
+13423929,3876748,142
+4980866,3876890,142
+8164851,3877032,142
+3464189,3877174,142
+8936082,3877316,142
+16395,3877458,147
+24688,3877605,147
+5244420,3877752,142
+57374,3877894,147
+4399,3878041,146
+7164,3878187,140
+10507599,3878327,142
+2116766,3878469,142
+8697858,3878611,142
+11577975,3878753,142
+12371091,3878895,142
+10775594,3879037,142
+13673894,3879179,142
+3956419,3879321,142
+6616733,3879463,142
+905,3879605,139
+13660892,3879744,142
+2672590,3879886,142
+15994651,3880028,142
+16302728,3880170,142
+1862266,3880312,142
+7909,3880454,133
+4736135,3880587,131
+3721308,3880718,131
+4741945,3880849,165
+12365509,3881014,141
+1097544,3881155,141
+5269422,3881296,142
+15769187,3881438,142
+7117193,3881580,142
+1632040,3881722,142
+4631,3881864,133
+4880,3881997,133
+289949,3882130,142
+8696417,3882272,142
+14960839,3882414,131
+4127,3882545,147
+5546612,3882692,142
+6355778,3882834,123
+6601192,3882957,123
+7503,3883080,123
+8978,3883203,123
+8445981,3883326,142
+14197342,3883468,123
+2599,3883591,123
+1586257,3883714,123
+816922,3883837,123
+2648762,3883960,123
+5026201,3884083,123
+12623682,3884206,123
+13640667,3884329,123
+7397090,3884452,123
+15780769,3884575,123
+1581106,3884698,123
+4209916,3884821,123
+4743356,3884944,123
+3428809,3885067,123
+4222095,3885190,123
+5789130,3885313,123
+14429025,3885436,123
+4237017,3885559,123
+6355661,3885682,123
+16097,3885805,123
+16524607,3885928,123
+325604,3886051,123
+3457113,3886174,123
+15782313,3886297,123
+7362177,3886420,123
+1314975,3886543,123
+265422,3886666,123
+5565096,3886789,123
+2679116,3886912,123
+14992957,3887035,123
+5563450,3887158,123
+318294,3887281,123
+11287563,3887404,123
+7344420,3887527,123
+271973,3887650,123
+15480198,3887773,123
+7929236,3887896,123
+2932232,3888019,123
+15237166,3888142,123
+24945,3888265,123
+9206930,3888388,123
+11547797,3888511,123
+16005047,3888634,123
+11304766,3888757,123
+2624348,3888880,123
+11337196,3889003,123
+14457756,3889126,123
+5534287,3889249,123
+14208924,3889372,123
+8154616,3889495,123
+320822,3889618,123
+11058127,3889741,123
+7094280,3889864,123
+16556934,3889987,285
+4207386,3890272,123
+13420384,3890395,123
+12340420,3890518,123
+14432020,3890641,123
+2138852,3890764,123
+2682998,3890887,123
+1315671,3891010,160
+12104427,3891170,195
+16568131,3891365,256
+14174446,3891621,198
+11857668,3891819,170
+10804937,3891989,279
+13426883,3892268,165
+6580852,3892433,135
+5017292,3892568,139
+14955976,3892707,196
+808121,3892903,114
+8654861,3893017,193
+13635437,3893210,158
+9473400,3893368,189
+8155510,3893557,289
+8126865,3893846,123
+2890696,3893969,228
+11028298,3894197,193
+12845129,3894390,120
+8443397,3894510,123
+10020936,3894633,112
+4210855,3894745,183
+12601865,3894928,206
+10493451,3895134,180
+6875371,3895314,177
+11027917,3895491,198
+13681043,3895689,126
+11297890,3895815,178
+12592546,3895993,151
+4723582,3896144,161
+3209074,3896305,193
+14433526,3896498,129
+564043,3896627,154
+4486102,3896781,116
+1100827,3896897,175
+15206196,3897072,188
+10762289,3897260,136
+3671366,3897396,198
+13927172,3897594,248
+14428970,3897842,123
+10259923,3897965,178
+14948908,3898143,145
+15252945,3898288,196
+15996213,3898484,249
+3672747,3898733,116
+3681768,3898849,161
+12618135,3899010,161
+11015638,3899171,272
+12614865,3899443,168
+9492723,3899611,178
+13911528,3899789,224
+3417606,3900013,144
+3716901,3900157,258
+11332736,3900415,139
+5274525,3900554,189
+7107104,3900743,189
+3187267,3900932,236
+3670421,3901168,175
+2387606,3901343,117
+4495194,3901460,248
+5260791,3901708,189
+11298671,3901897,141
+6557158,3902038,136
+14701885,3902174,148
+16528223,3902322,114
+8705224,3902436,120
+15475173,3902556,114
+311870,3902670,156
+14686954,3902826,153
+2669017,3902979,150
+16041491,3903129,196
+4480908,3903325,178
+12093825,3903503,214
+15738404,3903717,174
+16315492,3903891,157
+6050184,3904048,193
+15466803,3904241,165
+2934088,3904406,151
+1367465,3904557,167
+1593138,3904724,193
+14459820,3904917,183
+845605,3905100,149
+5828866,3905249,161
+11841067,3905410,125
+9740094,3905535,126
+3181011,3905661,227
+6075285,3905888,196
+9465004,3906084,136
+3988010,3906220,178
+8662567,3906398,161
+1879505,3906559,175
+535728,3906734,151
+10490827,3906885,199
+13632658,3907084,199
+1323729,3907283,161
+1578697,3907444,175
+64653,3907619,208
+8707865,3907827,203
+14423515,3908030,245
+14736144,3908275,161
+5529970,3908436,141
+15491296,3908577,124
+11824437,3908701,290
+3973914,3908991,169
+3207989,3909160,196
+15266531,3909356,171
+6576632,3909527,143
+7095320,3909670,116
+11064329,3909786,159
+7095704,3909945,146
+6857592,3910091,132
+3410466,3910223,186
+15230660,3910409,121
+13948841,3910530,193
+3423640,3910723,183
+16008979,3910906,268
+6070648,3911174,159
+10272480,3911333,196
+803134,3911529,149
+13659978,3911678,195
+299758,3911873,114
+8418393,3911987,137
+6297968,3912124,262
+10750186,3912386,178
+12089465,3912564,166
+13665236,3912730,152
+578379,3912882,225
+7906129,3913107,213
+14969178,3913320,147
+8157779,3913467,161
+1079411,3913628,213
+4779532,3913841,189
+15481992,3914030,161
+7384404,3914191,157
+9437403,3914348,161
+11857721,3914509,161
+15739427,3914670,162
+5785348,3914832,267
+7643235,3915099,196
+15524605,3915295,248
+1347361,3915543,139
+10250331,3915682,141
+8147786,3915823,110
+12349028,3915933,183
+12366600,3916116,223
+7089778,3916339,165
+6081791,3916504,162
+9487199,3916666,220
+13109481,3916886,151
+1587757,3917037,161
+15496378,3917198,210
+16528008,3917408,188
+14185621,3917596,178
+6044469,3917774,128
+15007449,3917902,193
+6092739,3918095,204
+10281520,3918299,182
+6046183,3918481,186
+3427492,3918667,185
+11071544,3918852,316
+11323199,3919168,153
+4470127,3919321,120
+7660151,3919441,131
+1345854,3919572,169
+12342521,3919741,186
+7928852,3919927,158
+3672484,3920085,140
+12380007,3920225,214
+16560044,3920439,143
+12340731,3920582,208
+2896762,3920790,193
+8707511,3920983,144
+585643,3921127,179
+7370495,3921306,130
+1324742,3921436,238
+6879016,3921674,189
+3681354,3921863,167
+3175248,3922030,123
+14478342,3922153,205
+13417939,3922358,166
+9234316,3922524,163
+5525830,3922687,151
+8676310,3922838,149
+15471538,3922987,110
+1068551,3923097,225
+301980,3923322,254
+8660624,3923576,235
+8395111,3923811,230
+2947057,3924041,219
+3939859,3924260,231
+528734,3924491,156
+557500,3924647,193
+12621945,3924840,138
+12079061,3924978,149
+14174855,3925127,149
+15744297,3925276,125
+8941708,3925401,238
+5248181,3925639,237
+13385501,3925876,153
+14473807,3926029,157
+1053208,3926186,141
+3418352,3926327,179
+13373603,3926506,205
+6073085,3926711,126
+1371620,3926837,143
+13636162,3926980,141
+6305430,3927121,148
+5570511,3927269,143
+16052845,3927412,252
+4214507,3927664,179
+12867326,3927843,165
+11319119,3928008,130
+12644091,3928138,206
+3162661,3928344,133
+16571315,3928477,178
+13432120,3928655,141
+12107129,3928796,139
+7664659,3928935,137
+10487335,3929072,150
+3158837,3929222,119
+4486252,3929341,183
+5021439,3929524,187
+12360901,3929711,273
+6076619,3929984,181
+3469514,3930165,292
+7369229,3930457,299
+3984730,3930756,167
+16558612,3930923,182
+9754126,3931105,228
+7638861,3931333,161
+5269383,3931494,129
+9224093,3931623,225
+10268055,3931848,193
+8923472,3932041,201
+8185124,3932242,126
+16044641,3932368,193
+4773973,3932561,136
+587560,3932697,181
+2125468,3932878,161
+7089964,3933039,161
+11536851,3933200,121
+6341067,3933321,205
+12330480,3933526,183
+12598598,3933709,193
+6613701,3933902,166
+3209175,3934068,178
+1581694,3934246,161
+3196846,3934407,161
+4510944,3934568,183
+16569817,3934751,186
+7658040,3934937,169
+15004870,3935106,122
+13410533,3935228,151
+6324523,3935379,150
+1842429,3935529,275
+9481755,3935804,252
+6349607,3936056,252
+4772238,3936308,174
+16279041,3936482,209
+1332805,3936691,146
+7365304,3936837,189
+11315481,3937026,132
+11543978,3937158,60
+13939774,3937218,160
+9748500,3937378,205
+10288113,3937583,144
+1058750,3937727,142
+2131884,3937869,136
+7377795,3938005,217
+8442931,3938222,141
+11590144,3938363,156
+1878785,3938519,118
+14202582,3938637,143
+7089158,3938780,181
+12882234,3938961,217
+6849898,3939178,159
+9720255,3939337,132
+15734176,3939469,155
+12865055,3939624,107
+11568798,3939731,145
+13653921,3939876,177
+11842882,3940053,154
+5557742,3940207,191
+8972536,3940398,193
+9476196,3940591,150
+14476664,3940741,285
+14181781,3941026,148
+16037167,3941174,137
+12646301,3941311,130
+12896537,3941441,151
+3731608,3941592,158
+6613138,3941750,146
+14212447,3941896,132
+14180756,3942028,188
+15268960,3942216,187
+5807356,3942403,140
+7351327,3942543,114
+13161513,3942657,139
+16276549,3942796,137
+11329641,3942933,136
+3192258,3943069,252
+14712659,3943321,128
+4783850,3943449,115
+15264362,3943564,129
+318346,3943693,158
+9494455,3943851,176
+546560,3944027,252
+16525218,3944279,164
+16563105,3944443,213
+15764008,3944656,191
+2669401,3944847,155
+2369090,3945002,154
+3464756,3945156,178
+16520711,3945334,172
+11272906,3945506,137
+7630653,3945643,128
+4984302,3945771,172
+13656909,3945943,171
+35651,3946114,112
+9191922,3946226,160
+14694115,3946386,193
+14419247,3946579,146
+13679873,3946725,142
+9232025,3946867,138
+5038523,3947005,208
+2402429,3947213,241
+15495643,3947454,236
+10750411,3947690,198
+9197213,3947888,147
+4241073,3948035,179
+8715934,3948214,146
+16534300,3948360,165
+4206695,3948525,148
+15229315,3948673,178
+3721641,3948851,185
+5249733,3949036,125
+11573407,3949161,146
+12644804,3949307,178
+6292295,3949485,174
+15782823,3949659,152
+3712316,3949811,146
+6094847,3949957,261
+545344,3950218,196
+12108194,3950414,184
+8450654,3950598,103
+6842670,3950701,142
+13920359,3950843,165
+2889902,3951008,169
+16260325,3951177,152
+8950118,3951329,159
+1061752,3951488,167
+1371557,3951655,178
+5292038,3951833,138
+314141,3951971,134
+10807715,3952105,162
+10544617,3952267,130
+10232170,3952397,252
+16278186,3952649,123
+1080303,3952772,187
+11821741,3952959,153
+3431488,3953112,144
+6822207,3953256,140
+11826446,3953396,167
+9703486,3953563,167
+8173363,3953730,164
+3166712,3953894,144
+15266342,3954038,180
+4517424,3954218,173
+16522774,3954391,138
+3960419,3954529,128
+10749342,3954657,131
+10534736,3954788,156
+15258848,3954944,190
+16515486,3955134,108
+6562180,3955242,171
+2385135,3955413,192
+14165772,3955605,202
+11848937,3955807,118
+12899925,3955925,177
+5815801,3956102,136
+12633735,3956238,134
+12882816,3956372,196
+32250,3956568,157
+2912597,3956725,119
+2103310,3956844,251
+8434201,3957095,167
+14724786,3957262,156
+16271999,3957418,137
+7644341,3957555,221
+9477955,3957776,154
+2659503,3957930,133
+11292726,3958063,126
+826131,3958189,227
+9748254,3958416,235
+15225198,3958651,136
+11280907,3958787,167
+12093352,3958954,158
+14721432,3959112,162
+8926540,3959274,112
+3956996,3959386,137
+13388513,3959523,173
+9194329,3959696,169
+6042407,3959865,146
+5273233,3960011,141
+2684210,3960152,137
+9715874,3960289,205
+1869485,3960494,157
+2677054,3960651,136
+6556490,3960787,163
+3686963,3960950,153
+3967664,3961103,137
+12596404,3961240,148
+13428908,3961388,182
+7401846,3961570,134
+12076998,3961704,150
+12111251,3961854,146
+2677633,3962000,201
+3671732,3962201,124
+12067866,3962325,155
+10531072,3962480,221
+2104579,3962701,127
+14706611,3962828,210
+1854199,3963038,131
+14972779,3963169,121
+3207965,3963290,178
+10546304,3963468,178
+837663,3963646,155
+11074416,3963801,125
+14975411,3963926,202
+12610669,3964128,143
+15237336,3964271,163
+3161773,3964434,147
+16266717,3964581,230
+14200908,3964811,195
+13370548,3965006,131
+6034913,3965137,165
+15225245,3965302,185
+14440230,3965487,127
+16308959,3965614,127
+3190395,3965741,181
+6876258,3965922,163
+1607767,3966085,232
+12109909,3966317,205
+7876667,3966522,198
+13376250,3966720,178
+7113519,3966898,178
+9198320,3967076,162
+11567244,3967238,147
+14212329,3967385,209
+14472490,3967594,158
+14182086,3967752,212
+13635236,3967964,153
+7883528,3968117,169
+8709337,3968286,203
+4242547,3968489,145
+4196288,3968634,149
+10802101,3968783,147
+13908581,3968930,166
+16030124,3969096,170
+13652121,3969266,155
+10788571,3969421,132
+1865418,3969553,171
+8948068,3969724,152
+8181828,3969876,123
+4481436,3969999,154
+7373326,3970153,161
+790789,3970314,181
+6038212,3970495,178
+16318120,3970673,157
+1573083,3970830,132
+7905542,3970962,252
+7102758,3971214,142
+8939612,3971356,290
+1058865,3971646,137
+15477833,3971783,142
+14166294,3971925,163
+2945539,3972088,163
+11861644,3972251,161
+4253488,3972412,154
+6860948,3972566,152
+10515452,3972718,193
+4520009,3972911,152
+13372908,3973063,134
+1849279,3973197,137
+5286847,3973334,134
+815660,3973468,252
+10282549,3973720,163
+6333516,3973883,167
+1596136,3974050,154
+12877260,3974204,150
+14724845,3974354,119
+14979815,3974473,175
+13370492,3974648,148
+6574941,3974796,166
+3960823,3974962,148
+2915162,3975110,120
+13942573,3975230,172
+14735778,3975402,118
+16516679,3975520,148
+7131462,3975668,124
+5562418,3975792,137
+5530090,3975929,107
+13667198,3976036,165
+284783,3976201,202
+16555950,3976403,142
+6823563,3976545,147
+13652648,3976692,160
+13384289,3976852,193
+16308159,3977045,124
+4767277,3977169,127
+15737641,3977296,137
+15758254,3977433,145
+4765918,3977578,172
+1108569,3977750,134
+792863,3977884,165
+1074639,3978049,112
+6835368,3978161,221
+9969806,3978382,152
+7359204,3978534,134
+539320,3978668,172
+10542487,3978840,188
+15501813,3979028,276
+11835458,3979304,178
+7361746,3979482,168
+6576644,3979650,210
+11278082,3979860,140
+9981139,3980000,152
+548974,3980152,167
+3954645,3980319,114
+16271511,3980433,147
+16255952,3980580,241
+15244031,3980821,241
+822492,3981062,117
+6342056,3981179,219
+2675268,3981398,188
+11853627,3981586,131
+8166043,3981717,163
+8709908,3981880,222
+12069367,3982102,127
+14985213,3982229,148
+2941608,3982377,148
+46445,3982525,183
+2897239,3982708,145
+12059669,3982853,139
+13898607,3982992,142
+13164967,3983134,168
+5024563,3983302,131
+16009002,3983433,230
+14418574,3983663,178
+11027945,3983841,208
+4739681,3984049,119
+6578723,3984168,178
+9979708,3984346,244
+5538221,3984590,168
+5546063,3984758,153
+1366917,3984911,127
+12114673,3985038,220
+13917296,3985258,138
+15484732,3985396,122
+3981612,3985518,128
+9739261,3985646,174
+10488511,3985820,176
+9227752,3985996,163
+8172082,3986159,222
+58982,3986381,188
+3456506,3986569,134
+15998502,3986703,165
+7349542,3986868,114
+1628489,3986982,138
+14158069,3987120,154
+836734,3987274,170
+5272141,3987444,172
+7879907,3987616,141
+12097712,3987757,121
+2386250,3987878,162
+527371,3988040,143
+14466960,3988183,251
+302854,3988434,194
+2660939,3988628,141
+10521621,3988769,135
+9490287,3988904,158
+13171494,3989062,134
+12081168,3989196,120
+15522128,3989316,111
+8127164,3989427,166
+12067856,3989593,167
+1072969,3989760,134
+1858656,3989894,203
+12106062,3990097,228
+11323032,3990325,171
+8140908,3990496,153
+2123697,3990649,127
+1612391,3990776,141
+556321,3990917,189
+16254236,3991106,172
+7918415,3991278,155
+10765931,3991433,173
+9445085,3991606,182
+3463092,3991788,152
+15994779,3991940,152
+6578175,3992092,127
+11303490,3992219,138
+7343040,3992357,162
+13374630,3992519,168
+1089449,3992687,155
+12624740,3992842,149
+1859583,3992991,315
+6309309,3993306,125
+2363492,3993431,205
+8186858,3993636,146
+10227116,3993782,148
+7386521,3993930,151
+15486029,3994081,140
+10801551,3994221,286
+5780539,3994507,166
+8951414,3994673,136
+6035255,3994809,132
+11274849,3994941,123
+1852396,3995064,159
+5558704,3995223,162
+7885410,3995385,263
+7629449,3995648,142
+7352139,3995790,139
+7607433,3995929,135
+2366227,3996064,228
+2097487,3996292,158
+15470294,3996450,165
+2361623,3996615,156
+10245322,3996771,275
+11810148,3997046,280
+48917,3997326,142
+3731101,3997468,125
+7913149,3997593,124
+13950807,3997717,152
+5261547,3997869,261
+11800214,3998130,134
+5278839,3998264,180
+4223050,3998444,205
+5529277,3998649,129
+16023349,3998778,141
+12370280,3998919,135
+14430364,3999054,140
+2883831,3999194,117
+2684422,3999311,130
+831322,3999441,188
+8187786,3999629,168
+2363685,3999797,156
+11809208,3999953,117
+13375611,4000070,150
+572937,4000220,143
+11804143,4000363,151
+8426387,4000514,129
+10487734,4000643,170
+840373,4000813,177
+4736753,4000990,106
+12068843,4001096,166
+8695583,4001262,176
+11557060,4001438,172
+7624600,4001610,157
+2627534,4001767,153
+3985011,4001920,141
+11582829,4002061,172
+6309109,4002233,148
+9481279,4002381,129
+11293166,4002510,184
+7905667,4002694,108
+11063525,4002802,137
+16292181,4002939,164
+5032271,4003103,114
+845267,4003217,129
+14951913,4003346,137
+1356232,4003483,142
+15220978,4003625,168
+5244221,4003793,129
+16288796,4003922,226
+1837906,4004148,134
+7634477,4004282,221
+8936519,4004503,133
+3981814,4004636,175
+9763560,4004811,275
+11829845,4005086,164
+8394423,4005250,159
+36314,4005409,160
+12883973,4005569,153
+9499841,4005722,123
+1579327,4005845,128
+9716804,4005973,130
+5006553,4006103,218
+9699657,4006321,130
+1880212,4006451,156
+10223889,4006607,201
+4197991,4006808,123
+12640119,4006931,149
+3167725,4007080,150
+15791957,4007230,141
+1880643,4007371,110
+3718963,4007481,176
+11823081,4007657,196
+1599313,4007853,172
+6577854,4008025,129
+13419786,4008154,217
+1880447,4008371,145
+14953558,4008516,152
+4779392,4008668,146
+13109016,4008814,117
+5774737,4008931,194
+14204748,4009125,175
+3979686,4009300,162
+9178275,4009462,116
+9756504,4009578,156
+4773196,4009734,138
+9231954,4009872,155
+533794,4010027,117
+4992925,4010144,138
+14968762,4010282,170
+12367954,4010452,131
+12882688,4010583,114
+7120514,4010697,188
+2676086,4010885,149
+7394998,4011034,154
+12624094,4011188,130
+4242571,4011318,140
+10264884,4011458,122
+5307440,4011580,133
+12097140,4011713,139
+4776367,4011852,113
+1883048,4011965,165
+27552,4012130,196
+11049158,4012326,159
+11804957,4012485,252
+9452718,4012737,241
+7368780,4012978,145
+14194528,4013123,135
+16022220,4013258,137
+9459330,4013395,164
+15784572,4013559,136
+11284893,4013695,262
+2101370,4013957,230
+7921110,4014187,109
+12620082,4014296,125
+9443422,4014421,161
+16318044,4014582,141
+7118061,4014723,141
+2393844,4014864,142
+12854138,4015006,137
+16049879,4015143,164
+12088356,4015307,152
+11817465,4015459,140
+3151501,4015599,131
+14987169,4015730,107
+11044845,4015837,137
+13947465,4015974,136
+8405628,4016110,174
+14736092,4016284,172
+15221686,4016456,162
+12098505,4016618,124
+4235207,4016742,158
+64600,4016900,130
+9975153,4017030,139
+5506214,4017169,167
+1600921,4017336,166
+10543617,4017502,223
+15785657,4017725,218
+8168989,4017943,125
+10286717,4018068,137
+16265051,4018205,143
+10012741,4018348,131
+9998464,4018479,200
+16266102,4018679,169
+5305882,4018848,243
+5513240,4019091,125
+5775343,4019216,121
+5815715,4019337,163
+16314970,4019500,121
+3178187,4019621,143
+6877477,4019764,145
+12351054,4019909,139
+13420759,4020048,143
+8704810,4020191,128
+4981385,4020319,171
+12641614,4020490,156
+16302081,4020646,137
+1604737,4020783,135
+11324558,4020918,138
+9213135,4021056,166
+7120768,4021222,132
+3168172,4021354,160
+8661840,4021514,135
+4782065,4021649,114
+9211510,4021763,125
+10490683,4021888,184
+10245905,4022072,291
+8975496,4022363,273
+4492818,4022636,140
+12106605,4022776,143
+1324859,4022919,153
+1611775,4023072,216
+5002629,4023288,139
+15526403,4023427,148
+3209709,4023575,146
+5779198,4023721,160
+13394107,4023881,141
+8183072,4024022,156
+15528502,4024178,150
+268470,4024328,60
+14984687,4024388,183
+3174834,4024571,238
+14470721,4024809,204
+16542769,4025013,142
+7363757,4025155,146
+3960645,4025301,135
+7352711,4025436,126
+3204315,4025562,141
+8970483,4025703,137
+8427291,4025840,180
+5797493,4026020,171
+807415,4026191,134
+851075,4026325,175
+32552,4026500,155
+8406833,4026655,146
+11574228,4026801,190
+15764478,4026991,161
+3942101,4027152,134
+15224326,4027286,217
+1917,4027503,141
+13425129,4027644,132
+3450633,4027776,124
+14731554,4027900,183
+9461645,4028083,120
+9972031,4028203,210
+11820196,4028413,251
+9473309,4028664,152
+4476766,4028816,182
+13676470,4028998,178
+10021989,4029176,121
+11323701,4029297,137
+36174,4029434,132
+10025179,4029566,183
+14946953,4029749,153
+5826568,4029902,154
+14419437,4030056,154
+5019887,4030210,103
+41438,4030313,234
+8416444,4030547,171
+9474144,4030718,168
+12353945,4030886,138
+14460889,4031024,154
+3735237,4031178,128
+12866982,4031306,142
+6059863,4031448,144
+13949080,4031592,166
+11840077,4031758,142
+12074318,4031900,263
+5277624,4032163,128
+12643044,4032291,124
+538789,4032415,172
+13377279,4032587,155
+1592980,4032742,152
+7092509,4032894,214
+8434474,4033108,158
+4216121,4033266,141
+14742033,4033407,126
+16279921,4033533,135
+4500007,4033668,176
+15268136,4033844,121
+1873245,4033965,163
+6354332,4034128,135
+11577130,4034263,150
+6553841,4034413,141
+12121296,4034554,199
+568485,4034753,145
+5795215,4034898,143
+1106887,4035041,148
+7628241,4035189,112
+264835,4035301,128
+12867072,4035429,151
+12336659,4035580,159
+11016984,4035739,131
+13673233,4035870,182
+269584,4036052,149
+8393792,4036201,172
+1575762,4036373,146
+14419905,4036519,223
+12624493,4036742,147
+48014,4036889,145
+14166654,4037034,132
+8396546,4037166,169
+5828302,4037335,147
+6586330,4037482,166
+11273747,4037648,163
+7632920,4037811,130
+14688010,4037941,162
+4470553,4038103,166
+8710809,4038269,160
+14683263,4038429,163
+14977749,4038592,143
+16576973,4038735,129
+4466107,4038864,163
+8182404,4039027,167
+12371482,4039194,206
+291004,4039400,134
+8969593,4039534,112
+6617479,4039646,124
+14179716,4039770,131
+13951788,4039901,134
+8153819,4040035,190
+9449095,4040225,122
+10757299,4040347,152
+9751980,4040499,121
+1330202,4040620,145
+3409924,4040765,160
+15752585,4040925,140
+11305174,4041065,127
+10287416,4041192,141
+9231141,4041333,135
+16528792,4041468,146
+9492780,4041614,135
+9997876,4041749,193
+12874238,4041942,141
+4203245,4042083,149
+9999433,4042232,215
+2924887,4042447,139
+9707603,4042586,132
+2655533,4042718,137
+12106344,4042855,260
+11580203,4043115,155
+5784292,4043270,152
+12089726,4043422,161
+13409792,4043583,163
+5810031,4043746,139
+1782,4043885,141
+7634358,4044026,184
+11560291,4044210,187
+4200663,4044397,138
+4992128,4044535,175
+13934189,4044710,255
+7089715,4044965,164
+4233339,4045129,160
+12335314,4045289,187
+2098664,4045476,132
+15729224,4045608,129
+11300687,4045737,120
+15214711,4045857,154
+15779980,4046011,138
+4208557,4046149,178
+2682200,4046327,125
+4746129,4046452,144
+6566921,4046596,129
+4244037,4046725,222
+13391277,4046947,112
+15234431,4047059,237
+15792051,4047296,110
+54157,4047406,172
+13123239,4047578,122
+6326588,4047700,163
+14183415,4047863,163
+7654668,4048026,171
+13422144,4048197,123
+12119673,4048320,148
+7657077,4048468,148
+11800284,4048616,162
+14741019,4048778,210
+7650824,4048988,139
+6317053,4049127,199
+14202561,4049326,171
+7644327,4049497,155
+7340632,4049652,142
+16012768,4049794,255
+2162161,4050049,144
+8689592,4050193,135
+10542565,4050328,155
+2124543,4050483,184
+11285707,4050667,220
+9472162,4050887,182
+4246842,4051069,127
+4730090,4051196,184
+13164,4051380,158
+2937306,4051538,140
+16279282,4051678,141
+11297059,4051819,137
+1051684,4051956,132
+5830335,4052088,130
+7924770,4052218,210
+792005,4052428,142
+16545254,4052570,155
+10528611,4052725,167
+15475560,4052892,143
+7639120,4053035,186
+3708306,4053221,190
+10756490,4053411,146
+16317231,4053557,153
+2936131,4053710,148
+6592861,4053858,125
+8187672,4053983,177
+16547047,4054160,123
+1332242,4054283,136
+8142493,4054419,123
+2377111,4054542,183
+7897487,4054725,166
+2639942,4054891,138
+3172683,4055029,116
+7103085,4055145,165
+2623117,4055310,116
+12586366,4055426,127
+8701865,4055553,151
+14184791,4055704,276
+6331044,4055980,149
+6557828,4056129,171
+3416329,4056300,138
+3936367,4056438,156
+843247,4056594,132
+15531646,4056726,156
+14986621,4056882,133
+15768763,4057015,179
+1101019,4057194,169
+3721146,4057363,147
+15490153,4057510,219
+7115455,4057729,201
+4499650,4057930,154
+8449651,4058084,131
+16572991,4058215,132
+5789453,4058347,149
+12878399,4058496,225
+15227739,4058721,164
+12364246,4058885,150
+7093916,4059035,163
+9229864,4059198,148
+2374688,4059346,150
+3946947,4059496,158
+3933611,4059654,148
+15745845,4059802,154
+10779108,4059956,127
+4725714,4060083,179
+13693147,4060262,115
+8131702,4060377,160
+9196573,4060537,125
+41690,4060662,126
+15557,4060788,189
+15759312,4060977,151
+5031426,4061128,133
+8417567,4061261,137
+8977685,4061398,147
+8932153,4061545,164
+14166217,4061709,176
+4506163,4061885,244
+3207121,4062129,234
+8137971,4062363,168
+530001,4062531,206
+11035615,4062737,160
+1588178,4062897,199
+14955923,4063096,207
+2898472,4063303,148
+11819105,4063451,126
+11573050,4063577,147
+2117227,4063724,130
+8451475,4063854,182
+14981104,4064036,187
+11798578,4064223,138
+15523389,4064361,140
+7143358,4064501,156
+3162484,4064657,136
+8434313,4064793,172
+15219351,4064965,144
+1070794,4065109,156
+4747218,4065265,141
+10500725,4065406,128
+2415533,4065534,158
+10284008,4065692,214
+265922,4065906,215
+13160913,4066121,201
+56133,4066322,127
+13933608,4066449,132
+7665446,4066581,131
+2650821,4066712,155
+14716908,4066867,144
+11332010,4067011,139
+535248,4067150,151
+8951841,4067301,143
+14739281,4067444,163
+15023,4067607,134
+6559373,4067741,141
+15004,4067882,141
+8154255,4068023,134
+10269190,4068157,129
+8973596,4068286,184
+10276226,4068470,218
+15753857,4068688,146
+12622994,4068834,138
+12597497,4068972,135
+16016201,4069107,141
+7663741,4069248,158
+16274143,4069406,123
+11062165,4069529,155
+16015351,4069684,141
+8141781,4069825,138
+6087203,4069963,146
+16282110,4070109,189
+2890116,4070298,141
+14205947,4070439,136
+5830267,4070575,234
+7139401,4070809,145
+6573940,4070954,144
+7896930,4071098,110
+4199831,4071208,141
+12909796,4071349,121
+15207187,4071470,148
+15494303,4071618,224
+4255564,4071842,196
+10014,4072038,152
+10013,4072190,178
+10016,4072368,147
+9968,4072515,167
+9962,4072682,236
+9992,4072918,114
+9986,4073032,142
+9988,4073174,151
+9978,4073325,144
+9977,4073469,130
+9981,4073599,145
+9975,4073744,168
+9974,4073912,164
+9949,4074076,186
+9950,4074262,142
+9946,4074404,197
+9947,4074601,156
+9941,4074757,199
+9934,4074956,141
+10001,4075097,119
+9862,4075216,161
+9860,4075377,148
+9856,4075525,125
+9919,4075650,220
+9908,4075870,140
+9930,4076010,141
+9929,4076151,153
+9872,4076304,131
+9871,4076435,123
+9849,4076558,172
+9900,4076730,194
+9894,4076924,116
+9884,4077040,139
+9876,4077179,153
+9846,4077332,132
+9757,4077464,167
+9751,4077631,126
+9747,4077757,151
+9784,4077908,207
+9786,4078115,153
+9743,4078268,138
+9740,4078406,120
+9771,4078526,181
+9760,4078707,137
+9729,4078844,123
+9781,4078967,131
+9815,4079098,144
+9810,4079242,141
+9830,4079383,158
+9717,4079541,168
+9707,4079709,178
+9710,4079887,131
+9646,4080018,156
+9647,4080174,138
+9640,4080312,214
+9689,4080526,160
+9686,4080686,130
+9681,4080816,193
+9677,4081009,123
+9663,4081132,151
+9657,4081283,134
+9654,4081417,129
+9637,4081546,140
+9636,4081686,192
+9665,4081878,181
+9718,4082059,147
+9594,4082206,258
+9590,4082464,131
+9588,4082595,179
+9561,4082774,159
+9556,4082933,144
+9536,4083077,163
+9523,4083240,140
+9520,4083380,149
+9516,4083529,158
+9612,4083687,206
+9562,4083893,150
+9607,4084043,126
+9587,4084169,211
+9583,4084380,123
+9519,4084503,130
+9482,4084633,157
+9477,4084790,158
+9481,4084948,155
+9434,4085103,162
+9432,4085265,162
+9421,4085427,138
+9427,4085565,120
+9422,4085685,138
+9423,4085823,155
+9414,4085978,147
+9469,4086125,156
+9507,4086281,131
+9501,4086412,129
+9487,4086541,155
+9461,4086696,143
+9319,4086839,158
+9325,4086997,159
+9328,4087156,141
+9322,4087297,170
+9362,4087467,181
+9355,4087648,143
+9348,4087791,157
+9344,4087948,143
+9338,4088091,183
+9334,4088274,125
+9396,4088399,142
+9393,4088541,138
+9372,4088679,236
+9368,4088915,141
+9298,4089056,160
+9299,4089216,121
+9292,4089337,159
+9288,4089496,153
+9291,4089649,129
+9256,4089778,124
+9239,4089902,157
+9238,4090059,136
+9258,4090195,156
+9250,4090351,178
+9243,4090529,157
+9310,4090686,157
+9293,4090843,177
+9282,4091020,154
+9216,4091174,135
+9211,4091309,145
+9225,4091454,137
+9222,4091591,156
+9276,4091747,136
+9171,4091883,202
+9162,4092085,140
+9163,4092225,225
+9133,4092450,141
+9131,4092591,141
+9124,4092732,162
+9180,4092894,148
+9169,4093042,118
+9214,4093160,132
+9204,4093292,122
+9168,4093414,133
+9159,4093547,127
+9155,4093674,142
+9136,4093816,178
+9185,4093994,157
+9086,4094151,121
+9084,4094272,111
+9082,4094383,116
+9069,4094499,136
+9067,4094635,132
+9057,4094767,143
+9004,4094910,121
+9003,4095031,114
+9014,4095145,134
+9016,4095279,133
+9019,4095412,149
+9002,4095561,181
+8999,4095742,169
+9000,4095911,195
+9074,4096106,218
+9036,4096324,135
+9027,4096459,104
+9055,4096563,169
+9093,4096732,123
+8920,4096855,243
+8924,4097098,161
+8921,4097259,169
+8915,4097428,128
+8916,4097556,144
+8958,4097700,154
+8960,4097854,168
+8947,4098022,155
+8950,4098177,172
+8973,4098349,135
+8963,4098484,164
+8941,4098648,148
+8929,4098796,132
+8928,4098928,175
+8927,4099103,134
+8986,4099237,140
+8892,4099377,136
+8874,4099513,163
+8905,4099676,146
+8844,4099822,157
+8843,4099979,179
+8845,4100158,147
+8780,4100305,163
+8778,4100468,131
+8779,4100599,179
+8790,4100778,141
+8786,4100919,152
+8781,4101071,165
+8863,4101236,139
+8857,4101375,137
+8813,4101512,228
+8814,4101740,221
+8797,4101961,203
+8827,4102164,136
+8841,4102300,145
+8829,4102445,124
+8872,4102569,112
+8739,4102681,153
+8730,4102834,136
+8728,4102970,144
+8764,4103114,154
+8679,4103268,167
+8668,4103435,143
+8689,4103578,131
+8675,4103709,128
+8732,4103837,60
+8738,4103897,158
+8696,4104055,134
+8691,4104189,114
+8753,4104303,162
+8723,4104465,158
+8705,4104623,144
+8571,4104767,116
+8566,4104883,141
+8561,4105024,182
+8595,4105206,121
+8594,4105327,259
+8615,4105586,179
+8604,4105765,148
+8602,4105913,172
+8664,4106085,141
+8663,4106226,141
+8665,4106367,137
+8666,4106504,164
+8629,4106668,122
+8637,4106790,163
+8644,4106953,139
+8585,4107092,134
+8482,4107226,146
+8485,4107372,149
+8486,4107521,235
+8467,4107756,150
+8466,4107906,153
+8462,4108059,137
+8545,4108196,119
+8543,4108315,141
+8501,4108456,127
+8504,4108583,119
+8519,4108702,163
+8521,4108865,186
+8534,4109051,141
+8529,4109192,181
+8556,4109373,117
+8476,4109490,141
+8472,4109631,137
+8125,4109768,154
+8121,4109922,127
+8119,4110049,203
+8116,4110252,138
+8118,4110390,182
+8136,4110572,179
+8133,4110751,163
+8128,4110914,155
+8124,4111069,128
+8185,4111197,176
+8173,4111373,137
+8165,4111510,138
+8180,4111648,156
+8031,4111804,133
+8023,4111937,162
+8025,4112099,137
+8014,4112236,131
+8106,4112367,130
+8059,4112497,146
+8061,4112643,146
+8077,4112789,183
+8111,4112972,130
+8052,4113102,136
+8053,4113238,130
+8079,4113368,206
+8068,4113574,155
+8046,4113729,172
+8038,4113901,123
+8096,4114024,130
+8094,4114154,141
+7910,4114295,222
+7927,4114517,141
+7947,4114658,205
+7948,4114863,197
+7944,4115060,124
+8003,4115184,168
+7956,4115352,137
+7921,4115489,119
+7924,4115608,188
+7925,4115796,158
+7950,4115954,141
+7976,4116095,137
+7966,4116232,165
+8010,4116397,132
+7850,4116529,151
+7836,4116680,148
+7831,4116828,228
+7819,4117056,176
+7867,4117232,163
+7861,4117395,182
+7859,4117577,134
+7813,4117711,144
+7896,4117855,143
+7894,4117998,133
+7878,4118131,145
+7876,4118276,129
+7873,4118405,144
+7862,4118549,146
+7852,4118695,145
+7799,4118840,113
+7803,4118953,135
+7790,4119088,190
+7789,4119278,141
+7732,4119419,139
+7725,4119558,118
+7745,4119676,197
+7676,4119873,166
+7765,4120039,144
+7766,4120183,158
+7743,4120341,175
+7767,4120516,145
+7760,4120661,143
+7697,4120804,154
+7666,4120958,133
+7663,4121091,124
+7665,4121215,145
+7661,4121360,136
+7619,4121496,128
+7617,4121624,133
+7602,4121757,190
+7597,4121947,233
+7595,4122180,140
+7580,4122320,155
+7584,4122475,208
+7640,4122683,156
+7624,4122839,187
+7628,4123026,155
+7570,4123181,161
+7562,4123342,141
+7552,4123483,189
+7555,4123672,143
+7540,4123815,249
+7499,4124064,137
+7501,4124201,172
+7454,4124373,164
+7453,4124537,149
+7438,4124686,176
+7434,4124862,146
+7527,4125008,116
+7548,4125124,156
+7533,4125280,167
+7541,4125447,140
+7507,4125587,186
+7508,4125773,172
+7519,4125945,152
+7512,4126097,126
+7559,4126223,170
+7471,4126393,152
+7397,4126545,164
+7389,4126709,161
+7362,4126870,147
+7357,4127017,153
+7352,4127170,135
+7340,4127305,156
+7333,4127461,139
+7325,4127600,134
+7423,4127734,140
+7388,4127874,167
+7377,4128041,152
+7405,4128193,140
+7354,4128333,139
+7344,4128472,141
+7244,4128613,150
+7237,4128763,172
+7228,4128935,142
+7255,4129077,141
+7261,4129218,157
+7262,4129375,139
+7253,4129514,186
+7259,4129700,185
+7236,4129885,159
+7298,4130044,162
+7300,4130206,160
+7289,4130366,174
+7268,4130540,138
+7217,4130678,220
+7307,4130898,147
+7277,4131045,186
+7318,4131231,166
+7209,4131397,197
+7204,4131594,167
+7200,4131761,130
+7196,4131891,170
+7130,4132061,130
+7121,4132191,143
+7168,4132334,133
+7165,4132467,150
+7126,4132617,136
+7119,4132753,144
+7115,4132897,156
+7157,4133053,193
+7142,4133246,111
+7138,4133357,137
+7136,4133494,163
+7220,4133657,177
+7222,4133834,130
+7189,4133964,141
+7175,4134105,152
+7075,4134257,143
+7071,4134400,153
+7066,4134553,159
+7101,4134712,156
+7102,4134868,125
+7091,4134993,126
+7095,4135119,174
+7065,4135293,133
+7055,4135426,141
+7052,4135567,156
+7057,4135723,122
+7042,4135845,180
+7049,4136025,158
+7051,4136183,145
+7084,4136328,192
+7018,4136520,165
+7015,4136685,146
+7035,4136831,139
+7029,4136970,132
+6951,4137102,123
+6939,4137225,143
+6943,4137368,191
+6999,4137559,204
+6997,4137763,164
+6995,4137927,141
+6985,4138068,157
+6926,4138225,177
+6916,4138402,159
+6918,4138561,165
+6961,4138726,160
+6953,4138886,127
+6955,4139013,141
+6952,4139154,145
+6979,4139299,214
+6972,4139513,174
+6973,4139687,138
+7014,4139825,176
+7008,4140001,128
+6917,4140129,119
+6911,4140248,141
+6912,4140389,147
+6990,4140536,136
+6934,4140672,129
+6886,4140801,215
+6873,4141016,212
+6856,4141228,206
+6827,4141434,142
+6828,4141576,122
+6831,4141698,163
+6832,4141861,174
+6817,4142035,141
+6854,4142176,144
+6898,4142320,154
+6786,4142474,211
+6780,4142685,161
+6778,4142846,182
+6776,4143028,135
+6774,4143163,184
+6768,4143347,143
+6753,4143490,143
+6754,4143633,160
+6757,4143793,127
+6740,4143920,159
+6722,4144079,207
+6736,4144286,186
+6739,4144472,122
+6732,4144594,153
+6682,4144747,192
+6674,4144939,118
+6781,4145057,183
+6752,4145240,198
+6742,4145438,175
+6643,4145613,127
+6639,4145740,263
+6647,4146003,150
+6638,4146153,188
+6591,4146341,181
+6582,4146522,147
+6635,4146669,137
+6631,4146806,141
+6633,4146947,181
+6618,4147128,233
+6676,4147361,181
+6672,4147542,175
+6668,4147717,163
+6620,4147880,141
+6608,4148021,120
+6614,4148141,177
+6615,4148318,154
+6658,4148472,150
+6648,4148622,161
+6663,4148783,132
+6664,4148915,115
+6660,4149030,163
+6601,4149193,141
+6581,4149334,133
+6584,4149467,132
+6493,4149599,234
+6483,4149833,172
+6485,4150005,141
+6489,4150146,157
+6477,4150303,176
+6478,4150479,217
+6572,4150696,169
+6576,4150865,164
+6549,4151029,192
+6554,4151221,124
+6548,4151345,158
+6524,4151503,160
+6560,4151663,157
+6545,4151820,142
+6540,4151962,117
+6498,4152079,130
+6511,4152209,144
+6365,4152353,150
+6367,4152503,143
+6369,4152646,162
+6362,4152808,177
+6357,4152985,127
+6375,4153112,161
+6372,4153273,158
+6373,4153431,118
+6410,4153549,130
+6435,4153679,152
+6428,4153831,134
+6440,4153965,170
+6421,4154135,154
+6427,4154289,143
+6409,4154432,129
+6451,4154561,141
+6404,4154702,175
+6452,4154877,193
+6413,4155070,132
+6273,4155202,178
+6262,4155380,139
+6266,4155519,121
+6252,4155640,136
+6259,4155776,141
+6239,4155917,145
+6356,4156062,172
+6311,4156234,153
+6306,4156387,141
+6300,4156528,139
+6298,4156667,156
+6244,4156823,152
+6246,4156975,133
+6240,4157108,192
+6295,4157300,179
+6302,4157479,135
+6313,4157614,171
+6312,4157785,161
+6338,4157946,136
+6206,4158082,125
+6210,4158207,135
+6208,4158342,139
+6212,4158481,180
+6177,4158661,140
+6179,4158801,152
+6165,4158953,153
+6231,4159106,129
+6227,4159235,137
+6233,4159372,164
+6223,4159536,161
+6150,4159697,158
+6168,4159855,141
+6170,4159996,167
+6166,4160163,136
+6187,4160299,109
+6185,4160408,133
+6200,4160541,215
+6128,4160756,224
+6129,4160980,161
+6143,4161141,135
+6134,4161276,138
+6085,4161414,121
+6078,4161535,147
+6080,4161682,151
+6074,4161833,136
+6100,4161969,167
+6016,4162136,165
+6053,4162301,180
+6056,4162481,138
+6057,4162619,129
+6063,4162748,112
+6058,4162860,152
+6062,4163012,142
+6069,4163154,175
+5996,4163329,143
+6000,4163472,171
+6027,4163643,179
+6111,4163822,141
+5958,4163963,142
+5965,4164105,164
+5956,4164269,126
+5961,4164395,174
+5955,4164569,113
+5928,4164682,140
+5922,4164822,166
+5949,4164988,122
+5952,4165110,186
+5938,4165296,165
+5997,4165461,148
+6003,4165609,188
+5946,4165797,139
+5935,4165936,147
+5923,4166083,157
+5919,4166240,128
+5971,4166368,167
+5975,4166535,153
+5819,4166688,202
+5812,4166890,60
+5799,4166950,121
+5904,4167071,153
+5823,4167224,125
+5815,4167349,145
+5857,4167494,138
+5858,4167632,161
+5907,4167793,148
+5837,4167941,145
+5871,4168086,139
+5885,4168225,151
+5752,4168376,229
+5748,4168605,141
+5744,4168746,148
+5769,4168894,177
+5770,4169071,126
+5766,4169197,134
+5773,4169331,154
+5774,4169485,153
+5711,4169638,188
+5758,4169826,137
+5755,4169963,127
+5753,4170090,153
+5795,4170243,184
+5792,4170427,134
+5725,4170561,140
+5723,4170701,135
+5735,4170836,154
+5706,4170990,180
+5701,4171170,149
+5695,4171319,169
+5693,4171488,214
+5677,4171702,155
+5671,4171857,171
+5690,4172028,161
+5688,4172189,154
+5683,4172343,143
+5612,4172486,139
+5615,4172625,159
+5604,4172784,146
+5666,4172930,146
+5651,4173076,170
+5647,4173246,138
+5636,4173384,117
+5627,4173501,184
+5630,4173685,141
+5645,4173826,155
+5577,4173981,131
+5562,4174112,123
+5563,4174235,149
+5567,4174384,134
+5506,4174518,146
+5499,4174664,172
+5496,4174836,165
+5550,4175001,141
+5564,4175142,116
+5565,4175258,162
+5557,4175420,134
+5581,4175554,178
+5593,4175732,132
+5597,4175864,166
+5532,4176030,169
+5525,4176199,167
+5511,4176366,165
+5402,4176531,162
+5396,4176693,195
+5398,4176888,177
+5445,4177065,167
+5443,4177232,163
+5441,4177395,170
+5481,4177565,128
+5476,4177693,185
+5475,4177878,141
+5473,4178019,143
+5489,4178162,133
+5477,4178295,224
+5432,4178519,125
+5422,4178644,140
+5464,4178784,142
+5407,4178926,201
+5410,4179127,133
+5455,4179260,160
+5377,4179420,118
+5283,4179538,121
+5271,4179659,213
+5273,4179872,131
+5266,4180003,169
+5268,4180172,111
+5359,4180283,153
+5308,4180436,188
+5305,4180624,155
+5309,4180779,136
+5303,4180915,136
+5322,4181051,158
+5320,4181209,151
+5317,4181360,162
+5338,4181522,176
+5333,4181698,255
+5331,4181953,117
+5336,4182070,122
+5358,4182192,177
+5301,4182369,141
+5276,4182510,125
+5212,4182635,142
+5210,4182777,144
+5211,4182921,136
+5193,4183057,204
+5190,4183261,153
+5184,4183414,137
+5166,4183551,138
+5168,4183689,149
+5170,4183838,155
+5253,4183993,126
+5251,4184119,128
+5233,4184247,193
+5226,4184440,141
+5196,4184581,156
+5187,4184737,157
+5216,4184894,154
+5109,4185048,138
+5105,4185186,164
+5095,4185350,125
+5098,4185475,120
+5089,4185595,117
+5091,4185712,156
+5092,4185868,158
+5057,4186026,147
+5056,4186173,173
+5151,4186346,217
+5149,4186563,135
+5138,4186698,136
+5137,4186834,179
+5125,4187013,160
+17665,4187173,136
+5123,4187309,122
+5121,4187431,167
+5081,4187598,172
+5068,4187770,149
+5012,4187919,186
+5001,4188105,180
+5004,4188285,165
+5025,4188450,151
+5020,4188601,163
+4949,4188764,169
+4951,4188933,179
+4960,4189112,141
+5006,4189253,141
+4982,4189394,142
+4957,4189536,165
+4946,4189701,127
+4972,4189828,118
+4964,4189946,169
+4971,4190115,129
+4992,4190244,141
+4997,4190385,172
+5043,4190557,201
+5047,4190758,130
+4872,4190888,140
+4871,4191028,155
+4860,4191183,154
+4862,4191337,262
+4844,4191599,140
+4843,4191739,135
+4931,4191874,207
+4926,4192081,127
+4933,4192208,149
+4935,4192357,147
+4910,4192504,146
+4921,4192650,152
+4905,4192802,149
+4907,4192951,144
+4875,4193095,130
+4877,4193225,134
+4855,4193359,217
+4891,4193576,174
+4834,4193750,182
+4831,4193932,150
+4820,4194082,157
+4825,4194239,141
+4802,4194380,176
+4798,4194556,159
+4833,4194715,146
+4805,4194861,192
+4781,4195053,134
+4768,4195187,168
+4742,4195355,143
+4707,4195498,165
+4720,4195663,138
+4718,4195801,180
+4719,4195981,183
+4700,4196164,161
+4703,4196325,134
+4653,4196459,146
+4724,4196605,126
+4691,4196731,119
+4684,4196850,146
+4693,4196996,156
+4676,4197152,141
+4652,4197293,146
+4651,4197439,130
+4658,4197569,155
+4647,4197724,164
+4634,4197888,168
+4635,4198056,138
+4575,4198194,137
+4567,4198331,140
+4612,4198471,144
+4618,4198615,168
+4616,4198783,158
+4609,4198941,141
+4590,4199082,125
+4608,4199207,141
+4581,4199348,164
+4574,4199512,129
+4552,4199641,149
+4536,4199790,179
+4532,4199969,161
+4472,4200130,147
+4458,4200277,124
+4499,4200401,141
+4492,4200542,183
+4494,4200725,144
+4486,4200869,149
+4483,4201018,133
+4477,4201151,141
+4479,4201292,211
+4509,4201503,172
+4508,4201675,127
+4506,4201802,128
+4545,4201930,156
+4530,4202086,167
+4527,4202253,142
+4446,4202395,167
+4476,4202562,113
+4409,4202675,181
+4414,4202856,142
+4408,4202998,136
+4406,4203134,164
+4402,4203298,151
+4427,4203449,158
+4423,4203607,167
+4426,4203774,176
+4418,4203950,143
+4384,4204093,141
+4376,4204234,155
+4359,4204389,137
+4360,4204526,161
+4364,4204687,181
+4429,4204868,171
+4400,4205039,189
+4393,4205228,147
+4439,4205375,162
+4057,4205537,161
+4048,4205698,114
+4042,4205812,142
+4076,4205954,128
+4077,4206082,163
+4069,4206245,161
+4014,4206406,136
+4017,4206542,134
+4007,4206676,158
+4080,4206834,130
+4355,4206964,148
+4061,4207112,126
+4035,4207238,162
+3976,4207400,128
+3966,4207528,178
+3971,4207706,170
+3972,4207876,148
+3932,4208024,166
+3922,4208190,172
+3916,4208362,136
+3987,4208498,123
+3988,4208621,124
+3948,4208745,140
+3983,4208885,141
+3965,4209026,129
+3958,4209155,153
+3998,4209308,157
+3961,4209465,175
+3863,4209640,142
+3870,4209782,234
+3861,4210016,122
+3897,4210138,129
+3902,4210267,132
+3903,4210399,144
+3893,4210543,141
+3894,4210684,161
+3880,4210845,146
+3875,4210991,141
+3874,4211132,125
+3876,4211257,141
+3836,4211398,144
+3838,4211542,156
+3884,4211698,126
+3883,4211824,171
+3826,4211995,145
+3853,4212140,184
+3848,4212324,123
+3844,4212447,129
+3906,4212576,119
+3749,4212695,128
+3744,4212823,169
+3812,4212992,191
+3806,4213183,139
+3740,4213322,151
+3738,4213473,191
+3728,4213664,150
+3722,4213814,171
+3768,4213985,143
+3774,4214128,169
+3771,4214297,139
+3790,4214436,139
+3796,4214575,145
+3798,4214720,141
+3800,4214861,171
+3793,4215032,152
+3760,4215184,139
+3715,4215323,141
+3713,4215464,153
+3720,4215617,134
+3718,4215751,146
+3689,4215897,206
+3681,4216103,150
+3684,4216253,122
+3657,4216375,142
+3650,4216517,152
+3645,4216669,121
+3641,4216790,141
+3636,4216931,134
+3690,4217065,129
+3674,4217194,144
+3677,4217338,157
+3666,4217495,135
+3710,4217630,107
+3703,4217737,127
+3661,4217864,130
+3660,4217994,125
+3629,4218119,205
+3632,4218324,148
+3625,4218472,150
+3553,4218622,151
+3536,4218773,155
+3539,4218928,157
+3544,4219085,125
+3507,4219210,183
+3502,4219393,195
+3506,4219588,126
+3597,4219714,150
+3574,4219864,158
+3583,4220022,169
+3527,4220191,157
+3522,4220348,60
+3519,4220408,174
+3609,4220582,136
+3610,4220718,140
+3590,4220858,133
+3420,4220991,154
+3424,4221145,142
+3431,4221287,124
+3423,4221411,136
+3484,4221547,137
+3480,4221684,201
+3468,4221885,169
+3476,4222054,155
+3498,4222209,157
+3494,4222366,171
+3469,4222537,150
+3460,4222687,147
+3443,4222834,154
+3433,4222988,131
+3490,4223119,151
+3432,4223270,141
+3428,4223411,156
+3444,4223567,163
+3453,4223730,126
+3412,4223856,129
+3404,4223985,150
+3343,4224135,121
+3346,4224256,155
+3380,4224411,198
+3378,4224609,168
+3318,4224777,136
+3314,4224913,148
+3374,4225061,186
+3368,4225247,141
+3405,4225388,124
+3411,4225512,178
+3324,4225690,146
+3384,4225836,129
+3349,4225965,126
+3233,4226091,144
+3238,4226235,138
+3265,4226373,136
+3211,4226509,135
+3216,4226644,130
+3212,4226774,146
+3266,4226920,176
+3220,4227096,177
+3227,4227273,155
+3297,4227428,127
+3292,4227555,166
+3269,4227721,178
+3294,4227899,169
+3263,4228068,162
+3149,4228230,197
+3140,4228427,166
+3131,4228593,157
+3185,4228750,133
+3186,4228883,169
+3192,4229052,176
+3161,4229228,147
+3164,4229375,124
+3157,4229499,158
+3154,4229657,136
+3188,4229793,146
+3175,4229939,147
+3118,4230086,231
+3116,4230317,129
+3112,4230446,131
+3133,4230577,127
+3119,4230704,172
+3121,4230876,141
+3155,4231017,60
+3144,4231077,150
+3171,4231227,175
+3003,4231402,146
+3004,4231548,155
+2993,4231703,180
+3007,4231883,141
+2989,4232024,139
+2976,4232163,161
+3095,4232324,147
+3089,4232471,152
+3092,4232623,163
+2997,4232786,153
+3001,4232939,128
+3105,4233067,219
+3099,4233286,138
+3017,4233424,153
+3010,4233577,169
+3063,4233746,129
+3072,4233875,157
+3059,4234032,124
+3053,4234156,135
+2961,4234291,228
+2967,4234519,198
+2962,4234717,139
+2970,4234856,185
+2973,4235041,170
+2966,4235211,143
+2902,4235354,134
+2896,4235488,123
+2898,4235611,185
+2921,4235796,135
+2981,4235931,154
+2889,4236085,155
+2886,4236240,141
+2938,4236381,132
+2948,4236513,124
+2935,4236637,149
+2918,4236786,147
+2860,4236933,150
+2854,4237083,156
+2856,4237239,127
+2858,4237366,160
+2864,4237526,209
+2802,4237735,137
+2805,4237872,144
+2800,4238016,203
+2804,4238219,141
+2798,4238360,154
+2776,4238514,159
+2775,4238673,154
+2872,4238827,137
+2866,4238964,132
+2823,4239096,157
+2820,4239253,152
+2809,4239405,153
+2847,4239558,148
+2835,4239706,116
+2832,4239822,171
+2793,4239993,181
+2859,4240174,170
+2818,4240344,152
+2765,4240496,172
+2764,4240668,144
+2767,4240812,188
+2769,4241000,102
+2685,4241102,121
+2687,4241223,148
+2689,4241371,140
+2695,4241511,164
+2679,4241675,145
+2700,4241820,141
+2710,4241961,149
+2690,4242110,188
+2771,4242298,144
+2760,4242442,175
+2758,4242617,139
+2731,4242756,192
+2740,4242948,163
+2682,4243111,152
+2716,4243263,150
+2677,4243413,147
+2578,4243560,169
+2579,4243729,146
+2569,4243875,167
+2625,4244042,141
+2614,4244183,175
+2632,4244358,157
+2622,4244515,133
+2649,4244648,126
+2644,4244774,134
+2639,4244908,167
+2642,4245075,141
+2562,4245216,176
+2661,4245392,169
+2594,4245561,127
+2588,4245688,165
+2610,4245853,140
+2603,4245993,127
+2626,4246120,141
+2616,4246261,129
+2472,4246390,128
+2474,4246518,164
+2468,4246682,161
+2470,4246843,146
+2471,4246989,134
+2504,4247123,201
+2487,4247324,141
+2482,4247465,115
+2547,4247580,169
+2543,4247749,147
+2500,4247896,154
+2521,4248050,149
+2512,4248199,155
+2508,4248354,124
+2560,4248478,147
+2544,4248625,171
+2532,4248796,179
+2418,4248975,150
+2424,4249125,175
+2419,4249300,171
+2421,4249471,175
+2423,4249646,141
+2409,4249787,169
+2370,4249956,178
+2373,4250134,153
+2366,4250287,158
+2368,4250445,152
+2431,4250597,139
+2432,4250736,154
+2464,4250890,160
+2459,4251050,137
+2448,4251187,165
+2387,4251352,173
+2380,4251525,164
+2414,4251689,162
+2412,4251851,164
+2399,4252015,135
+2442,4252150,126
+2297,4252276,168
+2292,4252444,183
+2295,4252627,221
+2336,4252848,182
+2338,4253030,134
+2326,4253164,175
+2321,4253339,141
+2322,4253480,141
+2312,4253621,164
+2315,4253785,145
+2363,4253930,162
+2356,4254092,154
+2353,4254246,172
+2293,4254418,166
+2284,4254584,157
+2278,4254741,128
+2352,4254869,145
+2334,4255014,169
+2274,4255183,141
+2309,4255324,154
+2213,4255478,160
+2210,4255638,150
+2200,4255788,158
+2203,4255946,159
+2204,4256105,169
+2205,4256274,127
+2255,4256401,185
+2251,4256586,145
+2259,4256731,165
+2256,4256896,173
+2234,4257069,153
+2229,4257222,166
+2231,4257388,152
+2217,4257540,173
+2248,4257713,161
+2244,4257874,152
+2191,4258026,157
+2187,4258183,155
+2155,4258338,125
+2175,4258463,150
+2182,4258613,141
+2136,4258754,140
+2128,4258894,148
+2139,4259042,157
+2091,4259199,150
+2094,4259349,152
+2029,4259501,141
+2033,4259642,149
+2034,4259791,132
+2026,4259923,131
+2032,4260054,133
+2023,4260187,146
+2006,4260333,106
+2007,4260439,125
+2004,4260564,198
+1998,4260762,144
+2003,4260906,136
+2067,4261042,135
+2063,4261177,136
+2066,4261313,145
+2059,4261458,141
+2058,4261599,124
+2019,4261723,160
+2017,4261883,169
+2016,4262052,127
+2042,4262179,115
+2038,4262294,151
+2043,4262445,158
+2141,4262603,128
+2133,4262731,158
+2138,4262889,129
+2071,4263018,158
+2069,4263176,124
+2072,4263300,138
+2090,4263438,154
+1964,4263592,105
+1962,4263697,140
+1956,4263837,152
+1949,4263989,138
+1951,4264127,136
+1148,4264263,116
+1982,4264379,117
+1967,4264496,147
+1895,4264643,181
+1883,4264824,133
+1890,4264957,136
+1924,4265093,141
+1910,4265234,122
+1914,4265356,150
+1936,4265506,168
+1933,4265674,128
+1930,4265802,155
+1938,4265957,132
+1970,4266089,140
+1965,4266229,160
+2000,4266389,190
+1898,4266579,143
+1766,4266722,167
+1756,4266889,162
+1804,4267051,165
+1807,4267216,140
+1812,4267356,106
+1779,4267462,151
+1746,4267613,143
+1752,4267756,147
+1743,4267903,185
+1790,4268088,146
+1767,4268234,165
+1773,4268399,128
+1755,4268527,142
+1831,4268669,148
+1838,4268817,110
+1689,4268927,128
+1677,4269055,131
+1699,4269186,118
+1695,4269304,133
+1698,4269437,143
+1702,4269580,172
+1720,4269752,132
+1723,4269884,129
+1725,4270013,144
+1731,4270157,135
+1706,4270292,126
+1623,4270418,157
+1687,4270575,122
+1690,4270697,109
+1661,4270806,126
+1649,4270932,114
+1650,4271046,120
+1642,4271166,155
+1633,4271321,164
+1714,4271485,128
+1718,4271613,117
+1668,4271730,122
+1666,4271852,113
+1507,4271965,163
+1517,4272128,136
+1519,4272264,166
+1536,4272430,159
+1643,4272589,133
+1370,4272722,130
+1619,4272852,141
+1615,4272993,163
+1554,4273156,137
+1545,4273293,138
+1558,4273431,132
+1549,4273563,136
+1610,4273699,151
+1599,4273850,153
+1597,4274003,159
+1593,4274162,94
+1583,4274256,149
+1590,4274405,155
+1617,4274560,149
+1628,4274709,167
+1602,4274876,148
+1513,4275024,149
+1510,4275173,125
+1566,4275298,113
+1570,4275411,176
+1416,4275587,137
+1421,4275724,141
+1418,4275865,128
+1425,4275993,130
+1427,4276123,144
+1479,4276267,107
+1484,4276374,169
+1487,4276543,181
+1478,4276724,139
+1494,4276863,132
+1498,4276995,128
+1441,4277123,120
+1449,4277243,160
+1455,4277403,133
+1446,4277536,133
+1440,4277669,115
+1412,4277784,155
+1423,4277939,123
+1467,4278062,102
+1303,4278164,128
+1308,4278292,136
+1273,4278428,153
+1274,4278581,153
+1345,4278734,147
+1349,4278881,148
+1338,4279029,147
+1329,4279176,141
+1337,4279317,138
+1322,4279455,155
+1325,4279610,152
+1317,4279762,149
+1368,4279911,138
+1360,4280049,176
+1298,4280225,150
+1283,4280375,94
+1402,4280469,137
+1380,4280606,148
+1272,4280754,167
+1269,4280921,153
+1266,4281074,117
+1267,4281191,127
+1261,4281318,172
+1255,4281490,172
+1254,4281662,158
+1246,4281820,141
+1186,4281961,154
+1179,4282115,141
+1177,4282256,137
+1166,4282393,143
+1190,4282536,119
+1192,4282655,152
+1185,4282807,148
+1230,4282955,105
+1223,4283060,97
+1165,4283157,150
+1168,4283307,110
+1249,4283417,154
+1218,4283571,142
+1158,4283713,157
+1163,4283870,137
+1156,4284007,102
+1144,4284109,186
+1146,4284295,113
+1130,4284408,131
+1131,4284539,146
+1138,4284685,124
+1124,4284809,132
+1125,4284941,148
+1118,4285089,160
+1041,4285249,149
+1040,4285398,150
+1042,4285548,148
+1090,4285696,104
+1093,4285800,144
+1102,4285944,141
+1106,4286085,142
+1063,4286227,141
+1056,4286368,139
+1085,4286507,96
+1083,4286603,143
+1073,4286746,153
+964,4286899,120
+965,4287019,109
+959,4287128,192
+953,4287320,138
+1017,4287458,166
+1022,4287624,141
+1013,4287765,118
+913,4287883,185
+940,4288068,145
+921,4288213,208
+1021,4288421,141
+954,4288562,140
+943,4288702,150
+779,4288852,154
+969,4289006,122
+961,4289128,133
+990,4289261,125
+808,4289386,138
+811,4289524,160
+812,4289684,127
+803,4289811,168
+896,4289979,152
+898,4290131,124
+890,4290255,125
+885,4290380,134
+858,4290514,132
+851,4290646,130
+854,4290776,172
+847,4290948,136
+891,4291084,133
+871,4291217,145
+874,4291362,109
+875,4291471,141
+876,4291612,141
+911,4291753,147
+900,4291900,110
+903,4292010,146
+897,4292156,131
+832,4292287,155
+492,4292442,117
+819,4292559,122
+824,4292681,134
+825,4292815,163
+817,4292978,141
+816,4293119,136
+842,4293255,135
+719,4293390,149
+721,4293539,122
+706,4293661,153
+694,4293814,168
+689,4293982,125
+685,4294107,146
+686,4294253,157
+772,4294410,169
+769,4294579,110
+765,4294689,141
+768,4294830,156
+701,4294986,133
+702,4295119,156
+697,4295275,141
+698,4295416,141
+761,4295557,135
+755,4295692,151
+746,4295843,135
+787,4295978,143
+784,4296121,166
+778,4296287,136
+798,4296423,136
+789,4296559,143
+793,4296702,107
+743,4296809,126
+735,4296935,134
+731,4297069,130
+587,4297199,141
+589,4297340,151
+592,4297491,146
+584,4297637,122
+588,4297759,135
+602,4297894,128
+622,4298022,147
+624,4298169,143
+571,4298312,115
+569,4298427,120
+563,4298547,163
+674,4298710,111
+596,4298821,121
+666,4298942,129
+655,4299071,139
+647,4299210,120
+641,4299330,128
+611,4299458,134
+576,4299592,127
+499,4299719,123
+484,4299842,129
+483,4299971,106
+491,4300077,167
+498,4300244,159
+473,4300403,111
+453,4300514,132
+457,4300646,141
+539,4300787,141
+542,4300928,118
+545,4301046,156
+503,4301202,157
+512,4301359,148
+452,4301507,129
+449,4301636,147
+472,4301783,140
+517,4301923,148
+533,4302071,150
+554,4302221,139
+396,4302360,125
+399,4302485,124
+379,4302609,155
+412,4302764,127
+419,4302891,127
+386,4303018,123
+393,4303141,167
+403,4303308,144
+12533,4303452,150
+349,4303602,147
+371,4303749,113
+364,4303862,111
+373,4303973,165
+431,4304138,158
+394,4304296,125
+402,4304421,156
+348,4304577,135
+361,4304712,159
+363,4304871,128
+438,4304999,141
+427,4305140,148
+325,4305288,135
+311,4305423,144
+316,4305567,126
+307,4305693,157
+421,4305850,146
+400,4305996,117
+332,4306113,149
+323,4306262,141
+331,4306403,152
+317,4306555,133
+288,4306688,139
+12358,4306827,167
+12440,4306994,165
+12301,4307159,158
+12405,4307317,123
+45161,4307440,115
+45250,4307555,141
+45115,4307696,132
+295,4307828,157
+270,4307985,167
+12343,4308152,166
+12375,4308318,142
+12540,4308460,163
+45190,4308623,141
+12450,4308764,148
+12354,4308912,158
+45255,4309070,153
+45098,4309223,123
+260,4309346,154
+262,4309500,142
+265,4309642,172
+668,4309814,111
+45081,4309925,118
+12399,4310043,144
+12349,4310187,132
+12532,4310319,152
+12370,4310471,149
+12313,4310620,141
+12406,4310761,143
+12524,4310904,99
+12531,4311003,132
+12492,4311135,141
+12464,4311276,158
+12523,4311434,163
+12449,4311597,149
+12394,4311746,159
+12422,4311905,154
+12356,4312059,133
+12482,4312192,110
+12371,4312302,125
+12498,4312427,150
+12377,4312577,156
+12439,4312733,111
+12383,4312844,120
+12508,4312964,155
+12325,4313119,161
+12306,4313280,148
+12486,4313428,152
+12502,4313580,122
+12353,4313702,151
+12428,4313853,150
+12515,4314003,138
+12479,4314141,116
+53263,4314257,121
+12376,4314378,122
+12340,4314500,148
+12362,4314648,134
+12429,4314782,152
+12454,4314934,138
+53439,4315072,154
+12348,4315226,125
+12324,4315351,141
+12534,4315492,149
+53295,4315641,143
+12504,4315784,99
+12310,4315883,119
+53425,4316002,129
+53270,4316131,147
+53315,4316278,143
+53441,4316421,156
+53420,4316577,133
+53372,4316710,154
+53436,4316864,141
+53451,4317005,178
+53273,4317183,165
+53301,4317348,178
+53467,4317526,155
+53360,4317681,175
+53289,4317856,159
+53443,4318015,146
+53267,4318161,151
+53411,4318312,141
+53374,4318453,106
+53280,4318559,135
+53448,4318694,114
+20503,4318808,113
+20581,4318921,169
+20665,4319090,156
+20587,4319246,118
+53366,4319364,135
+53329,4319499,143
+53435,4319642,141
+53358,4319783,145
+53340,4319928,147
+53482,4320075,165
+53348,4320240,123
+53342,4320363,163
+53418,4320526,140
+53341,4320666,149
+53409,4320815,145
+53254,4320960,141
+53290,4321101,154
+53391,4321255,153
+53498,4321408,190
+53483,4321598,147
+20641,4321745,151
+53440,4321896,141
+53352,4322037,131
+20521,4322168,151
+20609,4322319,166
+20652,4322485,147
+20553,4322632,133
+20493,4322765,165
+20643,4322930,172
+20644,4323102,129
+20572,4323231,127
+20659,4323358,149
+20620,4323507,132
+20705,4323639,166
+20702,4323805,140
+20597,4323945,139
+20717,4324084,130
+20630,4324214,167
+20498,4324381,126
+20722,4324507,136
+20554,4324643,120
+20673,4324763,149
+20687,4324912,210
+20516,4325122,135
+37053,4325257,158
+37044,4325415,163
+36867,4325578,103
+36913,4325681,120
+37021,4325801,172
+37085,4325973,128
+36904,4326101,166
+36989,4326267,132
+37065,4326399,139
+20603,4326538,149
+20685,4326687,108
+20525,4326795,122
+20538,4326917,148
+20615,4327065,165
+20518,4327230,136
+36908,4327366,168
+36893,4327534,116
+37015,4327650,132
+36901,4327782,213
+36940,4327995,131
+36996,4328126,134
+36970,4328260,154
+36999,4328414,129
+36945,4328543,148
+36902,4328691,190
+37075,4328881,158
+36967,4329039,170
+36906,4329209,159
+36877,4329368,153
+37071,4329521,124
+36978,4329645,111
+36911,4329756,151
+37016,4329907,145
+36933,4330052,151
+36918,4330203,116
+37003,4330319,126
+36932,4330445,146
+37009,4330591,139
+36990,4330730,142
+36944,4330872,139
+36941,4331011,115
+37117,4331126,147
+36921,4331273,139
+37116,4331412,159
+36884,4331571,146
+37005,4331717,162
+36930,4331879,125
+36915,4332004,134
+36866,4332138,116
+4308,4332254,158
+1577,4332412,142
+4265,4332554,138
+4234,4332692,141
+4132,4332833,173
+4310,4333006,127
+4168,4333133,142
+4247,4333275,202
+4229,4333477,162
+4108,4333639,135
+4102,4333774,159
+36873,4333933,164
+37006,4334097,165
+36988,4334262,145
+37074,4334407,141
+510,4334548,177
+37054,4334725,178
+4156,4334903,150
+4121,4335053,170
+37086,4335223,151
+36971,4335374,150
+4322,4335524,131
+4306,4335655,157
+4313,4335812,159
+36966,4335971,155
+4244,4336126,195
+4176,4336321,142
+4252,4336463,144
+4302,4336607,146
+4274,4336753,150
+4191,4336903,135
+4158,4337038,153
+4299,4337191,133
+4320,4337324,147
+4220,4337471,131
+4285,4337602,220
+4104,4337822,165
+4305,4337987,154
+4202,4338141,163
+4207,4338304,155
+4148,4338459,133
+4164,4338592,160
+4257,4338752,167
+4264,4338919,155
+4206,4339074,132
+4250,4339206,114
+4233,4339320,120
+4326,4339440,171
+4155,4339611,149
+57475,4339760,159
+57458,4339919,107
+57517,4340026,143
+57492,4340169,110
+57394,4340279,168
+57536,4340447,163
+57553,4340610,154
+57584,4340764,138
+57346,4340902,150
+57558,4341052,162
+57460,4341214,159
+57561,4341373,133
+57429,4341506,187
+57524,4341693,149
+57457,4341842,142
+57446,4341984,153
+57491,4342137,136
+57410,4342273,146
+57579,4342419,159
+57372,4342578,133
+57383,4342711,129
+57419,4342840,163
+57495,4343003,154
+57481,4343157,149
+57456,4343306,137
+57436,4343443,143
+57380,4343586,136
+24667,4343722,164
+24791,4343886,188
+57530,4344074,163
+57377,4344237,135
+57435,4344372,165
+57412,4344537,148
+57546,4344685,144
+57511,4344829,155
+57442,4344984,151
+57550,4345135,121
+57439,4345256,125
+57375,4345381,158
+57552,4345539,133
+57440,4345672,119
+57450,4345791,115
+57345,4345906,149
+57560,4346055,140
+57575,4346195,150
+57404,4346345,120
+57459,4346465,170
+24678,4346635,134
+24820,4346769,169
+24672,4346938,181
+24629,4347119,167
+24583,4347286,139
+24664,4347425,183
+24827,4347608,142
+24769,4347750,150
+24636,4347900,152
+24701,4348052,154
+24601,4348206,143
+24665,4348349,160
+24579,4348509,162
+24698,4348671,117
+24819,4348788,195
+24700,4348983,129
+24736,4349112,182
+24599,4349294,131
+24614,4349425,148
+24686,4349573,162
+24775,4349735,157
+1048808,4349892,156
+24691,4350048,163
+24829,4350211,119
+24779,4350330,165
+24776,4350495,163
+24611,4350658,156
+24675,4350814,150
+24625,4350964,118
+24590,4351082,169
+24739,4351251,156
+24637,4351407,120
+24813,4351527,158
+24594,4351685,155
+24653,4351840,150
+24823,4351990,137
+24608,4352127,153
+24768,4352280,127
+24695,4352407,135
+24724,4352542,142
+24747,4352684,146
+24797,4352830,134
+24646,4352964,136
+24680,4353100,161
+24666,4353261,133
+24725,4353394,147
+24714,4353541,128
+24723,4353669,118
+41023,4353787,228
+41005,4354015,148
+41084,4354163,170
+41114,4354333,140
+41107,4354473,140
+41080,4354613,151
+41151,4354764,161
+41055,4354925,150
+41165,4355075,169
+41178,4355244,174
+41002,4355418,154
+40988,4355572,167
+41103,4355739,147
+41164,4355886,162
+41190,4356048,140
+41034,4356188,155
+41013,4356343,139
+41021,4356482,122
+41046,4356604,116
+41185,4356720,166
+41143,4356886,137
+40998,4357023,146
+40995,4357169,177
+41097,4357346,164
+40967,4357510,137
+41031,4357647,146
+41010,4357793,151
+41187,4357944,136
+40980,4358080,101
+40981,4358181,114
+41066,4358295,142
+40984,4358437,154
+41214,4358591,156
+41195,4358747,151
+41085,4358898,147
+41177,4359045,168
+41072,4359213,128
+8414,4359341,170
+8203,4359511,152
+8340,4359663,139
+8439,4359802,141
+8407,4359943,173
+8387,4360116,150
+8263,4360266,138
+8405,4360404,102
+8218,4360506,153
+8434,4360659,147
+8376,4360806,146
+8365,4360952,121
+8317,4361073,159
+8239,4361232,156
+8346,4361388,138
+8290,4361526,140
+8321,4361666,142
+8409,4361808,175
+8303,4361983,154
+8224,4362137,146
+8219,4362283,150
+8435,4362433,145
+8336,4362578,174
+8384,4362752,153
+8318,4362905,137
+8270,4363042,174
+8394,4363216,135
+8341,4363351,148
+8443,4363499,157
+8304,4363656,128
+8382,4363784,147
+8255,4363931,119
+8361,4364050,143
+8342,4364193,132
+8266,4364325,106
+8447,4364431,154
+8260,4364585,114
+8431,4364699,121
+8240,4364820,134
+8364,4364954,154
+8408,4365108,142
+8294,4365250,146
+8193,4365396,144
+8383,4365540,144
+8275,4365684,159
+8353,4365843,118
+49199,4365961,124
+49182,4366085,132
+49377,4366217,140
+8246,4366357,135
+8440,4366492,164
+49253,4366656,153
+49273,4366809,127
+49167,4366936,164
+49287,4367100,164
+49158,4367264,146
+49316,4367410,102
+49193,4367512,151
+49402,4367663,160
+49210,4367823,139
+49216,4367962,119
+49180,4368081,147
+49218,4368228,130
+49265,4368358,170
+49220,4368528,126
+49382,4368654,142
+49302,4368796,132
+49230,4368928,139
+49215,4369067,160
+49206,4369227,148
+49314,4369375,111
+49235,4369486,148
+49356,4369634,168
+49358,4369802,171
+16463,4369973,151
+16527,4370124,123
+16599,4370247,120
+16471,4370367,152
+16407,4370519,158
+49369,4370677,156
+49329,4370833,128
+49362,4370961,136
+49278,4371097,149
+49373,4371246,137
+49179,4371383,157
+16495,4371540,131
+16627,4371671,112
+16459,4371783,140
+16435,4371923,164
+49294,4372087,168
+49351,4372255,168
+49348,4372423,157
+49170,4372580,144
+16557,4372724,133
+16493,4372857,129
+16589,4372986,160
+16629,4373146,129
+16441,4373275,159
+16505,4373434,166
+49184,4373600,173
+49383,4373773,108
+49247,4373881,156
+16558,4374037,139
+16630,4374176,151
+16518,4374327,137
+16530,4374464,161
+16488,4374625,138
+16504,4374763,158
+16628,4374921,163
+16564,4375084,108
+16560,4375192,166
+32985,4375358,156
+16473,4375514,135
+16533,4375649,165
+16437,4375814,115
+16476,4375929,164
+16481,4376093,186
+140,4376279,205
+16569,4376484,128
+16571,4376612,150
+16561,4376762,138
+16632,4376900,130
+16594,4377030,143
+16420,4377173,120
+16617,4377293,139
+16387,4377432,213
+16528,4377645,144
+16581,4377789,161
+16416,4377950,138
+16456,4378088,136
+16508,4378224,148
+16511,4378372,99
+16429,4378471,160
+32934,4378631,148
+16606,4378779,127
+16585,4378906,122
+32818,4379028,121
+32975,4379149,159
+32912,4379308,167
+16452,4379475,163
+32964,4379638,164
+32859,4379802,146
+32835,4379948,118
+16607,4380066,152
+16393,4380218,153
+16544,4380371,138
+16636,4380509,144
+32943,4380653,129
+32900,4380782,114
+33011,4380896,136
+32921,4381032,139
+32909,4381171,133
+32958,4381304,131
+32789,4381435,134
+32978,4381569,140
+32905,4381709,142
+32879,4381851,117
+32897,4381968,162
+32924,4382130,129
+32869,4382259,144
+32793,4382403,170
+32848,4382573,148
+32932,4382721,148
+32973,4382869,157
+32771,4383026,135
+32850,4383161,168
+32861,4383329,115
+32847,4383444,144
+32773,4383588,148
+32877,4383736,132
+32916,4383868,121
+65,4383989,133
+134,4384122,158
+146,4384280,155
+88,4384435,169
+32884,4384604,136
+32816,4384740,136
+85,4384876,154
+32969,4385030,152
+32780,4385182,121
+32893,4385303,143
+32867,4385446,194
+33006,4385640,115
+32910,4385755,136
+32918,4385891,165
+32986,4386056,181
+32830,4386237,130
+32974,4386367,154
+32794,4386521,144
+32990,4386665,112
+32770,4386777,137
+32868,4386914,150
+32840,4387064,140
+32901,4387204,156
+32844,4387360,118
+32911,4387478,148
+82,4387626,143
+33023,4387769,162
+247,4387931,155
+199,4388086,139
+209,4388225,132
+22,4388357,145
+225,4388502,137
+129,4388639,129
+41,4388768,143
+10,4388911,165
+13,4389076,121
+36,4389197,102
+103,4389299,154
+210,4389453,126
+55,4389579,146
+251,4389725,133
+226,4389858,147
+186,4390005,123
+42,4390128,136
+44,4390264,138
+131,4390402,136
+243,4390538,134
+176,4390672,141
+207,4390813,139
+86,4390952,127
+108,4391079,60
+169,4391139,158
+239,4391297,110
+37,4391407,129
+175,4391536,154
+118,4391690,146
+524373,4391836,145
+524371,4391981,145
+524430,4392126,140
+524420,4392266,141
+524421,4392407,111
+524418,4392518,146
+524416,4392664,132
+524407,4392796,143
+524404,4392939,137
+524398,4393076,120
+524392,4393196,144
+524387,4393340,118
+524411,4393458,143
+524412,4393601,157
+223,4393758,157
+249,4393915,146
+524384,4394061,159
+524364,4394220,151
+524359,4394371,171
+524362,4394542,140
+524356,4394682,138
+524353,4394820,157
+524343,4394977,136
+524341,4395113,147
+524338,4395260,137
+524429,4395397,131
+524309,4395528,137
+524354,4395665,108
+524390,4395773,141
+524292,4395914,151
+456,4396065,92
+524351,4396157,118
+524299,4396275,140
+56577,4396415,145
+56582,4396560,145
+11141123,4396705,160
+0,4396865,129
+524321,4396994,124
+178945,4397118,138
+524426,4397256,131
+62,4397387,119
+56578,4397506,145
+56580,4397651,145
+155782,4397796,156
+524336,4397952,107
+7658120,4398059,252
+13382373,4398311,252
+1850355,4398563,252
+3966673,4398815,197
+3152791,4399012,215
+2937571,4399227,220
+1333699,4399447,150
+10541167,4399597,140
+14968606,4399737,295
+6825753,4400032,157
+2408826,4400189,217
+1875084,4400406,137
+10799417,4400543,213
+3463026,4400756,240
+12639450,4400996,161
+308265,4401157,161
+4749645,4401318,161
+4520305,4401479,260
+1636804,4401739,132
+6335442,4401871,136
+15789958,4402007,139
+14991564,4402146,192
+6074686,4402338,178
+16049650,4402516,196
+5509904,4402712,196
+9233903,4402908,196
+10800419,4403104,238
+12073562,4403342,189
+14985962,4403531,174
+10523754,4403705,297
+1845923,4404002,270
+3706490,4404272,127
+5009676,4404399,141
+5009677,4404540,141
+10236355,4404681,121
+7087270,4404802,197
+10248026,4404999,213
+14960563,4405212,178
+16571169,4405390,141
+6322033,4405531,130
+14208905,4405661,265
+305889,4405926,263
+4512846,4406189,214
+3680793,4406403,149
+7657044,4406552,133
+11856073,4406685,179
+8134926,4406864,139
+9711068,4407003,161
+5567124,4407164,180
+2382517,4407344,161
+12636893,4407505,161
+11280018,4407666,164
+26859,4407830,112
+8172411,4407942,211
+4738182,4408153,180
+8917565,4408333,230
+4727051,4408563,168
+10493069,4408731,196
+8139022,4408927,139
+16047791,4409066,196
+6296124,4409262,196
+4761063,4409458,156
+535734,4409614,123
+16273011,4409737,123
+11806301,4409860,151
+15759367,4410011,123
+3984694,4410134,123
+13940489,4410257,178
+3675214,4410435,199
+11320587,4410634,140
+14732536,4410774,219
+9982538,4410993,166
+3696804,4411159,175
+11838892,4411334,213
+1865806,4411547,218
+8666745,4411765,179
+12065028,4411944,189
+16033181,4412133,180
+14742594,4412313,180
+15778863,4412493,180
+12629117,4412673,180
+4474503,4412853,256
+15214217,4413109,189
+2159477,4413298,139
+8698729,4413437,139
+1073108,4413576,207
+9233294,4413783,150
+10531897,4413933,141
+10794041,4414074,141
+4152,4414215,185
+15211339,4414400,139
+13431825,4414539,139
+10235343,4414678,277
+9708728,4414955,197
+13108213,4415152,135
+3338,4415287,163
+12871633,4415450,196
+10259147,4415646,137
+13157477,4415783,196
+1852259,4415979,196
+9709871,4416175,185
+13933216,4416360,134
+16257017,4416494,139
+9198273,4416633,180
+11033312,4416813,180
+10794526,4416993,180
+12910171,4417173,213
+12597559,4417386,197
+11815995,4417583,186
+4235995,4417769,141
+5008403,4417910,210
+11044311,4418120,180
+4475611,4418300,123
+8714371,4418423,148
+10265875,4418571,161
+1063401,4418732,137
+3182664,4418869,123
+13901580,4418992,151
+13171332,4419143,150
+12845793,4419293,234
+16276283,4419527,164
+7892459,4419691,126
+8972708,4419817,158
+2646973,4419975,146
+1864221,4420121,117
+15998101,4420238,255
+10512510,4420493,139
+11038813,4420632,139
+5530883,4420771,220
+10262409,4420991,176
+1836471,4421167,208
+3827,4421375,144
+10503088,4421519,277
+7646393,4421796,146
+16028351,4421942,146
+14206305,4422088,194
+797167,4422282,117
+6346908,4422399,127
+16264846,4422526,191
+11848121,4422717,186
+15746619,4422903,155
+6870938,4423058,146
+1860543,4423204,218
+11286097,4423422,239
+6834806,4423661,122
+6852553,4423783,307
+15761781,4424090,178
+14174002,4424268,252
+2647216,4424520,180
+323945,4424700,180
+5251564,4424880,180
+9201722,4425060,196
+11824648,4425256,196
+24076,4425452,127
+11829511,4425579,285
+7366229,4425864,169
+6585396,4426033,180
+7092385,4426213,180
+7885581,4426393,219
+805062,4426612,154
+10758533,4426766,186
+7908420,4426952,117
+10012856,4427069,197
+12113127,4427266,189
+14175376,4427455,123
+2412767,4427578,123
+7096965,4427701,123
+2682931,4427824,123
+2137847,4427947,145
+12323171,4428092,123
+1595497,4428215,199
+12332527,4428414,257
+7897550,4428671,218
+12386081,4428889,238
+4480233,4429127,175
+12588690,4429302,192
+3675952,4429494,159
+4206193,4429653,130
+7370461,4429783,146
+9759214,4429929,180
+2679630,4430109,196
+13914862,4430305,121
+14689279,4430426,126
+9198044,4430552,220
+1606284,4430772,158
+10285097,4430930,214
+2643649,4431144,187
+7911638,4431331,148
+12339798,4431479,141
+7102964,4431620,145
+16027851,4431765,154
+4223,4431919,152
+7045,4432071,140
+5785915,4432211,140
+6935,4432351,140
+5790146,4432491,147
+12070859,4432638,129
+1101381,4432767,126
+7896403,4432893,147
+8164785,4433040,147
+15493249,4433187,140
+7892372,4433327,140
+16297733,4433467,180
+5045418,4433647,125
+13413164,4433772,166
+7105801,4433938,163
+2416932,4434101,207
+2376674,4434308,200
+11037371,4434508,178
+9443135,4434686,196
+5508653,4434882,197
+7376711,4435079,197
+10551152,4435276,166
+6323917,4435442,196
+5540538,4435638,141
+13109049,4435779,132
+9207039,4435911,172
+11287694,4436083,247
+4219444,4436330,201
+8950897,4436531,172
+7907041,4436703,172
+38124,4436875,180
+7619885,4437055,180
+10768390,4437235,226
+13136165,4437461,202
+6843836,4437663,202
+8441762,4437865,180
+525122,4438045,140
+16530853,4438185,158
+15486850,4438343,122
+4482431,4438465,122
+4749126,4438587,122
+15494325,4438709,178
+12628225,4438887,178
+1311058,4439065,161
+12333996,4439226,149
+9763751,4439375,154
+9997945,4439529,145
+10024481,4439674,219
+12598970,4439893,117
+12597594,4440010,186
+2122955,4440196,213
+15750401,4440409,180
+8188637,4440589,135
+13661839,4440724,122
+1900377,4440846,240
+1315835,4441086,196
+57527,4441282,188
+10785600,4441470,265
+16312439,4441735,200
+10525458,4441935,185
+9701459,4442120,174
+11837056,4442294,204
+57900,4442498,192
+7868672,4442690,167
+15237013,4442857,123
+8962187,4442980,123
+7646099,4443103,142
+8169835,4443245,194
+9963068,4443439,175
+3727021,4443614,140
+13921645,4443754,140
+11823393,4443894,140
+16314910,4444034,140
+7645162,4444174,141
+5012697,4444315,123
+15783855,4444438,154
+8710893,4444592,125
+8172157,4444717,140
+322867,4444857,140
+6062262,4444997,140
+8701350,4445137,140
+11298653,4445277,140
+16311523,4445417,140
+14176055,4445557,137
+11276803,4445694,140
+14424993,4445834,140
+6071740,4445974,120
+275394,4446094,140
+13129920,4446234,140
+6601816,4446374,140
+10798064,4446514,140
+5273263,4446654,140
+14455231,4446794,141
+10013052,4446935,255
+14717607,4447190,209
+569511,4447399,150
+12608361,4447549,210
+1589758,4447759,117
+7130692,4447876,174
+11564571,4448050,196
+10752354,4448246,135
+7429,4448381,158
+9178720,4448539,265
+1616669,4448804,161
+12380463,4448965,112
+8665045,4449077,161
+3441349,4449238,161
+3410483,4449399,189
+8706075,4449588,252
+8137435,4449840,219
+15245893,4450059,137
+8923465,4450196,192
+16278712,4450388,178
+1331488,4450566,180
+12636563,4450746,180
+3966058,4450926,252
+7865571,4451178,180
+10763022,4451358,180
+2400608,4451538,170
+14462699,4451708,135
+2392519,4451843,180
+16549418,4452023,180
+1850671,4452203,196
+15496510,4452399,196
+9474404,4452595,257
+15522694,4452852,127
+4735965,4452979,141
+538729,4453120,252
+14196436,4453372,199
+8651560,4453571,137
+564153,4453708,109
+7420,4453817,176
+5686,4453993,167
+5566815,4454160,186
+14711236,4454346,196
+8929383,4454542,137
+11310450,4454679,206
+4248159,4454885,214
+11010858,4455099,170
+6645,4455269,175
+52157,4455444,172
+5805218,4455616,115
+4989465,4455731,178
+5560774,4455909,180
+3181303,4456089,180
+6612952,4456269,175
+14217026,4456444,180
+8440850,4456624,180
+1616399,4456804,180
+11576416,4456984,140
+11311766,4457124,131
+58374,4457255,196
+4465276,4457451,196
+13414786,4457647,196
+4755503,4457843,189
+2668412,4458032,154
+6870765,4458186,225
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.txt
new file mode 100644
index 0000000000000000000000000000000000000000..60f1f01529f363147ac0b23e5d1c40d54330b4d3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/eui/oui.txt
@@ -0,0 +1,168378 @@
+OUI/MA-L                                                    Organization                                 
+company_id                                                  Organization                                 
+                                                            Address                                      
+
+00-22-72   (hex)		American Micro-Fuel Device Corp.
+002272     (base 16)		American Micro-Fuel Device Corp.
+				2181 Buchanan Loop
+				Ferndale  WA  98248
+				US
+
+00-D0-EF   (hex)		IGT
+00D0EF     (base 16)		IGT
+				9295 PROTOTYPE DRIVE
+				RENO  NV  89511
+				US
+
+08-61-95   (hex)		Rockwell Automation
+086195     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+F4-BD-9E   (hex)		Cisco Systems, Inc
+F4BD9E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-85-E9   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+5885E9     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+BC-23-92   (hex)		BYD Precision Manufacture Company Ltd.
+BC2392     (base 16)		BYD Precision Manufacture Company Ltd.
+				No.3001, Bao He Road, Baolong Industrial, Longgang Street,Longgang Zone, Shenzhen
+				shenzhen    518116
+				CN
+
+40-55-82   (hex)		Nokia
+405582     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+A4-E3-1B   (hex)		Nokia
+A4E31B     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+D8-97-90   (hex)		Commonwealth Scientific and Industrial Research Organisation
+D89790     (base 16)		Commonwealth Scientific and Industrial Research Organisation
+				GPO Box 1700
+				Canberra  ACT  2601
+				AU
+
+88-3A-30   (hex)		Aruba, a Hewlett Packard Enterprise Company
+883A30     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+B8-A5-8D   (hex)		Axe Group Holdings Limited
+B8A58D     (base 16)		Axe Group Holdings Limited
+				Road Town
+				tortola    VG1110
+				VG
+
+50-CE-E3   (hex)		Gigafirm.co.LTD
+50CEE3     (base 16)		Gigafirm.co.LTD
+				3-21-8,kisonishi
+				machida-city  tokyo  1940037
+				JP
+
+98-E7-43   (hex)		Dell Inc.
+98E743     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+C4-19-D1   (hex)		Telink Semiconductor (Shanghai) Co., Ltd.
+C419D1     (base 16)		Telink Semiconductor (Shanghai) Co., Ltd.
+				No. 1500 Zuchongzhi Rd, Building #3
+				Shanghai    201203
+				CN
+
+88-7E-25   (hex)		Extreme Networks, Inc.
+887E25     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+08-60-83   (hex)		zte corporation
+086083     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E0-19-54   (hex)		zte corporation
+E01954     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-32-7E   (hex)		Huawei Device Co., Ltd.
+10327E     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F8-08-4F   (hex)		Sagemcom Broadband SAS
+F8084F     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+30-FB-B8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30FBB8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-97-C2   (hex)		Nebulon Inc
+F497C2     (base 16)		Nebulon Inc
+				3089 Skyway Court
+				Fremont  CA  94539
+				US
+
+A4-45-19   (hex)		Xiaomi Communications Co Ltd
+A44519     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+68-DB-F5   (hex)		Amazon Technologies Inc.
+68DBF5     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+24-46-C8   (hex)		Motorola Mobility LLC, a Lenovo Company
+2446C8     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+18-02-AE   (hex)		vivo Mobile Communication Co., Ltd.
+1802AE     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+0C-20-D3   (hex)		vivo Mobile Communication Co., Ltd.
+0C20D3     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+44-D7-91   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+44D791     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-46-FE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8446FE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D8-29-18   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D82918     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-D0-03   (hex)		Samsung Electronics Co.,LTD
+D0D003     (base 16)		Samsung Electronics Co.,LTD
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+64-B2-1D   (hex)		Chengdu Phycom Tech Co., Ltd.
+64B21D     (base 16)		Chengdu Phycom Tech Co., Ltd.
+				No.216 beisen road
+				Chengdu  Sichuan  610000
+				CN
+
+C4-29-96   (hex)		Signify B.V.
+C42996     (base 16)		Signify B.V.
+				High Tech Campus 7
+				Eindhoven    5656AE
+				NL
+
+98-06-37   (hex)		IEEE Registration Authority
+980637     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-B8-4A   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+8CB84A     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+98-E8-FA   (hex)		Nintendo Co.,Ltd
+98E8FA     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+38-C4-E8   (hex)		NSS Sp. z o.o.
+38C4E8     (base 16)		NSS Sp. z o.o.
+				Modularna 11
+				Warszawa    02-238
+				PL
+
+34-DD-7E   (hex)		Umeox Innovations Co.,Ltd
+34DD7E     (base 16)		Umeox Innovations Co.,Ltd
+				Room 1208-09, Research Building, Tsinghua Information Port, No. 1, Xindong Road, Nanshan District, Shenzhen
+				Shenzhen  Guangdong  518000
+				CN
+
+CC-CD-64   (hex)		SM-Electronic GmbH
+CCCD64     (base 16)		SM-Electronic GmbH
+				Waldweg 2
+				Stapelfeld / Braak    22145
+				DE
+
+24-DF-A7   (hex)		Hangzhou BroadLink Technology Co.,Ltd
+24DFA7     (base 16)		Hangzhou BroadLink Technology Co.,Ltd
+				Room 101,1/F,Unit C,Building 1,No.57 Jiang'er Road,Changhe Street,Binjiang District,Hangzhou,Zhejiang,P.R.China
+				Hangzhou  Zhejiang  310052
+				CN
+
+B0-65-F1   (hex)		WIO Manufacturing HK Limited
+B065F1     (base 16)		WIO Manufacturing HK Limited
+				15/F OTB Building, 160 Glocester Road
+				Hong Kong    00000
+				HK
+
+90-12-34   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+901234     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+54-2A-1B   (hex)		Sonos, Inc.
+542A1B     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+5C-92-5E   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+5C925E     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				A1&A2 Building,Lantian Technology Park, Xinyu Road, Xingqiao Henggang Block, Shajing Street, Baoan District
+				Shenzhen  Guangdong  518000
+				CN
+
+08-4F-A9   (hex)		Cisco Systems, Inc
+084FA9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-4F-F9   (hex)		Cisco Systems, Inc
+084FF9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-98-B8   (hex)		New H3C Technologies Co., Ltd
+5098B8     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+11-00-AA   (hex)		Private
+1100AA     (base 16)		Private
+
+B8-4D-EE   (hex)		Hisense broadband multimedia technology Co.,Ltd
+B84DEE     (base 16)		Hisense broadband multimedia technology Co.,Ltd
+				Song ling Road 399
+				Qingdao    266000
+				CN
+
+A8-93-52   (hex)		SHANGHAI ZHONGMI COMMUNICATION TECHNOLOGY CO.,LTD
+A89352     (base 16)		SHANGHAI ZHONGMI COMMUNICATION TECHNOLOGY CO.,LTD
+				RM510,418 Guiping Road,xuhui-Park
+				shanghai  shanghai  200233
+				CN
+
+E4-CC-9D   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+E4CC9D     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+A8-D0-E3   (hex)		Systech Electronics Ltd
+A8D0E3     (base 16)		Systech Electronics Ltd
+				Lever Tech Centre, 69-71 King Yip Street,
+				,    852
+				HK
+
+98-BA-39   (hex)		Doro AB
+98BA39     (base 16)		Doro AB
+				Jörgen Kocksgatan 1B
+				Malmö  Skane  211 20
+				SE
+
+D4-6B-A6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D46BA6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-05-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CC0577     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-8B-B2   (hex)		Cisco Systems, Inc
+308BB2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-EB-62   (hex)		Shanghai Hulu Devices Co., Ltd
+E0EB62     (base 16)		Shanghai Hulu Devices Co., Ltd
+				509 Caobao Road,  Rm 101-2 Bld 9
+				Shanghai    200233
+				CN
+
+08-68-8D   (hex)		New H3C Technologies Co., Ltd
+08688D     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+E8-6F-38   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+E86F38     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+48-21-6C   (hex)		China Mobile IOT Company Limited
+48216C     (base 16)		China Mobile IOT Company Limited
+				Building D3,No.8 Yangliu North Road,Yubei District 
+				CHONGQING  CHONGQING  401121
+				CN
+
+8C-BE-24   (hex)		Tashang Semiconductor(Shanghai) Co., Ltd.
+8CBE24     (base 16)		Tashang Semiconductor(Shanghai) Co., Ltd.
+				Room 903, Building 5, Minggu Science Park,No. 7001, Zhong Chun Road, Minhang District ,Shanghai 201101, P.R. China
+				Shanghai    123456
+				CN
+
+08-B3-AF   (hex)		vivo Mobile Communication Co., Ltd.
+08B3AF     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+30-86-2D   (hex)		Arista Network, Inc.
+30862D     (base 16)		Arista Network, Inc.
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+6C-E8-C6   (hex)		Earda Technologies co Ltd
+6CE8C6     (base 16)		Earda Technologies co Ltd
+				Block A,Lianfeng Creative Park, #2 Jisheng Rd., Nansha District
+				Guangzhou  Guangdong  511455
+				CN
+
+1C-41-76   (hex)		China Mobile Group Device Co.,Ltd.
+1C4176     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+60-8B-0E   (hex)		Apple, Inc.
+608B0E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-71-D5   (hex)		Hazens Automotive Electronics(SZ)Co.,Ltd.
+1871D5     (base 16)		Hazens Automotive Electronics(SZ)Co.,Ltd.
+				C8 Building, Building 13, Zhongxin Innovation Industry City, No.12, Ganli No.6 Road, Ganli Industrial Park, Buji Street, Longgang District 
+				Shenzhen  Guangdong  518100
+				CN
+
+AC-B1-EE   (hex)		SHENZHEN FENDA TECHNOLOGY CO., LTD
+ACB1EE     (base 16)		SHENZHEN FENDA TECHNOLOGY CO., LTD
+				Fenda Hi-Tech Park, Zhoushi Road, Shiyan, Baoan
+				ShenZhen  GuangDong  518108
+				CN
+
+F8-AD-CB   (hex)		HMD Global Oy
+F8ADCB     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+D4-62-EA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D462EA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-BA-D6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+54BAD6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-DC-4E   (hex)		AEV, spol. s r. o.
+94DC4E     (base 16)		AEV, spol. s r. o.
+				Jozky Silneho 2783/9
+				Kromeriz    76701
+				CZ
+
+14-42-FC   (hex)		Texas Instruments
+1442FC     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+AC-5D-5C   (hex)		FN-LINK TECHNOLOGY LIMITED
+AC5D5C     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+A4-AE-11   (hex)		Hon Hai Precision Ind. Co., Ltd.
+A4AE11     (base 16)		Hon Hai Precision Ind. Co., Ltd.
+				GuangDongShenZhen
+				ShenZhen  GuangDong  518109
+				CN
+
+54-DE-D0   (hex)		Sevio Srl
+54DED0     (base 16)		Sevio Srl
+				Via Dei Caniana 6/A
+				Bergamo  Bergamo  24127
+				IT
+
+6C-5E-3B   (hex)		Cisco Systems, Inc
+6C5E3B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-19-20   (hex)		Movon Corporation
+401920     (base 16)		Movon Corporation
+				3Fl, Hyunjuk Bldg. 7 selleung-ro, 94gil,  Gangnam-gu
+				Seoul    06161
+				KR
+
+D0-37-45   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D03745     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+60-3A-7C   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+603A7C     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-01-78   (hex)		MARGI Systems, Inc.
+000178     (base 16)		MARGI Systems, Inc.
+				3155 Kearney Street. - Ste.#200
+				Fremont  CA  94538
+				US
+
+0C-B7-71   (hex)		ARRIS Group, Inc.
+0CB771     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+58-C8-76   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+58C876     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+2C-1E-4F   (hex)		Chengdu Qianli Network Technology Co., Ltd.
+2C1E4F     (base 16)		Chengdu Qianli Network Technology Co., Ltd.
+				Room 1208, 4 Building, Ideal Center, NO.38 Tianyi Street, Chengdu High-tech Zone
+				Chengdu  Sichuan  610000
+				CN
+
+00-90-52   (hex)		SELCOM ELETTRONICA S.R.L.
+009052     (base 16)		SELCOM ELETTRONICA S.R.L.
+				VIA GRANDI, 5
+				40013 CASTELMAGGIORE BO    
+				IT
+
+00-1A-83   (hex)		Pegasus Technologies Inc.
+001A83     (base 16)		Pegasus Technologies Inc.
+				108 Pawnook Farm Rd.
+				Lenoir City  TN  37771
+				US
+
+24-16-6D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24166D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+94-0B-19   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+940B19     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+70-C7-F2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70C7F2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+38-94-ED   (hex)		NETGEAR
+3894ED     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+70-04-33   (hex)		California Things Inc.
+700433     (base 16)		California Things Inc.
+				650 main st
+				redwood city  CA  94063
+				US
+
+DC-A6-32   (hex)		Raspberry Pi Trading Ltd
+DCA632     (base 16)		Raspberry Pi Trading Ltd
+				Maurice Wilkes Building, Cowley Road
+				Cambridge    CB4 0DS
+				GB
+
+88-F5-6E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88F56E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+BC-97-E1   (hex)		Broadcom Limited
+BC97E1     (base 16)		Broadcom Limited
+				15191 Alton Parkway
+				Irvine  CA  92618
+				US
+
+28-D1-B7   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+28D1B7     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+C8-C2-FA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C8C2FA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+88-B3-62   (hex)		Nokia Shanghai Bell Co., Ltd.
+88B362     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai 201206,P.R.China
+				Shanghai   Pudong  201206
+				CN
+
+08-47-D0   (hex)		Nokia Shanghai Bell Co., Ltd.
+0847D0     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai 201206,P.R.China
+				Shanghai   Pudong  201206
+				CN
+
+08-9C-86   (hex)		Nokia Shanghai Bell Co., Ltd.
+089C86     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai 201206,P.R.China
+				Shanghai   Pudong  201206
+				CN
+
+7C-89-56   (hex)		Samsung Electronics Co.,Ltd
+7C8956     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-93-E4   (hex)		Private
+9C93E4     (base 16)		Private
+
+88-29-9C   (hex)		Samsung Electronics Co.,Ltd
+88299C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-90-93   (hex)		Hansong Tehnologies
+CC9093     (base 16)		Hansong Tehnologies
+				8 Kangping road, New development zone
+				Nanjing  Jiangsu  210006
+				CN
+
+CC-64-A6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CC64A6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-31-7D   (hex)		Hosiden Corporation
+30317D     (base 16)		Hosiden Corporation
+				4-33, Kitakyuhoji 1-chome
+				Yao  Osaka  5810071
+				JP
+
+F0-A9-68   (hex)		Antailiye Technology Co.,Ltd
+F0A968     (base 16)		Antailiye Technology Co.,Ltd
+				7/F,Zhengjiyuan Buiding,2 Road,Qianjing, Xixiang, Baoan District,Shenzhen
+				SHEN ZHEN  GUANGDONG  518000
+				CN
+
+48-E1-E9   (hex)		Chengdu Meross Technology Co., Ltd.
+48E1E9     (base 16)		Chengdu Meross Technology Co., Ltd.
+				No. 25, Yizhou Avenue, Gaoxin
+				Chengdu  Sichuan  610000
+				CN
+
+D8-13-99   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+D81399     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+54-E0-19   (hex)		Ring LLC
+54E019     (base 16)		Ring LLC
+				1523 26th St
+				Santa Monica  CA  90404
+				US
+
+14-84-30   (hex)		MITAC COMPUTING TECHNOLOGY CORPORATION
+148430     (base 16)		MITAC COMPUTING TECHNOLOGY CORPORATION
+				3F., NO.1, R&D ROAD 2, HSINCHU SCIENCE PARK
+				HSINCHU    30076
+				TW
+
+B8-A4-4F   (hex)		Axis Communications AB
+B8A44F     (base 16)		Axis Communications AB
+				Emdalavägen 14
+				LUND    22369
+				SE
+
+00-24-EB   (hex)		ClearPath Networks, Inc.
+0024EB     (base 16)		ClearPath Networks, Inc.
+				1940 E. Mariposa Ave
+				El Segundo  CA  90245
+				US
+
+50-AF-4D   (hex)		zte corporation
+50AF4D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C8-EA-F8   (hex)		zte corporation
+C8EAF8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+70-9F-2D   (hex)		zte corporation
+709F2D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-3B-26   (hex)		Jiangsu Qinheng Co., Ltd.
+383B26     (base 16)		Jiangsu Qinheng Co., Ltd.
+				No. 18, Ningshuang Road
+				Nanjing  Jiangsu  210012
+				CN
+
+5C-FA-FB   (hex)		Acubit
+5CFAFB     (base 16)		Acubit
+				Afred Nobels Vej 21A
+				Aalborg Ø    9220
+				DK
+
+9C-7B-EF   (hex)		Hewlett Packard
+9C7BEF     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+74-2E-DB   (hex)		Perinet GmbH
+742EDB     (base 16)		Perinet GmbH
+				Rudower Chaussee 29
+				Berlin  Berlin  12489
+				DE
+
+20-17-42   (hex)		LG Electronics
+201742     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+CC-88-26   (hex)		LG Innotek
+CC8826     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+EC-5B-73   (hex)		Advanced & Wise Technology Corp.
+EC5B73     (base 16)		Advanced & Wise Technology Corp.
+				5F, No. 3-2, Industry East 9th Road, Hsinchu Science Park,
+				Hsinchu City  Hsinchu  30075
+				TW
+
+E0-CB-1D   (hex)		Private
+E0CB1D     (base 16)		Private
+
+84-8B-CD   (hex)		IEEE Registration Authority
+848BCD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+14-C0-3E   (hex)		ARRIS Group, Inc.
+14C03E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C0-89-AB   (hex)		ARRIS Group, Inc.
+C089AB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D4-4D-A4   (hex)		Murata Manufacturing Co., Ltd.
+D44DA4     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+F8-E5-CF   (hex)		CGI IT UK LIMITED
+F8E5CF     (base 16)		CGI IT UK LIMITED
+				20 Fenchurch Street, 14th Floor
+				London    EC3M 3BY
+				GB
+
+68-82-F2   (hex)		grandcentrix GmbH
+6882F2     (base 16)		grandcentrix GmbH
+				Holzmarkt 1 
+				Cologne  NW  50676
+				DE
+
+D4-20-B0   (hex)		Mist Systems, Inc.
+D420B0     (base 16)		Mist Systems, Inc.
+				1601 South De Anza Blvd, Suite 248
+				Cupertino  CA  95014
+				US
+
+08-ED-ED   (hex)		Zhejiang Dahua Technology Co., Ltd.
+08EDED     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+60-92-F5   (hex)		ARRIS Group, Inc.
+6092F5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-22-AF   (hex)		Safety Vision, LLC
+0022AF     (base 16)		Safety Vision, LLC
+				6100 W. Sam Houston Pkwy. North
+				Houston    77041
+				US
+
+A0-91-A2   (hex)		OnePlus Electronics (Shenzhen) Co., Ltd.
+A091A2     (base 16)		OnePlus Electronics (Shenzhen) Co., Ltd.
+				Room 201, Block A, No.1, 1st Qian Wan Road, Qianhai Shenzhen-Hong Kong Cooperation Zone, Shenzhen, China.
+				Shenzhen  Guangdong  518000
+				CN
+
+00-80-B5   (hex)		UNITED NETWORKS INC.
+0080B5     (base 16)		UNITED NETWORKS INC.
+				2178 PARAGON DRIVE
+				SAN JOSE  CA  95131
+				US
+
+1C-69-7A   (hex)		EliteGroup Computer Systems Co., LTD
+1C697A     (base 16)		EliteGroup Computer Systems Co., LTD
+				No.239, Sec. 2, TiDing Blvd. Nei-Hu Dist.
+				Taipei  Taiwan  11439
+				TW
+
+4C-17-44   (hex)		Amazon Technologies Inc.
+4C1744     (base 16)		Amazon Technologies Inc.
+				P.O. Box 8102
+				Reno  NV  89507
+				US
+
+B0-30-55   (hex)		China Mobile IOT Company Limited
+B03055     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+90-5C-34   (hex)		Sirius Electronic Systems Srl
+905C34     (base 16)		Sirius Electronic Systems Srl
+				via Robinie, 33
+				Gravellona Toce  VB  28883
+				IT
+
+D4-6A-35   (hex)		Cisco Systems, Inc
+D46A35     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D0-9C-7A   (hex)		Xiaomi Communications Co Ltd
+D09C7A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C8-2C-2B   (hex)		IEEE Registration Authority
+C82C2B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-20-DA   (hex)		Sagemcom Broadband SAS
+8020DA     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+68-84-7E   (hex)		FUJITSU LIMITED
+68847E     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+00-30-85   (hex)		Cisco Systems, Inc
+003085     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-5F-8D   (hex)		eero inc.
+605F8D     (base 16)		eero inc.
+				500 Howard Street, Suite 900
+				SAN FRANCISCO  CA  94105
+				US
+
+C4-B3-6A   (hex)		Cisco Systems, Inc
+C4B36A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+70-F7-54   (hex)		AMPAK Technology,Inc.
+70F754     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+6C-8B-D3   (hex)		Cisco Systems, Inc
+6C8BD3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+68-97-4B   (hex)		Shenzhen Costar Electronics Co. Ltd.
+68974B     (base 16)		Shenzhen Costar Electronics Co. Ltd.
+				No.94 Fuyuan 1st Road,Yuyuan Industrial Park,
+				Shenzhen   Guangdong  518103
+				CN
+
+34-E1-D1   (hex)		IEEE Registration Authority
+34E1D1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-21-B7   (hex)		LEXMARK INTERNATIONAL, INC.
+0021B7     (base 16)		LEXMARK INTERNATIONAL, INC.
+				740 West New Circle Road
+				Lexington  KY  40550
+				US
+
+00-A0-B0   (hex)		I-O DATA DEVICE,INC.
+00A0B0     (base 16)		I-O DATA DEVICE,INC.
+				24-1, SAKURADA-MACHI
+				KANAZAWA, ISHIKAWA 920    na
+				JP
+
+24-79-F3   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+2479F3     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+80-A2-35   (hex)		Edgecore Networks Corporation
+80A235     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+C8-C6-4A   (hex)		Flextronics Tech.(Ind) Pvt Ltd
+C8C64A     (base 16)		Flextronics Tech.(Ind) Pvt Ltd
+				SURVEYNO.381, PADUR ROAD, KUTHAMBAKKAM VILLAGE, 602107 POONAMALLEE TALUK, THIRUVALLUR DISTRIC
+				Chennai    602107
+				IN
+
+30-EA-26   (hex)		Sycada BV
+30EA26     (base 16)		Sycada BV
+				Burgemeester Stramanweg 105B
+				Amsterdam    1101 AA
+				NL
+
+9C-49-7F   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+9C497F     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+C4-E3-9F   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C4E39F     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+F8-9A-78   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F89A78     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-F8-72   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88F872     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-56-23   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC5623     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-86-BC   (hex)		Cisco Systems, Inc
+5486BC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-23-43   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+402343     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+18-F1-8E   (hex)		ChipER Technology co. ltd
+18F18E     (base 16)		ChipER Technology co. ltd
+				907 University Ave#299
+				Middleton  WI  53562
+				US
+
+00-04-22   (hex)		Studio Technologies, Inc
+000422     (base 16)		Studio Technologies, Inc
+				7440 Frontage Rd
+				Skokie  IL   60077-3212
+				US
+
+80-DA-13   (hex)		eero inc.
+80DA13     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+50-EC-50   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+50EC50     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+60-61-DF   (hex)		Z-meta Research LLC
+6061DF     (base 16)		Z-meta Research LLC
+				8365 Quay Drive
+				Arvada  CO  80003
+				US
+
+70-57-BF   (hex)		New H3C Technologies Co., Ltd
+7057BF     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+8C-E7-48   (hex)		Private
+8CE748     (base 16)		Private
+
+10-82-86   (hex)		Luxshare Precision Industry Co.,Ltd
+108286     (base 16)		Luxshare Precision Industry Co.,Ltd
+				2nd floor, A building, Sanyo New Industrial Area, West of Maoyi, Shajing  Baoan District
+				Shenzhen  Shenzhen  518104
+				CN
+
+14-B4-57   (hex)		Silicon Laboratories
+14B457     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+DC-96-2C   (hex)		NST Audio Ltd
+DC962C     (base 16)		NST Audio Ltd
+				32 Whitewall
+				Norton  North Yorkshire  YO17 9EH
+				GB
+
+18-02-2D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+18022D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D8-BC-59   (hex)		Shenzhen DAPU Microelectronics Co., Ltd
+D8BC59     (base 16)		Shenzhen DAPU Microelectronics Co., Ltd
+				Room B 503, No.2 Building, Tian’an Digital New Town, Huangge Middle Road, Longgang District
+				Shenzhen  Guangdong  518100
+				CN
+
+08-97-98   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+089798     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+24-6F-28   (hex)		Espressif Inc.
+246F28     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+8C-79-F5   (hex)		Samsung Electronics Co.,Ltd
+8C79F5     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+48-F8-DB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48F8DB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-12-2A   (hex)		VTech Telecommunications Ltd.
+00122A     (base 16)		VTech Telecommunications Ltd.
+				23/F, Tai Ping Industrial Centre, Block 1
+				 NA    00000
+				HK
+
+B0-51-8E   (hex)		Holl technology CO.Ltd.
+B0518E     (base 16)		Holl technology CO.Ltd.
+				F2,Bld 27,Anle Industrial Park,Nantou Guankou No.2 Road
+				Shenzhen  Guangdong  518052
+				CN
+
+28-52-E0   (hex)		Layon international Electronic & Telecom Co.,Ltd
+2852E0     (base 16)		Layon international Electronic & Telecom Co.,Ltd
+				4rd Floor, Building 15, Juda Industrial Zone, ShiBei Industrial Road, HuiJiang , Da Shi Street, PanYu District,Guangzhou,China
+				guangzhou  guangdong  511430
+				CN
+
+58-CB-52   (hex)		Google, Inc.
+58CB52     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+7C-61-66   (hex)		Amazon Technologies Inc.
+7C6166     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+98-9B-CB   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+989BCB     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+94-F7-AD   (hex)		Juniper Networks
+94F7AD     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+60-63-F9   (hex)		Ciholas, Inc.
+6063F9     (base 16)		Ciholas, Inc.
+				3700 Bell Rd
+				Newburgh  IN  47630-7907
+				US
+
+AC-8F-F8   (hex)		Nokia
+AC8FF8     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+60-03-A6   (hex)		Inteno Broadband Technology AB
+6003A6     (base 16)		Inteno Broadband Technology AB
+				Stensätravägen 13
+				Skärholmen  SE  127 39 
+				SE
+
+7C-52-59   (hex)		Sichuan Jiuzhou Electronic Technology Co., Ltd.
+7C5259     (base 16)		Sichuan Jiuzhou Electronic Technology Co., Ltd.
+				No. 259, Jiuzhou Road
+				Mianyang City  Sichuan Province  621000
+				CN
+
+44-B2-95   (hex)		Sichuan AI-Link Technology Co., Ltd.
+44B295     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+94-24-E1   (hex)		Alcatel-Lucent Enterprise
+9424E1     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Rd
+				Calabasas  CA  91301
+				US
+
+F8-CA-59   (hex)		NetComm Wireless
+F8CA59     (base 16)		NetComm Wireless
+				LEVEL 5, 18-20 ORION RD. LANE COVE
+				LANE COVE WEST  NSW  2066
+				AU
+
+88-B2-91   (hex)		Apple, Inc.
+88B291     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-2A-D0   (hex)		Apple, Inc.
+C42AD0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-D2-81   (hex)		Apple, Inc.
+CCD281     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-0D-B0   (hex)		Shenzhen Four Seas Global Link Network Technology Co., Ltd.
+200DB0     (base 16)		Shenzhen Four Seas Global Link Network Technology Co., Ltd.
+				Room 607-610, Block B, TAOJINDI Electronic Business Incubation Base
+				Tenglong Road, Longhua District,   Shenzhen Guangdong  518000
+				CN
+
+D8-1E-DD   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+D81EDD     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D4-3F-CB   (hex)		ARRIS Group, Inc.
+D43FCB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-76-95   (hex)		Technicolor CH USA Inc.
+5C7695     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+F8-4D-33   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F84D33     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+C0-8A-CD   (hex)		Guangzhou Shiyuan Electronic Technology Company Limited
+C08ACD     (base 16)		Guangzhou Shiyuan Electronic Technology Company Limited
+				No.6, 4th Yunpu Road, Yunpu industry District
+				Guangzhou  Guangdong  510530
+				CN
+
+AC-F6-F7   (hex)		LG Electronics (Mobile Communications)
+ACF6F7     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+E8-9E-0C   (hex)		Private
+E89E0C     (base 16)		Private
+
+48-E6-C0   (hex)		SIMCom Wireless Solutions Co.,Ltd.
+48E6C0     (base 16)		SIMCom Wireless Solutions Co.,Ltd.
+				Building B,SIM Technology Building,No.633,Jinzhong Road
+				Shanghai    200335
+				CN
+
+38-3C-9C   (hex)		Fujian Newland Payment Technology Co.,Ltd.
+383C9C     (base 16)		Fujian Newland Payment Technology Co.,Ltd.
+				No. B602,Building #1,Haixia Jingmao Plaza,Fuzhou Bonded Area
+				Fuzhou  Fujian  350015
+				CN
+
+C0-2E-25   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C02E25     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+10-77-17   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+107717     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+A8-6D-5F   (hex)		Raisecom Technology CO., LTD
+A86D5F     (base 16)		Raisecom Technology CO., LTD
+				No. 11, East Area, No. 10 Block, East Xibeiwang Road
+				Beijing    100094
+				CN
+
+58-EC-ED   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+58ECED     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+A4-68-BC   (hex)		Private
+A468BC     (base 16)		Private
+
+00-50-79   (hex)		Private
+005079     (base 16)		Private
+
+10-0C-6B   (hex)		NETGEAR
+100C6B     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+50-5F-B5   (hex)		Askey Computer Corp.
+505FB5     (base 16)		Askey Computer Corp.
+				10F, NO. 119, JIANKANG RD., ZHONGHE DIST.
+				NEW TAIPEI     235
+				TW
+
+C4-F0-EC   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+C4F0EC     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-0F-C8   (hex)		Universal Electronics, Inc.
+E80FC8     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+E4-5D-37   (hex)		Juniper Networks
+E45D37     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-EE-AB   (hex)		Cisco Systems, Inc
+00EEAB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+54-A7-03   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+54A703     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+90-7A-58   (hex)		Zegna-Daidong Limited
+907A58     (base 16)		Zegna-Daidong Limited
+				 Rooms 14-17, 18/F, Nan Fung Commercial, Centre 19 Lam Lok Street, Kowloon Bay
+				Hong Kong    999077
+				HK
+
+E0-09-BF   (hex)		SHENZHEN TONG BO WEI TECHNOLOGY Co.,LTD
+E009BF     (base 16)		SHENZHEN TONG BO WEI TECHNOLOGY Co.,LTD
+				5th floor building 4 pengtengda industrial，langkou community，dalang street longhua newly developed area
+				Shenzhen  GuangDong  518000
+				CN
+
+00-13-1E   (hex)		peiker acustic GmbH
+00131E     (base 16)		peiker acustic GmbH
+				Max-Planck-Strasse 28-32
+				Friedrichsdorf    61381
+				DE
+
+84-69-91   (hex)		Nokia
+846991     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-1B-F7   (hex)		Lund IP Products AB
+001BF7     (base 16)		Lund IP Products AB
+				Dalbyv. 1
+				Lund  Skåne  224 60
+				SE
+
+78-36-07   (hex)		Cermate Technologies Inc.
+783607     (base 16)		Cermate Technologies Inc.
+				7F-1, No 168 Lien-Chen Rd.
+				Chung-Ho Dist  New Taipei City  
+				TW
+
+B0-00-73   (hex)		Wistron Neweb Corporation
+B00073     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+D8-8D-C8   (hex)		Atil Technology Co., LTD
+D88DC8     (base 16)		Atil Technology Co., LTD
+				Rm. 3, 21F., No.93, Sec. 2, Roosevelt Rd.,
+				Da’an Dist., Taipei City    106
+				TW
+
+88-DE-7C   (hex)		Askey Computer Corp.
+88DE7C     (base 16)		Askey Computer Corp.
+				10F, No.119, JIANKANG RD.,ZHINGHE DIST,
+				NEW TAIPEI CITY    23585
+				TW
+
+A8-E2-C1   (hex)		Texas Instruments
+A8E2C1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+90-9A-77   (hex)		Texas Instruments
+909A77     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+04-EE-03   (hex)		Texas Instruments
+04EE03     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+4C-24-98   (hex)		Texas Instruments
+4C2498     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+7C-D9-5C   (hex)		Google, Inc.
+7CD95C     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+C8-AA-CC   (hex)		Private
+C8AACC     (base 16)		Private
+
+00-21-67   (hex)		HWA JIN T&I Corp.
+002167     (base 16)		HWA JIN T&I Corp.
+				5F., SEHWA Bldg 164-24, Poi-dong, Gangnam-gu, Seoul, Korea
+				Gangnam-gu  Seoul  135-960
+				KR
+
+00-0B-86   (hex)		Aruba, a Hewlett Packard Enterprise Company
+000B86     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+DC-31-D1   (hex)		vivo Mobile Communication Co., Ltd.
+DC31D1     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+C8-F7-50   (hex)		Dell Inc.
+C8F750     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+D4-92-34   (hex)		NEC Corporation
+D49234     (base 16)		NEC Corporation
+				7-1 Shiba 5-chome
+				Minato-Ku  Tokyo  108-8001
+				JP
+
+00-07-CB   (hex)		FREEBOX SAS
+0007CB     (base 16)		FREEBOX SAS
+				8 rue de la Ville l'Eveque
+				Paris    75008
+				FR
+
+14-9F-B6   (hex)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+149FB6     (base 16)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+				#126,BBK Road,Wusha,Chang'An
+				Dong Guan   Guang Dong  523860
+				CN
+
+00-11-5A   (hex)		Ivoclar Vivadent AG
+00115A     (base 16)		Ivoclar Vivadent AG
+				Bendererstrasse 2
+				Schaan    9494
+				LI
+
+4C-AE-A3   (hex)		Hewlett Packard Enterprise
+4CAEA3     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+1C-2E-1B   (hex)		Suzhou Tremenet Communication Technology Co., Ltd.
+1C2E1B     (base 16)		Suzhou Tremenet Communication Technology Co., Ltd.
+				Room 413, Nangong Building, 399 Linquan Street, SIP
+				Suzhou  Jiangsu  215123
+				CN
+
+1C-24-EB   (hex)		Burlywood
+1C24EB     (base 16)		Burlywood
+				1501 S Sunset Street
+				Longmont  CO  80501
+				US
+
+00-10-13   (hex)		Kontron America, Inc.
+001013     (base 16)		Kontron America, Inc.
+				14118 Stowe Drive
+				Poway,  CA  9206
+				US
+
+2C-2B-F9   (hex)		LG Innotek
+2C2BF9     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+D8-C7-C8   (hex)		Aruba, a Hewlett Packard Enterprise Company
+D8C7C8     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+70-3A-0E   (hex)		Aruba, a Hewlett Packard Enterprise Company
+703A0E     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+20-4C-03   (hex)		Aruba, a Hewlett Packard Enterprise Company
+204C03     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+58-C6-F0   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+58C6F0     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+84-A0-6E   (hex)		Sagemcom Broadband SAS
+84A06E     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+A4-3E-A0   (hex)		iComm HK LIMITED
+A43EA0     (base 16)		iComm HK LIMITED
+				Room 702 Kowloon Building 555 Nathan Road Kowloon HongKong
+				Kowloon    NA
+				HK
+
+64-C2-DE   (hex)		LG Electronics (Mobile Communications)
+64C2DE     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+8C-44-4F   (hex)		HUMAX Co., Ltd.
+8C444F     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+00-67-62   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+006762     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+2C-C4-07   (hex)		machineQ
+2CC407     (base 16)		machineQ
+				1900 market st
+				philadelphia  PA  19103
+				US
+
+B4-ED-19   (hex)		Pie Digital, Inc.
+B4ED19     (base 16)		Pie Digital, Inc.
+				575 Market st., 8th floor
+				San Francisco  CA  94105-2823
+				US
+
+40-DF-02   (hex)		LINE BIZ Plus
+40DF02     (base 16)		LINE BIZ Plus
+				Alphadom Tower IV (6F), Bundangnaegok-ro 117, Bundang-gu
+				Seongnam  Gyeonggi  13529
+				KR
+
+CC-E1-94   (hex)		Juniper Networks
+CCE194     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-02-18   (hex)		BSkyB Ltd
+900218     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+14-4E-2A   (hex)		Ciena Corporation
+144E2A     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+84-13-9F   (hex)		zte corporation
+84139F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-51-EA   (hex)		Fitbit, Inc.
+F051EA     (base 16)		Fitbit, Inc.
+				199 Fremont Street, 14th Fl
+				San Francisco  CA  94105
+				US
+
+50-33-F0   (hex)		YICHEN (SHENZHEN) TECHNOLOGY CO.LTD
+5033F0     (base 16)		YICHEN (SHENZHEN) TECHNOLOGY CO.LTD
+				23F, Building C1, Nanshan iPark, No. 1001 Xueyuan Road, Nanshan District, Shenzhen City, Guangdong, China
+				shenzhen    518044
+				CN
+
+FC-2B-B2   (hex)		Actiontec Electronics, Inc
+FC2BB2     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+E0-9F-2A   (hex)		Iton Technology Corp. 
+E09F2A     (base 16)		Iton Technology Corp. 
+				Room 1302, Block A, Building 4，Huangge Road, Longgang District
+				Shenzhen   Guangdong   518116
+				CN
+
+4C-E1-9E   (hex)		TECNO MOBILE LIMITED
+4CE19E     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+74-95-EC   (hex)		ALPS ELECTRIC CO., LTD.
+7495EC     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+AC-5A-EE   (hex)		China Mobile Group Device Co.,Ltd.
+AC5AEE     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+70-BC-10   (hex)		Microsoft Corporation
+70BC10     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+88-4A-18   (hex)		Opulinks
+884A18     (base 16)		Opulinks
+				F 28, No.328, Huashan Rd
+				Shanghai    200040
+				CN
+
+00-06-F7   (hex)		ALPS ELECTRIC CO., LTD.
+0006F7     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+00-07-04   (hex)		ALPS ELECTRIC CO., LTD.
+000704     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+00-06-F5   (hex)		ALPS ELECTRIC CO., LTD.
+0006F5     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+34-C7-31   (hex)		ALPS ELECTRIC CO., LTD.
+34C731     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+9C-69-B4   (hex)		IEEE Registration Authority
+9C69B4     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+50-00-84   (hex)		Siemens Canada
+500084     (base 16)		Siemens Canada
+				300 Applewood Crescent
+				Concord  Ontario  L4K 5C7
+				CA
+
+64-D4-BD   (hex)		ALPS ELECTRIC CO., LTD.
+64D4BD     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				KAKUDA-CITY  MIYAGI-PREF  981-1595
+				JP
+
+04-98-F3   (hex)		ALPS ELECTRIC CO., LTD.
+0498F3     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1 NISHIDA
+				KAKUDA  MIYAGI PREF  9876-8501
+				JP
+
+00-21-4F   (hex)		ALPS ELECTRIC CO., LTD.
+00214F     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+44-B4-33   (hex)		tide.co.,ltd
+44B433     (base 16)		tide.co.,ltd
+				9F Kapeul GreatValley A-dong, Digitalro 9-ghil 32, Geumcheon-gu
+				seoul  seoul  ASIKRKS006
+				KR
+
+D8-A6-FD   (hex)		Ghost Locomotion
+D8A6FD     (base 16)		Ghost Locomotion
+				800 California St.  Suite 200
+				Mountain View  CA  94041
+				US
+
+DC-21-B9   (hex)		Sentec Co.Ltd
+DC21B9     (base 16)		Sentec Co.Ltd
+				10, Baekseokgongdan 1-ro, Seobuk-gu
+				 Cheonan-si  Chungcheongnam-do  31094
+				KR
+
+6C-DF-FB   (hex)		IEEE Registration Authority
+6CDFFB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+24-7D-4D   (hex)		Texas Instruments
+247D4D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-50-F6   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+8850F6     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan Distric
+				Shenzhen  Guangdong  518055
+				CN
+
+E4-98-BB   (hex)		Phyplus Microelectronics Limited
+E498BB     (base 16)		Phyplus Microelectronics Limited
+				304 Building 1 No.608 Sheng Xia Road
+				Shanghai    200000
+				CN
+
+60-A1-1E   (hex)		Wuhan Maxsine Electric Co.,Ltd.
+60A11E     (base 16)		Wuhan Maxsine Electric Co.,Ltd.
+				Building A6, Hangyu Building, No 7, Wuhan University Science Park Road, East Lake Development District,Wuhan,China.
+				Wuhan  Hubei  430000
+				CN
+
+C4-5B-F7   (hex)		ants
+C45BF7     (base 16)		ants
+				1164-21,Haeun-daero, Haeundae-gu,
+				Busan    48069
+				KR
+
+8C-DF-9D   (hex)		NEC Corporation
+8CDF9D     (base 16)		NEC Corporation
+				7-1, Shiba 5-chome,
+				Tokyo  Tokyo  108-8001
+				JP
+
+5C-41-5A   (hex)		Amazon.com, LLC
+5C415A     (base 16)		Amazon.com, LLC
+				1200 12th Ave. South, Suite 1200
+				Seattle    98144
+				US
+
+70-5E-55   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+705E55     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+B0-D5-68   (hex)		Shenzhen Cultraview Digital Technology Co., Ltd
+B0D568     (base 16)		Shenzhen Cultraview Digital Technology Co., Ltd
+				F6,M6,Maqueling, High-tech park, Nanshan district
+				Shenzhen  Guangdong  518057
+				CN
+
+F0-0E-BF   (hex)		ZettaHash Inc.
+F00EBF     (base 16)		ZettaHash Inc.
+				6F Chiyoda Ogawamachi Crosta, 1-11, Kanda Ogawamachi
+				Chiyoda-ku  Tokyo  101-0052
+				JP
+
+70-35-09   (hex)		Cisco Systems, Inc
+703509     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-1A-FA   (hex)		New H3C Technologies Co., Ltd
+441AFA     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+04-07-2E   (hex)		VTech Electronics Ltd.
+04072E     (base 16)		VTech Electronics Ltd.
+				23rd Floor, Block 1, Tai Ping Industrial Centre, 57 Ting Kok Road
+				Tai Po, N.T.    NA
+				HK
+
+78-0E-D1   (hex)		TRUMPF Werkzeugmaschinen GmbH+Co.KG
+780ED1     (base 16)		TRUMPF Werkzeugmaschinen GmbH+Co.KG
+				Johann-Maus-Straße 2
+				Ditzingen    71254
+				DE
+
+44-EC-CE   (hex)		Juniper Networks
+44ECCE     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F8-2F-08   (hex)		Molex CMS
+F82F08     (base 16)		Molex CMS
+				2222 Wellington Court
+				Lisle  IL  60532
+				US
+
+44-1C-12   (hex)		Technicolor CH USA Inc.
+441C12     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+44-28-A3   (hex)		Jiangsu fulian  Communication Technology Co., Ltd.
+4428A3     (base 16)		Jiangsu fulian  Communication Technology Co., Ltd.
+				The south of lanling road, yongan new district
+				Danyang   Jiangsu  212300
+				CN
+
+10-C5-95   (hex)		Lenovo
+10C595     (base 16)		Lenovo
+				1009 Think Place
+				Morrisvilee  NC  27560
+				US
+
+20-32-33   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+203233     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+68-29-DC   (hex)		Ficosa Electronics S.L.U.
+6829DC     (base 16)		Ficosa Electronics S.L.U.
+				Pol.Ind Can Mitjans s/n Viladecavalls Barcelona
+				Viladecavalls  Barcelona  ES08232
+				ES
+
+94-54-DF   (hex)		YST CORP.
+9454DF     (base 16)		YST CORP.
+				A-1407, 767, Sinsu-ro, Suji-gu,
+				Yongin-si  Gyeonggi-do  16827
+				KR
+
+7C-BC-84   (hex)		IEEE Registration Authority
+7CBC84     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-0D-F1   (hex)		Sontex SA
+F80DF1     (base 16)		Sontex SA
+				rue de la gare
+				sonceboz  Bern  2605
+				CH
+
+A4-94-26   (hex)		Elgama-Elektronika Ltd.
+A49426     (base 16)		Elgama-Elektronika Ltd.
+				Visoriu str. 2
+				Vilnius    LT-08300
+				LT
+
+E4-F1-4C   (hex)		Private
+E4F14C     (base 16)		Private
+
+A8-B4-56   (hex)		Cisco Systems, Inc
+A8B456     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-A9-F0   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+2CA9F0     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+54-9B-72   (hex)		Ericsson AB
+549B72     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+A0-47-D7   (hex)		Best IT World (India) Pvt Ltd
+A047D7     (base 16)		Best IT World (India) Pvt Ltd
+				87, Mistry Complex,, Midc Cross Road A, Andheri-East
+				Mumbai  Maharashtra  400093
+				IN
+
+68-99-CD   (hex)		Cisco Systems, Inc
+6899CD     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+10-40-F3   (hex)		Apple, Inc.
+1040F3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-6B-14   (hex)		Apple, Inc.
+586B14     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-B8-63   (hex)		Apple, Inc.
+BCB863     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-1C-F6   (hex)		Alien Green LLC
+2C1CF6     (base 16)		Alien Green LLC
+				A. Kazbegi Ave., No24g, apt 227
+				Tbilisi  Tbilisi  0160
+				GE
+
+6C-2B-59   (hex)		Dell Inc.
+6C2B59     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+44-E6-6E   (hex)		Apple, Inc.
+44E66E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-E8-62   (hex)		Apple, Inc.
+C0E862     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-06-16   (hex)		Apple, Inc.
+F40616     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-FE-5D   (hex)		IEEE Registration Authority
+0CFE5D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+3C-8D-20   (hex)		Google, Inc.
+3C8D20     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+60-1D-91   (hex)		Motorola Mobility LLC, a Lenovo Company
+601D91     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+D4-C9-4B   (hex)		Motorola Mobility LLC, a Lenovo Company
+D4C94B     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+08-35-1B   (hex)		Shenzhen Jialihua Electronic Technology Co., Ltd
+08351B     (base 16)		Shenzhen Jialihua Electronic Technology Co., Ltd
+				Building 26,Xin'e Industrial Area,E'gongling Village,Pinghu Town,Longgang District
+				Shenzhen  Guangdong  518111
+				CN
+
+AC-15-85   (hex)		silergy corp
+AC1585     (base 16)		silergy corp
+				Oleander  Way，802 West  Bay  Road，P.O. BOX    32052
+				Grand   Cayman  KYI-1208，Cayman Islands    32052
+				US
+
+AC-50-93   (hex)		Magna Electronics Europe GmbH & Co. OHG
+AC5093     (base 16)		Magna Electronics Europe GmbH & Co. OHG
+				Kurfürst-Eppstein-Ring 9
+				Sailauf  Bavaria  63877
+				DE
+
+70-BB-E9   (hex)		Xiaomi Communications Co Ltd
+70BBE9     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+50-A0-A4   (hex)		Nokia
+50A0A4     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-D0-2D   (hex)		Resideo
+00D02D     (base 16)		Resideo
+				2 Corporate Center Dr.
+				Melville  NY  11747
+				US
+
+80-69-40   (hex)		LEXAR CO.,LIMITED
+806940     (base 16)		LEXAR CO.,LIMITED
+				10TH FLOOR,CHINA AEROSPACE CENTRE,143 HOI BUN ROAD,KWUN TONG,KOWLOON, HONG KONG
+				HONG KONG    999077
+				HK
+
+64-F8-1C   (hex)		Huawei Technologies Co., Ltd.
+64F81C     (base 16)		Huawei Technologies Co., Ltd.
+				 Bantian, Longgang District, Shenzhen, 518129, P.R.C
+				Shenzhen  GUANGDONG Province  518000
+				CN
+
+10-98-C3   (hex)		Murata Manufacturing Co., Ltd.
+1098C3     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+9C-C8-FC   (hex)		ARRIS Group, Inc.
+9CC8FC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+B0-7E-11   (hex)		Texas Instruments
+B07E11     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+10-C7-53   (hex)		Qingdao Intelligent&Precise Electronics Co.,Ltd.
+10C753     (base 16)		Qingdao Intelligent&Precise Electronics Co.,Ltd.
+				No.218 Qianwangang Road
+				Qingdao  Shangdong  266510
+				CN
+
+F4-95-1B   (hex)		Hefei Radio Communication Technology Co., Ltd 
+F4951B     (base 16)		Hefei Radio Communication Technology Co., Ltd 
+				 No.108, YinXing Road, High-tech Development Zone 
+				Hefei  Anhui  230088
+				CN
+
+6C-38-45   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+6C3845     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+2C-61-04   (hex)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+2C6104     (base 16)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+				ORIENTAL CYBERPORT, HIGHTECH 6 ROAD
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+BC-93-25   (hex)		Ningbo Joyson Preh Car Connect Co.,Ltd.  
+BC9325     (base 16)		Ningbo Joyson Preh Car Connect Co.,Ltd.  
+				No. 99, Qingyi Road
+				Ningbo   Zhejiang  315040
+				CN
+
+D0-B6-0A   (hex)		Xingluo Technology Company  Limited
+D0B60A     (base 16)		Xingluo Technology Company  Limited
+				28F, Building A, Aerospace Science And Technology Square, Nanshan District
+				ShenZhen  GuangDong   518067
+				CN
+
+04-92-26   (hex)		ASUSTek COMPUTER INC.
+049226     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+E8-AD-A6   (hex)		Sagemcom Broadband SAS
+E8ADA6     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+0C-1C-19   (hex)		LONGCONN ELECTRONICS(SHENZHEN) CO.,LTD
+0C1C19     (base 16)		LONGCONN ELECTRONICS(SHENZHEN) CO.,LTD
+				Building B, No. 42 Xingye Road, Phoenix First Industrial Zone, Fuyong, Baoan District
+				Shenzhen  Guangdong  518103
+				CN
+
+90-E7-10   (hex)		New H3C Technologies Co., Ltd
+90E710     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+30-29-52   (hex)		Hillstone Networks Inc
+302952     (base 16)		Hillstone Networks Inc
+				North Olympic Science & Technology Park Building #20， Floor #5, SouthBaosheng
+				Beijing    100192
+				CN
+
+E0-13-B5   (hex)		vivo Mobile Communication Co., Ltd.
+E013B5     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+E0-79-5E   (hex)		Wuxi Xiaohu Technology Co.,Ltd.
+E0795E     (base 16)		Wuxi Xiaohu Technology Co.,Ltd.
+				FL.2, Building A10, 777 West Jianzhu Road, Binhu District
+				Wuxi  Jiangsu Province  214000
+				CN
+
+00-B1-E3   (hex)		Cisco Systems, Inc
+00B1E3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-11-94   (hex)		Lenovo
+A41194     (base 16)		Lenovo
+				1009 Think Place
+				Morrisvilee  NC  27560
+				US
+
+00-CB-00   (hex)		Private
+00CB00     (base 16)		Private
+
+DC-F4-01   (hex)		Dell Inc.
+DCF401     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+0C-41-01   (hex)		Ruichi Auto Technology (Guangzhou) Co., Ltd.
+0C4101     (base 16)		Ruichi Auto Technology (Guangzhou) Co., Ltd.
+				No. 171 Haibin Road, Nansha District, Guangzhou, China
+				Guangzhou  Guangdong Province  511400
+				CN
+
+00-B7-71   (hex)		Cisco Systems, Inc
+00B771     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E4-B2-FB   (hex)		Apple, Inc.
+E4B2FB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-CA-0C   (hex)		WITHUS PLANET
+2CCA0C     (base 16)		WITHUS PLANET
+				1604, O'BIZTOWER, Pyeong Chon, 126, Beolmal-ro, Dongan-gu
+				Anyang-si  Gyeonggi-do  14057
+				KR
+
+84-32-6F   (hex)		GUANGZHOU AVA ELECTRONICS TECHNOLOGY CO.,LTD 
+84326F     (base 16)		GUANGZHOU AVA ELECTRONICS TECHNOLOGY CO.,LTD 
+				Science town luogang district guangzhou city branch bead road 232 profit people park 301, building 2
+				guangzhou   guangdong  510000
+				CN
+
+C8-9C-13   (hex)		Inspiremobile
+C89C13     (base 16)		Inspiremobile
+				Rm1412, Daeryung Techno-Town, 15th, 401 , Simin-daero, Dongan-gu
+				Anyang-si  Gyeonggi-do  14057
+				KR
+
+8C-85-E6   (hex)		Cleondris GmbH
+8C85E6     (base 16)		Cleondris GmbH
+				Zuercherstrasse 42
+				Uitikon  ZH  8142
+				CH
+
+80-7D-14   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+807D14     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-28-3E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20283E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-FC-77   (hex)		Mega Well Limited
+A4FC77     (base 16)		Mega Well Limited
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+4C-56-9D   (hex)		Apple, Inc.
+4C569D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-53-9C   (hex)		Apple, Inc.
+38539C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-26-19   (hex)		Apple, Inc.
+402619     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-E8-5C   (hex)		Apple, Inc.
+6CE85C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-91-62   (hex)		Microchip Technology Inc.
+049162     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+F8-38-80   (hex)		Apple, Inc.
+F83880     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-79-D7   (hex)		Sagemcom Broadband SAS
+2C79D7     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-B4-F5   (hex)		DongGuan Siyoto Electronics Co., Ltd       
+00B4F5     (base 16)		DongGuan Siyoto Electronics Co., Ltd       
+				Hecheng Industrial District, QiaoTou Town
+				DongGuan City  Guangdong  523520
+				CN
+
+BC-3F-4E   (hex)		Teleepoch Ltd
+BC3F4E     (base 16)		Teleepoch Ltd
+				No.13 Langshan Rd,HiTech Park,Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+18-38-AE   (hex)		CONSPIN SOLUTION
+1838AE     (base 16)		CONSPIN SOLUTION
+				2F, Geonwoong Bldg. 109, Gwanak-ro, Gwanak-gu
+				Seoul    08833
+				KR
+
+04-CF-8C   (hex)		XIAOMI Electronics,CO.,LTD
+04CF8C     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+0C-75-12   (hex)		Shenzhen Kunlun TongTai Technology  Co.,Ltd.
+0C7512     (base 16)		Shenzhen Kunlun TongTai Technology  Co.,Ltd.
+				Room 2401,B,Building 3,Tianan Yungu Industry Park,Gangtou community,bantian streets,Longgang District
+				Shenzhen  Guangdong  518129
+				CN
+
+74-83-C2   (hex)		Ubiquiti Networks Inc.
+7483C2     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+E0-63-DA   (hex)		Ubiquiti Networks Inc.
+E063DA     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+50-57-9C   (hex)		Seiko Epson Corporation
+50579C     (base 16)		Seiko Epson Corporation
+				2070 Kotobuki Koaka
+				Matsumoto-shi  Nagano-ken  399-8702
+				JP
+
+54-27-8D   (hex)		NXP (China) Management Ltd.
+54278D     (base 16)		NXP (China) Management Ltd.
+				21F, BM InterContinental Business Center, 100 Yu Tong Road
+				Shanghai  Shanghai  200070
+				CN
+
+B0-BE-76   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B0BE76     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+44-47-CC   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+4447CC     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+4C-D9-8F   (hex)		Dell Inc.
+4CD98F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+B0-AE-25   (hex)		Varikorea
+B0AE25     (base 16)		Varikorea
+				#505 kolon digital tower aston, gasan, geumcheon
+				seoul    08502
+				KR
+
+4C-1B-86   (hex)		Arcadyan Corporation
+4C1B86     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+EC-C4-0D   (hex)		Nintendo Co.,Ltd
+ECC40D     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+44-00-49   (hex)		Amazon Technologies Inc.
+440049     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+E8-6A-64   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+E86A64     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+10-A2-4E   (hex)		GOLD3LINK ELECTRONICS CO., LTD
+10A24E     (base 16)		GOLD3LINK ELECTRONICS CO., LTD
+				No.90,Sec.1,Com Lin Rd,Taipei 114,Taiwan,R.O.C
+				Taipei  Taiwan  114
+				TW
+
+CC-C5-E5   (hex)		Dell Inc.
+CCC5E5     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+6C-C3-74   (hex)		Texas Instruments
+6CC374     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+68-47-49   (hex)		Texas Instruments
+684749     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F8-D9-B8   (hex)		Open Mesh, Inc.
+F8D9B8     (base 16)		Open Mesh, Inc.
+				111 SW 5th Ave Ste1150
+				Portland  OR  97204
+				US
+
+7C-69-6B   (hex)		Atmosic Technologies
+7C696B     (base 16)		Atmosic Technologies
+				12930 Saratoga Ave, Suite B6
+				Saratoga  CA  95070
+				US
+
+5C-D2-0B   (hex)		Yytek Co., Ltd.
+5CD20B     (base 16)		Yytek Co., Ltd.
+				No.1 Bao Sheng South Road, Room 401, Ao Bei Technology Park, Ling Zhi Center
+				Beijing    100192
+				CN
+
+70-03-7E   (hex)		Technicolor CH USA Inc.
+70037E     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+D0-03-DF   (hex)		Samsung Electronics Co.,Ltd
+D003DF     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+C4-23-A2   (hex)		PT. Emsonic Indonesia
+C423A2     (base 16)		PT. Emsonic Indonesia
+				Jl.Timor Blok E5, MM2100 Industrial Town Jatiwangi Cikarang Barat
+				Bekasi  Jawa Barat  17530
+				ID
+
+B4-CB-57   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B4CB57     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+4C-12-65   (hex)		ARRIS Group, Inc.
+4C1265     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-50-0C   (hex)		e-Tek Labs, Inc.
+00500C     (base 16)		e-Tek Labs, Inc.
+				1057 EAST HENRIETTA RD.
+				ROCHESTER  NY  14623
+				US
+
+48-5F-99   (hex)		Cloud Network Technology (Samoa) Limited
+485F99     (base 16)		Cloud Network Technology (Samoa) Limited
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+88-34-FE   (hex)		Bosch Automotive Products (Suzhou) Co. Ltd
+8834FE     (base 16)		Bosch Automotive Products (Suzhou) Co. Ltd
+				No. 455 Xing Long Street,Suzhou Industrial Park,Suzhou P.R., 215021 China
+				Suzhou  Jiangsu  215021
+				CN
+
+88-F7-BF   (hex)		vivo Mobile Communication Co., Ltd.
+88F7BF     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+D8-7D-7F   (hex)		Sagemcom Broadband SAS
+D87D7F     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-05-1A   (hex)		3COM EUROPE LTD
+00051A     (base 16)		3COM EUROPE LTD
+				3COM CENTRE
+				vvvvv  UNITED  KINGDOM
+				GB
+
+08-00-4E   (hex)		3COM EUROPE LTD
+08004E     (base 16)		3COM EUROPE LTD
+				3COM CENTRE
+				vvvvv  UNITED  KINGDOM
+				GB
+
+00-30-1E   (hex)		3COM EUROPE LTD
+00301E     (base 16)		3COM EUROPE LTD
+				BOUNDARY WAY
+				vvvvv  UNITED  KINGDOM
+				GB
+
+00-50-04   (hex)		3COM
+005004     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-01-03   (hex)		3COM
+000103     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+58-B5-68   (hex)		SECURITAS DIRECT ESPAÑA, SAU
+58B568     (base 16)		SECURITAS DIRECT ESPAÑA, SAU
+				C/ Priégola, 2
+				Pozuelo de Alarcon  Madrid  28224
+				ES
+
+48-4A-E9   (hex)		Hewlett Packard Enterprise
+484AE9     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+84-6A-66   (hex)		Sumitomo Kizai  Co.,Ltd.
+846A66     (base 16)		Sumitomo Kizai  Co.,Ltd.
+				1-45-1higashiikebukuro
+				tosimaku  tokyo  170-0013
+				JP
+
+18-D7-17   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+18D717     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+80-B6-24   (hex)		IVS
+80B624     (base 16)		IVS
+				807-809 , Woorim E-biz center, 35, Gwangnaru-ro 6-gil
+				Seoul  Seongdong-gu  04799
+				KR
+
+DC-F5-05   (hex)		AzureWave Technology Inc.
+DCF505     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+CC-F0-FD   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+CCF0FD     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District, Hangzhou, Zhejiang
+				Hangzhou  Zhejiang  310000
+				CN
+
+84-89-EC   (hex)		IEEE Registration Authority
+8489EC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+88-10-8F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88108F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-63-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4631F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-9B-4F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A49B4F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-07-3A   (hex)		INVENTEL
+00073A     (base 16)		INVENTEL
+				35, rue Toumefort
+				000    0000
+				FR
+
+00-26-6C   (hex)		INVENTEC CORPORATION
+00266C     (base 16)		INVENTEC CORPORATION
+				Inventec Building, 66 Hou-Kang Street Shih-Lin District,
+				Taipei    111
+				TW
+
+00-8C-FA   (hex)		INVENTEC CORPORATION
+008CFA     (base 16)		INVENTEC CORPORATION
+				No. 255, Jen-Ho Road Sec. 2, 33547,
+				Tachi  Taoyuan  33547
+				TW
+
+5C-FB-7C   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+5CFB7C     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+FC-03-9F   (hex)		Samsung Electronics Co.,Ltd
+FC039F     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+02-C0-8C   (hex)		3COM
+02C08C     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-57-C1   (hex)		LG Electronics (Mobile Communications)
+0057C1     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+7C-24-0C   (hex)		Telechips, Inc.
+7C240C     (base 16)		Telechips, Inc.
+				19F~23F,Luther Bldg.42, Olympic-ro 35da-gil, Songpa-gu,
+				Seoul  Seoul  05510
+				KR
+
+00-20-3D   (hex)		Honeywell Environmental & Combustion Controls
+00203D     (base 16)		Honeywell Environmental & Combustion Controls
+				1985 Douglas Drive
+				Golden Valley  MN  55422
+				US
+
+00-40-84   (hex)		Honeywell International HPS
+004084     (base 16)		Honeywell International HPS
+				consolidation
+				Fort Washington  PA  19034
+				US
+
+A4-D9-90   (hex)		Samsung Electronics Co.,Ltd
+A4D990     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-60-87   (hex)		KANSAI ELECTRIC CO., LTD.
+006087     (base 16)		KANSAI ELECTRIC CO., LTD.
+				6-14-9 MIDORII, ASAMINAMI-KU
+				HIROSHIMA 731-01    
+				JO
+
+DC-F7-19   (hex)		Cisco Systems, Inc
+DCF719     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-95-0C   (hex)		China Mobile IOT Company Limited
+A0950C     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+D4-74-1B   (hex)		Beijing HuaDa ZhiBao Electronic System Co.,Ltd.
+D4741B     (base 16)		Beijing HuaDa ZhiBao Electronic System Co.,Ltd.
+				No.1 Gaojiayuan,Chaoyang District,Beijing,China
+				Beijing  Beijing  100015
+				CN
+
+00-1B-C0   (hex)		Juniper Networks
+001BC0     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+2C-15-E1   (hex)		Phicomm (Shanghai) Co., Ltd.
+2C15E1     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+30-D1-6B   (hex)		Liteon Technology Corporation
+30D16B     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+98-AE-71   (hex)		VVDN Technologies Pvt Ltd
+98AE71     (base 16)		VVDN Technologies Pvt Ltd
+				B-22, Sec-34 , Info-city -I
+				Gurugram  Haryana  122001
+				IN
+
+A4-56-CC   (hex)		Technicolor CH USA Inc.
+A456CC     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+AC-6E-1A   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+AC6E1A     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				B116,B118,A211-A213,B201-B213,A311-A313,B411-413,BF08-09 Nanshan Medical Instrument Industry Park,
+				Shenzhen  Guangdong  518067
+				CN
+
+00-80-EB   (hex)		COMPCONTROL B.V.
+0080EB     (base 16)		COMPCONTROL B.V.
+				STRATUMSED K31
+				  THE  
+				NL
+
+00-02-EB   (hex)		Pico Communications
+0002EB     (base 16)		Pico Communications
+				20085 Stevens Creek Blvd.
+				Cupertino  CA  95014
+				US
+
+34-2E-B6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+342EB6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-92-32   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC9232     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-0F-B0   (hex)		Compal Electronics INC.
+000FB0     (base 16)		Compal Electronics INC.
+				No.8 , Nandong Road , PingZhen Dist.
+				Taoyuan   Taiwan   32455
+				TW
+
+00-02-3F   (hex)		Compal Electronics INC.
+00023F     (base 16)		Compal Electronics INC.
+				No.8 , Nandong Road , PingZhen Dist.
+				Taoyuan   Taiwan   32455
+				TW
+
+68-A8-E1   (hex)		Wacom Co.,Ltd.
+68A8E1     (base 16)		Wacom Co.,Ltd.
+				Sumitomo Fudosan Shinjuku Grand Tower 31F,8-17-1
+				Nishi-shinjuku,Shinjuku-ku  Tokyo  160-6131
+				JP
+
+30-D3-2D   (hex)		devolo AG
+30D32D     (base 16)		devolo AG
+				Charlottenburger Allee 67
+				Aachen  NRW  52068
+				DE
+
+BC-F2-AF   (hex)		devolo AG
+BCF2AF     (base 16)		devolo AG
+				Charlottenburger Allee 67
+				Aachen  NRW  52068
+				DE
+
+E0-AF-4F   (hex)		Deutsche Telekom AG
+E0AF4F     (base 16)		Deutsche Telekom AG
+				Friedrich-Ebert-Allee 140
+				Bonn    53113
+				DE
+
+B8-69-F4   (hex)		Routerboard.com
+B869F4     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+28-3A-4D   (hex)		Cloud Network Technology (Samoa) Limited
+283A4D     (base 16)		Cloud Network Technology (Samoa) Limited
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+B8-7C-6F   (hex)		NXP (China) Management Ltd.
+B87C6F     (base 16)		NXP (China) Management Ltd.
+				21F, BM InterContinental Business Center, 100 Yu Tong Road
+				Shanghai  Shanghai  200070
+				CN
+
+30-5D-A6   (hex)		ADVALY SYSTEM Inc.
+305DA6     (base 16)		ADVALY SYSTEM Inc.
+				7 KITA2 NISHI2 CYUO-KU
+				SAPPORO  HOKKAIDO  060-0002
+				JP
+
+BC-30-D9   (hex)		Arcadyan Corporation
+BC30D9     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+04-79-B7   (hex)		Texas Instruments
+0479B7     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+C0-D0-FF   (hex)		China Mobile IOT Company Limited
+C0D0FF     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+88-DF-9E   (hex)		New H3C Technologies Co., Ltd
+88DF9E     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+2C-7C-E4   (hex)		Wuhan Tianyu Information Industry Co., Ltd.
+2C7CE4     (base 16)		Wuhan Tianyu Information Industry Co., Ltd.
+				HUST Industry Park, East-Lake Development Zone
+				Wuhan  Hubei  430223
+				CN
+
+58-03-FB   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+5803FB     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+14-48-02   (hex)		THE YEOLRIM Co.,Ltd.
+144802     (base 16)		THE YEOLRIM Co.,Ltd.
+				D-311,H Business Park,26,Beobwon-ro 9-gil Songpa-gu,Seoul Korea
+				Seoul    05836
+				KR
+
+FC-4A-E9   (hex)		Castlenet Technology Inc.
+FC4AE9     (base 16)		Castlenet Technology Inc.
+				No.64, Chung-Shan Rd.
+				New Taipei City    23680
+				TW
+
+40-31-3C   (hex)		XIAOMI Electronics,CO.,LTD
+40313C     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+FC-45-96   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+FC4596     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				 NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZON
+				KUNSHAN  SUZHOU  215300
+				CN
+
+A0-E5-34   (hex)		Stratec Biomedical AG
+A0E534     (base 16)		Stratec Biomedical AG
+				Gewerbestrasse 37
+				Birkenfeld  Baden Wuertemberg  75217
+				DE
+
+44-4B-5D   (hex)		GE Healthcare
+444B5D     (base 16)		GE Healthcare
+				Kuortaneenkatu 2
+				Helsinki    00510
+				FI
+
+00-15-55   (hex)		DFM GmbH
+001555     (base 16)		DFM GmbH
+				Lahrer Strasse 6
+				Lahr  Baden-Württemberg  77933
+				US
+
+1C-75-08   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+1C7508     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU   215300 
+				CN
+
+00-1B-38   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+001B38     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD AVENUE
+				KUNSHAN CITY  SUZHOU PROVINCE  215300
+				CN
+
+00-23-5A   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+00235A     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO 25, The 3rd street,
+				KuanShan  SUZHOU  215300
+				CN
+
+24-D7-6B   (hex)		Syntronic AB
+24D76B     (base 16)		Syntronic AB
+				Utmarksvägen 33c
+				Gävle    80291
+				SE
+
+C4-FE-E2   (hex)		AMICCOM Electronics Corporation
+C4FEE2     (base 16)		AMICCOM Electronics Corporation
+				10F, No.18, Taiyuan St., Zhubei City
+				Hsinchu Country  Taiwan  30265
+				TW
+
+78-0C-F0   (hex)		Cisco Systems, Inc
+780CF0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+0C-8C-24   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+0C8C24     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+8C-6D-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C6D77     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-C5-7A   (hex)		Ufispace Co., LTD.
+E8C57A     (base 16)		Ufispace Co., LTD.
+				9F., No. 81 Jhongcheng Rd., Tucheng Dist.,
+				New Taipei    23674
+				TW
+
+E0-12-83   (hex)		 Shenzhen Fanzhuo Communication Technology Co., Lt
+E01283     (base 16)		 Shenzhen Fanzhuo Communication Technology Co., Lt
+				 No.1003 Kesi Road, Hi-Tech Park, 
+				Shenzhen  Nanshan District  2602-2603
+				CN
+
+A0-CF-5B   (hex)		Cisco Systems, Inc
+A0CF5B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-21   (hex)		MICRO-STAR INT'L CO., LTD.
+002421     (base 16)		MICRO-STAR INT'L CO., LTD.
+				No.69, Li-De St
+				Taipei Hsien    235
+				TW
+
+00-60-D1   (hex)		CASCADE COMMUNICATIONS
+0060D1     (base 16)		CASCADE COMMUNICATIONS
+				6 TECHNOLOGY PARK DRIVE
+				WESTFORD  MA  01886
+				US
+
+84-C9-C6   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+84C9C6     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+88-B6-6B   (hex)		easynetworks
+88B66B     (base 16)		easynetworks
+				 Rd kaituo 1# kaituohuiyuan B 1020, shangdi
+				Beijing    100084
+				CN
+
+24-F5-7E   (hex)		HWH CO., LTD.
+24F57E     (base 16)		HWH CO., LTD.
+				102-708, Digital Empire2, Sin-dong, Youngtong-gu
+				Suwon-si  Gyeonggi-do  443-734
+				KR
+
+8C-A0-48   (hex)		Beijing NeTopChip Technology Co.,LTD
+8CA048     (base 16)		Beijing NeTopChip Technology Co.,LTD
+				309,Intergration Building Olympic Center, No.1 An Ding Road,Chao Yang District,, 
+				Beijing    100029
+				CN
+
+24-D3-F2   (hex)		zte corporation
+24D3F2     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-69-A5   (hex)		Miura Systems Ltd.
+D469A5     (base 16)		Miura Systems Ltd.
+				Axis 40, Oxford Road, Stokenchurch
+				High Wycombe  Buckinghamshire  HP143SX
+				GB
+
+8C-81-26   (hex)		ARCOM
+8C8126     (base 16)		ARCOM
+				ZAC de la Loyère
+				FRAGNES LA LOYERE    71530
+				FR
+
+D4-7C-44   (hex)		IEEE Registration Authority
+D47C44     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-5E-4F   (hex)		FN-LINK TECHNOLOGY LIMITED
+805E4F     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+84-17-EF   (hex)		Technicolor CH USA Inc.
+8417EF     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+38-56-B5   (hex)		Peerbridge Health Inc
+3856B5     (base 16)		Peerbridge Health Inc
+				3 Columbus Circle 15th Fl
+				New York  NY  10019
+				US
+
+7C-96-D2   (hex)		Fihonest communication co.,Ltd
+7C96D2     (base 16)		Fihonest communication co.,Ltd
+				The Frist Building ,ShangKeng Industrial Zone,  Changping Town
+				Dongguan  Guangdong  523560
+				CN
+
+C0-42-D0   (hex)		Juniper Networks
+C042D0     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+D0-C5-D8   (hex)		LATECOERE
+D0C5D8     (base 16)		LATECOERE
+				135 Rue de Périole, BP25211
+				Toulouse Cedex 5  31 Haute-Garonne  31079
+				FR
+
+70-54-B4   (hex)		Vestel Elektronik San ve Tic. A.Ş.
+7054B4     (base 16)		Vestel Elektronik San ve Tic. A.Ş.
+				Organize san
+				Manisa  Turket  45030
+				TR
+
+20-A6-0C   (hex)		Xiaomi Communications Co Ltd
+20A60C     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+48-8A-D2   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+488AD2     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+DC-E8-38   (hex)		CK Telecom (Shenzhen) Limited
+DCE838     (base 16)		CK Telecom (Shenzhen) Limited
+				Floor 9th, Building 4C,Software Industry Base, Xuefu Road, Hi-Tech Park, Nanshan Dist.
+				Shenzhen  Guangdong  518057
+				CN
+
+A8-D4-98   (hex)		Avira Operations GmbH & Co. KG
+A8D498     (base 16)		Avira Operations GmbH & Co. KG
+				Kaplaneiweg 1
+				Tettnang  Baden-Wuerttermberg  88069
+				DE
+
+50-59-67   (hex)		Intent Solutions Inc
+505967     (base 16)		Intent Solutions Inc
+				730 Peachtree St NE, Suite 550
+				ATLANTA  GA  30308
+				US
+
+00-06-80   (hex)		Card Access, Inc.
+000680     (base 16)		Card Access, Inc.
+				11778 S. Election Rd
+				Salt Lake City  UT  80420
+				US
+
+3C-57-6C   (hex)		Samsung Electronics Co.,Ltd
+3C576C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+84-17-66   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+841766     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road,Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Wei Fang  Shan Dong  
+				CN
+
+2C-4D-79   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+2C4D79     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				No.268 Dongfang Road
+				Weifang  Shandong  261000
+				CN
+
+00-0C-42   (hex)		Routerboard.com
+000C42     (base 16)		Routerboard.com
+				Pernavas 46
+				Riga    LV-1009
+				LV
+
+00-26-BD   (hex)		JTEC Card &amp; Communication Co., Ltd
+0026BD     (base 16)		JTEC Card &amp; Communication Co., Ltd
+				Dabo Bldg, 4F, 61-1, Gyesu-dong, Sosa-gu
+				Bucheon  Gyunggi-do  422-070
+				KR
+
+60-D0-2C   (hex)		Ruckus Wireless
+60D02C     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+D0-58-FC   (hex)		BSkyB Ltd
+D058FC     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+14-57-9F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14579F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-43-26   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B44326     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-AB-18   (hex)		ELECOM CO.,LTD.
+04AB18     (base 16)		ELECOM CO.,LTD.
+				11F Tokyubancho Bldg. 6-2,
+				Chiyoda-ku  Tokyo  102-0081
+				JP
+
+78-D2-94   (hex)		NETGEAR
+78D294     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+70-9F-A9   (hex)		TECNO MOBILE LIMITED
+709FA9     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+0C-01-DB   (hex)		Infinix mobility limited
+0C01DB     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+08-C5-E1   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+08C5E1     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+18-66-C7   (hex)		Shenzhen Libre Technology Co., Ltd
+1866C7     (base 16)		Shenzhen Libre Technology Co., Ltd
+				634, Tian Hui Building #B, You Song Lu, Long Hua District
+				Shenzhen    511700
+				CN
+
+5C-B3-F6   (hex)		Human, Incorporated
+5CB3F6     (base 16)		Human, Incorporated
+				3100 Airport Way S, 25-512
+				Seattle  WA  98134
+				US
+
+2C-48-35   (hex)		IEEE Registration Authority
+2C4835     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+48-2A-E3   (hex)		Wistron InfoComm(Kunshan)Co.,Ltd.
+482AE3     (base 16)		Wistron InfoComm(Kunshan)Co.,Ltd.
+				168# First Avenue,Kunshan Integrated Free Trade Zone,Kunshan,Jiangsu,China
+				Kunshan  Jiangsu  215300
+				CN
+
+FC-A6-CD   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+FCA6CD     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+44-C8-74   (hex)		China Mobile Group Device Co.,Ltd.
+44C874     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+74-C1-4F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+74C14F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-EB-57   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B0EB57     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-69-DA   (hex)		China Mobile Group Device Co.,Ltd.
+1869DA     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+F8-5C-4D   (hex)		Nokia
+F85C4D     (base 16)		Nokia
+				1 Robbins Road
+				Westford  MA  01886-4113
+				US
+
+2C-58-4F   (hex)		ARRIS Group, Inc.
+2C584F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F0-4B-3A   (hex)		Juniper Networks
+F04B3A     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+54-BF-64   (hex)		Dell Inc.
+54BF64     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+A8-5B-6C   (hex)		Robert Bosch Gmbh, CM-CI2
+A85B6C     (base 16)		Robert Bosch Gmbh, CM-CI2
+				Renningen
+				Stuttgart    D-70465 
+				DE
+
+C8-B1-EE   (hex)		Qorvo
+C8B1EE     (base 16)		Qorvo
+				1 Changi Business Park Crescent, Avenue 1, #04-01
+				NA    486058
+				SG
+
+00-FC-BA   (hex)		Cisco Systems, Inc
+00FCBA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-CB-B4   (hex)		SHENZHEN ATEKO PHOTOELECTRICITY CO.,LTD
+00CBB4     (base 16)		SHENZHEN ATEKO PHOTOELECTRICITY CO.,LTD
+				4-5F,E1 Building,TCL International E City,No.1001 Zhongshanyuan Road,Nanshan District,Shenzhen
+				SHENZHEN  GUANGDONG  518052
+				CN
+
+4C-C0-0A   (hex)		vivo Mobile Communication Co., Ltd.
+4CC00A     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+9C-E8-2B   (hex)		vivo Mobile Communication Co., Ltd.
+9CE82B     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+70-79-B3   (hex)		Cisco Systems, Inc
+7079B3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-18-D3   (hex)		Juniper Networks
+D818D3     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+14-9B-2F   (hex)		JiangSu ZhongXie Intelligent Technology co., LTD
+149B2F     (base 16)		JiangSu ZhongXie Intelligent Technology co., LTD
+				Room 201,building 15, 16,FengJi set avenue (C08),YuHua district economic development zone ,NanJing city,JiangSu province,China,PRC.
+				NanJing   JiangSu   210000
+				CN
+
+38-35-FB   (hex)		Sagemcom Broadband SAS
+3835FB     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+48-DD-9D   (hex)		ITEL MOBILE LIMITED
+48DD9D     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+A0-75-EA   (hex)		BoxLock, Inc.
+A075EA     (base 16)		BoxLock, Inc.
+				931 Monroe Dr Ste A 102-405
+				Atlanta  GA  30308
+				US
+
+F0-4C-D5   (hex)		Maxlinear, Inc
+F04CD5     (base 16)		Maxlinear, Inc
+				5966 La Place Ct. Ste# 100
+				Carlsbad  CA  92008
+				US
+
+00-01-AE   (hex)		Trex Enterprises
+0001AE     (base 16)		Trex Enterprises
+				590 Lipoa Parkway
+				Kihei  HI  96753
+				US
+
+00-E0-09   (hex)		Stratus Technologies
+00E009     (base 16)		Stratus Technologies
+				5 Mill and Main Place, Suite 500
+				Maynard  MA  01754
+				US
+
+E4-EA-83   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+E4EA83     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+74-EC-42   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+74EC42     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D4-FC-13   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D4FC13     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+80-7D-3A   (hex)		Espressif Inc.
+807D3A     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+EC-AF-97   (hex)		GIT
+ECAF97     (base 16)		GIT
+				05655, GIT Bldg., 87, Macheon-ro, Songpa-gu, Seoul, Korea
+				Songpa-gu  Seoul  05655
+				KR
+
+A0-B0-45   (hex)		Halong Mining
+A0B045     (base 16)		Halong Mining
+				13/F TCL Tower,  No.8 Tai Chung Road 
+				Tsuen Wan New Territories    Tsuen Wan New Territories
+				HK
+
+E0-BA-B4   (hex)		Arrcus, Inc
+E0BAB4     (base 16)		Arrcus, Inc
+				2077 Gateway Pl, Suite 250,
+				San Jose  CA  95110
+				US
+
+58-9B-0B   (hex)		Shineway Technologies, Inc.
+589B0B     (base 16)		Shineway Technologies, Inc.
+				Floor 5, Huanxing Building
+				Beijing    100191
+				CN
+
+D8-16-0A   (hex)		Nippon Electro-Sensory Devices
+D8160A     (base 16)		Nippon Electro-Sensory Devices
+				Itachibori 2-5-12
+				Nishi-ku  Osaka  550-0012
+				JP
+
+10-C0-7C   (hex)		Blu-ray Disc Association
+10C07C     (base 16)		Blu-ray Disc Association
+				4444 Riverside Drive #103
+				Burbank  California  91505
+				US
+
+40-A6-77   (hex)		Juniper Networks
+40A677     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+E4-B0-21   (hex)		Samsung Electronics Co.,Ltd
+E4B021     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-7F-57   (hex)		UNIC Memory Technology Co Ltd
+9C7F57     (base 16)		UNIC Memory Technology Co Ltd
+				15/F, Building B, Truth Plaza, No.7 Zhichun Road
+				Beijing  Haidian District  102208
+				CN
+
+B4-E0-1D   (hex)		CONCEPTION ELECTRONIQUE
+B4E01D     (base 16)		CONCEPTION ELECTRONIQUE
+				3 boulevard de l'europe
+				NEUFCHATEL EN BRAY    76270
+				FR
+
+1C-00-42   (hex)		NARI Technology Co., Ltd.
+1C0042     (base 16)		NARI Technology Co., Ltd.
+				NO.19 Chengxin Avenue, Nanjing
+				Nanjing    211106
+				CN
+
+44-34-A7   (hex)		ARRIS Group, Inc.
+4434A7     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-E1-A1   (hex)		Universal Global Scientific Industrial Co., Ltd.
+3CE1A1     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Road, Sec.1,Tsao Tuen
+				Nan-Tou  Taiwan  54261
+				TW
+
+F8-98-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F898EF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-F9-87   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+58F987     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-F5-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A8F5AC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-BA-D4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+58BAD4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-1D-08   (hex)		99IOT Shenzhen co.,ltd
+701D08     (base 16)		99IOT Shenzhen co.,ltd
+				609C north block, Cangsong Building, Tairan Seven Road, Futian District
+				Shenzhen  Guangdong  518000
+				CN
+
+74-12-BB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+7412BB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+00-10-27   (hex)		L-3 COMMUNICATIONS EAST
+001027     (base 16)		L-3 COMMUNICATIONS EAST
+				ONE FEDERAL STREET - A&E-3ES
+				CAMDEN  NJ  08102
+				US
+
+BC-26-43   (hex)		Elprotronic Inc.
+BC2643     (base 16)		Elprotronic Inc.
+				35 Austin Rumble Crt.
+				King City  ON  L7B0B2
+				CA
+
+04-E2-29   (hex)		Qingdao Haier Technology Co.,Ltd
+04E229     (base 16)		Qingdao Haier Technology Co.,Ltd
+				Building A01,Haier Information Park, No.1 Haier Road,
+				Qingdao  Shandong  266101
+				CN
+
+34-8B-75   (hex)		LAVA INTERNATIONAL(H.K) LIMITED
+348B75     (base 16)		LAVA INTERNATIONAL(H.K) LIMITED
+				UNIT L 1/F MAU LAM COMM BLDG 16-18 MAU LAM ST, JORDAN KL, HK
+				Hong kong    999077
+				CN
+
+9C-E8-95   (hex)		New H3C Technologies Co., Ltd
+9CE895     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+00-58-3F   (hex)		PC Aquarius
+00583F     (base 16)		PC Aquarius
+				Comcity Office Park, Kievskoe shosse, est.6, bld. 1, Rumyantsevo, Moscow, 108811, RF
+				Moscow    108811
+				RU
+
+90-3D-68   (hex)		G-Printec, Inc.
+903D68     (base 16)		G-Printec, Inc.
+				Kawasaki Tech Center 5F, 580-16, Horikawacho
+				Saiwai-ku, Kawasaki-shi  Kanagawa  212-0013
+				JP
+
+10-94-BB   (hex)		Apple, Inc.
+1094BB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-1D-4A   (hex)		zte corporation
+781D4A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+94-E1-AC   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+94E1AC     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+34-E8-94   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+34E894     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-6F-C1   (hex)		Apple, Inc.
+F86FC1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-FF-3C   (hex)		Apple, Inc.
+28FF3C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-99-B6   (hex)		Apple, Inc.
+F099B6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-E9-FE   (hex)		Apple, Inc.
+88E9FE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-89-2C   (hex)		Apple, Inc.
+38892C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-9E-AF   (hex)		Apple, Inc.
+749EAF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-BF-2D   (hex)		Apple, Inc.
+94BF2D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-CA-E4   (hex)		Cisco Systems, Inc
+68CAE4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-BE-3B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00BE3B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-A1-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7CA177     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-2E-02   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+242E02     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-B6-EC   (hex)		Scuf Gaming International LLC
+78B6EC     (base 16)		Scuf Gaming International LLC
+				3970 Johns Creek Court Suite 325 Suwanee
+				Atlanta  GA  30024
+				US
+
+80-35-C1   (hex)		Xiaomi Communications Co Ltd
+8035C1     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+58-B3-FC   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+58B3FC     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+20-47-DA   (hex)		Xiaomi Communications Co Ltd
+2047DA     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+24-29-FE   (hex)		KYOCERA Corporation 
+2429FE     (base 16)		KYOCERA Corporation 
+				30 Hoji
+				Kitami,  Hokkaido  099-1595
+				JP
+
+7C-49-EB   (hex)		XIAOMI Electronics,CO.,LTD
+7C49EB     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+C4-33-06   (hex)		China Mobile Group Device Co.,Ltd.
+C43306     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+08-DF-CB   (hex)		Systrome Networks
+08DFCB     (base 16)		Systrome Networks
+				Sohna Road
+				Gurgaon  Haryana  122018
+				IN
+
+A4-93-3F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4933F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-AC-9E   (hex)		Cisco Systems, Inc
+28AC9E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-B8-ED   (hex)		SonicWall
+2CB8ED     (base 16)		SonicWall
+				5455 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+68-D4-82   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+68D482     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+98-45-62   (hex)		Shanghai Baud Data Communication Co.,Ltd.
+984562     (base 16)		Shanghai Baud Data Communication Co.,Ltd.
+				NO.123 JULI RD
+				PUDONG ZHANGJIANG HIGH-TECH PARK  SHANGHAI  201203
+				CN
+
+E4-C4-83   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+E4C483     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+00-1F-BA   (hex)		Boyoung Tech
+001FBA     (base 16)		Boyoung Tech
+				Youngdeungpo-Gu Munrae3ga 84-2
+				Seoul    150-093
+				KR
+
+A4-33-D7   (hex)		MitraStar Technology Corp.
+A433D7     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+B0-AC-D2   (hex)		zte corporation
+B0ACD2     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+20-0F-70   (hex)		FOXTECH
+200F70     (base 16)		FOXTECH
+				152-160 City Road
+				LONDON  KEMP HOUSE  EC1V 2NX
+				GB
+
+20-2D-23   (hex)		Collinear Networks Inc.
+202D23     (base 16)		Collinear Networks Inc.
+				2901 Tasman Drive
+				Santa Clara  CA  95054
+				US
+
+90-83-4B   (hex)		BEIJING YUNYI TIMES TECHNOLOGY CO,.LTD
+90834B     (base 16)		BEIJING YUNYI TIMES TECHNOLOGY CO,.LTD
+				1-411Room 19#Building No.26 Xihuan South Rd. BDA Daxing District,
+				BEIJING    100176
+				CN
+
+18-50-2A   (hex)		SOARNEX
+18502A     (base 16)		SOARNEX
+				NO.158, RUIHU ST., NEIHU DIST.,
+				TAIPEI CITY  TAIWAN (R.O.C.)  11494
+				TW
+
+A8-36-7A   (hex)		frogblue TECHNOLOGY GmbH
+A8367A     (base 16)		frogblue TECHNOLOGY GmbH
+				Luxemburger Straße 6
+				Kaiserslautern  Rheinland-Pfalz  67657
+				DE
+
+6C-E4-DA   (hex)		NEC Platforms, Ltd.
+6CE4DA     (base 16)		NEC Platforms, Ltd.
+				2-3 Kandatsukasamachi
+				Chiyodaku  Tokyo  101-8532
+				JP
+
+10-E7-C6   (hex)		Hewlett Packard
+10E7C6     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+18-31-BF   (hex)		ASUSTek COMPUTER INC.
+1831BF     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+C8-FA-E1   (hex)		ARQ Digital LLC
+C8FAE1     (base 16)		ARQ Digital LLC
+				2430 Auto Park Way
+				Escondido  CA  92029
+				US
+
+DC-A3-33   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+DCA333     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+78-8C-54   (hex)		Ping Communication
+788C54     (base 16)		Ping Communication
+				Brenden 18
+				Appenzell Meistersrüte  AI  9050
+				CH
+
+B8-AF-67   (hex)		Hewlett Packard
+B8AF67     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+C0-98-DA   (hex)		China Mobile IOT Company Limited
+C098DA     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+F0-0F-EC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F00FEC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-07-5F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC075F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-48-E6   (hex)		Samsung Electronics Co.,Ltd
+C048E6     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+88-2E-5A   (hex)		storONE
+882E5A     (base 16)		storONE
+				POB 2660
+				Ra'anana    
+				IL
+
+00-71-47   (hex)		Amazon Technologies Inc.
+007147     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-BE-75   (hex)		Cisco Systems, Inc
+00BE75     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-DB-8B   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+64DB8B     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+78-25-7A   (hex)		LEO Innovation Lab
+78257A     (base 16)		LEO Innovation Lab
+				Silkegade 8
+				Copenhagen K  Denmark  1113
+				DK
+
+10-A4-B9   (hex)		Baidu Online Network Technology (Beijing) Co., Ltd
+10A4B9     (base 16)		Baidu Online Network Technology (Beijing) Co., Ltd
+				Baidu Campus, No.10 Shangdi 10th Street, Haidian District
+				 Beijing    100085
+				CN
+
+50-1C-B0   (hex)		Cisco Systems, Inc
+501CB0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+04-AC-44   (hex)		Holtek Semiconductor Inc.
+04AC44     (base 16)		Holtek Semiconductor Inc.
+				No.3, Creation Rd. II, Science Park
+				Hsinchu    300
+				TW
+
+F4-DC-A5   (hex)		DAWON DNS
+F4DCA5     (base 16)		DAWON DNS
+				217ho, Sauphwajiwon-dong, KETI, 226, Cheomdangwagi-ro, Buk-gu
+				Gwangju    61011
+				KR
+
+80-CE-62   (hex)		Hewlett Packard
+80CE62     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+80-1F-12   (hex)		Microchip Technology Inc.
+801F12     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+50-6C-BE   (hex)		InnosiliconTechnology Ltd
+506CBE     (base 16)		InnosiliconTechnology Ltd
+				WuHan East Lake Wuhan New Technology Development Zone 
+				Wuhan  Hubei Province  430223
+				CN
+
+24-7E-12   (hex)		Cisco Systems, Inc
+247E12     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+04-C2-41   (hex)		Nokia
+04C241     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+3C-47-9B   (hex)		Theissen Training Systems, Inc.
+3C479B     (base 16)		Theissen Training Systems, Inc.
+				1225 SE 4th Terrace
+				Chiefland  FL  32626
+				US
+
+60-6B-FF   (hex)		Nintendo Co.,Ltd
+606BFF     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+8C-F7-10   (hex)		AMPAK Technology, Inc.
+8CF710     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+30-7B-AC   (hex)		New H3C Technologies Co., Ltd
+307BAC     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+78-5D-C8   (hex)		LG Electronics
+785DC8     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+3C-04-61   (hex)		ARRIS Group, Inc.
+3C0461     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+88-3D-24   (hex)		Google, Inc.
+883D24     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+E8-C1-B8   (hex)		 Nanjing Bangzhong Electronic Commerce Limited
+E8C1B8     (base 16)		 Nanjing Bangzhong Electronic Commerce Limited
+				No.22, Liuzhou East Road, High - tech Zone
+				Nanjing    210000
+				CN
+
+D8-D7-75   (hex)		Sagemcom Broadband SAS
+D8D775     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E8-33-0D   (hex)		Xaptec GmbH
+E8330D     (base 16)		Xaptec GmbH
+				Neidenburger Str. 10
+				Gelsenkirchen    45897
+				DE
+
+D4-60-E3   (hex)		Sercomm Corporation.
+D460E3     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+B4-A8-B9   (hex)		Cisco Systems, Inc
+B4A8B9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-DC-E7   (hex)		Amazon Technologies Inc.
+50DCE7     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+64-98-29   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+649829     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+08-1D-C4   (hex)		Thermo Fisher Scientific Messtechnik GmbH
+081DC4     (base 16)		Thermo Fisher Scientific Messtechnik GmbH
+				Frauenauracher Strasse 96
+				Erlangen    91056
+				DE
+
+78-53-64   (hex)		SHIFT GmbH
+785364     (base 16)		SHIFT GmbH
+				Am Gänsemarkt 6
+				Wabern Falkenberg  Hessen  34590
+				DE
+
+38-E6-0A   (hex)		Xiaomi Communications Co Ltd
+38E60A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+40-CB-C0   (hex)		Apple, Inc.
+40CBC0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-61-8B   (hex)		Apple, Inc.
+C4618B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-6E-A4   (hex)		Samsung Electronics Co.,Ltd
+CC6EA4     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+80-3A-59   (hex)		AT&T
+803A59     (base 16)		AT&T
+				1025 Lenox Park Blvd
+				Atlanta  GA  30319
+				US
+
+58-8D-64   (hex)		Xi'an Clevbee Technology Co.,Ltd
+588D64     (base 16)		Xi'an Clevbee Technology Co.,Ltd
+				FLOOR 7, TOWER B, POSCO CENTER, NO. 13 ZONE FOUR WANGJING EAST PARK, CHAOYANG DISTRICT, BEIJING
+				Beijing    100012
+				CN
+
+00-5D-73   (hex)		Cisco Systems, Inc
+005D73     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-6D-3C   (hex)		Luxshare Precision Industry Company Limited
+606D3C     (base 16)		Luxshare Precision Industry Company Limited
+				Floor 2, Block A, Sanyo New Industrial Area
+				West Haoyi Community, Shajing Subdistrict Office  Bao'an District, Shenzhen, Guangdong  523000
+				CN
+
+44-F0-34   (hex)		Kaonmedia CO., LTD.
+44F034     (base 16)		Kaonmedia CO., LTD.
+				884-3, Seongnam-daero, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13517
+				KR
+
+00-27-90   (hex)		Cisco Systems, Inc
+002790     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-BA-38   (hex)		PAL MOHAN ELECTRONICS PVT LTD
+34BA38     (base 16)		PAL MOHAN ELECTRONICS PVT LTD
+				40 DLF, INDUSTRIAL AREA, KIRTI NAGAR
+				NEW DELHI  DELHI  110015
+				IN
+
+98-29-A6   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+9829A6     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+CC-4D-38   (hex)		Carnegie Technologies
+CC4D38     (base 16)		Carnegie Technologies
+				9737 Great Hills Trail #260
+				Austin  TX  78759
+				US
+
+08-E6-89   (hex)		Apple, Inc.
+08E689     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-56-E7   (hex)		Apple, Inc.
+DC56E7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-16-D0   (hex)		Samsung Electronics Co.,Ltd
+A816D0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-6C-F1   (hex)		Samsung Electronics Co.,Ltd
+A46CF1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-AE-D6   (hex)		Samsung Electronics Co.,Ltd
+08AED6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-BF-E9   (hex)		Motorola Mobility LLC, a Lenovo Company
+DCBFE9     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+B4-2D-56   (hex)		Extreme Networks, Inc.
+B42D56     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+40-64-A4   (hex)		THE FURUKAWA ELECTRIC CO., LTD
+4064A4     (base 16)		THE FURUKAWA ELECTRIC CO., LTD
+				2-2-3,Marunouchi
+				Chiyoda-ku  Tokyo  100-8322
+				JP
+
+6C-B2-AE   (hex)		Cisco Systems, Inc
+6CB2AE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B0-98-2B   (hex)		Sagemcom Broadband SAS
+B0982B     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+34-FA-9F   (hex)		Ruckus Wireless
+34FA9F     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+F0-65-C2   (hex)		Yanfeng Visteon Electronics Technology (Shanghai) Co.,Ltd.
+F065C2     (base 16)		Yanfeng Visteon Electronics Technology (Shanghai) Co.,Ltd.
+				1001 North Qin Zhou Road
+				Shang Hai    200233
+				CN
+
+70-B7-E2   (hex)		Jiangsu Miter Technology Co.,Ltd.
+70B7E2     (base 16)		Jiangsu Miter Technology Co.,Ltd.
+				No.86 fuyuan community,the town of houbei
+				Jurong  Jiangsu  212400
+				CN
+
+80-8D-B7   (hex)		Hewlett Packard Enterprise
+808DB7     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+A0-9D-86   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+A09D86     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+00-C0-FF   (hex)		Seagate Cloud Systems Inc
+00C0FF     (base 16)		Seagate Cloud Systems Inc
+				6305 El Camino Real
+				Carlsbad  CA  92009
+				US
+
+D4-5D-DF   (hex)		PEGATRON CORPORATION
+D45DDF     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+F8-B5-68   (hex)		IEEE Registration Authority
+F8B568     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+2C-6B-7D   (hex)		Texas Instruments
+2C6B7D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-D1-71   (hex)		BEGHELLI S.P.A
+88D171     (base 16)		BEGHELLI S.P.A
+				VIA MOZZEGHINE 13/15
+				LOCALITA' MONTEVEGLIO - COMUNE VALSAMOGGIA  BOLOGNA  40053
+				IT
+
+A0-9D-C1   (hex)		China Dragon Technology Limited
+A09DC1     (base 16)		China Dragon Technology Limited
+				B4 Bldg.Haoshan 1st Industry Park,
+				Shenzhen  Guangdong  518104
+				CN
+
+2C-42-05   (hex)		Lytx
+2C4205     (base 16)		Lytx
+				9785 Towne Centre Drive
+				San Diego  CA  92121
+				US
+
+A8-25-EB   (hex)		Cambridge Industries(Group) Co.,Ltd.
+A825EB     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				5/F,Building 8, 2388 ChenHang Road, MinHang District
+				shanghai    201114
+				CN
+
+34-E3-80   (hex)		Genexis B.V.
+34E380     (base 16)		Genexis B.V.
+				Lodewijkstraat 1A
+				Eindhoven    5652AC
+				NL
+
+5C-58-19   (hex)		Jingsheng Technology Co., Ltd.
+5C5819     (base 16)		Jingsheng Technology Co., Ltd.
+				Linyin street 5#
+				chengdu  sichuan  610000
+				CN
+
+B8-CA-04   (hex)		Holtek Semiconductor Inc.
+B8CA04     (base 16)		Holtek Semiconductor Inc.
+				No.3, Creation Rd. II, Science Park
+				Hsinchu    300
+				TW
+
+C4-C5-63   (hex)		TECNO MOBILE LIMITED
+C4C563     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+80-B7-08   (hex)		Blue Danube Systems, Inc
+80B708     (base 16)		Blue Danube Systems, Inc
+				3131 Jay Street, Suite 201
+				Santa Clara  CA  95054
+				US
+
+08-BC-20   (hex)		Hangzhou Royal Cloud Technology Co., Ltd
+08BC20     (base 16)		Hangzhou Royal Cloud Technology Co., Ltd
+				Hangzhou Xixi Road 957, 24, Unit 2, 302
+				Hangzhou    310030
+				CN
+
+94-2A-3F   (hex)		Diversey Inc
+942A3F     (base 16)		Diversey Inc
+				2415 Cascade Pointe Blvd
+				Charlotte  NC  28208
+				US
+
+20-31-EB   (hex)		HDSN
+2031EB     (base 16)		HDSN
+				4 allée des roseaux
+				Saint mitre les remparts  BDR  13920
+				FR
+
+F8-C9-6C   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F8C96C     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+84-48-23   (hex)		WOXTER TECHNOLOGY Co. Ltd
+844823     (base 16)		WOXTER TECHNOLOGY Co. Ltd
+				23F Doushiyangguang, Chegongmiao
+				Shenzhen    518040
+				CN
+
+F4-1E-5E   (hex)		RtBrick Inc.
+F41E5E     (base 16)		RtBrick Inc.
+				26 Kingston Terrace
+				Princeton  NJ  08540
+				US
+
+6C-76-60   (hex)		KYOCERA CORPORATION 
+6C7660     (base 16)		KYOCERA CORPORATION 
+				2-1-1 Kagahara
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+00-21-02   (hex)		UpdateLogic Inc.
+002102     (base 16)		UpdateLogic Inc.
+				2 Willow Street, Suite 101
+				Southborough  MA  01745
+				US
+
+50-58-00   (hex)		WyTec International, Inc.
+505800     (base 16)		WyTec International, Inc.
+				19206 Huebner Rd Suite 202
+				San Antonio  Texas  78258
+				US
+
+C8-D1-2A   (hex)		Comtrend Corporation
+C8D12A     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+0C-EA-C9   (hex)		ARRIS Group, Inc.
+0CEAC9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-2A-44   (hex)		Liteon Technology Corporation
+E82A44     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+10-A4-BE   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+10A4BE     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+94-7B-BE   (hex)		Ubicquia
+947BBE     (base 16)		Ubicquia
+				3281 Fairlane Farms Rd
+				Wellington   FL  33449
+				US
+
+EC-C0-6A   (hex)		PowerChord Group Limited
+ECC06A     (base 16)		PowerChord Group Limited
+				1 Blythe Road
+				London    W14 0HG
+				GB
+
+94-49-96   (hex)		WiSilica Inc
+944996     (base 16)		WiSilica Inc
+				23282 Mill Creek Dr #340
+				Laguna Hills  CA  92653
+				US
+
+F8-1D-0F   (hex)		Hitron Technologies. Inc
+F81D0F     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+58-C9-35   (hex)		Chiun Mai Communication Systems, Inc
+58C935     (base 16)		Chiun Mai Communication Systems, Inc
+				No.4, Minsheng St., Tucheng District
+				New Taipei City    23678
+				TW
+
+00-94-A1   (hex)		F5 Networks, Inc.
+0094A1     (base 16)		F5 Networks, Inc.
+				401 Elliott Ave. W.
+				Seattle  WA  98119
+				US
+
+BC-F2-92   (hex)		PLANTRONICS, INC.
+BCF292     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+04-50-DA   (hex)		Qiku Internet Network Scientific (Shenzhen) Co., Ltd
+0450DA     (base 16)		Qiku Internet Network Scientific (Shenzhen) Co., Ltd
+				Building A2, Chi Yuen Technology Park  1001 College Avenue, Nanshan District Shenzhen, Guangdong 
+				 Shenzhen  Guangdong   518000
+				CN
+
+E8-20-E2   (hex)		HUMAX Co., Ltd.
+E820E2     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+00-26-A8   (hex)		DAEHAP HYPER-TECH
+0026A8     (base 16)		DAEHAP HYPER-TECH
+				Mega center #1108, SK Techno-Park, #190-1, Sangdaewon-Dong, Jungwon-Gu
+				Seongnam  Gyeonggi-Do  462-807
+				KR
+
+78-5C-28   (hex)		Prime Motion Inc.
+785C28     (base 16)		Prime Motion Inc.
+				Akaho 1134-12
+				Komagane  Nagano  399-4117
+				JP
+
+8C-5B-F0   (hex)		ARRIS Group, Inc.
+8C5BF0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+18-90-D8   (hex)		Sagemcom Broadband SAS
+1890D8     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+88-83-5D   (hex)		FN-LINK TECHNOLOGY LIMITED
+88835D     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				No.8, Litong Road, Liuyang Economic & Technical Development Zone
+				ChangSha  Hu Nan  410300
+				CN
+
+EC-9F-0D   (hex)		IEEE Registration Authority
+EC9F0D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E0-78-A3   (hex)		Shanghai Winner Information Technology Co.,Inc
+E078A3     (base 16)		Shanghai Winner Information Technology Co.,Inc
+				Lujiazui Software Park,No.190,Lane 91,Eshan Road,Pudong New Area
+				Shanghai  Shanghai  200127
+				CN
+
+00-05-A7   (hex)		HYPERCHIP Inc.
+0005A7     (base 16)		HYPERCHIP Inc.
+				180 Peel Street - Ste. #333
+				123    H3C 2G7
+				CA
+
+08-84-66   (hex)		Novartis Pharma AG
+088466     (base 16)		Novartis Pharma AG
+				Lichtstrasse 35
+				Basel    4056
+				CH
+
+30-9F-FB   (hex)		Ardomus Networks Corporation
+309FFB     (base 16)		Ardomus Networks Corporation
+				4F,No. 6 Innovation Road II, Hsinchu Science Park  
+				Hsinchu    300
+				TW
+
+28-23-73   (hex)		Digita
+282373     (base 16)		Digita
+				Jämsänkatu 2
+				Helsinki  Uusimaa  00520
+				FI
+
+64-9A-08   (hex)		Shenzhen SuperElectron Technology Co.,LTD
+649A08     (base 16)		Shenzhen SuperElectron Technology Co.,LTD
+				Layer 13,Haosheng Business Center,Dongbin Road,Nanshan District
+				Shenzhen  guangdong  518052
+				CN
+
+68-A6-82   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+68A682     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+58-7A-62   (hex)		Texas Instruments
+587A62     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+54-7A-52   (hex)		CTE International srl
+547A52     (base 16)		CTE International srl
+				Via Sevardi 7
+				Reggio Emilia    42124
+				IT
+
+F0-6E-0B   (hex)		Microsoft Corporation
+F06E0B     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND    98052
+				US
+
+34-6F-ED   (hex)		Enovation Controls
+346FED     (base 16)		Enovation Controls
+				5311 S. 122nd E. Ave. 
+				Tulsa  OK  74146
+				US
+
+54-33-CB   (hex)		Apple, Inc.
+5433CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-08-BC   (hex)		Apple, Inc.
+3408BC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-36-BB   (hex)		Apple, Inc.
+1C36BB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-2E-FF   (hex)		Apple, Inc.
+3C2EFF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-E0-25   (hex)		dit Co., Ltd.
+00E025     (base 16)		dit Co., Ltd.
+				Premier Toyocho Building
+				Koto-ku  Tokyo  135-0056
+				JP
+
+AC-84-C6   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+AC84C6     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-15-30   (hex)		Dell EMC
+001530     (base 16)		Dell EMC
+				176 South Street
+				Hopkinton  MA  01748
+				US
+
+0C-B2-B7   (hex)		Texas Instruments
+0CB2B7     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+24-F6-77   (hex)		Apple, Inc.
+24F677     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-CA-68   (hex)		Apple, Inc.
+B0CA68     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-3C-85   (hex)		Apple, Inc.
+C83C85     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-87-0D   (hex)		Unifiedgateways India Private Limited
+78870D     (base 16)		Unifiedgateways India Private Limited
+				25 1st Floor 4th Cross KR Road Jayanagar 7th Block West
+				Bangalore  Karnataka  560082
+				IN
+
+A8-82-00   (hex)		Hisense Electric Co.,Ltd
+A88200     (base 16)		Hisense Electric Co.,Ltd
+				Qianwangang Roard 218
+				Qingdao  Shandong  266510
+				CN
+
+38-20-A8   (hex)		ColorTokens, Inc.
+3820A8     (base 16)		ColorTokens, Inc.
+				2101 Tasman Dr. Suite 200A
+				Santa Clara  CA  95054
+				US
+
+70-58-96   (hex)		InShow Technology
+705896     (base 16)		InShow Technology
+				Jinqi Zhigu Building, Chongwen Garden, Liuxian Avenue, Nanshan District
+				shenzhen  Guangdong  518055
+				CN
+
+00-05-89   (hex)		National Datacomputer
+000589     (base 16)		National Datacomputer
+				900 Middlesex Tpk.
+				Billerica  MA  01821
+				US
+
+3C-A6-16   (hex)		vivo Mobile Communication Co., Ltd.
+3CA616     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+9C-E0-63   (hex)		Samsung Electronics Co.,Ltd
+9CE063     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-31-69   (hex)		Samsung Electronics Co.,Ltd
+D03169     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-F2-7F   (hex)		Hewlett Packard Enterprise
+24F27F     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+BC-05-43   (hex)		AVM GmbH
+BC0543     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+00-B6-9F   (hex)		Latch
+00B69F     (base 16)		Latch
+				450 W 33rd  St
+				New York  NY  10001
+				US
+
+84-2C-80   (hex)		Sichuan Changhong Electric Ltd.
+842C80     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+3C-C0-79   (hex)		Shenzhen One-Nine Intelligent Electronic Science and Technology Co., Ltd
+3CC079     (base 16)		Shenzhen One-Nine Intelligent Electronic Science and Technology Co., Ltd
+				Office 3015, Chuangxingda Business Building, No.36. Liuxian 3 Road, Baoan District
+				Shenzhen  Guangdong  518133
+				CN
+
+98-C5-DB   (hex)		Ericsson AB
+98C5DB     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+14-9F-3C   (hex)		Samsung Electronics Co.,Ltd
+149F3C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-EE-E6   (hex)		FORMIKE ELECTRONIC CO., LTD
+FCEEE6     (base 16)		FORMIKE ELECTRONIC CO., LTD
+				Flats 401-403, Block B, iPARK Building, 26 Dengliang Rd., NanShan Distric
+				Shenzhen  Guang Dong  518054
+				CN
+
+84-E3-27   (hex)		TAILYN TECHNOLOGIES INC
+84E327     (base 16)		TAILYN TECHNOLOGIES INC
+				NO 10 RUNG-AN ROAD, LU-ZHU DISTRICT
+				TAOYUAN CITY  TAIWAN ROC  33852
+				TW
+
+00-21-B8   (hex)		Inphi Corporation
+0021B8     (base 16)		Inphi Corporation
+				112 S. Lakeview Canyon Rd., Suite 100
+				Westlake Village  CA  91362
+				US
+
+0C-91-60   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+0C9160     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+D8-ED-1C   (hex)		Magna Technology SL
+D8ED1C     (base 16)		Magna Technology SL
+				C/Principe de Vergara, 55. 3ª planta
+				Madrid    28006
+				ES
+
+D8-31-34   (hex)		Roku, Inc
+D83134     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+40-8B-F6   (hex)		Shenzhen TCL New Technology Co., Ltd
+408BF6     (base 16)		Shenzhen TCL New Technology Co., Ltd
+				TCL Building, #5 Central Nanhai Road, Nanshan District,
+				Shenzhen,  Guangdong,   518067
+				CN
+
+00-00-6B   (hex)		Silicon Graphics
+00006B     (base 16)		Silicon Graphics
+				2011 NORTH SHORELINE BLVD.
+				MOUNTAIN VIEW  CA  94039-7311
+				US
+
+74-37-3B   (hex)		UNINET Co.,Ltd.
+74373B     (base 16)		UNINET Co.,Ltd.
+				#1803, Daerung Techno Town15, 401, Simin-daero, Dongan-gu
+				Anyang-si  Gyunggi-do  14057
+				KR
+
+7C-64-56   (hex)		Samsung Electronics Co.,Ltd
+7C6456     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+F4-6E-24   (hex)		NEC Personal Computers, Ltd.
+F46E24     (base 16)		NEC Personal Computers, Ltd.
+				Akihabara UDX,14-1, Sotokanda 4-Chome
+				Chiyoda-ku  Tokyo  101-0021
+				JP
+
+88-82-79   (hex)		Shenzhen RB-LINK Intelligent Technology Co.Ltd
+888279     (base 16)		Shenzhen RB-LINK Intelligent Technology Co.Ltd
+				Second floor, No 22, Wanfeng the third industry area, Shajing , BaoAn district
+				Shenzhen City    518125
+				CN
+
+68-C6-3A   (hex)		Espressif Inc.
+68C63A     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+A0-64-8F   (hex)		ASKEY COMPUTER CORP
+A0648F     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+C8-50-E9   (hex)		Raisecom Technology CO., LTD
+C850E9     (base 16)		Raisecom Technology CO., LTD
+				No. 11, East Area, No. 10 Block, East Xibeiwang Road
+				Beijing    100094
+				CN
+
+10-F1-63   (hex)		TNK CO.,LTD
+10F163     (base 16)		TNK CO.,LTD
+				1 Kasugayama.Iitoyo
+				Tenei-village.Iwase-country  Fukushima-prefecture  962-0512
+				JP
+
+88-DA-1A   (hex)		Redpine Signals, Inc.
+88DA1A     (base 16)		Redpine Signals, Inc.
+				2107, N. First St
+				San Jose  CA  95131-2019
+				US
+
+98-EF-9B   (hex)		OHSUNG
+98EF9B     (base 16)		OHSUNG
+				335-4,SANHODAERO,GUMI,GYEONG BUK,KOREA
+				GUMI  GYEONG BUK  730-030
+				KR
+
+14-CF-8D   (hex)		OHSUNG
+14CF8D     (base 16)		OHSUNG
+				181
+				GUMI  KYUNGBUK  730-030
+				KR
+
+10-44-00   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+104400     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-E1-7E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B0E17E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-A7-C5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4A7C5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-8D-2D   (hex)		Shanghai Wellpay Information Technology Co., Ltd
+5C8D2D     (base 16)		Shanghai Wellpay Information Technology Co., Ltd
+				 Loushanguan Road 523, Jin Hongqiao International Center Building, 1501
+				Shanghai    200000
+				CN
+
+90-FD-9F   (hex)		Silicon Laboratories
+90FD9F     (base 16)		Silicon Laboratories
+				400 W. Cesar Chavez St.
+				Austin  TX  78701
+				US
+
+B4-30-C0   (hex)		York Instruments Ltd
+B430C0     (base 16)		York Instruments Ltd
+				The Biocentre, York Science Park
+				York  North Yorkshire  YO10 5NY
+				GB
+
+E8-1D-A8   (hex)		Ruckus Wireless
+E81DA8     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+F0-3D-03   (hex)		TECNO MOBILE LIMITED
+F03D03     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+DC-F0-90   (hex)		Nubia Technology Co.,Ltd.
+DCF090     (base 16)		Nubia Technology Co.,Ltd.
+				6/F-8/F 10/F-11/F A Tower,6/F B Tower,6/F-10/F C Tower Dazu Innovation Mansion, North Ring Rd,No.9018,High-Tech Park Nanshan District
+				Shenzhen  Guandong  518057
+				CN
+
+A0-FE-61   (hex)		Vivint Wireless Inc. 
+A0FE61     (base 16)		Vivint Wireless Inc. 
+				4931 N 300 W
+				Provo  UT  84604
+				US
+
+5C-2B-F5   (hex)		Vivint Wireless Inc. 
+5C2BF5     (base 16)		Vivint Wireless Inc. 
+				4931 N 300 W
+				Provo  UT  84604
+				US
+
+CC-5A-53   (hex)		Cisco Systems, Inc
+CC5A53     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-60-88   (hex)		Analog Devices, Inc.
+006088     (base 16)		Analog Devices, Inc.
+				410 AMHERST STREET-STE #325
+				NASHUA  NH  03063
+				US
+
+08-4A-CF   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+084ACF     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+2C-27-9E   (hex)		IEEE Registration Authority
+2C279E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-5F-48   (hex)		Continental Intelligent Transportation Systems LLC
+8C5F48     (base 16)		Continental Intelligent Transportation Systems LLC
+				3901 North First Street
+				San Jose  CA  95134
+				US
+
+94-7E-B9   (hex)		National Narrowband Network Communications Pty Ltd
+947EB9     (base 16)		National Narrowband Network Communications Pty Ltd
+				Unit 10, 1 Talavera Road
+				Macquarie Park  New South Wales  2113
+				AU
+
+64-6E-69   (hex)		Liteon Technology Corporation
+646E69     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+70-6B-B9   (hex)		Cisco Systems, Inc
+706BB9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-38-9C   (hex)		Sony Mobile Communications Inc
+D4389C     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-C0-EE   (hex)		KYOCERA Display Corporation
+00C0EE     (base 16)		KYOCERA Display Corporation
+				2-14-9 TAMAGAWADAI
+				tokyo  158  0000
+				JP
+
+24-5F-DF   (hex)		KYOCERA CORPORATION 
+245FDF     (base 16)		KYOCERA CORPORATION 
+				2-1-1,Kagahara,
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+9C-63-ED   (hex)		zte corporation
+9C63ED     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+74-F6-61   (hex)		Schneider Electric Fire & Security Oy
+74F661     (base 16)		Schneider Electric Fire & Security Oy
+				Sokerilinnantie 11 C
+				Espoo    02650
+				FI
+
+B8-63-4D   (hex)		Apple, Inc.
+B8634D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-C4-2F   (hex)		Philips Lifeline
+24C42F     (base 16)		Philips Lifeline
+				111 Lawrence st
+				Framingham  MA  01702
+				US
+
+2C-B2-1A   (hex)		Phicomm (Shanghai) Co., Ltd.
+2CB21A     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+A4-E9-75   (hex)		Apple, Inc.
+A4E975     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-35-AD   (hex)		Apple, Inc.
+3035AD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-41-67   (hex)		Apple, Inc.
+844167     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-00-C6   (hex)		Apple, Inc.
+9800C6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-1F-74   (hex)		Apple, Inc.
+AC1F74     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-5C-2C   (hex)		Apple, Inc.
+A85C2C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-DB-70   (hex)		Apple, Inc.
+00DB70     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-E5-57   (hex)		Nokia Corporation
+FCE557     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+48-C5-8D   (hex)		Lear Corporation GmbH
+48C58D     (base 16)		Lear Corporation GmbH
+				Industriestrasse 48
+				Kronach  Bavaria  96317
+				DE
+
+00-28-9F   (hex)		Semptian Co., Ltd.
+00289F     (base 16)		Semptian Co., Ltd.
+				Block 5D, 8/F, Software Industry Park, No.14, Haitian 2nd Road, GaoxinSouth, Nanshan District, Shenzhen, China
+				Shen Zhen  GuangDong  518061
+				CN
+
+9C-30-5B   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9C305B     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+10-4E-89   (hex)		Garmin International
+104E89     (base 16)		Garmin International
+				1200 E. 151st St
+				Olathe  KS  66062
+				US
+
+D8-C4-97   (hex)		Quanta Computer Inc.
+D8C497     (base 16)		Quanta Computer Inc.
+				No. 211, Wen-Hwa 2nd Rd.,Kuei-Shan Dist.
+				Taoyuan City  Taiwan  33377
+				TW
+
+BC-C3-42   (hex)		Panasonic Communications Co., Ltd.
+BCC342     (base 16)		Panasonic Communications Co., Ltd.
+				4-1-62 Minoshima Hakata-ku
+				Fukuoka city  Fukuoka  812-8531
+				JP
+
+00-1B-D3   (hex)		Panasonic Corporation AVC Networks Company
+001BD3     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma  Osaka  571-8504
+				JP
+
+CC-7E-E7   (hex)		Panasonic Corporation AVC Networks Company
+CC7EE7     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma City  Osaka  571-8504
+				JP
+
+20-C6-EB   (hex)		Panasonic Corporation AVC Networks Company
+20C6EB     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma  Osaka  571-8504
+				JP
+
+64-B5-C6   (hex)		Nintendo Co.,Ltd
+64B5C6     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+28-30-AC   (hex)		Frontiir Co. Ltd.
+2830AC     (base 16)		Frontiir Co. Ltd.
+				5 Bayint Naung Road, Hlaing Township
+				Yangon    11052
+				MM
+
+D4-D2-E5   (hex)		BKAV Corporation
+D4D2E5     (base 16)		BKAV Corporation
+				2nd floor - HH1 Building - Yen Hoa Urban Area, Yen Hoa Ward, Cau Giay District
+				HaNoi    100000
+				VN
+
+00-50-B5   (hex)		FICHET SECURITE ELECTRONIQUE
+0050B5     (base 16)		FICHET SECURITE ELECTRONIQUE
+				15-17 AVE. MORANE-SAULNIER
+				    
+				FR
+
+00-14-39   (hex)		Blonder Tongue Laboratories, Inc
+001439     (base 16)		Blonder Tongue Laboratories, Inc
+				One Jake Brown Road
+				Old Bridge    08857
+				US
+
+20-A6-CD   (hex)		Hewlett Packard Enterprise
+20A6CD     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+84-80-2D   (hex)		Cisco Systems, Inc
+84802D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-19-87   (hex)		Panasonic Mobile Communications Co.,Ltd.
+001987     (base 16)		Panasonic Mobile Communications Co.,Ltd.
+				600 Saedo-cho, Tsuzuki-ku,
+				Yokohama City  Kanagawa Prefecture  224-8539
+				JP
+
+74-1C-27   (hex)		ITEL MOBILE LIMITED
+741C27     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+00-A0-AC   (hex)		GILAT SATELLITE NETWORKS, LTD.
+00A0AC     (base 16)		GILAT SATELLITE NETWORKS, LTD.
+				24A HABARZEL STREET
+				    
+				IL
+
+00-26-09   (hex)		Phyllis Co., Ltd.
+002609     (base 16)		Phyllis Co., Ltd.
+				9th Fl., Room 3/4, No. 52, Sec. 2, Chung Shan North Road,
+				Taipei    104
+				TW
+
+28-F5-37   (hex)		IEEE Registration Authority
+28F537     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-D9-B3   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+94D9B3     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-40-29   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+C84029     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+F8-6E-EE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F86EEE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-02-B1   (hex)		Cisco Systems, Inc
+7802B1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B4-0F-3B   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+B40F3B     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+00-18-8D   (hex)		Nokia Danmark A/S
+00188D     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    1790
+				DK
+
+00-15-AB   (hex)		PRO CO SOUND INC
+0015AB     (base 16)		PRO CO SOUND INC
+				225 PARSONS STREET
+				KALAMAZOO  MICHIGAN  49008
+				US
+
+58-76-C5   (hex)		DIGI I'S LTD
+5876C5     (base 16)		DIGI I'S LTD
+				31, Takahata, Maesawa
+				Oshu  Iwate  029-4204
+				JP
+
+A8-B2-DA   (hex)		FUJITSU LIMITED
+A8B2DA     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+00-13-54   (hex)		Zcomax Technologies, Inc.
+001354     (base 16)		Zcomax Technologies, Inc.
+				98 Ford Road
+				Denville  NJ  07834
+				US
+
+78-D8-00   (hex)		IEEE Registration Authority
+78D800     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+08-35-B2   (hex)		CoreEdge Networks Co., Ltd
+0835B2     (base 16)		CoreEdge Networks Co., Ltd
+				#806 G Plus Tower, 123, Digital-ro 26gil, Guro-gu
+				Seoul    08390
+				KR
+
+4C-49-E3   (hex)		Xiaomi Communications Co Ltd
+4C49E3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+24-58-80   (hex)		VIZEO
+245880     (base 16)		VIZEO
+				13 rue Emile Decorps
+				Villeurbanne    69100
+				FR
+
+54-66-6C   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+54666C     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+A8-96-75   (hex)		Motorola Mobility LLC, a Lenovo Company
+A89675     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+38-9A-F6   (hex)		Samsung Electronics Co.,Ltd
+389AF6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-AA-96   (hex)		Samsung Electronics Co.,Ltd
+E0AA96     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-77-05   (hex)		Samsung Electronics Co.,Ltd
+507705     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+28-D4-36   (hex)		Jiangsu dewosi electric co., LTD
+28D436     (base 16)		Jiangsu dewosi electric co., LTD
+				Dantu district fengjingchengbang  xibanya 503, building 6
+				Zhenjiang  Jiangsu  212028
+				CN
+
+D4-B2-7A   (hex)		ARRIS Group, Inc.
+D4B27A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-EA-4B   (hex)		Actlas Inc.
+44EA4B     (base 16)		Actlas Inc.
+				2-2-32, Asahikawa,
+				Yokote  Akita  013-0033
+				JP
+
+C4-CB-6B   (hex)		Airista Flow, Inc.
+C4CB6B     (base 16)		Airista Flow, Inc.
+				913 Ridgebrook Road Suite 110
+				Sparks  MD  21152
+				US
+
+18-80-90   (hex)		Cisco Systems, Inc
+188090     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+78-62-56   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+786256     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-55-08   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B05508     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B8-75-C0   (hex)		PayPal, Inc.
+B875C0     (base 16)		PayPal, Inc.
+				2211 North 1st Street
+				San Jose  California  95131
+				US
+
+00-1C-71   (hex)		Emergent Electronics
+001C71     (base 16)		Emergent Electronics
+				Bldg 2 Level 3 Suite 305
+				Sewickley  PA  15143
+				US
+
+00-1A-93   (hex)		ERCO Leuchten GmbH
+001A93     (base 16)		ERCO Leuchten GmbH
+				Brockhauser Weg 80-82
+				Lüdenscheid  NRW  D-58507
+				DE
+
+94-F6-65   (hex)		Ruckus Wireless
+94F665     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+B0-90-D4   (hex)		Shenzhen Hoin Internet Technology Co., Ltd
+B090D4     (base 16)		Shenzhen Hoin Internet Technology Co., Ltd
+				Xusheng Building, No. 4004, Bao’an, Room 1616 Bao’an District
+				Shenzhen  Guangdong  518000
+				CN
+
+C0-BA-E6   (hex)		Application Solutions (Electronics and Vision) Ltd
+C0BAE6     (base 16)		Application Solutions (Electronics and Vision) Ltd
+				The Riverside Centre
+				Lewes  East Sussex  BN7 2AQ
+				GB
+
+8C-9F-3B   (hex)		Qingdao Hisense Communications Co.,Ltd.
+8C9F3B     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+00-14-B8   (hex)		Hill-Rom
+0014B8     (base 16)		Hill-Rom
+				1125 E. Pearl Street
+				Batesville  IN  47006
+				US
+
+AC-ED-5C   (hex)		Intel Corporate
+ACED5C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+84-20-96   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+842096     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+B4-C1-70   (hex)		Yi chip Microelectronics (Hangzhou) Co., Ltd
+B4C170     (base 16)		Yi chip Microelectronics (Hangzhou) Co., Ltd
+				Suite 401, Building #13, No. 498 Guoshoujing Rd., Pudong
+				Shanghai    201210
+				CN
+
+AC-67-06   (hex)		Ruckus Wireless
+AC6706     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+04-4F-AA   (hex)		Ruckus Wireless
+044FAA     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+58-93-96   (hex)		Ruckus Wireless
+589396     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-1F-41   (hex)		Ruckus Wireless
+001F41     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+C4-10-8A   (hex)		Ruckus Wireless
+C4108A     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+F0-B0-52   (hex)		Ruckus Wireless
+F0B052     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+70-DF-2F   (hex)		Cisco Systems, Inc
+70DF2F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-94-E0   (hex)		Syrotech Networks. Ltd.
+3894E0     (base 16)		Syrotech Networks. Ltd.
+				UNIT NO.-5 20F, KIN WING INDUSTERIAL BUILDING,33 KIN WING STREET
+				TUEN MUN    999077
+				HK
+
+34-F6-4B   (hex)		Intel Corporate
+34F64B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+F4-6B-EF   (hex)		Sagemcom Broadband SAS
+F46BEF     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+10-CD-B6   (hex)		Essential Products, Inc.
+10CDB6     (base 16)		Essential Products, Inc.
+				380 Portage Avenue
+				Palo Alto  CA  94306
+				US
+
+A4-F3-E7   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+A4F3E7     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+E4-3A-6E   (hex)		Shenzhen Zeroone Technology CO.,LTD
+E43A6E     (base 16)		Shenzhen Zeroone Technology CO.,LTD
+				9/F.,Building B Tianan Cyber Park ,North Huangge Road,Longgang District
+				Shenzhen  Guangdong  518000
+				CN
+
+7C-E2-CA   (hex)		Juniper Networks
+7CE2CA     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-61-AE   (hex)		Intel Corporate
+9061AE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+6C-F9-D2   (hex)		CHENGDU POVODO ELECTRONIC TECHNOLOGY CO., LTD
+6CF9D2     (base 16)		CHENGDU POVODO ELECTRONIC TECHNOLOGY CO., LTD
+				High - West West West Center Road on the 4th
+				 Chengdu   Sichuan  611731
+				CN
+
+30-B6-2D   (hex)		 Mojo Networks, Inc.
+30B62D     (base 16)		 Mojo Networks, Inc.
+				339 N.Bernardo Ave
+				Mountain View  CA  94043
+				US
+
+50-18-4C   (hex)		Platina Systems Inc.
+50184C     (base 16)		Platina Systems Inc.
+				3180 De La Cruz Blvd. Ste# 110
+				Santa Clara  CA  95054
+				US
+
+F4-B7-B3   (hex)		vivo Mobile Communication Co., Ltd.
+F4B7B3     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+CC-03-D9   (hex)		Cisco Meraki
+CC03D9     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+FC-A6-67   (hex)		Amazon Technologies Inc.
+FCA667     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+C8-1F-EA   (hex)		Avaya Inc
+C81FEA     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-27-E3   (hex)		Cisco Systems, Inc
+0027E3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-AE   (hex)		TVT CO.,LTD
+0018AE     (base 16)		TVT CO.,LTD
+				5/F,North Block,CE Lighting House
+				shenzhen  guangdong  518026
+				CN
+
+88-91-DD   (hex)		Racktivity
+8891DD     (base 16)		Racktivity
+				Hertstokweg 5
+				Ternat  Flanders  1741
+				BE
+
+1C-45-93   (hex)		Texas Instruments
+1C4593     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+90-EC-50   (hex)		C.O.B.O. SPA
+90EC50     (base 16)		C.O.B.O. SPA
+				via Tito Speri, 10
+				Leno  Brescia  25024
+				IT
+
+E0-D8-48   (hex)		Dell Inc.
+E0D848     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+60-27-1C   (hex)		VIDEOR E. Hartig GmbH
+60271C     (base 16)		VIDEOR E. Hartig GmbH
+				Carl-Zeiss-Straße 8
+				Rödermark  Hessen  63322
+				DE
+
+00-EC-0A   (hex)		Xiaomi Communications Co Ltd
+00EC0A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C8-D7-B0   (hex)		Samsung Electronics Co.,Ltd
+C8D7B0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+6C-60-EB   (hex)		ZHI YUAN ELECTRONICS CO., LIMITED
+6C60EB     (base 16)		ZHI YUAN ELECTRONICS CO., LIMITED
+				UNIT 2508A 25/F BANK OF AMERICA TOWER， 12 HARCOURT RD CENTRAL 
+				HONGKONG    999077
+				HK
+
+74-DA-DA   (hex)		D-Link International
+74DADA     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+D8-F1-F0   (hex)		Pepxim International Limited
+D8F1F0     (base 16)		Pepxim International Limited
+				A5, 5/F, HK Spinners Industrial Building, Phase 6
+				Cheung Sha Wan  Hong Kong  0
+				HK
+
+DC-C8-F5   (hex)		Shanghai UMEinfo CO.,LTD.
+DCC8F5     (base 16)		Shanghai UMEinfo CO.,LTD.
+				16/F,Building B ,NO.15 Changyi Road ,Baoshan District,
+				Shanghai    200441
+				CN
+
+88-D7-F6   (hex)		ASUSTek COMPUTER INC.
+88D7F6     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+90-97-F3   (hex)		Samsung Electronics Co.,Ltd
+9097F3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-1C-68   (hex)		Samsung Electronics Co.,Ltd
+7C1C68     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-87-EB   (hex)		Samsung Electronics Co.,Ltd
+C087EB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-71-4B   (hex)		IEEE Registration Authority
+04714B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+2C-41-A1   (hex)		Bose Corporation
+2C41A1     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+4C-38-D8   (hex)		ARRIS Group, Inc.
+4C38D8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-7B-BB   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+447BBB     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+9C-7B-D2   (hex)		NEOLAB Convergence
+9C7BD2     (base 16)		NEOLAB Convergence
+				4F Yujung bldg.,
+				Seoul    137-070
+				KR
+
+D0-F8-8C   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+D0F88C     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+2C-B1-15   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+2CB115     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+10-D0-7A   (hex)		AMPAK Technology, Inc.
+10D07A     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+D4-C1-C8   (hex)		zte corporation
+D4C1C8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+88-D2-74   (hex)		zte corporation
+88D274     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-24-49   (hex)		Shen Zhen Lite Star Electronics Technology Co., Ltd
+002449     (base 16)		Shen Zhen Lite Star Electronics Technology Co., Ltd
+				Xinghong Science Park,1st Ind.Area,
+				ShenZhen  GuangDong  518102
+				CN
+
+00-E1-8C   (hex)		Intel Corporate
+00E18C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+84-79-33   (hex)		profichip GmbH
+847933     (base 16)		profichip GmbH
+				Einsteinstrasse 6
+				Herzogenaurach    91074
+				DE
+
+88-15-44   (hex)		Cisco Meraki
+881544     (base 16)		Cisco Meraki
+				660 Alabama St
+				San Francisco  CA  94110
+				US
+
+C4-AB-B2   (hex)		vivo Mobile Communication Co., Ltd.
+C4ABB2     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+80-B2-34   (hex)		Technicolor CH USA Inc.
+80B234     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+44-B4-12   (hex)		SIUS AG
+44B412     (base 16)		SIUS AG
+				Im Langhag 1
+				Effretikon    8307
+				CH
+
+0C-B9-12   (hex)		JM-DATA GmbH
+0CB912     (base 16)		JM-DATA GmbH
+				Hackl-Str. 1
+				Traun  Upper Austria  4050
+				AT
+
+3C-A3-08   (hex)		Texas Instruments
+3CA308     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F4-3E-61   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+F43E61     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				2F Baiying Building
+				Shenzhen  Guangdong  518067
+				CN
+
+B4-41-7A   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+B4417A     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				4F,Baiying Building, No.1019,Nanhai RD,Shekou
+				ShenZhen  GuangDong  518067
+				CN
+
+18-52-07   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+185207     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+00-00-62   (hex)		BULL HN INFORMATION SYSTEMS
+000062     (base 16)		BULL HN INFORMATION SYSTEMS
+				300 CONCORD ROAD M/S 864A
+				BILLERICA  MA  01821
+				US
+
+E8-C1-D7   (hex)		Philips
+E8C1D7     (base 16)		Philips
+				TussenDiepen 4
+				Drachten  Friesland  9206 AD  
+				NL
+
+4C-81-20   (hex)		Taicang T&W Electronics
+4C8120     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+28-A6-DB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+28A6DB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-A0-F8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14A0F8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-F8-6D   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+C8F86D     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+60-45-CB   (hex)		ASUSTek COMPUTER INC.
+6045CB     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+00-11-8B   (hex)		Alcatel-Lucent Enterprise
+00118B     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				Calabasas  CA  91301
+				US
+
+00-E0-B1   (hex)		Alcatel-Lucent Enterprise
+00E0B1     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				Calabasas  CA  91301
+				US
+
+00-E0-DA   (hex)		Alcatel-Lucent Enterprise
+00E0DA     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				CALABASAS  CA  91301
+				US
+
+F8-BE-0D   (hex)		A2UICT Co.,Ltd.
+F8BE0D     (base 16)		A2UICT Co.,Ltd.
+				1202, OWNER'S TOWER, 28,
+				Hwangsaeul-ro 200 beon-gil, Bundang-gu,  Seongnam-si, Gyeonggi-do  13595
+				KR
+
+E4-42-A6   (hex)		Intel Corporate
+E442A6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+3C-67-8C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C678C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-50-3F   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+D4503F     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+38-8C-50   (hex)		LG Electronics
+388C50     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+DC-08-56   (hex)		Alcatel-Lucent Enterprise
+DC0856     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Rd
+				Calabasas  CA  91301
+				US
+
+1C-DA-27   (hex)		vivo Mobile Communication Co., Ltd.
+1CDA27     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+90-F3-05   (hex)		HUMAX Co., Ltd.
+90F305     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+40-95-BD   (hex)		NTmore.Co.,Ltd
+4095BD     (base 16)		NTmore.Co.,Ltd
+				38, Heungan-daero 427 beon-gil, Dongan-gu
+				Anyang  Gyeonggi  431-801
+				KR
+
+98-AA-FC   (hex)		IEEE Registration Authority
+98AAFC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-14-3F   (hex)		Hotway Technology Corporation
+00143F     (base 16)		Hotway Technology Corporation
+				3F.-4, No.81, Sec. 1, Xintai 5th Rd.
+				Xizhi Dist.  New Taipei City  22101
+				TW
+
+D0-55-B2   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+D055B2     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+14-4F-D7   (hex)		IEEE Registration Authority
+144FD7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B8-55-10   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+B85510     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				A1&A2 Building,Lantian Technology Park, Xinyu Road, Xingqiao Henggang Block, Shajing Street,
+				Shenzhen  Guangdong  518000
+				CN
+
+04-95-73   (hex)		zte corporation
+049573     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-D7-AA   (hex)		Motorola Mobility LLC, a Lenovo Company
+F0D7AA     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+F8-FF-0B   (hex)		Electronic Technology Inc.
+F8FF0B     (base 16)		Electronic Technology Inc.
+				511 Lyons Ave
+				Irvington  NJ  07111
+				US
+
+7C-6B-F7   (hex)		NTI co., ltd.
+7C6BF7     (base 16)		NTI co., ltd.
+				5th floor takei building 2-19-6
+				taito  taito-ku , Tokyo  1100016
+				JP
+
+00-D3-18   (hex)		SPG Controls
+00D318     (base 16)		SPG Controls
+				Blue gates business park Stortford road
+				Dunmow  Essex  CM61SN
+				GB
+
+30-96-FB   (hex)		Samsung Electronics Co.,Ltd
+3096FB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+48-27-EA   (hex)		Samsung Electronics Co.,Ltd
+4827EA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-78-7E   (hex)		Samsung Electronics Co.,Ltd
+7C787E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-5B-A7   (hex)		Apple, Inc.
+245BA7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-F0-87   (hex)		Apple, Inc.
+70F087     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-C6-3C   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+E0C63C     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+00-0C-46   (hex)		Allied Telesyn Inc.
+000C46     (base 16)		Allied Telesyn Inc.
+				960 Stewart Drive, Suite B
+				Sunnyvale  California  94085
+				US
+
+00-1F-72   (hex)		QingDao Hiphone Technology Co,.Ltd
+001F72     (base 16)		QingDao Hiphone Technology Co,.Ltd
+				NO.106,JiangXi Road
+				QingDao  ShanDong  266071
+				CN
+
+00-23-65   (hex)		Insta Elektro GmbH
+002365     (base 16)		Insta Elektro GmbH
+				Hohe Steinert 10
+				Luedenscheid  NRW  58509
+				DE
+
+60-91-F3   (hex)		vivo Mobile Communication Co., Ltd.
+6091F3     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+28-39-5E   (hex)		Samsung Electronics Co.,Ltd
+28395E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+38-29-5A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+38295A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+88-E6-28   (hex)		Shenzhen Kezhonglong Optoelectronic Technology Co.,Ltd
+88E628     (base 16)		Shenzhen Kezhonglong Optoelectronic Technology Co.,Ltd
+				Floor 3, Bldg. 5, Area B, Xinfu Industrial Park, Chongqing Rd., Baoan Dist,Shenzhen,Guangdong, China
+				Shenzhen   Guangdong  518103
+				CN
+
+58-23-8C   (hex)		Technicolor CH USA Inc.
+58238C     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+CC-82-EB   (hex)		KYOCERA CORPORATION 
+CC82EB     (base 16)		KYOCERA CORPORATION 
+				 2-1-1,Kagahara, Tsuzuki-ku,
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+14-98-7D   (hex)		Technicolor CH USA Inc.
+14987D     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+D4-CF-37   (hex)		Symbolic IO
+D4CF37     (base 16)		Symbolic IO
+				101 Crawfords Corner Rd.
+				Holmdel  NJ  07733
+				US
+
+D4-7D-FC   (hex)		TECNO MOBILE LIMITED
+D47DFC     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+40-9F-38   (hex)		AzureWave Technology Inc.
+409F38     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+BC-2F-3D   (hex)		vivo Mobile Communication Co., Ltd.
+BC2F3D     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+40-FA-7F   (hex)		Preh Car Connect GmbH
+40FA7F     (base 16)		Preh Car Connect GmbH
+				Gewerbepark 5
+				Dresden    01156
+				DE
+
+00-0D-BB   (hex)		Nippon Dentsu Co.,Ltd.
+000DBB     (base 16)		Nippon Dentsu Co.,Ltd.
+				2-21-1,Isoji
+				Osaka    552-0003
+				JP
+
+2C-7E-81   (hex)		ARRIS Group, Inc.
+2C7E81     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-7D-0F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+407D0F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+68-CC-6E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+68CC6E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-34-D2   (hex)		Availink, Inc.
+3034D2     (base 16)		Availink, Inc.
+				Scotia Centre P.O. Box 268GT,Grand Cayman, Cayman Islands
+				Grand Cayman  Grand Cayman  999159
+				KY
+
+50-40-61   (hex)		Nokia
+504061     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-10-8E   (hex)		HUGH SYMONS CONCEPT Technologies Ltd.
+00108E     (base 16)		HUGH SYMONS CONCEPT Technologies Ltd.
+				Alder Hills Park
+				Poole, Dorset BM12 4AR    
+				GB
+
+E0-51-63   (hex)		Arcadyan Corporation
+E05163     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+54-E3-F6   (hex)		Alcatel-Lucent
+54E3F6     (base 16)		Alcatel-Lucent
+				777 East Middlefield Road
+				Mountain View  CA  94043
+				US
+
+40-B0-34   (hex)		Hewlett Packard
+40B034     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+B8-16-DB   (hex)		CHANT SINCERE CO.,LTD
+B816DB     (base 16)		CHANT SINCERE CO.,LTD
+				7F-2,NO.188,SEC.3,TA TUNG ROAD
+				XIZHI DISTRICT, NEW TAIPEI CITY  TAIWAN,ROC  22103
+				TW
+
+40-B4-CD   (hex)		Amazon Technologies Inc.
+40B4CD     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+D4-81-D7   (hex)		Dell Inc.
+D481D7     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+F4-2B-48   (hex)		Ubiqam
+F42B48     (base 16)		Ubiqam
+				15 Gonen 
+				Petah Tiqva    4925915
+				IL
+
+50-F1-4A   (hex)		Texas Instruments
+50F14A     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+04-DE-F2   (hex)		Shenzhen ECOM Technology Co. Ltd
+04DEF2     (base 16)		Shenzhen ECOM Technology Co. Ltd
+				Longhua Street Qinghu Community Longhu Junhui Fashion Apartment
+				 Longhua New District, Shenzhen  Guangdong  518012
+				CN
+
+78-C1-A7   (hex)		zte corporation
+78C1A7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+4C-78-72   (hex)		Cav. Uff. Giacomo Cimberio S.p.A. 
+4C7872     (base 16)		Cav. Uff. Giacomo Cimberio S.p.A. 
+				Via Torchio, 57
+				San Maurizio d'Opaglio  (Novara)  28017
+				IT
+
+8C-F5-A3   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+8CF5A3     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+8C-C8-F4   (hex)		IEEE Registration Authority
+8CC8F4     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F4-83-E1   (hex)		Shanghai Clouder Semiconductor Co.,Ltd
+F483E1     (base 16)		Shanghai Clouder Semiconductor Co.,Ltd
+				Room515,No.8,Wuzhong Rd,Xuhui District
+				Shanghai  Shanghai  200336
+				CN
+
+08-3E-5D   (hex)		Sagemcom Broadband SAS
+083E5D     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+3C-BD-3E   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+3CBD3E     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+64-1A-22   (hex)		Heliospectra AB
+641A22     (base 16)		Heliospectra AB
+				Frans Perssons väg 6
+				    
+				SE
+
+A0-84-CB   (hex)		SonicSensory,Inc.
+A084CB     (base 16)		SonicSensory,Inc.
+				1161 Logan St
+				Los Angeles  CA  90026
+				US
+
+D4-7A-E2   (hex)		Samsung Electronics Co.,Ltd
+D47AE2     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+68-54-FD   (hex)		Amazon Technologies Inc.
+6854FD     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-03-BC   (hex)		COT GmbH
+0003BC     (base 16)		COT GmbH
+				Güterstraße 5
+				    
+				DE
+
+D4-B1-69   (hex)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+D4B169     (base 16)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+				,Le Shi Building, No.105 Yaojiayuan Road,Chaoyang District,Beijing,China
+				beijing  beijing  100025
+				CN
+
+E4-47-90   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+E44790     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+38-45-4C   (hex)		Light Labs, Inc.
+38454C     (base 16)		Light Labs, Inc.
+				636 Ramona St.
+				Palo Alto  CA  94301
+				US
+
+00-0A-49   (hex)		F5 Networks, Inc.
+000A49     (base 16)		F5 Networks, Inc.
+				401 Elliott Ave. W.
+				Seattle  WA  98119
+				US
+
+00-A0-C8   (hex)		Adtran Inc
+00A0C8     (base 16)		Adtran Inc
+				901 EXPLORER BLVD.
+				HUNTSVILLE  AL  35806-2807
+				US
+
+F4-96-51   (hex)		NAKAYO Inc
+F49651     (base 16)		NAKAYO Inc
+				1-3-2, Soja-machi
+				Maebashi-shi  Gunma  371-0853
+				JP
+
+44-62-46   (hex)		Comat AG
+446246     (base 16)		Comat AG
+				Bernstrasse 4
+				Worb    3076
+				CH
+
+34-FC-B9   (hex)		Hewlett Packard Enterprise
+34FCB9     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+70-91-8F   (hex)		Weber-Stephen Products LLC
+70918F     (base 16)		Weber-Stephen Products LLC
+				1415 S. Roselle Rd
+				Palatine  IL  60067
+				US
+
+D8-E0-E1   (hex)		Samsung Electronics Co.,Ltd
+D8E0E1     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+7C-10-15   (hex)		Brilliant Home Technology, Inc.
+7C1015     (base 16)		Brilliant Home Technology, Inc.
+				762 Judith Ct
+				Incline Village  NV  89451
+				US
+
+D8-C7-71   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D8C771     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E0-2A-82   (hex)		Universal Global Scientific Industrial Co., Ltd.
+E02A82     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+B0-F9-63   (hex)		Hangzhou H3C Technologies Co., Limited
+B0F963     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+D4-90-E0   (hex)		Topcon Electronics GmbH & Co. KG
+D490E0     (base 16)		Topcon Electronics GmbH & Co. KG
+				Industriestraße 7
+				Geisenheim    65366
+				DE
+
+A8-40-41   (hex)		Dragino Technology Co., Limited
+A84041     (base 16)		Dragino Technology Co., Limited
+				303, Block B, No 8; 349, Jian'An 1 Road,Bao'An
+				Shenzhen  GuangDong  518101
+				CN
+
+E0-22-02   (hex)		ARRIS Group, Inc.
+E02202     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D8-25-B0   (hex)		Rockeetech Systems Co.,Ltd.
+D825B0     (base 16)		Rockeetech Systems Co.,Ltd.
+				Unit 201, #6 Lane 51, Shuicheng S Rd.
+				Shanghai    201103
+				CN
+
+74-61-4B   (hex)		Chongqing Huijiatong Information Technology Co., Ltd.
+74614B     (base 16)		Chongqing Huijiatong Information Technology Co., Ltd.
+				Yubei District Longxi Street Hongjin Road No. 498, building  Jialeziguang No.1 12-12, 12-13, 12-13, 12-14, 12-15
+				Chongqing  Chongqing City  401120
+				CN
+
+98-D2-93   (hex)		Google, Inc.
+98D293     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+CC-B8-A8   (hex)		AMPAK Technology, Inc.
+CCB8A8     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+10-77-B0   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+1077B0     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+F0-1D-BC   (hex)		Microsoft Corporation
+F01DBC     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+34-04-9E   (hex)		IEEE Registration Authority
+34049E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-FB-29   (hex)		Zebra Technologies Inc.
+94FB29     (base 16)		Zebra Technologies Inc.
+				ONE ZEBRA PLAZA
+				HOLTSVILLE  NY  11742
+				US
+
+B0-70-2D   (hex)		Apple, Inc.
+B0702D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-19-C0   (hex)		Apple, Inc.
+6C19C0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-20-4F   (hex)		DEUTSCHE AEROSPACE AG
+00204F     (base 16)		DEUTSCHE AEROSPACE AG
+				GESCHAEFTSFELD
+				  BUNDESREPUBLIK  DEUTSCHLAND
+				DE
+
+00-DB-DF   (hex)		Intel Corporate
+00DBDF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+94-A0-4E   (hex)		Bostex Technology Co., LTD
+94A04E     (base 16)		Bostex Technology Co., LTD
+				NO.148 West MinZhou Road
+				Cixi City  Zhejiang Province  315301
+				CN
+
+8C-E1-17   (hex)		zte corporation
+8CE117     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+68-8A-F0   (hex)		zte corporation
+688AF0     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C0-21-0D   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+C0210D     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+4C-E2-F1   (hex)		sclak srl
+4CE2F1     (base 16)		sclak srl
+				via borgonuovo 7
+				milano  mi  20121
+				IT
+
+50-4B-5B   (hex)		CONTROLtronic GmbH
+504B5B     (base 16)		CONTROLtronic GmbH
+				Schragenhofstr. 35
+				Munich    80992
+				DE
+
+B4-74-47   (hex)		CoreOS
+B47447     (base 16)		CoreOS
+				PO Box 7775 #55097
+				San Francisco  CA  94120-7775
+				US
+
+80-D4-A5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80D4A5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-B0-E7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04B0E7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-6A-2E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+446A2E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-8D-DB   (hex)		Cisco Meraki
+0C8DDB     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+B0-EE-7B   (hex)		Roku, Inc
+B0EE7B     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+AC-58-7B   (hex)		JCT Healthcare
+AC587B     (base 16)		JCT Healthcare
+				1/25 London Road
+				Mile End South  South Australia  5031
+				AU
+
+10-62-EB   (hex)		D-Link International
+1062EB     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+00-08-94   (hex)		InnoVISION Multimedia Ltd.
+000894     (base 16)		InnoVISION Multimedia Ltd.
+				Rm 608, 6/F Tins Enterprises Centre,
+				Kowloon,    
+				HK
+
+48-00-33   (hex)		Technicolor CH USA Inc.
+480033     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+A0-6F-AA   (hex)		LG Innotek
+A06FAA     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+00-26-AB   (hex)		Seiko Epson Corporation
+0026AB     (base 16)		Seiko Epson Corporation
+				3-3-5 OWA
+				SUWA-SHI  NAGANO-KEN  392-8502
+				JP
+
+FC-10-C6   (hex)		Taicang T&W Electronics
+FC10C6     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+2C-6F-C9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+2C6FC9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+58-EF-68   (hex)		Belkin International Inc.
+58EF68     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  null  90094
+				US
+
+00-0B-4F   (hex)		Verifone
+000B4F     (base 16)		Verifone
+				2099 Gateway Place
+				San Jose    95110
+				US
+
+60-C7-98   (hex)		Verifone
+60C798     (base 16)		Verifone
+				2455 Augustine Drive
+				Santa Clara  California  95054
+				
+
+C8-66-2C   (hex)		Beijing Haitai Fangyuan High Technology Co,.Ltd.
+C8662C     (base 16)		Beijing Haitai Fangyuan High Technology Co,.Ltd.
+				B1st&2nd  floor,Unit E，NO.9 Building,Zhongguancun Software Park,Dongbeiwang West Road 8.Haidian District,Beijing
+				Bei Jing    100094
+				CN
+
+80-96-CA   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+8096CA     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+18-65-71   (hex)		Top Victory Electronics (Taiwan) Co., Ltd.
+186571     (base 16)		Top Victory Electronics (Taiwan) Co., Ltd.
+				14F,No.166,Jian 1st Rd
+				New Taipei City  Taiwan  23511
+				TW
+
+F8-3F-51   (hex)		Samsung Electronics Co.,Ltd
+F83F51     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+50-D7-53   (hex)		CONELCOM GmbH
+50D753     (base 16)		CONELCOM GmbH
+				Trientlgasse 18c
+				Innsbruck    6020
+				AT
+
+0C-C4-7A   (hex)		Super Micro Computer, Inc.
+0CC47A     (base 16)		Super Micro Computer, Inc.
+				980 Rock Avenue
+				San Jose  California  95131
+				US
+
+34-D2-70   (hex)		Amazon Technologies Inc.
+34D270     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+50-79-5B   (hex)		Interexport Telecomunicaciones S.A.
+50795B     (base 16)		Interexport Telecomunicaciones S.A.
+				Cerro Colorado 5240 piso 14
+				Santiago  Region Metropolitana  8320000
+				US
+
+00-16-D9   (hex)		NINGBO BIRD CO.,LTD.
+0016D9     (base 16)		NINGBO BIRD CO.,LTD.
+				No.999 Dacheng East Road
+				Fenghua  Zhejiang  315500
+				CN
+
+6C-A7-FA   (hex)		YOUNGBO ENGINEERING INC.
+6CA7FA     (base 16)		YOUNGBO ENGINEERING INC.
+				132, Haewian-gil, Dunpo-myeon
+				Asan-si  Chungcheongnam-do  336-873
+				KR
+
+8C-7E-B3   (hex)		Lytro, Inc.
+8C7EB3     (base 16)		Lytro, Inc.
+				1300  Terra Bella Avenue
+				Mountain View  California  94043
+				US
+
+B4-B3-84   (hex)		ShenZhen Figigantic Electronic Co.,Ltd
+B4B384     (base 16)		ShenZhen Figigantic Electronic Co.,Ltd
+				5F NO.1 Bld East,Guole Industrial Zone,Lirong Road,Longhua New
+				ShenZhen  GuangDong  518109
+				CN
+
+78-28-CA   (hex)		Sonos, Inc.
+7828CA     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+00-C0-03   (hex)		GLOBALNET COMMUNICATIONS
+00C003     (base 16)		GLOBALNET COMMUNICATIONS
+				912, PLACE TRANS CANADA
+				CANADA  J4G  2M1
+				CA
+
+00-23-4A   (hex)		Private
+00234A     (base 16)		Private
+
+2C-40-2B   (hex)		Smart iBlue Technology Limited
+2C402B     (base 16)		Smart iBlue Technology Limited
+				Unit 12, 10/F., Hong Man Industrial Centre,2 Hong Man Street, Chai Wan, Hong Kong
+				Hong Kong    000
+				HK
+
+5C-6B-4F   (hex)		Hello Inc.
+5C6B4F     (base 16)		Hello Inc.
+				438 Shotwell Street
+				San Francisco  CA  94110
+				US
+
+2C-99-24   (hex)		ARRIS Group, Inc.
+2C9924     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D0-58-A8   (hex)		zte corporation
+D058A8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D0-71-C4   (hex)		zte corporation
+D071C4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A0-CC-2B   (hex)		Murata Manufacturing Co., Ltd.
+A0CC2B     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+50-01-D9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5001D9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-27-1C   (hex)		MERCURY CORPORATION
+00271C     (base 16)		MERCURY CORPORATION
+				90, Gajaeul-ro, Seo-gu
+				INCHEON    22830
+				KR
+
+E0-D9-E3   (hex)		Eltex Enterprise Ltd.
+E0D9E3     (base 16)		Eltex Enterprise Ltd.
+				Okruzhnaya st. 29v
+				Novosibirsk    630020
+				RU
+
+80-5E-C0   (hex)		YEALINK(XIAMEN) NETWORK TECHNOLOGY CO.,LTD.
+805EC0     (base 16)		YEALINK(XIAMEN) NETWORK TECHNOLOGY CO.,LTD.
+				309, 3th Floor, No.16, Yun Ding North Road, Huli District
+				xiamen  Fujian  361015
+				CN
+
+00-7B-18   (hex)		SENTRY Co., LTD.
+007B18     (base 16)		SENTRY Co., LTD.
+				792,Pyeongcheon-ro,Wonmi-gu
+				Bucheon-si, Gyeonggi-do    420-805
+				KR
+
+14-4D-67   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+144D67     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				A1&A2 Building,Lantian Technology Park, Xinyu Road, Xingqiao Henggang Block, Shajing Street, Baoan District
+				Shenzhen  Guangdong  518000
+				CN
+
+4C-E1-73   (hex)		IEEE Registration Authority
+4CE173     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-D8-6C   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+0CD86C     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+04-97-90   (hex)		Lartech telecom LLC
+049790     (base 16)		Lartech telecom LLC
+				Bolshoi Sampsonievski 68, lit. N, office 237
+				Saint-Petersburg    194100
+				RU
+
+28-EE-D3   (hex)		Shenzhen Super D Technology Co., Ltd
+28EED3     (base 16)		Shenzhen Super D Technology Co., Ltd
+				Room 201 , Building A former Qianhai Shenzhen-Hong Kong cooperation zone Shenzhen Bay all the way to No. 1 ( settled in Shenzhen Qianhai Business Secretary , Ltd. )
+				Shenzhen  Guangdong  518000
+				CN
+
+24-C4-4A   (hex)		zte corporation
+24C44A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+98-54-1B   (hex)		Intel Corporate
+98541B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+1C-40-E8   (hex)		SHENZHEN PROGRESS&WIN TECHNOLOGY CO.,LTD
+1C40E8     (base 16)		SHENZHEN PROGRESS&WIN TECHNOLOGY CO.,LTD
+				9F, K1 Mall, Xinsha street, Shajing District, Baoan
+				Shenzhen  Guangdong  518000
+				CN
+
+00-23-D2   (hex)		Inhand Electronics, Inc.
+0023D2     (base 16)		Inhand Electronics, Inc.
+				30 West Gude Drive
+				Rockville  Maryland  20850
+				US
+
+DC-0B-34   (hex)		LG Electronics (Mobile Communications)
+DC0B34     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+40-4E-36   (hex)		HTC Corporation
+404E36     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+A8-E7-05   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+A8E705     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+98-40-BB   (hex)		Dell Inc.
+9840BB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-60-D6   (hex)		NovAtel Inc.
+0060D6     (base 16)		NovAtel Inc.
+				SUITE 200, 6715-8TH STREET NE
+				CALGARY, ALBERTA T2E 8M4    0000
+				CA
+
+50-3A-A0   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+503AA0     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-95-8E   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B0958E     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+C0-25-E9   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C025E9     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+80-2A-A8   (hex)		Ubiquiti Networks Inc.
+802AA8     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Parkway
+				San Jose  CA  95131
+				US
+
+F0-9F-C2   (hex)		Ubiquiti Networks Inc.
+F09FC2     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Parkway
+				San Jose  CA  95131
+				US
+
+18-8B-15   (hex)		ShenZhen ZhongRuiJing Technology co.,LTD
+188B15     (base 16)		ShenZhen ZhongRuiJing Technology co.,LTD
+				4th Floor,Building 3,Meng Liyuan Industrial Park, Yousong Road, Longhua New District,Shenzhen,Guangdong Province,China
+				Shenzhen  Guangdong  518109
+				CN
+
+78-8A-20   (hex)		Ubiquiti Networks Inc.
+788A20     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+88-6B-0F   (hex)		Bluegiga Technologies OY
+886B0F     (base 16)		Bluegiga Technologies OY
+				P.O. BOX 120
+				FIN-02631  Espoo  
+				FI
+
+AC-84-C9   (hex)		Sagemcom Broadband SAS
+AC84C9     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+24-5C-BF   (hex)		NCSE
+245CBF     (base 16)		NCSE
+				Future of China Electronics Science & Technology
+				Beijing  Changping District  102200
+				CN
+
+2C-33-61   (hex)		Apple, Inc.
+2C3361     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-A4-D0   (hex)		Samsung Electronics Co.,Ltd
+60A4D0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-87-01   (hex)		Samsung Electronics Co.,Ltd
+008701     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+5C-99-60   (hex)		Samsung Electronics Co.,Ltd
+5C9960     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-62-AB   (hex)		Sumavision Technologies Co.,Ltd
+9C62AB     (base 16)		Sumavision Technologies Co.,Ltd
+				6F, Block A2, Power Creative Building,No.1 Shangdi East Road, Haidian District
+				Beijing    100085
+				CN
+
+C8-F9-46   (hex)		LOCOSYS Technology Inc.
+C8F946     (base 16)		LOCOSYS Technology Inc.
+				20F.-13, No. 79, Sec. 1, Xintai 5th Rd, Xizhi Dist.
+				New Taipei City  Taiwan  22101
+				TW
+
+48-7B-6B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+487B6B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-3F-D3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+883FD3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-0D-65   (hex)		Shenzhen Vsun Communication Technology Co., Ltd.
+240D65     (base 16)		Shenzhen Vsun Communication Technology Co., Ltd.
+				3/F., 19 Block, Wisdomland Business Park, No.2 Nantou Gateway Road, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+00-0B-14   (hex)		ViewSonic Corporation
+000B14     (base 16)		ViewSonic Corporation
+				381 Brea Canyon Road
+				Walnut  California  91789
+				US
+
+C8-02-8F   (hex)		Nova Electronics (Shanghai) Co., Ltd.
+C8028F     (base 16)		Nova Electronics (Shanghai) Co., Ltd.
+				Room B706, 7th Floor, MET Plaza, No.268 Tongxie Road
+				Shanghai  Changning District  200335
+				CN
+
+A4-60-11   (hex)		Verifone
+A46011     (base 16)		Verifone
+				2099 Gateway Place
+				San Jose  CA  95110
+				US
+
+5C-A9-33   (hex)		Luma Home
+5CA933     (base 16)		Luma Home
+				75 5th St
+				Atlanta  GA  30308
+				US
+
+00-13-7E   (hex)		CorEdge Networks, Inc.
+00137E     (base 16)		CorEdge Networks, Inc.
+				7600 Boone Ave N
+				Brooklyn Park  MN  55428
+				US
+
+D8-14-D6   (hex)		SURE SYSTEM Co Ltd
+D814D6     (base 16)		SURE SYSTEM Co Ltd
+				Bakurou-machi 4-7-5
+				Cyuou-ku  Osaka  541-0059
+				JP
+
+6C-EF-C6   (hex)		SHENZHEN TWOWING TECHNOLOGIES CO.,LTD.
+6CEFC6     (base 16)		SHENZHEN TWOWING TECHNOLOGIES CO.,LTD.
+				Nangang Industrial Building, Tangtou Industrial Park, Shiyan, Baoan
+				Shenzhen  Guangdong  518108
+				CN
+
+10-1D-C0   (hex)		Samsung Electronics Co.,Ltd
+101DC0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-23-41   (hex)		Vanderbilt International (SWE) AB 
+002341     (base 16)		Vanderbilt International (SWE) AB 
+				Englundavaegen 7
+				Solna    SE-171 41 
+				SE
+
+40-7C-7D   (hex)		Nokia
+407C7D     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+24-59-0B   (hex)		White Sky Inc. Limited
+24590B     (base 16)		White Sky Inc. Limited
+				Floor 5, Building 1, No. 6, Lane 365, Xinhua Road
+				Shanghai    200052
+				CN
+
+68-EB-AE   (hex)		Samsung Electronics Co.,Ltd
+68EBAE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-4E-1A   (hex)		Samsung Electronics Co.,Ltd
+444E1A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-33-65   (hex)		TEM Mobile Limited
+143365     (base 16)		TEM Mobile Limited
+				RM1703, North Block, Cangsong Building, Tairan 6 road, Futian District, Shenzhen.
+				Shenzhen  Guangdong  518000
+				CN
+
+80-18-44   (hex)		Dell Inc.
+801844     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+78-47-1D   (hex)		Samsung Electronics Co.,Ltd
+78471D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-75-91   (hex)		Samsung Electronics Co.,Ltd
+A07591     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-DF-A4   (hex)		Samsung Electronics Co.,Ltd
+0CDFA4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-72-BF   (hex)		Murata Manufacturing Co., Ltd.
+B072BF     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+70-1D-C4   (hex)		NorthStar Battery Company, LLC
+701DC4     (base 16)		NorthStar Battery Company, LLC
+				4000 Continental Way
+				Springfield  MO  65803
+				US
+
+64-DA-A0   (hex)		Robert Bosch Smart Home GmbH
+64DAA0     (base 16)		Robert Bosch Smart Home GmbH
+				Schockenriedstraße 17
+				Stuttgart    70565
+				DE
+
+14-B8-37   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+14B837     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+5C-86-13   (hex)		Beijing Zhoenet Technology Co., Ltd
+5C8613     (base 16)		Beijing Zhoenet Technology Co., Ltd
+				Room B16,No. 8 WenHua East Road,Changping District
+				Beijing  Beijing  102208
+				CN
+
+CC-73-14   (hex)		HONG KONG WHEATEK TECHNOLOGY LIMITED
+CC7314     (base 16)		HONG KONG WHEATEK TECHNOLOGY LIMITED
+				Building 20，No.2277, ZuChongZhi Road, PuDong District, Shanghai
+				shanghai    201203
+				CN
+
+B8-EE-65   (hex)		Liteon Technology Corporation
+B8EE65     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+98-5B-B0   (hex)		KMDATA INC.
+985BB0     (base 16)		KMDATA INC.
+				505-2, Daeryung Techno Town 1cha, 18, Gasan Digital 2-ro, Geumcheon-gu
+				Seoul    153771
+				KR
+
+E0-06-E6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+E006E6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+BC-85-56   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+BC8556     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+34-23-87   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+342387     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-26-37   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+002637     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Metan dong
+				Suwon  Kyung-ki do  443-743
+				KR
+
+00-21-19   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+002119     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Metan 3 dong
+				Suwon  Kyung-gi do  443-743
+				KR
+
+F4-D9-FB   (hex)		Samsung Electronics Co.,Ltd
+F4D9FB     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu,
+				Suwon  Gyeonggi-do  443-742
+				KR
+
+3C-62-00   (hex)		Samsung Electronics Co.,Ltd
+3C6200     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu,
+				Suwon-City  Gyeonggi-do  443-742
+				KR
+
+C4-17-FE   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C417FE     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+94-39-E5   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9439E5     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+64-27-37   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+642737     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+A4-17-31   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+A41731     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+5C-A3-9D   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+5CA39D     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon    443-743
+				US
+
+90-18-7C   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+90187C     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon  KYUNGGI-DO  443-743
+				KR
+
+50-CC-F8   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+50CCF8     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				Metan Dong 314, Youngtong Gu
+				Suwon  Kyung-gi Do.  443-743
+				KR
+
+00-22-3B   (hex)		Communication Networks, LLC
+00223B     (base 16)		Communication Networks, LLC
+				3 Corporate Drive
+				Danbury  CT  06810
+				US
+
+C0-F8-DA   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C0F8DA     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-11-FF   (hex)		Digitro Tecnologia Ltda
+0011FF     (base 16)		Digitro Tecnologia Ltda
+				Rua: Professora Sofia Quint de Souza, 167
+				Florianópolis  Santa Catarina  88085-040
+				BR
+
+00-1B-94   (hex)		T.E.M.A. S.p.A.
+001B94     (base 16)		T.E.M.A. S.p.A.
+				via della Scienza 21 A/C
+				Castelnuovo Rangone  Modena  41051
+				IT
+
+F0-F0-02   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F0F002     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C0-CB-38   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C0CB38     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+F0-7B-CB   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F07BCB     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+50-B7-C3   (hex)		Samsung Electronics Co.,Ltd
+50B7C3     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon  Geyonggi  443742
+				KR
+
+1C-5A-3E   (hex)		Samsung Electronics Co.,Ltd
+1C5A3E     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3dong, Yeongtong-Gu
+				Suwon    443742
+				US
+
+A0-21-95   (hex)		Samsung Electronics Co.,Ltd
+A02195     (base 16)		Samsung Electronics Co.,Ltd
+				#416, Maetan 3-dong
+				Suwon-si  Gyeonggi-do  443-742
+				KR
+
+B0-78-70   (hex)		Wi-NEXT, Inc.
+B07870     (base 16)		Wi-NEXT, Inc.
+				530 Lytton Avenue
+				Palo Alto  CA  94301
+				US
+
+E4-7C-F9   (hex)		Samsung Electronics Co.,Ltd
+E47CF9     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon  Gyeonggi-do  443742
+				KR
+
+48-44-F7   (hex)		Samsung Electronics Co.,Ltd
+4844F7     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon  Gyeonggi-do  443742
+				KR
+
+00-13-77   (hex)		Samsung Electronics Co.,Ltd
+001377     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon  Geyonggi  443742
+				KR
+
+00-24-54   (hex)		Samsung Electronics Co.,Ltd
+002454     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon  Geyonggi  443742
+				KR
+
+E8-11-32   (hex)		Samsung Electronics Co.,Ltd
+E81132     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon  Geyonggi  443742
+				KR
+
+C0-65-99   (hex)		Samsung Electronics Co.,Ltd
+C06599     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-79-AD   (hex)		Samsung Electronics Co.,Ltd
+BC79AD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+4C-3C-16   (hex)		Samsung Electronics Co.,Ltd
+4C3C16     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-73-E0   (hex)		Samsung Electronics Co.,Ltd
+0073E0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-17-D5   (hex)		Samsung Electronics Co.,Ltd
+0017D5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+00-1E-7D   (hex)		Samsung Electronics Co.,Ltd
+001E7D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1D-F6   (hex)		Samsung Electronics Co.,Ltd
+001DF6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-08-F1   (hex)		Samsung Electronics Co.,Ltd
+F008F1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+58-C3-8B   (hex)		Samsung Electronics Co.,Ltd
+58C38B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-E3-B2   (hex)		Samsung Electronics Co.,Ltd
+00E3B2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-19-66   (hex)		Samsung Electronics Co.,Ltd
+301966     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-E7-7E   (hex)		Samsung Electronics Co.,Ltd
+F0E77E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-35-0A   (hex)		Samsung Electronics Co.,Ltd
+94350A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1D-25   (hex)		Samsung Electronics Co.,Ltd
+001D25     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-C1-F1   (hex)		SHENZHEN SPOTMAU INFORMATION TECHNOLIGY CO., Ltd  
+E4C1F1     (base 16)		SHENZHEN SPOTMAU INFORMATION TECHNOLIGY CO., Ltd  
+				10F, Block D, 5th Building, Shenzhen Software Industrial Base, Haitian 2nd Rd,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+24-0A-C4   (hex)		Espressif Inc.
+240AC4     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+34-31-11   (hex)		Samsung Electronics Co.,Ltd
+343111     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-FD-0E   (hex)		Samsung Electronics Co.,Ltd
+08FD0E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-1B-BA   (hex)		Samsung Electronics Co.,Ltd
+041BBA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-9B-39   (hex)		Samsung Electronics Co.,Ltd
+889B39     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-32-CB   (hex)		Samsung Electronics Co.,Ltd
+E432CB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-8C-CD   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+BC8CCD     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+D0-22-BE   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+D022BE     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+EC-9B-F3   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+EC9BF3     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+F4-09-D8   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+F409D8     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+10-D5-42   (hex)		Samsung Electronics Co.,Ltd
+10D542     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-82-1F   (hex)		Samsung Electronics Co.,Ltd
+A0821F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-6B-CA   (hex)		Samsung Electronics Co.,Ltd
+F06BCA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-36-13   (hex)		Samsung Electronics Co.,Ltd
+AC3613     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-26-11   (hex)		Licera AB
+002611     (base 16)		Licera AB
+				Teknikringen 1C
+				Linköping    58330
+				SE
+
+00-50-94   (hex)		ARRIS Group, Inc.
+005094     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-B7-B1   (hex)		ARRIS Group, Inc.
+E0B7B1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D8-25-22   (hex)		ARRIS Group, Inc.
+D82522     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F0-03-8C   (hex)		AzureWave Technology Inc.
+F0038C     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+18-D2-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+18D276     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-52-18   (hex)		Wuxi Keboda Electron Co.Ltd
+005218     (base 16)		Wuxi Keboda Electron Co.Ltd
+				No.155 Chunhui Road, Xishan District, 
+				Wuxi  Jiangsu  214101
+				CN
+
+00-1E-81   (hex)		CNB Technology Inc.
+001E81     (base 16)		CNB Technology Inc.
+				#701 Star Valley, 60-11 Gasan-Dong,
+				Seoul    153777
+				KR
+
+7C-A9-7D   (hex)		Objenious
+7CA97D     (base 16)		Objenious
+				20 rue de Troyon
+				SEVRES    92310
+				FR
+
+A8-A6-48   (hex)		Qingdao Hisense Communications Co.,Ltd.
+A8A648     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Jiangxi Road
+				Qingdao  Shandong  266071
+				CN
+
+98-5D-AD   (hex)		Texas Instruments
+985DAD     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D4-36-39   (hex)		Texas Instruments
+D43639     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+BC-28-2C   (hex)		e-Smart Systems Pvt. Ltd
+BC282C     (base 16)		e-Smart Systems Pvt. Ltd
+				483 FIE, , Patparganj Industrial Area
+				Delhi  Delhi  110092
+				IN
+
+A4-0D-BC   (hex)		Xiamen Intretech Inc.
+A40DBC     (base 16)		Xiamen Intretech Inc.
+				 FL 7 NO 588 JIAHE RD TORCH CARDEN HIGH-TECH ZONE
+				Xiamen  FUJIAN  361006
+				CN
+
+84-EF-18   (hex)		Intel Corporate
+84EF18     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+84-C1-C1   (hex)		Juniper Networks
+84C1C1     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+A8-1B-6A   (hex)		Texas Instruments
+A81B6A     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+34-3D-C4   (hex)		BUFFALO.INC
+343DC4     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+B0-F8-93   (hex)		Shanghai MXCHIP Information Technology Co., Ltd.
+B0F893     (base 16)		Shanghai MXCHIP Information Technology Co., Ltd.
+				9th Floor, No. 5 Building, 2145 Jinshajiang Rd., Putuo District
+				Shanghai    200333
+				CN
+
+C4-11-E0   (hex)		Bull Group Co., Ltd
+C411E0     (base 16)		Bull Group Co., Ltd
+				No.32 Sanhai Road,East Guanhaiwei Industrial Zone, Cixi City, Zhejiang, P.R.China
+				Cixi  Zhejiang  315314
+				CN
+
+28-C8-7A   (hex)		ARRIS Group, Inc.
+28C87A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+48-FD-8E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48FD8E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-06-23   (hex)		Ultra Electronics Sonar System Division
+7C0623     (base 16)		Ultra Electronics Sonar System Division
+				419 Bridport Road
+				Greenford  Middlesex  UB6 8UA
+				GB
+
+28-AC-67   (hex)		Mach Power, Rappresentanze Internazionali s.r.l.
+28AC67     (base 16)		Mach Power, Rappresentanze Internazionali s.r.l.
+				CUPA S.ANIELLO, 112
+				NAPOLI  Napoli  80146
+				IT
+
+14-82-5B   (hex)		Hefei Radio Communication Technology Co., Ltd 
+14825B     (base 16)		Hefei Radio Communication Technology Co., Ltd 
+				No.108, YinXing Road, High-tech Development Zone, Hefei, Anhui Province, China
+				Hefei  Anhui Province  230088
+				CN
+
+64-12-69   (hex)		ARRIS Group, Inc.
+641269     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-02-C9   (hex)		Mellanox Technologies, Inc.
+0002C9     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+08-00-51   (hex)		ExperData
+080051     (base 16)		ExperData
+				88, RUE BRILLAT SAVARIN
+				0000    0000
+				FR
+
+00-12-6C   (hex)		Visonic Technologies 1993 Ltd.
+00126C     (base 16)		Visonic Technologies 1993 Ltd.
+				24 Habarzel St.
+				Tel Aviv    69710
+				IL
+
+AC-61-75   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC6175     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-44-27   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+244427     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-80-C7   (hex)		XIRCOM
+0080C7     (base 16)		XIRCOM
+				26025 MUREAU ROAD
+				CALABASAS  CA  91302
+				US
+
+00-01-38   (hex)		XAVi Technologies Corp.
+000138     (base 16)		XAVi Technologies Corp.
+				9F, No. 129, Hsing Te Rd,
+				241 TAIWAN  241 TAIWAN  R.O.C.
+				TW
+
+00-16-6D   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+00166D     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				8/F.high Tech Plaza,TianAn Cyberpark,Chegongmiao
+				Shenzhen  Guangdong  518040
+				CN
+
+3C-91-57   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+3C9157     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				5F Building 2,No.56,Liuhe Road,Xihu District
+				Hangzhou  Zhejiang  310023
+				CN
+
+00-00-D8   (hex)		Novell, Inc.
+0000D8     (base 16)		Novell, Inc.
+				122 EAST 1700 SOUTH M/S:E-12-1
+				PROVO  UT  84601
+				US
+
+00-1F-46   (hex)		Nortel Networks
+001F46     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson    75082
+				US
+
+00-30-93   (hex)		Sonnet Technologies, Inc
+003093     (base 16)		Sonnet Technologies, Inc
+				8 Autry
+				Irvine,  CA  92618
+				US
+
+00-03-4B   (hex)		Nortel Networks
+00034B     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-25-61   (hex)		ProCurve Networking by HP
+002561     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+00-80-58   (hex)		PRINTER SYSTEMS CORP.
+008058     (base 16)		PRINTER SYSTEMS CORP.
+				207 PARRY PARKWAY
+				GAITHERSBURG  MD  20877
+				US
+
+00-15-7D   (hex)		POSDATA
+00157D     (base 16)		POSDATA
+				276-2,Seohyeon-dong,Bundang-gu,
+				Seongnam-City  Kyeonggi-Do  463-775
+				KR
+
+48-49-C7   (hex)		Samsung Electronics Co.,Ltd
+4849C7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+84-98-66   (hex)		Samsung Electronics Co.,Ltd
+849866     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1C-9C   (hex)		Nortel Networks
+001C9C     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1B-25   (hex)		Nortel Networks
+001B25     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-19-E1   (hex)		Nortel Networks
+0019E1     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1D-42   (hex)		Nortel Networks
+001D42     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-14-0D   (hex)		Nortel Networks
+00140D     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0E-40   (hex)		Nortel Networks
+000E40     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+FC-B0-C4   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+FCB0C4     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F Info-Tech Building
+				Shanghai  Shanghai  200092
+				CN
+
+A8-9D-D2   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+A89DD2     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F Info-Tech Building
+				Shanghai  Shanghai  200092
+				CN
+
+00-E0-0F   (hex)		Shanghai Baud Data Communication Co.,Ltd.
+00E00F     (base 16)		Shanghai Baud Data Communication Co.,Ltd.
+				COMMUNICATION DEVELOPMENT CORP
+				SHANGHAI    0000
+				CN
+
+28-BE-03   (hex)		TCT mobile ltd
+28BE03     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+90-3A-E6   (hex)		PARROT SA
+903AE6     (base 16)		PARROT SA
+				174 Quai de Jemmapes
+				Paris    75010
+				FR
+
+A0-98-ED   (hex)		Shandong Intelligent Optical Communication Development Co., Ltd.
+A098ED     (base 16)		Shandong Intelligent Optical Communication Development Co., Ltd.
+				No.149 Yingcui Road,Torch Town,Advanced Technique Development Area
+				Jining  Shandong  272023
+				CN
+
+00-0E-F4   (hex)		Kasda Networks Inc
+000EF4     (base 16)		Kasda Networks Inc
+				B-31 Building, Tanglang Industry Zone
+				Shenzhen  Guangdong Province  518055
+				CN
+
+00-16-7A   (hex)		Skyworth Overseas Development Ltd.
+00167A     (base 16)		Skyworth Overseas Development Ltd.
+				Room 1505-06,Westlands Centre
+				0000    0000
+				HK
+
+A4-29-40   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+A42940     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+E4-A3-87   (hex)		Control Solutions LLC
+E4A387     (base 16)		Control Solutions LLC
+				2520 Diehl Rd
+				Aurora  IL  60502
+				US
+
+18-80-F5   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+1880F5     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+10-E8-78   (hex)		Nokia
+10E878     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+10-F9-6F   (hex)		LG Electronics (Mobile Communications)
+10F96F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+C4-43-8F   (hex)		LG Electronics (Mobile Communications)
+C4438F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+A0-91-69   (hex)		LG Electronics (Mobile Communications)
+A09169     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+28-6C-07   (hex)		XIAOMI Electronics,CO.,LTD
+286C07     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+00-22-80   (hex)		A2B Electronics AB
+002280     (base 16)		A2B Electronics AB
+				Box 14
+				Motala    S-591 21
+				SE
+
+40-4A-D4   (hex)		Widex A/S
+404AD4     (base 16)		Widex A/S
+				Nymoellevej 6
+				Lynge  Alleroed  DK3540
+				DK
+
+98-93-CC   (hex)		LG ELECTRONICS INC
+9893CC     (base 16)		LG ELECTRONICS INC
+				19-1, Cheongho-ri, Jinwi-myeon
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+3C-CD-93   (hex)		LG ELECTRONICS INC
+3CCD93     (base 16)		LG ELECTRONICS INC
+				19-1, CHEONGHO-RI, JINWI-MYEON
+				PYEONGTAEK  GYEONGGI-DO  451-713
+				KR
+
+20-21-A5   (hex)		LG Electronics (Mobile Communications)
+2021A5     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+6C-D6-8A   (hex)		LG Electronics (Mobile Communications)
+6CD68A     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+CC-79-CF   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+CC79CF     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,Shenzhen,P.R.C
+				ShenZhen  Guangdong  518000
+				CN
+
+00-19-25   (hex)		Intelicis Corporation
+001925     (base 16)		Intelicis Corporation
+				4633 Old Ironsides Drive, Suite 150
+				Santa Clara  CA  95054
+				US
+
+94-76-B7   (hex)		Samsung Electronics Co.,Ltd
+9476B7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-54-CF   (hex)		LG Electronics (Mobile Communications)
+2C54CF     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+48-59-29   (hex)		LG Electronics (Mobile Communications)
+485929     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+58-A2-B5   (hex)		LG Electronics (Mobile Communications)
+58A2B5     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-24-83   (hex)		LG Electronics (Mobile Communications)
+002483     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-1F-E3   (hex)		LG Electronics (Mobile Communications)
+001FE3     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F0-42-1C   (hex)		Intel Corporate
+F0421C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-0F-62   (hex)		Alcatel Bell Space N.V.
+000F62     (base 16)		Alcatel Bell Space N.V.
+				Berkenrodelei 33
+				Hoboken  Antwerpen  B-2660
+				BE
+
+00-1C-D8   (hex)		BlueAnt Wireless
+001CD8     (base 16)		BlueAnt Wireless
+				245 St.Kilda Rd, St Kilda
+				Melbourne  Victoria  3182
+				AU
+
+00-19-AB   (hex)		Raycom CO ., LTD
+0019AB     (base 16)		Raycom CO ., LTD
+				A,3-4/FL, Building 1,27 Chuangxin Road,
+				Beijing    102200
+				CN
+
+4C-33-4E   (hex)		HIGHTECH
+4C334E     (base 16)		HIGHTECH
+				No202.gsif, 4 Gyeonggang-ro 2326 beon-gil
+				Gangneung-si  Gangwon-do  25570
+				KR
+
+7C-70-BC   (hex)		IEEE Registration Authority
+7C70BC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E8-18-63   (hex)		IEEE Registration Authority
+E81863     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+2C-D1-41   (hex)		IEEE Registration Authority
+2CD141     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+3C-39-E7   (hex)		IEEE Registration Authority
+3C39E7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+BC-66-41   (hex)		IEEE Registration Authority
+BC6641     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-E4-DA   (hex)		IEEE Registration Authority
+80E4DA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+88-5D-90   (hex)		IEEE Registration Authority
+885D90     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C8-8E-D1   (hex)		IEEE Registration Authority
+C88ED1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B0-1F-81   (hex)		IEEE Registration Authority
+B01F81     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+54-9A-11   (hex)		IEEE Registration Authority
+549A11     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B8-D8-12   (hex)		IEEE Registration Authority
+B8D812     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+1C-21-D1   (hex)		IEEE Registration Authority
+1C21D1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+28-36-38   (hex)		IEEE Registration Authority
+283638     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F4-85-C6   (hex)		FDT Technologies
+F485C6     (base 16)		FDT Technologies
+				14027 Memorial Drive #132
+				Houston  TX  77024
+				US
+
+D4-04-FF   (hex)		Juniper Networks
+D404FF     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C8-75-5B   (hex)		Quantify Technology Pty. Ltd.
+C8755B     (base 16)		Quantify Technology Pty. Ltd.
+				Suite 1, 4 Sarich Way
+				Bentley  Western Australia  6102
+				AU
+
+88-12-4E   (hex)		Qualcomm Inc.
+88124E     (base 16)		Qualcomm Inc.
+				1700 Technology Drive
+				San Jose  CA  95110
+				US
+
+00-14-28   (hex)		Vocollect Inc
+001428     (base 16)		Vocollect Inc
+				703 Rodi Road
+				Pittsburgh  PA  15235
+				US
+
+00-6B-9E   (hex)		Vizio, Inc
+006B9E     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+4C-66-41   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+4C6641     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+5C-A8-6A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CA86A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-1B-32   (hex)		QLogic Corporation
+001B32     (base 16)		QLogic Corporation
+				26650 Aliso Viejo Parkway
+				Aliso Viejo  CA  92656
+				US
+
+00-17-CA   (hex)		Qisda Corporation
+0017CA     (base 16)		Qisda Corporation
+				157 Shan Ying Road,
+				GueiShan  Taoyuan,  333
+				TW
+
+70-F3-95   (hex)		Universal Global Scientific Industrial Co., Ltd.
+70F395     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+48-F7-C0   (hex)		Technicolor CH USA Inc.
+48F7C0     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+00-15-B7   (hex)		Toshiba
+0015B7     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome    1988710
+				JP
+
+E8-9D-87   (hex)		Toshiba
+E89D87     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+E0-95-79   (hex)		ORTHOsoft inc, d/b/a Zimmer CAS
+E09579     (base 16)		ORTHOsoft inc, d/b/a Zimmer CAS
+				75 Queen Street, Suite 3300
+				Montreal  Quebec  H3C 2N6
+				CA
+
+A0-AD-A1   (hex)		JMR Electronics, Inc
+A0ADA1     (base 16)		JMR Electronics, Inc
+				8968 Fullbright Avenue
+				Chatsworth  California  91311
+				US
+
+BC-C0-0F   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+BCC00F     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+9C-A5-C0   (hex)		vivo Mobile Communication Co., Ltd.
+9CA5C0     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong  523860
+				CN
+
+80-C6-AB   (hex)		Technicolor CH USA Inc.
+80C6AB     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+90-A4-DE   (hex)		Wistron Neweb Corporation
+90A4DE     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsinchu Science Park, 
+				Hsinchu     308
+				TW
+
+70-E2-84   (hex)		Wistron Infocomm (Zhongshan) Corporation
+70E284     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				No.38,East Keji Road,Zhongshan Torch Development Zone,Zhongshan City,Guangdong,China
+				Zhongshan  Guangdong  528437
+				CN
+
+A8-54-B2   (hex)		Wistron Neweb Corporation
+A854B2     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsin Science Park, Hsinchu 308, Taiwan
+				HsinChu  Taiwan  308
+				TW
+
+30-44-A1   (hex)		Shanghai Nanchao Information Technology
+3044A1     (base 16)		Shanghai Nanchao Information Technology
+				Floor 1th, building 13, No.368 Zhangjiang Road, Pudong New District, Shanghai
+				shanghai    200000
+				CN
+
+CC-03-FA   (hex)		Technicolor CH USA Inc.
+CC03FA     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+E0-AC-F1   (hex)		Cisco Systems, Inc
+E0ACF1     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-01-5B   (hex)		ITALTEL S.p.A/RF-UP-I
+00015B     (base 16)		ITALTEL S.p.A/RF-UP-I
+				20019 Cast.Settimo M.se (MI)
+				    
+				IT
+
+00-A0-A8   (hex)		RENEX CORPORATION
+00A0A8     (base 16)		RENEX CORPORATION
+				2750 KILLARNEY DRIVE
+				WOODBRIDGE  VA  22192
+				US
+
+00-C0-AB   (hex)		Telco Systems, Inc. 
+00C0AB     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield  MA  02048
+				US
+
+00-23-F8   (hex)		Zyxel Communications Corporation
+0023F8     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-19-CB   (hex)		Zyxel Communications Corporation
+0019CB     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+2C-09-4D   (hex)		Raptor Engineering, LLC
+2C094D     (base 16)		Raptor Engineering, LLC
+				2556 Anderson Dr.
+				Belvidere  IL  61008
+				US
+
+AC-37-43   (hex)		HTC Corporation
+AC3743     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+00-1D-7E   (hex)		Cisco-Linksys, LLC
+001D7E     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+E4-FB-8F   (hex)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+E4FB8F     (base 16)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+				No.999,Dacheng East Road,Fenghua City,Zhejiang Province,China.
+				Fenghua  Zhejiang  315500
+				CN
+
+10-BD-55   (hex)		Q-Lab Corporation
+10BD55     (base 16)		Q-Lab Corporation
+				800 Canterbury Rd
+				Westlake  OH  44145
+				US
+
+C4-49-BB   (hex)		MITSUMI ELECTRIC CO.,LTD.
+C449BB     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+FC-2D-5E   (hex)		zte corporation
+FC2D5E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B4-04-18   (hex)		Smartchip Integrated Inc.
+B40418     (base 16)		Smartchip Integrated Inc.
+				9B,Science Plaza,1355 JinJiHu Avenue,Suzhou Industrial Park
+				Suzhou  Jiangsu  215021
+				CN
+
+90-CF-7D   (hex)		Qingdao Hisense Communications Co.,Ltd.
+90CF7D     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+F4-0A-4A   (hex)		INDUSNET Communication Technology Co.,LTD
+F40A4A     (base 16)		INDUSNET Communication Technology Co.,LTD
+				3th floor A block,No11 Gaopeng st,Wuhou district
+				chengdu  sichuan  610041
+				CN
+
+F8-5A-00   (hex)		Sanford LP
+F85A00     (base 16)		Sanford LP
+				6655 Peachtree Dunwoody Road
+				Atlanta  GA  30228
+				US
+
+FC-55-DC   (hex)		Baltic Latvian Universal Electronics LLC
+FC55DC     (base 16)		Baltic Latvian Universal Electronics LLC
+				5706 Corsa Avenue Suite 102
+				Westlake Village  CA  91362
+				US
+
+08-01-0F   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+08010F     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+94-18-82   (hex)		Hewlett Packard Enterprise
+941882     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+60-38-E0   (hex)		Belkin International Inc.
+6038E0     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+88-50-DD   (hex)		Infiniband Trade Association 
+8850DD     (base 16)		Infiniband Trade Association 
+				3855 SW 153rd Drive
+				Beaverton  OR  97003
+				US
+
+00-25-50   (hex)		Riverbed Technology, Inc.
+002550     (base 16)		Riverbed Technology, Inc.
+				125 Cambridge Park Drive
+				Cambridge  MA  02140
+				US
+
+D0-B2-C4   (hex)		Technicolor CH USA Inc.
+D0B2C4     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+50-AB-3E   (hex)		Qibixx AG
+50AB3E     (base 16)		Qibixx AG
+				Bahnhofstrasse 2
+				Buchs  SG  9471
+				CH
+
+38-76-CA   (hex)		Shenzhen Smart Intelligent Technology Co.Ltd
+3876CA     (base 16)		Shenzhen Smart Intelligent Technology Co.Ltd
+				Gaoxin South 4th Road Hi-Tech Industry Park, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+04-27-58   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+042758     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-E3-74   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9CE374     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+8C-D2-E9   (hex)		YOKOTE SEIKO CO., LTD.
+8CD2E9     (base 16)		YOKOTE SEIKO CO., LTD.
+				10-18 Minami-Gosyono Yasumoto
+				Yokote-City  Akita  013-0811
+				JP
+
+B8-BB-AF   (hex)		Samsung Electronics Co.,Ltd
+B8BBAF     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+60-C5-AD   (hex)		Samsung Electronics Co.,Ltd
+60C5AD     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+44-2C-05   (hex)		AMPAK Technology, Inc.
+442C05     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+8C-89-7A   (hex)		AUGTEK
+8C897A     (base 16)		AUGTEK
+				Tuanjie Road No.100, Building C, Room 521 
+				Nanjing  Jiangsu  211899
+				CN
+
+F8-45-AD   (hex)		Konka Group Co., Ltd.
+F845AD     (base 16)		Konka Group Co., Ltd.
+				Shenzhen Konka R & D Building, 28th floor 15-24
+				Nanshan District  Guangdong  00000
+				CN
+
+00-0F-E2   (hex)		Hangzhou H3C Technologies Co., Limited
+000FE2     (base 16)		Hangzhou H3C Technologies Co., Limited
+				Oriental Electronic Bld., NO.2,Chuangye Road
+				Hai-Dian District  Beijing  100085
+				CN
+
+80-F6-2E   (hex)		Hangzhou H3C Technologies Co., Limited
+80F62E     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+60-8D-17   (hex)		Sentrus Government Systems Division, Inc
+608D17     (base 16)		Sentrus Government Systems Division, Inc
+				141 Chesterfield Industrial Blvd
+				Chesterfield  MO  63005-1219
+				US
+
+EC-AD-B8   (hex)		Apple, Inc.
+ECADB8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-01-A7   (hex)		Apple, Inc.
+9801A7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-79-ED   (hex)		SHARP Corporation
+6879ED     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+00-23-82   (hex)		Lih Rong electronic Enterprise Co., Ltd.
+002382     (base 16)		Lih Rong electronic Enterprise Co., Ltd.
+				No. 2, Lane 387, Hsin Shu Rd.
+				Hsin Chuang City,  Taipei  242
+				TW
+
+24-F0-94   (hex)		Apple, Inc.
+24F094     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-6D-41   (hex)		Apple, Inc.
+086D41     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-D5-BD   (hex)		Intel Corporate
+B4D5BD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+98-AA-3C   (hex)		Will i-tech Co., Ltd.
+98AA3C     (base 16)		Will i-tech Co., Ltd.
+				34, Deokcheon-ro, Manan-gu, Anyang-si, Gyeonggi-do, Korea
+				Anyang    14088
+				KR
+
+BC-AD-28   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+BCAD28     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+F4-91-1E   (hex)		ZHUHAI EWPE INFORMATION TECHNOLOGY INC
+F4911E     (base 16)		ZHUHAI EWPE INFORMATION TECHNOLOGY INC
+				Room 409,NO.10,Technology 1st Road, Gangwan Av.,Tangjia Bay Town,Zhuhai,Guangdong,China
+				Zhuhai  Guangdong  519070
+				CN
+
+00-25-52   (hex)		VXi Corporation
+002552     (base 16)		VXi Corporation
+				271 Locust Street
+				Dover  NH  03820
+				US
+
+6C-E9-83   (hex)		Gastron Co., LTD.
+6CE983     (base 16)		Gastron Co., LTD.
+				#75-10, Palgok2-dong, Sangnok-gu, 
+				Ansan-city  Kyunggi-do  426-190
+				KR
+
+28-E3-1F   (hex)		Xiaomi Communications Co Ltd
+28E31F     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+98-90-96   (hex)		Dell Inc.
+989096     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+DC-37-52   (hex)		GE
+DC3752     (base 16)		GE
+				650 Markland Street
+				Markham  Ontario  L6C 0M1
+				CA
+
+DC-D9-16   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DCD916     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-02-2E   (hex)		TEAC Corp. R& D
+00022E     (base 16)		TEAC Corp. R& D
+				857 Koyata, Iruma
+				    
+				JP
+
+00-60-B0   (hex)		Hewlett Packard
+0060B0     (base 16)		Hewlett Packard
+				MS 42LE
+				CUPERTINO  CA  95014
+				US
+
+7C-73-8B   (hex)		Cocoon Alarm Ltd
+7C738B     (base 16)		Cocoon Alarm Ltd
+				46 The Calls
+				Leeds  West Yorkshire  LS2 7EY
+				GB
+
+F8-0F-84   (hex)		Natural Security SAS
+F80F84     (base 16)		Natural Security SAS
+				165 Avenue de Bretagne
+				Lille    59000
+				FR
+
+44-A4-2D   (hex)		TCT mobile ltd
+44A42D     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+70-F9-6D   (hex)		Hangzhou H3C Technologies Co., Limited
+70F96D     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+BC-6A-44   (hex)		Commend International GmbH
+BC6A44     (base 16)		Commend International GmbH
+				Saalachstrasse 51
+				Salzburg  Salzburg  A-5020
+				AT
+
+F0-EE-58   (hex)		PACE Telematics GmbH
+F0EE58     (base 16)		PACE Telematics GmbH
+				Haid-und-Neu-Str. 18
+				Karlsruhe    76131
+				DE
+
+08-3F-BC   (hex)		zte corporation
+083FBC     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-C0-F0   (hex)		Kingston Technology Company, Inc.
+00C0F0     (base 16)		Kingston Technology Company, Inc.
+				17600 NEWHOPE STREET
+				FOUNTAIN VALLEY  CA  92708
+				US
+
+94-3B-B1   (hex)		Kaonmedia CO., LTD.
+943BB1     (base 16)		Kaonmedia CO., LTD.
+				KAONMEDIA Building 513-4
+				Sungnam-City  Kyonggi-Do  463-839, KOREA
+				KR
+
+00-18-D7   (hex)		JAVAD GNSS, Inc.
+0018D7     (base 16)		JAVAD GNSS, Inc.
+				1731 Technology Drive, Suite 680
+				San Jose  CA  95110
+				US
+
+00-1F-09   (hex)		Jastec
+001F09     (base 16)		Jastec
+				Jastec B/D 2F, 92-7 Kumgok-dong, 
+				Boondang-gu,    463-804
+				KR
+
+AC-62-0D   (hex)		Jabil Circuit(Wuxi) Co.,Ltd
+AC620D     (base 16)		Jabil Circuit(Wuxi) Co.,Ltd
+				Lot J9, J10 Export Processing Zone
+				Wuxi City  Jiangsu  214028
+				CN
+
+08-00-0D   (hex)		International Computers, Ltd
+08000D     (base 16)		International Computers, Ltd
+				WENLOCK WAY
+				na  UNITED  KINGDOM
+				GB
+
+1C-73-70   (hex)		Neotech
+1C7370     (base 16)		Neotech
+				104, 37 Yaeun-ro
+				Gumi-si  Gyoungsangbuk-do  730-711
+				KR
+
+30-E3-7A   (hex)		Intel Corporate
+30E37A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-00-C9   (hex)		Emulex Corporation
+0000C9     (base 16)		Emulex Corporation
+				3333 Susan Street
+				Costa Mesa  CA  92626
+				US
+
+00-40-AA   (hex)		Valmet Automation
+0040AA     (base 16)		Valmet Automation
+				Lentokentänkatu 11, P.O.Box 237
+				Tampere    FIN-3310
+				FI
+
+D0-B0-CD   (hex)		Moen
+D0B0CD     (base 16)		Moen
+				25300 Al Moen Dr
+				North Olmstead  OH  44070-8022
+				US
+
+70-50-AF   (hex)		BSkyB Ltd
+7050AF     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+F4-EF-9E   (hex)		SGSG SCIENCE & TECHNOLOGY CO. LTD
+F4EF9E     (base 16)		SGSG SCIENCE & TECHNOLOGY CO. LTD
+				3RD Fl, Bldg A3, No.1 software Park Rd
+				Zhuhai  Guangdong  519085
+				CN
+
+1C-74-0D   (hex)		Zyxel Communications Corporation
+1C740D     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+60-3E-CA   (hex)		Cambridge Medical Robotics Ltd
+603ECA     (base 16)		Cambridge Medical Robotics Ltd
+				Unit 2, Crome Lea Business Park
+				Madingley Road  Cambridgeshire  CB23 7PH
+				GB
+
+00-1F-1F   (hex)		Edimax Technology Co. Ltd.
+001F1F     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+00-02-0E   (hex)		ECI Telecom Ltd.
+00020E     (base 16)		ECI Telecom Ltd.
+				30 Hasivim St
+				Petach-Tikva 49133    49133
+				IL
+
+20-0A-5E   (hex)		Xiangshan Giant Eagle Technology Developing Co., Ltd.
+200A5E     (base 16)		Xiangshan Giant Eagle Technology Developing Co., Ltd.
+				Juexi Road no.9 Juexi street 
+				Ningbo  Zhejiang  315708
+				CN
+
+9C-74-1A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C741A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-A8-B6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4A8B6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-4C-07   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+244C07     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-6F-F7   (hex)		Wistron Neweb Corporation
+746FF7     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+B8-AE-ED   (hex)		Elitegroup Computer Systems Co.,Ltd.
+B8AEED     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No. 239, Sec. 2, Ti Ding Blvd.,
+				Taipei    11493
+				TW
+
+00-0D-B0   (hex)		Olym-tech Co.,Ltd.
+000DB0     (base 16)		Olym-tech Co.,Ltd.
+				Room 401/402,No.1,Songling Road,Hi-tech
+				Shenzhen  Guangdong  518031
+				CN
+
+30-F6-B9   (hex)		Ecocentric Energy
+30F6B9     (base 16)		Ecocentric Energy
+				E3 The Innovation Centre, 9 De Laeter Way, Technology Park
+				Bentley  Western Australia  6102
+				AU
+
+84-7B-EB   (hex)		Dell Inc.
+847BEB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+54-51-1B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+54511B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+68-53-6C   (hex)		SPnS Co.,Ltd
+68536C     (base 16)		SPnS Co.,Ltd
+				#315, Woolim Lions Valley 2nd, Gasan-dong, Geumcheon-gu
+				Seoul    08591
+				KR
+
+1C-EA-1B   (hex)		Nokia
+1CEA1B     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+D4-61-2E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D4612E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-E2-E5   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+B0E2E5     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+00-1F-A7   (hex)		Sony Interactive Entertainment Inc.
+001FA7     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+90-46-A2   (hex)		Tedipay UK Ltd
+9046A2     (base 16)		Tedipay UK Ltd
+				Level 39, One Canada Square
+				London    E14 5AB
+				GB
+
+64-79-A7   (hex)		Phison Electronics Corp.   
+6479A7     (base 16)		Phison Electronics Corp.   
+				No.1, Qun Yi Rd., Jhunan,
+				Miaoli    350
+				TW
+
+CC-B1-1A   (hex)		Samsung Electronics Co.,Ltd
+CCB11A     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+70-3C-03   (hex)		RadiAnt Co.,Ltd
+703C03     (base 16)		RadiAnt Co.,Ltd
+				102-610, 36, Bucheon-ro 198beon-gil, Wonmi-gu
+				Bucheon-si  Gyeonggi-do  14557
+				KR
+
+00-C1-64   (hex)		Cisco Systems, Inc
+00C164     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+DC-2D-CB   (hex)		Beijing Unis HengYue Technology Co., Ltd.
+DC2DCB     (base 16)		Beijing Unis HengYue Technology Co., Ltd.
+				Room 402, No. 2 Block, No. 1 yard, Zhongguancun east road, Haidian District
+				Beijing    100190
+				CN
+
+2C-96-62   (hex)		Invenit BV
+2C9662     (base 16)		Invenit BV
+				Lange Broekstraat 3
+				Raamsdonk  Noord-Brabant  4944 XH
+				NL
+
+CC-D3-E2   (hex)		Jiangsu Yinhe  Electronics Co.,Ltd.
+CCD3E2     (base 16)		Jiangsu Yinhe  Electronics Co.,Ltd.
+				No.188 Nanhuan Road, TangQiao Town
+				Zhangjiagang   Jiangsu   215611
+				CN
+
+E4-FA-ED   (hex)		Samsung Electronics Co.,Ltd
+E4FAED     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+28-83-35   (hex)		Samsung Electronics Co.,Ltd
+288335     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-CF-96   (hex)		Samsung Electronics Co.,Ltd
+DCCF96     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-44-F2   (hex)		YAMAHA CORPORATION
+AC44F2     (base 16)		YAMAHA CORPORATION
+				10-1 Nakazawa-cho, Naka-ku
+				Hamamatsu  Shizuoka  430-8650
+				JP
+
+1C-5F-2B   (hex)		D-Link International
+1C5F2B     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+1C-98-EC   (hex)		Hewlett Packard Enterprise
+1C98EC     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+70-66-1B   (hex)		Sonova AG
+70661B     (base 16)		Sonova AG
+				Laubisruetistrasse 28
+				Staefa    8712
+				CH
+
+B0-7F-B9   (hex)		NETGEAR
+B07FB9     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+04-7E-4A   (hex)		moobox CO., Ltd.
+047E4A     (base 16)		moobox CO., Ltd.
+				No 801, Yanchang Zhong Road
+				Shanghai  Shanghai  200072
+				CN
+
+00-80-E5   (hex)		NetApp
+0080E5     (base 16)		NetApp
+				1395 Crossman Ave
+				Sunnyvale,  CA  94089
+				US
+
+9C-5C-8E   (hex)		ASUSTek COMPUTER INC.
+9C5C8E     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+C8-87-22   (hex)		Lumenpulse
+C88722     (base 16)		Lumenpulse
+				1751 Richardson, suite 1505
+				Montreal  Quebec  H3K 1G6
+				CA
+
+84-68-3E   (hex)		Intel Corporate
+84683E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+E0-CD-FD   (hex)		Beijing E3Control Technology Co, LTD
+E0CDFD     (base 16)		Beijing E3Control Technology Co, LTD
+				1 Shangdi East Rd, Building A, Rm 205
+				Beijing  Beijing  100085
+				CN
+
+00-08-95   (hex)		DIRC Technologie GmbH & Co.KG
+000895     (base 16)		DIRC Technologie GmbH & Co.KG
+				Borsigstraße 13
+				Ratingen  NRW  40880
+				DE
+
+60-AC-C8   (hex)		KunTeng Inc.
+60ACC8     (base 16)		KunTeng Inc.
+				Room302, 3rd Floor, Building1 ,No.8 NongDa South street
+				HaiDian District  BeiJing  100084
+				CN
+
+CC-B3-AB   (hex)		shenzhen Biocare Bio-Medical Equipment Co.,Ltd.
+CCB3AB     (base 16)		shenzhen Biocare Bio-Medical Equipment Co.,Ltd.
+				#A735, 7/F, Block A, Shenzhen Mingyou Industrial Products Exhibition & Procurement  Center, Baoyuan Road, Xixiang Sub-district, Bao'an District, 518102 Shenzhen, P.R. China
+				Shenzhen    518000
+				CN
+
+E4-B3-18   (hex)		Intel Corporate
+E4B318     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+74-3E-2B   (hex)		Ruckus Wireless
+743E2B     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+E0-C7-67   (hex)		Apple, Inc.
+E0C767     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-ED-2C   (hex)		Apple, Inc.
+80ED2C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-34-04   (hex)		TCT mobile ltd
+F03404     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+80-D1-60   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+80D160     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+30-78-5C   (hex)		Partow Tamas Novin (Parman)
+30785C     (base 16)		Partow Tamas Novin (Parman)
+				UNIT 32 NO.31 26TH WEST AVE ,ALLAMEH TABATABAIE ST.SAADAT ABAD
+				Tehran  Tehran  1997968413
+				IR
+
+24-69-68   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+246968     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+8C-A2-FD   (hex)		Starry, Inc.
+8CA2FD     (base 16)		Starry, Inc.
+				PO Box 52226
+				Boston  MA  02205
+				US
+
+84-BA-3B   (hex)		CANON INC.
+84BA3B     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+00-05-85   (hex)		Juniper Networks
+000585     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+20-4E-71   (hex)		Juniper Networks
+204E71     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-19-4F   (hex)		Nokia Danmark A/S
+00194F     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-BD-3A   (hex)		Nokia Corporation
+00BD3A     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+80-50-1B   (hex)		Nokia Corporation
+80501B     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+A0-4E-04   (hex)		Nokia Corporation
+A04E04     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+00-12-62   (hex)		Nokia Danmark A/S
+001262     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-14-A7   (hex)		Nokia Danmark A/S
+0014A7     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-15-A0   (hex)		Nokia Danmark A/S
+0015A0     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-16-BC   (hex)		Nokia Danmark A/S
+0016BC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-17-4B   (hex)		Nokia Danmark A/S
+00174B     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-26-69   (hex)		Nokia Danmark A/S
+002669     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+AC-61-EA   (hex)		Apple, Inc.
+AC61EA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-B5-4D   (hex)		Apple, Inc.
+38B54D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-5C-F2   (hex)		Apple, Inc.
+1C5CF2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-7E-33   (hex)		Nokia Danmark A/S
+A87E33     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-24-03   (hex)		Nokia Danmark A/S
+002403     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-24-04   (hex)		Nokia Danmark A/S
+002404     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-19-B7   (hex)		Nokia Danmark A/S
+0019B7     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-17-B0   (hex)		Nokia Danmark A/S
+0017B0     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-21-09   (hex)		Nokia Danmark A/S
+002109     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-21-08   (hex)		Nokia Danmark A/S
+002108     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1B-33   (hex)		Nokia Danmark A/S
+001B33     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-15-DE   (hex)		Nokia Danmark A/S
+0015DE     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-02-EE   (hex)		Nokia Danmark A/S
+0002EE     (base 16)		Nokia Danmark A/S
+				Frederikskaj, Copenhagen V
+				copenhagen    12345
+				DK
+
+D8-F7-10   (hex)		Libre Wireless Technologies Inc.
+D8F710     (base 16)		Libre Wireless Technologies Inc.
+				5405 Alton Parkway
+				Irvine, CA  CA  92604
+				US
+
+3C-59-1E   (hex)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+3C591E     (base 16)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+				7/FTCL Multimedia Building, TCL International E City, No.1001 Zhongshanyuan Road, Nanshan 
+				Shenzhen   Guangdong    518052
+				CN
+
+C4-36-55   (hex)		Shenzhen Fenglian Technology Co., Ltd.
+C43655     (base 16)		Shenzhen Fenglian Technology Co., Ltd.
+				Room 302, 3F, Block 2, Oriental Cyberport, No. 2, Xinxi Road
+				Shenzhen   Guangdong  518057
+				CN
+
+E0-B9-E5   (hex)		Technicolor
+E0B9E5     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+00-30-DA   (hex)		Comtrend Corporation
+0030DA     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+64-68-0C   (hex)		Comtrend Corporation
+64680C     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+38-72-C0   (hex)		Comtrend Corporation
+3872C0     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+A8-06-00   (hex)		Samsung Electronics Co.,Ltd
+A80600     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-26-82   (hex)		Gemtek Technology Co., Ltd.
+002682     (base 16)		Gemtek Technology Co., Ltd.
+				No.1 Jen Ai Road, Hsinchu Industrial Park,
+				Hukou,  Hsinchu  303
+				TW
+
+00-09-E1   (hex)		Gemtek Technology Co., Ltd.
+0009E1     (base 16)		Gemtek Technology Co., Ltd.
+				No.1 Jen Ai Road
+				Hukou  Hsinchu  303
+				TW
+
+14-C1-26   (hex)		Nokia Corporation
+14C126     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+60-01-94   (hex)		Espressif Inc.
+600194     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+F0-5A-09   (hex)		Samsung Electronics Co.,Ltd
+F05A09     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-32-75   (hex)		Samsung Electronics Co.,Ltd
+503275     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-FC-88   (hex)		Samsung Electronics Co.,Ltd
+08FC88     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+02-70-B3   (hex)		DATA RECALL LTD.
+0270B3     (base 16)		DATA RECALL LTD.
+				SONDES PLACE
+				12345  UNITED  KINGDOM
+				GB
+
+00-01-36   (hex)		CyberTAN Technology Inc.
+000136     (base 16)		CyberTAN Technology Inc.
+				99, Park Avenue III
+				Hsinchu    12345
+				TW
+
+D0-4D-2C   (hex)		Roku, Inc.
+D04D2C     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga  CA  95070
+				US
+
+B0-A7-37   (hex)		Roku, Inc.
+B0A737     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga  CA  95070
+				US
+
+14-0C-76   (hex)		FREEBOX SAS
+140C76     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS    75008
+				FR
+
+00-1B-E9   (hex)		Broadcom
+001BE9     (base 16)		Broadcom
+				16215 Alton Parkway
+				Irvine  CA  92618
+				US
+
+00-19-C7   (hex)		Cambridge Industries(Group) Co.,Ltd.
+0019C7     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				Room 309,333 Hong Qiao Road
+				Shanghai    200030
+				CN
+
+70-D9-31   (hex)		Cambridge Industries(Group) Co.,Ltd.
+70D931     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22Floor,Qilai Tower;889Yishan Road
+				shanghai    200233
+				CN
+
+02-9D-8E   (hex)		CARDIAC RECORDERS, INC.
+029D8E     (base 16)		CARDIAC RECORDERS, INC.
+				34 SCARBORO RD
+				UK  UNITED  KINGDOM
+				GB
+
+00-40-2A   (hex)		Canoga Perkins Corporation
+00402A     (base 16)		Canoga Perkins Corporation
+				21012 LASSEN STREET
+				CHATSWORTH  CA  91311-4241
+				US
+
+A4-C7-DE   (hex)		Cambridge Industries(Group) Co.,Ltd.
+A4C7DE     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22 Floor,Qilai Tower;889 Yishan Road
+				Shanghai    200233
+				CN
+
+D8-B8-F6   (hex)		Nantworks
+D8B8F6     (base 16)		Nantworks
+				12230 El Camino Real, Suite 400
+				San Diego  CA  92130
+				US
+
+00-80-77   (hex)		Brother industries, LTD.
+008077     (base 16)		Brother industries, LTD.
+				RESEARCH LABORATORY
+				piscatawa    12345
+				JP
+
+24-F5-AA   (hex)		Samsung Electronics Co.,Ltd
+24F5AA     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+98-83-89   (hex)		Samsung Electronics Co.,Ltd
+988389     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+84-A4-66   (hex)		Samsung Electronics Co.,Ltd
+84A466     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+C4-57-6E   (hex)		Samsung Electronics Co.,Ltd
+C4576E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+50-85-69   (hex)		Samsung Electronics Co.,Ltd
+508569     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-60-BB   (hex)		Cabletron Systems, Inc.
+0060BB     (base 16)		Cabletron Systems, Inc.
+				35 INDUSTRIAL WAY
+				ROCHESTER  NH  03866-5005
+				US
+
+F8-D0-BD   (hex)		Samsung Electronics Co.,Ltd
+F8D0BD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-59-5E   (hex)		Samsung Electronics Co.,Ltd
+78595E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-14-20   (hex)		Samsung Electronics Co.,Ltd
+0C1420     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-B1-0A   (hex)		Samsung Electronics Co.,Ltd
+94B10A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-BB-FD   (hex)		Samsung Electronics Co.,Ltd
+3CBBFD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-84-31   (hex)		Samsung Electronics Co.,Ltd
+A48431     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-B4-A5   (hex)		Samsung Electronics Co.,Ltd
+A0B4A5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-F8-EF   (hex)		Samsung Electronics Co.,Ltd
+E4F8EF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-44-6D   (hex)		Allwinner Technology Co., Ltd
+DC446D     (base 16)		Allwinner Technology Co., Ltd
+				No.9 Technology Road 2, High-Tech Zone
+				Zhuhai  Guangdong  519085
+				CN
+
+74-5A-AA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+745AAA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-FE-8D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04FE8D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-13-33   (hex)		BaudTec Corporation
+001333     (base 16)		BaudTec Corporation
+				12F, NO.181, Sec.  1. Tatung Rd.,
+				Hsichih  Taipei Hsien  221
+				TW
+
+58-67-1A   (hex)		Barnes&Noble
+58671A     (base 16)		Barnes&Noble
+				400 HAMILTON AVENUE
+				PALO ALTO  CA  94301
+				US
+
+00-26-75   (hex)		Aztech Electronics Pte Ltd
+002675     (base 16)		Aztech Electronics Pte Ltd
+				31 Ubi Road 1
+				Singapore    408694
+				SG
+
+00-24-FE   (hex)		AVM GmbH
+0024FE     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+C0-25-06   (hex)		AVM GmbH
+C02506     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+40-5D-82   (hex)		NETGEAR
+405D82     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+DC-EF-09   (hex)		NETGEAR
+DCEF09     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+DC-64-B8   (hex)		Shenzhen JingHanDa Electronics Co.Ltd
+DC64B8     (base 16)		Shenzhen JingHanDa Electronics Co.Ltd
+				5th Floor,No 4 ,Road 1,ShangXue Technology industrial Park,LongGang district,ShenZhen,GuangDong,China
+				ShenZhen  GuangDong  518129
+				CN
+
+00-0D-92   (hex)		ARIMA Communications Corp.
+000D92     (base 16)		ARIMA Communications Corp.
+				16, lane 658, Ying-Tao Road
+				Yingko  Taipei County  23943
+				TW
+
+00-21-63   (hex)		ASKEY COMPUTER CORP
+002163     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119.CHIENKANG RD,CHUNG-HO,
+				taipei  TAIPEI  235
+				TW
+
+A8-D3-F7   (hex)		Arcadyan Technology Corporation
+A8D3F7     (base 16)		Arcadyan Technology Corporation
+				No.8, Sec.2, Guangfu Rd.,
+				Hsinchu City  Hsinchu  30071
+				TW
+
+4C-60-DE   (hex)		NETGEAR
+4C60DE     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+C4-3D-C7   (hex)		NETGEAR
+C43DC7     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+48-9D-24   (hex)		BlackBerry RTS
+489D24     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+08-BD-43   (hex)		NETGEAR
+08BD43     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+44-EE-02   (hex)		MTI Ltd.
+44EE02     (base 16)		MTI Ltd.
+				Nishi-shinjuku Tokyo Opera City Tower 3-20-2 35F
+				Shinjuku-ku  Tokyo  163-1435
+				JP
+
+58-56-E8   (hex)		ARRIS Group, Inc.
+5856E8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-0B-BE   (hex)		ARRIS Group, Inc.
+F80BBE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+DC-45-17   (hex)		ARRIS Group, Inc.
+DC4517     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C8-AA-21   (hex)		ARRIS Group, Inc.
+C8AA21     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-17-EE   (hex)		ARRIS Group, Inc.
+0017EE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-11-1A   (hex)		ARRIS Group, Inc.
+00111A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0F-9F   (hex)		ARRIS Group, Inc.
+000F9F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-04-BD   (hex)		ARRIS Group, Inc.
+0004BD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-42   (hex)		ARRIS Group, Inc.
+002642     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-24-A1   (hex)		ARRIS Group, Inc.
+0024A1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-22-10   (hex)		ARRIS Group, Inc.
+002210     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-22-B4   (hex)		ARRIS Group, Inc.
+0022B4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-14-9A   (hex)		ARRIS Group, Inc.
+00149A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-14-E8   (hex)		ARRIS Group, Inc.
+0014E8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-19-C0   (hex)		ARRIS Group, Inc.
+0019C0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-E0-6F   (hex)		ARRIS Group, Inc.
+00E06F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+80-96-B1   (hex)		ARRIS Group, Inc.
+8096B1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-7E-43   (hex)		ARRIS Group, Inc.
+707E43     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-2F   (hex)		ARRIS Group, Inc.
+00152F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1F-C4   (hex)		ARRIS Group, Inc.
+001FC4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1C-FB   (hex)		ARRIS Group, Inc.
+001CFB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-95   (hex)		ARRIS Group, Inc.
+002395     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-AF   (hex)		ARRIS Group, Inc.
+0023AF     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-7B-7A   (hex)		ARRIS Group, Inc.
+F87B7A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-00-F4   (hex)		Allied Telesis, Inc.
+0000F4     (base 16)		Allied Telesis, Inc.
+				CORPORATION
+				SUNNYVALE  CA  94086
+				US
+
+00-15-77   (hex)		Allied Telesis, Inc.
+001577     (base 16)		Allied Telesis, Inc.
+				3200 North First Street
+				San Jose    95134
+				US
+
+00-1A-EB   (hex)		Allied Telesis R&D Center K.K.
+001AEB     (base 16)		Allied Telesis R&D Center K.K.
+				No.2 TOC Bldg.
+				Shinagawa-ku  Tokyo  141-0031
+				JP
+
+70-3C-39   (hex)		SEAWING Kft
+703C39     (base 16)		SEAWING Kft
+				Palánkai utca 5.
+				Székesfehérvár  Fejér  8000
+				HU
+
+90-97-D5   (hex)		Espressif Inc.
+9097D5     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+AC-D0-74   (hex)		Espressif Inc.
+ACD074     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+38-E3-C5   (hex)		Taicang T&W Electronics
+38E3C5     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+00-15-CE   (hex)		ARRIS Group, Inc.
+0015CE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-A2   (hex)		ARRIS Group, Inc.
+0015A2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-A3   (hex)		ARRIS Group, Inc.
+0015A3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-A4   (hex)		ARRIS Group, Inc.
+0015A4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-00-CA   (hex)		ARRIS Group, Inc.
+0000CA     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-9E-29   (hex)		Sony Interactive Entertainment Inc.
+709E29     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+A4-DB-30   (hex)		Liteon Technology Corporation
+A4DB30     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+40-F0-2F   (hex)		Liteon Technology Corporation
+40F02F     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+74-C2-46   (hex)		Amazon Technologies Inc.
+74C246     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-0F-A3   (hex)		Alpha Networks Inc.
+000FA3     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing 7th Rd.,Science-based Industrial Park
+				Hsinchu    300
+				TW
+
+00-1D-6A   (hex)		Alpha Networks Inc.
+001D6A     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing Seventh Road,Science-based
+				Hsinchu    300
+				US
+
+00-23-45   (hex)		Sony Mobile Communications Inc
+002345     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+6C-0E-0D   (hex)		Sony Mobile Communications Inc
+6C0E0D     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+6C-23-B9   (hex)		Sony Mobile Communications Inc
+6C23B9     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+30-17-C8   (hex)		Sony Mobile Communications Inc
+3017C8     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-12-EE   (hex)		Sony Mobile Communications Inc
+0012EE     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-16-20   (hex)		Sony Mobile Communications Inc
+001620     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-19-63   (hex)		Sony Mobile Communications Inc
+001963     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-1F-E4   (hex)		Sony Mobile Communications Inc
+001FE4     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+20-54-76   (hex)		Sony Mobile Communications Inc
+205476     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-1A-80   (hex)		Sony Corporation
+001A80     (base 16)		Sony Corporation
+				Gotenyama Tec, 5-1-2 Kitashinagawa
+				Tokyo    141-0001
+				JP
+
+88-41-FC   (hex)		AirTies Wireless Networks
+8841FC     (base 16)		AirTies Wireless Networks
+				Gulbahar Mahallesi, Avni Diligil Sokak
+				ISTANBUL  ISTANBUL  34394
+				TR
+
+00-30-D3   (hex)		Agilent Technologies, Inc.
+0030D3     (base 16)		Agilent Technologies, Inc.
+				1501 Page Mill Road
+				Palo Alto  CA  94304-1126
+				US
+
+00-A0-2F   (hex)		ADB Broadband Italia
+00A02F     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				20126 MILAN    12345
+				IT
+
+98-74-3D   (hex)		Shenzhen Jun Kai Hengye Technology Co. Ltd
+98743D     (base 16)		Shenzhen Jun Kai Hengye Technology Co. Ltd
+				5th floor,Yahua Building,#1Hongwan Gonghegongye RD,Xixiang Gushu Community,Baoan District,Shenzhen
+				Shenzhen  Guangdong  518000
+				CN
+
+A0-F4-59   (hex)		FN-LINK TECHNOLOGY LIMITED
+A0F459     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				5th Floor, A Building, Haoye Logistics Park, Shugang Channel, Bao'an District,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+58-63-56   (hex)		FN-LINK TECHNOLOGY LIMITED
+586356     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				5th Floor, A Building, Haoye Logistics Park, Shugang Channel, Bao'an District,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+8C-B8-64   (hex)		AcSiP Technology Corp.
+8CB864     (base 16)		AcSiP Technology Corp.
+				3F., No.22, Dalin Rd., 
+				Taoyuan City    330
+				TW
+
+5C-E2-F4   (hex)		AcSiP Technology Corp.
+5CE2F4     (base 16)		AcSiP Technology Corp.
+				3F., No.22, Dalin Rd.
+				Taoyuan  Taoyuan County  33067
+				TW
+
+B8-61-6F   (hex)		Accton Technology Corp
+B8616F     (base 16)		Accton Technology Corp
+				No.1 Creation Rd III, Science-based Industrial Park
+				Hsinchu    30077
+				TW
+
+00-12-CF   (hex)		Accton Technology Corp
+0012CF     (base 16)		Accton Technology Corp
+				No. 1 Creation Rd. III, Science-based Industrial Park
+				Hsinchu    300
+				TW
+
+00-30-F1   (hex)		Accton Technology Corp
+0030F1     (base 16)		Accton Technology Corp
+				No. 1, Creation Rd. IV
+				Hsinchu    12345
+				TW
+
+70-5A-0F   (hex)		Hewlett Packard
+705A0F     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+44-95-FA   (hex)		Qingdao Santong Digital Technology Co.Ltd
+4495FA     (base 16)		Qingdao Santong Digital Technology Co.Ltd
+				Room701, No.1£¬Fu Ying Building,No.443East Changjiang Road,Qingdao Economic and Technological Development District
+				Qingdao  Shandong  266555
+				CN
+
+00-25-D3   (hex)		AzureWave Technology Inc.
+0025D3     (base 16)		AzureWave Technology Inc.
+				8F ., No.94, Baozhong Rd.
+				Xindian City    231
+				TW
+
+1C-4B-D6   (hex)		AzureWave Technology Inc.
+1C4BD6     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baoshong Rd.
+				Xindian City, Taipei County    231
+				TW
+
+08-A9-5A   (hex)		AzureWave Technology Inc.
+08A95A     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baoshong Rd.
+				Xindian City, Taipei County    231
+				TW
+
+94-DB-C9   (hex)		AzureWave Technology Inc.
+94DBC9     (base 16)		AzureWave Technology Inc.
+				8F No94 Baozhong Rd
+				XindianDistrict, New Taipei City    231
+				TW
+
+24-0A-64   (hex)		AzureWave Technology Inc.
+240A64     (base 16)		AzureWave Technology Inc.
+				9F.,No.92,Baozhong Rd
+				Xindian  NewTaipeiCity  231
+				TW
+
+40-E2-30   (hex)		AzureWave Technology Inc.
+40E230     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.,
+				New Taipei City  Taiwan  231
+				TW
+
+80-D2-1D   (hex)		AzureWave Technology Inc.
+80D21D     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+D4-D1-84   (hex)		ADB Broadband Italia
+D4D184     (base 16)		ADB Broadband Italia
+				via Sarca 222
+				Milano    20126
+				IT
+
+A0-4F-D4   (hex)		ADB Broadband Italia
+A04FD4     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				IT
+
+D0-0E-D9   (hex)		Taicang T&W Electronics
+D00ED9     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD, Lu Du
+				Taicang  Jiangsu  215412
+				CN
+
+54-14-73   (hex)		 Wingtech Group (HongKong）Limited
+541473     (base 16)		 Wingtech Group (HongKong）Limited
+				FLAT/RM 1903 19/F PODIUM PLAZA 5HANOI ROAD TSIM SHA TSUI
+				HongKong    999077
+				HK
+
+80-86-F2   (hex)		Intel Corporate
+8086F2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+E0-94-67   (hex)		Intel Corporate
+E09467     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+08-D4-0C   (hex)		Intel Corporate
+08D40C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+6C-88-14   (hex)		Intel Corporate
+6C8814     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+30-3A-64   (hex)		Intel Corporate
+303A64     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+AC-FD-CE   (hex)		Intel Corporate
+ACFDCE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+7C-CC-B8   (hex)		Intel Corporate
+7CCCB8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+F4-06-69   (hex)		Intel Corporate
+F40669     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1D-E1   (hex)		Intel Corporate
+001DE1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+90-E2-BA   (hex)		Intel Corporate
+90E2BA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-26-C7   (hex)		Intel Corporate
+0026C7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-26-C6   (hex)		Intel Corporate
+0026C6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+0C-CC-26   (hex)		Airenetworks
+0CCC26     (base 16)		Airenetworks
+				Ramon y Cajal 11
+				Elche  Alicante  03203
+				ES
+
+E0-9D-31   (hex)		Intel Corporate
+E09D31     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+88-53-2E   (hex)		Intel Corporate
+88532E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+74-C9-9A   (hex)		Ericsson AB
+74C99A     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+5C-C2-13   (hex)		Fr. Sauter AG
+5CC213     (base 16)		Fr. Sauter AG
+				Im Surinam 55
+				Basel  BS  CH4016
+				CH
+
+28-10-1B   (hex)		MagnaCom
+28101B     (base 16)		MagnaCom
+				9 Bareket Street
+				Petah Tikva    4951777
+				IL
+
+00-16-76   (hex)		Intel Corporate
+001676     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-16-EA   (hex)		Intel Corporate
+0016EA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1B-77   (hex)		Intel Corporate
+001B77     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1C-C0   (hex)		Intel Corporate
+001CC0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-4A-7D   (hex)		Intel Corporate
+104A7D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1A-A0   (hex)		Dell Inc.
+001AA0     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+00-19-B9   (hex)		Dell Inc.
+0019B9     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-B0-D0   (hex)		Dell Inc.
+00B0D0     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-C0-4F   (hex)		Dell Inc.
+00C04F     (base 16)		Dell Inc.
+				1807 WEST BRAKER LANE-BLDG.
+				AUSTIN  TX  78758-3610
+				US
+
+B0-79-94   (hex)		Motorola Mobility LLC, a Lenovo Company
+B07994     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Hwy 45
+				Libertyville  IL  60048
+				US
+
+A4-70-D6   (hex)		Motorola Mobility LLC, a Lenovo Company
+A470D6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+74-86-7A   (hex)		Dell Inc.
+74867A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+18-03-73   (hex)		Dell Inc.
+180373     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+14-FE-B5   (hex)		Dell Inc.
+14FEB5     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+78-2B-CB   (hex)		Dell Inc.
+782BCB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-1F-3B   (hex)		Intel Corporate
+001F3B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-21-5D   (hex)		Intel Corporate
+00215D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-21-6A   (hex)		Intel Corporate
+00216A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1C-23   (hex)		Dell Inc.
+001C23     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+A4-BA-DB   (hex)		Dell Inc.
+A4BADB     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+00-25-64   (hex)		Dell Inc.
+002564     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+A4-1F-72   (hex)		Dell Inc.
+A41F72     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock     78682
+				US
+
+C4-66-99   (hex)		vivo Mobile Communication Co., Ltd.
+C46699     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+C8-F2-30   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C8F230     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+8C-0E-E3   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+8C0EE3     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+C8-CD-72   (hex)		Sagemcom Broadband SAS
+C8CD72     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+F8-2C-18   (hex)		2Wire Inc
+F82C18     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+18-01-7D   (hex)		Harbin Arteor technology co., LTD
+18017D     (base 16)		Harbin Arteor technology co., LTD
+				Yushan Road 49-2
+				Harbin  Heilongjiang  150090
+				CN
+
+00-15-56   (hex)		Sagemcom Broadband SAS
+001556     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+C0-D0-44   (hex)		Sagemcom Broadband SAS
+C0D044     (base 16)		Sagemcom Broadband SAS
+				250, Route de l'Empereur
+				RUEIL-MALMAISON    92500
+				FR
+
+A0-1B-29   (hex)		Sagemcom Broadband SAS
+A01B29     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+74-E1-4A   (hex)		IEEE Registration Authority
+74E14A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-EF-AF   (hex)		IEEE Registration Authority
+0CEFAF     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-02-78   (hex)		IEEE Registration Authority
+F80278     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A0-BB-3E   (hex)		IEEE Registration Authority
+A0BB3E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+88-4A-EA   (hex)		Texas Instruments
+884AEA     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-22-A4   (hex)		2Wire Inc
+0022A4     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+98-2C-BE   (hex)		2Wire Inc
+982CBE     (base 16)		2Wire Inc
+				1764 Automation Pkwy
+				San Jose  CA  95131
+				US
+
+64-0F-28   (hex)		2Wire Inc
+640F28     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose   CA  95131
+				US
+
+00-12-3F   (hex)		Dell Inc.
+00123F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-0B-DB   (hex)		Dell Inc.
+000BDB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+20-47-47   (hex)		Dell Inc.
+204747     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-14-95   (hex)		2Wire Inc
+001495     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  95131
+				US
+
+34-8A-AE   (hex)		Sagemcom Broadband SAS
+348AAE     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+7C-03-D8   (hex)		Sagemcom Broadband SAS
+7C03D8     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+C0-AC-54   (hex)		Sagemcom Broadband SAS
+C0AC54     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+2C-39-96   (hex)		Sagemcom Broadband SAS
+2C3996     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+F0-82-61   (hex)		Sagemcom Broadband SAS
+F08261     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+00-30-C5   (hex)		CADENCE DESIGN SYSTEMS, INC.
+0030C5     (base 16)		CADENCE DESIGN SYSTEMS, INC.
+				555 RIVER OAKS PARKWAY
+				SAN JOSE  CA  95134
+				US
+
+D0-8C-B5   (hex)		Texas Instruments
+D08CB5     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-2F   (hex)		Texas Instruments
+00182F     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-EA   (hex)		Texas Instruments
+0017EA     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-21-BA   (hex)		Texas Instruments
+0021BA     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+BC-0D-A5   (hex)		Texas Instruments
+BC0DA5     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+CC-8C-E3   (hex)		Texas Instruments
+CC8CE3     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+E0-D7-BA   (hex)		Texas Instruments
+E0D7BA     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+1C-E2-CC   (hex)		Texas Instruments
+1CE2CC     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+98-59-45   (hex)		Texas Instruments
+985945     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+94-44-52   (hex)		Belkin International Inc.
+944452     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+B0-B4-48   (hex)		Texas Instruments
+B0B448     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+D4-94-A1   (hex)		Texas Instruments
+D494A1     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-14-BF   (hex)		Cisco-Linksys, LLC
+0014BF     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+CC-B2-55   (hex)		D-Link International
+CCB255     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+28-10-7B   (hex)		D-Link International
+28107B     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+FC-75-16   (hex)		D-Link International
+FC7516     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+84-C9-B2   (hex)		D-Link International
+84C9B2     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+C8-D3-A3   (hex)		D-Link International
+C8D3A3     (base 16)		D-Link International
+				1 Internal Business Park, #03-12. The Synergy Singapore
+				Singapore    609917
+				US
+
+3C-BB-73   (hex)		Shenzhen Xinguodu Technology Co., Ltd.
+3CBB73     (base 16)		Shenzhen Xinguodu Technology Co., Ltd.
+				F17A, JinSong Building, Tairan Industrial & Trade Park, Chegongmiao, Shennan Road，Futian District
+				Shenzhen  Guangdong  518040
+				CN
+
+0C-47-C9   (hex)		Amazon Technologies Inc.
+0C47C9     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-50-BA   (hex)		D-Link Corporation
+0050BA     (base 16)		D-Link Corporation
+				2F, NO. 233L-2, PAO-CHIAO RD.
+				TAIPEI    0000
+				TW
+
+00-17-9A   (hex)		D-Link Corporation
+00179A     (base 16)		D-Link Corporation
+				No. 289, Sinhu 3rd Rd., Neihu District,
+				Taipei    114
+				TW
+
+00-1C-F0   (hex)		D-Link Corporation
+001CF0     (base 16)		D-Link Corporation
+				NO.289, Sinhu 3rd Rd.,
+				Neihu District,  Taipei City  114
+				TW
+
+00-1E-58   (hex)		D-Link Corporation
+001E58     (base 16)		D-Link Corporation
+				NO.289, Sinhu 3rd Rd.,
+				Neihu District,  Taipei City  114
+				TW
+
+00-22-B0   (hex)		D-Link Corporation
+0022B0     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd RD.,
+				Neihu District,  Taipei City  114
+				TW
+
+00-24-01   (hex)		D-Link Corporation
+002401     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd RD.,
+				Neihu District,  Taipei City  114
+				TW
+
+1C-AF-F7   (hex)		D-Link International
+1CAFF7     (base 16)		D-Link International
+				1 INTERNATIONAL  BUSINESS  PARK,
+				SINGAPORE    609917
+				SG
+
+14-D6-4D   (hex)		D-Link International
+14D64D     (base 16)		D-Link International
+				1 INTERNATIONAL BUSINESS PARK
+				SINGAPORE    609917
+				SG
+
+90-94-E4   (hex)		D-Link International
+9094E4     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+B4-99-BA   (hex)		Hewlett Packard
+B499BA     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+04-78-63   (hex)		Shanghai MXCHIP Information Technology Co., Ltd.
+047863     (base 16)		Shanghai MXCHIP Information Technology Co., Ltd.
+				9th Floor, No. 5 Building, 2145 Jinshajiang Rd., Putuo District
+				Shanghai    200333
+				CN
+
+40-9F-87   (hex)		Jide Technology (Hong Kong) Limited
+409F87     (base 16)		Jide Technology (Hong Kong) Limited
+				jiahua Mansion 3F, 133 North 4th Ring Road East, Chaoyang District
+				Beijing    100101
+				CN
+
+0C-F9-C0   (hex)		BSkyB Ltd
+0CF9C0     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+4C-FF-12   (hex)		Fuze Entertainment Co., ltd
+4CFF12     (base 16)		Fuze Entertainment Co., ltd
+				3rd Floor Harbour Centre
+				George Town  George Town  P.O. Box 613GT
+				KY
+
+AC-9A-22   (hex)		NXP Semiconductors
+AC9A22     (base 16)		NXP Semiconductors
+				411 E. Plumeria Drive
+				San Jose  CA  95134
+				US
+
+28-7C-DB   (hex)		Hefei  Toycloud Technology Co.,ltd
+287CDB     (base 16)		Hefei  Toycloud Technology Co.,ltd
+				FLOOR 13,XUNFEI BUILDING,NO.666 WANGJIANG ROAD,HIGH & NEW TECHNOLOGY DEVELOPMENT ZONE.HEFEI.
+				Hefei  Anhui  230088
+				CN
+
+80-6A-B0   (hex)		Shenzhen TINNO Mobile Technology Corp.
+806AB0     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park
+				Nanshan District, Shenzhen  GUANGDONG  518053
+				CN
+
+48-AD-08   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48AD08     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-FB-45   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CFB45     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+00-9A-CD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+009ACD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+3C-5A-B4   (hex)		Google, Inc.
+3C5AB4     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View    94043
+				US
+
+F4-F5-E8   (hex)		Google, Inc.
+F4F5E8     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View    94043
+				US
+
+94-EB-2C   (hex)		Google, Inc.
+94EB2C     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View    94043
+				US
+
+0C-C7-31   (hex)		Currant, Inc.
+0CC731     (base 16)		Currant, Inc.
+				927 Industrial Ave
+				Palo Alto  CA  94303
+				US
+
+70-B3-D5   (hex)		IEEE Registration Authority
+70B3D5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+28-ED-6A   (hex)		Apple, Inc.
+28ED6A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-56-E3   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+C056E3     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+EC-3E-F7   (hex)		Juniper Networks
+EC3EF7     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+0C-F8-93   (hex)		ARRIS Group, Inc.
+0CF893     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-DF-A9   (hex)		ARRIS Group, Inc.
+3CDFA9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+84-61-A0   (hex)		ARRIS Group, Inc.
+8461A0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-D1   (hex)		ARRIS Group, Inc.
+0015D1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-D0   (hex)		ARRIS Group, Inc.
+001DD0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-D3   (hex)		ARRIS Group, Inc.
+001DD3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+AC-B3-13   (hex)		ARRIS Group, Inc.
+ACB313     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+38-F2-3E   (hex)		Microsoft Mobile Oy
+38F23E     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+E4-F8-9C   (hex)		Intel Corporate
+E4F89C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+6C-A1-00   (hex)		Intel Corporate
+6CA100     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+2C-41-38   (hex)		Hewlett Packard
+2C4138     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+44-1E-A1   (hex)		Hewlett Packard
+441EA1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+78-E7-D1   (hex)		Hewlett Packard
+78E7D1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+5C-8F-E0   (hex)		ARRIS Group, Inc.
+5C8FE0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+90-C7-92   (hex)		ARRIS Group, Inc.
+90C792     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+BC-CA-B5   (hex)		ARRIS Group, Inc.
+BCCAB5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D0-39-B3   (hex)		ARRIS Group, Inc.
+D039B3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0F-CC   (hex)		ARRIS Group, Inc.
+000FCC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-12-F0   (hex)		Intel Corporate
+0012F0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-07-40   (hex)		BUFFALO.INC
+000740     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+00-24-A5   (hex)		BUFFALO.INC
+0024A5     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+CC-E1-D5   (hex)		BUFFALO.INC
+CCE1D5     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg.,30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref  460-8315
+				JP
+
+A4-02-B9   (hex)		Intel Corporate
+A402B9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+DC-53-60   (hex)		Intel Corporate
+DC5360     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1C-C4   (hex)		Hewlett Packard
+001CC4     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-1E-0B   (hex)		Hewlett Packard
+001E0B     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-22-64   (hex)		Hewlett Packard
+002264     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-25-B3   (hex)		Hewlett Packard
+0025B3     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-0C-F1   (hex)		Intel Corporation
+000CF1     (base 16)		Intel Corporation
+				MS: JF3-420
+				Hillsboro  OR  97124
+				US
+
+78-48-59   (hex)		Hewlett Packard
+784859     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+58-DC-6D   (hex)		Exceptional Innovation, Inc.
+58DC6D     (base 16)		Exceptional Innovation, Inc.
+				480 Olde Worthington Rd, Suite 350
+				Westerville  OH  43082
+				US
+
+90-21-55   (hex)		HTC Corporation
+902155     (base 16)		HTC Corporation
+				No.23 Xinghua Road
+				Taoyuan County    330
+				TW
+
+64-31-50   (hex)		Hewlett Packard
+643150     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+7C-B1-5D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7CB15D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+00-26-5E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00265E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-24-2C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00242C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+D8-B3-77   (hex)		HTC Corporation
+D8B377     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., 
+				Taoyuan City    330
+				TW
+
+B0-F1-A3   (hex)		Fengfan (BeiJing) Technology Co., Ltd. 
+B0F1A3     (base 16)		Fengfan (BeiJing) Technology Co., Ltd. 
+				Room518,Dianzichengdasha Town,No12,Jiuxianqiao Road
+				Beijing  Chaoyang District  100016
+				CN
+
+34-64-A9   (hex)		Hewlett Packard
+3464A9     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+38-63-BB   (hex)		Hewlett Packard
+3863BB     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+5C-B9-01   (hex)		Hewlett Packard
+5CB901     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+DC-4A-3E   (hex)		Hewlett Packard
+DC4A3E     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+B0-5A-DA   (hex)		Hewlett Packard
+B05ADA     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-10-83   (hex)		Hewlett Packard
+001083     (base 16)		Hewlett Packard
+				MAIL STOP 42LE
+				CUPERTINO  CA  95014
+				US
+
+A0-B3-CC   (hex)		Hewlett Packard
+A0B3CC     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+EC-B1-D7   (hex)		Hewlett Packard
+ECB1D7     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+9C-B6-54   (hex)		Hewlett Packard
+9CB654     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+6C-3B-E5   (hex)		Hewlett Packard
+6C3BE5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+B0-AA-36   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B0AA36     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+78-4B-87   (hex)		Murata Manufacturing Co., Ltd.
+784B87     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1,Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+E4-CE-02   (hex)		WyreStorm Technologies Ltd
+E4CE02     (base 16)		WyreStorm Technologies Ltd
+				Tech Valley Park, 23 Wood Road
+				Round Lake  New York  12151
+				GB
+
+40-F3-08   (hex)		Murata Manufacturing Co., Ltd.
+40F308     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+80-89-17   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+808917     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+A0-93-47   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A09347     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN,DONGGUAN,GUANGDONG,CHINA
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+E8-BB-A8   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+E8BBA8     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN,DONGGUAN,GUANGDONG,CHINA
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+94-2C-B3   (hex)		HUMAX Co., Ltd.
+942CB3     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+00-27-19   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+002719     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+40-16-9F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+40169F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+F4-EC-38   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F4EC38     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+14-04-67   (hex)		SNK Technologies Co.,Ltd.
+140467     (base 16)		SNK Technologies Co.,Ltd.
+				#1001, Byuksan Sunyoung Technopia, A-dong, 13
+				Ojeongongeop-gil, Uiwang-si,  Gyeonggi-do  16072
+				KR
+
+80-30-DC   (hex)		Texas Instruments
+8030DC     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A4-D5-78   (hex)		Texas Instruments
+A4D578     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+14-CF-92   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+14CF92     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				shenzhen  guangdong Province  518057
+				CN
+
+20-DC-E6   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+20DCE6     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				shenzhen  guangdong Province  518057
+				CN
+
+14-CC-20   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+14CC20     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+24-60-81   (hex)		razberi technologies
+246081     (base 16)		razberi technologies
+				13755 Hutton Drive Suite 500
+				Farmers Branch  TX  75234
+				US
+
+A4-D1-8C   (hex)		Apple, Inc.
+A4D18C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-F6-52   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+90F652     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan,
+				Shenzhen  Guangdong Province,  518057
+				CN
+
+24-1E-EB   (hex)		Apple, Inc.
+241EEB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-25-EF   (hex)		Apple, Inc.
+CC25EF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-CF-98   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88CF98     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F8-0D-43   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F80D43     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+38-F8-89   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38F889     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-7A-B5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D07AB5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-19-C6   (hex)		zte corporation
+0019C6     (base 16)		zte corporation
+				Technology Management Department, 
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1D-D9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001DD9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-19-7D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00197D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+7C-4C-A5   (hex)		BSkyB Ltd
+7C4CA5     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+00-14-A4   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0014A4     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+78-DD-08   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+78DD08     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+9C-D2-1E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9CD21E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+B4-30-52   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B43052     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+80-D0-9B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80D09B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-8E-5C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C8E5C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-74-2A   (hex)		zte corporation
+84742A     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+9C-D2-4B   (hex)		zte corporation
+9CD24B     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+C8-7B-5B   (hex)		zte corporation
+C87B5B     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+00-07-D8   (hex)		Hitron Technologies. Inc
+0007D8     (base 16)		Hitron Technologies. Inc
+				135-220 Hitron B/D 726-5
+				Seoul    13456
+				KR
+
+C0-3E-0F   (hex)		BSkyB Ltd
+C03E0F     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+90-4E-2B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+904E2B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-08-ED   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2008ED     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-34-FE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0034FE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-51-95   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C85195     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+40-CB-A8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+40CBA8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+D4-6E-5C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D46E5C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+88-53-D4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8853D4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+04-C0-6F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04C06F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+20-2B-C1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+202BC1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+54-A5-1B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+54A51B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+00-25-68   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+002568     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+78-1D-BA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+781DBA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				HUAWEI Industrial Base Bantian,Longgang
+				Shenzhen  guangdong  518129
+				CN
+
+00-25-9E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00259E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				B1-7,Huawei Base,Bantian, Longgang District,ShenZhen,GuangDong,CHINA
+				ShenZhen  GuangDong  518129
+				CN
+
+00-6B-8E   (hex)		Shanghai Feixun Communication Co.,Ltd.
+006B8E     (base 16)		Shanghai Feixun Communication Co.,Ltd.
+				Building 90,No,4855,Guangfulin Road
+				shanghai  Shanghai  201616
+				CN
+
+D4-6A-A8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D46AA8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen    518129
+				CN
+
+BC-AD-AB   (hex)		Avaya Inc
+BCADAB     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+FC-A8-41   (hex)		Avaya Inc
+FCA841     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+3C-B1-5B   (hex)		Avaya Inc
+3CB15B     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+34-75-C7   (hex)		Avaya Inc
+3475C7     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+B0-AD-AA   (hex)		Avaya Inc
+B0ADAA     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+B4-47-5E   (hex)		Avaya Inc
+B4475E     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+B8-BC-1B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B8BC1B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-2A-F7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+582AF7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-D9-21   (hex)		Avaya Inc
+24D921     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+84-83-71   (hex)		Avaya Inc
+848371     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-1B-4F   (hex)		Avaya Inc
+001B4F     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+4C-8B-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4C8BEF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+50-06-AB   (hex)		Cisco Systems, Inc
+5006AB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+FC-48-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC48EF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+70-7B-E8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+707BE8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+4C-1F-CC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4C1FCC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+00-90-6D   (hex)		Cisco Systems, Inc
+00906D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-90-AB   (hex)		Cisco Systems, Inc
+0090AB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-54   (hex)		Cisco Systems, Inc
+005054     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-50-0B   (hex)		Cisco Systems, Inc
+00500B     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-03-DD   (hex)		Comark Interactive Solutions
+0003DD     (base 16)		Comark Interactive Solutions
+				93 West St.
+				Medfield  MA  02052
+				US
+
+00-50-53   (hex)		Cisco Systems, Inc
+005053     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-50   (hex)		Cisco Systems, Inc
+005050     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-B1-10   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D4B110     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+E4-68-A3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E468A3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+24-71-89   (hex)		Texas Instruments
+247189     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+98-7B-F3   (hex)		Texas Instruments
+987BF3     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+A0-F6-FD   (hex)		Texas Instruments
+A0F6FD     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+D0-B5-C2   (hex)		Texas Instruments
+D0B5C2     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+78-A5-04   (hex)		Texas Instruments
+78A504     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+6C-EC-EB   (hex)		Texas Instruments
+6CECEB     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+34-00-A3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3400A3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+00-90-2B   (hex)		Cisco Systems, Inc
+00902B     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-8F   (hex)		Cisco Systems, Inc
+00E08F     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-18-68   (hex)		Cisco SPVTG
+001868     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+88-75-56   (hex)		Cisco Systems, Inc
+887556     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+FC-99-47   (hex)		Cisco Systems, Inc
+FC9947     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+6C-20-56   (hex)		Cisco Systems, Inc
+6C2056     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-15-F2   (hex)		ASUSTek COMPUTER INC.
+0015F2     (base 16)		ASUSTek COMPUTER INC.
+				No.5 Shing Yeh Street,Kwei Shan Hsiang,Taoyuan
+				Taipei    333
+				TW
+
+90-E6-BA   (hex)		ASUSTek COMPUTER INC.
+90E6BA     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+00-26-18   (hex)		ASUSTek COMPUTER INC.
+002618     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+F4-6D-04   (hex)		ASUSTek COMPUTER INC.
+F46D04     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,
+				Taipei    112
+				TW
+
+00-E0-18   (hex)		ASUSTek COMPUTER INC.
+00E018     (base 16)		ASUSTek COMPUTER INC.
+				150 LI-TE RD.
+				PEITOU, TAIPEI    77777
+				TW
+
+00-0C-6E   (hex)		ASUSTek COMPUTER INC.
+000C6E     (base 16)		ASUSTek COMPUTER INC.
+				150, Li-Te Rd., PeiTou
+				Taipei    112
+				TW
+
+00-0E-A6   (hex)		ASUSTek COMPUTER INC.
+000EA6     (base 16)		ASUSTek COMPUTER INC.
+				150, Li-Te Rd., PeiTou
+				Taipei    112
+				TW
+
+00-1D-60   (hex)		ASUSTek COMPUTER INC.
+001D60     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou
+				Taipei    112
+				TW
+
+6C-41-6A   (hex)		Cisco Systems, Inc
+6C416A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+EC-E1-A9   (hex)		Cisco Systems, Inc
+ECE1A9     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C0-67-AF   (hex)		Cisco Systems, Inc
+C067AF     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+AC-F2-C5   (hex)		Cisco Systems, Inc
+ACF2C5     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+24-01-C7   (hex)		Cisco Systems, Inc
+2401C7     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+68-86-A7   (hex)		Cisco Systems, Inc
+6886A7     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C0-25-5C   (hex)		Cisco Systems, Inc
+C0255C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+3C-0E-23   (hex)		Cisco Systems, Inc
+3C0E23     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+08-CC-68   (hex)		Cisco Systems, Inc
+08CC68     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+0C-27-24   (hex)		Cisco Systems, Inc
+0C2724     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+6C-FA-89   (hex)		Cisco Systems, Inc
+6CFA89     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-E0-A3   (hex)		Cisco Systems, Inc
+00E0A3     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+60-2A-D0   (hex)		Cisco SPVTG
+602AD0     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+74-5E-1C   (hex)		PIONEER CORPORATION
+745E1C     (base 16)		PIONEER CORPORATION
+				1-1 Shin-ogura
+				Kawasaki-shi  Kanagawa Prefecture  2120031
+				JP
+
+04-62-73   (hex)		Cisco Systems, Inc
+046273     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+D8-B1-90   (hex)		Cisco Systems, Inc
+D8B190     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+80-E8-6F   (hex)		Cisco Systems, Inc
+80E86F     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+AC-7E-8A   (hex)		Cisco Systems, Inc
+AC7E8A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+1C-E8-5D   (hex)		Cisco Systems, Inc
+1CE85D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+A8-9D-21   (hex)		Cisco Systems, Inc
+A89D21     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+68-9C-E2   (hex)		Cisco Systems, Inc
+689CE2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-23-BE   (hex)		Cisco SPVTG
+0023BE     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+18-59-33   (hex)		Cisco SPVTG
+185933     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+44-58-29   (hex)		Cisco SPVTG
+445829     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+F4-4E-05   (hex)		Cisco Systems, Inc
+F44E05     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+88-1D-FC   (hex)		Cisco Systems, Inc
+881DFC     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-10-11   (hex)		Cisco Systems, Inc
+001011     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-00-0C   (hex)		Cisco Systems, Inc
+00000C     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+28-CF-E9   (hex)		Apple, Inc.
+28CFE9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-A0-40   (hex)		Apple, Inc.
+00A040     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-F8-49   (hex)		Cisco Systems, Inc
+A0F849     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+3C-D0-F8   (hex)		Apple, Inc.
+3CD0F8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-09-27   (hex)		Apple, Inc.
+680927     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-C2-6B   (hex)		Apple, Inc.
+6CC26B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-D8-84   (hex)		Apple, Inc.
+44D884     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-26-08   (hex)		Apple, Inc.
+002608     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-26-B0   (hex)		Apple, Inc.
+0026B0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-26-BB   (hex)		Apple, Inc.
+0026BB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-9A-20   (hex)		Apple, Inc.
+D49A20     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-1E-DF   (hex)		Apple, Inc.
+F81EDF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-2A-14   (hex)		Apple, Inc.
+C82A14     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-07-54   (hex)		Apple, Inc.
+3C0754     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-B1-97   (hex)		Apple, Inc.
+A4B197     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-B4-79   (hex)		Apple, Inc.
+F0B479     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-93-E9   (hex)		Apple, Inc.
+1093E9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-2A-60   (hex)		Apple, Inc.
+442A60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-D1-D2   (hex)		Apple, Inc.
+A4D1D2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-CF-DA   (hex)		Apple, Inc.
+28CFDA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-30-65   (hex)		Apple, Inc.
+003065     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-14-51   (hex)		Apple, Inc.
+001451     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1E-52   (hex)		Apple, Inc.
+001E52     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-21-E9   (hex)		Apple, Inc.
+0021E9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-08-E0   (hex)		Apple, Inc.
+CC08E0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-54-53   (hex)		Apple, Inc.
+045453     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-F9-51   (hex)		Apple, Inc.
+F4F951     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-63-94   (hex)		Apple, Inc.
+C06394     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-AF-8F   (hex)		Apple, Inc.
+18AF8F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-B5-B7   (hex)		Apple, Inc.
+C8B5B7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-B2-1F   (hex)		Apple, Inc.
+90B21F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-F7-C5   (hex)		Apple, Inc.
+30F7C5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-B3-95   (hex)		Apple, Inc.
+40B395     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-FB-42   (hex)		Apple, Inc.
+44FB42     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-8D-28   (hex)		Apple, Inc.
+E88D28     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-94-26   (hex)		Apple, Inc.
+949426     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-7D-74   (hex)		Apple, Inc.
+207D74     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-F1-5A   (hex)		Apple, Inc.
+F4F15A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-6F-1D   (hex)		Apple, Inc.
+C86F1D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-90-AB   (hex)		Apple, Inc.
+3090AB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-2D-AA   (hex)		Apple, Inc.
+8C2DAA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-85-06   (hex)		Apple, Inc.
+848506     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-FE-94   (hex)		Apple, Inc.
+98FE94     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-00-4D   (hex)		Apple, Inc.
+D8004D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-20-0C   (hex)		Apple, Inc.
+64200C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-33-4B   (hex)		Apple, Inc.
+C8334B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-E6-82   (hex)		Apple, Inc.
+64E682     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-E8-56   (hex)		Apple, Inc.
+B8E856     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-96-95   (hex)		Apple, Inc.
+D89695     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-99-E2   (hex)		Apple, Inc.
+1499E2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-18-D1   (hex)		Apple, Inc.
+B418D1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-20-7B   (hex)		Apple, Inc.
+9C207B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-65-BD   (hex)		Apple, Inc.
+B065BD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-26-96   (hex)		Apple, Inc.
+542696     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-A3-CB   (hex)		Apple, Inc.
+64A3CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-3C-92   (hex)		Apple, Inc.
+903C92     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-1D-72   (hex)		Apple, Inc.
+D81D72     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-12-98   (hex)		Apple, Inc.
+341298     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-E7-2C   (hex)		Apple, Inc.
+70E72C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-EC-E4   (hex)		Apple, Inc.
+70ECE4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-AE-20   (hex)		Apple, Inc.
+68AE20     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-87-A3   (hex)		Apple, Inc.
+AC87A3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-BB-2C   (hex)		Apple, Inc.
+D8BB2C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-4F-7E   (hex)		Apple, Inc.
+D04F7E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-78-F0   (hex)		Apple, Inc.
+2078F0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-AC-CB   (hex)		Apple, Inc.
+E0ACCB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-99-9B   (hex)		Apple, Inc.
+A0999B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-24-0E   (hex)		Apple, Inc.
+24240E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-DB-F8   (hex)		Apple, Inc.
+F0DBF8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-74-6E   (hex)		Apple, Inc.
+48746E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-AE-27   (hex)		Apple, Inc.
+54AE27     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-E9-98   (hex)		Apple, Inc.
+FCE998     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-BC-9F   (hex)		Apple, Inc.
+0CBC9F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-36-3B   (hex)		Apple, Inc.
+34363B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-A6-37   (hex)		Apple, Inc.
+D0A637     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-9F-70   (hex)		Apple, Inc.
+789F70     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-F3-87   (hex)		Apple, Inc.
+9CF387     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-5B-78   (hex)		Apple, Inc.
+A85B78     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-F6-50   (hex)		Apple, Inc.
+C8F650     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-8E-24   (hex)		Apple, Inc.
+A88E24     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-4A-39   (hex)		BITA
+6C4A39     (base 16)		BITA
+				6/F, New Century Hotel Office Tower
+				  BEI JING  100044
+				CN
+
+84-7D-50   (hex)		Holley Metering Limited
+847D50     (base 16)		Holley Metering Limited
+				181 Wuchang Avenue
+				Hangzhou  Zhejiang  310023
+				CN
+
+50-D5-9C   (hex)		Thai Habel Industrial Co., Ltd.
+50D59C     (base 16)		Thai Habel Industrial Co., Ltd.
+				3/1 - 3/3 RAMA 3 RD,
+				ฺBangkholaem  Bangkok  10120
+				TH
+
+20-89-6F   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+20896F     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+30-52-CB   (hex)		Liteon Technology Corporation
+3052CB     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+04-96-45   (hex)		WUXI SKY CHIP INTERCONNECTION TECHNOLOGY CO.,LTD.
+049645     (base 16)		WUXI SKY CHIP INTERCONNECTION TECHNOLOGY CO.,LTD.
+				Building F12, China Sensor Network International Innovation park,200# Linghu Avenue,Wuxi.
+				WUXI  Jiangsu  214135
+				CN
+
+1C-CD-E5   (hex)		Shanghai Wind Technologies Co.,Ltd
+1CCDE5     (base 16)		Shanghai Wind Technologies Co.,Ltd
+				Room 208,Section A, Building 3#, No.7 GuiQing Road, Xuhui District, Shanghai, China(Headquarter)
+				Shanghai  Shanghai  200233
+				CN
+
+68-14-01   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+681401     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+50-A9-DE   (hex)		Smartcom - Bulgaria AD
+50A9DE     (base 16)		Smartcom - Bulgaria AD
+				BIC IZOT, Building 1, Floor 3, Office 317
+				Sofia  Sofia  1784
+				BG
+
+AC-1F-D7   (hex)		Real Vision Technology Co.,Ltd.
+AC1FD7     (base 16)		Real Vision Technology Co.,Ltd.
+				A-805, 537, Dunchon-daero, Jungwon-gu
+				Seongnam-si  Gyeonggi-do  13216
+				KR
+
+88-C2-42   (hex)		Poynt Co.
+88C242     (base 16)		Poynt Co.
+				490 S. California Avenue
+				Palo Alto  California  94306
+				US
+
+14-02-EC   (hex)		Hewlett Packard Enterprise
+1402EC     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+E0-34-E4   (hex)		Feit Electric Company, Inc.
+E034E4     (base 16)		Feit Electric Company, Inc.
+				4901 Gregg Road
+				Pico Rivera  CA  90660
+				US
+
+34-C9-F0   (hex)		LM Technologies Ltd
+34C9F0     (base 16)		LM Technologies Ltd
+				Unit 19 Spectrum House
+				London  England  NW5 1LP
+				GB
+
+68-A8-28   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+68A828     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-20-E8   (hex)		Apple, Inc.
+CC20E8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-BF-74   (hex)		Baicells Technologies Co.,LTD
+48BF74     (base 16)		Baicells Technologies Co.,LTD
+				10F,Dinghao Electronics Plaza-B,No.3 Haidian St.,Haidian Dist.,Beijing,China
+				Beijing  Beijing  10080
+				CN
+
+6C-93-54   (hex)		Yaojin Technology (Shenzhen) Co., LTD.
+6C9354     (base 16)		Yaojin Technology (Shenzhen) Co., LTD.
+				 No.18,Zhulong Tian Road,Shuitian No.4 Industrial Area,Shiyan Street, Baoan District,Shenzhen,China
+				Shenzhen  Guangdong  518108
+				CN
+
+DC-DC-07   (hex)		TRP Systems BV
+DCDC07     (base 16)		TRP Systems BV
+				Televisieweg 159 1322 BH  Almere
+				Almere  -  -
+				NL
+
+38-91-D5   (hex)		Hangzhou H3C Technologies Co., Limited
+3891D5     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+8C-E2-DA   (hex)		Circle Media Inc
+8CE2DA     (base 16)		Circle Media Inc
+				1319 SE Martin Luther King Jr. Blvd.
+				Portland  Oregon  97214
+				US
+
+38-21-87   (hex)		Midea Group Co., Ltd.
+382187     (base 16)		Midea Group Co., Ltd.
+				No. 6 Midea Avenue,
+				Foshan  Guangdong  528311
+				CN
+
+78-D6-B2   (hex)		Toshiba
+78D6B2     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+E8-DE-D6   (hex)		Intrising Networks, Inc.
+E8DED6     (base 16)		Intrising Networks, Inc.
+				8F., No.67, Shitan Rd., Neihu Dist., Taipei City 11469
+				Taipei    
+				TW
+
+DC-82-F6   (hex)		iPort
+DC82F6     (base 16)		iPort
+				236 Calle Pintoresco
+				San Clemente  CA  92672
+				US
+
+70-48-0F   (hex)		Apple, Inc.
+70480F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-B7-2B   (hex)		PLUMgrid Inc
+3CB72B     (base 16)		PLUMgrid Inc
+				5155 OLD IRONSIDES DR
+				Santa Clara  CA  95054
+				US
+
+48-9A-42   (hex)		Technomate Ltd
+489A42     (base 16)		Technomate Ltd
+				Unit 11 Nobel Road
+				London    N18 3BH
+				GB
+
+20-D1-60   (hex)		Private
+20D160     (base 16)		Private
+
+BC-9C-31   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC9C31     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D8-8B-4C   (hex)		KingTing Tech.
+D88B4C     (base 16)		KingTing Tech.
+				8 Holly St
+				Irvine  California  92612
+				US
+
+38-4C-90   (hex)		ARRIS Group, Inc.
+384C90     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F0-B0-E7   (hex)		Apple, Inc.
+F0B0E7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-1C-23   (hex)		Hilan Technology CO.,LTD
+381C23     (base 16)		Hilan Technology CO.,LTD
+				604,Block 1,Kai Da Er Building,No.168 TongSha Road,XiLi Town,Nanshan,Shenzhen,P.R.C
+				Shenzhen  Guandong  518055
+				CN
+
+64-9A-12   (hex)		P2 Mobile Technologies Limited
+649A12     (base 16)		P2 Mobile Technologies Limited
+				Unit 708, 7/F, Bio-Informatics Centre, No.2 Science Park West Avenue,
+				Hong Kong  Hong Kong  00000
+				HK
+
+AC-89-95   (hex)		AzureWave Technology Inc.
+AC8995     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+04-69-F8   (hex)		Apple, Inc.
+0469F8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-29-BE   (hex)		Shanghai MRDcom Co.,Ltd
+3029BE     (base 16)		Shanghai MRDcom Co.,Ltd
+				NO.123 JULI RD
+				SHANGHAI  PUDONG ZHANGJIANG HIGH-TECH PARK  201203
+				CN
+
+20-C3-A4   (hex)		RetailNext
+20C3A4     (base 16)		RetailNext
+				60 S. Market St, 10th Floor
+				San Jose  CA  95113
+				US
+
+E4-C2-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4C2D1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-F4-BE   (hex)		Palo Alto Networks
+D4F4BE     (base 16)		Palo Alto Networks
+				4401 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+48-B6-20   (hex)		ROLI Ltd.
+48B620     (base 16)		ROLI Ltd.
+				2 Glebe Road
+				London    E8 4BD
+				GB
+
+D8-88-CE   (hex)		RF Technology Pty Ltd
+D888CE     (base 16)		RF Technology Pty Ltd
+				46/7 Sefton Rd
+				Thornleigh  NSW  2120
+				AU
+
+30-7C-B2   (hex)		ANOV FRANCE
+307CB2     (base 16)		ANOV FRANCE
+				100 CHEMIN DE BAILLOT
+				MONTAUBAN  TARN ET GARONNE  82000
+				FR
+
+84-79-73   (hex)		Shanghai Baud Data Communication Co.,Ltd.
+847973     (base 16)		Shanghai Baud Data Communication Co.,Ltd.
+				NO.123 JULI RD
+				PUDONG ZHANGJIANG HIGH-TECH PARK  SHANGHAI  201203
+				CN
+
+E8-B4-C8   (hex)		Samsung Electronics Co.,Ltd
+E8B4C8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-87-E2   (hex)		Samsung Electronics Co.,Ltd
+D087E2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-5B-7B   (hex)		Samsung Electronics Co.,Ltd
+F05B7B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-47-BF   (hex)		Samsung Electronics Co.,Ltd
+B047BF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-0B-C6   (hex)		Samsung Electronics Co.,Ltd
+7C0BC6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-FE-90   (hex)		Mellanox Technologies, Inc.
+7CFE90     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+84-5B-12   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+845B12     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-55-31   (hex)		Samsung Electronics Co.,Ltd
+205531     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-86-8C   (hex)		ARRIS Group, Inc.
+10868C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-FD-A3   (hex)		Everysight LTD.
+44FDA3     (base 16)		Everysight LTD.
+				Advanced Technology Center P.O.B 539
+				Haifa  Haifa  31053
+				IL
+
+A8-A7-95   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+A8A795     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+90-6F-A9   (hex)		NANJING PUTIAN TELECOMMUNICATIONS TECHNOLOGY CO.,LTD.
+906FA9     (base 16)		NANJING PUTIAN TELECOMMUNICATIONS TECHNOLOGY CO.,LTD.
+				No.1 Putian Road,Yuhuamenwai,Nanjing
+				Nan Jing  Jiang Su  210022
+				CN
+
+60-FD-56   (hex)		WOORISYSTEMS CO., Ltd
+60FD56     (base 16)		WOORISYSTEMS CO., Ltd
+				357-4, Neungpyeong-ri, Opo-eup
+				Gwangjiu-si  Gyeonggi-do  464-921
+				KR
+
+98-70-E8   (hex)		INNATECH SDN BHD
+9870E8     (base 16)		INNATECH SDN BHD
+				2, JALAN TIARA 3, TIARA SQUARE
+				SUBANG JAYA  SELANGOR  47600
+				MY
+
+44-65-6A   (hex)		Mega Video Electronic(HK) Industry Co., Ltd
+44656A     (base 16)		Mega Video Electronic(HK) Industry Co., Ltd
+				Room 503, No.43 Fushun Street, Huanghai West Road,
+				Dalian  Liaoning  116600
+				CN
+
+78-EB-39   (hex)		Instituto Nacional de Tecnología Industrial
+78EB39     (base 16)		Instituto Nacional de Tecnología Industrial
+				Av. Gral. Paz 5445
+				San Martín  Buenos Aires  1650
+				AR
+
+0C-75-6C   (hex)		Anaren Microwave, Inc.
+0C756C     (base 16)		Anaren Microwave, Inc.
+				6635 Kirkville Road
+				East Syracuse  NY  13057
+				US
+
+D4-7B-B0   (hex)		ASKEY COMPUTER CORP
+D47BB0     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+F0-22-4E   (hex)		Esan electronic co.
+F0224E     (base 16)		Esan electronic co.
+				D&I Building 2nd floor
+				Gun-Po  Kyunggido  435-862
+				KR
+
+CC-5F-BF   (hex)		Topwise 3G Communication Co., Ltd.
+CC5FBF     (base 16)		Topwise 3G Communication Co., Ltd.
+				6 Floor, A8 Music Building, Keyuan Road, High-Tech Park, Nanshan District, Shenzhen, China
+				Shenzhen  Guangdong  518000
+				CN
+
+C8-F9-C8   (hex)		NewSharp Technology(SuZhou)Co,Ltd
+C8F9C8     (base 16)		NewSharp Technology(SuZhou)Co,Ltd
+				1st/f.building 7th No.328 XingHu street SuZhou City
+				SuZhou City  JiangSu Province  215123
+				CN
+
+80-C5-E6   (hex)		Microsoft Corporation
+80C5E6     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+10-DF-8B   (hex)		Shenzhen CareDear Communication Technology Co.,Ltd
+10DF8B     (base 16)		Shenzhen CareDear Communication Technology Co.,Ltd
+				No.605,6th floor, 1st Section, 25th Building, Science and Technology Park Industrial Zone, median space, High-tech Zone
+				ShenZhen  Guangdong  518000
+				CN
+
+C4-12-F5   (hex)		D-Link International
+C412F5     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+5C-45-27   (hex)		Juniper Networks
+5C4527     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+E0-2C-B2   (hex)		Lenovo Mobile Communication (Wuhan) Company Limited
+E02CB2     (base 16)		Lenovo Mobile Communication (Wuhan) Company Limited
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan, China  430205
+				Wuhan  Hubei  430205
+				CN
+
+60-6D-C7   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+606DC7     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+68-ED-A4   (hex)		Shenzhen Seavo Technology Co.,Ltd
+68EDA4     (base 16)		Shenzhen Seavo Technology Co.,Ltd
+				5H,West Building,NO.210,Terra Hi-Tech Industrial Park,
+				Shenzhen  Guangdong  518040
+				CN
+
+2C-C5-D3   (hex)		Ruckus Wireless
+2CC5D3     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+F4-57-3E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F4573E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D0-43-1E   (hex)		Dell Inc.
+D0431E     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+54-CD-10   (hex)		Panasonic Mobile Communications Co.,Ltd.
+54CD10     (base 16)		Panasonic Mobile Communications Co.,Ltd.
+				600 Saedo-cho Tsuzuki-ku
+				Yokohama City  Kanagawa  224-8539
+				JP
+
+40-8D-5C   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+408D5C     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+FC-E1-FB   (hex)		Array Networks
+FCE1FB     (base 16)		Array Networks
+				1371 McCarthy Blvd
+				Milpitas  California  95035
+				US
+
+E8-91-20   (hex)		Motorola Mobility LLC, a Lenovo Company
+E89120     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+D4-F9-A1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D4F9A1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-40-AD   (hex)		Samsung Electronics Co.,Ltd
+5440AD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-24-DD   (hex)		Cambrionix Ltd
+A424DD     (base 16)		Cambrionix Ltd
+				St Johns Innovation Centre
+				Cambridge  Cambridgeshire  CB4 0WS
+				GB
+
+14-5A-83   (hex)		Logi-D inc
+145A83     (base 16)		Logi-D inc
+				5550 Des Rossignol Blvd
+				Laval  Quebec  H7L 5W6
+				CA
+
+80-4E-81   (hex)		Samsung Electronics Co.,Ltd
+804E81     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-9A-71   (hex)		XIAMEN MEITU MOBILE TECHNOLOGY CO.LTD
+C09A71     (base 16)		XIAMEN MEITU MOBILE TECHNOLOGY CO.LTD
+				1-3F, Block2, No.6 Wanghai Rd,Siming District, Xiamen, Fujian, China (”MEITU”)
+				Xiamen  Fujian  361008
+				CN
+
+64-16-7F   (hex)		Polycom
+64167F     (base 16)		Polycom
+				6001 America Center Drive
+				San Jose  CA  95002
+				US
+
+34-0B-40   (hex)		MIOS ELETTRONICA SRL
+340B40     (base 16)		MIOS ELETTRONICA SRL
+				VIA ARCHIMEDE, 10
+				SAN MARTINO B.A. (VR)  VERONA  37036
+				IT
+
+48-06-6A   (hex)		Tempered Networks, Inc.
+48066A     (base 16)		Tempered Networks, Inc.
+				100 West Harrison St
+				Seattle  WA  98119
+				US
+
+BC-F8-11   (hex)		Xiamen DNAKE Technology Co.,Ltd
+BCF811     (base 16)		Xiamen DNAKE Technology Co.,Ltd
+				5F,Xingtel Building,Chuangxin Rd.
+				Xiamen  Fujian  361006
+				CN
+
+90-0A-39   (hex)		Wiio, Inc.
+900A39     (base 16)		Wiio, Inc.
+				99 S. Almaden Boulevard
+				San Jose  California  95113
+				US
+
+D0-C0-BF   (hex)		Actions Microelectronics Co., Ltd
+D0C0BF     (base 16)		Actions Microelectronics Co., Ltd
+				201, No 9 Building, Software Park,Kejizhonger Rd.,
+				Shenzhen  Gangdong  518057
+				CN
+
+E8-61-BE   (hex)		Melec Inc.
+E861BE     (base 16)		Melec Inc.
+				516-10 Higashiasakawamachi
+				Hachioji  Tokyo  193-0834
+				JP
+
+58-70-C6   (hex)		Shanghai Xiaoyi Technology Co., Ltd.
+5870C6     (base 16)		Shanghai Xiaoyi Technology Co., Ltd.
+				Shanghai Zhangjiang hi-tech park of Pudong New Area
+				Shanghai  Shanghai  201120
+				CN
+
+FC-8F-90   (hex)		Samsung Electronics Co.,Ltd
+FC8F90     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+74-04-2B   (hex)		Lenovo Mobile Communication (Wuhan) Company Limited
+74042B     (base 16)		Lenovo Mobile Communication (Wuhan) Company Limited
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan, China  430205
+				Wuhan  Hubei  430205
+				CN
+
+F8-7A-EF   (hex)		Rosonix Technology, Inc.
+F87AEF     (base 16)		Rosonix Technology, Inc.
+				10F, No.235, Sec. 4, Chengde Rd., 
+				Taipei  Taiwan  11167
+				TW
+
+20-28-BC   (hex)		Visionscape Co,. Ltd.
+2028BC     (base 16)		Visionscape Co,. Ltd.
+				503, 145, Gasan Digital 1-ro, Geumcheon-gu,
+				Seoul  Korea  153-787
+				KR
+
+24-1C-04   (hex)		SHENZHEN JEHE TECHNOLOGY DEVELOPMENT CO., LTD.
+241C04     (base 16)		SHENZHEN JEHE TECHNOLOGY DEVELOPMENT CO., LTD.
+				2/F, Block A, Tsinghua Information Harbor, North Section
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-5C-7A   (hex)		Sartura d.o.o.
+D05C7A     (base 16)		Sartura d.o.o.
+				Kuniscak 28
+				  Zagreb  10000
+				HR
+
+BC-5C-4C   (hex)		ELECOM CO.,LTD.
+BC5C4C     (base 16)		ELECOM CO.,LTD.
+				11F Tokyubancho Bldg. 6-2,
+				Chiyoda-ku  Tokyo  102-0081
+				JP
+
+88-70-33   (hex)		Hangzhou Silan Microelectronic Inc
+887033     (base 16)		Hangzhou Silan Microelectronic Inc
+				No.4 HuangGuShan Road
+				Hangzhou  Zhejiang  310012
+				CN
+
+DC-56-E6   (hex)		Shenzhen Bococom Technology Co.,LTD
+DC56E6     (base 16)		Shenzhen Bococom Technology Co.,LTD
+				303, Dongjiang Environmental Build, LangShan Road.
+				Shenzhen  Guangdong  518000
+				CN
+
+CC-96-35   (hex)		LVS Co.,Ltd.
+CC9635     (base 16)		LVS Co.,Ltd.
+				SmartValley B # 801
+				Incheon    406-840
+				KR
+
+44-80-EB   (hex)		Motorola Mobility LLC, a Lenovo Company
+4480EB     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+40-28-14   (hex)		RFI Engineering
+402814     (base 16)		RFI Engineering
+				Markerkant 13-76
+				Almere  Flevoland  1314AN
+				NL
+
+14-41-46   (hex)		Honeywell (China) Co., LTD
+144146     (base 16)		Honeywell (China) Co., LTD
+				No. 100, Zunyi Road, Changning District
+				Shanghai  Shanghai  200051
+				CN
+
+94-F1-9E   (hex)		HUIZHOU MAORONG INTELLIGENT TECHNOLOGY CO.,LTD
+94F19E     (base 16)		HUIZHOU MAORONG INTELLIGENT TECHNOLOGY CO.,LTD
+				China Guangdong Huizhou
+				Huizhou  Guangdong  516000
+				CN
+
+B8-56-BD   (hex)		ITT LLC
+B856BD     (base 16)		ITT LLC
+				1-ya Brestkaya St, building 35
+				  Moscow  125047
+				RU
+
+40-A5-EF   (hex)		Shenzhen Four Seas Global Link Network Technology Co., Ltd.
+40A5EF     (base 16)		Shenzhen Four Seas Global Link Network Technology Co., Ltd.
+				Room 607-610, Block B, TAOJINDI Electronic Business Incubation Base
+				Tenglong Road, Longhua District,   Shenzhen Guangdong  518000
+				CN
+
+C4-92-4C   (hex)		KEISOKUKI CENTER CO.,LTD.
+C4924C     (base 16)		KEISOKUKI CENTER CO.,LTD.
+				2-6-7 SAKANE
+				KAWANISHI-CITY  HYOGO  666-0021
+				JP
+
+74-9C-E3   (hex)		KodaCloud Canada, Inc
+749CE3     (base 16)		KodaCloud Canada, Inc
+				Suite 310
+				Ottawa  Ontario  K2K3G4
+				CA
+
+D4-55-56   (hex)		Fiber Mountain Inc.
+D45556     (base 16)		Fiber Mountain Inc.
+				700 W Johnson Ave
+				Cheshire  CT  06410
+				US
+
+50-50-2A   (hex)		Egardia
+50502A     (base 16)		Egardia
+				Kleine Landtong 19
+				Gorinchem  Zuid Holland  4201 HL
+				NL
+
+74-96-37   (hex)		Todaair Electronic Co., Ltd
+749637     (base 16)		Todaair Electronic Co., Ltd
+				F.6 Electronic Building, No.1 Shuinan Guangdeli Road，Peng’Jiang District, Jiangmen, Guangdong, China
+				JiangMen  Guangdong  529000
+				CN
+
+88-E6-03   (hex)		Avotek corporation
+88E603     (base 16)		Avotek corporation
+				9-17, Dongil-ro 174-gil, Nowon-gu, Seoul
+				Seoul  Seoul  139-808
+				KR
+
+2C-AD-13   (hex)		SHENZHEN ZHILU TECHNOLOGY CO.,LTD
+2CAD13     (base 16)		SHENZHEN ZHILU TECHNOLOGY CO.,LTD
+				B2-402 Kexin Science Park, Keyuan Road, Hi-tech Park, Nanshan District, Shenzhen
+				shenzhen  Guangdong  518052
+				CN
+
+78-AC-BF   (hex)		Igneous Systems
+78ACBF     (base 16)		Igneous Systems
+				2401 4th Ave
+				Seattle  WA  98121
+				US
+
+C4-8E-8F   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C48E8F     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C4-36-6C   (hex)		LG Innotek
+C4366C     (base 16)		LG Innotek
+				Jangduk-dong 978-1
+				Gwang-ju  Gwangsan-gu  506-731
+				KR
+
+54-36-9B   (hex)		1Verge Internet Technology (Beijing) Co., Ltd.
+54369B     (base 16)		1Verge Internet Technology (Beijing) Co., Ltd.
+				5th Floor, Sinosteel International Plaza
+				Haidian District  Beijing  
+				CN
+
+40-D2-8A   (hex)		Nintendo Co., Ltd.
+40D28A     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+40-62-B6   (hex)		Tele system communication
+4062B6     (base 16)		Tele system communication
+				5F, No.437, Tao Ying Rd
+				Taoyuan    33068
+				TW
+
+60-12-8B   (hex)		CANON INC.
+60128B     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+84-C3-E8   (hex)		Vaillant GmbH
+84C3E8     (base 16)		Vaillant GmbH
+				Berghauser Straße 40
+				Remscheid  NRW  D-42859
+				DE
+
+9C-D3-5B   (hex)		Samsung Electronics Co.,Ltd
+9CD35B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-9F-BA   (hex)		Samsung Electronics Co.,Ltd
+A89FBA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-8E-C6   (hex)		Stateless Networks
+B88EC6     (base 16)		Stateless Networks
+				388 Market Street
+				San Francisco  CA  94111
+				US
+
+BC-D1-65   (hex)		Cisco SPVTG
+BCD165     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+28-E4-76   (hex)		Pi-Coral
+28E476     (base 16)		Pi-Coral
+				2130 Gold Street, Ste. 200
+				San Jose  CA - California  95002
+				US
+
+4C-A5-15   (hex)		Baikal Electronics JSC
+4CA515     (base 16)		Baikal Electronics JSC
+				Highway Baltic 26 km, BC 'RigaLand, Block B, 3-rd entrance, 2-nd floor.
+				Krasnogorsk district  Moscow region  143421
+				RU
+
+7C-3C-B6   (hex)		Shenzhen Homecare Technology Co.,Ltd.
+7C3CB6     (base 16)		Shenzhen Homecare Technology Co.,Ltd.
+				Homecare Industrial Zone,NO.30,Langdong road,Yangchuan,Songgang Town,Bao'an Distric ,
+				Shenzhen  Guangdong  5108105
+				CN
+
+1C-7D-22   (hex)		Fuji Xerox Co., Ltd.
+1C7D22     (base 16)		Fuji Xerox Co., Ltd.
+				6-1 Minatomirai, Nishi-ku
+				Yokohama  Kanagawa  220-8668
+				JP
+
+20-C0-6D   (hex)		SHENZHEN SPACETEK TECHNOLOGY CO.,LTD
+20C06D     (base 16)		SHENZHEN SPACETEK TECHNOLOGY CO.,LTD
+				3F, NO.2, ChaXiSanWei Industrial Park, Gushu Community, XiXiang Street, BaoAn District
+				ShenZhen  GuangDong  518100
+				
+
+48-86-E8   (hex)		Microsoft Corporation
+4886E8     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+74-A3-4A   (hex)		ZIMI CORPORATION
+74A34A     (base 16)		ZIMI CORPORATION
+				Room A913, 159 Chengjiang Road, Jiangyin City, Jiangsu Province, P, R.China
+				    214400
+				CN
+
+A8-64-05   (hex)		nimbus 9, Inc
+A86405     (base 16)		nimbus 9, Inc
+				29 W. Cimarron St.
+				Colorado Springs  CO  80903
+				US
+
+30-D5-87   (hex)		Samsung Electronics Co.,Ltd
+30D587     (base 16)		Samsung Electronics Co.,Ltd
+				#416, Maetan 3-dong
+				Suwon-si  Gyeonggi-do  443-742
+				KR
+
+68-28-F6   (hex)		Vubiq Networks, Inc.
+6828F6     (base 16)		Vubiq Networks, Inc.
+				9231 Irvine Blvd.
+				Irvine  California  92618
+				US
+
+DC-60-A1   (hex)		Teledyne DALSA Professional Imaging
+DC60A1     (base 16)		Teledyne DALSA Professional Imaging
+				High Tech Campus 27
+				Eindhoven  NB  5656 AE
+				NL
+
+10-A6-59   (hex)		Mobile Create Co.,Ltd.
+10A659     (base 16)		Mobile Create Co.,Ltd.
+				Kakukita 2-20-8
+				Oita    870-0848
+				JP
+
+58-85-6E   (hex)		QSC AG
+58856E     (base 16)		QSC AG
+				Mathias-Brueggen-Str. 55
+				Köln    50829
+				DE
+
+8C-91-09   (hex)		Toyoshima Electric Technoeogy(Suzhou) Co.,Ltd.
+8C9109     (base 16)		Toyoshima Electric Technoeogy(Suzhou) Co.,Ltd.
+				No.399,Baisheng Road,Jinxi Town
+				Kunshan  Jiangsu  215324
+				CN
+
+54-09-8D   (hex)		deister electronic GmbH
+54098D     (base 16)		deister electronic GmbH
+				Hermann-Bahlsen-Str. 11
+				Barsinghausen  Niedersachsen  30890
+				DE
+
+D0-5B-A8   (hex)		zte corporation
+D05BA8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E4-BA-D9   (hex)		360 Fly Inc.
+E4BAD9     (base 16)		360 Fly Inc.
+				1000 Town Center Blvd
+				Canonsburg  PA  15317
+				US
+
+EC-59-E7   (hex)		Microsoft Corporation
+EC59E7     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+C0-35-C5   (hex)		Prosoft Systems LTD
+C035C5     (base 16)		Prosoft Systems LTD
+				Volgogradskaya 194-a
+				Ekaterinburg  Sverdlovskay  620102
+				RU
+
+A0-A3-E2   (hex)		Actiontec Electronics, Inc
+A0A3E2     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+74-54-7D   (hex)		Cisco SPVTG
+74547D     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-E6-E8   (hex)		Netzin Technology Corporation,.Ltd.
+00E6E8     (base 16)		Netzin Technology Corporation,.Ltd.
+				4F-17, No. 26, Lane 321, Yang-Kuang St.,Neihu District, Taipei, Taiwan,
+				Taiwan Taipei  Taiwan Taipei  11491
+				TW
+
+50-F4-3C   (hex)		Leeo Inc
+50F43C     (base 16)		Leeo Inc
+				989 Comercial St
+				Palo Alto  CA  94303
+				US
+
+E8-87-A3   (hex)		Loxley Public Company Limited
+E887A3     (base 16)		Loxley Public Company Limited
+				102 Na Ranong Road, Klongtoey,
+				  Bangkok  10110
+				TH
+
+10-C6-7E   (hex)		SHENZHEN JUCHIN TECHNOLOGY CO., LTD
+10C67E     (base 16)		SHENZHEN JUCHIN TECHNOLOGY CO., LTD
+				Unit 423 4/B NO.1, Central Business District
+				Shenzhen  Guangdong  518000
+				CN
+
+08-A5-C8   (hex)		Sunnovo International Limited
+08A5C8     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+F8-84-79   (hex)		Yaojin Technology(Shenzhen)Co.,Ltd
+F88479     (base 16)		Yaojin Technology(Shenzhen)Co.,Ltd
+				Yaojin Park, Shui Tian No.4 Industrial Area ShiYan Tow,
+				SHENZHEN  GUANGDONG  518108
+				CN
+
+2C-29-97   (hex)		Microsoft Corporation
+2C2997     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+D4-61-32   (hex)		Pro Concept Manufacturer Co.,Ltd.
+D46132     (base 16)		Pro Concept Manufacturer Co.,Ltd.
+				88/1 Moo12 Soi Phetkasem120
+				Kratumbaen  Samutsakorn  74130
+				TH
+
+54-A0-50   (hex)		ASUSTek COMPUTER INC.
+54A050     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+4C-2C-83   (hex)		Zhejiang KaNong Network Technology Co.,Ltd.
+4C2C83     (base 16)		Zhejiang KaNong Network Technology Co.,Ltd.
+				Room 633, Building B, ShunFan Technology Park,JingChang Road No.768, YuHang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+90-8C-09   (hex)		Total Phase
+908C09     (base 16)		Total Phase
+				735 Palomar Ave
+				Sunnyvale  CA  94085
+				US
+
+DC-2F-03   (hex)		Step forward Group Co., Ltd.
+DC2F03     (base 16)		Step forward Group Co., Ltd.
+				1/3 Park Village Rama2 Floor 2   C2-2
+				Bangkok  Bangkok  10150
+				TH
+
+38-0E-7B   (hex)		V.P.S. Thai Co., Ltd
+380E7B     (base 16)		V.P.S. Thai Co., Ltd
+				279-281 Mangkorn Rd., Pomprab District
+				Bangkok  Bangkok  10100
+				TH
+
+2C-37-96   (hex)		CYBO CO.,LTD.
+2C3796     (base 16)		CYBO CO.,LTD.
+				218 MOO 3 LAEM CHA BANG
+				SRIRACHA  CHONBURI  20230
+				TH
+
+58-7F-B7   (hex)		SONAR INDUSTRIAL CO., LTD.
+587FB7     (base 16)		SONAR INDUSTRIAL CO., LTD.
+				29, 29/1, 29/2, MOO.3, THATALAD,
+				SAMPRAN  NAKORN PATHOM  73110
+				TH
+
+08-EB-29   (hex)		Jiangsu Huitong Group Co.,Ltd.
+08EB29     (base 16)		Jiangsu Huitong Group Co.,Ltd.
+				No. 24, Block 2, Taohuawu New District
+				Zhenjiang  Jiangsu  212003
+				CN
+
+40-9B-0D   (hex)		Shenzhen Yourf Kwan Industrial Co., Ltd
+409B0D     (base 16)		Shenzhen Yourf Kwan Industrial Co., Ltd
+				MCN Edifice 5D, R1 Building, No.21 4th Hi-tech Road South, High-tech Industrial Park(south)
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-CB-8A   (hex)		Micro-Star INTL CO., LTD.
+D8CB8A     (base 16)		Micro-Star INTL CO., LTD.
+				No.69, Lide St.,
+				New Taipei City  Taiwan  235
+				TW
+
+70-FC-8C   (hex)		OneAccess SA
+70FC8C     (base 16)		OneAccess SA
+				381 avenue du général de Gaulle
+				CLAMART   France  92140
+				FR
+
+58-10-8C   (hex)		Intelbras
+58108C     (base 16)		Intelbras
+				BR 101, km 210, S/N°
+				São José  Santa Catarina  88104800
+				BR
+
+4C-74-03   (hex)		BQ
+4C7403     (base 16)		BQ
+				c Sofía 10. Polígono Európolis
+				Las Rozas de Madrid  Madrid  28230
+				ES
+
+8C-5D-60   (hex)		UCI Corporation Co.,Ltd.
+8C5D60     (base 16)		UCI Corporation Co.,Ltd.
+				299/195-7, Chaengwattana Road,
+				Bangkok  Bangkok  10210
+				TH
+
+BC-6B-4D   (hex)		Nokia
+BC6B4D     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+C8-D0-19   (hex)		Shanghai Tigercel Communication Technology Co.,Ltd
+C8D019     (base 16)		Shanghai Tigercel Communication Technology Co.,Ltd
+				Room 805, building 1
+				  Shanghai  200235
+				CN
+
+90-21-81   (hex)		Shanghai Huaqin Telecom Technology Co.,Ltd
+902181     (base 16)		Shanghai Huaqin Telecom Technology Co.,Ltd
+				No.1 Building,399 Keyuan Road, Zhangjian Hi-Tech Park,
+				shanghai  shanghai  201203
+				CN
+
+84-96-81   (hex)		Cathay Communication Co.,Ltd
+849681     (base 16)		Cathay Communication Co.,Ltd
+				Tsinghua Institude A319 of Hi-tech Park,Nanshan district,Shenzhen China
+				Shenzhen  Canton  0755
+				CN
+
+2C-A3-0E   (hex)		POWER DRAGON DEVELOPMENT LIMITED
+2CA30E     (base 16)		POWER DRAGON DEVELOPMENT LIMITED
+				Room D, 10/F Tower A, Billion Centre, 1 Wang Kwong Road, Kowloon Bay
+				HONG KONG  HONG KONG  999077
+				CN
+
+84-86-F3   (hex)		Greenvity Communications
+8486F3     (base 16)		Greenvity Communications
+				673 S. Milpitas Blvd Suite 204
+				Milpitas  California  95035
+				US
+
+1C-52-16   (hex)		DONGGUAN HELE ELECTRONICS CO., LTD
+1C5216     (base 16)		DONGGUAN HELE ELECTRONICS CO., LTD
+				Lijiangwei Group,
+				Dongguan City  Guangdong  86
+				CN
+
+60-99-D1   (hex)		Vuzix / Lenovo
+6099D1     (base 16)		Vuzix / Lenovo
+				2166 Brighton Henrietta Town Line Road
+				Rochester  NY  14623
+				US
+
+B0-45-15   (hex)		mira fitness,LLC.
+B04515     (base 16)		mira fitness,LLC.
+				1925 West Field Court Suite100
+				Lake Forest  IL  60045
+				US
+
+14-48-8B   (hex)		Shenzhen Doov Technology Co.,Ltd
+14488B     (base 16)		Shenzhen Doov Technology Co.,Ltd
+				11st Floor,East,2nd Phase
+				 Futian District, Shenzhen  Guangdong  518040
+				CN
+
+20-12-D5   (hex)		Scientech Materials Corporation
+2012D5     (base 16)		Scientech Materials Corporation
+				No.7, Hejiang 2nd Rd., Chungli , Taoyuan Hsien 320, Taiwan
+				Taoyuan Hsien  Chungli  320
+				TW
+
+6C-6E-FE   (hex)		Core Logic Inc.
+6C6EFE     (base 16)		Core Logic Inc.
+				11th Fl., 1-B U-SPACE Bldg.
+				Seongnam  Gyeonggi-do  463-400
+				KR
+
+38-08-FD   (hex)		Silca Spa
+3808FD     (base 16)		Silca Spa
+				Via Podgora, 20 (Z.I.)
+				Vittorio Veneto  TV  31029
+				IT
+
+78-45-61   (hex)		CyberTAN Technology Inc.
+784561     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+94-CE-31   (hex)		CTS Limited
+94CE31     (base 16)		CTS Limited
+				1st district, 23D, 21
+				Moscow  -  142784
+				RU
+
+80-F8-EB   (hex)		RayTight
+80F8EB     (base 16)		RayTight
+				Room 1-216, Building 25, No 9, Anningzhuang West Road
+				Haidian District  Beijing  100085
+				CN
+
+D4-37-D7   (hex)		zte corporation
+D437D7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+2C-01-0B   (hex)		NASCENT Technology, LLC - RemKon
+2C010B     (base 16)		NASCENT Technology, LLC - RemKon
+				2744 Yorkmont Road
+				Charlotte  NC  28208
+				
+
+04-DE-DB   (hex)		Rockport Networks Inc
+04DEDB     (base 16)		Rockport Networks Inc
+				515 Legget Dr., Suite 600
+				Kanata  ON  K2K 3G4
+				CA
+
+1C-48-40   (hex)		IMS Messsysteme GmbH
+1C4840     (base 16)		IMS Messsysteme GmbH
+				Dieselstr. 55
+				Heiligenhaus  NRW  D-42579
+				DE
+
+60-50-C1   (hex)		Kinetek Sports
+6050C1     (base 16)		Kinetek Sports
+				16885 Via Del Campo Ct.
+				San Diego  Ca  92127
+				US
+
+2C-1A-31   (hex)		Electronics Company Limited
+2C1A31     (base 16)		Electronics Company Limited
+				Units 12,15&16,8/F,Metro Centre 2
+				Kowloon Bay  HongKong  852
+				CN
+
+90-B6-86   (hex)		Murata Manufacturing Co., Ltd.
+90B686     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+EC-D9-D1   (hex)		Shenzhen TG-NET Botone Technology Co.,Ltd.
+ECD9D1     (base 16)		Shenzhen TG-NET Botone Technology Co.,Ltd.
+				East F/3,No.38 Huarong Second Industry Zone
+				Shenzhen  Guangdong  518109
+				CN
+
+6C-02-73   (hex)		Shenzhen Jin Yun Video Equipment Co., Ltd.
+6C0273     (base 16)		Shenzhen Jin Yun Video Equipment Co., Ltd.
+				4th floor, 78th, Matou Road
+				Shenzhen  Guangdong  518000
+				CN
+
+54-DF-00   (hex)		Ulterius Technologies, LLC
+54DF00     (base 16)		Ulterius Technologies, LLC
+				1625 N. Waterfront Parkway
+				Wichita  KS  67206
+				US
+
+20-ED-74   (hex)		Ability enterprise co.,Ltd.
+20ED74     (base 16)		Ability enterprise co.,Ltd.
+				4F., No.8, Ln.7, Wuquan Rd, Wugu Dist, New Taipei City 24886, Taiwan(R.O.C)
+				Taipei  Taipei  24886
+				TW
+
+A0-56-B2   (hex)		Harman/Becker Automotive Systems GmbH
+A056B2     (base 16)		Harman/Becker Automotive Systems GmbH
+				Becker-Göring-Straße 16
+				Karlsbad  Baden-Württemberg  76307
+				DE
+
+44-66-6E   (hex)		IP-LINE
+44666E     (base 16)		IP-LINE
+				#204, Gangseo B/D
+				Guro-gu  Seoul  152-826
+				KR
+
+24-4F-1D   (hex)		iRule LLC
+244F1D     (base 16)		iRule LLC
+				1555 Broadway St
+				Detroit  MI  48226
+				US
+
+94-AE-E3   (hex)		Belden Hirschmann Industries (Suzhou) Ltd.
+94AEE3     (base 16)		Belden Hirschmann Industries (Suzhou) Ltd.
+				333 Yanhu Road, Huaqiao Town
+				Kunshan  Jiangsu  215332
+				CN
+
+5C-B6-CC   (hex)		NovaComm Technologies Inc.
+5CB6CC     (base 16)		NovaComm Technologies Inc.
+				902A, #560 Shengxia Rd., ZJ Inno Park
+				  Shanghai  201203
+				CN
+
+70-5B-2E   (hex)		M2Communication Inc.
+705B2E     (base 16)		M2Communication Inc.
+				Room 12, 18F., No.65, Gaotie 7th Road
+				Zhubei City  Hsinchu County  302
+				TW
+
+5C-15-15   (hex)		ADVAN
+5C1515     (base 16)		ADVAN
+				Wisma SMR.JL.Yos Sudarso Kav 89,Lt8.Suite 804,Jakarta Utara 10730
+				Jakarta  Jakarta Utara  １４３５０
+				ID
+
+D0-59-E4   (hex)		Samsung Electronics Co.,Ltd
+D059E4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-A3-64   (hex)		Samsung Electronics Co.,Ltd
+14A364     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-0A-C6   (hex)		DEXON Systems Ltd.
+B40AC6     (base 16)		DEXON Systems Ltd.
+				Baross u. 165
+				Budaors  Pest  H-2040
+				HU
+
+D8-66-EE   (hex)		BOXIN COMMUNICATION CO.,LTD.
+D866EE     (base 16)		BOXIN COMMUNICATION CO.,LTD.
+				Room 309，Block A，New materials business building
+				Haidian District  Beijing  100094
+				CN
+
+28-29-CC   (hex)		Corsa Technology Incorporated
+2829CC     (base 16)		Corsa Technology Incorporated
+				505 March Road
+				Ottawa  Ontario  K2K 3A4
+				CA
+
+18-4A-6F   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+184A6F     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+10-C3-7B   (hex)		ASUSTek COMPUTER INC.
+10C37B     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+E8-5D-6B   (hex)		Luminate Wireless
+E85D6B     (base 16)		Luminate Wireless
+				20823 Stevens Creek Blvd, Suite 300
+				Cupertino  CA  95014
+				US
+
+B4-0B-44   (hex)		Smartisan Technology Co., Ltd.
+B40B44     (base 16)		Smartisan Technology Co., Ltd.
+				7/F, Motorola Bldg., 1st Wangjing East Rd,
+				Beijing    100102
+				CN
+
+34-31-C4   (hex)		AVM GmbH
+3431C4     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+50-FE-F2   (hex)		Sify Technologies Ltd
+50FEF2     (base 16)		Sify Technologies Ltd
+				II floor, TIDEL Park,
+				chennai  Tamilnadu  600113
+				IN
+
+34-C5-D0   (hex)		Hagleitner Hygiene International GmbH
+34C5D0     (base 16)		Hagleitner Hygiene International GmbH
+				Lunastrasse 5
+				Zell am See  Salzburg  5700
+				AT
+
+A0-12-DB   (hex)		TABUCHI ELECTRIC CO.,LTD
+A012DB     (base 16)		TABUCHI ELECTRIC CO.,LTD
+				4-2-21
+				  OSAKA  532-0003
+				JP
+
+48-1A-84   (hex)		Pointer Telocation Ltd
+481A84     (base 16)		Pointer Telocation Ltd
+				14 Hamelacha Street,
+				Rosh Ha’ayin  Israel  48091
+				IL
+
+DC-66-3A   (hex)		Apacer Technology Inc.
+DC663A     (base 16)		Apacer Technology Inc.
+				1F., No.32, Zhongcheng Rd., Tucheng Dist.,
+				New Taipei City  Taiwan R.O.C.  236
+				TW
+
+08-DF-1F   (hex)		Bose Corporation
+08DF1F     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+58-1F-67   (hex)		Open-m technology limited
+581F67     (base 16)		Open-m technology limited
+				logan century buildding ,No.23 of Hai xiu road
+				Shenzhen  Guangdong  518000
+				CN
+
+48-26-E8   (hex)		Tek-Air Systems, Inc.
+4826E8     (base 16)		Tek-Air Systems, Inc.
+				41 Eagle Road
+				Danbury  CT  06810
+				US
+
+D0-5A-F1   (hex)		Shenzhen Pulier Tech CO.,Ltd
+D05AF1     (base 16)		Shenzhen Pulier Tech CO.,Ltd
+				3rd Floor, NO. B Buliding, District A, Shajing minzhu jiujiu industrial park , Shenzhen, China
+				Shenzhen  Guangdong  518104
+				CN
+
+FC-E1-86   (hex)		A3M Co., LTD
+FCE186     (base 16)		A3M Co., LTD
+				KeumJeong Highview 2F #205,
+				Gunpo  Gyeonggi  435-845
+				KR
+
+54-EF-92   (hex)		Shenzhen Elink Technology Co., LTD
+54EF92     (base 16)		Shenzhen Elink Technology Co., LTD
+				A531, Famous, No 168 Bao Yuan Road,
+				Shenzhen  Guangdong  518000
+				CN
+
+EC-E5-12   (hex)		tado GmbH
+ECE512     (base 16)		tado GmbH
+				Lindwurmstr. 76
+				Munich  Bavaria  80337
+				DE
+
+30-91-8F   (hex)		Technicolor
+30918F     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+5C-F4-AB   (hex)		Zyxel Communications Corporation
+5CF4AB     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+08-B2-A3   (hex)		Cynny Italia S.r.L.
+08B2A3     (base 16)		Cynny Italia S.r.L.
+				Via delle Mantellate, 8
+				Firenze  FI  59021
+				IT
+
+70-30-5D   (hex)		Ubiquoss Inc
+70305D     (base 16)		Ubiquoss Inc
+				8F Ubiquoss B/D, 68, Pangyo-ro 255beon-gil, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+48-82-44   (hex)		Life Fitness / Div. of Brunswick
+488244     (base 16)		Life Fitness / Div. of Brunswick
+				10601 W. Belmont Ave
+				Franklin Park  IL  60131
+				US
+
+C8-31-68   (hex)		eZEX corporation
+C83168     (base 16)		eZEX corporation
+				Rm 508, Ssangyong IT Twin-Tower II, 442-5
+				Seongnam-si  Gyeonggi-do  462-120
+				KR
+
+40-B3-CD   (hex)		Chiyoda Electronics Co.,Ltd.
+40B3CD     (base 16)		Chiyoda Electronics Co.,Ltd.
+				1-3-11 Nishiki-cho
+				Warabi  Saitama  
+				JP
+
+24-33-6C   (hex)		Private
+24336C     (base 16)		Private
+
+20-25-64   (hex)		PEGATRON CORPORATION
+202564     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+C8-D5-90   (hex)		FLIGHT DATA SYSTEMS
+C8D590     (base 16)		FLIGHT DATA SYSTEMS
+				31 MCGREGORS DRIVE
+				KEILOR PARK  VICTORIA  3042
+				AU
+
+7C-FF-62   (hex)		Huizhou Super Electron Technology Co.,Ltd.
+7CFF62     (base 16)		Huizhou Super Electron Technology Co.,Ltd.
+				10F,Financial Tower,No.23,Xiapu Road
+				Huizhou City  Guangdong Province  516001
+				CN
+
+84-B5-9C   (hex)		Juniper Networks
+84B59C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C0-9D-26   (hex)		Topicon HK Lmd.
+C09D26     (base 16)		Topicon HK Lmd.
+				302, 3F, Lee Loong Building
+				Central  Hong Kong  0000
+				US
+
+44-29-38   (hex)		NietZsche enterprise Co.Ltd.
+442938     (base 16)		NietZsche enterprise Co.Ltd.
+				4F. No.560 Sec2 Chung Shan Rd.
+				New Taipei City Taiwan R.O.C  Taipei ( 臺 北 縣 / 市 )  220
+				TW
+
+A0-DA-92   (hex)		Nanjing Glarun Atten Technology Co. Ltd.
+A0DA92     (base 16)		Nanjing Glarun Atten Technology Co. Ltd.
+				Dinghuai men No. 1, Gulou District
+				    
+				CN
+
+EC-F7-2B   (hex)		HD DIGITAL TECH CO., LTD.
+ECF72B     (base 16)		HD DIGITAL TECH CO., LTD.
+				Room 602, Baoyuan road, Banan District
+				Shenzhen  Guangdong  518102
+				US
+
+4C-F4-5B   (hex)		Blue Clover Devices
+4CF45B     (base 16)		Blue Clover Devices
+				1001 Bayhill Dr
+				San Bruno  CA  94066
+				US
+
+B0-69-71   (hex)		DEI Sales, Inc.
+B06971     (base 16)		DEI Sales, Inc.
+				1 Viper Way
+				Vista  CA  92081
+				US
+
+18-89-DF   (hex)		CerebrEX Inc.
+1889DF     (base 16)		CerebrEX Inc.
+				Central Shin-Osaka Building 10F
+				Osaka  Osaka  532-0003
+				JP
+
+54-C8-0F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+54C80F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-D3-32   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+E4D332     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+0C-20-26   (hex)		noax Technologies AG
+0C2026     (base 16)		noax Technologies AG
+				Am Forst 6
+				Ebersberg    85560
+				DE
+
+28-3B-96   (hex)		Cool Control LTD
+283B96     (base 16)		Cool Control LTD
+				Mivtahim 2
+				Petah Tikva  Israel  4951774
+				IL
+
+64-8D-9E   (hex)		IVT Electronic Co.,Ltd
+648D9E     (base 16)		IVT Electronic Co.,Ltd
+				F building Dongxing Insdustrial Area
+				Dongguan City  Guangdong provice  523457
+				CN
+
+CC-95-D7   (hex)		Vizio, Inc
+CC95D7     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+FC-09-F6   (hex)		GUANGDONG TONZE ELECTRIC CO.,LTD
+FC09F6     (base 16)		GUANGDONG TONZE ELECTRIC CO.,LTD
+				No.12-12 Block,Jinyuan Industrical City,Chaoshan Road,Shantou,Guangdong,china
+				Shantou  Guangdong  515021
+				CN
+
+BC-F6-1C   (hex)		Geomodeling Wuxi Technology Co. Ltd.
+BCF61C     (base 16)		Geomodeling Wuxi Technology Co. Ltd.
+				Room1708, 17/F, North Star Times Tower, No.8 BeiChen East Road
+				  Beijing  100101
+				CN
+
+FC-92-3B   (hex)		Nokia Corporation
+FC923B     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+E0-3F-49   (hex)		ASUSTek COMPUTER INC.
+E03F49     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+88-A7-3C   (hex)		Ragentek Technology Group
+88A73C     (base 16)		Ragentek Technology Group
+				D10/D11, No.3188, Xiupu Road
+				  Shanghai  201315
+				CN
+
+88-D9-62   (hex)		Canopus Systems US LLC
+88D962     (base 16)		Canopus Systems US LLC
+				Nasa Ames Research Park
+				Moffett Field  CALIFORNIA  94035
+				US
+
+D0-9C-30   (hex)		Foster Electric Company, Limited
+D09C30     (base 16)		Foster Electric Company, Limited
+				1-1-109, Tsutsujigaoka
+				Akishima  Tokyo  196-8550
+				JP
+
+94-9F-3F   (hex)		Optek Digital Technology company limited
+949F3F     (base 16)		Optek Digital Technology company limited
+				Room508 Build A, Shennan Garden, Shenzhen Science and Industry Park, Nanshan
+				Shenzhen  GuangDong  518057
+				CN
+
+E8-17-FC   (hex)		Fujitsu Cloud Technologies Limited
+E817FC     (base 16)		Fujitsu Cloud Technologies Limited
+				Shinjuku Front Tower 21-1
+				 Kita-shinjuku 2-chome   Shinjuku-ku, Tokyo   169-0074
+				JP
+
+78-FE-E2   (hex)		Shanghai Diveo Technology Co., Ltd
+78FEE2     (base 16)		Shanghai Diveo Technology Co., Ltd
+				No.8,Lane 777,LongWu Rd
+				  Shanghai  200232
+				CN
+
+08-6D-F2   (hex)		Shenzhen MIMOWAVE Technology Co.,Ltd
+086DF2     (base 16)		Shenzhen MIMOWAVE Technology Co.,Ltd
+				
+				Shenzhen  Guangdong  518172
+				CN
+
+68-78-48   (hex)		Westunitis Co., Ltd.
+687848     (base 16)		Westunitis Co., Ltd.
+				North Building 7F, 3-1 Ofuka-cho, Kita-ku
+				Osaka-city  Osaka-pref  5300011
+				JP
+
+48-D0-CF   (hex)		Universal Electronics, Inc.
+48D0CF     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+9C-3E-AA   (hex)		EnvyLogic Co.,Ltd.
+9C3EAA     (base 16)		EnvyLogic Co.,Ltd.
+				#605,Gwanyang Doosan Ven Digm B/D
+				Anyang-si  Gyeonggi-do  431-810
+				KR
+
+1C-FC-BB   (hex)		Realfiction ApS
+1CFCBB     (base 16)		Realfiction ApS
+				Oester Alle 42, 5
+				Copenhagen  OE  2100
+				DK
+
+F8-F0-05   (hex)		Newport Media Inc.
+F8F005     (base 16)		Newport Media Inc.
+				1 Spectrum Pointe Drive Suite 225
+				Lake Forest  CA  92630
+				US
+
+28-65-6B   (hex)		Keystone Microtech Corporation
+28656B     (base 16)		Keystone Microtech Corporation
+				9F., No.255, Dong Sec. 1,
+				Jhubei City, Hsinchu County    302
+				TW
+
+CC-9F-35   (hex)		Transbit Sp. z o.o.
+CC9F35     (base 16)		Transbit Sp. z o.o.
+				Przyczolkowa 109A
+				Warsaw     02-968
+				PL
+
+DC-C7-93   (hex)		Nokia Corporation
+DCC793     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+44-48-91   (hex)		HDMI Licensing, LLC
+444891     (base 16)		HDMI Licensing, LLC
+				1140 East Arques, Suite 100
+				Sunnyvale  CA  94085
+				US
+
+5C-25-4C   (hex)		Avire Global Pte Ltd
+5C254C     (base 16)		Avire Global Pte Ltd
+				8 Admiralty Street
+				Singapore    757438
+				SG
+
+D4-2F-23   (hex)		Akenori PTE Ltd
+D42F23     (base 16)		Akenori PTE Ltd
+				176 Joo Chiat Road, #02-02
+				Singapore    427447
+				SG
+
+98-C0-EB   (hex)		Global Regency Ltd
+98C0EB     (base 16)		Global Regency Ltd
+				20F, Phase A, Wenjin Plaza,
+				Shen Zhen  Guangdong  518000
+				CN
+
+F0-3F-F8   (hex)		R L Drake
+F03FF8     (base 16)		R L Drake
+				1 Jake Brown Road
+				Old Bridge  NJ  08857
+				US
+
+B0-C5-54   (hex)		D-Link International
+B0C554     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+48-EE-86   (hex)		UTStarcom (China) Co.,Ltd
+48EE86     (base 16)		UTStarcom (China) Co.,Ltd
+				25 Floor,A Block,1#Building,TianZuo International Center,
+				Haidian District  BeiJing  100081
+				CN
+
+88-89-14   (hex)		All Components Incorporated
+888914     (base 16)		All Components Incorporated
+				828 New Meister Lane
+				Pflugerville  TX  78660
+				US
+
+F0-32-1A   (hex)		Mita-Teknik A/S
+F0321A     (base 16)		Mita-Teknik A/S
+				Aktieselskabet af 12.12.2006
+				Roedkaersbro    8840
+				DK
+
+A8-81-F1   (hex)		BMEYE B.V.
+A881F1     (base 16)		BMEYE B.V.
+				Hoogoorddreef 60
+				Amsterdam    1101BE
+				NL
+
+C4-E9-84   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C4E984     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-69-D0   (hex)		Verto Medical Solutions, LLC
+D069D0     (base 16)		Verto Medical Solutions, LLC
+				900 Spruce St., Suite 550
+				St. Louis  Missouri  63012
+				US
+
+FC-13-49   (hex)		Global Apps Corp.
+FC1349     (base 16)		Global Apps Corp.
+				12F., No 225, Sec. 5 Nanjing E. Rd
+				Taipei    105
+				TW
+
+84-84-33   (hex)		Paradox Engineering SA
+848433     (base 16)		Paradox Engineering SA
+				Via Passeggiata, 7
+				Novazzano  Ticino  6883
+				CH
+
+44-C3-06   (hex)		SIFROM Inc.
+44C306     (base 16)		SIFROM Inc.
+				1201 N. Orange St., Ste 700 #7112
+				Wilmington  DE  19801-1186
+				US
+
+60-21-03   (hex)		I4VINE, INC
+602103     (base 16)		I4VINE, INC
+				TLI Building 6th floor, 195
+				Seongnam-si  Gyeonggi-do  462-100
+				KR
+
+FC-07-A0   (hex)		LRE Medical GmbH
+FC07A0     (base 16)		LRE Medical GmbH
+				Hofer Strasse 5
+				Noerdlingen  Bavaria  86720
+				DE
+
+1C-EE-E8   (hex)		Ilshin Elecom
+1CEEE8     (base 16)		Ilshin Elecom
+				2973, Hagun-ri, Yangchon-eup
+				Gimpo-si  Gyeonggi-do  415-843
+				KR
+
+90-31-CD   (hex)		Onyx Healthcare Inc.
+9031CD     (base 16)		Onyx Healthcare Inc.
+				2F ,No135, Lane235,
+				New Taipei City    231
+				TW
+
+E4-81-84   (hex)		Nokia
+E48184     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+14-C0-89   (hex)		DUNE HD LTD
+14C089     (base 16)		DUNE HD LTD
+				2F., No.297, Sec. 2, Tiding Blvd.,
+				Taipei    11493
+				TW
+
+F4-B6-E5   (hex)		TerraSem Co.,Ltd
+F4B6E5     (base 16)		TerraSem Co.,Ltd
+				9,Gwahaksaneop 5-ro
+				Cheongwon-Gu  ChungBuk  363-885
+				KR
+
+60-FF-DD   (hex)		C.E. ELECTRONICS, INC
+60FFDD     (base 16)		C.E. ELECTRONICS, INC
+				2107 INDUSTRIAL DR
+				BRYAN  OHIO  43506
+				US
+
+24-05-0F   (hex)		MTN Electronic Co. Ltd
+24050F     (base 16)		MTN Electronic Co. Ltd
+				MTN Industrial Park,No 3, Fuhua Road,
+				Shenzhen  Guangdong Province  518117
+				CN
+
+AC-2D-A3   (hex)		TXTR GmbH
+AC2DA3     (base 16)		TXTR GmbH
+				Rosenthaler Str. 13
+				Berlin    10119
+				DE
+
+88-9C-A6   (hex)		BTB Korea INC
+889CA6     (base 16)		BTB Korea INC
+				#1001, Suntech City 1st
+				Sungnam  Kyunggido  462-725
+				KR
+
+90-83-7A   (hex)		General Electric Water & Process Technologies
+90837A     (base 16)		General Electric Water & Process Technologies
+				6060 Spine Road
+				Boulder  Colorado  80301-3687
+				US
+
+80-BA-E6   (hex)		Neets
+80BAE6     (base 16)		Neets
+				Langballe 4
+				Horsens  Jylland  8700
+				DK
+
+F8-A2-B4   (hex)		RHEWA-WAAGENFABRIK August Freudewald GmbH &amp;Co. KG
+F8A2B4     (base 16)		RHEWA-WAAGENFABRIK August Freudewald GmbH &amp;Co. KG
+				Feldstr. 17
+				Mettmann    40822
+				DE
+
+E0-56-F4   (hex)		AxesNetwork Solutions inc.
+E056F4     (base 16)		AxesNetwork Solutions inc.
+				410 pepin
+				Sherbrooke  qc  j1l2y8
+				CA
+
+84-56-9C   (hex)		Coho Data, Inc.,
+84569C     (base 16)		Coho Data, Inc.,
+				1230 Midas Way, Suite 110
+				Sunnyvale  CA  94085
+				US
+
+78-AE-0C   (hex)		Far South Networks
+78AE0C     (base 16)		Far South Networks
+				49 Bell Crescent
+				Westlake  Western Cape  7945
+				ZA
+
+B0-24-F3   (hex)		Progeny Systems
+B024F3     (base 16)		Progeny Systems
+				9500 Innovation Drive
+				Manassas  VA  20110
+				US
+
+0C-54-A5   (hex)		PEGATRON CORPORATION
+0C54A5     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+8C-4D-B9   (hex)		Unmonday Ltd
+8C4DB9     (base 16)		Unmonday Ltd
+				Laivakatu 3
+				Helsinki  Uusimaa  00150
+				FI
+
+78-CA-5E   (hex)		ELNO
+78CA5E     (base 16)		ELNO
+				43 rue Michel Carré
+				Argenteuil  -  F95102
+				US
+
+2C-5A-05   (hex)		Nokia Corporation
+2C5A05     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+D4-81-CA   (hex)		iDevices, LLC
+D481CA     (base 16)		iDevices, LLC
+				136 Simsbury, Rd
+				Avon  CT  06001
+				US
+
+D8-58-D7   (hex)		CZ.NIC, z.s.p.o.
+D858D7     (base 16)		CZ.NIC, z.s.p.o.
+				Americka 23
+				  Prague  12000
+				CZ
+
+B0-D7-C5   (hex)		Logipix Ltd
+B0D7C5     (base 16)		Logipix Ltd
+				Kesmark utca 11-13
+				Budapest  -  1158
+				HU
+
+A4-3A-69   (hex)		Vers Inc
+A43A69     (base 16)		Vers Inc
+				PO Box 5265
+				Wayland  MA  01778
+				US
+
+9C-44-A6   (hex)		SwiftTest, Inc.
+9C44A6     (base 16)		SwiftTest, Inc.
+				3255 Scott Blvd.
+				Santa Clara  California  95054
+				US
+
+4C-D9-C4   (hex)		Magneti Marelli Automotive Electronics (Guangzhou) Co. Ltd
+4CD9C4     (base 16)		Magneti Marelli Automotive Electronics (Guangzhou) Co. Ltd
+				Building B10, No.8 Jinghu Road
+				Guangzhou  Guangdong  510800
+				CN
+
+50-E0-C7   (hex)		TurControlSystme AG
+50E0C7     (base 16)		TurControlSystme AG
+				Geschwister-Scholl-Strasse 7
+				Genthin  Sachsen-Anhalt  39307
+				DE
+
+B4-82-7B   (hex)		AKG Acoustics GmbH
+B4827B     (base 16)		AKG Acoustics GmbH
+				Lemboeckgasse 21-25
+				  Vienna  1230
+				AT
+
+DC-5E-36   (hex)		Paterson Technology
+DC5E36     (base 16)		Paterson Technology
+				23490 SE 51st Pl
+				Issaquah  WA  98029
+				US
+
+DC-AD-9E   (hex)		GreenPriz
+DCAD9E     (base 16)		GreenPriz
+				549, boulevard Pierre Sauvaigo
+				La Colle sur Loup    06480
+				FR
+
+B8-DF-6B   (hex)		SpotCam Co., Ltd.
+B8DF6B     (base 16)		SpotCam Co., Ltd.
+				12F.-1, No.125, Jianguo Rd.
+				New Taipei City    239
+				TW
+
+9C-88-88   (hex)		Simac Techniek NV
+9C8888     (base 16)		Simac Techniek NV
+				De Run 1101
+				Veldhoven  NB  5503LB
+				NL
+
+10-B2-6B   (hex)		base Co.,Ltd.
+10B26B     (base 16)		base Co.,Ltd.
+				F1 92 building taoyuancun longzhu road
+				Shenzhen  Guangdong  518000
+				CN
+
+4C-F0-2E   (hex)		Vifa Denmark A/S
+4CF02E     (base 16)		Vifa Denmark A/S
+				Mariendalsvej 2A
+				Viborg    DK-8800
+				US
+
+28-8A-1C   (hex)		Juniper Networks
+288A1C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+DC-CE-BC   (hex)		Shenzhen JSR Technology Co.,Ltd.
+DCCEBC     (base 16)		Shenzhen JSR Technology Co.,Ltd.
+				2-3F,E building,Yu Jianfeng science and industry park
+				Shenzhen City  Guangdong  518109
+				CN
+
+18-C8-E7   (hex)		Shenzhen Hualistone Technology Co.,Ltd
+18C8E7     (base 16)		Shenzhen Hualistone Technology Co.,Ltd
+				1708RM,Huafeng HQ Economic Building,
+				Shenzhen  Guangdong  518102
+				CN
+
+A0-3B-1B   (hex)		Inspire Tech
+A03B1B     (base 16)		Inspire Tech
+				No.588-10,Zhongzheng Rd.,Xinzhuang Dist
+				New Taipei  Taiwan  24255
+				TW
+
+7C-CD-3C   (hex)		Guangzhou Juzing Technology Co., Ltd
+7CCD3C     (base 16)		Guangzhou Juzing Technology Co., Ltd
+				Building C Rm 1906-1909
+				Guangzhou  Guangdong  510630
+				US
+
+98-43-DA   (hex)		INTERTECH
+9843DA     (base 16)		INTERTECH
+				3F. 14-9 Sarihyun-Ro. Ilsandong-Gu
+				Goyang-Si  Gyeonggi-Do  410-821
+				KR
+
+08-CA-45   (hex)		Toyou Feiji Electronics Co., Ltd.
+08CA45     (base 16)		Toyou Feiji Electronics Co., Ltd.
+				No.2 Building No.9 Yard, Dijin Road,
+				  Beijing  100095
+				CN
+
+3C-CA-87   (hex)		Iders Incorporated
+3CCA87     (base 16)		Iders Incorporated
+				27047 Oakwood Rd
+				Oakbank  Manitoba  R0E 1J2
+				CA
+
+7C-6A-B3   (hex)		IBC TECHNOLOGIES INC.
+7C6AB3     (base 16)		IBC TECHNOLOGIES INC.
+				1445 CHARLES STREET
+				Vancouver  British Columbia  V5L2S7
+				CA
+
+18-1B-EB   (hex)		Actiontec Electronics, Inc
+181BEB     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+84-A7-83   (hex)		Alcatel Lucent
+84A783     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+04-1A-04   (hex)		WaveIP
+041A04     (base 16)		WaveIP
+				1 Sky street
+				Misgav    20179
+				IL
+
+68-76-4F   (hex)		Sony Mobile Communications Inc
+68764F     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+34-A5-E1   (hex)		Sensorist ApS
+34A5E1     (base 16)		Sensorist ApS
+				Nyhavn 16
+				Copenhagen K  Sjaelland  1051
+				DK
+
+80-79-AE   (hex)		ShanDong Tecsunrise  Co.,Ltd
+8079AE     (base 16)		ShanDong Tecsunrise  Co.,Ltd
+				B316,F-2,QiLu Soft Park,
+				JiNan  ShanDong  250101
+				CN
+
+7C-BD-06   (hex)		AE REFUsol
+7CBD06     (base 16)		AE REFUsol
+				Uracher Str. 91
+				Metzingen  Baden-Württemberg  72555
+				DE
+
+94-BA-56   (hex)		Shenzhen Coship Electronics Co., Ltd.
+94BA56     (base 16)		Shenzhen Coship Electronics Co., Ltd.
+				Rainbow Bldg., North, Hi-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+38-DB-BB   (hex)		Sunbow Telecom Co., Ltd.
+38DBBB     (base 16)		Sunbow Telecom Co., Ltd.
+				3F, 501-21, Chung Cheng Rd., Hsin Tien Dist.
+				New Taipei City    23148
+				TW
+
+44-8A-5B   (hex)		Micro-Star INT'L CO., LTD.
+448A5B     (base 16)		Micro-Star INT'L CO., LTD.
+				No69, LIde St.
+				Taipei    235
+				TW
+
+6C-4B-7F   (hex)		Vossloh-Schwabe Deutschland GmbH
+6C4B7F     (base 16)		Vossloh-Schwabe Deutschland GmbH
+				Wasenstrasse 25
+				Urbach    73660
+				DE
+
+90-8C-44   (hex)		H.K ZONGMU TECHNOLOGY CO., LTD.
+908C44     (base 16)		H.K ZONGMU TECHNOLOGY CO., LTD.
+				ROOM 604, BUILDING B, 977 SHANGFENG RD
+				  SHANGHAI  201201
+				CN
+
+68-8A-B5   (hex)		EDP Servicos
+688AB5     (base 16)		EDP Servicos
+				Rua Castilho, número 165, 5º andar
+				Lisboa    1070-050
+				PT
+
+24-93-CA   (hex)		Voxtronic Austria
+2493CA     (base 16)		Voxtronic Austria
+				Modecenterstrasse 17  Objekt 1
+				Vienna    1110
+				AT
+
+0C-CB-8D   (hex)		ASCO Numatics GmbH
+0CCB8D     (base 16)		ASCO Numatics GmbH
+				Otto-Hahn-Str. 7-11
+				Oelbronn-Duerrn    75248
+				DE
+
+90-79-90   (hex)		Benchmark Electronics Romania SRL
+907990     (base 16)		Benchmark Electronics Romania SRL
+				Aeroportului no 6 Ghimbav
+				Brasov    507075
+				US
+
+74-0E-DB   (hex)		Optowiz Co., Ltd
+740EDB     (base 16)		Optowiz Co., Ltd
+				D-901 Bundang Techno Park
+				Seongnam-si  Kyeonggi-do  463-760
+				KR
+
+6C-83-66   (hex)		Nanjing SAC Power Grid Automation Co., Ltd.
+6C8366     (base 16)		Nanjing SAC Power Grid Automation Co., Ltd.
+				No.11 Phoenix Road
+				Nanjing  Jiangsu Provience  211100
+				CN
+
+F8-3D-4E   (hex)		Softlink Automation System Co., Ltd
+F83D4E     (base 16)		Softlink Automation System Co., Ltd
+				No.12, Hi-tech South 7th Rd.,
+				Shenzhen  GuangDong  518057
+				CN
+
+74-D4-35   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+74D435     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+78-D9-9F   (hex)		NuCom HK Ltd.
+78D99F     (base 16)		NuCom HK Ltd.
+				Unit B 11/F, Eton Bldg, 288 Des Voeux Rd. Central
+				Hong Kong  Hong Kong  00852
+				CN
+
+14-2B-D2   (hex)		Armtel Ltd.
+142BD2     (base 16)		Armtel Ltd.
+				 33A Smolenskaya str.
+				St.  Petersburg    196084
+				RU
+
+9C-A1-0A   (hex)		SCLE SFE
+9CA10A     (base 16)		SCLE SFE
+				Parc des Aygalades – Bât 10
+				MARSEILLE  PACA  13014
+				FR
+
+88-78-9C   (hex)		Game Technologies SA
+88789C     (base 16)		Game Technologies SA
+				Plac W. Andersa 3
+				Poznan    61894
+				PL
+
+A4-89-5B   (hex)		ARK INFOSOLUTIONS PVT LTD
+A4895B     (base 16)		ARK INFOSOLUTIONS PVT LTD
+				4428, GANESH BAZAR CLOTH MARKET
+				  DELHI  110006
+				IN
+
+D0-9D-0A   (hex)		LINKCOM
+D09D0A     (base 16)		LINKCOM
+				11 Rue du Soleil Levant
+				Clamart    92140
+				FR
+
+EC-21-9F   (hex)		VidaBox LLC
+EC219F     (base 16)		VidaBox LLC
+				240 Madison Ave
+				Garden City Park  NEW YORK  11040
+				US
+
+A8-CC-C5   (hex)		Saab AB (publ)
+A8CCC5     (base 16)		Saab AB (publ)
+				Nobymalmsvagen
+				Linkoping    SE-581 82
+				SE
+
+58-46-8F   (hex)		Koncar Electronics and Informatics
+58468F     (base 16)		Koncar Electronics and Informatics
+				Fallerovo setaliste 22
+				Zagreb  Drvinje  10000
+				HR
+
+98-5D-46   (hex)		PeopleNet Communication
+985D46     (base 16)		PeopleNet Communication
+				4400 Baker Road
+				Minnetonka  Minnesota  55343
+				US
+
+F8-9F-B8   (hex)		YAZAKI Energy System Corporation
+F89FB8     (base 16)		YAZAKI Energy System Corporation
+				1-7-1 YOKOI
+				Shimada -shi,Shizuoka    427-8555
+				JP
+
+F0-F5-AE   (hex)		Adaptrum Inc.
+F0F5AE     (base 16)		Adaptrum Inc.
+				25 E Trimble Rd.
+				San Jose  California  95131
+				US
+
+FC-3F-AB   (hex)		Henan Lanxin Technology Co., Ltd
+FC3FAB     (base 16)		Henan Lanxin Technology Co., Ltd
+				4/F-B, Building No.1, 863 Central China Software Park, No.6 Cuizhu Street, High &amp; New Technology Industries Development Zone
+				Zhengzhou  Henan  450001
+				CN
+
+98-8E-4A   (hex)		NOXUS(BEIJING) TECHNOLOGY CO.,LTD
+988E4A     (base 16)		NOXUS(BEIJING) TECHNOLOGY CO.,LTD
+				02-1205,11/F, No.2 Building,No.8,Worker’s Stadium North Road Chaoyang District
+				  Beijing  100027
+				CN
+
+EC-2A-F0   (hex)		Ypsomed AG
+EC2AF0     (base 16)		Ypsomed AG
+				Brunnmattstrasse 6
+				Burgdorf  BE  3400
+				CH
+
+F8-54-AF   (hex)		ECI Telecom Ltd.
+F854AF     (base 16)		ECI Telecom Ltd.
+				30 Hasivim St.
+				Petah Tikva    49133
+				IL
+
+54-BE-F7   (hex)		PEGATRON CORPORATION
+54BEF7     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+50-B8-88   (hex)		wi2be Tecnologia S/A
+50B888     (base 16)		wi2be Tecnologia S/A
+				Rua Manoel Valdomiro de Macedo, 2285
+				Curitiba  Parana  81170-150
+				BR
+
+7C-83-06   (hex)		Glen Dimplex Nordic as
+7C8306     (base 16)		Glen Dimplex Nordic as
+				Postboks 16
+				Stjoerdal  N-T  7501
+				NO
+
+44-2A-FF   (hex)		E3 Technology, Inc.
+442AFF     (base 16)		E3 Technology, Inc.
+				Martell-house 2F, 2-28-3 Sekimachi-Kita,
+				Nerima-ku  Tokyo  177-0051
+				JP
+
+14-0D-4F   (hex)		Flextronics International
+140D4F     (base 16)		Flextronics International
+				Stretton Green Distribution Centre Langford Way
+				Warrington  Cheshire  WA4 4TQ
+				GB
+
+44-67-55   (hex)		Orbit Irrigation
+446755     (base 16)		Orbit Irrigation
+				P.O. Box 328
+				Bountiful  Utah  84011
+				US
+
+E0-FA-EC   (hex)		Platan sp. z o.o. sp. k.
+E0FAEC     (base 16)		Platan sp. z o.o. sp. k.
+				ul.Platanowa 2
+				Sopot  pomorskie  81-855
+				PL
+
+7C-E5-6B   (hex)		ESEN Optoelectronics Technology Co.,Ltd.
+7CE56B     (base 16)		ESEN Optoelectronics Technology Co.,Ltd.
+				Houcheng Yuanjiaqiao ,Jingang Town
+				Zhangjiagang  Jiangsu  215631
+				CN
+
+D4-4C-9C   (hex)		Shenzhen YOOBAO Technology Co.Ltd
+D44C9C     (base 16)		Shenzhen YOOBAO Technology Co.Ltd
+				F3,A5,Hua Tong Yuan Logistics Center,Minzhi Street,Longhua Town,Bao’an District,Shenzhen City,China
+				Shenzhen  Guangdong  518000
+				CN
+
+20-CE-C4   (hex)		Peraso Technologies
+20CEC4     (base 16)		Peraso Technologies
+				144 Front St. West, Suite 685
+				Toronto  ON  M5J 2L7
+				CA
+
+CC-47-03   (hex)		Intercon Systems Co., Ltd.
+CC4703     (base 16)		Intercon Systems Co., Ltd.
+				#915 Hanlim Human Tower,1-40 Geumjeong-dong
+				Gunpo-si  Gyeonggi-do  435-824
+				KR
+
+AC-CA-8E   (hex)		ODA Technologies
+ACCA8E     (base 16)		ODA Technologies
+				607-A Woorim Lions Valley, #425
+				Incheon    KSXX0009
+				KR
+
+08-8E-4F   (hex)		SF Software Solutions
+088E4F     (base 16)		SF Software Solutions
+				Buchenweg 32
+				Großbettlingen  Baden-Württemberg  72663
+				US
+
+54-05-36   (hex)		Vivago Oy
+540536     (base 16)		Vivago Oy
+				Itsehallintokuja 6
+				  Espoo  FI-02600
+				FI
+
+6C-90-B1   (hex)		SanLogic Inc
+6C90B1     (base 16)		SanLogic Inc
+				2350 Mission College Blvd
+				Santa Clara  CA  95054
+				US
+
+CC-7B-35   (hex)		zte corporation
+CC7B35     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+04-D4-37   (hex)		ZNV
+04D437     (base 16)		ZNV
+				4/F, W1-A, Bldg, Gaoxin S, 1st Ave., Hi-tech Park, Nanshan District, Shenzhen, P.R.C
+				Shenzhen  Guangdong  518057
+				US
+
+CC-F4-07   (hex)		EUKREA ELECTROMATIQUE SARL
+CCF407     (base 16)		EUKREA ELECTROMATIQUE SARL
+				74 AVENUE JEAN JAURES
+				PESSAC  GIRONDE  33600
+				FR
+
+DC-17-92   (hex)		Captivate Network
+DC1792     (base 16)		Captivate Network
+				2 Executive Drive Suite 301
+				Chelmsford  Massachusetts  01824
+				US
+
+28-A2-41   (hex)		exlar corp
+28A241     (base 16)		exlar corp
+				18400 west 77th street
+				chanhassen  mn  55317
+				US
+
+50-98-71   (hex)		Inventum Technologies Private Limited
+509871     (base 16)		Inventum Technologies Private Limited
+				C-70, Phase 2 Extension
+				NOIDA  Uttar Pradesh  201305
+				IN
+
+04-8C-03   (hex)		ThinPAD Technology (Shenzhen)CO.,LTD
+048C03     (base 16)		ThinPAD Technology (Shenzhen)CO.,LTD
+				Room 2305, Xingji Building, Xinsha Road
+				Shenzhen  Guangdong  518104
+				CN
+
+88-46-2A   (hex)		Telechips Inc.
+88462A     (base 16)		Telechips Inc.
+				Luther Building,7-20, Sincheon-dong,Songpa-gu,
+				Seoul  Seoul  138-240
+				KR
+
+C8-02-58   (hex)		ITW GSE ApS
+C80258     (base 16)		ITW GSE ApS
+				Smedebakken 31-33
+				Odense N    5270
+				DK
+
+30-78-6B   (hex)		TIANJIN Golden Pentagon Electronics Co., Ltd.
+30786B     (base 16)		TIANJIN Golden Pentagon Electronics Co., Ltd.
+				No. 196 Rixin Road, Binhai Science Park,
+				  Tianjin  300457
+				CN
+
+20-DF-3F   (hex)		Nanjing SAC Power Grid Automation Co., Ltd.
+20DF3F     (base 16)		Nanjing SAC Power Grid Automation Co., Ltd.
+				No.11 Phoenix Road
+				Nanjing  Jiangsu  211106
+				CN
+
+F8-51-6D   (hex)		Denwa Technology Corp.
+F8516D     (base 16)		Denwa Technology Corp.
+				1931 NW 150 TH AVE
+				Penbroke Pines  Florida  33028
+				US
+
+44-4A-65   (hex)		Silverflare Ltd.
+444A65     (base 16)		Silverflare Ltd.
+				2 Bakers Yard
+				Uxbridge  Greater London  UB8 1JZ
+				GB
+
+74-4B-E9   (hex)		EXPLORER HYPERTECH CO.,LTD
+744BE9     (base 16)		EXPLORER HYPERTECH CO.,LTD
+				7F.-9,NO.112,Xinmin St
+				New Taipei City    235
+				TW
+
+FC-60-18   (hex)		Zhejiang Kangtai Electric Co., Ltd.
+FC6018     (base 16)		Zhejiang Kangtai Electric Co., Ltd.
+				No.5, Kangtai Rd
+				Yueqing  Zhejiang  325605
+				CN
+
+F4-20-12   (hex)		Cuciniale GmbH
+F42012     (base 16)		Cuciniale GmbH
+				Heuriedweg 65
+				Lindau    88131
+				DE
+
+98-B0-39   (hex)		Nokia
+98B039     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+B8-30-A8   (hex)		Road-Track Telematics Development
+B830A8     (base 16)		Road-Track Telematics Development
+				15th Keren Hayesod St.
+				Tirat Hacarmel  Israel  15223
+				IL
+
+4C-D6-37   (hex)		Qsono Electronics Co., Ltd
+4CD637     (base 16)		Qsono Electronics Co., Ltd
+				2nd Floor,Dingxin Industry park,jiayuan Road,East Lake Development Zone
+				Wuhan  Hubei  430074
+				CN
+
+94-36-E0   (hex)		Sichuan Bihong Broadcast &amp; Television New Technologies Co.,Ltd
+9436E0     (base 16)		Sichuan Bihong Broadcast &amp; Television New Technologies Co.,Ltd
+				Guanghan City, Sichuan province Zhongshan road south three period of 36
+				Deyang Guanghan  Sichuan Province  618300
+				CN
+
+54-22-F8   (hex)		zte corporation
+5422F8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+48-6E-73   (hex)		Pica8, Inc.
+486E73     (base 16)		Pica8, Inc.
+				1032 Elwell Court, Suite 105
+				Palo Alto  CA  94303
+				US
+
+64-05-BE   (hex)		NEW LIGHT LED
+6405BE     (base 16)		NEW LIGHT LED
+				No.50, Siyuan Rd
+				New Taipei    24251
+				TW
+
+64-6E-EA   (hex)		Iskratel d.o.o.
+646EEA     (base 16)		Iskratel d.o.o.
+				Ljubljanska cesta 24a
+				Kranj    4000
+				SI
+
+D0-73-7F   (hex)		Mini-Circuits
+D0737F     (base 16)		Mini-Circuits
+				50 Yosef Levi Street
+				Kiryat Bialik Industrial Zone    27000
+				US
+
+E8-BB-3D   (hex)		Sino Prime-Tech Limited
+E8BB3D     (base 16)		Sino Prime-Tech Limited
+				Room 418, Building 1, Hua Mei Ju (D),
+				Shenzhen  Guangdong  518101
+				CN
+
+28-28-5D   (hex)		Zyxel Communications Corporation
+28285D     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+0C-F0-19   (hex)		Malgn Technology Co., Ltd.
+0CF019     (base 16)		Malgn Technology Co., Ltd.
+				Star Tower #305, 223-25
+				Seongnam-Si  Kyounggi-Do  462-738
+				KR
+
+94-9F-B4   (hex)		ChengDu JiaFaAnTai Technology Co.,Ltd
+949FB4     (base 16)		ChengDu JiaFaAnTai Technology Co.,Ltd
+				8th Floor, Building No.2, Zone A of Wisdom Valley
+				Chengdu  Sichuan  610000
+				CN
+
+40-68-26   (hex)		Thales UK Limited
+406826     (base 16)		Thales UK Limited
+				1 Linthouse Road
+				Glasgow  Scotland  G51 4BZ
+				GB
+
+F8-2B-C8   (hex)		Jiangsu Switter Co., Ltd
+F82BC8     (base 16)		Jiangsu Switter Co., Ltd
+				Room 512, Buliding 8, 118 Nanyuanbei Road
+				Suzhou City  Jiangsu Province  215006
+				CN
+
+60-C3-97   (hex)		2Wire Inc
+60C397     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+E0-7F-88   (hex)		EVIDENCE Network SIA
+E07F88     (base 16)		EVIDENCE Network SIA
+				Zilupes 4A
+				  Rīga  LV-1019
+				LV
+
+1C-7C-C7   (hex)		Coriant GmbH
+1C7CC7     (base 16)		Coriant GmbH
+				St.-Martin-Str. 76
+				Munich  Germany  81541
+				DE
+
+34-1B-22   (hex)		Grandbeing Technology Co., Ltd
+341B22     (base 16)		Grandbeing Technology Co., Ltd
+				B-301,Science and Technology Building Phase II
+				Shenzhen  Guangdong  518000
+				CN
+
+40-56-0C   (hex)		In Home Displays Ltd
+40560C     (base 16)		In Home Displays Ltd
+				Waterside House
+				Edinburgh  Lothian  EH6 6QU
+				GB
+
+58-E0-2C   (hex)		Micro Technic A/S
+58E02C     (base 16)		Micro Technic A/S
+				Smedevaenget 5
+				Aarup    5560
+				DK
+
+78-B3-CE   (hex)		Elo touch solutions
+78B3CE     (base 16)		Elo touch solutions
+				1033 McCarthy Boulevard
+				Milpitas  CA  95035
+				US
+
+88-14-2B   (hex)		Protonic Holland
+88142B     (base 16)		Protonic Holland
+				Factorij 36
+				Zwaag NH  Netherlands  1689 AL
+				NL
+
+A4-FC-CE   (hex)		Security Expert Ltd.
+A4FCCE     (base 16)		Security Expert Ltd.
+				75, Ekaterininskaya Street, of. 105
+				Perm  Perm region  614000
+				RU
+
+34-A6-8C   (hex)		Shine Profit Development Limited
+34A68C     (base 16)		Shine Profit Development Limited
+				Unit 1401B Telecom Tower
+				Kwun Tong  Kowloon  000001
+				HK
+
+34-1A-4C   (hex)		SHENZHEN WEIBU ELECTRONICS CO.,LTD.
+341A4C     (base 16)		SHENZHEN WEIBU ELECTRONICS CO.,LTD.
+				3/F, Block 132,Jindi Industrial Zone
+				Shenzhen  Guangdong  518048
+				CN
+
+04-88-E2   (hex)		Beats Electronics LLC
+0488E2     (base 16)		Beats Electronics LLC
+				1601 Cloverfield Blvd.
+				Santa Monica  California  90404
+				US
+
+A4-7A-CF   (hex)		VIBICOM COMMUNICATIONS INC.
+A47ACF     (base 16)		VIBICOM COMMUNICATIONS INC.
+				900 CORPORATE DRIVE
+				MAHWAH  NEW JERSEY  074030
+				US
+
+BC-26-1D   (hex)		HONG KONG TECON TECHNOLOGY
+BC261D     (base 16)		HONG KONG TECON TECHNOLOGY
+				ROOM 2802,BLOCK A,SHEN FANG OLAZA
+				Shenzhen  Guangdong  518000
+				CN
+
+E8-CE-06   (hex)		SkyHawke Technologies, LLC.
+E8CE06     (base 16)		SkyHawke Technologies, LLC.
+				274 Commerce Park Drive
+				Ridgeland  MS  39157
+				US
+
+C8-F3-86   (hex)		Shenzhen Xiaoniao Technology Co.,Ltd
+C8F386     (base 16)		Shenzhen Xiaoniao Technology Co.,Ltd
+				Floor 13 C-D Yunsong Buliding
+				Futian District, Shenzhen  Guangdong  518040
+				CN
+
+E0-DC-A0   (hex)		Siemens Industrial Automation Products Ltd Chengdu
+E0DCA0     (base 16)		Siemens Industrial Automation Products Ltd Chengdu
+				Tianyuan Road 99
+				Cheng Du  Si Chuan  611731
+				CN
+
+84-2F-75   (hex)		Innokas Group
+842F75     (base 16)		Innokas Group
+				Tarjusojantie 12
+				Kempele  Oulu  90440
+				FI
+
+CC-3C-3F   (hex)		SA.S.S. Datentechnik AG
+CC3C3F     (base 16)		SA.S.S. Datentechnik AG
+				Talhofstr. 32
+				Gilching  Bayern  82205
+				DE
+
+2C-69-BA   (hex)		RF Controls, LLC
+2C69BA     (base 16)		RF Controls, LLC
+				622 Bates Street
+				Saint Louis  Missouri  63111
+				US
+
+D4-BF-7F   (hex)		UPVEL
+D4BF7F     (base 16)		UPVEL
+				13139 Ramona Blvd. #F
+				Irwindale  CA  91706
+				US
+
+2C-72-C3   (hex)		Soundmatters
+2C72C3     (base 16)		Soundmatters
+				8060 Double R Blvd Suite 100
+				Reno  NV  89511
+				US
+
+C4-48-38   (hex)		Satcom Direct, Inc.
+C44838     (base 16)		Satcom Direct, Inc.
+				1901 Hwy A1A
+				Satellite Beach  FL  32937
+				US
+
+C8-DD-C9   (hex)		Lenovo Mobile Communication Technology Ltd.
+C8DDC9     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,
+				Xiamen   Fujian  361006
+				US
+
+6C-86-86   (hex)		Technonia
+6C8686     (base 16)		Technonia
+				#1101, Hanshin IT Tower 235
+				  Seoul  152-768
+				KR
+
+D4-AC-4E   (hex)		BODi rS, LLC
+D4AC4E     (base 16)		BODi rS, LLC
+				7622 Rickenbacker Drive
+				Gaithersburg  MD  20879
+				US
+
+20-4C-6D   (hex)		Hugo Brennenstuhl Gmbh & Co. KG.
+204C6D     (base 16)		Hugo Brennenstuhl Gmbh & Co. KG.
+				Seestr. 1-3
+				Tuebingen  Baden-Wuerttemberg  72074
+				DE
+
+40-C4-D6   (hex)		ChongQing Camyu Technology Development Co.,Ltd.
+40C4D6     (base 16)		ChongQing Camyu Technology Development Co.,Ltd.
+				4th Floor,Tower of Venus Technology Building ,NO 60 Xing Guang Road
+				  Chong Qing  401121
+				CN
+
+A8-29-4C   (hex)		Precision Optical Transceivers, Inc.
+A8294C     (base 16)		Precision Optical Transceivers, Inc.
+				2328 Innovation Way
+				Rochester  NY  14624
+				US
+
+70-C6-AC   (hex)		Bosch Automotive Aftermarket
+70C6AC     (base 16)		Bosch Automotive Aftermarket
+				Franz Oechsle Str. 4
+				Plochingen    D-73201
+				DE
+
+7C-05-07   (hex)		PEGATRON CORPORATION
+7C0507     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+88-09-05   (hex)		MTMCommunications
+880905     (base 16)		MTMCommunications
+				2-3-10 Honmachi
+				Ichinomiya-shi  Aichi-ken  491-0853
+				US
+
+30-D4-6A   (hex)		Autosales Incorporated
+30D46A     (base 16)		Autosales Incorporated
+				1200 Souteat Avenue
+				Tallmadge  Ohio  44278
+				US
+
+28-2C-B2   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+282CB2     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+64-E5-99   (hex)		EFM Networks
+64E599     (base 16)		EFM Networks
+				6F, Benposra II 1197-1 Bojeong Giheung Gu
+				Yong In  Kyunggi do  446913
+				KR
+
+30-89-99   (hex)		Guangdong East Power Co.,
+308999     (base 16)		Guangdong East Power Co.,
+				No.6 Northern Industry Road,Songshan lake SCI&TECH Industry Park
+				DongGuan  GuangDong  523808
+				CN
+
+C8-93-46   (hex)		MXCHIP Company Limited
+C89346     (base 16)		MXCHIP Company Limited
+				Room 811,Tongpu Building,
+				Shanghai  Shanghai  200333
+				CN
+
+F4-B3-81   (hex)		WindowMaster A/S
+F4B381     (base 16)		WindowMaster A/S
+				Skelstedet 13
+				Vedbaek    2950
+				DK
+
+74-F1-02   (hex)		Beijing HCHCOM Technology Co., Ltd
+74F102     (base 16)		Beijing HCHCOM Technology Co., Ltd
+				Patton Building 8 floor,11# Wan liu zhong lu,Haidian District,Beijing,China
+				Beijing  China  100089
+				CN
+
+A0-86-1D   (hex)		Chengdu Fuhuaxin Technology co.,Ltd
+A0861D     (base 16)		Chengdu Fuhuaxin Technology co.,Ltd
+				Room 1608,Building G1,No.1800 of Yizhou Ave
+				Chengdu  Sichuan  610041
+				CN
+
+50-8D-6F   (hex)		CHAHOO Limited
+508D6F     (base 16)		CHAHOO Limited
+				B-4thFloor, 631
+				Sungnam  Gyeonggi  463-400
+				KR
+
+E8-DE-27   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+E8DE27     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+94-AC-CA   (hex)		trivum technologies GmbH
+94ACCA     (base 16)		trivum technologies GmbH
+				Heusteigstraße 37
+				Stuttgart    70108
+				DE
+
+9C-97-26   (hex)		Technicolor
+9C9726     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+90-82-60   (hex)		IEEE 1904.1 Working Group
+908260     (base 16)		IEEE 1904.1 Working Group
+				1351 Redwood Way,
+				Petaluma  CA  94954
+				US
+
+D4-EE-07   (hex)		HIWIFI Co., Ltd.
+D4EE07     (base 16)		HIWIFI Co., Ltd.
+				Room 1002, Zhongguancun e-Plaza A,
+				Haidian District  Beijing  100080
+				CN
+
+FC-AD-0F   (hex)		QTS NETWORKS
+FCAD0F     (base 16)		QTS NETWORKS
+				Jinyanlong Plaza, Huilongguan,
+				  Beijing  100092
+				CN
+
+98-4C-04   (hex)		Zhangzhou Keneng Electrical Equipment Co Ltd
+984C04     (base 16)		Zhangzhou Keneng Electrical Equipment Co Ltd
+				Keneng Technology Park,No.12 Wuqiao Zhong Rd
+				Zhangzhou  Fujian  363005
+				CN
+
+A4-E9-91   (hex)		SISTEMAS AUDIOVISUALES ITELSIS S.L.
+A4E991     (base 16)		SISTEMAS AUDIOVISUALES ITELSIS S.L.
+				POL.IND. DEL TAMBRE
+				SANTIAGO COMPOSTELA  A CORUÑA  15890
+				ES
+
+3C-86-A8   (hex)		Sangshin elecom .co,, LTD
+3C86A8     (base 16)		Sangshin elecom .co,, LTD
+				614-1 Wolhari Suhmyon
+				  Choongnam  339-814
+				KR
+
+84-F4-93   (hex)		OMS spol. s.r.o.
+84F493     (base 16)		OMS spol. s.r.o.
+				Dojc 419
+				Dojc  Slovakia  90602
+				SK
+
+BC-D1-77   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+BCD177     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+AC-DB-DA   (hex)		Shenzhen Geniatech Inc, Ltd
+ACDBDA     (base 16)		Shenzhen Geniatech Inc, Ltd
+				18th F, GDC Building,No.9 ,Gaoxin Central Avenue 3rd
+				Shenzhen  GuangDong  518057
+				CN
+
+D4-27-51   (hex)		Infopia Co., Ltd
+D42751     (base 16)		Infopia Co., Ltd
+				891, Hogye-dong, Dongan-gu
+				Anyang  Gyeonggi  431-080
+				KR
+
+10-3D-EA   (hex)		HFC Technology (Beijing) Ltd. Co.
+103DEA     (base 16)		HFC Technology (Beijing) Ltd. Co.
+				Building #3, Room 1214
+				Beijing  AP (Area Pacific)  100193
+				CN
+
+F0-5D-C8   (hex)		Duracell Powermat
+F05DC8     (base 16)		Duracell Powermat
+				230 Park Ave, suit 910
+				new york  NY  10169
+				US
+
+CC-5D-57   (hex)		Information  System Research Institute,Inc.
+CC5D57     (base 16)		Information  System Research Institute,Inc.
+				Metro city minamiikebukuro-bldg.5F
+				Toshima-ku  Tokyo  171-0022
+				JP
+
+64-C6-67   (hex)		Barnes&Noble
+64C667     (base 16)		Barnes&Noble
+				400 Hamilton Avenue
+				Palo Alto  CA  94301
+				US
+
+F0-F2-60   (hex)		Mobitec AB
+F0F260     (base 16)		Mobitec AB
+				Box 97
+				Herrljunga  VG  52421
+				SE
+
+04-4C-EF   (hex)		Fujian Sanao Technology Co.,Ltd
+044CEF     (base 16)		Fujian Sanao Technology Co.,Ltd
+				Fuzhou shibei bicyclic road no. 117
+				Fuzhou  Fujian  350000
+				CN
+
+4C-80-4F   (hex)		Armstrong Monitoring Corp
+4C804F     (base 16)		Armstrong Monitoring Corp
+				215 Colonnade Rd
+				Nepean  Ontario  K2E 7K3
+				CA
+
+7C-D7-62   (hex)		Freestyle Technology Pty Ltd
+7CD762     (base 16)		Freestyle Technology Pty Ltd
+				1A 24 Ricketts Road
+				Mount Waverley  Victoria  3149
+				AU
+
+90-1D-27   (hex)		zte corporation
+901D27     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+9C-31-78   (hex)		Foshan Huadian Intelligent Communications Teachnologies Co.,Ltd
+9C3178     (base 16)		Foshan Huadian Intelligent Communications Teachnologies Co.,Ltd
+				Building B,No.8 of Shishan Industrial Avenue
+				Foshan  Guangdong  528225
+				CN
+
+B0-C9-5B   (hex)		Beijing Symtech CO.,LTD
+B0C95B     (base 16)		Beijing Symtech CO.,LTD
+				Technology Park Building 2-1,The Hung Fu Pioneer Park
+				  Beijing  102209
+				CN
+
+4C-CA-53   (hex)		Skyera, Inc.
+4CCA53     (base 16)		Skyera, Inc.
+				1704 Automation Pkwy
+				San Jose  CA  95131
+				US
+
+90-FF-79   (hex)		Metro Ethernet Forum
+90FF79     (base 16)		Metro Ethernet Forum
+				6033 W. Century Boulevard
+				Los Angeles  California  90045
+				US
+
+B0-14-08   (hex)		LIGHTSPEED INTERNATIONAL CO.
+B01408     (base 16)		LIGHTSPEED INTERNATIONAL CO.
+				No.20, LANE 526 NIUPU East RD.
+				Hsinchu  Not US/Canada  30091
+				TW
+
+08-1D-FB   (hex)		Shanghai Mexon Communication Technology Co.,Ltd
+081DFB     (base 16)		Shanghai Mexon Communication Technology Co.,Ltd
+				Floor4-5, Unit B, Building 5 ,Lane 128, Jiujing Road
+				Shanghai  Shanghai  201615
+				CN
+
+98-3F-9F   (hex)		China SSJ (Suzhou) Network Technology Inc.
+983F9F     (base 16)		China SSJ (Suzhou) Network Technology Inc.
+				399 Linquan St., Dongnan Building 411
+				Suzhou  Jiangsu  215123
+				CN
+
+B8-38-CA   (hex)		Kyokko Tsushin System CO.,LTD
+B838CA     (base 16)		Kyokko Tsushin System CO.,LTD
+				2-25-7 sakado,Takatsu-ku
+				Kawasaki  Kanagawa  213-0012
+				JP
+
+C4-4E-AC   (hex)		Shenzhen Shiningworth Technology Co., Ltd.
+C44EAC     (base 16)		Shenzhen Shiningworth Technology Co., Ltd.
+				Room 610, Block B, Huameiju Business Center,
+				Shenzhen  Guangdong  518000
+				CN
+
+A8-01-80   (hex)		IMAGO Technologies GmbH
+A80180     (base 16)		IMAGO Technologies GmbH
+				Strassheimer Str. 45
+				Friedberg  Hessen  61169
+				DE
+
+0C-55-21   (hex)		Axiros GmbH
+0C5521     (base 16)		Axiros GmbH
+				Altlaufstrasse 34
+				Munich Hoehenkirchen  Bavaria  85635
+				DE
+
+68-A4-0E   (hex)		BSH Hausgeräte GmbH
+68A40E     (base 16)		BSH Hausgeräte GmbH
+				Im Gewerbepark B35
+				Regensburg  Bayern  93059
+				DE
+
+F4-C6-D7   (hex)		blackned GmbH
+F4C6D7     (base 16)		blackned GmbH
+				Am Hartholz 21
+				Alling  Bavaria  82239
+				DE
+
+D4-CA-6E   (hex)		u-blox AG
+D4CA6E     (base 16)		u-blox AG
+				Zuercherstrasse 68
+				Thalwil    8800
+				CH
+
+5C-43-D2   (hex)		HAZEMEYER
+5C43D2     (base 16)		HAZEMEYER
+				ZI Route de Grugies
+				GAUCHY  FRANCE  02430
+				FR
+
+D8-09-C3   (hex)		Cercacor Labs
+D809C3     (base 16)		Cercacor Labs
+				189 Technology Dr
+				Irvine  CA  92618
+				US
+
+E0-C2-B7   (hex)		Masimo Corporation
+E0C2B7     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine  CA  92618
+				US
+
+A0-19-17   (hex)		Bertel S.p.a.
+A01917     (base 16)		Bertel S.p.a.
+				Frazione Rimale, Via Emilia Ovest 61
+				Fidenza  Parma  43036
+				IT
+
+68-B8-D9   (hex)		Act KDE, Inc.
+68B8D9     (base 16)		Act KDE, Inc.
+				196-14, Bangi-dong, Songpa-gu
+				Seoul    138-834
+				KR
+
+90-CC-24   (hex)		Synaptics, Inc
+90CC24     (base 16)		Synaptics, Inc
+				1251 McKay Drive
+				San Jose  CA   95131-1709
+				US
+
+2C-E8-71   (hex)		Alert Metalguard ApS
+2CE871     (base 16)		Alert Metalguard ApS
+				Vester Voldgade 104, st, th
+				Copenhagen V    1552
+				DK
+
+F8-7B-62   (hex)		FASTWEL INTERNATIONAL CO., LTD. Taiwan Branch
+F87B62     (base 16)		FASTWEL INTERNATIONAL CO., LTD. Taiwan Branch
+				6F., No.118, Ln. 235, Baociao Rd., Sindian City, Taipei County 231, Taiwan  R.O.C.
+				Taipei    231
+				TW
+
+40-27-0B   (hex)		Mobileeco Co., Ltd
+40270B     (base 16)		Mobileeco Co., Ltd
+				#2126, IT Tower B, Keumkang Penterium Bldg, 810
+				Anyang City  Kyunggi-Do  431810
+				KR
+
+74-FE-48   (hex)		ADVANTECH CO., LTD.
+74FE48     (base 16)		ADVANTECH CO., LTD.
+				NO.1, Alley 20, Lane 26
+				  TAIPEI  231
+				TW
+
+80-B9-5C   (hex)		ELFTECH Co., Ltd.
+80B95C     (base 16)		ELFTECH Co., Ltd.
+				174, Daehyeon Techno World 6F 609,
+				Uiwang-Si  Gyeonggi-Do  437-753
+				KR
+
+38-B5-BD   (hex)		E.G.O. Elektro-Ger
+38B5BD     (base 16)		E.G.O. Elektro-Ger
+				Einkauf
+				Oberderdingen    75038
+				DE
+
+20-91-8A   (hex)		PROFALUX
+20918A     (base 16)		PROFALUX
+				377 rue des Cypr
+				THYEZ  Haute Savoie  74300
+				FR
+
+E4-EE-FD   (hex)		MR&D Manufacturing
+E4EEFD     (base 16)		MR&D Manufacturing
+				Viale dell'Unione Europea, 8
+				Gallarate  Varese  21013
+				US
+
+10-5C-BF   (hex)		DuroByte Inc
+105CBF     (base 16)		DuroByte Inc
+				875 Foster Ave, Unit 101
+				Windsor  Ontario  N8X4W3
+				CA
+
+A4-6E-79   (hex)		DFT System Co.Ltd
+A46E79     (base 16)		DFT System Co.Ltd
+				Room 6B XINHAOFANG Building
+				SHENZHEN  GUANGDONG  518052
+				CN
+
+C8-8A-83   (hex)		Dongguan HuaHong Electronics Co.,Ltd
+C88A83     (base 16)		Dongguan HuaHong Electronics Co.,Ltd
+				NO.25,Xing Er Road,Chen Wu Industrial Zone,Wusha Village,Chang£§an Town
+				Dongguan City  China/Guangdong  523858
+				CN
+
+8C-C5-E1   (hex)		ShenZhen Konka Telecommunication Technology Co.,Ltd
+8CC5E1     (base 16)		ShenZhen Konka Telecommunication Technology Co.,Ltd
+				No.9008 Shennan Road
+				ShenZhen  GuangDong  518053
+				CN
+
+64-A3-41   (hex)		Wonderlan (Beijing) Technology Co., Ltd.
+64A341     (base 16)		Wonderlan (Beijing) Technology Co., Ltd.
+				Room 04D, Building D, KeShi Plaza
+				 Haidian District  Beijing  100085
+				CN
+
+78-98-FD   (hex)		Q9 Networks Inc.
+7898FD     (base 16)		Q9 Networks Inc.
+				Suite 4400, PO Box 235
+				Toronto  ON  M5K 1J3
+				CA
+
+D0-63-B4   (hex)		SolidRun Ltd.
+D063B4     (base 16)		SolidRun Ltd.
+				P.O Box 50782
+				Nazareth  ISRAEL  16165
+				IL
+
+9C-54-1C   (hex)		Shenzhen My-power Technology Co.,Ltd
+9C541C     (base 16)		Shenzhen My-power Technology Co.,Ltd
+				202¬Building 3¬Shenzhen Software Park
+				Shenzhen  Nanshan  518000
+				CN
+
+8C-33-30   (hex)		EmFirst Co., Ltd.
+8C3330     (base 16)		EmFirst Co., Ltd.
+				701 Suwon Venture Center
+				Suwon  Gyeonggi-do  442-833
+				KR
+
+08-7B-AA   (hex)		SVYAZKOMPLEKTSERVICE, LLC
+087BAA     (base 16)		SVYAZKOMPLEKTSERVICE, LLC
+				Lenskaya 2-21
+				Moscow    129327
+				US
+
+24-F2-DD   (hex)		Radiant Zemax LLC
+24F2DD     (base 16)		Radiant Zemax LLC
+				22908 NE Alder Crest Dr NE Ste 100
+				Redmond  WA  98053
+				US
+
+20-B5-C6   (hex)		Mimosa Networks
+20B5C6     (base 16)		Mimosa Networks
+				656 N. Santa Cruz. Ave., Suite B
+				Los Gatos  CA  95030
+				US
+
+E4-E4-09   (hex)		LEIFHEIT AG
+E4E409     (base 16)		LEIFHEIT AG
+				Leifhheitstreet
+				Nassau  Rheinland-Pfalz  56377
+				DE
+
+B8-77-C3   (hex)		METER Group
+B877C3     (base 16)		METER Group
+				2365 NE Hopkins Court
+				Pullman  WA  99163
+				US
+
+00-4D-32   (hex)		Andon Health Co.,Ltd.
+004D32     (base 16)		Andon Health Co.,Ltd.
+				NO.3Jin PIng Road Ya An Street
+				Tianjin    300190
+				CN
+
+FC-A9-B0   (hex)		MIARTECH (SHANGHAI),INC.
+FCA9B0     (base 16)		MIARTECH (SHANGHAI),INC.
+				3F,Building 4,No 290 Zhangheng Road Zhangjiang Hi-Tech Park,Pudong New District Shanghai,P.R.China
+				SHANGHAI  SHANGHAI  201204
+				CN
+
+94-DE-80   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+94DE80     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+2C-44-1B   (hex)		Spectrum Medical Limited
+2C441B     (base 16)		Spectrum Medical Limited
+				Harrier 4, Meteor Business Park
+				Gloucester    GL2 9QL
+				US
+
+EC-49-93   (hex)		Qihan Technology Co., Ltd 
+EC4993     (base 16)		Qihan Technology Co., Ltd 
+				20th Floor,Times Technology BuildingNo.7028,Shennan Road,Futian,
+				Shenzhen  Guangdong  518040
+				CN
+
+B0-AC-FA   (hex)		FUJITSU LIMITED
+B0ACFA     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+8C-E0-81   (hex)		zte corporation
+8CE081     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A4-4E-2D   (hex)		Adaptive Wireless Solutions, LLC
+A44E2D     (base 16)		Adaptive Wireless Solutions, LLC
+				577 Main Street
+				Hudson  MA  01749
+				US
+
+0C-CD-FB   (hex)		EDIC Systems Inc.
+0CCDFB     (base 16)		EDIC Systems Inc.
+				1-3-7 Nakamachidai
+				Yokohama  Kanagawa  224-0041
+				JP
+
+9C-8D-1A   (hex)		INTEG process group inc
+9C8D1A     (base 16)		INTEG process group inc
+				2919 E Hardies Rd, First Floor
+				Gibsonia  PA  15044
+				US
+
+48-03-62   (hex)		DESAY ELECTRONICS(HUIZHOU)CO.,LTD
+480362     (base 16)		DESAY ELECTRONICS(HUIZHOU)CO.,LTD
+				BuildingA,No.3 Desay Industrial Zone
+				Huizhou  Guangdong  516029
+				CN
+
+18-67-3F   (hex)		Hanover Displays Limited
+18673F     (base 16)		Hanover Displays Limited
+				Unit 24
+				Lewes  East Sussex  BN8 6JL
+				GB
+
+7C-0A-50   (hex)		J-MEX Inc.
+7C0A50     (base 16)		J-MEX Inc.
+				B2, 3F, No.1, Li-Hsin 1st Road,
+				Hsinchu  Taiwan  300
+				TW
+
+50-11-EB   (hex)		SilverNet Ltd
+5011EB     (base 16)		SilverNet Ltd
+				16 Cocran Close
+				Milton Keynes  Bucks  MK8 0AJ
+				GB
+
+54-DF-63   (hex)		Intrakey technologies GmbH
+54DF63     (base 16)		Intrakey technologies GmbH
+				Wiener Strasse 114-116
+				Dresden  Saxony  01219
+				DE
+
+40-F2-E9   (hex)		IBM
+40F2E9     (base 16)		IBM
+				3039 E Cornwallis Rd
+				Research Triangle Park  NC  27709
+				US
+
+74-4D-79   (hex)		Arrive Systems Inc.
+744D79     (base 16)		Arrive Systems Inc.
+				1404 Franklin Street, # 350 
+				Oakland  CA  94612
+				US
+
+9C-04-73   (hex)		Tecmobile (International) Ltd. 
+9C0473     (base 16)		Tecmobile (International) Ltd. 
+				Unit L, Braintree Industrial Estate, 
+				    HA4 0EJ 
+				GB
+
+B4-DF-FA   (hex)		Litemax Electronics Inc.
+B4DFFA     (base 16)		Litemax Electronics Inc.
+				8F, No.137,Lane 235
+				Shin-dian-Dist  New Taipei  23145
+				TW
+
+68-1C-A2   (hex)		Rosewill Inc.
+681CA2     (base 16)		Rosewill Inc.
+				17708 Rowland St.,
+				City of Industry  CA  91748
+				US
+
+60-46-16   (hex)		XIAMEN VANN INTELLIGENT CO., LTD
+604616     (base 16)		XIAMEN VANN INTELLIGENT CO., LTD
+				UNIT 101£¬NO.28 GUANRI RD., SOFTWARE PARK ¢ò
+				XIAMEN  FUJIAN  361009
+				CN
+
+E4-56-14   (hex)		Suttle Apparatus
+E45614     (base 16)		Suttle Apparatus
+				1001 East Highway 212
+				Hector  MN  55342
+				US
+
+3C-83-B5   (hex)		Advance Vision Electronics Co. Ltd.
+3C83B5     (base 16)		Advance Vision Electronics Co. Ltd.
+				6F, No. 199, Lide St. Jhonghe Dist
+				New Taipei City, Jhonghe Dist    23556
+				TW
+
+28-A1-92   (hex)		GERP Solution
+28A192     (base 16)		GERP Solution
+				Rua Costa Aguiar, 1710
+				São Paulo  SP  04204002
+				BR
+
+10-6F-EF   (hex)		Ad-Sol Nissin Corp
+106FEF     (base 16)		Ad-Sol Nissin Corp
+				Rivage Shinagawa, 4-1-8 Kounan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+6C-40-C6   (hex)		Nimbus Data, Inc.
+6C40C6     (base 16)		Nimbus Data, Inc.
+				5151 California Ave, Ste 100
+				Irvine  CA  92617
+				US
+
+10-48-B1   (hex)		Beijing Duokan Technology Limited
+1048B1     (base 16)		Beijing Duokan Technology Limited
+				Room 1105, Changxin Building, No.39 Anding Road
+				Chaoyang District  Beijing  100029
+				CN
+
+D4-93-A0   (hex)		Fidelix Oy
+D493A0     (base 16)		Fidelix Oy
+				Martinkyläntie 41
+				VANTAA  International  01720
+				FI
+
+08-EB-ED   (hex)		World Elite Technology Co.,LTD
+08EBED     (base 16)		World Elite Technology Co.,LTD
+				6/F Liyuan floor ,Dragon City North Road on the 3rd
+				ShenZhen  GuangDong  518100
+				CN
+
+DC-9F-A4   (hex)		Nokia Corporation
+DC9FA4     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+44-C3-9B   (hex)		OOO RUBEZH NPO
+44C39B     (base 16)		OOO RUBEZH NPO
+				Pionerskaya 11a
+				Bratsk  Irkutsk  665717
+				RU
+
+C4-45-67   (hex)		SAMBON PRECISON and ELECTRONICS
+C44567     (base 16)		SAMBON PRECISON and ELECTRONICS
+				204, Samjeong-dong, Ojeong-gu
+				Bucheon-city   Kyeonggi-do  421-810
+				KR
+
+48-F8-B3   (hex)		Cisco-Linksys, LLC
+48F8B3     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+D8-D2-7C   (hex)		JEMA ENERGY, SA
+D8D27C     (base 16)		JEMA ENERGY, SA
+				Pº Circuito nº10
+				Lasarte-Oria  Guipuzcoa  20160
+				ES
+
+B0-12-03   (hex)		Dynamics Hong Kong Limited
+B01203     (base 16)		Dynamics Hong Kong Limited
+				Room A4, 3/F, Friend's House , No.6A Carnarvon Road,
+				    999077
+				HK
+
+98-86-B1   (hex)		Flyaudio corporation (China)
+9886B1     (base 16)		Flyaudio corporation (China)
+				No.16 Mingzhu RD Economic&Technology
+				Guangzhou  Guangdong Province  510730
+				CN
+
+70-93-F8   (hex)		Space Monkey, Inc.
+7093F8     (base 16)		Space Monkey, Inc.
+				7707 south main street
+				Midvale  Utah  84047
+				US
+
+28-B3-AB   (hex)		Genmark Automation
+28B3AB     (base 16)		Genmark Automation
+				1201 Cadillac Ct
+				Milpitas  CA  95035
+				US
+
+C4-E7-BE   (hex)		SCSpro Co.,Ltd
+C4E7BE     (base 16)		SCSpro Co.,Ltd
+				#1203, KCC welltz valley 470-8
+				Seoul  Korea  153-710
+				KR
+
+58-87-4C   (hex)		LITE-ON CLEAN ENERGY TECHNOLOGY CORP.
+58874C     (base 16)		LITE-ON CLEAN ENERGY TECHNOLOGY CORP.
+				3F, 392, Ruey Kuang Road, Neihu,
+				Taipei    11492
+				TW
+
+28-91-D0   (hex)		Stage Tec Entwicklungsgesellschaft für professionelle Audiotechnik mbH
+2891D0     (base 16)		Stage Tec Entwicklungsgesellschaft für professionelle Audiotechnik mbH
+				Tabbertstraße 10
+				Berlin    12459
+				DE
+
+C0-BD-42   (hex)		ZPA Smart Energy a.s.
+C0BD42     (base 16)		ZPA Smart Energy a.s.
+				Komenskeho 821
+				Trutnov    54101
+				CZ
+
+FC-52-CE   (hex)		Control iD
+FC52CE     (base 16)		Control iD
+				Rua Hungria, 574
+				São Paulo  SP  01455-000
+				BR
+
+5C-4A-26   (hex)		Enguity Technology Corp
+5C4A26     (base 16)		Enguity Technology Corp
+				2020 Pennsylvania Ave., NW
+				Washington  DC  20006
+				US
+
+60-F2-EF   (hex)		VisionVera International Co., Ltd.
+60F2EF     (base 16)		VisionVera International Co., Ltd.
+				A1103 Gehua Building
+				  Beijing  100007
+				CN
+
+C0-3F-2A   (hex)		Biscotti, Inc.
+C03F2A     (base 16)		Biscotti, Inc.
+				5900 South Lake Forest Drive
+				McKinney  TX  75070
+				US
+
+38-1C-4A   (hex)		SIMCom Wireless Solutions Co.,Ltd.
+381C4A     (base 16)		SIMCom Wireless Solutions Co.,Ltd.
+				Building A,SIM Technology Building,No.633,Jinzhong Road,
+				  Shanghai  200335
+				CN
+
+D8-C6-91   (hex)		Hichan Technology Corp.
+D8C691     (base 16)		Hichan Technology Corp.
+				12F., No.2, Jian 8th Rd., Zhonghe Dist
+				New Taipei City    23511
+				TW
+
+E4-3F-A2   (hex)		Wuxi DSP Technologies Inc.
+E43FA2     (base 16)		Wuxi DSP Technologies Inc.
+				Rm A801,530Mansion,International High-Tech Park,Qingyuan Road
+				Wuxi  Jiangsu  214000
+				US
+
+F4-B7-2A   (hex)		TIME INTERCONNECT LTD
+F4B72A     (base 16)		TIME INTERCONNECT LTD
+				6/F, Photonics Centre
+				    
+				HK
+
+74-99-75   (hex)		IBM Corporation
+749975     (base 16)		IBM Corporation
+				4400 North First Street
+				San Jose  CA  95134
+				US
+
+2C-62-5A   (hex)		Finest Security Systems Co., Ltd
+2C625A     (base 16)		Finest Security Systems Co., Ltd
+				12F, No.103, Sec3, Nan King E. RD
+				Taipei    104
+				US
+
+20-74-CF   (hex)		Shenzhen Voxtech Co.,Ltd
+2074CF     (base 16)		Shenzhen Voxtech Co.,Ltd
+				4/F East, Building 4, Minqi Science&Technology Park, Pingshan,
+				Shenzhen  Guangdong  518055
+				CN
+
+E0-F5-CA   (hex)		CHENG UEI PRECISION INDUSTRY CO.,LTD.
+E0F5CA     (base 16)		CHENG UEI PRECISION INDUSTRY CO.,LTD.
+				No. 18, ZhongShan Rd., TuCheng Dist.,
+				New Taipei City  Taiwan  23680
+				TW
+
+A8-EF-26   (hex)		Tritonwave
+A8EF26     (base 16)		Tritonwave
+				795 Lakeshore Dr, Suite 307
+				  Quebec  H9S 0A8
+				CA
+
+20-DC-93   (hex)		Cheetah Hi-Tech, Inc.
+20DC93     (base 16)		Cheetah Hi-Tech, Inc.
+				Rm 804, No. 5, Sec. 2, Anhe Rd.
+				Taipei  Taiwan  10680
+				TW
+
+44-23-AA   (hex)		Farmage Co., Ltd.
+4423AA     (base 16)		Farmage Co., Ltd.
+				166-8 Kanazawa Toubetsu
+				  Hokkaido  061-0212
+				JP
+
+7C-FE-28   (hex)		Salutron Inc.
+7CFE28     (base 16)		Salutron Inc.
+				40979 Encyclopedia Circle
+				Fremont  CA  94538
+				US
+
+E8-10-2E   (hex)		Really Simple Software, Inc
+E8102E     (base 16)		Really Simple Software, Inc
+				P.O. Box 1086
+				Tiburon  California  94920
+				US
+
+0C-56-5C   (hex)		HyBroad Vision (Hong Kong) Technology Co Ltd
+0C565C     (base 16)		HyBroad Vision (Hong Kong) Technology Co Ltd
+				Unit 1808 18/F Tower 3 Enterprise Square
+				Kowloon Bay    
+				HK
+
+8C-6A-E4   (hex)		Viogem Limited
+8C6AE4     (base 16)		Viogem Limited
+				Paddock House
+				Orlingbury  Northamptonshire  NN141JH
+				GB
+
+54-39-68   (hex)		Edgewater Networks Inc
+543968     (base 16)		Edgewater Networks Inc
+				2895 Northwestern Parkway
+				Santa Clara  CA  95051
+				US
+
+44-0C-FD   (hex)		NetMan Co., Ltd.
+440CFD     (base 16)		NetMan Co., Ltd.
+				Rm 406, DIP, 2139, Daemyeong-dong,
+				Daegu    705-701
+				KR
+
+8C-D3-A2   (hex)		VisSim AS
+8CD3A2     (base 16)		VisSim AS
+				Vollveien 5
+				Horten  Vestfold  3183
+				NO
+
+D8-2D-E1   (hex)		Tricascade Inc.
+D82DE1     (base 16)		Tricascade Inc.
+				5020 Campus Drv.
+				Newport Beach  CA  92660
+				US
+
+14-35-8B   (hex)		Mediabridge Products, LLC.
+14358B     (base 16)		Mediabridge Products, LLC.
+				1951 Old Cuthbert Rd
+				Cherry Hill  New Jersey  08034
+				US
+
+00-F4-03   (hex)		Orbis Systems Oy
+00F403     (base 16)		Orbis Systems Oy
+				Taivaltie 5
+				Vantaa    01610
+				FI
+
+54-73-98   (hex)		Toyo Electronics Corporation
+547398     (base 16)		Toyo Electronics Corporation
+				1860-38, Simoakasaka
+				Kawagoe  Saitama  3501155
+				JP
+
+E0-A3-0F   (hex)		Pevco
+E0A30F     (base 16)		Pevco
+				1401 Tangier Drive
+				Baltimore  MD  21220
+				US
+
+88-DC-96   (hex)		SENAO Networks, Inc.
+88DC96     (base 16)		SENAO Networks, Inc.
+				No. 500, Fusing 3rd Rd., Hwa-Ya Technology Park
+				Kuei-Shan Hsiang  TaoYuan County  333
+				TW
+
+20-44-3A   (hex)		Schneider Electric Asia Pacific Ltd
+20443A     (base 16)		Schneider Electric Asia Pacific Ltd
+				13F East Wing, Warwick House, Taikoo Place
+				Quarry Bay    
+				HK
+
+C4-39-3A   (hex)		SMC Networks Inc
+C4393A     (base 16)		SMC Networks Inc
+				20 Mason
+				Irvine  CA  92618
+				US
+
+5C-24-79   (hex)		Baltech AG
+5C2479     (base 16)		Baltech AG
+				Lilienthalstrasse 27
+				Hallbergmoos    85399
+				DE
+
+EC-93-27   (hex)		MEMMERT GmbH + Co. KG
+EC9327     (base 16)		MEMMERT GmbH + Co. KG
+				Aeussere Rittersbacher Strasse 38
+				Schwabach  Bavaria  91126
+				DE
+
+A0-EF-84   (hex)		Seine Image Int'l Co., Ltd
+A0EF84     (base 16)		Seine Image Int'l Co., Ltd
+				6F,4Building, NO.63,Mingz North Road
+				ZhuHai    519075
+				CN
+
+64-51-7E   (hex)		LONG BEN (DONGGUAN) ELECTRONIC TECHNOLOGY CO.,LTD.
+64517E     (base 16)		LONG BEN (DONGGUAN) ELECTRONIC TECHNOLOGY CO.,LTD.
+				NO.19.Jian she Road,Shi ma Village,Tang xia  Town,Dong guan,Guang dong,China
+				Dong guan  Guang dong  523731
+				CN
+
+D4-3D-7E   (hex)		Micro-Star Int'l Co, Ltd
+D43D7E     (base 16)		Micro-Star Int'l Co, Ltd
+				No.69, Lide St., Jhonghe City
+				Taipei County    235
+				US
+
+AC-D9-D6   (hex)		tci GmbH
+ACD9D6     (base 16)		tci GmbH
+				Ludwig-Rinn-Straße 10-14
+				Heuchelheim  Hessen  35452
+				US
+
+48-28-2F   (hex)		zte corporation
+48282F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+60-CB-FB   (hex)		AirScape Inc.
+60CBFB     (base 16)		AirScape Inc.
+				625 Charles Way
+				Medford  OR  97501
+				US
+
+7C-16-0D   (hex)		Saia-Burgess Controls AG
+7C160D     (base 16)		Saia-Burgess Controls AG
+				Bahnhofstrasse 18
+				Murten  FR  3280
+				CH
+
+A4-97-BB   (hex)		Hitachi Industrial Equipment Systems Co.,Ltd
+A497BB     (base 16)		Hitachi Industrial Equipment Systems Co.,Ltd
+				3, Kanda Neribei-cho
+				Chiyoda-ku  Tokyo  101-0022
+				US
+
+4C-54-27   (hex)		Linepro Sp. z o.o.
+4C5427     (base 16)		Linepro Sp. z o.o.
+				ul. Miedziana 11
+				Warszawa  mazowieckie  00-835
+				PL
+
+80-D1-8B   (hex)		Hangzhou I'converge Technology Co.,Ltd
+80D18B     (base 16)		Hangzhou I'converge Technology Co.,Ltd
+				No.618 Xixi Road,
+				Hangzhou  Zhejiang  310012
+				CN
+
+40-88-E0   (hex)		Beijing Ereneben Information Technology Limited Shenzhen Branch
+4088E0     (base 16)		Beijing Ereneben Information Technology Limited Shenzhen Branch
+				Room 14A, Building A, Honglong Central Plaza, No.3001,Heping Road, Luohu District, Shenzhen City
+				Shenzhen  Guangdong  518001
+				CN
+
+E8-54-84   (hex)		NEO Information Systems Co., Ltd.
+E85484     (base 16)		NEO Information Systems Co., Ltd.
+				609, Junganginduspia, #517-13, Sangdaeweon-Dong, Jungweon-Gu
+				Seongnam  Gyunggi-Do  462-713
+				KR
+
+74-AE-76   (hex)		iNovo Broadband, Inc.
+74AE76     (base 16)		iNovo Broadband, Inc.
+				3475 Corporate Way
+				Duluth  Georgia  30096
+				US
+
+EC-1A-59   (hex)		Belkin International Inc.
+EC1A59     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  Ca.   90094
+				US
+
+88-10-36   (hex)		Panodic(ShenZhen) Electronics Limted
+881036     (base 16)		Panodic(ShenZhen) Electronics Limted
+				Floor 12, Grentech Building, Keji.C. Road 
+				ShenZhen  GuangDong   518052
+				CN
+
+68-B6-FC   (hex)		Hitron Technologies. Inc
+68B6FC     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+EC-A2-9B   (hex)		Kemppi Oy
+ECA29B     (base 16)		Kemppi Oy
+				Kempinkatu 1
+				Lahti  Lahti  15810
+				FI
+
+04-CE-14   (hex)		Wilocity LTD.
+04CE14     (base 16)		Wilocity LTD.
+				21 Bareket St.
+				Caesarea  Israel  38900
+				US
+
+C4-BA-99   (hex)		I+ME Actia Informatik und Mikro-Elektronik GmbH
+C4BA99     (base 16)		I+ME Actia Informatik und Mikro-Elektronik GmbH
+				Dresdenstrasse 17/18
+				Braunschweig  Niedersachsen  38690
+				DE
+
+A4-93-4C   (hex)		Cisco Systems, Inc
+A4934C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D0-D2-12   (hex)		K2NET Co.,Ltd.
+D0D212     (base 16)		K2NET Co.,Ltd.
+				K2Net Building
+				  Seoul  158-092
+				KR
+
+B0-43-5D   (hex)		NuLEDs, Inc.
+B0435D     (base 16)		NuLEDs, Inc.
+				1497 Poinsettia Ave.
+				Vista  CA  92081
+				US
+
+08-08-EA   (hex)		AMSC
+0808EA     (base 16)		AMSC
+				15775 W Schaefer Court
+				New Berlin  WI  53151
+				US
+
+E8-D4-83   (hex)		ULTIMATE Europe Transportation Equipment GmbH
+E8D483     (base 16)		ULTIMATE Europe Transportation Equipment GmbH
+				Industriestraße 3
+				3300  Niederösterreich  3300
+				AT
+
+1C-84-64   (hex)		FORMOSA WIRELESS COMMUNICATION CORP.
+1C8464     (base 16)		FORMOSA WIRELESS COMMUNICATION CORP.
+				11F., No.3-2, Yuanqu St., Nangang Dist.,
+				  Taipei City  115
+				TW
+
+34-6E-8A   (hex)		Ecosense
+346E8A     (base 16)		Ecosense
+				1414 Kolon science vallet-II., #811
+				Seoul  Guro-gu  152-878
+				KR
+
+64-F2-42   (hex)		Gerdes Aktiengesellschaft
+64F242     (base 16)		Gerdes Aktiengesellschaft
+				Bergerwiesenstraße 9
+				Meckenheim  NRW  53340
+				DE
+
+60-F2-81   (hex)		TRANWO TECHNOLOGY CO., LTD.
+60F281     (base 16)		TRANWO TECHNOLOGY CO., LTD.
+				No.236, Sec.3, Huanbei Rd.
+				Jubei City  Hsinchu County  30265
+				TW
+
+94-21-97   (hex)		Stalmart Technology Limited
+942197     (base 16)		Stalmart Technology Limited
+				Rm1106-1107E, Building F, Xihaimingzhu, No.1, Taoyuan Road
+				Shenzhen  Gunagdong  518052
+				CN
+
+A0-C3-DE   (hex)		Triton Electronic Systems Ltd.
+A0C3DE     (base 16)		Triton Electronic Systems Ltd.
+				620063, Ekaterinburg, P/O box 522
+				Ekaterinburg  Sverdlovskaya obl.  620063
+				RU
+
+D0-69-9E   (hex)		LUMINEX Lighting Control Equipment
+D0699E     (base 16)		LUMINEX Lighting Control Equipment
+				Berkenlaan 8 A
+				Hechtel - Eksel  Limburg  3940
+				BE
+
+0C-C0-C0   (hex)		MAGNETI MARELLI SISTEMAS ELECTRONICOS MEXICO
+0CC0C0     (base 16)		MAGNETI MARELLI SISTEMAS ELECTRONICOS MEXICO
+				AV. INDUSTRIA 20/21
+				TEPOTZOTLAN  MEXICO  54600
+				MX
+
+08-37-9C   (hex)		Topaz Co. LTD.
+08379C     (base 16)		Topaz Co. LTD.
+				B305-22, Acrotower, 1591 Gwanyang-dong
+				Anyang-si  Gyeonggi-Do  431-060
+				KR
+
+D8-0D-E3   (hex)		FXI TECHNOLOGIES AS
+D80DE3     (base 16)		FXI TECHNOLOGIES AS
+				Postboks 609
+				TRONDHEIM  Norge  7406
+				NO
+
+B0-D2-F5   (hex)		Vello Systems, Inc.
+B0D2F5     (base 16)		Vello Systems, Inc.
+				1530 O'Brien Drive
+				Menlo Park  California  94025
+				US
+
+70-9A-0B   (hex)		Italian Institute of Technology
+709A0B     (base 16)		Italian Institute of Technology
+				Via Morego 30
+				Genova  GE  16163
+				IT
+
+F0-FD-A0   (hex)		Acurix Networks Pty Ltd
+F0FDA0     (base 16)		Acurix Networks Pty Ltd
+				Unit 5, 348 Victoria Road,
+				Malaga, Perth  Western Austraila  6090
+				NZ
+
+B4-55-70   (hex)		Borea
+B45570     (base 16)		Borea
+				Mlaka 1b
+				Begunje    SI-4275
+				SI
+
+10-0D-2F   (hex)		Online Security Pty. Ltd.
+100D2F     (base 16)		Online Security Pty. Ltd.
+				5/21-25 Redland Drive
+				Mitcham  VIC  3132
+				AU
+
+14-2D-F5   (hex)		Amphitech
+142DF5     (base 16)		Amphitech
+				1, rue Robert & Sonia DELAUNAY
+				Paris    75011
+				FR
+
+50-57-A8   (hex)		Cisco Systems, Inc
+5057A8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-DE-FB   (hex)		Cisco Systems, Inc
+00DEFB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-A3-15   (hex)		Bless Information & Communications Co., Ltd
+3CA315     (base 16)		Bless Information & Communications Co., Ltd
+				#64-1, Wonhyoro 3-ga, Yongsan-gu,
+				Seoul    140-848
+				KR
+
+F8-30-94   (hex)		Alcatel-Lucent Telecom Limited
+F83094     (base 16)		Alcatel-Lucent Telecom Limited
+				The Quadrant, Stonehill Green 
+				SWINDON    SN5 7DJ
+				GB
+
+10-A9-32   (hex)		Beijing Cyber Cloud Technology Co. ,Ltd.
+10A932     (base 16)		Beijing Cyber Cloud Technology Co. ,Ltd.
+				2/F, Tower B, Jingmeng High-tech Building. No. 5 Shangdi East Road, Haidian District.
+				Beijing    100085
+				CN
+
+34-FC-6F   (hex)		ALCEA
+34FC6F     (base 16)		ALCEA
+				3 Rue Joly de Bammeville
+				91460  Marcoussis  
+				FR
+
+C0-B3-57   (hex)		Yoshiki Electronics Industry Ltd.
+C0B357     (base 16)		Yoshiki Electronics Industry Ltd.
+				Ooicyoyo Building 7f
+				Shinagawa-ku  Tokyo  140-0011
+				JP
+
+3C-98-BF   (hex)		Quest Controls, Inc.
+3C98BF     (base 16)		Quest Controls, Inc.
+				208 9th Street Dr. West
+				Palmetto  FL  34221
+				US
+
+D0-AE-EC   (hex)		Alpha Networks Inc.
+D0AEEC     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing 7th Rd., Science-based Industrial Park, Hsinchu, Taiwan, R.O.C
+				Hsinchu  Taiwan  300
+				TW
+
+E8-13-24   (hex)		GuangZhou Bonsoninfo System CO.,LTD
+E81324     (base 16)		GuangZhou Bonsoninfo System CO.,LTD
+				4/F,NO.1029/31,GaoPu Road,GaoTang New Building District
+				Guangzhou  Guangdong  510663
+				CN
+
+E4-77-D4   (hex)		Minrray Industry Co.,Ltd 
+E477D4     (base 16)		Minrray Industry Co.,Ltd 
+				C5, Building 2, ZhongHaiXin  ,Science&Technology Park, Ganli Rd, LiLang Blvd., Buji
+				Shenzhen  GuangDong  518112
+				CN
+
+38-E0-8E   (hex)		Mitsubishi Electric Corporation
+38E08E     (base 16)		Mitsubishi Electric Corporation
+				2-7-3 Marunouchi Chiyoda-ku
+				Tokyo    100-8310
+				JP
+
+E4-C8-06   (hex)		Ceiec Electric Technology Inc.
+E4C806     (base 16)		Ceiec Electric Technology Inc.
+				8/F West Side, Building 201, Terra Industrial & Tradepark, Che Gong Miao,
+				Shenzhen  Guangdong  518040
+				CN
+
+E0-F9-BE   (hex)		Cloudena Corp.
+E0F9BE     (base 16)		Cloudena Corp.
+				6F., No. 5, Alley 22, Lane 513
+				Taipei City    114
+				TW
+
+B8-8F-14   (hex)		Analytica GmbH
+B88F14     (base 16)		Analytica GmbH
+				Vorholzstraße 36
+				Karlsruhe  Baden-Württemberg  76137
+				DE
+
+7C-94-B2   (hex)		Philips Healthcare PCCI
+7C94B2     (base 16)		Philips Healthcare PCCI
+				2271 Cosmos Ct
+				Carlsbad  CA  92011
+				US
+
+44-2B-03   (hex)		Cisco Systems, Inc
+442B03     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-73-CA   (hex)		Conversion Sound Inc.
+F473CA     (base 16)		Conversion Sound Inc.
+				960 N. Northwest Hwy
+				Park Ridge  IL  60068
+				US
+
+F8-F7-FF   (hex)		SYN-TECH SYSTEMS INC
+F8F7FF     (base 16)		SYN-TECH SYSTEMS INC
+				100 FOUR POINTS WAY
+				TALLAHASSEE  FL  32305
+				US
+
+A8-17-58   (hex)		Elektronik System i Umeå AB
+A81758     (base 16)		Elektronik System i Umeå AB
+				Box 7978
+				Umeå  Västerbotten  907 19
+				SE
+
+88-20-12   (hex)		LMI Technologies
+882012     (base 16)		LMI Technologies
+				1673 Cliveden Avenue
+				Delta  British Columbia  V3M 6V5
+				CA
+
+60-E9-56   (hex)		Ayla Networks, Inc
+60E956     (base 16)		Ayla Networks, Inc
+				218 Morgan Lane
+				Menlo Park  CA  94025
+				US
+
+EC-11-20   (hex)		FloDesign Wind Turbine Corporation
+EC1120     (base 16)		FloDesign Wind Turbine Corporation
+				Papirfabrikken 28
+				Silkeborg    8600
+				DK
+
+F8-97-CF   (hex)		DAESHIN-INFORMATION TECHNOLOGY CO., LTD.
+F897CF     (base 16)		DAESHIN-INFORMATION TECHNOLOGY CO., LTD.
+				6F, Chungwon Bldg., 828-5 Yuksam-Dong,Kangnam-Gu,
+				Seoul    135935
+				KR
+
+08-B4-CF   (hex)		Abicom International
+08B4CF     (base 16)		Abicom International
+				The Old Grammar School
+				Market Drayton  Shropshire  TF9 1JR
+				GB
+
+C4-95-A2   (hex)		SHENZHEN WEIJIU INDUSTRY AND TRADE DEVELOPMENT CO., LTD
+C495A2     (base 16)		SHENZHEN WEIJIU INDUSTRY AND TRADE DEVELOPMENT CO., LTD
+				ROOM 1713,BAOHUA BUILDING, HUAQIANG NORTH ROAD, FUTIAN DISTRICT, 
+				SHENZHEN  GUANGDONG  518031
+				CN
+
+8C-68-78   (hex)		Nortek-AS
+8C6878     (base 16)		Nortek-AS
+				Vangkroken 2
+				  Akreshus  1351 RUD
+				NO
+
+20-25-98   (hex)		Teleview
+202598     (base 16)		Teleview
+				#401 Sehwa, 355-1
+				Sungnam  Gyeonggi  463-828
+				KR
+
+38-F8-B7   (hex)		V2COM PARTICIPACOES S.A.
+38F8B7     (base 16)		V2COM PARTICIPACOES S.A.
+				Rua Cunha Gago, 700
+				São Paulo    05421001
+				BR
+
+F8-D4-62   (hex)		Pumatronix Equipamentos Eletronicos Ltda.
+F8D462     (base 16)		Pumatronix Equipamentos Eletronicos Ltda.
+				Rua Bartolomeu Lourenco de Gusmao 2021
+				Curitiba  PR  81650050
+				BR
+
+A0-DC-04   (hex)		Becker-Antriebe GmbH
+A0DC04     (base 16)		Becker-Antriebe GmbH
+				Friedrich-Ebert-Straße 2 - 4
+				35764 Sinn  Hessen  DE811177977
+				DE
+
+40-60-5A   (hex)		Hawkeye Tech Co. Ltd
+40605A     (base 16)		Hawkeye Tech Co. Ltd
+				13F-5, No. 736 Chung Cheng Road, Chung He
+				New Taipei    23511
+				TW
+
+A0-4C-C1   (hex)		Helixtech Corp.
+A04CC1     (base 16)		Helixtech Corp.
+				6F Lions bldg., 160-2 Gangnam-daero,
+				Seoul    137-888
+				KR
+
+34-A7-BA   (hex)		Fischer International Systems Corporation
+34A7BA     (base 16)		Fischer International Systems Corporation
+				5801 Pelican Bay Boulevard #300
+				Naples  Florida  34108
+				US
+
+04-63-E0   (hex)		Nome Oy
+0463E0     (base 16)		Nome Oy
+				Lunkintie 9
+				Oulunsalo  Oulun lللni  90460
+				FI
+
+B4-9E-E6   (hex)		SHENZHEN TECHNOLOGY CO LTD
+B49EE6     (base 16)		SHENZHEN TECHNOLOGY CO LTD
+				NO34 SHILONG RD
+				SHENZHEN  GUANGDONG  91732
+				CN
+
+BC-4B-79   (hex)		SensingTek
+BC4B79     (base 16)		SensingTek
+				2F, No.6-2,Dusing Rd.,Hsinchu Science Park, 
+				Hsinchu    30078
+				TW
+
+A4-90-05   (hex)		CHINA GREATWALL COMPUTER SHENZHEN CO.,LTD
+A49005     (base 16)		CHINA GREATWALL COMPUTER SHENZHEN CO.,LTD
+				409,2#,Greatwall Bldg,No.3 Kefa Road,Science & Industry Park,Nanshan District,
+				Shenzhen  Guangdong  51807
+				CN
+
+C4-0A-CB   (hex)		Cisco Systems, Inc
+C40ACB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E8-6D-6E   (hex)		voestalpine SIGNALING Fareham Ltd.
+E86D6E     (base 16)		voestalpine SIGNALING Fareham Ltd.
+				Unit 1, Fulcrum 4, Solent Way
+				Whiteley  Hampshire  PO15 7FT
+				GB
+
+68-16-05   (hex)		Systems And Electronic Development FZCO
+681605     (base 16)		Systems And Electronic Development FZCO
+				Roundabout no. 8
+				Jebel Ali free Zone  Dubai  P.O.Box 61129
+				AE
+
+D4-A0-2A   (hex)		Cisco Systems, Inc
+D4A02A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-4E-47   (hex)		Etronic A/S
+3C4E47     (base 16)		Etronic A/S
+				Rødeledsvej 95
+				Svendborg  South Denmark  5700
+				DK
+
+F4-87-71   (hex)		Infoblox
+F48771     (base 16)		Infoblox
+				4750 Patrick Henry Drive
+				Santa Clara  California  95054
+				US
+
+54-53-ED   (hex)		Sony Corporation
+5453ED     (base 16)		Sony Corporation
+				Gotenyama Tec 5-1-2
+				Tokyo  Shinagawa-ku  141-0001
+				JP
+
+00-37-6D   (hex)		Murata Manufacturing Co., Ltd.
+00376D     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+50-00-8C   (hex)		Hong Kong Telecommunications (HKT) Limited
+50008C     (base 16)		Hong Kong Telecommunications (HKT) Limited
+				41/F, PCCW Tower, Taikoo Place,
+				    
+				HK
+
+90-2B-34   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+902B34     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, 
+				Pin-Jen  Taoyuan  324
+				TW
+
+88-C3-6E   (hex)		Beijing Ereneben lnformation Technology Limited
+88C36E     (base 16)		Beijing Ereneben lnformation Technology Limited
+				Room 14F,Building F,Honglong Central Plaza,NO,3001,Heping Road,LuoHu 
+				ShenZhen  GuangDong  518110
+				CN
+
+4C-9E-80   (hex)		KYOKKO ELECTRIC Co., Ltd.
+4C9E80     (base 16)		KYOKKO ELECTRIC Co., Ltd.
+				5-7-20, Motomachi-dori, Chuo-Ku
+				Kobe  Hyogo  6500022
+				JP
+
+5C-EB-4E   (hex)		R. STAHL HMI Systems GmbH
+5CEB4E     (base 16)		R. STAHL HMI Systems GmbH
+				Im Gewerbegebiet Pesch 14
+				Cologne    50767
+				DE
+
+34-AA-99   (hex)		Nokia
+34AA99     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+64-55-63   (hex)		Intelight Inc.
+645563     (base 16)		Intelight Inc.
+				3450 S Broadmont Drive  #126
+				Tucson  Arizona  85713
+				US
+
+94-3A-F0   (hex)		Nokia Corporation
+943AF0     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+64-54-22   (hex)		Equinox Payments
+645422     (base 16)		Equinox Payments
+				8888 E. Raintree Dr., Suite 300
+				Scottsdale  Arizona  85260
+				US
+
+08-0D-84   (hex)		GECO, Inc.
+080D84     (base 16)		GECO, Inc.
+				1754 N. 48th St.
+				Mesa  AZ  85205
+				US
+
+88-E7-12   (hex)		Whirlpool Corporation
+88E712     (base 16)		Whirlpool Corporation
+				750 Monte Dr.
+				Benton Harbor  Michigan  49022
+				US
+
+D4-12-BB   (hex)		Quadrant Components Inc. Ltd
+D412BB     (base 16)		Quadrant Components Inc. Ltd
+				Unit 5, 17/F, Metro Loft,
+				Kwai Chung,  New Territory  
+				HK
+
+24-B8-8C   (hex)		Crenus Co.,Ltd.
+24B88C     (base 16)		Crenus Co.,Ltd.
+				Mario Tower 814, 222-12
+				Seoul    152-050
+				KR
+
+BC-FE-8C   (hex)		Altronic, LLC
+BCFE8C     (base 16)		Altronic, LLC
+				712 Trumbull Ave
+				Girard  Ohio  44420
+				US
+
+64-9E-F3   (hex)		Cisco Systems, Inc
+649EF3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-BB-C1   (hex)		Absolute Analysis
+24BBC1     (base 16)		Absolute Analysis
+				2393 Teller Road Ste #109
+				Newbury Park  California  91320
+				US
+
+9C-CA-D9   (hex)		Nokia Corporation
+9CCAD9     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+04-6D-42   (hex)		Bryston Ltd.
+046D42     (base 16)		Bryston Ltd.
+				P.O. Box 2170
+				Peterborough  Ontario  K9J  7Y4
+				CA
+
+D8-E7-43   (hex)		Wush, Inc
+D8E743     (base 16)		Wush, Inc
+				17F.No 268, Liancheng Rd., Zhonghe District
+				New  Taipei City     235
+				TW
+
+64-4D-70   (hex)		dSPACE GmbH
+644D70     (base 16)		dSPACE GmbH
+				Rathenaustraße 26
+				Paderborn    33102
+				DE
+
+DC-C1-01   (hex)		SOLiD Technologies, Inc.
+DCC101     (base 16)		SOLiD Technologies, Inc.
+				9th Floor, SOLiD Space, Pangyoyeok-ro 220
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+3C-E6-24   (hex)		LG Display 
+3CE624     (base 16)		LG Display 
+				9th, Fl., LG U+ building, 65-228, Hangangro, 3-ga, Yongsan-gu
+				Seoul    140-716
+				KR
+
+D8-F0-F2   (hex)		Zeebo Inc
+D8F0F2     (base 16)		Zeebo Inc
+				5405 Morehouse Drive
+				San Diego  California  92121
+				US
+
+80-60-07   (hex)		RIM
+806007     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+38-A8-51   (hex)		Moog, Ing
+38A851     (base 16)		Moog, Ing
+				3650 Woodhead Drive
+				Northbrook  IL  60062
+				US
+
+94-E0-D0   (hex)		HealthStream Taiwan Inc.
+94E0D0     (base 16)		HealthStream Taiwan Inc.
+				16-3, Zichiang 1st Road
+				Jhongli, Taoyuan county    32063
+				TW
+
+D8-05-2E   (hex)		Skyviia Corporation
+D8052E     (base 16)		Skyviia Corporation
+				No. 10-1, Lixing 1st Rd., Science Park,
+				Hsinchu City    300
+				TW
+
+80-94-6C   (hex)		TOKYO RADAR CORPORATION
+80946C     (base 16)		TOKYO RADAR CORPORATION
+				15-7 Nishikubo-cho
+				Hodogaya-ku, Yokohama-shi  Kanagawa  240-0022
+				JP
+
+D0-CF-5E   (hex)		Energy Micro AS
+D0CF5E     (base 16)		Energy Micro AS
+				Sandakerveien 118
+				Oslo    N-0484
+				NO
+
+18-03-FA   (hex)		IBT Interfaces
+1803FA     (base 16)		IBT Interfaces
+				Im Taubhaus 19
+				Roedermark  Hessen  63322
+				DE
+
+30-6E-5C   (hex)		Validus Technologies
+306E5C     (base 16)		Validus Technologies
+				420 North Main Street
+				East Peoria  Illinois  61611
+				US
+
+C8-94-D2   (hex)		Jiangsu Datang  Electronic Products Co., Ltd
+C894D2     (base 16)		Jiangsu Datang  Electronic Products Co., Ltd
+				NO.20
+				Nanjing  Jiangsu  211800
+				CN
+
+C8-A6-20   (hex)		Nebula, Inc
+C8A620     (base 16)		Nebula, Inc
+				215 Castro St
+				Mountain View  CA  94041
+				US
+
+EC-62-64   (hex)		Global411 Internet Services, LLC
+EC6264     (base 16)		Global411 Internet Services, LLC
+				10400 W Overland Rd #371
+				Boise  Idaho  83709
+				US
+
+00-F0-51   (hex)		KWB Gmbh
+00F051     (base 16)		KWB Gmbh
+				Industriestraße 235
+				St. Margarethen  Styria  8321
+				AT
+
+FC-94-6C   (hex)		UBIVELOX
+FC946C     (base 16)		UBIVELOX
+				#1301 KOLONG Digital Villent 222-7 Guro-dong Guro-gu
+				SEOUL    152-777
+				KR
+
+40-7B-1B   (hex)		Mettle Networks Inc.
+407B1B     (base 16)		Mettle Networks Inc.
+				111 N. Market St STE 300
+				San Jose   CA  95113
+				US
+
+40-D5-59   (hex)		MICRO S.E.R.I.
+40D559     (base 16)		MICRO S.E.R.I.
+				24, rue Henri FARMAN
+				TREMBLAY EN FRANCE  Ile de France  93290
+				FR
+
+30-6C-BE   (hex)		Skymotion Technology (HK) Limited
+306CBE     (base 16)		Skymotion Technology (HK) Limited
+				Unit 2603, 26/F, Metropole Square,
+				    852
+				HK
+
+18-38-25   (hex)		Wuhan Lingjiu High-tech Co.,Ltd.
+183825     (base 16)		Wuhan Lingjiu High-tech Co.,Ltd.
+				No.718
+				Wuhan  Hubei  430074
+				CN
+
+7C-4B-78   (hex)		Red Sun Synthesis Pte Ltd
+7C4B78     (base 16)		Red Sun Synthesis Pte Ltd
+				639, #11-544
+				    510539
+				SG
+
+64-A0-E7   (hex)		Cisco Systems, Inc
+64A0E7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+DC-F8-58   (hex)		Lorent Networks, Inc.
+DCF858     (base 16)		Lorent Networks, Inc.
+				Third Floor, Technology Complex, HAO Science Park
+				Foshan  Guangdong Province  528200
+				CN
+
+94-0B-2D   (hex)		NetView Technologies(Shenzhen) Co., Ltd
+940B2D     (base 16)		NetView Technologies(Shenzhen) Co., Ltd
+				RM2902,East Tower, Nanshan Software Park
+				Shenzhen  Guangdong  518052
+				CN
+
+80-3F-5D   (hex)		Winstars Technology Ltd
+803F5D     (base 16)		Winstars Technology Ltd
+				Block4,Taisong Industrial Park, DaLang Street, LongHua Town , Bao'an District
+				Shenzhen  Guangdong  518109
+				CN
+
+40-BF-17   (hex)		Digistar Telecom. SA
+40BF17     (base 16)		Digistar Telecom. SA
+				Av. Theodomiro Porto da Fonseca, 3101
+				Sao Leopoldo  RS  9302080
+				BR
+
+78-07-38   (hex)		Z.U.K. Elzab S.A.
+780738     (base 16)		Z.U.K. Elzab S.A.
+				ul. Kruczkowskiego 39
+				Zabrze    41-813
+				PL
+
+20-37-BC   (hex)		Kuipers Electronic Engineering BV
+2037BC     (base 16)		Kuipers Electronic Engineering BV
+				Houtkopersstraat 6
+				Zwijndrecht  Zuid-Holland  3334 KD
+				NL
+
+94-31-9B   (hex)		Alphatronics BV
+94319B     (base 16)		Alphatronics BV
+				Watergoorweg 71
+				NIJKERK  Gld  3861 MA
+				NL
+
+00-E1-75   (hex)		AK-Systems Ltd
+00E175     (base 16)		AK-Systems Ltd
+				off 62, 27/29 Pavlovskaya str.
+				Moscow    115093
+				RU
+
+CC-50-1C   (hex)		KVH Industries, Inc.
+CC501C     (base 16)		KVH Industries, Inc.
+				50 Enterprise Center
+				Middletown  RI  02842-5279
+				US
+
+04-D7-83   (hex)		Y&H E&C Co.,LTD.
+04D783     (base 16)		Y&H E&C Co.,LTD.
+				1501 Daerung Technotown 224-5
+				Anyang-city  Gyeonggi-do  431-062
+				KR
+
+54-A9-D4   (hex)		Minibar Systems
+54A9D4     (base 16)		Minibar Systems
+				7340 Westmore Road
+				Rockville  MD  20850
+				US
+
+B0-E5-0E   (hex)		NRG SYSTEMS INC
+B0E50E     (base 16)		NRG SYSTEMS INC
+				PO BOX 0509
+				Hinesburg  VT  054610509
+				US
+
+64-80-8B   (hex)		VG Controls, Inc.
+64808B     (base 16)		VG Controls, Inc.
+				11 Butternut Drive
+				Vernon  NJ  07462
+				US
+
+48-C1-AC   (hex)		PLANTRONICS, INC.
+48C1AC     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+98-58-8A   (hex)		SYSGRATION Ltd.
+98588A     (base 16)		SYSGRATION Ltd.
+				10Fl.NO.868-3.Chung Cheng Rd.
+				NewTaipei City    235
+				TW
+
+24-37-EF   (hex)		EMC Electronic Media Communication SA
+2437EF     (base 16)		EMC Electronic Media Communication SA
+				Via Cantonale 4
+				S. Antonino  Ticino  6592
+				CH
+
+28-B0-CC   (hex)		Xenya d.o.o.
+28B0CC     (base 16)		Xenya d.o.o.
+				Celovska cesta 172
+				Ljubljana    1000
+				SI
+
+20-5B-5E   (hex)		Shenzhen Wonhe Technology Co., Ltd
+205B5E     (base 16)		Shenzhen Wonhe Technology Co., Ltd
+				South Block 10th floor, Yuanxing Building, No. 1
+				Shenzhen  Guangdong  518057
+				CN
+
+C0-58-A7   (hex)		Pico Systems Co., Ltd.
+C058A7     (base 16)		Pico Systems Co., Ltd.
+				332-7 Kouya
+				Matsudo  Chiba pref.  270-0017
+				JP
+
+EC-3F-05   (hex)		Institute 706, The Second Academy China Aerospace Science & Industry Corp
+EC3F05     (base 16)		Institute 706, The Second Academy China Aerospace Science & Industry Corp
+				YongDing Road ,HaiDian District.BeiJing ,No.51
+				BeiJing    100854
+				CN
+
+48-9B-E2   (hex)		SCI Innovations Ltd
+489BE2     (base 16)		SCI Innovations Ltd
+				16C Hurst End
+				Newport Pagnell  Buckinghamshire  MK16 9HS
+				GB
+
+80-FF-A8   (hex)		UNIDIS
+80FFA8     (base 16)		UNIDIS
+				4 floors(401), 144-4, Gumi-dong
+				Sungnam-si  Gyeonggi-do  463-810
+				KR
+
+E4-35-FB   (hex)		Sabre Technology (Hull) Ltd
+E435FB     (base 16)		Sabre Technology (Hull) Ltd
+				3a Newlands Science Park
+				Hull  East Yorkshire  HU6 7TQ
+				GB
+
+C8-3B-45   (hex)		JRI
+C83B45     (base 16)		JRI
+				16 rue louis rameau
+				Bezons Cedex    95872
+				FR
+
+E8-78-A1   (hex)		BEOVIEW INTERCOM DOO
+E878A1     (base 16)		BEOVIEW INTERCOM DOO
+				TRESNJINOG CVETA 5/17
+				BELGRADE    11070
+				RS
+
+CC-EF-48   (hex)		Cisco Systems, Inc
+CCEF48     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F0-4B-6A   (hex)		Scientific Production Association Siberian Arsenal, Ltd.
+F04B6A     (base 16)		Scientific Production Association Siberian Arsenal, Ltd.
+				Bld.8A, Gorskiy Microdistrict
+				Novosibirsk    630073
+				RU
+
+64-AE-0C   (hex)		Cisco Systems, Inc
+64AE0C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E8-DA-96   (hex)		Zhuhai Tianrui Electrical Power Tech. Co., Ltd.
+E8DA96     (base 16)		Zhuhai Tianrui Electrical Power Tech. Co., Ltd.
+				Minying Technology Zone, 10# Keji 1 Road, Gangwan Main Road, Tangjia
+				Zhuhai  Guangdong  519085
+				CN
+
+B4-D8-DE   (hex)		iota Computing, Inc.
+B4D8DE     (base 16)		iota Computing, Inc.
+				2275 East Bayshore Road
+				Palo Alto  CA  94303-3222
+				US
+
+C8-90-3E   (hex)		Pakton Technologies
+C8903E     (base 16)		Pakton Technologies
+				1 Helium St
+				Narangba  QLD  4504
+				AU
+
+54-CD-A7   (hex)		Fujian Shenzhou Electronic Co.,Ltd
+54CDA7     (base 16)		Fujian Shenzhou Electronic Co.,Ltd
+				Quanzhou Economical&Technological Development Zone,Quanzhou,Fujian,China
+				QUANZHOU  FUJIAN  362005
+				CN
+
+88-6B-76   (hex)		CHINA HOPEFUL GROUP HOPEFUL ELECTRIC CO.,LTD
+886B76     (base 16)		CHINA HOPEFUL GROUP HOPEFUL ELECTRIC CO.,LTD
+				Shunde District of Foshan City, Guangdong Province, Guangxi Rong Ronggui Town Road, No. 148
+				Foshan  GuangDong  528305
+				CN
+
+78-F7-D0   (hex)		Silverbrook Research
+78F7D0     (base 16)		Silverbrook Research
+				3 Montague Street
+				Balmain  New South Wales  2041
+				AU
+
+20-76-00   (hex)		Actiontec Electronics, Inc
+207600     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+F0-13-C3   (hex)		SHENZHEN FENDA TECHNOLOGY CO., LTD
+F013C3     (base 16)		SHENZHEN FENDA TECHNOLOGY CO., LTD
+				Fenda Hi-Tech Park, Zhoushi Road, Shiyan, Baoan
+				ShenZhen  GuangDong  518108
+				CN
+
+04-A8-2A   (hex)		Nokia Corporation
+04A82A     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+E4-4E-18   (hex)		Gardasoft VisionLimited
+E44E18     (base 16)		Gardasoft VisionLimited
+				Units 1 and 2, Castle Acres
+				Cambridge    CB23 4JQ
+				GB
+
+20-46-A1   (hex)		VECOW Co., Ltd
+2046A1     (base 16)		VECOW Co., Ltd
+				7F., No.105, Zhongcheng Rd., Tucheng Dist.,
+				New Taipei City     23674
+				TW
+
+FC-01-CD   (hex)		FUNDACION TEKNIKER
+FC01CD     (base 16)		FUNDACION TEKNIKER
+				Avenida Otaola, 20
+				Eibar  Gipuzkoa  20600
+				ES
+
+9C-8B-F1   (hex)		The Warehouse Limited
+9C8BF1     (base 16)		The Warehouse Limited
+				Suite 601, City Point, 1600 Zhonghua Road, Huangpu District
+				Shanghai    200010
+				CN
+
+DC-2E-6A   (hex)		HCT. Co., Ltd.
+DC2E6A     (base 16)		HCT. Co., Ltd.
+				105-1, Jangam-ri, Majang-myen
+				Icheon-si  Gyeonggi-do  467-811
+				KR
+
+14-8A-70   (hex)		ADS GmbH
+148A70     (base 16)		ADS GmbH
+				Im Rohnweiher 39
+				Lohmar  Germany  D-53797
+				DE
+
+00-B3-38   (hex)		Kontron Asia Pacific Design Sdn. Bhd
+00B338     (base 16)		Kontron Asia Pacific Design Sdn. Bhd
+				Plot 554, Lorong Perusahaan 4
+				Prai Free Trade Zone  Prai, Penang  13600
+				MY
+
+84-24-8D   (hex)		Zebra Technologies Inc
+84248D     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+FC-E8-92   (hex)		Hangzhou Lancable Technology Co.,Ltd
+FCE892     (base 16)		Hangzhou Lancable Technology Co.,Ltd
+				Zone A,Floor 16,Zhongcai Building,68#,Tonghe Road,Binjiang District,
+				Hangzhou  Zhejiang  310051
+				CN
+
+10-71-F9   (hex)		Cloud Telecomputers, LLC
+1071F9     (base 16)		Cloud Telecomputers, LLC
+				1032 Elwell Court
+				Palo Alto  CA  94303
+				US
+
+B8-62-1F   (hex)		Cisco Systems, Inc
+B8621F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F0-02-2B   (hex)		Chrontel
+F0022B     (base 16)		Chrontel
+				2210 OToole Ave., Suite 100
+				San Jose  CA  95131
+				US
+
+D4-53-AF   (hex)		VIGO System S.A.
+D453AF     (base 16)		VIGO System S.A.
+				129/133 Poznanska str
+				Ozarow Mazowiecki  Mazowieckie  05-850
+				PL
+
+18-AD-4D   (hex)		Polostar Technology Corporation
+18AD4D     (base 16)		Polostar Technology Corporation
+				2F, No.351, Yangguang St.
+				Taipei    11491
+				TW
+
+94-C6-EB   (hex)		NOVA electronics, Inc.
+94C6EB     (base 16)		NOVA electronics, Inc.
+				Grand Axe Bldg. 3F.
+				Shibuya-ku  Tokyo  151-0064
+				JP
+
+84-3F-4E   (hex)		Tri-Tech Manufacturing, Inc.
+843F4E     (base 16)		Tri-Tech Manufacturing, Inc.
+				333 Turbine Drive
+				Rapid City  SD  57703
+				US
+
+C8-32-32   (hex)		Hunting Innova
+C83232     (base 16)		Hunting Innova
+				8383 N Sam Houston Pkwy West
+				Houston  Texas  77064
+				US
+
+54-94-78   (hex)		Silvershore Technology Partners
+549478     (base 16)		Silvershore Technology Partners
+				800 High Street
+				Palo Alto  CA  94301
+				US
+
+A0-6E-50   (hex)		Nanotek Elektronik Sistemler Ltd. Sti.
+A06E50     (base 16)		Nanotek Elektronik Sistemler Ltd. Sti.
+				Ivedik Organize Sanayi
+				Ankara    06370
+				TR
+
+4C-77-4F   (hex)		Embedded Wireless Labs 
+4C774F     (base 16)		Embedded Wireless Labs 
+				702 Level 7 Uptown 2 No.2 
+				Petaling Jaya  Selangor  47400
+				MY
+
+D0-C2-82   (hex)		Cisco Systems, Inc
+D0C282     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+14-7D-B3   (hex)		JOA TELECOM.CO.,LTD
+147DB3     (base 16)		JOA TELECOM.CO.,LTD
+				1007,Sicox tower,513-14,Sangdaewon-dong,Jungwon-gu
+				Seongnam-si  Gyeonggi-do  462-806
+				KR
+
+EC-BD-09   (hex)		FUSION Electronics Ltd
+ECBD09     (base 16)		FUSION Electronics Ltd
+				PO Box 137 - 142
+				Auckland    1151
+				NZ
+
+94-46-96   (hex)		BaudTec Corporation
+944696     (base 16)		BaudTec Corporation
+				12F, No.181, Sec.1.Tatung Rd.
+				Hsi-chih  Taipei  221
+				TW
+
+54-84-7B   (hex)		Digital Devices GmbH
+54847B     (base 16)		Digital Devices GmbH
+				Moewestr 45 A
+				Muenchen    81827
+				DE
+
+3C-27-63   (hex)		SLE quality engineering GmbH & Co. KG
+3C2763     (base 16)		SLE quality engineering GmbH & Co. KG
+				Josef-Buchinger-Str. 9
+				Grafenau  Bavaria  94481
+				DE
+
+B0-F1-BC   (hex)		Dhemax Ingenieros Ltda
+B0F1BC     (base 16)		Dhemax Ingenieros Ltda
+				Siete Oriente 1234
+				Vina del Mar  Region de Valparaiso  2530954
+				CL
+
+B8-28-8B   (hex)		Parker Hannifin Manufacturing (UK) Ltd
+B8288B     (base 16)		Parker Hannifin Manufacturing (UK) Ltd
+				Condition Monitoring Centre
+				Thetford  Norfolk  IP24 1HP
+				GB
+
+90-D1-1B   (hex)		Palomar Medical Technologies
+90D11B     (base 16)		Palomar Medical Technologies
+				15 Network Drive
+				Burlington  MA  01803
+				US
+
+34-A5-5D   (hex)		TECHNOSOFT INTERNATIONAL SRL
+34A55D     (base 16)		TECHNOSOFT INTERNATIONAL SRL
+				RO6640904
+				  Bucuresti - Sector 6  061992
+				RO
+
+80-2E-14   (hex)		azeti Networks AG
+802E14     (base 16)		azeti Networks AG
+				Am Brambusch 1a
+				Luenen  NRW  44536
+				DE
+
+D4-C1-FC   (hex)		Nokia Corporation
+D4C1FC     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+34-BC-A6   (hex)		Beijing Ding Qing Technology, Ltd.
+34BCA6     (base 16)		Beijing Ding Qing Technology, Ltd.
+				218 Han Tai Hua Office Building, 13 Huan Yuan Lu,
+				Haidian District  Beijing  100083
+				CN
+
+58-35-D9   (hex)		Cisco Systems, Inc
+5835D9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-D9-12   (hex)		Solidica, Inc.
+64D912     (base 16)		Solidica, Inc.
+				5840 Interface Drive
+				Ann Arbor  Michigan  48103
+				US
+
+C4-7B-2F   (hex)		Beijing JoinHope Image Technology Ltd.
+C47B2F     (base 16)		Beijing JoinHope Image Technology Ltd.
+				624 Room .Automation Building.95# Zhong Guancun East Road.Haidian District
+				Beijing    100190
+				CN
+
+50-8A-CB   (hex)		SHENZHEN MAXMADE TECHNOLOGY CO., LTD.
+508ACB     (base 16)		SHENZHEN MAXMADE TECHNOLOGY CO., LTD.
+				Building 3,No.5 Fuqiao Industrial Estate,
+				Shenzhen  Guangdong  518103
+				CN
+
+3C-D1-6E   (hex)		Telepower Communication Co., Ltd
+3CD16E     (base 16)		Telepower Communication Co., Ltd
+				5/F,Zonghe Building, Hantian Technology Town,Guiping RD,Nanhai District,F
+				Foshan City  Guangdong  528251
+				CN
+
+FC-2E-2D   (hex)		Lorom Industrial Co.LTD.
+FC2E2D     (base 16)		Lorom Industrial Co.LTD.
+				F1.13,Rm.2,No.78,Sec.2,An-HoRd.
+				Taipei    106
+				TW
+
+40-04-0C   (hex)		A&T
+40040C     (base 16)		A&T
+				#411, Will Town, 402-3
+				Bucheon-Si  Gyeonggi-Do  420-814
+				KR
+
+DC-3C-84   (hex)		Ticom Geomatics, Inc.
+DC3C84     (base 16)		Ticom Geomatics, Inc.
+				9130 Jollyville Rd. Ste. 300
+				Austin  Texas  78759
+				US
+
+D0-13-1E   (hex)		Sunrex Technology Corp
+D0131E     (base 16)		Sunrex Technology Corp
+				No. 188-1,Chung Cheng Road.,Ta Ya Shiang
+				Taichung    428
+				TW
+
+00-FC-70   (hex)		Intrepid Control Systems, Inc.
+00FC70     (base 16)		Intrepid Control Systems, Inc.
+				31601 Research Park Dr.
+				Madison Heights  MI  48071
+				US
+
+70-3A-D8   (hex)		Shenzhen Afoundry Electronic Co., Ltd
+703AD8     (base 16)		Shenzhen Afoundry Electronic Co., Ltd
+				201, A Building, Bole Industrial Zone, Bantian, Longgang District
+				Shenzhen   Guangdong  518129
+				CN
+
+70-4A-AE   (hex)		Xstream Flow (Pty) Ltd
+704AAE     (base 16)		Xstream Flow (Pty) Ltd
+				Room 123, Building 16, CSIR campus
+				Pretoria  Gauteng  0184
+				ZA
+
+40-B3-FC   (hex)		Logital Co. Limited 
+40B3FC     (base 16)		Logital Co. Limited 
+				Rm 901-902, 9/F, Nathan Centre, 
+				Kowloon    
+				HK
+
+A4-13-4E   (hex)		Luxul 
+A4134E     (base 16)		Luxul 
+				14203 Minuteman Drive
+				Draper  UT  84020
+				US
+
+B0-99-28   (hex)		FUJITSU LIMITED
+B09928     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+04-E1-C8   (hex)		IMS Soluções em Energia Ltda.
+04E1C8     (base 16)		IMS Soluções em Energia Ltda.
+				Av. Bernardino Silveira Pastoriza, 720
+				Porto Alegre  RS  91160-310
+				BR
+
+94-8F-EE   (hex)		Verizon Telematics
+948FEE     (base 16)		Verizon Telematics
+				2002 Summit Blvd
+				Atlanta  GA  30319
+				US
+
+50-D6-D7   (hex)		Takahata Precision
+50D6D7     (base 16)		Takahata Precision
+				4-17-1 Suniyoshi
+				Kofu    400-0851
+				JP
+
+88-F0-77   (hex)		Cisco Systems, Inc
+88F077     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-75-21   (hex)		CJSC RTSoft
+587521     (base 16)		CJSC RTSoft
+				Nikitinskaya str., 3
+				Moscow    105037
+				RU
+
+C4-0F-09   (hex)		Hermes electronic GmbH
+C40F09     (base 16)		Hermes electronic GmbH
+				Am Handwerkerpark 1
+				Essen  NRW  45309
+				DE
+
+48-F4-7D   (hex)		TechVision Holding  Internation Limited
+48F47D     (base 16)		TechVision Holding  Internation Limited
+				Offshore Incorporations Centre
+				Road Town  Tortola  VG1110
+				VG
+
+F0-81-AF   (hex)		IRZ AUTOMATION TECHNOLOGIES LTD
+F081AF     (base 16)		IRZ AUTOMATION TECHNOLOGIES LTD
+				Unit 9-10 27/F Seapower Tower
+				  Kowloon  
+				HK
+
+70-14-04   (hex)		Limited Liability Company
+701404     (base 16)		Limited Liability Company
+				I.Yakovleva St., 1
+				Cheboksary Chuvash Republic    428003
+				RU
+
+B4-35-F7   (hex)		Zhejiang Pearmain Electronics Co.ltd.
+B435F7     (base 16)		Zhejiang Pearmain Electronics Co.ltd.
+				4F Yitai Mansion, 76 Gucui Road,
+				Hangzhou  Zhejiang  310012
+				CN
+
+98-66-EA   (hex)		Industrial Control Communications, Inc.
+9866EA     (base 16)		Industrial Control Communications, Inc.
+				1600 Aspen Commons
+				Middleton  WI  53562
+				US
+
+98-30-00   (hex)		Beijing KEMACOM Technologies Co., Ltd.
+983000     (base 16)		Beijing KEMACOM Technologies Co., Ltd.
+				Room 208, Building 6, No.50, Xi San Huan Bei Road 
+				Beijing    100044
+				CN
+
+90-CF-15   (hex)		Nokia Corporation
+90CF15     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+94-8B-03   (hex)		EAGET Innovation and Technology Co., Ltd.
+948B03     (base 16)		EAGET Innovation and Technology Co., Ltd.
+				3/F, Building 4, Lianchuang Technology Park,Buji Town,
+				Shenzhen  Guangdong  518112
+				CN
+
+2C-00-33   (hex)		EControls, LLC
+2C0033     (base 16)		EControls, LLC
+				5757 Farinon Dr
+				San Antonio  TX  78249
+				US
+
+AC-19-9F   (hex)		SUNGROW POWER SUPPLY CO.,LTD.
+AC199F     (base 16)		SUNGROW POWER SUPPLY CO.,LTD.
+				NO.2 Tianhu Road, New and High Technology Industrial Development Zone
+				Hefei  Anhui  230088
+				CN
+
+7C-4A-82   (hex)		Portsmith LLC
+7C4A82     (base 16)		Portsmith LLC
+				850 E. Franklin Road
+				Meridian  ID  83642
+				US
+
+94-E8-48   (hex)		FYLDE MICRO LTD
+94E848     (base 16)		FYLDE MICRO LTD
+				8 AVROE CRESCENT
+				BLACKPOOL  LANCASHIRE  FY4 2DP
+				GB
+
+AC-5E-8C   (hex)		Utillink
+AC5E8C     (base 16)		Utillink
+				817 Woolim Lions Valley 1, 311-3 Sangdaewon-dong Jungwon-gu
+				Seongnam-si  Gyeonggi-do  462160
+				KR
+
+18-E2-88   (hex)		STT Condigi
+18E288     (base 16)		STT Condigi
+				Agnesfridsvagen 113 A
+				Malmö  Skåne  21237
+				SE
+
+1C-35-F1   (hex)		NEW Lift Neue Elektronische Wege Steuerungsbau GmbH
+1C35F1     (base 16)		NEW Lift Neue Elektronische Wege Steuerungsbau GmbH
+				Lochhamer Schlag 8
+				Graefelfing  Bavaria  82166
+				DE
+
+80-34-57   (hex)		OT Systems Limited
+803457     (base 16)		OT Systems Limited
+				Unit 1023, 10/F., Landmark North,
+				Sheung Shui, N. T.    
+				HK
+
+5C-0C-BB   (hex)		CELIZION Inc.
+5C0CBB     (base 16)		CELIZION Inc.
+				#206 Lordland EZ Tower, GuMi-Dong 153 BunDang-Gu
+				SeongNam-Si   GyeongGi-Do  463-870
+				KR
+
+C4-24-2E   (hex)		Galvanic Applied Sciences Inc
+C4242E     (base 16)		Galvanic Applied Sciences Inc
+				7000 Fisher Road SE
+				Calgary  Alberta  T2H 0W3
+				CA
+
+24-C8-6E   (hex)		Chaney Instrument Co.
+24C86E     (base 16)		Chaney Instrument Co.
+				965 Wells Street
+				Lake Geneva  WI  53147
+				US
+
+F0-AE-51   (hex)		Xi3 Corp
+F0AE51     (base 16)		Xi3 Corp
+				299 S. Main St.
+				Salt Lake City  UT  84111
+				US
+
+B8-0B-9D   (hex)		ROPEX Industrie-Elektronik GmbH
+B80B9D     (base 16)		ROPEX Industrie-Elektronik GmbH
+				Adolf-Heim-Str. 4
+				Bietigheim-Bissingen  Baden Wuerttemberg  74321
+				DE
+
+30-61-18   (hex)		Paradom Inc.
+306118     (base 16)		Paradom Inc.
+				8F, N0. 178, Sec-2, Gongdaowu Rd.
+				Hsinchu City    300
+				TW
+
+4C-73-67   (hex)		Genius Bytes Software Solutions GmbH
+4C7367     (base 16)		Genius Bytes Software Solutions GmbH
+				Merianstraße 30
+				Bochum  NRW  44801
+				DE
+
+90-EA-60   (hex)		SPI Lasers Ltd 
+90EA60     (base 16)		SPI Lasers Ltd 
+				6 wellington Park
+				Southampton  Hampshire  S0302QU
+				GB
+
+50-70-E5   (hex)		He Shan World Fair Electronics Technology Limited
+5070E5     (base 16)		He Shan World Fair Electronics Technology Limited
+				New Material Base, Gonghe Town
+				Jiangmen  Guangdong  529728
+				CN
+
+80-22-75   (hex)		Beijing Beny Wave Technology Co Ltd
+802275     (base 16)		Beijing Beny Wave Technology Co Ltd
+				No.55, Jiachuang Road
+				Tongzhou District  Beijing  101111
+				CN
+
+CC-F3-A5   (hex)		Chi Mei Communication Systems, Inc
+CCF3A5     (base 16)		Chi Mei Communication Systems, Inc
+				No.4
+				Tucheng City  Taipei County   23678
+				TW
+
+14-A9-E3   (hex)		MST CORPORATION
+14A9E3     (base 16)		MST CORPORATION
+				4th Floor Lawford House
+				London  England  N3 1 RL
+				GB
+
+F8-EA-0A   (hex)		Dipl.-Math. Michael Rauch
+F8EA0A     (base 16)		Dipl.-Math. Michael Rauch
+				Kapellenstraße 31
+				Bretten  BaWü  75015
+				DE
+
+38-31-AC   (hex)		WEG
+3831AC     (base 16)		WEG
+				Av. Pref. Waldemar Grubba, 3000
+				Jaraguá do Sul  Santa Catarina  89256-900
+				BR
+
+58-4C-19   (hex)		Chongqing Guohong Technology Development Company Limited
+584C19     (base 16)		Chongqing Guohong Technology Development Company Limited
+				Rongzhi Building, Science & Technology Venture Center,
+				Chongqing    401336
+				CN
+
+64-69-BC   (hex)		Hytera Communications Co .,ltd
+6469BC     (base 16)		Hytera Communications Co .,ltd
+				HYT Tower ,Hi-Tech Industrial Park North,Nanshan District,
+				Shenzhen  Guangdong  518057
+				CN
+
+B4-F3-23   (hex)		PETATEL INC.
+B4F323     (base 16)		PETATEL INC.
+				#322 THE O VILLE 720-25, YEOKSAM-DONG
+				GANGNAM-GU  SEOUL  135080
+				KR
+
+28-51-32   (hex)		Shenzhen Prayfly Technology Co.,Ltd
+285132     (base 16)		Shenzhen Prayfly Technology Co.,Ltd
+				16F B International Chamber of Commerce Building
+				Shenzhen  Guangdong Province   518048
+				CN
+
+E4-2F-F6   (hex)		Unicore communication Inc.
+E42FF6     (base 16)		Unicore communication Inc.
+				Rm.312 Building 2 IRICO, No.11St.4,Shangdi, Haidian District,
+				Beijing    100085
+				CN
+
+84-D9-C8   (hex)		Unipattern Co.,
+84D9C8     (base 16)		Unipattern Co.,
+				16F., No.30., Beiping E. Rd., Zhongzheng Dist.,
+				Taipei    100
+				TW
+
+94-AA-B8   (hex)		Joview(Beijing) Technology Co. Ltd.
+94AAB8     (base 16)		Joview(Beijing) Technology Co. Ltd.
+				Room 302, South Building
+				Beijing    100081
+				CN
+
+28-F3-58   (hex)		2C - Trifonov & Co
+28F358     (base 16)		2C - Trifonov & Co
+				133, Tsarigradsko Shose Blvd, BIZ IZOT, 
+				Sofia    1784
+				BG
+
+14-C2-1D   (hex)		Sabtech Industries
+14C21D     (base 16)		Sabtech Industries
+				23231 La Palma Ave
+				Yorba Linda  Ca.  92887-4788
+				US
+
+C8-84-39   (hex)		Sunrise Technologies
+C88439     (base 16)		Sunrise Technologies
+				54 Commercial Street
+				Raynham  MA  02767
+				US
+
+F0-BF-97   (hex)		Sony Corporation
+F0BF97     (base 16)		Sony Corporation
+				Gotenyama Tec 5-1-2
+				Tokyo  Shinagawa-ku  141-0001
+				JP
+
+C4-4A-D0   (hex)		FIREFLIES SYSTEMS
+C44AD0     (base 16)		FIREFLIES SYSTEMS
+				3 CHEMIN DU PRE CARRE
+				MEYLAN    38240
+				FR
+
+EC-7D-9D   (hex)		CPI
+EC7D9D     (base 16)		CPI
+				3222 Phoenixville Pike Suite 200
+				Malvern  PA  19355
+				US
+
+C8-1E-8E   (hex)		ADV Security (S) Pte Ltd
+C81E8E     (base 16)		ADV Security (S) Pte Ltd
+				56 Dunlop Street
+				    209386
+				SG
+
+A8-87-92   (hex)		Broadband Antenna Tracking Systems
+A88792     (base 16)		Broadband Antenna Tracking Systems
+				8902 Vincennes Circle, Suite D-2
+				Indianapolis  IN  46268
+				US
+
+14-F0-C5   (hex)		Xtremio Ltd.
+14F0C5     (base 16)		Xtremio Ltd.
+				POB 5246
+				Herzelyia    46152
+				IL
+
+E8-C2-29   (hex)		H-Displays (MSC) Bhd
+E8C229     (base 16)		H-Displays (MSC) Bhd
+				No. 31 & 32, Jalan Gangsa Dua
+				Johor Bahru    81700
+				MY
+
+3C-A7-2B   (hex)		MRV Communications (Networks) LTD
+3CA72B     (base 16)		MRV Communications (Networks) LTD
+				P.O Box 614
+				Yokneam     20692
+				IL
+
+30-1A-28   (hex)		Mako Networks Ltd
+301A28     (base 16)		Mako Networks Ltd
+				1/62 Paul Matthews Rd
+				Auckland    0632
+				NZ
+
+04-E6-62   (hex)		Acroname Inc.
+04E662     (base 16)		Acroname Inc.
+				4822 Sterling Drive
+				Boulder  CO  80301-2350
+				US
+
+F8-7B-8C   (hex)		Amped Wireless
+F87B8C     (base 16)		Amped Wireless
+				13089 Peyton Dr. #C307
+				Chino Hills  CA  91709
+				US
+
+28-34-10   (hex)		Enigma Diagnostics Limited
+283410     (base 16)		Enigma Diagnostics Limited
+				Building 224
+				DSTL Porton Down  Salisbury  SP4 0JQ
+				GB
+
+0C-E8-2F   (hex)		Bonfiglioli Vectron GmbH
+0CE82F     (base 16)		Bonfiglioli Vectron GmbH
+				Europark Fichtenhain B6
+				Krefeld  NRW  47807
+				DE
+
+40-F4-EC   (hex)		Cisco Systems, Inc
+40F4EC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+14-B7-3D   (hex)		ARCHEAN Technologies
+14B73D     (base 16)		ARCHEAN Technologies
+				1899 avenue d'Italie
+				MONTAUBAN    82000
+				FR
+
+94-8D-50   (hex)		Beamex Oy Ab
+948D50     (base 16)		Beamex Oy Ab
+				Ristisuonraitti 10
+				Pietarsaari    FI-68600
+				FI
+
+A4-33-D1   (hex)		Fibrlink Communications Co.,Ltd.
+A433D1     (base 16)		Fibrlink Communications Co.,Ltd.
+				28F Ages Wealth World, No.1 Hangfeng Road
+				Beijing    100070
+				CN
+
+5C-BD-9E   (hex)		HONGKONG MIRACLE EAGLE TECHNOLOGY(GROUP) LIMITED
+5CBD9E     (base 16)		HONGKONG MIRACLE EAGLE TECHNOLOGY(GROUP) LIMITED
+				FLAT RM 2103,  EASEY COMMERCIAL BLDG,253-261 HENNESSY RD,  
+				  WANCHAI  999077
+				HK
+
+08-E6-72   (hex)		JEBSEE ELECTRONICS CO.,LTD.
+08E672     (base 16)		JEBSEE ELECTRONICS CO.,LTD.
+				24-3, SIN LE ROAD, 
+				TAINAN    70268
+				TW
+
+B8-E5-89   (hex)		Payter BV
+B8E589     (base 16)		Payter BV
+				Rozenlaan 115
+				Rotterdam  Zuid-Holland  3051 LP
+				NL
+
+88-E0-A0   (hex)		Shenzhen VisionSTOR Technologies Co., Ltd
+88E0A0     (base 16)		Shenzhen VisionSTOR Technologies Co., Ltd
+				12/F, East Tower,Nanshan Software Park
+				Shenzhen  Guangdong  518000
+				CN
+
+FC-10-BD   (hex)		Control Sistematizado S.A.
+FC10BD     (base 16)		Control Sistematizado S.A.
+				Cra 43 N 31 52
+				Medellin  Antioquia  10101
+				CO
+
+F0-C2-7C   (hex)		Mianyang Netop Telecom Equipment Co.,Ltd.
+F0C27C     (base 16)		Mianyang Netop Telecom Equipment Co.,Ltd.
+				No.111,East section of Puming South Road,
+				Mianyang City  Sichuan Province,   621000
+				CN
+
+24-1A-8C   (hex)		Squarehead Technology AS
+241A8C     (base 16)		Squarehead Technology AS
+				PO Box 13 Nydalen
+				Oslo    NO-0410
+				NO
+
+D4-4F-80   (hex)		Kemper Digital GmbH
+D44F80     (base 16)		Kemper Digital GmbH
+				Koenigswall 16-18
+				Recklinghausen  North-Rhine-Westphalia  45657
+				DE
+
+A4-1B-C0   (hex)		Fastec Imaging Corporation
+A41BC0     (base 16)		Fastec Imaging Corporation
+				17150 Via Del Campo
+				San Diego  California  92127
+				US
+
+20-5B-2A   (hex)		Private
+205B2A     (base 16)		Private
+
+F4-03-21   (hex)		BeNeXt B.V.
+F40321     (base 16)		BeNeXt B.V.
+				Ter Gouwstraat 3
+				Amsterdam  NH  1093JX
+				NL
+
+A0-71-A9   (hex)		Nokia Corporation
+A071A9     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+A4-E3-2E   (hex)		Silicon & Software Systems Ltd.
+A4E32E     (base 16)		Silicon & Software Systems Ltd.
+				South County Business Park
+				Leopardstown  Dublin  18
+				IE
+
+C8-C1-26   (hex)		ZPM Industria e Comercio Ltda
+C8C126     (base 16)		ZPM Industria e Comercio Ltda
+				Rua Araguaia, 175
+				Canoas  RS  92410-000
+				BR
+
+64-DE-1C   (hex)		Kingnetic Pte Ltd
+64DE1C     (base 16)		Kingnetic Pte Ltd
+				47 Kaki Bukit Place
+				    416225
+				SG
+
+A8-62-A2   (hex)		JIWUMEDIA CO., LTD.
+A862A2     (base 16)		JIWUMEDIA CO., LTD.
+				#902, Daerug Techno Town 13'th, 664
+				Geumcheon-gu  Seoul  153-803
+				KR
+
+98-4E-97   (hex)		Starlight Marketing (H. K.) Ltd.
+984E97     (base 16)		Starlight Marketing (H. K.) Ltd.
+				5/F., Shing Dao Industrial Building, 
+				    
+				HK
+
+64-DC-01   (hex)		Static Systems Group PLC
+64DC01     (base 16)		Static Systems Group PLC
+				Heathmill Road
+				Wolverhampton  West Midlands  WV5 8AN
+				GB
+
+FC-1F-C0   (hex)		EURECAM
+FC1FC0     (base 16)		EURECAM
+				BAT 9 - Miniparc
+				LES ULIS    91940
+				FR
+
+BC-67-84   (hex)		Environics Oy
+BC6784     (base 16)		Environics Oy
+				Graanintie 5
+				Mikkeli    50190
+				FI
+
+68-DC-E8   (hex)		PacketStorm Communications
+68DCE8     (base 16)		PacketStorm Communications
+				20 Meridian Rd
+				Eatontown  NJ  07724
+				US
+
+48-8E-42   (hex)		DIGALOG GmbH
+488E42     (base 16)		DIGALOG GmbH
+				Wattstraße 11-13
+				Berlin    D-13355
+				DE
+
+60-76-88   (hex)		Velodyne
+607688     (base 16)		Velodyne
+				345 Digital Drive
+				Morgan Hill  CA  95037
+				US
+
+78-CD-8E   (hex)		SMC Networks Inc
+78CD8E     (base 16)		SMC Networks Inc
+				20 Mason
+				Irvine  CA  92618
+				US
+
+2C-80-65   (hex)		HARTING Inc. of North America
+2C8065     (base 16)		HARTING Inc. of North America
+				1370 Bowes Road
+				Elgin  Illinois  60123
+				US
+
+3C-C0-C6   (hex)		d&b audiotechnik GmbH
+3CC0C6     (base 16)		d&b audiotechnik GmbH
+				Eugen Adolff Str 134
+				Backnang  Baden Wuerttemberg  71522
+				DE
+
+44-68-AB   (hex)		JUIN COMPANY, LIMITED
+4468AB     (base 16)		JUIN COMPANY, LIMITED
+				2FL, 1075-1, Wonpyeong-Dong
+				Gumi City  Gyeongsangbuk-Do  730-010
+				KR
+
+F8-10-37   (hex)		Atopia Systems, LP
+F81037     (base 16)		Atopia Systems, LP
+				681 N. Plano Road
+				Richardson  TX  75082
+				US
+
+78-A6-83   (hex)		Precidata
+78A683     (base 16)		Precidata
+				CP 672
+				2002  NE  2002
+				CH
+
+F0-25-72   (hex)		Cisco Systems, Inc
+F02572     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+04-FF-51   (hex)		NOVAMEDIA INNOVISION SP. Z O.O.
+04FF51     (base 16)		NOVAMEDIA INNOVISION SP. Z O.O.
+				WODNA 7 
+				KALISZ  WIELKOPOLSKA  62-800
+				PL
+
+4C-B4-EA   (hex)		HRD (S) PTE., LTD.
+4CB4EA     (base 16)		HRD (S) PTE., LTD.
+				Lot 7, Block 9, Phase 1, Cavite Eco-Zone,
+				Rosario  Cavite  4106
+				PH
+
+D4-4C-24   (hex)		Vuppalamritha Magnetic Components LTD
+D44C24     (base 16)		Vuppalamritha Magnetic Components LTD
+				3rd Floor, 307 ,My Home Ashoka Chambers,S.P Road, 
+				Secunderabad  AndhraPradesh  500003
+				IN
+
+F8-C6-78   (hex)		Carefusion
+F8C678     (base 16)		Carefusion
+				10020 Pacific Mesa Blvd
+				San Diego  CA  92121
+				US
+
+6C-AB-4D   (hex)		Digital Payment Technologies
+6CAB4D     (base 16)		Digital Payment Technologies
+				4105 Grandview Hwy
+				Burnaby  BC  V5C 6B4
+				CA
+
+2C-B0-DF   (hex)		Soliton Technologies Pvt Ltd
+2CB0DF     (base 16)		Soliton Technologies Pvt Ltd
+				# 683, 15th Cross 
+				Bangalore  Karnataka  560 078
+				IN
+
+EC-E5-55   (hex)		Hirschmann Automation
+ECE555     (base 16)		Hirschmann Automation
+				Stuttgarter Straße 45-51
+				Neckartenzlingen  Baden-Württemberg  72654
+				DE
+
+58-F9-8E   (hex)		SECUDOS GmbH
+58F98E     (base 16)		SECUDOS GmbH
+				Rhenus-Platz 2
+				Holzwickede  NRW  59439
+				DE
+
+B4-C4-4E   (hex)		VXL eTech Pvt Ltd
+B4C44E     (base 16)		VXL eTech Pvt Ltd
+				#91, 11th Main, Begur Main Road
+				Bangalore  Karnataka  560068
+				IN
+
+70-7E-DE   (hex)		NASTEC LTD.
+707EDE     (base 16)		NASTEC LTD.
+				111-D, Krasnorechenskaya str.
+				Khabarovsk    680006
+				RU
+
+C0-7E-40   (hex)		SHENZHEN XDK COMMUNICATION EQUIPMENT CO.,LTD
+C07E40     (base 16)		SHENZHEN XDK COMMUNICATION EQUIPMENT CO.,LTD
+				XDK BUILDING,NO.1 INDUSTRIAL AREA,BANTIAN,LONGGANG DISTRICT
+				SHENZHEN  GUANGDONG  518129
+				CN
+
+E4-4F-29   (hex)		MA Lighting Technology GmbH
+E44F29     (base 16)		MA Lighting Technology GmbH
+				Dachdeckerstraße16
+				Waldbüttelbrunn  Bavaria  97297
+				DE
+
+B4-74-9F   (hex)		ASKEY COMPUTER CORP
+B4749F     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+7C-4A-A8   (hex)		MindTree Wireless PVT Ltd
+7C4AA8     (base 16)		MindTree Wireless PVT Ltd
+				LGF, Phase III, Mindtree West Campus, 
+				Bangalore  Karnataka  560 059
+				IN
+
+80-91-C0   (hex)		AgileMesh, Inc.
+8091C0     (base 16)		AgileMesh, Inc.
+				1671 International Pkwy
+				Richardson  TX  75081
+				US
+
+E0-5F-B9   (hex)		Cisco Systems, Inc
+E05FB9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-14-3E   (hex)		Modoosis Inc.
+E0143E     (base 16)		Modoosis Inc.
+				#302, Samil Bldg., 656-282
+				Seoul    133-110
+				KR
+
+90-D8-52   (hex)		Comtec Co., Ltd.
+90D852     (base 16)		Comtec Co., Ltd.
+				 3F., No.81, Jiankang Rd.,
+				Zhonghe City  Taipei County  23586
+				TW
+
+38-01-97   (hex)		TSST Global,Inc
+380197     (base 16)		TSST Global,Inc
+				14 Floor, Bldg. No. 102, Digital Empire2, 486, Sin-dong, Yeongtong-gu, Suwon-si,
+				Su-won  Gyeonggi  443-734
+				KR
+
+AC-02-CF   (hex)		RW Tecnologia Industria e Comercio Ltda
+AC02CF     (base 16)		RW Tecnologia Industria e Comercio Ltda
+				Centro Empresarial Paulo Frederico de Toledo, 80 A
+				Santa Rita do Sapucai  Minas Gerais   37540000
+				BR
+
+D4-12-96   (hex)		Anobit Technologies Ltd.
+D41296     (base 16)		Anobit Technologies Ltd.
+				8 Hasadnaot St.
+				Herzeliya Pituach     46728
+				IL
+
+48-17-4C   (hex)		MicroPower technologies
+48174C     (base 16)		MicroPower technologies
+				4225 Executive Sq.
+				La Jolla  California  92037
+				US
+
+34-9A-0D   (hex)		ZBD Displays Ltd
+349A0D     (base 16)		ZBD Displays Ltd
+				Orchard Lea
+				Windsor  Berkshire  SL4 4RU
+				GB
+
+90-50-7B   (hex)		Advanced PANMOBIL Systems GmbH & Co. KG
+90507B     (base 16)		Advanced PANMOBIL Systems GmbH & Co. KG
+				Hansestraße 91
+				Cologne  NRW  51149
+				DE
+
+08-76-FF   (hex)		Thomson Telecom Belgium
+0876FF     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+1C-7C-11   (hex)		EID 
+1C7C11     (base 16)		EID 
+				Rua Quinta dos Medronheiros 
+				Charneca da Caparica     2820-486
+				PT
+
+20-AA-25   (hex)		IP-NET LLC
+20AA25     (base 16)		IP-NET LLC
+				10256 N.W. 47th St.
+				Sunrise  FL  33351
+				US
+
+C4-EE-F5   (hex)		II-VI Incorporated
+C4EEF5     (base 16)		II-VI Incorporated
+				Network Solutions,343 Daniel Zenker Dr., Suite 102
+				Horseheads  NY  14845
+				US
+
+E0-CF-2D   (hex)		Gemintek Corporation
+E0CF2D     (base 16)		Gemintek Corporation
+				5F-1, No.8, Alley 30, Lane 358, Rueiguang Rd.
+				Taipei    114
+				TW
+
+D4-91-AF   (hex)		Electroacustica General Iberica, S.A.
+D491AF     (base 16)		Electroacustica General Iberica, S.A.
+				Avda. Almozara, 79
+				Zaragoza    50003
+				ES
+
+C4-B5-12   (hex)		General Electric Digital Energy
+C4B512     (base 16)		General Electric Digital Energy
+				4200 Wildwood Pkwy
+				Atlanta  GA  30339
+				US
+
+00-34-F1   (hex)		Radicom Research, Inc.
+0034F1     (base 16)		Radicom Research, Inc.
+				2148 Bering Drive
+				San Jose  Ca  95131
+				US
+
+94-33-DD   (hex)		Taco Inc
+9433DD     (base 16)		Taco Inc
+				1160 Cranston Street
+				Cranston  RI  02920
+				US
+
+E0-25-38   (hex)		Titan Pet Products
+E02538     (base 16)		Titan Pet Products
+				6521 Creedmoor Rd. Suite 101
+				Raleigh  NC  27613
+				US
+
+CC-7A-30   (hex)		CMAX Wireless Co., Ltd.
+CC7A30     (base 16)		CMAX Wireless Co., Ltd.
+				KT Bongduk B/D 9F, 627-15, Bongduk-dong
+				Namgu  Daegu  705710
+				KR
+
+B8-8E-3A   (hex)		Infinite Technologies JLT
+B88E3A     (base 16)		Infinite Technologies JLT
+				Office 3203, Level 32
+				Jumeirah Lake Towers  Dubai  
+				AE
+
+58-8D-09   (hex)		Cisco Systems, Inc
+588D09     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C0-C1-C0   (hex)		Cisco-Linksys, LLC
+C0C1C0     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+60-15-C7   (hex)		IdaTech
+6015C7     (base 16)		IdaTech
+				63065 NE 18th St.
+				Bend  OR  97701
+				US
+
+DC-20-08   (hex)		ASD Electronics Ltd 
+DC2008     (base 16)		ASD Electronics Ltd 
+				DEDE INDUSTRIAL PARK,JIAN'AN ROAD,HIGH-TECH
+				Shenzhen   Guang Dong  518103
+				CN
+
+1C-83-B0   (hex)		Linked IP GmbH
+1C83B0     (base 16)		Linked IP GmbH
+				Kirchenstrasse 9
+				Anif / Niederalm  SBG  5081
+				AT
+
+A4-D1-D1   (hex)		ECOtality North America
+A4D1D1     (base 16)		ECOtality North America
+				430 S 2nd Avenue
+				Phoenix  AZ  85003
+				US
+
+C4-93-13   (hex)		100fio networks technology llc
+C49313     (base 16)		100fio networks technology llc
+				2534 crescent st. apt 3F
+				Astoria  New york  11102
+				US
+
+7C-39-20   (hex)		SSOMA SECURITY
+7C3920     (base 16)		SSOMA SECURITY
+				Unit 703, Daeryung Technotown 13th, 
+				Geumcheongu  Seoul  153754
+				KR
+
+28-C0-DA   (hex)		Juniper Networks
+28C0DA     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+9C-77-AA   (hex)		NADASNV
+9C77AA     (base 16)		NADASNV
+				2203, T-dong, Poonglim I-won Plus
+				Seongnam-si  Gyeonggi-do  463-862
+				KR
+
+10-E8-EE   (hex)		PhaseSpace
+10E8EE     (base 16)		PhaseSpace
+				1933 Davis St Suite 312
+				San Leandro  CA  94577
+				US
+
+A4-7C-1F   (hex)		Cobham plc
+A47C1F     (base 16)		Cobham plc
+				3985 Gateway Centre Blvd
+				Pinellas Park  FL  33782
+				US
+
+D4-6C-DA   (hex)		CSM GmbH
+D46CDA     (base 16)		CSM GmbH
+				Raiffeisenstraße 34
+				Filderstadt  Baden-Württemberg  70794
+				DE
+
+5C-D9-98   (hex)		D-Link Corporation
+5CD998     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd Rd., Neihu District, 
+				Taipei City     114
+				TW
+
+68-59-7F   (hex)		Alcatel Lucent
+68597F     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+F0-65-DD   (hex)		Primax Electronics Ltd.
+F065DD     (base 16)		Primax Electronics Ltd.
+				669, Ruey Kuang Road, Neihu
+				Taipei    114
+				TW
+
+70-65-82   (hex)		Suzhou Hanming Technologies Co., Ltd.
+706582     (base 16)		Suzhou Hanming Technologies Co., Ltd.
+				Suite 407, No. 166, Ren Ai Road
+				Suzhou  Jiangsu  215123
+				CN
+
+34-D2-C4   (hex)		RENA GmbH Print Systeme
+34D2C4     (base 16)		RENA GmbH Print Systeme
+				Hienlohestrasse 24
+				Otterfing  Bavaria  83624
+				DE
+
+D4-CB-AF   (hex)		Nokia Corporation
+D4CBAF     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+04-5D-56   (hex)		camtron industrial inc.
+045D56     (base 16)		camtron industrial inc.
+				5F, Kuem-Ah B/D, 31-3, Karak-dong, Songpa-gu
+				Seoul    138-801
+				KR
+
+68-23-4B   (hex)		Nihon Dengyo Kousaku
+68234B     (base 16)		Nihon Dengyo Kousaku
+				shinmachi 21-1
+				kawagoe-shi  saitama  350-1107
+				JP
+
+1C-3D-E7   (hex)		Sigma Koki Co.,Ltd.
+1C3DE7     (base 16)		Sigma Koki Co.,Ltd.
+				1-19-9 Midori
+				Sumida-ku  Tokyo  130-0021
+				JP
+
+58-BC-27   (hex)		Cisco Systems, Inc
+58BC27     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+20-D6-07   (hex)		Nokia Corporation
+20D607     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+6C-E0-B0   (hex)		SOUND4
+6CE0B0     (base 16)		SOUND4
+				11 quai Joseph Gillet
+				LYON    69004
+				FR
+
+9C-FF-BE   (hex)		OTSL Inc.
+9CFFBE     (base 16)		OTSL Inc.
+				HANROKU Bldg. 2F, 2-1-2
+				Shinjuku-ku  Tokyo  160-0021
+				JP
+
+00-F8-60   (hex)		PT. Panggung Electric Citrabuana
+00F860     (base 16)		PT. Panggung Electric Citrabuana
+				Jl. Raya Waru no. 1
+				Sidoarjo  Jawa Timur  61256
+				ID
+
+B8-BA-72   (hex)		Cynove
+B8BA72     (base 16)		Cynove
+				10 cite rougemont
+				Paris    75009
+				FR
+
+44-3D-21   (hex)		Nuvolt
+443D21     (base 16)		Nuvolt
+				8087 Boul. de la Rive Sud
+				Levis  Quebec  G6V 9G9
+				CA
+
+30-49-3B   (hex)		Nanjing Z-Com Wireless Co.,Ltd
+30493B     (base 16)		Nanjing Z-Com Wireless Co.,Ltd
+				Z-Com Building,NO.30 Jiangsu Software Park,NO.699-22 Xuanwu Avenue,
+				Nanjing  Jiangsu  210042
+				CN
+
+A4-5C-27   (hex)		Nintendo Co., Ltd.
+A45C27     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+6C-04-60   (hex)		RBH Access Technologies Inc.
+6C0460     (base 16)		RBH Access Technologies Inc.
+				2 Automatic Road
+				Brampton  Ontario  L6S 6K8
+				CA
+
+70-64-17   (hex)		ORBIS TECNOLOGIA ELECTRICA S.A.
+706417     (base 16)		ORBIS TECNOLOGIA ELECTRICA S.A.
+				Lerida, 61
+				Madrid  Madrid  E28020
+				US
+
+18-EF-63   (hex)		Cisco Systems, Inc
+18EF63     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+20-6F-EC   (hex)		Braemac CA LLC
+206FEC     (base 16)		Braemac CA LLC
+				43134 Osgood Road
+				Fremont  CA  94539
+				US
+
+10-0D-32   (hex)		Embedian, Inc.
+100D32     (base 16)		Embedian, Inc.
+				10F., 95, Nanjing E. Rd. Sec. 4, 
+				Taipei    10580
+				TW
+
+88-AC-C1   (hex)		Generiton Co., Ltd. 
+88ACC1     (base 16)		Generiton Co., Ltd. 
+				8F-1, No. 81, Shuili Rd., 
+				Hsinchu City,     30059 
+				TW
+
+88-18-AE   (hex)		Tamron Co., Ltd
+8818AE     (base 16)		Tamron Co., Ltd
+				1385,Hasunuma, Minuma-ku
+				Saitama-shi  Saitama  337-8556
+				JP
+
+7C-ED-8D   (hex)		Microsoft
+7CED8D     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+A4-BE-61   (hex)		EutroVision System, Inc.
+A4BE61     (base 16)		EutroVision System, Inc.
+				Rm 403,Building33,No.680 GuipingRd,Xuhui,
+				Shanghai    200233
+				CN
+
+D0-7D-E5   (hex)		Forward Pay Systems, Inc.
+D07DE5     (base 16)		Forward Pay Systems, Inc.
+				9531 West 78th St., #245
+				Eden Prairie  MN  55344
+				US
+
+04-DD-4C   (hex)		Velocytech
+04DD4C     (base 16)		Velocytech
+				Poppelgårdvej 11
+				Søborg  DK  2860
+				DK
+
+A4-0C-C3   (hex)		Cisco Systems, Inc
+A40CC3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+4C-BA-A3   (hex)		Bison Electronics Inc.
+4CBAA3     (base 16)		Bison Electronics Inc.
+				3F., No.28, Lane 583, Rueiguang Rd., Neihu District
+				Taipei City    11492
+				TW
+
+A8-B1-D4   (hex)		Cisco Systems, Inc
+A8B1D4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+EC-7C-74   (hex)		Justone Technologies Co., Ltd.
+EC7C74     (base 16)		Justone Technologies Co., Ltd.
+				Tongguang Building F19, 12# South Agriculture Exhibition Center Road, 
+				Beijing    100125
+				CN
+
+CC-FC-B1   (hex)		Wireless Technology, Inc.
+CCFCB1     (base 16)		Wireless Technology, Inc.
+				2064 Eastman Ave. #113
+				Ventura  CA  93003-7787
+				US
+
+3C-1A-79   (hex)		Huayuan Technology CO.,LTD
+3C1A79     (base 16)		Huayuan Technology CO.,LTD
+				R308 Block Jingmeng High-Tech Building,NO.5-1 Shangdi East Road,
+				Beijing    100085
+				CN
+
+7C-F0-98   (hex)		Bee Beans Technologies, Inc.
+7CF098     (base 16)		Bee Beans Technologies, Inc.
+				TCI B5
+				Tsukuba City  Ibaraki  305-0047
+				JP
+
+EC-66-D1   (hex)		B&W Group LTD
+EC66D1     (base 16)		B&W Group LTD
+				Dale Road
+				Worthing  Sussex  BN11 2BH
+				GB
+
+38-5F-C3   (hex)		Yu Jeong System, Co.Ltd
+385FC3     (base 16)		Yu Jeong System, Co.Ltd
+				#503, Dong il B/D, 826, Guro-3dong, 
+				Seoul    152-879
+				KR
+
+88-8B-5D   (hex)		Storage Appliance Corporation 
+888B5D     (base 16)		Storage Appliance Corporation 
+				29 Su Zhou Jie, Haidian Dist.
+				Beijing     100080
+				CN
+
+78-C6-BB   (hex)		Innovasic, Inc.
+78C6BB     (base 16)		Innovasic, Inc.
+				5635 Jefferson St. NE, Suite A
+				Albuquerque  NM  87109
+				US
+
+84-A9-91   (hex)		Cyber Trans Japan Co.,Ltd.
+84A991     (base 16)		Cyber Trans Japan Co.,Ltd.
+				
+				Setagaya-ku  Tokyo  155-0031
+				JP
+
+68-78-4C   (hex)		Nortel Networks
+68784C     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+F8-D7-56   (hex)		Simm Tronic Limited 
+F8D756     (base 16)		Simm Tronic Limited 
+				Unit 3, Waterside
+				Hoddesdon  Hertfordshire  EN11 0QR
+				GB
+
+04-A3-F3   (hex)		Emicon
+04A3F3     (base 16)		Emicon
+				shelkovskoe shosse, 77
+				Moscow    107241
+				RU
+
+1C-17-D3   (hex)		Cisco Systems, Inc
+1C17D3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-E0-44   (hex)		NEON Inc
+7CE044     (base 16)		NEON Inc
+				5340 Airport Boulevard
+				Boulder  CO  80301
+				US
+
+28-4C-53   (hex)		Intune Networks
+284C53     (base 16)		Intune Networks
+				9B Beckett Way
+				Dublin     12
+				IE
+
+64-D0-2D   (hex)		Next Generation Integration (NGI)
+64D02D     (base 16)		Next Generation Integration (NGI)
+				137 rue de Versailles
+				Le Chesnay    78150
+				FR
+
+90-51-3F   (hex)		Elettronica Santerno SpA
+90513F     (base 16)		Elettronica Santerno SpA
+				Via della Concia 7
+				Castel Guelfo (BO)    40026
+				IT
+
+88-41-C1   (hex)		ORBISAT DA AMAZONIA IND E AEROL SA
+8841C1     (base 16)		ORBISAT DA AMAZONIA IND E AEROL SA
+				AV SHISHIMA HIFUMI, 2911
+				SAO JOSE DOS CAMPOS  São Paulo  12244-000
+				BR
+
+9C-75-14   (hex)		Wildix srl
+9C7514     (base 16)		Wildix srl
+				loc. Le Basse, 3
+				Trento  TN  38100
+				IT
+
+4C-F7-37   (hex)		SamJi Electronics Co., Ltd
+4CF737     (base 16)		SamJi Electronics Co., Ltd
+				459-21, Gasan-dong, Gumchun-ku
+				Seoul    153-803
+				KR
+
+F0-D7-67   (hex)		Axema Passagekontroll AB
+F0D767     (base 16)		Axema Passagekontroll AB
+				Box 90 215
+				Stockholm    120 23 
+				SE
+
+C8-4C-75   (hex)		Cisco Systems, Inc
+C84C75     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-02-A6   (hex)		Beijing Newmine Technology
+C802A6     (base 16)		Beijing Newmine Technology
+				10 floor,Keshi Plaza
+				Beijing    100085
+				CN
+
+4C-8B-55   (hex)		Grupo Digicon
+4C8B55     (base 16)		Grupo Digicon
+				Rua Nissin Castiel, 640
+				Gravataí  Rio Grande do Sul  94045420
+				BR
+
+6C-5C-DE   (hex)		SunReports, Inc.
+6C5CDE     (base 16)		SunReports, Inc.
+				1406 Cedarwood Dr.
+				San Mateo  CA  94403
+				US
+
+34-F3-9B   (hex)		WizLAN Ltd.
+34F39B     (base 16)		WizLAN Ltd.
+				P.O.Box 7948
+				Haifa    31078
+				IL
+
+E8-6C-DA   (hex)		Supercomputers and Neurocomputers Research Center
+E86CDA     (base 16)		Supercomputers and Neurocomputers Research Center
+				2, Chekhov st
+				Taganrog   Rostov-on-Don region   347922 
+				RU
+
+24-0B-2A   (hex)		Viettel Group
+240B2A     (base 16)		Viettel Group
+				Center for Research and Development
+				Hanoi    1111
+				VN
+
+00-B5-D6   (hex)		Omnibit Inc.
+00B5D6     (base 16)		Omnibit Inc.
+				2-7-9, Soto-Kanda
+				Chiyoda-ku  Tokyo  101-0021
+				JP
+
+54-89-22   (hex)		Zelfy Inc
+548922     (base 16)		Zelfy Inc
+				4655 Old Ironsides Dr, Suite#200
+				Santa Clara  Ca  95054
+				US
+
+50-C5-8D   (hex)		Juniper Networks
+50C58D     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+24-A4-2C   (hex)		KOUKAAM a.s.
+24A42C     (base 16)		KOUKAAM a.s.
+				U vinnych sklepu 7
+				Prague    190 00
+				CZ
+
+4C-30-89   (hex)		Thales Transportation Systems GmbH
+4C3089     (base 16)		Thales Transportation Systems GmbH
+				Bierweg 2
+				Arnstadt  Thuringia  99310
+				DE
+
+48-12-49   (hex)		Luxcom Technologies Inc.
+481249     (base 16)		Luxcom Technologies Inc.
+				102 Walgreen Road
+				Ottawa  Ontario  K0A 1L0
+				CA
+
+24-A9-37   (hex)		PURE Storage
+24A937     (base 16)		PURE Storage
+				650 Castro Street
+				Mt. View  CA  94041
+				US
+
+34-83-02   (hex)		iFORCOM Co., Ltd
+348302     (base 16)		iFORCOM Co., Ltd
+				1326
+				Sagamihara  Kanagawa  252-0157
+				JP
+
+B4-3D-B2   (hex)		Degreane Horizon
+B43DB2     (base 16)		Degreane Horizon
+				730 Rue de l'Initiative
+				Cuers  Var  83390
+				FR
+
+84-F6-4C   (hex)		Cross Point BV
+84F64C     (base 16)		Cross Point BV
+				Postbus 2112
+				Emmen  Drenthe  7801 CC
+				NL
+
+C0-8B-6F   (hex)		S I Sistemas Inteligentes Eletrônicos Ltda
+C08B6F     (base 16)		S I Sistemas Inteligentes Eletrônicos Ltda
+				Rua Amadeu Piotto 161
+				Curitiba  Paraná  81280020
+				BR
+
+F8-6E-CF   (hex)		Arcx Inc
+F86ECF     (base 16)		Arcx Inc
+				151 Amber St, Unit 1
+				Markham  ON  L3R 3B3
+				CA
+
+8C-84-01   (hex)		Private
+8C8401     (base 16)		Private
+
+40-84-93   (hex)		Clavister AB
+408493     (base 16)		Clavister AB
+				Sjogatan 6J
+				Ornskoldsvik    89160
+				SE
+
+78-A6-BD   (hex)		DAEYEON Control&Instrument Co,.Ltd
+78A6BD     (base 16)		DAEYEON Control&Instrument Co,.Ltd
+				ACETECHNOTOWER 2-108, 197-7, Guro3-Dong, Guro-Gu, 
+				Seoul    152-766
+				KR
+
+3C-19-15   (hex)		GFI Chrono Time
+3C1915     (base 16)		GFI Chrono Time
+				121 rue des Guillees
+				CHAURAY    79180
+				FR
+
+EC-B1-06   (hex)		Acuro Networks, Inc
+ECB106     (base 16)		Acuro Networks, Inc
+				42808 Christy St., Suite 100
+				Fremont  CA  94538
+				US
+
+C8-35-B8   (hex)		Ericsson, EAB/RWI/K
+C835B8     (base 16)		Ericsson, EAB/RWI/K
+				Skolgången 17
+				    SE-800 06
+				SE
+
+F8-9D-0D   (hex)		Control Technology Inc.
+F89D0D     (base 16)		Control Technology Inc.
+				7608 North Hudson Ave
+				Oklahoma City  OK  73116
+				US
+
+2C-3F-3E   (hex)		Alge-Timing GmbH
+2C3F3E     (base 16)		Alge-Timing GmbH
+				Rotkreuzstrasse 39
+				Lustenau    6890
+				AT
+
+08-9F-97   (hex)		LEROY AUTOMATION
+089F97     (base 16)		LEROY AUTOMATION
+				35, Boulevard du Libre Echange
+				Saint Orens de Gameville    31650
+				FR
+
+34-BA-51   (hex)		Se-Kure Controls, Inc.
+34BA51     (base 16)		Se-Kure Controls, Inc.
+				3714 Runge Street
+				Franklin Park  IL  60131
+				US
+
+6C-70-39   (hex)		Novar GmbH
+6C7039     (base 16)		Novar GmbH
+				Johannes-Mauthe-Str. 14
+				Albstadt  Baden-Württemberg  72458
+				DE
+
+98-2D-56   (hex)		Resolution Audio
+982D56     (base 16)		Resolution Audio
+				88 Hoff Street #106
+				San Francisco  CA  94110
+				US
+
+14-73-73   (hex)		TUBITAK UEKAE
+147373     (base 16)		TUBITAK UEKAE
+				ANIBAL ST.
+				KOCAELI    41470
+				TR
+
+FC-CF-62   (hex)		IBM Corp
+FCCF62     (base 16)		IBM Corp
+				2051 Mission College Blvd 
+				Santa Clara  CA  95054
+				US
+
+08-4E-1C   (hex)		H2A Systems, LLC
+084E1C     (base 16)		H2A Systems, LLC
+				7545 Irvine Center Drive
+				Irvine  CA  92618
+				US
+
+88-B6-27   (hex)		Gembird Europe BV
+88B627     (base 16)		Gembird Europe BV
+				Wittevrouwen 56
+				Almere  Flevoland  1358CD
+				NL
+
+F0-68-53   (hex)		Integrated Corporation
+F06853     (base 16)		Integrated Corporation
+				3/F, Shun On Commercial Bldg., 
+				Cetnral,    
+				HK
+
+A4-AD-B8   (hex)		Vitec Group, Camera Dynamics Ltd
+A4ADB8     (base 16)		Vitec Group, Camera Dynamics Ltd
+				William Vinten Building
+				Bury St Edmunds  Suffolk  IP33 3TB
+				GB
+
+A4-B1-21   (hex)		Arantia 2010 S.L.
+A4B121     (base 16)		Arantia 2010 S.L.
+				Volta do Castro s/n
+				Santiago de Compostela  A Coruña  15706
+				ES
+
+E0-26-36   (hex)		Nortel Networks
+E02636     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+5C-57-C8   (hex)		Nokia Corporation
+5C57C8     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+D4-6C-BF   (hex)		Goodrich ISR
+D46CBF     (base 16)		Goodrich ISR
+				6600 Gulton Crt
+				Albuquerque  NM  87109
+				US
+
+E0-26-30   (hex)		Intrigue Technologies, Inc.
+E02630     (base 16)		Intrigue Technologies, Inc.
+				800 Old Pond Road
+				Bridgeville  PA  15017
+				US
+
+EC-C8-82   (hex)		Cisco Systems, Inc
+ECC882     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-FD-B9   (hex)		Proware Technologies Co Ltd.
+6CFDB9     (base 16)		Proware Technologies Co Ltd.
+				2nd F1 East Wing,South Section,Factory Building 24,Science&Technology Park
+				Shenzhen  Guangdong  518000
+				CN
+
+10-18-9E   (hex)		Elmo Motion Control
+10189E     (base 16)		Elmo Motion Control
+				64 Gisin St.
+				Petach Tikva    49103
+				IL
+
+8C-56-C5   (hex)		Nintendo Co., Ltd.
+8C56C5     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+CC-B8-88   (hex)		AnB Securite s.a.
+CCB888     (base 16)		AnB Securite s.a.
+				Rue de Joie,38-40
+				Liege    4000
+				BE
+
+6C-5E-7A   (hex)		Ubiquitous Internet Telecom Co., Ltd
+6C5E7A     (base 16)		Ubiquitous Internet Telecom Co., Ltd
+				#512, 5th Floor, Kolon Digital Valley,Guro 3(sam)-dong, Guro-gu
+				Seoul    152-777
+				KR
+
+B4-2C-BE   (hex)		Direct Payment Solutions Limited
+B42CBE     (base 16)		Direct Payment Solutions Limited
+				98 Anzac Avenue
+				Auckland    1035
+				NZ
+
+CC-22-18   (hex)		InnoDigital Co., Ltd.
+CC2218     (base 16)		InnoDigital Co., Ltd.
+				No.310 3F Kofomo Tower
+				Sungnam-city  Kyunggi-do  463-825
+				KR
+
+C8-6C-1E   (hex)		Display Systems Ltd
+C86C1E     (base 16)		Display Systems Ltd
+				16-Parkovaja Street 26
+				Moscow    105484
+				RU
+
+A0-18-59   (hex)		Shenzhen Yidashi Electronics Co Ltd
+A01859     (base 16)		Shenzhen Yidashi Electronics Co Ltd
+				Building A10, Fukang Industrial Zone
+				Shenzhen   Guangdong   518110
+				CN
+
+E8-05-6D   (hex)		Nortel Networks
+E8056D     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+C4-59-76   (hex)		Fugoo Coorporation
+C45976     (base 16)		Fugoo Coorporation
+				8001 Irvine Center Drive
+				Irvine  CA  62618
+				US
+
+90-A7-C1   (hex)		Pakedge Device and Software Inc.
+90A7C1     (base 16)		Pakedge Device and Software Inc.
+				1011 Edwards Road
+				Burlingame  CA  94010
+				US
+
+80-BA-AC   (hex)		TeleAdapt Ltd
+80BAAC     (base 16)		TeleAdapt Ltd
+				Axis 5
+				Watford  Hertfordshire  WD244YW
+				GB
+
+50-2D-F4   (hex)		Phytec Messtechnik GmbH
+502DF4     (base 16)		Phytec Messtechnik GmbH
+				Robert-Koch-Straße 39
+				Mainz  Rheinland-Pfalz  55129
+				DE
+
+2C-CD-27   (hex)		Precor Inc
+2CCD27     (base 16)		Precor Inc
+				20031 142nd Avenue NE
+				Woodinville  WA  98072
+				US
+
+10-43-69   (hex)		Soundmax Electronic Limited 
+104369     (base 16)		Soundmax Electronic Limited 
+				Room#1505, Oriental plaza, #1072 JianShe Road
+				SHENZHEN   Guangdong  518001
+				CN
+
+C0-6C-0F   (hex)		Dobbs Stanford
+C06C0F     (base 16)		Dobbs Stanford
+				2715 Electronic Lane
+				Dallas  Texas  75220
+				US
+
+C8-6C-B6   (hex)		Optcom Co., Ltd.
+C86CB6     (base 16)		Optcom Co., Ltd.
+				792-3 Tomigaoka
+				Iwata  Shizuoka  438-0803
+				JP
+
+58-49-BA   (hex)		Chitai Electronic Corp.
+5849BA     (base 16)		Chitai Electronic Corp.
+				5F., No. 1 Lane 123, Pao-Chung Rd., Hsin-Tien City 
+				Taiepi    23144
+				TW
+
+00-D1-1C   (hex)		ACETEL
+00D11C     (base 16)		ACETEL
+				#1006, World Merdian 2-cha, 426-5,
+				Seoul    153-759
+				KR
+
+60-1D-0F   (hex)		Midnite Solar
+601D0F     (base 16)		Midnite Solar
+				17722 67th Ave NE #C
+				Arlington  WA  98223
+				US
+
+A8-F9-4B   (hex)		Eltex Enterprise Ltd.
+A8F94B     (base 16)		Eltex Enterprise Ltd.
+				Okruzhnaya st. 29v
+				Novosibirsk    630020
+				RU
+
+0C-82-30   (hex)		SHENZHEN MAGNUS TECHNOLOGIES CO.,LTD
+0C8230     (base 16)		SHENZHEN MAGNUS TECHNOLOGIES CO.,LTD
+				c-504,Skyworth Building,No.8 Road,High-tech south,Nanshan District,
+				Shenzhen  Guangdong  518057
+				CN
+
+74-6B-82   (hex)		MOVEK 
+746B82     (base 16)		MOVEK 
+				6517 Navaho Trail
+				Edina  Minnesota  55439
+				US
+
+9C-C0-77   (hex)		PrintCounts, LLC
+9CC077     (base 16)		PrintCounts, LLC
+				5109 W Lemon St
+				Tampa  FL  33609
+				US
+
+3C-B1-7F   (hex)		Wattwatchers Pty Ld
+3CB17F     (base 16)		Wattwatchers Pty Ld
+				22 Woodbury Rd St. Ives
+				Sydney  NSW  2075
+				AU
+
+CC-54-59   (hex)		OnTime Networks AS
+CC5459     (base 16)		OnTime Networks AS
+				Gladsvei 20
+				Oslo    0489
+				NO
+
+F8-DC-7A   (hex)		Variscite LTD
+F8DC7A     (base 16)		Variscite LTD
+				60 Medinat Hayehudim st.
+				Hertzelia    46722
+				IL
+
+D4-F1-43   (hex)		IPROAD.,Inc
+D4F143     (base 16)		IPROAD.,Inc
+				#505 Byuksan digital valley 7, 170-13,
+				Seoul    152-847
+				KR
+
+B8-F7-32   (hex)		Aryaka Networks Inc
+B8F732     (base 16)		Aryaka Networks Inc
+				691 S. Milpitas Blvd., 
+				Milpitas   CA  95035
+				US
+
+E8-DF-F2   (hex)		PRF Co., Ltd.
+E8DFF2     (base 16)		PRF Co., Ltd.
+				#510, Leaders B/D, Yatop-dong
+				Seongnam-city  Gyeonggi-do  463-828
+				KR
+
+B4-ED-54   (hex)		Wohler Technologies
+B4ED54     (base 16)		Wohler Technologies
+				31055 Huntwood Avenue
+				Hayward  CA  94544
+				US
+
+00-64-40   (hex)		Cisco Systems, Inc
+006440     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+94-C4-E9   (hex)		PowerLayer Microsystems HongKong Limited
+94C4E9     (base 16)		PowerLayer Microsystems HongKong Limited
+				23 Zhichun Rd,Liangziyinzuo Rm1009
+				Beijing    100083
+				CN
+
+88-43-E1   (hex)		Cisco Systems, Inc
+8843E1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-86-2A   (hex)		Heinz Lackmann GmbH & Co KG
+34862A     (base 16)		Heinz Lackmann GmbH & Co KG
+				Harkortstraße 15
+				Münster  NRW  48163
+				DE
+
+AC-E3-48   (hex)		MadgeTech, Inc
+ACE348     (base 16)		MadgeTech, Inc
+				879 Maple St
+				Contoocook  NH  03229
+				US
+
+54-9A-16   (hex)		Uzushio Electric Co.,Ltd.
+549A16     (base 16)		Uzushio Electric Co.,Ltd.
+				105
+				Imabari-city  Ehime pref.  7948582
+				JP
+
+90-18-AE   (hex)		Shanghai Meridian Technologies, Co. Ltd.
+9018AE     (base 16)		Shanghai Meridian Technologies, Co. Ltd.
+				Suite 6A Tongsheng Tower
+				Pudong  shanghai  200122
+				CN
+
+04-94-A1   (hex)		CATCH THE WIND INC
+0494A1     (base 16)		CATCH THE WIND INC
+				10781 JAMES PAYNE COURT
+				MANASSAS  VA  20110
+				US
+
+00-3A-99   (hex)		Cisco Systems, Inc
+003A99     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-3A-9A   (hex)		Cisco Systems, Inc
+003A9A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-3A-98   (hex)		Cisco Systems, Inc
+003A98     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-A6-E3   (hex)		David Clark Company
+50A6E3     (base 16)		David Clark Company
+				360 Franklin St.
+				Worcester  MA  01615
+				US
+
+50-93-4F   (hex)		Gradual Tecnologia Ltda.
+50934F     (base 16)		Gradual Tecnologia Ltda.
+				Rua Attilio Giaretta, 110
+				Itatiba  SP  13257-584
+				BR
+
+B8-B1-C7   (hex)		BT&COM CO.,LTD
+B8B1C7     (base 16)		BT&COM CO.,LTD
+				#1103, E&C Venture Dream Tower II
+				Seoul    152-719
+				KR
+
+DC-2C-26   (hex)		Iton Technology Limited
+DC2C26     (base 16)		Iton Technology Limited
+				Room 10E, JingFeng Building, 
+				ShenZhen  GuangDong  518034
+				CN
+
+D4-11-D6   (hex)		ShotSpotter, Inc.
+D411D6     (base 16)		ShotSpotter, Inc.
+				1060 Terra Bella Ave.
+				Mountain View  CA  94043
+				US
+
+9C-AF-CA   (hex)		Cisco Systems, Inc
+9CAFCA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+1C-0F-CF   (hex)		Sypro Optics GmbH
+1C0FCF     (base 16)		Sypro Optics GmbH
+				Carl-Zeiss-Promenade 10
+				Jena  Thuringia  07745
+				DE
+
+9C-4E-8E   (hex)		ALT Systems Ltd
+9C4E8E     (base 16)		ALT Systems Ltd
+				PoBox 17
+				Helsinki    00761
+				FI
+
+70-72-CF   (hex)		EdgeCore Networks
+7072CF     (base 16)		EdgeCore Networks
+				20 Mason
+				Irvine  CA  92618
+				US
+
+EC-D0-0E   (hex)		MiraeRecognition Co., Ltd.
+ECD00E     (base 16)		MiraeRecognition Co., Ltd.
+				PrimeBank Bldg. Annex-3F, #278-3
+				Seoul    135-833
+				KR
+
+A4-AD-00   (hex)		Ragsdale Technology
+A4AD00     (base 16)		Ragsdale Technology
+				505 Echo Lane
+				Big Bear Lake  CA  92315
+				US
+
+4C-9E-E4   (hex)		Hanyang Navicom Co.,Ltd.
+4C9EE4     (base 16)		Hanyang Navicom Co.,Ltd.
+				713, Gwanpyeong-dong, Yusung-gu
+				Daejeon    305-509
+				KR
+
+C8-72-48   (hex)		Aplicom Oy
+C87248     (base 16)		Aplicom Oy
+				Rautatienkatu 56
+				Äänekoski  Länsi-Suomi  44101
+				FI
+
+C4-7D-4F   (hex)		Cisco Systems, Inc
+C47D4F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-DF-1E   (hex)		Cisco Systems, Inc
+3CDF1E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+98-6D-C8   (hex)		TOSHIBA MITSUBISHI-ELECTRIC INDUSTRIAL SYSTEMS CORPORATION
+986DC8     (base 16)		TOSHIBA MITSUBISHI-ELECTRIC INDUSTRIAL SYSTEMS CORPORATION
+				 TOKYO SQUARE GARDEN
+				 3-1-1 Kyobashi, CHUO-KU  Tokyo  104-0031
+				JP
+
+6C-AC-60   (hex)		Venetex Corp
+6CAC60     (base 16)		Venetex Corp
+				8-3-9,Shin-machi
+				Ome-shi,  Tokyo  198-0024
+				JP
+
+F0-4B-F2   (hex)		JTECH Communications, Inc.
+F04BF2     (base 16)		JTECH Communications, Inc.
+				6413 Congress Ave.
+				Boca Raton  FL  33487
+				US
+
+04-2B-BB   (hex)		PicoCELA, Inc.
+042BBB     (base 16)		PicoCELA, Inc.
+				3-8-33, Momochihama
+				Fukuoka-city  Fukuoka  814-0001
+				JP
+
+FC-08-77   (hex)		Prentke Romich Company
+FC0877     (base 16)		Prentke Romich Company
+				1022 Heyl Rd
+				Wooster  OH  44691
+				US
+
+64-F9-70   (hex)		Kenade Electronics Technology Co.,LTD.
+64F970     (base 16)		Kenade Electronics Technology Co.,LTD.
+				F/G room,11/F,Hangdu building,Huafu Rd, Futian district,
+				ShenZhen  GuangDong  518028
+				CN
+
+C8-2E-94   (hex)		Halfa Enterprise Co., Ltd.
+C82E94     (base 16)		Halfa Enterprise Co., Ltd.
+				5F, No.102, Ming Chuan Road
+				Hsin Tien  Taipei County  23141
+				TW
+
+80-17-7D   (hex)		Nortel Networks
+80177D     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+7C-7B-E4   (hex)		Z'SEDAI KENKYUSHO CORPORATION
+7C7BE4     (base 16)		Z'SEDAI KENKYUSHO CORPORATION
+				Meikai sannomiya 2nd Bldg. 11th/fl.
+				Kobe  Hyogo  650-0034
+				JP
+
+F0-DE-71   (hex)		Shanghai EDO Technologies Co.,Ltd.
+F0DE71     (base 16)		Shanghai EDO Technologies Co.,Ltd.
+				Unit 12302, Building 12,498 Guoshoujing Road, Pudong New Area
+				Shanghai    201203
+				CN
+
+60-D3-0A   (hex)		Quatius Limited
+60D30A     (base 16)		Quatius Limited
+				Units 05-07, 16/F, Greenfield Tower, Concordia Plaza,
+				Kowloon    
+				HK
+
+24-CF-21   (hex)		Shenzhen State Micro Technology Co., Ltd
+24CF21     (base 16)		Shenzhen State Micro Technology Co., Ltd
+				SSMEC Building2/F, Gao Xin Nan First Avenue, Hi-Tech Park South, Nanshan
+				Shenzhen City  Guangdong Province  518057
+				CN
+
+10-BA-A5   (hex)		GANA I&C CO., LTD
+10BAA5     (base 16)		GANA I&C CO., LTD
+				154-17 kyoungdong B/D 3F karak-dong songpa-gu
+				Seoul  Korea  138-160
+				KR
+
+BC-9D-A5   (hex)		DASCOM Europe GmbH
+BC9DA5     (base 16)		DASCOM Europe GmbH
+				Heuweg 3
+				Ulm  Baden-Württemberg  89079
+				DE
+
+28-FB-D3   (hex)		Ragentek Technology Group
+28FBD3     (base 16)		Ragentek Technology Group
+				D10/D11，No.3188, Xiupu Road, PuDong District, Shanghai
+				Shanghai    201703
+				CN
+
+58-6E-D6   (hex)		Private
+586ED6     (base 16)		Private
+
+EC-30-91   (hex)		Cisco Systems, Inc
+EC3091     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-BC-11   (hex)		CombiQ AB
+64BC11     (base 16)		CombiQ AB
+				Science Park
+				Jonkoping    553 18
+				SE
+
+C8-C1-3C   (hex)		RuggedTek Hangzhou Co., Ltd
+C8C13C     (base 16)		RuggedTek Hangzhou Co., Ltd
+				Zhejiang University National Science Park
+				Hangzhou  Zhejiang  310013
+				CN
+
+F4-AC-C1   (hex)		Cisco Systems, Inc
+F4ACC1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-97-D1   (hex)		BK Electronics cc
+4097D1     (base 16)		BK Electronics cc
+				150 Swaardlelie Ave
+				Pretoria  Gauteng  0184
+				ZA
+
+0C-E9-36   (hex)		ELIMOS srl
+0CE936     (base 16)		ELIMOS srl
+				Area Science Park - Padriciano 99
+				TRIESTE    34149
+				IT
+
+A0-2E-F3   (hex)		United Integrated Services Co., Led.
+A02EF3     (base 16)		United Integrated Services Co., Led.
+				5F No 3 Lane 7 Packao Road Hsintien
+				Taipei Hsien    23144
+				TW
+
+A0-98-05   (hex)		OpenVox Communication Co Ltd
+A09805     (base 16)		OpenVox Communication Co Ltd
+				F2,Building No.14,Shangsha Science &
+				ShenZhen  GuangDong  518031
+				CN
+
+60-39-1F   (hex)		ABB Ltd
+60391F     (base 16)		ABB Ltd
+				Distribution Automation
+				Vadodara  Gujarat  390013
+				IN
+
+E8-A4-C1   (hex)		Deep Sea Electronics Ltd
+E8A4C1     (base 16)		Deep Sea Electronics Ltd
+				Highfield House
+				Hunmanby  North Yorkshire  YO14 0PH
+				GB
+
+C8-D2-C1   (hex)		Jetlun (Shenzhen) Corporation
+C8D2C1     (base 16)		Jetlun (Shenzhen) Corporation
+				1008A Skyworth Building, Gao-xin Rd South
+				Shenzhen    518057
+				CN
+
+E0-91-53   (hex)		XAVi Technologies Corp.
+E09153     (base 16)		XAVi Technologies Corp.
+				9F., No129, Xingde RD.,Sanchong Dist.,
+				New Taipei  Taiwan  24158
+				TW
+
+88-A5-BD   (hex)		QPCOM INC.
+88A5BD     (base 16)		QPCOM INC.
+				6030 NW 99 AVE
+				DORAL  FLORIDA  33178
+				US
+
+D4-C7-66   (hex)		Acentic GmbH
+D4C766     (base 16)		Acentic GmbH
+				Venloer Strasse 151-153
+				Cologne    50672
+				DE
+
+00-27-12   (hex)		MaxVision LLC
+002712     (base 16)		MaxVision LLC
+				495 Production Ave
+				Madison  AL  35758
+				US
+
+00-27-1F   (hex)		MIPRO Electronics Co., Ltd
+00271F     (base 16)		MIPRO Electronics Co., Ltd
+				814,Peikang Road
+				Chiayi    60096
+				TW
+
+00-27-0C   (hex)		Cisco Systems, Inc
+00270C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-CF   (hex)		DEKA R&D
+0026CF     (base 16)		DEKA R&D
+				340 Commercial Street
+				Manchester  NH  03101
+				US
+
+00-26-E7   (hex)		Shanghai ONLAN Communication Tech. Co., Ltd.
+0026E7     (base 16)		Shanghai ONLAN Communication Tech. Co., Ltd.
+				3F, 6C, No. 1658, Gumei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+00-26-E0   (hex)		ASITEQ
+0026E0     (base 16)		ASITEQ
+				5F, DONGYOUNG Bldg,382-6,Yatap dong
+				Sung Nam si  Kyounggi-do  463-827
+				KR
+
+00-27-03   (hex)		Testech Electronics Pte Ltd
+002703     (base 16)		Testech Electronics Pte Ltd
+				Block 118, #05-110,
+				Singapore    380118
+				SG
+
+00-26-F3   (hex)		SMC Networks
+0026F3     (base 16)		SMC Networks
+				20 Mason
+				Irvine  CA  92618
+				US
+
+00-26-A5   (hex)		MICROROBOT.CO.,LTD
+0026A5     (base 16)		MICROROBOT.CO.,LTD
+				167-3 Gungpyeong-ri
+				Gwangju-si  Gyeonggi-Do  464-881
+				KR
+
+00-26-A3   (hex)		FQ Ingenieria Electronica S.A.
+0026A3     (base 16)		FQ Ingenieria Electronica S.A.
+				Avda. Roquetes 9
+				Sant Pere de Ribes  Barcelona  08812
+				ES
+
+00-26-9D   (hex)		M2Mnet Co., Ltd.
+00269D     (base 16)		M2Mnet Co., Ltd.
+				607 Downtown Bld. 1043-1 Hogye-Dong Dongan-Gu
+				Anyang-City  Kyunggi-Do  431-080
+				KR
+
+00-26-97   (hex)		Alpha  Technologies Inc.
+002697     (base 16)		Alpha  Technologies Inc.
+				3767 Alpha Way
+				Bellingham  WA  98226 
+				US
+
+00-26-8A   (hex)		Terrier SC Ltd
+00268A     (base 16)		Terrier SC Ltd
+				Strettit Farm
+				East Peckham  Kent  TN12 5EE
+				GB
+
+00-26-89   (hex)		General Dynamics Robotic Systems
+002689     (base 16)		General Dynamics Robotic Systems
+				1231 Tech Court
+				Westminster  MD  21157
+				US
+
+00-26-C5   (hex)		Guangdong Gosun Telecommunications Co.,Ltd
+0026C5     (base 16)		Guangdong Gosun Telecommunications Co.,Ltd
+				Guangdong software park D, No.11, CaiPing road , Guangzhou science city
+				Guangzhou  Guangdong  510663
+				CN
+
+00-26-C4   (hex)		Cadmos microsystems S.r.l.
+0026C4     (base 16)		Cadmos microsystems S.r.l.
+				Via Pietro Frattini, 255
+				Roma    00149
+				IT
+
+00-26-C8   (hex)		System Sensor
+0026C8     (base 16)		System Sensor
+				3825 Ohio Avenue
+				Saint Charles  IL  60174
+				US
+
+00-26-7A   (hex)		wuhan hongxin telecommunication technologies co.,ltd
+00267A     (base 16)		wuhan hongxin telecommunication technologies co.,ltd
+				No.5 Donxin Road,Wuhan East Lake High-Tech Development Zone
+				Wuhan  Hubei  430073
+				CN
+
+00-26-C2   (hex)		SCDI Co. LTD
+0026C2     (base 16)		SCDI Co. LTD
+				#451, Hagal-Dong, Giheung-Gu,
+				Yongin-Si  Gyeonggi-Do  446-930
+				KR
+
+00-26-85   (hex)		Digital Innovation
+002685     (base 16)		Digital Innovation
+				Travbaneveien 6
+				Trondheim    7044
+				NO
+
+00-26-A9   (hex)		Strong Technologies Pty Ltd
+0026A9     (base 16)		Strong Technologies Pty Ltd
+				60 Wedgewood Road
+				Hallam  Victoria  3803
+				AU
+
+00-26-72   (hex)		AAMP of America
+002672     (base 16)		AAMP of America
+				13190 56th Court
+				Clearwater  Florida  33760
+				US
+
+00-25-FD   (hex)		OBR Centrum Techniki Morskiej S.A.
+0025FD     (base 16)		OBR Centrum Techniki Morskiej S.A.
+				Dickmana 62
+				Gdynia    81-109
+				US
+
+00-26-00   (hex)		TEAC Australia Pty Ltd.
+002600     (base 16)		TEAC Australia Pty Ltd.
+				75 Northgate Drive
+				Thomastown  Victoria  3074
+				AU
+
+00-25-FF   (hex)		CreNova Multimedia Co., Ltd
+0025FF     (base 16)		CreNova Multimedia Co., Ltd
+				7/F, Hana EZ Tower, Gumi-Dong 10, Sungnam Rd 43,
+				Sungnam-Si  Kyunggi-Do  463-870
+				KR
+
+00-26-04   (hex)		Audio Processing Technology Ltd
+002604     (base 16)		Audio Processing Technology Ltd
+				Whiterock Business Park
+				Belfast    BT12 7FP
+				GB
+
+00-26-59   (hex)		Nintendo Co., Ltd.
+002659     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-26-51   (hex)		Cisco Systems, Inc
+002651     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-12   (hex)		Space Exploration Technologies
+002612     (base 16)		Space Exploration Technologies
+				1 Rocket Road
+				Hawthorne  CA  90250
+				US
+
+00-26-16   (hex)		Rosemount Inc.
+002616     (base 16)		Rosemount Inc.
+				8200 Market Boulevard
+				Chanhassen  MN  55317
+				US
+
+00-26-0B   (hex)		Cisco Systems, Inc
+00260B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-23   (hex)		JRD Communication Inc
+002623     (base 16)		JRD Communication Inc
+				16/F, TCL Tower, Gaoxin Nanyi Road, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-26-27   (hex)		Truesell
+002627     (base 16)		Truesell
+				301 Sungyun Bldg, 89-2
+				Seocho-gu,  Seoul  137-130
+				KR
+
+00-26-4E   (hex)		Rail & Road Protec GmbH
+00264E     (base 16)		Rail & Road Protec GmbH
+				Norderhofenden 12-13
+				Flensburg    24937
+				DE
+
+00-26-4F   (hex)		Krüger &Gothe GmbH
+00264F     (base 16)		Krüger &Gothe GmbH
+				Atzendorfer Straße 19
+				Staßfurt  Sachsen Anhalt  39418
+				DE
+
+00-26-21   (hex)		InteliCloud Technology Inc.
+002621     (base 16)		InteliCloud Technology Inc.
+				895 Dove St.
+				Newport Beach  CA  92660
+				US
+
+00-26-1C   (hex)		NEOVIA INC.
+00261C     (base 16)		NEOVIA INC.
+				503 LOTTE IT CASTLE 1DONG,550-1
+				SEOUL    153-768
+				KR
+
+00-26-64   (hex)		Core System Japan
+002664     (base 16)		Core System Japan
+				Bunshu Bldg,2-27-6,Myojin
+				Hachioji  Tokyo  1920046
+				JP
+
+00-26-39   (hex)		T.M. Electronics, Inc.
+002639     (base 16)		T.M. Electronics, Inc.
+				45 Main St
+				Boylston  MA  01505
+				US
+
+00-25-C6   (hex)		kasercorp, ltd
+0025C6     (base 16)		kasercorp, ltd
+				South 20,Gaobu Road,Gaobu Town
+				Dongwan  Guangdong  523000
+				CN
+
+00-25-C5   (hex)		Star Link Communication Pvt. Ltd.
+0025C5     (base 16)		Star Link Communication Pvt. Ltd.
+				HR114/6 & Hr132/6, Pulprehladpur,
+				New Delhi    110044
+				IN
+
+00-25-C7   (hex)		altek Corporation
+0025C7     (base 16)		altek Corporation
+				3F, No. 10, Li-Hsin Road, Science-Based Industrial Park,
+				Hsinchu    
+				TW
+
+00-25-E6   (hex)		Belgian Monitoring Systems bvba
+0025E6     (base 16)		Belgian Monitoring Systems bvba
+				Th. Sevenslaan 106
+				Kortrijk  WVL  8500
+				BE
+
+00-25-E0   (hex)		CeedTec Sdn Bhd
+0025E0     (base 16)		CeedTec Sdn Bhd
+				303-4-5, Krystal Point Business Center
+				Bayan Lepas  Penang  11900
+				MY
+
+00-25-DE   (hex)		Probits Co., LTD.
+0025DE     (base 16)		Probits Co., LTD.
+				#1502, Kolon Science Valley II, 811
+				Seoul    152-878
+				KR
+
+00-25-B0   (hex)		Schmartz Inc
+0025B0     (base 16)		Schmartz Inc
+				2307 Valerian Trl
+				Round Rock  TX  78665
+				US
+
+00-25-AD   (hex)		Manufacturing Resources International
+0025AD     (base 16)		Manufacturing Resources International
+				6415 Shiloh Road East
+				Alpharetta  GA  30005
+				US
+
+00-25-AC   (hex)		I-Tech corporation
+0025AC     (base 16)		I-Tech corporation
+				1-15 Shin-ogawa machi
+				Shinjyuku-ku  Tokyo  162-0814
+				JP
+
+00-25-AB   (hex)		AIO LCD PC BU / TPV
+0025AB     (base 16)		AIO LCD PC BU / TPV
+				10F., No., 230, Liancheng Rd.
+				Zhonghe City  Taipei Taiwan  23553
+				TW
+
+00-25-EC   (hex)		Humanware
+0025EC     (base 16)		Humanware
+				445 rue du Parc Industriel
+				Longueuil  Québec  J4H 3V7
+				CA
+
+00-25-ED   (hex)		NuVo Technologies LLC
+0025ED     (base 16)		NuVo Technologies LLC
+				3015 Kustom Drive
+				Hebron  KY  41048
+				US
+
+00-25-E9   (hex)		i-mate Development, Inc.
+0025E9     (base 16)		i-mate Development, Inc.
+				8383 158th Ave. N.E., Suite 300, Redmond,
+				Washington  WA  98052-3871
+				US
+
+00-25-BA   (hex)		Alcatel-Lucent IPD
+0025BA     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+00-25-BB   (hex)		INNERINT Co., Ltd.
+0025BB     (base 16)		INNERINT Co., Ltd.
+				Dongyoung CentralTower #202, Geumjung-dong,
+				Gunpo-si  Kyunggi-do  430050
+				KR
+
+00-25-B8   (hex)		Agile Communications, Inc.
+0025B8     (base 16)		Agile Communications, Inc.
+				810 Lawrence Dr
+				Thousand Oaks  California  91320
+				US
+
+00-25-B1   (hex)		Maya-Creation Corporation
+0025B1     (base 16)		Maya-Creation Corporation
+				3F, Building M-10, Centre od Hi-Tech Ind. Dist.
+				Shenzhen    518057
+				CN
+
+00-25-A1   (hex)		Enalasys
+0025A1     (base 16)		Enalasys
+				250 Avenida Campillo
+				Calexico  California  92231
+				US
+
+00-25-F3   (hex)		Nordwestdeutsche Zählerrevision
+0025F3     (base 16)		Nordwestdeutsche Zählerrevision
+				Ing. Aug. Knemeyer GmbH & Co. KG
+				Bad Laer  Niedersachsen  49196
+				DE
+
+00-25-DD   (hex)		SUNNYTEK INFORMATION CO., LTD.
+0025DD     (base 16)		SUNNYTEK INFORMATION CO., LTD.
+				12F, NO. 88, HSIN-TE ROAD
+				TAIPEI HSIEN    241
+				TW
+
+00-25-CE   (hex)		InnerSpace
+0025CE     (base 16)		InnerSpace
+				PO Box 2186
+				Grand Rapids  MI  49501
+				US
+
+00-25-49   (hex)		Jeorich Tech. Co.,Ltd.
+002549     (base 16)		Jeorich Tech. Co.,Ltd.
+				4F., No.6, Ln. 70, Sec. 2, Academia Rd., Nangang District, Taipei City 115, Taiwan (R.O.C.)
+				Taipei  Taiwan  110
+				TW
+
+00-25-39   (hex)		IfTA GmbH
+002539     (base 16)		IfTA GmbH
+				Industriestraße 33
+				Groebenzell  Bavaria  82194
+				DE
+
+00-25-37   (hex)		Runcom Technologies Ltd.
+002537     (base 16)		Runcom Technologies Ltd.
+				11 Moshe Levi Str. 11th Flr.
+				Rishon Le Zion    75658
+				IL
+
+00-25-38   (hex)		Samsung Electronics Co., Ltd., Memory Division
+002538     (base 16)		Samsung Electronics Co., Ltd., Memory Division
+				San #16 Banwol-Dong, Taean-Gu
+				Hwasung City  Gyeonggi Do  445-701
+				KR
+
+00-25-44   (hex)		LoJack Corporation
+002544     (base 16)		LoJack Corporation
+				780 Dedham Street
+				Canton  MA  02021
+				US
+
+00-25-32   (hex)		Digital Recorders
+002532     (base 16)		Digital Recorders
+				4018 Patriot Drive
+				Durham  NC  27709
+				US
+
+00-25-5D   (hex)		Morningstar Corporation
+00255D     (base 16)		Morningstar Corporation
+				10611 Iron Bridge Road
+				Jessup  MD  20794
+				US
+
+00-25-58   (hex)		MPEDIA
+002558     (base 16)		MPEDIA
+				Shinyoung Tower 12F 246-2
+				Seongnam  Gyeonggi-do  463-824
+				KR
+
+00-25-4A   (hex)		RingCube Technologies, Inc.
+00254A     (base 16)		RingCube Technologies, Inc.
+				100 West Evelyn Ave, Suite 210
+				Mountain View  CA  94041
+				US
+
+00-25-4F   (hex)		ELETTROLAB Srl
+00254F     (base 16)		ELETTROLAB Srl
+				Via Dell'Industria 25
+				San Vendemiano  Treviso  31020
+				IT
+
+00-25-83   (hex)		Cisco Systems, Inc
+002583     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-91   (hex)		NEXTEK, Inc.
+002591     (base 16)		NEXTEK, Inc.
+				410 Douglass Street
+				Reading  PA  19601
+				US
+
+00-25-8D   (hex)		Haier
+00258D     (base 16)		Haier
+				No.1,Haier Road
+				Qingdao  Shandong  266101
+				CN
+
+00-25-71   (hex)		Zhejiang Tianle Digital Electric Co.,Ltd
+002571     (base 16)		Zhejiang Tianle Digital Electric Co.,Ltd
+				No.8 Tianle Rd,Economic Development Zone
+				Shengzhou  Zhejiang  312400
+				CN
+
+00-25-9A   (hex)		CEStronics GmbH
+00259A     (base 16)		CEStronics GmbH
+				Friedrichstraße 243
+				Velbert    42551
+				DE
+
+00-25-02   (hex)		NaturalPoint
+002502     (base 16)		NaturalPoint
+				PO Box 2317
+				Corvallis  OR  97339
+				US
+
+00-24-F8   (hex)		Technical Solutions Company Ltd.
+0024F8     (base 16)		Technical Solutions Company Ltd.
+				Box 31750
+				Whitehorse  Yukon  Y1A 6L3
+				CA
+
+00-24-F9   (hex)		Cisco Systems, Inc
+0024F9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-F2   (hex)		Uniphone Telecommunication Co., Ltd.
+0024F2     (base 16)		Uniphone Telecommunication Co., Ltd.
+				No. 25, Chu-Kung 3rd Lane, Chu-Hou Tsung, Jen-Wu Hsiang,
+				Kaohsiung Hsien    81448
+				TW
+
+00-25-14   (hex)		PC Worth Int'l Co., Ltd.
+002514     (base 16)		PC Worth Int'l Co., Ltd.
+				18F, No.100, Sec. 1, Xintai 5th Rd., Xizhi Dist.,
+				New Taipei City  Taipei  22102
+				TW
+
+00-25-0B   (hex)		CENTROFACTOR  INC
+00250B     (base 16)		CENTROFACTOR  INC
+				Road Town, Tortola, P.O.Box 3161,
+				Tortola    194295
+				VG
+
+00-25-06   (hex)		A.I. ANTITACCHEGGIO ITALIA SRL
+002506     (base 16)		A.I. ANTITACCHEGGIO ITALIA SRL
+				VICOLO DELLE DAME 4
+				BOLOGNA    40124
+				IT
+
+00-25-1C   (hex)		EDT
+00251C     (base 16)		EDT
+				1400 SW Compton
+				Beaverton  OR  97008
+				US
+
+00-25-1A   (hex)		Psiber Data Systems Inc.
+00251A     (base 16)		Psiber Data Systems Inc.
+				7075-K Mission Gorge Rd
+				San Diego  CA  92120
+				US
+
+00-24-E1   (hex)		Convey Computer Corp.
+0024E1     (base 16)		Convey Computer Corp.
+				1302 E. Collins Blvd.
+				Richardson  TX  75081
+				US
+
+00-24-EE   (hex)		Wynmax Inc.
+0024EE     (base 16)		Wynmax Inc.
+				18F., No. 75, Sec. 1, XinTai 5th  Rd.,
+				Xizhi  City,  Taipei County  221
+				TW
+
+00-24-E3   (hex)		CAO Group
+0024E3     (base 16)		CAO Group
+				4628 West Skyhawk Drive
+				West Jordan  UT  84084
+				US
+
+00-25-07   (hex)		ASTAK Inc.
+002507     (base 16)		ASTAK Inc.
+				1911 Hartog Drive
+				San Jose  CA  95131
+				US
+
+00-24-D9   (hex)		BICOM, Inc.
+0024D9     (base 16)		BICOM, Inc.
+				755 Main Street
+				Monroe  CT  06468
+				US
+
+00-24-8E   (hex)		Infoware ZRt.
+00248E     (base 16)		Infoware ZRt.
+				Huseg u. 10/a
+				Budapest    1223
+				HU
+
+00-24-94   (hex)		Shenzhen Baoxin Tech CO., Ltd.
+002494     (base 16)		Shenzhen Baoxin Tech CO., Ltd.
+				6F Huale BLDG., Zhonghangbei Rd.,
+				Shenzhen  GuangDong  518028
+				CN
+
+00-24-89   (hex)		Vodafone Omnitel N.V.
+002489     (base 16)		Vodafone Omnitel N.V.
+				Via Jervis 13
+				10015  Ivrea  Torino
+				IT
+
+00-24-6F   (hex)		Onda Communication spa
+00246F     (base 16)		Onda Communication spa
+				via del lavoro 9
+				pordenone    33170
+				IT
+
+00-24-69   (hex)		Smart Doorphones
+002469     (base 16)		Smart Doorphones
+				Klipsenstraat 18A
+				Lokeren    9160
+				BE
+
+00-24-7F   (hex)		Nortel Networks
+00247F     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-24-75   (hex)		Compass System(Embedded Dept.)
+002475     (base 16)		Compass System(Embedded Dept.)
+				1403 ACE TechnoTower 8th
+				Seoul    152-050
+				KR
+
+00-24-C3   (hex)		Cisco Systems, Inc
+0024C3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-B5   (hex)		Nortel Networks
+0024B5     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-24-B0   (hex)		ESAB AB
+0024B0     (base 16)		ESAB AB
+				Box 8004
+				Göteborg    SE-402 77
+				SE
+
+00-24-C4   (hex)		Cisco Systems, Inc
+0024C4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-9D   (hex)		NES Technology Inc.
+00249D     (base 16)		NES Technology Inc.
+				#205 ACE Technotower 10, 470-5 Gasan-dong
+				Seoul    153-789
+				KR
+
+00-24-64   (hex)		Bridge Technologies Co AS
+002464     (base 16)		Bridge Technologies Co AS
+				Mølleparken 4
+				Oslo    0459
+				NO
+
+00-24-62   (hex)		Rayzone Corporation
+002462     (base 16)		Rayzone Corporation
+				#2008, B-Dong, Samho BLDG
+				Seoul    137-941
+				KR
+
+00-24-20   (hex)		NetUP Inc.
+002420     (base 16)		NetUP Inc.
+				Olof Palme st., 1, sect. 7
+				Moscow    119311
+				RU
+
+00-24-1E   (hex)		Nintendo Co., Ltd.
+00241E     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-24-1F   (hex)		DCT-Delta GmbH
+00241F     (base 16)		DCT-Delta GmbH
+				Bodanrückstraße 1
+				Bodman - Ludwigshafen  Baden-Württemberg  78351
+				DE
+
+00-24-0E   (hex)		Inventec Besta Co., Ltd.
+00240E     (base 16)		Inventec Besta Co., Ltd.
+				10FL, No.36, Lane 513, Rui Guang Road, Nei Hu Dist.
+				Taipei    114
+				TW
+
+00-24-60   (hex)		Giaval Science Development Co. Ltd.
+002460     (base 16)		Giaval Science Development Co. Ltd.
+				58 Bei Si Huan Xi Rd
+				  Beijing  100080
+				CN
+
+00-24-5C   (hex)		Design-Com Technologies Pty. Ltd.
+00245C     (base 16)		Design-Com Technologies Pty. Ltd.
+				14 Redland Drive
+				Mitcham  Victoria  3132
+				AU
+
+00-24-3D   (hex)		Emerson Appliance Motors and Controls
+00243D     (base 16)		Emerson Appliance Motors and Controls
+				1901 South St.
+				Elgin  IL  60123
+				US
+
+00-24-37   (hex)		Motorola - BSG
+002437     (base 16)		Motorola - BSG
+				1101 Marina Village Pkwy
+				Alameda  CA  94501
+				US
+
+00-24-44   (hex)		Nintendo Co., Ltd.
+002444     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-24-13   (hex)		Cisco Systems, Inc
+002413     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-4F   (hex)		Asantron Technologies Ltd.
+00244F     (base 16)		Asantron Technologies Ltd.
+				3F-1, No.30 Jihe Rd., 111
+				Taipei    11166
+				TW
+
+00-23-DD   (hex)		ELGIN S.A.
+0023DD     (base 16)		ELGIN S.A.
+				RUA BARAO DE CAMPINAS, 305
+				São Paulo    01201-901
+				BR
+
+00-23-DE   (hex)		Ansync Inc.
+0023DE     (base 16)		Ansync Inc.
+				4970 Robert J Matthews Pky
+				El Dorado Hills  CA  95762
+				US
+
+00-23-D9   (hex)		Banner Engineering
+0023D9     (base 16)		Banner Engineering
+				9714 10th Ave. N.
+				Plymouth  MN  55441
+				US
+
+00-23-DA   (hex)		Industrial Computer Source (Deutschland)GmbH
+0023DA     (base 16)		Industrial Computer Source (Deutschland)GmbH
+				Marie-Curie-Straße 9
+				Pulheim  NRW  50259
+				DE
+
+00-24-05   (hex)		Dilog Nordic AB
+002405     (base 16)		Dilog Nordic AB
+				Faktorvägen 9
+				Kungsbacka  Halland  439 34
+				SE
+
+00-23-E8   (hex)		Demco Corp.
+0023E8     (base 16)		Demco Corp.
+				#919, Doosan Venturedigm, 126-1
+				Anyang-Si  Kyungki-Do  431-070
+				US
+
+00-23-E3   (hex)		Microtronic AG
+0023E3     (base 16)		Microtronic AG
+				Duennernstrasse 32
+				Oensingen  Solothurn  4702
+				CH
+
+00-23-B7   (hex)		Q-Light Co., Ltd.
+0023B7     (base 16)		Q-Light Co., Ltd.
+				178-1 Woogye-Ri, Sangdong-Myun,
+				Gimhae-Si  GyungsangNam-Do  621-812
+				KR
+
+00-23-FD   (hex)		AFT Atlas Fahrzeugtechnik GmbH
+0023FD     (base 16)		AFT Atlas Fahrzeugtechnik GmbH
+				Gewerbestraße 14
+				Werdohl    58791
+				DE
+
+00-23-EF   (hex)		Zuend Systemtechnik AG
+0023EF     (base 16)		Zuend Systemtechnik AG
+				Industriestrasse 8
+				Altstaetten  SG  9450
+				CH
+
+00-23-AC   (hex)		Cisco Systems, Inc
+0023AC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-D8   (hex)		Ball-It Oy
+0023D8     (base 16)		Ball-It Oy
+				Uusikatu 24 G 76
+				Oulu    90100
+				FI
+
+00-23-9F   (hex)		Institut für Prüftechnik
+00239F     (base 16)		Institut für Prüftechnik
+				Schulstraße 3
+				Todtenweis  Bayern  86447
+				DE
+
+00-23-9D   (hex)		Mapower Electronics Co., Ltd
+00239D     (base 16)		Mapower Electronics Co., Ltd
+				No. 50 Minquan Road
+				Taoyuan County    33846
+				TW
+
+00-23-9C   (hex)		Juniper Networks
+00239C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-23-98   (hex)		Vutlan sro
+002398     (base 16)		Vutlan sro
+				ul. Svornosti 43
+				Bratislava  BA  82 106
+				SK
+
+00-23-5B   (hex)		Gulfstream
+00235B     (base 16)		Gulfstream
+				32 Lummus Drive
+				Savannah  GA  31407
+				US
+
+00-23-59   (hex)		Benchmark Electronics ( Thailand ) Public Company Limited
+002359     (base 16)		Benchmark Electronics ( Thailand ) Public Company Limited
+				94 Moo 1, Hi-Tech Industrial Estate
+				Bang Pa-in  Ayudhaya  13160
+				TH
+
+00-23-57   (hex)		Pitronot Technologies and Engineering P.T.E. Ltd.
+002357     (base 16)		Pitronot Technologies and Engineering P.T.E. Ltd.
+				8 Hatut st
+				Pardesiya    42815
+				IL
+
+00-23-55   (hex)		Kinco Automation(Shanghai) Ltd.
+002355     (base 16)		Kinco Automation(Shanghai) Ltd.
+				Bldg1, No.1387, Zhangdong Road,
+				  Shanghai  201203
+				CN
+
+00-23-73   (hex)		GridIron Systems, Inc.
+002373     (base 16)		GridIron Systems, Inc.
+				726 Palomar Ave
+				Sunnyvale  CA  94085
+				US
+
+00-23-67   (hex)		UniControls a.s.
+002367     (base 16)		UniControls a.s.
+				Krenicka 2257
+				Prague 10    100 00
+				CZ
+
+00-23-68   (hex)		Zebra Technologies Inc
+002368     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+00-23-6E   (hex)		Burster GmbH & Co KG
+00236E     (base 16)		Burster GmbH & Co KG
+				Talstraße 1-5
+				Gernsbach  Baden-Württemberg  76593
+				DE
+
+00-23-66   (hex)		Beijing Siasun Electronic System Co.,Ltd.
+002366     (base 16)		Beijing Siasun Electronic System Co.,Ltd.
+				Rm.1018 Huatian Bldg, No.6 Bei Xiaomachang
+				Beijing    100038
+				CN
+
+00-23-8F   (hex)		NIDEC COPAL CORPORATION
+00238F     (base 16)		NIDEC COPAL CORPORATION
+				2-18-10,SHIMURA
+				ITABASHI-KU  TOKYO  174-8550
+				JP
+
+00-23-80   (hex)		Nanoteq
+002380     (base 16)		Nanoteq
+				 PO Box 7991
+				Centurion  Gauteng  0046
+				ZA
+
+00-23-3D   (hex)		Laird Technologies
+00233D     (base 16)		Laird Technologies
+				Meesmannstrasse 103
+				Bochum    44807
+				DE
+
+00-23-3F   (hex)		Purechoice Inc
+00233F     (base 16)		Purechoice Inc
+				11481 Rupp Drive
+				Burnsville  MN  55337
+				US
+
+00-23-1B   (hex)		Danaher Motion - Kollmorgen
+00231B     (base 16)		Danaher Motion - Kollmorgen
+				201 W. Rock Road
+				Radford  VA  24141
+				US
+
+00-23-1E   (hex)		Cezzer Multimedia Technologies
+00231E     (base 16)		Cezzer Multimedia Technologies
+				Pépinière d'entreprises CREATIC
+				Plouzané    29280
+				FR
+
+00-23-1F   (hex)		Guangda Electronic & Telecommunication Technology Development Co., Ltd.
+00231F     (base 16)		Guangda Electronic & Telecommunication Technology Development Co., Ltd.
+				#8 Gaopengdong Road, Gaoxin District
+				Chengdu  Sichuan  610041
+				CN
+
+00-22-70   (hex)		ABK North America, LLC
+002270     (base 16)		ABK North America, LLC
+				440 North Wolfe Rd.
+				Sunnyvale  CA  94085
+				US
+
+00-23-13   (hex)		Qool Technologies Ltd.
+002313     (base 16)		Qool Technologies Ltd.
+				Gotanda Chuo Bldg 8f, 2-3-5
+				Shinagawa-ku  Tokyo  141-0022
+				JP
+
+00-23-10   (hex)		LNC Technology Co., Ltd.
+002310     (base 16)		LNC Technology Co., Ltd.
+				19F, No. 78-2, Sec. 3, Taichung Kang Rd.
+				Taichung    40764
+				TW
+
+00-22-CD   (hex)		Ared Technology Co., Ltd.
+0022CD     (base 16)		Ared Technology Co., Ltd.
+				6F-8 No.83 Sec.1, Nankan Rd. Luzhu Shiang
+				Taoyuan County  Taiwan  33859
+				TW
+
+00-22-CC   (hex)		SciLog, Inc.
+0022CC     (base 16)		SciLog, Inc.
+				8845 South Greenview Drive
+				Middleton  Wisconsin  53562
+				US
+
+00-22-CB   (hex)		IONODES Inc.
+0022CB     (base 16)		IONODES Inc.
+				4001 boulevard Industriel
+				Laval  Quebec  H7L4S3
+				CA
+
+00-22-C6   (hex)		Sutus Inc
+0022C6     (base 16)		Sutus Inc
+				301-3999 Henning Drive
+				Burnaby  British Columbia  V5C 6P9
+				CA
+
+00-22-E8   (hex)		Applition Co., Ltd.
+0022E8     (base 16)		Applition Co., Ltd.
+				509-1, Bundang Techno Park D-dong,
+				SeongNam  Kyunggi-do  463-760
+				KR
+
+00-22-E9   (hex)		ProVision Communications
+0022E9     (base 16)		ProVision Communications
+				1 Portland Square
+				Bristol    BS2 8RR
+				GB
+
+00-22-E6   (hex)		Intelligent Data
+0022E6     (base 16)		Intelligent Data
+				Edf. Inverinnova – Avda. Punto Mobi, 4. Parque Científico Tecnológico
+				Alcalá de Henares  Madrid  28805
+				ES
+
+00-22-E3   (hex)		Amerigon
+0022E3     (base 16)		Amerigon
+				21680 Haggerty Road
+				Northville  Michigan  48167
+				US
+
+00-22-EB   (hex)		Data Respons A/S
+0022EB     (base 16)		Data Respons A/S
+				Ellekær 6
+				Herlev    2730
+				DK
+
+00-22-EF   (hex)		iWDL Technologies
+0022EF     (base 16)		iWDL Technologies
+				10522 Meinert Rd
+				Wexford  PA  15090
+				US
+
+00-22-F2   (hex)		SunPower Corp
+0022F2     (base 16)		SunPower Corp
+				1414 Harbour Way South
+				Richmond  CA  94804
+				US
+
+00-22-E2   (hex)		WABTEC Transit Division
+0022E2     (base 16)		WABTEC Transit Division
+				130 Ridgeview Circle
+				Duncan  SC  29334
+				US
+
+00-23-01   (hex)		Witron Technology Limited
+002301     (base 16)		Witron Technology Limited
+				6/F, Xin Rui Building, 32 Tao Hua Road, Futian Free Trade Zone,
+				  Shenzhen  86
+				CN
+
+00-22-F7   (hex)		Conceptronic
+0022F7     (base 16)		Conceptronic
+				Databankweg 7
+				AMERSFOORT  utrecht  3821 AL
+				NL
+
+00-23-0C   (hex)		CLOVER ELECTRONICS CO.,LTD.
+00230C     (base 16)		CLOVER ELECTRONICS CO.,LTD.
+				AKENO 306-1
+				ISE City  MIE Prefecture  519-0501
+				JP
+
+00-23-34   (hex)		Cisco Systems, Inc
+002334     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-C8   (hex)		Applied Instruments B.V.
+0022C8     (base 16)		Applied Instruments B.V.
+				Dynamoweg 3
+				Vlissingen  Zeeland  NL-4382WZ
+				NL
+
+00-22-C0   (hex)		Shenzhen Forcelink Electronic Co, Ltd
+0022C0     (base 16)		Shenzhen Forcelink Electronic Co, Ltd
+				2nd and 3rd floor, Hasse manufacture building, Hasee industrial park
+				Shenzhen  Guangdong  518112
+				CN
+
+00-22-A6   (hex)		Sony Computer Entertainment America
+0022A6     (base 16)		Sony Computer Entertainment America
+				919 East Hillsdale Blvd
+				Foster City  California  94404-2175
+				US
+
+00-22-A7   (hex)		Tyco Electronics AMP GmbH
+0022A7     (base 16)		Tyco Electronics AMP GmbH
+				Amperestraße 12-14
+				Bensheim  Hessen  64625
+				DE
+
+00-22-A1   (hex)		Huawei Symantec Technologies Co.,Ltd.
+0022A1     (base 16)		Huawei Symantec Technologies Co.,Ltd.
+				Building 1,The West Zone Science Park of UESTC,No.88,Tianchen Road
+				Chengdu  Sichuan  611731
+				CN
+
+00-22-9D   (hex)		PYUNG-HWA IND.CO.,LTD
+00229D     (base 16)		PYUNG-HWA IND.CO.,LTD
+				230-1
+				HWASUNG-SI  KYUNGGI-DO  445-912
+				KR
+
+00-22-96   (hex)		LinoWave Corporation
+002296     (base 16)		LinoWave Corporation
+				1001-101 Champlain Avenue
+				Burlington  Ontario  L7L 5Z4
+				CA
+
+00-22-44   (hex)		Chengdu Linkon Communications Device Co., Ltd
+002244     (base 16)		Chengdu Linkon Communications Device Co., Ltd
+				5f-02, Juntong Building, No. 53,Shuangfeng Road, Wuhou District,
+				Chengdu  Sichuan  610041
+				CN
+
+00-22-50   (hex)		Point Six Wireless, LLC
+002250     (base 16)		Point Six Wireless, LLC
+				2333 Alumni Park Plaza
+				Lexington  KY  40517
+				US
+
+00-22-6F   (hex)		3onedata Technology Co. Ltd.
+00226F     (base 16)		3onedata Technology Co. Ltd.
+				3/F, B/2, Jiuxiangling Industrial District, Xili Town, Nanshan District,
+				Shenzhen  Guangdong  518055
+				CN
+
+00-22-78   (hex)		Shenzhen  Tongfang Multimedia  Technology Co.,Ltd.
+002278     (base 16)		Shenzhen  Tongfang Multimedia  Technology Co.,Ltd.
+				2f Sector D of TongFang Information Harbor
+				Nanshan District, Shenzhen  GuangDong  518058
+				CN
+
+00-22-7A   (hex)		Telecom Design
+00227A     (base 16)		Telecom Design
+				Za Remora
+				33170  Gradignan  
+				FR
+
+00-22-60   (hex)		AFREEY Inc.
+002260     (base 16)		AFREEY Inc.
+				6F, No.249, Chien I Road
+				Chung Ho City  Taipei County  235
+				TW
+
+00-21-EF   (hex)		Kapsys
+0021EF     (base 16)		Kapsys
+				790 Av du Docteur Maurice Donat
+				06250 Mougins  Sophia Antipolis  
+				FR
+
+00-21-ED   (hex)		Telegesis
+0021ED     (base 16)		Telegesis
+				84 Station Road
+				Marlow  Bucks  SL7 1NX
+				GB
+
+00-21-EB   (hex)		ESP SYSTEMS, LLC
+0021EB     (base 16)		ESP SYSTEMS, LLC
+				1422 East Fourth Street
+				Charlotte  NC  28204
+				US
+
+00-22-37   (hex)		Shinhint Group
+002237     (base 16)		Shinhint Group
+				Unit 1506, 15/F, Nanyang Plaza,, 57 Hung To Road,
+				    
+				HK
+
+00-22-2F   (hex)		Open Grid Computing, Inc.
+00222F     (base 16)		Open Grid Computing, Inc.
+				4030-1 West Braker Lane STE130
+				Austin  TX  78759
+				US
+
+00-21-F6   (hex)		Oracle Corporation
+0021F6     (base 16)		Oracle Corporation
+				900 Chelmsford Street
+				Lowell  MA  01851
+				US
+
+00-22-06   (hex)		Cyberdyne Inc.
+002206     (base 16)		Cyberdyne Inc.
+				504 @C49-2
+				Tsukuba-shi  Ibaraki-ken  305-0817
+				JP
+
+00-22-02   (hex)		Excito Elektronik i Skåne AB
+002202     (base 16)		Excito Elektronik i Skåne AB
+				Box 126
+				Löddeköpinge    246 22
+				SE
+
+00-22-27   (hex)		uv-electronic GmbH
+002227     (base 16)		uv-electronic GmbH
+				Grosswiesenstraße 20
+				Durchhausen  Baden-Württemberg  78591
+				DE
+
+00-22-1E   (hex)		Media Devices Co., Ltd.
+00221E     (base 16)		Media Devices Co., Ltd.
+				Rm1002 Ace TechnoTower(9th) 345-30
+				Seoul    153-802
+				KR
+
+00-22-25   (hex)		Thales Avionics Ltd
+002225     (base 16)		Thales Avionics Ltd
+				86 Bushey Road
+				London    SW20 0JW
+				GB
+
+00-22-20   (hex)		Mitac Technology Corp
+002220     (base 16)		Mitac Technology Corp
+				9th Fl., #75, Min-sheng E. Road, Sec. 3,
+				Taipei    104
+				TW
+
+00-22-0E   (hex)		Indigo Security Co., Ltd.
+00220E     (base 16)		Indigo Security Co., Ltd.
+				2nd Floor, 277-169 Sungsoo2-Ga, Sungdong-Gu
+				Seoul    133-832
+				KR
+
+00-22-07   (hex)		Inteno Broadband Technology AB
+002207     (base 16)		Inteno Broadband Technology AB
+				Stensätravägen 13
+				Skärholmen  SE  127 39 
+				SE
+
+00-22-3E   (hex)		IRTrans GmbH
+00223E     (base 16)		IRTrans GmbH
+				Einsteinstrasse 14
+				Unterschleissheim  BAYERN  85716
+				DE
+
+00-21-CE   (hex)		NTC-Metrotek
+0021CE     (base 16)		NTC-Metrotek
+				9, Nevzorovoy street
+				Saint-Petersburg    192148
+				RU
+
+00-21-CA   (hex)		ART System Co., Ltd.
+0021CA     (base 16)		ART System Co., Ltd.
+				Mobile Techno Bldg Room 910
+				Dae-Gu    702-020
+				KR
+
+00-21-CB   (hex)		SMS TECNOLOGIA ELETRONICA LTDA
+0021CB     (base 16)		SMS TECNOLOGIA ELETRONICA LTDA
+				Av. Pirâmide, 661
+				DIADEMA  São Paulo  09970330
+				BR
+
+00-21-C8   (hex)		LOHUIS Networks
+0021C8     (base 16)		LOHUIS Networks
+				2681 TV Monster
+				Votlaan 408  Votlaan  31
+				NL
+
+00-21-DB   (hex)		Santachi Video Technology (Shenzhen) Co., Ltd.
+0021DB     (base 16)		Santachi Video Technology (Shenzhen) Co., Ltd.
+				Santachi Building,#14 Kaifeng Road,Meilin,
+				Shenzhen  Guangdong  518049
+				CN
+
+00-21-BF   (hex)		Hitachi High-Tech Control Systems Corporation
+0021BF     (base 16)		Hitachi High-Tech Control Systems Corporation
+				500,Miyu-cho
+				Mito-shi  Ibaraki-ken  319-0316
+				JP
+
+00-21-BC   (hex)		ZALA COMPUTER
+0021BC     (base 16)		ZALA COMPUTER
+				EL BOUNI
+				ANNABA    23000
+				DZ
+
+00-21-B4   (hex)		APRO MEDIA CO., LTD
+0021B4     (base 16)		APRO MEDIA CO., LTD
+				#13-5,Dodang-Dong,Wonmi-Gu,
+				Bucheon-City  Kyunggi-Do  420-801
+				KR
+
+00-21-A8   (hex)		Telephonics Corporation
+0021A8     (base 16)		Telephonics Corporation
+				815 Broad Hollow Road
+				Farmingdale  New York  11790
+				US
+
+00-21-A9   (hex)		Mobilink Telecom Co.,Ltd
+0021A9     (base 16)		Mobilink Telecom Co.,Ltd
+				292-3 Sindang-ri, Sandong-myun
+				Gumi  Gyeongbuk  730-853
+				KR
+
+00-21-8D   (hex)		AP Router Ind. Eletronica LTDA
+00218D     (base 16)		AP Router Ind. Eletronica LTDA
+				Av. Lomanto Junior, 1000
+				Ilheus  Bahia  45654-000
+				BR
+
+00-21-90   (hex)		Goliath Solutions
+002190     (base 16)		Goliath Solutions
+				3082 Sterling Circle
+				Boulder  Colorado  80301
+				US
+
+00-21-85   (hex)		MICRO-STAR INT'L CO.,LTD.
+002185     (base 16)		MICRO-STAR INT'L CO.,LTD.
+				No.69,Li-De St,Jung-Ho City
+				Taipei Hsien    235
+				TW
+
+00-21-9F   (hex)		SATEL OY
+00219F     (base 16)		SATEL OY
+				Meriniitynkatu 17
+				SALO  Lansi-Suomen Laani  24100
+				FI
+
+00-21-96   (hex)		Telsey  S.p.A.
+002196     (base 16)		Telsey  S.p.A.
+				Viale dell'Industria, 1
+				Quinto  DiTreviso  31055
+				IT
+
+00-21-82   (hex)		SandLinks Systems, Ltd.
+002182     (base 16)		SandLinks Systems, Ltd.
+				P.O.Box 4629
+				Petah-Tiqwa  Israel  49277
+				IL
+
+00-21-83   (hex)		ANDRITZ HYDRO GmbH
+002183     (base 16)		ANDRITZ HYDRO GmbH
+				Eibesbrunnergasse 20
+				Vienna    1120
+				AT
+
+00-21-DF   (hex)		Martin Christ GmbH
+0021DF     (base 16)		Martin Christ GmbH
+				An der Unteren Soese 50
+				Osterode  Niedersachsen  37520
+				DE
+
+00-21-D4   (hex)		Vollmer Werke GmbH
+0021D4     (base 16)		Vollmer Werke GmbH
+				Maschinenfabrik
+				Biberach  Baden-Württemberg  88400
+				DE
+
+00-21-D6   (hex)		LXI Consortium
+0021D6     (base 16)		LXI Consortium
+				P.O. Box 1016
+				Niwot  CO  80544-1016
+				US
+
+00-21-A6   (hex)		Videotec Spa
+0021A6     (base 16)		Videotec Spa
+				Via Friuli,6
+				Schio  Vicenza  36015
+				IT
+
+00-21-59   (hex)		Juniper Networks
+002159     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-21-55   (hex)		Cisco Systems, Inc
+002155     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-57   (hex)		National Datacast, Inc.
+002157     (base 16)		National Datacast, Inc.
+				2100 Crystal Drive, Suite 750
+				Arlington  VA  22202
+				US
+
+00-21-3B   (hex)		Berkshire Products, Inc
+00213B     (base 16)		Berkshire Products, Inc
+				PO Box 2819
+				Cumming  GA  30028
+				US
+
+00-21-37   (hex)		Bay Controls, LLC
+002137     (base 16)		Bay Controls, LLC
+				6528 Weatherfield Ct
+				Maumee  OH  43537
+				US
+
+00-21-39   (hex)		Escherlogic Inc.
+002139     (base 16)		Escherlogic Inc.
+				1481 Rosebank Rd.
+				Pickering  Ontario  L1V 1P3
+				CA
+
+00-21-2C   (hex)		SemIndia System Private Limited
+00212C     (base 16)		SemIndia System Private Limited
+				No. 1106/9, A.M Industrial Estate, Garvebhavipalya
+				Bangalore  Karnataka  560 068
+				IN
+
+00-21-2B   (hex)		MSA Auer
+00212B     (base 16)		MSA Auer
+				Thiemannstraße 1
+				Berlin    12059
+				DE
+
+00-21-74   (hex)		AvaLAN Wireless
+002174     (base 16)		AvaLAN Wireless
+				958 San Leandro Ave, Suite 900
+				Mountain View  CA  94043
+				US
+
+00-21-79   (hex)		IOGEAR, Inc.
+002179     (base 16)		IOGEAR, Inc.
+				23 Hubble
+				Irvine  CA  92618
+				US
+
+00-21-68   (hex)		iVeia, LLC
+002168     (base 16)		iVeia, LLC
+				51 Franklin Street
+				Annapolis  MD  21401
+				US
+
+00-21-50   (hex)		EYEVIEW ELECTRONICS
+002150     (base 16)		EYEVIEW ELECTRONICS
+				3 Floor, No. 86, Kung Yeh 32 Road
+				TAICHUNG    407
+				TW
+
+00-21-4D   (hex)		Guangzhou Skytone Transmission Technology Com. Ltd.
+00214D     (base 16)		Guangzhou Skytone Transmission Technology Com. Ltd.
+				3/F West, Block 4, Huangzhou
+				Guangzhou  Guangdong  510660
+				CN
+
+00-21-2A   (hex)		Audiovox Corporation
+00212A     (base 16)		Audiovox Corporation
+				150 Marcus Blvd
+				Hauppauge  NY  11788
+				US
+
+00-21-5E   (hex)		IBM Corp
+00215E     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-1F-F6   (hex)		PS Audio International
+001FF6     (base 16)		PS Audio International
+				4826 Sterling Drive
+				Boulder  CO  80301
+				US
+
+00-21-10   (hex)		Clearbox Systems
+002110     (base 16)		Clearbox Systems
+				Suite 2, Level 2
+				Macquarie Park  NSW  2113
+				AU
+
+00-21-0C   (hex)		Cymtec Systems, Inc.
+00210C     (base 16)		Cymtec Systems, Inc.
+				10845 Olive Bouleveard
+				St Louis  MO  63141
+				US
+
+00-21-0B   (hex)		GEMINI TRAZE RFID PVT. LTD.
+00210B     (base 16)		GEMINI TRAZE RFID PVT. LTD.
+				1, DR. RANGA ROAD
+				CHENNAI  TAMILNADU  600018
+				IN
+
+00-1F-DD   (hex)		GDI LLC
+001FDD     (base 16)		GDI LLC
+				One MidAmerica Plaza
+				Oakbrook Terrace  IL  60181
+				US
+
+00-1F-DA   (hex)		Nortel Networks
+001FDA     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-21-04   (hex)		Gigaset Communications GmbH
+002104     (base 16)		Gigaset Communications GmbH
+				Frankenstrasse 2
+				46395  Bocholt  
+				DE
+
+00-1F-FB   (hex)		Green Packet Bhd
+001FFB     (base 16)		Green Packet Bhd
+				Lot 1-4, Incubator 2, Technology Park Malaysia
+				Kuala Lumpur  Wilayah Persekutuan  57000
+				MY
+
+00-1F-E9   (hex)		Printrex, Inc.
+001FE9     (base 16)		Printrex, Inc.
+				276 East Gish Road
+				San Jose  CA  95112
+				US
+
+00-1F-F0   (hex)		Audio Partnership
+001FF0     (base 16)		Audio Partnership
+				Gallery Court
+				London    SE1 4BB
+				GB
+
+00-1F-EA   (hex)		Applied Media Technologies Corporation
+001FEA     (base 16)		Applied Media Technologies Corporation
+				4091 AMTC Center Drive
+				Clearwater  FL  33764
+				US
+
+00-1F-D9   (hex)		RSD Communications Ltd
+001FD9     (base 16)		RSD Communications Ltd
+				8 Borrowmeadow Road
+				Stirling  Scotland  FK7 7UW
+				GB
+
+00-1F-CE   (hex)		QTECH LLC
+001FCE     (base 16)		QTECH LLC
+				Novozavodskaya st. 18 build. 1
+				Moscow  Moscow region  121309
+				RU
+
+00-1F-8B   (hex)		Cache IQ
+001F8B     (base 16)		Cache IQ
+				8834 North Capital of Texas Hwy
+				Austin  Texas  78759
+				US
+
+00-1F-85   (hex)		Apriva ISS, LLC
+001F85     (base 16)		Apriva ISS, LLC
+				6900 E Camelback Rd
+				Scottsdale  AZ  85251
+				US
+
+00-1F-87   (hex)		Skydigital Inc.
+001F87     (base 16)		Skydigital Inc.
+				#28-9 Wonhyoro1-ga, Yongsan-gu,
+				Seoul    140-846
+				KR
+
+00-1F-88   (hex)		FMS Force Measuring Systems AG
+001F88     (base 16)		FMS Force Measuring Systems AG
+				Aspstrasse 6
+				Oberglatt  Zurich  8154
+				CH
+
+00-1F-86   (hex)		digEcor
+001F86     (base 16)		digEcor
+				1625 N. 1100 W.
+				Springville  UT  84663
+				US
+
+00-1F-A1   (hex)		Gtran Inc
+001FA1     (base 16)		Gtran Inc
+				2651 Lavery Court
+				Newbury Park  CA  91320
+				US
+
+00-1F-9F   (hex)		Thomson Telecom Belgium
+001F9F     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-1F-99   (hex)		SERONICS co.ltd
+001F99     (base 16)		SERONICS co.ltd
+				#401 Technopolis,
+				Daegu  Gyeong-buk  704-230
+				KR
+
+00-1F-80   (hex)		Lucas Holding bv
+001F80     (base 16)		Lucas Holding bv
+				Domein 28
+				Gemert  NB  5421AR
+				NL
+
+00-1B-58   (hex)		ACE CAD Enterprise Co., Ltd.
+001B58     (base 16)		ACE CAD Enterprise Co., Ltd.
+				2F, No. 94, Bao Chung Road,
+				Hsin Tien City,  Taipei Hsien  23144
+				TW
+
+00-1F-B0   (hex)		TimeIPS, Inc.
+001FB0     (base 16)		TimeIPS, Inc.
+				3522 N Comotara St
+				Wichita  KS  67226
+				US
+
+00-1F-AE   (hex)		Blick South Africa (Pty) Ltd
+001FAE     (base 16)		Blick South Africa (Pty) Ltd
+				PO Box 1908
+				Johannesburg  Gauteng  2108
+				ZA
+
+00-1F-79   (hex)		Lodam Electronics A/S
+001F79     (base 16)		Lodam Electronics A/S
+				Kærvej 77
+				Sønderborg  Als  DK-6400
+				DK
+
+00-1F-71   (hex)		xG Technology, Inc.
+001F71     (base 16)		xG Technology, Inc.
+				240 S. Pineapple Avenue
+				Sarasota  FL  34236
+				US
+
+00-1F-A5   (hex)		Blue-White Industries
+001FA5     (base 16)		Blue-White Industries
+				5300 Business Drive
+				Huntington Beach  CA  92649
+				US
+
+00-1F-9D   (hex)		Cisco Systems, Inc
+001F9D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-96   (hex)		APROTECH CO.LTD
+001F96     (base 16)		APROTECH CO.LTD
+				KOLONDIGITAL TOWER ASTON 201, 505-14
+				SEOUL    KSXX 0022
+				KR
+
+00-1F-6C   (hex)		Cisco Systems, Inc
+001F6C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-6F   (hex)		Fujian Sunnada Communication Co.,Ltd.
+001F6F     (base 16)		Fujian Sunnada Communication Co.,Ltd.
+				7/F Main Building,Fujian Torch Hi-Tech Innovation Park No.611 Industrial Road,Fuzhou Fuzhou Fujian China  350002 
+				Fuzhou  Fujian  350002
+				CN
+
+00-1F-60   (hex)		COMPASS SYSTEMS CORP.
+001F60     (base 16)		COMPASS SYSTEMS CORP.
+				6F, No. 413, Sec. 2, Ti-Ding Blvd.,
+				Taipei  NeihuDist  114
+				TW
+
+00-1F-6A   (hex)		PacketFlux Technologies, Inc.
+001F6A     (base 16)		PacketFlux Technologies, Inc.
+				50 11th Avenue
+				Helena  MT  59601
+				US
+
+00-1F-65   (hex)		KOREA ELECTRIC TERMINAL CO., LTD.
+001F65     (base 16)		KOREA ELECTRIC TERMINAL CO., LTD.
+				#7-38 SONGDO-DONG
+				YEONSU-GU  INCHEON  406-840
+				KR
+
+00-1F-17   (hex)		IDX Company, Ltd.
+001F17     (base 16)		IDX Company, Ltd.
+				6-28-11 Shukugawara, Tana-ku
+				Kawasaki-Shi  Kanagawa-Ken  2140021
+				JP
+
+00-1F-1B   (hex)		RoyalTek Company Ltd.
+001F1B     (base 16)		RoyalTek Company Ltd.
+				Suite 9F-1, No. 1071, Chung Cheng Rd.
+				Taoyuan Shien  Taoyuan  330
+				TW
+
+00-1F-5E   (hex)		Dyna Technology Co.,Ltd.
+001F5E     (base 16)		Dyna Technology Co.,Ltd.
+				HaoHai Building 1F,No.7,5th Street,Shangdi,
+				Beijing    100085
+				CN
+
+00-1F-55   (hex)		Honeywell Security (China) Co., Ltd.
+001F55     (base 16)		Honeywell Security (China) Co., Ltd.
+				Block 28, Section 2, Huai  De Cui Gang Industrial  Estate, Fu Yong, Bao An, ShenZhen, P.R. China
+				ShenZhen  GuangDong  518103
+				CN
+
+00-1F-54   (hex)		Lorex Technology Inc.
+001F54     (base 16)		Lorex Technology Inc.
+				250 Royal Crest Court
+				Markham  Ontario  L3R3S1
+				CA
+
+00-1F-2E   (hex)		Triangle Research Int'l Pte Ltd
+001F2E     (base 16)		Triangle Research Int'l Pte Ltd
+				10 Ubi Crescent #05-83
+				Ubi Techpark  SG  408664
+				SG
+
+00-1F-4B   (hex)		Lineage Power
+001F4B     (base 16)		Lineage Power
+				3000 Skyline Dr.
+				Mesquite  TX  75149
+				US
+
+00-1F-0D   (hex)		L3 Communications - Telemetry West
+001F0D     (base 16)		L3 Communications - Telemetry West
+				9020 Balboa Ave
+				San Diego  CA  92123
+				US
+
+00-1E-FC   (hex)		JSC MASSA-K
+001EFC     (base 16)		JSC MASSA-K
+				15, A, Pirogovskaya nab.
+				Saint-Petersburg  Leningradskiy reg.  194044
+				RU
+
+00-1F-23   (hex)		Interacoustics
+001F23     (base 16)		Interacoustics
+				Drejervaenget 8
+				Assens  DK  5610
+				DK
+
+00-1F-06   (hex)		Integrated Dispatch Solutions
+001F06     (base 16)		Integrated Dispatch Solutions
+				645 Mountain Ave
+				Wyckoff  NJ  07481
+				US
+
+00-1E-BA   (hex)		High Density Devices AS
+001EBA     (base 16)		High Density Devices AS
+				Vestre Strandgate 26
+				Kristiansand    4611
+				NO
+
+00-1E-B8   (hex)		Aloys, Inc
+001EB8     (base 16)		Aloys, Inc
+				#3F HANWHA TECHWIN R&D BLDG. 4-5, YANGHYEON-RO 405 BEON-GIL,
+				JUNGWON-GU, SEONGNAM-SI  GYEONGGI-DO  13438
+				KR
+
+00-1E-B4   (hex)		UNIFAT TECHNOLOGY LTD.
+001EB4     (base 16)		UNIFAT TECHNOLOGY LTD.
+				7/FLOOR, SUI HONG IND. BLDG.,
+				KWAI CHUNG  N.T.  
+				HK
+
+00-1E-DA   (hex)		Wesemann Elektrotechniek B.V.
+001EDA     (base 16)		Wesemann Elektrotechniek B.V.
+				Droogbloem 31
+				Rotterdam  Zuid-Holland  3068 AW
+				NL
+
+00-1E-D7   (hex)		H-Stream Wireless, Inc.
+001ED7     (base 16)		H-Stream Wireless, Inc.
+				2595 East Bayshore Road
+				Palo Alto  CA  94303
+				US
+
+00-1E-D5   (hex)		Tekon-Automatics
+001ED5     (base 16)		Tekon-Automatics
+				Zelenograd, 512-29
+				Moscow    124482
+				RU
+
+00-1E-E8   (hex)		Mytek
+001EE8     (base 16)		Mytek
+				151 Lafayette Str 3 Fl
+				New York  NY  10013
+				US
+
+00-1E-EE   (hex)		ETL Systems Ltd
+001EEE     (base 16)		ETL Systems Ltd
+				Coldwell Radio Station
+				Hereford  Herefordshire  HR2 9NE
+				GB
+
+00-1E-FA   (hex)		PROTEI Ltd.
+001EFA     (base 16)		PROTEI Ltd.
+				60A B.Sampsonievsky,  Business Center
+				St.Petersburg  RU  194044
+				RU
+
+00-1E-FB   (hex)		Trio Motion Technology Ltd
+001EFB     (base 16)		Trio Motion Technology Ltd
+				Shannon Way
+				Tewkesbury  Gloucestershire  GL20 8ND
+				GB
+
+00-1E-F8   (hex)		Emfinity Inc.
+001EF8     (base 16)		Emfinity Inc.
+				1305 Kelly Lake Road
+				Sudbury  Ontario  P3E5P5
+				CA
+
+00-1E-CB   (hex)		RPC Energoautomatika Ltd
+001ECB     (base 16)		RPC Energoautomatika Ltd
+				Krasnokazarmennaya st., 13/1
+				Moscow    111250
+				RU
+
+00-1E-A8   (hex)		Datang Mobile Communications Equipment CO.,LTD
+001EA8     (base 16)		Datang Mobile Communications Equipment CO.,LTD
+				No.29,Xueyuan Rd.
+				Beijing    100083
+				CN
+
+00-1E-AB   (hex)		TeleWell Oy
+001EAB     (base 16)		TeleWell Oy
+				Alahotie 14 b
+				Jarvenpaa  Uusimaa  04430
+				FI
+
+00-1E-9F   (hex)		Visioneering Systems, Inc.
+001E9F     (base 16)		Visioneering Systems, Inc.
+				5931 Sea Lion Place
+				Carlsbad  California  92010
+				US
+
+00-1E-6B   (hex)		Cisco SPVTG
+001E6B     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-1E-70   (hex)		Cobham Antenna Systems
+001E70     (base 16)		Cobham Antenna Systems
+				Cobham Centre, Fourth Avenue
+				Marlow  Buckinghamshire  SL7 1TF
+				GB
+
+00-1E-61   (hex)		ITEC GmbH
+001E61     (base 16)		ITEC GmbH
+				Lassnitzthal 300
+				  A-8200   Gleisdorf
+				AT
+
+00-1E-3E   (hex)		KMW Inc.
+001E3E     (base 16)		KMW Inc.
+				65 Youngchun-ri, Dongtan-myun
+				Hwasung-si  Kyungki-do  445-813
+				KR
+
+00-1E-38   (hex)		Bluecard Software Technology Co., Ltd.
+001E38     (base 16)		Bluecard Software Technology Co., Ltd.
+				D-801 Shangdi Science Building
+				Beijing    100085
+				CN
+
+00-1E-47   (hex)		PT. Hariff Daya Tunggal Engineering
+001E47     (base 16)		PT. Hariff Daya Tunggal Engineering
+				Jl. Soekarno Hatta No. 450
+				Bandung  Jawa Barat  40266
+				ID
+
+00-1E-48   (hex)		Wi-Links
+001E48     (base 16)		Wi-Links
+				332 Ayiou street
+				Limassol    3725
+				CY
+
+00-1E-8A   (hex)		eCopy, Inc
+001E8A     (base 16)		eCopy, Inc
+				1 Oracle Dr
+				Nashua  NH  03062
+				US
+
+00-1E-9B   (hex)		San-Eisha, Ltd.
+001E9B     (base 16)		San-Eisha, Ltd.
+				2-1 Ebara 5-chome
+				Shinagawa-ku  Tokyo  142-8611
+				JP
+
+00-1E-96   (hex)		Sepura Plc
+001E96     (base 16)		Sepura Plc
+				Radio House
+				Cambridge  CAMBRIDGESHIRE  CB4 1GR
+				GB
+
+00-1E-59   (hex)		Silicon Turnkey Express, LLC
+001E59     (base 16)		Silicon Turnkey Express, LLC
+				749 Miner Road
+				Highland Heights  Ohio  44143
+				US
+
+00-1E-51   (hex)		Converter Industry Srl
+001E51     (base 16)		Converter Industry Srl
+				Via Euclide, 12
+				Forli'  FC  47100
+				IT
+
+00-1E-71   (hex)		MIrcom Group of Companies
+001E71     (base 16)		MIrcom Group of Companies
+				25 Interchange Way
+				  Vaughan, Ontario  l4K 5W3
+				CA
+
+00-1D-C4   (hex)		AIOI Systems Co., Ltd.
+001DC4     (base 16)		AIOI Systems Co., Ltd.
+				KDX Omori, Bldg 8F
+				Tokyo    140-0016
+				JP
+
+00-1D-C0   (hex)		Enphase Energy
+001DC0     (base 16)		Enphase Energy
+				201 1st Street, Suite 111
+				Petaluma  CA  94952
+				US
+
+00-1D-BD   (hex)		Versamed Inc.
+001DBD     (base 16)		Versamed Inc.
+				2 Blue Hill Plaza
+				Pearl River  NY  10965
+				US
+
+00-1D-F8   (hex)		Webpro Vision Technology Corporation
+001DF8     (base 16)		Webpro Vision Technology Corporation
+				4F., No.573, Cingping Rd.
+				Anping District    708
+				TW
+
+00-1D-F9   (hex)		Cybiotronics (Far East) Limited
+001DF9     (base 16)		Cybiotronics (Far East) Limited
+				Unit 1906, Eastern Centre,
+				Quarry Bay    
+				HK
+
+00-1D-F7   (hex)		R. STAHL Schaltgeräte GmbH
+001DF7     (base 16)		R. STAHL Schaltgeräte GmbH
+				am Bahnhof 30
+				Waldenburg  Baden-Württemberg  74638
+				DE
+
+00-1E-05   (hex)		Xseed Technologies & Computing
+001E05     (base 16)		Xseed Technologies & Computing
+				Topaz House, MATAM
+				Haifa    39100
+				IL
+
+00-1E-07   (hex)		Winy Technology Co., Ltd.
+001E07     (base 16)		Winy Technology Co., Ltd.
+				305-303, Bucheon Techno-park, #365
+				Bucheon  Gyeonggi-do  421-741
+				KR
+
+00-1E-0A   (hex)		Syba Tech Limited
+001E0A     (base 16)		Syba Tech Limited
+				RM1301, Vanta Industrial Centre,
+				Kwai Chung    
+				HK
+
+00-1E-03   (hex)		LiComm Co., Ltd.
+001E03     (base 16)		LiComm Co., Ltd.
+				908-1 SEO-RI, IDONG-MYEON
+				YONGIN-SI  GYEONGGI-DO  449-834
+				KR
+
+00-1E-1B   (hex)		Digital Stream Technology, Inc.
+001E1B     (base 16)		Digital Stream Technology, Inc.
+				4,5,6th Fl., TaeChang B/D, 451-1
+				Seoul    134-030
+				KR
+
+00-1E-17   (hex)		STN BV
+001E17     (base 16)		STN BV
+				Amerikaweg 4
+				Hulst  Zeeland  4561 PB
+				NL
+
+00-1E-18   (hex)		Radio Activity srl
+001E18     (base 16)		Radio Activity srl
+				Via De Notaris 50
+				Milano  MI  20128
+				IT
+
+00-1E-15   (hex)		Beech Hill Electronics
+001E15     (base 16)		Beech Hill Electronics
+				Beechcroft, Beech Hill Road
+				Reading  Berkshire  RG7 2AU
+				GB
+
+00-1E-30   (hex)		Shireen Inc
+001E30     (base 16)		Shireen Inc
+				8531 Ziggy Lane
+				Gaithersburg  MD  20877
+				US
+
+00-1E-2E   (hex)		SIRTI S.p.A.
+001E2E     (base 16)		SIRTI S.p.A.
+				Via Bombrini 11/3
+				GENOA    16149
+				IT
+
+00-1D-DC   (hex)		HangZhou DeChangLong Tech&Info Co.,Ltd
+001DDC     (base 16)		HangZhou DeChangLong Tech&Info Co.,Ltd
+				Room 1102,KeJi Mansion,
+				HangZhou  ZheJiang  310012
+				CN
+
+00-1D-EB   (hex)		DINEC International
+001DEB     (base 16)		DINEC International
+				Rue de la Gare, 30
+				BRAINE L'ALLEUD  BRABANT WALLON  1420
+				BE
+
+00-1D-9A   (hex)		GODEX INTERNATIONAL CO., LTD
+001D9A     (base 16)		GODEX INTERNATIONAL CO., LTD
+				4F. NO.168, Lian-Cheng Road Chung-Ho City,
+				Taipei  Hsien  235
+				US
+
+00-1D-97   (hex)		Alertus Technologies LLC
+001D97     (base 16)		Alertus Technologies LLC
+				11785 Beltsville Drive
+				Beltsville  MD  20705
+				US
+
+00-1D-91   (hex)		Digitize, Inc
+001D91     (base 16)		Digitize, Inc
+				158 Edison Road
+				Lake Hopatcong  New Jersey  07849
+				US
+
+00-1D-95   (hex)		Flash, Inc.
+001D95     (base 16)		Flash, Inc.
+				3703 N. 200th St.
+				Elkhorn  NE  68022-2922
+				US
+
+00-1D-9D   (hex)		ARTJOY INTERNATIONAL LIMITED
+001D9D     (base 16)		ARTJOY INTERNATIONAL LIMITED
+				Room 1601,No.239 ZhongXing Road,LuoHu District
+				Shenzhen  Guangdong  518001
+				CN
+
+00-1D-9E   (hex)		AXION TECHNOLOGIES
+001D9E     (base 16)		AXION TECHNOLOGIES
+				151 RUE PARC INNOVATION
+				LA POCATIERE  QUEBEC  G0R1Z0
+				US
+
+00-1D-70   (hex)		Cisco Systems, Inc
+001D70     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-78   (hex)		Invengo Information Technology Co.,Ltd
+001D78     (base 16)		Invengo Information Technology Co.,Ltd
+				3/F,No.T2-B,High-Tech Industrial Park South
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1D-6F   (hex)		Chainzone Technology Co., Ltd
+001D6F     (base 16)		Chainzone Technology Co., Ltd
+				Chainzone Tech. Ind Park, Nanxin 1st Rd.
+				Foshan  Guangdong  528200
+				CN
+
+00-1D-7F   (hex)		Tekron International Ltd
+001D7F     (base 16)		Tekron International Ltd
+				409 Cuba Street, Alicetown
+				Lower Hutt  Wellington  5010
+				NZ
+
+00-1D-79   (hex)		SIGNAMAX LLC
+001D79     (base 16)		SIGNAMAX LLC
+				1090 Vermont Avenue
+				Washington  Washington D.C.  20005
+				US
+
+00-1D-AE   (hex)		CHANG TSENG TECHNOLOGY CO., LTD
+001DAE     (base 16)		CHANG TSENG TECHNOLOGY CO., LTD
+				2F NO.160 BACK BUILDING, LEN CHENG RD., CHUNG HO CITY
+				TAIPEI  HSIEN  235
+				TW
+
+00-1D-A6   (hex)		Media Numerics Limited
+001DA6     (base 16)		Media Numerics Limited
+				Rodenbacher Chaussee 6
+				Hanau  Hessen  63457
+				DE
+
+00-1D-62   (hex)		InPhase Technologies
+001D62     (base 16)		InPhase Technologies
+				2000 Pike Road
+				Longmont  Colorado  80501
+				US
+
+00-1D-63   (hex)		Miele & Cie. KG
+001D63     (base 16)		Miele & Cie. KG
+				Carl-Miele-Straße 29
+				Gütersloh    33332
+				DE
+
+00-1D-B7   (hex)		Tendril Networks, Inc.
+001DB7     (base 16)		Tendril Networks, Inc.
+				5700-D Flatiron Parkway
+				Boulder  CO  80301
+				US
+
+00-1D-8D   (hex)		Fluke Process Instruments GmbH
+001D8D     (base 16)		Fluke Process Instruments GmbH
+				Blankenburger Str. 135
+				Berlin    13127
+				DE
+
+00-1D-1F   (hex)		Siauliu Tauro Televizoriai, JSC
+001D1F     (base 16)		Siauliu Tauro Televizoriai, JSC
+				Pramones,15
+				Siauliai    LT-57318
+				LT
+
+00-1D-43   (hex)		Shenzhen G-link Digital Technology Co., Ltd.
+001D43     (base 16)		Shenzhen G-link Digital Technology Co., Ltd.
+				4F, E Building,Huachuang Da Technology Zone ,Hangcheng Highway,Gushu,Xixiang ,
+				shenzhen  GuangDong  518126
+				CN
+
+00-1D-3F   (hex)		Mitron Pty Ltd
+001D3F     (base 16)		Mitron Pty Ltd
+				Unit 11
+				Artarmon  NSW  2065
+				AU
+
+00-1D-39   (hex)		MOOHADIGITAL CO., LTD
+001D39     (base 16)		MOOHADIGITAL CO., LTD
+				Seoul Hightech Venture Center C-307 647-26
+				SEOUL    157-030
+				KR
+
+00-1D-37   (hex)		Thales-Panda Transportation System
+001D37     (base 16)		Thales-Panda Transportation System
+				6th floor, HUIJIE Plaza, 268 Zhongshan Rd.
+				nanjing  jiangsu  210008
+				CN
+
+00-1D-13   (hex)		NextGTV
+001D13     (base 16)		NextGTV
+				13F Byucksan/Kyungin Digital Valley ll
+				Seoul    153-803
+				KR
+
+00-1D-14   (hex)		SPERADTONE INFORMATION TECHNOLOGY LIMITED
+001D14     (base 16)		SPERADTONE INFORMATION TECHNOLOGY LIMITED
+				Room 1001 NO.418 Gui Ping Road,
+				Shanghai    200233
+				CN
+
+00-1D-10   (hex)		LightHaus Logic, Inc.
+001D10     (base 16)		LightHaus Logic, Inc.
+				126-1020 Mainland Street
+				Vancouver  BC  V6B 2T4
+				CA
+
+00-1D-04   (hex)		Zipit Wireless, Inc.
+001D04     (base 16)		Zipit Wireless, Inc.
+				49 Salters Road.
+				Greenville  SC  29607
+				US
+
+00-1C-F2   (hex)		Tenlon Technology Co.,Ltd.
+001CF2     (base 16)		Tenlon Technology Co.,Ltd.
+				4/F.,Shenhua Bldg,No.3155,Binhe Road,Futian District
+				Shenzhen  Guangdong  518033
+				CN
+
+00-1D-30   (hex)		YX Wireless S.A.
+001D30     (base 16)		YX Wireless S.A.
+				Av. Vicuña Mackenna #4860
+				Santiago    8580710
+				US
+
+00-1C-B2   (hex)		BPT SPA
+001CB2     (base 16)		BPT SPA
+				Via Stazione,48
+				Sesto al Reghena  Pordenone  33079
+				IT
+
+00-1C-B5   (hex)		Neihua Network Technology Co.,LTD.(NHN)
+001CB5     (base 16)		Neihua Network Technology Co.,LTD.(NHN)
+				Plot Xinmei Road 102-Q,New District
+				WuXi  Jiangsu  214028
+				CN
+
+00-1C-B4   (hex)		Iridium Satellite LLC
+001CB4     (base 16)		Iridium Satellite LLC
+				8440 S. River Parkway
+				Tempe  AZ  85284
+				US
+
+00-1C-B6   (hex)		Duzon CNT Co., Ltd.
+001CB6     (base 16)		Duzon CNT Co., Ltd.
+				14th Floor, IRE building 2
+				Seoul    150-967
+				KR
+
+00-1C-C7   (hex)		Rembrandt Technologies, LLC d/b/a REMSTREAM
+001CC7     (base 16)		Rembrandt Technologies, LLC d/b/a REMSTREAM
+				140 South Beverly Drive
+				Beverly Hills  CA  90212
+				US
+
+00-1C-BB   (hex)		MusicianLink
+001CBB     (base 16)		MusicianLink
+				2401 Cory Ave.
+				San Jose  CA  95128
+				US
+
+00-1C-8D   (hex)		Mesa Imaging
+001C8D     (base 16)		Mesa Imaging
+				Badenerstrasse 569
+				Zürich  ZH  8048
+				CH
+
+00-1C-89   (hex)		Force Communications, Inc.
+001C89     (base 16)		Force Communications, Inc.
+				3810 Arbordale Lane
+				Sachse  TX  75048
+				US
+
+00-1C-87   (hex)		Uriver Inc.
+001C87     (base 16)		Uriver Inc.
+				3rd., Fl., Bogwang Bldg., Poi-dong, 238-7 Gangnam-gu,
+				Seoul    135-964
+				KR
+
+00-1C-CD   (hex)		Alektrona Corporation
+001CCD     (base 16)		Alektrona Corporation
+				95 Hathaway Street, Suite 10
+				Providence  RI  02907
+				US
+
+00-1C-EC   (hex)		Mobilesoft (Aust.) Pty Ltd
+001CEC     (base 16)		Mobilesoft (Aust.) Pty Ltd
+				Suite 2, 27-35 Grosvenor Street
+				Sydney  NSW  2089
+				AU
+
+00-1C-E8   (hex)		Cummins Inc
+001CE8     (base 16)		Cummins Inc
+				1400 73rd Ave NE
+				Fridley  MN  55432
+				US
+
+00-1C-D0   (hex)		Circleone Co.,Ltd.
+001CD0     (base 16)		Circleone Co.,Ltd.
+				860-1,Noda
+				Beppu-shi  Ooita-ken  874-0016
+				JP
+
+00-1C-9F   (hex)		Razorstream, LLC
+001C9F     (base 16)		Razorstream, LLC
+				2381-C Renaissance Drive
+				Las Vegas  NV  89119
+				US
+
+00-1C-7D   (hex)		Excelpoint Manufacturing Pte Ltd
+001C7D     (base 16)		Excelpoint Manufacturing Pte Ltd
+				15, Changi Business Park
+				    486057
+				SG
+
+00-1C-5C   (hex)		Integrated Medical Systems, Inc.
+001C5C     (base 16)		Integrated Medical Systems, Inc.
+				1984 Obispo Avenue
+				Signal Hill  CA  90755
+				US
+
+00-1C-52   (hex)		VISIONEE SRL
+001C52     (base 16)		VISIONEE SRL
+				VIALE DELLA REPUBBLICA, 22
+				VILLORBA  TREVISO  31050
+				IT
+
+00-1C-47   (hex)		Hangzhou Hollysys Automation Co., Ltd
+001C47     (base 16)		Hangzhou Hollysys Automation Co., Ltd
+				No.10 Middle Road, Jiancaicheng, Haidian District,
+				Beijing    100096
+				CN
+
+00-1C-16   (hex)		ThyssenKrupp Elevator
+001C16     (base 16)		ThyssenKrupp Elevator
+				9280 Crestwyn Hills Drive
+				Memphis  TN  38125
+				US
+
+00-1C-19   (hex)		secunet Security Networks AG
+001C19     (base 16)		secunet Security Networks AG
+				Kronprinzenstraße 30
+				Essen  NRW  45128
+				DE
+
+00-1C-6C   (hex)		30805
+001C6C     (base 16)		30805
+				128, Jun Cheng Road,uangzhou Economic and Technological Development District
+				Guangzhou  Guangdong  510530
+				CN
+
+00-1C-61   (hex)		Galaxy  Microsystems LImited
+001C61     (base 16)		Galaxy  Microsystems LImited
+				Room 1101-03, 11/F Enterprise Square Two
+				Kowloon Bay  Kowloon  
+				HK
+
+00-1C-3B   (hex)		AmRoad Technology Inc.
+001C3B     (base 16)		AmRoad Technology Inc.
+				18F-3 No. 150 , Chien I Rd
+				Chung Ho  Taipei Hsien  23511
+				TW
+
+00-1C-3F   (hex)		International Police Technologies, Inc.
+001C3F     (base 16)		International Police Technologies, Inc.
+				4150 S. 87th E. Avenue
+				Tulsa  OK  74145
+				US
+
+00-1C-28   (hex)		Sphairon Technologies GmbH 
+001C28     (base 16)		Sphairon Technologies GmbH 
+				Philipp-Reis-Strasse 1
+				Bautzen  Saxony  02625    
+				DE
+
+00-1C-1F   (hex)		Quest Retail Technology Pty Ltd
+001C1F     (base 16)		Quest Retail Technology Pty Ltd
+				37-39 Walsh Street
+				Thebarton  SA  5031
+				AU
+
+00-1C-32   (hex)		Telian Corporation
+001C32     (base 16)		Telian Corporation
+				4FL. Namjeon Bldg. 53-3 Haandong
+				Kwangmyungsi  Kyoungkido  423060
+				KR
+
+00-1C-2B   (hex)		Alertme.com Limited
+001C2B     (base 16)		Alertme.com Limited
+				30 Station Road
+				Cambridge  Cambridgeshire  CB1 2RE
+				GB
+
+00-1C-77   (hex)		Prodys
+001C77     (base 16)		Prodys
+				C/Trigo 54 Pol. Ind. Polvoranca
+				Leganes  MADRID  28914
+				ES
+
+00-1C-6F   (hex)		Emfit Ltd
+001C6F     (base 16)		Emfit Ltd
+				Konttisentie 8 B
+				Vaajakoski    40800
+				FI
+
+00-1C-49   (hex)		Zoltan Technology Inc.
+001C49     (base 16)		Zoltan Technology Inc.
+				4F, No.30, Wunsi St.
+				Jhubei  Hsinchu  302
+				TW
+
+00-1C-63   (hex)		TRUEN
+001C63     (base 16)		TRUEN
+				4F SAMWON BLDG., 451-7
+				SEOUL    137-818
+				KR
+
+00-1B-DF   (hex)		Iskra Sistemi d.d.
+001BDF     (base 16)		Iskra Sistemi d.d.
+				Stegne 21
+				Ljubljana  Slovenia  1000
+				SI
+
+00-1B-D9   (hex)		Edgewater Wireless Systems Inc
+001BD9     (base 16)		Edgewater Wireless Systems Inc
+				50 HInes Road Suite 200
+				Ottawa  Ontario  K2K-2M5
+				CA
+
+00-1B-C7   (hex)		StarVedia Technology Inc.
+001BC7     (base 16)		StarVedia Technology Inc.
+				3F, No. 247, Done Sec. 1, Guangming 6th Rd.
+				Jhubei  Hsin-Chu County  302
+				TW
+
+00-1B-EC   (hex)		Netio Technologies Co., Ltd
+001BEC     (base 16)		Netio Technologies Co., Ltd
+				4F-1, No. 582, Rueiguang Rd., Neihu District
+				Taipei    11492
+				TW
+
+00-1C-09   (hex)		SAE Electronic Co.,Ltd.
+001C09     (base 16)		SAE Electronic Co.,Ltd.
+				23/F,Ying Long Zhan Ye Building,
+				Shenzhen  Guang Dong  518040
+				CN
+
+00-1C-0C   (hex)		TANITA Corporation
+001C0C     (base 16)		TANITA Corporation
+				1-14-2,Maeno-cho
+				Tokyo    174-8630
+				JP
+
+00-1B-A6   (hex)		intotech inc.
+001BA6     (base 16)		intotech inc.
+				 13F DMC R&D Center E3-2 Building Land Development District Sangam-Dong
+				Mapogu  Seoul  121-270
+				KR
+
+00-1B-A4   (hex)		S.A.E Afikim
+001BA4     (base 16)		S.A.E Afikim
+				Kibutz Afikim
+				Kibutz Afikim    15148
+				IL
+
+00-1B-B4   (hex)		Airvod Limited
+001BB4     (base 16)		Airvod Limited
+				Heather House
+				Sandyford Ind Est  Dublin 18  D18
+				IE
+
+00-1B-B6   (hex)		Bird Electronic Corp.
+001BB6     (base 16)		Bird Electronic Corp.
+				30303 Aurora Road
+				Solon  Ohio  44139
+				US
+
+00-1B-E8   (hex)		Ultratronik GmbH
+001BE8     (base 16)		Ultratronik GmbH
+				Dornierstr. 9
+				Gilching    822205
+				DE
+
+00-1B-E1   (hex)		ViaLogy
+001BE1     (base 16)		ViaLogy
+				2400 Lincoln Ave
+				Altadena  CA  91001
+				US
+
+00-1B-93   (hex)		JC Decaux SA DNT
+001B93     (base 16)		JC Decaux SA DNT
+				21 rue claude Bernard
+				MAUREPAS    78310
+				FR
+
+00-1B-9B   (hex)		Hose-McCann Communications
+001B9B     (base 16)		Hose-McCann Communications
+				1241 West Newport Center Drive
+				Deerfield Beach  FL  33442
+				US
+
+00-1B-9C   (hex)		SATEL sp. z o.o.
+001B9C     (base 16)		SATEL sp. z o.o.
+				Schuberta 79
+				Gdansk  pomorskie  80-172
+				PL
+
+00-1B-92   (hex)		l-acoustics
+001B92     (base 16)		l-acoustics
+				parc de la fontaine de jouvence
+				marcoussis  essonne  91462
+				FR
+
+00-1B-8E   (hex)		Hulu Sweden AB
+001B8E     (base 16)		Hulu Sweden AB
+				Box 12328, 10228
+				Kista  Stockholm  164 40
+				SE
+
+00-1B-45   (hex)		ABB AS, Division Automation Products
+001B45     (base 16)		ABB AS, Division Automation Products
+				Bergerveien 12
+				Billingstad    NO-1375
+				NO
+
+00-1B-3F   (hex)		ProCurve Networking by HP
+001B3F     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				    118502
+				SG
+
+00-1B-41   (hex)		General Infinity Co.,Ltd.
+001B41     (base 16)		General Infinity Co.,Ltd.
+				3F,No.169, Xing-ai Rd,
+				Taipei    114
+				TW
+
+00-1B-50   (hex)		Nizhny Novgorod Factory named after M.Frunze, FSUE (NZiF)
+001B50     (base 16)		Nizhny Novgorod Factory named after M.Frunze, FSUE (NZiF)
+				174, Gagarina Avenue
+				Nizhny Novgorod  Russia  603950
+				RU
+
+00-1B-47   (hex)		Futarque A/S
+001B47     (base 16)		Futarque A/S
+				Aagade 15B
+				Aalborg    9000
+				DK
+
+00-1B-6C   (hex)		LookX Digital Media BV
+001B6C     (base 16)		LookX Digital Media BV
+				Roekenveldweg 1
+				Brunssum  Limburg  6446DK
+				NL
+
+00-1B-6B   (hex)		Swyx Solutions AG
+001B6B     (base 16)		Swyx Solutions AG
+				Joseph-von-Fraunhofer-straße 13a
+				Dortmund    44227
+				DE
+
+00-1B-69   (hex)		Equaline Corporation
+001B69     (base 16)		Equaline Corporation
+				9F, No. 234, Section 4, Cheng-De Road,
+				  Taipei Hsien  25162
+				TW
+
+00-1B-76   (hex)		Ripcode, Inc.
+001B76     (base 16)		Ripcode, Inc.
+				1130 E. Arapaho Road
+				Richardson  TX  75081
+				US
+
+00-1B-70   (hex)		IRI Ubiteq, INC.
+001B70     (base 16)		IRI Ubiteq, INC.
+				Shinjuku-Nomura Bldg. 47F,
+				Shinjuku-ku  Tokyo  163-0547
+				JP
+
+00-1B-68   (hex)		Modnnet Co., Ltd
+001B68     (base 16)		Modnnet Co., Ltd
+				2139 Daemyung-Dong DIP main B/D Room#505, Namgu
+				Daegu  Kyungsang Bookdo  705-701
+				KR
+
+00-1B-62   (hex)		JHT Optoelectronics Co.,Ltd.
+001B62     (base 16)		JHT Optoelectronics Co.,Ltd.
+				Hetian Industrial Park 2rd,Houjie Town, Donguan,
+				Dongguan  Guangdong  523945
+				CN
+
+00-1B-8A   (hex)		2M Electronic A/S
+001B8A     (base 16)		2M Electronic A/S
+				Malervej 10
+				Taastrup    2630
+				DK
+
+00-1B-80   (hex)		LORD Corporation
+001B80     (base 16)		LORD Corporation
+				2000 West Grandview Blvd
+				Erie  Pa  16509
+				US
+
+00-1B-3E   (hex)		Curtis, Inc.
+001B3E     (base 16)		Curtis, Inc.
+				2405 Annapolis Lane
+				Minneapolis  MN  55441
+				US
+
+00-1B-37   (hex)		Computec Oy
+001B37     (base 16)		Computec Oy
+				Juholankatu 8
+				Kouvola  Kymi  45200
+				FI
+
+00-1B-07   (hex)		Mendocino Software
+001B07     (base 16)		Mendocino Software
+				47001 Benecia St.
+				Fremont  CA  94538
+				US
+
+00-1B-08   (hex)		Danfoss Drives A/S
+001B08     (base 16)		Danfoss Drives A/S
+				Ulsnaes 1
+				Graasten  6300  
+				DK
+
+00-1B-01   (hex)		Applied Radio Technologies
+001B01     (base 16)		Applied Radio Technologies
+				1124 South Service Road West
+				Oakville  Ontario  L6L 5T7
+				CA
+
+00-1B-02   (hex)		ED Co.Ltd
+001B02     (base 16)		ED Co.Ltd
+				517-15 SangDaeWon-Dong
+				SeongNam-City  GyeongGi-Do  462-806
+				KR
+
+00-1A-FC   (hex)		ModusLink Corporation
+001AFC     (base 16)		ModusLink Corporation
+				2905 Prestonwood Drive
+				Plano  Texas  75093
+				US
+
+00-1B-10   (hex)		ShenZhen Kang Hui Technology Co.,ltd
+001B10     (base 16)		ShenZhen Kang Hui Technology Co.,ltd
+				China  GuangDong
+				ShenZhen  GuangDong  518109
+				CN
+
+00-1B-0B   (hex)		Phidgets Inc.
+001B0B     (base 16)		Phidgets Inc.
+				2715A 16A Street N.W.
+				Calgary  Alberta  T2M 3R7
+				CA
+
+00-1B-0C   (hex)		Cisco Systems, Inc
+001B0C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-E0   (hex)		Mythology Tech Express Inc.
+001AE0     (base 16)		Mythology Tech Express Inc.
+				2F, No.10, Lane 235, Bao Chiao road,
+				Taipei    231
+				TW
+
+00-1A-E2   (hex)		Cisco Systems, Inc
+001AE2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-D7   (hex)		Christie Digital Systems, Inc.
+001AD7     (base 16)		Christie Digital Systems, Inc.
+				809 Wellington Street North
+				Kitchener  Ontario  N2G 4Y7
+				CA
+
+00-1B-23   (hex)		SimpleComTools
+001B23     (base 16)		SimpleComTools
+				598 Indian Trail Rd S.
+				Indian Trail  NC  28079
+				US
+
+00-1A-F6   (hex)		Woven Systems, Inc.
+001AF6     (base 16)		Woven Systems, Inc.
+				2455 Augustine Drive
+				Santa Clara  CA  95054
+				US
+
+00-1A-F9   (hex)		AeroVIronment (AV Inc)
+001AF9     (base 16)		AeroVIronment (AV Inc)
+				4685 Industrial St
+				Simi Valley  CA  93063
+				US
+
+00-1B-30   (hex)		Solitech Inc.
+001B30     (base 16)		Solitech Inc.
+				1838 Main Street
+				Stevensville  MD  21666
+				US
+
+00-1B-18   (hex)		Tsuken Electric Ind. Co.,Ltd
+001B18     (base 16)		Tsuken Electric Ind. Co.,Ltd
+				3-9 Akedouri Izumi-ku
+				Sendai City  Miyagi  981-3206
+				JP
+
+00-1A-E7   (hex)		Aztek Networks, Inc.
+001AE7     (base 16)		Aztek Networks, Inc.
+				2477 55th St. #202
+				Boulder  CO  80301
+				US
+
+00-1A-95   (hex)		Hisense Mobile Communications Technoligy Co.,Ltd.
+001A95     (base 16)		Hisense Mobile Communications Technoligy Co.,Ltd.
+				11,JiangXi Road,
+				QingDao  ShanDong  266071
+				CN
+
+00-1A-81   (hex)		Zelax
+001A81     (base 16)		Zelax
+				2nd buid., 1B, Zavodskaya st.,
+				Moscow    124681
+				RU
+
+00-1A-87   (hex)		Canhold International Limited
+001A87     (base 16)		Canhold International Limited
+				Flat 4, 13/F., Block 4, Tai Ping Industrial Centre
+				    00852
+				HK
+
+00-1A-88   (hex)		Venergy,Co,Ltd
+001A88     (base 16)		Venergy,Co,Ltd
+				West 6th Floor,M-8 Building Maqueling Zone,
+				shenzhen  guangdong  518000
+				CN
+
+00-1A-C1   (hex)		3Com Ltd
+001AC1     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-1A-BB   (hex)		Fontal Technology Incorporation
+001ABB     (base 16)		Fontal Technology Incorporation
+				Rm.522, Bldg. 52, 195, Sec. 4, ChungHsing Rd., Chutung
+				Hsinchu    310
+				TW
+
+00-1A-BD   (hex)		Impatica Inc.
+001ABD     (base 16)		Impatica Inc.
+				205-1725 St. Laurent Blvd.
+				Ottawa  ON  K1G 3V4
+				CA
+
+00-1A-AE   (hex)		Savant Systems LLC
+001AAE     (base 16)		Savant Systems LLC
+				45 Perseverance Way
+				Hyannis  Massachusetts  02601
+				US
+
+00-1A-CD   (hex)		Tidel Engineering LP
+001ACD     (base 16)		Tidel Engineering LP
+				2025 W Belt Line Road Suite 114
+				Carrollton  TX  75019
+				US
+
+00-1A-C9   (hex)		SUZUKEN CO.,LTD
+001AC9     (base 16)		SUZUKEN CO.,LTD
+				SUZUKEN TOMEI BLDG.
+				NAGOYA-SI  AICHI-KEN  465-0045
+				JP
+
+00-1A-79   (hex)		TELECOMUNICATION TECHNOLOGIES LTD.
+001A79     (base 16)		TELECOMUNICATION TECHNOLOGIES LTD.
+				4D ZHUKOVA BLV.
+				ODESSA    65121
+				UA
+
+00-1A-AA   (hex)		Analogic Corp.
+001AAA     (base 16)		Analogic Corp.
+				8 Centennial Drive
+				Peabody  MA  01960
+				US
+
+00-1A-8B   (hex)		CHUNIL ELECTRIC IND., CO.
+001A8B     (base 16)		CHUNIL ELECTRIC IND., CO.
+				308,ByuckSan Digital Valley,132-7,Gamjeon-Dong,Sasang-Gu
+				Busan  GyeongSangNamDo  617-800
+				KR
+
+00-1A-8D   (hex)		AVECS Bergen GmbH
+001A8D     (base 16)		AVECS Bergen GmbH
+				Billrothstraße 11 a
+				Bergen auf Rügen  M/V  18528
+				DE
+
+00-1A-B4   (hex)		FFEI Ltd.
+001AB4     (base 16)		FFEI Ltd.
+				Graphics House
+				Hemel Hempstead  Hertfordshire  HP2 7SU
+				GB
+
+00-1A-B5   (hex)		Home Network System
+001AB5     (base 16)		Home Network System
+				107, Hyundai I-Vally
+				Seongnam-si  Gyeonggi-do  462-714
+				KR
+
+00-1A-A4   (hex)		Future University-Hakodate
+001AA4     (base 16)		Future University-Hakodate
+				116-2 Kamedanakano-cho
+				Hakodate  Hokkaido  041-8655
+				JP
+
+00-1A-9F   (hex)		A-Link Ltd
+001A9F     (base 16)		A-Link Ltd
+				Kylavainiontie 20
+				Espoo    FI-02760
+				FI
+
+00-1A-74   (hex)		Procare International Co
+001A74     (base 16)		Procare International Co
+				5F, No.88, Jhouzih Street, Neihu District
+				Taipei    114
+				TW
+
+00-1A-BE   (hex)		COMPUTER HI-TECH INC.
+001ABE     (base 16)		COMPUTER HI-TECH INC.
+				HigashiUeno3-18-7
+				Taitoku  Tokyo  110-0015
+				JP
+
+00-1A-19   (hex)		Computer Engineering Limited
+001A19     (base 16)		Computer Engineering Limited
+				PO Box 493
+				Auckland  AK  2340
+				NZ
+
+00-1A-18   (hex)		Advanced Simulation Technology inc.
+001A18     (base 16)		Advanced Simulation Technology inc.
+				500A Huntmar Park Drive
+				Herndon  VA  20170
+				US
+
+00-1A-58   (hex)		CCV Deutschland GmbH - Celectronic eHealth Div.
+001A58     (base 16)		CCV Deutschland GmbH - Celectronic eHealth Div.
+				Gertraudenstrasse 18
+				Berlin    D-10178
+				DE
+
+00-1A-5E   (hex)		Thincom Technology Co.,Ltd
+001A5E     (base 16)		Thincom Technology Co.,Ltd
+				17F-3, No.398, Huanbei Rd.,
+				Zhongli City  Taoyuan Contry  320
+				TW
+
+00-1A-5C   (hex)		Euchner GmbH+Co. KG
+001A5C     (base 16)		Euchner GmbH+Co. KG
+				Kohlhammerstraße 16
+				Leinfelden-Echterdingen  BW  70771
+				DE
+
+00-1A-5B   (hex)		NetCare Service Co., Ltd.
+001A5B     (base 16)		NetCare Service Co., Ltd.
+				5-13-16 Shimizu, Asahi-ku
+				Osaka    535-0021
+				JP
+
+00-1A-24   (hex)		Galaxy Telecom Technologies Ltd
+001A24     (base 16)		Galaxy Telecom Technologies Ltd
+				No.25, The 1st Gaoxin Road
+				Xi'an City  Shannxi  710075
+				CN
+
+00-1A-20   (hex)		CMOTECH Co. Ltd.
+001A20     (base 16)		CMOTECH Co. Ltd.
+				5F Etronix Bldg. 17-10
+				Youngdungpo-Gu  Seoul  150-874
+				KR
+
+00-1A-4E   (hex)		NTI AG / LinMot
+001A4E     (base 16)		NTI AG / LinMot
+				Haerdlistrasse 15
+				Spreitenbach  AG  8957
+				CH
+
+00-1A-52   (hex)		Meshlinx Wireless Inc.
+001A52     (base 16)		Meshlinx Wireless Inc.
+				1410 G Avenue, Suite T
+				Plano  Texas  75074
+				US
+
+00-1A-13   (hex)		Wanlida Group Co., LTD
+001A13     (base 16)		Wanlida Group Co., LTD
+				Jiahe Road No.618
+				Xiamen  Fujian  361006
+				CN
+
+00-1A-0F   (hex)		Sistemas Avanzados de Control, S.A.
+001A0F     (base 16)		Sistemas Avanzados de Control, S.A.
+				calle Colquide 6
+				Las Rozas  Madrid  28230
+				ES
+
+00-1A-43   (hex)		Logical Link Communications
+001A43     (base 16)		Logical Link Communications
+				1909 Central Drive Suite 205
+				Bedford  TX  76021
+				US
+
+00-1A-47   (hex)		Agami Systems, Inc.
+001A47     (base 16)		Agami Systems, Inc.
+				1269 Innsbruck Drive
+				Sunnyvale  California  94089
+				US
+
+00-1A-2D   (hex)		The Navvo Group
+001A2D     (base 16)		The Navvo Group
+				4400 Baker Road
+				Minnetonka  MN  55343
+				US
+
+00-1A-2F   (hex)		Cisco Systems, Inc
+001A2F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-A9   (hex)		Cisco Systems, Inc
+0019A9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-AE   (hex)		Hopling Technologies b.v.
+0019AE     (base 16)		Hopling Technologies b.v.
+				Camerastraat 10
+				Almere  Flevoland  1322 BC
+				NL
+
+00-19-AF   (hex)		Rigol Technologies, Inc.
+0019AF     (base 16)		Rigol Technologies, Inc.
+				No. 156 Cai He Village, Sha He Town
+				Beijing    102206
+				CN
+
+00-19-DE   (hex)		MOBITEK
+0019DE     (base 16)		MOBITEK
+				5F,No.60,Lane 321,Yang-Kwang Street
+				Taipei    114
+				US
+
+00-19-E5   (hex)		Lynx Studio Technology, Inc.
+0019E5     (base 16)		Lynx Studio Technology, Inc.
+				1540 Barton Rd # 268
+				Redlands  CA  92373
+				US
+
+00-19-DB   (hex)		MICRO-STAR INTERNATIONAL CO., LTD.
+0019DB     (base 16)		MICRO-STAR INTERNATIONAL CO., LTD.
+				NO. 69, LI-DE ST.
+				JUNG-HE CITY  TAIPEI HSIEN  235
+				TW
+
+00-1A-03   (hex)		Angel Electronics Co., Ltd.
+001A03     (base 16)		Angel Electronics Co., Ltd.
+				17, Lane 134, Shou Shan Road, Tai Shan,
+				Taipei    243
+				TW
+
+00-19-F9   (hex)		TDK-Lambda
+0019F9     (base 16)		TDK-Lambda
+				405 Essex Road
+				Neptune  NJ  07753
+				US
+
+00-19-CE   (hex)		Progressive Gaming International
+0019CE     (base 16)		Progressive Gaming International
+				920 Pilot Road
+				Las Vegas  NV  89119
+				US
+
+00-19-BD   (hex)		New Media Life
+0019BD     (base 16)		New Media Life
+				Hea Ju Bild, 5F, 837-7, Yeoksam-dong
+				Kangnam-gu  Seoul  135-080
+				KR
+
+00-19-F2   (hex)		Teradyne K.K.
+0019F2     (base 16)		Teradyne K.K.
+				272-13, Heisei, Takaono
+				Kikuchi-gun  Kumamoto  869-1232
+				JP
+
+00-19-A7   (hex)		ITU-T
+0019A7     (base 16)		ITU-T
+				Place des Nations
+				Geneva 20    CH-1211
+				CH
+
+00-19-9F   (hex)		DKT A/S
+00199F     (base 16)		DKT A/S
+				Fanoevej 6
+				Kr. Saaby    DK-4060
+				DK
+
+00-19-8D   (hex)		Ocean Optics, Inc.
+00198D     (base 16)		Ocean Optics, Inc.
+				830 Douglas Ave
+				Dunedin  FL  34698
+				US
+
+00-19-82   (hex)		SmarDTV
+001982     (base 16)		SmarDTV
+				Route de Genève 22
+				Cheseaux    CH-1033 
+				CH
+
+00-19-85   (hex)		IT Watchdogs, Inc
+001985     (base 16)		IT Watchdogs, Inc
+				12885 Research, Suite 210B
+				Austin  TX  78750
+				US
+
+00-19-51   (hex)		NETCONS, s.r.o.
+001951     (base 16)		NETCONS, s.r.o.
+				Stara Vajnorska 37
+				Bratislava  Slovakia  831 04
+				SK
+
+00-19-57   (hex)		Saafnet Canada Inc.
+001957     (base 16)		Saafnet Canada Inc.
+				107-1089 East Kent Ave (N)
+				Vancouver  BC  V5X 4V9
+				CA
+
+00-19-58   (hex)		Bluetooth SIG, Inc.
+001958     (base 16)		Bluetooth SIG, Inc.
+				5209 Lake Washington Blvd NE
+				Kirkland  WA  98033
+				US
+
+00-19-56   (hex)		Cisco Systems, Inc
+001956     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-6B   (hex)		Danpex Corporation
+00196B     (base 16)		Danpex Corporation
+				2114 Ringwood Avenue
+				San Jose  California  95131
+				US
+
+00-19-3D   (hex)		GMC Guardian Mobility Corp.
+00193D     (base 16)		GMC Guardian Mobility Corp.
+				Suite 200
+				Ottawa  ON  K2E 7Y8
+				CA
+
+00-19-86   (hex)		Cheng Hongjian
+001986     (base 16)		Cheng Hongjian
+				Rm.2305B.Sege Plaza,Huaqiang North Rd.,
+				Shenzhen  Guangdong  518057
+				US
+
+00-19-9E   (hex)		Nifty
+00199E     (base 16)		Nifty
+				miwa4-2-22-105
+				  Nagano  3800803
+				JP
+
+00-19-6A   (hex)		MikroM GmbH
+00196A     (base 16)		MikroM GmbH
+				Dovestraße 1
+				Berlin    10587
+				DE
+
+00-18-FF   (hex)		PowerQuattro Co.
+0018FF     (base 16)		PowerQuattro Co.
+				János u. 175.
+				Budapest    H-1161
+				HU
+
+00-18-F4   (hex)		EO TECHNICS Co., Ltd.
+0018F4     (base 16)		EO TECHNICS Co., Ltd.
+				91, Dongpyeon-ro
+				Anyang  Kyeonggi-Do  431-803
+				KR
+
+00-18-FC   (hex)		Altec Electronic AG
+0018FC     (base 16)		Altec Electronic AG
+				Lenggenbachstrasse 3
+				Fahrweid  Zürich  CH-8951
+				CH
+
+00-18-F6   (hex)		Thomson Telecom Belgium
+0018F6     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-18-F5   (hex)		Shenzhen Streaming Video Technology Company Limited
+0018F5     (base 16)		Shenzhen Streaming Video Technology Company Limited
+				5/F, Block 3, Software Part No.1, Keji Middle 2 Road,
+				Shenzhen  GaungDong  518057
+				CN
+
+00-18-F9   (hex)		VVOND, Inc.
+0018F9     (base 16)		VVOND, Inc.
+				3000 Bridge Parkway
+				Redwood City  CA  94065
+				US
+
+00-19-3B   (hex)		LigoWave
+00193B     (base 16)		LigoWave
+				138 Mountain Brook Drive
+				Canton  GA  30115
+				US
+
+00-19-35   (hex)		DUERR DENTAL AG
+001935     (base 16)		DUERR DENTAL AG
+				Hoepfigheimer Strasse 17
+				Bietigheim-Bissingen  Baden-Wuerttemberg  74321
+				DE
+
+00-19-10   (hex)		Knick Elektronische Messgeraete GmbH & Co. KG
+001910     (base 16)		Knick Elektronische Messgeraete GmbH & Co. KG
+				Beuckestraße 22
+				Berlin    14163
+				DE
+
+00-19-13   (hex)		Chuang-Yi Network Equipment Co.Ltd.
+001913     (base 16)		Chuang-Yi Network Equipment Co.Ltd.
+				238 TianMuShan Rd., West Lake district
+				HangZhou  ZheJiang  310000
+				CN
+
+00-18-FA   (hex)		Yushin Precision Equipment Co.,Ltd.
+0018FA     (base 16)		Yushin Precision Equipment Co.,Ltd.
+				11-260 KOGAHONMACHI
+				KYOTO    612-8492 JAP
+				JP
+
+00-18-EA   (hex)		Alltec GmbH
+0018EA     (base 16)		Alltec GmbH
+				An der Trave 27-31
+				Selmsdorf  Mecklenburg-Vorpommern  23923
+				DE
+
+00-18-E8   (hex)		Hacetron Corporation
+0018E8     (base 16)		Hacetron Corporation
+				No. 542,
+				Yang-Mei,  Tao-Yuan,  326
+				TW
+
+00-19-14   (hex)		Winix Co., Ltd
+001914     (base 16)		Winix Co., Ltd
+				363 Angade Bldg., Yangjae-dong
+				Seoul    137-898
+				KR
+
+00-19-06   (hex)		Cisco Systems, Inc
+001906     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-01   (hex)		F1MEDIA
+001901     (base 16)		F1MEDIA
+				610, Keumkang Hightech ¥±, 138-1 Sangdaewon-Dong, Jungwon-Gu
+				Seongnam-Si  Gyeonggi-Do  462-707
+				KR
+
+00-19-31   (hex)		Balluff GmbH
+001931     (base 16)		Balluff GmbH
+				Schurwaldstraße 9
+				Neuhausen  BW  73765
+				DE
+
+00-18-E3   (hex)		Visualgate Systems, Inc.
+0018E3     (base 16)		Visualgate Systems, Inc.
+				64 Bakersfield Street
+				Toronto  Ontario  M3J 2W7
+				CA
+
+00-18-9F   (hex)		Lenntek Corporation
+00189F     (base 16)		Lenntek Corporation
+				4F, 125 GuangMing 3rd. Road
+				Jhu Bei  Hsin Chu  302
+				TW
+
+00-18-99   (hex)		ShenZhen jieshun Science&Technology Industry CO,LTD.
+001899     (base 16)		ShenZhen jieshun Science&Technology Industry CO,LTD.
+				China GuangDong state Shenzhen City Futian section NO17. Meilin Road
+				Shenzhen  GuangDong  518049
+				CN
+
+00-18-6D   (hex)		Zhenjiang Sapphire Electronic Industry CO.
+00186D     (base 16)		Zhenjiang Sapphire Electronic Industry CO.
+				Wei San Road,Dingmao Develop Area
+				zhenjiang  jiangsu  212009
+				CN
+
+00-18-6F   (hex)		Setha Industria Eletronica LTDA
+00186F     (base 16)		Setha Industria Eletronica LTDA
+				Rua Alvaro de Macedo 134
+				Rio de Janeiro  RJ  21.250-620
+				BR
+
+00-18-75   (hex)		AnaCise Testnology Pte Ltd
+001875     (base 16)		AnaCise Testnology Pte Ltd
+				3 Bishan Place #02-06
+				    579838
+				SG
+
+00-18-C1   (hex)		Almitec Informática e Comércio
+0018C1     (base 16)		Almitec Informática e Comércio
+				461, Francisco de Morais St.
+				São Paulo    04714-010
+				BR
+
+00-18-C4   (hex)		Raba Technologies LLC
+0018C4     (base 16)		Raba Technologies LLC
+				8830 Stanford Blvd Suite 205
+				Columbia  Maryland  21045
+				US
+
+00-18-C9   (hex)		EOps Technology Limited
+0018C9     (base 16)		EOps Technology Limited
+				Room 2001, Fairmont House,
+				Hong Kong    
+				HK
+
+00-18-D8   (hex)		ARCH METER Corporation
+0018D8     (base 16)		ARCH METER Corporation
+				4F, No.3-2, Industry E. Rd.
+				Hsinchu    
+				TW
+
+00-18-D9   (hex)		Santosha Internatonal, Inc
+0018D9     (base 16)		Santosha Internatonal, Inc
+				3843 S. Bristol St. #242
+				Santa Ana  CA  92704
+				US
+
+00-18-CF   (hex)		Baldor Electric Company
+0018CF     (base 16)		Baldor Electric Company
+				600 S. Zero St.
+				Fort Smith  AR  72901
+				US
+
+00-18-BC   (hex)		ZAO NVP Bolid
+0018BC     (base 16)		ZAO NVP Bolid
+				Pionerskaya str., 4
+				Korolyov  Moscow region  141070
+				RU
+
+00-18-B7   (hex)		D3 LED, LLC
+0018B7     (base 16)		D3 LED, LLC
+				380 Mountain Rd
+				Union City  NJ  07087
+				US
+
+00-18-95   (hex)		Hansun Technologies Inc.
+001895     (base 16)		Hansun Technologies Inc.
+				Room 301, Building 103, Wangjingkejiyuan, Chaoyang District
+				Beijing    100102
+				CN
+
+00-18-83   (hex)		FORMOSA21 INC.
+001883     (base 16)		FORMOSA21 INC.
+				8F-6, NO.351, CHUNG SHAN RD., SEC.2
+				TAIPEI    235
+				TW
+
+00-18-8E   (hex)		Ekahau, Inc.
+00188E     (base 16)		Ekahau, Inc.
+				Hiilikatu 3
+				HELSINKI  UUSIMAA  00180
+				FI
+
+00-18-14   (hex)		Mitutoyo Corporation
+001814     (base 16)		Mitutoyo Corporation
+				20-1, Sakado 1-chome, Takatsu-ku,
+				Kawasaki-shi    213-8533
+				JP
+
+00-18-17   (hex)		D. E. Shaw Research, LLC
+001817     (base 16)		D. E. Shaw Research, LLC
+				120 W. 45th St., 33rd Floor
+				New York  NY  10036
+				US
+
+00-18-11   (hex)		Neuros Technology International, LLC.
+001811     (base 16)		Neuros Technology International, LLC.
+				650 W Lake St
+				Chicago  IL  60661
+				US
+
+00-17-DE   (hex)		Advantage Six Ltd
+0017DE     (base 16)		Advantage Six Ltd
+				208 George St
+				OLDHAM  Lancs  OL2 8DR
+				GB
+
+00-17-D7   (hex)		ION Geophysical Corporation Inc.
+0017D7     (base 16)		ION Geophysical Corporation Inc.
+				850 Dorothy
+				Richardson  Texas  75081
+				US
+
+00-18-37   (hex)		Universal ABIT Co., Ltd.
+001837     (base 16)		Universal ABIT Co., Ltd.
+				7F, No. 323 Yangguang St.,
+				Neihu  Taipei  114
+				TW
+
+00-18-22   (hex)		CEC TELECOM CO.,LTD.
+001822     (base 16)		CEC TELECOM CO.,LTD.
+				10thFL.CEC Building,6 Zhongguancun South Street
+				Beijing    100086
+				CN
+
+00-18-20   (hex)		w5networks
+001820     (base 16)		w5networks
+				48389 Fremont Blvd
+				Fremont  CA  94538
+				US
+
+00-18-5D   (hex)		TAIGUEN TECHNOLOGY (SHEN-ZHEN) CO., LTD.
+00185D     (base 16)		TAIGUEN TECHNOLOGY (SHEN-ZHEN) CO., LTD.
+				No. 23, The Third Industrial Park of Xia Village,
+				Shenzhen City,  Guangdong,  815106
+				CN
+
+00-18-5E   (hex)		Nexterm Inc.
+00185E     (base 16)		Nexterm Inc.
+				1-12-3, Shibaura, Minato-ku,
+				Tokyo    105-0023
+				JP
+
+00-18-28   (hex)		e2v technologies (UK) ltd.
+001828     (base 16)		e2v technologies (UK) ltd.
+				106 Waterhouse Lane
+				Chelmsford  Essex  CM1 2QU
+				GB
+
+00-18-35   (hex)		Thoratec / ITC
+001835     (base 16)		Thoratec / ITC
+				2656 Patton Road
+				Roseville  MN  55113
+				US
+
+00-18-01   (hex)		Actiontec Electronics, Inc
+001801     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-17-F3   (hex)		Harris Corporation
+0017F3     (base 16)		Harris Corporation
+				1025 West NASA Blvd
+				Melbourne  FL  32919
+				US
+
+00-18-4A   (hex)		Catcher, Inc.
+00184A     (base 16)		Catcher, Inc.
+				5864 Owens Ave.
+				Carlsbad  CA  92008
+				US
+
+00-18-4B   (hex)		Las Vegas Gaming, Inc.
+00184B     (base 16)		Las Vegas Gaming, Inc.
+				4000 West Ali Baba Lane, Suite D
+				Las Vegas  Nevada  89118
+				US
+
+00-18-0E   (hex)		Avega Systems
+00180E     (base 16)		Avega Systems
+				59 Victoria Street
+				McMahons Point  NSW  2060
+				AU
+
+00-17-BC   (hex)		Touchtunes Music Corporation
+0017BC     (base 16)		Touchtunes Music Corporation
+				3 Place du Commerce
+				Montréal  Québec  H3E 1H7
+				CA
+
+00-17-C1   (hex)		CM Precision Technology LTD.
+0017C1     (base 16)		CM Precision Technology LTD.
+				2 Fl, No. 177, Chien-E Road, Chung-Ho City
+				Taipei Hsien    235
+				TW
+
+00-17-B2   (hex)		SK Telesys
+0017B2     (base 16)		SK Telesys
+				4F, Kyungdong bldg, 4-4, Sunae-Dong, Pundang-Gu
+				Sungnam-City  Kunggi-Do  463-825
+				KR
+
+00-17-B1   (hex)		ACIST Medical Systems, Inc.
+0017B1     (base 16)		ACIST Medical Systems, Inc.
+				7450 Flying Cloud Drive
+				Eden Prairie  MN  55344
+				US
+
+00-17-A3   (hex)		MIX s.r.l.
+0017A3     (base 16)		MIX s.r.l.
+				Via Caldera, 21
+				Milan    I-20153
+				IT
+
+00-17-A6   (hex)		YOSIN ELECTRONICS CO., LTD.
+0017A6     (base 16)		YOSIN ELECTRONICS CO., LTD.
+				6F-2, No.17, Lan 174,Shin-Ming Road
+				Taipei    114
+				TW
+
+00-17-9C   (hex)		DEPRAG SCHULZ GMBH u. CO.
+00179C     (base 16)		DEPRAG SCHULZ GMBH u. CO.
+				Kurfürstenringg 12.18
+				Amberg  Bayern  92224
+				DE
+
+00-17-96   (hex)		Rittmeyer AG
+001796     (base 16)		Rittmeyer AG
+				Inwilerriedstrasse 57
+				Baar  ZG  CH-6341
+				CH
+
+00-17-E1   (hex)		DACOS Technologies Co., Ltd.
+0017E1     (base 16)		DACOS Technologies Co., Ltd.
+				104 Daeryung-Technotown III 448
+				SEOUL  Keumcheon-Gu  153-772
+				KR
+
+00-17-E0   (hex)		Cisco Systems, Inc
+0017E0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-D2   (hex)		THINLINX PTY LTD
+0017D2     (base 16)		THINLINX PTY LTD
+				31 Carwoola Crescent
+				Mooloolaba  Queensland  4557
+				AU
+
+00-17-85   (hex)		Sparr Electronics Ltd
+001785     (base 16)		Sparr Electronics Ltd
+				Sparr Electronics Ltd
+				Bangalore  Karnataka  560054
+				IN
+
+00-17-75   (hex)		TTE Germany GmbH
+001775     (base 16)		TTE Germany GmbH
+				Hermann-Schwer-Straße 3
+				Villingen-Schwenningen  Baden-Württemberg  78048
+				DE
+
+00-17-B8   (hex)		NOVATRON CO., LTD.
+0017B8     (base 16)		NOVATRON CO., LTD.
+				#601 polaris bldg., 15-3 jeongja-dong, bundang-gu
+				Seong Nam  Gyeonggi Do  463-811
+				KR
+
+00-17-BB   (hex)		Syrinx Industrial Electronics
+0017BB     (base 16)		Syrinx Industrial Electronics
+				De Factorij 13
+				Zwaag  Noord Holland  1689 AK
+				NL
+
+00-17-7C   (hex)		Smartlink Network Systems Limited
+00177C     (base 16)		Smartlink Network Systems Limited
+				L-7, Verna Electronic city
+				Nagoa  Goa  403 722
+				IN
+
+00-17-81   (hex)		Greystone Data System, Inc.
+001781     (base 16)		Greystone Data System, Inc.
+				40800 Encycopedia Circle
+				Fremont  CA  94538
+				US
+
+00-17-8D   (hex)		Checkpoint Systems, Inc.
+00178D     (base 16)		Checkpoint Systems, Inc.
+				101 Wolf Drive
+				Thorofare  NJ  08086
+				US
+
+00-17-8E   (hex)		Gunnebo Cash Automation AB
+00178E     (base 16)		Gunnebo Cash Automation AB
+				Fabriksgatan 10
+				Göteborg    402 27
+				SE
+
+00-17-C7   (hex)		MARA Systems Consulting AB
+0017C7     (base 16)		MARA Systems Consulting AB
+				Instrumentvägen 45
+				Stockholm    126 53
+				SE
+
+00-17-5D   (hex)		Dongseo system.
+00175D     (base 16)		Dongseo system.
+				974-21 Mansu-dong Namdong-gu
+				Incheon  In-Cheon  405-865
+				KR
+
+00-17-50   (hex)		GSI Group, MicroE Systems
+001750     (base 16)		GSI Group, MicroE Systems
+				8 Erie Drive
+				Natick  MA  01760
+				US
+
+00-17-55   (hex)		GE Security
+001755     (base 16)		GE Security
+				12345 SW Leveton Drive
+				Tualatin  OR  97062
+				US
+
+00-17-1D   (hex)		DIGIT
+00171D     (base 16)		DIGIT
+				Via Pasteur , 1/3
+				S.Pietro Mosezzo  NOVARA  28060
+				IT
+
+00-17-18   (hex)		Vansco Electronics Oy
+001718     (base 16)		Vansco Electronics Oy
+				Tiilenlyojankatu 5
+				FORSSA    30101
+				FI
+
+00-17-19   (hex)		Audiocodes USA, Inc
+001719     (base 16)		Audiocodes USA, Inc
+				27 World's Fair Drive
+				Somerset  NJ  08873
+				US
+
+00-17-76   (hex)		Meso Scale Diagnostics, LLC
+001776     (base 16)		Meso Scale Diagnostics, LLC
+				9238 Gaither Rd.
+				Gaithersburg  MD  20877
+				US
+
+00-17-79   (hex)		QuickTel
+001779     (base 16)		QuickTel
+				Cornishe El-Nile, Maasara
+				Cairo    11743
+				EG
+
+00-17-67   (hex)		Earforce AS
+001767     (base 16)		Earforce AS
+				P.O.Box 4
+				Bryne    4349
+				NO
+
+00-17-39   (hex)		Bright Headphone Electronics Company
+001739     (base 16)		Bright Headphone Electronics Company
+				8F, 109, Li De Street
+				Chung Ho City  Taipei County  235
+				TW
+
+00-17-2C   (hex)		TAEJIN INFOTECH
+00172C     (base 16)		TAEJIN INFOTECH
+				6F Woolim e-Biz Center, 170-5
+				Seoul    152-769
+				KR
+
+00-17-51   (hex)		Online Corporation
+001751     (base 16)		Online Corporation
+				22F-3, No. 398, Huan Pei Road,
+				Chung Li  Taoyuan  320
+				TW
+
+00-17-4C   (hex)		Millipore
+00174C     (base 16)		Millipore
+				1, rue Jacques Monod
+				Guyancourt    78280
+				FR
+
+00-17-11   (hex)		GE Healthcare Bio-Sciences AB
+001711     (base 16)		GE Healthcare Bio-Sciences AB
+				Björkgatan 30
+				Uppsala  SE  75184
+				SE
+
+00-17-45   (hex)		INNOTZ CO., Ltd
+001745     (base 16)		INNOTZ CO., Ltd
+				14F, Prime Center 546-4 Guui-Dong Kwanggin-Gu
+				Seoul  Seoul  
+				KR
+
+00-17-48   (hex)		Neokoros Brasil Ltda
+001748     (base 16)		Neokoros Brasil Ltda
+				Rua 86, numero 501, Setor Sul
+				Goiania  Goias  74083-330
+				BR
+
+00-17-63   (hex)		Essentia S.p.A.
+001763     (base 16)		Essentia S.p.A.
+				Via G.B. Vico, 29
+				Cella (RE)  Reggio Emilia  42040
+				IT
+
+00-17-01   (hex)		KDE, Inc.
+001701     (base 16)		KDE, Inc.
+				KDE TOWN, 42-7, Mangwol-dong
+				Hanam  Gyeonggi-do  465-150
+				KR
+
+00-16-F6   (hex)		Video Products Group
+0016F6     (base 16)		Video Products Group
+				1600 Emerson Avenue
+				Oxnard  California  93033
+				US
+
+00-16-EE   (hex)		Royaldigital Inc.
+0016EE     (base 16)		Royaldigital Inc.
+				8F., No.308, Sec.1, Neihu Rd.
+				Taipei City    114
+				TW
+
+00-16-DE   (hex)		FAST Inc
+0016DE     (base 16)		FAST Inc
+				905 Honeyspot Rd
+				Stratford  CT  06615
+				US
+
+00-16-DA   (hex)		Futronic Technology Co. Ltd.
+0016DA     (base 16)		Futronic Technology Co. Ltd.
+				Room 1016A, 10/F., Profit Ind. Bldg.,
+				Kwai Chung    00000
+				HK
+
+00-16-D4   (hex)		Compal Communications, Inc.
+0016D4     (base 16)		Compal Communications, Inc.
+				7th, FL, No. 319, Sec. 4, Pa-Teh rd.
+				Taipei    886
+				TW
+
+00-16-D7   (hex)		Sunways AG
+0016D7     (base 16)		Sunways AG
+				Macairestraße 3-5
+				Konstanz  Baden-Württemberg  78467
+				DE
+
+00-16-FF   (hex)		Wamin Optocomm Mfg Corp
+0016FF     (base 16)		Wamin Optocomm Mfg Corp
+				No. 239 Qiaohe Road
+				Zhonghe City  Taipei County  235
+				TW
+
+00-16-D1   (hex)		ZAT a.s.
+0016D1     (base 16)		ZAT a.s.
+				K Podlesi 541
+				Pribram VI    26180
+				CZ
+
+00-16-C5   (hex)		Shenzhen Xing Feng Industry Co.,Ltd
+0016C5     (base 16)		Shenzhen Xing Feng Industry Co.,Ltd
+				Floor 1 - 4, Block 25, Hongtian Jinyuan Industrial,
+				Shenzhen  GuangDong  86
+				CN
+
+00-16-CC   (hex)		Xcute Mobile Corp.
+0016CC     (base 16)		Xcute Mobile Corp.
+				3F. No.25, Ally15, Lane 120, Sec.1, Neihu Rd.
+				Taipei    114
+				TW
+
+00-17-17   (hex)		Leica Geosystems AG
+001717     (base 16)		Leica Geosystems AG
+				Heinrich Wild Strasse
+				Heerbrugg  St. Gallen  CH-9435
+				CH
+
+00-17-15   (hex)		Qstik
+001715     (base 16)		Qstik
+				Cartel Business Estate
+				Harlow  Essex  CM20 2TT
+				GB
+
+00-17-0E   (hex)		Cisco Systems, Inc
+00170E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-05   (hex)		Methode Electronics
+001705     (base 16)		Methode Electronics
+				7401 W. Wilson
+				Chicago  IL  60706
+				US
+
+00-16-AA   (hex)		Kei Communication Technology Inc.
+0016AA     (base 16)		Kei Communication Technology Inc.
+				8-BAN CHUOU
+				KOBE  HYOGO  650-0024
+				JP
+
+00-16-A8   (hex)		CWT CO., LTD.
+0016A8     (base 16)		CWT CO., LTD.
+				10F No. 74 Sec. 1 Chung-Hua Rd.
+				Taipei    108
+				TW
+
+00-16-A6   (hex)		Dovado FZ-LLC
+0016A6     (base 16)		Dovado FZ-LLC
+				Al-Thuraya Tower 1, office 504
+				Dubai    
+				AE
+
+00-16-ED   (hex)		Utility, Inc
+0016ED     (base 16)		Utility, Inc
+				250 E Ponce de Leon Ave Suite 700
+				Decatur  GA  30030
+				US
+
+00-16-C7   (hex)		Cisco Systems, Inc
+0016C7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-16-71   (hex)		Symphox Information Co.
+001671     (base 16)		Symphox Information Co.
+				15F, No. 51, Sec. 3, Minsheng E. Road
+				Taipei City    104
+				TW
+
+00-16-69   (hex)		MRV Communication (Networks) LTD
+001669     (base 16)		MRV Communication (Networks) LTD
+				P.O Box 614
+				Yokneam    20692
+				US
+
+00-16-68   (hex)		Eishin Electronics
+001668     (base 16)		Eishin Electronics
+				Nishiku Miyashita 1-19
+				Kobe City  Hyogo Prefecture  651-2146
+				JP
+
+00-16-40   (hex)		Asmobile Communication Inc.
+001640     (base 16)		Asmobile Communication Inc.
+				No.11 Lane 120, Li-Te Rd., Peitou 112, Taipei, Taiwan, R.O.C
+				Taipei    112
+				TW
+
+00-16-3C   (hex)		Rebox B.V.
+00163C     (base 16)		Rebox B.V.
+				Hendrik Figeeweg 1X
+				Haarlem  Noord-Holland  2031 BJ
+				NL
+
+00-16-7D   (hex)		Sky-Line Information Co., Ltd.
+00167D     (base 16)		Sky-Line Information Co., Ltd.
+				8F.,No.38,Sihyuan Rd.,
+				Sinihuang  Taipei  242
+				TW
+
+00-16-77   (hex)		Bihl + Wiedemann GmbH
+001677     (base 16)		Bihl + Wiedemann GmbH
+				Flosswoerthstr 41
+				Mannheim    68199
+				DE
+
+00-16-55   (hex)		FUHO TECHNOLOGY Co., LTD
+001655     (base 16)		FUHO TECHNOLOGY Co., LTD
+				No. 30, Lane 726, Jinma Rd, Sec. 3
+				Chang Hua    500
+				TW
+
+00-16-46   (hex)		Cisco Systems, Inc
+001646     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-16-48   (hex)		SSD Company Limited
+001648     (base 16)		SSD Company Limited
+				3-3-4 Higashiyagura
+				Kusatsu-city  Shiga  525-0054
+				JP
+
+00-16-72   (hex)		Zenway enterprise ltd
+001672     (base 16)		Zenway enterprise ltd
+				6F., No.20, Lane 150, Jhongsing Rd., Sijhih City
+				Taipei    886
+				TW
+
+00-16-5A   (hex)		Harman Specialty Group
+00165A     (base 16)		Harman Specialty Group
+				3 Oak Park Drive
+				Bedford  MA  01730
+				US
+
+00-16-59   (hex)		Z.M.P. RADWAG
+001659     (base 16)		Z.M.P. RADWAG
+				Bracka 28 street
+				RADOM  Mazowieckie  26-600
+				PL
+
+00-16-A2   (hex)		CentraLite Systems, Inc.
+0016A2     (base 16)		CentraLite Systems, Inc.
+				6420 Wall Street
+				Mobile  AL  36695
+				US
+
+00-16-95   (hex)		AVC Technology (International) Limited
+001695     (base 16)		AVC Technology (International) Limited
+				6/F Enterprise Square III
+				Kowloon Bay    
+				HK
+
+00-15-D8   (hex)		Interlink Electronics
+0015D8     (base 16)		Interlink Electronics
+				546 Flynn Road
+				Camarillo  CA  93012
+				US
+
+00-15-D4   (hex)		Emitor AB
+0015D4     (base 16)		Emitor AB
+				Sjöviksbacken 14
+				Stockholm    117 43
+				SE
+
+00-15-D5   (hex)		NICEVT
+0015D5     (base 16)		NICEVT
+				Warshawskoe shosse 125
+				Moscow    117405
+				RU
+
+00-16-0C   (hex)		LPL  DEVELOPMENT S.A. DE C.V
+00160C     (base 16)		LPL  DEVELOPMENT S.A. DE C.V
+				LAGO GINEBRA 380 P3
+				  D.F.  11480
+				MX
+
+00-16-12   (hex)		Otsuka Electronics Co., Ltd.
+001612     (base 16)		Otsuka Electronics Co., Ltd.
+				1-10 Sasagaoka, Minakuchi
+				kouka  shiga  528-0061
+				US
+
+00-16-0B   (hex)		TVWorks LLC
+00160B     (base 16)		TVWorks LLC
+				Two Belvedere Place, #200
+				Mill Valley  CA  94941
+				US
+
+00-16-03   (hex)		COOLKSKY Co., LTD
+001603     (base 16)		COOLKSKY Co., LTD
+				Shingsung offcetel A511, 1588-1 Secho
+				  Seoul  137-070
+				KR
+
+00-15-EA   (hex)		Tellumat (Pty) Ltd
+0015EA     (base 16)		Tellumat (Pty) Ltd
+				64/74 White Road
+				Cape Town  Western Province  7945
+				ZA
+
+00-15-E2   (hex)		Dr.Ing. Herbert Knauer GmbH
+0015E2     (base 16)		Dr.Ing. Herbert Knauer GmbH
+				Hegauer Weg 38
+				Berlin    14163
+				DE
+
+00-15-E1   (hex)		Picochip Ltd
+0015E1     (base 16)		Picochip Ltd
+				Upper Borough Court
+				Bath    BA1 1RG
+				GB
+
+00-15-DF   (hex)		Clivet S.p.A.
+0015DF     (base 16)		Clivet S.p.A.
+				via Camp Lonc 25
+				Feltre  Belluno  32030
+				IT
+
+00-16-1D   (hex)		Innovative Wireless Technologies, Inc.
+00161D     (base 16)		Innovative Wireless Technologies, Inc.
+				1047 Vista Park Dr.
+				Forest  VA  24551
+				US
+
+00-16-11   (hex)		Altecon Srl
+001611     (base 16)		Altecon Srl
+				Via F.lli Cairoli, 17
+				Lissone  Milano  20035
+				IT
+
+00-16-09   (hex)		Unitech electronics co., ltd.
+001609     (base 16)		Unitech electronics co., ltd.
+				5F,No.136,Lane 235 ,Pao-chiao Rd.,
+				Hsin-Tien city  Taipei Hsien  231
+				TW
+
+00-15-F5   (hex)		Sustainable Energy Systems
+0015F5     (base 16)		Sustainable Energy Systems
+				#500, 609 14th Street NW
+				Calgary  Ab  T2T 1P3
+				CA
+
+00-15-F1   (hex)		KYLINK Communications Corp.
+0015F1     (base 16)		KYLINK Communications Corp.
+				8F-8, No. 351, Sec. 2, Zhongshan Rd., Zhonghe City
+				    23504
+				TW
+
+00-16-23   (hex)		Interval Media
+001623     (base 16)		Interval Media
+				3200 Ash Street
+				Palo Alto  CA  94306
+				US
+
+00-16-19   (hex)		Lancelan Technologies S.L.
+001619     (base 16)		Lancelan Technologies S.L.
+				C/Angel Guimera 208 bis
+				Terrassa  Barcelona  08223
+				ES
+
+00-16-25   (hex)		Impinj, Inc.
+001625     (base 16)		Impinj, Inc.
+				400 Fairview Ave N, Suite 1200
+				Seattle  WA  98109
+				US
+
+00-15-86   (hex)		Xiamen Overseas Chinese Electronic Co., Ltd.
+001586     (base 16)		Xiamen Overseas Chinese Electronic Co., Ltd.
+				No. 22, Huli Street,
+				Xiamen  Fujian  361006
+				CN
+
+00-15-7E   (hex)		Weidmüller Interface GmbH & Co. KG
+00157E     (base 16)		Weidmüller Interface GmbH & Co. KG
+				Klingenbergstraße 16
+				Detmold    32758
+				DE
+
+00-15-80   (hex)		U-WAY CORPORATION
+001580     (base 16)		U-WAY CORPORATION
+				3F-2, NO. 125, LANE 235, PAO-CHIAO
+				HSINTIEN CITY  TAIPEI HSIEN  231
+				TW
+
+00-15-7C   (hex)		Dave Networks, Inc.
+00157C     (base 16)		Dave Networks, Inc.
+				2151 O'tool Avenue
+				San Jose  CA  95131
+				US
+
+00-15-7F   (hex)		ChuanG International Holding CO.,LTD.
+00157F     (base 16)		ChuanG International Holding CO.,LTD.
+				1F, NO.12, Alley 1, Lane 125, Guolian Street 4Lirn, Wuhan Village
+				Taoyuan  Longtan  325
+				US
+
+00-15-B3   (hex)		Caretech AB
+0015B3     (base 16)		Caretech AB
+				Nyborgsvägen 197
+				Kalix    95291
+				SE
+
+00-15-AA   (hex)		Rextechnik International Co.,
+0015AA     (base 16)		Rextechnik International Co.,
+				Room 5-3, No.51, Section 2, Keelung Road
+				Taipei    110
+				TW
+
+00-15-A6   (hex)		Digital Electronics Products Ltd.
+0015A6     (base 16)		Digital Electronics Products Ltd.
+				Room 301, 3 rd Floor, Tsun Yip Centre
+				Kwun Tong    852
+				HK
+
+00-15-9D   (hex)		Tripp Lite 
+00159D     (base 16)		Tripp Lite 
+				1111 W 35th Street
+				Chicago  IL  60609
+				US
+
+00-15-D6   (hex)		OSLiNK Sp. z o.o.
+0015D6     (base 16)		OSLiNK Sp. z o.o.
+				ul. Marsa 27
+				Gdansk    80299
+				PL
+
+00-15-92   (hex)		Facom UK Ltd (Melksham)
+001592     (base 16)		Facom UK Ltd (Melksham)
+				Lancaster House
+				Melksham  Wiltshire  SN104FB
+				US
+
+00-15-8B   (hex)		Park Air Systems Ltd
+00158B     (base 16)		Park Air Systems Ltd
+				Northfields
+				Peterborough    PE6 8UE
+				GB
+
+00-15-76   (hex)		LABiTec - Labor Biomedical Technologies GmbH
+001576     (base 16)		LABiTec - Labor Biomedical Technologies GmbH
+				An der Strusbek 6
+				    
+				DE
+
+00-15-BE   (hex)		Iqua Ltd.
+0015BE     (base 16)		Iqua Ltd.
+				Hyvoninkatu 1
+				Salo  Varsinais-Suomi  24240
+				US
+
+00-15-C7   (hex)		Cisco Systems, Inc
+0015C7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-5E   (hex)		Morgan Stanley
+00155E     (base 16)		Morgan Stanley
+				750 7th Avenue
+				New York  NY  10019
+				US
+
+00-15-0B   (hex)		SAGE INFOTECH LTD.
+00150B     (base 16)		SAGE INFOTECH LTD.
+				3F, No30, INDUSTRY E. 9TH RD.,SCIENCE-BASED
+				HSIN-CHU  TAIWAN  300
+				TW
+
+00-15-07   (hex)		Renaissance Learning Inc
+001507     (base 16)		Renaissance Learning Inc
+				2911 Peach Street
+				Wisconsin Rapids  Wisconsin  54494
+				US
+
+00-15-08   (hex)		Global Target Enterprise Inc
+001508     (base 16)		Global Target Enterprise Inc
+				5F, No. 186, Sec. 2, Chung-Hsing Rd.,
+				Hsin Tien,  Taipei county  231
+				TW
+
+00-15-02   (hex)		BETA tech
+001502     (base 16)		BETA tech
+				15 rue d'apollo
+				L'UNION    31240
+				FR
+
+00-14-FD   (hex)		Thecus Technology Corp.
+0014FD     (base 16)		Thecus Technology Corp.
+				15F.,No. 79,Sec. 1,Sintai 5th RD.,
+				Sijhih City  Taipei County  221
+				TW
+
+00-14-FC   (hex)		Extandon, Inc.
+0014FC     (base 16)		Extandon, Inc.
+				39350 Civic Center Drive Ste. 160
+				Fremont  CA  94538
+				US
+
+00-14-F8   (hex)		Scientific Atlanta
+0014F8     (base 16)		Scientific Atlanta
+				5030 Sugarloaf Parkway
+				Lawrenceville  Ga  30042
+				US
+
+00-14-F7   (hex)		CREVIS Co., LTD
+0014F7     (base 16)		CREVIS Co., LTD
+				157-1, Hagal-Dong
+				Youngin  Kyungki  446930
+				KR
+
+00-15-15   (hex)		Leipold+Co.GmbH
+001515     (base 16)		Leipold+Co.GmbH
+				Kreuzwiese 12
+				Rockenhausen  RLP  D-67806
+				DE
+
+00-15-0F   (hex)		mingjong
+00150F     (base 16)		mingjong
+				8F,NO.1,LANE 16,SZE CHUAN ROAD,SEC.2,PANCHIAO CITY.
+				TAIPEI    220
+				TW
+
+00-15-5C   (hex)		Dresser Wayne
+00155C     (base 16)		Dresser Wayne
+				3814 Jarrett Way
+				Austin  Texas  78728
+				US
+
+00-15-59   (hex)		Securaplane Technologies, Inc.
+001559     (base 16)		Securaplane Technologies, Inc.
+				10800 N. Mavinee Dr.
+				Tucson  AZ  85737
+				US
+
+00-15-57   (hex)		Olivetti
+001557     (base 16)		Olivetti
+				Via Jervis 77
+				Ivrea  Torino  10015
+				IT
+
+00-15-54   (hex)		Atalum Wireless S.A.
+001554     (base 16)		Atalum Wireless S.A.
+				C/ Orellana 5, 1º I
+				Madrid    28004
+				ES
+
+00-15-3B   (hex)		EMH metering GmbH & Co. KG
+00153B     (base 16)		EMH metering GmbH & Co. KG
+				Neu- Galliner Weg 1
+				  Mecklenburg-Vorpommern  
+				DE
+
+00-15-37   (hex)		Ventus Networks
+001537     (base 16)		Ventus Networks
+				800 Connecticut Ave
+				Norwalk  CT  06854
+				US
+
+00-15-33   (hex)		NADAM.CO.,LTD
+001533     (base 16)		NADAM.CO.,LTD
+				#91-3 Wangrim-Li
+				Hwaseong  Gyeonggi  445-895
+				KR
+
+00-15-34   (hex)		A Beltrónica-Companhia de Comunicações, Lda
+001534     (base 16)		A Beltrónica-Companhia de Comunicações, Lda
+				Rua Dr. José Baptista de Sousa, 27
+				Lisbon    1549-002 Lis
+				PT
+
+00-15-3F   (hex)		Alcatel Alenia Space Italia
+00153F     (base 16)		Alcatel Alenia Space Italia
+				Strada Padana Superiore 290
+				Vimodrone  MI  20090
+				IT
+
+00-15-18   (hex)		Shenzhen 10MOONS Technology Development CO.,Ltd
+001518     (base 16)		Shenzhen 10MOONS Technology Development CO.,Ltd
+				Add:3F,Huaxing building, QiaoXiang road,
+				shenzhen  guangdong  518053
+				CN
+
+00-15-26   (hex)		Remote Technologies Inc
+001526     (base 16)		Remote Technologies Inc
+				 5775 12th Ave E, Suite 180
+				Shakopee  MN  55379
+				US
+
+00-14-F1   (hex)		Cisco Systems, Inc
+0014F1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-EA   (hex)		S Digm Inc. (Safe Paradigm Inc.)
+0014EA     (base 16)		S Digm Inc. (Safe Paradigm Inc.)
+				5F, Shin-an Bldg. 89-8,
+				Songpa-Gu  Seoul  138-201
+				KR
+
+00-14-E5   (hex)		Alticast
+0014E5     (base 16)		Alticast
+				16th floor, Nara Bldg, 1328-3
+				  Seoul  137-070
+				KR
+
+00-14-9F   (hex)		System and Chips, Inc.
+00149F     (base 16)		System and Chips, Inc.
+				4F,No. 1, Lane 50, NanKang Road, Section 3,
+				Taipei    115
+				TW
+
+00-14-B3   (hex)		CoreStar International Corp
+0014B3     (base 16)		CoreStar International Corp
+				1044 Sandy Hill Rd
+				Irwin  PA  15642
+				US
+
+00-14-B1   (hex)		Axell Wireless Limited
+0014B1     (base 16)		Axell Wireless Limited
+				Aerial HOuse
+				Chesham  Buckinghamshire  HP5 2QD
+				GB
+
+00-14-E0   (hex)		LET'S Corporation
+0014E0     (base 16)		LET'S Corporation
+				Bancho Bldg. 4F, 2-18-20 Marunouchi, Naka
+				Nagoya  Aichi  460-0002
+				JP
+
+00-14-E2   (hex)		datacom systems inc.
+0014E2     (base 16)		datacom systems inc.
+				9 adler drive
+				east syracuse  n.y.  13057
+				US
+
+00-14-E4   (hex)		infinias, LLC
+0014E4     (base 16)		infinias, LLC
+				857 West Carmel Drive
+				Carmel  IN  46032
+				US
+
+00-14-CC   (hex)		Zetec, Inc.
+0014CC     (base 16)		Zetec, Inc.
+				8226 Bracken Place SE
+				Snoqualmie  WA  98065
+				US
+
+00-14-CB   (hex)		LifeSync Corporation
+0014CB     (base 16)		LifeSync Corporation
+				1 E Broward Boulevard, Suite 1701
+				Fort Lauderdale  Florida  33301
+				US
+
+00-14-C6   (hex)		Quixant Ltd
+0014C6     (base 16)		Quixant Ltd
+				61A Mount Pleasant
+				England  Kent  TN16 3TP
+				GB
+
+00-14-98   (hex)		Viking Design Technology
+001498     (base 16)		Viking Design Technology
+				2F, No.2, Lane 42,
+				Taipei    111
+				TW
+
+00-14-96   (hex)		Phonic Corp.
+001496     (base 16)		Phonic Corp.
+				12thFl, 59 Tung Hsing Rd
+				Taipei    110
+				TW
+
+00-14-93   (hex)		Systimax Solutions
+001493     (base 16)		Systimax Solutions
+				1300 E Lookout Drive
+				Richardson  Texas  75082
+				US
+
+00-14-DB   (hex)		Elma Trenew Electronic GmbH
+0014DB     (base 16)		Elma Trenew Electronic GmbH
+				Stuttgarter Straße 11
+				Pforzheim    75179
+				DE
+
+00-14-3A   (hex)		RAYTALK INTERNATIONAL SRL
+00143A     (base 16)		RAYTALK INTERNATIONAL SRL
+				St. Marecchia 79
+				  Verucchio (RN)  47826
+				IT
+
+00-14-36   (hex)		Qwerty Elektronik AB
+001436     (base 16)		Qwerty Elektronik AB
+				Gryt 44
+				Ösmo    610 60
+				SE
+
+00-14-6B   (hex)		Anagran, Inc.
+00146B     (base 16)		Anagran, Inc.
+				580 North Pastoria Av
+				Sunnyvale  CA  94085
+				US
+
+00-14-61   (hex)		CORONA CORPORATION
+001461     (base 16)		CORONA CORPORATION
+				7-7, HIGASHI-SHINBO
+				SANJO-SHI  NIIGATA  955-8510
+				JP
+
+00-14-62   (hex)		Digiwell Technology, inc
+001462     (base 16)		Digiwell Technology, inc
+				4F, No.1, Prosperity 1st Road
+				  Hsinchu Science Park  300
+				TW
+
+00-14-63   (hex)		IDCS N.V.
+001463     (base 16)		IDCS N.V.
+				Hellebeemden 9
+				Hasselt  Limburg  3500
+				BE
+
+00-14-65   (hex)		Novo Nordisk A/S
+001465     (base 16)		Novo Nordisk A/S
+				Novo Alle
+				Bagsvaerd    2880
+				DK
+
+00-14-74   (hex)		K40 Electronics
+001474     (base 16)		K40 Electronics
+				600 Tollgate Rd. Unit A
+				Elgin  IL  60123
+				US
+
+00-14-6F   (hex)		Kohler Co
+00146F     (base 16)		Kohler Co
+				444 Highland Drive
+				Kohler  WI  53044
+				US
+
+00-14-66   (hex)		Kleinhenz Elektronik GmbH
+001466     (base 16)		Kleinhenz Elektronik GmbH
+				Greinerberg 14
+				Munich    81371
+				DE
+
+00-14-7F   (hex)		Thomson Telecom Belgium
+00147F     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-14-75   (hex)		Wiline Networks, Inc.
+001475     (base 16)		Wiline Networks, Inc.
+				741 Alexander Rd
+				Princeton  NJ  08540
+				US
+
+00-14-86   (hex)		Echo Digital Audio Corporation
+001486     (base 16)		Echo Digital Audio Corporation
+				402 E Carrillo St
+				Santa Barbara  CA  93101
+				US
+
+00-14-82   (hex)		Aurora Networks
+001482     (base 16)		Aurora Networks
+				5400 Betsy Ross Drive
+				Santa Clara  CA  95054
+				US
+
+00-14-55   (hex)		Coder Electronics Corporation
+001455     (base 16)		Coder Electronics Corporation
+				Takeda Bldg, 1-30-6 Shirasagi,
+				Nakano-ku  Tokyo  165-0035
+				JP
+
+00-14-4E   (hex)		SRISA
+00144E     (base 16)		SRISA
+				36/1, Nakhimovskiy pr-t
+				  Moscow  117218
+				RU
+
+00-14-8D   (hex)		Cubic Defense Simulation Systems
+00148D     (base 16)		Cubic Defense Simulation Systems
+				2001 W. Oakridge Road
+				Orlando  FL  32809
+				US
+
+00-14-3D   (hex)		Aevoe Inc.
+00143D     (base 16)		Aevoe Inc.
+				11F, No 23, Keelung Road
+				Taipei  HsinYi District  110
+				TW
+
+00-14-15   (hex)		Intec Automation inc.
+001415     (base 16)		Intec Automation inc.
+				2751 Arbutus Rd.
+				Victoria  British Columbia  V8N 5X7
+				CA
+
+00-14-10   (hex)		Suzhou Keda Technology CO.,Ltd
+001410     (base 16)		Suzhou Keda Technology CO.,Ltd
+				131,Jinshan Road
+				Suzhou  JiangSu  215011
+				CN
+
+00-14-17   (hex)		RSE Informations Technologie GmbH
+001417     (base 16)		RSE Informations Technologie GmbH
+				Silberbergstrasse 9
+				Wolfsberg  Kärnten  9400
+				AT
+
+00-14-33   (hex)		Empower Technologies(Canada) Inc.
+001433     (base 16)		Empower Technologies(Canada) Inc.
+				Unit 405 - 5600 Parkwood Way,
+				Richmond  British Columbia  V6V 2M2
+				CA
+
+00-14-34   (hex)		Keri Systems, Inc
+001434     (base 16)		Keri Systems, Inc
+				2305 Bering Dr
+				San Jose  CA  95131
+				US
+
+00-13-DE   (hex)		Adapt4, LLC
+0013DE     (base 16)		Adapt4, LLC
+				1050 W Nasa Blvd,
+				Melbourne  FL  32901
+				US
+
+00-13-DD   (hex)		Abbott Diagnostics
+0013DD     (base 16)		Abbott Diagnostics
+				5440 Patrick Henry Drive
+				Santa Clara  CA  95054
+				US
+
+00-13-D7   (hex)		SPIDCOM Technologies SA
+0013D7     (base 16)		SPIDCOM Technologies SA
+				137 avenue du General LECLERC
+				BOURG LA REINE    92340
+				FR
+
+00-13-C7   (hex)		IONOS Co.,Ltd.
+0013C7     (base 16)		IONOS Co.,Ltd.
+				1-36-18 Miyasaka
+				Setagaya-ku  Tokyo  156-0051
+				JP
+
+00-14-23   (hex)		J-S Co. NEUROCOM
+001423     (base 16)		J-S Co. NEUROCOM
+				Energeticheskii proezd, 6
+				Moscow    111250
+				RU
+
+00-14-25   (hex)		Galactic Computing Corp.
+001425     (base 16)		Galactic Computing Corp.
+				1/F
+				Chai Wan District    
+				HK
+
+00-14-19   (hex)		SIDSA
+001419     (base 16)		SIDSA
+				PTM - TORRES QUEVEDO 1
+				TRES CANTOS  MADRID  28760
+				ES
+
+00-13-EE   (hex)		JBX Designs Inc.
+0013EE     (base 16)		JBX Designs Inc.
+				PO Box 970158
+				Boca Raton  FL  33497
+				US
+
+00-13-E5   (hex)		TENOSYS, INC.
+0013E5     (base 16)		TENOSYS, INC.
+				Seojin B/D, 1564-1, Seocho-dong,
+				  Seoul  137-070
+				KR
+
+00-13-E2   (hex)		GeoVision Inc.
+0013E2     (base 16)		GeoVision Inc.
+				9F.,No.246,Sec.1,
+				Taipei    114
+				TW
+
+00-14-02   (hex)		kk-electronic a/s
+001402     (base 16)		kk-electronic a/s
+				Cypresvej 6
+				Herning    7400
+				DK
+
+00-13-FF   (hex)		Dage-MTI of MC, Inc.
+0013FF     (base 16)		Dage-MTI of MC, Inc.
+				701 N. Roeske Ave.
+				Michigan City  IN  46360
+				US
+
+00-13-BC   (hex)		Artimi Ltd
+0013BC     (base 16)		Artimi Ltd
+				Betjeman House
+				Cambridge  Cambridgeshire  CB2 1LQ
+				GB
+
+00-14-08   (hex)		Eka Systems Inc.
+001408     (base 16)		Eka Systems Inc.
+				20251 Century Blvd
+				Germantown  MD  20874
+				US
+
+00-13-A7   (hex)		BATTELLE MEMORIAL INSTITUTE
+0013A7     (base 16)		BATTELLE MEMORIAL INSTITUTE
+				505 KING AVE
+				COLUMBUS  OHIO  43201
+				US
+
+00-13-A6   (hex)		Extricom Ltd
+0013A6     (base 16)		Extricom Ltd
+				Glil Yam
+				Herzlia    46905
+				IL
+
+00-13-A2   (hex)		MaxStream, Inc
+0013A2     (base 16)		MaxStream, Inc
+				355 South 520 West Suite 180
+				Lindon  Ut  84042
+				US
+
+00-13-9F   (hex)		Electronics Design Services, Co., Ltd.
+00139F     (base 16)		Electronics Design Services, Co., Ltd.
+				5-10-20 Tokumaru
+				Itabashi-ku  Tokyo  175-0083
+				JP
+
+00-13-A0   (hex)		ALGOSYSTEM Co., Ltd.
+0013A0     (base 16)		ALGOSYSTEM Co., Ltd.
+				656 kobirao mihara-cho
+				sakai  osaka  587-0021
+				JP
+
+00-13-98   (hex)		TrafficSim Co.,Ltd
+001398     (base 16)		TrafficSim Co.,Ltd
+				23-9 Mita-biru 2F, Chiyoda 3-chome
+				Aichi  Non  460-0012
+				JP
+
+00-13-9B   (hex)		ioIMAGE Ltd.
+00139B     (base 16)		ioIMAGE Ltd.
+				3 Maskit Street
+				Herzliya Pituach  IL  46733
+				IL
+
+00-13-96   (hex)		Acbel Polytech Inc.
+001396     (base 16)		Acbel Polytech Inc.
+				No.159,Sec.3, Tam-King Rd.,
+				Tamsui  Taipei  251
+				TW
+
+00-13-93   (hex)		Panta Systems, Inc.
+001393     (base 16)		Panta Systems, Inc.
+				20450 Stevens Creek Blvd.
+				Cupertino  California  95014
+				US
+
+00-13-8B   (hex)		Phantom Technologies LLC
+00138B     (base 16)		Phantom Technologies LLC
+				7825 Fay Avenue, Suite 200
+				La Jolla  CA  92037
+				US
+
+00-13-88   (hex)		WiMedia Alliance
+001388     (base 16)		WiMedia Alliance
+				2400 Camino Ramon
+				San Ramon  CA  94583
+				US
+
+00-13-6E   (hex)		Techmetro Corp.
+00136E     (base 16)		Techmetro Corp.
+				4F. Dongam B/D., 264-5, YangJae-Dong
+				Seoul    137-130
+				KR
+
+00-13-6D   (hex)		Tentaculus AB
+00136D     (base 16)		Tentaculus AB
+				Studiegangen 3
+				Ostersund  Jamtland  SE - 831 40
+				SE
+
+00-13-6A   (hex)		Hach Lange Sarl
+00136A     (base 16)		Hach Lange Sarl
+				6, route de Compois
+				VESENAZ  GENEVA  1222
+				CH
+
+00-13-B2   (hex)		Carallon Limited
+0013B2     (base 16)		Carallon Limited
+				Studio G20 Shepherds Building
+				  London  W14 0DA
+				GB
+
+00-13-AD   (hex)		Sendo Ltd
+0013AD     (base 16)		Sendo Ltd
+				Hatchford Brook
+				Birmingham  West Midlands  B26 3RZ
+				GB
+
+00-13-AA   (hex)		ALS  & TEC Ltd.
+0013AA     (base 16)		ALS  & TEC Ltd.
+				6 B. Kazachya str.
+				Saratov  Saratov region  410600
+				RU
+
+00-13-A4   (hex)		KeyEye Communications
+0013A4     (base 16)		KeyEye Communications
+				9785 Goethe
+				Sacramento  CA  95827
+				US
+
+00-13-4D   (hex)		Inepro BV
+00134D     (base 16)		Inepro BV
+				Pondweg 7
+				  Nieuw- Vennep  
+				NL
+
+00-13-4B   (hex)		ToGoldenNet Technology Inc.
+00134B     (base 16)		ToGoldenNet Technology Inc.
+				5F-1 No.25,Pu-ding.,
+				Hsin-Chu    300
+				TW
+
+00-13-84   (hex)		Advanced Motion Controls
+001384     (base 16)		Advanced Motion Controls
+				3805 Calle Tecate
+				Camarillo  California  93012
+				US
+
+00-13-7B   (hex)		Movon Corporation
+00137B     (base 16)		Movon Corporation
+				5th, Hyunjuk B/D
+				Seoul    135-092
+				KR
+
+00-13-53   (hex)		HYDAC Filtertechnik GMBH
+001353     (base 16)		HYDAC Filtertechnik GMBH
+				Industriegebiet
+				Sulzbach/Saar  Saarland  66280
+				DE
+
+00-13-63   (hex)		Verascape, Inc.
+001363     (base 16)		Verascape, Inc.
+				1101 31st St., Suite #190
+				Downers Grove  IL  60515
+				US
+
+00-13-03   (hex)		GateConnect
+001303     (base 16)		GateConnect
+				Eisenhutweg 69
+				12487 Berlin    12487
+				DE
+
+00-13-04   (hex)		Flaircomm Technologies Co. LTD
+001304     (base 16)		Flaircomm Technologies Co. LTD
+				2088 Huashan Road
+				Shanghai    200030
+				CN
+
+00-12-F9   (hex)		URYU SEISAKU, LTD.
+0012F9     (base 16)		URYU SEISAKU, LTD.
+				1-2-11
+				HIGASHINARI-KU  OSAKA  537-0002
+				JP
+
+00-12-F3   (hex)		connectBlue AB
+0012F3     (base 16)		connectBlue AB
+				Norra Vallgatan 64
+				Malmoe    SE-211 22
+				SE
+
+00-13-37   (hex)		Orient Power Home Network Ltd.
+001337     (base 16)		Orient Power Home Network Ltd.
+				307 Harbour Centre, Tower 1,
+				    
+				HK
+
+00-13-34   (hex)		Arkados, Inc.
+001334     (base 16)		Arkados, Inc.
+				948 US HWY 22
+				North Plainfield  NJ  07060
+				US
+
+00-13-32   (hex)		Beijing Topsec Network Security Technology Co., Ltd.
+001332     (base 16)		Beijing Topsec Network Security Technology Co., Ltd.
+				Huakong Tower
+				Haidian District  Beijing  100085
+				CN
+
+00-13-1F   (hex)		NxtPhase T&D, Corp.
+00131F     (base 16)		NxtPhase T&D, Corp.
+				3040 E. Broadway
+				Vancouver  BC  V5M 1Z4
+				CA
+
+00-12-DC   (hex)		SunCorp Industrial Limited
+0012DC     (base 16)		SunCorp Industrial Limited
+				No.68 Guowei Road,
+				Liantang Industrial District,  Shenzhen,  
+				CN
+
+00-12-FF   (hex)		Lely Industries N.V.
+0012FF     (base 16)		Lely Industries N.V.
+				Weverskade 110
+				Maassluis  Zuid-Holland  3147PA
+				NL
+
+00-13-3A   (hex)		VadaTech Inc.
+00133A     (base 16)		VadaTech Inc.
+				11540 S. Eastern Avenue
+				Henderson  Nevada  89052
+				US
+
+00-13-2A   (hex)		Sitronics Telecom Solutions
+00132A     (base 16)		Sitronics Telecom Solutions
+				Michelska 60
+				Prague  Prague 4 - Michle  140 00
+				CZ
+
+00-12-E5   (hex)		Time America, Inc.
+0012E5     (base 16)		Time America, Inc.
+				51 W. 3rd Street #310
+				Tempe  AZ  85281
+				US
+
+00-13-0E   (hex)		Focusrite Audio Engineering Limited
+00130E     (base 16)		Focusrite Audio Engineering Limited
+				19 Lincoln Road
+				High Wycombe  Bucks  HP12 3FX
+				GB
+
+00-13-09   (hex)		Ocean Broadband Networks
+001309     (base 16)		Ocean Broadband Networks
+				2078 Walsh Ave, Suite B
+				Santa Clara  California  95050
+				US
+
+00-13-19   (hex)		Cisco Systems, Inc
+001319     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-1C   (hex)		LiteTouch, Inc.
+00131C     (base 16)		LiteTouch, Inc.
+				3400 South West Temple
+				Salt Lake City  UT  84115
+				US
+
+00-13-4A   (hex)		Engim, Inc.
+00134A     (base 16)		Engim, Inc.
+				40 Nagog Park
+				Acton  MA  01720
+				US
+
+00-12-D7   (hex)		Invento Networks, Inc.
+0012D7     (base 16)		Invento Networks, Inc.
+				377 Simarano Drive
+				Marlborough  MA  01752
+				US
+
+00-12-C4   (hex)		Viseon, Inc.
+0012C4     (base 16)		Viseon, Inc.
+				8445 Freeport Parkway
+				Irving  Texas  75063
+				US
+
+00-12-93   (hex)		GE Energy
+001293     (base 16)		GE Energy
+				1501 Roanoke Blvd.
+				Salem  VA  24153
+				US
+
+00-12-94   (hex)		SUMITOMO ELECTRIC DEVICE INNOVATIONS, INC
+001294     (base 16)		SUMITOMO ELECTRIC DEVICE INNOVATIONS, INC
+				1000 Kamisukiawara,Showa-cho
+				Nakakoma-gun  Yamanashi  409-3883
+				JP
+
+00-12-96   (hex)		Addlogix
+001296     (base 16)		Addlogix
+				459 Wald
+				Irvine  CA  92618
+				US
+
+00-12-B3   (hex)		Advance Wireless Technology Corp.
+0012B3     (base 16)		Advance Wireless Technology Corp.
+				12F No. 27-6, Sec. 2, Chung Cheng East Road
+				Tamshui    251
+				TW
+
+00-12-B0   (hex)		Efore Oyj   (Plc)
+0012B0     (base 16)		Efore Oyj   (Plc)
+				Quartetto Business Park
+				Espoo    FI - 02600
+				FI
+
+00-12-7F   (hex)		Cisco Systems, Inc
+00127F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-A6   (hex)		Dolby Australia
+0012A6     (base 16)		Dolby Australia
+				Level 6
+				Surry Hills  NSW  2010
+				AU
+
+00-12-A4   (hex)		ThingMagic, LLC
+0012A4     (base 16)		ThingMagic, LLC
+				One Broadway
+				Cambridge  MA  02142
+				US
+
+00-12-A9   (hex)		3Com Ltd
+0012A9     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-12-D0   (hex)		Gossen-Metrawatt-GmbH
+0012D0     (base 16)		Gossen-Metrawatt-GmbH
+				Thomas-Mann-Straße 16-20
+				Nürnberg  Bavaria  90471
+				DE
+
+00-12-99   (hex)		Ktech Telecommunications Inc
+001299     (base 16)		Ktech Telecommunications Inc
+				21540 Prairie Street Unit B
+				Chatsworth  CA  91311
+				US
+
+00-12-8C   (hex)		Woodward Governor
+00128C     (base 16)		Woodward Governor
+				1000 E. Drake Road
+				Ft. Collins  CO  80525
+				US
+
+00-12-B8   (hex)		G2 Microsystems
+0012B8     (base 16)		G2 Microsystems
+				408 Euclid Ave
+				Oakland  CA  94610
+				US
+
+00-12-7B   (hex)		VIA Networking Technologies, Inc.
+00127B     (base 16)		VIA Networking Technologies, Inc.
+				8F,533, Chung-Cheng Road, Hsin-Tien
+				Taipei    231
+				TW
+
+00-12-80   (hex)		Cisco Systems, Inc
+001280     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-75   (hex)		Sentilla Corporation
+001275     (base 16)		Sentilla Corporation
+				201 Marshall Street
+				Redwood City  CA  94063
+				US
+
+00-12-76   (hex)		CG Power Systems Ireland Limited
+001276     (base 16)		CG Power Systems Ireland Limited
+				Herbert House., Harmony Row, 
+				Dublin    D2
+				IE
+
+00-12-71   (hex)		Measurement Computing Corp
+001271     (base 16)		Measurement Computing Corp
+				10 Commerce Way
+				Norton  MA  02766
+				US
+
+00-12-73   (hex)		Stoke Inc
+001273     (base 16)		Stoke Inc
+				2189 Leghorn Street
+				Mountain View  CA  94043
+				US
+
+00-12-69   (hex)		Value Electronics
+001269     (base 16)		Value Electronics
+				Dong-kwan B/D, 5F, 1566-2
+				seoul    137-874
+				KR
+
+00-12-50   (hex)		Tokyo Aircaft Instrument Co., Ltd.
+001250     (base 16)		Tokyo Aircaft Instrument Co., Ltd.
+				1-35-1, Izumi-Honcho
+				Komae-Shi  Tokyo  201-8555
+				JP
+
+00-12-52   (hex)		Citronix, LLC
+001252     (base 16)		Citronix, LLC
+				2214 South Watson Road
+				Arlington  Texas  76010
+				US
+
+00-12-40   (hex)		AMOI ELECTRONICS CO.,LTD
+001240     (base 16)		AMOI ELECTRONICS CO.,LTD
+				295 Lane,Zuchongzhi Road,Zhang jiang,
+				Shanghai    201203
+				CN
+
+00-12-2E   (hex)		Signal Technology - AISD
+00122E     (base 16)		Signal Technology - AISD
+				1820 Preston Park Blvd.
+				Plano  TX  75093
+				US
+
+00-12-64   (hex)		daum electronic gmbh
+001264     (base 16)		daum electronic gmbh
+				flugplatzstraße 100
+				Fürth  Bavaria  90768
+				DE
+
+00-12-61   (hex)		Adaptix, Inc
+001261     (base 16)		Adaptix, Inc
+				1407 116th Ave. NE
+				Bellevue  WA  98004
+				US
+
+00-12-60   (hex)		Stanton Magnetics,inc.
+001260     (base 16)		Stanton Magnetics,inc.
+				3000 SW 42nd Street
+				Hollywood  FL  33312
+				US
+
+00-12-31   (hex)		Motion Control Systems, Inc.
+001231     (base 16)		Motion Control Systems, Inc.
+				PO Box 115
+				New River  VA  24129
+				US
+
+00-12-4B   (hex)		Texas Instruments
+00124B     (base 16)		Texas Instruments
+				Gaustadalleen 21
+				Oslo    N-0349
+				NO
+
+00-12-4A   (hex)		Dedicated Devices, Inc.
+00124A     (base 16)		Dedicated Devices, Inc.
+				5680 E. Franklin Road
+				Nampa  Idaho  83687
+				US
+
+00-12-43   (hex)		Cisco Systems, Inc
+001243     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-D9   (hex)		TiVo
+0011D9     (base 16)		TiVo
+				2160 Gold Ave
+				Alviso  CA  95002-2160
+				US
+
+00-11-D2   (hex)		Perception Digital Ltd
+0011D2     (base 16)		Perception Digital Ltd
+				Flat A, 8/F, Shaw House
+				Clear Water Bay  NT  
+				HK
+
+00-11-CF   (hex)		Thrane & Thrane A/S
+0011CF     (base 16)		Thrane & Thrane A/S
+				Lundtoftegårdsvej 93D
+				Lyngby  København  2800
+				DK
+
+00-11-D4   (hex)		NetEnrich, Inc
+0011D4     (base 16)		NetEnrich, Inc
+				890 Hillview Ct.
+				Milpitas  CA  95035
+				US
+
+00-11-D5   (hex)		Hangzhou Sunyard System Engineering Co.,Ltd.
+0011D5     (base 16)		Hangzhou Sunyard System Engineering Co.,Ltd.
+				Sunyard Science & Technology Building Hi-Tech Software Park(Second Land Consolidation)
+				Hangzhou  Zhejiang  310053
+				CN
+
+00-11-F8   (hex)		AIRAYA Corp
+0011F8     (base 16)		AIRAYA Corp
+				637 Adair Court
+				Morgan Hill  CA  95037
+				US
+
+00-11-F4   (hex)		woori-net
+0011F4     (base 16)		woori-net
+				#508, Hankook Moolyu, 853-1 Dongchun-Dong
+				Yongin-Si  Kyungki-Do  449-843
+				KR
+
+00-11-F6   (hex)		Asia Pacific Microsystems , Inc.
+0011F6     (base 16)		Asia Pacific Microsystems , Inc.
+				No.2,R&D Road 6 ,Science-Based Industrial Park,
+				Hsinchu    300
+				TW
+
+00-11-F0   (hex)		Wideful Limited
+0011F0     (base 16)		Wideful Limited
+				F5, 3/F., Phase II, Superluck Industrial Centre, 
+				    
+				HK
+
+00-11-F1   (hex)		QinetiQ Ltd
+0011F1     (base 16)		QinetiQ Ltd
+				Room E601
+				Malvern  Worcestershire  WR14 3PS
+				GB
+
+00-11-ED   (hex)		802 Global
+0011ED     (base 16)		802 Global
+				Studio 11,Intec 2,Wade Road
+				Hampshire    RG24 BNE
+				GB
+
+00-12-11   (hex)		Protechna Herbst GmbH & Co. KG
+001211     (base 16)		Protechna Herbst GmbH & Co. KG
+				Otto Hahn Str. 26
+				Ottobrunn  Germany/Bavaria  85521
+				DE
+
+00-12-19   (hex)		General Datacomm LLC
+001219     (base 16)		General Datacomm LLC
+				353 Christian Street, Suite 4
+				Oxford  CT  06478
+				US
+
+00-12-16   (hex)		ICP Internet Communication Payment AG
+001216     (base 16)		ICP Internet Communication Payment AG
+				Wilhelm-Stein-Weg 24
+				Hamburg    D-22339
+				DE
+
+00-12-15   (hex)		iStor Networks, Inc.
+001215     (base 16)		iStor Networks, Inc.
+				7585 Irvine Center Drive
+				Irvine  CA  92618
+				US
+
+00-12-03   (hex)		ActivNetworks
+001203     (base 16)		ActivNetworks
+				BAT L - 1 rue de Terre Neuve
+				COURTABOEUF    91944
+				FR
+
+00-11-CC   (hex)		Guangzhou Jinpeng Group Co.,Ltd.
+0011CC     (base 16)		Guangzhou Jinpeng Group Co.,Ltd.
+				No.9 Shenzhou Road,Guangzhou Science City
+				Guangzhou  Guangdong  510663
+				CN
+
+00-11-C7   (hex)		Raymarine UK Ltd
+0011C7     (base 16)		Raymarine UK Ltd
+				Marine House
+				Fareham  Hampshire  PO15 5RJ
+				GB
+
+00-11-C9   (hex)		MTT Corporation
+0011C9     (base 16)		MTT Corporation
+				2-7-12
+				Nishi-ku  Kobe  651-2241
+				JP
+
+00-11-DB   (hex)		Land-Cellular Corporation
+0011DB     (base 16)		Land-Cellular Corporation
+				12054 Miramar Parkway
+				Miramar  FL  33025
+				US
+
+00-12-24   (hex)		NexQL Corporation
+001224     (base 16)		NexQL Corporation
+				12250 Inwood Road #6
+				Dallas  TX  75244
+				US
+
+00-11-BD   (hex)		Bombardier Transportation
+0011BD     (base 16)		Bombardier Transportation
+				1501 Lebanon Church Road
+				Pittsburgh  PA  15236
+				US
+
+00-11-AA   (hex)		Uniclass Technology, Co., LTD
+0011AA     (base 16)		Uniclass Technology, Co., LTD
+				4F, No. 98, Ming chuan Rd
+				Hsintien City  Taipei Hsien  231
+				TW
+
+00-11-79   (hex)		Singular Technology Co. Ltd.
+001179     (base 16)		Singular Technology Co. Ltd.
+				21F, No.37, Sec.2, San Min Rd.,
+				Taipei    220
+				TW
+
+00-11-8A   (hex)		Viewtran Technology Limited
+00118A     (base 16)		Viewtran Technology Limited
+				3/F, R2-A builiding, High Tech Industrial Park,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-11-84   (hex)		Humo Laboratory,Ltd.
+001184     (base 16)		Humo Laboratory,Ltd.
+				Nishiogi-Kita 5-19-11
+				Suginami-ku  Tokyo  167-0042
+				JP
+
+00-11-B1   (hex)		BlueExpert Technology Corp.
+0011B1     (base 16)		BlueExpert Technology Corp.
+				8F,No.16,Lane 77,Xing-Ai Rd,Nei-Hu District
+				Taipei    11494
+				TW
+
+00-11-A6   (hex)		Sypixx Networks
+0011A6     (base 16)		Sypixx Networks
+				108 Bank Street
+				Waterbury  CT  06702
+				US
+
+00-11-B5   (hex)		Shenzhen Powercom Co.,Ltd
+0011B5     (base 16)		Shenzhen Powercom Co.,Ltd
+				Floor 16,Tower B,Zhongyin Building,North Caitian Road,Futian District,Shenzhen,P.R.China
+				Shenzhen  Guangdong province  518028
+				CN
+
+00-11-BB   (hex)		Cisco Systems, Inc
+0011BB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-66   (hex)		Taelim Electronics Co., Ltd.
+001166     (base 16)		Taelim Electronics Co., Ltd.
+				196-5, ANYANG7-DONG MANAN-GU
+				ANYANG-SI  KYUGGI-DO  430-817
+				KR
+
+00-11-64   (hex)		ACARD Technology Corp.
+001164     (base 16)		ACARD Technology Corp.
+				6F No.78 Sec1 Kwang Fu Road, Sanchung,
+				Taipei Hsien    241
+				TW
+
+00-11-A2   (hex)		Manufacturing Technology Inc
+0011A2     (base 16)		Manufacturing Technology Inc
+				70 Ready Ave NW
+				Fort Walton Beach  FL  32548
+				US
+
+00-11-9E   (hex)		Solectron Brazil
+00119E     (base 16)		Solectron Brazil
+				Rod. Campinas Mogi Mirim
+				Jaguariuna  SP  13820-000
+				BR
+
+00-11-73   (hex)		SMART Storage Systems
+001173     (base 16)		SMART Storage Systems
+				2600 W Geronimo Place
+				Chandler  AZ  85224
+				US
+
+00-11-25   (hex)		IBM Corp
+001125     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-11-1C   (hex)		Pleora Technologies Inc.
+00111C     (base 16)		Pleora Technologies Inc.
+				359 Terry Fox Drive, Suite 230
+				Kanata  ON  K2K 2E7
+				CA
+
+00-11-1F   (hex)		Doremi Labs, Inc.
+00111F     (base 16)		Doremi Labs, Inc.
+				306 E. Alameda Ave.
+				Burbank  CA  91502
+				US
+
+00-11-1D   (hex)		Hectrix Limited
+00111D     (base 16)		Hectrix Limited
+				Unit 906-911, 9/F, Stanhope Hosue,
+				North Point  Hong Kong  
+				CN
+
+00-11-19   (hex)		Solteras, Inc.
+001119     (base 16)		Solteras, Inc.
+				900 W. Santa Anita Street
+				San Gabriel  CA  91776
+				US
+
+00-11-50   (hex)		Belkin Corporation
+001150     (base 16)		Belkin Corporation
+				501 West Walnut Street
+				Compton  CA  90220-5221
+				US
+
+00-11-46   (hex)		Telecard-Pribor Ltd
+001146     (base 16)		Telecard-Pribor Ltd
+				Lustdorfskaya doroga, 162
+				Odessa    65115
+				UA
+
+00-11-0D   (hex)		SANBlaze Technology, Inc.
+00110D     (base 16)		SANBlaze Technology, Inc.
+				2 Clock Tower Place
+				Maynard  MA  01748
+				US
+
+00-11-06   (hex)		Siemens NV (Belgium)
+001106     (base 16)		Siemens NV (Belgium)
+				Atealaan 34
+				Herentals  Antwerp  2200
+				BE
+
+00-0F-F4   (hex)		Guntermann & Drunck GmbH
+000FF4     (base 16)		Guntermann & Drunck GmbH
+				Obere Leimbach 9
+				Siegen  NRW  57074
+				DE
+
+00-0F-F8   (hex)		Cisco Systems, Inc
+000FF8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-2C   (hex)		IZT GmbH
+00112C     (base 16)		IZT GmbH
+				Am Weichselgarten 5
+				Erlangen  Bavaria  91058
+				DE
+
+00-11-14   (hex)		EverFocus Electronics Corp.
+001114     (base 16)		EverFocus Electronics Corp.
+				12F, No. 79, Sec. 1, Shin-Tai Wu Rd.
+				Hsi-Chi  Taipei Hsien  221
+				TW
+
+00-11-0E   (hex)		Tsurusaki Sealand Transportation Co. Ltd.
+00110E     (base 16)		Tsurusaki Sealand Transportation Co. Ltd.
+				1000 Misa
+				Oita    8700196
+				JP
+
+00-11-4C   (hex)		caffeina applied research ltd.
+00114C     (base 16)		caffeina applied research ltd.
+				125 baird ave
+				cochrane  alberta  t4c 1c7
+				CA
+
+00-11-41   (hex)		GoodMan Corporation
+001141     (base 16)		GoodMan Corporation
+				2F, No.572, Sec.1, Ming-Sheng N Road, Kwei-Shan Hsiang
+				Taoyuan Hsien    33300
+				TW
+
+00-11-55   (hex)		Sevis Systems
+001155     (base 16)		Sevis Systems
+				2805 N Dallas Parkway, STE 530
+				Plano  Texas  75093
+				US
+
+00-11-52   (hex)		Eidsvoll Electronics AS
+001152     (base 16)		Eidsvoll Electronics AS
+				Nedre Vilberg vei 8
+				Eidsvoll    N-2080
+				NO
+
+00-0F-CF   (hex)		DataWind Research
+000FCF     (base 16)		DataWind Research
+				555 Rene-Levesque West
+				Montreal  Quebec  H2Z 1B1
+				CA
+
+00-0F-D2   (hex)		EWA Technologies, Inc.
+000FD2     (base 16)		EWA Technologies, Inc.
+				13873 Park Center Road
+				Herndon  VA  20171
+				US
+
+00-0F-CE   (hex)		Kikusui Electronics Corp.
+000FCE     (base 16)		Kikusui Electronics Corp.
+				1-1-3,Higashi yamata
+				Yokohama  Kanagawa  224-0023
+				JP
+
+00-0F-EB   (hex)		Cylon Controls
+000FEB     (base 16)		Cylon Controls
+				Clonshaugh Industrial Estate
+				Dublin 17    
+				IE
+
+00-0F-DC   (hex)		Ueda Japan  Radio Co., Ltd.
+000FDC     (base 16)		Ueda Japan  Radio Co., Ltd.
+				Fumiiri 2-10-19
+				Ueda city  Nagano prefecture  386-8608
+				JP
+
+00-0F-8E   (hex)		DONGYANG TELECOM CO.,LTD.
+000F8E     (base 16)		DONGYANG TELECOM CO.,LTD.
+				642-7, DEUNGCHON-DONG, KANGSEO-GU
+				SEOUL  KANGSE-GU  157-841
+				KR
+
+00-0F-91   (hex)		Aerotelecom Co.,Ltd.
+000F91     (base 16)		Aerotelecom Co.,Ltd.
+				195-58 Anyang 7 Dong
+				Anyang  Kyunggi  430-817
+				US
+
+00-0F-87   (hex)		Maxcess International
+000F87     (base 16)		Maxcess International
+				222 W. Memorial Road
+				Oklahoma City  OK  73114
+				US
+
+00-0F-A1   (hex)		Gigabit Systems Inc.
+000FA1     (base 16)		Gigabit Systems Inc.
+				Fuyoh Video Building 3F
+				Yokohama  Kanagawa  241-0826
+				JP
+
+00-0F-99   (hex)		APAC opto Electronics Inc.
+000F99     (base 16)		APAC opto Electronics Inc.
+				3 Tzu Chiang Road, Hsinchu Industrial Park
+				Hukow, Hsinchu Hsien    303
+				TW
+
+00-0F-F5   (hex)		GN&S company
+000FF5     (base 16)		GN&S company
+				301 Ansan S/W center, 643-7 wongok-dong
+				Ansan city  Gyeonggi-do  425-130
+				KR
+
+00-0F-E8   (hex)		Lobos, Inc.
+000FE8     (base 16)		Lobos, Inc.
+				U&T Bldg 3F, 1-2-3 Sarugaku-cho, Chiyoda-ku,
+				Tokyo    101-0064
+				JP
+
+00-0F-B2   (hex)		Broadband Pacenet (India) Pvt. Ltd.
+000FB2     (base 16)		Broadband Pacenet (India) Pvt. Ltd.
+				7-B, Shah Industrial Estate, Off Veera Desai Road
+				Mumbai  Maharashtra  400 053
+				IN
+
+00-0F-D7   (hex)		Harman Music Group
+000FD7     (base 16)		Harman Music Group
+				8760 Sandy Parkway
+				Sandy  Utah  84070
+				US
+
+00-0F-D4   (hex)		Soundcraft
+000FD4     (base 16)		Soundcraft
+				Cranborne House
+				Potters Bar  Hertfordshire  EN6 3JN
+				GB
+
+00-0F-AF   (hex)		Dialog Inc.
+000FAF     (base 16)		Dialog Inc.
+				1-47-9
+				Toshima-ku  Tokyo  1700013
+				JP
+
+00-0F-A5   (hex)		BWA Technology GmbH
+000FA5     (base 16)		BWA Technology GmbH
+				Johann-Krane-Weg 21
+				Muenster    48149
+				DE
+
+00-0F-80   (hex)		Trinity Security Systems,Inc.
+000F80     (base 16)		Trinity Security Systems,Inc.
+				Alte Building Higashi Kanda 8F
+				Chiyoda-ku  Tokyo  101-0031
+				JP
+
+00-0F-32   (hex)		Lootom Telcovideo Network Wuxi Co Ltd
+000F32     (base 16)		Lootom Telcovideo Network Wuxi Co Ltd
+				5F, 9Building,
+				WuXi  JiangSu  214072
+				CN
+
+00-0F-2A   (hex)		Cableware Electronics
+000F2A     (base 16)		Cableware Electronics
+				1702 Western Ave.
+				Las Vegas  Nevada  89102
+				US
+
+00-0F-29   (hex)		Augmentix Corporation
+000F29     (base 16)		Augmentix Corporation
+				4030 W Braker Ln
+				Austin  Texas  78759
+				US
+
+00-0F-27   (hex)		TEAL Electronics, Inc.
+000F27     (base 16)		TEAL Electronics, Inc.
+				10350 Sorrento Valley Road
+				San Diego  California  92121
+				US
+
+00-0F-43   (hex)		Wasabi Systems Inc.
+000F43     (base 16)		Wasabi Systems Inc.
+				500 E. Main Street
+				Norfolk  VA  23510
+				US
+
+00-0F-48   (hex)		Polypix Inc.
+000F48     (base 16)		Polypix Inc.
+				1Fl, Sungdo Venture Tower, 165-2 Samsung-Dong, Kangnam-Ku
+				Seoul    135-881
+				KR
+
+00-0F-50   (hex)		StreamScale Limited
+000F50     (base 16)		StreamScale Limited
+				The Court, Alexandra Park
+				St Helens    WA10 3TP
+				GB
+
+00-0F-4E   (hex)		Cellink
+000F4E     (base 16)		Cellink
+				Catherinalaan 37
+				Rotselaar  Vlaams Brabant  B-3110
+				BE
+
+00-0F-47   (hex)		ROBOX SPA
+000F47     (base 16)		ROBOX SPA
+				via Sempione 82
+				Castelletto S.Ticino  NO  28053
+				IT
+
+00-0F-18   (hex)		Industrial Control Systems
+000F18     (base 16)		Industrial Control Systems
+				Houtschelf 1
+				Hardinxveld  Zuid-Holland  NL-3371 KB
+				NL
+
+00-0F-1D   (hex)		Cosmo Techs Co., Ltd.
+000F1D     (base 16)		Cosmo Techs Co., Ltd.
+				2-6-1, Matsue
+				Atsugi-shi  Kanagawa-ken  243-0005
+				JP
+
+00-0F-1B   (hex)		Ego Systems Inc.
+000F1B     (base 16)		Ego Systems Inc.
+				1206 Woolim e-Biz Center II
+				Seoul    150-834
+				KR
+
+00-0F-78   (hex)		Datacap Systems Inc
+000F78     (base 16)		Datacap Systems Inc
+				100 New Britain Blvd
+				Chalfont  PA  18914
+				US
+
+00-0F-70   (hex)		Wintec Industries, inc.
+000F70     (base 16)		Wintec Industries, inc.
+				675 Sycamore Drive
+				Milpitas,  CA  95035
+				US
+
+00-0F-74   (hex)		Qamcom Technology AB
+000F74     (base 16)		Qamcom Technology AB
+				Gruvgatan 8
+				Vastra  Frolunda  
+				SE
+
+00-0F-6D   (hex)		Midas Engineering
+000F6D     (base 16)		Midas Engineering
+				Ace Techno-Tower V #906 197-22
+				Seoul    152-848
+				KR
+
+00-0F-5F   (hex)		Nicety Technologies Inc. (NTS)
+000F5F     (base 16)		Nicety Technologies Inc. (NTS)
+				792-3 Tomioka Toyoda-cho
+				Iwata-gun  Shizuoka  438-0803
+				JP
+
+00-0F-5A   (hex)		Peribit Networks
+000F5A     (base 16)		Peribit Networks
+				2855 Bowers Ave
+				Santa Clara  CA  95051
+				US
+
+00-0F-31   (hex)		Allied Vision Technologies Canada Inc
+000F31     (base 16)		Allied Vision Technologies Canada Inc
+				101-3750 North Fraser Way
+				Burnaby  BC  V5J 5E9
+				CA
+
+00-0F-73   (hex)		RS Automation Co., Ltd
+000F73     (base 16)		RS Automation Co., Ltd
+				447-6, Gongse-Dong , Giheung-Gu
+				Youngin-City  Gyeonggi-Do  449-902
+				KR
+
+00-0F-3C   (hex)		Endeleo Limited
+000F3C     (base 16)		Endeleo Limited
+				78 Cannon Street
+				London  England  EC4N 6NQ
+				GB
+
+00-0E-AB   (hex)		Cray Inc
+000EAB     (base 16)		Cray Inc
+				901 Fifth Avenue
+				Seattle  WA  98104
+				US
+
+00-0E-AD   (hex)		Metanoia Technologies, Inc.
+000EAD     (base 16)		Metanoia Technologies, Inc.
+				5918 W. courtyard Dr.
+				Austin  TX  78730
+				US
+
+00-0E-AF   (hex)		CASTEL
+000EAF     (base 16)		CASTEL
+				ZI Saint Lambert des Levées
+				SAUMUR  Maine et Loire  49412
+				FR
+
+00-0E-F8   (hex)		SBC ASI
+000EF8     (base 16)		SBC ASI
+				Network & Infrastructure Technical Support
+				San Antonio  Texas  78215
+				US
+
+00-0E-F9   (hex)		REA Elektronik GmbH
+000EF9     (base 16)		REA Elektronik GmbH
+				Teichwiesenstraße 1
+				Muehltal  Hessen  64367
+				DE
+
+00-0E-E6   (hex)		Adimos Systems LTD
+000EE6     (base 16)		Adimos Systems LTD
+				17 Atirey-Yeda Street
+				Kfar-Saba    44643
+				IL
+
+00-0E-F6   (hex)		E-TEN Information Systems Co., Ltd.
+000EF6     (base 16)		E-TEN Information Systems Co., Ltd.
+				No. 256, Yangguang Street, Neihu Chiu
+				Taipei    114
+				TW
+
+00-0E-EA   (hex)		Shadong Luneng Jicheng Electronics,Co.,Ltd
+000EEA     (base 16)		Shadong Luneng Jicheng Electronics,Co.,Ltd
+				No.188,east,Huayuan Road
+				Jinan  Shandong  250100
+				CN
+
+00-0F-0F   (hex)		Real ID Technology Co., Ltd.
+000F0F     (base 16)		Real ID Technology Co., Ltd.
+				9F Hanmi B/D 192-19
+				Gangnam-Gu  Seoul  135-010
+				KR
+
+00-0F-16   (hex)		JAY HOW TECHNOLOGY CO.,
+000F16     (base 16)		JAY HOW TECHNOLOGY CO.,
+				NO.486,SEC. 1, WAN SHOU RD., KUEI
+				TAOYUAN HSIEN    333
+				TW
+
+00-0E-C6   (hex)		ASIX ELECTRONICS CORP.
+000EC6     (base 16)		ASIX ELECTRONICS CORP.
+				4F, NO.8, HSIN ANN RD.,
+				HSINCHU    300
+				TW
+
+00-0E-BF   (hex)		Remsdaq Limited
+000EBF     (base 16)		Remsdaq Limited
+				Parkway
+				Deeside  Flintshire  CH5 2NL
+				GB
+
+00-0E-FF   (hex)		Megasolution,Inc.
+000EFF     (base 16)		Megasolution,Inc.
+				2-7-10 Shitaya
+				Taito  TOKYO  110-0004
+				JP
+
+00-0E-E0   (hex)		Mcharge
+000EE0     (base 16)		Mcharge
+				Firstec Bldg,. 15-4 Youido-Dong
+				seoul  Youido  150-010
+				KR
+
+00-0E-9F   (hex)		TEMIC SDS GmbH
+000E9F     (base 16)		TEMIC SDS GmbH
+				Soeflinger Strasse 100
+				Ulm    89077
+				DE
+
+00-0E-96   (hex)		Cubic Defense Applications, Inc.
+000E96     (base 16)		Cubic Defense Applications, Inc.
+				P.O. Box 85587
+				San Diego  CA  92186-5587
+				US
+
+00-0E-8E   (hex)		SparkLAN Communications, Inc.
+000E8E     (base 16)		SparkLAN Communications, Inc.
+				3Fl . , No. 246, Sec. 1, Neihu Road., Neihu Chiu,
+				Taipei    114
+				TW
+
+00-0E-91   (hex)		Navico Auckland Ltd
+000E91     (base 16)		Navico Auckland Ltd
+				17-21 Kawana St
+				Northcote  Auckland  
+				NZ
+
+00-0E-48   (hex)		Lipman TransAction Solutions
+000E48     (base 16)		Lipman TransAction Solutions
+				11 Haamal St.
+				 Rosh-Haayin    48092
+				IL
+
+00-0E-3E   (hex)		Sun Optronics Inc
+000E3E     (base 16)		Sun Optronics Inc
+				4-38-4 Fuchinobe-honchou
+				Sagamihara  Kanagawa  229-0002
+				JP
+
+00-0E-33   (hex)		Shuko Electronics Co.,Ltd
+000E33     (base 16)		Shuko Electronics Co.,Ltd
+				TOHSHIN HIGASHI-IKEBUKURO Building 3F
+				TOKYO  KANTOH  170-0063
+				JP
+
+00-0E-75   (hex)		New York Air Brake Corp.
+000E75     (base 16)		New York Air Brake Corp.
+				748 Starbuck Ave.
+				Watertown  NY  13601
+				US
+
+00-0E-7C   (hex)		Televes S.A.
+000E7C     (base 16)		Televes S.A.
+				Rua Benefica Conxo 17
+				Santiago de Compostela  Coruña  15706
+				ES
+
+00-0E-66   (hex)		Hitachi Industry & Control Solutions, Ltd.
+000E66     (base 16)		Hitachi Industry & Control Solutions, Ltd.
+				5-1-26, Omika-cho, Hitachi-shi, Ibaraki
+				    319-1221
+				JP
+
+00-0E-68   (hex)		E-TOP Network Technology Inc.
+000E68     (base 16)		E-TOP Network Technology Inc.
+				No. 7, Shin Shin Rd.,
+				Tainan    702
+				TW
+
+00-0E-5E   (hex)		Raisecom Technology
+000E5E     (base 16)		Raisecom Technology
+				2 Floor, South Building of Rainbow Plaza
+				Haidian District  Beijing  100085
+				CN
+
+00-0E-56   (hex)		4G Systems GmbH & Co. KG
+000E56     (base 16)		4G Systems GmbH & Co. KG
+				Jarrestrasse 2-6
+				22303  Hamburg  
+				DE
+
+00-0E-55   (hex)		AUVITRAN
+000E55     (base 16)		AUVITRAN
+				7c chemin des Prés
+				MEYLAN    38410
+				FR
+
+00-0E-73   (hex)		Tpack A/S
+000E73     (base 16)		Tpack A/S
+				Lautrupbjerg 7 - 11
+				DK 2750  Ballerup    DK 2750
+				DK
+
+00-0E-72   (hex)		CTS electronics
+000E72     (base 16)		CTS electronics
+				Corso Vercelli 332
+				Ivrea  Torino  10015
+				IT
+
+00-0E-6E   (hex)		MAT S.A. (Mircrelec Advanced Technology)
+000E6E     (base 16)		MAT S.A. (Mircrelec Advanced Technology)
+				Mousounitsis 15
+				Peristeri  Athens  
+				GR
+
+00-0E-84   (hex)		Cisco Systems, Inc
+000E84     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-87   (hex)		adp Gauselmann GmbH
+000E87     (base 16)		adp Gauselmann GmbH
+				Boschstraße 8
+				Luebbecke  NRW  32312
+				DE
+
+00-0E-92   (hex)		Open Telecom
+000E92     (base 16)		Open Telecom
+				803-804 Daeryung Techno-town II
+				Keuncheon-Ku  Seoul  153-771
+				KR
+
+00-0E-53   (hex)		AV TECH CORPORATION
+000E53     (base 16)		AV TECH CORPORATION
+				10F,E Building,No.19-11 San Chung Rd.,NanKang
+				Taipei    115
+				TW
+
+00-0D-F9   (hex)		NDS Limited
+000DF9     (base 16)		NDS Limited
+				One Heathrow Boulevard
+				West Drayton  Middlesex  UB7 0DQ
+				GB
+
+00-0D-FD   (hex)		Huges Hi-Tech Inc.,
+000DFD     (base 16)		Huges Hi-Tech Inc.,
+				7F, 188, Sec. 2, Chung Hsing Road.
+				Hsin Tien  Taipei Hsien  231
+				TW
+
+00-0D-FB   (hex)		Komax AG
+000DFB     (base 16)		Komax AG
+				Industriestrasse 6
+				Dierikon  LU  6036
+				CH
+
+00-0E-00   (hex)		Atrie
+000E00     (base 16)		Atrie
+				10th Floor, 14, Lane 609, Sec. 5, Chung Hsin Rd., San Chung City,
+				Taipei Hsien  San Chung  241
+				TW
+
+00-0D-F4   (hex)		Watertek Co.
+000DF4     (base 16)		Watertek Co.
+				Room 1006,Haitai building,north si Huan
+				Beijing    100083
+				CN
+
+00-0D-FA   (hex)		Micro Control Systems Ltd.
+000DFA     (base 16)		Micro Control Systems Ltd.
+				8-7 Sakurai
+				Saku-shi  Nagano  385-0056
+				JP
+
+00-0D-FC   (hex)		ITFOR Inc.
+000DFC     (base 16)		ITFOR Inc.
+				Ichibancho Tokyu Bidg.,
+				  Tokyo  102-0082
+				JP
+
+00-0D-FE   (hex)		Hauppauge Computer Works, Inc.
+000DFE     (base 16)		Hauppauge Computer Works, Inc.
+				91 Cabot Court
+				Hauppauge  New York  11788
+				US
+
+00-0D-D6   (hex)		ITI    LTD
+000DD6     (base 16)		ITI    LTD
+				R&D,ITI Bangalore Complex
+				Dooravani Nagar, Bangalore  Karnataka State  560016
+				IN
+
+00-0D-D5   (hex)		O'RITE TECHNOLOGY CO.,LTD
+000DD5     (base 16)		O'RITE TECHNOLOGY CO.,LTD
+				4f-8,NO 80,GUANGFU RD.SEC 2,SANCHUNG
+				TAIPEI COUNTY    241
+				TW
+
+00-0E-0F   (hex)		ERMME
+000E0F     (base 16)		ERMME
+				9 rue Lavoisier
+				Vert-Le-Petit    91710
+				FR
+
+00-0E-10   (hex)		C-guys, Inc.
+000E10     (base 16)		C-guys, Inc.
+				Izumi Garden Wing 1F, 1-6-3
+				Tokyo    106-0032
+				JP
+
+00-0E-0A   (hex)		SAKUMA DESIGN OFFICE
+000E0A     (base 16)		SAKUMA DESIGN OFFICE
+				674-11
+				KUKI-SHI  SAITAMA  346-0029
+				JP
+
+00-0E-0E   (hex)		ESA elettronica S.P.A.
+000E0E     (base 16)		ESA elettronica S.P.A.
+				
+				Mariano Comense  CO  22066
+				IT
+
+00-0E-18   (hex)		MyA Technology
+000E18     (base 16)		MyA Technology
+				2100 Muirwood Way
+				San Jose  CA  95132
+				US
+
+00-0E-14   (hex)		Visionary Solutions, Inc.
+000E14     (base 16)		Visionary Solutions, Inc.
+				4193 Carpinteria Ave
+				Carpinteria  CA  93013
+				US
+
+00-0E-1B   (hex)		IAV GmbH
+000E1B     (base 16)		IAV GmbH
+				Carnotstraße 1
+				Berlin    10587
+				DE
+
+00-0E-13   (hex)		Accu-Sort Systems inc.
+000E13     (base 16)		Accu-Sort Systems inc.
+				511 School House Road
+				Telford  PA  18969
+				US
+
+00-0D-DE   (hex)		Joyteck Co., Ltd.
+000DDE     (base 16)		Joyteck Co., Ltd.
+				19F, No.4, Sec. 3, Min Chuan East Rd.
+				Taipei    105
+				TW
+
+00-0D-E2   (hex)		CMZ Sistemi Elettronici
+000DE2     (base 16)		CMZ Sistemi Elettronici
+				Via dell'Artiginato, 21
+				Vascon di Carbonera  Treviso  31050
+				IT
+
+00-0D-DA   (hex)		ALLIED TELESIS K.K.
+000DDA     (base 16)		ALLIED TELESIS K.K.
+				PIAZZA TIRANA N. 24/4 B
+				MILANO    20147
+				IT
+
+00-0D-CD   (hex)		GROUPE TXCOM
+000DCD     (base 16)		GROUPE TXCOM
+				ZI DU PETIT CLAMART
+				LE PLESSIS ROBINSON  HAUTS-DE-SEINE  92350
+				FR
+
+00-0D-CA   (hex)		Tait Electronics
+000DCA     (base 16)		Tait Electronics
+				535 Wairakei Rd
+				Christchurch  Canterbury  8005
+				NZ
+
+00-0D-CF   (hex)		Cidra Corp.
+000DCF     (base 16)		Cidra Corp.
+				50 Barns Park North
+				Wallingford  CT  06492
+				US
+
+00-0E-3A   (hex)		Cirrus Logic
+000E3A     (base 16)		Cirrus Logic
+				2901 Via Fortuna
+				Austin  TX  78746
+				US
+
+00-0E-3B   (hex)		Hawking Technologies, Inc.
+000E3B     (base 16)		Hawking Technologies, Inc.
+				15281A Barranca Parkway
+				Irvine  CA  92618
+				US
+
+00-0D-EC   (hex)		Cisco Systems, Inc
+000DEC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-F2   (hex)		Private
+000DF2     (base 16)		Private
+
+00-0E-27   (hex)		Crere Networks, Inc.
+000E27     (base 16)		Crere Networks, Inc.
+				Room 110 ETRI TBI, 52 Eoeun-dong
+				Daejeon    305-333
+				KR
+
+00-0D-A0   (hex)		NEDAP N.V.
+000DA0     (base 16)		NEDAP N.V.
+				P.O.Box 103
+				GROENLO  GLD  7141 AC
+				NL
+
+00-0D-8E   (hex)		Koden Electronics Co., Ltd.
+000D8E     (base 16)		Koden Electronics Co., Ltd.
+				5278 Uenohara
+				  Yamanashi-Ken  409-0112
+				JP
+
+00-0D-8A   (hex)		Winners Electronics Co., Ltd.
+000D8A     (base 16)		Winners Electronics Co., Ltd.
+				#340-5,Wonchun-Dong,Paldal-Gu
+				Suwon-City  Kyungki-Do  442-823
+				KR
+
+00-0D-7E   (hex)		Axiowave Networks, Inc.
+000D7E     (base 16)		Axiowave Networks, Inc.
+				200 Nickerson Road
+				Marlborough  MA  01752
+				US
+
+00-0D-71   (hex)		boca systems
+000D71     (base 16)		boca systems
+				1065 s. rogers circle
+				boca raton  fl  33487
+				US
+
+00-0D-5A   (hex)		Tiesse SpA
+000D5A     (base 16)		Tiesse SpA
+				Via Asti
+				Ivrea  TO  10015
+				IT
+
+00-0D-B8   (hex)		SCHILLER AG
+000DB8     (base 16)		SCHILLER AG
+				Altgasse 68
+				Baar  Zug  6300
+				CH
+
+00-0D-C4   (hex)		Emcore Corporation
+000DC4     (base 16)		Emcore Corporation
+				1600 Eubank Blvd, SE
+				Albuquerque  New Mexico  87123
+				US
+
+00-0D-9B   (hex)		Heraeus Electro-Nite International N.V.
+000D9B     (base 16)		Heraeus Electro-Nite International N.V.
+				Centrum Zuid 1105
+				Houthalen    3530
+				BE
+
+00-0D-7C   (hex)		Codian Ltd
+000D7C     (base 16)		Codian Ltd
+				14 Waterside Drive
+				Langley  Slough  SL3 6EZ
+				GB
+
+00-0D-6B   (hex)		Mita-Teknik A/S
+000D6B     (base 16)		Mita-Teknik A/S
+				Haandvaerkervej 1
+				Roedkaersbro    DK-8840
+				DK
+
+00-0D-43   (hex)		DRS Tactical Systems Inc.
+000D43     (base 16)		DRS Tactical Systems Inc.
+				3520 U.S. Highway 1
+				Palm Bay  FL  32905
+				US
+
+00-0D-44   (hex)		Audio BU - Logitech
+000D44     (base 16)		Audio BU - Logitech
+				1499 SE Tech Center Place
+				Vancouver  WA  98683
+				US
+
+00-0D-36   (hex)		Wu Han Routon Electronic Co., Ltd
+000D36     (base 16)		Wu Han Routon Electronic Co., Ltd
+				Miao Shan District, East Lake Hi-Tech
+				Wuhan  Hubei  430223
+				CN
+
+00-0D-3D   (hex)		Hammerhead Systems, Inc.
+000D3D     (base 16)		Hammerhead Systems, Inc.
+				640 Clyde Court
+				Mountain View  California  94043
+				US
+
+00-0D-3E   (hex)		APLUX Communications Ltd.
+000D3E     (base 16)		APLUX Communications Ltd.
+				10F, No. 166, Dah-Yeh Rd., Peitou
+				Taipei    112
+				TW
+
+00-0D-0D   (hex)		ITSupported, LLC
+000D0D     (base 16)		ITSupported, LLC
+				4989 Peachtree Parkway
+				Norcross  GA  30092
+				US
+
+00-0D-06   (hex)		Compulogic Limited
+000D06     (base 16)		Compulogic Limited
+				Unit W3, MK TWO Business Centre
+				Water Eaton  Milton Keynes  MK2 3HU
+				GB
+
+00-0D-4A   (hex)		Steag ETA-Optik
+000D4A     (base 16)		Steag ETA-Optik
+				Borsigstrasse 78.-80
+				Heinsberg    52525
+				DE
+
+00-0D-4F   (hex)		Kenwood Corporation
+000D4F     (base 16)		Kenwood Corporation
+				2967-3, Ishikawa-machi
+				Hachioji-shi  Tokyo  192-8525
+				JP
+
+00-0D-47   (hex)		Collex
+000D47     (base 16)		Collex
+				13F-3,No.142,Sec.1,Huamei W,St.,Shi Chiu
+				Taichung    403
+				TW
+
+00-0D-61   (hex)		Giga-Byte Technology Co., Ltd.
+000D61     (base 16)		Giga-Byte Technology Co., Ltd.
+				No 6, Bau Chiang Road, Hsin-Tien
+				Taipei Hsien    9999
+				TW
+
+00-0D-3B   (hex)		Microelectronics Technology Inc.
+000D3B     (base 16)		Microelectronics Technology Inc.
+				No1, Innovation Road II
+				    300
+				TW
+
+00-0D-2D   (hex)		NCT Deutschland GmbH
+000D2D     (base 16)		NCT Deutschland GmbH
+				Wildenbruchstraße 15
+				Jena  Thüringen  07745
+				DE
+
+00-0D-1E   (hex)		Control Techniques
+000D1E     (base 16)		Control Techniques
+				The Gro
+				Newtown  Powys  SY16 3BE
+				GB
+
+00-0D-52   (hex)		Comart system
+000D52     (base 16)		Comart system
+				No. 211, Ace Techno Tower III, 197-48
+				Seoul    152-050
+				KR
+
+00-0D-1A   (hex)		Mustek System Inc.
+000D1A     (base 16)		Mustek System Inc.
+				No. 25, R&D Road, Science-Based Industri
+				Hsin-Chu    300
+				TW
+
+00-0C-B8   (hex)		MEDION AG
+000CB8     (base 16)		MEDION AG
+				Am Zehnthof 77
+				Essen  NRW  45307
+				DE
+
+00-0C-BB   (hex)		ISKRAEMECO
+000CBB     (base 16)		ISKRAEMECO
+				Savska loka 4
+				Kranj  Gorenjska  4000
+				SI
+
+00-0C-C0   (hex)		Genera Oy
+000CC0     (base 16)		Genera Oy
+				Niittylanpolku 16
+				Helsinki    00621
+				FI
+
+00-0C-A8   (hex)		Garuda Networks Corporation
+000CA8     (base 16)		Garuda Networks Corporation
+				48499 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-0D-03   (hex)		Matrics, Inc.
+000D03     (base 16)		Matrics, Inc.
+				8850 Stanford Blvd
+				Columbia  MD  21045
+				US
+
+00-0C-FF   (hex)		MRO-TEK Realty Limited
+000CFF     (base 16)		MRO-TEK Realty Limited
+				#6, New BEL Road
+				Chikkamaranahalli  Bangalore  560 054
+				IN
+
+00-0C-FA   (hex)		Digital Systems Corp
+000CFA     (base 16)		Digital Systems Corp
+				3 North Main Street
+				Walkersville  Maryland  21793
+				US
+
+00-0C-FD   (hex)		Hyundai ImageQuest Co.,Ltd.
+000CFD     (base 16)		Hyundai ImageQuest Co.,Ltd.
+				San 136-1, Ami-ri, Bubal-eub
+				Ichon-si  Kyoung ki-do  467-701
+				KR
+
+00-0C-D3   (hex)		Prettl Elektronik Radeberg GmbH
+000CD3     (base 16)		Prettl Elektronik Radeberg GmbH
+				Robert-Bosch-Str. 10
+				Radeberg  Saxony  D-01454
+				DE
+
+00-0C-D7   (hex)		Nallatech Ltd
+000CD7     (base 16)		Nallatech Ltd
+				Boolean House
+				Glasgow  Scotland  G68 0BH
+				GB
+
+00-0C-D4   (hex)		Positron Public Safety Systems inc.
+000CD4     (base 16)		Positron Public Safety Systems inc.
+				5101 Buchan
+				Montreal  Quebec  H4P 2R9
+				CA
+
+00-0C-D6   (hex)		PARTNER TECH
+000CD6     (base 16)		PARTNER TECH
+				10F, NO.233-2,PAO CHIAO ROAD, SHIN TIEN
+				TAIPEI    231
+				TW
+
+00-0C-B9   (hex)		LEA
+000CB9     (base 16)		LEA
+				Bat LA FAYETTE
+				Paris  RP  924051
+				FR
+
+00-0C-BD   (hex)		Interface Masters, Inc
+000CBD     (base 16)		Interface Masters, Inc
+				2381 Zanker Rd., Suite 130
+				San Jose  California  95131
+				US
+
+00-0C-B2   (hex)		UNION co., ltd.
+000CB2     (base 16)		UNION co., ltd.
+				14Beon-Gil 17, UiChang-Gu,
+				GyeongSnagNam-Do    641-846
+				KR
+
+00-0C-EB   (hex)		CNMP Networks, Inc.
+000CEB     (base 16)		CNMP Networks, Inc.
+				1245 S. Winchester Blvd.
+				San Jose  CA  95128
+				US
+
+00-0C-CC   (hex)		Aeroscout Ltd.
+000CCC     (base 16)		Aeroscout Ltd.
+				3 Pekeris St.
+				Rehovot    76701
+				IL
+
+00-0C-C7   (hex)		Intelligent Computer Solutions Inc.
+000CC7     (base 16)		Intelligent Computer Solutions Inc.
+				9350 Eton St.
+				Chatsworth  CA  91301
+				US
+
+00-0C-BE   (hex)		Innominate Security Technologies AG
+000CBE     (base 16)		Innominate Security Technologies AG
+				Rudower Chaussee 13
+				12489  Berlin  
+				DE
+
+00-0C-A7   (hex)		Metro (Suzhou) Technologies Co., Ltd.
+000CA7     (base 16)		Metro (Suzhou) Technologies Co., Ltd.
+				No.221 Xinghai Street, Suzhou Industrial Park
+				Suzhou  Jiang Su Province  215021
+				CN
+
+00-0C-EF   (hex)		Open Networks Engineering Ltd
+000CEF     (base 16)		Open Networks Engineering Ltd
+				Classic House
+				Bishop's Stortford  Hertfordshire  CM23 5PD
+				GB
+
+00-0C-64   (hex)		X2 MSA Group
+000C64     (base 16)		X2 MSA Group
+				Care of: Agilent Technologies
+				Ipswich,  Suffolk  IP1 5PB
+				GB
+
+00-0C-A0   (hex)		StorCase Technology, Inc.
+000CA0     (base 16)		StorCase Technology, Inc.
+				17600 Newhope St.
+				Fountain Valley  CA  92708
+				US
+
+00-0C-99   (hex)		HITEL LINK Co.,Ltd
+000C99     (base 16)		HITEL LINK Co.,Ltd
+				Samsung Omni Tower 4th Fl., 395-62
+				Seoul    156-010
+				KR
+
+00-0C-5A   (hex)		IBSmm Embedded Electronics Consulting
+000C5A     (base 16)		IBSmm Embedded Electronics Consulting
+				Teufelsgrabenweg 1
+				Valley  Bavaria  D-83626
+				DE
+
+00-0C-5E   (hex)		Calypso Medical
+000C5E     (base 16)		Calypso Medical
+				2101 Fourth Avenue, Suite 1550
+				Seattle  WA  98121
+				US
+
+00-0C-61   (hex)		AC Tech corporation DBA Advanced Digital
+000C61     (base 16)		AC Tech corporation DBA Advanced Digital
+				1250-G Avenida Acaso
+				Camarillo  CA  93010
+				US
+
+00-0C-5F   (hex)		Avtec, Inc.
+000C5F     (base 16)		Avtec, Inc.
+				4335 Augusta Hwy
+				Gilbert  SC  29054
+				US
+
+00-0C-4B   (hex)		Cheops Elektronik
+000C4B     (base 16)		Cheops Elektronik
+				Jeschkenstrasse 32
+				Geretsried  Bayern  82538
+				DE
+
+00-0C-45   (hex)		Animation Technologies Inc.
+000C45     (base 16)		Animation Technologies Inc.
+				8F,No.138,Lane 235,Paochiao Road,
+				Taipei Hsien    231
+				TW
+
+00-0C-3C   (hex)		MediaChorus, Inc.
+000C3C     (base 16)		MediaChorus, Inc.
+				#205, ETRI TBI 2 Center
+				Daejon  DJ  305-333
+				KR
+
+00-0C-7C   (hex)		Internet Information Image Inc.
+000C7C     (base 16)		Internet Information Image Inc.
+				Fl. 6, No. 1, Alley 20, Lane 26, Rueigua
+				Taipei    114
+				TW
+
+00-0C-7B   (hex)		ALPHA PROJECT Co.,Ltd.
+000C7B     (base 16)		ALPHA PROJECT Co.,Ltd.
+				834 Sekishi,Higashi-ku,Hamamatsu-city
+				Shizuoka    431-3114
+				JP
+
+00-0C-77   (hex)		Life Racing Ltd
+000C77     (base 16)		Life Racing Ltd
+				Unit 6 Repton Close
+				Basildon  Essex  SS13 1LE
+				GB
+
+00-0C-69   (hex)		National Radio Astronomy Observatory
+000C69     (base 16)		National Radio Astronomy Observatory
+				P.O. Box O
+				Socorro  NM  87801
+				US
+
+00-0C-66   (hex)		Pronto Networks Inc
+000C66     (base 16)		Pronto Networks Inc
+				4637 Chabot Dr
+				Pleasanton  CA  94588
+				US
+
+00-0C-88   (hex)		Apache Micro Peripherals, Inc.
+000C88     (base 16)		Apache Micro Peripherals, Inc.
+				17526 Von Karman Ave
+				Irvine  CA  92614
+				US
+
+00-0C-82   (hex)		NETWORK TECHNOLOGIES INC
+000C82     (base 16)		NETWORK TECHNOLOGIES INC
+				1275 DANNER DRIVE
+				AURORA  OH  44202
+				US
+
+00-0C-8D   (hex)		MATRIX VISION GmbH
+000C8D     (base 16)		MATRIX VISION GmbH
+				Talstrasse 16
+				Oppenweiler  Baden-Württemberg  D-71570
+				DE
+
+00-0C-89   (hex)		AC Electric Vehicles, Ltd.
+000C89     (base 16)		AC Electric Vehicles, Ltd.
+				Markkinakuja 3
+				Jokela    05400
+				FI
+
+00-0C-4E   (hex)		Winbest Technology CO,LT
+000C4E     (base 16)		Winbest Technology CO,LT
+				7F-5No.736 Chung ChengRd.,ChungHo
+				Taipei    235
+				TW
+
+00-0B-FE   (hex)		CASTEL Broadband Limited
+000BFE     (base 16)		CASTEL Broadband Limited
+				9/F., Sui Ying Industrial Building.,
+				Tokwawan  Kowloon  150
+				HK
+
+00-0B-F5   (hex)		Shanghai Sibo Telecom Technology Co.,Ltd
+000BF5     (base 16)		Shanghai Sibo Telecom Technology Co.,Ltd
+				Floor 6 Building 18,300 Tianlin Rd.
+				Shanghai    200233
+				CN
+
+00-0C-27   (hex)		Sammy Corporation
+000C27     (base 16)		Sammy Corporation
+				SUN SHINE60 45F,3-1-1,HIGASHI-IKEBUKURO
+				TOSHIMA-KU  TOKYO  170-6045
+				JP
+
+00-0C-2A   (hex)		OCTTEL Communication Co., Ltd.
+000C2A     (base 16)		OCTTEL Communication Co., Ltd.
+				7F-1, No.300, Daduen 10th St.
+				Taichung City    408
+				TW
+
+00-0C-1C   (hex)		MicroWeb Co., Ltd.
+000C1C     (base 16)		MicroWeb Co., Ltd.
+				403 T/S/S/C, 23-14 Jang-dong, Yusong-gu,
+				Daejeon  ChoongChungDo  305-343
+				KR
+
+00-0B-DF   (hex)		Shenzhen RouterD Networks Limited
+000BDF     (base 16)		Shenzhen RouterD Networks Limited
+				8/F, Building A, Tsinghua Hi-Tech Park
+				Shenzhen    
+				CN
+
+00-0B-E6   (hex)		Datel Electronics
+000BE6     (base 16)		Datel Electronics
+				Stafford Road
+				Stone  Staffordshire  ST15 0DG
+				GB
+
+00-0B-F2   (hex)		Chih-Kan Technology Co., Ltd.
+000BF2     (base 16)		Chih-Kan Technology Co., Ltd.
+				No. 24-1, Pei Shih Chou, Ming Ho Vill.
+				Shan Sun Hsiang  Tainan Hsien  180
+				TW
+
+00-0B-EB   (hex)		Systegra AG
+000BEB     (base 16)		Systegra AG
+				Burgunderstrasse 15
+				Bellach  SO  4512
+				CH
+
+00-0B-EF   (hex)		Code Corporation
+000BEF     (base 16)		Code Corporation
+				11814 S. Election Rd., Ste 200
+				Draper  Utah  84020
+				US
+
+00-0C-05   (hex)		RPA Reserch Co., Ltd.
+000C05     (base 16)		RPA Reserch Co., Ltd.
+				4F, 90-7, Yangjae-Dong, Seocho-Ku
+				Seoul    137-130
+				US
+
+00-0C-22   (hex)		Double D Electronics Ltd
+000C22     (base 16)		Double D Electronics Ltd
+				Unit 6, Robins Wharf
+				Northfleet  Kent  DA11 9AX
+				GB
+
+00-0C-0F   (hex)		Techno-One Co., Ltd
+000C0F     (base 16)		Techno-One Co., Ltd
+				9-17-1 Higashi Sonoda
+				Amagasaki  Hyogo  661-0953
+				JP
+
+00-0C-38   (hex)		TelcoBridges Inc.
+000C38     (base 16)		TelcoBridges Inc.
+				586 Du Chenal
+				Repentigny  Quebec  J6A 7C5
+				CA
+
+00-0B-AF   (hex)		WOOJU COMMUNICATIONS Co,.Ltd
+000BAF     (base 16)		WOOJU COMMUNICATIONS Co,.Ltd
+				B-713, SK Twin Tech Tower, 345-9, Ga-San
+				Seoul    153-802
+				KR
+
+00-0B-B6   (hex)		Metalligence Technology Corp.
+000BB6     (base 16)		Metalligence Technology Corp.
+				9, Park Avenue II, Science-Based Industr
+				Hsinchu    300
+				TW
+
+00-0B-B3   (hex)		RiT technologies Ltd.
+000BB3     (base 16)		RiT technologies Ltd.
+				24 Raoul Walenberg  St.
+				Tel Aviv    69719
+				IL
+
+00-0B-B7   (hex)		Micro Systems Co.,Ltd.
+000BB7     (base 16)		Micro Systems Co.,Ltd.
+				2-15-34 Nishikubo
+				Musashino-City  Tokyo  180-0013
+				JP
+
+00-0B-BA   (hex)		Harmonic, Inc
+000BBA     (base 16)		Harmonic, Inc
+				4300 North First Street
+				San Jose  CA  95134
+				US
+
+00-0B-62   (hex)		ib-mohnen KG
+000B62     (base 16)		ib-mohnen KG
+				Stich 30 e
+				52249  Eschweiler  
+				DE
+
+00-0B-64   (hex)		Kieback & Peter GmbH & Co KG
+000B64     (base 16)		Kieback & Peter GmbH & Co KG
+				Tempelhofer Weg 50
+				Berlin    12347
+				DE
+
+00-0B-67   (hex)		Topview Technology Corporation
+000B67     (base 16)		Topview Technology Corporation
+				No. 8,Wu-Chuan Road,Wu Ku Industrial Par
+				Wu Ku Hsiang,Taipei Hsien,    248
+				TW
+
+00-0B-7D   (hex)		SOLOMON EXTREME INTERNATIONAL LTD.
+000B7D     (base 16)		SOLOMON EXTREME INTERNATIONAL LTD.
+				3F, No.20, Lane 165, Duenhua N. Rd., Sun
+				Taipei    
+				TW
+
+00-0B-94   (hex)		Digital Monitoring Products, Inc.
+000B94     (base 16)		Digital Monitoring Products, Inc.
+				2500 N. Partnership Boulevard
+				Springfield  Missouri  65803
+				US
+
+00-0B-AE   (hex)		Vitals System Inc.
+000BAE     (base 16)		Vitals System Inc.
+				Jooheung B/D 4FL. 1005-1, Youngtong-Dong
+				Suwon City  Kyonggi-Do  442-813
+				KR
+
+00-0B-D9   (hex)		General Hydrogen
+000BD9     (base 16)		General Hydrogen
+				13120 Vanier Place
+				Richmond  British Columbia  V6V 2J2
+				CA
+
+00-0B-AB   (hex)		Advantech Technology (CHINA) Co., Ltd.
+000BAB     (base 16)		Advantech Technology (CHINA) Co., Ltd.
+				No.666, Han-Pu Rd. Yu-Shan
+				Kun-Shan  Jiang Su  215316
+				CN
+
+00-0B-6D   (hex)		SOLECTRON JAPAN NAKANIIDA
+000B6D     (base 16)		SOLECTRON JAPAN NAKANIIDA
+				325 GANBARA
+				KAMIGUN  MIYAGIKEN  981-4263
+				JP
+
+00-0B-C4   (hex)		BIOTRONIK GmbH & Co
+000BC4     (base 16)		BIOTRONIK GmbH & Co
+				Woermannkehre 1
+				Berlin    12359
+				DE
+
+00-0B-57   (hex)		Silicon Laboratories
+000B57     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+00-0B-51   (hex)		Micetek International Inc.
+000B51     (base 16)		Micetek International Inc.
+				7F-1, #237, Sec. 1, wu Chuan W. Rd.
+				Taichung    403
+				TW
+
+00-0B-53   (hex)		INITIUM Co., Ltd.
+000B53     (base 16)		INITIUM Co., Ltd.
+				8F. Gongduck Bldg. 272-6 Seohyun Bundang
+				Sungnam  Kyunggi  463-824
+				KR
+
+00-0A-FB   (hex)		Ambri Limited
+000AFB     (base 16)		Ambri Limited
+				126 Greville Street
+				Chatswood  NSW  2067
+				AU
+
+00-0A-FF   (hex)		Kilchherr Elektronik AG
+000AFF     (base 16)		Kilchherr Elektronik AG
+				Aeschistrasse 25
+				Muensingen  BE  3110
+				CH
+
+00-0B-4A   (hex)		Visimetrics (UK) Ltd
+000B4A     (base 16)		Visimetrics (UK) Ltd
+				Skye House
+				Prestwick  Ayrshire  KA9 2TA
+				GB
+
+00-0B-48   (hex)		sofrel
+000B48     (base 16)		sofrel
+				2 rue du plessis
+				vern sur seiche  ille et vilaine  35770
+				FR
+
+00-0B-1E   (hex)		KAPPA opto-electronics GmbH
+000B1E     (base 16)		KAPPA opto-electronics GmbH
+				Kleines Feld 6
+				Gleichen  Niedersachsen  
+				DE
+
+00-0B-1C   (hex)		SIBCO bv
+000B1C     (base 16)		SIBCO bv
+				Schoonhout 46
+				Etten-Leur  NB  4872 ME
+				NL
+
+00-0B-37   (hex)		MANUFACTURE DES MONTRES ROLEX SA
+000B37     (base 16)		MANUFACTURE DES MONTRES ROLEX SA
+				LA HAUTE-ROUTE 82
+				BIEL-BIENNE  BE  2502
+				CH
+
+00-0A-F8   (hex)		American Telecare Inc.
+000AF8     (base 16)		American Telecare Inc.
+				7640 Golden Triangle Drive
+				Eden Prairie  MN  55344
+				US
+
+00-0B-17   (hex)		MKS Instruments
+000B17     (base 16)		MKS Instruments
+				651 Lowell Street
+				Methuen  MA  01844
+				US
+
+00-0B-2D   (hex)		Danfoss Inc.
+000B2D     (base 16)		Danfoss Inc.
+				7941 Corporate Dr
+				Baltimore  MD  21236
+				US
+
+00-0A-A3   (hex)		SHIMAFUJI ELECTRIC CO.,LTD.
+000AA3     (base 16)		SHIMAFUJI ELECTRIC CO.,LTD.
+				Daihyaku-seimei Kamata Bldg.3F
+				  Tokyo  144-0051
+				JP
+
+00-0A-A7   (hex)		FEI Electron Optics
+000AA7     (base 16)		FEI Electron Optics
+				Achtseweg Noord 5
+				Eindhoven    5651GG
+				NL
+
+00-0A-A6   (hex)		Hochiki Corporation
+000AA6     (base 16)		Hochiki Corporation
+				246, TSURUMA
+				MACHIDA  TOKYO  194-8577
+				JP
+
+00-0A-9A   (hex)		Aiptek International Inc
+000A9A     (base 16)		Aiptek International Inc
+				No 5-1 Innovation Rd 1
+				Hsin-Chu    300
+				TW
+
+00-0A-94   (hex)		ShangHai cellink CO., LTD
+000A94     (base 16)		ShangHai cellink CO., LTD
+				C3 MeiLong ZhongXin Industrial Park,No.1
+				ShangHai    200237
+				US
+
+00-0A-97   (hex)		SONICblue, Inc.
+000A97     (base 16)		SONICblue, Inc.
+				2841 Mission College Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-0A-92   (hex)		Presonus Corporation
+000A92     (base 16)		Presonus Corporation
+				7257 Florida Blvd.
+				Baton Rouge  Louisiana  70806
+				US
+
+00-0A-85   (hex)		PLAT'C2,Inc
+000A85     (base 16)		PLAT'C2,Inc
+				2-3-6 SOTOKANDA
+				CHIYODA-KU  TOKYO  101-0021
+				JP
+
+00-0A-D0   (hex)		Niigata Develoment Center,  F.I.T. Co., Ltd.
+000AD0     (base 16)		Niigata Develoment Center,  F.I.T. Co., Ltd.
+				Akane-Niigata Building 2F
+				Niigata  Niigata Prefecture  950-0944
+				JP
+
+00-0A-D4   (hex)		CoreBell Systems Inc.
+000AD4     (base 16)		CoreBell Systems Inc.
+				HTVC 2317 KAIST
+				Yuseong-Gu  Daejeon  305-701
+				KR
+
+00-0A-CA   (hex)		YOKOYAMA SHOKAI CO.,Ltd.
+000ACA     (base 16)		YOKOYAMA SHOKAI CO.,Ltd.
+				6-96 Matsumura
+				Kanazawa  Ishikawa  920-0348
+				JP
+
+00-0A-CE   (hex)		RADIANTECH, INC.
+000ACE     (base 16)		RADIANTECH, INC.
+				2-1, INDUSTRY EAST RD. 1, SCIENCE-BASED
+				HSIN CHU    300
+				TW
+
+00-0A-C7   (hex)		Unication Group
+000AC7     (base 16)		Unication Group
+				3F., No. 6, Wu-Kung 5Rd., Hsinchuang Cit
+				Taipei    242
+				TW
+
+00-0A-DE   (hex)		Happy Communication Co., Ltd.
+000ADE     (base 16)		Happy Communication Co., Ltd.
+				42-11 WonMi-Dong
+				Bucheon-City  KyungGi-Do  420-110
+				KR
+
+00-0A-E2   (hex)		Binatone Electronics International, Ltd
+000AE2     (base 16)		Binatone Electronics International, Ltd
+				Floor 23A, 9 Des Voeux Road West
+				Hong Kong  China  
+				HK
+
+00-0A-DB   (hex)		Trilliant
+000ADB     (base 16)		Trilliant
+				401 Harrison Oaks Blvd. Suite 300
+				Cary  NC  27513
+				US
+
+00-0A-B8   (hex)		Cisco Systems, Inc
+000AB8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-AC   (hex)		TerraTec Electronic GmbH
+000AAC     (base 16)		TerraTec Electronic GmbH
+				Herrenpfad 38
+				Nettetal    41334
+				DE
+
+00-0A-BF   (hex)		HIROTA SS
+000ABF     (base 16)		HIROTA SS
+				Matukawa-Kougyoudanchi
+				Suzaka-shi  Nagano  382-0005
+				JP
+
+00-0A-BC   (hex)		Seabridge Ltd.
+000ABC     (base 16)		Seabridge Ltd.
+				3 Hanagar St.
+				Hod-Hasharon  Israel  45241
+				IL
+
+00-0A-50   (hex)		REMOTEK CORPORATION
+000A50     (base 16)		REMOTEK CORPORATION
+				6F-6, No 77, Sec 1, HSIN TAI WU ROAD,
+				HSI-CHIH  TAIPEI HSIEN  221
+				TW
+
+00-0A-58   (hex)		Freyer & Siegel Elektronik GmbH & Co. KG
+000A58     (base 16)		Freyer & Siegel Elektronik GmbH & Co. KG
+				Neuendorfstraße 18 b
+				Hennigsdorf  Brandenburg  16761
+				DE
+
+00-0A-4E   (hex)		UNITEK Electronics INC.
+000A4E     (base 16)		UNITEK Electronics INC.
+				1-18-4
+				Ohta-ku  Tokyo  143-0016
+				US
+
+00-0A-62   (hex)		Crinis Networks, Inc.
+000A62     (base 16)		Crinis Networks, Inc.
+				2099 N. Collins Blvd, Suite 200
+				Richardson  TX  75080
+				US
+
+00-0A-6A   (hex)		SVM Microwaves s.r.o.
+000A6A     (base 16)		SVM Microwaves s.r.o.
+				U Mrazovky 5
+				Praha 5    15000
+				CZ
+
+00-0A-66   (hex)		MITSUBISHI ELECTRIC SYSTEM & SERVICE CO.,LTD.
+000A66     (base 16)		MITSUBISHI ELECTRIC SYSTEM & SERVICE CO.,LTD.
+				1-4-13 OOYODONAKA,KITA-KU
+				OSAKA    531-0076
+				JP
+
+00-0A-31   (hex)		HCV Consulting
+000A31     (base 16)		HCV Consulting
+				P O Box 3692
+				Queensland     4212
+				AU
+
+00-42-52   (hex)		RLX Technologies
+004252     (base 16)		RLX Technologies
+				25231 Grograns Mill Rd
+				The Woodlands  Tx  77380
+				US
+
+00-0A-70   (hex)		MPLS Forum
+000A70     (base 16)		MPLS Forum
+				39355 California Street
+				Fremont  CA  94538
+				US
+
+00-0A-72   (hex)		STEC, INC.
+000A72     (base 16)		STEC, INC.
+				3001 Daimler Street
+				Santa Ana  CA  92705
+				US
+
+00-0A-3D   (hex)		Elo Sistemas Eletronicos S.A.
+000A3D     (base 16)		Elo Sistemas Eletronicos S.A.
+				Rua Edu Chaves, 547
+				Porto Alegre  RS  90.240-620
+				BR
+
+00-0A-46   (hex)		ARO WELDING TECHNOLOGIES SAS
+000A46     (base 16)		ARO WELDING TECHNOLOGIES SAS
+				1, avenue de Tours
+				Chateau du Loir  sarthe  72500
+				FR
+
+00-0A-71   (hex)		Avrio Technologies, Inc
+000A71     (base 16)		Avrio Technologies, Inc
+				2655 A Park Center Drive
+				Simi Valley  CA  91356
+				US
+
+00-0A-64   (hex)		Eracom Technologies
+000A64     (base 16)		Eracom Technologies
+				28 Greg Chappell Drive
+				Burleigh Heads  Qld  4220
+				AU
+
+00-0A-83   (hex)		SALTO SYSTEMS S.L.
+000A83     (base 16)		SALTO SYSTEMS S.L.
+				Arkotz, 9
+				Polígonoo Lanbarren  Oiartzun  20180
+				ES
+
+00-0A-86   (hex)		Lenze
+000A86     (base 16)		Lenze
+				PO box 101352
+				Hameln  Lower Saxony  31763
+				DE
+
+00-0A-3F   (hex)		Data East Corporation
+000A3F     (base 16)		Data East Corporation
+				4-41-10 Minami-Ogikubo
+				Suginami-ku  TOKYO  167-0052
+				JP
+
+00-0A-0C   (hex)		Scientific Research Corporation
+000A0C     (base 16)		Scientific Research Corporation
+				2300 Windy Ridge Parkway
+				Atlanta  GA  30339
+				US
+
+00-09-F6   (hex)		Shenzhen Eastern Digital Tech Ltd.
+0009F6     (base 16)		Shenzhen Eastern Digital Tech Ltd.
+				Shenzhen Futian Chegongmiao Tairan
+				Shenzhen  Guangdong  518048
+				CN
+
+00-0A-20   (hex)		SVA Networks, Inc.
+000A20     (base 16)		SVA Networks, Inc.
+				840 F Ave., Suite 104
+				Plano  TX  75074
+				US
+
+00-0A-24   (hex)		Octave Communications
+000A24     (base 16)		Octave Communications
+				85 Northwest Boulevard
+				Nashua  NH  03063
+				US
+
+00-0A-19   (hex)		Valere Power, Inc.
+000A19     (base 16)		Valere Power, Inc.
+				661 N. Plano Rd.
+				Richardson  Texas  75081
+				US
+
+00-09-E5   (hex)		Hottinger Baldwin Messtechnik GmbH
+0009E5     (base 16)		Hottinger Baldwin Messtechnik GmbH
+				Im Tiefen See 45
+				Darmstadt  Hessen  64293
+				DE
+
+00-09-DE   (hex)		Samjin Information & Communications Co., Ltd.
+0009DE     (base 16)		Samjin Information & Communications Co., Ltd.
+				MajangMyun DukPyungRi 235-2
+				Ichon  KyongGi  467-812
+				KR
+
+00-09-E0   (hex)		XEMICS S.A.
+0009E0     (base 16)		XEMICS S.A.
+				Rue de la Maladiere 71
+				CH-2007 Neuchatel  Neuchatel  2007
+				CH
+
+00-0A-01   (hex)		SOHOware, Inc.
+000A01     (base 16)		SOHOware, Inc.
+				3050 Coronado Drive
+				Santa Clara  CA  95054
+				US
+
+00-09-EC   (hex)		Daktronics, Inc.
+0009EC     (base 16)		Daktronics, Inc.
+				315 32nd Ave
+				Brookings  SD  57006
+				US
+
+00-09-EE   (hex)		MEIKYO ELECTRIC CO.,LTD
+0009EE     (base 16)		MEIKYO ELECTRIC CO.,LTD
+				4-27-2 Higashiogu
+				Arakawa-ku  Tokyo  116-0012
+				JP
+
+00-09-CA   (hex)		iMaxNetworks(Shenzhen)Limited.
+0009CA     (base 16)		iMaxNetworks(Shenzhen)Limited.
+				4/B,South Bldg of 29th,South District of
+				Shenzhen  GuangDong  518057
+				CN
+
+00-09-CF   (hex)		iAd GmbH
+0009CF     (base 16)		iAd GmbH
+				Unterschlauersbacher Hauptstraße 10
+				Grosshabersdorf  Bavaria  90613
+				DE
+
+00-0A-11   (hex)		ExPet Technologies, Inc
+000A11     (base 16)		ExPet Technologies, Inc
+				6F, Kyonggi Small Business Center
+				Suwon, Kyonggi-do, 442-270    442-770
+				KR
+
+00-0A-0F   (hex)		Ilryung Telesys, Inc
+000A0F     (base 16)		Ilryung Telesys, Inc
+				Ilryung bldg, 34-2, Cheonho-dong
+				SEOUL    134-861
+				KR
+
+00-09-E7   (hex)		ADC Techonology
+0009E7     (base 16)		ADC Techonology
+				Sakae Members Office Bld. 4-16-8, Sakae,
+				Nagoya  Aichi  4600008
+				JP
+
+00-09-93   (hex)		Visteon Corporation
+000993     (base 16)		Visteon Corporation
+				16630 Southfield Road
+				Allen Park  Michigan  48101
+				US
+
+00-09-99   (hex)		CP GEORGES RENAULT
+000999     (base 16)		CP GEORGES RENAULT
+				38 Rue Bobby Sands
+				44800  Saint Herblain  
+				FR
+
+00-09-94   (hex)		Cronyx Engineering
+000994     (base 16)		Cronyx Engineering
+				Marshala Sokolovskogo str. 4
+				Moscow    123063
+				RU
+
+00-09-B9   (hex)		Action Imaging Solutions
+0009B9     (base 16)		Action Imaging Solutions
+				Kings Hall, St Ives Business Park
+				Huntingdon  Cambridgeshire  PE27 4WY
+				GB
+
+00-09-AC   (hex)		LANVOICE
+0009AC     (base 16)		LANVOICE
+				1364-39 SeochoDong, #201 Jihun Bldg
+				Seoul    137-072
+				KR
+
+00-09-B1   (hex)		Kanematsu Electronics, Ltd.
+0009B1     (base 16)		Kanematsu Electronics, Ltd.
+				17-5, Kyobashi 2-chome
+				Chuo-ku  Tokyo  104-8338
+				JP
+
+00-09-B0   (hex)		Onkyo Corporation
+0009B0     (base 16)		Onkyo Corporation
+				2-1 Nisshin-cho
+				Neyagawa  Osaka  5728540
+				JP
+
+00-09-79   (hex)		Advanced Television Systems Committee, Inc.
+000979     (base 16)		Advanced Television Systems Committee, Inc.
+				1750 K Street NW
+				Washington  DC  20006
+				US
+
+00-09-63   (hex)		Dominion Lasercom Inc.
+000963     (base 16)		Dominion Lasercom Inc.
+				1716 Briarcrest Dr. Ste. 210
+				Bryan  TX  77802
+				US
+
+00-09-66   (hex)		TRIMBLE EUROPE BV
+000966     (base 16)		TRIMBLE EUROPE BV
+				Meerheide 45
+				Eersel  DZ  5521
+				NL
+
+00-09-C1   (hex)		PROCES-DATA A/S
+0009C1     (base 16)		PROCES-DATA A/S
+				Navervej 8
+				Silkeborg    DK-8600
+				DK
+
+00-09-BB   (hex)		MathStar, Inc.
+0009BB     (base 16)		MathStar, Inc.
+				5900 Green Oak Drive
+				Minneapolis  MN  55343
+				US
+
+00-09-68   (hex)		TECHNOVENTURE, INC.
+000968     (base 16)		TECHNOVENTURE, INC.
+				P. O. Box 5641
+				Pasadena  Texas  77508-5641
+				US
+
+00-09-61   (hex)		Switchgear and Instrumentation Ltd
+000961     (base 16)		Switchgear and Instrumentation Ltd
+				Ripley Road
+				Bradford  West Yorkshire  BD4 7EH
+				GB
+
+00-09-7C   (hex)		Cisco Systems, Inc
+00097C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-7B   (hex)		Cisco Systems, Inc
+00097B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-9D   (hex)		Haliplex Communications
+00099D     (base 16)		Haliplex Communications
+				PO Box 147
+				Mooroolbark  Vic  3138
+				AU
+
+00-09-9E   (hex)		Testech, Inc.
+00099E     (base 16)		Testech, Inc.
+				Bundang-Technopark, C-Dong, 702-Ho, #145
+				Sungnam-City  Kyungki-Do  463-070
+				KR
+
+00-09-88   (hex)		Nudian Electron Co., Ltd.
+000988     (base 16)		Nudian Electron Co., Ltd.
+				797-28 Bangbae-Dong, Seocho-Gu
+				Seoul    137-060
+				KR
+
+00-09-8E   (hex)		ipcas GmbH
+00098E     (base 16)		ipcas GmbH
+				Wetterkreuz 17
+				Erlangen  Bavaria  91058
+				DE
+
+00-09-AB   (hex)		Netcontrol Oy
+0009AB     (base 16)		Netcontrol Oy
+				Karvaamokuja 3
+				Helsinki    FIN 00380
+				FI
+
+00-09-60   (hex)		YOZAN Inc.
+000960     (base 16)		YOZAN Inc.
+				YOZAN Bld.,3-5-18, Kitazawa
+				Setagaya-ku  Tokyo  155-0031
+				JP
+
+00-09-56   (hex)		Network Systems Group, Ltd. (NSG)
+000956     (base 16)		Network Systems Group, Ltd. (NSG)
+				39 Kirpichnaya St., Suite 1302
+				Moscow    105187
+				RU
+
+00-09-00   (hex)		TMT
+000900     (base 16)		TMT
+				11 Kiryat Mada, POB 45199
+				Jerusalem    91450
+				IL
+
+00-09-01   (hex)		Shenzhen Shixuntong Information & Technoligy Co
+000901     (base 16)		Shenzhen Shixuntong Information & Technoligy Co
+				Room 403,617 Bldg;Bagua 1 Road ,Shenzhen
+				Shenzhen  Guangdong  518029
+				CN
+
+00-09-13   (hex)		SystemK Corporation
+000913     (base 16)		SystemK Corporation
+				238-9 Higashi 1, Kita 15, Higashi-ku
+				Sapporo  Hokkaido  065-0015
+				JP
+
+00-09-0E   (hex)		Helix Technology Inc.
+00090E     (base 16)		Helix Technology Inc.
+				5F, No. 6, Sec 1, Jung-Shing Rd., Wugu-S
+				Taipei    248
+				TW
+
+00-09-3C   (hex)		Jacques Technologies P/L
+00093C     (base 16)		Jacques Technologies P/L
+				268 Montague Rd
+				West End  Queensland  4101
+				AU
+
+00-09-35   (hex)		Sandvine Incorporated
+000935     (base 16)		Sandvine Incorporated
+				170 Columbia St. W.
+				Waterloo  ON  N2L 3L3
+				CA
+
+00-09-36   (hex)		Ipetronik GmbH & Co. KG
+000936     (base 16)		Ipetronik GmbH & Co. KG
+				Im Rollfeld 28
+				Baden-Baden  Baden-Württemberg  76532
+				DE
+
+00-09-37   (hex)		Inventec Appliance Corp
+000937     (base 16)		Inventec Appliance Corp
+				113, Wugung 1 RD., WuKu Industrial nPark
+				Taipei    
+				TW
+
+00-09-46   (hex)		Cluster Labs GmbH
+000946     (base 16)		Cluster Labs GmbH
+				Dauerwaldweg 1
+				Berlin  Berlin  14055
+				DE
+
+00-09-3F   (hex)		Double-Win Enterpirse CO., LTD
+00093F     (base 16)		Double-Win Enterpirse CO., LTD
+				NO.300, Sec 1, Chung Feng Rd.
+				Ping Chen City  Taoyuan Hsien  324
+				TW
+
+00-09-48   (hex)		Vista Control Systems, Corp.
+000948     (base 16)		Vista Control Systems, Corp.
+				2001 West Melinda Lane
+				Phoenix  AZ  85027
+				US
+
+00-09-49   (hex)		Glyph Technologies Inc.
+000949     (base 16)		Glyph Technologies Inc.
+				735 W. Clinton Street
+				Ithaca  NY  14850
+				US
+
+00-09-2A   (hex)		MYTECS Co.,Ltd.
+00092A     (base 16)		MYTECS Co.,Ltd.
+				1-12-39, Taishidou
+				Setagaya-ku  Tokyo  154-0004
+				JP
+
+00-09-25   (hex)		VSN Systemen BV
+000925     (base 16)		VSN Systemen BV
+				Keizersveld 83
+				Venray  Limburg  5803 AP
+				NL
+
+00-08-E0   (hex)		ATO Technology Ltd.
+0008E0     (base 16)		ATO Technology Ltd.
+				Rm. 1314-1346, Block B1, Yau Tong Ind. C
+				Hong Kong    
+				HK
+
+00-08-E4   (hex)		Envenergy Inc
+0008E4     (base 16)		Envenergy Inc
+				6307 Carpinteria Ave
+				Carpinteria  CA  93013
+				US
+
+00-08-E3   (hex)		Cisco Systems, Inc
+0008E3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-E5   (hex)		IDK Corporation
+0008E5     (base 16)		IDK Corporation
+				6-7-10
+				Yamato  Kanagawa  242-0007
+				JP
+
+00-08-D9   (hex)		Mitadenshi Co.,LTD
+0008D9     (base 16)		Mitadenshi Co.,LTD
+				1-8-6 Furuichi Asaminamiku
+				Hiroshima    731-0123
+				JP
+
+00-08-91   (hex)		Lyan Inc.
+000891     (base 16)		Lyan Inc.
+				5F-1, NO.51, SEC.2, KEELUNG RD.
+				TAIPEI    110
+				TW
+
+00-08-92   (hex)		EM Solutions
+000892     (base 16)		EM Solutions
+				101 Hyde Rd
+				Yeronga  Brisbane, QLD  4104
+				AU
+
+00-08-8C   (hex)		Quanta Network Systems Inc.
+00088C     (base 16)		Quanta Network Systems Inc.
+				13, 13F, Sec. 2, Pei-Tou Rd
+				Taipei    112
+				TW
+
+00-08-8A   (hex)		Minds@Work
+00088A     (base 16)		Minds@Work
+				15550 Rockfield Blvd. Suite C
+				Irvine  CA  92618
+				US
+
+00-08-FD   (hex)		BlueKorea Co., Ltd.
+0008FD     (base 16)		BlueKorea Co., Ltd.
+				3F, sejong Building, 379-15, Seokyo-Dong
+				Seoul    121-839
+				KR
+
+00-08-F8   (hex)		UTC CCS
+0008F8     (base 16)		UTC CCS
+				791 Commerce Blvd
+				Boca Raton  FL  33497
+				US
+
+00-08-D5   (hex)		Vanguard Networks Solutions, LLC
+0008D5     (base 16)		Vanguard Networks Solutions, LLC
+				25 Forbes Boulevard
+				Foxboro  MA  02035
+				US
+
+00-08-CD   (hex)		With-Net Inc
+0008CD     (base 16)		With-Net Inc
+				4FL B&B B/D 1403-4
+				Anyang  Kyonggi  431-061
+				US
+
+00-08-CC   (hex)		Remotec, Inc.
+0008CC     (base 16)		Remotec, Inc.
+				114 Union Valley Road
+				Oakridge  TN  37830
+				US
+
+00-08-D1   (hex)		KAREL INC.
+0008D1     (base 16)		KAREL INC.
+				ORGANIZE SANAYI BOLGESI
+				ANKARA    06935
+				TR
+
+00-08-A7   (hex)		iLogic Inc.
+0008A7     (base 16)		iLogic Inc.
+				Rm#318, TechnoComplex Bldg., 126-16, 5-g
+				Seoul    136-701
+				KR
+
+00-08-99   (hex)		Netbind, Inc.
+000899     (base 16)		Netbind, Inc.
+				5 Marine View Plaza
+				Hoboken  NJ  07030
+				US
+
+00-08-A0   (hex)		Stotz Feinmesstechnik GmbH
+0008A0     (base 16)		Stotz Feinmesstechnik GmbH
+				Hermann-Dreher Str. 6
+				Gerlingen    70839
+				DE
+
+00-08-BC   (hex)		Ilevo AB
+0008BC     (base 16)		Ilevo AB
+				Box 1561
+				Karlstad  Värmland  S-651 21
+				SE
+
+00-08-BD   (hex)		TEPG-US
+0008BD     (base 16)		TEPG-US
+				100 Simplex Drive
+				Westminster  MA  01441
+				US
+
+00-08-AE   (hex)		PacketFront Network Products AB
+0008AE     (base 16)		PacketFront Network Products AB
+				PO 1217
+				Kistagangen 2, IV  Kista Stockholm SE -16428  
+				SE
+
+00-08-C3   (hex)		Contex A/S
+0008C3     (base 16)		Contex A/S
+				Svanevang 2
+				Allerod  DK  3450
+				DK
+
+00-08-F3   (hex)		WANY
+0008F3     (base 16)		WANY
+				CEEI Cap Alpha
+				Montpellier  Herault  34940
+				FR
+
+00-08-DE   (hex)		3UP Systems
+0008DE     (base 16)		3UP Systems
+				6 Results Way
+				Cupertino  CA  95014
+				US
+
+00-08-22   (hex)		InPro Comm
+000822     (base 16)		InPro Comm
+				11F, No. 93 Shuei-Yuan Street
+				    
+				TW
+
+00-08-23   (hex)		Texa Corp.
+000823     (base 16)		Texa Corp.
+				Nara Bldg. 3F, 2-2-8 Shin-Yokohama,
+				    222-0033
+				JP
+
+00-08-1D   (hex)		Ipsil, Incorporated
+00081D     (base 16)		Ipsil, Incorporated
+				7945 MacArthur Blvd.
+				Cabin John  MD  20818
+				US
+
+00-08-2D   (hex)		Indus Teqsite Private Limited
+00082D     (base 16)		Indus Teqsite Private Limited
+				#7, Arya Gowder Road,
+				Tamil Nadu    600033
+				IN
+
+00-08-20   (hex)		Cisco Systems, Inc
+000820     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-28   (hex)		Koei Engineering Ltd.
+000828     (base 16)		Koei Engineering Ltd.
+				3-40, 5-Chome
+				Osaku    547-0026
+				JP
+
+00-08-24   (hex)		Nuance Document Imaging
+000824     (base 16)		Nuance Document Imaging
+				8390 Mayrand Street
+				Montreal   Quebec  H4P 2C9
+				CA
+
+00-08-6C   (hex)		Plasmon LMS
+00086C     (base 16)		Plasmon LMS
+				4425 ArrowsWest Drive
+				Colorado Springs  CO  80907
+				US
+
+00-08-68   (hex)		PurOptix
+000868     (base 16)		PurOptix
+				1945 Camino Vida Roble
+				Carlsbad  CA  92008
+				US
+
+00-08-69   (hex)		Command-e Technology Co.,Ltd.
+000869     (base 16)		Command-e Technology Co.,Ltd.
+				Suite 1108, Zhongsheng Mansion,
+				Beijing    100038
+				CN
+
+00-08-62   (hex)		NEC Eluminant Technologies, Inc.
+000862     (base 16)		NEC Eluminant Technologies, Inc.
+				14700 Avion Parkway
+				Chantilly  VA  20151
+				US
+
+00-08-03   (hex)		Cos Tron
+000803     (base 16)		Cos Tron
+				4F Boolim B/D, 1431-22,
+				Anyang    431-061
+				KR
+
+00-08-05   (hex)		Techno-Holon Corporation
+000805     (base 16)		Techno-Holon Corporation
+				3-19-2, Takamatsu-cho
+				Tokyo    190-0011
+				JP
+
+00-08-08   (hex)		PPT Vision, Inc.
+000808     (base 16)		PPT Vision, Inc.
+				12988 Valley View Rd.
+				Eden Prairie  MN  55344
+				US
+
+00-08-14   (hex)		TIL Technologies
+000814     (base 16)		TIL Technologies
+				Europark DePichaury, BAT 9
+				    
+				FR
+
+00-08-5C   (hex)		Shanghai Dare Technologies Co. Ltd.
+00085C     (base 16)		Shanghai Dare Technologies Co. Ltd.
+				23F, China Merchants Tower,
+				Pudong New Area,  Shanghai  
+				CN
+
+00-08-2C   (hex)		Homag AG
+00082C     (base 16)		Homag AG
+				Abt. Ess-Mp., Homag Str. 3-5
+				    
+				DE
+
+00-08-21   (hex)		Cisco Systems, Inc
+000821     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-87   (hex)		Maschinenfabrik Reinhausen GmbH
+000887     (base 16)		Maschinenfabrik Reinhausen GmbH
+				Falkensteinstraße 8
+				Regensburg  Bavaria  93059
+				DE
+
+00-08-77   (hex)		Liebert-Hiross Spa
+000877     (base 16)		Liebert-Hiross Spa
+				Via Leonardo da Vinci 8
+				Piove di Sacco  Z.I. Tognana  35020
+				IT
+
+00-08-7B   (hex)		RTX Telecom A/S
+00087B     (base 16)		RTX Telecom A/S
+				Stroemmen 6
+				    
+				DK
+
+00-08-61   (hex)		SoftEnergy Co., Ltd.
+000861     (base 16)		SoftEnergy Co., Ltd.
+				346 Sangwangsipli-Dong,
+				    
+				KR
+
+00-08-4F   (hex)		Qualstar Corporation
+00084F     (base 16)		Qualstar Corporation
+				3990B Heritage Oak Court
+				Simi Valley  CA  93063
+				US
+
+00-08-54   (hex)		Netronix, Inc.
+000854     (base 16)		Netronix, Inc.
+				3F-1, No. 31, Hsin-Tai Road,
+				    
+				TW
+
+00-08-76   (hex)		SDSystem
+000876     (base 16)		SDSystem
+				613,Hyundai I Valley,223-12,
+				Seongnam  Gyeonggi-Do  462-807
+				KR
+
+00-08-70   (hex)		Rasvia Systems, Inc.
+000870     (base 16)		Rasvia Systems, Inc.
+				3255-3 Scott Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-08-6E   (hex)		Hyglo AB
+00086E     (base 16)		Hyglo AB
+				Vastberga alle 60
+				    
+				SE
+
+00-07-FD   (hex)		LANergy Ltd.
+0007FD     (base 16)		LANergy Ltd.
+				Rudloe Manor
+				    
+				GB
+
+00-07-FE   (hex)		Rigaku Corporation
+0007FE     (base 16)		Rigaku Corporation
+				3-9-12, Matsubara-cho
+				Tokyo    196-8666
+				JP
+
+00-04-7D   (hex)		Pelco
+00047D     (base 16)		Pelco
+				3500 Pelco Way
+				Clovis  CA  93612
+				US
+
+00-07-BF   (hex)		Armillaire Technologies, Inc.
+0007BF     (base 16)		Armillaire Technologies, Inc.
+				10411 Motor City Drive
+				Bethesda  MD  20817
+				US
+
+00-07-BB   (hex)		Candera Inc.
+0007BB     (base 16)		Candera Inc.
+				673 South Milpitas Blvd.
+				Milpitas  CA  95035
+				US
+
+00-07-BD   (hex)		Radionet Ltd.
+0007BD     (base 16)		Radionet Ltd.
+				Keilaranta 6
+				    
+				FI
+
+00-07-C4   (hex)		JEAN Co. Ltd.
+0007C4     (base 16)		JEAN Co. Ltd.
+				7F, 2, Rei Kuang Road,
+				Taipei    
+				TW
+
+00-07-B6   (hex)		Telecom Technology Ltd.
+0007B6     (base 16)		Telecom Technology Ltd.
+				Docklands Innovation Park
+				Dublin 3    
+				IE
+
+00-07-B7   (hex)		Samurai Ind. Prods Eletronicos Ltda
+0007B7     (base 16)		Samurai Ind. Prods Eletronicos Ltda
+				R-Nebraska, 443 S/2 2o Andar
+				    04560-011
+				BR
+
+00-07-B0   (hex)		Office Details, Inc.
+0007B0     (base 16)		Office Details, Inc.
+				25 Ottawa
+				Grand Rapids  MI  49503
+				US
+
+00-07-D9   (hex)		Splicecom
+0007D9     (base 16)		Splicecom
+				Little Gillions, The Green
+				Herts    WD3 3HY
+				GB
+
+00-07-DA   (hex)		Neuro Telecom Co., Ltd.
+0007DA     (base 16)		Neuro Telecom Co., Ltd.
+				2F Misung B/D, 938-7
+				Kyunggi-do    
+				KR
+
+00-07-CD   (hex)		Kumoh Electronic Co, Ltd
+0007CD     (base 16)		Kumoh Electronic Co, Ltd
+				154-2 Chunui-dong
+				Gyeonggi-do    
+				KR
+
+00-07-CF   (hex)		Anoto AB
+0007CF     (base 16)		Anoto AB
+				Solvegatan 41
+				    
+				SE
+
+00-07-D2   (hex)		Logopak Systeme GmbH & Co. KG
+0007D2     (base 16)		Logopak Systeme GmbH & Co. KG
+				Dorfstraße 40
+				    
+				DE
+
+00-07-C9   (hex)		Technol Seven Co., Ltd.
+0007C9     (base 16)		Technol Seven Co., Ltd.
+				25-16 Tobehon-cho, Nisi-ku,
+				    
+				JP
+
+00-07-C7   (hex)		Synectics Systems Limited
+0007C7     (base 16)		Synectics Systems Limited
+				3 Acorn Business Park
+				    S8 OTB
+				GB
+
+00-07-C3   (hex)		Thomson
+0007C3     (base 16)		Thomson
+				5-7, rue Salomon de Rothschild
+				    92150
+				FR
+
+00-07-A5   (hex)		Y.D.K Co. Ltd.
+0007A5     (base 16)		Y.D.K Co. Ltd.
+				1705, Oshitate, Inagi-City,
+				    
+				JP
+
+00-07-9C   (hex)		Golden Electronics Technology Co., Ltd.
+00079C     (base 16)		Golden Electronics Technology Co., Ltd.
+				No. 29, 21st Road,
+				    
+				TW
+
+00-07-E4   (hex)		SoftRadio Co., Ltd.
+0007E4     (base 16)		SoftRadio Co., Ltd.
+				2F, Dong-Bok B/D 645-18
+				Seoul    
+				KR
+
+00-07-8E   (hex)		Garz & Friche GmbH
+00078E     (base 16)		Garz & Friche GmbH
+				Tempowerhving 4
+				    
+				DE
+
+00-07-54   (hex)		Xyterra Computing, Inc.
+000754     (base 16)		Xyterra Computing, Inc.
+				14505 Hayden Rd.,
+				Scottsdale  AZ  85260-6953
+				US
+
+00-07-57   (hex)		Topcall International AG
+000757     (base 16)		Topcall International AG
+				Talpagasse 1
+				    
+				AT
+
+00-07-53   (hex)		Beijing Qxcomm Technology Co., Ltd.
+000753     (base 16)		Beijing Qxcomm Technology Co., Ltd.
+				4F Tower B, TongTai Building No. 33,
+				Beijing 100032    
+				CN
+
+00-07-4C   (hex)		Beicom Inc.
+00074C     (base 16)		Beicom Inc.
+				114 King Street
+				Alexandria  VA  22314
+				US
+
+00-07-4D   (hex)		Zebra Technologies Corp.
+00074D     (base 16)		Zebra Technologies Corp.
+				333 Corporate Woods Parkway
+				Vernon Hills  IL  60061
+				US
+
+00-07-32   (hex)		AAEON Technology Inc.
+000732     (base 16)		AAEON Technology Inc.
+				5F, #135, Lane 235, Pao Chiao Road
+				Taipei    
+				TW
+
+00-07-25   (hex)		Bematech International Corp.
+000725     (base 16)		Bematech International Corp.
+				5895 Shiloh Road
+				Alpharetta  GA  30005
+				US
+
+00-07-23   (hex)		ELCON Systemtechnik GmbH
+000723     (base 16)		ELCON Systemtechnik GmbH
+				Obere Hauptstraße10
+				    
+				DE
+
+00-07-1D   (hex)		Satelsa Sistemas Y Aplicaciones De Telecomunicaciones, S.A.
+00071D     (base 16)		Satelsa Sistemas Y Aplicaciones De Telecomunicaciones, S.A.
+				c/, Alejandro Moran, 56
+				    
+				ES
+
+00-07-20   (hex)		Trutzschler GmbH & Co. KG
+000720     (base 16)		Trutzschler GmbH & Co. KG
+				Duvenstraße 82-92
+				    
+				DE
+
+00-07-6E   (hex)		Sinetica Corporation Limited
+00076E     (base 16)		Sinetica Corporation Limited
+				Willow House
+				Monmouthshire  Usk  NP15 1HY
+				GB
+
+00-07-6F   (hex)		Synoptics Limited
+00076F     (base 16)		Synoptics Limited
+				Beacon House, Nuffield Road,
+				    
+				GB
+
+00-07-73   (hex)		Ascom Powerline Communications Ltd.
+000773     (base 16)		Ascom Powerline Communications Ltd.
+				Belpstr. 37
+				    
+				CH
+
+00-07-6C   (hex)		Daehanet, Inc.
+00076C     (base 16)		Daehanet, Inc.
+				#8-2 Chung Jung Rd 2- Ga
+				Seoul    120-012
+				KR
+
+00-07-5D   (hex)		Celleritas Inc.
+00075D     (base 16)		Celleritas Inc.
+				c/o Celeritas Ltd.
+				    
+				IL
+
+00-07-3F   (hex)		Woojyun Systec Co., Ltd.
+00073F     (base 16)		Woojyun Systec Co., Ltd.
+				4F Han Yang B/D, Yoido-dong
+				Seoul    150-010
+				KR
+
+00-07-28   (hex)		Neo Telecom
+000728     (base 16)		Neo Telecom
+				East Building 9F, 1T
+				Songpa-gu, Seoul    
+				KR
+
+00-07-2C   (hex)		Fabricom
+00072C     (base 16)		Fabricom
+				Rue Gatti De Gamond 254
+				    
+				BE
+
+00-07-2D   (hex)		CNSystems
+00072D     (base 16)		CNSystems
+				Baumkircherstrasse 1
+				    
+				AT
+
+00-07-2F   (hex)		Intransa, Inc.
+00072F     (base 16)		Intransa, Inc.
+				2670 Zanker
+				San Jose  CA  95134
+				US
+
+00-07-80   (hex)		Bluegiga Technologies OY
+000780     (base 16)		Bluegiga Technologies OY
+				P.O. BOX 120
+				FIN-02631  Espoo  
+				FI
+
+00-07-77   (hex)		Motah Ltd.
+000777     (base 16)		Motah Ltd.
+				4-4-5 Koishikawa
+				    112-0002
+				JP
+
+00-07-24   (hex)		Telemax Co., Ltd.
+000724     (base 16)		Telemax Co., Ltd.
+				6th Fl. Sungwoo B/D, 1099-1
+				Kyungki-Do,    435-040
+				KR
+
+00-07-1B   (hex)		CDVI Americas Ltd
+00071B     (base 16)		CDVI Americas Ltd
+				1637 Autoroute Laval West
+				Laval  Quebec  H7L 3W3
+				CA
+
+00-07-15   (hex)		General Research of Electronics, Inc.
+000715     (base 16)		General Research of Electronics, Inc.
+				3-12-17, Mita, Minato-ku
+				Tokyo    108-0073
+				JP
+
+00-07-37   (hex)		Soriya Co. Ltd.
+000737     (base 16)		Soriya Co. Ltd.
+				2, 8th Floor Hanshin B/O, 136-1,
+				Seoul,    
+				KR
+
+00-07-34   (hex)		ONStor, Inc.
+000734     (base 16)		ONStor, Inc.
+				130-B Knowles Drive
+				Los Gatos  CA  95032
+				US
+
+00-07-65   (hex)		Jade Quantum Technologies, Inc.
+000765     (base 16)		Jade Quantum Technologies, Inc.
+				5F, No. 116, Hsien Fu Rd.,
+				    
+				TW
+
+00-05-EA   (hex)		Rednix
+0005EA     (base 16)		Rednix
+				502, Dong-A Resort Officetel
+				Taejon    305-709
+				KR
+
+00-06-C9   (hex)		Technical Marketing Research, Inc.
+0006C9     (base 16)		Technical Marketing Research, Inc.
+				Shin Nihon Gijutsu Bldg.
+				Tokyo 105-0012    105-0012
+				JP
+
+00-06-C8   (hex)		Sumitomo Metal Micro Devices, Inc.
+0006C8     (base 16)		Sumitomo Metal Micro Devices, Inc.
+				1, Higashimukojima Higashino-cho
+				    
+				JP
+
+00-06-F1   (hex)		Optillion
+0006F1     (base 16)		Optillion
+				Kronborgsgr.9
+				    
+				SE
+
+00-06-A7   (hex)		Primarion
+0006A7     (base 16)		Primarion
+				3450 Torrance Blvd.
+				Torrance  CA  90503
+				US
+
+00-06-A9   (hex)		Universal Instruments Corp.
+0006A9     (base 16)		Universal Instruments Corp.
+				PO Box 825
+				Binghamton  NY  13902
+				US
+
+00-06-9E   (hex)		UNIQA, Inc.
+00069E     (base 16)		UNIQA, Inc.
+				477 Valley Way
+				Milpitas  CA  95035
+				US
+
+00-06-B1   (hex)		Sonicwall
+0006B1     (base 16)		Sonicwall
+				1160 Bordeaux Dr.
+				Sunnyvale  CA  94089
+				US
+
+00-06-AD   (hex)		KB Electronics Ltd.
+0006AD     (base 16)		KB Electronics Ltd.
+				150 Bluewater Rd.
+				    B4B 1G9
+				CA
+
+00-06-AF   (hex)		Xalted Networks
+0006AF     (base 16)		Xalted Networks
+				2901 Dallas Parkway
+				Plano  TX  75093
+				US
+
+00-06-D7   (hex)		Cisco Systems, Inc
+0006D7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-D5   (hex)		Diamond Systems Corp.
+0006D5     (base 16)		Diamond Systems Corp.
+				8430-D Central Ave.
+				Newark  CA  94560
+				US
+
+00-06-FD   (hex)		Comjet Information Systems Corp.
+0006FD     (base 16)		Comjet Information Systems Corp.
+				7Fl., No. 103, Fen Liao Street
+				    
+				TW
+
+00-06-F9   (hex)		Mitsui Zosen Systems Research Inc.
+0006F9     (base 16)		Mitsui Zosen Systems Research Inc.
+				11-1, Uno 1-chome
+				    706-0011
+				JP
+
+00-06-C0   (hex)		United Internetworks, Inc.
+0006C0     (base 16)		United Internetworks, Inc.
+				5072 North 300 West, Suite 2N
+				Provo  UT  84604
+				US
+
+00-06-E0   (hex)		MAT Co., Ltd.
+0006E0     (base 16)		MAT Co., Ltd.
+				864-3 Kwanyang-dong
+				Kyunggi-do    431-060
+				KR
+
+00-D0-B9   (hex)		MICROTEK INTERNATIONAL, INC.
+00D0B9     (base 16)		MICROTEK INTERNATIONAL, INC.
+				NO. 6 INDUSTRY EAST ROAD 3
+				TAIWAN 30077  TAIWAN 30077  R.O.C.
+				TW
+
+00-D0-5F   (hex)		VALCOM, INC.
+00D05F     (base 16)		VALCOM, INC.
+				1111 INDUSTRY AVENUE
+				ROANOKE  VA  24013
+				US
+
+00-06-75   (hex)		Banderacom, Inc.
+000675     (base 16)		Banderacom, Inc.
+				9211 Waterford Centre Blvd.
+				Austin  TX  78758
+				US
+
+00-06-98   (hex)		egnite GmbH
+000698     (base 16)		egnite GmbH
+				Erinstraße 9
+				Castrop-Rauxel    D-44575
+				DE
+
+00-06-9C   (hex)		Transmode Systems AB
+00069C     (base 16)		Transmode Systems AB
+				Jakobsdalsvagen 17
+				  Hägersten  SE-126 53
+				SE
+
+00-06-43   (hex)		SONO Computer Co., Ltd.
+000643     (base 16)		SONO Computer Co., Ltd.
+				1F., No. 8, Alley 35, Lane 91,
+				Taipei    
+				TW
+
+00-06-49   (hex)		3M Deutschland GmbH
+000649     (base 16)		3M Deutschland GmbH
+				Carl-Schurz-Str. 1
+				Neuss    D-41453
+				DE
+
+00-06-3E   (hex)		Opthos Inc.
+00063E     (base 16)		Opthos Inc.
+				590 Taylor Way
+				San Carlos  CA  94070
+				US
+
+00-06-3B   (hex)		Arcturus Networks Inc.
+00063B     (base 16)		Arcturus Networks Inc.
+				701 Evans Ave. - Suite 300
+				Toronto  Ontario  M9C 1A3
+				CA
+
+00-06-7B   (hex)		Toplink C&C Corporation
+00067B     (base 16)		Toplink C&C Corporation
+				6F-15, No. 12, Lane 609, Sec. 5
+				Taipei Hsien 241    
+				TW
+
+00-06-70   (hex)		Upponetti Oy
+000670     (base 16)		Upponetti Oy
+				Tykistokatu 4D
+				    
+				FI
+
+00-06-6F   (hex)		Korea Data Systems
+00066F     (base 16)		Korea Data Systems
+				170, Gongdan-Dong, Gumi-Si
+				Kyungbuk    730-030
+				KR
+
+00-06-68   (hex)		Vicon Industries Inc.
+000668     (base 16)		Vicon Industries Inc.
+				89 Arkay Drive
+				Hauppauge  NY  11788
+				US
+
+00-06-6D   (hex)		Compuprint S.P.A.
+00066D     (base 16)		Compuprint S.P.A.
+				Via Martiri D'Italia 26
+				    
+				IT
+
+00-06-26   (hex)		MWE GmbH
+000626     (base 16)		MWE GmbH
+				Olbrichtstraße 21
+				    
+				DE
+
+00-06-20   (hex)		Serial System Ltd.
+000620     (base 16)		Serial System Ltd.
+				76 Playfair Road
+				    367996
+				SG
+
+00-06-18   (hex)		DigiPower Manufacturing Inc.
+000618     (base 16)		DigiPower Manufacturing Inc.
+				No. 114, Floor 13, Sec. 1,
+				Taipei    
+				TW
+
+00-06-33   (hex)		Cross Match Technologies GmbH
+000633     (base 16)		Cross Match Technologies GmbH
+				Unstrutweg 4
+				  Jena  07743
+				DE
+
+00-06-86   (hex)		ZARDCOM Co., Ltd.
+000686     (base 16)		ZARDCOM Co., Ltd.
+				4F, 1548-1, Seocho Dong, Seocho-Gu
+				Seoul    
+				KR
+
+00-06-89   (hex)		yLez Technologies Pte Ltd
+000689     (base 16)		yLez Technologies Pte Ltd
+				No. 1, Tannery Road, Cencon 1,
+				    
+				SG
+
+00-06-81   (hex)		Goepel Electronic GmbH
+000681     (base 16)		Goepel Electronic GmbH
+				Goeschwitzer Str. 58-60
+				    
+				DE
+
+00-06-58   (hex)		Helmut Fischer GmbH Institut für Elektronik und Messtechnik
+000658     (base 16)		Helmut Fischer GmbH Institut für Elektronik und Messtechnik
+				Industriestraße 21
+				    
+				DE
+
+00-05-D3   (hex)		eProduction Solutions, Inc.
+0005D3     (base 16)		eProduction Solutions, Inc.
+				22001 North Park Drive
+				Kingwood  TX  77339-3804
+				US
+
+00-06-04   (hex)		@Track Communications, Inc.
+000604     (base 16)		@Track Communications, Inc.
+				1155 Kas Dr.
+				Richardson  TX  75081
+				US
+
+00-06-06   (hex)		RapidWAN, Inc.
+000606     (base 16)		RapidWAN, Inc.
+				2085 Hamilton Ave.
+				San Jose  CA  95125
+				US
+
+00-06-03   (hex)		Baker Hughes Inc.
+000603     (base 16)		Baker Hughes Inc.
+				2001 Rankin Rd.
+				Houston  TX  77073
+				US
+
+00-06-07   (hex)		Omni Directional Control Technology Inc.
+000607     (base 16)		Omni Directional Control Technology Inc.
+				8F-2, No. 94, Pao-Chung Rd.
+				Taipei  Hsien,  
+				TW
+
+00-05-F7   (hex)		Analog Devices, Inc.
+0005F7     (base 16)		Analog Devices, Inc.
+				Three Technology Way
+				Norwood   MA  02062-2666
+				US
+
+00-05-9C   (hex)		Kleinknecht GmbH, Ing. Büro
+00059C     (base 16)		Kleinknecht GmbH, Ing. Büro
+				Bachstraße 30
+				    
+				DE
+
+00-05-AE   (hex)		Mediaport USA
+0005AE     (base 16)		Mediaport USA
+				17151 Newhope Ave. #202
+				Fountain Valley  CA  92708
+				US
+
+00-05-B0   (hex)		Korea Computer Technology Co., Ltd.
+0005B0     (base 16)		Korea Computer Technology Co., Ltd.
+				KCT Bldg, 111-3 Yangjae-Dong,
+				    
+				KR
+
+00-05-B2   (hex)		Medison Co., Ltd.
+0005B2     (base 16)		Medison Co., Ltd.
+				997-4, Saechi-Dong,
+				    135-280
+				KR
+
+00-05-97   (hex)		Eagle Traffic Control Systems
+000597     (base 16)		Eagle Traffic Control Systems
+				8004 Cameron Road
+				Austin  TX  78754
+				US
+
+00-05-B5   (hex)		Broadcom Technologies
+0005B5     (base 16)		Broadcom Technologies
+				137-060
+				Secho-Gu  Seoul,  
+				KR
+
+00-05-CB   (hex)		ROIS Technologies, Inc.
+0005CB     (base 16)		ROIS Technologies, Inc.
+				6th F Changhyun B/D, 960-1
+				    431-080
+				KR
+
+00-05-C8   (hex)		VERYTECH
+0005C8     (base 16)		VERYTECH
+				#402, Jang Young Shil Kwan,
+				    
+				KR
+
+00-05-CD   (hex)		D&M Holdings Inc.
+0005CD     (base 16)		D&M Holdings Inc.
+				D&M Building, 2-1 Nisshin-cho
+				Kawasaki-shi  Kanagawa   210-8569
+				JP
+
+00-05-A2   (hex)		CELOX Networks
+0005A2     (base 16)		CELOX Networks
+				940 West Port Plaza - Ste. #300
+				St. Louis  MO  63146
+				US
+
+00-05-AA   (hex)		Moore Industries International Inc.
+0005AA     (base 16)		Moore Industries International Inc.
+				16650 Schoenborn St.
+				North Hills  CA  91343
+				US
+
+00-05-E7   (hex)		Netrake an AudioCodes Company
+0005E7     (base 16)		Netrake an AudioCodes Company
+				3000 Technology Drive
+				Plano  TX  75074
+				US
+
+00-05-F4   (hex)		System Base Co., Ltd.
+0005F4     (base 16)		System Base Co., Ltd.
+				475-22, BangBae 2 dong,
+				    
+				KR
+
+00-05-E1   (hex)		Trellis Photonics, Ltd.
+0005E1     (base 16)		Trellis Photonics, Ltd.
+				P.O.B. 36
+				    
+				IL
+
+00-05-E2   (hex)		Creativ Network Technologies
+0005E2     (base 16)		Creativ Network Technologies
+				1755 St. Regis Suite 240
+				  Quebec  H9B-2M9
+				CA
+
+00-06-13   (hex)		Kawasaki Microelectronics Incorporated
+000613     (base 16)		Kawasaki Microelectronics Incorporated
+				MTG B-5, 1-3, Nakase,
+				Mihama-ku  Chiba  261-8501
+				JP
+
+00-06-17   (hex)		Redswitch Inc.
+000617     (base 16)		Redswitch Inc.
+				1815 McCandless Drive
+				Milpitas  CA  95035-8046
+				US
+
+00-05-51   (hex)		F & S Elektronik Systeme GmbH
+000551     (base 16)		F & S Elektronik Systeme GmbH
+				Untere Waldplaetze 23
+				Stuttgart    70569
+				DE
+
+00-05-4D   (hex)		Brans Technologies, Inc.
+00054D     (base 16)		Brans Technologies, Inc.
+				501 Boramae Academy Tower
+				    
+				KR
+
+00-05-47   (hex)		Starent Networks
+000547     (base 16)		Starent Networks
+				30 International Place
+				Tewksbury  MA  01876
+				US
+
+00-05-4E   (hex)		Philips
+00054E     (base 16)		Philips
+				1000 West Maude Avenue
+				Sunnyvale  CA  94085-2810
+				US
+
+00-05-46   (hex)		KDDI Network & Solultions Inc.
+000546     (base 16)		KDDI Network & Solultions Inc.
+				2-3-1, Nishishinjunku-ku,
+				  Tokyo  163-0907
+				JP
+
+00-05-40   (hex)		FAST Corporation
+000540     (base 16)		FAST Corporation
+				2791-5 Shimo-Tsuruma
+				    242-0001
+				JP
+
+00-05-3C   (hex)		XIRCOM
+00053C     (base 16)		XIRCOM
+				2300 CORPORATE CENTER DR.
+				THOUSAND OAKS  CA  91320
+				US
+
+00-05-44   (hex)		Valley Technologies, Inc.
+000544     (base 16)		Valley Technologies, Inc.
+				1006 West College Ave.
+				State College  PA  16801
+				US
+
+00-05-2E   (hex)		Cinta Networks
+00052E     (base 16)		Cinta Networks
+				3010 North First Street
+				San Jose  CA  95134
+				US
+
+00-05-2F   (hex)		Leviton Network Solutions
+00052F     (base 16)		Leviton Network Solutions
+				2222 222nd Street S.E.
+				Bothell  WA  98021
+				US
+
+00-05-3B   (hex)		Harbour Networks Ltd., Co. Beijing
+00053B     (base 16)		Harbour Networks Ltd., Co. Beijing
+				13/F, JiuLing Building, No. 21,
+				    100089
+				CN
+
+00-05-28   (hex)		New Focus, Inc.
+000528     (base 16)		New Focus, Inc.
+				2630 Walsh Ave.
+				Santa Clara  CA  95051
+				US
+
+00-05-6B   (hex)		C.P. Technology Co., Ltd.
+00056B     (base 16)		C.P. Technology Co., Ltd.
+				12F, No. 86, Hsin Tai Wu Rd.,
+				    221
+				TW
+
+00-05-60   (hex)		LEADER COMM.CO., LTD
+000560     (base 16)		LEADER COMM.CO., LTD
+				234, Komae-ri, Kiheung-eup,
+				    449-900
+				KR
+
+00-05-5E   (hex)		Cisco Systems, Inc
+00055E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-96   (hex)		Genotech Co., Ltd.
+000596     (base 16)		Genotech Co., Ltd.
+				#308 Gunkook Bldg.,
+				Gumchon-Gu  Seoul  
+				KR
+
+00-05-79   (hex)		Universal Control Solution Corp.
+000579     (base 16)		Universal Control Solution Corp.
+				12843 Foothill Blvd.
+				Sylmar  CA  91342
+				US
+
+00-05-7F   (hex)		Acqis Technology
+00057F     (base 16)		Acqis Technology
+				1621 West El Camino Real
+				Mt. View  CA  94040
+				US
+
+00-05-73   (hex)		Cisco Systems, Inc
+000573     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-75   (hex)		CDS-Electronics BV
+000575     (base 16)		CDS-Electronics BV
+				Mozart laan 330
+				    
+				NL
+
+00-05-56   (hex)		360 Systems
+000556     (base 16)		360 Systems
+				31355 Agoura Road
+				Westlake Village  CA  91361
+				US
+
+00-05-59   (hex)		Intracom S.A.
+000559     (base 16)		Intracom S.A.
+				19 5 KM Markopoulou Ave.
+				Attika    
+				GR
+
+00-05-8C   (hex)		Opentech Inc.
+00058C     (base 16)		Opentech Inc.
+				6F, DongWon Bldg., 275
+				Seoul    137-130
+				KR
+
+00-04-C9   (hex)		Micro Electron Co., Ltd.
+0004C9     (base 16)		Micro Electron Co., Ltd.
+				13-1-205 Aobaokakita
+				Suita-city  Osaka  
+				JP
+
+00-04-BE   (hex)		OptXCon, Inc.
+0004BE     (base 16)		OptXCon, Inc.
+				P.O. Box 13449
+				Research Triangle Park  NC  27709-3449
+				US
+
+00-04-C4   (hex)		Audiotonix Group Limited
+0004C4     (base 16)		Audiotonix Group Limited
+				Unit 10, Silverglade Business Park
+				Chessington  Surrey  KT9 2QL
+				GB
+
+00-04-C1   (hex)		Cisco Systems, Inc
+0004C1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-D6   (hex)		Takagi Industrial Co., Ltd.
+0004D6     (base 16)		Takagi Industrial Co., Ltd.
+				Electronic Instrument Div.
+				418-0103  418-0103  
+				JP
+
+00-04-D1   (hex)		Drew Technologies, Inc.
+0004D1     (base 16)		Drew Technologies, Inc.
+				3915 Research Park Dr
+				Ann Arbor  MI  48108
+				US
+
+00-04-D0   (hex)		Softlink s.r.o.
+0004D0     (base 16)		Softlink s.r.o.
+				Tomkova 409
+				  Czech  Republic
+				CZ
+
+00-80-87   (hex)		OKI ELECTRIC INDUSTRY CO., LTD
+008087     (base 16)		OKI ELECTRIC INDUSTRY CO., LTD
+				10-3 SHIBAURA 4-CHOME
+				    
+				JP
+
+00-04-D9   (hex)		Titan Electronics, Inc.
+0004D9     (base 16)		Titan Electronics, Inc.
+				Rm 7, 11 Fl., No. 398,
+				Taoyuan  Taoyuan  TAIWAN
+				TW
+
+00-04-D8   (hex)		IPWireless, Inc.
+0004D8     (base 16)		IPWireless, Inc.
+				4 Landsowne Court
+				SN14  GRZ  UK
+				GB
+
+00-05-24   (hex)		BTL System (HK) Limited
+000524     (base 16)		BTL System (HK) Limited
+				14/F., Blk. B, Vita Tower,
+				Aberdeen    
+				HK
+
+00-05-22   (hex)		LEA*D Corporation, Inc.
+000522     (base 16)		LEA*D Corporation, Inc.
+				Advatech Bldg.
+				    
+				IL
+
+00-05-20   (hex)		Smartronix, Inc.
+000520     (base 16)		Smartronix, Inc.
+				22685 Three Notch Rd.
+				California  MD  20619
+				US
+
+00-04-EB   (hex)		Paxonet Communications, Inc.
+0004EB     (base 16)		Paxonet Communications, Inc.
+				4046 Clipper Court
+				Fremont  CA  94538
+				US
+
+00-04-EF   (hex)		Polestar Corp.
+0004EF     (base 16)		Polestar Corp.
+				RM #802 SeoGeon B/D, 1480,
+				  Korea  (ROK)
+				KR
+
+00-05-14   (hex)		KDT Systems Co., Ltd.
+000514     (base 16)		KDT Systems Co., Ltd.
+				102-6, Chobu-Li, Mohyun-Myun,
+				    
+				KR
+
+00-05-0B   (hex)		SICOM Systems, Inc.
+00050B     (base 16)		SICOM Systems, Inc.
+				4140 Skyron Drive
+				Doylestown  PA  18901
+				US
+
+00-05-05   (hex)		Systems Integration Solutions, Inc.
+000505     (base 16)		Systems Integration Solutions, Inc.
+				3922 Coconut Palm Drive,
+				Tampa  FL  33619
+				US
+
+00-04-FE   (hex)		Pelago Networks
+0004FE     (base 16)		Pelago Networks
+				701 E. Plano Parkway - Ste. #205
+				Plano  TX  75074
+				US
+
+00-05-18   (hex)		Jupiters Technology
+000518     (base 16)		Jupiters Technology
+				PO Box 12693
+				    
+				AU
+
+00-04-B7   (hex)		AMB i.t. Holding
+0004B7     (base 16)		AMB i.t. Holding
+				Zuiderhoutlaan 4
+				  PJ Haarlem  2012
+				NL
+
+00-04-B9   (hex)		S.I. Soubou, Inc.
+0004B9     (base 16)		S.I. Soubou, Inc.
+				4-2586-8
+				Tokorozawa  Sitama  359-0047
+				JP
+
+00-04-BB   (hex)		Bardac Corporation
+0004BB     (base 16)		Bardac Corporation
+				40 Log Canoe Circle
+				Stevensville  MD  21666
+				US
+
+00-04-BC   (hex)		Giantec, Inc.
+0004BC     (base 16)		Giantec, Inc.
+				4F, No. 3, Lane 123,
+				TAIWAN 231  TAIWAN 231  R.O.C.
+				TW
+
+00-04-AF   (hex)		Digital Fountain, Inc.
+0004AF     (base 16)		Digital Fountain, Inc.
+				600 Alabama St.
+				San Francisco  CA  94110
+				US
+
+00-04-56   (hex)		Cambium Networks Limited
+000456     (base 16)		Cambium Networks Limited
+				Unit B2, Linhay Business Park,
+				Ashburton  Devon  TQ13 7UP
+				GB
+
+00-04-58   (hex)		Fusion X Co., Ltd.
+000458     (base 16)		Fusion X Co., Ltd.
+				#905 Hansol Techno Town
+				  Zip  435-030
+				KR
+
+00-04-4F   (hex)		Schubert System Elektronik Gmbh
+00044F     (base 16)		Schubert System Elektronik Gmbh
+				Rudolf-Diesel-Str. 17
+				    
+				DE
+
+00-04-46   (hex)		CYZENTECH Co., Ltd.
+000446     (base 16)		CYZENTECH Co., Ltd.
+				601 Eunkyeong B/D 141-31,
+				  135-876  KOREA
+				KR
+
+00-04-4A   (hex)		iPolicy Networks, Inc.
+00044A     (base 16)		iPolicy Networks, Inc.
+				47467 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-04-40   (hex)		cyberPIXIE, Inc.
+000440     (base 16)		cyberPIXIE, Inc.
+				68 E. Wacker Place,
+				Chicago  IL  60601
+				US
+
+00-04-3C   (hex)		SONOS Co., Ltd.
+00043C     (base 16)		SONOS Co., Ltd.
+				#725 Pungsan Apt. Factory
+				Rep. of KOREA Zip  Code:  411-815
+				KR
+
+00-04-B2   (hex)		ESSEGI SRL
+0004B2     (base 16)		ESSEGI SRL
+				Via Del Cavaratori, 17
+				    
+				IT
+
+00-04-B4   (hex)		CIAC
+0004B4     (base 16)		CIAC
+				18 rue Joseph BARA
+				    
+				FR
+
+00-04-AD   (hex)		Malibu Networks
+0004AD     (base 16)		Malibu Networks
+				26637 Agoura Rd.
+				Calabasas  CA  91302
+				US
+
+00-04-A9   (hex)		SandStream Technologies, Inc.
+0004A9     (base 16)		SandStream Technologies, Inc.
+				1955 Lakeway Dr.
+				Lewisville  TX  75057
+				US
+
+00-04-61   (hex)		EPOX Computer Co., Ltd.
+000461     (base 16)		EPOX Computer Co., Ltd.
+				11F, #346, Chung San Rd.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-04-62   (hex)		DAKOS Data & Communication Co., Ltd.
+000462     (base 16)		DAKOS Data & Communication Co., Ltd.
+				2nd Floor Bethel Building 324-1
+				Zip  code:  137-130
+				TW
+
+00-04-5F   (hex)		Avalue Technology, Inc.
+00045F     (base 16)		Avalue Technology, Inc.
+				7F, 228, Lian-Cheng Road
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-04-9C   (hex)		Surgient Networks, Inc.
+00049C     (base 16)		Surgient Networks, Inc.
+				3520 Executive Center Drive
+				Austin  TX  78731
+				US
+
+00-04-9D   (hex)		Ipanema Technologies
+00049D     (base 16)		Ipanema Technologies
+				28, Rue De La Redoute
+				    
+				FR
+
+00-04-60   (hex)		Knilink Technology, Inc.
+000460     (base 16)		Knilink Technology, Inc.
+				10F, #96, Hsin Tai Wu Rd.,
+				    TAIWAN
+				TW
+
+00-04-8F   (hex)		TD Systems Corporation
+00048F     (base 16)		TD Systems Corporation
+				100 Bearfoot Rd.
+				Hudson  MA  01749
+				US
+
+00-04-95   (hex)		Tejas Networks India Limited
+000495     (base 16)		Tejas Networks India Limited
+				#58, 1st Main Road, J.P. Nagar, 
+				Bangalore   560078  
+				IN
+
+00-04-6F   (hex)		Digitel S/A Industria Eletronica
+00046F     (base 16)		Digitel S/A Industria Eletronica
+				R. Doutor Joao Ignacio, 1165
+				  Zip:  90230.181
+				BR
+
+00-04-69   (hex)		Innocom, Inc.
+000469     (base 16)		Innocom, Inc.
+				655-2 Naebalsan-Dong
+				157-280  157-280  KOREA
+				KR
+
+00-04-87   (hex)		Cogency Semiconductor, Inc.
+000487     (base 16)		Cogency Semiconductor, Inc.
+				362 Terry Fox Drive, Suite 210
+				    
+				CA
+
+00-04-68   (hex)		Vivity, Inc.
+000468     (base 16)		Vivity, Inc.
+				3360 Mitchell Lane
+				Boulder  CO  80301
+				US
+
+00-03-E1   (hex)		Winmate Communication, Inc.
+0003E1     (base 16)		Winmate Communication, Inc.
+				9F,No.111-6,Shing-De Rd
+				Taipei     241
+				TW
+
+00-03-E4   (hex)		Cisco Systems, Inc
+0003E4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-DC   (hex)		Lexar Media, Inc.
+0003DC     (base 16)		Lexar Media, Inc.
+				47421 Bayside Parkway
+				Fremont  CA  94538
+				US
+
+00-03-D8   (hex)		iMPath Networks, Inc.
+0003D8     (base 16)		iMPath Networks, Inc.
+				1431 Merivale Rd.
+				CANADA  K2E  1B9
+				CA
+
+00-03-D5   (hex)		Advanced Communications Co., Ltd.
+0003D5     (base 16)		Advanced Communications Co., Ltd.
+				2876-1 Ooka
+				Shizuoka  41-0022  
+				JP
+
+00-03-F7   (hex)		Plast-Control GmbH
+0003F7     (base 16)		Plast-Control GmbH
+				Walter-Freitag-Str. 15
+				    
+				DE
+
+00-03-FC   (hex)		Intertex Data AB
+0003FC     (base 16)		Intertex Data AB
+				Rissneleden 45
+				    
+				SE
+
+00-03-EF   (hex)		Oneline AG
+0003EF     (base 16)		Oneline AG
+				Steinfeldstraße 3
+				    
+				DE
+
+00-03-F1   (hex)		Cicada Semiconductor, Inc.
+0003F1     (base 16)		Cicada Semiconductor, Inc.
+				811 Barton Springs Rd.
+				Austin  TX  78704
+				US
+
+00-04-30   (hex)		Netgem
+000430     (base 16)		Netgem
+				27 rue d'Orleans
+				    
+				FR
+
+00-04-2C   (hex)		Minet, Inc.
+00042C     (base 16)		Minet, Inc.
+				3F Se-A Venture Tower
+				    KOREA
+				KR
+
+00-04-2A   (hex)		Wireless Networks, Inc.
+00042A     (base 16)		Wireless Networks, Inc.
+				2322 El Camino Real
+				San Mateo  CA  94403
+				US
+
+00-04-2B   (hex)		IT Access Co., Ltd.
+00042B     (base 16)		IT Access Co., Ltd.
+				3-17-6, Shinyokohama, Kouhoku-ku
+				Yokohama-shi  Kanagawa  222-8545
+				JP
+
+00-03-D6   (hex)		RADVision, Ltd.
+0003D6     (base 16)		RADVision, Ltd.
+				24 Raul Wallenberg St.
+				    
+				IL
+
+00-03-D4   (hex)		Alloptic, Inc.
+0003D4     (base 16)		Alloptic, Inc.
+				6960 Koll Center Parkway
+				Pleasanton  CA  94566
+				US
+
+00-03-CE   (hex)		ETEN Technologies, Inc.
+0003CE     (base 16)		ETEN Technologies, Inc.
+				2F, No. 9, Lane 235, Pao-Chiao Rd.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-C8   (hex)		CML Emergency Services
+0003C8     (base 16)		CML Emergency Services
+				75 Boulevard la Technologies
+				    
+				CA
+
+00-03-C3   (hex)		Micronik Multimedia
+0003C3     (base 16)		Micronik Multimedia
+				Brückenstraße 2
+				    
+				DE
+
+00-04-19   (hex)		Fibercycle Networks, Inc.
+000419     (base 16)		Fibercycle Networks, Inc.
+				20 South Santa Cruz Ave.
+				Los Gatos  CA  95030
+				US
+
+00-04-1C   (hex)		ipDialog, Inc.
+00041C     (base 16)		ipDialog, Inc.
+				1762 Technology Drive
+				San Jose  CA  95110
+				US
+
+00-04-18   (hex)		Teltronic S.A.U.
+000418     (base 16)		Teltronic S.A.U.
+				Poligono de Malpica
+				    
+				ES
+
+00-03-70   (hex)		NXTV, Inc.
+000370     (base 16)		NXTV, Inc.
+				5955 De Soto Ave, #160
+				Woodland Hills  CA  91367
+				US
+
+00-04-02   (hex)		Nexsan Technologies, Ltd.
+000402     (base 16)		Nexsan Technologies, Ltd.
+				Parker Centre
+				Derby    DE21 4SZ
+				GB
+
+00-03-ED   (hex)		Shinkawa Electric Co., Ltd.
+0003ED     (base 16)		Shinkawa Electric Co., Ltd.
+				3-2-24 3 chome
+				    
+				JP
+
+00-03-BD   (hex)		OmniCluster Technologies, Inc.
+0003BD     (base 16)		OmniCluster Technologies, Inc.
+				4950 Blue Lake Drive
+				Boca Raton  FL  33431
+				US
+
+00-03-C0   (hex)		RFTNC Co., Ltd.
+0003C0     (base 16)		RFTNC Co., Ltd.
+				3F, 1624-24, Bongchen-dong
+				  SOUTH  KOREA
+				KR
+
+00-03-B8   (hex)		NetKit Solutions, LLC
+0003B8     (base 16)		NetKit Solutions, LLC
+				26630 Agoura Road
+				Calabasas  CA  91302
+				US
+
+00-03-B7   (hex)		ZACCESS Systems
+0003B7     (base 16)		ZACCESS Systems
+				275 Shoreline Drive, #110
+				Redwood City  CA  94065
+				US
+
+00-03-A0   (hex)		Cisco Systems, Inc
+0003A0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-A2   (hex)		Catapult Communications
+0003A2     (base 16)		Catapult Communications
+				160 S. Whisman Rd.
+				Mountain View  CA  94041
+				US
+
+00-03-9C   (hex)		OptiMight Communications, Inc.
+00039C     (base 16)		OptiMight Communications, Inc.
+				980 Linda Vista Avenue
+				Mountain View  CA  94043
+				US
+
+00-03-B0   (hex)		Xsense Technology Corp.
+0003B0     (base 16)		Xsense Technology Corp.
+				11 F, 232, Sec. 3, ChengTeh Rd.
+				Taipei  TAIWAN,  103
+				TW
+
+00-03-AA   (hex)		Watlow
+0003AA     (base 16)		Watlow
+				1241 Bundy Blvd.
+				Winona  MN  55987
+				US
+
+00-03-A8   (hex)		IDOT Computers, Inc.
+0003A8     (base 16)		IDOT Computers, Inc.
+				3F., No. 137, Lane 235
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-55   (hex)		TeraBeam Internet Systems
+000355     (base 16)		TeraBeam Internet Systems
+				14833 NE 87th St., Bldg. C
+				Redmond  WA  98052
+				US
+
+00-03-69   (hex)		Nippon Antenna Co., Ltd.
+000369     (base 16)		Nippon Antenna Co., Ltd.
+				No. 49-8, Nishiogu,
+				Tokyo    116-8561
+				JP
+
+00-03-73   (hex)		Aselsan A.S
+000373     (base 16)		Aselsan A.S
+				Mehmet Akif Ersoy Mah.
+				    
+				TR
+
+00-03-77   (hex)		Gigabit Wireless
+000377     (base 16)		Gigabit Wireless
+				3099 N. First Street
+				San Jose  CA  95134
+				US
+
+00-03-65   (hex)		Kira Information & Communications, Ltd.
+000365     (base 16)		Kira Information & Communications, Ltd.
+				6th Fl. Anam Tower,
+				    
+				KR
+
+00-03-85   (hex)		Actelis Networks, Inc.
+000385     (base 16)		Actelis Networks, Inc.
+				1 Bazel St., P.O.B. 10173
+				    
+				IL
+
+00-03-54   (hex)		Fiber Logic Communications
+000354     (base 16)		Fiber Logic Communications
+				5F-3, No. 9, Prosperity Road One,
+				Hsinchu    
+				TW
+
+00-03-50   (hex)		BTICINO SPA
+000350     (base 16)		BTICINO SPA
+				Via L. Manara, 4
+				    
+				IT
+
+00-03-51   (hex)		Diebold, Inc.
+000351     (base 16)		Diebold, Inc.
+				5995 Mayfair Road
+				North Canton  OH  44720
+				US
+
+00-03-4E   (hex)		Pos Data Company, Ltd.
+00034E     (base 16)		Pos Data Company, Ltd.
+				276-2, Seo-Hyun Dong,
+				    
+				KR
+
+00-03-48   (hex)		Norscan Instruments, Ltd.
+000348     (base 16)		Norscan Instruments, Ltd.
+				7 Terracon Place
+				    R2J 4B3
+				CA
+
+00-03-46   (hex)		Hitachi Kokusai Electric, Inc.
+000346     (base 16)		Hitachi Kokusai Electric, Inc.
+				1-6-10 Uchikanda
+				    
+				JP
+
+00-03-44   (hex)		Tietech.Co., Ltd.
+000344     (base 16)		Tietech.Co., Ltd.
+				2-13-1 Chikamatoori Minamiku
+				    
+				JP
+
+00-02-E6   (hex)		Gould Instrument Systems, Inc.
+0002E6     (base 16)		Gould Instrument Systems, Inc.
+				8333 Rockside Road
+				Valley View  OH  44125
+				US
+
+00-02-E4   (hex)		JC HYUN Systems, Inc.
+0002E4     (base 16)		JC HYUN Systems, Inc.
+				Shinbong Bldg, 736-6,
+				Seoul    (135-080)
+				KR
+
+00-02-DE   (hex)		Astrodesign, Inc.
+0002DE     (base 16)		Astrodesign, Inc.
+				2-22-12 Kamikodana Ka
+				Kanagawa    
+				JP
+
+00-02-E2   (hex)		NDC Infared Engineering
+0002E2     (base 16)		NDC Infared Engineering
+				5314 N. Irwindale Ave.
+				Irwindale  CA  91706
+				US
+
+00-02-E1   (hex)		Integrated Network Corporation
+0002E1     (base 16)		Integrated Network Corporation
+				757 Route 202/206
+				Bridgewater  NJ  08807
+				US
+
+00-02-F7   (hex)		ARM
+0002F7     (base 16)		ARM
+				110, Fulbourn Road
+				    CB1 9NJ
+				GB
+
+00-D0-24   (hex)		Cognex Corporation
+00D024     (base 16)		Cognex Corporation
+				Modular Vision Systems Division
+				Portland  OR  97224
+				US
+
+00-02-F1   (hex)		Pinetron Co., Ltd.
+0002F1     (base 16)		Pinetron Co., Ltd.
+				Bldg. #1599-11,
+				Seoul    137-073
+				KR
+
+00-02-ED   (hex)		DXO Telecom Co., Ltd.
+0002ED     (base 16)		DXO Telecom Co., Ltd.
+				8F, 300-11, Yumgok-Dong,
+				    
+				KR
+
+00-02-EC   (hex)		Maschoff Design Engineering
+0002EC     (base 16)		Maschoff Design Engineering
+				1325 Kenilworth Drive
+				Woodbury  MN  55125
+				US
+
+00-03-36   (hex)		Zetes Technologies
+000336     (base 16)		Zetes Technologies
+				3 Rue De Stras Bourg
+				    
+				BE
+
+00-03-37   (hex)		Vaone, Inc.
+000337     (base 16)		Vaone, Inc.
+				6F Kyemong Art Center,
+				    135-082
+				KR
+
+00-03-3B   (hex)		TAMI Tech Co., Ltd.
+00033B     (base 16)		TAMI Tech Co., Ltd.
+				4F, Chungdo Bencher Town
+				Taejon    
+				KR
+
+00-03-2D   (hex)		IBASE Technology, Inc.
+00032D     (base 16)		IBASE Technology, Inc.
+				5F, No. 221,
+				Taipei    
+				TW
+
+00-B0-52   (hex)		Atheros Communications
+00B052     (base 16)		Atheros Communications
+				5955 T.G. Lee Blvd, Ste. 600
+				Ocala  FL  32822
+				US
+
+00-03-43   (hex)		Martin Professional A/S
+000343     (base 16)		Martin Professional A/S
+				Olof Palmes Alle 18
+				    
+				DK
+
+00-03-35   (hex)		Mirae Technology
+000335     (base 16)		Mirae Technology
+				211-15, Hon Hyun-dong,
+				Seoul    
+				KR
+
+00-02-F8   (hex)		SEAKR Engineering, Inc.
+0002F8     (base 16)		SEAKR Engineering, Inc.
+				12847 E. Peakview Ave.
+				Englewood  CO  80111
+				US
+
+00-03-14   (hex)		Teleware Network Systems
+000314     (base 16)		Teleware Network Systems
+				#7806 7th Dongil Technotown,
+				    431-062
+				KR
+
+00-03-2F   (hex)		Global Sun Technology, Inc.
+00032F     (base 16)		Global Sun Technology, Inc.
+				No. 13, Tung Yuan Rd.,
+				    
+				TW
+
+00-02-DC   (hex)		Fujitsu General Limited
+0002DC     (base 16)		Fujitsu General Limited
+				1116, Suenaga, Takatsu-Ku,
+				  213-8502  
+				JP
+
+00-02-D7   (hex)		EMPEG Ltd
+0002D7     (base 16)		EMPEG Ltd
+				1 Signet Court
+				    CB5 8LA
+				GB
+
+00-02-D3   (hex)		NetBotz, Inc.
+0002D3     (base 16)		NetBotz, Inc.
+				110044 Research Blvd.
+				Austin  TX  78759
+				US
+
+00-02-DA   (hex)		ExiO Communications, Inc.
+0002DA     (base 16)		ExiO Communications, Inc.
+				2362 Qume Drive
+				San Jose  CA  95131
+				US
+
+00-02-D4   (hex)		PDA Peripherals, Inc.
+0002D4     (base 16)		PDA Peripherals, Inc.
+				205 Orange St.
+				New Haven  CT  06510
+				US
+
+00-02-D6   (hex)		NICE Systems
+0002D6     (base 16)		NICE Systems
+				8 Hapnina St., POB 690
+				    
+				IL
+
+00-02-7D   (hex)		Cisco Systems, Inc
+00027D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-7C   (hex)		Trilithic, Inc.
+00027C     (base 16)		Trilithic, Inc.
+				9202 E. 33rd Street
+				Indianapolis  IN  46235
+				US
+
+00-02-8B   (hex)		VDSL Systems OY
+00028B     (base 16)		VDSL Systems OY
+				Tekniikantie 12
+				    
+				FI
+
+00-02-8C   (hex)		Micrel-Synergy Semiconductor
+00028C     (base 16)		Micrel-Synergy Semiconductor
+				3250 Scott Boulevard
+				Santa Clara  CA  95054
+				US
+
+00-02-8D   (hex)		Movita Technologies, Inc.
+00028D     (base 16)		Movita Technologies, Inc.
+				No. 26 Wu-Chuan 7th Road,
+				Taipei  Taiwan,  R.O.C.
+				TW
+
+00-02-98   (hex)		Broadframe Corporation
+000298     (base 16)		Broadframe Corporation
+				5828 Moonstone Ave.
+				Alta Loma  CA  91701
+				US
+
+00-02-97   (hex)		C-COR.net
+000297     (base 16)		C-COR.net
+				60 Decibel Road
+				State College  PA  16801
+				US
+
+00-02-91   (hex)		Open Network Co., Ltd.
+000291     (base 16)		Open Network Co., Ltd.
+				Seishin Bldg., 2-5-10 Shinjuku
+				  JAPAN  160-0022
+				JP
+
+00-02-C1   (hex)		Innovative Electronic Designs, Inc.
+0002C1     (base 16)		Innovative Electronic Designs, Inc.
+				9701 Taylorsville Rd.
+				Louisville  KY  40299
+				US
+
+00-02-C0   (hex)		Bencent Tzeng Industry Co., Ltd.
+0002C0     (base 16)		Bencent Tzeng Industry Co., Ltd.
+				3rd fl., No. 3 Ruey Kuang Rd.,
+				Taiwan  Taiwan  R.O.C.
+				TW
+
+00-02-99   (hex)		Apex, Inc.
+000299     (base 16)		Apex, Inc.
+				9911 Willows Rd. N.E.
+				Redmond  WA  95052
+				US
+
+00-02-75   (hex)		SMART Technologies, Inc.
+000275     (base 16)		SMART Technologies, Inc.
+				3636 Research  Road NW
+				Calgary, Alberta    T2L1Y1
+				CA
+
+00-02-C6   (hex)		Data Track Technology PLC
+0002C6     (base 16)		Data Track Technology PLC
+				153 Somerford Road
+				  UNITED  KINGDOM
+				GB
+
+00-02-A6   (hex)		Effinet Systems Co., Ltd.
+0002A6     (base 16)		Effinet Systems Co., Ltd.
+				Yugong Bldg. 502
+				    Korea
+				KR
+
+00-02-5F   (hex)		Nortel Networks
+00025F     (base 16)		Nortel Networks
+				9300 trans-CANADA Highway
+				H4S  1KS  
+				CA
+
+00-02-5C   (hex)		SCI Systems (Kunshan) Co., Ltd.
+00025C     (base 16)		SCI Systems (Kunshan) Co., Ltd.
+				312 QING YANG ROAD
+				CHINA  CHINA  215300
+				CN
+
+00-00-87   (hex)		HITACHI, LTD.
+000087     (base 16)		HITACHI, LTD.
+				NETWORK ENGINEERING DIV.
+				  TOKYO 140  
+				JP
+
+00-02-58   (hex)		Flying Packets Communications
+000258     (base 16)		Flying Packets Communications
+				388 Market Street
+				San Francisco  CA  94111
+				US
+
+00-02-4E   (hex)		Datacard Group
+00024E     (base 16)		Datacard Group
+				11111 Bren Road West
+				Minnetonka  MN  55343
+				US
+
+00-02-42   (hex)		Videoframe Systems
+000242     (base 16)		Videoframe Systems
+				101 Providence Mine Road
+				Nevada City  CA  95959
+				US
+
+00-02-44   (hex)		SURECOM Technology Co.
+000244     (base 16)		SURECOM Technology Co.
+				6F, No. 125, Sec. 2, Datung Rd.
+				Taiwan  Taiwan  R.O.C.
+				TW
+
+00-02-3E   (hex)		Selta Telematica S.p.a
+00023E     (base 16)		Selta Telematica S.p.a
+				Via Nazionale km 404.5
+				    
+				IT
+
+00-02-41   (hex)		Amer.com
+000241     (base 16)		Amer.com
+				7259 Bryan Dairy Road
+				Largo  FL  33777
+				US
+
+00-02-07   (hex)		VisionGlobal Network Corp.
+000207     (base 16)		VisionGlobal Network Corp.
+				826 E. Stale Road
+				American Fork  UT  84003
+				US
+
+00-02-08   (hex)		Unify Networks, Inc.
+000208     (base 16)		Unify Networks, Inc.
+				3160 De La Cruz Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-02-04   (hex)		Bodmann Industries Elektronik GmbH
+000204     (base 16)		Bodmann Industries Elektronik GmbH
+				Messerschmittring 33
+				    
+				DE
+
+00-02-29   (hex)		Adtec Corporation
+000229     (base 16)		Adtec Corporation
+				3F Megurohigashiyama Blg
+				    
+				JP
+
+00-02-2D   (hex)		Agere Systems
+00022D     (base 16)		Agere Systems
+				P.O. Box 755
+				    
+				NL
+
+00-02-26   (hex)		XESystems, Inc.
+000226     (base 16)		XESystems, Inc.
+				317 Main Street
+				East Rochester  NY  14445
+				US
+
+00-02-25   (hex)		One Stop Systems
+000225     (base 16)		One Stop Systems
+				2235 Enterprise Street
+				Escondido  CA  92029
+				US
+
+00-02-11   (hex)		Nature Worldwide Technology Corp.
+000211     (base 16)		Nature Worldwide Technology Corp.
+				No. 1, Min-Chuan Street
+				Taiwan  Taiwan  R.O.C.
+				TW
+
+00-02-12   (hex)		SierraCom
+000212     (base 16)		SierraCom
+				99 South Street
+				Hopkinton  Ma  01748
+				US
+
+00-02-17   (hex)		Cisco Systems, Inc
+000217     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-7A   (hex)		Chengdu Maipu Electric Industrial Co., Ltd.
+00017A     (base 16)		Chengdu Maipu Electric Industrial Co., Ltd.
+				NANYI BUILDING, CONSULATE RD.,
+				  P.R.  
+				CN
+
+00-02-38   (hex)		Serome Technology, Inc.
+000238     (base 16)		Serome Technology, Inc.
+				555-14, Baekang B/D 7F
+				Seoul  Korea  135-120
+				KR
+
+00-02-69   (hex)		Nadatel Co., Ltd
+000269     (base 16)		Nadatel Co., Ltd
+				9F CoWell Bldg, 66-1 Banpo-Dong
+				  KOREA  137-040
+				KR
+
+00-02-64   (hex)		AudioRamp.com
+000264     (base 16)		AudioRamp.com
+				15941 Red Hill Suite 205
+				Tustin  CA  92780
+				US
+
+00-02-55   (hex)		IBM Corp
+000255     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-02-52   (hex)		Carrier Corporation
+000252     (base 16)		Carrier Corporation
+				One Carrier Place
+				Farmington  CT  06034-4015
+				US
+
+00-02-20   (hex)		CANON FINETECH INC.
+000220     (base 16)		CANON FINETECH INC.
+				717, Yaguchi, Misato-shi,
+				Saitama    341-8527
+				JP
+
+00-02-0D   (hex)		Micronpc.com
+00020D     (base 16)		Micronpc.com
+				900 E. Karcher Rd.
+				Nampa  IA  83687
+				US
+
+00-01-D4   (hex)		Leisure Time, Inc.
+0001D4     (base 16)		Leisure Time, Inc.
+				4258 Communications Drive
+				Norcross  GA  30093
+				US
+
+00-01-DD   (hex)		Avail Networks
+0001DD     (base 16)		Avail Networks
+				305 E. Eisenhower Parkway
+				Ann Arbor  MI  48108
+				US
+
+00-01-D5   (hex)		HAEDONG INFO & COMM CO., LTD
+0001D5     (base 16)		HAEDONG INFO & COMM CO., LTD
+				#801 The Corporation Center for Universi
+				Taejeon  Republic  of Korea 305
+				KR
+
+00-01-D7   (hex)		F5 Networks, Inc.
+0001D7     (base 16)		F5 Networks, Inc.
+				1322 N. Whitman Lane
+				Liberty Lake  WA  99019
+				US
+
+00-01-DE   (hex)		Trango Systems, Inc.
+0001DE     (base 16)		Trango Systems, Inc.
+				9939 V/A Pasar
+				San Diego  CA  92126
+				US
+
+00-01-DC   (hex)		Activetelco
+0001DC     (base 16)		Activetelco
+				43222 Christy Street
+				Fremont  CA  94538
+				US
+
+00-01-F9   (hex)		TeraGlobal Communications Corp.
+0001F9     (base 16)		TeraGlobal Communications Corp.
+				9171 Towne Centre Drive
+				San Diego  CA  92122
+				US
+
+00-01-FB   (hex)		DoTop Technology, Inc.
+0001FB     (base 16)		DoTop Technology, Inc.
+				10F, No. 100, Min-Chyuan Road
+				    TAIWAN
+				TW
+
+00-01-F8   (hex)		TEXIO TECHNOLOGY CORPORATION
+0001F8     (base 16)		TEXIO TECHNOLOGY CORPORATION
+				2-18-13 Shin Yokohama,
+				    222-0033
+				JP
+
+00-01-BE   (hex)		Gigalink Co., Ltd.
+0001BE     (base 16)		Gigalink Co., Ltd.
+				6th F/L Diplomatic Center 1376-1
+				    KOREA
+				KR
+
+00-01-B1   (hex)		General Bandwidth
+0001B1     (base 16)		General Bandwidth
+				12303-B Technology Blvd.
+				Austin  TX  78727
+				US
+
+00-01-BF   (hex)		Teleforce Co., Ltd.
+0001BF     (base 16)		Teleforce Co., Ltd.
+				721 yoshioka-cho kanonji-city
+				    
+				JP
+
+00-01-B4   (hex)		Wayport, Inc.
+0001B4     (base 16)		Wayport, Inc.
+				1609 Shoal Creek Blvd.
+				Austin  TX  78701
+				US
+
+00-01-BA   (hex)		IC-Net, Inc.
+0001BA     (base 16)		IC-Net, Inc.
+				5 Fl. Seasung Bldg., 311-27 Noryangjin-D
+				    KOREA
+				KR
+
+00-01-CF   (hex)		Alpha Data Parallel Systems, Ltd.
+0001CF     (base 16)		Alpha Data Parallel Systems, Ltd.
+				58 Timber Bush
+				  UNITED  KINGDOM
+				GB
+
+00-01-D0   (hex)		VitalPoint, Inc.
+0001D0     (base 16)		VitalPoint, Inc.
+				15770 Hopper Road
+				Peyton  CO  80831
+				US
+
+00-01-B0   (hex)		Fulltek Technology Co., Ltd.
+0001B0     (base 16)		Fulltek Technology Co., Ltd.
+				3F No. 8, Lane 130, Min Chuan Rd., Hsint
+				  TAIWAN  R.O.C.
+				TW
+
+00-01-A9   (hex)		BMW AG
+0001A9     (base 16)		BMW AG
+				Dept. FG-322
+				80788  Munich  
+				DE
+
+00-01-AA   (hex)		Airspan Communications, Ltd.
+0001AA     (base 16)		Airspan Communications, Ltd.
+				Cambridge House, Oxford Rd.,
+				    
+				GB
+
+00-01-9E   (hex)		ESS Technology, Inc.
+00019E     (base 16)		ESS Technology, Inc.
+				48401 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-01-7D   (hex)		ThermoQuest
+00017D     (base 16)		ThermoQuest
+				355 River Oaks Parkway
+				San Jose  CA  95134
+				US
+
+00-01-81   (hex)		Nortel Networks
+000181     (base 16)		Nortel Networks
+				1100 Technology Park Drive
+				Billerica  MA  01821
+				US
+
+00-01-94   (hex)		Capital Equipment Corporation
+000194     (base 16)		Capital Equipment Corporation
+				900 Middlesex Turnpike - Bldg. 2
+				Billerica  MA  01821
+				US
+
+00-01-98   (hex)		Darim Vision
+000198     (base 16)		Darim Vision
+				Taejon Expo Venture Town
+				    KOREA
+				KR
+
+00-01-E8   (hex)		Force10 Networks, Inc.
+0001E8     (base 16)		Force10 Networks, Inc.
+				1440 McCarthy Blvd.
+				Milpitas  CA  95035
+				US
+
+00-01-E9   (hex)		Litton Marine Systems B.V.
+0001E9     (base 16)		Litton Marine Systems B.V.
+				118 Burlington Road
+				ENGLAND  KT3  4NR
+				GB
+
+00-01-E5   (hex)		Supernet, Inc.
+0001E5     (base 16)		Supernet, Inc.
+				135-080 Daemeong Bldg.
+				    KOREA
+				KR
+
+00-01-A2   (hex)		Logical Co., Ltd.
+0001A2     (base 16)		Logical Co., Ltd.
+				4598 Murakushi-cho
+				  431-1207  
+				JP
+
+00-01-85   (hex)		Hitachi Aloka Medical, Ltd.
+000185     (base 16)		Hitachi Aloka Medical, Ltd.
+				3-7-19, Imai Ome-city
+				  198-8577  
+				JP
+
+00-01-C7   (hex)		Cisco Systems, Inc
+0001C7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-21   (hex)		WatchGuard Technologies, Inc.
+000121     (base 16)		WatchGuard Technologies, Inc.
+				605 Fifth Ave. S
+				Seattle  WA  98104-3892
+				US
+
+00-01-29   (hex)		DFI Inc.
+000129     (base 16)		DFI Inc.
+				100, Huan-Ho Street
+				Hsi-Chih City  Taipei Hsien  
+				TW
+
+00-01-19   (hex)		RTUnet (Australia)
+000119     (base 16)		RTUnet (Australia)
+				8/3-5 Gilda Court
+				Mulgrave  Vic  3170
+				AU
+
+00-01-22   (hex)		Trend Communications, Ltd.
+000122     (base 16)		Trend Communications, Ltd.
+				Knaves Beech Estate
+				Bucks, HP10 9QZ    
+				GB
+
+00-01-1A   (hex)		Hoffmann und Burmeister GbR
+00011A     (base 16)		Hoffmann und Burmeister GbR
+				Niederberger Str. 75
+				D-53909 Zuelpich    
+				DE
+
+00-01-0A   (hex)		CIS TECHNOLOGY INC.
+00010A     (base 16)		CIS TECHNOLOGY INC.
+				16F, No. 75 Hsin Tai Wu Road
+				Taipei Hsien 221    
+				TW
+
+00-01-67   (hex)		HIOKI E.E. CORPORATION
+000167     (base 16)		HIOKI E.E. CORPORATION
+				81 Koizumi, Ueda, Nagano
+				386-1192  386-1192  
+				JP
+
+00-01-68   (hex)		VITANA CORPORATION
+000168     (base 16)		VITANA CORPORATION
+				2500 Don Reid Drive
+				K1H 1E1  K1H 1E1  
+				CA
+
+00-01-62   (hex)		Cygnet Technologies, Inc.
+000162     (base 16)		Cygnet Technologies, Inc.
+				1411 LeMay Drive #301
+				Carrollton  TX  75007
+				US
+
+00-01-54   (hex)		G3M Corporation
+000154     (base 16)		G3M Corporation
+				4320 Stevens Creek Blvd. - Ste. #275
+				San Jose  CA  95129
+				US
+
+00-01-52   (hex)		CHROMATEK INC.
+000152     (base 16)		CHROMATEK INC.
+				6-10, Miyazaki 2-Chome
+				    
+				JP
+
+00-01-50   (hex)		GILAT COMMUNICATIONS, LTD.
+000150     (base 16)		GILAT COMMUNICATIONS, LTD.
+				21/D Yegia Kapayim Street
+				    
+				IL
+
+00-01-51   (hex)		Ensemble Communications
+000151     (base 16)		Ensemble Communications
+				6256 Greenman Drive - Ste. #400
+				San Diego  CA  92122
+				US
+
+00-01-15   (hex)		EXTRATECH CORPORATION
+000115     (base 16)		EXTRATECH CORPORATION
+				760 Thornton St., Unit 2
+				Post Falls  ID  83854
+				US
+
+00-01-01   (hex)		Private
+000101     (base 16)		Private
+
+00-01-0D   (hex)		Teledyne DALSA Inc.
+00010D     (base 16)		Teledyne DALSA Inc.
+				880 McCaffrey
+				St-Laurent  Quebec  H4T 2C7
+				CA
+
+00-01-05   (hex)		Beckhoff Automation GmbH
+000105     (base 16)		Beckhoff Automation GmbH
+				Eiserstraße 5
+				Verl  NRW  33415
+				DE
+
+00-B0-17   (hex)		InfoGear Technology Corp.
+00B017     (base 16)		InfoGear Technology Corp.
+				2055 Woodside Road
+				Redwood City  CA  94061
+				US
+
+00-01-2C   (hex)		Aravox Technologies, Inc.
+00012C     (base 16)		Aravox Technologies, Inc.
+				16725 40th Place North
+				Plymouth  MN  55446
+				US
+
+00-01-42   (hex)		Cisco Systems, Inc
+000142     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-64   (hex)		Cisco Systems, Inc
+000164     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-5F   (hex)		DIGITAL DESIGN GmbH
+00015F     (base 16)		DIGITAL DESIGN GmbH
+				Rauchstr. 21
+				  Berlin  D-10787
+				DE
+
+00-01-2B   (hex)		TELENET Co., Ltd.
+00012B     (base 16)		TELENET Co., Ltd.
+				
+				    
+				
+
+00-01-3F   (hex)		Neighbor World Co., Ltd.
+00013F     (base 16)		Neighbor World Co., Ltd.
+				114A YERC, 134, Shinchon_dong
+				120-749  120-749  KOREA
+				KR
+
+00-01-24   (hex)		Acer Incorporated
+000124     (base 16)		Acer Incorporated
+				21F, 88, Sec.1
+				Taipei Hsien 221    
+				TW
+
+00-30-88   (hex)		Ericsson
+003088     (base 16)		Ericsson
+				250 Holger Way
+				SAN JOSE  CA  95134
+				US
+
+00-30-20   (hex)		TSI, Inc..
+003020     (base 16)		TSI, Inc..
+				500 Cardigan Road
+				Shoreview  MN  55126
+				US
+
+00-30-95   (hex)		Procomp Informatics, Ltd.
+003095     (base 16)		Procomp Informatics, Ltd.
+				5F, 69-10, Sec. 2,
+				Tamshui, Taipei, Hsien    
+				TW
+
+00-30-CA   (hex)		Discovery Com
+0030CA     (base 16)		Discovery Com
+				4935 Century Street
+				Huntsville  AL  35816
+				US
+
+00-30-CE   (hex)		Zaffire
+0030CE     (base 16)		Zaffire
+				2630 Orchard Parkway
+				San Jose  CA  95134-2020
+				US
+
+00-30-7B   (hex)		Cisco Systems, Inc
+00307B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-B5   (hex)		Tadiran Microwave Networks
+0030B5     (base 16)		Tadiran Microwave Networks
+				4000 Greenbriar Drive
+				Stafford  TX  77477
+				US
+
+00-30-B8   (hex)		RiverDelta Networks
+0030B8     (base 16)		RiverDelta Networks
+				Three Highwood Drive East
+				Tewksbury  MA  01876
+				US
+
+00-30-71   (hex)		Cisco Systems, Inc
+003071     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-3A   (hex)		MAATEL
+00303A     (base 16)		MAATEL
+				495 RUE DE POMMARIN
+				38360 VOREPPE    
+				FR
+
+00-30-4E   (hex)		BUSTEC PRODUCTION LTD.
+00304E     (base 16)		BUSTEC PRODUCTION LTD.
+				WORLD AVIATION PARK
+				Shannon  County Clare  
+				IE
+
+00-30-A4   (hex)		Woodwind Communications System
+0030A4     (base 16)		Woodwind Communications System
+				20300 Century Blvd., Suite 200B
+				Germantown  MD  20874
+				US
+
+00-30-3B   (hex)		PowerCom Technology
+00303B     (base 16)		PowerCom Technology
+				2F, No. 34, Industry E. Road IV
+				Hsinchu 300    
+				TW
+
+00-30-BC   (hex)		Optronic AG
+0030BC     (base 16)		Optronic AG
+				untereggerstrasse 53
+				9403 Goldach    
+				CH
+
+00-B0-2D   (hex)		ViaGate Technologies, Inc.
+00B02D     (base 16)		ViaGate Technologies, Inc.
+				745 Route 202/206
+				Bridgewater  NJ  08807
+				US
+
+00-30-EE   (hex)		DSG Technology, Inc.
+0030EE     (base 16)		DSG Technology, Inc.
+				6F-4 No. 270, Chwig Hsiao
+				 Taipei    
+				TW
+
+00-30-9E   (hex)		WORKBIT CORPORATION.
+00309E     (base 16)		WORKBIT CORPORATION.
+				1-2-2 Chuou, Yamato
+				Kanagawa  242-0021    
+				JP
+
+00-30-DE   (hex)		WAGO Kontakttechnik GmbH
+0030DE     (base 16)		WAGO Kontakttechnik GmbH
+				Hansastrasse 27
+				32423 Minden    
+				DE
+
+00-30-3E   (hex)		Radcom Ltd.
+00303E     (base 16)		Radcom Ltd.
+				12 Hanechoshet Street
+				Tel-Aviv 69710    
+				IL
+
+00-30-D7   (hex)		Innovative Systems, L.L.C.
+0030D7     (base 16)		Innovative Systems, L.L.C.
+				1000 Innovative Drive
+				Mitchell  SD  57301
+				US
+
+00-B0-CE   (hex)		Viveris Technologies
+00B0CE     (base 16)		Viveris Technologies
+				1 rue Traversiere BP 20327
+				Rungis Cedex    94598
+				FR
+
+00-B0-1C   (hex)		Westport Technologies
+00B01C     (base 16)		Westport Technologies
+				15 Capella Court, Unit 116
+				Nepean  Ontario  
+				CA
+
+00-B0-4A   (hex)		Cisco Systems, Inc
+00B04A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-B0-48   (hex)		Marconi Communications Inc.
+00B048     (base 16)		Marconi Communications Inc.
+				8616 Freeport Parkway
+				Irving  TX  75063
+				US
+
+00-30-1B   (hex)		SHUTTLE, INC.
+00301B     (base 16)		SHUTTLE, INC.
+				5F, No. 34, Lane 60
+				Taipei    
+				TW
+
+00-30-21   (hex)		HSING TECH. ENTERPRISE CO.,LTD
+003021     (base 16)		HSING TECH. ENTERPRISE CO.,LTD
+				2F, NO. 22, ALLLEY 38, LANE 91
+				TAIPEI    
+				TW
+
+00-30-2C   (hex)		SYLANTRO SYSTEMS CORPORATION
+00302C     (base 16)		SYLANTRO SYSTEMS CORPORATION
+				1686 DELL AVENUE
+				CAMPBELL  CA  95008
+				US
+
+00-30-DF   (hex)		KB/TEL TELECOMUNICACIONES
+0030DF     (base 16)		KB/TEL TELECOMUNICACIONES
+				S.A. DE C.V.
+				Mexico City 14060    
+				MX
+
+00-30-30   (hex)		HARMONIX CORPORATION
+003030     (base 16)		HARMONIX CORPORATION
+				1755 OSGOOD STREET
+				NORTH ANDOVER  MA  01845
+				US
+
+00-30-63   (hex)		SANTERA SYSTEMS, INC.
+003063     (base 16)		SANTERA SYSTEMS, INC.
+				2901 SUMMIT AVENUE - STE. #100
+				PLANO  TX  75074
+				US
+
+00-30-A3   (hex)		Cisco Systems, Inc
+0030A3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-DD   (hex)		INDIGITA CORPORATION
+0030DD     (base 16)		INDIGITA CORPORATION
+				30 Corporate Park Drive
+				Irvine  CA  92606
+				US
+
+00-30-99   (hex)		BOENIG UND KALLENBACH OHG
+003099     (base 16)		BOENIG UND KALLENBACH OHG
+				AM SPOERKEL 100
+				    
+				DE
+
+00-30-F2   (hex)		Cisco Systems, Inc
+0030F2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-51   (hex)		ORBIT AVIONIC & COMMUNICATION
+003051     (base 16)		ORBIT AVIONIC & COMMUNICATION
+				SYSTEMS, LTD.
+				    
+				IL
+
+00-30-8E   (hex)		CROSS MATCH TECHNOLOGIES, INC.
+00308E     (base 16)		CROSS MATCH TECHNOLOGIES, INC.
+				3960 RCA Blvd., Suite 6001
+				Palm Beach  FL  33410
+				US
+
+00-30-27   (hex)		KERBANGO, INC.
+003027     (base 16)		KERBANGO, INC.
+				21771 STEVENS CREEK BLVD. #100
+				CUPERTINO  CA  95014
+				US
+
+00-30-33   (hex)		ORIENT TELECOM CO., LTD.
+003033     (base 16)		ORIENT TELECOM CO., LTD.
+				MISUNG BULDING 115-7
+				    KOREA
+				KR
+
+00-30-08   (hex)		AVIO DIGITAL, INC.
+003008     (base 16)		AVIO DIGITAL, INC.
+				957 INDUSTRIAL ROAD
+				SAN CARLOS  CA  94070
+				US
+
+00-30-1D   (hex)		SKYSTREAM, INC.
+00301D     (base 16)		SKYSTREAM, INC.
+				455 DeGuigne Drive
+				Sunnyvale  CA  94086-3835
+				US
+
+00-30-BA   (hex)		AC&T SYSTEM CO., LTD.
+0030BA     (base 16)		AC&T SYSTEM CO., LTD.
+				ROOM 702, KEUM-WHA PLAZA
+				435-040  SOUTH  KOREA
+				KR
+
+00-30-FD   (hex)		INTEGRATED SYSTEMS DESIGN
+0030FD     (base 16)		INTEGRATED SYSTEMS DESIGN
+				3650-G CENTRE CIRCLE DRIVE
+				FORT MILL  SC  29715
+				US
+
+00-30-B9   (hex)		ECTEL
+0030B9     (base 16)		ECTEL
+				22240 COMSAT DRIVE
+				CLARKSBURG  MD  20871
+				US
+
+00-30-7D   (hex)		GRE AMERICA, INC.
+00307D     (base 16)		GRE AMERICA, INC.
+				425 HARBOR BLVD.
+				BELMONT  CA  94002
+				US
+
+00-30-EF   (hex)		NEON TECHNOLOGY, INC.
+0030EF     (base 16)		NEON TECHNOLOGY, INC.
+				85 WEST MONTAGUE EXPRESSWAY
+				MILPITAS  CA  95035
+				US
+
+00-30-96   (hex)		Cisco Systems, Inc
+003096     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-39   (hex)		SOFTBOOK PRESS
+003039     (base 16)		SOFTBOOK PRESS
+				7745 HERSCHEL AVENUE
+				LA JOLLA  CA  92037
+				US
+
+00-D0-F8   (hex)		FUJIAN STAR TERMINAL
+00D0F8     (base 16)		FUJIAN STAR TERMINAL
+				DEVICE CO., LTD.
+				FUZHOU  FUJIAN,  CHINA 350002
+				CN
+
+00-D0-ED   (hex)		XIOX
+00D0ED     (base 16)		XIOX
+				150 DOW STREET
+				MANCHESTER  NH  03101
+				US
+
+00-D0-97   (hex)		Cisco Systems, Inc
+00D097     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-8E   (hex)		Grass Valley, A Belden Brand
+00D08E     (base 16)		Grass Valley, A Belden Brand
+				3499, Douglas B. Floreani
+				Montreal  Quebec  H4S 2C6
+				CA
+
+00-D0-56   (hex)		SOMAT CORPORATION
+00D056     (base 16)		SOMAT CORPORATION
+				702 KILLARNEY STREET
+				URBANA  IL  61801
+				US
+
+00-D0-E0   (hex)		DOOIN ELECTRONICS CO.
+00D0E0     (base 16)		DOOIN ELECTRONICS CO.
+				DOOIN BLDG. 16-6, SOONAE-DONG
+				  KOREA  463-020
+				KR
+
+00-D0-00   (hex)		FERRAN SCIENTIFIC, INC.
+00D000     (base 16)		FERRAN SCIENTIFIC, INC.
+				11558 SORRENTO VALLEY ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-D0-D0   (hex)		ZHONGXING TELECOM LTD.
+00D0D0     (base 16)		ZHONGXING TELECOM LTD.
+				8-9F BUILDING 54,301#
+				    
+				CN
+
+00-D0-53   (hex)		CONNECTED SYSTEMS
+00D053     (base 16)		CONNECTED SYSTEMS
+				126 W. FIGUEROA STREET
+				SANTA BARBARA  CA  93101
+				US
+
+00-D0-33   (hex)		DALIAN DAXIAN NETWORK
+00D033     (base 16)		DALIAN DAXIAN NETWORK
+				SYSTEM CO., LTD.
+				    
+				CN
+
+00-D0-D6   (hex)		AETHRA TELECOMUNICAZIONI
+00D0D6     (base 16)		AETHRA TELECOMUNICAZIONI
+				VIA MATTEO RICCI, 10
+				    
+				IT
+
+00-D0-63   (hex)		Cisco Systems, Inc
+00D063     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-47   (hex)		XN TECHNOLOGIES
+00D047     (base 16)		XN TECHNOLOGIES
+				P.O. BOX 350
+				CHENEY  WA  99004
+				US
+
+00-D0-55   (hex)		KATHREIN-WERKE KG
+00D055     (base 16)		KATHREIN-WERKE KG
+				ANTON-KATHREIN-STRASS 1-3
+				    
+				DE
+
+00-D0-3B   (hex)		VISION PRODUCTS PTY. LTD.
+00D03B     (base 16)		VISION PRODUCTS PTY. LTD.
+				SECOND AVENUE, TECHNOLOGY PARK
+				  AUSTRALIA  5095
+				AU
+
+00-D0-B3   (hex)		DRS Technologies Canada Ltd
+00D0B3     (base 16)		DRS Technologies Canada Ltd
+				700 Palladium Drive
+				Ottawa  Ontario  K2V 1C6
+				CA
+
+00-D0-AF   (hex)		CUTLER-HAMMER, INC.
+00D0AF     (base 16)		CUTLER-HAMMER, INC.
+				PMP CENTER
+				PITTSBURGH  PA  15205
+				US
+
+00-D0-52   (hex)		ASCEND COMMUNICATIONS, INC.
+00D052     (base 16)		ASCEND COMMUNICATIONS, INC.
+				1701 HARBOR BAY PARKWAY
+				ALAMEDA  CA  94502
+				US
+
+00-D0-AD   (hex)		TL INDUSTRIES
+00D0AD     (base 16)		TL INDUSTRIES
+				2541 TRACY ROAD
+				NORTHWOOD  OH  43619
+				US
+
+00-D0-A4   (hex)		ALANTRO COMMUNICATIONS
+00D0A4     (base 16)		ALANTRO COMMUNICATIONS
+				141 STONY CIRCLE,  STE. #210
+				SANTAROSA  CA  95401
+				US
+
+00-D0-B0   (hex)		BITSWITCH LTD.
+00D0B0     (base 16)		BITSWITCH LTD.
+				3 MEADOW COURT, AMOS ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-D0-30   (hex)		Safetran Systems Corp
+00D030     (base 16)		Safetran Systems Corp
+				10655 7th Street
+				Rancho Cucamonga  CA  91730
+				US
+
+00-30-2A   (hex)		SOUTHERN INFORMATION
+00302A     (base 16)		SOUTHERN INFORMATION
+				SYSTEM, INC.
+				HSINCHU  TAIWAN,  R.O.C.
+				TW
+
+00-30-E1   (hex)		Network Equipment Technologies, Inc.
+0030E1     (base 16)		Network Equipment Technologies, Inc.
+				6900 Paseo Padre Parkway
+				Fremont  CA  94555
+				US
+
+00-30-2B   (hex)		INALP NETWORKS, INC.
+00302B     (base 16)		INALP NETWORKS, INC.
+				MERIEDWEG 7
+				    
+				CH
+
+00-30-01   (hex)		SMP
+003001     (base 16)		SMP
+				22, RUE DES COSMONAUTES
+				    
+				FR
+
+00-D0-8B   (hex)		ADVA Optical Networking Ltd.
+00D08B     (base 16)		ADVA Optical Networking Ltd.
+				ADVAntage House
+				York    YO30 4RY
+				GB
+
+00-D0-E4   (hex)		Cisco Systems, Inc
+00D0E4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-5A   (hex)		SYMBIONICS, LTD.
+00D05A     (base 16)		SYMBIONICS, LTD.
+				ST. JOHN'S INNOVATION PARK
+				    ENGLAND
+				GB
+
+00-D0-79   (hex)		Cisco Systems, Inc
+00D079     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-21   (hex)		REGENT ELECTRONICS CORP.
+00D021     (base 16)		REGENT ELECTRONICS CORP.
+				200 CENTENNIAL AVE.-STE. #201
+				PISCATAWAY  NJ  08854
+				US
+
+00-D0-9F   (hex)		NOVTEK TEST SYSTEMS
+00D09F     (base 16)		NOVTEK TEST SYSTEMS
+				2170 PARAGON DRIVE
+				SAN JOSE  CA  95131
+				US
+
+00-D0-FE   (hex)		ASTRAL POINT
+00D0FE     (base 16)		ASTRAL POINT
+				COMMUNICATIONS, INC.
+				CHELMSFORD  MA  01824
+				US
+
+00-D0-D4   (hex)		V-BITS, INC.
+00D0D4     (base 16)		V-BITS, INC.
+				2150 TRADE ZONE BLVD.
+				SAN JOSE  CA  95131
+				US
+
+00-D0-84   (hex)		NEXCOMM SYSTEMS, INC.
+00D084     (base 16)		NEXCOMM SYSTEMS, INC.
+				SUIT #NAL-903,
+				SUNGNAM-CITY  SUNGNAM-CITY  KYUNGGI-DO,K
+				KR
+
+00-D0-99   (hex)		Elcard Wireless Systems Oy
+00D099     (base 16)		Elcard Wireless Systems Oy
+				P.O. BOX 120/BECKERINTIC 38
+				    
+				FI
+
+00-D0-E7   (hex)		VCON TELECOMMUNICATION LTD.
+00D0E7     (base 16)		VCON TELECOMMUNICATION LTD.
+				22 MASKIT STREET
+				    
+				IL
+
+00-D0-1B   (hex)		MIMAKI ENGINEERING CO., LTD.
+00D01B     (base 16)		MIMAKI ENGINEERING CO., LTD.
+				5-9-41 KITA SHINAGAWA
+				    
+				JP
+
+00-D0-0D   (hex)		MICROMERITICS INSTRUMENT
+00D00D     (base 16)		MICROMERITICS INSTRUMENT
+				CORPORATION
+				NORCROSS  GA  30093-1877
+				US
+
+00-D0-54   (hex)		SAS INSTITUTE INC.
+00D054     (base 16)		SAS INSTITUTE INC.
+				SAS CAMPUS DRIVE, R4
+				CARY  NC  27511
+				US
+
+00-D0-09   (hex)		HSING TECH. ENTERPRISE CO. LTD
+00D009     (base 16)		HSING TECH. ENTERPRISE CO. LTD
+				NO.2, LANE 128, SEC. 2
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-D0-F4   (hex)		CARINTHIAN TECH INSTITUTE
+00D0F4     (base 16)		CARINTHIAN TECH INSTITUTE
+				RICHARD-WAGNER STR. 19
+				    
+				AT
+
+00-D0-7D   (hex)		COSINE COMMUNICATIONS
+00D07D     (base 16)		COSINE COMMUNICATIONS
+				1200 BRIDGE PARKWAY
+				REDWOOD CITY  CA  94065
+				US
+
+00-D0-83   (hex)		INVERTEX, INC.
+00D083     (base 16)		INVERTEX, INC.
+				1012 MORSE AVENUE- STE.#9
+				SUNNYVALE  CA  94089
+				US
+
+00-D0-BA   (hex)		Cisco Systems, Inc
+00D0BA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-98   (hex)		Photon Dynamics Canada Inc.
+00D098     (base 16)		Photon Dynamics Canada Inc.
+				221 Whitehall Drive
+				    L3R 9T1
+				CA
+
+00-D0-BE   (hex)		EMUTEC INC.
+00D0BE     (base 16)		EMUTEC INC.
+				P.O. BOX 3035
+				EVERETT  WA  98203
+				US
+
+00-D0-92   (hex)		GLENAYRE WESTERN MULTIPLEX
+00D092     (base 16)		GLENAYRE WESTERN MULTIPLEX
+				1196 BORREGAS AVENUE
+				SUNNYVALE  CA  94089
+				US
+
+00-50-9D   (hex)		THE INDUSTREE B.V.
+00509D     (base 16)		THE INDUSTREE B.V.
+				P.O. BOX 462
+				  THE  
+				NL
+
+00-D0-B8   (hex)		Iomega Corporation
+00D0B8     (base 16)		Iomega Corporation
+				1821 West 4000 South
+				Roy  UT  84067
+				US
+
+00-50-CB   (hex)		JETTER
+0050CB     (base 16)		JETTER
+				GRAETERSTRASSE 2
+				    
+				DE
+
+00-50-58   (hex)		Sangoma Technologies
+005058     (base 16)		Sangoma Technologies
+				100 Renfrew Drive, Suite 100
+				Markham  ON  L3R 9R6
+				CA
+
+00-50-74   (hex)		ADVANCED HI-TECH CORP.
+005074     (base 16)		ADVANCED HI-TECH CORP.
+				1990 EAST GRAND AVE.
+				EL SEGUNDO  CA  90505
+				US
+
+00-50-0A   (hex)		IRIS TECHNOLOGIES, INC.
+00500A     (base 16)		IRIS TECHNOLOGIES, INC.
+				WESTMORELAND INDUSRIAL PARK
+				GREENSBURG  PA  15601
+				US
+
+00-50-6D   (hex)		VIDEOJET SYSTEMS
+00506D     (base 16)		VIDEOJET SYSTEMS
+				INTERNATIONAL INC.
+				WOODDALE  IL  60091-1073
+				US
+
+00-50-CA   (hex)		NET TO NET TECHNOLOGIES
+0050CA     (base 16)		NET TO NET TECHNOLOGIES
+				680 CENTRAL AVENUE - STE. #301
+				DOVER  NH  03820
+				US
+
+00-D0-C7   (hex)		PATHWAY, INC.
+00D0C7     (base 16)		PATHWAY, INC.
+				777 BETA DRIVE
+				MAYFIELD VILLAGE  OH  44143
+				US
+
+00-D0-7A   (hex)		AMAQUEST COMPUTER CORP.
+00D07A     (base 16)		AMAQUEST COMPUTER CORP.
+				8/F, 79 HSIN-TAI
+				  TAIWAN  R.O.C.
+				TW
+
+00-50-3F   (hex)		ANCHOR GAMES
+00503F     (base 16)		ANCHOR GAMES
+				815 PILOT ROAD - STE
+				LAS VEGAS  NV  89119
+				US
+
+00-50-32   (hex)		PICAZO COMMUNICATIONS, INC.
+005032     (base 16)		PICAZO COMMUNICATIONS, INC.
+				61 DAGGETT DRIVE
+				SAN JOSE  CA  95134
+				US
+
+00-D0-4A   (hex)		PRESENCE TECHNOLOGY GMBH
+00D04A     (base 16)		PRESENCE TECHNOLOGY GMBH
+				+ CO. KG
+				    
+				DE
+
+00-D0-74   (hex)		TAQUA SYSTEMS, INC.
+00D074     (base 16)		TAQUA SYSTEMS, INC.
+				1600 FALMOUTH RD. - STE
+				CENTERVILLE  MA  02632
+				US
+
+00-50-4D   (hex)		Tokyo Electron Device Limited
+00504D     (base 16)		Tokyo Electron Device Limited
+				1, Higashikata-machi, Tsuzuki-ku,
+				Yokohama-shi  Kanagawa-ken  
+				JP
+
+00-50-70   (hex)		CHAINTECH COMPUTER CO., LTD.
+005070     (base 16)		CHAINTECH COMPUTER CO., LTD.
+				5TH F, ALLEY 2, LANE 222
+				  TAIWAN  R.O.C.
+				TW
+
+00-50-23   (hex)		PG DESIGN ELECTRONICS, INC.
+005023     (base 16)		PG DESIGN ELECTRONICS, INC.
+				48700 STRUCTURAL DRIVE
+				CHESTERFIELD  MI  48051
+				US
+
+00-50-9E   (hex)		Les Technologies SoftAcoustik Inc.
+00509E     (base 16)		Les Technologies SoftAcoustik Inc.
+				
+				Quebec G1K  3P6    
+				CA
+
+00-50-71   (hex)		AIWA CO., LTD.
+005071     (base 16)		AIWA CO., LTD.
+				1-11, KAMITOMATSURI 4-CHOME
+				UTSUNOMIYA-SHI, TOCHIGI-KEN 320-85    
+				JP
+
+00-50-5F   (hex)		BRAND INNOVATORS
+00505F     (base 16)		BRAND INNOVATORS
+				Steenovenweg 5
+				Helmond    5708 HN
+				NL
+
+00-50-B4   (hex)		SATCHWELL CONTROL SYSTEMS, LTD
+0050B4     (base 16)		SATCHWELL CONTROL SYSTEMS, LTD
+				P.O. BOX 57,  94 FARNHAM ROAD
+				BERKSHIRE SL1 4UH    
+				GB
+
+00-50-D6   (hex)		ATLAS COPCO TOOLS AB
+0050D6     (base 16)		ATLAS COPCO TOOLS AB
+				
+				S-105 23 STOCKHOLM    
+				SE
+
+00-50-82   (hex)		FORESSON CORPORATION
+005082     (base 16)		FORESSON CORPORATION
+				3F, NO.9 SEC.1
+				TAIPEI 10404    
+				TW
+
+00-50-DF   (hex)		AirFiber, Inc.
+0050DF     (base 16)		AirFiber, Inc.
+				P.O. BOX 502148
+				SAN DIEGO  CA  92150-2148
+				US
+
+00-50-C5   (hex)		ADS Technologies, Inc
+0050C5     (base 16)		ADS Technologies, Inc
+				12627 Hiddencreek Way
+				Cerritos  CA  90703
+				US
+
+00-50-8E   (hex)		OPTIMATION, INC.
+00508E     (base 16)		OPTIMATION, INC.
+				P.O. BOX 14357
+				HUNTSVILLE  AL  35815
+				US
+
+00-50-28   (hex)		AVAL COMMUNICATIONS
+005028     (base 16)		AVAL COMMUNICATIONS
+				1777 NORTH CALIFORNIA BLVD.
+				WALNUT CREEK  CA  94596
+				US
+
+00-50-2F   (hex)		TollBridge Technologies, Inc.
+00502F     (base 16)		TollBridge Technologies, Inc.
+				872 HERMOSA DRIVE
+				SUNNYVALE  CA  94086
+				US
+
+00-50-FE   (hex)		PCTVnet ASA
+0050FE     (base 16)		PCTVnet ASA
+				STRANDVEILEN 50
+				N-1324 LYSAKER    
+				NO
+
+00-50-AB   (hex)		NALTEC, Inc.
+0050AB     (base 16)		NALTEC, Inc.
+				1-1-15, Nakanogo, Shimizu-ku
+				Shizuoka-shi  Shizuoka  424-0888
+				JP
+
+00-50-37   (hex)		KOGA ELECTRONICS CO.
+005037     (base 16)		KOGA ELECTRONICS CO.
+				5-8-10, TEHARA, RITTO-CHO
+				SHIGA, 420-3047    
+				JP
+
+00-50-A8   (hex)		OpenCon Systems, Inc.
+0050A8     (base 16)		OpenCon Systems, Inc.
+				377 HOES LANE
+				PISCATAWAY  NJ  08854
+				US
+
+00-50-9C   (hex)		BETA RESEARCH
+00509C     (base 16)		BETA RESEARCH
+				BETASTR. 1
+				85774 UNTERFOEHRING    
+				DE
+
+00-50-B1   (hex)		GIDDINGS & LEWIS
+0050B1     (base 16)		GIDDINGS & LEWIS
+				660 S. MILITARY RD.
+				FOND DU LAC  WI  54935
+				US
+
+00-50-06   (hex)		TAC AB
+005006     (base 16)		TAC AB
+				JAGERSHILLGATON 18
+				21375 MALMO    
+				SE
+
+00-50-09   (hex)		PHILIPS BROADBAND NETWORKS
+005009     (base 16)		PHILIPS BROADBAND NETWORKS
+				64 PERIMETER CENTRE EAST
+				ATLANTA  GA  30346
+				US
+
+00-50-30   (hex)		FUTURE PLUS SYSTEMS
+005030     (base 16)		FUTURE PLUS SYSTEMS
+				36 OLDE ENGLISH RD.
+				BEDFORD  NH  03110
+				US
+
+00-50-78   (hex)		MEGATON HOUSE, LTD.
+005078     (base 16)		MEGATON HOUSE, LTD.
+				ZIP: 224 NO.1-3-5 NAKAMACHIBAI
+				YOKOHAMA    
+				JP
+
+00-50-02   (hex)		OMNISEC AG
+005002     (base 16)		OMNISEC AG
+				RIETSTRASSE 14
+				CH-8108 DAELLIKON    
+				CH
+
+00-50-6A   (hex)		EDEVA, INC.
+00506A     (base 16)		EDEVA, INC.
+				298 S. SUNNYVALE AVE. - #208
+				SUNNYVALE  CA  94086
+				US
+
+00-50-AA   (hex)		KONICA MINOLTA HOLDINGS, INC.
+0050AA     (base 16)		KONICA MINOLTA HOLDINGS, INC.
+				1-6-1, Marunouchi,
+				Tokyo    100-0005
+				JP
+
+00-50-38   (hex)		DAIN TELECOM CO., LTD.
+005038     (base 16)		DAIN TELECOM CO., LTD.
+				2ND Flr., OH-SUNG BLDG. #2-28
+				YANGJAE-DONG, SEOCHO-GU  SEOUL  
+				KR
+
+00-50-B7   (hex)		BOSER TECHNOLOGY CO., LTD.
+0050B7     (base 16)		BOSER TECHNOLOGY CO., LTD.
+				15F-6, 77 HSIN TAI WU ROAD
+				TAIPEI HSIEN    
+				TW
+
+00-90-88   (hex)		BAXALL SECURITY LTD.
+009088     (base 16)		BAXALL SECURITY LTD.
+				UNIT 1 CASTLEHILL
+				STOCKPORT  Great Britain SK6 2SV  
+				GB
+
+00-90-6C   (hex)		Sartorius Hamburg GmbH
+00906C     (base 16)		Sartorius Hamburg GmbH
+				Meiendorferstraße 205
+				Hamburg    D-22145
+				DE
+
+00-90-A4   (hex)		ALTIGA NETWORKS
+0090A4     (base 16)		ALTIGA NETWORKS
+				124 GROVE STREET
+				FRANKLIN  MA  02038-3206
+				US
+
+00-90-F9   (hex)		Imagine Communications
+0090F9     (base 16)		Imagine Communications
+				3001 Dallas Parkway, Suite 300
+				Frisco  TX  75034
+				US
+
+00-90-89   (hex)		SOFTCOM MICROSYSTEMS, INC.
+009089     (base 16)		SOFTCOM MICROSYSTEMS, INC.
+				47509 SEABRIDGE DRIVE
+				FREMONT  CA  94538
+				US
+
+00-90-EE   (hex)		PERSONAL COMMUNICATIONS TECHNOLOGIES
+0090EE     (base 16)		PERSONAL COMMUNICATIONS TECHNOLOGIES
+				50 STILES ROAD
+				SALEM  NH  03079
+				US
+
+00-90-80   (hex)		NOT LIMITED, INC.
+009080     (base 16)		NOT LIMITED, INC.
+				500 ALLERTON STREET, STE #102
+				REDWOOD CITY  CA  94063
+				US
+
+00-90-E8   (hex)		MOXA TECHNOLOGIES CORP., LTD.
+0090E8     (base 16)		MOXA TECHNOLOGIES CORP., LTD.
+				7F, NO. 2, ALY6, LN 235
+				SHIENG-TIEN CITY  TAIPEI  
+				TW
+
+00-90-A1   (hex)		Flying Pig Systems/High End Systems Inc.
+0090A1     (base 16)		Flying Pig Systems/High End Systems Inc.
+				2105 Gracy Farms Lane
+				Austin  TX  78758
+				US
+
+00-90-79   (hex)		ClearOne, Inc.
+009079     (base 16)		ClearOne, Inc.
+				299 WASHINGTON STREET
+				WOBURN  MA  01801
+				US
+
+00-90-9A   (hex)		ONE WORLD SYSTEMS, INC.
+00909A     (base 16)		ONE WORLD SYSTEMS, INC.
+				1144 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-90-C2   (hex)		JK microsystems, Inc.
+0090C2     (base 16)		JK microsystems, Inc.
+				1275 YUBA AVENUE
+				SAN PABLO  CA  94806
+				US
+
+00-50-D0   (hex)		MINERVA SYSTEMS
+0050D0     (base 16)		MINERVA SYSTEMS
+				1585 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  84943
+				US
+
+00-50-D8   (hex)		UNICORN COMPUTER CORP.
+0050D8     (base 16)		UNICORN COMPUTER CORP.
+				7 FL.,  NO. 96 KWANG FU NORTH ROAD
+				TAIPEI    
+				TW
+
+00-50-B2   (hex)		BRODEL GmbH
+0050B2     (base 16)		BRODEL GmbH
+				Distelbusch 24
+				Velbert  NRW  42549
+				DE
+
+00-90-76   (hex)		FMT AIRCRAFT GATE SUPPORT SYSTEMS AB
+009076     (base 16)		FMT AIRCRAFT GATE SUPPORT SYSTEMS AB
+				
+				SE-231 32 TRELLEBORG    
+				SE
+
+00-90-17   (hex)		Zypcom, Inc
+009017     (base 16)		Zypcom, Inc
+				28400 Kohoutek Way
+				Union City  CA  94587-1212
+				US
+
+00-90-49   (hex)		ENTRIDIA CORPORATION
+009049     (base 16)		ENTRIDIA CORPORATION
+				101 PARK CENTER PLAZA
+				SAN JOSE  CA  95113-2218
+				US
+
+00-90-E6   (hex)		ALi Corporation
+0090E6     (base 16)		ALi Corporation
+				6F, 246 NeiHu Road, Sec. 1
+				Taipei    114
+				TW
+
+00-90-70   (hex)		NEO NETWORKS, INC.
+009070     (base 16)		NEO NETWORKS, INC.
+				10300 BREN ROAD EAST
+				MINNETONKA  MN  55343
+				US
+
+00-90-30   (hex)		HONEYWELL-DATING
+009030     (base 16)		HONEYWELL-DATING
+				VIA TINTORETTO, 15
+				21012 CASSANO MAGNAGO (VA)    
+				IT
+
+00-90-08   (hex)		HanA Systems Inc.
+009008     (base 16)		HanA Systems Inc.
+				EAHO B/D 740-1
+				SEOUL    
+				KR
+
+00-90-AC   (hex)		OPTIVISION, INC.
+0090AC     (base 16)		OPTIVISION, INC.
+				3450 HILLVIEW AVENUE
+				PALO ALTO  CA  94304
+				US
+
+00-90-4E   (hex)		DELEM BV
+00904E     (base 16)		DELEM BV
+				LUCHTHAVEN WEG 42
+				5657 EB EINDHOVEN    
+				NL
+
+00-90-ED   (hex)		CENTRAL SYSTEM RESEARCH CO., LTD.
+0090ED     (base 16)		CENTRAL SYSTEM RESEARCH CO., LTD.
+				4-13-2 HIYOSHICHO
+				KOKUBUNJI-CITY  TOKYO 18500032  
+				JP
+
+00-90-1E   (hex)		Selesta Ingegneria S.p.A.
+00901E     (base 16)		Selesta Ingegneria S.p.A.
+				via di Francia, 28
+				Genova    16149
+				IT
+
+00-90-75   (hex)		NEC DO BRASIL S.A.
+009075     (base 16)		NEC DO BRASIL S.A.
+				RODOVIA PRESIDENTE DUTRA, KM 218
+				São Paulo-SP  CEP - 07210-902  
+				BR
+
+00-90-AD   (hex)		ASPECT ELECTRONICS, INC.
+0090AD     (base 16)		ASPECT ELECTRONICS, INC.
+				12740 EARHART AVE.
+				AUBURN  CA  95602
+				US
+
+00-90-01   (hex)		NISHIMU ELECTRONICS INDUSTRIES CO., LTD.
+009001     (base 16)		NISHIMU ELECTRONICS INDUSTRIES CO., LTD.
+				700 TATENO MITAGAWA-CHO
+				KANZAKI-GUN SAGA PREF.    
+				JP
+
+00-90-43   (hex)		Tattile SRL 
+009043     (base 16)		Tattile SRL 
+				1-13-10 SHIROGANE  CHUO-KU
+				FUKUOKA-CITY    
+				JP
+
+00-90-CB   (hex)		Wireless OnLine, Inc.
+0090CB     (base 16)		Wireless OnLine, Inc.
+				4410 EL CAMINO REAL,  STE #101
+				LOS ALTOS  CA  94022
+				US
+
+00-10-63   (hex)		STARGUIDE DIGITAL NETWORKS
+001063     (base 16)		STARGUIDE DIGITAL NETWORKS
+				5754 PACIFIC CENTER BLVD.
+				SAN DIEGO  CA  92121
+				US
+
+00-10-23   (hex)		Network Equipment Technologies
+001023     (base 16)		Network Equipment Technologies
+				6900 Paseo Padre Parkway
+				Freemont  CA  94555-3660
+				US
+
+00-10-2B   (hex)		UMAX DATA SYSTEMS, INC.
+00102B     (base 16)		UMAX DATA SYSTEMS, INC.
+				NO. 1-1, R&D ROAD 2
+				HSINCHU    
+				TW
+
+00-90-8A   (hex)		BAYLY COMMUNICATIONS, INC.
+00908A     (base 16)		BAYLY COMMUNICATIONS, INC.
+				105 GREEN COURT
+				AJAX  Ontario  L1S 6W9  
+				CA
+
+00-90-0E   (hex)		HANDLINK TECHNOLOGIES, INC.
+00900E     (base 16)		HANDLINK TECHNOLOGIES, INC.
+				5F, 24-2, Industry E. Road IV,
+				Hsinchu 30077    
+				TW
+
+00-90-C1   (hex)		Peco II, Inc.
+0090C1     (base 16)		Peco II, Inc.
+				7060 Huntley Road
+				Columbus  OH  43229
+				US
+
+00-10-8D   (hex)		Johnson Controls, Inc.
+00108D     (base 16)		Johnson Controls, Inc.
+				507 E. Michigan St.
+				Milwaukee  WI  53201
+				US
+
+00-10-45   (hex)		Nortel Networks
+001045     (base 16)		Nortel Networks
+				OPTera Solutions Division
+				Kanata  Ontario K2K-2X3  
+				CA
+
+00-10-7D   (hex)		AURORA COMMUNICATIONS, LTD.
+00107D     (base 16)		AURORA COMMUNICATIONS, LTD.
+				P.O. BOX 1942
+				NSW 2113    
+				AU
+
+00-90-E4   (hex)		NEC AMERICA, INC.
+0090E4     (base 16)		NEC AMERICA, INC.
+				3100 N.E. SHUTE ROAD
+				HILLSBORO  OR  97124
+				US
+
+00-90-40   (hex)		Siemens Network Convergence LLC
+009040     (base 16)		Siemens Network Convergence LLC
+				Ten Technology Park Drive
+				Westford  MA  01886-3146
+				US
+
+00-90-C8   (hex)		WAVERIDER COMMUNICATIONS (CANADA) INC.
+0090C8     (base 16)		WAVERIDER COMMUNICATIONS (CANADA) INC.
+				
+				  British Columbia V1E 4R9  
+				CA
+
+00-90-1B   (hex)		DIGITAL CONTROLS
+00901B     (base 16)		DIGITAL CONTROLS
+				305 PIONEER BLVD.
+				SPRINGBORO  OH  45066-1100
+				US
+
+00-90-F7   (hex)		NBASE COMMUNICATIONS LTD.
+0090F7     (base 16)		NBASE COMMUNICATIONS LTD.
+				INDUSTRIAL PARK
+				    
+				IL
+
+00-90-12   (hex)		GLOBESPAN SEMICONDUCTOR, INC.
+009012     (base 16)		GLOBESPAN SEMICONDUCTOR, INC.
+				100 SCHULZ DRIVE
+				RED BANK  NJ  07701
+				US
+
+00-90-B7   (hex)		DIGITAL LIGHTWAVE, INC.
+0090B7     (base 16)		DIGITAL LIGHTWAVE, INC.
+				601 CLEVELAND STREET- 5TH FL.
+				CLEARWATER  FL  33755
+				US
+
+00-90-A0   (hex)		8X8 INC.
+0090A0     (base 16)		8X8 INC.
+				2445 MISSION COLLEGE BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+00-90-47   (hex)		GIGA FAST E. LTD.
+009047     (base 16)		GIGA FAST E. LTD.
+				14F, NO.112, SEC. 1
+				Hsi-Chih  Taipei Hsien  
+				TW
+
+00-90-E1   (hex)		TELENA S.P.A.
+0090E1     (base 16)		TELENA S.P.A.
+				VIA SAVONA, 146
+				20144 MILANO    
+				IT
+
+00-90-32   (hex)		PELCOMBE GROUP LTD.
+009032     (base 16)		PELCOMBE GROUP LTD.
+				MAIN ROAD
+				  ESSEX C012 4LP  
+				GB
+
+00-10-62   (hex)		NX SERVER, ILNC.
+001062     (base 16)		NX SERVER, ILNC.
+				5401 E. LA PALMA AVE.
+				ANAHEIM  CA  92807
+				US
+
+00-10-F0   (hex)		RITTAL-WERK RUDOLF LOH GmbH & Co.
+0010F0     (base 16)		RITTAL-WERK RUDOLF LOH GmbH & Co.
+				AUF DEM STUTZELBERG
+				D-35745 HERBORN    
+				DE
+
+00-10-01   (hex)		Citel
+001001     (base 16)		Citel
+				Loughborough Innovation Centre
+				Loughborough    LE11 3EH
+				GB
+
+00-10-5C   (hex)		QUANTUM DESIGNS (H.K.) LTD.
+00105C     (base 16)		QUANTUM DESIGNS (H.K.) LTD.
+				5/F., SOMERSET HOUSE, TAIKOO PLACE
+				QUARRY BAY    
+				HK
+
+00-10-CF   (hex)		FIBERLANE COMMUNICATIONS
+0010CF     (base 16)		FIBERLANE COMMUNICATIONS
+				1318 REDWOOD WAY, #200
+				PETALUMA  CA  94954
+				US
+
+00-10-69   (hex)		HELIOSS COMMUNICATIONS, INC.
+001069     (base 16)		HELIOSS COMMUNICATIONS, INC.
+				391 TOTTEM POND RD.- STE#303
+				WALTHAM  MA  02154
+				US
+
+00-10-BF   (hex)		InterAir Wireless
+0010BF     (base 16)		InterAir Wireless
+				485 CAYUGA ROAD
+				BUFFALO  NY  14225-0222
+				US
+
+00-10-26   (hex)		ACCELERATED NETWORKS, INC.
+001026     (base 16)		ACCELERATED NETWORKS, INC.
+				31238 VIA COLINAS, UNIT
+				WESTLAKE VILLAGE  CA  91362
+				US
+
+00-10-36   (hex)		INTER-TEL INTEGRATED SYSTEMS
+001036     (base 16)		INTER-TEL INTEGRATED SYSTEMS
+				7300 W. BOSTON STREET
+				CHANDLER  AZ  85226
+				US
+
+00-10-39   (hex)		Vectron Systems AG
+001039     (base 16)		Vectron Systems AG
+				Willy-Brandt-Weg 41
+				48155 Muenster    
+				DE
+
+00-10-B6   (hex)		ENTRATA COMMUNICATIONS CORP.
+0010B6     (base 16)		ENTRATA COMMUNICATIONS CORP.
+				574 HERITAGE RD.
+				SOUTHBURY  CT  06488
+				US
+
+00-10-EC   (hex)		RPCG, LLC
+0010EC     (base 16)		RPCG, LLC
+				749 MINER ROAD
+				HIGHLAND HTS  OH  44143-2117
+				US
+
+00-10-59   (hex)		DIABLO RESEARCH CO. LLC
+001059     (base 16)		DIABLO RESEARCH CO. LLC
+				825 STEWART DRIVE
+				SUNNYVALE  CA  94086
+				US
+
+00-10-FC   (hex)		BROADBAND NETWORKS, INC.
+0010FC     (base 16)		BROADBAND NETWORKS, INC.
+				37 STEVENSON ROAD
+				WINNIPEG, MANITOBA R3H 0H9    
+				CA
+
+00-10-31   (hex)		OBJECTIVE COMMUNICATIONS, INC.
+001031     (base 16)		OBJECTIVE COMMUNICATIONS, INC.
+				75 ROCHESTER AVE.
+				PORTSMOUTH  NH  03801
+				US
+
+00-10-6D   (hex)		Axxcelera Broadband Wireless
+00106D     (base 16)		Axxcelera Broadband Wireless
+				1600 East Parham Road
+				Richmond  VA  23228
+				US
+
+00-10-4C   (hex)		Teledyne LeCroy, Inc
+00104C     (base 16)		Teledyne LeCroy, Inc
+				3385 Scott Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-10-CC   (hex)		CLP COMPUTER LOGISTIK PLANUNG GmbH
+0010CC     (base 16)		CLP COMPUTER LOGISTIK PLANUNG GmbH
+				BASSERMANNSTR. 21
+				 D-81245 MUENCHEN    
+				DE
+
+00-10-30   (hex)		EION Inc.
+001030     (base 16)		EION Inc.
+				320 March Road
+				Ottawa  ON  K2K 2E3
+				CA
+
+00-10-D0   (hex)		WITCOM, LTD.
+0010D0     (base 16)		WITCOM, LTD.
+				P.O.B. 2250
+				HAIFA  31021    
+				IL
+
+00-10-93   (hex)		CMS COMPUTERS, LTD.
+001093     (base 16)		CMS COMPUTERS, LTD.
+				201 ARCADIA
+				MUMBAI 400 0021    
+				IN
+
+00-10-8F   (hex)		RAPTOR SYSTEMS
+00108F     (base 16)		RAPTOR SYSTEMS
+				69 HICKORY AVE.
+				WALTHAM  MA  02154
+				US
+
+00-10-A4   (hex)		XIRCOM
+0010A4     (base 16)		XIRCOM
+				2300 CORPORATE CENTER DR.
+				THOUSAND OAKS  CA  91320
+				US
+
+00-10-F1   (hex)		I-O CORPORATION
+0010F1     (base 16)		I-O CORPORATION
+				2256 SOUTH 3600 WEST
+				SALT LAKE CITY  UT  84119
+				US
+
+00-10-66   (hex)		ADVANCED CONTROL SYSTEMS, INC.
+001066     (base 16)		ADVANCED CONTROL SYSTEMS, INC.
+				2755 NORTHWOODS PARKWAY
+				NORCROSS  GA  30071
+				US
+
+00-10-AC   (hex)		IMCI TECHNOLOGIES
+0010AC     (base 16)		IMCI TECHNOLOGIES
+				8401 OLD COURT HKOUSE RD
+				VIENNA  VA  22182
+				US
+
+00-10-B1   (hex)		FOR-A CO., LTD.
+0010B1     (base 16)		FOR-A CO., LTD.
+				2-3-3 OOSAKU
+				CHIBA PREF. 285    
+				JP
+
+00-10-EE   (hex)		CTI PRODUCTS, INC.
+0010EE     (base 16)		CTI PRODUCTS, INC.
+				1211 W. SHARON RD.
+				CINCINNATI  OH  45240
+				US
+
+00-10-41   (hex)		BRISTOL BABCOCK, INC.
+001041     (base 16)		BRISTOL BABCOCK, INC.
+				1100 BUCKINGHAM STREET
+				WATERTOWN  CT  06795
+				US
+
+00-10-AA   (hex)		MEDIA4, INC.
+0010AA     (base 16)		MEDIA4, INC.
+				250 14TH ST. NW - STE #4002
+				ATLANTA  GA  30318
+				US
+
+00-10-E8   (hex)		TELOCITY, INCORPORATED
+0010E8     (base 16)		TELOCITY, INCORPORATED
+				992 SOUTH DE ANZA BLVD
+				SAN JOSE  CA  95129
+				US
+
+00-10-A2   (hex)		TNS
+0010A2     (base 16)		TNS
+				800 Third Street, Suite B100
+				HERNDON  VA  20170
+				US
+
+00-10-65   (hex)		RADYNE CORPORATION
+001065     (base 16)		RADYNE CORPORATION
+				5225 S. 37TH STREET
+				PHOENIX  AZ  85040
+				US
+
+00-10-9F   (hex)		PAVO, INC.
+00109F     (base 16)		PAVO, INC.
+				95 YESLER WAY
+				SEATTLE  WA  98104
+				US
+
+00-10-1D   (hex)		WINBOND ELECTRONICS CORP.
+00101D     (base 16)		WINBOND ELECTRONICS CORP.
+				NO. 4, CREATION RD. III
+				HSIN CHU    
+				TW
+
+00-10-84   (hex)		K-BOT COMMUNICATIONS
+001084     (base 16)		K-BOT COMMUNICATIONS
+				P.O. BOX 410
+				NORTON  MA  02766
+				US
+
+00-10-00   (hex)		CABLE TELEVISION LABORATORIES, INC.
+001000     (base 16)		CABLE TELEVISION LABORATORIES, INC.
+				858 Coal Creek Circle
+				Louisville  CO  80027
+				US
+
+00-10-09   (hex)		HORANET
+001009     (base 16)		HORANET
+				 ZI Route de Niort – BP 70328
+				FONTENAY LE COMTE CEDEX  VENDEE   85206
+				FR
+
+00-10-F8   (hex)		TEXIO TECHNOLOGY CORPORATION
+0010F8     (base 16)		TEXIO TECHNOLOGY CORPORATION
+				2-18-13 Shin Yokohama,
+				    222-0033
+				JP
+
+00-10-C0   (hex)		ARMA, Inc.
+0010C0     (base 16)		ARMA, Inc.
+				4851 Northshore Lane
+				North Little Rock  AR  72118
+				US
+
+00-10-5B   (hex)		NET INSIGHT AB
+00105B     (base 16)		NET INSIGHT AB
+				Västberga Allé 9
+				SE-1260  30 Hägersten  
+				SE
+
+00-10-02   (hex)		ACTIA
+001002     (base 16)		ACTIA
+				25 CHEMIN DE POUVOURVILLE
+				31432 TOULOUSE,  CEDEX 04    
+				FR
+
+00-10-EB   (hex)		SELSIUS SYSTEMS, INC.
+0010EB     (base 16)		SELSIUS SYSTEMS, INC.
+				5057 KELLER SPRINGS RD.
+				DALLAS  TX  75248
+				US
+
+00-10-57   (hex)		Rebel.com, Inc.
+001057     (base 16)		Rebel.com, Inc.
+				150 ISABELLA STREET--STE. 1000
+				OTTAWA, ONTARIO K1S 1V7    
+				CA
+
+00-10-F9   (hex)		UNIQUE SYSTEMS, INC.
+0010F9     (base 16)		UNIQUE SYSTEMS, INC.
+				181 DON PARK RD
+				MARKHAM, ONTARIO L3R 1C2    
+				CA
+
+00-10-75   (hex)		Segate Technology LLC
+001075     (base 16)		Segate Technology LLC
+				10200 S De Anza Blvd
+				Cupertino  CA  95014
+				US
+
+00-E0-03   (hex)		NOKIA WIRELESS BUSINESS COMMUN
+00E003     (base 16)		NOKIA WIRELESS BUSINESS COMMUN
+				ACCESS POINT PRODUCTS GROUP
+				CB4 0WS    
+				GB
+
+00-E0-F3   (hex)		WebSprint Communications, Inc.
+00E0F3     (base 16)		WebSprint Communications, Inc.
+				3026 SCOTT BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+08-BB-CC   (hex)		AK-NORD EDV VERTRIEBSGES. mbH
+08BBCC     (base 16)		AK-NORD EDV VERTRIEBSGES. mbH
+				FRIEDRICHSTRASSE 10
+				25436 TORNESCH    
+				DE
+
+00-E0-DB   (hex)		ViaVideo Communications, Inc.
+00E0DB     (base 16)		ViaVideo Communications, Inc.
+				8900 SHOAL CREEK BLVD.
+				AUSTIN  TX  78757
+				US
+
+00-E0-A6   (hex)		TELOGY NETWORKS, INC.
+00E0A6     (base 16)		TELOGY NETWORKS, INC.
+				20250 CENTURY BLVD.
+				GERMANTOWN  MD  20874
+				US
+
+00-E0-9F   (hex)		PIXEL VISION
+00E09F     (base 16)		PIXEL VISION
+				43 NAGOG PARK
+				ACTON  MA  01720
+				US
+
+00-E0-CC   (hex)		HERO SYSTEMS, LTD.
+00E0CC     (base 16)		HERO SYSTEMS, LTD.
+				THE BARNES, COOMBELANDS LANE,
+				SURREY KT15 1HY  ENGLAND  
+				GB
+
+00-E0-80   (hex)		CONTROL RESOURCES CORPORATION
+00E080     (base 16)		CONTROL RESOURCES CORPORATION
+				16-00 POLLITT DRIVE
+				FAIR LAWN  NJ  07410
+				US
+
+00-E0-04   (hex)		PMC-SIERRA, INC.
+00E004     (base 16)		PMC-SIERRA, INC.
+				105-8555 BAXTER PLACE
+				BURNABY, BC V5A 4V7    
+				CA
+
+00-E0-3B   (hex)		PROMINET CORPORATION
+00E03B     (base 16)		PROMINET CORPORATION
+				110 TURNPIKE RD. - STE. #208
+				WESTBOROUGH  MA  01581
+				US
+
+00-E0-F5   (hex)		TELES AG
+00E0F5     (base 16)		TELES AG
+				DOVESTR. 2-4
+				10587 BERLIN    
+				DE
+
+00-E0-D7   (hex)		SUNSHINE ELECTRONICS, INC.
+00E0D7     (base 16)		SUNSHINE ELECTRONICS, INC.
+				46560 FREMONT BLVD. -STE. #113
+				FREMONT  CA  94538
+				US
+
+00-E0-B5   (hex)		ARDENT COMMUNICATIONS CORP.
+00E0B5     (base 16)		ARDENT COMMUNICATIONS CORP.
+				3801 ZANKER ROAD,  Suite A
+				SAN JOSE  CA  95134
+				US
+
+00-E0-68   (hex)		MERRIMAC SYSTEMS INC.
+00E068     (base 16)		MERRIMAC SYSTEMS INC.
+				2144 MC COY ROAD
+				CARROLLTON  TX  75006
+				US
+
+00-E0-49   (hex)		MICROWI ELECTRONIC GmbH
+00E049     (base 16)		MICROWI ELECTRONIC GmbH
+				ZUSAMSTRASSE 8
+				D 86165 AUGSBURG    
+				DE
+
+00-E0-95   (hex)		ADVANCED-VISION TECHNOLGIES CORP.
+00E095     (base 16)		ADVANCED-VISION TECHNOLGIES CORP.
+				8F-1, 87 SECTION 3, CHUNG YANG RD,
+				Tu Cheng  Taipei  
+				TW
+
+00-E0-0E   (hex)		AVALON IMAGING SYSTEMS, INC.
+00E00E     (base 16)		AVALON IMAGING SYSTEMS, INC.
+				3133 INDIAN ROAD
+				BOULDER  CO  80301
+				US
+
+00-E0-48   (hex)		SDL COMMUNICATIONS, INC.
+00E048     (base 16)		SDL COMMUNICATIONS, INC.
+				P.O. BOX 1303
+				EASTON  MA  02334
+				US
+
+00-E0-CB   (hex)		RESON, INC.
+00E0CB     (base 16)		RESON, INC.
+				300 LOPEZ ROAD
+				GOLETA  CA  93117
+				US
+
+00-E0-C8   (hex)		VIRTUAL ACCESS, LTD.
+00E0C8     (base 16)		VIRTUAL ACCESS, LTD.
+				WOODSIDE HOUSE, WINKFIELD,
+				WINDSOR, BERKSHIRE SL4 2DX  ENGLAND  
+				GB
+
+00-E0-06   (hex)		SILICON INTEGRATED SYS. CORP.
+00E006     (base 16)		SILICON INTEGRATED SYS. CORP.
+				16, CREATION RD. I
+				HSIN CHU    
+				TW
+
+00-E0-AC   (hex)		MIDSCO, INC.
+00E0AC     (base 16)		MIDSCO, INC.
+				710 ROUTE 46 EAST
+				FAIRFIELD  NJ  07004
+				US
+
+00-E0-08   (hex)		AMAZING CONTROLS! INC.
+00E008     (base 16)		AMAZING CONTROLS! INC.
+				1615 WYATT DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-E0-AE   (hex)		XAQTI CORPORATION
+00E0AE     (base 16)		XAQTI CORPORATION
+				 1630 OAKLAND RD. #A-214
+				SAN JOSE  CA  95131
+				US
+
+00-E0-E0   (hex)		SI ELECTRONICS, LTD.
+00E0E0     (base 16)		SI ELECTRONICS, LTD.
+				28-16, SHIMOMARUKO 2-CHOME,
+				TOKYO 146    
+				JP
+
+00-E0-50   (hex)		EXECUTONE INFORMATION SYSTEMS, INC.
+00E050     (base 16)		EXECUTONE INFORMATION SYSTEMS, INC.
+				478 WHEELERS FARMS ROAD
+				MILFORD  CT  06460
+				US
+
+00-E0-23   (hex)		TELRAD
+00E023     (base 16)		TELRAD
+				P.O. BOX 50
+				LOD 71100    
+				IL
+
+00-E0-2C   (hex)		AST COMPUTER
+00E02C     (base 16)		AST COMPUTER
+				16215 ALTON PARKWAY
+				IRVINE  CA  92718
+				US
+
+00-E0-67   (hex)		eac AUTOMATION-CONSULTING GmbH
+00E067     (base 16)		eac AUTOMATION-CONSULTING GmbH
+				HERMSDORFER DAMM 222
+				73467 BERLIN    
+				DE
+
+00-E0-FA   (hex)		TRL TECHNOLOGY, LTD.
+00E0FA     (base 16)		TRL TECHNOLOGY, LTD.
+				SHANNON WAY, ASHCHURCH,
+				TEWKESBURY, GLOS. GL20 8ND    
+				GB
+
+00-E0-2A   (hex)		TANDBERG TELEVISION AS
+00E02A     (base 16)		TANDBERG TELEVISION AS
+				PHILIP PEDERSENS V 20
+				N-1324 LYSAKER    
+				NO
+
+00-E0-4E   (hex)		SANYO DENKI CO., LTD.
+00E04E     (base 16)		SANYO DENKI CO., LTD.
+				812-3, Shimonogou, Ueda-Shi
+				Nagano    386-1211
+				JP
+
+00-E0-12   (hex)		PLUTO TECHNOLOGIES INTERNATIONAL INC.
+00E012     (base 16)		PLUTO TECHNOLOGIES INTERNATIONAL INC.
+				2511 55TH STREET
+				BOULDER  CO  80301
+				US
+
+00-E0-4C   (hex)		REALTEK SEMICONDUCTOR CORP.
+00E04C     (base 16)		REALTEK SEMICONDUCTOR CORP.
+				1F, NO. 11, INDUSTRY E. RD. IX
+				HSINCHU 300    
+				TW
+
+00-E0-51   (hex)		TALX CORPORATION
+00E051     (base 16)		TALX CORPORATION
+				1850 BORMAN COURT
+				ST. LOUIS  MO  63146
+				US
+
+00-60-6B   (hex)		Synclayer Inc.
+00606B     (base 16)		Synclayer Inc.
+				1-20 Himegaoka
+				GIFU 509-0249    
+				JP
+
+00-60-3B   (hex)		AMTEC spa
+00603B     (base 16)		AMTEC spa
+				LOC. S. MARTINO
+				53025 PIANCASTAGNAIO (SIENA)    
+				IT
+
+00-E0-39   (hex)		PARADYNE CORP.
+00E039     (base 16)		PARADYNE CORP.
+				8545 126TH AVENUE NORTH
+				LARGO  FL  33773
+				US
+
+00-60-0B   (hex)		LOGWARE GmbH
+00600B     (base 16)		LOGWARE GmbH
+				SCHWEDENSTR. 9
+				D-13359 BERLIN    
+				DE
+
+00-E0-C7   (hex)		EUROTECH SRL
+00E0C7     (base 16)		EUROTECH SRL
+				VIA JACOPO LINUSSIO 1
+				33030 AMAROO (UD)    
+				IT
+
+00-E0-AF   (hex)		GENERAL DYNAMICS INFORMATION SYSTEMS
+00E0AF     (base 16)		GENERAL DYNAMICS INFORMATION SYSTEMS
+				COMPUTING DEVICES, LTD.
+				FALLS CHURCH  VA  22042-4523
+				US
+
+00-E0-54   (hex)		KODAI HITEC CO., LTD.
+00E054     (base 16)		KODAI HITEC CO., LTD.
+				2-45 ONUMA HANYU CITY
+				SAITAMA.348    
+				JP
+
+00-E0-B9   (hex)		BYAS SYSTEMS
+00E0B9     (base 16)		BYAS SYSTEMS
+				2250 MONROE STREET,  #371
+				SANTA CLARA  CA  95050
+				US
+
+00-60-4B   (hex)		Safe-com GmbH & Co. KG
+00604B     (base 16)		Safe-com GmbH & Co. KG
+				Burg Lichtenfels 1
+				35104 Lichtenfels    
+				DE
+
+00-E0-EF   (hex)		DIONEX
+00E0EF     (base 16)		DIONEX
+				PO BOX 3603
+				SUNNYVALE  CA  94088-3603
+				US
+
+00-E0-2D   (hex)		InnoMediaLogic, Inc.
+00E02D     (base 16)		InnoMediaLogic, Inc.
+				3653 CHEMIN CHAMBLY
+				LONGUEUIL, QUEBEC J4L J4L    IN9
+				CA
+
+00-E0-35   (hex)		Artesyn Embedded Technologies
+00E035     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way
+				Tempe  AZ  85282
+				US
+
+00-E0-90   (hex)		BECKMAN LAB. AUTOMATION DIV.
+00E090     (base 16)		BECKMAN LAB. AUTOMATION DIV.
+				90 BOROLINE ROAD
+				ALLENDALE  NJ  07401
+				US
+
+00-60-01   (hex)		InnoSys, Inc.
+006001     (base 16)		InnoSys, Inc.
+				3095 RICHMOND PKWY #207
+				RICHMOND  CA  94806
+				US
+
+00-60-FE   (hex)		LYNX SYSTEM DEVELOPERS, INC.
+0060FE     (base 16)		LYNX SYSTEM DEVELOPERS, INC.
+				175N NEW BOSTON STREET
+				WOBURN  MA  01801
+				US
+
+00-60-BD   (hex)		Enginuity Communications
+0060BD     (base 16)		Enginuity Communications
+				3545 Stern Avenue
+				St Charles  IL  60174
+				US
+
+00-08-00   (hex)		MULTITECH SYSTEMS, INC.
+000800     (base 16)		MULTITECH SYSTEMS, INC.
+				2205 WOODALE DRIVE
+				MOUNDS VIEW  MN  55112
+				US
+
+00-E0-85   (hex)		GLOBAL MAINTECH, INC.
+00E085     (base 16)		GLOBAL MAINTECH, INC.
+				6468 CITY WEST PARKWAY
+				EDEN PRAIRIE  MN  55344
+				US
+
+00-E0-BE   (hex)		GENROCO INTERNATIONAL, INC.
+00E0BE     (base 16)		GENROCO INTERNATIONAL, INC.
+				255 ENDERS COURT
+				SLINGER  WI  53086
+				US
+
+00-E0-B6   (hex)		Entrada Networks
+00E0B6     (base 16)		Entrada Networks
+				9020 JUNCTION DRIVE
+				ANNAPOLIS JUNCTION  MD  20701
+				US
+
+00-E0-F4   (hex)		INSIDE Technology A/S
+00E0F4     (base 16)		INSIDE Technology A/S
+				VENLIGHEDSVEJ 6
+				DK-2970 HOERSHOLM    
+				DK
+
+00-E0-A0   (hex)		WILTRON CO.
+00E0A0     (base 16)		WILTRON CO.
+				490 JARVIS DRIVE
+				MORGAN HILL  CA  95037
+				US
+
+00-E0-F1   (hex)		THAT CORPORATION
+00E0F1     (base 16)		THAT CORPORATION
+				734 FOREST STREET
+				MARLBOROUGH  MA  01752
+				US
+
+00-60-D5   (hex)		AMADA MIYACHI Co., Ltd
+0060D5     (base 16)		AMADA MIYACHI Co., Ltd
+				95-3, FUTASUZUKA NODA
+				CHIBA    278-0016
+				JP
+
+00-60-3F   (hex)		PATAPSCO DESIGNS
+00603F     (base 16)		PATAPSCO DESIGNS
+				5350 PARTNERS COURT
+				FREDERICK  MD  21703
+				US
+
+00-60-B5   (hex)		KEBA GmbH
+0060B5     (base 16)		KEBA GmbH
+				GEWERBEPARK URFAHR
+				A-4041 LINZ    
+				AT
+
+00-60-14   (hex)		EDEC CO., LTD.
+006014     (base 16)		EDEC CO., LTD.
+				9F OF T.O.C. BUILDING
+				SHINAGAWAKU,  TOKYO    
+				JP
+
+00-60-AC   (hex)		RESILIENCE CORPORATION
+0060AC     (base 16)		RESILIENCE CORPORATION
+				1755 EMBARCADERO ROAD-STE #120
+				PALO ALTO  CA  94303
+				US
+
+00-60-4E   (hex)		CYCLE COMPUTER CORPORATION, INC.
+00604E     (base 16)		CYCLE COMPUTER CORPORATION, INC.
+				20245 STEVENS CREEK BLVD.
+				CUPERTINO  CA  95014
+				US
+
+00-60-E1   (hex)		ORCKIT COMMUNICATIONS LTD.
+0060E1     (base 16)		ORCKIT COMMUNICATIONS LTD.
+				38 NAHALAT YIZHAK STREET
+				TEL-AVIV  67448    
+				IL
+
+00-60-D2   (hex)		LUCENT TECHNOLOGIES TAIWAN TELECOMMUNICATIONS CO., LTD.
+0060D2     (base 16)		LUCENT TECHNOLOGIES TAIWAN TELECOMMUNICATIONS CO., LTD.
+				#2, INNOVATION ROAD II
+				HSIN CHU    
+				TW
+
+00-60-42   (hex)		TKS (USA), INC.
+006042     (base 16)		TKS (USA), INC.
+				1201 COMMERCE
+				RICHARDSON  TX  75081
+				US
+
+00-60-79   (hex)		Mainstream Data, Inc.
+006079     (base 16)		Mainstream Data, Inc.
+				375 Chipeta Way, Suite B
+				Salt Lake City  UT  84108
+				US
+
+00-60-9A   (hex)		NJK TECHNO CO.
+00609A     (base 16)		NJK TECHNO CO.
+				N1-25 KAMIYASATO
+				KOMATSU  #923    
+				JP
+
+00-60-2B   (hex)		PEAK AUDIO
+00602B     (base 16)		PEAK AUDIO
+				1790 30TH STREET STE #414
+				BOULDER  CO  80301
+				US
+
+00-60-F1   (hex)		EXP COMPUTER, INC.
+0060F1     (base 16)		EXP COMPUTER, INC.
+				141 EILEEN WAY
+				SYOSSET  NY  11791
+				US
+
+00-60-E6   (hex)		SHOMITI SYSTEMS INCORPORATED
+0060E6     (base 16)		SHOMITI SYSTEMS INCORPORATED
+				2099 GATEWAY PLACE - STE.#220
+				SAN JOSE  CA  95110
+				US
+
+00-60-FF   (hex)		QuVis, Inc.
+0060FF     (base 16)		QuVis, Inc.
+				2921 SW WANAMAKER DRIVE
+				TOPEKA  KS  66614
+				US
+
+00-60-67   (hex)		ACER NETXUS INC.
+006067     (base 16)		ACER NETXUS INC.
+				5F-3, 5 HSIN ANN ROAD  SBIP
+				HSINCHU 300    
+				TJ
+
+00-60-9F   (hex)		PHAST CORPORATION
+00609F     (base 16)		PHAST CORPORATION
+				79 WEST 4500 SOUTH - BLDG.#14
+				SALT LAKE CITY  UT  84107
+				US
+
+00-60-40   (hex)		NETRO CORP.
+006040     (base 16)		NETRO CORP.
+				3120 SCOTT BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+00-60-CC   (hex)		EMTRAK, INCORPORATED
+0060CC     (base 16)		EMTRAK, INCORPORATED
+				7150 CAMPUS DRIVE, STE #180
+				COLORADO SPRINGS  CO  80920
+				US
+
+00-60-2C   (hex)		LINX Data Terminals, Inc.
+00602C     (base 16)		LINX Data Terminals, Inc.
+				625 DIGITAL DRIVE-STE #100
+				PLANO  TX  75075
+				US
+
+00-60-7E   (hex)		GIGALABS, INC.
+00607E     (base 16)		GIGALABS, INC.
+				290 SANTA ANA COURT
+				SUNNYVALE  CA  94086
+				US
+
+00-60-CD   (hex)		VideoServer, Inc.
+0060CD     (base 16)		VideoServer, Inc.
+				5 FORBES ROAD
+				LEXINGTON  MA  02173
+				US
+
+00-60-AA   (hex)		INTELLIGENT DEVICES INC. (IDI)
+0060AA     (base 16)		INTELLIGENT DEVICES INC. (IDI)
+				1718-L BELMONT AVENUE
+				BALTIMORE  MD  21244
+				US
+
+00-60-25   (hex)		ACTIVE IMAGING PLC
+006025     (base 16)		ACTIVE IMAGING PLC
+				HATTORI HOUSE
+				MAIDENHEAD  Berkshire SL6 4UB  
+				GB
+
+00-60-A7   (hex)		MICROSENS GmbH & CO. KG
+0060A7     (base 16)		MICROSENS GmbH & CO. KG
+				Kueferstrasse 16
+				D-59067 Hamm    
+				DE
+
+00-05-A8   (hex)		WYLE ELECTRONICS
+0005A8     (base 16)		WYLE ELECTRONICS
+				3000 BOWERS AVENUE
+				SANTA CLARA  CA  95051-0919
+				US
+
+00-60-E5   (hex)		FUJI AUTOMATION CO., LTD.
+0060E5     (base 16)		FUJI AUTOMATION CO., LTD.
+				3-23-10, NEGISHI
+				URAWA-SHI, 336 SAITAMA    
+				US
+
+00-60-5E   (hex)		LIBERTY TECHNOLOGY NETWORKING
+00605E     (base 16)		LIBERTY TECHNOLOGY NETWORKING
+				P.O. BOX 11566
+				HATFIELD, PRETORIA 0028    
+				ZA
+
+00-60-C6   (hex)		DCS AG
+0060C6     (base 16)		DCS AG
+				SALZACHSTRASS 31
+				D-14129  BERLIN    
+				DE
+
+00-60-1E   (hex)		SOFTLAB, INC.
+00601E     (base 16)		SOFTLAB, INC.
+				P.O. BOX 8
+				CHIMNEY ROCK  CO  81127
+				US
+
+00-60-65   (hex)		BERNECKER & RAINER INDUSTRIE-ELEKTRONIC GmbH
+006065     (base 16)		BERNECKER & RAINER INDUSTRIE-ELEKTRONIC GmbH
+				EGGELSBERG 120
+				5142 EGGELSBERG    
+				AT
+
+00-60-5D   (hex)		SCANIVALVE CORP.
+00605D     (base 16)		SCANIVALVE CORP.
+				1722 N. MADSON STREET
+				LIBERTY LAKE  WA  99019
+				US
+
+00-60-6F   (hex)		CLARION CORPORATION OF AMERICA
+00606F     (base 16)		CLARION CORPORATION OF AMERICA
+				25 Commerce Drive
+				Allendale  NJ  07401
+				US
+
+00-A0-10   (hex)		SYSLOGIC DATENTECHNIK AG
+00A010     (base 16)		SYSLOGIC DATENTECHNIK AG
+				Bruggerstrasse 69
+				CH-5400 Baden    
+				CH
+
+00-A0-59   (hex)		HAMILTON HALLMARK
+00A059     (base 16)		HAMILTON HALLMARK
+				2105 LUNDY AVENUE
+				SAN JOSE  CA  95131
+				US
+
+00-A0-39   (hex)		ROSS TECHNOLOGY, INC.
+00A039     (base 16)		ROSS TECHNOLOGY, INC.
+				5316 HWY 290 WEST - STE. #500
+				AUSTIN  TX  78735
+				US
+
+00-A0-AD   (hex)		MARCONI SPA
+00A0AD     (base 16)		MARCONI SPA
+				VIA NEGRONE, 1A
+				16153 GENOVA CORNIGLIANO    
+				IT
+
+00-A0-D6   (hex)		SBE, Inc.
+00A0D6     (base 16)		SBE, Inc.
+				4000 Executive Parkway
+				San Ramon  CA  94583
+				US
+
+00-A0-2E   (hex)		BRAND COMMUNICATIONS, LTD.
+00A02E     (base 16)		BRAND COMMUNICATIONS, LTD.
+				ENTERPRISE HOUSE, CHIVERS WAY,
+				HISTON, CAMBRIDGE CB4 4ZR    
+				GB
+
+00-60-4A   (hex)		SAIC IDEAS GROUP
+00604A     (base 16)		SAIC IDEAS GROUP
+				7120 COLUMBIA GATEWAY DRIVE
+				COLUMBIA  MD  21046
+				US
+
+00-A0-BD   (hex)		I-TECH CORP.
+00A0BD     (base 16)		I-TECH CORP.
+				10200 VALLEY VIEW ROAD
+				EDEN PRAIRIE  MN  55344
+				US
+
+00-60-90   (hex)		Artiza Networks Inc
+006090     (base 16)		Artiza Networks Inc
+				Faret Tachikawa Center Square, 2-36-2 Akebono-cho, 
+				Tachikawa-shi,  Tokyo   190-0012
+				JP
+
+00-60-0D   (hex)		Digital Logic GmbH
+00600D     (base 16)		Digital Logic GmbH
+				Stahlwerkstraße 25
+				Mudersbach    57555
+				DE
+
+00-60-30   (hex)		VILLAGE TRONIC ENTWICKLUNG
+006030     (base 16)		VILLAGE TRONIC ENTWICKLUNG
+				WELLWEG 95
+				31157 SARSTEDT    
+				DE
+
+00-A0-8D   (hex)		JACOMO CORPORATION
+00A08D     (base 16)		JACOMO CORPORATION
+				26900 E. PINK HILL ROAD
+				INDEPENDENCE  MO  64057
+				US
+
+00-A0-8E   (hex)		Check Point Software Technologies
+00A08E     (base 16)		Check Point Software Technologies
+				8333 Ridgepoint Dr.
+				Irving  TX  75063
+				US
+
+00-A0-FC   (hex)		IMAGE SCIENCES, INC.
+00A0FC     (base 16)		IMAGE SCIENCES, INC.
+				7500 INNOVATION WAY
+				MASON  OH  45040
+				US
+
+00-A0-9C   (hex)		Xyplex, Inc.
+00A09C     (base 16)		Xyplex, Inc.
+				25 FOSTER STREET
+				LITTLETON  MA  01460
+				US
+
+00-A0-0D   (hex)		THE PANDA PROJECT
+00A00D     (base 16)		THE PANDA PROJECT
+				5201 CONGRESS AVE. - C-100
+				BOCA RATON  FL  33487
+				US
+
+00-A0-E9   (hex)		ELECTRONIC RETAILING SYSTEMS INTERNATIONAL
+00A0E9     (base 16)		ELECTRONIC RETAILING SYSTEMS INTERNATIONAL
+				372 DANBURY ROAD
+				WILTON  CT  06897-2523
+				US
+
+00-A0-BE   (hex)		INTEGRATED CIRCUIT SYSTEMS, INC. COMMUNICATIONS GROUP
+00A0BE     (base 16)		INTEGRATED CIRCUIT SYSTEMS, INC. COMMUNICATIONS GROUP
+				1271 PARKMOOR AVENUE
+				SAN JOSE  CA  95126-3448
+				US
+
+00-A0-16   (hex)		MICROPOLIS CORP.
+00A016     (base 16)		MICROPOLIS CORP.
+				21211 NORDHOFF STREET
+				CHATSWORTH  CA  91311
+				US
+
+00-A0-48   (hex)		QUESTECH, LTD.
+00A048     (base 16)		QUESTECH, LTD.
+				EASTHEATH AVENUE
+				 BERKS, RG11 2PP    
+				GB
+
+00-A0-03   (hex)		Siemens Switzerland Ltd., I B T HVP
+00A003     (base 16)		Siemens Switzerland Ltd., I B T HVP
+				Building Technologies Division, International Headquarters
+				Zug    6301
+				CH
+
+00-A0-F9   (hex)		BINTEC COMMUNICATIONS GMBH
+00A0F9     (base 16)		BINTEC COMMUNICATIONS GMBH
+				SUEDWESTPARK 94
+				90449 NUERNBERG    
+				DE
+
+00-A0-F5   (hex)		RADGUARD LTD.
+00A0F5     (base 16)		RADGUARD LTD.
+				8 HANECHOSHET STREET
+				TEL-AVIV  69710    
+				IL
+
+00-A0-CA   (hex)		FUJITSU DENSO LTD.
+00A0CA     (base 16)		FUJITSU DENSO LTD.
+				3055 ORCHARD DRIVE
+				SAN JOSE  CA  95134
+				US
+
+00-A0-22   (hex)		CENTRE FOR DEVELOPMENT OF ADVANCED COMPUTING
+00A022     (base 16)		CENTRE FOR DEVELOPMENT OF ADVANCED COMPUTING
+				UNIVERSITY OF POONA CAMPUS
+				GANESH KHIND, Pune - 411 008    
+				IN
+
+00-A0-B6   (hex)		SANRITZ AUTOMATION CO., LTD.
+00A0B6     (base 16)		SANRITZ AUTOMATION CO., LTD.
+				4-21 MINAMI NARUSE
+				    
+				
+
+00-A0-79   (hex)		ALPS ELECTRIC (USA), INC.
+00A079     (base 16)		ALPS ELECTRIC (USA), INC.
+				3553 NORTH 1ST STREET
+				SAN JOSE  CA  95134
+				US
+
+00-A0-C0   (hex)		DIGITAL LINK CORP.
+00A0C0     (base 16)		DIGITAL LINK CORP.
+				217 HUMBOLDT COURT
+				SUNNYVALE  CA  94089
+				US
+
+00-A0-1E   (hex)		EST CORPORATION
+00A01E     (base 16)		EST CORPORATION
+				120 ROYALL STREET
+				CANTON  MA  02021
+				US
+
+00-A0-AE   (hex)		NUCOM SYSTEMS, INC.
+00A0AE     (base 16)		NUCOM SYSTEMS, INC.
+				9F-6, NO 4, LANE
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-A0-62   (hex)		AES PRODATA
+00A062     (base 16)		AES PRODATA
+				249 BALCATTA ROAD
+				WESTERN  AUSTRALIA  6021
+				AU
+
+00-A0-76   (hex)		CARDWARE LAB, INC.
+00A076     (base 16)		CARDWARE LAB, INC.
+				285 SOBRANTE WAY, STE.
+				SUNNYVALE  CA  94086
+				VI
+
+00-A0-A1   (hex)		EPIC DATA INC.
+00A0A1     (base 16)		EPIC DATA INC.
+				7280 RIVER ROAD
+				CANADA  V6X  1X5
+				
+
+00-A0-44   (hex)		NTT IT CO., LTD.
+00A044     (base 16)		NTT IT CO., LTD.
+				
+				  231  
+				JP
+
+00-A0-11   (hex)		MUTOH INDUSTRIES LTD.
+00A011     (base 16)		MUTOH INDUSTRIES LTD.
+				253 KANAGAWA-KEN,
+				    
+				JP
+
+00-A0-BA   (hex)		PATTON ELECTRONICS CO.
+00A0BA     (base 16)		PATTON ELECTRONICS CO.
+				7622 RICKENBACKER DRIVE
+				GAITHERSBURG  MD  20879
+				US
+
+00-A0-B5   (hex)		3H TECHNOLOGY
+00A0B5     (base 16)		3H TECHNOLOGY
+				3375 SCOTT BLVD. #336
+				SANTA CLARA  CA  95054
+				US
+
+00-A0-4D   (hex)		EDA INSTRUMENTS, INC.
+00A04D     (base 16)		EDA INSTRUMENTS, INC.
+				4 THORNCLIFFE PARK DRIVE
+				    M4H 1H1
+				CA
+
+00-A0-86   (hex)		AMBER WAVE SYSTEMS, INC.
+00A086     (base 16)		AMBER WAVE SYSTEMS, INC.
+				403 MASSACHUSETTS AVENUE
+				ACTON  MA  01720
+				US
+
+00-A0-AF   (hex)		WMS INDUSTRIES
+00A0AF     (base 16)		WMS INDUSTRIES
+				3401 N. CALIFORNIA
+				CHICAGO  IL  60618
+				US
+
+00-A0-57   (hex)		LANCOM Systems GmbH
+00A057     (base 16)		LANCOM Systems GmbH
+				Adenauer Straße 20 /B2
+				Würselen    52146
+				DE
+
+00-A0-30   (hex)		CAPTOR NV/SA
+00A030     (base 16)		CAPTOR NV/SA
+				DE HENE 13
+				    
+				BE
+
+00-A0-DE   (hex)		YAMAHA CORPORATION
+00A0DE     (base 16)		YAMAHA CORPORATION
+				10-1 Nakazawa-cho, Naka-ku
+				Hamamatsu  Shizuoka  430-8650
+				JP
+
+00-A0-84   (hex)		Dataplex Pty Ltd
+00A084     (base 16)		Dataplex Pty Ltd
+				Ground floor,
+				MACQUARIE PARK  NSW  2113
+				AU
+
+00-A0-49   (hex)		DIGITECH INDUSTRIES, INC.
+00A049     (base 16)		DIGITECH INDUSTRIES, INC.
+				PO BOX 2267
+				DANBURY  CT  06810
+				US
+
+00-A0-9D   (hex)		JOHNATHON FREEMAN TECHNOLOGIES
+00A09D     (base 16)		JOHNATHON FREEMAN TECHNOLOGIES
+				P.O. BOX 880114
+				SAN FRANCISCO  CA  94188
+				US
+
+00-A0-6B   (hex)		DMS DORSCH MIKROSYSTEM GMBH
+00A06B     (base 16)		DMS DORSCH MIKROSYSTEM GMBH
+				HOLMLUECK 13-15
+				    
+				DE
+
+00-A0-F8   (hex)		Zebra Technologies Inc
+00A0F8     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+00-A0-9F   (hex)		COMMVISION CORP.
+00A09F     (base 16)		COMMVISION CORP.
+				510 LOGUE AVE.
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-A0-6E   (hex)		AUSTRON, INC.
+00A06E     (base 16)		AUSTRON, INC.
+				P.O. BOX 14766
+				AUSTIN  TX  78761-4766
+				US
+
+00-20-22   (hex)		NMS Communications
+002022     (base 16)		NMS Communications
+				100 Crossing Boulevard
+				Framingham  MA  01702
+				US
+
+00-20-AE   (hex)		ORNET DATA COMMUNICATION TECH.
+0020AE     (base 16)		ORNET DATA COMMUNICATION TECH.
+				P.O. BOX 323
+				    
+				IL
+
+00-20-AA   (hex)		Ericsson Television Limited
+0020AA     (base 16)		Ericsson Television Limited
+				Solution Area Media
+				Comines Way, Hedge End  Southhampton  SO 30 4DA
+				GB
+
+00-20-A4   (hex)		MULTIPOINT NETWORKS
+0020A4     (base 16)		MULTIPOINT NETWORKS
+				19 DAVIS DRIVE
+				BELMONT  CA  94002-3001
+				US
+
+00-02-67   (hex)		NODE RUNNER, INC.
+000267     (base 16)		NODE RUNNER, INC.
+				2202 N. FORBES BLVD.
+				TUCSON  AZ  85745
+				US
+
+00-20-B1   (hex)		COMTECH RESEARCH INC.
+0020B1     (base 16)		COMTECH RESEARCH INC.
+				24271 TAHOE
+				LAGUNA NIGUEL  CA  92656
+				US
+
+00-20-32   (hex)		ALCATEL TAISEL
+002032     (base 16)		ALCATEL TAISEL
+				4, MING SHENG STREET TU-CHENG
+				  TAIWAN  ROC
+				TW
+
+00-20-E9   (hex)		DANTEL
+0020E9     (base 16)		DANTEL
+				P.O. BOX 55013
+				FRESNO  CA  93727-1388
+				US
+
+00-20-38   (hex)		VME MICROSYSTEMS INTERNATIONAL CORPORATION
+002038     (base 16)		VME MICROSYSTEMS INTERNATIONAL CORPORATION
+				12090 S. MEMORIAL PARKWAY
+				HUNTSVILLE  AL  35803
+				US
+
+00-20-A3   (hex)		Harmonic, Inc
+0020A3     (base 16)		Harmonic, Inc
+				4300 North First Street
+				San Jose  CA  95134
+				US
+
+00-20-59   (hex)		MIRO COMPUTER PRODUCTS AG
+002059     (base 16)		MIRO COMPUTER PRODUCTS AG
+				CARL MIELE STR. 4
+				D-38112 BRAUNSCHWEIG    
+				DE
+
+00-20-34   (hex)		ROTEC INDUSTRIEAUTOMATION GMBH
+002034     (base 16)		ROTEC INDUSTRIEAUTOMATION GMBH
+				GUTENBERGSTR. 15
+				    
+				DE
+
+00-20-79   (hex)		MIKRON GMBH
+002079     (base 16)		MIKRON GMBH
+				BRESLAUERSTR. 1-3
+				85386 ECHING    
+				DE
+
+00-20-05   (hex)		SIMPLE TECHNOLOGY
+002005     (base 16)		SIMPLE TECHNOLOGY
+				3001 DAIMLER ROAD
+				SANTA ANA  CA  92705
+				US
+
+00-20-18   (hex)		CIS TECHNOLOGY INC.
+002018     (base 16)		CIS TECHNOLOGY INC.
+				FL. 9-1, NO. 94, PAO CHUNG RD.
+				TAIPEI HSIEN    
+				TW
+
+00-20-98   (hex)		HECTRONIC AB
+002098     (base 16)		HECTRONIC AB
+				BOX 3002
+				S-75003 UPPSALA    
+				SE
+
+00-20-FD   (hex)		ITV TECHNOLOGIES, INC.
+0020FD     (base 16)		ITV TECHNOLOGIES, INC.
+				6800 OWENSMOUTH AVE.  #230
+				CANOGA PARK  CA  91303
+				US
+
+00-20-FA   (hex)		GDE SYSTEMS, INC.
+0020FA     (base 16)		GDE SYSTEMS, INC.
+				P.O. BOX 85468 - BLDG.#61
+				SAN DIEGO  CA  92186-5468
+				US
+
+00-20-C1   (hex)		SAXA, Inc.
+0020C1     (base 16)		SAXA, Inc.
+				NBF Platinum Tower 1-17-3 Shirokane
+				Tokyo    108-8050
+				JP
+
+00-20-80   (hex)		SYNERGY (UK) LTD.
+002080     (base 16)		SYNERGY (UK) LTD.
+				HARTCRAN HOUSE
+				WATFORD HERTS.  WD1 5EZ    
+				GB
+
+00-C0-23   (hex)		TUTANKHAMON ELECTRONICS
+00C023     (base 16)		TUTANKHAMON ELECTRONICS
+				2446 ESTAND WAY
+				PLEASANT HILL  CA  94523
+				US
+
+00-C0-8B   (hex)		RISQ MODULAR SYSTEMS, INC.
+00C08B     (base 16)		RISQ MODULAR SYSTEMS, INC.
+				39899 BALENTINE DRIVE-STE #375
+				NEWARK  CA  94560
+				US
+
+00-20-C4   (hex)		INET,INC.
+0020C4     (base 16)		INET,INC.
+				801 E. CAMPBELL-STE.#330
+				RICHARDSON  TX  75081
+				US
+
+00-20-74   (hex)		SUNGWOON SYSTEMS
+002074     (base 16)		SUNGWOON SYSTEMS
+				YUSUN BLDG.44-4
+				    KOREA
+				KR
+
+00-20-3C   (hex)		EUROTIME AB
+00203C     (base 16)		EUROTIME AB
+				BOX 277
+				    
+				SE
+
+00-20-28   (hex)		WEST EGG SYSTEMS, INC.
+002028     (base 16)		WEST EGG SYSTEMS, INC.
+				65 HIGH RIDGE ROAD-STE.#286
+				STAMFORD  CT  06905
+				US
+
+00-20-68   (hex)		ISDYNE
+002068     (base 16)		ISDYNE
+				11 ROXBURY AVENUE
+				NATICK  MA  01760
+				US
+
+00-20-C8   (hex)		LARSCOM INCORPORATED
+0020C8     (base 16)		LARSCOM INCORPORATED
+				4600 PATRICK HENRY DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-20-9D   (hex)		LIPPERT AUTOMATIONSTECHNIK
+00209D     (base 16)		LIPPERT AUTOMATIONSTECHNIK
+				D-68165 MANNHEIM
+				    
+				DE
+
+00-20-9C   (hex)		PRIMARY ACCESS CORP.
+00209C     (base 16)		PRIMARY ACCESS CORP.
+				10080 CARROLL CANYON RD
+				SAN DIEGO  CA  92131
+				US
+
+00-20-6D   (hex)		DATA RACE, INC.
+00206D     (base 16)		DATA RACE, INC.
+				11550 IH-10WEST  STE#395
+				SAN ANTONIO  TX  78230
+				US
+
+00-20-3A   (hex)		DIGITAL BI0METRICS INC.
+00203A     (base 16)		DIGITAL BI0METRICS INC.
+				5600 ROWLAND ROAD- STE.#205
+				MINNETONKA  MN  55364
+				US
+
+00-20-48   (hex)		Marconi Communications
+002048     (base 16)		Marconi Communications
+				1000 Fore Drive
+				Warrendale  PA  15086-7502
+				US
+
+00-20-DC   (hex)		DENSITRON TAIWAN LTD.
+0020DC     (base 16)		DENSITRON TAIWAN LTD.
+				KYOWA NANABANKAN 5F
+				    
+				JP
+
+00-20-0C   (hex)		ADASTRA SYSTEMS CORP.
+00200C     (base 16)		ADASTRA SYSTEMS CORP.
+				28310 INDUSTRIAL BLVD.-STE-K
+				HAYWARD  CA  94545
+				US
+
+00-20-11   (hex)		CANOPUS CO., LTD.
+002011     (base 16)		CANOPUS CO., LTD.
+				KOBE HI-TECH PARK
+				  651-22  
+				JP
+
+00-20-51   (hex)		Verilink Corporation
+002051     (base 16)		Verilink Corporation
+				127 Jetplex Circle
+				Madison  AL  35758
+				US
+
+00-20-3B   (hex)		WISDM LTD.
+00203B     (base 16)		WISDM LTD.
+				ST. JOHNS INNOVATION CENTRE
+				    ENGLAND
+				GB
+
+00-20-BA   (hex)		CENTER FOR HIGH PERFORMANCE
+0020BA     (base 16)		CENTER FOR HIGH PERFORMANCE
+				COMPUTING OF WPI
+				MARLBORO  MA  01752
+				US
+
+00-20-F5   (hex)		PANDATEL AG
+0020F5     (base 16)		PANDATEL AG
+				FASANENWEG 25
+				    
+				DE
+
+00-20-0E   (hex)		NSSLGlobal Technologies AS
+00200E     (base 16)		NSSLGlobal Technologies AS
+				Martin Linges vei 25
+				Fornebu    1364 
+				NO
+
+00-20-E7   (hex)		B&W NUCLEAR SERVICE COMPANY
+0020E7     (base 16)		B&W NUCLEAR SERVICE COMPANY
+				SPECIAL PRODUCTS & INTEG.SVCS.
+				LYNCHBURG  VA  24502
+				US
+
+00-20-F0   (hex)		UNIVERSAL MICROELECTRONICS CO.
+0020F0     (base 16)		UNIVERSAL MICROELECTRONICS CO.
+				3, 27TH RD., TAICHUNG IND.PARK
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-20-89   (hex)		T3PLUS NETWORKING, INC.
+002089     (base 16)		T3PLUS NETWORKING, INC.
+				2840 SAN TOMAS EXPRESSWAY
+				SANTA CLARA  CA  95051
+				US
+
+00-20-61   (hex)		GarrettCom, Inc.
+002061     (base 16)		GarrettCom, Inc.
+				47823 Westinghouse Dr.
+				Fremont  CA  94539
+				US
+
+00-C0-80   (hex)		NETSTAR, INC.
+00C080     (base 16)		NETSTAR, INC.
+				CEDAR BUSINESS CENTER
+				MINNEAPOLIS  MN  55425-1235
+				US
+
+00-C0-B4   (hex)		MYSON TECHNOLOGY, INC.
+00C0B4     (base 16)		MYSON TECHNOLOGY, INC.
+				2F, NO. 3, INDUSTRY E. RD.IV
+				    TAIWAN
+				TW
+
+00-C0-45   (hex)		ISOLATION SYSTEMS, LTD.
+00C045     (base 16)		ISOLATION SYSTEMS, LTD.
+				26 SIX POINT ROAD
+				CANADA  M8Z  2W9
+				CA
+
+00-70-B3   (hex)		DATA RECALL LTD.
+0070B3     (base 16)		DATA RECALL LTD.
+				SONDES PLACE
+				  UNITED  KINGDOM
+				GB
+
+00-70-B0   (hex)		M/A-COM INC. COMPANIES
+0070B0     (base 16)		M/A-COM INC. COMPANIES
+				11717 EXPLORATION LANE
+				GERMANTOWN  MD  20767
+				US
+
+00-E6-D3   (hex)		NIXDORF COMPUTER CORP.
+00E6D3     (base 16)		NIXDORF COMPUTER CORP.
+				2520 MISSION COLLEGE ROAD
+				SANTA CLARA  CA  95054
+				US
+
+00-C0-C3   (hex)		ACUSON COMPUTED SONOGRAPHY
+00C0C3     (base 16)		ACUSON COMPUTED SONOGRAPHY
+				1220 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94039-7393
+				US
+
+00-C0-B3   (hex)		COMSTAT DATACOMM CORPORATION
+00C0B3     (base 16)		COMSTAT DATACOMM CORPORATION
+				1720 SPECTRUM DRIVE
+				LAWRENCEVILLE  GA  30243
+				US
+
+00-C0-E5   (hex)		GESPAC, S.A.
+00C0E5     (base 16)		GESPAC, S.A.
+				CHEMIN DES AULX 18
+				    
+				CH
+
+00-C0-4D   (hex)		MITEC, INC.
+00C04D     (base 16)		MITEC, INC.
+				BR-KAMEIDO 1 BUILDING
+				    
+				JP
+
+00-C0-47   (hex)		UNIMICRO SYSTEMS, INC.
+00C047     (base 16)		UNIMICRO SYSTEMS, INC.
+				44382 S. GRIMMER BLVD.
+				FREMONT  CA  94538
+				US
+
+00-C0-84   (hex)		DATA LINK CORP. LTD.
+00C084     (base 16)		DATA LINK CORP. LTD.
+				3-15-3 MIDORICHO
+				    
+				JP
+
+00-C0-41   (hex)		DIGITAL TRANSMISSION SYSTEMS
+00C041     (base 16)		DIGITAL TRANSMISSION SYSTEMS
+				4830 RIVER GREEN PARKWAY
+				DULUTH  GA  30136
+				US
+
+00-C0-1F   (hex)		S.E.R.C.E.L.
+00C01F     (base 16)		S.E.R.C.E.L.
+				B.P. 439
+				    
+				FR
+
+00-60-86   (hex)		LOGIC REPLACEMENT TECH. LTD.
+006086     (base 16)		LOGIC REPLACEMENT TECH. LTD.
+				14 ARKWRIGHT ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-C0-59   (hex)		DENSO CORPORATION
+00C059     (base 16)		DENSO CORPORATION
+				1-1, Showa-cho,
+				Kariya-shi,  Aichi  448-8661
+				JP
+
+00-C0-F1   (hex)		SHINKO ELECTRIC CO., LTD.
+00C0F1     (base 16)		SHINKO ELECTRIC CO., LTD.
+				COMPUTER SYSTEM DIVISION
+				  JAPAN  441-31
+				JP
+
+00-C0-A1   (hex)		TOKYO DENSHI SEKEI CO.
+00C0A1     (base 16)		TOKYO DENSHI SEKEI CO.
+				255-1 RENKOJI, TAMA-SHI
+				  JAPAN  206
+				JP
+
+00-C0-2E   (hex)		NETWIZ
+00C02E     (base 16)		NETWIZ
+				26 GOLOMB STREET
+				    
+				IL
+
+00-C0-0D   (hex)		ADVANCED LOGIC RESEARCH, INC.
+00C00D     (base 16)		ADVANCED LOGIC RESEARCH, INC.
+				9401 JERONIMO
+				IRVINE  CA  92618
+				US
+
+00-C0-81   (hex)		METRODATA LTD.
+00C081     (base 16)		METRODATA LTD.
+				BLENHEIM HOUSE
+				TW20 8RY  TW20 8RY  ENGLAND
+				GB
+
+00-C0-3B   (hex)		MULTIACCESS COMPUTING CORP.
+00C03B     (base 16)		MULTIACCESS COMPUTING CORP.
+				5350 HOLLISTER AVE., STE.
+				SANTA BARBARA  CA  93111
+				US
+
+00-C0-82   (hex)		MOORE PRODUCTS CO.
+00C082     (base 16)		MOORE PRODUCTS CO.
+				SUMNEYTOWN PIKE
+				SPRING HOUSE  PA  19477
+				US
+
+00-C0-99   (hex)		YOSHIKI INDUSTRIAL CO.,LTD.
+00C099     (base 16)		YOSHIKI INDUSTRIAL CO.,LTD.
+				1-38 MATSUGASAKI 2-CHOME
+				  992  
+				JP
+
+00-C0-01   (hex)		DIATEK PATIENT MANAGMENT
+00C001     (base 16)		DIATEK PATIENT MANAGMENT
+				SYSTEMS, INC.
+				SAN DIEGO  CA  92121-1723
+				US
+
+00-C0-F4   (hex)		INTERLINK SYSTEM CO., LTD.
+00C0F4     (base 16)		INTERLINK SYSTEM CO., LTD.
+				INTERLINK B/D, 476-20
+				    KOREA
+				KR
+
+00-C0-E2   (hex)		CALCOMP, INC.
+00C0E2     (base 16)		CALCOMP, INC.
+				2411 W. LAPALMA AVENUE
+				ANAHEIM  CA  92803-3250
+				US
+
+00-C0-7B   (hex)		ASCEND COMMUNICATIONS, INC.
+00C07B     (base 16)		ASCEND COMMUNICATIONS, INC.
+				1701 HARBOR BAY PARKWAY
+				ALAMEDA  CA  94502
+				US
+
+00-C0-3C   (hex)		TOWER TECH S.R.L.
+00C03C     (base 16)		TOWER TECH S.R.L.
+				VIA RIDOLFI 6,8
+				    
+				IT
+
+00-C0-1D   (hex)		GRAND JUNCTION NETWORKS, INC.
+00C01D     (base 16)		GRAND JUNCTION NETWORKS, INC.
+				3101 WHIPPLE RD., #27
+				UNION CITY  CA  94587
+				US
+
+00-C0-35   (hex)		QUINTAR COMPANY
+00C035     (base 16)		QUINTAR COMPANY
+				370 AMAPOLA AVE., STE.#106
+				TORRANCE  CA  90501
+				US
+
+00-C0-70   (hex)		SECTRA SECURE-TRANSMISSION AB
+00C070     (base 16)		SECTRA SECURE-TRANSMISSION AB
+				TEKNIKRINGEN 2
+				    
+				SE
+
+00-C0-6D   (hex)		BOCA RESEARCH, INC.
+00C06D     (base 16)		BOCA RESEARCH, INC.
+				6401 CONGRESS AVENUE
+				BOCA RATON  FL  33487
+				US
+
+00-C0-EA   (hex)		ARRAY TECHNOLOGY LTD.
+00C0EA     (base 16)		ARRAY TECHNOLOGY LTD.
+				145 FRIMLEY ROAD
+				ENGLAND  GU15  2PS
+				GB
+
+00-C0-09   (hex)		KT TECHNOLOGY (S) PTE LTD
+00C009     (base 16)		KT TECHNOLOGY (S) PTE LTD
+				KT BUILDING
+				  SINGAPORE  0511
+				SG
+
+00-C0-D6   (hex)		J1 SYSTEMS, INC.
+00C0D6     (base 16)		J1 SYSTEMS, INC.
+				3 DUNWOODY PARK-STE.#103
+				ATLANTA  GA  30338
+				US
+
+00-C0-DC   (hex)		EOS TECHNOLOGIES, INC.
+00C0DC     (base 16)		EOS TECHNOLOGIES, INC.
+				3945 FREEDOM CIRCLE, STE.#770
+				SANTA CLARA  CA  95054
+				US
+
+00-C0-72   (hex)		KNX LTD.
+00C072     (base 16)		KNX LTD.
+				HOLLINGWOOD HOUSE
+				LS21 3HA  UNITED  KINGDOM
+				GB
+
+00-C0-AE   (hex)		TOWERCOM CO. INC. DBA PC HOUSE
+00C0AE     (base 16)		TOWERCOM CO. INC. DBA PC HOUSE
+				841 E. ARTESIA BLVD.
+				CARSON  CA  90746
+				US
+
+00-C0-C2   (hex)		INFINITE NETWORKS LTD.
+00C0C2     (base 16)		INFINITE NETWORKS LTD.
+				19 BROOKSIDE ROAD, OXHEY
+				  UNITED  KINGDOM
+				GB
+
+00-C0-AF   (hex)		TEKLOGIX INC.
+00C0AF     (base 16)		TEKLOGIX INC.
+				2100 MEADOWVALE BOULEVARD
+				CANADA  L5N  7J9
+				CA
+
+00-C0-7A   (hex)		PRIVA B.V.
+00C07A     (base 16)		PRIVA B.V.
+				P.O. BOX 18
+				    
+				NL
+
+00-C0-F6   (hex)		CELAN TECHNOLOGY INC.
+00C0F6     (base 16)		CELAN TECHNOLOGY INC.
+				NO. 101, MIN-HSIANG ST.
+				TAIWAN  TAIWAN  R.O.C.
+				CN
+
+00-C0-F8   (hex)		ABOUT COMPUTING INC.
+00C0F8     (base 16)		ABOUT COMPUTING INC.
+				P.O. BOX 172
+				BELMONT  MA  02178
+				US
+
+00-C0-78   (hex)		COMPUTER SYSTEMS ENGINEERING
+00C078     (base 16)		COMPUTER SYSTEMS ENGINEERING
+				46791 FREMONT BLVD.
+				FREMONT  CA  94538
+				US
+
+00-C0-9A   (hex)		PHOTONICS CORPORATION
+00C09A     (base 16)		PHOTONICS CORPORATION
+				2940 NORTH FIRST STREET
+				SAN JOSE  CA  95123-2021
+				US
+
+00-C0-1A   (hex)		COROMETRICS MEDICAL SYSTEMS
+00C01A     (base 16)		COROMETRICS MEDICAL SYSTEMS
+				61 BARNES PARK ROAD NORTH
+				WALLINGFORD  CT  06492-0333
+				US
+
+00-C0-68   (hex)		HME Clear-Com LTD.
+00C068     (base 16)		HME Clear-Com LTD.
+				7400 Beach Drive
+				Cambridgeshire    CB25 9TP
+				GB
+
+00-C0-D8   (hex)		UNIVERSAL DATA SYSTEMS
+00C0D8     (base 16)		UNIVERSAL DATA SYSTEMS
+				5000 BRADFORD DRIVE
+				HUNTSVILLE  AL  35805-1993
+				US
+
+00-40-36   (hex)		Zoom Telephonics, Inc
+004036     (base 16)		Zoom Telephonics, Inc
+				207 South St
+				Boston  MA  02111
+				US
+
+00-40-16   (hex)		ADC - Global Connectivity Solutions Division
+004016     (base 16)		ADC - Global Connectivity Solutions Division
+				P.O. Box 1101
+				Minneapolis  MN  55440-1101
+				US
+
+00-40-6A   (hex)		KENTEK INFORMATION SYSTEMS,INC
+00406A     (base 16)		KENTEK INFORMATION SYSTEMS,INC
+				2945 WILDERNESS PLACE
+				BOULDER  CO  80301
+				US
+
+00-40-0A   (hex)		PIVOTAL TECHNOLOGIES, INC.
+00400A     (base 16)		PIVOTAL TECHNOLOGIES, INC.
+				100 W. RINCON AVENUE-STE #211
+				CAMPBELL  CA  95008
+				US
+
+00-40-99   (hex)		NEWGEN SYSTEMS CORP.
+004099     (base 16)		NEWGEN SYSTEMS CORP.
+				17580 NEWHOPE STREET
+				FOUNTAIN VALLEY  CA  92708
+				US
+
+00-40-11   (hex)		ANDOVER CONTROLS CORPORATION
+004011     (base 16)		ANDOVER CONTROLS CORPORATION
+				300 BRICKSTONE SQUARE
+				ANDOVER  MA  01810
+				US
+
+00-40-A1   (hex)		ERGO COMPUTING
+0040A1     (base 16)		ERGO COMPUTING
+				ONE INTERCONTINENTAL WAY
+				PEABODY  MA  01960
+				US
+
+00-40-81   (hex)		MANNESMANN SCANGRAPHIC GMBH
+004081     (base 16)		MANNESMANN SCANGRAPHIC GMBH
+				RISSENER STRASSE 112-114
+				    
+				DE
+
+00-C0-8C   (hex)		PERFORMANCE TECHNOLOGIES, INC.
+00C08C     (base 16)		PERFORMANCE TECHNOLOGIES, INC.
+				315 SCIENCE PARKWAY
+				ROCHESTER  NY  14620
+				US
+
+00-C0-07   (hex)		PINNACLE DATA SYSTEMS, INC.
+00C007     (base 16)		PINNACLE DATA SYSTEMS, INC.
+				1350 WEST FIFTH AVENUE
+				COLUMBUS  OH  43212
+				US
+
+00-C0-98   (hex)		CHUNTEX ELECTRONIC CO., LTD.
+00C098     (base 16)		CHUNTEX ELECTRONIC CO., LTD.
+				6F., NO.2, ALLEY 6, LANE 235
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-C0-BE   (hex)		ALCATEL - SEL
+00C0BE     (base 16)		ALCATEL - SEL
+				LORENZ STR
+				    
+				DE
+
+00-C0-6E   (hex)		HAFT TECHNOLOGY, INC.
+00C06E     (base 16)		HAFT TECHNOLOGY, INC.
+				DAINI-DOHO BLDG.
+				  305  
+				JP
+
+00-C0-8A   (hex)		Lauterbach GmbH
+00C08A     (base 16)		Lauterbach GmbH
+				Altlaufstraße 40
+				  Höhenkirchen-Siegertsbrunn  85635
+				DE
+
+00-C0-F7   (hex)		ENGAGE COMMUNICATION, INC.
+00C0F7     (base 16)		ENGAGE COMMUNICATION, INC.
+				9053 SOQUEL DRIVE
+				APTOS  CA  95003-4034
+				US
+
+00-40-B7   (hex)		STEALTH COMPUTER SYSTEMS
+0040B7     (base 16)		STEALTH COMPUTER SYSTEMS
+				2341 REGINA CT.
+				SANTA CLARA  CA  95054
+				US
+
+00-40-AC   (hex)		SUPER WORKSTATION, INC.
+0040AC     (base 16)		SUPER WORKSTATION, INC.
+				2190 PARAGON DRIVE
+				SAN JOSE  CA  95131
+				US
+
+10-00-5A   (hex)		IBM Corp
+10005A     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-40-D1   (hex)		FUKUDA DENSHI CO., LTD.
+0040D1     (base 16)		FUKUDA DENSHI CO., LTD.
+				R & D DEPARTMENT NO. 1
+				    
+				JP
+
+00-40-69   (hex)		LEMCOM SYSTEMS, INC.
+004069     (base 16)		LEMCOM SYSTEMS, INC.
+				2104 WEST PEORIA AVENUE
+				PHOENIX  AZ  85029
+				US
+
+00-40-3B   (hex)		SYNERJET INTERNATIONAL CORP.
+00403B     (base 16)		SYNERJET INTERNATIONAL CORP.
+				5F, NO 35, KUANG FU S. ROAD
+				TAIWAN  R.  O. C.
+				TW
+
+00-80-3B   (hex)		APT COMMUNICATIONS, INC.
+00803B     (base 16)		APT COMMUNICATIONS, INC.
+				9607 DR. PERRY ROAD
+				IJAMSVILLE  MD  21754
+				US
+
+00-80-6A   (hex)		ERI (EMPAC RESEARCH INC.)
+00806A     (base 16)		ERI (EMPAC RESEARCH INC.)
+				47560 SEABRIDGE DRIVE
+				FREMONT  CA  94538
+				US
+
+00-C0-A8   (hex)		GVC CORPORATION
+00C0A8     (base 16)		GVC CORPORATION
+				1961 CONCOURSE DRIVE-STE
+				SAN JOSE  CA  95131
+				US
+
+00-40-E0   (hex)		ATOMWIDE LTD.
+0040E0     (base 16)		ATOMWIDE LTD.
+				23 THE GREENWAY
+				  UNITED  KINGDOM
+				GB
+
+00-40-A8   (hex)		IMF INTERNATIONAL LTD.
+0040A8     (base 16)		IMF INTERNATIONAL LTD.
+				NO.5 2/F KINGSFORD IND. CENTRE
+				  HONG  KONG
+				HK
+
+00-40-70   (hex)		INTERWARE CO., LTD.
+004070     (base 16)		INTERWARE CO., LTD.
+				7F KUDAN NEW CENTRAL BLDG.,
+				TOKYO 102  TOKYO 102  
+				JP
+
+00-40-8A   (hex)		TPS TELEPROCESSING SYS. GMBH
+00408A     (base 16)		TPS TELEPROCESSING SYS. GMBH
+				SCHWADERMUCHLSTRASSE 4-8
+				    
+				DE
+
+00-40-FD   (hex)		LXE
+0040FD     (base 16)		LXE
+				303 RESEARCH DRIVE
+				NORCROSS  GA  30092
+				US
+
+00-40-3F   (hex)		SSANGYONG COMPUTER SYSTEMS
+00403F     (base 16)		SSANGYONG COMPUTER SYSTEMS
+				CORPORATION
+				  KOREA  100-705
+				KR
+
+00-40-82   (hex)		LABORATORY EQUIPMENT CORP.
+004082     (base 16)		LABORATORY EQUIPMENT CORP.
+				1-7-3 MINATOMACHI
+				  300  
+				JP
+
+00-40-F1   (hex)		CHUO ELECTRONICS CO., LTD.
+0040F1     (base 16)		CHUO ELECTRONICS CO., LTD.
+				1-9-9, MOTOHONGO-CHO
+				    
+				JP
+
+00-40-A9   (hex)		DATACOM INC.
+0040A9     (base 16)		DATACOM INC.
+				146 HIGHWAY ROUTE 34 - STE 250
+				HOLMDEL  NJ  07733
+				US
+
+00-40-E3   (hex)		QUIN SYSTEMS LTD
+0040E3     (base 16)		QUIN SYSTEMS LTD
+				OAKLANDS BUSINESS CENTRE
+				  UNITED  KINGDOM
+				GB
+
+00-40-91   (hex)		PROCOMP INDUSTRIA ELETRONICA
+004091     (base 16)		PROCOMP INDUSTRIA ELETRONICA
+				AV. KENKITI SIMOMOTO, 767
+				    
+				BR
+
+00-40-EA   (hex)		PLAIN TREE SYSTEMS INC
+0040EA     (base 16)		PLAIN TREE SYSTEMS INC
+				CHIEF EXECTUVIE OFFICER
+				    
+				CA
+
+00-40-A7   (hex)		ITAUTEC PHILCO S.A.
+0040A7     (base 16)		ITAUTEC PHILCO S.A.
+				GRUPO ITAUTEC PHILCO
+				    
+				BR
+
+00-40-64   (hex)		KLA INSTRUMENTS CORPORATION
+004064     (base 16)		KLA INSTRUMENTS CORPORATION
+				160 RIO ROBLES
+				SAN JOSE  CA  95161-9055
+				US
+
+00-40-43   (hex)		Nokia Siemens Networks GmbH & Co. KG.
+004043     (base 16)		Nokia Siemens Networks GmbH & Co. KG.
+				Werner-von-Siemens Straße 2-6
+				Bruchsal  Baden-Württemberg  76646
+				DE
+
+00-40-5A   (hex)		GOLDSTAR INFORMATION & COMM.
+00405A     (base 16)		GOLDSTAR INFORMATION & COMM.
+				533, HOGAE-DONG, ANYANG-SHI
+				    KOREA
+				KR
+
+00-40-13   (hex)		NTT DATA COMM. SYSTEMS CORP.
+004013     (base 16)		NTT DATA COMM. SYSTEMS CORP.
+				DEVELOPMENT HEADQUARTERS
+				TOKYO 135  TOKYO 135  
+				JP
+
+00-40-0C   (hex)		GENERAL MICRO SYSTEMS, INC.
+00400C     (base 16)		GENERAL MICRO SYSTEMS, INC.
+				P.O. BOX 3689
+				RANCHO CUCAMONGA  CA  91729
+				US
+
+00-40-5E   (hex)		NORTH HILLS ISRAEL
+00405E     (base 16)		NORTH HILLS ISRAEL
+				P.O. BOX 1280
+				    
+				IL
+
+00-40-FA   (hex)		MICROBOARDS, INC.
+0040FA     (base 16)		MICROBOARDS, INC.
+				31-8, TAKASECHO,FUNABASHI-CITY
+				CHIBA 273  CHIBA 273  
+				JP
+
+00-40-14   (hex)		COMSOFT GMBH
+004014     (base 16)		COMSOFT GMBH
+				WACHHAUSSTR. 5A
+				    
+				DE
+
+00-40-00   (hex)		PCI COMPONENTES DA AMZONIA LTD
+004000     (base 16)		PCI COMPONENTES DA AMZONIA LTD
+				RUA JOSEF KRYSS
+				  01140  BRASIL
+				BR
+
+00-40-6C   (hex)		COPERNIQUE
+00406C     (base 16)		COPERNIQUE
+				6, MAIL DE L'EUROPE BP 25
+				    
+				FR
+
+00-40-75   (hex)		Tattile SRL 
+004075     (base 16)		Tattile SRL 
+				11-12 NORTHFIELD PROSPECT
+				  UNITED  KINGDOM
+				GB
+
+00-40-53   (hex)		AMPRO COMPUTERS
+004053     (base 16)		AMPRO COMPUTERS
+				990 ALMONDOR AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-80-38   (hex)		DATA RESEARCH & APPLICATIONS
+008038     (base 16)		DATA RESEARCH & APPLICATIONS
+				9041 EXECUTIVE PARK DR.
+				KNOXVILLE  TN  37923-4609
+				US
+
+00-80-5E   (hex)		LSI LOGIC CORPORATION
+00805E     (base 16)		LSI LOGIC CORPORATION
+				1551 MCCARTHY BOULEVARD
+				MILPITAS  CA  95035
+				US
+
+00-80-60   (hex)		NETWORK INTERFACE CORPORATION
+008060     (base 16)		NETWORK INTERFACE CORPORATION
+				15019 WEST 95 STREET
+				LENEXA  KS  66215
+				US
+
+00-80-C3   (hex)		BICC INFORMATION SYSTEMS & SVC
+0080C3     (base 16)		BICC INFORMATION SYSTEMS & SVC
+				500 CAPABILITY GREEN, LUTON
+				ENGLAND  LU1  3LT
+				GB
+
+00-80-44   (hex)		SYSTECH COMPUTER CORP.
+008044     (base 16)		SYSTECH COMPUTER CORP.
+				6465 NANCY RIDGE DRIVE
+				SAN DIEGO  CA  92121
+				US
+
+00-80-06   (hex)		COMPUADD CORPORATION
+008006     (base 16)		COMPUADD CORPORATION
+				ENGINEERING
+				AUSTIN  TX  78727
+				US
+
+00-80-9B   (hex)		JUSTSYSTEM CORPORATION
+00809B     (base 16)		JUSTSYSTEM CORPORATION
+				3-46 OKINOHAMAHIGASHI
+				    
+				JP
+
+00-80-DF   (hex)		ADC CODENOLL TECHNOLOGY CORP.
+0080DF     (base 16)		ADC CODENOLL TECHNOLOGY CORP.
+				200 CORPORATE BLVD. SO.
+				YONKERS  NY  10701
+				US
+
+00-80-28   (hex)		TRADPOST (HK) LTD
+008028     (base 16)		TRADPOST (HK) LTD
+				5/F, STAR CENTRE
+				  HONG  KONG
+				HK
+
+00-80-61   (hex)		LITTON SYSTEMS, INC.
+008061     (base 16)		LITTON SYSTEMS, INC.
+				M/S 44-20
+				AGOURA HILLS  CA  91301-0500
+				US
+
+00-80-F5   (hex)		Quantel Ltd
+0080F5     (base 16)		Quantel Ltd
+				Turnpike Road
+				Newbury  Berkshire  RG14 2NX
+				GB
+
+00-80-B9   (hex)		ARCHE TECHNOLIGIES INC.
+0080B9     (base 16)		ARCHE TECHNOLIGIES INC.
+				48502 KATO ROAD
+				FREMONT  CA  94538
+				US
+
+00-40-63   (hex)		VIA TECHNOLOGIES, INC.
+004063     (base 16)		VIA TECHNOLOGIES, INC.
+				5020 BRANDIN COURT
+				FREMONT  CA  94538
+				US
+
+00-80-8A   (hex)		SUMMIT MICROSYSTEMS CORP.
+00808A     (base 16)		SUMMIT MICROSYSTEMS CORP.
+				710 LAKEWAY-STE.#150
+				SUNNYVALE  CA  940867
+				US
+
+00-80-A7   (hex)		Honeywell International Inc
+0080A7     (base 16)		Honeywell International Inc
+				Vancouver Center of Excellence 
+				North Vancouver    V7J 3S4 
+				CA
+
+00-80-66   (hex)		ARCOM CONTROL SYSTEMS, LTD.
+008066     (base 16)		ARCOM CONTROL SYSTEMS, LTD.
+				UNIT 8, CLIFTON ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-80-CB   (hex)		FALCO DATA PRODUCTS
+0080CB     (base 16)		FALCO DATA PRODUCTS
+				440 POTRERO AVENUE
+				SUNNYVALE  CA  94086-4196
+				US
+
+00-80-07   (hex)		DLOG NC-SYSTEME
+008007     (base 16)		DLOG NC-SYSTEME
+				WERNER-VON-SIEMENS STRASSE 13
+				    GERMANY
+				
+
+00-80-62   (hex)		INTERFACE  CO.
+008062     (base 16)		INTERFACE  CO.
+				8-26 OZU 5-CHOME MINAMI-KU
+				    
+				JP
+
+00-80-1E   (hex)		XINETRON, INC.
+00801E     (base 16)		XINETRON, INC.
+				2330 B. WALSH AVE.
+				SANTA CLARA  CA  95051
+				US
+
+00-80-E2   (hex)		T.D.I. CO., LTD.
+0080E2     (base 16)		T.D.I. CO., LTD.
+				DEVELOPMENT DIV.  #3 FUJI BLDG
+				    
+				JP
+
+00-80-49   (hex)		NISSIN ELECTRIC CO., LTD.
+008049     (base 16)		NISSIN ELECTRIC CO., LTD.
+				47, UMEZU - TAKASE - CHO
+				    
+				JP
+
+00-80-C1   (hex)		LANEX CORPORATION
+0080C1     (base 16)		LANEX CORPORATION
+				10727 TUCKER STREET
+				BELTSVILLE  MD  20705
+				US
+
+00-80-A3   (hex)		Lantronix
+0080A3     (base 16)		Lantronix
+				15353 Barranca Parkway
+				Irvine  CA  92618
+				US
+
+00-80-BC   (hex)		HITACHI ENGINEERING CO., LTD
+0080BC     (base 16)		HITACHI ENGINEERING CO., LTD
+				4-8-26, OMIKACHO
+				    
+				JP
+
+00-80-36   (hex)		REFLEX MANUFACTURING SYSTEMS
+008036     (base 16)		REFLEX MANUFACTURING SYSTEMS
+				UNIT D, THE FLEMING CENTRE,
+				    ENGLAND
+				GB
+
+00-80-83   (hex)		AMDAHL
+008083     (base 16)		AMDAHL
+				1250 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94088-3470
+				US
+
+00-80-B8   (hex)		DMG MORI B.U.G. CO., LTD.
+0080B8     (base 16)		DMG MORI B.U.G. CO., LTD.
+				1-1-14 Techno park,
+				Shimonopporo, Atsubetsuku, Sapporo  Hokkaido  004-0015
+				JP
+
+00-80-4D   (hex)		CYCLONE MICROSYSTEMS, INC.
+00804D     (base 16)		CYCLONE MICROSYSTEMS, INC.
+				25 SCIENCE PARK
+				NEW HAVEN  CT  06511
+				US
+
+00-80-D4   (hex)		CHASE RESEARCH LTD.
+0080D4     (base 16)		CHASE RESEARCH LTD.
+				7 CHINEHAM BUSINESS PARK
+				    ENGLAND
+				GB
+
+00-80-3D   (hex)		SURIGIKEN CO.,  LTD.
+00803D     (base 16)		SURIGIKEN CO.,  LTD.
+				YOUTH BLDG, 4-1-9 SHINJUKU
+				    
+				JP
+
+00-80-8B   (hex)		DACOLL LIMITED
+00808B     (base 16)		DACOLL LIMITED
+				DACOLL HOUSE, GARDNERS LANE
+				SCOTLAND  EH48  1TP
+				GB
+
+00-80-B2   (hex)		NETWORK EQUIPMENT TECHNOLOGIES
+0080B2     (base 16)		NETWORK EQUIPMENT TECHNOLOGIES
+				6900 PASEO PADRE PARKWAY
+				FREMONT  CA  94555
+				US
+
+00-80-76   (hex)		MCNC
+008076     (base 16)		MCNC
+				P.O. BOX 12889
+				RTP  NC  27709
+				US
+
+00-80-0B   (hex)		CSK CORPORATION
+00800B     (base 16)		CSK CORPORATION
+				18F MATSUSHITA IMP BLDG,
+				  JAPAN  540
+				JP
+
+00-80-18   (hex)		KOBE STEEL, LTD.
+008018     (base 16)		KOBE STEEL, LTD.
+				KOBE ISUZU RECRUIT BLDG.
+				    
+				JP
+
+00-80-68   (hex)		YAMATECH SCIENTIFIC LTD.
+008068     (base 16)		YAMATECH SCIENTIFIC LTD.
+				1255 LAIRD, SUITE 260
+				    
+				CA
+
+00-80-A8   (hex)		VITACOM CORPORATION
+0080A8     (base 16)		VITACOM CORPORATION
+				1330 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-80-33   (hex)		EMS Aviation, Inc.
+008033     (base 16)		EMS Aviation, Inc.
+				121 WHITTENDALE DRIVE
+				MOORESTOWN  NJ  08057
+				US
+
+00-80-7C   (hex)		FIBERCOM, INC.
+00807C     (base 16)		FIBERCOM, INC.
+				3353 ORANGE AVENUE NE
+				ROANOKE  VA  24012
+				US
+
+00-80-91   (hex)		TOKYO ELECTRIC CO.,LTD
+008091     (base 16)		TOKYO ELECTRIC CO.,LTD
+				10-14 UCHIKANDA
+				TOKYO  JAPAN  101
+				JP
+
+00-00-8E   (hex)		SOLBOURNE COMPUTER, INC.
+00008E     (base 16)		SOLBOURNE COMPUTER, INC.
+				1900 PIKE ROAD
+				LONGMONT  COLORADO  80501
+				US
+
+00-00-DC   (hex)		HAYES MICROCOMPUTER PRODUCTS
+0000DC     (base 16)		HAYES MICROCOMPUTER PRODUCTS
+				P.O. BOX 105203
+				ATLANTA  GA  30348
+				US
+
+00-00-63   (hex)		BARCO CONTROL ROOMS GMBH
+000063     (base 16)		BARCO CONTROL ROOMS GMBH
+				An der Rossweid 5
+				Karlsruhe    D-76229
+				DE
+
+00-00-4E   (hex)		AMPEX CORPORATION
+00004E     (base 16)		AMPEX CORPORATION
+				581 CONFERENCE PLACE
+				GOLDEN  CO  80401
+				US
+
+00-00-BD   (hex)		Mitsubishi Cable Industries, Ltd. / Ryosei Systems
+0000BD     (base 16)		Mitsubishi Cable Industries, Ltd. / Ryosei Systems
+				 8, NISHINO-CHO, HIGASHI-MUKOJIMA
+				AMAGASAKI  HYOGO  660-0856
+				JP
+
+00-00-2E   (hex)		SOCIETE EVIRA
+00002E     (base 16)		SOCIETE EVIRA
+				ZONE PORTUAIRE DE BREGAILLON
+				    
+				FR
+
+00-00-3F   (hex)		SYNTREX, INC.
+00003F     (base 16)		SYNTREX, INC.
+				246 INDUSTRIAL WAY WEST
+				EATONTOWN  NJ  07724
+				US
+
+00-80-9D   (hex)		Commscraft Ltd.
+00809D     (base 16)		Commscraft Ltd.
+				PO BOX 160
+				    
+				AU
+
+00-80-F4   (hex)		TELEMECANIQUE ELECTRIQUE
+0080F4     (base 16)		TELEMECANIQUE ELECTRIQUE
+				33 BIS AVENUE,
+				    
+				FR
+
+00-80-22   (hex)		SCAN-OPTICS
+008022     (base 16)		SCAN-OPTICS
+				201 TECHNOLOGY DRIVE
+				IRVINE  CA  92718
+				US
+
+00-00-CD   (hex)		Allied Telesis Labs Ltd
+0000CD     (base 16)		Allied Telesis Labs Ltd
+				27 Nazareth Avenue
+				Middleton  Christchurch  8024
+				NZ
+
+00-80-DD   (hex)		GMX INC/GIMIX
+0080DD     (base 16)		GMX INC/GIMIX
+				3223 ARNOLD LANE
+				NORTHBROOK  IL  60062-2406
+				US
+
+00-80-FB   (hex)		BVM LIMITED
+0080FB     (base 16)		BVM LIMITED
+				Lakeside House, Brickyard Road,
+				Swanmore  SOUTHAMPTON  SO32 2SA
+				GB
+
+00-80-B4   (hex)		SOPHIA SYSTEMS
+0080B4     (base 16)		SOPHIA SYSTEMS
+				3337 KIFER ROAD
+				SANTA CLARA  CA  95051
+				US
+
+00-80-7F   (hex)		DY-4 INCORPORATED
+00807F     (base 16)		DY-4 INCORPORATED
+				333 PALLADIUM DRIVE, MS 312
+				    
+				CA
+
+00-80-2D   (hex)		XYLOGICS INC
+00802D     (base 16)		XYLOGICS INC
+				53 THIRD AVENUE
+				BURLINGTON  MA  01803
+				US
+
+00-00-61   (hex)		GATEWAY COMMUNICATIONS
+000061     (base 16)		GATEWAY COMMUNICATIONS
+				2941 ALTON AVENUE
+				IRVINE  CA  92714
+				US
+
+00-00-EA   (hex)		UPNOD AB
+0000EA     (base 16)		UPNOD AB
+				BOX 23051
+				    
+				SE
+
+00-00-43   (hex)		MICRO TECHNOLOGY
+000043     (base 16)		MICRO TECHNOLOGY
+				4905 EAST LAPALMA
+				ANAHEIM  CA  92807
+				US
+
+00-00-17   (hex)		Oracle
+000017     (base 16)		Oracle
+				4200 Network Circle
+				Santa Clara  CA  95054
+				US
+
+00-00-B2   (hex)		TELEVIDEO SYSTEMS, INC.
+0000B2     (base 16)		TELEVIDEO SYSTEMS, INC.
+				550 E. BROKAW ROAD
+				SAN JOSE  CA  95161-9048
+				US
+
+00-00-EE   (hex)		NETWORK DESIGNERS, LTD.
+0000EE     (base 16)		NETWORK DESIGNERS, LTD.
+				UNIT 1A, HORNBEAM PARK
+				UNITED KINGDOM  HG2  8QT
+				GB
+
+00-00-E5   (hex)		SIGMEX LTD.
+0000E5     (base 16)		SIGMEX LTD.
+				SIGMA HOUSE
+				RH12  4UZ  ENGLAND
+				GB
+
+00-00-89   (hex)		CAYMAN SYSTEMS INC.
+000089     (base 16)		CAYMAN SYSTEMS INC.
+				26 LANSDOWNE STREET
+				CAMBRIDGE  MA  02139
+				US
+
+00-00-FF   (hex)		CAMTEC ELECTRONICS LTD.
+0000FF     (base 16)		CAMTEC ELECTRONICS LTD.
+				101 VAUGHAN WAY
+				    ENGLAND
+				GB
+
+00-00-B7   (hex)		DOVE COMPUTER CORPORATION
+0000B7     (base 16)		DOVE COMPUTER CORPORATION
+				1200 NORTH 23RD STREET
+				WILMINGTON  NC  28405
+				US
+
+00-00-F2   (hex)		SPIDER COMMUNICATIONS
+0000F2     (base 16)		SPIDER COMMUNICATIONS
+				7491 BRIAR ROAD
+				    
+				CA
+
+00-00-CC   (hex)		DENSAN CO., LTD.
+0000CC     (base 16)		DENSAN CO., LTD.
+				1-23-11, KAMITAKAIDO
+				    
+				JP
+
+00-00-A4   (hex)		ACORN COMPUTERS LIMITED
+0000A4     (base 16)		ACORN COMPUTERS LIMITED
+				FULBOURN ROAD, CHERRY HINTON
+				    ENGLAND
+				GB
+
+00-00-DB   (hex)		British Telecommunications plc
+0000DB     (base 16)		British Telecommunications plc
+				81 New Gate St
+				    England
+				GB
+
+00-00-C1   (hex)		Madge Ltd.
+0000C1     (base 16)		Madge Ltd.
+				Madge House
+				Maindenhead  Berkshire  SL6 2HP
+				GB
+
+00-00-F6   (hex)		APPLIED MICROSYSTEMS CORP.
+0000F6     (base 16)		APPLIED MICROSYSTEMS CORP.
+				5020 148 AVENUE, N.E.
+				REDMOND  WA  98073-9702
+				US
+
+00-00-77   (hex)		INTERPHASE CORPORATION
+000077     (base 16)		INTERPHASE CORPORATION
+				13800 SENLAC
+				DALLAS  TX  75234
+				US
+
+00-00-A2   (hex)		Bay Networks
+0000A2     (base 16)		Bay Networks
+				PO Box 58185
+				Santa Clara  CA  95052-8185
+				US
+
+00-00-EC   (hex)		MICROPROCESS
+0000EC     (base 16)		MICROPROCESS
+				97 BIS, RUE DE COLOMBES
+				    
+				FR
+
+00-00-C2   (hex)		INFORMATION PRESENTATION TECH.
+0000C2     (base 16)		INFORMATION PRESENTATION TECH.
+				23801 CALABASAS ROAD
+				CALABASAS  CA  91302
+				US
+
+00-00-FC   (hex)		MEIKO
+0000FC     (base 16)		MEIKO
+				650 AZTEC WEST
+				  UNITED  KINGDOM
+				GB
+
+00-00-6D   (hex)		CRAY COMMUNICATIONS, LTD.
+00006D     (base 16)		CRAY COMMUNICATIONS, LTD.
+				P.O. BOX 254, CAXTON WAY
+				  UNITED  KINGDOM
+				GB
+
+00-00-DA   (hex)		ATEX
+0000DA     (base 16)		ATEX
+				15 CROSBY DRIVE
+				BEDFORD  MA  01730
+				US
+
+00-00-DD   (hex)		TCL INCORPORATED
+0000DD     (base 16)		TCL INCORPORATED
+				41829 ALBRAE STREET
+				FREMONT  CA  94538
+				US
+
+00-00-AE   (hex)		DASSAULT ELECTRONIQUE
+0000AE     (base 16)		DASSAULT ELECTRONIQUE
+				55, QUAI MARCEL DASSAULT
+				    
+				FR
+
+00-00-A0   (hex)		SANYO Electric Co., Ltd.
+0000A0     (base 16)		SANYO Electric Co., Ltd.
+				5-5, Keihan-hondori 2-chome,
+				Moriguchi City  Osaka  570-8677
+				JP
+
+00-00-C0   (hex)		WESTERN DIGITAL CORPORATION
+0000C0     (base 16)		WESTERN DIGITAL CORPORATION
+				8105 IRVINE CENTER DRIVE
+				IRVINE  CA  92718
+				US
+
+00-00-33   (hex)		EGAN MACHINERY COMPANY
+000033     (base 16)		EGAN MACHINERY COMPANY
+				SOUTH ADAMSVILLE ROAD
+				SOMMERVILLE  NJ  08876
+				US
+
+00-00-9D   (hex)		LOCUS COMPUTING CORPORATION
+00009D     (base 16)		LOCUS COMPUTING CORPORATION
+				9800 LA CIENEGA
+				INGLEWOOD  CA  90301
+				US
+
+00-00-FD   (hex)		HIGH LEVEL HARDWARE
+0000FD     (base 16)		HIGH LEVEL HARDWARE
+				PO BOX 170 WINDMILL ROAD
+				    ENGLAND
+				GB
+
+00-00-65   (hex)		Network General Corporation
+000065     (base 16)		Network General Corporation
+				178 E Tsaman Dr
+				San Jose  CA  95134
+				US
+
+00-00-11   (hex)		NORMEREL SYSTEMES
+000011     (base 16)		NORMEREL SYSTEMES
+				58 RUE POTTIER
+				    
+				FR
+
+00-00-10   (hex)		SYTEK INC.
+000010     (base 16)		SYTEK INC.
+				1225 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-00-BC   (hex)		Rockwell Automation
+0000BC     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+08-00-7E   (hex)		AMALGAMATED WIRELESS(AUS) LTD
+08007E     (base 16)		AMALGAMATED WIRELESS(AUS) LTD
+				NORTH RYDE DIVISION
+				  AUSTRALIA  2113
+				AU
+
+08-00-7F   (hex)		CARNEGIE-MELLON UNIVERSITY
+08007F     (base 16)		CARNEGIE-MELLON UNIVERSITY
+				INFORMATION TECHNOLOGY
+				PITTSBURGE  PA  15213
+				US
+
+00-00-99   (hex)		MTX, INC.
+000099     (base 16)		MTX, INC.
+				3301 TERMINAL DRIVE
+				RALEIGH  NC  27604
+				US
+
+00-00-C4   (hex)		WATERS DIV. OF MILLIPORE
+0000C4     (base 16)		WATERS DIV. OF MILLIPORE
+				34 MAPLE STREET
+				MILFORD  MA  01757
+				US
+
+00-00-EB   (hex)		MATSUSHITA COMM. IND. CO. LTD.
+0000EB     (base 16)		MATSUSHITA COMM. IND. CO. LTD.
+				3-1  4-CHOME
+				    
+				JP
+
+00-00-28   (hex)		PRODIGY SYSTEMS CORPORATION
+000028     (base 16)		PRODIGY SYSTEMS CORPORATION
+				2601 CASEY DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+08-00-3B   (hex)		TORUS SYSTEMS LIMITED
+08003B     (base 16)		TORUS SYSTEMS LIMITED
+				SCIENCE PARK
+				  UNITED  KINGDOM
+				GB
+
+08-00-3C   (hex)		SCHLUMBERGER WELL SERVICES
+08003C     (base 16)		SCHLUMBERGER WELL SERVICES
+				AUSTIN ENGINEERING SERVICES
+				AUSTIN  TX  78720-0015
+				US
+
+08-00-34   (hex)		FILENET CORPORATION
+080034     (base 16)		FILENET CORPORATION
+				1575 CORPORATE DRIVE
+				COSTA MESA  CA  92626
+				US
+
+08-00-36   (hex)		INTERGRAPH CORPORATION
+080036     (base 16)		INTERGRAPH CORPORATION
+				ONE MADISON INDUSTRIAL PARK
+				HUNTSVILLE  AL  35807
+				US
+
+08-00-33   (hex)		BAUSCH & LOMB
+080033     (base 16)		BAUSCH & LOMB
+				INTERACTIVE GRAPHICS DIVISION
+				AUSITN  TX  78671
+				US
+
+08-00-48   (hex)		EUROTHERM GAUGING SYSTEMS
+080048     (base 16)		EUROTHERM GAUGING SYSTEMS
+				900 MIDDLESEX TURNPIKE, BDG. 6
+				BILLERICA  MA  01821
+				US
+
+08-00-43   (hex)		PIXEL COMPUTER INC.
+080043     (base 16)		PIXEL COMPUTER INC.
+				260 FORDHAM ROAD
+				WILMINGTON  MA  01887
+				US
+
+08-00-45   (hex)		CONCURRENT COMPUTER CORP.
+080045     (base 16)		CONCURRENT COMPUTER CORP.
+				2 CRESCENT PLACE
+				OCEANPORT  NJ  07757
+				US
+
+08-00-78   (hex)		ACCELL CORPORATION
+080078     (base 16)		ACCELL CORPORATION
+				50 SAGINAW DRIVE
+				ROCHESTER  NY  14623
+				US
+
+08-00-6D   (hex)		WHITECHAPEL COMPUTER WORKS
+08006D     (base 16)		WHITECHAPEL COMPUTER WORKS
+				75 WHITECHAPEL ROAD
+				LONDON  E1  1DU
+				GB
+
+08-00-30   (hex)		NETWORK RESEARCH CORPORATION
+080030     (base 16)		NETWORK RESEARCH CORPORATION
+				2380 N. ROSE AVENUE
+				OXNARD  CA  93010
+				US
+
+08-00-31   (hex)		LITTLE MACHINES INC.
+080031     (base 16)		LITTLE MACHINES INC.
+				4141 JUTLAND DRIVE
+				SAN DIEGO  CA  92117
+				US
+
+08-00-2E   (hex)		METAPHOR COMPUTER SYSTEMS
+08002E     (base 16)		METAPHOR COMPUTER SYSTEMS
+				2500 GARCIA AVENUE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+08-00-56   (hex)		STANFORD LINEAR ACCEL. CENTER
+080056     (base 16)		STANFORD LINEAR ACCEL. CENTER
+				2575 SANDHILL ROAD
+				MENLO PARK  CA  94025
+				US
+
+08-00-4F   (hex)		CYGNET SYSTEMS
+08004F     (base 16)		CYGNET SYSTEMS
+				2560 JUNCTION AVENUE
+				SAN JOSE  CA  95134
+				US
+
+08-00-50   (hex)		DAISY SYSTEMS CORP.
+080050     (base 16)		DAISY SYSTEMS CORP.
+				139 KIFER COURT
+				SUNNYVALE  CA  94086
+				US
+
+08-00-5E   (hex)		COUNTERPOINT COMPUTER INC.
+08005E     (base 16)		COUNTERPOINT COMPUTER INC.
+				2127 RINGWOOD AVENUE
+				SAN JOSE  CA  95131
+				US
+
+08-00-76   (hex)		PC LAN TECHNOLOGIES
+080076     (base 16)		PC LAN TECHNOLOGIES
+				5780 LINCOLN DRIVE SUITE 106
+				MINNEAPOLIS  MN  55436
+				US
+
+08-00-75   (hex)		DANSK DATA ELECTRONIK
+080075     (base 16)		DANSK DATA ELECTRONIK
+				HERLEV HOVEDGADE 199
+				    
+				DK
+
+08-00-2B   (hex)		DIGITAL EQUIPMENT CORPORATION
+08002B     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+08-00-29   (hex)		Megatek Corporation
+080029     (base 16)		Megatek Corporation
+				16868 Via Del Campo Court
+				San Diego  CA  92127
+				US
+
+02-70-B0   (hex)		M/A-COM INC. COMPANIES
+0270B0     (base 16)		M/A-COM INC. COMPANIES
+				11717 EXPLORATION LANE
+				GERMANTOWN  MD  20767
+				US
+
+00-00-53   (hex)		COMPUCORP
+000053     (base 16)		COMPUCORP
+				2211 MICHIGAN AVENUE
+				SANTA MONICA  CA  90404
+				US
+
+08-00-90   (hex)		SONOMA SYSTEMS
+080090     (base 16)		SONOMA SYSTEMS
+				4640 ADMIRALTY WAY,  STE. #600
+				MARINA DEL REY  CA  90292-6695
+				US
+
+08-00-0A   (hex)		NESTAR SYSTEMS INCORPORATED
+08000A     (base 16)		NESTAR SYSTEMS INCORPORATED
+				2585 EAST BAYSHORE ROAD
+				PALO ALTO  CA  94303
+				US
+
+00-80-0F   (hex)		STANDARD MICROSYSTEMS
+00800F     (base 16)		STANDARD MICROSYSTEMS
+				300 KENNEDY DRIVE
+				HAUPPAUGE  NY  11788
+				US
+
+00-40-6B   (hex)		SYSGEN
+00406B     (base 16)		SYSGEN
+				556 GIBRALTAR DRIVE
+				MILPITAS  CA  95035
+				US
+
+08-00-0F   (hex)		MITEL CORPORATION
+08000F     (base 16)		MITEL CORPORATION
+				350 LEGGET DRIVE
+				CANADA  K2K  1X3
+				CA
+
+08-00-23   (hex)		Panasonic Communications Co., Ltd.
+080023     (base 16)		Panasonic Communications Co., Ltd.
+				4-1-62 Minoshima Hakata Fukuoka
+				    812-8531
+				JP
+
+B0-4F-C3   (hex)		Shenzhen NVC Cloud Technology Co., Ltd.
+B04FC3     (base 16)		Shenzhen NVC Cloud Technology Co., Ltd.
+				Rm. 1406, Bld. 11A, Shenzhen Bay Eco-Technology Park, Nanshan Dist.,
+				Shenzhen  Guangdong  518063
+				CN
+
+08-00-1C   (hex)		KDD-KOKUSAI DEBNSIN DENWA CO.
+08001C     (base 16)		KDD-KOKUSAI DEBNSIN DENWA CO.
+				FUJI XEROX CO., LTD. TELEGRAPH
+				  107  
+				JP
+
+00-DD-0C   (hex)		UNGERMANN-BASS INC.
+00DD0C     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+08-00-18   (hex)		PIRELLI FOCOM NETWORKS
+080018     (base 16)		PIRELLI FOCOM NETWORKS
+				DENTON DRIVE
+				    ENGLAND
+				GB
+
+00-00-A6   (hex)		NETWORK GENERAL CORPORATION
+0000A6     (base 16)		NETWORK GENERAL CORPORATION
+				1296 B LAWRENCE STATION ROAD
+				SUNNYVALE  CA  94089
+				US
+
+00-BB-F0   (hex)		UNGERMANN-BASS INC.
+00BBF0     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-40-8E   (hex)		Tattile SRL 
+00408E     (base 16)		Tattile SRL 
+				2360 MARYLAND ROAD
+				WILLOW GROVE  PA  19090
+				US
+
+00-00-04   (hex)		XEROX CORPORATION
+000004     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-DD-0E   (hex)		UNGERMANN-BASS INC.
+00DD0E     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+88-57-1D   (hex)		Seongji Industry Company
+88571D     (base 16)		Seongji Industry Company
+				 54-33, Dongtanhana 1-gil
+				Hwaseong-si  Gyeonggi-do  18423
+				KR
+
+7C-F3-1B   (hex)		LG Electronics (Mobile Communications)
+7CF31B     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-01-C8   (hex)		THOMAS CONRAD CORP.
+0001C8     (base 16)		THOMAS CONRAD CORP.
+				1908-R KRAMER LANE
+				AUSTIN  TX  78758
+				US
+
+CC-EF-03   (hex)		Hunan Keyshare Communication Technology Co., Ltd.
+CCEF03     (base 16)		Hunan Keyshare Communication Technology Co., Ltd.
+				No. 19 Building, CEC Software Park, No. 39 jianshan Rd
+				Changsha  Hunan  410205
+				CN
+
+10-2F-A3   (hex)		Shenzhen Uvision-tech Technology Co.Ltd
+102FA3     (base 16)		Shenzhen Uvision-tech Technology Co.Ltd
+				shenzhen longhua Street
+				shenzhen  GuangDong  518000
+				CN
+
+70-48-F7   (hex)		Nintendo Co.,Ltd
+7048F7     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+18-E1-CA   (hex)		wanze
+18E1CA     (base 16)		wanze
+				wanjinglu
+				dandong  Liaoning  118000
+				CN
+
+EC-BE-DD   (hex)		Sagemcom Broadband SAS
+ECBEDD     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-C0-B6   (hex)		HVE, Inc. 
+00C0B6     (base 16)		HVE, Inc. 
+				Suite 2, 100 Executive Court
+				Waxahachie  TX  75165
+				US
+
+30-91-76   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+309176     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+78-C8-81   (hex)		Sony Interactive Entertainment Inc.
+78C881     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+D4-4F-68   (hex)		Eidetic Communications Inc
+D44F68     (base 16)		Eidetic Communications Inc
+				3553 31st NW
+				Calgary  Alberta  T2L2K7
+				CA
+
+74-9E-A5   (hex)		OHSUNG
+749EA5     (base 16)		OHSUNG
+				335-4,SANHODAERO,GUMI,GYEONG BUK,KOREA
+				GUMI  GYEONG BUK  730-030
+				KR
+
+8C-C8-4B   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+8CC84B     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+0C-2F-B0   (hex)		Samsung Electronics Co.,Ltd
+0C2FB0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-02-16   (hex)		Cisco Systems, Inc
+B40216     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+54-A4-93   (hex)		IEEE Registration Authority
+54A493     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+6C-1C-71   (hex)		Zhejiang Dahua Technology Co., Ltd.
+6C1C71     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+CC-6A-10   (hex)		The Chamberlain Group, Inc
+CC6A10     (base 16)		The Chamberlain Group, Inc
+				300 Windsor Drive
+				Oak Brook  IL  60523
+				US
+
+F0-3F-95   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F03F95     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-56-44   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+185644     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-69-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C69D1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-5A-58   (hex)		Dell Inc.
+185A58     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+C4-3A-35   (hex)		FN-LINK TECHNOLOGY LIMITED
+C43A35     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+04-D1-6E   (hex)		IEEE Registration Authority
+04D16E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+04-0E-3C   (hex)		HP Inc.
+040E3C     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+C4-E0-DE   (hex)		Zhengzhou XindaJiean Information Technology Co.,Ltd.
+C4E0DE     (base 16)		Zhengzhou XindaJiean Information Technology Co.,Ltd.
+				Tianli building A, wisdom park, no. 139, yangjin road, jinshui district
+				Zhengzhou  Henan  450003
+				CN
+
+90-1A-4F   (hex)		EM Microelectronic
+901A4F     (base 16)		EM Microelectronic
+				Rue des Sors 3
+				Marin-Epagnier  Neuchatel  2074
+				CH
+
+C8-4F-0E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+C84F0E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+6C-D2-BA   (hex)		zte corporation
+6CD2BA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+30-3A-BA   (hex)		Guangzhou BaoLun Electronics Co., Ltd
+303ABA     (base 16)		Guangzhou BaoLun Electronics Co., Ltd
+				No.1 Building B Block, Zhongcun Street, Panyu District
+				Guangzhou  guangdong  511400
+				CN
+
+D8-8A-DC   (hex)		Huawei Device Co., Ltd.
+D88ADC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+10-E9-53   (hex)		Huawei Device Co., Ltd.
+10E953     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+7C-48-B2   (hex)		Vida Resources Lte Ltd
+7C48B2     (base 16)		Vida Resources Lte Ltd
+				10 Anson road, unit #16-20 International Plaza
+				Singapore    079903
+				SG
+
+2C-AB-33   (hex)		Texas Instruments
+2CAB33     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B8-87-C6   (hex)		Prudential Technology co.,LTD
+B887C6     (base 16)		Prudential Technology co.,LTD
+				UNIT 4,7/F BRIGHT WAY TOWER, NO33 MONG KOK RD, 
+				Hong Kong    999077 
+				CN
+
+EC-9C-32   (hex)		Sichuan AI-Link Technology Co., Ltd.
+EC9C32     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+4C-AD-A8   (hex)		PANOPTICS CORP.
+4CADA8     (base 16)		PANOPTICS CORP.
+				D-908 Bundang Technopark, 700 Pangyoro, Bundang
+				Seongnam  Gyeonggi  13516
+				KR
+
+FC-1C-A1   (hex)		Nokia
+FC1CA1     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+D4-2D-C5   (hex)		Panasonic i-PRO Sensing Solutions Co., Ltd.
+D42DC5     (base 16)		Panasonic i-PRO Sensing Solutions Co., Ltd.
+				4-1-62 Minoshima, Hakata-ku
+				Fukuoka City     812-8531
+				JP
+
+E8-D0-3C   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+E8D03C     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+1C-1A-DF   (hex)		Microsoft Corporation
+1C1ADF     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+D4-F5-47   (hex)		Google, Inc.
+D4F547     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+98-1B-B5   (hex)		ASSA ABLOY Korea Co., Ltd iRevo
+981BB5     (base 16)		ASSA ABLOY Korea Co., Ltd iRevo
+				10F of JEI PLATZ Bldg., 186, Gasandigital-ro, Geumcheon-gu
+				Seoul    08502
+				KR
+
+34-CB-1A   (hex)		Procter & Gamble Company
+34CB1A     (base 16)		Procter & Gamble Company
+				2 Procter & Gamble Plaza
+				Cincinnati  OH  45202
+				US
+
+F0-B1-07   (hex)		Ericsson AB
+F0B107     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+78-4F-9B   (hex)		Juniper Networks
+784F9B     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+78-3A-6C   (hex)		TECNO MOBILE LIMITED
+783A6C     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+E0-40-07   (hex)		Huawei Device Co., Ltd.
+E04007     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+38-3F-B3   (hex)		Technicolor CH USA Inc.
+383FB3     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+70-CE-8C   (hex)		Samsung Electronics Co.,Ltd
+70CE8C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+40-70-F5   (hex)		Apple, Inc.
+4070F5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-35-B5   (hex)		Apple, Inc.
+B035B5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-AF-D1   (hex)		netKTI Co., Ltd
+90AFD1     (base 16)		netKTI Co., Ltd
+				7-10F THE-ONE SQUARE, 135, Unjung-ro, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13461
+				KR
+
+80-0C-67   (hex)		Apple, Inc.
+800C67     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-81-2A   (hex)		Apple, Inc.
+90812A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-17-BE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7817BE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F0-72-EA   (hex)		Google, Inc.
+F072EA     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+B8-7B-C5   (hex)		Apple, Inc.
+B87BC5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-51-36   (hex)		TCT mobile ltd
+F05136     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+10-59-32   (hex)		Roku, Inc
+105932     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+20-74-54   (hex)		vivo Mobile Communication Co., Ltd.
+207454     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+B8-C9-B5   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B8C9B5     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+88-AC-C0   (hex)		Zyxel Communications Corporation
+88ACC0     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+90-FD-73   (hex)		zte corporation
+90FD73     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+1C-1E-38   (hex)		PCCW Global, Inc.
+1C1E38     (base 16)		PCCW Global, Inc.
+				475 Spring Park Pl Suite 100 Herndon VA 20170
+				Herndon  WA  20170
+				US
+
+3C-41-0E   (hex)		Cisco Systems, Inc
+3C410E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+88-D9-8F   (hex)		Juniper Networks
+88D98F     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-45-E2   (hex)		CyberTAN Technology Inc.
+0045E2     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+00-69-67   (hex)		IEEE Registration Authority
+006967     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-6F-DE   (hex)		Shenzhen Goodix Technology Co.,Ltd.
+F86FDE     (base 16)		Shenzhen Goodix Technology Co.,Ltd.
+				 F13,Phase B,Tengfei Industrial Building,Futian Free Trade Zone,Shenzhen,China
+				Shenzhen  Guangdong  518045
+				CN
+
+64-66-24   (hex)		Sagemcom Broadband SAS
+646624     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+B0-F5-30   (hex)		Hitron Technologies. Inc
+B0F530     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+74-0A-E1   (hex)		Huawei Device Co., Ltd.
+740AE1     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B4-A8-98   (hex)		Huawei Device Co., Ltd.
+B4A898     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+0C-E4-A0   (hex)		Huawei Device Co., Ltd.
+0CE4A0     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+BC-1A-E4   (hex)		Huawei Device Co., Ltd.
+BC1AE4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+04-3F-72   (hex)		Mellanox Technologies, Inc.
+043F72     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+1C-4D-66   (hex)		Amazon Technologies Inc.
+1C4D66     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+50-2C-C6   (hex)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+502CC6     (base 16)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+				Jinji West Road, Qianshan,
+				Zhuhai  Guangdong  519070
+				CN
+
+F4-FE-FB   (hex)		Samsung Electronics Co.,Ltd
+F4FEFB     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+98-49-14   (hex)		Wistron Neweb Corporation
+984914     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+0C-EE-99   (hex)		Amazon Technologies Inc.
+0CEE99     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-11-7E   (hex)		Midmark Corp
+00117E     (base 16)		Midmark Corp
+				1001 Asbury Dr
+				Buffalo Grove  IL  60089
+				US
+
+D0-28-BA   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+D028BA     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+A4-28-B7   (hex)		Yangtze Memory Technologies Co., Ltd.
+A428B7     (base 16)		Yangtze Memory Technologies Co., Ltd.
+				No.88 Weilai 3rd Road, East Lake High-tech Development Zone, Wuhan, Hubei, POC
+				Wuhan  Hubei  430078
+				CN
+
+94-92-D2   (hex)		KCF Technologies, Inc.
+9492D2     (base 16)		KCF Technologies, Inc.
+				336 S Fraser Street
+				State College  PA  16801
+				US
+
+E4-A8-DF   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+E4A8DF     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+8C-53-C3   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+8C53C3     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+70-2F-35   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+702F35     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-14-B8   (hex)		Nokia
+C014B8     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-76-3D   (hex)		Veea
+00763D     (base 16)		Veea
+				164 E 83rd Street
+				New York  NY  10028
+				US
+
+30-93-BC   (hex)		Sagemcom Broadband SAS
+3093BC     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+FC-F5-C4   (hex)		Espressif Inc.
+FCF5C4     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+E8-26-B6   (hex)		Inside Biometrics International Limited
+E826B6     (base 16)		Inside Biometrics International Limited
+				Strathpeffer Road
+				Dingwall  Scotland  IV159QF
+				GB
+
+54-CE-69   (hex)		Hikari Trading Co.,Ltd.
+54CE69     (base 16)		Hikari Trading Co.,Ltd.
+				Hikari Building,7-4-14,Ginza,Chuo-ku
+				Tokyo    104-0061
+				JP
+
+6C-C6-3B   (hex)		Taicang T&W Electronics
+6CC63B     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+58-8E-81   (hex)		Silicon Laboratories
+588E81     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+48-B0-2D   (hex)		NVIDIA Corporation
+48B02D     (base 16)		NVIDIA Corporation
+				2701 San Tomas Expressway
+				Santa Clara  CA  95050
+				US
+
+4C-E1-76   (hex)		Cisco Systems, Inc
+4CE176     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-AE-F6   (hex)		eero inc.
+6CAEF6     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+FC-8E-6E   (hex)		StreamCCTV, LLC
+FC8E6E     (base 16)		StreamCCTV, LLC
+				1129 Northern Blvd, STE. 404
+				Manhasset    11030
+				US
+
+E0-2A-E6   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E02AE6     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+64-12-36   (hex)		Technicolor CH USA Inc.
+641236     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+78-8B-2A   (hex)		Zhen Shi Information Technology (Shanghai) Co., Ltd.
+788B2A     (base 16)		Zhen Shi Information Technology (Shanghai) Co., Ltd.
+				5F, Building 3?No. 401 Caobao Road, Xuhui District, Shanghai, China
+				Shanghai  Shanghai  200233
+				CN
+
+AC-64-CF   (hex)		FN-LINK TECHNOLOGY LIMITED
+AC64CF     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+F0-67-28   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+F06728     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+BC-D7-67   (hex)		Private
+BCD767     (base 16)		Private
+
+9C-E1-76   (hex)		Cisco Systems, Inc
+9CE176     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+10-29-59   (hex)		Apple, Inc.
+102959     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-76-84   (hex)		Apple, Inc.
+E47684     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-1A-1D   (hex)		Samsung Electronics Co.,Ltd
+B41A1D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-5C-D5   (hex)		Apple, Inc.
+F05CD5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-DA-6D   (hex)		Tiandy Technologies CO.,LTD
+3CDA6D     (base 16)		Tiandy Technologies CO.,LTD
+				NO.8,haitai huake rd2 (outside ring road),huayuan new technology industrial park
+				Tianjin  Tianjin  300384
+				CN
+
+F8-0D-F0   (hex)		zte corporation
+F80DF0     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+9C-E9-1C   (hex)		zte corporation
+9CE91C     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+5C-17-CF   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+5C17CF     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+A4-FA-76   (hex)		New H3C Technologies Co., Ltd
+A4FA76     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+70-EA-5A   (hex)		Apple, Inc.
+70EA5A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-FA-D3   (hex)		IEEE Registration Authority
+3CFAD3     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-60-78   (hex)		Swissbit AG
+8C6078     (base 16)		Swissbit AG
+				Industriestrasse 4
+				Bronschhofen    CH-9552
+				CH
+
+00-DD-25   (hex)		Shenzhen hechengdong Technology Co., Ltd
+00DD25     (base 16)		Shenzhen hechengdong Technology Co., Ltd
+				302, floor 3, no.90-5, Dayang Road, Xintian community, Fuhai street, Bao'an District
+				Shenzhen  GuangDong  518100
+				CN
+
+80-20-E1   (hex)		BVBA DPTechnics
+8020E1     (base 16)		BVBA DPTechnics
+				Westkapellestraat 396/44
+				Knokke-Heist  West-Vlaanderen  8300
+				BE
+
+04-45-A1   (hex)		NIRIT- Xinwei  Telecom Technology Co., Ltd.
+0445A1     (base 16)		NIRIT- Xinwei  Telecom Technology Co., Ltd.
+				2-? ??????????? ??????, ?.12, ???.2
+				Moscow    115432
+				RU
+
+8C-97-EA   (hex)		FREEBOX SAS
+8C97EA     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+30-AB-6A   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+30AB6A     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+74-9B-E8   (hex)		Hitron Technologies. Inc
+749BE8     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+5C-BA-EF   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+5CBAEF     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+4C-63-71   (hex)		Xiaomi Communications Co Ltd
+4C6371     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+D8-4D-B9   (hex)		Wu Qi Technologies,Inc.
+D84DB9     (base 16)		Wu Qi Technologies,Inc.
+				14/F, 107 Middle Road, Xiantao Big Data Valley, Yubei District
+				Chongqing  Chongqing  401120
+				CN
+
+A0-4F-85   (hex)		LG Electronics (Mobile Communications)
+A04F85     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+D8-07-B6   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D807B6     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+64-6E-97   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+646E97     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+78-50-7C   (hex)		Juniper Networks
+78507C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-12-58   (hex)		TechVoIP Sp z o.o.
+001258     (base 16)		TechVoIP Sp z o.o.
+				Os. Boleslawa Chrobrego 117 
+				Poznan  Wielkopolska  60-681
+				PL
+
+6C-16-32   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6C1632     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-1A-01   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2C1A01     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-78-39   (hex)		zte corporation
+347839     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+24-16-9D   (hex)		Cisco Systems, Inc
+24169D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-19-E2   (hex)		Volterra
+F419E2     (base 16)		Volterra
+				2550 Great America Way #350
+				Santa Clara  CA  95054
+				US
+
+4C-A0-03   (hex)		VITEC
+4CA003     (base 16)		VITEC
+				99 rue Pierre Semard
+				Chatillon    92320
+				FR
+
+64-F2-FB   (hex)		Hangzhou Ezviz Software Co.,Ltd.
+64F2FB     (base 16)		Hangzhou Ezviz Software Co.,Ltd.
+				Room 302, Unit B, Building 2, 399 Danfeng Road,Binjiang District
+				Hangzhou  Zhejiang  310051
+				CN
+
+30-80-9B   (hex)		New H3C Technologies Co., Ltd
+30809B     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+74-22-BB   (hex)		Huawei Device Co., Ltd.
+7422BB     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+6C-0D-34   (hex)		Nokia
+6C0D34     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+4C-45-76   (hex)		China Mobile(Hangzhou) Information Technology Co.,Ltd.
+4C4576     (base 16)		China Mobile(Hangzhou) Information Technology Co.,Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+B4-40-A4   (hex)		Apple, Inc.
+B440A4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-B8-A3   (hex)		Apple, Inc.
+48B8A3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-DB-E3   (hex)		Apple, Inc.
+F4DBE3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-42-8C   (hex)		ALPS ELECTRIC CO., LTD.
+BC428C     (base 16)		ALPS ELECTRIC CO., LTD.
+				nishida  6-1 
+				Kakuda-City  Miyagi-Pref  981-1595
+				JP
+
+F0-7C-C7   (hex)		Juniper Networks
+F07CC7     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+D4-5E-EC   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+D45EEC     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+74-C9-29   (hex)		Zhejiang Dahua Technology Co., Ltd.
+74C929     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+D4-CF-F9   (hex)		Shenzhen SEI Robotics Co.,Ltd
+D4CFF9     (base 16)		Shenzhen SEI Robotics Co.,Ltd
+				501,Productivity Building A, #5 Hi-Tech Middle 2nd Road
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-B2-9E   (hex)		ASCO Power Technologies
+5CB29E     (base 16)		ASCO Power Technologies
+				160 Park Avenue
+				Florham Park  NJ  07932
+				US
+
+9C-C9-EB   (hex)		NETGEAR
+9CC9EB     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+94-CC-04   (hex)		IEEE Registration Authority
+94CC04     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+90-EC-77   (hex)		silicom
+90EC77     (base 16)		silicom
+				14 Atir-Yeda St/
+				Kfar-Sava  Israel  44000
+				IL
+
+88-C3-97   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+88C397     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+F0-F6-C1   (hex)		Sonos, Inc.
+F0F6C1     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+60-68-4E   (hex)		Samsung Electronics Co.,Ltd
+60684E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-20-FD   (hex)		Samsung Electronics Co.,Ltd
+8020FD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-CE-40   (hex)		Samsung Electronics Co.,Ltd
+B4CE40     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-03-84   (hex)		Hongkong Nano IC Technologies Co., Ltd
+540384     (base 16)		Hongkong Nano IC Technologies Co., Ltd
+				Rm. 19C, Lockhart Ctr., 301-307 Lockhart Rd., Wan Chai, Hong Kong
+				Hong Kong  Hong Kong  999077
+				CN
+
+04-BD-BF   (hex)		Samsung Electronics Co.,Ltd
+04BDBF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-7A-BF   (hex)		Samsung Electronics Co.,Ltd
+BC7ABF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-09-31   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B40931     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-E7-EA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94E7EA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-E4-BA   (hex)		Huawei Device Co., Ltd.
+94E4BA     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+34-71-46   (hex)		Huawei Device Co., Ltd.
+347146     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+2C-C5-46   (hex)		Huawei Device Co., Ltd.
+2CC546     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+0C-83-9A   (hex)		Huawei Device Co., Ltd.
+0C839A     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+E0-E0-FC   (hex)		Huawei Device Co., Ltd.
+E0E0FC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+30-50-75   (hex)		GN Audio A/S
+305075     (base 16)		GN Audio A/S
+				Lautrupbjerg 7
+				Ballerup    DK-2750
+				DK
+
+F4-B7-8D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4B78D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-16-E7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A416E7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-B9-B0   (hex)		Intracom Asia Co., Ltd
+30B9B0     (base 16)		Intracom Asia Co., Ltd
+				4F., No77, Sec. 1, Xintai 5th Rd., Xizhi Dist.
+				New Taipei City  Taiwan  221
+				TW
+
+0C-35-FE   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+0C35FE     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+8C-83-DF   (hex)		Nokia
+8C83DF     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+AC-4B-1E   (hex)		Integri-Sys.Com LLC
+AC4B1E     (base 16)		Integri-Sys.Com LLC
+				9130 South Dadeland Bvld. Suite 1509
+				Miami  FL  33156
+				US
+
+B0-E4-D5   (hex)		Google, Inc.
+B0E4D5     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+D4-DA-CD   (hex)		BSkyB Ltd
+D4DACD     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+68-69-CA   (hex)		Hitachi, Ltd.
+6869CA     (base 16)		Hitachi, Ltd.
+				27-18, Minami Oi 6-chome, Shinagawa-ku
+				Tokyo    140-8572
+				JP
+
+AC-4A-56   (hex)		Cisco Systems, Inc
+AC4A56     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-EA-B5   (hex)		Extreme Networks, Inc.
+F4EAB5     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+00-19-77   (hex)		Extreme Networks, Inc.
+001977     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+08-EA-44   (hex)		Extreme Networks, Inc.
+08EA44     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+B0-B5-C3   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B0B5C3     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+70-4A-0E   (hex)		AMPAK Technology,Inc.
+704A0E     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+08-30-6B   (hex)		Palo Alto Networks
+08306B     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+00-86-9C   (hex)		Palo Alto Networks
+00869C     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+4C-B9-11   (hex)		Raisecom Technology CO.,LTD
+4CB911     (base 16)		Raisecom Technology CO.,LTD
+				No. 11, East Area, No. 10 Block, East Xibeiwang Road
+				Beijing    100094
+				CN
+
+40-47-6A   (hex)		Astro Gaming
+40476A     (base 16)		Astro Gaming
+				340 Bryant St., Suite 101
+				San Francisco  CA  94107
+				US
+
+4C-CE-2D   (hex)		Danlaw Inc
+4CCE2D     (base 16)		Danlaw Inc
+				23700 research Dr.
+				Farmington Hills  MI  48335
+				US
+
+BC-0F-9A   (hex)		D-Link International
+BC0F9A     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+30-B2-37   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+30B237     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+BC-5A-56   (hex)		Cisco Systems, Inc
+BC5A56     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B8-7C-F2   (hex)		Extreme Networks, Inc.
+B87CF2     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+88-2B-94   (hex)		MADOKA SYSTEM Co.,Ltd.
+882B94     (base 16)		MADOKA SYSTEM Co.,Ltd.
+				2-105 Hanasakidai Moriyama-ku
+				Nagoya    463-0808
+				JP
+
+7C-EF-61   (hex)		STR Elektronik Josef Schlechtinger GmbH
+7CEF61     (base 16)		STR Elektronik Josef Schlechtinger GmbH
+				Auf dem Ohl 9
+				Wenden    57482
+				DE
+
+64-A9-65   (hex)		Linkflow Co., Ltd.
+64A965     (base 16)		Linkflow Co., Ltd.
+				54, Nonhyeon-ro 2-gil, Gangnam-gu
+				Seoul    06313
+				KR
+
+24-62-CE   (hex)		Aruba, a Hewlett Packard Enterprise Company
+2462CE     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+68-E2-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+68E209     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+40-05-89   (hex)		T-Mobile, USA
+400589     (base 16)		T-Mobile, USA
+				3625 132nd Ave SE
+				BELLEVUE  WA  98006
+				US
+
+C0-9B-F4   (hex)		IEEE Registration Authority
+C09BF4     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F4-30-8B   (hex)		Xiaomi Communications Co Ltd
+F4308B     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+DC-6B-12   (hex)		worldcns inc.
+DC6B12     (base 16)		worldcns inc.
+				174, Namjo-ro 1-gil, Jocheon-eup
+				Jeju-si  Jeju-do  63335
+				KR
+
+70-03-9F   (hex)		Espressif Inc.
+70039F     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+A0-DE-0F   (hex)		Huawei Device Co., Ltd.
+A0DE0F     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F4-87-C5   (hex)		Huawei Device Co., Ltd.
+F487C5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+08-00-88   (hex)		Brocade Communications Systems LLC
+080088     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-01-0F   (hex)		Brocade Communications Systems LLC
+00010F     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+08-B0-55   (hex)		ASKEY COMPUTER CORP
+08B055     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+04-5F-B9   (hex)		Cisco Systems, Inc
+045FB9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-4E-24   (hex)		Brocade Communications Systems LLC
+CC4E24     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-E0-52   (hex)		Brocade Communications Systems LLC
+00E052     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+98-DF-82   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+98DF82     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+3C-F6-52   (hex)		zte corporation
+3CF652     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+5C-0F-FB   (hex)		Amino Communications Ltd
+5C0FFB     (base 16)		Amino Communications Ltd
+				1010 Cambourne Business Park
+				Cambourne  Cambs  CB23 6DP
+				GB
+
+74-58-F3   (hex)		Amazon Technologies Inc.
+7458F3     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-06-31   (hex)		Calix Inc.
+000631     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+A8-05-77   (hex)		Netlist, Inc.
+A80577     (base 16)		Netlist, Inc.
+				175 Technology
+				Irvine  CA  92618
+				US
+
+E4-3A-65   (hex)		MofiNetwork Inc
+E43A65     (base 16)		MofiNetwork Inc
+				11 Boynton Cir
+				Markham  Ontario  L6C 1A8
+				CA
+
+08-AA-55   (hex)		Motorola Mobility LLC, a Lenovo Company
+08AA55     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+54-21-9D   (hex)		Samsung Electronics Co.,Ltd
+54219D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-8B-E8   (hex)		Masimo Corporation
+C88BE8     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine  CA  92618
+				US
+
+F0-41-C6   (hex)		Heat Tech Company, Ltd.
+F041C6     (base 16)		Heat Tech Company, Ltd.
+				221A, Tikhookeanskaya st.
+				Khabarovsk    680033
+				RU
+
+40-40-28   (hex)		ZIV
+404028     (base 16)		ZIV
+				Polígono Parque Tecnológico, 210
+				ZAMUDIO  VIZCAYA  48170
+				ES
+
+F8-6C-03   (hex)		Shenzhen Teleone Technology Co., Ltd
+F86C03     (base 16)		Shenzhen Teleone Technology Co., Ltd
+				TOWER B 5/F, SHANSHUI BUILDING, NANSHAN YUNGU INNOVATION INDUSTRY PARK, 1183 LIUXIAN AVENUE, NANSHAN, SHENZHEN, CHINA
+				Shenzhen    518000
+				CN
+
+D8-71-4D   (hex)		Texas Instruments
+D8714D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+0C-EC-80   (hex)		Texas Instruments
+0CEC80     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+10-5D-DC   (hex)		Huawei Device Co., Ltd.
+105DDC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+DC-73-85   (hex)		Huawei Device Co., Ltd.
+DC7385     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+54-55-D5   (hex)		Huawei Device Co., Ltd.
+5455D5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-15-D2   (hex)		Xantech Corporation
+0015D2     (base 16)		Xantech Corporation
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+00-1F-40   (hex)		Speakercraft Inc.
+001F40     (base 16)		Speakercraft Inc.
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+18-45-93   (hex)		Taicang T&W Electronics
+184593     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+C4-98-86   (hex)		Qorvo Utrecht B.V.
+C49886     (base 16)		Qorvo Utrecht B.V.
+				Leidseveer 10
+				Utrecht  Utrecht  3511SB
+				NL
+
+CC-9E-CA   (hex)		HMD Global Oy
+CC9ECA     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo  Espoo  02600
+				FI
+
+3C-30-6F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C306F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-EA-E7   (hex)		Shanghai High-Flying Electronics  Technology Co., Ltd
+34EAE7     (base 16)		Shanghai High-Flying Electronics  Technology Co., Ltd
+				Room 1002,#1Building,No.3000 Longdong Avenue,Pudong
+				Shanghai  Shanghai  201202
+				CN
+
+D4-AB-CD   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+D4ABCD     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+80-E1-BF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80E1BF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-2C-D0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+482CD0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-19-32   (hex)		Gude Systems GmbH
+001932     (base 16)		Gude Systems GmbH
+				Von-der-Wettern-Str. 23
+				Cologne  NRW  51149
+				DE
+
+A0-CA-A5   (hex)		INTELLIGENCE TECHNOLOGY OF CEC CO., LTD
+A0CAA5     (base 16)		INTELLIGENCE TECHNOLOGY OF CEC CO., LTD
+				Tower A, NO.2 Lutuan Road, The sountern Of Future Science and Tech Zone, Changping District
+				Beijing  Beijing  102209
+				CN
+
+5C-5F-67   (hex)		Intel Corporate
+5C5F67     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+0C-54-15   (hex)		Intel Corporate
+0C5415     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+30-24-32   (hex)		Intel Corporate
+302432     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+DC-8B-28   (hex)		Intel Corporate
+DC8B28     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+1C-1B-B5   (hex)		Intel Corporate
+1C1BB5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+F8-34-41   (hex)		Intel Corporate
+F83441     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E4-70-B8   (hex)		Intel Corporate
+E470B8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E0-0E-E4   (hex)		DWnet Technologies(Suzhou) Corporation
+E00EE4     (base 16)		DWnet Technologies(Suzhou) Corporation
+				No.8,Tangzhuang Road, Suzhou Industrial Park, Jiangsu, China
+				Suzhou    21500
+				CN
+
+E8-85-4B   (hex)		Apple, Inc.
+E8854B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-EC-95   (hex)		Apple, Inc.
+28EC95     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-FD-B1   (hex)		LG Electronics
+58FDB1     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+E0-2B-96   (hex)		Apple, Inc.
+E02B96     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-46-9D   (hex)		Cisco Meraki
+A8469D     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco    94158
+				US
+
+6C-DE-A9   (hex)		Cisco Meraki
+6CDEA9     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco    94158
+				US
+
+8C-CE-FD   (hex)		Shenzhen zhouhai technology co.,LTD
+8CCEFD     (base 16)		Shenzhen zhouhai technology co.,LTD
+				401-403,415-416, Area A, Block B, West Silicon Valley, 5010 Baoan Avenue, Baoan District, Shenzhen, China
+				Shenzhen  Guangdong  518110
+				CN
+
+50-FB-19   (hex)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+50FB19     (base 16)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+				9F,BLOCK A,GARDEN CITY DIGITAL BUILDING,NO.1079 NANHAI ROAD,NANSHAN DISTRICT
+				SHEN ZHEN  GUANG DONG  518000
+				CN
+
+D0-AB-D5   (hex)		Intel Corporate
+D0ABD5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+68-17-29   (hex)		Intel Corporate
+681729     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+B8-08-CF   (hex)		Intel Corporate
+B808CF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+DC-71-96   (hex)		Intel Corporate
+DC7196     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+50-E0-85   (hex)		Intel Corporate
+50E085     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+94-08-C7   (hex)		Huawei Device Co., Ltd.
+9408C7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C8-CA-63   (hex)		Huawei Device Co., Ltd.
+C8CA63     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+98-3B-8F   (hex)		Intel Corporate
+983B8F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D0-C6-37   (hex)		Intel Corporate
+D0C637     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+04-EA-56   (hex)		Intel Corporate
+04EA56     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D4-3B-04   (hex)		Intel Corporate
+D43B04     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+38-68-93   (hex)		Intel Corporate
+386893     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D8-3B-BF   (hex)		Intel Corporate
+D83BBF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+14-F6-D8   (hex)		Intel Corporate
+14F6D8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E0-D4-E8   (hex)		Intel Corporate
+E0D4E8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+94-E6-F7   (hex)		Intel Corporate
+94E6F7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+4C-1D-96   (hex)		Intel Corporate
+4C1D96     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+70-3A-A6   (hex)		New H3C Technologies Co., Ltd
+703AA6     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+94-37-F7   (hex)		Huawei Device Co., Ltd.
+9437F7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+04-6C-59   (hex)		Intel Corporate
+046C59     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+90-3F-EA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+903FEA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-AB-48   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20AB48     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-D7-3C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CCD73C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-40-D0   (hex)		OCOSMOS Co., LTD
+D440D0     (base 16)		OCOSMOS Co., LTD
+				(Tamnip-Dong) #1, 263-1 Techno 2-Ro Yuseong-Gu
+				Daejeon  Daejeon  34026
+				KR
+
+94-E7-0B   (hex)		Intel Corporate
+94E70B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+00-1E-E0   (hex)		Urmet SpA
+001EE0     (base 16)		Urmet SpA
+				Via Bologna 188/C
+				Torino  TO  I-10154
+				IT
+
+DC-D9-AE   (hex)		Nokia Shanghai Bell Co., Ltd.
+DCD9AE     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai
+				Shanghai     201206
+				CN
+
+98-B8-BC   (hex)		Samsung Electronics Co.,Ltd
+98B8BC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-4E-16   (hex)		Samsung Electronics Co.,Ltd
+184E16     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-3D-03   (hex)		Samsung Electronics Co.,Ltd
+C03D03     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-97-B1   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+A497B1     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+BC-A9-93   (hex)		Cambium Networks Limited
+BCA993     (base 16)		Cambium Networks Limited
+				Unit B2, Linhay Business Park,
+				Ashburton  Devon  TQ13 7UP
+				GB
+
+10-74-6F   (hex)		MOTOROLA SOLUTIONS MALAYSIA SDN. BHD.
+10746F     (base 16)		MOTOROLA SOLUTIONS MALAYSIA SDN. BHD.
+				INNOPLEX, NO. 2A, MEDAN BAYAN LEPAS, BAYAN LEPAS TECHNOPLEX
+				BAYAN LEPAS  PENANG  11900
+				MY
+
+00-92-7D   (hex)		Ficosa Internationa(Taicang) C0.,Ltd.
+00927D     (base 16)		Ficosa Internationa(Taicang) C0.,Ltd.
+				No.518, Middle Suzhou Rd., Taicang Economy Developing Area,  Taicang,
+				Suzhou  Jiangsu  215400
+				CN
+
+44-16-22   (hex)		Microsoft Corporation
+441622     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+44-E6-B0   (hex)		China Mobile IOT Company Limited
+44E6B0     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+74-7A-90   (hex)		Murata Manufacturing Co., Ltd.
+747A90     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+24-E9-CA   (hex)		Huawei Device Co., Ltd.
+24E9CA     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+14-00-7D   (hex)		zte corporation
+14007D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+94-AE-F0   (hex)		Cisco Systems, Inc
+94AEF0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+1C-08-C1   (hex)		LG Innotek
+1C08C1     (base 16)		LG Innotek
+				978-1 Jangduk dong, Gwangsangu
+				Gwangju  Gwangju  506-731
+				KR
+
+34-87-3D   (hex)		Quectel Wireless Solutions Co., Ltd.
+34873D     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				RM501,Building 13,No.99 TianZhou Road,Xuhui District,Shanghai,China
+				Shanghai  Shanghai  200233
+				CN
+
+9C-F6-1A   (hex)		Carrier Fire & Security
+9CF61A     (base 16)		Carrier Fire & Security
+				Kelvinstraat 7
+				DH Weert    6003
+				NL
+
+58-B6-23   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+58B623     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				Xiaomi Campus, No. 33 Xi erqi Middle Road, Haidian District
+				Beijing  Beijing  100085
+				CN
+
+A0-22-DE   (hex)		vivo Mobile Communication Co., Ltd.
+A022DE     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+FC-73-FB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC73FB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-45-62   (hex)		ANDRA Sp. z o. o.
+044562     (base 16)		ANDRA Sp. z o. o.
+				Pryzmaty 6/8
+				Warszawa    02-226
+				PL
+
+00-26-9E   (hex)		Quanta Computer Inc.
+00269E     (base 16)		Quanta Computer Inc.
+				NO. 211, WEN HWA 2RD., KUEI SHAN HSIANG, TAIPEI, SHIEN
+				TAO YUAN    333
+				TW
+
+C4-54-44   (hex)		Quanta Computer Inc.
+C45444     (base 16)		Quanta Computer Inc.
+				No.211, Wen Hwa 2nd Rd., Kuei Shan Hsiang, Tao Yuan Shien, Taiwan, R. O. C.
+				Taoyuan  Taiwan  33377
+				TW
+
+00-C0-9F   (hex)		Quanta Computer Inc.
+00C09F     (base 16)		Quanta Computer Inc.
+				7F., 116, HOU-KANG ST.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-1B-24   (hex)		Quanta Computer Inc.
+001B24     (base 16)		Quanta Computer Inc.
+				No. 211, Wen Hwa 2nd Rd.,
+				Kuei Shan Hsiang  Tao Yuan Shien  333
+				TW
+
+C8-0A-A9   (hex)		Quanta Computer Inc.
+C80AA9     (base 16)		Quanta Computer Inc.
+				211, Wen Hwa 2nd Rd.,
+				Tao Yuan  Kuei Shan  33377
+				TW
+
+60-EB-69   (hex)		Quanta Computer Inc.
+60EB69     (base 16)		Quanta Computer Inc.
+				211, Wen Hwa 2nd Rd.,Kuei Shan, 
+				Tao Yuan    33377
+				TW
+
+C0-8F-20   (hex)		Shenzhen Skyworth  Digital  Technology  CO., Ltd
+C08F20     (base 16)		Shenzhen Skyworth  Digital  Technology  CO., Ltd
+				4F,Block A, Skyworth?Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+74-F7-F6   (hex)		Shanghai Sunmi Technology Co.,Ltd.
+74F7F6     (base 16)		Shanghai Sunmi Technology Co.,Ltd.
+				Room 505, KIC Plaza, No.388 Song Hu Road, Yang Pu District, Shanghai, China
+				Shanghai  Yang Pu District  200433
+				CN
+
+C0-CC-42   (hex)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+C0CC42     (base 16)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+				No.198,First Section,Snow Mountain Avenue, Jinyuan Town, Dayi County
+				Chengdu  Sichuan  611330
+				CN
+
+24-1A-E6   (hex)		Huawei Device Co., Ltd.
+241AE6     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+60-B7-6E   (hex)		Google, Inc.
+60B76E     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+B4-23-30   (hex)		Itron Inc
+B42330     (base 16)		Itron Inc
+				2111 N Molter Rd
+				Liberty Lake  WA  99019
+				US
+
+08-4E-BF   (hex)		Sumitomo Electric Industries, Ltd
+084EBF     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+A8-02-DB   (hex)		zte corporation
+A802DB     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+1C-5D-80   (hex)		Mitubishi Hitachi Power Systems Industries Co., Ltd.
+1C5D80     (base 16)		Mitubishi Hitachi Power Systems Industries Co., Ltd.
+				Nakaku Aioimachi
+				Yokohama    2310012
+				JP
+
+80-16-05   (hex)		Vodafone Italia S.p.A.
+801605     (base 16)		Vodafone Italia S.p.A.
+				Via Lorenteggio nr. 240
+				Milan  Italy  20147
+				IT
+
+3C-9C-0F   (hex)		Intel Corporate
+3C9C0F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+5C-44-3E   (hex)		Skullcandy
+5C443E     (base 16)		Skullcandy
+				6301 N. Landmark Dr. 
+				Park City  UT  84098
+				US
+
+F8-82-00   (hex)		CaptionCall
+F88200     (base 16)		CaptionCall
+				4215 Riverboat Road
+				Salt Lake City  UT  84123
+				US
+
+08-FB-EA   (hex)		AMPAK Technology,Inc.
+08FBEA     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+34-0F-66   (hex)		Web Sensing LLC
+340F66     (base 16)		Web Sensing LLC
+				P.O. Box 692
+				Hanover  NH  03755
+				US
+
+58-65-E6   (hex)		infomark
+5865E6     (base 16)		infomark
+				#801, KINS TOWER, JEONGJA-DONG
+				SEONGNAM  GYOUNGGI  463-847
+				KR
+
+00-50-F1   (hex)		Maxlinear, Inc
+0050F1     (base 16)		Maxlinear, Inc
+				94 Em-Hamoshavot Way.
+				Petach-Tikva    
+				IL
+
+F4-E5-78   (hex)		LLC Proizvodstvennaya Kompania TransService
+F4E578     (base 16)		LLC Proizvodstvennaya Kompania TransService
+				Ulitsa Podolskih Kursantov,  build. 3, of. 133
+				Moscow  Moscow  117545
+				RU
+
+08-54-BB   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+0854BB     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+60-EB-5A   (hex)		Asterfusion Data Technologies Co.,Ltd
+60EB5A     (base 16)		Asterfusion Data Technologies Co.,Ltd
+				B401, Building 2, Creative Industry Park, No.328 Xinghu Street, SIP, Suzhou
+				suzhou    215123
+				CN
+
+E4-D3-73   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4D373     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-BC-9A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C0BC9A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-2C-09   (hex)		Nintendo Co.,Ltd
+702C09     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+90-12-A1   (hex)		We Corporation Inc.
+9012A1     (base 16)		We Corporation Inc.
+				201, 33, Deokcheon-ro, Manan-gu
+				Anyang-si  Gyeonggi-do  14088
+				KR
+
+64-B6-23   (hex)		CCS Care Communication Solutions GmbH
+64B623     (base 16)		CCS Care Communication Solutions GmbH
+				Computerstrasse 6
+				Vienna    1100
+				AT
+
+B8-80-35   (hex)		Shenzhen Qihu Intelligent Technology Company Limited
+B88035     (base 16)		Shenzhen Qihu Intelligent Technology Company Limited
+				Room 201, Block A, No.1, Qianwan Road 1,Qianhai Shenzhen HongKong Modern Service Industry Cooperation Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+B4-C2-6A   (hex)		Garmin International
+B4C26A     (base 16)		Garmin International
+				1200 E. 151st St
+				Olathe  KS  66062
+				US
+
+9C-FF-C2   (hex)		AVI Systems GmbH
+9CFFC2     (base 16)		AVI Systems GmbH
+				Dr. Franz Wilhelmstraße 2A
+				Krems a. d. Donau    3500
+				AT
+
+44-D8-78   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+44D878     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+A0-D8-07   (hex)		Huawei Device Co., Ltd.
+A0D807     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+2C-78-0E   (hex)		Huawei Device Co., Ltd.
+2C780E     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+34-B2-0A   (hex)		Huawei Device Co., Ltd.
+34B20A     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+98-F4-AB   (hex)		Espressif Inc.
+98F4AB     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+D8-BF-C0   (hex)		Espressif Inc.
+D8BFC0     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+20-26-81   (hex)		TECNO MOBILE LIMITED
+202681     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+F4-D6-20   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+F4D620     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+64-FB-92   (hex)		PPC Broadband Inc.
+64FB92     (base 16)		PPC Broadband Inc.
+				6176 E Molloy Rd
+				East Syracuse  NY  13057
+				US
+
+14-13-46   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+141346     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+94-90-34   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+949034     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+98-7A-10   (hex)		Ericsson AB
+987A10     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+54-2B-DE   (hex)		New H3C Technologies Co., Ltd
+542BDE     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+98-F7-81   (hex)		ARRIS Group, Inc.
+98F781     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+78-97-C3   (hex)		DINGXIN INFORMATION TECHNOLOGY CO.,LTD
+7897C3     (base 16)		DINGXIN INFORMATION TECHNOLOGY CO.,LTD
+				No.6 huasui Road,ZhuJiang Xincheng
+				Guangzhou  Guangdong  510623
+				CN
+
+4C-90-DB   (hex)		JL Audio
+4C90DB     (base 16)		JL Audio
+				10369 N Commerce Pkwy
+				Mirimar  FL  33025
+				US
+
+B8-99-AE   (hex)		Shenzhen MiaoMing  Intelligent Technology Co.,Ltd
+B899AE     (base 16)		Shenzhen MiaoMing  Intelligent Technology Co.,Ltd
+				Chudong science and technology park, 111 shaxin road, tangxia town,
+				dongguan city  guangdong province  523710
+				CN
+
+E8-D0-B9   (hex)		Taicang T&W Electronics
+E8D0B9     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+3C-8F-06   (hex)		Shenzhen Libtor Technology Co.,Ltd
+3C8F06     (base 16)		Shenzhen Libtor Technology Co.,Ltd
+				Room 608, Building A
+				Shenzhen City  Guangdong Province  518000
+				CN
+
+B0-08-75   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B00875     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+8C-F1-12   (hex)		Motorola Mobility LLC, a Lenovo Company
+8CF112     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+84-76-37   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+847637     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+FC-94-35   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC9435     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E0-24-81   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E02481     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-C0-EA   (hex)		Pepwave Limited
+A8C0EA     (base 16)		Pepwave Limited
+				A5, 5/F, HK Spinners Industrial Building, Phase 6, 481 Castle Peak Road
+				Cheung Sha Wan  Hong Kong  0
+				HK
+
+18-2A-D3   (hex)		Juniper Networks
+182AD3     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+80-B0-7B   (hex)		zte corporation
+80B07B     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C8-5A-9F   (hex)		zte corporation
+C85A9F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-AE-AB   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+44AEAB     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+A4-F0-5E   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A4F05E     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+1C-68-7E   (hex)		Shenzhen Qihu Intelligent Technology Company Limited
+1C687E     (base 16)		Shenzhen Qihu Intelligent Technology Company Limited
+				Room 201, Block A, No.1, Qianwan Road 1,Qianhai Shenzhen HongKong Modern Service Industry Cooperation Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+C0-36-56   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+C03656     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+58-85-A2   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+5885A2     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+2C-F8-9B   (hex)		Cisco Systems, Inc
+2CF89B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-1C   (hex)		AT&T
+00071C     (base 16)		AT&T
+				3300 E Renner Road
+				Richardson  TX  75082
+				US
+
+E0-E8-E6   (hex)		Shenzhen C-Data Technology Co., Ltd.
+E0E8E6     (base 16)		Shenzhen C-Data Technology Co., Ltd.
+				#601, Fl6, Bldg F, No.1008  Yangguang Community, Xili, Nanshan
+				Shenzhen  Guangdong  518055
+				CN
+
+50-02-91   (hex)		Espressif Inc.
+500291     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+00-1D-DF   (hex)		Sunitec Enterprise Co.,Ltd
+001DDF     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F., No. 98-1, Mincyuan Rd.
+				Sindian City  Taipei County  231
+				TW
+
+8C-0F-FA   (hex)		Hutec co.,ltd
+8C0FFA     (base 16)		Hutec co.,ltd
+				46, Gunpocheomdansaneop 2-ro
+				Gunpo-si  Gyeonggi-do  15880
+				KR
+
+AC-FE-05   (hex)		ITEL MOBILE LIMITED
+ACFE05     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+78-2A-79   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+782A79     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+78-65-59   (hex)		Sagemcom Broadband SAS
+786559     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+50-D2-F5   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+50D2F5     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+24-52-6A   (hex)		Zhejiang Dahua Technology Co., Ltd.
+24526A     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+20-DF-B9   (hex)		Google, Inc.
+20DFB9     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+5C-CA-D3   (hex)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+5CCAD3     (base 16)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+				9F,BLOCK A,GARDEN CITY DIGITAL BUILDING,NO.1079 NANHAI ROAD,NANSHAN DISTRICT
+				SHEN ZHEN  GUANG DONG  518000
+				CN
+
+28-16-7F   (hex)		Xiaomi Communications Co Ltd
+28167F     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+B0-3E-51   (hex)		BSkyB Ltd
+B03E51     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+5C-E8-83   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CE883     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-01-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+100177     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-A1-91   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+44A191     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-23-A4   (hex)		Sichuan AI-Link Technology Co., Ltd.
+6023A4     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+A4-53-0E   (hex)		Cisco Systems, Inc
+A4530E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-40-3A   (hex)		IMPACT TECHNOLOGIES
+00403A     (base 16)		IMPACT TECHNOLOGIES
+				6 RUE DE L'ACADIE
+				    
+				FR
+
+F8-87-F1   (hex)		Apple, Inc.
+F887F1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-28-BF   (hex)		Continental Automotive Czech Republic s.r.o.
+9C28BF     (base 16)		Continental Automotive Czech Republic s.r.o.
+				Průmyslová 1851
+				Brandýs nad Labem    250 01
+				CZ
+
+80-72-15   (hex)		BSkyB Ltd
+807215     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+74-D6-37   (hex)		Amazon Technologies Inc.
+74D637     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+D0-5F-64   (hex)		IEEE Registration Authority
+D05F64     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+BC-C3-1B   (hex)		Kygo Life A
+BCC31B     (base 16)		Kygo Life A
+				Sjolyst Plass 3
+				Oslo    0278
+				NO
+
+64-DF-10   (hex)		JingLue Semiconductor(SH) Ltd.
+64DF10     (base 16)		JingLue Semiconductor(SH) Ltd.
+				No.800 Naxian Rd
+				Shanghai    201210
+				CN
+
+C4-63-FB   (hex)		Neatframe AS
+C463FB     (base 16)		Neatframe AS
+				Martin Linges Vei 25
+				Fornebu  Fornebu  1364
+				NO
+
+0C-81-26   (hex)		Juniper Networks
+0C8126     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+30-57-14   (hex)		Apple, Inc.
+305714     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-44-7A   (hex)		Water-i.d. GmbH
+60447A     (base 16)		Water-i.d. GmbH
+				Daimlerstr. 20
+				Eggenstein    76344
+				DE
+
+C8-B1-CD   (hex)		Apple, Inc.
+C8B1CD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-60-CB   (hex)		Apple, Inc.
+1460CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-F1-2A   (hex)		Apple, Inc.
+B8F12A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-AB-6A   (hex)		Chun-il Co.,Ltd.
+04AB6A     (base 16)		Chun-il Co.,Ltd.
+				13-7, Gimhae-daero 2694 beon-gil,
+				Gimhae-si  Gyeongsangnam-do  50936
+				KR
+
+54-4E-45   (hex)		Private
+544E45     (base 16)		Private
+
+04-C8-07   (hex)		Xiaomi Communications Co Ltd
+04C807     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+04-A2-22   (hex)		Arcadyan Corporation
+04A222     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+48-9B-D5   (hex)		Extreme Networks, Inc.
+489BD5     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+3C-8C-93   (hex)		Juniper Networks
+3C8C93     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+28-FE-65   (hex)		DongGuan Siyoto Electronics Co., Ltd       
+28FE65     (base 16)		DongGuan Siyoto Electronics Co., Ltd       
+				Hecheng Industrial District, QiaoTou Town
+				DongGuan City  Guangdong  523520
+				CN
+
+18-06-F5   (hex)		RAD Data Communications, Ltd.
+1806F5     (base 16)		RAD Data Communications, Ltd.
+				24 Raoul Wallenberg St.
+				Tel Aviv    69719
+				IL
+
+74-84-E1   (hex)		Dongguan Haoyuan Electronics Co.,Ltd
+7484E1     (base 16)		Dongguan Haoyuan Electronics Co.,Ltd
+				NO.161 Kejizhong RoadLiuwu Shijie Town
+				Dongguan  Guangdong  523290
+				CN
+
+44-FB-5A   (hex)		zte corporation
+44FB5A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-59-E3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4459E3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+DC-54-D7   (hex)		Amazon Technologies Inc.
+DC54D7     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+44-D3-CA   (hex)		Cisco Systems, Inc
+44D3CA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+88-9F-AA   (hex)		Hella Gutmann Solutions GmbH 
+889FAA     (base 16)		Hella Gutmann Solutions GmbH 
+				Am Krebsbach 2
+				Ihringen   Baden Württemberg  79241
+				DE
+
+E4-54-E8   (hex)		Dell Inc.
+E454E8     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+20-96-8A   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+20968A     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+8C-18-50   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+8C1850     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Hangzhou  310000
+				CN
+
+D8-D4-E6   (hex)		Hytec Inter Co., Ltd.
+D8D4E6     (base 16)		Hytec Inter Co., Ltd.
+				3-28-6 Yoyogi
+				Shibuya-ku  Tokyo  1510053
+				JP
+
+68-3F-1E   (hex)		EFFECT Photonics B.V.
+683F1E     (base 16)		EFFECT Photonics B.V.
+				Kastanjelaan 400
+				Eindhoven  Noord-Brabant  5616 LZ
+				NL
+
+00-35-FF   (hex)		Texas Instruments
+0035FF     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F8-E7-A0   (hex)		vivo Mobile Communication Co., Ltd.
+F8E7A0     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+2C-FF-EE   (hex)		vivo Mobile Communication Co., Ltd.
+2CFFEE     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+84-0B-7C   (hex)		Hitron Technologies. Inc
+840B7C     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+48-A7-3C   (hex)		Sichuan tianyi kanghe communications co., LTD
+48A73C     (base 16)		Sichuan tianyi kanghe communications co., LTD
+				No.198, section 1, xueshan avenue, jinyuan town, dayi county
+				chengdu  sichuan  611330
+				CN
+
+C8-5D-38   (hex)		HUMAX Co., Ltd.
+C85D38     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+F8-A7-63   (hex)		Zhejiang Tmall Technology Co., Ltd.
+F8A763     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+A4-98-13   (hex)		ARRIS Group, Inc.
+A49813     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+6C-29-90   (hex)		WiZ Connected Lighting Company Limited
+6C2990     (base 16)		WiZ Connected Lighting Company Limited
+				Room 3805, 148 Electric Road
+				Hong Kong  0000  0000
+				HK
+
+98-35-ED   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9835ED     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+08-4F-0A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+084F0A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-49-4D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A8494D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-00-4D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+44004D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-CF-24   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+18CF24     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D8-9B-3B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D89B3B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+88-40-3B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88403B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+FC-87-43   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC8743     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+80-76-93   (hex)		Newag SA
+807693     (base 16)		Newag SA
+				Wyspianskiego 3
+				Nowy Sacz  woj. Malopolskie  33-300
+				PL
+
+BC-97-40   (hex)		IEEE Registration Authority
+BC9740     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+04-88-5F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04885F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+C8-50-CE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C850CE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+50-F8-A5   (hex)		eWBM Co., Ltd.
+50F8A5     (base 16)		eWBM Co., Ltd.
+				14F, 9, Teheran-ro 20-gil
+				Gangnam-gu, Seoul    06236
+				KR
+
+14-49-BC   (hex)		DrayTek Corp.
+1449BC     (base 16)		DrayTek Corp.
+				No. 26, Fushing Rd., Hukou, Hsinchu Industrial Park,
+				Hsinchu county    30352
+				TW
+
+20-F4-78   (hex)		Xiaomi Communications Co Ltd
+20F478     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+90-73-5A   (hex)		Motorola Mobility LLC, a Lenovo Company
+90735A     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+1C-82-59   (hex)		IEEE Registration Authority
+1C8259     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-04-DF   (hex)		TERACOM TELEMATICA S.A
+0004DF     (base 16)		TERACOM TELEMATICA S.A
+				RUA AMERICA N.1000
+				Eldorado do Sul - RS    Brazil
+				BR
+
+74-38-B7   (hex)		CANON INC.
+7438B7     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+8C-04-BA   (hex)		Dell Inc.
+8C04BA     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-FA-21   (hex)		Samsung Electronics Co.,Ltd
+00FA21     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-23-02   (hex)		Samsung Electronics Co.,Ltd
+7C2302     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-B6-F7   (hex)		NEW POS TECHNOLOGY LIMITED
+18B6F7     (base 16)		NEW POS TECHNOLOGY LIMITED
+				AB Unit, 14th Floor,Block A, Financial Technology Building.No. 11 Keyuan Rd
+				Shenzhen    518057
+				CN
+
+5C-B1-5F   (hex)		Oceanblue Cloud Technology Limited
+5CB15F     (base 16)		Oceanblue Cloud Technology Limited
+				253-261 Hennessy Road
+				Hong Kong  Hong Kong  999077
+				HK
+
+18-AA-CA   (hex)		Sichuan tianyi kanghe communications co., LTD
+18AACA     (base 16)		Sichuan tianyi kanghe communications co., LTD
+				No.198, section 1, xueshan avenue, jinyuan town, dayi county, sichuan province
+				chengdu  sichuan  611330
+				CN
+
+D4-9D-C0   (hex)		Samsung Electronics Co.,Ltd
+D49DC0     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+D0-19-6A   (hex)		Ciena Corporation
+D0196A     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+44-13-D0   (hex)		zte corporation
+4413D0     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+24-62-AB   (hex)		Espressif Inc.
+2462AB     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+88-B4-36   (hex)		Private
+88B436     (base 16)		Private
+
+6C-AB-05   (hex)		Cisco Systems, Inc
+6CAB05     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-E4   (hex)		Hosiden Corporation
+000BE4     (base 16)		Hosiden Corporation
+				4-33
+				Yao-city  Osaka  581-0071
+				JP
+
+60-D2-48   (hex)		ARRIS Group, Inc.
+60D248     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+48-5D-EB   (hex)		Just Add Power
+485DEB     (base 16)		Just Add Power
+				12505 STARKEY RD STE A
+				LARGO  FL  33773
+				US
+
+50-13-95   (hex)		Sichuan AI-Link Technology Co., Ltd.
+501395     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+18-D9-EF   (hex)		Shuttle Inc.
+18D9EF     (base 16)		Shuttle Inc.
+				No. 30 Lane 76, Rei Kuang Rd
+				Taipei    114
+				TW
+
+88-DA-33   (hex)		Beijing Xiaoyuer Network Technology Co., Ltd
+88DA33     (base 16)		Beijing Xiaoyuer Network Technology Co., Ltd
+				Block K1, North American International Business Centre, 86 Beiyuan Road, Chaoyang District
+				Beijing  Beijing  100012
+				CN
+
+84-C7-8F   (hex)		STORDIS GmbH
+84C78F     (base 16)		STORDIS GmbH
+				Rosenwiesstr. 17
+				Stuttgart    70567
+				DE
+
+50-41-B9   (hex)		I-O DATA DEVICE,INC.
+5041B9     (base 16)		I-O DATA DEVICE,INC.
+				3-10,Sakurada-machi
+				Kanazawa  Ishikawa  920-8512
+				JP
+
+80-DA-BC   (hex)		Megafone Limited
+80DABC     (base 16)		Megafone Limited
+				Unit 702,7/F,Bankok Bank Building,NO.18 Bonham Strand West
+				Hong Kong    999077
+				HK
+
+C0-9F-E1   (hex)		zte corporation
+C09FE1     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+18-46-44   (hex)		Home Control Singapore Pte Ltd
+184644     (base 16)		Home Control Singapore Pte Ltd
+				151 Lorong Chuan
+				Singapore    556741
+				SG
+
+B0-70-0D   (hex)		Nokia
+B0700D     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+34-6B-5B   (hex)		New H3C Technologies Co., Ltd
+346B5B     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+84-E8-92   (hex)		Actiontec Electronics, Inc
+84E892     (base 16)		Actiontec Electronics, Inc
+				301 Olcott St
+				Santa Clara  CA  95054
+				US
+
+78-E2-BD   (hex)		Vodafone Automotive S.p.A.
+78E2BD     (base 16)		Vodafone Automotive S.p.A.
+				via Astico 41
+				Varese  Italy/VA  21100
+				IT
+
+F8-48-FD   (hex)		China Mobile Group Device Co.,Ltd.
+F848FD     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+20-DA-22   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20DA22     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-21-DA   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+C821DA     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+E0-B6-55   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+E0B655     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+00-21-75   (hex)		Pacific Satellite International Ltd.
+002175     (base 16)		Pacific Satellite International Ltd.
+				20/F Tai Tung Building,
+				Wanchai    100000
+				HK
+
+88-97-46   (hex)		Sichuan AI-Link Technology Co., Ltd.
+889746     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+1C-DE-57   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+1CDE57     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E0-DC-FF   (hex)		Xiaomi Communications Co Ltd
+E0DCFF     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+60-8C-DF   (hex)		Private
+608CDF     (base 16)		Private
+
+00-77-8D   (hex)		Cisco Systems, Inc
+00778D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-8C   (hex)		Siemens AG
+000E8C     (base 16)		Siemens AG
+				Siemensstraße 10
+				Regensburg    93055
+				DE
+
+00-87-64   (hex)		Cisco Systems, Inc
+008764     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+FC-33-42   (hex)		Juniper Networks
+FC3342     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C4-68-D0   (hex)		VTech Telecommunications Ltd.
+C468D0     (base 16)		VTech Telecommunications Ltd.
+				23/F, Tai Ping Industrial Centre, Block 1,
+				HONG KONG  NA  000000
+				HK
+
+14-AE-DB   (hex)		VTech Telecommunications Ltd.
+14AEDB     (base 16)		VTech Telecommunications Ltd.
+				23/F, Tai Ping Industrial Centre, Block 1,
+				HONG KONG  NA  000000
+				HK
+
+78-DB-2F   (hex)		Texas Instruments
+78DB2F     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+8C-0F-A0   (hex)		di-soric GmbH & Co. KG
+8C0FA0     (base 16)		di-soric GmbH & Co. KG
+				Steinbeisstrasse 6
+				Urbach    73660
+				DE
+
+DC-B8-08   (hex)		Extreme Networks, Inc.
+DCB808     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+B0-E7-1D   (hex)		Shanghai Maigantech Co.,Ltd
+B0E71D     (base 16)		Shanghai Maigantech Co.,Ltd
+				Room 2211,No.88 Caoxi North Rd,Xuhui District
+				Shanghai  Shanghai  200030
+				CN
+
+F8-BB-BF   (hex)		eero inc.
+F8BBBF     (base 16)		eero inc.
+				500 Howard St Suite 900
+				San Francisco  CA  94105
+				US
+
+84-6F-CE   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+846FCE     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+20-65-8E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20658E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-3D-5E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+183D5E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+DC-71-37   (hex)		zte corporation
+DC7137     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+84-7C-9B   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+847C9B     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+34-41-A8   (hex)		ER-Telecom
+3441A8     (base 16)		ER-Telecom
+				Ovchinnikovskaya embankment, 20, Building 1 
+				Moscow    115324
+				RU
+
+34-DB-9C   (hex)		Sagemcom Broadband SAS
+34DB9C     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+74-40-BE   (hex)		LG Innotek
+7440BE     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+04-D4-C4   (hex)		ASUSTek COMPUTER INC.
+04D4C4     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+F0-D4-E2   (hex)		Dell Inc.
+F0D4E2     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+A8-E2-C3   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+A8E2C3     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+90-20-C2   (hex)		Aruba, a Hewlett Packard Enterprise Company
+9020C2     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+0C-A0-6C   (hex)		Industrial Cyber Sensing Inc.
+0CA06C     (base 16)		Industrial Cyber Sensing Inc.
+				Unit 1A - 343 Montrose Street North
+				Cambridge  Ontario  N3H 2H6
+				CA
+
+FC-D2-B6   (hex)		IEEE Registration Authority
+FCD2B6     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-4A-14   (hex)		Apple, Inc.
+804A14     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-3C-69   (hex)		Apple, Inc.
+703C69     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-2D-A9   (hex)		TECNO MOBILE LIMITED
+AC2DA9     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+FC-B6-62   (hex)		IC Holdings LLC
+FCB662     (base 16)		IC Holdings LLC
+				9066 S 300 W
+				Sandy  UT  84070
+				US
+
+48-04-9F   (hex)		ELECOM CO., LTD
+48049F     (base 16)		ELECOM CO., LTD
+				9FLand Axis Tower.1-1 fushimi machi,4-chome chuoku
+				osaka    5418765
+				JP
+
+08-7F-98   (hex)		vivo Mobile Communication Co., Ltd.
+087F98     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+C8-52-61   (hex)		ARRIS Group, Inc.
+C85261     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C0-41-21   (hex)		Nokia
+C04121     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+74-88-BB   (hex)		Cisco Systems, Inc
+7488BB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-CF-12   (hex)		Espressif Inc.
+A4CF12     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+4C-6A-F6   (hex)		HMD Global Oy
+4C6AF6     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+48-9D-D1   (hex)		Samsung Electronics Co.,Ltd
+489DD1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-6F-E0   (hex)		Samsung Electronics Co.,Ltd
+B06FE0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-B9-94   (hex)		Douglas Lighting Controls
+44B994     (base 16)		Douglas Lighting Controls
+				280 - 3605 Gilmore Way
+				Burnaby  BC  V5G4X5
+				CA
+
+40-A9-3F   (hex)		Pivotal Commware, Inc.
+40A93F     (base 16)		Pivotal Commware, Inc.
+				1555 132nd Ave. NE
+				Bellevue  WA  98005
+				US
+
+70-BF-92   (hex)		GN Audio A/S
+70BF92     (base 16)		GN Audio A/S
+				Lautrupbjerg 7
+				Ballerup    DK-2750
+				DK
+
+C0-8C-71   (hex)		Motorola Mobility LLC, a Lenovo Company
+C08C71     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+F4-6F-4E   (hex)		Echowell
+F46F4E     (base 16)		Echowell
+				7F-8, No. 8, Sec 1, JunShing Rd.
+				New Taipei City    24872
+				TW
+
+2C-3F-0B   (hex)		Cisco Meraki
+2C3F0B     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+5C-88-16   (hex)		Rockwell Automation
+5C8816     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+00-2F-5C   (hex)		Cisco Systems, Inc
+002F5C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-64-5D   (hex)		Toshiba
+F4645D     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+38-F8-5E   (hex)		HUMAX Co., Ltd.
+38F85E     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+AC-BB-61   (hex)		YSTen Technology Co.,Ltd
+ACBB61     (base 16)		YSTen Technology Co.,Ltd
+				Room 1715,17/F North Star Times Tower,Chaoyang District,Beijing.
+				Beijing    100101
+				CN
+
+24-79-F8   (hex)		KUPSON spol. s r.o.
+2479F8     (base 16)		KUPSON spol. s r.o.
+				Hradecka 787/14
+				Opava  Czech Republic  74601
+				CZ
+
+7C-FD-82   (hex)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+7CFD82     (base 16)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+				No.168, Middle Road Of East Gate
+				Xiaobian Community  Chang'an Town  523851
+				CN
+
+18-0D-2C   (hex)		Intelbras
+180D2C     (base 16)		Intelbras
+				BR 101, km 210, S/N°
+				São José  Santa Catarina  88104800
+				BR
+
+04-2D-B4   (hex)		First Property (Beijing) Co., Ltd Modern MOMA Branch
+042DB4     (base 16)		First Property (Beijing) Co., Ltd Modern MOMA Branch
+				Room 301A，Building No.10, No.1 Xiangheyuan Road, Dongcheng District, Beijing City
+				Beijing  Beijing  100028
+				CN
+
+04-E0-B0   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+04E0B0     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+08-EC-F5   (hex)		Cisco Systems, Inc
+08ECF5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D0-76-50   (hex)		IEEE Registration Authority
+D07650     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+60-D0-A9   (hex)		Samsung Electronics Co.,Ltd
+60D0A9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-CE-FA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88CEFA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-27-06   (hex)		YOISYS
+002706     (base 16)		YOISYS
+				309-52 SUNGSU-2GA, 1DONG, SUNGDONG-GU
+				SEOUL    133-827
+				KR
+
+00-CB-51   (hex)		Sagemcom Broadband SAS
+00CB51     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+C4-64-B7   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+C464B7     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+EC-41-18   (hex)		XIAOMI Electronics,CO.,LTD
+EC4118     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+D8-86-0B   (hex)		IEEE Registration Authority
+D8860B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+34-20-03   (hex)		Shenzhen Feitengyun Technology Co.,LTD
+342003     (base 16)		Shenzhen Feitengyun Technology Co.,LTD
+				7F 4building,Yalianhaoshida industrial Park
+				Shenzhen  Guangdong  518100
+				CN
+
+F0-7D-68   (hex)		D-Link Corporation
+F07D68     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd Rd., Neihu District, 
+				Taipei City    114
+				TW
+
+40-E3-D6   (hex)		Aruba, a Hewlett Packard Enterprise Company
+40E3D6     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+B4-5D-50   (hex)		Aruba, a Hewlett Packard Enterprise Company
+B45D50     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+78-DA-A2   (hex)		Cynosure Technologies Co.,Ltd
+78DAA2     (base 16)		Cynosure Technologies Co.,Ltd
+				Room 2708/2710, Building No.9A, Shenzhen Bay Science and Technology Ecological Park，Nanshan 
+				Shenzhen city  Guangdong Province  518057
+				CN
+
+38-B1-9E   (hex)		IEEE Registration Authority
+38B19E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+38-E2-6E   (hex)		ShenZhen Sweet Rain Electronics Co.,Ltd.
+38E26E     (base 16)		ShenZhen Sweet Rain Electronics Co.,Ltd.
+				Xinghua Road
+				Shenzhen  Bao'an  518101
+				CN
+
+00-D0-50   (hex)		Iskratel d.o.o.
+00D050     (base 16)		Iskratel d.o.o.
+				Ljubljanska cesta 24a
+				Kranj    4000
+				SI
+
+70-C9-C6   (hex)		Cisco Systems, Inc
+70C9C6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-B9-2F   (hex)		Technicolor CH USA Inc.
+D4B92F     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+68-9A-87   (hex)		Amazon Technologies Inc.
+689A87     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+64-AE-88   (hex)		Polytec GmbH
+64AE88     (base 16)		Polytec GmbH
+				Polytec Platz 1-7
+				Waldbronn  BW  76337
+				DE
+
+AC-A3-1E   (hex)		Aruba, a Hewlett Packard Enterprise Company
+ACA31E     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-17-7B   (hex)		Azalea Networks inc
+00177B     (base 16)		Azalea Networks inc
+				673 S Milpitas Blvd
+				Milpitas  CA  95035
+				US
+
+98-DA-C4   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+98DAC4     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+50-2B-98   (hex)		Es-tech International
+502B98     (base 16)		Es-tech International
+				228-70, Saneop-ro 155beon-gil, Gwonseon-gu, Suwon-si, Gyeonggi-do, Korea
+				Suwon    16648
+				KR
+
+C8-28-32   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+C82832     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+94-6A-77   (hex)		Technicolor CH USA Inc.
+946A77     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+C4-34-6B   (hex)		Hewlett Packard
+C4346B     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+80-84-A9   (hex)		oshkosh Corporation
+8084A9     (base 16)		oshkosh Corporation
+				2307 Oregon Street
+				Oshkosh  WI  54902
+				US
+
+F4-6E-95   (hex)		Extreme Networks, Inc.
+F46E95     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose    95119
+				US
+
+4C-C7-D6   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+4CC7D6     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+C8-08-73   (hex)		Ruckus Wireless
+C80873     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+70-1B-FB   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+701BFB     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+04-76-6E   (hex)		ALPS ELECTRIC CO., LTD.
+04766E     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+AC-7A-4D   (hex)		ALPS ELECTRIC CO., LTD.
+AC7A4D     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				KAKUDA-CITY  MIYAGI-PREF  981-1595
+				JP
+
+00-1B-B5   (hex)		Cherry GmbH
+001BB5     (base 16)		Cherry GmbH
+				Cherrystraße 1
+				Auerbach i. d. Opf.  Bayern  D-91275
+				DE
+
+00-26-43   (hex)		ALPS ELECTRIC CO., LTD.
+002643     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+38-C0-96   (hex)		ALPS ELECTRIC CO., LTD.
+38C096     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				KAKUDA-CITY  MIYAGI-PREF  981-1595
+				JP
+
+D0-51-57   (hex)		LEAX Arkivator Telecom
+D05157     (base 16)		LEAX Arkivator Telecom
+				NanShan District YueHaiMen Street
+				ShenZhen  GuangDong  518061
+				CN
+
+28-80-88   (hex)		NETGEAR
+288088     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+64-CE-6E   (hex)		Sierra Wireless
+64CE6E     (base 16)		Sierra Wireless
+				13811 Wireless Way
+				Richmond  BC  V6V 3A4
+				CA
+
+1C-34-77   (hex)		Innovation Wireless
+1C3477     (base 16)		Innovation Wireless
+				11869 Teale Street
+				Culver City  CA  90230
+				US
+
+BC-3E-07   (hex)		Hitron Technologies. Inc
+BC3E07     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+48-FD-A3   (hex)		Xiaomi Communications Co Ltd
+48FDA3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-16-97   (hex)		NEC Corporation
+001697     (base 16)		NEC Corporation
+				7-1, Shiba 5-chome Minato-ku,
+				tokyo  Tokyo  108-8001
+				JP
+
+00-30-13   (hex)		NEC Corporation
+003013     (base 16)		NEC Corporation
+				1-10 Nisshincho, Fuchu
+				Tokyo 183-8501    0000
+				JP
+
+04-9D-FE   (hex)		Hivesystem
+049DFE     (base 16)		Hivesystem
+				816 Kranz-techno Bldg. 388 dunchondaero, jun
+				Gyeonggi-do    KSXX0024
+				KR
+
+0C-EC-84   (hex)		Shenzhen TINNO Mobile Technology Corp.
+0CEC84     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+9C-DB-07   (hex)		Thum+Mahr GmbH
+9CDB07     (base 16)		Thum+Mahr GmbH
+				Heinrich-Hertz-Strasse 1-3
+				Monheim am Rhein  NRW  40789
+				DE
+
+DC-EB-69   (hex)		Technicolor CH USA Inc.
+DCEB69     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+00-4E-35   (hex)		Hewlett Packard Enterprise
+004E35     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F8-13-08   (hex)		Nokia
+F81308     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+F8-A2-D6   (hex)		Liteon Technology Corporation
+F8A2D6     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+18-2A-44   (hex)		HIROSE ELECTRONIC SYSTEM
+182A44     (base 16)		HIROSE ELECTRONIC SYSTEM
+				1-9-6 Ebisuminami
+				Shibuya  Tokyo  150-0022
+				JP
+
+FC-94-CE   (hex)		zte corporation
+FC94CE     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+90-86-9B   (hex)		zte corporation
+90869B     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E0-18-9F   (hex)		EM Microelectronic
+E0189F     (base 16)		EM Microelectronic
+				Rue des Sors 3
+				Marin-Epagnier  Neuchatel  2074
+				CH
+
+74-36-6D   (hex)		Vodafone Italia S.p.A.
+74366D     (base 16)		Vodafone Italia S.p.A.
+				Via Lorenteggio nr. 240
+				Milan  Italy  20147
+				IT
+
+84-DB-2F   (hex)		Sierra Wireless
+84DB2F     (base 16)		Sierra Wireless
+				1381 Wireless Way
+				Richmond  BC  V6V 3A4
+				CA
+
+94-58-CB   (hex)		Nintendo Co.,Ltd
+9458CB     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+28-EC-9A   (hex)		Texas Instruments
+28EC9A     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+FC-BE-7B   (hex)		vivo Mobile Communication Co., Ltd.
+FCBE7B     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+B4-0F-B3   (hex)		vivo Mobile Communication Co., Ltd.
+B40FB3     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+EC-5C-68   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+EC5C68     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+C4-E5-06   (hex)		Piper Networks, Inc.
+C4E506     (base 16)		Piper Networks, Inc.
+				3636 Nobel Drive
+				San Diego  CA  92122
+				US
+
+30-EB-5A   (hex)		LANDIS + GYR
+30EB5A     (base 16)		LANDIS + GYR
+				78th km Old National Road Athens-Corinth 
+				Corinth     20100
+				GR
+
+F8-0F-6F   (hex)		Cisco Systems, Inc
+F80F6F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-80-E3   (hex)		CORAL NETWORK CORPORATION
+0080E3     (base 16)		CORAL NETWORK CORPORATION
+				(NOW BAY NETWORKS)
+				SANTA CLARA  CA  95052-8185
+				US
+
+B4-C6-2E   (hex)		Molex CMS
+B4C62E     (base 16)		Molex CMS
+				2222 Wellington Court
+				Lisle  IL  60532
+				US
+
+B8-25-9A   (hex)		Thalmic Labs 
+B8259A     (base 16)		Thalmic Labs 
+				24 Charles Street West 
+				Kitchener   Ontario   N2G 1H2
+				CA
+
+28-25-36   (hex)		SHENZHEN HOLATEK CO.,LTD
+282536     (base 16)		SHENZHEN HOLATEK CO.,LTD
+				Rm.1001,Unit 4,Bld.B,Kexing Science Park,Keyuan Road, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+B8-A1-75   (hex)		Roku, Inc.
+B8A175     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga  CA  95070
+				US
+
+CC-D3-C1   (hex)		Vestel Elektronik San ve Tic. A.Ş.
+CCD3C1     (base 16)		Vestel Elektronik San ve Tic. A.Ş.
+				Organize san
+				Manisa  Turket  45030
+				TR
+
+0C-D0-F8   (hex)		Cisco Systems, Inc
+0CD0F8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-5F-90   (hex)		LAM Technologies
+745F90     (base 16)		LAM Technologies
+				Viale Ludovico Ariosto, 492/D
+				Sesto Fiorentino  FIRENZE  50019
+				IT
+
+A4-26-55   (hex)		LTI Motion (Shanghai) Co., Ltd.
+A42655     (base 16)		LTI Motion (Shanghai) Co., Ltd.
+				NO.80, Lane 2927, LaiYang Road Pudong New District
+				Shanghai  Shanghai  200137
+				CN
+
+60-A7-30   (hex)		Shenzhen Yipinfang Internet Technology Co.,Ltd
+60A730     (base 16)		Shenzhen Yipinfang Internet Technology Co.,Ltd
+				Shenzhen Konka R & D Building, 28th floor 21
+				GuangDong  Nanshan District  518000
+				CN
+
+3C-9B-D6   (hex)		Vizio, Inc
+3C9BD6     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+F8-5B-9C   (hex)		SB SYSTEMS Co.,Ltd
+F85B9C     (base 16)		SB SYSTEMS Co.,Ltd
+				2F Ventureforum, 323, Pangyo-ro, Bundang-gu
+				Seongnam-si  Gyeonngi-do  453-400
+				KR
+
+6C-A9-28   (hex)		HMD Global Oy
+6CA928     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+00-D8-61   (hex)		Micro-Star INTL CO., LTD.
+00D861     (base 16)		Micro-Star INTL CO., LTD.
+				No.69, Lide St.,
+				New Taipei City  Taiwan  235
+				TW
+
+74-C1-7D   (hex)		Infinix mobility limited
+74C17D     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+88-71-B1   (hex)		ARRIS Group, Inc.
+8871B1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F0-AF-85   (hex)		ARRIS Group, Inc.
+F0AF85     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-AE-34   (hex)		ARRIS Group, Inc.
+FCAE34     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+DC-DA-80   (hex)		New H3C Technologies Co., Ltd
+DCDA80     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+CC-72-86   (hex)		Xi'an Fengyu Information Technology Co., Ltd.
+CC7286     (base 16)		Xi'an Fengyu Information Technology Co., Ltd.
+				5F, Block A, STRC, No.10, Zhangba 5th Road, Yanta
+				Xi'an  Shaanxi  710077
+				CN
+
+64-EE-B7   (hex)		Netcore Technology Inc
+64EEB7     (base 16)		Netcore Technology Inc
+				Building 6, Baolong Plant, Able Technology Park, Longgang District, 
+				Shenzhen    518116
+				CN
+
+38-81-D7   (hex)		Texas Instruments
+3881D7     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+18-04-ED   (hex)		Texas Instruments
+1804ED     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D4-32-60   (hex)		GoPro
+D43260     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+50-DB-3F   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+50DB3F     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+10-81-B4   (hex)		Hunan Greatwall Galaxy Science and Technology Co.,Ltd.
+1081B4     (base 16)		Hunan Greatwall Galaxy Science and Technology Co.,Ltd.
+				No. 39, Jian Shan Road
+				Changsha  Hunan  410205
+				CN
+
+00-42-79   (hex)		Sunitec Enterprise Co.,Ltd
+004279     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+00-B8-B3   (hex)		Cisco Systems, Inc
+00B8B3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-DD-9E   (hex)		GoPro
+F4DD9E     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+D4-D9-19   (hex)		GoPro
+D4D919     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+14-11-14   (hex)		TECNO MOBILE LIMITED
+141114     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+A4-50-46   (hex)		Xiaomi Communications Co Ltd
+A45046     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+1C-24-CD   (hex)		Askey Computer Corp.
+1C24CD     (base 16)		Askey Computer Corp.
+				10F, No.119, JIANKANG RD.,ZHINGHE DIST,
+				NEW TAIPEI CITY    23585
+				TW
+
+00-7C-2D   (hex)		Samsung Electronics Co.,Ltd
+007C2D     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+B4-77-48   (hex)		Shenzhen Neoway Technology Co.,Ltd.
+B47748     (base 16)		Shenzhen Neoway Technology Co.,Ltd.
+				4F-2#,Lian Jian Science & Industry Park,Huarong Road,Dalang Street,Longhua District
+				Shenzhen  Guangdong  518000
+				CN
+
+F8-50-1C   (hex)		Tianjin Geneuo Technology Co.,Ltd
+F8501C     (base 16)		Tianjin Geneuo Technology Co.,Ltd
+				Technology Avenue South JingHai Economic Development Area,Tianjin China
+				Tianjin    301609
+				CN
+
+44-07-0B   (hex)		Google, Inc.
+44070B     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+F8-C2-49   (hex)		Private
+F8C249     (base 16)		Private
+
+B8-31-B5   (hex)		Microsoft Corporation
+B831B5     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+EC-F6-BD   (hex)		SNCF MOBILITÉS
+ECF6BD     (base 16)		SNCF MOBILITÉS
+				9 rue Jean-Philippe Rameau 
+				SAINT-DENIS    93200
+				FR
+
+38-B4-D3   (hex)		BSH Hausgeraete GmbH
+38B4D3     (base 16)		BSH Hausgeraete GmbH
+				Im Gewerbepark B10
+				Regensburg    93059
+				DE
+
+C8-47-82   (hex)		Areson Technology Corp.
+C84782     (base 16)		Areson Technology Corp.
+				11F., No. 646, Sec. 5, Chongxin Rd., Sanchong District
+				New Taipei City    24158
+				TW
+
+E8-93-63   (hex)		Nokia
+E89363     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+7C-0C-F6   (hex)		Guangdong Huiwei High-tech Co., Ltd.
+7C0CF6     (base 16)		Guangdong Huiwei High-tech Co., Ltd.
+				E Block No. 1 in Ecological Area in Puzhai NewArea
+				Fengshun County, Meizhou  Guangdong province  514000
+				CN
+
+74-9D-79   (hex)		Sercomm Corporation.
+749D79     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+00-D6-FE   (hex)		Cisco Systems, Inc
+00D6FE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+0C-BF-74   (hex)		Morse Micro
+0CBF74     (base 16)		Morse Micro
+				113 / 2-4 Cornwallis Street
+				Eveleigh  NSW  2015
+				AU
+
+FC-8F-7D   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+FC8F7D     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+24-BE-18   (hex)		DADOUTEK COMPANY LIMITED
+24BE18     (base 16)		DADOUTEK COMPANY LIMITED
+				14/F, Wilson Logistics Centre,No.24-28 Kung Yip St
+				Kwai Chung  New Territories  000
+				CN
+
+B4-1D-2B   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+B41D2B     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+14-C2-13   (hex)		Apple, Inc.
+14C213     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-D3-13   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70D313     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-1D-36   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C1D36     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-BB-FE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CCBBFE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-D9-31   (hex)		Apple, Inc.
+A4D931     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-FE-D9   (hex)		Apple, Inc.
+BCFED9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-82-23   (hex)		Apple, Inc.
+808223     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-0A-60   (hex)		IEEE Registration Authority
+300A60     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-D0-65   (hex)		CKS Corporation
+80D065     (base 16)		CKS Corporation
+				1-24-11 Akebono
+				Tachikawa  Tokyo  190-0012
+				JP
+
+28-31-66   (hex)		vivo Mobile Communication Co., Ltd.
+283166     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+C0-40-04   (hex)		Medicaroid Corporation
+C04004     (base 16)		Medicaroid Corporation
+				1-6-4, Minatojima-minamimachi, Chuo-ku
+				Kobe    650-0047
+				JP
+
+20-AD-56   (hex)		Continental Automotive Systems Inc.
+20AD56     (base 16)		Continental Automotive Systems Inc.
+				21440 W. Lake Cook Rd.
+				Deer Park  IL  60010
+				US
+
+50-29-F5   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+5029F5     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+CC-08-FB   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+CC08FB     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+BC-AF-91   (hex)		TE Connectivity Sensor Solutions
+BCAF91     (base 16)		TE Connectivity Sensor Solutions
+				4 rue Gaye-Marie, CS 83163
+				Toulouse    31027
+				FR
+
+F0-D7-DC   (hex)		Wesine (Wuhan) Technology Co., Ltd.
+F0D7DC     (base 16)		Wesine (Wuhan) Technology Co., Ltd.
+				10th Floor, Building 2, SBI Venture Street, Hongshan District
+				Wuhan  Hubei  430074
+				CN
+
+00-72-04   (hex)		Samsung Electronics Co., Ltd. ARTIK
+007204     (base 16)		Samsung Electronics Co., Ltd. ARTIK
+				1-1, Samsungjeonja-ro
+				Hwaseong-si  Gyeonggi-do  18448
+				KR
+
+40-C8-1F   (hex)		Shenzhen Xinguodu Technology Co., Ltd.
+40C81F     (base 16)		Shenzhen Xinguodu Technology Co., Ltd.
+				F17A, JinSong Building, Tairan Industrial & Trade Park, Chegongmiao, Shennan Road，Futian District
+				Shenzhen  Guangdong  518040
+				CN
+
+14-59-C0   (hex)		NETGEAR
+1459C0     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+8C-61-A3   (hex)		ARRIS Group, Inc.
+8C61A3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A8-10-87   (hex)		Texas Instruments
+A81087     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A0-28-33   (hex)		IEEE Registration Authority
+A02833     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C8-C2-F5   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+C8C2F5     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+F0-58-49   (hex)		CareView Communications
+F05849     (base 16)		CareView Communications
+				405 State HWY 121 BYP
+				Lewisville   Texas  75067
+				US
+
+34-E5-EC   (hex)		Palo Alto Networks
+34E5EC     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+A4-ED-43   (hex)		IEEE Registration Authority
+A4ED43     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-29-8D   (hex)		Shanghai AdaptComm Technology Co., Ltd.
+94298D     (base 16)		Shanghai AdaptComm Technology Co., Ltd.
+				3rd Floor, Building 14, No. 518 Xinzhuan Road, Songjiang District,
+				Shanghai    201600
+				CN
+
+00-AA-6E   (hex)		Cisco Systems, Inc
+00AA6E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+0C-7C-28   (hex)		Nokia
+0C7C28     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+68-43-D7   (hex)		Agilecom Photonics Solutions Guangdong Limited
+6843D7     (base 16)		Agilecom Photonics Solutions Guangdong Limited
+				No.1-6, Shenwan Industrial Park, Shenwan Town
+				Zhongshan  Guangdong  528462
+				CN
+
+20-D8-0B   (hex)		Juniper Networks
+20D80B     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+8C-8F-8B   (hex)		China Mobile Chongqing branch
+8C8F8B     (base 16)		China Mobile Chongqing branch
+				6 building, No. 2, Xingguang three road
+				Yubei District  Chongqing  401120
+				CN
+
+B8-6A-97   (hex)		Edgecore Networks Corporation
+B86A97     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+00-0A-5E   (hex)		3COM
+000A5E     (base 16)		3COM
+				5400 Bayfront Plaza
+				Santa Clara  CA  95052-8145
+				US
+
+00-10-5A   (hex)		3COM
+00105A     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-60-97   (hex)		3COM
+006097     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-60-08   (hex)		3COM
+006008     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-1B-6E   (hex)		Keysight Technologies, Inc.
+001B6E     (base 16)		Keysight Technologies, Inc.
+				1400 Fountaingrove Pkwy.
+				Santa Rosa  CA  95403
+				US
+
+00-04-0B   (hex)		3COM EUROPE LTD
+00040B     (base 16)		3COM EUROPE LTD
+				BOUNDARY WAY
+				vvvvv  UNITED  KINGDOM
+				GB
+
+00-01-02   (hex)		3COM
+000102     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+8C-FE-74   (hex)		Ruckus Wireless
+8CFE74     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+A8-01-6D   (hex)		Aiwa Corporation
+A8016D     (base 16)		Aiwa Corporation
+				965 W Chicago Ave
+				Chicago  IL  60642
+				US
+
+04-40-A9   (hex)		New H3C Technologies Co., Ltd
+0440A9     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+4C-01-43   (hex)		eero inc.
+4C0143     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+E4-34-93   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E43493     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-29-12   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+342912     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-4B-AA   (hex)		Magic Leap, Inc.
+604BAA     (base 16)		Magic Leap, Inc.
+				1855 Griffin Rd, Room B454
+				Dania Beach  FL  33004
+				US
+
+4C-36-4E   (hex)		Panasonic Corporation  Connected Solutions Company
+4C364E     (base 16)		Panasonic Corporation  Connected Solutions Company
+				4-1-62 Minoshima, Hakata-ku
+				Fukuoka-shi  Fukuoka  812-8531
+				JP
+
+BC-A5-8B   (hex)		Samsung Electronics Co.,Ltd
+BCA58B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-CE-B9   (hex)		Samsung Electronics Co.,Ltd
+80CEB9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-D3-FC   (hex)		Mios, Ltd.
+D0D3FC     (base 16)		Mios, Ltd.
+				645 W. 9th St.
+				Los Angeles  CA  90015
+				US
+
+6C-6C-D3   (hex)		Cisco Systems, Inc
+6C6CD3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-49-ED   (hex)		Audeze LLC
+E049ED     (base 16)		Audeze LLC
+				3410 S Susan st
+				Santa Ana  CA  92704
+				US
+
+80-30-E0   (hex)		Hewlett Packard Enterprise
+8030E0     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+E8-5D-86   (hex)		CHANG YOW TECHNOLOGIES INTERNATIONAL CO.,LTD.
+E85D86     (base 16)		CHANG YOW TECHNOLOGIES INTERNATIONAL CO.,LTD.
+				 No 88 Shuren 6th St Wufong District
+				Taichung    413
+				TW
+
+14-37-19   (hex)		PT Prakarsa Visi Valutama
+143719     (base 16)		PT Prakarsa Visi Valutama
+				Jl. Cideng Timur No.11D
+				Jakarta Pusat  Indonesia  10130
+				ID
+
+58-2F-40   (hex)		Nintendo Co.,Ltd
+582F40     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+08-90-BA   (hex)		Danlaw Inc
+0890BA     (base 16)		Danlaw Inc
+				23700 research Dr.
+				Farmington Hills    48335
+				US
+
+94-A3-CA   (hex)		KonnectONE, LLC
+94A3CA     (base 16)		KonnectONE, LLC
+				30 N Gould Street STE 4004
+				Sheridan  WY  82801
+				US
+
+24-4C-E3   (hex)		Amazon Technologies Inc.
+244CE3     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno    89507
+				US
+
+B8-BE-F4   (hex)		devolo AG
+B8BEF4     (base 16)		devolo AG
+				Charlottenburger Allee 67
+				Aachen  NRW  52068
+				DE
+
+00-01-57   (hex)		SYSWAVE CO., LTD
+000157     (base 16)		SYSWAVE CO., LTD
+				Dongho B/D 5F, 221-2
+				  KOREA  135-010
+				KR
+
+58-FD-BE   (hex)		Shenzhen Taikaida Technology Co., Ltd
+58FDBE     (base 16)		Shenzhen Taikaida Technology Co., Ltd
+				Shenzhen Baoan District Fuyong town Fengtang road Xintian building 613
+				shenzhen    518102
+				CN
+
+F4-F1-97   (hex)		EMTAKE Inc
+F4F197     (base 16)		EMTAKE Inc
+				14, Pangyoyeok ro 192, Bundang gu
+				Seongnam city  Kyeonggi do  13524
+				KR
+
+6C-ED-51   (hex)		NEXCONTROL Co.,Ltd
+6CED51     (base 16)		NEXCONTROL Co.,Ltd
+				(#303-1007, Ssangyong 3th) 397, Seokcheon-ro
+				Bucheon-si  Gyeonggi-do  14449
+				KR
+
+04-C3-E6   (hex)		IEEE Registration Authority
+04C3E6     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+28-63-36   (hex)		Siemens AG
+286336     (base 16)		Siemens AG
+				Werner-von-Siemens Strasse 50
+				Amberg    92224
+				DE
+
+14-D1-69   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14D169     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-62-E5   (hex)		Hewlett Packard
+1062E5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+00-20-B5   (hex)		YASKAWA ELECTRIC CORPORATION
+0020B5     (base 16)		YASKAWA ELECTRIC CORPORATION
+				2-1 Kurosakishiroishi, Yahatanishi-ku,
+				Kitakyushu    806-0004
+				JP
+
+E0-62-67   (hex)		Xiaomi Communications Co Ltd
+E06267     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+70-B7-AA   (hex)		vivo Mobile Communication Co., Ltd.
+70B7AA     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+84-B3-1B   (hex)		Kinexon GmbH
+84B31B     (base 16)		Kinexon GmbH
+				Schellingstrasse, 35
+				München    80799
+				DE
+
+08-25-25   (hex)		Xiaomi Communications Co Ltd
+082525     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C4-95-00   (hex)		Amazon Technologies Inc.
+C49500     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+F4-60-E2   (hex)		Xiaomi Communications Co Ltd
+F460E2     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+E4-D1-24   (hex)		 Mojo Networks, Inc.
+E4D124     (base 16)		 Mojo Networks, Inc.
+				339 N.Bernardo Ave
+				Mountain View  CA  94043
+				US
+
+00-13-A3   (hex)		Siemens Home & Office Comm. Devices
+0013A3     (base 16)		Siemens Home & Office Comm. Devices
+				4849 Alpha Road
+				Dallas    75244
+				US
+
+B0-B8-67   (hex)		Hewlett Packard Enterprise
+B0B867     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+C0-03-80   (hex)		Juniper Networks
+C00380     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+98-BB-99   (hex)		Phicomm (Sichuan) Co.,Ltd.
+98BB99     (base 16)		Phicomm (Sichuan) Co.,Ltd.
+				125 longquan street park road,longquan district,chengdu city
+				Sichuan  Chengdu  610015
+				CN
+
+00-26-22   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+002622     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+F8-27-2E   (hex)		Mercku
+F8272E     (base 16)		Mercku
+				509 Beaver Creek Rd.
+				Waterloo  Ontario  N2V 2L3
+				CA
+
+9C-C9-50   (hex)		Baumer Holding
+9CC950     (base 16)		Baumer Holding
+				Hummelstrasse 17
+				Frauenfeld  Thurgau  8501
+				CH
+
+F8-99-10   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+F89910     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+50-E0-EF   (hex)		Nokia
+50E0EF     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+84-8A-8D   (hex)		Cisco Systems, Inc
+848A8D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+1C-C3-EB   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1CC3EB     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+50-4C-7E   (hex)		THE 41ST INSTITUTE OF CETC
+504C7E     (base 16)		THE 41ST INSTITUTE OF CETC
+				No.98 Xiangjiang Road,Huangdao District,Qingdao,Shandong
+				Qingdao  Shangdong  266555
+				CN
+
+00-14-13   (hex)		Trebing & Himstedt Prozeßautomation GmbH & Co. KG
+001413     (base 16)		Trebing & Himstedt Prozeßautomation GmbH & Co. KG
+				Wilhelm Hennemann Straße 13
+				Schwerin  Mecklenburg-Vorpommern  19061
+				DE
+
+00-07-99   (hex)		Tipping Point Technologies, Inc.
+000799     (base 16)		Tipping Point Technologies, Inc.
+				7501 B N. Capital of TX Hwy.
+				Austin  TX  78731
+				US
+
+D0-1C-BB   (hex)		Beijing Ctimes Digital Technology Co., Ltd.
+D01CBB     (base 16)		Beijing Ctimes Digital Technology Co., Ltd.
+				7th Floor, Jinzhou Building, Suzhou Street, No.79, Haidian District, 
+				Beijing    100089
+				CN
+
+74-87-BB   (hex)		Ciena Corporation
+7487BB     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+68-DD-26   (hex)		Shanghai Focus Vision Security Technology Co.,Ltd
+68DD26     (base 16)		Shanghai Focus Vision Security Technology Co.,Ltd
+				No.4888 Hunan Rd, Pudong New District
+				Shanghai  Shanghai  201317
+				CN
+
+28-66-E3   (hex)		AzureWave Technology Inc.
+2866E3     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+60-F1-8A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60F18A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-38-73   (hex)		Juniper Networks
+EC3873     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+78-04-73   (hex)		Texas Instruments
+780473     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A8-3E-0E   (hex)		HMD Global Oy
+A83E0E     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+10-C1-72   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+10C172     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-15-1E   (hex)		ETHERNET Powerlink Standarization Group (EPSG)
+00151E     (base 16)		ETHERNET Powerlink Standarization Group (EPSG)
+				c/o Zurich University of Applied Sciences
+				Winterthur    CH-8401
+				CH
+
+00-11-1E   (hex)		ETHERNET Powerlink Standarization Group (EPSG)
+00111E     (base 16)		ETHERNET Powerlink Standarization Group (EPSG)
+				c/o University of Applied Sciences
+				Winterthur  ZH  CH-8401
+				CH
+
+00-40-9D   (hex)		DigiBoard
+00409D     (base 16)		DigiBoard
+				6400 FLYING CLOUD DRIVE
+				EDEN PRAIRIE  MN  55344
+				US
+
+CC-50-E3   (hex)		Espressif Inc.
+CC50E3     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+DC-E3-05   (hex)		   ZAO NPK Rotek
+DCE305     (base 16)		   ZAO NPK Rotek
+				Prospekt Mira
+				Moscow    129223
+				RU
+
+A4-DA-32   (hex)		Texas Instruments
+A4DA32     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-0E-EE   (hex)		Muco Industrie BV
+000EEE     (base 16)		Muco Industrie BV
+				Pleimuiden 12e
+				Amsterdam  NH  1046 AG
+				NL
+
+7C-1C-4E   (hex)		LG Innotek
+7C1C4E     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+D8-B6-B7   (hex)		Comtrend Corporation
+D8B6B7     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+00-21-06   (hex)		RIM Testing Services
+002106     (base 16)		RIM Testing Services
+				440 Phillip Street
+				Waterloo  ON  N2L 5R9
+				CA
+
+8C-14-B4   (hex)		zte corporation
+8C14B4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+3C-98-72   (hex)		Sercomm Corporation.
+3C9872     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+40-C3-C6   (hex)		SnapRoute
+40C3C6     (base 16)		SnapRoute
+				3960 Freedom Circle, Suite 100
+				Santa Clara  CA  95054
+				US
+
+5C-96-56   (hex)		AzureWave Technology Inc.
+5C9656     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+E0-60-66   (hex)		Sercomm Corporation.
+E06066     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+14-93-46   (hex)		PNI sensor corporation
+149346     (base 16)		PNI sensor corporation
+				2331 Circadian Way
+				Santa Rosa  CA  95407
+				US
+
+DC-E0-EB   (hex)		Nanjing Aozheng Information Technology Co.Ltd
+DCE0EB     (base 16)		Nanjing Aozheng Information Technology Co.Ltd
+				#E1-453, Zidong Road #1,Qixia District
+				Nanjing  jiangsu  210000
+				CN
+
+EC-8C-9A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC8C9A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-86-55   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B48655     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-47-59   (hex)		Beijing MEGA preponderance Science & Technology Co. Ltd
+2C4759     (base 16)		Beijing MEGA preponderance Science & Technology Co. Ltd
+				Room 2201,No.8,Ruichuang International B Block,Wangjing East Road
+				Beijing    100102
+				CN
+
+A4-15-66   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+A41566     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Wei fang Export processing Zone
+				Wei Fang  Shan Dong  261205
+				CN
+
+1C-96-5A   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+1C965A     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road,Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Wei Fang  Shan Dong  261205
+				CN
+
+40-1B-5F   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+401B5F     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road,Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+A8-E5-52   (hex)		JUWEL Aquarium AG & Co. KG
+A8E552     (base 16)		JUWEL Aquarium AG & Co. KG
+				Karl-Göx-Straße 1
+				Rotenburg / Wümme    27356
+				DE
+
+5C-CD-7C   (hex)		MEIZU Technology Co.,Ltd.
+5CCD7C     (base 16)		MEIZU Technology Co.,Ltd.
+				MEIZU Tech Bldg., Technology& Innovation Coast
+				Zhuhai  Guangdong  519085
+				CN
+
+00-13-8A   (hex)		Qingdao GoerTek Technology Co., Ltd.
+00138A     (base 16)		Qingdao GoerTek Technology Co., Ltd.
+				Room 605,Innovation Building,Hi-tech Industrial Park,
+				QINGDAO  SHANDONG  266061
+				CN
+
+A8-30-AD   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+A830AD     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Wei fang Export processing Zone
+				Wei Fang  Shan Dong  261205
+				CN
+
+BC-5F-F6   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+BC5FF6     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-E7-D8   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+C8E7D8     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr., Building 28, Cui Xi Fourth Road，Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+60-D2-1C   (hex)		Sunnovo International Limited
+60D21C     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+CC-51-B4   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+CC51B4     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+00-C3-F4   (hex)		Samsung Electronics Co.,Ltd
+00C3F4     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+B8-8A-EC   (hex)		Nintendo Co.,Ltd
+B88AEC     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+D0-D7-83   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D0D783     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-3B-77   (hex)		Sagemcom Broadband SAS
+AC3B77     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+B0-FC-0D   (hex)		Amazon Technologies Inc.
+B0FC0D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+CC-C9-2C   (hex)		Schindler - PORT Technology
+CCC92C     (base 16)		Schindler - PORT Technology
+				via della Pace 22
+				Locarno  Ticino  6600
+				CH
+
+00-1E-39   (hex)		Comsys Communication Ltd.
+001E39     (base 16)		Comsys Communication Ltd.
+				9 Hamenofim st.
+				Herzelia    46725
+				IL
+
+78-72-5D   (hex)		Cisco Systems, Inc
+78725D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+FC-E6-6A   (hex)		Industrial Software Co
+FCE66A     (base 16)		Industrial Software Co
+				85, Aleksandyr Malinov Blvd. Office 6
+				Sofia    1715
+				BG
+
+78-36-CC   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+7836CC     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+8C-CF-5C   (hex)		BEFEGA GmbH
+8CCF5C     (base 16)		BEFEGA GmbH
+				Reichenbacher Str. 22
+				Schwabach  Bavaria  91126
+				DE
+
+70-C8-33   (hex)		Wirepas Oy
+70C833     (base 16)		Wirepas Oy
+				Visiokatu 4
+				Tampere    33720
+				FI
+
+0C-73-EB   (hex)		IEEE Registration Authority
+0C73EB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+04-8A-E1   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+048AE1     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+F0-B5-D1   (hex)		Texas Instruments
+F0B5D1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-E0-00   (hex)		FUJITSU LIMITED
+00E000     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+90-84-8B   (hex)		HDR10+ Technologies, LLC
+90848B     (base 16)		HDR10+ Technologies, LLC
+				3855 SW 153rd Drive
+				Beaverton  OR  97006
+				US
+
+C8-D7-79   (hex)		QING DAO HAIER TELECOM CO.,LTD.
+C8D779     (base 16)		QING DAO HAIER TELECOM CO.,LTD.
+				No 1  Haier road,Hi-tech Zone，Qingdao，PR.China
+				Qingdao  Shandong  266101
+				CN
+
+10-B3-6F   (hex)		Bowei Technology Company Limited 
+10B36F     (base 16)		Bowei Technology Company Limited 
+				2F,Building No.6C,1658,Gumei Rd
+				Shanghai  Shanghai  200233
+				CN
+
+FC-9B-C6   (hex)		Sumavision Technologies Co.,Ltd
+FC9BC6     (base 16)		Sumavision Technologies Co.,Ltd
+				6F, Block A2, Power Creative Building,No.1 Shangdi East Road, Haidian District
+				Beijing    100085
+				CN
+
+C8-29-2A   (hex)		Barun Electronics
+C8292A     (base 16)		Barun Electronics
+				869, Jangji-ri, Dongtan-myeon
+				Hwaseong-si  Gyeonggi-do  445812
+				KR
+
+E4-82-CC   (hex)		Jumptronic GmbH
+E482CC     (base 16)		Jumptronic GmbH
+				An der Weide 5
+				Springe    31832
+				DE
+
+48-60-5F   (hex)		LG Electronics (Mobile Communications)
+48605F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+B0-41-6F   (hex)		Shenzhen Maxtang Computer Co.,Ltd
+B0416F     (base 16)		Shenzhen Maxtang Computer Co.,Ltd
+				6/F, Bldg.3, Honghui Industrial Park, Liuxian 2nd Rd., Bao'an Dist.
+				Shenzhen  Guangdong  518101
+				CN
+
+50-1D-93   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+501D93     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-16-A8   (hex)		Microsoft Corporation
+2816A8     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+F8-F5-32   (hex)		ARRIS Group, Inc.
+F8F532     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+B0-83-D6   (hex)		ARRIS Group, Inc.
+B083D6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+80-C7-C5   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+80C7C5     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E4-43-4B   (hex)		Dell Inc.
+E4434B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+0C-F5-A4   (hex)		Cisco Systems, Inc
+0CF5A4     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+9C-2E-A1   (hex)		Xiaomi Communications Co Ltd
+9C2EA1     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+08-97-34   (hex)		Hewlett Packard Enterprise
+089734     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F0-9C-D7   (hex)		Guangzhou Blue Cheetah Intelligent Technology Co., Ltd.
+F09CD7     (base 16)		Guangzhou Blue Cheetah Intelligent Technology Co., Ltd.
+				Panyu District, Guangzhou City Panyu Avenue North 555 Panyu Energy Technology Park,Industry Building 2 seats 406-407
+				Guangzhou  Guangdong   511400
+				CN
+
+BC-E1-43   (hex)		Apple, Inc.
+BCE143     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-70-33   (hex)		Apple, Inc.
+647033     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-68-78   (hex)		Apple, Inc.
+846878     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-D0-83   (hex)		Apple, Inc.
+C8D083     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-6A-BC   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+0C6ABC     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+00-80-BA   (hex)		SPECIALIX (ASIA) PTE, LTD
+0080BA     (base 16)		SPECIALIX (ASIA) PTE, LTD
+				3 WINTERSELLS ROAD
+				  UNITED  KINGDOM
+				US
+
+48-0B-B2   (hex)		IEEE Registration Authority
+480BB2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+CC-C0-79   (hex)		Murata Manufacturing Co., Ltd.
+CCC079     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+E0-19-D8   (hex)		BH TECHNOLOGIES
+E019D8     (base 16)		BH TECHNOLOGIES
+				12 RUE AMPERE
+				GRENOBLE    38000
+				FR
+
+60-30-D4   (hex)		Apple, Inc.
+6030D4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-95-EA   (hex)		Apple, Inc.
+F895EA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-F1-D8   (hex)		Apple, Inc.
+18F1D8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-CD-5D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3CCD5D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-76-68   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C7668     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+6C-38-38   (hex)		Marking System Technology Co., Ltd.
+6C3838     (base 16)		Marking System Technology Co., Ltd.
+				76-1, Hirakawa Yokomichi
+				Joyo-shi  Kyoto  610-0101
+				JP
+
+30-D9-D9   (hex)		Apple, Inc.
+30D9D9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-0F-77   (hex)		HangZhou Gubei Electronics Technology Co.,Ltd
+780F77     (base 16)		HangZhou Gubei Electronics Technology Co.,Ltd
+				HangZhou City, Zhejiang province Binjiang District Jiang Hong Road 611 Building 1 room 106
+				Hangzhou  ZheJiang  310052
+				CN
+
+A4-38-CC   (hex)		Nintendo Co.,Ltd
+A438CC     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+74-72-1E   (hex)		Edison Labs Inc.
+74721E     (base 16)		Edison Labs Inc.
+				1122 Stanyan St
+				San Francisco  CA  94117
+				US
+
+8C-4C-DC   (hex)		PLANEX COMMUNICATIONS INC.
+8C4CDC     (base 16)		PLANEX COMMUNICATIONS INC.
+				Planex Volta Bldg., 2-11-9 Ebisu-Nishi,Shibuya-ku,Tokyo 150-0021,Japan
+				Tokyo  Tokyo  150-0021
+				JP
+
+50-65-F3   (hex)		Hewlett Packard
+5065F3     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+3C-95-09   (hex)		Liteon Technology Corporation
+3C9509     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+BC-AB-7C   (hex)		TRnP KOREA Co Ltd
+BCAB7C     (base 16)		TRnP KOREA Co Ltd
+				room1308,239 SoHyungRo,WonMiGu,
+				BuChunCity  KyungKiDo  1135
+				KR
+
+64-CB-5D   (hex)		SIA TeleSet
+64CB5D     (base 16)		SIA TeleSet
+				Krāslavas iela 5
+				Vecstropi, Naujenes par., Daugavpils distr.    LV-5413
+				LV
+
+58-21-E9   (hex)		TWPI
+5821E9     (base 16)		TWPI
+				PMB# 335; 1121 Annapolis Road
+				Odenton  MD  21113
+				US
+
+C4-9F-4C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C49F4C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-70-4A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C704A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F0-E3-DC   (hex)		Tecon MT, LLC
+F0E3DC     (base 16)		Tecon MT, LLC
+				3rd Khoroshevskaya st - 20
+				Moscow    123298
+				RU
+
+A8-DA-01   (hex)		Shenzhen NUOLIJIA Digital Technology Co.,Ltd
+A8DA01     (base 16)		Shenzhen NUOLIJIA Digital Technology Co.,Ltd
+				A Area of The Second Flood and D Area of The First Floor,Factory Building A,Youxinda Industrial Park,Gengyu Road,Tianliao Community,Gongming Street Office,Guangming New District,Shenzhen City,Guangdong,P.R.China
+				Shenzhen  Guangdong  518000
+				CN
+
+7C-25-86   (hex)		Juniper Networks
+7C2586     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F0-41-C8   (hex)		IEEE Registration Authority
+F041C8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+CC-99-16   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+CC9916     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+EC-7F-C6   (hex)		ECCEL CORPORATION SAS
+EC7FC6     (base 16)		ECCEL CORPORATION SAS
+				CRA 106 15A 25 LT 88 MZ 17 BG 1, ZONA FRANCA BOGOTA
+				BOGOTA  D.C.  110921
+				CO
+
+4C-AB-FC   (hex)		zte corporation
+4CABFC     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-10-D8   (hex)		CALISTA
+0010D8     (base 16)		CALISTA
+				56A Packhorse Road
+				Bucks SL9 8EF  ENGLAND  
+				GB
+
+00-21-94   (hex)		Ping Communication
+002194     (base 16)		Ping Communication
+				Brenden 18
+				Appenzell Meistersrüte  AI  9050
+				CH
+
+5C-5A-EA   (hex)		FORD
+5C5AEA     (base 16)		FORD
+				17425 Federal Drive 
+				Allen Park  MI  48101
+				US
+
+00-0B-7B   (hex)		Test-Um Inc.
+000B7B     (base 16)		Test-Um Inc.
+				808 Calle Plano
+				Camarillo  CA  93012
+				US
+
+30-FD-38   (hex)		Google, Inc.
+30FD38     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+00-13-86   (hex)		ABB Inc/Totalflow
+001386     (base 16)		ABB Inc/Totalflow
+				123
+				Bartlesville  OK  74006
+				US
+
+00-3C-10   (hex)		Cisco Systems, Inc
+003C10     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+54-A6-5C   (hex)		Technicolor CH USA Inc.
+54A65C     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+BC-DD-C2   (hex)		Espressif Inc.
+BCDDC2     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+98-D8-63   (hex)		Shanghai High-Flying Electronics Technology Co., Ltd
+98D863     (base 16)		Shanghai High-Flying Electronics Technology Co., Ltd
+				Room 1002 ,#1Building,No.3000 Longdong Avenue,Pudong District,Shanghai,China
+				shanghai  shanghai  201203
+				CN
+
+0C-F3-46   (hex)		Xiaomi Communications Co Ltd
+0CF346     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+7C-FF-4D   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+7CFF4D     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+C8-8F-26   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+C88F26     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+70-3A-73   (hex)		Shenzhen Sundray Technologies Company Limited
+703A73     (base 16)		Shenzhen Sundray Technologies Company Limited
+				6th Floor,Block A1, Nanshan iPark, No.1001 XueYuan Road, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+10-F9-EB   (hex)		Industria Fueguina de Relojería Electrónica s.a.
+10F9EB     (base 16)		Industria Fueguina de Relojería Electrónica s.a.
+				Sarmiento 2920
+				Rio Grande  Tierra de Fuego  V9420GIV
+				AR
+
+80-AD-16   (hex)		Xiaomi Communications Co Ltd
+80AD16     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+04-4E-AF   (hex)		LG Innotek
+044EAF     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+18-94-C6   (hex)		ShenZhen Chenyee Technology Co., Ltd.
+1894C6     (base 16)		ShenZhen Chenyee Technology Co., Ltd.
+				32F, Tower A, East Pacific International Center, No.7888, Shennan Avenue, Futian District
+				Shenzhen    518040
+				CN
+
+40-BD-32   (hex)		Texas Instruments
+40BD32     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+CC-8E-71   (hex)		Cisco Systems, Inc
+CC8E71     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-F5-54   (hex)		HISENSE ELECTRIC CO.,LTD
+38F554     (base 16)		HISENSE ELECTRIC CO.,LTD
+				No. 218, Qianwangang Rd
+				Qingdao  Shandong  266555
+				CN
+
+88-E9-0F   (hex)		innomdlelab
+88E90F     (base 16)		innomdlelab
+				Unnam 1 gil, 3 
+				Seocho-gu  Seoul  06778
+				KR
+
+00-30-74   (hex)		EQUIINET LTD.
+003074     (base 16)		EQUIINET LTD.
+				EDISON HOUSE
+				 SWINDON, SN3 5JA    
+				GB
+
+EC-9B-8B   (hex)		Hewlett Packard Enterprise
+EC9B8B     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+B0-B3-AD   (hex)		HUMAX Co., Ltd.
+B0B3AD     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+18-A2-8A   (hex)		Essel-T Co., Ltd
+18A28A     (base 16)		Essel-T Co., Ltd
+				1211 kranztechno, 388 Dunchon-daero
+				Seongnam-si  Jungwon-gu, Gyeonggi-do  13403
+				KR
+
+20-36-5B   (hex)		Megafone Limited
+20365B     (base 16)		Megafone Limited
+				Unit 702,7/F,Bankok Bank Building,NO.18 Bonham Strand West
+				Hong Kong    999077
+				HK
+
+E8-DE-00   (hex)		ChongQing GuanFang Technology Co.,LTD
+E8DE00     (base 16)		ChongQing GuanFang Technology Co.,LTD
+				2F, A District,No.3 Middle Section of Mount Huangshan Avenue
+				ChongQing  ChongQing  401121
+				CN
+
+70-C9-4E   (hex)		Liteon Technology Corporation
+70C94E     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+70-D0-81   (hex)		Beijing Netpower Technologies Inc.
+70D081     (base 16)		Beijing Netpower Technologies Inc.
+				Room 201, Block B, NO. 15 Building, EastZone
+				Courtyard10, Xibeiwang East Road  Haidian District, Beijing  100094
+				CN
+
+FC-64-3A   (hex)		Samsung Electronics Co.,Ltd
+FC643A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-51-5B   (hex)		Samsung Electronics Co.,Ltd
+A8515B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-B7-E5   (hex)		Rayson Technology Co., Ltd.
+54B7E5     (base 16)		Rayson Technology Co., Ltd.
+				1F No.9 R&D Rd.II, Science-Based Industrial Park
+				Hsin-Chu    300
+				TW
+
+94-63-72   (hex)		vivo Mobile Communication Co., Ltd.
+946372     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+BC-0F-A7   (hex)		Ouster
+BC0FA7     (base 16)		Ouster
+				350 Treat Ave
+				San Francisco  CA  94110
+				US
+
+F8-C1-20   (hex)		Xi'an Link-Science Technology Co.,Ltd
+F8C120     (base 16)		Xi'an Link-Science Technology Co.,Ltd
+				1/F，Block F,Building zhichao Weilai,No.999,10#Caotan Road,Xi'an
+				xi'an    710016
+				CN
+
+F0-C9-D1   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+F0C9D1     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+34-7E-5C   (hex)		Sonos, Inc.
+347E5C     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+B4-FB-F9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B4FBF9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-6F-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+506F77     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-41-E9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C41E9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-E8-24   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3CE824     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-5A-06   (hex)		SHARP Corporation
+345A06     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+00-19-36   (hex)		STERLITE OPTICAL TECHNOLOGIES LIMITED
+001936     (base 16)		STERLITE OPTICAL TECHNOLOGIES LIMITED
+				E-1,E-2,&E-3
+				AURANGABAD  MAHARASTRA  431136
+				IN
+
+B8-9F-09   (hex)		Wistron Neweb Corporation
+B89F09     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+04-02-CA   (hex)		Shenzhen Vtsonic Co.,ltd
+0402CA     (base 16)		Shenzhen Vtsonic Co.,ltd
+				No.35,the 2nd Industrial Zone,Tangxiayong Village,Songgang Town,Bao'an District,Shenzhen,China.
+				Shenzhen  Guangdong  518102
+				CN
+
+3C-FB-5C   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+3CFB5C     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+74-40-BB   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+7440BB     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+1C-11-61   (hex)		Ciena Corporation
+1C1161     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+B4-DE-31   (hex)		Cisco Systems, Inc
+B4DE31     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-40-27   (hex)		zte corporation
+A44027     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B4-F7-A1   (hex)		LG Electronics (Mobile Communications)
+B4F7A1     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+28-ED-E0   (hex)		AMPAK Technology, Inc.
+28EDE0     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+88-BD-45   (hex)		Samsung Electronics Co.,Ltd
+88BD45     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-FC-F0   (hex)		Samsung Electronics Co.,Ltd
+54FCF0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-6A-85   (hex)		Samsung Electronics Co.,Ltd
+306A85     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+4C-DD-31   (hex)		Samsung Electronics Co.,Ltd
+4CDD31     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-B6-EE   (hex)		Dish Technologies Corp
+88B6EE     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+70-F2-20   (hex)		Actiontec Electronics, Inc
+70F220     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+D0-81-7A   (hex)		Apple, Inc.
+D0817A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-CA-33   (hex)		Apple, Inc.
+98CA33     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-AB-1E   (hex)		Apple, Inc.
+68AB1E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-EF-00   (hex)		Apple, Inc.
+70EF00     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-77-65   (hex)		Tiesse SpA
+C87765     (base 16)		Tiesse SpA
+				Via Asti
+				Ivrea  TO  10015
+				IT
+
+2C-37-C5   (hex)		Qingdao Haier Intelligent Home Appliance Technology Co.,Ltd
+2C37C5     (base 16)		Qingdao Haier Intelligent Home Appliance Technology Co.,Ltd
+				ingdao high-tech park haier road 1
+				Qingdao  Shandong  266101
+				CN
+
+CC-40-D0   (hex)		NETGEAR
+CC40D0     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+7C-76-30   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+7C7630     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+98-22-EF   (hex)		Liteon Technology Corporation
+9822EF     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+78-80-38   (hex)		FUNAI ELECTRIC CO., LTD.
+788038     (base 16)		FUNAI ELECTRIC CO., LTD.
+				7-1, NAKAGAITO 7-CHOME
+				DAITO  OSAKA  5740013
+				JP
+
+BC-FF-EB   (hex)		Motorola Mobility LLC, a Lenovo Company
+BCFFEB     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+00-01-30   (hex)		Extreme Networks, Inc.
+000130     (base 16)		Extreme Networks, Inc.
+				3585 Monroe Street
+				Santa Clara  CA  95051
+				US
+
+FC-0A-81   (hex)		Extreme Networks, Inc.
+FC0A81     (base 16)		Extreme Networks, Inc.
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+F0-45-DA   (hex)		Texas Instruments
+F045DA     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B8-07-16   (hex)		vivo Mobile Communication Co., Ltd.
+B80716     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+A8-EE-C6   (hex)		Muuselabs NV/SA
+A8EEC6     (base 16)		Muuselabs NV/SA
+				Rue du Tocsin 12
+				Brussels    1000
+				BE
+
+E4-F0-42   (hex)		Google, Inc.
+E4F042     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+40-48-FD   (hex)		IEEE Registration Authority
+4048FD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+20-B3-99   (hex)		Enterasys
+20B399     (base 16)		Enterasys
+				50 Minuteman Rd
+				Andover  MA  01810
+				US
+
+CC-2D-21   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+CC2D21     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+00-40-97   (hex)		DATEX DIVISION OF
+004097     (base 16)		DATEX DIVISION OF
+				INSTRUMENTARIUM CORP.
+				    
+				FI
+
+9C-4F-CF   (hex)		TCT mobile ltd
+9C4FCF     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+D8-96-E0   (hex)		Alibaba Cloud Computing Ltd.
+D896E0     (base 16)		Alibaba Cloud Computing Ltd.
+				Yuhang District of Hangzhou Wenyi Road, Building 1, No. 969 Xixi Park, Zhejiang Province
+				Hangzhou  Zhejiang  310000
+				CN
+
+00-18-62   (hex)		Seagate Technology
+001862     (base 16)		Seagate Technology
+				1280 Disc Drive
+				Shakopee  MN  55379
+				US
+
+1C-EE-C9   (hex)		Elo touch solutions
+1CEEC9     (base 16)		Elo touch solutions
+				1033 McCarthy Boulevard
+				Milpitas  CA  95035
+				US
+
+00-0C-50   (hex)		Seagate Technology
+000C50     (base 16)		Seagate Technology
+				M/S NW1F01
+				Longmont  CO  80503
+				US
+
+34-2A-F1   (hex)		Texas Instruments
+342AF1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+20-78-52   (hex)		Nokia
+207852     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+C8-DE-C9   (hex)		Coriant
+C8DEC9     (base 16)		Coriant
+				1415 W. Diehl Rd
+				Naperville  IL  60563
+				US
+
+44-D5-A5   (hex)		AddOn Computer
+44D5A5     (base 16)		AddOn Computer
+				15775 Gateway cir
+				tustin  CA  92780
+				US
+
+38-F7-3D   (hex)		Amazon Technologies Inc.
+38F73D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+C0-A0-0D   (hex)		ARRIS Group, Inc.
+C0A00D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+0C-61-11   (hex)		Anda Technologies SAC
+0C6111     (base 16)		Anda Technologies SAC
+				Av. Santa Cruz 888, Miraflores
+				Lima  Peru  Lima18
+				PE
+
+00-22-C4   (hex)		epro GmbH
+0022C4     (base 16)		epro GmbH
+				Joebkesweg 3
+				Gronau  NRW  48599
+				DE
+
+1C-33-0E   (hex)		PernixData
+1C330E     (base 16)		PernixData
+				1745 Technology Drive, Suite 800
+				San Jose  CA  95110
+				US
+
+B8-F7-4A   (hex)		RCNTEC
+B8F74A     (base 16)		RCNTEC
+				Polkovaya street 3
+				Moscow    127018
+				RU
+
+64-51-06   (hex)		Hewlett Packard
+645106     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+0C-15-39   (hex)		Apple, Inc.
+0C1539     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-56-97   (hex)		Amazon Technologies Inc.
+6C5697     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-05-FF   (hex)		SNS Solutions, Inc.
+0005FF     (base 16)		SNS Solutions, Inc.
+				2nd Fl. Hill House,
+				    
+				KR
+
+F8-7B-20   (hex)		Cisco Systems, Inc
+F87B20     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-AA-DB   (hex)		Nanjing PANENG Technology Development Co.,Ltd
+E0AADB     (base 16)		Nanjing PANENG Technology Development Co.,Ltd
+				NO.6 Paneng Road,Nanjing High-tech Zone,Jiang Su,China
+				Nanjing     210061
+				CN
+
+EC-F4-51   (hex)		Arcadyan Corporation
+ECF451     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+58-12-43   (hex)		AcSiP Technology Corp.
+581243     (base 16)		AcSiP Technology Corp.
+				3F., No.22, Dalin Rd.,
+				Taoyuan  Taoyuan County  33067
+				TW
+
+A8-9F-EC   (hex)		ARRIS Group, Inc.
+A89FEC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-BE-9E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+00BE9E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+54-C5-7A   (hex)		Sunnovo International Limited
+54C57A     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+58-C1-7A   (hex)		Cambium Networks Limited
+58C17A     (base 16)		Cambium Networks Limited
+				Unit B2, Linhay Business Park,
+				Ashburton  Devon  TQ13 7UP
+				GB
+
+38-01-9F   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+38019F     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+24-5C-CB   (hex)		AXIe Consortium, Inc.
+245CCB     (base 16)		AXIe Consortium, Inc.
+				P.O. Box 1016
+				Niwot  CO  80544-1016
+				US
+
+60-9B-C8   (hex)		Hipad Intelligent Technology Co., Ltd.
+609BC8     (base 16)		Hipad Intelligent Technology Co., Ltd.
+				No. 688, East of Huangtang Street, LinkongEconomy District
+				Nanchang  Jiangxi  330000
+				CN
+
+40-6A-8E   (hex)		Hangzhou Puwell OE Tech Ltd.
+406A8E     (base 16)		Hangzhou Puwell OE Tech Ltd.
+				Letel Technology Park, 500 Qiuyi Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+1C-0F-AF   (hex)		Lucid Vision Labs
+1C0FAF     (base 16)		Lucid Vision Labs
+				Unit 130 - 13200 Delf Place
+				Richmond  BC  V6V2A2
+				CA
+
+88-B4-A6   (hex)		Motorola Mobility LLC, a Lenovo Company
+88B4A6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+28-CF-08   (hex)		ESSYS
+28CF08     (base 16)		ESSYS
+				gaetbeol-ro
+				Incheon    21999
+				KR
+
+00-21-28   (hex)		Oracle Corporation
+002128     (base 16)		Oracle Corporation
+				17 Network Circle
+				Menlo Park  CA  95025
+				US
+
+00-1C-73   (hex)		Arista Networks
+001C73     (base 16)		Arista Networks
+				5470 Great America Pkwy
+				Santa Clara    95054
+				US
+
+2C-8A-72   (hex)		HTC Corporation
+2C8A72     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+38-AD-8E   (hex)		New H3C Technologies Co., Ltd
+38AD8E     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+34-D0-B8   (hex)		IEEE Registration Authority
+34D0B8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D0-67-26   (hex)		Hewlett Packard Enterprise
+D06726     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+EC-FA-F4   (hex)		SenRa Tech Pvt. Ltd
+ECFAF4     (base 16)		SenRa Tech Pvt. Ltd
+				133, First Floor, Lane No. 1, Westend Marg, Saidulajab
+				New Delhi    110030
+				IN
+
+D8-8F-76   (hex)		Apple, Inc.
+D88F76     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-9C-28   (hex)		Apple, Inc.
+409C28     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-A1-76   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+5CA176     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+58-38-79   (hex)		RICOH COMPANY, LTD.
+583879     (base 16)		RICOH COMPANY, LTD.
+				1005, Shimo-ogino
+				Atsugi-City  Kanagawa-Pref.  243-0298
+				JP
+
+F4-4C-70   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+F44C70     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-E7-F0   (hex)		Juniper Networks
+C8E7F0     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+B0-93-5B   (hex)		ARRIS Group, Inc.
+B0935B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F4-49-EF   (hex)		EMSTONE
+F449EF     (base 16)		EMSTONE
+				#310, Ace Techno Tower 3rd, 38 Digital-ro-29-gil
+				Guro-Gu  Seoul  08381
+				KR
+
+54-DF-24   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+54DF24     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+AC-1D-DF   (hex)		IEEE Registration Authority
+AC1DDF     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E8-D8-19   (hex)		AzureWave Technology Inc.
+E8D819     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+78-2D-7E   (hex)		TRENDnet, Inc.
+782D7E     (base 16)		TRENDnet, Inc.
+				20675 Manhattan Place
+				Torrance  CA  90501
+				US
+
+74-1A-E0   (hex)		IEEE Registration Authority
+741AE0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+24-B2-09   (hex)		Avaya Inc
+24B209     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+FC-65-DE   (hex)		Amazon Technologies Inc.
+FC65DE     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+B0-6E-BF   (hex)		ASUSTek COMPUTER INC.
+B06EBF     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+60-3D-26   (hex)		Technicolor CH USA Inc.
+603D26     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+BC-90-3A   (hex)		Robert Bosch GmbH
+BC903A     (base 16)		Robert Bosch GmbH
+				Postfach 1661
+				Leonberg    71226
+				DE
+
+D0-B1-28   (hex)		Samsung Electronics Co.,Ltd
+D0B128     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-54-51   (hex)		Samsung Electronics Co.,Ltd
+BC5451     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+74-86-0B   (hex)		Cisco Systems, Inc
+74860B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-2D-98   (hex)		Jinwoo Industrial system
+182D98     (base 16)		Jinwoo Industrial system
+				7F,Jinwoo Building,149 dosan-daero
+				seoul  gangnamgu  06036
+				KR
+
+D8-A5-34   (hex)		Spectronix Corporation
+D8A534     (base 16)		Spectronix Corporation
+				3-28-15, Tarumi-cho
+				Suita-city  Osaka  564-0062
+				JP
+
+EC-51-BC   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+EC51BC     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+F0-79-E8   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+F079E8     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+78-32-1B   (hex)		D-Link International
+78321B     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+60-18-03   (hex)		Daikin Air-conditioning (Shanghai) Co., Ltd.
+601803     (base 16)		Daikin Air-conditioning (Shanghai) Co., Ltd.
+				318 Shen Fu Road, Xin Zhuang Industry Zone, Shanghai, 201108, China
+				Shanghai    201108
+				CN
+
+00-A0-96   (hex)		MITSUMI ELECTRIC CO.,LTD.
+00A096     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+78-61-7C   (hex)		MITSUMI ELECTRIC CO.,LTD.
+78617C     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+94-0E-6B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+940E6B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-FB-50   (hex)		RoomReady/Zdi, Inc.
+64FB50     (base 16)		RoomReady/Zdi, Inc.
+				2200 N. Main Street
+				Normal  IL  61761
+				US
+
+74-EA-C8   (hex)		New H3C Technologies Co., Ltd
+74EAC8     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+B4-D6-4E   (hex)		Caldero Limited
+B4D64E     (base 16)		Caldero Limited
+				Concordia Works, 30 Sovereign Street
+				Leeds  West Yorkshire  LS1 4BA
+				GB
+
+F8-9D-BB   (hex)		Tintri
+F89DBB     (base 16)		Tintri
+				303 Ravendale Dr
+				Mountain View  CA  94070
+				US
+
+D8-A0-1D   (hex)		Espressif Inc.
+D8A01D     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+C4-F3-12   (hex)		Texas Instruments
+C4F312     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+90-4E-91   (hex)		IEEE Registration Authority
+904E91     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+5C-E8-B7   (hex)		Oraimo Technology Limited
+5CE8B7     (base 16)		Oraimo Technology Limited
+				RMS 05-15，13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HONG KONG  HONG KONG  999077
+				HK
+
+3C-11-B2   (hex)		Fraunhofer FIT
+3C11B2     (base 16)		Fraunhofer FIT
+				Schloss Birlinghoven
+				Sankt Augustin    53754
+				DE
+
+10-4B-46   (hex)		Mitsubishi Electric Corporation
+104B46     (base 16)		Mitsubishi Electric Corporation
+				2-7-3
+				Chiyoda-ku  Tokyo  100-8310
+				JP
+
+DC-0C-2D   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+DC0C2D     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road, Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+D0-67-E5   (hex)		Dell Inc.
+D067E5     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+8C-FE-B4   (hex)		VSOONTECH ELECTRONICS CO., LIMITED
+8CFEB4     (base 16)		VSOONTECH ELECTRONICS CO., LIMITED
+				18th, Floor, On Hong Commericial Building, 145 Hennessy Road, Wanchai, HONG KONG
+				HongKong    999077
+				HK
+
+CC-66-B2   (hex)		Nokia
+CC66B2     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+9C-65-EE   (hex)		DASAN Network Solutions
+9C65EE     (base 16)		DASAN Network Solutions
+				DASAN Tower 8F, 49 Daewangpangyo-ro644beon-gil Bundang-gu
+				Seongnam-si  Gyeonggi-do  13493
+				KR
+
+78-CA-04   (hex)		Nokia Corporation
+78CA04     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+34-29-8F   (hex)		IEEE Registration Authority
+34298F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+5C-EA-1D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+5CEA1D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+18-14-56   (hex)		Nokia Corporation
+181456     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+00-17-C8   (hex)		KYOCERA Display Corporation
+0017C8     (base 16)		KYOCERA Display Corporation
+				2-14-9, Tamagawadai
+				Tokyo    158-8610
+				JP
+
+38-E2-DD   (hex)		zte corporation
+38E2DD     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+88-5D-FB   (hex)		zte corporation
+885DFB     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+58-B4-2D   (hex)		YSTen Technology Co.,Ltd
+58B42D     (base 16)		YSTen Technology Co.,Ltd
+				Room 1715,17/F North Star Times Tower,Chaoyang District,Beijing.
+				Beijing    100101
+				CN
+
+E0-48-D3   (hex)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+E048D3     (base 16)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+				No.999,Dacheng East Road,
+				Fenghua  Zhejiang  315500
+				CN
+
+58-E2-8F   (hex)		Apple, Inc.
+58E28F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-7B-8A   (hex)		Apple, Inc.
+787B8A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-16-FC   (hex)		Juniper Networks
+4C16FC     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+48-BC-A6   (hex)		​ASUNG TECHNO CO.,Ltd
+48BCA6     (base 16)		​ASUNG TECHNO CO.,Ltd
+				462, Dogok-ro, Songpa-gu, Seoul, Republic of Korea
+				SEOUL  Repubilc of KOREA  05574
+				KR
+
+B0-09-DA   (hex)		Ring Solutions
+B009DA     (base 16)		Ring Solutions
+				1200 Atwater Drive, Suite 225
+				Malvern  PA  19355
+				US
+
+00-05-4F   (hex)		Garmin International
+00054F     (base 16)		Garmin International
+				1200 E. 151st St
+				Olathe  KS  66062
+				US
+
+00-5C-86   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+005C86     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+30-05-3F   (hex)		JTI Co.,Ltd.
+30053F     (base 16)		JTI Co.,Ltd.
+				102-1508, 36, Bucheon-ro 198beon-gil, 
+				Buchcheon-si  Gyeonggi-do  14557
+				KR
+
+B8-DB-1C   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+B8DB1C     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+3C-10-E6   (hex)		PHAZR Inc.
+3C10E6     (base 16)		PHAZR Inc.
+				8, Presitige Circle, Suite 104
+				Allen  TX  75002
+				US
+
+90-45-06   (hex)		Tokyo Boeki Medisys Inc.
+904506     (base 16)		Tokyo Boeki Medisys Inc.
+				1-14-21, Higashitoyoda
+				 Hino  Tokyo  191-0052
+				JP
+
+00-21-A1   (hex)		Cisco Systems, Inc
+0021A1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+FC-B6-98   (hex)		Cambridge Industries(Group) Co.,Ltd.
+FCB698     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22 Floor,Qilai Tower;889 Yishan Road
+				Shanghai  CHINA  200233
+				CN
+
+00-01-CD   (hex)		ARtem
+0001CD     (base 16)		ARtem
+				Olgastraße 152
+				    
+				DE
+
+5C-54-6D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C546D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-A1-D1   (hex)		Sagemcom Broadband SAS
+84A1D1     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+90-9D-7D   (hex)		ARRIS Group, Inc.
+909D7D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+78-8C-4D   (hex)		Indyme Solutions, LLC
+788C4D     (base 16)		Indyme Solutions, LLC
+				8295 Aero Place Ste 260
+				San Diego  CA  92123
+				US
+
+78-BC-1A   (hex)		Cisco Systems, Inc
+78BC1A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-59   (hex)		Sagemcom Broadband SAS
+000E59     (base 16)		Sagemcom Broadband SAS
+				2, rue du petit Albi
+				CERGY SAINT CHRISTOPHE  val d'Oise  95800
+				FR
+
+10-1D-51   (hex)		8Mesh Networks Limited
+101D51     (base 16)		8Mesh Networks Limited
+				Unit 607, 6/F, Yen Sheng Centre,
+				64 Hoi Yuen Road  Kwun Tong  000
+				HK
+
+DC-EB-53   (hex)		Wuhan QianXiao Elecronic Technology CO.,LTD
+DCEB53     (base 16)		Wuhan QianXiao Elecronic Technology CO.,LTD
+				Guanggu Xinzhongxin, No.303 of Guanggu road, East lake development zone
+				wuhan  hubei  430000
+				CN
+
+EC-8A-C7   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+EC8AC7     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+88-36-5F   (hex)		LG Electronics (Mobile Communications)
+88365F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+28-8C-B8   (hex)		zte corporation
+288CB8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+FC-7F-56   (hex)		CoSyst Control Systems GmbH
+FC7F56     (base 16)		CoSyst Control Systems GmbH
+				Martin-Albert-Str. 1
+				Nürnberg  Bayern  90491
+				DE
+
+2C-40-53   (hex)		Samsung Electronics Co.,Ltd
+2C4053     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+0C-8F-FF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C8FFF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-B1-21   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+54B121     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-81-02   (hex)		Sercomm Corporation.
+788102     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+84-AA-9C   (hex)		MitraStar Technology Corp.
+84AA9C     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+F0-EF-D2   (hex)		TF PAYMENT SERVICE CO., LTD
+F0EFD2     (base 16)		TF PAYMENT SERVICE CO., LTD
+				5F Shibadaimon Center Building, 1-10-11 Shibadaimon
+				Minato-ku  Tokyo  105-0012
+				JP
+
+24-B2-DE   (hex)		Espressif Inc.
+24B2DE     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+F4-93-9F   (hex)		Hon Hai Precision Ind. Co., Ltd.
+F4939F     (base 16)		Hon Hai Precision Ind. Co., Ltd.
+				GuangDongShenZhen
+				ShenZhen  GuangDong  518109
+				CN
+
+00-07-26   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+000726     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				A211-A213 & B201-B210, 2F, Baiying Building, 1019#, Nanhai RD, Shekou Party, Nanshan District, 
+				Shenzhen  Guangdong  518067
+				CN
+
+FC-8B-97   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+FC8B97     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				B116,B118,A211-A213,B201-B213,A311-A313,B411-413,BF08-09 Nanshan Medical Instrument Industry Park,
+				Shenzhen  Guangdong  518067
+				CN
+
+2C-AB-25   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+2CAB25     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				B116,B118,A211-A213,B201-B213,A311-A313,B411-413,BF08-09 Nanshan Medical Instrument Industry Park,
+				Shenzhen  Guangdong  518067
+				CN
+
+1C-A5-32   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+1CA532     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				1#SongGang RD, Bao'an Dist., Shenzhen, Guangdong,China
+				Shenzhen  Guangdong  518109
+				CN
+
+00-1F-92   (hex)		Avigilon Corporation
+001F92     (base 16)		Avigilon Corporation
+				Box 378, 101 - 1001 West Broadway
+				Vancouver  BC  V6H 4E4
+				CA
+
+00-0C-03   (hex)		HDMI Licensing, LLC
+000C03     (base 16)		HDMI Licensing, LLC
+				1060 East Arques Ave.
+				Sunnyvale  CA  94085
+				US
+
+7C-BA-CC   (hex)		IEEE Registration Authority
+7CBACC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-F1-28   (hex)		Hewlett Packard Enterprise
+94F128     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville    95747
+				US
+
+10-1B-54   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+101B54     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+A8-0C-63   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A80C63     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-C3-07   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CC307     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E0-10-7F   (hex)		Ruckus Wireless
+E0107F     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+C4-01-7C   (hex)		Ruckus Wireless
+C4017C     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+04-FA-3F   (hex)		Opticore Inc.
+04FA3F     (base 16)		Opticore Inc.
+				97 Jungbudaero448beongil, Yeongtonggu
+				Suwonsi  Gyeonggido  16521
+				KR
+
+54-02-37   (hex)		Teltronic AG
+540237     (base 16)		Teltronic AG
+				Gewerbestrasse 9
+				Biberist    4562
+				CH
+
+4C-B0-08   (hex)		Shenzhen Gwelltimes Technology Co.,Ltd
+4CB008     (base 16)		Shenzhen Gwelltimes Technology Co.,Ltd
+				A4 building 15floor Zhongying Jewelry Industrial Park Bulan Road No.31 Nanwan Street Longgang District Shenzhen City China
+				Shenzhen    518112
+				CN
+
+E8-6F-F2   (hex)		Actiontec Electronics, Inc
+E86FF2     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-50-18   (hex)		AMIT, Inc.
+005018     (base 16)		AMIT, Inc.
+				No.32, Huangong Rd.,
+				Yongkang City,  Tainan County  71041
+				TW
+
+70-DE-F9   (hex)		FAI WAH INTERNATIONAL (HONG KONG) LIMITED
+70DEF9     (base 16)		FAI WAH INTERNATIONAL (HONG KONG) LIMITED
+				Room 19, 8F.,Corporation Park, 11 On Lai Street,Shatin,Shek Mun,N.T.Hong Kong
+				Hong Kong    999077
+				HK
+
+B0-EA-BC   (hex)		ASKEY COMPUTER CORP
+B0EABC     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+94-C6-91   (hex)		EliteGroup Computer Systems Co., LTD
+94C691     (base 16)		EliteGroup Computer Systems Co., LTD
+				No.239, Sec. 2, TiDing Blvd. Nei-Hu Dist.
+				Taipei  Taiwan  11439
+				TW
+
+3C-F5-91   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+3CF591     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+60-21-01   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+602101     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+7C-EB-7F   (hex)		Dmet Products Corp.
+7CEB7F     (base 16)		Dmet Products Corp.
+				118, Fujisoft Akihabara Bldg 12F, Kanda Neribeicho 3
+				Chiyodaku  Tokyo  1010022
+				JP
+
+8C-85-80   (hex)		Smart Innovation LLC
+8C8580     (base 16)		Smart Innovation LLC
+				7F,Tower B,Jianxing
+				ShenZhen  GuangZhou  518055
+				CN
+
+40-42-29   (hex)		Layer3TV, Inc
+404229     (base 16)		Layer3TV, Inc
+				1660 Wynkoop St - Suite 800
+				Denver  CO  80202
+				US
+
+FC-2F-6B   (hex)		Everspin Technologies, Inc.
+FC2F6B     (base 16)		Everspin Technologies, Inc.
+				1347 N. Alma School Rd., Suite 220
+				Chandler  AZ  85224
+				US
+
+28-7B-09   (hex)		zte corporation
+287B09     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-25-C4   (hex)		Ruckus Wireless
+0025C4     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+C0-C5-20   (hex)		Ruckus Wireless
+C0C520     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+78-B2-8D   (hex)		Beijing Tengling Technology CO.Ltd 
+78B28D     (base 16)		Beijing Tengling Technology CO.Ltd 
+				beijing haidian shangdi san jie
+				beijing    100086
+				CN
+
+A8-80-38   (hex)		ShenZhen MovingComm Technology Co., Limited
+A88038     (base 16)		ShenZhen MovingComm Technology Co., Limited
+				5F, FuXinFa Industrial Park, LiuXianDong Industrial Zone,
+				ShenZhen  GuangDong   518055
+				CN
+
+F8-1D-90   (hex)		Solidwintech
+F81D90     (base 16)		Solidwintech
+				6th Floor, SOLiD Space 220 Pangyoyeok-ro, Bundang-gu
+				Seongnam-si  Gyeongi-do  13493
+				KR
+
+A0-6A-44   (hex)		Vizio, Inc
+A06A44     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+DC-BE-7A   (hex)		Zhejiang Nurotron Biotechnology Co.
+DCBE7A     (base 16)		Zhejiang Nurotron Biotechnology Co.
+				Building4, No.99 Xiaomao Rd
+				Hangzhou  zhejiang  310011
+				CN
+
+34-38-B7   (hex)		HUMAX Co., Ltd.
+3438B7     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+CC-06-77   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+CC0677     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+78-45-01   (hex)		Biamp Systems
+784501     (base 16)		Biamp Systems
+				9300 SW Gemini Dr
+				Beaverton  OR  97008
+				US
+
+30-9C-23   (hex)		Micro-Star INTL CO., LTD.
+309C23     (base 16)		Micro-Star INTL CO., LTD.
+				No.69, Lide St.,
+				New Taipei City  Taiwan  235
+				TW
+
+54-D7-51   (hex)		Proximus
+54D751     (base 16)		Proximus
+				Bld du Roi Albert II 27
+				Brussels    1030
+				BE
+
+14-78-0B   (hex)		Varex Imaging Deutschland AG
+14780B     (base 16)		Varex Imaging Deutschland AG
+				Zweigniederlassung/Branch Walluf
+				In der Rehbach 22  Walluf  65396
+				DE
+
+AC-AF-B9   (hex)		Samsung Electronics Co.,Ltd
+ACAFB9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-B1-11   (hex)		Intel Corporate
+88B111     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+8C-39-5C   (hex)		Bit4id Srl
+8C395C     (base 16)		Bit4id Srl
+				Via Diocleziano, 107
+				Naples    80125
+				IT
+
+D4-25-8B   (hex)		Intel Corporate
+D4258B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+04-1B-6D   (hex)		LG Electronics (Mobile Communications)
+041B6D     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F4-41-56   (hex)		Arrikto Inc.
+F44156     (base 16)		Arrikto Inc.
+				3505 El Camino Real
+				Palo Alto  CA  94306
+				US
+
+00-80-C2   (hex)		IEEE 802.1 Working Group
+0080C2     (base 16)		IEEE 802.1 Working Group
+				802.1 CHAIR c/o IEEE
+				Piscataway  NJ  08554
+				US
+
+68-8D-B6   (hex)		AETEK INC.
+688DB6     (base 16)		AETEK INC.
+				 3F, No.192, Lien-Cheng Rd., Chung-Ho,
+				 New Taipei City    23553
+				TW
+
+EC-F3-42   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+ECF342     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+50-FF-20   (hex)		Keenetic Limited
+50FF20     (base 16)		Keenetic Limited
+				1202, 12/F., AT TOWER, 180 ELECTRIC ROAD, NORTH POINT
+				HONG KONG    852
+				HK
+
+E4-57-40   (hex)		ARRIS Group, Inc.
+E45740     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-94-C2   (hex)		Intel Corporate
+F894C2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+70-D3-79   (hex)		Cisco Systems, Inc
+70D379     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-F8-2C   (hex)		Cisco Systems, Inc
+00F82C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-C1-B1   (hex)		Cisco Systems, Inc
+00C1B1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-FC-B1   (hex)		JJ Corp
+F4FCB1     (base 16)		JJ Corp
+				88 Soha-ro
+				Gwangmyeong-si    14316
+				KR
+
+D8-C8-E9   (hex)		Phicomm (Shanghai) Co., Ltd.
+D8C8E9     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+7C-B9-60   (hex)		Shanghai X-Cheng telecom LTD
+7CB960     (base 16)		Shanghai X-Cheng telecom LTD
+				ROOM 401, Building 5, No.3000 LONG DONG Avenue, Pudong New District, Shanghai
+				Shanghai  Shanghai  201203
+				CN
+
+B0-3D-96   (hex)		Vision Valley FZ LLC
+B03D96     (base 16)		Vision Valley FZ LLC
+				Dubai Internet City
+				Dubai  Dubai  500294
+				AE
+
+98-6C-5C   (hex)		Jiangxi Gosun Guard Security Co.,Ltd
+986C5C     (base 16)		Jiangxi Gosun Guard Security Co.,Ltd
+				2rd floor,8 building Middle,Zhongxing Software Park,Changdong Avenue,Nanchang High Tech Zone,Nanchang city,Jiangxi province
+				Nan Chang City  Jiang Xi Province  330000
+				CN
+
+24-79-2A   (hex)		Ruckus Wireless
+24792A     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+30-D3-86   (hex)		zte corporation
+30D386     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+70-DB-98   (hex)		Cisco Systems, Inc
+70DB98     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B4-2A-0E   (hex)		Technicolor CH USA Inc.
+B42A0E     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+9C-C8-AE   (hex)		Becton, Dickinson  and Company
+9CC8AE     (base 16)		Becton, Dickinson  and Company
+				1 Becton Drive
+				Franklin Lakes  MA   07417-1880
+				US
+
+B0-35-9F   (hex)		Intel Corporate
+B0359F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+C0-D9-62   (hex)		ASKEY COMPUTER CORP
+C0D962     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,JIANKANG RD.,ZHONGHE DIST XINBEI CITY
+				taipei  TAIPEI  23585
+				TW
+
+F8-0B-CB   (hex)		Cisco Systems, Inc
+F80BCB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-D3-7F   (hex)		Yu Fly Mikly Way Science and Technology Co., Ltd.
+50D37F     (base 16)		Yu Fly Mikly Way Science and Technology Co., Ltd.
+				6F, No. 1168 Huyi Road, Nanxiang Town Jiading District Shanghai 201800 CHINA
+				shanghai    201800
+				CN
+
+18-12-12   (hex)		Cepton Technologies
+181212     (base 16)		Cepton Technologies
+				103 Bonaventura Dr
+				San Jose  CA  95134
+				US
+
+70-D9-23   (hex)		vivo Mobile Communication Co., Ltd.
+70D923     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'an  DongGuan City,Guangdong  523860
+				CN
+
+B8-3A-08   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+B83A08     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+28-B4-48   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+28B448     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-05-01   (hex)		PEGATRON CORPORATION
+100501     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+2C-FA-A2   (hex)		Alcatel-Lucent Enterprise
+2CFAA2     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Rd
+				Calabasas  CA  91301
+				US
+
+A4-9B-F5   (hex)		Hybridserver Tec GmbH
+A49BF5     (base 16)		Hybridserver Tec GmbH
+				Gutenbergring 26a
+				Norderstedt  Schleswig-Holstein  22848
+				DE
+
+50-3D-A1   (hex)		Samsung Electronics Co.,Ltd
+503DA1     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+F0-97-E5   (hex)		TAMIO, INC
+F097E5     (base 16)		TAMIO, INC
+				12F-2, No.33, Sec. 1 , Mingsheng Rd.,Banqiao Dist
+				New Taipei City    22069
+				TW
+
+4C-1A-3D   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+4C1A3D     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+08-02-8E   (hex)		NETGEAR
+08028E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+E8-E7-32   (hex)		Alcatel-Lucent Enterprise
+E8E732     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				Calabasas  CA  91301
+				US
+
+B4-7C-9C   (hex)		Amazon Technologies Inc.
+B47C9C     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+F4-A7-39   (hex)		Juniper Networks
+F4A739     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F4-70-AB   (hex)		vivo Mobile Communication Co., Ltd.
+F470AB     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+2C-5A-0F   (hex)		Cisco Systems, Inc
+2C5A0F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-31-24   (hex)		Cisco Systems, Inc
+2C3124     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-32-37   (hex)		Apple, Inc.
+503237     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-48-1A   (hex)		Apple, Inc.
+B0481A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-9C-DF   (hex)		Apple, Inc.
+B49CDF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-BF-6B   (hex)		Apple, Inc.
+48BF6B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-1D-B8   (hex)		ARRIS Group, Inc.
+2C1DB8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+58-82-1D   (hex)		H. Schomäcker GmbH
+58821D     (base 16)		H. Schomäcker GmbH
+				Heidestr. 183
+				Köln    51147
+				DE
+
+D8-A1-05   (hex)		Syslane, Co., Ltd.
+D8A105     (base 16)		Syslane, Co., Ltd.
+				#1201, Megacenter, SKntechno-park,, Sangdaeweon-dong, Joongweon-gu
+				Seongnam  Outside the US, Mexico, or Canada  462-721
+				KR
+
+BC-A0-42   (hex)		SHANGHAI FLYCO ELECTRICAL APPLIANCE CO.,LTD
+BCA042     (base 16)		SHANGHAI FLYCO ELECTRICAL APPLIANCE CO.,LTD
+				No.555,Guang Fu Lin east Road,Songjiang District
+				Shanghai  Shanghai  201613
+				CN
+
+3C-05-18   (hex)		Samsung Electronics Co.,Ltd
+3C0518     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+90-06-28   (hex)		Samsung Electronics Co.,Ltd
+900628     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-A9-FE   (hex)		GHIA Technology (Shenzhen) LTD
+B4A9FE     (base 16)		GHIA Technology (Shenzhen) LTD
+				RM 1606, BLDG 3rd, COFCO Clouds Mansion
+				Shenzhen    518101
+				CN
+
+08-B2-58   (hex)		Juniper Networks
+08B258     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+9C-84-BF   (hex)		Apple, Inc.
+9C84BF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-A0-D3   (hex)		IEEE Registration Authority
+1CA0D3     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+9C-FC-D1   (hex)		Aetheris Technology (Shanghai) Co., Ltd.
+9CFCD1     (base 16)		Aetheris Technology (Shanghai) Co., Ltd.
+				Room 225， Building No. 8, 433 Yuyuan Road
+				Shanghai  Shanghai  200040
+				CN
+
+CC-CE-1E   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+CCCE1E     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+0C-F4-D5   (hex)		Ruckus Wireless
+0CF4D5     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+7C-26-64   (hex)		Sagemcom Broadband SAS
+7C2664     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+AC-6B-0F   (hex)		CADENCE DESIGN SYSTEMS INC
+AC6B0F     (base 16)		CADENCE DESIGN SYSTEMS INC
+				2670 SEELY AVE
+				SAN JOSE  CA  95134
+				US
+
+C8-B5-AD   (hex)		Hewlett Packard Enterprise
+C8B5AD     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+7C-38-66   (hex)		Texas Instruments
+7C3866     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+0C-61-CF   (hex)		Texas Instruments
+0C61CF     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+9C-1D-58   (hex)		Texas Instruments
+9C1D58     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+38-05-AC   (hex)		Piller Group GmbH
+3805AC     (base 16)		Piller Group GmbH
+				Abgunst 24
+				Osterode    37520
+				DE
+
+34-6E-9D   (hex)		Ericsson AB
+346E9D     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+68-54-C1   (hex)		ColorTokens, Inc.
+6854C1     (base 16)		ColorTokens, Inc.
+				2101 Tasman Dr. Suite 200A
+				Santa Clara  CA  95054
+				US
+
+00-11-1B   (hex)		Targa Systems Div L-3 Communications
+00111B     (base 16)		Targa Systems Div L-3 Communications
+				2081 Merivale Rd
+				Ottawa  Ont  K2G 1G9
+				CA
+
+6C-75-0D   (hex)		WiFiSONG
+6C750D     (base 16)		WiFiSONG
+				Rm. 605, Building 3, No. 75 Wenyi West Road
+				Hangzhou  Zhejiang  310012
+				CN
+
+BC-3F-8F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC3F8F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-30-04   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+143004     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-DC-41   (hex)		YOUNGZONE CULTURE (SHANGHAI) CORP
+F4DC41     (base 16)		YOUNGZONE CULTURE (SHANGHAI) CORP
+				7-8th floor, #1 Building, 1006 Jinshajiang Road
+				Shanghai  Shanghai  200062
+				CN
+
+C4-83-6F   (hex)		Ciena Corporation
+C4836F     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+7C-C6-C4   (hex)		Kolff Computer Supplies b.v.
+7CC6C4     (base 16)		Kolff Computer Supplies b.v.
+				Kuipershaven 22
+				Dordrecht  Zuid-Holland  3311 AL
+				NL
+
+00-0F-4F   (hex)		PCS Systemtechnik GmbH
+000F4F     (base 16)		PCS Systemtechnik GmbH
+				66 Hillside Rd
+				Auckland    1310
+				NZ
+
+A8-0C-CA   (hex)		Shenzhen Sundray Technologies Company Limited
+A80CCA     (base 16)		Shenzhen Sundray Technologies Company Limited
+				6th Floor,Block A1, Nanshan iPark, No.1001 XueYuan Road, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+38-AA-3C   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+38AA3C     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon    443-743
+				US
+
+00-03-02   (hex)		Charles Industries, Ltd.
+000302     (base 16)		Charles Industries, Ltd.
+				5600 Apollo Drive
+				Rolling Meadows  IL  60008
+				US
+
+50-A4-D0   (hex)		IEEE Registration Authority
+50A4D0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-00-10   (hex)		AT&T
+800010     (base 16)		AT&T
+				3300 E Renner Road
+				Richardson  TX  75082
+				US
+
+00-24-F1   (hex)		Shenzhen Fanhai Sanjiang Electronics Co., Ltd.
+0024F1     (base 16)		Shenzhen Fanhai Sanjiang Electronics Co., Ltd.
+				3Floor-Guangcai Xintiandi Building,Nanshan Rd,Nanshan,
+				Shenzhen  Guangdong  518054
+				CN
+
+14-2F-FD   (hex)		LT SECURITY INC
+142FFD     (base 16)		LT SECURITY INC
+				18738 SAN JOSE AVE
+				CITY OF INDUSTRY  CA  91748
+				US
+
+0C-3C-CD   (hex)		Universal Global Scientific Industrial Co., Ltd.
+0C3CCD     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Road, Sec.1,Tsao Tuen
+				Nan-Tou  Taiwan  54261
+				TW
+
+14-AB-C5   (hex)		Intel Corporate
+14ABC5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+50-D2-13   (hex)		CviLux Corporation
+50D213     (base 16)		CviLux Corporation
+				9F,No.9,Lane 3,Sec.1,Chung-Cheng East Road, Tamshui
+				New Taipei City    25147
+				TW
+
+00-1E-29   (hex)		Hypertherm Inc
+001E29     (base 16)		Hypertherm Inc
+				15 Great Hollow Rd
+				Hanover  NH  03755
+				US
+
+50-04-B8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5004B8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-D0-B2   (hex)		Xiotech Corporation
+00D0B2     (base 16)		Xiotech Corporation
+				6455 FLYING CLOUD DRIVE
+				EDEN PRAIRIE  MN  55344
+				US
+
+5C-FF-35   (hex)		Wistron Corporation
+5CFF35     (base 16)		Wistron Corporation
+				21F, 88, Sec.1, Hsin Tai Wu Rd., Hsichih,
+				Taipei Hsien    221
+				TW
+
+CC-9F-7A   (hex)		Chiun Mai Communication Systems, Inc
+CC9F7A     (base 16)		Chiun Mai Communication Systems, Inc
+				No.4, Minsheng St., Tucheng District
+				New Taipei City    23678
+				TW
+
+78-F2-9E   (hex)		PEGATRON CORPORATION
+78F29E     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+64-77-7D   (hex)		Hitron Technologies. Inc
+64777D     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+9C-50-EE   (hex)		Cambridge Industries(Group) Co.,Ltd.
+9C50EE     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				5/F,Building 8, 2388 ChenHang Road, MinHang District
+				shanghai    201114
+				CN
+
+40-ED-98   (hex)		IEEE Registration Authority
+40ED98     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C8-91-F9   (hex)		Sagemcom Broadband SAS
+C891F9     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+AC-DC-E5   (hex)		Procter & Gamble Company
+ACDCE5     (base 16)		Procter & Gamble Company
+				2 Procter & Gamble Plaza
+				Cincinnati  OH  45202
+				US
+
+00-B3-62   (hex)		Apple, Inc.
+00B362     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-E4-AB   (hex)		Apple, Inc.
+E4E4AB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-D2-62   (hex)		Tzukuri Pty Ltd
+60D262     (base 16)		Tzukuri Pty Ltd
+				6 Lenthall Street
+				Kensington  NSW  2033
+				AU
+
+84-04-D2   (hex)		Kirale Technologies SL
+8404D2     (base 16)		Kirale Technologies SL
+				General Vara de Rey 9, 5B
+				Logrono  La Rioja  26001
+				ES
+
+54-FA-96   (hex)		Nokia
+54FA96     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+60-33-4B   (hex)		Apple, Inc.
+60334B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-AF-D7   (hex)		FUJITSU LIMITED
+38AFD7     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+28-99-3A   (hex)		Arista Networks
+28993A     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+64-EB-8C   (hex)		Seiko Epson Corporation
+64EB8C     (base 16)		Seiko Epson Corporation
+				80 Harashinden
+				Shiojiri-shi  Nagano-ken  399-0785
+				JP
+
+F4-8C-50   (hex)		Intel Corporate
+F48C50     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+DC-D2-55   (hex)		Kinpo Electronics, Inc.
+DCD255     (base 16)		Kinpo Electronics, Inc.
+				No.147, Sec. 3, Beishen Rd
+				Shenkeng Dist.  New Taipei City  222
+				TW
+
+A0-2C-36   (hex)		FN-LINK TECHNOLOGY LIMITED
+A02C36     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+00-03-20   (hex)		Xpeed, Inc.
+000320     (base 16)		Xpeed, Inc.
+				99 W. Tasman Drive
+				San Jose  CA  95134
+				US
+
+50-8A-0F   (hex)		SHENZHEN FISE TECHNOLOGY HOLDING CO.,LTD.
+508A0F     (base 16)		SHENZHEN FISE TECHNOLOGY HOLDING CO.,LTD.
+				No.6 Building, Longfu Industrial Area, Huarong Road, Tongsheng Community, Dalang Street, Longhua New District
+				Shenzhen  Guangdong  518000
+				CN
+
+7C-CB-E2   (hex)		IEEE Registration Authority
+7CCBE2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A8-A5-E2   (hex)		MSF-Vathauer Antriebstechnik GmbH & Co KG 
+A8A5E2     (base 16)		MSF-Vathauer Antriebstechnik GmbH & Co KG 
+				Am Hessentuch 6-8
+				Detmold  Nordrhein-Westfalen  32758
+				DE
+
+BC-A8-A6   (hex)		Intel Corporate
+BCA8A6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+74-FF-4C   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+74FF4C     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+68-AF-13   (hex)		Futura Mobility
+68AF13     (base 16)		Futura Mobility
+				515 PENNSYLVANIA AVE
+				FORT WASHINTON  PA  19034
+				US
+
+68-1A-B2   (hex)		zte corporation
+681AB2     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+E0-4F-BD   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+E04FBD     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+7C-EB-AE   (hex)		Ridgeline Instruments
+7CEBAE     (base 16)		Ridgeline Instruments
+				4803 Innovation Drive, Suite 3B
+				Fort Collins  CO  80525
+				US
+
+E0-50-8B   (hex)		Zhejiang Dahua Technology Co., Ltd.
+E0508B     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+9C-1E-95   (hex)		Actiontec Electronics, Inc
+9C1E95     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+60-42-7F   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+60427F     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+E8-9E-B4   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+E89EB4     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+D4-6A-6A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D46A6A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+98-FD-74   (hex)		ACT.CO.LTD
+98FD74     (base 16)		ACT.CO.LTD
+				3-RD Floor 93, Sanbon-ro
+				Gunpo-si  Gyeonggi-do  15849
+				KR
+
+64-DB-43   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+64DB43     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+00-0E-58   (hex)		Sonos, Inc.
+000E58     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+00-25-90   (hex)		Super Micro Computer, Inc.
+002590     (base 16)		Super Micro Computer, Inc.
+				980 Rock Avenue
+				San Jose  California  95131
+				US
+
+AC-1F-6B   (hex)		Super Micro Computer, Inc.
+AC1F6B     (base 16)		Super Micro Computer, Inc.
+				980 Rock Ave
+				San Jose  CA  95131
+				US
+
+00-0B-2E   (hex)		Cal-Comp Electronics & Communications Company Ltd.
+000B2E     (base 16)		Cal-Comp Electronics & Communications Company Ltd.
+				No.147, Sec. 3, Beishen Rd
+				Shenkeng Dist  New Taipei City  ---
+				TW
+
+48-65-EE   (hex)		IEEE Registration Authority
+4865EE     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D0-F7-3B   (hex)		Helmut Mauell GmbH Werk Weida
+D0F73B     (base 16)		Helmut Mauell GmbH Werk Weida
+				Am Rosenhügel 1-7
+				Velbert    42553
+				DE
+
+18-06-75   (hex)		Dilax Intelcom GmbH
+180675     (base 16)		Dilax Intelcom GmbH
+				Alt-Moabit 96b
+				Berlin    10559
+				DE
+
+00-0F-C2   (hex)		Uniwell Corporation
+000FC2     (base 16)		Uniwell Corporation
+				5-25, 3-chome, Tenma, Kita-ku
+				Osaka    530-0043
+				JP
+
+6C-EC-5A   (hex)		Hon Hai Precision Ind. CO.,Ltd.
+6CEC5A     (base 16)		Hon Hai Precision Ind. CO.,Ltd.
+				B22 Building, NO.52,Tongle Road, Foxconn Industrial Park, District Jiangnan, Nanning, Guangxi, China
+				Nanning  Guangxi  530031
+				CN
+
+44-C3-46   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+44C346     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-74-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+307496     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-8A-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+708A09     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-C5-EF   (hex)		Co-Comm Servicios Telecomunicaciones S.L.
+CCC5EF     (base 16)		Co-Comm Servicios Telecomunicaciones S.L.
+				Lisboa, 20 Las Rozas
+				Madrid  Madrid  28232
+				ES
+
+90-02-A9   (hex)		Zhejiang Dahua Technology Co., Ltd.
+9002A9     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				NO.1199 BinAn Road
+				Hangzhou  Zhejiang  310053
+				CN
+
+C0-28-8D   (hex)		Logitech, Inc
+C0288D     (base 16)		Logitech, Inc
+				4700 NW Camas Meadows Drive
+				Camas  WA  98607
+				US
+
+0C-49-33   (hex)		Sichuan Jiuzhou Electronic Technology Co., Ltd.
+0C4933     (base 16)		Sichuan Jiuzhou Electronic Technology Co., Ltd.
+				No. 259, Jiuzhou Road
+				Mianyang City  Sichuan Province  621000
+				CN
+
+00-00-64   (hex)		Yokogawa Digital Computer Corporation
+000064     (base 16)		Yokogawa Digital Computer Corporation
+				Shinjuku MIDWEST Bldg.4-30-3
+				Yoyogi  Shibuya-ku, Tokyo  151-0053
+				JP
+
+50-6B-8D   (hex)		Nutanix
+506B8D     (base 16)		Nutanix
+				1740 Technology Drive Ste #150
+				San Jose  CA  95110
+				US
+
+00-38-DF   (hex)		Cisco Systems, Inc
+0038DF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-CA-E5   (hex)		FREEBOX SAS
+F4CAE5     (base 16)		FREEBOX SAS
+				8 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+90-00-4E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+90004E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+7C-26-34   (hex)		ARRIS Group, Inc.
+7C2634     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-F4-13   (hex)		Rubezh
+40F413     (base 16)		Rubezh
+				Ulyanovskaya str. 28
+				Saratov    410056
+				RU
+
+C8-D3-FF   (hex)		Hewlett Packard
+C8D3FF     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+C4-BE-84   (hex)		Texas Instruments
+C4BE84     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas    75243
+				US
+
+F4-F5-24   (hex)		Motorola Mobility LLC, a Lenovo Company
+F4F524     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+00-BB-C1   (hex)		CANON INC.
+00BBC1     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+24-C1-BD   (hex)		CRRC DALIAN R&D CO.,LTD.
+24C1BD     (base 16)		CRRC DALIAN R&D CO.,LTD.
+				No.1 Haoyang North Street,Lvshun Economic Deveopment Zone
+				Dalian  Liaoning  116052
+				CN
+
+00-A2-EE   (hex)		Cisco Systems, Inc
+00A2EE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-59-DC   (hex)		Cisco Systems, Inc
+0059DC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-FD-45   (hex)		Hewlett Packard Enterprise
+00FD45     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+50-98-F3   (hex)		Rheem Australia Pty Ltd
+5098F3     (base 16)		Rheem Australia Pty Ltd
+				1 Alan Street
+				Rydalmere  NSW  2116
+				AU
+
+B4-D1-35   (hex)		Cloudistics
+B4D135     (base 16)		Cloudistics
+				116000 Sunrise Valley Dr Suite 210
+				Reston  VA  20190
+				US
+
+00-13-A5   (hex)		General Solutions, LTD.
+0013A5     (base 16)		General Solutions, LTD.
+				5902 Sovereign Drive
+				Houston  Texas  77036
+				US
+
+9C-3D-CF   (hex)		NETGEAR
+9C3DCF     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+24-88-94   (hex)		shenzhen lensun Communication Technology LTD
+248894     (base 16)		shenzhen lensun Communication Technology LTD
+				RM 201, Block 19, Zhiheng industry Park, Nantou Check point
+				Shenzhen   Guangdong  518000
+				CN
+
+B0-4B-BF   (hex)		PT HAN SUNG ELECTORONICS INDONESIA
+B04BBF     (base 16)		PT HAN SUNG ELECTORONICS INDONESIA
+				JL.PALEM 1 BLOK DS-6
+				KAWASAN INDUSTRI BATIK LIPPO CIKARANG, DESA CIBATU, KECAMATAN CIKARANG SELATAN  BEKASI JAWA BARAT  17550
+				ID
+
+CC-2D-83   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+CC2D83     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D4-6E-0E   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D46E0E     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+88-36-6C   (hex)		EFM Networks
+88366C     (base 16)		EFM Networks
+				6F, Benposra II 1197-1 Bojeong Giheung Gu
+				Yong In  Kyunggi do  446913
+				KR
+
+48-DA-96   (hex)		Eddy Smart Home Solutions Inc.
+48DA96     (base 16)		Eddy Smart Home Solutions Inc.
+				1600-25 Sheppard Avenue West
+				Toronto  Ontario  M2N 6S6
+				CA
+
+F0-74-E4   (hex)		Thundercomm Technology Co., Ltd
+F074E4     (base 16)		Thundercomm Technology Co., Ltd
+				Building NO.4, 99# Xiantao Data Valley Zhonglu, Yubei District, Chongqing, China 
+				chongqing    404100
+				CN
+
+A0-72-2C   (hex)		HUMAX Co., Ltd.
+A0722C     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+FC-D8-48   (hex)		Apple, Inc.
+FCD848     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-10-7B   (hex)		Samsung Electronics Co.,Ltd
+EC107B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-23-2C   (hex)		Samsung Electronics Co.,Ltd
+1C232C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-0D-B9   (hex)		Cree, Inc.
+E00DB9     (base 16)		Cree, Inc.
+				4600 Silicon Drive
+				Durham  NC  27703
+				US
+
+DC-0D-30   (hex)		Shenzhen Feasycom Technology Co., Ltd.
+DC0D30     (base 16)		Shenzhen Feasycom Technology Co., Ltd.
+				#2004, Huichao Science & Technology Building, Jinhai Road, Xixiang
+				Shenzhen  Guangdong  18000
+				CN
+
+F0-AC-D7   (hex)		IEEE Registration Authority
+F0ACD7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-95-A0   (hex)		Google, Inc.
+9495A0     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+00-A6-CA   (hex)		Cisco Systems, Inc
+00A6CA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-D5-47   (hex)		ASUSTek COMPUTER INC.
+38D547     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+FC-83-C6   (hex)		N-Radio Technologies Co., Ltd.
+FC83C6     (base 16)		N-Radio Technologies Co., Ltd.
+				2#, 7F, Satellite Buiding, Keyuan Road, Nanshan
+				ShenZhen  GuangDong  518000
+				CN
+
+30-B6-4F   (hex)		Juniper Networks
+30B64F     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+1C-9D-3E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+1C9D3E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+F0-2F-A7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F02FA7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-DE-D7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+18DED7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-3D-D4   (hex)		CyberTAN Technology Inc.
+C83DD4     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+E0-B9-4D   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+E0B94D     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+D8-45-2B   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+D8452B     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+E4-18-6B   (hex)		Zyxel Communications Corporation
+E4186B     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-87-31   (hex)		Cisco Systems, Inc
+008731     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+88-DE-A9   (hex)		Roku, Inc.
+88DEA9     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga  CA  95070
+				US
+
+78-88-8A   (hex)		CDR Sp. z o.o. Sp. k.
+78888A     (base 16)		CDR Sp. z o.o. Sp. k.
+				Palki 15
+				Zory    44-240
+				PL
+
+00-21-D1   (hex)		Samsung Electronics Co.,Ltd
+0021D1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1F-CC   (hex)		Samsung Electronics Co.,Ltd
+001FCC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-29-83   (hex)		Boeing Defence Australia
+A42983     (base 16)		Boeing Defence Australia
+				GPO Box 767
+				Brisbane  Queensland  4001
+				AU
+
+EC-88-92   (hex)		Motorola Mobility LLC, a Lenovo Company
+EC8892     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+74-87-A9   (hex)		OCT Technology Co., Ltd.
+7487A9     (base 16)		OCT Technology Co., Ltd.
+				8F. -2, No. 94, Baojhong Rd. Sindian Dist.
+				New Taipei City    231
+				TW
+
+00-4A-77   (hex)		zte corporation
+004A77     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A4-14-37   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+A41437     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+60-A1-0A   (hex)		Samsung Electronics Co.,Ltd
+60A10A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-71-F8   (hex)		Samsung Electronics Co.,Ltd
+8C71F8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-05-1B   (hex)		Samsung Electronics Co.,Ltd
+CC051B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-77-12   (hex)		Samsung Electronics Co.,Ltd
+8C7712     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-63-D1   (hex)		Samsung Electronics Co.,Ltd
+9463D1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-21-D2   (hex)		Samsung Electronics Co.,Ltd
+0021D2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+5C-49-7D   (hex)		Samsung Electronics Co.,Ltd
+5C497D     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+98-23-4E   (hex)		Micromedia AG
+98234E     (base 16)		Micromedia AG
+				Gartenweg 46
+				Buonas  Zug  6343
+				CH
+
+50-3F-98   (hex)		CMITECH
+503F98     (base 16)		CMITECH
+				904-ho, 25, Simin-daero 248beon-gil, Dongan-gu
+				Anyang-si  Gyeonggi-do  14067
+				KR
+
+78-20-79   (hex)		ID Tech
+782079     (base 16)		ID Tech
+				10721 Walker St
+				Cypress  CA  90630
+				US
+
+0C-60-76   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0C6076     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+0C-EE-E6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0CEEE6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+E4-D5-3D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+E4D53D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C0-14-3D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C0143D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C0-18-85   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C01885     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-74-9C   (hex)		Ruijie Networks Co.,LTD
+00749C     (base 16)		Ruijie Networks Co.,LTD
+				19# Building,Star-net Science Plaza,Juyuanzhou, 618 Jinshan Road
+				Fuzhou  Fujian  350002
+				CN
+
+58-94-CF   (hex)		Vertex Standard LMR, Inc.
+5894CF     (base 16)		Vertex Standard LMR, Inc.
+				4-8-8 Nakameguro 
+				Meguro-ku   Tokyo  153-8644
+				JP
+
+20-F8-5E   (hex)		Delta Electronics
+20F85E     (base 16)		Delta Electronics
+				252 Shangying Road
+				Taoyuan County  Taiwan  33341
+				TW
+
+78-25-AD   (hex)		Samsung Electronics Co.,Ltd
+7825AD     (base 16)		Samsung Electronics Co.,Ltd
+				416, MAETAN-3DONG, PALDAL-GU
+				SUWON CITY  KYUNGKI-DO  442-742
+				KR
+
+EC-E0-9B   (hex)		Samsung Electronics Co.,Ltd
+ECE09B     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu,
+				Suwon-City  Gyeonggi-do  443-742
+				KR
+
+00-23-E4   (hex)		IPnect co. ltd.
+0023E4     (base 16)		IPnect co. ltd.
+				808 albatross B/D 237-18
+				Seoul    153-801
+				KR
+
+70-D4-F2   (hex)		RIM
+70D4F2     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+78-D6-F0   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+78D6F0     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				Metan Dong 314, Youngtong Gu
+				Suwon  Kyung-gi Do.  443-743
+				KR
+
+BC-20-A4   (hex)		Samsung Electronics Co.,Ltd
+BC20A4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-D4-2B   (hex)		Samsung Electronics Co.,Ltd
+08D42B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-9E-D0   (hex)		Samsung Electronics Co.,Ltd
+789ED0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-C4-E7   (hex)		Samsung Electronics Co.,Ltd
+B0C4E7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-07-98   (hex)		Samsung Electronics Co.,Ltd
+A00798     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1F-CD   (hex)		Samsung Electronics Co.,Ltd
+001FCD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+38-EC-E4   (hex)		Samsung Electronics Co.,Ltd
+38ECE4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-51-03   (hex)		Samsung Electronics Co.,Ltd
+945103     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-24-90   (hex)		Samsung Electronics Co.,Ltd
+002490     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-23-D7   (hex)		Samsung Electronics Co.,Ltd
+0023D7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-9B-12   (hex)		Samsung Electronics Co.,Ltd
+549B12     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-A1-3E   (hex)		Samsung Electronics Co.,Ltd
+FCA13E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-C6-96   (hex)		Samsung Electronics Co.,Ltd
+24C696     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-D7-71   (hex)		Samsung Electronics Co.,Ltd
+94D771     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E8-4E-84   (hex)		Samsung Electronics Co.,Ltd
+E84E84     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-16-32   (hex)		Samsung Electronics Co.,Ltd
+001632     (base 16)		Samsung Electronics Co.,Ltd
+				416, METAN-3DONG,
+				SUWON  KYUNGKI-DO  442-742
+				KR
+
+E4-E0-C5   (hex)		Samsung Electronics Co.,Ltd
+E4E0C5     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon  Gyeonggi-do  443742
+				KR
+
+C8-14-79   (hex)		Samsung Electronics Co.,Ltd
+C81479     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-AF-05   (hex)		Samsung Electronics Co.,Ltd
+1CAF05     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-16-DB   (hex)		Samsung Electronics Co.,Ltd
+0016DB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+00-1E-E2   (hex)		Samsung Electronics Co.,Ltd
+001EE2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-D5-BF   (hex)		Samsung Electronics Co.,Ltd
+20D5BF     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3dong, Yeongtong-Gu
+				Suwon  Gyeonggi-Do  443742
+				KR
+
+5C-E8-EB   (hex)		Samsung Electronics Co.,Ltd
+5CE8EB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-BD-D1   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+C0BDD1     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+B4-79-A7   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+B479A7     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+7C-11-CB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C11CB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-25-E1   (hex)		China Mobile IOT Company Limited
+1C25E1     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+C0-F6-36   (hex)		Hangzhou Kuaiyue Technologies, Ltd.
+C0F636     (base 16)		Hangzhou Kuaiyue Technologies, Ltd.
+				Dongguan Hitech Park, Building 1-805, 288 Qiuyi Rd, Bingjiang District
+				Hangzhou  Zhejiang  310053
+				CN
+
+00-1A-22   (hex)		eQ-3 Entwicklung GmbH
+001A22     (base 16)		eQ-3 Entwicklung GmbH
+				Maiburger Str. 36
+				Leer  Niedersachsen  D-26789
+				DE
+
+B0-DF-3A   (hex)		Samsung Electronics Co.,Ltd
+B0DF3A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-57-19   (hex)		Samsung Electronics Co.,Ltd
+805719     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-BE-00   (hex)		Samsung Electronics Co.,Ltd
+34BE00     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-E2-E0   (hex)		ARRIS Group, Inc.
+54E2E0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+34-7A-60   (hex)		ARRIS Group, Inc.
+347A60     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1C-C3   (hex)		ARRIS Group, Inc.
+001CC3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+24-0D-C2   (hex)		TCT mobile ltd
+240DC2     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+78-52-1A   (hex)		Samsung Electronics Co.,Ltd
+78521A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-85-C6   (hex)		ARRIS Group, Inc.
+7085C6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+20-BB-C6   (hex)		Jabil Circuit Hungary Ltd.
+20BBC6     (base 16)		Jabil Circuit Hungary Ltd.
+				Huszár Andor 1.
+				Tiszaújváros    H-3580
+				HU
+
+04-FE-A1   (hex)		Fihonest communication co.,Ltd
+04FEA1     (base 16)		Fihonest communication co.,Ltd
+				Room902,Park road,Zhixing business-building
+				Dongguan  Guangdong  523560
+				CN
+
+EC-8C-A2   (hex)		Ruckus Wireless
+EC8CA2     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+B8-00-18   (hex)		Htel
+B80018     (base 16)		Htel
+				Dunchon-dearo, Jungwon-gu
+				Seongnam-si  Gyeonggi-do  13229
+				KR
+
+74-72-B0   (hex)		Guangzhou Shiyuan Electronics Co., Ltd. 
+7472B0     (base 16)		Guangzhou Shiyuan Electronics Co., Ltd. 
+				No.6, 4th Yunpu Road, Yunpu Industry District
+				Guangzhou  Guangdong  510530
+				CN
+
+54-6C-0E   (hex)		Texas Instruments
+546C0E     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+EC-8E-AE   (hex)		Nagravision SA
+EC8EAE     (base 16)		Nagravision SA
+				Route de Geneve 22-24, PO 7980
+				Cheseaux  Vaud  1033
+				CH
+
+A0-43-DB   (hex)		Sitael S.p.A.
+A043DB     (base 16)		Sitael S.p.A.
+				Via San Sabino, 21
+				Mola di Bari  BA  70042
+				IT
+
+E0-E7-BB   (hex)		Nureva, Inc.
+E0E7BB     (base 16)		Nureva, Inc.
+				1000, 1221 8th Street SW
+				Calgary  AB  T2R 0L4
+				CA
+
+00-80-8C   (hex)		NetAlly
+00808C     (base 16)		NetAlly
+				310 Littleton Road
+				Westford  MA  01886 
+				US
+
+04-9F-81   (hex)		NetAlly
+049F81     (base 16)		NetAlly
+				310 Littleton Road
+				Westford  MA  01886 
+				US
+
+00-10-87   (hex)		XSTREAMIS PLC
+001087     (base 16)		XSTREAMIS PLC
+				OXFORD SCIENCE PARK
+				OXFORD 0X4 4GA    00000
+				US
+
+00-B0-B3   (hex)		XSTREAMIS PLC
+00B0B3     (base 16)		XSTREAMIS PLC
+				Magdalen Centre
+				Oxford 0X4 4GA    0000
+				GB
+
+04-9F-CA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+049FCA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-01-6B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+50016B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-48-2D   (hex)		Ralinwi Nanjing Electronic Technology Co., Ltd.
+AC482D     (base 16)		Ralinwi Nanjing Electronic Technology Co., Ltd.
+				3rd Floor, Building B,R&D Block 3, Xuzhuang Software Park, No. 699-27, Xuanwu Avenue
+				Nanjing  Jiangsu  210046
+				CN
+
+00-23-63   (hex)		Zhuhai Raysharp Technology Co.,Ltd
+002363     (base 16)		Zhuhai Raysharp Technology Co.,Ltd
+				No.119 of Huawei Road, Qianshan Science & Technology Park,
+				Zhuhai  Guangdong  519070
+				CN
+
+00-00-1B   (hex)		Novell, Inc.
+00001B     (base 16)		Novell, Inc.
+				122 EAST 1700 SOUTH
+				PROVO  UT  84606
+				US
+
+00-90-58   (hex)		Ultra Electronics Command & Control Systems
+009058     (base 16)		Ultra Electronics Command & Control Systems
+				Knaves Beech Business Centre
+				Hemel Hemstead  Herts England  HP2 7BW
+				GB
+
+00-1C-FD   (hex)		Universal Electronics, Inc.
+001CFD     (base 16)		Universal Electronics, Inc.
+				6101 Gateway Drive
+				Cypress    90630
+				US
+
+08-00-87   (hex)		Xyplex, Inc.
+080087     (base 16)		Xyplex, Inc.
+				295 FOSTER STREET
+				LITTLETON  MA  01460
+				US
+
+DC-1A-01   (hex)		Ecoliv Technology ( Shenzhen ) Ltd.
+DC1A01     (base 16)		Ecoliv Technology ( Shenzhen ) Ltd.
+				B-734, Tianhui building, Longhua Street, Pine Road, Longhua District
+				Shenzhen  Guangdong  518109
+				CN
+
+00-54-9F   (hex)		Avaya Inc
+00549F     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+28-24-FF   (hex)		Wistron Neweb Corporation
+2824FF     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+38-25-6B   (hex)		Microsoft Mobile Oy
+38256B     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+00-1C-EF   (hex)		Primax Electronics Ltd.
+001CEF     (base 16)		Primax Electronics Ltd.
+				669, Ruey Kuang Road, Neihu
+				Taipei    114
+				TW
+
+00-02-76   (hex)		Primax Electronics Ltd.
+000276     (base 16)		Primax Electronics Ltd.
+				No. 669, Ruey Kuang Road, Neihu
+				Taipei  Taiwan,  R.O.C.
+				TW
+
+4C-B2-1C   (hex)		Maxphotonics Co.,Ltd
+4CB21C     (base 16)		Maxphotonics Co.,Ltd
+				Maxphotonics Industrial Park,Third Furong Road,Furong Industrial Area,Shajing,BaoAn
+				ShenZhen  GuangDong  518125
+				CN
+
+20-5E-F7   (hex)		Samsung Electronics Co.,Ltd
+205EF7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-1F-78   (hex)		Samsung Electronics Co.,Ltd
+141F78     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-47-10   (hex)		Sichuan Changhong Electric Ltd.
+D84710     (base 16)		Sichuan Changhong Electric Ltd.
+				35 East Mianxing Road,High-Tech Park,
+				MianYang  SiChuan  621000
+				CN
+
+00-19-72   (hex)		Plexus (Xiamen) Co.,ltd.
+001972     (base 16)		Plexus (Xiamen) Co.,ltd.
+				No.6 Xiangxing 2 Road
+				Xiamen  Fujian  361006
+				CN
+
+00-23-47   (hex)		ProCurve Networking by HP
+002347     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+00-24-A8   (hex)		ProCurve Networking by HP
+0024A8     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+C0-91-34   (hex)		ProCurve Networking by HP
+C09134     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+00-19-69   (hex)		Nortel Networks
+001969     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-18-B0   (hex)		Nortel Networks
+0018B0     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-16-CA   (hex)		Nortel Networks
+0016CA     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0F-CD   (hex)		Nortel Networks
+000FCD     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1B-BA   (hex)		Nortel Networks
+001BBA     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-04-DC   (hex)		Nortel Networks
+0004DC     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0C-F7   (hex)		Nortel Networks
+000CF7     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-14-0E   (hex)		Nortel Networks
+00140E     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1E-1F   (hex)		Nortel Networks
+001E1F     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+20-3A-EF   (hex)		Sivantos GmbH
+203AEF     (base 16)		Sivantos GmbH
+				Henri-Dunant-Strasse 100
+				Erlangen  Bavaria  91058
+				DE
+
+00-59-79   (hex)		Networked Energy Services
+005979     (base 16)		Networked Energy Services
+				5215 Hellyer Avenue
+				San Jose  CA  95138
+				US
+
+20-7C-8F   (hex)		Quanta Microsystems,Inc.
+207C8F     (base 16)		Quanta Microsystems,Inc.
+				No.5 Lane 91,Dongmei Rd.
+				Hsinchu    300
+				TW
+
+00-0B-34   (hex)		ShangHai Broadband Technologies CO.LTD
+000B34     (base 16)		ShangHai Broadband Technologies CO.LTD
+				17F,No.122,HuangXing Road
+				ShangHai    200090
+				CN
+
+74-B5-7E   (hex)		zte corporation
+74B57E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B8-BB-23   (hex)		Guangdong Nufront CSC Co., Ltd
+B8BB23     (base 16)		Guangdong Nufront CSC Co., Ltd
+				A403-414, Building 13, No.232 Waihuan East Road, Higher           Education Mega Center, Guangdong 510006, China
+				Guangzhou  Guangdong  510006
+				CN
+
+34-EA-34   (hex)		HangZhou Gubei Electronics Technology Co.,Ltd
+34EA34     (base 16)		HangZhou Gubei Electronics Technology Co.,Ltd
+				Room 106, No.611 Jianghong Road, Binjiang District, Hangzhou, Zhejiang, China
+				Hangzhou  ZheJiang  310052
+				CN
+
+30-92-F6   (hex)		SHANGHAI SUNMON COMMUNICATION TECHNOGY CO.,LTD
+3092F6     (base 16)		SHANGHAI SUNMON COMMUNICATION TECHNOGY CO.,LTD
+				Suite 604-605,Xing Yuan Technology Plaza 
+				00000  ShangHai  200233
+				CN
+
+A8-AD-3D   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+A8AD3D     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+24-AF-4A   (hex)		Alcatel-Lucent IPD
+24AF4A     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+7C-20-64   (hex)		Alcatel-Lucent IPD
+7C2064     (base 16)		Alcatel-Lucent IPD
+				600 March Drive
+				Kanata  Ontario  K2K2E6
+				CA
+
+44-DC-91   (hex)		PLANEX COMMUNICATIONS INC.
+44DC91     (base 16)		PLANEX COMMUNICATIONS INC.
+				2F F-NISSAY Ebisu Bldg 3-16-3 Higashi, 
+				Shibuya-ku  Tokyo  150-0011
+				JP
+
+E0-9D-B8   (hex)		PLANEX COMMUNICATIONS INC.
+E09DB8     (base 16)		PLANEX COMMUNICATIONS INC.
+				Planex Volta Bldg., 2-11-9 Ebisu-Nishi,Shibuya-ku,
+				00000    1500021
+				US
+
+00-0F-59   (hex)		Phonak AG
+000F59     (base 16)		Phonak AG
+				Länggasse 17
+				Murten  FR  3280
+				CH
+
+00-14-78   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+001478     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				3/F,Bldg.R1-B,Hi-tech Industrial Park,
+				ShenZhen  GuangDong  518057
+				CN
+
+48-F8-E1   (hex)		Nokia
+48F8E1     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+8C-90-D3   (hex)		Nokia
+8C90D3     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-28-F8   (hex)		Intel Corporate
+0028F8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+58-BC-8F   (hex)		Cognitive Systems Corp.
+58BC8F     (base 16)		Cognitive Systems Corp.
+				560 Westmount Road North
+				Waterloo  Ontario  N2L 0A9
+				CA
+
+D4-55-BE   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+D455BE     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+64-0D-CE   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+640DCE     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+54-D2-72   (hex)		Nuki Home Solutions GmbH
+54D272     (base 16)		Nuki Home Solutions GmbH
+				Muenzgrabenstrasse 92
+				Graz    8010
+				AT
+
+EC-26-FB   (hex)		TECC CO.,LTD.
+EC26FB     (base 16)		TECC CO.,LTD.
+				Guam-ro 15-gil, Buk-gu
+				Daegu    720-849
+				KR
+
+00-20-F4   (hex)		SPECTRIX CORPORATION
+0020F4     (base 16)		SPECTRIX CORPORATION
+				106 WILMOT ROAD, SUITE 250
+				DEERFIELD  IL  60015-5150
+				US
+
+04-EE-91   (hex)		x-fabric GmbH
+04EE91     (base 16)		x-fabric GmbH
+				Nachodstraße 7
+				Berlin    10779
+				DE
+
+B4-74-43   (hex)		Samsung Electronics Co.,Ltd
+B47443     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-F6-47   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+FCF647     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+18-68-6A   (hex)		zte corporation
+18686A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C4-4B-D1   (hex)		Wallys Communications  Teachnologies Co.,Ltd.
+C44BD1     (base 16)		Wallys Communications  Teachnologies Co.,Ltd.
+				5-207, DongHong Pioneer Park, #99 YangYu Lane,
+				SuZhou  JiangSu  215000
+				CN
+
+6C-B9-C5   (hex)		Delta Networks, Inc.
+6CB9C5     (base 16)		Delta Networks, Inc.
+				256 Yang Guang Street, Neihu
+				Taipei  Taiwan  11491
+				TW
+
+30-76-6F   (hex)		LG Electronics (Mobile Communications)
+30766F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+A8-92-2C   (hex)		LG Electronics (Mobile Communications)
+A8922C     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F8-0C-F3   (hex)		LG Electronics (Mobile Communications)
+F80CF3     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+C4-9A-02   (hex)		LG Electronics (Mobile Communications)
+C49A02     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-1F-6B   (hex)		LG Electronics (Mobile Communications)
+001F6B     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-26-E2   (hex)		LG Electronics (Mobile Communications)
+0026E2     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+DC-44-27   (hex)		IEEE Registration Authority
+DC4427     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+BC-34-00   (hex)		IEEE Registration Authority
+BC3400     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E8-88-6C   (hex)		Shenzhen SC Technologies Co.,LTD
+E8886C     (base 16)		Shenzhen SC Technologies Co.,LTD
+				4/FL,2Block,LianChuang Industrial Park,Bulan Road,Longgang
+				Shenzhen   Guangdong Province  518112
+				CN
+
+00-24-FF   (hex)		QLogic Corporation
+0024FF     (base 16)		QLogic Corporation
+				26650 Aliso Viejo Parkway
+				Aliso Viejo  CA  92656
+				US
+
+00-1E-21   (hex)		Qisda Corporation
+001E21     (base 16)		Qisda Corporation
+				157 Shan-Ying Road, Gueishan
+				Taoyuan    333
+				TW
+
+00-03-9D   (hex)		Qisda Corporation
+00039D     (base 16)		Qisda Corporation
+				157 Shan Ying Road
+				GueiShan  Taoyuan  333
+				TW
+
+00-08-0D   (hex)		Toshiba
+00080D     (base 16)		Toshiba
+				2-9, Suehiro-cho,
+				Tokyo    198-8710
+				JP
+
+00-0E-7B   (hex)		Toshiba
+000E7B     (base 16)		Toshiba
+				2-9, Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+00-03-B2   (hex)		Radware
+0003B2     (base 16)		Radware
+				8 Hamrpe Hochvim
+				000    0000
+				IL
+
+9C-61-21   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+9C6121     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+00-A0-C6   (hex)		Qualcomm Inc.
+00A0C6     (base 16)		Qualcomm Inc.
+				6455 LUSK BLVD
+				SAN DIEGO  CA  92121
+				US
+
+64-9C-81   (hex)		Qualcomm Inc.
+649C81     (base 16)		Qualcomm Inc.
+				5665 Morehouse Drive
+				San Diego  CA  92071
+				US
+
+00-1A-6A   (hex)		Tranzas, Inc.
+001A6A     (base 16)		Tranzas, Inc.
+				Queens tower C17
+				Yokohama  Kanagawa-ken  220-6217
+				JP
+
+A4-71-74   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A47174     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-CB-52   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4CB52     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B8-08-D7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B808D7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-61-1E   (hex)		Wata Electronics Co.,Ltd. 
+94611E     (base 16)		Wata Electronics Co.,Ltd. 
+				No 142,South Tanshen Road, Tanzhou Town,Zhongshan City,Guangdong,China
+				Zhongshan  Guangdong  528467
+				CN
+
+00-C0-E4   (hex)		SIEMENS BUILDING
+00C0E4     (base 16)		SIEMENS BUILDING
+				TECHNOLOGIES, INC.
+				BUFFALO GROVE  IL  60089
+				US
+
+00-0D-10   (hex)		Embedtronics Oy
+000D10     (base 16)		Embedtronics Oy
+				Leväsentie 23
+				Kuopio    70780
+				FI
+
+00-1F-A8   (hex)		Smart Energy Instruments Inc.
+001FA8     (base 16)		Smart Energy Instruments Inc.
+				297 Lakeshore Road East
+				Oakville  Ontario  L6J 1J3
+				CA
+
+00-0F-DB   (hex)		Westell Technologies Inc.
+000FDB     (base 16)		Westell Technologies Inc.
+				750 N Commons Dr
+				Aurora  IL  60504
+				US
+
+3C-07-71   (hex)		Sony Corporation
+3C0771     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+80-41-4E   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+80414E     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+24-94-42   (hex)		OPEN ROAD SOLUTIONS , INC.
+249442     (base 16)		OPEN ROAD SOLUTIONS , INC.
+				88-13 SHUILI  ROAD
+				HSINCHU    30059
+				TW
+
+C4-64-13   (hex)		Cisco Systems, Inc
+C46413     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-10-CA   (hex)		Telco Systems, Inc. 
+0010CA     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield,  MA  02048
+				US
+
+00-E0-9E   (hex)		Quantum Corporation
+00E09E     (base 16)		Quantum Corporation
+				500 McCarthy Boulevard
+				Milpitas  CA  95035
+				US
+
+00-0A-08   (hex)		Alpine Electronics, Inc.
+000A08     (base 16)		Alpine Electronics, Inc.
+				20-1 Yoshima-Kogyodanchi
+				iwaki-city  Fukushima  970-1192
+				JP
+
+20-6A-8A   (hex)		Wistron Infocomm (Zhongshan) Corporation
+206A8A     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				168# First Avenue,Kunshan Export Processing Zone
+				Kunshan  Jiangsu  215300
+				CN
+
+78-44-76   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+784476     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				A1&A2 building,lantian technology park, xinyu road, xingqiao henggang block, shajing street, Baoan District
+				shenzhen  guangdong  518000
+				CN
+
+00-11-65   (hex)		ZNYX Networks, Inc.
+001165     (base 16)		ZNYX Networks, Inc.
+				48421 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-0A-68   (hex)		Solarflare Communications Inc.
+000A68     (base 16)		Solarflare Communications Inc.
+				Suite 100, 7505 Irvine Center Drive
+				Irvine  CA  92618
+				US
+
+00-21-86   (hex)		Universal Global Scientific Industrial Co., Ltd.
+002186     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Sec.1, Taiping Road,
+				NANTOU    54261
+				TW
+
+18-39-19   (hex)		Unicoi Systems
+183919     (base 16)		Unicoi Systems
+				410 Peachtree Pkwy
+				Cumming  GA  30041
+				US
+
+E8-E0-B7   (hex)		Toshiba
+E8E0B7     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+68-07-15   (hex)		Intel Corporate
+680715     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+3C-B6-B7   (hex)		vivo Mobile Communication Co., Ltd.
+3CB6B7     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong  523860
+				CN
+
+C4-27-95   (hex)		Technicolor CH USA Inc.
+C42795     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+A0-20-A6   (hex)		Espressif Inc.
+A020A6     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+58-52-8A   (hex)		Mitsubishi Electric Corporation
+58528A     (base 16)		Mitsubishi Electric Corporation
+				2-7-3 Marunouchi Chiyoda-ku
+				Tokyo    100-8310
+				JP
+
+C4-F1-D1   (hex)		BEIJING SOGOU TECHNOLOGY DEVELOPMENT CO., LTD.
+C4F1D1     (base 16)		BEIJING SOGOU TECHNOLOGY DEVELOPMENT CO., LTD.
+				SOHU.COM INTERNET PLAZA, NO.1 PARK, ZHONGGUANCHUN EAST ROAD. HAIDIAN DISTRICT
+				Beijing    100000
+				CN
+
+AC-E7-7B   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+ACE77B     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+2C-36-A0   (hex)		Capisco Limited
+2C36A0     (base 16)		Capisco Limited
+				PO Box 938
+				Auckland    0943
+				NZ
+
+B0-B2-DC   (hex)		Zyxel Communications Corporation
+B0B2DC     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+CC-5D-4E   (hex)		Zyxel Communications Corporation
+CC5D4E     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+40-4A-03   (hex)		Zyxel Communications Corporation
+404A03     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+C8-6C-87   (hex)		Zyxel Communications Corporation
+C86C87     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-1E-C0   (hex)		Microchip Technology Inc.
+001EC0     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+64-5D-92   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+645D92     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road, Chengdu, Sichuan
+				Chengdu  Sichuan  610000
+				CN
+
+38-BC-1A   (hex)		MEIZU Technology Co., Ltd.
+38BC1A     (base 16)		MEIZU Technology Co., Ltd.
+				MEIZU Tech Bldg., Technology & Innovation Coast
+				Zhuhai  Guangdong  519085
+				CN
+
+80-29-94   (hex)		Technicolor CH USA Inc.
+802994     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+E0-88-5D   (hex)		Technicolor CH USA Inc.
+E0885D     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+34-0A-FF   (hex)		Qingdao Hisense Communications Co.,Ltd.
+340AFF     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+58-7E-61   (hex)		Qingdao Hisense Communications Co.,Ltd.
+587E61     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+C0-A1-A2   (hex)		MarqMetrix
+C0A1A2     (base 16)		MarqMetrix
+				410 West Harrison ST #200
+				Seattle  WA  98119
+				US
+
+08-D0-B7   (hex)		Qingdao Hisense Communications Co.,Ltd.
+08D0B7     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+EC-D6-8A   (hex)		Shenzhen JMicron Intelligent Technology Developmen
+ECD68A     (base 16)		Shenzhen JMicron Intelligent Technology Developmen
+				Futian District, 13th Floor , Block B Building Tai
+				Shenzhen  Guangdong Province  518040
+				CN
+
+50-52-D2   (hex)		Hangzhou Telin Technologies Co., Limited
+5052D2     (base 16)		Hangzhou Telin Technologies Co., Limited
+				8 floor,D Building,Paradise Software Park,No. 3 Xidoumen Road, Xihu District, Hangzhou
+				Hangzhou  Zhejiang  310013
+				CN
+
+90-EE-D9   (hex)		UNIVERSAL DE DESARROLLOS ELECTRÓNICOS, SA
+90EED9     (base 16)		UNIVERSAL DE DESARROLLOS ELECTRÓNICOS, SA
+				CRTA DE CASTELLAR, 298
+				TERRASSA  BARCELONA  08226
+				ES
+
+60-64-53   (hex)		AOD Co.,Ltd.
+606453     (base 16)		AOD Co.,Ltd.
+				No. 13155, Yuqing Street, High-Technology Development Zone,
+				Weifang  Shandong  261061
+				CN
+
+6C-98-EB   (hex)		Riverbed Technology, Inc.
+6C98EB     (base 16)		Riverbed Technology, Inc.
+				 680 Folsom St.
+				San Francisco  CA  94107
+				US
+
+00-9E-1E   (hex)		Cisco Systems, Inc
+009E1E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-3E   (hex)		Sensus Metering Systems
+00253E     (base 16)		Sensus Metering Systems
+				10147 W. Emerald Street
+				Boise  Idaho  83704
+				US
+
+C8-AF-E3   (hex)		Hefei Radio Communication Technology Co., Ltd 
+C8AFE3     (base 16)		Hefei Radio Communication Technology Co., Ltd 
+				 No.108, YinXing Road, High-tech Development Zone 
+				Hefei  Anhui  230088
+				CN
+
+CC-A2-60   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+CCA260     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+7C-57-4E   (hex)		COBI GmbH
+7C574E     (base 16)		COBI GmbH
+				Solmsstrasse 4
+				Frankfurt am Main    60486
+				DE
+
+28-F1-0E   (hex)		Dell Inc.
+28F10E     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+04-56-04   (hex)		Gionee Communication Equipment Co.,Ltd.
+045604     (base 16)		Gionee Communication Equipment Co.,Ltd.
+				21/F,Times Technology Building,No. 7028,Shennan Avenue,Futian District
+				Shenzhen    518000
+				CN
+
+34-C0-F9   (hex)		Rockwell Automation
+34C0F9     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+00-FE-C8   (hex)		Cisco Systems, Inc
+00FEC8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-5A-8D   (hex)		SYSTRONIK Elektronik u. Systemtechnik GmbH
+2C5A8D     (base 16)		SYSTRONIK Elektronik u. Systemtechnik GmbH
+				Gewerbestrasse 57
+				ILLMENSEE    88636
+				DE
+
+10-BE-F5   (hex)		D-Link International
+10BEF5     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+E4-7B-3F   (hex)		BEIJING CO-CLOUD TECHNOLOGY LTD.
+E47B3F     (base 16)		BEIJING CO-CLOUD TECHNOLOGY LTD.
+				903 Room，Power Create E ，No.1 Shangdi East Road
+				Beijing  Beijing  100085
+				CN
+
+0C-8A-87   (hex)		AgLogica Holdings, Inc
+0C8A87     (base 16)		AgLogica Holdings, Inc
+				333 Research Ct NW Ste 230
+				Norcross  GA  30092
+				US
+
+54-ED-A3   (hex)		Navdy, Inc.
+54EDA3     (base 16)		Navdy, Inc.
+				575 7th Street
+				San Francisco  CA  94103
+				US
+
+40-F4-20   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+40F420     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+34-A2-A2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+34A2A2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-9D-8F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+749D8F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-59-07   (hex)		Shanghai HITE-BELDEN Network Technology Co., Ltd.
+945907     (base 16)		Shanghai HITE-BELDEN Network Technology Co., Ltd.
+				No. 777, Xinjun Ring Road, Pujiang Hi-Tech Park, Minhang District
+				Shanghai  Shanghai  201114
+				CN
+
+00-18-48   (hex)		Vecima Networks Inc.
+001848     (base 16)		Vecima Networks Inc.
+				150 Cardinal Place
+				Saskatoon  SK  S7L 6H7
+				CA
+
+00-16-FB   (hex)		SHENZHEN MTC CO LTD
+0016FB     (base 16)		SHENZHEN MTC CO LTD
+				5/F BenYuan Bldg,6015 ShenNan Road
+				ShenZhen  GuangDong  518040
+				CN
+
+A0-41-5E   (hex)		Opsens Solution Inc.
+A0415E     (base 16)		Opsens Solution Inc.
+				2014 rue Cyrille-Duquet, suite 125
+				Quebec  QC  G1N 4N6
+				CA
+
+A8-60-B6   (hex)		Apple, Inc.
+A860B6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-B3-01   (hex)		Apple, Inc.
+C4B301     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-5F-45   (hex)		Apple, Inc.
+E05F45     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-CC-39   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+74CC39     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+38-22-D6   (hex)		Hangzhou H3C Technologies Co., Limited
+3822D6     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+94-E8-C5   (hex)		ARRIS Group, Inc.
+94E8C5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+6C-3B-6B   (hex)		Routerboard.com
+6C3B6B     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+00-22-E7   (hex)		WPS Parking Systems
+0022E7     (base 16)		WPS Parking Systems
+				Hoevenweg 11
+				Eindhoven  Noord-Brabant  5652 AW
+				NL
+
+48-51-B7   (hex)		Intel Corporate
+4851B7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B8-E7-79   (hex)		9Solutions Oy
+B8E779     (base 16)		9Solutions Oy
+				Teknologiantie 2
+				Oulu    90590
+				FI
+
+C8-64-C7   (hex)		zte corporation
+C864C7     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+48-3B-38   (hex)		Apple, Inc.
+483B38     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-91-48   (hex)		Apple, Inc.
+1C9148     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-5F-2E   (hex)		TCT mobile ltd
+905F2E     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+F8-23-B2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F823B2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-12-90   (hex)		Treeview Co.,Ltd.
+341290     (base 16)		Treeview Co.,Ltd.
+				106/29 BANGLAMUNG
+				BANGLAMUNG  CHONBURI  20150
+				TH
+
+7C-FE-4E   (hex)		Shenzhen Safe vision Technology Co.,LTD
+7CFE4E     (base 16)		Shenzhen Safe vision Technology Co.,LTD
+				Shenzhen ring view south road and 27 digital dragon industrial park industrial zone
+				shenzhen  Guangdong province  518110
+				CN
+
+64-4F-B0   (hex)		Hyunjin.com
+644FB0     (base 16)		Hyunjin.com
+				 Hyochang-dong 5-86, Yongsan-gu
+				Seoul    140-896
+				KR
+
+00-E0-E6   (hex)		INCAA Computers
+00E0E6     (base 16)		INCAA Computers
+				P.O. BOX 211
+				7300 AE APELDOORN    na
+				NL
+
+28-F3-66   (hex)		Shenzhen Bilian electronic CO.,LTD
+28F366     (base 16)		Shenzhen Bilian electronic CO.,LTD
+				NO 268，Fuqian Rd,Jutang Community,Guanlan town , LongHua new district,Shenzhen,518110,China.
+				Shenzhen    518110
+				CN
+
+E0-A3-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E0A3AC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-75-74   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC7574     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-A6-80   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20A680     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-28-B3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8828B3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-E5-97   (hex)		Gessler GmbH
+A4E597     (base 16)		Gessler GmbH
+				Gutenbergring 14
+				Rodgau    63110
+				DE
+
+00-6C-BC   (hex)		Cisco Systems, Inc
+006CBC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+5C-70-A3   (hex)		LG Electronics (Mobile Communications)
+5C70A3     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-1D-08   (hex)		Jiangsu Yinhe  Electronics Co.,Ltd.
+001D08     (base 16)		Jiangsu Yinhe  Electronics Co.,Ltd.
+				188 NANHUAN ROAD
+				ZHANGJIAGANG  JIANGSU  215611
+				CN
+
+00-1D-82   (hex)		GN Netcom A/S
+001D82     (base 16)		GN Netcom A/S
+				Lautrupbjerg 7
+				Ballerup    DK - 2750
+				DK
+
+00-13-17   (hex)		GN Netcom A/S
+001317     (base 16)		GN Netcom A/S
+				Metalbuen 66
+				Ballerup  Skovlunde  DK-2750
+				DK
+
+00-A0-A4   (hex)		Oracle Corporation 
+00A0A4     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+74-97-81   (hex)		zte corporation
+749781     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-01-F4   (hex)		Enterasys
+0001F4     (base 16)		Enterasys
+				35 Industrial Way
+				Rochester  NH  03867
+				US
+
+00-10-9B   (hex)		Emulex Corporation
+00109B     (base 16)		Emulex Corporation
+				3333 Susan Street
+				Costa Mesa  CA  92626
+				US
+
+00-14-2A   (hex)		Elitegroup Computer Systems Co.,Ltd.
+00142A     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22, Alley 38, Lane 91, Sec. 1,
+				Taipei    114
+				TW
+
+00-11-5B   (hex)		Elitegroup Computer Systems Co.,Ltd.
+00115B     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22, Alley 38, Lane 91, Sec. 1, Nei Hu
+				Taipei    114
+				TW
+
+C0-3F-D5   (hex)		Elitegroup Computer Systems Co.,Ltd.
+C03FD5     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No. 239, Sec. 2, Ti-Ding Blvd
+				Taipei    11493
+				TW
+
+EC-A8-6B   (hex)		Elitegroup Computer Systems Co.,Ltd.
+ECA86B     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO. 239, Sec. 2, Ti Ding Blvd.
+				Taipei    11493
+				TW
+
+C8-9C-DC   (hex)		Elitegroup Computer Systems Co.,Ltd.
+C89CDC     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO. 239, Sec. 2, Ti Ding Blvd.
+				Taipei    11493
+				TW
+
+00-25-11   (hex)		Elitegroup Computer Systems Co.,Ltd.
+002511     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO. 239, Sec. 2, Ti Ding Blvd.
+				Taipei  Taiwan  11493
+				TW
+
+44-87-FC   (hex)		Elitegroup Computer Systems Co.,Ltd.
+4487FC     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO. 239, Sec. 2, Ti Ding Blvd.
+				Taipei  Taiwan  11493
+				TW
+
+A8-6B-AD   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+A86BAD     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+D8-0F-99   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D80F99     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+B4-B1-5A   (hex)		Siemens AG Energy Management Division
+B4B15A     (base 16)		Siemens AG Energy Management Division
+				Humboldtstr. 59
+				Nurnberg  Bavaria  90459
+				DE
+
+00-24-65   (hex)		Elentec
+002465     (base 16)		Elentec
+				401-13 Chunggye-Ri,Dongtan-Myun
+				Hwasung  Kyunggi  445-811
+				KR
+
+00-08-9F   (hex)		EFM Networks
+00089F     (base 16)		EFM Networks
+				403, 4th floor Elegance 1 Bldg.
+				Sungnam-si  Kyunggi-do  463-808
+				KR
+
+00-50-FC   (hex)		Edimax Technology Co. Ltd.
+0050FC     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+9C-DF-03   (hex)		Harman/Becker Automotive Systems GmbH
+9CDF03     (base 16)		Harman/Becker Automotive Systems GmbH
+				Becker-Göring-Straße 16
+				Karlsbad  Baden-Württemberg  76307
+				DE
+
+00-11-88   (hex)		Enterasys
+001188     (base 16)		Enterasys
+				35 Industrial Way
+				Rochester  NH  03867
+				US
+
+00-16-FA   (hex)		ECI Telecom Ltd.
+0016FA     (base 16)		ECI Telecom Ltd.
+				30 Hasivim St.
+				Petah Tikva    49133
+				US
+
+F8-A1-88   (hex)		LED Roadway Lighting
+F8A188     (base 16)		LED Roadway Lighting
+				115 Chain Lake Dr.
+				Halifax  NS  B3S 1B3
+				CA
+
+A0-82-AC   (hex)		Linear DMS Solutions Sdn. Bhd.
+A082AC     (base 16)		Linear DMS Solutions Sdn. Bhd.
+				135, Jalan Utara
+				PENANG  Pulau Pinang  11700
+				MY
+
+A8-6A-C1   (hex)		HanbitEDS Co., Ltd.
+A86AC1     (base 16)		HanbitEDS Co., Ltd.
+				44-10, Techno 10-ro, Yuseong-gu
+				Daejeon  Daejeon  34027
+				KR
+
+D4-63-FE   (hex)		Arcadyan Corporation
+D463FE     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+68-93-61   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+689361     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+BC-15-AC   (hex)		Vodafone Italia S.p.A.
+BC15AC     (base 16)		Vodafone Italia S.p.A.
+				Via Lorenteggio nr. 240
+				Milan  Italy  20147
+				IT
+
+00-BD-82   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+00BD82     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+94-51-3D   (hex)		iSmart Alarm, Inc.
+94513D     (base 16)		iSmart Alarm, Inc.
+				1290 Kifer Road Suite 306
+				Sunnyvale  CA  94086
+				US
+
+00-11-74   (hex)		 Mojo Networks, Inc.
+001174     (base 16)		 Mojo Networks, Inc.
+				339 N.Bernardo Ave
+				Mountain View  CA  94043
+				US
+
+00-19-54   (hex)		Leaf Corporation.
+001954     (base 16)		Leaf Corporation.
+				Amuze 1F
+				Isehara City  Kanagawa-Pref.  259-1117
+				JP
+
+94-66-E7   (hex)		WOM Engineering
+9466E7     (base 16)		WOM Engineering
+				13F., No. 192, Sec. 2, Zhongxing Rd., Xindian Dist.
+				New Taipei City  Taiwan  231
+				TW
+
+4C-B8-B5   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+4CB8B5     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+70-85-C2   (hex)		ASRock Incorporation
+7085C2     (base 16)		ASRock Incorporation
+				2F., No. 37, Sec. 2, Jhongyang S. Rd., Beitou District,
+				Taipei    112
+				TW
+
+EC-93-ED   (hex)		DDoS-Guard LTD
+EC93ED     (base 16)		DDoS-Guard LTD
+				goroda Volos, 6, 904
+				Rostov-on-Don    344010
+				RU
+
+30-FC-68   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+30FC68     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-8A-96   (hex)		Cisco Systems, Inc
+008A96     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-60-A7   (hex)		Sony Interactive Entertainment Inc.
+BC60A7     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+80-8C-97   (hex)		Kaonmedia CO., LTD.
+808C97     (base 16)		Kaonmedia CO., LTD.
+				884-3, Seongnam-daero, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13517
+				KR
+
+DC-EE-06   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DCEE06     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-52-C7   (hex)		Bose Corporation
+0452C7     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+F0-27-45   (hex)		F-Secure Corporation
+F02745     (base 16)		F-Secure Corporation
+				Tammasaarenkatu 7
+				Helsinki    00181
+				FI
+
+54-D0-B4   (hex)		Xiamen Four-Faith Communication Technology Co.,Ltd
+54D0B4     (base 16)		Xiamen Four-Faith Communication Technology Co.,Ltd
+				3rd Floor,No,44,GuanRi Road,Software Park,XiaMen
+				XiaMen  Fujian  361000
+				CN
+
+00-13-7C   (hex)		Kaicom co., Ltd.
+00137C     (base 16)		Kaicom co., Ltd.
+				#109, Gayang Techno Town 1487, Gayang-dong,Kangso-gu
+				Seoul    157-810
+				KR
+
+E8-56-59   (hex)		Advanced-Connectek Inc.
+E85659     (base 16)		Advanced-Connectek Inc.
+				No. 2,Alley 9, Lane 45, Baoxing Rd., Xiadian Dist.,
+				New Taipei City    231
+				TW
+
+34-BF-90   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+34BF90     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+CC-B3-F8   (hex)		FUJITSU ISOTEC LIMITED
+CCB3F8     (base 16)		FUJITSU ISOTEC LIMITED
+				135,Higashinozaki,Hobara-machi,
+				Date-shi  Fukushima  960-0695
+				JP
+
+E4-A4-71   (hex)		Intel Corporate
+E4A471     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-F0-05   (hex)		Intel Corporate
+10F005     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+64-CC-2E   (hex)		Xiaomi Communications Co Ltd
+64CC2E     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+88-01-F2   (hex)		Vitec System Engineering Inc.
+8801F2     (base 16)		Vitec System Engineering Inc.
+				203203 Kita-shinagawa
+				Shinagawa-ku  Tokyo  140-0001
+				JP
+
+14-D1-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14D11F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+DC-09-4C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC094C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-67-58   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C6758     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-BC-F8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24BCF8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-04-3E   (hex)		Parker Hannifin Manufacturing Germany GmbH & Co. KG
+A0043E     (base 16)		Parker Hannifin Manufacturing Germany GmbH & Co. KG
+				Gutenbergstrasse 38
+				Kaarst  Select State  41564
+				DE
+
+C8-45-29   (hex)		IMK Networks Co.,Ltd
+C84529     (base 16)		IMK Networks Co.,Ltd
+				201-Ho jungribjunja, 16-3bunji, 
+				Seoul    143-816
+				KR
+
+7C-47-7C   (hex)		IEEE Registration Authority
+7C477C     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-77-B8   (hex)		Samsung Electronics Co.,Ltd
+F877B8     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+F0-D2-F1   (hex)		Amazon Technologies Inc.
+F0D2F1     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+A8-E3-EE   (hex)		Sony Interactive Entertainment Inc.
+A8E3EE     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+00-24-8D   (hex)		Sony Interactive Entertainment Inc.
+00248D     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+00-04-1F   (hex)		Sony Interactive Entertainment Inc.
+00041F     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+20-A9-0E   (hex)		TCT mobile ltd
+20A90E     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+EC-43-8B   (hex)		YAPTV
+EC438B     (base 16)		YAPTV
+				623 GangNamDa-Ro
+				Seocho-Gu  Seoul  06524
+				KR
+
+98-0C-A5   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+980CA5     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+44-11-02   (hex)		EDMI  Europe Ltd
+441102     (base 16)		EDMI  Europe Ltd
+				The Grainger  Suite, Dobson House
+				Newcastle upon Tyne    NE3 3PF
+				GB
+
+A8-5E-E4   (hex)		12Sided Technology, LLC
+A85EE4     (base 16)		12Sided Technology, LLC
+				1 Penn Plaza, 36th Floor
+				New York  NY  10119
+				US
+
+18-21-95   (hex)		Samsung Electronics Co.,Ltd
+182195     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-78-3E   (hex)		Samsung Electronics Co.,Ltd
+44783E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-A2-F4   (hex)		Chameleon Technology (UK) Limited
+0CA2F4     (base 16)		Chameleon Technology (UK) Limited
+				Gardner House,  Hornbeam Park Avenue
+				Hornbeam Park  Harrogate  HG2 8NA
+				GB
+
+BC-44-B0   (hex)		Elastifile
+BC44B0     (base 16)		Elastifile
+				Abba Even 8
+				Herzlia    4672526
+				IL
+
+74-BF-B7   (hex)		Nusoft Corporation
+74BFB7     (base 16)		Nusoft Corporation
+				3F.-1, No. 880, Zhongzheng Rd.,
+				Zhonghe Dist., New Taipei City  Taiwan (R.O.C.)   235-86
+				TW
+
+50-DA-00   (hex)		Hangzhou H3C Technologies Co., Limited
+50DA00     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+F4-ED-5F   (hex)		SHENZHEN KTC TECHNOLOGY GROUP 
+F4ED5F     (base 16)		SHENZHEN KTC TECHNOLOGY GROUP 
+				Wuhe Street
+				Shenzhen  Guangdong  518129
+				CN
+
+00-E0-E4   (hex)		FANUC ROBOTICS NORTH AMERICA, Inc.
+00E0E4     (base 16)		FANUC ROBOTICS NORTH AMERICA, Inc.
+				3900 W. HAMLIN RD.
+				ROCHESTER HILLS  MI  48309-3253
+				US
+
+00-08-96   (hex)		Printronix, Inc.
+000896     (base 16)		Printronix, Inc.
+				14600 Myford Rd.
+				Irvine  California  92623-9559
+				US
+
+24-5E-BE   (hex)		QNAP Systems, Inc.
+245EBE     (base 16)		QNAP Systems, Inc.
+				2F., No.22, Zhongxing Rd., Xizhi Dist.
+				New Taipei City    221
+				TW
+
+04-04-EA   (hex)		Valens Semiconductor Ltd.
+0404EA     (base 16)		Valens Semiconductor Ltd.
+				8 Hanagar Street
+				Hod Hasharon  Hod Hasharon  4501309
+				IL
+
+80-0D-D7   (hex)		Latticework, Inc
+800DD7     (base 16)		Latticework, Inc
+				2210 O'Toole Ave, Suite 250
+				San Jose  CA  95131
+				US
+
+D0-B5-3D   (hex)		SEPRO ROBOTIQUE
+D0B53D     (base 16)		SEPRO ROBOTIQUE
+				ZI Acti-Est Les Ajoncs
+				LA ROCHE SUR YON    F85003
+				FR
+
+00-D0-EC   (hex)		NAKAYO Inc
+00D0EC     (base 16)		NAKAYO Inc
+				Development Support Center 165 Higashiomuro-machi
+				Maebashi-shi  Gunma  379-2105
+				JP
+
+4C-CC-6A   (hex)		Micro-Star INTL CO., LTD.
+4CCC6A     (base 16)		Micro-Star INTL CO., LTD.
+				No.69, Lide St.,
+				New Taipei City  Taiwan  235
+				TW
+
+30-63-6B   (hex)		Apple, Inc.
+30636B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-88-4D   (hex)		JAPAN RADIO CO., LTD.
+70884D     (base 16)		JAPAN RADIO CO., LTD.
+				5-1-1 SHIMORENJYAKU,
+				MITAKA-SHI, TOKYO    181-8510
+				JP
+
+A4-F1-E8   (hex)		Apple, Inc.
+A4F1E8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-67-51   (hex)		Compal Broadband Networks, Inc.
+546751     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+24-0B-0A   (hex)		Palo Alto Networks
+240B0A     (base 16)		Palo Alto Networks
+				4401 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+D0-99-D5   (hex)		Alcatel-Lucent
+D099D5     (base 16)		Alcatel-Lucent
+				777 East Middlefield Road
+				Mountain View  CA  94043
+				US
+
+14-C3-C2   (hex)		K.A. Schmersal GmbH & Co. KG
+14C3C2     (base 16)		K.A. Schmersal GmbH & Co. KG
+				Möddinghofe 30
+				Wuppertal  NRW  42279
+				DE
+
+10-78-5B   (hex)		Actiontec Electronics, Inc
+10785B     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+DC-00-77   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+DC0077     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+F4-F5-A5   (hex)		Nokia Corporation
+F4F5A5     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo    24101
+				FI
+
+EC-9B-5B   (hex)		Nokia Corporation
+EC9B5B     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+2C-CC-15   (hex)		Nokia Corporation
+2CCC15     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+14-BB-6E   (hex)		Samsung Electronics Co.,Ltd
+14BB6E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+18-86-AC   (hex)		Nokia Danmark A/S
+1886AC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1F-5C   (hex)		Nokia Danmark A/S
+001F5C     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1F-00   (hex)		Nokia Danmark A/S
+001F00     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-25-47   (hex)		Nokia Danmark A/S
+002547     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-18-C5   (hex)		Nokia Danmark A/S
+0018C5     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    1790
+				DK
+
+00-16-4E   (hex)		Nokia Danmark A/S
+00164E     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-26-68   (hex)		Nokia Danmark A/S
+002668     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-24-7D   (hex)		Nokia Danmark A/S
+00247D     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-22-65   (hex)		Nokia Danmark A/S
+002265     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+F8-80-96   (hex)		Elsys Equipamentos Eletrônicos Ltda
+F88096     (base 16)		Elsys Equipamentos Eletrônicos Ltda
+				Rod. Visconde de Porto Seguro, n.º 2.660, Sitio Recreio dos Cafezais
+				Valinhos  SP  13278327
+				BR
+
+A8-11-FC   (hex)		ARRIS Group, Inc.
+A811FC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-AA   (hex)		DrayTek Corp.
+001DAA     (base 16)		DrayTek Corp.
+				No. 26, Fu-Shing Road
+				Hsin-Chu    303
+				TW
+
+E4-98-D1   (hex)		Microsoft Mobile Oy
+E498D1     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				ESPOO    02150
+				FI
+
+6C-27-79   (hex)		Microsoft Mobile Oy
+6C2779     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				ESPOO    02150
+				FI
+
+00-CF-1C   (hex)		Communication Machinery Corporation
+00CF1C     (base 16)		Communication Machinery Corporation
+				1226 ANACAPA
+				SANTA BARBARA  CA  93101
+				US
+
+28-CC-01   (hex)		Samsung Electronics Co.,Ltd
+28CC01     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-FB-5E   (hex)		ASKEY COMPUTER CORP
+D8FB5E     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+00-23-26   (hex)		FUJITSU LIMITED
+002326     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+0C-BF-15   (hex)		Genetec Inc.
+0CBF15     (base 16)		Genetec Inc.
+				2280 boul Alfred-Nobel
+				St. Laurent  Quebec  H4S 2A4
+				CA
+
+00-0D-4B   (hex)		Roku, Inc.
+000D4B     (base 16)		Roku, Inc.
+				399 Sherman Ave. #12
+				Palo Alto  CA  94306
+				US
+
+00-40-FB   (hex)		CASCADE COMMUNICATIONS
+0040FB     (base 16)		CASCADE COMMUNICATIONS
+				PRODUCTION QUALITY ENGINEER
+				WESTFORD  MA  01886
+				US
+
+D0-54-2D   (hex)		Cambridge Industries(Group) Co.,Ltd.
+D0542D     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22 Floor,Qilai Tower;889 Yishan Road
+				Shanghai    200233
+				CN
+
+74-4A-A4   (hex)		zte corporation
+744AA4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-1B-A9   (hex)		Brother industries, LTD.
+001BA9     (base 16)		Brother industries, LTD.
+				Printing & Solutions Company, Development Management Dept.
+				Nagoya  Aichi  467-8561
+				JP
+
+30-A2-20   (hex)		ARG Telecom
+30A220     (base 16)		ARG Telecom
+				No.69, W. Lavasani St. ,
+				Tehran  Tehran  1936938194
+				IR
+
+6C-F3-73   (hex)		Samsung Electronics Co.,Ltd
+6CF373     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-3A-AF   (hex)		Samsung Electronics Co.,Ltd
+9C3AAF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-1F-DB   (hex)		Samsung Electronics Co.,Ltd
+781FDB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+4C-A5-6D   (hex)		Samsung Electronics Co.,Ltd
+4CA56D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-6C-E8   (hex)		Samsung Electronics Co.,Ltd
+B86CE8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-B3-19   (hex)		Samsung Electronics Co.,Ltd
+0CB319     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-3F-47   (hex)		Samsung Electronics Co.,Ltd
+183F47     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-62-93   (hex)		Samsung Electronics Co.,Ltd
+B46293     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-A4-C8   (hex)		Samsung Electronics Co.,Ltd
+50A4C8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-00-1D   (hex)		Cabletron Systems, Inc.
+00001D     (base 16)		Cabletron Systems, Inc.
+				35 INDUSTRIAL WAY
+				ROCHESTER  NH  03867
+				US
+
+18-67-B0   (hex)		Samsung Electronics Co.,Ltd
+1867B0     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+6C-83-36   (hex)		Samsung Electronics Co.,Ltd
+6C8336     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-D8-7C   (hex)		Beijing Jingdong Century Trading Co., LTD.
+DCD87C     (base 16)		Beijing Jingdong Century Trading Co., LTD.
+				28F,Building A Zhaolin Plaza,NO.19,Ronghua Middle road,BDA Beijing
+				Beijing    100176
+				CN
+
+C4-DA-7D   (hex)		Ivium Technologies B.V.
+C4DA7D     (base 16)		Ivium Technologies B.V.
+				De Zaale 11
+				Eindhoven  Noord Brabant  5612 AJ
+				NL
+
+00-0B-6A   (hex)		Asiarock Technology Limited
+000B6A     (base 16)		Asiarock Technology Limited
+				P.O. Box957, Offshore Incorporations Cen
+				Road Town  Tortola  12345
+				VG
+
+00-90-96   (hex)		ASKEY COMPUTER CORP
+009096     (base 16)		ASKEY COMPUTER CORP
+				2F, NO. 2, LANE 497
+				TAIPEI  23136    12345
+				TW
+
+00-1B-9E   (hex)		ASKEY COMPUTER CORP
+001B9E     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,
+				CHUNG-HO,TPIPEI    235
+				TW
+
+E0-CA-94   (hex)		ASKEY COMPUTER CORP
+E0CA94     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,CHUNG-HO,TAIPEI,
+				TAIWAN  TAIPEI  235
+				TW
+
+00-26-B6   (hex)		ASKEY COMPUTER CORP
+0026B6     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,CHUNG-HO,TAIPEI,
+				TAIWAN  TAIPEI  235
+				TW
+
+00-25-57   (hex)		BlackBerry RTS
+002557     (base 16)		BlackBerry RTS
+				440 Phillip Street
+				Waterloo  Ontario  N2L 5W9
+				CA
+
+00-1C-CC   (hex)		BlackBerry RTS
+001CCC     (base 16)		BlackBerry RTS
+				305 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+00-30-0A   (hex)		Aztech Electronics Pte Ltd
+00300A     (base 16)		Aztech Electronics Pte Ltd
+				31 UBI ROAD 1
+				singapore    408694
+				SG
+
+00-1F-3F   (hex)		AVM GmbH
+001F3F     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+24-65-11   (hex)		AVM GmbH
+246511     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+C0-FF-D4   (hex)		NETGEAR
+C0FFD4     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+6C-B0-CE   (hex)		NETGEAR
+6CB0CE     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-8E-F2   (hex)		NETGEAR
+008EF2     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+9C-D3-6D   (hex)		NETGEAR
+9CD36D     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+C4-04-15   (hex)		NETGEAR
+C40415     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+E8-FC-AF   (hex)		NETGEAR
+E8FCAF     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+84-1B-5E   (hex)		NETGEAR
+841B5E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+2C-B0-5D   (hex)		NETGEAR
+2CB05D     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+A0-21-B7   (hex)		NETGEAR
+A021B7     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-24-B2   (hex)		NETGEAR
+0024B2     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-1B-2F   (hex)		NETGEAR
+001B2F     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-26-4D   (hex)		Arcadyan Technology Corporation
+00264D     (base 16)		Arcadyan Technology Corporation
+				4F., No. 9 , Park Avenue II ,
+				Hsinchu  Taiwan  300
+				TW
+
+84-9C-A6   (hex)		Arcadyan Technology Corporation
+849CA6     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+E0-3E-44   (hex)		Broadcom
+E03E44     (base 16)		Broadcom
+				190 Mathilda Place
+				Sunnyvale  CA  94086
+				US
+
+00-1F-33   (hex)		NETGEAR
+001F33     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-20-40   (hex)		ARRIS Group, Inc.
+002040     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+38-6B-BB   (hex)		ARRIS Group, Inc.
+386BBB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-6D-52   (hex)		ARRIS Group, Inc.
+E86D52     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-75-4A   (hex)		ARRIS Group, Inc.
+3C754A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E4-83-99   (hex)		ARRIS Group, Inc.
+E48399     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-21-43   (hex)		ARRIS Group, Inc.
+002143     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+74-F6-12   (hex)		ARRIS Group, Inc.
+74F612     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-24-95   (hex)		ARRIS Group, Inc.
+002495     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-24-A0   (hex)		ARRIS Group, Inc.
+0024A0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-08-0E   (hex)		ARRIS Group, Inc.
+00080E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-90-9C   (hex)		ARRIS Group, Inc.
+00909C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-12-25   (hex)		ARRIS Group, Inc.
+001225     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+14-5B-D1   (hex)		ARRIS Group, Inc.
+145BD1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+6C-C1-D2   (hex)		ARRIS Group, Inc.
+6CC1D2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-14-48   (hex)		ARRIS Group, Inc.
+1C1448     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-17-84   (hex)		ARRIS Group, Inc.
+001784     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1C-11   (hex)		ARRIS Group, Inc.
+001C11     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1E-46   (hex)		ARRIS Group, Inc.
+001E46     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-18-A4   (hex)		ARRIS Group, Inc.
+0018A4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-18-C0   (hex)		ARRIS Group, Inc.
+0018C0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-74   (hex)		ARRIS Group, Inc.
+002374     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+AC-E0-10   (hex)		Liteon Technology Corporation
+ACE010     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road, ChungHo
+				New Taipei City  Taiwan  23585
+				TW
+
+74-75-48   (hex)		Amazon Technologies Inc.
+747548     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-00-B1   (hex)		Alpha Micro
+0000B1     (base 16)		Alpha Micro
+				3501 SUNFLOWER
+				SANTA ANA  CA  92704
+				US
+
+00-18-02   (hex)		Alpha Networks Inc.
+001802     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing Seventh Road,Science-based Industrial Park
+				Hsinchu    300
+				TW
+
+00-1E-45   (hex)		Sony Mobile Communications Inc
+001E45     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-1C-A4   (hex)		Sony Mobile Communications Inc
+001CA4     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-1A-75   (hex)		Sony Mobile Communications Inc
+001A75     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+78-84-3C   (hex)		Sony Corporation
+78843C     (base 16)		Sony Corporation
+				Gotenyama Tec,5-1-12,
+				Shinagawa-ku  Tokyo  141-0001
+				JP
+
+00-13-A9   (hex)		Sony Corporation
+0013A9     (base 16)		Sony Corporation
+				Gotenyama Tec, 5-1-2 Kitashinagawa
+				Tokyo    141-0001
+				JP
+
+00-0A-D9   (hex)		Sony Mobile Communications Inc
+000AD9     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-0E-07   (hex)		Sony Mobile Communications Inc
+000E07     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+94-CE-2C   (hex)		Sony Mobile Communications Inc
+94CE2C     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+FC-0F-E6   (hex)		Sony Interactive Entertainment Inc.
+FC0FE6     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+74-DE-2B   (hex)		Liteon Technology Corporation
+74DE2B     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+00-22-5F   (hex)		Liteon Technology Corporation
+00225F     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+5C-93-A2   (hex)		Liteon Technology Corporation
+5C93A2     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road, ChungHo, TaiPei Hsien
+				TaiPei  TaiWan  23585
+				TW
+
+24-FD-52   (hex)		Liteon Technology Corporation
+24FD52     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+2C-D0-5A   (hex)		Liteon Technology Corporation
+2CD05A     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+74-E5-43   (hex)		Liteon Technology Corporation
+74E543     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+00-15-CF   (hex)		ARRIS Group, Inc.
+0015CF     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+6C-FA-A7   (hex)		AMPAK Technology, Inc.
+6CFAA7     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road
+				Hsinchu    30352
+				TW
+
+00-23-F1   (hex)		Sony Mobile Communications Inc
+0023F1     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+54-E4-BD   (hex)		FN-LINK TECHNOLOGY LIMITED
+54E4BD     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				5th Floor, A Building, Haoye Logistics Park, Shugang Channel, Bao'an District,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+54-14-FD   (hex)		Orbbec 3D Technology International
+5414FD     (base 16)		Orbbec 3D Technology International
+				950 Stephenson Hwy Suite 208
+				Troy  MI  48083
+				US
+
+90-0B-C1   (hex)		Sprocomm Technologies CO.,Ltd
+900BC1     (base 16)		Sprocomm Technologies CO.,Ltd
+				5D-506 F1.6 Block,Tianfa Building,Tianan Chegongmiao Industrial Park,Futian Dist,Shenzhen China
+				Shenzhen  Guangdong  518000
+				CN
+
+00-1C-A8   (hex)		AirTies Wireless Networks
+001CA8     (base 16)		AirTies Wireless Networks
+				Gulbahar Mahallesi, Avni Diligil Sokak
+				ISTANBUL  ISTANBUL  34394
+				TR
+
+48-5D-60   (hex)		AzureWave Technology Inc.
+485D60     (base 16)		AzureWave Technology Inc.
+				8F ., No.94, Baozhong Rd. 
+				Xindian City  Taipei County  231 
+				TW
+
+DC-85-DE   (hex)		AzureWave Technology Inc.
+DC85DE     (base 16)		AzureWave Technology Inc.
+				8F ., No.94, Baozhong RD, Sindian, 
+				New Taipei City    231
+				TW
+
+B0-EE-45   (hex)		AzureWave Technology Inc.
+B0EE45     (base 16)		AzureWave Technology Inc.
+				8F ., No.94, Baozhong Rd. , Xindian Dist., 
+				New Taipei City    231
+				US
+
+00-23-8E   (hex)		ADB Broadband Italia
+00238E     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+00-1D-8B   (hex)		ADB Broadband Italia
+001D8B     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+00-13-C8   (hex)		ADB Broadband Italia
+0013C8     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+DC-0B-1A   (hex)		ADB Broadband Italia
+DC0B1A     (base 16)		ADB Broadband Italia
+				via Sarca 222
+				Milano    20126
+				IT
+
+0C-6A-E6   (hex)		Stanley Security Solutions
+0C6AE6     (base 16)		Stanley Security Solutions
+				6161 East 75th Street
+				Indianapolis  IN  46250
+				US
+
+84-26-15   (hex)		ADB Broadband Italia
+842615     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				IT
+
+F0-84-2F   (hex)		ADB Broadband Italia
+F0842F     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				IT
+
+54-27-1E   (hex)		AzureWave Technology Inc.
+54271E     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City    231
+				TW
+
+28-C2-DD   (hex)		AzureWave Technology Inc.
+28C2DD     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.,
+				New Taipei City  Taiwan  231
+				TW
+
+80-A5-89   (hex)		AzureWave Technology Inc.
+80A589     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.,
+				New Taipei City  Taiwan  231
+				TW
+
+C4-09-38   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+C40938     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building,,Star-net Science Plaza
+				Fuzhou  Fujian  350002
+				CN
+
+00-1C-50   (hex)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+001C50     (base 16)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+				10/F, Block A , TCL Tower
+				Shenzhen  Guangdong  518057
+				CN
+
+00-AA-02   (hex)		Intel Corporation
+00AA02     (base 16)		Intel Corporation
+				445
+				piscataway  NJ  08554
+				US
+
+AC-E5-F0   (hex)		Doppler Labs
+ACE5F0     (base 16)		Doppler Labs
+				611 Broadway Suite 523
+				New York  NY  10012
+				US
+
+F4-8E-38   (hex)		Dell Inc.
+F48E38     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+74-C6-3B   (hex)		AzureWave Technology Inc.
+74C63B     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+7C-7A-91   (hex)		Intel Corporate
+7C7A91     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+AC-7B-A1   (hex)		Intel Corporate
+AC7BA1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+6C-29-95   (hex)		Intel Corporate
+6C2995     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+98-4F-EE   (hex)		Intel Corporate
+984FEE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+E8-2A-EA   (hex)		Intel Corporate
+E82AEA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+60-57-18   (hex)		Intel Corporate
+605718     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+C4-D9-87   (hex)		Intel Corporate
+C4D987     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+FC-F8-AE   (hex)		Intel Corporate
+FCF8AE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+60-36-DD   (hex)		Intel Corporate
+6036DD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-0B-A9   (hex)		Intel Corporate
+100BA9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+8C-70-5A   (hex)		Intel Corporate
+8C705A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+60-67-20   (hex)		Intel Corporate
+606720     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+7C-5C-F8   (hex)		Intel Corporate
+7C5CF8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B4-E1-C4   (hex)		Microsoft Mobile Oy
+B4E1C4     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+E0-75-7D   (hex)		Motorola Mobility LLC, a Lenovo Company
+E0757D     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+34-BB-26   (hex)		Motorola Mobility LLC, a Lenovo Company
+34BB26     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+80-6C-1B   (hex)		Motorola Mobility LLC, a Lenovo Company
+806C1B     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+00-16-EB   (hex)		Intel Corporate
+0016EB     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-18-DE   (hex)		Intel Corporate
+0018DE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+5C-E0-C5   (hex)		Intel Corporate
+5CE0C5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+58-A8-39   (hex)		Intel Corporate
+58A839     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1E-67   (hex)		Intel Corporate
+001E67     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-22-FA   (hex)		Intel Corporate
+0022FA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-15-00   (hex)		Intel Corporate
+001500     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A0-88-B4   (hex)		Intel Corporate
+A088B4     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+64-80-99   (hex)		Intel Corporate
+648099     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+D0-7E-35   (hex)		Intel Corporate
+D07E35     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1E-65   (hex)		Intel Corporate
+001E65     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+34-84-46   (hex)		Ericsson AB
+348446     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+04-4E-06   (hex)		Ericsson AB
+044E06     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+00-27-0E   (hex)		Intel Corporate
+00270E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-26-B9   (hex)		Dell Inc.
+0026B9     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+64-00-6A   (hex)		Dell Inc.
+64006A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-D0-9E   (hex)		2Wire Inc
+00D09E     (base 16)		2Wire Inc
+				694 TASMAN DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-19-E4   (hex)		2Wire Inc
+0019E4     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  94538
+				US
+
+00-1A-C4   (hex)		2Wire Inc
+001AC4     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  94538
+				US
+
+00-1B-5B   (hex)		2Wire Inc
+001B5B     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  95131
+				US
+
+3C-EA-4F   (hex)		2Wire Inc
+3CEA4F     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+DC-7F-A4   (hex)		2Wire Inc
+DC7FA4     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+B0-D5-CC   (hex)		Texas Instruments
+B0D5CC     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+38-29-DD   (hex)		ONvocal Inc
+3829DD     (base 16)		ONvocal Inc
+				104 Otis Street, Ste 28
+				Northborough  MA  01532
+				US
+
+00-1E-C7   (hex)		2Wire Inc
+001EC7     (base 16)		2Wire Inc
+				1704 Automation Prkwy
+				San Jose    95131
+				US
+
+00-26-50   (hex)		2Wire Inc
+002650     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+00-23-51   (hex)		2Wire Inc
+002351     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+00-1E-4F   (hex)		Dell Inc.
+001E4F     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+5C-26-0A   (hex)		Dell Inc.
+5C260A     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock     78682
+				US
+
+78-45-C4   (hex)		Dell Inc.
+7845C4     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock    78682
+				US
+
+C8-1F-66   (hex)		Dell Inc.
+C81F66     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-15-C5   (hex)		Dell Inc.
+0015C5     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-14-22   (hex)		Dell Inc.
+001422     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+10-98-36   (hex)		Dell Inc.
+109836     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+80-0A-80   (hex)		IEEE Registration Authority
+800A80     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-DB-88   (hex)		Dell Inc.
+F8DB88     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+3C-A3-48   (hex)		vivo Mobile Communication Co., Ltd.
+3CA348     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+E4-5A-A2   (hex)		vivo Mobile Communication Co., Ltd.
+E45AA2     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+CC-3B-3E   (hex)		Lester Electrical
+CC3B3E     (base 16)		Lester Electrical
+				625 W A Street
+				Lincoln  NE  68522
+				US
+
+20-82-C0   (hex)		Xiaomi Communications Co Ltd
+2082C0     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+DC-6D-CD   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+DC6DCD     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+C4-28-2D   (hex)		Embedded Intellect Pty Ltd
+C4282D     (base 16)		Embedded Intellect Pty Ltd
+				Level 32, 101 Miller Street
+				North Sydney  NSW  2060
+				AU
+
+58-46-E1   (hex)		Baxter International Inc
+5846E1     (base 16)		Baxter International Inc
+				One Baxter Parkway
+				Deerfield  IL  60015
+				US
+
+00-17-3F   (hex)		Belkin International Inc.
+00173F     (base 16)		Belkin International Inc.
+				501 West Walnut Street
+				Compton  CA  90220-5221
+				US
+
+00-1C-DF   (hex)		Belkin International Inc.
+001CDF     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+C0-56-27   (hex)		Belkin International Inc.
+C05627     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+4C-17-EB   (hex)		Sagemcom Broadband SAS
+4C17EB     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+CC-33-BB   (hex)		Sagemcom Broadband SAS
+CC33BB     (base 16)		Sagemcom Broadband SAS
+				250 ROUTE DE L'EMPEREUR
+				RUEIL MALMAISON CEDEX  Choisissez l'état / la province  92848
+				FR
+
+D8-6C-E9   (hex)		Sagemcom Broadband SAS
+D86CE9     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+E8-F1-B0   (hex)		Sagemcom Broadband SAS
+E8F1B0     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+5C-6B-32   (hex)		Texas Instruments
+5C6B32     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+84-DD-20   (hex)		Texas Instruments
+84DD20     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-31   (hex)		Texas Instruments
+001831     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+24-FD-5B   (hex)		SmartThings, Inc.
+24FD5B     (base 16)		SmartThings, Inc.
+				456 University Avenue
+				Palo Alto  CA  94301
+				US
+
+28-76-CD   (hex)		Funshion Online Technologies Co.,Ltd
+2876CD     (base 16)		Funshion Online Technologies Co.,Ltd
+				Tower B 1201, Jinqiu International Building, No.6, Zhichun Road, Haidian District
+				Beijing    100088
+				CN
+
+20-55-32   (hex)		Gotech International Technology Limited
+205532     (base 16)		Gotech International Technology Limited
+				Unit 2506, 25/F, Prosperity Place,6 Shing Yip Street, Kwun Tong,  Kowloon
+				Hong Kong    00000
+				CN
+
+2C-FF-65   (hex)		Oki Electric Industry Co., Ltd.
+2CFF65     (base 16)		Oki Electric Industry Co., Ltd.
+				1-7-12 Toranomon
+				Tokyo 105-8460    
+				JP
+
+2C-27-D7   (hex)		Hewlett Packard
+2C27D7     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+98-4B-E1   (hex)		Hewlett Packard
+984BE1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-29-26   (hex)		Applied Optoelectronics, Inc Taiwan Branch
+002926     (base 16)		Applied Optoelectronics, Inc Taiwan Branch
+				No.18,Gong 4th Rd
+				New Taipei City  Linkou District  24452
+				TW
+
+24-BA-13   (hex)		RISO KAGAKU CORPORATION
+24BA13     (base 16)		RISO KAGAKU CORPORATION
+				2-8-1 Gakuen-minami
+				Thukuba-shi  Ibaraki  305-0818
+				JP
+
+00-17-E5   (hex)		Texas Instruments
+0017E5     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-EC   (hex)		Texas Instruments
+0017EC     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-E7   (hex)		Texas Instruments
+0017E7     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-E9   (hex)		Texas Instruments
+0017E9     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+1C-BA-8C   (hex)		Texas Instruments
+1CBA8C     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-15-E9   (hex)		D-Link Corporation
+0015E9     (base 16)		D-Link Corporation
+				2F, No.233-2, Pao-Chiao Road
+				Hsin-Tien,  Taipei  231
+				TW
+
+00-1B-11   (hex)		D-Link Corporation
+001B11     (base 16)		D-Link Corporation
+				NO.289, Sinhu 3rd Rd.,
+				Neihu District,  Taipei City  114
+				TW
+
+00-26-5A   (hex)		D-Link Corporation
+00265A     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd Rd.,
+				Neihu District    114
+				TW
+
+C8-BE-19   (hex)		D-Link International
+C8BE19     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+A4-BA-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4BA76     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+00-50-C2   (hex)		IEEE Registration Authority
+0050C2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+44-00-10   (hex)		Apple, Inc.
+440010     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-56-CD   (hex)		Apple, Inc.
+0056CD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-60-37   (hex)		NXP Semiconductors
+006037     (base 16)		NXP Semiconductors
+				High Tech Campus 32, Office 1.21
+				SAF  AD  13456
+				NL
+
+DC-C0-EB   (hex)		ASSA ABLOY CÔTE PICARDE
+DCC0EB     (base 16)		ASSA ABLOY CÔTE PICARDE
+				rue Alexandre Fichet
+				Oust-Marest    80460
+				FR
+
+28-BC-56   (hex)		EMAC, Inc.
+28BC56     (base 16)		EMAC, Inc.
+				2390 EMAC Way
+				Carbondale  IL  62902
+				US
+
+00-CD-FE   (hex)		Apple, Inc.
+00CDFE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-F8-95   (hex)		Shenzhen TINNO Mobile Technology Corp.
+A0F895     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park.
+				Nanshan District, Shenzhen  GUANGDONG  518053
+				CN
+
+00-78-CD   (hex)		Ignition Design Labs
+0078CD     (base 16)		Ignition Design Labs
+				1550 Technology Drive
+				San Jose    95110
+				US
+
+B4-36-A9   (hex)		Fibocom Wireless Inc. 
+B436A9     (base 16)		Fibocom Wireless Inc. 
+				 5/F,Tower A,Technology Building II,1057# Nanhai Blvd
+				Shenzhen  GuangDong  518000
+				CN
+
+70-CA-4D   (hex)		Shenzhen lnovance Technology Co.,Ltd.
+70CA4D     (base 16)		Shenzhen lnovance Technology Co.,Ltd.
+				LiuXian 2 Road
+				Shenzhen  Guangdong  518000
+				CN
+
+00-1A-11   (hex)		Google, Inc.
+001A11     (base 16)		Google, Inc.
+				1600 Amphitheater Parkway
+				Mountain View  CA  94043
+				US
+
+48-DB-50   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48DB50     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+C8-47-8C   (hex)		Beken Corporation
+C8478C     (base 16)		Beken Corporation
+				Building 41, Capital of Tech Leaders, 1387 Zhangdong Road, Zhangjiang High-Tech Park, Pudong New District
+				Shanghai    201203
+				CN
+
+9C-EF-D5   (hex)		Panda Wireless, Inc.
+9CEFD5     (base 16)		Panda Wireless, Inc.
+				15559 Union Ave, Suite 300
+				Los Gatos  CA  95032
+				US
+
+9C-34-26   (hex)		ARRIS Group, Inc.
+9C3426     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+2C-6E-85   (hex)		Intel Corporate
+2C6E85     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1D-D1   (hex)		ARRIS Group, Inc.
+001DD1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-CF   (hex)		ARRIS Group, Inc.
+001DCF     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-D5   (hex)		ARRIS Group, Inc.
+001DD5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-D4   (hex)		ARRIS Group, Inc.
+001DD4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E4-98-D6   (hex)		Apple, Inc.
+E498D6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-22-83   (hex)		Juniper Networks
+002283     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-10-DB   (hex)		Juniper Networks
+0010DB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-12-1E   (hex)		Juniper Networks
+00121E     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+CC-A4-62   (hex)		ARRIS Group, Inc.
+CCA462     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+48-45-20   (hex)		Intel Corporate
+484520     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+C8-0E-77   (hex)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+C80E77     (base 16)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+				No.201-427,2F,Tthe Animation  Building B1 District£¬No. 126£¬Tianjin eco-city animation Road
+				Tianjin    300467
+				CN
+
+10-6F-3F   (hex)		BUFFALO.INC
+106F3F     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+90-49-FA   (hex)		Intel Corporate
+9049FA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+BC-0F-64   (hex)		Intel Corporate
+BC0F64     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-00-C5   (hex)		ARRIS Group, Inc.
+0000C5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+64-55-B1   (hex)		ARRIS Group, Inc.
+6455B1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-02-B3   (hex)		Intel Corporation
+0002B3     (base 16)		Intel Corporation
+				M/S:  JF3-420
+				Hillsboro  OR  97124
+				US
+
+00-03-47   (hex)		Intel Corporation
+000347     (base 16)		Intel Corporation
+				M/S:  JF3-420
+				Hillsboro  OR  97124
+				US
+
+00-0E-0C   (hex)		Intel Corporation
+000E0C     (base 16)		Intel Corporation
+				2111 NE  25th Avenue
+				Hillsboro  OR  97124
+				US
+
+D8-D3-85   (hex)		Hewlett Packard
+D8D385     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+18-A9-05   (hex)		Hewlett Packard
+18A905     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-1B-78   (hex)		Hewlett Packard
+001B78     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+E4-FA-FD   (hex)		Intel Corporate
+E4FAFD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+94-65-9C   (hex)		Intel Corporate
+94659C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B0-C7-45   (hex)		BUFFALO.INC
+B0C745     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg.,30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref  460-8315
+				JP
+
+14-CF-E2   (hex)		ARRIS Group, Inc.
+14CFE2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-E1-37   (hex)		ARRIS Group, Inc.
+44E137     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-13-20   (hex)		Intel Corporate
+001320     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-80-E1   (hex)		STMicroelectronics SRL
+0080E1     (base 16)		STMicroelectronics SRL
+				1000 AZTEC WEST
+				london    12345
+				GB
+
+F8-DB-7F   (hex)		HTC Corporation
+F8DB7F     (base 16)		HTC Corporation
+				No.23 Xinghua Road
+				Taoyuan County    330
+				TW
+
+64-A7-69   (hex)		HTC Corporation
+64A769     (base 16)		HTC Corporation
+				No.23 Xinghua Road
+				Taoyuan County    330
+				TW
+
+E8-99-C4   (hex)		HTC Corporation
+E899C4     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+BC-CF-CC   (hex)		HTC Corporation
+BCCFCC     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County    330
+				TW
+
+00-04-EA   (hex)		Hewlett Packard
+0004EA     (base 16)		Hewlett Packard
+				MAIL STOP 42LE
+				CUPERTINO  CA  95014
+				US
+
+00-12-79   (hex)		Hewlett Packard
+001279     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-13-21   (hex)		Hewlett Packard
+001321     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-08-02   (hex)		Hewlett Packard
+000802     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-02-A5   (hex)		Hewlett Packard
+0002A5     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-18-71   (hex)		Hewlett Packard
+001871     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-0E-7F   (hex)		Hewlett Packard
+000E7F     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-11-85   (hex)		Hewlett Packard
+001185     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+10-60-4B   (hex)		Hewlett Packard
+10604B     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+C8-CB-B8   (hex)		Hewlett Packard
+C8CBB8     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+84-34-97   (hex)		Hewlett Packard
+843497     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+6C-C2-17   (hex)		Hewlett Packard
+6CC217     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+14-58-D0   (hex)		Hewlett Packard
+1458D0     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+5C-8A-38   (hex)		Hewlett Packard
+5C8A38     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+EC-9A-74   (hex)		Hewlett Packard
+EC9A74     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+2C-59-E5   (hex)		Hewlett Packard
+2C59E5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D8-FC-38   (hex)		Giantec Semiconductor Inc
+D8FC38     (base 16)		Giantec Semiconductor Inc
+				No12, Lane647, Songtao Rd, Zhangjiang Hi-Tech Park
+				Shanghai  Shanghai  201203
+				CN
+
+AC-2A-0C   (hex)		CSR ZHUZHOU INSTITUTE CO.,LTD.
+AC2A0C     (base 16)		CSR ZHUZHOU INSTITUTE CO.,LTD.
+				Times Ave.,Zhuzhou,hunan,China
+				zhuzhou  Hunan  412001
+				CN
+
+2C-67-98   (hex)		InTalTech Ltd.
+2C6798     (base 16)		InTalTech Ltd.
+				Shlomo Ben David 5
+				Rishon LeZion    7536215
+				IL
+
+00-23-4D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00234D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-25-56   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+002556     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+60-18-88   (hex)		zte corporation
+601888     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D8-60-B0   (hex)		bioMérieux Italia S.p.A.
+D860B0     (base 16)		bioMérieux Italia S.p.A.
+				Via di Campigliano, 58
+				Bagno a Ripoli  Firenze  50012
+				IT
+
+54-E6-FC   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+54E6FC     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+74-EA-3A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+74EA3A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518000
+				CN
+
+F8-1A-67   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F81A67     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan
+				shenzhen  guangdong Province  518057
+				CN
+
+EC-17-2F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+EC172F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan
+				shenzhen  guangdong Province  518057
+				CN
+
+84-77-78   (hex)		Cochlear Limited
+847778     (base 16)		Cochlear Limited
+				1 University Avenue
+				Sydney  New South Wales  2109
+				AU
+
+88-7F-03   (hex)		Comper Technology Investment Limited
+887F03     (base 16)		Comper Technology Investment Limited
+				Room 710, Wangjing SOHO Tower 1-B
+				Beijing  Beijing  100102
+				CN
+
+00-19-E0   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0019E0     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				South Building, No.5 Keyuan Road
+				Nanshan  Shenzhen  518057
+				CN
+
+00-25-86   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+002586     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+F4-31-C3   (hex)		Apple, Inc.
+F431C3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-A5-C3   (hex)		Apple, Inc.
+64A5C3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-56-5A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+28565A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+6C-B5-6B   (hex)		HUMAX Co., Ltd.
+6CB56B     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village,216,Hwangsaeul-ro,Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+BC-3A-EA   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+BC3AEA     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN,DONGGUAN,GUANGDONG,CHINA
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+E4-22-A5   (hex)		PLANTRONICS, INC.
+E422A5     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+D4-C9-B2   (hex)		Quanergy Systems Inc
+D4C9B2     (base 16)		Quanergy Systems Inc
+				482 Mercury Drive
+				Sunnyvale  California  94085
+				US
+
+60-21-C0   (hex)		Murata Manufacturing Co., Ltd.
+6021C0     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+88-30-8A   (hex)		Murata Manufacturing Co., Ltd.
+88308A     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+5C-DA-D4   (hex)		Murata Manufacturing Co., Ltd.
+5CDAD4     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+00-26-E8   (hex)		Murata Manufacturing Co., Ltd.
+0026E8     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+00-25-12   (hex)		zte corporation
+002512     (base 16)		zte corporation
+				12/F ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  GUANGDONG  518057
+				CN
+
+00-1C-26   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001C26     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+14-E6-E4   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+14E6E4     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan,
+				Shenzhen  Guangdong Province,  518057
+				CN
+
+34-4B-50   (hex)		zte corporation
+344B50     (base 16)		zte corporation
+				12/F,ZTE R&D Building,Kejinan Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+FC-C8-97   (hex)		zte corporation
+FCC897     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+00-16-CE   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0016CE     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-22-68   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+002268     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-18-82   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+001882     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				F1-20,Section F,Huawei Base,Bantian, Longgang District
+				ShenZhen  GuangDong  518129
+				CN
+
+D4-EA-0E   (hex)		Avaya Inc
+D4EA0E     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+6C-FA-58   (hex)		Avaya Inc
+6CFA58     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+20-F3-A3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20F3A3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+0C-37-DC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C37DC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+BC-76-70   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC7670     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+24-DB-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24DBAC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+1C-1D-67   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C1D67     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+30-0E-D5   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+300ED5     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+48-5A-B6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+485AB6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+54-35-30   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+543530     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+F8-66-D1   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F866D1     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+24-69-A5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2469A5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+EC-23-3D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC233D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+78-F5-FD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+78F5FD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-7D-5E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C7D5E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+90-67-1C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+90671C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-25-E0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC25E0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-E3-FB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4E3FB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-2D-B3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D02DB3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+E8-CD-2D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E8CD2D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+84-A8-E4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+84A8E4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+0C-96-BF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C96BF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-E7-01   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60E701     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-08-8B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E8088B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-51-C6   (hex)		Avaya Inc
+A051C6     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+F0-EB-D0   (hex)		Shanghai Feixun Communication Co.,Ltd.
+F0EBD0     (base 16)		Shanghai Feixun Communication Co.,Ltd.
+				Building 90,No,4855,Guangfulin Road
+				shanghai  Shanghai  201616
+				CN
+
+64-3E-8C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+643E8C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+00-12-D2   (hex)		Texas Instruments
+0012D2     (base 16)		Texas Instruments
+				12500 TI Boulevard
+				Dallas    75243
+				US
+
+A8-63-F2   (hex)		Texas Instruments
+A863F2     (base 16)		Texas Instruments
+				12203 S.W.Freeway, MS728
+				Stafford    77477
+				US
+
+7C-60-97   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C6097     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+CC-53-B5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CC53B5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+60-DE-44   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60DE44     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+10-51-72   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+105172     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+08-E8-4F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+08E84F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+88-86-03   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+888603     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen    518129
+				CN
+
+04-F9-38   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04F938     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+AC-85-3D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC853D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+48-46-FB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4846FB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+D0-FF-50   (hex)		Texas Instruments
+D0FF50     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+20-C3-8F   (hex)		Texas Instruments
+20C38F     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+7C-66-9D   (hex)		Texas Instruments
+7C669D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D8-DD-FD   (hex)		Texas Instruments
+D8DDFD     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D0-5F-B8   (hex)		Texas Instruments
+D05FB8     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+E0-24-7F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E0247F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+00-46-4B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00464B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+80-FB-06   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80FB06     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+6C-A8-49   (hex)		Avaya Inc
+6CA849     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+64-C3-54   (hex)		Avaya Inc
+64C354     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+50-CD-22   (hex)		Avaya Inc
+50CD22     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+B4-A9-5A   (hex)		Avaya Inc
+B4A95A     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+84-EB-18   (hex)		Texas Instruments
+84EB18     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+EC-11-27   (hex)		Texas Instruments
+EC1127     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+58-16-26   (hex)		Avaya Inc
+581626     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-E4-22   (hex)		Cisco Systems, Inc
+70E422     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+00-50-0F   (hex)		Cisco Systems, Inc
+00500F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-1D-D9   (hex)		Xiaomi Communications Co Ltd
+7C1DD9     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+A0-86-C6   (hex)		Xiaomi Communications Co Ltd
+A086C6     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+9C-99-A0   (hex)		Xiaomi Communications Co Ltd
+9C99A0     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+58-44-98   (hex)		Xiaomi Communications Co Ltd
+584498     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-E0-B0   (hex)		Cisco Systems, Inc
+00E0B0     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-FE   (hex)		Cisco Systems, Inc
+00E0FE     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-34   (hex)		Cisco Systems, Inc
+00E034     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-F9   (hex)		Cisco Systems, Inc
+00E0F9     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+C8-D7-19   (hex)		Cisco-Linksys, LLC
+C8D719     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine    92612
+				US
+
+00-10-79   (hex)		Cisco Systems, Inc
+001079     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-29   (hex)		Cisco Systems, Inc
+001029     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-0E-08   (hex)		Cisco-Linksys, LLC
+000E08     (base 16)		Cisco-Linksys, LLC
+				170 West Tasman Dr.
+				San Jose  CA  95134
+				US
+
+44-03-A7   (hex)		Cisco Systems, Inc
+4403A7     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-FA-EB   (hex)		Cisco Systems, Inc
+B0FAEB     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+7C-AD-74   (hex)		Cisco Systems, Inc
+7CAD74     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-60-3E   (hex)		Cisco Systems, Inc
+00603E     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-60-2F   (hex)		Cisco Systems, Inc
+00602F     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-60-47   (hex)		Cisco Systems, Inc
+006047     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-50-A2   (hex)		Cisco Systems, Inc
+0050A2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-3D   (hex)		Cisco Systems, Inc
+00023D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+20-3A-07   (hex)		Cisco Systems, Inc
+203A07     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-50-2A   (hex)		Cisco Systems, Inc
+00502A     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+BC-16-F5   (hex)		Cisco Systems, Inc
+BC16F5     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+FC-5B-39   (hex)		Cisco Systems, Inc
+FC5B39     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+34-6F-90   (hex)		Cisco Systems, Inc
+346F90     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+5C-FC-66   (hex)		Cisco Systems, Inc
+5CFC66     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+D4-6D-50   (hex)		Cisco Systems, Inc
+D46D50     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+74-A0-2F   (hex)		Cisco Systems, Inc
+74A02F     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+88-90-8D   (hex)		Cisco Systems, Inc
+88908D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F0-78-16   (hex)		Cisco Systems, Inc
+F07816     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-22-3A   (hex)		Cisco SPVTG
+00223A     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-21-BE   (hex)		Cisco SPVTG
+0021BE     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+14-DA-E9   (hex)		ASUSTek COMPUTER INC.
+14DAE9     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,
+				Taipei    112
+				TW
+
+F4-CF-E2   (hex)		Cisco Systems, Inc
+F4CFE2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+A8-0C-0D   (hex)		Cisco Systems, Inc
+A80C0D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C0-7B-BC   (hex)		Cisco Systems, Inc
+C07BBC     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+24-E9-B3   (hex)		Cisco Systems, Inc
+24E9B3     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-11-D8   (hex)		ASUSTek COMPUTER INC.
+0011D8     (base 16)		ASUSTek COMPUTER INC.
+				No.150, Li-Te Rd., Peitou
+				Taipei    112
+				TW
+
+C0-8C-60   (hex)		Cisco Systems, Inc
+C08C60     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E8-ED-F3   (hex)		Cisco Systems, Inc
+E8EDF3     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E4-C7-22   (hex)		Cisco Systems, Inc
+E4C722     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+64-E9-50   (hex)		Cisco Systems, Inc
+64E950     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F4-1F-C2   (hex)		Cisco Systems, Inc
+F41FC2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+44-AD-D9   (hex)		Cisco Systems, Inc
+44ADD9     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+0C-68-03   (hex)		Cisco Systems, Inc
+0C6803     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+1C-DE-A7   (hex)		Cisco Systems, Inc
+1CDEA7     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F0-7F-06   (hex)		Cisco Systems, Inc
+F07F06     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+88-F0-31   (hex)		Cisco Systems, Inc
+88F031     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-18-F3   (hex)		ASUSTek COMPUTER INC.
+0018F3     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou
+				Taipei    112
+				TW
+
+00-1A-92   (hex)		ASUSTek COMPUTER INC.
+001A92     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou
+				Taipei    112
+				TW
+
+00-0C-41   (hex)		Cisco-Linksys, LLC
+000C41     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+00-16-B6   (hex)		Cisco-Linksys, LLC
+0016B6     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+00-18-F8   (hex)		Cisco-Linksys, LLC
+0018F8     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  CA  92612
+				US
+
+00-25-2E   (hex)		Cisco SPVTG
+00252E     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+54-D4-6F   (hex)		Cisco SPVTG
+54D46F     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+A4-A2-4A   (hex)		Cisco SPVTG
+A4A24A     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+44-E0-8E   (hex)		Cisco SPVTG
+44E08E     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-E0-36   (hex)		PIONEER CORPORATION
+00E036     (base 16)		PIONEER CORPORATION
+				2610 Hanazono 4-Chome
+				Saitama Prefecture, 359-8    34567
+				JP
+
+00-E0-4F   (hex)		Cisco Systems, Inc
+00E04F     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-FF   (hex)		Cisco Systems, Inc
+0010FF     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-54   (hex)		Cisco Systems, Inc
+001054     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-F6   (hex)		Cisco Systems, Inc
+0010F6     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-A6   (hex)		Cisco Systems, Inc
+0010A6     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+BC-C8-10   (hex)		Cisco SPVTG
+BCC810     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+7C-B2-1B   (hex)		Cisco SPVTG
+7CB21B     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville    30044
+				US
+
+24-76-7D   (hex)		Cisco SPVTG
+24767D     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+48-1D-70   (hex)		Cisco SPVTG
+481D70     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+F0-B2-E5   (hex)		Cisco Systems, Inc
+F0B2E5     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-23-32   (hex)		Apple, Inc.
+002332     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-23-6C   (hex)		Apple, Inc.
+00236C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-23-DF   (hex)		Apple, Inc.
+0023DF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-25-00   (hex)		Apple, Inc.
+002500     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-25-BC   (hex)		Apple, Inc.
+0025BC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-97-BD   (hex)		Cisco Systems, Inc
+5897BD     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+5C-83-8F   (hex)		Cisco Systems, Inc
+5C838F     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+EC-BD-1D   (hex)		Cisco Systems, Inc
+ECBD1D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-19-E3   (hex)		Apple, Inc.
+0019E3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1B-63   (hex)		Apple, Inc.
+001B63     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1E-C2   (hex)		Apple, Inc.
+001EC2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1F-F3   (hex)		Apple, Inc.
+001FF3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-10-FA   (hex)		Apple, Inc.
+0010FA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-50-E4   (hex)		Apple, Inc.
+0050E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-0D-93   (hex)		Apple, Inc.
+000D93     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-FA-DF   (hex)		Apple, Inc.
+7CFADF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-A3-E4   (hex)		Apple, Inc.
+78A3E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-8F-C6   (hex)		Apple, Inc.
+148FC6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-6A-B8   (hex)		Apple, Inc.
+286AB8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-E0-2C   (hex)		Apple, Inc.
+28E02C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-B9-BA   (hex)		Apple, Inc.
+E0B9BA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-C6-10   (hex)		Apple, Inc.
+00C610     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-F6-B1   (hex)		Apple, Inc.
+B8F6B1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-FA-BA   (hex)		Apple, Inc.
+8CFABA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-D1-C3   (hex)		Apple, Inc.
+7CD1C3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-DC-E2   (hex)		Apple, Inc.
+F0DCE2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-AB-81   (hex)		Apple, Inc.
+24AB81     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-F8-47   (hex)		Apple, Inc.
+E0F847     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-E7-CF   (hex)		Apple, Inc.
+28E7CF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-CE-8F   (hex)		Apple, Inc.
+E4CE8F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-20-66   (hex)		Apple, Inc.
+A82066     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-52-B7   (hex)		Apple, Inc.
+BC52B7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-59-48   (hex)		Apple, Inc.
+5C5948     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-BC-C8   (hex)		Apple, Inc.
+C8BCC8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-04-0B   (hex)		Apple, Inc.
+E8040B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-5A-05   (hex)		Apple, Inc.
+145A05     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-AB-A7   (hex)		Apple, Inc.
+1CABA7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-84-7A   (hex)		Apple, Inc.
+C0847A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-15-9E   (hex)		Apple, Inc.
+34159E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-B0-35   (hex)		Apple, Inc.
+58B035     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-86-D8   (hex)		Apple, Inc.
+DC86D8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-B9-31   (hex)		Apple, Inc.
+90B931     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-E1-40   (hex)		Apple, Inc.
+D0E140     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-A2-E1   (hex)		Apple, Inc.
+24A2E1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-21-4C   (hex)		Insight Energy Ventures LLC
+04214C     (base 16)		Insight Energy Ventures LLC
+				123 W. Fifth St
+				Royal Oak  MI  48067
+				US
+
+F8-32-E4   (hex)		ASUSTek COMPUTER INC.
+F832E4     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+80-EA-96   (hex)		Apple, Inc.
+80EA96     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-03-08   (hex)		Apple, Inc.
+600308     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-F1-3E   (hex)		Apple, Inc.
+04F13E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-F0-AB   (hex)		Apple, Inc.
+98F0AB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-31-C1   (hex)		Apple, Inc.
+7831C1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-3A-84   (hex)		Apple, Inc.
+783A84     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-8D-4E   (hex)		Apple, Inc.
+5C8D4E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-63-DF   (hex)		Apple, Inc.
+8863DF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-1F-A1   (hex)		Apple, Inc.
+881FA1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-E0-EB   (hex)		Apple, Inc.
+C8E0EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-B8-E3   (hex)		Apple, Inc.
+98B8E3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-53-95   (hex)		Apple, Inc.
+885395     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-6C-1C   (hex)		Apple, Inc.
+786C1C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-8D-79   (hex)		Apple, Inc.
+4C8D79     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-E6-2B   (hex)		Apple, Inc.
+1CE62B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-30-21   (hex)		Apple, Inc.
+0C3021     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-3E-9F   (hex)		Apple, Inc.
+0C3E9F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-FC-48   (hex)		Apple, Inc.
+FCFC48     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-29-3F   (hex)		Apple, Inc.
+9C293F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-A1-AB   (hex)		Intellisis
+80A1AB     (base 16)		Intellisis
+				10350 Science Center Dr
+				San Diego  CA  92121
+				US
+
+84-28-5A   (hex)		Saffron Solutions Inc
+84285A     (base 16)		Saffron Solutions Inc
+				1337 Mass Ave #273
+				Arlington  MA  02476
+				US
+
+D4-B8-FF   (hex)		Home Control Singapore Pte Ltd
+D4B8FF     (base 16)		Home Control Singapore Pte Ltd
+				620A Lorong 1 Toa Payoh
+				Singapore  Singapore  217909
+				SG
+
+08-74-02   (hex)		Apple, Inc.
+087402     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-F6-A3   (hex)		Apple, Inc.
+94F6A3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-E0-D9   (hex)		Apple, Inc.
+98E0D9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-29-F5   (hex)		Apple, Inc.
+CC29F5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-5A-EB   (hex)		Apple, Inc.
+285AEB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-24-75   (hex)		Apple, Inc.
+F02475     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-1F-23   (hex)		Apple, Inc.
+2C1F23     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-9F-13   (hex)		Apple, Inc.
+549F13     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-DB-E2   (hex)		Apple, Inc.
+F0DBE2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-81-14   (hex)		Apple, Inc.
+748114     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-F6-43   (hex)		Apple, Inc.
+18F643     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-5E-60   (hex)		Apple, Inc.
+A45E60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-18-28   (hex)		Apple, Inc.
+A01828     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-03-4B   (hex)		Apple, Inc.
+D0034B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-41-7F   (hex)		Apple, Inc.
+10417F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-66-7F   (hex)		Apple, Inc.
+A8667F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-25-98   (hex)		Apple, Inc.
+D02598     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-BE-05   (hex)		Apple, Inc.
+80BE05     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-A0-74   (hex)		Apple, Inc.
+24A074     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-78-8B   (hex)		Apple, Inc.
+84788B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-A4-23   (hex)		Sagemcom Broadband SAS
+84A423     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+3C-78-73   (hex)		Airsonics
+3C7873     (base 16)		Airsonics
+				1289 Fordham Blvd.
+				Chapel Hill  NC  27514
+				US
+
+9C-88-AD   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+9C88AD     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+88-94-7E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+88947E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+C8-A2-CE   (hex)		Oasis Media Systems LLC
+C8A2CE     (base 16)		Oasis Media Systems LLC
+				1073 Barley Sheaf Rd
+				Flemington  NJ  08822
+				US
+
+58-F4-96   (hex)		Source Chain
+58F496     (base 16)		Source Chain
+				#407-4 eBIZ.Center
+				Seoul  seoul  ASI|KR|KS013|SEOUL
+				KR
+
+58-7F-57   (hex)		Apple, Inc.
+587F57     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-7C-2D   (hex)		Leie IOT technology Co., Ltd
+D07C2D     (base 16)		Leie IOT technology Co., Ltd
+				9th floor,Hongchengxintai building,No.105,Yaojiayuan Road,Chaoyang District,Beijing
+				Beijing  Beijing  100026
+				CN
+
+EC-64-E7   (hex)		MOCACARE Corporation
+EC64E7     (base 16)		MOCACARE Corporation
+				887 Federation Way
+				Palo Alto  CA  94303
+				US
+
+40-86-2E   (hex)		JDM MOBILE INTERNET SOLUTION CO., LTD.
+40862E     (base 16)		JDM MOBILE INTERNET SOLUTION CO., LTD.
+				
+				Jiashan  Zhejiang  314100
+				CN
+
+C4-BB-EA   (hex)		Pakedge Device and Software Inc
+C4BBEA     (base 16)		Pakedge Device and Software Inc
+				3847 Breakwater Ave
+				Hayward  CA  94545
+				US
+
+98-87-44   (hex)		Wuxi Hongda Science and Technology Co.,LTD
+988744     (base 16)		Wuxi Hongda Science and Technology Co.,LTD
+				No.10 An Nan Road, Nan Quan Town, Bin Hu District
+				WUXI  Jiangsu  214128
+				CN
+
+E8-34-3E   (hex)		Beijing Infosec Technologies Co., LTD.
+E8343E     (base 16)		Beijing Infosec Technologies Co., LTD.
+				Floor 4, Tower C, Global Finance and News Center
+				Beijing  Beijing  100052
+				CN
+
+34-69-87   (hex)		zte corporation
+346987     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+98-F4-28   (hex)		zte corporation
+98F428     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A4-CC-32   (hex)		Inficomm Co., Ltd
+A4CC32     (base 16)		Inficomm Co., Ltd
+				3F, B-31 Building, Tanglang Industry Park, Taoyuan Str, Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+00-6D-52   (hex)		Apple, Inc.
+006D52     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-32-99   (hex)		Lenovo (Beijing) Co., Ltd.
+A03299     (base 16)		Lenovo (Beijing) Co., Ltd.
+				No.6, ChuangYe Road,
+				Haidian District  Beijing  100085
+				CN
+
+40-54-E4   (hex)		Wearsafe Labs Inc
+4054E4     (base 16)		Wearsafe Labs Inc
+				1429 Park Street
+				Hartford  CT  06106
+				US
+
+DC-9A-8E   (hex)		Nanjing Cocomm electronics co., LTD
+DC9A8E     (base 16)		Nanjing Cocomm electronics co., LTD
+				Room 201,the Qinheng technology park building
+				Nanjing  Jiangsu  210012
+				CN
+
+AC-EE-9E   (hex)		Samsung Electronics Co.,Ltd
+ACEE9E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-57-D8   (hex)		Samsung Electronics Co.,Ltd
+B857D8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-BF-3E   (hex)		Charles River Laboratories
+70BF3E     (base 16)		Charles River Laboratories
+				1023 Wappoo Road Suite 43B
+				Charleston  SC  29407
+				US
+
+A8-C8-7F   (hex)		Roqos, Inc.
+A8C87F     (base 16)		Roqos, Inc.
+				1775 Greensboro Station Place
+				Mclean  Virginia  22102
+				US
+
+3C-83-1E   (hex)		CKD Corporation
+3C831E     (base 16)		CKD Corporation
+				250, Ouji 2-Chome
+				Komaki  Aichi  485-8551
+				JP
+
+90-DF-FB   (hex)		HOMERIDER SYSTEMS
+90DFFB     (base 16)		HOMERIDER SYSTEMS
+				12 RUE REMORA
+				GRADIGNAN  GIRONDE  33170
+				FR
+
+30-5A-3A   (hex)		ASUSTek COMPUTER INC.
+305A3A     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+2C-08-1C   (hex)		OVH
+2C081C     (base 16)		OVH
+				2, rue Kellermann
+				Roubaix  Nord  59100
+				FR
+
+C0-84-88   (hex)		Finis Inc
+C08488     (base 16)		Finis Inc
+				7085-E Las Positas Rd
+				Livermore  CA  94551
+				US
+
+38-F5-57   (hex)		JOLATA, INC.
+38F557     (base 16)		JOLATA, INC.
+				2262 N. FIRST ST.
+				SAN JOSE  CA  95134
+				US
+
+54-A3-FA   (hex)		BQT Solutions (Australia)Pty Ltd
+54A3FA     (base 16)		BQT Solutions (Australia)Pty Ltd
+				Unit 29, 1 Talavera Road
+				North Ryde  NSW  2113
+				AU
+
+24-6C-8A   (hex)		YUKAI Engineering
+246C8A     (base 16)		YUKAI Engineering
+				16-11-101, Tomihisa, Shinjuku
+				Tokyo  -  162-0067
+				
+
+AC-C5-1B   (hex)		Zhuhai Pantum Electronics Co., Ltd.
+ACC51B     (base 16)		Zhuhai Pantum Electronics Co., Ltd.
+				Area A, 3rd floor, Building No.1, No.3883, Zhuhai Avenue, Zhuhai, Guangdong, China
+				Zhuhai  Guangdong  519000
+				CN
+
+38-5F-66   (hex)		Cisco SPVTG
+385F66     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+B8-44-D9   (hex)		Apple, Inc.
+B844D9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-7A-03   (hex)		Ciena Corporation
+9C7A03     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+5C-CF-7F   (hex)		Espressif Inc.
+5CCF7F     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+68-12-95   (hex)		Lupine Lighting Systems GmbH
+681295     (base 16)		Lupine Lighting Systems GmbH
+				Winnberger Weg 11
+				Neumarkt  Bavaria  92318
+				DE
+
+70-11-AE   (hex)		Music Life LTD
+7011AE     (base 16)		Music Life LTD
+				Unit E, 31/F, Billion Centre Tower A
+				Kowloon  N/A  00000
+				HK
+
+04-1E-7A   (hex)		DSPWorks
+041E7A     (base 16)		DSPWorks
+				12/947, MHB Colony, Gorai Road
+				Mumbai    400091
+				IN
+
+84-A7-88   (hex)		Perples
+84A788     (base 16)		Perples
+				8F, 209 Dosan-daero,
+				Seoul    135-892
+				KR
+
+AC-60-B6   (hex)		Ericsson AB
+AC60B6     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+14-B3-70   (hex)		Gigaset Digital Technology (Shenzhen) Co., Ltd.
+14B370     (base 16)		Gigaset Digital Technology (Shenzhen) Co., Ltd.
+				11/F, Matsunichi Building, No.9996 Shen Nan Boulevard,  Nan Shan District, Shenzhen, China
+				ShenZhen  Guangdong  518000
+				CN
+
+68-89-C1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6889C1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-49-7B   (hex)		Gemtek Technology Co., Ltd.
+1C497B     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road Hsinchu Industrial Park Hukou, Hsinchu 30352 TAIWAN, REPUBLIC OF CHINA
+				Hsinchu  TAIWAN  30352
+				TW
+
+2C-CF-58   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2CCF58     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-93-80   (hex)		Ducere Technologies Pvt. Ltd.
+D09380     (base 16)		Ducere Technologies Pvt. Ltd.
+				222B West Marredpally
+				Secunderabad  Telangana  500026
+				IN
+
+68-F9-56   (hex)		Objetivos y Servicio de Valor Añadido
+68F956     (base 16)		Objetivos y Servicio de Valor Añadido
+				c/Monte Esquinza, 28 1ºD
+				MADRID  MADRID  28010
+				ES
+
+C8-A9-FC   (hex)		Goyoo Networks Inc.
+C8A9FC     (base 16)		Goyoo Networks Inc.
+				Building D, Kelin Blocks, No.107, Dongsi North St,
+				Beijing  Beijing  100007
+				CN
+
+FC-FE-C2   (hex)		Invensys Controls UK Limited
+FCFEC2     (base 16)		Invensys Controls UK Limited
+				401 Southway Drive
+				Plymouth  Devon  Pl6 6QT
+				GB
+
+68-9A-B7   (hex)		Atelier Vision Corporation
+689AB7     (base 16)		Atelier Vision Corporation
+				888-340 Nakagawa
+				Hamamatsu  Shizuoka  431-1304
+				JP
+
+44-4C-A8   (hex)		Arista Networks
+444CA8     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+7C-2B-E1   (hex)		Shenzhen Ferex Electrical Co.,Ltd
+7C2BE1     (base 16)		Shenzhen Ferex Electrical Co.,Ltd
+				Block 2,Jiuzhou Industrial Park,Gongming
+				Shenzhen  Guangdong  518107
+				CN
+
+50-31-AD   (hex)		ABB Global Industries and Services Private Limited
+5031AD     (base 16)		ABB Global Industries and Services Private Limited
+				21st floor, World Trade Center
+				Bangalore  Karnataka  560055
+				IN
+
+14-3E-BF   (hex)		zte corporation
+143EBF     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+FC-2F-EF   (hex)		UTT Technologies Co., Ltd.
+FC2FEF     (base 16)		UTT Technologies Co., Ltd.
+				Room 301, Building 9, No. 518 Xinzhuan
+				Shanghai  Shanghai  201612
+				CN
+
+A4-C1-38   (hex)		Telink Semiconductor (Taipei) Co. Ltd.
+A4C138     (base 16)		Telink Semiconductor (Taipei) Co. Ltd.
+				Room 1050. 10F. Buld. H, No. 3-2 YuanQu St.,
+				Taipei  Taipei  11503
+				TW
+
+20-F5-10   (hex)		Codex Digital Limited
+20F510     (base 16)		Codex Digital Limited
+				60 Poland Street
+				London  Greater London  W1F 7NT
+				GB
+
+A8-74-1D   (hex)		PHOENIX CONTACT Electronics GmbH
+A8741D     (base 16)		PHOENIX CONTACT Electronics GmbH
+				Dringenauer Str. 30
+				Bad Pyrmont  -  D-31812
+				DE
+
+F0-9A-51   (hex)		Shanghai Viroyal Electronic Technology Company Limited
+F09A51     (base 16)		Shanghai Viroyal Electronic Technology Company Limited
+				LevelB,Building#3,401 Caobao Road,Shanghai,China
+				Shanghai  Shanghai  200233
+				CN
+
+4C-B8-2C   (hex)		Cambridge Mobile Telematics, Inc.
+4CB82C     (base 16)		Cambridge Mobile Telematics, Inc.
+				One Broadway, 14th Floor
+				Cambridge  MA  02142
+				US
+
+E4-A3-2F   (hex)		Shanghai Artimen Technology Co., Ltd.
+E4A32F     (base 16)		Shanghai Artimen Technology Co., Ltd.
+				Room 4462, Third Building, No. 505, Xinge Road, Xinqiao Town, SongJiang District, Shanghai City, China
+				Shanghai  Shanghai  201206
+				CN
+
+F4-67-2D   (hex)		ShenZhen Topstar Technology Company
+F4672D     (base 16)		ShenZhen Topstar Technology Company
+				5/F Buliding 204,Tai Ran ShenZhen Science&Industry Park
+				ShenZhen  GuangZhou  518042
+				CN
+
+A8-D8-28   (hex)		Ascensia Diabetes Care
+A8D828     (base 16)		Ascensia Diabetes Care
+				5 Wood Hollow Rd,
+				Parsippany  NJ  07054
+				US
+
+B8-69-C2   (hex)		Sunitec Enterprise Co., Ltd.
+B869C2     (base 16)		Sunitec Enterprise Co., Ltd.
+				1F., No.35, Dayong St., Zhonghe Dist.,
+				New Taipei City  Taiwan  235
+				TW
+
+88-CB-A5   (hex)		Suzhou Torchstar Intelligent Technology Co.,Ltd
+88CBA5     (base 16)		Suzhou Torchstar Intelligent Technology Co.,Ltd
+				Rm1704B,Business Building, No.181, Cuiyuan Rd.,SIP
+				Suzhou  Jiangsu Province  215000
+				CN
+
+7C-A2-3E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7CA23E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-1A-A5   (hex)		GN Netcom A/S
+501AA5     (base 16)		GN Netcom A/S
+				Lautrupbjerg 7
+				Ballerup  Ballerup  DK-2750
+				DK
+
+A4-8D-3B   (hex)		Vizio, Inc
+A48D3B     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+1C-56-FE   (hex)		Motorola Mobility LLC, a Lenovo Company
+1C56FE     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+B8-99-B0   (hex)		Cohere Technologies
+B899B0     (base 16)		Cohere Technologies
+				404 Saratoga Avenue
+				Santa Clara  CA  95050
+				US
+
+D8-5D-EF   (hex)		Busch-Jaeger Elektro GmbH
+D85DEF     (base 16)		Busch-Jaeger Elektro GmbH
+				Freisenbergstrasse 2
+				Luedenscheid  NRW  58513
+				DE
+
+88-A2-D7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88A2D7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-32-3A   (hex)		so-logic
+00323A     (base 16)		so-logic
+				Lustkandlgasse 52
+				Vienna  Vienna  1090
+				AT
+
+80-9F-AB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+809FAB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E0-03-70   (hex)		ShenZhen Continental Wireless Technology Co., Ltd.
+E00370     (base 16)		ShenZhen Continental Wireless Technology Co., Ltd.
+				North 23F, Dongfang Technology Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+04-61-69   (hex)		MEDIA GLOBAL LINKS CO., LTD.
+046169     (base 16)		MEDIA GLOBAL LINKS CO., LTD.
+				580-16, Horikawa-cho
+				Kawasaki  Kanagawa  212-0013
+				JP
+
+BC-EB-5F   (hex)		Fujian Beifeng Telecom Technology Co., Ltd.
+BCEB5F     (base 16)		Fujian Beifeng Telecom Technology Co., Ltd.
+				A-15, Huaqiao Economic Development Zone, Shuangyang, Luojiang,
+				quanzhou  fujian  362000
+				CN
+
+AC-5A-14   (hex)		Samsung Electronics Co.,Ltd
+AC5A14     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-AB-54   (hex)		MITSUMI ELECTRIC CO.,LTD.
+F0AB54     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+3C-31-78   (hex)		Qolsys Inc.
+3C3178     (base 16)		Qolsys Inc.
+				1900 The Alameda
+				San Jose  Ca  95126
+				US
+
+08-EC-A9   (hex)		Samsung Electronics Co.,Ltd
+08ECA9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-4B-45   (hex)		Hi-P Electronics Pte Ltd
+E04B45     (base 16)		Hi-P Electronics Pte Ltd
+				12 Ang Mo Kio Street 64
+				Singapore  Singapore  569088
+				SG
+
+F4-6A-92   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+F46A92     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+F0-D6-57   (hex)		ECHOSENS
+F0D657     (base 16)		ECHOSENS
+				30 Place d'Italie
+				PARIS 13  Ile de France  75013
+				FR
+
+9C-37-F4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C37F4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-47-11   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C4711     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-EB-68   (hex)		Cheerstar Technology Co., Ltd
+5CEB68     (base 16)		Cheerstar Technology Co., Ltd
+				5th Floor,Hongye Industrial Park,
+				ShenZhen  GuangDong  518006
+				CN
+
+AC-56-2C   (hex)		LAVA INTERNATIONAL(H.K) LIMITED
+AC562C     (base 16)		LAVA INTERNATIONAL(H.K) LIMITED
+				UNIT L 1/F MAU LAM COMM BLDG 16-18
+				Hong Kong    
+				CN
+
+FC-9A-FA   (hex)		Motus Global Inc.
+FC9AFA     (base 16)		Motus Global Inc.
+				5394 Merrick Road
+				Massapequa  NY  11758
+				US
+
+14-15-7C   (hex)		TOKYO COSMOS ELECTRIC CO.,LTD.
+14157C     (base 16)		TOKYO COSMOS ELECTRIC CO.,LTD.
+				2-268 Sobudai
+				Zama  Kanagawa  252-8550
+				JP
+
+20-E4-07   (hex)		Spark srl
+20E407     (base 16)		Spark srl
+				Via A. Gramsci 86/A
+				Reggio Emilia    42124
+				IT
+
+D0-9D-AB   (hex)		TCT mobile ltd
+D09DAB     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+88-73-84   (hex)		Toshiba
+887384     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+24-69-3E   (hex)		innodisk Corporation
+24693E     (base 16)		innodisk Corporation
+				5F., No. 237, Sec. 1, Datong Rd., Xizhi Dist.
+				New Taipei City  Taiwan  221
+				TW
+
+C0-DC-6A   (hex)		Qingdao Eastsoft Communication Technology Co.,LTD
+C0DC6A     (base 16)		Qingdao Eastsoft Communication Technology Co.,LTD
+				Shandong QINGDAO, No. 16A, Shangqing Road, Shibei District
+				QINGDAO  Shandong  266023
+				CN
+
+24-B0-A9   (hex)		Shanghai Mobiletek Communication Ltd.
+24B0A9     (base 16)		Shanghai Mobiletek Communication Ltd.
+				RM201, Building 9, No 99 Tianzhou RD, Shanghai China
+				Shanghai  Shanghai  200233
+				CN
+
+1C-C5-86   (hex)		Absolute Acoustics
+1CC586     (base 16)		Absolute Acoustics
+				Av. Corifeu de Azevedo Marques, 1703
+				  Sao Paulo  05581-001
+				BR
+
+40-7F-E0   (hex)		Glory Star Technics (ShenZhen) Limited
+407FE0     (base 16)		Glory Star Technics (ShenZhen) Limited
+				4/f, West Block, Xi Li Village, Xin Wu Industry Bldg., Nan Shan District, ShenZhen, China
+				Shenzhen  China  
+				CN
+
+C8-E1-30   (hex)		Milkyway Group Ltd
+C8E130     (base 16)		Milkyway Group Ltd
+				RM 405 Tung Ming Building
+				Hong Kong  Hong Kong  999077
+				HK
+
+48-6E-FB   (hex)		Davit System Technology Co., Ltd.
+486EFB     (base 16)		Davit System Technology Co., Ltd.
+				#304 Hanlim Human Tower, LS-Ro 172
+				Gunpo-si  Gyeonggi-Do  435-824
+				KR
+
+B0-96-6C   (hex)		Lanbowan Technology Ltd.
+B0966C     (base 16)		Lanbowan Technology Ltd.
+				No. 60 Langbao Xi Road
+				Foshan  Guangdong  528051
+				CN
+
+1C-F0-3E   (hex)		Wearhaus Inc.
+1CF03E     (base 16)		Wearhaus Inc.
+				2041 Bancroft Way
+				Berkeley  CA  94704
+				US
+
+C4-3A-BE   (hex)		Sony Mobile Communications Inc
+C43ABE     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+88-3B-8B   (hex)		Cheering Connection Co. Ltd.
+883B8B     (base 16)		Cheering Connection Co. Ltd.
+				Room 602, Shenzhen Software Park T2-B
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-F9-39   (hex)		Minxon Hotel Technology INC.
+E4F939     (base 16)		Minxon Hotel Technology INC.
+				3F, No.37, Dongxing Rd., Xinyi Dist.
+				Taipei  Taiwan  11070
+				TW
+
+14-6B-72   (hex)		Shenzhen Fortune Ship Technology Co., Ltd.
+146B72     (base 16)		Shenzhen Fortune Ship Technology Co., Ltd.
+				Room 701-716, 7th Floor,
+				Nanshan District, Shenzhen  Guangdong  518000
+				CN
+
+B8-F0-80   (hex)		SPS, INC.
+B8F080     (base 16)		SPS, INC.
+				70, Techno8-ro
+				Yuseong-gu  Daejeon  305-500
+				KR
+
+80-50-67   (hex)		W & D TECHNOLOGY CORPORATION
+805067     (base 16)		W & D TECHNOLOGY CORPORATION
+				1F., NO.22, GONGYEQU 31TH RD
+				TAICHUNG CITY  TAIWAN  40768
+				TW
+
+78-F9-44   (hex)		Private
+78F944     (base 16)		Private
+
+24-76-56   (hex)		Shanghai Net Miles Fiber Optics Technology Co., LTD.
+247656     (base 16)		Shanghai Net Miles Fiber Optics Technology Co., LTD.
+				Flat F, 17th Floor, Southern International Mansion
+				Shanghai  Shanghai  201401
+				CN
+
+F8-CF-C5   (hex)		Motorola Mobility LLC, a Lenovo Company
+F8CFC5     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+A4-7B-85   (hex)		ULTIMEDIA Co Ltd,
+A47B85     (base 16)		ULTIMEDIA Co Ltd,
+				Guro-Gu Saeaml-ro 102
+				Seoul    152770
+				KR
+
+5C-5B-35   (hex)		Mist Systems, Inc.
+5C5B35     (base 16)		Mist Systems, Inc.
+				1601 South De Anza Blvd, Suite 248
+				Cupertino  CA  95014
+				US
+
+EC-BA-FE   (hex)		GIROPTIC
+ECBAFE     (base 16)		GIROPTIC
+				165 avenue de Bretagne
+				Lille  Nord  59000
+				FR
+
+3C-2C-94   (hex)		杭州德澜科技有限公司（HangZhou Delan Technology Co.,Ltd）
+3C2C94     (base 16)		杭州德澜科技有限公司（HangZhou Delan Technology Co.,Ltd）
+				tianmushan road no.398,Xihu District, hangzhou city, zhejiang province, China
+				Hangzhou  ZheJiang  310013
+				CN
+
+24-1B-44   (hex)		Hangzhou Tuners Electronics Co., Ltd
+241B44     (base 16)		Hangzhou Tuners Electronics Co., Ltd
+				5/F,Building No.1,No.619
+				BinJiang District, Hangzhou  ZheJiang  310053
+				CN
+
+80-A8-5D   (hex)		Osterhout Design Group
+80A85D     (base 16)		Osterhout Design Group
+				153 Townsend Suite 570
+				San Francisco  CA  94107
+				US
+
+AC-CA-AB   (hex)		Virtual Electric Inc
+ACCAAB     (base 16)		Virtual Electric Inc
+				1314 Vanna Ct
+				San Jose  CA  95131
+				US
+
+48-54-15   (hex)		NET RULES TECNOLOGIA EIRELI
+485415     (base 16)		NET RULES TECNOLOGIA EIRELI
+				Rua Madre Cabrini, 240 - 7°andar
+				São Paulo  São Paulo  04020000
+				BR
+
+78-40-E4   (hex)		Samsung Electronics Co.,Ltd
+7840E4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-99-71   (hex)		Samsung Electronics Co.,Ltd
+E09971     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-DA-9C   (hex)		TECSEN
+70DA9C     (base 16)		TECSEN
+				$401, Jeongsu Bd, 94-70,
+				SEOUL  NA  150-037
+				KR
+
+2C-A2-B4   (hex)		Fortify Technologies, LLC
+2CA2B4     (base 16)		Fortify Technologies, LLC
+				6200 Shingle Creek Pkwy, Suite 400
+				Minneapolis  Minnesota  55430
+				US
+
+10-D3-8A   (hex)		Samsung Electronics Co.,Ltd
+10D38A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-85-01   (hex)		Geberit International AG
+E48501     (base 16)		Geberit International AG
+				Schachenstrasse 77
+				Jona  SG  8645
+				CH
+
+20-62-74   (hex)		Microsoft Corporation
+206274     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+E8-16-2B   (hex)		IDEO Security Co., Ltd.
+E8162B     (base 16)		IDEO Security Co., Ltd.
+				1404, Seoul Forest IT Valley, 77, Seongsuil-ro
+				Seongdong-gu,  SEOUL  133-822
+				KR
+
+B4-73-56   (hex)		Hangzhou Treebear Networking Co., Ltd.
+B47356     (base 16)		Hangzhou Treebear Networking Co., Ltd.
+				2F,Block A, Lianhe Building, 2#, Zijinghua RD, Xihu District
+				Hangzhou  Zhejiang  310012
+				CN
+
+34-68-95   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+346895     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+84-73-03   (hex)		Letv Mobile and Intelligent Information Technology (Beijing) Corporation Ltd.
+847303     (base 16)		Letv Mobile and Intelligent Information Technology (Beijing) Corporation Ltd.
+				5th floor,Hongchengxintai building,No.105,Yaojiayuan Road,Chaoyang District,Beijing
+				Beijing  Chaoyang  100025
+				CN
+
+3C-C2-E1   (hex)		XINHUA CONTROL ENGINEERING CO.,LTD
+3CC2E1     (base 16)		XINHUA CONTROL ENGINEERING CO.,LTD
+				160 Wenjing Road, Minhang
+				Shanghai  Shanghai  200245
+				CN
+
+8C-87-3B   (hex)		Leica Camera AG
+8C873B     (base 16)		Leica Camera AG
+				Am Leitz-Park 5
+				Wetzlar  Hessen  35578
+				DE
+
+44-F4-77   (hex)		Juniper Networks
+44F477     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+14-29-71   (hex)		NEMOA ELECTRONICS (HK) CO. LTD
+142971     (base 16)		NEMOA ELECTRONICS (HK) CO. LTD
+				ROOM 610, MINGYOU PURCHASING & DISPLAYING CENTER,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+78-E9-80   (hex)		RainUs Co.,Ltd
+78E980     (base 16)		RainUs Co.,Ltd
+				E-703, Digital Empire, 16, Deogyeong-daero
+				Suwon-si  Gyeonggi-do  443-702
+				KR
+
+E0-FF-F7   (hex)		Softiron Inc.
+E0FFF7     (base 16)		Softiron Inc.
+				6540 Central Avenue
+				Newark  California  94560
+				US
+
+3C-6A-9D   (hex)		Dexatek Technology LTD.
+3C6A9D     (base 16)		Dexatek Technology LTD.
+				15F, NO.81, Sec.1, Xizhi Dist.,
+				New Taipei City    221
+				TW
+
+34-9E-34   (hex)		Evervictory Electronic Co.Ltd
+349E34     (base 16)		Evervictory Electronic Co.Ltd
+				Chu-Chi management district Humen Town, DongGuan GuangDong Province, China
+				DongGuan  GuangDong  523000
+				CN
+
+70-0F-C7   (hex)		SHENZHEN IKINLOOP TECHNOLOGY CO.,LTD.
+700FC7     (base 16)		SHENZHEN IKINLOOP TECHNOLOGY CO.,LTD.
+				Room 8B,Building C, Tongfang Information Port, Langshan Road, Science
+				Shenzhen  Guangdong  518057
+				CN
+
+BC-74-D7   (hex)		HangZhou JuRu Technology CO.,LTD
+BC74D7     (base 16)		HangZhou JuRu Technology CO.,LTD
+				No.803 Room,Shuyu Building,No.98 Wenyi West Road,Hangzhou,Zhejiang,China
+				hangzhou  zhejiang  310053
+				CN
+
+78-EB-14   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+78EB14     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+3C-49-37   (hex)		ASSMANN Electronic GmbH
+3C4937     (base 16)		ASSMANN Electronic GmbH
+				Auf dem Schueffel 3
+				Luedenscheid  Germany  58513
+				DE
+
+84-44-64   (hex)		ServerU Inc
+844464     (base 16)		ServerU Inc
+				8100 NW 64th Street
+				Miami  FL  33166
+				US
+
+00-35-60   (hex)		Rosen Aviation
+003560     (base 16)		Rosen Aviation
+				1020 Owen Loop South
+				Eugene  Oregon  97402
+				US
+
+F8-BC-41   (hex)		Rosslare Enterprises Limited
+F8BC41     (base 16)		Rosslare Enterprises Limited
+				Flat 912 Wing Fat Industrial Building
+				Kowloon Bay  Kowloon  
+				HK
+
+3C-B7-92   (hex)		Hitachi Maxell, Ltd., Optronics Division
+3CB792     (base 16)		Hitachi Maxell, Ltd., Optronics Division
+				5030 Totsuka-cho, Totsuka-ku
+				Yokohama  Kanagawa  244-0003
+				JP
+
+F8-B2-F3   (hex)		GUANGZHOU BOSMA TECHNOLOGY CO.,LTD
+F8B2F3     (base 16)		GUANGZHOU BOSMA TECHNOLOGY CO.,LTD
+				FL.3,A5,No.11 Kaiyuan Ave., Scienc City,Guangzhou,CHINA
+				Guangzhou  GuangDong  510530
+				CN
+
+28-D9-8A   (hex)		Hangzhou Konke Technology Co.,Ltd.
+28D98A     (base 16)		Hangzhou Konke Technology Co.,Ltd.
+				Hangzhou cuibai road 7, ROOM 422
+				Hangzhou  Zhejiang  310012
+				CN
+
+D8-93-41   (hex)		General Electric Global Research
+D89341     (base 16)		General Electric Global Research
+				2623 Camino Ramon
+				San Ramon  CA  94583
+				US
+
+1C-9E-CB   (hex)		Beijing Nari Smartchip Microelectronics Company Limited
+1C9ECB     (base 16)		Beijing Nari Smartchip Microelectronics Company Limited
+				Northern Territory Xixiaokou Rd,Haidian district,Beijing 100192,China
+				beijing  beijing  100192
+				CN
+
+D4-8D-D9   (hex)		Meld Technology, Inc
+D48DD9     (base 16)		Meld Technology, Inc
+				725 San Aleso Ave
+				Sunnyvale  CA  94085
+				US
+
+DC-C6-22   (hex)		BUHEUNG SYSTEM
+DCC622     (base 16)		BUHEUNG SYSTEM
+				302, 45, Jeonpa-ro, 24 Beongil
+				Anyang-si  Gyeonggi-do  430-857
+				KR
+
+90-2C-C7   (hex)		C-MAX Asia Limited
+902CC7     (base 16)		C-MAX Asia Limited
+				Unit 117, 1/F, Liven House
+				Kwun Tong  Kowloon  852
+				HK
+
+88-70-EF   (hex)		SC Professional Trading Co., Ltd.
+8870EF     (base 16)		SC Professional Trading Co., Ltd.
+				2 Soi Krungthepkreetar 21
+				Sapansoong  Bangkok  10250
+				TH
+
+94-C0-38   (hex)		Tallac Networks
+94C038     (base 16)		Tallac Networks
+				6528 Lonetree Blvd.
+				Rocklin  CA  95765
+				US
+
+68-36-B5   (hex)		DriveScale, Inc.
+6836B5     (base 16)		DriveScale, Inc.
+				530 Lakeside Dr. #190
+				Sunnyvale  CALIFORNIA  94085
+				US
+
+C4-08-80   (hex)		Shenzhen UTEPO Tech Co., Ltd.
+C40880     (base 16)		Shenzhen UTEPO Tech Co., Ltd.
+				5/F Western Block, M-8 Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-80-39   (hex)		Microchip Technology Inc.
+D88039     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+5C-96-6A   (hex)		RTNET
+5C966A     (base 16)		RTNET
+				827-64, Yeoksam-dong, Kangnam-Gu
+				Seoul  -  135-080
+				KR
+
+BC-BC-46   (hex)		SKS Welding Systems GmbH
+BCBC46     (base 16)		SKS Welding Systems GmbH
+				Marie-Curie-Str. 14
+				Kaiserslautern  Rheinlandpfalz  67661
+				DE
+
+98-16-EC   (hex)		IC Intracom
+9816EC     (base 16)		IC Intracom
+				550 Commerce Blvd
+				Oldsmar  Florida  34677
+				US
+
+D0-62-A0   (hex)		China Essence Technology (Zhumadian) Co., Ltd.
+D062A0     (base 16)		China Essence Technology (Zhumadian) Co., Ltd.
+				4th Floor, Administrative Service Center Office of Yicheng District
+				Zhumadian  Henan Province  463000
+				CN
+
+90-17-9B   (hex)		Nanomegas
+90179B     (base 16)		Nanomegas
+				BD Ed.Machtens 79/22
+				BXL  Molenbeek  1080
+				BE
+
+14-F8-93   (hex)		Wuhan FiberHome Digital Technology Co.,Ltd.
+14F893     (base 16)		Wuhan FiberHome Digital Technology Co.,Ltd.
+				No.88 YouKeyuan Road
+				Wuhan  Hubei  430074
+				CN
+
+58-21-36   (hex)		KMB systems, s.r.o.
+582136     (base 16)		KMB systems, s.r.o.
+				Dr. M. Horakove 559
+				Liberec  Czech Republic  46006
+				CZ
+
+80-09-02   (hex)		Keysight Technologies, Inc.
+800902     (base 16)		Keysight Technologies, Inc.
+				1400 Fountaingrove Pkwy.
+				Santa Rosa  CA  95403
+				US
+
+04-99-E6   (hex)		Shenzhen Yoostar Technology Co., Ltd
+0499E6     (base 16)		Shenzhen Yoostar Technology Co., Ltd
+				#503，Tower D, HUA HAN Innovation Park,
+				Shenzhen  Guangdong  518000
+				CN
+
+70-FF-5C   (hex)		Cheerzing Communication(Xiamen)Technology Co.,Ltd
+70FF5C     (base 16)		Cheerzing Communication(Xiamen)Technology Co.,Ltd
+				Room N514,North Torch Building,5 Torch Road
+				Xiamen  Fujian  361005
+				CN
+
+4C-48-DA   (hex)		Beijing Autelan Technology Co.,Ltd
+4C48DA     (base 16)		Beijing Autelan Technology Co.,Ltd
+				1-4F, 3rd Area, 9#Building Zhongguancun Software Park
+				  Beijing  100193
+				CN
+
+20-5C-FA   (hex)		Yangzhou ChangLian Network Technology Co,ltd.
+205CFA     (base 16)		Yangzhou ChangLian Network Technology Co,ltd.
+				No.60, Shangfang Temple Road
+				Yangzhou City  Jiangsu  225000
+				CN
+
+84-93-0C   (hex)		InCoax Networks Europe AB
+84930C     (base 16)		InCoax Networks Europe AB
+				Strommavagen 2
+				Gavle  Sweden  80309
+				SE
+
+1C-A2-B1   (hex)		ruwido austria gmbh
+1CA2B1     (base 16)		ruwido austria gmbh
+				Koestendorferstrasse 8
+				Neumarkt a.W.  Salzburg  5202
+				AT
+
+38-4B-76   (hex)		AIRTAME ApS
+384B76     (base 16)		AIRTAME ApS
+				Vestergade 20C
+				Copenhagen C  Copenhagen  1456
+				DK
+
+38-B1-DB   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+38B1DB     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+34-F6-D2   (hex)		Panasonic Taiwan Co.,Ltd.
+34F6D2     (base 16)		Panasonic Taiwan Co.,Ltd.
+				579,Yuan Shan Road
+				New Taipei  Taiwan  235
+				
+
+30-75-12   (hex)		Sony Mobile Communications Inc
+307512     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+64-00-2D   (hex)		Powerlinq Co., LTD
+64002D     (base 16)		Powerlinq Co., LTD
+				13 PingDong Road 4 ,
+				Zhuhai  GD   519060
+				
+
+B4-7C-29   (hex)		Shenzhen Guzidi Technology Co.,Ltd
+B47C29     (base 16)		Shenzhen Guzidi Technology Co.,Ltd
+				South 6/F,Yingtang Building,No.5 Kejiyuan Road,Nanshan District,Shenzhen City,Guangdong Province,P.R. China
+				Shenzhen  Guangdong  518000
+				CN
+
+D4-8F-33   (hex)		Microsoft Corporation
+D48F33     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+54-F8-76   (hex)		ABB AG
+54F876     (base 16)		ABB AG
+				Trafoweg 4
+				Halle / Saale  Saxony-Anhalt  06112
+				DE
+
+34-B7-FD   (hex)		Guangzhou Younghead Electronic Technology Co.,Ltd
+34B7FD     (base 16)		Guangzhou Younghead Electronic Technology Co.,Ltd
+				Room 206,Wenzhenxin Building,Block 3, No.2 Kefa RD,Hi-Tech Park, Nanshan District, Shenzhen,China
+				Shenzhen  Guangdong  518052
+				CN
+
+B4-17-80   (hex)		DTI Group Ltd
+B41780     (base 16)		DTI Group Ltd
+				50 Affleck Rd
+				Perth Airport  Western Australia  6105
+				AU
+
+48-9D-18   (hex)		Flashbay Limited
+489D18     (base 16)		Flashbay Limited
+				6 The Fountain Centre
+				London  London  SW6 2TW
+				GB
+
+90-20-3A   (hex)		BYD Precision Manufacture Co.,Ltd
+90203A     (base 16)		BYD Precision Manufacture Co.,Ltd
+				Building 23#，NO.3009 BYD Road，Pingshan
+				Shenzhen  Guangdong  518118
+				CN
+
+80-EA-CA   (hex)		Dialog Semiconductor Hellas SA
+80EACA     (base 16)		Dialog Semiconductor Hellas SA
+				Leoforos Syggrou 143
+				Athens  Attiki  17121
+				GR
+
+20-A9-9B   (hex)		Microsoft Corporation
+20A99B     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+60-48-26   (hex)		Newbridge Technologies Int. Ltd.
+604826     (base 16)		Newbridge Technologies Int. Ltd.
+				35/F Central Plaza
+				Hong Kong    
+				CN
+
+38-F3-3F   (hex)		TATSUNO CORPORATION
+38F33F     (base 16)		TATSUNO CORPORATION
+				2-6,Mita 3-Chome,Minato-ku
+				  Tokyo  108-8520
+				JP
+
+D8-0C-CF   (hex)		C.G.V. S.A.S.
+D80CCF     (base 16)		C.G.V. S.A.S.
+				18, RUE THEODORE MONOD
+				OSTWALD CEDEX  BAS-RHIN  67541
+				FR
+
+4C-BB-58   (hex)		Chicony Electronics Co., Ltd.
+4CBB58     (base 16)		Chicony Electronics Co., Ltd.
+				No.25, Wugong 6th Rd., Wugu Dist.,
+				New Taipei City 248,  TAIWAN, REPUBLIC OF CHINA  248
+				TW
+
+A4-12-42   (hex)		NEC Platforms, Ltd.
+A41242     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+D0-0A-AB   (hex)		Yokogawa Digital Computer Corporation
+D00AAB     (base 16)		Yokogawa Digital Computer Corporation
+				Shinjuku MIDWEST Bldg.4-30-3
+				Yoyogi  Shibuya-ku, Tokyo  151-0053
+				JP
+
+C4-00-06   (hex)		Lipi Data Systems Ltd.
+C40006     (base 16)		Lipi Data Systems Ltd.
+				Mewar Industrial Area (M.I.A)
+				UDAIPUR  RAJASTHAN  313003
+				IN
+
+38-26-2B   (hex)		UTran Technology
+38262B     (base 16)		UTran Technology
+				No.130, Guoji Rd., Tucheng Dist.,
+				New Taipei City    23650
+				TW
+
+48-0C-49   (hex)		NAKAYO Inc
+480C49     (base 16)		NAKAYO Inc
+				Development Support Center 165 Higashiomuro-machi
+				Maebashi-shi  Gunma  379-2105
+				JP
+
+3C-D9-CE   (hex)		Eclipse WiFi
+3CD9CE     (base 16)		Eclipse WiFi
+				68 S Service Rd
+				Melville  NY  11747
+				US
+
+60-77-E2   (hex)		Samsung Electronics Co.,Ltd
+6077E2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-19-10   (hex)		Samsung Electronics Co.,Ltd
+FC1910     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-79-0B   (hex)		Hitachi High Technologies America, Inc.
+FC790B     (base 16)		Hitachi High Technologies America, Inc.
+				208 Fairforest Way
+				Greenville  SC  29607
+				US
+
+60-81-F9   (hex)		Helium Systems, Inc
+6081F9     (base 16)		Helium Systems, Inc
+				717 Market Street
+				San Francisco  CA  94102
+				US
+
+84-01-A7   (hex)		Greyware Automation Products, Inc
+8401A7     (base 16)		Greyware Automation Products, Inc
+				308 Oriole Ct
+				Murphy  TX  75094
+				US
+
+98-F1-70   (hex)		Murata Manufacturing Co., Ltd.
+98F170     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+68-6E-48   (hex)		Prophet Electronic Technology Corp.,Ltd
+686E48     (base 16)		Prophet Electronic Technology Corp.,Ltd
+				9F ,3 Building,No 1535,Hongmei Road ,Xuhui District
+				Shanghai  Shanghai  200233
+				CN
+
+04-C9-91   (hex)		Phistek INC.
+04C991     (base 16)		Phistek INC.
+				5 Floor, No.188, Section 3, Datong Road
+				New Taipei City    221
+				TW
+
+3C-A1-0D   (hex)		Samsung Electronics Co.,Ltd
+3CA10D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-6C-B2   (hex)		Samsung Electronics Co.,Ltd
+646CB2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+68-05-71   (hex)		Samsung Electronics Co.,Ltd
+680571     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-B4-84   (hex)		Samsung Electronics Co.,Ltd
+14B484     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-C4-47   (hex)		Coagent International Enterprise Limited
+F4C447     (base 16)		Coagent International Enterprise Limited
+				FLAT/RM 2 6F CROWN TND BLDG 106 HOW MING ST KWUN TONG
+				Hong Kong  Hong Kong  528133
+				CN
+
+C8-E4-2F   (hex)		Technical Research Design and Development
+C8E42F     (base 16)		Technical Research Design and Development
+				186 Lincoln street
+				Boston  MA  02111
+				US
+
+C4-C9-EC   (hex)		Gugaoo   HK Limited
+C4C9EC     (base 16)		Gugaoo   HK Limited
+				Unit 04, 7/F BRIGHT WAY TOWER
+				Kowloon, Hongkong    
+				HK
+
+34-E4-2A   (hex)		Automatic Bar Controls Inc.
+34E42A     (base 16)		Automatic Bar Controls Inc.
+				790 Eubanks Dr
+				Vacaville  CA  95688
+				US
+
+30-59-B7   (hex)		Microsoft
+3059B7     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+20-A7-87   (hex)		Bointec Taiwan Corporation Limited
+20A787     (base 16)		Bointec Taiwan Corporation Limited
+				1F, A20, L790, SEC.5,
+				TAIPEI  TAIWAN  11082
+				TW
+
+A0-FC-6E   (hex)		Telegrafia a.s.
+A0FC6E     (base 16)		Telegrafia a.s.
+				Lomena 7
+				Kosice  Slovakia  040 01
+				
+
+20-53-CA   (hex)		Risk Technology Ltd
+2053CA     (base 16)		Risk Technology Ltd
+				Matrix House, Merlin Court
+				Altrincham  Cheshire  WA14 5NL
+				GB
+
+A4-3D-78   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A43D78     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+04-57-2F   (hex)		Sertel Electronics UK Ltd
+04572F     (base 16)		Sertel Electronics UK Ltd
+				Rutland House, 148 Edmund Street,
+				Birmingham    B3 2FD
+				GB
+
+D8-97-7C   (hex)		Grey Innovation
+D8977C     (base 16)		Grey Innovation
+				255 Mary St
+				Richmond  Victoria  3121
+				AU
+
+BC-8D-0E   (hex)		Nokia
+BC8D0E     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+A4-9F-85   (hex)		Lyve Minds, Inc
+A49F85     (base 16)		Lyve Minds, Inc
+				10001 N. De Anza Blvd, Ste 300
+				Cupertino  CA  95014
+				US
+
+78-92-3E   (hex)		Nokia Corporation
+78923E     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+AC-A9-A0   (hex)		Audioengine, Ltd.
+ACA9A0     (base 16)		Audioengine, Ltd.
+				1535 Dido Mt Salem Rd
+				Ackerman  Ms  39735
+				US
+
+A4-81-EE   (hex)		Nokia Corporation
+A481EE     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+78-D6-6F   (hex)		Aristocrat Technologies Australia Pty. Ltd.
+78D66F     (base 16)		Aristocrat Technologies Australia Pty. Ltd.
+				Building A, Pinnacle Office Park
+				North Ryde  N.S.W.  2113
+				AU
+
+44-1E-91   (hex)		ARVIDA Intelligent Electronics Technology  Co.,Ltd.
+441E91     (base 16)		ARVIDA Intelligent Electronics Technology  Co.,Ltd.
+				No.3 Qiliang Road.,
+				Danyang  Jiangsu  212300
+				CN
+
+C4-62-6B   (hex)		ZPT Vigantice
+C4626B     (base 16)		ZPT Vigantice
+				Vigantice 266
+				Roznov pod Radhostem    75661
+				CZ
+
+EC-17-66   (hex)		Research Centre Module
+EC1766     (base 16)		Research Centre Module
+				3 Eight March 4Th Street
+				Moscow  Moscow  125190
+				RU
+
+A0-D1-2A   (hex)		AXPRO Technology Inc.
+A0D12A     (base 16)		AXPRO Technology Inc.
+				8F, No.128, sec. 4 Chung Hsiao E. RD.,
+				Taipei city    10866
+				TW
+
+20-9A-E9   (hex)		Volacomm Co., Ltd
+209AE9     (base 16)		Volacomm Co., Ltd
+				15F-6., No.7, Sec.3, New Taipei Blvd., Xinzhuang Dist., New Taipei City 242., Taiwan (R.O.C)
+				Xinzhuang Dist.  New Taipei City  242
+				TW
+
+34-5D-10   (hex)		Wytek
+345D10     (base 16)		Wytek
+				10 rue jean jaures
+				Poitiers    86000
+				FR
+
+6C-14-F7   (hex)		Erhardt+Leimer GmbH
+6C14F7     (base 16)		Erhardt+Leimer GmbH
+				Albert-Leimer-Platz 1
+				Stadtbergen    86391
+				DE
+
+B0-D5-9D   (hex)		Shenzhen Zowee Technology Co., Ltd
+B0D59D     (base 16)		Shenzhen Zowee Technology Co., Ltd
+				Block 5   （ZOWEE Technology Building),
+				Pingshan, Xili Town, Nanshan District  Shenzhen, Guangdong  518055
+				CN
+
+68-28-BA   (hex)		Dejai
+6828BA     (base 16)		Dejai
+				PO Box 101
+				Toorak  Vic  3142
+				AU
+
+B0-57-06   (hex)		Vallox Oy
+B05706     (base 16)		Vallox Oy
+				Myllykylantie 9-11
+				Loimaa    32200
+				FI
+
+48-EE-07   (hex)		Silver Palm Technologies LLC
+48EE07     (base 16)		Silver Palm Technologies LLC
+				9639 DOCTOR PERRY RD STE 123N
+				IJAMSVILLE  Maryland  21754
+				US
+
+50-C7-BF   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+50C7BF     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+20-5A-00   (hex)		Coval
+205A00     (base 16)		Coval
+				ZA Les Petits Champs
+				MONTELIER  Drome  26120
+				FR
+
+A8-A6-68   (hex)		zte corporation
+A8A668     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-EE-BD   (hex)		HTC Corporation
+00EEBD     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+38-F7-08   (hex)		National Resource Management, Inc.
+38F708     (base 16)		National Resource Management, Inc.
+				480 Neponset St.  Bldg. #2
+				Canton  MA  02021
+				US
+
+E0-DB-88   (hex)		Open Standard Digital-IF Interface for SATCOM Systems
+E0DB88     (base 16)		Open Standard Digital-IF Interface for SATCOM Systems
+				3090 Raritan Ave
+				Aberdeen Proving Ground  MD  21001
+				US
+
+A8-BD-3A   (hex)		UNIONMAN TECHNOLOGY CO.,LTD
+A8BD3A     (base 16)		UNIONMAN TECHNOLOGY CO.,LTD
+				18F, HUAYANG TOWER,YANDAYI ROAD
+				Huizhou  Guangdong  516007
+				CN
+
+A8-24-EB   (hex)		ZAO NPO Introtest
+A824EB     (base 16)		ZAO NPO Introtest
+				Studencheskaya st. 55
+				Ekaterinburg  Sverdlovsk region  620078
+				RU
+
+C4-0E-45   (hex)		ACK Networks,Inc.
+C40E45     (base 16)		ACK Networks,Inc.
+				Floor3,Building B.,No.1 ShangDi XinXi Rd.
+				  Beijing  100085
+				CN
+
+3C-89-A6   (hex)		KAPELSE
+3C89A6     (base 16)		KAPELSE
+				5 Allee De Saint-Cloud 
+				54600 Villers Les Nancy    
+				FR
+
+A4-6C-C1   (hex)		LTi REEnergy GmbH
+A46CC1     (base 16)		LTi REEnergy GmbH
+				Heinrich-Hertz-Straße 18
+				Unna  North Rhine-Westfalia  59423
+				DE
+
+A8-B9-B3   (hex)		ESSYS
+A8B9B3     (base 16)		ESSYS
+				Daerung Post Tower 5 15F
+				Seoul  Gasan-Dong, Geumchen-gu  153-702
+				KR
+
+6C-09-D6   (hex)		Digiquest Electronics LTD
+6C09D6     (base 16)		Digiquest Electronics LTD
+				26 Park House
+				London    NW11 7PT
+				GB
+
+48-18-42   (hex)		Shanghai Winaas Co. Equipment Co. Ltd.
+481842     (base 16)		Shanghai Winaas Co. Equipment Co. Ltd.
+				8F Building A, WanDa Square
+				  Shanghai  200433
+				CN
+
+44-70-98   (hex)		MING HONG TECHNOLOGY (SHEN ZHEN) LIMITED
+447098     (base 16)		MING HONG TECHNOLOGY (SHEN ZHEN) LIMITED
+				Unit 906,South Block,Resources Tech Building,
+				Shenzhen  Guangdong province  518000
+				CN
+
+9C-BD-9D   (hex)		SkyDisk, Inc.
+9CBD9D     (base 16)		SkyDisk, Inc.
+				2F Tenjin central place,
+				Fukuoka-shi  Fukuoka  810-0001
+				JP
+
+74-C6-21   (hex)		Zhejiang Hite Renewable Energy Co.,LTD
+74C621     (base 16)		Zhejiang Hite Renewable Energy Co.,LTD
+				NO1320,2th Ring Road(South)
+				Tongxiang City  Zhejiang Province  314500
+				CN
+
+D4-31-9D   (hex)		Sinwatec
+D4319D     (base 16)		Sinwatec
+				76 Rikhard Zorge st.
+				Ufa  Bashkortostan  450075
+				RU
+
+B0-68-B6   (hex)		Hangzhou OYE Technology Co. Ltd
+B068B6     (base 16)		Hangzhou OYE Technology Co. Ltd
+				Room 202 Building 12 Wenxinrenjia,
+				Hangzhou  Zhejiang  310051
+				CN
+
+9C-65-F9   (hex)		AcSiP Technology Corp.
+9C65F9     (base 16)		AcSiP Technology Corp.
+				3F-1, No. 207, Fusing Rd.
+				Taoyuan  Taiwan  33066
+				TW
+
+48-76-04   (hex)		Private
+487604     (base 16)		Private
+
+2C-53-4A   (hex)		Shenzhen Winyao Electronic Limited
+2C534A     (base 16)		Shenzhen Winyao Electronic Limited
+				7B Block A Fuqiao Building Fuhua Road
+				Shen Zhen  Guangdong  518000
+				CN
+
+A4-BB-AF   (hex)		Lime Instruments
+A4BBAF     (base 16)		Lime Instruments
+				1187 Brittmoore Road
+				Houston  TX  77043
+				US
+
+F4-90-CA   (hex)		Tensorcom
+F490CA     (base 16)		Tensorcom
+				5900 Pastuer Ct., Suite 105
+				Carlsbad  CA  92008
+				US
+
+E4-4C-6C   (hex)		Shenzhen Guo Wei Electronic Co,. Ltd.
+E44C6C     (base 16)		Shenzhen Guo Wei Electronic Co,. Ltd.
+				No 3038, Lo Sha Road, Liantang
+				Shenzhen  Guangdong  518004
+				CN
+
+A8-57-4E   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+A8574E     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B8-43-E4   (hex)		Vlatacom
+B843E4     (base 16)		Vlatacom
+				Milutina Milankovica 5
+				Belgrade  Serbia  11080
+				RS
+
+28-22-46   (hex)		Beijing Sinoix Communication Co., LTD
+282246     (base 16)		Beijing Sinoix Communication Co., LTD
+				Gehua Tower Room 603
+				  Beijing  100000
+				CN
+
+48-B9-77   (hex)		PulseOn Oy
+48B977     (base 16)		PulseOn Oy
+				Tekniikantie 12
+				ESPOO  Uusimaa  02150
+				FI
+
+70-71-B3   (hex)		Brain Corporation
+7071B3     (base 16)		Brain Corporation
+				5665 Morehouse Dr.
+				San Diego  CA  92121
+				US
+
+64-E6-25   (hex)		Woxu Wireless Co., Ltd
+64E625     (base 16)		Woxu Wireless Co., Ltd
+				B103 Building1 No.6 Changjianghoujie
+				Nanjing    210000
+				US
+
+10-B7-13   (hex)		Private
+10B713     (base 16)		Private
+
+10-0E-7E   (hex)		Juniper Networks
+100E7E     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+20-89-86   (hex)		zte corporation
+208986     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-C5-6F   (hex)		NGN Easy Satfinder (Tianjin) Electronic Co., Ltd
+44C56F     (base 16)		NGN Easy Satfinder (Tianjin) Electronic Co., Ltd
+				A4, Sifang Hi-tech Building, Nankai Hi-tech Industry Area, Ya'an Road, Nankai District
+				  Tianjin  300113
+				US
+
+B8-98-F7   (hex)		Gionee Communication Equipment Co,Ltd.ShenZhen
+B898F7     (base 16)		Gionee Communication Equipment Co,Ltd.ShenZhen
+				21/F Times Technology Building, 7028 Shennan Road,
+				Shenzhen  Guangdong  518040
+				CN
+
+84-83-36   (hex)		Newrun
+848336     (base 16)		Newrun
+				#803 IT Convergence Industry Bldg., Kyungpook National Univ.
+				Daegu  N/A  702-010
+				KR
+
+18-20-12   (hex)		Aztech Associates Inc.
+182012     (base 16)		Aztech Associates Inc.
+				805 Bayridge Dr.
+				Kingston  Ontario  K7P1T5
+				CA
+
+B8-26-6C   (hex)		ANOV France
+B8266C     (base 16)		ANOV France
+				Chemin de Baillot
+				Montauban  Tarn &amp; Garonne  82000
+				FR
+
+3C-30-0C   (hex)		Dewar Electronics Pty Ltd
+3C300C     (base 16)		Dewar Electronics Pty Ltd
+				32 Taylors Road
+				Croydon  Victoria  3136
+				AU
+
+98-FF-D0   (hex)		Lenovo Mobile Communication Technology Ltd.
+98FFD0     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road
+				Xiamen  Fujian  361006
+				CN
+
+A8-75-E2   (hex)		Aventura Technologies, Inc.
+A875E2     (base 16)		Aventura Technologies, Inc.
+				48 Mall Drive
+				Commack  NY  11725
+				US
+
+B8-7A-C9   (hex)		Siemens Ltd.
+B87AC9     (base 16)		Siemens Ltd.
+				885 Mountain Hwy
+				Bayswater  Victoria  3153
+				AU
+
+F0-61-30   (hex)		Advantage Pharmacy Services, LLC
+F06130     (base 16)		Advantage Pharmacy Services, LLC
+				PO Box 7
+				Madison  MO  39130-0007
+				US
+
+6C-3C-53   (hex)		SoundHawk Corp
+6C3C53     (base 16)		SoundHawk Corp
+				20380 Town Center Lane
+				Cupertino  Ca  95014
+				US
+
+08-40-27   (hex)		Gridstore Inc.
+084027     (base 16)		Gridstore Inc.
+				1975 Landings Dr.
+				Mountain View  CA  94043
+				US
+
+38-BF-2F   (hex)		Espec Corp.
+38BF2F     (base 16)		Espec Corp.
+				5-2-5 Kanokodai Minamimachi
+				Kobe City  Hyogo  561-1514
+				JP
+
+44-C4-A9   (hex)		Opticom Communication, LLC
+44C4A9     (base 16)		Opticom Communication, LLC
+				1050 Connecticut Avenue, NW
+				Washington  DC  20036
+				US
+
+C4-82-4E   (hex)		Changzhou Uchip Electronics Co., LTD.
+C4824E     (base 16)		Changzhou Uchip Electronics Co., LTD.
+				Room1801~1802,
+				  Shanghai  201206
+				CN
+
+A4-77-60   (hex)		Nokia Corporation
+A47760     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+C8-56-63   (hex)		Sunflex Europe GmbH
+C85663     (base 16)		Sunflex Europe GmbH
+				Konrad-Zuse-Str. 13
+				Schwerte  NRW  58239
+				DE
+
+88-FE-D6   (hex)		ShangHai WangYong Software Co., Ltd.
+88FED6     (base 16)		ShangHai WangYong Software Co., Ltd.
+				Shanghai Pudong Zhangjiang Hi-Tech Park,
+				Pudong Software Park 22301-283  ShangHai  201203
+				CN
+
+7C-72-E4   (hex)		Unikey Technologies
+7C72E4     (base 16)		Unikey Technologies
+				2250 Lee Rd
+				Winter Park  FL  32789
+				US
+
+7C-20-48   (hex)		KoamTac
+7C2048     (base 16)		KoamTac
+				116 Village Boulevard
+				Princeton  New Jersey  08540
+				US
+
+8C-B7-F7   (hex)		Shenzhen UniStrong Science & Technology Co., Ltd
+8CB7F7     (base 16)		Shenzhen UniStrong Science & Technology Co., Ltd
+				17/F, Global Digital Bldg, Hi-tech Park
+				Shen zhen  Guang dong  518000
+				CN
+
+38-B7-4D   (hex)		Fijowave Limited
+38B74D     (base 16)		Fijowave Limited
+				Synergy Centre
+				    Dublin 24
+				IE
+
+18-0C-14   (hex)		iSonea Limited
+180C14     (base 16)		iSonea Limited
+				125 South Tremont Street
+				Oceanside  CA  92054
+				US
+
+9C-A9-E4   (hex)		zte corporation
+9CA9E4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+90-F3-B7   (hex)		Kirisun Communications Co., Ltd.
+90F3B7     (base 16)		Kirisun Communications Co., Ltd.
+				3-6Flrs, ROBETA Building, 1 QiMin Road, Songping Shan Area, Science & Industry Park, Nanshan District
+				Shenzhen  GuangDong  518057
+				US
+
+C4-E9-2F   (hex)		AB Sciex
+C4E92F     (base 16)		AB Sciex
+				71 Four Valley Drive
+				Concord  Ontario  L4K 4V8
+				US
+
+A8-8D-7B   (hex)		SunDroid Global limited.
+A88D7B     (base 16)		SunDroid Global limited.
+				Room 1305B, Fiyta Science Building,
+				Shenzhen  Guang Dong  518057
+				CN
+
+3C-F7-48   (hex)		Shenzhen Linsn Technology Development Co.,Ltd
+3CF748     (base 16)		Shenzhen Linsn Technology Development Co.,Ltd
+				Floor 4,Block 7,Zone 2,Baiwangxin Industrial Park
+				Shenzhen  Guangdong  518055
+				CN
+
+B0-79-08   (hex)		Cummings Engineering
+B07908     (base 16)		Cummings Engineering
+				145 S. 79th St., Ste. 26
+				Chandler  AZ  85226
+				US
+
+E4-77-23   (hex)		zte corporation
+E47723     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+1C-63-B7   (hex)		OpenProducts 237 AB
+1C63B7     (base 16)		OpenProducts 237 AB
+				Barsebäcksvägen 27
+				Löddeköpinge    24630
+				SE
+
+B4-52-7E   (hex)		Sony Mobile Communications Inc
+B4527E     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+94-B9-B4   (hex)		Aptos Technology
+94B9B4     (base 16)		Aptos Technology
+				5F., No.65, Guangfu N. Rd., Zhongxing Vil.,
+				Hsinchu    303
+				TW
+
+6C-15-F9   (hex)		Nautronix Limited
+6C15F9     (base 16)		Nautronix Limited
+				Blackwood House
+				Aberdeen    AB10 6XU
+				GB
+
+18-AA-45   (hex)		Fon Technology
+18AA45     (base 16)		Fon Technology
+				C/Quintanavides, 15 Edificio 2 Planta 1
+				    
+				ES
+
+90-20-83   (hex)		General Engine Management Systems Ltd.
+902083     (base 16)		General Engine Management Systems Ltd.
+				GEMS
+				Egham  Surrey  TW208RN
+				GB
+
+14-B1-26   (hex)		Industrial Software Co
+14B126     (base 16)		Industrial Software Co
+				85, Aleksandyr Malinov Blvd. Office 6
+				Sofia    1715
+				BG
+
+D8-50-E6   (hex)		ASUSTek COMPUTER INC.
+D850E6     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+DC-3E-F8   (hex)		Nokia Corporation
+DC3EF8     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+A4-9F-89   (hex)		Shanghai Rui Rui Communication Technology Co.Ltd.
+A49F89     (base 16)		Shanghai Rui Rui Communication Technology Co.Ltd.
+				Room 1130,Building No.1
+				  ShangHai  201199
+				CN
+
+70-60-DE   (hex)		LaVision GmbH
+7060DE     (base 16)		LaVision GmbH
+				Anna-Vandenhoeck-Ring 19
+				Goettingen  Niedersachsen  37081
+				DE
+
+50-2E-5C   (hex)		HTC Corporation
+502E5C     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+FC-FE-77   (hex)		Hitachi Reftechno, Inc.
+FCFE77     (base 16)		Hitachi Reftechno, Inc.
+				709-2 Tomita
+				Tochigi-shi  Tochigi-ken  329-4404
+				JP
+
+70-53-3F   (hex)		Alfa Instrumentos Eletronicos Ltda.
+70533F     (base 16)		Alfa Instrumentos Eletronicos Ltda.
+				Rua Coronel Mario de Azevedo, 138
+				Sao Paulo  SP  02710-020
+				BR
+
+40-7A-80   (hex)		Nokia Corporation
+407A80     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+64-42-14   (hex)		Swisscom Energy Solutions AG
+644214     (base 16)		Swisscom Energy Solutions AG
+				Solothurnerstrasse 19
+				Olten    4600
+				CH
+
+0C-A6-94   (hex)		Sunitec Enterprise Co.,Ltd
+0CA694     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+18-44-62   (hex)		Riava Networks, Inc.
+184462     (base 16)		Riava Networks, Inc.
+				Kato Bldg. 1F, 6-12-4 Soto-Kanda
+				Chiyoda-ku  Tokyo  1010021
+				JP
+
+C0-35-80   (hex)		A&R TECH
+C03580     (base 16)		A&R TECH
+				Marksteinergasse 13
+				Vienna    1210
+				AT
+
+D0-8A-55   (hex)		Skullcandy
+D08A55     (base 16)		Skullcandy
+				1441 Ute blvd.
+				Park City  Utah  84098
+				US
+
+34-4F-3F   (hex)		IO-Power Technology Co., Ltd.
+344F3F     (base 16)		IO-Power Technology Co., Ltd.
+				1F., No.100,
+				Hsinchu City    30055
+				TW
+
+14-60-80   (hex)		zte corporation
+146080     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+9C-BB-98   (hex)		Shen Zhen RND Electronic Co.,LTD
+9CBB98     (base 16)		Shen Zhen RND Electronic Co.,LTD
+				G315,Hua Chuang Da business Certer
+				Shen Zhen  Guang Dong  518000
+				CN
+
+50-C2-71   (hex)		SECURETECH INC
+50C271     (base 16)		SECURETECH INC
+				#304, 799 Kwanyang-dong, Dongan-gu,
+				Anyang-ci  Gyunggi-do  431-767
+				KR
+
+CC-72-0F   (hex)		Viscount Systems Inc.
+CC720F     (base 16)		Viscount Systems Inc.
+				4585 Tillicum Street
+				Burnaby  British Columbia  V5J 5K9
+				CA
+
+74-2B-62   (hex)		FUJITSU LIMITED
+742B62     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+64-3F-5F   (hex)		Exablaze
+643F5F     (base 16)		Exablaze
+				Level 6
+				Sydney  NSW  2000
+				AU
+
+8C-2F-39   (hex)		IBA Dosimetry GmbH
+8C2F39     (base 16)		IBA Dosimetry GmbH
+				Bahnhofstrasse 5
+				Schwarzenbruck    90592
+				DE
+
+C0-A0-BB   (hex)		D-Link International
+C0A0BB     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+2C-CD-69   (hex)		Aqavi.com
+2CCD69     (base 16)		Aqavi.com
+				3 Riverway
+				Houston  TX  77056
+				US
+
+F4-5F-69   (hex)		Matsufu Electronics distribution Company
+F45F69     (base 16)		Matsufu Electronics distribution Company
+				Suites 1601~3, Kinwick Centre, 32 Hollywood Road, Hong Kong
+				Hong Kong    
+				HK
+
+28-A1-EB   (hex)		ETEK TECHNOLOGY (SHENZHEN) CO.,LTD
+28A1EB     (base 16)		ETEK TECHNOLOGY (SHENZHEN) CO.,LTD
+				A505-506、A509 Room,A5 Floor, Academy Of International Technology Innovation, Keji Nan 10th Road, Hi-Tech Industrial Park, Shenzhen, P.R.C.
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+B8-F8-28   (hex)		Changshu Gaoshida Optoelectronic Technology Co. Ltd.
+B8F828     (base 16)		Changshu Gaoshida Optoelectronic Technology Co. Ltd.
+				Baimao Industrail Park Changshu  Jiangsu
+				Changshu  Jiangsu  215500
+				CN
+
+3C-1A-57   (hex)		Cardiopulmonary Corp
+3C1A57     (base 16)		Cardiopulmonary Corp
+				200 Cascade Blvd
+				Milford  CT  06460
+				US
+
+54-1B-5D   (hex)		Techno-Innov
+541B5D     (base 16)		Techno-Innov
+				35 rue du champ Blanc
+				Meyzieu  Rhône  69330
+				FR
+
+9C-E7-BD   (hex)		Winduskorea co., Ltd
+9CE7BD     (base 16)		Winduskorea co., Ltd
+				RM313, Seoul-Garden Bldg,
+				Seoul    152-828
+				KR
+
+38-42-A6   (hex)		Ingenieurbuero Stahlkopf
+3842A6     (base 16)		Ingenieurbuero Stahlkopf
+				Ingenieurbuero Stahlkopf
+				Glockengießerweg 2  Bielefeld  33659
+				DE
+
+2C-55-3C   (hex)		Gainspeed, Inc.
+2C553C     (base 16)		Gainspeed, Inc.
+				295 Santa Ana Court
+				Sunnyvale  CA  94085
+				US
+
+24-80-00   (hex)		Westcontrol AS
+248000     (base 16)		Westcontrol AS
+				Breivikvg 7
+				Joerpeland  -  4100
+				US
+
+1C-4B-B9   (hex)		SMG ENTERPRISE, LLC
+1C4BB9     (base 16)		SMG ENTERPRISE, LLC
+				865 LOVE ST
+				ELK GROVE VILLAGE  IL  60007
+				US
+
+34-61-78   (hex)		The Boeing Company
+346178     (base 16)		The Boeing Company
+				325 James S. McDonnell Blvd
+				Hazelwood  MO  63042-2513
+				US
+
+14-46-E4   (hex)		AVISTEL
+1446E4     (base 16)		AVISTEL
+				15 rue Auguste Bartholdi
+				Carrieres sur Seine    78420
+				FR
+
+D0-95-C7   (hex)		Pantech Co., Ltd.
+D095C7     (base 16)		Pantech Co., Ltd.
+				110-1 Ongjeong-Ri, Tongjin-Eup
+				Gimpo-Si  Gyounggi-Do  415-865
+				KR
+
+D0-2C-45   (hex)		littleBits Electronics, Inc.
+D02C45     (base 16)		littleBits Electronics, Inc.
+				60 E. 11th Street
+				New York  NY  10003
+				US
+
+04-4F-8B   (hex)		Adapteva, Inc.
+044F8B     (base 16)		Adapteva, Inc.
+				1666 Massachusetts Ave
+				Lexington  MA  02420
+				US
+
+B4-A8-2B   (hex)		Histar Digital Electronics Co., Ltd.
+B4A82B     (base 16)		Histar Digital Electronics Co., Ltd.
+				 Room 616,Block A,
+				Shenzhen  Baoan  518133
+				CN
+
+28-4D-92   (hex)		Luminator
+284D92     (base 16)		Luminator
+				900 Klein Road
+				Plano  Texas  75074
+				US
+
+54-FB-58   (hex)		WISEWARE, Lda
+54FB58     (base 16)		WISEWARE, Lda
+				Centro Social e Administrativo da ZIV
+				Zona Industrial de Vagos  Portugal  3840-385
+				PT
+
+94-0B-D5   (hex)		Himax Technologies, Inc
+940BD5     (base 16)		Himax Technologies, Inc
+				No.26, Zilian Rd., Xinshi Dist.
+				Tainan City    741
+				TW
+
+E0-D1-E6   (hex)		Aliph dba Jawbone
+E0D1E6     (base 16)		Aliph dba Jawbone
+				99 Rhode Island Street
+				San Francisco  California  94103
+				US
+
+D8-2D-9B   (hex)		Shenzhen G.Credit Communication Technology Co., Ltd
+D82D9B     (base 16)		Shenzhen G.Credit Communication Technology Co., Ltd
+				4/F, Suite A, XinNengYuan Building, 2239 Nanhai Rd., Nanshan Dist., Shenzhen, Guangdong,China
+				Shenzhen  Guangdong  518054
+				CN
+
+70-9B-FC   (hex)		Bryton Inc.
+709BFC     (base 16)		Bryton Inc.
+				6F., No. 100, Zhouzi St., Neihu Dist.
+				Taipei City    11493
+				US
+
+AC-E4-2E   (hex)		SK hynix
+ACE42E     (base 16)		SK hynix
+				SK u-Tower, 25-1, Jeongja-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-844
+				KR
+
+78-FE-41   (hex)		Socus networks
+78FE41     (base 16)		Socus networks
+				2F.-2, No.215, Sec. 2, Chengde Rd., Datong Dist.,
+				Taipei City    103
+				TW
+
+20-57-21   (hex)		Salix Technology CO., Ltd.
+205721     (base 16)		Salix Technology CO., Ltd.
+				5F., No. 16, Lane 77, Hsing Ai Road
+				Taipei    114
+				TW
+
+88-36-12   (hex)		SRC Computers, LLC
+883612     (base 16)		SRC Computers, LLC
+				4240 N. Nevada Avenue
+				Colorado Springs  CO  80907
+				US
+
+08-35-71   (hex)		CASwell INC.
+083571     (base 16)		CASwell INC.
+				8F,No.242,Bo-Ai St., Shu-Lin Dist.,New Taipei City ,Taiwan.
+				New Taipei City  Taiwan  23845
+				TW
+
+98-76-B6   (hex)		Adafruit
+9876B6     (base 16)		Adafruit
+				150 Varick st
+				New York  NY  10013
+				US
+
+50-3C-C4   (hex)		Lenovo Mobile Communication Technology Ltd.
+503CC4     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,
+				Xiamen  Fujian  361006
+				US
+
+2C-7B-84   (hex)		OOO Petr Telegin
+2C7B84     (base 16)		OOO Petr Telegin
+				Gagarin avenue, 37, build P1
+				  Nizhny Novgorod  603009
+				RU
+
+A4-C0-C7   (hex)		ShenZhen Hitom Communication Technology Co..LTD
+A4C0C7     (base 16)		ShenZhen Hitom Communication Technology Co..LTD
+				Room 110,Unit A,No.1 Chuangye Building,43# YanShan Road,Shekou Area
+				ShenZhen  GuangDong  518052
+				CN
+
+30-61-12   (hex)		PAV GmbH
+306112     (base 16)		PAV GmbH
+				Georg-Kaindl-Straße 11
+				Otterfing    83624
+				DE
+
+78-9F-4C   (hex)		HOERBIGER Elektronik GmbH
+789F4C     (base 16)		HOERBIGER Elektronik GmbH
+				Justinus-Kernerstr. 7
+				Ammerbuch  Baden-Wuerttemberg  D-72119
+				DE
+
+18-10-4E   (hex)		CEDINT-UPM
+18104E     (base 16)		CEDINT-UPM
+				Campus de Montegancedo
+				  Madrid  
+				ES
+
+9C-14-65   (hex)		Edata Elektronik San. ve Tic. A.Ş.
+9C1465     (base 16)		Edata Elektronik San. ve Tic. A.Ş.
+				Tantavi Mahallesi Menteşoğlu Cad.
+				İstanbul  -  34764
+				TR
+
+4C-55-CC   (hex)		Zentri Pty Ltd
+4C55CC     (base 16)		Zentri Pty Ltd
+				Level 9, 191 Clarence St,
+				Sydney  NSW  2000
+				AU
+
+00-C5-DB   (hex)		Datatech Sistemas Digitales Avanzados SL
+00C5DB     (base 16)		Datatech Sistemas Digitales Avanzados SL
+				Cardenal Herrera Oria 165
+				  Madrid  28034
+				ES
+
+8C-F9-45   (hex)		Power Automation pte Ltd
+8CF945     (base 16)		Power Automation pte Ltd
+				28 Ayer Rajah Crescent
+				    139959
+				SG
+
+F8-42-FB   (hex)		Yasuda Joho Co.,ltd.
+F842FB     (base 16)		Yasuda Joho Co.,ltd.
+				1-11-1
+				Minato-ku  Tokyo  105-0022
+				JP
+
+88-73-98   (hex)		K2E Tekpoint
+887398     (base 16)		K2E Tekpoint
+				201,Winstower,278-51,Sungsoo2ga 3dong,Sungdong-gu,Seoul,S.Korea,133-123
+				Seoul  Sungdong-gu  133-123
+				KR
+
+2C-92-2C   (hex)		Kishu Giken Kogyou Company Ltd,.
+2C922C     (base 16)		Kishu Giken Kogyou Company Ltd,.
+				466 Nunohiki
+				Wakayama city  Wakayama prefecture  6410015
+				JP
+
+D8-FE-E3   (hex)		D-Link International
+D8FEE3     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+58-F3-87   (hex)		HCCP
+58F387     (base 16)		HCCP
+				Gabriel Metsulaan 4a
+				EINDHOVEN    5611SP
+				NL
+
+3C-97-7E   (hex)		IPS Technology Limited
+3C977E     (base 16)		IPS Technology Limited
+				7 Floor,E  block,Dong Hai Wang Building
+				Shenzhen  Guangodng  518000
+				CN
+
+A4-FB-8D   (hex)		Hangzhou Dunchong Technology Co.Ltd
+A4FB8D     (base 16)		Hangzhou Dunchong Technology Co.Ltd
+				Yitian Square 1#401A
+				hangzhou  zhejiang  310051
+				US
+
+F4-CD-90   (hex)		Vispiron Rotec GmbH
+F4CD90     (base 16)		Vispiron Rotec GmbH
+				Frankfurter Ring 224
+				München  Bayern  80807
+				DE
+
+80-6C-8B   (hex)		KAESER KOMPRESSOREN AG
+806C8B     (base 16)		KAESER KOMPRESSOREN AG
+				Carl-Kaeser-Strasse 26
+				Coburg  Bavaria  96450
+				DE
+
+04-3D-98   (hex)		ChongQing QingJia Electronics CO.,LTD
+043D98     (base 16)		ChongQing QingJia Electronics CO.,LTD
+				No.1,DianCe Village JiangBei District
+				  Chongqing city  400020
+				CN
+
+E0-3E-4A   (hex)		Cavanagh Group International
+E03E4A     (base 16)		Cavanagh Group International
+				9180 Four Mile Creek Rd.
+				Gainesville  GA  30506
+				US
+
+04-1B-94   (hex)		Host Mobility AB
+041B94     (base 16)		Host Mobility AB
+				Anders Personsgatan 12
+				Gothenburg  Vastra Gotaland  41664
+				SE
+
+A0-CE-C8   (hex)		CE LINK LIMITED
+A0CEC8     (base 16)		CE LINK LIMITED
+				2/F, Building G, Licheng Tech. Ind. Zone
+				Shenzhen  Guangdong  518104
+				CN
+
+90-7A-28   (hex)		Beijing Morncloud Information And Technology Co. Ltd.
+907A28     (base 16)		Beijing Morncloud Information And Technology Co. Ltd.
+				A#1107, XiaoYun center
+				Chaoyang District  Beijing  100125
+				CN
+
+10-01-CA   (hex)		Ashley Butterworth
+1001CA     (base 16)		Ashley Butterworth
+				P.O. Box 3410
+				Santa Clara  CA  95055
+				US
+
+24-6A-AB   (hex)		IT-IS International
+246AAB     (base 16)		IT-IS International
+				1 Wainstones Court
+				Middlesbrough  Cleveland  TS9 5JY
+				GB
+
+FC-4B-BC   (hex)		Sunplus Technology Co., Ltd.
+FC4BBC     (base 16)		Sunplus Technology Co., Ltd.
+				No.19, Innovation First Road
+				Hsinchu City    300
+				TW
+
+50-A0-BF   (hex)		Alba Fiber Systems Inc.
+50A0BF     (base 16)		Alba Fiber Systems Inc.
+				265 E. Merrick Rd
+				Valley Stream  NY  11580
+				US
+
+B8-36-D8   (hex)		Videoswitch
+B836D8     (base 16)		Videoswitch
+				Uspallata 3579
+				Buenos Aires  Capital Federal  C1437JCS
+				AR
+
+DC-6F-00   (hex)		Livescribe, Inc.
+DC6F00     (base 16)		Livescribe, Inc.
+				7677 Oakport Street
+				Oakland  California  94621
+				US
+
+54-E3-B0   (hex)		JVL Industri Elektronik
+54E3B0     (base 16)		JVL Industri Elektronik
+				Blokken 42
+				Birkeroed  Sjaelland  DK-3460
+				DK
+
+80-4B-20   (hex)		Ventilation Control
+804B20     (base 16)		Ventilation Control
+				Kronenstrasse 34
+				Villingen-Schwenningen  Baden-Wuerttemberg  78054
+				DE
+
+28-79-94   (hex)		Realplay Digital Technology(Shenzhen) Co.,Ltd
+287994     (base 16)		Realplay Digital Technology(Shenzhen) Co.,Ltd
+				7/F,Building E,SDG Information Port ,Kefeng Rd.,Hi-tech
+				Shenzhen  Guangdong  518057
+				CN
+
+10-7A-86   (hex)		U&U ENGINEERING INC.
+107A86     (base 16)		U&U ENGINEERING INC.
+				No.15, Gaoyang S. Rd
+				Taoyuan County    325-44
+				TW
+
+40-BD-9E   (hex)		Physio-Control, Inc
+40BD9E     (base 16)		Physio-Control, Inc
+				11811 Willows Rd NE
+				Redmond  WA  98052
+				US
+
+6C-57-79   (hex)		Aclima, Inc.
+6C5779     (base 16)		Aclima, Inc.
+				10 Lombard Street
+				San Francisco  California  94111
+				US
+
+C0-DA-74   (hex)		Hangzhou Sunyard Technology Co., Ltd.
+C0DA74     (base 16)		Hangzhou Sunyard Technology Co., Ltd.
+				No.3888 Jiangnan Ave, Binjiang District,
+				Hangzhou  Zhejiang  310053
+				CN
+
+18-D6-CF   (hex)		Kurth Electronic GmbH
+18D6CF     (base 16)		Kurth Electronic GmbH
+				Mühleweg 11
+				Eningen    72800
+				DE
+
+F4-81-39   (hex)		CANON INC.
+F48139     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+18-36-FC   (hex)		Elecsys International Corporation
+1836FC     (base 16)		Elecsys International Corporation
+				846 N Mart-Way Court
+				Olathe  KS  66061
+				US
+
+A4-D0-94   (hex)		Erwin Peters Systemtechnik GmbH
+A4D094     (base 16)		Erwin Peters Systemtechnik GmbH
+				Josef Baumann Strasse 37
+				Bochum    D44805
+				DE
+
+88-23-64   (hex)		Watchnet DVR Inc
+882364     (base 16)		Watchnet DVR Inc
+				Unit 5 - 351 Ferrier St.
+				Markham  Ontario  L3R 5Z2
+				CA
+
+58-1C-BD   (hex)		Affinegy
+581CBD     (base 16)		Affinegy
+				1705 S. Capital of Texas Hwy. Ste 310
+				Austin  Texas  78746
+				US
+
+28-4F-CE   (hex)		Liaoning Wontel Science and Technology Development Co.,Ltd.
+284FCE     (base 16)		Liaoning Wontel Science and Technology Development Co.,Ltd.
+				A704 Floor TaiHe building
+				Shenyang  Liaoning  110000
+				CN
+
+04-8D-38   (hex)		Netcore Technology Inc.
+048D38     (base 16)		Netcore Technology Inc.
+				9F,B block,Tsinghua Information Guard
+				Shenzhen  Guangdong  518057
+				CN
+
+2C-94-64   (hex)		Cincoze Co., Ltd.
+2C9464     (base 16)		Cincoze Co., Ltd.
+				7F., No. 4 Aly. 1 Ln. 235, Baociao Rd.,
+				New Taipei City    23145
+				US
+
+30-65-EC   (hex)		Wistron (ChongQing)
+3065EC     (base 16)		Wistron (ChongQing)
+				No.F08/F09,D zone,Konggang Functional Zone
+				  ChongQing  401120
+				CN
+
+54-2C-EA   (hex)		PROTECTRON
+542CEA     (base 16)		PROTECTRON
+				140 zone industriel
+				  CASABLANCA  18600
+				MA
+
+94-B8-C5   (hex)		RuggedCom Inc.
+94B8C5     (base 16)		RuggedCom Inc.
+				300 Applewood Crescent
+				Concord  Ontario  L4K 5C7
+				CA
+
+DC-82-5B   (hex)		JANUS, spol. s r.o.
+DC825B     (base 16)		JANUS, spol. s r.o.
+				Sarajevska 8
+				Prague  Czech Republic  12000
+				CZ
+
+9C-A5-77   (hex)		Osorno Enterprises Inc.
+9CA577     (base 16)		Osorno Enterprises Inc.
+				976 Elgin Ave
+				Winnipeg  MB  R3E 1B4
+				CA
+
+C0-43-01   (hex)		Epec Oy
+C04301     (base 16)		Epec Oy
+				P.O. Box 194
+				Seinäjoki    60101
+				FI
+
+E0-7C-62   (hex)		Whistle Labs, Inc.
+E07C62     (base 16)		Whistle Labs, Inc.
+				251 Rhode Island Street, Suite 211
+				San Francisco  CA  94013
+				US
+
+F0-7F-0C   (hex)		Leopold Kostal GmbH &Co. KG
+F07F0C     (base 16)		Leopold Kostal GmbH &Co. KG
+				An der Bellmerei 10
+				Luedenscheid  NRW  D-58513
+				DE
+
+4C-62-55   (hex)		SANMINA-SCI SYSTEM DE MEXICO S.A. DE C.V.
+4C6255     (base 16)		SANMINA-SCI SYSTEM DE MEXICO S.A. DE C.V.
+				Carretera Guadalajara-chapala km 15.5 #45
+				TLAJOMULCO  JALISCO  45640
+				MX
+
+08-27-19   (hex)		APS systems/electronic AG
+082719     (base 16)		APS systems/electronic AG
+				Neumatt 4
+				Niederbuchsiten  SO  4626
+				CH
+
+50-5A-C6   (hex)		GUANGDONG SUPER TELECOM CO.,LTD.
+505AC6     (base 16)		GUANGDONG SUPER TELECOM CO.,LTD.
+				4/F,NO.1025-1027 Gaopu Rd
+				Guangzhou  Guangdong  510663
+				CN
+
+9C-79-AC   (hex)		Suntec Software(Shanghai) Co., Ltd.
+9C79AC     (base 16)		Suntec Software(Shanghai) Co., Ltd.
+				17F New Hualian Mansion
+				  Shanghai  200020
+				CN
+
+4C-96-14   (hex)		Juniper Networks
+4C9614     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+B8-63-BC   (hex)		ROBOTIS, Co, Ltd
+B863BC     (base 16)		ROBOTIS, Co, Ltd
+				#1506 Ace high End Tower 3, 371-50
+				Seoul    153-787
+				KR
+
+98-0D-2E   (hex)		HTC Corporation
+980D2E     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+C4-19-EC   (hex)		Qualisys AB
+C419EC     (base 16)		Qualisys AB
+				Packhusgatan 6
+				Gothenburg    41113
+				SE
+
+60-4A-1C   (hex)		SUYIN Corporation
+604A1C     (base 16)		SUYIN Corporation
+				No.377,Fude 1st Rd
+				Taipei    221
+				TW
+
+D4-64-F7   (hex)		CHENGDU USEE DIGITAL TECHNOLOGY CO., LTD
+D464F7     (base 16)		CHENGDU USEE DIGITAL TECHNOLOGY CO., LTD
+				NO.6 CHUANGYE ROAD
+				CHENGDU  SICHUAN  610041
+				CN
+
+74-D0-2B   (hex)		ASUSTek COMPUTER INC.
+74D02B     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+60-1E-02   (hex)		EltexAlatau
+601E02     (base 16)		EltexAlatau
+				Ibragimova 9
+				Almaty  Province  050032
+				KZ
+
+E0-C6-B3   (hex)		MilDef AB
+E0C6B3     (base 16)		MilDef AB
+				Box 22079
+				Helsingborg  Skane  25022
+				SE
+
+64-72-D8   (hex)		GooWi Technology Co.,Limited
+6472D8     (base 16)		GooWi Technology Co.,Limited
+				Unit C8.,9/F,Hongming Fatoty Building
+				99 How Ming Street  Kwun Tong  999077
+				HK
+
+60-60-1F   (hex)		SZ DJI TECHNOLOGY CO.,LTD
+60601F     (base 16)		SZ DJI TECHNOLOGY CO.,LTD
+				6/F,HKUST SZ IER Bldg,9 Yuexing 1st Rd
+				shenzhen  guangdong  518057
+				CN
+
+5C-84-86   (hex)		Brightsource Industries Israel LTD
+5C8486     (base 16)		Brightsource Industries Israel LTD
+				11 Kiryat Mada st
+				Jerusalem    91450
+				IL
+
+50-CD-32   (hex)		NanJing Chaoran Science & Technology Co.,Ltd.
+50CD32     (base 16)		NanJing Chaoran Science & Technology Co.,Ltd.
+				 Block C,Floor 5,Tianzexingwang Building
+				NanJing City  JiangSu Province  210019
+				CN
+
+BC-BA-E1   (hex)		AREC Inc.
+BCBAE1     (base 16)		AREC Inc.
+				3F, No.367, Sec.2, Wenhua Rd
+				 Banqiao Dist  New Taipei City  220
+				TW
+
+18-FA-6F   (hex)		ISC applied systems corp
+18FA6F     (base 16)		ISC applied systems corp
+				295 Labrosse
+				Pointe-claire  QC  H9R-1A3
+				CA
+
+A0-1C-05   (hex)		NIMAX TELECOM CO.,LTD.
+A01C05     (base 16)		NIMAX TELECOM CO.,LTD.
+				1F. NO.308-7,SEC.1,DATONG RD
+				NEW TAIPEI CITY    221
+				TW
+
+60-E0-0E   (hex)		SHINSEI ELECTRONICS CO LTD
+60E00E     (base 16)		SHINSEI ELECTRONICS CO LTD
+				2-6-25
+				Amagasaki  Hyogo  660-0805
+				JP
+
+54-54-14   (hex)		Digital RF Corea, Inc
+545414     (base 16)		Digital RF Corea, Inc
+				2 Floor, SeMin B/D, 201, Jangdari-ro
+				Suwon-si  Gyeonggi-do  442-833
+				KR
+
+24-EB-65   (hex)		SAET I.S. S.r.l.
+24EB65     (base 16)		SAET I.S. S.r.l.
+				Via Leinì 1/B
+				San Maurizio C.se  TO  10077
+				IT
+
+D0-F2-7F   (hex)		SteadyServ Technoligies, LLC
+D0F27F     (base 16)		SteadyServ Technoligies, LLC
+				12895 Brighton Avenue
+				Carmel  IN  46032
+				US
+
+E8-94-F6   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+E894F6     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+18-84-10   (hex)		CoreTrust Inc.
+188410     (base 16)		CoreTrust Inc.
+				14F Saman Bldg. 945 Daechi-dong
+				Seoul  Republic of Korea  135-280
+				KR
+
+FC-22-9C   (hex)		Han Kyung I Net Co.,Ltd.
+FC229C     (base 16)		Han Kyung I Net Co.,Ltd.
+				3F,Seung Eun Bldg
+				Yu Seong-Gu  Dae Jeon  305-335
+				KR
+
+18-32-A2   (hex)		LAON TECHNOLOGY CO., LTD.
+1832A2     (base 16)		LAON TECHNOLOGY CO., LTD.
+				#1212 HO, BIZ CENTER, SKn TECHNOPARK
+				SEONGNAM  KYOUNGGI DO  462-721
+				KR
+
+D4-A4-99   (hex)		InView Technology Corporation
+D4A499     (base 16)		InView Technology Corporation
+				8900 Shoal Creek Blvd
+				Austin  TX  78757
+				US
+
+08-48-2C   (hex)		Raycore Taiwan Co., LTD.
+08482C     (base 16)		Raycore Taiwan Co., LTD.
+				3F-5, No.351, Sec.2, Zongshan Rd
+				New Taipei city    23504
+				TW
+
+DC-2B-CA   (hex)		Zera GmbH
+DC2BCA     (base 16)		Zera GmbH
+				Hauptstrasse 392
+				Koenigswinter  NRW  53639
+				DE
+
+94-98-A2   (hex)		Shanghai LISTEN TECH.LTD
+9498A2     (base 16)		Shanghai LISTEN TECH.LTD
+				7F,A#,NO.3699,Gonghexin Road
+				SHANGHAI  SHANGHAI  200435
+				CN
+
+E0-ED-C7   (hex)		Shenzhen Friendcom Technology Development Co., Ltd
+E0EDC7     (base 16)		Shenzhen Friendcom Technology Development Co., Ltd
+				6/F,17 Building, Guangqian Industrial Park,
+				Nanshan District, Shen Zhen CIty  Guang Dong  518055
+				CN
+
+B4-DD-15   (hex)		ControlThings Oy Ab
+B4DD15     (base 16)		ControlThings Oy Ab
+				Werner Söderströmin katu 24
+				Porvoo  Finland  06100
+				FI
+
+DC-1D-D4   (hex)		Microstep-MIS spol. s r.o.
+DC1DD4     (base 16)		Microstep-MIS spol. s r.o.
+				Cavojskeho 1
+				Bratislava    84104
+				SK
+
+FC-DD-55   (hex)		Shenzhen WeWins wireless Co.,Ltd
+FCDD55     (base 16)		Shenzhen WeWins wireless Co.,Ltd
+				6/F.,B Wing,Yuehai Piaza,Nanhai Road
+				Shenzhen  Guangdong  518000
+				CN
+
+B0-17-43   (hex)		EDISON GLOBAL CIRCUITS LLC
+B01743     (base 16)		EDISON GLOBAL CIRCUITS LLC
+				1475  Sawdust Rd
+				Spring  TX  77380-2974
+				US
+
+D0-BE-2C   (hex)		CNSLink Co., Ltd.
+D0BE2C     (base 16)		CNSLink Co., Ltd.
+				room 807, Jungang Induspia 5
+				Seongnam  Gyeonggi  462-807
+				US
+
+40-51-6C   (hex)		Grandex International Corporation
+40516C     (base 16)		Grandex International Corporation
+				4F, 525 Chung Cheng Road
+				Hsin Tien Dist.  New Taipei City  231
+				TW
+
+C0-88-5B   (hex)		SnD Tech Co., Ltd.
+C0885B     (base 16)		SnD Tech Co., Ltd.
+				 1140-4 Triple Tower C-406
+				Bucheon Si  Gyeonggi-Do  420-852
+				KR
+
+3C-FB-96   (hex)		Emcraft Systems LLC
+3CFB96     (base 16)		Emcraft Systems LLC
+				2191 S. El Camino Real
+				Oceanside  CA  92054
+				US
+
+84-62-23   (hex)		Shenzhen Coship Electronics Co., Ltd.
+846223     (base 16)		Shenzhen Coship Electronics Co., Ltd.
+				Rainbow Bldg., North, Hi-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+1C-FA-68   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+1CFA68     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+08-1F-3F   (hex)		WondaLink Inc.
+081F3F     (base 16)		WondaLink Inc.
+				2F, No. 23, R&D Road 2
+				Hsinchu    300
+				TW
+
+18-53-E0   (hex)		Hanyang Digitech Co.Ltd
+1853E0     (base 16)		Hanyang Digitech Co.Ltd
+				103, BANWOL-DONG, HWASEONG-SI, KYUNGGI-DO, KOREA
+				HWASEONG  KYUNGGI  445-330
+				KR
+
+00-C1-4F   (hex)		DDL Co,.ltd.
+00C14F     (base 16)		DDL Co,.ltd.
+				6F AFT BLDG.
+				SAPPORO  HOKKAIDO  060-0035
+				JP
+
+2C-26-C5   (hex)		zte corporation
+2C26C5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-5F-06   (hex)		Actiontec Electronics, Inc
+105F06     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+08-79-99   (hex)		AIM GmbH
+087999     (base 16)		AIM GmbH
+				Sasbacherstraße 2
+				Freiburg  BW  79111
+				US
+
+C0-11-A6   (hex)		Fort-Telecom ltd.
+C011A6     (base 16)		Fort-Telecom ltd.
+				Hrustalnaya 8a
+				  Perm  614107
+				RU
+
+C0-4A-00   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C04A00     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+04-5F-A7   (hex)		Shenzhen Yichen Technology Development Co.,LTD
+045FA7     (base 16)		Shenzhen Yichen Technology Development Co.,LTD
+				5/F Honghualing 2nd Industry Zone,Xili Town
+				Shenzhen  Guangdong  518055
+				CN
+
+94-C9-62   (hex)		Teseq AG
+94C962     (base 16)		Teseq AG
+				Nordstrasse 11F
+				Luterbach  Solothurn  4542
+				CH
+
+DC-2A-14   (hex)		Shanghai Longjing Technology Co.
+DC2A14     (base 16)		Shanghai Longjing Technology Co.
+				689 Chundong Road, Minhang District
+				  Shanghai  201108
+				CN
+
+68-86-E7   (hex)		Orbotix, Inc.
+6886E7     (base 16)		Orbotix, Inc.
+				1155 Canyon Blvd.
+				Boulder  CO  80302
+				US
+
+C0-5E-6F   (hex)		V. Stonkaus firma Kodinis Raktas
+C05E6F     (base 16)		V. Stonkaus firma Kodinis Raktas
+				Ateities 10
+				  Vilnius  08303
+				LT
+
+C0-B8-B1   (hex)		BitBox Ltd
+C0B8B1     (base 16)		BitBox Ltd
+				Whitney Road
+				Basingstoke  Hampshire  RG24 8NS
+				GB
+
+F8-2E-DB   (hex)		RTW GmbH & Co. KG
+F82EDB     (base 16)		RTW GmbH & Co. KG
+				Am Wassermann 25
+				Cologne  NRW  50829
+				DE
+
+80-8B-5C   (hex)		Shenzhen Runhuicheng Technology Co., Ltd
+808B5C     (base 16)		Shenzhen Runhuicheng Technology Co., Ltd
+				315.3rd Floor Taoyuan Commercial Building A2 ridgepole Guang Qian Industrial Estate XiLi
+				Shenzhen  Guangdong  518052
+				CN
+
+D8-19-CE   (hex)		Telesquare
+D819CE     (base 16)		Telesquare
+				670, Sampyeong-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+E0-CE-C3   (hex)		ASKEY COMPUTER CORP
+E0CEC3     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+38-F5-97   (hex)		home2net GmbH
+38F597     (base 16)		home2net GmbH
+				Im Haslet 42
+				Woerth/Donau  Bayern  93086
+				DE
+
+80-7B-1E   (hex)		Corsair Memory, Inc.
+807B1E     (base 16)		Corsair Memory, Inc.
+				47100 Bayside Parkway
+				Fremont  CA  94538
+				US
+
+B4-AB-2C   (hex)		MtM Technology Corporation
+B4AB2C     (base 16)		MtM Technology Corporation
+				12F, No. 186, Fuxing Road
+				Taoyuan City  Taoyuan County  33066
+				TW
+
+74-37-2F   (hex)		Tongfang Shenzhen Cloudcomputing Technology Co.,Ltd
+74372F     (base 16)		Tongfang Shenzhen Cloudcomputing Technology Co.,Ltd
+				4,1 Building,FinanceBase,NO.8KeFaRoad,Science park
+				ShenZhen City  GuangDong  518057
+				US
+
+F0-21-9D   (hex)		Cal-Comp Electronics & Communications Company Ltd.
+F0219D     (base 16)		Cal-Comp Electronics & Communications Company Ltd.
+				No.147, Sec. 3, Beishen Rd
+				Shenkeng Dist  New Taipei City  ---
+				TW
+
+18-17-25   (hex)		Cameo Communications, Inc.
+181725     (base 16)		Cameo Communications, Inc.
+				No. 276, Sinhu 1st Rd., Neihu District,
+				Taipei    114
+				TW
+
+84-62-A6   (hex)		EuroCB (Phils), Inc.
+8462A6     (base 16)		EuroCB (Phils), Inc.
+				SFB No.2
+				Lapulapu CIty  Cebu  6015
+				PH
+
+E4-F3-65   (hex)		Time-O-Matic, Inc.
+E4F365     (base 16)		Time-O-Matic, Inc.
+				1015 Maple St.
+				Danville  IL  61832
+				US
+
+DC-C0-DB   (hex)		Shenzhen Kaiboer Technology Co., Ltd.
+DCC0DB     (base 16)		Shenzhen Kaiboer Technology Co., Ltd.
+				4/F, No. 11 Bldg., Yusheng Industrial Park, No. 467, Xixiang Sec.,
+				Shenzhen  Guangdong  518126
+				CN
+
+AC-5D-10   (hex)		Pace Americas
+AC5D10     (base 16)		Pace Americas
+				1764 Automation Parkway
+				San Jose  Ca  95131
+				US
+
+FC-62-6E   (hex)		Beijing MDC Telecom
+FC626E     (base 16)		Beijing MDC Telecom
+				26 Xiaoyun Road #B2808, Chaoyang
+				  Beijing  100016
+				CN
+
+84-C8-B1   (hex)		Incognito Software Systems Inc.
+84C8B1     (base 16)		Incognito Software Systems Inc.
+				#500 - 375 Water St
+				Vancouver  BC - British Columbia  V6B 5C6
+				CA
+
+E8-A3-64   (hex)		Signal Path International / Peachtree Audio
+E8A364     (base 16)		Signal Path International / Peachtree Audio
+				2045 120th Ave NE
+				Bellevue  Washington  98005
+				US
+
+BC-51-FE   (hex)		Swann communications Pty Ltd
+BC51FE     (base 16)		Swann communications Pty Ltd
+				Unit 13
+				Port Melbourne  Victoria  3207
+				AU
+
+88-F4-90   (hex)		Jetmobile Pte Ltd
+88F490     (base 16)		Jetmobile Pte Ltd
+				541 Orchard Road
+				Singapore    238881
+				SG
+
+1C-91-79   (hex)		Integrated System Technologies Ltd
+1C9179     (base 16)		Integrated System Technologies Ltd
+				Suite 5 Birch House
+				Aldridge  West Midlands  WS9 0NF
+				GB
+
+A0-BA-B8   (hex)		Pixon Imaging
+A0BAB8     (base 16)		Pixon Imaging
+				9530 Towne Center Dr.
+				San Diego  CA  92121
+				US
+
+74-E4-24   (hex)		APISTE CORPORATION
+74E424     (base 16)		APISTE CORPORATION
+				1-4-16 Dojimahama, Kita-ku
+				Osaka  Japan  530-0004
+				JP
+
+24-11-D0   (hex)		Chongqing Ehs Science and Technology Development Co.,Ltd.
+2411D0     (base 16)		Chongqing Ehs Science and Technology Development Co.,Ltd.
+				Saturn Business Center C3-15-7,Starlight No.5 Street
+				  Chongqing  400060
+				CN
+
+B4-61-FF   (hex)		Lumigon A/S
+B461FF     (base 16)		Lumigon A/S
+				Baadehavnsgade 2A
+				Copenhagen SV  Denmark  2450
+				DK
+
+A0-A1-30   (hex)		DLI Taiwan Branch office
+A0A130     (base 16)		DLI Taiwan Branch office
+				No.18-5, No.738. Zhong Zheng Rd
+				Taipei New City    23511
+				TW
+
+30-21-5B   (hex)		Shenzhen Ostar Display Electronic Co.,Ltd
+30215B     (base 16)		Shenzhen Ostar Display Electronic Co.,Ltd
+				Room218, CASTD Incubator Building, High-tech South Street No.1,
+				Shenzhen  Guangdong  518057
+				CN
+
+34-FA-40   (hex)		Guangzhou Robustel Technologies Co., Limited
+34FA40     (base 16)		Guangzhou Robustel Technologies Co., Limited
+				B301, Tianchang Shangmaoyuan
+				Guangzhou  Guangdong  510660
+				CN
+
+1C-5A-6B   (hex)		Philips Electronics Nederland BV
+1C5A6B     (base 16)		Philips Electronics Nederland BV
+				PO BOX 80045
+				 Eindhoven    5600 JZ
+				NL
+
+A8-75-D6   (hex)		FreeTek International Co., Ltd.
+A875D6     (base 16)		FreeTek International Co., Ltd.
+				Unit D, 15/F, Tai Ping Ind.Ctr., Blk 2, 55 Ting Kok Rd.,
+				Hong Kong  Hong KOng  1111
+				HK
+
+EC-E9-15   (hex)		STI Ltd
+ECE915     (base 16)		STI Ltd
+				Osborn Way
+				Hook  Hampshire  RG27 9HX
+				GB
+
+80-D7-33   (hex)		QSR Automations, Inc.
+80D733     (base 16)		QSR Automations, Inc.
+				2301 Stanley Gault Pkwy
+				Louisville  KY  40223
+				US
+
+30-3D-08   (hex)		GLINTT TES S.A.
+303D08     (base 16)		GLINTT TES S.A.
+				Beloura Office Park, Ed.10
+				Sintra    2710-693
+				PT
+
+A8-1F-AF   (hex)		KRYPTON POLSKA
+A81FAF     (base 16)		KRYPTON POLSKA
+				AL. JEROZOLIMSKIE 131
+				WARSZAWA  MAZOWIECKIE  02-304
+				PL
+
+30-D3-57   (hex)		Logosol, Inc.
+30D357     (base 16)		Logosol, Inc.
+				5041 ROBERT J. MATHEWS PARKWAY
+				EL DORADO HILLS  California  95762
+				US
+
+BC-39-A6   (hex)		CSUN System Technology Co.,LTD
+BC39A6     (base 16)		CSUN System Technology Co.,LTD
+				4-16-22,Chiyogaoka
+				Kawasaki-shi  Kanagawa Ken  2150005
+				JP
+
+EC-B5-41   (hex)		SHINANO E and E Co.Ltd.
+ECB541     (base 16)		SHINANO E and E Co.Ltd.
+				5511-6 Wada
+				Matsumoto City  Nagano  390-1242
+				JP
+
+D4-10-CF   (hex)		Huanshun Network Science and Technology Co., Ltd.
+D410CF     (base 16)		Huanshun Network Science and Technology Co., Ltd.
+				No. 218-1, North Binjiang Road
+				yuyao  zhejiang  315400
+				CN
+
+6C-B3-11   (hex)		Shenzhen Lianrui Electronics Co.,Ltd
+6CB311     (base 16)		Shenzhen Lianrui Electronics Co.,Ltd
+				Block C4 XinTang Industrial Park
+				Shenzhen  Guangdong  518000
+				CN
+
+10-A7-43   (hex)		SK Mtek Limited
+10A743     (base 16)		SK Mtek Limited
+				Flat/Rm 1808, 18F Tower II, Admirality
+				Hong Kong    
+				HK
+
+54-7F-A8   (hex)		TELCO systems, s.r.o.
+547FA8     (base 16)		TELCO systems, s.r.o.
+				Zvolenska cesta 20
+				Banska Bystrica  Slovak republic  974 05
+				SK
+
+54-74-E6   (hex)		Webtech Wireless
+5474E6     (base 16)		Webtech Wireless
+				215-4299 Canada Way
+				Burnaby  BC  V5G 1H3
+				CA
+
+C4-6D-F1   (hex)		DataGravity
+C46DF1     (base 16)		DataGravity
+				10 Tara Blvd
+				Nashua  NH  03062
+				US
+
+30-44-49   (hex)		PLATH GmbH
+304449     (base 16)		PLATH GmbH
+				Gotenstrasse 18
+				  Hamburg  20097
+				DE
+
+94-FD-2E   (hex)		Shanghai Uniscope Technologies Co.,Ltd
+94FD2E     (base 16)		Shanghai Uniscope Technologies Co.,Ltd
+				5th Floor, Building 10,
+				  Shanghai  200233
+				CN
+
+E4-C1-46   (hex)		Objetivos y Servicios de Valor A
+E4C146     (base 16)		Objetivos y Servicios de Valor A
+				C/ Monte Esquinza, 28, 1D
+				  Madrid  28017
+				ES
+
+D4-00-57   (hex)		MC Technologies GmbH
+D40057     (base 16)		MC Technologies GmbH
+				Kabelkamp 2
+				Hannover  Germany  30179
+				DE
+
+5C-E0-F6   (hex)		NIC.br- Nucleo de Informacao e Coordenacao do Ponto BR
+5CE0F6     (base 16)		NIC.br- Nucleo de Informacao e Coordenacao do Ponto BR
+				Av. das Nacoes Unidas, 11541, 7o andar
+				São Paulo  SP  04578-000
+				BR
+
+C8-3D-97   (hex)		Nokia Corporation
+C83D97     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+0C-F3-61   (hex)		Java Information
+0CF361     (base 16)		Java Information
+				Woolim Lions Valley 2nd B-1305
+				Seongnam-Si  Gyounggi-Do  462-120
+				KR
+
+60-0F-77   (hex)		SilverPlus, Inc
+600F77     (base 16)		SilverPlus, Inc
+				18 Technology Dr, #143
+				Irvine  CA  92618
+				US
+
+B0-35-8D   (hex)		Nokia Corporation
+B0358D     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+F8-E4-FB   (hex)		Actiontec Electronics, Inc
+F8E4FB     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+8C-4A-EE   (hex)		GIGA TMS INC
+8C4AEE     (base 16)		GIGA TMS INC
+				9F-2 NO.31 Lane 169 Kang-ning Street, Hsi-Chih
+				Taipei County 221    221
+				TW
+
+34-C9-9D   (hex)		EIDOLON COMMUNICATIONS TECHNOLOGY CO. LTD.
+34C99D     (base 16)		EIDOLON COMMUNICATIONS TECHNOLOGY CO. LTD.
+				Room 603, 6/F., Wanchai Central Building, 89 Lockhart Road, Wanchai, 
+				    
+				HK
+
+AC-E6-4B   (hex)		Shenzhen Baojia Battery Technology Co., Ltd.
+ACE64B     (base 16)		Shenzhen Baojia Battery Technology Co., Ltd.
+				Block A, Tongfuyu Industrial Zone
+				Shenzhen  Guangdong  518013
+				CN
+
+78-9F-87   (hex)		Siemens AG I IA PP PRM
+789F87     (base 16)		Siemens AG I IA PP PRM
+				Gleiwitzer Strasse 555
+				Nuremberg  Bavaria  90475
+				DE
+
+08-E5-DA   (hex)		NANJING FUJITSU COMPUTER PRODUCTS CO.,LTD. 
+08E5DA     (base 16)		NANJING FUJITSU COMPUTER PRODUCTS CO.,LTD. 
+				NO.1,XIANXIN MID-ROAD
+				NANJING  JIANGSU  210046
+				CN
+
+58-84-E4   (hex)		IP500 Alliance e.V.
+5884E4     (base 16)		IP500 Alliance e.V.
+				Scharnhorststraße 16
+				Berlin    10115
+				DE
+
+04-4B-FF   (hex)		GuangZhou Hedy Digital Technology Co., Ltd
+044BFF     (base 16)		GuangZhou Hedy Digital Technology Co., Ltd
+				B 701, Gaoke Building, TianHe Bei Road,
+				GuangZhou  GuangDong  510630
+				CN
+
+E8-71-8D   (hex)		Elsys Equipamentos Eletronicos Ltda
+E8718D     (base 16)		Elsys Equipamentos Eletronicos Ltda
+				Av. Torquato Tapajós, n. 1052 - B. Flores
+				Manaus  Amazonas  69.058-830
+				BR
+
+D0-73-8E   (hex)		DONG OH PRECISION CO., LTD. 
+D0738E     (base 16)		DONG OH PRECISION CO., LTD. 
+				#282 SHINGAL-RI, JICSAN-EUP
+				CHEONAN-SI  CHUNGCHEONGNAM-DO  331-814
+				KR
+
+64-C9-44   (hex)		LARK Technologies, Inc
+64C944     (base 16)		LARK Technologies, Inc
+				2570 W El Camino Real
+				Mountain View  CA  94040
+				US
+
+0C-93-FB   (hex)		BNS Solutions
+0C93FB     (base 16)		BNS Solutions
+				PO Box 508
+				Walpole  MA  02081
+				US
+
+E4-4F-5F   (hex)		EDS Elektronik Destek San.Tic.Ltd.Sti
+E44F5F     (base 16)		EDS Elektronik Destek San.Tic.Ltd.Sti
+				Meclis Mah. Hayran Sok. No:4
+				istanbul    34785
+				TR
+
+E8-6D-54   (hex)		Digit Mobile Inc
+E86D54     (base 16)		Digit Mobile Inc
+				5F.,No.550,Ruiguang Rd., Neihu Dist.,Taipei City 11492, Taiwan
+				Taipei  Taiwan  11492
+				TW
+
+90-B1-1C   (hex)		Dell Inc.
+90B11C     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-5D-03   (hex)		Xilinx, Inc
+005D03     (base 16)		Xilinx, Inc
+				2100 Logic drive
+				San Jose  CA  95124
+				US
+
+80-2F-DE   (hex)		Zurich Instruments AG
+802FDE     (base 16)		Zurich Instruments AG
+				Technoparkstrasse 1
+				  Zurich  8005
+				CH
+
+5C-38-E0   (hex)		Shanghai Super Electronics Technology Co.,LTD
+5C38E0     (base 16)		Shanghai Super Electronics Technology Co.,LTD
+				1/F Building A 39 Hongcao Road
+				Shanghai    200233
+				CN
+
+08-AF-78   (hex)		Totus Solutions, Inc.
+08AF78     (base 16)		Totus Solutions, Inc.
+				1505 Wallace Drive, Suite 102
+				Carrollton  TX  75006
+				US
+
+C8-C7-91   (hex)		Zero1.tv GmbH
+C8C791     (base 16)		Zero1.tv GmbH
+				Heinrich-Roller-Str. 16 B
+				  Berlin  10405
+				DE
+
+EC-D9-25   (hex)		RAMI
+ECD925     (base 16)		RAMI
+				7 RUE RAOUL FOLLEREAU
+				BUSSY ST GEORGES    77600
+				FR
+
+1C-94-92   (hex)		RUAG Schweiz AG
+1C9492     (base 16)		RUAG Schweiz AG
+				RUAG Defence 
+				Hombrechtikon  ZH  8634
+				CH
+
+B8-89-CA   (hex)		ILJIN ELECTRIC Co., Ltd.
+B889CA     (base 16)		ILJIN ELECTRIC Co., Ltd.
+				112-83, Annyeong-dong
+				Hwaseong  Gyeonggi-do  445-380
+				KR
+
+64-F5-0E   (hex)		Kinion Technology Company Limited
+64F50E     (base 16)		Kinion Technology Company Limited
+				ng Kon107A, 1/F, Enterprise Place,
+				    
+				HK
+
+D0-4C-C1   (hex)		SINTRONES Technology Corp.
+D04CC1     (base 16)		SINTRONES Technology Corp.
+				14F.-3, No.736, Zhongzheng Rd., Zhonghe Dist., New Taipei City 235, Taiwan (R.O.C.)
+				Taipei  N/A  235
+				TW
+
+50-3F-56   (hex)		Syncmold Enterprise Corp
+503F56     (base 16)		Syncmold Enterprise Corp
+				9F., No.168, Jiankang Rd., Zhonghe Dist.
+				Xinbei City    235
+				US
+
+8C-EE-C6   (hex)		Precepscion Pty. Ltd.
+8CEEC6     (base 16)		Precepscion Pty. Ltd.
+				Level 10
+				Melbourne  Victoria  3000
+				AU
+
+10-12-48   (hex)		ITG, Inc.
+101248     (base 16)		ITG, Inc.
+				YASUHARA BLDG 302, 1-42-6, ITABASHI,
+				ITABASHI-KU  TOKYO  173-0004
+				US
+
+18-48-D8   (hex)		Fastback Networks
+1848D8     (base 16)		Fastback Networks
+				2480 N 1st Street
+				San Jose  California  95131
+				US
+
+F0-D3-E7   (hex)		Sensometrix SA
+F0D3E7     (base 16)		Sensometrix SA
+				Rue Albert Richard 2
+				Geneva  GE  1201
+				CH
+
+B0-12-66   (hex)		Futaba-Kikaku
+B01266     (base 16)		Futaba-Kikaku
+				2-17-20-302 Yanaka
+				Taito-ku  Tokyo  110-0001
+				JP
+
+7C-C8-D0   (hex)		TIANJIN YAAN TECHNOLOGY CO., LTD.
+7CC8D0     (base 16)		TIANJIN YAAN TECHNOLOGY CO., LTD.
+				No.8 Ziyuan Road,Huayuan Industrial Zone
+				  Tianjin  300384
+				CN
+
+88-E9-17   (hex)		Tamaggo
+88E917     (base 16)		Tamaggo
+				2001 McGill College
+				Montreal  Quebec  H3A 3L3
+				CA
+
+88-61-5A   (hex)		Siano Mobile Silicon Ltd.
+88615A     (base 16)		Siano Mobile Silicon Ltd.
+				P.O. Box 8684
+				Netanya    42504
+				IL
+
+70-E2-4C   (hex)		SAE IT-systems GmbH & Co. KG
+70E24C     (base 16)		SAE IT-systems GmbH & Co. KG
+				Im Gewerbegebiet Pesch 14
+				Köln  NRW  50767
+				DE
+
+00-FD-4C   (hex)		NEVATEC
+00FD4C     (base 16)		NEVATEC
+				Lindaraja 2
+				Granada    18009
+				ES
+
+14-43-19   (hex)		Creative&Link Technology Limited
+144319     (base 16)		Creative&Link Technology Limited
+				 ROOM 704 HONG JIN GE BLD. NO.3018,YANHE SOUTH ROAD
+				Shenzhen  Guangdong  518002
+				US
+
+D8-AF-3B   (hex)		Hangzhou Bigbright Integrated communications system Co.,Ltd
+D8AF3B     (base 16)		Hangzhou Bigbright Integrated communications system Co.,Ltd
+				The 6floor ,Building1,No.1418-41,Moganshan Road
+				Hangzhou  Zhejiang  310015
+				CN
+
+60-32-F0   (hex)		Mplus technology
+6032F0     (base 16)		Mplus technology
+				#201  Gayang Dong, Gangsea Gu
+				Seoul    157-793
+				KR
+
+28-29-D9   (hex)		GlobalBeiMing technology (Beijing)Co. Ltd
+2829D9     (base 16)		GlobalBeiMing technology (Beijing)Co. Ltd
+				Beijing  Chaoyang District 8 Guanghua Road A seat 320 rooms
+				  Beijing   100026 
+				CN
+
+1C-C3-16   (hex)		MileSight Technology Co., Ltd.
+1CC316     (base 16)		MileSight Technology Co., Ltd.
+				202-2,No.21 Wanghai Road, 2nd Software Park
+				Xiamen  Fujian  361006
+				CN
+
+68-15-D3   (hex)		Zaklady Elektroniki i Mechaniki Precyzyjnej R&G S.A.
+6815D3     (base 16)		Zaklady Elektroniki i Mechaniki Precyzyjnej R&G S.A.
+				ul. Traugutta 7
+				Mielec    39-300
+				PL
+
+10-F3-DB   (hex)		Gridco Systems, Inc.
+10F3DB     (base 16)		Gridco Systems, Inc.
+				10-L Commerice Way
+				Woburn  MA   01801
+				US
+
+30-5D-38   (hex)		Beissbarth 
+305D38     (base 16)		Beissbarth 
+				Hanauer Str. 101
+				Muenchen    80993
+				DE
+
+60-D2-B9   (hex)		REALAND BIO CO., LTD.
+60D2B9     (base 16)		REALAND BIO CO., LTD.
+				Room 201A, N.set, Jinshan Bd., No.248 Wushan Rd., Tianhe District
+				Guangzhou  Guangdong  510630
+				CN
+
+30-FD-11   (hex)		MACROTECH (USA) INC.
+30FD11     (base 16)		MACROTECH (USA) INC.
+				1799 BAYSHORE HIGHWAY
+				BURLINGAME  CA  94010
+				US
+
+C4-DA-26   (hex)		NOBLEX SA
+C4DA26     (base 16)		NOBLEX SA
+				Vicente Padín Moreira 97
+				Ushuaia   Tierra del fuego  9410  
+				AR
+
+7C-C8-AB   (hex)		Acro Associates, Inc.
+7CC8AB     (base 16)		Acro Associates, Inc.
+				1990 Olivera Rd.
+				Concord  CA  94520
+				US
+
+60-19-29   (hex)		VOLTRONIC POWER TECHNOLOGY(SHENZHEN) CORP.
+601929     (base 16)		VOLTRONIC POWER TECHNOLOGY(SHENZHEN) CORP.
+				1-4F,Building 5,YuSheng Industrial Park,No.467,Section Xixiang,National Highway 107,Xixiang,Bao An District,Shenzhen,China
+				Shenzhen  Shenzhen  518000
+				CN
+
+48-B2-53   (hex)		Marketaxess Corporation
+48B253     (base 16)		Marketaxess Corporation
+				299 Park Avenue
+				New York  NY  10171
+				US
+
+74-94-3D   (hex)		AgJunction
+74943D     (base 16)		AgJunction
+				8444 N. 90th St
+				Scottsdale  AZ  85258
+				US
+
+58-CF-4B   (hex)		Lufkin Industries
+58CF4B     (base 16)		Lufkin Industries
+				811 Willow Oak Drive
+				Missouri City  Texas  77489
+				US
+
+68-B4-3A   (hex)		WaterFurnace International, Inc.
+68B43A     (base 16)		WaterFurnace International, Inc.
+				9000 Conservation Way
+				Fort Wayne  IN  46809
+				US
+
+4C-78-97   (hex)		Arrowhead Alarm Products Ltd
+4C7897     (base 16)		Arrowhead Alarm Products Ltd
+				344B Rosedale Road
+				Auckland  Auckland  0751
+				NZ
+
+44-E8-A5   (hex)		Myreka Technologies Sdn. Bhd.
+44E8A5     (base 16)		Myreka Technologies Sdn. Bhd.
+				2-13, JALAN MAYANG PASIR 1,
+				Bayan Baru  Penang  11950
+				MY
+
+D8-AF-F1   (hex)		Panasonic Appliances Company
+D8AFF1     (base 16)		Panasonic Appliances Company
+				2-3-1-2 Noji-higashi
+				Kusatsu City  Shiga  525-8555
+				JP
+
+2C-62-89   (hex)		Regenersis (Glenrothes) Ltd
+2C6289     (base 16)		Regenersis (Glenrothes) Ltd
+				1 James Watt Avenue
+				Glenrothes  Fife  KY7 4UA
+				GB
+
+58-EC-E1   (hex)		Newport Corporation
+58ECE1     (base 16)		Newport Corporation
+				1791 Deere Ave.
+				Irvine  California  92606
+				US
+
+4C-09-B4   (hex)		zte corporation
+4C09B4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+60-D1-AA   (hex)		Vishal Telecommunications Pvt Ltd
+60D1AA     (base 16)		Vishal Telecommunications Pvt Ltd
+				25 Sitaram Building Dr D N Road
+				Mumbai  Maharastra  400001
+				IN
+
+70-9B-A5   (hex)		Shenzhen Y&D Electronics Co.,LTD.
+709BA5     (base 16)		Shenzhen Y&D Electronics Co.,LTD.
+				D zone3F,Shenzhen Academy of Aerospace Technology,Hi-Tech Park,south 10th Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+F4-54-33   (hex)		Rockwell Automation
+F45433     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+B4-89-10   (hex)		Coster T.E. S.P.A.
+B48910     (base 16)		Coster T.E. S.P.A.
+				Via San Giovanni Battista De La Salle 4/a
+				Milano  MI  20132
+				IT
+
+B0-C8-3F   (hex)		Jiangsu Cynray IOT Co., Ltd.
+B0C83F     (base 16)		Jiangsu Cynray IOT Co., Ltd.
+				Building D1, 1 Zidong road, Qixia district
+				Nanjing  Jiangsu  210000
+				CN
+
+3C-F3-92   (hex)		Virtualtek. Co. Ltd
+3CF392     (base 16)		Virtualtek. Co. Ltd
+				12F, ShinhanDm Bldg., 
+				  Seoul  121-708
+				KR
+
+B4-82-C5   (hex)		Relay2, Inc.
+B482C5     (base 16)		Relay2, Inc.
+				1525 McCarthy Blvd., 
+				Milpitas  CA  95035
+				US
+
+98-5E-1B   (hex)		ConversDigital Co., Ltd.
+985E1B     (base 16)		ConversDigital Co., Ltd.
+				5308 5th Bldg., Dong Seoul Univ.
+				Seongnam  Gyeonggi  461714
+				KR
+
+D4-8C-B5   (hex)		Cisco Systems, Inc
+D48CB5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+90-9D-E0   (hex)		Newland Design + Assoc. Inc.
+909DE0     (base 16)		Newland Design + Assoc. Inc.
+				3186-G Airway Ave.
+				Costa Mesa  CA  92626
+				US
+
+14-9F-E8   (hex)		Lenovo Mobile Communication Technology Ltd.
+149FE8     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,Torch Hi-tech Industry Development Zone
+				Xiamen  Fujian  361006
+				CN
+
+BC-D9-40   (hex)		ASR Co,.Ltd.
+BCD940     (base 16)		ASR Co,.Ltd.
+				1-3-1 Sotokanda Chiyoda-ku
+				Tokyo    101-0021
+				JP
+
+04-9C-62   (hex)		BMT Medical Technology s.r.o.
+049C62     (base 16)		BMT Medical Technology s.r.o.
+				Cejl 50
+				Brno    65660
+				CZ
+
+0C-2A-69   (hex)		electric imp, incorporated
+0C2A69     (base 16)		electric imp, incorporated
+				5050 El Camino Real, Ste 221
+				Los Altos  California  94022
+				US
+
+C4-55-C2   (hex)		Bach-Simpson
+C455C2     (base 16)		Bach-Simpson
+				109 Meg Drive
+				London  Ontario  N6E3Z7
+				CA
+
+00-E8-AB   (hex)		Meggitt Training Systems, Inc.
+00E8AB     (base 16)		Meggitt Training Systems, Inc.
+				296 Brogdon Rd
+				Suwanee  GA  30024
+				US
+
+B4-21-8A   (hex)		Dog Hunter LLC
+B4218A     (base 16)		Dog Hunter LLC
+				8 Faneuil Hall SQ
+				Boston  MA  02109
+				US
+
+B4-A4-B5   (hex)		Zen Eye Co.,Ltd
+B4A4B5     (base 16)		Zen Eye Co.,Ltd
+				#401, 157-5 Chunui-dong
+				Bucheon-si  Gyeonggi-do  420-859
+				KR
+
+DC-37-D2   (hex)		Hunan HKT Electronic Technology Co., Ltd
+DC37D2     (base 16)		Hunan HKT Electronic Technology Co., Ltd
+				Room 428,4F,Hunan Environmental Science and Technology Committee Building,No 18 South of Wanjiali Road,Yuhua District,Changsha
+				Changsha  Hunan  410007
+				CN
+
+40-70-74   (hex)		Life Technology (China) Co., Ltd
+407074     (base 16)		Life Technology (China) Co., Ltd
+				No.1, 2F, Nanshan Digital Culture Industrial base (East Tower  Podium) 10128 Shennan Blvd, Nanshan Dist.
+				Shenzhen  Guangdong  518000
+				CN
+
+20-F0-02   (hex)		MTData Developments Pty. Ltd.
+20F002     (base 16)		MTData Developments Pty. Ltd.
+				20 Miles Street
+				Mulgrave  Victoria  3170
+				AU
+
+38-8A-B7   (hex)		ITC Networks
+388AB7     (base 16)		ITC Networks
+				3F Daiwa Shibaura Bldg
+				Tokyo    105-0023
+				JP
+
+BC-C2-3A   (hex)		Thomson Video Networks
+BCC23A     (base 16)		Thomson Video Networks
+				6, rue du Clos Courtel
+				Cesson Sevigne    35510
+				FR
+
+1C-F4-CA   (hex)		Private
+1CF4CA     (base 16)		Private
+
+AC-C2-EC   (hex)		CLT INT'L IND. CORP.
+ACC2EC     (base 16)		CLT INT'L IND. CORP.
+				11F-2, NO.1, ZHANQIAN
+				MIAOLI    36043
+				TW
+
+A8-65-B2   (hex)		DONGGUAN YISHANG ELECTRONIC TECHNOLOGY CO., LIMITED
+A865B2     (base 16)		DONGGUAN YISHANG ELECTRONIC TECHNOLOGY CO., LIMITED
+				3rd floor, B# Building ,Houdefu Logistics Park,Qingshuiao,
+				Dongguan  Guangdong  523062
+				CN
+
+E8-D0-FA   (hex)		MKS Instruments Deutschland GmbH
+E8D0FA     (base 16)		MKS Instruments Deutschland GmbH
+				Schatzbogen 43
+				Munich    81829 
+				DE
+
+98-26-2A   (hex)		Applied Research Associates, Inc
+98262A     (base 16)		Applied Research Associates, Inc
+				4300 San Mateo Boulevard NE
+				Albuquerque  NM  87110
+				US
+
+3C-91-74   (hex)		ALONG COMMUNICATION TECHNOLOGY
+3C9174     (base 16)		ALONG COMMUNICATION TECHNOLOGY
+				1301, Zhenye International Business Center,
+				Shenzhen  Guandong  518000
+				CN
+
+AC-EE-3B   (hex)		6harmonics Inc
+ACEE3B     (base 16)		6harmonics Inc
+				21 Concourse Gate - Suite 10
+				Ottawa  Ontario  K2E 7S4
+				CA
+
+1C-6B-CA   (hex)		Mitsunami Co., Ltd.
+1C6BCA     (base 16)		Mitsunami Co., Ltd.
+				2-30-11, Nishi-gotanda, Shinagawa-ku
+				Tokyo    141-0031
+				JP
+
+64-24-00   (hex)		Xorcom Ltd.
+642400     (base 16)		Xorcom Ltd.
+				Teradyon Industrial Park
+				D.N Misgav    20179
+				IL
+
+E8-3E-FB   (hex)		GEODESIC LTD.
+E83EFB     (base 16)		GEODESIC LTD.
+				18,10TH CROSS, MAYURA STREET
+				BANGALORE  KARNATAKA  560094
+				IN
+
+EC-D1-9A   (hex)		Zhuhai Liming Industries Co., Ltd
+ECD19A     (base 16)		Zhuhai Liming Industries Co., Ltd
+				No.6 Xinqing Rd,Xinqing Hi-Tech Industrial Park
+				Zhuhai  Guangdong  519100
+				CN
+
+34-81-37   (hex)		UNICARD SA
+348137     (base 16)		UNICARD SA
+				UL.WADOWICKA 12
+				KRAKOW  woj. malopolskie  30-415
+				PL
+
+38-B1-2D   (hex)		Sonotronic Nagel GmbH
+38B12D     (base 16)		Sonotronic Nagel GmbH
+				Becker-Goering-Str. 17-25
+				Karlsbad    76307
+				DE
+
+54-9D-85   (hex)		EnerAccess inc
+549D85     (base 16)		EnerAccess inc
+				3154 Le Corbusier Blvd
+				Laval  Quebec  H7L 4S8
+				CA
+
+B0-75-0C   (hex)		QA Cafe
+B0750C     (base 16)		QA Cafe
+				33 Jewell Court
+				Portsmouth  NH  03801
+				US
+
+B4-E1-EB   (hex)		Private
+B4E1EB     (base 16)		Private
+
+3C-36-3D   (hex)		Nokia Corporation
+3C363D     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+80-86-98   (hex)		Netronics Technologies Inc.
+808698     (base 16)		Netronics Technologies Inc.
+				600-15 Allstate Parkway
+				Markham  Ontario  L3R 5B4
+				CA
+
+9C-E1-0E   (hex)		NCTech Ltd
+9CE10E     (base 16)		NCTech Ltd
+				20-22 Braid Road
+				Edinburgh    EH10 6AD
+				GB
+
+A0-6D-09   (hex)		Intelcan Technosystems Inc.
+A06D09     (base 16)		Intelcan Technosystems Inc.
+				5490  Boul Thimens
+				Saint-Laurent  Quebec  H4R2K9
+				CA
+
+60-F3-DA   (hex)		Logic Way GmbH
+60F3DA     (base 16)		Logic Way GmbH
+				Hagenower Str. 73
+				Schwerin  Mecklenburg-West Pomerania  19061
+				DE
+
+FC-50-90   (hex)		SIMEX Sp. z o.o.
+FC5090     (base 16)		SIMEX Sp. z o.o.
+				ul. Wielopole 7
+				Gdañsk  pomorskie  80-556
+				PL
+
+60-B9-82   (hex)		RO.VE.R. Laboratories S.p.A.
+60B982     (base 16)		RO.VE.R. Laboratories S.p.A.
+				Via Parini, 2
+				Sirmione  Brescia  25019
+				IT
+
+B4-62-38   (hex)		Exablox
+B46238     (base 16)		Exablox
+				365 San Antonio Road
+				Mountain View  CA  94040
+				US
+
+C8-BB-D3   (hex)		Embrane
+C8BBD3     (base 16)		Embrane
+				2350 Mission College Blvd., Ste 703
+				Santa Clara  CA  95054
+				US
+
+8C-60-4F   (hex)		Cisco Systems, Inc
+8C604F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-B9-80   (hex)		Parking BOXX Inc.
+A4B980     (base 16)		Parking BOXX Inc.
+				382 NE 191st St. #93984
+				Miami  FL  33179-3899
+				US
+
+A4-7C-14   (hex)		ChargeStorm AB
+A47C14     (base 16)		ChargeStorm AB
+				Laxholmstorget 3
+				Norrköping    60221
+				SE
+
+80-20-AF   (hex)		Trade FIDES, a.s.
+8020AF     (base 16)		Trade FIDES, a.s.
+				Dornych 57
+				Brno    61700
+				CZ
+
+2C-75-0F   (hex)		Shanghai Dongzhou-Lawton Communication Technology Co. Ltd.
+2C750F     (base 16)		Shanghai Dongzhou-Lawton Communication Technology Co. Ltd.
+				NO.188,FengyeRoad,BaoshanDistrict
+				shanghai    200949
+				CN
+
+5C-50-15   (hex)		Cisco Systems, Inc
+5C5015     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+98-02-84   (hex)		Theobroma Systems GmbH
+980284     (base 16)		Theobroma Systems GmbH
+				Gutheil-Schoder Gasse 17
+				Wien    1230
+				US
+
+1C-D4-0C   (hex)		Kriwan Industrie-Elektronik GmbH
+1CD40C     (base 16)		Kriwan Industrie-Elektronik GmbH
+				Allmand 11
+				Forchtenberg  Baden-Würtemberg  D-74670
+				DE
+
+00-2D-76   (hex)		TITECH GmbH
+002D76     (base 16)		TITECH GmbH
+				Otto-Hahn-Str. 6
+				Muelheim-Kaerlich    56218
+				DE
+
+F8-DB-4C   (hex)		PNY Technologies, INC.
+F8DB4C     (base 16)		PNY Technologies, INC.
+				100 Jefferson Road
+				Parsippany  New Jersey  07054
+				US
+
+0C-9D-56   (hex)		Consort Controls Ltd
+0C9D56     (base 16)		Consort Controls Ltd
+				13 Campion Terrace
+				Leamington Spa    CV32 4SU
+				GB
+
+3C-B8-7A   (hex)		Private
+3CB87A     (base 16)		Private
+
+AC-14-61   (hex)		ATAW  Co., Ltd.
+AC1461     (base 16)		ATAW  Co., Ltd.
+				Dongan-gu Pyeongchon-dong 126-1
+				Anyang-si  Gyeonggi-do  431-755
+				KR
+
+E4-C6-E6   (hex)		Mophie, LLC
+E4C6E6     (base 16)		Mophie, LLC
+				2850 Red Hill Ave.
+				Santa Ana  CA  92705
+				US
+
+50-2D-1D   (hex)		Nokia Corporation
+502D1D     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+F4-8E-09   (hex)		Nokia Corporation
+F48E09     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+58-48-C0   (hex)		COFLEC
+5848C0     (base 16)		COFLEC
+				Parc d'activités du moulin de Massy
+				MASSY    91300
+				FR
+
+8C-57-FD   (hex)		LVX Western
+8C57FD     (base 16)		LVX Western
+				700 54th ave North
+				St. Cloud  MN  56303
+				US
+
+54-E6-3F   (hex)		ShenZhen LingKeWeiEr Technology Co., Ltd.
+54E63F     (base 16)		ShenZhen LingKeWeiEr Technology Co., Ltd.
+				Room 625, YiJing Building, MeiLin Rd., FuTian District
+				ShenZhen  GuandDong  518000
+				CN
+
+20-FA-BB   (hex)		Cambridge Executive Limited
+20FABB     (base 16)		Cambridge Executive Limited
+				St John's Innovation Centre
+				Cambridge  Cambridgeshire  CB40WS
+				GB
+
+14-1A-51   (hex)		Treetech Sistemas Digitais
+141A51     (base 16)		Treetech Sistemas Digitais
+				Praca Claudino Alves, 141
+				Atibaia  São Paulo  12940-800
+				BR
+
+58-7F-C8   (hex)		S2M
+587FC8     (base 16)		S2M
+				2 rue des champs
+				Saint Marcel    27950
+				FR
+
+20-05-05   (hex)		RADMAX COMMUNICATION PRIVATE LIMITED
+200505     (base 16)		RADMAX COMMUNICATION PRIVATE LIMITED
+				F-24/34, IIND FLOOR, SECTOR-7
+				DELHI  DELHI  110085
+				IN
+
+C0-35-BD   (hex)		Velocytech Aps
+C035BD     (base 16)		Velocytech Aps
+				Automatikvej 1, 3rd floor
+				SOEBORG    2860
+				DK
+
+28-71-84   (hex)		Spire Payments
+287184     (base 16)		Spire Payments
+				Units 3 & 6 Milford Trading Estate
+				Salisbury  Wiltshire  SP1 2UD
+				GB
+
+7C-B0-3E   (hex)		OSRAM GmbH
+7CB03E     (base 16)		OSRAM GmbH
+				Berliner Allee 65
+				Augsburg  Bayern  86136
+				DE
+
+3C-9F-81   (hex)		Shenzhen CATIC Bit Communications Technology Co.,Ltd
+3C9F81     (base 16)		Shenzhen CATIC Bit Communications Technology Co.,Ltd
+				in  Nanshan District,Shenzhen Software park Road 10 in Room 202
+				Shenzhen  Guangdong  518057
+				CN
+
+44-5F-7A   (hex)		Shihlin Electric & Engineering Corp.
+445F7A     (base 16)		Shihlin Electric & Engineering Corp.
+				16F  NO.88,  SEC,  6,  CHUNG  SHAN  N.  RD., TAIPEI  
+				HsinChu  HsinFun Shiang  304
+				TW
+
+44-13-19   (hex)		WKK TECHNOLOGY LTD.
+441319     (base 16)		WKK TECHNOLOGY LTD.
+				23/F., One Kowloon, No.1, Wang Yuen Street, 
+				    852
+				HK
+
+18-B5-91   (hex)		I-Storm
+18B591     (base 16)		I-Storm
+				Hogye-dong, Dongan-gu
+				Anyang-si  Gyeonggi-do  431-080
+				KR
+
+BC-8B-55   (hex)		NPP ELIKS America Inc. DBA T&M Atlantic
+BC8B55     (base 16)		NPP ELIKS America Inc. DBA T&M Atlantic
+				175 SW 7th St Suite 1812
+				Miami  FL  33130
+				US
+
+C0-49-3D   (hex)		MAITRISE TECHNOLOGIQUE
+C0493D     (base 16)		MAITRISE TECHNOLOGIQUE
+				224 RUE DE LA SAINTE BAUME
+				SAINT MAXIMIN LA SAINTE BAUME  VAR  83470
+				FR
+
+C8-45-44   (hex)		Asia Pacific CIS (Wuxi) Co, Ltd
+C84544     (base 16)		Asia Pacific CIS (Wuxi) Co, Ltd
+				No 11, Xikun Road, Wuxi New District
+				Wuxi  Jiangsu  214028
+				CN
+
+E0-EF-25   (hex)		Lintes Technology Co., Ltd.
+E0EF25     (base 16)		Lintes Technology Co., Ltd.
+				9F-1., No.150, Jian 1st Rd., Zhonghe Dist., 
+				 New Taipei City     23511
+				TW
+
+50-ED-94   (hex)		EGATEL SL
+50ED94     (base 16)		EGATEL SL
+				Parque Tecnologico de Galicia
+				Ourense    32901
+				ES
+
+48-A2-2D   (hex)		Shenzhen Huaxuchang Telecom Technology Co.,Ltd
+48A22D     (base 16)		Shenzhen Huaxuchang Telecom Technology Co.,Ltd
+				Room 501 Block B, Cyber Time Plaza
+				Shenzhen  Guangdong  518040
+				CN
+
+C8-60-00   (hex)		ASUSTek COMPUTER INC.
+C86000     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+AC-0D-FE   (hex)		Ekon GmbH - myGEKKO
+AC0DFE     (base 16)		Ekon GmbH - myGEKKO
+				Rienzfeldstraße 30
+				Bruneck  Südtirol (BZ)  39031
+				IT
+
+FC-5B-26   (hex)		MikroBits
+FC5B26     (base 16)		MikroBits
+				Jalan Petung 31 Papringan
+				Yogyakarta  DIY  55281
+				ID
+
+40-F4-07   (hex)		Nintendo Co., Ltd.
+40F407     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+B0-1C-91   (hex)		Elim Co
+B01C91     (base 16)		Elim Co
+				4F Gagu Plaza B/D 81-9, jeongja-dong, Jangan-gu, 
+				Suwon city  Gyeonggi-Do  440-300 
+				KR
+
+04-F1-7D   (hex)		Tarana Wireless
+04F17D     (base 16)		Tarana Wireless
+				2105 Martin Luther King Jr Way
+				Berkeley  CA  94704
+				US
+
+84-49-15   (hex)		vArmour Networks, Inc.
+844915     (base 16)		vArmour Networks, Inc.
+				4633 OLD IRONSIDES DR
+				SANTA CLARA  CA  95054-1807
+				US
+
+2C-BE-97   (hex)		Ingenieurbuero Bickele und Buehler GmbH
+2CBE97     (base 16)		Ingenieurbuero Bickele und Buehler GmbH
+				St.Poeltener Str. 70
+				Stuttgart  BW  70469
+				DE
+
+70-A6-6A   (hex)		Prox Dynamics AS
+70A66A     (base 16)		Prox Dynamics AS
+				Smedsvingen 4
+				Hvalstad  Akershus  1395
+				NO
+
+DC-3E-51   (hex)		Solberg & Andersen AS
+DC3E51     (base 16)		Solberg & Andersen AS
+				Litleaasvegen 61
+				Bergen    5132
+				NO
+
+90-0A-3A   (hex)		PSG Plastic Service GmbH
+900A3A     (base 16)		PSG Plastic Service GmbH
+				Pinaer Str. 12-16
+				Mannheim  BW  68309
+				DE
+
+28-CD-1C   (hex)		Espotel Oy
+28CD1C     (base 16)		Espotel Oy
+				Kappelitie 6
+				Espoo  Espoo  FI-02200
+				FI
+
+D4-43-A8   (hex)		Changzhou Haojie Electric Co., Ltd.
+D443A8     (base 16)		Changzhou Haojie Electric Co., Ltd.
+				No. 158,
+				Changzhou  Jiangsu  213022
+				CN
+
+BC-E5-9F   (hex)		WATERWORLD Technology Co.,LTD
+BCE59F     (base 16)		WATERWORLD Technology Co.,LTD
+				6 Floor,Block B,Digital Building,Garden City,No.1079,Nanhai Road,Nanshan District,
+				Shenzhen  Guangdong  518067
+				US
+
+70-41-B7   (hex)		Edwards Lifesciences LLC
+7041B7     (base 16)		Edwards Lifesciences LLC
+				One Edwards Way
+				Irvine  CA  92614
+				US
+
+DC-A8-CF   (hex)		New Spin Golf, LLC.
+DCA8CF     (base 16)		New Spin Golf, LLC.
+				1637 Burr Oak Drive
+				Libertyville  IL  60048
+				US
+
+A8-49-A5   (hex)		Lisantech Co., Ltd.
+A849A5     (base 16)		Lisantech Co., Ltd.
+				1108, STX V-Tower  Gasan-dong
+				Seoul    153-803
+				KR
+
+A0-5E-6B   (hex)		MELPER Co., Ltd.
+A05E6B     (base 16)		MELPER Co., Ltd.
+				207, 2nd FL.,Wonhyo Bldg.,1365-22
+				SEOUL    137-863
+				KR
+
+D8-78-E5   (hex)		KUHN SA
+D878E5     (base 16)		KUHN SA
+				4, impasse des fabriques
+				SAVERNE    67700
+				FR
+
+D8-24-BD   (hex)		Cisco Systems, Inc
+D824BD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-97-FB   (hex)		ADVANCED RF TECHNOLOGIES INC
+3497FB     (base 16)		ADVANCED RF TECHNOLOGIES INC
+				3116 W Vanowen St
+				Burbank  California  91505
+				US
+
+F0-3A-55   (hex)		Omega Elektronik AS
+F03A55     (base 16)		Omega Elektronik AS
+				Ege Serbest Bolgesi
+				Izmir    35410
+				TR
+
+98-BC-57   (hex)		SVA TECHNOLOGIES CO.LTD
+98BC57     (base 16)		SVA TECHNOLOGIES CO.LTD
+				5F No.192 Tinglin Road,
+				SHANGHAI    200233
+				CN
+
+DC-3C-2E   (hex)		Manufacturing System Insights, Inc.
+DC3C2E     (base 16)		Manufacturing System Insights, Inc.
+				2550 Ninth St.
+				Berkely  CA  94710
+				US
+
+F8-35-53   (hex)		Magenta Research Ltd.
+F83553     (base 16)		Magenta Research Ltd.
+				128 Litchfield Road
+				New Milford  CT  06776
+				US
+
+F4-04-4C   (hex)		ValenceTech Limited
+F4044C     (base 16)		ValenceTech Limited
+				Unit 1, 20/F., APEC Plaza
+				HONG KONG    NIL
+				CN
+
+C4-67-B5   (hex)		Libratone A/S
+C467B5     (base 16)		Libratone A/S
+				Marielundvej 43 A
+				2730 HERLEV    
+				DK
+
+4C-39-10   (hex)		Newtek Electronics co., Ltd.
+4C3910     (base 16)		Newtek Electronics co., Ltd.
+				Byucksan-Sunyoung Technopia 1004,
+				Uiwang-City  Kyunggi-Do  437-821
+				KR
+
+90-3A-A0   (hex)		Nokia
+903AA0     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+B0-6C-BF   (hex)		3ality Digital Systems GmbH
+B06CBF     (base 16)		3ality Digital Systems GmbH
+				Gut Mergenthau 1
+				Kissing  Bayern  86438
+				DE
+
+54-D0-ED   (hex)		AXIM Communications
+54D0ED     (base 16)		AXIM Communications
+				1F., No. 5, Aly. 12, Ln. 15, Sec. 6, Sinyi Rd., Sinyi Dist.,
+				Taipei    110
+				TW
+
+84-36-11   (hex)		hyungseul publishing networks
+843611     (base 16)		hyungseul publishing networks
+				526-4, paju bookcity, munbal-li, gyoha-eup
+				paju-si  Gyeonggi-do  413-832
+				KR
+
+34-40-B5   (hex)		IBM
+3440B5     (base 16)		IBM
+				3039 E Cornwallis Rd
+				Research Triangle Park  NC  27709
+				US
+
+D4-D7-48   (hex)		Cisco Systems, Inc
+D4D748     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-4F-69   (hex)		EKINOPS SAS
+344F69     (base 16)		EKINOPS SAS
+				3, Rue Blaise Pascal
+				LANNION  FRANCE  22300
+				FR
+
+F8-31-3E   (hex)		endeavour GmbH
+F8313E     (base 16)		endeavour GmbH
+				Max-Planck-Str. 04
+				Vreden  NRW  48691
+				DE
+
+14-36-05   (hex)		Nokia Corporation
+143605     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+C8-1A-FE   (hex)		DLOGIC GmbH
+C81AFE     (base 16)		DLOGIC GmbH
+				Rathausstrasse 14
+				Baar  ZG  6341
+				CH
+
+EC-63-E5   (hex)		ePBoard Design LLC
+EC63E5     (base 16)		ePBoard Design LLC
+				4065 E. La Palma Ave.
+				Anaheim  California  92807
+				US
+
+94-DB-49   (hex)		SITCORP
+94DB49     (base 16)		SITCORP
+				7 RUE CADET
+				PARIS    75015
+				FR
+
+F0-62-0D   (hex)		Shenzhen Egreat Tech Corp.,Ltd
+F0620D     (base 16)		Shenzhen Egreat Tech Corp.,Ltd
+				4F,1Building,Chuangye Industrial park
+				Shenzhen  Guangdong  518104
+				CN
+
+2C-67-FB   (hex)		ShenZhen Zhengjili Electronics Co., LTD
+2C67FB     (base 16)		ShenZhen Zhengjili Electronics Co., LTD
+				The Longhua Town Shenzhen City Streets huaning three house Science Park Road Chiayi Source fifth floor
+				Shenzhen  Guangdong  518000
+				CN
+
+3C-E5-B4   (hex)		KIDASEN INDUSTRIA E COMERCIO DE ANTENAS LTDA
+3CE5B4     (base 16)		KIDASEN INDUSTRIA E COMERCIO DE ANTENAS LTDA
+				AV SINCLER SAMBATTI, 1945
+				MARINGA  PARANA  87055-020
+				BR
+
+08-D0-9F   (hex)		Cisco Systems, Inc
+08D09F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-4B-F0   (hex)		CalDigit, Inc
+644BF0     (base 16)		CalDigit, Inc
+				1941 Miraloma Ave #B
+				Placentia  CA  92870
+				US
+
+64-ED-62   (hex)		WOORI SYSTEMS Co., Ltd
+64ED62     (base 16)		WOORI SYSTEMS Co., Ltd
+				101Ho #42-9, Jeongja-dong, Pundang-gu
+				Sungnam-si  Kyunggi-do  463-848
+				KR
+
+2C-00-2C   (hex)		UNOWHY
+2C002C     (base 16)		UNOWHY
+				11, rue Tronchet
+				Paris    75008
+				US
+
+5C-C9-D3   (hex)		PALLADIUM ENERGY ELETRONICA DA AMAZONIA LTDA
+5CC9D3     (base 16)		PALLADIUM ENERGY ELETRONICA DA AMAZONIA LTDA
+				AVENIDA BURITI, 4285
+				MANAUS  AMAZONAS  69075-000
+				BR
+
+C8-7C-BC   (hex)		Valink Co., Ltd. 
+C87CBC     (base 16)		Valink Co., Ltd. 
+				1F Dongwon Bldg. 90, Dangsan-Dong 3-Ga Youngdungpo-Gu
+				Seoul    150-803
+				KR
+
+B8-14-13   (hex)		Keen High Holding(HK) Ltd.
+B81413     (base 16)		Keen High Holding(HK) Ltd.
+				25th Floor, In-long Development Centre, No.6025 Shennan Ave
+				Shenzhen  Guangdong   518040
+				CN
+
+B4-94-4E   (hex)		WeTelecom Co., Ltd.
+B4944E     (base 16)		WeTelecom Co., Ltd.
+				The'O Plus #915
+				Gunpo-si  Kyunggi-do  435-805
+				KR
+
+E0-0B-28   (hex)		Inovonics
+E00B28     (base 16)		Inovonics
+				315 CTC Blvd
+				Louisville  CO  80027
+				US
+
+48-02-2A   (hex)		B-Link Electronic Limited
+48022A     (base 16)		B-Link Electronic Limited
+				NO 268,FuQian Rd, JuTang Community,GuanLan town BaoAn district,ShenZhen, 518110,China
+				Shen Zhen  Guang Dong  518110
+				CN
+
+18-E8-0F   (hex)		Viking Electronics Inc.
+18E80F     (base 16)		Viking Electronics Inc.
+				1531 Industrial St
+				Hudson  WI  54016
+				US
+
+CC-6B-F1   (hex)		Sound Masking Inc.
+CC6BF1     (base 16)		Sound Masking Inc.
+				47 - 23 - Glamis Drive Sw
+				Calgary  Alberta  T3E 6S3
+				CA
+
+2C-97-17   (hex)		I.C.Y. B.V.
+2C9717     (base 16)		I.C.Y. B.V.
+				Houtsaachmole 35
+				Lemmer  Friesland  8531 WC
+				NL
+
+2C-3F-38   (hex)		Cisco Systems, Inc
+2C3F38     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-50-E0   (hex)		Milton Security Group LLC
+4050E0     (base 16)		Milton Security Group LLC
+				111 North Harbor Blvd
+				Fullerton  CA  92832
+				US
+
+70-CA-9B   (hex)		Cisco Systems, Inc
+70CA9B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-78-BA   (hex)		Pantech Co., Ltd.
+A078BA     (base 16)		Pantech Co., Ltd.
+				110-1 Ongjeong-Ri, Tongjin-Eup
+				Gimpo-Si  Gyounggi-Do  415-865
+				KR
+
+68-BC-0C   (hex)		Cisco Systems, Inc
+68BC0C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-5B-11   (hex)		EVI HEAT AB
+345B11     (base 16)		EVI HEAT AB
+				Box 55
+				Kungsaengen    196 22
+				SE
+
+78-BA-D0   (hex)		Shinybow Technology Co. Ltd.
+78BAD0     (base 16)		Shinybow Technology Co. Ltd.
+				9Fl.,No.63,Ju Guang Rd.,Chung Ho Dist.
+				New Taipei    235
+				TW
+
+24-E6-BA   (hex)		JSC Zavod im. Kozitsky
+24E6BA     (base 16)		JSC Zavod im. Kozitsky
+				Bld. 70, 5th line, V.O, 
+				St.-Petersburg    199048
+				RU
+
+CC-A3-74   (hex)		Guangdong Guanglian Electronic Technology Co.Ltd
+CCA374     (base 16)		Guangdong Guanglian Electronic Technology Co.Ltd
+				B338,Block13,No.232 Waihuandonglu Road,High Education Mega Center
+				Guangzhou  Guangdong  510006
+				CN
+
+58-67-7F   (hex)		Clare Controls Inc.
+58677F     (base 16)		Clare Controls Inc.
+				7519 Pennsylvania Ave
+				Sarasota  FL  34243
+				US
+
+0C-5A-19   (hex)		Axtion Sdn Bhd
+0C5A19     (base 16)		Axtion Sdn Bhd
+				A13-07, Subang Avenue Serviced Suites
+				Subang Jaya  Selangor  47500
+				MY
+
+A8-BD-1A   (hex)		Honey Bee (Hong Kong) Limited
+A8BD1A     (base 16)		Honey Bee (Hong Kong) Limited
+				Flat L, 12/F., Phase 4, Kwun Tong Industrial Ctr.,
+				    
+				HK
+
+24-87-07   (hex)		SEnergy Corporation
+248707     (base 16)		SEnergy Corporation
+				Koizumi Bldg. 3F, 1-38-18
+				Yokohama city  Kanagawa Pref.  224-0003
+				JP
+
+C4-C1-9F   (hex)		National Oilwell Varco Instrumentation, Monitoring, and Optimization (NOV IMO)
+C4C19F     (base 16)		National Oilwell Varco Instrumentation, Monitoring, and Optimization (NOV IMO)
+				1200 Cypress Creek Rd.
+				Cedar Park  TX  78613
+				US
+
+00-08-30   (hex)		Cisco Systems, Inc
+000830     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-EE-AE   (hex)		VSS Monitoring
+C4EEAE     (base 16)		VSS Monitoring
+				1850 Gateway Dr, Suite 500
+				San Mateo  CA  94404
+				US
+
+F8-D3-A9   (hex)		AXAN Networks
+F8D3A9     (base 16)		AXAN Networks
+				2F Myungjin-Bldg Daechi-Dong Gangnam-Gu 
+				Seoul     135-845
+				KR
+
+BC-77-9F   (hex)		SBM Co., Ltd.
+BC779F     (base 16)		SBM Co., Ltd.
+				Hyunwoo Bldg 206, Anyang7-Dong
+				Anyang  Gyeonggi-Do  430-817
+				KR
+
+40-6A-AB   (hex)		RIM
+406AAB     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+9C-A3-BA   (hex)		SAKURA Internet Inc.
+9CA3BA     (base 16)		SAKURA Internet Inc.
+				7-20-1 Nishi-shinjuku
+				Shinjuku-ku  Tokyo  1600023
+				JP
+
+8C-8A-6E   (hex)		ESTUN AUTOMATION TECHNOLOY CO., LTD
+8C8A6E     (base 16)		ESTUN AUTOMATION TECHNOLOY CO., LTD
+				16,Shuige Road
+				Nanjing  Jiangsu  211106
+				CN
+
+98-82-17   (hex)		Disruptive Ltd
+988217     (base 16)		Disruptive Ltd
+				Windsor House
+				High Wycombe  Buckinghamshire  HP12 3NR
+				GB
+
+9C-5C-8D   (hex)		FIREMAX INDÚSTRIA E COMÉRCIO DE PRODUTOS ELETRÔNICOS  LTDA
+9C5C8D     (base 16)		FIREMAX INDÚSTRIA E COMÉRCIO DE PRODUTOS ELETRÔNICOS  LTDA
+				R: Vicente de Felice, 589 -  Jd.Ouro Verde
+				Limeira  São Paulo  13482-075
+				BR
+
+D4-20-6D   (hex)		HTC Corporation
+D4206D     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+7C-1E-52   (hex)		Microsoft
+7C1E52     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+DC-B4-C4   (hex)		Microsoft XCG
+DCB4C4     (base 16)		Microsoft XCG
+				1 Microsoft Way
+				Redmond  WA  98052
+				US
+
+AC-CB-09   (hex)		Hefcom Metering (Pty) Ltd
+ACCB09     (base 16)		Hefcom Metering (Pty) Ltd
+				PO Box 10770
+				Centurion  Gauteng  0046
+				ZA
+
+18-66-E3   (hex)		Veros Systems, Inc.
+1866E3     (base 16)		Veros Systems, Inc.
+				PO Box 10534
+				College Station  Texas  77842
+				US
+
+74-FD-A0   (hex)		Compupal (Group) Corporation 
+74FDA0     (base 16)		Compupal (Group) Corporation 
+				No.1555 Jiashan Avenue
+				Jiashan  Zhejiang  314113
+				CN
+
+CC-B8-F1   (hex)		EAGLE KINGDOM TECHNOLOGIES LIMITED
+CCB8F1     (base 16)		EAGLE KINGDOM TECHNOLOGIES LIMITED
+				FLAT/ RM B 26/F TWO CHINACHEM PLAZA 68 CONNAUGHT ROAD CENTRAL HK
+				    
+				HK
+
+A4-29-B7   (hex)		bluesky
+A429B7     (base 16)		bluesky
+				Rm1410 Tower A,Chengjian plaza,NO.18 beitaipingzhuang Road,Haidian district,
+				Beijing    100088
+				CN
+
+48-F3-17   (hex)		Private
+48F317     (base 16)		Private
+
+CC-F8-F0   (hex)		Xi'an HISU Multimedia Technology Co.,Ltd.
+CCF8F0     (base 16)		Xi'an HISU Multimedia Technology Co.,Ltd.
+				3 Floor , NO.1 Building , Modern Business Enterprise Centre (East) , NO.69, Jinye road , Xi¡¯an 
+				Xi'an City  Shanxi Province  710075
+				CN
+
+04-88-8C   (hex)		Eifelwerk Butler Systeme GmbH
+04888C     (base 16)		Eifelwerk Butler Systeme GmbH
+				Eifelwerkstrasse 1
+				Malbergweich    54655
+				DE
+
+D4-5A-B2   (hex)		Galleon Systems
+D45AB2     (base 16)		Galleon Systems
+				Unit 9, Fortnum Close
+				Birmingham  West Midlands  B33 0LG
+				GB
+
+30-DE-86   (hex)		Cedac Software S.r.l.
+30DE86     (base 16)		Cedac Software S.r.l.
+				Via Toscana, 3
+				Castiglione dei Pepoli  Bologna  40035
+				IT
+
+18-C4-51   (hex)		Tucson Embedded Systems
+18C451     (base 16)		Tucson Embedded Systems
+				5620 North Kolb Road
+				Tucson  AZ  85750
+				US
+
+70-46-42   (hex)		CHYNG HONG ELECTRONIC CO., LTD.
+704642     (base 16)		CHYNG HONG ELECTRONIC CO., LTD.
+				No.80, Lane 258, Sec. 3, Hansi W. Rd.,
+				Taichung    40647
+				TW
+
+D4-1C-1C   (hex)		RCF S.P.A.
+D41C1C     (base 16)		RCF S.P.A.
+				Via Raffaello Sanzio 13
+				Reggio Emilia  Italy  42124
+				IT
+
+58-92-0D   (hex)		Kinetic Avionics Limited
+58920D     (base 16)		Kinetic Avionics Limited
+				Elstree Aerodrome
+				Hertfordshire    WD6 3AW
+				GB
+
+AC-02-EF   (hex)		Comsis
+AC02EF     (base 16)		Comsis
+				3 rue Broussais
+				Paris    75014
+				FR
+
+B8-B4-2E   (hex)		Gionee Communication Equipment Co,Ltd.ShenZhen
+B8B42E     (base 16)		Gionee Communication Equipment Co,Ltd.ShenZhen
+				21/F Times Technology Building, 7028 Shennan Road, Futian District,
+				Shenzhen  Guangdong  518040
+				CN
+
+44-3E-B2   (hex)		DEOTRON Co., LTD.
+443EB2     (base 16)		DEOTRON Co., LTD.
+				506, Dain Bldg
+				Ansan  Kyonggi-do  425-856
+				KR
+
+D0-59-C3   (hex)		CeraMicro Technology Corporation
+D059C3     (base 16)		CeraMicro Technology Corporation
+				4F, No. 16-1, Sec. 6, Mingcyuan East Road
+				Taipei    114
+				TW
+
+18-2C-91   (hex)		Concept Development, Inc.
+182C91     (base 16)		Concept Development, Inc.
+				1881 Langley Avenue
+				Irvine  CA  92614-5623
+				US
+
+FC-17-94   (hex)		InterCreative Co., Ltd
+FC1794     (base 16)		InterCreative Co., Ltd
+				897-6, HoGye-Dong, DongAn-Gu,
+				AnYang-Si,  GyeongGi-Do,  431-836
+				KR
+
+B4-0B-7A   (hex)		Brusa Elektronik AG
+B40B7A     (base 16)		Brusa Elektronik AG
+				Neudorf 14
+				Sennwald  St. Gallen  9466
+				CH
+
+28-0C-B8   (hex)		Mikrosay Yazilim ve Elektronik A.S.
+280CB8     (base 16)		Mikrosay Yazilim ve Elektronik A.S.
+				Cevizli Mah. Tansel Cad. 
+				Istanbul    34846
+				TR
+
+3C-C9-9E   (hex)		Huiyang Technology Co., Ltd
+3CC99E     (base 16)		Huiyang Technology Co., Ltd
+				22D 7 Block ZhonghuiNewcity
+				Dongguan  Guangdong  523849
+				CN
+
+2C-1E-EA   (hex)		AERODEV
+2C1EEA     (base 16)		AERODEV
+				No.59,1985 Lane,Chunshen Road,
+				Shanghai    200237
+				CN
+
+1C-8E-8E   (hex)		DB Communication & Systems Co., ltd.
+1C8E8E     (base 16)		DB Communication & Systems Co., ltd.
+				3-3 Yeongdeok-dong, Giheung-gu
+				Yongin-si  Gyeonggi-do  449-908
+				KR
+
+24-EC-99   (hex)		ASKEY COMPUTER CORP
+24EC99     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+A4-4B-15   (hex)		Sun Cupid Technology (HK) LTD
+A44B15     (base 16)		Sun Cupid Technology (HK) LTD
+				Room 1201-3, 12/F., Tower 6
+				Tsim Sha Tsui    
+				HK
+
+48-C8-62   (hex)		Simo Wireless,Inc.
+48C862     (base 16)		Simo Wireless,Inc.
+				326#,Building 4,Zhongxing Industrial Park,Chuangye
+				Shenzhen  Guangdong  518054
+				CN
+
+78-BE-B6   (hex)		Enhanced Vision
+78BEB6     (base 16)		Enhanced Vision
+				5882 MACHINE DR.
+				Huntington Beach  California  92649
+				US
+
+44-9C-B5   (hex)		Alcomp, Inc
+449CB5     (base 16)		Alcomp, Inc
+				11537 Walnut Lane
+				Fort Atkinson  WI  53538
+				US
+
+B4-FC-75   (hex)		SEMA Electronics(HK) CO.,LTD
+B4FC75     (base 16)		SEMA Electronics(HK) CO.,LTD
+				Xialingbei Industrial Zone  Liaobu, 
+				Dongguan  Guangdong  523411
+				CN
+
+B0-BF-99   (hex)		WIZITDONGDO
+B0BF99     (base 16)		WIZITDONGDO
+				2F, 299-1, 3-DONG, SUNGSU 2-GA
+				SEOUL    133-833
+				KR
+
+B8-2A-DC   (hex)		EFR Europäische Funk-Rundsteuerung GmbH
+B82ADC     (base 16)		EFR Europäische Funk-Rundsteuerung GmbH
+				Nymphenburger Straße 20b
+				Munich    80335
+				DE
+
+40-F1-4C   (hex)		ISE Europe SPRL
+40F14C     (base 16)		ISE Europe SPRL
+				Fauvette 1
+				Uccle    1180
+				BE
+
+E8-94-4C   (hex)		Cogent Healthcare Systems Ltd
+E8944C     (base 16)		Cogent Healthcare Systems Ltd
+				69 Alma Road
+				Berkshire    SL4 3HT
+				GB
+
+90-67-F3   (hex)		Alcatel Lucent
+9067F3     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+D4-F0-B4   (hex)		Napco Security Technologies
+D4F0B4     (base 16)		Napco Security Technologies
+				333 Bayview Ave
+				Amityville  NY  11701
+				US
+
+68-F8-95   (hex)		Redflow Limited
+68F895     (base 16)		Redflow Limited
+				1/27 Counihan Rd 
+				Brisbane  Queensland  4073
+				AU
+
+70-B9-21   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+70B921     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+A0-E2-95   (hex)		DAT System Co.,Ltd
+A0E295     (base 16)		DAT System Co.,Ltd
+				Gun San Free Trade Area 511-1 ,
+				    573-540
+				KR
+
+A0-16-5C   (hex)		Triteka LTD
+A0165C     (base 16)		Triteka LTD
+				Malha Technology Park
+				Jerusalem    96951
+				IL
+
+9C-41-7C   (hex)		Hame  Technology Co.,  Limited 
+9C417C     (base 16)		Hame  Technology Co.,  Limited 
+				5F, No. 18 High Tech Middle Avenue One, High Tech Industrial Park, Nanshan District, 
+				Shenzhen  Guangdong  518057
+				CN
+
+9C-6A-BE   (hex)		QEES ApS.
+9C6ABE     (base 16)		QEES ApS.
+				Naverland 31, 2.tv
+				Glostrup  Hovedstaden  2600
+				DK
+
+9C-93-4E   (hex)		Xerox Corporation
+9C934E     (base 16)		Xerox Corporation
+				Mail Stop 0214 - 7E
+				Webster  NY  14580
+				US
+
+04-46-65   (hex)		Murata Manufacturing Co., Ltd.
+044665     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+2C-21-72   (hex)		Juniper Networks
+2C2172     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-09-17   (hex)		Far-sighted mobile
+900917     (base 16)		Far-sighted mobile
+				Technology Park Desay Building 6th-Floor
+				Shenzhen  Guangdong Province   518000
+				CN
+
+2C-8B-F2   (hex)		Hitachi Metals America Ltd
+2C8BF2     (base 16)		Hitachi Metals America Ltd
+				1920 Zanker Road
+				San Jose   CA  95112
+				US
+
+D8-97-3B   (hex)		Artesyn Embedded Technologies
+D8973B     (base 16)		Artesyn Embedded Technologies
+				16/F Lu Plaza Building
+				Kwun Tong  Kowloon  00000
+				HK
+
+38-26-CD   (hex)		ANDTEK
+3826CD     (base 16)		ANDTEK
+				Am Soeldnermoos 17
+				Hallbergmoos  Bavaria  85399
+				DE
+
+88-BF-D5   (hex)		Simple Audio Ltd
+88BFD5     (base 16)		Simple Audio Ltd
+				Unit 59 Elderpark Workspace
+				Glasgow    G51 3TR
+				GB
+
+24-CB-E7   (hex)		MYK, Inc.
+24CBE7     (base 16)		MYK, Inc.
+				4-60-30-108, Kamoi, 
+				Yokohama  Kanagawa  226-0003
+				JP
+
+B0-A1-0A   (hex)		Pivotal Systems Corporation
+B0A10A     (base 16)		Pivotal Systems Corporation
+				4683  Chabot Drive
+				Pleasanton  CA  94588
+				US
+
+80-2D-E1   (hex)		Solarbridge Technologies
+802DE1     (base 16)		Solarbridge Technologies
+				9229 Waterford Centre Blvd
+				Austin  TX  78758
+				US
+
+F4-A5-2A   (hex)		Hawa Technologies Inc
+F4A52A     (base 16)		Hawa Technologies Inc
+				336 Hayes St
+				San Francisco  California  94102
+				US
+
+0C-6E-4F   (hex)		PrimeVOLT Co., Ltd.
+0C6E4F     (base 16)		PrimeVOLT Co., Ltd.
+				2F-3, No. 9, Lane 3, Jihu Rd, Neihu
+				Taipei    11492
+				TW
+
+E8-B7-48   (hex)		Cisco Systems, Inc
+E8B748     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-99-BC   (hex)		FonSee Technology Inc.
+BC99BC     (base 16)		FonSee Technology Inc.
+				14F-2, No.32, Gaotie 2nd Rd.,
+				Zhubei City  Hsinchu County  302
+				TW
+
+78-3F-15   (hex)		EasySYNC Ltd.
+783F15     (base 16)		EasySYNC Ltd.
+				Unit 1, 2 Seaward Place
+				Glasgow  Scotland  G41 1HH
+				GB
+
+18-D0-71   (hex)		DASAN CO., LTD.
+18D071     (base 16)		DASAN CO., LTD.
+				DASAN Tower 7F, 49 Daewangpangyo-ro644beon-gil
+				Seongnam-si  Gyeonggi-do  463-760
+				KR
+
+58-E4-76   (hex)		CENTRON COMMUNICATIONS TECHNOLOGIES FUJIAN CO.,LTD
+58E476     (base 16)		CENTRON COMMUNICATIONS TECHNOLOGIES FUJIAN CO.,LTD
+				4th Floor,Jiaodajiepu Building,72# Kejierlu Road, 
+				Xi'an  Shaanxi Province  710100
+				CN
+
+44-7E-95   (hex)		Alpha and Omega, Inc
+447E95     (base 16)		Alpha and Omega, Inc
+				4735 Montview Blvd
+				Denver  CO  80207
+				US
+
+98-60-22   (hex)		EMW Co., Ltd.
+986022     (base 16)		EMW Co., Ltd.
+				80B-4L, 680-3 Gojan-Dong
+				Incheon    405-819
+				KR
+
+B8-D4-9D   (hex)		M Seven System Ltd.
+B8D49D     (base 16)		M Seven System Ltd.
+				24F, Trust Tower Bldg, 275-7, Yangjae2-Dong, Seocho-Gu
+				Seoul    137-739
+				KR
+
+3C-67-2C   (hex)		Sciovid Inc.
+3C672C     (base 16)		Sciovid Inc.
+				387 S Silverbrook Dr
+				Anaheim  CA  92807
+				US
+
+DC-9B-1E   (hex)		Intercom, Inc.
+DC9B1E     (base 16)		Intercom, Inc.
+				Sorimachi Bldg., 3-5, Taito 1-chome, 
+				Taito-ku  Tokyo  110-8654
+				JP
+
+BC-5F-F4   (hex)		ASRock Incorporation
+BC5FF4     (base 16)		ASRock Incorporation
+				2F.,No.37, Sec.2, Jhongyang S.Rd., Beitou Distric, 
+				Taipei    112
+				TW
+
+E8-B4-AE   (hex)		Shenzhen C&D Electronics Co.,Ltd
+E8B4AE     (base 16)		Shenzhen C&D Electronics Co.,Ltd
+				Building 2, Xia You Song Mountain Top Industrial District, You Song Village
+				Shenzhen  Guang Dong  518000
+				CN
+
+50-FA-AB   (hex)		L-tek d.o.o.
+50FAAB     (base 16)		L-tek d.o.o.
+				Obrtna cesta 18
+				Sentjernej    8310
+				SI
+
+38-91-FB   (hex)		Xenox Holding BV
+3891FB     (base 16)		Xenox Holding BV
+				Lingedijk 80
+				Tricht  Gelderland  4196 HC
+				NL
+
+A8-E0-18   (hex)		Nokia Corporation
+A8E018     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+78-1D-FD   (hex)		Jabil Inc
+781DFD     (base 16)		Jabil Inc
+				10500 Dr. Martin Luther King Jr. St. N.
+				St. Petersburg  Florida  33716
+				US
+
+18-AE-BB   (hex)		Siemens Convergence Creators GmbH&Co.KG
+18AEBB     (base 16)		Siemens Convergence Creators GmbH&Co.KG
+				Communications, Media and Technology
+				Hamburg    D-21079
+				DE
+
+B0-BD-A1   (hex)		ZAKLAD ELEKTRONICZNY SIMS
+B0BDA1     (base 16)		ZAKLAD ELEKTRONICZNY SIMS
+				POD SKARPA 51A
+				BYDGOSZCZ  KUJAWSKO-POMORSKIE  85-796
+				PL
+
+70-B2-65   (hex)		Hiltron s.r.l.
+70B265     (base 16)		Hiltron s.r.l.
+				Strada Provinciale di Caserta, 218
+				Naples    80144
+				IT
+
+CC-C6-2B   (hex)		Tri-Systems Corporation
+CCC62B     (base 16)		Tri-Systems Corporation
+				3-27-8 TRS Building 3F
+				Hachioji  Tokyo  192-0904
+				JP
+
+D8-C0-68   (hex)		Netgenetech.co.,ltd.
+D8C068     (base 16)		Netgenetech.co.,ltd.
+				704, Hanlim Venture Town., #689-6, 
+				Gunpo-si    435-862
+				KR
+
+60-11-99   (hex)		Siama Systems Inc
+601199     (base 16)		Siama Systems Inc
+				410 Saint-Nicolas Street
+				Montreal  Quebec  H2Y 2P5
+				CA
+
+6C-81-FE   (hex)		Mitsuba Corporation
+6C81FE     (base 16)		Mitsuba Corporation
+				1-2681
+				Kiryu  Gunma  376-8555
+				JP
+
+C0-27-B9   (hex)		Beijing National Railway Research & Design Institute  of Signal & Communication Co., Ltd.
+C027B9     (base 16)		Beijing National Railway Research & Design Institute  of Signal & Communication Co., Ltd.
+				Building No.18, Huayuan YiLi,Fengtai District,
+				Beijing    100073
+				CN
+
+14-74-11   (hex)		RIM
+147411     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+F8-A9-DE   (hex)		PUISSANCE PLUS
+F8A9DE     (base 16)		PUISSANCE PLUS
+				222 Impasse Louis Lépine
+				Montauban    82000
+				FR
+
+A8-8C-EE   (hex)		MicroMade Galka i Drozdz sp.j.
+A88CEE     (base 16)		MicroMade Galka i Drozdz sp.j.
+				ul. Wieniawskiego 16
+				Pila  Wielkopolskie  64-920
+				PL
+
+DC-2B-66   (hex)		InfoBLOCK S.A. de C.V.
+DC2B66     (base 16)		InfoBLOCK S.A. de C.V.
+				Hegel 229 - 10
+				Mexico City  Distrito Federal  11570
+				MX
+
+B8-87-1E   (hex)		Good Mind Industries Co., Ltd.
+B8871E     (base 16)		Good Mind Industries Co., Ltd.
+				22, Ta Yeou 2nd St, 
+				Kaohsiung    831
+				TW
+
+D4-F0-27   (hex)		Trust Power Ltd.
+D4F027     (base 16)		Trust Power Ltd.
+				13 Berkley Street
+				London    W1J 8DU
+				GB
+
+04-55-CA   (hex)		BriView (Xiamen) Corp.
+0455CA     (base 16)		BriView (Xiamen) Corp.
+				NO.1998 West of Fangshan Road,Xiang An Branch,Torch Hi-tech lndustrial Development Zone,
+				Xiamen city  Fujian Province  361102
+				CN
+
+14-35-B3   (hex)		Future Designs, Inc.
+1435B3     (base 16)		Future Designs, Inc.
+				2702 Triana Blvd
+				Huntsville  AL  35805
+				US
+
+AC-93-2F   (hex)		Nokia Corporation
+AC932F     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+00-54-AF   (hex)		Continental Automotive Systems Inc.
+0054AF     (base 16)		Continental Automotive Systems Inc.
+				21440 W. Lake Cook Rd.
+				Deer Park  IL  60010
+				US
+
+AC-CA-BA   (hex)		Midokura Co., Ltd. 
+ACCABA     (base 16)		Midokura Co., Ltd. 
+				7th Floor Azabudai Hinoki building
+				Tokyo    106-0041
+				JP
+
+0C-81-12   (hex)		Private
+0C8112     (base 16)		Private
+
+9C-95-F8   (hex)		SmartDoor Systems, LLC
+9C95F8     (base 16)		SmartDoor Systems, LLC
+				5711-A Center Lane
+				Falls Church  Virginia  22041
+				US
+
+78-19-F7   (hex)		Juniper Networks
+7819F7     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+64-09-4C   (hex)		Beijing Superbee Wireless Technology Co.,Ltd
+64094C     (base 16)		Beijing Superbee Wireless Technology Co.,Ltd
+				B7,Science-Tech Fortune Center,
+				Beijing    100192
+				CN
+
+7C-7D-41   (hex)		Jinmuyu Electronics Co., Ltd.
+7C7D41     (base 16)		Jinmuyu Electronics Co., Ltd.
+				Room 132, Building 16, Tianqiaowan
+				Beijing    101101
+				CN
+
+4C-14-80   (hex)		NOREGON SYSTEMS, INC
+4C1480     (base 16)		NOREGON SYSTEMS, INC
+				100 N. MAIN ST.  SUITE 2200
+				WINSTON - SALEM  NC  27101
+				US
+
+A4-85-6B   (hex)		Q Electronics Ltd
+A4856B     (base 16)		Q Electronics Ltd
+				Beck House, Hawksworth Road
+				Leeds  West Yorkshire  LS18 4JP
+				GB
+
+20-D5-AB   (hex)		Korea Infocom Co.,Ltd.
+20D5AB     (base 16)		Korea Infocom Co.,Ltd.
+				5F Wintek B/D 511
+				Uiwang  Kyunggi-Do  437-830
+				KR
+
+0C-F3-EE   (hex)		EM Microelectronic
+0CF3EE     (base 16)		EM Microelectronic
+				Rue des Sors 3
+				Marin-Epagnier  Neuchatel  2074
+				CH
+
+64-D1-A3   (hex)		Sitecom Europe BV
+64D1A3     (base 16)		Sitecom Europe BV
+				Linatebaan 101
+				Rotterdam  Zuid Holland  3045 AH
+				NL
+
+F4-3E-9D   (hex)		Benu Networks, Inc.
+F43E9D     (base 16)		Benu Networks, Inc.
+				300 Rd., Suite 110
+				Billerica  MA  01821
+				US
+
+04-E2-F8   (hex)		AEP Ticketing solutions srl
+04E2F8     (base 16)		AEP Ticketing solutions srl
+				Via dei Colli, 240
+				Signa  Firenze  50058
+				IT
+
+EC-9E-CD   (hex)		Artesyn Embedded Technologies
+EC9ECD     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way Suite 190
+				Tempe  Arizona  85282
+				US
+
+8C-51-05   (hex)		Shenzhen ireadygo Information Technology CO.,LTD.
+8C5105     (base 16)		Shenzhen ireadygo Information Technology CO.,LTD.
+				Room 02,11F,DESAY Building,No.1 Hi-Tech South Road
+				Shenzhen    518057
+				CN
+
+C8-20-8E   (hex)		Storagedata
+C8208E     (base 16)		Storagedata
+				Randstad 22117
+				Almere  Flevoland  1316BW
+				NL
+
+5C-5E-AB   (hex)		Juniper Networks
+5C5EAB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+9C-80-7D   (hex)		SYSCABLE Korea Inc.
+9C807D     (base 16)		SYSCABLE Korea Inc.
+				2F KAMA Bldg 1461-15 Secho-3dong Seocho-Gu
+				Seoul    137-720
+				KR
+
+28-E2-97   (hex)		Shanghai InfoTM Microelectronics Co.,Ltd.
+28E297     (base 16)		Shanghai InfoTM Microelectronics Co.,Ltd.
+				building 11,NO.115,lane 572,BiBo Road,
+				ShangHai    201203
+				CN
+
+34-B5-71   (hex)		PLDS
+34B571     (base 16)		PLDS
+				Schanzenfeldstrasse 2
+				Wetzlar  Hessen  35578
+				DE
+
+3C-74-37   (hex)		RIM
+3C7437     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+EC-92-33   (hex)		Eddyfi NDT Inc
+EC9233     (base 16)		Eddyfi NDT Inc
+				2800, Louis-Lumiere street
+				Quebec  Quebec  G1P 0A4
+				CA
+
+74-38-89   (hex)		ANNAX Anzeigesysteme GmbH
+743889     (base 16)		ANNAX Anzeigesysteme GmbH
+				Wettersteinstrasse 18
+				Taufkirchen  Bavaria  82024
+				DE
+
+44-D2-CA   (hex)		Anvia TV Oy
+44D2CA     (base 16)		Anvia TV Oy
+				PO Box 29
+				SEINAJOKI    FIN60101
+				FI
+
+38-6E-21   (hex)		Wasion Group Ltd.
+386E21     (base 16)		Wasion Group Ltd.
+				No.468 West Tongzipo Road High-Tech Industrial Development Zone
+				Changsha City  Hunan Province,  410205 
+				CN
+
+28-72-F0   (hex)		ATHENA
+2872F0     (base 16)		ATHENA
+				42 RUE MONGE
+				PARIS    75005
+				FR
+
+1C-19-DE   (hex)		eyevis GmbH
+1C19DE     (base 16)		eyevis GmbH
+				Hundsschleestrasse 23
+				Reutlingen  BW  72766
+				DE
+
+60-9E-64   (hex)		Vivonic GmbH
+609E64     (base 16)		Vivonic GmbH
+				Kurfuerst-Eppstein-Ring 4
+				Sailauf  Bayern  63877
+				DE
+
+BC-15-A6   (hex)		Taiwan Jantek Electronics,Ltd.
+BC15A6     (base 16)		Taiwan Jantek Electronics,Ltd.
+				6F-1,No.1 Wu-Chuan 1St. Rd,Wu-Ku Industrial Park,
+				Sinchwang City  Taipei Hsien  24892
+				TW
+
+DC-DE-CA   (hex)		Akyllor
+DCDECA     (base 16)		Akyllor
+				Britannia House, 22, 2F, Cator Road
+				Bandar Seri Begawan BS    8811
+				BN
+
+A0-AA-FD   (hex)		EraThink Technologies Corp.
+A0AAFD     (base 16)		EraThink Technologies Corp.
+				289 Bisheng Road Building 4,Floor 4
+				Shanghai    201204
+				CN
+
+6C-A9-06   (hex)		Telefield Ltd
+6CA906     (base 16)		Telefield Ltd
+				Flat D,2/F., Valiant Industrial Centre,2-12 Au Pui Wan Street, 
+				Hongkong    852
+				CN
+
+78-22-3D   (hex)		Affirmed Networks
+78223D     (base 16)		Affirmed Networks
+				35 Nagog Park
+				Acton  MA  01720
+				US
+
+3C-02-B1   (hex)		Creation Technologies LP
+3C02B1     (base 16)		Creation Technologies LP
+				3939 North Fraser Way
+				Burnaby  BC  V5J 5J2
+				CA
+
+E4-41-E6   (hex)		Ottec Technology GmbH
+E441E6     (base 16)		Ottec Technology GmbH
+				Bünteweg 33
+				Gehrden  Lower Saxony  30989
+				DE
+
+BC-71-C1   (hex)		XTrillion, Inc.
+BC71C1     (base 16)		XTrillion, Inc.
+				1-12-3-4F 
+				Chiyoda-ku  Tokyo  101-0041
+				JP
+
+E0-E8-E8   (hex)		Olive Telecommunication Pvt. Ltd
+E0E8E8     (base 16)		Olive Telecommunication Pvt. Ltd
+				862, Udyog Vihar
+				Gurgaon  Haryana  122016
+				IN
+
+60-52-D0   (hex)		FACTS Engineering 
+6052D0     (base 16)		FACTS Engineering 
+				8049 Photonics Drive
+				New Port Richey  FL  34655
+				US
+
+B0-89-91   (hex)		LGE 
+B08991     (base 16)		LGE 
+				60-39 , Kasan -dong , Gumcheon-gu.
+				Seoul     153-801
+				KR
+
+30-14-2D   (hex)		Piciorgros GmbH
+30142D     (base 16)		Piciorgros GmbH
+				Claudiastrasse 5
+				Cologne  NRW  51149
+				DE
+
+50-AF-73   (hex)		Shenzhen Bitland Information Technology Co., Ltd.
+50AF73     (base 16)		Shenzhen Bitland Information Technology Co., Ltd.
+				1-4F,44 Building,Tanglang Industrial Park and 1-6F,#7 Building,XiLi Tongfuyu Industrial Town,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+5C-9A-D8   (hex)		FUJITSU LIMITED
+5C9AD8     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+A4-C0-E1   (hex)		Nintendo Co., Ltd.
+A4C0E1     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+4C-3B-74   (hex)		VOGTEC(H.K.) Co., Ltd
+4C3B74     (base 16)		VOGTEC(H.K.) Co., Ltd
+				Flat 01, 2/F, On Ning Building,
+				Hong Kong    999077
+				CN
+
+68-43-52   (hex)		Bhuu Limited
+684352     (base 16)		Bhuu Limited
+				Office 1, 465 Mt Eden Road
+				Auckland    1023
+				NZ
+
+EC-E9-0B   (hex)		SISTEMA SOLUCOES ELETRONICAS LTDA - EASYTECH
+ECE90B     (base 16)		SISTEMA SOLUCOES ELETRONICAS LTDA - EASYTECH
+				RUA GUERRA DE AGUIAR, 220
+				São Paulo  SP  08275-260
+				BR
+
+A0-8C-9B   (hex)		Xtreme Technologies Corp
+A08C9B     (base 16)		Xtreme Technologies Corp
+				200 4616 Valiant Dr NW
+				Calgary  AB  T3A0X9
+				CA
+
+A8-39-44   (hex)		Actiontec Electronics, Inc
+A83944     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+74-E0-6E   (hex)		Ergophone GmbH
+74E06E     (base 16)		Ergophone GmbH
+				Temmlerstrasse 5
+				Marburg  Hessen  35039
+				DE
+
+0C-F0-B4   (hex)		Globalsat International Technology Ltd
+0CF0B4     (base 16)		Globalsat International Technology Ltd
+				17th floor,China Youse Building,No.6013 Shennan Avenue,Futian District,
+				Shenzhen  Guangdong  518040
+				CN
+
+48-DF-1C   (hex)		Wuhan NEC Fibre Optic Communications industry Co. Ltd
+48DF1C     (base 16)		Wuhan NEC Fibre Optic Communications industry Co. Ltd
+				3rd Road Guanshan,
+				Wuhan  Hubei  430074
+				CN
+
+D4-9C-8E   (hex)		University of FUKUI
+D49C8E     (base 16)		University of FUKUI
+				3-9-1 Bunkyo
+				Fukui City    910-8507
+				JP
+
+F8-F0-14   (hex)		RackWare Inc.
+F8F014     (base 16)		RackWare Inc.
+				44053 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+28-26-A6   (hex)		PBR electronics GmbH
+2826A6     (base 16)		PBR electronics GmbH
+				Berliner Strasse 5
+				Sandhausen  Baden Wuertemmberg  69207
+				DE
+
+B4-28-F1   (hex)		E-Prime Co., Ltd.
+B428F1     (base 16)		E-Prime Co., Ltd.
+				Rm1207, Kolon Science Valley, 811,
+				Seoul    152050
+				KR
+
+C0-12-42   (hex)		Alpha Security Products
+C01242     (base 16)		Alpha Security Products
+				10715 Sikes Place, Ste. 200
+				Charlotte  NC  28277
+				US
+
+BC-20-BA   (hex)		Inspur (Shandong) Electronic Information Co., Ltd
+BC20BA     (base 16)		Inspur (Shandong) Electronic Information Co., Ltd
+				No.1036 Shunya Rd.
+				Jinan  Shandong  250101
+				CN
+
+1C-FE-A7   (hex)		IDentytech Solutins Ltd.
+1CFEA7     (base 16)		IDentytech Solutins Ltd.
+				14 Hadaya Street 
+				Ramat- Hasharon    47226
+				IL
+
+30-4E-C3   (hex)		Tianjin Techua Technology Co., Ltd.
+304EC3     (base 16)		Tianjin Techua Technology Co., Ltd.
+				12-1-1401 Tianlinyuan Fulicheng Gulouxi Road,Nankai District 
+				Tianjin    300101
+				CN
+
+B4-CF-DB   (hex)		Shenzhen Jiuzhou Electric Co.,LTD
+B4CFDB     (base 16)		Shenzhen Jiuzhou Electric Co.,LTD
+				6F,Jiuzhou Electric Building,Southern No.12RD.,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  Guangdong  518057
+				CN
+
+FC-D4-F2   (hex)		The Coca Cola Company
+FCD4F2     (base 16)		The Coca Cola Company
+				One Coca Cola Plaza
+				Atlanta  GA  30313
+				US
+
+5C-6A-7D   (hex)		KENTKART EGE ELEKTRONIK SAN. VE TIC. LTD. STI. 
+5C6A7D     (base 16)		KENTKART EGE ELEKTRONIK SAN. VE TIC. LTD. STI. 
+				1370 SK, NO:42/304, 
+				MONTRO  IZMIR  35230
+				TR
+
+44-59-9F   (hex)		Criticare Systems, Inc
+44599F     (base 16)		Criticare Systems, Inc
+				20925 Crossroads Circle
+				Waukasha  WI  53186
+				US
+
+3C-2F-3A   (hex)		SFORZATO Corp.
+3C2F3A     (base 16)		SFORZATO Corp.
+				863
+				HINO-SHI  TOKYO  191-0022
+				JP
+
+74-CE-56   (hex)		Packet Force Technology Limited Company
+74CE56     (base 16)		Packet Force Technology Limited Company
+				 2F., No.25, Sec. 1, Shuangshi Rd., Central Dist., 
+				Taichung    40046
+				TW
+
+AC-2F-A8   (hex)		Humannix Co.,Ltd.
+AC2FA8     (base 16)		Humannix Co.,Ltd.
+				#402, 98-4, Songpa-Dong, Songpa-Gu
+				Seoul    138-170
+				KR
+
+10-64-E2   (hex)		ADFweb.com s.r.l.
+1064E2     (base 16)		ADFweb.com s.r.l.
+				Strada Nuova, 17
+				Mareno di Piave  Treviso  31010
+				IT
+
+CC-34-D7   (hex)		GEWISS S.P.A.
+CC34D7     (base 16)		GEWISS S.P.A.
+				VIA ALESSANDRO VOLTA 1
+				CENATE SOTTO    24069
+				IT
+
+F0-2A-61   (hex)		Waldo Networks, Inc.
+F02A61     (base 16)		Waldo Networks, Inc.
+				4505 Spicewood Springs Rd
+				Austin  Texas  78759
+				US
+
+C8-A7-0A   (hex)		Verizon Business
+C8A70A     (base 16)		Verizon Business
+				One Digex Plaza
+				Beltsville  MD  20705
+				US
+
+60-DA-23   (hex)		Estech Co.,Ltd
+60DA23     (base 16)		Estech Co.,Ltd
+				#717,133-1,Sangdaewon-Dong
+				Seongnam-Si  Gyeonggi-Do  462-120
+				KR
+
+44-DC-CB   (hex)		SEMINDIA SYSTEMS PVT LTD
+44DCCB     (base 16)		SEMINDIA SYSTEMS PVT LTD
+				1006/13, Sy No.49/1&3, 7th Mile, A.M Indl Estate,
+				Bangalore  Karnataka  560068
+				IN
+
+A0-DE-05   (hex)		JSC Irbis-T
+A0DE05     (base 16)		JSC Irbis-T
+				39, Gorodskoy lane
+				Tula    300012
+				RU
+
+08-17-F4   (hex)		IBM Corp
+0817F4     (base 16)		IBM Corp
+				2051 Mission College Blvd
+				Santa Clara  CA  95054
+				US
+
+CC-D8-11   (hex)		Aiconn Technology Corporation
+CCD811     (base 16)		Aiconn Technology Corporation
+				5F, NO. 9, Alley 2, Lane 35, Ji-Hu Rd., Nei-Hu, 
+				Taipei City    11494
+				TW
+
+F4-38-14   (hex)		Shanghai Howell Electronic Co.,Ltd
+F43814     (base 16)		Shanghai Howell Electronic Co.,Ltd
+				5-5/F, Bldg.1, No.788 Fengzhen Rd., 
+				Shanghai     200434
+				CN
+
+90-61-0C   (hex)		Fida International (S) Pte Ltd
+90610C     (base 16)		Fida International (S) Pte Ltd
+				Blk 16, Kallang Place 
+				    339156
+				SG
+
+3C-5F-01   (hex)		Synerchip Co., Ltd.
+3C5F01     (base 16)		Synerchip Co., Ltd.
+				c/o Synerchip USA Corp.
+				Sunnyvale  CA  94085
+				US
+
+EC-BB-AE   (hex)		Digivoice Tecnologia em Eletronica Ltda
+ECBBAE     (base 16)		Digivoice Tecnologia em Eletronica Ltda
+				Alameda Juru, 159 - Torreo
+				Barueri  São Paulo  06455-010
+				BR
+
+34-A1-83   (hex)		AWare, Inc
+34A183     (base 16)		AWare, Inc
+				614 Massachusetts Ave. 
+				Cambridge  MA  02139
+				US
+
+98-73-C4   (hex)		Sage Electronic Engineering LLC
+9873C4     (base 16)		Sage Electronic Engineering LLC
+				201 Terry St.
+				Longmont  CO  80501
+				US
+
+B4-01-42   (hex)		GCI Science & Technology Co.,LTD
+B40142     (base 16)		GCI Science & Technology Co.,LTD
+				No.381,xingangzhong road ,
+				GuangZhou  GuangDong  510310
+				CN
+
+74-0A-BC   (hex)		LightwaveRF Technology Ltd
+740ABC     (base 16)		LightwaveRF Technology Ltd
+				Innovation Campus Birmingham
+				Faraday Wharf, Holt Street  Birmingham  B4 4BB
+				GB
+
+10-A1-3B   (hex)		FUJIKURA RUBBER LTD.
+10A13B     (base 16)		FUJIKURA RUBBER LTD.
+				1-840,Mihashi,Omiya
+				Saitama     330-0856
+				JP
+
+F4-E1-42   (hex)		Delta Elektronika BV
+F4E142     (base 16)		Delta Elektronika BV
+				Vissersdijk 4
+				Zierikzee    4301 ND
+				NL
+
+AC-81-12   (hex)		Gemtek Technology Co., Ltd.
+AC8112     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road Hsinchu Industrial Park Hukou, Hsinchu 30352 TAIWAN, REPUBLIC OF CHINA
+				Hsinchu  TAIWAN  30352
+				TW
+
+68-63-59   (hex)		Advanced Digital Broadcast SA
+686359     (base 16)		Advanced Digital Broadcast SA
+				Avenue de Tournay 7
+				Pregny-Chambesy    1292
+				CH
+
+28-06-1E   (hex)		NINGBO GLOBAL USEFUL ELECTRIC CO.,LTD
+28061E     (base 16)		NINGBO GLOBAL USEFUL ELECTRIC CO.,LTD
+				No.88,Kechuang South Road,
+				Ningbo  Zhejiang  315000
+				CN
+
+64-E8-E6   (hex)		global moisture management system
+64E8E6     (base 16)		global moisture management system
+				11132 broad river road
+				irmo  sc  29063
+				US
+
+E0-D1-0A   (hex)		Katoudenkikougyousyo co ltd
+E0D10A     (base 16)		Katoudenkikougyousyo co ltd
+				oujihontyou1-4-13
+				kita-ku  tokyo-to  114-0022
+				JP
+
+C4-4B-44   (hex)		Omniprint Inc.
+C44B44     (base 16)		Omniprint Inc.
+				1923 East Deere Ave.
+				Santa Ana  CA  92705
+				US
+
+18-92-2C   (hex)		Virtual Instruments
+18922C     (base 16)		Virtual Instruments
+				100 Enterprise Way
+				Scotts Valley  CA  95066
+				US
+
+A4-9B-13   (hex)		Digital Check
+A49B13     (base 16)		Digital Check
+				630 Dundee Rd. Suite 210
+				Northbrook  IL  60062
+				US
+
+C8-EE-08   (hex)		TANGTOP TECHNOLOGY CO.,LTD
+C8EE08     (base 16)		TANGTOP TECHNOLOGY CO.,LTD
+				1F,NO.153,Ligon St.,Beitou District
+				Taipei City     112
+				TW
+
+74-72-F2   (hex)		Chipsip Technology Co., Ltd.
+7472F2     (base 16)		Chipsip Technology Co., Ltd.
+				8F-1, No.186, Jian-Yi Road, ChungHo City,
+				Taipei    235
+				TW
+
+48-C8-B6   (hex)		SysTec GmbH
+48C8B6     (base 16)		SysTec GmbH
+				Ludwig-Erhard-Strasse 6
+				Bergheim-Glessen  NRW  50129
+				DE
+
+3C-62-78   (hex)		SHENZHEN JETNET TECHNOLOGY CO.,LTD.
+3C6278     (base 16)		SHENZHEN JETNET TECHNOLOGY CO.,LTD.
+				Room 403,4th floor,Qinghua Information Building,Keyuan Road,North District of Tech-Park,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-D5-FE   (hex)		Shenzhen Zowee Technology Co., Ltd
+C8D5FE     (base 16)		Shenzhen Zowee Technology Co., Ltd
+				Block 5, Science and Technology Industrial Park of
+				Shenzhen  GuangDong  518055
+				CN
+
+2C-30-68   (hex)		Pantech Co.,Ltd
+2C3068     (base 16)		Pantech Co.,Ltd
+				110-1 Ongjeong-Ri, Tongjin-Eup
+				Gimpo-Si  Gyounggi-Do  415-865
+				KR
+
+00-BD-27   (hex)		Exar Corp.
+00BD27     (base 16)		Exar Corp.
+				48720 Kato Rd.
+				Fremont  CA  94538
+				US
+
+5C-40-58   (hex)		Jefferson Audio Video Systems, Inc.
+5C4058     (base 16)		Jefferson Audio Video Systems, Inc.
+				13020 Middletown Industrial Blvd.
+				Louisville  Kentucky  40223
+				US
+
+58-D0-8F   (hex)		IEEE 1904.1 Working Group
+58D08F     (base 16)		IEEE 1904.1 Working Group
+				1351 Redwood Way,
+				Petaluma  CA  94954
+				US
+
+6C-9C-E9   (hex)		Nimble Storage
+6C9CE9     (base 16)		Nimble Storage
+				2645 Zanker Road
+				San Jose  CA  95134
+				US
+
+CC-09-C8   (hex)		IMAQLIQ LTD
+CC09C8     (base 16)		IMAQLIQ LTD
+				Obvodny Canal 93A
+				St.Petersburg    191119
+				RU
+
+9C-45-63   (hex)		DIMEP Sistemas
+9C4563     (base 16)		DIMEP Sistemas
+				Av. Mofarrej, 840
+				São Paulo    05311000
+				BR
+
+D4-3D-67   (hex)		Carma Industries Inc.
+D43D67     (base 16)		Carma Industries Inc.
+				132 Walsh Road
+				Lindsay  Ontario  K9V 4R3
+				CA
+
+E0-A6-70   (hex)		Nokia Corporation
+E0A670     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+58-DB-8D   (hex)		Fast Co., Ltd.
+58DB8D     (base 16)		Fast Co., Ltd.
+				2-11-1 Iwamotocho
+				Chiyoda-ku  Tokyo  101-0032
+				JP
+
+E4-46-BD   (hex)		C&C TECHNIC TAIWAN CO., LTD.
+E446BD     (base 16)		C&C TECHNIC TAIWAN CO., LTD.
+				ROOM6 13F, NO.2,Jian 8th ROAD
+				Taipei  Chungho City,   23511
+				TW
+
+8C-DD-8D   (hex)		Wifly-City System Inc.
+8CDD8D     (base 16)		Wifly-City System Inc.
+				4F.,-1,NO 106,RUEIGUANG Rd.Neihu District,
+				Taipei City     114
+				TW
+
+20-A2-E7   (hex)		Lee-Dickens Ltd
+20A2E7     (base 16)		Lee-Dickens Ltd
+				Rushton Rd
+				Kettering  Northamptonshire  NN14 2QW
+				GB
+
+FC-ED-B9   (hex)		Arrayent
+FCEDB9     (base 16)		Arrayent
+				570 El Camino Real #150-419
+				Redwood City  CA  94063
+				US
+
+44-ED-57   (hex)		Longicorn, inc.
+44ED57     (base 16)		Longicorn, inc.
+				Rm1001-2, 10F, Byuksan Digital Valley1
+				Seoul    152-775
+				KR
+
+EC-98-C1   (hex)		Beijing Risbo Network Technology Co.,Ltd
+EC98C1     (base 16)		Beijing Risbo Network Technology Co.,Ltd
+				1/F Yinyan Building 2A,No.23 Anningzhuangdonglu Haidian District 
+				Beijing    100085
+				CN
+
+38-A9-5F   (hex)		Actifio Inc
+38A95F     (base 16)		Actifio Inc
+				225 Wyman Street
+				Waltham  MA  02451
+				IN
+
+F4-DC-DA   (hex)		Zhuhai Jiahe Communication Technology Co., limited
+F4DCDA     (base 16)		Zhuhai Jiahe Communication Technology Co., limited
+				4/F,East Of B5,Sourth Software Park,Tangjia,
+				Zhuhai  Guangdong  519085
+				CN
+
+E8-04-62   (hex)		Cisco Systems, Inc
+E80462     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+DC-D0-F7   (hex)		Bentek Systems Ltd.
+DCD0F7     (base 16)		Bentek Systems Ltd.
+				315 - 3750 46th Ave. SE
+				Calgary  AB  T2B 0L1
+				CA
+
+D4-A9-28   (hex)		GreenWave Reality Inc
+D4A928     (base 16)		GreenWave Reality Inc
+				39 Parker
+				Irvine  California  92618
+				US
+
+E0-62-90   (hex)		Jinan Jovision Science & Technology Co., Ltd.
+E06290     (base 16)		Jinan Jovision Science & Technology Co., Ltd.
+				Room 407, Tower C, Cyber Port Building,
+				Jinan  Shandong  250013
+				CN
+
+10-0E-2B   (hex)		NEC CASIO Mobile Communications
+100E2B     (base 16)		NEC CASIO Mobile Communications
+				1753,Shimonumabe
+				Kawasaki-shi  Kanagawa  211-8666
+				JP
+
+70-E1-39   (hex)		3view Ltd
+70E139     (base 16)		3view Ltd
+				168-172 Old Street
+				London    EC1V 9BP
+				GB
+
+18-42-2F   (hex)		Alcatel Lucent
+18422F     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+C4-63-54   (hex)		U-Raku, Inc.
+C46354     (base 16)		U-Raku, Inc.
+				401-1 Deba
+				Ritto-shi  Shiga  520-3041
+				JP
+
+40-5F-BE   (hex)		RIM
+405FBE     (base 16)		RIM
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+68-54-F5   (hex)		enLighted Inc
+6854F5     (base 16)		enLighted Inc
+				1451 Grant Rd
+				Mountain View  CA  94040
+				US
+
+7C-B5-42   (hex)		ACES Technology
+7CB542     (base 16)		ACES Technology
+				#928, Hyundai Venture Ville
+				Seoul    135-539
+				KR
+
+90-54-46   (hex)		TES ELECTRONIC SOLUTIONS
+905446     (base 16)		TES ELECTRONIC SOLUTIONS
+				Immeuble Odyssee
+				BRUZ    35170
+				FR
+
+54-4A-05   (hex)		wenglor sensoric gmbh
+544A05     (base 16)		wenglor sensoric gmbh
+				wenglor Str. 3
+				Tettnang    88069
+				DE
+
+98-E1-65   (hex)		Accutome
+98E165     (base 16)		Accutome
+				3222 Phoenixville Pike
+				Malvern  PA  19355
+				US
+
+78-57-12   (hex)		Mobile Integration Workgroup
+785712     (base 16)		Mobile Integration Workgroup
+				4580 Klahanie DR SE STE 106
+				Issaquah  WA  98029
+				US
+
+38-0A-0A   (hex)		Sky-City Communication and Electronics Limited Company
+380A0A     (base 16)		Sky-City Communication and Electronics Limited Company
+				1109, Building A, Kefa Industrial park, Huanguan south road, Guanlan, 
+				Shenzhen  Guangdong  518110
+				CN
+
+0C-D6-96   (hex)		Amimon Ltd
+0CD696     (base 16)		Amimon Ltd
+				2 Maskit st
+				Herzlia    46733
+				IL
+
+F4-DC-4D   (hex)		Beijing CCD Digital Technology Co., Ltd
+F4DC4D     (base 16)		Beijing CCD Digital Technology Co., Ltd
+				107 Dongsi North Street, Dongcheng District, 
+				Beijing    100007
+				CN
+
+40-13-D9   (hex)		Global ES
+4013D9     (base 16)		Global ES
+				Sinimäentie 8 b
+				Espoo    02631
+				FI
+
+AC-4F-FC   (hex)		SVS-VISTEK GmbH
+AC4FFC     (base 16)		SVS-VISTEK GmbH
+				Muehlbachstraße 20
+				Seefeld  BY  82229
+				DE
+
+B4-37-41   (hex)		Consert, Inc.
+B43741     (base 16)		Consert, Inc.
+				4700 Falls of Neuse Rd.
+				Raleigh  NC  27609
+				US
+
+94-85-7A   (hex)		Evantage Industries Corp
+94857A     (base 16)		Evantage Industries Corp
+				815 Bridge St. W.
+				Waterloo  Ontario  N2V 2M7
+				CA
+
+40-83-DE   (hex)		Zebra Technologies Inc
+4083DE     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+88-97-DF   (hex)		Entrypass Corporation Sdn. Bhd.
+8897DF     (base 16)		Entrypass Corporation Sdn. Bhd.
+				No.40, Jalan TPP 1/10,
+				Puchong  Selangor Darul Ehsan  47100
+				MY
+
+24-AF-54   (hex)		NEXGEN Mediatech Inc.
+24AF54     (base 16)		NEXGEN Mediatech Inc.
+				8F No. 150, Jianyi Rd., 
+				Chung Ho  Taipei Hsien  235
+				TW
+
+F0-F8-42   (hex)		KEEBOX, Inc.
+F0F842     (base 16)		KEEBOX, Inc.
+				10 Poppy Trail
+				Rolling Hills  California  90274
+				US
+
+DC-4E-DE   (hex)		SHINYEI TECHNOLOGY CO., LTD.
+DC4EDE     (base 16)		SHINYEI TECHNOLOGY CO., LTD.
+				6-5-2, MINATOJIMA-MINAMIMACHI, CHUO-KU
+				KOBE  HYOGO  650-0047
+				JP
+
+E0-87-B1   (hex)		Nata-Info Ltd.
+E087B1     (base 16)		Nata-Info Ltd.
+				28, Prokhorova str.
+				Yoshkar-Ola  Republic Mari-El  424007
+				RU
+
+44-7C-7F   (hex)		Innolight Technology Corporation
+447C7F     (base 16)		Innolight Technology Corporation
+				3 Results Way
+				Cupertino  CA  95014
+				US
+
+D4-96-DF   (hex)		SUNGJIN C&T CO.,LTD
+D496DF     (base 16)		SUNGJIN C&T CO.,LTD
+				Daeya
+				Sheung  Gyeonggi  429-809
+				KR
+
+5C-86-4A   (hex)		Secret Labs LLC
+5C864A     (base 16)		Secret Labs LLC
+				315 Bleecker St #308
+				New York  NY  10014
+				US
+
+F0-AD-4E   (hex)		Globalscale Technologies, Inc.
+F0AD4E     (base 16)		Globalscale Technologies, Inc.
+				5F, No. 2 Building, Minxing Industrial Park
+				Shenzhen  Guangdong  518109
+				CN
+
+90-3D-5A   (hex)		Shenzhen Wision Technology Holding Limited
+903D5A     (base 16)		Shenzhen Wision Technology Holding Limited
+				Room 26A, Jinrun Building, N0.6019, Shennan Rd., Futian District
+				Shenzhen  Guangdong  518040
+				CN
+
+7C-A2-9B   (hex)		D.SignT GmbH & Co. KG
+7CA29B     (base 16)		D.SignT GmbH & Co. KG
+				Marktstraße 10
+				Kerken    47647
+				DE
+
+A0-40-41   (hex)		SAMWONFA Co.,Ltd.
+A04041     (base 16)		SAMWONFA Co.,Ltd.
+				470-5, Moonhyun2-Dong
+				Busan    608-042
+				KR
+
+40-40-6B   (hex)		Icomera
+40406B     (base 16)		Icomera
+				Vikingsgatan 3
+				Göteborg    41104
+				SE
+
+6C-22-AB   (hex)		Ainsworth Game Technology
+6C22AB     (base 16)		Ainsworth Game Technology
+				10 Holker Street 
+				Newington  New South Wales  2127
+				AU
+
+30-18-CF   (hex)		DEOS control systems GmbH
+3018CF     (base 16)		DEOS control systems GmbH
+				Birkenallee 113
+				Rheine  NRW  48432
+				DE
+
+08-FA-E0   (hex)		Fohhn Audio AG
+08FAE0     (base 16)		Fohhn Audio AG
+				Hohes Gestade 3-7
+				Nuertingen  BW  72622
+				DE
+
+58-B9-E1   (hex)		Crystalfontz America, Inc.
+58B9E1     (base 16)		Crystalfontz America, Inc.
+				12412 E. Saltese Ave.
+				Spokane Valley  WA  99216
+				US
+
+20-D9-06   (hex)		Iota, Inc.
+20D906     (base 16)		Iota, Inc.
+				2212 Queen Anne Ave. N., #348
+				Seattle  WA  98109
+				US
+
+F4-55-95   (hex)		HENGBAO Corporation LTD.
+F45595     (base 16)		HENGBAO Corporation LTD.
+				8th Floor,Tower B,Xinsheng Mansion No.5 Financial Street,
+				Beijing    100140
+				CN
+
+1C-3A-4F   (hex)		AccuSpec Electronics, LLC
+1C3A4F     (base 16)		AccuSpec Electronics, LLC
+				8140 Hawthorne Drive
+				Erie  Pennsylvania  16509
+				US
+
+9C-4E-20   (hex)		Cisco Systems, Inc
+9C4E20     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-75-33   (hex)		Nokia Corporation
+D87533     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+98-35-B8   (hex)		Assembled Products Corporation
+9835B8     (base 16)		Assembled Products Corporation
+				115 E. Linden
+				Rogers  Arkansas  72756
+				US
+
+28-89-15   (hex)		CashGuard Sverige AB
+288915     (base 16)		CashGuard Sverige AB
+				Finlandsgatan 16
+				Kista    16474
+				SE
+
+4C-5D-CD   (hex)		Oy Finnish Electric Vehicle Technologies Ltd
+4C5DCD     (base 16)		Oy Finnish Electric Vehicle Technologies Ltd
+				Majavantie 10
+				TUUSULA    FI-04320
+				FI
+
+70-D5-7E   (hex)		Scalar Corporation
+70D57E     (base 16)		Scalar Corporation
+				1F San-Ei Bldg
+				Shinjuku-ku  Tokyo  160-0023
+				JP
+
+B0-E3-9D   (hex)		CAT SYSTEM CO.,LTD.
+B0E39D     (base 16)		CAT SYSTEM CO.,LTD.
+				3-147-27 Higasi-sinmachi Hirohata-ku
+				Himeji  Hyogo  671-1121
+				JP
+
+7C-2E-0D   (hex)		Blackmagic Design
+7C2E0D     (base 16)		Blackmagic Design
+				11 Gateway Court
+				Melbourne  Victoria  3207
+				AU
+
+18-0C-77   (hex)		Westinghouse Electric Company, LLC
+180C77     (base 16)		Westinghouse Electric Company, LLC
+				1000 Westinghouse Drive
+				Cranberry Township  PA  16066
+				US
+
+68-CA-00   (hex)		Octopus Systems Limited
+68CA00     (base 16)		Octopus Systems Limited
+				36/F, 148 Electric Road
+				    
+				HK
+
+E0-58-9E   (hex)		Laerdal Medical
+E0589E     (base 16)		Laerdal Medical
+				Tanke Svilandsgate 30
+				Stavanger    4002
+				NO
+
+0C-1D-C2   (hex)		SeAH Networks
+0C1DC2     (base 16)		SeAH Networks
+				9F, IT Venture Tower East Wing 78 Garak-Dong,
+				Seoul  Songpa-gu  138-950
+				KR
+
+54-75-D0   (hex)		Cisco Systems, Inc
+5475D0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-89-B7   (hex)		KAEL MÜHENDİSLİK ELEKTRONİK TİCARET SANAYİ LİMİTED ŞİRKETİ
+6089B7     (base 16)		KAEL MÜHENDİSLİK ELEKTRONİK TİCARET SANAYİ LİMİTED ŞİRKETİ
+				Atatürk Mah. 78 sokak ,No:10, Büyükalan Mevkii
+				Izmir  Aegean  35175
+				TR
+
+30-52-5A   (hex)		NST Co., LTD
+30525A     (base 16)		NST Co., LTD
+				RM301,Daeryung Techno Town 2, 569-21
+				Seoul    153-771
+				KR
+
+2C-A7-80   (hex)		True Technologies Inc.
+2CA780     (base 16)		True Technologies Inc.
+				R476, AngelCity 1st,
+				Seongnam,  Kyungki  463-862
+				KR
+
+7C-6F-06   (hex)		Caterpillar Trimble Control Technologies
+7C6F06     (base 16)		Caterpillar Trimble Control Technologies
+				5475 Kellenburger Rd.
+				Dayton  OH  45424
+				US
+
+60-12-83   (hex)		TSB REAL TIME LOCATION SYSTEMS S.L.
+601283     (base 16)		TSB REAL TIME LOCATION SYSTEMS S.L.
+				Ronda Auguste y Louis Lumière 23, Nave 13
+				Parque Tecnológico de Valencia   Paterna (Valencia)  46980
+				ES
+
+98-DC-D9   (hex)		UNITEC Co., Ltd.
+98DCD9     (base 16)		UNITEC Co., Ltd.
+				1-2-1-Shinyokohama
+				Yokohama-shi  Kanagawa  222-0033
+				JP
+
+C0-CF-A3   (hex)		Creative Electronics & Software, Inc.
+C0CFA3     (base 16)		Creative Electronics & Software, Inc.
+				650 Sundown Road
+				South Elgin  IL  60177
+				US
+
+94-23-6E   (hex)		Shenzhen Junlan Electronic Ltd
+94236E     (base 16)		Shenzhen Junlan Electronic Ltd
+				Block C,No.2 Industrial District, Fuyuan, Tangwei,Fuyong, Bao'an
+				Shenzhen  Guangdong  518103
+				CN
+
+10-E6-AE   (hex)		Source Technologies, LLC
+10E6AE     (base 16)		Source Technologies, LLC
+				2910 Whitehall Park Drive
+				Charlotte  NC  28273
+				US
+
+FC-E1-92   (hex)		Sichuan Jinwangtong Electronic Science&Technology Co,.Ltd
+FCE192     (base 16)		Sichuan Jinwangtong Electronic Science&Technology Co,.Ltd
+				No.28,Xinchuang Rd.,West Gaoxin District
+				Chengdu  Sichuan  611731
+				CN
+
+40-8A-9A   (hex)		TITENG CO., Ltd.
+408A9A     (base 16)		TITENG CO., Ltd.
+				7Fl. Shindo B/D 10 Garak-dong
+				Seoul    138-160
+				KR
+
+F4-45-ED   (hex)		Portable Innovation Technology Ltd.
+F445ED     (base 16)		Portable Innovation Technology Ltd.
+				601-602, 6/F Park Building,
+				Kowloon    
+				HK
+
+5C-E2-86   (hex)		Nortel Networks
+5CE286     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+8C-64-0B   (hex)		Beyond Devices d.o.o.
+8C640B     (base 16)		Beyond Devices d.o.o.
+				Trzaska cesta 515
+				Brezovica pri Ljubljani    SI-1351
+				SI
+
+94-9C-55   (hex)		Alta Data Technologies
+949C55     (base 16)		Alta Data Technologies
+				4901 Rockaway Blvd, Building A
+				Rio Rancho  NM  87124
+				US
+
+D4-79-C3   (hex)		Cameronet GmbH & Co. KG
+D479C3     (base 16)		Cameronet GmbH & Co. KG
+				Elberfelder Strasse 96
+				Remscheid  NRW  42853
+				DE
+
+70-D5-E7   (hex)		Wellcore Corporation
+70D5E7     (base 16)		Wellcore Corporation
+				2870 Zanker Road
+				San Jose  CA  95134
+				US
+
+3C-F7-2A   (hex)		Nokia Corporation
+3CF72A     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+54-5F-A9   (hex)		Teracom Limited
+545FA9     (base 16)		Teracom Limited
+				B-84, Sector - 60,
+				Noida  Uttar Pradesh  201 301
+				IN
+
+6C-32-DE   (hex)		Indieon Technologies Pvt. Ltd.
+6C32DE     (base 16)		Indieon Technologies Pvt. Ltd.
+				601, Alpha 2, Gigaspace IT Park
+				Pune   Maharastra  411014
+				IN
+
+14-A6-2C   (hex)		S.M. Dezac S.A.
+14A62C     (base 16)		S.M. Dezac S.A.
+				Vial Sant jordi S/N
+				Viladecavalls  Barcelona  08232
+				ES
+
+54-7F-EE   (hex)		Cisco Systems, Inc
+547FEE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+AC-EA-6A   (hex)		GENIX INFOCOMM CO., LTD.
+ACEA6A     (base 16)		GENIX INFOCOMM CO., LTD.
+				2F, Daebo Bldg. #1009-34
+				Seoul    153-829
+				KR
+
+E0-BC-43   (hex)		C2 Microsystems, Inc.
+E0BC43     (base 16)		C2 Microsystems, Inc.
+				2833 Junction Avenue
+				San Jose  California  95134
+				US
+
+2C-A8-35   (hex)		RIM
+2CA835     (base 16)		RIM
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+C4-1E-CE   (hex)		HMI Sources Ltd.
+C41ECE     (base 16)		HMI Sources Ltd.
+				5 Floor, Suite 2, 233 Hsin Yi Road, Section 4
+				Taipei    10681
+				TW
+
+A8-F4-70   (hex)		Fujian Newland Communication Science Technologies Co.,Ltd.
+A8F470     (base 16)		Fujian Newland Communication Science Technologies Co.,Ltd.
+				Newland Science & Technology Park No.1 Rujiang West Rd., Mawei, 
+				Fuzhou  Fujian  350015
+				CN
+
+8C-73-6E   (hex)		FUJITSU LIMITED
+8C736E     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+B8-64-91   (hex)		CK Telecom Ltd
+B86491     (base 16)		CK Telecom Ltd
+				Keji Avenue,Heyuan Hi-tech Development Zone
+				Heyuan   Guangdong Province  517000
+				CN
+
+50-F0-03   (hex)		Open Stack, Inc.
+50F003     (base 16)		Open Stack, Inc.
+				Advanced Research Center #411
+				Bun-Dang, Seong-Nam  Gyung-Gi  463-816
+				KR
+
+DC-49-C9   (hex)		CASCO SIGNAL LTD
+DC49C9     (base 16)		CASCO SIGNAL LTD
+				No.489 Xizang Bei Road
+				Shanghai    200071
+				CN
+
+70-D8-80   (hex)		Upos System sp. z o.o.
+70D880     (base 16)		Upos System sp. z o.o.
+				Sienkiewicza 13
+				Knurow  Slaskie  44-190
+				PL
+
+A0-5D-C1   (hex)		TMCT Co., LTD.
+A05DC1     (base 16)		TMCT Co., LTD.
+				5F-561, #19-11 SanChong Rd.
+				Taipei    115
+				TW
+
+58-3C-C6   (hex)		Omneality Ltd.
+583CC6     (base 16)		Omneality Ltd.
+				10B Glossop Road
+				South Croydon  Surrey  CR2 0PU
+				GB
+
+B0-C8-AD   (hex)		People Power Company
+B0C8AD     (base 16)		People Power Company
+				620 Lowell Ave
+				Palo Alto  CA  94301
+				US
+
+18-17-14   (hex)		DAEWOOIS
+181714     (base 16)		DAEWOOIS
+				7F Namkwang Centlex Bldg. 440-4 Cheongcheon2-dong 
+				Incheon  Pupyeong-gu  82
+				KR
+
+F0-EC-39   (hex)		Essec
+F0EC39     (base 16)		Essec
+				Schoebroekstraat 48
+				Paal  Limburg  3583
+				BE
+
+44-6C-24   (hex)		Reallin Electronic Co.,Ltd
+446C24     (base 16)		Reallin Electronic Co.,Ltd
+				2/F, Building 3, No.202 Zhengzhong Rd, XiHu industry Park
+				Hang Zhou  Zhe Jiang  310030
+				CN
+
+20-46-F9   (hex)		Advanced Network Devices (dba:AND)
+2046F9     (base 16)		Advanced Network Devices (dba:AND)
+				3820 Ventura Drive
+				Arlington Heights  IL  60004
+				US
+
+48-71-19   (hex)		SGB GROUP LTD.
+487119     (base 16)		SGB GROUP LTD.
+				13F,No.192,Sec.2,Chung Hsin Rd.,Hsin Tien City
+				Taipei     231
+				TW
+
+04-FE-7F   (hex)		Cisco Systems, Inc
+04FE7F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-B1-EE   (hex)		H. ZANDER GmbH & Co. KG
+A4B1EE     (base 16)		H. ZANDER GmbH & Co. KG
+				Am Gut Wolf 15
+				Aachen    52070
+				DE
+
+84-21-41   (hex)		Shenzhen Ginwave Technologies Ltd.
+842141     (base 16)		Shenzhen Ginwave Technologies Ltd.
+				4/F,R2-A,High-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+A0-23-1B   (hex)		TeleComp R&D Corp.
+A0231B     (base 16)		TeleComp R&D Corp.
+				102 SW Orange Blossom
+				Lake City  Florida  32025
+				US
+
+B8-A3-E0   (hex)		BenRui Technology Co.,Ltd
+B8A3E0     (base 16)		BenRui Technology Co.,Ltd
+				No.3A room A Unit Hongsong Building 
+				ShenZhen  GuangDong  518000
+				CN
+
+3C-F5-2C   (hex)		DSPECIALISTS GmbH
+3CF52C     (base 16)		DSPECIALISTS GmbH
+				Helmholtzstr. 2-9 L
+				Berlin    10587
+				DE
+
+EC-44-76   (hex)		Cisco Systems, Inc
+EC4476     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-18-11   (hex)		Decatur Electronics
+6C1811     (base 16)		Decatur Electronics
+				715 Bright Street
+				Decatur  IL  62522
+				US
+
+F8-E9-68   (hex)		Egker Kft.
+F8E968     (base 16)		Egker Kft.
+				Szuglo u. 49.
+				Budapest    1145
+				HU
+
+A8-99-5C   (hex)		aizo ag
+A8995C     (base 16)		aizo ag
+				Brandstrasse 33
+				Schlieren    8952
+				CH
+
+40-12-E4   (hex)		Compass-EOS
+4012E4     (base 16)		Compass-EOS
+				7 Giborei Israel
+				Natanya    42504
+				IL
+
+54-03-F5   (hex)		EBN Technology Corp.
+5403F5     (base 16)		EBN Technology Corp.
+				10F, No.90, Sec. 1, Sintai 5th Rd.
+				Sijhih City  Taipei County  22102
+				US
+
+04-C0-5B   (hex)		Tigo Energy
+04C05B     (base 16)		Tigo Energy
+				170 Knowles Dr
+				Los Gatos  CA  95032
+				US
+
+80-38-FD   (hex)		LeapFrog Enterprises, Inc.
+8038FD     (base 16)		LeapFrog Enterprises, Inc.
+				6401 Holis Street
+				Emeryville  CA  94608
+				US
+
+AC-BE-B6   (hex)		Visualedge Technology Co., Ltd.
+ACBEB6     (base 16)		Visualedge Technology Co., Ltd.
+				13FL.-1 No. 716, Zhongzheng Road, Zhonghe City,
+				Taipei County,     23511
+				TW
+
+2C-91-27   (hex)		Eintechno Corporation
+2C9127     (base 16)		Eintechno Corporation
+				3359-1, kako, Inami-cho
+				kako-gun  hyogo  675-1105
+				JP
+
+AC-58-3B   (hex)		Human Assembler, Inc.
+AC583B     (base 16)		Human Assembler, Inc.
+				2-1-11-6F
+				Shibuya-ku  Tokyo  150-0002
+				JP
+
+E8-E7-76   (hex)		Shenzhen Kootion Technology Co., Ltd
+E8E776     (base 16)		Shenzhen Kootion Technology Co., Ltd
+				3/F, Building #4, XinJianXing Industrial Park
+				Shenzhen  Guangdong Province  518108
+				CN
+
+68-1F-D8   (hex)		Siemens Industry, Inc.
+681FD8     (base 16)		Siemens Industry, Inc.
+				10670 Treena Street
+				San Diego  CA  92131
+				US
+
+40-01-C6   (hex)		3COM EUROPE LTD
+4001C6     (base 16)		3COM EUROPE LTD
+				Peoplebuilding 2
+				Hemel Hempstead  HERTS.  HP2 4NW
+				GB
+
+9C-5E-73   (hex)		Calibre UK LTD
+9C5E73     (base 16)		Calibre UK LTD
+				Cornwall House
+				Bradford  West Yorkshire  BD8 7JS
+				GB
+
+5C-14-37   (hex)		Thyssenkrupp Aufzugswerke GmbH
+5C1437     (base 16)		Thyssenkrupp Aufzugswerke GmbH
+				Bernhaeuser Str.45
+				Neuhausen a.d.F    73765
+				DE
+
+9C-55-B4   (hex)		I.S.E. S.r.l.
+9C55B4     (base 16)		I.S.E. S.r.l.
+				Via della Canapiglia 5
+				Migliarino Pisano  PISA  56010
+				IT
+
+4C-63-EB   (hex)		Application Solutions (Electronics and Vision) Ltd
+4C63EB     (base 16)		Application Solutions (Electronics and Vision) Ltd
+				The Riverside Centre
+				Lewes  East Sussex  BN7 2AQ
+				GB
+
+70-2F-97   (hex)		Aava Mobile Oy
+702F97     (base 16)		Aava Mobile Oy
+				Nahkatehtaankatu 2
+				Oulu    90100
+				FI
+
+10-CA-81   (hex)		PRECIA
+10CA81     (base 16)		PRECIA
+				Le ruissol VEYRAS
+				PRIVAS    07001
+				FR
+
+40-A6-A4   (hex)		PassivSystems Ltd
+40A6A4     (base 16)		PassivSystems Ltd
+				Medway House
+				Newbury  Berks  RG14 2PZ
+				GB
+
+94-BA-31   (hex)		Visiontec da Amazônia Ltda.
+94BA31     (base 16)		Visiontec da Amazônia Ltda.
+				Rod. Geraldo Scavone, 2300 - Galpao 27
+				Jacareí  SP  12305-490
+				BR
+
+B8-94-D2   (hex)		Retail Innovation HTT AB
+B894D2     (base 16)		Retail Innovation HTT AB
+				Sjöängsvägen 2
+				Sollentuna    S-192 72
+				SE
+
+B0-E9-7E   (hex)		Advanced Micro Peripherals
+B0E97E     (base 16)		Advanced Micro Peripherals
+				Unit 1 Harrier House
+				Witchford  Cambridgeshire  CB6 2HY
+				GB
+
+F0-C2-4C   (hex)		Zhejiang FeiYue Digital Technology Co., Ltd
+F0C24C     (base 16)		Zhejiang FeiYue Digital Technology Co., Ltd
+				Baoting Industrial Park, 531 Jiaogong Road
+				 Hangzhou City  Zhejiang Province  310012
+				CN
+
+E4-75-1E   (hex)		Getinge Sterilization AB
+E4751E     (base 16)		Getinge Sterilization AB
+				Box 69
+				Getinge    31044
+				SE
+
+9C-5B-96   (hex)		NMR Corporation
+9C5B96     (base 16)		NMR Corporation
+				3F Esprit Build.,1-3-6 Nishi-Nippori
+				Arakawa-Ku  Tokyo  116-0013
+				JP
+
+60-F1-3D   (hex)		JABLOCOM s.r.o.
+60F13D     (base 16)		JABLOCOM s.r.o.
+				V Nivach 12
+				Jablonec nad Nisou    466 01
+				CZ
+
+50-25-2B   (hex)		Nethra Imaging Incorporated
+50252B     (base 16)		Nethra Imaging Incorporated
+				2855 Bowers Ave
+				Santa Clara  CA  95051
+				US
+
+F8-81-1A   (hex)		OVERKIZ
+F8811A     (base 16)		OVERKIZ
+				EUROPA 3
+				Archamps    74160
+				FR
+
+38-63-F6   (hex)		3NOD MULTIMEDIA(SHENZHEN)CO.,LTD
+3863F6     (base 16)		3NOD MULTIMEDIA(SHENZHEN)CO.,LTD
+				F6,Building11,Shenzhen Software Park
+				Shenzhen  Guangdong  518057
+				CN
+
+78-B8-1A   (hex)		INTER SALES A/S
+78B81A     (base 16)		INTER SALES A/S
+				Stavneagervej 22
+				Egaa    8250
+				DK
+
+CC-00-80   (hex)		BETTINI SRL
+CC0080     (base 16)		BETTINI SRL
+				VIA CESARE BATTISTI 22
+				CESANO MADERNO  MILAN  20031
+				IT
+
+64-4B-C3   (hex)		Shanghai WOASiS Telecommunications Ltd., Co.
+644BC3     (base 16)		Shanghai WOASiS Telecommunications Ltd., Co.
+				15F, Software Building,
+				Shanghai    200233
+				CN
+
+94-2E-63   (hex)		Finsécur
+942E63     (base 16)		Finsécur
+				52 rue Paul Lescop
+				Nanterre    92000
+				FR
+
+AC-83-17   (hex)		Shenzhen Furtunetel Communication Co., Ltd
+AC8317     (base 16)		Shenzhen Furtunetel Communication Co., Ltd
+				F19 building A zhongke plaza Nan yi street high-tech zone, Nanshan District, 
+				Shenzhen  Guangdong  518057
+				CN
+
+AC-D1-80   (hex)		Crexendo Business Solutions, Inc.
+ACD180     (base 16)		Crexendo Business Solutions, Inc.
+				10201 S. 5st  St.
+				Phoenix  AZ  85044
+				US
+
+CC-CC-4E   (hex)		Sun Fountainhead USA. Corp 
+CCCC4E     (base 16)		Sun Fountainhead USA. Corp 
+				801 S. Garfiled AVE # 236 
+				Los Angeles   California   91801
+				US
+
+68-85-40   (hex)		IGI Mobile, Inc.
+688540     (base 16)		IGI Mobile, Inc.
+				4F Kyongnam Bldg.,
+				Seoul    135-080
+				KR
+
+A0-9A-5A   (hex)		Time Domain
+A09A5A     (base 16)		Time Domain
+				330 Wynn Drive
+				Huntsville  AL  35805
+				US
+
+64-A8-37   (hex)		Juni Korea Co., Ltd
+64A837     (base 16)		Juni Korea Co., Ltd
+				E603 Bundang Techno-Park 151
+				Seongnam  Gyeonggi  463-760
+				KR
+
+20-2C-B7   (hex)		Kong Yue Electronics & Information Industry (Xinhui) Ltd.
+202CB7     (base 16)		Kong Yue Electronics & Information Industry (Xinhui) Ltd.
+				Kong Yue Industrial Park, 18 Kongyue Road, Jinguzhou
+				Jiangmen  Guangdong  529141
+				CN
+
+60-9F-9D   (hex)		CloudSwitch
+609F9D     (base 16)		CloudSwitch
+				200 Wheeler Rd
+				Burlington  MA  01803
+				US
+
+48-34-3D   (hex)		IEP GmbH
+48343D     (base 16)		IEP GmbH
+				Am Pferdemarkt 9c
+				Langenhagen  Niedersachsen  30853
+				DE
+
+D4-AA-FF   (hex)		MICRO WORLD 
+D4AAFF     (base 16)		MICRO WORLD 
+				19370 VAN NESS AVE 
+				TORRANCE   CA  90501
+				US
+
+74-E5-37   (hex)		RADSPIN
+74E537     (base 16)		RADSPIN
+				Songpa-gu Garak-dong 78
+				Seoul    138-950
+				KR
+
+00-26-E9   (hex)		SP Corp
+0026E9     (base 16)		SP Corp
+				Guro 3-dong ,Guro-gu
+				Seoul    152-780
+				KR
+
+00-26-EB   (hex)		Advanced Spectrum Technology Co., Ltd.
+0026EB     (base 16)		Advanced Spectrum Technology Co., Ltd.
+				1F., No.67 Jhongjheng Rd.
+				Sinjhuang  Taiwan  242
+				TW
+
+00-26-E1   (hex)		Stanford University, OpenFlow Group
+0026E1     (base 16)		Stanford University, OpenFlow Group
+				353 Serra Mall
+				Stanford  CA  94305-9030
+				US
+
+00-27-17   (hex)		CE Digital(Zhenjiang)Co.,Ltd
+002717     (base 16)		CE Digital(Zhenjiang)Co.,Ltd
+				Wei 3 Road, Dingmao, Eco.Dev.Zone,
+				Zhenjiang    212009
+				CN
+
+00-27-16   (hex)		Adachi-Syokai Co., Ltd.
+002716     (base 16)		Adachi-Syokai Co., Ltd.
+				228-2 Hazama Maki
+				Fukuchiyama-shi  Kyoto  620-0913
+				JP
+
+00-26-DC   (hex)		Optical Systems Design
+0026DC     (base 16)		Optical Systems Design
+				7/1 Vuko Place
+				Warriewood  NSW  2102
+				AU
+
+00-27-00   (hex)		Shenzhen Siglent Technology Co., Ltd.
+002700     (base 16)		Shenzhen Siglent Technology Co., Ltd.
+				BUILDING A8,TANGLANG INDUSTRIAL ZONE,XILI,NANSHAN
+				Shenzhen  Guangdong  518000
+				CN
+
+00-26-EC   (hex)		Legrand Home Systems, Inc
+0026EC     (base 16)		Legrand Home Systems, Inc
+				301 Fulling Mill Rd
+				Middletown  PA  17057
+				US
+
+00-26-D4   (hex)		IRCA SpA
+0026D4     (base 16)		IRCA SpA
+				Viale Venezia 31 - C.P. 248
+				San Vendemiano (Treviso)  Italy  31020
+				IT
+
+00-26-63   (hex)		Shenzhen Huitaiwei Tech. Ltd, co.
+002663     (base 16)		Shenzhen Huitaiwei Tech. Ltd, co.
+				JianDa Building,501-502
+				Shenzhen  Guangdong  518000
+				CN
+
+00-26-61   (hex)		Irumtek Co., Ltd.
+002661     (base 16)		Irumtek Co., Ltd.
+				Apt 708  513-22 Joongil Eines Platz
+				Seongnam-City  Gyunggi-do  462-120
+				KR
+
+00-26-5B   (hex)		Hitron Technologies. Inc
+00265B     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+00-26-56   (hex)		Sansonic Electronics USA
+002656     (base 16)		Sansonic Electronics USA
+				9950 Baldwin Place
+				El Monte  Cailfornia  91731
+				US
+
+00-26-7D   (hex)		A-Max Technology Macao Commercial Offshore Company Limited
+00267D     (base 16)		A-Max Technology Macao Commercial Offshore Company Limited
+				Avenida Da Praia Grande No. 409
+				Macau    
+				CN
+
+00-26-7C   (hex)		Metz-Werke GmbH & Co KG
+00267C     (base 16)		Metz-Werke GmbH & Co KG
+				Ohmstrasse 55
+				Zirndorf    90513
+				DE
+
+00-26-73   (hex)		RICOH COMPANY,LTD.
+002673     (base 16)		RICOH COMPANY,LTD.
+				810 Shimoimaizumi
+				Ebina-City  Kanagawa-Pref  243-0460
+				JP
+
+00-26-6D   (hex)		MobileAccess Networks
+00266D     (base 16)		MobileAccess Networks
+				8391 Old Courthouse Rd.
+				Vienna  VA  22182
+				US
+
+00-26-C0   (hex)		EnergyHub
+0026C0     (base 16)		EnergyHub
+				232 3rd St C201
+				Brooklyn  NY  11215
+				US
+
+00-26-C1   (hex)		ARTRAY CO., LTD.
+0026C1     (base 16)		ARTRAY CO., LTD.
+				5F Ueno Bldg, 1-17-5 Kouenjikita,
+				Tokyo    166-0002
+				JP
+
+00-26-BE   (hex)		Schoonderbeek Elektronica Systemen B.V.
+0026BE     (base 16)		Schoonderbeek Elektronica Systemen B.V.
+				Roggestraat 3-5
+				Nieuw Vennep  Noord Holland  2153GC
+				NL
+
+00-26-B5   (hex)		ICOMM Tele Ltd
+0026B5     (base 16)		ICOMM Tele Ltd
+				304, Trendset Towers,
+				Hyderabad  AP  500034
+				IN
+
+00-26-8C   (hex)		StarLeaf Ltd.
+00268C     (base 16)		StarLeaf Ltd.
+				Chaston House, Mill Court
+				Cambridge    CB22 5LD
+				GB
+
+00-26-8B   (hex)		Guangzhou Escene Computer Technology Limited
+00268B     (base 16)		Guangzhou Escene Computer Technology Limited
+				Room 209, No.54-56 Yuehe Building, Huacui Street, Tianhe Industrial Park
+				Guangzhou  Guangdong Province  510065
+				CN
+
+00-26-6F   (hex)		Coordiwise Technology Corp.
+00266F     (base 16)		Coordiwise Technology Corp.
+				2F., No.123, Sec. 1, Lioujia 5th Rd.
+				Jhubei City, Hsinchu County    30272
+				TW
+
+00-26-6E   (hex)		Nissho-denki Co.,LTD.
+00266E     (base 16)		Nissho-denki Co.,LTD.
+				3-7-6,chidori
+				ohta  Tokyo  146-0083
+				JP
+
+00-26-C3   (hex)		Insightek Corp.
+0026C3     (base 16)		Insightek Corp.
+				5F,NO.755,Chung Cheng Rd.,
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-26-81   (hex)		Interspiro AB
+002681     (base 16)		Interspiro AB
+				Box 2853
+				Täby    18728
+				SE
+
+00-26-83   (hex)		Ajoho Enterprise Co., Ltd.
+002683     (base 16)		Ajoho Enterprise Co., Ltd.
+				7F., No.101, Ruihu St.
+				Taipei    114
+				TW
+
+00-26-7F   (hex)		Zenterio AB
+00267F     (base 16)		Zenterio AB
+				Diskettgatan 11B
+				Linköping    58335
+				SE
+
+00-26-98   (hex)		Cisco Systems, Inc
+002698     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-9B   (hex)		SOKRAT Ltd.
+00269B     (base 16)		SOKRAT Ltd.
+				Volkonskogo 2
+				Irkutsk    664007
+				RU
+
+00-26-A1   (hex)		Megger
+0026A1     (base 16)		Megger
+				4271 Bronze Way
+				Dallas  Texas  75237
+				US
+
+00-26-44   (hex)		Thomson Telecom Belgium
+002644     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-26-46   (hex)		SHENYANG TONGFANG MULTIMEDIA TECHNOLOGY COMPANY LIMITED
+002646     (base 16)		SHENYANG TONGFANG MULTIMEDIA TECHNOLOGY COMPANY LIMITED
+				No.10 Ping Nan East Road
+				Shenyang  Liao Ning  110014
+				CN
+
+00-26-3F   (hex)		LIOS Technology GmbH
+00263F     (base 16)		LIOS Technology GmbH
+				Schanzenstraße 39
+				Köln  Germany  D-51063
+				DE
+
+00-26-3B   (hex)		Onbnetech
+00263B     (base 16)		Onbnetech
+				506, Samsung IT Valley, 197-5
+				Guro-Gu  Seoul  152-848
+				KR
+
+00-26-58   (hex)		T-Platforms (Cyprus) Limited
+002658     (base 16)		T-Platforms (Cyprus) Limited
+				Themistokli Dervi 3, Julia House
+				Nicosia    P.C.-1066
+				CY
+
+00-26-4C   (hex)		Shanghai DigiVision Technology Co., Ltd.
+00264C     (base 16)		Shanghai DigiVision Technology Co., Ltd.
+				No. 333 Guangji Rd.
+				Shanghai    200083
+				CN
+
+00-26-2F   (hex)		HAMAMATSU TOA ELECTRONICS
+00262F     (base 16)		HAMAMATSU TOA ELECTRONICS
+				9162-1
+				HAMAMATSU  SIZUOKA  431-2102
+				JP
+
+00-26-31   (hex)		COMMTACT LTD
+002631     (base 16)		COMMTACT LTD
+				Nahal Snir 10
+				Yazne    81101
+				IL
+
+00-25-FB   (hex)		Tunstall Healthcare A/S
+0025FB     (base 16)		Tunstall Healthcare A/S
+				Stroemmen 6
+				Noerresundby    9400
+				DK
+
+00-25-F4   (hex)		KoCo Connector AG
+0025F4     (base 16)		KoCo Connector AG
+				Marienstraße 12
+				Berlin    10117
+				DE
+
+00-26-06   (hex)		RAUMFELD GmbH
+002606     (base 16)		RAUMFELD GmbH
+				Reichenberger Str. 124
+				Berlin    10999
+				DE
+
+00-26-07   (hex)		Enabling Technology Pty Ltd
+002607     (base 16)		Enabling Technology Pty Ltd
+				23/44 Kings Park Road
+				West Perth  Western Australia  6005
+				AU
+
+00-26-24   (hex)		Thomson Inc.
+002624     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290
+				US
+
+00-26-05   (hex)		CC Systems AB
+002605     (base 16)		CC Systems AB
+				Box 83
+				Alfta    822 22
+				SE
+
+00-26-02   (hex)		SMART Temps LLC
+002602     (base 16)		SMART Temps LLC
+				435 PARK PL CIRCLE SUITE 100
+				Mishawaka  IN  46545
+				US
+
+00-26-1A   (hex)		Femtocomm System Technology Corp.
+00261A     (base 16)		Femtocomm System Technology Corp.
+				2F.-2,No.28, Taiyuan St.,
+				Jhubei City,  Hsinchu Country,  30288
+				TW
+
+00-26-34   (hex)		Infineta Systems, Inc
+002634     (base 16)		Infineta Systems, Inc
+				2870 Zanker Rd
+				San Jose  CA  95134
+				US
+
+00-25-99   (hex)		Hedon e.d. B.V.
+002599     (base 16)		Hedon e.d. B.V.
+				Elektronicaweg 15
+				Delft  Zuid Holland  2628 XG
+				NL
+
+00-25-97   (hex)		Kalki Communication Technologies
+002597     (base 16)		Kalki Communication Technologies
+				4th Floor, Survey. No. 17/1, Outer Ring Road
+				Opp. Prestige Cessna Park  Bangalore   560 103
+				IN
+
+00-25-92   (hex)		Guangzhou Shirui Electronic Co., Ltd
+002592     (base 16)		Guangzhou Shirui Electronic Co., Ltd
+				301D, No.9, Caipin Road,
+				Guangzhou  Guangdong  510663
+				CN
+
+00-25-94   (hex)		Eurodesign BG LTD
+002594     (base 16)		Eurodesign BG LTD
+				Business Park Sofia, Building 4, Floor 2
+				Sofia    1113
+				BG
+
+00-25-9F   (hex)		TechnoDigital Technologies GmbH
+00259F     (base 16)		TechnoDigital Technologies GmbH
+				Haesslerstraße 8
+				Erfurt  Thuringia  99096
+				DE
+
+00-25-9D   (hex)		Private
+00259D     (base 16)		Private
+
+00-25-98   (hex)		Zhong Shan City Litai Electronic Industrial Co. Ltd
+002598     (base 16)		Zhong Shan City Litai Electronic Industrial Co. Ltd
+				No.3 Industrial District, Wuguishan, Cheng gui Road
+				Zhong shan City  Guang dong Province  528458
+				CN
+
+00-25-E3   (hex)		Hanshinit Inc.
+0025E3     (base 16)		Hanshinit Inc.
+				Dong-Won Bld 3F, 395-13, Gal-Ma 2, Seo-Gu
+				Daejeon    302-809
+				KR
+
+00-25-D4   (hex)		General Dynamics Mission Systems
+0025D4     (base 16)		General Dynamics Mission Systems
+				150 Rustcraft Road
+				Dedham  MA  02026
+				US
+
+00-25-C2   (hex)		RingBell Co.,Ltd.
+0025C2     (base 16)		RingBell Co.,Ltd.
+				10586 KingGeorge Hwy
+				Surrey  B.C  V3T 2X3
+				CA
+
+00-25-A7   (hex)		itron
+0025A7     (base 16)		itron
+				5390 Triangle Parkway
+				Norcross  GA  30092
+				US
+
+00-25-A9   (hex)		Shanghai Embedway Information Technologies Co.,Ltd
+0025A9     (base 16)		Shanghai Embedway Information Technologies Co.,Ltd
+				2F,Building 9,Lujiazui Software Park, No.20,Lane 91,E'Shan Road
+				Shanghai    200127
+				CN
+
+00-25-CA   (hex)		LS Research, LLC
+0025CA     (base 16)		LS Research, LLC
+				W66 N220 Commerce Court
+				Cedarburg  WI  53012
+				US
+
+00-25-B4   (hex)		Cisco Systems, Inc
+0025B4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-B2   (hex)		MBDA Deutschland GmbH
+0025B2     (base 16)		MBDA Deutschland GmbH
+				Hagenauer Forst 27
+				Schrobenhausen  Bavaria  86529
+				DE
+
+00-25-EF   (hex)		I-TEC Co., Ltd.
+0025EF     (base 16)		I-TEC Co., Ltd.
+				7/F,KAWARAMACHI KOYO BLDG.3-4-3,KAWARAMCHI,CHUO-KU,
+				OSAKA    541-0048
+				JP
+
+00-25-28   (hex)		Daido Signal Co., Ltd.
+002528     (base 16)		Daido Signal Co., Ltd.
+				6-17-19
+				Minato-ku  TOKYO  105-8650
+				JP
+
+00-25-26   (hex)		Genuine Technologies Co., Ltd.
+002526     (base 16)		Genuine Technologies Co., Ltd.
+				Klingelnberg Bldg.
+				Yokohama  Kanagawa  222-0033
+				JP
+
+00-25-6B   (hex)		ATENIX E.E. s.r.l.
+00256B     (base 16)		ATENIX E.E. s.r.l.
+				Via Torricelli, 15/b
+				VERONA  VR  37135
+				IT
+
+00-25-6E   (hex)		Van Breda B.V.
+00256E     (base 16)		Van Breda B.V.
+				Mercuriusweg 21
+				Brummen  Gelderland  6971 GV
+				NL
+
+00-25-65   (hex)		Vizimax Inc.
+002565     (base 16)		Vizimax Inc.
+				2284, rue de la Province
+				Longueuil  Québec  J4G 1G1
+				CA
+
+00-25-5E   (hex)		Shanghai Dare Technologies Co.,Ltd.
+00255E     (base 16)		Shanghai Dare Technologies Co.,Ltd.
+				22F,Info Tech Building, No.1555,Kongjiang Road,
+				  Shanghai  200092
+				CN
+
+00-25-3B   (hex)		din Dietmar Nocker Facilitymanagement GmbH
+00253B     (base 16)		din Dietmar Nocker Facilitymanagement GmbH
+				Kotzinastrasse 5
+				Linz  Upper Austria  4030
+				AT
+
+00-25-3D   (hex)		DRS Consolidated Controls
+00253D     (base 16)		DRS Consolidated Controls
+				21 South Street
+				Danbury  CT  06810-8147
+				US
+
+00-25-35   (hex)		Minimax GmbH & Co KG
+002535     (base 16)		Minimax GmbH & Co KG
+				Industriestrasse 10/12
+				Bad Oldesloe  SH  23840
+				DE
+
+00-25-84   (hex)		Cisco Systems, Inc
+002584     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-79   (hex)		J & F Labs
+002579     (base 16)		J & F Labs
+				1214 W. Boston Post Road
+				Mamaroneck  NY  10543
+				US
+
+00-25-7F   (hex)		CallTechSolution Co.,Ltd
+00257F     (base 16)		CallTechSolution Co.,Ltd
+				#123,Daewooprugio B/D,344-1, Seogyo-Dong,Mapo-gu
+				Seoul    121-837
+				KR
+
+00-25-77   (hex)		D-BOX Technologies
+002577     (base 16)		D-BOX Technologies
+				2172 de la Province
+				Longueuil  Quebec  J4G 1R7
+				CA
+
+00-25-72   (hex)		Nemo-Q International AB
+002572     (base 16)		Nemo-Q International AB
+				Box 210
+				Sollentuna    19123
+				SE
+
+00-25-29   (hex)		COMELIT GROUP S.P.A
+002529     (base 16)		COMELIT GROUP S.P.A
+				DON ARRIGONI N. 5
+				SAN LORENZO, ROVETTA  BERGAMO  24020
+				IT
+
+00-25-2A   (hex)		Chengdu GeeYa Technology Co.,LTD
+00252A     (base 16)		Chengdu GeeYa Technology Co.,LTD
+				50 Shuxi Road,
+				Chengdu  SiChuan  610091
+				CN
+
+00-25-8A   (hex)		Pole/Zero Corporation
+00258A     (base 16)		Pole/Zero Corporation
+				5530 Union Centre Drive
+				West Chester  OH  45069
+				US
+
+00-25-5F   (hex)		SenTec AG
+00255F     (base 16)		SenTec AG
+				Ringstrasse 39
+				Therwil    4106
+				CH
+
+00-24-EC   (hex)		United Information Technology Co.,Ltd.
+0024EC     (base 16)		United Information Technology Co.,Ltd.
+				5/F,9th Building,Software Park,2nd Keji-zhong Road,High-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+00-24-E6   (hex)		In Motion Technology Inc.
+0024E6     (base 16)		In Motion Technology Inc.
+				#350, 625 Agnes Street
+				New Westminster  BC  V3M 5Y4
+				CA
+
+00-24-E7   (hex)		Plaster Networks
+0024E7     (base 16)		Plaster Networks
+				935 Hamilton Avenue
+				Menlo Park  CA  94025-1431
+				US
+
+00-24-E4   (hex)		Withings
+0024E4     (base 16)		Withings
+				37bis rue du General Leclerc
+				Issy les Moulineaux    92442
+				FR
+
+00-24-DE   (hex)		GLOBAL Technology Inc.
+0024DE     (base 16)		GLOBAL Technology Inc.
+				No.168,Shanshan Rd., Wangchun Industrial Park,
+				Ningbo    315176
+				CN
+
+00-24-DC   (hex)		Juniper Networks
+0024DC     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-24-DB   (hex)		Alcohol Monitoring Systems
+0024DB     (base 16)		Alcohol Monitoring Systems
+				1241 W. Mineral Avenue
+				Littleton  CO  80120
+				US
+
+00-25-21   (hex)		Logitek Electronic Systems, Inc.
+002521     (base 16)		Logitek Electronic Systems, Inc.
+				5622 Edgemoor Drive
+				Houston  Texas  77081
+				US
+
+00-25-1F   (hex)		ZYNUS VISION INC.
+00251F     (base 16)		ZYNUS VISION INC.
+				1-1-7-1A
+				SAGAMIHARA  KANAGAWA  229-0039
+				JP
+
+00-25-1E   (hex)		ROTEL TECHNOLOGIES
+00251E     (base 16)		ROTEL TECHNOLOGIES
+				CEVIZLIDERE 14.CD NO:2/19 BALGAT
+				ANKARA    06520
+				TR
+
+00-25-19   (hex)		Viaas Inc
+002519     (base 16)		Viaas Inc
+				3175 South Winchester Blvd
+				Campbell  CA  95008
+				US
+
+00-24-D5   (hex)		Winward Industrial Limited
+0024D5     (base 16)		Winward Industrial Limited
+				Rm.7, P Floor, Tower A,
+				HongKong    852
+				CN
+
+00-24-DD   (hex)		Centrak, Inc.
+0024DD     (base 16)		Centrak, Inc.
+				207 Penns Trail
+				Newtown  PA  18940
+				US
+
+00-24-EA   (hex)		iris-GmbH infrared & intelligent sensors
+0024EA     (base 16)		iris-GmbH infrared & intelligent sensors
+				Ostendstraße 1-14
+				Berlin    12459
+				DE
+
+00-24-ED   (hex)		YT Elec. Co,.Ltd.
+0024ED     (base 16)		YT Elec. Co,.Ltd.
+				Block B,2 Floor ,Bao Ying Industrial District,
+				Wu Lian Lu  Shenzhen  518116
+				CN
+
+00-25-03   (hex)		IBM Corp
+002503     (base 16)		IBM Corp
+				2051 Mission College Blvd 
+				Santa Clara  CA  95054
+				US
+
+00-25-04   (hex)		Valiant Communications Limited
+002504     (base 16)		Valiant Communications Limited
+				71-1 Shivaji Marg
+				New Delhi  Delhi  110015
+				IN
+
+00-25-13   (hex)		CXP DIGITAL BV
+002513     (base 16)		CXP DIGITAL BV
+				De Reulver 97A
+				Enschede    7544RT
+				NL
+
+00-24-A4   (hex)		Siklu Communication
+0024A4     (base 16)		Siklu Communication
+				7 Shoham St., , 3rd Floor
+				Petah Tikva    49517
+				IL
+
+00-24-9A   (hex)		Beijing Zhongchuang Telecommunication Test Co., Ltd.
+00249A     (base 16)		Beijing Zhongchuang Telecommunication Test Co., Ltd.
+				12-14,Block C,Beijing International Building,#18,Zhong Guan Cun Nan Road,
+				Beijing    100081
+				CN
+
+00-24-9E   (hex)		ADC-Elektronik GmbH
+00249E     (base 16)		ADC-Elektronik GmbH
+				Östingstraße 13b
+				Hamm  NRW  D-59063
+				DE
+
+00-24-9F   (hex)		RIM Testing Services
+00249F     (base 16)		RIM Testing Services
+				440 Phillip Street
+				Waterloo  Ontario  N2L 5R9
+				CA
+
+00-24-C2   (hex)		Asumo Co.,Ltd.
+0024C2     (base 16)		Asumo Co.,Ltd.
+				Oya-Kita 1-3-1
+				EBINA-CITY  KANAGAWA-PREF.  243-0419
+				JP
+
+00-24-BF   (hex)		CIAT
+0024BF     (base 16)		CIAT
+				30, Avenue Jean Falconnier
+				Culoz    01350
+				FR
+
+00-24-C0   (hex)		NTI COMODO INC
+0024C0     (base 16)		NTI COMODO INC
+				Rm#502, Kangyong Bldg, Sungnam-dong
+				Sungnam-si  Kyunggi-do  462-827
+				KR
+
+00-24-BB   (hex)		CENTRAL Corporation
+0024BB     (base 16)		CENTRAL Corporation
+				NISSO 17 Bldg.7F 2-14-30
+				Yokohama  Kanagawa  222-0033
+				JP
+
+00-24-BC   (hex)		HuRob Co.,Ltd
+0024BC     (base 16)		HuRob Co.,Ltd
+				2121, Jeongwang-Dong
+				Siheung-Si  Gyeonggi-Do  429-793
+				KR
+
+00-24-AD   (hex)		Adolf Thies Gmbh & Co. KG
+0024AD     (base 16)		Adolf Thies Gmbh & Co. KG
+				Hauptstraße 76
+				Göttingen    37083
+				DE
+
+00-24-A7   (hex)		Advanced Video Communications Inc.
+0024A7     (base 16)		Advanced Video Communications Inc.
+				633 W 5th Street
+				Los Angeles  CA  90017
+				US
+
+00-24-AB   (hex)		A7 Engineering, Inc.
+0024AB     (base 16)		A7 Engineering, Inc.
+				12127 Kirkham Road Suite 101
+				Poway  CA  92064
+				US
+
+00-24-66   (hex)		Unitron nv
+002466     (base 16)		Unitron nv
+				Franrkijklaan 27
+				Poperinge  W-vl  8970
+				BE
+
+00-24-5F   (hex)		Vine Telecom CO.,Ltd.
+00245F     (base 16)		Vine Telecom CO.,Ltd.
+				191-4, 4F, Anyang-dong, Manan-gu
+				Anyang-si  Gyeonggi-do  430-010
+				KR
+
+00-24-55   (hex)		MuLogic BV
+002455     (base 16)		MuLogic BV
+				Olivier van Noortstraat 4
+				Schiedam  ZH  3124LA
+				NL
+
+00-24-88   (hex)		Centre For Development Of Telematics
+002488     (base 16)		Centre For Development Of Telematics
+				B01, Electronic City, Phase 1
+				Bangalore  Karnataka  560100
+				IN
+
+00-24-8F   (hex)		DO-MONIX
+00248F     (base 16)		DO-MONIX
+				#501, Koreana B/D
+				Seongnam-si  Gyeonggi-do  82
+				KP
+
+00-24-79   (hex)		Optec Displays, Inc.
+002479     (base 16)		Optec Displays, Inc.
+				528 S. 6th Avenue
+				City of Industry  California  91746
+				US
+
+00-24-B7   (hex)		GridPoint, Inc.
+0024B7     (base 16)		GridPoint, Inc.
+				2801 Clarendon Blvd.
+				Arlington  VA  22201
+				US
+
+00-24-AE   (hex)		IDEMIA
+0024AE     (base 16)		IDEMIA
+				18 chaussee Jules Cesar
+				OSNY    95520
+				FR
+
+00-24-68   (hex)		Sumavision Technologies Co.,Ltd
+002468     (base 16)		Sumavision Technologies Co.,Ltd
+				6F, Block A2, Power Creative Building,No.1 Shangdi East Road, Haidian District
+				Beijing    100085
+				CN
+
+00-24-3A   (hex)		Ludl Electronic Products
+00243A     (base 16)		Ludl Electronic Products
+				171 Brady Ave
+				Hawthorne  NY  10532
+				US
+
+00-24-39   (hex)		Digital Barriers Advanced Technologies
+002439     (base 16)		Digital Barriers Advanced Technologies
+				4th Floor
+				Glasgow  Lanarkshire  G1 2QQ
+				GB
+
+00-24-34   (hex)		Lectrosonics, Inc.
+002434     (base 16)		Lectrosonics, Inc.
+				581 Laser Rd.
+				Rio Rancho  NM  87124
+				US
+
+00-24-5A   (hex)		Nanjing Panda Electronics Company Limited
+00245A     (base 16)		Nanjing Panda Electronics Company Limited
+				Zhongshan EastRoad 301,
+				NANJING  JIANGSU  210016
+				CN
+
+00-24-5B   (hex)		RAIDON TECHNOLOGY, INC.
+00245B     (base 16)		RAIDON TECHNOLOGY, INC.
+				4F-8, NO.16, Lane 609, Sec.5, Chung-Hsin Rd.,
+				San-Chung City  Taipei county,  24159
+				TW
+
+00-24-59   (hex)		ABB Automation products GmbH
+002459     (base 16)		ABB Automation products GmbH
+				Eppelheimer Strasse 82
+				Heidelberg    69123
+				DE
+
+00-24-4E   (hex)		RadChips, Inc.
+00244E     (base 16)		RadChips, Inc.
+				422 East Vermijo Ave.
+				Colorado Springs  CO  80903
+				US
+
+00-24-0D   (hex)		OnePath Networks LTD.
+00240D     (base 16)		OnePath Networks LTD.
+				8 Hartom St
+				Jerusalem    91450
+				IL
+
+00-24-0B   (hex)		Virtual Computer Inc.
+00240B     (base 16)		Virtual Computer Inc.
+				3 LAN Drive
+				Westford  MA  01886
+				US
+
+00-24-02   (hex)		Op-Tection GmbH
+002402     (base 16)		Op-Tection GmbH
+				Borsigstraße 80
+				Heinsberg  Germany  52525
+				DE
+
+00-24-2F   (hex)		Micron
+00242F     (base 16)		Micron
+				8000 S Federal Way
+				Boise  ID  83716
+				US
+
+00-24-26   (hex)		NOHMI BOSAI LTD.
+002426     (base 16)		NOHMI BOSAI LTD.
+				7-3,Kudan-Minami 4-Chome,
+				Tokyo    102-8277
+				JP
+
+00-24-18   (hex)		Nextwave Semiconductor
+002418     (base 16)		Nextwave Semiconductor
+				3610 Valley Centre Dr
+				San Diego  CA  92130
+				US
+
+00-24-12   (hex)		Benign Technologies Co, Ltd.
+002412     (base 16)		Benign Technologies Co, Ltd.
+				504 room, 5F, South building, Forsafe Tower,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-24-29   (hex)		MK MASTER INC.
+002429     (base 16)		MK MASTER INC.
+				6F, -1, NO. 110,SEC. 3, JHONGSHAN RD.,
+				JHONG-HE CITY,  TAIPEI COUNTY  235
+				TW
+
+00-23-DB   (hex)		saxnet gmbh
+0023DB     (base 16)		saxnet gmbh
+				Willy-Brandt-Ring 1
+				Oelsnitz  Sachsen  08606
+				DE
+
+00-23-C8   (hex)		TEAM-R
+0023C8     (base 16)		TEAM-R
+				Gragdanski str.111, A, 9-N
+				St. Petersburg    195265
+				RU
+
+00-23-EB   (hex)		Cisco Systems, Inc
+0023EB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-EC   (hex)		Algorithmix GmbH
+0023EC     (base 16)		Algorithmix GmbH
+				Klettgaustrasse 21
+				Waldshut-Tiengen  BW  79761
+				US
+
+00-23-C1   (hex)		Securitas Direct AB
+0023C1     (base 16)		Securitas Direct AB
+				Angbatsbron 1
+				Malmö    21120
+				SE
+
+00-23-AA   (hex)		HFR, Inc.
+0023AA     (base 16)		HFR, Inc.
+				5F, Hana EZ Tower
+				Sungnam-si  Kyunggi-do  463-870
+				KR
+
+00-23-A5   (hex)		SageTV, LLC
+0023A5     (base 16)		SageTV, LLC
+				9800 S. La Cienega Blvd
+				Inglewood  CA  90301
+				US
+
+00-23-9E   (hex)		Jiangsu Lemote Technology Corporation Limited
+00239E     (base 16)		Jiangsu Lemote Technology Corporation Limited
+				Menglan Industrial Park,Yushan
+				Changshu  Jiangsu  215500
+				CN
+
+00-23-FC   (hex)		Ultra Stereo Labs, Inc
+0023FC     (base 16)		Ultra Stereo Labs, Inc
+				181 Bonetti Drive
+				San Luis Obispo  CA  93401
+				US
+
+00-23-BB   (hex)		Schmitt Industries
+0023BB     (base 16)		Schmitt Industries
+				2765 NW Nicolai St
+				Portland  Oregon  97210
+				US
+
+00-23-8D   (hex)		Techno Design Co., Ltd.
+00238D     (base 16)		Techno Design Co., Ltd.
+				312-2
+				Aso-gun  Kumamoto-ken  861-2401
+				JP
+
+00-23-87   (hex)		ThinkFlood, Inc.
+002387     (base 16)		ThinkFlood, Inc.
+				138 Claflin St
+				Belmont  MA  02478
+				US
+
+00-23-84   (hex)		GGH Engineering s.r.l.
+002384     (base 16)		GGH Engineering s.r.l.
+				Via Agucchi 84/2
+				Bologna    40133
+				IT
+
+00-23-91   (hex)		Maxian
+002391     (base 16)		Maxian
+				21th Fl. KINS tower, 25-1
+				Seongnam-city  Gyeonggi-do  463-847
+				KR
+
+00-23-92   (hex)		Proteus Industries Inc.
+002392     (base 16)		Proteus Industries Inc.
+				340 Pioneer Way
+				Mountain View  CA  94041
+				US
+
+00-23-93   (hex)		AJINEXTEK
+002393     (base 16)		AJINEXTEK
+				9-3, Holimdong, Dalseogu
+				Daegu    704-240
+				KR
+
+00-23-7F   (hex)		PLANTRONICS, INC.
+00237F     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+00-23-6F   (hex)		DAQ System
+00236F     (base 16)		DAQ System
+				Rm 913, SungNam Woolim Lions VAlley I, 311-3
+				Sungnam-Si  Kyunggi-Do,  462-806
+				KR
+
+00-23-30   (hex)		DIZIPIA, INC.
+002330     (base 16)		DIZIPIA, INC.
+				15th Floor, East Wing, IT Venture Tower
+				Seoul    138160
+				KR
+
+00-23-69   (hex)		Cisco-Linksys, LLC
+002369     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-22-F8   (hex)		PIMA Electronic Systems Ltd.
+0022F8     (base 16)		PIMA Electronic Systems Ltd.
+				5 Hatzoref St.
+				Holon    58856
+				IL
+
+00-23-1C   (hex)		Fourier Systems Ltd.
+00231C     (base 16)		Fourier Systems Ltd.
+				16 Hamelacha St
+				Rosh Haayin    48091
+				IL
+
+00-23-1D   (hex)		Deltacom Electronics Ltd
+00231D     (base 16)		Deltacom Electronics Ltd
+				2F,ZIT,7km Tzarigradsko Shose
+				Sofia  Sofia-grad  1784
+				BG
+
+00-22-D7   (hex)		Nintendo Co., Ltd.
+0022D7     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-22-D6   (hex)		Cypak AB
+0022D6     (base 16)		Cypak AB
+				P.O. BOX 2332
+				Stockholm    103 18
+				SE
+
+00-22-D0   (hex)		Polar Electro Oy
+0022D0     (base 16)		Polar Electro Oy
+				Professorintie 5
+				Kempele  Oulu  90440
+				FI
+
+00-23-0A   (hex)		ARBURG GmbH & Co KG
+00230A     (base 16)		ARBURG GmbH & Co KG
+				Arthur Hehl Straße
+				Lossburg    D-72290
+				DE
+
+00-22-C3   (hex)		Zeeport Technology Inc.
+0022C3     (base 16)		Zeeport Technology Inc.
+				1F,No231,Xianzheng 2nd Rd.
+				HsinChu  Taiwan  300
+				TW
+
+00-23-16   (hex)		KISAN ELECTRONICS CO
+002316     (base 16)		KISAN ELECTRONICS CO
+				317-15
+				SEOUNG-DONG GU  SEOUL  133-123
+				KR
+
+00-23-0F   (hex)		Hirsch Electronics Corporation
+00230F     (base 16)		Hirsch Electronics Corporation
+				1900 Carnegie, Bldg. B
+				Santa Ana  CA  92705
+				US
+
+00-23-2D   (hex)		SandForce
+00232D     (base 16)		SandForce
+				12950 Saratoga Ave.
+				Saratoga  California  95070-4658
+				US
+
+00-23-23   (hex)		Zylin AS
+002323     (base 16)		Zylin AS
+				Auglendsdalen 78
+				Stavanger    4017
+				NO
+
+00-22-DE   (hex)		OPPO Digital, Inc.
+0022DE     (base 16)		OPPO Digital, Inc.
+				2629B Terminal Blvd
+				Mountain View  CA  94043
+				US
+
+00-22-F1   (hex)		Private
+0022F1     (base 16)		Private
+
+00-22-A2   (hex)		Xtramus Technologies
+0022A2     (base 16)		Xtramus Technologies
+				5th Fl., No. 102, Lide St.,
+				Zhonghe City  Taipei County  235
+				TW
+
+00-22-9E   (hex)		Social Aid Research Co., Ltd.
+00229E     (base 16)		Social Aid Research Co., Ltd.
+				South 3, West 10, Chuo-ku
+				Sapporo  Hokkaido  060-0063
+				JP
+
+00-22-85   (hex)		NOMUS COMM SYSTEMS
+002285     (base 16)		NOMUS COMM SYSTEMS
+				601, Gunjan Tower,
+				Baroda  Gujarat  390023
+				IN
+
+00-22-81   (hex)		Daintree Networks Pty
+002281     (base 16)		Daintree Networks Pty
+				1 Dalmore Drive
+				Scoresby  Victoria  3179
+				AU
+
+00-22-55   (hex)		Cisco Systems, Inc
+002255     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-4E   (hex)		SEEnergy Corp.
+00224E     (base 16)		SEEnergy Corp.
+				4F, No.61, Dongsing RD.
+				Taipei    110
+				TW
+
+00-22-87   (hex)		Titan Wireless LLC
+002287     (base 16)		Titan Wireless LLC
+				3914 Gattis School Rd
+				Round Rock  Texas  78664
+				US
+
+00-22-88   (hex)		Sagrad, Inc.
+002288     (base 16)		Sagrad, Inc.
+				751 North Drive
+				Melbourne  FL  32934
+				US
+
+00-22-73   (hex)		Techway
+002273     (base 16)		Techway
+				Rm 1002, Daehyun Techno World Bd,
+				Uiwang-Si,  Kyungki-Do  437-820
+				KR
+
+00-22-6B   (hex)		Cisco-Linksys, LLC
+00226B     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-22-67   (hex)		Nortel Networks
+002267     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-22-95   (hex)		SGM Technology for lighting spa
+002295     (base 16)		SGM Technology for lighting spa
+				Via Pio La Torre 1
+				Tavullia  PU  61010
+				IT
+
+00-22-5A   (hex)		Garde Security AB
+00225A     (base 16)		Garde Security AB
+				Box 78
+				Soderhamn    S-826 22
+				SE
+
+00-22-42   (hex)		Alacron Inc.
+002242     (base 16)		Alacron Inc.
+				71 Spit Brook Rd.
+				Nashua  NH  03060
+				US
+
+00-22-34   (hex)		Corventis Inc.
+002234     (base 16)		Corventis Inc.
+				1410 Energy Park Dr. Suite #1
+				St. Paul  Minnesota  55108
+				US
+
+00-21-F7   (hex)		HPN Supply Chain
+0021F7     (base 16)		HPN Supply Chain
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+00-21-F4   (hex)		INRange Systems, Inc
+0021F4     (base 16)		INRange Systems, Inc
+				3316 5th Avenue, Suite 100
+				Altoona  PA  16602
+				US
+
+00-21-F5   (hex)		Western Engravers Supply, Inc.
+0021F5     (base 16)		Western Engravers Supply, Inc.
+				17621 N Black Canyon Highway
+				Phoenix  AZ  85023
+				US
+
+00-22-32   (hex)		Design Design Technology Ltd
+002232     (base 16)		Design Design Technology Ltd
+				Unit 9, Ash Road South
+				Wrexham  North Wales  LL13 9UG
+				GB
+
+00-22-2B   (hex)		Nucomm, Inc.
+00222B     (base 16)		Nucomm, Inc.
+				101 Bilby Road
+				Hackettstown  NJ  07840
+				US
+
+00-22-26   (hex)		Avaak, Inc.
+002226     (base 16)		Avaak, Inc.
+				9645 Scranton Rd., Suitie 110
+				San Diego  CA  92121
+				US
+
+00-22-21   (hex)		ITOH DENKI CO,LTD.
+002221     (base 16)		ITOH DENKI CO,LTD.
+				1146-2, Asazuma-cho
+				Kasai  Hyogo  679-0180
+				JP
+
+00-22-1D   (hex)		Freegene Technology LTD
+00221D     (base 16)		Freegene Technology LTD
+				3/F ,C BLDG,Weipengda Industrial Park
+				Shenzhen  Gongdong  518109
+				CN
+
+00-22-24   (hex)		Good Will Instrument Co., Ltd.
+002224     (base 16)		Good Will Instrument Co., Ltd.
+				No. 7-1 Jhongsing Road,
+				Taipei    236
+				TW
+
+00-22-45   (hex)		Leine & Linde AB
+002245     (base 16)		Leine & Linde AB
+				Box 8
+				Strängnäs  Södermanland  SE-645 21
+				SE
+
+00-22-49   (hex)		HOME MULTIENERGY SL
+002249     (base 16)		HOME MULTIENERGY SL
+				Capitán HAYA 1
+				MADRID    28020
+				ES
+
+00-22-40   (hex)		Universal Telecom S/A
+002240     (base 16)		Universal Telecom S/A
+				Avenida Paulista, 2444 - 17 andar
+				São Paulo    01310-300
+				BR
+
+00-22-0F   (hex)		MoCA (Multimedia over Coax Alliance)
+00220F     (base 16)		MoCA (Multimedia over Coax Alliance)
+				90 Inverness Circle East
+				Englewood  CA  94583
+				US
+
+00-22-0A   (hex)		OnLive, Inc
+00220A     (base 16)		OnLive, Inc
+				1091 N Shoreline Blvd
+				Mountainview  California  94043
+				US
+
+00-22-03   (hex)		Glensound Electronics Ltd
+002203     (base 16)		Glensound Electronics Ltd
+				1 - 6 Brooks Place
+				Maidstone  Kent  ME17 1UN
+				GB
+
+00-22-04   (hex)		KORATEK
+002204     (base 16)		KORATEK
+				Geumjeong-dong
+				Gunpo-si  Gyeonggi-do  435-825
+				KR
+
+00-21-FF   (hex)		Cyfrowy Polsat SA
+0021FF     (base 16)		Cyfrowy Polsat SA
+				Łubinowa
+				Warsaw  Mazowieckie  03-878
+				PL
+
+00-21-E4   (hex)		I-WIN
+0021E4     (base 16)		I-WIN
+				27 Rue des Econdeaux
+				EPINAY SUR SEINE  Seine Saint Denis  93800
+				FR
+
+00-21-E5   (hex)		Display Solution AG
+0021E5     (base 16)		Display Solution AG
+				Talhofstraße 32a
+				Gilching  D  82205
+				DE
+
+00-22-1B   (hex)		Morega Systems
+00221B     (base 16)		Morega Systems
+				5770 Hurontario Street
+				Mississauga  Ontario  L5R 3G5
+				CA
+
+00-21-B2   (hex)		Fiberblaze A/S
+0021B2     (base 16)		Fiberblaze A/S
+				Kildevangsvej 9
+				Roskilde    4000
+				DK
+
+00-21-AC   (hex)		Infrared Integrated Systems Ltd
+0021AC     (base 16)		Infrared Integrated Systems Ltd
+				Park Circle, Tithe Barn Way
+				Northampton  Northants  NN4 9BG
+				GB
+
+00-21-8E   (hex)		MEKICS CO., LTD.
+00218E     (base 16)		MEKICS CO., LTD.
+				Industrial Zone 861-10, Taegye-Dong
+				Chunchon  Kangwon  200-944
+				KR
+
+00-21-8F   (hex)		Avantgarde Acoustic Lautsprechersysteme GmbH
+00218F     (base 16)		Avantgarde Acoustic Lautsprechersysteme GmbH
+				Nibelungenstraße 349
+				Lautertal - Reichenbach  Hessen  D-64686
+				DE
+
+00-21-7E   (hex)		Telit Communication s.p.a
+00217E     (base 16)		Telit Communication s.p.a
+				Via stazione di prosecco 5B
+				SGONICO  Trieste  34010
+				IT
+
+00-21-87   (hex)		Imacs GmbH
+002187     (base 16)		Imacs GmbH
+				Mittelfeldstrasse 25
+				Kornwestheim  Germany  D-70806
+				DE
+
+00-21-81   (hex)		Si2 Microsystems Limited
+002181     (base 16)		Si2 Microsystems Limited
+				No 84, Sy No 150, EPIP, Whitefield Industrial Area
+				Bangalore  Karnataka  560066
+				IN
+
+00-21-C2   (hex)		GL Communications Inc
+0021C2     (base 16)		GL Communications Inc
+				818 West Diamond Ave
+				Gaithersburg  MD  20878
+				US
+
+00-21-E2   (hex)		visago Systems & Controls GmbH & Co. KG
+0021E2     (base 16)		visago Systems & Controls GmbH & Co. KG
+				Neuwiesenstraße 20
+				Weilheim an der Teck    D-73235
+				DE
+
+00-21-DD   (hex)		Northstar Systems Corp
+0021DD     (base 16)		Northstar Systems Corp
+				5F, No.200 Gang Qian Rd
+				Taipei    114
+				TW
+
+00-21-D5   (hex)		X2E GmbH
+0021D5     (base 16)		X2E GmbH
+				Raiffeisenstrasse 9
+				Winden  Rheinland-Pfalz  76872
+				DE
+
+00-21-A2   (hex)		EKE-Electronics Ltd.
+0021A2     (base 16)		EKE-Electronics Ltd.
+				Piispanportti 7
+				ESPOO    02240
+				FI
+
+00-21-C9   (hex)		Wavecom Asia Pacific Limited
+0021C9     (base 16)		Wavecom Asia Pacific Limited
+				201 Bio-Informatics Centre,  No.2 Science Park West Ave
+				    
+				HK
+
+00-21-4A   (hex)		Pixel Velocity, Inc
+00214A     (base 16)		Pixel Velocity, Inc
+				3917 Research Park Dr.
+				Ann Arbor  MI  48108
+				US
+
+00-21-46   (hex)		Sanmina-SCI
+002146     (base 16)		Sanmina-SCI
+				13000 South Memorial Parkway
+				Huntsville  AL  35803
+				US
+
+00-21-6E   (hex)		Function ATI (Huizhou) Telecommunications Co., Ltd.
+00216E     (base 16)		Function ATI (Huizhou) Telecommunications Co., Ltd.
+				No. 8, Huitai Road, Huitai Industrial Zone
+				Huizhou City  Guangdong Province  516006
+				CN
+
+00-21-6D   (hex)		Soltech Co., Ltd.
+00216D     (base 16)		Soltech Co., Ltd.
+				#30-3,3F
+				Yongsan Ku  Seoul  140837
+				KR
+
+00-21-65   (hex)		Presstek Inc.
+002165     (base 16)		Presstek Inc.
+				55 Executive Drive
+				Hudson  New Hampshire  03051
+				US
+
+00-21-1F   (hex)		SHINSUNG DELTATECH CO.,LTD.
+00211F     (base 16)		SHINSUNG DELTATECH CO.,LTD.
+				44-10
+				CHANGWON-CITY  KYUNGNAM-DO  641-290
+				KR
+
+00-21-24   (hex)		Optos Plc
+002124     (base 16)		Optos Plc
+				Queensferry House
+				Dunfermline  Fife  KY11 8GR
+				GB
+
+00-21-33   (hex)		Building B, Inc
+002133     (base 16)		Building B, Inc
+				1000 NW 65th Street, Suite 300
+				Ft. Lauderdale  FL  33309
+				US
+
+00-21-34   (hex)		Brandywine Communications
+002134     (base 16)		Brandywine Communications
+				1153 Warner Ave
+				Tustin  CA  92780
+				US
+
+00-21-3A   (hex)		Winchester Systems Inc.
+00213A     (base 16)		Winchester Systems Inc.
+				101 Billerica Avenue
+				Billerica,  MA  01862
+				US
+
+00-21-2E   (hex)		dresden-elektronik
+00212E     (base 16)		dresden-elektronik
+				Enno-Heidebroek-Str. 12
+				Dresden  Saxony  D-01237
+				DE
+
+00-21-30   (hex)		Keico Hightech Inc.
+002130     (base 16)		Keico Hightech Inc.
+				Ace twin tower I, 12th Fl.
+				Seoul    152-050
+				KR
+
+00-21-5B   (hex)		SenseAnywhere
+00215B     (base 16)		SenseAnywhere
+				Lisztlaan 2
+				Roosendaal    4702 KJ
+				NL
+
+00-21-4E   (hex)		GS Yuasa Power Supply Ltd.
+00214E     (base 16)		GS Yuasa Power Supply Ltd.
+				1, Inobanba-cho, Nishinosho, Kisshoin, Minami-ku,
+				Kyoto    601-8520
+				JP
+
+00-21-42   (hex)		Advanced Control Systems doo
+002142     (base 16)		Advanced Control Systems doo
+				Bulevar Zorana Djindjica 8a
+				Belgrade  Serbia  11070
+				YU
+
+00-1F-FA   (hex)		Coretree, Co, Ltd
+001FFA     (base 16)		Coretree, Co, Ltd
+				#502 IT Venture Town, 694
+				Daejeon    305-510
+				KR
+
+00-1F-F5   (hex)		Kongsberg Defence & Aerospace
+001FF5     (base 16)		Kongsberg Defence & Aerospace
+				Olav Brunborgs vei 6
+				Billingstad    1396
+				NO
+
+00-1F-F2   (hex)		VIA Technologies, Inc.
+001FF2     (base 16)		VIA Technologies, Inc.
+				1F, 531, Chung-Cheng Road
+				Hsin-Tien  Taipei  231
+				TW
+
+00-21-01   (hex)		Aplicaciones Electronicas Quasar (AEQ)
+002101     (base 16)		Aplicaciones Electronicas Quasar (AEQ)
+				C/Rey Pastor 40
+				Leganes  Madrid  28914
+				ES
+
+00-21-03   (hex)		GHI Electronics, LLC
+002103     (base 16)		GHI Electronics, LLC
+				35555 Garfield Rd.
+				Clinton Township  MI  48035
+				US
+
+00-1F-F8   (hex)		Siemens AG, Sector Industry, Drive Technologies, Motion Control Systems
+001FF8     (base 16)		Siemens AG, Sector Industry, Drive Technologies, Motion Control Systems
+				Frauenauracherstraße 80
+				Erlangen  Bavaria  91056
+				DE
+
+00-1F-D0   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+001FD0     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+00-1F-D1   (hex)		OPTEX CO.,LTD.
+001FD1     (base 16)		OPTEX CO.,LTD.
+				5-8-12
+				Otsu  Shiga  520-0101
+				JP
+
+00-1F-C9   (hex)		Cisco Systems, Inc
+001FC9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-DC   (hex)		Mobile Safe Track Ltd
+001FDC     (base 16)		Mobile Safe Track Ltd
+				Niemenkatu 73
+				15149  Lahti  
+				FI
+
+00-1F-D6   (hex)		Shenzhen Allywll
+001FD6     (base 16)		Shenzhen Allywll
+				Kejiyuan Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-21-17   (hex)		Tellord
+002117     (base 16)		Tellord
+				Gurogu Gurodong 170-5 Woolim e-Biz Center 709
+				Seoul    152-050
+				KR
+
+00-21-0F   (hex)		Cernium Corp
+00210F     (base 16)		Cernium Corp
+				1943 Isaac Newton Sq
+				Reston  VA  20190
+				US
+
+00-1F-F1   (hex)		Paradox Hellas S.A.
+001FF1     (base 16)		Paradox Hellas S.A.
+				3 Korinthoy St
+				Athens  Attiki  14451
+				GR
+
+00-1F-E6   (hex)		Alphion Corporation
+001FE6     (base 16)		Alphion Corporation
+				196 Princeton Hightstown Rd.
+				Princeton Junction  NJ  08550
+				US
+
+00-1F-CF   (hex)		MSI Technology GmbH
+001FCF     (base 16)		MSI Technology GmbH
+				Hanauer Landstraße 328-330
+				Frankfurt am Main  Hessen  60314
+				DE
+
+00-1F-9C   (hex)		LEDCO
+001F9C     (base 16)		LEDCO
+				47801 W Anchor Court
+				Plymouth  MI  48170
+				US
+
+00-1F-90   (hex)		Actiontec Electronics, Inc
+001F90     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-1F-91   (hex)		DBS Lodging Technologies, LLC
+001F91     (base 16)		DBS Lodging Technologies, LLC
+				21196 Limber
+				Mission Viejo  CA  92692
+				US
+
+00-1F-98   (hex)		DAIICHI-DENTSU LTD.
+001F98     (base 16)		DAIICHI-DENTSU LTD.
+				OOMORI 690-1
+				KANI  GIFU  509-0238
+				JP
+
+00-1F-93   (hex)		Xiotech Corporation
+001F93     (base 16)		Xiotech Corporation
+				6455 Flying Cloud Drive
+				Eden Prairie  MN  55344
+				US
+
+00-1F-51   (hex)		HD Communications Corp
+001F51     (base 16)		HD Communications Corp
+				2180 Fifth Ave
+				Ronkonkoma  NY  11779
+				US
+
+00-1F-53   (hex)		GEMAC Chemnitz GmbH
+001F53     (base 16)		GEMAC Chemnitz GmbH
+				Zwickauer Straße 227
+				Chemnitz  Sachsen  09116
+				DE
+
+00-1F-50   (hex)		Swissdis AG
+001F50     (base 16)		Swissdis AG
+				Grasweg 7
+				Schwarzhaeusern  BE  4911
+				CH
+
+00-1F-4C   (hex)		Roseman Engineering Ltd
+001F4C     (base 16)		Roseman Engineering Ltd
+				65 Weizman Street
+				Givataim  Israel  53468
+				IL
+
+00-1F-A9   (hex)		Atlanta DTH, Inc.
+001FA9     (base 16)		Atlanta DTH, Inc.
+				5388 New Peachtree Rd
+				Chamblee  GA  30341
+				US
+
+00-1F-A3   (hex)		T&W Electronics(Shenzhen)Co.,Ltd.
+001FA3     (base 16)		T&W Electronics(Shenzhen)Co.,Ltd.
+				2F,Baiying Building, No.1019,
+				ShenZhen  GuangDong  518067
+				CN
+
+00-1F-A2   (hex)		Datron World Communications, Inc.
+001FA2     (base 16)		Datron World Communications, Inc.
+				3030 Enterprise Court
+				Vista  California  92081
+				US
+
+00-1F-70   (hex)		Botik Technologies LTD
+001F70     (base 16)		Botik Technologies LTD
+				Trudovaya, 1
+				Pereslavl-Zalessky  Yaroslavskaya  152020
+				RU
+
+00-1F-64   (hex)		Beijing Autelan Technology Inc.
+001F64     (base 16)		Beijing Autelan Technology Inc.
+				Room B-12B01, Keshi Plaza, Xinxi road,
+				Beijing    100085
+				CN
+
+00-1F-6D   (hex)		Cisco Systems, Inc
+001F6D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-24   (hex)		DIGITVIEW TECHNOLOGY CO., LTD.
+001F24     (base 16)		DIGITVIEW TECHNOLOGY CO., LTD.
+				NO. 14-22, TIAN-FU ,
+				TAIPEI COUNTY    237
+				TW
+
+00-1F-21   (hex)		Inner Mongolia Yin An Science & Technology Development Co.,L
+001F21     (base 16)		Inner Mongolia Yin An Science & Technology Development Co.,L
+				YinAn Building Yiwei Road.RuYi
+				Beijing    010010
+				CN
+
+00-1F-22   (hex)		Source Photonics, Inc.
+001F22     (base 16)		Source Photonics, Inc.
+				20550 Nordhoff Street
+				Chatsworth  CA  91311
+				US
+
+00-1F-1D   (hex)		Atlas Material Testing Technology LLC
+001F1D     (base 16)		Atlas Material Testing Technology LLC
+				4114 N. Ravenswood Ave.
+				Chicago  IL  60613
+				US
+
+00-1F-15   (hex)		Bioscrypt Inc
+001F15     (base 16)		Bioscrypt Inc
+				505 Cochrane Drive
+				Markham  Ontario  L3R 8E3
+				CA
+
+00-1F-2B   (hex)		Orange Logic
+001F2B     (base 16)		Orange Logic
+				#706 AceTechnoTower 10-cha,470-5
+				SEOUL    153-789
+				KR
+
+00-1F-2A   (hex)		ACCM
+001F2A     (base 16)		ACCM
+				Obour Industrial City, Industrial zone A, lot14, block 12006.
+				Cairo    
+				EG
+
+00-1F-30   (hex)		Travelping
+001F30     (base 16)		Travelping
+				
+				Chemnitz  Saxony  09113
+				DE
+
+00-1F-48   (hex)		Mojix Inc.
+001F48     (base 16)		Mojix Inc.
+				11075 Santa Monica Blvd.
+				Los Angeles  Ca  90025
+				US
+
+00-1F-3E   (hex)		RP-Technik e.K.
+001F3E     (base 16)		RP-Technik e.K.
+				Hermann-Staudinger-Str. 10-16
+				Rodgau  Hessen  63110
+				DE
+
+00-1E-F0   (hex)		Gigafin Networks
+001EF0     (base 16)		Gigafin Networks
+				19050 Pruneridge
+				Cupertino  CA  95014
+				US
+
+00-1E-F2   (hex)		Micro Motion Inc
+001EF2     (base 16)		Micro Motion Inc
+				7070 Winchester Circle
+				Boulder  CO  80301
+				US
+
+00-1F-37   (hex)		Genesis I&C
+001F37     (base 16)		Genesis I&C
+				#515 lisantekeunotaun
+				Goyang  Gyeonggi  410-722
+				KR
+
+00-1F-2C   (hex)		Starbridge Networks
+001F2C     (base 16)		Starbridge Networks
+				3265 Meridian Parkway
+				Weston  FL  33331
+				US
+
+00-1F-31   (hex)		Radiocomp
+001F31     (base 16)		Radiocomp
+				Krakesvej 17
+				Hilleroed  Copenhagen  3400
+				DK
+
+00-1F-12   (hex)		Juniper Networks
+001F12     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-1E-EA   (hex)		Sensor Switch, Inc.
+001EEA     (base 16)		Sensor Switch, Inc.
+				900 Northrop Road
+				Wallingford  CT  06492
+				US
+
+00-1F-04   (hex)		Granch Ltd.
+001F04     (base 16)		Granch Ltd.
+				40 Koroleva str.
+				Novosibirsk  NSO  630015
+				RU
+
+00-1E-94   (hex)		SUPERCOM TECHNOLOGY CORPORATION
+001E94     (base 16)		SUPERCOM TECHNOLOGY CORPORATION
+				8F, NO 100-1, Ming-Chuan Rd.
+				Shing Tien  Taipei  231
+				TW
+
+00-1E-8F   (hex)		CANON INC.
+001E8F     (base 16)		CANON INC.
+				3-30-2
+				Ohta-Ku  Tokyo  146-8501
+				JP
+
+00-1E-A5   (hex)		ROBOTOUS, Inc.
+001EA5     (base 16)		ROBOTOUS, Inc.
+				Nex Center-201(Lab.), SK n Technopark
+				Seongnam-si  Gyeonggi-do  462-120
+				KR
+
+00-1E-A7   (hex)		Actiontec Electronics, Inc
+001EA7     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-1E-A0   (hex)		XLN-t
+001EA0     (base 16)		XLN-t
+				Hoogstraat 52
+				Putte  Antwerp  B2580
+				BE
+
+00-1E-98   (hex)		GreenLine Communications
+001E98     (base 16)		GreenLine Communications
+				Alrabiah - Alrabeea Street
+				Amman  Central Region  11953
+				JO
+
+00-1E-9A   (hex)		HAMILTON Bonaduz AG
+001E9A     (base 16)		HAMILTON Bonaduz AG
+				Via Crusch 8
+				Bonaduz  Graubuenden  7402
+				CH
+
+00-1E-DF   (hex)		Master Industrialization Center Kista
+001EDF     (base 16)		Master Industrialization Center Kista
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+00-1E-E3   (hex)		T&W Electronics (ShenZhen) Co.,Ltd
+001EE3     (base 16)		T&W Electronics (ShenZhen) Co.,Ltd
+				2F Baiying Building, No.19, NanhaiRd., Nanshan Dist
+				ShenZhen  GuangDong  518052
+				CN
+
+00-1E-D9   (hex)		Mitsubishi Precision Co.,LTd.
+001ED9     (base 16)		Mitsubishi Precision Co.,LTd.
+				345 KAMIMACHIYA
+				KAMAKURA-City  KANAGAWA-Prefecture  247-8505
+				JP
+
+00-1E-D3   (hex)		Dot Technology Int'l Co., Ltd.
+001ED3     (base 16)		Dot Technology Int'l Co., Ltd.
+				Unit 1001, Fourseas Building 208-212, Nathan Road
+				Kowloon    
+				HK
+
+00-1E-A6   (hex)		Best IT World (India) Pvt. Ltd.
+001EA6     (base 16)		Best IT World (India) Pvt. Ltd.
+				87/70/93 Mistry Industrial Complex,
+				Mumbai  Maharashtra  400093
+				IN
+
+00-1E-83   (hex)		LAN/MAN Standards Association (LMSC)
+001E83     (base 16)		LAN/MAN Standards Association (LMSC)
+				C/O IEEE Standards Association
+				Piscataway  NJ  08855-1331
+				US
+
+00-1E-7C   (hex)		Taiwick Limited
+001E7C     (base 16)		Taiwick Limited
+				5/F., Block E, Hing Yip Factory Bldg.,
+				Hong Kong  China  852
+				HK
+
+00-1E-CF   (hex)		PHILIPS ELECTRONICS UK LTD
+001ECF     (base 16)		PHILIPS ELECTRONICS UK LTD
+				PHILIPS CENTRE
+				GUILDFORD  SURREY  GU2 8XH
+				GB
+
+00-1E-22   (hex)		ARVOO Imaging Products BV
+001E22     (base 16)		ARVOO Imaging Products BV
+				Tasveld 13
+				Montfoort  UT  3417 XS
+				NL
+
+00-1E-1A   (hex)		Best Source Taiwan Inc.
+001E1A     (base 16)		Best Source Taiwan Inc.
+				2F, No.16, Lane 56, Jhongjheng W. Rd.,
+				Jhubei City,  Hsinchu County  302
+				TW
+
+00-1E-19   (hex)		GTRI
+001E19     (base 16)		GTRI
+				M/S 0821
+				Atlanta  GA  30332
+				US
+
+00-1E-14   (hex)		Cisco Systems, Inc
+001E14     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-44   (hex)		SANTEC
+001E44     (base 16)		SANTEC
+				An der Strusbek 31
+				Ahrensburg  Schleswig Holstein  22926
+				DE
+
+00-1E-62   (hex)		Siemon
+001E62     (base 16)		Siemon
+				27 Siemon Company Drive
+				Watertown  CT  06795
+				US
+
+00-1E-5C   (hex)		RB GeneralEkonomik
+001E5C     (base 16)		RB GeneralEkonomik
+				Bulevar despota stefana 59a
+				Beograd  Serbia  11000
+				YU
+
+00-1E-5D   (hex)		Holosys d.o.o.
+001E5D     (base 16)		Holosys d.o.o.
+				Kovinska 4
+				Zagreb    10090
+				HR
+
+00-1E-78   (hex)		Owitek Technology Ltd.,
+001E78     (base 16)		Owitek Technology Ltd.,
+				No.2, Lane 78, Cingshan 6th St.,
+				Taoyuan County    32657
+				TW
+
+00-1E-7A   (hex)		Cisco Systems, Inc
+001E7A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-27   (hex)		SBN TECH Co.,Ltd.
+001E27     (base 16)		SBN TECH Co.,Ltd.
+				#706 Industrial Academic Center, Konkuk University, Hwayang-dong, Gwangjin-gu
+				Seoul    143-701
+				KR
+
+00-1E-60   (hex)		Digital Lighting Systems, Inc
+001E60     (base 16)		Digital Lighting Systems, Inc
+				12302 Sw 128th ct,   #105
+				Miami  FL  33186
+				US
+
+00-1E-6C   (hex)		Opaque Systems
+001E6C     (base 16)		Opaque Systems
+				4820 Fisher Road
+				Athens  OH  45701
+				US
+
+00-1E-2F   (hex)		DiMoto Pty Ltd
+001E2F     (base 16)		DiMoto Pty Ltd
+				7 Meljaren Place
+				Buderim  Queensland  4556
+				AU
+
+00-1E-36   (hex)		IPTE
+001E36     (base 16)		IPTE
+				Geleenlaan 5
+				Genk  Limburg  3600
+				BE
+
+00-1D-A7   (hex)		Seamless Internet
+001DA7     (base 16)		Seamless Internet
+				2050 Russett Way Suite 338
+				Carson City  Nevada  89703
+				US
+
+00-1D-A5   (hex)		WB Electronics
+001DA5     (base 16)		WB Electronics
+				Langelandsvej 1A
+				Herning  Herning  7400
+				DK
+
+00-1D-A8   (hex)		Takahata Electronics Co.,Ltd
+001DA8     (base 16)		Takahata Electronics Co.,Ltd
+				1188,Kubota,Kubota-machi
+				Yonezawa-shi  Yamagata-Pref.  992-0003
+				JP
+
+00-1D-A9   (hex)		Castles Technology, Co., LTD
+001DA9     (base 16)		Castles Technology, Co., LTD
+				2F, No.205, Sec 3 Beishin Rd.,
+				Hsin-Tien City  Taipei  231
+				TW
+
+00-1D-CB   (hex)		Exéns Development Oy
+001DCB     (base 16)		Exéns Development Oy
+				Kauppakatu 36
+				Kajaani  Kainuu  87100
+				FI
+
+00-1D-CA   (hex)		PAV Electronics Limited
+001DCA     (base 16)		PAV Electronics Limited
+				7 Laverock Road
+				Airdrie  Lanarkshire  ML6 7UD
+				GB
+
+00-1D-C2   (hex)		XORTEC OY
+001DC2     (base 16)		XORTEC OY
+				Höytämöntie 6
+				Lempäälä   Pirkanmaa  33880
+				FI
+
+00-1E-0E   (hex)		MAXI VIEW HOLDINGS LIMITED
+001E0E     (base 16)		MAXI VIEW HOLDINGS LIMITED
+				Suite 2302,23/F Great Eagle Centre, 23 Harbour Road, Wanchai
+				Hong Kong    
+				CN
+
+00-1E-0F   (hex)		Briot International
+001E0F     (base 16)		Briot International
+				2 rue roger Bonnet
+				Pont de l'Arche  Eure  27340
+				FR
+
+00-1D-E3   (hex)		Intuicom
+001DE3     (base 16)		Intuicom
+				4900 Nautilus CT N
+				Boulder  CO  80301
+				US
+
+00-1D-DE   (hex)		Zhejiang Broadcast&Television Technology Co.,Ltd.
+001DDE     (base 16)		Zhejiang Broadcast&Television Technology Co.,Ltd.
+				Building No.16,Xidoumen Industry Park,Wenyi Road,
+				Hangzhou  Zhejiang  310012
+				CN
+
+00-1D-E5   (hex)		Cisco Systems, Inc
+001DE5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-EC   (hex)		Marusys
+001DEC     (base 16)		Marusys
+				Eunsung Bldg. 5F
+				Seoul    135-763
+				KR
+
+00-1D-E8   (hex)		Nikko Denki Tsushin Corporation(NDTC)
+001DE8     (base 16)		Nikko Denki Tsushin Corporation(NDTC)
+				440 Kamoshida-town, Aoba-ku
+				Yokohama    227-0033
+				JP
+
+00-1D-DA   (hex)		Mikroelektronika spol. s r. o.
+001DDA     (base 16)		Mikroelektronika spol. s r. o.
+				Dráby 849
+				Vysoké Mýto  CZ  566 01
+				CZ
+
+00-1D-B0   (hex)		FuJian HengTong Information Technology Co.,Ltd
+001DB0     (base 16)		FuJian HengTong Information Technology Co.,Ltd
+				No.14-804,Building 2,JinXiuFuCheng,No.338,HuaLin Road
+				FuZhou City  FuJian Province  350001
+				CN
+
+00-1D-B8   (hex)		Intoto Inc.
+001DB8     (base 16)		Intoto Inc.
+				3100 De La Cruz Blvd.  #300
+				Santa Clara  CA  95054
+				US
+
+00-1D-F5   (hex)		Sunshine Co,LTD
+001DF5     (base 16)		Sunshine Co,LTD
+				1-3-5 Kojimachi
+				TOKYO  Kanto region  102-0083
+				JP
+
+00-1D-F0   (hex)		Vidient Systems, Inc.
+001DF0     (base 16)		Vidient Systems, Inc.
+				4000 Burton Drive
+				Santa Clara  CA  94054
+				US
+
+00-1D-FE   (hex)		Palm, Inc
+001DFE     (base 16)		Palm, Inc
+				950 West Maude Ave
+				Sunnyvale  CA  94085
+				US
+
+00-1D-52   (hex)		Defzone B.V.
+001D52     (base 16)		Defzone B.V.
+				Transportcentrum 10
+				Enschede  Overijssel  7547 RW
+				NL
+
+00-1D-4A   (hex)		Carestream Health, Inc.
+001D4A     (base 16)		Carestream Health, Inc.
+				150 Verona Street
+				Rochestser  NY  14608
+				US
+
+00-1D-96   (hex)		WatchGuard Video
+001D96     (base 16)		WatchGuard Video
+				3001 Summit Ave.
+				Plano  TX  75074
+				US
+
+00-1D-8F   (hex)		PureWave Networks
+001D8F     (base 16)		PureWave Networks
+				2660-C Marine Way
+				Mountain View  CA  94043
+				US
+
+00-1D-8C   (hex)		La Crosse Technology LTD
+001D8C     (base 16)		La Crosse Technology LTD
+				2809 Losey Blvd. So.
+				La Crosse  WI  54601
+				US
+
+00-1D-64   (hex)		Adam Communications Systems Int Ltd
+001D64     (base 16)		Adam Communications Systems Int Ltd
+				The Mission
+				Stockport  Cheshire  SK1 3AH
+				GB
+
+00-1D-5E   (hex)		COMING MEDIA CORP.
+001D5E     (base 16)		COMING MEDIA CORP.
+				BONA Bld. 4th Fl., 548-18
+				Seoul    135-158
+				KR
+
+00-1D-55   (hex)		ZANTAZ, Inc
+001D55     (base 16)		ZANTAZ, Inc
+				5758 W. Las Positas Avenue
+				Pleasanton  CA  94588
+				US
+
+00-1D-A1   (hex)		Cisco Systems, Inc
+001DA1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-71   (hex)		Cisco Systems, Inc
+001D71     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-65   (hex)		Microwave Radio Communications
+001D65     (base 16)		Microwave Radio Communications
+				101 Billerica Avemue, Bldg 6
+				N. Billerica  MA  01862
+				US
+
+00-1D-50   (hex)		SPINETIX SA
+001D50     (base 16)		SPINETIX SA
+				Parc Scientifique de l'EPFL, Bâtiment C
+				Lausanne  VD  1015
+				CH
+
+00-1D-45   (hex)		Cisco Systems, Inc
+001D45     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-69   (hex)		Knorr-Bremse IT-Services GmbH
+001D69     (base 16)		Knorr-Bremse IT-Services GmbH
+				Moosacher Str. 80
+				Muenchen  BY  80809
+				DE
+
+00-1C-F8   (hex)		Parade Technologies, Ltd.
+001CF8     (base 16)		Parade Technologies, Ltd.
+				C/O Parade Technologies, Inc.
+				Sunnyvale  CA  94085
+				US
+
+00-1C-F7   (hex)		AudioScience
+001CF7     (base 16)		AudioScience
+				729 west 16th st
+				Costa Mesa  California  92627
+				US
+
+00-1C-F6   (hex)		Cisco Systems, Inc
+001CF6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-F5   (hex)		Wiseblue Technology Limited
+001CF5     (base 16)		Wiseblue Technology Limited
+				Rm G5, 5/F, Kingsford Industrial Building Phase II, 26-32 Kwai Hei Street,
+				Kwai Chung  N.T.  
+				HK
+
+00-1C-EE   (hex)		SHARP Corporation
+001CEE     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+00-1D-07   (hex)		Shenzhen Sang Fei Consumer Communications Co.,Ltd
+001D07     (base 16)		Shenzhen Sang Fei Consumer Communications Co.,Ltd
+				11 Science and Technology Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1D-06   (hex)		HM Electronics, Inc.
+001D06     (base 16)		HM Electronics, Inc.
+				14110 Stowe Drive
+				Poway  CA  92064
+				US
+
+00-1D-01   (hex)		Neptune Digital
+001D01     (base 16)		Neptune Digital
+				Mednarodni mejni prehod 6
+				Vrtojba  Nova Gorica  5290
+				SI
+
+00-1D-33   (hex)		Maverick Systems Inc.
+001D33     (base 16)		Maverick Systems Inc.
+				908, Daerungposttower 2-cha, 182-13
+				Seoul    152-790
+				KR
+
+00-1D-2C   (hex)		Wavetrend Technologies (Pty) Limited
+001D2C     (base 16)		Wavetrend Technologies (Pty) Limited
+				Wavetrend House, Building 816/3
+				Gauteng    2021
+				ZA
+
+00-1C-CF   (hex)		LIMETEK
+001CCF     (base 16)		LIMETEK
+				#213-1, Byucksan Digital Valley II, 480-10, Gasan-dong,
+				Seoul    153-783
+				KR
+
+00-1D-24   (hex)		Aclara Power-Line Systems Inc.
+001D24     (base 16)		Aclara Power-Line Systems Inc.
+				945 Hornet Drive
+				Hazelwood  MO  63042
+				US
+
+00-1D-18   (hex)		Power Innovation GmbH
+001D18     (base 16)		Power Innovation GmbH
+				Rehland 2
+				Achim  Niedersachsen  28832
+				DE
+
+00-1D-1B   (hex)		Sangean Electronics Inc.
+001D1B     (base 16)		Sangean Electronics Inc.
+				No. 18, Lane 7, Li-De street
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-1D-17   (hex)		Digital Sky Corporation
+001D17     (base 16)		Digital Sky Corporation
+				5-5-15 Sotokanda,
+				Chiyoda-ku  Tokyo  101-0021
+				JP
+
+00-1D-27   (hex)		NAC-INTERCOM
+001D27     (base 16)		NAC-INTERCOM
+				AVDA. RICARDO MELLA 123-B
+				VIGO  PONTEVEDRA  36330
+				ES
+
+00-1C-E3   (hex)		Optimedical Systems
+001CE3     (base 16)		Optimedical Systems
+				235 Hembree Park Drive
+				Roswell  GA  30076
+				US
+
+00-1C-DE   (hex)		Interactive Multimedia eXchange Inc.
+001CDE     (base 16)		Interactive Multimedia eXchange Inc.
+				NO. 165 Wenlin Road.
+				Taipei  Taiwan  111
+				TW
+
+00-1D-36   (hex)		ELECTRONICS CORPORATION OF INDIA LIMITED
+001D36     (base 16)		ELECTRONICS CORPORATION OF INDIA LIMITED
+				CONTROL AND AUTOMATION DIVISION-3
+				HYDERABAD  ANDHRA PRADESH  500 062
+				IN
+
+00-1C-80   (hex)		New Business Division/Rhea-Information CO., LTD.
+001C80     (base 16)		New Business Division/Rhea-Information CO., LTD.
+				4F 594 Yeong Pung Bldg, Gueui-Dong
+				Seoul  Gwangjin-Gu  143-200
+				KR
+
+00-1C-83   (hex)		New Level Telecom Co., Ltd.
+001C83     (base 16)		New Level Telecom Co., Ltd.
+				INNOPLEX 1-703
+				Seoul    153-803
+				KR
+
+00-1C-76   (hex)		The Wandsworth Group Ltd
+001C76     (base 16)		The Wandsworth Group Ltd
+				Albert Drive
+				Woking  Surrey  GU21 5SE
+				GB
+
+00-1C-72   (hex)		Mayer & Cie GmbH & Co KG
+001C72     (base 16)		Mayer & Cie GmbH & Co KG
+				Emil Mayer Strasse 10
+				Albstadt  Baden-Württemberg  72461
+				DE
+
+00-1C-AD   (hex)		Wuhan Telecommunication Devices Co.,Ltd
+001CAD     (base 16)		Wuhan Telecommunication Devices Co.,Ltd
+				88 Youkeyuan Road,Hongshan District
+				Wuhan  Hubei  430074
+				CN
+
+00-1C-A7   (hex)		International Quartz Limited
+001CA7     (base 16)		International Quartz Limited
+				2nd Floor, 2, Dai Wang Street,
+				  Hong Kong  852
+				CN
+
+00-1C-AB   (hex)		Meyer Sound Laboratories, Inc.
+001CAB     (base 16)		Meyer Sound Laboratories, Inc.
+				2832 San Pablo Ave.
+				Berkeley  CA  94702
+				US
+
+00-1C-9E   (hex)		Dualtech IT AB
+001C9E     (base 16)		Dualtech IT AB
+				Banehagsgatan 1F
+				GOTHENBURG  Västra Götaland  41451
+				SE
+
+00-1C-C8   (hex)		INDUSTRONIC Industrie-Electronic GmbH & Co. KG
+001CC8     (base 16)		INDUSTRONIC Industrie-Electronic GmbH & Co. KG
+				Carl-Jacob-Kolb-Weg 1
+				Wertheim  Baden-Württemberg  97877
+				DE
+
+00-1C-C6   (hex)		ProStor Systems
+001CC6     (base 16)		ProStor Systems
+				5555 Central Avenue
+				Boulder  Colorado  80301
+				US
+
+00-1C-BE   (hex)		Nintendo Co., Ltd.
+001CBE     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1C-94   (hex)		LI-COR Biosciences
+001C94     (base 16)		LI-COR Biosciences
+				4647 Superior Street
+				Lincoln  NE  68504
+				US
+
+00-1C-8C   (hex)		DIAL TECHNOLOGY LTD.
+001C8C     (base 16)		DIAL TECHNOLOGY LTD.
+				6F-4, NO.18, LANE.609, SEC.5, CHONGSIN RD.,
+				SANCHONG CITY  TAIPEI COUNTY  241
+				TW
+
+00-1C-CA   (hex)		Shanghai Gaozhi Science & Technology Development Co.
+001CCA     (base 16)		Shanghai Gaozhi Science & Technology Development Co.
+				No.283 Qin Jiang Rd. Shanghai,China
+				Shanghai    200233
+				CN
+
+00-1C-C9   (hex)		Kaise Electronic Technology Co., Ltd.
+001CC9     (base 16)		Kaise Electronic Technology Co., Ltd.
+				No.678, Wunsyue Rd., Zuoying District,
+				Kaohsiung    813
+				TW
+
+00-1C-93   (hex)		ExaDigm Inc
+001C93     (base 16)		ExaDigm Inc
+				2871 Pullman St
+				Santa Ana  CA  92705
+				US
+
+00-1C-85   (hex)		Eunicorn
+001C85     (base 16)		Eunicorn
+				226-16 unbo b/d suckchon-dong songpa-gu
+				seoul    138845
+				KR
+
+00-1C-67   (hex)		Pumpkin Networks, Inc.
+001C67     (base 16)		Pumpkin Networks, Inc.
+				3FL JungHo Bldg, 108-4 Sangdo-Dong, Dongjak-Gu
+				SEOUL    156-030
+				KR
+
+00-1C-60   (hex)		CSP Frontier Technologies,Inc.
+001C60     (base 16)		CSP Frontier Technologies,Inc.
+				3-2-3,Sasazuka
+				Shibuya-ku  Tokyo  151-0073
+				JP
+
+00-1C-6A   (hex)		Weiss Engineering Ltd.
+001C6A     (base 16)		Weiss Engineering Ltd.
+				Florastrasse 42
+				Uster  ZH  8610
+				CH
+
+00-1C-0A   (hex)		Shenzhen AEE Technology Co.,Ltd.
+001C0A     (base 16)		Shenzhen AEE Technology Co.,Ltd.
+				1st Floor B Building, Shenzhen,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1C-0D   (hex)		G-Technology, Inc.
+001C0D     (base 16)		G-Technology, Inc.
+				1653 Stanford Street
+				Santa Monica  CA  90404
+				US
+
+00-1C-03   (hex)		Betty TV Technology AG
+001C03     (base 16)		Betty TV Technology AG
+				Hardturmstrasse 2
+				Zurich    80005
+				CH
+
+00-1C-46   (hex)		QTUM
+001C46     (base 16)		QTUM
+				#507 Byucksan/Kyungin Digital Valley 2 481-10
+				Seoul    153-783
+				KR
+
+00-1C-42   (hex)		Parallels, Inc.
+001C42     (base 16)		Parallels, Inc.
+				660 SW 39h Street
+				Renton  WA  98057
+				US
+
+00-1C-3E   (hex)		ECKey Corporation
+001C3E     (base 16)		ECKey Corporation
+				206A W James St
+				Lancaster  PA  17603
+				US
+
+00-1C-51   (hex)		Celeno Communications
+001C51     (base 16)		Celeno Communications
+				22 Zarhin Street
+				Ra'anana    43665
+				IL
+
+00-1C-54   (hex)		Hillstone Networks Inc
+001C54     (base 16)		Hillstone Networks Inc
+				A-1905 e-Wing Center
+				Beijing    100086
+				CN
+
+00-1C-59   (hex)		DEVON IT
+001C59     (base 16)		DEVON IT
+				1100 FIRST AVENUE
+				KING OF PRUSSIA  PA  19406
+				US
+
+00-1C-22   (hex)		Aeris Elettronica s.r.l.
+001C22     (base 16)		Aeris Elettronica s.r.l.
+				Zona Ind.le Vallecupa
+				Colonnella  Teramo  64010
+				IT
+
+00-1C-1D   (hex)		CHENZHOU GOSPELL DIGITAL TECHNOLOGY CO.,LTD
+001C1D     (base 16)		CHENZHOU GOSPELL DIGITAL TECHNOLOGY CO.,LTD
+				BAILUTANG,SUXIAN DISTRICT,
+				CHENZHOU  HUNAN  423025
+				CN
+
+00-1C-39   (hex)		S Netsystems Inc.
+001C39     (base 16)		S Netsystems Inc.
+				10F Sungwon Bldg., 141 Samsung-Dong
+				Seoul    135-716
+				KR
+
+00-1C-37   (hex)		Callpod, Inc.
+001C37     (base 16)		Callpod, Inc.
+				850 W. Jackson
+				Chicago  IL  60607
+				US
+
+00-1C-33   (hex)		Sutron
+001C33     (base 16)		Sutron
+				21300 Ridgetop Cir
+				Sterling  VA  20166
+				US
+
+00-1B-F6   (hex)		CONWISE Technology Corporation Ltd.
+001BF6     (base 16)		CONWISE Technology Corporation Ltd.
+				2F No.44, Park Ave. 2, Hsinchu Science Park
+				Hsinchu City    30075
+				TW
+
+00-1B-F8   (hex)		Digitrax Inc.
+001BF8     (base 16)		Digitrax Inc.
+				2443 Transmitter Rd,
+				Panama City  FL  32404
+				US
+
+00-1C-2F   (hex)		Pfister GmbH
+001C2F     (base 16)		Pfister GmbH
+				Stätzlinger  SStraße 70
+				Augsburg  Bavaria  86165
+				DE
+
+00-1C-27   (hex)		Sunell Electronics Co.
+001C27     (base 16)		Sunell Electronics Co.
+				3rd Floor,Bldg.514,BaGua Rd
+				ShenZhen  Guangdong  518029
+				CN
+
+00-1C-0F   (hex)		Cisco Systems, Inc
+001C0F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-48   (hex)		WiDeFi, Inc.
+001C48     (base 16)		WiDeFi, Inc.
+				1333 Gateway Blvd
+				Melbourne  FL  32901
+				US
+
+00-1B-AD   (hex)		iControl Incorporated
+001BAD     (base 16)		iControl Incorporated
+				3235 Kifer Road
+				Santa Clara  California  95051
+				US
+
+00-1B-A7   (hex)		Lorica Solutions
+001BA7     (base 16)		Lorica Solutions
+				275 Northpointe Parkway
+				Amherst  NY  14228
+				US
+
+00-1B-A5   (hex)		MyungMin Systems, Inc.
+001BA5     (base 16)		MyungMin Systems, Inc.
+				#410,Doosan Venture Dime 2-cha,1307-37
+				Kyungki-do    431-060
+				KR
+
+00-1B-F1   (hex)		Nanjing SilverNet Software Co., Ltd.
+001BF1     (base 16)		Nanjing SilverNet Software Co., Ltd.
+				3/F, 10 building, Nanjing World Window Technology & Software Park
+				Nanjing  Jiangsu  210013
+				CN
+
+00-1B-EF   (hex)		Blossoms Digital Technology Co.,Ltd.
+001BEF     (base 16)		Blossoms Digital Technology Co.,Ltd.
+				BLK25,Hengfeng Ind.City,Hezhou
+				Shenzhen  Guangdong  518126
+				CN
+
+00-1B-EB   (hex)		DMP Electronics INC.
+001BEB     (base 16)		DMP Electronics INC.
+				8F., No.12, Wucyuan 7th Rd.,
+				Taipei County    248
+				TW
+
+00-1B-A2   (hex)		IDS Imaging Development Systems GmbH
+001BA2     (base 16)		IDS Imaging Development Systems GmbH
+				Dimbacher Str. 6
+				Obersulm  BW  74182
+				DE
+
+00-1B-9D   (hex)		Novus Security Sp. z o.o.
+001B9D     (base 16)		Novus Security Sp. z o.o.
+				ul. Puławska 431
+				Warsaw  woj. mazowieckie  02-801
+				PL
+
+00-1B-C9   (hex)		FSN DISPLAY INC
+001BC9     (base 16)		FSN DISPLAY INC
+				Baeksuk-Dong 1141-1, Ilsan Techno Town 1009
+				Koyang-si  Kyeonggi-Do  410722
+				KR
+
+00-1B-C3   (hex)		Mobisolution Co.,Ltd
+001BC3     (base 16)		Mobisolution Co.,Ltd
+				848-16
+				Gumi  Gyeongbuk  730-300
+				KR
+
+00-1B-CE   (hex)		Measurement Devices Ltd
+001BCE     (base 16)		Measurement Devices Ltd
+				Redwood House
+				York  Yorkshire  YO266QR
+				GB
+
+00-1B-B8   (hex)		BLUEWAY ELECTRONIC CO;LTD
+001BB8     (base 16)		BLUEWAY ELECTRONIC CO;LTD
+				Workshop B,Dong Feng Village,
+				HuiZhou  GuangDong  516008
+				CN
+
+00-1B-B2   (hex)		Intellect International NV
+001BB2     (base 16)		Intellect International NV
+				Kleine Kloosterstraat 23
+				Zaventem  Vlaamse brabant  1932
+				BE
+
+00-1B-E7   (hex)		Postek Electronics Co., Ltd.
+001BE7     (base 16)		Postek Electronics Co., Ltd.
+				Suite 510, Shanghang Building
+				Shen Zhen  Guang Dong  518028
+				CN
+
+00-1B-E3   (hex)		Health Hero Network, Inc.
+001BE3     (base 16)		Health Hero Network, Inc.
+				2000 Seaport Blvd.
+				Redwood City  CA  94063
+				US
+
+00-1B-DC   (hex)		Vencer Co., Ltd.
+001BDC     (base 16)		Vencer Co., Ltd.
+				20F-1, No.77, Sec.1, Hsin Tai Wu Rd.,
+				Hsi Chih  Taipei  221
+				TW
+
+00-1B-D5   (hex)		Cisco Systems, Inc
+001BD5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-95   (hex)		VIDEO SYSTEMS SRL
+001B95     (base 16)		VIDEO SYSTEMS SRL
+				Loc. Gorizzo, 16
+				CAMINO AL TAGLIAMENTO  UD  
+				IT
+
+00-1B-90   (hex)		Cisco Systems, Inc
+001B90     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-7F   (hex)		TMN Technologies Telecomunicacoes Ltda
+001B7F     (base 16)		TMN Technologies Telecomunicacoes Ltda
+				Rua Nilza, 422
+				São Paulo  SP  03651-120
+				BR
+
+00-1B-7E   (hex)		Beckmann GmbH
+001B7E     (base 16)		Beckmann GmbH
+				Brandtstraße 1
+				Hoevelhof  NRW  33161
+				DE
+
+00-1B-7A   (hex)		Nintendo Co., Ltd.
+001B7A     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1B-34   (hex)		Focus System Inc.
+001B34     (base 16)		Focus System Inc.
+				19F-1, No. 266 Wen Hwa 2nd Rd., Sec. 1
+				Linkou  Taipei County  
+				TW
+
+00-1B-3A   (hex)		SIMS Corp.
+001B3A     (base 16)		SIMS Corp.
+				RAON Bldg, 9F, 92-8, Wonhyoro-2ga, Yongsan-gu
+				Seoul    140-847
+				KR
+
+00-1B-2E   (hex)		Sinkyo Electron Inc
+001B2E     (base 16)		Sinkyo Electron Inc
+				3-3-21 asahigaoka
+				hino-city  Tokyo  191-0065
+				JP
+
+00-1B-5F   (hex)		Alien Technology
+001B5F     (base 16)		Alien Technology
+				18220 Butterfield Blvd.
+				Morgan Hill  CA  95037
+				US
+
+00-1B-61   (hex)		Digital Acoustics, LLC
+001B61     (base 16)		Digital Acoustics, LLC
+				37 Sherwood Terrace
+				Lake Bluff  IL  60044
+				US
+
+00-1B-5E   (hex)		BPL Limited
+001B5E     (base 16)		BPL Limited
+				BPL Towers
+				Bangalore  Karnataka  560001
+				IN
+
+00-1B-5C   (hex)		Azuretec Co., Ltd.
+001B5C     (base 16)		Azuretec Co., Ltd.
+				3F, No.8, Alley 8, Lane 45, Baoxing Rd., Xindian Dist.,
+				New Taipei City  Taiwan  231
+				TW
+
+00-1B-72   (hex)		Sicep s.p.a.
+001B72     (base 16)		Sicep s.p.a.
+				Via calabria, 14
+				Certaldo    50052
+				IT
+
+00-1B-74   (hex)		MiraLink Corporation
+001B74     (base 16)		MiraLink Corporation
+				111 SW 5th Ave.
+				Portland  OR  97204
+				US
+
+00-1B-6D   (hex)		Midtronics, Inc.
+001B6D     (base 16)		Midtronics, Inc.
+				7000 Monroe St.
+				Willowbrook  IL  60527
+				US
+
+00-1B-6F   (hex)		Teletrak Ltd
+001B6F     (base 16)		Teletrak Ltd
+				214 Kepa Road
+				Auckland    1071
+				NZ
+
+00-1B-4B   (hex)		SANION Co., Ltd.
+001B4B     (base 16)		SANION Co., Ltd.
+				#208 ACETECHNO TOWER, 55-7, MULLAE-DONG 3GA,
+				YEONGDEUNGPO-GU  SEOUL  150-992
+				KR
+
+00-1B-2D   (hex)		Med-Eng Systems Inc.
+001B2D     (base 16)		Med-Eng Systems Inc.
+				2400 St. Laurent Blvd.
+				Ottawa  Ontario  K1G 6C4
+				CA
+
+00-1B-87   (hex)		Deepsound Tech. Co., Ltd
+001B87     (base 16)		Deepsound Tech. Co., Ltd
+				3F No. 576 Sec. 1, Minsheng N. Rd., Gueishan Township,
+				Taoyuan    333
+				TW
+
+00-1B-4D   (hex)		Areca Technology Corporation
+001B4D     (base 16)		Areca Technology Corporation
+				8F., No. 22, Lane 35, Ji-Hu Rd.
+				Taipei    114
+				TW
+
+00-1A-E3   (hex)		Cisco Systems, Inc
+001AE3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-DF   (hex)		Interactivetv Pty Limited
+001ADF     (base 16)		Interactivetv Pty Limited
+				Suite 10 Level 3
+				Pyrmont, Sydney  NSW  2009
+				US
+
+00-1A-E1   (hex)		EDGE ACCESS INC
+001AE1     (base 16)		EDGE ACCESS INC
+				5440 BEAUMONT CENTER BLVD
+				TAMPA  FL  33634
+				US
+
+00-1A-E8   (hex)		Unify Software and Solutions GmbH & Co. KG
+001AE8     (base 16)		Unify Software and Solutions GmbH & Co. KG
+				 Mies-van-der-Rohe-Strasse 6
+				Munich    80807
+				DE
+
+00-1A-E9   (hex)		Nintendo Co., Ltd.
+001AE9     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1A-E5   (hex)		Mvox Technologies Inc.
+001AE5     (base 16)		Mvox Technologies Inc.
+				19050 Pruneridge Ave
+				Cupertino  CA  95014
+				US
+
+00-1A-E4   (hex)		Medicis Technologies Corporation
+001AE4     (base 16)		Medicis Technologies Corporation
+				11818 North Creek Parkway N.
+				Bothell  WA  98011
+				US
+
+00-1A-F8   (hex)		Copley Controls Corporation
+001AF8     (base 16)		Copley Controls Corporation
+				20 Dan Road
+				Canton  MA  02021
+				US
+
+00-1A-F5   (hex)		PENTAONE. CO., LTD.
+001AF5     (base 16)		PENTAONE. CO., LTD.
+				Hyo Chang Bldg, 3F, 1013-6, Inkye-dong Paldal-Gu,
+				Suwon City  Gyunggi-Do  422-833
+				KR
+
+00-1A-ED   (hex)		INCOTEC GmbH
+001AED     (base 16)		INCOTEC GmbH
+				Blomestrasse 25 - 27
+				Bielefeld  NRW  33609
+				DE
+
+00-1A-EE   (hex)		Shenztech Ltd
+001AEE     (base 16)		Shenztech Ltd
+				813, 8F, HOLLYWOOD PLAZA, 610 NATHAN ROAD,
+				KOWLOON    852
+				HK
+
+00-1A-CE   (hex)		YUPITERU CORPORATION
+001ACE     (base 16)		YUPITERU CORPORATION
+				3, Dannoue, Iwazu-cho, Okazaki-city, Aichi
+				Okazaki  Aichi  444-2144
+				JP
+
+00-1A-CC   (hex)		Celestial Semiconductor, Ltd
+001ACC     (base 16)		Celestial Semiconductor, Ltd
+				Ugland House, South Church Street,
+				George Town,   Cayman Islands  00000
+				KY
+
+00-1A-D2   (hex)		Eletronica Nitron Ltda
+001AD2     (base 16)		Eletronica Nitron Ltda
+				Rua Dr. Ulisses Escobar 415
+				Camanducaia  Minas Gerais  37650-000
+				BR
+
+00-1B-1D   (hex)		Phoenix International Co., Ltd
+001B1D     (base 16)		Phoenix International Co., Ltd
+				11F. No.42-1, Sec.1, Zhongyang N. Rd. Beitou
+				Taipei    112
+				TW
+
+00-1B-1A   (hex)		e-trees Japan, Inc.
+001B1A     (base 16)		e-trees Japan, Inc.
+				Oowada-cho 2-9-2
+				Hachioji-city  Tokyo  150-0001
+				JP
+
+00-1B-12   (hex)		Apprion
+001B12     (base 16)		Apprion
+				Nasa Ames Rerearch Center
+				Moffett Field  California  94035
+				US
+
+00-1A-FE   (hex)		SOFACREAL
+001AFE     (base 16)		SOFACREAL
+				149 avenue du MAINE
+				PARIS  Region Parisienne  75014
+				FR
+
+00-1A-F1   (hex)		Embedded Artists AB
+001AF1     (base 16)		Embedded Artists AB
+				Davidshallsgatan 16
+				Malmoe    21145
+				SE
+
+00-1B-0D   (hex)		Cisco Systems, Inc
+001B0D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-0A   (hex)		Intelligent Distributed Controls Ltd
+001B0A     (base 16)		Intelligent Distributed Controls Ltd
+				Keynes House, Chester Park
+				Derby  Derbyshire  DE21 4AS
+				GB
+
+00-1A-B1   (hex)		Asia Pacific Satellite Industries Co., Ltd.
+001AB1     (base 16)		Asia Pacific Satellite Industries Co., Ltd.
+				9th FL, IT Castle 2-Dong, #550-1, Gasan-Dong, GeumCheon-Gu,
+				Seoul    153-768
+				KR
+
+00-1A-B7   (hex)		Ethos Networks LTD.
+001AB7     (base 16)		Ethos Networks LTD.
+				2 Maskit St.
+				Herzlia    46766
+				IL
+
+00-1A-B2   (hex)		Cyber Solutions Inc.
+001AB2     (base 16)		Cyber Solutions Inc.
+				6-6-3, Minami Yoshinari
+				Sendai  Miyagi-ken  989-3204
+				JP
+
+00-1A-97   (hex)		fitivision technology Inc.
+001A97     (base 16)		fitivision technology Inc.
+				8F, No. 356, Sec. 1, Neihu Rd
+				Taipei    114
+				TW
+
+00-1A-90   (hex)		Trópico Sistemas e Telecomunicações da Amazônia LTDA. 
+001A90     (base 16)		Trópico Sistemas e Telecomunicações da Amazônia LTDA. 
+				Rod.  Campinas-Mogi-Mirim (SP 340)  Km 118,5
+				Campinas  São Paulo  13.086-902
+				BR
+
+00-1A-94   (hex)		Votronic GmbH
+001A94     (base 16)		Votronic GmbH
+				Saarbruecker Str. 8
+				St. Ingbert  Saarland  66386
+				DE
+
+00-1A-86   (hex)		AdvancedIO Systems Inc
+001A86     (base 16)		AdvancedIO Systems Inc
+				595 Howe Street, Suite 502
+				Vancouver  BC  V6C 2T5
+				CA
+
+00-1A-C7   (hex)		UNIPOINT
+001AC7     (base 16)		UNIPOINT
+				7F Gwangsung Bld 831-47 YeokSam-Dong
+				Seoul    135-936
+				KR
+
+00-1A-C0   (hex)		JOYBIEN TECHNOLOGIES CO., LTD.
+001AC0     (base 16)		JOYBIEN TECHNOLOGIES CO., LTD.
+				14F-7, NO.2, JIAN 8TH RD.,
+				NEW TAIPEI CITY  TAIWAN  23511
+				TW
+
+00-1A-9E   (hex)		ICON Digital International Limited
+001A9E     (base 16)		ICON Digital International Limited
+				Suite2209, 22/F., SkyLine Tower,
+				    
+				CN
+
+00-1A-98   (hex)		Asotel Communication Limited Taiwan Branch
+001A98     (base 16)		Asotel Communication Limited Taiwan Branch
+				3G17, No5, Hsin Yi Road, Sec. 5
+				Taipei    110
+				TW
+
+00-1A-72   (hex)		Mosart Semiconductor Corp.
+001A72     (base 16)		Mosart Semiconductor Corp.
+				23F., No.33, Sec.1,
+				Taipei    220
+				TW
+
+00-1A-68   (hex)		Weltec Enterprise Co., Ltd.
+001A68     (base 16)		Weltec Enterprise Co., Ltd.
+				2F, No. 351 Yung Ho Rd.
+				Chung Ho    235
+				TW
+
+00-1A-C2   (hex)		YEC Co.,Ltd.
+001AC2     (base 16)		YEC Co.,Ltd.
+				543-9 Tsuruma
+				Machida  Tokyo  194-0004
+				JP
+
+00-1A-A5   (hex)		BRN Phoenix
+001AA5     (base 16)		BRN Phoenix
+				2500 Augustine Drive, Suite 200
+				Santa Clara  CA  95054
+				US
+
+00-1A-A2   (hex)		Cisco Systems, Inc
+001AA2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-9C   (hex)		RightHand Technologies, Inc.
+001A9C     (base 16)		RightHand Technologies, Inc.
+				7450 W Wilson Avenue
+				Chicago  IL  60706
+				US
+
+00-1A-7E   (hex)		LN Srithai Comm Ltd.
+001A7E     (base 16)		LN Srithai Comm Ltd.
+				71/12 M.5, Bangna-Trad Rd, KM.52, Thakam
+				Bangpakong  Chachoengsao  24130
+				TH
+
+00-1A-5A   (hex)		Korea Electric Power Data Network  (KDN) Co., Ltd
+001A5A     (base 16)		Korea Electric Power Data Network  (KDN) Co., Ltd
+				665 NAESON-DONG,
+				GYEONGGI-DO  UIWANG-SI, NAESON-DONG  437-082
+				KR
+
+00-1A-5F   (hex)		KitWorks.fi Ltd.
+001A5F     (base 16)		KitWorks.fi Ltd.
+				Snowpolis
+				Vuokatti  Kainuu  88610
+				FI
+
+00-1A-35   (hex)		BARTEC GmbH
+001A35     (base 16)		BARTEC GmbH
+				Schulstraße 30
+				Gotteszell  Bavaria  94239
+				DE
+
+00-1A-37   (hex)		Lear Corporation
+001A37     (base 16)		Lear Corporation
+				Industriestrasse 48
+				Kronach  Bayern  96317
+				DE
+
+00-1A-38   (hex)		Sanmina-SCI
+001A38     (base 16)		Sanmina-SCI
+				13000 South Memorial Parkway
+				Huntsville  AL  35803
+				US
+
+00-1A-2B   (hex)		Ayecom Technology Co., Ltd.
+001A2B     (base 16)		Ayecom Technology Co., Ltd.
+				No. 25, R&D Road 2, Science-Based Industrial Park
+				Hsinchu    300
+				TW
+
+00-1A-28   (hex)		ASWT Co., LTD. Taiwan Branch H.K.
+001A28     (base 16)		ASWT Co., LTD. Taiwan Branch H.K.
+				7F., No.3 Lane 91, Dongmei Rd.
+				Hsinchu    30070
+				TW
+
+00-1A-2C   (hex)		SATEC Co.,LTD
+001A2C     (base 16)		SATEC Co.,LTD
+				358-4, Palgok2-Dong, Sangnok-Gu
+				Ansan-Si  Kyungki-Do  426-190
+				KR
+
+00-1A-27   (hex)		Ubistar
+001A27     (base 16)		Ubistar
+				8F, Seongo Building, 587-23
+				Seoul    135-747
+				KR
+
+00-1A-21   (hex)		Brookhuis Applied Technologies BV
+001A21     (base 16)		Brookhuis Applied Technologies BV
+				PO Box 79
+				Enschede    NL-7500
+				NL
+
+00-19-FF   (hex)		Finnzymes
+0019FF     (base 16)		Finnzymes
+				800 West Cummings Park
+				Woburn  MA  01801
+				US
+
+00-19-FA   (hex)		Cable Vision Electronics CO., LTD.
+0019FA     (base 16)		Cable Vision Electronics CO., LTD.
+				12F-3, No.16, Chien Pa Rd.
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-1A-5D   (hex)		Mobinnova Corp.
+001A5D     (base 16)		Mobinnova Corp.
+				11F, 845, CHUNG SHAN RD
+				TAOYUAN    33059
+				TW
+
+00-1A-4D   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+001A4D     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+00-1A-48   (hex)		Takacom Corporation
+001A48     (base 16)		Takacom Corporation
+				304-709 Aza-Nishiyanma
+				Toki-shi  Gifu-ken  509-5202
+				JP
+
+00-1A-0B   (hex)		BONA TECHNOLOGY INC.
+001A0B     (base 16)		BONA TECHNOLOGY INC.
+				4F, E-Place Bldg., 719-24
+				Seoul    135-080
+				KR
+
+00-1A-06   (hex)		OpVista, Inc.
+001A06     (base 16)		OpVista, Inc.
+				870 North McCarthy Blvd.
+				Milpitas  California  95035
+				US
+
+00-1A-2E   (hex)		Ziova Coporation
+001A2E     (base 16)		Ziova Coporation
+				Unit 3, 7-9 Sherriffs road
+				Lonsdale  S.A.  5160
+				AU
+
+00-1A-32   (hex)		ACTIVA MULTIMEDIA
+001A32     (base 16)		ACTIVA MULTIMEDIA
+				SICP CSE
+				SANT JOAN DESPI  BARCELONA  08970
+				ES
+
+00-1A-00   (hex)		MATRIX INC.
+001A00     (base 16)		MATRIX INC.
+				AS bld.3-13-20
+				Osaka    530-0047
+				JP
+
+00-19-AD   (hex)		BOBST SA
+0019AD     (base 16)		BOBST SA
+				rte des flumeaux 50
+				PRILLY  VD  1008
+				CH
+
+00-19-A2   (hex)		ORDYN TECHNOLOGIES
+0019A2     (base 16)		ORDYN TECHNOLOGIES
+				Ozone Manay Tech Park, 
+				Bangalore     560 068
+				IN
+
+00-19-A5   (hex)		RadarFind Corporation
+0019A5     (base 16)		RadarFind Corporation
+				2100 Gateway Centre Blvd., Suite 150
+				Morrisville  NC  27560
+				US
+
+00-19-93   (hex)		Changshu Switchgear MFG. Co.,Ltd. (Former Changshu Switchgea
+001993     (base 16)		Changshu Switchgear MFG. Co.,Ltd. (Former Changshu Switchgea
+				No. 8 Jianye Road
+				Changshu  Jiangsu  215500
+				CN
+
+00-19-F1   (hex)		Star Communication Network Technology Co.,Ltd
+0019F1     (base 16)		Star Communication Network Technology Co.,Ltd
+				10/F,Tower B,SOHO New Town,No.88 jianguoRoad,Chaoyang District
+				Beijing    100022
+				CN
+
+00-19-EC   (hex)		Sagamore Systems, Inc.
+0019EC     (base 16)		Sagamore Systems, Inc.
+				55 Middlesex Street
+				North Chelmsford  MA  01863
+				US
+
+00-19-CC   (hex)		RCG (HK) Ltd
+0019CC     (base 16)		RCG (HK) Ltd
+				9/F., Core C, Cyberport 3
+				    
+				HK
+
+00-19-C8   (hex)		AnyDATA Corporation
+0019C8     (base 16)		AnyDATA Corporation
+				18902 Bardeen Ave.
+				Irvine  CA  91612
+				US
+
+00-19-C4   (hex)		Infocrypt Inc.
+0019C4     (base 16)		Infocrypt Inc.
+				711, BYUCKSAN DIGITAL VALLEY 1 212-16,
+				Seoul    152-050
+				KR
+
+00-19-BC   (hex)		ELECTRO CHANCE SRL
+0019BC     (base 16)		ELECTRO CHANCE SRL
+				CARHUE 3179
+				CAPITAL FEDERAL  BUENOS AIRES  1440
+				AR
+
+00-19-9B   (hex)		Diversified Technical Systems, Inc.
+00199B     (base 16)		Diversified Technical Systems, Inc.
+				909 Electric Avenue
+				Seal Beach  California  90740
+				US
+
+00-19-90   (hex)		ELM DATA Co., Ltd.
+001990     (base 16)		ELM DATA Co., Ltd.
+				2-15 TECHNO-PARK 1-CHOME
+				SAPPORO  HOKKAIDO  004-0015
+				JP
+
+00-19-8F   (hex)		Nokia Bell N.V.
+00198F     (base 16)		Nokia Bell N.V.
+				Copernicuslaan 50
+				Antwerp    B-2018
+				BE
+
+00-19-D8   (hex)		MAXFOR
+0019D8     (base 16)		MAXFOR
+				#E 809, Bundang, Techno-Park
+				Seongnam-City  Gyeonggi-Do  463-760
+				KR
+
+00-19-D5   (hex)		IP Innovations, Inc.
+0019D5     (base 16)		IP Innovations, Inc.
+				1517 146th Ave
+				Dorr  MI  49323
+				US
+
+00-19-A3   (hex)		asteel electronique atlantique
+0019A3     (base 16)		asteel electronique atlantique
+				za de la lande de saint jean
+				sainte marie de redon    35600
+				FR
+
+00-19-EA   (hex)		TeraMage Technologies Co., Ltd.
+0019EA     (base 16)		TeraMage Technologies Co., Ltd.
+				Golden Land Building Suite 907
+				Beijing    100016
+				CN
+
+00-19-6E   (hex)		Metacom (Pty) Ltd.
+00196E     (base 16)		Metacom (Pty) Ltd.
+				6 Ndabeni Business Park
+				Cape Town  Western Cape  7405
+				ZA
+
+00-19-65   (hex)		YuHua TelTech (ShangHai) Co., Ltd.
+001965     (base 16)		YuHua TelTech (ShangHai) Co., Ltd.
+				YuHua R&D Building,27 xin jin qiao road,
+				SHANGHAI    201206
+				CN
+
+00-19-66   (hex)		Asiarock Technology Limited
+001966     (base 16)		Asiarock Technology Limited
+				P.O. Box957, Offshore Incorporations Centre
+				Road Town  Tortola  
+				VG
+
+00-19-7B   (hex)		Picotest Corp.
+00197B     (base 16)		Picotest Corp.
+				8F-1, 286-9, Hsin-Ya Rd., 80673
+				Kaohsiung    80673
+				TW
+
+00-19-73   (hex)		Zeugma Systems
+001973     (base 16)		Zeugma Systems
+				Suite 250
+				Richmond  BC  V6V 2R2
+				CA
+
+00-19-75   (hex)		Beijing Huisen networks technology Inc
+001975     (base 16)		Beijing Huisen networks technology Inc
+				Jia#2 of Xili of Baiyun road,Xicheng district
+				Beijing    100045
+				CN
+
+00-19-40   (hex)		Rackable Systems
+001940     (base 16)		Rackable Systems
+				1933 Milmont Drive
+				Milpitas  CA  95035
+				US
+
+00-19-3C   (hex)		HighPoint Technologies Incorporated
+00193C     (base 16)		HighPoint Technologies Incorporated
+				1161 Cadillac Court
+				Milpitas  CA  95035
+				US
+
+00-19-5C   (hex)		Innotech Corporation
+00195C     (base 16)		Innotech Corporation
+				3-17-6
+				Yokohama  Kanagawa  222-8580
+				JP
+
+00-19-5F   (hex)		Valemount Networks Corporation
+00195F     (base 16)		Valemount Networks Corporation
+				1201- 5th Ave
+				Valemount  BC  V0E2Z0
+				CA
+
+00-19-48   (hex)		AireSpider Networks
+001948     (base 16)		AireSpider Networks
+				1171 Montague Express Way
+				Milpitas  CA  95035
+				US
+
+00-19-43   (hex)		Belden
+001943     (base 16)		Belden
+				793 Fort Mill Highway
+				Fort Mill  South Carolina  29715
+				US
+
+00-19-2E   (hex)		Spectral Instruments, Inc.
+00192E     (base 16)		Spectral Instruments, Inc.
+				420 N Bonita Ave
+				Tucson  AZ  85745
+				US
+
+00-19-2B   (hex)		Aclara RF Systems Inc.
+00192B     (base 16)		Aclara RF Systems Inc.
+				30400 Solon Road
+				Solon  OH  44139
+				US
+
+00-19-1E   (hex)		Beyondwiz Co., Ltd.
+00191E     (base 16)		Beyondwiz Co., Ltd.
+				3F, Daechang Bldg.,
+				Sungnam  Kyungki-do  463-825
+				KR
+
+00-19-81   (hex)		Vivox Inc
+001981     (base 16)		Vivox Inc
+				40 Speen Street
+				Framingham  MA  01701
+				US
+
+00-19-45   (hex)		RF COncepts, LLC
+001945     (base 16)		RF COncepts, LLC
+				1148 Wagner Drive 
+				Sevierville  TN  37862
+				US
+
+00-19-1F   (hex)		Microlink communications Inc.
+00191F     (base 16)		Microlink communications Inc.
+				8F , 31 , Hsintai Road , Chupei City , Hsinchu
+				Chupei  Taiwan  302
+				TW
+
+00-19-20   (hex)		KUME electric Co.,Ltd.
+001920     (base 16)		KUME electric Co.,Ltd.
+				4-2-24 Kitakawara
+				Itami-city  Hyougo  
+				JP
+
+00-19-26   (hex)		BitsGen Co., Ltd.
+001926     (base 16)		BitsGen Co., Ltd.
+				#502, Owner's Tower, #16-5, Sunea-dong
+				Bundang-gu  Seongnam-si  463-825
+				KR
+
+00-19-29   (hex)		2M2B Montadora de Maquinas Bahia Brasil LTDA
+001929     (base 16)		2M2B Montadora de Maquinas Bahia Brasil LTDA
+				Rua Djalma dutra, 668, Sete Portas
+				Salvador  Bahia  40240080
+				BR
+
+00-18-F1   (hex)		Chunichi Denshi Co.,LTD.
+0018F1     (base 16)		Chunichi Denshi Co.,LTD.
+				1 Denjiyama
+				Nagoya  Aichi  458-8525
+				JP
+
+00-18-F2   (hex)		Beijing Tianyu Communication Equipment Co., Ltd
+0018F2     (base 16)		Beijing Tianyu Communication Equipment Co., Ltd
+				27th Floor, Tengda Plaza
+				Beijing    100044
+				CN
+
+00-18-EC   (hex)		Welding Technology Corporation
+0018EC     (base 16)		Welding Technology Corporation
+				24775 Crestview Court
+				Farmington Hills  MI  48335
+				US
+
+00-18-ED   (hex)		Accutech Ultrasystems Co., Ltd.
+0018ED     (base 16)		Accutech Ultrasystems Co., Ltd.
+				11F-4, No. 150,
+				CHUNG-HO CITY,  TAIPEI HSIEN,  235
+				TW
+
+00-19-0B   (hex)		Southern Vision Systems, Inc.
+00190B     (base 16)		Southern Vision Systems, Inc.
+				8215 Madison Blvd, Suite 150
+				Madison  AL  35758
+				US
+
+00-19-03   (hex)		Bigfoot Networks Inc
+001903     (base 16)		Bigfoot Networks Inc
+				3925 West Braker Lane
+				Austin  TX  78759
+				US
+
+00-19-00   (hex)		Intelliverese - DBA Voicecom
+001900     (base 16)		Intelliverese - DBA Voicecom
+				5900 Windward Parkway
+				Alpharetta  Georgia  30005
+				US
+
+00-19-02   (hex)		Cambridge Consultants Ltd
+001902     (base 16)		Cambridge Consultants Ltd
+				Science Park
+				Cambridge  Cambs  CB4 0DW
+				GB
+
+00-19-2A   (hex)		Antiope Associates
+00192A     (base 16)		Antiope Associates
+				18 Clay Street
+				Fair Haven  New Jersey  07704
+				US
+
+00-19-0F   (hex)		Advansus Corp.
+00190F     (base 16)		Advansus Corp.
+				No.5 Shing Yeh Street, Kwei Hsiang
+				Taoyuan    333
+				TW
+
+00-19-11   (hex)		Just In Mobile Information Technologies (Shanghai) Co., Ltd.
+001911     (base 16)		Just In Mobile Information Technologies (Shanghai) Co., Ltd.
+				5th Floor, 2nd Area, Haiwangxing Building, 62 Xingguang Ave., N.High-Tech Park
+				Chongqing    401121
+				CN
+
+00-18-E0   (hex)		ANAVEO
+0018E0     (base 16)		ANAVEO
+				Les Carrés du parc
+				CHAMPAGNE au MONT D'OR  Rhône  F-69410
+				FR
+
+00-19-17   (hex)		Posiflex Inc.
+001917     (base 16)		Posiflex Inc.
+				6, Wu-Chuan Road
+				Taipei Hsien    248
+				TW
+
+00-19-18   (hex)		Interactive Wear AG
+001918     (base 16)		Interactive Wear AG
+				Petersbrunner Strasse 3
+				Starnberg  Bayern  82319
+				DE
+
+00-18-CB   (hex)		Tecobest Technology Limited
+0018CB     (base 16)		Tecobest Technology Limited
+				53/F.,Block A,United Plaza,
+				Shenzhen  Guangdong  518026
+				CN
+
+00-18-CE   (hex)		Dreamtech Co., Ltd
+0018CE     (base 16)		Dreamtech Co., Ltd
+				#340-5, Yang-dang Ri, Jik-san Myeon
+				Cheon-an si  Chung-Nam  330810
+				KR
+
+00-18-94   (hex)		NPCore, Inc.
+001894     (base 16)		NPCore, Inc.
+				1001, ISBIZ Tower
+				Youngdungpo Gu  Seoul  150-105
+				KR
+
+00-18-98   (hex)		KINGSTATE ELECTRONICS CORPORATION
+001898     (base 16)		KINGSTATE ELECTRONICS CORPORATION
+				10F, No.69-11, Sec.2, Chung Cheng E. Rd.,
+				Taipei County    251
+				TW
+
+00-18-92   (hex)		ads-tec GmbH
+001892     (base 16)		ads-tec GmbH
+				Raiffeisenstrasse 14
+				Leinfelden-Echterdingen  BW  70771
+				DE
+
+00-18-91   (hex)		Zhongshan General K-mate Electronics Co., Ltd
+001891     (base 16)		Zhongshan General K-mate Electronics Co., Ltd
+				3/F B1 Building, Fuwan Ind. Zone Sun Wen East Road
+				Zhongshan  Guangdong  528403
+				CN
+
+00-18-AD   (hex)		NIDEC SANKYO CORPORATION
+0018AD     (base 16)		NIDEC SANKYO CORPORATION
+				5329, Shimosuwa-machi, Suwa-gun
+				  Nagano  393-8511
+				JP
+
+00-18-AC   (hex)		Shanghai Jiao Da HISYS Technology Co. Ltd.
+0018AC     (base 16)		Shanghai Jiao Da HISYS Technology Co. Ltd.
+				7F Haoran HiTech Bldg., No.1954 Huashan Road
+				shanghai  xuhui  200030
+				US
+
+00-18-AB   (hex)		BEIJING LHWT MICROELECTRONICS INC.
+0018AB     (base 16)		BEIJING LHWT MICROELECTRONICS INC.
+				18/F,QUANTUM PLAZA,NO.27 ZHI CHUN RD.,HAI DIAN DISTRICT,BEIJING
+				    
+				CN
+
+00-18-A5   (hex)		ADigit Technologies Corp.
+0018A5     (base 16)		ADigit Technologies Corp.
+				Rm D302E,No.185 3F-2,Kur-Wong Road,
+				Tao-yuan,    325
+				TW
+
+00-18-78   (hex)		Mackware GmbH
+001878     (base 16)		Mackware GmbH
+				Schänzle 13
+				Waiblingen  Baden-Württemberg  71332
+				DE
+
+00-18-6A   (hex)		Global Link Digital Technology Co,.LTD
+00186A     (base 16)		Global Link Digital Technology Co,.LTD
+				Qibaoyiding Ind.Area
+				Dongguan  Guangdong  523051
+				CN
+
+00-18-6B   (hex)		Sambu Communics CO., LTD.
+00186B     (base 16)		Sambu Communics CO., LTD.
+				38B-1L Namdong Industrial Complex
+				Incheon    405-100
+				KR
+
+00-18-6E   (hex)		3Com Ltd
+00186E     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-18-A6   (hex)		Persistent Systems, LLC
+0018A6     (base 16)		Persistent Systems, LLC
+				118 N. Howard St. #72
+				Baltimore  MD  21201
+				US
+
+00-18-9B   (hex)		Thomson Inc.
+00189B     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290-1102
+				US
+
+00-18-B2   (hex)		ADEUNIS RF
+0018B2     (base 16)		ADEUNIS RF
+				283 Rue NEEL
+				CROLLES  ISERE  38920
+				FR
+
+00-18-B3   (hex)		TEC WizHome Co., Ltd.
+0018B3     (base 16)		TEC WizHome Co., Ltd.
+				18fl., In-Song bldg., 194-15,
+				Seoul    100-952
+				KR
+
+00-18-BD   (hex)		SHENZHEN DVBWORLD TECHNOLOGY CO., LTD.
+0018BD     (base 16)		SHENZHEN DVBWORLD TECHNOLOGY CO., LTD.
+				2ND FLOOR, BUILDING A, QINGHU XINQIAO INDUSTRY AREA,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+00-18-67   (hex)		Datalogic ADC
+001867     (base 16)		Datalogic ADC
+				433 N. Fair Oaks Ave
+				Pasadena  CA  91103
+				US
+
+00-18-65   (hex)		Siemens Healthcare Diagnostics Manufacturing Ltd
+001865     (base 16)		Siemens Healthcare Diagnostics Manufacturing Ltd
+				Northern Road
+				Sudbury  Suffolk  C010 2XQ
+				GB
+
+00-18-77   (hex)		Amplex A/S
+001877     (base 16)		Amplex A/S
+				Silkeborgvej 2
+				Aarhus C    8000
+				DK
+
+00-18-89   (hex)		WinNet Solutions Limited
+001889     (base 16)		WinNet Solutions Limited
+				Rm804, Kornhill Metro Tower, Quarry Bay
+				  HK  852
+				HK
+
+00-17-F9   (hex)		Forcom Sp. z o.o.
+0017F9     (base 16)		Forcom Sp. z o.o.
+				Gajowa 6
+				Poznan  WLKP  60-815
+				PL
+
+00-17-F4   (hex)		ZERON ALLIANCE
+0017F4     (base 16)		ZERON ALLIANCE
+				 3F DOORI BUILD. 244-14 bunji, Poi-dong, Gangnam-gu
+				SEOUL    135-965
+				KR
+
+00-17-F7   (hex)		CEM Solutions Pvt Ltd
+0017F7     (base 16)		CEM Solutions Pvt Ltd
+				49,Kanija Bhavan
+				Bangalore  Karnataka  560 001
+				IN
+
+00-17-ED   (hex)		WooJooIT Ltd.
+0017ED     (base 16)		WooJooIT Ltd.
+				Hankooktire B/D 4th floor, 501-19,
+				Yangcheon-gu,  Seoul  158-839
+				KR
+
+00-18-43   (hex)		Dawevision Ltd
+001843     (base 16)		Dawevision Ltd
+				197 High Street
+				Cottenham  Cambridge  CB4 8RX
+				GB
+
+00-18-2C   (hex)		Ascend Networks, Inc.
+00182C     (base 16)		Ascend Networks, Inc.
+				No. 4 - 4, Lane 413, ChungChan Road,
+				BenQuao City  Taipei  220
+				TW
+
+00-18-1D   (hex)		ASIA ELECTRONICS CO.,LTD
+00181D     (base 16)		ASIA ELECTRONICS CO.,LTD
+				620-3 DOCHEON-DONG
+				GWANGJU    506-301
+				KR
+
+00-18-1F   (hex)		Palmmicro Communications
+00181F     (base 16)		Palmmicro Communications
+				Room 0611, Bldg.B Tsinghua Tongfang Technology Plaza
+				Beijing    100083
+				CN
+
+00-18-1B   (hex)		TaiJin Metal Co., Ltd.
+00181B     (base 16)		TaiJin Metal Co., Ltd.
+				#95-9, Hangdong7-Ga, Joong-Gu
+				In Cheon    400-037
+				KR
+
+00-18-05   (hex)		Beijing InHand Networking Technology Co.,Ltd.
+001805     (base 16)		Beijing InHand Networking Technology Co.,Ltd.
+				West Wing 11th Floor of Qiming International Mansion
+				Beijing    100085
+				CN
+
+00-18-0D   (hex)		Terabytes Server Storage Tech Corp
+00180D     (base 16)		Terabytes Server Storage Tech Corp
+				14257 E Don Julian Rd
+				City of Industry  CA  91746
+				US
+
+00-18-54   (hex)		Argard Co., Ltd
+001854     (base 16)		Argard Co., Ltd
+				2571 Lardprao Rd.
+				wangthonglang  Bangkok  10310
+				TH
+
+00-18-47   (hex)		AceNet Technology Inc.
+001847     (base 16)		AceNet Technology Inc.
+				133 Vienna Dr.
+				Milpitas  CA  95035
+				US
+
+00-18-36   (hex)		REJ Co.,Ltd
+001836     (base 16)		REJ Co.,Ltd
+				2-3-2 Fukuura, Kanazawa-ku
+				Yokohama  Kanagawa  236-8641
+				JP
+
+00-17-CC   (hex)		Alcatel-Lucent
+0017CC     (base 16)		Alcatel-Lucent
+				601 Data Dr.
+				Plano  TX  75075
+				US
+
+00-17-C4   (hex)		Quanta Microsystems, INC.
+0017C4     (base 16)		Quanta Microsystems, INC.
+				188 Wenhwa 2nd RD., Kueishan Hsiang
+				Taoyuan Shien    333
+				TW
+
+00-17-9E   (hex)		Sirit Inc
+00179E     (base 16)		Sirit Inc
+				2525 Meridian Parkway
+				Durham  NC  27713
+				US
+
+00-17-A7   (hex)		Mobile Computing Promotion Consortium
+0017A7     (base 16)		Mobile Computing Promotion Consortium
+				3-5-12 Shiba-Koen
+				Tokyo    105-0011
+				JP
+
+00-17-9F   (hex)		Apricorn
+00179F     (base 16)		Apricorn
+				12191 Kirkham RD
+				Poway  California  92064
+				US
+
+00-17-B4   (hex)		Remote Security Systems, LLC
+0017B4     (base 16)		Remote Security Systems, LLC
+				4806 Upper Brandon Place
+				Marietta  Georgia  30068
+				US
+
+00-17-AC   (hex)		O'Neil Product Development Inc.
+0017AC     (base 16)		O'Neil Product Development Inc.
+				8 Mason
+				Irvine  CA  92618
+				US
+
+00-17-AD   (hex)		AceNet Corporation
+0017AD     (base 16)		AceNet Corporation
+				7F-4, No.146, Wen-Shin Road
+				Gueishan  TAOYUAN  
+				TW
+
+00-17-DD   (hex)		Clipsal Australia
+0017DD     (base 16)		Clipsal Australia
+				33-37 Port Wakefield Rd
+				Gepps Cross  South Australia  5094
+				AU
+
+00-17-D9   (hex)		AAI Corporation
+0017D9     (base 16)		AAI Corporation
+				P.O. Box 126
+				Hunt Valley  Maryland  21030
+				US
+
+00-17-DC   (hex)		DAEMYUNG ZERO1
+0017DC     (base 16)		DAEMYUNG ZERO1
+				#809,Hyosung Intellian
+				Anyang-si  Gyeonggi-do  431-060
+				KR
+
+00-17-BF   (hex)		Coherent Research Limited
+0017BF     (base 16)		Coherent Research Limited
+				8 Princess Mews
+				Kingston upon Thames  Surrey  KT1 2SZ
+				GB
+
+00-17-BD   (hex)		Tibetsystem
+0017BD     (base 16)		Tibetsystem
+				6F IT Castle II 550-1 Gasan-dong
+				Seoul  Geumcheon-gu  153-803
+				KR
+
+00-17-A1   (hex)		3soft inc.
+0017A1     (base 16)		3soft inc.
+				shinyoung bldg 4f, chungdam-dong, gangnam-gu
+				seoul    135-100
+				KR
+
+00-17-92   (hex)		Falcom Wireless Comunications Gmbh
+001792     (base 16)		Falcom Wireless Comunications Gmbh
+				Gewerbering 6
+				Langewiesen  Thuringia  98704
+				DE
+
+00-17-97   (hex)		Telsy Elettronica S.p.A.
+001797     (base 16)		Telsy Elettronica S.p.A.
+				Corso Svizzera 185
+				Torino    10149
+				IT
+
+00-17-8C   (hex)		Independent Witness, Inc
+00178C     (base 16)		Independent Witness, Inc
+				1515 West 2200 South
+				Salt Lake City  UT  84119
+				US
+
+00-17-CB   (hex)		Juniper Networks
+0017CB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-17-D3   (hex)		Etymotic Research, Inc.
+0017D3     (base 16)		Etymotic Research, Inc.
+				61 Martin Lane
+				Elk Grove Village  IL  60061
+				US
+
+00-17-88   (hex)		Philips Lighting BV
+001788     (base 16)		Philips Lighting BV
+				High Tech Campus 45
+				Eindhoven  Noord Brabant  5656 AE
+				NL
+
+00-17-3C   (hex)		Extreme Engineering Solutions
+00173C     (base 16)		Extreme Engineering Solutions
+				7878 Big Sky Drive
+				Madison  WI  53719
+				US
+
+00-17-36   (hex)		iiTron Inc.
+001736     (base 16)		iiTron Inc.
+				88 Mercy St.
+				Mountain View  CA  94041
+				US
+
+00-17-37   (hex)		Industrie Dial Face S.p.A.
+001737     (base 16)		Industrie Dial Face S.p.A.
+				via Canzo, 4
+				Peschiera Borromeo  Milano  20068
+				IT
+
+00-17-33   (hex)		SFR
+001733     (base 16)		SFR
+				42 Quai du point du jour
+				Boulogne Billancourt  Hauts de Seine  92659
+				FR
+
+00-17-58   (hex)		ThruVision Ltd
+001758     (base 16)		ThruVision Ltd
+				Central 127, No.18
+				Abingdon  Oxfordshire  OX14 4SA
+				GB
+
+00-17-4F   (hex)		iCatch Inc.
+00174F     (base 16)		iCatch Inc.
+				10F-2, No. 109, Sec. 6, Mincyuan E. Rd.,
+				Taipei    114
+				TW
+
+00-17-4A   (hex)		SOCOMEC
+00174A     (base 16)		SOCOMEC
+				rue de Westhouse
+				BENFELD CEDEX    67235
+				FR
+
+00-17-4E   (hex)		Parama-tech Co.,Ltd.
+00174E     (base 16)		Parama-tech Co.,Ltd.
+				2-19-8, Sharyo, Higashi-ku
+				Fukuoka    812-0068
+				JP
+
+00-17-6F   (hex)		PAX Computer Technology(Shenzhen) Ltd.
+00176F     (base 16)		PAX Computer Technology(Shenzhen) Ltd.
+				4/F, No.3 Building, Software Park, Second Central Science-Tech Road, High-Tech
+				Shenzhen  GuangDong  518057
+				CN
+
+00-17-71   (hex)		APD Communications Ltd
+001771     (base 16)		APD Communications Ltd
+				Newlands Centre
+				HULL    HU6 7TQ
+				GB
+
+00-17-5B   (hex)		ACS Solutions Switzerland Ltd.
+00175B     (base 16)		ACS Solutions Switzerland Ltd.
+				Frankenstrasse 70
+				Bern- Buempliz    3018
+				CH
+
+00-17-29   (hex)		Ubicod Co.LTD
+001729     (base 16)		Ubicod Co.LTD
+				7F Chun-gin Bldg, 53-5 Wonhyo-ro
+				Seoul    140-719
+				KR
+
+00-17-27   (hex)		Thermo Ramsey Italia s.r.l.
+001727     (base 16)		Thermo Ramsey Italia s.r.l.
+				Strada Rivoltana km 6/7
+				Rodano  Milano  20090
+				IT
+
+00-17-2A   (hex)		Proware Technology Corp.(By Unifosa)
+00172A     (base 16)		Proware Technology Corp.(By Unifosa)
+				6Fl., No. 4, Alley 1, Lane 235, PaoChao Rd., Sindian Dist.,
+				New Taipei City    231
+				TW
+
+00-17-25   (hex)		Liquid Computing
+001725     (base 16)		Liquid Computing
+				340 Terry Fox Drive
+				Ottawa  Ontario  K2K 3A2
+				CA
+
+00-17-64   (hex)		ATMedia GmbH
+001764     (base 16)		ATMedia GmbH
+				Stuhlsatzenhausweg 69
+				Saarbruecken  Saarland  66123
+				DE
+
+00-17-5E   (hex)		Zed-3
+00175E     (base 16)		Zed-3
+				501 Valley Way
+				Milpitas  CA  95035
+				US
+
+00-17-66   (hex)		Accense Technology, Inc.
+001766     (base 16)		Accense Technology, Inc.
+				35 Tansumachi
+				Shinjyuku-ku  Tokyo  1620833
+				JP
+
+00-16-D0   (hex)		ATech elektronika d.o.o.
+0016D0     (base 16)		ATech elektronika d.o.o.
+				Bac pri Materiji 30
+				Materija  SI  6242
+				SI
+
+00-16-C3   (hex)		BA Systems Inc
+0016C3     (base 16)		BA Systems Inc
+				6895 Via Del Oro
+				San Jose  CA  95119
+				US
+
+00-16-F0   (hex)		Dell
+0016F0     (base 16)		Dell
+				909 Hermosa Ct
+				Sunnyvale  CA  94085
+				US
+
+00-16-F8   (hex)		AVIQTECH TECHNOLOGY CO., LTD.
+0016F8     (base 16)		AVIQTECH TECHNOLOGY CO., LTD.
+				6F 12, Li-hsin Road, SBIP
+				Hsin-chu    300
+				TW
+
+00-16-E8   (hex)		Sigma Designs, Inc.
+0016E8     (base 16)		Sigma Designs, Inc.
+				1778 McCarthy Blvd.
+				Milpitas  CA  95035
+				US
+
+00-17-03   (hex)		MOSDAN Internation Co.,Ltd
+001703     (base 16)		MOSDAN Internation Co.,Ltd
+				No.216 Xiwei,Shanhua Dist,
+				Tainan    741
+				TW
+
+00-16-FC   (hex)		TOHKEN CO.,LTD.
+0016FC     (base 16)		TOHKEN CO.,LTD.
+				2-16-20 Tamagawa
+				Chofu  Tokyo  182-0025
+				JP
+
+00-16-E9   (hex)		Tiba Medical Inc
+0016E9     (base 16)		Tiba Medical Inc
+				5024 Lakewood Drive
+				Plano  TX  75093
+				US
+
+00-16-DC   (hex)		ARCHOS
+0016DC     (base 16)		ARCHOS
+				12 rue AMPERE
+				IGNY  ESSONNES  91430
+				FR
+
+00-17-14   (hex)		BR Controls Nederland bv
+001714     (base 16)		BR Controls Nederland bv
+				Branderweg 1
+				Zwolle  Overijssel  8042 PD
+				NL
+
+00-17-1B   (hex)		Innovation Lab Corp.
+00171B     (base 16)		Innovation Lab Corp.
+				12FL., No. 285, Sec. 2, TiDing Blvd.,
+				Taipei    11493
+				TW
+
+00-17-09   (hex)		Exalt Communications
+001709     (base 16)		Exalt Communications
+				580 Division Street
+				Campbell  CA  95008
+				US
+
+00-16-C1   (hex)		Eleksen Ltd
+0016C1     (base 16)		Eleksen Ltd
+				Pinewood Studios
+				Iver  Bucks  SL0 0NH
+				US
+
+00-16-A9   (hex)		2EI
+0016A9     (base 16)		2EI
+				Rua dos Rubis, 77 - Assumpcao
+				Aguas de Lindoia  São Paulo  13940-000
+				BR
+
+00-16-B0   (hex)		VK Corporation
+0016B0     (base 16)		VK Corporation
+				VK B/D, 548-6, Anyang 8dong, Manan-gu
+				Anyang  Kyounggi  430-8903
+				KR
+
+00-16-B1   (hex)		KBS
+0016B1     (base 16)		KBS
+				88 rue Pierre Sémard
+				Moissy cedex  Ile de France  77552
+				FR
+
+00-16-AE   (hex)		INVENTEL
+0016AE     (base 16)		INVENTEL
+				35 rue Tournefort
+				PARIS    75005
+				FR
+
+00-16-AC   (hex)		Toho Technology Corp.
+0016AC     (base 16)		Toho Technology Corp.
+				HIGASHI 5-1
+				INAZAWA-CITY  AICHI  492-8501
+				JP
+
+00-16-83   (hex)		WEBIO International Co.,.Ltd.
+001683     (base 16)		WEBIO International Co.,.Ltd.
+				21F.,No.171 Songde Rd.,Sinyi District
+				Taipei    11085
+				TW
+
+00-16-84   (hex)		Donjin Co.,Ltd.
+001684     (base 16)		Donjin Co.,Ltd.
+				21F,Cangsong Building,Tairan,Futian
+				Shenzhen  Guangdong  518040
+				CN
+
+00-16-87   (hex)		Chubb CSC-Vendor AP
+001687     (base 16)		Chubb CSC-Vendor AP
+				Ottawa STN
+				Ottawa    K1G 6W6
+				CA
+
+00-16-7F   (hex)		Bluebird Soft Inc.
+00167F     (base 16)		Bluebird Soft Inc.
+				562-21 Gangnam-gu,
+				Seoul    135-890
+				KR
+
+00-16-4C   (hex)		PLANET INT Co., Ltd
+00164C     (base 16)		PLANET INT Co., Ltd
+				8th Floor, Saeum B/D, 1361-5
+				Seoul    137-070
+				KR
+
+00-16-49   (hex)		SetOne GmbH
+001649     (base 16)		SetOne GmbH
+				Hegenheimer Str. 2
+				Weil am Rhein    D-79576
+				DE
+
+00-16-47   (hex)		Cisco Systems, Inc
+001647     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-16-65   (hex)		Cellon France
+001665     (base 16)		Cellon France
+				Route d'Angers Le Mans cedex 9
+				Le Mans  Sarthe  72081
+				FR
+
+00-16-5F   (hex)		Fairmount Automation
+00165F     (base 16)		Fairmount Automation
+				4621 West Chester Pike
+				Newtown Square  PA  19073
+				US
+
+00-16-7C   (hex)		iRex Technologies BV
+00167C     (base 16)		iRex Technologies BV
+				HighTech Campus
+				Eindhoven  Brabant  5656AE
+				NL
+
+00-16-73   (hex)		Bury GmbH & Co. KG
+001673     (base 16)		Bury GmbH & Co. KG
+				Robert-Koch-Str. 1-7
+				Loehne  Germany  32584
+				DE
+
+00-16-94   (hex)		Sennheiser Communications A/S
+001694     (base 16)		Sennheiser Communications A/S
+				Langager 6
+				Solrød Strand  Copenhagen  2680
+				DK
+
+00-16-9C   (hex)		Cisco Systems, Inc
+00169C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-16-57   (hex)		Aegate Ltd
+001657     (base 16)		Aegate Ltd
+				Technology Centre
+				Melbourn  Hertfordshire  SG8 6DP
+				GB
+
+00-16-8C   (hex)		DSL Partner AS
+00168C     (base 16)		DSL Partner AS
+				Havreveien 49
+				Oslo    0680
+				NO
+
+00-16-1B   (hex)		Micronet Corporation
+00161B     (base 16)		Micronet Corporation
+				1788-388 Nomura Hirooka
+				Shiojiri-shi  Nagano-ken  399-0702
+				JP
+
+00-16-18   (hex)		HIVION Co., Ltd.
+001618     (base 16)		HIVION Co., Ltd.
+				2F., Akyung Bldg., 54-10, Munjeong-dong,
+				Songpa-Gu  Seoul  
+				KR
+
+00-16-1E   (hex)		Woojinnet
+00161E     (base 16)		Woojinnet
+				292 osan dongtan
+				hwaseong  kyonggi  445-813
+				KR
+
+00-16-1F   (hex)		SUNWAVETEC Co., Ltd.
+00161F     (base 16)		SUNWAVETEC Co., Ltd.
+				#823, Kwanyang-dong, Dongan-ku
+				Anyang-si  Kyungki-do  431-060
+				US
+
+00-16-14   (hex)		Picosecond Pulse Labs
+001614     (base 16)		Picosecond Pulse Labs
+				2500 55th Street
+				Boulder  CO  80301
+				US
+
+00-16-0E   (hex)		Optica Technologies Inc.
+00160E     (base 16)		Optica Technologies Inc.
+				2051 Dogwood Street
+				Louisville  CO  80027
+				US
+
+00-16-43   (hex)		Sunhillo Corporation
+001643     (base 16)		Sunhillo Corporation
+				444 Kelley Drive
+				West Berlin  New Jersey  08091
+				US
+
+00-16-44   (hex)		LITE-ON Technology Corp.
+001644     (base 16)		LITE-ON Technology Corp.
+				18F, No.392, Ruey Kuang Road, Niehu,
+				Taipei    114
+				TW
+
+00-16-3E   (hex)		Xensource, Inc.
+00163E     (base 16)		Xensource, Inc.
+				2300 Geng Rd.
+				Palo Alto  CA  94303
+				US
+
+00-15-FD   (hex)		Complete Media Systems
+0015FD     (base 16)		Complete Media Systems
+				Grove Place
+				Warninglid  West sussex  RH17 5SN
+				GB
+
+00-15-F6   (hex)		SCIENCE AND ENGINEERING SERVICES, INC.
+0015F6     (base 16)		SCIENCE AND ENGINEERING SERVICES, INC.
+				4015 PULASKI PIKE NW
+				HUNTSVILLE  AL  35810
+				US
+
+00-16-34   (hex)		Mathtech, Inc.
+001634     (base 16)		Mathtech, Inc.
+				6402 Arlington Blvd.,
+				Falls Church  Virginia  22042-2356
+				US
+
+00-16-2C   (hex)		Xanboo
+00162C     (base 16)		Xanboo
+				115 West 30th, 6th Fl
+				New York  NY  10001
+				US
+
+00-16-05   (hex)		YORKVILLE SOUND INC.
+001605     (base 16)		YORKVILLE SOUND INC.
+				4625 WITMER INDUSTRIAL ESTATE
+				NIAGARA FALLS  NY  14305
+				US
+
+00-15-F9   (hex)		Cisco Systems, Inc
+0015F9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-E3   (hex)		Dream Technologies Corporation
+0015E3     (base 16)		Dream Technologies Corporation
+				Ebisu Prime Square, 1-1-39 Hiroo
+				Tokyo    150-0012
+				JP
+
+00-15-E0   (hex)		Ericsson
+0015E0     (base 16)		Ericsson
+				Nya Vattentornet
+				Lund    SE-221 83
+				NO
+
+00-15-F3   (hex)		PELTOR AB
+0015F3     (base 16)		PELTOR AB
+				Box 2341
+				SE-331 02  Värnamo    SE-331 02
+				SE
+
+00-15-E7   (hex)		Quantec Tontechnik
+0015E7     (base 16)		Quantec Tontechnik
+				Mittenwalderstr.63
+				München    D-81377
+				DE
+
+00-15-D3   (hex)		Pantech&Curitel Communications, Inc.
+0015D3     (base 16)		Pantech&Curitel Communications, Inc.
+				1451-34, Seocho-dong, Seocho-Gu
+				Seoul    137-070
+				KR
+
+00-15-AD   (hex)		Accedian Networks
+0015AD     (base 16)		Accedian Networks
+				4878 Levy, suite 202
+				St-Laurent  Quebec  H9P 2V4
+				CA
+
+00-15-AC   (hex)		Capelon AB
+0015AC     (base 16)		Capelon AB
+				Jägerhorns  väg 1
+				Kungens Kurva  Stockholm  S-141 75
+				SE
+
+00-15-A9   (hex)		KWANG WOO I&C CO.,LTD
+0015A9     (base 16)		KWANG WOO I&C CO.,LTD
+				898-23, Hogye-dong,Dongan-gu
+				    431-080
+				KR
+
+00-E0-A8   (hex)		SAT GmbH & Co.
+00E0A8     (base 16)		SAT GmbH & Co.
+				RUTHNERGASSE 1
+				VIENNA A-1210    
+				AT
+
+00-15-74   (hex)		Horizon Semiconductors Ltd.
+001574     (base 16)		Horizon Semiconductors Ltd.
+				9 Hamenofim St.
+				Herzliya    46120
+				IL
+
+00-15-8A   (hex)		SURECOM Technology Corp.
+00158A     (base 16)		SURECOM Technology Corp.
+				6F, No. 125, Sec. 2, Datung Rd.
+				Shijr City, Taipei County    221
+				TW
+
+00-15-8E   (hex)		Plustek.INC
+00158E     (base 16)		Plustek.INC
+				13F-1,No3(Building F) Yuan Qu Street
+				Taipei  Yuan Qu  115
+				TW
+
+00-15-89   (hex)		D-MAX Technology Co.,Ltd
+001589     (base 16)		D-MAX Technology Co.,Ltd
+				7F-6,NO.26,Lian Cheng RD.,Chung-Ho City
+				Taipei Hsien    235
+				US
+
+00-15-B4   (hex)		Polymap  Wireless LLC
+0015B4     (base 16)		Polymap  Wireless LLC
+				310 S. Williams Blvd. Ste. 350
+				Tucson  AZ  85711
+				US
+
+00-15-CA   (hex)		TeraRecon, Inc.
+0015CA     (base 16)		TeraRecon, Inc.
+				2955 Campus Drive, Suite 325
+				San Mateo  CA  94403
+				US
+
+00-15-98   (hex)		Kolektor group
+001598     (base 16)		Kolektor group
+				Vojkova 10
+				Idrija    5280
+				SI
+
+00-15-12   (hex)		Zurich University of Applied Sciences
+001512     (base 16)		Zurich University of Applied Sciences
+				Technikumstrasse 9
+				Winterthur  ZH  CH-8401
+				CH
+
+00-15-0A   (hex)		Sonoa Systems, Inc
+00150A     (base 16)		Sonoa Systems, Inc
+				3900 Freedom Circle
+				Santa Clara  CA  95054
+				US
+
+00-15-70   (hex)		Zebra Technologies Inc
+001570     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+00-15-6E   (hex)		A. W. Communication Systems Ltd
+00156E     (base 16)		A. W. Communication Systems Ltd
+				Crook Barn
+				Carlisle  Cumbria  CA6 6LH
+				GB
+
+00-15-68   (hex)		Dilithium Networks
+001568     (base 16)		Dilithium Networks
+				5401 Old Redwood Hwy
+				Petaluma  CA  94954
+				US
+
+00-15-4B   (hex)		Wonde Proud Technology Co., Ltd
+00154B     (base 16)		Wonde Proud Technology Co., Ltd
+				21F., No.100, Sec.1, Shintai 5th Rd
+				Sijhih city  Taipei County  221
+				TW
+
+00-15-48   (hex)		CUBE TECHNOLOGIES
+001548     (base 16)		CUBE TECHNOLOGIES
+				46 A CHEMIN DU MOULIN CARRON
+				69570 DARDILLY  FRANCE  
+				FR
+
+00-15-5F   (hex)		GreenPeak Technologies
+00155F     (base 16)		GreenPeak Technologies
+				Spinnerijstraat 14
+				Zele    9240
+				BE
+
+00-15-5A   (hex)		DAINIPPON PHARMACEUTICAL CO., LTD.
+00155A     (base 16)		DAINIPPON PHARMACEUTICAL CO., LTD.
+				2-6-8, DOSHOMACHI, CHUO-KU
+				OSAKA CITY  OSAKA PREF.  541-8524
+				JP
+
+00-15-1D   (hex)		M2I CORPORATION
+00151D     (base 16)		M2I CORPORATION
+				Kyonggi Venture Anyang technical center, 13th Floor, 572-5, Anyang 8-Dong, Manan-Gu
+				Anyang-Shi  Kyonggi-Do  430-731
+				KR
+
+00-15-3C   (hex)		Kprotech Co., Ltd.
+00153C     (base 16)		Kprotech Co., Ltd.
+				2nd Floor, # 202, Myoung-ji e-Space II
+				An-yang City  Gyeong-gi Do  430-817
+				KR
+
+00-15-3A   (hex)		Shenzhen Syscan Technology Co.,Ltd.
+00153A     (base 16)		Shenzhen Syscan Technology Co.,Ltd.
+				13F, Olympic Plaza,
+				Shenzhen  Guangdong  518034
+				CN
+
+00-15-32   (hex)		Consumer Technologies Group, LLC
+001532     (base 16)		Consumer Technologies Group, LLC
+				801 Brookhollow
+				Efland  NC  27243
+				US
+
+00-14-9B   (hex)		Nokota Communications, LLC
+00149B     (base 16)		Nokota Communications, LLC
+				200 Galleria Parkway
+				Atlanta  Georgia  30339
+				US
+
+00-14-A1   (hex)		Synchronous Communication Corp
+0014A1     (base 16)		Synchronous Communication Corp
+				9 floor, No168, Rueiguang Road, Neihu District
+				Taipei    114
+				TW
+
+00-14-9E   (hex)		UbONE Co., Ltd
+00149E     (base 16)		UbONE Co., Ltd
+				Shinyoung B.D. 602, SeoHyeon2-Dong
+				Seongnam-si  Gyeongg-do  463-824
+				KR
+
+00-14-A2   (hex)		Core Micro Systems Inc.
+0014A2     (base 16)		Core Micro Systems Inc.
+				Wacore Kaname-cho Bldg. 9F, 11-2, Nakamaru-cho
+				Itabashi-ku  Tokyo  173-0026
+				JP
+
+00-14-AD   (hex)		Gassner Wiege- und Meßtechnik GmbH
+0014AD     (base 16)		Gassner Wiege- und Meßtechnik GmbH
+				Münchner Bundesstraße
+				Salzburg    A-5020
+				AT
+
+00-14-AF   (hex)		Datasym POS Inc.
+0014AF     (base 16)		Datasym POS Inc.
+				45 Dalkeith Drive
+				Brantford  Ontario  N3P1M1
+				CA
+
+00-14-A9   (hex)		Cisco Systems, Inc
+0014A9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-FF   (hex)		Precise Automation, Inc.
+0014FF     (base 16)		Precise Automation, Inc.
+				1402 Alexandra Blvd
+				Crystal Lake  IL  60014
+				US
+
+00-14-FA   (hex)		AsGa S.A.
+0014FA     (base 16)		AsGa S.A.
+				Rod Roberto Moreira Km 04
+				Paulinia  São Paulo  13140-000
+				BR
+
+00-14-FB   (hex)		Technical Solutions Inc.
+0014FB     (base 16)		Technical Solutions Inc.
+				101-7188 Progress Way
+				Delta  BC  V4G 1M6
+				CA
+
+00-14-D2   (hex)		Kyuden Technosystems Corporation
+0014D2     (base 16)		Kyuden Technosystems Corporation
+				4-19-18 SHIMIZU,MINAMI-KU
+				FUKUOKA    815-0031
+				JP
+
+00-14-DC   (hex)		Communication System Design & Manufacturing (CSDM)
+0014DC     (base 16)		Communication System Design & Manufacturing (CSDM)
+				Postbus 181
+				Bussum  NH  1400 AD
+				NL
+
+00-14-CD   (hex)		DigitalZone Co., Ltd.
+0014CD     (base 16)		DigitalZone Co., Ltd.
+				No. 1001 E&C VentureDreamTower2
+				Seoul    152-848
+				KR
+
+00-14-C0   (hex)		Symstream Technology Group Ltd
+0014C0     (base 16)		Symstream Technology Group Ltd
+				Level 1, 3 Chester Street
+				Oakleigh  Victoria  3166
+				AU
+
+00-14-C1   (hex)		U.S. Robotics Corporation
+0014C1     (base 16)		U.S. Robotics Corporation
+				935 National Parkway
+				Schaumburg  IL  60173-5157
+				US
+
+00-14-C4   (hex)		Vitelcom Mobile Technology
+0014C4     (base 16)		Vitelcom Mobile Technology
+				PTA, Avda, Juan López Peñalver, nº 7
+				Campanillas.  Malaga.  
+				ES
+
+00-14-EC   (hex)		Acro Telecom
+0014EC     (base 16)		Acro Telecom
+				714 Woolim e-Biz Center 170-5 Guro-dong
+				Guro-Gu  Seoul  152-769
+				KR
+
+00-14-EB   (hex)		AwarePoint Corporation
+0014EB     (base 16)		AwarePoint Corporation
+				8899 University Center Lane
+				San Diego  CA  92122
+				US
+
+00-14-AB   (hex)		Senhai Electronic Technology Co., Ltd.
+0014AB     (base 16)		Senhai Electronic Technology Co., Ltd.
+				Rm.10A. 28/F.SEGPlaza Huaqiangbei Road
+				Shengzhen  Guangdong  518031
+				CN
+
+00-14-B0   (hex)		Naeil Community
+0014B0     (base 16)		Naeil Community
+				#506 AceTwin Tower 1, Guro-Dong
+				Seoul  Guro-Gu  152779
+				KR
+
+00-14-F4   (hex)		DekTec Digital Video B.V.
+0014F4     (base 16)		DekTec Digital Video B.V.
+				Van Riebeeckweg 43A
+				Hilversum  NH  1212AE
+				NL
+
+00-14-F5   (hex)		OSI Security Devices
+0014F5     (base 16)		OSI Security Devices
+				1580 Jayken Way
+				Chula Vista  California  91911
+				US
+
+00-14-8E   (hex)		Tele Power Inc.
+00148E     (base 16)		Tele Power Inc.
+				1-46-15#B1F
+				Nerima-ku  Tokyo  176-0005
+				JP
+
+00-14-8F   (hex)		Protronic (Far East) Ltd.
+00148F     (base 16)		Protronic (Far East) Ltd.
+				Rm. 2504, Nanyang Plaza,
+				Kwun Tong  Kowloon  
+				HK
+
+00-14-8C   (hex)		General Dynamics Mission Systems
+00148C     (base 16)		General Dynamics Mission Systems
+				150 Rustcraft Road
+				Dedham  MA  02026
+				US
+
+00-14-87   (hex)		American Technology Integrators
+001487     (base 16)		American Technology Integrators
+				1358 Rosalia Ave
+				San Jose  CA  95130
+				US
+
+00-14-44   (hex)		Grundfos Holding
+001444     (base 16)		Grundfos Holding
+				Poul Due Jensensvej 7
+				Bjerringbro    DK8850
+				DK
+
+00-14-37   (hex)		GSTeletech Co.,Ltd.
+001437     (base 16)		GSTeletech Co.,Ltd.
+				1385-14, Juan-Dong, Nam-gu
+				  Incheon  402-200
+				KR
+
+00-14-31   (hex)		PDL Electronics Ltd
+001431     (base 16)		PDL Electronics Ltd
+				81 Austin Street
+				Napier  Hawkes Bay  
+				NZ
+
+00-14-4D   (hex)		Intelligent Systems
+00144D     (base 16)		Intelligent Systems
+				11101 Johns Hopkins Road
+				Laurel  MD  20723
+				US
+
+00-14-4A   (hex)		Taiwan Thick-Film Ind. Corp.
+00144A     (base 16)		Taiwan Thick-Film Ind. Corp.
+				NO.126,Wuu Gong 2nd RD,
+				Taipei Hsien    248
+				TW
+
+00-14-45   (hex)		Telefon-Gradnja d.o.o.
+001445     (base 16)		Telefon-Gradnja d.o.o.
+				Plesivicka 3
+				Sveta Nedelja  Zupanija Zagrebacka  10431
+				HR
+
+00-14-68   (hex)		CelPlan International, Inc.
+001468     (base 16)		CelPlan International, Inc.
+				1920 Association Drive
+				Reston  VA  20191
+				US
+
+00-14-7C   (hex)		3Com Ltd
+00147C     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-14-81   (hex)		Multilink Inc
+001481     (base 16)		Multilink Inc
+				580 Ternes Ave
+				Elyria  OH  44035
+				US
+
+00-14-64   (hex)		Cryptosoft
+001464     (base 16)		Cryptosoft
+				Lermontova str, 3
+				  Penza region  440026
+				RU
+
+00-14-5E   (hex)		IBM Corp
+00145E     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-14-58   (hex)		HS Automatic ApS
+001458     (base 16)		HS Automatic ApS
+				Bjerringbrovej 70
+				Rodovre    2610
+				DK
+
+00-14-21   (hex)		Total Wireless Technologies Pte. Ltd.
+001421     (base 16)		Total Wireless Technologies Pte. Ltd.
+				Blk 1003, Bukit Merah Central, #04-18
+				    159836
+				SG
+
+00-14-20   (hex)		G-Links networking company
+001420     (base 16)		G-Links networking company
+				1FL. NO.15-49, MING DER SECOND ROAD,
+				Keelung    206
+				TW
+
+00-14-18   (hex)		C4Line
+001418     (base 16)		C4Line
+				1001 Hyundai Parisian,
+				Yangchun-Gu  Seoul  158-050
+				KR
+
+00-14-1B   (hex)		Cisco Systems, Inc
+00141B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-F0   (hex)		Wavefront Semiconductor
+0013F0     (base 16)		Wavefront Semiconductor
+				4746 44th Ave SW
+				Seattle  WA  98116
+				US
+
+00-13-EF   (hex)		Kingjon Digital Technology Co.,Ltd
+0013EF     (base 16)		Kingjon Digital Technology Co.,Ltd
+				Room 827,Huanan Dianli Bulding,No.2050
+				Shenzhen  GuangDong  518031
+				CN
+
+00-13-EB   (hex)		Sysmaster Corporation
+0013EB     (base 16)		Sysmaster Corporation
+				5801 Christie Ave.
+				Emeryville  CA  94608
+				US
+
+00-13-EC   (hex)		Netsnapper Technologies SARL
+0013EC     (base 16)		Netsnapper Technologies SARL
+				2160 Century Park East 1806
+				Los Angeles  CA  90067-2236
+				US
+
+00-14-2B   (hex)		Edata Communication Inc.
+00142B     (base 16)		Edata Communication Inc.
+				2F-1, No. 872, Chung-Cheng Rd
+				  Taipei Hsien  235
+				TW
+
+00-14-2C   (hex)		Koncept International, Inc.
+00142C     (base 16)		Koncept International, Inc.
+				2500 E Foothill Blvd. #407
+				Pasadena  CA  91107
+				US
+
+00-14-24   (hex)		Merry Electrics CO., LTD.
+001424     (base 16)		Merry Electrics CO., LTD.
+				NO.22,23rd ROAD
+				TAICHUNG CITY    40850
+				TW
+
+00-13-D0   (hex)		t+ Medical Ltd
+0013D0     (base 16)		t+ Medical Ltd
+				174E Milton Park
+				Abingdon    OX14 4SE
+				GB
+
+00-13-D2   (hex)		PAGE IBERICA, S.A.
+0013D2     (base 16)		PAGE IBERICA, S.A.
+				AV. DE LA INDUSTRIA, 24
+				TRES CANTOS  MADRID  28760
+				ES
+
+00-13-D1   (hex)		KIRK telecom A/S
+0013D1     (base 16)		KIRK telecom A/S
+				Langmarksvej 34
+				Horsens    8700
+				DK
+
+00-14-0F   (hex)		Federal State Unitary Enterprise Leningrad R&D Institute of
+00140F     (base 16)		Federal State Unitary Enterprise Leningrad R&D Institute of
+				11 Warshawskaya St.
+				  St. Petersburg  196128
+				RU
+
+00-14-07   (hex)		Sperian Protection Instrumentation
+001407     (base 16)		Sperian Protection Instrumentation
+				651 South Main Street
+				Middletown  CT  06457
+				US
+
+00-14-06   (hex)		Go Networks
+001406     (base 16)		Go Networks
+				126 Yigal Alon st.
+				Tel Aviv    67443
+				IL
+
+00-14-0A   (hex)		WEPIO Co., Ltd.
+00140A     (base 16)		WEPIO Co., Ltd.
+				#1125, Opus1, Gurodongcomplex building
+				Seoul    152-050
+				KR
+
+00-13-FA   (hex)		LifeSize Communications, Inc
+0013FA     (base 16)		LifeSize Communications, Inc
+				901 S. Mopac
+				Austin  TX  78746
+				US
+
+00-13-FB   (hex)		RKC INSTRUMENT INC.
+0013FB     (base 16)		RKC INSTRUMENT INC.
+				16-6, Kugahara 5-chome,
+				Ohta-ku  Tokyo  146-8515
+				JP
+
+00-13-DC   (hex)		IBTEK INC.
+0013DC     (base 16)		IBTEK INC.
+				16F, 30, Pei-Ping East Rd.,
+				Taipei    100
+				TW
+
+00-13-BA   (hex)		ReadyLinks Inc
+0013BA     (base 16)		ReadyLinks Inc
+				6595 Edenvale Boulevard
+				Eden Prairie  MN  55346
+				US
+
+00-13-B8   (hex)		RyCo Electronic Systems Limited
+0013B8     (base 16)		RyCo Electronic Systems Limited
+				Unit E, Cartel Business Estate
+				Harlow  Essex  CM20 2TT
+				GB
+
+00-13-B6   (hex)		Sling Media, Inc.
+0013B6     (base 16)		Sling Media, Inc.
+				1840 Gateway Center
+				San Mateo  CA  94404
+				US
+
+00-13-7D   (hex)		Dynalab, Inc.
+00137D     (base 16)		Dynalab, Inc.
+				555 Lancaster Ave.
+				Reynoldsburg  OH  43068
+				US
+
+00-13-83   (hex)		Application Technologies and Engineering Research Laboratory
+001383     (base 16)		Application Technologies and Engineering Research Laboratory
+				Shinjuku 1-chome Bldg.
+				Shinjuku-ku  Tokyo  160-0022
+				JP
+
+00-13-87   (hex)		27M Technologies AB
+001387     (base 16)		27M Technologies AB
+				Diskettgatan 11
+				Linköping     S-583 35
+				SE
+
+00-13-73   (hex)		BLwave Electronics Co., Ltd
+001373     (base 16)		BLwave Electronics Co., Ltd
+				23FGH, Block A,ZhenYe Building , BaoAn Nan Road , LuoHu , Shenzhen , China
+				ShenZhen  GuangDong  518000
+				CN
+
+00-13-66   (hex)		Neturity Technologies Inc.
+001366     (base 16)		Neturity Technologies Inc.
+				830 Stewart Drive
+				Sunnyvale  CA  94085
+				US
+
+00-13-5B   (hex)		PanelLink Cinema, LLC
+00135B     (base 16)		PanelLink Cinema, LLC
+				1070 E Arques Ave
+				Sunnyvale  CA  94085
+				US
+
+00-13-6F   (hex)		PacketMotion, Inc.
+00136F     (base 16)		PacketMotion, Inc.
+				2121 El Camino Real
+				San Mateo  CA  94403
+				US
+
+00-13-68   (hex)		Saab Danmark A/S
+001368     (base 16)		Saab Danmark A/S
+				Alsion 2
+				Soenderborg  DK  6400
+				DK
+
+00-13-B4   (hex)		Appear TV
+0013B4     (base 16)		Appear TV
+				P.O. Box 8 Lilleaker
+				Oslo    NO-0216
+				NO
+
+00-13-AE   (hex)		Radiance Technologies, Inc.
+0013AE     (base 16)		Radiance Technologies, Inc.
+				350 Wynn Dr.
+				Huntsville  Alabama  35805
+				US
+
+00-13-97   (hex)		Oracle Corporation 
+001397     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-13-C3   (hex)		Cisco Systems, Inc
+0013C3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-BD   (hex)		HYMATOM SA
+0013BD     (base 16)		HYMATOM SA
+				Zone Industrielle
+				VENDARGUES  HERAULT  34740
+				FR
+
+00-13-91   (hex)		OUEN CO.,LTD.
+001391     (base 16)		OUEN CO.,LTD.
+				Gotanda NT Bldg.7F,
+				Shinagawa-ku  Tokyo  141-0022
+				JP
+
+00-13-23   (hex)		Cap Co., Ltd.
+001323     (base 16)		Cap Co., Ltd.
+				11F,684-2,deungchon 3-dong,gangseo-gu
+				Seoul    157-754
+				KR
+
+00-13-14   (hex)		Asiamajor Inc.
+001314     (base 16)		Asiamajor Inc.
+				6F-9, No. 268, Lian-Cheng Rd., Junghe City,
+				Taipei    235
+				TW
+
+00-13-16   (hex)		L-S-B Broadcast Technologies GmbH
+001316     (base 16)		L-S-B Broadcast Technologies GmbH
+				Gustav-Stresemann-Str. 8
+				Bingen  Rheinland-Pfalz  55411
+				DE
+
+00-13-12   (hex)		Amedia Networks Inc.
+001312     (base 16)		Amedia Networks Inc.
+				101 Crawfords Corner Rd
+				Holmdel  NJ  07733
+				US
+
+00-13-36   (hex)		Tianjin 712 Communication Broadcasting co., ltd.
+001336     (base 16)		Tianjin 712 Communication Broadcasting co., ltd.
+				No.185, Xinda Road, Hebei District
+				Tianjin    300140
+				CN
+
+00-13-5E   (hex)		EAB/RWI/K
+00135E     (base 16)		EAB/RWI/K
+				Färögatan 6
+				Stockholm  Kista  164 80
+				SE
+
+00-13-4E   (hex)		Valox Systems, Inc.
+00134E     (base 16)		Valox Systems, Inc.
+				#704, Ace Twin tower 2, 212-30, Guro-3dong, Guro-gu
+				Seoul    152-779
+				KR
+
+00-13-44   (hex)		Fargo Electronics Inc.
+001344     (base 16)		Fargo Electronics Inc.
+				6533 Flying Cloud Drive
+				Eden Prairie  MN  55344
+				US
+
+00-13-48   (hex)		Artila Electronics Co., Ltd.
+001348     (base 16)		Artila Electronics Co., Ltd.
+				2F., No.1, Alley 8, Siwei Lane, Zhongzheng Rd.,
+				Xindian City  Taipei County  231
+				TW
+
+00-12-EF   (hex)		OneAccess SA
+0012EF     (base 16)		OneAccess SA
+				28 rue de la Redoute
+				Fontenay aux Roses    92260
+				FR
+
+00-12-E9   (hex)		Abbey Systems Ltd
+0012E9     (base 16)		Abbey Systems Ltd
+				Level 4, 220 Willis St
+				Wellington    6030
+				NZ
+
+00-13-00   (hex)		IT-FACTORY, INC.
+001300     (base 16)		IT-FACTORY, INC.
+				1-16-26 TAKAGI MINAMI-KU
+				FUKUOKA-SHI  FUKUOKA-KEN  815-0004
+				JP
+
+00-13-22   (hex)		DAQ Electronics, Inc.
+001322     (base 16)		DAQ Electronics, Inc.
+				262B Old New Brunswick Road
+				Piscataway  NJ  08854
+				US
+
+00-12-D5   (hex)		Motion Reality Inc.
+0012D5     (base 16)		Motion Reality Inc.
+				200 North Cobb Parkway
+				Marietta  GA  30062
+				US
+
+00-12-D8   (hex)		International Games System Co., Ltd.
+0012D8     (base 16)		International Games System Co., Ltd.
+				No.130, Wu-Gung Rd., Wu-Gu Industrial Park,
+				Taipei    248
+				TW
+
+00-12-9A   (hex)		IRT Electronics Pty Ltd
+00129A     (base 16)		IRT Electronics Pty Ltd
+				26 Hotham Parade
+				Artarmon  NSW  2064
+				AU
+
+00-12-8D   (hex)		STB Datenservice GmbH
+00128D     (base 16)		STB Datenservice GmbH
+				Weinsbergstraße 190
+				Köln  NRW  50825
+				DE
+
+00-12-DB   (hex)		ZIEHL industrie-elektronik GmbH + Co KG
+0012DB     (base 16)		ZIEHL industrie-elektronik GmbH + Co KG
+				Daimlerstraße 13
+				Schwäbisch Hall    74523
+				DE
+
+00-12-D6   (hex)		Jiangsu Yitong High-Tech Co.,Ltd
+0012D6     (base 16)		Jiangsu Yitong High-Tech Co.,Ltd
+				No 216 Huanghe Road
+				Changshu  Jiangsu  215500
+				CN
+
+00-12-DA   (hex)		Cisco Systems, Inc
+0012DA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-D3   (hex)		Zetta Systems, Inc.
+0012D3     (base 16)		Zetta Systems, Inc.
+				17311 135th AVE NE
+				Woodinville  WA  98072
+				US
+
+00-12-A2   (hex)		VITA
+0012A2     (base 16)		VITA
+				PO Box 19658
+				Fountain Hills  AZ  85269
+				US
+
+00-12-A5   (hex)		Dolphin Interconnect Solutions AS
+0012A5     (base 16)		Dolphin Interconnect Solutions AS
+				NILS Hansens Vei 13
+				Oslo    0667
+				NO
+
+00-12-A8   (hex)		intec GmbH
+0012A8     (base 16)		intec GmbH
+				Rahmedestraße 90
+				Luedenscheid  NRW  58507
+				DE
+
+00-12-9E   (hex)		Surf Communications Inc.
+00129E     (base 16)		Surf Communications Inc.
+				Room 313, 3F, Bldg.52, No. 195, Chung Hsing Rd., Sec 4, Chutung, HsinChu, Taiwan
+				HsinChu    310
+				TW
+
+00-12-BA   (hex)		FSI Systems, Inc.
+0012BA     (base 16)		FSI Systems, Inc.
+				5847 County Road 41
+				Farmington  NY  14425
+				US
+
+00-12-B2   (hex)		AVOLITES LTD.
+0012B2     (base 16)		AVOLITES LTD.
+				184 PARK AVENUE
+				LONDON    NW10 7XL
+				GB
+
+00-12-AE   (hex)		HLS HARD-LINE Solutions Inc.
+0012AE     (base 16)		HLS HARD-LINE Solutions Inc.
+				53 Main Street
+				Dowling  Ontario  P0M 1R0
+				CA
+
+00-12-AF   (hex)		ELPRO Technologies
+0012AF     (base 16)		ELPRO Technologies
+				9 / 12 Billabong St.
+				Stafford  Queensland  4053
+				AU
+
+00-12-E6   (hex)		SPECTEC COMPUTER CO., LTD.
+0012E6     (base 16)		SPECTEC COMPUTER CO., LTD.
+				6F., No. 92, Nanking E. Rd. Sec. 5,
+				Taipei    105
+				TW
+
+00-12-36   (hex)		ConSentry Networks
+001236     (base 16)		ConSentry Networks
+				1690 McCandless Dr
+				Milipitas  CA  95035
+				US
+
+00-12-35   (hex)		Andrew Corporation
+001235     (base 16)		Andrew Corporation
+				2601 Telecom Pkwy
+				Richardson  TX  75082
+				US
+
+00-12-45   (hex)		Zellweger Analytics, Inc.
+001245     (base 16)		Zellweger Analytics, Inc.
+				405 Barclay Blvd.
+				Lincolnshire  Illinois  60069
+				US
+
+00-12-42   (hex)		Millennial Net
+001242     (base 16)		Millennial Net
+				 285 Billerica Road
+				Chelmsford  MA  01803
+				US
+
+00-12-41   (hex)		a2i marketing center
+001241     (base 16)		a2i marketing center
+				1024-4  Duksan Bldg Bangbaedong Seochogu Seoul Korea
+				SEOUL    137-060
+				KR
+
+00-12-3B   (hex)		KeRo Systems ApS
+00123B     (base 16)		KeRo Systems ApS
+				Allikevej 3
+				Hørsholm    2970
+				DK
+
+00-12-87   (hex)		Digital Everywhere Unterhaltungselektronik GmbH
+001287     (base 16)		Digital Everywhere Unterhaltungselektronik GmbH
+				Maria Gailer Strasse 16
+				Villach  Kärnten  9500
+				AT
+
+00-12-82   (hex)		Qovia
+001282     (base 16)		Qovia
+				7470 New Technology Way
+				Frederick  MD  21703
+				US
+
+00-12-85   (hex)		Gizmondo Europe Ltd
+001285     (base 16)		Gizmondo Europe Ltd
+				1 Meadow Gate Avenue
+				Farnborough  Hampshire  GU14 6FG
+				GB
+
+00-12-77   (hex)		Korenix Technologies Co., Ltd.
+001277     (base 16)		Korenix Technologies Co., Ltd.
+				11F-1, No. 108, MinQuan Rd.
+				Xindian City  Taipei  231
+				TW
+
+00-12-6D   (hex)		University of California, Berkeley
+00126D     (base 16)		University of California, Berkeley
+				EECS Department
+				Berkeley  CA  94720-1776
+				US
+
+00-12-67   (hex)		Panasonic Corporation
+001267     (base 16)		Panasonic Corporation
+				2460-1, Uegawa-Cho
+				Matsusaka-City  Mie  571-8506
+				JP
+
+00-12-65   (hex)		Enerdyne Technologies, Inc.
+001265     (base 16)		Enerdyne Technologies, Inc.
+				1935 Cordell Court
+				El Cajon  CA  92020
+				US
+
+00-12-57   (hex)		LeapComm Communication Technologies Inc.
+001257     (base 16)		LeapComm Communication Technologies Inc.
+				RM1804-05 South Tower Hong Kong Plaza, No.283 Huaihai Zhong Road
+				Shanghai    200021
+				CN
+
+00-12-51   (hex)		SILINK
+001251     (base 16)		SILINK
+				13 RUE POMEYS
+				LE TAILLAN    33320
+				FR
+
+00-12-8E   (hex)		Q-Free ASA
+00128E     (base 16)		Q-Free ASA
+				Th. Owesensgt. 35c
+				Trondheim    7443
+				NO
+
+00-12-92   (hex)		Griffin Technology
+001292     (base 16)		Griffin Technology
+				1930 Air Lane Drive
+				Nashville  TN  37210
+				US
+
+00-11-F3   (hex)		NeoMedia Europe AG
+0011F3     (base 16)		NeoMedia Europe AG
+				Jens-Otto-Krag-Straße 11
+				Würselen    52146
+				DE
+
+00-11-E9   (hex)		STARNEX CO., LTD.
+0011E9     (base 16)		STARNEX CO., LTD.
+				4th Floor, C&C Bldg, 228-2
+				Kwangjin-gu  Seoul  143-200
+				KR
+
+00-11-EC   (hex)		AVIX INC.
+0011EC     (base 16)		AVIX INC.
+				1-1, Fukuura, Kanazawa-ku
+				Yokohama-shi  Kanagawa  236-0004
+				JP
+
+00-11-E7   (hex)		WORLDSAT - Texas de France
+0011E7     (base 16)		WORLDSAT - Texas de France
+				220, rue Gustave Eiffel
+				Aix en Provence  Bouches du Rhone  13854
+				FR
+
+00-12-02   (hex)		Decrane Aerospace - Audio International Inc.
+001202     (base 16)		Decrane Aerospace - Audio International Inc.
+				7300 Industry Drive
+				North Little Rock  AR  72117
+				US
+
+00-11-FE   (hex)		Keiyo System Research, Inc.
+0011FE     (base 16)		Keiyo System Research, Inc.
+				Hamada park Bldg. 6F
+				Chiba-city  Chiba-pref  260-0028
+				JP
+
+00-11-FD   (hex)		KORG INC.
+0011FD     (base 16)		KORG INC.
+				4015-2, Yanokuchi
+				Inagi-City  TOKYO  206-0812
+				JP
+
+00-11-FA   (hex)		Rane Corporation
+0011FA     (base 16)		Rane Corporation
+				10802 47th Avenue West
+				Mukilteo  WA  98275-5098
+				US
+
+00-11-CE   (hex)		Ubisense Limited
+0011CE     (base 16)		Ubisense Limited
+				St. Andrews House
+				Chesterton  Cambridge  CB4 1DL
+				GB
+
+00-11-D0   (hex)		Tandberg Data ASA
+0011D0     (base 16)		Tandberg Data ASA
+				Kjelsåsveien 161
+				Oslo    0411
+				NO
+
+00-11-C3   (hex)		Transceiving System Technology Corporation
+0011C3     (base 16)		Transceiving System Technology Corporation
+				NO.85,Sec.2,Gongdaowu Rd.,
+				Hsinchu    300
+				TW
+
+00-11-C2   (hex)		United Fiber Optic Communication
+0011C2     (base 16)		United Fiber Optic Communication
+				13-1,NO.700,Jungjeng RD,Junghe City
+				Junghe City  Taipei  235
+				TW
+
+00-12-28   (hex)		Data Ltd.
+001228     (base 16)		Data Ltd.
+				J. Hagaru 9
+				Bratislava    830 05
+				SK
+
+00-12-1F   (hex)		Harding Instruments
+00121F     (base 16)		Harding Instruments
+				9431-41Ave
+				Edmonton  AB  T6E 5X7
+				CA
+
+00-12-20   (hex)		Cadco Systems
+001220     (base 16)		Cadco Systems
+				2363 Merritt Dr
+				Garland  Texas  75041
+				US
+
+00-12-29   (hex)		BroadEasy Technologies Co.,Ltd
+001229     (base 16)		BroadEasy Technologies Co.,Ltd
+				24th Floor,Tower A,JinShan Mansion,
+				Nanjing  Jiangsu  210009
+				CN
+
+00-12-26   (hex)		Japan Direx Corporation
+001226     (base 16)		Japan Direx Corporation
+				Kyocera Harajuku Bldg.
+				Shibuya-ku  Tokyo  150-0001
+				JP
+
+00-12-22   (hex)		Skardin (UK) Ltd
+001222     (base 16)		Skardin (UK) Ltd
+				No. 5 Greenway (RO24)
+				Harlow  Essex  CM19 5QB
+				GB
+
+00-11-E8   (hex)		Tixi.Com
+0011E8     (base 16)		Tixi.Com
+				Karmeliterweg 114
+				Berlin    13465
+				DE
+
+00-11-E0   (hex)		U-MEDIA Communications, Inc.
+0011E0     (base 16)		U-MEDIA Communications, Inc.
+				 9F, No.1 Jin-Shan St.
+				Hsinchu    300
+				TW
+
+00-12-0D   (hex)		Advanced Telecommunication Technologies, Inc.
+00120D     (base 16)		Advanced Telecommunication Technologies, Inc.
+				10390 Wilshire Boulevard
+				Los Angeles  California  90024
+				US
+
+00-12-0E   (hex)		AboCom
+00120E     (base 16)		AboCom
+				1F , No. 21, Yanfa 2nd Rd., SBIP
+				Hsinchu City    300
+				TW
+
+00-11-F2   (hex)		Institute of Network Technologies
+0011F2     (base 16)		Institute of Network Technologies
+				17-th Line Vasilevsky Ostrov, 54-1
+				St.Petersburg    199178
+				RU
+
+00-12-10   (hex)		WideRay Corp
+001210     (base 16)		WideRay Corp
+				25 Kearny Street
+				San Francisco  CA  94108
+				US
+
+00-11-A4   (hex)		JStream Technologies Inc.
+0011A4     (base 16)		JStream Technologies Inc.
+				Bldg.53, R405, 195 Sec.4, Chung Hsing Rd.
+				Chutung,   Hsinchu  310
+				TW
+
+00-11-98   (hex)		Prism Media Products Limited
+001198     (base 16)		Prism Media Products Limited
+				William James House
+				Cambridge  Cambridgeshire  CB4 0WX
+				GB
+
+00-11-97   (hex)		Monitoring Technologies Limited
+001197     (base 16)		Monitoring Technologies Limited
+				14 Attenburys Park Estate
+				Timperley  Cheshire  WA14 5QE
+				GB
+
+00-11-99   (hex)		2wcom Systems GmbH
+001199     (base 16)		2wcom Systems GmbH
+				Am Sophienhof 8
+				Flensburg    24941
+				DE
+
+00-11-A7   (hex)		Infilco Degremont Inc.
+0011A7     (base 16)		Infilco Degremont Inc.
+				8007 Discovery Dr.
+				Richmond  Virginia  23255-1390
+				US
+
+00-11-A9   (hex)		MOIMSTONE Co., LTD
+0011A9     (base 16)		MOIMSTONE Co., LTD
+				7th Floor JoongPyung Building 64-1
+				Seoul    137-900
+				KR
+
+00-11-A3   (hex)		LanReady Technologies Inc.
+0011A3     (base 16)		LanReady Technologies Inc.
+				4F, No. 337, SinHu 2nd Road., NeiHu District
+				  Taipei  114
+				TW
+
+00-11-76   (hex)		Intellambda Systems, Inc.
+001176     (base 16)		Intellambda Systems, Inc.
+				48501 Warm Springs Blvd, #107
+				Fremont  California  94539
+				US
+
+00-11-77   (hex)		Coaxial Networks, Inc.
+001177     (base 16)		Coaxial Networks, Inc.
+				4633 Old Ironsides Dr
+				Santa Clara  CA  95054
+				US
+
+00-11-70   (hex)		GSC SRL
+001170     (base 16)		GSC SRL
+				VIA PER VIMERCATE
+				USMATE VELATE  MILANO  20040
+				IT
+
+00-11-6B   (hex)		Digital Data Communications Asia Co.,Ltd
+00116B     (base 16)		Digital Data Communications Asia Co.,Ltd
+				8F,No.41,Lane 221,Kang-Chien RD.,Nei-Hu Dis.,
+				Taipei City    114
+				TW
+
+00-11-69   (hex)		EMS Satcom
+001169     (base 16)		EMS Satcom
+				Green Lane
+				Tewkesbury  Gloucestershire  GL20 8HD
+				GB
+
+00-11-62   (hex)		STAR MICRONICS CO.,LTD.
+001162     (base 16)		STAR MICRONICS CO.,LTD.
+				536 Shimizunanatsushinya
+				Shizuoka    424-0066
+				JP
+
+00-11-81   (hex)		InterEnergy Co.Ltd,
+001181     (base 16)		InterEnergy Co.Ltd,
+				3F Shinyokohama Bosei Bldg.
+				Yokohama city  Kanagawa  222-0033
+				JP
+
+00-11-94   (hex)		Chi Mei Communication Systems, Inc.
+001194     (base 16)		Chi Mei Communication Systems, Inc.
+				11F, No.39, Chung Hua RD. Sec 1
+				Taipei    100
+				TW
+
+00-11-BF   (hex)		AESYS S.p.A.
+0011BF     (base 16)		AESYS S.p.A.
+				Via Artigiani, 41
+				Brusaporto  Bergamo  24060
+				IT
+
+00-11-B7   (hex)		Octalix B.V.
+0011B7     (base 16)		Octalix B.V.
+				Molensteijn 60
+				De Meern    NL-3454 PT
+				NL
+
+00-11-B9   (hex)		Inner Range Pty. Ltd.
+0011B9     (base 16)		Inner Range Pty. Ltd.
+				1 Millenium Court
+				Knoxfield  Victoria  3180
+				AU
+
+00-11-09   (hex)		Micro-Star International
+001109     (base 16)		Micro-Star International
+				No 69, Li-De Street, Jung-He City,
+				Taipei    
+				TW
+
+00-11-04   (hex)		TELEXY
+001104     (base 16)		TELEXY
+				1116, HYUNDAI 41 TOWER, 917-9
+				SEOUL    158-723
+				KR
+
+00-11-61   (hex)		NetStreams, LLC
+001161     (base 16)		NetStreams, LLC
+				3600 W. Parmer Lane
+				Austin  TX  78727
+				US
+
+00-11-56   (hex)		Pharos Systems NZ
+001156     (base 16)		Pharos Systems NZ
+				Level 3, 123 Carlton Gore Road
+				Auckland  NZ  1001
+				NZ
+
+00-11-59   (hex)		MATISSE NETWORKS INC
+001159     (base 16)		MATISSE NETWORKS INC
+				339 N BERNARDO AVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-11-5C   (hex)		Cisco Systems, Inc
+00115C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-5D   (hex)		Cisco Systems, Inc
+00115D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-26   (hex)		Venstar Inc.
+001126     (base 16)		Venstar Inc.
+				9250 Owensmouth Ave.
+				Chatsworth  CA  91311
+				US
+
+00-11-2E   (hex)		CEICOM
+00112E     (base 16)		CEICOM
+				17 rue Gaston Evrard
+				Toulouse Cedex 1    31094
+				FR
+
+00-11-22   (hex)		CIMSYS Inc
+001122     (base 16)		CIMSYS Inc
+				#301,Sinsung-clean BLDG,140, Nongseo-Ri,Kiheung-Eup
+				Yongin-City  Kyunggi-Do  449-711
+				KR
+
+00-11-17   (hex)		CESNET
+001117     (base 16)		CESNET
+				Zikova 4
+				Praha 6    160 00
+				CZ
+
+00-11-16   (hex)		COTEAU VERT CO., LTD.
+001116     (base 16)		COTEAU VERT CO., LTD.
+				3-3-19 KACHIDOKI
+				CHUO-KU  TOKYO  104-0054
+				JP
+
+00-11-10   (hex)		Maxanna Technology Co., Ltd.
+001110     (base 16)		Maxanna Technology Co., Ltd.
+				Room201, No.42-3, Luyuan Road
+				Guangzhou    510095
+				CN
+
+00-11-3B   (hex)		Micronet Communications Inc.
+00113B     (base 16)		Micronet Communications Inc.
+				12F-1, No. 100, Min-Chuan Road
+				Hsin-Tien  Taipei  231
+				TW
+
+00-11-3D   (hex)		KN SOLTEC CO.,LTD.
+00113D     (base 16)		KN SOLTEC CO.,LTD.
+				98B-5L NAMDONG INDUSTRIAL COMPLEX #662-4 GOJAN-DONG
+				NAMDONG-GU  INCHEON  405-818
+				KR
+
+00-11-34   (hex)		MediaCell, Inc.
+001134     (base 16)		MediaCell, Inc.
+				600 17th St
+				Denver  CO  80202
+				US
+
+00-11-35   (hex)		Grandeye Ltd
+001135     (base 16)		Grandeye Ltd
+				6 Huxley Road
+				Guildford  Surrey  GU2 7RE
+				GB
+
+00-11-21   (hex)		Cisco Systems, Inc
+001121     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-49   (hex)		Proliphix Inc.
+001149     (base 16)		Proliphix Inc.
+				3 Lan Drive
+				Westford  MA  01886
+				US
+
+00-0F-C0   (hex)		DELCOMp
+000FC0     (base 16)		DELCOMp
+				Technologielaan 3
+				Leuven    B-3000
+				BE
+
+00-0F-BA   (hex)		Tevebox AB
+000FBA     (base 16)		Tevebox AB
+				Berglinds vag 13
+				warmdo    S-13900
+				SE
+
+00-0F-B8   (hex)		CallURL Inc.
+000FB8     (base 16)		CallURL Inc.
+				3F-11, No. 508 Sec.  5, Chung-Hsiao E. Rd.
+				Taipei    110
+				TW
+
+00-0F-B7   (hex)		Cavium
+000FB7     (base 16)		Cavium
+				2315 N First Street
+				San Jose  CA  95131
+				US
+
+00-0F-D3   (hex)		Digium
+000FD3     (base 16)		Digium
+				445 Jan Davis Drive NW
+				Huntsville  AL  35806
+				US
+
+00-0F-D1   (hex)		Applied Wireless Identifications Group, Inc.
+000FD1     (base 16)		Applied Wireless Identifications Group, Inc.
+				382 Route 59, Section 292
+				Monsey  New York  10952
+				US
+
+00-0F-C1   (hex)		WAVE Corporation
+000FC1     (base 16)		WAVE Corporation
+				3-25-5 Chidori
+				Ohta-ku  Tokyo  146-0083
+				JP
+
+00-11-00   (hex)		Schneider Electric
+001100     (base 16)		Schneider Electric
+				5460 Pottsville Pike
+				Leesport  PA  19533
+				US
+
+00-0F-FA   (hex)		Optinel Systems, Inc.
+000FFA     (base 16)		Optinel Systems, Inc.
+				6835 Deerpath Rd.
+				Elkridge  MD  21075
+				US
+
+00-0F-FD   (hex)		Glorytek Network Inc.
+000FFD     (base 16)		Glorytek Network Inc.
+				5F.-3, No.16, Sec. 1, Dongda Rd.,
+				Hsinchu    300
+				TW
+
+00-0F-F9   (hex)		Valcretec, Inc.
+000FF9     (base 16)		Valcretec, Inc.
+				Byucksan Digital Valley II 15F
+				Seoul    153-803
+				KR
+
+00-0F-C4   (hex)		NST co.,LTD.
+000FC4     (base 16)		NST co.,LTD.
+				4-3-1 SHINMIYAKODA
+				HAMAMATSU  SHIZUOKA  431-2103
+				JP
+
+00-0F-C9   (hex)		Allnet GmbH
+000FC9     (base 16)		Allnet GmbH
+				Maistraße 2
+				Germering  Bavaria  82110
+				DE
+
+00-0F-C6   (hex)		Eurocom Industries A/S
+000FC6     (base 16)		Eurocom Industries A/S
+				porsvej 2
+				Aalborg  NV  DK-9200
+				DK
+
+00-0F-BE   (hex)		e-w/you Inc.
+000FBE     (base 16)		e-w/you Inc.
+				3F FINE Bldg. 6-17-17
+				Shinagawa-ku,  Tokyo  140-0013
+				JP
+
+00-0F-A9   (hex)		PC Fabrik
+000FA9     (base 16)		PC Fabrik
+				Buchenstrasse 13-15
+				Dresden  Sachsen  01097
+				DE
+
+00-0F-A0   (hex)		CANON KOREA BUSINESS SOLUTIONS INC.
+000FA0     (base 16)		CANON KOREA BUSINESS SOLUTIONS INC.
+				736 Wonsi-Dong
+				Ansan-si  Kyunggi-do  425-090
+				KR
+
+00-0F-9A   (hex)		Synchrony, Inc.
+000F9A     (base 16)		Synchrony, Inc.
+				6410 Commonwealth Drive
+				Roanoke  VA  24018
+				US
+
+00-0F-EA   (hex)		Giga-Byte Technology Co.,LTD.
+000FEA     (base 16)		Giga-Byte Technology Co.,LTD.
+				No.215,Nan-Ping Road,Ping-Jen City,
+				Ping-Jen  Taoyuan  324
+				TW
+
+00-0F-F7   (hex)		Cisco Systems, Inc
+000FF7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-D8   (hex)		Force, Inc.
+000FD8     (base 16)		Force, Inc.
+				825 Park Street
+				Christiansburg  Va  24073
+				US
+
+00-0F-8D   (hex)		FAST TV-Server AG
+000F8D     (base 16)		FAST TV-Server AG
+				Ruedesheimerstraße 11-13
+				Munich  Germany  80686
+				DE
+
+00-0F-85   (hex)		ADDO-Japan Corporation
+000F85     (base 16)		ADDO-Japan Corporation
+				Shin Edobashi Bldg. 4F, 8-6 Nihombashi Kobuna-cho
+				Chuo-ku  Tokyo  103-0024
+				JP
+
+00-0F-82   (hex)		Mortara Instrument, Inc.
+000F82     (base 16)		Mortara Instrument, Inc.
+				7865 N. 86th St.
+				Milwaukee  WI  53224
+				US
+
+00-0F-49   (hex)		Northover Solutions Limited
+000F49     (base 16)		Northover Solutions Limited
+				Heath Cottage
+				Larling  Norfolk  NR16 2RB
+				GB
+
+00-0F-4B   (hex)		Oracle Corporation
+000F4B     (base 16)		Oracle Corporation
+				900 Chelmsford Street
+				Lowell  MA  01851
+				US
+
+00-0F-44   (hex)		Tivella Inc.
+000F44     (base 16)		Tivella Inc.
+				795 Main Street
+				Half Moon Bay  CA  94019
+				US
+
+00-0F-4A   (hex)		Kyushu-kyohan co.,ltd
+000F4A     (base 16)		Kyushu-kyohan co.,ltd
+				2-6-3,Koganemachi
+				Kitakyushu-city  Fukuoka  802-0071
+				JP
+
+00-0F-81   (hex)		PAL Pacific Inc.
+000F81     (base 16)		PAL Pacific Inc.
+				79405 Highway 111
+				La Quinta  CA  92253
+				US
+
+00-0F-7F   (hex)		UBSTORAGE Co.,Ltd.
+000F7F     (base 16)		UBSTORAGE Co.,Ltd.
+				#A-108, Seoul_Sanup_Jiwon_Center
+				Ganseo-gu  Seoul  157-840
+				KR
+
+00-0F-95   (hex)		ELECOM Co.,LTD Laneed Division
+000F95     (base 16)		ELECOM Co.,LTD Laneed Division
+				8F Kanda-Muromachi Bldg.
+				Chiyoda-Ku, Tokyo.    101-0052
+				JP
+
+00-0F-55   (hex)		Datawire Communication Networks Inc.
+000F55     (base 16)		Datawire Communication Networks Inc.
+				10 Carlson Court, Suite 300
+				Toronto  Ontario  M9W 6L2
+				CA
+
+00-0F-56   (hex)		Continuum Photonics Inc
+000F56     (base 16)		Continuum Photonics Inc
+				5 Fortune Drive
+				Billerica  MA  01821
+				US
+
+00-0F-60   (hex)		Lifetron Co.,Ltd
+000F60     (base 16)		Lifetron Co.,Ltd
+				6-7,Tenjinnishimachi
+				Osaka  Osaka Prefecture  530-0045
+				JP
+
+00-0F-5B   (hex)		Delta Information Systems, Inc.
+000F5B     (base 16)		Delta Information Systems, Inc.
+				300 Welsh Road, Bldg. 3
+				Horsham  PA  19044-2273
+				US
+
+00-0F-8A   (hex)		WideView
+000F8A     (base 16)		WideView
+				F. 6, No. 8, Wu-chuan 2 Rd, Hsin-Chuang City
+				Taipei Country    242
+				TW
+
+00-0F-90   (hex)		Cisco Systems, Inc
+000F90     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-77   (hex)		DENTUM CO.,LTD
+000F77     (base 16)		DENTUM CO.,LTD
+				Wookyung B/D 602 #678-6
+				Seoul    157-030
+				KR
+
+00-0F-7B   (hex)		Arce Sistemas, S.A.
+000F7B     (base 16)		Arce Sistemas, S.A.
+				C/Padre Larramendi, 3 - 2º
+				Bilbao  Vizcaya  48012
+				ES
+
+00-0F-68   (hex)		Vavic Network Technology, Inc.
+000F68     (base 16)		Vavic Network Technology, Inc.
+				1st Floor, 15 Jiangong Road
+				Guangzhou  Guangdong  510665
+				CN
+
+00-0E-E2   (hex)		Custom Engineering
+000EE2     (base 16)		Custom Engineering
+				Via Beretttine 2/b
+				Fontevivo  Parma  43010
+				IT
+
+00-0E-E3   (hex)		Chiyu Technology Co.,Ltd
+000EE3     (base 16)		Chiyu Technology Co.,Ltd
+				No. 28, Renai Road, Chiayi, 600
+				Chiayi    600
+				TW
+
+00-0E-E5   (hex)		bitWallet, Inc.
+000EE5     (base 16)		bitWallet, Inc.
+				Gate City Ohsaki West Tower 18F, 1-11-1 Osaki, Shinagawa-ku
+				Tokyo    1410032
+				JP
+
+00-0E-DA   (hex)		C-TECH UNITED CORP.
+000EDA     (base 16)		C-TECH UNITED CORP.
+				5F, No 665, CHUNG CHEN RD.
+				HSIN CHUANG CITT  of TAIPEI HSIEN    242
+				TW
+
+00-0E-CF   (hex)		PROFIBUS Nutzerorganisation e.V.
+000ECF     (base 16)		PROFIBUS Nutzerorganisation e.V.
+				Haid-und-Neu-Straße 7
+				Karlsruhe  Baden-Württemberg  76131
+				DE
+
+00-0E-EB   (hex)		Sandmartin(zhong shan)Electronics Co.,Ltd
+000EEB     (base 16)		Sandmartin(zhong shan)Electronics Co.,Ltd
+				3st Industrial Area,Tan Zhou,
+				Zhongshan  Guangdong  528467
+				CN
+
+00-0E-EC   (hex)		Orban
+000EEC     (base 16)		Orban
+				1525 Alvarado St.
+				San Leandro  CA  94577
+				US
+
+00-0E-EF   (hex)		Private
+000EEF     (base 16)		Private
+
+00-0E-F1   (hex)		EZQUEST INC.
+000EF1     (base 16)		EZQUEST INC.
+				23311 E. LA PALMA AVE.
+				YORBA LINDA  CA  92887
+				US
+
+00-0E-E7   (hex)		AAC ELECTRONICS CORP.
+000EE7     (base 16)		AAC ELECTRONICS CORP.
+				FLOOR 7,SIXTH BUILDING OF NAIANYOU TNAN INDUSTRIAL AREA,NANSHAN DISTRICT
+				SHENZHEN  PROVINCE GUANGDONG  518054
+				CN
+
+00-0F-1C   (hex)		DigitAll World Co., Ltd
+000F1C     (base 16)		DigitAll World Co., Ltd
+				Sejin Bld 2F, 689 ilwon2-dong,
+				gangnam-gu  Seoul  135-946
+				KR
+
+00-0F-1A   (hex)		Gaming Support B.V.
+000F1A     (base 16)		Gaming Support B.V.
+				Industrie weg 29
+				  Rotterdam  3044 AS
+				NL
+
+00-0F-0A   (hex)		Clear Edge Networks
+000F0A     (base 16)		Clear Edge Networks
+				11250 El Camino Real
+				San Diego  CA  92130
+				US
+
+00-0F-02   (hex)		Digicube Technology Co., Ltd
+000F02     (base 16)		Digicube Technology Co., Ltd
+				8F,No. 51, Lane  35, Jihu Rd.,
+				Taipei    114
+				TW
+
+00-0F-2F   (hex)		W-LINX TECHNOLOGY CO., LTD.
+000F2F     (base 16)		W-LINX TECHNOLOGY CO., LTD.
+				 2F,ELLEN L. SKELTON BUILDING,FISHER LANE ROAD
+				TORTOLA    
+				VG
+
+00-0F-2D   (hex)		CHUNG-HSIN ELECTRIC & MACHINERY MFG.CORP.
+000F2D     (base 16)		CHUNG-HSIN ELECTRIC & MACHINERY MFG.CORP.
+				NO. 25, Wen-Te Rd., Lo-Shan Village
+				Kwei Shan Hsiang  Taoyuan Hsien  330
+				TW
+
+00-0E-F7   (hex)		Vulcan Portals Inc
+000EF7     (base 16)		Vulcan Portals Inc
+				505 5th Ave South, Suite 900
+				Seattle  WA  98104
+				US
+
+00-0E-F0   (hex)		Festo AG & Co. KG
+000EF0     (base 16)		Festo AG & Co. KG
+				Ruiterstraße 82
+				Esslingen    73734
+				DE
+
+00-0E-E9   (hex)		WayTech Development, Inc.
+000EE9     (base 16)		WayTech Development, Inc.
+				11Floor, 253 Min-Sheng Road
+				HsinChu    300
+				TW
+
+00-0F-40   (hex)		Optical Internetworking Forum
+000F40     (base 16)		Optical Internetworking Forum
+				48377 Fremont Blvd
+				Fremont  CA  94538
+				US
+
+00-0F-33   (hex)		DUALi Inc.
+000F33     (base 16)		DUALi Inc.
+				#505 Samsung Techno Park Bldg 471
+				Suwon  Gyeonggi-do  442-824
+				KR
+
+00-0F-05   (hex)		3B SYSTEM INC.
+000F05     (base 16)		3B SYSTEM INC.
+				1727, SANKYUK2-DONG, BUK-GU
+				DAEGU    702-845
+				KR
+
+00-0E-C9   (hex)		YOKO Technology Corp.
+000EC9     (base 16)		YOKO Technology Corp.
+				6F, No.10, Lane16, Sec2, Sze-Chuan Rd., Pan-
+				Taipei    886
+				TW
+
+00-0E-BD   (hex)		Burdick, a Quinton Compny
+000EBD     (base 16)		Burdick, a Quinton Compny
+				500 Burdick Parkway
+				Deerfield  WI  53531
+				US
+
+00-0E-B9   (hex)		HASHIMOTO Electronics Industry Co.,Ltd.
+000EB9     (base 16)		HASHIMOTO Electronics Industry Co.,Ltd.
+				3866-12 Takasu-cho
+				Matsusaka  Mie  515-0104
+				JP
+
+00-0E-B2   (hex)		Micro-Research Finland Oy
+000EB2     (base 16)		Micro-Research Finland Oy
+				Välitalontie 83 C
+				Helsinki    FIN-00660
+				FI
+
+00-0E-D0   (hex)		Privaris, Inc.
+000ED0     (base 16)		Privaris, Inc.
+				675 Peter Jefferson Pkwy, Ste 150
+				Charlottesville  Virginia  22911
+				US
+
+00-0E-C3   (hex)		Logic Controls, Inc.
+000EC3     (base 16)		Logic Controls, Inc.
+				355 Denton Avenue
+				New Hyde Park  NY  11040
+				US
+
+00-0E-C4   (hex)		Iskra Transmission d.d.
+000EC4     (base 16)		Iskra Transmission d.d.
+				Stegne 11
+				Ljubljana    1000
+				SI
+
+00-0E-C1   (hex)		MYNAH Technologies
+000EC1     (base 16)		MYNAH Technologies
+				504 Trade Center Blvd
+				Chesterfield  MO  63005
+				US
+
+00-0E-82   (hex)		Commtech Wireless
+000E82     (base 16)		Commtech Wireless
+				115/396 Scarborough Beach Rd
+				Perth  WA  6017
+				AU
+
+00-0E-89   (hex)		CLEMATIC
+000E89     (base 16)		CLEMATIC
+				101 rue Pierre SEMARD
+				CHATILLON  R.P.  92320
+				US
+
+00-0E-79   (hex)		Ample Communications Inc.
+000E79     (base 16)		Ample Communications Inc.
+				4034 Clipper Ct.
+				Fremont  CA  94538
+				US
+
+00-0E-A1   (hex)		Formosa Teletek Corporation
+000EA1     (base 16)		Formosa Teletek Corporation
+				358,Huaya 2nd Rd.
+				Taoyuan    333
+				TW
+
+00-0E-98   (hex)		HME Clear-Com LTD.
+000E98     (base 16)		HME Clear-Com LTD.
+				7400 Beach Drive
+				Cambridgeshire    CB25 9TP
+				GB
+
+00-0E-99   (hex)		Spectrum Digital, Inc
+000E99     (base 16)		Spectrum Digital, Inc
+				12502 Exchange Drive, Suite 440
+				Stafford  TX  77477
+				US
+
+00-0E-95   (hex)		Fujiya Denki Seisakusho Co.,Ltd.
+000E95     (base 16)		Fujiya Denki Seisakusho Co.,Ltd.
+				8F Fukushima BLDG. 6-25-11,Nishi-Gotanda
+				Shinagawa-Ku  Tokyo  141-0031
+				JP
+
+00-0E-97   (hex)		Ultracker Technology CO., Inc
+000E97     (base 16)		Ultracker Technology CO., Inc
+				14F-1, No. 888, Jingguo Road, Taoyuan City,
+				Taoyuan    330
+				TW
+
+00-0E-A7   (hex)		Endace Technology
+000EA7     (base 16)		Endace Technology
+				85 Alexandra Street
+				Hamilton    3204
+				NZ
+
+00-0E-6F   (hex)		IRIS Corporation Berhad
+000E6F     (base 16)		IRIS Corporation Berhad
+				IRIS Smart Technology Complex
+				Kuala Lumpur  WP  57000
+				MY
+
+00-0E-B5   (hex)		Ecastle Electronics Co., Ltd.
+000EB5     (base 16)		Ecastle Electronics Co., Ltd.
+				#502, Namjang B/D, Bangbae-dong,
+				Seoul    137-818
+				KR
+
+00-0E-50   (hex)		Thomson Telecom Belgium
+000E50     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-0E-4B   (hex)		atrium c and i
+000E4B     (base 16)		atrium c and i
+				124-4, Ojeon-dong,
+				Uiwang-city  Kyunggi-Do  437-819
+				KR
+
+00-0E-2B   (hex)		Safari Technologies
+000E2B     (base 16)		Safari Technologies
+				63855 M40 Hwy
+				Lawton  MI  49065
+				US
+
+00-0E-28   (hex)		Dynamic Ratings P/L
+000E28     (base 16)		Dynamic Ratings P/L
+				C/O Wilson Transformer Co.
+				Glen Waverley  Victoria  3150
+				AU
+
+00-0E-24   (hex)		Huwell Technology Inc.
+000E24     (base 16)		Huwell Technology Inc.
+				1F 82-21, Majin Building
+				Seoul    135-010
+				KR
+
+00-0E-3F   (hex)		Soronti, Inc.
+000E3F     (base 16)		Soronti, Inc.
+				12159 Business Park Dr, Suite 140
+				Draper  Utah  84020
+				US
+
+00-0E-45   (hex)		Beijing Newtry Electronic Technology Ltd
+000E45     (base 16)		Beijing Newtry Electronic Technology Ltd
+				PO Box 95, No. 1 Bei Sha Tan,
+				Beijing    10083
+				CN
+
+00-0E-1D   (hex)		ARION Technology Inc.
+000E1D     (base 16)		ARION Technology Inc.
+				3F, Pica Bldg, 894-2, Hogye 2 Dong
+				An-Yang City  Gyeonggi-Do  
+				KR
+
+00-0E-12   (hex)		Adaptive Micro Systems Inc.
+000E12     (base 16)		Adaptive Micro Systems Inc.
+				7840 North 86th St.
+				Milwaukee  WI  53224
+				US
+
+00-0E-4F   (hex)		Trajet GmbH
+000E4F     (base 16)		Trajet GmbH
+				Rebenring 33
+				Braunschweig  Nds.  38106
+				DE
+
+00-0E-38   (hex)		Cisco Systems, Inc
+000E38     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-36   (hex)		HEINESYS, Inc.
+000E36     (base 16)		HEINESYS, Inc.
+				3F, Sungkwang Bldg. 456-13, Sungnae-dong
+				Seoul    134-848
+				KR
+
+00-0E-17   (hex)		Private
+000E17     (base 16)		Private
+
+00-0E-15   (hex)		Tadlys LTD
+000E15     (base 16)		Tadlys LTD
+				ISRAELI SHIMON 3
+				RISHON lEZYYON  ISRAEL  75654
+				US
+
+00-0E-01   (hex)		ASIP Technologies Inc.
+000E01     (base 16)		ASIP Technologies Inc.
+				10F-2, NO.322, Sec.1, Guangfu Rd.,
+				Hsinchu    300
+				TW
+
+00-0D-CB   (hex)		Petcomkorea Co., Ltd.
+000DCB     (base 16)		Petcomkorea Co., Ltd.
+				5F,689-47,Geumjeong-dong,Gunpo-si,Kyungg
+				Kyunggi-do  gunpo-si  435-050
+				KR
+
+00-0D-CC   (hex)		NEOSMART Corp.
+000DCC     (base 16)		NEOSMART Corp.
+				Yoon-B/D 4F, 475-31, Bangbae 2-dong
+				Seoul  Seocho-gu  147-819
+				KR
+
+00-0D-CE   (hex)		Dynavac Technology Pte Ltd
+000DCE     (base 16)		Dynavac Technology Pte Ltd
+				30 Tuas Avenue 9
+				    639183
+				SG
+
+00-0D-E8   (hex)		Nasaco Electronics Pte. Ltd
+000DE8     (base 16)		Nasaco Electronics Pte. Ltd
+				Level 4, Nasaco Tech Centre
+				    486056
+				SG
+
+00-0D-E9   (hex)		Napatech Aps
+000DE9     (base 16)		Napatech Aps
+				Rundofrbivej 271, 1
+				Naerum    2850
+				DK
+
+00-0D-E6   (hex)		YOUNGBO ENGINEERING CO.,LTD
+000DE6     (base 16)		YOUNGBO ENGINEERING CO.,LTD
+				Mt.22, Jaeunga-ri, Jigsan-Eup,
+				Cheonan-shi  Chungcheongnam-do  #330-810
+				KR
+
+00-0D-C3   (hex)		First Communication, Inc.
+000DC3     (base 16)		First Communication, Inc.
+				1F, No.36, Industry E. Rd. IV.,
+				Hsinchu    
+				TW
+
+00-0D-B9   (hex)		PC Engines GmbH
+000DB9     (base 16)		PC Engines GmbH
+				Flughofstrasse 58
+				8152  Glattbrugg  
+				CH
+
+00-0D-B7   (hex)		SANKO ELECTRIC CO,.LTD
+000DB7     (base 16)		SANKO ELECTRIC CO,.LTD
+				7-23 Tamanoi-cho Atsuta-ku
+				Nagoya-shi  Aichi  456-0025
+				JP
+
+00-0D-AC   (hex)		Japan CBM Corporation
+000DAC     (base 16)		Japan CBM Corporation
+				5-68-10 Nakano,
+				Nakano-Ku  Tokyo  164-0001
+				JP
+
+00-0D-DF   (hex)		Japan Image & Network Inc.
+000DDF     (base 16)		Japan Image & Network Inc.
+				5-29-12 Shiba
+				Minato-ku  Tokyo  108-0014
+				JP
+
+00-0D-DB   (hex)		AIRWAVE TECHNOLOGIES INC.
+000DDB     (base 16)		AIRWAVE TECHNOLOGIES INC.
+				3F,No.9,Industry E. 9th Road
+				Hsinchu    300
+				TW
+
+00-0E-04   (hex)		CMA/Microdialysis AB
+000E04     (base 16)		CMA/Microdialysis AB
+				Dalvägen  10 / Box 2
+				Solna    171 18
+				SE
+
+00-0D-2A   (hex)		Scanmatic AS
+000D2A     (base 16)		Scanmatic AS
+				Kilsund
+				Staubø    4920
+				NO
+
+00-0D-29   (hex)		Cisco Systems, Inc
+000D29     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-26   (hex)		Primagraphics Limited
+000D26     (base 16)		Primagraphics Limited
+				Cambridge House, No.2 Focus Four
+				Letchworth Garden City  Hertfordshire  SG6 2TU
+				GB
+
+00-0D-46   (hex)		Parker SSD Drives
+000D46     (base 16)		Parker SSD Drives
+				9225 Forsyth Park Drive
+				Charlotte  NC  28273-3884
+				US
+
+00-0D-41   (hex)		Siemens AG ICM MP UC RD IT KLF1
+000D41     (base 16)		Siemens AG ICM MP UC RD IT KLF1
+				Suedstrasse 9
+				Kamp-Lintfort  NRW  47475
+				DE
+
+00-0D-42   (hex)		Newbest Development Limited
+000D42     (base 16)		Newbest Development Limited
+				3/F  Unit 311-312
+				  Shatin  NT  
+				HK
+
+00-0D-3C   (hex)		i.Tech Dynamic Ltd
+000D3C     (base 16)		i.Tech Dynamic Ltd
+				Room 1112, Metroplaza Tower 2, 223 Hing
+				    852
+				HK
+
+00-0D-55   (hex)		SANYCOM Technology Co.,Ltd
+000D55     (base 16)		SANYCOM Technology Co.,Ltd
+				6F,Beijing Capital Times Square,88# Xich
+				Beijing    100031
+				CN
+
+00-0D-57   (hex)		Fujitsu I-Network Systems Limited.
+000D57     (base 16)		Fujitsu I-Network Systems Limited.
+				1-403 kosugi-cho nakahara-ku
+				kawasaki  kanagawa  211-0063
+				JP
+
+00-0D-58   (hex)		Private
+000D58     (base 16)		Private
+
+00-0D-51   (hex)		DIVR Systems, Inc.
+000D51     (base 16)		DIVR Systems, Inc.
+				2161 Saturn Ct.
+				Bakersfield  CA  93308
+				US
+
+00-0D-39   (hex)		Network Electronics
+000D39     (base 16)		Network Electronics
+				Box 1020
+				Sandefjord  Sandefjord  N3204
+				NO
+
+00-0D-35   (hex)		PAC International Ltd
+000D35     (base 16)		PAC International Ltd
+				1 Park Gate Close
+				Stockport  Cheshire  SK6 2SZ
+				GB
+
+00-0D-95   (hex)		Opti-cell, Inc.
+000D95     (base 16)		Opti-cell, Inc.
+				100 High Tower Blvd.,  Suite 301
+				Pittsburgh  PA  15205
+				US
+
+00-0D-91   (hex)		Eclipse (HQ Espana) S.L.
+000D91     (base 16)		Eclipse (HQ Espana) S.L.
+				CC de Negocios
+				Puerto de Banus  Marbella  29660
+				ES
+
+00-0D-62   (hex)		Funkwerk Dabendorf GmbH
+000D62     (base 16)		Funkwerk Dabendorf GmbH
+				Maerkische Strasse
+				Dabendorf  Brandenburg  15806
+				DE
+
+00-0D-65   (hex)		Cisco Systems, Inc
+000D65     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-45   (hex)		Tottori SANYO Electric Co., Ltd.
+000D45     (base 16)		Tottori SANYO Electric Co., Ltd.
+				3-201, Minami Yoshikata
+				Tottori City  Tottori  680-8634
+				JP
+
+00-0D-A1   (hex)		MIRAE ITS Co.,LTD.
+000DA1     (base 16)		MIRAE ITS Co.,LTD.
+				7F, ChangHyun B/D,960-1,HoGye1Dong
+				AnYang  KyongiGiDo  431-840
+				KR
+
+00-0D-80   (hex)		Online Development Inc
+000D80     (base 16)		Online Development Inc
+				7209 Chapman Hwy
+				Knoxville  Tn  37920
+				US
+
+00-0D-13   (hex)		Wilhelm Rutenbeck GmbH&Co.KG
+000D13     (base 16)		Wilhelm Rutenbeck GmbH&Co.KG
+				Niederworth 1-10
+				Schalksmühle  NRW  58579
+				DE
+
+00-0D-19   (hex)		ROBE Show lighting
+000D19     (base 16)		ROBE Show lighting
+				Hazovice 2090
+				Roznov pod Radhostem    756 61
+				US
+
+00-0D-1C   (hex)		Amesys Defense
+000D1C     (base 16)		Amesys Defense
+				1030 Av de la LAUZIERE
+				AIX en PROVENCE  Cedex 03  13794
+				FR
+
+00-0C-ED   (hex)		Real Digital Media
+000CED     (base 16)		Real Digital Media
+				485 North Keller Road
+				Maitland  FL  32751
+				US
+
+00-0C-F0   (hex)		M & N GmbH
+000CF0     (base 16)		M & N GmbH
+				Dieselstr 18
+				Rosbach v.d.H.    61191
+				DE
+
+00-0C-F4   (hex)		AKATSUKI ELECTRIC MFG.CO.,LTD.
+000CF4     (base 16)		AKATSUKI ELECTRIC MFG.CO.,LTD.
+				593-1,aoji­ cho
+				kusatsu shi  shiga  525-0041
+				JP
+
+00-0C-F3   (hex)		CALL IMAGE SA
+000CF3     (base 16)		CALL IMAGE SA
+				867 Route Imperiale
+				BAILLARGUES    34670
+				FR
+
+00-0C-CF   (hex)		Cisco Systems, Inc
+000CCF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-D8   (hex)		M. K. Juchheim GmbH & Co
+000CD8     (base 16)		M. K. Juchheim GmbH & Co
+				Moltkestraße 13 - 31
+				Fulda  Hessen  36039
+				DE
+
+00-0C-C6   (hex)		Ka-Ro electronics GmbH
+000CC6     (base 16)		Ka-Ro electronics GmbH
+				Pascalstraße 22
+				Aachen  NW  52076
+				DE
+
+00-0D-01   (hex)		P&E Microcomputer Systems, Inc.
+000D01     (base 16)		P&E Microcomputer Systems, Inc.
+				710 Commonwealth Ave
+				Boston  Ma  02215
+				US
+
+00-0D-00   (hex)		Seaway Networks Inc.
+000D00     (base 16)		Seaway Networks Inc.
+				1 Chrysalis Way
+				Ottawa  Ontario  K2G 6P9
+				CA
+
+00-0C-F9   (hex)		Xylem Water Solutions
+000CF9     (base 16)		Xylem Water Solutions
+				Gesallvagen
+				    
+				SE
+
+00-0C-C4   (hex)		Tiptel AG
+000CC4     (base 16)		Tiptel AG
+				Halskestrasse 1
+				Ratingen  NRW  40880
+				DE
+
+00-0C-BA   (hex)		Jamex, Inc.
+000CBA     (base 16)		Jamex, Inc.
+				2415 N Triphammer Rd
+				Ithaca  NY  14850
+				US
+
+00-0C-D1   (hex)		SFOM Technology Corp.
+000CD1     (base 16)		SFOM Technology Corp.
+				No.18, Lane 32, Wufu 1st Rd., Luju shian
+				Luju Shiang  Tauyuan County  338
+				TW
+
+00-0C-CE   (hex)		Cisco Systems, Inc
+000CCE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-E0   (hex)		Trek Diagnostics Inc.
+000CE0     (base 16)		Trek Diagnostics Inc.
+				982 Keynote Circle
+				Cleveland  Ohio  44131
+				US
+
+00-0C-E2   (hex)		Rolls-Royce
+000CE2     (base 16)		Rolls-Royce
+				105 N. Sandusky St.
+				Mt. Vernon  Ohio  43050
+				US
+
+00-0D-0C   (hex)		MDI Security Systems
+000D0C     (base 16)		MDI Security Systems
+				9518 Ninth Street
+				Rancho Cucamonga  CA  91730
+				US
+
+00-0D-16   (hex)		UHS Systems Pty Ltd
+000D16     (base 16)		UHS Systems Pty Ltd
+				PO Box 6264
+				Alexandria  NSW  2015
+				AU
+
+00-0D-1F   (hex)		AV Digital
+000D1F     (base 16)		AV Digital
+				Pottendorfer Strasse 25-27/4/1/1
+				Wien    1120
+				AT
+
+00-0C-AD   (hex)		BTU International
+000CAD     (base 16)		BTU International
+				23 Esquire Rd
+				North Billerica  MA  01862
+				US
+
+00-0C-AA   (hex)		Cubic Transportation Systems Inc
+000CAA     (base 16)		Cubic Transportation Systems Inc
+				1308 S. Washington Street
+				Tullahoma  TN  37388
+				US
+
+00-0C-AC   (hex)		Citizen Watch Co., Ltd.
+000CAC     (base 16)		Citizen Watch Co., Ltd.
+				6-1-12, Tanashi-cho
+				Nishi-Tokyo-shi  Tokyo  188-8511
+				JP
+
+00-0C-AE   (hex)		Ailocom Oy
+000CAE     (base 16)		Ailocom Oy
+				Hatanpaan valtatie 24
+				TAMPERE  FIN  33950
+				FI
+
+00-0C-A3   (hex)		Rancho Technology, Inc.
+000CA3     (base 16)		Rancho Technology, Inc.
+				10783 Bell Court
+				Rancho Cucamonga  CA  19730
+				US
+
+00-0C-9C   (hex)		Chongho information & communications
+000C9C     (base 16)		Chongho information & communications
+				Chongho Bldg, #7-61 Yangjae-dong, Seocho
+				Seoul    137-130
+				KR
+
+00-0C-97   (hex)		NV ADB TTV Technologies SA
+000C97     (base 16)		NV ADB TTV Technologies SA
+				LEUVENSESTEENWEG,585
+				ZAVENTEM  Vlaamse brabant  1930
+				BE
+
+00-0C-8F   (hex)		Nergal s.r.l.
+000C8F     (base 16)		Nergal s.r.l.
+				Viale Bardanzellu,8
+				Roma    00155
+				IT
+
+00-0C-92   (hex)		WolfVision Gmbh
+000C92     (base 16)		WolfVision Gmbh
+				VWP
+				Goetzis  Vorarlberg  A-6840
+				AT
+
+00-0C-93   (hex)		Xeline Co., Ltd.
+000C93     (base 16)		Xeline Co., Ltd.
+				7F. Chungjin Bldg., 475-22
+				Seoul    137-819
+				KR
+
+00-0C-7F   (hex)		synertronixx GmbH
+000C7F     (base 16)		synertronixx GmbH
+				Lange Laube 22
+				Hannover  Niedersachsen  30159
+				DE
+
+00-0C-81   (hex)		Schneider Electric (Australia) 
+000C81     (base 16)		Schneider Electric (Australia) 
+				80 Schneider Road
+				Eagle Farm   Qld  4009
+				AU
+
+00-0C-9E   (hex)		MemoryLink Corp.
+000C9E     (base 16)		MemoryLink Corp.
+				36 Jewelers Park Drive
+				Neenah  Wisconsin  54957
+				US
+
+00-0C-95   (hex)		PrimeNet
+000C95     (base 16)		PrimeNet
+				Hongik University, 72-1, Sangsu-Dong, Ma
+				Seoul    121-791
+				KR
+
+00-0C-76   (hex)		MICRO-STAR INTERNATIONAL CO., LTD.
+000C76     (base 16)		MICRO-STAR INTERNATIONAL CO., LTD.
+				No 69, Li-De Street, Jung-He City, Taipe
+				Taipei    
+				TW
+
+00-0C-80   (hex)		Opelcomm Inc.
+000C80     (base 16)		Opelcomm Inc.
+				46750 Fremont Blvd. Ste 210
+				Fremont  CA  94538
+				US
+
+00-0C-7D   (hex)		TEIKOKU ELECTRIC MFG. CO., LTD
+000C7D     (base 16)		TEIKOKU ELECTRIC MFG. CO., LTD
+				60,HIRANO
+				IBO-GUN  HYOGO  679-4395
+				JP
+
+00-0C-B7   (hex)		Nanjing Huazhuo Electronics Co., Ltd.
+000CB7     (base 16)		Nanjing Huazhuo Electronics Co., Ltd.
+				No.77 Gaohu Road
+				Nanjing  Jiangsu  211100
+				CN
+
+00-0C-68   (hex)		SigmaTel, Inc.
+000C68     (base 16)		SigmaTel, Inc.
+				201 Jones Road
+				Waltham  MA  02451
+				US
+
+00-0C-07   (hex)		Iftest AG
+000C07     (base 16)		Iftest AG
+				Schwimmbadstrasse 43
+				Wettingen  AG  5430
+				CH
+
+00-0C-0C   (hex)		APPRO TECHNOLOGY INC.
+000C0C     (base 16)		APPRO TECHNOLOGY INC.
+				13F, No. 66 Chung-Cheng Rd,
+				Hsin-Chuang  Taipei  242
+				TW
+
+00-0C-0E   (hex)		XtremeSpectrum, Inc.
+000C0E     (base 16)		XtremeSpectrum, Inc.
+				8133 Leesburg Pike
+				Vienna  VA  22182
+				US
+
+00-0C-12   (hex)		Micro-Optronic-Messtechnik GmbH
+000C12     (base 16)		Micro-Optronic-Messtechnik GmbH
+				Lessingstrasse 14
+				Langebrück  Saxony  D-01465
+				DE
+
+00-0C-10   (hex)		PNI Corporation
+000C10     (base 16)		PNI Corporation
+				5464 Skylane Blvd #A
+				Santa Rosa  CA  95403
+				US
+
+00-0C-40   (hex)		Altech Controls
+000C40     (base 16)		Altech Controls
+				1545 Industial Drive
+				Missouri City  Texas  77489
+				US
+
+00-0C-3E   (hex)		Crest Audio
+000C3E     (base 16)		Crest Audio
+				16-00 Pollitt Drive
+				Fair Lawn  NJ  07410
+				US
+
+00-0C-3A   (hex)		Oxance
+000C3A     (base 16)		Oxance
+				75-85 rue Richelieu
+				les Lucs sur Boulogne    85170
+				FR
+
+00-0C-35   (hex)		KaVo Dental GmbH & Co. KG
+000C35     (base 16)		KaVo Dental GmbH & Co. KG
+				Bismarkring 39
+				Biberach/Riss  Baden-Württemberg  88400
+				DE
+
+00-0C-56   (hex)		Megatel Computer (1986) Corp.
+000C56     (base 16)		Megatel Computer (1986) Corp.
+				586 Main Street
+				Glen Williams  Ontario  L7G 3T6
+				CA
+
+00-0C-57   (hex)		MACKIE Engineering Services Belgium BVBA
+000C57     (base 16)		MACKIE Engineering Services Belgium BVBA
+				Industriepark Noord 10
+				Sint Niklaas    B-9100
+				BE
+
+00-0C-23   (hex)		Beijing Lanchuan Tech. Co., Ltd.
+000C23     (base 16)		Beijing Lanchuan Tech. Co., Ltd.
+				Rm220,No.30 Shangyuancun,Gaoliangqiaolu,
+				Beijing    100044
+				CN
+
+00-0C-25   (hex)		Allied Telesis Labs, Inc. 
+000C25     (base 16)		Allied Telesis Labs, Inc. 
+				Suite 450
+				Raleigh  NC  27606
+				US
+
+00-0C-18   (hex)		Zenisu Keisoku Inc.
+000C18     (base 16)		Zenisu Keisoku Inc.
+				2-13-37
+				Fuchu-shi  Tokyo  183-0027
+				JP
+
+00-0C-0A   (hex)		Guangdong Province Electronic Technology Research Institute
+000C0A     (base 16)		Guangdong Province Electronic Technology Research Institute
+				Electronic Technology Building,NO.61-65,
+				Guangzhou  Guangdong  510630
+				CN
+
+00-0C-0B   (hex)		Broadbus Technologies
+000C0B     (base 16)		Broadbus Technologies
+				80 Central Street
+				Boxborough  Massachusetts  01719
+				US
+
+00-0C-4A   (hex)		Cygnus Microsystems (P) Limited
+000C4A     (base 16)		Cygnus Microsystems (P) Limited
+				93, Phase II,
+				Hyderabad  Andhra Pradesh  500051
+				IN
+
+00-0C-54   (hex)		Pedestal Networks, Inc
+000C54     (base 16)		Pedestal Networks, Inc
+				6503 Dumbarton Circle
+				Fremont  CA  94555
+				US
+
+00-0C-37   (hex)		Geomation, Inc.
+000C37     (base 16)		Geomation, Inc.
+				25188 Genesee Trail Road
+				Golden  CO  80401
+				US
+
+00-0B-E8   (hex)		AOIP
+000BE8     (base 16)		AOIP
+				6 rue Maryse BASTIE
+				COURCOURONNES  Idf  91080
+				FR
+
+00-0B-DC   (hex)		AKCP
+000BDC     (base 16)		AKCP
+				67/285  Muangake Village #8
+				Amphur Muang  Patomthanee  12000
+				TH
+
+00-0B-D8   (hex)		Industrial Scientific Corp.
+000BD8     (base 16)		Industrial Scientific Corp.
+				1001 Oakdale Road
+				Oakdale  PA  15071
+				US
+
+00-0B-D7   (hex)		DORMA Time + Access GmbH
+000BD7     (base 16)		DORMA Time + Access GmbH
+				Mainzer Straße 36-52
+				Bonn  Nordrheinwestfalen  53179
+				DE
+
+00-0B-DD   (hex)		TOHOKU RICOH Co., LTD.
+000BDD     (base 16)		TOHOKU RICOH Co., LTD.
+				3-1 Shinmeido
+				Shibata  Miyagi pref.  989-1695
+				JP
+
+00-0B-E5   (hex)		HIMS International Corporation
+000BE5     (base 16)		HIMS International Corporation
+				139-9
+				Daejeon  Daejeon  305-806
+				KR
+
+00-0B-E9   (hex)		Actel Corporation
+000BE9     (base 16)		Actel Corporation
+				200 Valley Road
+				Mt. Arlington  NJ  07856
+				US
+
+00-0B-E3   (hex)		Key Stream Co., Ltd.
+000BE3     (base 16)		Key Stream Co., Ltd.
+				No. 2 Nagaoka Bldg. 4F,  2-8-5 Hatchobor
+				Chuo-ku  Tokyo  104-0032
+				JP
+
+00-0B-D3   (hex)		cd3o
+000BD3     (base 16)		cd3o
+				402 W Broadway
+				San Deigo  CA  92101
+				US
+
+00-0B-D5   (hex)		Nvergence, Inc.
+000BD5     (base 16)		Nvergence, Inc.
+				Jeil Bldg. 4th, Samsung-dong 168-26, Kan
+				Seoul    135-090
+				KR
+
+00-0B-D1   (hex)		Aeronix, Inc.
+000BD1     (base 16)		Aeronix, Inc.
+				1775 W. Hibiscus Blvd,
+				Melbourne  FL  32901
+				US
+
+00-0B-D2   (hex)		Remopro Technology Inc.
+000BD2     (base 16)		Remopro Technology Inc.
+				No. 443, Huannan RD.,
+				Pingjen City  Taoyuan  324
+				TW
+
+00-0B-C7   (hex)		ICET S.p.A.
+000BC7     (base 16)		ICET S.p.A.
+				Via Quarto Negroni, 63
+				Cecchina di Ariccia  Roma  00040
+				IT
+
+00-0B-B8   (hex)		Kihoku Electronic Co.
+000BB8     (base 16)		Kihoku Electronic Co.
+				Marukatubiru 3F 4-9-6
+				Osakashi  Osaka-hu  556-0005
+				JP
+
+00-0B-C0   (hex)		China IWNComm Co., Ltd.
+000BC0     (base 16)		China IWNComm Co., Ltd.
+				4F.C Xietong Building,No.12 Gaoxin 2nd r
+				Xi'an  shaanxi  710075
+				CN
+
+00-0B-B0   (hex)		Sysnet Telematica srl
+000BB0     (base 16)		Sysnet Telematica srl
+				Viale Berbera, 49
+				Milan    20162
+				IT
+
+00-0B-B4   (hex)		RDC Semiconductor Inc.,
+000BB4     (base 16)		RDC Semiconductor Inc.,
+				6F-1 , No.2-1, Lihsin Rd, Science-Based
+				Hsin Chu    300
+				TW
+
+00-0B-CC   (hex)		JUSAN, S.A.
+000BCC     (base 16)		JUSAN, S.A.
+				Vivero, 5
+				MADRID    28040
+				ES
+
+00-0B-AC   (hex)		3Com Ltd
+000BAC     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-0B-F9   (hex)		Gemstone Communications, Inc.
+000BF9     (base 16)		Gemstone Communications, Inc.
+				6Fl., No. 102,  Hengyang Rd.
+				Taipei    100
+				TW
+
+00-0B-FC   (hex)		Cisco Systems, Inc
+000BFC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-EA   (hex)		Zultys Technologies
+000BEA     (base 16)		Zultys Technologies
+				785 Lucern Drive
+				Sunnyvale  CA  94085
+				US
+
+00-0B-9F   (hex)		Neue ELSA GmbH
+000B9F     (base 16)		Neue ELSA GmbH
+				Sonnenweg 11
+				Aachen    52070
+				DE
+
+00-0B-98   (hex)		NiceTechVision
+000B98     (base 16)		NiceTechVision
+				IntelZone 703
+				YongIn  Gugal-ri  Ki Heung  KyoungKiDo  354-2
+				KR
+
+00-0B-95   (hex)		eBet Gaming Systems Pty Ltd
+000B95     (base 16)		eBet Gaming Systems Pty Ltd
+				Suite D, 255 Rawson Street
+				Auburn  NSW  2144
+				AU
+
+00-0B-9E   (hex)		Yasing Technology Corp.
+000B9E     (base 16)		Yasing Technology Corp.
+				No. 50, Ta Hsueh Road, HsinChu, Taiwan
+				HsinChu    300
+				TW
+
+00-0B-88   (hex)		Vidisco ltd.
+000B88     (base 16)		Vidisco ltd.
+				17 Yechiel Dresner
+				Petach-Tikva    49277
+				IL
+
+00-0B-54   (hex)		BiTMICRO Networks, Inc.
+000B54     (base 16)		BiTMICRO Networks, Inc.
+				47929 Fremont Blvd
+				Fremont  CA  94538
+				US
+
+00-0B-8C   (hex)		Flextronics
+000B8C     (base 16)		Flextronics
+				Migdal HaEmek
+				23108  Hataasia 1  
+				IL
+
+00-0B-8A   (hex)		MITEQ Inc.
+000B8A     (base 16)		MITEQ Inc.
+				100 Davids Drive
+				Hauppauge  NY  11788-2034
+				US
+
+00-0B-90   (hex)		ADVA Optical Networking Ltd.
+000B90     (base 16)		ADVA Optical Networking Ltd.
+				ADVAntage House
+				York    YO30 4RY
+				GB
+
+00-0B-79   (hex)		X-COM, Inc.
+000B79     (base 16)		X-COM, Inc.
+				8809 Sudley Road
+				Manassas  VA  20110
+				US
+
+00-0B-4B   (hex)		VISIOWAVE SA
+000B4B     (base 16)		VISIOWAVE SA
+				Route de la Pierre 22
+				ECUBLENS  VAUD  CH-1024
+				CH
+
+00-0B-36   (hex)		Productivity Systems, Inc.
+000B36     (base 16)		Productivity Systems, Inc.
+				1711 Analog Drive
+				Richardson  TX  75081-1944
+				US
+
+00-0B-35   (hex)		Quad Bit System co., Ltd.
+000B35     (base 16)		Quad Bit System co., Ltd.
+				402 Gayang Technotown
+				Seoul  Kangseogu  157-810
+				KR
+
+00-0B-75   (hex)		Iosoft Ltd.
+000B75     (base 16)		Iosoft Ltd.
+				5 Woodlark Road
+				Cambridge  Cambs.  CB3 0HT
+				GB
+
+00-0B-70   (hex)		Load Technology, Inc.
+000B70     (base 16)		Load Technology, Inc.
+				4225 Production Court
+				Las Vegas  NV  89115
+				US
+
+00-0B-6F   (hex)		Media Streaming Networks Inc
+000B6F     (base 16)		Media Streaming Networks Inc
+				1905 Anam Tower, 702-10, Yeoksam dong, K
+				Seoul    135-080
+				KR
+
+00-0B-43   (hex)		Microscan Systems, Inc.
+000B43     (base 16)		Microscan Systems, Inc.
+				700 SW 39th St
+				Renton  WA  98057
+				US
+
+00-0B-45   (hex)		Cisco Systems, Inc
+000B45     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-4C   (hex)		Clarion (M) Sdn Bhd
+000B4C     (base 16)		Clarion (M) Sdn Bhd
+				Phase 3
+				Bayan Lepas  Penang  11900
+				MY
+
+00-0B-63   (hex)		Kaleidescape
+000B63     (base 16)		Kaleidescape
+				One First Street, Suite Sixteen
+				Los Altos  CA  94022
+				US
+
+00-0B-68   (hex)		Addvalue Communications Pte Ltd
+000B68     (base 16)		Addvalue Communications Pte Ltd
+				28,TAI SENG STREET #06-02
+				Singapore    534106
+				SG
+
+00-0B-58   (hex)		Astronautics C.A  LTD
+000B58     (base 16)		Astronautics C.A  LTD
+				23 hayarkon street
+				Bnei Brak    51261
+				IL
+
+00-0B-55   (hex)		ADInstruments
+000B55     (base 16)		ADInstruments
+				P. O. Box 587
+				Dunedin  Otago  9001
+				NZ
+
+00-0B-87   (hex)		American Reliance Inc.
+000B87     (base 16)		American Reliance Inc.
+				11801 Goldring Rd
+				Arcadia  CA  91006
+				US
+
+00-0B-0D   (hex)		Air2U, Inc.
+000B0D     (base 16)		Air2U, Inc.
+				No. 5-1 Innovation Rd 1, Science-based P
+				Hsin-Chu  Taiwan  300
+				TW
+
+00-0B-0B   (hex)		Corrent Corporation
+000B0B     (base 16)		Corrent Corporation
+				1711 W. Greentree Dr.
+				Tempe  AZ  85284-2717
+				US
+
+00-0B-08   (hex)		Pillar Data Systems
+000B08     (base 16)		Pillar Data Systems
+				1371 McCarthy Blvd.
+				Milpitas  CA  95035
+				US
+
+00-0B-27   (hex)		Scion Corporation
+000B27     (base 16)		Scion Corporation
+				82 Worman's Mill Court
+				Frederick  MD  21701
+				US
+
+00-0B-21   (hex)		G-Star Communications Inc.
+000B21     (base 16)		G-Star Communications Inc.
+				5F, 69-10, Sec. 2, Chung Cheng East Road
+				Taipei Hsien    251
+				TW
+
+00-0A-DA   (hex)		Vindicator Technologies
+000ADA     (base 16)		Vindicator Technologies
+				5307 Industrial Oaks Blvd.
+				Austin  Texas  78735
+				US
+
+00-0A-C9   (hex)		Zambeel Inc
+000AC9     (base 16)		Zambeel Inc
+				45700 Northport Loop East
+				Fremont  CA  94538
+				US
+
+00-0B-25   (hex)		Aeluros
+000B25     (base 16)		Aeluros
+				201 San Antonio Circle #172
+				Mountain View  CA  94040
+				US
+
+00-0B-1A   (hex)		Industrial Defender, Inc.
+000B1A     (base 16)		Industrial Defender, Inc.
+				16 Chestnut Street
+				Foxborough  MA  02035
+				US
+
+00-0B-18   (hex)		Private
+000B18     (base 16)		Private
+
+00-0B-15   (hex)		Platypus Technology
+000B15     (base 16)		Platypus Technology
+				4/1 Atchison St
+				St Leonards  NSW  2065
+				AU
+
+00-0A-FA   (hex)		Traverse Technologies Australia
+000AFA     (base 16)		Traverse Technologies Australia
+				Unit 13, 240 Sydney Rd
+				Coburg  Victoria  3058
+				AU
+
+00-0A-FC   (hex)		Core Tec Communications, LLC
+000AFC     (base 16)		Core Tec Communications, LLC
+				49 Leavenworth Street
+				Waterbury  CT  06702
+				US
+
+00-0A-EC   (hex)		Koatsu Gas Kogyo Co., Ltd.
+000AEC     (base 16)		Koatsu Gas Kogyo Co., Ltd.
+				1-5, Doyama-cho, Kita-ku, Osaka
+				Osaka    530-8411
+				JP
+
+00-0A-E7   (hex)		ELIOP S.A.
+000AE7     (base 16)		ELIOP S.A.
+				Avenida de Manoteras, 30
+				Madrid    E-28050
+				ES
+
+00-0A-E8   (hex)		Cathay Roxus Information Technology Co. LTD
+000AE8     (base 16)		Cathay Roxus Information Technology Co. LTD
+				Fuhua mansion building A/B 4F
+				Beijing    100027
+				CN
+
+00-0A-DD   (hex)		Allworx Corp.
+000ADD     (base 16)		Allworx Corp.
+				245 East Main Street
+				East Rochester  NY  14604
+				US
+
+00-0A-E1   (hex)		EG Technology
+000AE1     (base 16)		EG Technology
+				250 15th Street
+				Atlanta  GA  30318
+				US
+
+00-0A-DF   (hex)		Gennum Corporation
+000ADF     (base 16)		Gennum Corporation
+				P.O Box 489
+				Burlington  Ontario  L7R 3Y3
+				CA
+
+00-0B-3F   (hex)		Anthology Solutions Inc.
+000B3F     (base 16)		Anthology Solutions Inc.
+				1722 Ringwood Ave.
+				San Jose  CA  95131
+				US
+
+00-0B-3C   (hex)		Cygnal Integrated Products, Inc.
+000B3C     (base 16)		Cygnal Integrated Products, Inc.
+				4301 Westbank Drive
+				Austin  TX  78746
+				US
+
+00-0A-F1   (hex)		Clarity Design, Inc.
+000AF1     (base 16)		Clarity Design, Inc.
+				13029 Danielson Street
+				Poway  CA  92064-8810
+				US
+
+00-0A-F3   (hex)		Cisco Systems, Inc
+000AF3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-8D   (hex)		EUROTHERM LIMITED
+000A8D     (base 16)		EUROTHERM LIMITED
+				FARADAY CLOSE
+				WORTHING  WEST SUSSEX  BN13 3PL
+				GB
+
+00-0A-9F   (hex)		Pannaway Technologies, Inc.
+000A9F     (base 16)		Pannaway Technologies, Inc.
+				215 Commerce Way
+				Portsmouth  NH  03801
+				US
+
+00-0A-8F   (hex)		Aska International Inc.
+000A8F     (base 16)		Aska International Inc.
+				306 Riverseven
+				Kochi    780-8088
+				JP
+
+00-0A-A0   (hex)		Cedar Point Communications
+000AA0     (base 16)		Cedar Point Communications
+				16 Route 111, Bldg 3
+				Derry  NH  03038
+				US
+
+00-0A-8E   (hex)		Invacom Ltd
+000A8E     (base 16)		Invacom Ltd
+				Business and Technology Centre
+				Stevenage  Hertfordshire  SG1 2DX
+				GB
+
+00-0A-C1   (hex)		Futuretel
+000AC1     (base 16)		Futuretel
+				21580 Stevens Creek Blvd, Suite 208
+				Cupertino  CA  95014
+				US
+
+00-0A-BE   (hex)		OPNET Technologies CO., LTD.
+000ABE     (base 16)		OPNET Technologies CO., LTD.
+				3F, NO.5, Industry E. Rd. IX, Science-Ba
+				Hsinchu    300
+				TW
+
+00-0A-C3   (hex)		eM Technics Co., Ltd.
+000AC3     (base 16)		eM Technics Co., Ltd.
+				7F., IT Venture Tower., 78,
+				Seoul    138-803
+				KR
+
+00-0A-C4   (hex)		Daewoo Teletech Co., Ltd
+000AC4     (base 16)		Daewoo Teletech Co., Ltd
+				265-3, Seohyeon, Bundang
+				Seongnam  Gyeonggi  
+				KR
+
+00-0A-C0   (hex)		Fuyoh Video Industry CO., LTD.
+000AC0     (base 16)		Fuyoh Video Industry CO., LTD.
+				7-25 Higashi Kibogaoka
+				Yokohama-shi  Kanagawa-ken  246-0008
+				JP
+
+00-0A-AE   (hex)		Rosemount Process Analytical
+000AAE     (base 16)		Rosemount Process Analytical
+				6573A Cochran Rd.
+				Solon  Ohio  44139-3922
+				US
+
+00-0A-B3   (hex)		Fa. GIRA
+000AB3     (base 16)		Fa. GIRA
+				Dahlienstraße
+				Radevormwald  Nordrhein-Westfalen  42477
+				DE
+
+00-0A-BA   (hex)		Arcon Technology Limited
+000ABA     (base 16)		Arcon Technology Limited
+				Rm. 3711-12, 37/F., Cable TV Tower ,
+				Hong Kong    
+				CN
+
+00-0A-B6   (hex)		COMPUNETIX, INC
+000AB6     (base 16)		COMPUNETIX, INC
+				2420 MOSSIDE BLVD.
+				MONROEVILLE  PA  15146
+				US
+
+00-0A-AF   (hex)		Pipal Systems
+000AAF     (base 16)		Pipal Systems
+				2903 Bunker Hill Lane
+				Santa Clara  CA  95054
+				US
+
+00-0A-76   (hex)		Beida Jade Bird Huaguang Technology Co.,Ltd
+000A76     (base 16)		Beida Jade Bird Huaguang Technology Co.,Ltd
+				No.207 Chengfu Road, Haidian District
+				Beijing    100871
+				CN
+
+00-0A-B2   (hex)		Fresnel Wireless Systems
+000AB2     (base 16)		Fresnel Wireless Systems
+				1333 Gateway Drive
+				Melbourne  FL  32901
+				US
+
+00-0A-AA   (hex)		AltiGen Communications Inc.
+000AAA     (base 16)		AltiGen Communications Inc.
+				47427 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-0A-99   (hex)		Calamp Wireless Networks Inc
+000A99     (base 16)		Calamp Wireless Networks Inc
+				101-5540 Ferrier Street
+				Town of Mount-Royal  Quebec  H4P 1M2
+				CA
+
+00-0A-93   (hex)		W2 Networks, Inc.
+000A93     (base 16)		W2 Networks, Inc.
+				5808 NW Lac Leman Drive
+				Issaquah  Washington  98027
+				US
+
+00-0A-89   (hex)		Creval Systems, Inc.
+000A89     (base 16)		Creval Systems, Inc.
+				2F,24-4,Sanwolgok-Dong,Sungbuk-Ku,Seoul,
+				Seoul    136-120
+				KR
+
+00-0A-80   (hex)		Telkonet Inc.
+000A80     (base 16)		Telkonet Inc.
+				20374 Seneca Meadows Pkwy
+				Germantown  MD  21401
+				US
+
+00-0A-79   (hex)		corega K.K
+000A79     (base 16)		corega K.K
+				1-19-20, Shinyokohama
+				Yokohama-city  Kanagawa-ken  222-0033
+				JP
+
+00-0A-5C   (hex)		Carel s.p.a.
+000A5C     (base 16)		Carel s.p.a.
+				Via dell' Industria, 11
+				Brugine  Padova  35020
+				IT
+
+00-0A-5A   (hex)		GreenNET Technologies Co.,Ltd.
+000A5A     (base 16)		GreenNET Technologies Co.,Ltd.
+				No.10, Qiongyu Road,Sciences-based Indus
+				Shenzhen  Guangdong  518057
+				CN
+
+00-0A-56   (hex)		HITACHI Maxell Ltd.
+000A56     (base 16)		HITACHI Maxell Ltd.
+				6-20-1 Kinunodai
+				Yawara-mura, Tsukuba-gun  IBARAKI  300-2496
+				JP
+
+00-0A-51   (hex)		GyroSignal Technology Co., Ltd.
+000A51     (base 16)		GyroSignal Technology Co., Ltd.
+				5F,No. 77,Lide St.
+				Zhonghe City  Taipei County  23556
+				TW
+
+00-0A-2C   (hex)		Active Tchnology Corporation
+000A2C     (base 16)		Active Tchnology Corporation
+				16-23, Shibaura 2-Chome,
+				Tokyo  Tokyo  108-0023
+				JP
+
+00-0A-2A   (hex)		QSI Systems Inc.
+000A2A     (base 16)		QSI Systems Inc.
+				7 Raymond Avenue
+				Salem  NH  03079
+				US
+
+00-0A-23   (hex)		Parama Networks Inc
+000A23     (base 16)		Parama Networks Inc
+				1955 The Alameda
+				San Jose  CA  95126
+				US
+
+00-0A-1F   (hex)		ART WARE Telecommunication Co., Ltd.
+000A1F     (base 16)		ART WARE Telecommunication Co., Ltd.
+				806 Ace Techno Tower #1, 197-17
+				Seoul    152-050
+				KR
+
+00-0A-0A   (hex)		SUNIX Co., Ltd.
+000A0A     (base 16)		SUNIX Co., Ltd.
+				3Fl., No. 76, Baugau Rd.,
+				Shindian  Taipei  231
+				TW
+
+00-0A-05   (hex)		Widax Corp.
+000A05     (base 16)		Widax Corp.
+				269 Stevens Street
+				Hyannis  MA  02668
+				US
+
+00-0A-34   (hex)		Identicard Systems Incorporated
+000A34     (base 16)		Identicard Systems Incorporated
+				40 Citation Lane
+				Lancaster  Pennsylvania  17606
+				US
+
+00-0A-30   (hex)		Visteon Corporation
+000A30     (base 16)		Visteon Corporation
+				One Village Center Drive
+				Van Buren Twp  MI  48111
+				US
+
+00-0A-2F   (hex)		Artnix Inc.
+000A2F     (base 16)		Artnix Inc.
+				Chungjin B/D, 475-22 Bangbae, Seocho
+				Seoul    137-819
+				KR
+
+00-0A-15   (hex)		Silicon Data, Inc
+000A15     (base 16)		Silicon Data, Inc
+				4699 Old Ironsides Dr., #150
+				Santa Clara  CA  95054
+				US
+
+00-0A-1B   (hex)		Stream Labs
+000A1B     (base 16)		Stream Labs
+				Leninskie gori 1, bild 77
+				Moskow    119992
+				RU
+
+00-0A-1A   (hex)		Imerge Ltd
+000A1A     (base 16)		Imerge Ltd
+				Unit 6, Bar Hill Business Park
+				Bar Hill  Cambridge  CB3 8SL
+				GB
+
+00-0A-60   (hex)		Autostar Technology Pte Ltd
+000A60     (base 16)		Autostar Technology Pte Ltd
+				Unit 04-10 TECHplace II
+				Singapore  Singapore  569876
+				SG
+
+00-0A-5D   (hex)		FingerTec Worldwide Sdn Bhd
+000A5D     (base 16)		FingerTec Worldwide Sdn Bhd
+				No 6, 8 & 10
+				Bandar Kinrara 47100 PUchong  Selangor  
+				MY
+
+00-0A-39   (hex)		LoPA Information Technology
+000A39     (base 16)		LoPA Information Technology
+				710-9, Dae Lim 3-Dong
+				Young Deung po-gu  Seoul, Korea  150-814
+				KR
+
+00-0A-37   (hex)		Procera Networks, Inc.
+000A37     (base 16)		Procera Networks, Inc.
+				1299 Orleans Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0A-53   (hex)		Intronics, Incorporated
+000A53     (base 16)		Intronics, Incorporated
+				2020 Lafayette Blvd.
+				Fredericksburg  Virginia  22401
+				US
+
+00-0A-4A   (hex)		Targa Systems Ltd.
+000A4A     (base 16)		Targa Systems Ltd.
+				1905 Grandtech Centre,
+				Shatin  N.T.  
+				HK
+
+00-09-D6   (hex)		KNC One GmbH
+0009D6     (base 16)		KNC One GmbH
+				Hohe Welle 10 B
+				Evessen    38173
+				DE
+
+00-09-C7   (hex)		Movistec
+0009C7     (base 16)		Movistec
+				110-5 Maryoung -ri Seosu-myun
+				Kunsan  Chonbuk  573-940
+				KR
+
+00-09-C9   (hex)		BlueWINC Co., Ltd.
+0009C9     (base 16)		BlueWINC Co., Ltd.
+				401 Korea Design Center
+				Seongnam City  Kyonggi杁o  463-828
+				KR
+
+00-09-D4   (hex)		Transtech Networks
+0009D4     (base 16)		Transtech Networks
+				100 Wood Avenue
+				Iselin  NJ  08830
+				US
+
+00-09-CB   (hex)		HBrain
+0009CB     (base 16)		HBrain
+				#705 Kwanglim Bldg 179 KumiDong
+				Seongnam  GyeonggiDo  463-810
+				KR
+
+00-09-F1   (hex)		Yamaki Electric Corporation
+0009F1     (base 16)		Yamaki Electric Corporation
+				3-7-22 Shimomeguro
+				Meguro-ku  Tokyo  153-0064
+				JP
+
+00-09-F4   (hex)		Alcon Laboratories, Inc.
+0009F4     (base 16)		Alcon Laboratories, Inc.
+				6201 South Freeway
+				Fort Worth  Tx  76134
+				US
+
+00-09-F5   (hex)		Emerson Network Power Co.,Ltd
+0009F5     (base 16)		Emerson Network Power Co.,Ltd
+				1/F,3/F Electric Building Huawei Base,Ba
+				ShenZhen  GuangDong  518029
+				CN
+
+00-09-EA   (hex)		YEM Inc.
+0009EA     (base 16)		YEM Inc.
+				1-3-33
+				Atsugi-shi  Kanagawa  243-0021
+				JP
+
+00-09-C5   (hex)		KINGENE Technology Corporation
+0009C5     (base 16)		KINGENE Technology Corporation
+				7F, No. 144, Minchuan E. Rd. Sec. 3
+				Taipei    105
+				TW
+
+00-09-CD   (hex)		HUDSON SOFT CO.,LTD.
+0009CD     (base 16)		HUDSON SOFT CO.,LTD.
+				C62,Geijutsu-no-mori
+				Sapporo  Hokkaido  005-0864
+				JP
+
+00-09-C0   (hex)		6WIND
+0009C0     (base 16)		6WIND
+				1, place Charles de Gaulle
+				Montigny-le-Bretonneux    78180
+				FR
+
+00-09-BF   (hex)		Nintendo Co., Ltd.
+0009BF     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-09-E3   (hex)		Angel Iglesias S.A.
+0009E3     (base 16)		Angel Iglesias S.A.
+				Polígono 27 Martutene
+				San Sebastián  Guipúzcoa  20014
+				ES
+
+00-09-B4   (hex)		KISAN TELECOM CO., LTD.
+0009B4     (base 16)		KISAN TELECOM CO., LTD.
+				9F, Teawon Bldg., 65 Bangyi-Dong
+				Songpa-Gu  Seoul  138-828
+				KR
+
+00-09-AE   (hex)		OKANO ELECTRIC CO.,LTD
+0009AE     (base 16)		OKANO ELECTRIC CO.,LTD
+				2-8-18 KANAYAMA-CHO
+				HIGASHIKURUME  TOKYO  203-0003
+				JP
+
+00-09-BA   (hex)		MAKU Informationstechik GmbH
+0009BA     (base 16)		MAKU Informationstechik GmbH
+				Gewerbehofstraße 7
+				Essen  NRW  45145
+				DE
+
+00-0A-04   (hex)		3Com Ltd
+000A04     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-09-71   (hex)		Time Management, Inc.
+000971     (base 16)		Time Management, Inc.
+				11 Lake Gatlin Road
+				Orlando  Florida  32806
+				US
+
+00-09-74   (hex)		Innopia Technologies, Inc.
+000974     (base 16)		Innopia Technologies, Inc.
+				5F., Institute of Technology
+				Seoul    133-791
+				KR
+
+00-09-8B   (hex)		Entropic Communications, Inc.
+00098B     (base 16)		Entropic Communications, Inc.
+				9276 Scranton Rd #200
+				San Diego  CA  92121
+				US
+
+00-09-7E   (hex)		IMI TECHNOLOGY CO., LTD
+00097E     (base 16)		IMI TECHNOLOGY CO., LTD
+				2nd floor, Eun Seok Building, 729-1
+				Gangnam-gu  Seoul  135-080
+				KR
+
+00-09-6A   (hex)		Cloverleaf Communications Inc.
+00096A     (base 16)		Cloverleaf Communications Inc.
+				2 Willow St.
+				Southborough  MA  01745-1027
+				US
+
+00-09-5A   (hex)		RACEWOOD TECHNOLOGY
+00095A     (base 16)		RACEWOOD TECHNOLOGY
+				5F-2,NO.6,CHUNG-HSING RD.,SEC.1,WU-GU
+				TAIPEI    248
+				TW
+
+00-09-4E   (hex)		BARTECH SYSTEMS INTERNATIONAL, INC
+00094E     (base 16)		BARTECH SYSTEMS INTERNATIONAL, INC
+				251 Najoles Rd Suite A
+				Millersville  Maryland  21108
+				US
+
+00-09-47   (hex)		Aztek, Inc.
+000947     (base 16)		Aztek, Inc.
+				23 Spectrum Pointe #209
+				Lake Forest  California  92630
+				US
+
+00-09-51   (hex)		Apogee Imaging Systems
+000951     (base 16)		Apogee Imaging Systems
+				151 Sunrise Avenue
+				Roseville  CA  95661
+				US
+
+00-09-3D   (hex)		Newisys,Inc.
+00093D     (base 16)		Newisys,Inc.
+				6200 Bridgepoint Parkway
+				Austin  TX  78730
+				US
+
+00-09-67   (hex)		Tachyon, Inc
+000967     (base 16)		Tachyon, Inc
+				9339 Carroll Park Drive
+				San Diego  CA  92121
+				US
+
+00-09-96   (hex)		RDI
+000996     (base 16)		RDI
+				20406 Earl St.
+				Torrance  CA  90503
+				US
+
+00-09-0C   (hex)		Mayekawa Mfg. Co. Ltd.
+00090C     (base 16)		Mayekawa Mfg. Co. Ltd.
+				16825 IH 35 North
+				Selma  Texas  78154
+				US
+
+00-09-0D   (hex)		LEADER ELECTRONICS CORP.
+00090D     (base 16)		LEADER ELECTRONICS CORP.
+				2-6-33, TSUNASHIMA-HIGASHI
+				YOKOHAMA  KANAGAWA  223-8505
+				JP
+
+00-08-FE   (hex)		UNIK C&C Co.,Ltd.
+0008FE     (base 16)		UNIK C&C Co.,Ltd.
+				706-13 UNIK BLDG 17F
+				SEOUL    135-080
+				KR
+
+00-08-FF   (hex)		Trilogy Communications Ltd
+0008FF     (base 16)		Trilogy Communications Ltd
+				26 Focus Way
+				Andover  Hampshire  SP10 5NY
+				GB
+
+00-09-04   (hex)		MONDIAL electronic
+000904     (base 16)		MONDIAL electronic
+				Eggelsberg 73
+				Eggelsberg  Oberoesterreich  5142
+				AT
+
+00-09-1F   (hex)		A&D Co., Ltd.
+00091F     (base 16)		A&D Co., Ltd.
+				1-243 Asahi
+				Kitamoto-shi  Saitama  364-8585
+				JP
+
+00-09-24   (hex)		Telebau GmbH
+000924     (base 16)		Telebau GmbH
+				Am Kraehenberg 1
+				Waldeck-Sachsenhausen  Germany  34513
+				DE
+
+00-09-21   (hex)		Planmeca Oy
+000921     (base 16)		Planmeca Oy
+				Asentajankatu 6
+				HELSINKI    00810 HELSIN
+				FI
+
+00-09-19   (hex)		MDS Gateways
+000919     (base 16)		MDS Gateways
+				Clonshaugh Industrial Estate
+				Dublin 17    
+				IE
+
+00-09-18   (hex)		SAMSUNG TECHWIN CO.,LTD
+000918     (base 16)		SAMSUNG TECHWIN CO.,LTD
+				42
+				CHANGWON  KYONGNAM  641-716
+				KR
+
+00-09-2F   (hex)		Akom Technology Corporation
+00092F     (base 16)		Akom Technology Corporation
+				5F, No. 323, Yang-Guang St.
+				Taipei    114
+				TW
+
+00-08-EF   (hex)		DIBAL,S.A.
+0008EF     (base 16)		DIBAL,S.A.
+				Astintze Kalea 24
+				Derio  Vizcaya  48160
+				ES
+
+00-08-F0   (hex)		Next Generation Systems, Inc.
+0008F0     (base 16)		Next Generation Systems, Inc.
+				PO BOX 31205
+				Dayton  OH  45437-0205
+				US
+
+00-08-E9   (hex)		NextGig
+0008E9     (base 16)		NextGig
+				9820-B Towne Centre Drive
+				San Diego  CA  92121
+				US
+
+00-09-10   (hex)		Simple Access Inc.
+000910     (base 16)		Simple Access Inc.
+				600 McCaffrey Street
+				St-Laurent  Quebec  H4T1N1
+				CA
+
+00-09-14   (hex)		COMPUTROLS INC.
+000914     (base 16)		COMPUTROLS INC.
+				221 Bark Drive
+				Harvey  LA  70058
+				US
+
+00-08-E7   (hex)		SHI ControlSystems,Ltd.
+0008E7     (base 16)		SHI ControlSystems,Ltd.
+				19,Natusima
+				Yokosuka  Kanagawa  237-8555
+				JP
+
+00-08-D7   (hex)		HOW CORPORATION
+0008D7     (base 16)		HOW CORPORATION
+				1-11-17 Chiyoda
+				Sagamihara  Kanagawa  229-0037
+				JP
+
+00-08-FC   (hex)		Gigaphoton Inc.
+0008FC     (base 16)		Gigaphoton Inc.
+				YOKOKURA SHINDEN400
+				OYAMA  TOTIGI  323-8558
+				JP
+
+00-09-38   (hex)		Allot Communications
+000938     (base 16)		Allot Communications
+				Hanagar 22 st'
+				Hod-Hasharon    45800
+				IL
+
+00-08-BF   (hex)		Aptus Elektronik AB
+0008BF     (base 16)		Aptus Elektronik AB
+				FO Petersons G 6
+				    
+				SE
+
+00-08-B8   (hex)		E.F. Johnson
+0008B8     (base 16)		E.F. Johnson
+				299 Johnson Ave.
+				Waseca  MN  56093
+				US
+
+00-08-BB   (hex)		NetExcell
+0008BB     (base 16)		NetExcell
+				15375 Barranca Pkwy, #E-106
+				Irvine  CA  92679
+				US
+
+00-08-BE   (hex)		XENPAK MSA Group
+0008BE     (base 16)		XENPAK MSA Group
+				Care of: Agilent Technologies
+				Ipswich  Suffolk  Ip1 5PB
+				GB
+
+00-08-C1   (hex)		Avistar Communications Corporation
+0008C1     (base 16)		Avistar Communications Corporation
+				15851 Dallas Pkwy.
+				Addison  TX  75001
+				US
+
+00-08-C6   (hex)		Philips Consumer Communications
+0008C6     (base 16)		Philips Consumer Communications
+				Route d'Angers
+				Cedex 9    
+				FR
+
+00-08-65   (hex)		JASCOM CO., LTD
+000865     (base 16)		JASCOM CO., LTD
+				JUAN INDUSTRIAL COMPLEX 330, 17-1,
+				JUAN-DONG NAM-GU  INCHEON  402-200
+				KR
+
+00-08-64   (hex)		Fasy S.p.A.
+000864     (base 16)		Fasy S.p.A.
+				Via Tognasca 7
+				Gallarate  Varese  21013
+				US
+
+00-08-60   (hex)		LodgeNet Entertainment Corp.
+000860     (base 16)		LodgeNet Entertainment Corp.
+				3900 W. Innovation Street
+				Sioux Falls  SD  57107
+				US
+
+00-08-97   (hex)		Quake Technologies
+000897     (base 16)		Quake Technologies
+				2880 Zanker Road
+				San Jose  CA  95134
+				US
+
+00-08-90   (hex)		AVILINKS SA
+000890     (base 16)		AVILINKS SA
+				Etic Center - CS 77 729
+				Cesson Sevigne Cedex    35577
+				FR
+
+00-08-8D   (hex)		Sigma-Links Inc.
+00088D     (base 16)		Sigma-Links Inc.
+				550-1 Higashiasakawa-cho,
+				Tokyo    193-8550
+				JP
+
+00-08-A8   (hex)		Systec Co., Ltd.
+0008A8     (base 16)		Systec Co., Ltd.
+				19 Nochidori, Nawa
+				Tokai  Aichi  476-0002
+				JP
+
+00-08-A4   (hex)		Cisco Systems, Inc
+0008A4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-00-6B   (hex)		ACCEL TECHNOLOGIES INC.
+08006B     (base 16)		ACCEL TECHNOLOGIES INC.
+				7358 TRADE STREET
+				SAN DIEGO  CA  92121
+				US
+
+00-08-84   (hex)		Index Braille AB
+000884     (base 16)		Index Braille AB
+				Box 155
+				    
+				SE
+
+00-07-E8   (hex)		EdgeWave
+0007E8     (base 16)		EdgeWave
+				15333 Avenue of Science
+				San Diego  CA  92128
+				US
+
+00-07-EB   (hex)		Cisco Systems, Inc
+0007EB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-EC   (hex)		Cisco Systems, Inc
+0007EC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-51   (hex)		Canadian Bank Note Company, Ltd.
+000851     (base 16)		Canadian Bank Note Company, Ltd.
+				18 Auriga Dr.
+				    K2E 7T9
+				CA
+
+00-08-59   (hex)		ShenZhen Unitone Electronics Co., Ltd.
+000859     (base 16)		ShenZhen Unitone Electronics Co., Ltd.
+				2 Southern Floor 702 Building
+				    
+				CN
+
+00-08-4E   (hex)		DivergeNet, Inc.
+00084E     (base 16)		DivergeNet, Inc.
+				2142 Bering Dr.
+				San Jose  CA  95131
+				US
+
+00-08-19   (hex)		Banksys
+000819     (base 16)		Banksys
+				Haachtsesteenweg 1442
+				    
+				BE
+
+00-08-1A   (hex)		Sanrad Intelligence Storage Communications (2000) Ltd.
+00081A     (base 16)		Sanrad Intelligence Storage Communications (2000) Ltd.
+				32 Habarzel St., Entrace B
+				    
+				IL
+
+00-08-10   (hex)		Key Technology, Inc.
+000810     (base 16)		Key Technology, Inc.
+				150 Avery St.
+				Walla Walla  WA  99362
+				US
+
+00-08-07   (hex)		Access Devices Limited
+000807     (base 16)		Access Devices Limited
+				Sixth Floor, 58 Oxbridge Road
+				    
+				GB
+
+00-07-FC   (hex)		Adept Systems Inc.
+0007FC     (base 16)		Adept Systems Inc.
+				2100 Boca Rio Rd.
+				Boca Raton  FL  33433
+				US
+
+00-08-25   (hex)		Acme Packet
+000825     (base 16)		Acme Packet
+				71 Third Avenue
+				Woburn  MA  01803
+				US
+
+00-07-DC   (hex)		Atek Co, Ltd.
+0007DC     (base 16)		Atek Co, Ltd.
+				B dong #205 hanyang venture park
+				Seoul    
+				KR
+
+00-08-1F   (hex)		Pou Yuen Tech Corp. Ltd.
+00081F     (base 16)		Pou Yuen Tech Corp. Ltd.
+				16F, No. 107, Sect. 3, Taichung Keng Rd.
+				    
+				TW
+
+00-07-C6   (hex)		VDS Vosskuhler GmbH
+0007C6     (base 16)		VDS Vosskuhler GmbH
+				Weibe Breite 7
+				    
+				DE
+
+00-07-F5   (hex)		Bridgeco Co AG
+0007F5     (base 16)		Bridgeco Co AG
+				Ringstr. 14
+				    
+				CH
+
+00-07-94   (hex)		Simple Devices, Inc.
+000794     (base 16)		Simple Devices, Inc.
+				111 Anza Blvd., Suite 120
+				Burlingame  CA  94010
+				US
+
+00-07-97   (hex)		Netpower Co., Ltd.
+000797     (base 16)		Netpower Co., Ltd.
+				Baekam Bldg., 6F
+				Seoul    138-162
+				KR
+
+00-07-8C   (hex)		Elektronikspecialisten i Borlange AB
+00078C     (base 16)		Elektronikspecialisten i Borlange AB
+				Box 50
+				    SE 780
+				SE
+
+00-07-CC   (hex)		Kaba Benzing GmbH
+0007CC     (base 16)		Kaba Benzing GmbH
+				Albertistrabe 3
+				    
+				DE
+
+00-07-C0   (hex)		NetZerver Inc.
+0007C0     (base 16)		NetZerver Inc.
+				26 West Lone Cactus Drive
+				Phoenix  AZ  85027
+				US
+
+00-04-7E   (hex)		Siqura B.V.
+00047E     (base 16)		Siqura B.V.
+				Zuidelijk Halfrond 4
+				    
+				NL
+
+00-07-BC   (hex)		Identix Inc.
+0007BC     (base 16)		Identix Inc.
+				6591 Sierra Lane
+				Dublin  CA  94568
+				US
+
+00-07-A9   (hex)		Novasonics
+0007A9     (base 16)		Novasonics
+				1390 Willow Road
+				Menlo Park  CA  94025
+				US
+
+00-07-A1   (hex)		VIASYS Healthcare GmbH
+0007A1     (base 16)		VIASYS Healthcare GmbH
+				Leibnizstraße 7
+				Hoechberg  Bavaria  97204
+				DE
+
+00-07-9E   (hex)		Ilinx Co., Ltd.
+00079E     (base 16)		Ilinx Co., Ltd.
+				4th Floor Korea Telecom, Yangjae Branch
+				Seoul    
+				KR
+
+00-07-A0   (hex)		e-Watch Inc.
+0007A0     (base 16)		e-Watch Inc.
+				7800 IH 10 West
+				San Antonio  TX  78229
+				US
+
+00-07-88   (hex)		Clipcomm, Inc.
+000788     (base 16)		Clipcomm, Inc.
+				5th Fl, Ssangyang Bldg.
+				Seoul    151-827
+				KR
+
+00-07-81   (hex)		Itron Inc.
+000781     (base 16)		Itron Inc.
+				2818 N. Sullivan Road
+				Spokane  WA  99216
+				US
+
+00-07-6B   (hex)		Stralfors AB
+00076B     (base 16)		Stralfors AB
+				Langgatan 21
+				    
+				SE
+
+00-07-68   (hex)		Danfoss A/S
+000768     (base 16)		Danfoss A/S
+				E16-N12, DK-6430 Nordborg
+				    
+				
+
+00-07-5F   (hex)		VCS Video Communication Systems AG
+00075F     (base 16)		VCS Video Communication Systems AG
+				Forchheimer Str. 4
+				    
+				DE
+
+00-07-B8   (hex)		Corvalent Corporation
+0007B8     (base 16)		Corvalent Corporation
+				1101 Arrow Point Dr #501
+				Cedar Park  TX  78613
+				US
+
+00-07-7B   (hex)		Millimetrix Broadband Networks
+00077B     (base 16)		Millimetrix Broadband Networks
+				Kibutz Givat Hashelosha 48800
+				    
+				IL
+
+00-07-69   (hex)		Italiana Macchi SpA
+000769     (base 16)		Italiana Macchi SpA
+				Via Matteotti 1
+				    
+				IT
+
+00-07-1A   (hex)		Finedigital Inc.
+00071A     (base 16)		Finedigital Inc.
+				4th Fl. Bomi Bldg., 661 Deungchon 3 Dong
+				Seoul    157-033
+				KR
+
+00-07-1E   (hex)		Tri-M Engineering / Nupak Dev. Corp.
+00071E     (base 16)		Tri-M Engineering / Nupak Dev. Corp.
+				6-1301 Ketch Court
+				    V3K 6X7
+				CA
+
+00-07-17   (hex)		Wieland Electric GmbH
+000717     (base 16)		Wieland Electric GmbH
+				Brennerstraße 10-14
+				    
+				DE
+
+00-07-11   (hex)		Acterna
+000711     (base 16)		Acterna
+				6620 Network Way
+				Indianapolis  IN  46278
+				US
+
+00-07-02   (hex)		Varex Imaging
+000702     (base 16)		Varex Imaging
+				1678 South Pioneer Road
+				Salt Lake City  UT  84104
+				US
+
+00-07-05   (hex)		Endress & Hauser GmbH & Co
+000705     (base 16)		Endress & Hauser GmbH & Co
+				Hauptstrabe 1 - Postfach 1261
+				    
+				DE
+
+00-06-FF   (hex)		Sheba Systems Co., Ltd.
+0006FF     (base 16)		Sheba Systems Co., Ltd.
+				5th Fl. Hyundai Jad B/D
+				Seoul    134-030
+				KR
+
+00-07-41   (hex)		Sierra Automated Systems
+000741     (base 16)		Sierra Automated Systems
+				2821 Burton Ave.
+				Burbank  CA  91504
+				US
+
+00-07-45   (hex)		Radlan Computer Communications Ltd.
+000745     (base 16)		Radlan Computer Communications Ltd.
+				Atidim Technology Park
+				Tel Aviv    61131
+				IL
+
+00-07-3E   (hex)		China Great-Wall Computer Shenzhen Co., Ltd.
+00073E     (base 16)		China Great-Wall Computer Shenzhen Co., Ltd.
+				Research & Development Center, Kefa Road
+				Shenzhen    518057
+				CN
+
+00-07-33   (hex)		DANCONTROL Engineering
+000733     (base 16)		DANCONTROL Engineering
+				Italiensvej 1-5
+				    
+				DK
+
+00-07-2B   (hex)		Jung Myung Telecom Co., Ltd.
+00072B     (base 16)		Jung Myung Telecom Co., Ltd.
+				5Fl Silla Technovil., 39-3 Dang-Dong
+				    
+				KR
+
+00-07-18   (hex)		iCanTek Co., Ltd.
+000718     (base 16)		iCanTek Co., Ltd.
+				2nd Fl. DK Plaza II, 376-5,
+				Sungman-si, Kyonggi-do    463-805
+				KR
+
+00-07-16   (hex)		J & S Marine Ltd.
+000716     (base 16)		J & S Marine Ltd.
+				Pottington Business Park
+				Devon    EX31 1LY
+				GB
+
+00-07-5C   (hex)		Eastman Kodak Company
+00075C     (base 16)		Eastman Kodak Company
+				343 State Street
+				Rochester  NY  146501245
+				US
+
+00-07-56   (hex)		Juyoung Telecom
+000756     (base 16)		Juyoung Telecom
+				#201, Dunsan Building
+				Taejon    302-846
+				KR
+
+00-07-5A   (hex)		Air Products and Chemicals, Inc.
+00075A     (base 16)		Air Products and Chemicals, Inc.
+				7201 Hamilton Blvd.
+				Allentown  PA  18195-1501
+				US
+
+00-07-48   (hex)		The Imaging Source Europe
+000748     (base 16)		The Imaging Source Europe
+				Sommerstraße 34-36
+				    
+				DE
+
+00-07-46   (hex)		TURCK, Inc.
+000746     (base 16)		TURCK, Inc.
+				3000 Campus Drive
+				Plymouth  MN  55441
+				US
+
+00-07-3B   (hex)		Tenovis GmbH & Co KG
+00073B     (base 16)		Tenovis GmbH & Co KG
+				Kleyerstraße 94
+				    
+				DE
+
+00-07-31   (hex)		Ophir-Spiricon LLC
+000731     (base 16)		Ophir-Spiricon LLC
+				3050 N 300 W
+				North Logan  UT  84341
+				US
+
+00-07-0A   (hex)		Unicom Automation Co., Ltd.
+00070A     (base 16)		Unicom Automation Co., Ltd.
+				Silk Bldg 3-31-11
+				Tokyo    164-0012
+				JP
+
+00-07-09   (hex)		Westerstrand Urfabrik AB
+000709     (base 16)		Westerstrand Urfabrik AB
+				Box 133
+				    
+				SE
+
+00-06-EB   (hex)		Global Data
+0006EB     (base 16)		Global Data
+				2250 Obispo Ave #105
+				Signal Hill  CA  90806
+				US
+
+00-06-D3   (hex)		Alpha Telecom, Inc. U.S.A.
+0006D3     (base 16)		Alpha Telecom, Inc. U.S.A.
+				1394 Borregor Ave.
+				Sunnyvale  CA  94089
+				US
+
+00-06-47   (hex)		Etrali S.A.
+000647     (base 16)		Etrali S.A.
+				221, Rue La Fontaine
+				    
+				FR
+
+00-06-A4   (hex)		INNOWELL Corp.
+0006A4     (base 16)		INNOWELL Corp.
+				#717 ChongGu Bluevill
+				    463-825
+				KR
+
+00-06-D6   (hex)		Cisco Systems, Inc
+0006D6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-CB   (hex)		Jotron Electronics A/S
+0006CB     (base 16)		Jotron Electronics A/S
+				Pob 54
+				    
+				NO
+
+00-06-CD   (hex)		Leaf Imaging Ltd.
+0006CD     (base 16)		Leaf Imaging Ltd.
+				7th Hatnufa st
+				Petach-Tikva    49002
+				IL
+
+00-06-95   (hex)		Ensure Technologies, Inc.
+000695     (base 16)		Ensure Technologies, Inc.
+				3526 West Liberty
+				Ann Arbor  MI  48103
+				US
+
+00-06-91   (hex)		PT Inovacao
+000691     (base 16)		PT Inovacao
+				Rua Eng. Jose F. Pinto Basto
+				    
+				PT
+
+00-06-92   (hex)		Intruvert Networks, Inc.
+000692     (base 16)		Intruvert Networks, Inc.
+				Suite 102
+				San Jose  CA  95131
+				US
+
+00-06-8B   (hex)		AirRunner Technologies, Inc.
+00068B     (base 16)		AirRunner Technologies, Inc.
+				2401 Lupine Trail
+				South Lake Tahoe  CA  96150
+				US
+
+00-06-88   (hex)		Telways Communication Co., Ltd.
+000688     (base 16)		Telways Communication Co., Ltd.
+				3F, No. 53, Lane 258
+				Taipei    114
+				TW
+
+00-06-AB   (hex)		W-Link Systems, Inc.
+0006AB     (base 16)		W-Link Systems, Inc.
+				No. 20, Park Ave. II,
+				Hsinchu    300
+				TW
+
+00-06-AC   (hex)		Intersoft Co.
+0006AC     (base 16)		Intersoft Co.
+				#1803 sun-kyoung Officetel
+				Seoul    
+				KR
+
+00-06-94   (hex)		Mobillian Corporation
+000694     (base 16)		Mobillian Corporation
+				11031 Via Frontera
+				San Diego  CA  92127
+				US
+
+00-06-C7   (hex)		RFNET Technologies Pte Ltd (S)
+0006C7     (base 16)		RFNET Technologies Pte Ltd (S)
+				Unit 233 Innovation Centre Blk 2
+				    637722
+				SG
+
+00-06-B9   (hex)		A5TEK Corp.
+0006B9     (base 16)		A5TEK Corp.
+				1233 Alderwood Ave.
+				Sunnyvale  CA  94089
+				US
+
+00-06-B3   (hex)		Diagraph Corporation
+0006B3     (base 16)		Diagraph Corporation
+				3401 Rider Trail South
+				Earth City  MO  63045-1110
+				US
+
+00-06-E3   (hex)		Quantitative Imaging Corporation
+0006E3     (base 16)		Quantitative Imaging Corporation
+				8081 Lougheed Highway
+				    
+				CA
+
+00-06-E4   (hex)		Citel Technologies Ltd.
+0006E4     (base 16)		Citel Technologies Ltd.
+				Wheatcroft Business Park
+				Nottigham    NG12 4DG
+				GB
+
+00-06-A1   (hex)		Celsian Technologies, Inc.
+0006A1     (base 16)		Celsian Technologies, Inc.
+				3002 Dow Ave., Unit 138
+				Tustin  CA  92780
+				US
+
+00-06-D9   (hex)		IPM-Net S.p.A.
+0006D9     (base 16)		IPM-Net S.p.A.
+				Via Remo De Feo
+				    
+				IT
+
+00-06-63   (hex)		Human Technology Co., Ltd.
+000663     (base 16)		Human Technology Co., Ltd.
+				3rd Fl, Hyungok Bldg.,
+				Kangnam-ku  Seoul  
+				KR
+
+00-06-65   (hex)		Sunny Giken, Inc.
+000665     (base 16)		Sunny Giken, Inc.
+				3-1-9 Nishidai Itami-shi
+				Hyogo-pref.    664-0858
+				JP
+
+00-06-69   (hex)		Datasound Laboratories Ltd
+000669     (base 16)		Datasound Laboratories Ltd
+				5 Business Park West, Avenue One
+				  ENGLAND  
+				GB
+
+00-06-6E   (hex)		Delta Electronics, Inc.
+00066E     (base 16)		Delta Electronics, Inc.
+				11F, 266 Wen-Hwa 2nd Road,
+				    
+				TW
+
+00-06-1B   (hex)		Notebook Development Lab.  Lenovo Japan Ltd.
+00061B     (base 16)		Notebook Development Lab.  Lenovo Japan Ltd.
+				1623-14 Shimotsuruma
+				    242-8502
+				JP
+
+00-06-0F   (hex)		Narad Networks Inc
+00060F     (base 16)		Narad Networks Inc
+				515 Groton Road
+				Westford  MA  01886
+				US
+
+00-06-10   (hex)		Abeona Networks Inc
+000610     (base 16)		Abeona Networks Inc
+				46117 Landing Parkway
+				Fremont  CA  94539
+				US
+
+00-06-11   (hex)		Zeus Wireless, Inc.
+000611     (base 16)		Zeus Wireless, Inc.
+				8325 Guilford Road
+				Columbia  MD  21046
+				US
+
+00-05-EC   (hex)		Mosaic Systems Inc.
+0005EC     (base 16)		Mosaic Systems Inc.
+				7 Campbell Park
+				Somerville  MA  02144
+				US
+
+00-06-62   (hex)		MBM Technology Ltd.
+000662     (base 16)		MBM Technology Ltd.
+				Victoria Rd.
+				    
+				GB
+
+00-06-5A   (hex)		Strix Systems
+00065A     (base 16)		Strix Systems
+				310 N. Westlake Blvd.
+				Westlake Village  CA  91362
+				US
+
+00-06-52   (hex)		Cisco Systems, Inc
+000652     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-56   (hex)		Tactel AB
+000656     (base 16)		Tactel AB
+				Norra Vallgatan 64
+				    
+				SE
+
+00-06-41   (hex)		ITCN
+000641     (base 16)		ITCN
+				8571 Gander Creek Drive
+				Miamisburg  OH  45342
+				US
+
+00-06-48   (hex)		Seedsware, Inc.
+000648     (base 16)		Seedsware, Inc.
+				 3-7-16 Technostage,
+				Izumi,  Osaka  594-1144
+				JP
+
+00-06-4C   (hex)		Invicta Networks, Inc.
+00064C     (base 16)		Invicta Networks, Inc.
+				13873 Park Center Road
+				Herndon  VA  20171
+				US
+
+00-06-74   (hex)		Spectrum Control, Inc.
+000674     (base 16)		Spectrum Control, Inc.
+				8061 Avonia Road
+				Fairview  PA  16415
+				US
+
+00-06-38   (hex)		Sungjin C&C Co., Ltd.
+000638     (base 16)		Sungjin C&C Co., Ltd.
+				1543-6, Seocho-dong, Seocho-gu,
+				Seoul    137-073
+				KR
+
+00-06-35   (hex)		PacketAir Networks, Inc.
+000635     (base 16)		PacketAir Networks, Inc.
+				11545 W. Bernardo Ct.
+				San Diego  CA  92127
+				US
+
+00-06-1A   (hex)		Zetari Inc.
+00061A     (base 16)		Zetari Inc.
+				411 Waverly Oaks Rd.
+				Waltham  MA  02452-8401
+				US
+
+00-06-1F   (hex)		Vision Components GmbH
+00061F     (base 16)		Vision Components GmbH
+				Ottostraße 2
+				    
+				DE
+
+00-06-87   (hex)		Omnitron Systems Technology, Inc.
+000687     (base 16)		Omnitron Systems Technology, Inc.
+				140 Technology
+				Irvine  CA  92618
+				US
+
+00-06-02   (hex)		Cirkitech Electronics Co.
+000602     (base 16)		Cirkitech Electronics Co.
+				B1-2, No. 361, Fu-Xing First Road
+				  Tao-Yuan  
+				TW
+
+00-05-C0   (hex)		Digital Network Alacarte Co., Ltd.
+0005C0     (base 16)		Digital Network Alacarte Co., Ltd.
+				A104, Seoul Business Incubator
+				Seoul    157-030,
+				KR
+
+00-05-B8   (hex)		Electronic Design Associates, Inc.
+0005B8     (base 16)		Electronic Design Associates, Inc.
+				331 Arcado Rd. NW
+				Lilburn  GA  30047-2841
+				US
+
+00-05-BA   (hex)		Area Netwoeks, Inc.
+0005BA     (base 16)		Area Netwoeks, Inc.
+				1148 Euclid Ave., Suite 400
+				Cleveland  OH  4415
+				US
+
+00-05-BF   (hex)		JustEzy Technology, Inc.
+0005BF     (base 16)		JustEzy Technology, Inc.
+				5F, No. 324, Sec. 1, Junghua Rd.
+				Hsinchu    
+				TW
+
+00-05-D5   (hex)		Speedcom Wireless
+0005D5     (base 16)		Speedcom Wireless
+				7020 Professional Pkwy East
+				Sarasota  FL  34240-8514
+				US
+
+00-05-C5   (hex)		Flaga HF
+0005C5     (base 16)		Flaga HF
+				Vesturhlid 7
+				    
+				IS
+
+00-05-CA   (hex)		Hitron Technology, Inc.
+0005CA     (base 16)		Hitron Technology, Inc.
+				HSINCHU SBIP SUBSIDIARY
+				Hsin-chu    
+				TW
+
+00-05-D2   (hex)		DAP Technologies
+0005D2     (base 16)		DAP Technologies
+				955 Fernand Dufour,
+				    G1M 3B2
+				CA
+
+00-05-B1   (hex)		ASB Technology BV
+0005B1     (base 16)		ASB Technology BV
+				De Ronde 15A
+				    
+				NL
+
+00-05-99   (hex)		DRS Test and Energy Management or DRS-TEM
+000599     (base 16)		DRS Test and Energy Management or DRS-TEM
+				110 Wynn Drive
+				Huntsville  AL  35805
+				US
+
+00-05-9A   (hex)		Cisco Systems, Inc
+00059A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-AB   (hex)		Cyber Fone, Inc.
+0005AB     (base 16)		Cyber Fone, Inc.
+				989 Old Eagle School Road
+				Wayne  PA  19087
+				US
+
+00-05-92   (hex)		Pultek Corp.
+000592     (base 16)		Pultek Corp.
+				74-1, Yamashita-cho,
+				    231-0023
+				JP
+
+00-05-8B   (hex)		IPmental, Inc.
+00058B     (base 16)		IPmental, Inc.
+				8F-9, No. 35, Hsin Tai Rd.
+				    
+				TW
+
+00-05-AC   (hex)		Northern Digital, Inc.
+0005AC     (base 16)		Northern Digital, Inc.
+				103 Randall Drive
+				Waterloo   Ontario  N2V 1C5
+				CA
+
+00-05-AD   (hex)		Topspin Communications, Inc.
+0005AD     (base 16)		Topspin Communications, Inc.
+				515 Ellis Street
+				Mountain View  CA  94043
+				US
+
+00-05-D1   (hex)		Metavector Technologies
+0005D1     (base 16)		Metavector Technologies
+				Steenweg Op Gierle, 100
+				    
+				BE
+
+00-05-FB   (hex)		ShareGate, Inc.
+0005FB     (base 16)		ShareGate, Inc.
+				9805 Double R Blvd.
+				Reno  NV  89511-5917
+				US
+
+00-05-FE   (hex)		Traficon N.V.
+0005FE     (base 16)		Traficon N.V.
+				Bissegemsestraat 45
+				    
+				BE
+
+00-05-F0   (hex)		SATEC
+0005F0     (base 16)		SATEC
+				P.O. Box 45022
+				  91450  
+				IL
+
+00-05-30   (hex)		Andiamo Systems, Inc.
+000530     (base 16)		Andiamo Systems, Inc.
+				375 E. Tasman Dr.
+				San Jose  CA  95134
+				US
+
+00-05-38   (hex)		Merilus, Inc.
+000538     (base 16)		Merilus, Inc.
+				#307-46165 Yale Road
+				    V2P 2P2
+				CA
+
+00-05-2B   (hex)		HORIBA, Ltd.
+00052B     (base 16)		HORIBA, Ltd.
+				2 Miyanohigashi, Kisshoin,
+				    601-8510
+				JP
+
+00-05-1D   (hex)		Airocon, Inc.
+00051D     (base 16)		Airocon, Inc.
+				116 Houghton Lane
+				Boxboro  MA  01719
+				US
+
+00-05-15   (hex)		Nuark Co., Ltd.
+000515     (base 16)		Nuark Co., Ltd.
+				12F, Anyang K center, 1591-9, Burim-dong
+				  Gunggi-do  431-065
+				KR
+
+00-05-16   (hex)		SMART Modular Technologies
+000516     (base 16)		SMART Modular Technologies
+				4305 Cushing Pkwy
+				Fremont  CA  94538
+				US
+
+00-05-77   (hex)		SM Information & Communication
+000577     (base 16)		SM Information & Communication
+				330-1 Yangjaedong
+				    137-130
+				KR
+
+00-05-70   (hex)		Baydel Ltd.
+000570     (base 16)		Baydel Ltd.
+				Baydel House
+				    
+				GB
+
+00-05-6E   (hex)		National Enhance Technology, Inc.
+00056E     (base 16)		National Enhance Technology, Inc.
+				2F, No. 196-3, Tatung Rd., Sec. 3,
+				    
+				TW
+
+00-05-6D   (hex)		Pacific Corporation
+00056D     (base 16)		Pacific Corporation
+				2-23-3 Ebisu-Minami Shibuya
+				    
+				JP
+
+00-05-81   (hex)		Snell
+000581     (base 16)		Snell
+				Southleigh Park House
+				Hampshire    P09 2PE
+				GB
+
+00-05-7D   (hex)		Sun Communications, Inc.
+00057D     (base 16)		Sun Communications, Inc.
+				Gloria Bldg 6th
+				Tokyo    162-082
+				JP
+
+00-05-86   (hex)		Lucent Technologies
+000586     (base 16)		Lucent Technologies
+				1701 Harbor Bay Parkway
+				Alameda  CA  94502
+				US
+
+00-05-7B   (hex)		Chung Nam Electronic Co., Ltd.
+00057B     (base 16)		Chung Nam Electronic Co., Ltd.
+				Unit 3, 1/F, Festigood Centre
+				Tsuen  Fanling,  
+				HK
+
+00-05-71   (hex)		Seiwa Electronics Co.
+000571     (base 16)		Seiwa Electronics Co.
+				757 Amabouki, Kukizaki-Machi
+				    300-1253
+				JP
+
+00-05-49   (hex)		Salira Optical Network Systems
+000549     (base 16)		Salira Optical Network Systems
+				2694 Orchard Parkway
+				San Jose  CA  95134
+				US
+
+00-05-4C   (hex)		RF Innovations Pty Ltd
+00054C     (base 16)		RF Innovations Pty Ltd
+				22 Boulder Road
+				Malaga  WA   6090
+				AU
+
+00-05-43   (hex)		IQ Wireless GmbH
+000543     (base 16)		IQ Wireless GmbH
+				Carl-Scheele-Str. 14
+				    
+				DE
+
+00-05-5C   (hex)		Kowa Company, Ltd.
+00055C     (base 16)		Kowa Company, Ltd.
+				Chofugaoka 3-3-1,
+				    182-0021
+				JP
+
+00-05-10   (hex)		Infinite Shanghai Communication Terminals Ltd.
+000510     (base 16)		Infinite Shanghai Communication Terminals Ltd.
+				777 Chungiao Road, Pudong
+				    
+				CN
+
+00-04-FF   (hex)		Acronet Co., Ltd.
+0004FF     (base 16)		Acronet Co., Ltd.
+				Saman B/D 2Fl
+				    137-064
+				KR
+
+00-05-01   (hex)		Cisco Systems, Inc
+000501     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-08   (hex)		Inetcam, Inc.
+000508     (base 16)		Inetcam, Inc.
+				10171 Pacific Mesa Blvd.
+				San Diego  CA  92121
+				US
+
+00-05-1B   (hex)		Magic Control Technology Corporation
+00051B     (base 16)		Magic Control Technology Corporation
+				6F, No. 120-11 Chung Shan Rd.
+				    
+				TW
+
+00-05-13   (hex)		VTLinx Multimedia Systems, Inc.
+000513     (base 16)		VTLinx Multimedia Systems, Inc.
+				8401 Colesville Road,
+				Silver Spring  MD  20910
+				US
+
+00-05-0E   (hex)		3ware, Inc.
+00050E     (base 16)		3ware, Inc.
+				701 E. Middlefield Rd.
+				Mt. View  CA  94043
+				US
+
+00-04-D7   (hex)		Omitec Instrumentation Ltd.
+0004D7     (base 16)		Omitec Instrumentation Ltd.
+				Hopton Industrial Est.
+				    ENGLAND
+				GB
+
+00-04-D4   (hex)		Proview Electronics Co., Ltd.
+0004D4     (base 16)		Proview Electronics Co., Ltd.
+				6F, No. 1, Pau-Sheng Road
+				    
+				TW
+
+00-04-DB   (hex)		Tellus Group Corp.
+0004DB     (base 16)		Tellus Group Corp.
+				4F, No. 15 Industry E. Rd., IX
+				Hsinchu  Hsinchu  Taiwan
+				TW
+
+00-04-E0   (hex)		Procket Networks
+0004E0     (base 16)		Procket Networks
+				1100 Cadillac Court
+				Milpitas  CA  95035
+				US
+
+00-04-DD   (hex)		Cisco Systems, Inc
+0004DD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-80-86   (hex)		COMPUTER GENERATION INC.
+008086     (base 16)		COMPUTER GENERATION INC.
+				3855 PRESIDENTIAL PARKWAY
+				ATLANTA  GA  30340
+				US
+
+00-05-04   (hex)		Naray Information & Communication Enterprise
+000504     (base 16)		Naray Information & Communication Enterprise
+				3F San Woo Bldg., 1543-11
+				Seoul 137-070    
+				KR
+
+00-05-09   (hex)		AVOC Nishimura Ltd.
+000509     (base 16)		AVOC Nishimura Ltd.
+				Jogasaki 4-16-14
+				    
+				JP
+
+00-04-FB   (hex)		Commtech, Inc.
+0004FB     (base 16)		Commtech, Inc.
+				9011 E. 37th Street
+				Wichita  KS  67226-2006
+				US
+
+00-04-C0   (hex)		Cisco Systems, Inc
+0004C0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-BA   (hex)		KDD Media Will Corporation
+0004BA     (base 16)		KDD Media Will Corporation
+				2-1-23 Nakameguro
+				  153-0061  
+				JP
+
+00-04-B6   (hex)		Stratex Networks, Inc.
+0004B6     (base 16)		Stratex Networks, Inc.
+				64 White Road
+				Cape Town    7945
+				ZA
+
+00-04-CD   (hex)		Extenway Solutions Inc
+0004CD     (base 16)		Extenway Solutions Inc
+				500 boul. Morgan
+				Baie-d'Urfe  Quebec H9X 3V1  
+				CA
+
+00-04-E9   (hex)		Infiniswitch Corporation
+0004E9     (base 16)		Infiniswitch Corporation
+				134 Flanders Road
+				Westborough  MA  01581
+				US
+
+00-04-E8   (hex)		IER, Inc.
+0004E8     (base 16)		IER, Inc.
+				4501 So. General Bruce Dr
+				Temple  TX  76502
+				US
+
+00-04-B3   (hex)		Videotek, Inc.
+0004B3     (base 16)		Videotek, Inc.
+				243 Shoemaker Rd.
+				Pottstown  PA  19464
+				US
+
+00-04-4C   (hex)		JENOPTIK
+00044C     (base 16)		JENOPTIK
+				Laser, Optik, Systeme GmbH
+				    
+				DE
+
+00-04-44   (hex)		Western Multiplex Corporation
+000444     (base 16)		Western Multiplex Corporation
+				1196 Borregas Avenue
+				Sunnyvale  CA  94089
+				US
+
+00-04-39   (hex)		Rosco Entertainment Technology, Inc.
+000439     (base 16)		Rosco Entertainment Technology, Inc.
+				2181 NW Front Ave.
+				Portland  OR  97209
+				US
+
+00-04-3A   (hex)		Intelligent Telecommunications, Inc.
+00043A     (base 16)		Intelligent Telecommunications, Inc.
+				1687-2, Sinil-dong
+				SOUTH  KOREA  306-230
+				KR
+
+00-04-92   (hex)		Hive Internet, Ltd.
+000492     (base 16)		Hive Internet, Ltd.
+				Unit 2, Church View Business Centre
+				Binbrook  Market Rasen, Lincolnshire  LN8 6BY
+				GB
+
+00-04-8C   (hex)		Nayna Networks, Inc.
+00048C     (base 16)		Nayna Networks, Inc.
+				157 Topaz St.
+				Milpitas  CA  95035
+				US
+
+00-04-91   (hex)		Technovision, Inc.
+000491     (base 16)		Technovision, Inc.
+				5155 Spectrum Way, Unit #31
+				L4W  5A1  
+				CA
+
+00-04-93   (hex)		Tsinghua Unisplendour Co., Ltd.
+000493     (base 16)		Tsinghua Unisplendour Co., Ltd.
+				Th-Unis Building Tsinghua
+				  P.R.  
+				CN
+
+00-04-94   (hex)		Breezecom, Ltd.
+000494     (base 16)		Breezecom, Ltd.
+				Atidim Technology Park
+				    
+				IL
+
+00-04-89   (hex)		YAFO Networks, Inc.
+000489     (base 16)		YAFO Networks, Inc.
+				1340F Charwood Rd.
+				Hanover  MD  21076
+				US
+
+00-04-8A   (hex)		Temia Vertriebs GmbH
+00048A     (base 16)		Temia Vertriebs GmbH
+				Landsbergerstraße 320
+				    
+				DE
+
+00-04-81   (hex)		Econolite Control Products, Inc.
+000481     (base 16)		Econolite Control Products, Inc.
+				3360 E. La Palma Ave.
+				Anaheim  CA  92806
+				US
+
+00-04-6C   (hex)		Cyber Technology Co., Ltd.
+00046C     (base 16)		Cyber Technology Co., Ltd.
+				1-45 Yeo Wol-Dong
+				Kyeong Gi-Do  Kyeong Gi-Do  KOREA
+				KR
+
+00-04-71   (hex)		IPrad
+000471     (base 16)		IPrad
+				24 Raoul Wallenberg St.
+				    
+				IL
+
+00-04-6E   (hex)		Cisco Systems, Inc
+00046E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-74   (hex)		LEGRAND
+000474     (base 16)		LEGRAND
+				145 Avenue De Lattre
+				    
+				FR
+
+00-04-2D   (hex)		Sarian Systems, Ltd.
+00042D     (base 16)		Sarian Systems, Ltd.
+				Beacon House
+				West Yorkshire  ENGLAND  LS29 8JZ
+				GB
+
+00-04-2E   (hex)		Netous Technologies, Ltd.
+00042E     (base 16)		Netous Technologies, Ltd.
+				1006, Block A,
+				  HONG  KONG
+				HK
+
+00-04-25   (hex)		Atmel Corporation
+000425     (base 16)		Atmel Corporation
+				Multimedia & Communications Group
+				Morrisville  NC  27560
+				US
+
+00-04-3F   (hex)		ESTeem Wireless Modems, Inc
+00043F     (base 16)		ESTeem Wireless Modems, Inc
+				415 N. Quay St., Suite 4
+				Kennewick  WA  99336
+				US
+
+00-04-33   (hex)		Cyberboard A/S
+000433     (base 16)		Cyberboard A/S
+				Kloevermarken 120
+				    
+				DK
+
+00-04-34   (hex)		Accelent Systems, Inc.
+000434     (base 16)		Accelent Systems, Inc.
+				2620 Ridgewood Rd.,
+				Akron  OH  44313
+				US
+
+00-04-77   (hex)		Scalant Systems, Inc.
+000477     (base 16)		Scalant Systems, Inc.
+				2040 Martin Avenue
+				Santa Clara  CA  95050
+				US
+
+00-04-73   (hex)		Photonex Corporation
+000473     (base 16)		Photonex Corporation
+				8C Preston Court
+				Bedford  MA  01730
+				US
+
+00-04-70   (hex)		ipUnplugged AB
+000470     (base 16)		ipUnplugged AB
+				Box 10160
+				    
+				SE
+
+00-04-5D   (hex)		BEKA Elektronik
+00045D     (base 16)		BEKA Elektronik
+				Siemenstraße 29
+				  Erftstadt  50374
+				DE
+
+00-04-59   (hex)		Veristar Corporation
+000459     (base 16)		Veristar Corporation
+				727 Allston Way
+				Berkeley  CA  94710
+				US
+
+00-04-A4   (hex)		NetEnabled, Inc.
+0004A4     (base 16)		NetEnabled, Inc.
+				1275 Kinnear Rd.
+				Columbus  OH  43212
+				US
+
+00-04-16   (hex)		Parks S/A Comunicacoes Digitais
+000416     (base 16)		Parks S/A Comunicacoes Digitais
+				Av. Pernambuco, 1001
+				    
+				BR
+
+00-04-0F   (hex)		Asus Network Technologies, Inc.
+00040F     (base 16)		Asus Network Technologies, Inc.
+				11-1, No. 675, Sec. 1, King-kuo Rd.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-04-0A   (hex)		Sage Systems
+00040A     (base 16)		Sage Systems
+				1420 Harbor Bay Parkway
+				Alameda  CA  94502
+				US
+
+00-04-04   (hex)		Makino Milling Machine Co., Ltd.
+000404     (base 16)		Makino Milling Machine Co., Ltd.
+				4023 Nakatsu, Aikawa-machi
+				Aiko-gun  Kanagawa  243-0303
+				JP
+
+00-03-D0   (hex)		KOANKEISO Co., Ltd.
+0003D0     (base 16)		KOANKEISO Co., Ltd.
+				Zip Code 791-8042
+				    
+				JP
+
+00-03-CF   (hex)		Muxcom, Inc.
+0003CF     (base 16)		Muxcom, Inc.
+				D 602, Bundang Technopark #151
+				Kyungki Do  KOREA  463-070
+				KR
+
+00-03-D1   (hex)		Takaya Corporation
+0003D1     (base 16)		Takaya Corporation
+				Development Division
+				    
+				JP
+
+00-03-AD   (hex)		Emerson Energy Systems AB
+0003AD     (base 16)		Emerson Energy Systems AB
+				PO Box 92113
+				    
+				SE
+
+00-03-A7   (hex)		Unixtar Technology, Inc.
+0003A7     (base 16)		Unixtar Technology, Inc.
+				13F No. 100 Ming Chuan Road
+				    TAIWAN
+				TW
+
+00-03-AE   (hex)		Allied Advanced Manufacturing Pte, Ltd.
+0003AE     (base 16)		Allied Advanced Manufacturing Pte, Ltd.
+				7 International Business Park
+				  Singapore  609919
+				SG
+
+00-03-A3   (hex)		MAVIX, Ltd.
+0003A3     (base 16)		MAVIX, Ltd.
+				POB 217, Yokneam Illit,
+				    20692
+				IL
+
+00-03-B6   (hex)		QSI Corporation
+0003B6     (base 16)		QSI Corporation
+				2212 South West Temple #50
+				Salt Lake City  UT  84115
+				US
+
+00-03-B1   (hex)		Hospira Inc.
+0003B1     (base 16)		Hospira Inc.
+				755 Jarvis Drive
+				Morgan Hill  CA  95037
+				US
+
+00-03-B3   (hex)		IA Link Systems Co., Ltd.
+0003B3     (base 16)		IA Link Systems Co., Ltd.
+				6F-4, No. 81 Hsin Tai
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-EB   (hex)		Atrica
+0003EB     (base 16)		Atrica
+				5 Shenkar St. P.O.B. 12231
+				46733  46733  
+				IL
+
+00-03-E7   (hex)		Logostek Co. Ltd.
+0003E7     (base 16)		Logostek Co. Ltd.
+				19th 15 Sunusu-Academy Tower
+				Seoul  KOREA  133-123
+				KR
+
+00-03-E3   (hex)		Cisco Systems, Inc
+0003E3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-F4   (hex)		NetBurner
+0003F4     (base 16)		NetBurner
+				5405 Morehouse Drive
+				San Diego  CA  92121
+				US
+
+00-03-F2   (hex)		Seneca Networks
+0003F2     (base 16)		Seneca Networks
+				30 West Gude Dr.
+				Rockville  MD  20850
+				US
+
+00-03-F0   (hex)		Redfern Broadband Networks
+0003F0     (base 16)		Redfern Broadband Networks
+				Level 1, 1 Central Ave.,
+				    
+				AU
+
+00-03-DB   (hex)		Apogee Electronics Corp.
+0003DB     (base 16)		Apogee Electronics Corp.
+				1715 Berkeley St. 
+				Santa Monica  CA  90405-3210
+				US
+
+00-03-D2   (hex)		Crossbeam Systems, Inc.
+0003D2     (base 16)		Crossbeam Systems, Inc.
+				80 Central Street
+				Boxborough  MA  01719
+				US
+
+00-04-05   (hex)		ACN Technologies
+000405     (base 16)		ACN Technologies
+				9F, HeyKang B/D, 157-36
+				Seoul  KOREA  #135-090
+				KR
+
+00-04-01   (hex)		Osaki Electric Co., Ltd.
+000401     (base 16)		Osaki Electric Co., Ltd.
+				1131, Fujikubo, Miyoshimachi,
+				    
+				JP
+
+00-04-1B   (hex)		Bridgeworks Ltd.
+00041B     (base 16)		Bridgeworks Ltd.
+				135 Somerford Road
+				Christchurch  DORSET  BH23 3PY
+				GB
+
+00-03-A1   (hex)		HIPER Information & Communication, Inc.
+0003A1     (base 16)		HIPER Information & Communication, Inc.
+				1675-7, Sinil-dong,
+				306-230  South  Korea
+				KR
+
+00-03-96   (hex)		EZ Cast Co., Ltd.
+000396     (base 16)		EZ Cast Co., Ltd.
+				6th Floor, JungAng Building,
+				    KOREA
+				KR
+
+00-03-9A   (hex)		SiConnect
+00039A     (base 16)		SiConnect
+				Delta 100
+				Swindon    SN5 7XP
+				GB
+
+00-03-63   (hex)		Miraesys Co., Ltd.
+000363     (base 16)		Miraesys Co., Ltd.
+				650-2 4 Fl. Daemyung Bldg.
+				    135-080
+				KR
+
+00-03-5F   (hex)		Prüftechnik Condition Monitoring GmbH & Co. KG
+00035F     (base 16)		Prüftechnik Condition Monitoring GmbH & Co. KG
+				Franz-Bayer-Straße 14
+				    
+				DE
+
+00-03-60   (hex)		PAC Interactive Technology, Inc.
+000360     (base 16)		PAC Interactive Technology, Inc.
+				6F, No. 30, Alley 18, Lane 478
+				Taipei    
+				TW
+
+00-03-61   (hex)		Widcomm, Inc.
+000361     (base 16)		Widcomm, Inc.
+				9645 Scranton Road
+				San Diego  CA  92121
+				US
+
+00-03-94   (hex)		Connect One
+000394     (base 16)		Connect One
+				2 Hanagar Street
+				    
+				IL
+
+00-03-8A   (hex)		America Online, Inc.
+00038A     (base 16)		America Online, Inc.
+				44900 Prentice Drive
+				Dulles  VA  20166
+				US
+
+00-03-8D   (hex)		PCS Revenue Control Systems, Inc.
+00038D     (base 16)		PCS Revenue Control Systems, Inc.
+				560 Sylvan Ave.
+				Englewood Cliffs  NJ  07632
+				US
+
+00-03-88   (hex)		Fastfame Technology Co., Ltd.
+000388     (base 16)		Fastfame Technology Co., Ltd.
+				7F, No. 111, Hsing De Rd.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-59   (hex)		DigitalSis
+000359     (base 16)		DigitalSis
+				B-1405 Samho Bldg.
+				Seocho  Seoul,  
+				KR
+
+00-03-52   (hex)		Colubris Networks
+000352     (base 16)		Colubris Networks
+				440 Armand-Frappier
+				    H7V 4B4
+				CA
+
+00-03-4C   (hex)		Shanghai DigiVision Technology Co., Ltd.
+00034C     (base 16)		Shanghai DigiVision Technology Co., Ltd.
+				11F, Heng Tong
+				  Shanghai  200050
+				CN
+
+00-03-78   (hex)		HUMAX Co., Ltd.
+000378     (base 16)		HUMAX Co., Ltd.
+				271-2, Suh-hyun-Dong,
+				    
+				KR
+
+00-03-74   (hex)		Control Microsystems
+000374     (base 16)		Control Microsystems
+				48 Steacie Drive
+				Ottawa  Ontario  K2K 2A9
+				CA
+
+00-03-76   (hex)		Graphtec Technology, Inc.
+000376     (base 16)		Graphtec Technology, Inc.
+				45 Parker, Suite A
+				Irvine  CA  92618
+				US
+
+00-03-7E   (hex)		PORTech Communications, Inc.
+00037E     (base 16)		PORTech Communications, Inc.
+				150, Shiang-Shung N. Rd.,
+				Taichung  Taiwan  403, R.O.C.
+				TW
+
+00-03-6D   (hex)		Runtop, Inc.
+00036D     (base 16)		Runtop, Inc.
+				1, Lane 21, Hsin Hua Road, Kueishan
+				    
+				TW
+
+00-03-6E   (hex)		Nicon Systems (Pty) Limited
+00036E     (base 16)		Nicon Systems (Pty) Limited
+				11 Termo Street
+				    
+				ZA
+
+00-03-71   (hex)		Acomz Networks Corp.
+000371     (base 16)		Acomz Networks Corp.
+				7th Fl., Wooseok Bldg., 1007-37
+				Seoul    156-09
+				KR
+
+00-03-49   (hex)		Vidicode Datacommunicatie B.V.
+000349     (base 16)		Vidicode Datacommunicatie B.V.
+				Postbus 7164
+				    
+				NL
+
+00-03-3E   (hex)		Tateyama System Laboratory Co., Ltd.
+00033E     (base 16)		Tateyama System Laboratory Co., Ltd.
+				30 Shimonoban Oyama-cho
+				    930-1305
+				JP
+
+00-03-3C   (hex)		Daiden Co., Ltd.
+00033C     (base 16)		Daiden Co., Ltd.
+				2100-19 Tutumi, Kamimine-machi
+				    
+				JP
+
+00-03-25   (hex)		Arima Computer Corp.
+000325     (base 16)		Arima Computer Corp.
+				6th Fl., No. 327,
+				    
+				TW
+
+00-03-1F   (hex)		Condev Ltd.
+00031F     (base 16)		Condev Ltd.
+				200-1626 West 2nd Ave.
+				    
+				CA
+
+00-02-9F   (hex)		L-3 Communication Aviation Recorders
+00029F     (base 16)		L-3 Communication Aviation Recorders
+				P.O. Box 3041
+				Sarasota  FL  34230
+				US
+
+00-03-1B   (hex)		Cellvision Systems, Inc.
+00031B     (base 16)		Cellvision Systems, Inc.
+				3F-1, 75, Hsin Taiwu Road, Sec. 1
+				    
+				TW
+
+00-03-1C   (hex)		Svenska Hardvarufabriken AB
+00031C     (base 16)		Svenska Hardvarufabriken AB
+				Ole Romersvag 16, Ideon
+				    
+				SE
+
+00-01-A8   (hex)		Welltech Computer Co., Ltd.
+0001A8     (base 16)		Welltech Computer Co., Ltd.
+				13F-4, no. 150, Jian Yi Road
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-0C   (hex)		Telesoft Technologies Ltd.
+00030C     (base 16)		Telesoft Technologies Ltd.
+				Observatory House, Stour Park,
+				    
+				GB
+
+00-03-08   (hex)		AM Communications, Inc.
+000308     (base 16)		AM Communications, Inc.
+				100 Commerce Blvd.
+				Quakertown  PA  18951
+				US
+
+00-03-07   (hex)		Secure Works, Inc.
+000307     (base 16)		Secure Works, Inc.
+				11 Executive Drive
+				Atlanta  GA  30329
+				US
+
+00-03-06   (hex)		Fusion In Tech Co., Ltd.
+000306     (base 16)		Fusion In Tech Co., Ltd.
+				6Fl, Daeyoon Bldg. 1688-5, Seocho-dong
+				Seoul,    
+				KR
+
+00-02-FC   (hex)		Cisco Systems, Inc
+0002FC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-FA   (hex)		DX Antenna Co., Ltd.
+0002FA     (base 16)		DX Antenna Co., Ltd.
+				2-15 Hamazaki-Dori,
+				    
+				JP
+
+00-02-FB   (hex)		Baumuller Aulugen-Systemtechnik GmbH
+0002FB     (base 16)		Baumuller Aulugen-Systemtechnik GmbH
+				Ostendsts. 84
+				    
+				DE
+
+00-02-F6   (hex)		Equipe Communications
+0002F6     (base 16)		Equipe Communications
+				100 Nagog Park
+				Acton  MA  01720
+				US
+
+00-02-23   (hex)		ClickTV
+000223     (base 16)		ClickTV
+				Kemong Bldg., 4th Fl.,
+				Seoul  Korea  135-010
+				KR
+
+00-02-CB   (hex)		TriState Ltd.
+0002CB     (base 16)		TriState Ltd.
+				Shinonaga Blg. 4-11-19 Hokko-cho
+				053-0852  053-0852  
+				JP
+
+00-02-CA   (hex)		EndPoints, Inc.
+0002CA     (base 16)		EndPoints, Inc.
+				4 Preston Court
+				Bedford  MA  01730
+				US
+
+00-03-2A   (hex)		UniData Communication Systems, Inc.
+00032A     (base 16)		UniData Communication Systems, Inc.
+				2F, OhSung-Bldg, 82-15,
+				    
+				KR
+
+00-03-24   (hex)		SANYO Consumer Electronics Co., Ltd.
+000324     (base 16)		SANYO Consumer Electronics Co., Ltd.
+				7-101 Tachikawa-cho
+				Tottori City    680-8634
+				JP
+
+00-02-BF   (hex)		dotRocket, Inc.
+0002BF     (base 16)		dotRocket, Inc.
+				1901 S. Bascom, Suite 300
+				Campbell  CA  95008
+				US
+
+00-03-17   (hex)		Merlin Systems, Inc.
+000317     (base 16)		Merlin Systems, Inc.
+				3900 New Park Mall Rd.
+				Newark  CA  94560
+				US
+
+00-03-18   (hex)		Cyras Systems, Inc.
+000318     (base 16)		Cyras Systems, Inc.
+				47100 Bayside Parkway
+				Fremont  CA  94538
+				US
+
+00-02-E3   (hex)		LITE-ON Communications, Inc.
+0002E3     (base 16)		LITE-ON Communications, Inc.
+				736 S. Hillview Drive
+				Milpitas  CA  95035
+				US
+
+00-02-DD   (hex)		Bromax Communications, Ltd.
+0002DD     (base 16)		Bromax Communications, Ltd.
+				No. 20 Kuang Fu Road,
+				Hsin Chu 303    
+				TW
+
+00-02-47   (hex)		Great Dragon Information Technology (Group) Co., Ltd.
+000247     (base 16)		Great Dragon Information Technology (Group) Co., Ltd.
+				169 Beiyuan Rd.,
+				Beijing  100101,  
+				CN
+
+00-02-43   (hex)		Raysis Co., Ltd.
+000243     (base 16)		Raysis Co., Ltd.
+				997-10, Daechi-Dong, Kangnam-Ku,
+				Seoul  135-280,  South Korea
+				KR
+
+00-02-31   (hex)		Ingersoll-Rand
+000231     (base 16)		Ingersoll-Rand
+				1467 Route 31 South
+				Annandale  NJ  08801
+				US
+
+00-02-66   (hex)		Thermalogic Corporation
+000266     (base 16)		Thermalogic Corporation
+				22 Kane Industrial Drive
+				Hudson  MA  01749
+				US
+
+00-02-68   (hex)		Harris Government Communications
+000268     (base 16)		Harris Government Communications
+				Systems Division
+				Melbourne  FL  32902
+				US
+
+00-02-5E   (hex)		High Technology Ltd
+00025E     (base 16)		High Technology Ltd
+				Chongqing Jinghong
+				People's Republic  of  
+				CN
+
+00-02-60   (hex)		Accordion Networks, Inc.
+000260     (base 16)		Accordion Networks, Inc.
+				39899 Balentine Drive, #335
+				Newark  CA  94560
+				US
+
+00-02-83   (hex)		Spectrum Controls, Inc.
+000283     (base 16)		Spectrum Controls, Inc.
+				PO Box 5533
+				Bellevue  WA  98006
+				US
+
+00-02-84   (hex)		UK Grid Solutions Limited
+000284     (base 16)		UK Grid Solutions Limited
+				St Leonards Building  Redhill Business Park
+				Stafford    ST16 1TW
+				GB
+
+00-02-80   (hex)		Mu Net, Inc.
+000280     (base 16)		Mu Net, Inc.
+				442 Marrett Road
+				Lexington  MA  02421
+				US
+
+00-90-64   (hex)		Thomson Inc.
+009064     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290-1102
+				US
+
+00-02-7A   (hex)		IOI Technology Corporation
+00027A     (base 16)		IOI Technology Corporation
+				4F-3 No. 125 Lane 235,
+				Taipei  TAIWAN,  R.O.C.
+				TW
+
+00-02-74   (hex)		Tommy Technologies Corp.
+000274     (base 16)		Tommy Technologies Corp.
+				#407 Heehoon Bld
+				Seoul  Seoul  KOREA
+				KR
+
+00-02-9E   (hex)		Information Equipment Co., Ltd.
+00029E     (base 16)		Information Equipment Co., Ltd.
+				740-1 Eaho Bldg., Yeok Sam-Dong
+				Seoul  Korea  #135-080
+				KR
+
+00-02-9B   (hex)		Kreatel Communications AB
+00029B     (base 16)		Kreatel Communications AB
+				Teknikringen 4C
+				    
+				SE
+
+00-02-95   (hex)		IP.Access Limited
+000295     (base 16)		IP.Access Limited
+				Melbourn Science Park
+				SG8 6EE  SG8 6EE  U.K.
+				GB
+
+00-02-72   (hex)		CC&C Technologies, Inc.
+000272     (base 16)		CC&C Technologies, Inc.
+				8F, 150, Chien I Rd., Chung Ho City,
+				Taipei County 235  Taiwan  R.O.C.
+				TW
+
+00-02-6D   (hex)		Adept Telecom
+00026D     (base 16)		Adept Telecom
+				Avenue de l'Europe
+				    
+				FR
+
+00-02-6B   (hex)		BCM Computers Co., Ltd.
+00026B     (base 16)		BCM Computers Co., Ltd.
+				6F-6, No. 66, Sec 2,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-02-93   (hex)		Solid Data Systems
+000293     (base 16)		Solid Data Systems
+				2945 Oakmead Village Court
+				Santa Clara  CA  95051
+				US
+
+00-02-89   (hex)		DNE Technologies
+000289     (base 16)		DNE Technologies
+				50 Barnes Park N
+				Wallingford  CT  06492
+				US
+
+00-01-2F   (hex)		Twinhead International Corp
+00012F     (base 16)		Twinhead International Corp
+				2FL, 2, Lane 235, Bao-Chiao Road
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-02-A7   (hex)		Vivace Networks
+0002A7     (base 16)		Vivace Networks
+				2730 Orchard Parkway
+				San Jose  CA  95134
+				US
+
+00-01-B2   (hex)		Digital Processing Systems, Inc.
+0001B2     (base 16)		Digital Processing Systems, Inc.
+				70 Valleywood Drive
+				  L3R  4T5
+				CA
+
+00-01-B8   (hex)		Netsensity, Inc.
+0001B8     (base 16)		Netsensity, Inc.
+				PO Box 1060
+				Lake Forest  CA  92630
+				US
+
+00-01-B9   (hex)		SKF (U.K.) Limited
+0001B9     (base 16)		SKF (U.K.) Limited
+				2 Michaelson Square Kirkton Campus
+				Livingston    West Lothian  EH54 7DP
+				GB
+
+00-01-B3   (hex)		Precision Electronic Manufacturing
+0001B3     (base 16)		Precision Electronic Manufacturing
+				P0187, P.O. 527948
+				Miami  FL  33152-7948
+				US
+
+00-01-BD   (hex)		Peterson Electro-Musical Products, Inc.
+0001BD     (base 16)		Peterson Electro-Musical Products, Inc.
+				11601 S. Mayfield Avenue
+				Alsip  IL  60803-2476
+				US
+
+00-02-09   (hex)		Shenzhen SED Information Technology Co., Ltd.
+000209     (base 16)		Shenzhen SED Information Technology Co., Ltd.
+				4/F., West Block, Block 414, Zhenhua Rd.
+				    
+				CN
+
+00-02-02   (hex)		Amino Communications, Ltd.
+000202     (base 16)		Amino Communications, Ltd.
+				Times House
+				UK  CB4  5LH
+				GB
+
+00-02-01   (hex)		IFM Electronic gmbh
+000201     (base 16)		IFM Electronic gmbh
+				Bechlingen 34
+				    
+				DE
+
+00-02-34   (hex)		Imperial Technology, Inc.
+000234     (base 16)		Imperial Technology, Inc.
+				2305 Utah Avenue
+				El Segundo  CA  90245
+				US
+
+00-02-36   (hex)		INIT GmbH
+000236     (base 16)		INIT GmbH
+				Kaeppelestraße 6
+				    
+				DE
+
+00-02-2B   (hex)		SAXA, Inc.
+00022B     (base 16)		SAXA, Inc.
+				NBF Platinum Tower 1-17-3 Shirokane
+				Minato-ku  Tokyo  108-8050
+				JP
+
+00-02-24   (hex)		C-COR
+000224     (base 16)		C-COR
+				15 Sterling Drive
+				Wallingford  CT  06492
+				US
+
+00-02-1F   (hex)		Aculab PLC
+00021F     (base 16)		Aculab PLC
+				Lakeside, Bramley Road
+				Milton Keynes    MK1 1PT
+				GB
+
+00-02-1A   (hex)		Zuma Networks
+00021A     (base 16)		Zuma Networks
+				8403 Fallbrook Ave.
+				West Hills  CA  91304
+				US
+
+00-01-CA   (hex)		Geocast Network Systems, Inc.
+0001CA     (base 16)		Geocast Network Systems, Inc.
+				190 Independence Drive
+				Menlo Park  CA  94025
+				US
+
+00-01-D1   (hex)		CoNet Communications, Inc.
+0001D1     (base 16)		CoNet Communications, Inc.
+				25 Mauchly, #320
+				Irvine  CA  92618
+				US
+
+00-02-22   (hex)		Chromisys, Inc.
+000222     (base 16)		Chromisys, Inc.
+				1012 Stewart Drive
+				Sunnyvale  CA  94086
+				US
+
+00-02-13   (hex)		S.D.E.L.
+000213     (base 16)		S.D.E.L.
+				Aeropole D2A
+				    
+				FR
+
+00-01-DB   (hex)		Freecom Technologies GmbH
+0001DB     (base 16)		Freecom Technologies GmbH
+				Obentrautstraße 72
+				    
+				DE
+
+00-01-DF   (hex)		ISDN Communications, Ltd.
+0001DF     (base 16)		ISDN Communications, Ltd.
+				The Stable Block, Ronans
+				    ENGLAND
+				GB
+
+00-01-EF   (hex)		Camtel Technology Corp.
+0001EF     (base 16)		Camtel Technology Corp.
+				No. 2, Wu-Kung 5 Rd., Wu-Ku
+				Taiwan  Taiwan  R.O.C.
+				TW
+
+00-02-0A   (hex)		Gefran Spa
+00020A     (base 16)		Gefran Spa
+				Via Sebina, 74
+				    
+				IT
+
+00-02-06   (hex)		Telital R&D Denmark A/S
+000206     (base 16)		Telital R&D Denmark A/S
+				9530 Stouring
+				    
+				DK
+
+00-01-79   (hex)		WIRELESS TECHNOLOGY, INC.
+000179     (base 16)		WIRELESS TECHNOLOGY, INC.
+				Anam Bldg. 2Fl, 154-17
+				    KOREA
+				KR
+
+00-01-60   (hex)		ELMEX Co., LTD.
+000160     (base 16)		ELMEX Co., LTD.
+				16-30 Kimachi
+				    
+				JP
+
+00-01-4E   (hex)		WIN Enterprises, Inc.
+00014E     (base 16)		WIN Enterprises, Inc.
+				300 Willow Street South
+				North Andover  MA  01845
+				US
+
+00-30-73   (hex)		International Microsystems, In
+003073     (base 16)		International Microsystems, In
+				521 Valley Way
+				Milpitas  CA  95035
+				US
+
+00-30-3F   (hex)		TurboComm Tech Inc.
+00303F     (base 16)		TurboComm Tech Inc.
+				4F-2, No 171, Sung-Tch Road
+				Taipei    
+				TW
+
+00-01-84   (hex)		SIEB & MEYER AG
+000184     (base 16)		SIEB & MEYER AG
+				Auf dem Schmaarkamp 21
+				    
+				DE
+
+00-01-95   (hex)		Sena Technologies, Inc.
+000195     (base 16)		Sena Technologies, Inc.
+				116-23 Shinlim-dong
+				    KOREA
+				KR
+
+00-01-A4   (hex)		Microlink Corporation
+0001A4     (base 16)		Microlink Corporation
+				11110 Ohio Ave., - Ste. #108
+				Los Angeles  CA  90034
+				US
+
+00-01-8E   (hex)		Logitec Corporation
+00018E     (base 16)		Logitec Corporation
+				8268 Rokudouhara, Misuzu
+				    
+				JP
+
+00-01-6D   (hex)		CarrierComm Inc.
+00016D     (base 16)		CarrierComm Inc.
+				2231 Rutherford, Suite 110
+				Carlsbad  CA  92008
+				US
+
+00-01-6F   (hex)		Inkel Corp.
+00016F     (base 16)		Inkel Corp.
+				CheongCheon-Dong, BuPyeong-Gu,
+				Incheon-Si    
+				KR
+
+00-01-70   (hex)		ESE Embedded System Engineer'g
+000170     (base 16)		ESE Embedded System Engineer'g
+				Mühlbachstraße 20
+				    
+				DE
+
+00-01-6A   (hex)		ALITEC
+00016A     (base 16)		ALITEC
+				Laval Technopole B.P. 102
+				    
+				FR
+
+00-01-53   (hex)		ARCHTEK TELECOM CORPORATION
+000153     (base 16)		ARCHTEK TELECOM CORPORATION
+				4F, No.9 Lane 130, Min-Chyuan Rd.
+				  231  TAIWAN
+				TW
+
+00-01-35   (hex)		KDC Corp.
+000135     (base 16)		KDC Corp.
+				200-11 AnYang 7 dong
+				    KOREA
+				KR
+
+00-01-41   (hex)		CABLE PRINT
+000141     (base 16)		CABLE PRINT
+				Jozef Cardynstraat 16
+				    
+				BE
+
+00-01-65   (hex)		AirSwitch Corporation
+000165     (base 16)		AirSwitch Corporation
+				37East 200South
+				Springville  UT  84663
+				US
+
+00-01-56   (hex)		FIREWIREDIRECT.COM, INC.
+000156     (base 16)		FIREWIREDIRECT.COM, INC.
+				4132 Spicewood Springs Rd - #I-4
+				Austin  TX  78759
+				US
+
+00-01-B7   (hex)		Centos, Inc.
+0001B7     (base 16)		Centos, Inc.
+				6F-1, NO. 15, LANE 360
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-01-B5   (hex)		Turin Networks, Inc.
+0001B5     (base 16)		Turin Networks, Inc.
+				1415 North McDowell Blvd.
+				Petaluma  CA  94954
+				US
+
+00-01-83   (hex)		ANITE TELECOMS
+000183     (base 16)		ANITE TELECOMS
+				127 Fleet Road, Fleet
+				  UNITED  KINGDOM
+				GB
+
+00-01-7E   (hex)		ADTEK System Science Co., Ltd.
+00017E     (base 16)		ADTEK System Science Co., Ltd.
+				YBP West Tower
+				  Hodogaya Yokohama  
+				JP
+
+00-01-0C   (hex)		System Talks Inc.
+00010C     (base 16)		System Talks Inc.
+				4F, PrimeNihonbashi Bld.
+				Chuo-ku Tokyo    
+				JP
+
+00-01-11   (hex)		iDigm Inc.
+000111     (base 16)		iDigm Inc.
+				7FL Sindo B/D 1604-22 Seocho-Dong
+				Seoul 137-070    
+				KR
+
+00-01-07   (hex)		Leiser GmbH
+000107     (base 16)		Leiser GmbH
+				Ilmstr. 7
+				85579 Neubiberg    
+				DE
+
+00-01-14   (hex)		KANDA TSUSHIN KOGYO CO., LTD.
+000114     (base 16)		KANDA TSUSHIN KOGYO CO., LTD.
+				23-2, Nishi-Gotanda 2-chome,
+				Tokyo 141-8533    
+				JP
+
+00-B0-F5   (hex)		NetWorth Technologies, Inc.
+00B0F5     (base 16)		NetWorth Technologies, Inc.
+				1000 Germantown Pike
+				Plymouth Metting  PA  19462
+				US
+
+00-B0-DB   (hex)		Nextcell, Inc.
+00B0DB     (base 16)		Nextcell, Inc.
+				651 East 18th Street
+				Plano  TX  75074
+				US
+
+00-B0-AE   (hex)		Symmetricom
+00B0AE     (base 16)		Symmetricom
+				2300 Orchard Parkway
+				San Jose  CA  95131
+				US
+
+00-B0-E7   (hex)		British Federal Ltd.
+00B0E7     (base 16)		British Federal Ltd.
+				Castle Mill Works
+				Dudley DY1 4DA  England  
+				GB
+
+00-B0-8E   (hex)		Cisco Systems, Inc
+00B08E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-5C   (hex)		SMAR Laboratories Corp.
+00305C     (base 16)		SMAR Laboratories Corp.
+				10960 Millridge North - Ste. #107
+				Houston  TX  77070
+				US
+
+00-30-04   (hex)		LEADTEK RESEARCH INC.
+003004     (base 16)		LEADTEK RESEARCH INC.
+				18F, No.166, Chien-Yi Road
+				Hsien    
+				TW
+
+00-30-F9   (hex)		Sollae Systems Co., Ltd.
+0030F9     (base 16)		Sollae Systems Co., Ltd.
+				607 Incheo IT Tower
+				Nam-gu  Incheon  
+				KR
+
+00-01-18   (hex)		EZ Digital Co., Ltd.
+000118     (base 16)		EZ Digital Co., Ltd.
+				Bitville Bldg. Room 703
+				Seoul    
+				KR
+
+00-01-1C   (hex)		Universal Talkware Corporation
+00011C     (base 16)		Universal Talkware Corporation
+				10 Second St. NE
+				Minneapolis  MN  55413
+				US
+
+00-01-28   (hex)		EnjoyWeb, Inc.
+000128     (base 16)		EnjoyWeb, Inc.
+				3000 Scott Blvd. #107
+				Santa Clara  CA  95054
+				US
+
+00-01-46   (hex)		Tesco Controls, Inc.
+000146     (base 16)		Tesco Controls, Inc.
+				P.O. Box 239012
+				Sacramento  CA  95823-9012
+				US
+
+00-01-49   (hex)		TDT AG
+000149     (base 16)		TDT AG
+				Siemensstraße 18
+				Essenbach    84051
+				DE
+
+00-01-31   (hex)		Bosch Security Systems, Inc.
+000131     (base 16)		Bosch Security Systems, Inc.
+				130 Perinton Parkway
+				Fairport  NY  14450
+				US
+
+00-30-BE   (hex)		City-Net Technology, Inc.
+0030BE     (base 16)		City-Net Technology, Inc.
+				135 E. Chesnut Ave., Ste.
+				Monrovia  CA  91016
+				US
+
+00-30-02   (hex)		Expand Networks
+003002     (base 16)		Expand Networks
+				Atidim Tech Park, Bldg. 4
+				Tel-Aviv 61580    
+				IL
+
+00-30-78   (hex)		Cisco Systems, Inc
+003078     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-B0-EC   (hex)		EACEM
+00B0EC     (base 16)		EACEM
+				Avenue Louise 140, Bte 6
+				B-1050 BRUSSELS    
+				BE
+
+00-B0-DF   (hex)		Starboard Storage Systems
+00B0DF     (base 16)		Starboard Storage Systems
+				12303 Airport Way
+				Broomfield  Co  80021
+				US
+
+00-01-0B   (hex)		Space CyberLink, Inc.
+00010B     (base 16)		Space CyberLink, Inc.
+				5th Fl. Guppyung Town B
+				Seoul    
+				KR
+
+00-30-9C   (hex)		Timing Applications, Inc.
+00309C     (base 16)		Timing Applications, Inc.
+				4775 Walnut St.
+				Boulder  CO  80301
+				US
+
+00-30-7E   (hex)		Redflex Communication Systems
+00307E     (base 16)		Redflex Communication Systems
+				11-29 Eastern Road
+				South Melbourne  Victoria 3205  
+				AU
+
+00-30-4F   (hex)		PLANET Technology Corporation
+00304F     (base 16)		PLANET Technology Corporation
+				11F, No. 96, Min-Chuan Road
+				Hsin-Tien Dist., New Taipei City    
+				TW
+
+00-30-22   (hex)		Fong Kai Industrial Co., Ltd.
+003022     (base 16)		Fong Kai Industrial Co., Ltd.
+				4F-3, No. 13, Wu Chuan 1st Road
+				Hsin Chuang City, Taipei Hsien    
+				TW
+
+00-30-70   (hex)		1Net Corporation
+003070     (base 16)		1Net Corporation
+				347 Elizabeth Avenue - Ste. #100
+				Somerset  NJ  08873
+				US
+
+00-30-F8   (hex)		Dynapro Systems, Inc.
+0030F8     (base 16)		Dynapro Systems, Inc.
+				800 Carleton Court
+				New Westminster  British Columbia V3M 6L3  
+				CA
+
+00-30-B7   (hex)		Teletrol Systems, Inc.
+0030B7     (base 16)		Teletrol Systems, Inc.
+				Technology Center
+				Manchester  NH  03101
+				US
+
+00-30-B3   (hex)		San Valley Systems, Inc.
+0030B3     (base 16)		San Valley Systems, Inc.
+				2105 S. Bascom Ave. - Ste. #390
+				Campbell  CA  95008
+				US
+
+00-30-09   (hex)		Tachion Networks, Inc.
+003009     (base 16)		Tachion Networks, Inc.
+				2 Meridian Road
+				Eatontown  NJ  07724
+				US
+
+00-30-7A   (hex)		Advanced Technology & Systems
+00307A     (base 16)		Advanced Technology & Systems
+				Yokohama Business Park East Tower 9F,
+				    240-0005
+				JP
+
+00-30-61   (hex)		MobyTEL
+003061     (base 16)		MobyTEL
+				4301 Connecticut Ave. NW
+				Washington  DC  20008
+				US
+
+00-30-54   (hex)		CASTLENET TECHNOLOGY, INC.
+003054     (base 16)		CASTLENET TECHNOLOGY, INC.
+				NO. 130 WU-KUNG RD.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-0B   (hex)		mPHASE Technologies, Inc.
+00300B     (base 16)		mPHASE Technologies, Inc.
+				250 14th Street
+				Atlanta  GA  30318
+				US
+
+00-30-8F   (hex)		MICRILOR, Inc.
+00308F     (base 16)		MICRILOR, Inc.
+				17 Lakeside Office Park
+				Wakefield  MA  01880
+				US
+
+00-30-50   (hex)		Versa Technology
+003050     (base 16)		Versa Technology
+				4430 E. Miraloma Ave., - Ste.
+				Anaheim  CA  92807
+				US
+
+00-30-C0   (hex)		Lara Technology, Inc.
+0030C0     (base 16)		Lara Technology, Inc.
+				2345 North First Street
+				San Jose  CA  95131
+				US
+
+00-30-05   (hex)		Fujitsu Siemens Computers
+003005     (base 16)		Fujitsu Siemens Computers
+				Buergermeister ulrich 100
+				86199 Augsburg    
+				DE
+
+00-30-E0   (hex)		OXFORD SEMICONDUCTOR LTD.
+0030E0     (base 16)		OXFORD SEMICONDUCTOR LTD.
+				25 MILTON PARK
+				Abingdon  Oxon  OX14 4SH
+				GB
+
+00-30-64   (hex)		ADLINK TECHNOLOGY, INC.
+003064     (base 16)		ADLINK TECHNOLOGY, INC.
+				9F, NO. 166, JIEN-YI R.D.
+				CHUNG-HO CITY TAIPEI    
+				TW
+
+00-30-DB   (hex)		Mindready Solutions, Inc.
+0030DB     (base 16)		Mindready Solutions, Inc.
+				2800 Marie-Curie Avenue
+				Quebec    H4S 2C2
+				CA
+
+00-30-E7   (hex)		CNF MOBILE SOLUTIONS, INC.
+0030E7     (base 16)		CNF MOBILE SOLUTIONS, INC.
+				7722 E. GRAY ROAD
+				SCOTTSDALE  AZ  85260
+				US
+
+00-30-B4   (hex)		INTERSIL CORP.
+0030B4     (base 16)		INTERSIL CORP.
+				P.O. BOX 883
+				MELBOURNE  FL  32902
+				US
+
+00-30-B1   (hex)		TrunkNet
+0030B1     (base 16)		TrunkNet
+				Aubergenviller Allee 51
+				Dieburg    D-64807
+				DE
+
+00-30-60   (hex)		Powerfile, Inc.
+003060     (base 16)		Powerfile, Inc.
+				3350 Thomas Road
+				Santa Clara  CA  95054-2062
+				US
+
+00-30-A0   (hex)		TYCO SUBMARINE SYSTEMS, LTD.
+0030A0     (base 16)		TYCO SUBMARINE SYSTEMS, LTD.
+				250 INDUSTRIAL WAY WEST
+				EATONTOWN  NJ  07724
+				US
+
+00-30-15   (hex)		CP CLARE CORP.
+003015     (base 16)		CP CLARE CORP.
+				78 CHERRY HILL DRIVE
+				BEVERLY  MA  01915
+				US
+
+00-30-1F   (hex)		OPTICAL NETWORKS, INC.
+00301F     (base 16)		OPTICAL NETWORKS, INC.
+				166 BAYPOINTE PARKWAY
+				SAN JOSE  CA  95134
+				US
+
+00-30-FA   (hex)		TELICA, INC.
+0030FA     (base 16)		TELICA, INC.
+				734 FOREST STREET, BLDG.
+				MARLBORO  MA  01752
+				US
+
+00-30-4B   (hex)		ORBACOM SYSTEMS, INC.
+00304B     (base 16)		ORBACOM SYSTEMS, INC.
+				1704 TAYLORS LANE
+				CINNAMINSON  NJ  08077
+				US
+
+00-30-E9   (hex)		GMA COMMUNICATION MANUFACT'G
+0030E9     (base 16)		GMA COMMUNICATION MANUFACT'G
+				MARKETING, (1991) LTD.
+				ISRAEL  ISRAEL  49130
+				IL
+
+00-30-A5   (hex)		ACTIVE POWER
+0030A5     (base 16)		ACTIVE POWER
+				11525 STONEHOLLOW - STE.#255
+				AUSTIN  TX  78758
+				US
+
+00-30-84   (hex)		ALLIED TELESYN INTERNAIONAL
+003084     (base 16)		ALLIED TELESYN INTERNAIONAL
+				CORPORATION
+				SUNNYVALE  CA  94086
+				US
+
+00-30-43   (hex)		IDREAM TECHNOLOGIES, PTE. LTD.
+003043     (base 16)		IDREAM TECHNOLOGIES, PTE. LTD.
+				54 KALLANG BAHRU, #02-14
+				    
+				SG
+
+00-30-00   (hex)		ALLWELL TECHNOLOGY CORP.
+003000     (base 16)		ALLWELL TECHNOLOGY CORP.
+				4F, #15, LANE3, SEC.2
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-11   (hex)		HMS Industrial Networks   
+003011     (base 16)		HMS Industrial Networks   
+				P O Box 4126
+				    SE-300 04
+				SE
+
+00-30-68   (hex)		CYBERNETICS TECH. CO., LTD.
+003068     (base 16)		CYBERNETICS TECH. CO., LTD.
+				DAITOH BLDG. 4F 3-32-1
+				  JAPAN  171-0033
+				JP
+
+00-30-91   (hex)		TAIWAN FIRST LINE ELEC. CORP.
+003091     (base 16)		TAIWAN FIRST LINE ELEC. CORP.
+				40 Chung-Shan Road
+				Taipei County    
+				TW
+
+00-30-CD   (hex)		CONEXANT SYSTEMS, INC.
+0030CD     (base 16)		CONEXANT SYSTEMS, INC.
+				4311 JAMBOREE ROAD
+				NEWPORT BEACH  CA  92660
+				US
+
+00-30-1A   (hex)		SMARTBRIDGES PTE. LTD.
+00301A     (base 16)		SMARTBRIDGES PTE. LTD.
+				745 Toa Payoh Lorong 5
+				    319455
+				SG
+
+00-30-29   (hex)		OPICOM
+003029     (base 16)		OPICOM
+				ROOM #302, STYLE FACTORY 151
+				    KOREA
+				KR
+
+00-30-83   (hex)		Ivron Systems
+003083     (base 16)		Ivron Systems
+				19-20 YORK ROAD
+				    
+				IE
+
+00-30-B6   (hex)		Cisco Systems, Inc
+0030B6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-C7   (hex)		Macromate Corp.
+0030C7     (base 16)		Macromate Corp.
+				8F,Universal Center,Number 179
+				Taipei  Hsien  
+				TW
+
+00-30-E4   (hex)		CHIYODA SYSTEM RIKEN
+0030E4     (base 16)		CHIYODA SYSTEM RIKEN
+				2-7, KANDA-NISHIKI-CHO
+				    
+				JP
+
+00-30-66   (hex)		RFM
+003066     (base 16)		RFM
+				3079 Premiere Pkwy
+				Duluth  GA  30097
+				US
+
+00-30-31   (hex)		LIGHTWAVE COMMUNICATIONS, INC.
+003031     (base 16)		LIGHTWAVE COMMUNICATIONS, INC.
+				261 PEPE'S FARM ROAD
+				MILFORD  CT  06460
+				US
+
+00-D0-07   (hex)		MIC ASSOCIATES, INC.
+00D007     (base 16)		MIC ASSOCIATES, INC.
+				1510-1, KAIDOKI
+				JAPAN  JAPAN  206-0012
+				JP
+
+00-D0-FF   (hex)		Cisco Systems, Inc
+00D0FF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-28   (hex)		Harmonic, Inc
+00D028     (base 16)		Harmonic, Inc
+				965 Stewart Drive
+				Sunnyvale  CA  94086-3913
+				US
+
+00-D0-25   (hex)		XROSSTECH, INC.
+00D025     (base 16)		XROSSTECH, INC.
+				HABDONG B/D 5F 210-2
+				    KOREA
+				KR
+
+00-D0-44   (hex)		ALIDIAN NETWORKS, INC.
+00D044     (base 16)		ALIDIAN NETWORKS, INC.
+				1330 W. MIDDLEFIELD ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-30-5B   (hex)		Toko Inc.
+00305B     (base 16)		Toko Inc.
+				18 COMIGAYA, TSURUGASHIMA-SHI
+				  JAPAN  350-2281
+				JP
+
+00-D0-49   (hex)		IMPRESSTEK CO., LTD.
+00D049     (base 16)		IMPRESSTEK CO., LTD.
+				6F, SPECIALTY CONSTRUCTION CTR
+				302-120  KOREA  (REP.)
+				KR
+
+00-D0-5B   (hex)		ACROLOOP MOTION CONTROL
+00D05B     (base 16)		ACROLOOP MOTION CONTROL
+				SYSTEMS
+				CHASKA  MN  55318
+				US
+
+00-D0-42   (hex)		MAHLO GMBH & CO. UG
+00D042     (base 16)		MAHLO GMBH & CO. UG
+				DONAUSTRASSE 12
+				    
+				DE
+
+00-D0-31   (hex)		INDUSTRIAL LOGIC CORPORATION
+00D031     (base 16)		INDUSTRIAL LOGIC CORPORATION
+				15 PIEDMONT CENTER-STE #700
+				ATLANTA  GA  30305
+				US
+
+00-D0-38   (hex)		FIVEMERE, LTD.
+00D038     (base 16)		FIVEMERE, LTD.
+				UNIT 1-HERON INDUSTRIAL ESTATE
+				RG7  1PJ  ENGLAND
+				GB
+
+00-D0-C6   (hex)		THOMAS & BETTS CORP.
+00D0C6     (base 16)		THOMAS & BETTS CORP.
+				Thomas & Betts Aust. Pty. Ltd.
+				Lidcombe  New South Wales  
+				AU
+
+00-D0-77   (hex)		LUCENT TECHNOLOGIES
+00D077     (base 16)		LUCENT TECHNOLOGIES
+				CLIENT ACCESS BUSINESS UNIT
+				HOLMDEL  NJ  07733
+				US
+
+00-D0-3E   (hex)		ROCKETCHIPS, INC.
+00D03E     (base 16)		ROCKETCHIPS, INC.
+				7901 XERXES AVE. S.
+				MINNEAPOLIS  MN  55431
+				US
+
+00-D0-93   (hex)		TQ - COMPONENTS GMBH
+00D093     (base 16)		TQ - COMPONENTS GMBH
+				GUT DELLING - MUHLSTR 2
+				    
+				DE
+
+00-D0-3F   (hex)		AMERICAN COMMUNICATION
+00D03F     (base 16)		AMERICAN COMMUNICATION
+				TECHNOLIGIES INTERNATIONAL INC
+				ROHNERT PARK  CA  94928
+				US
+
+00-D0-F7   (hex)		NEXT NETS CORPORATION
+00D0F7     (base 16)		NEXT NETS CORPORATION
+				MITA KOKUSAI BLDG. 17F
+				    
+				JP
+
+00-D0-6F   (hex)		KMC CONTROLS
+00D06F     (base 16)		KMC CONTROLS
+				P.O. BOX 497
+				NEW PARIS  IN  46553
+				US
+
+00-D0-FC   (hex)		GRANITE MICROSYSTEMS
+00D0FC     (base 16)		GRANITE MICROSYSTEMS
+				10202 N. ENTERPRISE DRIVE
+				MEQUON  WI  53092
+				US
+
+00-D0-A6   (hex)		LANBIRD TECHNOLOGY CO., LTD.
+00D0A6     (base 16)		LANBIRD TECHNOLOGY CO., LTD.
+				ROOM A-211, S.B.I.
+				  KOREA  157-030
+				KR
+
+00-D0-03   (hex)		COMDA ENTERPRISES CORP.
+00D003     (base 16)		COMDA ENTERPRISES CORP.
+				2F, NO. 501-18, CHUNGCHEN ROAD
+				TAIWAN  TAIWAN  ROC
+				TW
+
+00-D0-D2   (hex)		EPILOG CORPORATION
+00D0D2     (base 16)		EPILOG CORPORATION
+				500 CORPORATE CIRCLE - STE.
+				GOLDEN  CO  80401
+				US
+
+00-D0-F9   (hex)		ACUTE COMMUNICATIONS CORP.
+00D0F9     (base 16)		ACUTE COMMUNICATIONS CORP.
+				NO. 1, CREATION ROAD III
+				    TAIWAN
+				TW
+
+00-D0-CE   (hex)		iSystem Labs 
+00D0CE     (base 16)		iSystem Labs 
+				BRODISCE 7, 10C 
+				Trzin    1236
+				SI
+
+00-D0-18   (hex)		QWES. COM, INC.
+00D018     (base 16)		QWES. COM, INC.
+				14742 NEWPORT AVE. - STE. #203
+				TUSTIN  CA  92780
+				US
+
+00-01-A7   (hex)		UNEX TECHNOLOGY CORPORATION
+0001A7     (base 16)		UNEX TECHNOLOGY CORPORATION
+				8F-5, #130, SZE WEI RD.,
+				HSINCHU    
+				TW
+
+00-D0-8C   (hex)		GENOA TECHNOLOGY, INC.
+00D08C     (base 16)		GENOA TECHNOLOGY, INC.
+				5401 TECH CIRCLE
+				MOORPARK  CA  93021
+				US
+
+00-D0-59   (hex)		AMBIT MICROSYSTEMS CORP.
+00D059     (base 16)		AMBIT MICROSYSTEMS CORP.
+				5F-1, 5 HSIN-AN ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-D0-FD   (hex)		OPTIMA TELE.COM, INC.
+00D0FD     (base 16)		OPTIMA TELE.COM, INC.
+				4-20 Cachet Woods Court
+				Markham  ON  L6C 3G1
+				CA
+
+00-D0-A9   (hex)		SHINANO KENSHI CO., LTD.
+00D0A9     (base 16)		SHINANO KENSHI CO., LTD.
+				ELECTRONIC EQUIPMENT DIVISION
+				    
+				JP
+
+00-D0-DD   (hex)		SUNRISE TELECOM, INC.
+00D0DD     (base 16)		SUNRISE TELECOM, INC.
+				22 GREAT OAKS BLVD.
+				SAN JOSE  CA  95119
+				US
+
+00-D0-E6   (hex)		IBOND INC.
+00D0E6     (base 16)		IBOND INC.
+				3160, DE LA CRUZ BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+00-D0-D1   (hex)		Sycamore Networks
+00D0D1     (base 16)		Sycamore Networks
+				220 Mill Rd
+				Chelmsford  MA  01824
+				US
+
+00-D0-87   (hex)		MICROFIRST INC.
+00D087     (base 16)		MICROFIRST INC.
+				11 EAST OAK STREET
+				OAKLAND  NJ  07436
+				US
+
+00-D0-80   (hex)		EXABYTE CORPORATION
+00D080     (base 16)		EXABYTE CORPORATION
+				1685 38TH STREET
+				BOULDER  CO  80301
+				US
+
+00-D0-91   (hex)		SMARTSAN SYSTEMS, INC.
+00D091     (base 16)		SMARTSAN SYSTEMS, INC.
+				4655 OLD IRONSIDES DR. #480
+				SANTA CLARA  CA  95054
+				US
+
+00-D0-4E   (hex)		LOGIBAG
+00D04E     (base 16)		LOGIBAG
+				2, Rue de la Mandinière
+				    
+				FR
+
+00-D0-27   (hex)		APPLIED AUTOMATION, INC.
+00D027     (base 16)		APPLIED AUTOMATION, INC.
+				P.O. BOX 9999
+				BARTLESVILLE  OK  74005-9999
+				US
+
+00-D0-72   (hex)		BROADLOGIC
+00D072     (base 16)		BROADLOGIC
+				463 S. MILPITAS BLVD.
+				MILPITAS  CA  95035
+				US
+
+00-D0-E2   (hex)		MRT MICRO, INC.
+00D0E2     (base 16)		MRT MICRO, INC.
+				14000 S. MILITARY TRAIL
+				DELRAY BEACH  FL  33484
+				US
+
+00-D0-6A   (hex)		LINKUP SYSTEMS CORPORATION
+00D06A     (base 16)		LINKUP SYSTEMS CORPORATION
+				1190 COLEMAN AVE.- STE #2C
+				SAN JOSE  CA  95110
+				US
+
+00-D0-89   (hex)		DYNACOLOR, INC.
+00D089     (base 16)		DYNACOLOR, INC.
+				No.116, Zhouzi St., Neihu Dist.
+				Taipei City    114
+				TW
+
+00-D0-2C   (hex)		CAMPBELL SCIENTIFIC, INC.
+00D02C     (base 16)		CAMPBELL SCIENTIFIC, INC.
+				815 W. 1800 N.
+				LOGAN  UT  84321-1784
+				US
+
+00-D0-CD   (hex)		ATAN TECHNOLOGY INC.
+00D0CD     (base 16)		ATAN TECHNOLOGY INC.
+				#5, ALLEY 18, LANE 81,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-D0-40   (hex)		SYSMATE CO., LTD.
+00D040     (base 16)		SYSMATE CO., LTD.
+				1091 WOLPYONG-DONG
+				  SOUTH  KOREA
+				KR
+
+00-D0-1A   (hex)		URMET  TLC S.P.A.
+00D01A     (base 16)		URMET  TLC S.P.A.
+				VIA DI CASTEL ROMANO 167
+				    
+				IT
+
+00-50-FF   (hex)		HAKKO ELECTRONICS CO., LTD.
+0050FF     (base 16)		HAKKO ELECTRONICS CO., LTD.
+				238, KAMIKASHIWANO-MACHI
+				MATTO-SHI, ISHIKAWA 924-0035    
+				JP
+
+00-50-D2   (hex)		CMC Electronics Inc
+0050D2     (base 16)		CMC Electronics Inc
+				600 Dr.Frederik-Philips Blvd
+				Montreal    QC H4M 2S9
+				CA
+
+00-50-F9   (hex)		Sensormatic Electronics LLC
+0050F9     (base 16)		Sensormatic Electronics LLC
+				1501 Yamato Rd
+				Boca Raton  FL  33431
+				US
+
+00-50-48   (hex)		INFOLIBRIA
+005048     (base 16)		INFOLIBRIA
+				411 WAVERLY OAKS RD-STE #323
+				WALTHAM  MA  02154-8414
+				US
+
+00-50-4E   (hex)		SIERRA MONITOR CORP.
+00504E     (base 16)		SIERRA MONITOR CORP.
+				1991 TAROB COURT
+				MILPITAS  CA  95035
+				US
+
+00-50-F6   (hex)		PAN-INTERNATIONAL INDUSTRIAL CORP.
+0050F6     (base 16)		PAN-INTERNATIONAL INDUSTRIAL CORP.
+				GF, NO. 176, CHANG CHUN RD.
+				TAIPEI    
+				TW
+
+00-50-6C   (hex)		Beijer Electronics Products AB
+00506C     (base 16)		Beijer Electronics Products AB
+				Box 426
+				SE-201 24  Malmoe  
+				SE
+
+00-50-D7   (hex)		TELSTRAT
+0050D7     (base 16)		TELSTRAT
+				3600 AVENUE
+				PLANO  TX  75074
+				US
+
+00-50-44   (hex)		ASACA CORPORATION
+005044     (base 16)		ASACA CORPORATION
+				420 CORPORATE CIRCLE, Unit H
+				GOLDEN  CO  80401
+				US
+
+00-50-E6   (hex)		HAKUSAN CORPORATION
+0050E6     (base 16)		HAKUSAN CORPORATION
+				J TOWER, 1-1, NIKKOU-CHO
+				    
+				JP
+
+00-50-3C   (hex)		TSINGHUA NOVEL ELECTRONICS
+00503C     (base 16)		TSINGHUA NOVEL ELECTRONICS
+				CO., LTD.
+				100084  100084  
+				CN
+
+00-50-60   (hex)		TANDBERG TELECOM AS
+005060     (base 16)		TANDBERG TELECOM AS
+				Philip Pedersens vei 20
+				1361  Lysaker  
+				NO
+
+00-50-EE   (hex)		TEK DIGITEL CORPORATION
+0050EE     (base 16)		TEK DIGITEL CORPORATION
+				20010 CENTURY BLVD. #300
+				GERMANTOWN  MD  20874
+				US
+
+00-50-45   (hex)		RIOWORKS SOLUTIONS, INC.
+005045     (base 16)		RIOWORKS SOLUTIONS, INC.
+				4F, NO.28, LANE 583
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-50-2B   (hex)		GENRAD LTD.
+00502B     (base 16)		GENRAD LTD.
+				ORION BUSINESS PARK
+				UNITED KINGDOM  SK3  OXG
+				GB
+
+00-50-2E   (hex)		CAMBEX CORPORATION
+00502E     (base 16)		CAMBEX CORPORATION
+				115 Flanders Road
+				Westborough  MA  01581
+				US
+
+00-50-6E   (hex)		CORDER ENGINEERING CORPORATION
+00506E     (base 16)		CORDER ENGINEERING CORPORATION
+				151 KALMUS DRIVE - STE #A103
+				COSTA MESA  CA  92626
+				US
+
+00-50-2C   (hex)		SOYO COMPUTER, INC.
+00502C     (base 16)		SOYO COMPUTER, INC.
+				NO. 21 WU-KUNG 5 RD.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-50-77   (hex)		PROLIFIC TECHNOLOGY, INC.
+005077     (base 16)		PROLIFIC TECHNOLOGY, INC.
+				6F 1, LANE 51, SEC 1
+				    100
+				TW
+
+00-50-33   (hex)		MAYAN NETWORKS
+005033     (base 16)		MAYAN NETWORKS
+				3350 SCOTT BLVD. - BLDG. #9
+				SANTA CLARA  CA  95054
+				US
+
+00-50-0E   (hex)		CHROMATIS NETWORKS, INC.
+00500E     (base 16)		CHROMATIS NETWORKS, INC.
+				3 BETHESDA METRO CENTER
+				BETHESDA  MD  20814
+				US
+
+00-D0-CC   (hex)		TECHNOLOGIES LYRE INC.
+00D0CC     (base 16)		TECHNOLOGIES LYRE INC.
+				1200 ST-JEAN-BAPTISTE,
+				CANADA  G2E  5E8
+				CA
+
+00-50-EC   (hex)		OLICOM A/S
+0050EC     (base 16)		OLICOM A/S
+				NYBROVEJ 114
+				    
+				DK
+
+00-50-C9   (hex)		MASPRO DENKOH CORP.
+0050C9     (base 16)		MASPRO DENKOH CORP.
+				ASADA NISSHIN AICHI
+				    
+				JP
+
+00-50-BB   (hex)		CMS TECHNOLOGIES
+0050BB     (base 16)		CMS TECHNOLOGIES
+				13955 FARMINGTON RAOD
+				LIVONIA  MI  48154
+				US
+
+00-50-62   (hex)		KOUWELL ELECTRONICS CORP.  **
+005062     (base 16)		KOUWELL ELECTRONICS CORP.  **
+				7F, NO.99, NAN-KANG ROAD
+				    
+				TW
+
+00-50-D5   (hex)		AD SYSTEMS CORP.
+0050D5     (base 16)		AD SYSTEMS CORP.
+				1-4-1, NAKACHO, MUSASHINO CITY
+				TOKYO 180-0006    
+				JP
+
+00-50-F3   (hex)		GLOBAL NET INFORMATION CO., Ltd.
+0050F3     (base 16)		GLOBAL NET INFORMATION CO., Ltd.
+				NORTH TOWER- RM 1305
+				GUANG ZHOU 510095    
+				CN
+
+00-50-BE   (hex)		FAST MULTIMEDIA AG
+0050BE     (base 16)		FAST MULTIMEDIA AG
+				RUEDESHEIMERSTR. 11-13
+				80686 MUNICH    
+				DE
+
+00-50-6F   (hex)		G-CONNECT
+00506F     (base 16)		G-CONNECT
+				P.O. BOX 2200
+				HERZLIYA 46120    
+				IL
+
+00-50-F8   (hex)		ENTREGA TECHNOLOGIES, INC.
+0050F8     (base 16)		ENTREGA TECHNOLOGIES, INC.
+				25691 ATLANTIC OCEAN DRIVE
+				LAKE FOREST  CA  92630
+				US
+
+00-50-42   (hex)		SCI MANUFACTURING SINGAPORE PTE, LTD.
+005042     (base 16)		SCI MANUFACTURING SINGAPORE PTE, LTD.
+				3 DEPOT CLOSE
+				  SINGAPORE 109840  
+				SG
+
+00-50-C0   (hex)		GATAN, INC.
+0050C0     (base 16)		GATAN, INC.
+				5933 CORONADO LANE
+				PLEASANTON  CA  94588
+				US
+
+00-50-51   (hex)		IWATSU ELECTRIC CO., LTD.
+005051     (base 16)		IWATSU ELECTRIC CO., LTD.
+				7-41, KUGAYAMA 1-CHOME
+				SUGINAMI-KU, TOKYO 168-8501    
+				JP
+
+00-50-7D   (hex)		IFP
+00507D     (base 16)		IFP
+				LESSINGSTR. 4
+				D-78315 RADOLFZELL    
+				DE
+
+00-50-97   (hex)		MMC-EMBEDDED COMPUTERTECHNIK GmbH
+005097     (base 16)		MMC-EMBEDDED COMPUTERTECHNIK GmbH
+				ULRICHSBERGERSTR. 17
+				D-94469 DEGGENDORF    
+				DE
+
+00-50-10   (hex)		NovaNET Learning, Inc.
+005010     (base 16)		NovaNET Learning, Inc.
+				125 W. CHURCH STREET-STE. #300
+				CHAMPAIGN  IL  61820
+				US
+
+00-50-9A   (hex)		TAG ELECTRONIC SYSTEMS
+00509A     (base 16)		TAG ELECTRONIC SYSTEMS
+				GENESIS BUSINESS PARK
+				WOKING, SURREY GU21 5RW    
+				GB
+
+00-50-22   (hex)		ZONET TECHNOLOGY, INC.
+005022     (base 16)		ZONET TECHNOLOGY, INC.
+				830 ROOM, BLDG. 53, 195, SEC.4
+				HSINCHA    
+				TW
+
+00-50-07   (hex)		SIEMENS TELECOMMUNICATION SYSTEMS LIMITED
+005007     (base 16)		SIEMENS TELECOMMUNICATION SYSTEMS LIMITED
+				NO. 90, SEC. 1, CHIEN KUO NORTH ROAD
+				TAIPEI    
+				TW
+
+00-50-40   (hex)		Panasonic Electric Works Co., Ltd.
+005040     (base 16)		Panasonic Electric Works Co., Ltd.
+				Tsu-Factory, 1668, Fujikata
+				Tsu-shi  Mie-ken  514-8555
+				JP
+
+00-50-1C   (hex)		JATOM SYSTEMS, INC.
+00501C     (base 16)		JATOM SYSTEMS, INC.
+				99 MICHAEL COWPLAND DRIVE
+				ONTARIO, K2M 1X3    
+				CA
+
+00-50-92   (hex)		Rigaku Corporation Osaka Plant
+005092     (base 16)		Rigaku Corporation Osaka Plant
+				14-8 AKAOJI-CHO
+				TAKATSUKI-SHI, OSAKA 569-1146    
+				JP
+
+00-50-7A   (hex)		XPEED, INC.
+00507A     (base 16)		XPEED, INC.
+				4699 OLD IRONSIDES DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-50-69   (hex)		PixStream Incorporated
+005069     (base 16)		PixStream Incorporated
+				180 COLUMBIA ST. W.
+				Ontario N2L 3L3    
+				CA
+
+00-50-68   (hex)		ELECTRONIC INDUSTRIES ASSOCIATION
+005068     (base 16)		ELECTRONIC INDUSTRIES ASSOCIATION
+				2500 WILSON BLVD.
+				ARLINGTON  VA  22201
+				US
+
+00-50-BC   (hex)		HAMMER STORAGE SOLUTIONS
+0050BC     (base 16)		HAMMER STORAGE SOLUTIONS
+				8450 CENTRAL AVENUE
+				NEWARK  CA  94560
+				US
+
+00-90-71   (hex)		Applied Innovation Inc.
+009071     (base 16)		Applied Innovation Inc.
+				5800 Innovation Drive
+				Dublin  OH  43016-3271
+				US
+
+00-50-EB   (hex)		ALPHA-TOP CORPORATION
+0050EB     (base 16)		ALPHA-TOP CORPORATION
+				19F., NO. 2, LANE 150
+				TAIPEI    
+				TW
+
+00-50-EF   (hex)		SPE Systemhaus GmbH
+0050EF     (base 16)		SPE Systemhaus GmbH
+				WALDSTRASSE 7
+				63150 HEUSENSTAMM    
+				DE
+
+00-50-98   (hex)		GLOBALOOP, LTD.
+005098     (base 16)		GLOBALOOP, LTD.
+				12 HASHARON ROAD
+				KFAR SABA 44269    
+				IL
+
+00-50-4F   (hex)		OLENCOM ELECTRONICS
+00504F     (base 16)		OLENCOM ELECTRONICS
+				SOLTAM INDUSTRIAL PARK
+				YOKNEAM 20692    
+				IL
+
+00-90-FF   (hex)		TELLUS TECHNOLOGY INC.
+0090FF     (base 16)		TELLUS TECHNOLOGY INC.
+				40990 ENCYCLOPEDIA CIR.
+				FREMONT  CA  94538-2470
+				US
+
+00-90-3E   (hex)		N.V. PHILIPS INDUSTRIAL ACTIVITIES
+00903E     (base 16)		N.V. PHILIPS INDUSTRIAL ACTIVITIES
+				
+				B-3001 LEUVEN    
+				BE
+
+00-90-BA   (hex)		VALID NETWORKS, INC.
+0090BA     (base 16)		VALID NETWORKS, INC.
+				6 CROMWELL #102
+				IRVINE  CA  92618
+				US
+
+00-90-18   (hex)		ITO ELECTRIC INDUSTRY CO, LTD.
+009018     (base 16)		ITO ELECTRIC INDUSTRY CO, LTD.
+				4-26-12 MEIEKI NAKAMURA-KU
+				NAGOYA-CITY AICHI 450-0002    
+				JP
+
+00-90-CD   (hex)		ENT-EMPRESA NACIONAL DE TELECOMMUNICACOES, S.A.
+0090CD     (base 16)		ENT-EMPRESA NACIONAL DE TELECOMMUNICACOES, S.A.
+				R. ENG FREDERICO ULRICH -  APARTADO 3081
+				Guardeiras - 4470 Moreira Maia    
+				PT
+
+00-90-FB   (hex)		PORTWELL, INC.
+0090FB     (base 16)		PORTWELL, INC.
+				7F-4, NO. 160, SEC. 6
+				TAIPEI    
+				TW
+
+00-90-94   (hex)		OSPREY TECHNOLOGIES, INC.
+009094     (base 16)		OSPREY TECHNOLOGIES, INC.
+				600 AIRPORT BLVD. - STE. #900
+				MORRISVILLE  NC  27560
+				US
+
+00-90-B3   (hex)		AGRANAT SYSTEMS
+0090B3     (base 16)		AGRANAT SYSTEMS
+				1345 MAIN STREET
+				WALTHAM  MA  02154
+				US
+
+00-90-3C   (hex)		ATLANTIC NETWORK SYSTEMS
+00903C     (base 16)		ATLANTIC NETWORK SYSTEMS
+				IMMEUBLE Kennedy
+				  33700 MERIGNAC  
+				FR
+
+00-90-5D   (hex)		NETCOM SICHERHEITSTECHNIK GMBH
+00905D     (base 16)		NETCOM SICHERHEITSTECHNIK GMBH
+				BOPPSTRASSE 38
+				    
+				DE
+
+00-90-D1   (hex)		LEICHU ENTERPRISE CO., LTD.
+0090D1     (base 16)		LEICHU ENTERPRISE CO., LTD.
+				8F, NO. 203, PA-TEH ROAD, SEC.2
+				    
+				TW
+
+00-90-46   (hex)		DEXDYNE, LTD.
+009046     (base 16)		DEXDYNE, LTD.
+				15 MARKET PL.
+				GLOCESTERSHIRE GL7 2PB    
+				GB
+
+00-90-DA   (hex)		DYNARC, INC.
+0090DA     (base 16)		DYNARC, INC.
+				1887 LANDINGS DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-90-E0   (hex)		SYSTRAN CORP.
+0090E0     (base 16)		SYSTRAN CORP.
+				4126 LINDEN AVENUE
+				DAYTON  OH  45432
+				US
+
+00-90-D0   (hex)		Thomson Telecom Belgium
+0090D0     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				B-2650 EDEGEM    
+				BE
+
+00-90-9B   (hex)		MARKEM-IMAJE
+00909B     (base 16)		MARKEM-IMAJE
+				Frihamnen 16A
+				Gothenburg    417 55
+				SE
+
+00-90-22   (hex)		IVEX
+009022     (base 16)		IVEX
+				4295 INTERNATIONAL BLVD.
+				NORCROSS  GA  30093
+				US
+
+00-90-16   (hex)		ZAC
+009016     (base 16)		ZAC
+				Stüvestraße 9
+				D-31141 Hildesheim    
+				DE
+
+00-90-A7   (hex)		CLIENTEC CORPORATION
+0090A7     (base 16)		CLIENTEC CORPORATION
+				8175 S. VIRGINIA ST.
+				RENO  NV  89511
+				US
+
+00-90-53   (hex)		DAEWOO ELECTRONICS CO., LTD.
+009053     (base 16)		DAEWOO ELECTRONICS CO., LTD.
+				DIT RESEARCH CENTER
+				CHUNG-GU  SEOUL 100-714  
+				KR
+
+00-90-DC   (hex)		TECO INFORMATION SYSTEMS
+0090DC     (base 16)		TECO INFORMATION SYSTEMS
+				CO., LTD.
+				SAN JOSE  CA  95134
+				US
+
+00-90-E2   (hex)		DISTRIBUTED PROCESSING TECHNOLOGY
+0090E2     (base 16)		DISTRIBUTED PROCESSING TECHNOLOGY
+				140 CANDACE DRIVE
+				ORLANDO  FL  32751
+				US
+
+00-90-85   (hex)		GOLDEN ENTERPRISES, INC.
+009085     (base 16)		GOLDEN ENTERPRISES, INC.
+				4450 WEST EAU GALLIE BLVD.
+				MELBOURNE  FL  32934
+				US
+
+00-90-C7   (hex)		ICOM INC.
+0090C7     (base 16)		ICOM INC.
+				6-9-16 KAMIHIGASHI
+				HIRANO-KU, OSAKA    
+				JP
+
+00-90-35   (hex)		ALPHA TELECOM, INC.
+009035     (base 16)		ALPHA TELECOM, INC.
+				2F, NO.2, LI HSIN ROAD
+				HSIN-CHU    
+				TW
+
+00-90-0F   (hex)		KAWASAKI HEAVY INDUSTRIES, LTD
+00900F     (base 16)		KAWASAKI HEAVY INDUSTRIES, LTD
+				ELEC. & CONTROL TECH CENTER
+				    
+				JP
+
+00-90-EA   (hex)		ALPHA TECHNOLOGIES, INC.
+0090EA     (base 16)		ALPHA TECHNOLOGIES, INC.
+				3767 ALPHA WAY
+				BELLINGHAM  WA  98226
+				US
+
+00-90-77   (hex)		ADVANCED FIBRE COMMUNICATIONS
+009077     (base 16)		ADVANCED FIBRE COMMUNICATIONS
+				PO BOX #751239
+				PETALUMA  CA  94975
+				US
+
+00-90-99   (hex)		ALLIED TELESIS, K.K.
+009099     (base 16)		ALLIED TELESIS, K.K.
+				NO. 2  TOC BUILDING, 7-21-11Nishi-Gotand
+				Shinagawa-Ku  Tokyo 141  
+				JP
+
+00-10-AD   (hex)		SOFTRONICS USB, INC.
+0010AD     (base 16)		SOFTRONICS USB, INC.
+				5085 LIST DRIVE
+				COLORADO SPRINGS  CO  80919
+				US
+
+00-10-A7   (hex)		UNEX TECHNOLOGY CORPORATION
+0010A7     (base 16)		UNEX TECHNOLOGY CORPORATION
+				8F-5, #130, SZE WEI RD.,
+				HSINCHU    
+				TW
+
+00-10-D5   (hex)		IMASDE CANARIAS, S.A.
+0010D5     (base 16)		IMASDE CANARIAS, S.A.
+				URB. EL CEBADAL
+				35008 LAS PALMAS G.C.    
+				ES
+
+00-10-55   (hex)		FUJITSU MICROELECTRONICS, INC.
+001055     (base 16)		FUJITSU MICROELECTRONICS, INC.
+				3545 NORTH FIRST STREET
+				SAN JOSE  CA  95134-1806
+				US
+
+00-90-7A   (hex)		Spectralink, Inc
+00907A     (base 16)		Spectralink, Inc
+				2560 55th Street
+				BOULDER  CO  80301
+				US
+
+00-90-F0   (hex)		Harmonic Video Systems Ltd.
+0090F0     (base 16)		Harmonic Video Systems Ltd.
+				19 ALON HATAVOR STREET
+				CAESAREA  Industrial Park    38900
+				IL
+
+00-90-20   (hex)		PHILIPS ANALYTICAL X-RAY B.V.
+009020     (base 16)		PHILIPS ANALYTICAL X-RAY B.V.
+				LELYWEG 1
+				7602 EA ALMELO    
+				NL
+
+00-10-A3   (hex)		OMNITRONIX, INC.
+0010A3     (base 16)		OMNITRONIX, INC.
+				760 HARRISON STREET
+				SEATTLE  WA  98109
+				US
+
+00-90-5C   (hex)		EDMI
+00905C     (base 16)		EDMI
+				626 OLD GYMPIE ROAD
+				NARANGBA  QLD 4504  
+				AU
+
+00-90-E3   (hex)		AVEX ELECTRONICS INC.
+0090E3     (base 16)		AVEX ELECTRONICS INC.
+				4807 BRADFORD DRIVE
+				HUNTSVILLE  AL  35805
+				US
+
+00-90-A9   (hex)		WESTERN DIGITAL
+0090A9     (base 16)		WESTERN DIGITAL
+				1599 NORTH BROADWAY
+				ROCHESTER  MN  55906
+				US
+
+00-90-F3   (hex)		ASPECT COMMUNICATIONS
+0090F3     (base 16)		ASPECT COMMUNICATIONS
+				1310 Ridder Park Drive
+				San Jose  CA  95131-2313
+				US
+
+00-90-4F   (hex)		ABB POWER T&D COMPANY, INC.
+00904F     (base 16)		ABB POWER T&D COMPANY, INC.
+				7036 SNOWDRIFT ROAD
+				ALLENTOWN  PA  18106
+				US
+
+00-90-60   (hex)		SYSTEM CREATE CORP.
+009060     (base 16)		SYSTEM CREATE CORP.
+				3-13-6 YOSHIKAWA BLD.
+				TOKYO    
+				JP
+
+00-90-13   (hex)		SAMSAN CORP.
+009013     (base 16)		SAMSAN CORP.
+				ELECTRONICS & COMM DIVISION
+				Kangdong-Gu  Seoul 134-050  
+				KR
+
+00-10-52   (hex)		METTLER-TOLEDO (ALBSTADT) GMBH
+001052     (base 16)		METTLER-TOLEDO (ALBSTADT) GMBH
+				P.O. BOX 2 50
+				D-72423 ALBSTADT    
+				DE
+
+00-10-6B   (hex)		SONUS NETWORKS, INC.
+00106B     (base 16)		SONUS NETWORKS, INC.
+				5 CARLISLE ROAD
+				WESTFORD  MA  01886
+				US
+
+00-10-C3   (hex)		CSI-CONTROL SYSTEMS
+0010C3     (base 16)		CSI-CONTROL SYSTEMS
+				INTERNATIONAL
+				DALLAS  TX  75229
+				US
+
+00-90-55   (hex)		PARKER HANNIFIN CORPORATION COMPUMOTOR DIVISION
+009055     (base 16)		PARKER HANNIFIN CORPORATION COMPUMOTOR DIVISION
+				5500 BUSINESS PARK DRIVE
+				ROHNERT PARK  CA  94928
+				US
+
+00-10-DD   (hex)		ENABLE SEMICONDUCTOR, INC.
+0010DD     (base 16)		ENABLE SEMICONDUCTOR, INC.
+				1740 TECHNOLOGY DRIVE
+				SAN JOSE  CA  95110
+				US
+
+00-10-2D   (hex)		HITACHI SOFTWARE ENGINEERING
+00102D     (base 16)		HITACHI SOFTWARE ENGINEERING
+				5-79, ONOECHO, NAKA-KU
+				YOKOHAMA 231    
+				JP
+
+00-10-33   (hex)		ACCESSLAN COMMUNICATIONS, INC.
+001033     (base 16)		ACCESSLAN COMMUNICATIONS, INC.
+				44 AIRPORT PARKWAY
+				SAN JOSE  CA  95110
+				US
+
+00-10-12   (hex)		PROCESSOR SYSTEMS (I) PVT LTD
+001012     (base 16)		PROCESSOR SYSTEMS (I) PVT LTD
+				24 RICHMOND ROAD
+				BANGALORE 560 025    
+				IN
+
+00-10-15   (hex)		OOmon Inc.
+001015     (base 16)		OOmon Inc.
+				PO BOX 8241
+				COBURG  OR  97408
+				US
+
+00-10-78   (hex)		NUERA COMMUNICATIONS, INC.
+001078     (base 16)		NUERA COMMUNICATIONS, INC.
+				10445 PACIFIC CENTER COURT
+				SAN DIEGO  CA  92121
+				US
+
+00-10-4F   (hex)		Oracle Corporation 
+00104F     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-10-7A   (hex)		AmbiCom, Inc.
+00107A     (base 16)		AmbiCom, Inc.
+				2450 SCOTT BLVD., #305
+				SANTA CLARA  CA  95050
+				US
+
+00-10-B9   (hex)		MAXTOR CORP.
+0010B9     (base 16)		MAXTOR CORP.
+				2190 MILLER DRIVE
+				LONGMONT  CO  80501-6744
+				US
+
+00-10-5D   (hex)		Draeger Medical
+00105D     (base 16)		Draeger Medical
+				Moislinger Allee 53-55
+				Luebeck    D-23542
+				DE
+
+00-10-91   (hex)		NO WIRES NEEDED BV
+001091     (base 16)		NO WIRES NEEDED BV
+				P.O. BOX 343
+				3720 AH BILTHOVEN    
+				NL
+
+00-10-1B   (hex)		CORNET TECHNOLOGY, INC.
+00101B     (base 16)		CORNET TECHNOLOGY, INC.
+				7F-4, NO. 46 CHUNG SHAN N.ROAD
+				SEC. 2, TAIPEI    
+				TJ
+
+00-10-DC   (hex)		MICRO-STAR INTERNATIONAL CO., LTD.
+0010DC     (base 16)		MICRO-STAR INTERNATIONAL CO., LTD.
+				NO. 69, LI-DE ST., JUNG-HE CITY
+				Taipei Hsien    
+				TW
+
+00-10-0A   (hex)		WILLIAMS COMMUNICATIONS GROUP
+00100A     (base 16)		WILLIAMS COMMUNICATIONS GROUP
+				ADVANCED TECHNOLOGIES
+				TULSA  OK  74103
+				US
+
+00-10-32   (hex)		ALTA TECHNOLOGY
+001032     (base 16)		ALTA TECHNOLOGY
+				9500 SOUTH 500 WEST - STE #212
+				SANDY  UT  84070
+				US
+
+00-10-80   (hex)		METAWAVE COMMUNICATIONS
+001080     (base 16)		METAWAVE COMMUNICATIONS
+				8700 148TH AVENUE N.E.
+				REDMOND  WA  98052
+				US
+
+00-10-F4   (hex)		Vertical Communications
+0010F4     (base 16)		Vertical Communications
+				3979 Freedom Circle #400
+				Santa Clara  CA  95054-1247
+				US
+
+00-10-77   (hex)		SAF DRIVE SYSTEMS, LTD.
+001077     (base 16)		SAF DRIVE SYSTEMS, LTD.
+				88 ARDELT AVE.
+				KITCHENER, ONTARIO N2C 2C9    
+				CA
+
+00-10-B3   (hex)		NOKIA MULTIMEDIA TERMINALS
+0010B3     (base 16)		NOKIA MULTIMEDIA TERMINALS
+				NOKIA HOME COMMUNICATIONS
+				SE-583 35 LINKOPING    
+				SE
+
+00-10-1E   (hex)		MATSUSHITA ELECTRONIC INSTRUMENTS CORP.
+00101E     (base 16)		MATSUSHITA ELECTRONIC INSTRUMENTS CORP.
+				23-9 KIYOHARA INDUSTRIAL PARK
+				UTSUNOMIYA Tochigi 321-32    
+				JP
+
+00-10-4D   (hex)		SURTEC INDUSTRIES, INC.
+00104D     (base 16)		SURTEC INDUSTRIES, INC.
+				NO.11, ALLEY 16, LANE 337
+				TAIPEI    
+				TW
+
+00-10-51   (hex)		CMICRO CORPORATION
+001051     (base 16)		CMICRO CORPORATION
+				17-20-2 KAMINO-CHO
+				TAKAMATSU-SHI, KAGAWA 761    
+				JP
+
+00-10-37   (hex)		CYQ've Technology Co., Ltd.
+001037     (base 16)		CYQ've Technology Co., Ltd.
+				COSMO BLDG. 10F, NO.1-7
+				SHINJUKU-KU,  TOKYO 160    
+				JP
+
+00-E0-BB   (hex)		NBX CORPORATION
+00E0BB     (base 16)		NBX CORPORATION
+				100 BRICKSTONE SQUARE
+				ANDOVER  MA  01810
+				US
+
+00-E0-8A   (hex)		GEC AVERY, LTD.
+00E08A     (base 16)		GEC AVERY, LTD.
+				FOUNDRY LANE
+				WEST MIDLANDS, B66 2LP  England  
+				GB
+
+00-E0-86   (hex)		Emerson Network Power, Avocent Division
+00E086     (base 16)		Emerson Network Power, Avocent Division
+				4991 Corporate Drive
+				HUNTSVILLE  AL  35805
+				US
+
+00-E0-1B   (hex)		SPHERE COMMUNICATIONS, INC.
+00E01B     (base 16)		SPHERE COMMUNICATIONS, INC.
+				2 ENERGY DRIVE
+				LAKE BLUFF  IL  60044
+				US
+
+00-E0-59   (hex)		CONTROLLED ENVIRONMENTS, LTD.
+00E059     (base 16)		CONTROLLED ENVIRONMENTS, LTD.
+				590 BERRY STREET
+				WINNEPEG R3H OR9    
+				CA
+
+00-E0-C5   (hex)		BCOM ELECTRONICS INC.
+00E0C5     (base 16)		BCOM ELECTRONICS INC.
+				8 FL, NO. 64, AN HO ROAD, SEC. 2
+				TAIPEI    
+				TW
+
+00-E0-EE   (hex)		MAREL HF
+00E0EE     (base 16)		MAREL HF
+				Austurhraun 9
+				Gardabaer    210
+				IS
+
+00-E0-8E   (hex)		UTSTARCOM
+00E08E     (base 16)		UTSTARCOM
+				33 WOOD AVE. SOUTH
+				ISELIN  NJ  08830
+				US
+
+00-E0-3F   (hex)		JATON CORPORATION
+00E03F     (base 16)		JATON CORPORATION
+				556 SOUTH MILPITAS BLVD.
+				MILPITAS  CA  95035
+				US
+
+00-E0-D4   (hex)		EXCELLENT COMPUTER
+00E0D4     (base 16)		EXCELLENT COMPUTER
+				551, M.K.N. ROAD
+				ALANDUR, CHENNAI 600016    
+				IN
+
+00-E0-7F   (hex)		LOGISTISTEM s.r.l.
+00E07F     (base 16)		LOGISTISTEM s.r.l.
+				VIA PANCIATICHI 94/18
+				50127 FIRENZE    
+				IT
+
+00-E0-13   (hex)		EASTERN ELECTRONIC CO., LTD.
+00E013     (base 16)		EASTERN ELECTRONIC CO., LTD.
+				NO. 4, SHIN-LONG ROAD,
+				TAO-YUAN    
+				TW
+
+00-E0-FD   (hex)		A-TREND TECHNOLOGY CO., LTD.
+00E0FD     (base 16)		A-TREND TECHNOLOGY CO., LTD.
+				10F, NO. 75, HSIN TAI WU RD.,
+				TAIPEI HSIEN 221    
+				TJ
+
+00-E0-BD   (hex)		INTERFACE SYSTEMS, INC.
+00E0BD     (base 16)		INTERFACE SYSTEMS, INC.
+				5855 INTERFACE DRIVE
+				ANN ARBOR  MI  48103-9515
+				US
+
+00-E0-6E   (hex)		FAR SYSTEMS S.p.A.
+00E06E     (base 16)		FAR SYSTEMS S.p.A.
+				VIA F. ZENI 8
+				3868 ROVERETO (TN)    
+				IT
+
+00-E0-6D   (hex)		COMPUWARE CORPORATION
+00E06D     (base 16)		COMPUWARE CORPORATION
+				One Campus Martius
+				Detroit  MI  48226
+				US
+
+00-E0-EA   (hex)		INNOVAT COMMUNICATIONS, INC.
+00E0EA     (base 16)		INNOVAT COMMUNICATIONS, INC.
+				1257 N. PLANO ROAD
+				RICHARDSON  TX  75081
+				US
+
+00-E0-64   (hex)		SAMSUNG ELECTRONICS
+00E064     (base 16)		SAMSUNG ELECTRONICS
+				99 W. TASMAN DRIVE
+				SAN JOSE  CA  95134
+				US
+
+00-E0-C9   (hex)		AutomatedLogic Corporation
+00E0C9     (base 16)		AutomatedLogic Corporation
+				1150 ROBERTS BOULEVARD
+				KENNESAW  GA  30144-3618
+				US
+
+00-E0-38   (hex)		PROXIMA CORPORATION
+00E038     (base 16)		PROXIMA CORPORATION
+				9440 CARROLL PARK DRIVE
+				SAN DIEGO  CA  92121-2298
+				US
+
+00-E0-9C   (hex)		MII
+00E09C     (base 16)		MII
+				LE parc du MOULIN
+				F95650 PUISEUX-POTOISE    
+				FR
+
+00-E0-E9   (hex)		DATA LABS, INC.
+00E0E9     (base 16)		DATA LABS, INC.
+				444 NORTH FREDERICK AVE.
+				GAITHERSBURG  MD  20877
+				US
+
+00-E0-0C   (hex)		MOTOROLA
+00E00C     (base 16)		MOTOROLA
+				5401 N. BEACH ST.  S243
+				FT. WORTH  TX  76137
+				US
+
+00-E0-0A   (hex)		DIBA, INC.
+00E00A     (base 16)		DIBA, INC.
+				3355 EDISON WAY
+				MENLO PARK  CA  94025
+				US
+
+00-E0-C4   (hex)		HORNER ELECTRIC, INC.
+00E0C4     (base 16)		HORNER ELECTRIC, INC.
+				1521 E. WASHINGTON ST.
+				INDIANAPOLIS  IN  46201
+				US
+
+00-E0-69   (hex)		JAYCOR
+00E069     (base 16)		JAYCOR
+				9775 TOWNE CENTRE DRIVE
+				SAN DIEGO  CA  92121
+				US
+
+00-E0-A4   (hex)		ESAOTE S.p.A.
+00E0A4     (base 16)		ESAOTE S.p.A.
+				via di CACIOLLE, 15
+				50127 FLORENCE    
+				IT
+
+00-E0-DE   (hex)		DATAX NV
+00E0DE     (base 16)		DATAX NV
+				RINGLAAN 51
+				B-2600 BERCHEM    
+				BE
+
+00-E0-A5   (hex)		ComCore Semiconductor, Inc.
+00E0A5     (base 16)		ComCore Semiconductor, Inc.
+				4505 LAS VIRGENES, Suite 202
+				CALABASAS  CA  91302
+				US
+
+00-E0-15   (hex)		HEIWA CORPORATION
+00E015     (base 16)		HEIWA CORPORATION
+				2-3014-8, HIROSAWA-CHO
+				GUNMA PREF. 376    
+				JP
+
+00-E0-E8   (hex)		GRETACODER Data Systems AG
+00E0E8     (base 16)		GRETACODER Data Systems AG
+				ALTHARDSTRASSE  150
+				CH-8105 REGENSDORF    
+				CH
+
+00-E0-16   (hex)		RAPID CITY COMMUNICATIONS
+00E016     (base 16)		RAPID CITY COMMUNICATIONS
+				555 CLYDE AVE.
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-E0-05   (hex)		TECHNICAL CORP.
+00E005     (base 16)		TECHNICAL CORP.
+				22-6 MINAMI SENGENCHO
+				KANAGAWA    
+				JP
+
+00-E0-C1   (hex)		MEMOREX TELEX JAPAN, LTD.
+00E0C1     (base 16)		MEMOREX TELEX JAPAN, LTD.
+				YAESUGUCHI KAIKAN, 1-7-20
+				TOKYO 103    
+				JP
+
+00-E0-A9   (hex)		FUNAI ELECTRIC CO., LTD.
+00E0A9     (base 16)		FUNAI ELECTRIC CO., LTD.
+				7-1, NAKAGAITO 7-CHOME, DAITO
+				OSAKA  574    
+				JP
+
+00-E0-84   (hex)		COMPULITE R&D
+00E084     (base 16)		COMPULITE R&D
+				3 HAROSHET STR. NEW IND. ZONE
+				RAMAT-HASHARON 47279    
+				IL
+
+00-E0-96   (hex)		SHIMADZU CORPORATION
+00E096     (base 16)		SHIMADZU CORPORATION
+				1, NISHINOKYO-KUWABARACHO
+				NAKAGYO-KU, KYOTO 604    
+				US
+
+00-E0-17   (hex)		EXXACT GmbH
+00E017     (base 16)		EXXACT GmbH
+				RHEINSTRASE 7
+				D-41836 HUCKELHOVEN    
+				DE
+
+00-60-7F   (hex)		AURORA TECHNOLOGIES, INC.
+00607F     (base 16)		AURORA TECHNOLOGIES, INC.
+				176 SECOND AVENUE
+				WALTHAM  MA  02154
+				US
+
+00-E0-29   (hex)		STANDARD MICROSYSTEMS CORP.
+00E029     (base 16)		STANDARD MICROSYSTEMS CORP.
+				6 HUGHES
+				IRVINE  CA  92718
+				US
+
+00-60-74   (hex)		QSC LLC
+006074     (base 16)		QSC LLC
+				1675 MACARTHUR BLVD
+				COSTA MESA  CA  92626
+				US
+
+00-60-76   (hex)		SCHLUMBERGER TECHNOLOGIES RETAIL PETROLEUM SYSTEMS
+006076     (base 16)		SCHLUMBERGER TECHNOLOGIES RETAIL PETROLEUM SYSTEMS
+				825-M GREENBRIER CIRCLE
+				CHESAPEAKE  VA  23320
+				US
+
+00-60-A1   (hex)		VPNet, Inc.
+0060A1     (base 16)		VPNet, Inc.
+				555 N. MATHILDA AVE.,-STE #110
+				SUNNYVALE  CA  94086
+				US
+
+00-60-27   (hex)		Superior Modular Products
+006027     (base 16)		Superior Modular Products
+				General Technology Division
+				MELBOURNE  FL  32940
+				US
+
+00-60-BC   (hex)		KeunYoung Electronics & Communication Co., Ltd.
+0060BC     (base 16)		KeunYoung Electronics & Communication Co., Ltd.
+				325-76, DAEHEUNG-DONG, MAPO-GU,
+				SEOUL    
+				KR
+
+00-60-A5   (hex)		PERFORMANCE TELECOM CORP.
+0060A5     (base 16)		PERFORMANCE TELECOM CORP.
+				10 CARLSON ROAD
+				ROCHESTER  NY  14610-1021
+				US
+
+00-60-05   (hex)		FEEDBACK DATA LTD.
+006005     (base 16)		FEEDBACK DATA LTD.
+				PARK ROAD
+				EAST SUSSEX, TN6 2QR    
+				GB
+
+00-60-2E   (hex)		CYCLADES CORPORATION
+00602E     (base 16)		CYCLADES CORPORATION
+				41934 CHRISTY STREET
+				FREMONT  CA  94538
+				US
+
+00-60-B6   (hex)		LAND COMPUTER CO., LTD.
+0060B6     (base 16)		LAND COMPUTER CO., LTD.
+				7-4-17 NISHINAKAJIMA
+				YODOGAWAKU 532    
+				JP
+
+00-60-6C   (hex)		ARESCOM
+00606C     (base 16)		ARESCOM
+				2833 JUNCTION AVE. - STE #206
+				SAN JOSE  CA  95134
+				US
+
+00-60-E3   (hex)		ARBIN INSTRUMENTS
+0060E3     (base 16)		ARBIN INSTRUMENTS
+				3206 LONGMIRE DRIVE
+				COLLEGE STATION  TX  77845
+				US
+
+00-60-71   (hex)		MIDAS LAB, INC.
+006071     (base 16)		MIDAS LAB, INC.
+				4 KATAMACHI,
+				  TOKYO 160  
+				JP
+
+00-60-61   (hex)		WHISTLE COMMUNICATIONS CORP.
+006061     (base 16)		WHISTLE COMMUNICATIONS CORP.
+				110 MARSH DRIVE-STE #100
+				FOSTER CITY  CA  94404
+				US
+
+00-60-1B   (hex)		MESA ELECTRONICS
+00601B     (base 16)		MESA ELECTRONICS
+				1323 61ST STREET
+				EMERYVILLE  CA  94608-2117
+				US
+
+00-60-C5   (hex)		ANCOT CORP.
+0060C5     (base 16)		ANCOT CORP.
+				115 CONSTITUTION DR.
+				MENLO PARK  CA  94025
+				US
+
+00-60-A9   (hex)		GESYTEC MBH
+0060A9     (base 16)		GESYTEC MBH
+				PASCALSTRASSE 6
+				D 52076 AACHEN    
+				DE
+
+00-60-F2   (hex)		LASERGRAPHICS, INC.
+0060F2     (base 16)		LASERGRAPHICS, INC.
+				20 ADA
+				IRVINE  CA  92718
+				US
+
+00-60-C3   (hex)		NETVISION CORPORATION
+0060C3     (base 16)		NETVISION CORPORATION
+				MS# 1A
+				RONKONKOMA  NY  11779
+				US
+
+00-60-29   (hex)		CARY PERIPHERALS INC.
+006029     (base 16)		CARY PERIPHERALS INC.
+				190 COLONNADE ROAD S, UNIT 9
+				NEPEAN, ONTARIO K2E 7J5    
+				CA
+
+00-60-A8   (hex)		TIDOMAT AB
+0060A8     (base 16)		TIDOMAT AB
+				
+				S-12089 STOCKHOLM    
+				SE
+
+00-60-FC   (hex)		CONSERVATION THROUGH INNOVATION LTD.
+0060FC     (base 16)		CONSERVATION THROUGH INNOVATION LTD.
+				1040 WHIPPLE ST.- STE. #225
+				PRESCOTT  AZ  86301
+				US
+
+00-60-18   (hex)		STELLAR ONE CORPORATION
+006018     (base 16)		STELLAR ONE CORPORATION
+				500 108TH AVE. NE--STE. #2200
+				BELLEVUE  WA  98004
+				US
+
+00-60-0A   (hex)		SORD COMPUTER CORPORATION
+00600A     (base 16)		SORD COMPUTER CORPORATION
+				20-7, MASAGO 5-CHOME
+				CHIBA 261    
+				JP
+
+00-60-A4   (hex)		GEW Technologies (PTY)Ltd
+0060A4     (base 16)		GEW Technologies (PTY)Ltd
+				BOX 912-561
+				SILVERTON  0127    
+				ZA
+
+00-60-64   (hex)		NETCOMM LIMITED
+006064     (base 16)		NETCOMM LIMITED
+				PO BOX 379
+				NORTH RYDE, NSW, 2113    
+				AU
+
+00-60-F9   (hex)		DIAMOND LANE COMMUNICATIONS
+0060F9     (base 16)		DIAMOND LANE COMMUNICATIONS
+				1310 REDWOOD WAY - STE.
+				PETALUMA  CA  94954
+				US
+
+00-60-EA   (hex)		StreamLogic
+0060EA     (base 16)		StreamLogic
+				21329 NORDHOFF STREET
+				CHATSWORTH  CA  91311
+				US
+
+00-60-82   (hex)		NOVALINK TECHNOLOGIES, INC.
+006082     (base 16)		NOVALINK TECHNOLOGIES, INC.
+				48511 WARM SPRINGS BLVD. #208
+				FREMONT  CA  94539
+				US
+
+00-60-E7   (hex)		RANDATA
+0060E7     (base 16)		RANDATA
+				PO BOX 209
+				HAWTHORN  VIC  3122    
+				AU
+
+00-60-D9   (hex)		TRANSYS NETWORKS INC.
+0060D9     (base 16)		TRANSYS NETWORKS INC.
+				3403 GRIFFITH
+				ST. LAURENT, QUEBEC H4T 1W5    
+				CA
+
+00-60-1F   (hex)		STALLION TECHNOLOGIES
+00601F     (base 16)		STALLION TECHNOLOGIES
+				33 WOODSTOCK ROAD
+				TOOWONG Q-L-D- 4066    
+				AU
+
+00-60-54   (hex)		CONTROLWARE GMBH
+006054     (base 16)		CONTROLWARE GMBH
+				WALDSTRASSE 92
+				63128 DIETZENBACH    
+				DE
+
+00-60-C2   (hex)		MPL AG
+0060C2     (base 16)		MPL AG
+				Taefernstrasse 20
+				CH-5405  Daettwil  
+				CH
+
+00-60-D4   (hex)		ELDAT COMMUNICATION LTD.
+0060D4     (base 16)		ELDAT COMMUNICATION LTD.
+				10 HAKISHON STREET
+				BNEI-BRAK  51203    
+				IL
+
+00-A0-4E   (hex)		VOELKER TECHNOLOGIES, INC.
+00A04E     (base 16)		VOELKER TECHNOLOGIES, INC.
+				22 NEW BOSTON COURT
+				DANVILLE  CA  94526
+				US
+
+00-A0-5A   (hex)		KOFAX IMAGE PRODUCTS
+00A05A     (base 16)		KOFAX IMAGE PRODUCTS
+				3 JENNER STREET
+				IRVINE  CA  92718-3807
+				US
+
+00-A0-52   (hex)		STANILITE ELECTRONICS PTY. LTD
+00A052     (base 16)		STANILITE ELECTRONICS PTY. LTD
+				424, LANE COVE ROAD
+				NORTH RYDE NSW 2113    
+				AU
+
+00-A0-5E   (hex)		MYRIAD LOGIC INC.
+00A05E     (base 16)		MYRIAD LOGIC INC.
+				1109 SPRING STREET
+				SILVER SPRING  MD  20910
+				US
+
+00-A0-95   (hex)		ACACIA NETWORKS, INC.
+00A095     (base 16)		ACACIA NETWORKS, INC.
+				831 WOBURN STREET
+				WILMINGTON  MA  01887
+				US
+
+00-A0-53   (hex)		COMPACT DEVICES, INC.
+00A053     (base 16)		COMPACT DEVICES, INC.
+				16795 LARK AVENUE
+				LOS GATOS  CA  95030
+				US
+
+00-A0-69   (hex)		Symmetricom, Inc.
+00A069     (base 16)		Symmetricom, Inc.
+				3750 Westwind Blvd.
+				Santa Rosa  CA  95403
+				US
+
+00-A0-7A   (hex)		ADVANCED PERIPHERALS TECHNOLOGIES, INC.
+00A07A     (base 16)		ADVANCED PERIPHERALS TECHNOLOGIES, INC.
+				
+				FUJISAWA-SHI, KANAGAWA-KEN 251    
+				JP
+
+00-60-9B   (hex)		AstroNova, Inc
+00609B     (base 16)		AstroNova, Inc
+				600 EAST GREENWICH AVE.
+				WEST WARWICK  RI  02893
+				US
+
+00-60-DB   (hex)		NTP ELEKTRONIK A/S
+0060DB     (base 16)		NTP ELEKTRONIK A/S
+				KNAPHOLM 7
+				DK-2730 HERLEV    
+				DK
+
+00-60-52   (hex)		PERIPHERALS ENTERPRISE CO., Ltd.
+006052     (base 16)		PERIPHERALS ENTERPRISE CO., Ltd.
+				3F, NO.10, ALLEY 6, LANE 45
+				TAIPEI    
+				TW
+
+00-60-B2   (hex)		PROCESS CONTROL CORP.
+0060B2     (base 16)		PROCESS CONTROL CORP.
+				6875 MIMMS DRIVE
+				ATLANTA  GA  30340
+				US
+
+00-60-81   (hex)		TV/COM INTERNATIONAL
+006081     (base 16)		TV/COM INTERNATIONAL
+				16516 VIA ESPRILLO
+				SAN DIEGO  CA  92127
+				US
+
+00-A0-05   (hex)		DANIEL INSTRUMENTS, LTD.
+00A005     (base 16)		DANIEL INSTRUMENTS, LTD.
+				TROLLSTRASSE 33
+				CH-8400 WINTERTHUR    
+				CH
+
+00-A0-F2   (hex)		INFOTEK COMMUNICATIONS, INC.
+00A0F2     (base 16)		INFOTEK COMMUNICATIONS, INC.
+				111 ANZA BLVD., #203
+				BURLINGAME  CA  94010
+				US
+
+00-A0-DF   (hex)		STS TECHNOLOGIES, INC.
+00A0DF     (base 16)		STS TECHNOLOGIES, INC.
+				13765 ST. CHARLES ROCK RD.
+				BRIDGETON  MO  63044
+				US
+
+00-A0-94   (hex)		COMSAT CORPORATION
+00A094     (base 16)		COMSAT CORPORATION
+				22300 COMSAT DRIVE
+				CLARKSBURG  MD  20871-9475
+				US
+
+00-A0-EF   (hex)		LUCIDATA LTD.
+00A0EF     (base 16)		LUCIDATA LTD.
+				LUCIDATA HOUSE
+				GREAT SHELFORD  CAMBBRIDGE CB2 5HA  
+				GB
+
+00-A0-20   (hex)		CITICORP/TTI
+00A020     (base 16)		CITICORP/TTI
+				3100 OCEAN PARK BLVD.
+				SANTA MONICA  CA  90405
+				US
+
+00-A0-CE   (hex)		Ecessa
+00A0CE     (base 16)		Ecessa
+				2800 Campus Drive 
+				Plymouth  MN  55441
+				US
+
+00-A0-28   (hex)		CONNER PERIPHERALS
+00A028     (base 16)		CONNER PERIPHERALS
+				3061 ZANKER ROAD
+				SAN JOSE  CA  95134-2128
+				US
+
+00-A0-9E   (hex)		ICTV
+00A09E     (base 16)		ICTV
+				14600 WINCHESTER BLVD.
+				LOS GATOS  CA  95030
+				US
+
+00-A0-99   (hex)		K-NET LTD.
+00A099     (base 16)		K-NET LTD.
+				SADDLERS HOUSE
+				YATELEY, SURREY GU17 7RX    
+				GB
+
+00-A0-EC   (hex)		TRANSMITTON LTD.
+00A0EC     (base 16)		TRANSMITTON LTD.
+				SMISBY ROAD
+				LEICESTERSHIRE LE65 2UG    
+				GB
+
+00-A0-67   (hex)		NETWORK SERVICES GROUP
+00A067     (base 16)		NETWORK SERVICES GROUP
+				3421 COMMISSION COURT-STE #202
+				WOODBRIDGE  VA  22192
+				US
+
+00-A0-E0   (hex)		TENNYSON TECHNOLOGIES PTY LTD
+00A0E0     (base 16)		TENNYSON TECHNOLOGIES PTY LTD
+				14 BUSINESS PARK DRIVE
+				VICTORIA - 3168    
+				AU
+
+00-A0-FD   (hex)		SCITEX DIGITAL PRINTING, INC.
+00A0FD     (base 16)		SCITEX DIGITAL PRINTING, INC.
+				3100 RESEARCH BLVD.
+				DAYTON  OH  45420
+				US
+
+00-A0-0F   (hex)		Broadband Technologies
+00A00F     (base 16)		Broadband Technologies
+				P.O. Box 13737
+				Research Triangle Park,  NC  27709-3737
+				US
+
+00-A0-02   (hex)		LEEDS & NORTHRUP AUSTRALIA PTY LTD
+00A002     (base 16)		LEEDS & NORTHRUP AUSTRALIA PTY LTD
+				PO BOX 4009
+				EIGHT MILE PLAINS  QLD 4113    
+				AU
+
+00-A0-E4   (hex)		OPTIQUEST
+00A0E4     (base 16)		OPTIQUEST
+				20490 BUSINESS PARKWAY
+				WALNUT  CA  91789
+				US
+
+00-A0-EE   (hex)		NASHOBA NETWORKS
+00A0EE     (base 16)		NASHOBA NETWORKS
+				9-11 GOLDSMITH ST.
+				LITTLETON  MA  01460
+				US
+
+00-A0-C3   (hex)		UNICOMPUTER GMBH
+00A0C3     (base 16)		UNICOMPUTER GMBH
+				LIMBURGER STRASSE 48
+				    
+				DE
+
+00-A0-0A   (hex)		Airspan
+00A00A     (base 16)		Airspan
+				Unitronics Building, Arava Street, Airport City
+				    70100
+				IL
+
+00-A0-E7   (hex)		CENTRAL DATA CORPORATION
+00A0E7     (base 16)		CENTRAL DATA CORPORATION
+				1602 NEWTON DRIVE
+				CHAMPAIGN  IL  61821
+				US
+
+00-A0-80   (hex)		Tattile SRL 
+00A080     (base 16)		Tattile SRL 
+				4000 Executive Parkway
+				San Ramon  CA  94583
+				US
+
+00-A0-2B   (hex)		TRANSITIONS RESEARCH CORP.
+00A02B     (base 16)		TRANSITIONS RESEARCH CORP.
+				SHELTER ROCK LANE
+				DANBURY  CT  06810
+				US
+
+00-A0-E8   (hex)		REUTERS HOLDINGS PLC
+00A0E8     (base 16)		REUTERS HOLDINGS PLC
+				85, FLEET STREET
+				    ENGLAND
+				GB
+
+00-A0-08   (hex)		NETCORP
+00A008     (base 16)		NETCORP
+				8 PLACE OF COMMERCE--STE #200
+				CANADA  J4W  3H2
+				CA
+
+00-A0-50   (hex)		CYPRESS SEMICONDUCTOR
+00A050     (base 16)		CYPRESS SEMICONDUCTOR
+				198 Champion Ct
+				SAN JOSE  CA  95134
+				US
+
+00-A0-DD   (hex)		AZONIX CORPORATION
+00A0DD     (base 16)		AZONIX CORPORATION
+				900 MIDDLESEX TURNPIKE
+				BILLERICA  MA  01821
+				US
+
+00-A0-75   (hex)		MICRON TECHNOLOGY, INC.
+00A075     (base 16)		MICRON TECHNOLOGY, INC.
+				8000 S. Federal Way
+				Boise  ID  83707-0006
+				US
+
+00-A0-09   (hex)		WHITETREE NETWORK
+00A009     (base 16)		WHITETREE NETWORK
+				TECHNOLOGIES, INC.
+				PALO ALTO  CA  94306
+				US
+
+00-A0-0C   (hex)		KINGMAX TECHNOLOGY, INC.
+00A00C     (base 16)		KINGMAX TECHNOLOGY, INC.
+				2FL., NO. 4, LANE 902, SEC.2
+				    
+				TW
+
+00-A0-66   (hex)		ISA CO., LTD.
+00A066     (base 16)		ISA CO., LTD.
+				SHINJUKU LAMBDAX BLDG. 5F.,
+				    
+				JP
+
+00-A0-AB   (hex)		NETCS INFORMATIONSTECHNIK GMBH
+00A0AB     (base 16)		NETCS INFORMATIONSTECHNIK GMBH
+				KATHARINENSTRASSE 17-18
+				    
+				DE
+
+00-A0-D8   (hex)		SPECTRA - TEK
+00A0D8     (base 16)		SPECTRA - TEK
+				OUTGANG LANE
+				ENGLAND  Y018  FJA
+				GB
+
+00-A0-FA   (hex)		Marconi Communication GmbH
+00A0FA     (base 16)		Marconi Communication GmbH
+				Gerberstrasse 33
+				    
+				DE
+
+00-A0-CB   (hex)		ARK TELECOMMUNICATIONS, INC.
+00A0CB     (base 16)		ARK TELECOMMUNICATIONS, INC.
+				124 CARMEN LANE--SUITE
+				SANTA MARIA  CA  93454
+				US
+
+00-A0-34   (hex)		AXEL
+00A034     (base 16)		AXEL
+				16, AVENUE DU QUEBEC
+				    
+				FR
+
+00-A0-01   (hex)		DRS Signal Solutions
+00A001     (base 16)		DRS Signal Solutions
+				700 Quince Orchard Road
+				Gaithersburg  MD  20878-1794
+				US
+
+00-20-B2   (hex)		GKD Gesellschaft Fur Kommunikation Und Datentechnik
+0020B2     (base 16)		GKD Gesellschaft Fur Kommunikation Und Datentechnik
+				SAARBURGER RING 10-12
+				 68229 MANNHEIM    
+				DE
+
+00-20-52   (hex)		RAGULA SYSTEMS
+002052     (base 16)		RAGULA SYSTEMS
+				4540 S. JUPITER DRIVE
+				SALT LAKE CITY  UT  84124
+				US
+
+00-20-FC   (hex)		MATROX
+0020FC     (base 16)		MATROX
+				1055 ST. REGIS,
+				DORVAL, QUEBEC  H9P-2T4    
+				CA
+
+00-20-FE   (hex)		TOPWARE INC. / GRAND COMPUTER
+0020FE     (base 16)		TOPWARE INC. / GRAND COMPUTER
+				CORPORATION
+				TAIPEI    R.O.C.
+				TW
+
+00-20-73   (hex)		FUSION SYSTEMS CORPORATION
+002073     (base 16)		FUSION SYSTEMS CORPORATION
+				7600 STANDISH PLACE
+				ROCKVILLE  MD  20855
+				US
+
+00-20-35   (hex)		IBM Corp
+002035     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-A0-17   (hex)		J B M CORPORATION
+00A017     (base 16)		J B M CORPORATION
+				10-1, ARAMOTOSHIN MACHI
+				    577
+				JP
+
+00-A0-25   (hex)		REDCOM LABS INC.
+00A025     (base 16)		REDCOM LABS INC.
+				ONE REDCOM CENTER
+				VICTOR  NY  14564-0995
+				US
+
+00-A0-BB   (hex)		HILAN GMBH
+00A0BB     (base 16)		HILAN GMBH
+				HAID-UND-NEU-STRASSE 7
+				    
+				DE
+
+00-A0-91   (hex)		APPLICOM INTERNATIONAL
+00A091     (base 16)		APPLICOM INTERNATIONAL
+				43, RUE MAZAGRAN
+				    
+				FR
+
+00-A0-A5   (hex)		TEKNOR MICROSYSTEME, INC.
+00A0A5     (base 16)		TEKNOR MICROSYSTEME, INC.
+				616 CURE BOIVIN
+				    J7G 2A7
+				CA
+
+00-20-B7   (hex)		NAMAQUA COMPUTERWARE
+0020B7     (base 16)		NAMAQUA COMPUTERWARE
+				P.O. BOX 7155
+				    
+				ZA
+
+00-20-E3   (hex)		MCD KENCOM CORPORATION
+0020E3     (base 16)		MCD KENCOM CORPORATION
+				20950 CASTLE ROCK ROAD
+				LAGUNA BEACH  CA  92651-1115
+				US
+
+00-20-13   (hex)		DIVERSIFIED TECHNOLOGY, INC.
+002013     (base 16)		DIVERSIFIED TECHNOLOGY, INC.
+				112 E. STATE STREET
+				RIDGELAND  MS  39157
+				US
+
+00-20-AB   (hex)		MICRO INDUSTRIES CORP.
+0020AB     (base 16)		MICRO INDUSTRIES CORP.
+				8399 GREEN MEADOWS DR. N.
+				WESTERVILLE  OH  43081
+				US
+
+00-20-8D   (hex)		CMD TECHNOLOGY
+00208D     (base 16)		CMD TECHNOLOGY
+				1 VANDERBILT
+				IRVINE  CA  92718
+				US
+
+00-20-DD   (hex)		Cybertec Pty Ltd
+0020DD     (base 16)		Cybertec Pty Ltd
+				Unit 11, 41 Higginbotham Road
+				Gladesville  NSW  2111
+				AU
+
+00-20-E6   (hex)		LIDKOPING MACHINE TOOLS AB
+0020E6     (base 16)		LIDKOPING MACHINE TOOLS AB
+				BOX 910
+				    
+				SE
+
+00-A0-A2   (hex)		DIGICOM S.P.A.
+00A0A2     (base 16)		DIGICOM S.P.A.
+				VIA VOLTA 39
+				    
+				IT
+
+00-20-86   (hex)		MICROTECH ELECTRONICS LIMITED
+002086     (base 16)		MICROTECH ELECTRONICS LIMITED
+				LANCASTER ROAD
+				    KINGDOM
+				GB
+
+00-20-23   (hex)		T.C. TECHNOLOGIES PTY. LTD
+002023     (base 16)		T.C. TECHNOLOGIES PTY. LTD
+				6/60 FAIRFORD RD.
+				    
+				AU
+
+00-A0-54   (hex)		Private
+00A054     (base 16)		Private
+
+00-20-5A   (hex)		COMPUTER IDENTICS
+00205A     (base 16)		COMPUTER IDENTICS
+				5 SHAWMUT ROAD
+				CANTON  MA  02021
+				US
+
+00-20-00   (hex)		LEXMARK INTERNATIONAL, INC.
+002000     (base 16)		LEXMARK INTERNATIONAL, INC.
+				740 NEW CIRCLE ROAD
+				LEXINGTON  KY  40550
+				US
+
+00-20-1D   (hex)		KATANA PRODUCTS
+00201D     (base 16)		KATANA PRODUCTS
+				THE STUDIO, QUARRY HILL BOX,
+				WILTSHIRE SN14 9HT    
+				GB
+
+00-20-03   (hex)		PIXEL POWER LTD.
+002003     (base 16)		PIXEL POWER LTD.
+				Unit 5 College Business Park
+				CAMBRIDGE    CB1 3HD
+				GB
+
+00-20-46   (hex)		CIPRICO, INC.
+002046     (base 16)		CIPRICO, INC.
+				2800 CAMPUS DRIVE--SUITE #60
+				PLYMOUTH  MN  55441
+				US
+
+00-20-9B   (hex)		ERSAT ELECTRONIC GMBH
+00209B     (base 16)		ERSAT ELECTRONIC GMBH
+				HAARBERGSTR. 61
+				    
+				DE
+
+00-20-1C   (hex)		EXCEL, INC.
+00201C     (base 16)		EXCEL, INC.
+				355 OLD PLYMOUTH ROAD
+				SAGAMORE BEACH  MA  02562
+				US
+
+00-20-7F   (hex)		KYOEI SANGYO CO., LTD.
+00207F     (base 16)		KYOEI SANGYO CO., LTD.
+				DIR. & GEN'L MGR.IND. SYSTEMS
+				    TOKYO
+				JP
+
+00-20-C9   (hex)		VICTRON BV
+0020C9     (base 16)		VICTRON BV
+				POB 31
+				  THE  
+				NL
+
+00-20-77   (hex)		KARDIOS SYSTEMS CORP.
+002077     (base 16)		KARDIOS SYSTEMS CORP.
+				26 N SUMMIT AVE.
+				GAITHERSBURG  MD  20877
+				US
+
+00-20-7A   (hex)		WiSE Communications, Inc.
+00207A     (base 16)		WiSE Communications, Inc.
+				130 KNOWLES DRIVE
+				LOS GATOS  CA  95030
+				US
+
+00-20-3E   (hex)		LogiCan Technologies, Inc.
+00203E     (base 16)		LogiCan Technologies, Inc.
+				150 KARL CLARK ROAD
+				EDMONTON, ALBERTA T6N 1E2    
+				CA
+
+00-20-58   (hex)		ALLIED SIGNAL INC.
+002058     (base 16)		ALLIED SIGNAL INC.
+				ROUTE 46
+				TETERBORO  NJ  07608
+				US
+
+00-20-E1   (hex)		ALAMAR ELECTRONICS
+0020E1     (base 16)		ALAMAR ELECTRONICS
+				489 DIVISION STREET
+				CAMPBELL  CA  95008
+				US
+
+00-20-26   (hex)		AMKLY SYSTEMS, INC.
+002026     (base 16)		AMKLY SYSTEMS, INC.
+				15801 ROCKFIELD BLVD., #P
+				IRVINE  CA  92718
+				US
+
+00-20-65   (hex)		SUPERNET NETWORKING INC.
+002065     (base 16)		SUPERNET NETWORKING INC.
+				16 TOZERET HA'ARETZ ST.
+				TEL-AVIV 67891    
+				IL
+
+00-20-2A   (hex)		N.V. DZINE
+00202A     (base 16)		N.V. DZINE
+				KONING LEOPOLD III LAAN 2
+				    
+				BE
+
+00-20-83   (hex)		PRESTICOM INCORPORATED
+002083     (base 16)		PRESTICOM INCORPORATED
+				3275, 1ST STREET, STE. #1
+				CANADA  J3Y  8Y6
+				CA
+
+00-20-19   (hex)		OHLER GMBH
+002019     (base 16)		OHLER GMBH
+				MAYBACHSTRASE 30
+				71332 WAIBLINGEN    
+				DE
+
+00-20-9E   (hex)		BROWN'S OPERATING SYSTEM SERVICES, LTD.
+00209E     (base 16)		BROWN'S OPERATING SYSTEM SERVICES, LTD.
+				ST. AGNES HOUSE, CRESSWELL PK,
+				BLACKHEATH, London SE3 9RD    
+				GB
+
+00-20-8E   (hex)		CHEVIN SOFTWARE ENG. LTD.
+00208E     (base 16)		CHEVIN SOFTWARE ENG. LTD.
+				2 BOROUGHGATE, OTLEY,
+				LS21 3AL  UNITED  KINGDOM
+				GB
+
+00-20-97   (hex)		APPLIED SIGNAL TECHNOLOGY
+002097     (base 16)		APPLIED SIGNAL TECHNOLOGY
+				160 SOBRANTE WAY
+				SUNNYVALE  CA  94086
+				US
+
+00-C0-0B   (hex)		NORCONTROL A.S.
+00C00B     (base 16)		NORCONTROL A.S.
+				P.O. BOX 1024
+				    
+				NO
+
+00-20-B0   (hex)		GATEWAY DEVICES, INC.
+0020B0     (base 16)		GATEWAY DEVICES, INC.
+				2440 STANWELL DRIVE
+				CONCORD  CA  94520
+				US
+
+00-20-5B   (hex)		Kentrox, LLC
+00205B     (base 16)		Kentrox, LLC
+				20010 NW Tanasbourne Dr.
+				Hillsboro  OR  97124
+				US
+
+00-20-F6   (hex)		NET TEK  AND KARLNET, INC.
+0020F6     (base 16)		NET TEK  AND KARLNET, INC.
+				LITTLE STREAMS
+				  UNITED  KINGDOM
+				GB
+
+00-20-C6   (hex)		NECTEC
+0020C6     (base 16)		NECTEC
+				RAMA VI ROAD
+				    
+				TH
+
+00-20-08   (hex)		CABLE & COMPUTER TECHNOLOGY
+002008     (base 16)		CABLE & COMPUTER TECHNOLOGY
+				1555 SO. SINCLAIR STREET
+				ANAHEIM  CA  92806
+				US
+
+00-20-D3   (hex)		OST (OUEST STANDARD TELEMATIQU
+0020D3     (base 16)		OST (OUEST STANDARD TELEMATIQU
+				RUE DU BAS VILLAGE
+				    
+				FR
+
+00-C0-0E   (hex)		PSITECH, INC.
+00C00E     (base 16)		PSITECH, INC.
+				18368 BANDILIER CIRCLE
+				FOUNTAIN VALLEY  CA  92708
+				US
+
+00-C0-31   (hex)		DESIGN RESEARCH SYSTEMS, INC.
+00C031     (base 16)		DESIGN RESEARCH SYSTEMS, INC.
+				925 E. EXECUTIVE PARK DR.
+				SALT LAKE CITY  UT  84117
+				US
+
+00-07-01   (hex)		RACAL-DATACOM
+000701     (base 16)		RACAL-DATACOM
+				LAN INTERNETWORKING DIVISION
+				BOXBOROUGH  MA  01719
+				US
+
+00-C0-9C   (hex)		HIOKI E.E. CORPORATION
+00C09C     (base 16)		HIOKI E.E. CORPORATION
+				81 Koizumi, Ueda, Nagano
+				Tokyo    386-1192
+				JP
+
+00-C0-AA   (hex)		SILICON VALLEY COMPUTER
+00C0AA     (base 16)		SILICON VALLEY COMPUTER
+				441 N. WHISMAN RD., BLDG.#13
+				MT. VIEW  CA  94043
+				US
+
+00-C0-66   (hex)		DOCUPOINT, INC.
+00C066     (base 16)		DOCUPOINT, INC.
+				2701 BAYVIEW DRIVE
+				FREMONT  CA  94538
+				US
+
+00-C0-2D   (hex)		FUJI PHOTO FILM CO., LTD.
+00C02D     (base 16)		FUJI PHOTO FILM CO., LTD.
+				798 MIYANODAI KAISEI-MACHI
+				    
+				JP
+
+00-C0-F2   (hex)		TRANSITION NETWORKS
+00C0F2     (base 16)		TRANSITION NETWORKS
+				10900 Red Circle Dr.
+				MInnetonka  MN  55343
+				US
+
+00-C0-BD   (hex)		INEX TECHNOLOGIES, INC.
+00C0BD     (base 16)		INEX TECHNOLOGIES, INC.
+				3350 SCOTT BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+00-C0-88   (hex)		EKF ELEKTRONIK GMBH
+00C088     (base 16)		EKF ELEKTRONIK GMBH
+				PHILIPP-REIS-STR. 4
+				    
+				DE
+
+00-C0-11   (hex)		INTERACTIVE COMPUTING DEVICES
+00C011     (base 16)		INTERACTIVE COMPUTING DEVICES
+				1735 TECHNOLOGY DRIVE-STE #720
+				SAN JOSE  CA  95110
+				US
+
+00-C0-3E   (hex)		FA. GEBR. HELLER GMBH
+00C03E     (base 16)		FA. GEBR. HELLER GMBH
+				P.O. BOX 1428, DEP. EE7
+				    
+				DE
+
+00-C0-FD   (hex)		PROSUM
+00C0FD     (base 16)		PROSUM
+				12 RUE SADI-CARNOT
+				    
+				FR
+
+00-C0-14   (hex)		TELEMATICS CALABASAS INT'L,INC
+00C014     (base 16)		TELEMATICS CALABASAS INT'L,INC
+				26630 AGOURA ROAD
+				CALABASAS  CA  91302-1988
+				US
+
+00-AA-3C   (hex)		OLIVETTI TELECOM SPA (OLTECO)
+00AA3C     (base 16)		OLIVETTI TELECOM SPA (OLTECO)
+				10062 MILLER AVE.-STE.#204
+				CUPERTINO  CA  95014
+				US
+
+00-C0-C9   (hex)		ELSAG BAILEY PROCESS
+00C0C9     (base 16)		ELSAG BAILEY PROCESS
+				AUTOMATION
+				WICKLIFFE  OH  44092
+				US
+
+00-C0-48   (hex)		BAY TECHNICAL ASSOCIATES
+00C048     (base 16)		BAY TECHNICAL ASSOCIATES
+				200 N. SECOND STREET
+				BAY ST. LOUIS  MS  39520
+				US
+
+00-C0-76   (hex)		I-DATA INTERNATIONAL A-S
+00C076     (base 16)		I-DATA INTERNATIONAL A-S
+				35-43 VADSTRUPVEJ
+				    
+				DK
+
+00-C0-46   (hex)		Blue Chip Technology Ltd
+00C046     (base 16)		Blue Chip Technology Ltd
+				Chowley Oak Lane
+				Chester  Cheshire  CH3 9EX
+				GB
+
+00-C0-97   (hex)		ARCHIPEL SA
+00C097     (base 16)		ARCHIPEL SA
+				1 RUE DU BULLOZ
+				    
+				FR
+
+00-C0-04   (hex)		JAPAN BUSINESS COMPUTER CO.LTD
+00C004     (base 16)		JAPAN BUSINESS COMPUTER CO.LTD
+				1368 FUTOO-CHO, KOHOKU-KU
+				  222  
+				JP
+
+00-C0-60   (hex)		ID SCANDINAVIA AS
+00C060     (base 16)		ID SCANDINAVIA AS
+				P.O. BOX 4227
+				    
+				NO
+
+00-40-CC   (hex)		SILCOM MANUF'G TECHNOLOGY INC.
+0040CC     (base 16)		SILCOM MANUF'G TECHNOLOGY INC.
+				5620 TIMBERLEA BOULEVARD
+				CANADA  L4W  4M6
+				CA
+
+00-C0-9E   (hex)		CACHE COMPUTERS, INC.
+00C09E     (base 16)		CACHE COMPUTERS, INC.
+				46600 LANDING PARKWAY
+				FREMONT  CA  94538
+				US
+
+00-C0-AC   (hex)		GAMBIT COMPUTER COMMUNICATIONS
+00C0AC     (base 16)		GAMBIT COMPUTER COMMUNICATIONS
+				SOLTAM INDUSTRIAL PARK
+				    
+				IL
+
+00-C0-34   (hex)		TRANSACTION NETWORK
+00C034     (base 16)		TRANSACTION NETWORK
+				SERVICES, INC.
+				LANSING  MI  48910-8356
+				US
+
+00-C0-93   (hex)		ALTA RESEARCH CORP.
+00C093     (base 16)		ALTA RESEARCH CORP.
+				614 SOUTH FEDERAL HIGHWAY
+				DEERFIELD BEACH  FL  33441
+				US
+
+00-40-E7   (hex)		ARNOS INSTRUMENTS & COMPUTER
+0040E7     (base 16)		ARNOS INSTRUMENTS & COMPUTER
+				SYSTEMS (GROUP) CO., LTD.
+				TSUEN WAN  N.T.  
+				HK
+
+00-40-87   (hex)		UBITREX CORPORATION
+004087     (base 16)		UBITREX CORPORATION
+				19TH FLOOR, 155 CARLTON STREET
+				CANADA  R3C  3H8
+				CA
+
+00-40-07   (hex)		TELMAT INFORMATIQUE
+004007     (base 16)		TELMAT INFORMATIQUE
+				6 RUE DE L'INDUSTRIE
+				    
+				FR
+
+00-40-7B   (hex)		SCIENTIFIC ATLANTA
+00407B     (base 16)		SCIENTIFIC ATLANTA
+				Information Technology
+				Norcross  GA  30091-6850
+				US
+
+00-40-2C   (hex)		ISIS DISTRIBUTED SYSTEMS, INC.
+00402C     (base 16)		ISIS DISTRIBUTED SYSTEMS, INC.
+				111 SOUTH CAYUGA STREET
+				ITHACA  NY  14850
+				US
+
+00-C0-DF   (hex)		KYE Systems Corp.
+00C0DF     (base 16)		KYE Systems Corp.
+				No. 492 Sec 5, Chung Hsin Road
+				Taipei  Hsien  241
+				TW
+
+00-C0-F5   (hex)		METACOMP, INC.
+00C0F5     (base 16)		METACOMP, INC.
+				10989 VIA FRONTERA
+				SAN DIEGO  CA  92127
+				US
+
+00-C0-91   (hex)		JABIL CIRCUIT, INC.
+00C091     (base 16)		JABIL CIRCUIT, INC.
+				32275 MALLY ROAD
+				MADISON HEIGHTS  MI  48071
+				US
+
+00-C0-49   (hex)		U.S. ROBOTICS, INC.
+00C049     (base 16)		U.S. ROBOTICS, INC.
+				8100 NORTH MCCORMICK BLVD.
+				SKOKIE  IL  60076-2999
+				US
+
+00-C0-9D   (hex)		DISTRIBUTED SYSTEMS INT'L, INC
+00C09D     (base 16)		DISTRIBUTED SYSTEMS INT'L, INC
+				531 WEST ROOSEVLET RD, STE #2
+				WHEATON  IL  60187
+				US
+
+00-C0-E9   (hex)		OAK SOLUTIONS, LTD.
+00C0E9     (base 16)		OAK SOLUTIONS, LTD.
+				BROADWAY HOUSE
+				    ENGLAND
+				GB
+
+00-C0-C5   (hex)		SID INFORMATICA
+00C0C5     (base 16)		SID INFORMATICA
+				RUA DR. GERALDO CAMPOS MOREIRA
+				    
+				BR
+
+00-C0-51   (hex)		ADVANCED INTEGRATION RESEARCH
+00C051     (base 16)		ADVANCED INTEGRATION RESEARCH
+				2188 DEL FRANCO STREET
+				SAN JOSE  CA  95131
+				US
+
+00-C0-85   (hex)		ELECTRONICS FOR IMAGING, INC.
+00C085     (base 16)		ELECTRONICS FOR IMAGING, INC.
+				2855 CAMPUS DRIVE
+				SAN MATEO  CA  94403
+				US
+
+00-C0-B2   (hex)		NORAND CORPORATION
+00C0B2     (base 16)		NORAND CORPORATION
+				550 2ND STREET SE
+				CEDAR RAPIDS  IA  52401
+				US
+
+00-C0-54   (hex)		NETWORK PERIPHERALS, LTD.
+00C054     (base 16)		NETWORK PERIPHERALS, LTD.
+				4TH FLOOR, 17 BOWATER RD.
+				    ENGLAND
+				GB
+
+00-C0-22   (hex)		LASERMASTER TECHNOLOGIES, INC.
+00C022     (base 16)		LASERMASTER TECHNOLOGIES, INC.
+				7156 SHADY OAK ROAD
+				EDEN PRAIRIE  MN  55344
+				US
+
+00-C0-25   (hex)		DATAPRODUCTS CORPORATION
+00C025     (base 16)		DATAPRODUCTS CORPORATION
+				6219 DESOTO AVENUE
+				WOODLAND HILLS  CA  91365-0746
+				US
+
+00-40-CF   (hex)		STRAWBERRY TREE, INC.
+0040CF     (base 16)		STRAWBERRY TREE, INC.
+				160 SOUTH WOLFE ROAD
+				SUNNYVALE  CA  94086
+				US
+
+00-40-77   (hex)		MAXTON TECHNOLOGY CORPORATION
+004077     (base 16)		MAXTON TECHNOLOGY CORPORATION
+				4FK, 249, SEC. 3,
+				    TAIWAN
+				TW
+
+00-C0-2C   (hex)		CENTRUM COMMUNICATIONS, INC.
+00C02C     (base 16)		CENTRUM COMMUNICATIONS, INC.
+				2880 ZANKER ROAD-STE #108
+				SAN JOSE  CA  95134
+				US
+
+00-C0-FB   (hex)		ADVANCED TECHNOLOGY LABS
+00C0FB     (base 16)		ADVANCED TECHNOLOGY LABS
+				22100 BOTHELL HIGHWAY S.E.
+				BOTHELL  WA  98041-3003
+				US
+
+00-C0-2B   (hex)		GERLOFF GESELLSCHAFT FUR
+00C02B     (base 16)		GERLOFF GESELLSCHAFT FUR
+				ELEKRONISCHE SYSTEMENTWICKLUNG
+				    
+				DE
+
+00-40-74   (hex)		CABLE AND WIRELESS
+004074     (base 16)		CABLE AND WIRELESS
+				COMMUNICATIONS, INC.
+				VIENNA  VA  22182-3964
+				US
+
+00-40-B8   (hex)		IDEA ASSOCIATES
+0040B8     (base 16)		IDEA ASSOCIATES
+				29 DUNHAM ROAD
+				BILLERICA  MA  01821
+				US
+
+00-40-E8   (hex)		CHARLES RIVER DATA SYSTEMS,INC
+0040E8     (base 16)		CHARLES RIVER DATA SYSTEMS,INC
+				983 CONCORD STREET
+				FRAMINGHAM  MA  01701
+				US
+
+00-40-C0   (hex)		VISTA CONTROLS CORPORATION
+0040C0     (base 16)		VISTA CONTROLS CORPORATION
+				27825 FREMONT COURT
+				VALENCIA  CA  91355
+				US
+
+00-C0-A0   (hex)		ADVANCE MICRO RESEARCH, INC.
+00C0A0     (base 16)		ADVANCE MICRO RESEARCH, INC.
+				2045 CORPORATE COURT
+				SAN JOSE  CA  95131
+				US
+
+00-C0-10   (hex)		HIRAKAWA HEWTECH CORP.
+00C010     (base 16)		HIRAKAWA HEWTECH CORP.
+				7F, BLDG.B, OMORI BELLPORT
+				    
+				JP
+
+00-C0-37   (hex)		DYNATEM
+00C037     (base 16)		DYNATEM
+				15795 ROCKFIELD BLVD.
+				IRVINE  CA  92718
+				US
+
+00-40-83   (hex)		TDA INDUSTRIA DE PRODUTOS
+004083     (base 16)		TDA INDUSTRIA DE PRODUTOS
+				ELETRONICOS S.A.
+				    
+				BR
+
+00-40-5B   (hex)		FUNASSET LIMITED
+00405B     (base 16)		FUNASSET LIMITED
+				ORCHARDS, 14 TOWNSEND
+				  UNITED  KINGDOM
+				GB
+
+00-40-73   (hex)		BASS ASSOCIATES
+004073     (base 16)		BASS ASSOCIATES
+				435 TASSO STREET, STE. #325
+				PALO ALTO  CA  94301
+				US
+
+00-40-7D   (hex)		EXTENSION TECHNOLOGY CORP.
+00407D     (base 16)		EXTENSION TECHNOLOGY CORP.
+				30 HOLLIS STREET
+				FRAMINGHAM  MA  01701
+				US
+
+00-80-D7   (hex)		Fantum Engineering
+0080D7     (base 16)		Fantum Engineering
+				
+				Rockwall  TX  75087
+				US
+
+00-80-7A   (hex)		AITECH SYSTEMS LTD.
+00807A     (base 16)		AITECH SYSTEMS LTD.
+				3080 OLCOTT STREET
+				SANTA CLARA  CA  95054
+				US
+
+00-80-DC   (hex)		PICKER INTERNATIONAL
+0080DC     (base 16)		PICKER INTERNATIONAL
+				595 MINER ROAD
+				CLEVELAND  OH  44143
+				US
+
+00-40-4D   (hex)		TELECOMMUNICATIONS TECHNIQUES
+00404D     (base 16)		TELECOMMUNICATIONS TECHNIQUES
+				M/S
+				GERMANTOWN  MD  20876
+				US
+
+00-40-0D   (hex)		LANNET DATA COMMUNICATIONS,LTD
+00400D     (base 16)		LANNET DATA COMMUNICATIONS,LTD
+				ATIDIM TECHNOLOG'L PARK, BG.#3
+				    
+				IL
+
+00-40-19   (hex)		AEON SYSTEMS, INC.
+004019     (base 16)		AEON SYSTEMS, INC.
+				8401 WASHINGTON PLACE NE
+				ALBUQUERQUE  NM  87113
+				US
+
+00-40-BE   (hex)		BOEING DEFENSE & SPACE
+0040BE     (base 16)		BOEING DEFENSE & SPACE
+				P.O. BOX 3999
+				SEATTLE  WA  98124-2499
+				US
+
+00-40-6E   (hex)		COROLLARY, INC.
+00406E     (base 16)		COROLLARY, INC.
+				2802 KELVIN
+				IRVINE  CA  92714
+				US
+
+00-40-76   (hex)		Sun Conversion Technologies
+004076     (base 16)		Sun Conversion Technologies
+				100 Commerce Boulevard
+				Quakertown  PA  78951-2237
+				US
+
+00-40-22   (hex)		KLEVER COMPUTERS, INC.
+004022     (base 16)		KLEVER COMPUTERS, INC.
+				1028 W. MAUDE AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-40-BF   (hex)		CHANNEL SYSTEMS INTERN'L INC.
+0040BF     (base 16)		CHANNEL SYSTEMS INTERN'L INC.
+				93 SO. LA PATERA LANE
+				SANTA BARBARA  CA  93117
+				US
+
+00-40-1E   (hex)		ICC
+00401E     (base 16)		ICC
+				8230 MONTGOMERY ROAD
+				CINCINNATI  OH  45236
+				US
+
+00-40-9A   (hex)		NETWORK EXPRESS, INC.
+00409A     (base 16)		NETWORK EXPRESS, INC.
+				2200 GREEN ROAD - STE
+				ANN ARBOR  MI  48170
+				US
+
+00-40-94   (hex)		SHOGRAPHICS, INC.
+004094     (base 16)		SHOGRAPHICS, INC.
+				1890 N. SHORELINE BLVD.
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-40-55   (hex)		METRONIX GMBH
+004055     (base 16)		METRONIX GMBH
+				NEUE KNOCHENHAUERSTRAßE 5
+				  WEST  
+				DE
+
+00-40-27   (hex)		SMC MASSACHUSETTS, INC.
+004027     (base 16)		SMC MASSACHUSETTS, INC.
+				25 WALKERS BROOK DRIVE
+				READING  MA  01867
+				US
+
+00-40-8B   (hex)		RAYLAN CORPORATION
+00408B     (base 16)		RAYLAN CORPORATION
+				120 INDEPENDENCE DRIVE
+				MENLO PARK  CA  94025
+				US
+
+00-40-EF   (hex)		HYPERCOM, INC.
+0040EF     (base 16)		HYPERCOM, INC.
+				2851 WEST KATHLEEN ROAD
+				PHOENIX  AZ  85023
+				US
+
+00-40-93   (hex)		PAXDATA NETWORKS LTD.
+004093     (base 16)		PAXDATA NETWORKS LTD.
+				COMMUNICATIONS HOUSE,
+				    ENGLAND
+				GB
+
+00-40-85   (hex)		SAAB INSTRUMENTS AB
+004085     (base 16)		SAAB INSTRUMENTS AB
+				P.O. BOX 1017
+				    
+				SE
+
+00-40-23   (hex)		LOGIC CORPORATION
+004023     (base 16)		LOGIC CORPORATION
+				3-14-10 MEIJI-SEIMEI BUILDING
+				    
+				JP
+
+00-40-A4   (hex)		ROSE ELECTRONICS
+0040A4     (base 16)		ROSE ELECTRONICS
+				P.O. BOX 742571
+				HOUSTON  TX  77274-2571
+				US
+
+00-40-08   (hex)		A PLUS INFO CORPORATION
+004008     (base 16)		A PLUS INFO CORPORATION
+				5F, NO.2, LANE 235
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-40-B5   (hex)		VIDEO TECHNOLOGY COMPUTERS LTD
+0040B5     (base 16)		VIDEO TECHNOLOGY COMPUTERS LTD
+				33/F., BLOCK #1,
+				N.T.  HONG  KONG
+				HK
+
+00-40-12   (hex)		WINDATA, INC.
+004012     (base 16)		WINDATA, INC.
+				10 BEARFOOT ROAD
+				NORTHBORO  MA  01532
+				US
+
+00-40-D5   (hex)		Sartorius Mechatronics T&H GmbH 
+0040D5     (base 16)		Sartorius Mechatronics T&H GmbH 
+				WEENDER LANDSTR: 94 - 108
+				    
+				DE
+
+00-40-10   (hex)		SONIC SYSTEMS, INC.
+004010     (base 16)		SONIC SYSTEMS, INC.
+				575 PASTORIA NORTH AVENUE
+				SUNNYVALE  CA  940867
+				US
+
+00-40-CA   (hex)		FIRST INTERNAT'L COMPUTER, INC
+0040CA     (base 16)		FIRST INTERNAT'L COMPUTER, INC
+				FIC Building
+				Neihu  Taipei 114  Taipei 114
+				TW
+
+00-40-C4   (hex)		KINKEI SYSTEM CORPORATION
+0040C4     (base 16)		KINKEI SYSTEM CORPORATION
+				1-22-17, KAMIKITA, HIRANOKU
+				    
+				JP
+
+00-40-5D   (hex)		STAR-TEK, INC.
+00405D     (base 16)		STAR-TEK, INC.
+				71 LYMAN STREET
+				NORTHBORO  MA  01532
+				US
+
+00-40-E2   (hex)		MESA RIDGE TECHNOLOGIES, INC.
+0040E2     (base 16)		MESA RIDGE TECHNOLOGIES, INC.
+				6725 MESA RIDGE ROAD-STE#100
+				SAN DIEGO  CA  92121
+				US
+
+00-40-8C   (hex)		AXIS COMMUNICATIONS AB
+00408C     (base 16)		AXIS COMMUNICATIONS AB
+				SCHEELEVAGEN 16
+				    
+				SE
+
+00-40-45   (hex)		TWINHEAD CORPORATION
+004045     (base 16)		TWINHEAD CORPORATION
+				1537 CENTRE POINTE DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-40-28   (hex)		NETCOMM LIMITED
+004028     (base 16)		NETCOMM LIMITED
+				3 OLYMPIC BUSINESS CENTRE
+				  UNITED  KINGDOM
+				GB
+
+00-40-DD   (hex)		HONG TECHNOLOGIES
+0040DD     (base 16)		HONG TECHNOLOGIES
+				532 WEDDELL DRIVE
+				SUNNYVALE  CA  94089
+				US
+
+00-40-CB   (hex)		LANWAN TECHNOLOGIES
+0040CB     (base 16)		LANWAN TECHNOLOGIES
+				1566 LA PRADERA DRIVE
+				CAMPBELL  CA  95008
+				US
+
+00-40-B2   (hex)		SYSTEMFORSCHUNG
+0040B2     (base 16)		SYSTEMFORSCHUNG
+				KONIGSTRASSE 33A
+				    
+				DE
+
+00-40-E6   (hex)		C.A.E.N.
+0040E6     (base 16)		C.A.E.N.
+				2, CHEMIN LATERAL
+				    
+				FR
+
+00-40-F0   (hex)		MicroBrain,Inc.
+0040F0     (base 16)		MicroBrain,Inc.
+				Yuzan Bldg. 4F,
+				Aichi-gun AICHI    480-1117
+				JP
+
+00-40-89   (hex)		MEIDENSHA CORPORATION
+004089     (base 16)		MEIDENSHA CORPORATION
+				FACTORY NO.4, 515 KAMINAKAMIZO
+				    
+				JP
+
+00-40-15   (hex)		ASCOM INFRASYS AG
+004015     (base 16)		ASCOM INFRASYS AG
+				DPT. EASO 3726
+				    
+				CH
+
+00-80-95   (hex)		BASIC MERTON HANDELSGES.M.B.H.
+008095     (base 16)		BASIC MERTON HANDELSGES.M.B.H.
+				DURCHLASS-STRASSE 42
+				    
+				AT
+
+00-80-AE   (hex)		HUGHES NETWORK SYSTEMS
+0080AE     (base 16)		HUGHES NETWORK SYSTEMS
+				11717 EXPLORATION LANE
+				GERMANTOWN  MD  20876
+				US
+
+00-80-3A   (hex)		VARITYPER, INC.
+00803A     (base 16)		VARITYPER, INC.
+				900 MIDDLESEX TURNPIKE
+				BILLERICA  MA  01821
+				US
+
+00-80-1C   (hex)		NEWPORT SYSTEMS SOLUTIONS
+00801C     (base 16)		NEWPORT SYSTEMS SOLUTIONS
+				4019 WESTERLY AVENUE
+				NEWPORT BEACH  CA  92660
+				US
+
+00-80-56   (hex)		SPHINX Electronics GmbH & Co KG
+008056     (base 16)		SPHINX Electronics GmbH & Co KG
+				Tullastr. 3
+				    
+				DE
+
+00-80-31   (hex)		BASYS, CORP.
+008031     (base 16)		BASYS, CORP.
+				501 MACARA AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-80-DB   (hex)		GRAPHON CORPORATION
+0080DB     (base 16)		GRAPHON CORPORATION
+				1506 DELL AVE - #
+				CAMPBELL  CA  95008-6911
+				VE
+
+00-80-82   (hex)		PEP MODULAR COMPUTERS GMBH
+008082     (base 16)		PEP MODULAR COMPUTERS GMBH
+				APFELSTRANGER STR. 16
+				  WEST  
+				DE
+
+00-80-39   (hex)		ALCATEL STC AUSTRALIA
+008039     (base 16)		ALCATEL STC AUSTRALIA
+				252-280 BOTANY ROAD
+				    
+				AU
+
+00-80-23   (hex)		INTEGRATED BUSINESS NETWORKS
+008023     (base 16)		INTEGRATED BUSINESS NETWORKS
+				1BN THE SYSTEMS CENTRE
+				BUCKS HP19 3XN  -  ENGLAND
+				GB
+
+00-80-6B   (hex)		SCHMID TELECOMMUNICATION
+00806B     (base 16)		SCHMID TELECOMMUNICATION
+				BINZSTRASSE 35,
+				    
+				CH
+
+00-80-59   (hex)		STANLEY ELECTRIC CO., LTD
+008059     (base 16)		STANLEY ELECTRIC CO., LTD
+				R&D LABORATORY
+				    
+				JP
+
+00-80-41   (hex)		VEB KOMBINAT ROBOTRON
+008041     (base 16)		VEB KOMBINAT ROBOTRON
+				GRUNAER STRAßE 2, DRESDEN 8010
+				GDR  EAST  
+				DE
+
+00-80-80   (hex)		DATAMEDIA CORPORATION
+008080     (base 16)		DATAMEDIA CORPORATION
+				7401 CENTRAL HIGHWAY
+				PENNSAUKEN  NJ  08109
+				US
+
+00-80-3F   (hex)		TATUNG COMPANY
+00803F     (base 16)		TATUNG COMPANY
+				22 CHUNGSHANG N. RD. 3RD SEC.
+				TAIPEI  TAIWAN  R.O.C.
+				TW
+
+00-80-E6   (hex)		PEER NETWORKS, INC.
+0080E6     (base 16)		PEER NETWORKS, INC.
+				3350 SCOTT BLVD. BLDG. 14
+				SANTA CLARA  CA  95054
+				US
+
+00-80-E0   (hex)		XTP SYSTEMS, INC.
+0080E0     (base 16)		XTP SYSTEMS, INC.
+				1900 STATE STREET , STE
+				SANTA BARBARA  CA  93101
+				US
+
+00-80-88   (hex)		VICTOR COMPANY OF JAPAN, LTD.
+008088     (base 16)		VICTOR COMPANY OF JAPAN, LTD.
+				58-7 SHINMEI-CHO, YOKOSUKA
+				    
+				JP
+
+00-80-D8   (hex)		NETWORK PERIPHERALS INC.
+0080D8     (base 16)		NETWORK PERIPHERALS INC.
+				2890 ZONKER ROAD SUITE 209
+				SAN JOSE  CA  95134
+				US
+
+00-80-9E   (hex)		DATUS GMBH
+00809E     (base 16)		DATUS GMBH
+				INDUSTRIESTR. 2
+				  WEST  
+				DE
+
+00-80-2B   (hex)		INTEGRATED MARKETING CO
+00802B     (base 16)		INTEGRATED MARKETING CO
+				1360 BORDEAUX DRIVE
+				SUNNYVALE  CA  94089
+				US
+
+00-80-01   (hex)		PERIPHONICS CORPORATION
+008001     (base 16)		PERIPHONICS CORPORATION
+				4000 VETERANS MEMORIAL HIGHWAY
+				BOHEMIA  NEW YORK  11716
+				US
+
+00-80-97   (hex)		CENTRALP AUTOMATISMES
+008097     (base 16)		CENTRALP AUTOMATISMES
+				21, RUE MARCEL PAGNOL 69694
+				    
+				FR
+
+00-80-71   (hex)		SAI TECHNOLOGY
+008071     (base 16)		SAI TECHNOLOGY
+				4224 CAMPUS POINT COURT
+				SAN DIEGO  CA  92121-1513
+				US
+
+00-80-98   (hex)		TDK CORPORATION
+008098     (base 16)		TDK CORPORATION
+				CORP. R&D DEPT. TECH. HDQTERS.
+				CHIBA-KEN  272,  
+				JP
+
+00-80-CA   (hex)		NETCOM RESEARCH INCORPORATED
+0080CA     (base 16)		NETCOM RESEARCH INCORPORATED
+				201 TECHNOLOGY DRIVE
+				IRVINE  CA  92718
+				US
+
+00-80-D5   (hex)		CADRE TECHNOLOGIES
+0080D5     (base 16)		CADRE TECHNOLOGIES
+				19545 NW VON NEUMANN DRIVE
+				BEAVERTON  OR  97006
+				VU
+
+00-80-1B   (hex)		KODIAK TECHNOLOGY
+00801B     (base 16)		KODIAK TECHNOLOGY
+				2340 HARRIS WAY
+				SAN JOSE  CA  95131
+				US
+
+00-80-D3   (hex)		SHIVA CORP.
+0080D3     (base 16)		SHIVA CORP.
+				205 BURLINGTON ROAD
+				BEDFORD  MA  01730
+				US
+
+00-80-B3   (hex)		AVAL DATA CORPORATION
+0080B3     (base 16)		AVAL DATA CORPORATION
+				MACHIDA ENGINEERING CENTER
+				    
+				JP
+
+00-80-E7   (hex)		Leonardo Tactical Systems.
+0080E7     (base 16)		Leonardo Tactical Systems.
+				Silvertree, Coxbridge Business Park
+				Alton Road,   Farnham  GU10 5EH
+				GB
+
+00-80-20   (hex)		NETWORK PRODUCTS
+008020     (base 16)		NETWORK PRODUCTS
+				DIVISION OF ANDREW CORPORATION
+				TORRANCE  CA  90503
+				US
+
+00-80-70   (hex)		COMPUTADORAS MICRON
+008070     (base 16)		COMPUTADORAS MICRON
+				GUERRERO 2001 - 19
+				    
+				MX
+
+00-80-08   (hex)		DYNATECH COMPUTER SYSTEMS
+008008     (base 16)		DYNATECH COMPUTER SYSTEMS
+				280 BERNARDO AVENUE
+				MOUNTAIN VIEW  CA  94039-7400
+				US
+
+00-00-E4   (hex)		IN2 GROUPE INTERTECHNIQUE
+0000E4     (base 16)		IN2 GROUPE INTERTECHNIQUE
+				IN2 - B.P.63
+				    
+				FR
+
+00-80-13   (hex)		THOMAS-CONRAD CORPORATION
+008013     (base 16)		THOMAS-CONRAD CORPORATION
+				1908-R KRAMER LANE
+				AUSTIN  TX  78758
+				US
+
+00-80-6E   (hex)		NIPPON STEEL CORPORATION
+00806E     (base 16)		NIPPON STEEL CORPORATION
+				31-1 SHINKAWA 2-CHOUME
+				    
+				JP
+
+00-80-10   (hex)		COMMODORE INTERNATIONAL
+008010     (base 16)		COMMODORE INTERNATIONAL
+				1200 WILSON DRIVE
+				WEST CHESTER  PA  19380
+				US
+
+00-80-47   (hex)		IN-NET CORP.
+008047     (base 16)		IN-NET CORP.
+				16720 WEST BERNARDO DRIVE
+				SAN DIEGO  CA  92127-1904
+				US
+
+00-80-67   (hex)		SQUARE D COMPANY
+008067     (base 16)		SQUARE D COMPANY
+				4041 NORTH RICHARD STREET
+				MILWAUKEE  WI  53201
+				US
+
+00-80-45   (hex)		MATSUSHITA ELECTRIC IND. CO
+008045     (base 16)		MATSUSHITA ELECTRIC IND. CO
+				COMPUTER DIVISION
+				OSAKA  571  
+				JP
+
+00-80-BF   (hex)		TAKAOKA ELECTRIC MFG. CO. LTD.
+0080BF     (base 16)		TAKAOKA ELECTRIC MFG. CO. LTD.
+				KANDA BRANCH OFFICE TONEN
+				    
+				JP
+
+00-80-F9   (hex)		HEURIKON CORPORATION
+0080F9     (base 16)		HEURIKON CORPORATION
+				8310 EXCELSIOR DRIVE
+				MADISON  WI  53717
+				US
+
+00-80-A1   (hex)		MICROTEST, INC.
+0080A1     (base 16)		MICROTEST, INC.
+				4747 N. 22ND STREET
+				PHOENIX  AZ  85016-4708
+				US
+
+00-80-A9   (hex)		CLEARPOINT RESEARCH
+0080A9     (base 16)		CLEARPOINT RESEARCH
+				190 NORTH MAIN STREET
+				  NATICK  MA
+				US
+
+00-80-17   (hex)		PFU LIMITED
+008017     (base 16)		PFU LIMITED
+				Nu 98-2 Unoke
+				Kahoku-shi, Ishikawa    929-1192
+				JP
+
+00-80-F8   (hex)		MIZAR, INC.
+0080F8     (base 16)		MIZAR, INC.
+				1419 DUNN DRIVE
+				CARROLLTON  TX  75006
+				US
+
+00-00-14   (hex)		NETRONIX
+000014     (base 16)		NETRONIX
+				1372 MCDOWELL BLVD.
+				PETULAMA  CA  94952
+				US
+
+00-00-72   (hex)		MINIWARE TECHNOLOGY
+000072     (base 16)		MINIWARE TECHNOLOGY
+				BEEMDENSTRAAT 38
+				  THE  
+				NL
+
+00-00-A1   (hex)		MARQUETTE ELECTRIC CO.
+0000A1     (base 16)		MARQUETTE ELECTRIC CO.
+				8200 WEST TOWER AVENUE
+				MILWAUKEE  WI  53223
+				US
+
+00-00-F5   (hex)		DIAMOND SALES LIMITED
+0000F5     (base 16)		DIAMOND SALES LIMITED
+				17, CHARTERHOUSE STREET
+				  UNITED  KINGDOM
+				GB
+
+00-00-5C   (hex)		TELEMATICS INTERNATIONAL INC.
+00005C     (base 16)		TELEMATICS INTERNATIONAL INC.
+				1201 CYPRESS CREEK RD
+				FT. LAUDERDALE  FL  33309
+				US
+
+00-00-AC   (hex)		CONWARE COMPUTER CONSULTING
+0000AC     (base 16)		CONWARE COMPUTER CONSULTING
+				KILLISFELDSTRAßE 64
+				    
+				DE
+
+00-00-94   (hex)		ASANTE TECHNOLOGIES
+000094     (base 16)		ASANTE TECHNOLOGIES
+				821 FOX LANE
+				SAN JOSE  CA  95131
+				US
+
+00-00-90   (hex)		MICROCOM
+000090     (base 16)		MICROCOM
+				500 RIVER RIDGE DRIVE
+				NORWOOD  MA  02062-5028
+				US
+
+00-00-47   (hex)		NICOLET INSTRUMENTS CORP.
+000047     (base 16)		NICOLET INSTRUMENTS CORP.
+				5225 VERONA ROAD
+				MADISON  WI  53711
+				US
+
+00-00-21   (hex)		SUREMAN COMP. & COMMUN. CORP.
+000021     (base 16)		SUREMAN COMP. & COMMUN. CORP.
+				10F-5 NO. 7,  SEC. 3
+				TAIPEI  TAIWAN,  R.O.C.
+				TW
+
+00-00-30   (hex)		VG LABORATORY SYSTEMS LTD
+000030     (base 16)		VG LABORATORY SYSTEMS LTD
+				TRIBUNE AVENUE
+				    ENGLAND
+				GB
+
+00-00-35   (hex)		SPECTRAGRAPHICS CORPORATION
+000035     (base 16)		SPECTRAGRAPHICS CORPORATION
+				    OR
+				SAN DIEGO  CA  92121
+				US
+
+00-00-26   (hex)		SHA-KEN CO., LTD.
+000026     (base 16)		SHA-KEN CO., LTD.
+				MINAMI-OTSUKA
+				  TOKYO  
+				JP
+
+00-00-B6   (hex)		MICRO-MATIC RESEARCH
+0000B6     (base 16)		MICRO-MATIC RESEARCH
+				AMBACHTENLAAN  21 B5
+				    
+				BE
+
+00-00-82   (hex)		LECTRA SYSTEMES SA
+000082     (base 16)		LECTRA SYSTEMES SA
+				CHEMIN DE MARTICOT
+				    
+				FR
+
+00-00-2B   (hex)		CRISP AUTOMATION, INC
+00002B     (base 16)		CRISP AUTOMATION, INC
+				5160 BLAZER PARKWAY
+				DUBLIN  OH  43017
+				US
+
+00-00-51   (hex)		HOB ELECTRONIC GMBH & CO. KG
+000051     (base 16)		HOB ELECTRONIC GMBH & CO. KG
+				BRANDSSTATTER-STR.2-10
+				    
+				DE
+
+00-00-A7   (hex)		NETWORK COMPUTING DEVICES INC.
+0000A7     (base 16)		NETWORK COMPUTING DEVICES INC.
+				350 NORTH BERNARDO
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-00-98   (hex)		CROSSCOMM CORPORATION
+000098     (base 16)		CROSSCOMM CORPORATION
+				450 DONALD LYNCH BOULEVARD
+				MARLBOROUGH  MA  01752
+				US
+
+00-00-C6   (hex)		EON SYSTEMS
+0000C6     (base 16)		EON SYSTEMS
+				10601 SOUTH DEANZA BLVD.
+				CUPERTINO  CA  95014
+				US
+
+00-00-70   (hex)		HCL LIMITED
+000070     (base 16)		HCL LIMITED
+				RESEARCH & DEVELOPMENT UNIT
+				    
+				IN
+
+00-00-8F   (hex)		Raytheon
+00008F     (base 16)		Raytheon
+				M/S 1-1-1119
+				Marlboro  MA  01752
+				US
+
+00-00-F1   (hex)		MAGNA COMPUTER CORPORATION
+0000F1     (base 16)		MAGNA COMPUTER CORPORATION
+				22 KEEWAYDIN DRIVE
+				SALEM  NH  03079
+				US
+
+00-00-54   (hex)		Schneider Electric
+000054     (base 16)		Schneider Electric
+				35 rue Joseph Monier
+				    
+				FR
+
+00-00-20   (hex)		DATAINDUSTRIER DIAB AB
+000020     (base 16)		DATAINDUSTRIER DIAB AB
+				BOX 2029
+				    
+				SE
+
+00-00-7A   (hex)		DANA COMPUTER INC.
+00007A     (base 16)		DANA COMPUTER INC.
+				550 DEL REY AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-00-45   (hex)		FORD AEROSPACE & COMM. CORP.
+000045     (base 16)		FORD AEROSPACE & COMM. CORP.
+				COLORADO SPRINGS OPERATION
+				COLORADO SPRINGS  CO  80908
+				US
+
+00-00-9C   (hex)		ROLM MIL-SPEC COMPUTERS
+00009C     (base 16)		ROLM MIL-SPEC COMPUTERS
+				3151 ZANKER ROAD
+				SAN JOSE  CA  95148
+				US
+
+00-00-7C   (hex)		AMPERE INCORPORATED
+00007C     (base 16)		AMPERE INCORPORATED
+				SHINJUKU ASAHI BLDG.
+				  TOKYO  
+				JP
+
+00-00-68   (hex)		ROSEMOUNT CONTROLS
+000068     (base 16)		ROSEMOUNT CONTROLS
+				1300 E. LAMBERT ROAD
+				LA HABRA  CA  90632
+				US
+
+00-00-E9   (hex)		ISICAD, INC.
+0000E9     (base 16)		ISICAD, INC.
+				1920 WEST CORPORATE WAY
+				ANAHEIM  CA  92803-6122
+				US
+
+00-00-9F   (hex)		AMERISTAR TECHNOLOGIES INC.
+00009F     (base 16)		AMERISTAR TECHNOLOGIES INC.
+				47 WHITTIER AVE.
+				MEDFORD  NY  11763
+				US
+
+00-00-E3   (hex)		INTEGRATED MICRO PRODUCTS LTD
+0000E3     (base 16)		INTEGRATED MICRO PRODUCTS LTD
+				IMP, NO. 1 INDUSTRIAL ESTATE
+				ENGLAND  ENGLAND  DH86TJ
+				GB
+
+00-00-AD   (hex)		BRUKER INSTRUMENTS INC.
+0000AD     (base 16)		BRUKER INSTRUMENTS INC.
+				MANNING PARK
+				BILLERICA  MA  01821
+				US
+
+00-00-74   (hex)		RICOH COMPANY LTD.
+000074     (base 16)		RICOH COMPANY LTD.
+				2446 TODA, ATSUGI CITY
+				  243  
+				JP
+
+00-00-46   (hex)		OLIVETTI NORTH AMERICA
+000046     (base 16)		OLIVETTI NORTH AMERICA
+				E 22425 APPLEWAY
+				LIBERTY LAKE  WA  99019
+				US
+
+00-00-8D   (hex)		Cryptek Inc.
+00008D     (base 16)		Cryptek Inc.
+				1501 Moran Road
+				Sterling  VA  20166
+				US
+
+00-00-3B   (hex)		i Controls, Inc.
+00003B     (base 16)		i Controls, Inc.
+				12F Doonsan building, 105-7
+				  KOREA  135-714
+				KR
+
+00-00-B3   (hex)		CIMLINC INCORPORATED
+0000B3     (base 16)		CIMLINC INCORPORATED
+				1957 CROOKS ROAD
+				TROY  MI  48084
+				US
+
+00-00-D3   (hex)		WANG LABORATORIES INC.
+0000D3     (base 16)		WANG LABORATORIES INC.
+				
+				    
+				
+
+00-00-D0   (hex)		DEVELCON ELECTRONICS LTD.
+0000D0     (base 16)		DEVELCON ELECTRONICS LTD.
+				856-51ST STREET EAST
+				    
+				CA
+
+00-00-93   (hex)		PROTEON INC.
+000093     (base 16)		PROTEON INC.
+				4 TECH CIRCLE
+				NATICK  MA  01760
+				US
+
+00-00-8B   (hex)		INFOTRON
+00008B     (base 16)		INFOTRON
+				9 NORTH OLNEY
+				CHERRY HILL  NJ  08003
+				US
+
+08-00-57   (hex)		Evans & Sutherland
+080057     (base 16)		Evans & Sutherland
+				
+				Salt Lake City  UT  
+				US
+
+08-00-5D   (hex)		GOULD INC.
+08005D     (base 16)		GOULD INC.
+				6901 WEST SUNRISE BLVD.
+				FT. LAUDERDALE  FL  33310-9148
+				US
+
+08-00-5B   (hex)		VTA TECHNOLOGIES INC.
+08005B     (base 16)		VTA TECHNOLOGIES INC.
+				2040 SHERMAN STREET
+				HOLLYWOOD  FL  33020
+				US
+
+08-00-71   (hex)		MATRA (DSIE)
+080071     (base 16)		MATRA (DSIE)
+				PARC D'AFFAIRES - B.P. 262
+				    
+				FR
+
+08-00-6C   (hex)		SUNTEK TECHNOLOGY INT'L
+08006C     (base 16)		SUNTEK TECHNOLOGY INT'L
+				586 NO. FIRST STREET
+				SAN JOSE  CA  95112
+				US
+
+08-00-67   (hex)		ComDesign
+080067     (base 16)		ComDesign
+				
+				Goleta  CA  
+				US
+
+08-00-8C   (hex)		NETWORK RESEARCH CORPORATION
+08008C     (base 16)		NETWORK RESEARCH CORPORATION
+				2380 N. ROSE AVENUE
+				OXNARD  CA  93010
+				US
+
+08-00-81   (hex)		ASTECH INC.
+080081     (base 16)		ASTECH INC.
+				670 NORTH COMMERCIAL STREET
+				MANCHESTER  NH  03101
+				US
+
+08-00-2D   (hex)		LAN-TEC INC.
+08002D     (base 16)		LAN-TEC INC.
+				2131 UNIVERSITY AVENUE
+				BERKELEY  CA  94704
+				US
+
+00-DD-00   (hex)		UNGERMANN-BASS INC.
+00DD00     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-AA   (hex)		XEROX CORPORATION
+0000AA     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+04-0A-E0   (hex)		XMIT AG COMPUTER NETWORKS
+040AE0     (base 16)		XMIT AG COMPUTER NETWORKS
+				11 AVENUE DE BAUMETTES
+				    
+				CH
+
+08-00-11   (hex)		TEKTRONIX INC.
+080011     (base 16)		TEKTRONIX INC.
+				TECHNICAL STANDARDS
+				BEAVERTON  OR  97077
+				US
+
+08-00-26   (hex)		NORSK DATA A.S.
+080026     (base 16)		NORSK DATA A.S.
+				P.O. BOX 25 BOGERUD
+				    
+				NO
+
+08-00-25   (hex)		CONTROL DATA
+080025     (base 16)		CONTROL DATA
+				4201 LEXINGTON AVE NORTH
+				ARDEN HILLS  MN  55112
+				US
+
+10-00-00   (hex)		Private
+100000     (base 16)		Private
+
+00-00-D7   (hex)		DARTMOUTH COLLEGE
+0000D7     (base 16)		DARTMOUTH COLLEGE
+				KIEWIT COMPUTER CENTER
+				HANOVER  NH  03755
+				US
+
+AA-00-04   (hex)		DIGITAL EQUIPMENT CORPORATION
+AA0004     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+08-00-0C   (hex)		MIKLYN DEVELOPMENT CO.
+08000C     (base 16)		MIKLYN DEVELOPMENT CO.
+				3613 ANDOVER DIVE
+				BEDFORD  TX  76021
+				US
+
+00-DD-05   (hex)		UNGERMANN-BASS INC.
+00DD05     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+08-00-1D   (hex)		ABLE COMMUNICATIONS INC.
+08001D     (base 16)		ABLE COMMUNICATIONS INC.
+				17891 CARTWRIGHT ROAD
+				IRVINE  CA  92714-6216
+				US
+
+00-DD-0B   (hex)		UNGERMANN-BASS INC.
+00DD0B     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+08-00-03   (hex)		ADVANCED COMPUTER COMM.
+080003     (base 16)		ADVANCED COMPUTER COMM.
+				720 SANTA BARBARA ST.
+				SANTA BARBARA  CA  93101
+				US
+
+00-DD-03   (hex)		UNGERMANN-BASS INC.
+00DD03     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-DD-0F   (hex)		UNGERMANN-BASS INC.
+00DD0F     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-01   (hex)		XEROX CORPORATION
+000001     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+08-00-17   (hex)		NATIONAL SEMICONDUCTOR
+080017     (base 16)		NATIONAL SEMICONDUCTOR
+				2900 SEMICONDUCTOR DRIVE
+				SANTA CLARA  CA  95051
+				US
+
+54-21-60   (hex)		Alula
+542160     (base 16)		Alula
+				2340 Energy Park Drive
+				St. Paul  MN  55108
+				US
+
+10-B3-C6   (hex)		Cisco Systems, Inc
+10B3C6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+10-B3-D6   (hex)		Cisco Systems, Inc
+10B3D6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-96-30   (hex)		Technicolor CH USA Inc.
+589630     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+F8-54-B8   (hex)		Amazon Technologies Inc.
+F854B8     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+78-17-35   (hex)		Nokia Shanghai Bell Co., Ltd.
+781735     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai
+				Shanghai     201206
+				CN
+
+3C-89-4D   (hex)		Dr. Ing. h.c. F. Porsche AG
+3C894D     (base 16)		Dr. Ing. h.c. F. Porsche AG
+				Porscheplatz 1
+				Stuttgart    70435
+				DE
+
+84-C8-07   (hex)		ADVA Optical Networking Ltd.
+84C807     (base 16)		ADVA Optical Networking Ltd.
+				ADVAntage House
+				York    YO30 4RY
+				GB
+
+B4-39-39   (hex)		Shenzhen TINNO Mobile Technology Corp.
+B43939     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+A0-AB-51   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+A0AB51     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road, Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+64-C9-01   (hex)		INVENTEC Corporation
+64C901     (base 16)		INVENTEC Corporation
+				No.66, Hougang St., Shilin Dist., Taipei City 111, Taiwan (R.O.C.)
+				Taipei    111
+				TW
+
+74-9E-F5   (hex)		Samsung Electronics Co.,Ltd
+749EF5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+68-BF-C4   (hex)		Samsung Electronics Co.,Ltd
+68BFC4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-5E-45   (hex)		ASUSTek COMPUTER INC.
+A85E45     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+04-B1-A1   (hex)		Samsung Electronics Co.,Ltd
+04B1A1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-46-4E   (hex)		Samsung Electronics Co.,Ltd
+CC464E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F8-89-3C   (hex)		Inventec Appliances Corp.
+F8893C     (base 16)		Inventec Appliances Corp.
+				37 Wugong 5th road, New Taipei Industrial Park,
+				New Taipei City  Wugu District  24890
+				TW
+
+A0-DF-15   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A0DF15     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-AD-34   (hex)		Routerboard.com
+C4AD34     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+30-6F-07   (hex)		Nations Technologies Inc.
+306F07     (base 16)		Nations Technologies Inc.
+				18F, Nations Tower, Nanshan District
+				Shenzhen    518057
+				CN
+
+24-74-F7   (hex)		GoPro
+2474F7     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+7C-D5-66   (hex)		Amazon Technologies Inc.
+7CD566     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+68-63-50   (hex)		Hella India Automotive Pvt Ltd
+686350     (base 16)		Hella India Automotive Pvt Ltd
+				Unit no 201A to 201B  Nano Space Surveyno.5/1B/2 BanerBaner Pashan Link road
+				Pune  Maharastra  411045
+				IN
+
+5C-E5-0C   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+5CE50C     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+18-70-3B   (hex)		Huawei Device Co., Ltd.
+18703B     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D8-9E-61   (hex)		Huawei Device Co., Ltd.
+D89E61     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+34-7E-00   (hex)		Huawei Device Co., Ltd.
+347E00     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-30-92   (hex)		Kontron Electronics AG
+003092     (base 16)		Kontron Electronics AG
+				Riedstrasse 1
+				Rotkreuz    CH-6343
+				CH
+
+80-75-1F   (hex)		BSkyB Ltd
+80751F     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+E8-5A-8B   (hex)		Xiaomi Communications Co Ltd
+E85A8B     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+44-22-95   (hex)		China Mobile Iot Limited company
+442295     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+5C-71-0D   (hex)		Cisco Systems, Inc
+5C710D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+00-AB-48   (hex)		eero inc.
+00AB48     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+F8-55-CD   (hex)		Visteon Corporation
+F855CD     (base 16)		Visteon Corporation
+				One Village Center Drive
+				Van Buren Twp  MI  48111
+				US
+
+44-18-47   (hex)		HUNAN SCROWN ELECTRONIC INFORMATION TECH.CO.,LTD
+441847     (base 16)		HUNAN SCROWN ELECTRONIC INFORMATION TECH.CO.,LTD
+				Building No.4,Changsha Zhongdian Software Park No.39,Jianshan Road
+				Changsha  Hunan  410006
+				CN
+
+1C-C1-BC   (hex)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+1CC1BC     (base 16)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+				Room 401, Building 15, No.498 Guoshoujing Road, Pudong Software Park
+				Shanghai    200120
+				CN
+
+AC-61-B9   (hex)		WAMA Technology Limited
+AC61B9     (base 16)		WAMA Technology Limited
+				Room 2205, Westley Square, 48 Hoi Yuen Road, Kwun Tong, Kowloon
+				Hong Kong    00000
+				HK
+
+C4-D8-F3   (hex)		iZotope
+C4D8F3     (base 16)		iZotope
+				60 Hampshire St
+				Cambridge  MA  02139
+				US
+
+00-30-56   (hex)		HMS Industrial Networks
+003056     (base 16)		HMS Industrial Networks
+				P O Box 4126
+				Halmstad  Halland  300 04
+				SE
+
+68-0A-E2   (hex)		Silicon Laboratories
+680AE2     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+AC-8B-9C   (hex)		Primera Technology, Inc.
+AC8B9C     (base 16)		Primera Technology, Inc.
+				2 Carlson Parkway N, Ste 375
+				Plymouth  MN  55447
+				US
+
+2C-3A-FD   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+2C3AFD     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+34-49-5B   (hex)		Sagemcom Broadband SAS
+34495B     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+C8-F3-19   (hex)		LG Electronics (Mobile Communications)
+C8F319     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+80-16-09   (hex)		Sleep Number
+801609     (base 16)		Sleep Number
+				1001 Third Avenue South
+				Minneapolis  MN  55404
+				US
+
+04-5E-A4   (hex)		SHENZHEN NETIS TECHNOLOGY CO.,LTD
+045EA4     (base 16)		SHENZHEN NETIS TECHNOLOGY CO.,LTD
+				Building 6, Baolong Plant, Able Technology Park, Longgang District
+				SHENZHEN    518116
+				CN
+
+1C-BF-C0   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+1CBFC0     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+78-B4-6A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+78B46A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+6C-EB-B6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6CEBB6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-F5-5B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CF55B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-3F-67   (hex)		Huawei Device Co., Ltd.
+E83F67     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+34-46-EC   (hex)		Huawei Device Co., Ltd.
+3446EC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+64-31-39   (hex)		IEEE Registration Authority
+643139     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-4B-D5   (hex)		Xiaomi Communications Co Ltd
+A44BD5     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+64-95-6C   (hex)		LG Electronics
+64956C     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+14-87-6A   (hex)		Apple, Inc.
+14876A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-B5-5F   (hex)		Apple, Inc.
+E0B55F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-FF-C2   (hex)		Apple, Inc.
+F8FFC2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-EB-40   (hex)		Apple, Inc.
+E0EB40     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-69-4E   (hex)		Texas Instruments
+64694E     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+94-D6-DB   (hex)		NexFi
+94D6DB     (base 16)		NexFi
+				Room 417, Building 14, No. 498, Guoshoujing Road, Pudong New Area
+				Shanghai    201203
+				CN
+
+B4-EC-F2   (hex)		Shanghai Listent Medical Tech Co., Ltd.
+B4ECF2     (base 16)		Shanghai Listent Medical Tech Co., Ltd.
+				No. 668 Qingdai Road Pudong District
+				Shanghai  Shanghai  201318
+				CN
+
+18-E7-77   (hex)		vivo Mobile Communication Co., Ltd.
+18E777     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+40-77-A9   (hex)		New H3C Technologies Co., Ltd
+4077A9     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+F8-33-31   (hex)		Texas Instruments
+F83331     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+C4-95-4D   (hex)		IEEE Registration Authority
+C4954D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C4-98-78   (hex)		SHANGHAI MOAAN INTELLIGENT TECHNOLOGY CO.,LTD
+C49878     (base 16)		SHANGHAI MOAAN INTELLIGENT TECHNOLOGY CO.,LTD
+				BLOCK B, 4TH FLOOR, BUILDING 2, NO. 401 CAOBAO ROAD, XUHUI DISTRICT, SHANGHAI
+				SHANGHAI    200030
+				CN
+
+6C-63-9C   (hex)		ARRIS Group, Inc.
+6C639C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-2A-EF   (hex)		  r2p Asia-Pacific Pty Ltd
+5C2AEF     (base 16)		  r2p Asia-Pacific Pty Ltd
+				65 Epping Road
+				Sydney  NSW  2113
+				AU
+
+A4-BB-6D   (hex)		Dell Inc.
+A4BB6D     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+6C-06-D6   (hex)		Huawei Device Co., Ltd.
+6C06D6     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+0C-8E-29   (hex)		Arcadyan Corporation
+0C8E29     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+A0-22-4E   (hex)		IEEE Registration Authority
+A0224E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+30-27-CF   (hex)		Private
+3027CF     (base 16)		Private
+
+38-43-E5   (hex)		Grotech Inc
+3843E5     (base 16)		Grotech Inc
+				19, Ojeongongeop-gil
+				Uiwang-si  Gyeonggi-do  16072
+				KR
+
+CC-59-3E   (hex)		Sensium Healthcare Limited
+CC593E     (base 16)		Sensium Healthcare Limited
+				115 MILTON PARK
+				ABINGDON  OXFORDSHIRE  OX14 4SA
+				GB
+
+5C-68-D0   (hex)		Aurora Innovation Inc.
+5C68D0     (base 16)		Aurora Innovation Inc.
+				1880 Embarcadero Rd.
+				Palo Alto  CA  94303
+				US
+
+10-36-4A   (hex)		Boston Dynamics
+10364A     (base 16)		Boston Dynamics
+				78 4TH AVE
+				Waltham  MA  02451
+				US
+
+00-B8-10   (hex)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+00B810     (base 16)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+				Room 401, Building 15, No.498 Guoshoujing Road, Pudong Software Park
+				Shanghai    200120
+				CN
+
+A4-B2-39   (hex)		Cisco Systems, Inc
+A4B239     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-D5-B9   (hex)		Rainforest Automation, Inc.
+D8D5B9     (base 16)		Rainforest Automation, Inc.
+				827 Cambie St.
+				Vancouver  British Columbia  V6B 2P4
+				CA
+
+00-1B-B0   (hex)		Bharat Electronics Limited
+001BB0     (base 16)		Bharat Electronics Limited
+				JALAHALLI POST
+				BANGALORE  KARNATAKA  560013
+				IN
+
+68-AF-FF   (hex)		Shanghai Cambricon Information Technology Co., Ltd.
+68AFFF     (base 16)		Shanghai Cambricon Information Technology Co., Ltd.
+				888 West Huanhu Road No.2, Nanhui New Town, Pudong New Area
+				Shanghai  Shanghai  200000
+				CN
+
+DC-21-E2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC21E2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+FC-1B-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC1BD1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-25-75   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+582575     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-DE-E5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+28DEE5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-1C-3C   (hex)		TECNO MOBILE LIMITED
+D01C3C     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+18-C0-4D   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+18C04D     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+8C-AA-B5   (hex)		Espressif Inc.
+8CAAB5     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+40-2C-76   (hex)		IEEE Registration Authority
+402C76     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+44-C7-FC   (hex)		Huawei Device Co., Ltd.
+44C7FC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+78-85-F4   (hex)		Huawei Device Co., Ltd.
+7885F4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F4-49-55   (hex)		MIMO TECH Co., Ltd.
+F44955     (base 16)		MIMO TECH Co., Ltd.
+				21F.-6, No. 7, Sec. 3, New Taipei Blvd., Xinzhuang Dist.,
+				New Taipei City  Taiwan  24250
+				TW
+
+08-09-C7   (hex)		Zhuhai Unitech Power Technology Co., Ltd.
+0809C7     (base 16)		Zhuhai Unitech Power Technology Co., Ltd.
+				102, Yinhua Road
+				Zhuhai  Guangdong  519000
+				CN
+
+88-54-1F   (hex)		Google, Inc.
+88541F     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+90-0C-C8   (hex)		Google, Inc.
+900CC8     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+04-1D-C7   (hex)		zte corporation
+041DC7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+68-21-5F   (hex)		Edgecore Networks Corporation
+68215F     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+3C-28-A6   (hex)		Alcatel-Lucent Enterprise (China)
+3C28A6     (base 16)		Alcatel-Lucent Enterprise (China)
+				2/F, Building 1, No.60 Naxian Road,Pudong
+				Shanghai  Shanghai  201210
+				CN
+
+50-50-A4   (hex)		Samsung Electronics Co.,Ltd
+5050A4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-86-D9   (hex)		Samsung Electronics Co.,Ltd
+8086D9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-17-B8   (hex)		AirTies Wireless Networks
+F417B8     (base 16)		AirTies Wireless Networks
+				Esentepe Mah., Kore Şehitleri Cad.
+				Istanbul  Şişli  34360
+				TR
+
+3C-BF-60   (hex)		Apple, Inc.
+3CBF60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-15-F4   (hex)		Apple, Inc.
+AC15F4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-6A-77   (hex)		Samsung Electronics Co.,Ltd
+386A77     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-14-59   (hex)		Vodafone Italia S.p.A.
+141459     (base 16)		Vodafone Italia S.p.A.
+				Via Lorenteggio nr. 240
+				Milan  Italy  20147
+				IT
+
+50-43-B9   (hex)		OktoInform RUS
+5043B9     (base 16)		OktoInform RUS
+				Bolshoy Tishinskiy pereulok, d. 26, korp.13-14, ofis 4R
+				Moscow    123557
+				RU
+
+5C-27-D4   (hex)		Shenzhen Qihu Intelligent Technology Company Limited
+5C27D4     (base 16)		Shenzhen Qihu Intelligent Technology Company Limited
+				Room 201, Block A, No.1, Qianwan Road 1,Qianhai Shenzhen HongKong Modern Service Industry Cooperation Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+88-A4-79   (hex)		Apple, Inc.
+88A479     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-72-95   (hex)		Apple, Inc.
+047295     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-46-E1   (hex)		Apple, Inc.
+D446E1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-D1-62   (hex)		Apple, Inc.
+78D162     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-F8-BC   (hex)		Apple, Inc.
+08F8BC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-A2-5B   (hex)		Apple, Inc.
+90A25B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-30-0C   (hex)		Hisense Electric Co.,Ltd
+18300C     (base 16)		Hisense Electric Co.,Ltd
+				Qianwangang Roard 218
+				Qingdao  Shandong  266510
+				CN
+
+44-A5-6E   (hex)		NETGEAR
+44A56E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+1C-91-9D   (hex)		Dongguan Liesheng Electronic Co., Ltd.
+1C919D     (base 16)		Dongguan Liesheng Electronic Co., Ltd.
+				F5, Building B, North Block, Gaosheng Tech Park, No. 84 Zhongli Road, Nancheng District, Dongguan Ci
+				dongguan   guangdong  523000
+				CN
+
+FC-F2-9F   (hex)		China Mobile Iot Limited company
+FCF29F     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+F8-1F-32   (hex)		Motorola Mobility LLC, a Lenovo Company
+F81F32     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+B0-0A-D5   (hex)		zte corporation
+B00AD5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+20-11-4E   (hex)		MeteRSit S.R.L.
+20114E     (base 16)		MeteRSit S.R.L.
+				Viale dell'Industria 31
+				Padova    35129
+				IT
+
+2C-57-41   (hex)		Cisco Systems, Inc
+2C5741     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A8-4D-4A   (hex)		Audiowise Technology Inc.
+A84D4A     (base 16)		Audiowise Technology Inc.
+				2F, No 1-1, Innovation RD I, Hsinchu Science Park
+				Hsincu  Taiwan  30076
+				TW
+
+78-94-E8   (hex)		Radio Bridge
+7894E8     (base 16)		Radio Bridge
+				8601 73rd Ave N, Suite 38
+				Brooklyn Park  MN  55428
+				US
+
+48-4E-FC   (hex)		ARRIS Group, Inc.
+484EFC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+B0-B3-53   (hex)		IEEE Registration Authority
+B0B353     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+54-7F-BC   (hex)		iodyne
+547FBC     (base 16)		iodyne
+				35 Miller Ave #175
+				Mill Valley  CA  94941
+				US
+
+7C-DF-A1   (hex)		Espressif Inc.
+7CDFA1     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+98-00-6A   (hex)		zte corporation
+98006A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-26-74   (hex)		Hunter Douglas
+002674     (base 16)		Hunter Douglas
+				One Duette Way
+				Broomfield  CO  80020
+				US
+
+1C-97-C5   (hex)		Ynomia Pty Ltd
+1C97C5     (base 16)		Ynomia Pty Ltd
+				153 Tooronga Rd
+				Glen Iris    3146
+				AU
+
+5C-C1-D7   (hex)		Samsung Electronics Co.,Ltd
+5CC1D7     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+38-01-46   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+380146     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268? Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+88-96-55   (hex)		Zitte corporation
+889655     (base 16)		Zitte corporation
+				4F Yokohama Kusunoki-cho Building,4-7 Kusunoki-cho,Nishi-ku
+				Yokohama  Kanagawa  2200003
+				JP
+
+F4-A4-D6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4A4D6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+FC-E1-4F   (hex)		BRK Brands, Inc.
+FCE14F     (base 16)		BRK Brands, Inc.
+				3901 Liberty Street
+				Aurora  IL  60504
+				US
+
+74-B6-B6   (hex)		eero inc.
+74B6B6     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+EC-97-B2   (hex)		SUMEC Machinery & Electric Co.,Ltd.
+EC97B2     (base 16)		SUMEC Machinery & Electric Co.,Ltd.
+				198# ChangJiang Road, XuanWu District, 17F, SUMEC Building
+				Nanjing  JiangSu  210018
+				CN
+
+28-FA-7A   (hex)		Zhejiang Tmall Technology Co., Ltd.
+28FA7A     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+84-2E-14   (hex)		Silicon Laboratories
+842E14     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+10-05-E1   (hex)		Nokia
+1005E1     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+08-F4-58   (hex)		Huawei Device Co., Ltd.
+08F458     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+5C-BA-2C   (hex)		Hewlett Packard Enterprise
+5CBA2C     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+34-37-94   (hex)		Hamee Corp.
+343794     (base 16)		Hamee Corp.
+				Square O2 2-12-10 Sakae-cho
+				Odawara  Kanagawa  250-0011
+				JP
+
+6C-D9-4C   (hex)		vivo Mobile Communication Co., Ltd.
+6CD94C     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+EC-31-6D   (hex)		Hansgrohe
+EC316D     (base 16)		Hansgrohe
+				Auestraße 5-9
+				Schiltach    77761
+				DE
+
+44-10-FE   (hex)		Huizhou Foryou General Electronics Co., Ltd.
+4410FE     (base 16)		Huizhou Foryou General Electronics Co., Ltd.
+				North Shangxia Road, Dongjiang Hi-tech Industry Park
+				Huizhou  Guangdong  516000
+				CN
+
+7C-AB-60   (hex)		Apple, Inc.
+7CAB60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-C6-5D   (hex)		Apple, Inc.
+44C65D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-7E-B9   (hex)		Apple, Inc.
+187EB9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-A6-4D   (hex)		Cisco Systems, Inc
+4CA64D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-7F-75   (hex)		Cisco Systems, Inc
+CC7F75     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+20-E8-74   (hex)		Apple, Inc.
+20E874     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-3F-AA   (hex)		Apple, Inc.
+D03FAA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-B9-37   (hex)		Ubee Interactive Co., Limited
+0CB937     (base 16)		Ubee Interactive Co., Limited
+				Flat/RM 1202, 12/F, AT Tower 
+				North Point  Hong Kong  180
+				HK
+
+D4-DC-09   (hex)		Mist Systems, Inc.
+D4DC09     (base 16)		Mist Systems, Inc.
+				1601 South De Anza Blvd, Suite 248
+				Cupertino  CA  95014
+				US
+
+00-88-BA   (hex)		NC&C
+0088BA     (base 16)		NC&C
+				Gurogu
+				Seoul    08390
+				KR
+
+F4-73-35   (hex)		Logitech Far East
+F47335     (base 16)		Logitech Far East
+				#2 Creation Rd. 4,
+				Hsinchu    300
+				TW
+
+90-AD-FC   (hex)		Telechips, Inc.
+90ADFC     (base 16)		Telechips, Inc.
+				19F~23F,Luther Bldg.42, Olympic-ro 35da-gil, Songpa-gu,
+				Seoul  Seoul  05510
+				KR
+
+5C-A6-2D   (hex)		Cisco Systems, Inc
+5CA62D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-2B-69   (hex)		Kumho Electric Inc.
+402B69     (base 16)		Kumho Electric Inc.
+				309, Bongmu-ro, Namsa-myeon, Cheoin-gu
+				Yongin-si  Gyeonggi-do  17118
+				KR
+
+E8-E9-8E   (hex)		SOLAR controls s.r.o.
+E8E98E     (base 16)		SOLAR controls s.r.o.
+				Brojova 25
+				Plzen    32600
+				CZ
+
+64-F6-BB   (hex)		Fibocom Wireless Inc.
+64F6BB     (base 16)		Fibocom Wireless Inc.
+				5/F,TowerA,Technology Building 2,1057 Nanhai Blvd, Nanshan
+				Shenzhen  518000  Guangdong
+				CN
+
+BC-16-95   (hex)		zte corporation
+BC1695     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+DC-35-F1   (hex)		Positivo Tecnologia S.A.
+DC35F1     (base 16)		Positivo Tecnologia S.A.
+				João Bettega, 5200
+				Curitiba  Paraná  81350-000
+				BR
+
+A4-08-01   (hex)		Amazon Technologies Inc.
+A40801     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+AC-1E-D0   (hex)		Temic Automotive Philippines Inc.
+AC1ED0     (base 16)		Temic Automotive Philippines Inc.
+				Bagsakan Road, FTI estate
+				Taguig    1630
+				PH
+
+2C-EA-7F   (hex)		Dell Inc.
+2CEA7F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+34-51-80   (hex)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+345180     (base 16)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+				10F, TCL Multimedia Building, TCL International E City, No.1001 Zhongshanyuan Rd., Nanshan District
+				Shenzhen  Guangdong  518052
+				CN
+
+A4-CF-D2   (hex)		Ubee Interactive Co., Limited
+A4CFD2     (base 16)		Ubee Interactive Co., Limited
+				Flat/RM 1202, 12/F, AT Tower, 180 Electric Road
+				North Point    00000
+				HK
+
+A8-A0-97   (hex)		ScioTeq bvba
+A8A097     (base 16)		ScioTeq bvba
+				President Kennedypark 35A
+				Kortrijk    8500
+				BE
+
+08-6B-D1   (hex)		Shenzhen SuperElectron Technology Co.,Ltd.
+086BD1     (base 16)		Shenzhen SuperElectron Technology Co.,Ltd.
+				1213-1214, haosheng business center, dongbin road, nanshan street, nanshan district, shenzhen city
+				Shenzhen  Guangdong  518000
+				CN
+
+AC-3A-67   (hex)		Cisco Systems, Inc
+AC3A67     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-B5-3D   (hex)		HUNAN GOKE MICROELECTRONICS CO.,LTD
+3CB53D     (base 16)		HUNAN GOKE MICROELECTRONICS CO.,LTD
+				No.9, East 10th Road(South), Xingsha, Changsha
+				Changsha  HUNAN  410131 
+				CN
+
+98-0D-51   (hex)		Huawei Device Co., Ltd.
+980D51     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-AD-D5   (hex)		Huawei Device Co., Ltd.
+00ADD5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+90-5D-7C   (hex)		New H3C Technologies Co., Ltd
+905D7C     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+98-FA-A7   (hex)		INNONET
+98FAA7     (base 16)		INNONET
+				C-417, Munjeong Hyundai Knowledge Industry Center, Beobwon-ro 11-gil-7
+				Songpa-gu  Seoul  05836
+				KR
+
+48-7B-5E   (hex)		SMT TELECOMM HK
+487B5E     (base 16)		SMT TELECOMM HK
+				Unit C 8/F Charmhill Centre 50 Hillwood RD.
+				Tsim Sha Tsui  Kowloon  999077
+				HK
+
+B8-E3-B1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B8E3B1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-B7-A8   (hex)		Heinzinger electronic GmbH
+00B7A8     (base 16)		Heinzinger electronic GmbH
+				Anton Jakob Str.4
+				Rosenheim  BY  83026
+				DE
+
+EC-79-49   (hex)		FUJITSU LIMITED
+EC7949     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+D4-D2-D6   (hex)		FN-LINK TECHNOLOGY LIMITED
+D4D2D6     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+10-50-72   (hex)		Sercomm Corporation.
+105072     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+90-0A-84   (hex)		Mellanox Technologies, Inc.
+900A84     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+AC-4A-67   (hex)		Cisco Systems, Inc
+AC4A67     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+70-CA-97   (hex)		Ruckus Wireless
+70CA97     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+30-B2-16   (hex)		ABB Power Grids Germany AG – Grid Automation
+30B216     (base 16)		ABB Power Grids Germany AG – Grid Automation
+				Kallstadter Strasse 1
+				Mannheim    68309
+				DE
+
+00-09-91   (hex)		Intelligent Platforms, LLC.
+000991     (base 16)		Intelligent Platforms, LLC.
+				2500 Austin Drive
+				Charlottesville  VA  22911
+				US
+
+C8-66-5D   (hex)		Extreme Networks, Inc.
+C8665D     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+E0-1C-41   (hex)		Extreme Networks, Inc.
+E01C41     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+D8-54-A2   (hex)		Extreme Networks, Inc.
+D854A2     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+08-66-1F   (hex)		Palo Alto Networks
+08661F     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+BC-F3-10   (hex)		Extreme Networks, Inc.
+BCF310     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+28-54-71   (hex)		Huawei Device Co., Ltd.
+285471     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B8-8E-82   (hex)		Huawei Device Co., Ltd.
+B88E82     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+DC-33-3D   (hex)		Huawei Device Co., Ltd.
+DC333D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D8-78-7F   (hex)		Ubee Interactive Co., Limited
+D8787F     (base 16)		Ubee Interactive Co., Limited
+				Flat/RM 1202, 12/F, AT Tower, 180 Electric Road
+				North Point    00000
+				HK
+
+D4-1D-71   (hex)		Palo Alto Networks
+D41D71     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+08-87-C6   (hex)		INGRAM MICRO SERVICES
+0887C6     (base 16)		INGRAM MICRO SERVICES
+				100 CHEMIN DE BAILLOT
+				MONTAUBAN    82000
+				FR
+
+78-57-73   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+785773     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-60-89   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC6089     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-3E-92   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+843E92     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-8C-B6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+708CB6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-46-4A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+50464A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-A4-02   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4A402     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-15-FF   (hex)		Novatel Wireless Solutions, Inc.
+0015FF     (base 16)		Novatel Wireless Solutions, Inc.
+				9710 Scranton Rd., Suite 200
+				San Diego  CA  92121
+				US
+
+28-80-A2   (hex)		Novatel Wireless Solutions, Inc.
+2880A2     (base 16)		Novatel Wireless Solutions, Inc.
+				9710 Scranton Rd., Suite 200
+				San Diego  CA  92121
+				US
+
+68-33-2C   (hex)		KENSTEL NETWORKS LIMITED
+68332C     (base 16)		KENSTEL NETWORKS LIMITED
+				34D SECTOR 57 HSIIDC INDUSTRIAL AREA PHASE 4
+				KUNDLI  HARYANA  131028
+				IN
+
+14-5E-45   (hex)		Bamboo Systems Group
+145E45     (base 16)		Bamboo Systems Group
+				Sheraton House, Castle Park
+				Cambridge  CAMBRIDGESHIRE  CB3 0AX
+				GB
+
+70-61-7B   (hex)		Cisco Systems, Inc
+70617B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+98-59-49   (hex)		LUXOTTICA GROUP S.P.A.
+985949     (base 16)		LUXOTTICA GROUP S.P.A.
+				Piazzale Cadrona, 3
+				Milano  MI  20132
+				IT
+
+AC-67-B2   (hex)		Espressif Inc.
+AC67B2     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+9C-BD-6E   (hex)		DERA Co., Ltd
+9CBD6E     (base 16)		DERA Co., Ltd
+				Zhichun road NO7 Building B Room1203 Haidian District
+				Beijing    100191
+				CN
+
+4C-33-29   (hex)		Sweroam
+4C3329     (base 16)		Sweroam
+				Stortorget 16
+				Orebro  N/A  70211
+				SE
+
+64-E1-72   (hex)		Shenzhen Qihoo Intelligent Technology Co.,Ltd
+64E172     (base 16)		Shenzhen Qihoo Intelligent Technology Co.,Ltd
+				Room 201,Block A.No.1,Qianwan Road1 Qianhai Shenzhen-HONGKONG Cooperation Zone
+				Shenzhen  Guangdong  5181000
+				CN
+
+48-8F-5A   (hex)		Routerboard.com
+488F5A     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+10-06-45   (hex)		Sagemcom Broadband SAS
+100645     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-14-C9   (hex)		Brocade Communications Systems LLC
+0014C9     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-24-38   (hex)		Brocade Communications Systems LLC
+002438     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+74-8E-F8   (hex)		Brocade Communications Systems LLC
+748EF8     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-27-F8   (hex)		Brocade Communications Systems LLC
+0027F8     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+50-EB-1A   (hex)		Brocade Communications Systems LLC
+50EB1A     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+F8-4D-FC   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+F84DFC     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+84-9A-40   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+849A40     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+D8-1F-CC   (hex)		Brocade Communications Systems LLC
+D81FCC     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+C4-89-ED   (hex)		Solid Optics EU N.V.
+C489ED     (base 16)		Solid Optics EU N.V.
+				De Huchtstraat 35
+				Almere  Flevoland  1327 EC
+				NL
+
+60-F4-3A   (hex)		Edifier International
+60F43A     (base 16)		Edifier International
+				Suit 2207, 22nd floor, Tower II, Lippo centre, 89 Queensway
+				Hong Kong    070
+				CN
+
+58-A8-7B   (hex)		Fitbit, Inc.
+58A87B     (base 16)		Fitbit, Inc.
+				199 Fremont Street, 14th Fl
+				San Francisco  CA  94105
+				US
+
+5C-6B-D7   (hex)		Foshan VIOMI Electric Appliance Technology Co. Ltd.
+5C6BD7     (base 16)		Foshan VIOMI Electric Appliance Technology Co. Ltd.
+				No.2 North Xinxi Fourth Road, Xiashi Village Committee,Lunjiao Sub-district Office, Shunde District
+				Foshan  Guandong  528308
+				CN
+
+18-48-CA   (hex)		Murata Manufacturing Co., Ltd.
+1848CA     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+90-EE-C7   (hex)		Samsung Electronics Co.,Ltd
+90EEC7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-29-AB   (hex)		Samsung Electronics Co.,Ltd
+1029AB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-4E-CB   (hex)		Samsung Electronics Co.,Ltd
+184ECB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-22-A7   (hex)		NEC Platforms, Ltd.
+8022A7     (base 16)		NEC Platforms, Ltd.
+				2-3 Kandatsukasamachi
+				Chiyodaku  Tokyo  101-8532
+				JP
+
+64-E8-81   (hex)		Aruba, a Hewlett Packard Enterprise Company
+64E881     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+98-9D-5D   (hex)		Technicolor CH USA Inc.
+989D5D     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+5C-23-16   (hex)		Squirrels Research Labs LLC
+5C2316     (base 16)		Squirrels Research Labs LLC
+				8050 Freedom Ave NW Suite B
+				North Canton  OH  44720
+				US
+
+04-21-44   (hex)		Sunitec Enterprise Co.,Ltd
+042144     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+A0-27-B6   (hex)		Samsung Electronics Co.,Ltd
+A027B6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-39-17   (hex)		Samsung Electronics Co.,Ltd
+103917     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+98-80-EE   (hex)		Samsung Electronics Co.,Ltd
+9880EE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-0D-F2   (hex)		Motorola Mobility LLC, a Lenovo Company
+CC0DF2     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+94-BF-94   (hex)		Juniper Networks
+94BF94     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+94-43-4D   (hex)		Ciena Corporation
+94434D     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+A8-40-25   (hex)		Oxide Computer Company
+A84025     (base 16)		Oxide Computer Company
+				1251 Park Avenue
+				Emeryville  CA  94608
+				US
+
+10-65-A3   (hex)		Panamax LLC
+1065A3     (base 16)		Panamax LLC
+				5919 Sea Otter Place
+				Carlsbad   CA  92010
+				US
+
+C8-5B-A0   (hex)		Shenzhen Qihu Intelligent Technology Company Limited
+C85BA0     (base 16)		Shenzhen Qihu Intelligent Technology Company Limited
+				Room 201, Block A, No.1, Qianwan Road 1,Qianhai Shenzhen HongKong Modern Service Industry Cooperation Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+E0-BE-03   (hex)		Lite-On Network Communication (Dongguan) Limited
+E0BE03     (base 16)		Lite-On Network Communication (Dongguan) Limited
+				30#Keji Rd,YinHu Industrial Area,Qingxi Town Dongguan City,Guang Dong China
+				Dongguan  Guang Dong  523648
+				CN
+
+5C-90-12   (hex)		Owl Cyber Defense Solutions, LLC
+5C9012     (base 16)		Owl Cyber Defense Solutions, LLC
+				38A Grove Street
+				Ridgefield  CT  06877
+				US
+
+38-F7-CD   (hex)		IEEE Registration Authority
+38F7CD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+98-CB-A4   (hex)		Benchmark Electronics
+98CBA4     (base 16)		Benchmark Electronics
+				Free Industrial Zone, Phase 1, 
+				Bayan Lepas  Penang  11900
+				MY
+
+00-12-E3   (hex)		Agat Soft LLC
+0012E3     (base 16)		Agat Soft LLC
+				building 14, stroenie 15, room 7
+				Moscow  Serebryakova proezd  129343
+				RU
+
+00-13-51   (hex)		Niles Audio Corporation
+001351     (base 16)		Niles Audio Corporation
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+18-3C-B7   (hex)		Huawei Device Co., Ltd.
+183CB7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A4-88-73   (hex)		Cisco Systems, Inc
+A48873     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B8-80-4F   (hex)		Texas Instruments
+B8804F     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+FC-A5-D0   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+FCA5D0     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+04-CB-88   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+04CB88     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+A0-62-60   (hex)		Private
+A06260     (base 16)		Private
+
+A4-BD-C4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4BDC4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-91-57   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C9157     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-16-93   (hex)		Lear Corporation GmbH
+481693     (base 16)		Lear Corporation GmbH
+				Industriestrasse 48
+				Kronach  Bavaria  96317
+				DE
+
+B4-79-47   (hex)		Nutanix
+B47947     (base 16)		Nutanix
+				1740 Technology Drive Ste #150
+				San Jose  CA  95110
+				US
+
+04-F8-F8   (hex)		Edgecore Networks Corporation
+04F8F8     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+38-F0-C8   (hex)		Mevo Inc.
+38F0C8     (base 16)		Mevo Inc.
+				19 Morris Avenue
+				Brooklyn  NY  11205
+				US
+
+5C-FE-9E   (hex)		Wiwynn Corporation Tainan Branch
+5CFE9E     (base 16)		Wiwynn Corporation Tainan Branch
+				4F, NO. 8, Beiyuan 3rd Rd., Anding Dist.,
+				Tainan    745
+				TW
+
+88-1C-95   (hex)		ITEL MOBILE LIMITED
+881C95     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+F4-69-42   (hex)		ASKEY COMPUTER CORP
+F46942     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+24-14-07   (hex)		Xiamen Sigmastar Technology Ltd.
+241407     (base 16)		Xiamen Sigmastar Technology Ltd.
+				15th Floor ,Unit A,Chuangxin Building, Software Park, Xiamen Torch Hi-Tech Industrial Development Zone, Xiamen,China
+				Xiamen  Fujian  361005
+				CN
+
+08-E9-F6   (hex)		AMPAK Technology,Inc.
+08E9F6     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+F0-2E-51   (hex)		Casa Systems
+F02E51     (base 16)		Casa Systems
+				18-20 Orion Road Lane Cove West
+				LANE COVE  NSW  2066
+				AU
+
+CC-C2-61   (hex)		IEEE Registration Authority
+CCC261     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+74-70-FD   (hex)		Intel Corporate
+7470FD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+7C-2A-31   (hex)		Intel Corporate
+7C2A31     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+B4-6B-FC   (hex)		Intel Corporate
+B46BFC     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+14-4F-8A   (hex)		Intel Corporate
+144F8A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C0-B6-F9   (hex)		Intel Corporate
+C0B6F9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+48-A4-72   (hex)		Intel Corporate
+48A472     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D8-F2-CA   (hex)		Intel Corporate
+D8F2CA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+48-F1-7F   (hex)		Intel Corporate
+48F17F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+44-56-E2   (hex)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+4456E2     (base 16)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+				No.198,First Section,Snow Mountain Avenue, Jinyuan Town, Dayi County
+				Chengdu  Sichuan  611330
+				CN
+
+68-EC-C5   (hex)		Intel Corporate
+68ECC5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+7C-76-35   (hex)		Intel Corporate
+7C7635     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+64-0B-D7   (hex)		Apple, Inc.
+640BD7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-91-3D   (hex)		Apple, Inc.
+A8913D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-C9-5E   (hex)		Samsung Electronics Co.,Ltd
+4CC95E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+0C-3B-50   (hex)		Apple, Inc.
+0C3B50     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-2B-46   (hex)		Intel Corporate
+782B46     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+34-7D-F6   (hex)		Intel Corporate
+347DF6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+CC-D9-AC   (hex)		Intel Corporate
+CCD9AC     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+9C-29-76   (hex)		Intel Corporate
+9C2976     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+B8-9A-2A   (hex)		Intel Corporate
+B89A2A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+58-96-1D   (hex)		Intel Corporate
+58961D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+74-D8-3E   (hex)		Intel Corporate
+74D83E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+08-D2-3E   (hex)		Intel Corporate
+08D23E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A8-7E-EA   (hex)		Intel Corporate
+A87EEA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+40-EC-99   (hex)		Intel Corporate
+40EC99     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+BC-54-2F   (hex)		Intel Corporate
+BC542F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+34-CF-F6   (hex)		Intel Corporate
+34CFF6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C8-7E-A1   (hex)		TCL MOKA International Limited
+C87EA1     (base 16)		TCL MOKA International Limited
+				7/F, Building 22E 22 Science Park East Avenue
+				Hong Kong    999077
+				HK
+
+64-2C-0F   (hex)		vivo Mobile Communication Co., Ltd.
+642C0F     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+A0-51-0B   (hex)		Intel Corporate
+A0510B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+DC-FB-48   (hex)		Intel Corporate
+DCFB48     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+84-FD-D1   (hex)		Intel Corporate
+84FDD1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+40-74-E0   (hex)		Intel Corporate
+4074E0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+08-71-90   (hex)		Intel Corporate
+087190     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+5C-CD-5B   (hex)		Intel Corporate
+5CCD5B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+98-AF-65   (hex)		Intel Corporate
+98AF65     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+40-A6-B7   (hex)		Intel Corporate
+40A6B7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+0C-7A-15   (hex)		Intel Corporate
+0C7A15     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+54-8D-5A   (hex)		Intel Corporate
+548D5A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+30-66-D0   (hex)		Huawei Device Co., Ltd.
+3066D0     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+3C-B2-33   (hex)		Huawei Device Co., Ltd.
+3CB233     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+20-9E-79   (hex)		Universal Electronics, Inc.
+209E79     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+AC-5F-EA   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+AC5FEA     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+04-4A-C6   (hex)		Aipon Electronics Co., Ltd
+044AC6     (base 16)		Aipon Electronics Co., Ltd
+				#78, Qiaojiao Dong road, Qiaolong, Tangxia Town
+				Dongguan City  Guangdong Province  523-710
+				CN
+
+5C-D5-B5   (hex)		Shenzhen WiSiYiLink Technology Co.,Ltd
+5CD5B5     (base 16)		Shenzhen WiSiYiLink Technology Co.,Ltd
+				Building a 3, huafengzhigu Yuanshan hi tech Industrial Park, No.62, Yinhe Road, he'ao community, Yuanshan street, Longgang District
+				Shenzhen    518100
+				CN
+
+88-94-8F   (hex)		Xi'an Zhisensor Technologies Co.,Ltd
+88948F     (base 16)		Xi'an Zhisensor Technologies Co.,Ltd
+				 No.52 Jinye 1st Road Xi'an,Shaanxi,China
+				Xi an  Xi an High-Tech Zone  710077
+				CN
+
+18-95-52   (hex)		1MORE
+189552     (base 16)		1MORE
+				TianliaoBuilding F14, New Materials Industrial Park, Xueyuan Blvd?Nanshan
+				Shenzhen  Guangdong  518055
+				CN
+
+C0-FF-A8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C0FFA8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-51-7E   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+C0517E     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+FC-14-99   (hex)		Aimore Acoustics Incorporation
+FC1499     (base 16)		Aimore Acoustics Incorporation
+				16F,Tianliao Building(New Material industrial Park), Xueyuan Avenue, Nanshan District
+				Shenzhen   Guangdong  518055
+				CN
+
+98-C7-A4   (hex)		Shenzhen HS Fiber Communication Equipment CO., LTD
+98C7A4     (base 16)		Shenzhen HS Fiber Communication Equipment CO., LTD
+				6F, Bld#A, Dezhong Industrial Park, Yangmei Village, Bantian Town, Longgang District
+				Shenzhen  Guangdong  518129
+				CN
+
+00-BE-D5   (hex)		New H3C Technologies Co., Ltd
+00BED5     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+00-02-C4   (hex)		OPT Machine Vision Tech Co., Ltd
+0002C4     (base 16)		OPT Machine Vision Tech Co., Ltd
+				no. 8 JInSheng Road, JinXia Zone, Chang'An Town
+				Dongguan  Guangdong  523000
+				CN
+
+AC-F1-08   (hex)		LG Innotek
+ACF108     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+08-ED-9D   (hex)		TECNO MOBILE LIMITED
+08ED9D     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+E8-6D-CB   (hex)		Samsung Electronics Co.,Ltd
+E86DCB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-49-50   (hex)		IEEE Registration Authority
+304950     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-05-C9   (hex)		LG Innotek
+0005C9     (base 16)		LG Innotek
+				LG Component R&D Center
+				Ansan-si  Gyeonggi-do  426-791
+				KR
+
+0C-DC-7E   (hex)		Espressif Inc.
+0CDC7E     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+20-98-D8   (hex)		Shenzhen Yingdakang Technology CO., LTD
+2098D8     (base 16)		Shenzhen Yingdakang Technology CO., LTD
+				8004,Building 51,Block 2,Shangtang Songzi Park, MinZhi St., Longhua Dist
+				Shenzhen    518055
+				CN
+
+7C-C7-7E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+7CC77E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+A0-CF-F5   (hex)		zte corporation
+A0CFF5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+1C-01-2D   (hex)		Ficer Technology
+1C012D     (base 16)		Ficer Technology
+				2F, No.138, Daye Rd., Beitou Dist.,
+				Taipei City    11268
+				TW
+
+3C-A6-2F   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+3CA62F     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+98-B3-EF   (hex)		Huawei Device Co., Ltd.
+98B3EF     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+50-F9-58   (hex)		Huawei Device Co., Ltd.
+50F958     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C0-A3-6E   (hex)		BSkyB Ltd
+C0A36E     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+60-32-B1   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+6032B1     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+7C-FD-6B   (hex)		Xiaomi Communications Co Ltd
+7CFD6B     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+E4-1F-7B   (hex)		Cisco Systems, Inc
+E41F7B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-26-49   (hex)		Intel Corporate
+182649     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+88-03-E9   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+8803E9     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+34-58-40   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+345840     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-64-7A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C647A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-7F-7B   (hex)		Huawei Device Co., Ltd.
+BC7F7B     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F0-FA-C7   (hex)		Huawei Device Co., Ltd.
+F0FAC7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+DC-EF-80   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DCEF80     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-6F-2D   (hex)		Wahoo Fitness
+B46F2D     (base 16)		Wahoo Fitness
+				90 W Wieuca Rd, Suite 110
+				Atlanta  GA  30342
+				US
+
+5C-85-7E   (hex)		IEEE Registration Authority
+5C857E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+84-6B-48   (hex)		ShenZhen EepuLink Co., Ltd.
+846B48     (base 16)		ShenZhen EepuLink Co., Ltd.
+				4th Floor, Building 3, Nangang 1st industrial zone, Xili street, Nanshan district,
+				ShenZhen  Guangdong  518000
+				CN
+
+B4-60-ED   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+B460ED     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+30-CC-21   (hex)		zte corporation
+30CC21     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+64-6C-80   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+646C80     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+08-9E-01   (hex)		Quanta Computer Inc.
+089E01     (base 16)		Quanta Computer Inc.
+				No.211, Wen Hwa 2nd Rd
+				Taoyuan  Taiwan  33377
+				TW
+
+A8-1E-84   (hex)		Quanta Computer Inc.
+A81E84     (base 16)		Quanta Computer Inc.
+				No.211, Wen Hwa 2nd Rd., Kuei Shan Hsiang
+				Tao Yuan    33377
+				TW
+
+C0-18-50   (hex)		Quanta Computer Inc.
+C01850     (base 16)		Quanta Computer Inc.
+				No. 211, Wen-Hwa 2nd Rd.,Kuei-Shan Dist.
+				Taoyuan City  Taiwan  33377
+				TW
+
+44-27-F3   (hex)		70mai Co.,Ltd.
+4427F3     (base 16)		70mai Co.,Ltd.
+				Room 2220, building 2, No. 588, Zixing road
+				Shanghai  MinHang District  201100
+				CN
+
+04-7D-7B   (hex)		Quanta Computer Inc.
+047D7B     (base 16)		Quanta Computer Inc.
+				NO. 211, WEN HWA 2RD.,KUEI SHAN HSIANG, TAO YUAN SHIEN,
+				TAIPEI  TAIWAN  333
+				TW
+
+00-25-DC   (hex)		Sumitomo Electric Industries, Ltd
+0025DC     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+D4-F3-37   (hex)		Xunison Ltd.
+D4F337     (base 16)		Xunison Ltd.
+				25 Kilbarbery Business Park, Upper Nangor Road
+				Dublin 22  Co. Dublin  D22 NH32
+				IE
+
+48-A2-B8   (hex)		Chengdu Vision-Zenith Tech.Co,.Ltd
+48A2B8     (base 16)		Chengdu Vision-Zenith Tech.Co,.Ltd
+				China (Sichuan) Free Trade Test Zone Chengdu Hi-tech Zone 300 Jiaozi Avenue 3 buildings 22
+				Chengdu  Sichuan  610041
+				CN
+
+C0-B8-E6   (hex)		Ruijie Networks Co.,LTD
+C0B8E6     (base 16)		Ruijie Networks Co.,LTD
+				No. 2, 7th floor, xingwangruijie, haixi hi-tech industrial park, high-tech zone, fuzhou city
+				Fuzhou  Fujian  350002
+				CN
+
+8C-94-1F   (hex)		Cisco Systems, Inc
+8C941F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+68-7D-B4   (hex)		Cisco Systems, Inc
+687DB4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-E8-73   (hex)		HANGZHOU DANGBEI NETWORK TECH.Co.,Ltd
+58E873     (base 16)		HANGZHOU DANGBEI NETWORK TECH.Co.,Ltd
+				Build C,Wanfu Center,Binkang Road No.228,Binjiang Area
+				China    210051
+				CN
+
+B0-30-C8   (hex)		Teal Drones, Inc.
+B030C8     (base 16)		Teal Drones, Inc.
+				5200 South Highland Drive
+				Holladay   UT  84117
+				US
+
+DC-41-A9   (hex)		Intel Corporate
+DC41A9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+08-8F-2C   (hex)		Amber Technology Ltd.
+088F2C     (base 16)		Amber Technology Ltd.
+				Unit 1, 2 Daydream Street
+				Warriewood  New South Wales  2102
+				AU
+
+A8-35-12   (hex)		Huawei Device Co., Ltd.
+A83512     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D4-A6-51   (hex)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+D4A651     (base 16)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+				34/F.,ICBC Tower,3 Garden Road, Central, Hong Kong.
+				Hong Kong  Central Garden Road  510031
+				CN
+
+90-F6-44   (hex)		Huawei Device Co., Ltd.
+90F644     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+44-AF-28   (hex)		Intel Corporate
+44AF28     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+6C-44-2A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6C442A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-7C-C9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A47CC9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-0D-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C40D96     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-68-1C   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+A0681C     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+84-2A-FD   (hex)		HP Inc.
+842AFD     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+F8-5C-7D   (hex)		Shenzhen Honesty Electronics Co.,Ltd.
+F85C7D     (base 16)		Shenzhen Honesty Electronics Co.,Ltd.
+				5/F,Zone B,Chitat Industrial Park,West Longping Road, Longgang District,Shenzhen City
+				Shenzhen  Guangdong  518172
+				CN
+
+84-80-94   (hex)		Meter, Inc.
+848094     (base 16)		Meter, Inc.
+				148 Townsend St
+				San Francisco  CA  94107
+				US
+
+10-B3-D5   (hex)		Cisco Systems, Inc
+10B3D5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+30-A2-C2   (hex)		Huawei Device Co., Ltd.
+30A2C2     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+DC-DF-D6   (hex)		zte corporation
+DCDFD6     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+AC-A8-8E   (hex)		SHARP Corporation
+ACA88E     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+98-41-5C   (hex)		Nintendo Co.,Ltd
+98415C     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+F0-4F-7C   (hex)		Private
+F04F7C     (base 16)		Private
+
+70-54-25   (hex)		ARRIS Group, Inc.
+705425     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-0B-CA   (hex)		Tunstall Nordic AB
+5C0BCA     (base 16)		Tunstall Nordic AB
+				Agnesfridsvagen 113A
+				Malmo    21237
+				SE
+
+28-33-34   (hex)		Huawei Device Co., Ltd.
+283334     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F0-A2-25   (hex)		Private
+F0A225     (base 16)		Private
+
+50-A1-32   (hex)		Shenzhen MiaoMing  Intelligent Technology Co.,Ltd
+50A132     (base 16)		Shenzhen MiaoMing  Intelligent Technology Co.,Ltd
+				Chudong science and technology park, 111 shaxin road, tangxia town,
+				dongguan city  guangdong province  523710
+				CN
+
+80-78-71   (hex)		ASKEY COMPUTER CORP
+807871     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+4C-B1-CD   (hex)		Ruckus Wireless
+4CB1CD     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+F4-9C-12   (hex)		Structab AB
+F49C12     (base 16)		Structab AB
+				Slotsmöllan 14B
+				HALMSTAD    30231
+				SE
+
+88-51-7A   (hex)		HMD Global Oy
+88517A     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+AC-B3-B5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACB3B5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-3A-88   (hex)		Universal Global Scientific Industrial Co., Ltd.
+083A88     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Road, Sec.1,Tsao Tuen
+				Nan-Tou  Taiwan  54261
+				TW
+
+08-31-8B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+08318B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-B6-88   (hex)		PLANTRONICS, INC.
+F4B688     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+4C-7A-48   (hex)		Nippon Seiki (Europe) B.V.
+4C7A48     (base 16)		Nippon Seiki (Europe) B.V.
+				Antareslaan 27
+				Hoofddorp    2132
+				NL
+
+84-D1-5A   (hex)		TCT mobile ltd
+84D15A     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+04-7F-0E   (hex)		Barrot Technology Limited
+047F0E     (base 16)		Barrot Technology Limited
+				C7-1-1,East Area, No.2,Shangdi Xinxi Road, Haidian District
+				Beijing    100085
+				CN
+
+B8-F6-53   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+B8F653     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+60-AB-14   (hex)		LG Innotek
+60AB14     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+BC-62-D2   (hex)		Genexis International B.V.
+BC62D2     (base 16)		Genexis International B.V.
+				Waldfeuchterbaan 124
+				Maria Hoop  Maria Hoop  6105 BP 
+				NL
+
+6C-9E-7C   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+6C9E7C     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+44-D5-F2   (hex)		IEEE Registration Authority
+44D5F2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-0C-86   (hex)		Cisco Systems, Inc
+000C86     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F8-3C-BF   (hex)		BOTATO ELECTRONICS SDN BHD
+F83CBF     (base 16)		BOTATO ELECTRONICS SDN BHD
+				c-1-2, JALAN BK5A/2B 47180,BANDAR KINRARA
+				PUCHONG  SELANGOR  47180
+				MY
+
+FC-58-9A   (hex)		Cisco Systems, Inc
+FC589A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F0-86-20   (hex)		Arcadyan Corporation
+F08620     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+DC-CC-8D   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+DCCC8D     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+F0-5C-77   (hex)		Google, Inc.
+F05C77     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+11-11-11   (hex)		Private
+111111     (base 16)		Private
+
+6C-D7-1F   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+6CD71F     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+F0-68-65   (hex)		Taicang T&W Electronics
+F06865     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+A4-63-A1   (hex)		Inventus Power Eletronica do Brasil LTDA
+A463A1     (base 16)		Inventus Power Eletronica do Brasil LTDA
+				Av Buriti, 4285 Distrito Industrial
+				Manaus  Amazonas  69075000
+				BR
+
+3C-9D-56   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C9D56     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-FD-45   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70FD45     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-67-47   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+446747     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-4A-70   (hex)		Wacom Co.,Ltd.
+884A70     (base 16)		Wacom Co.,Ltd.
+				Sumitomo Fudosan Shinjuku Grand Tower 31F,8-17-1
+				Nishi-shinjuku,Shinjuku-ku  Tokyo  160-6131
+				JP
+
+F4-B5-BB   (hex)		CERAGON NETWORKS
+F4B5BB     (base 16)		CERAGON NETWORKS
+				24 RAUEL WALLENBERG STREET
+				TEL-AVIV    96719
+				IL
+
+50-7A-C5   (hex)		Apple, Inc.
+507AC5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-6B-E8   (hex)		Apple, Inc.
+4C6BE8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-86-1E   (hex)		Apple, Inc.
+8C861E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-2B-8D   (hex)		Apple, Inc.
+542B8D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1D-29   (hex)		Doro AB
+001D29     (base 16)		Doro AB
+				Magistratsvägen 10
+				Lund    226 43
+				SE
+
+EC-A5-DE   (hex)		ONYX WIFI Inc
+ECA5DE     (base 16)		ONYX WIFI Inc
+				9891 Irvine Center Drive, Suite 200
+				Irvine    92618
+				US
+
+8C-49-62   (hex)		Roku, Inc
+8C4962     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+10-33-BF   (hex)		Technicolor CH USA Inc.
+1033BF     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+34-75-63   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+347563     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+14-2E-5E   (hex)		Sercomm Corporation.
+142E5E     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+00-25-CB   (hex)		Reiner SCT
+0025CB     (base 16)		Reiner SCT
+				Reiner Kartengeräte GmbH & Co. KG.
+				Furtwangen    78120
+				DE
+
+44-23-7C   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+44237C     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+C0-64-E4   (hex)		Cisco Systems, Inc
+C064E4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-80-4A   (hex)		Quectel Wireless Solutions Co., Ltd.
+50804A     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+30-94-35   (hex)		vivo Mobile Communication Co., Ltd.
+309435     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+D4-4B-B6   (hex)		Zhejiang Tmall Technology Co., Ltd.
+D44BB6     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+38-18-4C   (hex)		Sony Home Entertainment&Sound Products Inc
+38184C     (base 16)		Sony Home Entertainment&Sound Products Inc
+				Sony City Osaki 2-10-1 Osaki Shinagawa-ku
+				Tokyo  Japan  141-8610
+				JP
+
+D8-2F-E6   (hex)		Zhejiang Tmall Technology Co., Ltd.
+D82FE6     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+14-0F-42   (hex)		Nokia
+140F42     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-6D-61   (hex)		Guangzhou V-SOLUTION Electronic Technology Co., Ltd.
+006D61     (base 16)		Guangzhou V-SOLUTION Electronic Technology Co., Ltd.
+				Room 601,Originality Building B2, NO.162 Science Avenue,Science Town
+				Guangzhou  Guangdong  510663
+				CN
+
+C4-AC-59   (hex)		Murata Manufacturing Co., Ltd.
+C4AC59     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+58-16-D7   (hex)		ALPS ELECTRIC CO., LTD.
+5816D7     (base 16)		ALPS ELECTRIC CO., LTD.
+				nishida  6-1 
+				Kakuda-City  Miyagi-Pref  981-1595
+				JP
+
+FC-A4-7A   (hex)		IEEE Registration Authority
+FCA47A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E4-19-C1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E419C1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B8-66-85   (hex)		Sagemcom Broadband SAS
+B86685     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+38-1A-52   (hex)		Seiko Epson Corporation
+381A52     (base 16)		Seiko Epson Corporation
+				2070 Kotobuki Koaka
+				Matsumoto-shi  Nagano-ken  399-8702
+				JP
+
+00-0A-17   (hex)		NESTAR COMMUNICATIONS, INC
+000A17     (base 16)		NESTAR COMMUNICATIONS, INC
+				No.6,19 Lane Bade Road
+				HSINCHU    300
+				TW
+
+D8-AF-81   (hex)		   ZAO NPK Rotek
+D8AF81     (base 16)		   ZAO NPK Rotek
+				Filippovskiy per., 8/1
+				Moscow    119019
+				RU
+
+E4-FD-A1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4FDA1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-52-A9   (hex)		Texas Instruments
+B452A9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+54-EF-44   (hex)		Lumi United Technology Co., Ltd
+54EF44     (base 16)		Lumi United Technology Co., Ltd
+				8th Floor, JinQi Wisdom Valley, No.1 TangLing Road, LinXian Ave, Taoyuan Residential District,Nanshan District
+				ShenZhen  GuangDong  518055
+				CN
+
+40-2B-50   (hex)		ARRIS Group, Inc.
+402B50     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+78-CC-2B   (hex)		SINEWY TECHNOLOGY CO., LTD
+78CC2B     (base 16)		SINEWY TECHNOLOGY CO., LTD
+				2F., No.179, Dongmin Rd.
+				Toufen City, Miaoli County    351
+				TW
+
+B8-07-56   (hex)		Cisco Meraki
+B80756     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+D0-C8-57   (hex)		IEEE Registration Authority
+D0C857     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+FC-BC-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FCBCD1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+74-60-FA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7460FA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+CC-3A-DF   (hex)		Private
+CC3ADF     (base 16)		Private
+
+38-EF-E3   (hex)		 INGENICO TERMINALS SAS
+38EFE3     (base 16)		 INGENICO TERMINALS SAS
+				28-32 BOULEVARD DE GRENELLE
+				PARIS    75015
+				FR
+
+50-D4-F7   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+50D4F7     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1F-47   (hex)		MCS Logic Inc.
+001F47     (base 16)		MCS Logic Inc.
+				6F. Samho Center B Bldg., 275-6
+				Seoul    137-941
+				KR
+
+8C-FD-18   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8CFD18     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+B4-54-59   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+B45459     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+00-09-70   (hex)		Vibration Research Corporation
+000970     (base 16)		Vibration Research Corporation
+				2385 Wilshere Drive
+				Jenison  MI  49428
+				US
+
+14-A2-A0   (hex)		Cisco Systems, Inc
+14A2A0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E4-AB-89   (hex)		MitraStar Technology Corp.
+E4AB89     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+78-C3-13   (hex)		China Mobile Group Device Co.,Ltd.
+78C313     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+74-34-AE   (hex)		this is engineering Inc.
+7434AE     (base 16)		this is engineering Inc.
+				352, 815 Daewangpangyo-ro, Sujeong-gu
+				Seongnam-si  Gyeonggi-do  13449
+				KR
+
+74-AD-B7   (hex)		China Mobile Group Device Co.,Ltd.
+74ADB7     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street
+				Beijing    100053
+				CN
+
+60-95-CE   (hex)		IEEE Registration Authority
+6095CE     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-E5-C0   (hex)		Samsung Electronics Co.,Ltd
+8CE5C0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-8A-76   (hex)		Samsung Electronics Co.,Ltd
+F08A76     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+EC-AA-25   (hex)		Samsung Electronics Co.,Ltd
+ECAA25     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+68-7D-6B   (hex)		Samsung Electronics Co.,Ltd
+687D6B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+48-51-69   (hex)		Samsung Electronics Co.,Ltd
+485169     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-06-83   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C40683     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+94-D0-0D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94D00D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+C4-8A-5A   (hex)		JFCONTROL
+C48A5A     (base 16)		JFCONTROL
+				1449-37 Seoburo
+				Suwon  Gyunggi-do  16643
+				KR
+
+B4-9A-95   (hex)		Shenzhen Boomtech Industrial Corporation
+B49A95     (base 16)		Shenzhen Boomtech Industrial Corporation
+				2F, Block E, Bao'an Intelligent Valley, Yingtian Road No.4 Xixiang Sub-District Office, Bao'an District
+				Shenzhen  Guangdong  518102
+				CN
+
+AC-83-E9   (hex)		Beijing Zile Technology Co., Ltd
+AC83E9     (base 16)		Beijing Zile Technology Co., Ltd
+				Tecent WeWork, Huilongguan East Avenue, Changping District
+				Beijing  Beijing  100096
+				CN
+
+D8-CA-06   (hex)		Titan DataCenters France
+D8CA06     (base 16)		Titan DataCenters France
+				E.SpacePark 45 Allee des ormes
+				mougins    06250
+				FR
+
+1C-20-DB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C20DB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-C6-5B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D0C65B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-78-B2   (hex)		Xiaomi Communications Co Ltd
+9078B2     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+B4-CF-E0   (hex)		Sichuan tianyi kanghe communications co., LTD
+B4CFE0     (base 16)		Sichuan tianyi kanghe communications co., LTD
+				No.198, section 1, xueshan avenue, jinyuan town, dayi county
+				chengdu  sichuan  611330
+				CN
+
+BC-7F-A4   (hex)		Xiaomi Communications Co Ltd
+BC7FA4     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+FC-49-2D   (hex)		Amazon Technologies Inc.
+FC492D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+74-EE-2A   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+74EE2A     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+08-7E-64   (hex)		Technicolor CH USA Inc.
+087E64     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+08-00-39   (hex)		SPIDER SYSTEMS LIMITED
+080039     (base 16)		SPIDER SYSTEMS LIMITED
+				SPIDER PARK
+				    SCOTLAND
+				GB
+
+90-47-3C   (hex)		China Mobile Group Device Co.,Ltd.
+90473C     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+88-9E-33   (hex)		TCT mobile ltd
+889E33     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+6C-8A-EC   (hex)		Nantong Coship Electronics Co., Ltd.
+6C8AEC     (base 16)		Nantong Coship Electronics Co., Ltd.
+				No.188 Xinsheng Road
+				Nantong  Jiangsu  226001
+				CN
+
+84-C2-E4   (hex)		Jiangsu Qinheng Co., Ltd.
+84C2E4     (base 16)		Jiangsu Qinheng Co., Ltd.
+				No. 18, Ningshuang Road
+				Nanjing  Jiangsu  210012
+				CN
+
+7C-21-D8   (hex)		Shenzhen Think Will Communication Technology co., LTD.
+7C21D8     (base 16)		Shenzhen Think Will Communication Technology co., LTD.
+				16F,Block A,Central Plaza,No.2002,Baoyuan Rd.,Baoan District
+				Shenzhen    518101
+				CN
+
+FC-EA-50   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+FCEA50     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+00-E0-6B   (hex)		W&G SPECIAL PRODUCTS
+00E06B     (base 16)		W&G SPECIAL PRODUCTS
+				SCEINCE PARK EINDHOVIN 5049
+				    
+				NL
+
+04-5C-6C   (hex)		Juniper Networks
+045C6C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+D8-F1-5B   (hex)		Espressif Inc.
+D8F15B     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+D4-F0-57   (hex)		Nintendo Co.,Ltd
+D4F057     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+6C-F1-7E   (hex)		Zhejiang Uniview Technologies Co.,Ltd.
+6CF17E     (base 16)		Zhejiang Uniview Technologies Co.,Ltd.
+				No.88,Jiangling Road
+				Hangzhou  Zhejiang,P.R.China  310051
+				CN
+
+08-3A-2F   (hex)		Guangzhou Juan Intelligent Tech Joint Stock Co.,Ltd
+083A2F     (base 16)		Guangzhou Juan Intelligent Tech Joint Stock Co.,Ltd
+				NO.9, street 3, HengLing industrial zone, Tangdong, tianhe district
+				Guangzhou  Guangdong  CN 510000
+				CN
+
+1C-3A-60   (hex)		Ruckus Wireless
+1C3A60     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+D4-35-1D   (hex)		Technicolor
+D4351D     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+60-09-C3   (hex)		u-blox AG
+6009C3     (base 16)		u-blox AG
+				Zuercherstrasse 68
+				Thalwil    8800
+				CH
+
+48-87-64   (hex)		vivo Mobile Communication Co., Ltd.
+488764     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+5C-1C-B9   (hex)		vivo Mobile Communication Co., Ltd.
+5C1CB9     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+C0-FD-84   (hex)		zte corporation
+C0FD84     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-4B-7E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+444B7E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+DC-8C-37   (hex)		Cisco Systems, Inc
+DC8C37     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E8-D0-FC   (hex)		Liteon Technology Corporation
+E8D0FC     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+E8-E8-B7   (hex)		Murata Manufacturing Co., Ltd.
+E8E8B7     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto   617-8555
+				JP
+
+10-3D-3E   (hex)		China Mobile Group Device Co.,Ltd.
+103D3E     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+7C-50-DA   (hex)		Private
+7C50DA     (base 16)		Private
+
+64-CC-22   (hex)		Arcadyan Corporation
+64CC22     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+4C-91-57   (hex)		Fujian LANDI Commercial Equipment Co.,Ltd
+4C9157     (base 16)		Fujian LANDI Commercial Equipment Co.,Ltd
+				Building 17,the 1st Section ,Fuzhou Software Park
+				No.89 Software Road   Fuzhou ,Fujian  350003
+				CN
+
+9C-25-BE   (hex)		Wildlife Acoustics, Inc.
+9C25BE     (base 16)		Wildlife Acoustics, Inc.
+				3 Mill and Main Place, Suite 210
+				MAYNARD  MA  01754
+				US
+
+D0-39-EA   (hex)		NetApp
+D039EA     (base 16)		NetApp
+				1395 Crossman Ave
+				Sunnyvale,  CA  94089
+				US
+
+F8-DF-E1   (hex)		MyLight Systems
+F8DFE1     (base 16)		MyLight Systems
+				290 rue Ferdinand Perrier
+				Saint Priest    69800
+				FR
+
+60-D2-DD   (hex)		Shenzhen Baitong Putian Technology Co.,Ltd.
+60D2DD     (base 16)		Shenzhen Baitong Putian Technology Co.,Ltd.
+				501,5/F,Building 1,No.2,Lianwei Street,Hualian Community,Longhua Street Longhua District
+				Shenzhen  Guangdong  518109
+				CN
+
+78-8C-77   (hex)		LEXMARK INTERNATIONAL, INC.
+788C77     (base 16)		LEXMARK INTERNATIONAL, INC.
+				740 NEW CIRCLE ROAD
+				LEXINGTON  KY  40550
+				US
+
+3C-0C-7D   (hex)		Tiny Mesh AS
+3C0C7D     (base 16)		Tiny Mesh AS
+				Elisabeth von Hübschs gate 6
+				MOSS    1534
+				NO
+
+34-76-C5   (hex)		I-O DATA DEVICE,INC.
+3476C5     (base 16)		I-O DATA DEVICE,INC.
+				3-10, SAKURADA-MACHI
+				KANAZAWA  ISHIKAWA  920-8512
+				JP
+
+24-DA-33   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24DA33     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+FC-AB-90   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FCAB90     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-93-D8   (hex)		Texas Instruments
+5893D8     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+50-51-A9   (hex)		Texas Instruments
+5051A9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A4-97-5C   (hex)		VTech Telecommunications Ltd.
+A4975C     (base 16)		VTech Telecommunications Ltd.
+				23/F,Tai Ping Industrial Centre ,Block 1
+				Hong Kong    000000
+				CN
+
+B0-2A-1F   (hex)		 Wingtech Group (HongKong）Limited
+B02A1F     (base 16)		 Wingtech Group (HongKong）Limited
+				 FLAT/RM 1903 19/F PODIUM PLAZA 5HANOI ROAD TSIM SHA TSUI
+				Hong Kong  Hong Kong  999077
+				HK
+
+DC-68-0C   (hex)		Hewlett Packard Enterprise
+DC680C     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F4-02-70   (hex)		Dell Inc.
+F40270     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+1C-27-04   (hex)		zte corporation
+1C2704     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+50-78-B3   (hex)		zte corporation
+5078B3     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-D4-F7   (hex)		varram system
+F0D4F7     (base 16)		varram system
+				57, TECHNO 11-RO,YUSEONG-GU, DAEJEON, KOREA 
+				DAEJEON    34036
+				KR
+
+E0-CC-7A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E0CC7A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+6C-23-CB   (hex)		Wattty Corporation
+6C23CB     (base 16)		Wattty Corporation
+				2-15-31 takaokanishi nakaku
+				hamamatsushi  shizuokaken  4338118
+				JP
+
+60-AB-67   (hex)		Xiaomi Communications Co Ltd
+60AB67     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+AC-71-0C   (hex)		China Mobile Group Device Co.,Ltd.
+AC710C     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+A8-DB-03   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+A8DB03     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+30-89-44   (hex)		DEVA Broadcast Ltd.
+308944     (base 16)		DEVA Broadcast Ltd.
+				Alexander Stamboliyski 65
+				Burgas  Burgas  8000
+				BG
+
+F4-79-60   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F47960     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-52-90   (hex)		KNS Group LLC (YADRO Company)
+145290     (base 16)		KNS Group LLC (YADRO Company)
+				Spartakovskaya sq., 14, bl. 1
+				Moscow    105082
+				RU
+
+5C-32-C5   (hex)		Teracom Ltd.
+5C32C5     (base 16)		Teracom Ltd.
+				11 Vasil Levski blvd.
+				Ruse    7019
+				BG
+
+AC-EE-70   (hex)		Fontem Ventures BV
+ACEE70     (base 16)		Fontem Ventures BV
+				Motion Building 8F, Radarweg 60
+				Amsterdam  Noord-Holland  1043NT
+				NL
+
+AC-E2-D3   (hex)		Hewlett Packard
+ACE2D3     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+00-FD-22   (hex)		Cisco Systems, Inc
+00FD22     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-18-FD   (hex)		Apple, Inc.
+4418FD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-B6-00   (hex)		VOIM Co., Ltd.
+00B600     (base 16)		VOIM Co., Ltd.
+				70, Seotan-ro, Jinwi-myeon
+				Pyeongtaek-si  Gyeonggi-do  17706
+				KR
+
+98-FA-9B   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+98FA9B     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+00-5B-94   (hex)		Apple, Inc.
+005B94     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-89-7E   (hex)		Apple, Inc.
+E0897E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-0C-D1   (hex)		Hewlett Packard
+B00CD1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+48-46-C1   (hex)		FN-LINK TECHNOLOGY LIMITED
+4846C1     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+B4-D0-A9   (hex)		China Mobile Group Device Co.,Ltd.
+B4D0A9     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+FC-29-F3   (hex)		McPay Co.,LTD.
+FC29F3     (base 16)		McPay Co.,LTD.
+				No.801, 61, Digital-ro 31-gil, Guro-gu
+				Seoul    08375
+				KR
+
+F8-AF-DB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F8AFDB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+A0-BD-1D   (hex)		Zhejiang Dahua Technology Co., Ltd.
+A0BD1D     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+E4-9F-1E   (hex)		ARRIS Group, Inc.
+E49F1E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-15   (hex)		Teracom Limited
+002615     (base 16)		Teracom Limited
+				B-84
+				Noida  Uttar Pradesh  201301
+				IN
+
+9C-8E-DC   (hex)		Teracom Limited
+9C8EDC     (base 16)		Teracom Limited
+				123456
+				Noida  Uttar Pradesh  201301
+				IN
+
+00-01-91   (hex)		SYRED Data Systems
+000191     (base 16)		SYRED Data Systems
+				272 Lanes Mill Road
+				Howell  NJ  07731
+				US
+
+AC-D5-64   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+ACD564     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+94-D0-75   (hex)		CIS Crypto
+94D075     (base 16)		CIS Crypto
+				Nauchnyy proezd 6
+				Moscow    117246
+				RU
+
+28-B4-FB   (hex)		Sprocomm Technologies CO.,LTD.
+28B4FB     (base 16)		Sprocomm Technologies CO.,LTD.
+				5D F1.6 Block,Tianfa Building,Tianan Chegongmiao Industrial park,Futian Dist
+				shenzhen  guangdong  518000
+				CN
+
+40-F9-D5   (hex)		Tecore Networks
+40F9D5     (base 16)		Tecore Networks
+				7030 Hi Tech Drive
+				Hanover  MD  21076
+				US
+
+CC-2C-83   (hex)		DarkMatter L.L.C
+CC2C83     (base 16)		DarkMatter L.L.C
+				Level 15, Aldar HQ
+				Abu Dhabi    27655
+				AE
+
+DC-ED-84   (hex)		Haverford Systems Inc
+DCED84     (base 16)		Haverford Systems Inc
+				152 Robbins Road
+				Downingtown  PA  19335
+				US
+
+7C-57-3C   (hex)		Aruba, a Hewlett Packard Enterprise Company
+7C573C     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+2C-01-B5   (hex)		Cisco Systems, Inc
+2C01B5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+28-EF-01   (hex)		Private
+28EF01     (base 16)		Private
+
+C0-53-36   (hex)		Beijing National Railway Research & Design Institute of Signal & Communication Group Co..Ltd.
+C05336     (base 16)		Beijing National Railway Research & Design Institute of Signal & Communication Group Co..Ltd.
+				7 floor, No.1 Automobile Museum South Road, Fengtai Science and Technology Park,
+				Beijing  Beijing  100070
+				CN
+
+60-6E-D0   (hex)		SEAL AG
+606ED0     (base 16)		SEAL AG
+				Landstrasse 176
+				Wettingen    5430
+				CH
+
+2C-CC-E6   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+2CCCE6     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-4C-C7   (hex)		IEEE Registration Authority
+E44CC7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D4-E8-80   (hex)		Cisco Systems, Inc
+D4E880     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A8-34-6A   (hex)		Samsung Electronics Co.,Ltd
+A8346A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-20-F6   (hex)		Samsung Electronics Co.,Ltd
+3C20F6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-38-AD   (hex)		Samsung Electronics Co.,Ltd
+7C38AD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-9C-DD   (hex)		AMPAK Technology,Inc.
+D49CDD     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+50-F7-22   (hex)		Cisco Systems, Inc
+50F722     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+98-49-E1   (hex)		Boeing Defence Australia
+9849E1     (base 16)		Boeing Defence Australia
+				GPO Box 767
+				Brisbane  Queensland  4001
+				AU
+
+04-D7-A5   (hex)		New H3C Technologies Co., Ltd
+04D7A5     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+4C-4D-66   (hex)		Nanjing Jiahao Technology Co., Ltd.
+4C4D66     (base 16)		Nanjing Jiahao Technology Co., Ltd.
+				Moling Industrial Park, Development Zone, Jiangning, Nanjing
+				Nanjing  Jiangsu  211111
+				CN
+
+A4-81-7A   (hex)		CIG SHANGHAI CO LTD
+A4817A     (base 16)		CIG SHANGHAI CO LTD
+				5th Floor, Building 8 No 2388 Chenhang Road
+				SHANGHAI    201114
+				CN
+
+90-58-51   (hex)		Technicolor CH USA Inc.
+905851     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+98-09-CF   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+9809CF     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+B8-DE-5E   (hex)		LONGCHEER TELECOMMUNICATION LIMITED
+B8DE5E     (base 16)		LONGCHEER TELECOMMUNICATION LIMITED
+				Building 1,No.401,Caobao Rd
+				Shanghai  Xuhui District  200233
+				CN
+
+88-5A-06   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+885A06     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+54-47-D3   (hex)		TSAT AS
+5447D3     (base 16)		TSAT AS
+				Martin Linges v 25
+				Fornebu    1364
+				NO
+
+CC-ED-DC   (hex)		MitraStar Technology Corp.
+CCEDDC     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+CC-D8-1F   (hex)		Maipu Communication Technology Co.,Ltd.
+CCD81F     (base 16)		Maipu Communication Technology Co.,Ltd.
+				Maipu Mansion, No.288 Tianfu 3rd Street, High-tech Zone
+				Chengdu  Sichuan  610094
+				CN
+
+68-8B-0F   (hex)		China Mobile IOT Company Limited
+688B0F     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+F8-2F-6A   (hex)		ITEL MOBILE LIMITED
+F82F6A     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+B0-68-E6   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+B068E6     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+A4-E7-E4   (hex)		Connex GmbH
+A4E7E4     (base 16)		Connex GmbH
+				Elbestrasse 12
+				Oldenburg    26135
+				DE
+
+B8-EF-8B   (hex)		SHENZHEN CANNICE TECHNOLOGY CO.,LTD
+B8EF8B     (base 16)		SHENZHEN CANNICE TECHNOLOGY CO.,LTD
+				F-20,7A,Baoneng Technology Park
+				Shenzhen  Guangdong  518109
+				CN
+
+B8-18-6F   (hex)		ORIENTAL MOTOR CO., LTD.
+B8186F     (base 16)		ORIENTAL MOTOR CO., LTD.
+				5-8-3 Tokodai
+				Tsukuba  Ibaraki  300-2635
+				JP
+
+00-1A-3F   (hex)		Intelbras
+001A3F     (base 16)		Intelbras
+				BR 101, km 210, S/N°
+				São José  Santa Catarina  88104800
+				BR
+
+C0-D8-34   (hex)		xvtec ltd
+C0D834     (base 16)		xvtec ltd
+				Ha'nagar 24
+				Hod Hasharon  Israel  4527713
+				IL
+
+B8-C2-53   (hex)		Juniper Networks
+B8C253     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F0-5C-19   (hex)		Aruba, a Hewlett Packard Enterprise Company
+F05C19     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+04-BD-88   (hex)		Aruba, a Hewlett Packard Enterprise Company
+04BD88     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+9C-1C-12   (hex)		Aruba, a Hewlett Packard Enterprise Company
+9C1C12     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+18-DF-B4   (hex)		BOSUNG POWERTEC CO.,LTD.
+18DFB4     (base 16)		BOSUNG POWERTEC CO.,LTD.
+				70, Daechang-gil, Judeok-eup
+				Chungju-si  Chungcheongbuk-do  27463
+				KR
+
+00-01-47   (hex)		Zhone Technologies
+000147     (base 16)		Zhone Technologies
+				7001 Oakport Street
+				Oakland  CA  94621
+				US
+
+20-B7-80   (hex)		Toshiba Visual Solutions Corporation Co.,Ltd
+20B780     (base 16)		Toshiba Visual Solutions Corporation Co.,Ltd
+				Shinkawasaki Mitsui Builing West Tower 19F, 1-1-2 Kashimada
+				Saiwai-ku, Kawasaki-shi  Kanagawa  212-0058
+				JP
+
+E0-37-17   (hex)		Technicolor CH USA Inc.
+E03717     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+14-D4-FE   (hex)		ARRIS Group, Inc.
+14D4FE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+30-4F-75   (hex)		DASAN Network Solutions
+304F75     (base 16)		DASAN Network Solutions
+				DASAN Tower 8F, 49 Daewangpangyo-ro644beon-gil Bundang-gu
+				Seongnam-si  Gyeonggi-do  13493
+				KR
+
+EC-A9-FA   (hex)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+ECA9FA     (base 16)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+				#126,BBK Road,Wusha,Chang'An
+				Dong Guan  Guang Dong  523860
+				CN
+
+00-03-A5   (hex)		Medea Corporation
+0003A5     (base 16)		Medea Corporation
+				5701 Lindero Canyon Rd.
+				Wetlake Village  CA  91362
+				US
+
+BC-E6-7C   (hex)		Cambium Networks Limited
+BCE67C     (base 16)		Cambium Networks Limited
+				Unit B2, Linhay Business Park,
+				Ashburton  Devon  TQ13 7UP
+				GB
+
+7C-1E-06   (hex)		New H3C Technologies Co., Ltd
+7C1E06     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+F0-B3-1E   (hex)		Universal Electronics, Inc.
+F0B31E     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+F8-91-73   (hex)		AEDLE SAS
+F89173     (base 16)		AEDLE SAS
+				11 Rue Campagne Première, Cour Intérieure, Entresol, CODE 13B80
+				Paris  IDF  75014
+				FR
+
+C8-4F-86   (hex)		Sophos Ltd
+C84F86     (base 16)		Sophos Ltd
+				The Pentagon
+				Abingdon  Oxfordshire  OX14 3YP
+				GB
+
+64-29-ED   (hex)		AO PKK Milandr
+6429ED     (base 16)		AO PKK Milandr
+				Gergievsky prospekt, 5
+				Zelenograd  Moscow  124498
+				RU
+
+44-3C-88   (hex)		FICOSA MAROC INTERNATIONAL
+443C88     (base 16)		FICOSA MAROC INTERNATIONAL
+				Zone Franche Technopolis Rocade Rabat-Salé 11103 Sala Al Jadida - Salé
+				Salé    11103
+				MA
+
+84-1C-70   (hex)		zte corporation
+841C70     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+54-47-41   (hex)		XCHENG HOLDING
+544741     (base 16)		XCHENG HOLDING
+				ROOM 401F, Building 5, No.3000 LONG DONG Avenue, Pudong New District
+				 Shanghai    201203
+				CN
+
+CC-F7-35   (hex)		Amazon Technologies Inc.
+CCF735     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+C4-F8-39   (hex)		Actia Automotive
+C4F839     (base 16)		Actia Automotive
+				5 rue Jorge Semprun
+				TOULOUSE    31400
+				FR
+
+C8-F7-42   (hex)		HangZhou Gubei Electronics Technology Co.,Ltd
+C8F742     (base 16)		HangZhou Gubei Electronics Technology Co.,Ltd
+				Room 106, No.611 Jianghong Road, Binjiang District, Hangzhou, Zhejiang, China
+				Hangzhou  ZheJiang  310052
+				CN
+
+00-6F-F2   (hex)		MITSUMI ELECTRIC CO.,LTD.
+006FF2     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+30-DF-8D   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+30DF8D     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+D4-C9-3C   (hex)		Cisco Systems, Inc
+D4C93C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+78-DD-12   (hex)		Arcadyan Corporation
+78DD12     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+2C-5D-34   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+2C5D34     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+9C-14-63   (hex)		Zhejiang Dahua Technology Co., Ltd.
+9C1463     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+00-24-33   (hex)		ALPS ELECTRIC CO., LTD.
+002433     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+00-23-06   (hex)		ALPS ELECTRIC CO., LTD.
+002306     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+B4-EC-02   (hex)		ALPS ELECTRIC CO., LTD.
+B4EC02     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+64-60-38   (hex)		Hirschmann Automation and Control GmbH
+646038     (base 16)		Hirschmann Automation and Control GmbH
+				Stuttgarter Straße 45-51
+				Neckartenzlingen    D-72654
+				DE
+
+70-18-A7   (hex)		Cisco Systems, Inc
+7018A7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-D3-9D   (hex)		IEEE Registration Authority
+CCD39D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E0-75-0A   (hex)		ALPS ELECTRIC CO., LTD.
+E0750A     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				kakuda-City    981-1595
+				US
+
+00-19-C1   (hex)		ALPS ELECTRIC CO., LTD.
+0019C1     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+00-16-FE   (hex)		ALPS ELECTRIC CO., LTD.
+0016FE     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+9C-8D-7C   (hex)		ALPS ELECTRIC CO., LTD.
+9C8D7C     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+D4-25-CC   (hex)		IEEE Registration Authority
+D425CC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-6D-C4   (hex)		Megapixel VR
+8C6DC4     (base 16)		Megapixel VR
+				340 S. Lemon Ave
+				Walnut  CA  91789
+				US
+
+BC-75-36   (hex)		ALPS ELECTRIC CO., LTD.
+BC7536     (base 16)		ALPS ELECTRIC CO., LTD.
+				nishida  6-1 
+				Kakuda-City  Miyagi-Pref  981-1595
+				JP
+
+E0-AE-5E   (hex)		ALPS ELECTRIC CO., LTD.
+E0AE5E     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-3-36 Furukawanakazato,
+				Osaki  Miyagi-pref  989-6181
+				JP
+
+D4-B7-61   (hex)		Sichuan AI-Link Technology Co., Ltd.
+D4B761     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+7C-03-5E   (hex)		Xiaomi Communications Co Ltd
+7C035E     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+44-FE-3B   (hex)		Arcadyan Corporation
+44FE3B     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+D8-3A-F5   (hex)		Wideband Labs LLC
+D83AF5     (base 16)		Wideband Labs LLC
+				1027 S Main Street, STE 330
+				Joplin  MO  64801
+				US
+
+38-D9-A5   (hex)		Mikotek Information Inc. 
+38D9A5     (base 16)		Mikotek Information Inc. 
+				3F, No. 20, Aly. 18, Ln. 478, Ruiguang Rd.
+				Taipei    114
+				TW
+
+4C-87-5D   (hex)		Bose Corporation
+4C875D     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+B0-E7-DE   (hex)		Homa Technologies JSC
+B0E7DE     (base 16)		Homa Technologies JSC
+				Building 5, Quang Trung Software City, District 12
+				Ho Chi Minh    729226
+				VN
+
+64-9D-99   (hex)		FS COM INC
+649D99     (base 16)		FS COM INC
+				380 Centerpoint Blvd New Castle
+				New Castle  DE  19720
+				US
+
+00-16-9D   (hex)		Cisco Systems, Inc
+00169D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+4C-96-2D   (hex)		Fresh AB
+4C962D     (base 16)		Fresh AB
+				Gransholmsvägen 136
+				Gemla    35599
+				SE
+
+00-D2-79   (hex)		VINGROUP JOINT STOCK COMPANY
+00D279     (base 16)		VINGROUP JOINT STOCK COMPANY
+				Number 7, Bang Lang 1 street, Long Bien district
+				Ha Noi  Ha Noi  100000
+				VN
+
+48-4A-30   (hex)		George Robotics Limited
+484A30     (base 16)		George Robotics Limited
+				Salisbury House, Station Road
+				Cambridge    CB1 2LA
+				GB
+
+48-61-A3   (hex)		Concern Axion JSC
+4861A3     (base 16)		Concern Axion JSC
+				90, M. Gorkogo St.
+				Izhevsk  Udmurt Republic  426000
+				RU
+
+30-4A-26   (hex)		Shenzhen Trolink Technology CO, LTD
+304A26     (base 16)		Shenzhen Trolink Technology CO, LTD
+				201 B building 4 shijie, Chashu industry 505 block, Baoan airport Sanwei community, Hangcheng street Baoan area.
+				Shenzhen  GuangDong  518000
+				CN
+
+4C-E5-AE   (hex)		Tianjin Beebox Intelligent Technology Co.,Ltd.
+4CE5AE     (base 16)		Tianjin Beebox Intelligent Technology Co.,Ltd.
+				Room 103，NO.1 of the 2nd Street
+				Tianjin Pilot Free Trade Zone Airport EconomicArea  Airport International Logistics Zone, Tianjin  300300
+				CN
+
+E4-D3-AA   (hex)		FUJITSU CONNECTED TECHNOLOGIES LIMITED
+E4D3AA     (base 16)		FUJITSU CONNECTED TECHNOLOGIES LIMITED
+				4-1-1, Kamikodanaka, Nakahara-ku
+				Kawasaki  Kanagawa  2118588
+				JP
+
+D4-67-D3   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+D467D3     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+A4-12-32   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A41232     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+48-E3-C3   (hex)		JENOPTIK Advanced Systems GmbH
+48E3C3     (base 16)		JENOPTIK Advanced Systems GmbH
+				Feldstrasse 155
+				Wedel  Schleswig-Holstein  22880
+				DE
+
+CC-35-5A   (hex)		SecuGen Corporation
+CC355A     (base 16)		SecuGen Corporation
+				2065 Martin Ave, Suite 108
+				Santa Clara  CA  95050
+				US
+
+80-54-6A   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+80546A     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+B4-47-F5   (hex)		Earda Technologies co Ltd
+B447F5     (base 16)		Earda Technologies co Ltd
+				Block A,Lianfeng Creative Park, #2 Jisheng Rd., Nansha District
+				Guangzhou  Guangdong  511455
+				CN
+
+F4-C7-C8   (hex)		Kelvin Inc.
+F4C7C8     (base 16)		Kelvin Inc.
+				400 Centennial Parkway, Suite 190
+				Louisville  CO  80027
+				US
+
+A8-9C-A4   (hex)		Furrion Limited
+A89CA4     (base 16)		Furrion Limited
+				Units 503C & 505-508, Level 5, Core D, Cyberport 3, 100 Cyberport Road
+				Hong Kong    00000
+				HK
+
+00-00-4C   (hex)		NEC Corporation
+00004C     (base 16)		NEC Corporation
+				7-1 SHIBA  5-CHOME
+				TOKYO 108-01    0000
+				JP
+
+8C-CF-8F   (hex)		ITC Systems
+8CCF8F     (base 16)		ITC Systems
+				800 Fee Fee Road
+				St Louis  MO  63043
+				US
+
+28-75-D8   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+2875D8     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building, Star-net Science Plaza, Juyuanzhou,
+				FUZHOU  FUJIAN  350002
+				CN
+
+90-E2-02   (hex)		Texas Instruments
+90E202     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+30-24-78   (hex)		Sagemcom Broadband SAS
+302478     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+7C-89-C1   (hex)		Palo Alto Networks
+7C89C1     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+84-A9-3E   (hex)		Hewlett Packard
+84A93E     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+B0-C3-87   (hex)		GOEFER, Inc.
+B0C387     (base 16)		GOEFER, Inc.
+				118 N. Market St.
+				Frederick  MD  21701
+				US
+
+08-6B-D7   (hex)		Silicon Laboratories
+086BD7     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+34-93-42   (hex)		TTE Corporation
+349342     (base 16)		TTE Corporation
+				7/F, Building 22E 22 Science Park East Avenue Hong Kong Science Park Shatin, N.T.
+				Hong Kong    999077
+				HK
+
+58-9E-C6   (hex)		Gigaset Communications GmbH
+589EC6     (base 16)		Gigaset Communications GmbH
+				Frankenstrasse 2
+				Bocholt  NRW  46395
+				DE
+
+64-C7-53   (hex)		Apple, Inc.
+64C753     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-58-AD   (hex)		China Mobile IOT Company Limited
+6458AD     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+1C-F2-9A   (hex)		Google, Inc.
+1CF29A     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+74-8A-0D   (hex)		ARRIS Group, Inc.
+748A0D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+CC-75-E2   (hex)		ARRIS Group, Inc.
+CC75E2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A0-A3-B8   (hex)		WISCLOUD
+A0A3B8     (base 16)		WISCLOUD
+				Tech Park Xia Sha
+				Hangzhou  Zhejiang  310000
+				CN
+
+38-F9-D3   (hex)		Apple, Inc.
+38F9D3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-18-3C   (hex)		Apple, Inc.
+FC183C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-0C-66   (hex)		Shenzhen Colorful Yugong Technology and Development Co., Ltd.
+A40C66     (base 16)		Shenzhen Colorful Yugong Technology and Development Co., Ltd.
+				13F, Central Business Tower, No.88 Fuhua First Rd., Futian District, Shenzhen, Guangdong, China
+				Shenzhen  Guangdong  518000
+				CN
+
+44-55-B1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4455B1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+98-F9-C7   (hex)		IEEE Registration Authority
+98F9C7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+70-0B-4F   (hex)		Cisco Systems, Inc
+700B4F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E4-38-8C   (hex)		Digital Products Limited
+E4388C     (base 16)		Digital Products Limited
+				53 Clark Road
+				Rothesay  New Brunswick  E2E 2K9
+				CA
+
+18-4B-DF   (hex)		Caavo Inc
+184BDF     (base 16)		Caavo Inc
+				1525 McCarthy Blvd., #1182
+				Milpitas    95035
+				US
+
+B8-9A-9A   (hex)		Xin Shi Jia Technology (Beijing) Co.,Ltd
+B89A9A     (base 16)		Xin Shi Jia Technology (Beijing) Co.,Ltd
+				Room 1002, A Tower, Zhongguancun E World Wealth Center, No.11, Zhongguancun Street, Haidian District, Beijing City
+				Beijing  Beijing  100190
+				CN
+
+8C-7B-F0   (hex)		Xufeng Development Limited
+8C7BF0     (base 16)		Xufeng Development Limited
+				FLAT/RM1616 16F INTERATIONAL TRADE CENTRE 11-19 SHA TSUI RD TSUEN WAN
+				HongKong  HongKong  999077
+				HK
+
+E0-A5-09   (hex)		Bitmain Technologies Inc
+E0A509     (base 16)		Bitmain Technologies Inc
+				Building 25, North Olympic Science & Technology Park, Baosheng South Road, Haidian District, Beijing, China
+				Beijing  BEIJING  CHINA
+				CN
+
+3C-5C-C4   (hex)		Amazon Technologies Inc.
+3C5CC4     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+D8-A7-56   (hex)		Sagemcom Broadband SAS
+D8A756     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+D8-D6-F3   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+D8D6F3     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+6C-2C-DC   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+6C2CDC     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+78-35-A0   (hex)		Zurn Industries LLC
+7835A0     (base 16)		Zurn Industries LLC
+				1747 Commerce Way
+				Paso Robles  CA  93446
+				US
+
+F4-39-09   (hex)		Hewlett Packard
+F43909     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+20-1F-31   (hex)		Inteno Broadband Technology AB
+201F31     (base 16)		Inteno Broadband Technology AB
+				Stensätravägen 13
+				Skärholmen  SE  127 39 
+				SE
+
+2C-CC-44   (hex)		Sony Interactive Entertainment Inc.
+2CCC44     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+F4-7D-EF   (hex)		Samsung Electronics Co.,Ltd
+F47DEF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-8B-B5   (hex)		Samsung Electronics Co.,Ltd
+7C8BB5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-83-3A   (hex)		Zyxel Communications Corporation
+54833A     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+78-70-52   (hex)		Welotec GmbH
+787052     (base 16)		Welotec GmbH
+				zum Hagenbach 7
+				Laer  NRW  48366
+				DE
+
+D8-A9-8B   (hex)		Texas Instruments
+D8A98B     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-11-6C   (hex)		Nanwang Multimedia Inc.,Ltd
+00116C     (base 16)		Nanwang Multimedia Inc.,Ltd
+				Floor 12,Tianyuan Bldg,Wensan Rd#508
+				Hangzhou  Zhejiang  310013
+				CN
+
+10-B9-F7   (hex)		Niko-Servodan
+10B9F7     (base 16)		Niko-Servodan
+				Stenager 5
+				Sønderborg    6400
+				DK
+
+14-EF-CF   (hex)		SCHREDER
+14EFCF     (base 16)		SCHREDER
+				Rue Lusambo 67
+				Brussels    1190
+				BE
+
+38-30-F9   (hex)		LG Electronics (Mobile Communications)
+3830F9     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+A8-3F-A1   (hex)		IEEE Registration Authority
+A83FA1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+78-47-E3   (hex)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+7847E3     (base 16)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+				NO.198 FIRST SECTION,SNOW MOUNTAIN AVENUE, JINYUAN TOWN, DAYI COUNTY, 
+				CHENGDU  SICHUAN  611330
+				CN
+
+6C-9B-C0   (hex)		Chemoptics Inc.
+6C9BC0     (base 16)		Chemoptics Inc.
+				261, Techno 2-ro, Yuseong-gu
+				Daejeon    34026
+				KR
+
+F4-DB-E6   (hex)		Cisco Systems, Inc
+F4DBE6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-84-98   (hex)		Beijing Jiaoda Microunion Tech.Co.,Ltd.
+248498     (base 16)		Beijing Jiaoda Microunion Tech.Co.,Ltd.
+				4-5/F,89 Building, First Section No.44 Gaoliangqiao Xie Street, Haidian District, Beijing, China
+				Beijing  Beijing  100044
+				CN
+
+C0-74-AD   (hex)		Grandstream Networks, Inc.
+C074AD     (base 16)		Grandstream Networks, Inc.
+				1297 Beacon Street
+				Brookline  MA  02446
+				US
+
+F0-95-F1   (hex)		Carl Zeiss AG
+F095F1     (base 16)		Carl Zeiss AG
+				Carl-Zeiss-Straße 22
+				Oberkochen    73447
+				DE
+
+00-F4-8D   (hex)		Liteon Technology Corporation
+00F48D     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+70-2E-D9   (hex)		Guangzhou Shiyuan Electronics Co., Ltd.
+702ED9     (base 16)		Guangzhou Shiyuan Electronics Co., Ltd.
+				No.6, 4th Yunpu Road, Yunpu industry District
+				Gunagzhou  Guangdong  510530
+				CN
+
+70-19-2F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70192F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-C2-2F   (hex)		China Entropy Co., Ltd.
+10C22F     (base 16)		China Entropy Co., Ltd.
+				Haidian District
+				Beijing    100085
+				CN
+
+BC-38-65   (hex)		JWCNETWORKS
+BC3865     (base 16)		JWCNETWORKS
+				114, Gasan digital 2-ro, Geumcheon-gu,
+				Seoul    08506
+				KR
+
+04-EB-40   (hex)		Cisco Systems, Inc
+04EB40     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-A7-F1   (hex)		Qingdao Haier Technology Co.,Ltd
+18A7F1     (base 16)		Qingdao Haier Technology Co.,Ltd
+				Building A01,Haier Information Park, No.1 Haier Road,
+				Qingdao  Shandong  266101
+				CN
+
+90-E1-7B   (hex)		Apple, Inc.
+90E17B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-1C-79   (hex)		Apple, Inc.
+D81C79     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-E6-BA   (hex)		Apple, Inc.
+58E6BA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-E4-EE   (hex)		Wistron Neweb Corporation
+44E4EE     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+DC-41-E5   (hex)		Shenzhen Zhixin Data Service Co., Ltd.
+DC41E5     (base 16)		Shenzhen Zhixin Data Service Co., Ltd.
+				 Baoyuan Road F518 Fashion Creative Park F3 Blg208
+				Baoan District, Shenzhen  Guangdong  518101
+				CN
+
+00-A5-BF   (hex)		Cisco Systems, Inc
+00A5BF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-BA-E9   (hex)		QDIS
+C8BAE9     (base 16)		QDIS
+				#512, Buliding B, 168 GaSanDigital 1st, GeumChun-Gu
+				SEOUL    08507
+				KR
+
+18-01-F1   (hex)		Xiaomi Communications Co Ltd
+1801F1     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C4-4F-33   (hex)		Espressif Inc.
+C44F33     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+54-6A-D8   (hex)		Elster Water Metering
+546AD8     (base 16)		Elster Water Metering
+				Mas des Cavaliers II, 471 Rue Charles Nungesser 
+				Mauguio    34130
+				FR
+
+C0-84-7D   (hex)		AMPAK Technology, Inc.
+C0847D     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+04-09-A5   (hex)		HFR, Inc.
+0409A5     (base 16)		HFR, Inc.
+				5F, Hana EZ Tower
+				Sungnam-si  Kyunggi-do  463-870
+				KR
+
+94-91-7F   (hex)		ASKEY COMPUTER CORP
+94917F     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+9C-0C-DF   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+9C0CDF     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+24-21-24   (hex)		Nokia
+242124     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+94-9B-2C   (hex)		Extreme Networks, Inc.
+949B2C     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose    95119
+				US
+
+7C-D3-0A   (hex)		INVENTEC CORPORATION
+7CD30A     (base 16)		INVENTEC CORPORATION
+				Inventec Building, 66 Hou-Kang Street
+				Taipei    111
+				TW
+
+00-1E-33   (hex)		INVENTEC CORPORATION
+001E33     (base 16)		INVENTEC CORPORATION
+				Inventec Building, 66 Hou-Kang Street
+				Taipei    111
+				TW
+
+FC-1D-84   (hex)		Autobase
+FC1D84     (base 16)		Autobase
+				1201, Biz Center, SKnTechno Park, 124, Sagimakgol-ro, Jungwon-gu, Seongnam-si, Gyeonggi-do
+				Seongnam  Gyeonggi  462-721
+				KR
+
+18-AC-9E   (hex)		ITEL MOBILE LIMITED
+18AC9E     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+EC-84-B4   (hex)		CIG SHANGHAI CO LTD
+EC84B4     (base 16)		CIG SHANGHAI CO LTD
+				5th Floor, Building 8 No 2388 Chenhang Road
+				SHANGHAI    201114
+				CN
+
+00-D0-96   (hex)		3COM EUROPE LTD
+00D096     (base 16)		3COM EUROPE LTD
+				BOUNDARY WAY
+				vvvvv  UNITED  KINGDOM
+				GB
+
+00-26-54   (hex)		3COM
+002654     (base 16)		3COM
+				5353 Betsy Ross Drive
+				Santa Clara    95054-1162
+				US
+
+00-50-DA   (hex)		3COM
+0050DA     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-04-76   (hex)		3COM
+000476     (base 16)		3COM
+				5400 Bayfront Plaza
+				Santa Clara  CA  95052
+				US
+
+00-04-75   (hex)		3COM
+000475     (base 16)		3COM
+				5400 Bayfront Plaza
+				Santa Clara  CA  95052
+				US
+
+44-22-F1   (hex)		S.FAC, INC
+4422F1     (base 16)		S.FAC, INC
+				Bldg A203  Techno2 ro 187
+				Yuseong-Gu  Daejeon  34025
+				KR
+
+30-09-F9   (hex)		IEEE Registration Authority
+3009F9     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B4-DD-D0   (hex)		Continental Automotive Hungary Kft
+B4DDD0     (base 16)		Continental Automotive Hungary Kft
+				Napmátka u. 6.
+				Budapest  Pest  H-1106
+				HU
+
+48-F0-27   (hex)		Chengdu newifi Co.,Ltd
+48F027     (base 16)		Chengdu newifi Co.,Ltd
+				C11 Building 2001,No.219 ,2nd Tianhua Road,Hi-tech zone
+				Chengdu  Sichuan  610000
+				CN
+
+14-C6-97   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+14C697     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+7C-03-AB   (hex)		Xiaomi Communications Co Ltd
+7C03AB     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+DC-16-B2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC16B2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-FB-65   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24FB65     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-B5-27   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0CB527     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-2E-99   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+B42E99     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+34-2C-C4   (hex)		Compal Broadband Networks, Inc.
+342CC4     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+14-E9-B2   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+14E9B2     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+C8-54-4B   (hex)		Zyxel Communications Corporation
+C8544B     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+D0-7F-A0   (hex)		Samsung Electronics Co.,Ltd
+D07FA0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-90-93   (hex)		EIZO Corporation
+009093     (base 16)		EIZO Corporation
+				153 Shimokashiwano
+				Hakusan  Ishikawa  924-8856
+				JP
+
+4C-11-59   (hex)		Vision Information & Communications
+4C1159     (base 16)		Vision Information & Communications
+				151, Ulseong-gil
+				Pyeongtaek-si  Gyeonggi-do  17823
+				KR
+
+00-04-9F   (hex)		Freescale Semiconductor
+00049F     (base 16)		Freescale Semiconductor
+				2100 East  Elliot
+				Tempe  AZ  85284
+				US
+
+00-D0-7B   (hex)		COMCAM INTERNATIONAL INC
+00D07B     (base 16)		COMCAM INTERNATIONAL INC
+				1140 McDermott Drive Suite 200
+				WEST CHESTER  PA  19380
+				US
+
+78-52-4A   (hex)		Ensenso GmbH
+78524A     (base 16)		Ensenso GmbH
+				Gundelfingerstr. 2
+				Freiburg    79108
+				DE
+
+E4-FC-82   (hex)		Juniper Networks
+E4FC82     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-B5-D0   (hex)		Samsung Electronics Co.,Ltd
+00B5D0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-96-E5   (hex)		Samsung Electronics Co.,Ltd
+1496E5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-6E-7B   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+C46E7B     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+C0-48-FB   (hex)		Shenzhen JingHanDa Electronics Co.Ltd
+C048FB     (base 16)		Shenzhen JingHanDa Electronics Co.Ltd
+				5th Floor,No 4 ,Road 1,ShangXue Technology industrial Park,LongGang district,ShenZhen,GuangDong,China
+				ShenZhen  GuangDong  518129
+				CN
+
+20-E8-82   (hex)		zte corporation
+20E882     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-9F-FC   (hex)		SHARP Corporation
+F09FFC     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+0C-B5-DE   (hex)		Alcatel Lucent
+0CB5DE     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+00-0B-3B   (hex)		devolo AG
+000B3B     (base 16)		devolo AG
+				Charlottenburger Allee 67
+				Aachen  NRW  52068
+				DE
+
+24-05-88   (hex)		Google, Inc.
+240588     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+50-DC-FC   (hex)		ECOCOM
+50DCFC     (base 16)		ECOCOM
+				15ST,Block A,Fortune Plaza, No.7002 ShenNan Avenue, Futian District
+				Shenzhen  Guangdong  518040
+				CN
+
+70-0B-01   (hex)		Sagemcom Broadband SAS
+700B01     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+5C-26-23   (hex)		WaveLynx Technologies Corporation
+5C2623     (base 16)		WaveLynx Technologies Corporation
+				100 Technology Drive, Building B, Ste 150
+				Broomfield  CO  80021
+				US
+
+30-38-55   (hex)		Nokia Corporation
+303855     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+00-B6-70   (hex)		Cisco Systems, Inc
+00B670     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+AC-64-17   (hex)		Siemens AG
+AC6417     (base 16)		Siemens AG
+				Werner-von-Siemens Strasse 50
+				Amberg    92224
+				DE
+
+34-79-16   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+347916     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-66-EA   (hex)		VERTU INTERNATIONAL CORPORATION LIMITED
+3466EA     (base 16)		VERTU INTERNATIONAL CORPORATION LIMITED
+				25 St Thomas Street, Winchester, Hampshire, United Kingdom
+				Winchester  Hampshire  SO23 9HJ
+				GB
+
+28-38-5C   (hex)		FLEXTRONICS
+28385C     (base 16)		FLEXTRONICS
+				Carretera Base Aerea 5850 int 4
+				Zapopan  Jalisco  45136
+				MX
+
+0C-1C-57   (hex)		Texas Instruments
+0C1C57     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+80-6F-B0   (hex)		Texas Instruments
+806FB0     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-3F-99   (hex)		Siemens AG
+883F99     (base 16)		Siemens AG
+				Werner-von-Siemens-Str. 48
+				Amberg    92224
+				DE
+
+EC-6F-0B   (hex)		FADU, Inc.
+EC6F0B     (base 16)		FADU, Inc.
+				4th FL, 8, Bongeunsa-ro 68-gil, Gangnam-gu
+				Seoul    06153
+				KR
+
+00-06-EC   (hex)		Harris Corporation
+0006EC     (base 16)		Harris Corporation
+				1025 West NASA Blvd
+				Melbourne  FL  32919
+				US
+
+7C-6D-A6   (hex)		Superwave Group LLC
+7C6DA6     (base 16)		Superwave Group LLC
+				poselok Krasnaya Zarya, dom 15
+				Vsevolozhskiy raiyon  Leningradskaya oblast  193149
+				RU
+
+D0-16-B4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D016B4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-A8-B9   (hex)		SIEMENS AG
+20A8B9     (base 16)		SIEMENS AG
+				Oestliche Rheinbrueckenstrasse 50
+				Karlsruhe  Baden Wuerttemberg  76187
+				DE
+
+F0-F0-8F   (hex)		Nextek Solutions Pte Ltd
+F0F08F     (base 16)		Nextek Solutions Pte Ltd
+				105 Cecil Street, #06-01 The Octagon
+				Singapore  Singapore  069534
+				SG
+
+8C-B0-E9   (hex)		Samsung Electronics.,LTD
+8CB0E9     (base 16)		Samsung Electronics.,LTD
+				129, Samsung-ro, Yeongtong-gu
+				Suwon  Gyeonggi-Do  443-742
+				KR
+
+1C-39-47   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+1C3947     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 15, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+34-27-92   (hex)		FREEBOX SAS
+342792     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+40-A1-08   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+40A108     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+70-5A-B6   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+705AB6     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 15, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+20-1A-06   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+201A06     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 15, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+F8-A9-63   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+F8A963     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 15, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+DC-0E-A1   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+DC0EA1     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				No.25, Third Avenue, A Zone, Kunshan Comprehensive Free Trade Zone,, Jiangsu, 
+				KUNSHAN   SUZHOU  215300
+				CN
+
+B8-70-F4   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+B870F4     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+00-9D-6B   (hex)		Murata Manufacturing Co., Ltd.
+009D6B     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+74-59-33   (hex)		Danal Entertainment
+745933     (base 16)		Danal Entertainment
+				9th Fl. Bundang First Tower, 55 Bundang-ro, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13591
+				KR
+
+EC-58-EA   (hex)		Ruckus Wireless
+EC58EA     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+7C-9A-54   (hex)		Technicolor CH USA Inc.
+7C9A54     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+38-8B-59   (hex)		Google, Inc.
+388B59     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+88-01-18   (hex)		BLT Co
+880118     (base 16)		BLT Co
+				Dongan-gu Burim-ro 170beon-gil 44
+				Anyangsi  Kyunggido  14055
+				KR
+
+A4-26-18   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+A42618     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+A4-61-91   (hex)		NamJunSa
+A46191     (base 16)		NamJunSa
+				12, Gimhae-daero 2635 beon-gil
+				Gimhae-si  Gyeongsangnam-do  50932
+				KR
+
+84-A2-4D   (hex)		Birds Eye Systems Private Limited
+84A24D     (base 16)		Birds Eye Systems Private Limited
+				123-126, B Wing First Floor, Chintanmani Plaza, Mohan Studio Compound, Andheri-Kurla Road, Andheri East
+				Mumbai  Maharashtra   400099
+				IN
+
+7C-6B-9C   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+7C6B9C     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+00-17-B6   (hex)		Aquantia Corporation
+0017B6     (base 16)		Aquantia Corporation
+				700 Tasman Drive
+				Milpitas  CA  95035
+				US
+
+10-59-17   (hex)		Tonal
+105917     (base 16)		Tonal
+				1074 Folsom St
+				San Francisco    94103
+				US
+
+D0-EF-C1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D0EFC1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-52-51   (hex)		IBT Ingenieurbureau Broennimann Thun
+D45251     (base 16)		IBT Ingenieurbureau Broennimann Thun
+				Kasernenstrasse 5
+				Thun  Bern  3600
+				CH
+
+00-18-B5   (hex)		Magna Carta
+0018B5     (base 16)		Magna Carta
+				Naritaweg 126
+				Amsterdam  Noord Holland  1043 CA
+				NL
+
+D8-7E-B1   (hex)		x.o.ware, inc.
+D87EB1     (base 16)		x.o.ware, inc.
+				114 E. Haley St., Ste N
+				Santa Barbara  California  93101
+				US
+
+48-57-02   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+485702     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-4F-42   (hex)		JETTER CO., Ltd.
+644F42     (base 16)		JETTER CO., Ltd.
+				265-40 Emukaecho Tanomoto
+				Sasebo-shi  Nagasaki  859-6134
+				JP
+
+DC-AF-68   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+DCAF68     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road, Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+24-EC-51   (hex)		ADF Technologies Sdn Bhd
+24EC51     (base 16)		ADF Technologies Sdn Bhd
+				Plot 88F, Lintang Bayan Lepas 10, Bayan Lepas Industrial Park Phase IV
+				Bayan Lepas  Pulau Pinang  11900
+				MY
+
+70-89-CC   (hex)		China Mobile Group Device Co.,Ltd.
+7089CC     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+2C-5B-E1   (hex)		Centripetal Networks, Inc
+2C5BE1     (base 16)		Centripetal Networks, Inc
+				2251 Corporate Park Drive, Suite 150
+				Herndon  VA  201715806
+				US
+
+DC-EF-CA   (hex)		Murata Manufacturing Co., Ltd.
+DCEFCA     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+00-BC-60   (hex)		Cisco Systems, Inc
+00BC60     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-7B-61   (hex)		NIKKISO CO., LTD.
+CC7B61     (base 16)		NIKKISO CO., LTD.
+				Yebisu Garden Place Tower 22nd Floor, 20-3, Ebisu 4-Chome
+				Shibuya-ku  Tokyo  150-6022
+				JP
+
+9C-71-3A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C713A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-97-B1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2C97B1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-99-69   (hex)		Dell Inc.
+A89969     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+A4-EA-8E   (hex)		Extreme Networks, Inc.
+A4EA8E     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+88-2D-53   (hex)		Baidu Online Network Technology (Beijing) Co., Ltd.
+882D53     (base 16)		Baidu Online Network Technology (Beijing) Co., Ltd.
+				Baidu Campus, No.10 Shangdi 10th Street, Haidian District Beijing 100085 CN
+				Beijing    100085
+				CN
+
+00-D0-B5   (hex)		IPricot formerly DotCom
+00D0B5     (base 16)		IPricot formerly DotCom
+				10-12, avenue de Verdun
+				La-Garenne-Colombes    F-92250
+				FR
+
+74-6B-AB   (hex)		GUANGDONG ENOK COMMUNICATION CO., LTD
+746BAB     (base 16)		GUANGDONG ENOK COMMUNICATION CO., LTD
+				NO.139 Lixiang road, Songmushan Dalang Town
+				Dongguan, Guangdong    523770
+				CN
+
+0C-B6-D2   (hex)		D-Link International
+0CB6D2     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+78-29-ED   (hex)		ASKEY COMPUTER CORP
+7829ED     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+50-61-BF   (hex)		Cisco Systems, Inc
+5061BF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-DF   (hex)		Vestel Elektronik San ve Tic. A.Ş.
+0009DF     (base 16)		Vestel Elektronik San ve Tic. A.Ş.
+				Organize san
+				Manisa  Turket  45030
+				TR
+
+F4-03-2F   (hex)		Reduxio Systems
+F4032F     (base 16)		Reduxio Systems
+				2 Granit St
+				Petach Tikvah    4951446
+				IL
+
+94-4A-0C   (hex)		Sercomm Corporation.
+944A0C     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+00-0F-A2   (hex)		2xWireless
+000FA2     (base 16)		2xWireless
+				1065 Maurader st
+				Chico  CA  95973
+				US
+
+10-8E-E0   (hex)		Samsung Electronics Co.,Ltd
+108EE0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-A6-21   (hex)		Samsung Electronics Co.,Ltd
+FCA621     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-F2-28   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+8CF228     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+70-0F-6A   (hex)		Cisco Systems, Inc
+700F6A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-B2   (hex)		SMALLBIG TECHNOLOGY
+000BB2     (base 16)		SMALLBIG TECHNOLOGY
+				3F Dongsung Bldg. 720-9 Yoksamdong
+				Gangnamgu  Seoul  135-080
+				KR
+
+00-30-5E   (hex)		Abelko Innovation
+00305E     (base 16)		Abelko Innovation
+				Box 808
+				Lulea    97125
+				SE
+
+FC-6B-F0   (hex)		TOPWELL INTERNATIONAL HOLDINDS LIMITED
+FC6BF0     (base 16)		TOPWELL INTERNATIONAL HOLDINDS LIMITED
+				Room 1301-5,Buliding China Youshe,NO.6013,ShenNan Road,CheGong Temple,FuTian District,ShenZhen,GuangDong province,China
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+00-14-77   (hex)		Trilliant
+001477     (base 16)		Trilliant
+				950 Cowie st.
+				Granby  Quebec  J2J 1P2
+				CA
+
+00-07-9B   (hex)		Aurora Networks
+00079B     (base 16)		Aurora Networks
+				2803 Mission College Blvd.
+				Santa Clara  CA  95054
+				US
+
+54-48-10   (hex)		Dell Inc.
+544810     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+54-B2-03   (hex)		PEGATRON CORPORATION
+54B203     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+38-68-DD   (hex)		INVENTEC CORPORATION
+3868DD     (base 16)		INVENTEC CORPORATION
+				NO.88, DAZHI RD.
+				TAOYUAN    33068
+				TW
+
+B8-B7-F1   (hex)		Wistron Neweb Corporation
+B8B7F1     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+80-50-F6   (hex)		ITEL MOBILE LIMITED
+8050F6     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+A8-CA-B9   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+A8CAB9     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				SUWON  KYUNGGI-DO  443-743
+				KR
+
+20-39-56   (hex)		HMD Global Oy
+203956     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+78-AF-E4   (hex)		Comau S.p.A
+78AFE4     (base 16)		Comau S.p.A
+				via Rivalta 30
+				Grugliasco  (TO)  10095
+				IT
+
+90-A1-37   (hex)		Beijing Splendidtel Communication Technology Co,. Ltd
+90A137     (base 16)		Beijing Splendidtel Communication Technology Co,. Ltd
+				4 Floor,Taixing Tower,No.11 Huayuan East Road. Haidian District
+				Beijing  Beijing  100191
+				CN
+
+80-02-9C   (hex)		Gemtek Technology Co., Ltd.
+80029C     (base 16)		Gemtek Technology Co., Ltd.
+				No.15-1 Zhonghua Road
+				Hukou  Hsinchu  30352
+				TW
+
+D0-C5-D3   (hex)		AzureWave Technology Inc.
+D0C5D3     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+14-16-9E   (hex)		 Wingtech Group (HongKong）Limited
+14169E     (base 16)		 Wingtech Group (HongKong）Limited
+				 FLAT/RM 1903 19/F PODIUM PLAZA 5HANOI ROAD TSIM SHA TSUI
+				Hong Kong  Hong Kong  999077
+				HK
+
+F8-C3-9E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F8C39E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-D0-99   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E8D099     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+10-7B-A4   (hex)		Olive & Dove Co.,Ltd.
+107BA4     (base 16)		Olive & Dove Co.,Ltd.
+				803 Polaris bldg., 381, Seongnam-daero, Bundang-gu 
+				Gyeonggi-do  Seongnam-si  13555
+				KR
+
+7C-41-A2   (hex)		Nokia
+7C41A2     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+BC-32-5F   (hex)		Zhejiang Dahua Technology Co., Ltd.
+BC325F     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+50-5B-C2   (hex)		Liteon Technology Corporation
+505BC2     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+6C-21-A2   (hex)		AMPAK Technology, Inc.
+6C21A2     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+9C-2F-73   (hex)		Universal Tiancheng Technology (Beijing) Co., Ltd.
+9C2F73     (base 16)		Universal Tiancheng Technology (Beijing) Co., Ltd.
+				13 floor,Changxin Building,Anding Road No.39,Chaoyang District,Beijing
+				Beijing  Beijing  100029
+				CN
+
+D8-32-E3   (hex)		Xiaomi Communications Co Ltd
+D832E3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+94-87-E0   (hex)		Xiaomi Communications Co Ltd
+9487E0     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+38-AF-29   (hex)		Zhejiang Dahua Technology Co., Ltd.
+38AF29     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+C8-86-29   (hex)		Shenzhen Duubee Intelligent Technologies Co.,LTD.
+C88629     (base 16)		Shenzhen Duubee Intelligent Technologies Co.,LTD.
+				9F, Block B, Unicenter, Xin’an Sub district, Bao’an District
+				Shenzhen  GuangDong  518000
+				CN
+
+CC-C2-E0   (hex)		Raisecom Technology CO., LTD
+CCC2E0     (base 16)		Raisecom Technology CO., LTD
+				No. 11, East Area, No. 10 Block, East Xibeiwang Road
+				Beijing    100094
+				CN
+
+30-0A-C5   (hex)		Ruio telecommunication technologies Co., Limited
+300AC5     (base 16)		Ruio telecommunication technologies Co., Limited
+				Room 2501, Broadegate Software Building, No,1003 Keyuan Road,
+				Shenzhen  guangdong  518000
+				CN
+
+00-E0-65   (hex)		OPTICAL ACCESS INTERNATIONAL
+00E065     (base 16)		OPTICAL ACCESS INTERNATIONAL
+				500 WEST CUMMINGS PL. #3400
+				WOBURN  MA  01801
+				US
+
+44-66-FC   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+4466FC     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+A0-28-ED   (hex)		HMD Global Oy
+A028ED     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+AC-54-74   (hex)		China Mobile IOT Company Limited
+AC5474     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+8C-1C-DA   (hex)		IEEE Registration Authority
+8C1CDA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-07-A8   (hex)		Haier Group Technologies Ltd
+0007A8     (base 16)		Haier Group Technologies Ltd
+				No. 1 Haier Road, Hi-tech Zone
+				00000    00000
+				CN
+
+98-14-D2   (hex)		Avonic
+9814D2     (base 16)		Avonic
+				Distributieweg 60
+				Delfgauw    2645EJ
+				NL
+
+14-09-DC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1409DC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-93-65   (hex)		Mapper.ai, Inc.
+EC9365     (base 16)		Mapper.ai, Inc.
+				400 Treat Ave, Suite G
+				San Francisco  CA  94110
+				US
+
+C4-BA-A3   (hex)		Beijing Winicssec Technologies Co., Ltd.
+C4BAA3     (base 16)		Beijing Winicssec Technologies Co., Ltd.
+				F block 9th floor 907 of Jiahua Building, No.9 Shangdi 3rd Street
+				Haidian District  Beijing  100085
+				CN
+
+9C-FE-A1   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+9CFEA1     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D8-8A-3B   (hex)		UNIT-EM
+D88A3B     (base 16)		UNIT-EM
+				167 Merchants Street
+				Valletta    VLT 1174
+				MT
+
+EC-5A-86   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+EC5A86     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				Road NO2, West of Industrial Park,North of Science & Technology Park
+				Dongguan  Guangdong  518057
+				CN
+
+C0-EE-B5   (hex)		Enice Network.
+C0EEB5     (base 16)		Enice Network.
+				NO.30, Shuige Rd, JiangNing Economic Development Zone, Nanjing
+				Nanjing    211106
+				CN
+
+60-DE-F3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60DEF3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-A0-09   (hex)		Xiaomi Communications Co Ltd
+50A009     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+88-96-4E   (hex)		ARRIS Group, Inc.
+88964E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+88-3F-4A   (hex)		Texas Instruments
+883F4A     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+9C-A6-15   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+9CA615     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-4E-76   (hex)		CHAMPIONTECH  ENTERPRISE (SHENZHEN) INC
+E44E76     (base 16)		CHAMPIONTECH  ENTERPRISE (SHENZHEN) INC
+				Against Office of Dong-Zhou Residential Committee Guang Ming
+				Shenzhen    518000
+				CN
+
+00-40-98   (hex)		DRESSLER GMBH & CO.
+004098     (base 16)		DRESSLER GMBH & CO.
+				KACKERTSTRASSE 10
+				    
+				DE
+
+00-1D-FA   (hex)		Fujian LANDI Commercial Equipment Co.,Ltd
+001DFA     (base 16)		Fujian LANDI Commercial Equipment Co.,Ltd
+				Building 17,the 1st Section ,Fuzhou Software Park
+				No.89 Software Road   Fuzhou ,Fujian  350003
+				CN
+
+9C-E6-5E   (hex)		Apple, Inc.
+9CE65E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-98-80   (hex)		Apple, Inc.
+C49880     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-33-8E   (hex)		Apple, Inc.
+E0338E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-F6-9C   (hex)		Apple, Inc.
+08F69C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-FA-83   (hex)		Qingdao Haier Technology Co.,Ltd
+04FA83     (base 16)		Qingdao Haier Technology Co.,Ltd
+				Building A01,Haier Information Park, No.1 Haier Road,
+				Qingdao  Shandong  266101
+				CN
+
+78-F9-B4   (hex)		Nokia
+78F9B4     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+D0-76-E7   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D076E7     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+50-A6-7F   (hex)		Apple, Inc.
+50A67F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-61-DA   (hex)		Apple, Inc.
+D461DA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-18-98   (hex)		Apple, Inc.
+F01898     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-19-08   (hex)		Apple, Inc.
+881908     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-09-47   (hex)		Apple, Inc.
+5C0947     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-20-5E   (hex)		Apple, Inc.
+14205E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-41-A4   (hex)		Apple, Inc.
+B841A4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-16-5C   (hex)		Trackflow Ltd.
+00165C     (base 16)		Trackflow Ltd.
+				167-169 Kensington High Street
+				London  England  W86SH
+				GB
+
+64-1C-AE   (hex)		Samsung Electronics Co.,Ltd
+641CAE     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+F8-E4-4E   (hex)		MCOT INC.
+F8E44E     (base 16)		MCOT INC.
+				Yogohigashi 1-5-12
+				Matsuyama  Ehime  790-0044
+				JP
+
+40-CD-7A   (hex)		Qingdao Hisense Communications Co.,Ltd.
+40CD7A     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+DC-4E-F4   (hex)		Shenzhen MTN Electronics CO., Ltd
+DC4EF4     (base 16)		Shenzhen MTN Electronics CO., Ltd
+				MTN Industrial Park, No. 5, 9 South Futai Road, Pingxi Community, Pingdi Street, Longgang District
+				Shenzhen  Guangdong  518117
+				CN
+
+F0-81-73   (hex)		Amazon Technologies Inc.
+F08173     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno    89507
+				US
+
+EC-65-CC   (hex)		Panasonic Automotive Systems Company of America
+EC65CC     (base 16)		Panasonic Automotive Systems Company of America
+				776 Highway 74 South
+				Peachtree City  null  30269
+				US
+
+94-99-90   (hex)		VTC Telecommunications
+949990     (base 16)		VTC Telecommunications
+				750 (3rd Floor) Dien Bien Phu, District 10
+				Ho Chi Minh  Ho Chi Minh  70000
+				VN
+
+F4-BC-97   (hex)		Shenzhen Crave Communication Co., LTD
+F4BC97     (base 16)		Shenzhen Crave Communication Co., LTD
+				F3,8Building, DongFangMing IndustryZone, No.83 DabaoRD., 33 District BaoAn
+				Shenzhen    518000
+				CN
+
+28-FE-DE   (hex)		COMESTA, Inc.
+28FEDE     (base 16)		COMESTA, Inc.
+				Techno1-ro 61-7, Yuseong-gu, 
+				Daejeon    34014
+				KR
+
+90-79-10   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+907910     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+00-3D-E8   (hex)		LG Electronics (Mobile Communications)
+003DE8     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+68-FE-DA   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+68FEDA     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-98-6D   (hex)		Palo Alto Networks
+E8986D     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+14-4E-34   (hex)		Remote Solution
+144E34     (base 16)		Remote Solution
+				92, Chogokri, Nammyun
+				Kimcheon city  Kyungbuk  740-871
+				KR
+
+00-50-8B   (hex)		Hewlett Packard
+00508B     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+14-6B-9C   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+146B9C     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+94-8D-EF   (hex)		Oetiker Schweiz AG
+948DEF     (base 16)		Oetiker Schweiz AG
+				Spätzstrasse 11
+				Horgen    8810
+				CH
+
+2C-D9-74   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+2CD974     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+D4-F7-86   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D4F786     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+34-03-DE   (hex)		Texas Instruments
+3403DE     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+24-0A-63   (hex)		ARRIS Group, Inc.
+240A63     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-8B-37   (hex)		ARRIS Group, Inc.
+F88B37     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+20-67-7C   (hex)		Hewlett Packard Enterprise
+20677C     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+34-D7-12   (hex)		Smartisan Digital Co., Ltd
+34D712     (base 16)		Smartisan Digital Co., Ltd
+				4F, China Digital Kingdom, No.1 Wangjing North Road, Chaoyang District
+				Beijing  Beijing  100012
+				CN
+
+A0-66-10   (hex)		FUJITSU LIMITED
+A06610     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+44-FF-BA   (hex)		zte corporation
+44FFBA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E0-E6-2E   (hex)		TCT mobile ltd
+E0E62E     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+38-78-62   (hex)		Sony Mobile Communications Inc
+387862     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+E4-2D-7B   (hex)		China Mobile IOT Company Limited
+E42D7B     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+C4-64-E3   (hex)		Texas Instruments
+C464E3     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-17-A3   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+8817A3     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+88-A9-A7   (hex)		IEEE Registration Authority
+88A9A7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+EC-89-14   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC8914     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B8-94-36   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B89436     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-14-79   (hex)		iRobot Corporation 
+501479     (base 16)		iRobot Corporation 
+				8 Crosby Drive
+				Bedford  MA  01730
+				US
+
+60-84-BD   (hex)		BUFFALO.INC
+6084BD     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+34-7E-CA   (hex)		NEXTWILL
+347ECA     (base 16)		NEXTWILL
+				JJ-Building, 20, Deongmyeong-ro 71beon-gil1, Yuseong-gu
+				Daejeon    34155
+				KR
+
+B4-2E-F8   (hex)		Eline Technology co.Ltd
+B42EF8     (base 16)		Eline Technology co.Ltd
+				kangcheng Road, Pharmaceutical Industrical Park, Yuanzhou District
+				Yichun  Jiangxi  336000
+				CN
+
+A4-D4-B2   (hex)		Shenzhen MeiG Smart Technology Co.,Ltd
+A4D4B2     (base 16)		Shenzhen MeiG Smart Technology Co.,Ltd
+				#88 Qinjiang Road, Xuhui District
+				Shanghai    200233
+				CN
+
+8C-F7-73   (hex)		Nokia
+8CF773     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+DC-DD-24   (hex)		Energica Motor Company SpA
+DCDD24     (base 16)		Energica Motor Company SpA
+				Via Cesare della Chiesa, 150
+				MODENA (MO)  Mo  41126
+				IT
+
+64-1C-B0   (hex)		Samsung Electronics Co.,Ltd
+641CB0     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+90-3A-72   (hex)		Ruckus Wireless
+903A72     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+CC-3B-58   (hex)		Curiouser Products Inc
+CC3B58     (base 16)		Curiouser Products Inc
+				712 Broadway #4
+				New York  NY  10003
+				US
+
+4C-EF-C0   (hex)		Amazon Technologies Inc.
+4CEFC0     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+8C-59-73   (hex)		Zyxel Communications Corporation
+8C5973     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+24-18-1D   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+24181D     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+58-D7-59   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+58D759     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F8-90-66   (hex)		Nain Inc.
+F89066     (base 16)		Nain Inc.
+				Aoyamadai building 902, Shibuya 2-9-10, Shibuya-ku
+				Tokyo    150-0002
+				JP
+
+70-06-AC   (hex)		Eastcompeace Technology Co., Ltd
+7006AC     (base 16)		Eastcompeace Technology Co., Ltd
+				Number 8 Pinggong Zhong Road,Nanping S&T Industry Community,Zhuhai,Guangdong,519060 China 
+				Zhuhai  Guangdong  519060
+				CN
+
+28-02-D8   (hex)		Samsung Electronics Co.,Ltd
+2802D8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-E5-33   (hex)		IEEE Registration Authority
+DCE533     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D8-44-5C   (hex)		DEV Tecnologia Ind Com Man Eq LTDA
+D8445C     (base 16)		DEV Tecnologia Ind Com Man Eq LTDA
+				Av Prof Lineu Prestes 2242 SL 23
+				Sao Paulo  SP  05508000
+				BR
+
+50-95-51   (hex)		ARRIS Group, Inc.
+509551     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+80-41-26   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+804126     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-F9-70   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACF970     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-39-53   (hex)		zte corporation
+7C3953     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-E1-AA   (hex)		zte corporation
+38E1AA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+48-C7-96   (hex)		Samsung Electronics Co.,Ltd
+48C796     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-C2-48   (hex)		Samsung Electronics Co.,Ltd
+F4C248     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-71-90   (hex)		Samsung Electronics Co.,Ltd
+F47190     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-FF-BC   (hex)		IEEE Registration Authority
+C4FFBC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-23-69   (hex)		Honeywell SPS
+0C2369     (base 16)		Honeywell SPS
+				700 Visions Dr.
+				Skaneateles Falls  NY  13153
+				US
+
+04-C9-D9   (hex)		Dish Technologies Corp
+04C9D9     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+70-55-F8   (hex)		Cerebras Systems Inc
+7055F8     (base 16)		Cerebras Systems Inc
+				175 S San Antonio Rd #100
+				Los Altos  CA  94022
+				US
+
+6C-54-CD   (hex)		LAMPEX ELECTRONICS LIMITED
+6C54CD     (base 16)		LAMPEX ELECTRONICS LIMITED
+				6-2/231/B, Kukatpally,
+				Hyderabad  Telangana  500072
+				IN
+
+00-08-89   (hex)		Dish Technologies Corp
+000889     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+F0-B5-B7   (hex)		Disruptive Technologies Research AS
+F0B5B7     (base 16)		Disruptive Technologies Research AS
+				Ytrebygdsvegen 215
+				Blomsterdalen  Hordaland  5258
+				NO
+
+B4-DE-DF   (hex)		zte corporation
+B4DEDF     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+28-3B-82   (hex)		D-Link International
+283B82     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+D4-90-9C   (hex)		Apple, Inc.
+D4909C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-E0-A6   (hex)		Apple, Inc.
+E4E0A6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-04-54   (hex)		ICOMM HK LIMITED
+580454     (base 16)		ICOMM HK LIMITED
+				SUITES 2302-6, 23/F GREAT EAGLE CTR 23 HARBOUR RD 
+				WANCHAI    NA
+				HK
+
+3C-9A-77   (hex)		Technicolor CH USA Inc.
+3C9A77     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+C4-77-AF   (hex)		Advanced Digital Broadcast SA
+C477AF     (base 16)		Advanced Digital Broadcast SA
+				Route de Crassier 21, B2
+				Eysins    CH-1262
+				CH
+
+94-29-0C   (hex)		Shenyang wisdom Foundation Technology Development Co., Ltd.
+94290C     (base 16)		Shenyang wisdom Foundation Technology Development Co., Ltd.
+				No. 262 North Main Street, Huanggu District, the Yellow River
+				shenyang    110000
+				CN
+
+9C-32-CE   (hex)		CANON INC.
+9C32CE     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+20-E0-9C   (hex)		Nokia
+20E09C     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+2C-FD-A1   (hex)		ASUSTek COMPUTER INC.
+2CFDA1     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+38-07-D4   (hex)		Zeppelin Systems GmbH
+3807D4     (base 16)		Zeppelin Systems GmbH
+				Messenhäuser Str. 37-45
+				Rödermark  Hessen  63322
+				DE
+
+04-19-7F   (hex)		Grasphere Japan
+04197F     (base 16)		Grasphere Japan
+				3-1-11 NNT build. 
+				Tokyo    1030013
+				JP
+
+5C-00-38   (hex)		Viasat Group S.p.A.
+5C0038     (base 16)		Viasat Group S.p.A.
+				Via Aosta 23
+				Venaria Reale   Torino  10078
+				IT
+
+8C-EC-4B   (hex)		Dell Inc.
+8CEC4B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-50-91   (hex)		NETACCESS, INC.
+005091     (base 16)		NETACCESS, INC.
+				18 KEEWAYDIN DRIVE
+				SALEM  NH  03079
+				US
+
+B8-50-01   (hex)		Extreme Networks, Inc.
+B85001     (base 16)		Extreme Networks, Inc.
+				ONE ZEBRA PLAZA
+				HOLTSVILLE  NY  11742
+				US
+
+80-2B-F9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+802BF9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+54-B8-02   (hex)		Samsung Electronics Co.,Ltd
+54B802     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-CE-A9   (hex)		Texas Instruments
+10CEA9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+80-5E-0C   (hex)		YEALINK(XIAMEN) NETWORK TECHNOLOGY CO.,LTD.
+805E0C     (base 16)		YEALINK(XIAMEN) NETWORK TECHNOLOGY CO.,LTD.
+				309, 3th Floor, No.16, Yun Ding North Road, Huli District
+				xiamen  Fujian  361015
+				CN
+
+6C-49-C1   (hex)		o2ones Co., Ltd.
+6C49C1     (base 16)		o2ones Co., Ltd.
+				503 Glory Tower, 3-10, Gumi-ro 9beon-gil, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13637
+				KR
+
+70-EE-A3   (hex)		Eoptolink Technology Inc. Ltd,
+70EEA3     (base 16)		Eoptolink Technology Inc. Ltd,
+				No.127 West Wulian Street
+				Chengdu  China/Sichuan  610213
+				CN
+
+70-47-E9   (hex)		vivo Mobile Communication Co., Ltd.
+7047E9     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+5C-52-1E   (hex)		Nintendo Co.,Ltd
+5C521E     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+14-44-4A   (hex)		Apollo Seiko Ltd.
+14444A     (base 16)		Apollo Seiko Ltd.
+				2271-7 Jinba
+				Gotenba  Shizuoka  412-0047
+				JP
+
+3C-2C-99   (hex)		Edgecore Networks Corporation
+3C2C99     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+88-D0-39   (hex)		TCL Technoly Electronics(Huizhou).,Ltd
+88D039     (base 16)		TCL Technoly Electronics(Huizhou).,Ltd
+				Section 37, Zhongkai Hi-Tech Development Zone
+				Huizhou  Guangdong  516006
+				CN
+
+68-3E-02   (hex)		SIEMENS AG, Digital Factory, Motion Control System
+683E02     (base 16)		SIEMENS AG, Digital Factory, Motion Control System
+				Varey Road
+				Congleton  Cheshire  CW12 1PH
+				GB
+
+00-02-61   (hex)		Tilgin AB
+000261     (base 16)		Tilgin AB
+				Finlandsgatan 40
+				kista    12345
+				SE
+
+00-14-C3   (hex)		Seagate Technology
+0014C3     (base 16)		Seagate Technology
+				M/S NW1F01
+				Longmont  CO  80503
+				US
+
+00-04-CF   (hex)		Seagate Technology
+0004CF     (base 16)		Seagate Technology
+				M/S NW1F01
+				Longmont  CO  80503
+				US
+
+00-20-37   (hex)		Seagate Technology
+002037     (base 16)		Seagate Technology
+				8001 E. BLOOMINGTON FWY
+				BLOOMINGTON  MN  55420
+				US
+
+5C-81-A7   (hex)		Network Devices Pty Ltd
+5C81A7     (base 16)		Network Devices Pty Ltd
+				16 Dickson Ave
+				Artarmon  NSW  2064
+				AU
+
+5C-0C-0E   (hex)		Guizhou Huaxintong Semiconductor Technology Co Ltd
+5C0C0E     (base 16)		Guizhou Huaxintong Semiconductor Technology Co Ltd
+				Sitelin Park
+				Intersection between Jin ma Ave and Qianzhong Ave  Gui An New Area, Guizhou Prov  550003
+				CN
+
+50-3C-EA   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+503CEA     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D0-96-FB   (hex)		DASAN Network Solutions
+D096FB     (base 16)		DASAN Network Solutions
+				DASAN Tower 8F, 49 Daewangpangyo-ro644beon-gil Bundang-gu
+				Seongnam-si  Gyeonggi-do  13493
+				KR
+
+00-E0-91   (hex)		LG Electronics
+00E091     (base 16)		LG Electronics
+				16, Woomyeon-dong, Seocho-gu
+				Seoul    137-724
+				KR
+
+38-43-7D   (hex)		Compal Broadband Networks, Inc.
+38437D     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+50-6F-98   (hex)		Sehaj Synergy Technologies Private Limited
+506F98     (base 16)		Sehaj Synergy Technologies Private Limited
+				E-112A, Kataria Colony, Ramanagar Extension, New Sanganer Road, Sodala, Jaipur-302019
+				Jaipur  Rajasthan  302019
+				IN
+
+4C-AE-1C   (hex)		SaiNXT Technologies LLP
+4CAE1C     (base 16)		SaiNXT Technologies LLP
+				Shop No. 7, Sonawala Building, 1st Floor, Proctor Road, Grant Road (E)
+				Mumbai  Maharashtra  400007
+				IN
+
+14-28-82   (hex)		MIDICOM ELECTRONICS CO.LTD
+142882     (base 16)		MIDICOM ELECTRONICS CO.LTD
+				Bucheon Techno Park 303-404,345
+				Seokcheon-ro,Bucheon-si  Gyeonggi-do   1501
+				KR
+
+EC-81-93   (hex)		Logitech, Inc
+EC8193     (base 16)		Logitech, Inc
+				4700 NW Camas Meadows Drive
+				Camas  WA  98607
+				US
+
+6C-DD-30   (hex)		Cisco Systems, Inc
+6CDD30     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-4E-86   (hex)		Third Millennium Systems Ltd.
+6C4E86     (base 16)		Third Millennium Systems Ltd.
+				18/19 Torfaen Business Centre, Panteg Way
+				New Inn, Pontypool  Torfaen  NP4 0LS
+				GB
+
+5C-86-C1   (hex)		DONGGUAN SOLUM ELECTRONICS CO.,LTD
+5C86C1     (base 16)		DONGGUAN SOLUM ELECTRONICS CO.,LTD
+				NO.157,13 Coastal Way TPFTZ
+				TIANJIN    300461
+				CN
+
+5C-77-76   (hex)		TCT mobile ltd
+5C7776     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+70-E5-6E   (hex)		Texas Instruments
+70E56E     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+54-7D-CD   (hex)		Texas Instruments
+547DCD     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-AE-CD   (hex)		Pensando Systems
+00AECD     (base 16)		Pensando Systems
+				1730 Technology Drive, Suite 202
+				San Jose  CA  95110
+				US
+
+FC-9D-D8   (hex)		Beijing TongTongYiLian Science and Technology Ltd.
+FC9DD8     (base 16)		Beijing TongTongYiLian Science and Technology Ltd.
+				 Room 301,Zone 3,Building 9,No.8 Dongbeiwang West Road,Haidian District,Beijing
+				BEIJING  BEIJING  100193
+				CN
+
+DC-28-34   (hex)		HAKKO Corporation
+DC2834     (base 16)		HAKKO Corporation
+				4-5, Shiokusa 2-chome, Naniwaku
+				Osaka  Osaka  556-0024
+				JP
+
+84-50-9A   (hex)		Easy Soft TV Co., Ltd
+84509A     (base 16)		Easy Soft TV Co., Ltd
+				#1613, Heungduk U-Tower, Heungduk Jung ang-ro 120
+				Yongin-si  Gyeounggi-do  16950
+				KR
+
+00-17-30   (hex)		Automation Electronics
+001730     (base 16)		Automation Electronics
+				111 Big Horn Rd.
+				Casper  Wy  82601
+				US
+
+30-E4-8E   (hex)		Vodafone UK
+30E48E     (base 16)		Vodafone UK
+				Vodafone House 
+				Newbury   Berkshire   RG142FN
+				GB
+
+44-91-60   (hex)		Murata Manufacturing Co., Ltd.
+449160     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+B4-F1-DA   (hex)		LG Electronics (Mobile Communications)
+B4F1DA     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+C8-63-F1   (hex)		Sony Interactive Entertainment Inc.
+C863F1     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+DC-E1-AD   (hex)		Shenzhen Wintop Photoelectric Technology Co., Ltd
+DCE1AD     (base 16)		Shenzhen Wintop Photoelectric Technology Co., Ltd
+				6th Floor, 1st Building, Zone 3, South Area, Zhongguan& Honghualing Industrial Zone, No. 1213, Liuxian Avenue, Taoyuan Street, Nanshan District, Shenzhen, China
+				Shenzhen  Guangdong  518054
+				CN
+
+94-88-54   (hex)		Texas Instruments
+948854     (base 16)		Texas Instruments
+				12500 TI Boulevard
+				Dallas  TX  75243
+				US
+
+00-1D-0D   (hex)		Sony Interactive Entertainment Inc.
+001D0D     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+B0-FC-36   (hex)		CyberTAN Technology Inc.
+B0FC36     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+00-1D-F4   (hex)		Magellan Technology Pty Limited
+001DF4     (base 16)		Magellan Technology Pty Limited
+				65 Johnston Street
+				Annandale  NSW  2000
+				AU
+
+6C-05-D5   (hex)		Ethertronics Inc
+6C05D5     (base 16)		Ethertronics Inc
+				5501 Oberlin Drive, Suite 100
+				SAN DIEGO  CA  92121
+				US
+
+00-19-C2   (hex)		Equustek Solutions, Inc.
+0019C2     (base 16)		Equustek Solutions, Inc.
+				#286 - 5489 Byrne Road,
+				Burnaby  BC  V5J 3J1
+				CA
+
+EC-B0-E1   (hex)		Ciena Corporation
+ECB0E1     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+78-DD-D9   (hex)		Guangzhou Shiyuan Electronics Co., Ltd. 
+78DDD9     (base 16)		Guangzhou Shiyuan Electronics Co., Ltd. 
+				No.6, 4th Yunpu Road, Yunpu Industry District
+				Guangzhou  Guangdong  510530
+				CN
+
+F8-B7-E2   (hex)		Cisco Systems, Inc
+F8B7E2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F8-20-55   (hex)		Green Information System
+F82055     (base 16)		Green Information System
+				#202(Shopping center), Woldong-ro 28, Buk-gu
+				Gwangju    61153
+				KR
+
+74-E1-9A   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+74E19A     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+00-00-97   (hex)		Dell EMC
+000097     (base 16)		Dell EMC
+				176 South Street
+				Hopkinton  MA  01748
+				US
+
+8C-CF-09   (hex)		Dell EMC
+8CCF09     (base 16)		Dell EMC
+				228 South St
+				Hopkinton  MA  01748
+				US
+
+8C-83-9D   (hex)		SHENZHEN XINYUPENG ELECTRONIC TECHNOLOGY CO., LTD
+8C839D     (base 16)		SHENZHEN XINYUPENG ELECTRONIC TECHNOLOGY CO., LTD
+				ROOM 1505,BIT INNOVATION BUILDING,SCIENCE AND TECHNOLOGY PARK,NANSHAN DISTRICT
+				Shenzhen    518057
+				CN
+
+B0-C1-9E   (hex)		zte corporation
+B0C19E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+0C-37-47   (hex)		zte corporation
+0C3747     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+AC-A6-67   (hex)		Electronic Systems Protection, Inc.
+ACA667     (base 16)		Electronic Systems Protection, Inc.
+				8001 Knightdale Blvd.
+				Knightdale  NC  27545
+				US
+
+00-81-F9   (hex)		Texas Instruments
+0081F9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+EC-B5-FA   (hex)		Philips Lighting BV
+ECB5FA     (base 16)		Philips Lighting BV
+				High Tech Campus 45
+				Eindhoven  Noord Brabant  5656 AE
+				NL
+
+44-CD-0E   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+44CD0E     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+E8-82-5B   (hex)		ARRIS Group, Inc.
+E8825B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-99-1C   (hex)		Shenzhen Honesty Electronics Co.,Ltd
+70991C     (base 16)		Shenzhen Honesty Electronics Co.,Ltd
+				5/F,Zone B,Chitat Industrial Park,West Longping Road
+				Shenzhen City  Longgang District, Guangdong  518172
+				CN
+
+80-B0-3D   (hex)		Apple, Inc.
+80B03D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-9A-DC   (hex)		Apple, Inc.
+E49ADC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-E4-B5   (hex)		Apple, Inc.
+ACE4B5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-D2-B0   (hex)		Apple, Inc.
+D0D2B0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1C-AE   (hex)		WiChorus, Inc.
+001CAE     (base 16)		WiChorus, Inc.
+				3590 N 1st Street, Suite 300
+				San Jose  CA  95134
+				US
+
+7C-DD-76   (hex)		Suzhou Hanming Technologies Co., Ltd.
+7CDD76     (base 16)		Suzhou Hanming Technologies Co., Ltd.
+				Suite 407, No. 166, Ren Ai Road
+				Suzhou  Jiangsu  215123
+				CN
+
+24-68-80   (hex)		Braveridge.co.,ltd.
+246880     (base 16)		Braveridge.co.,ltd.
+				3-27-2, Susenji
+				Nishi-ku, Fukuoka-shi  Fukuoka  819-0373
+				JP
+
+F0-92-B4   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+F092B4     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+E8-DF-70   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+E8DF70     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+28-AD-3E   (hex)		Shenzhen TONG BO WEI Technology CO.,LTD
+28AD3E     (base 16)		Shenzhen TONG BO WEI Technology CO.,LTD
+				Longhua District, Dalang street Langkou community Huarong Road Peng Tengda Industrial Park 4 5 floor
+				SHENZHEN  guangdong  518109
+				CN
+
+00-1C-56   (hex)		Pado Systems, Inc.
+001C56     (base 16)		Pado Systems, Inc.
+				#706 Loadland EZ Tower 153
+				SungNam  Gyung gi-Do  463-810
+				KR
+
+F0-6D-78   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+F06D78     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+78-44-FD   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+7844FD     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+EC-F8-EB   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+ECF8EB     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+70-7D-95   (hex)		Shenzhen City LinwlanTechnology Co. Ltd.
+707D95     (base 16)		Shenzhen City LinwlanTechnology Co. Ltd.
+				106 village road , manhole street Baoan district .
+				Shenzhen  Guangdong  518125
+				CN
+
+2C-43-1A   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+2C431A     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+A8-D3-C8   (hex)		Topcon Electronics GmbH & Co. KG
+A8D3C8     (base 16)		Topcon Electronics GmbH & Co. KG
+				Industriestraße 7
+				Geisenheim    65366
+				DE
+
+D0-59-95   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D05995     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+18-CC-88   (hex)		Hitachi Johnson Controls Air 
+18CC88     (base 16)		Hitachi Johnson Controls Air 
+				390 Number
+				 Shimizu Village Village  Shizuoka Prefecture  424-0926
+				JP
+
+80-C7-55   (hex)		Panasonic Appliances Company
+80C755     (base 16)		Panasonic Appliances Company
+				2-3-1-2 Noji-higashi
+				Kusatsu City  Shiga  525-8555
+				JP
+
+F0-BD-2E   (hex)		H+S Polatis Ltd
+F0BD2E     (base 16)		H+S Polatis Ltd
+				332/2 Cambridge Science Park
+				Cambridge    CB4 0WN
+				GB
+
+74-6E-E4   (hex)		Asia Vital Components Co.,Ltd.
+746EE4     (base 16)		Asia Vital Components Co.,Ltd.
+				Rm. 3, 7F., No.24, Wuquan 2nd Rd., Xinzhuang Dist., 
+				 New Taipei   Taiwan  24892
+				TW
+
+00-40-E4   (hex)		E-M TECHNOLOGY, INC.
+0040E4     (base 16)		E-M TECHNOLOGY, INC.
+				9245 SOUTHWEST NIMBUS AVE.
+				BEAVERTON  OR  97005
+				US
+
+98-4B-4A   (hex)		ARRIS Group, Inc.
+984B4A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-84-F3   (hex)		High Grade Controls Corporation
+E084F3     (base 16)		High Grade Controls Corporation
+				87 Magill Street
+				Sudbury  Ontario  P3Y1K6
+				CA
+
+38-A6-CE   (hex)		BSkyB Ltd
+38A6CE     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+34-56-FE   (hex)		Cisco Meraki
+3456FE     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+70-70-8B   (hex)		Cisco Systems, Inc
+70708B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-9F-5A   (hex)		C-Kur TV Inc.
+389F5A     (base 16)		C-Kur TV Inc.
+				A-1902, 583, Yangcheon-ro, Gangseo-gu
+				Seoul    07547
+				KR
+
+D8-43-ED   (hex)		Suzuken
+D843ED     (base 16)		Suzuken
+				8, Higashikatahamachi, Higashiku
+				Nagoya  Aich  4610015
+				JP
+
+BC-41-01   (hex)		Shenzhen TINNO Mobile Technology Corp.
+BC4101     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+04-3A-0D   (hex)		SM Optics S.r.l.
+043A0D     (base 16)		SM Optics S.r.l.
+				via Michelangelo Buonarroti, 1
+				Cologno Monzese  Milan  I-20093
+				IT
+
+44-8F-17   (hex)		Samsung Electronics Co., Ltd. ARTIK
+448F17     (base 16)		Samsung Electronics Co., Ltd. ARTIK
+				1-1, Samsungjeonja-ro
+				Hwaseong-si  Gyeonggi-do  18448
+				KR
+
+00-FC-8B   (hex)		Amazon Technologies Inc.
+00FC8B     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-76-B1   (hex)		Somfy-Protect By Myfox SAS
+0076B1     (base 16)		Somfy-Protect By Myfox SAS
+				Regent Park II, Bât I, 2460 l'Occitane
+				Labège    31670
+				FR
+
+6C-C1-47   (hex)		Xiamen Hanin Electronic Technology Co., Ltd
+6CC147     (base 16)		Xiamen Hanin Electronic Technology Co., Ltd
+				#8 building, Gaoqi Nan Shi'er Road, Huli Distric
+				Xiamen  Fujian  361000
+				CN
+
+A0-72-E4   (hex)		NJ SYSTEM CO.,LTD
+A072E4     (base 16)		NJ SYSTEM CO.,LTD
+				Urim lions valley 5cha, A-1701, 144-3, Sangdaewon-dong, Jungwon-gu
+				Seongnam  Gyeonggido  13201
+				KR
+
+4C-13-65   (hex)		Emplus Technologies
+4C1365     (base 16)		Emplus Technologies
+				Bld B, 10F, No.209, Sec.1, Nangang Rd
+				Taipei    115
+				TW
+
+CC-F9-57   (hex)		u-blox AG
+CCF957     (base 16)		u-blox AG
+				Zuercherstrasse 68
+				Thalwil    8800
+				CH
+
+0C-62-A6   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+0C62A6     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+18-13-2D   (hex)		zte corporation
+18132D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+74-D2-1D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+74D21D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-78-D4   (hex)		Verizon 
+1878D4     (base 16)		Verizon 
+				One Verizon Way
+				Basking Ridge  NJ  07920
+				US
+
+B8-D9-4D   (hex)		Sagemcom Broadband SAS
+B8D94D     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+38-90-A5   (hex)		Cisco Systems, Inc
+3890A5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C0-74-2B   (hex)		SHENZHEN XUNLONG SOFTWARE CO.,LIMITED
+C0742B     (base 16)		SHENZHEN XUNLONG SOFTWARE CO.,LIMITED
+				Room 532, Block A, Huameiju Business Center, Xinhu Road, Baoan 82 Area
+				Shenzhen  Guangdong  518133
+				CN
+
+5C-67-76   (hex)		IDS Imaging Development Systems GmbH
+5C6776     (base 16)		IDS Imaging Development Systems GmbH
+				Dimbacher Str. 6
+				Obersulm  BW  74182
+				DE
+
+44-EA-D8   (hex)		Texas Instruments
+44EAD8     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+18-9B-A5   (hex)		IEEE Registration Authority
+189BA5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-91-B1   (hex)		Technicolor
+A491B1     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+1C-70-22   (hex)		Murata Manufacturing Co., Ltd.
+1C7022     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+CC-98-91   (hex)		Cisco Systems, Inc
+CC9891     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+28-BF-89   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+28BF89     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+90-3D-BD   (hex)		SECURE METERS LIMITED
+903DBD     (base 16)		SECURE METERS LIMITED
+				E CLASS, PRATAP NAGAR INDUSTRIAL AREA
+				UDAIPUR  RAJASTHAN  313003
+				IN
+
+00-22-94   (hex)		KYOCERA CORPORATION 
+002294     (base 16)		KYOCERA CORPORATION 
+				2-1-1,Kagahara
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+38-89-DC   (hex)		Opticon Sensors Europe B.V.
+3889DC     (base 16)		Opticon Sensors Europe B.V.
+				Opaallaan 35
+				Hoofddorp  Noord Holland  2132 XV
+				NL
+
+8C-45-00   (hex)		Murata Manufacturing Co., Ltd.
+8C4500     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+1C-DD-EA   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1CDDEA     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+94-00-06   (hex)		jinyoung
+940006     (base 16)		jinyoung
+				1000 Dongil-ro Nowon-gu Seoul
+				Seoul    01849
+				KR
+
+20-04-0F   (hex)		Dell Inc.
+20040F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+A4-34-12   (hex)		Thales Alenia Space
+A43412     (base 16)		Thales Alenia Space
+				26 av JF Champollion
+				Toulouse    31037
+				FR
+
+8C-85-90   (hex)		Apple, Inc.
+8C8590     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-88-C3   (hex)		Ningbo Dooya Mechanic & Electronic Technology Co., Ltd
+BC88C3     (base 16)		Ningbo Dooya Mechanic & Electronic Technology Co., Ltd
+				No.168 Shengguang road Luotuo street Zhenhai district
+				Ningbo  Zhejiang  315202
+				CN
+
+38-CD-07   (hex)		Beijing FaceCam Technology Co., Ltd.
+38CD07     (base 16)		Beijing FaceCam Technology Co., Ltd.
+				Room C115, DongSheng Building, No 8, East Road, Zhongguan Town, Haidian District
+				Beijing    100083
+				CN
+
+00-D0-60   (hex)		Panasonic Europe Ltd.
+00D060     (base 16)		Panasonic Europe Ltd.
+				LABORATORIES GMBH
+				    
+				DE
+
+EC-FA-03   (hex)		FCA
+ECFA03     (base 16)		FCA
+				800 Chrylser Dr
+				Auburn Hills  MI  48326
+				US
+
+6C-96-CF   (hex)		Apple, Inc.
+6C96CF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-1F-40   (hex)		Blu Wireless Technology Ltd
+681F40     (base 16)		Blu Wireless Technology Ltd
+				Bluwireless Technology, 5th Floor, 1 Temple Way
+				Bristol  Bristol, City of  BS2 0BY
+				GB
+
+90-AD-F7   (hex)		vivo Mobile Communication Co., Ltd.
+90ADF7     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+40-CE-24   (hex)		Cisco Systems, Inc
+40CE24     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-32-E6   (hex)		Panasonic Industrial Devices Europe GmbH
+3432E6     (base 16)		Panasonic Industrial Devices Europe GmbH
+				Zeppelinstraße 19
+				Lüneburg    21337
+				DE
+
+40-01-7A   (hex)		Cisco Systems, Inc
+40017A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+78-88-6D   (hex)		Apple, Inc.
+78886D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-EE-28   (hex)		Apple, Inc.
+20EE28     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-F6-1C   (hex)		Apple, Inc.
+B4F61C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-F4-AB   (hex)		Apple, Inc.
+08F4AB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-01-7C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+FC017C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+90-32-4B   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+90324B     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+60-2E-20   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+602E20     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-72-E2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E472E2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-12-7D   (hex)		MobileAria
+00127D     (base 16)		MobileAria
+				800 W El Camino Real #240
+				Mountain View  CA  94040
+				US
+
+F8-64-65   (hex)		Anova Applied Electronics, Inc.
+F86465     (base 16)		Anova Applied Electronics, Inc.
+				580 Howard Street, #403
+				san francisco  CA  94105
+				US
+
+00-20-60   (hex)		ALCATEL ITALIA S.p.A.
+002060     (base 16)		ALCATEL ITALIA S.p.A.
+				VIA TRENTO, 30
+				20059 VIMERCATE (MI)    
+				IT
+
+50-8F-4C   (hex)		Xiaomi Communications Co Ltd
+508F4C     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+A4-77-58   (hex)		Ningbo Freewings Technologies Co.,Ltd
+A47758     (base 16)		Ningbo Freewings Technologies Co.,Ltd
+				No.502 Wenshui Road, Shounan Street, Yinzhou District
+				Ningbo  Zhejiang  315192
+				CN
+
+58-A0-CB   (hex)		TrackNet, Inc
+58A0CB     (base 16)		TrackNet, Inc
+				900 Lafayette Street #329
+				Santa Clara  CA  95050
+				US
+
+00-0C-EC   (hex)		Spectracom Corp.
+000CEC     (base 16)		Spectracom Corp.
+				95 Methodist Hill Drive
+				Rochester  NY  14623
+				US
+
+E0-60-89   (hex)		Cloudleaf, Inc.
+E06089     (base 16)		Cloudleaf, Inc.
+				860 Hillview Court, Suite 350
+				Milpitas  CA  95035
+				US
+
+78-36-90   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+783690     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				Road NO2, West of Industrial Park,North of Science & Technology Park
+				Dongguan  Guangdong  518057
+				CN
+
+BC-54-FC   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+BC54FC     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+0C-4B-54   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0C4B54     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-F0-04   (hex)		Dell Inc.
+E4F004     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+94-E3-6D   (hex)		Texas Instruments
+94E36D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F0-F8-F2   (hex)		Texas Instruments
+F0F8F2     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+34-15-13   (hex)		Texas Instruments
+341513     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+74-81-9A   (hex)		PT. Hartono Istana Teknologi
+74819A     (base 16)		PT. Hartono Istana Teknologi
+				KHR Asnawi
+				Kudus  Jawa Tengah  59332
+				ID
+
+28-35-45   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+283545     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+04-4F-4C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+044F4C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-B8-1F   (hex)		ARRIS Group, Inc.
+18B81F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-15-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C151F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-8B-FC   (hex)		mixi,Inc.
+008BFC     (base 16)		mixi,Inc.
+				Sumitomo Shibuya First Tower 7F, 1-2-20 Higashi
+				Shibuya-ku  Tokyo  150-0011
+				JP
+
+A8-2B-B5   (hex)		Edgecore Networks Corporation
+A82BB5     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+E8-E1-E2   (hex)		Energotest
+E8E1E2     (base 16)		Energotest
+				Chorzowska 44B
+				Gliwice  Slask  44-100
+				PL
+
+78-11-DC   (hex)		XIAOMI Electronics,CO.,LTD
+7811DC     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+D4-63-C6   (hex)		Motorola Mobility LLC, a Lenovo Company
+D463C6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+F8-44-E3   (hex)		Taicang T&W Electronics
+F844E3     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+24-A5-34   (hex)		SynTrust Tech International Ltd. 
+24A534     (base 16)		SynTrust Tech International Ltd. 
+				10F-1, No. 125, Songde Road,
+				Taipei  Taiwan  110
+				TW
+
+C4-44-A0   (hex)		Cisco Systems, Inc
+C444A0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-74-2E   (hex)		Amazon Technologies Inc.
+18742E     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno    89507
+				US
+
+90-A3-65   (hex)		HMD Global Oy
+90A365     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+DC-44-B6   (hex)		Samsung Electronics Co.,Ltd
+DC44B6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-07-B6   (hex)		Samsung Electronics Co.,Ltd
+1007B6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-2D-0D   (hex)		Samsung Electronics Co.,Ltd
+342D0D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-4C-C8   (hex)		Dell Inc.
+A44CC8     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+D8-37-BE   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+D837BE     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				#1905 Mei Hong Road
+				Shanghai  Shanghai  200000
+				CN
+
+D4-68-4D   (hex)		Ruckus Wireless
+D4684D     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+8C-0C-90   (hex)		Ruckus Wireless
+8C0C90     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+6C-AA-B3   (hex)		Ruckus Wireless
+6CAAB3     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-13-92   (hex)		Ruckus Wireless
+001392     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+08-51-14   (hex)		QINGDAO TOPSCOMM COMMUNICATION CO., LTD
+085114     (base 16)		QINGDAO TOPSCOMM COMMUNICATION CO., LTD
+				7/F, Building 6, NO.288, Ningxia Road
+				Qingdao   Shandong  266024
+				CN
+
+D0-5A-00   (hex)		Technicolor CH USA Inc.
+D05A00     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+70-78-8B   (hex)		vivo Mobile Communication Co., Ltd.
+70788B     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+48-59-A4   (hex)		zte corporation
+4859A4     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+54-BD-79   (hex)		Samsung Electronics Co.,Ltd
+54BD79     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+A0-42-3F   (hex)		Tyan Computer Corp
+A0423F     (base 16)		Tyan Computer Corp
+				3288 Larurelview Court
+				Fremont  CA  94538
+				US
+
+70-F1-1C   (hex)		Shenzhen Ogemray Technology Co.,Ltd
+70F11C     (base 16)		Shenzhen Ogemray Technology Co.,Ltd
+				4/F,5Bldg,Dongwu Industrial Park, Donghuan 1st Rd, Longhua District.
+				Shenzhen    518059
+				CN
+
+70-65-A3   (hex)		Kandao lightforge Co., Ltd.
+7065A3     (base 16)		Kandao lightforge Co., Ltd.
+				5th Floor, M7 Steel Building, the second way in Technology Road , Nanshan District, 
+				Shenzhen  Guangdong  518057
+				CN
+
+14-14-4B   (hex)		Ruijie Networks Co.,LTD
+14144B     (base 16)		Ruijie Networks Co.,LTD
+				19-22# Building,Star-net Science Plaza,Juyuanzhou, 
+				FUZHOU  FUJIAN  350002
+				CN
+
+74-D0-DC   (hex)		Ericsson AB
+74D0DC     (base 16)		Ericsson AB
+				Torshamnsgatan 48
+				STOCKHOLM    164 83
+				SE
+
+C0-8A-DE   (hex)		Ruckus Wireless
+C08ADE     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-1D-2E   (hex)		Ruckus Wireless
+001D2E     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+B4-E6-2A   (hex)		LG Innotek
+B4E62A     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+A0-C5-F2   (hex)		IEEE Registration Authority
+A0C5F2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A8-6B-7C   (hex)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+A86B7C     (base 16)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+				ORIENTAL CYBERPORT, HIGHTECH 6 ROAD
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+B0-39-56   (hex)		NETGEAR
+B03956     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+3C-0C-DB   (hex)		UNIONMAN TECHNOLOGY CO.,LTD
+3C0CDB     (base 16)		UNIONMAN TECHNOLOGY CO.,LTD
+				18F, HUAYANG TOWER,YANDAYI ROAD
+				Huizhou  Guangdong  516007
+				CN
+
+EC-42-B4   (hex)		ADC Corporation
+EC42B4     (base 16)		ADC Corporation
+				77-1, Miyako
+				Namegawa-machi, Hiki-gun  Saitama Pref.  355-0812
+				JP
+
+60-DA-83   (hex)		Hangzhou H3C Technologies Co., Limited
+60DA83     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+2C-57-31   (hex)		 Wingtech Group (HongKong）Limited
+2C5731     (base 16)		 Wingtech Group (HongKong）Limited
+				 FLAT/RM 1903 19/F PODIUM PLAZA 5HANOI ROAD TSIM SHA TSUI
+				Hong Kong  Hong Kong  999077
+				HK
+
+CC-46-39   (hex)		WAAV, Inc.
+CC4639     (base 16)		WAAV, Inc.
+				151 PEARL ST FL 4
+				BOSTON  MA  02110
+				US
+
+AC-9E-17   (hex)		ASUSTek COMPUTER INC.
+AC9E17     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+64-16-66   (hex)		Nest Labs Inc.
+641666     (base 16)		Nest Labs Inc.
+				3400 Hillview Ave.
+				Palo Alto  CA  94304
+				US
+
+D8-DF-7A   (hex)		Quest Software, Inc.
+D8DF7A     (base 16)		Quest Software, Inc.
+				4 Polaris Way
+				Aliso Viejo  CA  92656
+				US
+
+14-5B-E1   (hex)		nyantec GmbH
+145BE1     (base 16)		nyantec GmbH
+				Europaplatz 2
+				Berlin    10557
+				DE
+
+A0-23-9F   (hex)		Cisco Systems, Inc
+A0239F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+70-F3-5A   (hex)		Cisco Systems, Inc
+70F35A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-34-1B   (hex)		Adero Inc
+A0341B     (base 16)		Adero Inc
+				7410 HOllister Ave
+				Goleta  CA  93117
+				US
+
+A0-AF-BD   (hex)		Intel Corporate
+A0AFBD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+7C-8B-CA   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+7C8BCA     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-4E-26   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B04E26     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-89-C2   (hex)		Zyptonite
+B089C2     (base 16)		Zyptonite
+				1460 Broadway, 12 fl.
+				New York  NY  10036
+				US
+
+F0-23-B9   (hex)		IEEE Registration Authority
+F023B9     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+FC-4D-D4   (hex)		Universal Global Scientific Industrial Co., Ltd.
+FC4DD4     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Rd. Sec. 1, Tsao Tuen,
+				Nan-Tou Hsien,     542
+				TW
+
+A4-F4-C2   (hex)		VNPT TECHNOLOGY
+A4F4C2     (base 16)		VNPT TECHNOLOGY
+				HoaLac Hi-Tech Park
+				HANOI  HANOI  10000
+				VN
+
+8C-14-7D   (hex)		IEEE Registration Authority
+8C147D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+30-07-4D   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+30074D     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+1C-1F-D4   (hex)		LifeBEAM Technologies LTD
+1C1FD4     (base 16)		LifeBEAM Technologies LTD
+				150 Greenwich st 4WTC - 29th floor
+				New York  NY  10007
+				US
+
+00-9A-D2   (hex)		Cisco Systems, Inc
+009AD2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-7F-77   (hex)		Connected Home
+447F77     (base 16)		Connected Home
+				19-22, Rathbone Place
+				London    W1T 1HY
+				GB
+
+E8-B6-C2   (hex)		Juniper Networks
+E8B6C2     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+94-7B-E7   (hex)		Samsung Electronics Co.,Ltd
+947BE7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-92-B9   (hex)		Samsung Electronics Co.,Ltd
+5092B9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-74-A8   (hex)		Samsung Electronics Co.,Ltd
+DC74A8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E8-39-35   (hex)		Hewlett Packard
+E83935     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-18-0A   (hex)		Cisco Meraki
+00180A     (base 16)		Cisco Meraki
+				99 Rhode Island St.
+				San Francisco,  CA  94103
+				US
+
+5C-6A-80   (hex)		Zyxel Communications Corporation
+5C6A80     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+D8-60-B3   (hex)		Guangdong Global Electronic Technology CO.，LTD
+D860B3     (base 16)		Guangdong Global Electronic Technology CO.，LTD
+				 Floor4 East side,build#6,Huangzhou industry Park, chebei Road, Tianhe District
+				GuangZhou  GuangDong  510660
+				CN
+
+64-35-1C   (hex)		e-CON SYSTEMS INDIA PVT LTD
+64351C     (base 16)		e-CON SYSTEMS INDIA PVT LTD
+				RR Tower 4, 7th Floor, TVK IND Estate, Guindy
+				Chennai  Other  600032
+				IN
+
+60-BA-18   (hex)		nextLAP GmbH
+60BA18     (base 16)		nextLAP GmbH
+				Hofmannstr. 61
+				München    81379
+				DE
+
+44-AA-50   (hex)		Juniper Networks
+44AA50     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+84-CD-62   (hex)		ShenZhen IDWELL Technology CO.,Ltd
+84CD62     (base 16)		ShenZhen IDWELL Technology CO.,Ltd
+				4F,Building 20 Changxing Industrial Park,Shayi,Shajing,BaoAn
+				ShenZhen    518000
+				CN
+
+A8-D5-79   (hex)		Beijing Chushang Science and Technology Co.,Ltd
+A8D579     (base 16)		Beijing Chushang Science and Technology Co.,Ltd
+				3A285 room,3 layer,1 building,No 11 of yongwai song zhuang road,Fengtai district,Beijing
+				Beijing  Beijing  518000
+				CN
+
+44-48-C1   (hex)		Hewlett Packard Enterprise
+4448C1     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+48-10-63   (hex)		NTT Innovation Institute, Inc.
+481063     (base 16)		NTT Innovation Institute, Inc.
+				1950 University Avenue, Suite 600
+				East Palo Alto  CA  94303
+				US
+
+A0-8E-78   (hex)		Sagemcom Broadband SAS
+A08E78     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+88-D5-0C   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+88D50C     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D4-28-D5   (hex)		TCT mobile ltd
+D428D5     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+9C-AF-6F   (hex)		ITEL MOBILE LIMITED
+9CAF6F     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+FC-53-9E   (hex)		Shanghai Wind Technologies Co.,Ltd
+FC539E     (base 16)		Shanghai Wind Technologies Co.,Ltd
+				Floor 8,East Building,Guilin Technology Mansion,No.650,Caobao Road,XuHui District,Shanghai,P.R.China
+				Shanghai  Shanghai  200233
+				CN
+
+60-53-17   (hex)		Sandstone Technologies
+605317     (base 16)		Sandstone Technologies
+				1920 lyell ave
+				Rochester  NY  14606
+				US
+
+90-70-65   (hex)		Texas Instruments
+907065     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+18-A9-58   (hex)		PROVISION THAI CO., LTD.
+18A958     (base 16)		PROVISION THAI CO., LTD.
+				155/7-10 Rachadapisek Rd.,
+				Thonburi  Bangkok  10600
+				TH
+
+74-C9-A3   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+74C9A3     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+EC-8A-4C   (hex)		zte corporation
+EC8A4C     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-5F-25   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+D45F25     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+40-C8-CB   (hex)		AM Telecom co., Ltd.
+40C8CB     (base 16)		AM Telecom co., Ltd.
+				#608,YatapLeaders B/D, Jangmi-ro 42, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-828
+				KR
+
+2C-AB-EB   (hex)		Cisco Systems, Inc
+2CABEB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-3A-6B   (hex)		Roku, Inc
+C83A6B     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+B4-C6-F8   (hex)		Axilspot Communication
+B4C6F8     (base 16)		Axilspot Communication
+				A302 Han's Innovation Building, No.9018 Beihuan Ave., Nanshan District
+				Shenzhen    518000
+				CN
+
+9C-E9-51   (hex)		Shenzhen Sang Fei Consumer Communications Ltd., Co.
+9CE951     (base 16)		Shenzhen Sang Fei Consumer Communications Ltd., Co.
+				11,Science And Technology Road, Shenzhen Hi-tech Industrial Park, Nanshan District
+				 Shenzhen City  Guangdong  518057
+				CN
+
+B8-D5-0B   (hex)		Sunitec Enterprise Co.,Ltd
+B8D50B     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+BC-66-DE   (hex)		Shadow Creator Information Technology Co.,Ltd.
+BC66DE     (base 16)		Shadow Creator Information Technology Co.,Ltd.
+				Shanghai City, Pudong New Area Zhangjiang road 368, Building 29, room 611 
+				Shanghai  Shanghai  200120
+				CN
+
+18-68-CB   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+1868CB     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+C4-AE-12   (hex)		Samsung Electronics Co.,Ltd
+C4AE12     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-1F-A4   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+001FA4     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				4F,Baiying Building, No.1019,Nanhai RD,Shekou,
+				ShenZhen  GuangDong  518067
+				CN
+
+D4-DC-CD   (hex)		Apple, Inc.
+D4DCCD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-4B-AA   (hex)		Apple, Inc.
+484BAA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-A9-04   (hex)		Apple, Inc.
+DCA904     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-AB-31   (hex)		Apple, Inc.
+6CAB31     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-74-BF   (hex)		Apple, Inc.
+4C74BF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-94-6B   (hex)		TECNO MOBILE LIMITED
+04946B     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+A0-4C-5B   (hex)		Shenzhen TINNO Mobile Technology Corp.
+A04C5B     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+48-88-03   (hex)		ManTechnology Inc.
+488803     (base 16)		ManTechnology Inc.
+				12th Fl, 308-4 Seongsoodong 2ga, Seongdonggu
+				Seoul    04781
+				KR
+
+B4-36-E3   (hex)		KBVISION GROUP
+B436E3     (base 16)		KBVISION GROUP
+				337 N. Vineyard Avenue,  4th Floor,  San Jose, CA 91764
+				San Jose  CA  90847
+				US
+
+94-D2-99   (hex)		Techmation Co.,Ltd.
+94D299     (base 16)		Techmation Co.,Ltd.
+				9F., No.529, Zhongzheng Rd., Xindian Dist., New Taipei City 231, Taiwan
+				New Taipei City     231
+				TW
+
+34-1A-35   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+341A35     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+2C-02-9F   (hex)		3ALogics
+2C029F     (base 16)		3ALogics
+				#704, Hyundai office B'd, Sunae-dong, Bundang-gu
+				Seongnam-si    13601
+				KR
+
+64-D1-54   (hex)		Routerboard.com
+64D154     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+58-D9-D5   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+58D9D5     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+6C-4B-90   (hex)		LiteON
+6C4B90     (base 16)		LiteON
+				5F, No.90, Rd. Chien 1, ChungHo
+				New Taipei  Taiwan  23505
+				TW
+
+00-05-0F   (hex)		Tanaka S/S Ltd.
+00050F     (base 16)		Tanaka S/S Ltd.
+				1942 Nomura Hirooka
+				Nagano  399-0702  
+				JP
+
+98-9E-63   (hex)		Apple, Inc.
+989E63     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-6B-6E   (hex)		Apple, Inc.
+886B6E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-E4-AD   (hex)		zte corporation
+F4E4AD     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+28-FF-3E   (hex)		zte corporation
+28FF3E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B8-D7-AF   (hex)		Murata Manufacturing Co., Ltd.
+B8D7AF     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+D4-AE-05   (hex)		Samsung Electronics Co.,Ltd
+D4AE05     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-48-AF   (hex)		Premietech Limited
+E048AF     (base 16)		Premietech Limited
+				Unit 805, Tower 3, Enterprise Square I
+				No. 9 Sheung Yuet Road  Kowloon Bay  HongKong  00000
+				HK
+
+2C-33-11   (hex)		Cisco Systems, Inc
+2C3311     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-82-D5   (hex)		Apple, Inc.
+5082D5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-EE-10   (hex)		Samsung Electronics Co.,Ltd
+F0EE10     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-70-0B   (hex)		GUANGZHOU CHIP TECHNOLOGIES CO.,LTD
+C4700B     (base 16)		GUANGZHOU CHIP TECHNOLOGIES CO.,LTD
+				4th floor, Building J of JiTang Industrial Zone, No. 8 NanYun fifth road, HuangPu District
+				Guangzhou  Guangdong  510700
+				CN
+
+3C-A0-67   (hex)		Liteon Technology Corporation
+3CA067     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+BC-02-4A   (hex)		HMD Global Oy
+BC024A     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+94-99-01   (hex)		Shenzhen YITOA Digital Appliance CO.,LTD
+949901     (base 16)		Shenzhen YITOA Digital Appliance CO.,LTD
+				5/F,Yitoa Building,Keji South Road 5th,Hi-tech Industrial Park,Nanshan District,
+				shenzhen  Guangdong  518000
+				CN
+
+F8-59-71   (hex)		Intel Corporate
+F85971     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-05-CA   (hex)		Cisco Systems, Inc
+1005CA     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+78-94-B4   (hex)		Sercomm Corporation.
+7894B4     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+44-37-08   (hex)		MRV Comunications
+443708     (base 16)		MRV Comunications
+				Hayetzira
+				Yokneam    614
+				IL
+
+28-5F-2F   (hex)		RNware Co.,Ltd.
+285F2F     (base 16)		RNware Co.,Ltd.
+				#202 ICT Park Bldg, 205, Songhyun-ro, Dalseo-gu
+				Daegu    42734
+				KR
+
+50-0F-F5   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+500FF5     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+BC-45-2E   (hex)		Knowledge Development for POF S.L.
+BC452E     (base 16)		Knowledge Development for POF S.L.
+				Ronda de Poniente 14, 2-C,D
+				Tres Cantos  Madrid  28760
+				ES
+
+DC-C6-4B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DCC64B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-33-89   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+043389     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-A0-68   (hex)		BHP LIMITED
+00A068     (base 16)		BHP LIMITED
+				1500 Post Oak Boulevard #11.08 B
+				Houston  TX  77056-3030
+				US
+
+70-3A-CB   (hex)		Google, Inc.
+703ACB     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+70-6D-EC   (hex)		Wifi-soft LLC
+706DEC     (base 16)		Wifi-soft LLC
+				616, West Monroe
+				Austin  TX  78704
+				US
+
+B0-C2-05   (hex)		BIONIME
+B0C205     (base 16)		BIONIME
+				No.100, Sec.2, Daqing St., South Dist.,
+				Taichung  Taiwan  40242
+				TW
+
+94-F5-51   (hex)		Cadi Scientific Pte Ltd
+94F551     (base 16)		Cadi Scientific Pte Ltd
+				31 Ubi Road 1, Aztech Building, #07-01A
+				Singapore    408694
+				SG
+
+10-5A-F7   (hex)		ADB Italia 
+105AF7     (base 16)		ADB Italia 
+				Viale Sarca 222
+				Milan  Italy  20126
+				IT
+
+B8-1D-AA   (hex)		LG Electronics (Mobile Communications)
+B81DAA     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-E4-00   (hex)		Sichuan Changhong Electric Ltd.
+00E400     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+2C-55-D3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2C55D3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-C0-24   (hex)		EDEN SISTEMAS DE COMPUTACAO SA
+00C024     (base 16)		EDEN SISTEMAS DE COMPUTACAO SA
+				RUA DO OUVIDOR 121 5 ANDAR
+				    
+				BR
+
+7C-46-85   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+7C4685     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+1C-1E-E3   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+1C1EE3     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+44-03-2C   (hex)		Intel Corporate
+44032C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+78-68-F7   (hex)		YSTen Technology Co.,Ltd
+7868F7     (base 16)		YSTen Technology Co.,Ltd
+				Room 1715,17/F North Star Times Tower,Chaoyang District,Beijing.
+				Beijing    100101
+				CN
+
+00-4B-F3   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+004BF3     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+08-CC-A7   (hex)		Cisco Systems, Inc
+08CCA7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-96-AD   (hex)		Cisco Systems, Inc
+0896AD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-23-B2   (hex)		vivo Mobile Communication Co., Ltd.
+0823B2     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+88-C3-B3   (hex)		SOVICO
+88C3B3     (base 16)		SOVICO
+				2271-5 Nambusunhwan-ro, Seocho-gu
+				Seoul    06703
+				KR
+
+E0-51-24   (hex)		NXP Semiconductors
+E05124     (base 16)		NXP Semiconductors
+				411 E. Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-1D-A3   (hex)		SabiOso
+001DA3     (base 16)		SabiOso
+				189 S State Suite #250
+				Clearfield  Utah  84015
+				US
+
+54-2F-8A   (hex)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+542F8A     (base 16)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+				Av. Buriti, 1900 – Setor B – Distrito Industrial
+				Manaus  Amazonas  69075-000
+				BR
+
+60-14-B3   (hex)		CyberTAN Technology Inc.
+6014B3     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+10-56-11   (hex)		ARRIS Group, Inc.
+105611     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+34-78-77   (hex)		O-Net Communications (Shenzhen) Limited
+347877     (base 16)		O-Net Communications (Shenzhen) Limited
+				#10-1 South,Maqueling Industrial Park,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-20-CC   (hex)		DIGITAL SERVICES, LTD.
+0020CC     (base 16)		DIGITAL SERVICES, LTD.
+				9 WAYTE STREET
+				ENGLAND  PO6  3BS
+				GB
+
+68-9F-F0   (hex)		zte corporation
+689FF0     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+5C-AF-06   (hex)		LG Electronics (Mobile Communications)
+5CAF06     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-17-9B   (hex)		CHANT SINCERE CO.,LTD
+00179B     (base 16)		CHANT SINCERE CO.,LTD
+				7F-2,NO.188,Sec 3,Ta Tung Rood,
+				Hsi Chih City  Taipei Hsien  221
+				TW
+
+1C-39-8A   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+1C398A     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-65-D4   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+E865D4     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+24-D5-1C   (hex)		Zhongtian broadband technology co., LTD 
+24D51C     (base 16)		Zhongtian broadband technology co., LTD 
+				Rudong hekou town Zhongtian industrial park
+				Nantong  jiangsu Province  226463
+				CN
+
+EC-43-F6   (hex)		Zyxel Communications Corporation
+EC43F6     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+60-C6-58   (hex)		PHYTRONIX Co.,Ltd.
+60C658     (base 16)		PHYTRONIX Co.,Ltd.
+				1877-3 Ootashimo-machi
+				Takamatsu  Kagawa  761-8073
+				JP
+
+FC-B5-8A   (hex)		Wapice Ltd.
+FCB58A     (base 16)		Wapice Ltd.
+				Yliopistonranta 5
+				Vaasa    65200
+				FI
+
+A4-62-DF   (hex)		DS Global. Co., LTD
+A462DF     (base 16)		DS Global. Co., LTD
+				3F, 107, Gasan digital 2-ro, Geumcheon-gu
+				Seoul    08505
+				KR
+
+4C-16-94   (hex)		shenzhen sibituo Technology Co., Ltd
+4C1694     (base 16)		shenzhen sibituo Technology Co., Ltd
+				15C Yuehua Park Nanshan Road Nanshan District
+				SHENZHEN  guangdong  518000
+				CN
+
+C8-14-51   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C81451     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-D4-37   (hex)		Inteno Broadband Technology AB
+44D437     (base 16)		Inteno Broadband Technology AB
+				Stensätravägen 13
+				Skärholmen  SE  127 39 
+				SE
+
+EC-E1-54   (hex)		Beijing Unisound Information Technology Co.,Ltd.
+ECE154     (base 16)		Beijing Unisound Information Technology Co.,Ltd.
+				Rm406,keyan Building,Tsinghua Hi-tech Park,High-tech Industrial Park North Area,Nanshan
+				Shenzhen    518057
+				CN
+
+6C-16-0E   (hex)		ShotTracker
+6C160E     (base 16)		ShotTracker
+				7220 W Frontage Rd
+				Merriam  KS  66203
+				US
+
+80-3A-0A   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+803A0A     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+0C-73-BE   (hex)		Dongguan Haimai Electronie Technology Co.,Ltd
+0C73BE     (base 16)		Dongguan Haimai Electronie Technology Co.,Ltd
+				Room 701，Yifeng Building7, No.8 Industrial Zone, Xianbian Road, Changan Town Xiaobian edge
+				Dongguan  Guangdong  518000
+				CN
+
+28-6F-7F   (hex)		Cisco Systems, Inc
+286F7F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F0-C8-50   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F0C850     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-01-4F   (hex)		Adtran Inc
+00014F     (base 16)		Adtran Inc
+				901 Explorer Blvd.
+				Huntsville  AL  35806-2807
+				US
+
+28-52-61   (hex)		Cisco Systems, Inc
+285261     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-AA-55   (hex)		Hunan Comtom Electronic Incorporated Co.,Ltd
+C8AA55     (base 16)		Hunan Comtom Electronic Incorporated Co.,Ltd
+				6 -7 Floor, Jindan Building B,Xiongtian Road, Furong District
+				changsha  Hunan  410126
+				CN
+
+20-78-0B   (hex)		Delta Faucet Company
+20780B     (base 16)		Delta Faucet Company
+				55 East 111th Street
+				Indianapolis  IN  46280
+				US
+
+88-09-AF   (hex)		Masimo Corporation
+8809AF     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine    92618
+				US
+
+2C-D0-2D   (hex)		Cisco Systems, Inc
+2CD02D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-CC-83   (hex)		Juniper Networks
+9CCC83     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+2C-63-73   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+2C6373     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+24-A7-DC   (hex)		BSkyB Ltd
+24A7DC     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+64-DB-A0   (hex)		Select Comfort
+64DBA0     (base 16)		Select Comfort
+				9800 59th Ave N
+				Minneapolis  MN  55442
+				US
+
+F8-98-3A   (hex)		Leeman International (HongKong) Limited
+F8983A     (base 16)		Leeman International (HongKong) Limited
+				Number 13 first floor Y1 cultural creative park bantian
+				shen zhen     51800
+				CN
+
+4C-EC-EF   (hex)		Soraa, Inc.
+4CECEF     (base 16)		Soraa, Inc.
+				6500 Kaiser Dr Suite 110
+				Fremont  CA  94555
+				US
+
+1C-EF-CE   (hex)		bebro electronic GmbH
+1CEFCE     (base 16)		bebro electronic GmbH
+				MAx-Planck-Str. 6-8
+				Frickenhausen    72636
+				DE
+
+98-B6-E9   (hex)		Nintendo Co.,Ltd
+98B6E9     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+F0-15-B9   (hex)		PlayFusion Limited
+F015B9     (base 16)		PlayFusion Limited
+				St  Johns Innovation Centre
+				Cambridge    CB4 0WS
+				GB
+
+64-B0-A6   (hex)		Apple, Inc.
+64B0A6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-04-D0   (hex)		Apple, Inc.
+7C04D0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-FC-AC   (hex)		Apple, Inc.
+84FCAC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-0C-5C   (hex)		Apple, Inc.
+DC0C5C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-70-0D   (hex)		Apple, Inc.
+70700D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-E1-71   (hex)		Hewlett Packard
+30E171     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+18-65-90   (hex)		Apple, Inc.
+186590     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-62-14   (hex)		Apple, Inc.
+F86214     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-4F-43   (hex)		Apple, Inc.
+784F43     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-4D-7F   (hex)		Apple, Inc.
+404D7F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1D-72   (hex)		Wistron Corporation
+001D72     (base 16)		Wistron Corporation
+				21F, 88, Sec.1, Hsin Tai Wu Rd., Hsichih,
+				Taipei Hsien    221
+				TW
+
+D8-19-7A   (hex)		Nuheara Ltd
+D8197A     (base 16)		Nuheara Ltd
+				Unit 5, 28 John St
+				Northbridge  WA  6003
+				AU
+
+4C-38-D5   (hex)		MITAC COMPUTING TECHNOLOGY CORPORATION
+4C38D5     (base 16)		MITAC COMPUTING TECHNOLOGY CORPORATION
+				3F., NO.1, R&D ROAD 2, HSINCHU SCIENCE PARK
+				HSINCHU    30076
+				TW
+
+54-B5-6C   (hex)		Xi'an NovaStar Tech Co., Ltd
+54B56C     (base 16)		Xi'an NovaStar Tech Co., Ltd
+				4F, Block D, Qinfeng Pavilion, Xi'an Software Park, No.68 Keji 2nd Rd.,
+				 Xi'an  Shanxi  710075
+				CN
+
+34-4C-C8   (hex)		Echodyne Corp
+344CC8     (base 16)		Echodyne Corp
+				2380 116th Ave NE
+				Bellevue   WA  98004
+				US
+
+64-13-6C   (hex)		zte corporation
+64136C     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+04-B6-48   (hex)		ZENNER
+04B648     (base 16)		ZENNER
+				Roemerstadt 6
+				Saarbruecken    66121
+				DE
+
+98-F1-99   (hex)		NEC Platforms, Ltd.
+98F199     (base 16)		NEC Platforms, Ltd.
+				2-3 Kandatsukasamachi
+				Chiyodaku  Tokyo  101-8532
+				JP
+
+18-40-A4   (hex)		Shenzhen Trylong Smart Science and Technology Co., Ltd.
+1840A4     (base 16)		Shenzhen Trylong Smart Science and Technology Co., Ltd.
+				15E, qingdian building, No#6007, Binhe road, futian district
+				Shenzhen city  Guangdong Province  518100
+				CN
+
+1C-48-CE   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1C48CE     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+C8-0C-C8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C80CC8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-25-C5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0425C5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-3E-7B   (hex)		Gafachi, Inc.
+603E7B     (base 16)		Gafachi, Inc.
+				1 W Main St., STE 650
+				Rochester  NY  14614
+				US
+
+4C-74-87   (hex)		Leader Phone Communication Technology Co., Ltd.
+4C7487     (base 16)		Leader Phone Communication Technology Co., Ltd.
+				121 Room (Park) No.1 Building, No.10 Xinghuo Road  Science City Feng-tai District, Beijing, China
+				Beijing    100070
+				CN
+
+AC-83-F3   (hex)		AMPAK Technology, Inc.
+AC83F3     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+CC-8C-DA   (hex)		Shenzhen Wei Da Intelligent Technology Go.,Ltd
+CC8CDA     (base 16)		Shenzhen Wei Da Intelligent Technology Go.,Ltd
+				5K, Block B,Yueshang Center Cultural Square Jianshe East Rd Longhua New District
+				Shenzhen    518109
+				CN
+
+D4-36-DB   (hex)		Jiangsu Toppower Automotive Electronics Co., Ltd
+D436DB     (base 16)		Jiangsu Toppower Automotive Electronics Co., Ltd
+				No. 2 Tuolanshan Road
+				Xuzhou  Jiangsu  221004
+				CN
+
+2C-DC-AD   (hex)		Wistron Neweb Corporation
+2CDCAD     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+6C-5C-14   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+6C5C14     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+E8-09-45   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+E80945     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+B0-A2-E7   (hex)		Shenzhen TINNO Mobile Technology Corp.
+B0A2E7     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+7C-25-87   (hex)		chaowifi.com
+7C2587     (base 16)		chaowifi.com
+				No. 502 1th Building TaiHe Square
+				HangZhou  QianJiangRoad  310002
+				CN
+
+2C-21-31   (hex)		Juniper Networks
+2C2131     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-50-1E   (hex)		Grass Valley, A Belden Brand
+00501E     (base 16)		Grass Valley, A Belden Brand
+				3499, Douglas B. Floreani
+				Montreal  Quebec  H4S 2C6
+				CA
+
+EC-0D-9A   (hex)		Mellanox Technologies, Inc.
+EC0D9A     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+90-D7-BE   (hex)		Wavelab Global Inc.
+90D7BE     (base 16)		Wavelab Global Inc.
+				12007 Sunrise Valley Drive, Suite 450
+				Reston  VA  20191
+				US
+
+24-4E-7B   (hex)		IEEE Registration Authority
+244E7B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+30-AE-A4   (hex)		Espressif Inc.
+30AEA4     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+3C-FA-43   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3CFA43     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-5F-94   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+145F94     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-1F-82   (hex)		Cal-Comp Electronics & Communications Company Ltd.
+001F82     (base 16)		Cal-Comp Electronics & Communications Company Ltd.
+				No.147, Sec. 3, Beishen Rd
+				Shenkeng Dist  New Taipei City  ---
+				TW
+
+88-3C-1C   (hex)		MERCURY CORPORATION
+883C1C     (base 16)		MERCURY CORPORATION
+				90, Gajaeul-ro, Seo-gu
+				INCHEON    22830
+				KR
+
+00-21-44   (hex)		SS Telecoms
+002144     (base 16)		SS Telecoms
+				23 Botha Avenue
+				Centurion  Gauteng  0140
+				ZA
+
+00-6B-F1   (hex)		Cisco Systems, Inc
+006BF1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+28-34-A2   (hex)		Cisco Systems, Inc
+2834A2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+78-23-AE   (hex)		ARRIS Group, Inc.
+7823AE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+20-71-9E   (hex)		SF Technology Co.,Ltd
+20719E     (base 16)		SF Technology Co.,Ltd
+				1/F,Block B,Building 1,ShenzhenSoftware Industry Base,Hi-Tech Industrial Park South
+				Shenzhen  Guangdong Province  518054
+				CN
+
+2C-C2-60   (hex)		Oracle Corporation 
+2CC260     (base 16)		Oracle Corporation 
+				Zarhin 13
+				Raanana    4366241
+				IL
+
+3C-3F-51   (hex)		2CRSI
+3C3F51     (base 16)		2CRSI
+				32 rue Jacobi-Netter
+				STRASBOURG  France  67200
+				FR
+
+3C-2A-F4   (hex)		Brother Industries, LTD.
+3C2AF4     (base 16)		Brother Industries, LTD.
+				15-1, Naeshirocho, Mizuho-ku
+				NAGOYA    4678561
+				JP
+
+C0-85-4C   (hex)		Ragentek Technology Group
+C0854C     (base 16)		Ragentek Technology Group
+				D10/D11，No.3188, Xiupu Road, PuDong District, Shanghai
+				Shanghai    201315
+				CN
+
+00-24-AC   (hex)		Hangzhou DPtech Technologies Co., Ltd.
+0024AC     (base 16)		Hangzhou DPtech Technologies Co., Ltd.
+				Huarong Shidai Bld., NO.3880,Jiang-Nan Avenue, Binjiang District
+				Hangzhou  Zhejiang  310051
+				CN
+
+50-58-4F   (hex)		waytotec,Inc.
+50584F     (base 16)		waytotec,Inc.
+				#604-4,B-Dong,Bundang Technopark,148,Yatap-dong,Bundang-gu,
+				Seongnam-si  Gyeonggi-do  13511
+				KR
+
+08-5D-DD   (hex)		MERCURY CORPORATION
+085DDD     (base 16)		MERCURY CORPORATION
+				90, Gajaeul-ro, Seo-gu
+				INCHEON    22830
+				KR
+
+8C-60-E7   (hex)		MPGIO CO.,LTD
+8C60E7     (base 16)		MPGIO CO.,LTD
+				MPGIO Bldg., 98 Uijeong St.,
+				Uijeongbu  Korea / Gyeonggi  11623
+				KR
+
+CC-94-70   (hex)		Kinestral Technologies, Inc.
+CC9470     (base 16)		Kinestral Technologies, Inc.
+				400 E Jamie Ct., Ste. 201
+				South San Francisco  CA  94080
+				US
+
+B4-39-D6   (hex)		ProCurve Networking by HP
+B439D6     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+34-F3-9A   (hex)		Intel Corporate
+34F39A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+D8-16-C1   (hex)		DEWAV (HK) ELECTRONICS LIMITED
+D816C1     (base 16)		DEWAV (HK) ELECTRONICS LIMITED
+				UNIT NO.1-2, 06/F., PERFECT INDUSTRIAL BUILDING,NO. 31 TAI YAU STREET, SAN PO KONG
+				KOWLOON, HONG KONG    510610
+				CN
+
+CC-61-E5   (hex)		Motorola Mobility LLC, a Lenovo Company
+CC61E5     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+8C-8A-BB   (hex)		Beijing Orient View Technology Co., Ltd.
+8C8ABB     (base 16)		Beijing Orient View Technology Co., Ltd.
+				Building NO.1, LiYe Road 7
+				Huilongguan Town  Changping District, Beijing  102206
+				CN
+
+00-03-9B   (hex)		NetChip Technology, Inc.
+00039B     (base 16)		NetChip Technology, Inc.
+				335 Pioneer Way
+				Mountain View  CA  94041
+				US
+
+44-D9-E7   (hex)		Ubiquiti Networks Inc.
+44D9E7     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Parkway
+				San Jose  CA  95131
+				US
+
+24-A4-3C   (hex)		Ubiquiti Networks Inc.
+24A43C     (base 16)		Ubiquiti Networks Inc.
+				91 E. Tasman Dr.
+				San Jose    95134
+				US
+
+9C-8B-A0   (hex)		Apple, Inc.
+9C8BA0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-08-8D   (hex)		Apple, Inc.
+CC088D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-A4-ED   (hex)		Xiaomi Communications Co Ltd
+38A4ED     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+B8-99-19   (hex)		7signal Solutions, Inc
+B89919     (base 16)		7signal Solutions, Inc
+				526 S. Main Street
+				Akron  OH  44311
+				US
+
+40-FE-0D   (hex)		MAXIO
+40FE0D     (base 16)		MAXIO
+				1101-1 digital empire A, 387 simin-daero dongan-gu
+				anyang-si  kyunggi-do  14057
+				KR
+
+AC-64-DD   (hex)		IEEE Registration Authority
+AC64DD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-B8-19   (hex)		Nokia
+94B819     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+78-7D-48   (hex)		ITEL MOBILE LIMITED
+787D48     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+88-71-E5   (hex)		Amazon Technologies Inc.
+8871E5     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+BC-39-D9   (hex)		Z-TEC
+BC39D9     (base 16)		Z-TEC
+				Donyu 1 Ro
+				Paju  Kyeongkido  10832
+				KR
+
+60-9A-C1   (hex)		Apple, Inc.
+609AC1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-8D-08   (hex)		Apple, Inc.
+748D08     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-B0-EE   (hex)		Ajile Systems, Inc.
+00B0EE     (base 16)		Ajile Systems, Inc.
+				920 Saratoga Ave.
+				San Jose  CA  95129
+				US
+
+04-18-D6   (hex)		Ubiquiti Networks Inc.
+0418D6     (base 16)		Ubiquiti Networks Inc.
+				91 E. Tasman Dr.
+				San Jose    95134
+				US
+
+20-DB-AB   (hex)		Samsung Electronics Co., Ltd.
+20DBAB     (base 16)		Samsung Electronics Co., Ltd.
+				416, Maetan-3Dong, Yeongtong-Gu
+				Suwon  Geyonggi-Do  443-742
+				KR
+
+38-3A-21   (hex)		IEEE Registration Authority
+383A21     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D8-38-0D   (hex)		SHENZHEN IP-COM Network Co.,Ltd
+D8380D     (base 16)		SHENZHEN IP-COM Network Co.,Ltd
+				No.1001,Zhongshangyuan Road,Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+88-AD-43   (hex)		PEGATRON CORPORATION
+88AD43     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+B4-EF-FA   (hex)		Lemobile Information Technology (Beijing) Co., Ltd.
+B4EFFA     (base 16)		Lemobile Information Technology (Beijing) Co., Ltd.
+				5/F LeEco Building, 105 Yaojiayuan Road, Chaoyang District 
+				Beijing  Beijing  100025
+				CN
+
+6C-71-BD   (hex)		EZELINK TELECOM
+6C71BD     (base 16)		EZELINK TELECOM
+				Bay Square Building 06 - Office No 105
+				Dubai  Dubai  111581
+				AE
+
+60-EF-C6   (hex)		Shenzhen Chima Technologies Co Limited
+60EFC6     (base 16)		Shenzhen Chima Technologies Co Limited
+				5F, TongXin Technology Park,HengGang,LongGang,Shenzhen,China
+				Shenzhen  GuangDong  518115
+				CN
+
+00-1F-C6   (hex)		ASUSTek COMPUTER INC.
+001FC6     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+B0-C1-28   (hex)		Adler ELREHA GmbH
+B0C128     (base 16)		Adler ELREHA GmbH
+				Schwetzinger Str. 103
+				Hockenheim  Baden-Württemberg  D-68766
+				DE
+
+30-87-D9   (hex)		Ruckus Wireless
+3087D9     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+FC-CA-C4   (hex)		LifeHealth, LLC
+FCCAC4     (base 16)		LifeHealth, LLC
+				2656 Patton Rd
+				Roseville  MN  55113
+				US
+
+F0-D9-B2   (hex)		EXO S.A.
+F0D9B2     (base 16)		EXO S.A.
+				Av. Chiclana 3444
+				Buenos Aires    1260
+				AR
+
+E4-C8-01   (hex)		BLU Products Inc
+E4C801     (base 16)		BLU Products Inc
+				10814 NW 33rd Street
+				Miami  FL  33172
+				US
+
+F0-98-38   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F09838     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-0E-14   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+C80E14     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+AC-63-BE   (hex)		Amazon Technologies Inc.
+AC63BE     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+F8-1D-78   (hex)		IEEE Registration Authority
+F81D78     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+38-F7-B2   (hex)		SEOJUN ELECTRIC
+38F7B2     (base 16)		SEOJUN ELECTRIC
+				468 Gangseo-ro, 07573, SEOJUN ELECTRIC Ace Techno Tower 805
+				Seoul    07573
+				KR
+
+10-12-50   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+101250     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+78-02-B7   (hex)		ShenZhen Ultra Easy Technology CO.,LTD
+7802B7     (base 16)		ShenZhen Ultra Easy Technology CO.,LTD
+				608,Building 2,Guangxingyuan Industrial Park A District,
+				Baoyuan Rd  ShenZhen,Guangdong  518102
+				CN
+
+64-61-84   (hex)		VELUX
+646184     (base 16)		VELUX
+				Baekgaardsvej 40
+				Skjern    6900
+				DK
+
+E8-E5-D6   (hex)		Samsung Electronics Co.,Ltd
+E8E5D6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-7E-75   (hex)		Samsung Electronics Co.,Ltd
+C87E75     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-26-5F   (hex)		Samsung Electronics Co.,Ltd
+00265F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-23-3A   (hex)		Samsung Electronics Co.,Ltd
+00233A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-6A-0A   (hex)		ASKEY COMPUTER CORP
+086A0A     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+98-E7-F4   (hex)		Hewlett Packard
+98E7F4     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+00-07-AB   (hex)		Samsung Electronics Co.,Ltd
+0007AB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-24-86   (hex)		DesignArt Networks
+002486     (base 16)		DesignArt Networks
+				4 Ha'haroshet St
+				Ra'anana    43101
+				IL
+
+00-24-78   (hex)		Mag Tech Electronics Co Limited
+002478     (base 16)		Mag Tech Electronics Co Limited
+				Flat / Room T78 GOF Bangkok Building
+				Sheung Wan  HK  
+				HK
+
+38-2D-D1   (hex)		Samsung Electronics Co.,Ltd
+382DD1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1B-2C   (hex)		ATRON electronic GmbH
+001B2C     (base 16)		ATRON electronic GmbH
+				Am Ziegelstadel 12 + 14
+				Markt Schwaben    85570
+				DE
+
+90-34-FC   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9034FC     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-14-27   (hex)		JazzMutant
+001427     (base 16)		JazzMutant
+				2 allee du Doyen Georges Brus
+				Pessac    33600
+				FR
+
+00-1E-84   (hex)		Pika Technologies Inc.
+001E84     (base 16)		Pika Technologies Inc.
+				535 Legget Drive
+				Ottawa  Ontario  K2K 3B8
+				CA
+
+10-DD-B1   (hex)		Apple, Inc.
+10DDB1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-23-29   (hex)		DDRdrive LLC
+002329     (base 16)		DDRdrive LLC
+				384 Madeline CT
+				Palo Alto  CA  94306
+				US
+
+00-26-AD   (hex)		Arada Systems, Inc.
+0026AD     (base 16)		Arada Systems, Inc.
+				1024 Morse Avenue
+				Sunnyvale  CA  94089
+				US
+
+FC-1F-19   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+FC1F19     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon    443-743
+				US
+
+84-0B-2D   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+840B2D     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				SUWON  KYUNGGI-DO  443-743
+				KR
+
+20-64-32   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+206432     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon  Gyunggi-Do  443-743
+				KR
+
+B4-07-F9   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+B407F9     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				Suwon-Si, Gyeonggi_Do, Korea
+				Suwon  Gyeonggi_Do  443-743
+				KR
+
+88-9F-FA   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+889FFA     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+8C-7C-B5   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+8C7CB5     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C4-46-19   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C44619     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+50-63-13   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+506313     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+60-D8-19   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+60D819     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+F8-2F-A8   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F82FA8     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+0C-84-DC   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0C84DC     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-16-6C   (hex)		Samsung Electronics Co.,Ltd
+00166C     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3Dong,Yeongtong-Gu
+				Suwon  Gyeonggi-Do  443-742
+				KR
+
+18-1E-B0   (hex)		Samsung Electronics Co.,Ltd
+181EB0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-7F-20   (hex)		Sagemcom Broadband SAS
+247F20     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E8-03-9A   (hex)		Samsung Electronics Co.,Ltd
+E8039A     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon  Geyonggi  443742
+				KR
+
+30-CD-A7   (hex)		Samsung Electronics Co.,Ltd
+30CDA7     (base 16)		Samsung Electronics Co.,Ltd
+				416 MAETAN 3-DONG
+				SUWON- SI    443-742
+				US
+
+00-12-47   (hex)		Samsung Electronics Co.,Ltd
+001247     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+00-15-99   (hex)		Samsung Electronics Co.,Ltd
+001599     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3Dong, Yeongtong-Gu
+				Suwon  AL  443-742
+				US
+
+00-12-FB   (hex)		Samsung Electronics Co.,Ltd
+0012FB     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3Dong, Yeongtong-Gu
+				Suwon-City  Gyeonggi-Do  443-742
+				KR
+
+D0-66-7B   (hex)		Samsung Electronics Co.,Ltd
+D0667B     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon  Gyeonggi-do  443742
+				KR
+
+B8-5E-7B   (hex)		Samsung Electronics Co.,Ltd
+B85E7B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-92-FB   (hex)		Samsung Electronics Co.,Ltd
+E492FB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+6C-B7-F4   (hex)		Samsung Electronics Co.,Ltd
+6CB7F4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-44-01   (hex)		Samsung Electronics Co.,Ltd
+2C4401     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-D9-CE   (hex)		Samsung Electronics Co.,Ltd
+B8D9CE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-66-AA   (hex)		Samsung Electronics Co.,Ltd
+1C66AA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-8B-FE   (hex)		Samsung Electronics Co.,Ltd
+3C8BFE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-E8-B2   (hex)		Samsung Electronics Co.,Ltd
+D4E8B2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-89-FD   (hex)		Samsung Electronics Co.,Ltd
+1489FD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-85-1F   (hex)		Samsung Electronics Co.,Ltd
+BC851F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-15-B9   (hex)		Samsung Electronics Co.,Ltd
+0015B9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+00-24-91   (hex)		Samsung Electronics Co.,Ltd
+002491     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-23-39   (hex)		Samsung Electronics Co.,Ltd
+002339     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-01-BB   (hex)		Samsung Electronics Co.,Ltd
+5001BB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-01-42   (hex)		MaxMedia Technology Limited
+C40142     (base 16)		MaxMedia Technology Limited
+				5F, No. 113, Jian 2nd Rd. Jhonghe District.
+				New Taipei City    23585
+				TW
+
+84-30-E5   (hex)		SkyHawke Technologies, LLC
+8430E5     (base 16)		SkyHawke Technologies, LLC
+				274 Commerce Park Dr, Ste M
+				Ridgeland  MS  39157
+				US
+
+1C-77-F6   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1C77F6     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+58-E3-26   (hex)		Compass Technologies Inc.
+58E326     (base 16)		Compass Technologies Inc.
+				Unit 1012 C-dong, Woolim Lion's Valley
+				Seoul  Seoul  153-786
+				KR
+
+00-1B-2A   (hex)		Cisco Systems, Inc
+001B2A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-9D-DC   (hex)		2Wire Inc
+749DDC     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+14-DD-E5   (hex)		MPMKVVCL
+14DDE5     (base 16)		MPMKVVCL
+				NISHTHA PARISAR, GOVINDPURA
+				BHOPAL  MADHYA PRADESH  462023
+				IN
+
+00-1A-09   (hex)		Wayfarer Transit Systems Ltd
+001A09     (base 16)		Wayfarer Transit Systems Ltd
+				10 Willis Way
+				Poole  Dorset  BH15 3SS
+				GB
+
+74-23-44   (hex)		Xiaomi Communications Co Ltd
+742344     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+54-88-0E   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+54880E     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+F0-25-B7   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+F025B7     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+F0-43-47   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F04347     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-B2-B2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9CB2B2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-C8-3A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A8C83A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-72-B1   (hex)		Samsung Electronics Co.,Ltd
+BC72B1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-F7-BE   (hex)		Samsung Electronics Co.,Ltd
+78F7BE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+68-48-98   (hex)		Samsung Electronics Co.,Ltd
+684898     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-23-BA   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+3423BA     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+00-36-76   (hex)		ARRIS Group, Inc.
+003676     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-8E-7E   (hex)		ARRIS Group, Inc.
+FC8E7E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-6F-B7   (hex)		ARRIS Group, Inc.
+FC6FB7     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D4-2C-0F   (hex)		ARRIS Group, Inc.
+D42C0F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-0E-85   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+400E85     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+C8-BA-94   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+C8BA94     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+84-38-38   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+843838     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+A0-55-DE   (hex)		ARRIS Group, Inc.
+A055DE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+80-F5-03   (hex)		ARRIS Group, Inc.
+80F503     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-AA-F5   (hex)		ARRIS Group, Inc.
+44AAF5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-9D-FA   (hex)		Wanan Hongsheng Electronic Co.Ltd
+E09DFA     (base 16)		Wanan Hongsheng Electronic Co.Ltd
+				1st section of industrial pack,Wan'An County,Ji'An City,jiangxi province
+				Wanan  China/jiangxi  343800
+				CN
+
+5C-3C-27   (hex)		Samsung Electronics Co.,Ltd
+5C3C27     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-A8-4C   (hex)		MONAD., Inc.
+70A84C     (base 16)		MONAD., Inc.
+				702, Hanlla Sigma Vally, 545, Dunchon-daero, Jungwon-gu
+				Seongnam-Shi    13215
+				KR
+
+84-C7-EA   (hex)		Sony Mobile Communications Inc
+84C7EA     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+24-E4-3F   (hex)		Wenzhou Kunmei Communication Technology Co.,Ltd.
+24E43F     (base 16)		Wenzhou Kunmei Communication Technology Co.,Ltd.
+				Baitawang industrial zone,Yueqing,Zhejiang
+				Yueqing  Zhejiang  310025
+				CN
+
+28-7A-EE   (hex)		ARRIS Group, Inc.
+287AEE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+88-79-7E   (hex)		Motorola Mobility LLC, a Lenovo Company
+88797E     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+30-58-90   (hex)		Frontier Silicon Ltd
+305890     (base 16)		Frontier Silicon Ltd
+				137 Euston Road
+				London    NW12AA
+				GB
+
+70-8B-CD   (hex)		ASUSTek COMPUTER INC.
+708BCD     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+00-25-8B   (hex)		Mellanox Technologies, Inc.
+00258B     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+00-56-2B   (hex)		Cisco Systems, Inc
+00562B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E8-FD-90   (hex)		Turbostor
+E8FD90     (base 16)		Turbostor
+				47800 Westinghouse Drive
+				Fremont  CA  94539
+				US
+
+2C-AC-44   (hex)		CONEXTOP
+2CAC44     (base 16)		CONEXTOP
+				Room 608, 6/F, Electric Building , High-tech Park , Nanshan
+				Shenzhen    51800
+				CN
+
+D0-13-FD   (hex)		LG Electronics (Mobile Communications)
+D013FD     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+BC-64-4B   (hex)		ARRIS Group, Inc.
+BC644B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+60-64-05   (hex)		Texas Instruments
+606405     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+18-99-F5   (hex)		Sichuan Changhong Electric Ltd.
+1899F5     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+00-25-C3   (hex)		21168
+0025C3     (base 16)		21168
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+00-0F-57   (hex)		CABLELOGIC Co., Ltd.
+000F57     (base 16)		CABLELOGIC Co., Ltd.
+				3F., Hwain Bldg., 1559-12 Seocho 3-dong,
+				Seoul    137-873
+				KR
+
+00-03-42   (hex)		Nortel Networks
+000342     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+A4-82-69   (hex)		Datrium, Inc.
+A48269     (base 16)		Datrium, Inc.
+				385 Moffett Park Drive
+				Sunnyvale  CA  94089
+				US
+
+10-E6-8F   (hex)		KWANGSUNG ELECTRONICS KOREA CO.,LTD.
+10E68F     (base 16)		KWANGSUNG ELECTRONICS KOREA CO.,LTD.
+				356-3, Gongdan-ro
+				Gunpo-si  Gyeonggi-do  15808
+				KR
+
+4C-FA-CA   (hex)		Cambridge Industries(Group) Co.,Ltd.
+4CFACA     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				5/F,Building 8, 2388 ChenHang Road, MinHang District
+				shanghai    201114
+				CN
+
+18-AB-F5   (hex)		Ultra Electronics Electrics
+18ABF5     (base 16)		Ultra Electronics Electrics
+				Kingsditch Lane
+				Cheltenham  Gloucestershire  GL51 9PG
+				GB
+
+B0-3E-B0   (hex)		MICRODIA Ltd.
+B03EB0     (base 16)		MICRODIA Ltd.
+				Suites 1608-1610, 16/F., Prosperity Centre, 25 Chong Yip Street,
+				Kwun Tong  Kowloon,  000000
+				HK
+
+00-15-91   (hex)		RLW Inc.
+001591     (base 16)		RLW Inc.
+				2029 Cato Ave.
+				State College  PA  16801
+				US
+
+00-18-2E   (hex)		XStreamHD
+00182E     (base 16)		XStreamHD
+				7900B Westpark Drive
+				McLean  VA  22102
+				US
+
+00-12-83   (hex)		Nortel Networks
+001283     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-11-F9   (hex)		Nortel Networks
+0011F9     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-11-58   (hex)		Nortel Networks
+001158     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0F-6A   (hex)		Nortel Networks
+000F6A     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0E-62   (hex)		Nortel Networks
+000E62     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0C-F8   (hex)		Nortel Networks
+000CF8     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-26-F1   (hex)		ProCurve Networking by HP
+0026F1     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				0000    118502
+				SG
+
+38-0D-D4   (hex)		Primax Electronics Ltd.
+380DD4     (base 16)		Primax Electronics Ltd.
+				8F,No. 669, Ruey Kuang Road, Neihu
+				Taipei    114
+				TW
+
+98-FD-B4   (hex)		Primax Electronics Ltd.
+98FDB4     (base 16)		Primax Electronics Ltd.
+				No. 669, Ruey Kuang Road, Neihu
+				Taipei  Taiwan,  R.O.C.
+				TW
+
+D8-C4-6A   (hex)		Murata Manufacturing Co., Ltd.
+D8C46A     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+D8-FB-68   (hex)		Cloud Corner Ltd.
+D8FB68     (base 16)		Cloud Corner Ltd.
+				Cloud Corner Smart Bldg, Mei Ju Center NO.39 Dongcheng South Road
+				Dong Guan  Guang Dong  523129
+				CN
+
+68-53-88   (hex)		P&S Technology
+685388     (base 16)		P&S Technology
+				216 Deajiro
+				Yongin-si  Gyeonggi-do  448-813
+				KR
+
+98-2F-3C   (hex)		Sichuan Changhong Electric Ltd.
+982F3C     (base 16)		Sichuan Changhong Electric Ltd.
+				35 East Mianxing Road,High-Tech Park,
+				MianYang  SiChuan  621000
+				CN
+
+14-C1-FF   (hex)		ShenZhen QianHai Comlan communication Co.,LTD
+14C1FF     (base 16)		ShenZhen QianHai Comlan communication Co.,LTD
+				Shenzhen Nanshan district keyuan road Dongfang science and technology building,  room 2407.
+				ShenZhen  GuangDong  518000
+				CN
+
+00-04-17   (hex)		ELAU AG
+000417     (base 16)		ELAU AG
+				Dillberg 12
+				    
+				DE
+
+EC-FA-AA   (hex)		The IMS Company
+ECFAAA     (base 16)		The IMS Company
+				2929 E. Imperial Highway
+				Brea  CA  92821
+				US
+
+F0-07-86   (hex)		Shandong Bittel Electronics Co., Ltd
+F00786     (base 16)		Shandong Bittel Electronics Co., Ltd
+				No.1 Rizhao North Road
+				Rizhao  Shandong  276800
+				CN
+
+00-D0-F6   (hex)		Nokia
+00D0F6     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+54-A6-19   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+54A619     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+00-09-97   (hex)		Nortel Networks
+000997     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1C-EB   (hex)		Nortel Networks
+001CEB     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1C-17   (hex)		Nortel Networks
+001C17     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1A-8F   (hex)		Nortel Networks
+001A8F     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-17-D1   (hex)		Nortel Networks
+0017D1     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+88-83-22   (hex)		Samsung Electronics Co.,Ltd
+888322     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E8-93-09   (hex)		Samsung Electronics Co.,Ltd
+E89309     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-14-C7   (hex)		Nortel Networks
+0014C7     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1D-AF   (hex)		Nortel Networks
+001DAF     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+88-A6-C6   (hex)		Sagemcom Broadband SAS
+88A6C6     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+94-D4-69   (hex)		Cisco Systems, Inc
+94D469     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+88-2B-D7   (hex)		ADDÉNERGIE  TECHNOLOGIES
+882BD7     (base 16)		ADDÉNERGIE  TECHNOLOGIES
+				533 avenue de la montagne LOCAL 121
+				Shawinigan  Quebec  G9N 0A3
+				CA
+
+00-90-CC   (hex)		PLANEX COMMUNICATIONS INC.
+0090CC     (base 16)		PLANEX COMMUNICATIONS INC.
+				2F FENISSAY Ebisu Bldg
+				Shibuya-ku,  Tokyo  150-0011
+				JP
+
+20-57-AF   (hex)		Shenzhen FH-NET OPTOELECTRONICS CO.,LTD
+2057AF     (base 16)		Shenzhen FH-NET OPTOELECTRONICS CO.,LTD
+				5/F Building D1 TCL International E City NO.1001 Zhong  shan  yuan Rd,  Nanshan District Shenzhen china 
+				Shenzhen  GuangDong  518055
+				CN
+
+54-DC-1D   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+54DC1D     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				Road NO2, West of Industrial Park,North of Science & Technology Park
+				Dongguan  Guangdong  518057
+				CN
+
+AC-A2-13   (hex)		Shenzhen Bilian electronic CO.,LTD
+ACA213     (base 16)		Shenzhen Bilian electronic CO.,LTD
+				NO 268，Fuqian Rd,Jutang Community
+				shenzhen  guangdong  518110
+				CN
+
+3C-33-00   (hex)		Shenzhen Bilian electronic CO.,LTD
+3C3300     (base 16)		Shenzhen Bilian electronic CO.,LTD
+				NO 268，Fuqian Rd,Jutang Community,Guanlan town , LongHua new district
+				Shenzhen  Guangdong  518110
+				CN
+
+6C-D0-32   (hex)		LG Electronics
+6CD032     (base 16)		LG Electronics
+				16, Woomyeon-dong, Seocho-gu
+				Seoul    137-724
+				KR
+
+3C-BD-D8   (hex)		LG ELECTRONICS INC
+3CBDD8     (base 16)		LG ELECTRONICS INC
+				19-1, CHEONGHO-RI, JINWI-MYEON
+				PYEONGTAEK  GYEONGGI-DO  451-713
+				KR
+
+34-4D-F7   (hex)		LG Electronics (Mobile Communications)
+344DF7     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+58-3F-54   (hex)		LG Electronics (Mobile Communications)
+583F54     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-22-CF   (hex)		PLANEX COMMUNICATIONS INC.
+0022CF     (base 16)		PLANEX COMMUNICATIONS INC.
+				2F F ・ NISSAY Ebisu Bldg3-16-3
+				Shibuya-ku  Tokyo  150-0011
+				JP
+
+E4-17-D8   (hex)		8BITDO TECHNOLOGY HK LIMITED
+E417D8     (base 16)		8BITDO TECHNOLOGY HK LIMITED
+				Rooms 1318-19, 13/F, Hollywood Plaza, 610 Nathan Road, Mongkok, Kowloon, Hong Kong
+				Hong Kong  Hong Kong  000000
+				CN
+
+9C-D3-32   (hex)		PLC Technology Ltd
+9CD332     (base 16)		PLC Technology Ltd
+				Nauchny proezd, 17
+				Moscow  Select State  117246
+				RU
+
+38-F8-CA   (hex)		OWIN Inc.
+38F8CA     (base 16)		OWIN Inc.
+				Chosunref 5fl,577,Seolleung-ro,Gangnam-gu
+				Seoul    682-20
+				KR
+
+44-33-4C   (hex)		Shenzhen Bilian electronic CO.,LTD
+44334C     (base 16)		Shenzhen Bilian electronic CO.,LTD
+				NO 268
+				Shenzhen  Guangdong  518110
+				CN
+
+64-89-9A   (hex)		LG Electronics (Mobile Communications)
+64899A     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-21-05   (hex)		Alcatel-Lucent IPD
+002105     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+00-1B-C5   (hex)		IEEE Registration Authority
+001BC5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+48-DF-37   (hex)		Hewlett Packard Enterprise
+48DF37     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+C0-E4-2D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C0E42D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+8C-A6-DF   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+8CA6DF     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+84-16-F9   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+8416F9     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+18-D6-C7   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+18D6C7     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+78-C3-E9   (hex)		Samsung Electronics Co.,Ltd
+78C3E9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-1A-BF   (hex)		Samsung Electronics Co.,Ltd
+8C1ABF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-CB-F8   (hex)		Samsung Electronics Co.,Ltd
+30CBF8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-CB-FD   (hex)		Samsung Electronics Co.,Ltd
+A0CBFD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-5D-75   (hex)		Samsung Electronics Co.,Ltd
+E45D75     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-E0-4D   (hex)		INTERNET INITIATIVE JAPAN, INC
+00E04D     (base 16)		INTERNET INITIATIVE JAPAN, INC
+				1-4, SANBAN-CHO, CHIYODA-KU
+				  TOKYO 102  
+				JP
+
+F8-A9-D0   (hex)		LG Electronics (Mobile Communications)
+F8A9D0     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+CC-FA-00   (hex)		LG Electronics (Mobile Communications)
+CCFA00     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+74-A7-22   (hex)		LG Electronics (Mobile Communications)
+74A722     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F0-1C-13   (hex)		LG Electronics (Mobile Communications)
+F01C13     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+58-FC-DB   (hex)		IEEE Registration Authority
+58FCDB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B0-C5-CA   (hex)		IEEE Registration Authority
+B0C5CA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+74-19-F8   (hex)		IEEE Registration Authority
+7419F8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A8-16-B2   (hex)		LG Electronics (Mobile Communications)
+A816B2     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+64-BC-0C   (hex)		LG Electronics (Mobile Communications)
+64BC0C     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+90-C6-82   (hex)		IEEE Registration Authority
+90C682     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C0-1A-DA   (hex)		Apple, Inc.
+C01ADA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-00-31   (hex)		QPSX COMMUNICATIONS, LTD.
+000031     (base 16)		QPSX COMMUNICATIONS, LTD.
+				33 RICHARDSON STREET
+				Western    00000
+				AU
+
+00-0E-1E   (hex)		QLogic Corporation
+000E1E     (base 16)		QLogic Corporation
+				26650 Aliso Viejo Parkway
+				Aliso Viejo  CA  92656
+				US
+
+00-14-D1   (hex)		TRENDnet, Inc.
+0014D1     (base 16)		TRENDnet, Inc.
+				20675 Manhattan Place
+				Torrance  CA  90501
+				US
+
+CC-52-AF   (hex)		Universal Global Scientific Industrial Co., Ltd.
+CC52AF     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351, TAIPING RD.
+				nan tou  NAN-TOU  542
+				TW
+
+00-1C-14   (hex)		VMware, Inc.
+001C14     (base 16)		VMware, Inc.
+				3401 Hillview Avenue
+				Palo Alto  CA  94304
+				US
+
+00-50-56   (hex)		VMware, Inc.
+005056     (base 16)		VMware, Inc.
+				3401 Hillview Avenue
+				PALO ALTO  CA  94304
+				US
+
+00-12-1C   (hex)		PARROT SA
+00121C     (base 16)		PARROT SA
+				174 Quai de Jemmapes
+				Paris    75010
+				FR
+
+90-03-B7   (hex)		PARROT SA
+9003B7     (base 16)		PARROT SA
+				174 Quai de Jemmapes
+				Paris    75010
+				FR
+
+20-87-56   (hex)		SIEMENS AG
+208756     (base 16)		SIEMENS AG
+				Oestliche Rheinbrueckenstrasse 50
+				Karlsruhe  Baden-Württemberg  76187
+				DE
+
+74-B4-72   (hex)		CIESSE
+74B472     (base 16)		CIESSE
+				Via G. di Vittorio, 66
+				Rignano Sull'Arno  Florence  50067
+				IT
+
+FC-F1-52   (hex)		Sony Corporation
+FCF152     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+48-3C-0C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+483C0C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-9B-AD   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+309BAD     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+00-1B-B1   (hex)		Wistron Neweb Corporation
+001BB1     (base 16)		Wistron Neweb Corporation
+				No. 10-1, Li-hsin Road I, Hsinchu Science Park,
+				Hsinchu    300
+				TW
+
+00-80-F7   (hex)		Zenith Electronics Corporation
+0080F7     (base 16)		Zenith Electronics Corporation
+				1000 MILWAUKEE AVENUE
+				GLENVIEW  IL  60025
+				US
+
+BC-30-7D   (hex)		Wistron Neweb Corporation
+BC307D     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsin Science Park, Hsinchu 308, Taiwan
+				HsinChu  Taiwan  308
+				TW
+
+48-A9-D2   (hex)		Wistron Neweb Corporation
+48A9D2     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsin Science Park, Hsinchu 308, Taiwan
+				HsinChu  Taiwan  308
+				TW
+
+80-EA-23   (hex)		Wistron Neweb Corporation
+80EA23     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsin Science Park, Hsinchu 308, Taiwan
+				HsinChu  Taiwan  308
+				TW
+
+00-27-13   (hex)		Universal Global Scientific Industrial Co., Ltd.
+002713     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+BC-30-7E   (hex)		Wistron Neweb Corporation
+BC307E     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II.
+				Hsinchu    30808854
+				TW
+
+08-95-2A   (hex)		Technicolor CH USA Inc.
+08952A     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+44-32-C8   (hex)		Technicolor CH USA Inc.
+4432C8     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+38-A2-8C   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+38A28C     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+B4-A5-EF   (hex)		Sercomm Corporation.
+B4A5EF     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+84-9D-64   (hex)		SMC Corporation
+849D64     (base 16)		SMC Corporation
+				4-2-2, Kinunodai
+				Tsukuba Mirai-shi  Ibaraki-ken  300-2493
+				JP
+
+00-10-C1   (hex)		OI ELECTRIC CO.,LTD
+0010C1     (base 16)		OI ELECTRIC CO.,LTD
+				7-3-16 KIKUNA
+				YOKOHAMA  KANAGAWA-KEN  222-0011
+				JP
+
+28-BE-9B   (hex)		Technicolor CH USA Inc.
+28BE9B     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+FC-52-8D   (hex)		Technicolor CH USA Inc.
+FC528D     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+50-65-83   (hex)		Texas Instruments
+506583     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B0-91-22   (hex)		Texas Instruments
+B09122     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+FC-51-A4   (hex)		ARRIS Group, Inc.
+FC51A4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+98-57-D3   (hex)		HON HAI-CCPBG  PRECISION IND.CO.,LTD.
+9857D3     (base 16)		HON HAI-CCPBG  PRECISION IND.CO.,LTD.
+				5F, No.9,Li-Hsin Road V,Science Park
+				Hsinchu    300
+				TW
+
+FC-F5-28   (hex)		Zyxel Communications Corporation
+FCF528     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-A0-C5   (hex)		Zyxel Communications Corporation
+00A0C5     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+A0-9E-1A   (hex)		Polar Electro Oy
+A09E1A     (base 16)		Polar Electro Oy
+				Professorintie 5
+				Kempele  Oulu  90440
+				FI
+
+1C-D6-BD   (hex)		LEEDARSON LIGHTING CO., LTD.
+1CD6BD     (base 16)		LEEDARSON LIGHTING CO., LTD.
+				No. 1511, 2nd Fanghu North Rd., Huli District
+				Xiamen  Fugian  361010
+				CN
+
+D0-D9-4F   (hex)		IEEE Registration Authority
+D0D94F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-1E-04   (hex)		Hanson Research Corporation
+001E04     (base 16)		Hanson Research Corporation
+				9810 Variel Ave.
+				Chatsworth  CA  91311
+				US
+
+60-C0-BF   (hex)		ON Semiconductor
+60C0BF     (base 16)		ON Semiconductor
+				5005 East McDowell Road
+				Phoenix  AZ  85008
+				US
+
+AC-04-81   (hex)		Jiangsu Huaxing Electronics Co., Ltd.
+AC0481     (base 16)		Jiangsu Huaxing Electronics Co., Ltd.
+				the Industrial concentration zone, Zhiqian town,Jintan distric
+				Changzhou City  Jiangsu Province  213234
+				CN
+
+68-B3-5E   (hex)		Shenzhen Neostra Technology Co.Ltd
+68B35E     (base 16)		Shenzhen Neostra Technology Co.Ltd
+				7th Building,Huaide Cuihai Industrial Park,Fuyong,Shenzhen China
+				shenzhen    518100
+				CN
+
+40-88-05   (hex)		Motorola Mobility LLC, a Lenovo Company
+408805     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+24-E2-71   (hex)		Qingdao Hisense Communications Co.,Ltd.
+24E271     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+BC-60-10   (hex)		Qingdao Hisense Communications Co.,Ltd.
+BC6010     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+D0-FC-CC   (hex)		Samsung Electronics Co.,Ltd
+D0FCCC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+98-39-8E   (hex)		Samsung Electronics Co.,Ltd
+98398E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-D1-FA   (hex)		Shenzhen Yunlink Technology Co., Ltd
+44D1FA     (base 16)		Shenzhen Yunlink Technology Co., Ltd
+				Gushu, Xixiang Town, Bao'an District, 
+				Shenzhen City  Guangdong Province  518100
+				CN
+
+F0-F6-44   (hex)		Whitesky Science & Technology Co.,Ltd.
+F0F644     (base 16)		Whitesky Science & Technology Co.,Ltd.
+				Room301,Building7,NO.6,Lane365
+				  Shanghai  200052
+				CN
+
+20-F1-7C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+20F17C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-6A-C2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+346AC2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-1C-FF   (hex)		Vizio, Inc
+C41CFF     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+C0-97-27   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+C09727     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+DC-29-3A   (hex)		Shenzhen Nuoshi Technology Co., LTD.
+DC293A     (base 16)		Shenzhen Nuoshi Technology Co., LTD.
+				Room 7020 of Tian Xia IC  Industry Park, Majialong Industrial Zone, YiYuan Road
+				Nanshan District, Shenzhen  Guangdong  518052
+				CN
+
+7C-6A-F3   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+7C6AF3     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+E4-62-51   (hex)		HAO CHENG GROUP LIMITED
+E46251     (base 16)		HAO CHENG GROUP LIMITED
+				 FLAT/RM C, 06/F, BEST-TO-BEST COMMERCIAL CENTRE 32-36 FERRY STREET JORDAN KL
+				Hong KOng    999077
+				HK
+
+40-56-2D   (hex)		Smartron India Pvt ltd
+40562D     (base 16)		Smartron India Pvt ltd
+				1st Floor,  Kapil Tower,  Gachibowli
+				Hyderabad  Telangana  500032
+				IN
+
+38-76-D1   (hex)		Euronda SpA
+3876D1     (base 16)		Euronda SpA
+				Via dell'artigianato, 7
+				Montecchio Precalcino  Italia/Vicenza  36030
+				IT
+
+C4-69-3E   (hex)		Turbulence Design Inc.
+C4693E     (base 16)		Turbulence Design Inc.
+				1-3-14
+				Koshigaya-City  Saitama  343-0813
+				JP
+
+00-95-69   (hex)		LSD Science and Technology Co.,Ltd.
+009569     (base 16)		LSD Science and Technology Co.,Ltd.
+				Lierda Building,No.425 Dengyun Rd.
+				Hangzhou  Zhijiang  310011
+				CN
+
+B0-CF-4D   (hex)		MI-Zone Technology Ireland
+B0CF4D     (base 16)		MI-Zone Technology Ireland
+				2nd floor,block 10 unit 3
+				dublin  Blanchardstown  15
+				IE
+
+28-9A-FA   (hex)		TCT mobile ltd
+289AFA     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+00-1A-34   (hex)		Konka Group Co., Ltd.
+001A34     (base 16)		Konka Group Co., Ltd.
+				Shenzhen Konka R & D Building, 28th floor 15-24
+				Nanshan District  Guangdong  00000
+				CN
+
+00-11-FC   (hex)		HARTING Electronics GmbH
+0011FC     (base 16)		HARTING Electronics GmbH
+				Wilhelm Harting Str. 1
+				Espelkamp  Nordrhein Westfalen  D-32339
+				DE
+
+00-23-89   (hex)		Hangzhou H3C Technologies Co., Limited
+002389     (base 16)		Hangzhou H3C Technologies Co., Limited
+				Oriental Electronics Bldg., #2, Chuangye Road£¬Shangdi Information Industry Base,
+				Beijing    100085
+				US
+
+3C-E5-A6   (hex)		Hangzhou H3C Technologies Co., Limited
+3CE5A6     (base 16)		Hangzhou H3C Technologies Co., Limited
+				Oriental Electronic Bld., NO.2,Chuangye Road
+				Beijing    100085
+				CN
+
+5C-DD-70   (hex)		Hangzhou H3C Technologies Co., Limited
+5CDD70     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+3C-8C-40   (hex)		Hangzhou H3C Technologies Co., Limited
+3C8C40     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District,
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+A0-67-BE   (hex)		Sicon srl
+A067BE     (base 16)		Sicon srl
+				Via Sila 1/3
+				Isola Vicentina  Vicenza  36033
+				IT
+
+D8-20-9F   (hex)		Cubro Acronet GesmbH
+D8209F     (base 16)		Cubro Acronet GesmbH
+				Geiselberstraße 17 / 6 Floor
+				Vienna  Vienna  1110
+				AT
+
+8C-77-16   (hex)		LONGCHEER TELECOMMUNICATION LIMITED
+8C7716     (base 16)		LONGCHEER TELECOMMUNICATION LIMITED
+				Building 1,No.401,Caobao Rd
+				Shanghai  Xuhui District  200233
+				CN
+
+68-FB-7E   (hex)		Apple, Inc.
+68FB7E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-A1-34   (hex)		Apple, Inc.
+84A134     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-D3-85   (hex)		AUMA Riester GmbH & Co. KG
+A0D385     (base 16)		AUMA Riester GmbH & Co. KG
+				Aumastr. 1
+				Muellheim  Baden-Württemberg  79379
+				DE
+
+14-14-E6   (hex)		Ningbo Sanhe Digital Co.,Ltd
+1414E6     (base 16)		Ningbo Sanhe Digital Co.,Ltd
+				No.1177 Lingyun Road
+				ningbo  zhejiang  315048
+				CN
+
+00-25-82   (hex)		Maksat Technologies (P) Ltd
+002582     (base 16)		Maksat Technologies (P) Ltd
+				D-10/6, Okhla, Phase-I
+				New Delhi    110020
+				IN
+
+0C-51-01   (hex)		Apple, Inc.
+0C5101     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-F0-A2   (hex)		Apple, Inc.
+2CF0A2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-C0-49   (hex)		Broad Telecom SA
+48C049     (base 16)		Broad Telecom SA
+				c/ Margarita Salas, 22
+				Leganes  Madrid  28918
+				ES
+
+AC-6F-BB   (hex)		TATUNG Technology Inc.
+AC6FBB     (base 16)		TATUNG Technology Inc.
+				22, Chungshan N. Rd., 3rd Sec.,
+				Taipei    104
+				TW
+
+00-1C-41   (hex)		scemtec Transponder Technology GmbH
+001C41     (base 16)		scemtec Transponder Technology GmbH
+				Wehrstr. 1
+				Gummersbach  NRW  51645
+				DE
+
+14-63-08   (hex)		JABIL CIRCUIT (SHANGHAI) LTD.
+146308     (base 16)		JABIL CIRCUIT (SHANGHAI) LTD.
+				FL5-UNIT A2 NO. 1528 GUMEI ROAD
+				SHANGHAI    200233
+				CN
+
+00-1E-25   (hex)		INTEK DIGITAL
+001E25     (base 16)		INTEK DIGITAL
+				1101, 11th Fl., Anyang K-center building, 1591-9
+				Anyang  Gyeonggi-do  431-815
+				KR
+
+00-E0-CF   (hex)		INTEGRATED DEVICE
+00E0CF     (base 16)		INTEGRATED DEVICE
+				6024 Silver Creek Valley Road
+				San Jose  CA  95138
+				US
+
+90-4D-4A   (hex)		Sagemcom Broadband SAS
+904D4A     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+04-4E-5A   (hex)		ARRIS Group, Inc.
+044E5A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-60-B1   (hex)		Input/Output, Inc.
+0060B1     (base 16)		Input/Output, Inc.
+				12300 PARC CREST DRIVE
+				STAFFORD  TX  77477-2416
+				US
+
+54-7F-54   (hex)		INGENICO
+547F54     (base 16)		INGENICO
+				9, avenue de la gare - BP 25156
+				Valence cedex 9    26958
+				FR
+
+6C-24-83   (hex)		Microsoft Mobile Oy
+6C2483     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+68-91-D0   (hex)		IEEE Registration Authority
+6891D0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E0-4F-43   (hex)		Universal Global Scientific Industrial Co., Ltd.
+E04F43     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Road, Sec.1,Tsao Tuen
+				Nan-Tou  Taiwan  54261
+				TW
+
+38-70-0C   (hex)		ARRIS Group, Inc.
+38700C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0E-2E   (hex)		Edimax Technology Co. Ltd.
+000E2E     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+00-06-5F   (hex)		ECI Telecom Ltd.
+00065F     (base 16)		ECI Telecom Ltd.
+				30 Hasivim St.
+				hasivivm    53188
+				IL
+
+00-20-8F   (hex)		ECI Telecom Ltd.
+00208F     (base 16)		ECI Telecom Ltd.
+				HASIVIM ST. 30,
+				PETACH-TIKVA 49133    49133
+				IL
+
+84-40-76   (hex)		Drivenets
+844076     (base 16)		Drivenets
+				4 ashizaf
+				Raanana    4366411
+				IL
+
+00-1C-D7   (hex)		Harman/Becker Automotive Systems GmbH
+001CD7     (base 16)		Harman/Becker Automotive Systems GmbH
+				Becker-Göring-Straße 16
+				Karlsbad  Baden-Württemberg  76307
+				DE
+
+00-3A-7D   (hex)		Cisco Systems, Inc
+003A7D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+90-C7-D8   (hex)		zte corporation
+90C7D8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-18-5C   (hex)		EDSLAB Technologies
+00185C     (base 16)		EDSLAB Technologies
+				20 Ayer Rajah Crescent
+				Crescent    139964
+				SG
+
+00-1A-45   (hex)		GN Netcom A/S
+001A45     (base 16)		GN Netcom A/S
+				Metalbuen 66
+				Ballerup  Skovlunde  DK - 2750
+				DK
+
+00-20-88   (hex)		GLOBAL VILLAGE COMMUNICATION
+002088     (base 16)		GLOBAL VILLAGE COMMUNICATION
+				1144 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+54-13-79   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+541379     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-19-21   (hex)		Elitegroup Computer Systems Co.,Ltd.
+001921     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22,Alley 38,Lane 91, Sec. 1,Nei Hu Road.
+				Taipei    114
+				TW
+
+00-16-EC   (hex)		Elitegroup Computer Systems Co.,Ltd.
+0016EC     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No. 22, Alley 38, Lane 91, Sec. 1, Nei Hu Road,
+				Taipei    11441
+				TW
+
+00-07-95   (hex)		Elitegroup Computer Systems Co.,Ltd.
+000795     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No. 22, Alley 38, Lane 91,
+				Taipei    114
+				TW
+
+FC-0F-4B   (hex)		Texas Instruments
+FC0F4B     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D4-88-3F   (hex)		HDPRO CO., LTD.
+D4883F     (base 16)		HDPRO CO., LTD.
+				HDPRO Bldg. 23, 362 Beon-gil, Shinheung-ro, Ojeong-gu
+				Bucheon-City  Gyunggi-Do  14491
+				KR
+
+10-88-CE   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+1088CE     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+60-B6-17   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+60B617     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+DC-9C-9F   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+DC9C9F     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+74-DF-BF   (hex)		Liteon Technology Corporation
+74DFBF     (base 16)		Liteon Technology Corporation
+				7F, Bldg, C, 90, Chien 1 Road
+				Taipei  Taiwan  23585
+				TW
+
+F0-3E-90   (hex)		Ruckus Wireless
+F03E90     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+D8-D7-23   (hex)		IDS, Inc
+D8D723     (base 16)		IDS, Inc
+				6801 15 Mile Rd.
+				Sterling Heights  MI  48312
+				US
+
+84-AD-58   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+84AD58     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-60-5F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+58605F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-A0-F4   (hex)		GE
+00A0F4     (base 16)		GE
+				W-657
+				WAUKESHA  WI  53188
+				US
+
+AC-0D-1B   (hex)		LG Electronics (Mobile Communications)
+AC0D1B     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F0-D1-B8   (hex)		LEDVANCE
+F0D1B8     (base 16)		LEDVANCE
+				200 Ballardvale St
+				Wilmington  MA  01887
+				US
+
+98-6D-35   (hex)		IEEE Registration Authority
+986D35     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+88-79-5B   (hex)		Konka Group Co., Ltd.
+88795B     (base 16)		Konka Group Co., Ltd.
+				Shenzhen Konka R & D Building, 28th floor 15-24
+				Nanshan District  Guangdong  00000
+				CN
+
+08-1F-71   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+081F71     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-CA-1A   (hex)		Microsoft Mobile Oy
+5CCA1A     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+FC-2F-AA   (hex)		Nokia
+FC2FAA     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+B0-7E-70   (hex)		Zadara Storage Ltd.
+B07E70     (base 16)		Zadara Storage Ltd.
+				6 Venture, Suite 140
+				Irvine  CA  92618
+				US
+
+00-80-B1   (hex)		SOFTCOM A/S
+0080B1     (base 16)		SOFTCOM A/S
+				STUDIESTRAEDE 21
+				    
+				DK
+
+20-2D-F8   (hex)		Digital Media Cartridge Ltd.
+202DF8     (base 16)		Digital Media Cartridge Ltd.
+				5F-3, No. 9, Ln 3, Jihu Rd, Neihu
+				Taipei    11492
+				TW
+
+10-D0-AB   (hex)		zte corporation
+10D0AB     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-04-C6   (hex)		YAMAHA MOTOR CO.,LTD
+0004C6     (base 16)		YAMAHA MOTOR CO.,LTD
+				Information System Division
+				Japan  Zip:  438-8501
+				JP
+
+18-A3-E8   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+18A3E8     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+74-1E-93   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+741E93     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+20-2D-07   (hex)		Samsung Electronics Co.,Ltd
+202D07     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-80-3C   (hex)		Anhui Huami Information Technology Company Limited
+D8803C     (base 16)		Anhui Huami Information Technology Company Limited
+				Building A4, 12th Floor, No. 800, Wangjiang Road
+				Hefei  Anhui  230088
+				CN
+
+00-34-DA   (hex)		LG Electronics (Mobile Communications)
+0034DA     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+38-10-D5   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+3810D5     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+18-C5-01   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+18C501     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+00-A0-B8   (hex)		NetApp
+00A0B8     (base 16)		NetApp
+				1395 Crossman Ave
+				Sunnyvale,  CA  94089
+				US
+
+00-C8-8B   (hex)		Cisco Systems, Inc
+00C88B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-C3-F9   (hex)		Securitas Direct AB
+24C3F9     (base 16)		Securitas Direct AB
+				Angbatsbron 1
+				Malmö    21120
+				SE
+
+2C-21-D7   (hex)		IMAX Corporation
+2C21D7     (base 16)		IMAX Corporation
+				2525 Speakman Drive
+				Mississauga  Ontario  L5K 1B1
+				CA
+
+00-09-D2   (hex)		Mai Logic Inc.
+0009D2     (base 16)		Mai Logic Inc.
+				47697 Westinghouse Dr., Suite 200
+				Fremont  CA  94539
+				US
+
+00-60-16   (hex)		CLARIION
+006016     (base 16)		CLARIION
+				COSLIN DRIVE
+				SOUTHBORO  MA  01772
+				US
+
+98-1F-B1   (hex)		Shenzhen Lemon Network Technology Co.,Ltd
+981FB1     (base 16)		Shenzhen Lemon Network Technology Co.,Ltd
+				Changhong Technology Building 1710-11,South NO.12 Road,Nanshan Technology Park,Nanshan District,Shenzhen,China.
+				shenzhen    518100
+				CN
+
+0C-5A-9E   (hex)		Wi-SUN Alliance
+0C5A9E     (base 16)		Wi-SUN Alliance
+				275 Tennant Avenue, Suite 202
+				Morgan Hill  CA  95037
+				US
+
+B4-4B-D2   (hex)		Apple, Inc.
+B44BD2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-41-5F   (hex)		Apple, Inc.
+DC415F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-12-25   (hex)		Cisco Systems, Inc
+641225     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+78-64-E6   (hex)		Green Motive Technology Limited
+7864E6     (base 16)		Green Motive Technology Limited
+				Room 1106,11 Floor，The XinYuan Square, No 418 Gui ping Road
+				shanghai  shanghai  20233
+				CN
+
+3C-BE-E1   (hex)		NIKON CORPORATION
+3CBEE1     (base 16)		NIKON CORPORATION
+				Shinagawa Intercity Tower C, 2-15-3, Konan
+				Minato-ku  Tokyo  108-6290
+				JP
+
+10-2A-B3   (hex)		Xiaomi Communications Co Ltd
+102AB3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+40-D3-57   (hex)		Ison Technology Co., Ltd.
+40D357     (base 16)		Ison Technology Co., Ltd.
+				Room 6, 20F, No. 77, section 1, Xintai 5th Rd. Xizhi District
+				New Taipei City  Taiwan  22101
+				TW
+
+A4-15-88   (hex)		ARRIS Group, Inc.
+A41588     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F4-5C-89   (hex)		Apple, Inc.
+F45C89     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-76-8F   (hex)		Apple, Inc.
+20768F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-5C-F9   (hex)		Sony Mobile Communications Inc
+9C5CF9     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-11-D1   (hex)		Soft Imaging System GmbH
+0011D1     (base 16)		Soft Imaging System GmbH
+				Johann-Krane-Weg 39
+				Muenster    48149
+				DE
+
+98-D6-86   (hex)		Chyi Lee industry Co., ltd.
+98D686     (base 16)		Chyi Lee industry Co., ltd.
+				No.25, Wufu Rd., Xinying Dist.
+				Tainan city    73054
+				TW
+
+8C-C6-61   (hex)		Current, powered by GE
+8CC661     (base 16)		Current, powered by GE
+				1975 Noble Road B335C
+				East Cleveland  OH  44112
+				US
+
+88-A0-84   (hex)		Formation Data Systems
+88A084     (base 16)		Formation Data Systems
+				39141 Civic Center Drive, Suite 410 
+				Fremont  CA  94538
+				US
+
+E8-B2-AC   (hex)		Apple, Inc.
+E8B2AC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-9A-79   (hex)		Apple, Inc.
+E49A79     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-A9-DE   (hex)		LG Innotek
+30A9DE     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+F0-1B-6C   (hex)		vivo Mobile Communication Co., Ltd.
+F01B6C     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+A0-B9-ED   (hex)		Skytap
+A0B9ED     (base 16)		Skytap
+				710 2nd Ave Suite 1130
+				Seattle  WA  98104
+				US
+
+94-C9-60   (hex)		Zhongshan B&T technology.co.,ltd
+94C960     (base 16)		Zhongshan B&T technology.co.,ltd
+				Floor3-4,Block A,Dong Fang Industrial park,Da che country,Nan Lang District 
+				Zhong Shan City  Guang Dong Province  528451
+				CN
+
+74-C3-30   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+74C330     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+40-3F-8C   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+403F8C     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+DC-B3-B4   (hex)		Honeywell Environmental & Combustion Controls (Tianjin) Co., Ltd.
+DCB3B4     (base 16)		Honeywell Environmental & Combustion Controls (Tianjin) Co., Ltd.
+				158 Nan Hai Road, TEDA
+				Tianjin    300457
+				CN
+
+00-1D-3B   (hex)		Nokia Danmark A/S
+001D3B     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1D-FD   (hex)		Nokia Danmark A/S
+001DFD     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1E-3B   (hex)		Nokia Danmark A/S
+001E3B     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1E-A4   (hex)		Nokia Danmark A/S
+001EA4     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-26-CC   (hex)		Nokia Danmark A/S
+0026CC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-0E-ED   (hex)		Nokia Danmark A/S
+000EED     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+4C-25-78   (hex)		Nokia Corporation
+4C2578     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  NA  24101
+				FI
+
+BC-C6-DB   (hex)		Nokia Corporation
+BCC6DB     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  NA  24101
+				FI
+
+60-A8-FE   (hex)		Nokia
+60A8FE     (base 16)		Nokia
+				Karaportti 3
+				Espoo    02610
+				FI
+
+00-11-9F   (hex)		Nokia Danmark A/S
+00119F     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1A-16   (hex)		Nokia Danmark A/S
+001A16     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1A-89   (hex)		Nokia Danmark A/S
+001A89     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1A-DC   (hex)		Nokia Danmark A/S
+001ADC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-25-CF   (hex)		Nokia Danmark A/S
+0025CF     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-21-AB   (hex)		Nokia Danmark A/S
+0021AB     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1F-DE   (hex)		Nokia Danmark A/S
+001FDE     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1F-DF   (hex)		Nokia Danmark A/S
+001FDF     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+54-79-75   (hex)		Nokia Corporation
+547975     (base 16)		Nokia Corporation
+				Joensuunkatu 7E
+				Salo    24101
+				FI
+
+A8-7B-39   (hex)		Nokia Corporation
+A87B39     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+00-24-7C   (hex)		Nokia Danmark A/S
+00247C     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-22-66   (hex)		Nokia Danmark A/S
+002266     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-21-FE   (hex)		Nokia Danmark A/S
+0021FE     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+C4-77-AB   (hex)		Beijing ASU Tech Co.,Ltd
+C477AB     (base 16)		Beijing ASU Tech Co.,Ltd
+				15/F, Global Trade Center Tower, No.36, North 3rd Ring Road, Dongcheng District, Beijing, 100013, China
+				BEI JING  BEI JING  100013
+				CN
+
+00-0B-CA   (hex)		DATAVAN TC
+000BCA     (base 16)		DATAVAN TC
+				4FL,#120-12,Chung Shan Rd, Sec.3
+				Chung Ho City, Taipei Hsien    235
+				TW
+
+70-25-59   (hex)		CyberTAN Technology Inc.
+702559     (base 16)		CyberTAN Technology Inc.
+				99, Park Avenue III, Science-Based Industrial Park
+				Hsinchu    308
+				TW
+
+60-7E-DD   (hex)		Microsoft Mobile Oy
+607EDD     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				ESPOO    02150
+				FI
+
+A8-A0-89   (hex)		Tactical Communications
+A8A089     (base 16)		Tactical Communications
+				473 Post Street
+				Camarillo  CA  93010
+				US
+
+48-36-5F   (hex)		Wintecronics Ltd.
+48365F     (base 16)		Wintecronics Ltd.
+				Rm. 3, 11F., No.716, Zhongzheng Rd., Zhonghe Dist., New Taipei City 23552, Taiwan (R.O.C.)
+				New Taipei City    23552
+				TW
+
+00-1D-20   (hex)		Comtrend Corporation
+001D20     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+08-37-3D   (hex)		Samsung Electronics Co.,Ltd
+08373D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-75-BD   (hex)		Cisco Systems, Inc
+0C75BD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+30-0D-43   (hex)		Microsoft Mobile Oy
+300D43     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 2-4
+				Espoo  N.A.  02150
+				FI
+
+00-00-0E   (hex)		FUJITSU LIMITED
+00000E     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+00-0B-5D   (hex)		FUJITSU LIMITED
+000B5D     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+C4-88-E5   (hex)		Samsung Electronics Co.,Ltd
+C488E5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-05-81   (hex)		Roku, Inc.
+080581     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga  CA  95070
+				US
+
+00-0D-F3   (hex)		Asmax Solutions
+000DF3     (base 16)		Asmax Solutions
+				Tatarska 5
+				Cracow    30-103
+				PL
+
+80-AC-AC   (hex)		Juniper Networks
+80ACAC     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-0D-B6   (hex)		Broadcom
+000DB6     (base 16)		Broadcom
+				1363 Redwood Way
+				Petaluma  CA  94954
+				US
+
+00-0A-F7   (hex)		Broadcom
+000AF7     (base 16)		Broadcom
+				16215 Alton Parkway
+				Irvine  CA  92618
+				US
+
+D4-01-29   (hex)		Broadcom
+D40129     (base 16)		Broadcom
+				5300 California Ave.
+				Irvine  CA  92617
+				US
+
+00-1D-00   (hex)		Brivo Systems, LLC
+001D00     (base 16)		Brivo Systems, LLC
+				4330 East West Highway
+				Bethesda  MD  20814
+				US
+
+00-20-D6   (hex)		Breezecom, Ltd.
+0020D6     (base 16)		Breezecom, Ltd.
+				ATIDIM TECHNOLOGICAL PK-BLDG.3
+				Tel-aviv    12345
+				IL
+
+00-E0-63   (hex)		Cabletron Systems, Inc.
+00E063     (base 16)		Cabletron Systems, Inc.
+				35 INDUSTRIAL WAY
+				ROCHESTER  NH  03866-5005
+				US
+
+FC-C7-34   (hex)		Samsung Electronics Co.,Ltd
+FCC734     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+84-25-DB   (hex)		Samsung Electronics Co.,Ltd
+8425DB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-EC-71   (hex)		Samsung Electronics Co.,Ltd
+B0EC71     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-58-B8   (hex)		Samsung Electronics Co.,Ltd
+E458B8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-8C-2C   (hex)		Samsung Electronics Co.,Ltd
+088C2C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-B8-53   (hex)		Samsung Electronics Co.,Ltd
+64B853     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+38-94-96   (hex)		Samsung Electronics Co.,Ltd
+389496     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-56-BF   (hex)		Samsung Electronics Co.,Ltd
+5056BF     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+90-F1-AA   (hex)		Samsung Electronics Co.,Ltd
+90F1AA     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+10-77-B1   (hex)		Samsung Electronics Co.,Ltd
+1077B1     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-1F-C7   (hex)		Casio Hitachi Mobile Communications Co., Ltd.
+001FC7     (base 16)		Casio Hitachi Mobile Communications Co., Ltd.
+				2-229-1, Sakuragaoka
+				Higashiyamato-shi  Tokyo  207-8501
+				JP
+
+A4-9A-58   (hex)		Samsung Electronics Co.,Ltd
+A49A58     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-EE-8B   (hex)		Samsung Electronics Co.,Ltd
+08EE8B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-A4-2A   (hex)		OB Telecom Electronic Technology Co., Ltd
+0CA42A     (base 16)		OB Telecom Electronic Technology Co., Ltd
+				17/F, Jiangong Building
+				Hangzhou  ZheJiang  310012
+				CN
+
+74-45-8A   (hex)		Samsung Electronics Co.,Ltd
+74458A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+5C-DC-96   (hex)		Arcadyan Technology Corporation
+5CDC96     (base 16)		Arcadyan Technology Corporation
+				No.8, Sec.2, Guangfu Rd.,
+				Hsinchu City 30071,    12345
+				TW
+
+74-31-70   (hex)		Arcadyan Technology Corporation
+743170     (base 16)		Arcadyan Technology Corporation
+				4F. , No. 9 , Park Avenue II,
+				Hsinchu    300
+				TW
+
+00-1A-2A   (hex)		Arcadyan Technology Corporation
+001A2A     (base 16)		Arcadyan Technology Corporation
+				4F., No. 9 , Park Avenue II,
+				Hsinchu    300
+				TW
+
+88-25-2C   (hex)		Arcadyan Technology Corporation
+88252C     (base 16)		Arcadyan Technology Corporation
+				4F., NO.9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+40-BA-61   (hex)		ARIMA Communications Corp.
+40BA61     (base 16)		ARIMA Communications Corp.
+				6F., No.866, Jhongjheng Rd., Jhonghe Dist.
+				New Taipei City    23586
+				TW
+
+00-11-F5   (hex)		ASKEY COMPUTER CORP
+0011F5     (base 16)		ASKEY COMPUTER CORP
+				10F, NO.119, CHIENKANG  RD.,
+				CHUNG-HO, TAIPEI    235
+				TW
+
+00-16-E3   (hex)		ASKEY COMPUTER CORP
+0016E3     (base 16)		ASKEY COMPUTER CORP
+				10F, NO.119, CHIENKANG RD.,
+				CHUNG-HO, TAIPEI    235
+				TW
+
+E8-39-DF   (hex)		ASKEY COMPUTER CORP
+E839DF     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,CHUNG-HO,TAIPEI,
+				TAIWAN  TAIPEI  235
+				TW
+
+1C-C6-3C   (hex)		Arcadyan Technology Corporation
+1CC63C     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+18-83-BF   (hex)		Arcadyan Technology Corporation
+1883BF     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+68-ED-43   (hex)		BlackBerry RTS
+68ED43     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+70-AA-B2   (hex)		BlackBerry RTS
+70AAB2     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+00-14-6C   (hex)		NETGEAR
+00146C     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-1E-2A   (hex)		NETGEAR
+001E2A     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-18-4D   (hex)		NETGEAR
+00184D     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-04-0E   (hex)		AVM GmbH
+00040E     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				berlin    12345
+				DE
+
+9C-C7-A6   (hex)		AVM GmbH
+9CC7A6     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				berlin  Berlin  10559
+				DE
+
+A0-63-91   (hex)		NETGEAR
+A06391     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+20-E5-2A   (hex)		NETGEAR
+20E52A     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+44-94-FC   (hex)		NETGEAR
+4494FC     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+20-0C-C8   (hex)		NETGEAR
+200CC8     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+C4-47-3F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4473F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-44-01   (hex)		NETGEAR
+744401     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+E0-91-F5   (hex)		NETGEAR
+E091F5     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-0F-86   (hex)		BlackBerry RTS
+000F86     (base 16)		BlackBerry RTS
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+00-24-D2   (hex)		ASKEY COMPUTER CORP
+0024D2     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,CHUNG-HO,TAIPEI,
+				TAIWAN  TAIPEI  235
+				TW
+
+B4-EE-B4   (hex)		ASKEY COMPUTER CORP
+B4EEB4     (base 16)		ASKEY COMPUTER CORP
+				10F,NO.119,CHIENKANG RD,ZHONGHE DIST NEW TAIPEI CITY
+				TAIWAN  TAIPEI  23585
+				TW
+
+E4-64-49   (hex)		ARRIS Group, Inc.
+E46449     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-FC-89   (hex)		ARRIS Group, Inc.
+40FC89     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+2C-9E-5F   (hex)		ARRIS Group, Inc.
+2C9E5F     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-36   (hex)		ARRIS Group, Inc.
+002636     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1C-C1   (hex)		ARRIS Group, Inc.
+001CC1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1E-5A   (hex)		ARRIS Group, Inc.
+001E5A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-13-71   (hex)		ARRIS Group, Inc.
+001371     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-EE   (hex)		ARRIS Group, Inc.
+0023EE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-DE   (hex)		ARRIS Group, Inc.
+001ADE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+74-56-12   (hex)		ARRIS Group, Inc.
+745612     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-50-E3   (hex)		ARRIS Group, Inc.
+0050E3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-21-36   (hex)		ARRIS Group, Inc.
+002136     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-16-26   (hex)		ARRIS Group, Inc.
+001626     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-19-A6   (hex)		ARRIS Group, Inc.
+0019A6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-C7-4F   (hex)		Liteon Technology Corporation
+E8C74F     (base 16)		Liteon Technology Corporation
+				4F, No. 90, Chien 1 Road,
+				New Taipei City  Taiwan  23585
+				TW
+
+D0-53-49   (hex)		Liteon Technology Corporation
+D05349     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road ChungHo
+				New Taipei City  Taiwan  23585
+				TW
+
+E8-F7-24   (hex)		Hewlett Packard Enterprise
+E8F724     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+5C-B5-24   (hex)		Sony Mobile Communications Inc
+5CB524     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+90-C1-15   (hex)		Sony Mobile Communications Inc
+90C115     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+D0-51-62   (hex)		Sony Mobile Communications Inc
+D05162     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+18-00-2D   (hex)		Sony Mobile Communications Inc
+18002D     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+28-0D-FC   (hex)		Sony Interactive Entertainment Inc.
+280DFC     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+00-13-11   (hex)		ARRIS Group, Inc.
+001311     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D0-DF-9A   (hex)		Liteon Technology Corporation
+D0DF9A     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+1C-65-9D   (hex)		Liteon Technology Corporation
+1C659D     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+30-10-B3   (hex)		Liteon Technology Corporation
+3010B3     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road, ChungHo, TaiPei Hsien
+				TaiPei  TaiWan  23585
+				TW
+
+70-1A-04   (hex)		Liteon Technology Corporation
+701A04     (base 16)		Liteon Technology Corporation
+				4F 90 Chien 1 Rd.ChungHo
+				Taipei    23585
+				TW
+
+48-D2-24   (hex)		Liteon Technology Corporation
+48D224     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+20-68-9D   (hex)		Liteon Technology Corporation
+20689D     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+00-24-EF   (hex)		Sony Mobile Communications Inc
+0024EF     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-25-E7   (hex)		Sony Mobile Communications Inc
+0025E7     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+58-17-0C   (hex)		Sony Mobile Communications Inc
+58170C     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-16-B8   (hex)		Sony Mobile Communications Inc
+0016B8     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+7C-BF-B1   (hex)		ARRIS Group, Inc.
+7CBFB1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+08-00-46   (hex)		Sony Corporation
+080046     (base 16)		Sony Corporation
+				Gotenyama Tec, 5-1-2 Kitashinagawa
+				Tokyo    141-0001
+				JP
+
+EC-F0-0E   (hex)		AboCom
+ECF00E     (base 16)		AboCom
+				1F , No. 21, Yanfa 2nd Rd., SBIP
+				Hsinchu City  300    886
+				TW
+
+00-E0-98   (hex)		AboCom
+00E098     (base 16)		AboCom
+				12F-3, NO. 333, SEC. 1
+				HSIN-CHU    12345
+				TW
+
+74-DA-EA   (hex)		Texas Instruments
+74DAEA     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+94-88-15   (hex)		Infinique Worldwide Inc
+948815     (base 16)		Infinique Worldwide Inc
+				513, 4185 Shipp Drive
+				Mississauga  Ontario  L4Z2Y8
+				CA
+
+D0-E4-4A   (hex)		Murata Manufacturing Co., Ltd.
+D0E44A     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+38-4F-F0   (hex)		AzureWave Technology Inc.
+384FF0     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd
+				. New Taipei City  Taiwan  231
+				TW
+
+E8-74-E6   (hex)		ADB Broadband Italia
+E874E6     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				IT
+
+00-20-E0   (hex)		Actiontec Electronics, Inc
+0020E0     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-26-62   (hex)		Actiontec Electronics, Inc
+002662     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-25-53   (hex)		ADB Broadband Italia
+002553     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+00-19-3E   (hex)		ADB Broadband Italia
+00193E     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+00-08-27   (hex)		ADB Broadband Italia
+000827     (base 16)		ADB Broadband Italia
+				Viale Sarca 222
+				pisacataway  Milano  20126
+				IT
+
+74-2F-68   (hex)		AzureWave Technology Inc.
+742F68     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd., Xindian
+				Taipei    231
+				TW
+
+4C-14-A3   (hex)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+4C14A3     (base 16)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+				19th Zhongkai Hi-tech Development Zone
+				Huizhou  Guangdong  516006
+				CN
+
+4C-B0-E8   (hex)		Beijing RongZhi xinghua technology co., LTD
+4CB0E8     (base 16)		Beijing RongZhi xinghua technology co., LTD
+				Beijing haidian district zhongguancun east road No. 18 smartfortune international building, room 909
+				beijing  beijing  100000
+				CN
+
+D8-87-D5   (hex)		Leadcore Technology CO.,LTD
+D887D5     (base 16)		Leadcore Technology CO.,LTD
+				1258 Mingyue Road,Shanghai.China
+				shanghai  shanghai  201206
+				CN
+
+00-F2-8B   (hex)		Cisco Systems, Inc
+00F28B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-E6-AD   (hex)		Intel Corporate
+34E6AD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+08-11-96   (hex)		Intel Corporate
+081196     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+18-3D-A2   (hex)		Intel Corporate
+183DA2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+80-9B-20   (hex)		Intel Corporate
+809B20     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-23-14   (hex)		Intel Corporate
+002314     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+34-02-86   (hex)		Intel Corporate
+340286     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1C-BF   (hex)		Intel Corporate
+001CBF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B4-B6-76   (hex)		Intel Corporate
+B4B676     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+3C-A9-F4   (hex)		Intel Corporate
+3CA9F4     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B8-8A-60   (hex)		Intel Corporate
+B88A60     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+78-FF-57   (hex)		Intel Corporate
+78FF57     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+9C-4E-36   (hex)		Intel Corporate
+9C4E36     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+34-13-E8   (hex)		Intel Corporate
+3413E8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-27-10   (hex)		Intel Corporate
+002710     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A4-8E-0A   (hex)		DeLaval International AB
+A48E0A     (base 16)		DeLaval International AB
+				Gustaf De Lavals väg 15
+				TUMBA    14721
+				SE
+
+AC-2B-6E   (hex)		Intel Corporate
+AC2B6E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+9C-35-83   (hex)		Nipro Diagnostics, Inc
+9C3583     (base 16)		Nipro Diagnostics, Inc
+				2400 N.W. 55th Court.
+				Ft. Lauderdale  FL  33309
+				US
+
+C0-61-18   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C06118     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B8-2A-72   (hex)		Dell Inc.
+B82A72     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+F8-E0-79   (hex)		Motorola Mobility LLC, a Lenovo Company
+F8E079     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+CC-C3-EA   (hex)		Motorola Mobility LLC, a Lenovo Company
+CCC3EA     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+40-78-6A   (hex)		Motorola Mobility LLC, a Lenovo Company
+40786A     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+00-19-D1   (hex)		Intel Corporate
+0019D1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-19-D2   (hex)		Intel Corporate
+0019D2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1B-21   (hex)		Intel Corporate
+001B21     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+18-FF-0F   (hex)		Intel Corporate
+18FF0F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+34-DE-1A   (hex)		Intel Corporate
+34DE1A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+E8-B1-FC   (hex)		Intel Corporate
+E8B1FC     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+CC-3D-82   (hex)		Intel Corporate
+CC3D82     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1F-3C   (hex)		Intel Corporate
+001F3C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-23-15   (hex)		Intel Corporate
+002315     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-16-6F   (hex)		Intel Corporate
+00166F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-0A-8A   (hex)		Cisco Systems, Inc
+000A8A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-09   (hex)		Dell Inc.
+001D09     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+00-23-AE   (hex)		Dell Inc.
+0023AE     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+BC-30-5B   (hex)		Dell Inc.
+BC305B     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+38-86-02   (hex)		Flexoptix GmbH
+388602     (base 16)		Flexoptix GmbH
+				Muehltalstr. 153
+				Darmstadt    64297
+				DE
+
+40-65-A3   (hex)		Sagemcom Broadband SAS
+4065A3     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+D0-22-12   (hex)		IEEE Registration Authority
+D02212     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+10-07-23   (hex)		IEEE Registration Authority
+100723     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-4F-29   (hex)		IEEE Registration Authority
+A44F29     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+74-F8-DB   (hex)		IEEE Registration Authority
+74F8DB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-3B-FA   (hex)		IEEE Registration Authority
+A43BFA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B8-CA-3A   (hex)		Dell Inc.
+B8CA3A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+EC-F4-BB   (hex)		Dell Inc.
+ECF4BB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+D4-BE-D9   (hex)		Dell Inc.
+D4BED9     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-19-4B   (hex)		Sagemcom Broadband SAS
+00194B     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+00-1E-74   (hex)		Sagemcom Broadband SAS
+001E74     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+38-3B-C8   (hex)		2Wire Inc
+383BC8     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+60-FE-20   (hex)		2Wire Inc
+60FE20     (base 16)		2Wire Inc
+				1764 Automation ParkWay
+				San Jose  CA  95131
+				US
+
+00-24-56   (hex)		2Wire Inc
+002456     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+C0-83-0A   (hex)		2Wire Inc
+C0830A     (base 16)		2Wire Inc
+				1764 Automation Pkwy
+				San Jose  CA  95131
+				US
+
+00-18-3F   (hex)		2Wire Inc
+00183F     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  94538
+				US
+
+00-0D-56   (hex)		Dell Inc.
+000D56     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+18-1E-78   (hex)		Sagemcom Broadband SAS
+181E78     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+00-37-B7   (hex)		Sagemcom Broadband SAS
+0037B7     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+00-54-BD   (hex)		Swelaser AB
+0054BD     (base 16)		Swelaser AB
+				Tullgårdsgatan 8
+				Stockholm    11668
+				SE
+
+00-1E-4C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001E4C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+20-BB-76   (hex)		COL GIOVANNI PAOLO SpA
+20BB76     (base 16)		COL GIOVANNI PAOLO SpA
+				Via F.lli Ceirano n. 20
+				Moncalieri  TORINO  10024
+				IT
+
+3C-DD-89   (hex)		SOMO HOLDINGS & TECH. CO.,LTD.
+3CDD89     (base 16)		SOMO HOLDINGS & TECH. CO.,LTD.
+				6, Mujeonggonddan-Gil
+				Damyang-Gun  Jellanam-Do  57360
+				KR
+
+18-01-E3   (hex)		Bittium Wireless Ltd
+1801E3     (base 16)		Bittium Wireless Ltd
+				Tutkijantie 8
+				Oulu    50590
+				FI
+
+14-91-82   (hex)		Belkin International Inc.
+149182     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+18-62-2C   (hex)		Sagemcom Broadband SAS
+18622C     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+3C-81-D8   (hex)		Sagemcom Broadband SAS
+3C81D8     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+40-F2-01   (hex)		Sagemcom Broadband SAS
+40F201     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+D0-84-B0   (hex)		Sagemcom Broadband SAS
+D084B0     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison  HAUTS DE SEINE  92848
+				FR
+
+D8-54-3A   (hex)		Texas Instruments
+D8543A     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+64-9C-8E   (hex)		Texas Instruments
+649C8E     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+10-2E-AF   (hex)		Texas Instruments
+102EAF     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+7C-8E-E4   (hex)		Texas Instruments
+7C8EE4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+B4-EE-D4   (hex)		Texas Instruments
+B4EED4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+D0-37-61   (hex)		Texas Instruments
+D03761     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+C8-3E-99   (hex)		Texas Instruments
+C83E99     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+40-98-4E   (hex)		Texas Instruments
+40984E     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-EB   (hex)		Texas Instruments
+0017EB     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-E6   (hex)		Texas Instruments
+0017E6     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+C4-ED-BA   (hex)		Texas Instruments
+C4EDBA     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-32   (hex)		Texas Instruments
+001832     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+3C-2D-B7   (hex)		Texas Instruments
+3C2DB7     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+54-64-D9   (hex)		Sagemcom Broadband SAS
+5464D9     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+00-19-5B   (hex)		D-Link Corporation
+00195B     (base 16)		D-Link Corporation
+				NO.289, Sinhu 3rd Rd.,
+				Neihu District,  Taipei City  114
+				TW
+
+00-0F-3D   (hex)		D-Link Corporation
+000F3D     (base 16)		D-Link Corporation
+				No.8,Li-shing Seventh Road,Science-based Industrial Park,Hsimchu,
+				Hsimchu    300
+				TW
+
+24-DA-11   (hex)		NO NDA Inc
+24DA11     (base 16)		NO NDA Inc
+				828 Bryant St 
+				Palo Alto  IA  94301
+				US
+
+EC-22-80   (hex)		D-Link International
+EC2280     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,
+				SINGAPORE  Singapore  609917
+				SG
+
+9C-8E-99   (hex)		Hewlett Packard
+9C8E99     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+90-59-AF   (hex)		Texas Instruments
+9059AF     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+BC-6A-29   (hex)		Texas Instruments
+BC6A29     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+84-7E-40   (hex)		Texas Instruments
+847E40     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-35   (hex)		Intel Wireless Network Group
+001735     (base 16)		Intel Wireless Network Group
+				2111 NE 25th Ave
+				Hillsboro  OR  97124
+				US
+
+74-AC-5F   (hex)		Qiku Internet Network Scientific (Shenzhen) Co., Ltd.
+74AC5F     (base 16)		Qiku Internet Network Scientific (Shenzhen) Co., Ltd.
+				Cyber Harbor, 2nd Mengxi Road, Hi-Tech Industrial Park (North), NanShan District
+				ShenZhen  GuangDong  518000
+				CN
+
+38-CA-DA   (hex)		Apple, Inc.
+38CADA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-B3-3F   (hex)		Shenzhen TINNO Mobile Technology Corp.
+D0B33F     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park. NO.1 XiangShan East Road.,
+				GUANGDONG  SHENZHEN  518053
+				CN
+
+BC-D1-D3   (hex)		Shenzhen TINNO Mobile Technology Corp.
+BCD1D3     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park.
+				Nanshan, Shenzhen  GUANGDONG  518053
+				CN
+
+D8-3C-69   (hex)		Shenzhen TINNO Mobile Technology Corp.
+D83C69     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park. NO.1 XiangShan East Road
+				SHENZHEN  GUANGDONG  518053
+				CN
+
+F4-F5-D8   (hex)		Google, Inc.
+F4F5D8     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+8C-57-9B   (hex)		Wistron Neweb Corporation
+8C579B     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+00-59-AC   (hex)		KPN. B.V.
+0059AC     (base 16)		KPN. B.V.
+				Maanplein 55
+				Den Haag  Zuid holland  2516 CK
+				NL
+
+40-D8-55   (hex)		IEEE Registration Authority
+40D855     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+34-AB-37   (hex)		Apple, Inc.
+34AB37     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-00-BA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2400BA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+24-DF-6A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24DF6A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+78-8B-77   (hex)		Standar Telecom
+788B77     (base 16)		Standar Telecom
+				Sadovnicheskaya 44 s.4
+				Moscow    115035
+				RU
+
+B0-C0-90   (hex)		Chicony Electronics Co., Ltd.
+B0C090     (base 16)		Chicony Electronics Co., Ltd.
+				No.25, Wugong 6th Rd., Wugu Dist.,
+				New Taipei City 248,  TAIWAN, REPUBLIC OF CHINA  248
+				TW
+
+90-7F-61   (hex)		Chicony Electronics Co., Ltd.
+907F61     (base 16)		Chicony Electronics Co., Ltd.
+				No.25, Wu-Gong 6th Rd., Wu Ku Industrial Park,
+				New Taipei City,    248
+				TW
+
+0C-05-35   (hex)		Juniper Systems
+0C0535     (base 16)		Juniper Systems
+				1132 W. 1700 N.
+				Logan  UT  84321
+				US
+
+BC-83-A7   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+BC83A7     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit A 13-16/F,Skyworth Bldg., Gaoxin Ave.1.S.,Nanshan District
+				Shenzhen  GuangDong   518057
+				CN
+
+BC-EC-23   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+BCEC23     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit A13-16/F,Skyworth Bldg., Gaoxin Ave.1.S.,Nanshan District,Shenzhen,China
+				ShenZhen  GuangDong  518057
+				CN
+
+18-AF-61   (hex)		Apple, Inc.
+18AF61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-F9-38   (hex)		Apple, Inc.
+5CF938     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-90-69   (hex)		Juniper Networks
+009069     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+64-64-9B   (hex)		Juniper Networks
+64649B     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F0-1C-2D   (hex)		Juniper Networks
+F01C2D     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+30-7C-5E   (hex)		Juniper Networks
+307C5E     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+AC-06-C7   (hex)		ServerNet S.r.l.
+AC06C7     (base 16)		ServerNet S.r.l.
+				Località Padriciano 99
+				Trieste  Trieste  34149
+				IT
+
+E8-3E-FC   (hex)		ARRIS Group, Inc.
+E83EFC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+90-0D-CB   (hex)		ARRIS Group, Inc.
+900DCB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-CD   (hex)		ARRIS Group, Inc.
+001DCD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-D2   (hex)		ARRIS Group, Inc.
+001DD2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+8C-09-F4   (hex)		ARRIS Group, Inc.
+8C09F4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+88-57-EE   (hex)		BUFFALO.INC
+8857EE     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+10-1F-74   (hex)		Hewlett Packard
+101F74     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-9C-02   (hex)		Hewlett Packard
+009C02     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+F4-CE-46   (hex)		Hewlett Packard
+F4CE46     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+DC-FB-02   (hex)		BUFFALO.INC
+DCFB02     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg.,30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref  460-8315
+				JP
+
+00-16-35   (hex)		Hewlett Packard
+001635     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-08-C7   (hex)		Hewlett Packard
+0008C7     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-10-E3   (hex)		Hewlett Packard
+0010E3     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-08-83   (hex)		Hewlett Packard
+000883     (base 16)		Hewlett Packard
+				MAIL STOP 42LE
+				CUPERTINO  CA  95014
+				US
+
+A0-2B-B8   (hex)		Hewlett Packard
+A02BB8     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-19-BB   (hex)		Hewlett Packard
+0019BB     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-1F-29   (hex)		Hewlett Packard
+001F29     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-21-5A   (hex)		Hewlett Packard
+00215A     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-23-7D   (hex)		Hewlett Packard
+00237D     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+E8-ED-05   (hex)		ARRIS Group, Inc.
+E8ED05     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+78-96-84   (hex)		ARRIS Group, Inc.
+789684     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+CC-65-AD   (hex)		ARRIS Group, Inc.
+CC65AD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-55   (hex)		Hewlett Packard
+002655     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-0D-9D   (hex)		Hewlett Packard
+000D9D     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-15-60   (hex)		Hewlett Packard
+001560     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-20-7B   (hex)		Intel Corporation
+00207B     (base 16)		Intel Corporation
+				2111 NE 25th Avenue
+				Hillsboro  OR  97124
+				US
+
+00-11-75   (hex)		Intel Corporation
+001175     (base 16)		Intel Corporation
+				 5200 NE ELAM YOUNG PARKWAY
+				HIllsboro  OR  97124
+				US
+
+78-0C-B8   (hex)		Intel Corporate
+780CB8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+18-5E-0F   (hex)		Intel Corporate
+185E0F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+2C-81-58   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+2C8158     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+80-02-DF   (hex)		ORA Inc.
+8002DF     (base 16)		ORA Inc.
+				No.1 Anjialou, Xiaoliangmaqiao Ave., Chaoyang Dist.
+				BeiJing    100125
+				CN
+
+00-30-6E   (hex)		Hewlett Packard
+00306E     (base 16)		Hewlett Packard
+				ENTERPRISE SYSTEMS TECH.CENTER
+				CUPERTINO  CA  95014
+				US
+
+3C-4A-92   (hex)		Hewlett Packard
+3C4A92     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+7C-7D-3D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C7D3D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+44-82-E5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4482E5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-23-4E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00234E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+2C-23-3A   (hex)		Hewlett Packard
+2C233A     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-0A-57   (hex)		Hewlett Packard
+000A57     (base 16)		Hewlett Packard
+				10955 Tantau Avenue
+				Cupertino  CA  95014
+				US
+
+00-01-E7   (hex)		Hewlett Packard
+0001E7     (base 16)		Hewlett Packard
+				11000 Wolfe Road, Mailstop 42LE
+				Cupertino  CA  95014
+				US
+
+00-01-E6   (hex)		Hewlett Packard
+0001E6     (base 16)		Hewlett Packard
+				11000 Wolfe Road, Mailstop 42LE
+				Cupertino  CA  95014
+				US
+
+00-23-76   (hex)		HTC Corporation
+002376     (base 16)		HTC Corporation
+				No.23 Xinghua Road
+				Taoyuan County    330
+				TW
+
+38-E7-D8   (hex)		HTC Corporation
+38E7D8     (base 16)		HTC Corporation
+				No.23 Xinghua Road
+				Taoyuan County    330
+				TW
+
+18-87-96   (hex)		HTC Corporation
+188796     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+B4-CE-F6   (hex)		HTC Corporation
+B4CEF6     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+8C-DC-D4   (hex)		Hewlett Packard
+8CDCD4     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D4-C9-EF   (hex)		Hewlett Packard
+D4C9EF     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+FC-15-B4   (hex)		Hewlett Packard
+FC15B4     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+3C-A8-2A   (hex)		Hewlett Packard
+3CA82A     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+EC-5F-23   (hex)		Qinghai Kimascend Electronics Technology Co. Ltd.
+EC5F23     (base 16)		Qinghai Kimascend Electronics Technology Co. Ltd.
+				2F,Building 6,J6 Science&Tech Park, No.6 Jiangjun Rd., Jiangning District
+				Nanjing  Jiangsu  211100
+				CN
+
+04-7D-50   (hex)		Shenzhen Kang Ying Technology Co.Ltd.
+047D50     (base 16)		Shenzhen Kang Ying Technology Co.Ltd.
+				Units 608,Saiba Electronic tower,NO.6, Langshan 2 Rd., Hi-Tech Industrial Park North , Nanshan, Shenzhen City
+				Shenzhen  Guangdong  518057
+				CN
+
+54-EF-FE   (hex)		Fullpower Technologies, Inc.
+54EFFE     (base 16)		Fullpower Technologies, Inc.
+				1200 Pacific Avenue
+				Santa Cruz  CA  95060
+				US
+
+94-09-37   (hex)		HUMAX Co., Ltd.
+940937     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bundang-gu,
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+E8-4D-D0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E84DD0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-45-BA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C45BA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-90-6F   (hex)		Shenzhen Tencent Computer System Co., Ltd.
+20906F     (base 16)		Shenzhen Tencent Computer System Co., Ltd.
+				5-10 Building High-tech Zone, Nanshan District, 
+				Shenzhen  Guangdong Province  518057
+				CN
+
+6C-E3-B6   (hex)		Nera Telecommunications Ltd.
+6CE3B6     (base 16)		Nera Telecommunications Ltd.
+				109 Defu Lane 10
+				Singapore  Singapore  539225
+				SG
+
+DC-D3-21   (hex)		HUMAX Co., Ltd.
+DCD321     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 11-4, Sunae-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-825
+				KR
+
+6C-72-E7   (hex)		Apple, Inc.
+6C72E7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-1B-B2   (hex)		Apple, Inc.
+741BB2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-E8-73   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+6CE873     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park
+				Shenzhen  Guangdong  518057
+				CN
+
+C4-6E-1F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C46E1F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+50-FA-84   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+50FA84     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+44-B3-2D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+44B32D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+CC-44-63   (hex)		Apple, Inc.
+CC4463     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-25-93   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+882593     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+00-1F-E1   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001FE1     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+D8-5D-4C   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D85D4C     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518000
+				CN
+
+A0-F3-C1   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+A0F3C1     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan
+				shenzhen  guangdong Province  518057
+				CN
+
+00-1D-0F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+001D0F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				3/F, Bldg. R1-B,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-23-CD   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0023CD     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				South Building, No.5 Keyuan Road, Central Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+90-48-9A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+90489A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-71-CC   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0071CC     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+B0-5B-67   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B05B67     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-A2-23   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CCA223     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-6A-89   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+786A89     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-46-08   (hex)		zte corporation
+384608     (base 16)		zte corporation
+				12/F,ZTE R&D Building,Kejinan Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+4C-AC-0A   (hex)		zte corporation
+4CAC0A     (base 16)		zte corporation
+				12/F,ZTE R&D Building,Kejinan Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+B4-B3-62   (hex)		zte corporation
+B4B362     (base 16)		zte corporation
+				12/F,ZTE R&D Building,Kejinan Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-75-D5   (hex)		zte corporation
+B075D5     (base 16)		zte corporation
+				12/F,ZTE R&D Building,Kejinan Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-15-4A   (hex)		zte corporation
+D0154A     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+00-26-ED   (hex)		zte corporation
+0026ED     (base 16)		zte corporation
+				12/F ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  GUANGDONG  518057
+				CN
+
+00-60-57   (hex)		Murata Manufacturing Co., Ltd.
+006057     (base 16)		Murata Manufacturing Co., Ltd.
+				1-18-1 HAKUSAN MIDORI-KU
+				YOKOHAMA  226    12345
+				JP
+
+78-3E-53   (hex)		BSkyB Ltd
+783E53     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+00-19-FB   (hex)		BSkyB Ltd
+0019FB     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+14-B9-68   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14B968     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-F9-6A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CF96A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-3E-8E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+083E8E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-22-93   (hex)		zte corporation
+002293     (base 16)		zte corporation
+				12/F ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  GUANGDONG  518057
+				CN
+
+10-A5-D0   (hex)		Murata Manufacturing Co., Ltd.
+10A5D0     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1,Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+50-A7-2B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+50A72B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-D6-BD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0CD6BD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-F8-1C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00F81C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-7A-4C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+087A4C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+AC-E2-15   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACE215     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+34-6B-D3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+346BD3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+70-72-3C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70723C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+AC-E8-7B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACE87B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-3D-FF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F83DFF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+28-5F-DB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+285FDB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+40-4D-8E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+404D8E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+4C-54-99   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4C5499     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+F4-9F-F3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F49FF3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-09-95   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+240995     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-DB-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+84DBAC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-77-2B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94772B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-40-F0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D440F0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-02-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04021F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-CD-AE   (hex)		Avaya Inc
+10CDAE     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+04-8A-15   (hex)		Avaya Inc
+048A15     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+B4-B0-17   (hex)		Avaya Inc
+B4B017     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+90-FB-5B   (hex)		Avaya Inc
+90FB5B     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+C8-F4-06   (hex)		Avaya Inc
+C8F406     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-52-C5   (hex)		Avaya Inc
+7052C5     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+F8-15-47   (hex)		Avaya Inc
+F81547     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+50-61-84   (hex)		Avaya Inc
+506184     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+18-59-36   (hex)		Xiaomi Communications Co Ltd
+185936     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+20-A7-83   (hex)		miControl GmbH
+20A783     (base 16)		miControl GmbH
+				Blankenfelder Chaussee 1
+				Großbeeren  Brandenburg  15831
+				DE
+
+20-0B-C7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+200BC7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+F8-4A-BF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F84ABF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+78-D7-52   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+78D752     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+10-47-80   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+104780     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+54-89-98   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+548998     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+00-04-0D   (hex)		Avaya Inc
+00040D     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-A8-E3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+70A8E3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen    518129
+				CN
+
+F8-E8-11   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F8E811     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+F8-A4-5F   (hex)		Xiaomi Communications Co Ltd
+F8A45F     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+64-09-80   (hex)		Xiaomi Communications Co Ltd
+640980     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+94-04-9C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94049C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+68-8F-84   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+688F84     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				SHENZHEN  GUANGDONG  518129
+				CN
+
+30-D1-7E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30D17E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+00-50-BD   (hex)		Cisco Systems, Inc
+0050BD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-90-6F   (hex)		Cisco Systems, Inc
+00906F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-D6-EA   (hex)		Texas Instruments
+74D6EA     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+20-91-48   (hex)		Texas Instruments
+209148     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+54-4A-16   (hex)		Texas Instruments
+544A16     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+E0-2F-6D   (hex)		Cisco Systems, Inc
+E02F6D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+58-97-1E   (hex)		Cisco Systems, Inc
+58971E     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B4-E9-B0   (hex)		Cisco Systems, Inc
+B4E9B0     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-08-32   (hex)		Cisco Systems, Inc
+000832     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+18-9C-5D   (hex)		Cisco Systems, Inc
+189C5D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+5C-A4-8A   (hex)		Cisco Systems, Inc
+5CA48A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+1C-1D-86   (hex)		Cisco Systems, Inc
+1C1D86     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+60-73-5C   (hex)		Cisco Systems, Inc
+60735C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+34-A8-4E   (hex)		Cisco Systems, Inc
+34A84E     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+54-78-1A   (hex)		Cisco Systems, Inc
+54781A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-60-5C   (hex)		Cisco Systems, Inc
+00605C     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-06-C1   (hex)		Cisco Systems, Inc
+0006C1     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-14   (hex)		Cisco Systems, Inc
+00E014     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+DC-A5-F4   (hex)		Cisco Systems, Inc
+DCA5F4     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+50-17-FF   (hex)		Cisco Systems, Inc
+5017FF     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+70-10-5C   (hex)		Cisco Systems, Inc
+70105C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+10-F3-11   (hex)		Cisco Systems, Inc
+10F311     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-50-F0   (hex)		Cisco Systems, Inc
+0050F0     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-50-14   (hex)		Cisco Systems, Inc
+005014     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-90-F2   (hex)		Cisco Systems, Inc
+0090F2     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+0C-E0-E4   (hex)		PLANTRONICS, INC.
+0CE0E4     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+74-A2-E6   (hex)		Cisco Systems, Inc
+74A2E6     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+BC-F1-F2   (hex)		Cisco Systems, Inc
+BCF1F2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C8-00-84   (hex)		Cisco Systems, Inc
+C80084     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+40-A6-E8   (hex)		Cisco Systems, Inc
+40A6E8     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+30-85-A9   (hex)		ASUSTek COMPUTER INC.
+3085A9     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou
+				Taipei    112
+				US
+
+B8-38-61   (hex)		Cisco Systems, Inc
+B83861     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+58-0A-20   (hex)		Cisco Systems, Inc
+580A20     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+2C-3E-CF   (hex)		Cisco Systems, Inc
+2C3ECF     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-59-47   (hex)		Shenzhen Qihu Intelligent Technology Company Limited
+B05947     (base 16)		Shenzhen Qihu Intelligent Technology Company Limited
+				Room 201, Block A, No.1, Qianwan Road 1,Qianhai Shenzhen HongKong Modern Service Industry Cooperation Zone
+				Shenzhen  Guangdong  518057
+				CN
+
+34-62-88   (hex)		Cisco Systems, Inc
+346288     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+CC-D8-C1   (hex)		Cisco Systems, Inc
+CCD8C1     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+7C-0E-CE   (hex)		Cisco Systems, Inc
+7C0ECE     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+A0-EC-F9   (hex)		Cisco Systems, Inc
+A0ECF9     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+50-87-89   (hex)		Cisco Systems, Inc
+508789     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+38-1C-1A   (hex)		Cisco Systems, Inc
+381C1A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+BC-67-1C   (hex)		Cisco Systems, Inc
+BC671C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-19-47   (hex)		Cisco SPVTG
+001947     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-18-39   (hex)		Cisco-Linksys, LLC
+001839     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+00-22-15   (hex)		ASUSTek COMPUTER INC.
+002215     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,
+				Taipei    112
+				TW
+
+E0-CB-4E   (hex)		ASUSTek COMPUTER INC.
+E0CB4E     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+54-7C-69   (hex)		Cisco Systems, Inc
+547C69     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-17-31   (hex)		ASUSTek COMPUTER INC.
+001731     (base 16)		ASUSTek COMPUTER INC.
+				No.5 Shing Yeh Street,Kwei Shan Hsiang,Taoyuan
+				Taipei    333
+				TW
+
+DC-CE-C1   (hex)		Cisco Systems, Inc
+DCCEC1     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+9C-57-AD   (hex)		Cisco Systems, Inc
+9C57AD     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+60-FE-C5   (hex)		Apple, Inc.
+60FEC5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-25-E7   (hex)		Apple, Inc.
+E425E7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-92-6B   (hex)		Apple, Inc.
+BC926B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-1C-0C   (hex)		Apple, Inc.
+101C0C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-00-07   (hex)		Apple, Inc.
+080007     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-40-96   (hex)		Cisco Systems, Inc
+004096     (base 16)		Cisco Systems, Inc
+				170 W. Tasman Drive
+				San Jose  CA  95134
+				US
+
+30-F7-0D   (hex)		Cisco Systems, Inc
+30F70D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E8-65-49   (hex)		Cisco Systems, Inc
+E86549     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-7D-47   (hex)		Cisco Systems, Inc
+B07D47     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+38-ED-18   (hex)		Cisco Systems, Inc
+38ED18     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+38-20-56   (hex)		Cisco Systems, Inc
+382056     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+40-D3-2D   (hex)		Apple, Inc.
+40D32D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-2C-03   (hex)		Apple, Inc.
+C42C03     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-27-E4   (hex)		Apple, Inc.
+9027E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-9A-DD   (hex)		Apple, Inc.
+109ADD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-1F-AA   (hex)		Apple, Inc.
+581FAA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-C6-63   (hex)		Apple, Inc.
+88C663     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1F-5B   (hex)		Apple, Inc.
+001F5B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-24-36   (hex)		Apple, Inc.
+002436     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-25-4B   (hex)		Apple, Inc.
+00254B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-16-CB   (hex)		Apple, Inc.
+0016CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-17-F2   (hex)		Apple, Inc.
+0017F2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-6D-62   (hex)		Apple, Inc.
+7C6D62     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-C9-D0   (hex)		Apple, Inc.
+20C9D0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-96-7B   (hex)		Apple, Inc.
+68967B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-FC-FE   (hex)		Apple, Inc.
+84FCFE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-8B-7F   (hex)		Apple, Inc.
+E48B7F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-88-65   (hex)		Apple, Inc.
+008865     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-3B-AF   (hex)		Apple, Inc.
+BC3BAF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-E0-72   (hex)		Apple, Inc.
+3CE072     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-48-4C   (hex)		Apple, Inc.
+38484C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-67-06   (hex)		Apple, Inc.
+A46706     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-58-77   (hex)		Apple, Inc.
+8C5877     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-F0-5F   (hex)		Apple, Inc.
+7CF05F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-49-71   (hex)		Apple, Inc.
+804971     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-3E-6D   (hex)		Apple, Inc.
+6C3E6D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-67-78   (hex)		Apple, Inc.
+BC6778     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-D1-CB   (hex)		Apple, Inc.
+D8D1CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-FA-D8   (hex)		Apple, Inc.
+A8FAD8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-17-C2   (hex)		Apple, Inc.
+B817C2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-11-BE   (hex)		Apple, Inc.
+7C11BE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-37-37   (hex)		Apple, Inc.
+283737     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+50-EA-D6   (hex)		Apple, Inc.
+50EAD6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-D6-BB   (hex)		Apple, Inc.
+98D6BB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-9E-FC   (hex)		Apple, Inc.
+189EFC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-CF-5C   (hex)		Apple, Inc.
+ACCF5C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-00-6E   (hex)		Apple, Inc.
+80006E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-8E-0C   (hex)		Apple, Inc.
+848E0C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-15-C2   (hex)		Apple, Inc.
+3C15C2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-70-9F   (hex)		Apple, Inc.
+6C709F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-F2-FB   (hex)		Apple, Inc.
+C0F2FB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-E3-14   (hex)		Apple, Inc.
+24E314     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-E6-50   (hex)		Apple, Inc.
+80E650     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-FD-61   (hex)		Apple, Inc.
+90FD61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-70-45   (hex)		Apple, Inc.
+087045     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-88-08   (hex)		Apple, Inc.
+A88808     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-C3-61   (hex)		Apple, Inc.
+A4C361     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-F0-EE   (hex)		Apple, Inc.
+2CF0EE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-97-F3   (hex)		Apple, Inc.
+5C97F3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-F4-6F   (hex)		Apple, Inc.
+D4F46F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-76-BA   (hex)		Apple, Inc.
+6476BA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-E2-FD   (hex)		Apple, Inc.
+34E2FD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-48-9A   (hex)		Apple, Inc.
+04489A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-F6-1C   (hex)		Apple, Inc.
+F0F61C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-29-37   (hex)		Apple, Inc.
+8C2937     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-9F-BA   (hex)		Apple, Inc.
+B09FBA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-4D-E9   (hex)		Apple, Inc.
+0C4DE9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-F5-C6   (hex)		Apple, Inc.
+E0F5C6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-ED-CD   (hex)		Apple, Inc.
+A0EDCD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-F2-49   (hex)		Hitron Technologies. Inc
+F0F249     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+28-57-BE   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+2857BE     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+5C-F5-DA   (hex)		Apple, Inc.
+5CF5DA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-EE-69   (hex)		Apple, Inc.
+18EE69     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-9A-BE   (hex)		Apple, Inc.
+649ABE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-99-BF   (hex)		Apple, Inc.
+F099BF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-E9-6A   (hex)		Apple, Inc.
+94E96A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-29-3A   (hex)		Apple, Inc.
+AC293A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-FC-01   (hex)		Apple, Inc.
+9CFC01     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-35-EB   (hex)		Apple, Inc.
+9C35EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-43-7C   (hex)		Apple, Inc.
+48437C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-A3-95   (hex)		Apple, Inc.
+34A395     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-7E-61   (hex)		Apple, Inc.
+787E61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-F8-1D   (hex)		Apple, Inc.
+60F81D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-C9-86   (hex)		Apple, Inc.
+38C986     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-33-11   (hex)		Apple, Inc.
+D03311     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+50-7A-55   (hex)		Apple, Inc.
+507A55     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-C2-C6   (hex)		Shanghai Airm2m Communication Technology Co., Ltd
+C8C2C6     (base 16)		Shanghai Airm2m Communication Technology Co., Ltd
+				Rm.816,Building C,No.668,East Beijing Road,Huangpu District,Shanghai,China
+				Shang hai  Shang hai  200001
+				CN
+
+78-9C-85   (hex)		August Home, Inc.
+789C85     (base 16)		August Home, Inc.
+				657 Bryant Street
+				San Francisco  California  94107
+				US
+
+74-D7-CA   (hex)		Panasonic Corporation Automotive
+74D7CA     (base 16)		Panasonic Corporation Automotive
+				5652
+				Matsumoto City  Nagano  399-8730
+				JP
+
+58-82-A8   (hex)		Microsoft
+5882A8     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+58-68-5D   (hex)		Tempo Australia Pty Ltd
+58685D     (base 16)		Tempo Australia Pty Ltd
+				8/14 Rodborough Rd
+				Frenchs Forest  NSW  2086
+				AU
+
+54-4B-8C   (hex)		Juniper Networks
+544B8C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+DC-FE-07   (hex)		PEGATRON CORPORATION
+DCFE07     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+70-79-38   (hex)		Wuxi Zhanrui Electronic Technology Co.,LTD
+707938     (base 16)		Wuxi Zhanrui Electronic Technology Co.,LTD
+				Wuxi,Taihu West Road No.1188 Runhua International Building 1604
+				Wuxi  Jiangsu  214072
+				CN
+
+24-31-84   (hex)		SHARP Corporation
+243184     (base 16)		SHARP Corporation
+				22-22,Nagaike-Cho
+				Osaka-City  Osaka-Prefecture  545-8522
+				JP
+
+58-2B-DB   (hex)		Pax AB
+582BDB     (base 16)		Pax AB
+				Box 72
+				Hälleforsnäs    64806
+				SE
+
+E0-36-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E03676     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-38-8F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC388F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-3E-5C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D03E5C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-9E-41   (hex)		G24 Power Limited
+C49E41     (base 16)		G24 Power Limited
+				South Lake Drive
+				Newport  Gwent  NP10 8AS
+				GB
+
+B8-13-E9   (hex)		Trace Live Network
+B813E9     (base 16)		Trace Live Network
+				#200, 5970 Centre St SE
+				Calgary  Alberta  T2H0C1
+				CA
+
+80-B7-09   (hex)		Viptela, Inc
+80B709     (base 16)		Viptela, Inc
+				1740 Technology Drive, Ste#500
+				San Jose  California  95110
+				US
+
+F0-0D-5C   (hex)		JinQianMao  Technology Co.,Ltd.
+F00D5C     (base 16)		JinQianMao  Technology Co.,Ltd.
+				58#,Jiangbin Road,Taijiang District
+				Fuzhou  Fujian  350009
+				CN
+
+54-BE-53   (hex)		zte corporation
+54BE53     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+28-0E-8B   (hex)		Beijing Spirit Technology Development Co., Ltd.
+280E8B     (base 16)		Beijing Spirit Technology Development Co., Ltd.
+				No. 26 Ave. 4 Chuangye Middle Road
+				  Beijing  100085
+				CN
+
+F4-4D-30   (hex)		Elitegroup Computer Systems Co.,Ltd.
+F44D30     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.239,Sec.2,Ti Ding Blvd.,
+				Taipei  Taipei  
+				TW
+
+0C-86-10   (hex)		Juniper Networks
+0C8610     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+38-D4-0B   (hex)		Samsung Electronics Co.,Ltd
+38D40B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E8-3A-12   (hex)		Samsung Electronics Co.,Ltd
+E83A12     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-DA-9B   (hex)		Motorola Mobility LLC, a Lenovo Company
+24DA9B     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+30-E0-90   (hex)		Linctronix Ltd,
+30E090     (base 16)		Linctronix Ltd,
+				​9F-1, No.66, Chongqing Rd.,
+				Banqiao Dist.,  China  22063
+				TW
+
+A4-DC-BE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4DCBE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-B8-70   (hex)		Beijing Heweinet Technology Co.,Ltd.
+ECB870     (base 16)		Beijing Heweinet Technology Co.,Ltd.
+				1514 Room,15F,No.2 Building
+				Haidian District  Beijing  100085
+				CN
+
+94-BB-AE   (hex)		Husqvarna AB
+94BBAE     (base 16)		Husqvarna AB
+				Drottninggatan 2
+				Huskvarna  Sweden  56131
+				SE
+
+D4-0A-A9   (hex)		ARRIS Group, Inc.
+D40AA9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+20-3D-66   (hex)		ARRIS Group, Inc.
+203D66     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D4-94-E8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D494E8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-78-F0   (hex)		Beijing HuaqinWorld Technology Co.,Ltd.
+B078F0     (base 16)		Beijing HuaqinWorld Technology Co.,Ltd.
+				Beijing City, Chaoyang District Wangjing Garden Department Youle A District No. 3 building 308 room
+				Bejjing  Bejjing  100102
+				CN
+
+20-9B-CD   (hex)		Apple, Inc.
+209BCD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-95-E3   (hex)		SHANGHAI SIMCOM LIMITED
+3095E3     (base 16)		SHANGHAI SIMCOM LIMITED
+				Building A,SIM Technology Building,No.633, Jinzhong Road,Changning District , Shanghai, P.R.China
+				Shanghai  /  200355
+				CN
+
+80-65-6D   (hex)		Samsung Electronics Co.,Ltd
+80656D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-F1-36   (hex)		Samsung Electronics Co.,Ltd
+FCF136     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+B8-86-87   (hex)		Liteon Technology Corporation
+B88687     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+18-89-5B   (hex)		Samsung Electronics Co.,Ltd
+18895B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+58-49-25   (hex)		E3 Enterprise
+584925     (base 16)		E3 Enterprise
+				32F, Shinjuku Nomura Building
+				  Tokyo  163-0532
+				JP
+
+94-F2-78   (hex)		Elma Electronic
+94F278     (base 16)		Elma Electronic
+				44350 S. Grimmer Blvd
+				Fremont  CA  94538
+				US
+
+28-37-13   (hex)		Shenzhen 3Nod Digital Technology Co., Ltd.
+283713     (base 16)		Shenzhen 3Nod Digital Technology Co., Ltd.
+				Building D, No.8 Langhui Road, Tangxiayong Community, Songgang Street, Baoan District, Shenzhen City, Guangdong Province, P.R. China
+				Shenzhen  Guangdong  518105
+				CN
+
+08-94-EF   (hex)		Wistron Infocomm (Zhongshan) Corporation
+0894EF     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				No.38,East Keji Road,Zhongshan Torch Development Zone,Zhongshan City,Guangdong,China
+				Zhongshan  Guangdong  528437
+				CN
+
+E0-31-9E   (hex)		Valve Corporation
+E0319E     (base 16)		Valve Corporation
+				10900 NE 4th ST
+				Bellevue  Washington  98004
+				US
+
+3C-5C-C3   (hex)		Shenzhen First Blue Chip Technology Ltd
+3C5CC3     (base 16)		Shenzhen First Blue Chip Technology Ltd
+				3Nod Smart Building,11Floor,No.3012,Binhai Avenue, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+C4-9F-F3   (hex)		Mciao Technologies, Inc.
+C49FF3     (base 16)		Mciao Technologies, Inc.
+				Room304, Building 1, No.288 Qiuyi Rd., Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+78-8E-33   (hex)		Jiangsu SEUIC Technology Co.,Ltd
+788E33     (base 16)		Jiangsu SEUIC Technology Co.,Ltd
+				NO23.Wenzhu Road.Yuhuatai Distrct.
+				Nanjing  Jiangsu Province  210012
+				CN
+
+EC-EE-D8   (hex)		ZTLX Network Technology Co.,Ltd
+ECEED8     (base 16)		ZTLX Network Technology Co.,Ltd
+				Unit 703,No 77,CuShaHuan
+				ZhuHai  GuangDong  519000
+				CN
+
+80-EB-77   (hex)		Wistron Corporation
+80EB77     (base 16)		Wistron Corporation
+				No. 158, SingShan Rd., Neihu, Taipei 11469, Taiwan, R.O.C.
+				Neihu  Taipei  11469
+				
+
+48-39-74   (hex)		Proware Technologies Co., Ltd.
+483974     (base 16)		Proware Technologies Co., Ltd.
+				2nd F1 East Wing,South Section,Factory Building 24,Science&Technology Park, Shennan Rd, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+30-FF-F6   (hex)		HangZhou KuoHeng Technology Co.,ltd
+30FFF6     (base 16)		HangZhou KuoHeng Technology Co.,ltd
+				No.368,Wangjiali,Chang'ancun Industrial Park,Wenyan Town, Xiaoshan District, Hangzhou, CHina
+				HangZhou  ZheJiang  311258
+				CN
+
+D8-EF-CD   (hex)		Nokia
+D8EFCD     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+4C-C6-81   (hex)		Shenzhen Aisat Electronic Co., Ltd.
+4CC681     (base 16)		Shenzhen Aisat Electronic Co., Ltd.
+				Golden Building 419#, Design Park,
+				Shenzhen  Guangdong  518056
+				CN
+
+48-E2-44   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+48E244     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+7C-AB-25   (hex)		MESMO TECHNOLOGY INC.
+7CAB25     (base 16)		MESMO TECHNOLOGY INC.
+				3F., No.181, ZHOUZI ST., NEIHU DIST.,
+				TAIPEI  TAIPEI  11493
+				TW
+
+B0-41-1D   (hex)		ITTIM Technologies
+B0411D     (base 16)		ITTIM Technologies
+				B1606, No.6, Zhongguancun South Street,
+				Beijing  Beijing  100086
+				CN
+
+F8-BF-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F8BF09     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-B2-5C   (hex)		Acacia Communications
+7CB25C     (base 16)		Acacia Communications
+				3 Clock Tower Place
+				Maynard  MA  01754
+				US
+
+DC-DB-70   (hex)		Tonfunk Systementwicklung und Service GmbH
+DCDB70     (base 16)		Tonfunk Systementwicklung und Service GmbH
+				Anger20
+				Falkenstein / Harz OT Ermsleben  Sachsen-Anhalt  06463
+				DE
+
+80-0B-51   (hex)		Chengdu XGimi Technology Co.,Ltd
+800B51     (base 16)		Chengdu XGimi Technology Co.,Ltd
+				5F Building A7,Tianfu Software Park,Tianfu
+				Chengdu  Sichuan  610041
+				CN
+
+F8-0D-60   (hex)		CANON INC.
+F80D60     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+F0-18-2B   (hex)		LG Chem
+F0182B     (base 16)		LG Chem
+				128, Yeoui-daero, Yeongdeungpo-gu,
+				Seoul  Seoul  150-721
+				KR
+
+34-81-F4   (hex)		SST Taiwan Ltd.
+3481F4     (base 16)		SST Taiwan Ltd.
+				5F, No. 5, Industry E Rd. VII,
+				Hsin Chu,  Taiwan  30077
+				TW
+
+7C-A2-37   (hex)		King Slide Technology CO., LTD.
+7CA237     (base 16)		King Slide Technology CO., LTD.
+				No. 6, Luke 9th Rd.,
+				Kaohsiung  Taiwan  82151
+				TW
+
+D4-04-CD   (hex)		ARRIS Group, Inc.
+D404CD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+58-48-22   (hex)		Sony Mobile Communications Inc
+584822     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+74-73-36   (hex)		MICRODIGTAL Inc
+747336     (base 16)		MICRODIGTAL Inc
+				10F, Ace High-End Tower 9th,
+				  Seoul  153-803
+				KR
+
+38-2B-78   (hex)		ECO PLUGS ENTERPRISE CO., LTD
+382B78     (base 16)		ECO PLUGS ENTERPRISE CO., LTD
+				10F,-6, No.117, Sec.2, Zhongbei Rd., Zhongli Dist.,
+				Taoyuan  Taiwan  32097
+				TW
+
+A4-7B-2C   (hex)		Nokia
+A47B2C     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+24-E5-AA   (hex)		Philips Oral Healthcare, Inc.
+24E5AA     (base 16)		Philips Oral Healthcare, Inc.
+				22100 Bothell Everett Hwy
+				Bothell  WA  98021
+				US
+
+78-BD-BC   (hex)		Samsung Electronics Co.,Ltd
+78BDBC     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+34-9B-5B   (hex)		Maquet GmbH
+349B5B     (base 16)		Maquet GmbH
+				Kehler Strasse 31
+				Rastatt  Baden-Württemberg  76437
+				DE
+
+88-41-57   (hex)		Shenzhen Atsmart Technology Co.,Ltd.
+884157     (base 16)		Shenzhen Atsmart Technology Co.,Ltd.
+				East 3F ,2 Building, Meijing Industry Park, Qiaoxiang Road, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+D8-9A-34   (hex)		Beijing SHENQI Technology Co., Ltd.
+D89A34     (base 16)		Beijing SHENQI Technology Co., Ltd.
+				No.6 Shang Di West Road
+				 Haidian District  Beijing  100085
+				CN
+
+A0-A6-5C   (hex)		Supercomputing Systems AG
+A0A65C     (base 16)		Supercomputing Systems AG
+				Technoparkstrasse 1
+				Zurich  ZH  8005
+				CH
+
+48-50-73   (hex)		Microsoft Corporation
+485073     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+E8-37-7A   (hex)		Zyxel Communications Corporation
+E8377A     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+80-3B-2A   (hex)		ABB Xiamen Low Voltage Equipment Co.,Ltd.
+803B2A     (base 16)		ABB Xiamen Low Voltage Equipment Co.,Ltd.
+				No.12-20,3rd Chuang Xin Road
+				Xiamen SEZ  Fujian  361006
+				CN
+
+C4-EA-1D   (hex)		Technicolor
+C4EA1D     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+7C-F9-0E   (hex)		Samsung Electronics Co.,Ltd
+7CF90E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-F0-D3   (hex)		Samsung Electronics Co.,Ltd
+50F0D3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-A7-84   (hex)		ITX security
+00A784     (base 16)		ITX security
+				9F Kolon Digital Tower Aston Bldg
+				SEOUL  (Outside US/Canada/China)  441-813
+				KR
+
+84-11-9E   (hex)		Samsung Electronics Co.,Ltd
+84119E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-9A-10   (hex)		Microsoft Corporation
+149A10     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+38-FA-CA   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+38FACA     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-B4-3E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CB43E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-77-81   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+707781     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+54-E1-40   (hex)		INGENICO
+54E140     (base 16)		INGENICO
+				9 AVENUE DE LA GARE
+				VALENCE  DROME  26958
+				FR
+
+E4-90-7E   (hex)		Motorola Mobility LLC, a Lenovo Company
+E4907E     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+74-6A-3A   (hex)		Aperi Corporation
+746A3A     (base 16)		Aperi Corporation
+				360 Mobil Avenue
+				Camarillo  CA  93010
+				US
+
+94-A7-B7   (hex)		zte corporation
+94A7B7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+18-44-E6   (hex)		zte corporation
+1844E6     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+3C-CE-15   (hex)		Mercedes-Benz USA, LLC
+3CCE15     (base 16)		Mercedes-Benz USA, LLC
+				One Mercedes Drive
+				Montvale  NJ  07645
+				US
+
+28-76-10   (hex)		IgniteNet
+287610     (base 16)		IgniteNet
+				1, Creation 3rd Rd.
+				Hsinchu    300
+				TW
+
+20-D7-5A   (hex)		Posh Mobile Limited
+20D75A     (base 16)		Posh Mobile Limited
+				1011A 10/F Harbour Centre Tower 1, 1 Hok Cheung Street
+				HungHom  Kowloon  00000
+				HK
+
+F4-15-63   (hex)		F5 Networks, Inc.
+F41563     (base 16)		F5 Networks, Inc.
+				1322 North Whitman Lane
+				Liberty Lake  WA  99019
+				US
+
+8C-8B-83   (hex)		Texas Instruments
+8C8B83     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+40-11-DC   (hex)		Sonance
+4011DC     (base 16)		Sonance
+				212 Avenida Fabricante
+				San Clemente  California  92672
+				US
+
+1C-83-41   (hex)		Hefei Bitland Information Technology Co.Ltd
+1C8341     (base 16)		Hefei Bitland Information Technology Co.Ltd
+				C1# Building, Bitland Industrial Park, No#4088, Jinxiu RD,Economic Development Zone, Hefei, Anhui, China
+				Hefei  Anhui  230061
+				CN
+
+08-1F-EB   (hex)		BinCube
+081FEB     (base 16)		BinCube
+				Si Ming Shan Road 116, Beilun
+				Ningbo  Zhejiang  315800
+				CN
+
+78-5F-4C   (hex)		Argox Information Co., Ltd.
+785F4C     (base 16)		Argox Information Co., Ltd.
+				7F, No.126, Lane 235, Baoqiao Rd., Xindian Dist.
+				New Taipei City  Taipei  231
+				TW
+
+34-CC-28   (hex)		Nexpring Co. LTD.,
+34CC28     (base 16)		Nexpring Co. LTD.,
+				3rd Floor, Building C, PDC Tower
+				Sungnam City  Kyungki-do  463400
+				KR
+
+54-E2-C8   (hex)		Dongguan Aoyuan Electronics Technology Co., Ltd
+54E2C8     (base 16)		Dongguan Aoyuan Electronics Technology Co., Ltd
+				Factory A7 Zhen'an Sci-Tech Industrial Park, Chang'an Town, Dongguan City, Guangdong Province, China
+				Dongguan City  Guangdong Province  523863
+				CN
+
+6C-1E-70   (hex)		Guangzhou YBDS IT Co.,Ltd
+6C1E70     (base 16)		Guangzhou YBDS IT Co.,Ltd
+				Room 318,3/F,970 Kang Wang Bei Lu,Liwan District,Guangzhou,PRC
+				Guangzhou City  Guangdong Province  510170
+				CN
+
+54-B8-0A   (hex)		D-Link International
+54B80A     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+D8-AD-DD   (hex)		Sonavation, Inc.
+D8ADDD     (base 16)		Sonavation, Inc.
+				3970 RCA Blvd.
+				Palm Beach Gardens  Florida  33410
+				US
+
+88-33-BE   (hex)		Ivenix, Inc.
+8833BE     (base 16)		Ivenix, Inc.
+				21 Water Street
+				Amesbury  MA  01913
+				US
+
+E4-8D-8C   (hex)		Routerboard.com
+E48D8C     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+70-68-79   (hex)		Saijo Denki International Co., Ltd.
+706879     (base 16)		Saijo Denki International Co., Ltd.
+				39/9 Moo 9 Soi Duangmanee
+				Muang  Nonthaburi  11000
+				TH
+
+10-AF-78   (hex)		Shenzhen ATUE Technology Co., Ltd
+10AF78     (base 16)		Shenzhen ATUE Technology Co., Ltd
+				3/F,Building 2nd, Xintang Industry Zone,Fuyong Town,Bao'an District
+				Shenzhen  Guangdong  518103
+				CN
+
+CC-19-A8   (hex)		PT Inovação e Sistemas SA
+CC19A8     (base 16)		PT Inovação e Sistemas SA
+				Rua Eng. José Ferreira Pinto Basto
+				Aveiro  Aveiro  3810-106
+				PT
+
+B4-B2-65   (hex)		DAEHO I&T
+B4B265     (base 16)		DAEHO I&T
+				211, Jayumuyeok 3-gil, MasanHoewon-gu
+				Changwon-si  Gyeongsangnam-do  630-812
+				KR
+
+E0-35-60   (hex)		Challenger Supply Holdings, LLC
+E03560     (base 16)		Challenger Supply Holdings, LLC
+				4500 Mercantile Plaza Dr.
+				Fort Worth  TX  76137
+				US
+
+3C-CB-7C   (hex)		TCT mobile ltd
+3CCB7C     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+24-9E-AB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+249EAB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-4B-03   (hex)		Samsung Electronics Co.,Ltd
+244B03     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+E4-CE-70   (hex)		Health & Life co., Ltd.
+E4CE70     (base 16)		Health & Life co., Ltd.
+				9F, No. 186, Jian Yi Road
+				New Taipei City  Taiwan  23553
+				TW
+
+7C-11-CD   (hex)		QianTang Technology
+7C11CD     (base 16)		QianTang Technology
+				36 Landmark Palace
+				Beijing  Beijing  100125
+				
+
+CC-A4-AF   (hex)		Shenzhen Sowell Technology Co., LTD
+CCA4AF     (base 16)		Shenzhen Sowell Technology Co., LTD
+				7F, Yizhe Building. Yuquan Road.
+				Shen Zhen  Guang Dong  518052
+				CN
+
+10-2C-83   (hex)		XIMEA
+102C83     (base 16)		XIMEA
+				Lesna 52
+				Marianka  SK  90033
+				SK
+
+6C-A7-5F   (hex)		zte corporation
+6CA75F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+8C-79-67   (hex)		zte corporation
+8C7967     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+78-58-F3   (hex)		Vachen Co.,Ltd
+7858F3     (base 16)		Vachen Co.,Ltd
+				Rm1206, Hanyang Bldg, 18, Gukhoe-daero 70-gil, Yeongdeungpo-gu
+				Seoul  Seoul  150-748
+				KR
+
+70-9C-8F   (hex)		Nero AG
+709C8F     (base 16)		Nero AG
+				Rueppurrer Str. 1A
+				Karlsruhe  BW  76137
+				DE
+
+00-7E-56   (hex)		China Dragon Technology Limited
+007E56     (base 16)		China Dragon Technology Limited
+				B4 Bldg.Haoshan 1st Industry Park,
+				Shenzhen  Guangdong  518104
+				CN
+
+74-E2-8C   (hex)		Microsoft Corporation
+74E28C     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+00-71-C2   (hex)		PEGATRON CORPORATION
+0071C2     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+7C-82-74   (hex)		Shenzhen Hikeen Technology CO.,LTD
+7C8274     (base 16)		Shenzhen Hikeen Technology CO.,LTD
+				15rd floor,unit1,Building A of Kexing Science Park
+				Shenzhen  GuangDong  518057
+				CN
+
+94-D4-17   (hex)		GPI KOREA INC.
+94D417     (base 16)		GPI KOREA INC.
+				Daebang Triplaon B-Dong 201
+				Goyang-Si  Kyeonggi-Do  410-704
+				KR
+
+24-4B-81   (hex)		Samsung Electronics Co.,Ltd
+244B81     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-4E-66   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+704E66     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-55-A3   (hex)		zte corporation
+D855A3     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-D8-2F   (hex)		zte corporation
+38D82F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-79-59   (hex)		ASUSTek COMPUTER INC.
+F07959     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+E0-8E-3C   (hex)		Aztech Electronics Pte Ltd
+E08E3C     (base 16)		Aztech Electronics Pte Ltd
+				31, Ubi Road 1
+				Singapore  Singapore  408694
+				SG
+
+84-4B-B7   (hex)		Beijing Sankuai Online Technology Co.,Ltd
+844BB7     (base 16)		Beijing Sankuai Online Technology Co.,Ltd
+				Block F&G, Wangjing International R & D Park,     
+				Chaoyang District  BEIJING  100102
+				CN
+
+68-F0-BC   (hex)		Shenzhen LiWiFi Technology Co., Ltd
+68F0BC     (base 16)		Shenzhen LiWiFi Technology Co., Ltd
+				No.7, Xinxi Road, Hi-Tech Park (North Zone)
+				Shenzhen  Guangdong  518057
+				CN
+
+30-0E-E3   (hex)		Aquantia Corporation
+300EE3     (base 16)		Aquantia Corporation
+				700 Tasman Drive
+				Milpitas  CA  95035
+				US
+
+18-F1-45   (hex)		NetComm Wireless Limited
+18F145     (base 16)		NetComm Wireless Limited
+				Level 2, 18-20 Orion Road
+				Lane Cove  Sydney  2066
+				AU
+
+AC-AB-BF   (hex)		AthenTek Inc.
+ACABBF     (base 16)		AthenTek Inc.
+				8F., No.356, Sec. 1, Neihu Rd., Neihu Dist.,
+				Taipei City  Taiwan  114
+				TW
+
+28-84-FA   (hex)		SHARP Corporation
+2884FA     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+60-AF-6D   (hex)		Samsung Electronics Co.,Ltd
+60AF6D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-5A-73   (hex)		Samsung Electronics Co.,Ltd
+B85A73     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-1E-04   (hex)		D-Link International
+3C1E04     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+60-D9-A0   (hex)		Lenovo Mobile Communication Technology Ltd.
+60D9A0     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information & Optoelectronics Park,
+				Xiamen  Fujian  361006
+				
+
+68-B9-83   (hex)		b-plus GmbH
+68B983     (base 16)		b-plus GmbH
+				Ulrichsberger Str. 17
+				Deggendorf  Bavaria  94469
+				DE
+
+78-B3-B9   (hex)		ShangHai sunup lighting CO.,LTD
+78B3B9     (base 16)		ShangHai sunup lighting CO.,LTD
+				RM2508,Building 2,1077# Zu Chong Zhi Rd,Zhang Jiang Hi-Tech Park,Pudong New Area,ShangHai,China
+				shanghai  shanghai  201203
+				CN
+
+04-C0-9C   (hex)		Tellabs Inc.
+04C09C     (base 16)		Tellabs Inc.
+				1415 W. Diehl Road
+				Naperville  Illinois  60563
+				US
+
+98-1D-FA   (hex)		Samsung Electronics Co.,Ltd
+981DFA     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+18-68-82   (hex)		Beward R&D Co., Ltd.
+186882     (base 16)		Beward R&D Co., Ltd.
+				Molokova street 16, apt.355
+				Krasnoyarsk  Krasnoyarsk region  660118
+				RU
+
+EC-80-09   (hex)		NovaSparks
+EC8009     (base 16)		NovaSparks
+				12 rue de Chatillon
+				Paris  Ile de France  75014
+				FR
+
+50-AD-D5   (hex)		Dynalec Corporation
+50ADD5     (base 16)		Dynalec Corporation
+				87 West Main Street
+				Sodus  NY  14551
+				US
+
+B0-45-19   (hex)		TCT mobile ltd
+B04519     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+D8-8D-5C   (hex)		Elentec
+D88D5C     (base 16)		Elentec
+				Dongtangiheung-ro 64-3
+				Gyeonggi-do  Hwaseong-si/Dongtan-myeon  445-812
+				KR
+
+74-29-AF   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+7429AF     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+3C-1A-0F   (hex)		ClearSky Data
+3C1A0F     (base 16)		ClearSky Data
+				99 Summer Street
+				Boston  MA  02110
+				US
+
+E8-CC-18   (hex)		D-Link International
+E8CC18     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+B0-91-37   (hex)		ISis ImageStream Internet Solutions, Inc
+B09137     (base 16)		ISis ImageStream Internet Solutions, Inc
+				4374 FM 1518
+				Selma  TX  78154
+				US
+
+8C-05-51   (hex)		Koubachi AG
+8C0551     (base 16)		Koubachi AG
+				Technoparkstrasse 1
+				Zurich  Zurich  8005
+				CH
+
+D8-97-BA   (hex)		PEGATRON CORPORATION
+D897BA     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+A8-D8-8A   (hex)		Wyconn
+A8D88A     (base 16)		Wyconn
+				Rennweg 97-99
+				Vienna    1030
+				AT
+
+40-EA-CE   (hex)		FOUNDER BROADBAND NETWORK SERVICE CO.,LTD
+40EACE     (base 16)		FOUNDER BROADBAND NETWORK SERVICE CO.,LTD
+				5F,Tower B,Beifa Plaza,No.16 Building
+				Haisdian District  Beijing  100088
+				CN
+
+84-8E-DF   (hex)		Sony Mobile Communications Inc
+848EDF     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+A4-9D-49   (hex)		Ketra, Inc.
+A49D49     (base 16)		Ketra, Inc.
+				3815 S. Capital of Texas Hwy
+				Austin  TX  78704
+				US
+
+C0-38-96   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+C03896     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+2C-50-89   (hex)		Shenzhen Kaixuan Visual Technology Co.,Limited
+2C5089     (base 16)		Shenzhen Kaixuan Visual Technology Co.,Limited
+				No.19th Xifu Road, Hongxing Community
+				Shenzhen  Guangdong  518000
+				CN
+
+94-8E-89   (hex)		INDUSTRIAS UNIDAS SA DE CV
+948E89     (base 16)		INDUSTRIAS UNIDAS SA DE CV
+				CARRETERA PANAMERICANA
+				PASTEJE JOCOTITLAN  ESTADO DE MEXICO  50700
+				MX
+
+00-AE-FA   (hex)		Murata Manufacturing Co., Ltd.
+00AEFA     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+84-18-26   (hex)		Osram GmbH
+841826     (base 16)		Osram GmbH
+				Marcel Breuer Str. 6
+				Munich  Bavaria  80807
+				DE
+
+F8-E9-03   (hex)		D-Link International
+F8E903     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+E8-96-06   (hex)		testo Instruments (Shenzhen) Co., Ltd.
+E89606     (base 16)		testo Instruments (Shenzhen) Co., Ltd.
+				China Merchants Guangming Science & Technology Park,
+				Guangming New District, Shenzhen  Guangdong  518107
+				CN
+
+1C-7E-51   (hex)		3bumen.com
+1C7E51     (base 16)		3bumen.com
+				11/F FRONT BLK HANG LOK BLDG
+				HONG KONG  KONG KONG  N/A
+				HK
+
+68-72-DC   (hex)		CETORY.TV Company Limited
+6872DC     (base 16)		CETORY.TV Company Limited
+				Building C-1601, Tiley Central Plaza
+				Shenzhen  Guangdong  518054
+				CN
+
+30-77-CB   (hex)		Maike Industry(Shenzhen)CO.,LTD
+3077CB     (base 16)		Maike Industry(Shenzhen)CO.,LTD
+				Maike Industrial Garden, Sanwei village,
+				Shenzhen  Guangdong  518100
+				CN
+
+24-97-ED   (hex)		Techvision Intelligent Technology Limited
+2497ED     (base 16)		Techvision Intelligent Technology Limited
+				Room 7006B, Tianxia IC Industry Building,
+				Shenzhen  Guangdong  518052
+				CN
+
+90-9F-33   (hex)		EFM Networks
+909F33     (base 16)		EFM Networks
+				6F, Benposra II 1197-1 Bojeong Giheung Gu
+				Yong In  Kyunggi do  446913
+				KR
+
+60-04-17   (hex)		POSBANK CO.,LTD
+600417     (base 16)		POSBANK CO.,LTD
+				Room 805-808, New T Castle B/D, 429-1
+				  Seoul  153-803
+				KR
+
+20-76-93   (hex)		Lenovo (Beijing) Limited.
+207693     (base 16)		Lenovo (Beijing) Limited.
+				No.6 Chuang Ye Road Shangdi Information Industry Base,
+				  Beijing  100085
+				CN
+
+08-46-56   (hex)		VEO-LABS
+084656     (base 16)		VEO-LABS
+				14 rue du Patis Tatelin
+				RENNES  Bretagne  35700
+				FR
+
+EC-3C-5A   (hex)		SHEN ZHEN HENG SHENG HUI DIGITAL TECHNOLOGY CO.,LTD
+EC3C5A     (base 16)		SHEN ZHEN HENG SHENG HUI DIGITAL TECHNOLOGY CO.,LTD
+				5A 6FLOOR, BLOCK C12, FUYUAN INDUSTRIAL AREA, ZHOU SHI ROAD,
+				SHENZHEN  GUANGDONG  518102
+				CN
+
+44-88-CB   (hex)		Camco Technologies NV
+4488CB     (base 16)		Camco Technologies NV
+				Technologielaan 13
+				Heverlee  VB  3001
+				BE
+
+6C-BF-B5   (hex)		Noon Technology Co., Ltd
+6CBFB5     (base 16)		Noon Technology Co., Ltd
+				Building C, Zhangkeng Industrial Park, Minzhi
+				Shenzhen  GuangDong  518131
+				CN
+
+50-29-4D   (hex)		NANJING IOT SENSOR TECHNOLOGY CO,LTD
+50294D     (base 16)		NANJING IOT SENSOR TECHNOLOGY CO,LTD
+				ROOM 422 NO.420 ZHONGHUA ROAD QINHUAI DISTRICT NANJING CITY
+				Nangjing  jiangsu  210000
+				CN
+
+0C-CF-D1   (hex)		SPRINGWAVE Co., Ltd
+0CCFD1     (base 16)		SPRINGWAVE Co., Ltd
+				#B-703,U-space 1-danji,670 Sampyeong-dong Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+74-BA-DB   (hex)		Longconn Electornics(shenzhen)Co.,Ltd
+74BADB     (base 16)		Longconn Electornics(shenzhen)Co.,Ltd
+				Building D12,n 30,Xingye One Road,Fenghuang First Industrial Zone,Fuyong Street,Bao an District,Shenzhen,Guangdong Province.
+				shenzhen  guangdong  518000
+				CN
+
+B8-F3-17   (hex)		iSun Smasher Communications Private Limited
+B8F317     (base 16)		iSun Smasher Communications Private Limited
+				No. 826, Ferns Paradise, 2nd Street,
+				Bangalore  Karnataka  560037
+				IN
+
+8C-F8-13   (hex)		ORANGE POLSKA
+8CF813     (base 16)		ORANGE POLSKA
+				AL.JEROZOLIMSKIE 160
+				WARSAW  MASOVIA  02-326
+				PL
+
+54-9F-35   (hex)		Dell Inc.
+549F35     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+24-42-BC   (hex)		Alinco,incorporated
+2442BC     (base 16)		Alinco,incorporated
+				Yodoyabashi Dai-Bldg 13F,
+				Osaka  Osaka pref.  541-0043
+				JP
+
+F8-24-41   (hex)		Yeelink
+F82441     (base 16)		Yeelink
+				F10-B4, Bldg. B, International Innovation Park
+				Qingdao  Shandong  266101
+				CN
+
+10-8A-1B   (hex)		RAONIX Inc.
+108A1B     (base 16)		RAONIX Inc.
+				Changeop-Center 710, Shin-Gu Univ. Gwangmyeong-ro 377, Jungwon-gu
+				Seongnam-si  Gyeonggi-do  462-743
+				KR
+
+10-2F-6B   (hex)		Microsoft Corporation
+102F6B     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+8C-B0-94   (hex)		Airtech I&C Co., Ltd
+8CB094     (base 16)		Airtech I&C Co., Ltd
+				33B-9L #613-9, Namchon-dong
+				Namdong-gu  Incheon  405-846
+				KR
+
+94-54-93   (hex)		Rigado, LLC
+945493     (base 16)		Rigado, LLC
+				2601 25th ST SE, STE 200
+				Salem  OR  97302
+				US
+
+68-F0-6D   (hex)		ALONG INDUSTRIAL CO., LIMITED
+68F06D     (base 16)		ALONG INDUSTRIAL CO., LIMITED
+				FLAT/RM,3 11/F, HUNG TO INDUSTRIAL BUILDING
+				  HONG KONG  
+				HK
+
+F4-28-53   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+F42853     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				A1&A2 Building,Lantian Technology Park, Xinyu Road, Xingqiao Henggang Block, Shajing Street, Baoan District
+				Shenzhen  Guangdong  518000
+				CN
+
+D4-EC-86   (hex)		LinkedHope Intelligent Technologies Co., Ltd
+D4EC86     (base 16)		LinkedHope Intelligent Technologies Co., Ltd
+				2nd Floor,Building 1, Science Park,
+				Beijing  Beijing  100070
+				CN
+
+1C-9C-26   (hex)		Zoovel Technologies
+1C9C26     (base 16)		Zoovel Technologies
+				Paseo de la Castellana 259C
+				  Madrid  28046
+				ES
+
+04-67-85   (hex)		scemtec Hard- und Software fuer Mess- und Steuerungstechnik GmbH
+046785     (base 16)		scemtec Hard- und Software fuer Mess- und Steuerungstechnik GmbH
+				Gewerbeparkstr. 20
+				Reichshof-Wehnrath  NRW  51580
+				
+
+D0-FA-1D   (hex)		Qihoo  360  Technology Co.,Ltd
+D0FA1D     (base 16)		Qihoo  360  Technology Co.,Ltd
+				Building 2，6 Haoyuan
+				Chaoyang District  Beijing  100015
+				CN
+
+AC-11-D3   (hex)		Suzhou HOTEK  Video Technology Co. Ltd
+AC11D3     (base 16)		Suzhou HOTEK  Video Technology Co. Ltd
+				No.78,Keling Road,Suzhou National new and hi-tech industrial Development zone
+				Suzhou  Jiangsu  215200
+				CN
+
+84-32-EA   (hex)		ANHUI WANZTEN P&T CO., LTD
+8432EA     (base 16)		ANHUI WANZTEN P&T CO., LTD
+				9F Building B1 HUAYI science Park
+				Hefei  Anhui Province  230088
+				CN
+
+E0-1D-38   (hex)		Beijing HuaqinWorld Technology Co.,Ltd
+E01D38     (base 16)		Beijing HuaqinWorld Technology Co.,Ltd
+				30F,Beijing Silver Tower
+				Chao Yang Dist  Beijing  100027
+				CN
+
+E4-7F-B2   (hex)		FUJITSU LIMITED
+E47FB2     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+FC-6D-C0   (hex)		BME CORPORATION
+FC6DC0     (base 16)		BME CORPORATION
+				147-2
+				Kawagoe-shi  Saitama  350-0845
+				JP
+
+24-D1-3F   (hex)		MEXUS CO.,LTD
+24D13F     (base 16)		MEXUS CO.,LTD
+				1512, Seoulsup IT Valley,
+				Seoul  Seoul  133-822
+				KR
+
+78-24-AF   (hex)		ASUSTek COMPUTER INC.
+7824AF     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+FC-9F-E1   (hex)		CONWIN.Tech. Ltd
+FC9FE1     (base 16)		CONWIN.Tech. Ltd
+				4D,Tianxia IC Bldg,115 Yiyuan road, Nanshan District,Shenzhen,Guangdong,P.P.China
+				Shenzhen  Guangdong  518000
+				CN
+
+B8-9B-E4   (hex)		ABB Power Systems Power Generation
+B89BE4     (base 16)		ABB Power Systems Power Generation
+				29801 Euclid Ave
+				Wickliffe  Ohio  44092
+				US
+
+A8-1B-5D   (hex)		Foxtel Management Pty Ltd
+A81B5D     (base 16)		Foxtel Management Pty Ltd
+				Building 3, Level 3
+				NORTH RYDE  NSW  2113
+				AU
+
+50-50-65   (hex)		TAKT Corporation
+505065     (base 16)		TAKT Corporation
+				2762-8
+				Chino-City  Nagano-Pref.  391-0001
+				JP
+
+40-C6-2A   (hex)		Shanghai Jing Ren Electronic Technology Co., Ltd.
+40C62A     (base 16)		Shanghai Jing Ren Electronic Technology Co., Ltd.
+				GUI Qing Road 7 No. 3 building G7 software base A District 208 room
+				Xuhui District  Shanghai City  200233
+				CN
+
+E8-15-0E   (hex)		Nokia Corporation
+E8150E     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+C4-42-02   (hex)		Samsung Electronics Co.,Ltd
+C44202     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-AE-6F   (hex)		Circle Reliance, Inc DBA Cranberry Networks
+B4AE6F     (base 16)		Circle Reliance, Inc DBA Cranberry Networks
+				921 Rose Avenue
+				Menlo Park  CA  94025
+				US
+
+90-DA-6A   (hex)		FOCUS H&S Co., Ltd.
+90DA6A     (base 16)		FOCUS H&S Co., Ltd.
+				#113, Doosan Venture Digm, 126-1
+				Anyang  Gyeonggi-Do  431-755
+				KR
+
+DC-53-7C   (hex)		Compal Broadband Networks, Inc.
+DC537C     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+44-A6-E5   (hex)		THINKING TECHNOLOGY CO.,LTD
+44A6E5     (base 16)		THINKING TECHNOLOGY CO.,LTD
+				The 6th Floor,Gate No. 3 of Huaqiang Logistics Building
+				Nanshan, Shenzhen  Guangdong  518055
+				CN
+
+A4-5D-A1   (hex)		ADB Broadband Italia
+A45DA1     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO  ITALY  20126
+				
+
+0C-AC-05   (hex)		Unitend Technologies Inc.
+0CAC05     (base 16)		Unitend Technologies Inc.
+				No.6 Nanda'an Hutong, Xizhimeng st
+				Zicheng District  Beijing  100035
+				CN
+
+4C-6E-6E   (hex)		Comnect Technology CO.,LTD
+4C6E6E     (base 16)		Comnect Technology CO.,LTD
+				7-402, Xinyuan Industrial Park, No.61
+				Shenzhen  Guangdong  518055
+				CN
+
+8C-33-57   (hex)		HiteVision Digital Media Technology Co.,Ltd.
+8C3357     (base 16)		HiteVision Digital Media Technology Co.,Ltd.
+				1st building,Honghui Industrial Park,LiuXian
+				Shenzhen  Guangdong  510008
+				CN
+
+3C-AA-3F   (hex)		iKey, Ltd.
+3CAA3F     (base 16)		iKey, Ltd.
+				2621 Ridgepoint Drive
+				Austin  Texas  78754
+				US
+
+0C-38-3E   (hex)		Fanvil Technology Co., Ltd.
+0C383E     (base 16)		Fanvil Technology Co., Ltd.
+				3F, Block A, Gaoxinqi Building, Anhua Industrial Park
+				Shenzhen  Guangdong  518101
+				CN
+
+60-CD-A9   (hex)		Abloomy
+60CDA9     (base 16)		Abloomy
+				Room 501 ,CTS Building,No 1 Beishatan Chaoyang District
+				BeiJing    100083
+				CN
+
+B8-AD-3E   (hex)		BLUECOM
+B8AD3E     (base 16)		BLUECOM
+				116, Venture-ro, Yeonsu-gu,
+				Incheon    406-840
+				KR
+
+18-30-09   (hex)		Woojin Industrial Systems Co., Ltd.
+183009     (base 16)		Woojin Industrial Systems Co., Ltd.
+				95, Sari-ro, Sari-myeon
+				Goesan-gun  Chungcheongbuk-do  367-822
+				KR
+
+74-DB-D1   (hex)		Ebay Inc
+74DBD1     (base 16)		Ebay Inc
+				2211 N. First St
+				San Jose  Ca  95131
+				US
+
+30-B5-F1   (hex)		Aitexin Technology Co., Ltd
+30B5F1     (base 16)		Aitexin Technology Co., Ltd
+				1210 PDAY research center streer 2
+				Peiking    100190
+				CN
+
+B0-10-41   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+B01041     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+80-AD-67   (hex)		Kasda Networks Inc
+80AD67     (base 16)		Kasda Networks Inc
+				B-31 Building, Tanglang Industry Zone, Xili, Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+18-D5-B6   (hex)		SMG Holdings LLC
+18D5B6     (base 16)		SMG Holdings LLC
+				205 N Michigan Ave
+				Chicago  IL  60601
+				US
+
+5C-2E-59   (hex)		Samsung Electronics Co.,Ltd
+5C2E59     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-E5-39   (hex)		Moimstone Co.,Ltd
+A8E539     (base 16)		Moimstone Co.,Ltd
+				4F, 954-9 Gwanyang-dong
+				Anyang-Si  Gyeonggi-do  431-060
+				KR
+
+54-B7-53   (hex)		Hunan Fenghui Yinjia Science And Technology Co.,Ltd
+54B753     (base 16)		Hunan Fenghui Yinjia Science And Technology Co.,Ltd
+				No.15 Lutian Road
+				Changsha  Hunan  410205
+				CN
+
+10-30-47   (hex)		Samsung Electronics Co.,Ltd
+103047     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F8-84-F2   (hex)		Samsung Electronics Co.,Ltd
+F884F2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-75-4D   (hex)		Nokia
+B0754D     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+E0-CB-EE   (hex)		Samsung Electronics Co.,Ltd
+E0CBEE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+4C-39-09   (hex)		HPL Electric & Power Private Limited
+4C3909     (base 16)		HPL Electric & Power Private Limited
+				133, Pace City-1, Sec-37
+				Gurgaon  Haryana  122001
+				IN
+
+90-7E-BA   (hex)		UTEK TECHNOLOGY (SHENZHEN) CO.,LTD
+907EBA     (base 16)		UTEK TECHNOLOGY (SHENZHEN) CO.,LTD
+				6F, C Building JiaAn Industrial Zone, 72# district of Baoan, ShenZhen, China
+				SHENZHEN  Guangdong Province  518101
+				CN
+
+A0-02-DC   (hex)		Amazon Technologies Inc.
+A002DC     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+54-2A-A2   (hex)		Alpha Networks Inc.
+542AA2     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing 7th Rd., Science-based Industrial Park, Hsinchu, Taiwan, R.O.C
+				Hsinchu  Taiwan  300
+				TW
+
+84-94-8C   (hex)		Hitron Technologies. Inc
+84948C     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+A8-F7-E0   (hex)		PLANET Technology Corporation
+A8F7E0     (base 16)		PLANET Technology Corporation
+				11F, No. 96, Min Quan Road,
+				New Taipei City    22341
+				TW
+
+44-86-C1   (hex)		Siemens Low Voltage & Products
+4486C1     (base 16)		Siemens Low Voltage & Products
+				5400 Triangle Parkway
+				Norcross  GA  30092
+				US
+
+40-45-DA   (hex)		Spreadtrum Communications (Shanghai) Co., Ltd.
+4045DA     (base 16)		Spreadtrum Communications (Shanghai) Co., Ltd.
+				Building 1, Spreadtrum Center, No.2288, Zuchongzhi Rd
+				  Shanghai  201203
+				
+
+34-51-AA   (hex)		JID GLOBAL
+3451AA     (base 16)		JID GLOBAL
+				211, Biz Plus Suwon 2F Chungho Bldg, 17 363Road, Susung-ro
+				SUWON  Gyeonggi-do  440-846
+				KR
+
+98-BE-94   (hex)		IBM
+98BE94     (base 16)		IBM
+				3039 E Cornwallis Rd
+				Research Triangle Park  NC  27709
+				US
+
+6C-19-8F   (hex)		D-Link International
+6C198F     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+C8-FF-77   (hex)		Dyson Limited
+C8FF77     (base 16)		Dyson Limited
+				Tetbury Hill
+				Malmesbury  Wiltshire  SN16 0RP
+				GB
+
+B4-9E-AC   (hex)		Imagik Int'l Corp
+B49EAC     (base 16)		Imagik Int'l Corp
+				2299 SW 37 th Ave
+				Miami  Florida  33145
+				US
+
+CC-07-E4   (hex)		Lenovo Mobile Communication Technology Ltd.
+CC07E4     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information &amp; Optoelectronics Park, Torch Hi-tech Industry Development Zone, Xiamen, P.R.China
+				Xiamen  Fujian  361006
+				US
+
+C4-6B-B4   (hex)		myIDkey
+C46BB4     (base 16)		myIDkey
+				65 Enterprise
+				Aliso Viejo  CA  92656
+				US
+
+0C-63-FC   (hex)		Nanjing Signway Technology Co., Ltd
+0C63FC     (base 16)		Nanjing Signway Technology Co., Ltd
+				Rm 1001,10/F,28 Ningshuang Rd,
+				Nanjing  Jiangsu  210012
+				CN
+
+D4-E0-8E   (hex)		ValueHD Corporation
+D4E08E     (base 16)		ValueHD Corporation
+				Xinwei Xili, Nanshan District, Shenzhen City Industrial Zone, Shiling 8, 3rd Floor, North
+				Shenzhen  Guangdong  518055
+				CN
+
+C8-9F-1D   (hex)		SHENZHEN COMMUNICATION TECHNOLOGIES CO.,LTD
+C89F1D     (base 16)		SHENZHEN COMMUNICATION TECHNOLOGIES CO.,LTD
+				NO.6 QINGNING ROAD,CAIHUANG INDUSTRY PARK,
+				SHENZHEN  GUANGDONG  518109
+				CN
+
+14-3D-F2   (hex)		Beijing Shidai Hongyuan Network Communication Co.,Ltd
+143DF2     (base 16)		Beijing Shidai Hongyuan Network Communication Co.,Ltd
+				#505, 5F, Tower 3
+				  Beijing  100000
+				CN
+
+2C-39-C1   (hex)		Ciena Corporation
+2C39C1     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+54-EE-75   (hex)		Wistron InfoComm(Kunshan)Co.,Ltd.
+54EE75     (base 16)		Wistron InfoComm(Kunshan)Co.,Ltd.
+				168# First Avenue,Kunshan Integrated Free Trade Zone,Kunshan,Jiangsu,China
+				Kunshan  Jiangsu  215300
+				CN
+
+08-74-F6   (hex)		Winterhalter Gastronom GmbH
+0874F6     (base 16)		Winterhalter Gastronom GmbH
+				Tettnanger Straße 72
+				Meckenbeuren  Baden-Württemberg  88074
+				DE
+
+D8-49-2F   (hex)		CANON INC.
+D8492F     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+80-0E-24   (hex)		ForgetBox
+800E24     (base 16)		ForgetBox
+				61 rue de Sèvres
+				Ville d'Avray  IDF  92140
+				FR
+
+3C-25-D7   (hex)		Nokia Corporation
+3C25D7     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+30-A8-DB   (hex)		Sony Mobile Communications Inc
+30A8DB     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+18-FF-2E   (hex)		Shenzhen Rui Ying Da Technology Co., Ltd
+18FF2E     (base 16)		Shenzhen Rui Ying Da Technology Co., Ltd
+				KaiXinda Electronic Science and Technology Park, Zhoushi Road 49,Shiyan Street,Baoan  District,ShenZhen,China
+				shenzhen  guangdong  518108
+				CN
+
+84-72-07   (hex)		I&C Technology
+847207     (base 16)		I&C Technology
+				24,Pangyo-ro 255beon-gil, Bundang-gu, Seongnam-si, Gyeonggi-do, 463-400,Korea
+				Seongnam-si  Gyeonggi-do  463-400,Korea
+				US
+
+CC-A6-14   (hex)		AIFA TECHNOLOGY CORP.
+CCA614     (base 16)		AIFA TECHNOLOGY CORP.
+				1F., No.230, Sec. 2, Bade Rd., Fongshan Dist.
+				Kaohsiung City  Taiwan  83053
+				TW
+
+90-F1-B0   (hex)		Hangzhou Anheng Info&Tech CO.,LTD
+90F1B0     (base 16)		Hangzhou Anheng Info&Tech CO.,LTD
+				15F Zhongcai Bldg,#68 Tonghe Rd
+				Hangzhou  Zhejiang  310051
+				CN
+
+4C-8B-30   (hex)		Actiontec Electronics, Inc
+4C8B30     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+08-05-CD   (hex)		DongGuang EnMai Electronic Product Co.Ltd.
+0805CD     (base 16)		DongGuang EnMai Electronic Product Co.Ltd.
+				701 7th Floor,YiFeng Building,
+				DongGuang  GuangDong Province  523843
+				CN
+
+54-D1-63   (hex)		MAX-TECH,INC
+54D163     (base 16)		MAX-TECH,INC
+				2F, 26, 2gil, Dujeonggongdan
+				Cheonan  Chungnam  331957
+				KR
+
+48-B5-A7   (hex)		Glory Horse Industries Ltd.
+48B5A7     (base 16)		Glory Horse Industries Ltd.
+				Woekshop 8, 4/F., World Wide Industrial Centre,
+				Shatin, N.T.    HKG
+				HK
+
+0C-4F-5A   (hex)		ASA-RT s.r.l.
+0C4F5A     (base 16)		ASA-RT s.r.l.
+				Strada del Lionetto 16/a
+				Torino  To  10146
+				IT
+
+D4-22-4E   (hex)		Alcatel Lucent
+D4224E     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+9C-86-DA   (hex)		Phoenix Geophysics Ltd.
+9C86DA     (base 16)		Phoenix Geophysics Ltd.
+				3781 Victoria Park Ave.
+				Toronto  ON  M1W 3K5
+				CA
+
+2C-07-3C   (hex)		DEVLINE LIMITED
+2C073C     (base 16)		DEVLINE LIMITED
+				FLAT/RM A9,9/F SILVERCORP INT TOWER
+				  HONGKONG  999077
+				CN
+
+7C-1A-03   (hex)		8Locations Co., Ltd.
+7C1A03     (base 16)		8Locations Co., Ltd.
+				1F, No. 123, Chenggong 2rd Street
+				Zhube City  Hsinchu  302
+				TW
+
+AC-B8-59   (hex)		Uniband Electronic Corp,
+ACB859     (base 16)		Uniband Electronic Corp,
+				6F-1 No. Dongguang Rd.,
+				Hsinchu  300  300
+				TW
+
+2C-9A-A4   (hex)		Eolo SpA
+2C9AA4     (base 16)		Eolo SpA
+				via Gran San Bernardo 12
+				Busto Arsizio  VA  21052
+				IT
+
+88-B1-E1   (hex)		 Mojo Networks, Inc.
+88B1E1     (base 16)		 Mojo Networks, Inc.
+				339 N.Bernardo Ave
+				Mountain View  CA  94043
+				US
+
+90-DB-46   (hex)		E-LEAD ELECTRONIC CO., LTD
+90DB46     (base 16)		E-LEAD ELECTRONIC CO., LTD
+				NO.37, GUNGDUNG 1ST RD.
+				SHENGANG SHIANG  CHANGHUA  50971
+				TW
+
+34-4F-5C   (hex)		R&amp;M AG
+344F5C     (base 16)		R&amp;M AG
+				Binzstrasse 32
+				Wetzikon  Zurich  8620
+				CH
+
+60-47-D4   (hex)		FORICS Electronic Technology Co., Ltd.
+6047D4     (base 16)		FORICS Electronic Technology Co., Ltd.
+				BLD 2A, No 1588, Lianhang Rd
+				  Shanghai  201112
+				CN
+
+FC-F8-B7   (hex)		TRONTEQ Electronic
+FCF8B7     (base 16)		TRONTEQ Electronic
+				Siemensstrasse 22
+				Reutlingen  Baden Wuerttemberg  72766
+				DE
+
+30-F4-2F   (hex)		ESP
+30F42F     (base 16)		ESP
+				126-1 Pyeongchon-dong, Dongan-gu
+				Anyang-si  Gyeonggi-do  431-755
+				KR
+
+70-4E-01   (hex)		KWANGWON TECH CO., LTD.
+704E01     (base 16)		KWANGWON TECH CO., LTD.
+				D-401, Digital-Empire Bldg., 980-3
+				Suwon  Gyeonggi-Do  443-702
+				KR
+
+74-6A-8F   (hex)		VS Vision Systems GmbH
+746A8F     (base 16)		VS Vision Systems GmbH
+				Aspelohe 27A
+				Norderstedt  Schleswig-Holstein  22848
+				DE
+
+54-A3-1B   (hex)		Shenzhen Linkworld Technology Co,.LTD
+54A31B     (base 16)		Shenzhen Linkworld Technology Co,.LTD
+				Room 667-675 , sixth floor ,
+				Shenzhen  Guangdong  518055
+				CN
+
+CC-39-8C   (hex)		Shiningtek
+CC398C     (base 16)		Shiningtek
+				No. 53, Nankeng 3 St
+				  Hsinchu  30841
+				TW
+
+18-20-A6   (hex)		Sage Co., Ltd.
+1820A6     (base 16)		Sage Co., Ltd.
+				2-24 Sumiyoshicho, Naka-ku
+				Yokohama-shi  Kanagawa  231-0013
+				JP
+
+20-EA-C7   (hex)		SHENZHEN RIOPINE ELECTRONICS CO., LTD
+20EAC7     (base 16)		SHENZHEN RIOPINE ELECTRONICS CO., LTD
+				ROOM1002~1004, BaoYuan HuaFeng Headquarters' Business Building, Xixiang Avenue (west) , Bao'an District
+				Shenzhen  Guangdong  518000
+				CN
+
+64-B3-70   (hex)		PowerComm Solutions LLC
+64B370     (base 16)		PowerComm Solutions LLC
+				15 Minneakoning Rd. Suite 311
+				Flemington  NJ  08822
+				US
+
+5C-F5-0D   (hex)		Institute of microelectronic applications
+5CF50D     (base 16)		Institute of microelectronic applications
+				Na Valentince 1003/1
+				Praha    15000
+				CZ
+
+74-9C-52   (hex)		Huizhou Desay SV Automotive Co., Ltd.
+749C52     (base 16)		Huizhou Desay SV Automotive Co., Ltd.
+				103, Hechang 5th Road West,
+				Huizhou  Guangdong  516006
+				CN
+
+C4-29-1D   (hex)		KLEMSAN ELEKTRIK ELEKTRONIK SAN.VE TIC.AS.
+C4291D     (base 16)		KLEMSAN ELEKTRIK ELEKTRONIK SAN.VE TIC.AS.
+				kemalpaşa yolu 3.km KEMALPASA 35170
+				izmir  TÜRKİYE --  35170
+				TR
+
+6C-5F-1C   (hex)		Lenovo Mobile Communication Technology Ltd.
+6C5F1C     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				 No.999, Qishan North 2nd Road,
+				Xiamen  361000  Fujian
+				US
+
+7C-E4-AA   (hex)		Private
+7CE4AA     (base 16)		Private
+
+08-3F-3E   (hex)		WSH GmbH
+083F3E     (base 16)		WSH GmbH
+				Koelner Str. 58a
+				Gummersbach  NRW  51645
+				DE
+
+2C-95-7F   (hex)		zte corporation
+2C957F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+3C-0C-48   (hex)		Servergy, Inc.
+3C0C48     (base 16)		Servergy, Inc.
+				1700 N. Redbud
+				McKinney  TEXAS  75069
+				US
+
+10-DE-E4   (hex)		automationNEXT GmbH
+10DEE4     (base 16)		automationNEXT GmbH
+				Millennium Park 4
+				Lustenau  Vorarlberg  6890
+				AT
+
+F0-3A-4B   (hex)		Bloombase, Inc.
+F03A4B     (base 16)		Bloombase, Inc.
+				955 Benecia Ave
+				Sunnyvale  California  94085
+				US
+
+A0-E4-53   (hex)		Sony Mobile Communications Inc
+A0E453     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+40-4A-18   (hex)		Addrek Smart Solutions
+404A18     (base 16)		Addrek Smart Solutions
+				Al Gharrafa Thani Bin Jassim St
+				Doha    
+				QA
+
+C0-C5-69   (hex)		SHANGHAI LYNUC CNC TECHNOLOGY CO.,LTD
+C0C569     (base 16)		SHANGHAI LYNUC CNC TECHNOLOGY CO.,LTD
+				Building 3,No.25 Cangwu Rd
+				  Shanghai  200233
+				CN
+
+C4-C0-AE   (hex)		MIDORI ELECTRONIC CO., LTD.
+C4C0AE     (base 16)		MIDORI ELECTRONIC CO., LTD.
+				397
+				Chikuma  Nagano  389-0804
+				JP
+
+AC-C5-95   (hex)		Graphite Systems
+ACC595     (base 16)		Graphite Systems
+				2037 Landings Drive
+				Mountain View  California  94043
+				US
+
+7C-E1-FF   (hex)		Computer Performance, Inc. DBA Digital Loggers, Inc.
+7CE1FF     (base 16)		Computer Performance, Inc. DBA Digital Loggers, Inc.
+				2695 Walsh Avenue
+				Santa Clara  CA  95051
+				US
+
+D8-15-0D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D8150D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+58-50-AB   (hex)		TLS Corporation
+5850AB     (base 16)		TLS Corporation
+				1241 Superior Ave.
+				Cleveland  OH  44114
+				US
+
+7C-CD-11   (hex)		MS-Magnet
+7CCD11     (base 16)		MS-Magnet
+				Parchevich 42
+				  Sofia  1000
+				BG
+
+98-FF-6A   (hex)		OTEC(Shanghai)Technology Co.,Ltd.
+98FF6A     (base 16)		OTEC(Shanghai)Technology Co.,Ltd.
+				13th Floor,Building 2
+				  Shanghai  200235
+				CN
+
+BC-1A-67   (hex)		YF Technology Co., Ltd
+BC1A67     (base 16)		YF Technology Co., Ltd
+				No.62,South Fumin Road,
+				Dongguang  Guangdong  523773
+				CN
+
+4C-D7-B6   (hex)		Helmer Scientific
+4CD7B6     (base 16)		Helmer Scientific
+				14400 Bergen Boulevard
+				Noblesville  Indiana  46060
+				US
+
+84-25-A4   (hex)		Tariox Limited
+8425A4     (base 16)		Tariox Limited
+				173 Highway 53
+				Cathcart  Ontario  N0E 1B0
+				CA
+
+48-3D-32   (hex)		Syscor Controls &amp; Automation
+483D32     (base 16)		Syscor Controls &amp; Automation
+				201-60 Bastion Sq
+				Victoria  BC  V8W 1J2
+				CA
+
+CC-85-6C   (hex)		SHENZHEN MDK DIGITAL TECHNOLOGY CO.,LTD
+CC856C     (base 16)		SHENZHEN MDK DIGITAL TECHNOLOGY CO.,LTD
+				Xin fengze industrial park,shangnan east road
+				SHENZHEN  GUANGDONG  518101
+				CN
+
+AC-6B-AC   (hex)		Jenny Science AG
+AC6BAC     (base 16)		Jenny Science AG
+				Sandblatte 7a
+				Rain  Luzern  6026
+				CH
+
+D8-EE-78   (hex)		Moog Protokraft
+D8EE78     (base 16)		Moog Protokraft
+				4545 W Stone Dr Bldg 135
+				Kingsport  TN  37660
+				US
+
+24-11-48   (hex)		Entropix, LLC
+241148     (base 16)		Entropix, LLC
+				100 Rawson Road
+				Victor  New York  14564
+				US
+
+C4-45-EC   (hex)		Shanghai Yali Electron Co.,LTD
+C445EC     (base 16)		Shanghai Yali Electron Co.,LTD
+				Room 1-607
+				Shanghai  Shanghai  201100
+				US
+
+E0-E6-31   (hex)		SNB TECHNOLOGIES LIMITED
+E0E631     (base 16)		SNB TECHNOLOGIES LIMITED
+				Rm 303, Building #13,
+				Long Gang district, ShenZhen  GuangDong  518000
+				CN
+
+78-B5-D2   (hex)		Ever Treasure Industrial Limited
+78B5D2     (base 16)		Ever Treasure Industrial Limited
+				15A Tung Lee Commercial Building
+				Sheung Wan    852
+				HK
+
+50-ED-78   (hex)		Changzhou Yongse Infotech Co.,Ltd
+50ED78     (base 16)		Changzhou Yongse Infotech Co.,Ltd
+				No.128 Zhengzhong Rd, Xixiashua Town
+				Changzhou  Jiangsu  213135
+				CN
+
+90-02-8A   (hex)		Shenzhen Shidean Legrand Electronic Products Co.,Ltd
+90028A     (base 16)		Shenzhen Shidean Legrand Electronic Products Co.,Ltd
+				Block39,Shahe Industrial Zone Baishizhou
+				  Guangdong  518053
+				CN
+
+1C-C1-1A   (hex)		Wavetronix
+1CC11A     (base 16)		Wavetronix
+				78 East 1700 South
+				Provo  UT  84606
+				US
+
+FC-09-D8   (hex)		ACTEON Group
+FC09D8     (base 16)		ACTEON Group
+				ZAC Athelia IV
+				La Ciotat  France  13705
+				FR
+
+74-3E-CB   (hex)		Gentrice tech
+743ECB     (base 16)		Gentrice tech
+				15F No.738-5 JhengJhong Rd
+				New Taipei city    235
+				TW
+
+7C-44-4C   (hex)		Entertainment Solutions, S.L.
+7C444C     (base 16)		Entertainment Solutions, S.L.
+				Parque Empresarial Miraflores, nave 3
+				  Zaragoza  50720
+				ES
+
+04-44-A1   (hex)		TELECON GALICIA,S.A.
+0444A1     (base 16)		TELECON GALICIA,S.A.
+				AVENIDA DE NOSTIAN
+				A CORUNA 15008     
+				ES
+
+20-C6-0D   (hex)		Shanghai annijie Information technology Co.,LTD
+20C60D     (base 16)		Shanghai annijie Information technology Co.,LTD
+				Room605,NO.9,Lane 777
+				Shanghai    200070
+				CN
+
+38-CA-97   (hex)		Contour Design LLC
+38CA97     (base 16)		Contour Design LLC
+				10 Industrial Drive
+				Windham  NH  03087
+				US
+
+BC-2D-98   (hex)		ThinGlobal LLC
+BC2D98     (base 16)		ThinGlobal LLC
+				703 wildflower RD
+				Davenport  FL  33837
+				US
+
+18-79-A2   (hex)		GMJ ELECTRIC LIMITED
+1879A2     (base 16)		GMJ ELECTRIC LIMITED
+				RM 1405, 14/F, C C WU BUILDING
+				    999077
+				HK
+
+E0-C8-6A   (hex)		SHENZHEN TW-SCIE Co., Ltd
+E0C86A     (base 16)		SHENZHEN TW-SCIE Co., Ltd
+				816# DongMing Building MinKang Road
+				Shenzhen  Guangdong  518000
+				CN
+
+BC-EE-7B   (hex)		ASUSTek COMPUTER INC.
+BCEE7B     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+34-13-A8   (hex)		Mediplan Limited
+3413A8     (base 16)		Mediplan Limited
+				245 Sheffield Road
+				Sheffield  South Yorkshire  S13 9ZD
+				GB
+
+7C-97-63   (hex)		Openmatics s.r.o.
+7C9763     (base 16)		Openmatics s.r.o.
+				Poděbradova 2842/1
+				Pilsen  Tschechien  30100
+				CZ
+
+48-A2-B7   (hex)		Kodofon JSC
+48A2B7     (base 16)		Kodofon JSC
+				97 Moskovskyi pr.
+				Voronezh    394077
+				RU
+
+CC-74-98   (hex)		Filmetrics Inc.
+CC7498     (base 16)		Filmetrics Inc.
+				3560 Dunhill Street, #100
+				San Diego  CA  92121
+				US
+
+08-5A-E0   (hex)		Recovision Technology Co., Ltd.
+085AE0     (base 16)		Recovision Technology Co., Ltd.
+				1709，No.5 Wanghai Road,
+				Xiamen  Fujian  361006
+				CN
+
+20-E7-91   (hex)		Siemens Healthcare Diagnostics, Inc
+20E791     (base 16)		Siemens Healthcare Diagnostics, Inc
+				2 Edgewater Drive
+				Norwood  MA  02062
+				US
+
+08-97-58   (hex)		Shenzhen Strong Rising Electronics Co.,Ltd DongGuan Subsidiary
+089758     (base 16)		Shenzhen Strong Rising Electronics Co.,Ltd DongGuan Subsidiary
+				QingPing Road 2,Qinghutou village
+				DongGuan  GuangDong  523711
+				CN
+
+FC-19-D0   (hex)		Cloud Vision Networks Technology Co.,Ltd.
+FC19D0     (base 16)		Cloud Vision Networks Technology Co.,Ltd.
+				F/9,Hechuan Building 2016
+				Shanghai    201103
+				CN
+
+94-86-D4   (hex)		Surveillance Pro Corporation
+9486D4     (base 16)		Surveillance Pro Corporation
+				12F., No.4, Ln. 609, Sec. 5, Chongxin Rd., Sanchong Dist.
+				New Taipei City    241
+				US
+
+9C-D6-43   (hex)		D-Link International
+9CD643     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+3C-18-A0   (hex)		Luxshare Precision Industry Company Limited
+3C18A0     (base 16)		Luxshare Precision Industry Company Limited
+				Floor 2, Block A, Sanyo New Industrial Area
+				West Haoyi Community, Shajing Subdistrict Office  Bao'an District, Shenzhen, Guangdong  523000
+				CN
+
+8C-AE-89   (hex)		Y-cam Solutions Ltd
+8CAE89     (base 16)		Y-cam Solutions Ltd
+				3 dee road
+				Richmond  Surrey  TW9 2JN
+				GB
+
+94-E9-8C   (hex)		Nokia
+94E98C     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+FC-E1-D9   (hex)		Stable Imaging Solutions LLC
+FCE1D9     (base 16)		Stable Imaging Solutions LLC
+				3709 Old Conejo Rd
+				Newbury Park  CA  91320
+				US
+
+50-20-6B   (hex)		Emerson Climate Technologies Transportation Solutions
+50206B     (base 16)		Emerson Climate Technologies Transportation Solutions
+				Axel Kiers Vej  5A
+				Hoejbjerg    8270
+				DK
+
+7C-BF-88   (hex)		Mobilicom LTD
+7CBF88     (base 16)		Mobilicom LTD
+				Hametzoda 31
+				Azor    5800174
+				IL
+
+60-DB-2A   (hex)		HNS
+60DB2A     (base 16)		HNS
+				345-50, Gasan-dong, Geumcheon-gu, Seoul, Korea[153-707]
+				Seoul  The Seoul Metropolis  82
+				KR
+
+B0-45-45   (hex)		YACOUB Automation GmbH
+B04545     (base 16)		YACOUB Automation GmbH
+				Gustav Meyer Allee 25
+				Berlin    13355
+				DE
+
+C8-EE-75   (hex)		Pishion International Co. Ltd
+C8EE75     (base 16)		Pishion International Co. Ltd
+				3F,NO,15-2,Beihuan Rd
+				Taichung City    42760
+				TW
+
+CC-34-29   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+CC3429     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+64-BA-BD   (hex)		SDJ Technologies, Inc.
+64BABD     (base 16)		SDJ Technologies, Inc.
+				2125-B Madera Road
+				Simi Valley  CA  93065
+				US
+
+24-C8-48   (hex)		mywerk Portal GmbH
+24C848     (base 16)		mywerk Portal GmbH
+				Fabrikstr. 3
+				Gronau     48599 
+				DE
+
+CC-FB-65   (hex)		Nintendo Co., Ltd.
+CCFB65     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+A0-A2-3C   (hex)		GPMS
+A0A23C     (base 16)		GPMS
+				40 Ridge Rd
+				Cornwall  VT  05753
+				US
+
+68-FC-B3   (hex)		Next Level Security Systems, Inc.
+68FCB3     (base 16)		Next Level Security Systems, Inc.
+				6353 Corte Del Abeto
+				Carlsbad  CA  92011
+				US
+
+94-C3-E4   (hex)		Atlas Copco IAS GmbH
+94C3E4     (base 16)		Atlas Copco IAS GmbH
+				Gewerbestr. 52
+				Bretten-Goelshausen    75015
+				DE
+
+34-88-5D   (hex)		Logitech Far East
+34885D     (base 16)		Logitech Far East
+				#2 Creation Rd. 4,
+				Hsinchu    300
+				TW
+
+88-57-6D   (hex)		XTA Electronics Ltd
+88576D     (base 16)		XTA Electronics Ltd
+				The Design House
+				Stourport-on-Severn  Worcestershire  DY13 9BZ
+				GB
+
+BC-41-00   (hex)		CODACO ELECTRONIC s.r.o.
+BC4100     (base 16)		CODACO ELECTRONIC s.r.o.
+				Hemy 825
+				Valasske Mezirici    75701
+				CZ
+
+FC-D8-17   (hex)		Beijing Hesun Technologies Co.Ltd.
+FCD817     (base 16)		Beijing Hesun Technologies Co.Ltd.
+				Room 1811, 18th floor, Building No. 4, Courtyard 1, Shangdi tenth Street
+				  Beijing  100085
+				CN
+
+68-2D-DC   (hex)		Wuhan Changjiang Electro-Communication Equipment CO.,LTD
+682DDC     (base 16)		Wuhan Changjiang Electro-Communication Equipment CO.,LTD
+				No.8,Yinghu Sience&Technology industrial park
+				Wuhan  Hubei  430040
+				CN
+
+E8-61-1F   (hex)		Dawning Information Industry Co.,Ltd
+E8611F     (base 16)		Dawning Information Industry Co.,Ltd
+				NO.15 Huake Street,Hi-Tech Zone
+				   Tianjin  300384
+				CN
+
+28-47-AA   (hex)		Nokia Corporation
+2847AA     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+5C-D6-1F   (hex)		Qardio, Inc
+5CD61F     (base 16)		Qardio, Inc
+				340 S Lemon Ave #1104F
+				Walnut  California  91789
+				US
+
+70-59-57   (hex)		Medallion Instrumentation Systems
+705957     (base 16)		Medallion Instrumentation Systems
+				17150 Hickory St
+				Spring Lake  MI  49456
+				US
+
+9C-44-3D   (hex)		CHENGDU XUGUANG TECHNOLOGY CO, LTD
+9C443D     (base 16)		CHENGDU XUGUANG TECHNOLOGY CO, LTD
+				2ND SECTION,PARK ROAD
+				CHENGDU  SICHUAN  610100
+				CN
+
+B4-24-E7   (hex)		Codetek Technology Co.,Ltd
+B424E7     (base 16)		Codetek Technology Co.,Ltd
+				4F.-1, No.55, Dongguang Rd., East Dist.,
+				Hsinchu City    300
+				TW
+
+54-2F-89   (hex)		Euclid Laboratories, Inc.
+542F89     (base 16)		Euclid Laboratories, Inc.
+				9151 Arvida Ln
+				Coral Gables  Florida  33156
+				US
+
+90-99-16   (hex)		ELVEES NeoTek OJSC
+909916     (base 16)		ELVEES NeoTek OJSC
+				Proezd 4922, dom 4, stroenie 2
+				Moscow  Zelenograd  124498
+				RU
+
+00-A2-FF   (hex)		abatec group AG
+00A2FF     (base 16)		abatec group AG
+				Oberregauerstraße 48
+				Regau    4844
+				AT
+
+60-24-C1   (hex)		Jiangsu Zhongxun Electronic Technology Co., Ltd
+6024C1     (base 16)		Jiangsu Zhongxun Electronic Technology Co., Ltd
+				tangshu road #8
+				yixing  jiangsu  214221
+				CN
+
+A0-14-3D   (hex)		PARROT SA
+A0143D     (base 16)		PARROT SA
+				174 Quai de Jemmapes
+				Paris    75010
+				FR
+
+FC-1B-FF   (hex)		V-ZUG AG
+FC1BFF     (base 16)		V-ZUG AG
+				Industriestrasse 66
+				  Zug  6301
+				CH
+
+F4-28-96   (hex)		SPECTO PAINEIS ELETRONICOS LTDA
+F42896     (base 16)		SPECTO PAINEIS ELETRONICOS LTDA
+				RUA WALTER JOSE CORREA, AREA 12
+				SAO JOSE  SANTA CATARINA  88122-035
+				BR
+
+78-CB-33   (hex)		DHC Software Co.,Ltd
+78CB33     (base 16)		DHC Software Co.,Ltd
+				16/F,DHC Mansion No.3 Zijin
+				Beijing    100190
+				CN
+
+60-A9-B0   (hex)		Merchandising Technologies, Inc
+60A9B0     (base 16)		Merchandising Technologies, Inc
+				1050 NW 229th Avenue
+				HIllsboro  OR  97124
+				US
+
+50-27-C7   (hex)		TECHNART Co.,Ltd
+5027C7     (base 16)		TECHNART Co.,Ltd
+				2-21 Nishiohjicho
+				Kusatsu  Shiga  525-0037
+				JP
+
+6C-5A-B5   (hex)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+6C5AB5     (base 16)		TCL Technoly Electronics (Huizhou) Co., Ltd.
+				19th Zhongkai Hi-tech Development Zone
+				Huizhou  Guangdong  516006
+				CN
+
+38-5A-A8   (hex)		Beijing Zhongdun Security Technology Development Co.
+385AA8     (base 16)		Beijing Zhongdun Security Technology Development Co.
+				No.1 Capital Gymnasium South Road
+				  Beijing  100048
+				CN
+
+F4-A2-94   (hex)		EAGLE WORLD DEVELOPMENT CO., LIMITED
+F4A294     (base 16)		EAGLE WORLD DEVELOPMENT CO., LIMITED
+				1F, CMA Bldg., 64 Connaught Road Central
+				  Hong Kong  00852
+				HK
+
+EC-3E-09   (hex)		PERFORMANCE DESIGNED PRODUCTS, LLC
+EC3E09     (base 16)		PERFORMANCE DESIGNED PRODUCTS, LLC
+				14144 Ventura Blvd
+				Sherman Oaks  California  91423
+				US
+
+94-7C-3E   (hex)		Polewall Norge AS
+947C3E     (base 16)		Polewall Norge AS
+				Vige Havnevei 78
+				Kristiansand  Vest-Agder  4633
+				NO
+
+34-A3-BF   (hex)		Terewave. Inc.
+34A3BF     (base 16)		Terewave. Inc.
+				Room 217, Ssangyong Research Center
+				Yuseong-gu  Daejeon-city  305804
+				KR
+
+8C-08-8B   (hex)		Remote Solution
+8C088B     (base 16)		Remote Solution
+				92, Chogokri, Nammyun
+				Kimcheon city  Kyungbuk  740-871
+				KR
+
+B4-3E-3B   (hex)		Viableware, Inc
+B43E3B     (base 16)		Viableware, Inc
+				12220 113th Ave NE
+				Kirkland  WA  98034
+				US
+
+0C-5C-D8   (hex)		DOLI Elektronik GmbH
+0C5CD8     (base 16)		DOLI Elektronik GmbH
+				Adi-Maislinger-Str. 7
+				Munich    81373
+				DE
+
+3C-15-EA   (hex)		TESCOM CO., LTD.
+3C15EA     (base 16)		TESCOM CO., LTD.
+				#928 UTV, 1141-2 Baeksuk Ilsandong
+				Goyang  Gyeonggi  410-722
+				KR
+
+E8-04-10   (hex)		Private
+E80410     (base 16)		Private
+
+F4-BD-7C   (hex)		Chengdu jinshi communication Co., LTD
+F4BD7C     (base 16)		Chengdu jinshi communication Co., LTD
+				No. 108 #1-2-505, Eastern 5 Section, First Ring Road, JinJiang District,
+				Chengdu  Chongqing  610000
+				CN
+
+DC-C4-22   (hex)		Systembase Limited
+DCC422     (base 16)		Systembase Limited
+				Jupes Field House, Pettridge Lane
+				Warminster  Wiltshire  BA12 6DG
+				GB
+
+C8-F3-6B   (hex)		Yamato Scale Co.,Ltd.
+C8F36B     (base 16)		Yamato Scale Co.,Ltd.
+				5-22
+				Akashi  Hyogo  673-8688
+				JP
+
+98-F8-C1   (hex)		IDT Technology Limited
+98F8C1     (base 16)		IDT Technology Limited
+				Block C, 9/F.,Kaiser Estate, Phase 1,
+				Kowloon  Hong Kong  
+				HK
+
+6C-D1-B0   (hex)		WING SING ELECTRONICS HONG KONG LIMITED
+6CD1B0     (base 16)		WING SING ELECTRONICS HONG KONG LIMITED
+				No. 1, Guoyuan Industrial Zone
+				Guangzhou  Guang Dong  510385
+				CN
+
+A4-F5-22   (hex)		CHOFU SEISAKUSHO CO.,LTD
+A4F522     (base 16)		CHOFU SEISAKUSHO CO.,LTD
+				2-1
+				Shimonoseki-shi  Yamaguchi  752-8555
+				JP
+
+84-5C-93   (hex)		Chabrier Services
+845C93     (base 16)		Chabrier Services
+				354 Chemin de la Pinatte
+				Saint-Peray    07130
+				FR
+
+68-E1-66   (hex)		Private
+68E166     (base 16)		Private
+
+BC-2B-D7   (hex)		Revogi Innovation Co., Ltd.
+BC2BD7     (base 16)		Revogi Innovation Co., Ltd.
+				2018, Anhui Building, No. 6007,
+				Shenzhen,  Guangdong  518113
+				CN
+
+28-6D-97   (hex)		SAMJIN Co., Ltd.
+286D97     (base 16)		SAMJIN Co., Ltd.
+				199-6, Anyang 7-dong, Manan-gu
+				Anyang-si  Gyeonggi-do  430-817
+				KR
+
+24-EC-D6   (hex)		CSG Science & Technology Co.,Ltd.Hefei
+24ECD6     (base 16)		CSG Science & Technology Co.,Ltd.Hefei
+				No.612-1,Huangshan Road,Gaoxin District
+				Hefei  Anhui Province  230088
+				CN
+
+CC-2A-80   (hex)		Micro-Biz intelligence solutions Co.,Ltd
+CC2A80     (base 16)		Micro-Biz intelligence solutions Co.,Ltd
+				Room 611,Sunshine Building
+				Zhuhai City  Guangdong Province  519000
+				CN
+
+60-FE-F9   (hex)		Thomas & Betts
+60FEF9     (base 16)		Thomas & Betts
+				5900 Eastport Blvd
+				Richmond  VA  23231
+				US
+
+B8-DC-87   (hex)		IAI Corporation
+B8DC87     (base 16)		IAI Corporation
+				577-1 Obane
+				Shizuoka-City  Shizuoka  424-0103
+				JP
+
+7C-6F-F8   (hex)		ShenZhen ACTO Digital Video Technology Co.,Ltd.
+7C6FF8     (base 16)		ShenZhen ACTO Digital Video Technology Co.,Ltd.
+				3/F,Building 7,Software Park
+				ShenZhen  GuangDong  518055
+				CN
+
+DC-F7-55   (hex)		SITRONIK
+DCF755     (base 16)		SITRONIK
+				22 MARISCHAL GARDENS
+				ABERDEEN  ABERDEENSHIRE  AB21 9BY
+				GB
+
+5C-02-6A   (hex)		Applied Vision Corporation
+5C026A     (base 16)		Applied Vision Corporation
+				2020 Vision Lane
+				Cuyahoga Falls  OH  44223
+				US
+
+0C-93-01   (hex)		PT. Prasimax Inovasi Teknologi
+0C9301     (base 16)		PT. Prasimax Inovasi Teknologi
+				Jl. Margonda Raya 494D
+				Depok  Jawa Barat  16424
+				ID
+
+74-66-30   (hex)		T:mi Ytti
+746630     (base 16)		T:mi Ytti
+				Messitytonkatu 8 C 39
+				Helsinki  n/a  00180
+				FI
+
+6C-B3-50   (hex)		Anhui comhigher tech co.,ltd
+6CB350     (base 16)		Anhui comhigher tech co.,ltd
+				B6,717 Zhongshan South Road
+				Wuhu  Anhui  241000
+				CN
+
+38-59-F8   (hex)		MindMade Sp. z o.o.
+3859F8     (base 16)		MindMade Sp. z o.o.
+				Sniadeckich 10
+				Warsaw    00-656
+				PL
+
+4C-DF-3D   (hex)		TEAM ENGINEERS ADVANCE TECHNOLOGIES INDIA PVT LTD
+4CDF3D     (base 16)		TEAM ENGINEERS ADVANCE TECHNOLOGIES INDIA PVT LTD
+				A-1/2/A,IDA UPPAL,
+				HYDERABAD  AP  500039
+				IN
+
+E8-92-18   (hex)		Arcontia International AB
+E89218     (base 16)		Arcontia International AB
+				Gruvgatan 35A
+				Vastra Frolunda    421 30
+				SE
+
+00-75-E1   (hex)		Ampt, LLC
+0075E1     (base 16)		Ampt, LLC
+				4850 Innovation Drive
+				Fort Collins  Colorado  80525
+				US
+
+D4-6A-91   (hex)		Snap AV
+D46A91     (base 16)		Snap AV
+				1800 Continental Blvd
+				Charlotte  North Carolina  28273
+				US
+
+98-CD-B4   (hex)		Virident Systems, Inc.
+98CDB4     (base 16)		Virident Systems, Inc.
+				500 Yosemite Dr.
+				Milpitas  CA  95035
+				US
+
+A4-23-05   (hex)		Open Networking Laboratory
+A42305     (base 16)		Open Networking Laboratory
+				1000 El Camino Real
+				Menlo Park  CA  94025
+				US
+
+1C-48-F9   (hex)		GN Netcom A/S
+1C48F9     (base 16)		GN Netcom A/S
+				Lautrupbjerg 7
+				Ballerup  Ballerup  DK-2750
+				DK
+
+B0-FE-BD   (hex)		Private
+B0FEBD     (base 16)		Private
+
+60-69-9B   (hex)		isepos GmbH
+60699B     (base 16)		isepos GmbH
+				Wannweiler Str. 12
+				Kirchentellinsfurt    72138
+				US
+
+D4-D5-0D   (hex)		Southwest Microwave, Inc
+D4D50D     (base 16)		Southwest Microwave, Inc
+				9055 S McKemy St
+				Tempe  AZ  85284
+				US
+
+34-CD-6D   (hex)		CommSky Technologies
+34CD6D     (base 16)		CommSky Technologies
+				4655 Old Ironsides Dr
+				Santa Clara  CA  95054
+				US
+
+E4-F3-E3   (hex)		Shanghai iComhome Co.,Ltd.
+E4F3E3     (base 16)		Shanghai iComhome Co.,Ltd.
+				Small second floor of No.773 Siping Road
+				  Shanghai  200092
+				CN
+
+90-46-B7   (hex)		Vadaro Pte Ltd
+9046B7     (base 16)		Vadaro Pte Ltd
+				71 Ayer Rajah Crescent
+				    139951
+				SG
+
+04-CF-25   (hex)		MANYCOLORS, INC.
+04CF25     (base 16)		MANYCOLORS, INC.
+				3F, 4-1-18 Jinnoharu
+				Kitakyushu  Fukuoka  8070821
+				JP
+
+80-BB-EB   (hex)		Satmap Systems Ltd
+80BBEB     (base 16)		Satmap Systems Ltd
+				4 Fountain House
+				Leatherhead  Surrey  KT22 7LX
+				GB
+
+00-B7-8D   (hex)		Nanjing Shining Electric Automation Co., Ltd
+00B78D     (base 16)		Nanjing Shining Electric Automation Co., Ltd
+				NO.699,Laiyinda Road
+				Nanjing  Jiangsu  211100
+				CN
+
+60-FE-1E   (hex)		China Palms Telecom.Ltd
+60FE1E     (base 16)		China Palms Telecom.Ltd
+				2nd Floor of Building 1
+				PuDong District  Shanghai  201203
+				US
+
+B0-50-BC   (hex)		SHENZHEN BASICOM ELECTRONIC CO.,LTD.
+B050BC     (base 16)		SHENZHEN BASICOM ELECTRONIC CO.,LTD.
+				Basicom industry park, Baolong Avenue 3rd Road, Baolong industry town
+				Shenzhen  Guangdong  518116
+				CN
+
+84-1E-26   (hex)		KERNEL-I Co.,LTD
+841E26     (base 16)		KERNEL-I Co.,LTD
+				#606,ACE Techno Tower 10,470-5
+				Gasan-Dong, Geumcheon-gu, Seoul  Korea  153-789
+				KR
+
+B4-34-6C   (hex)		MATSUNICHI DIGITAL TECHNOLOGY (HONG KONG) LIMITED
+B4346C     (base 16)		MATSUNICHI DIGITAL TECHNOLOGY (HONG KONG) LIMITED
+				22/F. TWO INTERNATIONAL FINANCE CTR
+				Hong Kong  Hong Kong  999077
+				HK
+
+00-86-A0   (hex)		Private
+0086A0     (base 16)		Private
+
+A0-5B-21   (hex)		ENVINET GmbH
+A05B21     (base 16)		ENVINET GmbH
+				Hans-Pinsel-Str. 4
+				Haar    85540
+				DE
+
+50-B8-A2   (hex)		ImTech Technologies LLC,
+50B8A2     (base 16)		ImTech Technologies LLC,
+				2101 NE Jack London St
+				Corvallis  Oregon  97330
+				US
+
+B0-4C-05   (hex)		Fresenius Medical Care Deutschland GmbH
+B04C05     (base 16)		Fresenius Medical Care Deutschland GmbH
+				Hafenstr. 9
+				Schweinfurt    97424
+				DE
+
+B0-79-3C   (hex)		Revolv Inc
+B0793C     (base 16)		Revolv Inc
+				2060 Broadway #380
+				Boulder  CO  80302
+				US
+
+9C-4E-BF   (hex)		BoxCast
+9C4EBF     (base 16)		BoxCast
+				14538 Grapeland Ave
+				Cleveland  Ohio  44111
+				US
+
+34-A8-43   (hex)		KYOCERA Display Corporation
+34A843     (base 16)		KYOCERA Display Corporation
+				5-7-18 Higashinippori
+				Arakawa-ku  Tokyo  116-0014
+				JP
+
+74-CA-25   (hex)		Calxeda, Inc.
+74CA25     (base 16)		Calxeda, Inc.
+				7000 North Mopac Expressway
+				Austin  TX  78731
+				US
+
+5C-A3-EB   (hex)		Lokel s.r.o.
+5CA3EB     (base 16)		Lokel s.r.o.
+				Moravska 797/85
+				Ostrava  Moravskoslezsky  700 30
+				CZ
+
+C8-B3-73   (hex)		Cisco-Linksys, LLC
+C8B373     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+0C-2A-E7   (hex)		Beijing General Research Institute of Mining and Metallurgy
+0C2AE7     (base 16)		Beijing General Research Institute of Mining and Metallurgy
+				Building 23, Zone 18 of ABP, No. 188
+				  Beijing  100160
+				CN
+
+98-30-71   (hex)		DAIKYUNG VASCOM
+983071     (base 16)		DAIKYUNG VASCOM
+				DAIKYUNG Bldg.#1164-15,Gaepo-dong
+				Gangnam-gu  Seoul  135-960
+				KR
+
+D4-95-24   (hex)		Clover Network, Inc.
+D49524     (base 16)		Clover Network, Inc.
+				415 N Mathilda Ave
+				Sunnyvale  CA  94085
+				US
+
+94-50-47   (hex)		Rechnerbetriebsgruppe
+945047     (base 16)		Rechnerbetriebsgruppe
+				Werner von Siemens Str. 64
+				Würzburg  Bayern  97076
+				DE
+
+E0-31-D0   (hex)		SZ Telstar CO., LTD
+E031D0     (base 16)		SZ Telstar CO., LTD
+				Telstar Technology Park No.12&14, Longtong Industrial Zone
+				Shenzhen  Guangdong  518172
+				CN
+
+54-11-2F   (hex)		Sulzer Pump Solutions Finland Oy
+54112F     (base 16)		Sulzer Pump Solutions Finland Oy
+				Lentokentaentie 44
+				Lappeenranta    FI-53600
+				FI
+
+4C-55-B8   (hex)		Turkcell Teknoloji
+4C55B8     (base 16)		Turkcell Teknoloji
+				TUBITAK MAM Teknoloji Serbest Bolgesi Gebze
+				Kocaeli    41470
+				TR
+
+08-80-39   (hex)		Cisco SPVTG
+088039     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+E4-38-F2   (hex)		Advantage Controls
+E438F2     (base 16)		Advantage Controls
+				4700 Harold Abitz Dr.
+				Muskogee  OK  74403
+				US
+
+C4-C7-55   (hex)		Beijing HuaqinWorld Technology Co.,Ltd
+C4C755     (base 16)		Beijing HuaqinWorld Technology Co.,Ltd
+				30F,Beijing Silver Tower,No.2 North Road,
+				  Beijing  100027
+				CN
+
+0C-2D-89   (hex)		QiiQ Communications Inc.
+0C2D89     (base 16)		QiiQ Communications Inc.
+				30 East Beaver Creek Road
+				Richmond Hill  Ontario  L4B 1J2
+				CA
+
+A8-D2-36   (hex)		Lightware Visual Engineering
+A8D236     (base 16)		Lightware Visual Engineering
+				Peterdy utca 15.
+				  Budapest  H-1071
+				HU
+
+98-10-94   (hex)		Shenzhen Vsun communication technology Co.,ltd
+981094     (base 16)		Shenzhen Vsun communication technology Co.,ltd
+				Room 1903, Block A,
+				Shenzhen  Guangdong  518000
+				CN
+
+A4-F3-C1   (hex)		Open Source Robotics Foundation, Inc.
+A4F3C1     (base 16)		Open Source Robotics Foundation, Inc.
+				419 N Shoreline Blvd
+				Mountain View  CA  94043
+				US
+
+14-13-30   (hex)		Anakreon UK LLP
+141330     (base 16)		Anakreon UK LLP
+				5-th Floor
+				  London  EC3V 0EH
+				GB
+
+0C-F4-05   (hex)		Beijing Signalway Technologies Co.,Ltd
+0CF405     (base 16)		Beijing Signalway Technologies Co.,Ltd
+				Room B 1905,Tri-tower
+				Haidian District  Beijing  100190
+				CN
+
+50-61-D6   (hex)		Indu-Sol GmbH
+5061D6     (base 16)		Indu-Sol GmbH
+				Blumenstr. 3
+				Schmölln  Thüringen  04626
+				DE
+
+DC-70-14   (hex)		Private
+DC7014     (base 16)		Private
+
+78-8D-F7   (hex)		Hitron Technologies. Inc
+788DF7     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+2C-24-5F   (hex)		Babolat VS
+2C245F     (base 16)		Babolat VS
+				93 rue Andre Bollier
+				  Lyon  69007
+				FR
+
+90-56-92   (hex)		Autotalks Ltd.
+905692     (base 16)		Autotalks Ltd.
+				Kfar Netter
+				  Israel  40593
+				IL
+
+04-BF-A8   (hex)		ISB Corporation
+04BFA8     (base 16)		ISB Corporation
+				1-2-1 Shinyokohama, Kohoku-ku
+				Yokohama  Kanagawa  222-0033
+				JP
+
+8C-C7-D0   (hex)		zhejiang ebang communication co.,ltd
+8CC7D0     (base 16)		zhejiang ebang communication co.,ltd
+				1418-36#,Moganshan Road
+				hangzhou  zhejiang  310013
+				CN
+
+B8-AE-6E   (hex)		Nintendo Co., Ltd.
+B8AE6E     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+D0-EB-03   (hex)		Zhehua technology limited
+D0EB03     (base 16)		Zhehua technology limited
+				Room 2206,No 1079,A,ZhanTao Technology Building, MinZhi Street, Longhua District
+				Tortoal British Virgin Island,Hong Kong  Shenzhen,Guang Dong  518131
+				CN
+
+68-3E-EC   (hex)		ERECA
+683EEC     (base 16)		ERECA
+				75, Rue d&#39;Orgemont
+				Saint GRATIEN    95210
+				FR
+
+C4-26-28   (hex)		Airo Wireless
+C42628     (base 16)		Airo Wireless
+				12 Piedmont Center
+				Atlanta  GA  30305
+				US
+
+30-AA-BD   (hex)		Shanghai Reallytek Information Technology Co.,Ltd
+30AABD     (base 16)		Shanghai Reallytek Information Technology Co.,Ltd
+				Building No.1-906, No.3000 Long Dong Avenue
+				Shanghai    201203
+				CN
+
+A4-B8-18   (hex)		PENTA Gesellschaft für elektronische Industriedatenverarbeitung mbH
+A4B818     (base 16)		PENTA Gesellschaft für elektronische Industriedatenverarbeitung mbH
+				Ulrichsberger Str. 17
+				Deggendorf    94469
+				DE
+
+C0-4D-F7   (hex)		SERELEC
+C04DF7     (base 16)		SERELEC
+				2, Chemin du Génie
+				VENISSIEUX CEDEX    69633
+				FR
+
+0C-84-84   (hex)		Zenovia Electronics Inc.
+0C8484     (base 16)		Zenovia Electronics Inc.
+				#206, 506B St. Albert Rd.
+				St. Albert  AB  T8N 5Z1
+				CA
+
+00-59-07   (hex)		LenovoEMC Products USA, LLC
+005907     (base 16)		LenovoEMC Products USA, LLC
+				22 South St
+				Hopinkton  MA  01748
+				US
+
+50-A7-15   (hex)		Aboundi, Inc.
+50A715     (base 16)		Aboundi, Inc.
+				4 Bud Way, Unit 10
+				Nashua  NH  03063
+				US
+
+0C-04-00   (hex)		Jantar d.o.o.
+0C0400     (base 16)		Jantar d.o.o.
+				Kranjska cesta 24
+				Naklo  Slovenia  4202
+				SI
+
+68-7C-D5   (hex)		Y Soft Corporation, a.s.
+687CD5     (base 16)		Y Soft Corporation, a.s.
+				Technicka 2948/13
+				Brno  Czech Republic  616 00
+				CZ
+
+90-7A-F1   (hex)		Wally
+907AF1     (base 16)		Wally
+				1415 NE 45th St
+				Seattle  WA  98105
+				US
+
+2C-B6-93   (hex)		Radware
+2CB693     (base 16)		Radware
+				22 Raoul Wallenberg St.
+				Tel-Aviv    69710
+				IL
+
+A8-61-AA   (hex)		Cloudview Limited
+A861AA     (base 16)		Cloudview Limited
+				Kingsway House
+				St Peter Port  Guernsey  GY1 2QE
+				GB
+
+FC-11-86   (hex)		Logic3 plc
+FC1186     (base 16)		Logic3 plc
+				Rhodes Way
+				Watford  Hertfordshire  WD24 4YW
+				GB
+
+E0-18-77   (hex)		FUJITSU LIMITED
+E01877     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+E4-57-A8   (hex)		Stuart Manufacturing, Inc.
+E457A8     (base 16)		Stuart Manufacturing, Inc.
+				1615 East Wallace Street
+				Fort Wayne  Indiana  46803
+				US
+
+78-99-66   (hex)		Musilab Electronics (DongGuan)Co.,Ltd.
+789966     (base 16)		Musilab Electronics (DongGuan)Co.,Ltd.
+				A2, LinDong 3 Road, LinCun
+				DongGuan  Guangdong  523710
+				CN
+
+28-CB-EB   (hex)		One
+28CBEB     (base 16)		One
+				Mechelsesteenweg 326
+				Edegem  Antwerpen  2650
+				BE
+
+7C-A1-5D   (hex)		GN ReSound A/S
+7CA15D     (base 16)		GN ReSound A/S
+				Lautrupbjerg 7
+				Ballerup  DK-CPH  2750
+				DK
+
+3C-08-1E   (hex)		Beijing Yupont Electric Power Technology Co.,Ltd
+3C081E     (base 16)		Beijing Yupont Electric Power Technology Co.,Ltd
+				No.1,Dizang-an Nanxiang
+				  Beijing  100045
+				CN
+
+FC-58-FA   (hex)		Shen Zhen Shi Xin Zhong Xin Technology Co.,Ltd.
+FC58FA     (base 16)		Shen Zhen Shi Xin Zhong Xin Technology Co.,Ltd.
+				Block 3, Dong Huan Industrial Zone, Sha Jing Town
+				Shen Zhen  Guang Dong  518000
+				CN
+
+4C-CC-34   (hex)		Motorola Solutions Inc.
+4CCC34     (base 16)		Motorola Solutions Inc.
+				One Motorola Plaza
+				Holtsville  NY  11742
+				US
+
+D0-D4-71   (hex)		MVTECH co., Ltd
+D0D471     (base 16)		MVTECH co., Ltd
+				#1004, Hanshin IT Tower, 235, Guro 3-dong, Guro-Gu
+				SEOUL    152-768
+				KR
+
+08-68-D0   (hex)		Japan System Design
+0868D0     (base 16)		Japan System Design
+				Skyhills Deshio 3F
+				  Hiroshima  734-0001
+				JP
+
+D4-22-3F   (hex)		Lenovo Mobile Communication Technology Ltd.
+D4223F     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,Torch Hi-tech Industry Development Zone,
+				Xiamen  Fujian  361006
+				US
+
+C8-EE-A6   (hex)		Shenzhen SHX Technology Co., Ltd
+C8EEA6     (base 16)		Shenzhen SHX Technology Co., Ltd
+				6F,No.10 buliding,JiuXiangling Industial Zone,Xili,
+				Shenzhen  Guangdong  518055
+				CN
+
+24-81-AA   (hex)		KSH International Co., Ltd.
+2481AA     (base 16)		KSH International Co., Ltd.
+				2F, No.17 Minsheng Rd, Xindian Dist.,
+				New Taipei City    23150
+				US
+
+AC-41-22   (hex)		Eclipse Electronic Systems Inc.
+AC4122     (base 16)		Eclipse Electronic Systems Inc.
+				17111 Waterview Parkway
+				Dallas  TX  75252
+				US
+
+68-97-E8   (hex)		Society of Motion Picture &amp; Television Engineers
+6897E8     (base 16)		Society of Motion Picture &amp; Television Engineers
+				3 Barker Ave. FL5
+				White Plains  NY  10601
+				US
+
+E8-E8-75   (hex)		iS5 Communications Inc.
+E8E875     (base 16)		iS5 Communications Inc.
+				#1-1815 Meyerside Drive
+				Mississauga  Ontario  L5T 1G3
+				CA
+
+C8-0E-95   (hex)		OmniLync Inc.
+C80E95     (base 16)		OmniLync Inc.
+				51a Bennington St.
+				Newton  MA  02458
+				US
+
+30-05-5C   (hex)		Brother industries, LTD.
+30055C     (base 16)		Brother industries, LTD.
+				1-1-1, Kawagishi, Mizuho-ku,
+				Nagoya  Aichi  467-8562
+				JP
+
+08-0E-A8   (hex)		Velex s.r.l.
+080EA8     (base 16)		Velex s.r.l.
+				Via Dell&#39;Artigianato 56
+				Vigodarzere  Padova  35010
+				IT
+
+B8-C4-6F   (hex)		PRIMMCON INDUSTRIES INC
+B8C46F     (base 16)		PRIMMCON INDUSTRIES INC
+				137 MinQuan Rd, 5th Floor,
+				New Taipei    23141
+				TW
+
+D8-B0-2E   (hex)		Guangzhou Zonerich Business Machine Co., LTD.
+D8B02E     (base 16)		Guangzhou Zonerich Business Machine Co., LTD.
+				North Gate, No.17 Yunjun Road, Luogang District
+				 Guangzhou  Guangdong  510530
+				CN
+
+C4-E0-32   (hex)		IEEE 1904.1 Working Group
+C4E032     (base 16)		IEEE 1904.1 Working Group
+				1351 Redwood Way,
+				Petaluma  CA  94954
+				US
+
+58-EB-14   (hex)		Proteus Digital Health
+58EB14     (base 16)		Proteus Digital Health
+				2600 Bridge Parkway, Ste 101
+				Redwood City  California  94065
+				US
+
+C4-58-C2   (hex)		Shenzhen TATFOOK Technology Co., Ltd.
+C458C2     (base 16)		Shenzhen TATFOOK Technology Co., Ltd.
+				3rd Industrial Area of Shajing Industrial Company, Haoxiang Road
+				Shenzhen  Guangdong  518104
+				CN
+
+D0-CD-E1   (hex)		Scientech Electronics
+D0CDE1     (base 16)		Scientech Electronics
+				4F, No.501-17, Zhong Zheng Rd,
+				New Taipei City    23148
+				TW
+
+5C-E0-CA   (hex)		FeiTian United (Beijing) System Technology Co., Ltd.
+5CE0CA     (base 16)		FeiTian United (Beijing) System Technology Co., Ltd.
+				3 Floor, Tower B, Huizhi Tower
+				Haidian District  Beijing  100085
+				CN
+
+E0-81-77   (hex)		GreenBytes, Inc.
+E08177     (base 16)		GreenBytes, Inc.
+				15 Gray Lane, Suite 301
+				Ashaway  RI  02804
+				US
+
+9C-98-11   (hex)		Guangzhou Sunrise Electronics Development Co., Ltd
+9C9811     (base 16)		Guangzhou Sunrise Electronics Development Co., Ltd
+				12th Floor,368 GuangZhou Avenue South
+				Guangzhou  Guangdong  510300
+				CN
+
+B8-60-91   (hex)		Onnet Technologies and Innovations LLC
+B86091     (base 16)		Onnet Technologies and Innovations LLC
+				1, 82/83 Street, New Industrial Area -II
+				Ajman  Ajman  52141
+				AE
+
+8C-76-C1   (hex)		Goden Tech Limited
+8C76C1     (base 16)		Goden Tech Limited
+				ROOM 510-511C2 NAN FUNG TOWER.,
+				    999077
+				HK
+
+8C-07-8C   (hex)		FLOW DATA INC
+8C078C     (base 16)		FLOW DATA INC
+				2309 GRAND PARK DRIVE
+				GRAND JUNCTION  CO  81505
+				US
+
+F8-DF-A8   (hex)		zte corporation
+F8DFA8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A8-95-B0   (hex)		Aker Subsea Ltd
+A895B0     (base 16)		Aker Subsea Ltd
+				Kiekhill Industrial Estate
+				  Aberdeen  AB51 3XA
+				GB
+
+10-4D-77   (hex)		Innovative Computer Engineering
+104D77     (base 16)		Innovative Computer Engineering
+				10302 Eaton Place STE 100
+				Fairfax  VA  22030
+				US
+
+C4-5D-D8   (hex)		HDMI Forum
+C45DD8     (base 16)		HDMI Forum
+				1140 East Arques Avenue, Suite 900
+				Sunnyvale  CA  94085
+				US
+
+C4-EB-E3   (hex)		RRCN SAS
+C4EBE3     (base 16)		RRCN SAS
+				23 chemin du vieux chene
+				Meylan  Isere  38246
+				FR
+
+94-75-6E   (hex)		QinetiQ North America
+94756E     (base 16)		QinetiQ North America
+				137 Delta Drive
+				Pittsburgh  PA  15238
+				US
+
+4C-1A-95   (hex)		Novakon Co., Ltd.
+4C1A95     (base 16)		Novakon Co., Ltd.
+				6F., No. 120, Lane 235, Pao Chiao Road
+				New Taipei City    23145
+				TW
+
+60-BB-0C   (hex)		Beijing HuaqinWorld Technology Co,Ltd
+60BB0C     (base 16)		Beijing HuaqinWorld Technology Co,Ltd
+				30F,Beijing Silver Tower,No.2 North Road
+				Chao Yang District  Beijing  100027
+				CN
+
+A4-2C-08   (hex)		Masterwork Automodules
+A42C08     (base 16)		Masterwork Automodules
+				11F-3, 3,PARK ST., NAN GANG
+				TAIPEI    11503
+				TW
+
+10-B9-FE   (hex)		Lika srl
+10B9FE     (base 16)		Lika srl
+				Via San Lorenzo 25
+				Carrè  Vicenza  36010
+				IT
+
+30-15-18   (hex)		Ubiquitous Communication Co. ltd.
+301518     (base 16)		Ubiquitous Communication Co. ltd.
+				JEI Platz RM No.410-1
+				  Seoul  153-792
+				KR
+
+84-17-15   (hex)		GP Electronics (HK) Ltd.
+841715     (base 16)		GP Electronics (HK) Ltd.
+				Gold Peak Industrial Building, 6F
+				Kwai Chung  NT  
+				HK
+
+84-8E-96   (hex)		Embertec Pty Ltd
+848E96     (base 16)		Embertec Pty Ltd
+				182 Fullarton Road
+				Dulwich, Adelaide  South Australia  5065
+				AU
+
+64-99-A0   (hex)		AG Elektronik AB
+6499A0     (base 16)		AG Elektronik AB
+				Smidesv 12
+				Staffanstorp    24534
+				SE
+
+08-F1-B7   (hex)		Towerstream Corpration
+08F1B7     (base 16)		Towerstream Corpration
+				55 Hammerlund Way
+				Middletown  RI  02842
+				US
+
+C0-44-E3   (hex)		Shenzhen Sinkna Electronics Co., LTD
+C044E3     (base 16)		Shenzhen Sinkna Electronics Co., LTD
+				9 Building, XinXin Tian Industry Area,
+				Shenzhen  Guangdong  5180000
+				CN
+
+18-55-0F   (hex)		Cisco SPVTG
+18550F     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+18-7A-93   (hex)		AMICCOM Electronics Corporation
+187A93     (base 16)		AMICCOM Electronics Corporation
+				Room A3, 1F., No.1, Lixing 1st Rd
+				Hsinchu    30078
+				TW
+
+88-87-DD   (hex)		DarbeeVision Inc.
+8887DD     (base 16)		DarbeeVision Inc.
+				401 N. Cotswolds Lane #C
+				Orange  California  92869
+				US
+
+30-C8-2A   (hex)		WI-BIZ srl
+30C82A     (base 16)		WI-BIZ srl
+				Via Carlo Ferrero 10
+				Cascine Vica Rivoli  Torino  10098
+				IT
+
+88-A3-CC   (hex)		Amatis Controls
+88A3CC     (base 16)		Amatis Controls
+				 210 Aspen Airport Business Center, Suite A
+				Aspen  CO  81611
+				US
+
+C0-A0-C7   (hex)		FAIRFIELD INDUSTRIES
+C0A0C7     (base 16)		FAIRFIELD INDUSTRIES
+				1111 GILLINGHAM LANE
+				SUGAR LAND  TEXAS  77478
+				US
+
+DC-A9-89   (hex)		MACANDC
+DCA989     (base 16)		MACANDC
+				2-nd Filevskaya str.7/6
+				Moscow    121096
+				RU
+
+A0-03-63   (hex)		Robert Bosch Healthcare GmbH
+A00363     (base 16)		Robert Bosch Healthcare GmbH
+				Stuttgarter Stra
+				Waiblingen  Baden-Württemberg  71332
+				DE
+
+D0-B4-98   (hex)		Robert Bosch LLC Automotive Electronics
+D0B498     (base 16)		Robert Bosch LLC Automotive Electronics
+				15000 N Haggerty
+				Plymouth  Michigan  48170
+				US
+
+E0-55-97   (hex)		Emergent Vision Technologies Inc.
+E05597     (base 16)		Emergent Vision Technologies Inc.
+				SUITE# 239 - 552A CLARKE ROAD
+				COQUITLAM  British Columbia  V3J 0A3
+				CA
+
+7C-43-8F   (hex)		E-Band Communications Corp.
+7C438F     (base 16)		E-Band Communications Corp.
+				10095 Scripps Ranch Ct.  Ste A
+				San Diego  CA  92131
+				US
+
+A0-E2-5A   (hex)		Amicus SK, s.r.o.
+A0E25A     (base 16)		Amicus SK, s.r.o.
+				Koreszkova 9
+				Skalica  Trnavsky kraj  90901
+				SK
+
+D4-0F-B2   (hex)		Applied Micro Electronics AME bv
+D40FB2     (base 16)		Applied Micro Electronics AME bv
+				Esp 100
+				Eindhoven  NB  5633 AA
+				NL
+
+44-9B-78   (hex)		The Now Factory
+449B78     (base 16)		The Now Factory
+				Arkle Road
+				Dublin 18    
+				IE
+
+F0-F6-69   (hex)		Motion Analysis Corporation
+F0F669     (base 16)		Motion Analysis Corporation
+				3617 Westwind Blvd.
+				Santa Rosa  CA  95403
+				US
+
+78-99-5C   (hex)		Nationz Technologies Inc
+78995C     (base 16)		Nationz Technologies Inc
+				12F,Tower Building #3,China Academy of Science and Technology Development,Gaoxin South Ave.1
+				Shen Zhen  GuangDong  518057
+				CN
+
+84-9D-C5   (hex)		Centera Photonics Inc.
+849DC5     (base 16)		Centera Photonics Inc.
+				3F, No 6-3 Dusing Rd.
+				Hsinchu  Taiwan  30078
+				TW
+
+58-09-43   (hex)		Private
+580943     (base 16)		Private
+
+EC-FC-55   (hex)		A. Eberle GmbH & Co. KG
+ECFC55     (base 16)		A. Eberle GmbH & Co. KG
+				Frankenstrasse 160
+				Nuernberg  Bavaria  90461
+				DE
+
+18-2A-7B   (hex)		Nintendo Co., Ltd.
+182A7B     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+68-FB-95   (hex)		Generalplus Technology Inc.
+68FB95     (base 16)		Generalplus Technology Inc.
+				3F, No.8, Dusing Rd., Hsinchu Science Park
+				Hsinchu City    30077
+				TW
+
+F8-F0-82   (hex)		NAG LLC
+F8F082     (base 16)		NAG LLC
+				Predelnaya st 57/2
+				Ekaterinburg  Sverdlovskaya oblast   620161
+				RU
+
+5C-89-D4   (hex)		Beijing Banner Electric Co.,Ltd
+5C89D4     (base 16)		Beijing Banner Electric Co.,Ltd
+				Mail Box 1033,Long cheng Garden
+				Chang Ping District  beijing  102208
+				CN
+
+54-11-5F   (hex)		Atamo Pty Ltd
+54115F     (base 16)		Atamo Pty Ltd
+				21 River Road
+				Bayswater  WA  6156
+				AU
+
+8C-AE-4C   (hex)		Plugable Technologies
+8CAE4C     (base 16)		Plugable Technologies
+				40 Lake Bellevue Dr.
+				Bellevue  WA  98005
+				US
+
+0C-C6-55   (hex)		Wuxi YSTen Technology Co.,Ltd.
+0CC655     (base 16)		Wuxi YSTen Technology Co.,Ltd.
+				Room 1801,18F, North Star Times Tower,
+				Chaoyang District  Beijing  100101
+				CN
+
+24-2F-FA   (hex)		Toshiba Global Commerce Solutions
+242FFA     (base 16)		Toshiba Global Commerce Solutions
+				B307/D121F
+				RTP  NC  27709
+				US
+
+E4-96-AE   (hex)		ALTOGRAPHICS Inc.
+E496AE     (base 16)		ALTOGRAPHICS Inc.
+				Daegu Venture Center 13F
+				  Daegu  701-020
+				KR
+
+4C-22-58   (hex)		cozybit, Inc.
+4C2258     (base 16)		cozybit, Inc.
+				605 Market Street
+				San Francisco  CA  94105
+				US
+
+F4-94-66   (hex)		CountMax,  ltd
+F49466     (base 16)		CountMax,  ltd
+				11 Titova str. 
+				poselok Lesnoy  Moscowskaya oblast  141231
+				RU
+
+F4-52-14   (hex)		Mellanox Technologies, Inc.
+F45214     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+1C-95-9F   (hex)		Veethree Electronics And Marine LLC
+1C959F     (base 16)		Veethree Electronics And Marine LLC
+				2050 47th Terrace East
+				Bradenton  Florida  34203
+				US
+
+08-81-F4   (hex)		Juniper Networks
+0881F4     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+10-F4-9A   (hex)		T3 Innovation
+10F49A     (base 16)		T3 Innovation
+				808 Calle Plano
+				Camarillo  CA  93012
+				US
+
+3C-57-BD   (hex)		Kessler Crane Inc.
+3C57BD     (base 16)		Kessler Crane Inc.
+				602 East Jefferson St
+				Plymouth  Indidana  46563
+				US
+
+04-E9-E5   (hex)		PJRC.COM, LLC
+04E9E5     (base 16)		PJRC.COM, LLC
+				14723 SW Brooke Ct
+				Sherwood  Oregon  97140
+				US
+
+60-BD-91   (hex)		Move Innovation
+60BD91     (base 16)		Move Innovation
+				Generatorvej 8B,st
+				Herlev  DK  2730
+				DK
+
+CC-4B-FB   (hex)		Hellberg Safety AB
+CC4BFB     (base 16)		Hellberg Safety AB
+				Stakebergsvagen 2
+				Stenkullen    44361
+				SE
+
+6C-AD-EF   (hex)		KZ Broadband Technologies, Ltd. 
+6CADEF     (base 16)		KZ Broadband Technologies, Ltd. 
+				1601 Tower C 
+				Shenzhen  Guangdong  518057
+				CN
+
+74-5F-AE   (hex)		TSL PPL
+745FAE     (base 16)		TSL PPL
+				Units 1-2, First Avenue
+				Marlow  Buckinghamshire  SL7 1YA
+				GB
+
+68-51-B7   (hex)		PowerCloud Systems, Inc.
+6851B7     (base 16)		PowerCloud Systems, Inc.
+				3333 Coyote Hill Rd
+				Palo Alto  CA  94304
+				US
+
+74-2D-0A   (hex)		Norfolk Elektronik AG
+742D0A     (base 16)		Norfolk Elektronik AG
+				Luzernstrasse 12
+				Eschenbach  LU  6274
+				CH
+
+70-F1-E5   (hex)		Xetawave LLC
+70F1E5     (base 16)		Xetawave LLC
+				1668 Valtec Lane
+				Boulder  CO  80301
+				US
+
+C0-AA-68   (hex)		OSASI Technos Inc.
+C0AA68     (base 16)		OSASI Technos Inc.
+				65-3, Hongu-cho, 
+				Kochi-shi, Kochi-ken     780-0945
+				JP
+
+88-D7-BC   (hex)		DEP Company
+88D7BC     (base 16)		DEP Company
+				Poryadkovy pereulok,21
+				Moscow    127055
+				RU
+
+48-5A-3F   (hex)		WISOL
+485A3F     (base 16)		WISOL
+				373-7, Gajang-dong
+				Osan-si  Gyeonggi-do  447-210
+				KR
+
+60-BC-4C   (hex)		EWM Hightec Welding GmbH
+60BC4C     (base 16)		EWM Hightec Welding GmbH
+				Dr.Günter-Henle-Str. 8
+				Mündersbach  Rheinland Pfalz  56271
+				DE
+
+1C-11-E1   (hex)		Wartsila Finland Oy
+1C11E1     (base 16)		Wartsila Finland Oy
+				Jarvikatu 2-4
+				Vaasa  Western Finland  65101
+				FI
+
+50-46-5D   (hex)		ASUSTek COMPUTER INC.
+50465D     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+74-BF-A1   (hex)		HYUNTECK
+74BFA1     (base 16)		HYUNTECK
+				#603 107-Dong, Jugong Apt., Changhyeon-ri, Hwado-eup
+				Namyangju-si  Gyeonggi-do  472-779
+				KR
+
+CC-26-2D   (hex)		Verifi, LLC
+CC262D     (base 16)		Verifi, LLC
+				9466 Meridian Way
+				West Chester   OH  45069
+				US
+
+3C-8A-E5   (hex)		Tensun Information Technology(Hangzhou) Co.,LTD
+3C8AE5     (base 16)		Tensun Information Technology(Hangzhou) Co.,LTD
+				Room 207,Building 5,Wensan Road
+				Hangzhou  Zhejiang  310013
+				CN
+
+2C-5A-A3   (hex)		PROMATE ELECTRONIC CO.LTD
+2C5AA3     (base 16)		PROMATE ELECTRONIC CO.LTD
+				4F 32,SEC.1 HUAN SHAN RD.,NEI HU,
+				TAIPEI    114
+				TW
+
+34-E0-CF   (hex)		zte corporation
+34E0CF     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+08-B7-38   (hex)		Lite-On Technogy Corp.
+08B738     (base 16)		Lite-On Technogy Corp.
+				18F, 392, RueyKuang Road, Neihu,
+				Taipei    11492
+				TW
+
+F8-AA-8A   (hex)		Axview Technology (Shenzhen) Co.,Ltd
+F8AA8A     (base 16)		Axview Technology (Shenzhen) Co.,Ltd
+				NO 1, Mei Zhong Road, Futian District
+				SHENZHEN  GUANGDONG  518049
+				CN
+
+7C-01-87   (hex)		Curtis Instruments, Inc.
+7C0187     (base 16)		Curtis Instruments, Inc.
+				200 Kisco Avenue
+				Mt Kisco  NY  10549
+				US
+
+54-F6-66   (hex)		Berthold Technologies GmbH and Co.KG
+54F666     (base 16)		Berthold Technologies GmbH and Co.KG
+				Calmbacher Strasse 22
+				Bad Wildbad    75323
+				DE
+
+34-C8-03   (hex)		Nokia Corporation
+34C803     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+F0-5F-5A   (hex)		Getriebebau NORD GmbH and Co. KG
+F05F5A     (base 16)		Getriebebau NORD GmbH and Co. KG
+				Rudolf-Diesel-Strasse 1
+				Bargteheide  Schleswig-Holstein  22941
+				DE
+
+80-1D-AA   (hex)		Avaya Inc
+801DAA     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+7C-09-2B   (hex)		Bekey A/S
+7C092B     (base 16)		Bekey A/S
+				Bredebjergvej 6
+				Taastrup    2630
+				DK
+
+84-2B-BC   (hex)		Modelleisenbahn GmbH
+842BBC     (base 16)		Modelleisenbahn GmbH
+				Plainbachstrasse 4
+				Bergheim    5101
+				AT
+
+B4-00-9C   (hex)		CableWorld Ltd.
+B4009C     (base 16)		CableWorld Ltd.
+				Kondorfa u. 6/B
+				Budapest    1112
+				HU
+
+28-9E-DF   (hex)		Danfoss Turbocor Compressors, Inc
+289EDF     (base 16)		Danfoss Turbocor Compressors, Inc
+				1769 E. Paul Dirac Ave.
+				Tallahassee  Florida  32310
+				US
+
+80-3F-D6   (hex)		bytes at work AG
+803FD6     (base 16)		bytes at work AG
+				Konradstrasse 15
+				Winterthur  ZH  8400
+				CH
+
+78-44-05   (hex)		FUJITU(HONG KONG) ELECTRONIC Co.,LTD.
+784405     (base 16)		FUJITU(HONG KONG) ELECTRONIC Co.,LTD.
+				8/F,QingHai Building,Xiang Mei Road,Futian District
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+04-4A-50   (hex)		Ramaxel Technology (Shenzhen) limited company
+044A50     (base 16)		Ramaxel Technology (Shenzhen) limited company
+				2-5/F,North Block Southeast Industrial and Commercial Building Houhai Road,Shekou Shenzhen 
+				shenzhen  guangdong  518067
+				CN
+
+0C-D9-C1   (hex)		Visteon Corporation
+0CD9C1     (base 16)		Visteon Corporation
+				One Village Center Drive
+				Van Buren Twp  MI  48111
+				US
+
+38-A5-B6   (hex)		SHENZHEN MEGMEET ELECTRICAL CO.,LTD
+38A5B6     (base 16)		SHENZHEN MEGMEET ELECTRICAL CO.,LTD
+				5th Floor,Building B, Ziguang Information Harbor
+				Shenzhen  Guangdong  518057
+				CN
+
+68-AB-8A   (hex)		RF IDeas
+68AB8A     (base 16)		RF IDeas
+				4020 Winnetka Ave
+				Rolling Meadows  IL  60008
+				US
+
+24-EE-3A   (hex)		Chengdu Yingji Electronic Hi-tech Co Ltd
+24EE3A     (base 16)		Chengdu Yingji Electronic Hi-tech Co Ltd
+				No.3 South Herui Road Hi-tech Zone
+				Chengdu City  Sichuan  611731
+				CN
+
+0C-C6-6A   (hex)		Nokia Corporation
+0CC66A     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+74-27-3C   (hex)		ChangYang Technology (Nanjing) Co., LTD
+74273C     (base 16)		ChangYang Technology (Nanjing) Co., LTD
+				NO.9 KaiCheng Road,QiLinTown
+				NanJing  JiangSu  211100
+				CN
+
+08-7C-BE   (hex)		Quintic Corp.
+087CBE     (base 16)		Quintic Corp.
+				1600 Wyatt Dr., #8
+				Santa Clara  CA  95054
+				US
+
+E8-04-F3   (hex)		Throughtek Co., Ltd.
+E804F3     (base 16)		Throughtek Co., Ltd.
+				4F, no. 221, Chong-yang Rd.
+				Taipei    11573
+				TW
+
+08-68-EA   (hex)		EITO ELECTRONICS CO., LTD.
+0868EA     (base 16)		EITO ELECTRONICS CO., LTD.
+				1-34-1 Shinmeidai
+				Hamura-shi  Tokyo  205-0023
+				JP
+
+F8-22-85   (hex)		Cypress Technology CO., LTD.
+F82285     (base 16)		Cypress Technology CO., LTD.
+				6F-5, NO., 130 Jiankang Rd.,
+				Zhonghe Dist.  New Taipei City  23585
+				TW
+
+C4-AD-21   (hex)		MEDIAEDGE Corporation
+C4AD21     (base 16)		MEDIAEDGE Corporation
+				23F Kobe Commerce, Industry and Trade Center Bldg.
+				Kobe  Hyogo  651-0083
+				JP
+
+E8-5B-F0   (hex)		Imaging Diagnostics
+E85BF0     (base 16)		Imaging Diagnostics
+				POB 698
+				Nes Ziona  N/A  74106
+				IL
+
+A4-0B-ED   (hex)		Carry Technology Co.,Ltd
+A40BED     (base 16)		Carry Technology Co.,Ltd
+				4F, No.119, JianKang Road
+				Jhonghe Dist.  New Taipei City  23585
+				TW
+
+70-23-93   (hex)		fos4X GmbH
+702393     (base 16)		fos4X GmbH
+				Thalkirchner Str. 210, Geb. 6
+				81371 München    
+				DE
+
+64-D8-14   (hex)		Cisco Systems, Inc
+64D814     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F8-5F-2A   (hex)		Nokia Corporation
+F85F2A     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+C4-38-D3   (hex)		TAGATEC CO.,LTD
+C438D3     (base 16)		TAGATEC CO.,LTD
+				#604, Dongmoon Goodmorning Tower 2, 
+				Goyang-si  Kyunggi-do  410-704
+				KR
+
+50-2E-CE   (hex)		Asahi Electronics Co.,Ltd
+502ECE     (base 16)		Asahi Electronics Co.,Ltd
+				29-25 Kariyado
+				  Kanagawa-ken  211-0022
+				JP
+
+AC-14-D2   (hex)		wi-daq, inc.
+AC14D2     (base 16)		wi-daq, inc.
+				850 NW Federal Hwy
+				Stuart  Florida  34994
+				US
+
+9C-4C-AE   (hex)		Mesa Labs
+9C4CAE     (base 16)		Mesa Labs
+				10 Evergreen Dr
+				Bozeman  MT  59715
+				US
+
+20-C1-AF   (hex)		i Wit Digital Co., Limited
+20C1AF     (base 16)		i Wit Digital Co., Limited
+				303,Buiding1,Nanhai Ecool Innovation Park,
+				Shenzhen  GuangDong  518000
+				US
+
+80-AA-A4   (hex)		USAG
+80AAA4     (base 16)		USAG
+				301 Goolsby Blvd
+				Deerfield Beach  FL  33442
+				US
+
+30-AE-F6   (hex)		Radio Mobile Access
+30AEF6     (base 16)		Radio Mobile Access
+				1 Elm Sq
+				Andover  MA  01870
+				US
+
+08-5B-0E   (hex)		Fortinet, Inc.
+085B0E     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale  California  94086
+				US
+
+EC-42-F0   (hex)		ADL Embedded Solutions, Inc.
+EC42F0     (base 16)		ADL Embedded Solutions, Inc.
+				4411 Morena Blvd.
+				San Diego  CA  92117
+				US
+
+E8-CB-A1   (hex)		Nokia Corporation
+E8CBA1     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+6C-E4-CE   (hex)		Villiger Security Solutions AG
+6CE4CE     (base 16)		Villiger Security Solutions AG
+				Giessenmatt 2
+				Sins    5643
+				CH
+
+64-9F-F7   (hex)		Kone OYj
+649FF7     (base 16)		Kone OYj
+				Myllykatu 3
+				Hyvinkaa  Hyvinkaa  05830
+				FI
+
+CC-91-2B   (hex)		TE Connectivity Touch Solutions
+CC912B     (base 16)		TE Connectivity Touch Solutions
+				2245 Brighton Henrietta Town Line Road
+				Rochester  New York  14623
+				US
+
+C0-5E-79   (hex)		SHENZHEN HUAXUN ARK TECHNOLOGIES CO.,LTD
+C05E79     (base 16)		SHENZHEN HUAXUN ARK TECHNOLOGIES CO.,LTD
+				3F,C4 Building,Yintian Industrial Zone,Xixiang,Baoan District
+				shenzhen  guangdong  518102
+				CN
+
+58-BF-EA   (hex)		Cisco Systems, Inc
+58BFEA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-01-B1   (hex)		SeekTech INC
+C401B1     (base 16)		SeekTech INC
+				3855 Ruffin Road
+				San Diego  California  92123
+				US
+
+C0-C9-46   (hex)		MITSUYA LABORATORIES INC.
+C0C946     (base 16)		MITSUYA LABORATORIES INC.
+				6-31-18
+				KAWASAKI-CITY  KANAGAWA  215-0021
+				JP
+
+F4-60-0D   (hex)		Panoptic Technology, Inc
+F4600D     (base 16)		Panoptic Technology, Inc
+				587 W Eau Gallie Blvd
+				Melbourne  FL  32935
+				US
+
+A8-2B-D6   (hex)		Shina System Co., Ltd
+A82BD6     (base 16)		Shina System Co., Ltd
+				3305, O'BizTower, 126, Beolmal-ro,
+				Anyang-Si  Gyeounggi-Do  431-763
+				KR
+
+AC-CF-23   (hex)		Hi-flying electronics technology Co.,Ltd
+ACCF23     (base 16)		Hi-flying electronics technology Co.,Ltd
+				Room B101,456 BiBo Raod,PuDong
+				  Shanghai  201200
+				CN
+
+60-90-84   (hex)		DSSD Inc
+609084     (base 16)		DSSD Inc
+				4025 Bohannon Dr
+				Menlo Park  CA  94025
+				US
+
+FC-1D-59   (hex)		I Smart Cities HK Ltd
+FC1D59     (base 16)		I Smart Cities HK Ltd
+				Unit G,10/F,Phase 2,Yip Fat IND
+				    73-75
+				HK
+
+78-C4-AB   (hex)		Shenzhen Runsil Technology Co.,Ltd
+78C4AB     (base 16)		Shenzhen Runsil Technology Co.,Ltd
+				4/F., Yuhua Building A, Yangmen Industrial Park, 
+				Shenzhen  GuangDong  518055
+				CN
+
+B0-A8-6E   (hex)		Juniper Networks
+B0A86E     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+80-2A-FA   (hex)		Germaneers GmbH
+802AFA     (base 16)		Germaneers GmbH
+				Dr.-Kurt-Schumacher-Ring 3
+				Wettstetten  Bayern  85139
+				DE
+
+18-42-1D   (hex)		Private
+18421D     (base 16)		Private
+
+28-C9-14   (hex)		Taimag Corporation
+28C914     (base 16)		Taimag Corporation
+				NO. 1, West 2nd St. N.E.P.Z 
+				Kaohsiung    811
+				TW
+
+74-93-A4   (hex)		Zebra Technologies Corp.
+7493A4     (base 16)		Zebra Technologies Corp.
+				20314 Seneca Meadows Parkway
+				Germantown  Maryland  21771
+				US
+
+E4-71-85   (hex)		Securifi Ltd
+E47185     (base 16)		Securifi Ltd
+				16F-3, #482 Zhongxiao E Rd, Sec 5
+				Taipei    11083
+				TW
+
+08-0C-C9   (hex)		Mission Technology Group, dba Magma
+080CC9     (base 16)		Mission Technology Group, dba Magma
+				9918 Via Pasar
+				San Diego  CA  92126
+				US
+
+64-0E-94   (hex)		Pluribus Networks, Inc.
+640E94     (base 16)		Pluribus Networks, Inc.
+				1808 Embarcadero Rd Suite B
+				Palo Alto  CA  94303
+				US
+
+0C-B4-EF   (hex)		Digience Co.,Ltd.
+0CB4EF     (base 16)		Digience Co.,Ltd.
+				204 Building for Growth, Gumi Electronics&Information Technology Research Institute, 17 Cheomdangieop-1ro, 
+				Gumi  Gyeongbuk  
+				KR
+
+14-6A-0B   (hex)		Cypress Electronics Limited
+146A0B     (base 16)		Cypress Electronics Limited
+				11/F., Block G, East Sun Industrial Centre, 16 Shing Yip Street,
+				Hong Kong  nil  nil
+				HK
+
+F4-90-EA   (hex)		Deciso B.V.
+F490EA     (base 16)		Deciso B.V.
+				Burgemeester Mijslaan 2
+				Middelharnis  Zuid Holland  3241 XA
+				NL
+
+5C-EE-79   (hex)		Global Digitech Co LTD
+5CEE79     (base 16)		Global Digitech Co LTD
+				1F., No.25, Aly.56, Ln. 245, Sec. 4, Bade Rd.,
+				Taipei  Taiwan  105
+				TW
+
+4C-AA-16   (hex)		AzureWave Technologies (Shanghai) Inc.
+4CAA16     (base 16)		AzureWave Technologies (Shanghai) Inc.
+				No.8 Lane 66, Chenbao Road, Malu Town Jiading District
+				Shanghai    201801
+				CN
+
+AC-40-EA   (hex)		C&T Solution Inc. 
+AC40EA     (base 16)		C&T Solution Inc. 
+				12F-1, No.700, Zhongzheng Rd., Zhonghe Dist.
+				New Taipei City  Taiwan   235
+				TW
+
+00-2A-AF   (hex)		LARsys-Automation GmbH
+002AAF     (base 16)		LARsys-Automation GmbH
+				Sinzinger Str. 3
+				Hochburg-Ach    5122
+				AT
+
+1C-E1-65   (hex)		Marshal Corporation
+1CE165     (base 16)		Marshal Corporation
+				Field Three Sotokanda Bldg.
+				5-3-6, Sotokanda, Chiyodaku  Tokyo  101-0021
+				JP
+
+40-16-FA   (hex)		EKM Metering
+4016FA     (base 16)		EKM Metering
+				363 Berkeley Way
+				Santa Cruz  CA  95062
+				US
+
+0C-13-0B   (hex)		Uniqoteq Ltd.
+0C130B     (base 16)		Uniqoteq Ltd.
+				Lemminkaisenkatu 14-18 A
+				Turku    20520 
+				FI
+
+2C-54-2D   (hex)		Cisco Systems, Inc
+2C542D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-14-01   (hex)		Hitron Technologies. Inc
+BC1401     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+94-CA-0F   (hex)		Honeywell Analytics
+94CA0F     (base 16)		Honeywell Analytics
+				2840 2nd Ave SE
+				Calgary  Alberta  T2A7X9
+				CA
+
+78-25-44   (hex)		Omnima Limited
+782544     (base 16)		Omnima Limited
+				Oxford Science Park
+				Oxford  Oxfordshire  OX4 4GP
+				GB
+
+A4-18-75   (hex)		Cisco Systems, Inc
+A41875     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-AE-9C   (hex)		Shanghai TYD Elecronic Technology Co. Ltd
+C8AE9C     (base 16)		Shanghai TYD Elecronic Technology Co. Ltd
+				21F, BLKB, NO.391 GuiPing Rd, 
+				  Shanghai  200233
+				CN
+
+AC-3F-A4   (hex)		TAIYO YUDEN CO.,LTD
+AC3FA4     (base 16)		TAIYO YUDEN CO.,LTD
+				8-1, Sakae-cho
+				Takasaki-shi  Gunma  370-8522
+				JP
+
+6C-AE-8B   (hex)		IBM Corporation
+6CAE8B     (base 16)		IBM Corporation
+				4400 North First Street
+				San Jose  CA  95134
+				US
+
+40-AC-8D   (hex)		Data Management, Inc.
+40AC8D     (base 16)		Data Management, Inc.
+				3322 Loop 306
+				San Angelo  Texas  76904
+				US
+
+80-CE-B1   (hex)		Theissen Training Systems GmbH
+80CEB1     (base 16)		Theissen Training Systems GmbH
+				Schuchardstrasse 3
+				Duesseldorf  NRW  40595
+				DE
+
+FC-2A-54   (hex)		Connected Data, Inc.
+FC2A54     (base 16)		Connected Data, Inc.
+				2905 Stender Way
+				Santa Clara  CA  95054
+				US
+
+04-5C-06   (hex)		Zmodo Technology Corporation
+045C06     (base 16)		Zmodo Technology Corporation
+				1401 Interstate Dr
+				Champaign  IL  61822
+				US
+
+74-7B-7A   (hex)		ETH Inc.
+747B7A     (base 16)		ETH Inc.
+				#202 Mazium BLG, 545-6, Dangjung-dong,
+				Gunpo-si  Gyeonggi-do  435-833
+				KR
+
+48-EA-63   (hex)		Zhejiang Uniview Technologies Co., Ltd.
+48EA63     (base 16)		Zhejiang Uniview Technologies Co., Ltd.
+				Eastcom Building C,Eastcom Avenue
+				Hangzhou  Zhejiang  310053
+				CN
+
+E8-8D-F5   (hex)		ZNYX Networks, Inc.
+E88DF5     (base 16)		ZNYX Networks, Inc.
+				48421 Milmont Drive
+				Fremont  CA  94538
+				US
+
+90-F7-2F   (hex)		Phillips Machine & Welding Co., Inc. 
+90F72F     (base 16)		Phillips Machine & Welding Co., Inc. 
+				16125 E. Gale Ave.
+				Industry  CA  91745
+				US
+
+D0-57-85   (hex)		Pantech Co., Ltd.
+D05785     (base 16)		Pantech Co., Ltd.
+				110-1 Ongjeong-Ri, Tongjin-Eup
+				Gimpo-Si  Gyounggi-Do  415-865
+				KR
+
+40-8B-07   (hex)		Actiontec Electronics, Inc
+408B07     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+28-41-21   (hex)		OptiSense Network, LLC
+284121     (base 16)		OptiSense Network, LLC
+				1308 10th Street
+				Bridgeport  TX  76426
+				US
+
+38-45-8C   (hex)		MyCloud Technology corporation
+38458C     (base 16)		MyCloud Technology corporation
+				Room 705£¬Building F, Jiahua Building£¬
+				Beijing    100085
+				CN
+
+10-E4-AF   (hex)		APR, LLC
+10E4AF     (base 16)		APR, LLC
+				4800 US HWY 280 West
+				Opelika  AL  36801
+				US
+
+F4-EA-67   (hex)		Cisco Systems, Inc
+F4EA67     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-2D-48   (hex)		bct electronic GesmbH
+2C2D48     (base 16)		bct electronic GesmbH
+				Saalachstraße 86a
+				Salzburg    5020
+				AT
+
+28-BA-18   (hex)		NextNav, LLC
+28BA18     (base 16)		NextNav, LLC
+				484 Oakmead Parkway
+				Sunnyvale  CA  94085
+				US
+
+AC-3D-75   (hex)		HANGZHOU ZHIWAY TECHNOLOGIES CO.,LTD.
+AC3D75     (base 16)		HANGZHOU ZHIWAY TECHNOLOGIES CO.,LTD.
+				FLOOR12B,BUILDING E,PARADISE SOFTWARE PARK,NO.3 XIDOUMEN ROAD,
+				HANGZHOU  ZHEJIANG  310012
+				CN
+
+A0-90-DE   (hex)		VEEDIMS,LLC
+A090DE     (base 16)		VEEDIMS,LLC
+				49 N. Federal Highway #397
+				Pompano Beach  Florida  33062
+				US
+
+64-2D-B7   (hex)		SEUNGIL ELECTRONICS
+642DB7     (base 16)		SEUNGIL ELECTRONICS
+				#16-8, Dodang-dong
+				Buchon  Gyuonggi-do  420-801
+				KR
+
+00-2A-6A   (hex)		Cisco Systems, Inc
+002A6A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-36-E1   (hex)		Abilis Systems SARL
+F436E1     (base 16)		Abilis Systems SARL
+				3, chemin Pré Fleuri
+				Plan-Les-Ouates  Geneva  1228
+				CH
+
+78-1C-5A   (hex)		SHARP Corporation
+781C5A     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+E8-0C-75   (hex)		Syncbak, Inc.
+E80C75     (base 16)		Syncbak, Inc.
+				5 Research Center
+				Marion  IA  52302
+				US
+
+80-0A-06   (hex)		COMTEC co.,ltd
+800A06     (base 16)		COMTEC co.,ltd
+				60 shimoishida,azabu-cho,
+				Miyoshi-shi  Aichi-ken  470-0206
+				JP
+
+60-8C-2B   (hex)		Hanson Technology
+608C2B     (base 16)		Hanson Technology
+				Room 1503, Zhao Jia Bang Road
+				Shanghai    200030
+				CN
+
+94-00-70   (hex)		Nokia Corporation
+940070     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+BC-2C-55   (hex)		Bear Flag Design, Inc.
+BC2C55     (base 16)		Bear Flag Design, Inc.
+				1 Thayer Road
+				Santa Cruz  CA  95060
+				US
+
+0C-75-23   (hex)		BEIJING GEHUA CATV NETWORK CO.,LTD
+0C7523     (base 16)		BEIJING GEHUA CATV NETWORK CO.,LTD
+				No.35,N.Huayuan RD.,Haidian District
+				BEIJING    100083
+				CN
+
+04-F0-21   (hex)		Compex Systems Pte Ltd
+04F021     (base 16)		Compex Systems Pte Ltd
+				135 Joo Seng Road, 
+				    368363
+				SG
+
+28-18-FD   (hex)		Aditya Infotech Ltd.
+2818FD     (base 16)		Aditya Infotech Ltd.
+				Khemka Square, A-12, Sector-4,
+				Noida  Uttar Pradesh  201301
+				IN
+
+D8-B9-0E   (hex)		Triple Domain Vision Co.,Ltd.
+D8B90E     (base 16)		Triple Domain Vision Co.,Ltd.
+				No.9, Aly. 1, Ln. 585, Sec.3, Fulin Rd.,
+				Hsinchu Conuty    307
+				TW
+
+34-2F-6E   (hex)		Anywire corporation
+342F6E     (base 16)		Anywire corporation
+				1 Zusyo, Baba
+				Nagaokakyo  Kyoto pref.  617-8550
+				JP
+
+CC-EE-D9   (hex)		VAHLE Automation GmbH
+CCEED9     (base 16)		VAHLE Automation GmbH
+				Egerbach 12a
+				Kufstein   Schwoich Tirol  6334
+				AT
+
+00-5C-B1   (hex)		Gospell DIGITAL TECHNOLOGY CO., LTD
+005CB1     (base 16)		Gospell DIGITAL TECHNOLOGY CO., LTD
+				Block F10-F13¡¢F518 Idea land ¡¢Bao Yuan Road
+				Shenzhen  Guangdong  518102
+				CN
+
+B0-8E-1A   (hex)		URadio Systems Co., Ltd
+B08E1A     (base 16)		URadio Systems Co., Ltd
+				Phase II D202-2, 1355 JinJiHu Blvd
+				Suzhou  Jiangsu  215021
+				CN
+
+D8-E9-52   (hex)		KEOPSYS
+D8E952     (base 16)		KEOPSYS
+				21 RUE LOUIS DE BROGLIE
+				LANNION  BRITANY  22300
+				FR
+
+BC-A4-E1   (hex)		Nabto
+BCA4E1     (base 16)		Nabto
+				Aabogade 15
+				Aarhus  Jutland  8200
+				DK
+
+90-8F-CF   (hex)		UNO System Co., Ltd
+908FCF     (base 16)		UNO System Co., Ltd
+				#402 Kolon Science Valley °., 187-10, Guro-dong, Guro-gu
+				Seoul    152-848
+				KR
+
+40-E7-93   (hex)		Shenzhen Siviton Technology Co.,Ltd
+40E793     (base 16)		Shenzhen Siviton Technology Co.,Ltd
+				4F,Block6,Coolpad Business Centre,North of Keyuan Road,Hi-technology Zone,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-08-31   (hex)		Cisco Systems, Inc
+000831     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+34-D0-9B   (hex)		MobilMAX Technology Inc.
+34D09B     (base 16)		MobilMAX Technology Inc.
+				2F-5, No.28, Tai-Yuan St.
+				Chupei City, Hsinchu Country    302
+				TW
+
+F0-00-7F   (hex)		Janz - Contadores de Energia, SA
+F0007F     (base 16)		Janz - Contadores de Energia, SA
+				Avenida Infante D. Henrique
+				Lisbon    1800-223
+				PT
+
+30-B3-A2   (hex)		Shenzhen Heguang Measurement & Control Technology Co.,Ltd
+30B3A2     (base 16)		Shenzhen Heguang Measurement & Control Technology Co.,Ltd
+				3/F, Tower A, Xiangnian Plaza, 6060 Qiaoxiang Road, 
+				Shenzhen  Guangdong  518053
+				CN
+
+50-60-28   (hex)		Xirrus Inc.
+506028     (base 16)		Xirrus Inc.
+				2101 CORPORATE CENTER DR
+				Thousand Oaks  CALIFORNIA  91320
+				US
+
+00-91-FA   (hex)		Synapse Product Development
+0091FA     (base 16)		Synapse Product Development
+				1511 6th Ave
+				Seattle  WA  98101
+				US
+
+A0-5A-A4   (hex)		Grand Products Nevada, Inc.
+A05AA4     (base 16)		Grand Products Nevada, Inc.
+				751 Pilot Rd.
+				Las Vegas  Nevada  89119
+				US
+
+F0-EE-BB   (hex)		VIPAR GmbH
+F0EEBB     (base 16)		VIPAR GmbH
+				Lichtenbergstrasse 8
+				Garching bei Muenchen  Bavaria  85748
+				DE
+
+6C-E9-07   (hex)		Nokia Corporation
+6CE907     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+E4-FA-1D   (hex)		PAD Peripheral Advanced Design Inc.
+E4FA1D     (base 16)		PAD Peripheral Advanced Design Inc.
+				1400 Hocquart
+				Saint-Bruno  QC  J3V 6E1
+				CA
+
+1C-5C-55   (hex)		PRIMA Cinema, Inc
+1C5C55     (base 16)		PRIMA Cinema, Inc
+				1903 Wright Place, Suite 320
+				Carlsbad  CA  92008
+				US
+
+34-BA-9A   (hex)		Asiatelco Technologies Co.
+34BA9A     (base 16)		Asiatelco Technologies Co.
+				301,#8 Building,#289 Bisheng Road
+				Shanghai    201204
+				CN
+
+50-64-41   (hex)		Greenlee
+506441     (base 16)		Greenlee
+				219 S Main St
+				Dallas  TX  76104
+				US
+
+9C-1F-DD   (hex)		Accupix Inc.
+9C1FDD     (base 16)		Accupix Inc.
+				3F Gaeyang BLDG, 548-1, 
+				Anyang  Kyeonggi-Do  430-730
+				KR
+
+7C-DD-11   (hex)		Chongqing MAS SCI&TECH.Co.,Ltd
+7CDD11     (base 16)		Chongqing MAS SCI&TECH.Co.,Ltd
+				 6th Floor, Zone C2,Hi-tech Venture Park, No.105 Erlang Venture Road
+				Chongqing City    400039
+				CN
+
+B8-FD-32   (hex)		Zhejiang ROICX Microelectronics
+B8FD32     (base 16)		Zhejiang ROICX Microelectronics
+				22 Floor, 1888 Jianghui Road, Binjiang District
+				Hangzhou  Zhejiang  310051
+				CN
+
+70-EE-50   (hex)		Netatmo
+70EE50     (base 16)		Netatmo
+				17 route de la reine
+				Boulogne-Billancourt    92100
+				FR
+
+98-4A-47   (hex)		CHG Hospital Beds
+984A47     (base 16)		CHG Hospital Beds
+				1020 Adelaide St S
+				London  ON  N6E 1R6
+				CA
+
+14-49-78   (hex)		Digital Control Incorporated
+144978     (base 16)		Digital Control Incorporated
+				19625 62nd Ave S
+				Kent  WA  98032
+				US
+
+2C-10-C1   (hex)		Nintendo Co., Ltd.
+2C10C1     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+8C-D1-7B   (hex)		CG Mobile
+8CD17B     (base 16)		CG Mobile
+				3F Caohejing Software Building, No.461 Hongcao Rd.,XuHui District
+				Shanghai    200233
+				CN
+
+50-22-67   (hex)		PixeLINK
+502267     (base 16)		PixeLINK
+				3030 Conroy Road
+				Ottawa  Ontario  K1G 6C2
+				CA
+
+3C-6A-7D   (hex)		Niigata Power Systems Co., Ltd.
+3C6A7D     (base 16)		Niigata Power Systems Co., Ltd.
+				7-26,Tatsumi 3-Chome
+				Koto-ku  TOKYO  135-0053
+				JP
+
+3C-70-59   (hex)		MakerBot Industries
+3C7059     (base 16)		MakerBot Industries
+				87 3rd Avenue
+				Brooklyn  NY  11217
+				US
+
+50-26-90   (hex)		FUJITSU LIMITED
+502690     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+24-B6-57   (hex)		Cisco Systems, Inc
+24B657     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-AF-40   (hex)		marco Systemanalyse und Entwicklung GmbH
+C8AF40     (base 16)		marco Systemanalyse und Entwicklung GmbH
+				Hans-Böckler-Straße 2
+				Dachau  Bavaria  85221
+				DE
+
+40-98-4C   (hex)		Casacom Solutions AG
+40984C     (base 16)		Casacom Solutions AG
+				Badenerstarsse 551
+				Zuerich    8046
+				CH
+
+5C-18-B5   (hex)		Talon Communications
+5C18B5     (base 16)		Talon Communications
+				10636 Scripps Summit Ct.
+				San Diego  CA  92131
+				US
+
+64-E1-61   (hex)		DEP Corp.
+64E161     (base 16)		DEP Corp.
+				Nishi-shinjuku 6-12-7
+				Shinjuku  Tokyo  160-0023
+				JP
+
+88-23-FE   (hex)		TTTech Computertechnik AG
+8823FE     (base 16)		TTTech Computertechnik AG
+				Schoenbrunnerstrasse 7
+				Vienna    1040
+				AT
+
+B8-9A-ED   (hex)		OceanServer Technology, Inc
+B89AED     (base 16)		OceanServer Technology, Inc
+				151 Martine St
+				Fall River  MA  02723
+				US
+
+C8-7D-77   (hex)		Shenzhen Kingtech Communication Equipment Co.,Ltd
+C87D77     (base 16)		Shenzhen Kingtech Communication Equipment Co.,Ltd
+				Floor3.Building A,NO.3,Road 1 of shangxue Dengxinkeng Industry Park,Bantian Street,
+				Shenzhen City  Guangdong  518112
+				CN
+
+94-AE-61   (hex)		Alcatel Lucent
+94AE61     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+5C-CE-AD   (hex)		CDYNE Corporation
+5CCEAD     (base 16)		CDYNE Corporation
+				505 Independence Pkwy Ste 300
+				Chesapeake  VA  23320
+				US
+
+AC-54-EC   (hex)		IEEE P1823 Standards Working Group
+AC54EC     (base 16)		IEEE P1823 Standards Working Group
+				445 Hoes Lane
+				Piscataway  NJ  08854
+				US
+
+70-97-56   (hex)		Happyelectronics Co.,Ltd
+709756     (base 16)		Happyelectronics Co.,Ltd
+				#A-805, Bundang Technopark,
+				Seongnam-Si    463-816
+				KR
+
+B8-20-E7   (hex)		Guangzhou Horizontal Information & Network Integration Co. Ltd
+B820E7     (base 16)		Guangzhou Horizontal Information & Network Integration Co. Ltd
+				Floor 10¬Golden Star Building¬Wushan Hanjing Road¬Tianhe District¬Guangzhou City
+				Guangzhou  Guangdong Province  510630
+				CN
+
+00-CD-90   (hex)		MAS Elektronik AG
+00CD90     (base 16)		MAS Elektronik AG
+				Pollhornbogen 19
+				Hamburg    21107
+				DE
+
+7C-6B-52   (hex)		Tigaro Wireless
+7C6B52     (base 16)		Tigaro Wireless
+				Shen A'ari 7
+				Even Yehuda    40500
+				IL
+
+00-64-A6   (hex)		Maquet CardioVascular
+0064A6     (base 16)		Maquet CardioVascular
+				1300 MacArthur Blvd
+				Mahwah  NJ  07430
+				US
+
+98-8B-AD   (hex)		Corintech Ltd.
+988BAD     (base 16)		Corintech Ltd.
+				Ashford Mill
+				Fordingbridge  Hampshire  SP6 1DZ
+				GB
+
+D4-4B-5E   (hex)		TAIYO YUDEN CO., LTD.
+D44B5E     (base 16)		TAIYO YUDEN CO., LTD.
+				8-1, Sakae-cho
+				Takasaki-shi  Gunma  370-8522
+				JP
+
+64-0E-36   (hex)		TAZTAG
+640E36     (base 16)		TAZTAG
+				Cicea 1
+				Bruz    35170
+				FR
+
+94-1D-1C   (hex)		TLab West Systems AB
+941D1C     (base 16)		TLab West Systems AB
+				Ebbe Lieberathsgatan 23B
+				Gothenburg    41265
+				SE
+
+E4-55-EA   (hex)		Dedicated Computing
+E455EA     (base 16)		Dedicated Computing
+				N26 W23880 Commerce Circle
+				Waukesha  Wisconsin  53188
+				US
+
+B0-5C-E5   (hex)		Nokia Corporation
+B05CE5     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+34-82-DE   (hex)		Kiio Inc
+3482DE     (base 16)		Kiio Inc
+				404 Holtzman Rd
+				Madison  WI  53713
+				US
+
+4C-5F-D2   (hex)		Alcatel-Lucent
+4C5FD2     (base 16)		Alcatel-Lucent
+				777 East Middlefield Road
+				Mountain View  CA  94043
+				US
+
+28-C7-18   (hex)		Altierre
+28C718     (base 16)		Altierre
+				1980 Concourse Drive
+				San Jose  United States  95131
+				US
+
+7C-4C-58   (hex)		Scale Computing, Inc.
+7C4C58     (base 16)		Scale Computing, Inc.
+				2121 El Camino Real
+				San Mateo  UNITED STATES  94403
+				US
+
+10-13-EE   (hex)		Justec International Technology INC.
+1013EE     (base 16)		Justec International Technology INC.
+				7F-2 No 113 Zihyou Road
+				Hsinchu City    30041
+				TW
+
+8C-27-1D   (hex)		QuantHouse
+8C271D     (base 16)		QuantHouse
+				52 Rue de la Victoire
+				Paris    75009
+				FR
+
+38-60-77   (hex)		PEGATRON CORPORATION
+386077     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+70-81-05   (hex)		Cisco Systems, Inc
+708105     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-ED-1A   (hex)		vastriver Technology Co., Ltd
+E0ED1A     (base 16)		vastriver Technology Co., Ltd
+				A-6A Keshi Building,No.28,Xinxi Road,Haidian,
+				Beijing    100085
+				CN
+
+D4-F6-3F   (hex)		IEA S.R.L.
+D4F63F     (base 16)		IEA S.R.L.
+				Eva Peron 4468
+				Rosario  Santa Fe  S2002LBQ 
+				AR
+
+58-B0-D4   (hex)		ZuniData Systems Inc.
+58B0D4     (base 16)		ZuniData Systems Inc.
+				4F-7,  No.65,  Gaotia 7th Rd,  Zhubei City
+				Hsinchu    302
+				TW
+
+64-55-7F   (hex)		NSFOCUS Information Technology Co., Ltd.
+64557F     (base 16)		NSFOCUS Information Technology Co., Ltd.
+				3/F,Ether Building, No.4 Beiwa Rd.,Haidian District
+				Beijing    100089
+				CN
+
+00-08-2F   (hex)		Cisco Systems, Inc
+00082F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-C7-D1   (hex)		SHARP Corporation
+9CC7D1     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+14-90-90   (hex)		KongTop industrial(shen zhen)CO.,LTD
+149090     (base 16)		KongTop industrial(shen zhen)CO.,LTD
+				xinwuyuan,gushu,Xixiang,Baoan,
+				Shenzhen  Guangdong  518000
+				CN
+
+38-DE-60   (hex)		Mohlenhoff GmbH
+38DE60     (base 16)		Mohlenhoff GmbH
+				Museumstraße 54a
+				Salzgitter  Niedersachsen  38229
+				DE
+
+28-39-E7   (hex)		Preceno Technology Pte.Ltd.
+2839E7     (base 16)		Preceno Technology Pte.Ltd.
+				11F, No.207-2, Sec. 3, Beixin Rd., Xindian Dist.
+				New Taipei City    23143
+				TW
+
+68-5E-6B   (hex)		PowerRay Co., Ltd.
+685E6B     (base 16)		PowerRay Co., Ltd.
+				7F-1, No 190, Sec 2, Chung Hsing Road, Sindian District
+				New Taipei City    231
+				TW
+
+20-C8-B3   (hex)		SHENZHEN BUL-TECH CO.,LTD.
+20C8B3     (base 16)		SHENZHEN BUL-TECH CO.,LTD.
+				Area C,4/F,NO.59,Longjing 2nd Road,
+				SHENZHEN   GuangDong  518101
+				CN
+
+F8-E7-B5   (hex)		µTech Tecnologia LTDA
+F8E7B5     (base 16)		µTech Tecnologia LTDA
+				Rua Lauro Linhares, 598
+				Florianopolis  Santa Catarina  88036-200
+				BR
+
+D4-CE-B8   (hex)		Enatel LTD
+D4CEB8     (base 16)		Enatel LTD
+				66 Treffers Road
+				Christchurch  Canterbury  8042
+				NZ
+
+80-7A-7F   (hex)		ABB Genway Xiamen Electrical Equipment CO., LTD
+807A7F     (base 16)		ABB Genway Xiamen Electrical Equipment CO., LTD
+				7F,No.23 Wanghai Road,Software Park 2, Lvling Road, 
+				Xiamen  Fujian Province  361008
+				CN
+
+24-DA-B6   (hex)		Sistemas de Gestión Energética S.A. de C.V
+24DAB6     (base 16)		Sistemas de Gestión Energética S.A. de C.V
+				Calzada de los Fresnos 70-A
+				Zapopan  Jalisoc  45010
+				MX
+
+B0-7D-62   (hex)		Dipl.-Ing. H. Horstmann GmbH
+B07D62     (base 16)		Dipl.-Ing. H. Horstmann GmbH
+				Humboldtstraße 2
+				Heiligenhaus    42579
+				DE
+
+B8-F5-E7   (hex)		WayTools, LLC
+B8F5E7     (base 16)		WayTools, LLC
+				401 Wilshire Blvd.
+				Santa Monica  CA  90401
+				US
+
+B8-19-99   (hex)		Nesys
+B81999     (base 16)		Nesys
+				Energeticheskaya, 1
+				Moscow    111116
+				RU
+
+34-25-5D   (hex)		Shenzhen Loadcom Technology Co.,Ltd
+34255D     (base 16)		Shenzhen Loadcom Technology Co.,Ltd
+				Yuehai Building A-13CD,Nanhai Road,Nanshan Area
+				Shenzhen  Guangdong  518054
+				CN
+
+4C-A7-4B   (hex)		Alcatel Lucent
+4CA74B     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+D0-31-10   (hex)		Ingenic Semiconductor Co.,Ltd
+D03110     (base 16)		Ingenic Semiconductor Co.,Ltd
+				Room 108,Building A,Information Center Zhongguancun Software Park 8 Dongbeiwang West Road,Haidain District
+				Beijing    100193
+				CN
+
+1C-E1-92   (hex)		Qisda Corporation
+1CE192     (base 16)		Qisda Corporation
+				157 Shan-Ying Road
+				Gueishan  Taoyuan  333
+				TW
+
+70-6F-81   (hex)		Private
+706F81     (base 16)		Private
+
+FC-00-12   (hex)		Toshiba Samsung Storage Technolgoy Korea Corporation 
+FC0012     (base 16)		Toshiba Samsung Storage Technolgoy Korea Corporation 
+				14 Floor, Bldg. No. 102, Digital Empire2, 486, Sin-dong, Yeongtong-gu, Suwon-si, 
+				Su-won   Gyeonggi   443-734 
+				KR
+
+18-14-20   (hex)		TEB SAS
+181420     (base 16)		TEB SAS
+				RD294 - Corpeau
+				Meursault  Burgundy  21190
+				FR
+
+AC-81-F3   (hex)		Nokia Corporation
+AC81F3     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+30-68-8C   (hex)		Reach Technology Inc.
+30688C     (base 16)		Reach Technology Inc.
+				4575 Cushing Parkway
+				Fremont  California  94538
+				US
+
+10-EE-D9   (hex)		Canoga Perkins Corporation
+10EED9     (base 16)		Canoga Perkins Corporation
+				20600 Prairie Street
+				Chatsworth  CA  91311
+				US
+
+94-DE-0E   (hex)		SmartOptics AS
+94DE0E     (base 16)		SmartOptics AS
+				Stalfjaera 9
+				Oslo    N-0975
+				NO
+
+C0-29-F3   (hex)		XySystem
+C029F3     (base 16)		XySystem
+				#1304 Daerung Post Tower 5
+				Seoul    153-801
+				KR
+
+AC-4A-FE   (hex)		Hisense Broadband Multimedia Technology Co.,Ltd.
+AC4AFE     (base 16)		Hisense Broadband Multimedia Technology Co.,Ltd.
+				No.11 Jiangxi Road,Shinan District
+				Qingdao City  Shandong Province  266071
+				CN
+
+54-F5-B6   (hex)		ORIENTAL PACIFIC INTERNATIONAL LIMITED
+54F5B6     (base 16)		ORIENTAL PACIFIC INTERNATIONAL LIMITED
+				5 ARGUS PLACE
+				NORTH SHORE CITY  AUCKLAND  0627
+				NZ
+
+90-34-2B   (hex)		Gatekeeper Systems, Inc.
+90342B     (base 16)		Gatekeeper Systems, Inc.
+				8 Studebaker
+				Irvine  CA  92618
+				US
+
+8C-B8-2C   (hex)		IPitomy Communications
+8CB82C     (base 16)		IPitomy Communications
+				1940 Northgate Boulevard
+				Sarasota  Florida  34234
+				US
+
+80-7D-E3   (hex)		Chongqing Sichuan Instrument Microcircuit Co.LTD.
+807DE3     (base 16)		Chongqing Sichuan Instrument Microcircuit Co.LTD.
+				Jinhua Road No.309, Beibei,
+				Chongqing    400700
+				CN
+
+DC-17-5A   (hex)		Hitachi High-Technologies Corporation
+DC175A     (base 16)		Hitachi High-Technologies Corporation
+				794, Higashitoyoi,
+				Kudamatsu City,  Yamaguchi Pref.,  744-0002,
+				JP
+
+C8-A1-BA   (hex)		Neul Ltd
+C8A1BA     (base 16)		Neul Ltd
+				Suite 42 Innovation Centre
+				Cambridge  Cambs  CB4 0EY
+				GB
+
+C4-3A-9F   (hex)		Siconix Inc.
+C43A9F     (base 16)		Siconix Inc.
+				#28, 2333 18th Ave NE
+				Calgary  Alberta  T2E 8T6
+				CA
+
+68-6E-23   (hex)		Wi3 Inc.
+686E23     (base 16)		Wi3 Inc.
+				P.O. Box 1123
+				Pittsford  NY  14534
+				US
+
+DC-F0-5D   (hex)		Letta Teknoloji
+DCF05D     (base 16)		Letta Teknoloji
+				TUBITAK Teknoloji Gelistirme Bolgesi
+				KOCAELI    41455
+				TR
+
+5C-16-C7   (hex)		Big Switch Networks
+5C16C7     (base 16)		Big Switch Networks
+				100 W Evelyn
+				Mountain View  CA  94041
+				US
+
+84-8F-69   (hex)		Dell Inc.
+848F69     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+3C-09-6D   (hex)		Powerhouse Dynamics
+3C096D     (base 16)		Powerhouse Dynamics
+				1 Bridge Street
+				Newton  MA  02458
+				US
+
+90-0D-66   (hex)		Digimore Electronics Co., Ltd
+900D66     (base 16)		Digimore Electronics Co., Ltd
+				10 FL., No. 61, Yan-Ping South Road
+				Taipei    100
+				TW
+
+0C-92-4E   (hex)		Rice Lake Weighing Systems
+0C924E     (base 16)		Rice Lake Weighing Systems
+				230 West Coleman St
+				Rice Lake  WI  54868
+				US
+
+F4-94-61   (hex)		NexGen Storage
+F49461     (base 16)		NexGen Storage
+				400 Centennial Blvd.
+				Louisville  CO  80027
+				US
+
+B8-CD-A7   (hex)		Maxeler Technologies Ltd.
+B8CDA7     (base 16)		Maxeler Technologies Ltd.
+				1 Down Place
+				London  UK  W6 9JH
+				GB
+
+54-35-DF   (hex)		Symeo GmbH
+5435DF     (base 16)		Symeo GmbH
+				Prof.-Messerschmitt-Str. 3
+				Neubiberg  Bavaria  85579
+				DE
+
+F4-3D-80   (hex)		FAG Industrial Services GmbH
+F43D80     (base 16)		FAG Industrial Services GmbH
+				Kaiserstrasse 100
+				Herzogenrath  NRW  52134
+				DE
+
+F0-DB-30   (hex)		Yottabyte
+F0DB30     (base 16)		Yottabyte
+				1750 S. Telegraph Road
+				Bloomfield Twp.  MI  48302
+				US
+
+9C-31-B6   (hex)		Kulite Semiconductor Products Inc
+9C31B6     (base 16)		Kulite Semiconductor Products Inc
+				1 Willow Tree Rd
+				Leonia  NJ  07605
+				US
+
+A4-B3-6A   (hex)		JSC SDO Chromatec
+A4B36A     (base 16)		JSC SDO Chromatec
+				94, Stroiteley street
+				Yoshkar-Ola  Mari El republic  424000
+				RU
+
+E4-DD-79   (hex)		En-Vision America, Inc.
+E4DD79     (base 16)		En-Vision America, Inc.
+				1845 Hovey Ave
+				Normal  IL  61761
+				US
+
+E8-CC-32   (hex)		Micronet  LTD
+E8CC32     (base 16)		Micronet  LTD
+				Hametzuda 27
+				Azor    58001
+				IL
+
+D4-3A-E9   (hex)		DONGGUAN ipt INDUSTRIAL CO., LTD
+D43AE9     (base 16)		DONGGUAN ipt INDUSTRIAL CO., LTD
+				No.66-1.Ist New Area, Nanshe Dist., Chigang,Humen,
+				Dongguan  Guangdong  52390
+				CN
+
+58-98-35   (hex)		Technicolor
+589835     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+8C-5C-A1   (hex)		d-broad,INC
+8C5CA1     (base 16)		d-broad,INC
+				3-17-5 ShinYokohama Kouhoku-Ku
+				Yokohama  Kanagawa  222-0033
+				JP
+
+18-F6-50   (hex)		Multimedia Pacific Limited
+18F650     (base 16)		Multimedia Pacific Limited
+				1 Matheson Street, Shell Tower 29F/12
+				    000000
+				HK
+
+68-84-70   (hex)		eSSys Co.,Ltd
+688470     (base 16)		eSSys Co.,Ltd
+				Daerung Post Tower 5 15F, 60-3
+				Seoul  Geumcheon-gu  153-702
+				KR
+
+48-DC-FB   (hex)		Nokia Corporation
+48DCFB     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+20-B7-C0   (hex)		OMICRON electronics GmbH
+20B7C0     (base 16)		OMICRON electronics GmbH
+				Oberes Ried 1
+				Klaus    6833
+				AT
+
+80-58-C5   (hex)		NovaTec Kommunikationstechnik GmbH
+8058C5     (base 16)		NovaTec Kommunikationstechnik GmbH
+				Technologiepark 9
+				Paderborn  NRW  33100
+				DE
+
+B8-C7-16   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+B8C716     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D4-2C-3D   (hex)		Sky Light Digital Limited
+D42C3D     (base 16)		Sky Light Digital Limited
+				Rm. 1009 Kwong Sang Hong Centre, 151-153 Hoi Bun Road, Kwun Tong, Kowloon, 
+				Hong Kong    999077
+				CN
+
+A4-5A-1C   (hex)		smart-electronic GmbH
+A45A1C     (base 16)		smart-electronic GmbH
+				Industriestrasse 29
+				St. Georgen  Baden-Württemberg  78122
+				DE
+
+80-64-59   (hex)		Nimbus Inc.
+806459     (base 16)		Nimbus Inc.
+				1359 Gwanpyeong-dong, Yuseong-gu
+				Daejeon    305-509
+				KR
+
+8C-89-A5   (hex)		Micro-Star INT'L CO., LTD
+8C89A5     (base 16)		Micro-Star INT'L CO., LTD
+				No.69, Lide st.
+				Taipei County    235
+				TW
+
+B4-A5-A9   (hex)		MODI GmbH
+B4A5A9     (base 16)		MODI GmbH
+				Kapellenweg 21
+				REICHSHOF-Sinspert    51580
+				DE
+
+E8-C3-20   (hex)		Austco Communication Systems Pty Ltd
+E8C320     (base 16)		Austco Communication Systems Pty Ltd
+				40 O'Malley Street
+				Osborne Park  Western Australia  6017
+				AU
+
+C4-36-DA   (hex)		Rusteletech Ltd.
+C436DA     (base 16)		Rusteletech Ltd.
+				Ordzhonikidze Str. 11, Bldg. 40, Off. 15 
+				Moscow    115419
+				RU
+
+04-32-F4   (hex)		Partron
+0432F4     (base 16)		Partron
+				22-6, Seokwoo-dong
+				Hwaseong-si  Gyeonggi-do  445-170
+				KR
+
+1C-18-4A   (hex)		ShenZhen RicherLink Technologies Co.,LTD
+1C184A     (base 16)		ShenZhen RicherLink Technologies Co.,LTD
+				703,Building W1-A,High-Tech Industrial Park,KeJiNan 1st Road,NanShan,
+				ShenZhen  GuangDong  518057
+				CN
+
+0C-39-56   (hex)		Observator instruments
+0C3956     (base 16)		Observator instruments
+				Rietdekkerstraat 6
+				Ridderkerk  Zuid Holland  2984 BM
+				NL
+
+DC-A6-BD   (hex)		Beijing Lanbo Technology Co., Ltd.
+DCA6BD     (base 16)		Beijing Lanbo Technology Co., Ltd.
+				Room.301.Bidg.4NO.8 Shangdi West Road, Haidian  District,
+				Beijing City    100085
+				CN
+
+10-C5-86   (hex)		BIO SOUND LAB CO., LTD.
+10C586     (base 16)		BIO SOUND LAB CO., LTD.
+				Suite 311, 312 SKn Techno Park 
+				Seongnam-si  Gyeonggi-do,  462-721
+				KR
+
+10-76-8A   (hex)		EoCell
+10768A     (base 16)		EoCell
+				149 Beaconsfield Street
+				Silverwater  NSW  2128
+				AU
+
+F4-4E-FD   (hex)		Actions Semiconductor Co.,Ltd.(Cayman Islands)
+F44EFD     (base 16)		Actions Semiconductor Co.,Ltd.(Cayman Islands)
+				Po Box 309GT,Ugland House,South Church Street,
+				George Town  Grand Cayman  
+				KY
+
+24-B8-D2   (hex)		Opzoon Technology Co.,Ltd.
+24B8D2     (base 16)		Opzoon Technology Co.,Ltd.
+				11th floor, Tower B£¬Yintai Center 2 Jianguomenwai St,.
+				Beijing  Asia  100022
+				CN
+
+A4-99-81   (hex)		FuJian Elite Power Tech CO.,LTD.
+A49981     (base 16)		FuJian Elite Power Tech CO.,LTD.
+				8th Floor£¬56 GuanRi Road 
+				Xiamen  Fujian  361009
+				CN
+
+B8-3A-7B   (hex)		Worldplay (Canada) Inc.
+B83A7B     (base 16)		Worldplay (Canada) Inc.
+				803 - 24th Ave SE, Unit 200
+				Calgary  Alberta  T2G 1P5
+				CA
+
+14-07-E0   (hex)		Abrantix AG
+1407E0     (base 16)		Abrantix AG
+				Foerrlibuckstrasse 66
+				Zuerich  ZH  8005
+				CH
+
+DC-CF-94   (hex)		Beijing Rongcheng Hutong Technology Co., Ltd.
+DCCF94     (base 16)		Beijing Rongcheng Hutong Technology Co., Ltd.
+				Room 401A,Building No.4,Yard No.5,
+				  Beijing  100024
+				CN
+
+A4-DB-2E   (hex)		Kingspan Environmental Ltd
+A4DB2E     (base 16)		Kingspan Environmental Ltd
+				180 Gilford Road
+				Portadown  Armagh  BT63 5LF
+				GB
+
+C8-FE-30   (hex)		Bejing DAYO Mobile Communication Technology Ltd.
+C8FE30     (base 16)		Bejing DAYO Mobile Communication Technology Ltd.
+				Room 712, ULO Park Building No. 601E
+				Beijing    100102
+				CN
+
+E4-D7-1D   (hex)		Oraya Therapeutics
+E4D71D     (base 16)		Oraya Therapeutics
+				8000 Jarvis Avenue  Ste. 200
+				Newark  CA  94560
+				US
+
+24-C9-DE   (hex)		Genoray
+24C9DE     (base 16)		Genoray
+				#812 Byucksan Technopia 434-6 Sangdaewon 1-Dong
+				Seongnam-City  Gyeonggi-Do  462-716
+				KR
+
+54-05-5F   (hex)		Alcatel Lucent
+54055F     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+6C-5D-63   (hex)		ShenZhen Rapoo Technology Co., Ltd.
+6C5D63     (base 16)		ShenZhen Rapoo Technology Co., Ltd.
+				Block A1,B1,B2,1st second stage, 1st Industrial Park, 3rd Industrial Zone ,Fenghuang Fuyong, BaoAn 
+				ShenZhen    518103
+				CN
+
+94-16-73   (hex)		Point Core SARL
+941673     (base 16)		Point Core SARL
+				29/31 Rue du Bois Galon
+				FONTENAY SOUS BOIS  Ile de France  94120
+				FR
+
+5C-56-ED   (hex)		3pleplay Electronics Private Limited
+5C56ED     (base 16)		3pleplay Electronics Private Limited
+				Plot No 54, Eshwarapuri Colony
+				Hyderabad  Andhra Pradesh  500083
+				IN
+
+78-02-8F   (hex)		Adaptive Spectrum and Signal Alignment (ASSIA), Inc.
+78028F     (base 16)		Adaptive Spectrum and Signal Alignment (ASSIA), Inc.
+				333 Twin Dolphin Drive
+				Redwood City  CA  94065
+				US
+
+DC-16-A2   (hex)		Medtronic Diabetes
+DC16A2     (base 16)		Medtronic Diabetes
+				18000 Devonshire St
+				Northridge  CA  91325
+				US
+
+30-8C-FB   (hex)		Dropcam
+308CFB     (base 16)		Dropcam
+				160 Spear Street
+				San Francisco  CA  94105
+				US
+
+D0-EB-9E   (hex)		Seowoo Inc.
+D0EB9E     (base 16)		Seowoo Inc.
+				#B101 Seojung B/D, 590-9 Guui-dong, Gwangjin-gu,
+				Seoul    143-831
+				KR
+
+BC-CD-45   (hex)		VOISMART
+BCCD45     (base 16)		VOISMART
+				VIA BENIGNO CRESPI 12
+				MILANO    20159
+				IT
+
+14-3E-60   (hex)		Nokia
+143E60     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+70-32-D5   (hex)		Athena Wireless Communications Inc
+7032D5     (base 16)		Athena Wireless Communications Inc
+				12425 W Bell Rd
+				Surprise  AZ  85378
+				US
+
+78-51-0C   (hex)		LiveU Ltd.
+78510C     (base 16)		LiveU Ltd.
+				5 Hagavish St.
+				Kfar-Saba    44641
+				IL
+
+44-AA-E8   (hex)		Nanotec Electronic GmbH & Co. KG
+44AAE8     (base 16)		Nanotec Electronic GmbH & Co. KG
+				Gewerbestrasse 11
+				Landsham  Bavaria  85652
+				DE
+
+D4-28-B2   (hex)		ioBridge, Inc.
+D428B2     (base 16)		ioBridge, Inc.
+				225 Cedar Hill Street
+				Marlborough  MA  01752
+				US
+
+84-27-CE   (hex)		Corporation of the Presiding Bishop of The Church of Jesus Christ of Latter-day Saints
+8427CE     (base 16)		Corporation of the Presiding Bishop of The Church of Jesus Christ of Latter-day Saints
+				Audiovisual Engineering - 2LL
+				Salt Lake City  UT  84150
+				US
+
+48-D8-FE   (hex)		ClarIDy Solutions, Inc.
+48D8FE     (base 16)		ClarIDy Solutions, Inc.
+				7F, No.9, ParkAvenue II Rd., Hsinchu Science Park, 
+				Hsinchu    300
+				TW
+
+D4-94-5A   (hex)		COSMO CO., LTD
+D4945A     (base 16)		COSMO CO., LTD
+				1-12, Higashi-Gotanda 2-chome
+				Shinagawa-ku  Tokyo  141-0022
+				JP
+
+30-4C-7E   (hex)		Panasonic Electric Works Automation Controls Techno Co.,Ltd.
+304C7E     (base 16)		Panasonic Electric Works Automation Controls Techno Co.,Ltd.
+				2-9-18 Chidori
+				Oota-ku  Tokyo  146-8540
+				JP
+
+5C-F2-07   (hex)		Speco Technologies
+5CF207     (base 16)		Speco Technologies
+				200 New Highway
+				Amityville  New York  11701
+				US
+
+B4-2A-39   (hex)		ORBIT MERRET, spol. s r. o.
+B42A39     (base 16)		ORBIT MERRET, spol. s r. o.
+				Vodnanska 675/30
+				Praha    198 00
+				CZ
+
+70-E8-43   (hex)		Beijing C&W Optical Communication Technology Co.,Ltd.
+70E843     (base 16)		Beijing C&W Optical Communication Technology Co.,Ltd.
+				2/F Yufa Plaza, No.19 Xiaoying Beilu, Chaoyang District, 
+				Beijing    100101
+				CN
+
+2C-7E-CF   (hex)		Onzo Ltd
+2C7ECF     (base 16)		Onzo Ltd
+				6 Great Newport Street
+				London    WC2H 7JB
+				GB
+
+10-37-11   (hex)		Simlink AS
+103711     (base 16)		Simlink AS
+				Otto Nielsens Veg 12
+				Trondheim    N-7004
+				NO
+
+50-E5-49   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+50E549     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+B4-B8-8D   (hex)		Thuh Company
+B4B88D     (base 16)		Thuh Company
+				605  Territorial Dr
+				Bolingbrook  IL  60440
+				US
+
+4C-73-A5   (hex)		KOVE
+4C73A5     (base 16)		KOVE
+				14 N. Peoria Street
+				Chicago  IL  60607
+				US
+
+70-A4-1C   (hex)		Advanced Wireless Dynamics S.L.
+70A41C     (base 16)		Advanced Wireless Dynamics S.L.
+				Centro de Empresas UPM oficina 3
+				Pozuelo de Alarcon  Madrid  28223
+				ES
+
+BC-BB-C9   (hex)		Kellendonk Elektronik GmbH
+BCBBC9     (base 16)		Kellendonk Elektronik GmbH
+				Butzweilerhof Allee 4
+				Cologne  NRW  50829
+				DE
+
+E4-2A-D3   (hex)		Magneti Marelli S.p.A. Powertrain
+E42AD3     (base 16)		Magneti Marelli S.p.A. Powertrain
+				Via del Timavo 33
+				Bologna    40128
+				IT
+
+E8-3E-B6   (hex)		RIM
+E83EB6     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+BC-35-E5   (hex)		Hydro Systems Company
+BC35E5     (base 16)		Hydro Systems Company
+				3798 Round Bottom Road
+				Cincinnati  Ohio  45244
+				US
+
+9C-5D-95   (hex)		VTC Electronics Corp.
+9C5D95     (base 16)		VTC Electronics Corp.
+				5F,No.21,Sec.6,Zhongxiao E.Rd.,Nangang District
+				Taipei    11575
+				TW
+
+B8-A8-AF   (hex)		Logic S.p.A.
+B8A8AF     (base 16)		Logic S.p.A.
+				Via Galilei 5
+				Cassina de' Pecchi  MI  20060
+				IT
+
+60-F6-73   (hex)		TERUMO CORPORATION
+60F673     (base 16)		TERUMO CORPORATION
+				1500,Inokuchi,Nakai-machi
+				Ashigarakami-gun  Kanagawa  259-0151
+				JP
+
+28-CC-FF   (hex)		Corporacion Empresarial Altra SL
+28CCFF     (base 16)		Corporacion Empresarial Altra SL
+				Marie Curie 21
+				Malaga    29590
+				ES
+
+94-FD-1D   (hex)		WhereWhen Corp
+94FD1D     (base 16)		WhereWhen Corp
+				96A Flynn Avenue
+				Mountain View  California  94043
+				US
+
+4C-07-C9   (hex)		COMPUTER OFFICE Co.,Ltd.
+4C07C9     (base 16)		COMPUTER OFFICE Co.,Ltd.
+				1368-10 Muramatsu-cho
+				Ise-shi  Mie-ken  515-0507
+				JP
+
+F8-76-9B   (hex)		Neopis Co., Ltd.
+F8769B     (base 16)		Neopis Co., Ltd.
+				#401 Neo bd., 196-44 Anyang7-Dong
+				Anyang  Kyonggi-Do  430-857
+				KR
+
+74-B0-0C   (hex)		Network Video Technologies, Inc
+74B00C     (base 16)		Network Video Technologies, Inc
+				4005 Bohannon Drive
+				Menlo Park  CA  94025
+				US
+
+E8-40-40   (hex)		Cisco Systems, Inc
+E84040     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-9D-B9   (hex)		eMegatech International Corp.
+D89DB9     (base 16)		eMegatech International Corp.
+				Room 403, No.24 Wucyuan 2nd Rd.,
+				Sinjhuang City, Taipei County,    238
+				TW
+
+40-5A-9B   (hex)		ANOVO
+405A9B     (base 16)		ANOVO
+				ZI de Bracheux 
+				BEAUVAIS    60000
+				FR
+
+E0-69-95   (hex)		PEGATRON CORPORATION
+E06995     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+84-DE-3D   (hex)		Crystal Vision Ltd
+84DE3D     (base 16)		Crystal Vision Ltd
+				Lion Technology park
+				Whittlesford/ Cambridge  Cambs  CB22 4WL
+				GB
+
+D0-75-BE   (hex)		Reno A&E
+D075BE     (base 16)		Reno A&E
+				4655 Aircenter Circle
+				Reno  Nevada  89502
+				US
+
+BC-6E-76   (hex)		Green Energy Options Ltd
+BC6E76     (base 16)		Green Energy Options Ltd
+				3 St. Mary's Court, Main Street
+				Cambridge  Cambridgeshire  CB23 7QS
+				GB
+
+E8-28-D5   (hex)		Cots Technology
+E828D5     (base 16)		Cots Technology
+				C-702, Bundang Techno Park, 145,
+				Sungnam-City  Kyounggi-do  463-760
+				KR
+
+F8-DA-F4   (hex)		Taishan Online Technology Co., Ltd.
+F8DAF4     (base 16)		Taishan Online Technology Co., Ltd.
+				4/F Fangda Building, South Area, Hi-tech Industial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+08-D5-C0   (hex)		Seers Technology Co., Ltd
+08D5C0     (base 16)		Seers Technology Co., Ltd
+				1210 Techcenter, SKnTechnopark, 190-1
+				Seongnam-si  Gyeonggi-do  462-721
+				KR
+
+6C-33-A9   (hex)		Magicjack LP
+6C33A9     (base 16)		Magicjack LP
+				5700 Georgia Avenue
+				West Palm Beach  FL  33405
+				US
+
+10-8C-CF   (hex)		Cisco Systems, Inc
+108CCF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-E3-AE   (hex)		CIRTEC MEDICAL SYSTEMS
+D8E3AE     (base 16)		CIRTEC MEDICAL SYSTEMS
+				101B Cooper Court
+				Los Gatos  CA  95032
+				US
+
+08-B7-EC   (hex)		Wireless Seismic
+08B7EC     (base 16)		Wireless Seismic
+				13100 SW Freeway
+				Sugar Land  TX  77478
+				US
+
+18-AF-9F   (hex)		DIGITRONIC Automationsanlagen GmbH
+18AF9F     (base 16)		DIGITRONIC Automationsanlagen GmbH
+				Auf der Langwies 1
+				Wallbach  Hessen  65510
+				DE
+
+00-B3-42   (hex)		MacroSAN Technologies Co., Ltd.
+00B342     (base 16)		MacroSAN Technologies Co., Ltd.
+				Room 102, No.2 Building
+				Hangzhou  Zhejiang  310052
+				CN
+
+1C-F5-E7   (hex)		Turtle Industry Co., Ltd.
+1CF5E7     (base 16)		Turtle Industry Co., Ltd.
+				1-12-4 Nishineminami
+				Tsutiura  Ibaraki  300-0842
+				JP
+
+98-0E-E4   (hex)		Private
+980EE4     (base 16)		Private
+
+44-7D-A5   (hex)		VTION INFORMATION TECHNOLOGY (FUJIAN) CO.,LTD
+447DA5     (base 16)		VTION INFORMATION TECHNOLOGY (FUJIAN) CO.,LTD
+				Room 502, Wing A, World Trade Center
+				 Beijing,     
+				CN
+
+0C-CD-D3   (hex)		EASTRIVER TECHNOLOGY CO., LTD.
+0CCDD3     (base 16)		EASTRIVER TECHNOLOGY CO., LTD.
+				30 JINNIU XINCUN
+				DONGGUAN  GUANGDONG  523010
+				CN
+
+E4-6C-21   (hex)		messMa GmbH
+E46C21     (base 16)		messMa GmbH
+				Am Stadtfeld 8
+				Ixleben  Sachsen-Anhalt  39167
+				DE
+
+00-B0-33   (hex)		OAO Izhevskiy radiozavod
+00B033     (base 16)		OAO Izhevskiy radiozavod
+				19 Bazisnaya street
+				Izhevsk  Udmurt Republic  426034
+				RU
+
+08-17-35   (hex)		Cisco Systems, Inc
+081735     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-9C-1D   (hex)		Cisco Systems, Inc
+C89C1D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E4-37-D7   (hex)		HENRI DEPAEPE S.A.S.
+E437D7     (base 16)		HENRI DEPAEPE S.A.S.
+				75/77 RUE DU PRE BROCHET
+				SANNOIS    95112
+				FR
+
+E0-A1-D7   (hex)		SFR
+E0A1D7     (base 16)		SFR
+				40/42 Quai du point du jour
+				Boulogne Billancourt  Hauts de Seine  92659
+				FR
+
+94-81-A4   (hex)		Azuray Technologies
+9481A4     (base 16)		Azuray Technologies
+				7470 SW Bridgeport Rd
+				Durham  OR  97224
+				US
+
+BC-E0-9D   (hex)		Eoslink
+BCE09D     (base 16)		Eoslink
+				#602, 900-1
+				Anyang-City  Kyonggi-Do  431-060
+				KR
+
+9C-22-0E   (hex)		TASCAN Systems GmbH
+9C220E     (base 16)		TASCAN Systems GmbH
+				Max-Planck-Str. 38
+				Cologne  Köln  50858
+				DE
+
+7C-DD-90   (hex)		Shenzhen Ogemray Technology Co., Ltd.
+7CDD90     (base 16)		Shenzhen Ogemray Technology Co., Ltd.
+				3 Floor, 9 Building, Minxing Industrial Zone,
+				Shenzhen  Guangdong  518131
+				CN
+
+0C-3C-65   (hex)		Dome Imaging Inc
+0C3C65     (base 16)		Dome Imaging Inc
+				400 Fifth Av
+				Waltham  MA  02451
+				US
+
+C8-DF-7C   (hex)		Nokia Corporation
+C8DF7C     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+B4-4C-C2   (hex)		NR ELECTRIC CO., LTD
+B44CC2     (base 16)		NR ELECTRIC CO., LTD
+				69,Suyuan Avenue
+				Nanjing  Jiangsu  211102
+				CN
+
+48-CB-6E   (hex)		Cello Electronics (UK) Ltd
+48CB6E     (base 16)		Cello Electronics (UK) Ltd
+				Cliff Lodge
+				Leyburn  North Yorkshire  DL8 5NS
+				GB
+
+BC-43-77   (hex)		Hang Zhou Huite Technology Co.,ltd.
+BC4377     (base 16)		Hang Zhou Huite Technology Co.,ltd.
+				Rm1338,Block A¬FuLi Technology Building ,No.328,WenEr Rd
+				Hang Zhou  Zhe Jiang  310012
+				CN
+
+CC-76-69   (hex)		SEETECH
+CC7669     (base 16)		SEETECH
+				19-15, Seoku-dong
+				Hwasung-si  Gyeonggi-do  445-170
+				KR
+
+AC-20-AA   (hex)		DMATEK Co., Ltd.
+AC20AA     (base 16)		DMATEK Co., Ltd.
+				11F.-2, No.386, Shizheng Rd., Xitun Dist.,
+				Taichung    40757
+				TW
+
+FC-AF-6A   (hex)		Qulsar Inc
+FCAF6A     (base 16)		Qulsar Inc
+				Torshamnsgatan 35
+				Kista    SE-16440
+				SE
+
+34-6F-92   (hex)		White Rodgers Division
+346F92     (base 16)		White Rodgers Division
+				8100 West Florissant
+				St. Louis  MO  63136
+				US
+
+34-BD-F9   (hex)		Shanghai WDK Industrial Co.,Ltd.
+34BDF9     (base 16)		Shanghai WDK Industrial Co.,Ltd.
+				No.2100,Songzhen Road,Songjiang District
+				Shanghai    201606
+				CN
+
+CC-BE-71   (hex)		OptiLogix BV
+CCBE71     (base 16)		OptiLogix BV
+				Joop Geesinkweg 999
+				Amsterdam  NH  1096AZ
+				NL
+
+0C-46-9D   (hex)		MS Sedco
+0C469D     (base 16)		MS Sedco
+				8701 Castle Park Drive
+				Indianapolis    46256
+				US
+
+B0-9A-E2   (hex)		STEMMER IMAGING GmbH
+B09AE2     (base 16)		STEMMER IMAGING GmbH
+				Gutenbergstraße 11
+				Puchheim  By  82178
+				DE
+
+14-EE-9D   (hex)		AirNav Systems LLC
+14EE9D     (base 16)		AirNav Systems LLC
+				4660 La Jolla Village Dr. - Suite 500
+				San Diego  California  CA 92122
+				US
+
+78-D0-04   (hex)		Neousys Technology Inc.
+78D004     (base 16)		Neousys Technology Inc.
+				13F.-1, NO.1, BAOSHENG RD., 
+				YONGHE CITY  TAIPEI COUNTY   23444
+				TW
+
+88-95-B9   (hex)		Unified Packet Systems Crop
+8895B9     (base 16)		Unified Packet Systems Crop
+				1F., No32,Lane 15,SEC 6, MinQuan E Rd., 
+				Taipei  Neihu  114
+				TW
+
+D8-FE-8F   (hex)		IDFone Co., Ltd.
+D8FE8F     (base 16)		IDFone Co., Ltd.
+				7F Ace techno tower 5th B/D, 197-22
+				Guro-dong, Guro-gu  Seoul  152-766
+				KR
+
+88-8C-19   (hex)		Brady Corp Asia Pacific Ltd
+888C19     (base 16)		Brady Corp Asia Pacific Ltd
+				1, Kaki Bukit Crescent
+				    416236
+				SG
+
+44-8C-52   (hex)		KTIS CO., Ltd
+448C52     (base 16)		KTIS CO., Ltd
+				1208ho-103dong
+				Ojung-Gu, Bucheon-si  Gyeonggi-do  421-808
+				KR
+
+00-6D-FB   (hex)		Vutrix Technologies Ltd
+006DFB     (base 16)		Vutrix Technologies Ltd
+				Unit 1 Red Lodge Business Park
+				Weston-super-mare  North Somerset  BS24 7TN
+				GB
+
+84-18-88   (hex)		Juniper Networks
+841888     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-67-B5   (hex)		Alcatel-Lucent
+9067B5     (base 16)		Alcatel-Lucent
+				600-700 Mountain Ave.
+				Murray Hiill  NJ  07974-0636
+				US
+
+E0-F3-79   (hex)		Vaddio
+E0F379     (base 16)		Vaddio
+				9433 Science Center Drive
+				New Hope  MN  55428
+				US
+
+78-B6-C1   (hex)		AOBO Telecom Co.,Ltd
+78B6C1     (base 16)		AOBO Telecom Co.,Ltd
+				Room1508,Jiangong Building
+				Hangzhou  ZheJiang   310012
+				CN
+
+08-D2-9A   (hex)		Proformatique
+08D29A     (base 16)		Proformatique
+				10 bis rue Lucien Voilin
+				Puteaux    92800
+				FR
+
+C8-93-83   (hex)		Embedded Automation, Inc.
+C89383     (base 16)		Embedded Automation, Inc.
+				17345 Abbey Drive
+				Surrey  BC  V4N 4M3
+				CA
+
+78-A0-51   (hex)		iiNet Labs Pty Ltd 
+78A051     (base 16)		iiNet Labs Pty Ltd 
+				Level 1
+				Subiaco  WA  6008
+				AU
+
+80-4F-58   (hex)		ThinkEco, Inc.
+804F58     (base 16)		ThinkEco, Inc.
+				303 Fifth Avenue
+				New York  NY  10016
+				US
+
+04-75-F5   (hex)		CSST
+0475F5     (base 16)		CSST
+				Building 6, CSST industrial park, Tong fuyu Industrial zone
+				Shenzhen  Guangdong  518107
+				CN
+
+8C-4D-EA   (hex)		Cerio Corporation
+8C4DEA     (base 16)		Cerio Corporation
+				5F., No.88, Mincyuan Rd., Sindian City
+				Taipei County    23141
+				TW
+
+24-BA-30   (hex)		Technical Consumer Products, Inc.
+24BA30     (base 16)		Technical Consumer Products, Inc.
+				325 Campus Drive
+				Aurora  OH  44202
+				US
+
+18-8E-D5   (hex)		TP Vision Belgium N.V. - innovation site Brugge
+188ED5     (base 16)		TP Vision Belgium N.V. - innovation site Brugge
+				Pathoekeweg 11
+				Bruges  West Flanders  8000
+				BE
+
+E8-0C-38   (hex)		DAEYOUNG INFORMATION SYSTEM CO., LTD
+E80C38     (base 16)		DAEYOUNG INFORMATION SYSTEM CO., LTD
+				#826 TAMNIP-DONG, YUSEONG-GO, 
+				DAEJON    305-510
+				KR
+
+E0-8A-7E   (hex)		Exponent
+E08A7E     (base 16)		Exponent
+				149 Commonwealth Drive
+				Menlo Park  CA  94025
+				US
+
+A8-B0-AE   (hex)		LEONI 
+A8B0AE     (base 16)		LEONI 
+				3945 Freedom Circle
+				Santa Clara  California  95054
+				US
+
+E4-27-71   (hex)		Smartlabs
+E42771     (base 16)		Smartlabs
+				72, Oktyabrskaya Street
+				Moscow    127521
+				RU
+
+34-DF-2A   (hex)		Fujikon Industrial Co.,Limited
+34DF2A     (base 16)		Fujikon Industrial Co.,Limited
+				16/F., Tower 1, Grand Central Plaza,138 Shatin Rural 
+				    523930
+				HK
+
+2C-DD-0C   (hex)		Discovergy GmbH
+2CDD0C     (base 16)		Discovergy GmbH
+				Pascalstraße 15
+				Aachen  NRW  52076
+				DE
+
+40-B2-C8   (hex)		Nortel Networks
+40B2C8     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+70-A1-91   (hex)		Trendsetter Medical, LLC
+70A191     (base 16)		Trendsetter Medical, LLC
+				2030 Ardmore BLVD
+				Pittsburgh  PA  15221
+				US
+
+70-8B-78   (hex)		citygrow technology co., ltd
+708B78     (base 16)		citygrow technology co., ltd
+				rm1404, blk A, ,5 - 21 Pak Tin Par Street
+				Tsuen Wan    
+				HK
+
+64-31-7E   (hex)		Dexin Corporation
+64317E     (base 16)		Dexin Corporation
+				14F-8, No. 258, Lian Cheng Rd.
+				Chung Ho City, Taipei Hsien    235
+				TW
+
+3C-99-F7   (hex)		Lansentechnology AB
+3C99F7     (base 16)		Lansentechnology AB
+				Rörkullsvägen 4
+				Halmstad    30241
+				SE
+
+50-7D-02   (hex)		BIODIT
+507D02     (base 16)		BIODIT
+				Calle Gustave Eiffel 3
+				Paterna  Valencia  46980
+				ES
+
+B4-A4-E3   (hex)		Cisco Systems, Inc
+B4A4E3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+8C-1F-94   (hex)		RF Surgical System Inc. 
+8C1F94     (base 16)		RF Surgical System Inc. 
+				9740 Appaloosa Road 
+				San Diego   CA  92131
+				US
+
+44-91-DB   (hex)		Shanghai Huaqin Telecom Technology Co.,Ltd
+4491DB     (base 16)		Shanghai Huaqin Telecom Technology Co.,Ltd
+				No.1 Building,399 Keyuan Road, Zhangjian Hi-Tech Park,
+				shanghai  shanghai  201203
+				CN
+
+14-D7-6E   (hex)		CONCH ELECTRONIC Co.,Ltd
+14D76E     (base 16)		CONCH ELECTRONIC Co.,Ltd
+				No.3 Keji 1st Load.
+				Tainan    70955
+				TW
+
+AC-83-F0   (hex)		ImmediaTV Corporation
+AC83F0     (base 16)		ImmediaTV Corporation
+				2005 De La Cruz Blvd
+				Santa Clara  California  95050
+				US
+
+CC-6B-98   (hex)		Minetec Wireless Technologies
+CC6B98     (base 16)		Minetec Wireless Technologies
+				10 Kembla Way
+				Willetton  WA  6155
+				AU
+
+3C-04-BF   (hex)		PRAVIS SYSTEMS Co.Ltd.,
+3C04BF     (base 16)		PRAVIS SYSTEMS Co.Ltd.,
+				4F, 5F Jaeyoon Bld, 75-3 Yangjae-Dong,
+				Seoul  Seocho-Gu  137-889
+				KR
+
+94-DD-3F   (hex)		A+V Link Technologies, Corp.
+94DD3F     (base 16)		A+V Link Technologies, Corp.
+				5F., No.550, Xianzheng 2nd Rd.
+				Zhubei City  Hsinchu Country  30268
+				TW
+
+F4-42-27   (hex)		S & S Research Inc.
+F44227     (base 16)		S & S Research Inc.
+				89 Access Rd #10
+				Norwood  MA  02062
+				US
+
+C8-A7-29   (hex)		SYStronics Co., Ltd.
+C8A729     (base 16)		SYStronics Co., Ltd.
+				#301-1404, Buchun Techno-Park II
+				Buchun City  Kyung gi-do  421-741
+				KR
+
+44-54-C0   (hex)		Thompson Aerospace
+4454C0     (base 16)		Thompson Aerospace
+				18 Technology
+				Irvine  CA  92618
+				US
+
+C4-F4-64   (hex)		Spica international
+C4F464     (base 16)		Spica international
+				Pot k sejmiscu 33
+				Ljubljana    1000
+				SI
+
+60-2A-54   (hex)		CardioTek B.V.
+602A54     (base 16)		CardioTek B.V.
+				Amerikalaan 70
+				Maastricht Airport  Limburg  6199AE
+				NL
+
+BC-FF-AC   (hex)		TOPCON CORPORATION
+BCFFAC     (base 16)		TOPCON CORPORATION
+				75-1, Hasunuma-cho
+				Itabashi-ku  TOKYO  174-8580
+				JP
+
+44-5E-F3   (hex)		Tonalite Holding B.V.
+445EF3     (base 16)		Tonalite Holding B.V.
+				Nieuw Amsterdamsestraat 40
+				Emmen  Drenthe  7814 VA
+				NL
+
+68-DB-96   (hex)		OPWILL Technologies CO .,LTD
+68DB96     (base 16)		OPWILL Technologies CO .,LTD
+				Room 415,Digital Media Building,NO.7 Shangdi Information Road,HaiDian District,
+				Beijing    100085
+				CN
+
+7C-55-E7   (hex)		YSI, Inc.
+7C55E7     (base 16)		YSI, Inc.
+				1725 Brannum Lane
+				Yellow Springs  Ohio  45387
+				US
+
+70-B0-8C   (hex)		Shenou Communication Equipment Co.,Ltd
+70B08C     (base 16)		Shenou Communication Equipment Co.,Ltd
+				No.118 Middle Juguang Road, High & New Industrial Zone
+				Wenzhou  Zhejiang  325029
+				CN
+
+C0-3B-8F   (hex)		Minicom Digital Signage
+C03B8F     (base 16)		Minicom Digital Signage
+				24 Hebron Road
+				Jerusalem    93542
+				IL
+
+20-FE-DB   (hex)		M2M Solution S.A.S.
+20FEDB     (base 16)		M2M Solution S.A.S.
+				Centre d'Affaires Regus Bat.D
+				Mougins     06254 
+				FR
+
+0C-8D-98   (hex)		TOP EIGHT IND CORP
+0C8D98     (base 16)		TOP EIGHT IND CORP
+				8F.,No79-1 Zhouzi St., Neihu District, Taipei City  (Neihu Technology Park)
+				Taipei    11493
+				TW
+
+40-C7-C9   (hex)		Naviit Inc.
+40C7C9     (base 16)		Naviit Inc.
+				3058A Scott Blvd.
+				Santa Clara  CA  95054
+				US
+
+7C-BB-6F   (hex)		Cosco Electronics Co., Ltd.
+7CBB6F     (base 16)		Cosco Electronics Co., Ltd.
+				#1101, ENC Dream tower, 327-27
+				Seoul    153-793
+				KR
+
+94-A7-BC   (hex)		BodyMedia, Inc.
+94A7BC     (base 16)		BodyMedia, Inc.
+				420 Fort Duquesne Blvd
+				Pittsburgh  PA  15222
+				US
+
+C8-A1-B6   (hex)		Shenzhen Longway Technologies Co., Ltd
+C8A1B6     (base 16)		Shenzhen Longway Technologies Co., Ltd
+				Suite 707,Incubation Building, China Academy of Science&Tech Development, South area 
+				Shenzhen  Guangdong  518057
+				CN
+
+A8-55-6A   (hex)		Pocketnet Technology Inc.
+A8556A     (base 16)		Pocketnet Technology Inc.
+				Suite B, 7F., No. 550, Ruie Kwang Rd., Neihu District,
+				Taipei    11429
+				TW
+
+B4-C8-10   (hex)		UMPI Elettronica
+B4C810     (base 16)		UMPI Elettronica
+				Via Respighi, 15
+				Cattolica    47841
+				IT
+
+64-A2-32   (hex)		OOO Samlight
+64A232     (base 16)		OOO Samlight
+				44A, Dubninskaya str., 
+				Moscow    127591
+				RU
+
+64-FC-8C   (hex)		Zonar Systems
+64FC8C     (base 16)		Zonar Systems
+				18200 Cascade Ave South
+				Seattle  WA  98118
+				US
+
+D0-57-4C   (hex)		Cisco Systems, Inc
+D0574C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F8-DA-E2   (hex)		NDC Technologies
+F8DAE2     (base 16)		NDC Technologies
+				8001 Technology Blvd
+				Dayton  OH  45424
+				US
+
+70-5E-AA   (hex)		Action Target, Inc.
+705EAA     (base 16)		Action Target, Inc.
+				PO Box 636
+				Provo  UT  84603
+				US
+
+34-F9-68   (hex)		ATEK Products, LLC
+34F968     (base 16)		ATEK Products, LLC
+				210 NE 10th Avenue
+				Brainerd  MN  56401
+				US
+
+20-B0-F7   (hex)		Enclustra GmbH
+20B0F7     (base 16)		Enclustra GmbH
+				Technoparkstrasse 1
+				Zurich  ZH  CH-8005
+				CH
+
+54-31-31   (hex)		Raster Vision Ltd
+543131     (base 16)		Raster Vision Ltd
+				Unit 1, Crundalls
+				Tonbridge   Kent  TN12 7EA
+				GB
+
+D0-E3-47   (hex)		Yoga
+D0E347     (base 16)		Yoga
+				Tammsaare tee 47
+				Tallinn  Harjumaa  11316
+				EE
+
+F0-ED-1E   (hex)		Bilkon Bilgisayar Kontrollu Cih. Im.Ltd.
+F0ED1E     (base 16)		Bilkon Bilgisayar Kontrollu Cih. Im.Ltd.
+				Gersan Sanayi Sitesi 658.Sokak No:16
+				ANKARA    06370
+				TR
+
+C4-16-FA   (hex)		Prysm Inc
+C416FA     (base 16)		Prysm Inc
+				180 Baytech Drive
+				San Jose  California  95134
+				US
+
+50-6F-9A   (hex)		Wi-Fi Alliance
+506F9A     (base 16)		Wi-Fi Alliance
+				3925 W. Braker Lane
+				Austin  TX  78759
+				US
+
+84-29-14   (hex)		EMPORIA TELECOM Produktions- und VertriebsgesmbH & Co KG
+842914     (base 16)		EMPORIA TELECOM Produktions- und VertriebsgesmbH & Co KG
+				Industriezeile 36, 
+				Linz    4020
+				AT
+
+BC-7D-D1   (hex)		Radio Data Comms
+BC7DD1     (base 16)		Radio Data Comms
+				5/20-30 Stubbs Street
+				Silverwater   New South Wales (NSW)  2128
+				AU
+
+58-50-76   (hex)		Linear Equipamentos Eletronicos SA
+585076     (base 16)		Linear Equipamentos Eletronicos SA
+				Praca Linear 100
+				Santa Rita do Sapucai  MG  37540000
+				BR
+
+F0-F9-F7   (hex)		IES GmbH & Co. KG
+F0F9F7     (base 16)		IES GmbH & Co. KG
+				Darmcher Grund 22
+				Meinerzhagen    58540
+				DE
+
+38-58-0C   (hex)		Panaccess Systems GmbH
+38580C     (base 16)		Panaccess Systems GmbH
+				Gutenbergstr. 8
+				Ismaning  BY  85737
+				DE
+
+44-51-DB   (hex)		Raytheon BBN Technologies
+4451DB     (base 16)		Raytheon BBN Technologies
+				10 Moulton Street
+				Cambridge  MA  02138
+				US
+
+DC-FA-D5   (hex)		STRONG Ges.m.b.H.
+DCFAD5     (base 16)		STRONG Ges.m.b.H.
+				Franz-Josefs-Kai 1
+				Vienna    1010
+				AT
+
+6C-8D-65   (hex)		Wireless Glue Networks, Inc.
+6C8D65     (base 16)		Wireless Glue Networks, Inc.
+				1601 N. Main Street, Suite 202
+				Walnut Creek  CA  94596
+				US
+
+98-03-A0   (hex)		ABB n.v. Power Quality Products
+9803A0     (base 16)		ABB n.v. Power Quality Products
+				10 allée centrale
+				Jumet    6040
+				BE
+
+CC-43-E3   (hex)		Trump s.a.
+CC43E3     (base 16)		Trump s.a.
+				rue de la Maitrise 9
+				Nivelles    1400
+				BE
+
+F8-C0-91   (hex)		Highgates Technology
+F8C091     (base 16)		Highgates Technology
+				1415 Highgates Ave
+				Los Angeles  CA  90042
+				US
+
+AC-9B-84   (hex)		Smak Tecnologia e Automacao
+AC9B84     (base 16)		Smak Tecnologia e Automacao
+				Av. Sto. Antonio, 201 - Bela Vista
+				Osasco  São Paulo  CEP 06086-075
+				BR
+
+90-F2-78   (hex)		Radius Gateway
+90F278     (base 16)		Radius Gateway
+				520 E. Montford Ave
+				Ada  OH  45810
+				US
+
+80-66-29   (hex)		Prescope Technologies CO.,LTD.
+806629     (base 16)		Prescope Technologies CO.,LTD.
+				12F-1,No.192,Sec 2,Chung Hsin Road
+				Hsin Tien City  Taipei County  23146
+				TW
+
+24-1F-2C   (hex)		Calsys, Inc.
+241F2C     (base 16)		Calsys, Inc.
+				2700 Augustine drive, Ste145
+				Santa Clara  California  95054
+				US
+
+F0-BD-F1   (hex)		Sipod Inc.
+F0BDF1     (base 16)		Sipod Inc.
+				4633 Old Ironsides Drive, #400
+				Santa Clara  CA  95054
+				US
+
+64-67-07   (hex)		Beijing Omnific Technology, Ltd.
+646707     (base 16)		Beijing Omnific Technology, Ltd.
+				Rm. 402, Building 1, Shui Mu Qing Hua Community
+				Beijing    100190
+				CN
+
+58-FD-20   (hex)		Bravida Sakerhet AB
+58FD20     (base 16)		Bravida Sakerhet AB
+				Mikrofonvagen 28
+				STOCKHOLM    126 81
+				SE
+
+AC-A0-16   (hex)		Cisco Systems, Inc
+ACA016     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-E7-47   (hex)		Deltanet AG
+58E747     (base 16)		Deltanet AG
+				Riedstrasse 8
+				Dietikon  Zurich  8953
+				CH
+
+40-40-22   (hex)		ZIV
+404022     (base 16)		ZIV
+				Polígono Parque Tecnológico, 210
+				ZAMUDIO  VIZCAYA  48170
+				ES
+
+A8-5B-B0   (hex)		Shenzhen Dehoo Technology Co.,Ltd
+A85BB0     (base 16)		Shenzhen Dehoo Technology Co.,Ltd
+				5C,Tianzhan Building Tianan Cyberpark,
+				ShenZhen  Guang Dong  518040
+				CN
+
+44-A6-89   (hex)		PROMAX ELECTRONICA SA
+44A689     (base 16)		PROMAX ELECTRONICA SA
+				FRANCESC MORAGAS 71-75
+				HOSPITALET DE LLOBREGAT  BARCELONA  08907
+				ES
+
+40-61-8E   (hex)		Stella-Green Co
+40618E     (base 16)		Stella-Green Co
+				1-5-16 Edobori, Nishi-ku
+				Osaka    550-0002
+				JP
+
+68-E4-1F   (hex)		Unglaube Identech GmbH
+68E41F     (base 16)		Unglaube Identech GmbH
+				An der Moosach 3a
+				Massenhausen  Bayern  85376
+				DE
+
+4C-60-D5   (hex)		airPointe of New Hampshire
+4C60D5     (base 16)		airPointe of New Hampshire
+				35E Industrial Way
+				Rochester  NH  03867
+				US
+
+88-87-17   (hex)		CANON INC.
+888717     (base 16)		CANON INC.
+				3-30-2
+				Ohta-Ku  Tokyo  146-8501
+				JP
+
+6C-DC-6A   (hex)		Promethean Limited
+6CDC6A     (base 16)		Promethean Limited
+				Activlab
+				Blackburn  Lancashire  BB1 5SN
+				GB
+
+90-55-AE   (hex)		Ericsson, EAB/RWI/K
+9055AE     (base 16)		Ericsson, EAB/RWI/K
+				Skolgången 17
+				Gävle    SE-800 06
+				SE
+
+10-10-B6   (hex)		McCain Inc
+1010B6     (base 16)		McCain Inc
+				2365 Oak Ridge Way
+				Vista  CA  92081
+				US
+
+00-93-63   (hex)		Uni-Link Technology Co., Ltd.
+009363     (base 16)		Uni-Link Technology Co., Ltd.
+				7-5, No.66, Sec.2, Nan-Kan Rd., Lu-Chu Hsiang,Taoyuan,Taiwan
+				Taoyuan  Taiwan  338
+				TW
+
+D4-82-3E   (hex)		Argosy Technologies, Ltd.
+D4823E     (base 16)		Argosy Technologies, Ltd.
+				73-221 Haystack Road
+				Palm Desert  CA  92260
+				US
+
+00-35-32   (hex)		Electro-Metrics Corporation
+003532     (base 16)		Electro-Metrics Corporation
+				231 Enterprise Road
+				Johnstown  New York  12095
+				US
+
+08-1F-F3   (hex)		Cisco Systems, Inc
+081FF3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-37-6F   (hex)		Young Electric Sign Co
+44376F     (base 16)		Young Electric Sign Co
+				1651 N 1000 W
+				Logan  UT  84321
+				US
+
+38-9F-83   (hex)		OTN Systems N.V.
+389F83     (base 16)		OTN Systems N.V.
+				Industrielaan 17b
+				Olen    2250
+				BE
+
+BC-6A-16   (hex)		tdvine
+BC6A16     (base 16)		tdvine
+				301 Maison Maru Building 
+				Seoul    135-010
+				KR
+
+00-3A-9D   (hex)		NEC Platforms, Ltd.
+003A9D     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+28-CD-4C   (hex)		Individual Computers GmbH
+28CD4C     (base 16)		Individual Computers GmbH
+				Im Zemmer 6
+				Woffelsbach  NRW  52152
+				DE
+
+8C-53-F7   (hex)		A&D ENGINEERING CO., LTD.
+8C53F7     (base 16)		A&D ENGINEERING CO., LTD.
+				336-6 Dangsandong 6-ga, Yeongdeungpo-gu
+				Seoul    150-810
+				KR
+
+7C-76-73   (hex)		ENMAS GmbH
+7C7673     (base 16)		ENMAS GmbH
+				Holzkoppelweg 23
+				Kiel  Schleswig-Holstein  24251
+				DE
+
+6C-6F-18   (hex)		Stereotaxis, Inc.
+6C6F18     (base 16)		Stereotaxis, Inc.
+				4320 Forest Park Ave
+				St. Louis  MO  63108
+				US
+
+84-C7-27   (hex)		Gnodal Ltd
+84C727     (base 16)		Gnodal Ltd
+				178 - 180 Hotwell Road
+				Bristol    BS8 4RP
+				GB
+
+08-76-95   (hex)		Auto Industrial Co., Ltd.
+087695     (base 16)		Auto Industrial Co., Ltd.
+				14Floor, #235 Hanshin IT Tower, 
+				Seoul    152-768
+				KR
+
+AC-CE-8F   (hex)		HWA YAO TECHNOLOGIES CO., LTD
+ACCE8F     (base 16)		HWA YAO TECHNOLOGIES CO., LTD
+				NO. 6, LN. 48, NANSING RD.,
+				YONGKANG CITY, TAINAN COUNTY     710
+				TW
+
+8C-92-36   (hex)		Aus.Linx Technology Co., Ltd.
+8C9236     (base 16)		Aus.Linx Technology Co., Ltd.
+				6F-2, No. 190, Sec. 2, Zhongxing Rd., Xindian Dist.,
+				New Taipei City    23146
+				TW
+
+10-C7-3F   (hex)		Midas Klark Teknik Ltd
+10C73F     (base 16)		Midas Klark Teknik Ltd
+				Klark Teknik Building
+				Kidderminster  Worcestershire  DY11 7HJ
+				GB
+
+F8-91-2A   (hex)		GLP German Light Products GmbH
+F8912A     (base 16)		GLP German Light Products GmbH
+				Im Stöckmädle 13
+				Karlsbad  BW  76307
+				DE
+
+44-E4-9A   (hex)		OMNITRONICS PTY LTD
+44E49A     (base 16)		OMNITRONICS PTY LTD
+				27 SARICH CRT
+				OSBORNE PARK  WA  6017
+				AU
+
+08-F2-F4   (hex)		Net One Partners Co.,Ltd.
+08F2F4     (base 16)		Net One Partners Co.,Ltd.
+				2-8 Higashi Shinagawa 2-chome,
+				Tokyo    1400002
+				JP
+
+0C-7D-7C   (hex)		Kexiang Information Technology Co, Ltd.
+0C7D7C     (base 16)		Kexiang Information Technology Co, Ltd.
+				Room 1502, Longxi Hotel No.3788 Jiangnan Avenue. 
+				Hangzhou  Zhejiang  310053
+				CN
+
+30-37-A6   (hex)		Cisco Systems, Inc
+3037A6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+DC-1D-9F   (hex)		U & B tech
+DC1D9F     (base 16)		U & B tech
+				2F, Daeyoung buliding, 1423-6, Kwanyang-1Dong,
+				Anyang-Si  Gyeonggi-Do  431-061
+				KR
+
+D8-E7-2B   (hex)		NetAlly
+D8E72B     (base 16)		NetAlly
+				310 Littleton Road
+				Westford  MA  01886 
+				US
+
+78-5C-72   (hex)		Hioso Technology Co., Ltd.
+785C72     (base 16)		Hioso Technology Co., Ltd.
+				6th Floor, 12th Building, Wangtang Industrial Zone,
+				Shenzhen  Guangdong  518055
+				CN
+
+58-05-56   (hex)		Elettronica GF S.r.L.
+580556     (base 16)		Elettronica GF S.r.L.
+				Via Vittori, 63
+				FAENZA  RA  48018
+				IT
+
+B0-90-74   (hex)		Fulan Electronics Limited
+B09074     (base 16)		Fulan Electronics Limited
+				Flat B&C,3/F,A1 Block, Gaoxin Cyber-Tech Zone,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+94-F6-92   (hex)		Geminico co.,Ltd.
+94F692     (base 16)		Geminico co.,Ltd.
+				#102-1112, Chunui-Technopark, 200-1,
+				Bucheon-city  Kyunggi-do  420-857
+				KR
+
+68-EF-BD   (hex)		Cisco Systems, Inc
+68EFBD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F0-24-08   (hex)		Talaris (Sweden) AB
+F02408     (base 16)		Talaris (Sweden) AB
+				Taljs Sodra Industriomrade
+				Flen    64284
+				SE
+
+80-81-A5   (hex)		TONGQING COMMUNICATION EQUIPMENT (SHENZHEN) Co.,Ltd
+8081A5     (base 16)		TONGQING COMMUNICATION EQUIPMENT (SHENZHEN) Co.,Ltd
+				Tongqing Industry Park,jiuwei,xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518126
+				CN
+
+B4-82-FE   (hex)		ASKEY COMPUTER CORP
+B482FE     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+30-7C-30   (hex)		RIM
+307C30     (base 16)		RIM
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+BC-4E-3C   (hex)		CORE STAFF CO., LTD.
+BC4E3C     (base 16)		CORE STAFF CO., LTD.
+				Shin-osaka Oriental Bldg. 14F, 7-1-26 Nishinakajima
+				Yodogawa-ku  Osaka  532-0011
+				JP
+
+50-2A-8B   (hex)		Telekom Research and Development Sdn Bhd
+502A8B     (base 16)		Telekom Research and Development Sdn Bhd
+				TMRND Innovation Centre
+				Cyberjaya  Selangor  63000
+				MY
+
+EC-43-E6   (hex)		AWCER Ltd.
+EC43E6     (base 16)		AWCER Ltd.
+				100-413 Bucheon Technopark
+				Bucheon-city  Gyeonggi-do  421-741
+				KR
+
+78-12-B8   (hex)		ORANTEK LIMITED
+7812B8     (base 16)		ORANTEK LIMITED
+				5/F, Building E, Dakan Tech Park, Dakan village, Xili Town, Nanshan District, Shenzhen, China
+				Shenzhen  Guangdong  518000
+				CN
+
+98-BC-99   (hex)		Edeltech Co.,Ltd.
+98BC99     (base 16)		Edeltech Co.,Ltd.
+				#302 Jamae Bldg, 1010-28, Sadang-dong, Dongjak=gu
+				Seoul    156-824
+				KR
+
+F0-2F-D8   (hex)		Bi2-Vision
+F02FD8     (base 16)		Bi2-Vision
+				16-504, 21-ban, Shimomaruko 4-chome, Oota-ku
+				Tokyo    146-0092
+				JP
+
+54-42-49   (hex)		Sony Corporation
+544249     (base 16)		Sony Corporation
+				Gotenyama Tec 5-1-2
+				Tokyo  Shinagawa-ku  141-0001
+				JP
+
+90-47-16   (hex)		RORZE CORPORATION
+904716     (base 16)		RORZE CORPORATION
+				1588-2 Michinoue, Kannabe-cho
+				Fukuyama  Hiroshima  720-2104
+				JP
+
+10-44-5A   (hex)		Shaanxi Hitech Electronic Co., LTD
+10445A     (base 16)		Shaanxi Hitech Electronic Co., LTD
+				35 Tuanjienan Rode,
+				Xian  Shaanxi  710075
+				CN
+
+F4-76-26   (hex)		Viltechmeda UAB 
+F47626     (base 16)		Viltechmeda UAB 
+				Kalvariju 125
+				Vilnius    LT-08221
+				LT
+
+0C-17-F1   (hex)		TELECSYS
+0C17F1     (base 16)		TELECSYS
+				31 chemin du fief aux pretres
+				L'ORBRIE    85200
+				FR
+
+00-3A-9B   (hex)		Cisco Systems, Inc
+003A9B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-34-27   (hex)		ERCO & GENER
+2C3427     (base 16)		ERCO & GENER
+				ZI de SAINT LAMBERT DES LEVEES
+				SAUMUR    49412
+				FR
+
+80-91-2A   (hex)		Lih Rong electronic Enterprise Co., Ltd.
+80912A     (base 16)		Lih Rong electronic Enterprise Co., Ltd.
+				2F, No. 2, Lane 387, Hsin Shu Road
+				Hsin Chuang  Taipei  242
+				TW
+
+7C-2F-80   (hex)		Gigaset Communications GmbH
+7C2F80     (base 16)		Gigaset Communications GmbH
+				SCM PE 2
+				Bocholt    46395
+				DE
+
+10-B7-F6   (hex)		Plastoform Industries Ltd.
+10B7F6     (base 16)		Plastoform Industries Ltd.
+				Units 1506A - 1512, Mita Centre,
+				Kwai Chung,    
+				HK
+
+44-8E-81   (hex)		VIG
+448E81     (base 16)		VIG
+				705 Hanshin IT Tower, 60-18, Kasan-dong, Geumcheon-gu
+				Seoul    KSXX0022
+				KR
+
+88-94-F9   (hex)		Gemicom Technology, Inc.
+8894F9     (base 16)		Gemicom Technology, Inc.
+				16F, Building B, No. 98, Sec 1, Hsin-Tai-Wu Rd.
+				Hsi-Chih city  Taipei  22102
+				TW
+
+50-2A-7E   (hex)		Smart electronic GmbH
+502A7E     (base 16)		Smart electronic GmbH
+				Industrie Str. 29
+				St. Georgen    78112
+				DE
+
+5C-87-78   (hex)		Cybertelbridge co.,ltd
+5C8778     (base 16)		Cybertelbridge co.,ltd
+				#901 Acehighend tower 2
+				Seoul    152-050
+				KR
+
+38-BB-23   (hex)		OzVision America LLC
+38BB23     (base 16)		OzVision America LLC
+				400 West Cummings Park
+				Woburn  MA  01801
+				US
+
+0C-84-11   (hex)		A.O. Smith Water Products
+0C8411     (base 16)		A.O. Smith Water Products
+				25589 Hwy 1
+				McBee  SC  29101
+				US
+
+E0-AB-FE   (hex)		Orb Networks, Inc.
+E0ABFE     (base 16)		Orb Networks, Inc.
+				428 13th Street
+				Oakland  CA  94612
+				US
+
+44-83-12   (hex)		Star-Net
+448312     (base 16)		Star-Net
+				Egoz 64 
+				Kiryat Byalik  Israel  27000
+				IL
+
+A0-5D-E7   (hex)		DIRECTV, Inc.
+A05DE7     (base 16)		DIRECTV, Inc.
+				2230 E. Imperial Hwy
+				El Segundo  CA  90245
+				US
+
+08-76-18   (hex)		ViE Technologies Sdn. Bhd.
+087618     (base 16)		ViE Technologies Sdn. Bhd.
+				no. 85-A, Lintang Bayan Lepas 11,
+				Bayan Lepas  Penang  11900
+				MY
+
+D0-E4-0B   (hex)		Wearable Inc.
+D0E40B     (base 16)		Wearable Inc.
+				3825 Charles Dr.
+				Northbrook  IL  60062
+				US
+
+74-7E-1A   (hex)		Red Embedded Design Limited
+747E1A     (base 16)		Red Embedded Design Limited
+				The Wave
+				Shipley  West Yorkshire  BD17 7Du
+				GB
+
+14-A8-6B   (hex)		ShenZhen Telacom Science&Technology Co., Ltd
+14A86B     (base 16)		ShenZhen Telacom Science&Technology Co., Ltd
+				B1701/1705 Pavilion, Hua Qiang Bei RD4002, Futian District
+				ShenZhen  GuangDong  518028
+				CN
+
+0C-C3-A7   (hex)		Meritec
+0CC3A7     (base 16)		Meritec
+				P.O. Box 8003
+				Painesville  Ohio  44077
+				US
+
+DC-E2-AC   (hex)		Lumens Digital Optics Inc.
+DCE2AC     (base 16)		Lumens Digital Optics Inc.
+				5F, No.35, Sintai Rd., Jhubei City
+				Jhubei   HsinChu  302
+				TW
+
+98-D8-8C   (hex)		Nortel Networks
+98D88C     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+78-19-2E   (hex)		NASCENT Technology
+78192E     (base 16)		NASCENT Technology
+				2744 Yorkmont RD
+				Charlotte  NC  28208
+				US
+
+48-EB-30   (hex)		ETERNA TECHNOLOGY, INC.
+48EB30     (base 16)		ETERNA TECHNOLOGY, INC.
+				3939 veselich ave
+				los angeles  california  90039
+				US
+
+4C-32-2D   (hex)		TELEDATA NETWORKS
+4C322D     (base 16)		TELEDATA NETWORKS
+				10 Hasadnaot Street
+				HERZLIYA    46120
+				IL
+
+AC-86-7E   (hex)		Create New Technology (HK) Limited Company
+AC867E     (base 16)		Create New Technology (HK) Limited Company
+				Rm B 10/F JinFeng Building,1001 ShangBu South Road,FuTian District 
+				Shen Zhen  Guang Dong  518031
+				CN
+
+8C-59-8B   (hex)		C Technologies AB
+8C598B     (base 16)		C Technologies AB
+				Traktorvägen 11
+				Lund  Skåne  226 60
+				SE
+
+D4-4C-A7   (hex)		Informtekhnika & Communication, LLC
+D44CA7     (base 16)		Informtekhnika & Communication, LLC
+				1, build. 2/1, Verhnaya
+				Moscow    107140
+				RU
+
+A8-C2-22   (hex)		TM-Research Inc.
+A8C222     (base 16)		TM-Research Inc.
+				Hiyoshi Honcho 1-15-4
+				Yokohama  Kanagawa  223-0062
+				JP
+
+00-3D-41   (hex)		Hatteland Computer AS
+003D41     (base 16)		Hatteland Computer AS
+				Aamsosen
+				Nedre Vats  Rogaland  5578
+				NO
+
+CC-50-76   (hex)		Ocom Communications, Inc.
+CC5076     (base 16)		Ocom Communications, Inc.
+				13F-6, No. 1, Bao Sheng Rd., 
+				Yong Ho City    234
+				TW
+
+4C-C4-52   (hex)		Shang Hai Tyd. Electon Technology Ltd.
+4CC452     (base 16)		Shang Hai Tyd. Electon Technology Ltd.
+				Room No.5,N0.396,GuiLin Road, 
+				Shang Hai    200233
+				US
+
+7C-CB-0D   (hex)		Antaira Technologies, LLC
+7CCB0D     (base 16)		Antaira Technologies, LLC
+				445 Capricorn St.
+				Brea  California  92821
+				US
+
+C0-1E-9B   (hex)		Pixavi AS
+C01E9B     (base 16)		Pixavi AS
+				Dusavikveien 39
+				Stavanger    4003
+				NO
+
+80-3B-9A   (hex)		ghe-ces electronic ag
+803B9A     (base 16)		ghe-ces electronic ag
+				Hoemelstraße 17
+				Wald  ZH  8636
+				CH
+
+74-32-56   (hex)		NT-ware Systemprg GmbH
+743256     (base 16)		NT-ware Systemprg GmbH
+				Niedersachsenstrasse 6
+				Bad Iburg  NDS  49186
+				DE
+
+C4-E1-7C   (hex)		U2S co.
+C4E17C     (base 16)		U2S co.
+				104-706, SK Ventium Building, 522, Dangjeong-Dong
+				Gunpo-si  Geonggi-do  435-776
+				KR
+
+20-BF-DB   (hex)		DVL
+20BFDB     (base 16)		DVL
+				21 Gradinilor Str
+				Chisinau    MD2001
+				MD
+
+20-41-5A   (hex)		Smarteh d.o.o.
+20415A     (base 16)		Smarteh d.o.o.
+				Trg tigrovcev 1
+				Tolmin    5220
+				SI
+
+A4-DA-3F   (hex)		Bionics Corp.
+A4DA3F     (base 16)		Bionics Corp.
+				1406 Masters Tower
+				Seoul    121-748
+				KR
+
+A0-40-25   (hex)		Actioncable, Inc.
+A04025     (base 16)		Actioncable, Inc.
+				998 Westlynn Way
+				Cupertino  CA  95014
+				US
+
+4C-4B-68   (hex)		Mobile Device, Inc. 
+4C4B68     (base 16)		Mobile Device, Inc. 
+				 8F-1, No. 145, Sianjheng 9th Rd., 
+				Jhubei City,   Hsinchu County   30251
+				TW
+
+20-12-57   (hex)		Most Lucky Trading Ltd
+201257     (base 16)		Most Lucky Trading Ltd
+				Room403 No.506 Zhongshan South 2nd Road,Xuhui District 
+				Shanghai    200032
+				CN
+
+E8-DA-AA   (hex)		VideoHome Technology Corp.
+E8DAAA     (base 16)		VideoHome Technology Corp.
+				4F-1, No. 192, Da Tung Rd., Sec. 3, Hsichih,
+				Taipei Hsien    221
+				TW
+
+64-7D-81   (hex)		YOKOTA INDUSTRIAL CO,.LTD
+647D81     (base 16)		YOKOTA INDUSTRIAL CO,.LTD
+				5-55 NISHIIWATA
+				HIGASHI OSAKA-CITY  OSAKA  578-0947
+				JP
+
+7C-CF-CF   (hex)		Shanghai SEARI Intelligent System Co., Ltd
+7CCFCF     (base 16)		Shanghai SEARI Intelligent System Co., Ltd
+				No.505 Wuning Road, Putuo District
+				Shanghai    200063
+				CN
+
+68-AA-D2   (hex)		DATECS LTD.,
+68AAD2     (base 16)		DATECS LTD.,
+				BUL. TSARIGRADSKO SHOSSE 115A
+				SOFIA    1784
+				BG
+
+A4-DE-50   (hex)		Total Walther GmbH
+A4DE50     (base 16)		Total Walther GmbH
+				Frankfurter Ring 17
+				Munich    80807
+				DE
+
+1C-F0-61   (hex)		SCAPS GmbH
+1CF061     (base 16)		SCAPS GmbH
+				Bahnhofstraße 17
+				Deisenhofen  Bavaria  82041
+				DE
+
+A8-93-E6   (hex)		JIANGXI JINGGANGSHAN CKING COMMUNICATION TECHNOLOGY CO.,LTD
+A893E6     (base 16)		JIANGXI JINGGANGSHAN CKING COMMUNICATION TECHNOLOGY CO.,LTD
+				5F,301building,Tairan High-tech park, Chegongmiao,Futian zone,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+C4-AA-A1   (hex)		SUMMIT DEVELOPMENT, spol.s r.o.
+C4AAA1     (base 16)		SUMMIT DEVELOPMENT, spol.s r.o.
+				K Vodoteci 197
+				Orech  Praha-zapad  252 25
+				CZ
+
+30-32-D4   (hex)		Hanilstm Co., Ltd.
+3032D4     (base 16)		Hanilstm Co., Ltd.
+				138-6, Sangdaewon-dong Jungwon-gu
+				Seongnam  Kyonggi-do  462-120
+				KR
+
+E0-64-BB   (hex)		DigiView S.r.l.
+E064BB     (base 16)		DigiView S.r.l.
+				Via Senigallia 18/2
+				Milano    20161
+				IT
+
+DC-33-50   (hex)		TechSAT GmbH
+DC3350     (base 16)		TechSAT GmbH
+				Gruber Str. 46c
+				Poing  BY  85586
+				DE
+
+F0-BC-C8   (hex)		MaxID (Pty) Ltd
+F0BCC8     (base 16)		MaxID (Pty) Ltd
+				43 Homestead Road
+				Johannesburg  Gauteng  2128
+				ZA
+
+24-82-8A   (hex)		Prowave Technologies Ltd.
+24828A     (base 16)		Prowave Technologies Ltd.
+				2F,No.879-16,Zhongjiang Road
+				Shanghai    200333
+				CN
+
+68-CC-9C   (hex)		Mine Site Technologies
+68CC9C     (base 16)		Mine Site Technologies
+				113 Wicks Road
+				North Ryde  NSW  2113
+				AU
+
+14-6E-0A   (hex)		Private
+146E0A     (base 16)		Private
+
+0C-E7-09   (hex)		Fox Crypto B.V.
+0CE709     (base 16)		Fox Crypto B.V.
+				P.O. box 638
+				Delft  ZH  2600 AP
+				NL
+
+B4-B5-AF   (hex)		Minsung Electronics
+B4B5AF     (base 16)		Minsung Electronics
+				Mega-valley #620
+				Anyang-si  Kyeonggi-do  431-767
+				KR
+
+04-B3-B6   (hex)		Seamap (UK) Ltd
+04B3B6     (base 16)		Seamap (UK) Ltd
+				Unit 34, The Maltings
+				Shepton Mallet  Somerset  BA4 5QE
+				GB
+
+00-27-0B   (hex)		Adura Technologies
+00270B     (base 16)		Adura Technologies
+				28 Second Street
+				San Francisco  CA  94105
+				US
+
+00-27-0D   (hex)		Cisco Systems, Inc
+00270D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-27-1B   (hex)		Alec Sicherheitssysteme GmbH
+00271B     (base 16)		Alec Sicherheitssysteme GmbH
+				Friedrich-Hoelscher-Strasse 367
+				Dortmund    44328
+				DE
+
+00-27-18   (hex)		Suzhou NEW SEAUNION Video Technology Co.,Ltd
+002718     (base 16)		Suzhou NEW SEAUNION Video Technology Co.,Ltd
+				383 Jingmao Road, Industry Park
+				Suzhou  Jiangsu  215021
+				CN
+
+6C-0F-6A   (hex)		JDC Tech Co., Ltd.
+6C0F6A     (base 16)		JDC Tech Co., Ltd.
+				370-12 Daemyung-ri Daegot-myun
+				Kimpo-si  Kyunggi-do  410-853
+				KR
+
+04-B4-66   (hex)		BSP Co., Ltd.
+04B466     (base 16)		BSP Co., Ltd.
+				162-10
+				Gumi  Gyeungsangbuk Do  730-902
+				KR
+
+D8-D6-7E   (hex)		GSK CNC EQUIPMENT CO.,LTD
+D8D67E     (base 16)		GSK CNC EQUIPMENT CO.,LTD
+				No.7,1st Street,Luochong North Road,Luochongwei,No.7,1st Street,Luochong North Road,Luochongwei,No.7,1st Street,Luochong North Road,Luochongwei,
+				Guangzhou  Guangdong  510165
+				CN
+
+00-26-AE   (hex)		Wireless Measurement Ltd
+0026AE     (base 16)		Wireless Measurement Ltd
+				The Crescent
+				EMSWORTH    PO10 8JS
+				GB
+
+00-26-B1   (hex)		Navis Auto Motive Systems, Inc.
+0026B1     (base 16)		Navis Auto Motive Systems, Inc.
+				Busan, Centumjungang-ro 78, Centum Greentower 8th floor
+				BUSAN    612-822
+				KR
+
+00-26-AA   (hex)		Kenmec Mechanical Engineering Co., Ltd.
+0026AA     (base 16)		Kenmec Mechanical Engineering Co., Ltd.
+				3F, No. 97, Sec.2 Nan-Kang Rd.,
+				Taipei    11578
+				TW
+
+00-26-D2   (hex)		Pcube Systems, Inc.
+0026D2     (base 16)		Pcube Systems, Inc.
+				1857 O'Toole Lane
+				San Jose  CA  95131
+				US
+
+00-26-CD   (hex)		PurpleComm, Inc.
+0026CD     (base 16)		PurpleComm, Inc.
+				2620 Augustine Dr., Ste. 100
+				Santa Clara  CA  95054
+				US
+
+00-27-07   (hex)		Lift Complex DS, JSC
+002707     (base 16)		Lift Complex DS, JSC
+				mikrorayon Gorsky, 6
+				Novosibirsk    630073
+				RU
+
+00-26-D7   (hex)		KM Electornic Technology Co., Ltd.
+0026D7     (base 16)		KM Electornic Technology Co., Ltd.
+				5F, NO.3 Building, NO.118 Rd. Baoan District, Shenzhen China
+				Shenzhen  Guangdong  518101
+				CN
+
+00-26-D0   (hex)		Semihalf
+0026D0     (base 16)		Semihalf
+				ul. Wadowicka 8A
+				Krakow  ...  30-415
+				PL
+
+00-26-FE   (hex)		MKD Technology Inc.
+0026FE     (base 16)		MKD Technology Inc.
+				 R.B8, No.1 Lising 1st  Rd.,
+				Hsinchu    30078
+				TW
+
+00-26-A0   (hex)		moblic
+0026A0     (base 16)		moblic
+				7F, 271-1, Seohyeon-dong, Bundang-gu
+				Seongnam-si  Kyeonggi-do  463-824
+				KR
+
+00-26-E5   (hex)		AEG Power Solutions
+0026E5     (base 16)		AEG Power Solutions
+				Emil Siepmannstraße 32
+				Warstein  NRW  59581
+				DE
+
+00-26-E3   (hex)		DTI
+0026E3     (base 16)		DTI
+				Rue de la gare, 35
+				NANINNE  NAMUR  5100
+				BE
+
+00-26-BC   (hex)		General Jack Technology Ltd.
+0026BC     (base 16)		General Jack Technology Ltd.
+				The Area of Administration of Lian Bei,
+				Dong Guan  Guang Dong  523580
+				CN
+
+00-26-96   (hex)		NOOLIX Co., Ltd
+002696     (base 16)		NOOLIX Co., Ltd
+				DAECHANG B/D 3F, 8-2 SUNAE-DONG
+				SUNGNAM-SI  KYUNGGI-DO  463-825
+				KR
+
+00-26-9A   (hex)		Carina System Co., Ltd.
+00269A     (base 16)		Carina System Co., Ltd.
+				2-2-11 Kotonoo-cho
+				Kobe  Hyogo  651-0094
+				JP
+
+00-26-95   (hex)		ZT Group Int'l Inc
+002695     (base 16)		ZT Group Int'l Inc
+				350 Meadowlands Parkway
+				Secaucus  NJ  07094
+				US
+
+00-26-93   (hex)		QVidium Technologies, Inc.
+002693     (base 16)		QVidium Technologies, Inc.
+				12989 Chaparral Ridge Rd
+				San Diego  CA  92130
+				US
+
+00-26-65   (hex)		ProtectedLogic Corporation
+002665     (base 16)		ProtectedLogic Corporation
+				PO Box 67707
+				Albuquerque  NM  87193
+				US
+
+00-26-60   (hex)		Logiways
+002660     (base 16)		Logiways
+				24/26 rue Louis ARMAND
+				PARIS    75015
+				FR
+
+00-26-70   (hex)		Cinch Connectors
+002670     (base 16)		Cinch Connectors
+				1700 Finley Road
+				Lombard  IL  60148
+				US
+
+00-26-71   (hex)		AUTOVISION Co., Ltd
+002671     (base 16)		AUTOVISION Co., Ltd
+				Shinsegae YBS Bldg. 102
+				Seongdong-gu  Seoul  133-847
+				KR
+
+00-26-48   (hex)		Emitech Corp.
+002648     (base 16)		Emitech Corp.
+				No. 156-5A, ChengGong 1st St.,
+				Jhubei City  Hsinchu County  302
+				TW
+
+00-26-45   (hex)		Circontrol S.A.
+002645     (base 16)		Circontrol S.A.
+				Lepant 43
+				Terrassa  Barcelona  08223
+				ES
+
+00-26-3E   (hex)		Trapeze Networks
+00263E     (base 16)		Trapeze Networks
+				5753 West Las Positas Blvd.
+				Pleasanton  California  94588
+				US
+
+00-26-3C   (hex)		Bachmann Technology GmbH & Co. KG
+00263C     (base 16)		Bachmann Technology GmbH & Co. KG
+				Ernsthaldenstrasse 33
+				Stuttgart  BW  70565
+				DE
+
+00-26-3D   (hex)		MIA Corporation
+00263D     (base 16)		MIA Corporation
+				1-3-15 Yoshino-cho, Minami-ku
+				Yokohama  Kanagawa  232-0014
+				JP
+
+00-26-78   (hex)		Logic Instrument SA
+002678     (base 16)		Logic Instrument SA
+				43, Avenue de l'Europe
+				Domont    95330
+				FR
+
+00-26-77   (hex)		DEIF A/S
+002677     (base 16)		DEIF A/S
+				Frisenborgvej 33
+				Skive    7800
+				DK
+
+00-26-8E   (hex)		Alta Solutions, Inc.
+00268E     (base 16)		Alta Solutions, Inc.
+				11305 Rancho Bernardo Road
+				San Diego  CA  92127
+				US
+
+00-26-88   (hex)		Juniper Networks
+002688     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-25-DA   (hex)		Secura Key
+0025DA     (base 16)		Secura Key
+				20301 Nordhoff St.
+				Chatsworth  CA  91311
+				US
+
+00-25-DB   (hex)		ATI Electronics(Shenzhen) Co., LTD
+0025DB     (base 16)		ATI Electronics(Shenzhen) Co., LTD
+				2F,1st Buliding,Tangyanshan Industrial Park,
+				Shenzhen  Guangdong  518108
+				CN
+
+00-25-D5   (hex)		Robonica (Pty) Ltd
+0025D5     (base 16)		Robonica (Pty) Ltd
+				41 Park Avenue North
+				Centurion  Gauteng  0046
+				ZA
+
+00-25-E2   (hex)		Everspring Industry Co., Ltd.
+0025E2     (base 16)		Everspring Industry Co., Ltd.
+				7F., No. 609, Sec 1, Wanshou Rd.,
+				Gueishan Township  Taoyuan County  333
+				TW
+
+00-25-E1   (hex)		SHANGHAI SEEYOO ELECTRONIC & TECHNOLOGY CO., LTD
+0025E1     (base 16)		SHANGHAI SEEYOO ELECTRONIC & TECHNOLOGY CO., LTD
+				RM701,XIN'AN BUILDING,99 TIANZHOU RD,XUHUI DISTRICT,SHANGHAI
+				SHANGHAI    200233
+				CN
+
+00-26-0E   (hex)		Ablaze Systems, LLC
+00260E     (base 16)		Ablaze Systems, LLC
+				523 West Valley Road
+				Wayne  Pennsylvania  19087
+				US
+
+00-26-10   (hex)		Apacewave Technologies
+002610     (base 16)		Apacewave Technologies
+				48389 Fremont Blvd, STE#100
+				Fremont  CA  94538
+				US
+
+00-26-0D   (hex)		Mercury Systems, Inc.
+00260D     (base 16)		Mercury Systems, Inc.
+				26 Hampshire Dr
+				Hudson  NH  03051
+				US
+
+00-26-0A   (hex)		Cisco Systems, Inc
+00260A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-32   (hex)		Instrumentation Technologies d.d.
+002632     (base 16)		Instrumentation Technologies d.d.
+				Velika pot 22
+				Solkan  Nova Gorica  5250
+				SI
+
+00-26-2E   (hex)		Chengdu Jiuzhou Electronic Technology Inc
+00262E     (base 16)		Chengdu Jiuzhou Electronic Technology Inc
+				A2 Building,Tianfu Software Park
+				Chengdu  Sichuan  610041
+				CN
+
+00-26-2C   (hex)		IKT Advanced Technologies s.r.o.
+00262C     (base 16)		IKT Advanced Technologies s.r.o.
+				Piseckeho 334/19
+				Praha 5    15000
+				CZ
+
+00-26-29   (hex)		Juphoon System Software Inc.
+002629     (base 16)		Juphoon System Software Inc.
+				Room 910,Building 2
+				Ningbo  Zhejiang  315041
+				CN
+
+00-26-25   (hex)		MediaSputnik
+002625     (base 16)		MediaSputnik
+				Yaroslavskoe shosse, 19,
+				Moscow    129337
+				RU
+
+00-26-26   (hex)		Geophysical Survey Systems, Inc.
+002626     (base 16)		Geophysical Survey Systems, Inc.
+				12 Industrial Way
+				Salem  NH  03079
+				US
+
+00-25-CC   (hex)		Mobile Communications Korea Incorporated
+0025CC     (base 16)		Mobile Communications Korea Incorporated
+				1011-1012, Suwon High Venture Valley,
+				Suwon-si,  Gyeonggi-do,  441-360
+				KR
+
+00-25-F9   (hex)		GMK electronic design GmbH
+0025F9     (base 16)		GMK electronic design GmbH
+				Daimlerstraße 8
+				Wernberg-Koeblitz  Bavaria  D-92533
+				DE
+
+00-25-F7   (hex)		Ansaldo STS USA
+0025F7     (base 16)		Ansaldo STS USA
+				1000 Technology Drive
+				Pittsburgh  PA  15219
+				US
+
+00-26-1B   (hex)		LAUREL BANK MACHINES CO., LTD.
+00261B     (base 16)		LAUREL BANK MACHINES CO., LTD.
+				12-6
+				Kita-Ku  Tokyo  114-0013
+				JP
+
+00-26-14   (hex)		KTNF
+002614     (base 16)		KTNF
+				204,Daeryungtechnotown1,327,Gasan-Dong,
+				Seoul    153-771
+				KR
+
+00-26-03   (hex)		Shenzhen Wistar Technology Co., Ltd
+002603     (base 16)		Shenzhen Wistar Technology Co., Ltd
+				Rm919, Science &Technology Service Center
+				Shenzhen  Guangdong  518000
+				CN
+
+00-25-A6   (hex)		Central Network Solution Co., Ltd.
+0025A6     (base 16)		Central Network Solution Co., Ltd.
+				584-1, Pajang-Dong, JangAn-Gu
+				Suwon-Si,  Kyunggi-Do  440-854
+				KR
+
+00-25-AA   (hex)		Beijing Soul Technology Co.,Ltd.
+0025AA     (base 16)		Beijing Soul Technology Co.,Ltd.
+				Room 606,Xinzheng Office Building
+				BEIJING    100089
+				CN
+
+00-25-88   (hex)		Genie Industries, Inc.
+002588     (base 16)		Genie Industries, Inc.
+				18620 NE 67th Ct
+				Redmond  WA  98052
+				US
+
+00-25-80   (hex)		Equipson S.A.
+002580     (base 16)		Equipson S.A.
+				Poligono Ind. L´Alteró
+				Silla  Valencia  46460
+				ES
+
+00-25-BD   (hex)		Italdata Ingegneria dell'Idea S.p.A.
+0025BD     (base 16)		Italdata Ingegneria dell'Idea S.p.A.
+				viale Eroi di Cefalonia 123
+				Roma    00128
+				IT
+
+00-25-B7   (hex)		Costar  electronics, inc.,
+0025B7     (base 16)		Costar  electronics, inc.,
+				3fl,-1 no 13,lane 120,nei-hu road sec.1,
+				Taipei    114
+				TW
+
+00-25-7D   (hex)		PointRed Telecom Private Ltd.
+00257D     (base 16)		PointRed Telecom Private Ltd.
+				15F - 5., No. 1071, Zhongzheng Road,
+				Taoyuan City 330    330
+				TW
+
+00-25-A2   (hex)		Alta Definicion LINCEO S.L.
+0025A2     (base 16)		Alta Definicion LINCEO S.L.
+				Maria de Luna 11, nave 4
+				Zaragoza    Es-50018
+				ES
+
+00-25-6D   (hex)		Broadband Forum
+00256D     (base 16)		Broadband Forum
+				48377 Fremont Boulevard
+				Fremont  CA  94538
+				US
+
+00-25-6C   (hex)		Azimut Production Association JSC
+00256C     (base 16)		Azimut Production Association JSC
+				2-B Ataeva Street
+				Makhachkala  Dagestan  367005
+				RU
+
+00-25-63   (hex)		Luxtera Inc
+002563     (base 16)		Luxtera Inc
+				2320. Camino Vida Roble
+				Carlsbad  CA  92011
+				US
+
+00-25-93   (hex)		DatNet Informatikai Kft.
+002593     (base 16)		DatNet Informatikai Kft.
+				Hétvezér u. 5.
+				Szigetszentmiklós  Pest megye  2310
+				HU
+
+00-25-8E   (hex)		The Weather Channel
+00258E     (base 16)		The Weather Channel
+				Mail Stop 500
+				Atlanta  GA  30339
+				US
+
+00-25-A3   (hex)		Trimax Wireless, Inc.
+0025A3     (base 16)		Trimax Wireless, Inc.
+				2675 S Horseshoe Dr
+				Naples  FL  34104
+				US
+
+00-25-9C   (hex)		Cisco-Linksys, LLC
+00259C     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-25-C8   (hex)		S-Access GmbH
+0025C8     (base 16)		S-Access GmbH
+				Oberhausenstrasse 47
+				Wettswil a/A  Zuerich  8907
+				CH
+
+00-25-C0   (hex)		ZillionTV Corporation
+0025C0     (base 16)		ZillionTV Corporation
+				1170 Kifer Road
+				Sunnyvale  CA  94086
+				US
+
+00-25-1B   (hex)		Philips CareServant
+00251B     (base 16)		Philips CareServant
+				High Tech Campus 27
+				Eindhoven  Noord-Brabant  5656 AE
+				NL
+
+00-25-18   (hex)		Power PLUS Communications AG
+002518     (base 16)		Power PLUS Communications AG
+				Am Exerzierplatz 2
+				Mannheim  Baden Wuerttemberg  68167
+				DE
+
+00-25-15   (hex)		SFR
+002515     (base 16)		SFR
+				42 Quai du point du jour
+				Boulogne billancourt  .  92659
+				FR
+
+00-25-0D   (hex)		GZT Telkom-Telmor sp. z o.o.
+00250D     (base 16)		GZT Telkom-Telmor sp. z o.o.
+				Mickiewicza 5/7
+				Gdansk  pomorskie  80-425
+				PL
+
+00-25-0E   (hex)		gt german telematics gmbh
+00250E     (base 16)		gt german telematics gmbh
+				Rankestrasse 26
+				Berlin    D-10789
+				DE
+
+00-25-31   (hex)		Cloud Engines, Inc.
+002531     (base 16)		Cloud Engines, Inc.
+				857 Montgomery Street
+				San Francisco  CA  94133
+				US
+
+00-25-2D   (hex)		Kiryung Electronics
+00252D     (base 16)		Kiryung Electronics
+				Kiryung Bldg. 686-70, Sindaebang-dong
+				Seoul    156-010
+				KR
+
+00-25-45   (hex)		Cisco Systems, Inc
+002545     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-42   (hex)		Pittasoft
+002542     (base 16)		Pittasoft
+				#913 Daeryung Techno Town 8th 481-11ga
+				Geumcheon-gu  Seoul  153-775
+				KR
+
+00-25-36   (hex)		Oki Electric Industry Co., Ltd.
+002536     (base 16)		Oki Electric Industry Co., Ltd.
+				1-16-8 Chuou
+				Warabi-shi  Saitama  335-8510
+				JP
+
+00-25-41   (hex)		Maquet Critical Care AB
+002541     (base 16)		Maquet Critical Care AB
+				Röntgenvägen 2
+				Solna    SE-171 95
+				SE
+
+00-25-2B   (hex)		Stirling Energy Systems
+00252B     (base 16)		Stirling Energy Systems
+				Sandia National Labs - NSTTF
+				Albuquerque  NM  87185-1127
+				US
+
+00-25-24   (hex)		Lightcomm Technology Co., Ltd
+002524     (base 16)		Lightcomm Technology Co., Ltd
+				9/F.,Hi-Tech Venture Park Tower A,
+				ShenZhen  GuangDong  518040
+				CN
+
+00-25-4E   (hex)		Vertex Wireless Co., Ltd.
+00254E     (base 16)		Vertex Wireless Co., Ltd.
+				5F, Seohyeon Plaza, 254-5, Seohyeon-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-824
+				KR
+
+00-25-46   (hex)		Cisco Systems, Inc
+002546     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-22   (hex)		ASRock Incorporation
+002522     (base 16)		ASRock Incorporation
+				2F., No. 37, Sec. 2, Jhongyang S. Rd., Beitou District,
+				Taipei    112
+				TW
+
+00-25-60   (hex)		Ibridge Networks & Communications Ltd.
+002560     (base 16)		Ibridge Networks & Communications Ltd.
+				28,Bedford Road East Ham
+				London    E6 2NN
+				GB
+
+00-24-B8   (hex)		free alliance sdn bhd
+0024B8     (base 16)		free alliance sdn bhd
+				B-3-2 Plaza Damas
+				Kuala Lumpur  WP  50480
+				MY
+
+00-24-B3   (hex)		Graf-Syteco GmbH & Co. KG
+0024B3     (base 16)		Graf-Syteco GmbH & Co. KG
+				Kaiserstraße 18
+				Tuningen  Baden-Württemberg  78609
+				DE
+
+00-24-F6   (hex)		MIYOSHI ELECTRONICS CORPORATION
+0024F6     (base 16)		MIYOSHI ELECTRONICS CORPORATION
+				3-13-21 KUSHIRO
+				KAWANISHI-CITY  HYOGO-PREF.  666-0024
+				JP
+
+00-24-F0   (hex)		Seanodes
+0024F0     (base 16)		Seanodes
+				Batiment Platon
+				Colomiers    31770
+				FR
+
+00-24-CB   (hex)		Autonet Mobile
+0024CB     (base 16)		Autonet Mobile
+				2235 Mercury Way Ste. 145
+				Santa Rosa  CA  95407
+				US
+
+00-24-D1   (hex)		Thomson Inc.
+0024D1     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290
+				US
+
+00-24-C9   (hex)		Broadband Solutions Group
+0024C9     (base 16)		Broadband Solutions Group
+				1101 Marina Village Parkway
+				Alameda  CA  94501
+				US
+
+00-24-CA   (hex)		Tobii Technology AB
+0024CA     (base 16)		Tobii Technology AB
+				Karlsrovägen 2D
+				Danderyd    18253
+				SE
+
+00-25-08   (hex)		Maquet Cardiopulmonary AG
+002508     (base 16)		Maquet Cardiopulmonary AG
+				Hechinger Strasse 38
+				Hirrlingen    72145
+				DE
+
+00-24-FC   (hex)		QuoPin Co., Ltd.
+0024FC     (base 16)		QuoPin Co., Ltd.
+				#109, R&D Center for Advanced Technology 68 Yatap-dong Bundang-gu
+				Seongnam  Kyungki-do  463-816
+				KR
+
+00-24-FB   (hex)		Private
+0024FB     (base 16)		Private
+
+00-24-FA   (hex)		Hilger u. Kern GMBH
+0024FA     (base 16)		Hilger u. Kern GMBH
+				Kaefertaler Strasse 253-255
+				Mannheim  Baden-Württemberg  68167
+				DE
+
+00-24-D0   (hex)		Shenzhen SOGOOD Industry CO.,LTD.
+0024D0     (base 16)		Shenzhen SOGOOD Industry CO.,LTD.
+				SOGOOD Science Park,Aviation Road,XiXiang Town,Bao'an District,
+				Shenzhen  Guangzhou  518102
+				CN
+
+00-24-CC   (hex)		Fascinations Toys and Gifts, Inc.
+0024CC     (base 16)		Fascinations Toys and Gifts, Inc.
+				19224 Des Moines Way S
+				Seattle  Washington  98148
+				US
+
+00-24-C7   (hex)		Mobilarm Ltd
+0024C7     (base 16)		Mobilarm Ltd
+				768 Canning Highway
+				  Western Australia  6153
+				AU
+
+00-24-DF   (hex)		Digitalbox Europe GmbH
+0024DF     (base 16)		Digitalbox Europe GmbH
+				Sandstraße 65
+				Ratingen    40878
+				DE
+
+00-24-45   (hex)		Adtran Inc
+002445     (base 16)		Adtran Inc
+				901 Explorer Blvd.
+				Huntsville  AL  35806-2807
+				US
+
+00-24-3F   (hex)		Storwize, Inc.
+00243F     (base 16)		Storwize, Inc.
+				11 Alatlef St.
+				Yehud    56216
+				IL
+
+00-24-97   (hex)		Cisco Systems, Inc
+002497     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-A3   (hex)		Sonim Technologies Inc
+0024A3     (base 16)		Sonim Technologies Inc
+				1875 S.Grant Street
+				Sanmateo  CA  94402
+				US
+
+00-24-AA   (hex)		Dycor Technologies Ltd.
+0024AA     (base 16)		Dycor Technologies Ltd.
+				1851 94 Street
+				Edmonton  Alberta  T6N 1E6
+				CA
+
+00-24-A9   (hex)		Ag Leader Technology
+0024A9     (base 16)		Ag Leader Technology
+				2202 S Riverside Dr.
+				Ames  IA  50010
+				US
+
+00-24-A6   (hex)		TELESTAR DIGITAL GmbH
+0024A6     (base 16)		TELESTAR DIGITAL GmbH
+				Vulkanhöhe / B410
+				Dreis-Brück    54552
+				DE
+
+00-24-9B   (hex)		Action Star Enterprise Co., Ltd.
+00249B     (base 16)		Action Star Enterprise Co., Ltd.
+				10F, No.159, Sec.2, Datong Rd.
+				Xizhi Dist.  New Taipei City  221
+				TW
+
+00-24-71   (hex)		Fusion MultiSystems dba Fusion-io
+002471     (base 16)		Fusion MultiSystems dba Fusion-io
+				6350 S. 3000 E., 6th floor
+				Salt lake City  UT  84121
+				US
+
+00-24-74   (hex)		Autronica Fire And Securirty
+002474     (base 16)		Autronica Fire And Securirty
+				Haakon VII's g.4
+				  Trondheim  N-7483
+				NO
+
+00-24-46   (hex)		MMB Research Inc.
+002446     (base 16)		MMB Research Inc.
+				35 Prince Arthur Ave.
+				Toronto  Ontario  M5R 1B2
+				CA
+
+00-24-63   (hex)		Phybridge Inc
+002463     (base 16)		Phybridge Inc
+				3495 Laird Rd
+				Mississauga  Ontario  L5L5S5
+				CA
+
+00-24-72   (hex)		ReDriven Power Inc.
+002472     (base 16)		ReDriven Power Inc.
+				24A Bath Rd.
+				Iroquois  Ontario  K0E 1K0
+				CA
+
+00-24-1C   (hex)		FuGang Electronic (DG) Co.,Ltd
+00241C     (base 16)		FuGang Electronic (DG) Co.,Ltd
+				Industry Street, Dong-Keng
+				Dong Guan City    523448
+				CN
+
+00-24-19   (hex)		Private
+002419     (base 16)		Private
+
+00-24-15   (hex)		Magnetic Autocontrol GmbH
+002415     (base 16)		Magnetic Autocontrol GmbH
+				Grienmatt 20
+				Schopfheim    D-79650
+				DE
+
+00-23-E7   (hex)		Hinke A/S
+0023E7     (base 16)		Hinke A/S
+				Tingbjergvej 2
+				Bjaeverskov    DK-4632
+				DK
+
+00-23-E2   (hex)		SEA Signalisation
+0023E2     (base 16)		SEA Signalisation
+				20-22 Rue Pierre Mendès France
+				Vaulx en Velin CEDEX    69515
+				FR
+
+00-24-25   (hex)		Shenzhenshi chuangzhicheng Technology Co.,Ltd
+002425     (base 16)		Shenzhenshi chuangzhicheng Technology Co.,Ltd
+				5th Floor,Block2,25th Building,Industrial Zone West Keyuan Sci-tech Garden Nanshan Districh,Shenzhen
+				Shenzhen  Guangdong  518057
+				CN
+
+00-24-27   (hex)		SSI COMPUTER CORP
+002427     (base 16)		SSI COMPUTER CORP
+				4F, NO4, LANE 235, BAO CHIAO ROAD
+				HSIN TIEN  TAIPEI  231
+				TW
+
+00-24-11   (hex)		PharmaSmart LLC
+002411     (base 16)		PharmaSmart LLC
+				3495 Winton Place
+				Rochester  NY  14623
+				US
+
+00-24-0F   (hex)		Ishii Tool & Engineering Corporation
+00240F     (base 16)		Ishii Tool & Engineering Corporation
+				2-5-60 Higashi-Omichi
+				Oita    870-0823
+				JP
+
+00-23-FA   (hex)		RG Nets, Inc.
+0023FA     (base 16)		RG Nets, Inc.
+				316 California Ave.
+				Reno  NV  89501
+				US
+
+00-23-F2   (hex)		TVLogic
+0023F2     (base 16)		TVLogic
+				suite 914 ACE Techno Tower-9th
+				Geumcheon-gu  SEOUL  153-782
+				KR
+
+00-24-0A   (hex)		US Beverage Net
+00240A     (base 16)		US Beverage Net
+				1001 W. Fayette Street
+				Syracuse  NY  13204
+				US
+
+00-24-07   (hex)		TELEM SAS
+002407     (base 16)		TELEM SAS
+				16, RUE DE L'ETANG
+				GIERES  RHONE ALPES  38610
+				FR
+
+00-24-40   (hex)		Halo Monitoring, Inc.
+002440     (base 16)		Halo Monitoring, Inc.
+				515 Sparkman Dr.
+				Huntsville  AL  35816
+				US
+
+00-23-CF   (hex)		CUMMINS-ALLISON CORP.
+0023CF     (base 16)		CUMMINS-ALLISON CORP.
+				891 FEEHANVILLE DRIVE
+				MT. PROSPECT  IL  60056
+				US
+
+00-23-C2   (hex)		SAMSUNG Electronics. Co. LTD
+0023C2     (base 16)		SAMSUNG Electronics. Co. LTD
+				19th Fl., Korea Life Bldg. 1338-12
+				Seoul    137-860
+				KR
+
+00-23-C4   (hex)		Lux Lumen
+0023C4     (base 16)		Lux Lumen
+				Kernenergiestraat 53A
+				Wilrijk  Antwerp  2610
+				BE
+
+00-23-C5   (hex)		Radiation Safety and Control Services Inc
+0023C5     (base 16)		Radiation Safety and Control Services Inc
+				91 Portsmouth Ave
+				Stratham  New Hampshire  03885
+				US
+
+00-23-C6   (hex)		SMC Corporation
+0023C6     (base 16)		SMC Corporation
+				4-2-2, Kinunodai
+				Tsukuba Mirai-shi  Ibaraki-ken  300-2493
+				JP
+
+00-23-88   (hex)		V.T. Telematica S.p.a.
+002388     (base 16)		V.T. Telematica S.p.a.
+				Via Gorky, 21
+				San Giuliano Milanese  Milano  20098
+				IT
+
+00-23-86   (hex)		Tour & Andersson AB
+002386     (base 16)		Tour & Andersson AB
+				Annelund
+				Ljung    524 80
+				US
+
+00-23-83   (hex)		InMage Systems Inc
+002383     (base 16)		InMage Systems Inc
+				3255-1 Scott Blvd, #104
+				Santa Clara  CA  95054
+				US
+
+00-23-81   (hex)		Lengda Technology(Xiamen) Co.,Ltd.
+002381     (base 16)		Lengda Technology(Xiamen) Co.,Ltd.
+				5/F, 47 Haijing South 2nd Road,Xiamen Export Processing Zone, Haicang District,
+				Xiamen  Fujian  361026
+				CN
+
+00-23-BF   (hex)		Mainpine, Inc.
+0023BF     (base 16)		Mainpine, Inc.
+				PO Box 241
+				Wilsonville  Oregon  97070-0241
+				US
+
+00-23-B2   (hex)		Intelligent Mechatronic Systems Inc
+0023B2     (base 16)		Intelligent Mechatronic Systems Inc
+				161 Roger Street
+				Waterloo  Ontario  N2J 1B1
+				CA
+
+00-23-B5   (hex)		ORTANA LTD
+0023B5     (base 16)		ORTANA LTD
+				OSTIM KOCASINAN SANAYI SITESI
+				ANKARA    06370
+				TR
+
+00-23-B9   (hex)		 Airbus Defence and Space Deutschland GmbH
+0023B9     (base 16)		 Airbus Defence and Space Deutschland GmbH
+				Willy-Messerschmitt-Strasse 1,
+				Taufkirchen    82024 
+				DE
+
+00-23-BD   (hex)		Digital Ally, Inc.
+0023BD     (base 16)		Digital Ally, Inc.
+				1218 Valley Ridge Drive
+				Grain Valley  MO  64029
+				US
+
+00-23-D5   (hex)		WAREMA electronic GmbH
+0023D5     (base 16)		WAREMA electronic GmbH
+				Dillberg 33
+				Marktheidenfeld  Bavaria  97828
+				DE
+
+00-23-C9   (hex)		Sichuan Tianyi Information Science & Technology Stock CO.,LTD
+0023C9     (base 16)		Sichuan Tianyi Information Science & Technology Stock CO.,LTD
+				No.1,Hot Spring Highway,Dayi County
+				Chengdu  Sichuan  611330
+				US
+
+00-23-CE   (hex)		KITA DENSHI CORPORATION
+0023CE     (base 16)		KITA DENSHI CORPORATION
+				12F TOKYO-NISHIIKEBUKURO Bilg.,
+				Toshima-ku,  Tokyo  171-0021
+				JP
+
+00-23-A9   (hex)		Beijing Detianquan Electromechanical Equipment Co., Ltd
+0023A9     (base 16)		Beijing Detianquan Electromechanical Equipment Co., Ltd
+				No. 2 Chapeng Road, Haidian District,
+				Beijing    100091
+				CN
+
+00-23-A7   (hex)		Redpine Signals, Inc.
+0023A7     (base 16)		Redpine Signals, Inc.
+				Plot 87, Sagar Society
+				Hyderabad  AP  500034
+				IN
+
+00-23-9B   (hex)		Elster Solutions, LLC
+00239B     (base 16)		Elster Solutions, LLC
+				208 South Rogers Lane
+				Raleigh  North Carolina  27610
+				US
+
+00-23-7B   (hex)		WHDI LLC
+00237B     (base 16)		WHDI LLC
+				2350 Mission College Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-23-24   (hex)		G-PRO COMPUTER
+002324     (base 16)		G-PRO COMPUTER
+				first arrange C, YingHu industrial estate
+				DongGuan City  GuangDong Province  523648
+				CN
+
+00-23-E0   (hex)		INO Therapeutics LLC
+0023E0     (base 16)		INO Therapeutics LLC
+				2902 Dairy Drive
+				Madison  WI  53718
+				US
+
+00-23-90   (hex)		Algolware Corporation
+002390     (base 16)		Algolware Corporation
+				13F-5, No. 77, Sec. 1, Sintai 5th Rd.,
+				Taipei County  Taiwan  221
+				TW
+
+00-23-11   (hex)		Gloscom Co., Ltd.
+002311     (base 16)		Gloscom Co., Ltd.
+				#507 Changhyun Bldg.
+				Anyang City  Kyunggo-do  431-080
+				KR
+
+00-23-09   (hex)		Janam Technologies LLC
+002309     (base 16)		Janam Technologies LLC
+				100 Crossways Park West
+				Woodbury  NY  11797
+				US
+
+00-23-04   (hex)		Cisco Systems, Inc
+002304     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-5D   (hex)		Cisco Systems, Inc
+00235D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-5C   (hex)		Aprius, Inc.
+00235C     (base 16)		Aprius, Inc.
+				440 N. Wolfe Rd
+				Sunnyvale  CA  94085
+				US
+
+00-23-52   (hex)		DATASENSOR S.p.A.
+002352     (base 16)		DATASENSOR S.p.A.
+				Via Lavino, 265
+				Monte San Pietro (BO)    40050
+				IT
+
+00-23-2F   (hex)		Advanced Card Systems Ltd.
+00232F     (base 16)		Advanced Card Systems Ltd.
+				Unit 2010-13, Chevalier Commercial Centre,
+				Kowloon Bay,  SAR  
+				HK
+
+00-23-53   (hex)		F E T Elettronica snc
+002353     (base 16)		F E T Elettronica snc
+				Via Alessandro Manzoni 14/a
+				Poggibonsi  Siena  53036
+				IT
+
+00-23-42   (hex)		Coffee Equipment Company
+002342     (base 16)		Coffee Equipment Company
+				4216 6th Ave NW
+				Seattle  WA  98107
+				US
+
+00-23-37   (hex)		Global Star Solutions ULC
+002337     (base 16)		Global Star Solutions ULC
+				4600 Jacombs Road
+				Richmond  BC  V6V 3B1
+				CA
+
+00-23-19   (hex)		Sielox LLC
+002319     (base 16)		Sielox LLC
+				170 East Ninth Ave.
+				Runnemede  NJ  08078
+				US
+
+00-23-6A   (hex)		SmartRG Inc
+00236A     (base 16)		SmartRG Inc
+				501 SE Columbia Shores Blvd
+				Vancouver  WA  98661
+				US
+
+00-23-31   (hex)		Nintendo Co., Ltd.
+002331     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-23-35   (hex)		Linkflex Co.,Ltd
+002335     (base 16)		Linkflex Co.,Ltd
+				5F. Min Young Bldg. 175-2
+				Seoul    135-010
+				KR
+
+00-23-25   (hex)		IOLAN Holding
+002325     (base 16)		IOLAN Holding
+				Mon Plaisir 26
+				Etten Leur    4879AN
+				NL
+
+00-23-21   (hex)		Avitech International Corp
+002321     (base 16)		Avitech International Corp
+				15333 NE 90th Street
+				Redmond  WA  98052
+				US
+
+00-23-70   (hex)		Snell
+002370     (base 16)		Snell
+				Hartman House
+				Reading  Berks  RG6 4PB
+				GB
+
+00-22-B9   (hex)		Analogix Seminconductor, Inc
+0022B9     (base 16)		Analogix Seminconductor, Inc
+				3211 Scott Blvd., Suite 100
+				Santa Clara  CA  95054
+				US
+
+00-22-B8   (hex)		Norcott
+0022B8     (base 16)		Norcott
+				Brookfield House, Grimsditch Lane off Tarporley Road
+				Cheshire    WA4 4EA
+				GB
+
+00-22-B7   (hex)		GSS Grundig SAT-Systems GmbH
+0022B7     (base 16)		GSS Grundig SAT-Systems GmbH
+				Beutherner Strasse 43
+				Nuernberg  Bayern  90471
+				DE
+
+00-22-B3   (hex)		Sei S.p.A.
+0022B3     (base 16)		Sei S.p.A.
+				Via Ruffilli, 1
+				Curno  Bergamo  24035
+				IT
+
+00-22-9C   (hex)		Verismo Networks Inc
+00229C     (base 16)		Verismo Networks Inc
+				295 Bernando Avenue
+				Mountain View  CA  94043
+				US
+
+00-22-9A   (hex)		Lastar, Inc.
+00229A     (base 16)		Lastar, Inc.
+				3555 Kettering BLVD.
+				Moraine  Ohio  45439
+				US
+
+00-22-EE   (hex)		Algo Communication Products Ltd
+0022EE     (base 16)		Algo Communication Products Ltd
+				4500 Beedie Street
+				Burnaby  BC  V5J 5L2
+				CA
+
+00-22-EA   (hex)		Rustelcom Inc.
+0022EA     (base 16)		Rustelcom Inc.
+				Garagniy proezd, 1
+				St.-Petersburg    192288
+				RU
+
+00-22-F0   (hex)		3 Greens Aviation Limited
+0022F0     (base 16)		3 Greens Aviation Limited
+				10 Hedingham Close
+				Macclesfield    SK10 3LZ
+				GB
+
+00-22-EC   (hex)		IDEALBT TECHNOLOGY CORPORATION
+0022EC     (base 16)		IDEALBT TECHNOLOGY CORPORATION
+				6F., NO.8, LANE 345, YANGGUANG ST., NEIHU DISTRICT
+				Taipei    114
+				TW
+
+00-22-DD   (hex)		Protecta Electronics Ltd
+0022DD     (base 16)		Protecta Electronics Ltd
+				Kesmark str 7/A
+				Budapest  Hungary  1158
+				HU
+
+00-22-AB   (hex)		Shenzhen Turbosight Technology Ltd
+0022AB     (base 16)		Shenzhen Turbosight Technology Ltd
+				Unit C-8A,Shennan Garden Bldg,Hightech Park,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-22-9B   (hex)		AverLogic Technologies, Inc.
+00229B     (base 16)		AverLogic Technologies, Inc.
+				7F-2, No.2, Lane 258, Rui Guang Rd., Nei-Hu Dist.,
+				Taipei  Taiwan  114
+				TW
+
+00-22-BE   (hex)		Cisco Systems, Inc
+0022BE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-BF   (hex)		SieAmp Group of Companies
+0022BF     (base 16)		SieAmp Group of Companies
+				2 Ang Mo Kio Street 64
+				Singapore    569084
+				US
+
+00-22-DB   (hex)		Translogic Corporation
+0022DB     (base 16)		Translogic Corporation
+				10825 E. 47th Avenue
+				Denver  Colorado  80239
+				US
+
+00-22-DA   (hex)		ANATEK, LLC
+0022DA     (base 16)		ANATEK, LLC
+				3219 East Camelback Road
+				Phoenix  AZ  85018
+				US
+
+00-22-F9   (hex)		Pollin Electronic GmbH
+0022F9     (base 16)		Pollin Electronic GmbH
+				Max-Pollin-Str. 1
+				Pfoerring    85104
+				DE
+
+00-22-C5   (hex)		INFORSON Co,Ltd.
+0022C5     (base 16)		INFORSON Co,Ltd.
+				Room 704,Tower B1, ChangYuanTianDi Plaza
+				BeiJing City    100080
+				CN
+
+00-22-62   (hex)		BEP Marine
+002262     (base 16)		BEP Marine
+				13 Tarndale Grove Albany
+				Auckland    0632
+				NZ
+
+00-22-6A   (hex)		Honeywell
+00226A     (base 16)		Honeywell
+				8840 Evergreen Blvd.
+				Minneapolis  MN  55433-6040
+				US
+
+00-22-63   (hex)		Koos Technical Services, Inc.
+002263     (base 16)		Koos Technical Services, Inc.
+				1025 Greenwood Blvd.
+				Lake Mary  FL  32746
+				US
+
+00-22-6C   (hex)		LinkSprite Technologies, Inc.
+00226C     (base 16)		LinkSprite Technologies, Inc.
+				1410 Cannon Mountain Dr
+				Longmont  CO  80503
+				US
+
+00-22-5C   (hex)		Multimedia & Communication Technology
+00225C     (base 16)		Multimedia & Communication Technology
+				Digital Empire D-801 #980-3
+				Suwon-City  KyeongGi-Do  443-813
+				KR
+
+00-22-84   (hex)		DESAY A&V SCIENCE AND TECHNOLOGY CO.,LTD
+002284     (base 16)		DESAY A&V SCIENCE AND TECHNOLOGY CO.,LTD
+				DESAY 3rd Zone,Chenjiang,
+				Huizhou  Guangdong  516229
+				CN
+
+00-22-86   (hex)		ASTRON
+002286     (base 16)		ASTRON
+				Oudehoogeveensedijk 4
+				Dwingeloo  Drenthe  7991PD
+				NL
+
+00-22-82   (hex)		8086 Consultancy
+002282     (base 16)		8086 Consultancy
+				17 Lowfield Lane
+				Newark  Notts  NG24 3HJ
+				GB
+
+00-22-46   (hex)		Evoc Intelligent Technology Co.,Ltd.
+002246     (base 16)		Evoc Intelligent Technology Co.,Ltd.
+				No.31 Gaoxin Centeral Avenue 4th Road,Nanshan District Shenzhen City
+				Shenzhen  Guangdong  518057
+				CN
+
+00-22-48   (hex)		Microsoft Corporation
+002248     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+00-22-90   (hex)		Cisco Systems, Inc
+002290     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-8A   (hex)		Teratronik elektronische systeme gmbh
+00228A     (base 16)		Teratronik elektronische systeme gmbh
+				Karl-Ulrich-Strasse 1
+				Gross-Umstadt    D-64823
+				DE
+
+00-22-8E   (hex)		TV-NUMERIC
+00228E     (base 16)		TV-NUMERIC
+				24-26 rue Louis Armand
+				Paris    75015
+				FR
+
+00-22-54   (hex)		Bigelow Aerospace
+002254     (base 16)		Bigelow Aerospace
+				1899 W. Brooks Ave
+				North Las Vegas  NV  89032
+				US
+
+00-22-57   (hex)		3COM EUROPE LTD
+002257     (base 16)		3COM EUROPE LTD
+				Peoplebuilding 2
+				Hemel Hempstead  HERTS.  HP2 4NW
+				GB
+
+00-22-76   (hex)		Triple EYE B.V.
+002276     (base 16)		Triple EYE B.V.
+				Vaassenseweg 71
+				Emst    8166 AT
+				NL
+
+00-22-74   (hex)		FamilyPhone AB
+002274     (base 16)		FamilyPhone AB
+				Anckargripsgatan 3
+				Malmö    21119
+				SE
+
+00-22-36   (hex)		VECTOR SP. Z O.O.
+002236     (base 16)		VECTOR SP. Z O.O.
+				KRZEMOWA 6
+				GDYNIA    81-577
+				PL
+
+00-22-30   (hex)		FutureLogic Inc.
+002230     (base 16)		FutureLogic Inc.
+				425 E. Colorado St., Ste. 100
+				Glendale  CA  91205
+				US
+
+00-22-2E   (hex)		maintech GmbH
+00222E     (base 16)		maintech GmbH
+				Seeweg 60
+				Höchberg  Bavaria  97204
+				DE
+
+00-22-14   (hex)		RINNAI KOREA
+002214     (base 16)		RINNAI KOREA
+				560-2, Shibjong-1dong, Pupyoung-gu
+				Pupyoung-gu  Incheon  403-847
+				KR
+
+00-22-0B   (hex)		National Source Coding Center
+00220B     (base 16)		National Source Coding Center
+				Suite 701,Power Creative A,No.1
+				Beijing    100085
+				CN
+
+00-22-0C   (hex)		Cisco Systems, Inc
+00220C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-EA   (hex)		Bystronic Laser AG
+0021EA     (base 16)		Bystronic Laser AG
+				Industriestrasse 21
+				3362  Niederönz  
+				CH
+
+00-21-FD   (hex)		LACROIX TRAFFIC S.A.U
+0021FD     (base 16)		LACROIX TRAFFIC S.A.U
+				Majada 4
+				Tres Cantos  Madrid  28760
+				ES
+
+00-21-CD   (hex)		LiveTV
+0021CD     (base 16)		LiveTV
+				1333 Gateway Drive, Suite 1007
+				Melbourne  Florida  32901
+				US
+
+00-21-D0   (hex)		Global Display Solutions Spa
+0021D0     (base 16)		Global Display Solutions Spa
+				Via Tezze, 20/A
+				Cornedo Vicentino  Vicenza  36073
+				IT
+
+00-22-28   (hex)		Breeze Innovations Ltd.
+002228     (base 16)		Breeze Innovations Ltd.
+				Har Hotzvim, P.O. Box 45397
+				Jerusalem  Israel  91451
+				IL
+
+00-22-29   (hex)		Compumedics Ltd
+002229     (base 16)		Compumedics Ltd
+				30 - 40 Flockhart Street
+				Abbotsford  Victoria  3067
+				AU
+
+00-22-16   (hex)		SHIBAURA VENDING MACHINE CORPORATION
+002216     (base 16)		SHIBAURA VENDING MACHINE CORPORATION
+				Ekimae-cho13-10
+				Obama-shi  Fukui-ken  917-0077
+				JP
+
+00-21-E1   (hex)		Nortel Networks
+0021E1     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-22-00   (hex)		IBM Corp
+002200     (base 16)		IBM Corp
+				2051 Mission College Blvd 
+				Santa Clara  CA  95054
+				US
+
+00-21-C6   (hex)		CSJ Global, Inc.
+0021C6     (base 16)		CSJ Global, Inc.
+				9th Fl. Samwhan Bldg. Annex, 17-26 Yeouido-dong,
+				Seoul    150-874
+				KR
+
+00-21-C3   (hex)		CORNELL Communications, Inc.
+0021C3     (base 16)		CORNELL Communications, Inc.
+				7915 N. 81st Street
+				Milwaukee  Wisconsin  53223
+				US
+
+00-21-C7   (hex)		Russound
+0021C7     (base 16)		Russound
+				5 Forbes Road
+				Newmarket  NH  03857
+				US
+
+00-21-C1   (hex)		ABB Oy / Medium Voltage Products
+0021C1     (base 16)		ABB Oy / Medium Voltage Products
+				PO Box 699
+				Vaasa    FI-65101
+				FI
+
+00-21-C0   (hex)		Mobile Appliance, Inc.
+0021C0     (base 16)		Mobile Appliance, Inc.
+				#819 Kranz Techno,
+				Seong nam  Gyeonggi-Do  462-729
+				KR
+
+00-21-BB   (hex)		Riken Keiki Co., Ltd.
+0021BB     (base 16)		Riken Keiki Co., Ltd.
+				 2-7-6 Azusawa
+				Itabashi-Ku  Tokyo  174-8744
+				JP
+
+00-21-66   (hex)		NovAtel Inc.
+002166     (base 16)		NovAtel Inc.
+				1120 - 68 Ave NE
+				Calgary  Alberta  T2E 8S5
+				CA
+
+00-21-64   (hex)		Special Design Bureau for Seismic Instrumentation
+002164     (base 16)		Special Design Bureau for Seismic Instrumentation
+				129, Krainyaya Str.
+				Saratov  Saratov region  410019
+				RU
+
+00-21-60   (hex)		Hidea Solutions Co. Ltd.
+002160     (base 16)		Hidea Solutions Co. Ltd.
+				4F, Do&Can house Dldg., #656-1683, Seongsu 1-ga 2-dong, Seongdong-gu
+				Seoul    656-1683
+				KR
+
+00-21-B1   (hex)		DIGITAL SOLUTIONS LTD
+0021B1     (base 16)		DIGITAL SOLUTIONS LTD
+				Tsarigradsko Shose 7km BLVD
+				Sofia  Sofia  1784
+				BG
+
+00-21-B0   (hex)		Tyco Telecommunications
+0021B0     (base 16)		Tyco Telecommunications
+				1011 Pawtucket Blvd
+				Lowell  Massachusetts  01853
+				US
+
+00-21-AD   (hex)		Nordic ID Oy
+0021AD     (base 16)		Nordic ID Oy
+				Myllyojankatu 2A
+				SALO    FIN-24100
+				FI
+
+00-21-7F   (hex)		Intraco Technology Pte Ltd
+00217F     (base 16)		Intraco Technology Pte Ltd
+				750e Chai Chee Road #05-01
+				Singapore    4690005
+				SG
+
+00-21-7D   (hex)		PYXIS S.R.L.
+00217D     (base 16)		PYXIS S.R.L.
+				C/O DIP. INFORMATICA E SISTEMISTICA - UNIVERSITY OF PAVIA
+				PAVIA    27100
+				IT
+
+00-21-6F   (hex)		SymCom, Inc.
+00216F     (base 16)		SymCom, Inc.
+				2880 North Plaza Drive
+				Rapid City  SD  57702
+				US
+
+00-21-A3   (hex)		Micromint
+0021A3     (base 16)		Micromint
+				111 Commerce St
+				Lake Mary  FL  32746
+				US
+
+00-21-A5   (hex)		ERLPhase Power Technologies Ltd.
+0021A5     (base 16)		ERLPhase Power Technologies Ltd.
+				74 Scurfield Blvd.
+				Winnipeg  Manitoba  R3Y 1G4
+				CA
+
+00-21-9D   (hex)		Adesys BV
+00219D     (base 16)		Adesys BV
+				Molenweer 4
+				Wateringen  Zuid Holland  2291 NR
+				NL
+
+00-21-95   (hex)		GWD Media Limited
+002195     (base 16)		GWD Media Limited
+				10 Leeds Road
+				Sheffield  South Yorkshire  S9 3TY
+				GB
+
+00-21-88   (hex)		EMC Corporation
+002188     (base 16)		EMC Corporation
+				2421 Mission College Blvd
+				Santa Clara  CA  95050
+				US
+
+00-21-1A   (hex)		LInTech Corporation
+00211A     (base 16)		LInTech Corporation
+				Krasnokazarmennaya st., 12
+				Moscow    111250
+				RU
+
+00-21-16   (hex)		Transcon Electronic Systems, spol. s r. o.
+002116     (base 16)		Transcon Electronic Systems, spol. s r. o.
+				Kvapilova 2133
+				Frydek-Mistek    73802
+				CZ
+
+00-21-15   (hex)		PHYWE Systeme GmbH & Co. KG
+002115     (base 16)		PHYWE Systeme GmbH & Co. KG
+				Robert-Bosch-Breite 10
+				Goettingen  Niedersachsen  37079
+				DE
+
+00-21-41   (hex)		RADLIVE
+002141     (base 16)		RADLIVE
+				4 Hanechoshet St.
+				Tel Aviv    69710
+				IL
+
+00-21-40   (hex)		EN Technologies Inc.
+002140     (base 16)		EN Technologies Inc.
+				Geumbok Bldg. 9F, Band-yi-dong 45-2, Songpa-gu
+				Seoul    138-828
+				KR
+
+00-21-3D   (hex)		Cermetek Microelectronics, Inc.
+00213D     (base 16)		Cermetek Microelectronics, Inc.
+				374 Turquoise Street
+				Milpitas  CA  95035
+				US
+
+00-21-11   (hex)		Uniphone Inc.
+002111     (base 16)		Uniphone Inc.
+				795 Main Street
+				Half Moon Bay  CA  94019
+				US
+
+00-21-14   (hex)		Hylab Technology Inc.
+002114     (base 16)		Hylab Technology Inc.
+				15F-2.,No.872,Jhongjheng Rd.
+				Jhonghe City,  Taipei  235
+				TW
+
+00-21-32   (hex)		Masterclock, Inc.
+002132     (base 16)		Masterclock, Inc.
+				2484 W. Clay St.
+				St. Charles  MO  63301
+				US
+
+00-21-31   (hex)		Blynke Inc.
+002131     (base 16)		Blynke Inc.
+				133 Richmond St. West
+				Toronto  Ontario  M5H 2L3
+				CA
+
+00-21-29   (hex)		Cisco-Linksys, LLC
+002129     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-21-1D   (hex)		Dataline AB
+00211D     (base 16)		Dataline AB
+				Katrinedalsgatan 53
+				Borås    S-50451
+				SE
+
+00-21-20   (hex)		Sequel Technologies
+002120     (base 16)		Sequel Technologies
+				2951 Cleveland Ave N
+				Roseville  MN  55113
+				US
+
+00-21-52   (hex)		General Satellite Research & Development Limited
+002152     (base 16)		General Satellite Research & Development Limited
+				Lit. E, building 2, 4 Novoladozhskaya str
+				Saint Petersburg    197110
+				RU
+
+00-21-58   (hex)		Style Flying Technology Co.
+002158     (base 16)		Style Flying Technology Co.
+				22/F,Cyber Tower B,No.2 Zhong Guan Cun South Street,Haidian District,
+				Beijing    100086
+				CN
+
+00-21-48   (hex)		Kaco Solar Korea
+002148     (base 16)		Kaco Solar Korea
+				Chung-won-ku Sang-dea-won-dong 333-1
+				Songnam  Kyung-kido  462-806
+				KR
+
+00-21-3C   (hex)		AliphCom
+00213C     (base 16)		AliphCom
+				150 Executive Park Blvd
+				San Francisco  CA  94134
+				US
+
+00-1F-B5   (hex)		I/O Interconnect Inc.
+001FB5     (base 16)		I/O Interconnect Inc.
+				1202 E Wakeham Ave
+				Santa Ana  CA  92708
+				US
+
+00-1F-E7   (hex)		Simet
+001FE7     (base 16)		Simet
+				Strada del Portone 129
+				Grugliasco  Torino  10095
+				IT
+
+00-1F-DB   (hex)		Network Supply Corp.,
+001FDB     (base 16)		Network Supply Corp.,
+				1938 NAKADAIRA KANAE
+				IIDA  NAGANO  395-0801
+				JP
+
+00-1F-BF   (hex)		Fulhua Microelectronics Corp. Taiwan Branch
+001FBF     (base 16)		Fulhua Microelectronics Corp. Taiwan Branch
+				1F, No.12, R&D Road,
+				Hsin-Chu, 300    886
+				TW
+
+00-1F-BE   (hex)		Shenzhen Mopnet Industrial Co.,Ltd
+001FBE     (base 16)		Shenzhen Mopnet Industrial Co.,Ltd
+				3F.No.3 Keyuan Rd.,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1F-C2   (hex)		Jow Tong Technology Co Ltd
+001FC2     (base 16)		Jow Tong Technology Co Ltd
+				46 Lane 337 Chung Cheng Rd
+				Yung Kang City  Tainan County  71066
+				TW
+
+00-1F-D2   (hex)		COMMTECH TECHNOLOGY MACAO COMMERCIAL OFFSHORE LTD.
+001FD2     (base 16)		COMMTECH TECHNOLOGY MACAO COMMERCIAL OFFSHORE LTD.
+				31,TAI YIP STREET, 7/F KWUN TONG,
+				KOWLOON,  HONGKONG  
+				CN
+
+00-1F-B8   (hex)		Universal Remote Control, Inc.
+001FB8     (base 16)		Universal Remote Control, Inc.
+				500 Mamaroneck Avenue
+				Harrison  NY  10528
+				US
+
+00-1F-D4   (hex)		4IPNET, INC.
+001FD4     (base 16)		4IPNET, INC.
+				38129 CAMBRIDGE COURT
+				FREMONT  CA  94536
+				US
+
+00-1F-CB   (hex)		NIW Solutions
+001FCB     (base 16)		NIW Solutions
+				P.O. Box 62
+				One Tree Hill  South Australia  5114
+				AU
+
+00-1F-F7   (hex)		Nakajima All Precision Co., Ltd.
+001FF7     (base 16)		Nakajima All Precision Co., Ltd.
+				Kami-Gomyo1480
+				Hanishina-Gun  Nagano-Ken  389-0606
+				JP
+
+00-1F-EB   (hex)		Trio Datacom Pty Ltd
+001FEB     (base 16)		Trio Datacom Pty Ltd
+				41 Aster Avenue
+				Carrum Downs  Victoria  3201
+				AU
+
+00-1F-69   (hex)		Pingood Technology Co., Ltd.
+001F69     (base 16)		Pingood Technology Co., Ltd.
+				Rm1917, South Block, Cangsong Bldg., Tairan Industrial Zone, Futian District
+				Shenzhen  Guangdong  518040
+				CN
+
+00-1F-4D   (hex)		Segnetics LLC
+001F4D     (base 16)		Segnetics LLC
+				Shkiperski protok 14
+				Saint-Petersburg    199106
+				RU
+
+00-1F-81   (hex)		Accel Semiconductor Corp
+001F81     (base 16)		Accel Semiconductor Corp
+				1F,Mainbldg,149 Chun Xiao Road,
+				Shanghai    201203
+				CN
+
+00-1F-83   (hex)		Teleplan Technology Services Sdn Bhd
+001F83     (base 16)		Teleplan Technology Services Sdn Bhd
+				2580, Tingkat Perusahaan 4B
+				Perai  Penang  13600
+				MY
+
+00-1F-9B   (hex)		POSBRO
+001F9B     (base 16)		POSBRO
+				ShinyoungGtower 6F, 271-1
+				Seongnam-si  Kyunggi-do  463-824
+				KR
+
+00-1F-78   (hex)		Blue Fox Porini Textile
+001F78     (base 16)		Blue Fox Porini Textile
+				1208 Pointe Centre Drive
+				Chattanooga  TN  37421
+				US
+
+00-1F-68   (hex)		Martinsson Elektronik AB
+001F68     (base 16)		Martinsson Elektronik AB
+				Box 9060
+				Hägersten  Stockholm  126 09
+				SE
+
+00-1F-63   (hex)		JSC Goodwin-Europa
+001F63     (base 16)		JSC Goodwin-Europa
+				20/5 Marksistskaya st.
+				Moscow    109147
+				RU
+
+00-1F-AD   (hex)		Brown Innovations, Inc
+001FAD     (base 16)		Brown Innovations, Inc
+				369 Congress Street
+				Boston  MA  02210
+				US
+
+00-1F-A6   (hex)		Stilo srl
+001FA6     (base 16)		Stilo srl
+				Via Besana, 4
+				20122  Milano  
+				IT
+
+00-1F-97   (hex)		BERTANA srl
+001F97     (base 16)		BERTANA srl
+				Viale GALILEO FERRARIS 27
+				BRUINO  TORINO  10090
+				IT
+
+00-1F-8C   (hex)		CCS Inc.
+001F8C     (base 16)		CCS Inc.
+				Shimodachiuri-agaru
+				Kyoto  Kyoto  602-8011
+				JP
+
+00-1F-10   (hex)		TOLEDO DO BRASIL INDUSTRIA DE BALANCAS  LTDA
+001F10     (base 16)		TOLEDO DO BRASIL INDUSTRIA DE BALANCAS  LTDA
+				RUA MANOEL CREMONESI, 1
+				SAO BERNARDO DO CAMPO  SP  09851-900
+				BR
+
+00-1F-0F   (hex)		Select Engineered Systems
+001F0F     (base 16)		Select Engineered Systems
+				7991 W. 26 Ave
+				Hialeah  Florida  33016
+				US
+
+00-1F-02   (hex)		Pixelmetrix Corporation Pte Ltd
+001F02     (base 16)		Pixelmetrix Corporation Pte Ltd
+				31 Kaki Bukit Road 3
+				    417818
+				SG
+
+00-1E-FE   (hex)		LEVEL s.r.o.
+001EFE     (base 16)		LEVEL s.r.o.
+				Plhovska 1997
+				Nachod    547 01
+				CZ
+
+00-1F-1A   (hex)		Prominvest
+001F1A     (base 16)		Prominvest
+				7, Bobruiskaya ulica
+				Saint-Petersburg  North-West Federal District  195009
+				RU
+
+00-1F-18   (hex)		Hakusan.Mfg.Co,.Ltd
+001F18     (base 16)		Hakusan.Mfg.Co,.Ltd
+				Tomin-Kougyou-Ikebukuro BLD.5F
+				Tosima Ward  Tokyo-Met.  171-0022
+				JP
+
+00-1F-13   (hex)		S.& A.S. Ltd.
+001F13     (base 16)		S.& A.S. Ltd.
+				Boutros Bldg. 1st bsmt
+				Beirut    2067 7808
+				LB
+
+00-1F-25   (hex)		MBS GmbH
+001F25     (base 16)		MBS GmbH
+				Römerstraße 15
+				Krefeld  Nordrhein-Westfalen  47809
+				DE
+
+00-1F-27   (hex)		Cisco Systems, Inc
+001F27     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-26   (hex)		Cisco Systems, Inc
+001F26     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-EF   (hex)		Cantronic International Limited
+001EEF     (base 16)		Cantronic International Limited
+				Unit 515-516, Building 15, East Wing, No 8 Science Park West Avenue, Hong Kong Science Park Phase II
+				Shatin  New Territories  852
+				HK
+
+00-1E-DE   (hex)		BYD COMPANY LIMITED
+001EDE     (base 16)		BYD COMPANY LIMITED
+				NO.1,Baoping Road,Baolong Industrial Town,Longgang
+				SHEN ZHEN  Guangdong  518116
+				CN
+
+00-1E-DD   (hex)		WASKO S.A.
+001EDD     (base 16)		WASKO S.A.
+				Berbeckiego 6
+				Gliwice  Silesia  44-100
+				PL
+
+00-1E-DB   (hex)		Giken Trastem Co., Ltd.
+001EDB     (base 16)		Giken Trastem Co., Ltd.
+				4-1 Takeda Dankawaracho Fushimiku
+				Kyoto    612-8414
+				JP
+
+00-1F-42   (hex)		Etherstack plc
+001F42     (base 16)		Etherstack plc
+				80 Abercrombie Street
+				Chippendale  NSW  2008
+				AU
+
+00-1F-35   (hex)		AIR802 LLC
+001F35     (base 16)		AIR802 LLC
+				1169 Banyon Court
+				Naperville  IL  60540
+				US
+
+00-1F-34   (hex)		Lung Hwa Electronics Co., Ltd.
+001F34     (base 16)		Lung Hwa Electronics Co., Ltd.
+				3F, 248, Pei Sheng Rd. Sec. 3,
+				Taipei  Hsien  222
+				TW
+
+00-1E-EB   (hex)		Talk-A-Phone Co.
+001EEB     (base 16)		Talk-A-Phone Co.
+				5013 N. Kedzie Ave.
+				Chicago  IL  60625
+				US
+
+00-1E-6A   (hex)		Beijing Bluexon Technology Co.,Ltd
+001E6A     (base 16)		Beijing Bluexon Technology Co.,Ltd
+				Jinqiuzhichun 7-301,Zhichun Rd.,
+				Beijing    100088
+				CN
+
+00-1E-66   (hex)		RESOL Elektronische Regelungen GmbH
+001E66     (base 16)		RESOL Elektronische Regelungen GmbH
+				Heiskampstraße 10
+				Hattingen  NRW  45527
+				DE
+
+00-1E-63   (hex)		Vibro-Meter SA
+001E63     (base 16)		Vibro-Meter SA
+				Route de Moncor 4
+				Fribourg    CH-1701
+				CH
+
+00-1E-7F   (hex)		CBM of America
+001E7F     (base 16)		CBM of America
+				1455 West Newport Center Drive
+				Deerfield Beach  Florida  33442
+				US
+
+00-1E-82   (hex)		SanDisk Corporation
+001E82     (base 16)		SanDisk Corporation
+				630 Alder Drive,
+				Milpitas  CA  95035
+				US
+
+00-1E-B1   (hex)		Cryptsoft Pty Ltd
+001EB1     (base 16)		Cryptsoft Pty Ltd
+				P.O. Box 6389
+				Fairfield Gardens  Queensland  4103
+				AU
+
+00-1E-AF   (hex)		Ophir Optronics Ltd
+001EAF     (base 16)		Ophir Optronics Ltd
+				POB 45021
+				Jerusalem    91450
+				IL
+
+00-1E-AD   (hex)		Wingtech Group Limited
+001EAD     (base 16)		Wingtech Group Limited
+				6th floor, Unit G, No.668, East Beijing Road,
+				Shanghai    200001
+				CN
+
+00-1E-D1   (hex)		Keyprocessor B.V.
+001ED1     (base 16)		Keyprocessor B.V.
+				Paasheuvelweg 20
+				Amsterdam  NH  1105 BJ
+				NL
+
+00-1E-D0   (hex)		Ingespace
+001ED0     (base 16)		Ingespace
+				6 rue de lourmede
+				Eurocentre    31621
+				FR
+
+00-1E-8E   (hex)		Hunkeler AG
+001E8E     (base 16)		Hunkeler AG
+				Bahnhofstrasse 31
+				Wikon  CH  4806
+				CH
+
+00-1E-87   (hex)		Realease Limited
+001E87     (base 16)		Realease Limited
+				15/F, Morrison Commercial Building
+				WanChai    
+				HK
+
+00-1E-CD   (hex)		KYLAND Technology Co. LTD
+001ECD     (base 16)		KYLAND Technology Co. LTD
+				Building No.2,Shixing Avenue 30#
+				Shijingshan District  Beijing  100044
+				CN
+
+00-1E-BF   (hex)		Haas Automation Inc.
+001EBF     (base 16)		Haas Automation Inc.
+				2800 Sturgis Rd
+				Oxnard  CA  93030
+				US
+
+00-1E-BC   (hex)		WINTECH AUTOMATION CO.,LTD.
+001EBC     (base 16)		WINTECH AUTOMATION CO.,LTD.
+				#1115, TAEKWANG BLVD.
+				SUWON-SI  KYUNGGI  443-816
+				KR
+
+00-1E-6F   (hex)		Magna-Power Electronics, Inc.
+001E6F     (base 16)		Magna-Power Electronics, Inc.
+				39 Royal Road
+				Flemington  NJ  08822
+				US
+
+00-1E-A1   (hex)		Brunata a/s
+001EA1     (base 16)		Brunata a/s
+				Vesterlundvej 14
+				Herlev    2730
+				DK
+
+00-1E-53   (hex)		Further Tech Co., LTD
+001E53     (base 16)		Further Tech Co., LTD
+				8F,NO 421, Sungshan RD.,Taipei, Taiwn,R.O.C.
+				Taipei    110
+				TW
+
+00-1E-4E   (hex)		DAKO EDV-Ingenieur- und Systemhaus GmbH
+001E4E     (base 16)		DAKO EDV-Ingenieur- und Systemhaus GmbH
+				Ernst-Haeckel-Platz 5/6
+				Jena  Thuringia  07745
+				DE
+
+00-1E-49   (hex)		Cisco Systems, Inc
+001E49     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-28   (hex)		Lumexis Corporation
+001E28     (base 16)		Lumexis Corporation
+				3184 Airway Ave Bldg D
+				Costa Mesa  CA  92626
+				US
+
+00-1E-24   (hex)		Zhejiang Bell Technology Co.,ltd
+001E24     (base 16)		Zhejiang Bell Technology Co.,ltd
+				6 Xidoumen Rd. West Lake district
+				Hangzhou  Zhejiang  310012
+				CN
+
+00-1E-20   (hex)		Intertain Inc.
+001E20     (base 16)		Intertain Inc.
+				Suite 608 LG Eclat-2, 245-4 Seohyun-dong, Bundang-gu
+				Sungngm-shi  Kyunggi-do  463-824
+				KR
+
+00-1E-1C   (hex)		SWS Australia Pty Limited
+001E1C     (base 16)		SWS Australia Pty Limited
+				23 Scanlon Drive
+				Epping  Victoria  3076
+				AU
+
+00-1E-12   (hex)		Ecolab
+001E12     (base 16)		Ecolab
+				655 Lone Oak Drive
+				Eagan  MN  55121
+				US
+
+00-1E-16   (hex)		Keytronix
+001E16     (base 16)		Keytronix
+				Ungargasse 64-66/1/109
+				Vienna    1030
+				AT
+
+00-1E-32   (hex)		Zensys
+001E32     (base 16)		Zensys
+				Emdrupvej 26
+				Copenhagen O    DK-2100
+				DK
+
+00-1E-35   (hex)		Nintendo Co., Ltd.
+001E35     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1E-2B   (hex)		Radio Systems Design, Inc.
+001E2B     (base 16)		Radio Systems Design, Inc.
+				601 Heron Drive
+				Logan Twp  New Jersey  08085
+				US
+
+00-1E-42   (hex)		Teltonika
+001E42     (base 16)		Teltonika
+				Zirmunu 27
+				Vilnius    LT - 09105
+				LT
+
+00-1E-43   (hex)		AISIN AW CO.,LTD.
+001E43     (base 16)		AISIN AW CO.,LTD.
+				6-18 HARAYAMA
+				OKAZAKI  AICHI  444-8564
+				JP
+
+00-1E-08   (hex)		Centec Networks Inc
+001E08     (base 16)		Centec Networks Inc
+				 Suite 4F-13/16, Building B, No.5 Xing Han Street
+				Suzhou  Jiangsu  215021
+				CN
+
+00-1D-FB   (hex)		NETCLEUS Systems Corporation
+001DFB     (base 16)		NETCLEUS Systems Corporation
+				3F, Daiichi-maeda Bldg.
+				Yamato-shi    242-0017
+				JP
+
+00-1D-B9   (hex)		Wellspring Wireless
+001DB9     (base 16)		Wellspring Wireless
+				107 Magella Court
+				North Wales  Pa  19454
+				US
+
+00-1D-BB   (hex)		Dynamic System Electronics Corp.
+001DBB     (base 16)		Dynamic System Electronics Corp.
+				5F,NO,9,LANE 130,SEC 1,KUANGG FU RD.SAN CHUNG CITY,
+				Taipei  Hsien  24158
+				TW
+
+00-1D-B3   (hex)		HPN Supply Chain
+001DB3     (base 16)		HPN Supply Chain
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+00-1D-B1   (hex)		Crescendo Networks
+001DB1     (base 16)		Crescendo Networks
+				6 Yoni Netanyahu St.
+				Or-Yehuda    60376
+				IL
+
+00-1D-B4   (hex)		KUMHO ENG CO.,LTD
+001DB4     (base 16)		KUMHO ENG CO.,LTD
+				498-13, HYUNDAI B/D 5F
+				DAEGU    703-835
+				KR
+
+00-1D-A4   (hex)		Hangzhou System Technology CO., LTD
+001DA4     (base 16)		Hangzhou System Technology CO., LTD
+				ROOM A1505 HuaXing times plaza,NO 478 Wensan Road
+				Hangzhou  Zhejiang  310012
+				CN
+
+00-1D-9F   (hex)		MATT   R.P.Traczynscy Sp.J.
+001D9F     (base 16)		MATT   R.P.Traczynscy Sp.J.
+				Polnocna 44
+				Koscian  wielkopolskie  PL-64000
+				PL
+
+00-1D-90   (hex)		EMCO Flow Systems
+001D90     (base 16)		EMCO Flow Systems
+				2150 Miller Drive
+				Longmont  CO  80501
+				US
+
+00-1D-93   (hex)		Modacom
+001D93     (base 16)		Modacom
+				Jinsuk Building 1536-7
+				Seoul    137-073
+				KR
+
+00-1D-94   (hex)		Climax Technology Co., Ltd
+001D94     (base 16)		Climax Technology Co., Ltd
+				No. 258, Hsin Hu 2nd Road
+				Taipei City  Taipei  114
+				TW
+
+00-1D-8E   (hex)		Alereon, Inc.
+001D8E     (base 16)		Alereon, Inc.
+				7600 N. Capital of Texas Hwy
+				Austin  TX  78731
+				US
+
+00-1D-DB   (hex)		C-BEL Corporation
+001DDB     (base 16)		C-BEL Corporation
+				Futabacho 35-12
+				Itabashi-ku  Tokyo  173-0011
+				JP
+
+00-1D-E6   (hex)		Cisco Systems, Inc
+001DE6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-E7   (hex)		Marine Sonic Technology, Ltd.
+001DE7     (base 16)		Marine Sonic Technology, Ltd.
+				5508 George Washington Memorial Highway
+				White Marsh  Virginia  23183
+				US
+
+00-1D-7B   (hex)		Ice Energy, Inc.
+001D7B     (base 16)		Ice Energy, Inc.
+				9351 Eastman Park Drive
+				Windsor  Colorado  80550
+				US
+
+00-1D-6C   (hex)		ClariPhy Communications, Inc.
+001D6C     (base 16)		ClariPhy Communications, Inc.
+				16 Technology Dr., Suite 165
+				Irvine  CA  92618
+				US
+
+00-1D-C5   (hex)		Beijing Jiaxun Feihong Electricial Co., Ltd.
+001DC5     (base 16)		Beijing Jiaxun Feihong Electricial Co., Ltd.
+				Electrical Building,No. 31 Jiaoda East Road,
+				Beijing  Haidian District,  100044
+				CN
+
+00-1D-C6   (hex)		SNR Inc.
+001DC6     (base 16)		SNR Inc.
+				VBIC T223ho, ICU, 103-6 Munji-dong, Youseong-gu
+				Daejeon    305-732
+				KR
+
+00-1D-84   (hex)		Gateway, Inc.
+001D84     (base 16)		Gateway, Inc.
+				610 Gateway Drive
+				North Sioux City  South Dakota  57049
+				US
+
+00-1D-85   (hex)		Call Direct Cellular Solutions
+001D85     (base 16)		Call Direct Cellular Solutions
+				Suite 145, National Innovation Centre
+				Eveleigh  NSW  1430
+				AU
+
+00-1D-BF   (hex)		Radiient Technologies, Inc.
+001DBF     (base 16)		Radiient Technologies, Inc.
+				2084-A Walsh Ave
+				Santa Clara  CA  95050
+				US
+
+00-1D-34   (hex)		SYRIS Technology Corp
+001D34     (base 16)		SYRIS Technology Corp
+				21 F-2,  NO. 12,  SEC. 1,  Taijunggang Rd.
+				Taichung    403
+				US
+
+00-1D-32   (hex)		Longkay Communication & Technology (Shanghai) Co. Ltd
+001D32     (base 16)		Longkay Communication & Technology (Shanghai) Co. Ltd
+				No.5 Building, Unit 2, Lane 299 Bisheng Rd,
+				Shanghai    201204
+				CN
+
+00-1D-2A   (hex)		SHENZHEN BUL-TECH CO.,LTD.
+001D2A     (base 16)		SHENZHEN BUL-TECH CO.,LTD.
+				4/F, COFCO Bdlg , 3rd District,Baoan District, Shenzhen City,
+				shengzhen  guangdong  518101
+				CN
+
+00-1D-2D   (hex)		Pylone, Inc.
+001D2D     (base 16)		Pylone, Inc.
+				4F Nakano Bldg. 4-30-8 Kita-Shinjuku
+				Shinjuku-ku,  Tokyo  169-0074
+				JP
+
+00-1D-5B   (hex)		Tecvan Informática Ltda
+001D5B     (base 16)		Tecvan Informática Ltda
+				Rua Guaicurus, 145
+				Diadema  São Paulo  09911-630
+				BR
+
+00-1D-5D   (hex)		Control Dynamics Pty. Ltd.
+001D5D     (base 16)		Control Dynamics Pty. Ltd.
+				PO Box 636
+				MORLEY  Western Australia  6943
+				AU
+
+00-1D-59   (hex)		Mitra Energy & Infrastructure
+001D59     (base 16)		Mitra Energy & Infrastructure
+				Boulevard de l'Europe 131
+				1301  Wavre  
+				BE
+
+00-1D-2B   (hex)		Wuhan Pont Technology CO. , LTD
+001D2B     (base 16)		Wuhan Pont Technology CO. , LTD
+				Building E, Guandong Science and Technology Industry  Park,
+				Wuhan  Hubei  430074
+				CN
+
+00-1D-22   (hex)		Foss Analytical A/S
+001D22     (base 16)		Foss Analytical A/S
+				Slangerupgade 69
+				Hillerød  Seeland  3400
+				DK
+
+00-1D-23   (hex)		SENSUS 
+001D23     (base 16)		SENSUS 
+				44 CASTILIAN DRIVE
+				GOLETA  CALIFORNIA  93117
+				US
+
+00-1D-3E   (hex)		SAKA TECHNO SCIENCE CO.,LTD
+001D3E     (base 16)		SAKA TECHNO SCIENCE CO.,LTD
+				Nishi 105-1
+				Kanazawa  Ishikawa  920-0367
+				JP
+
+00-1D-40   (hex)		 Intel – GE Care Innovations LLC
+001D40     (base 16)		 Intel – GE Care Innovations LLC
+				3721 Douglas Blvd
+				Roseville  CA  95661
+				US
+
+00-1D-57   (hex)		CAETEC Messtechnik
+001D57     (base 16)		CAETEC Messtechnik
+				Schlossstraße 95a
+				Olching  Bayern  82140
+				DE
+
+00-1D-51   (hex)		Babcock & Wilcox Power Generation Group, Inc
+001D51     (base 16)		Babcock & Wilcox Power Generation Group, Inc
+				11864 Canon Blvd, Suite 105
+				Newport News  VA  23606
+				US
+
+00-1D-4C   (hex)		Alcatel-Lucent
+001D4C     (base 16)		Alcatel-Lucent
+				601 Data Dr.
+				Plano  TX  75075
+				US
+
+00-1D-1A   (hex)		OvisLink S.A.
+001D1A     (base 16)		OvisLink S.A.
+				C/Andres Obispo, 37. Pl. 4.
+				Madrid    28043
+				ES
+
+00-1C-B7   (hex)		USC DigiArk Corporation
+001CB7     (base 16)		USC DigiArk Corporation
+				6F Tennoz Central Tower 2-2-24 Higashishinagawa
+				Tokyo  Shinagawa-ku  140-0002
+				JP
+
+00-1C-AF   (hex)		Plato Networks Inc.
+001CAF     (base 16)		Plato Networks Inc.
+				2855 Kifer Road
+				Santa Clara  CA  95051
+				US
+
+00-1C-B1   (hex)		Cisco Systems, Inc
+001CB1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-FE   (hex)		Quartics Inc
+001CFE     (base 16)		Quartics Inc
+				15241 Laguna Canyon Road
+				Irvine  CA  92618
+				US
+
+00-1D-0B   (hex)		Power Standards Lab
+001D0B     (base 16)		Power Standards Lab
+				1201 Marina Village Parkway #101
+				Alameda  CA  94501
+				US
+
+00-1D-02   (hex)		Cybertech Telecom Development
+001D02     (base 16)		Cybertech Telecom Development
+				Hazenkoog 25
+				Alkmaar  Noord Holland  1822 BS
+				NL
+
+00-1C-E9   (hex)		Galaxy Technology Limited
+001CE9     (base 16)		Galaxy Technology Limited
+				9/F Win Full Commerical Building, 172-176 Wing Lok Street,
+				Sheung Wan,    
+				HK
+
+00-1C-EA   (hex)		Scientific-Atlanta, Inc
+001CEA     (base 16)		Scientific-Atlanta, Inc
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+00-1C-E7   (hex)		Rocon PLC Research Centre
+001CE7     (base 16)		Rocon PLC Research Centre
+				21 Vek 56A str.
+				Sofia    1700
+				US
+
+00-1C-DB   (hex)		CARPOINT CO.,LTD
+001CDB     (base 16)		CARPOINT CO.,LTD
+				1340-6, Namgang Bld 7F, Seocho-Dong
+				SEOUL    137-070
+				KR
+
+00-1C-D5   (hex)		ZeeVee, Inc.
+001CD5     (base 16)		ZeeVee, Inc.
+				1 Monarch Drive
+				Littleton  MA  01460
+				US
+
+00-1C-BC   (hex)		CastGrabber, LLC
+001CBC     (base 16)		CastGrabber, LLC
+				6507 Wilkins Avenue Ste. 212
+				Pittsburgh  PA  15217
+				US
+
+00-1C-E4   (hex)		EleSy JSC
+001CE4     (base 16)		EleSy JSC
+				Altayskaya street, 161a
+				  Tomsk oblast  634021
+				RU
+
+00-1C-E2   (hex)		Attero Tech, LLC.
+001CE2     (base 16)		Attero Tech, LLC.
+				1315 Directors Row - Suite 107
+				Fort Wayne  Indiana  46808
+				US
+
+00-1C-AA   (hex)		Bellon Pty Ltd
+001CAA     (base 16)		Bellon Pty Ltd
+				Unit 12/12-18 Victoria St East
+				Lidcombe  NSW  2000
+				AU
+
+00-1C-A0   (hex)		Production Resource Group, LLC
+001CA0     (base 16)		Production Resource Group, LLC
+				539 Temple Hill Road
+				New Windsor  NY  12553
+				US
+
+00-1C-D3   (hex)		ZP Engineering SEL
+001CD3     (base 16)		ZP Engineering SEL
+				via Ardito Desio, 60
+				ROME    00131
+				IT
+
+00-1C-CB   (hex)		Forth Corporation Public Company Limited
+001CCB     (base 16)		Forth Corporation Public Company Limited
+				226/12,13,16 Paholyothin Road
+				Bangkok    10400
+				TH
+
+00-1C-75   (hex)		Segnet Ltd.
+001C75     (base 16)		Segnet Ltd.
+				146 New London Road
+				Chelmsford Essex CM2 OAW    
+				GB
+
+00-1C-74   (hex)		Syswan Technologies Inc.
+001C74     (base 16)		Syswan Technologies Inc.
+				2050 Beavercreek Road
+				Oregon City  Oregon  97045
+				US
+
+00-1C-68   (hex)		Anhui Sun Create Electronics Co., Ltd
+001C68     (base 16)		Anhui Sun Create Electronics Co., Ltd
+				NO.199 Xiangzhang Road
+				Hefei  Anhui  230088
+				CN
+
+00-1C-66   (hex)		UCAMP CO.,LTD
+001C66     (base 16)		UCAMP CO.,LTD
+				#1015, Kolon Science Valley ¥±
+				Seoul  Guro-Dong,Guro-gu,  152-848
+				KR
+
+00-1C-98   (hex)		LUCKY TECHNOLOGY (HK) COMPANY LIMITED
+001C98     (base 16)		LUCKY TECHNOLOGY (HK) COMPANY LIMITED
+				FLAT/RM 1503 15/F ISLAND BEVERLEY NO 1 GREAT GEORGE STREET CAUSEWAY BAY
+				    999077
+				HK
+
+00-1C-81   (hex)		NextGen Venturi LTD
+001C81     (base 16)		NextGen Venturi LTD
+				Technium 2
+				Swansea  West Glamorgan  SA18PJ
+				GB
+
+00-1C-7A   (hex)		Perfectone Netware Company Ltd
+001C7A     (base 16)		Perfectone Netware Company Ltd
+				Unit 815, Sun Fung Centre,
+				Kwai Chung    
+				HK
+
+00-1C-7B   (hex)		Castlenet Technology Inc.
+001C7B     (base 16)		Castlenet Technology Inc.
+				No.64, Chung-Shan Rd.
+				Tu-Cheng City  Taipei  236
+				TW
+
+00-1C-53   (hex)		Synergy Lighting Controls
+001C53     (base 16)		Synergy Lighting Controls
+				One Lithonia Way
+				Conyers  GA  30012
+				US
+
+00-1C-4D   (hex)		Aplix IP Holdings Corporation
+001C4D     (base 16)		Aplix IP Holdings Corporation
+				2-20-9 Nishiwaseda
+				Shinjuku-ku  Tokyo  169-0051
+				JP
+
+00-1C-92   (hex)		Tervela
+001C92     (base 16)		Tervela
+				43 Nagog Park
+				Acton  MA  01720
+				US
+
+00-1C-8A   (hex)		Cirrascale Corporation
+001C8A     (base 16)		Cirrascale Corporation
+				9449 Carroll Park Drive
+				San Diego  CA  92121
+				US
+
+00-1C-38   (hex)		Bio-Rad Laboratories, Inc.
+001C38     (base 16)		Bio-Rad Laboratories, Inc.
+				245 Winter St.
+				Waltham  MA  02451
+				US
+
+00-1C-30   (hex)		Mode Lighting (UK ) Ltd.
+001C30     (base 16)		Mode Lighting (UK ) Ltd.
+				The Maltings
+				Ware  Hertfordshire  SG12 9AD
+				GB
+
+00-1C-2E   (hex)		HPN Supply Chain
+001C2E     (base 16)		HPN Supply Chain
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+00-1C-2A   (hex)		Envisacor Technologies Inc.
+001C2A     (base 16)		Envisacor Technologies Inc.
+				237 Romina Drive
+				Concord  Ontario  L4K 4V3
+				CA
+
+00-1C-02   (hex)		Pano Logic
+001C02     (base 16)		Pano Logic
+				2000 Seaport Drive, Suite 200
+				Redwood City  CA  94063
+				US
+
+00-1C-05   (hex)		Nonin Medical Inc.
+001C05     (base 16)		Nonin Medical Inc.
+				13700 1st Avenue North
+				Plymouth  MN  55441
+				US
+
+00-1C-06   (hex)		Siemens Numerical Control Ltd., Nanjing
+001C06     (base 16)		Siemens Numerical Control Ltd., Nanjing
+				No. 18 Siemens Road, Jiangning Development Zone
+				Nanjing  JiangSu  211100
+				CN
+
+00-1B-EA   (hex)		Nintendo Co., Ltd.
+001BEA     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1B-E5   (hex)		802automation Limited
+001BE5     (base 16)		802automation Limited
+				18 First Avenue
+				Worthing  West Sussex  BN14 9NJ
+				GB
+
+00-1B-E4   (hex)		TOWNET SRL
+001BE4     (base 16)		TOWNET SRL
+				VIA DEI FINALE, 20
+				61043  CAGLI (PU)  
+				IT
+
+00-1C-04   (hex)		Airgain, Inc.
+001C04     (base 16)		Airgain, Inc.
+				1930 Palomar Point Way
+				Carlsbad  CA  92008
+				US
+
+00-1C-01   (hex)		ABB Oy Drives
+001C01     (base 16)		ABB Oy Drives
+				Hiomotie 13
+				Helsinki    FI-00380
+				FI
+
+00-1B-FF   (hex)		Millennia Media inc.
+001BFF     (base 16)		Millennia Media inc.
+				4200 Day Spring CT
+				Placerville  CA  95667
+				US
+
+00-1B-F2   (hex)		KWORLD COMPUTER CO., LTD
+001BF2     (base 16)		KWORLD COMPUTER CO., LTD
+				No. 113, Jian 2nd Rd.,
+				Jhonghe  Taipei county  235
+				TW
+
+00-1B-F0   (hex)		Value Platforms Limited
+001BF0     (base 16)		Value Platforms Limited
+				Rm 712-713, Building 9, 5, Science Park West Ave.,
+				Shatin,    
+				HK
+
+00-1C-1B   (hex)		Hyperstone GmbH
+001C1B     (base 16)		Hyperstone GmbH
+				Line-Eid-Straße 3
+				Konstanz  Baden-Württemberg  78467
+				DE
+
+00-1C-10   (hex)		Cisco-Linksys, LLC
+001C10     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-1B-D2   (hex)		ULTRA-X ASIA PACIFIC Inc.
+001BD2     (base 16)		ULTRA-X ASIA PACIFIC Inc.
+				5-1-15 Sotokanda
+				Tokyo  Chiyoda-ku  101-0021
+				JP
+
+00-1B-8D   (hex)		Electronic Computer Systems, Inc.
+001B8D     (base 16)		Electronic Computer Systems, Inc.
+				418 Donegal Drive
+				Towson  MD  21286
+				US
+
+00-1B-86   (hex)		Bosch Access Systems GmbH
+001B86     (base 16)		Bosch Access Systems GmbH
+				Charlottenburger Allee 50
+				AACHEN    D-52068
+				DE
+
+00-1B-C2   (hex)		Integrated Control Technology Limitied
+001BC2     (base 16)		Integrated Control Technology Limitied
+				11 Canaveral Drive
+				Auckland  Auckland  0735
+				NZ
+
+00-1B-BB   (hex)		RFTech Co.,Ltd
+001BBB     (base 16)		RFTech Co.,Ltd
+				339-17 Jwahang-Ri,Wonsam-Myun,
+				Yongin-Si  Kyungki-Do  449-871
+				KR
+
+00-1B-AA   (hex)		XenICs nv
+001BAA     (base 16)		XenICs nv
+				Ambachtenlaan 44
+				Leuven  Vlaams-Brabant  B-3001
+				BE
+
+00-1B-7C   (hex)		A & R Cambridge
+001B7C     (base 16)		A & R Cambridge
+				Pembroke Avenue
+				Cambridge  CAMBS  CB25 9QR
+				GB
+
+00-1B-5D   (hex)		Vololink Pty Ltd
+001B5D     (base 16)		Vololink Pty Ltd
+				Level 2, 541 Blackburn Road
+				Mount Waverley  Victoria  3149
+				AU
+
+00-1B-5A   (hex)		Apollo Imaging Technologies, Inc.
+001B5A     (base 16)		Apollo Imaging Technologies, Inc.
+				18545 Rangeland Rd
+				Ramona  CA  92065
+				US
+
+00-1B-56   (hex)		Tehuti Networks Ltd.
+001B56     (base 16)		Tehuti Networks Ltd.
+				1, Shenkar St.
+				Hertzliya    46105
+				IL
+
+00-1B-C6   (hex)		Strato Rechenzentrum AG
+001BC6     (base 16)		Strato Rechenzentrum AG
+				Pascalstrasse 10
+				D-10587  Berlin  
+				DE
+
+00-1B-C4   (hex)		Ultratec, Inc.
+001BC4     (base 16)		Ultratec, Inc.
+				450 Science Drive
+				Madison  WI  53711
+				US
+
+00-1B-A1   (hex)		Åmic AB
+001BA1     (base 16)		Åmic AB
+				Uppsala science park
+				Uppsala    75183
+				SE
+
+00-1B-96   (hex)		General Sensing
+001B96     (base 16)		General Sensing
+				Unit 716, Cyberport 1
+				Pok Fu Lam    
+				US
+
+00-1A-EA   (hex)		Radio Terminal Systems Pty Ltd
+001AEA     (base 16)		Radio Terminal Systems Pty Ltd
+				1st Floor
+				Laverton North  Victoria  3026
+				AU
+
+00-1A-DD   (hex)		PePWave Ltd
+001ADD     (base 16)		PePWave Ltd
+				17/F., Park Building,
+				Cheung Sha Wan  Kowloon  
+				HK
+
+00-1A-D6   (hex)		JIAGNSU AETNA ELECTRIC CO.,LTD
+001AD6     (base 16)		JIAGNSU AETNA ELECTRIC CO.,LTD
+				NO.571 QIANHU ROAD,QIANQIAO INDUSTRY PARK,WUXI,JIANGSU,CHINA
+				WUXI  JIANGSU  214151
+				CN
+
+00-1A-D4   (hex)		iPOX Technology Co., Ltd.
+001AD4     (base 16)		iPOX Technology Co., Ltd.
+				15F-1, No.186, Jian-Yi Rd., Chung-Ho City,
+				Taipei    235
+				TW
+
+00-1B-14   (hex)		Carex Lighting Equipment Factory
+001B14     (base 16)		Carex Lighting Equipment Factory
+				50 Chang Tang Rd., Yan Tian District,
+				  Guangdong province  
+				CN
+
+00-1B-15   (hex)		Voxtel, Inc.
+001B15     (base 16)		Voxtel, Inc.
+				12725 SW Millikan Way
+				Beaverton  OR  97005
+				US
+
+00-1B-09   (hex)		Matrix Telecom Pvt. Ltd.
+001B09     (base 16)		Matrix Telecom Pvt. Ltd.
+				394, GIDC, Makarpura,
+				Vadodara  Gujarat  390010
+				IN
+
+00-1B-03   (hex)		Action Technology (SZ) Co., Ltd
+001B03     (base 16)		Action Technology (SZ) Co., Ltd
+				Action Technology Building Baoyuan Road, Xixiang, Bao'an District
+				Shenzhen  Guangdong  518102
+				CN
+
+00-1A-FB   (hex)		Joby Inc.
+001AFB     (base 16)		Joby Inc.
+				1535 Mission St.
+				San Francisco  CA  94103
+				US
+
+00-1A-FD   (hex)		EVOLIS
+001AFD     (base 16)		EVOLIS
+				29 avenue de la fontaine
+				Beaucouze    49070
+				FR
+
+00-1B-1E   (hex)		HART Communication Foundation
+001B1E     (base 16)		HART Communication Foundation
+				STE 1-350
+				Austin  TX  78759
+				US
+
+00-1B-4C   (hex)		Signtech
+001B4C     (base 16)		Signtech
+				609 Seonil Technopia 609
+				Sungnamsi  Kyunggido  462-120
+				KR
+
+00-1A-D5   (hex)		KMC CHAIN INDUSTRIAL CO., LTD.
+001AD5     (base 16)		KMC CHAIN INDUSTRIAL CO., LTD.
+				7F-8, No. 81, Sui-Lih Rd., Hsinchu
+				Hsinchu    300
+				TW
+
+00-1A-D0   (hex)		Albis Technologies AG
+001AD0     (base 16)		Albis Technologies AG
+				Albisriederstrasse 199
+				CH 8047  Zuerich  
+				CH
+
+00-1A-D3   (hex)		Vamp Ltd.
+001AD3     (base 16)		Vamp Ltd.
+				PO Box 810
+				Vaasa    65101
+				FI
+
+00-1A-D8   (hex)		AlsterAero GmbH
+001AD8     (base 16)		AlsterAero GmbH
+				Heidenkampsweg 45
+				Hamburg    20097
+				DE
+
+00-1A-DA   (hex)		Biz-2-Me Inc.
+001ADA     (base 16)		Biz-2-Me Inc.
+				1301 West Eau Gallie Blvd
+				Melbourne  FL  32935
+				US
+
+00-1A-6F   (hex)		MI.TEL s.r.l.
+001A6F     (base 16)		MI.TEL s.r.l.
+				VIA GUIDO ROSSA, 22
+				CORNATE D'ADDA  MILANO  20040
+				IT
+
+00-1A-71   (hex)		Diostech Co., Ltd.
+001A71     (base 16)		Diostech Co., Ltd.
+				151-21, Buk-ri, Namsa-myeon,
+				Yongin-city  Gyeonggi-do  449 884
+				KR
+
+00-1A-69   (hex)		Wuhan Yangtze Optical Technology CO.,Ltd.
+001A69     (base 16)		Wuhan Yangtze Optical Technology CO.,Ltd.
+				4#,Guanshan 2 Road
+				Wuhan  Hubei  430073
+				CN
+
+00-1A-67   (hex)		Infinite QL Sdn Bhd
+001A67     (base 16)		Infinite QL Sdn Bhd
+				G.02, Block A, Dataran Hamodal
+				Petaling Jaya  Selangor Darul Ehsan  46300
+				MY
+
+00-1A-C3   (hex)		Scientific-Atlanta, Inc
+001AC3     (base 16)		Scientific-Atlanta, Inc
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+00-1A-BF   (hex)		TRUMPF Laser Marking Systems AG
+001ABF     (base 16)		TRUMPF Laser Marking Systems AG
+				Ausserfeld
+				Gruesch  GR  7214
+				CH
+
+00-1A-B8   (hex)		Anseri Corporation
+001AB8     (base 16)		Anseri Corporation
+				35E Industrial Way
+				Rochester  NH  03867
+				US
+
+00-1A-BC   (hex)		U4EA Technologies Ltd
+001ABC     (base 16)		U4EA Technologies Ltd
+				City Point
+				Bristol    BS1 6PL
+				GB
+
+00-1A-CB   (hex)		Autocom Products Ltd
+001ACB     (base 16)		Autocom Products Ltd
+				Unit 4 Tachbrook Link, Tachbrook Park Drive
+				Warwick  Warwickshire  CV34 6RH
+				GB
+
+00-1A-CF   (hex)		C.T. ELETTRONICA
+001ACF     (base 16)		C.T. ELETTRONICA
+				Via Caduti di Nassiriya 5 B
+				Barberino Val D'Elsa (FI)    50021
+				IT
+
+00-1A-A3   (hex)		DELORME
+001AA3     (base 16)		DELORME
+				2 DELORME DRIVE
+				YARMOUTH  MAINE  04096
+				US
+
+00-1A-9B   (hex)		ADEC & Parter AG
+001A9B     (base 16)		ADEC & Parter AG
+				Staldenbachstrasse 30
+				Pfaeffikon  ZH  8808
+				CH
+
+00-1A-9D   (hex)		Skipper Wireless, Inc.
+001A9D     (base 16)		Skipper Wireless, Inc.
+				Shinjuku-Sumitomo Bldg. 20F
+				Shinjuku  Tokyo  163-0220
+				JP
+
+00-1A-85   (hex)		NV Michel Van de Wiele
+001A85     (base 16)		NV Michel Van de Wiele
+				M. Vandewielestraat 7
+				Marke  West-Vlaanderen  8510
+				BE
+
+00-1A-8E   (hex)		3Way Networks Ltd
+001A8E     (base 16)		3Way Networks Ltd
+				7200 Cambridge Research Park
+				Cambridge  Cambridgeshire  CB5 9TL
+				GB
+
+00-1A-44   (hex)		JWTrading Co., Ltd
+001A44     (base 16)		JWTrading Co., Ltd
+				1590 Kwanyang-dong, Dongan-ku
+				Ahnyang  Kyungki - do  431-060
+				KR
+
+00-1A-49   (hex)		Micro Vision Co.,LTD
+001A49     (base 16)		Micro Vision Co.,LTD
+				1-9-15
+				Niigata-city  Niigata-ken  950-0986
+				JP
+
+00-1A-3D   (hex)		Ajin Vision Co.,Ltd
+001A3D     (base 16)		Ajin Vision Co.,Ltd
+				1404, Mario-Tower, 222-12
+				Seoul    152-050
+				KR
+
+00-1A-41   (hex)		INOCOVA Co.,Ltd
+001A41     (base 16)		INOCOVA Co.,Ltd
+				5F SEOUL BD.736-17
+				Yeoksam-Dong, Kangnam-Ku  SEOUL  135-924
+				KR
+
+00-1A-33   (hex)		ASI Communications, Inc.
+001A33     (base 16)		ASI Communications, Inc.
+				1042 E Guadalupe Rd
+				Tempe  AZ  85283
+				US
+
+00-1A-23   (hex)		Ice Qube, Inc
+001A23     (base 16)		Ice Qube, Inc
+				141 Wilson Ave
+				Greensburg  Pa  15601
+				US
+
+00-1A-1D   (hex)		PChome Online Inc.
+001A1D     (base 16)		PChome Online Inc.
+				11F, 105, Sec. 2, Tun-Hwa S. Rd.
+				  Taipei  106
+				TW
+
+00-1A-17   (hex)		Teak Technologies, Inc.
+001A17     (base 16)		Teak Technologies, Inc.
+				2901 Tasman Dr., Ste. #210
+				Santa Clara  CA  95054
+				US
+
+00-1A-1C   (hex)		GT&T Engineering Pte Ltd
+001A1C     (base 16)		GT&T Engineering Pte Ltd
+				2 Ang Mo Kio St.64, Econ Building, #04-00
+				  Singapore  569084
+				SG
+
+00-1A-1F   (hex)		Coastal Environmental Systems
+001A1F     (base 16)		Coastal Environmental Systems
+				820 First Avenue South
+				Seattle  wa  98134
+				US
+
+00-1A-64   (hex)		IBM Corp
+001A64     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-1A-51   (hex)		Alfred Mann Foundation
+001A51     (base 16)		Alfred Mann Foundation
+				P.O. Box 905
+				Santa Clarita  CA  91380-9005
+				US
+
+00-1A-55   (hex)		ACA-Digital Corporation
+001A55     (base 16)		ACA-Digital Corporation
+				17 F, No. 866-7, Chung Cheng Rd.,
+				Chung Ho City  Taipei County  23586
+				TW
+
+00-19-E6   (hex)		TOYO MEDIC CO.,LTD.
+0019E6     (base 16)		TOYO MEDIC CO.,LTD.
+				1-17-22 Kitahorie, Nishi-ku
+				Osaka    550-0014
+				JP
+
+00-19-E2   (hex)		Juniper Networks
+0019E2     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-19-E8   (hex)		Cisco Systems, Inc
+0019E8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-DF   (hex)		Thomson Inc.
+0019DF     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290-1102
+				US
+
+00-19-DD   (hex)		FEI-Zyfer, Inc.
+0019DD     (base 16)		FEI-Zyfer, Inc.
+				1515 S. Manchester
+				Anaheim  CA  92802
+				US
+
+00-19-B2   (hex)		XYnetsoft Co.,Ltd
+0019B2     (base 16)		XYnetsoft Co.,Ltd
+				NO.158Zhenyu Street High Industries Development area
+				ChangChun  JiLin  130000
+				CN
+
+00-19-A4   (hex)		Austar Technology (hang zhou) Co.,Ltd
+0019A4     (base 16)		Austar Technology (hang zhou) Co.,Ltd
+				7-402,West Lake Software Part
+				Hang Zhou  Zhe Jiang  310012
+				CN
+
+00-19-AA   (hex)		Cisco Systems, Inc
+0019AA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-B1   (hex)		Arrow7 Corporation
+0019B1     (base 16)		Arrow7 Corporation
+				Kamijima 3-27-7
+				Hamamatsu  Shizuoka  433-8122
+				JP
+
+00-19-B3   (hex)		Stanford Research Systems
+0019B3     (base 16)		Stanford Research Systems
+				1290-D Reamwood Ave
+				Sunnyvale  CA  94089
+				US
+
+00-1A-0A   (hex)		Adaptive Micro-Ware Inc.
+001A0A     (base 16)		Adaptive Micro-Ware Inc.
+				6917 Innovation Blvd
+				Fort Wayne  IN  46818
+				US
+
+00-1A-05   (hex)		OPTIBASE LTD
+001A05     (base 16)		OPTIBASE LTD
+				7 Shankar St.
+				Herzliya  ISRAEL  46120
+				IL
+
+00-19-D4   (hex)		ICX Technologies
+0019D4     (base 16)		ICX Technologies
+				3440 Francis-Hughes
+				Laval  Quebec  H7L 5A9
+				CA
+
+00-19-CF   (hex)		SALICRU, S.A.
+0019CF     (base 16)		SALICRU, S.A.
+				Av. Serra , 100
+				Sta.Ma.Palautordera  Barcelona  08460
+				ES
+
+00-19-FC   (hex)		PT. Ufoakses Sukses Luarbiasa
+0019FC     (base 16)		PT. Ufoakses Sukses Luarbiasa
+				Jl. Sultan Hasanudin No. 41
+				Jakarta Selatan  DKI Jakarta  12160
+				ID
+
+00-19-F4   (hex)		Convergens Oy Ltd
+0019F4     (base 16)		Convergens Oy Ltd
+				Westendintie 99 B
+				Espoo  Uusimaa  FIN-02160
+				FI
+
+00-19-96   (hex)		TurboChef Technologies Inc.
+001996     (base 16)		TurboChef Technologies Inc.
+				4240 International Parkway
+				Carrollton  Texas  75007
+				US
+
+00-19-97   (hex)		Soft Device Sdn Bhd
+001997     (base 16)		Soft Device Sdn Bhd
+				67-2 Jalan 2/27F
+				Kuala Lumpur  WP  53300
+				MY
+
+00-19-98   (hex)		SATO CORPORATION
+001998     (base 16)		SATO CORPORATION
+				1-207,ONARI-CHO,
+				SAITAMA-SHI  SAITAMA  330-0852
+				JP
+
+00-19-9C   (hex)		CTRING
+00199C     (base 16)		CTRING
+				#514, World Meridian Venture Center II
+				Keumcheon-gu  Seoul  153-803
+				KR
+
+00-19-46   (hex)		Cianet Industria e Comercio S/A
+001946     (base 16)		Cianet Industria e Comercio S/A
+				rod SC401, km01 Tecnopolis/Alfama 4o. Andar
+				Florianopolis  Santa Catarina  88030-902
+				BR
+
+00-19-49   (hex)		TENTEL  COMTECH CO., LTD.
+001949     (base 16)		TENTEL  COMTECH CO., LTD.
+				3/F., NO. 42, LANE 80, SEC. 3, NAN-KANG RD.,
+				TAIPEI    115
+				TW
+
+00-19-44   (hex)		Fossil Partners, L.P.
+001944     (base 16)		Fossil Partners, L.P.
+				2280 N. Greenville Ave.
+				Richardson  TX  75082
+				US
+
+00-19-71   (hex)		Guangzhou Unicomp Technology Co.,Ltd
+001971     (base 16)		Guangzhou Unicomp Technology Co.,Ltd
+				7/F,North Tower,Jinshan Building.No.248
+				Guangzhou  Guangdong  510630
+				CN
+
+00-19-64   (hex)		Doorking Inc.
+001964     (base 16)		Doorking Inc.
+				120 Glasgow St.
+				Inglewood  CA.  90301
+				US
+
+00-19-76   (hex)		Xipher Technologies, LLC
+001976     (base 16)		Xipher Technologies, LLC
+				156 River Road
+				Willington  CT  06279
+				US
+
+00-19-6C   (hex)		ETROVISION TECHNOLOGY
+00196C     (base 16)		ETROVISION TECHNOLOGY
+				2F, 19-5 San Chung Rd.,
+				TAIPEI    115
+				TW
+
+00-19-67   (hex)		TELDAT Sp.J.
+001967     (base 16)		TELDAT Sp.J.
+				Kijowska 44
+				Bydgoszcz  woj. kujawsko-pomorskie  85-703
+				PL
+
+00-19-52   (hex)		ACOGITO Co., Ltd
+001952     (base 16)		ACOGITO Co., Ltd
+				#501 Shinyoung Palace Tower, 246-2, Seohyun
+				Sungnam  Kyunggi  463-824
+				KR
+
+00-19-8B   (hex)		Novera Optics Korea, Inc.
+00198B     (base 16)		Novera Optics Korea, Inc.
+				463-1 Jeon Min Dong Yuseong Gu
+				Deajeon    305-811
+				KR
+
+00-19-61   (hex)		Blaupunkt  Embedded Systems GmbH
+001961     (base 16)		Blaupunkt  Embedded Systems GmbH
+				Bahnhofsstrasse 16
+				Schlitz    36110
+				DE
+
+00-19-42   (hex)		ON SOFTWARE INTERNATIONAL LIMITED
+001942     (base 16)		ON SOFTWARE INTERNATIONAL LIMITED
+				9F, NO. 17, SEC. 1, CHENG-TE RD.
+				TAIPEI    103
+				TW
+
+00-19-3F   (hex)		RDI technology(Shenzhen) Co.,LTD
+00193F     (base 16)		RDI technology(Shenzhen) Co.,LTD
+				Building C1&C2,  Xin Tang Industrial Zone,East BaiShiXia Village, Fuyong Town, Baoan District
+				SHENZHEN  GUANGDONG province  518103
+				CN
+
+00-19-41   (hex)		Pitney Bowes, Inc
+001941     (base 16)		Pitney Bowes, Inc
+				35 Waterview Drive
+				Shelton  CT  06484
+				US
+
+00-18-FD   (hex)		Optimal Technologies International Inc.
+0018FD     (base 16)		Optimal Technologies International Inc.
+				12 Spanish Main Drive
+				Freeport  GBI  
+				BS
+
+00-18-F0   (hex)		JOYTOTO Co., Ltd.
+0018F0     (base 16)		JOYTOTO Co., Ltd.
+				3F Sungwoo Bldg. 717-3, Sooseo-Dong
+				Seoul    135-220
+				KR
+
+00-18-E9   (hex)		Numata Corporation
+0018E9     (base 16)		Numata Corporation
+				8-2-39 nanko-higashi
+				Osaka-shi  Osaka-fu  559-0031
+				JP
+
+00-19-08   (hex)		Duaxes Corporation
+001908     (base 16)		Duaxes Corporation
+				2-5, Kasumigaseki 3-chome, Chiyoda-ku.
+				Tokyo  Foreign  100-6014
+				JP
+
+00-19-0C   (hex)		Encore Electronics, Inc.
+00190C     (base 16)		Encore Electronics, Inc.
+				16483 Old Valley Blvd.
+				La Puente  CA  91744
+				US
+
+00-19-19   (hex)		ASTEL Inc.
+001919     (base 16)		ASTEL Inc.
+				59-7 Jang-dong Yusung-Gu
+				Daejeon  Chungnam  305-343
+				KR
+
+00-19-2D   (hex)		Nokia Corporation
+00192D     (base 16)		Nokia Corporation
+				Rensingstraße 15
+				Bochum  NRW  44807
+				DE
+
+00-18-EF   (hex)		Escape Communications, Inc.
+0018EF     (base 16)		Escape Communications, Inc.
+				2615 Pacific Coast Hwy
+				Hermosa Beach  CA  90254
+				US
+
+00-18-E6   (hex)		Computer Hardware Design SIA
+0018E6     (base 16)		Computer Hardware Design SIA
+				Dzelzavas 120i
+				Riga    LV-1021
+				LV
+
+00-19-30   (hex)		Cisco Systems, Inc
+001930     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-27   (hex)		ImCoSys Ltd
+001927     (base 16)		ImCoSys Ltd
+				Bundesstrasse 5
+				Zug  ZG  6300
+				CH
+
+00-18-F7   (hex)		Kameleon Technologies
+0018F7     (base 16)		Kameleon Technologies
+				217, rue St Honoré
+				Paris    75001
+				FR
+
+00-18-85   (hex)		Avigilon Corporation
+001885     (base 16)		Avigilon Corporation
+				Box 378, 101 - 1001 West Broadway
+				Vancouver  BC  V6H 4E4
+				CA
+
+00-18-88   (hex)		GOTIVE a.s.
+001888     (base 16)		GOTIVE a.s.
+				Zámocká 34
+				Bratislava    81101
+				SK
+
+00-18-8A   (hex)		Infinova LLC
+00188A     (base 16)		Infinova LLC
+				51 Stouts Lane, Unit 1 & 2
+				Monmouth Junction  New Jersey  08852
+				US
+
+00-18-86   (hex)		EL-TECH, INC.
+001886     (base 16)		EL-TECH, INC.
+				A-711, WOOLIM LION'S VALLEY, 371-28
+				SEOUL    150-834
+				KR
+
+00-18-87   (hex)		Metasystem SpA
+001887     (base 16)		Metasystem SpA
+				Via Oberdan 16
+				Reggio Emilia  RE  42100
+				IT
+
+00-18-BE   (hex)		ANSA Corporation
+0018BE     (base 16)		ANSA Corporation
+				17F, No. 738, Chung Cheng Road
+				Chung Ho City  Taipei County  235
+				TW
+
+00-18-BA   (hex)		Cisco Systems, Inc
+0018BA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-B4   (hex)		Dawon Media Inc.
+0018B4     (base 16)		Dawon Media Inc.
+				Rm503. woolim e-biz center 170-5, Guro3dong Gurogu,
+				Seoul    152-769
+				KR
+
+00-18-B6   (hex)		S3C, Inc.
+0018B6     (base 16)		S3C, Inc.
+				1010 Stewart Dr.
+				Sunnyvale  California  94085
+				US
+
+00-18-A3   (hex)		ZIPPY TECHNOLOGY CORP.
+0018A3     (base 16)		ZIPPY TECHNOLOGY CORP.
+				10F, No. 50, Mincyuan Rd., Sindian City
+				Taipei    231
+				TW
+
+00-18-A0   (hex)		Cierma Ascenseurs
+0018A0     (base 16)		Cierma Ascenseurs
+				17 avenue guiglionda de saint agathe
+				Nice  PACA  06300
+				FR
+
+00-18-93   (hex)		SHENZHEN PHOTON BROADBAND TECHNOLOGY CO.,LTD
+001893     (base 16)		SHENZHEN PHOTON BROADBAND TECHNOLOGY CO.,LTD
+				2/F Hivac BLD,2th Langshan Rd,North Hi-Tech Industrial
+				Shenzhen  Guangdong  518057
+				CN
+
+00-18-B1   (hex)		IBM Corp
+0018B1     (base 16)		IBM Corp
+				2051 Mission College Blvd
+				Santa Clara  CA  95054
+				US
+
+00-18-7B   (hex)		4NSYS Co. Ltd.
+00187B     (base 16)		4NSYS Co. Ltd.
+				3F, Hana Bldg
+				Guro-Gu  Seoul  152-100
+				KR
+
+00-18-7F   (hex)		ZODIANET
+00187F     (base 16)		ZODIANET
+				23, rue des Fraisettes
+				PALAISEAU  ESSONNE  91120
+				FR
+
+00-18-7E   (hex)		RGB Spectrum
+00187E     (base 16)		RGB Spectrum
+				950 Marina Village Pkwy
+				Alameda  CA  94501
+				US
+
+00-18-9D   (hex)		Navcast Inc.
+00189D     (base 16)		Navcast Inc.
+				Suite 612, 6711 Mississauga Road
+				Mississauga  ON  m2r 1a3
+				CA
+
+00-18-D6   (hex)		Swirlnet A/S
+0018D6     (base 16)		Swirlnet A/S
+				Diplomvej 381
+				Lyngby    DK-2800
+				DK
+
+00-18-CD   (hex)		Erae Electronics Industry Co., Ltd
+0018CD     (base 16)		Erae Electronics Industry Co., Ltd
+				#371-51, Gasan-dong
+				Geumchen-gu  Seoul  153-803
+				KR
+
+00-18-DB   (hex)		EPL Technology Ltd
+0018DB     (base 16)		EPL Technology Ltd
+				LongDong,Longgang District
+				ShenZhen  GuangDong  518116
+				CN
+
+00-18-C8   (hex)		ISONAS Inc.
+0018C8     (base 16)		ISONAS Inc.
+				6325 Gunpark Drive
+				Boulder  CO  80301
+				US
+
+00-18-49   (hex)		nVent, Schroff GmbH
+001849     (base 16)		nVent, Schroff GmbH
+				Langenalber Strasse 96-100
+				Straubenhardt    75334
+				DE
+
+00-18-46   (hex)		Crypto S.A.
+001846     (base 16)		Crypto S.A.
+				V. Ipirou 45
+				Marousi  Athens  15125
+				GR
+
+00-18-45   (hex)		Pulsar-Telecom LLC.
+001845     (base 16)		Pulsar-Telecom LLC.
+				Zaharova, 18a
+				Penza    440044
+				RU
+
+00-18-1E   (hex)		GDX Technologies Ltd.
+00181E     (base 16)		GDX Technologies Ltd.
+				61-63 Back Sneddon Street
+				Paisley  Renfrewshire  PA3 2DD
+				GB
+
+00-18-1C   (hex)		Exterity Limited
+00181C     (base 16)		Exterity Limited
+				Ridge Way, Hillend Industrial Estate
+				Dunfermline  Fife  KY11 9JD
+				GB
+
+00-18-63   (hex)		Veritech Electronics Limited
+001863     (base 16)		Veritech Electronics Limited
+				8F, 67, Sec. 1, Zhongshan Road, Xinzhuang,
+				Taipei    242
+				TW
+
+00-18-5A   (hex)		uControl, Inc.
+00185A     (base 16)		uControl, Inc.
+				5914 W. Courtyard Drive
+				Austin  TX  78730
+				US
+
+00-18-52   (hex)		StorLink Semiconductors, Inc.
+001852     (base 16)		StorLink Semiconductors, Inc.
+				1804 N. Shoreline Boulevard
+				Mountain View  CA  94043
+				US
+
+00-18-50   (hex)		Secfone Kft
+001850     (base 16)		Secfone Kft
+				51 Bercsenyi str
+				Jaszbereny    5100
+				HU
+
+00-18-58   (hex)		TagMaster AB
+001858     (base 16)		TagMaster AB
+				Kronborgsgréind 1
+				Kista  Stockholm  S-16487
+				SE
+
+00-18-24   (hex)		Kimaldi Electronics, S.L.
+001824     (base 16)		Kimaldi Electronics, S.L.
+				Ctra. de Rubí, 292 B
+				Terrassa  Barcelona  08228
+				ES
+
+00-18-3D   (hex)		Vertex Link Corporation
+00183D     (base 16)		Vertex Link Corporation
+				Meitetsu Fudosan Takebashi Bldg 6F
+				Chiyoda-ku  Tokyo  101-0054
+				JP
+
+00-18-25   (hex)		Private
+001825     (base 16)		Private
+
+00-18-79   (hex)		dSys
+001879     (base 16)		dSys
+				Soeflinger Str. 100
+				Ulm  BW  89077
+				DE
+
+00-18-03   (hex)		ArcSoft Shanghai Co. LTD
+001803     (base 16)		ArcSoft Shanghai Co. LTD
+				20th Floor, Suite (EAST) 2008, China Merchants Plaza, 333
+				Shanghai    200041
+				CN
+
+00-17-EF   (hex)		IBM Corp
+0017EF     (base 16)		IBM Corp
+				2051 Mission College Blvd 
+				Santa Clara  CA  95054
+				US
+
+00-17-F5   (hex)		LIG NEOPTEK
+0017F5     (base 16)		LIG NEOPTEK
+				926 Gosaek-dong
+				Suwon-si  Gyeonggi-do  441-813
+				KR
+
+00-17-CD   (hex)		CEC Wireless R&D Ltd.
+0017CD     (base 16)		CEC Wireless R&D Ltd.
+				West M5 Building,No.1 East Road
+				Beijing    100016
+				CN
+
+00-17-D0   (hex)		Opticom Communications, LLC
+0017D0     (base 16)		Opticom Communications, LLC
+				1050 Connecticut Avenue, NW
+				Washington  DC  20036
+				US
+
+00-17-C6   (hex)		Cross Match Technologies Inc
+0017C6     (base 16)		Cross Match Technologies Inc
+				400, boul. Jean-Lesage
+				Québec    G1K 8W1
+				CA
+
+00-17-FE   (hex)		TALOS SYSTEM INC.
+0017FE     (base 16)		TALOS SYSTEM INC.
+				6191 CORNERSTONE CT. STE #109
+				SAN DIEGO  CA  92121
+				US
+
+00-17-F8   (hex)		Motech Industries Inc.
+0017F8     (base 16)		Motech Industries Inc.
+				6F, No. 248, Sec. 3, Pei-Shen Rd.,
+				Taipei Hsien    222
+				TW
+
+00-17-C3   (hex)		KTF Technologies Inc.
+0017C3     (base 16)		KTF Technologies Inc.
+				4th Fl., Central Tower, 265-3, Seohyun-Dong
+				Sungnam-City  Kyunggi-Do  463-769
+				KR
+
+00-17-B7   (hex)		Tonze Technology Co.
+0017B7     (base 16)		Tonze Technology Co.
+				5F-10, No.6, Lane 180,
+				Taipei    11490
+				TW
+
+00-17-AB   (hex)		Nintendo Co., Ltd.
+0017AB     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-18-07   (hex)		Fanstel Corp.
+001807     (base 16)		Fanstel Corp.
+				7466 E. Monte Cristo Ave.
+				Scottsdale  Arizona  85260
+				US
+
+00-18-08   (hex)		SightLogix, Inc.
+001808     (base 16)		SightLogix, Inc.
+				745 Alexander Road
+				Princeton  NJ  08540
+				US
+
+00-17-CE   (hex)		Screen Service Spa
+0017CE     (base 16)		Screen Service Spa
+				Via G.Di Vittorio 17
+				  Brescia  25125
+				IT
+
+00-17-DB   (hex)		CANKO TECHNOLOGIES INC.
+0017DB     (base 16)		CANKO TECHNOLOGIES INC.
+				5 FL. DONG SUNG BLDG. 17-8
+				SEOUL    150-874
+				KR
+
+00-17-D6   (hex)		Bluechips Microhouse Co.,Ltd.
+0017D6     (base 16)		Bluechips Microhouse Co.,Ltd.
+				212/2 M.10 Tambol Umong
+				Lamphun    51150
+				TH
+
+00-17-87   (hex)		Brother, Brother & Sons ApS
+001787     (base 16)		Brother, Brother & Sons ApS
+				Ved Amagerbanen 9
+				Copenhagen S    DK-2300
+				DK
+
+00-17-89   (hex)		Zenitron Corporation
+001789     (base 16)		Zenitron Corporation
+				No. 8, Lane 250, Sinhu 2nd Rd., Neihu District,
+				Taipei    11494
+				TW
+
+00-17-60   (hex)		Naito Densei Machida MFG.CO.,LTD
+001760     (base 16)		Naito Densei Machida MFG.CO.,LTD
+				2-17-28 Fuchinobe
+				Sagamihara  Kanagawa  229-0006
+				JP
+
+00-17-61   (hex)		Private
+001761     (base 16)		Private
+
+00-17-68   (hex)		Zinwave Ltd
+001768     (base 16)		Zinwave Ltd
+				Zinwave Ltd, Harston Mill
+				Cambridge  Cambridgeshire  CB2 5GG
+				GB
+
+00-17-69   (hex)		Cymphonix Corp
+001769     (base 16)		Cymphonix Corp
+				8871 S. Sandy Parkway, Suite 150
+				Sandy  UT  84070
+				US
+
+00-17-62   (hex)		Solar Technology, Inc.
+001762     (base 16)		Solar Technology, Inc.
+				7620 Cetronia Road
+				Allentown  PA  18106
+				US
+
+00-17-8F   (hex)		NINGBO YIDONG ELECTRONIC CO.,LTD.
+00178F     (base 16)		NINGBO YIDONG ELECTRONIC CO.,LTD.
+				No.65 Siming East Rd
+				Yuyao City, Zhejiang Province  Zhejiang Province China  P.C 315400
+				CN
+
+00-17-94   (hex)		Cisco Systems, Inc
+001794     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-8A   (hex)		DARTS TECHNOLOGIES CORP.
+00178A     (base 16)		DARTS TECHNOLOGIES CORP.
+				2F,No.119,Chien Kang Rd.,
+				Chung-Ho  Taipei Hsien  235
+				TW
+
+00-17-34   (hex)		ADC Telecommunications
+001734     (base 16)		ADC Telecommunications
+				541 E Trimble Road    
+				San Jose  California  95134-1224
+				US
+
+00-17-2E   (hex)		FXC Inc.
+00172E     (base 16)		FXC Inc.
+				10-16 6F, Nihonbashi Tomizawa-Chou, Chuo-ku
+				Tokyo    103-0006
+				JP
+
+00-17-2B   (hex)		Global Technologies Inc.
+00172B     (base 16)		Global Technologies Inc.
+				4/F Kicox Bldg.,188-5,Guro-Dong,Guro-gu,
+				  Seoul  152-848
+				KR
+
+00-17-72   (hex)		ASTRO Strobel Kommunikationssysteme GmbH
+001772     (base 16)		ASTRO Strobel Kommunikationssysteme GmbH
+				Olefant 1-3
+				Bergisch Gladbach  NRW  51427
+				DE
+
+00-17-3E   (hex)		LeucotronEquipamentos Ltda.
+00173E     (base 16)		LeucotronEquipamentos Ltda.
+				Rua Jorge Dionisio Barbosa, 312
+				Santa Rita do Sapucai  Minas Gerais  37.540-000
+				BR
+
+00-17-98   (hex)		Azonic Technology Co., LTD
+001798     (base 16)		Azonic Technology Co., LTD
+				15F-3, No. 163, Sec., 1 Keelung Rd.
+				Taipei    110
+				TW
+
+00-17-47   (hex)		Trimble
+001747     (base 16)		Trimble
+				345 SW Avery Ave
+				Corvallis  OR  97333
+				US
+
+00-17-7A   (hex)		ASSA ABLOY AB
+00177A     (base 16)		ASSA ABLOY AB
+				Theres Svenssons gata 15
+				Goteborg    41755
+				SE
+
+00-16-F4   (hex)		Eidicom Co., Ltd.
+0016F4     (base 16)		Eidicom Co., Ltd.
+				Polychem B/D 4th Floor, 900-1
+				Anyang-si  Kyeonggi-do  431-060
+				KR
+
+00-16-E7   (hex)		Dynamix Promotions Limited
+0016E7     (base 16)		Dynamix Promotions Limited
+				788-790, Finchley Road
+				London    NW11 7TJ
+				GB
+
+00-16-E5   (hex)		FORDLEY DEVELOPMENT LIMITED
+0016E5     (base 16)		FORDLEY DEVELOPMENT LIMITED
+				ROOM 706, 7TH FLOOR, YU SUNG BOON BUILDING, 107-111 DES VOEUX ROAD, CENTRAL,
+				    
+				HK
+
+00-16-E6   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+0016E6     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan
+				    324
+				TW
+
+00-17-20   (hex)		Image Sensing Systems, Inc.
+001720     (base 16)		Image Sensing Systems, Inc.
+				1600 University Ave. W.
+				St. Paul  MN  55104
+				US
+
+00-17-1A   (hex)		Winegard Company
+00171A     (base 16)		Winegard Company
+				3000 Kirkwood Street
+				Burlington  IA  52601
+				US
+
+00-16-C8   (hex)		Cisco Systems, Inc
+0016C8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-16-C4   (hex)		SiRF Technology, Inc.
+0016C4     (base 16)		SiRF Technology, Inc.
+				217 Devcon Dr.
+				San Jose  CA  95112
+				US
+
+00-16-F3   (hex)		CAST Information Co., Ltd
+0016F3     (base 16)		CAST Information Co., Ltd
+				5F MSA Bldg. 891-43 Dacchi-Dong,
+				SEOUL    135-280
+				KR
+
+00-16-F5   (hex)		Dalian Golden Hualu Digital Technology Co.,Ltd
+0016F5     (base 16)		Dalian Golden Hualu Digital Technology Co.,Ltd
+				No.1 Hua Road,Qixianling
+				Dalian  LiaoNing  116023
+				CN
+
+00-16-F1   (hex)		OmniSense, LLC
+0016F1     (base 16)		OmniSense, LLC
+				72 sams point road
+				Ladys Island  SC  29907
+				US
+
+00-16-DD   (hex)		Gigabeam Corporation
+0016DD     (base 16)		Gigabeam Corporation
+				407 Springpark Place
+				Herndon  VA  20170
+				US
+
+00-17-1C   (hex)		NT MicroSystems, Inc.
+00171C     (base 16)		NT MicroSystems, Inc.
+				1-5-3-2F Tamagawadai
+				Setagaya  Tokyo  158-0096
+				JP
+
+00-17-16   (hex)		Qno Technology Inc.
+001716     (base 16)		Qno Technology Inc.
+				6F-2, No.25, Puding Road
+				Hsinchu  Taiwan  300
+				TW
+
+00-17-26   (hex)		m2c Electronic Technology Ltd.
+001726     (base 16)		m2c Electronic Technology Ltd.
+				2403, 24/F, Nanyang Plaza
+				Kwuntong  Hong Kong  999 999
+				CN
+
+00-17-21   (hex)		FITRE S.p.A.
+001721     (base 16)		FITRE S.p.A.
+				Via Valsolda, 15
+				MILANO  MI  20142
+				IT
+
+00-16-F9   (hex)		CETRTA POT, d.o.o., Kranj
+0016F9     (base 16)		CETRTA POT, d.o.o., Kranj
+				Planina 3
+				Kranj  SI  4000
+				SI
+
+00-17-0A   (hex)		INEW DIGITAL COMPANY
+00170A     (base 16)		INEW DIGITAL COMPANY
+				Supply Bureau 3th floor KT&G 203-1,
+				Daejeon    306-712
+				KR
+
+00-16-BD   (hex)		ATI Industrial Automation
+0016BD     (base 16)		ATI Industrial Automation
+				1031 Goodworth Drive
+				Apex  North Carolina  27539-3869
+				US
+
+00-16-C0   (hex)		Semtech Corporation
+0016C0     (base 16)		Semtech Corporation
+				200 Flynn Rd
+				Camarillo  California  93012
+				US
+
+00-16-C2   (hex)		Avtec Systems Inc
+0016C2     (base 16)		Avtec Systems Inc
+				14432 Albemarle Point Place
+				Chantilly  Virginia  20151
+				US
+
+00-16-BA   (hex)		WEATHERNEWS INC.
+0016BA     (base 16)		WEATHERNEWS INC.
+				NAKASE 1-3 MTG
+				CHIBA    262-0032
+				US
+
+00-16-B2   (hex)		DriveCam Inc
+0016B2     (base 16)		DriveCam Inc
+				3954 Murphy Canyon Road
+				San Diego  CA  92123
+				US
+
+00-16-B3   (hex)		Photonicbridges (China) Co., Ltd.
+0016B3     (base 16)		Photonicbridges (China) Co., Ltd.
+				No. 900, Yishan road,
+				Shanghai    200233
+				US
+
+00-16-AD   (hex)		BT-Links Company Limited
+0016AD     (base 16)		BT-Links Company Limited
+				Rm 802, Nan Fung Centre, 264-298 Castle Peak Rd
+				    
+				HK
+
+00-16-6E   (hex)		Arbitron Inc.
+00166E     (base 16)		Arbitron Inc.
+				9705 Patuxent Woods Drive
+				Columbia  MD  21046
+				US
+
+00-16-AF   (hex)		Shenzhen Union Networks Equipment Co.,Ltd.
+0016AF     (base 16)		Shenzhen Union Networks Equipment Co.,Ltd.
+				Yihai Square east building 2307, Chuangye road, Nanshan District
+				Shenzhen  Guangdong  518054
+				CN
+
+00-16-9E   (hex)		TV One Ltd
+00169E     (base 16)		TV One Ltd
+				Unit V Continental Approach
+				Margate  Kent  CT9 4JG
+				GB
+
+00-16-6A   (hex)		TPS
+00166A     (base 16)		TPS
+				145 quai de Stalingrad
+				Issy Les Moulineaux  Ile de France  92137
+				FR
+
+00-16-63   (hex)		KBT Mobile
+001663     (base 16)		KBT Mobile
+				4F, Polaris I, 15-3, Jeongja-dong, Bundang-gu
+				Seongnam-si,  Gyeonggi-do  463-811
+				KR
+
+00-16-9F   (hex)		Vimtron Electronics Co., Ltd.
+00169F     (base 16)		Vimtron Electronics Co., Ltd.
+				7F., No.9, Alley 2, Lane 35
+				Neihu District  Taipei City  11492
+				TW
+
+00-16-9A   (hex)		Quadrics Ltd
+00169A     (base 16)		Quadrics Ltd
+				1 Bridewell Street
+				Bristol    BS1 2AA
+				GB
+
+00-16-92   (hex)		Scientific-Atlanta, Inc.
+001692     (base 16)		Scientific-Atlanta, Inc.
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+00-16-91   (hex)		Moser-Baer AG
+001691     (base 16)		Moser-Baer AG
+				Spitalstrasse 7
+				Sumiswald  BE  3454
+				CH
+
+00-16-88   (hex)		ServerEngines LLC
+001688     (base 16)		ServerEngines LLC
+				209 N. Fair Oaks Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-16-8B   (hex)		Paralan Corporation
+00168B     (base 16)		Paralan Corporation
+				455 Ruffner St.
+				San Diego  CA  92111
+				US
+
+00-16-82   (hex)		Pro Dex, Inc
+001682     (base 16)		Pro Dex, Inc
+				1800 NW 169th Place
+				Beaverton  Oregon  97006
+				US
+
+00-16-0A   (hex)		SWEEX Europe BV
+00160A     (base 16)		SWEEX Europe BV
+				Ampereweg 3
+				Delft  Zuid-Holland  2627 BG
+				NL
+
+00-16-02   (hex)		CEYON TECHNOLOGY CO.,LTD.
+001602     (base 16)		CEYON TECHNOLOGY CO.,LTD.
+				13F Samsung Insurance B/D. #942-9
+				Suwon-City  Gyeonggi-Do  442-832
+				KR
+
+00-16-00   (hex)		CelleBrite Mobile Synchronization
+001600     (base 16)		CelleBrite Mobile Synchronization
+				25 Basel St
+				Petach Tikva    49170
+				IL
+
+00-15-F4   (hex)		Eventide
+0015F4     (base 16)		Eventide
+				1 Alsan Way
+				Little Ferry  NJ  07643
+				US
+
+00-16-29   (hex)		Nivus GmbH
+001629     (base 16)		Nivus GmbH
+				Im Täle 2
+				Eppingen  Baden-Württemberg  75031
+				DE
+
+00-16-21   (hex)		Colorado Vnet
+001621     (base 16)		Colorado Vnet
+				255 E. 6th St.
+				Loveland  CO  80537
+				US
+
+00-16-1A   (hex)		Dametric AB
+00161A     (base 16)		Dametric AB
+				Box 120
+				Skarholmen  Stockholm  SE-12723
+				SE
+
+00-16-15   (hex)		Nittan Company, Limited
+001615     (base 16)		Nittan Company, Limited
+				11-6, 1-chome, Hatagaya
+				Shibuya-ku  Tokyo  151-8535
+				JP
+
+00-16-16   (hex)		BROWAN COMMUNICATION INC.
+001616     (base 16)		BROWAN COMMUNICATION INC.
+				No.1 Jen-Ai Road, HsinChu Industrial Park,
+				HuKou Hsiang  HsinChu Hsien  303
+				TW
+
+00-16-17   (hex)		MSI
+001617     (base 16)		MSI
+				No.69, Li-De St, Jung-Ho City
+				Taipei Hsien    235
+				TW
+
+00-16-2E   (hex)		Space Shuttle Hi-Tech Co., Ltd.
+00162E     (base 16)		Space Shuttle Hi-Tech Co., Ltd.
+				No. 226, Wu-Ho St., Wu-Lung Village,
+				Hsinchu Hsien    307
+				TW
+
+00-16-2A   (hex)		Antik computers & communications s.r.o.
+00162A     (base 16)		Antik computers & communications s.r.o.
+				Razusova 2
+				Kosice  SK  SK-04001
+				SK
+
+00-16-56   (hex)		Nintendo Co., Ltd.
+001656     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-16-51   (hex)		Exeo Systems
+001651     (base 16)		Exeo Systems
+				1650, rue Michelin, suite 201
+				Laval  Québec  H7L 4R3
+				CA
+
+00-16-10   (hex)		Carina Technology
+001610     (base 16)		Carina Technology
+				690A Discovery Drive
+				Huntsville  AL  35806
+				US
+
+00-16-06   (hex)		Ideal Industries
+001606     (base 16)		Ideal Industries
+				15070 Ave. of Science #200
+				San Diego  CA  92128
+				US
+
+00-16-07   (hex)		Curves International Inc.
+001607     (base 16)		Curves International Inc.
+				100 Ritchie Road
+				Waco  Texas  76712
+				US
+
+00-16-54   (hex)		Flex-P Industries Sdn. Bhd.
+001654     (base 16)		Flex-P Industries Sdn. Bhd.
+				No.128-12-2, Menara UMNO,
+				Georgetown  Penang  10400
+				US
+
+00-16-31   (hex)		Xteam
+001631     (base 16)		Xteam
+				room 801, No.102 international Science & Techology Park
+				  Beijing  8610
+				CN
+
+00-16-4B   (hex)		Quorion Data Systems GmbH
+00164B     (base 16)		Quorion Data Systems GmbH
+				An der Klinge 6
+				Erfurt  Thuringia  99095
+				DE
+
+00-15-94   (hex)		BIXOLON CO.,LTD
+001594     (base 16)		BIXOLON CO.,LTD
+				502-508,Digital Empire Bldg.
+				Yeongtong-Gu,Suwon  Gyeonggi-Do  443-813
+				KR
+
+00-15-90   (hex)		Hectronic GmbH
+001590     (base 16)		Hectronic GmbH
+				Allmendstraße 15
+				Bonndorf  Baden-Württemberg  79848
+				DE
+
+00-15-8C   (hex)		Liab ApS
+00158C     (base 16)		Liab ApS
+				Oestre Alle 6
+				Stoevring    DK-9530
+				DK
+
+00-15-8F   (hex)		NTT Advanced Technology Corporation
+00158F     (base 16)		NTT Advanced Technology Corporation
+				Shinjuku Mitsui Bldg. 2-1-1, Nishi-shinjuku,
+				Shinjuku-ku  Tokyo  163-0431
+				JP
+
+00-15-ED   (hex)		Fulcrum Microsystems, Inc.
+0015ED     (base 16)		Fulcrum Microsystems, Inc.
+				26630 Agoura Road
+				Calabasas  CA  91302
+				US
+
+00-15-F0   (hex)		EGO BV
+0015F0     (base 16)		EGO BV
+				Parade 15
+				's-Hertogenbosch  Noord-Brabant  5211KL
+				NL
+
+00-15-EE   (hex)		Omnex Control Systems
+0015EE     (base 16)		Omnex Control Systems
+				#74 - 1833 Coast Meridian Rd.
+				Port Coquitlam  BC  V3C 6G5
+				CA
+
+00-15-C8   (hex)		FlexiPanel Ltd
+0015C8     (base 16)		FlexiPanel Ltd
+				7 bis rue Lalo
+				  Paris  75016
+				FR
+
+00-15-C0   (hex)		DIGITAL TELEMEDIA CO.,LTD.
+0015C0     (base 16)		DIGITAL TELEMEDIA CO.,LTD.
+				17TH FLOOR, CHINA YUSE BUILDING,
+				SHENZHEN  GUANGDONG  518040
+				CN
+
+00-15-C2   (hex)		3M Germany
+0015C2     (base 16)		3M Germany
+				Carl Schurz Str. 1
+				Neuss  NRW  41453
+				US
+
+00-15-88   (hex)		Salutica Allied Solutions Sdn Bhd
+001588     (base 16)		Salutica Allied Solutions Sdn Bhd
+				3 Jalan Zarib 6
+				Lahat, Ipoh  Perak  31500
+				MY
+
+00-15-83   (hex)		IVT corporation
+001583     (base 16)		IVT corporation
+				Shangdi Xinxi road, Haidian District
+				Beijing    100085
+				US
+
+00-15-85   (hex)		Aonvision Technolopy Corp.
+001585     (base 16)		Aonvision Technolopy Corp.
+				2F, No. 58, Park 2nd Ave. Science-Based Industrial Park,
+				  Hsinchu  300
+				TW
+
+00-15-A5   (hex)		DCI Co., Ltd.
+0015A5     (base 16)		DCI Co., Ltd.
+				4th Fl. Susung B/D, 893-4
+				Daejeon    305-330
+				KR
+
+00-15-B2   (hex)		Advanced Industrial Computer, Inc.
+0015B2     (base 16)		Advanced Industrial Computer, Inc.
+				17970 E. Ajax Circle
+				City of Industry  CA  91748
+				US
+
+00-15-DA   (hex)		IRITEL A.D.
+0015DA     (base 16)		IRITEL A.D.
+				Batajnicki put 23
+				Beograd  Serbia  11080
+				YU
+
+00-15-4A   (hex)		WANSHIH ELECTRONIC CO., LTD
+00154A     (base 16)		WANSHIH ELECTRONIC CO., LTD
+				3F 72, WU KONG 6th RD.,
+				TAIPEI HSIEN  TAIWAN  248
+				TW
+
+00-15-4C   (hex)		Saunders Electronics
+00154C     (base 16)		Saunders Electronics
+				192 Gannett Drive
+				South Portland  ME  04106
+				US
+
+00-15-4D   (hex)		Netronome Systems, Inc.
+00154D     (base 16)		Netronome Systems, Inc.
+				3159 Unionville Road
+				Cranberry Twp.  PA  16066
+				US
+
+00-15-49   (hex)		Dixtal Biomedica Ind. Com. Ltda
+001549     (base 16)		Dixtal Biomedica Ind. Com. Ltda
+				R. Eng. Francisco Pitta Brito, 703
+				São Paulo  SP  04753-080
+				BR
+
+00-15-3D   (hex)		ELIM PRODUCT CO.
+00153D     (base 16)		ELIM PRODUCT CO.
+				602-2 GAYANG TECHNO TOWN, GAYANG, 3-DONG
+				  SEOUL  157-793
+				KR
+
+00-15-44   (hex)		coM.s.a.t. AG
+001544     (base 16)		coM.s.a.t. AG
+				Besselstraße 3
+				Mannheim    D-68219
+				US
+
+00-15-39   (hex)		Technodrive srl
+001539     (base 16)		Technodrive srl
+				Via Leonardo da Vinci  162
+				Trezzano S/N  Milan  20090
+				IT
+
+00-15-31   (hex)		KOCOM
+001531     (base 16)		KOCOM
+				5F, KOCOM Bldg., 260-7
+				SEOUL    157-040
+				KR
+
+00-15-35   (hex)		OTE Spa
+001535     (base 16)		OTE Spa
+				via Barsanti 8
+				Florence  FI  50127
+				IT
+
+00-15-36   (hex)		Powertech co.,Ltd
+001536     (base 16)		Powertech co.,Ltd
+				#705, dongyoung Venturestel, 199-32
+				Anyang City  Kyoungki-do  430-010
+				US
+
+00-15-2B   (hex)		Cisco Systems, Inc
+00152B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-2C   (hex)		Cisco Systems, Inc
+00152C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-28   (hex)		Beacon Medical Products LLC d.b.a. BeaconMedaes
+001528     (base 16)		Beacon Medical Products LLC d.b.a. BeaconMedaes
+				14408 W 105TH ST
+				LENEXA  KS  66215
+				US
+
+00-15-27   (hex)		Balboa Instruments
+001527     (base 16)		Balboa Instruments
+				1382 Bell Ave
+				Tustin  CA  92780
+				US
+
+00-15-21   (hex)		Horoquartz
+001521     (base 16)		Horoquartz
+				BP 251
+				FONTENAY LE COMTE  VENDEE  85205
+				FR
+
+00-15-20   (hex)		Radiocrafts AS
+001520     (base 16)		Radiocrafts AS
+				Sandakerveien 64
+				  Oslo  0484
+				NO
+
+00-15-66   (hex)		A-First Technology Co., Ltd.
+001566     (base 16)		A-First Technology Co., Ltd.
+				5F, No. 111-2, Shin-Teh Rd.,
+				San-Chung City  Taipei Shien  241
+				TW
+
+00-15-6B   (hex)		Perfisans Networks Corp.
+00156B     (base 16)		Perfisans Networks Corp.
+				4118 14th Avenue
+				Markham  Ontario  L3R 0J3
+				CA
+
+00-15-47   (hex)		AiZen Solutions Inc.
+001547     (base 16)		AiZen Solutions Inc.
+				10F-1, No.29, Puding Rd.
+				Hsinchu  Hsinchu County  300
+				TW
+
+00-15-79   (hex)		Lunatone Industrielle Elektronik GmbH
+001579     (base 16)		Lunatone Industrielle Elektronik GmbH
+				Rennbahnweg 55
+				Wien    1220
+				AT
+
+00-14-D7   (hex)		Datastore Technology Corp
+0014D7     (base 16)		Datastore Technology Corp
+				9F, NO.10, SEC.1, Chung Hsing RD., Wu-Ku
+				Taipei Hsien,    248
+				TW
+
+00-14-DD   (hex)		Covergence Inc.
+0014DD     (base 16)		Covergence Inc.
+				One Clock Tower Place, Suite 200
+				Maynard  MA  01754
+				US
+
+00-14-D4   (hex)		K Technology Corporation
+0014D4     (base 16)		K Technology Corporation
+				325 Ganbara
+				Kami-gun  Miyagi-ken  981-4263
+				JP
+
+00-14-CF   (hex)		INVISIO Communications
+0014CF     (base 16)		INVISIO Communications
+				Stamholmen 157
+				Hvidovre    2650
+				DK
+
+00-14-BE   (hex)		Wink communication technology CO.LTD
+0014BE     (base 16)		Wink communication technology CO.LTD
+				Huijiang Ind Blding Dashi Town
+				Guang zhou  Guang dong  511430
+				CN
+
+00-15-11   (hex)		Data Center Systems
+001511     (base 16)		Data Center Systems
+				14802 Venture Drive
+				Dallas  TX  75234
+				US
+
+00-15-0E   (hex)		OPENBRAIN TECHNOLOGIES CO., LTD.
+00150E     (base 16)		OPENBRAIN TECHNOLOGIES CO., LTD.
+				#804,ANYANG K-CENTER,1591-9 , BURIM-DONG,DONGAN-GU,
+				ANYANG  KYUNGGI-DO  431-815
+				KR
+
+00-15-0D   (hex)		Hoana Medical, Inc.
+00150D     (base 16)		Hoana Medical, Inc.
+				828 Fort Street Mall
+				Honolulu  HI  96813
+				US
+
+00-15-1C   (hex)		LENECO
+00151C     (base 16)		LENECO
+				6th.,Dong Moon Good Morning Tower 1
+				Kyeong Ki-Do  GoYang-Si  411-817
+				KR
+
+00-15-19   (hex)		StoreAge Networking Technologies
+001519     (base 16)		StoreAge Networking Technologies
+				63 Bar-Yehuda st.
+				Nesher    36651
+				IL
+
+00-15-06   (hex)		Neo Photonics
+001506     (base 16)		Neo Photonics
+				910 E. California St.
+				Sunnyvale  CA  94085
+				US
+
+00-15-04   (hex)		GAME PLUS CO., LTD.
+001504     (base 16)		GAME PLUS CO., LTD.
+				164-57, Yeonghwa-dong, Jangan-gu
+				Suwon  Gyeonggi-do  440-818
+				KR
+
+00-15-05   (hex)		Actiontec Electronics, Inc
+001505     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-14-FE   (hex)		Artech Electronics
+0014FE     (base 16)		Artech Electronics
+				#301, Yangjae Bldg., 276-2
+				Seoul    137-895
+				KR
+
+00-14-DE   (hex)		Sage Instruments Inc.
+0014DE     (base 16)		Sage Instruments Inc.
+				240 Airport Blvd.
+				Freedom  CA  95019
+				US
+
+00-14-DF   (hex)		HI-P Tech Corporation
+0014DF     (base 16)		HI-P Tech Corporation
+				1-27-23 Higashitokorozawa
+				Tokorozawa  Saitama  359-0021
+				JP
+
+00-14-E6   (hex)		AIM Infrarotmodule GmbH
+0014E6     (base 16)		AIM Infrarotmodule GmbH
+				Soeflingerstraße 100
+				Ulm  BW  89077
+				DE
+
+00-14-F3   (hex)		ViXS Systems Inc
+0014F3     (base 16)		ViXS Systems Inc
+				2235 Sheppard Ave East
+				TORONTO  ONTARIO  M2J 5B5
+				CA
+
+00-14-7E   (hex)		InnerWireless
+00147E     (base 16)		InnerWireless
+				1155 Kas Drive, Suite 200
+				Richardson  TX  75081
+				US
+
+00-14-7D   (hex)		Aeon Digital International
+00147D     (base 16)		Aeon Digital International
+				31-6, The Bund Center
+				Shanghai  SH  200002
+				CN
+
+00-14-76   (hex)		MultiCom Industries Limited
+001476     (base 16)		MultiCom Industries Limited
+				Room 1206-7, Manhattan Center,
+				Kwai Chung, N.T.    
+				HK
+
+00-14-73   (hex)		Bookham Inc
+001473     (base 16)		Bookham Inc
+				10 Brewer Hunt Way
+				Kanata  ON  K2K 2B5
+				CA
+
+00-14-89   (hex)		B15402100 - JANDEI, S.L.
+001489     (base 16)		B15402100 - JANDEI, S.L.
+				POL. IND. POCOMACO, E-28
+				LA Coruña    15190
+				ES
+
+00-14-80   (hex)		Hitachi-LG Data Storage Korea, Inc
+001480     (base 16)		Hitachi-LG Data Storage Korea, Inc
+				19-1,Cheongho-ri
+				Pyungtaik  Kyunggi-Do  451-713
+				KR
+
+00-14-B6   (hex)		Enswer Technology Inc.
+0014B6     (base 16)		Enswer Technology Inc.
+				1F No.70 Sec.2 Chung Shun St.
+				Taipei    116
+				TW
+
+00-14-B2   (hex)		mCubelogics Corporation
+0014B2     (base 16)		mCubelogics Corporation
+				4F, Unibooks B/D, 514-1, Dogok-Dong, KangNam
+				Seoul    135-270
+				KR
+
+00-14-AE   (hex)		Wizlogics Co., Ltd.
+0014AE     (base 16)		Wizlogics Co., Ltd.
+				Rm#1321, Samchang Plaza, 173,
+				Seoul    121-745
+				KR
+
+00-14-A6   (hex)		Teranetics, Inc.
+0014A6     (base 16)		Teranetics, Inc.
+				3965 Freedom Circle
+				Santa Clara  CA  95054
+				US
+
+00-14-69   (hex)		Cisco Systems, Inc
+001469     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-BA   (hex)		Carvers SA de CV
+0014BA     (base 16)		Carvers SA de CV
+				Alvarez del Castillo 1550
+				Guadalajara  Jalisco  44620
+				MX
+
+00-14-8A   (hex)		Elin Ebg Traction Gmbh
+00148A     (base 16)		Elin Ebg Traction Gmbh
+				Cumberlandstrasse 32
+				Vienna    1140
+				AT
+
+00-14-91   (hex)		Daniels Electronics Ltd. dbo Codan Rado Communications
+001491     (base 16)		Daniels Electronics Ltd. dbo Codan Rado Communications
+				43 Erie St
+				Victoria  BC  V8V 1P8
+				CA
+
+00-14-6E   (hex)		H. Stoll GmbH & Co. KG
+00146E     (base 16)		H. Stoll GmbH & Co. KG
+				Stollweg
+				Reutlingen  Deutschland  72760
+				DE
+
+00-14-AA   (hex)		Ashly Audio, Inc.
+0014AA     (base 16)		Ashly Audio, Inc.
+				847 Holt Road
+				Webster  NY  14580
+				US
+
+00-14-09   (hex)		MAGNETI MARELLI   S.E. S.p.A.
+001409     (base 16)		MAGNETI MARELLI   S.E. S.p.A.
+				ZI Nord, Allee d'Argenson
+				CHATELLERAULT    86100
+				FR
+
+00-14-0B   (hex)		FIRST INTERNATIONAL COMPUTER, INC.
+00140B     (base 16)		FIRST INTERNATIONAL COMPUTER, INC.
+				FIC BUILDING, NO.300, YANG GUANG ST.,
+				  TAIPEI COUNTY  114
+				TW
+
+00-13-FD   (hex)		Nokia Danmark A/S
+0013FD     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-14-00   (hex)		MINERVA KOREA CO., LTD
+001400     (base 16)		MINERVA KOREA CO., LTD
+				#203, SH Sienne, Seohyeon-Dong
+				Seongnam-Si  Gyeonggi-Do  463-821
+				KR
+
+00-13-FC   (hex)		SiCortex, Inc
+0013FC     (base 16)		SiCortex, Inc
+				One Clocktower Place
+				Maynard  MA  01754
+				US
+
+00-13-F6   (hex)		Cintech
+0013F6     (base 16)		Cintech
+				21a route de la wantzenau
+				Hoenheim    67800
+				FR
+
+00-14-4F   (hex)		Oracle Corporation 
+00144F     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-14-56   (hex)		Edge Products
+001456     (base 16)		Edge Products
+				1080 South Depot Drive
+				Ogden  Utah  84404
+				US
+
+00-14-50   (hex)		Heim Systems GmbH
+001450     (base 16)		Heim Systems GmbH
+				Friedrich Ebert Strasse
+				Bergisch Gladbach  NRW  51429
+				DE
+
+00-14-52   (hex)		CALCULEX,INC.
+001452     (base 16)		CALCULEX,INC.
+				132 W. LAS CRUCES AVE.
+				LAS CRUCES  NEW MEXICO  88001
+				US
+
+00-14-42   (hex)		ATTO CORPORATION
+001442     (base 16)		ATTO CORPORATION
+				1-25-23 Hongo,
+				  Tokyo  113-8425
+				JP
+
+00-14-47   (hex)		BOAZ Inc.
+001447     (base 16)		BOAZ Inc.
+				282 Pukok-ri SongSan-myon Dangzin-gun Chungcheongnam-do, 343-834
+				Seoul  SeoCho-gu  137-070
+				KR
+
+00-14-3E   (hex)		AirLink Communications, Inc.
+00143E     (base 16)		AirLink Communications, Inc.
+				3159 Corporate Place
+				Hayward  CA  94545
+				US
+
+00-14-5D   (hex)		WJ Communications, Inc.
+00145D     (base 16)		WJ Communications, Inc.
+				401 River Oaks Parkway
+				San Jose  CA  95134
+				US
+
+00-14-3B   (hex)		Sensovation AG
+00143B     (base 16)		Sensovation AG
+				Markhallen -Str
+				Radolfzell  Baden-Württemberg  78315
+				DE
+
+00-14-2D   (hex)		Toradex AG
+00142D     (base 16)		Toradex AG
+				Altsagenstrasse 5
+				Horw  LU  6048
+				CH
+
+00-14-29   (hex)		V Center Technologies Co., Ltd.
+001429     (base 16)		V Center Technologies Co., Ltd.
+				7F-7, NO.35, Hsintai Rd.
+				Jubei City  Hsinchu  302
+				TW
+
+00-14-14   (hex)		Jumpnode Systems LLC.
+001414     (base 16)		Jumpnode Systems LLC.
+				800 Washington Ave N.
+				Minneapolis  MN  55041
+				US
+
+00-14-1E   (hex)		P.A. Semi, Inc.
+00141E     (base 16)		P.A. Semi, Inc.
+				3965 Freedom Circle, Fl 8
+				Santa Clara  CA  95054
+				US
+
+00-13-CB   (hex)		Zenitel Norway AS
+0013CB     (base 16)		Zenitel Norway AS
+				Sandaker v 24 c
+				  Oslo  0403
+				NO
+
+00-13-CF   (hex)		4Access Communications
+0013CF     (base 16)		4Access Communications
+				1 N. LaSalle St.
+				Chicago  IL  60602
+				US
+
+00-13-BE   (hex)		Virtual Conexions
+0013BE     (base 16)		Virtual Conexions
+				410 rue St-Nicolas, suite 600
+				Montréal  QUÉBEC  H2Y 2P5
+				CA
+
+00-13-B9   (hex)		BM SPA
+0013B9     (base 16)		BM SPA
+				VIA MILANO 54/56
+				Rozzano    20089
+				IT
+
+00-13-AB   (hex)		Telemotive AG
+0013AB     (base 16)		Telemotive AG
+				Breitwiesen
+				Muehlhausen  Baden Wuerttemberg  73347
+				DE
+
+00-13-C9   (hex)		Beyond Achieve Enterprises Ltd.
+0013C9     (base 16)		Beyond Achieve Enterprises Ltd.
+				XIN LIAN HI-TECH INDUSTRIAL AREA, HU-MEN
+				DONGGUAN  GUANG DONG  
+				CN
+
+00-13-C6   (hex)		OpenGear, Inc
+0013C6     (base 16)		OpenGear, Inc
+				7984 South Welby Park #101
+				Salt Lake City  UTAH  84088
+				US
+
+00-13-F3   (hex)		Giga-byte Communications Inc.
+0013F3     (base 16)		Giga-byte Communications Inc.
+				8F, No.43, Fu-Hsin Road. Hsin-Tien
+				Taipei Hsien    231
+				TW
+
+00-13-F4   (hex)		Psitek (Pty) Ltd
+0013F4     (base 16)		Psitek (Pty) Ltd
+				The Vineyards Office Estate
+				Tyger Valley  Cape Town  7530
+				ZA
+
+00-13-AC   (hex)		Sunmyung Electronics Co., LTD
+0013AC     (base 16)		Sunmyung Electronics Co., LTD
+				LARGO-PLAZA 8F, Janghang-Dong
+				Koyang  Kyungki  411-837
+				KR
+
+00-13-A8   (hex)		Tanisys Technology
+0013A8     (base 16)		Tanisys Technology
+				11001 Lakeline blvd
+				Austin  TX  78717
+				US
+
+00-13-DA   (hex)		Diskware Co., Ltd
+0013DA     (base 16)		Diskware Co., Ltd
+				1-4-12 Kiba
+				Koto-ku  Tokyo  135-0042
+				JP
+
+00-13-D8   (hex)		Princeton Instruments
+0013D8     (base 16)		Princeton Instruments
+				3660 Quakerbridge Road
+				Trenton  NJ  08619
+				US
+
+00-13-99   (hex)		STAC Corporation.
+001399     (base 16)		STAC Corporation.
+				2-16-37 fujimi
+				sayama-shi  saitama  350-1306
+				JP
+
+00-13-E9   (hex)		VeriWave, Inc.
+0013E9     (base 16)		VeriWave, Inc.
+				9600 SW Oak St.
+				Portland  OR  97223
+				US
+
+00-13-95   (hex)		congatec AG
+001395     (base 16)		congatec AG
+				Auwiesenstrasse 5
+				Deggendorf    94469
+				DE
+
+00-13-56   (hex)		FLIR Radiation Inc
+001356     (base 16)		FLIR Radiation Inc
+				100 Midland Rd
+				Oak Ridge  TN  37830
+				US
+
+00-13-5A   (hex)		Project T&E Limited
+00135A     (base 16)		Project T&E Limited
+				Room 3C, 2/F. Wah Shing Center,
+				Kwun Tong,  Kowloon,  852
+				HK
+
+00-13-61   (hex)		Biospace Co., Ltd.
+001361     (base 16)		Biospace Co., Ltd.
+				10th Floor, Poonglim Bldg, 823 Yeoksam 1-dong
+				Gangnam-gu  Seoul  135-784
+				KR
+
+00-13-62   (hex)		ShinHeung Precision Co., Ltd.
+001362     (base 16)		ShinHeung Precision Co., Ltd.
+				DaeHa Bldg. 401
+				YoungDungPoGu  Seoul  150-050
+				KR
+
+00-13-4F   (hex)		Rapidus Wireless Networks Inc.
+00134F     (base 16)		Rapidus Wireless Networks Inc.
+				47 - 14550 Morris Valley Road
+				Agassiz  British Columbia  V0M 1A1
+				CA
+
+00-13-78   (hex)		Qsan Technology, Inc.
+001378     (base 16)		Qsan Technology, Inc.
+				4F., No.103, Ruihu St., Neihu Dist.
+				Taipei    114
+				TW
+
+00-13-7A   (hex)		Netvox Technology Co., Ltd.
+00137A     (base 16)		Netvox Technology Co., Ltd.
+				No.21-1 Sec. 1 Chung Hua West Road
+				Tainan    702
+				TW
+
+00-13-81   (hex)		CHIPS & Systems, Inc.
+001381     (base 16)		CHIPS & Systems, Inc.
+				4750 Patrick Henry Drive
+				Santa Clara  California  95054
+				US
+
+00-13-79   (hex)		PONDER INFORMATION INDUSTRIES LTD.
+001379     (base 16)		PONDER INFORMATION INDUSTRIES LTD.
+				14F,No.77,lane700, Chung-Cheng Road
+				Hsin-Tien City  Taipei Hsien  231
+				TW
+
+00-13-2C   (hex)		MAZ Brandenburg GmbH
+00132C     (base 16)		MAZ Brandenburg GmbH
+				Pascalstraße 10a
+				Berlin  Berlin  10587
+				DE
+
+00-13-24   (hex)		Schneider Electric Ultra Terminal
+001324     (base 16)		Schneider Electric Ultra Terminal
+				Industriparken 32
+				Copenhagen    2750
+				DK
+
+00-13-26   (hex)		ECM Systems Ltd
+001326     (base 16)		ECM Systems Ltd
+				Ellifoot Park
+				HULL  East Yorkshire  HU12 9DZ
+				GB
+
+00-13-27   (hex)		Data Acquisitions limited
+001327     (base 16)		Data Acquisitions limited
+				84 Gasson street
+				Christchurch    
+				NZ
+
+00-13-67   (hex)		Narayon. Co., Ltd.
+001367     (base 16)		Narayon. Co., Ltd.
+				#502 Hyochang T/W 181-3
+				Seoul    138-220
+				KR
+
+00-13-5C   (hex)		OnSite Systems, Inc.
+00135C     (base 16)		OnSite Systems, Inc.
+				3900 Freedom Circle
+				Santa Clara  CA  95054-1222
+				US
+
+00-13-5F   (hex)		Cisco Systems, Inc
+00135F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-3B   (hex)		Speed Dragon Multimedia Limited
+00133B     (base 16)		Speed Dragon Multimedia Limited
+				Room 1312, Vanta Industrial Centre,
+				Kwai Chung  N.T.  
+				HK
+
+00-13-38   (hex)		FRESENIUS-VIAL
+001338     (base 16)		FRESENIUS-VIAL
+				Le Grand Chemin
+				BREZINS    38590
+				FR
+
+00-13-2D   (hex)		iWise Communications
+00132D     (base 16)		iWise Communications
+				Unit 3C, Arden Grove
+				Cape Town    7441
+				ZA
+
+00-13-74   (hex)		Atheros Communications, Inc.
+001374     (base 16)		Atheros Communications, Inc.
+				529 Almanor Avenue
+				Sunnyvale  CA  94085-3512
+				US
+
+00-13-69   (hex)		Honda Electron Co., LED.
+001369     (base 16)		Honda Electron Co., LED.
+				Kanematsu Building 3 Floor
+				Chuo-ku  Tokyo  104-0031
+				JP
+
+00-13-42   (hex)		Vision Research, Inc.
+001342     (base 16)		Vision Research, Inc.
+				190 Parish Drive
+				Wayne  NJ  07470
+				US
+
+00-13-40   (hex)		AD.EL s.r.l.
+001340     (base 16)		AD.EL s.r.l.
+				via S. Pertini,5
+				Martellago  VENEZIA  30030
+				IT
+
+00-13-0C   (hex)		HF System Corporation
+00130C     (base 16)		HF System Corporation
+				1520-1 Ayukai
+				Nishiokitama-Gun  Yamagata-Ken  992-0771
+				JP
+
+00-13-0F   (hex)		EGEMEN Bilgisayar Muh San ve Tic LTD STI
+00130F     (base 16)		EGEMEN Bilgisayar Muh San ve Tic LTD STI
+				Fevzi Cakmak 2 Sok 31/A
+				ANKARA  CANKAYA  06440
+				TR
+
+00-13-13   (hex)		GuangZhou Post & Telecom Equipment ltd
+001313     (base 16)		GuangZhou Post & Telecom Equipment ltd
+				139# Zhongshan Ave
+				Guangzhou  Guangdong  510630
+				CN
+
+00-12-CB   (hex)		CSS Inc.
+0012CB     (base 16)		CSS Inc.
+				151 Superior Blvd.
+				Mississauga  Ontario  L5T2L1
+				CA
+
+00-12-CE   (hex)		Advanced Cybernetics Group
+0012CE     (base 16)		Advanced Cybernetics Group
+				2953 Bunker Hill Lane
+				Santa Clara  CA  95054
+				US
+
+00-12-CA   (hex)		Mechatronic Brick Aps
+0012CA     (base 16)		Mechatronic Brick Aps
+				Alsion 2
+				6400  Sonderborg  
+				DK
+
+00-12-C7   (hex)		SECURAY Technologies Ltd.Co.
+0012C7     (base 16)		SECURAY Technologies Ltd.Co.
+				Tianjin Haitai Industrial Base ErWei Road
+				Tianjin    300384
+				CN
+
+00-12-CD   (hex)		ASEM SpA
+0012CD     (base 16)		ASEM SpA
+				Via Buia, 4
+				ARTEGNA  Udine  I-33011
+				IT
+
+00-12-E8   (hex)		Fraunhofer IMS
+0012E8     (base 16)		Fraunhofer IMS
+				Finkenstrasse 61
+				Duisburg  NRW  47057
+				DE
+
+00-12-DD   (hex)		Shengqu Information Technology (Shanghai) Co., Ltd.
+0012DD     (base 16)		Shengqu Information Technology (Shanghai) Co., Ltd.
+				No.1 Building,No. 690 Bibo Road,Pudong New Area
+				Shanghai    201203
+				CN
+
+00-13-1D   (hex)		Scanvaegt International A/S
+00131D     (base 16)		Scanvaegt International A/S
+				P.O.Pedersens vej 18
+				Aarhus  Jylland  8200 N
+				DK
+
+00-13-18   (hex)		DGSTATION Co., Ltd.
+001318     (base 16)		DGSTATION Co., Ltd.
+				Rm.401, Bldg.A, Bundang Techno Park 150, Yatap-Dong, Bundang-Gu, Sungnam-Si, Gyunggi-Do, 463-760, Korea
+				Sungnam  Gyunggi  463-760
+				KR
+
+00-13-1A   (hex)		Cisco Systems, Inc
+00131A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-F4   (hex)		Belco International Co.,Ltd.
+0012F4     (base 16)		Belco International Co.,Ltd.
+				212, Yeokok-Dong, Wonmi-gu
+				Puchun-Si  Kyongki-Do  420-100
+				KR
+
+00-12-F5   (hex)		Imarda New Zealand Limited
+0012F5     (base 16)		Imarda New Zealand Limited
+				Suite G16, National Innovation Centre,
+				Eveleigh NSW     2015
+				NZ
+
+00-12-E0   (hex)		Codan Limited
+0012E0     (base 16)		Codan Limited
+				81 Graves Street
+				Newton  South  5074
+				AU
+
+00-12-DE   (hex)		Radio Components Sweden AB
+0012DE     (base 16)		Radio Components Sweden AB
+				Viderogatan 3B
+				Kista    16422
+				SE
+
+00-13-01   (hex)		IronGate S.L.
+001301     (base 16)		IronGate S.L.
+				C\Alcala 268, primera planta
+				Madrid    28027
+				ES
+
+00-12-F6   (hex)		MDK CO.,LTD.
+0012F6     (base 16)		MDK CO.,LTD.
+				2-6-27 Ibarame
+				Kashiwazaki City  Niigata  9451341
+				JP
+
+00-12-F1   (hex)		IFOTEC
+0012F1     (base 16)		IFOTEC
+				ZAC Champfeuillet
+				VOIRON    38507
+				FR
+
+00-12-F8   (hex)		WNI Resources, LLC
+0012F8     (base 16)		WNI Resources, LLC
+				2146 Bering Drive
+				San Jose  California  95131-2013
+				US
+
+00-12-7C   (hex)		SWEGON AB
+00127C     (base 16)		SWEGON AB
+				 Box 300
+				KVÄNUM  VÄSTRA GÖTALAND  SE 535 23
+				SE
+
+00-12-78   (hex)		International Bar Code
+001278     (base 16)		International Bar Code
+				160 Oak Street
+				Glastonbury  CT  06033
+				US
+
+00-12-7A   (hex)		Sanyu Industry Co.,Ltd.
+00127A     (base 16)		Sanyu Industry Co.,Ltd.
+				Midori-ku Hakusan1-11-11
+				Yokohama-shi  Kanagawa-ken  226-0006
+				JP
+
+00-12-68   (hex)		IPS d.o.o.
+001268     (base 16)		IPS d.o.o.
+				C. Ljubljanske brigade 17
+				Ljubljana    SI-1000
+				SI
+
+00-12-AC   (hex)		ONTIMETEK INC.
+0012AC     (base 16)		ONTIMETEK INC.
+				9Fl.,Owner's Tower
+				Sungnam-Si  Kyunggi-Do  463-825
+				KR
+
+00-12-BC   (hex)		Echolab LLC
+0012BC     (base 16)		Echolab LLC
+				267 Boston Road
+				Billerica  MA  01862
+				US
+
+00-12-BD   (hex)		Avantec Manufacturing Limited
+0012BD     (base 16)		Avantec Manufacturing Limited
+				Unit L, 7/F, Camelpaint Bldg, Block 3
+				    852
+				HK
+
+00-12-AB   (hex)		WiLife, Inc.
+0012AB     (base 16)		WiLife, Inc.
+				132 E. 13065 S., Suite 150
+				Draper  UT  84020
+				US
+
+00-12-9B   (hex)		E2S Electronic Engineering Solutions, S.L.
+00129B     (base 16)		E2S Electronic Engineering Solutions, S.L.
+				Sant Ferran 10
+				Barcelona    08031
+				ES
+
+00-12-98   (hex)		MICO ELECTRIC(SHENZHEN) LIMITED
+001298     (base 16)		MICO ELECTRIC(SHENZHEN) LIMITED
+				
+				SHENZHEN  GUANGDONG  518040
+				CN
+
+00-12-72   (hex)		Redux Communications Ltd.
+001272     (base 16)		Redux Communications Ltd.
+				POB 101
+				Modiin    71700
+				IL
+
+00-12-6A   (hex)		OPTOELECTRONICS Co., Ltd.
+00126A     (base 16)		OPTOELECTRONICS Co., Ltd.
+				3-1Kamiaokinishi 1-chome
+				Kawaguchi  Saitama Pref.  333-0845
+				JP
+
+00-12-C0   (hex)		HotLava Systems, Inc.
+0012C0     (base 16)		HotLava Systems, Inc.
+				6329 Chelton Drive
+				Oakland  CA  94611
+				US
+
+00-12-B7   (hex)		PTW Freiburg
+0012B7     (base 16)		PTW Freiburg
+				Loerracher Strasse 7
+				Freiburg    79115
+				DE
+
+00-12-A1   (hex)		BluePacket Communications Co., Ltd.
+0012A1     (base 16)		BluePacket Communications Co., Ltd.
+				10F-1, No. 420, Sec. 1, Keelung Rd., 110,
+				Taipei    110
+				TW
+
+00-12-06   (hex)		iQuest (NZ) Ltd
+001206     (base 16)		iQuest (NZ) Ltd
+				P.O.Box 15169
+				Hamilton  Waikato  3243
+				NZ
+
+00-12-07   (hex)		Head Strong International Limited
+001207     (base 16)		Head Strong International Limited
+				Unit 9, 20/F, Metropole Square,
+				  Guangdong  
+				HK
+
+00-12-09   (hex)		Fastrax Ltd
+001209     (base 16)		Fastrax Ltd
+				Valimotie 7
+				Vantaa  FI  01510
+				FI
+
+00-12-0B   (hex)		Chinasys Technologies Limited
+00120B     (base 16)		Chinasys Technologies Limited
+				10/F,CAGW Building,No.30 Haidian South Road
+				Beijing    100080
+				CN
+
+00-12-05   (hex)		Terrasat Communications, Inc.
+001205     (base 16)		Terrasat Communications, Inc.
+				235 Vineyard Court, suite 100
+				Morgan Hill  California  95037
+				US
+
+00-12-38   (hex)		SetaBox Technology Co., Ltd.
+001238     (base 16)		SetaBox Technology Co., Ltd.
+				9F-1, No. 293-3, Sec2, Fu-Hsing S. Rd.
+				Taipei    106
+				TW
+
+00-12-3C   (hex)		Second Rule LLC
+00123C     (base 16)		Second Rule LLC
+				4119 Walnut Street
+				Philadelphia  PA  19104
+				US
+
+00-12-3E   (hex)		ERUNE technology Co., Ltd.
+00123E     (base 16)		ERUNE technology Co., Ltd.
+				No. 429, Chin-San 2nd street,
+				Tao Yuan    326
+				TW
+
+00-12-54   (hex)		Spectra Technologies Holdings Company Ltd
+001254     (base 16)		Spectra Technologies Holdings Company Ltd
+				Unit 1301-09, Tower II
+				    852
+				HK
+
+00-12-4F   (hex)		nVent
+00124F     (base 16)		nVent
+				1665 Utica Avenue, Suite 700
+				St Louis Park  MN  55416
+				US
+
+00-12-21   (hex)		B.Braun Melsungen AG
+001221     (base 16)		B.Braun Melsungen AG
+				Schwarzenberger Weg 73-79
+				Melsungen  Hessen  34212
+				DE
+
+00-12-12   (hex)		PLUS  Corporation
+001212     (base 16)		PLUS  Corporation
+				1033-1, Oshitate
+				Inagi-shi  Tokyo  206-0811
+				JP
+
+00-12-13   (hex)		Metrohm AG
+001213     (base 16)		Metrohm AG
+				Oberdorfstrasse 68
+				Herisau  AR  9101
+				CH
+
+00-12-18   (hex)		ARUZE Corporation
+001218     (base 16)		ARUZE Corporation
+				Ariake Frontier Building A
+				Kohtoh-ku  Tokyo  135-0063
+				JP
+
+00-12-49   (hex)		Delta Elettronica S.p.A.
+001249     (base 16)		Delta Elettronica S.p.A.
+				Via Astico 41
+				Varese    21100
+				IT
+
+00-12-4D   (hex)		Inducon BV
+00124D     (base 16)		Inducon BV
+				Kerklaan 26
+				Leimuiden  ZH  2541 CG
+				NL
+
+00-12-66   (hex)		Swisscom Hospitality Services SA
+001266     (base 16)		Swisscom Hospitality Services SA
+				Chemin de l'Etang 65
+				1211  Geneva  
+				CH
+
+00-12-5E   (hex)		CAEN
+00125E     (base 16)		CAEN
+				via Vetraia, 11
+				Viareggio  LUCCA  55049
+				IT
+
+00-12-5D   (hex)		CyberNet Inc.
+00125D     (base 16)		CyberNet Inc.
+				#205, Lotte Suntech City, 513-15
+				Sungnam  Kyunggi  462-806
+				KR
+
+00-12-23   (hex)		Pixim
+001223     (base 16)		Pixim
+				915 Linda Vista Ave.
+				Mountain View  CA  94043
+				US
+
+00-12-3A   (hex)		Posystech Inc., Co.
+00123A     (base 16)		Posystech Inc., Co.
+				Room 407, Daeryung Techno Town 6,
+				Seoul    153-771
+				KR
+
+00-12-34   (hex)		Camille Bauer
+001234     (base 16)		Camille Bauer
+				Aargauerstr. 7
+				Wohlen  AG  5610
+				CH
+
+00-11-E3   (hex)		Thomson, Inc.
+0011E3     (base 16)		Thomson, Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290
+				US
+
+00-11-DC   (hex)		Glunz & Jensen
+0011DC     (base 16)		Glunz & Jensen
+				Selandia Park 1
+				Ringsted    4100
+				DK
+
+00-11-96   (hex)		Actuality Systems, Inc.
+001196     (base 16)		Actuality Systems, Inc.
+				25 Corporate Drive
+				Burlington  MA  01803
+				US
+
+00-11-87   (hex)		Category Solutions, Inc
+001187     (base 16)		Category Solutions, Inc
+				1021 W. Adams St
+				Chicago  IL  60607
+				US
+
+00-11-90   (hex)		Digital Design Corporation
+001190     (base 16)		Digital Design Corporation
+				3820 Ventura Drive
+				Arlington Heights  IL  60004
+				US
+
+00-11-C4   (hex)		Terminales de Telecomunicacion Terrestre, S.L.
+0011C4     (base 16)		Terminales de Telecomunicacion Terrestre, S.L.
+				Poligono Europolis, Calle C 26
+				Las Rozas  Madrid  28230
+				ES
+
+00-11-CB   (hex)		Jacobsons AB
+0011CB     (base 16)		Jacobsons AB
+				Nedralid s 32
+				Motala    591 97
+				SE
+
+00-11-F7   (hex)		Shenzhen Forward Industry Co., Ltd
+0011F7     (base 16)		Shenzhen Forward Industry Co., Ltd
+				4b1 F5.8, Tian An Cyber Park, Chengongmiao,
+				Shenzhen  Guangdong  518040
+				CN
+
+00-11-D3   (hex)		NextGenTel Holding ASA
+0011D3     (base 16)		NextGenTel Holding ASA
+				Sandslimarka 31
+				Bergen  Hordaland  5861
+				NO
+
+00-11-AB   (hex)		TRUSTABLE TECHNOLOGY CO.,LTD.
+0011AB     (base 16)		TRUSTABLE TECHNOLOGY CO.,LTD.
+				12FL.-1,NO.167,Fu-Shing N.Rd.,Sung-Shan area
+				Taipei    105
+				TW
+
+00-11-A5   (hex)		Fortuna Electronic Corp.
+0011A5     (base 16)		Fortuna Electronic Corp.
+				3F, No.9, Sec.1, ChangAn East Rd.,
+				Taipei    104
+				TW
+
+00-11-3C   (hex)		Micronas GmbH
+00113C     (base 16)		Micronas GmbH
+				Hans-Bunte-Strasse 19
+				Freiburg    D-79108
+				DE
+
+00-11-31   (hex)		UNATECH. CO.,LTD
+001131     (base 16)		UNATECH. CO.,LTD
+				A-727 ,GEOPYUNG TOWN,203-1
+				KANGNAM-GU  SEOUL  135-010
+				US
+
+00-11-27   (hex)		TASI, Inc
+001127     (base 16)		TASI, Inc
+				5551 Dry Fork Road
+				Cleves  OH  45002
+				US
+
+00-11-2A   (hex)		Niko NV
+00112A     (base 16)		Niko NV
+				Industriepark West 40
+				Sint-Niklaas  O/V  9100
+				BE
+
+00-11-2B   (hex)		NetModule AG
+00112B     (base 16)		NetModule AG
+				Meriedweg 11
+				Niederwangen  CH  3172
+				CH
+
+00-11-6F   (hex)		Netforyou Co., LTD.
+00116F     (base 16)		Netforyou Co., LTD.
+				1121-4 3F,  Kwanyang-dong, Dongan-gu
+				Anyang-si  Kyunggi-do  431-804
+				KR
+
+00-11-71   (hex)		DEXTER Communications, Inc.
+001171     (base 16)		DEXTER Communications, Inc.
+				2F Shinsung B/D 404-1
+				Sungnam  Gyunggi  463-420
+				KR
+
+00-11-67   (hex)		Integrated System Solution Corp.
+001167     (base 16)		Integrated System Solution Corp.
+				3F, No. 2-1, industry East Rd., I
+				Hsinchu    300
+				TW
+
+00-11-6D   (hex)		American Time and Signal
+00116D     (base 16)		American Time and Signal
+				140 Third St. South
+				Dassel  MN  55325
+				US
+
+00-11-60   (hex)		ARTDIO Company Co., LTD
+001160     (base 16)		ARTDIO Company Co., LTD
+				7th FL.., No.476, Min-Hu RD., Hsin-Chu,
+				Hsinchu    300
+				TW
+
+00-11-54   (hex)		Webpro Technologies Inc.
+001154     (base 16)		Webpro Technologies Inc.
+				2F-1, No.81, Sec. 4, Chungching N. Rd.,
+				Taipei    111
+				TW
+
+00-11-45   (hex)		ValuePoint Networks
+001145     (base 16)		ValuePoint Networks
+				350 Townsend St Ste 320
+				San Francisco,  CA  94107
+				US
+
+00-11-51   (hex)		Mykotronx
+001151     (base 16)		Mykotronx
+				359 Van Ness Way
+				Torrance  CA  90501
+				US
+
+00-11-4E   (hex)		690885 Ontario Inc.
+00114E     (base 16)		690885 Ontario Inc.
+				205 Annagem Blvd.
+				Mississauga  Ontario  L5T 2V1
+				CA
+
+00-11-2D   (hex)		iPulse Systems
+00112D     (base 16)		iPulse Systems
+				Unit 3, Riverside Industrial Park
+				Gauteng  Johannesburg  1618
+				ZA
+
+00-11-7B   (hex)		Büchi  Labortechnik AG
+00117B     (base 16)		Büchi  Labortechnik AG
+				Meierseggstrasse 40
+				Flawil  9230  SG
+				CH
+
+00-0F-EE   (hex)		XTec, Incorporated
+000FEE     (base 16)		XTec, Incorporated
+				5775 Blue Lagoon Drive
+				Miami  Florida  33126
+				US
+
+00-0F-E4   (hex)		Pantech Co.,Ltd
+000FE4     (base 16)		Pantech Co.,Ltd
+				Shinsong B/D 3F, 25-12,
+				Youngdeungpo-GU  Seoul  150-711
+				KR
+
+00-0F-E7   (hex)		Lutron Electronics Co., Inc.
+000FE7     (base 16)		Lutron Electronics Co., Inc.
+				7200 Suter Rd.
+				Coopersburg  PA  18036-1299
+				US
+
+00-0F-E6   (hex)		MBTech Systems, Inc.
+000FE6     (base 16)		MBTech Systems, Inc.
+				412 1st Ave SE
+				Cullman  Alabama  35055
+				US
+
+00-0F-DA   (hex)		YAZAKI CORPORATION
+000FDA     (base 16)		YAZAKI CORPORATION
+				1500 MISHUKU
+				SUSONO-CITY  SHIZUOKA-PREF  410-1194
+				JP
+
+00-0F-EF   (hex)		Thales e-Transactions GmbH
+000FEF     (base 16)		Thales e-Transactions GmbH
+				Konrad-Zuse-Straße 19-21
+				Bad Hersfeld  Hessen  36251
+				DE
+
+00-0F-E9   (hex)		GW TECHNOLOGIES CO.,LTD.
+000FE9     (base 16)		GW TECHNOLOGIES CO.,LTD.
+				No.38 Shangdi Xilu,Haidian District
+				Beijing    100085
+				CN
+
+00-0F-E1   (hex)		ID DIGITAL CORPORATION
+000FE1     (base 16)		ID DIGITAL CORPORATION
+				6th Fl., Mirae Bldg., 271-1, Seohyun-dong, Bundang-ku, Sungnam-si, Keongki-do, South Korea
+				Sungnam-Si  Keongki-do  463-050
+				KR
+
+00-0F-DF   (hex)		SOLOMON Technology Corp.
+000FDF     (base 16)		SOLOMON Technology Corp.
+				No.42,Sing Zhong Rd.,Nei Hu Dist.,
+				Taipei    114
+				TW
+
+00-0F-FE   (hex)		G-PRO COMPUTER
+000FFE     (base 16)		G-PRO COMPUTER
+				first arrange C YingHu industrial estate QingXi country DongGuan city
+				DongGuan  GuangDong  523648
+				CN
+
+00-11-0B   (hex)		Franklin Technology Systems
+00110B     (base 16)		Franklin Technology Systems
+				20406 Earl St
+				Torrance  CA  90503
+				US
+
+00-11-05   (hex)		Sunplus Technology Co., Ltd.
+001105     (base 16)		Sunplus Technology Co., Ltd.
+				19, Innovation First Road, Hsinchu Science Park
+				Hsinchu    300
+				TW
+
+00-11-02   (hex)		Aurora Multimedia Corp.
+001102     (base 16)		Aurora Multimedia Corp.
+				205 Commercial Court
+				Morganville  New Jersey  07751-1070
+				US
+
+00-11-23   (hex)		Appointech, Inc.
+001123     (base 16)		Appointech, Inc.
+				6F-2 No.192 Tung-Kuan Rd.
+				Hsinchu    300
+				TW
+
+00-11-0F   (hex)		netplat,Inc.
+00110F     (base 16)		netplat,Inc.
+				2F Olympia Center, 828-10, Yeoksam-dong, Gangnam-gu
+				SEOUL    135-935
+				KR
+
+00-0F-D6   (hex)		Sarotech Co., Ltd
+000FD6     (base 16)		Sarotech Co., Ltd
+				HanGang Bldg, 1549-7, Seocho-Dong,
+				Seoul    137-070
+				KR
+
+00-11-15   (hex)		EPIN Technologies, Inc.
+001115     (base 16)		EPIN Technologies, Inc.
+				Acorn Campus
+				Cupertino  CA  95014
+				US
+
+00-0F-C7   (hex)		Dionica R&D Ltd.
+000FC7     (base 16)		Dionica R&D Ltd.
+				Bologna Centre, F11
+				Mosta    MST13
+				MT
+
+00-0F-64   (hex)		D&R Electronica Weesp BV
+000F64     (base 16)		D&R Electronica Weesp BV
+				Rijnkade 15B
+				WEESP  NH  1382GS
+				NL
+
+00-0F-75   (hex)		First Silicon Solutions
+000F75     (base 16)		First Silicon Solutions
+				13939 Forest Lane
+				Larkspur  CO  80118
+				US
+
+00-0F-7C   (hex)		ACTi Corporation
+000F7C     (base 16)		ACTi Corporation
+				7F., No. 1, Alley 20, Lane 407, Sec. 2, Tiding Blvd.,
+				Taipei    114
+				TW
+
+00-0F-7A   (hex)		BeiJing NuQX Technology CO.,LTD
+000F7A     (base 16)		BeiJing NuQX Technology CO.,LTD
+				Room 812,8F Tower B,YinWang Center, No.113,Zhi Chun Road,
+				Beijing    100086
+				CN
+
+00-0F-AD   (hex)		FMN communications GmbH
+000FAD     (base 16)		FMN communications GmbH
+				Grimmelallee 4
+				Nordhausen  Thüringen  99734
+				DE
+
+00-0F-AB   (hex)		Kyushu Electronics Systems Inc.
+000FAB     (base 16)		Kyushu Electronics Systems Inc.
+				3-3, Kongo 2-Chome, Yahatanishi Ward
+				Kitakyushu City  Fukuoka Pref.  807-1263
+				JP
+
+00-0F-AC   (hex)		IEEE 802.11
+000FAC     (base 16)		IEEE 802.11
+				4125 Highlander Parkway
+				Richfield  Ohio  44286
+				US
+
+00-0F-72   (hex)		Sandburst
+000F72     (base 16)		Sandburst
+				600 Federal St
+				Andover  MA  01810
+				US
+
+00-0F-B3   (hex)		Actiontec Electronics, Inc
+000FB3     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-0F-9C   (hex)		Panduit Corp
+000F9C     (base 16)		Panduit Corp
+				17301 Ridgeland Ave
+				Tinley Park  Illinois  60477
+				US
+
+00-0F-C8   (hex)		Chantry Networks
+000FC8     (base 16)		Chantry Networks
+				1900 Minnesota Court
+				Mississauga  Ontario  L5N 3C9
+				CA
+
+00-0F-BB   (hex)		Nokia Siemens Networks GmbH & Co. KG.
+000FBB     (base 16)		Nokia Siemens Networks GmbH & Co. KG.
+				Werner-von-Siemens Straße 2-6
+				Bruchsal  Baden-Württemberg  76646
+				DE
+
+00-0F-BC   (hex)		Onkey Technologies, Inc.
+000FBC     (base 16)		Onkey Technologies, Inc.
+				780 Montague Expressway, Inc.
+				San Jose  CA  95131
+				US
+
+00-0F-B6   (hex)		Europlex Technologies
+000FB6     (base 16)		Europlex Technologies
+				Clonshaugh Business & Tech. Park
+				Clonshaugh    Dublin 17
+				IE
+
+00-0F-B9   (hex)		Adaptive Instruments
+000FB9     (base 16)		Adaptive Instruments
+				577 Main Street
+				Hudson  MA  01749
+				US
+
+00-0F-98   (hex)		Avamax Co. Ltd.
+000F98     (base 16)		Avamax Co. Ltd.
+				B1, No. 51, Section 2, ChongQing S. Rd.
+				Taipei    
+				TW
+
+00-0F-97   (hex)		Avanex Corporation
+000F97     (base 16)		Avanex Corporation
+				40919 Encyclopedia Circle
+				Fremont  CA  94538
+				US
+
+00-0F-96   (hex)		Telco Systems, Inc. 
+000F96     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield  MA  02048
+				US
+
+00-0F-8B   (hex)		Orion MultiSystems Inc
+000F8B     (base 16)		Orion MultiSystems Inc
+				3375 Scott Blvd Suite 338
+				Santa Clara  CA  95054
+				US
+
+00-0F-8C   (hex)		Gigawavetech Pte Ltd
+000F8C     (base 16)		Gigawavetech Pte Ltd
+				1 Jalan Kilang Timor
+				    159303
+				SG
+
+00-0F-38   (hex)		Netstar
+000F38     (base 16)		Netstar
+				3F,No.347, Yang-kuang St.,Nei-Hu Dis.,
+				Taipei    114
+				TW
+
+00-0F-3A   (hex)		HISHARP
+000F3A     (base 16)		HISHARP
+				NO.673,CHANG HSING ROAD PATE CITY,TAOYUAN,
+				TAIPEI    334
+				TW
+
+00-0F-30   (hex)		Raza Microelectronics Inc
+000F30     (base 16)		Raza Microelectronics Inc
+				3080 North First Street
+				San Jose  CA  95134
+				US
+
+00-0F-53   (hex)		Solarflare Communications Inc.
+000F53     (base 16)		Solarflare Communications Inc.
+				Suite 100, 7505 Irvine Center Drive
+				Irvine  CA  92618
+				US
+
+00-0F-51   (hex)		Azul Systems, Inc.
+000F51     (base 16)		Azul Systems, Inc.
+				1600 Plymouth Street
+				Mountain View  California  94043
+				US
+
+00-0F-07   (hex)		Mangrove Systems, Inc.
+000F07     (base 16)		Mangrove Systems, Inc.
+				10 Fairfield Blvd.
+				Wallingford  CT  06492
+				US
+
+00-0F-00   (hex)		Legra Systems, Inc.
+000F00     (base 16)		Legra Systems, Inc.
+				3 Burlington Woods Drive
+				Burlington  MA  01803
+				US
+
+00-0F-01   (hex)		DIGITALKS INC
+000F01     (base 16)		DIGITALKS INC
+				14 MARSHALL LANE
+				WESTON  CT  06883
+				US
+
+00-0F-03   (hex)		COM&C CO., LTD
+000F03     (base 16)		COM&C CO., LTD
+				2F Woojin BLD 1445-2 Secho-Dong
+				SEOUL    137-070
+				KR
+
+00-0F-34   (hex)		Cisco Systems, Inc
+000F34     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-2E   (hex)		Megapower International Corp.
+000F2E     (base 16)		Megapower International Corp.
+				Rm. 403, No 24 , Wu-Chuan 2nd Rd.,
+				Taipei Hsien    242
+				TW
+
+00-0F-26   (hex)		WorldAccxx  LLC
+000F26     (base 16)		WorldAccxx  LLC
+				4035 Tampa Rd.
+				Oldsmar  FL  34667
+				US
+
+00-0F-45   (hex)		Stretch, Inc.
+000F45     (base 16)		Stretch, Inc.
+				1322 Orleans Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0F-3B   (hex)		Fuji System Machines Co., Ltd.
+000F3B     (base 16)		Fuji System Machines Co., Ltd.
+				5-8-10
+				Zama-Shi  Kanagawa-Ken  228-0003
+				JP
+
+00-0F-37   (hex)		Xambala Incorporated
+000F37     (base 16)		Xambala Incorporated
+				2674 N. 1st Street
+				San Jose  CA  95134
+				US
+
+00-0F-54   (hex)		Entrelogic Corporation
+000F54     (base 16)		Entrelogic Corporation
+				33 Boston Post Rd. West.
+				Marlborough  MA  01752
+				US
+
+00-0F-25   (hex)		AimValley B.V.
+000F25     (base 16)		AimValley B.V.
+				Utrechtseweg 38,
+				Hilversum  NH  1223 TV
+				NL
+
+00-0F-19   (hex)		Boston Scientific
+000F19     (base 16)		Boston Scientific
+				4100 Hamline Ave N.
+				St. Paul  MN  55112
+				US
+
+00-0F-10   (hex)		RDM Corporation
+000F10     (base 16)		RDM Corporation
+				608 Weber St. N
+				Waterloo  ON  N2V 1K4
+				CA
+
+00-0E-A8   (hex)		United Technologists Europe Limited
+000EA8     (base 16)		United Technologists Europe Limited
+				UTEL Laboratories, Wolves Farm Lane
+				Hadleigh  Suffolk  IP7 6BH
+				GB
+
+00-0E-AA   (hex)		Scalent Systems, Inc.
+000EAA     (base 16)		Scalent Systems, Inc.
+				490 S. California Ave
+				Palo Alto  CA  94306
+				US
+
+00-0E-AC   (hex)		MINTRON ENTERPRISE CO., LTD.
+000EAC     (base 16)		MINTRON ENTERPRISE CO., LTD.
+				NO.3,Wu-Kung 5Rd., Wu-Ku Ind Park
+				Taipei County    248
+				TW
+
+00-0E-AE   (hex)		GAWELL TECHNOLOGIES CORP.
+000EAE     (base 16)		GAWELL TECHNOLOGIES CORP.
+				2F,NO.102,SEC.3,JUNG SHAN RD,
+				JUNG HO CITY,  TAIPEI HSIEN  235
+				TW
+
+00-0E-BA   (hex)		HANMI SEMICONDUCTOR CO., LTD.
+000EBA     (base 16)		HANMI SEMICONDUCTOR CO., LTD.
+				#532-2, Gajwa-Dong, Seo-Ku,
+				Incheon,    404 250
+				KR
+
+00-0E-BC   (hex)		Paragon Fidelity GmbH
+000EBC     (base 16)		Paragon Fidelity GmbH
+				Schwadermühlstraße
+				Cadolzburg    90556
+				DE
+
+00-0E-C5   (hex)		Digital Multitools Inc
+000EC5     (base 16)		Digital Multitools Inc
+				9005 Leslie Street  Unit 205
+				Richmond Hill  Ontario  L4B 1G7
+				CA
+
+00-0E-C7   (hex)		Motorola Korea
+000EC7     (base 16)		Motorola Korea
+				Hibrand B/D 17F SW Team Motorola Korea
+				Yangjaedong  Seocho  
+				KR
+
+00-0E-8B   (hex)		Astarte Technology Co, Ltd.
+000E8B     (base 16)		Astarte Technology Co, Ltd.
+				11F, No. 166 Dah-Yeh Rd.
+				Peitou, Taipei    
+				TW
+
+00-0E-DF   (hex)		PLX Technology
+000EDF     (base 16)		PLX Technology
+				870 Maude Ave.,
+				Sunnyvale  CA  94085
+				US
+
+00-0E-E1   (hex)		ExtremeSpeed Inc.
+000EE1     (base 16)		ExtremeSpeed Inc.
+				PO Box 600
+				Mannville  Alberta  T0B 2W0
+				CA
+
+00-0E-D7   (hex)		Cisco Systems, Inc
+000ED7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-D3   (hex)		Epicenter, Inc.
+000ED3     (base 16)		Epicenter, Inc.
+				211 B Calle Pintoresco
+				San Clemente  CA  92672
+				US
+
+00-0E-9D   (hex)		Tiscali UK Ltd
+000E9D     (base 16)		Tiscali UK Ltd
+				20 Broadwick Street
+				London    W1F 8HT
+				GB
+
+00-0E-47   (hex)		NCI System Co.,Ltd.
+000E47     (base 16)		NCI System Co.,Ltd.
+				#206, Kayang Techno-Town, 1487, Kayang 3 dong, Kangseo-Ku, Seoul, Korea
+				Seoul    157-810
+				KR
+
+00-0E-46   (hex)		Niigata Seimitsu Co.,Ltd.
+000E46     (base 16)		Niigata Seimitsu Co.,Ltd.
+				3335-2, Shimonaka, Sanwa-mura
+				Nakakubiki-gun  Niigata  943-0222
+				JP
+
+00-0E-1F   (hex)		TCL Networks Equipment Co., Ltd.
+000E1F     (base 16)		TCL Networks Equipment Co., Ltd.
+				No.5 Industrial Road,Shekou
+				ShenZhen  GuangDong  518067
+				CN
+
+00-0E-26   (hex)		Gincom Technology Corp.
+000E26     (base 16)		Gincom Technology Corp.
+				15F., No. 284, Sec.3, Sanmin Rd., Taoyuan City,
+				Taoyuan,    330
+				TW
+
+00-0E-6C   (hex)		Device Drivers Limited
+000E6C     (base 16)		Device Drivers Limited
+				1-5-1-103
+				Fuchu-shi  Tokyo  1830005
+				JP
+
+00-0E-6B   (hex)		Janitza electronics GmbH
+000E6B     (base 16)		Janitza electronics GmbH
+				Vor dem Polstück  1
+				Lahnau  Hessen  35633
+				DE
+
+00-0E-5F   (hex)		activ-net GmbH & Co. KG
+000E5F     (base 16)		activ-net GmbH & Co. KG
+				Konrad-Zuse-Str. 4
+				Bochum    44801
+				DE
+
+00-0E-57   (hex)		Iworld Networking, Inc.
+000E57     (base 16)		Iworld Networking, Inc.
+				125 Hanju Bldg, Nonhyun-Dong
+				Seoul    135010
+				KR
+
+00-0E-51   (hex)		tecna elettronica srl
+000E51     (base 16)		tecna elettronica srl
+				via miglioli 30
+				castel san pietro terme  bologna  40024
+				IT
+
+00-0E-67   (hex)		Eltis Microelectronics Ltd.
+000E67     (base 16)		Eltis Microelectronics Ltd.
+				Unit 902B, 9/F., Sunbeam Centre
+				Kwun Tong  Kowloon  
+				HK
+
+00-0E-65   (hex)		TransCore
+000E65     (base 16)		TransCore
+				8600 Jefferson St NE
+				Albuquerque  NM  87113
+				US
+
+00-0E-43   (hex)		G-Tek Electronics Sdn. Bhd.
+000E43     (base 16)		G-Tek Electronics Sdn. Bhd.
+				2493 Mukim 1, Lorong Perusahaan Lapan
+				Perai  Penang  13600
+				MY
+
+00-0E-44   (hex)		Digital 5, Inc.
+000E44     (base 16)		Digital 5, Inc.
+				101 Grovers Mill Rd.
+				Lawrenceville  NJ  08648
+				US
+
+00-0E-74   (hex)		Solar Telecom. Tech
+000E74     (base 16)		Solar Telecom. Tech
+				B B/D, 4F, Samho Venture Tower
+				Seoul    137-941
+				KR
+
+00-0E-7A   (hex)		GemWon Communications Co., Ltd.
+000E7A     (base 16)		GemWon Communications Co., Ltd.
+				3FL.,NO.32,Lane 135,Shianjeng 9th Rd.,Jubei City
+				Hsinchu    302
+				TW
+
+00-0E-80   (hex)		Thomson Technology Inc
+000E80     (base 16)		Thomson Technology Inc
+				9087A 198th ST
+				Surrey  BC  V1M-3B1
+				CA
+
+00-0E-85   (hex)		Catalyst Enterprises, Inc.
+000E85     (base 16)		Catalyst Enterprises, Inc.
+				3385 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-0E-32   (hex)		Kontron Medical
+000E32     (base 16)		Kontron Medical
+				Reinacherstrasse 131
+				Basel    4002
+				CH
+
+00-0E-0B   (hex)		Netac Technology Co., Ltd.
+000E0B     (base 16)		Netac Technology Co., Ltd.
+				6F, Incubator Building, China Academy of Science &Tech Development,
+				ShenZhen  GuangDong  518057
+				CN
+
+00-0E-11   (hex)		BDT Büro und Datentechnik GmbH & Co.KG 
+000E11     (base 16)		BDT Büro und Datentechnik GmbH & Co.KG 
+				Saline 29
+				Rottweil  Baden-Württemberg  D-78628
+				DE
+
+00-0D-F5   (hex)		Teletronics International Inc.
+000DF5     (base 16)		Teletronics International Inc.
+				2 Choke Cherry Road
+				Rockville  MD  20850
+				US
+
+00-0D-F7   (hex)		Space Dynamics Lab
+000DF7     (base 16)		Space Dynamics Lab
+				1695 N. Research Park Way
+				North Logan  UT  84341
+				US
+
+00-0D-EB   (hex)		CompXs Limited
+000DEB     (base 16)		CompXs Limited
+				Robert Denholm House
+				Redhill  Surrey  RH1 4HW
+				GB
+
+00-0D-EE   (hex)		Andrew RF Power Amplifier Group
+000DEE     (base 16)		Andrew RF Power Amplifier Group
+				40 Technology Drive
+				Warren  NJ  07059
+				US
+
+00-0D-EF   (hex)		Soc. Coop. Bilanciai
+000DEF     (base 16)		Soc. Coop. Bilanciai
+				via S.Ferrari 16
+				Campogalliano  Modena  41011
+				IT
+
+00-0D-E7   (hex)		Snap-on OEM Group
+000DE7     (base 16)		Snap-on OEM Group
+				2333 East Walton Blvd.
+				Auburn Hills  MI  48326
+				US
+
+00-0D-C6   (hex)		DigiRose Technology Co., Ltd.
+000DC6     (base 16)		DigiRose Technology Co., Ltd.
+				No. 1, Alley 20, Lane 26 Rueiguang Road,
+				Taipei    114
+				TW
+
+00-0D-C1   (hex)		SafeWeb Inc
+000DC1     (base 16)		SafeWeb Inc
+				2200 Powell St. Ste 590
+				Emeryville  CA  94608
+				US
+
+00-0D-F0   (hex)		QCOM TECHNOLOGY INC.
+000DF0     (base 16)		QCOM TECHNOLOGY INC.
+				4F., No.301, Sec. 2, Tiding Blvd.
+				Taipei City  Neihu District  114
+				TW
+
+00-0D-E5   (hex)		Samsung Thales
+000DE5     (base 16)		Samsung Thales
+				259 Gongdan-Dong
+				Gumi-City  Gyeongsangbuk-do  730-904
+				KR
+
+00-0D-C0   (hex)		Spagat AS
+000DC0     (base 16)		Spagat AS
+				Tonne Hutifeldtpl. 2
+				Halden  Ostfold  1767
+				NO
+
+00-0D-DD   (hex)		Profilo Telra Elektronik Sanayi ve Ticaret. A.Ş
+000DDD     (base 16)		Profilo Telra Elektronik Sanayi ve Ticaret. A.Ş
+				Cemal Sahir Sokak NO:26-28
+				İstanbul  TURKEY  34255
+				TR
+
+00-0D-F8   (hex)		ORGA Kartensysteme GmbH
+000DF8     (base 16)		ORGA Kartensysteme GmbH
+				Konrad-Zuse-Ring 1
+				Flintbek  Schleswig-Holstein  24220
+				DE
+
+00-0E-16   (hex)		SouthWing S.L.
+000E16     (base 16)		SouthWing S.L.
+				C/Avila, 48-50
+				Barcelona    08005
+				ES
+
+00-0D-A7   (hex)		Private
+000DA7     (base 16)		Private
+
+00-0D-AD   (hex)		Dataprobe, Inc.
+000DAD     (base 16)		Dataprobe, Inc.
+				1B Pearl Court
+				Allendale  NJ  07401
+				US
+
+00-0D-A9   (hex)		T.E.A.M. S.L.
+000DA9     (base 16)		T.E.A.M. S.L.
+				Parque Tecnologico Edificio 108
+				ZAMUDIO  Bizkaia  48170
+				ES
+
+00-0D-AB   (hex)		Parker Hannifin GmbH Electromechanical Division Europe
+000DAB     (base 16)		Parker Hannifin GmbH Electromechanical Division Europe
+				Robert-Bosch-Straße 22
+				Offenburg  Baden-Württemberg  77656
+				DE
+
+00-0D-A8   (hex)		Teletronics Technology Corporation
+000DA8     (base 16)		Teletronics Technology Corporation
+				2525 Pearl Buck Road
+				Bristol  Pennsylvania  19007
+				US
+
+00-0D-79   (hex)		Dynamic Solutions Co,.Ltd.
+000D79     (base 16)		Dynamic Solutions Co,.Ltd.
+				17-8 Nihonbashi Hakozaki-cho
+				Chuo-ku  Tokyo  103-0015
+				JP
+
+00-0D-6D   (hex)		K-Tech Devices Corp.
+000D6D     (base 16)		K-Tech Devices Corp.
+				14016-30
+				nakaminowa minowamachi kamiina  nagano  399-4601
+				JP
+
+00-0D-AF   (hex)		Plexus Corp (UK) Ltd
+000DAF     (base 16)		Plexus Corp (UK) Ltd
+				Pinnacle Hill
+				Kelso  Roxburghshire  TD5 8XX
+				GB
+
+00-0D-B1   (hex)		Japan Network Service Co., Ltd.
+000DB1     (base 16)		Japan Network Service Co., Ltd.
+				Matoba Bldg. 6F,
+				 Chuo-ku  Tokyo  104-0042
+				JP
+
+00-0D-83   (hex)		Sanmina-SCI Hungary  Ltd.
+000D83     (base 16)		Sanmina-SCI Hungary  Ltd.
+				Kota Jozsef u. 2.
+				Tatabanya  Komarom-Esztergom  2800
+				HU
+
+00-0D-7F   (hex)		MIDAS  COMMUNICATION TECHNOLOGIES PTE LTD ( Foreign Branch)
+000D7F     (base 16)		MIDAS  COMMUNICATION TECHNOLOGIES PTE LTD ( Foreign Branch)
+				04-12, Phase Z.Ro Technoprenuer Park
+				Singapore    139 347
+				SG
+
+00-0D-75   (hex)		Kobian Pte Ltd - Taiwan Branch
+000D75     (base 16)		Kobian Pte Ltd - Taiwan Branch
+				2F, No.580, Rueikuang Rd.,Nei Hu,Taipei,
+				Taipei  Nei Hu  114
+				TW
+
+00-0D-78   (hex)		Engineering & Security
+000D78     (base 16)		Engineering & Security
+				Martiri della Libertà   32/4
+				Genova    16155
+				IT
+
+00-0D-9E   (hex)		TOKUDEN OHIZUMI SEISAKUSYO Co.,Ltd.
+000D9E     (base 16)		TOKUDEN OHIZUMI SEISAKUSYO Co.,Ltd.
+				Yoshida 1221
+				Ouragun Ohizumi  Gunma  370-0523
+				JP
+
+00-0D-A3   (hex)		Emerging Technologies Limited
+000DA3     (base 16)		Emerging Technologies Limited
+				Wong's Industrial Centre, 180 Wai Yip St
+				  Nil  
+				HK
+
+00-0D-A4   (hex)		DOSCH & AMAND SYSTEMS AG
+000DA4     (base 16)		DOSCH & AMAND SYSTEMS AG
+				Scheinerstrasse 9
+				Munich  Bavaria  81679
+				DE
+
+00-0D-9A   (hex)		INFOTEC LTD
+000D9A     (base 16)		INFOTEC LTD
+				The Maltings
+				Ashby-de-la-Zouch  Leicestershire  LE65 2PS
+				GB
+
+00-0D-6E   (hex)		K-Patents Oy
+000D6E     (base 16)		K-Patents Oy
+				P.O. Box 77
+				VANTAA  FI  01511
+				FI
+
+00-0D-6A   (hex)		Redwood Technologies LTD
+000D6A     (base 16)		Redwood Technologies LTD
+				Amber House
+				Bracknell  Berkshire  RG12 1JB
+				GB
+
+00-0D-BA   (hex)		Océ Document Technologies GmbH
+000DBA     (base 16)		Océ Document Technologies GmbH
+				Max-Stromeyer-Straße  116
+				Konstanz    78467
+				DE
+
+00-0D-BD   (hex)		Cisco Systems, Inc
+000DBD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-B5   (hex)		GLOBALSAT TECHNOLOGY CORPORATION
+000DB5     (base 16)		GLOBALSAT TECHNOLOGY CORPORATION
+				Far East Century Park
+				Taipei Hsien    235
+				TW
+
+00-0D-97   (hex)		ABB Inc./Tropos
+000D97     (base 16)		ABB Inc./Tropos
+				1710 S. Amphlett Blvd,  Suite 304
+				San Mateo  CA  94402
+				US
+
+00-0D-96   (hex)		Vtera Technology Inc.
+000D96     (base 16)		Vtera Technology Inc.
+				No 34, Industrial East. 4th Rd.
+				HsinChu    300
+				TW
+
+00-0D-8B   (hex)		T&D Corporation
+000D8B     (base 16)		T&D Corporation
+				5652-169 Sasaga
+				Matsumoto  Nagano  399-0033
+				JP
+
+00-0D-90   (hex)		Factum Electronics AB
+000D90     (base 16)		Factum Electronics AB
+				Teknikringen 1H
+				Linköping  Östergötland  583 30
+				SE
+
+00-0D-85   (hex)		Tapwave, Inc.
+000D85     (base 16)		Tapwave, Inc.
+				1901 Landings Drive
+				Mountain View  CA  94043
+				US
+
+00-0D-82   (hex)		PHSNET
+000D82     (base 16)		PHSNET
+				Piazza Mariano Rumor, 18
+				Arcugnano  Vicenza  36057
+				IT
+
+00-0D-23   (hex)		Smart Solution, Inc
+000D23     (base 16)		Smart Solution, Inc
+				465 West Lawndale #B
+				Salt Lake City  UT  84115
+				US
+
+00-0D-27   (hex)		MICROPLEX Printware AG
+000D27     (base 16)		MICROPLEX Printware AG
+				Panzerstraße 5
+				Varel  Niedersachsen  26316
+				DE
+
+00-0D-1B   (hex)		Kyoto Electronics Manufacturing Co., Ltd.
+000D1B     (base 16)		Kyoto Electronics Manufacturing Co., Ltd.
+				56-2, Ninodan-cho, Shinden,
+				Kyoto-City  Kyoto Prefecture  601-8317
+				JP
+
+00-0D-1D   (hex)		HIGH-TEK HARNESS ENT. CO., LTD.
+000D1D     (base 16)		HIGH-TEK HARNESS ENT. CO., LTD.
+				4F-6, No18, Pu-Ting Rd. Hsinchu, Taiwan
+				Hsinchu    300
+				TW
+
+00-0D-02   (hex)		NEC Platforms, Ltd.
+000D02     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+00-0D-07   (hex)		Calrec Audio Ltd
+000D07     (base 16)		Calrec Audio Ltd
+				Nutclough Mill
+				Hebden Bridge  West Yorkshire  HX7 8EZ
+				GB
+
+00-0D-40   (hex)		Verint Loronix Video Solutions
+000D40     (base 16)		Verint Loronix Video Solutions
+				12526 High Bluff Dr. #170
+				San DIego  CA  92130
+				US
+
+00-0D-21   (hex)		WISCORE Inc.
+000D21     (base 16)		WISCORE Inc.
+				6F, No. 180, Sec. 2, Duenhua S. Rd,
+				Taipei    106
+				TW
+
+00-0D-09   (hex)		Yuehua(Zhuhai) Electronic CO. LTD
+000D09     (base 16)		Yuehua(Zhuhai) Electronic CO. LTD
+				4Rd Pingdong,Nanping Science & Technolog
+				Zhuhai  Guangdong  519070
+				CN
+
+00-0D-37   (hex)		WIPLUG
+000D37     (base 16)		WIPLUG
+				RUA  DR. AGOSTINHO GOULAO
+				PETROPOLIS  RIO JANEIRO  25730050
+				BR
+
+00-0D-33   (hex)		Prediwave Corp.
+000D33     (base 16)		Prediwave Corp.
+				48431 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-0D-2F   (hex)		AIN Comm.Tech.Co., LTD
+000D2F     (base 16)		AIN Comm.Tech.Co., LTD
+				4F, No.76, Sec2 Mintzu Rd
+				Jung-Li City    320
+				TW
+
+00-0D-5D   (hex)		Raritan Computer, Inc
+000D5D     (base 16)		Raritan Computer, Inc
+				400 Cottontail Lane
+				Somerset  NJ  08873
+				US
+
+00-0D-63   (hex)		DENT Instruments, Inc.
+000D63     (base 16)		DENT Instruments, Inc.
+				64 NW Franklin Ave
+				Bend  OR  97701
+				US
+
+00-0D-66   (hex)		Cisco Systems, Inc
+000D66     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-CD   (hex)		IEC - TC57
+000CCD     (base 16)		IEC - TC57
+				3, rue de Varembé
+				Geneva  GE  1211
+				CH
+
+00-0C-CB   (hex)		Design Combus Ltd
+000CCB     (base 16)		Design Combus Ltd
+				Hatanapaan valtatie 34A
+				Tampere    FIN-33100
+				FI
+
+00-0C-C9   (hex)		ILWOO DATA & TECHNOLOGY CO.,LTD
+000CC9     (base 16)		ILWOO DATA & TECHNOLOGY CO.,LTD
+				1475-10,HWA HYUN BLD. 2nd Floor,
+				SEOUL    137-071
+				KR
+
+00-0C-E9   (hex)		BLOOMBERG L.P.
+000CE9     (base 16)		BLOOMBERG L.P.
+				731 Lexington Ave
+				NEW YORK  NEW YORK  10022
+				US
+
+00-0C-EA   (hex)		aphona Kommunikationssysteme
+000CEA     (base 16)		aphona Kommunikationssysteme
+				Entwicklungs- und VertriebsgmbH
+				Wien    1230
+				AT
+
+00-0C-DA   (hex)		FreeHand Systems, Inc.
+000CDA     (base 16)		FreeHand Systems, Inc.
+				95 First St.
+				Los Altos  CA  94022
+				US
+
+00-0C-F5   (hex)		InfoExpress
+000CF5     (base 16)		InfoExpress
+				170 S. Whisman Road, Suite B
+				Mountain View  CA  94041
+				US
+
+00-0C-EE   (hex)		jp-embedded
+000CEE     (base 16)		jp-embedded
+				Buen 21, Nr. Dalby
+				Borup    4140
+				DK
+
+00-0C-AF   (hex)		TRI TERM CO.,LTD.
+000CAF     (base 16)		TRI TERM CO.,LTD.
+				21-5 HIRAIDE KOUGIYO DANCHI
+				TOCHIGI    321-0905
+				JP
+
+00-0C-B3   (hex)		ROUND Co.,Ltd.
+000CB3     (base 16)		ROUND Co.,Ltd.
+				3-9 Gokashou-Shibahigashi
+				uji  kyoto  611-0011
+				JP
+
+00-0C-DD   (hex)		AOS technologies AG
+000CDD     (base 16)		AOS technologies AG
+				Taefernstrasse 20
+				Baden - Daettwil  AG  CH-5405
+				CH
+
+00-0C-A5   (hex)		Naman NZ LTd
+000CA5     (base 16)		Naman NZ LTd
+				13/17 Kawana St
+				Auckland    
+				NZ
+
+00-0C-A9   (hex)		Ebtron Inc.
+000CA9     (base 16)		Ebtron Inc.
+				1663 Hwy 701 South
+				Loris  SC  29569
+				US
+
+00-0C-FB   (hex)		Korea Network Systems
+000CFB     (base 16)		Korea Network Systems
+				206  JangYoungSil Bldg, 1688-5
+				Taejeon    306-230
+				KR
+
+00-0C-7A   (hex)		DaTARIUS Technologies GmbH
+000C7A     (base 16)		DaTARIUS Technologies GmbH
+				Anton Maria Schyrle Str. 7
+				Reutte  Tirol  6600
+				AT
+
+00-0C-79   (hex)		Extel Communications P/L
+000C79     (base 16)		Extel Communications P/L
+				399 Ferntree Gully Road
+				Mt Waverley  Victoria  3149
+				AU
+
+00-0C-75   (hex)		Oriental integrated electronics. LTD
+000C75     (base 16)		Oriental integrated electronics. LTD
+				281-34 Dondang-dong Wonmi-Gu
+				Bucheon    420-808
+				KR
+
+00-0C-5D   (hex)		CHIC TECHNOLOGY (CHINA) CORP.
+000C5D     (base 16)		CHIC TECHNOLOGY (CHINA) CORP.
+				7th Building,Shi'ao Ind.Zone,Longhua Tow
+				Shenzhen  Guangdong  518109
+				CN
+
+00-0C-4F   (hex)		UDTech Japan Corporation
+000C4F     (base 16)		UDTech Japan Corporation
+				Hamacho Hanacho Bldg, 2F
+				Chuo-ku  Tokyo  103-0007
+				JP
+
+00-0C-62   (hex)		ABB AB, Cewe-Control 
+000C62     (base 16)		ABB AB, Cewe-Control 
+				Dept. LPCC/RE 
+				Vasteras    721 61
+				SE
+
+00-0C-4C   (hex)		Arcor AG&Co.
+000C4C     (base 16)		Arcor AG&Co.
+				Alfred-Herrhausen-Allee 1
+				Eschborn  Hessen  65760
+				DE
+
+00-0C-47   (hex)		SK Teletech(R&D Planning Team)
+000C47     (base 16)		SK Teletech(R&D Planning Team)
+				21th FL Startower 737, Yeoksam-dong
+				Seoul    135-984
+				KR
+
+00-0C-6D   (hex)		Edwards Ltd.
+000C6D     (base 16)		Edwards Ltd.
+				Marshall Road
+				Eastbourne  East Sussex  BN22 9BA
+				GB
+
+00-0C-70   (hex)		ACC GmbH
+000C70     (base 16)		ACC GmbH
+				Am Sandfeld 15
+				Karlsruhe  Baden  76149
+				DE
+
+00-0C-6A   (hex)		MBARI
+000C6A     (base 16)		MBARI
+				7700 Sandholdt Road
+				Moss Landing  CA  95039
+				US
+
+00-0C-6B   (hex)		Kurz Industrie-Elektronik GmbH
+000C6B     (base 16)		Kurz Industrie-Elektronik GmbH
+				Foehrenbachstraße 3
+				Remshalden  Baden-Württemberg  73630
+				DE
+
+00-0C-9D   (hex)		UbeeAirWalk, Inc.
+000C9D     (base 16)		UbeeAirWalk, Inc.
+				1850 N. GreenVille Ave., Suite 164
+				Richardson  TX  75081
+				US
+
+00-0C-9F   (hex)		NKE Corporation
+000C9F     (base 16)		NKE Corporation
+				366-1 Hishikawa-cho Hazukashi Fushimi-ku
+				Kyoto-shi  Kyoto  612-8487
+				JP
+
+00-0C-84   (hex)		Eazix, Inc.
+000C84     (base 16)		Eazix, Inc.
+				Unit 301 Plaza Building B
+				Muntinlupa City  Rizal  1770
+				PH
+
+00-0C-85   (hex)		Cisco Systems, Inc
+000C85     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-3F   (hex)		Cogent Defence & Security Networks,
+000C3F     (base 16)		Cogent Defence & Security Networks,
+				Meadows Road,
+				Newport,  South Wales,  NP19 4SS
+				GB
+
+00-0C-30   (hex)		Cisco Systems, Inc
+000C30     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-9A   (hex)		Hitech Electronics Corp.
+000C9A     (base 16)		Hitech Electronics Corp.
+				4f, No. 501-15 Chung-Cheng Rd.
+				Shin-tien  Taipei Shien  231
+				TW
+
+00-0C-91   (hex)		Riverhead Networks Inc.
+000C91     (base 16)		Riverhead Networks Inc.
+				
+				Cupertino  CA  95014
+				US
+
+00-0B-DA   (hex)		EyeCross Co.,Inc.
+000BDA     (base 16)		EyeCross Co.,Inc.
+				3F  Iioka-Building
+				Tokyo  Ueno Taitoh-ku 3-4-1  110-0005
+				JP
+
+00-0B-D6   (hex)		Paxton Access Ltd
+000BD6     (base 16)		Paxton Access Ltd
+				Paxton House
+				Brighton  East Sussex  BN1 9HU
+				GB
+
+00-0B-D4   (hex)		Beijing Wise Technology & Science Development Co.Ltd
+000BD4     (base 16)		Beijing Wise Technology & Science Development Co.Ltd
+				3rd Floor Caihong Building, No.2,1st Wes
+				Beijing    100088
+				CN
+
+00-0C-1F   (hex)		Glimmerglass Networks
+000C1F     (base 16)		Glimmerglass Networks
+				26142 Eden Landing Road
+				Hayward  California  94545
+				US
+
+00-0C-20   (hex)		Fi WIn, Inc.
+000C20     (base 16)		Fi WIn, Inc.
+				8F, No. 10, Prosperity Rd. 1,
+				Hsin Chu    300
+				TW
+
+00-0C-15   (hex)		CyberPower Systems, Inc.
+000C15     (base 16)		CyberPower Systems, Inc.
+				6F, No. 32, Sec. 1, Chenggong Rd.
+				Taipei    115
+				TW
+
+00-0B-F8   (hex)		Infinera
+000BF8     (base 16)		Infinera
+				1322 Bordeaux Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0B-FF   (hex)		Berkeley Camera Engineering
+000BFF     (base 16)		Berkeley Camera Engineering
+				127 National Street
+				Santa Cruz  CA  95060
+				US
+
+00-0C-16   (hex)		Concorde Microsystems Inc.
+000C16     (base 16)		Concorde Microsystems Inc.
+				10427 Cogdill Road, Suite 500
+				Knoxville  TN  37932
+				US
+
+00-0C-09   (hex)		Hitachi IE Systems Co., Ltd
+000C09     (base 16)		Hitachi IE Systems Co., Ltd
+				Saiwai-cho 120-1,Inazawa-shi
+				Inazawa-shi  Aichi  492-8622
+				JP
+
+00-0B-E7   (hex)		COMFLUX TECHNOLOGY INC.
+000BE7     (base 16)		COMFLUX TECHNOLOGY INC.
+				 Room 131,Bldg. 53,195-58,Sec.4,
+				Hsinchu    310
+				TW
+
+00-0B-EC   (hex)		NIPPON ELECTRIC INSTRUMENT, INC.
+000BEC     (base 16)		NIPPON ELECTRIC INSTRUMENT, INC.
+				3-56-21 Hirado
+				Totsuka-ku  Yokohama-shi  244-0802
+				JP
+
+00-0C-02   (hex)		ABB Oy
+000C02     (base 16)		ABB Oy
+				P.O.Box 89
+				Turku    FIN-20521
+				FI
+
+00-0B-71   (hex)		Litchfield Communications Inc.
+000B71     (base 16)		Litchfield Communications Inc.
+				27 Princeton Road
+				Watertown  CT  06795
+				US
+
+00-0B-74   (hex)		Kingwave Technology Co., Ltd.
+000B74     (base 16)		Kingwave Technology Co., Ltd.
+				18F-3, No. 186, Jian-Yi Rd.
+				Chung-Ho  Taipei  235
+				TW
+
+00-0B-73   (hex)		Kodeos Communications
+000B73     (base 16)		Kodeos Communications
+				111 Corporate Blvd
+				South Plainfield  NJ  07080
+				US
+
+00-0B-76   (hex)		ET&T Technology Co. Ltd.
+000B76     (base 16)		ET&T Technology Co. Ltd.
+				6F No.101, SongJiang Rd.
+				Taipei    104
+				TW
+
+00-0B-5E   (hex)		Audio Engineering Society Inc.
+000B5E     (base 16)		Audio Engineering Society Inc.
+				60 East 42nd Street, Suite #2520
+				New York  NY  10165-2520
+				US
+
+00-0B-60   (hex)		Cisco Systems, Inc
+000B60     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-65   (hex)		Sy.A.C. srl
+000B65     (base 16)		Sy.A.C. srl
+				via Caboto 19/1
+				Trieste    34147
+				IT
+
+00-0B-5F   (hex)		Cisco Systems, Inc
+000B5F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-61   (hex)		Friedrich Lütze GmbH & Co. KG
+000B61     (base 16)		Friedrich Lütze GmbH & Co. KG
+				Bruckwiesenstraße 17 - 19
+				Weinstadt (Großheppach)  BW  71384
+				DE
+
+00-0B-59   (hex)		ScriptPro, LLC
+000B59     (base 16)		ScriptPro, LLC
+				5828 Reeds Rd.
+				Mission  Kansas  66202
+				US
+
+00-0B-5C   (hex)		Newtech Co.,Ltd
+000B5C     (base 16)		Newtech Co.,Ltd
+				K-Bldg 1-7-7 Shibadaimon Minato-ku
+				Tokyo    105-0012
+				JP
+
+00-0B-7E   (hex)		SAGINOMIYA Seisakusho Inc.
+000B7E     (base 16)		SAGINOMIYA Seisakusho Inc.
+				535 Sasai
+				Sayamashi  Saitamaken  350-1395
+				JP
+
+00-0B-80   (hex)		Lycium Networks
+000B80     (base 16)		Lycium Networks
+				9 Hamenofim St.
+				Herzliya  Israel  46733
+				IL
+
+00-0B-A7   (hex)		Maranti Networks
+000BA7     (base 16)		Maranti Networks
+				3061-B Zanker Road
+				San Jose  CA  95134
+				US
+
+00-0B-AA   (hex)		Aiphone co.,Ltd
+000BAA     (base 16)		Aiphone co.,Ltd
+				2-18 Jinno-Cho
+				Nagoya  Aichi-ken  456-8666
+				JP
+
+00-0B-A4   (hex)		Shiron Satellite Communications Ltd. (1996)
+000BA4     (base 16)		Shiron Satellite Communications Ltd. (1996)
+				23 Hasivim St.
+				Petach Tikva    49170
+				IL
+
+00-0B-D0   (hex)		XiMeta Technology Americas Inc.
+000BD0     (base 16)		XiMeta Technology Americas Inc.
+				54 Ray Street
+				New Brunswick  NJ  08901
+				US
+
+00-0B-C5   (hex)		SMC Networks, Inc.
+000BC5     (base 16)		SMC Networks, Inc.
+				38 Tesla
+				Irvine  CA  92618
+				US
+
+00-0B-C6   (hex)		ISAC, Inc.
+000BC6     (base 16)		ISAC, Inc.
+				PO Box 7682
+				Auburn  CA  95604
+				US
+
+00-0B-C1   (hex)		Bay Microsystems, Inc.
+000BC1     (base 16)		Bay Microsystems, Inc.
+				2055 Gateway Place
+				Santa Jose  CA  95110
+				US
+
+00-0B-8B   (hex)		KERAJET, S.A.
+000B8B     (base 16)		KERAJET, S.A.
+				Avda. del Boverot, 24
+				Almazora  Castellon  E-12550
+				ES
+
+00-0B-89   (hex)		Top Global Technology, Ltd.
+000B89     (base 16)		Top Global Technology, Ltd.
+				Room 3310, China World Tower No. 1
+				Beijing  Beijing  100004
+				CN
+
+00-0B-99   (hex)		SensAble Technologies, Inc.
+000B99     (base 16)		SensAble Technologies, Inc.
+				15 Constitution Way
+				Woburn  MA  01801
+				US
+
+00-0B-9C   (hex)		TriBeam Technologies, Inc.
+000B9C     (base 16)		TriBeam Technologies, Inc.
+				116 W. Eastman St., suite 208
+				Arlington Heights  IL  60004
+				US
+
+00-0B-7C   (hex)		Telex Communications
+000B7C     (base 16)		Telex Communications
+				8601 E. Cornhusker Hwy
+				Lincoln  NE  68505
+				US
+
+00-0B-83   (hex)		DATAWATT B.V.
+000B83     (base 16)		DATAWATT B.V.
+				HOUTSTRAAT 5
+				WOLVEGA    NL-8471-ZX
+				NL
+
+00-0B-20   (hex)		Hirata corporation
+000B20     (base 16)		Hirata corporation
+				111 Hitotsugi, Ueki, Kamoto,
+				  Kumamoto  861-0198
+				JP
+
+00-0B-22   (hex)		Environmental Systems and Services
+000B22     (base 16)		Environmental Systems and Services
+				20 Council Street
+				Hawthorn East  Victoria  3123
+				AU
+
+00-0B-1B   (hex)		Systronix, Inc.
+000B1B     (base 16)		Systronix, Inc.
+				939 Edison St.
+				Salt Lake City  Utah  84111
+				US
+
+00-0B-03   (hex)		Taekwang Industrial Co., Ltd
+000B03     (base 16)		Taekwang Industrial Co., Ltd
+				#191-1, Anyang-7Dong, Manan-Gu
+				Anyang-Si  South Korea  430-017
+				KR
+
+00-0B-01   (hex)		DAIICHI ELECTRONICS CO., LTD.
+000B01     (base 16)		DAIICHI ELECTRONICS CO., LTD.
+				1-11-13
+				Hitotsuya  Adachi-ku Tokyo  121-8639
+				JP
+
+00-0B-3E   (hex)		BittWare, Inc
+000B3E     (base 16)		BittWare, Inc
+				31 B South Main St
+				Concord  NH  03301
+				US
+
+00-0B-29   (hex)		LS(LG) Industrial Systems co.,Ltd
+000B29     (base 16)		LS(LG) Industrial Systems co.,Ltd
+				533 Hogye-dong, Dongan-gu
+				Anyang-si  Gyeonggi-do  
+				KR
+
+00-0B-39   (hex)		Keisoku Giken Co.,Ltd.
+000B39     (base 16)		Keisoku Giken Co.,Ltd.
+				Tsuzuki-ku
+				Yokohama  Kanagawa  224-0037
+				JP
+
+00-0B-3A   (hex)		QuStream Corporation
+000B3A     (base 16)		QuStream Corporation
+				3305 Breckinridge Blvd.
+				Duluth  Georgia  30096
+				US
+
+00-0B-33   (hex)		Vivato Technologies
+000B33     (base 16)		Vivato Technologies
+				444 Cedros Ave
+				Solana Beach  CA  92027
+				US
+
+00-0B-05   (hex)		Pacific Broadband Networks
+000B05     (base 16)		Pacific Broadband Networks
+				Suite 15,  Building 3, 195 Wellington Road
+				Clayton  VIC  3168
+				AU
+
+00-0B-00   (hex)		FUJIAN START COMPUTER EQUIPMENT CO.,LTD
+000B00     (base 16)		FUJIAN START COMPUTER EQUIPMENT CO.,LTD
+				HONG SHAN YUAN ROAD NO.68 HONGSHAN,GULOU
+				FUZHOU  FUJIAN  350002
+				CN
+
+00-0B-5B   (hex)		Rincon Research Corporation
+000B5B     (base 16)		Rincon Research Corporation
+				101 N. Wilmot Rd.
+				Tucson  AZ  85711
+				US
+
+00-0A-F6   (hex)		Emerson Climate Technologies Retail Solutions, Inc.
+000AF6     (base 16)		Emerson Climate Technologies Retail Solutions, Inc.
+				1640 Airport Rd
+				Kennesaw  GA  30144-7038
+				US
+
+00-0B-11   (hex)		HIMEJI ABC TRADING CO.,LTD.
+000B11     (base 16)		HIMEJI ABC TRADING CO.,LTD.
+				1-8-22
+				HJMEJI  HYOGO  670-0883
+				JP
+
+00-0B-41   (hex)		Ing. Büro Dr. Beutlhauser
+000B41     (base 16)		Ing. Büro Dr. Beutlhauser
+				Roemerweg 4
+				  Grassau  D-83224
+				DE
+
+00-0A-EA   (hex)		ADAM ELEKTRONIK LTD. ŞTI
+000AEA     (base 16)		ADAM ELEKTRONIK LTD. ŞTI
+				UZUNAYNA CAD. CELENK SOK. NO:1 Çakmak
+				İstanbul    81260
+				TR
+
+00-0A-E3   (hex)		YANG MEI TECHNOLOGY CO., LTD
+000AE3     (base 16)		YANG MEI TECHNOLOGY CO., LTD
+				21, Alley 1, Lane 342
+				Taipei    114
+				TW
+
+00-0A-DC   (hex)		RuggedCom Inc.
+000ADC     (base 16)		RuggedCom Inc.
+				30 Whitmore Road
+				Woodbridge  Ontario  L4L 7Z4
+				CA
+
+00-0A-B7   (hex)		Cisco Systems, Inc
+000AB7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-AD   (hex)		Stargames Corporation
+000AAD     (base 16)		Stargames Corporation
+				13 Sheridan Close
+				Milperra  NSW  2031
+				AU
+
+00-0A-B1   (hex)		GENETEC Corporation
+000AB1     (base 16)		GENETEC Corporation
+				BYGS Shinjyuku Bldg. 5F
+				Shinjuku-ku  Tokyo  162-0022
+				JP
+
+00-0A-B9   (hex)		Astera Technologies Corp.
+000AB9     (base 16)		Astera Technologies Corp.
+				 2380 Waverley Street
+				Palo Alto  CA  94301
+				US
+
+00-0A-90   (hex)		Bayside Interactive, Inc.
+000A90     (base 16)		Bayside Interactive, Inc.
+				330 Biscayne Blvd.
+				Miami  FL  33132
+				US
+
+00-0A-9D   (hex)		King Young Technology Co. Ltd.
+000A9D     (base 16)		King Young Technology Co. Ltd.
+				1Fl., No. 9, Lane 26, Gangchi Rd., Neihu
+				Taipei    114
+				TW
+
+00-0A-A1   (hex)		V V S Limited
+000AA1     (base 16)		V V S Limited
+				HPIC, 1. Ainslie Road ,
+				Glasgow  Scotland  G52 4RU
+				GB
+
+00-0A-A4   (hex)		SHANGHAI SURVEILLANCE TECHNOLOGY CO,LTD
+000AA4     (base 16)		SHANGHAI SURVEILLANCE TECHNOLOGY CO,LTD
+				FL.25A,NO.8 CHANGYANG ROAD
+				SHANGHAI    200082
+				CN
+
+00-0A-9E   (hex)		BroadWeb Corportation
+000A9E     (base 16)		BroadWeb Corportation
+				3F, 24-1, Industry East Rd., IV,
+				  Hsin-Chu  300
+				TW
+
+00-0A-E0   (hex)		Fujitsu Softek
+000AE0     (base 16)		Fujitsu Softek
+				1250 East Arques Ave
+				Sunnyvale  Ca  94085
+				US
+
+00-0A-8B   (hex)		Cisco Systems, Inc
+000A8B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-88   (hex)		InCypher S.A.
+000A88     (base 16)		InCypher S.A.
+				18 rue de l'Eau
+				Luxembourg    1449
+				LU
+
+00-0A-BB   (hex)		Taiwan Secom Co,. Ltd
+000ABB     (base 16)		Taiwan Secom Co,. Ltd
+				13F, 108, Sec1, Shin-Tai 5th Road
+				Hsi-Chih  Taipei County  221
+				TW
+
+00-0A-7C   (hex)		Tecton Ltd
+000A7C     (base 16)		Tecton Ltd
+				Fishers Court
+				Eastleigh  Hampshire  SO50 7HG
+				GB
+
+00-0A-6E   (hex)		Harmonic, Inc
+000A6E     (base 16)		Harmonic, Inc
+				4300 North First Street
+				San Jose  CA  95134
+				US
+
+00-0A-6D   (hex)		EKS Elektronikservice GmbH
+000A6D     (base 16)		EKS Elektronikservice GmbH
+				Enzstr. 9
+				Kornwestheim  Baden-Württemberg  70806
+				DE
+
+00-0A-43   (hex)		Chunghwa Telecom Co., Ltd.
+000A43     (base 16)		Chunghwa Telecom Co., Ltd.
+				12, Lane 551, Min-Tsu Road
+				Taoyuan    326
+				TW
+
+00-0A-45   (hex)		Audio-Technica Corp.
+000A45     (base 16)		Audio-Technica Corp.
+				Naruse 1,348
+				Machida  Tokyo  194-8566
+				JP
+
+00-0A-35   (hex)		Xilinx
+000A35     (base 16)		Xilinx
+				2100 Logic Drive
+				San Jose  CA  94110
+				US
+
+00-0A-3B   (hex)		GCT Semiconductor, Inc
+000A3B     (base 16)		GCT Semiconductor, Inc
+				2121 Ringwood Avenue
+				San Jose  CA  95131
+				US
+
+00-0A-74   (hex)		Manticom Networks Inc.
+000A74     (base 16)		Manticom Networks Inc.
+				14016-C Sullyfield Circle
+				Chantilly  VA  20151
+				US
+
+00-0A-6F   (hex)		ZyFLEX Technologies Inc
+000A6F     (base 16)		ZyFLEX Technologies Inc
+				2Fl. No. 58 Park Ave. II
+				S.B.I.P., Hsinchu    30077
+				TW
+
+00-0A-63   (hex)		DHD GmbH
+000A63     (base 16)		DHD GmbH
+				Haferkornstrasse 5
+				Leipzig  Sachsen  04129
+				DE
+
+00-0A-2E   (hex)		MAPLE NETWORKS CO., LTD
+000A2E     (base 16)		MAPLE NETWORKS CO., LTD
+				602, Dongwha
+				SEOUL    156-010
+				KR
+
+00-0A-2D   (hex)		Cabot Communications Limited
+000A2D     (base 16)		Cabot Communications Limited
+				Verona House
+				Bristol  Gloucestershire  BS16 3RY
+				US
+
+00-0A-25   (hex)		CERAGON NETWORKS
+000A25     (base 16)		CERAGON NETWORKS
+				24 RAUEL WALLENBERG STREET
+				TEL-AVIV    96719
+				IL
+
+00-0A-21   (hex)		Integra Telecom Co. Ltd
+000A21     (base 16)		Integra Telecom Co. Ltd
+				7th floor Hwayoung Bld. 112-2
+				Seoul    
+				KR
+
+00-0A-1E   (hex)		Red-M Products Limited
+000A1E     (base 16)		Red-M Products Limited
+				Neptune House
+				Wooburn Green  Buckinghamshire  HP10 0HH
+				GB
+
+00-0A-4B   (hex)		DataPower Technology, Inc.
+000A4B     (base 16)		DataPower Technology, Inc.
+				One Alewife Center
+				Cambridge  MA  02140
+				US
+
+00-0A-33   (hex)		Emulex Corporation
+000A33     (base 16)		Emulex Corporation
+				2021 Opportunity Drive
+				Roseville  CA  95678
+				US
+
+00-0A-67   (hex)		OngCorp
+000A67     (base 16)		OngCorp
+				481 Hackensack Ave.
+				Hackensack  NJ  07601
+				US
+
+00-09-F9   (hex)		ART JAPAN CO., LTD.
+0009F9     (base 16)		ART JAPAN CO., LTD.
+				322-7, Ichinotsubo,
+				Kawasaki  Kanagawa  211-0016
+				JP
+
+00-09-FC   (hex)		IPFLEX Inc.
+0009FC     (base 16)		IPFLEX Inc.
+				Mowa-Bldg 3F, 1-16-6
+				Shibuya-ku  Tokyo  150-0021
+				JP
+
+00-09-FD   (hex)		Ubinetics Limited
+0009FD     (base 16)		Ubinetics Limited
+				Cambridge Technology Centre
+				Melbourn  Hertfordshire  SG8 6DP
+				GB
+
+00-09-F7   (hex)		SED, a division of Calian
+0009F7     (base 16)		SED, a division of Calian
+				18 Innnovation Boulevard
+				Saskatoon  Saskatchewan (SK)  S7K 3P7
+				CA
+
+00-09-E2   (hex)		Sinbon Electronics Co., Ltd.
+0009E2     (base 16)		Sinbon Electronics Co., Ltd.
+				4F-13, No. 79, Sec 1, Hsin Tai Wu Rd.
+				Hsi-Chih, Taipei    221
+				TW
+
+00-09-DA   (hex)		Control Module Inc.
+0009DA     (base 16)		Control Module Inc.
+				227 Brainard Road
+				Enfield  CT  06082
+				US
+
+00-09-D7   (hex)		DC Security Products
+0009D7     (base 16)		DC Security Products
+				One Lindsay Circle
+				San Francisco  California  94124
+				US
+
+00-09-D8   (hex)		Fält Communications AB
+0009D8     (base 16)		Fält Communications AB
+				Kylgränd 6a
+				SE 906 20  Umeå  
+				SE
+
+00-0A-14   (hex)		TECO a.s.
+000A14     (base 16)		TECO a.s.
+				Havlickova 260
+				KOLIN  CZ  280 58
+				CZ
+
+00-0A-0B   (hex)		Sealevel Systems, Inc.
+000A0B     (base 16)		Sealevel Systems, Inc.
+				155 Technology Place
+				Liberty  SC  29657
+				US
+
+00-0A-10   (hex)		FAST media integrations AG
+000A10     (base 16)		FAST media integrations AG
+				Schöngrund 26
+				Rotkreuz  Canton of Zug  6343
+				CH
+
+00-09-DB   (hex)		eSpace
+0009DB     (base 16)		eSpace
+				9623 Simsbury Ct.
+				Twinsburg  OH  44087-3220
+				US
+
+00-09-D5   (hex)		Signal Communication, Inc.
+0009D5     (base 16)		Signal Communication, Inc.
+				100 Wood Ave South
+				Iselin  NJ  08830
+				US
+
+00-09-D3   (hex)		Western DataCom Co., Inc.
+0009D3     (base 16)		Western DataCom Co., Inc.
+				925-D Bassett Rd.
+				Westlake  OH  44145
+				US
+
+00-09-BC   (hex)		Utility, Inc
+0009BC     (base 16)		Utility, Inc
+				250 E Ponce de Leon Ave Suite 700
+				Decatur  GA  30030
+				US
+
+00-09-BE   (hex)		Mamiya-OP Co.,Ltd.
+0009BE     (base 16)		Mamiya-OP Co.,Ltd.
+				3-23-10, Negishi Minami-ku
+				Saitama-shi  Saitama  336-8581
+				JP
+
+00-09-E6   (hex)		Cyber Switching Inc.
+0009E6     (base 16)		Cyber Switching Inc.
+				1800 De La Cruz Blvd.
+				Santa Clara  CA  95050
+				US
+
+00-09-FB   (hex)		Philips Patient Monitoring
+0009FB     (base 16)		Philips Patient Monitoring
+				Hewlett-Packard-Str.2
+				Boeblingen    71034
+				DE
+
+00-09-8F   (hex)		Cetacean Networks
+00098F     (base 16)		Cetacean Networks
+				110 Corporate Drive
+				Portsmouth  NH  03801
+				US
+
+00-09-87   (hex)		NISHI NIPPON ELECTRIC WIRE & CABLE CO.,LTD.
+000987     (base 16)		NISHI NIPPON ELECTRIC WIRE & CABLE CO.,LTD.
+				Kasugaura
+				Oita-City  OITA  870-8632
+				JP
+
+00-09-89   (hex)		VividLogic Inc.
+000989     (base 16)		VividLogic Inc.
+				40994 Encyclopedia Circle
+				Fremont  CA  94538
+				US
+
+00-09-86   (hex)		Metalink LTD.
+000986     (base 16)		Metalink LTD.
+				Yakum Business Park
+				Yakum  HOF HASHARON  60972
+				IL
+
+00-09-8C   (hex)		Option Wireless Sweden
+00098C     (base 16)		Option Wireless Sweden
+				Sturegatan 2
+				  Sundbyberg  SE-172 24
+				SE
+
+00-09-85   (hex)		Auto Telecom Company
+000985     (base 16)		Auto Telecom Company
+				10F, No.3,Lane 16, Sec.2, Sichuan Rd.
+				Banqiao City  Taipei County  22061
+				TW
+
+00-09-8D   (hex)		Velocity Semiconductor
+00098D     (base 16)		Velocity Semiconductor
+				Suite 32 Wey House
+				Weybridge  Surrey  KT13 8NA
+				GB
+
+00-09-81   (hex)		Newport Networks
+000981     (base 16)		Newport Networks
+				Enterprise House
+				Chepstow  Monmouthshire  NP16 5PB
+				GB
+
+00-09-55   (hex)		Young Generation International Corp.
+000955     (base 16)		Young Generation International Corp.
+				4F.,No. 188, Minchuan Rd., Shindian City
+				Shindian    231
+				TW
+
+00-09-4A   (hex)		Homenet Communications
+00094A     (base 16)		Homenet Communications
+				Innovation Centre
+				Limerick    
+				IE
+
+00-09-4B   (hex)		FillFactory NV
+00094B     (base 16)		FillFactory NV
+				Schalienhoevedreef 20B
+				B-2800 Mechelen    
+				BE
+
+00-09-4D   (hex)		Braintree Communications Pty Ltd
+00094D     (base 16)		Braintree Communications Pty Ltd
+				Unit 3
+				Slacks Creek  QLD  4127
+				AU
+
+00-09-50   (hex)		Independent Storage Corporation
+000950     (base 16)		Independent Storage Corporation
+				6273 Monarch Park Place
+				Niwot  Colorado  80503
+				US
+
+00-09-54   (hex)		AMiT spol. s. r. o.
+000954     (base 16)		AMiT spol. s. r. o.
+				Naskove 3
+				150 00  Praha 5  
+				CZ
+
+00-09-92   (hex)		InterEpoch Technology,INC.
+000992     (base 16)		InterEpoch Technology,INC.
+				7F,No.3,Alley 6,Lane 235,Pao-Chiao Rd
+				Hsin-Tien  Taipei Hsien  231
+				TW
+
+00-09-95   (hex)		Castle Technology Ltd
+000995     (base 16)		Castle Technology Ltd
+				Ore Trading Estate
+				Framlingham  Suffolk  IP13 9LL
+				GB
+
+00-09-98   (hex)		Capinfo Company Limited
+000998     (base 16)		Capinfo Company Limited
+				7th Floor A Corporate Square, NO. 35 Fin
+				Beijing    100032
+				CN
+
+00-09-B6   (hex)		Cisco Systems, Inc
+0009B6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-B3   (hex)		MCM Systems Ltd
+0009B3     (base 16)		MCM Systems Ltd
+				Kolomban 9F
+				Ankaran  Slovenija  6280
+				SI
+
+00-09-5C   (hex)		Philips Medical Systems - Cardiac and Monitoring Systems (CM
+00095C     (base 16)		Philips Medical Systems - Cardiac and Monitoring Systems (CM
+				3000 Minuteman Road
+				Andover  Massachusetts  01810
+				US
+
+00-09-58   (hex)		INTELNET S.A.
+000958     (base 16)		INTELNET S.A.
+				FRANCISCO OLIVAN BAYLE, 4
+				ZARAGOZA    50015
+				ES
+
+00-09-A3   (hex)		Leadfly Techologies Corp. Ltd.
+0009A3     (base 16)		Leadfly Techologies Corp. Ltd.
+				9Fl, No.260, Bade Rd.,
+				Taipei    104
+				TW
+
+00-09-A5   (hex)		HANSUNG ELETRONIC INDUSTRIES DEVELOPMENT CO., LTD
+0009A5     (base 16)		HANSUNG ELETRONIC INDUSTRIES DEVELOPMENT CO., LTD
+				HEUNGJIN BLDG 3F, #217-3 POI-DONG, KANGN
+				SEOUL    135-963
+				KR
+
+00-09-62   (hex)		Sonitor Technologies AS
+000962     (base 16)		Sonitor Technologies AS
+				Forskningsveien 1B
+				Oslo  Blindern  N-0134
+				NO
+
+00-09-5D   (hex)		Dialogue Technology Corp.
+00095D     (base 16)		Dialogue Technology Corp.
+				10F, No. 196, Sec. 2, Jungshing Rd.
+				Shindian City  Taipei  231
+				TW
+
+00-09-9A   (hex)		ELMO COMPANY, LIMITED
+00099A     (base 16)		ELMO COMPANY, LIMITED
+				6-14, MEIZEN-CHO, MIZUHO-KU
+				NAGOYA  AICHI-Pref.  467-8567
+				JP
+
+00-09-9C   (hex)		Naval Research Laboratory
+00099C     (base 16)		Naval Research Laboratory
+				Code 5592
+				Washington  DC  20375-5000
+				US
+
+00-09-84   (hex)		MyCasa Network Inc.
+000984     (base 16)		MyCasa Network Inc.
+				200 Sheridan Ave #103
+				Palo Alto  CA  94306
+				US
+
+00-09-2B   (hex)		iQstor Networks, Inc.
+00092B     (base 16)		iQstor Networks, Inc.
+				2001 Corporate Center Drive
+				Newbury Park  CA  91320
+				US
+
+00-09-26   (hex)		YODA COMMUNICATIONS, INC.
+000926     (base 16)		YODA COMMUNICATIONS, INC.
+				2F, No.3-1, Industry East Road IX,
+				Hsinchu    300
+				TW
+
+00-09-27   (hex)		TOYOKEIKI CO.,LTD.
+000927     (base 16)		TOYOKEIKI CO.,LTD.
+				17-10-3,Shimosinjyo
+				Osaka    533-0021
+				JP
+
+00-09-23   (hex)		Heaman System Co., Ltd
+000923     (base 16)		Heaman System Co., Ltd
+				Building M6,National Hi-tech & Indus
+				Changsha  Hunan Province  410013
+				US
+
+00-09-1D   (hex)		Proteam Computer Corporation
+00091D     (base 16)		Proteam Computer Corporation
+				7F, No. 157. Section 2 Ta-Tung Rd
+				Hsi-Chih  Taipei Hsien  221
+				US
+
+00-08-EB   (hex)		ROMWin Co.,Ltd.
+0008EB     (base 16)		ROMWin Co.,Ltd.
+				406 OmiyaOhtaka Bldg. 1-103
+				Saitama    330-0843
+				US
+
+00-08-E8   (hex)		Excel Master Ltd.
+0008E8     (base 16)		Excel Master Ltd.
+				Room D, 3/F., Yeung Yiu Chung (No. 8) Ind. Bldg.
+				  Kowloon Bay  
+				HK
+
+00-08-DC   (hex)		Wiznet
+0008DC     (base 16)		Wiznet
+				5F Simmtech bldg., 228-3,
+				Seoul    135-830
+				KR
+
+00-08-DD   (hex)		Telena Communications, Inc.
+0008DD     (base 16)		Telena Communications, Inc.
+				6725 Mesa Ridge Road
+				San Diego  CA  92121
+				US
+
+00-08-E1   (hex)		Barix AG
+0008E1     (base 16)		Barix AG
+				Seefeld Strasse 303
+				Zürich  ZH  8008
+				US
+
+00-09-09   (hex)		Telenor Connect A/S
+000909     (base 16)		Telenor Connect A/S
+				Ellegaardvej 25L
+				Sønderborg  Als  6400
+				DK
+
+00-09-0A   (hex)		SnedFar Technology Co., Ltd.
+00090A     (base 16)		SnedFar Technology Co., Ltd.
+				15FL., No.866-2, Jung Jeng Rd.,
+				Junghe  Taipei  235
+				TW
+
+00-09-0F   (hex)		Fortinet Inc.
+00090F     (base 16)		Fortinet Inc.
+				1090 Kifer Road
+				Sunnyvale  CA  94086
+				US
+
+00-09-2C   (hex)		Hitpoint Inc.
+00092C     (base 16)		Hitpoint Inc.
+				No.7, Fenliao, 2nd Industrial Park, Link
+				Taipei    244
+				TW
+
+00-09-03   (hex)		Panasas, Inc
+000903     (base 16)		Panasas, Inc
+				15333 John F Kennedy Blvd, Suite 400
+				Houston  TX  77032-2351
+				US
+
+00-09-07   (hex)		Chrysalis Development
+000907     (base 16)		Chrysalis Development
+				8125 River Dr. Suite 100
+				Morton Grove  IL  60053
+				US
+
+00-09-06   (hex)		Esteem Networks
+000906     (base 16)		Esteem Networks
+				4F, No.900, Yishan Road
+				Shanghai    200233
+				CN
+
+00-09-52   (hex)		Auerswald GmbH & Co. KG
+000952     (base 16)		Auerswald GmbH & Co. KG
+				Vor den Grashoefen 1
+				Cremlingen  Niedersachsen  38162
+				DE
+
+00-09-44   (hex)		Cisco Systems, Inc
+000944     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-FB   (hex)		SonoSite, Inc.
+0008FB     (base 16)		SonoSite, Inc.
+				21919 30th Drive SE
+				Bothell  WA  98021
+				US
+
+00-08-EE   (hex)		Logic Product Development
+0008EE     (base 16)		Logic Product Development
+				411 Washington Ave N. Suite 101
+				Minneapolis  Minnesota  55401
+				US
+
+00-09-17   (hex)		WEM Technology Inc
+000917     (base 16)		WEM Technology Inc
+				8F-2, No 386, Sec 5 Nanjing East Road.
+				Taipei    105
+				TW
+
+00-08-81   (hex)		DIGITAL HANDS CO.,LTD.
+000881     (base 16)		DIGITAL HANDS CO.,LTD.
+				KAKiYA Building 2F
+				Yokohama  Kanagawa  222-0033
+				JP
+
+00-08-82   (hex)		SIGMA CORPORATION
+000882     (base 16)		SIGMA CORPORATION
+				2-3-15 Iwato-minami
+				Komae-shi  Tokyo  201-8630
+				JP
+
+00-08-73   (hex)		DapTechnology B.V.
+000873     (base 16)		DapTechnology B.V.
+				Zutphenstraat 67
+				EJ Oldenzaal    7575
+				NL
+
+00-08-7A   (hex)		Wipotec GmbH
+00087A     (base 16)		Wipotec GmbH
+				Adam-Hoffman Str. 26
+				    
+				DE
+
+00-08-71   (hex)		NORTHDATA Co., Ltd.
+000871     (base 16)		NORTHDATA Co., Ltd.
+				#302 KayangTechno-Town 1487
+				Kangseo-Gu  Seoul  157-810
+				KR
+
+00-08-B2   (hex)		SHENZHEN COMPASS TECHNOLOGY DEVELOPMENT CO.,LTD
+0008B2     (base 16)		SHENZHEN COMPASS TECHNOLOGY DEVELOPMENT CO.,LTD
+				4th Floor,Building 205,TaiRan Industry
+				Shenzhen  GUANGDONG  518040
+				CN
+
+00-08-B1   (hex)		ProQuent Systems
+0008B1     (base 16)		ProQuent Systems
+				67 Forest Street
+				Marlboro  MA  01752
+				US
+
+00-08-AF   (hex)		Novatec Corporation
+0008AF     (base 16)		Novatec Corporation
+				2-19-2 Nishi-Gotanda
+				Shinagawa-ku  Tokyo  141-0031
+				JP
+
+00-08-A6   (hex)		Multiware & Image Co., Ltd.
+0008A6     (base 16)		Multiware & Image Co., Ltd.
+				Saedong Bldg. 65-25,
+				Pusan    606-032
+				KR
+
+00-08-7E   (hex)		Bon Electro-Telecom Inc.
+00087E     (base 16)		Bon Electro-Telecom Inc.
+				Gayang 1st Factory 701, 14-81
+				Seoul    157-808
+				KR
+
+00-08-80   (hex)		BroadTel Canada Communications inc.
+000880     (base 16)		BroadTel Canada Communications inc.
+				3700 Griffith, Suite 389
+				Saint-Laurent  Quebec  H4T 2B3
+				CA
+
+00-08-6D   (hex)		Missouri FreeNet
+00086D     (base 16)		Missouri FreeNet
+				PO Box 771026
+				St. Louis  Missouri  63177-1026
+				US
+
+00-08-D4   (hex)		IneoQuest Technologies, Inc
+0008D4     (base 16)		IneoQuest Technologies, Inc
+				1931 Washington St
+				Canton  Massachusetts  02021
+				US
+
+00-08-D6   (hex)		HASSNET Inc.
+0008D6     (base 16)		HASSNET Inc.
+				2F Missy2000 B/D 725, SooSeo-Dong,
+				Seoul    135-757
+				KR
+
+00-08-CE   (hex)		IPMobileNet Inc.
+0008CE     (base 16)		IPMobileNet Inc.
+				11909 E Telegraph Rd.
+				Santa Fe Springs  CA  90670
+				US
+
+00-08-C2   (hex)		Cisco Systems, Inc
+0008C2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-C0   (hex)		ASA SYSTEMS
+0008C0     (base 16)		ASA SYSTEMS
+				S245 Korea Maritime University, 1 Dongsa
+				Busan  Busan Metropolitan City  606-791
+				KR
+
+00-08-A3   (hex)		Cisco Systems, Inc
+0008A3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-9E   (hex)		Beijing Enter-Net co.LTD
+00089E     (base 16)		Beijing Enter-Net co.LTD
+				NO 1 courtyard,
+				Beijing    100085
+				US
+
+00-08-B4   (hex)		SYSPOL
+0008B4     (base 16)		SYSPOL
+				4th Fl,SYSPOL B/D, Bangbae 4 Dong, Seoch
+				Seoul    137-064
+				US
+
+00-08-B3   (hex)		Fastwel
+0008B3     (base 16)		Fastwel
+				Profsoyuznaya 108,
+				Moscow    117313
+				RU
+
+00-08-8E   (hex)		Nihon Computer Co., Ltd.
+00088E     (base 16)		Nihon Computer Co., Ltd.
+				36-8 Higashitamachi
+				Hamamatsu  Shizuoka  430-0915
+				JP
+
+00-08-DA   (hex)		SofaWare Technologies Ltd.
+0008DA     (base 16)		SofaWare Technologies Ltd.
+				3 Hilazon St.
+				Ramat-Gan    52522
+				IL
+
+00-07-D5   (hex)		3e Technologies Int;., Inc.
+0007D5     (base 16)		3e Technologies Int;., Inc.
+				15800 Crabbs Branch Way
+				Rockville  MD  20855
+				US
+
+00-07-DB   (hex)		Kirana Networks, Inc.
+0007DB     (base 16)		Kirana Networks, Inc.
+				331 Newman Springs Road
+				Red Bank  NJ  07701
+				US
+
+00-08-6A   (hex)		Securiton Gmbh
+00086A     (base 16)		Securiton Gmbh
+				Von-Drais-Strasse 33
+				Achern    D-77855
+				DE
+
+00-08-63   (hex)		Entrisphere Inc.
+000863     (base 16)		Entrisphere Inc.
+				1601 S. De Anza Blvd.
+				Cupertino  CA  95014
+				US
+
+00-08-66   (hex)		DSX Access Systems, Inc.
+000866     (base 16)		DSX Access Systems, Inc.
+				10731 Rockwall Rd.
+				Dallas  TX  75238
+				US
+
+00-07-EF   (hex)		Lockheed Martin Tactical Systems
+0007EF     (base 16)		Lockheed Martin Tactical Systems
+				3333 Pilot Knob Road
+				Eagan  MN  55121
+				US
+
+00-07-F4   (hex)		Eletex Co., Ltd.
+0007F4     (base 16)		Eletex Co., Ltd.
+				8-2-56 Nankou-Higashi Suminoe-ku
+				    
+				JP
+
+00-07-DD   (hex)		Cradle Technologies
+0007DD     (base 16)		Cradle Technologies
+				3130 West Warren Ave.
+				Fremont  CA  94538
+				US
+
+00-08-1B   (hex)		Windigo Systems
+00081B     (base 16)		Windigo Systems
+				2210 O'Toole Ave. #200
+				San Jose  CA  95131
+				US
+
+00-07-FF   (hex)		Gluon Networks
+0007FF     (base 16)		Gluon Networks
+				5401 Old Redwood Hwy.
+				Petaluma  CA  94954
+				US
+
+00-07-F7   (hex)		Galtronics
+0007F7     (base 16)		Galtronics
+				4645 East Cotton Center Blvd.
+				Phoenix  AZ  85040
+				US
+
+00-08-5F   (hex)		Picanol N.V.
+00085F     (base 16)		Picanol N.V.
+				Polenlaan 3-7
+				    
+				BE
+
+00-08-52   (hex)		Davolink Co. Inc.
+000852     (base 16)		Davolink Co. Inc.
+				Room-604, Kumhwa Plaza,
+				Kyunggi-Do    435-040
+				KR
+
+00-08-0C   (hex)		VDA Elettronica spa
+00080C     (base 16)		VDA Elettronica spa
+				Viale Lino Zanussi, 3
+				33170  Pordenone  
+				IT
+
+00-08-04   (hex)		ICA Inc.
+000804     (base 16)		ICA Inc.
+				542-1 Noguki
+				    
+				JP
+
+00-08-57   (hex)		Polaris Networks, Inc.
+000857     (base 16)		Polaris Networks, Inc.
+				6810 Santa Teresa Blvd.
+				San Jose  CA  95119
+				US
+
+00-07-8B   (hex)		Wegener Communications, Inc.
+00078B     (base 16)		Wegener Communications, Inc.
+				11350 Technology Circle
+				Duluth  GA  30097
+				US
+
+00-07-83   (hex)		SynCom Network, Inc.
+000783     (base 16)		SynCom Network, Inc.
+				4F, No. 31, Hsintai Road, Chupei City,
+				    
+				TW
+
+00-07-87   (hex)		Idea System Co., Ltd.
+000787     (base 16)		Idea System Co., Ltd.
+				4-1-21 Shinmei-cho Okaya-shi
+				    
+				JP
+
+00-07-89   (hex)		Allradio Co., Ltd
+000789     (base 16)		Allradio Co., Ltd
+				861-5, Gwanyang-Dong, Dongan-Gu,
+				Anyang-si, Gyeonggi-do,    430-803
+				KR
+
+00-07-B9   (hex)		Ginganet Corporation
+0007B9     (base 16)		Ginganet Corporation
+				Kintetsu Shin Namba Building
+				Osaka Shi    1556-0017
+				JP
+
+00-04-7F   (hex)		Chr. Mayr GmbH & Co. KG
+00047F     (base 16)		Chr. Mayr GmbH & Co. KG
+				Eichenstraße 1
+				    
+				DE
+
+00-04-7B   (hex)		Schlumberger
+00047B     (base 16)		Schlumberger
+				Sugar Land Product Center
+				Sugar Land  TX  77478
+				US
+
+00-07-B4   (hex)		Cisco Systems, Inc
+0007B4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-B3   (hex)		Cisco Systems, Inc
+0007B3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-B5   (hex)		Any One Wireless Ltd.
+0007B5     (base 16)		Any One Wireless Ltd.
+				Namseoul Bd., 8F, 1304-3
+				Seoul    
+				KR
+
+00-07-85   (hex)		Cisco Systems, Inc
+000785     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-75   (hex)		Valence Semiconductor, Inc.
+000775     (base 16)		Valence Semiconductor, Inc.
+				41 Discovery
+				Irvine  CA  92618
+				US
+
+00-07-93   (hex)		Shin Satellite Public Company Limited
+000793     (base 16)		Shin Satellite Public Company Limited
+				41/103  Rattanathibet Road,
+				    
+				TH
+
+00-07-96   (hex)		LSI Systems, Inc.
+000796     (base 16)		LSI Systems, Inc.
+				10-1 Minami-kurokawa,
+				Kanagawa    215-0034
+				JP
+
+00-07-7F   (hex)		J Communications Co., Ltd.
+00077F     (base 16)		J Communications Co., Ltd.
+				124-4 Ojeon-Dong, Ulwang-City
+				    
+				KR
+
+00-07-71   (hex)		Embedded System Corporation
+000771     (base 16)		Embedded System Corporation
+				13-5, Takadanobaba 3-chome,
+				    
+				JP
+
+00-07-70   (hex)		Ubiquoss Inc
+000770     (base 16)		Ubiquoss Inc
+				Ubiquoss B/D, 68, Pangyo-ro 255beon-gil,
+				    
+				KR
+
+00-07-D1   (hex)		Spectrum Signal Processing Inc.
+0007D1     (base 16)		Spectrum Signal Processing Inc.
+				#200-2700 Production Way
+				    
+				CA
+
+00-07-A2   (hex)		Opteon Corporation
+0007A2     (base 16)		Opteon Corporation
+				70 Hastings Street
+				Wellesley  MA  02481
+				US
+
+00-06-F8   (hex)		The Boeing Company
+0006F8     (base 16)		The Boeing Company
+				5731 W. Las Positas Blvd.
+				Pleasanton  CA  94588
+				US
+
+00-06-FB   (hex)		Hitachi Printing Solutions, Ltd.
+0006FB     (base 16)		Hitachi Printing Solutions, Ltd.
+				1060, Takeda Hitachinaka-City
+				    312-8502
+				JP
+
+00-06-FC   (hex)		Fnet Co., Ltd.
+0006FC     (base 16)		Fnet Co., Ltd.
+				KFSB Bldg. 10th F. 16-2
+				Seoul    
+				KR
+
+00-06-F4   (hex)		Prime Electronics & Satellitics Inc.
+0006F4     (base 16)		Prime Electronics & Satellitics Inc.
+				69,Tung-Yuan Rd
+				Chung-Li City  Tao-Yuan County  32000
+				TW
+
+00-07-38   (hex)		Young Technology Co., Ltd.
+000738     (base 16)		Young Technology Co., Ltd.
+				D-604, Sigma-II Officetel,
+				Sungnam-si,  Kyeonggi-do  763-741
+				KR
+
+00-07-29   (hex)		Kistler Instrumente AG
+000729     (base 16)		Kistler Instrumente AG
+				Eulachstrasse 22
+				    
+				CH
+
+00-07-2A   (hex)		Innovance Networks
+00072A     (base 16)		Innovance Networks
+				19 Fairmont Avenue
+				    
+				CA
+
+00-07-4A   (hex)		Carl Valentin GmbH
+00074A     (base 16)		Carl Valentin GmbH
+				Neckarstrabe 78-80
+				    
+				DE
+
+00-07-3C   (hex)		Telecom Design
+00073C     (base 16)		Telecom Design
+				Voie Romaine, Zone de Remora
+				    
+				FR
+
+00-07-36   (hex)		Data Video Technologies Co., Ltd.
+000736     (base 16)		Data Video Technologies Co., Ltd.
+				7F, No. 352, Sec. 2
+				Taipei Hsien    
+				TW
+
+00-07-50   (hex)		Cisco Systems, Inc
+000750     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-42   (hex)		Ormazabal
+000742     (base 16)		Ormazabal
+				Parque Tecnologico 104
+				48170 Zamudio, Bizkaia    
+				ES
+
+00-07-4B   (hex)		Daihen Corporation
+00074B     (base 16)		Daihen Corporation
+				2-1-11 Tagawa Yodogawa-ku
+				    
+				JP
+
+00-07-64   (hex)		YoungWoo Telecom Co. Ltd.
+000764     (base 16)		YoungWoo Telecom Co. Ltd.
+				3F, Sehwa B/D, 355-1
+				Sungnam-Si  Kyungki-Do  
+				KR
+
+00-07-66   (hex)		Chou Chin Industrial Co., Ltd.
+000766     (base 16)		Chou Chin Industrial Co., Ltd.
+				9F, #35, Chiau An St. Chung Ho City,
+				    
+				TW
+
+00-07-61   (hex)		29530
+000761     (base 16)		29530
+				EPFL - Quartier de l'Innovation
+				Lausanne  CH  1015
+				CH
+
+00-07-55   (hex)		Lafon
+000755     (base 16)		Lafon
+				44 Avenue Victor Meunier
+				 Bassens    33530
+				FR
+
+00-07-59   (hex)		Boris Manufacturing Corp.
+000759     (base 16)		Boris Manufacturing Corp.
+				PO Box 601
+				Castle Point  NY  12511
+				US
+
+00-07-51   (hex)		m-u-t AG
+000751     (base 16)		m-u-t AG
+				Messgeräte für Medizin- und Umwelttechnik
+				Wedel    22880
+				DE
+
+00-07-19   (hex)		Mobiis Co., Ltd.
+000719     (base 16)		Mobiis Co., Ltd.
+				277-1, Shinhwa Bldg. 4F
+				Seoul,    
+				KR
+
+00-07-0D   (hex)		Cisco Systems, Inc
+00070D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-0E   (hex)		Cisco Systems, Inc
+00070E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-0B   (hex)		Novabase SGPS, SA
+00070B     (base 16)		Novabase SGPS, SA
+				Av. D Joao II, Lote 1.03.2.3
+				Lisboa    1998-031
+				PT
+
+00-07-10   (hex)		Adax, Inc.
+000710     (base 16)		Adax, Inc.
+				614 Bancroft Way
+				Berkeley  CA  94556
+				US
+
+00-06-E8   (hex)		Optical Network Testing, Inc.
+0006E8     (base 16)		Optical Network Testing, Inc.
+				55 Merchant St.
+				Honolulu  HI  96813
+				US
+
+00-06-EE   (hex)		Shenyang Neu-era Information & Technology Stock Co., Ltd
+0006EE     (base 16)		Shenyang Neu-era Information & Technology Stock Co., Ltd
+				8/F, the 21st Century Building,
+				Dvlpmnt Zone  Shenyang,  
+				CN
+
+00-06-E2   (hex)		Ceemax Technology Co., Ltd.
+0006E2     (base 16)		Ceemax Technology Co., Ltd.
+				5f-7, 736, Chung Cheng Rd.,
+				    
+				TW
+
+00-06-A5   (hex)		PINON Corp.
+0006A5     (base 16)		PINON Corp.
+				Axis Gotanda Bldg.7F-701
+				Tokyo    141-0031
+				JP
+
+00-06-9D   (hex)		Petards Ltd
+00069D     (base 16)		Petards Ltd
+				390 Princesway, Team Valley
+				Gateshead  Tyne and Wear  NE11 OTU
+				GB
+
+00-06-A8   (hex)		KC Technology, Inc.
+0006A8     (base 16)		KC Technology, Inc.
+				1900 McCarthy Blvd.
+				Milpitas  CA  95035
+				US
+
+00-06-A0   (hex)		Mx Imaging
+0006A0     (base 16)		Mx Imaging
+				2894 Columbia Street
+				Torrance  CA  90503
+				US
+
+00-06-BE   (hex)		Baumer Optronic GmbH
+0006BE     (base 16)		Baumer Optronic GmbH
+				Badstraße 30
+				    
+				DE
+
+00-06-BA   (hex)		Westwave Communications
+0006BA     (base 16)		Westwave Communications
+				463 Aviation Blvd.
+				Santa Rosa  CA  95403
+				US
+
+00-06-C4   (hex)		Piolink Inc.
+0006C4     (base 16)		Piolink Inc.
+				IT Castle 1-401, 550-1 Gasan-dong,
+				Seoul    153-803
+				KR
+
+00-06-B5   (hex)		Source Photonics, Inc.
+0006B5     (base 16)		Source Photonics, Inc.
+				20550 Nordhoff St.
+				Chatsworth  CA  91311
+				US
+
+00-06-8F   (hex)		Telemonitor, Inc.
+00068F     (base 16)		Telemonitor, Inc.
+				9055F Guilford Road
+				Columbia  MD  21046
+				US
+
+00-06-DA   (hex)		ITRAN Communications Ltd.
+0006DA     (base 16)		ITRAN Communications Ltd.
+				1 Azrieli Center,
+				Tel Aviv 67021     67021
+				IL
+
+00-06-D0   (hex)		Elgar Electronics Corp.
+0006D0     (base 16)		Elgar Electronics Corp.
+				9250 Brown Deer Rd.
+				San Diego  CA  92121
+				US
+
+00-06-CC   (hex)		JMI Electronics Co., Ltd.
+0006CC     (base 16)		JMI Electronics Co., Ltd.
+				Nanyang B/D 3F, 25-4
+				Seoul    140-080
+				KR
+
+00-06-BF   (hex)		Accella Technologies Co., Ltd.
+0006BF     (base 16)		Accella Technologies Co., Ltd.
+				Rm 512 No. 680 Gui Ping Rd.
+				Shanghai    200233
+				CN
+
+00-06-90   (hex)		Euracom Communication GmbH
+000690     (base 16)		Euracom Communication GmbH
+				Franklinstraße 14
+				    
+				DE
+
+00-06-E1   (hex)		Techno Trade s.a
+0006E1     (base 16)		Techno Trade s.a
+				732a Chaussee de Bruxelles
+				    
+				BE
+
+00-06-2E   (hex)		Aristos Logic Corp.
+00062E     (base 16)		Aristos Logic Corp.
+				27051 Towne Centre Dr.
+				Foothill Ranch  CA  92610
+				US
+
+00-06-24   (hex)		Gentner Communications Corp.
+000624     (base 16)		Gentner Communications Corp.
+				1825 Research Way
+				Salt Lake City  UT  84119
+				US
+
+00-06-25   (hex)		The Linksys Group, Inc.
+000625     (base 16)		The Linksys Group, Inc.
+				17401 Armstrong Ave.
+				Irvine  CA  92614
+				US
+
+00-06-27   (hex)		Uniwide Technologies, Inc.
+000627     (base 16)		Uniwide Technologies, Inc.
+				Korea Development Bank B/D 5th Flr
+				Taejon  302-122,  
+				KR
+
+00-06-2A   (hex)		Cisco Systems, Inc
+00062A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-2C   (hex)		Bivio Networks
+00062C     (base 16)		Bivio Networks
+				4457 Willow Road,
+				Pleasanton  CA  94588
+				US
+
+00-06-21   (hex)		Hinox, Co., Ltd.
+000621     (base 16)		Hinox, Co., Ltd.
+				15-7 3-chome, Sennin-cho,
+				    193-0835
+				JP
+
+00-06-4E   (hex)		Broad Net Technology Inc.
+00064E     (base 16)		Broad Net Technology Inc.
+				5F, No.58, Lane 188, Rui Kuang Road
+				    
+				TW
+
+00-06-2D   (hex)		TouchStar Technologies, L.L.C.
+00062D     (base 16)		TouchStar Technologies, L.L.C.
+				5147 South Garnett Road
+				Tulsa  OK  74146
+				US
+
+00-06-46   (hex)		ShenZhen XunBao Network Technology Co Ltd
+000646     (base 16)		ShenZhen XunBao Network Technology Co Ltd
+				F3, R2-A Building, South District
+				Shen Zhen    
+				CN
+
+00-06-4B   (hex)		Alexon Co., Ltd.
+00064B     (base 16)		Alexon Co., Ltd.
+				3-207-1 Teramoto,
+				    
+				JP
+
+00-06-3C   (hex)		Intrinsyc Software International Inc.
+00063C     (base 16)		Intrinsyc Software International Inc.
+				885 Dunsmuir Street, Suite 380
+				Vancouver  B.C.  V6C 1N5
+				CA
+
+00-06-30   (hex)		Adtranz Sweden
+000630     (base 16)		Adtranz Sweden
+				Dept. TCC/TH
+				    
+				SE
+
+00-06-37   (hex)		Toptrend-Meta Information (ShenZhen) Inc.
+000637     (base 16)		Toptrend-Meta Information (ShenZhen) Inc.
+				2/F, Bldg. 3, Section A, Nor-East Zone
+				    
+				CN
+
+00-06-1C   (hex)		Hoshino Metal Industries, Ltd.
+00061C     (base 16)		Hoshino Metal Industries, Ltd.
+				645 Yamanokami, Yabutsuka,
+				    379-2302
+				JP
+
+00-06-23   (hex)		MGE UPS Systems France
+000623     (base 16)		MGE UPS Systems France
+				140 Avenue Jean Kuntzmann
+				    
+				FR
+
+00-06-0B   (hex)		Artesyn Embedded Technologies
+00060B     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way Suite 190
+				Tempe  AZ  85282
+				US
+
+00-06-7E   (hex)		WinCom Systems, Inc.
+00067E     (base 16)		WinCom Systems, Inc.
+				10900 World Trade Blvd.
+				Morrisville  NC  27560
+				US
+
+00-06-77   (hex)		SICK AG
+000677     (base 16)		SICK AG
+				Erwin-Sick Str.1
+				Waldkirch    D-79183
+				DE
+
+00-06-66   (hex)		Roving Networks
+000666     (base 16)		Roving Networks
+				809 University Avenue
+				Los Gatos  CA  95032
+				US
+
+00-06-67   (hex)		Tripp Lite
+000667     (base 16)		Tripp Lite
+				1111 W. 35th Street
+				Chicago  IL  60609
+				US
+
+00-06-4D   (hex)		Sencore
+00064D     (base 16)		Sencore
+				3200 Sencore Dr.
+				Sioux Falls  SD  57107
+				US
+
+00-06-60   (hex)		NADEX Co., Ltd.
+000660     (base 16)		NADEX Co., Ltd.
+				1 Omiyamae, Tokushige,
+				Aichi    481-0038
+				JP
+
+00-06-79   (hex)		Konami Corporation
+000679     (base 16)		Konami Corporation
+				11-14-5 Akasaka, Minato-ku,
+				    
+				JP
+
+00-06-6C   (hex)		Robinson Corporation
+00066C     (base 16)		Robinson Corporation
+				12F, No. 278 Ho Ping E. Rd.,
+				Taipei    
+				TW
+
+00-06-15   (hex)		Kimoto Electric Co., Ltd.
+000615     (base 16)		Kimoto Electric Co., Ltd.
+				3-1 Funahashi-Cho,
+				    543-0024
+				JP
+
+00-06-0A   (hex)		Blue2space
+00060A     (base 16)		Blue2space
+				Arstaangsv. 9
+				    
+				SE
+
+00-05-CE   (hex)		Prolink Microsystems Corporation
+0005CE     (base 16)		Prolink Microsystems Corporation
+				6F, No. 349, Yang-Kuang St.
+				Nei-Hu  Taipei,  
+				TW
+
+00-05-C2   (hex)		Soronti, Inc.
+0005C2     (base 16)		Soronti, Inc.
+				12159 Business Park Dr, suite 140
+				Draper  Utah  84020
+				US
+
+00-05-DF   (hex)		Electronic Innovation, Inc.
+0005DF     (base 16)		Electronic Innovation, Inc.
+				12731 Cannington Way SW
+				  Calgary, AB  T2W 1Z7
+				CA
+
+00-05-DE   (hex)		Gi Fone Korea, Inc.
+0005DE     (base 16)		Gi Fone Korea, Inc.
+				Twin Bldg. 4th Fl,
+				Seoul,    
+				KR
+
+00-05-E0   (hex)		Empirix Corp.
+0005E0     (base 16)		Empirix Corp.
+				205 Lowell St.
+				Wilmington  MA  01887
+				US
+
+00-05-D8   (hex)		Arescom, Inc.
+0005D8     (base 16)		Arescom, Inc.
+				3541 Gateway Blvd.
+				Fremont  CA  94538
+				US
+
+00-05-E4   (hex)		Red Lion Controls Inc.
+0005E4     (base 16)		Red Lion Controls Inc.
+				20 Willow Springs Circle
+				York  PA  17402
+				US
+
+00-05-F2   (hex)		Power R, Inc.
+0005F2     (base 16)		Power R, Inc.
+				756 Aloha St.
+				Seattle  WA  98109
+				US
+
+00-05-F3   (hex)		Webyn
+0005F3     (base 16)		Webyn
+				26 Rue Oes Gaudines
+				    
+				FR
+
+00-06-01   (hex)		Otanikeiki Co., Ltd.
+000601     (base 16)		Otanikeiki Co., Ltd.
+				2-10-23 Hikari-Machi
+				    732-0052
+				JP
+
+00-06-05   (hex)		Inncom International, Inc.
+000605     (base 16)		Inncom International, Inc.
+				P.O. Box 1060
+				Old Lyme  CT  06371
+				US
+
+00-05-FA   (hex)		IPOptical, Inc.
+0005FA     (base 16)		IPOptical, Inc.
+				45940 Horseshoe Drive
+				Dulles  VA  20166
+				US
+
+00-05-E5   (hex)		Renishaw PLC
+0005E5     (base 16)		Renishaw PLC
+				New Mills, Wotton-under-Edge
+				    
+				GB
+
+00-05-F5   (hex)		Geospace Technologies
+0005F5     (base 16)		Geospace Technologies
+				7007 Pinemont
+				Houston  TX  77040
+				US
+
+00-05-FD   (hex)		PacketLight Networks Ltd.
+0005FD     (base 16)		PacketLight Networks Ltd.
+				27 Habarzel St.
+				Tel-Aviv    69710
+				IL
+
+00-05-D4   (hex)		FutureSmart Networks, Inc.
+0005D4     (base 16)		FutureSmart Networks, Inc.
+				6155 Almaden Expressway
+				San Jose  CA  95120
+				US
+
+00-05-C4   (hex)		Telect, Inc.
+0005C4     (base 16)		Telect, Inc.
+				2111 N. Molter Road
+				Liberty Lake  WA  99019
+				US
+
+00-05-A3   (hex)		QEI, Inc.
+0005A3     (base 16)		QEI, Inc.
+				60 Fadem Road
+				Springfield  NJ  07081
+				US
+
+00-05-9E   (hex)		Zinwell Corporation
+00059E     (base 16)		Zinwell Corporation
+				7F, No.512, Yuan-Shan Road
+				    
+				TW
+
+00-05-A5   (hex)		KOTT
+0005A5     (base 16)		KOTT
+				Suite 305 Daeha B/D
+				    135-080
+				KR
+
+00-05-B3   (hex)		Asahi-Engineering Co., Ltd.
+0005B3     (base 16)		Asahi-Engineering Co., Ltd.
+				3-6-12-2 Gakuenhigashi-cho
+				Tokyo    187-0043
+				JP
+
+00-05-9D   (hex)		Daniel Computing Systems, Inc.
+00059D     (base 16)		Daniel Computing Systems, Inc.
+				3208 8th Avenue NE #118
+				    T2A 7V8
+				CA
+
+00-05-A4   (hex)		Lucid Voice Ltd.
+0005A4     (base 16)		Lucid Voice Ltd.
+				5 Jabotinski Street
+				    
+				IL
+
+00-05-63   (hex)		J-Works, Inc.
+000563     (base 16)		J-Works, Inc.
+				12328 Gladstone St. #1
+				Sylmor  CA  91342
+				US
+
+00-05-57   (hex)		Agile TV Corporation
+000557     (base 16)		Agile TV Corporation
+				333 Ravenswood Ave.,
+				Menlo Park  CA  94025
+				US
+
+00-05-5B   (hex)		Charles Industries, Ltd.
+00055B     (base 16)		Charles Industries, Ltd.
+				5600 Apollo Dr.
+				Rolling Meadows  IL  60008
+				US
+
+00-05-54   (hex)		Rangestar Wireless
+000554     (base 16)		Rangestar Wireless
+				9565 Soquel Drive, Suite 100
+				Aptos  CA  95003
+				US
+
+00-05-53   (hex)		DVC Company, Inc.
+000553     (base 16)		DVC Company, Inc.
+				10200 Hwy 290 W.
+				Austin  TX  78236
+				US
+
+00-05-66   (hex)		Secui.com Corporation
+000566     (base 16)		Secui.com Corporation
+				17th Fl. Samsung Yeoksam Bldg.
+				Seoul    135-080
+				KR
+
+00-05-6C   (hex)		Hung Chang Co., Ltd.
+00056C     (base 16)		Hung Chang Co., Ltd.
+				1385-14, Juan-Dong,
+				    
+				KR
+
+00-05-5F   (hex)		Cisco Systems, Inc
+00055F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-5D   (hex)		D-LINK SYSTEMS, INC.
+00055D     (base 16)		D-LINK SYSTEMS, INC.
+				53 Discover Dr.
+				Irvine  CA  92618
+				US
+
+00-05-61   (hex)		nac Image Technology, Inc.
+000561     (base 16)		nac Image Technology, Inc.
+				8-7 Sanban-cho, Chiyoda-ku,
+				    
+				JP
+
+00-05-94   (hex)		HMS Industrial Networks
+000594     (base 16)		HMS Industrial Networks
+				PO Box 4126
+				SE30004    SE
+				SE
+
+00-05-6F   (hex)		Innomedia Technologies Pvt. Ltd.
+00056F     (base 16)		Innomedia Technologies Pvt. Ltd.
+				#3278, 12th Main Road
+				    
+				IN
+
+00-05-74   (hex)		Cisco Systems, Inc
+000574     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-67   (hex)		Etymonic Design, Inc.
+000567     (base 16)		Etymonic Design, Inc.
+				41 Byron Avenue
+				    NOL 1GO
+				CA
+
+00-05-65   (hex)		Tailyn Communication Company Ltd.
+000565     (base 16)		Tailyn Communication Company Ltd.
+				No. 62, Lane 205, Nan-San Road,
+				Taoyuan Hsien    
+				TW
+
+00-05-8E   (hex)		Flextronics International GmbH & Co. Nfg. KG
+00058E     (base 16)		Flextronics International GmbH & Co. Nfg. KG
+				Schrackgasse 9-15
+				Kindberg    8650
+				AT
+
+00-05-32   (hex)		Cisco Systems, Inc
+000532     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-36   (hex)		Danam Communications, Inc.
+000536     (base 16)		Danam Communications, Inc.
+				900-3, Hokye-dong, Dongan-gu,
+				    
+				KR
+
+00-05-42   (hex)		Otari, Inc.
+000542     (base 16)		Otari, Inc.
+				4-33-3 Kokuryo-cho,
+				    
+				JP
+
+00-05-37   (hex)		Nets Technology Co., Ltd.
+000537     (base 16)		Nets Technology Co., Ltd.
+				#B1 YungJun Bldg.
+				Seoul 135-090    135-090
+				KR
+
+00-05-7C   (hex)		RCO Security AB
+00057C     (base 16)		RCO Security AB
+				Box 705
+				    
+				SE
+
+00-05-83   (hex)		ImageCom Limited
+000583     (base 16)		ImageCom Limited
+				Cedars Park, Cedars Road,
+				    SL6 1RZ
+				GB
+
+00-05-4B   (hex)		Eaton Automation AG
+00054B     (base 16)		Eaton Automation AG
+				Spinnereistrasse 8
+				St.Gallen    9008 
+				CH
+
+00-04-C8   (hex)		LIBA Maschinenfabrik GmbH
+0004C8     (base 16)		LIBA Maschinenfabrik GmbH
+				PO Box 1120
+				    
+				DE
+
+00-04-CC   (hex)		Peek Traffic B.V.
+0004CC     (base 16)		Peek Traffic B.V.
+				Postbus 2542
+				  The  
+				NL
+
+00-04-BF   (hex)		VersaLogic Corp.
+0004BF     (base 16)		VersaLogic Corp.
+				12100 SW Tualatin Rd
+				Tualatin  OR  97062
+				US
+
+00-04-C3   (hex)		CASTOR Informatique
+0004C3     (base 16)		CASTOR Informatique
+				2, Rue Du Kefir
+				94537 Orly  Cedex  
+				FR
+
+00-04-F6   (hex)		Amphus
+0004F6     (base 16)		Amphus
+				2372 Qume Drive, #F
+				San Jose  CA  95131
+				US
+
+00-04-F4   (hex)		Infinite Electronics Inc.
+0004F4     (base 16)		Infinite Electronics Inc.
+				No.478-1, Sec 2
+				    
+				TW
+
+00-04-F1   (hex)		WhereNet
+0004F1     (base 16)		WhereNet
+				107 W. McKinney Avenue
+				Rogersville  TN  37857
+				US
+
+00-05-21   (hex)		Control Microsystems
+000521     (base 16)		Control Microsystems
+				48 Steacie Drive
+				Ottawa  Ontario  K2K 2A9
+				CA
+
+00-05-23   (hex)		AVL List GmbH
+000523     (base 16)		AVL List GmbH
+				Hans List Platz 1
+				Graz    8020
+				AT
+
+00-05-1F   (hex)		Taijin Media Co., Ltd.
+00051F     (base 16)		Taijin Media Co., Ltd.
+				640-8 Tungchon-Dong
+				Seoul    157-030
+				KR
+
+00-05-0C   (hex)		Network Photonics, Inc.
+00050C     (base 16)		Network Photonics, Inc.
+				451 Aviation Boulevard
+				Santa Rosa  CA  95403
+				US
+
+00-04-EC   (hex)		Memobox SA
+0004EC     (base 16)		Memobox SA
+				1, Place Dame Suzanne
+				    
+				FR
+
+00-04-E4   (hex)		Daeryung Ind., Inc.
+0004E4     (base 16)		Daeryung Ind., Inc.
+				#219-6, Kasan Dong,
+				Seoul  Seoul  KOREA
+				KR
+
+00-05-0A   (hex)		ICS Spa
+00050A     (base 16)		ICS Spa
+				Via Romano AL
+				    
+				IT
+
+00-05-11   (hex)		Complementary Technologies Ltd
+000511     (base 16)		Complementary Technologies Ltd
+				Comtech House, 28 Manchester Road
+				    BL5 3QJ
+				GB
+
+00-05-06   (hex)		Reddo Networks AB
+000506     (base 16)		Reddo Networks AB
+				Livdjursgatan 4
+				    
+				SE
+
+00-04-E2   (hex)		SMC Networks, Inc.
+0004E2     (base 16)		SMC Networks, Inc.
+				6 Hughes
+				Irvine  CA  92618
+				US
+
+00-04-CB   (hex)		Tdsoft Communication, Ltd.
+0004CB     (base 16)		Tdsoft Communication, Ltd.
+				60 Medinat Hayehudim St.
+				    
+				IL
+
+00-05-26   (hex)		IPAS GmbH
+000526     (base 16)		IPAS GmbH
+				Hölscherstr. 27
+				    
+				DE
+
+00-04-67   (hex)		Wuhan Research Institute of MII
+000467     (base 16)		Wuhan Research Institute of MII
+				88 Youkeyuan Road,
+				430074  430074  P.R.CHINA
+				CN
+
+00-04-5A   (hex)		The Linksys Group, Inc.
+00045A     (base 16)		The Linksys Group, Inc.
+				17401 Armstrong Ave.
+				Irvine  CA  92614
+				US
+
+00-04-63   (hex)		Bosch Security Systems
+000463     (base 16)		Bosch Security Systems
+				850 Greenfield Road
+				Lancaster  PA  17601-5874
+				US
+
+00-04-5C   (hex)		Mobiwave Pte Ltd
+00045C     (base 16)		Mobiwave Pte Ltd
+				Blk 16, Kallang Place
+				    339156
+				SG
+
+00-04-53   (hex)		YottaYotta, Inc.
+000453     (base 16)		YottaYotta, Inc.
+				6020- 104 Street
+				Edmonton, AB    T6H 5S4
+				CA
+
+00-04-50   (hex)		DMD Computers SRL
+000450     (base 16)		DMD Computers SRL
+				Via Monviso, 14
+				    
+				IT
+
+00-04-43   (hex)		Agilent Technologies, Inc.
+000443     (base 16)		Agilent Technologies, Inc.
+				5301 Stevens Creek Boulevard
+				Santa Clara  CA  95051
+				US
+
+00-04-49   (hex)		Mapletree Networks
+000449     (base 16)		Mapletree Networks
+				315 Norwood Park South
+				Norwood  MA  02062
+				US
+
+00-04-2F   (hex)		International Communications Products, Inc.
+00042F     (base 16)		International Communications Products, Inc.
+				4325 Woodland Park Drive
+				West Melbourne  FL  32904
+				US
+
+00-04-29   (hex)		Pixord Corporation
+000429     (base 16)		Pixord Corporation
+				6F, No. 12, Innovation 1st Rd.,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-04-26   (hex)		Autosys
+000426     (base 16)		Autosys
+				202 Ilsinpastel,
+				Seoul  Seoul  KOREA
+				KR
+
+00-04-B8   (hex)		Kumahira Co., Ltd.
+0004B8     (base 16)		Kumahira Co., Ltd.
+				4-34 Ujinahigashi 2-Chome
+				  JAPAN  734-8567
+				JP
+
+00-04-B5   (hex)		Equitrac Corporation
+0004B5     (base 16)		Equitrac Corporation
+				1905 N.W. 82nd Avenue
+				Miami  FL  33126
+				US
+
+00-04-B1   (hex)		Signal Technology, Inc.
+0004B1     (base 16)		Signal Technology, Inc.
+				3rd. Fl. Dabo Bldg.
+				Seoul  KOREA  138-110
+				KR
+
+00-04-51   (hex)		Medrad, Inc.
+000451     (base 16)		Medrad, Inc.
+				One Medrad Drive
+				Indianola  PA  15051
+				US
+
+00-04-83   (hex)		Deltron Technology, Inc.
+000483     (base 16)		Deltron Technology, Inc.
+				8F-3, No. 125, Lane 235
+				Taipei  TAIWAN,  R.O.C.
+				TW
+
+00-04-41   (hex)		Half Dome Systems, Inc.
+000441     (base 16)		Half Dome Systems, Inc.
+				155 B-1 Moffet Park Drive
+				Sunnyvale  CA  94089
+				US
+
+00-04-A5   (hex)		Barco Projection Systems NV
+0004A5     (base 16)		Barco Projection Systems NV
+				Noordlaan 5
+				    
+				BE
+
+00-04-82   (hex)		Medialogic Corp.
+000482     (base 16)		Medialogic Corp.
+				0-3, Toyamaken-Sangyou
+				    
+				JP
+
+00-03-CA   (hex)		MTS Systems Corp.
+0003CA     (base 16)		MTS Systems Corp.
+				3001 Sheldon Drive
+				Cary,  NC  27513
+				US
+
+00-03-C7   (hex)		hopf Elektronik GmbH
+0003C7     (base 16)		hopf Elektronik GmbH
+				Nottebohmstraße 41
+				58511  Lüdenscheid  
+				DE
+
+00-03-C2   (hex)		Solphone K.K.
+0003C2     (base 16)		Solphone K.K.
+				2-11-1 Kandatsukasa-cho
+				  101-0048  
+				JP
+
+00-03-F3   (hex)		Dazzle Multimedia, Inc.
+0003F3     (base 16)		Dazzle Multimedia, Inc.
+				47211 Bayside Parkway
+				Fremont  CA  94538
+				US
+
+00-03-EC   (hex)		ICG Research, Inc.
+0003EC     (base 16)		ICG Research, Inc.
+				775 B The Queens Way
+				M8Z  1N1  
+				CA
+
+00-03-E9   (hex)		Akara Canada, Inc.
+0003E9     (base 16)		Akara Canada, Inc.
+				150 Katimavik Road
+				CANADA  K2L  2N2
+				CA
+
+00-03-E5   (hex)		Hermstedt SG
+0003E5     (base 16)		Hermstedt SG
+				Carl-Reuther - Str. 3
+				    
+				DE
+
+00-04-21   (hex)		Ocular Networks
+000421     (base 16)		Ocular Networks
+				12700, Fair Lakes Circle
+				Fairfax  VA  22033
+				US
+
+00-04-24   (hex)		TMC s.r.l.
+000424     (base 16)		TMC s.r.l.
+				202 Via A. Costa
+				    
+				IT
+
+00-04-1D   (hex)		Corega of America
+00041D     (base 16)		Corega of America
+				P.O. Box 159
+				Bothell  WA  98041-0159
+				US
+
+00-04-1A   (hex)		Ines Test and Measurement GmbH & CoKG
+00041A     (base 16)		Ines Test and Measurement GmbH & CoKG
+				An der Mühlenaue 5
+				  Bad Nenndorf  31542
+				DE
+
+00-04-1E   (hex)		Shikoku Instrumentation Co., Ltd.
+00041E     (base 16)		Shikoku Instrumentation Co., Ltd.
+				777, Oosachou, Zentsuujishi,
+				    
+				JP
+
+00-04-13   (hex)		snom technology GmbH
+000413     (base 16)		snom technology GmbH
+				Wittestr 30 G
+				Berlin    13509
+				DE
+
+00-03-B4   (hex)		Macrotek International Corp.
+0003B4     (base 16)		Macrotek International Corp.
+				2F, No. 28, Lane 46
+				Taipei  Taipei  TAIWAN
+				TW
+
+00-03-A6   (hex)		Traxit Technology, Inc.
+0003A6     (base 16)		Traxit Technology, Inc.
+				256 Great Road,
+				Littleton  MA  01461
+				US
+
+00-03-A4   (hex)		Imation Corp.
+0003A4     (base 16)		Imation Corp.
+				1 Imation Place
+				Oakdale  MN  55128-3414
+				US
+
+00-03-AB   (hex)		Bridge Information Systems
+0003AB     (base 16)		Bridge Information Systems
+				717 Office Parkway
+				St. Louis  MO  63141
+				US
+
+00-04-03   (hex)		Nexsi Corporation
+000403     (base 16)		Nexsi Corporation
+				1959 Concourse Drive
+				San Jose  CA  95131
+				US
+
+00-04-06   (hex)		Fa. Metabox AG
+000406     (base 16)		Fa. Metabox AG
+				Daimlerring 37,
+				    
+				DE
+
+00-03-F8   (hex)		SanCastle Technologies, Inc.
+0003F8     (base 16)		SanCastle Technologies, Inc.
+				2107 North First Street
+				San Jose  CA  95131
+				US
+
+00-03-FA   (hex)		TiMetra Networks
+0003FA     (base 16)		TiMetra Networks
+				500 Ellis St.
+				Mountain View  CA  94043
+				US
+
+00-03-C6   (hex)		ICUE Systems, Inc.
+0003C6     (base 16)		ICUE Systems, Inc.
+				17489 Gale Avenue
+				City of Industry  CA  91748
+				US
+
+00-03-BB   (hex)		Signal Communications Limited
+0003BB     (base 16)		Signal Communications Limited
+				Unit 217, 2/F, HKITC,
+				  HONG  KONG
+				HK
+
+00-03-BE   (hex)		Netility
+0003BE     (base 16)		Netility
+				298 South Sunnyvale Ave.
+				Sunnyvale  CA  94086
+				US
+
+00-03-DF   (hex)		Desana Systems
+0003DF     (base 16)		Desana Systems
+				1805 McCandless Ave.
+				Milpitas  CA  95035
+				US
+
+00-03-DA   (hex)		Takamisawa Cybernetics Co., Ltd.
+0003DA     (base 16)		Takamisawa Cybernetics Co., Ltd.
+				Nakano Heiwa Bldg.
+				    
+				JP
+
+00-03-D9   (hex)		Secheron SA
+0003D9     (base 16)		Secheron SA
+				Untermattweg 8
+				    
+				CH
+
+00-03-FB   (hex)		ENEGATE Co.,Ltd.
+0003FB     (base 16)		ENEGATE Co.,Ltd.
+				3-14-40 Senrioka,
+				Settsu-city  Osaka  566-8686
+				JP
+
+00-03-F6   (hex)		Allegro Networks, Inc.
+0003F6     (base 16)		Allegro Networks, Inc.
+				6399 San Ignacio Avenue
+				San Jose  CA  95119
+				US
+
+00-04-15   (hex)		Rasteme Systems Co., Ltd.
+000415     (base 16)		Rasteme Systems Co., Ltd.
+				886-2 Nihongi Nakagou-mura
+				    
+				JP
+
+00-03-98   (hex)		WISI
+000398     (base 16)		WISI
+				Wilhelm-Sihn-Str. 5-7
+				D-75223  Niefern-Oeschelbronn  
+				DE
+
+00-03-95   (hex)		California Amplifier
+000395     (base 16)		California Amplifier
+				460 Calle San Pablo
+				Camarillo  CA  93012
+				US
+
+00-03-92   (hex)		Hyundai Teletek Co., Ltd.
+000392     (base 16)		Hyundai Teletek Co., Ltd.
+				B-501, Techno Park, 148 Yatap-dong,
+				  KOREA  Republic
+				KR
+
+00-03-8E   (hex)		Atoga Systems, Inc.
+00038E     (base 16)		Atoga Systems, Inc.
+				49026 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-03-1A   (hex)		Beijing Broad Telecom Ltd., China
+00031A     (base 16)		Beijing Broad Telecom Ltd., China
+				P.O. Box #147
+				Beijing    100876
+				CN
+
+00-03-5B   (hex)		BridgeWave Communications
+00035B     (base 16)		BridgeWave Communications
+				3350 Thomad Road
+				Santa Clara  CA  95054
+				US
+
+00-03-57   (hex)		Intervoice-Brite, Inc.
+000357     (base 16)		Intervoice-Brite, Inc.
+				17811 Waterview Pkwy.
+				Dallas  TX  75252
+				US
+
+00-03-7F   (hex)		Atheros Communications, Inc.
+00037F     (base 16)		Atheros Communications, Inc.
+				5480 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+00-02-F0   (hex)		AME Optimedia Technology Co., Ltd.
+0002F0     (base 16)		AME Optimedia Technology Co., Ltd.
+				17F-2, 79 Hsin Tai Wu Road, Sec. 1,
+				    
+				TW
+
+00-03-9E   (hex)		Tera System Co., Ltd.
+00039E     (base 16)		Tera System Co., Ltd.
+				Doosung B/F Rm 302
+				Republic  of  Korea
+				KR
+
+00-03-97   (hex)		FireBrick Limited
+000397     (base 16)		FireBrick Limited
+				C/O Andrews & Arnold Ltd, 
+				Enterprise Court, Downmill Road  Bracknell, Berks  RG12 1QS
+				GB
+
+00-03-3F   (hex)		BigBand Networks, Ltd.
+00033F     (base 16)		BigBand Networks, Ltd.
+				3 Azrieli Towers
+				    
+				IL
+
+00-03-27   (hex)		ACT'L
+000327     (base 16)		ACT'L
+				Avenue de Artisanat 10A
+				    
+				BE
+
+00-03-2E   (hex)		Scope Information Management, Ltd.
+00032E     (base 16)		Scope Information Management, Ltd.
+				2F Chanwoo b/o 736 Youksang-dong,
+				Seoul    135-080
+				KR
+
+00-03-7C   (hex)		Coax Media
+00037C     (base 16)		Coax Media
+				1220 Oak Industrial Lane
+				Cumming  GA  30041
+				US
+
+00-03-68   (hex)		Embedone Co., Ltd.
+000368     (base 16)		Embedone Co., Ltd.
+				Fl. 9 Annex Samhwan B/D. 17-26
+				Seoul    150-01
+				KR
+
+00-03-45   (hex)		Routrek Networks Corporation
+000345     (base 16)		Routrek Networks Corporation
+				Nilssei Shin Mizonokuchi Bldg. 1F
+				  23-0011  
+				JP
+
+00-02-C8   (hex)		Technocom Communications Technology (pte) Ltd
+0002C8     (base 16)		Technocom Communications Technology (pte) Ltd
+				189 Kaki Buckit Avenue 1
+				  Singapore  416029
+				SG
+
+00-02-B8   (hex)		WHI KONSULT AB
+0002B8     (base 16)		WHI KONSULT AB
+				Scheelegatan 11
+				  Stockholm  SE-112 28
+				SE
+
+00-02-A9   (hex)		RACOM, s.r.o.
+0002A9     (base 16)		RACOM, s.r.o.
+				Mirova 1283, Nove Mesto na Morave
+				592 31  Czech  republic
+				CZ
+
+00-02-BB   (hex)		Continuous Computing Corp
+0002BB     (base 16)		Continuous Computing Corp
+				9380 Carroll Park Drive
+				San Diego  CA  92121
+				US
+
+00-02-BC   (hex)		LVL 7 Systems, Inc.
+0002BC     (base 16)		LVL 7 Systems, Inc.
+				13000 Weston Pkwy
+				Cary  NC  27513
+				US
+
+00-03-0F   (hex)		Digital China (Shanghai) Networks Ltd.
+00030F     (base 16)		Digital China (Shanghai) Networks Ltd.
+				602-23, Haitai Building, 351 Guo Shoujin
+				Shanghai    
+				CN
+
+00-03-11   (hex)		Micro Technology Co., Ltd.
+000311     (base 16)		Micro Technology Co., Ltd.
+				Suehiro Bldg.
+				  101-0021  
+				JP
+
+00-03-0D   (hex)		Uniwill Computer Corp.
+00030D     (base 16)		Uniwill Computer Corp.
+				No. 24, Pei Yuan Rd., Chung
+				Li City    
+				TW
+
+00-03-09   (hex)		Texcel Technology PLC
+000309     (base 16)		Texcel Technology PLC
+				Thames Road
+				  ENGLAND  
+				GB
+
+00-03-03   (hex)		JAMA Electronics Co., Ltd.
+000303     (base 16)		JAMA Electronics Co., Ltd.
+				10F, No. 222-1, Sec. 3
+				Taipei Hsien    
+				TW
+
+00-03-05   (hex)		MSC Vertriebs GmbH
+000305     (base 16)		MSC Vertriebs GmbH
+				Design Center Aachen
+				AACHEN    D-52076
+				DE
+
+00-02-FE   (hex)		Viditec, Inc.
+0002FE     (base 16)		Viditec, Inc.
+				520 Central Parkway E.
+				Plano  TX  75074
+				US
+
+00-01-9F   (hex)		ReadyNet
+00019F     (base 16)		ReadyNet
+				6952 High Tech Drive
+				Midvale  UT  84047
+				US
+
+00-02-FF   (hex)		Handan BroadInfoCom
+0002FF     (base 16)		Handan BroadInfoCom
+				5th Fl. Shinsung Plaza #697-11
+				Seoul    
+				KR
+
+00-02-F4   (hex)		PCTEL, Inc.
+0002F4     (base 16)		PCTEL, Inc.
+				1331 California Circle
+				Milpitas  CA  95035
+				US
+
+00-02-E9   (hex)		CS Systemes De Securite - C3S
+0002E9     (base 16)		CS Systemes De Securite - C3S
+				23, rue de Schwobsheim
+				    
+				FR
+
+00-02-E5   (hex)		Timeware Ltd.
+0002E5     (base 16)		Timeware Ltd.
+				Brookfield Grange
+				Lancs    042 GLB
+				GB
+
+00-02-E0   (hex)		ETAS GmbH
+0002E0     (base 16)		ETAS GmbH
+				Borsigstraße 10
+				    
+				DE
+
+00-02-CE   (hex)		FoxJet, Inc.
+0002CE     (base 16)		FoxJet, Inc.
+				2016 E. Randal Mill Rd. #409
+				Arlington  TX  76011-8223
+				US
+
+00-02-C3   (hex)		Arelnet Ltd.
+0002C3     (base 16)		Arelnet Ltd.
+				3 Hayarden St.
+				    
+				IL
+
+00-03-16   (hex)		Nobell Communications, Inc.
+000316     (base 16)		Nobell Communications, Inc.
+				3410 Far West Blvd., Suite 240
+				Austin  TX  78731
+				US
+
+00-03-29   (hex)		F3, Inc.
+000329     (base 16)		F3, Inc.
+				2F, No. 7, Industry E. Rd. 9,
+				Hsinchu    
+				TW
+
+00-03-21   (hex)		Reco Research Co., Ltd.
+000321     (base 16)		Reco Research Co., Ltd.
+				No. 47-1, Sec. 2,
+				    
+				TW
+
+00-02-F5   (hex)		VIVE Synergies, Inc.
+0002F5     (base 16)		VIVE Synergies, Inc.
+				30 West Beaver Creek Road, Unit 101
+				    L4B 3K1
+				CA
+
+00-02-D5   (hex)		ACR
+0002D5     (base 16)		ACR
+				Cardoulines B2
+				    
+				FR
+
+00-02-AB   (hex)		CTC Union Technologies Co., Ltd.
+0002AB     (base 16)		CTC Union Technologies Co., Ltd.
+				8F No. 60 Zhouzi St.
+				Neihu  Taipei  114
+				TW
+
+00-02-A4   (hex)		AddPac Technology Co., Ltd.
+0002A4     (base 16)		AddPac Technology Co., Ltd.
+				3F Jeoung Am Bldg., 769-12
+				Seoul  Seoul  Korea
+				KR
+
+00-02-A3   (hex)		ABB Switzerland Ltd, Power Systems
+0002A3     (base 16)		ABB Switzerland Ltd, Power Systems
+				Bruggerstrasse 72
+				Baden    
+				CH
+
+00-02-A0   (hex)		Flatstack Ltd.
+0002A0     (base 16)		Flatstack Ltd.
+				1112 Budapest
+				    
+				HU
+
+00-02-B2   (hex)		Cablevision
+0002B2     (base 16)		Cablevision
+				420 Crossways Park Drive West
+				Woodbury  NY  11787
+				US
+
+00-02-B7   (hex)		Watanabe Electric Industry Co., Ltd.
+0002B7     (base 16)		Watanabe Electric Industry Co., Ltd.
+				6-16-19, Jingumae, Shibuya-ku
+				    
+				JP
+
+00-02-AF   (hex)		TeleCruz Technology, Inc.
+0002AF     (base 16)		TeleCruz Technology, Inc.
+				2391 Qume Dr.
+				San Jose  CA  95131
+				US
+
+00-02-A8   (hex)		Air Link Technology
+0002A8     (base 16)		Air Link Technology
+				Bethel Bldg. 303
+				Seoul  KOREA  137-130
+				KR
+
+00-02-6A   (hex)		Cocess Telecom Co., Ltd.
+00026A     (base 16)		Cocess Telecom Co., Ltd.
+				Research & Development Dept.
+				Seoul  Seoul  KOREA
+				KR
+
+00-02-6C   (hex)		Philips CFT
+00026C     (base 16)		Philips CFT
+				Building SAN 6
+				  The  
+				NL
+
+00-02-62   (hex)		Soyo Group Soyo Com Tech Co., Ltd
+000262     (base 16)		Soyo Group Soyo Com Tech Co., Ltd
+				5H. No. 21 Wu-gong 5 Rd,
+				Taipei Hsien  Taiwan  R.O.C.
+				TW
+
+00-02-65   (hex)		Virditech Co. Ltd.
+000265     (base 16)		Virditech Co. Ltd.
+				Hyundai Topics Blgd., 11th Fl
+				Seoul  Seoul  KOREA
+				KR
+
+00-02-5B   (hex)		Cambridge Silicon Radio
+00025B     (base 16)		Cambridge Silicon Radio
+				Unit 400, Science Park,
+				  United  Kingdom
+				GB
+
+00-02-56   (hex)		Alpha Processor, Inc.
+000256     (base 16)		Alpha Processor, Inc.
+				130 C Baker Ave. Ext.
+				Concord  MA  01742
+				US
+
+00-02-59   (hex)		Tsann Kuen China (Shanghai)Enterprise Co., Ltd. IT Group
+000259     (base 16)		Tsann Kuen China (Shanghai)Enterprise Co., Ltd. IT Group
+				8F, #99, Huaihai Rd, East,
+				  CHINA  200021
+				CN
+
+00-02-94   (hex)		Tokyo Sokushin Co., Ltd.
+000294     (base 16)		Tokyo Sokushin Co., Ltd.
+				5-16-12 Nishi-Nippori
+				    
+				JP
+
+00-02-96   (hex)		Lectron Co,. Ltd.
+000296     (base 16)		Lectron Co,. Ltd.
+				9F, No.171, Sec. 2, Tatung Rd.,
+				Taiwan  Taiwan  R.O.C.
+				TW
+
+00-02-8E   (hex)		Rapid 5 Networks, Inc.
+00028E     (base 16)		Rapid 5 Networks, Inc.
+				180 Baytech Drive
+				San Jose  CA  95134-2302
+				US
+
+00-02-4F   (hex)		IPM Datacom S.R.L.
+00024F     (base 16)		IPM Datacom S.R.L.
+				Via Roma, 231
+				  Naples  
+				IT
+
+00-02-71   (hex)		Zhone Technologies
+000271     (base 16)		Zhone Technologies
+				7001 Oakport Street
+				Oakland  CA  94621
+				US
+
+00-02-8A   (hex)		Ambit Microsystems Corporation
+00028A     (base 16)		Ambit Microsystems Corporation
+				5F-1, 5 Hsin-An Road Hsinchu,
+				    TAIWAN
+				TW
+
+00-01-FA   (hex)		HOROSCAS
+0001FA     (base 16)		HOROSCAS
+				26, LOUIS BLANC
+				    
+				FR
+
+00-02-82   (hex)		ViaClix, Inc.
+000282     (base 16)		ViaClix, Inc.
+				1400 Dell Ave., Suite B
+				Campbell  CA  95008
+				US
+
+00-02-85   (hex)		Riverstone Networks
+000285     (base 16)		Riverstone Networks
+				5200 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+00-02-79   (hex)		Control Applications, Ltd.
+000279     (base 16)		Control Applications, Ltd.
+				3 Tevuot Haarets St.
+				    
+				IL
+
+00-02-51   (hex)		Soma Networks, Inc.
+000251     (base 16)		Soma Networks, Inc.
+				650 Townsend St.
+				San Francisco  CA  94103
+				US
+
+00-01-F5   (hex)		ERIM S.A.
+0001F5     (base 16)		ERIM S.A.
+				11 Av Republique
+				    
+				FR
+
+00-01-FF   (hex)		Data Direct Networks, Inc.
+0001FF     (base 16)		Data Direct Networks, Inc.
+				9320 Lurline Avenue
+				Chatsworth  CA  91311
+				US
+
+00-01-FC   (hex)		Keyence Corporation
+0001FC     (base 16)		Keyence Corporation
+				1-3-14, Higashi-Nakajima,
+				    
+				JP
+
+00-01-FD   (hex)		Digital Voice Systems, Inc.
+0001FD     (base 16)		Digital Voice Systems, Inc.
+				234 Littleton Road
+				Westford  MA  01886
+				US
+
+00-02-10   (hex)		Fenecom
+000210     (base 16)		Fenecom
+				7/F Kon-kuk University Alumni
+				Seoul  Seoul  Korea
+				KR
+
+00-02-0B   (hex)		Native Networks, Inc.
+00020B     (base 16)		Native Networks, Inc.
+				P.O. Box 7165
+				    
+				IL
+
+00-02-18   (hex)		Advanced Scientific Corp
+000218     (base 16)		Advanced Scientific Corp
+				1 Fl., No. 26, Industry East 9th Road
+				    TAIWAN
+				TW
+
+00-01-EE   (hex)		Comtrol Europe, Ltd.
+0001EE     (base 16)		Comtrol Europe, Ltd.
+				The Courtyard Studio
+				    U.K.
+				GB
+
+00-01-F0   (hex)		Tridium, Inc.
+0001F0     (base 16)		Tridium, Inc.
+				3951 Westerre Parkway
+				Richmond  VA  23233
+				US
+
+00-01-F1   (hex)		Innovative Concepts, Inc.
+0001F1     (base 16)		Innovative Concepts, Inc.
+				8200 Greensboro Drive
+				McLean  VA  22102
+				US
+
+00-01-E2   (hex)		Ando Electric Corporation
+0001E2     (base 16)		Ando Electric Corporation
+				19-7, Kamata 4-Chrome, Ota-ku
+				    
+				JP
+
+00-02-2F   (hex)		P-Cube, Ltd.
+00022F     (base 16)		P-Cube, Ltd.
+				P.O. Box 12331
+				    
+				IL
+
+00-02-27   (hex)		ESD Electronic System Design GmbH
+000227     (base 16)		ESD Electronic System Design GmbH
+				Vahrenwalder Str. 207
+				30 165  Hannover  
+				DE
+
+00-02-1D   (hex)		Data General Communication Ltd.
+00021D     (base 16)		Data General Communication Ltd.
+				Rm. 18C, Bldg. C, CEIEC Tower
+				    
+				CN
+
+00-02-19   (hex)		Paralon Technologies
+000219     (base 16)		Paralon Technologies
+				700 Fifth Ave, Suite 6101
+				Seattle  WA  98104
+				US
+
+00-02-03   (hex)		Woonsang Telecom, Inc.
+000203     (base 16)		Woonsang Telecom, Inc.
+				104-9, Munji-Dong, Yusong-Gu
+				    KOREA
+				KR
+
+00-01-D3   (hex)		PAXCOMM, Inc.
+0001D3     (base 16)		PAXCOMM, Inc.
+				7th F The Corp. Center
+				    KOREA
+				KR
+
+00-01-E1   (hex)		Kinpo Electronics, Inc.
+0001E1     (base 16)		Kinpo Electronics, Inc.
+				No.147, Sec. 3, Beishen Rd
+				Shenkeng Dist.  New Taipei City  222
+				TW
+
+00-02-2C   (hex)		ABB Bomem, Inc.
+00022C     (base 16)		ABB Bomem, Inc.
+				585, boul. Charest Est
+				Canada  G1K  9H4
+				CA
+
+00-02-3C   (hex)		Creative Technology, Ltd.
+00023C     (base 16)		Creative Technology, Ltd.
+				31 International Business Park
+				Republic  of  
+				SG
+
+00-30-6C   (hex)		Hitex Holding GmbH
+00306C     (base 16)		Hitex Holding GmbH
+				Greschbachstraße 12
+				76229 Karlsruhe    
+				DE
+
+00-30-8B   (hex)		Brix Networks
+00308B     (base 16)		Brix Networks
+				300 Concord Road
+				Billerica  MA  01821
+				US
+
+00-01-77   (hex)		EDSL
+000177     (base 16)		EDSL
+				Habarzel 1 st
+				  ISRAEL  69710
+				IL
+
+00-01-4D   (hex)		Shin Kin Enterprises Co., Ltd
+00014D     (base 16)		Shin Kin Enterprises Co., Ltd
+				7, FU Hsing St. Tue Cheng Ind.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-01-DA   (hex)		WINCOMM Corporation
+0001DA     (base 16)		WINCOMM Corporation
+				2F, No. 3, Prosperity Road 1,
+				  Hsinchu  Taiwan
+				TW
+
+00-01-D2   (hex)		inXtron, Inc. 
+0001D2     (base 16)		inXtron, Inc. 
+				8F, No.52, MinQuan Road, Xindian Dist.
+				New Taipei City    23141
+				TW
+
+00-01-C6   (hex)		Quarry Technologies
+0001C6     (base 16)		Quarry Technologies
+				8 New England Executive Park
+				Burlington  MA  01803
+				US
+
+00-01-6E   (hex)		Conklin Corporation
+00016E     (base 16)		Conklin Corporation
+				6141 Crooked Creek Road
+				Norcross  GA  30092-3193
+				US
+
+00-01-74   (hex)		CyberOptics Corporation
+000174     (base 16)		CyberOptics Corporation
+				5900 Golden Hills Drive
+				Golden Valley  MN  55416
+				US
+
+00-01-5E   (hex)		BEST TECHNOLOGY CO., LTD.
+00015E     (base 16)		BEST TECHNOLOGY CO., LTD.
+				7F, Haesung B/D
+				    KOREA
+				KR
+
+00-01-61   (hex)		Meta Machine Technology
+000161     (base 16)		Meta Machine Technology
+				400 Silver Cedar Court - ste. #220
+				Chapel Hill  NC  27514
+				US
+
+00-01-A1   (hex)		Mag-Tek, Inc.
+0001A1     (base 16)		Mag-Tek, Inc.
+				1710 Apollo Court
+				Seal Beach  CA  90740
+				US
+
+00-01-86   (hex)		Uwe Disch
+000186     (base 16)		Uwe Disch
+				Eichenhainstraße 14
+				    
+				DE
+
+00-01-A6   (hex)		Scientific-Atlanta Arcodan A/S
+0001A6     (base 16)		Scientific-Atlanta Arcodan A/S
+				Avgustenborg Landevej 7
+				    
+				DK
+
+00-01-72   (hex)		TechnoLand Co., LTD.
+000172     (base 16)		TechnoLand Co., LTD.
+				3-17-11 Akebono-cho
+				    
+				JP
+
+00-01-A0   (hex)		Infinilink Corporation
+0001A0     (base 16)		Infinilink Corporation
+				1740 E. Garry Ave. - Ste. #206
+				Santa Ana  CA  92705
+				US
+
+00-01-96   (hex)		Cisco Systems, Inc
+000196     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-99   (hex)		HeiSei Electronics
+000199     (base 16)		HeiSei Electronics
+				5/7 Alley 8, Lane 45
+				    TAIWAN
+				TW
+
+00-01-8B   (hex)		NetLinks Co., Ltd.
+00018B     (base 16)		NetLinks Co., Ltd.
+				3F Dscom Bldg., 238-3
+				    KOREA
+				KR
+
+00-01-8D   (hex)		AudeSi Technologies
+00018D     (base 16)		AudeSi Technologies
+				Suite 180, 6815
+				  AB  
+				CA
+
+00-01-9D   (hex)		E-Control Systems, Inc.
+00019D     (base 16)		E-Control Systems, Inc.
+				9420 Lurline Ave., Unite
+				Chatsworth  CA  91311
+				US
+
+00-01-CE   (hex)		Custom Micro Products, Ltd.
+0001CE     (base 16)		Custom Micro Products, Ltd.
+				450 Blandford Road
+				  UNITED  KINGDOM
+				GB
+
+00-01-BB   (hex)		Frequentis
+0001BB     (base 16)		Frequentis
+				SPITTELBREITENGASSE 34
+				    
+				AT
+
+00-01-BC   (hex)		Brains Corporation
+0001BC     (base 16)		Brains Corporation
+				2-27-8-4Fl TAMAGAWA
+				    
+				JP
+
+00-01-C0   (hex)		CompuLab, Ltd.
+0001C0     (base 16)		CompuLab, Ltd.
+				P.O. Box 66
+				    
+				IL
+
+00-01-7C   (hex)		AG-E GmbH
+00017C     (base 16)		AG-E GmbH
+				Dennewartstraße 27
+				    
+				DE
+
+00-01-08   (hex)		AVLAB Technology, Inc.
+000108     (base 16)		AVLAB Technology, Inc.
+				3F-1, No. 134, Sec. 3
+				Hsin Tien, Taipei    
+				TW
+
+00-06-2B   (hex)		INTRASERVER TECHNOLOGY
+00062B     (base 16)		INTRASERVER TECHNOLOGY
+				SEVEN OCTOBER HILL RD.
+				HOLLISTON  MA  01746
+				US
+
+00-01-00   (hex)		EQUIP'TRANS
+000100     (base 16)		EQUIP'TRANS
+				31 rue Paul Cezanne
+				LA ROCHETTE    77000
+				FR
+
+00-B0-9D   (hex)		Point Grey Research Inc.
+00B09D     (base 16)		Point Grey Research Inc.
+				305-1847 West Broadway
+				Vancouver  British Columbia V6J 1Y6  
+				CA
+
+00-01-10   (hex)		Gotham Networks
+000110     (base 16)		Gotham Networks
+				15 Discovery Way
+				Acton  MA  01720
+				US
+
+00-01-12   (hex)		Shark Multimedia Inc.
+000112     (base 16)		Shark Multimedia Inc.
+				48890 Milmont Drive  #101-D
+				Fremont  CA  94538
+				US
+
+00-01-16   (hex)		Netspect Technologies, Inc.
+000116     (base 16)		Netspect Technologies, Inc.
+				3945 Freedom Circle - Ste. #360
+				Santa Clara  CA  95054
+				US
+
+00-B0-6D   (hex)		Jones Futurex Inc.
+00B06D     (base 16)		Jones Futurex Inc.
+				3715 Atherton Road
+				Rocklin  CA  95765
+				US
+
+00-B0-94   (hex)		Alaris, Inc.
+00B094     (base 16)		Alaris, Inc.
+				47338 Fremont Boulevard
+				Fremont  CA  94538
+				US
+
+00-30-F0   (hex)		Uniform Industrial Corp.
+0030F0     (base 16)		Uniform Industrial Corp.
+				18F, 171, Shung Teh Road
+				Taipei    
+				TW
+
+00-01-3B   (hex)		BNA SYSTEMS
+00013B     (base 16)		BNA SYSTEMS
+				1637 S. Main Street
+				Milpitas  CA  95035
+				US
+
+00-01-34   (hex)		Selectron Systems AG
+000134     (base 16)		Selectron Systems AG
+				Bernstreasse 70
+				    
+				CH
+
+00-01-39   (hex)		Point Multimedia Systems
+000139     (base 16)		Point Multimedia Systems
+				4Ra 507, Shihwa Industrial Complex
+				  Korea  425-110
+				KR
+
+00-01-3E   (hex)		Ascom Tateco AB
+00013E     (base 16)		Ascom Tateco AB
+				Box 8783
+				    
+				SE
+
+00-01-2E   (hex)		PC Partner Ltd.
+00012E     (base 16)		PC Partner Ltd.
+				Rm 1901-1908, 19/F, Shatin Galleria
+				    
+				CN
+
+00-01-32   (hex)		Dranetz - BMI
+000132     (base 16)		Dranetz - BMI
+				1000 New Durham Road
+				Edison  NJ  08818
+				US
+
+00-01-13   (hex)		OLYMPUS CORPORATION
+000113     (base 16)		OLYMPUS CORPORATION
+				2-3 Kuboyama-cho, Hachioji-shi
+				Tokyo 192-8512    j
+				JP
+
+00-01-1E   (hex)		Precidia Technologies, Inc.
+00011E     (base 16)		Precidia Technologies, Inc.
+				10A Hearst Way
+				Kanata  Ontario K2M-2C4  
+				CA
+
+00-01-55   (hex)		Promise Technology, Inc.
+000155     (base 16)		Promise Technology, Inc.
+				4F, 1, Prosperity 1st Road
+				    TAIWAN
+				TW
+
+00-30-94   (hex)		Cisco Systems, Inc
+003094     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-8A   (hex)		NICOTRA SISTEMI S.P.A
+00308A     (base 16)		NICOTRA SISTEMI S.P.A
+				41 Via Primo Maggio
+				  Baranzate (MI)  20021
+				IT
+
+00-30-72   (hex)		Intellibyte Inc.
+003072     (base 16)		Intellibyte Inc.
+				Canada Trust Tower - BCE Place
+				Toronto  Ontario  M5J 2S1
+				CA
+
+00-30-40   (hex)		Cisco Systems, Inc
+003040     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-32   (hex)		MagicRam, Inc.
+003032     (base 16)		MagicRam, Inc.
+				1850 Beverly Blvd.
+				Los Angeles  CA  90057
+				US
+
+00-30-EA   (hex)		TeraForce Technology Corporation
+0030EA     (base 16)		TeraForce Technology Corporation
+				1100 EXECUTIVE DRIVE
+				RICHARDSON  TX  75081
+				US
+
+00-30-9B   (hex)		Smartware
+00309B     (base 16)		Smartware
+				49 AV Aristide
+				92160 Antony    
+				FR
+
+00-30-45   (hex)		Village Networks, Inc. (VNI)
+003045     (base 16)		Village Networks, Inc. (VNI)
+				100 Village Court - Ste. #301
+				Hazlet  NJ  07730
+				US
+
+00-30-E5   (hex)		Amper Datos S.A.
+0030E5     (base 16)		Amper Datos S.A.
+				C/Marconi n*3  (PTM)
+				28760 Madrid    
+				ES
+
+00-30-06   (hex)		SUPERPOWER COMPUTER
+003006     (base 16)		SUPERPOWER COMPUTER
+				ELECTRONICS CO., LTD.
+				Taipei 248    
+				TW
+
+00-30-38   (hex)		XCP, INC.
+003038     (base 16)		XCP, INC.
+				40 ELM STREET
+				DRYDEN  NY  13053
+				US
+
+00-30-79   (hex)		CQOS, INC.
+003079     (base 16)		CQOS, INC.
+				25 MAUCHLY  - STE. #329
+				IRVINE  CA  92618
+				US
+
+00-30-0C   (hex)		CONGRUENCY, LTD.
+00300C     (base 16)		CONGRUENCY, LTD.
+				23 HASIVIM STREET
+				PETAH-TIKVA 49170    
+				IL
+
+00-30-4C   (hex)		APPIAN COMMUNICATIONS, INC.
+00304C     (base 16)		APPIAN COMMUNICATIONS, INC.
+				80 CENTRAL STREET
+				BOXBOROUGH  MA  01719
+				US
+
+00-30-E8   (hex)		ENSIM CORP.
+0030E8     (base 16)		ENSIM CORP.
+				1215 Terra Bella Ave.
+				Mountainview  CA  94043
+				US
+
+00-30-C9   (hex)		LuxN, N
+0030C9     (base 16)		LuxN, N
+				570 Maude Court
+				Sunnyvale  CA  94086
+				US
+
+00-30-28   (hex)		FASE Saldatura srl
+003028     (base 16)		FASE Saldatura srl
+				V.R. Bernardi 5
+				TORINO    
+				IT
+
+00-30-69   (hex)		IMPACCT TECHNOLOGY CORP.
+003069     (base 16)		IMPACCT TECHNOLOGY CORP.
+				2F, NO. 12, R&D RD. II
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-C3   (hex)		FLUECKIGER ELEKTRONIK AG
+0030C3     (base 16)		FLUECKIGER ELEKTRONIK AG
+				KIRCHBARGSTRASSE 201
+				    
+				CH
+
+00-30-5A   (hex)		TELGEN CORPORATION
+00305A     (base 16)		TELGEN CORPORATION
+				3101 SOVEREIGN DR. - STE.
+				LANSING  MI  48911
+				US
+
+00-30-10   (hex)		VISIONETICS INTERNATIONAL
+003010     (base 16)		VISIONETICS INTERNATIONAL
+				3F, NO. 3, PROSPERITY ROAD 1
+				  TAIWAN  R.O.C.
+				TW
+
+00-30-D9   (hex)		DATACORE SOFTWARE CORP.
+0030D9     (base 16)		DATACORE SOFTWARE CORP.
+				CORPORATE PARK
+				FORT LAUDERDALE  FL  33309
+				US
+
+00-30-26   (hex)		HeiTel Digital Video GmbH
+003026     (base 16)		HeiTel Digital Video GmbH
+				Stuthagen 25
+				    
+				DE
+
+00-30-77   (hex)		ONPREM NETWORKS
+003077     (base 16)		ONPREM NETWORKS
+				42501 ALBRAE STREET
+				FREMONT  CA  94538
+				US
+
+00-30-47   (hex)		NISSEI ELECTRIC CO., LTD.
+003047     (base 16)		NISSEI ELECTRIC CO., LTD.
+				32 MIYAWAKE, SHIMONOISHIKI-CHO
+				    
+				JP
+
+00-30-D4   (hex)		AAE Systems, Inc.
+0030D4     (base 16)		AAE Systems, Inc.
+				642 North Pastoria Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-D0-D7   (hex)		B2C2, INC.
+00D0D7     (base 16)		B2C2, INC.
+				2020 CHALLENGER DRIVE-
+				ALAMEDA  CA  94501
+				US
+
+00-D0-73   (hex)		ACN ADVANCED COMMUNICATIONS
+00D073     (base 16)		ACN ADVANCED COMMUNICATIONS
+				NETWORKS SA
+				    
+				CH
+
+00-D0-57   (hex)		ULTRAK, INC.
+00D057     (base 16)		ULTRAK, INC.
+				1301 WATERS RIDGE DRIVE
+				LEWISVILLE  TX  75057
+				US
+
+00-30-AB   (hex)		DELTA NETWORKS, INC.
+0030AB     (base 16)		DELTA NETWORKS, INC.
+				8, KON JAN WEST ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-49   (hex)		BRYANT TECHNOLOGY, LTD.
+003049     (base 16)		BRYANT TECHNOLOGY, LTD.
+				P.O. BOX 69557
+				  SOUTH  AFRICA
+				ZA
+
+00-30-6D   (hex)		LUCENT TECHNOLOGIES
+00306D     (base 16)		LUCENT TECHNOLOGIES
+				300 BAKER AVENUE - STE. #100
+				CONCORD  MA  01742-2168
+				US
+
+00-30-17   (hex)		BlueArc UK Ltd
+003017     (base 16)		BlueArc UK Ltd
+				Queensgate House
+				Bracknell    RG12 1RB
+				GB
+
+00-30-1C   (hex)		ALTVATER AIRDATA SYSTEMS
+00301C     (base 16)		ALTVATER AIRDATA SYSTEMS
+				GMBH & CO. KG
+				    
+				DE
+
+00-30-80   (hex)		Cisco Systems, Inc
+003080     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-F7   (hex)		RAMIX INC.
+0030F7     (base 16)		RAMIX INC.
+				1672 DONLON STREET
+				VENTURA  CA  93003
+				US
+
+00-30-D0   (hex)		Tellabs
+0030D0     (base 16)		Tellabs
+				1750 Founder's Parkway
+				Alpharetta  GA  30004
+				US
+
+00-30-14   (hex)		DIVIO, INC.
+003014     (base 16)		DIVIO, INC.
+				997 E. ARQUES AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-30-81   (hex)		ALTOS C&C
+003081     (base 16)		ALTOS C&C
+				150-010 RM. 1012, 44-1
+				    KOREA
+				KR
+
+00-D0-F0   (hex)		CONVISION TECHNOLOGY GMBH
+00D0F0     (base 16)		CONVISION TECHNOLOGY GMBH
+				REBENRING 33
+				    
+				DE
+
+00-D0-10   (hex)		CONVERGENT NETWORKS, INC.
+00D010     (base 16)		CONVERGENT NETWORKS, INC.
+				2 HIGHWOOD DRIVE
+				TEWKSBURY  MA  01876
+				US
+
+00-D0-4B   (hex)		LA CIE GROUP S.A.
+00D04B     (base 16)		LA CIE GROUP S.A.
+				17 RUE AMPERE
+				    
+				FR
+
+00-D0-0E   (hex)		PLURIS, INC.
+00D00E     (base 16)		PLURIS, INC.
+				10455 BANDLEY DRIVE
+				CUPERTINO  CA  95014
+				US
+
+00-D0-12   (hex)		GATEWORKS CORP.
+00D012     (base 16)		GATEWORKS CORP.
+				7631 MORRO ROAD
+				ATASCADERO  CA  93422
+				US
+
+00-D0-4D   (hex)		DIV OF RESEARCH & STATISTICS
+00D04D     (base 16)		DIV OF RESEARCH & STATISTICS
+				BOG OF THE FEDERAL RESERVE SYS
+				WASHINGTON  DC  20551
+				US
+
+00-D0-2E   (hex)		COMMUNICATION AUTOMATION CORP.
+00D02E     (base 16)		COMMUNICATION AUTOMATION CORP.
+				1180 MCDERMOTT DRIVE
+				WEST CHESTER  PA  19380
+				US
+
+00-D0-C5   (hex)		COMPUTATIONAL SYSTEMS, INC.
+00D0C5     (base 16)		COMPUTATIONAL SYSTEMS, INC.
+				835 INNOVATION DRIVE
+				KNOXVILLE  TN  37932
+				US
+
+00-D0-46   (hex)		DOLBY LABORATORIES, INC.
+00D046     (base 16)		DOLBY LABORATORIES, INC.
+				100 Potrero Avenue
+				San Francisco  CA  94103-4938
+				US
+
+00-D0-DE   (hex)		PHILIPS MULTIMEDIA NETWORK
+00D0DE     (base 16)		PHILIPS MULTIMEDIA NETWORK
+				SYSTEMS GMBH
+				    
+				DE
+
+00-D0-0C   (hex)		SNIJDER MICRO SYSTEMS
+00D00C     (base 16)		SNIJDER MICRO SYSTEMS
+				P.O. BOX 300
+				  THE  
+				NL
+
+00-D0-17   (hex)		SYNTECH INFORMATION CO., LTD.
+00D017     (base 16)		SYNTECH INFORMATION CO., LTD.
+				8F, 210, TA-TUNG RD., SEC. 3
+				TAIWAN  TAIWAN  ROC
+				TW
+
+00-D0-36   (hex)		TECHNOLOGY ATLANTA CORP.
+00D036     (base 16)		TECHNOLOGY ATLANTA CORP.
+				141 W. WIEUCA RD. N.E.
+				ATLANTA  GA  30342
+				US
+
+00-D0-E3   (hex)		ELE-CHEM ENGINEERING CO., LTD.
+00D0E3     (base 16)		ELE-CHEM ENGINEERING CO., LTD.
+				WINDSTONE OFFICE
+				SEOUL 137-130  SEOUL 137-130  KOREA
+				KR
+
+00-D0-B6   (hex)		CRESCENT NETWORKS, INC.
+00D0B6     (base 16)		CRESCENT NETWORKS, INC.
+				201 RIVERNECK ROAD
+				CHELMSFORD  MA  01842
+				US
+
+00-D0-C4   (hex)		TERATECH CORPORATION
+00D0C4     (base 16)		TERATECH CORPORATION
+				223 MIDDLESEX TRPK.
+				BURLINGTON  MA  01803-3308
+				US
+
+00-D0-61   (hex)		TREMON ENTERPRISES CO., LTD.
+00D061     (base 16)		TREMON ENTERPRISES CO., LTD.
+				15F, NO. 116, SEC. 1
+				TAIWAN  TAIWAN  ROC
+				TW
+
+00-D0-E5   (hex)		SOLIDUM SYSTEMS CORP.
+00D0E5     (base 16)		SOLIDUM SYSTEMS CORP.
+				940 BELFAST ROAD 1S.217
+				    
+				CA
+
+00-D0-45   (hex)		KVASER AB
+00D045     (base 16)		KVASER AB
+				BOX 4076
+				    
+				SE
+
+00-D0-04   (hex)		PENTACOM LTD.
+00D004     (base 16)		PENTACOM LTD.
+				8 HASADNAOT STREET
+				    
+				IL
+
+00-D0-05   (hex)		ZHS ZEITMANAGEMENTSYSTEME
+00D005     (base 16)		ZHS ZEITMANAGEMENTSYSTEME
+				HARD-UND SOFTWARE GMBH
+				    
+				DE
+
+00-D0-D3   (hex)		Cisco Systems, Inc
+00D0D3     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-26   (hex)		HIRSCHMANN AUSTRIA GMBH
+00D026     (base 16)		HIRSCHMANN AUSTRIA GMBH
+				OBERER PASPELSWEG 6 - 8
+				    
+				AT
+
+00-D0-DA   (hex)		TAICOM DATA SYSTEMS CO., LTD.
+00D0DA     (base 16)		TAICOM DATA SYSTEMS CO., LTD.
+				45, WU-KUNG 5 ROAD
+				    TAIWAN
+				TW
+
+00-D0-3C   (hex)		Vieo, Inc.
+00D03C     (base 16)		Vieo, Inc.
+				12416 Hymeadow Drive,
+				Austin  TX  78750
+				US
+
+00-D0-B4   (hex)		KATSUJIMA CO., LTD.
+00D0B4     (base 16)		KATSUJIMA CO., LTD.
+				1-6-1, SHIRATORI
+				    
+				JP
+
+00-D0-86   (hex)		FOVEON, INC.
+00D086     (base 16)		FOVEON, INC.
+				2820 San Tomas Expressway
+				Santa Clara  CA  95051
+				US
+
+00-D0-A8   (hex)		NETWORK ENGINES, INC.
+00D0A8     (base 16)		NETWORK ENGINES, INC.
+				61 PLEASANT STREET
+				RANDOLPH  MA  02368
+				US
+
+00-D0-AB   (hex)		DELTAKABEL TELECOM CV
+00D0AB     (base 16)		DELTAKABEL TELECOM CV
+				HANZEWEG 14
+				  THE  
+				NL
+
+00-D0-E8   (hex)		MAC SYSTEM CO., LTD.
+00D0E8     (base 16)		MAC SYSTEM CO., LTD.
+				R&D INSTITUTE
+				KYUNGKI-DO  KOREA,  430-017
+				KR
+
+00-D0-6B   (hex)		SR TELECOM INC.
+00D06B     (base 16)		SR TELECOM INC.
+				8150 Trans Canada Highway
+				Quebec    H4S 1M5
+				CA
+
+00-D0-DC   (hex)		MODULAR MINING SYSTEMS, INC.
+00D0DC     (base 16)		MODULAR MINING SYSTEMS, INC.
+				3289 E. HEMISPHERE LOOP
+				TUCSON  AZ  85706
+				US
+
+00-D0-1E   (hex)		PINGTEL CORP.
+00D01E     (base 16)		PINGTEL CORP.
+				773 WINTER STREET
+				N. ANDOVER  MA  01845
+				US
+
+00-D0-CA   (hex)		Intrinsyc Software International Inc.
+00D0CA     (base 16)		Intrinsyc Software International Inc.
+				885 Dunsmuir Street, Suite 380
+				Vancouver  B.C.  V6C 1N5
+				CA
+
+00-D0-65   (hex)		TOKO ELECTRIC
+00D065     (base 16)		TOKO ELECTRIC
+				4008 KUROHAMA, HASUDA-SHI
+				    
+				JP
+
+00-D0-9A   (hex)		FILANET CORPORATION
+00D09A     (base 16)		FILANET CORPORATION
+				931 Benecia Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-D0-AE   (hex)		ORESIS COMMUNICATIONS, INC.
+00D0AE     (base 16)		ORESIS COMMUNICATIONS, INC.
+				14670 NW GREENBRIER PKWY
+				BEAVERTON  OR  97006
+				US
+
+00-D0-F2   (hex)		MONTEREY NETWORKS
+00D0F2     (base 16)		MONTEREY NETWORKS
+				1909 N. GLENVILLE DRIVE
+				RICHARDSON  TX  75081
+				US
+
+00-D0-14   (hex)		ROOT, INC.
+00D014     (base 16)		ROOT, INC.
+				8F TOC2 Bldg, 7-21-11 Nishi-Gotanda
+				  Tokyo  141-0031
+				JP
+
+00-D0-23   (hex)		INFORTREND TECHNOLOGY, INC.
+00D023     (base 16)		INFORTREND TECHNOLOGY, INC.
+				10F, NO. 33 SAN-MIN RD.
+				    TAIWAN
+				TW
+
+00-D0-A2   (hex)		INTEGRATED DEVICE
+00D0A2     (base 16)		INTEGRATED DEVICE
+				TECHNOLOGY, INC.
+				SANTA CLARA  CA  95054
+				US
+
+00-D0-34   (hex)		ORMEC SYSTEMS CORP.
+00D034     (base 16)		ORMEC SYSTEMS CORP.
+				19 LINDEN PARK
+				ROCHESTER  NY  14625
+				US
+
+00-D0-8A   (hex)		PHOTRON USA
+00D08A     (base 16)		PHOTRON USA
+				1101 S. WINCHESTER BLVD.
+				SAN JOSE  CA  95128
+				US
+
+00-D0-A7   (hex)		TOKYO SOKKI KENKYUJO CO., LTD.
+00D0A7     (base 16)		TOKYO SOKKI KENKYUJO CO., LTD.
+				8-2, MINAMI-OHI 6-CHOME
+				  JAPAN  140-8560
+				JP
+
+00-D0-1D   (hex)		FURUNO ELECTRIC CO., LTD.
+00D01D     (base 16)		FURUNO ELECTRIC CO., LTD.
+				NO. 9-52, ASHIHARA-CHO
+				  662-8580  
+				JP
+
+00-50-4C   (hex)		Galil Motion Control
+00504C     (base 16)		Galil Motion Control
+				270 Technology Way
+				Rocklin  CA  95765
+				US
+
+00-50-76   (hex)		IBM Corp
+005076     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-50-D4   (hex)		JOOHONG INFORMATION &
+0050D4     (base 16)		JOOHONG INFORMATION &
+				COMMUNICATIONS, LTD.
+				SEOUL  SEOUL  KOREA
+				KR
+
+00-50-A6   (hex)		OPTRONICS
+0050A6     (base 16)		OPTRONICS
+				175 CREMONA DRIVE
+				GOLETA  CA  93117
+				US
+
+00-50-A9   (hex)		MOLDAT WIRELESS TECHNOLGIES
+0050A9     (base 16)		MOLDAT WIRELESS TECHNOLGIES
+				3 SHIMON ISRAELI STREET
+				    
+				IL
+
+00-50-9B   (hex)		SWITCHCORE AB
+00509B     (base 16)		SWITCHCORE AB
+				POSITIONEN 153
+				    
+				SE
+
+00-50-7E   (hex)		NEWER TECHNOLOGY
+00507E     (base 16)		NEWER TECHNOLOGY
+				4848 WEST IRVING ST.
+				WICHITA  KS  67209-2621
+				US
+
+00-50-CE   (hex)		LG INTERNATIONAL CORP.
+0050CE     (base 16)		LG INTERNATIONAL CORP.
+				LG TWIN TOWERS
+				SEOUL,  150-606    
+				KR
+
+00-50-F7   (hex)		VENTURE MANUFACTURING (SINGAPORE) LTD.
+0050F7     (base 16)		VENTURE MANUFACTURING (SINGAPORE) LTD.
+				
+				#05-01 Techplace II    569873
+				SG
+
+00-50-19   (hex)		SPRING TIDE NETWORKS, INC.
+005019     (base 16)		SPRING TIDE NETWORKS, INC.
+				85 SWANSON ROAD
+				BOXBOROUGH  MA  01719
+				US
+
+00-50-FD   (hex)		VISIONCOMM CO., LTD.
+0050FD     (base 16)		VISIONCOMM CO., LTD.
+				4, 5F, DAEWON B/D
+				YONGSAN-GU, SEOUL    
+				KR
+
+00-50-BF   (hex)		Metalligence Technology Corp.
+0050BF     (base 16)		Metalligence Technology Corp.
+				NO.9, PARK AVENUE II
+				HSIN-CHU    
+				TW
+
+00-50-36   (hex)		NETCAM, LTD.
+005036     (base 16)		NETCAM, LTD.
+				6071 N. PASEO ZALDIVAR
+				TUCSON  AZ  85750
+				US
+
+00-50-DB   (hex)		CONTEMPORARY CONTROL
+0050DB     (base 16)		CONTEMPORARY CONTROL
+				SYSTEMS, INC.
+				DOWNERS GROVE  IL  60515
+				US
+
+00-50-7C   (hex)		VIDEOCON AG
+00507C     (base 16)		VIDEOCON AG
+				ALBERT-SCHWEITZER-STR. 64
+				    
+				DE
+
+00-50-47   (hex)		Private
+005047     (base 16)		Private
+
+00-D0-6C   (hex)		SHAREWAVE, INC.
+00D06C     (base 16)		SHAREWAVE, INC.
+				5175 HILLSDALE CIRCLE
+				EL DORADO HILLS  CA  95762
+				US
+
+00-50-A7   (hex)		Cisco Systems, Inc
+0050A7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-55   (hex)		DOMS A/S
+005055     (base 16)		DOMS A/S
+				FORMERVANGEN 28
+				    
+				DK
+
+00-50-72   (hex)		CORVIS CORPORATION
+005072     (base 16)		CORVIS CORPORATION
+				8320 GUILFORD ROAD
+				COLUMBIA  MD  21046
+				US
+
+00-D0-EE   (hex)		DICTAPHONE CORPORATION
+00D0EE     (base 16)		DICTAPHONE CORPORATION
+				3191 BROADBRIDGE AVE.
+				STRATFORD  CT  06614-2559
+				US
+
+00-50-1B   (hex)		ABL CANADA, INC.
+00501B     (base 16)		ABL CANADA, INC.
+				8550 COTE DE LIESSE
+				ST-LAURENT (QUEBEC) H4T 1H2    
+				CA
+
+00-90-57   (hex)		AANetcom, Inc.
+009057     (base 16)		AANetcom, Inc.
+				4949 LIBERTY LANE - STE. #200
+				ALLENTOWN  PA  18106-9015
+				US
+
+00-90-83   (hex)		TURBO COMMUNICATION, INC.
+009083     (base 16)		TURBO COMMUNICATION, INC.
+				4F-2, NO. 171, SUNG-TEH ROAD
+				TAIPEI    
+				TW
+
+00-90-3D   (hex)		BIOPAC SYSTEMS, INC.
+00903D     (base 16)		BIOPAC SYSTEMS, INC.
+				42 AERO CAMINO
+				SANTA BARBARA  CA  93117
+				US
+
+00-90-D7   (hex)		NetBoost Corp.
+0090D7     (base 16)		NetBoost Corp.
+				390 CAMBRIDGE AVENUE
+				PALO ALTO  CA  94306-1506
+				US
+
+00-50-83   (hex)		GILBARCO, INC.
+005083     (base 16)		GILBARCO, INC.
+				POB 22087
+				GREENSBORO  NC  27420
+				US
+
+00-50-DC   (hex)		TAS TELEFONBAU A. SCHWABE GMBH & CO. KG
+0050DC     (base 16)		TAS TELEFONBAU A. SCHWABE GMBH & CO. KG
+				
+				D-41238 MONCHENGLADBACH    
+				DE
+
+00-50-08   (hex)		TIVA MICROCOMPUTER CORP. (TMC)
+005008     (base 16)		TIVA MICROCOMPUTER CORP. (TMC)
+				48550 FREMONT BLVD.
+				FREMONT  CA  94538
+				US
+
+00-50-52   (hex)		TIARA NETWORKS, INC.
+005052     (base 16)		TIARA NETWORKS, INC.
+				113 FOORIER AVENUE
+				FREMONT  CA  94539
+				US
+
+00-50-27   (hex)		GENICOM CORPORATION
+005027     (base 16)		GENICOM CORPORATION
+				900 CLOPPER ROAD - STE. #110
+				GAITHERSBURG  MD  20878
+				US
+
+00-50-5A   (hex)		NETWORK ALCHEMY, INC.
+00505A     (base 16)		NETWORK ALCHEMY, INC.
+				1521.5 PACIFIC AVENUE
+				SANTA CRUZ  CA  95060
+				US
+
+00-50-39   (hex)		MARINER NETWORKS
+005039     (base 16)		MARINER NETWORKS
+				1585 S. MANCHESTER AVE.
+				ANAHEIM  CA  92802-2907
+				US
+
+00-50-64   (hex)		CAE ELECTRONICS
+005064     (base 16)		CAE ELECTRONICS
+				P.O. BOX 1800
+				ST. LAURENT, QUEBEC H4L 4X4    
+				CA
+
+00-50-B8   (hex)		INOVA COMPUTERS GMBH & CO. KG
+0050B8     (base 16)		INOVA COMPUTERS GMBH & CO. KG
+				SUDETENSTRASSE 5
+				87600 KAUFBEUREN    
+				DE
+
+00-50-5B   (hex)		KAWASAKI LSI U.S.A., INC.
+00505B     (base 16)		KAWASAKI LSI U.S.A., INC.
+				2570 NORTHFIRST STREET
+				SAN JOSE  CA  95131
+				US
+
+00-50-CC   (hex)		Seagate Cloud Systems Inc
+0050CC     (base 16)		Seagate Cloud Systems Inc
+				1351 S Sunset Street
+				Longmont  CO  80501
+				US
+
+00-50-16   (hex)		Molex Canada Ltd
+005016     (base 16)		Molex Canada Ltd
+				216 Bathurst Drive
+				Waterloo  Ontario  N2V 2L7
+				CA
+
+00-50-1F   (hex)		MRG SYSTEMS, LTD.
+00501F     (base 16)		MRG SYSTEMS, LTD.
+				WILLOW HOUSE, SLAD ROAD
+				GLOS.  GL5 1QG England    
+				GB
+
+00-50-43   (hex)		MARVELL SEMICONDUCTOR, INC.
+005043     (base 16)		MARVELL SEMICONDUCTOR, INC.
+				645 ALMANOR AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-50-95   (hex)		PERACOM NETWORKS
+005095     (base 16)		PERACOM NETWORKS
+				13000 WESTON PARKWAY
+				CARY  NC  27513
+				US
+
+00-50-FA   (hex)		OXTEL, LTD.
+0050FA     (base 16)		OXTEL, LTD.
+				THE MARKET PLACE
+				0X11 7LE England    
+				GB
+
+00-90-38   (hex)		FOUNTAIN TECHNOLOGIES, INC.
+009038     (base 16)		FOUNTAIN TECHNOLOGIES, INC.
+				50 RANDOLPH ROAD
+				SOMERSET  NJ  08873
+				US
+
+00-90-B0   (hex)		VADEM
+0090B0     (base 16)		VADEM
+				1960 ZANKER RD
+				SAN JOSE  CA  95112
+				US
+
+00-90-EF   (hex)		INTEGRIX, INC.
+0090EF     (base 16)		INTEGRIX, INC.
+				2001 CORPORATE CENTER DRIVE
+				NEWBURY PARK  CA  91320
+				US
+
+00-90-C5   (hex)		INTERNET MAGIC, INC.
+0090C5     (base 16)		INTERNET MAGIC, INC.
+				6450 LUSK BLVD.-STE. #E-201
+				SAN DIEGO  CA  92121
+				US
+
+00-90-8C   (hex)		ETREND ELECTRONICS, INC.
+00908C     (base 16)		ETREND ELECTRONICS, INC.
+				2F, 22 INDUSTRY E. 9TH ROAD
+				    
+				TW
+
+00-90-48   (hex)		ZEAL CORPORATION
+009048     (base 16)		ZEAL CORPORATION
+				301, HIRAIKE
+				NAGAKUTE-CHO, AICHI-PREF. 480-1155    
+				JP
+
+00-90-B9   (hex)		BERAN INSTRUMENTS LTD.
+0090B9     (base 16)		BERAN INSTRUMENTS LTD.
+				HATCHMOOR INDUSTRIAL ESTATE
+				N DEVON EX38 7HP    
+				GB
+
+00-90-C4   (hex)		JAVELIN SYSTEMS, INC.
+0090C4     (base 16)		JAVELIN SYSTEMS, INC.
+				1881 LANGLEY AVE.
+				IRVINE  CA  92614
+				US
+
+00-90-A5   (hex)		SPECTRA LOGIC
+0090A5     (base 16)		SPECTRA LOGIC
+				1700 N. 55TH STREET
+				BOULDER  CO  80301
+				US
+
+00-90-A3   (hex)		Corecess Inc.
+0090A3     (base 16)		Corecess Inc.
+				135-726, Keopyung B-Town 1F, 203, Nonhyu
+				Seoul    
+				KR
+
+00-90-82   (hex)		FORCE INSTITUTE
+009082     (base 16)		FORCE INSTITUTE
+				PARK ALLE 345
+				DK-2605 BROENDBY    
+				DK
+
+00-90-00   (hex)		DIAMOND MULTIMEDIA
+009000     (base 16)		DIAMOND MULTIMEDIA
+				312 SE STONEMILL DRIVE
+				VANCOUVER  WA  98684
+				US
+
+00-90-6E   (hex)		PRAXON, INC.
+00906E     (base 16)		PRAXON, INC.
+				1700 DELL AVENUE
+				CAMPBELL  CA  95008
+				US
+
+00-90-54   (hex)		INNOVATIVE SEMICONDUCTORS, INC
+009054     (base 16)		INNOVATIVE SEMICONDUCTORS, INC
+				2570 W. EL CAMINO REAL
+				MOUNTAIN VIEW  CA  94040
+				US
+
+00-90-61   (hex)		PACIFIC RESEARCH & ENGINEERING CORPORATION
+009061     (base 16)		PACIFIC RESEARCH & ENGINEERING CORPORATION
+				2070 LAS PALMAS DRIVE
+				CARLSBAD  CA  92009
+				US
+
+00-90-0B   (hex)		LANNER ELECTRONICS, INC.
+00900B     (base 16)		LANNER ELECTRONICS, INC.
+				8F-4, NO. 77, SEC. 1
+				  TAIPEI HSIEN  
+				TW
+
+00-90-CE   (hex)		 avateramedical Mechatronics GmbH
+0090CE     (base 16)		 avateramedical Mechatronics GmbH
+				Gewerbepark „Am Wald“ 4
+				 ILMENAU    D-98693
+				DE
+
+00-90-07   (hex)		DOMEX TECHNOLOGY CORP.
+009007     (base 16)		DOMEX TECHNOLOGY CORP.
+				NO. 2, TECHNOLOGY RD. 1
+				 HSINCHU    
+				TW
+
+00-90-2D   (hex)		DATA ELECTRONICS (AUST.) PTY, LTD.
+00902D     (base 16)		DATA ELECTRONICS (AUST.) PTY, LTD.
+				7 SEISMIC COURT
+				VICTORIA 3178    
+				AU
+
+00-90-D4   (hex)		BindView Development Corp.
+0090D4     (base 16)		BindView Development Corp.
+				3355 WEST ALABAMA #1200
+				HOUSTON  TX  77098
+				US
+
+00-90-29   (hex)		CRYPTO AG
+009029     (base 16)		CRYPTO AG
+				P.O. BOX
+				CH-6301 Zug    
+				CH
+
+00-90-DF   (hex)		MITSUBISHI CHEMICAL AMERICA, INC.
+0090DF     (base 16)		MITSUBISHI CHEMICAL AMERICA, INC.
+				445 INDIO WAY
+				SUNNYVALE  CA  94086
+				US
+
+00-90-C0   (hex)		K.J. LAW ENGINEERS, INC.
+0090C0     (base 16)		K.J. LAW ENGINEERS, INC.
+				42300 W. NINE MILE ROAD
+				NOVI  MI  48375
+				US
+
+00-90-1F   (hex)		ADTEC PRODUCTIONS, INC.
+00901F     (base 16)		ADTEC PRODUCTIONS, INC.
+				408 RUSSELL STREET
+				NASHVILLE  TN  37206
+				US
+
+00-90-24   (hex)		PIPELINKS, INC.
+009024     (base 16)		PIPELINKS, INC.
+				2710 WALSH AVE., STE #300
+				SANTA CLARA  CA  95051
+				US
+
+00-90-3A   (hex)		NIHON MEDIA TOOL INC.
+00903A     (base 16)		NIHON MEDIA TOOL INC.
+				1875 OYAMA-CHO
+				MIE 512-1102    
+				JP
+
+00-90-B2   (hex)		AVICI SYSTEMS INC.
+0090B2     (base 16)		AVICI SYSTEMS INC.
+				12 ELIZABETH DRIVE
+				CHELMSFORD  MA  01824
+				US
+
+00-90-B6   (hex)		FIBEX SYSTEMS
+0090B6     (base 16)		FIBEX SYSTEMS
+				5350 OLD REDWOOD HIGHWAY
+				PETALUMA  CA  94954
+				US
+
+00-90-63   (hex)		COHERENT COMMUNICATIONS SYSTEMS CORPORATION
+009063     (base 16)		COHERENT COMMUNICATIONS SYSTEMS CORPORATION
+				45085 UNIVERSITY DRIVE
+				ASHBURN  VA  20147
+				US
+
+00-90-62   (hex)		ICP VORTEX COMPUTERSYSTEME GmbH
+009062     (base 16)		ICP VORTEX COMPUTERSYSTEME GmbH
+				FALTERSTRASSE 51-53
+				D 74223 FLEIN    
+				DE
+
+00-10-D3   (hex)		GRIPS ELECTRONIC GMBH
+0010D3     (base 16)		GRIPS ELECTRONIC GMBH
+				NIESENBERGERGASSE 37
+				A-8020 GRAZ    
+				AT
+
+00-10-FB   (hex)		ZIDA TECHNOLOGIES LIMITED
+0010FB     (base 16)		ZIDA TECHNOLOGIES LIMITED
+				8/F BLOCK A  GOODVIEW INDUSTRIAL BUILDIN
+				TUEN MUN NT    
+				HK
+
+00-10-53   (hex)		COMPUTER TECHNOLOGY CORP.
+001053     (base 16)		COMPUTER TECHNOLOGY CORP.
+				50 W. TECHNECENTER DRIVE
+				MILFORD  OH  45150
+				US
+
+00-10-ED   (hex)		SUNDANCE TECHNOLOGY, INC.
+0010ED     (base 16)		SUNDANCE TECHNOLOGY, INC.
+				20111 STEVENS CREEK BLVD.
+				CUPERTINO  CA  95014
+				US
+
+00-10-6C   (hex)		EDNT GmbH
+00106C     (base 16)		EDNT GmbH
+				Werner-von-Siemens-Str. 7
+				64625  Bensheim  
+				DE
+
+00-10-E9   (hex)		RAIDTEC LTD.
+0010E9     (base 16)		RAIDTEC LTD.
+				CASTLE ROAD
+				Little Island  County Cork  
+				IE
+
+00-10-03   (hex)		IMATRON, INC.
+001003     (base 16)		IMATRON, INC.
+				389 OYSTER POINT BLVD.
+				SO. SAN FRANCISCO  CA  94080
+				US
+
+00-10-71   (hex)		ADVANET INC.
+001071     (base 16)		ADVANET INC.
+				3-20-8 NODA
+				  OKAYAMI 700  
+				JP
+
+00-90-15   (hex)		CENTIGRAM COMMUNICATIONS CORP.
+009015     (base 16)		CENTIGRAM COMMUNICATIONS CORP.
+				91 EAST TASMAN DRIVE
+				SAN JOSE  CA  95134
+				US
+
+00-90-95   (hex)		UNIVERSAL AVIONICS
+009095     (base 16)		UNIVERSAL AVIONICS
+				11351 WILLOWS ROAD NE
+				REDMOND  WA  98052-2552
+				US
+
+00-90-41   (hex)		APPLIED DIGITAL ACCESS
+009041     (base 16)		APPLIED DIGITAL ACCESS
+				9855 SCRANTON ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-90-5A   (hex)		DEARBORN GROUP, INC.
+00905A     (base 16)		DEARBORN GROUP, INC.
+				33604 West 8 Mile Rd
+				Farmington Hills  MI  48335
+				US
+
+00-90-11   (hex)		WAVTrace, Inc.
+009011     (base 16)		WAVTrace, Inc.
+				1555 132ND AVE. NE
+				BELLEVUE  WA  98005
+				US
+
+00-90-65   (hex)		FINISAR CORPORATION
+009065     (base 16)		FINISAR CORPORATION
+				1389 Moffett Park Dr
+				Sunnyvale  CA  94089
+				US
+
+00-90-23   (hex)		ZILOG INC.
+009023     (base 16)		ZILOG INC.
+				910 East Hamilton Ave.
+				Campbell  CA  95008
+				US
+
+00-90-F6   (hex)		ESCALATE NETWORKS, INC.
+0090F6     (base 16)		ESCALATE NETWORKS, INC.
+				6 HUGHES
+				IRVINE  CA  92617
+				US
+
+00-90-A8   (hex)		NineTiles Networks, Ltd.
+0090A8     (base 16)		NineTiles Networks, Ltd.
+				9 Station Road
+				Waterbeach  Cambridge  CB5 9HT
+				GB
+
+00-10-2A   (hex)		ZF MICROSYSTEMS, INC.
+00102A     (base 16)		ZF MICROSYSTEMS, INC.
+				1052 ELWELL COURT
+				PALO ALTO  CA  94303-4307
+				US
+
+00-10-E5   (hex)		SOLECTRON TEXAS
+0010E5     (base 16)		SOLECTRON TEXAS
+				12455 RESEARCH BLVD. M/S 2205
+				AUSTIN  TX  78759
+				US
+
+00-10-9D   (hex)		CLARINET SYSTEMS, INC.
+00109D     (base 16)		CLARINET SYSTEMS, INC.
+				1415 KOLL CIRCLE #101
+				SAN JOSE  CA  95112
+				US
+
+00-10-0E   (hex)		MICRO LINEAR COPORATION
+00100E     (base 16)		MICRO LINEAR COPORATION
+				2092 CONCOURSE DRIVE
+				SAN JOSE  CA  95131
+				US
+
+00-90-EC   (hex)		PYRESCOM
+0090EC     (base 16)		PYRESCOM
+				3 ALLEE DU MOULIN
+				66680 CANOHES    
+				FR
+
+00-90-C3   (hex)		TOPIC SEMICONDUCTOR CORP.
+0090C3     (base 16)		TOPIC SEMICONDUCTOR CORP.
+				11F-1, NO. 2, WU-LIN RD.
+				HSIN-CHU    
+				TW
+
+00-10-C8   (hex)		COMMUNICATIONS ELECTRONICS SECURITY GROUP
+0010C8     (base 16)		COMMUNICATIONS ELECTRONICS SECURITY GROUP
+				10/4W22 FIDDLERS GREEN LANE
+				Benhall, Cheltenham  Glouster GL52 5AJ  
+				GB
+
+00-10-F3   (hex)		Nexcom International Co., Ltd.
+0010F3     (base 16)		Nexcom International Co., Ltd.
+				18F, No. 716, Chung-Cheng Road,
+				Taipei Hsien 235,    
+				TW
+
+00-10-86   (hex)		ATTO Technology, Inc.
+001086     (base 16)		ATTO Technology, Inc.
+				155 Crosspoint Pkwy.
+				Amherst  NY  14068
+				US
+
+00-10-DF   (hex)		RISE COMPUTER INC.
+0010DF     (base 16)		RISE COMPUTER INC.
+				9F, NO. 306-3, TATUNG RD.
+				TAIPEI HSIEN    
+				TW
+
+00-10-72   (hex)		GVN TECHNOLOGIES, INC.
+001072     (base 16)		GVN TECHNOLOGIES, INC.
+				8200 BRYAN DAIRY ROAD
+				LARGO  FL  33777
+				US
+
+00-10-DA   (hex)		Kollmorgen Corp
+0010DA     (base 16)		Kollmorgen Corp
+				33 S.LA PATERA LN
+				SANTA BARBARA  CA  93117
+				US
+
+00-10-E4   (hex)		NSI CORPORATION
+0010E4     (base 16)		NSI CORPORATION
+				P.O. BOX 635
+				WILSONVILLE  OR  97070
+				US
+
+00-10-7E   (hex)		BACHMANN ELECTRONIC GmbH
+00107E     (base 16)		BACHMANN ELECTRONIC GmbH
+				KREUZAECKERWEG 33
+				A 6806 FELDKIRCH    
+				AT
+
+00-10-A0   (hex)		INNOVEX TECHNOLOGIES, INC.
+0010A0     (base 16)		INNOVEX TECHNOLOGIES, INC.
+				KEYSTONE COMMONS
+				TURTLE CREEK  PA  15145
+				US
+
+00-10-16   (hex)		T.SQWARE
+001016     (base 16)		T.SQWARE
+				6, PARC ARIANE
+				78284 GUYANCOURT CEDEX    
+				FR
+
+00-10-90   (hex)		CIMETRICS, INC.
+001090     (base 16)		CIMETRICS, INC.
+				55 TEMPLE PLACE
+				BOSTON  MA  02111
+				US
+
+00-10-F5   (hex)		AMHERST SYSTEMS, INC.
+0010F5     (base 16)		AMHERST SYSTEMS, INC.
+				30 WILSON ROAD
+				BUFFALO  NY  14221
+				US
+
+00-10-3D   (hex)		PHASECOM, LTD.
+00103D     (base 16)		PHASECOM, LTD.
+				P.O. BOX 45017
+				JERUSALEM 91450    
+				IL
+
+00-10-96   (hex)		TRACEWELL SYSTEMS, INC.
+001096     (base 16)		TRACEWELL SYSTEMS, INC.
+				567 ENTERPRISE DRIVE
+				WESTERVILLE  OH  43081
+				US
+
+00-10-82   (hex)		JNA TELECOMMUNICATIONS LIMITED
+001082     (base 16)		JNA TELECOMMUNICATIONS LIMITED
+				16 SMITH ST, CHATSWOOD
+				  NSW 2067  
+				AU
+
+00-10-98   (hex)		STARNET TECHNOLOGIES, INC.
+001098     (base 16)		STARNET TECHNOLOGIES, INC.
+				2210 O'TOOLE AVE.
+				SAN JOSE  CA  95131
+				US
+
+00-10-42   (hex)		Alacritech, Inc.
+001042     (base 16)		Alacritech, Inc.
+				1995 N. First Street
+				San Jose  CA  95112
+				US
+
+00-10-68   (hex)		COMOS TELECOM
+001068     (base 16)		COMOS TELECOM
+				SAEHAN B/D/, 27-1 SUPYO-DONG
+				CHUNG-GU,  SEOUL (100-230)    
+				KR
+
+00-10-EA   (hex)		ADEPT TECHNOLOGY
+0010EA     (base 16)		ADEPT TECHNOLOGY
+				150 ROSE ORCHARD WAY
+				SAN JOSE  CA  95134
+				US
+
+00-10-AE   (hex)		SHINKO ELECTRIC INDUSTRIES CO.
+0010AE     (base 16)		SHINKO ELECTRIC INDUSTRIES CO.
+				80 OSHIMADA-MACHI
+				NAGANO-SHI 381-22    
+				JP
+
+00-10-C4   (hex)		MEDIA GLOBAL LINKS CO., LTD.
+0010C4     (base 16)		MEDIA GLOBAL LINKS CO., LTD.
+				580-16, horikawa-cho,saiwai-ku
+				Kawasaki, Kanagawa 212-0013    
+				JP
+
+00-10-FE   (hex)		DIGITAL EQUIPMENT CORPORATION
+0010FE     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				301 ROCKRIMMON BLVD, SOUTH
+				COLORADO SPRINGS  CO  80919
+				US
+
+00-10-56   (hex)		SODICK CO., LTD.
+001056     (base 16)		SODICK CO., LTD.
+				3-12-1 NAKAMACHIDAI
+				TSUZUKI-KU, YOKOHAMA  KANAGAWA 224  
+				JP
+
+00-10-CD   (hex)		INTERFACE CONCEPT
+0010CD     (base 16)		INTERFACE CONCEPT
+				3 VENELLE de KERGOS
+				29000 QUIMPER    
+				FR
+
+00-10-61   (hex)		HOSTLINK CORP.
+001061     (base 16)		HOSTLINK CORP.
+				10F-1, NO. 181
+				HSI-CHIH, TAIPEI    
+				TW
+
+00-10-99   (hex)		InnoMedia, Inc.
+001099     (base 16)		InnoMedia, Inc.
+				4800 GREAT AMERICA PARKWAY
+				SANTA CLARA  CA  95054
+				US
+
+00-10-E1   (hex)		S.I. TECH, INC.
+0010E1     (base 16)		S.I. TECH, INC.
+				P.O. BOX 609
+				GENEVA  IL  60134
+				US
+
+00-10-BB   (hex)		DATA & INFORMATION TECHNOLOGY
+0010BB     (base 16)		DATA & INFORMATION TECHNOLOGY
+				TECHNOLOGY HOUSE
+				BOTTESFORD, NOTTINGHAM NG13 OEL    
+				GB
+
+00-10-20   (hex)		Hand Held Products Inc
+001020     (base 16)		Hand Held Products Inc
+				700 Visions Drive
+				Skaneateles Falls  NY  13153-0208
+				US
+
+00-10-3A   (hex)		DIAMOND NETWORK TECH
+00103A     (base 16)		DIAMOND NETWORK TECH
+				P.O. BOX 84525
+				GREENSIDE 2034    
+				ZA
+
+00-10-04   (hex)		THE BRANTLEY COILE COMPANY,INC
+001004     (base 16)		THE BRANTLEY COILE COMPANY,INC
+				545 RESEARCH DRIVE
+				ATHENS  GA  30605
+				US
+
+00-10-EF   (hex)		DBTEL INCORPORATED
+0010EF     (base 16)		DBTEL INCORPORATED
+				NO.29 TZU-CHIANG ST.,
+				TU-CHENG TAIPEI    
+				TW
+
+00-10-88   (hex)		AMERICAN NETWORKS INC.
+001088     (base 16)		AMERICAN NETWORKS INC.
+				6800 ORANGETHORPE AVE. #A
+				BUENA PARK  CA  90620
+				US
+
+00-10-22   (hex)		SatCom Media Corporation
+001022     (base 16)		SatCom Media Corporation
+				3255-7 SCOTT BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+00-10-76   (hex)		EUREM GmbH
+001076     (base 16)		EUREM GmbH
+				JULICHER STR. 338B
+				D-52070 AACHEN    
+				DE
+
+00-10-3F   (hex)		TOLLGRADE COMMUNICATIONS, INC.
+00103F     (base 16)		TOLLGRADE COMMUNICATIONS, INC.
+				493 NIXON ROAD
+				CHESWICK  PA  15024
+				US
+
+00-10-49   (hex)		ShoreTel, Inc
+001049     (base 16)		ShoreTel, Inc
+				960 Stewart Drive
+				Sunnyvale  CA  94085
+				US
+
+00-10-5E   (hex)		Spirent plc, Service Assurance Broadband
+00105E     (base 16)		Spirent plc, Service Assurance Broadband
+				5280 Corporate Dr
+				Ballenger Creek  MD  21703
+				US
+
+00-10-AF   (hex)		TAC SYSTEMS, INC.
+0010AF     (base 16)		TAC SYSTEMS, INC.
+				1035 PUTMAN DRIVE--STE.
+				HUNTSVILLE  AL  35816-2271
+				US
+
+00-10-8C   (hex)		Fujitsu Services Ltd
+00108C     (base 16)		Fujitsu Services Ltd
+				SOLIHULL PARKWAY
+				BIRMINGHAM B37 7YU  England  0000
+				GB
+
+00-10-F7   (hex)		IRIICHI TECHNOLOGIES Inc.
+0010F7     (base 16)		IRIICHI TECHNOLOGIES Inc.
+				1-26-7 CHUO, NAKANA-KU
+				 TOKYO 164    
+				JP
+
+00-10-AB   (hex)		KOITO ELECTRIC INDUSTRIES, LTD.
+0010AB     (base 16)		KOITO ELECTRIC INDUSTRIES, LTD.
+				100 MAEDA-CHO, TOTSUKA-KU
+				YOKOHAMA 244  KANAGAWA  244-8569
+				JP
+
+00-10-10   (hex)		INITIO CORPORATION
+001010     (base 16)		INITIO CORPORATION
+				2188 B DEL FRANCO STREET
+				SAN JOSE  CA  95118
+				US
+
+00-10-F2   (hex)		ANTEC
+0010F2     (base 16)		ANTEC
+				4920 AVALON RIDGE PKWY
+				NORCROSS  GA  30071
+				US
+
+00-E0-07   (hex)		Avaya ECS Ltd
+00E007     (base 16)		Avaya ECS Ltd
+				Unit 1 Sterling Court, Mundells
+				Welwyn Garden City  Hert  AL7 1LZ
+				GB
+
+00-10-BE   (hex)		MARCH NETWORKS CORPORATION
+0010BE     (base 16)		MARCH NETWORKS CORPORATION
+				303 Terry Fox Drive
+				OTTAWA, ONTARIO    K2K 3J1
+				CA
+
+00-10-58   (hex)		ArrowPoint Communications
+001058     (base 16)		ArrowPoint Communications
+				235 LITTLETON ROAD
+				WESTFORD  MA  01886
+				US
+
+00-10-0F   (hex)		INDUSTRIAL CPU SYSTEMS
+00100F     (base 16)		INDUSTRIAL CPU SYSTEMS
+				111-D W. DYER ROAD
+				SANTA ANA  CA  92707
+				US
+
+00-10-BC   (hex)		Aastra Telecom
+0010BC     (base 16)		Aastra Telecom
+				8 Federal Street
+				Billerica  MA  01821-3570
+				US
+
+00-E0-BF   (hex)		TORRENT NETWORKING TECHNOLOGIES CORP.
+00E0BF     (base 16)		TORRENT NETWORKING TECHNOLOGIES CORP.
+				8181 PROFESSIONAL PLACE
+				LANDOVER  MD  20785
+				US
+
+00-E0-E3   (hex)		SK-ELEKTRONIK GMBH
+00E0E3     (base 16)		SK-ELEKTRONIK GMBH
+				HEMMELRATHERWEG 201
+				51377 LEVERKUSEN    
+				DE
+
+00-E0-C6   (hex)		LINK2IT, L.L.C.
+00E0C6     (base 16)		LINK2IT, L.L.C.
+				4256 BECK AVENUE
+				STUDIO CITY  CA  91604
+				US
+
+00-E0-E5   (hex)		CINCO NETWORKS, INC.
+00E0E5     (base 16)		CINCO NETWORKS, INC.
+				6601 KOLL CENTER PARK WAY
+				PLEASANTON  CA  94566
+				US
+
+00-E0-61   (hex)		EdgePoint Networks, Inc.
+00E061     (base 16)		EdgePoint Networks, Inc.
+				2238 MARTIN AVENUE
+				SANTA CLARA  CA  95050
+				US
+
+00-E0-53   (hex)		CELLPORT LABS, INC.
+00E053     (base 16)		CELLPORT LABS, INC.
+				885 ARAPAHOE AVE.,
+				BOULDER  CO  80302
+				US
+
+00-E0-D3   (hex)		DATENTECHNIK GmbH
+00E0D3     (base 16)		DATENTECHNIK GmbH
+				THERESIANUMGASSE 11
+				A-1040 WIEN    
+				AT
+
+00-E0-43   (hex)		VitalCom
+00E043     (base 16)		VitalCom
+				15222 DEL AMO AVE.
+				TUSTIN  CA  92780
+				US
+
+00-E0-B3   (hex)		EtherWAN Systems, Inc.
+00E0B3     (base 16)		EtherWAN Systems, Inc.
+				14 HUGHES,  STE.B-105
+				IRVINE  CA  92618
+				US
+
+00-E0-ED   (hex)		SILICOM, LTD.
+00E0ED     (base 16)		SILICOM, LTD.
+				8 HANAGER ST.
+				KFAR-SAVA 44000    
+				IL
+
+00-E0-B8   (hex)		GATEWAY 2000
+00E0B8     (base 16)		GATEWAY 2000
+				610 GATEWAY DRIVE
+				N. SIOUX CITY  SD  57049
+				US
+
+00-E0-7C   (hex)		METTLER-TOLEDO, INC.
+00E07C     (base 16)		METTLER-TOLEDO, INC.
+				1150 DEARBORN DRIVE
+				WORTHINGTON  OH  43085
+				US
+
+00-E0-26   (hex)		Redlake MASD LLC
+00E026     (base 16)		Redlake MASD LLC
+				3440 E. Pritannia Dr.
+				Tuscon  AZ  85706
+				US
+
+00-E0-20   (hex)		TECNOMEN OY
+00E020     (base 16)		TECNOMEN OY
+				P.O. BOX 93
+				FIN-02271 ESPOO    
+				FI
+
+00-E0-0D   (hex)		RADIANT SYSTEMS
+00E00D     (base 16)		RADIANT SYSTEMS
+				1000 ALDERMAN DR.
+				ALPHARETTA  GA  30202
+				US
+
+00-E0-DC   (hex)		NEXWARE CORP.
+00E0DC     (base 16)		NEXWARE CORP.
+				825 STEWART DR.,  STE #4
+				SUNNYVALE  CA  94086
+				US
+
+00-E0-37   (hex)		CENTURY CORPORATION
+00E037     (base 16)		CENTURY CORPORATION
+				2-28-5, Taito
+				TAITO-KU,  TOKYO  101
+				JP
+
+00-E0-C2   (hex)		NECSY S.p.A.
+00E0C2     (base 16)		NECSY S.p.A.
+				VIA LISBONA 28
+				35020 PADOVA    
+				IT
+
+00-E0-FB   (hex)		LEIGHTRONIX, INC.
+00E0FB     (base 16)		LEIGHTRONIX, INC.
+				2330 JARCO DR.
+				HOLT  MI  48842
+				US
+
+00-E0-9B   (hex)		ENGAGE NETWORKS, INC.
+00E09B     (base 16)		ENGAGE NETWORKS, INC.
+				316 N. MILWAUKEE ST., STE.#214
+				MILWAUKEE  WI  53202
+				US
+
+00-E0-45   (hex)		TOUCHWAVE, INC.
+00E045     (base 16)		TOUCHWAVE, INC.
+				Maglebjergvej 5B
+				DK-2800 Lyngby    
+				DK
+
+00-E0-40   (hex)		DeskStation Technology, Inc.
+00E040     (base 16)		DeskStation Technology, Inc.
+				15729 COLLEGE BLVD.
+				LENEXA  KS  66219
+				US
+
+00-E0-1A   (hex)		COMTEC SYSTEMS. CO., LTD.
+00E01A     (base 16)		COMTEC SYSTEMS. CO., LTD.
+				404-9 CHOUNGCHEN-DONG
+				BUPYOUNG-KU, INCHON    
+				KR
+
+00-E0-78   (hex)		BERKELEY NETWORKS
+00E078     (base 16)		BERKELEY NETWORKS
+				683 RIVER OAKS PARKWAY
+				SAN JOSE  CA  95134
+				US
+
+00-E0-87   (hex)		LeCroy - Networking Productions Division
+00E087     (base 16)		LeCroy - Networking Productions Division
+				25 BURLINGTON MALL ROAD
+				BURLINGTON  MA  01803
+				US
+
+00-E0-41   (hex)		CSPI
+00E041     (base 16)		CSPI
+				43 Manning Rd.
+				Billerica  MA  01821
+				US
+
+00-E0-E2   (hex)		INNOVA CORP.
+00E0E2     (base 16)		INNOVA CORP.
+				3325 SOUTH 116TH STREET
+				SEATTLE  WA  98168
+				US
+
+00-E0-81   (hex)		TYAN COMPUTER CORP.
+00E081     (base 16)		TYAN COMPUTER CORP.
+				3288 LAUREVIEW CT
+				Fremont  CA  95035
+				US
+
+00-E0-57   (hex)		HAN MICROTELECOM. CO., LTD.
+00E057     (base 16)		HAN MICROTELECOM. CO., LTD.
+				FASHION BD., 3RD FR,
+				DONG SEO-GU, TAEJON  KOREA 302-173  
+				KR
+
+00-E0-BC   (hex)		SYMON COMMUNICATIONS, INC.
+00E0BC     (base 16)		SYMON COMMUNICATIONS, INC.
+				10701 CORPORATE DR.-STE. #290
+				STAFFORD  TX  77477
+				US
+
+00-E0-82   (hex)		ANERMA
+00E082     (base 16)		ANERMA
+				SCHAAPSDRIES 25
+				2260 WESTERLO    
+				BE
+
+00-E0-77   (hex)		WEBGEAR, INC.
+00E077     (base 16)		WEBGEAR, INC.
+				1263 OAKMEAD PKWY
+				SUNNYVALE  CA  94080
+				US
+
+00-E0-56   (hex)		HOLONTECH CORPORATION
+00E056     (base 16)		HOLONTECH CORPORATION
+				2039 SAMARITAN DRIVE
+				SAN JOSE  CA  95124
+				US
+
+00-E0-31   (hex)		HAGIWARA ELECTRIC CO., LTD.
+00E031     (base 16)		HAGIWARA ELECTRIC CO., LTD.
+				7, SHIMOKOFUKADA, ASADA-CHO
+				NISSHIN-SHI, AICHI  470-01    
+				JP
+
+00-E0-0B   (hex)		ROOFTOP COMMUNICATIONS CORP.
+00E00B     (base 16)		ROOFTOP COMMUNICATIONS CORP.
+				468 PACO DRIVE
+				LOS ALTOS  CA  94024
+				US
+
+00-E0-B2   (hex)		TELMAX COMMUNICATIONS CORP.
+00E0B2     (base 16)		TELMAX COMMUNICATIONS CORP.
+				46515 LANDING PARKWAY
+				FREMONT  CA  94538
+				US
+
+00-E0-2F   (hex)		MCNS HOLDINGS, L.P.
+00E02F     (base 16)		MCNS HOLDINGS, L.P.
+				TCI, INC.-TECHNOLOGY VENTURES
+				DENVER  CO  80217-5630
+				US
+
+00-E0-7E   (hex)		WALT DISNEY IMAGINEERING
+00E07E     (base 16)		WALT DISNEY IMAGINEERING
+				1401 FLOWER ST.
+				GLENDALE  CA  91221
+				US
+
+00-E0-99   (hex)		SAMSON AG
+00E099     (base 16)		SAMSON AG
+				WEISMULLERSTR. 3
+				D-60314 FRANKFURT    
+				DE
+
+00-60-AE   (hex)		TRIO INFORMATION SYSTEMS AB
+0060AE     (base 16)		TRIO INFORMATION SYSTEMS AB
+				FOGDEVAGEN 4B
+				  S-183 64 TABY  
+				SE
+
+00-60-53   (hex)		TOYODA MACHINE WORKS, LTD.
+006053     (base 16)		TOYODA MACHINE WORKS, LTD.
+				1-7 KITAJIZOYAMA NODACHOU
+				KARIYA CITY, AICHI    
+				JO
+
+00-60-56   (hex)		NETWORK TOOLS, INC.
+006056     (base 16)		NETWORK TOOLS, INC.
+				2975 BOWERS AVENUE, #202
+				SANTA CLARA  CA  95051-0955
+				US
+
+00-60-0C   (hex)		Eurotech Inc.
+00600C     (base 16)		Eurotech Inc.
+				10260 Old Columbia Road
+				COLUMBIA  MD  21046
+				US
+
+00-60-1C   (hex)		TELXON CORPORATION
+00601C     (base 16)		TELXON CORPORATION
+				3330 W. MARKET STREET
+				AKRON  OH  44334-0582
+				US
+
+00-60-5F   (hex)		NIPPON UNISOFT CORPORATION
+00605F     (base 16)		NIPPON UNISOFT CORPORATION
+				BR NINGYOCHO 1,2-13-9
+				TOKYO 103    
+				JP
+
+00-60-91   (hex)		FIRST PACIFIC NETWORKS, INC.
+006091     (base 16)		FIRST PACIFIC NETWORKS, INC.
+				871 FOX LANE
+				SAN JOSE  CA  95131
+				US
+
+00-60-1D   (hex)		LUCENT TECHNOLOGIES
+00601D     (base 16)		LUCENT TECHNOLOGIES
+				101 CRAWFORDS CORNER RD.
+				HOLMDEL  NJ  07733
+				US
+
+00-60-7B   (hex)		FORE SYSTEMS, INC.
+00607B     (base 16)		FORE SYSTEMS, INC.
+				1000 FORE DRIVE
+				WARRENDALE  PA  15086
+				US
+
+00-E0-6C   (hex)		Ultra Electronics Command & Control Systems
+00E06C     (base 16)		Ultra Electronics Command & Control Systems
+				Knaves Beech Business Centre
+				Hemel Hemstead  Herts England  HP2 7BW
+				GB
+
+00-E0-4A   (hex)		ZX Technologies, Inc
+00E04A     (base 16)		ZX Technologies, Inc
+				760 Spanish Oak Trail
+				Dripping Springs  TX  78620
+				US
+
+00-60-C9   (hex)		ControlNet, Inc.
+0060C9     (base 16)		ControlNet, Inc.
+				747 CAMDEN, STE. A
+				CAMPBELL  CA  95008
+				US
+
+00-E0-7A   (hex)		MIKRODIDAKT AB
+00E07A     (base 16)		MIKRODIDAKT AB
+				Skiffervägen 48
+				LUND    SE22478
+				SE
+
+00-60-32   (hex)		I-CUBE, INC.
+006032     (base 16)		I-CUBE, INC.
+				2328-C WALSH AVENUE
+				SANTA CLARA  CA  95014
+				US
+
+00-60-33   (hex)		ACUITY IMAGING, INC.
+006033     (base 16)		ACUITY IMAGING, INC.
+				9 TOWNSEND WEST
+				NASHUA  NH  03063
+				US
+
+00-60-13   (hex)		NETSTAL MASCHINEN AG
+006013     (base 16)		NETSTAL MASCHINEN AG
+				INDUSTRIESTRASSE
+				CH-8752 NAEFELS    
+				CH
+
+00-60-22   (hex)		VICOM SYSTEMS, INC.
+006022     (base 16)		VICOM SYSTEMS, INC.
+				1961 LANDINGS DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-60-EE   (hex)		APOLLO
+0060EE     (base 16)		APOLLO
+				3610 BIRCH STREET--STE #100
+				NEWPORT BEACH  CA  92660
+				US
+
+00-60-D8   (hex)		ELMIC SYSTEMS, INC.
+0060D8     (base 16)		ELMIC SYSTEMS, INC.
+				DAI-ICHI SEIMEI BLDG.
+				YOKOHAMA 231    
+				JP
+
+00-60-EF   (hex)		FLYTECH TECHNOLOGY CO., LTD.
+0060EF     (base 16)		FLYTECH TECHNOLOGY CO., LTD.
+				No.168 Sing-ai Rd., Neihu District
+				TAIPEI CITY    114
+				TW
+
+00-60-85   (hex)		Storage Concepts
+006085     (base 16)		Storage Concepts
+				14352 Chamber Road
+				Tustin  CA  92780
+				US
+
+00-60-11   (hex)		CRYSTAL SEMICONDUCTOR CORP.
+006011     (base 16)		CRYSTAL SEMICONDUCTOR CORP.
+				P.O. BOX 17847
+				AUSTIN  TX  78760
+				US
+
+00-60-F5   (hex)		ICON WEST, INC.
+0060F5     (base 16)		ICON WEST, INC.
+				3342 SOUTH 300 EAST
+				SALT LAKE CITY  UT  84115
+				US
+
+00-60-62   (hex)		TELESYNC, INC.
+006062     (base 16)		TELESYNC, INC.
+				5555 OAKBROOK PKWY-STE #110
+				NORCROSS  GA  30093
+				US
+
+00-60-E9   (hex)		ATOP TECHNOLOGIES, INC.
+0060E9     (base 16)		ATOP TECHNOLOGIES, INC.
+				SUITE 305, NO. 47, PARK AVENUE II,
+				HSINCHU 30047    
+				TW
+
+00-60-43   (hex)		iDirect, INC.
+006043     (base 16)		iDirect, INC.
+				13865 Sunrise Vally Drive
+				Herndon  VA  20171
+				US
+
+00-60-28   (hex)		MACROVISION CORPORATION
+006028     (base 16)		MACROVISION CORPORATION
+				2830 De La Cruz Boulevard
+				Santa Clara  CA  95050
+				US
+
+00-60-F0   (hex)		JOHNSON & JOHNSON MEDICAL, INC
+0060F0     (base 16)		JOHNSON & JOHNSON MEDICAL, INC
+				4110 GEORGE RD.
+				TAMPA  FL  33634
+				US
+
+00-60-E0   (hex)		AXIOM TECHNOLOGY CO., LTD.
+0060E0     (base 16)		AXIOM TECHNOLOGY CO., LTD.
+				3F, 14, LANE 235
+				TAIPEI HSIEN    
+				TW
+
+00-60-96   (hex)		T.S. MICROTECH INC.
+006096     (base 16)		T.S. MICROTECH INC.
+				20818 HIGGINS COURT
+				TORRANCE  CA  90501
+				US
+
+00-60-3A   (hex)		QUICK CONTROLS LTD.
+00603A     (base 16)		QUICK CONTROLS LTD.
+				DURHAM HOUSE, WARWICK COURT
+				MANCHESTER  M24 1AE    
+				GB
+
+00-02-88   (hex)		GLOBAL VILLAGE COMMUNICATION
+000288     (base 16)		GLOBAL VILLAGE COMMUNICATION
+				1144 EAST ARQUES AVE.
+				SUNNYVALE  CA  94086
+				US
+
+00-60-34   (hex)		ROBERT BOSCH GmbH
+006034     (base 16)		ROBERT BOSCH GmbH
+				POSTBOX 11 62
+				D-64701 ERBACH    
+				DE
+
+00-60-50   (hex)		INTERNIX INC.
+006050     (base 16)		INTERNIX INC.
+				59-10 TAKAKURA-CHO
+				  TOKYO 192  
+				JP
+
+00-60-FA   (hex)		EDUCATIONAL TECHNOLOGY RESOURCES, INC.
+0060FA     (base 16)		EDUCATIONAL TECHNOLOGY RESOURCES, INC.
+				1742 CHURCH STREET
+				HOLBROOK  NY  11741
+				US
+
+00-60-DA   (hex)		Red Lion Controls, LP
+0060DA     (base 16)		Red Lion Controls, LP
+				20 Willow Springs Circle
+				York  NY  17402
+				US
+
+00-60-E4   (hex)		COMPUSERVE, INC.
+0060E4     (base 16)		COMPUSERVE, INC.
+				5000 ARLINGTON CENTRE BLVD.
+				COLUMBUS  OH  43220
+				US
+
+00-60-8F   (hex)		TEKRAM TECHNOLOGY CO., LTD.
+00608F     (base 16)		TEKRAM TECHNOLOGY CO., LTD.
+				B1, NO. 17, LANE 159, SEC. 6
+				TAIPEI    
+				TW
+
+00-60-C4   (hex)		SOLITON SYSTEMS K.K.
+0060C4     (base 16)		SOLITON SYSTEMS K.K.
+				2-4-3 SHINJUKU, SHINJUKU-KU
+				TOKYO 160    
+				JP
+
+00-A0-3C   (hex)		EG&G NUCLEAR INSTRUMENTS
+00A03C     (base 16)		EG&G NUCLEAR INSTRUMENTS
+				100 MIDLAND ROAD
+				OAK RIDGE  TN  37830
+				US
+
+00-A0-C4   (hex)		CRISTIE ELECTRONICS LTD.
+00A0C4     (base 16)		CRISTIE ELECTRONICS LTD.
+				BOND'S MILL
+				GLOUCESTERSHIRE GL10 3RG    
+				GB
+
+00-A0-63   (hex)		JRL SYSTEMS, INC.
+00A063     (base 16)		JRL SYSTEMS, INC.
+				8305 HWY 71 WEST
+				AUSTIN  TX  78735
+				US
+
+00-A0-2C   (hex)		interWAVE Communications
+00A02C     (base 16)		interWAVE Communications
+				656 BAIR ISLAND BLVD.-STE.#108
+				REDWOOD CITY  CA  94063-2704
+				US
+
+00-A0-F7   (hex)		V.I COMPUTER CORP.
+00A0F7     (base 16)		V.I COMPUTER CORP.
+				531 ENCINITAS BLVD--#114
+				ENCINITAS  CA  92024
+				US
+
+00-A0-90   (hex)		TimeStep Corporation
+00A090     (base 16)		TimeStep Corporation
+				359 TERRY FOX DRIVE
+				KANATA, ONTARIO K2K 2E7    
+				CA
+
+00-A0-EA   (hex)		ETHERCOM CORP.
+00A0EA     (base 16)		ETHERCOM CORP.
+				45990 HOTCHKISS ST.
+				FREEMONT  CA  94539
+				US
+
+00-A0-DC   (hex)		O.N. ELECTRONIC CO., LTD.
+00A0DC     (base 16)		O.N. ELECTRONIC CO., LTD.
+				3-20-27, TARUMI
+				SUITA, OSAKA 564    
+				JP
+
+00-A0-0B   (hex)		COMPUTEX CO., LTD.
+00A00B     (base 16)		COMPUTEX CO., LTD.
+				432-13 GOJYOBASHI-HIGASHI 4-CHYOME
+				 HIGASHIYAMAKU, KYOTO-CITY 605    
+				JP
+
+00-A0-E2   (hex)		Keisokugiken Corporation
+00A0E2     (base 16)		Keisokugiken Corporation
+				2021-5 Houshakuji
+				Shioya-gun  Tochigi  329-1233
+				JP
+
+00-A0-33   (hex)		imc MeBsysteme GmbH
+00A033     (base 16)		imc MeBsysteme GmbH
+				VOLTASTRASSE 5
+				D-13355 BERLIN    
+				DE
+
+00-A0-A9   (hex)		NAVTEL COMMUNICATIONS INC.
+00A0A9     (base 16)		NAVTEL COMMUNICATIONS INC.
+				55 RENFREW DRIVE
+				MARKHAM, ONTARIO L3R 8H3    
+				CA
+
+00-A0-71   (hex)		VIDEO LOTTERY TECHNOLOGIES,INC
+00A071     (base 16)		VIDEO LOTTERY TECHNOLOGIES,INC
+				2311 SOUTH 7TH AVENUE
+				BOZEMAN  MT  59715
+				US
+
+00-60-00   (hex)		XYCOM INC.
+006000     (base 16)		XYCOM INC.
+				750 N. MAPLE
+				SALINE  MI  48176
+				US
+
+00-60-45   (hex)		PATHLIGHT TECHNOLOGIES
+006045     (base 16)		PATHLIGHT TECHNOLOGIES
+				767 WARREN ROAD
+				ITHACA  NY  14850
+				US
+
+00-A0-5D   (hex)		CS COMPUTER SYSTEME GmbH
+00A05D     (base 16)		CS COMPUTER SYSTEME GmbH
+				ISARSTRASSE 3,
+				82065 BAIERBRUNN    
+				DE
+
+00-A0-61   (hex)		PURITAN BENNETT
+00A061     (base 16)		PURITAN BENNETT
+				2200 FARADAY AVENUE
+				CARLSBAD  CA  92008
+				US
+
+00-60-A6   (hex)		PARTICLE MEASURING SYSTEMS
+0060A6     (base 16)		PARTICLE MEASURING SYSTEMS
+				5475 AIRPORT BLVD.
+				BOULDER  CO  80301
+				US
+
+00-60-2A   (hex)		SYMICRON COMPUTER COMMUNICATIONS, LTD.
+00602A     (base 16)		SYMICRON COMPUTER COMMUNICATIONS, LTD.
+				UNIT 4 GREEN LANE BUSINESS PARK
+				London SE9 3TL    
+				US
+
+00-A0-6D   (hex)		MANNESMANN TALLY CORPORATION
+00A06D     (base 16)		MANNESMANN TALLY CORPORATION
+				P.O. BOX 97018
+				KENT  WA  98064-9718
+				US
+
+00-A0-F6   (hex)		AutoGas Systems Inc.
+00A0F6     (base 16)		AutoGas Systems Inc.
+				P.O. BOX 6957
+				ABIOLENE  TX  79608
+				US
+
+00-60-BE   (hex)		WEBTRONICS
+0060BE     (base 16)		WEBTRONICS
+				3B-1  8-2-12
+				SHINAGAWA-KU TOKYO 141    
+				JP
+
+00-60-BF   (hex)		MACRAIGOR SYSTEMS, INC.
+0060BF     (base 16)		MACRAIGOR SYSTEMS, INC.
+				PO BOX 1008
+				BROOKLINE VILLAGE  MA  02147
+				US
+
+00-60-80   (hex)		MICROTRONIX DATACOM LTD.
+006080     (base 16)		MICROTRONIX DATACOM LTD.
+				4056 Meadowbrook Drive, Unit 126
+				LONDON  ONTARIO  N6L 1E3
+				CA
+
+00-A0-37   (hex)		Mindray DS USA, Inc.
+00A037     (base 16)		Mindray DS USA, Inc.
+				800 Macarthur Blvd.
+				Mahwah  NJ  07430
+				US
+
+00-A0-4C   (hex)		INNOVATIVE SYSTEMS & TECHNOLOGIES, INC.
+00A04C     (base 16)		INNOVATIVE SYSTEMS & TECHNOLOGIES, INC.
+				48511 WARM SPRINGS BLVD.
+				FREMONT  CA  94539
+				US
+
+00-A0-31   (hex)		HAZELTINE CORPORATION, MS 1-17
+00A031     (base 16)		HAZELTINE CORPORATION, MS 1-17
+				450 E. PULASKI ROAD
+				GREENLAWN  NY  11740
+				US
+
+00-A0-41   (hex)		INFICON
+00A041     (base 16)		INFICON
+				2 Technology Place
+				E. Syracuse  NY  13057
+				US
+
+00-A0-A7   (hex)		VORAX CORPORATION
+00A0A7     (base 16)		VORAX CORPORATION
+				1031 EAST DUANE AVENUE, STE H
+				SUNNYVALE  CA  94086
+				US
+
+00-A0-7E   (hex)		AVID TECHNOLOGY, INC.
+00A07E     (base 16)		AVID TECHNOLOGY, INC.
+				METROPOLITAN TECHNOLOGY PARK
+				TEWKSBURY  MA  01876
+				US
+
+00-A0-6F   (hex)		Color Sentinel Systems, LLC
+00A06F     (base 16)		Color Sentinel Systems, LLC
+				97 Ridgeland Rd, Suite #2
+				ROCHESTER  NY  14623
+				US
+
+00-A0-C7   (hex)		TADIRAN TELECOMMUNICATIONS
+00A0C7     (base 16)		TADIRAN TELECOMMUNICATIONS
+				P.O. BOX 500
+				PETAH-TIKVA 49104    
+				IL
+
+00-A0-1A   (hex)		BINAR ELEKTRONIK AB
+00A01A     (base 16)		BINAR ELEKTRONIK AB
+				MAGNETUAGEN 18
+				    
+				SE
+
+00-A0-88   (hex)		ESSENTIAL COMMUNICATIONS
+00A088     (base 16)		ESSENTIAL COMMUNICATIONS
+				4374 ALEXANDER BLVD. NE-STE
+				ALBUQUERQUE  NM  87107
+				US
+
+00-A0-C2   (hex)		R.A. SYSTEMS CO., LTD.
+00A0C2     (base 16)		R.A. SYSTEMS CO., LTD.
+				1850-3 HIROOKANOMURA
+				    
+				JP
+
+00-A0-98   (hex)		NetApp
+00A098     (base 16)		NetApp
+				1395 Crossman Ave
+				Sunnyvale,  CA  94089
+				US
+
+00-A0-4B   (hex)		TFL LAN INC.
+00A04B     (base 16)		TFL LAN INC.
+				9F, NO. 499 CHUNG CHENG ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-A0-64   (hex)		KVB/ANALECT
+00A064     (base 16)		KVB/ANALECT
+				9420 JERONIMO ROAD
+				IRVINE  CA  92718
+				US
+
+00-A0-3E   (hex)		ATM FORUM
+00A03E     (base 16)		ATM FORUM
+				WORLDWIDE HEADQUARTERS
+				FOSTER CITY  CA  94404-1138
+				US
+
+00-A0-1F   (hex)		TRICORD SYSTEMS, INC.
+00A01F     (base 16)		TRICORD SYSTEMS, INC.
+				2800 NORTHWEST BOULEVARD
+				PLYMOUTH  MN  55441-2625
+				US
+
+00-A0-FB   (hex)		TORAY ENGINEERING CO., LTD.
+00A0FB     (base 16)		TORAY ENGINEERING CO., LTD.
+				1-45, OE 1-CHOME, OTSU CITY
+				  520-21  
+				JP
+
+00-A0-6C   (hex)		SHINDENGEN ELECTRIC MFG. CO., LTD.
+00A06C     (base 16)		SHINDENGEN ELECTRIC MFG. CO., LTD.
+				10-13, MINAMI-CHO, HANNOU-CITY
+				SAITAMA 357    
+				JO
+
+00-A0-DB   (hex)		FISHER & PAYKEL PRODUCTION
+00A0DB     (base 16)		FISHER & PAYKEL PRODUCTION
+				MACHINERY LIMITED
+				    
+				NZ
+
+00-A0-81   (hex)		ALCATEL DATA NETWORKS
+00A081     (base 16)		ALCATEL DATA NETWORKS
+				12502 SUNRISE VALLEY DRIVE
+				RESTON  VA  22096
+				US
+
+00-A0-B1   (hex)		FIRST VIRTUAL CORPORATION
+00A0B1     (base 16)		FIRST VIRTUAL CORPORATION
+				3393 OCTAVIUS DR.-STE.# 102
+				SANTA CLARA  CA  95054
+				US
+
+00-20-10   (hex)		JEOL SYSTEM TECHNOLOGY CO. LTD
+002010     (base 16)		JEOL SYSTEM TECHNOLOGY CO. LTD
+				3-1-2 Musashino
+				Akishima-shi  Tokyo  196-8558
+				JP
+
+00-20-9F   (hex)		MERCURY COMPUTER SYSTEMS, INC.
+00209F     (base 16)		MERCURY COMPUTER SYSTEMS, INC.
+				199 RIVERNECK ROAD
+				CHELMSFORD  MA  01824
+				US
+
+00-A0-73   (hex)		COM21, INC.
+00A073     (base 16)		COM21, INC.
+				2113 LANDINGS DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-A0-3A   (hex)		KUBOTEK CORPORATION
+00A03A     (base 16)		KUBOTEK CORPORATION
+				56 NISHIAKETA-CHO, HIGASHIKUJO
+				    
+				JP
+
+00-A0-B2   (hex)		SHIMA SEIKI
+00A0B2     (base 16)		SHIMA SEIKI
+				85, SAKATA WAKAYAMA-CITY
+				    
+				JP
+
+00-A0-8B   (hex)		ASTON ELECTRONIC DESIGNS LTD.
+00A08B     (base 16)		ASTON ELECTRONIC DESIGNS LTD.
+				123/127 DEEPCUT BRIDGE ROAD
+				    ENGLAND
+				GB
+
+00-A0-97   (hex)		JC INFORMATION SYSTEMS
+00A097     (base 16)		JC INFORMATION SYSTEMS
+				4487 TECHNOLOGY DRIVE
+				FREMONT  CA  94538-6343
+				US
+
+00-A0-27   (hex)		FIREPOWER SYSTEMS, INC.
+00A027     (base 16)		FIREPOWER SYSTEMS, INC.
+				190 INDEPENDENCE DRIVE
+				MENLO PARK  CA  94025
+				US
+
+00-A0-46   (hex)		SCITEX CORP. LTD.
+00A046     (base 16)		SCITEX CORP. LTD.
+				P.O.BOX 330
+				    
+				IL
+
+00-A0-D4   (hex)		RADIOLAN,  INC.
+00A0D4     (base 16)		RADIOLAN,  INC.
+				454 DEGUIGNE DRIVE - STE
+				SUNNYVALE  CA  94086
+				US
+
+00-A0-92   (hex)		H. BOLLMANN MANUFACTURERS, LTD
+00A092     (base 16)		H. BOLLMANN MANUFACTURERS, LTD
+				26 VICTORIA WAY
+				  ENGLAND  
+				GB
+
+00-20-0D   (hex)		CARL ZEISS
+00200D     (base 16)		CARL ZEISS
+				POSTFACH 1380
+				    
+				DE
+
+00-20-2D   (hex)		TAIYO CORPORATION
+00202D     (base 16)		TAIYO CORPORATION
+				1-2-6 SANNOH, OHTA-KU
+				  143  
+				JP
+
+00-20-91   (hex)		J125, NATIONAL SECURITY AGENCY
+002091     (base 16)		J125, NATIONAL SECURITY AGENCY
+				9800 SAVAGE ROAD
+				FT. MEADE  MD  20755-6000
+				US
+
+00-20-BD   (hex)		NIOBRARA R & D CORPORATION
+0020BD     (base 16)		NIOBRARA R & D CORPORATION
+				PO BOX 3418
+				JOPLIN  MO  64803-3418
+				US
+
+00-20-54   (hex)		Sycamore Networks
+002054     (base 16)		Sycamore Networks
+				220 Mill Rd
+				Chelmsford  MA  01824
+				US
+
+00-20-A7   (hex)		PAIRGAIN TECHNOLOGIES, INC.
+0020A7     (base 16)		PAIRGAIN TECHNOLOGIES, INC.
+				14402 FRANKLIN AVENUE
+				TUSTIN  CA  92680-7013
+				US
+
+00-20-55   (hex)		ALTECH CO., LTD.
+002055     (base 16)		ALTECH CO., LTD.
+				OHISHI BLDG., 2-23-11
+				 TOKYO 116    
+				JP
+
+00-20-0A   (hex)		SOURCE-COMM CORP.
+00200A     (base 16)		SOURCE-COMM CORP.
+				25020 W. AVENUE STANFORD
+				VALENCIA  CA  91355
+				US
+
+00-20-CF   (hex)		TEST & MEASUREMENT SYSTEMS INC
+0020CF     (base 16)		TEST & MEASUREMENT SYSTEMS INC
+				2045 SITKA COURT
+				LOVELAND  CO  80538
+				US
+
+00-20-B4   (hex)		TERMA ELEKTRONIK AS
+0020B4     (base 16)		TERMA ELEKTRONIK AS
+				HOVMARKEN 4,
+				DK-8520 LYSTRUP    
+				DK
+
+00-20-E4   (hex)		HSING TECH ENTERPRISE CO., LTD
+0020E4     (base 16)		HSING TECH ENTERPRISE CO., LTD
+				NO. 2, LANE 128, SEC. 2
+				TEIPEI,    
+				TW
+
+00-20-6C   (hex)		EVERGREEN TECHNOLOGY CORP.
+00206C     (base 16)		EVERGREEN TECHNOLOGY CORP.
+				231 EMERSON STREET
+				PALO ALTO  CA  94301
+				US
+
+00-20-5E   (hex)		CASTLE ROCK, INC.
+00205E     (base 16)		CASTLE ROCK, INC.
+				20 SOUTH SANTA CRUZ AVE.
+				LOS GATOS  CA  95030
+				US
+
+00-20-12   (hex)		CAMTRONICS MEDICAL SYSTEMS
+002012     (base 16)		CAMTRONICS MEDICAL SYSTEMS
+				P.O. BOX 950
+				HARTLAND  WI  53029
+				US
+
+00-20-75   (hex)		MOTOROLA COMMUNICATION ISRAEL
+002075     (base 16)		MOTOROLA COMMUNICATION ISRAEL
+				3 KREMENETSKI STREET
+				TEL-AVIV  61250    
+				IL
+
+00-20-A5   (hex)		API ENGINEERING
+0020A5     (base 16)		API ENGINEERING
+				2689 POPLARWOOD WAY
+				SAN JOSE  CA  95132
+				US
+
+00-20-64   (hex)		PROTEC MICROSYSTEMS, INC.
+002064     (base 16)		PROTEC MICROSYSTEMS, INC.
+				297 LABROSSE
+				POINTE-CLAIRE, QUEBEC H9R 1A3    
+				CA
+
+00-20-33   (hex)		SYNAPSE TECHNOLOGIES, INC.
+002033     (base 16)		SYNAPSE TECHNOLOGIES, INC.
+				4822 ALBEMARLE ROAD, #104
+				CHARLOTTE  NC  28205
+				US
+
+00-20-CB   (hex)		PRETEC ELECTRONICS CORP.
+0020CB     (base 16)		PRETEC ELECTRONICS CORP.
+				39899 BALENTINE DR.
+				NEWARK  CA  94560
+				US
+
+00-20-EB   (hex)		CINCINNATI MICROWAVE, INC.
+0020EB     (base 16)		CINCINNATI MICROWAVE, INC.
+				ONE MICROWAVE PLAZA
+				CINCINNATI  OH  45249
+				US
+
+00-20-A0   (hex)		OA LABORATORY CO., LTD.
+0020A0     (base 16)		OA LABORATORY CO., LTD.
+				228 KAMIMACHIYA KAMAKURA
+				    
+				JP
+
+00-20-E2   (hex)		INFORMATION RESOURCE ENGINEERING
+0020E2     (base 16)		INFORMATION RESOURCE ENGINEERING
+				8029 CORPORATE DRIVE
+				BALTIMORE  MD  21236
+				US
+
+00-20-07   (hex)		SFA, INC.
+002007     (base 16)		SFA, INC.
+				1401 MCCORMICK DRIVE
+				LANDOVER  MD  20785
+				US
+
+00-20-5C   (hex)		InterNet Systems of Florida, Inc.
+00205C     (base 16)		InterNet Systems of Florida, Inc.
+				P.O. BOX 578
+				CRESTVIEW  FL  32536
+				US
+
+00-20-A2   (hex)		GALCOM NETWORKING LTD.
+0020A2     (base 16)		GALCOM NETWORKING LTD.
+				P.O. BOX 1568
+				RAMAT HASHARON 47113    
+				IL
+
+00-20-31   (hex)		Tattile SRL 
+002031     (base 16)		Tattile SRL 
+				AM PESTALOZZIRING 24
+				D-91058 ERLANGEN    
+				DE
+
+00-20-D0   (hex)		VERSALYNX CORPORATION
+0020D0     (base 16)		VERSALYNX CORPORATION
+				8950 CARLEY CIRCLE
+				SAN DIEGO  CA  92126
+				US
+
+00-20-B9   (hex)		METRICOM, INC.
+0020B9     (base 16)		METRICOM, INC.
+				980 UNIVERSITY AVENUE
+				LOS GATOS  CA  95030
+				US
+
+00-20-39   (hex)		SCINETS
+002039     (base 16)		SCINETS
+				1575 TENAKA - STE# N8
+				SUNNYVALE  CA  94087
+				US
+
+00-20-72   (hex)		WORKLINK INNOVATIONS
+002072     (base 16)		WORKLINK INNOVATIONS
+				2452 ARMSTRONG STREET
+				LIVERMORE  CA  9455O
+				US
+
+00-20-EC   (hex)		TECHWARE SYSTEMS CORP.
+0020EC     (base 16)		TECHWARE SYSTEMS CORP.
+				#100 - 12051 HORSESHOE WAY
+				  V7A  4V4
+				CA
+
+00-20-6E   (hex)		XACT, INC.
+00206E     (base 16)		XACT, INC.
+				P.O. BOX 55
+				ARGYLE  TX  76226
+				US
+
+00-20-F1   (hex)		ALTOS INDIA LIMITED
+0020F1     (base 16)		ALTOS INDIA LIMITED
+				D-60, OKLHLA INDUSTRIAL
+				    
+				IN
+
+00-20-41   (hex)		DATA NET
+002041     (base 16)		DATA NET
+				SUWON P.O. BOX 106, SUWON
+				  KOREA  440-600
+				KR
+
+00-20-76   (hex)		REUDO CORPORATION
+002076     (base 16)		REUDO CORPORATION
+				4-1-10 SHINSAN
+				    
+				JP
+
+00-20-E8   (hex)		DATATREK CORPORATION
+0020E8     (base 16)		DATATREK CORPORATION
+				4505 WYLAND DRIVE
+				ELKHART  IN  46516
+				US
+
+00-20-C5   (hex)		EAGLE TECHNOLOGY
+0020C5     (base 16)		EAGLE TECHNOLOGY
+				2865 ZANKER ROAD
+				SAN JOSE  CA  95134
+				US
+
+00-20-09   (hex)		PACKARD BELL ELEC., INC.
+002009     (base 16)		PACKARD BELL ELEC., INC.
+				9425 CANOGA AVENUE
+				CHATSWORTH  CA  913211
+				US
+
+00-20-27   (hex)		MING FORTUNE INDUSTRY CO., LTD
+002027     (base 16)		MING FORTUNE INDUSTRY CO., LTD
+				4F, NO. 800 CHUNG CHENG RD,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-20-8A   (hex)		SONIX COMMUNICATIONS, LTD.
+00208A     (base 16)		SONIX COMMUNICATIONS, LTD.
+				WILKINSON ROAD
+				    ENGLAND
+				GB
+
+00-20-D2   (hex)		RAD DATA COMMUNICATIONS, LTD.
+0020D2     (base 16)		RAD DATA COMMUNICATIONS, LTD.
+				8 HANECHOSHET STREET
+				    
+				KZ
+
+00-20-02   (hex)		SERITECH ENTERPRISE CO., LTD.
+002002     (base 16)		SERITECH ENTERPRISE CO., LTD.
+				FL. 182, NO. 531-1
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-20-4B   (hex)		AUTOCOMPUTER CO., LTD.
+00204B     (base 16)		AUTOCOMPUTER CO., LTD.
+				NO. 18, PEI YUAN ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-20-EA   (hex)		EFFICIENT NETWORKS, INC.
+0020EA     (base 16)		EFFICIENT NETWORKS, INC.
+				4201 SPRING VALLEY ROAD
+				DALLAS  TX  75244-3666
+				US
+
+00-20-6A   (hex)		OSAKA COMPUTER CORP.
+00206A     (base 16)		OSAKA COMPUTER CORP.
+				2-8 KOYACHOU NEYAGAW-SHI
+				    
+				JP
+
+00-20-DB   (hex)		XNET TECHNOLOGY, INC.
+0020DB     (base 16)		XNET TECHNOLOGY, INC.
+				426 S. HILLVIEW DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-20-BB   (hex)		ZAX CORPORATION
+0020BB     (base 16)		ZAX CORPORATION
+				20-12 OGIKUBO 5-CHOME
+				  167  
+				JP
+
+00-20-A8   (hex)		SAST TECHNOLOGY CORP.
+0020A8     (base 16)		SAST TECHNOLOGY CORP.
+				225 OLD NEW BRUNSWICK RD.
+				PISCATAWAY  NJ  08854
+				US
+
+00-20-45   (hex)		ION Networks, Inc.
+002045     (base 16)		ION Networks, Inc.
+				1551 South Washington Ave.
+				Piscataway  NJ  08854
+				US
+
+00-20-49   (hex)		COMTRON, INC.
+002049     (base 16)		COMTRON, INC.
+				SANCATHERINA BLDG.
+				TOKYO  160  
+				JP
+
+00-20-50   (hex)		KOREA COMPUTER INC.
+002050     (base 16)		KOREA COMPUTER INC.
+				469, DAEHEUNG-DONG
+				    KOREA
+				KR
+
+00-20-84   (hex)		OCE PRINTING SYSTEMS, GMBH
+002084     (base 16)		OCE PRINTING SYSTEMS, GMBH
+				SIEMENSALLEE 2
+				    
+				DE
+
+00-20-8C   (hex)		GALAXY NETWORKS, INC.
+00208C     (base 16)		GALAXY NETWORKS, INC.
+				9348 DE SOTO AVENUE
+				CHATSWORTH  CA  91311
+				US
+
+00-20-2C   (hex)		WELLTRONIX CO., LTD.
+00202C     (base 16)		WELLTRONIX CO., LTD.
+				3F, NO. 36-1, HWANG HSI STREET
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-20-21   (hex)		ALGORITHMS SOFTWARE PVT. LTD.
+002021     (base 16)		ALGORITHMS SOFTWARE PVT. LTD.
+				83 JOLLY MAKER CHAMBERS II
+				    
+				IN
+
+00-C0-F9   (hex)		Artesyn Embedded Technologies
+00C0F9     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way Suite 190
+				Tempe  AZ  85282
+				US
+
+00-C0-75   (hex)		XANTE CORPORATION
+00C075     (base 16)		XANTE CORPORATION
+				2559 EMOGENE STREET
+				MOBILE  AL  36606
+				US
+
+00-1C-7C   (hex)		PERQ SYSTEMS CORPORATION
+001C7C     (base 16)		PERQ SYSTEMS CORPORATION
+				2600 LIBERTY AVENUE
+				PITTSBURGH  PA  15230
+				US
+
+00-C0-39   (hex)		Teridian Semiconductor Corporation
+00C039     (base 16)		Teridian Semiconductor Corporation
+				6440 Oak Canyon
+				Irvine  CA  92618
+				US
+
+00-C0-A9   (hex)		BARRON MCCANN LTD.
+00C0A9     (base 16)		BARRON MCCANN LTD.
+				BEMAC HOUSE
+				  UNITED  KINGDOM
+				GB
+
+00-C0-4B   (hex)		CREATIVE MICROSYSTEMS
+00C04B     (base 16)		CREATIVE MICROSYSTEMS
+				9, AVENUE DU CANADA
+				91966  LES  ULIS---FRANC
+				FR
+
+00-C0-B9   (hex)		FUNK SOFTWARE, INC.
+00C0B9     (base 16)		FUNK SOFTWARE, INC.
+				222 THIRD STREET
+				CAMBRIDGE  MA  02142
+				US
+
+00-C0-15   (hex)		NEW MEDIA CORPORATION
+00C015     (base 16)		NEW MEDIA CORPORATION
+				15375 BARRANCA PARKWAY
+				IRVINE  CA  92718
+				US
+
+00-C0-83   (hex)		TRACE MOUNTAIN PRODUCTS, INC.
+00C083     (base 16)		TRACE MOUNTAIN PRODUCTS, INC.
+				1040 EAST BROKAW ROAD
+				SAN JOSE  CA  95131
+				US
+
+00-C0-94   (hex)		VMX INC.
+00C094     (base 16)		VMX INC.
+				2115 O'NEL DRIVE
+				SAN JOSE  CA  95131
+				US
+
+00-C0-19   (hex)		LEAP TECHNOLOGY, INC.
+00C019     (base 16)		LEAP TECHNOLOGY, INC.
+				20
+				BURLINGTON  MA  01803
+				US
+
+00-C0-CF   (hex)		IMATRAN VOIMA OY
+00C0CF     (base 16)		IMATRAN VOIMA OY
+				IVO
+				    
+				FI
+
+00-C0-7D   (hex)		RISC DEVELOPMENTS LTD.
+00C07D     (base 16)		RISC DEVELOPMENTS LTD.
+				117 HATFIELD ROAD
+				    ENGLAND
+				GB
+
+00-C0-43   (hex)		STRATACOM
+00C043     (base 16)		STRATACOM
+				1400 PARKMOOR AVENUE
+				SAN JOSE  CA  95126
+				US
+
+00-C0-B5   (hex)		CORPORATE NETWORK SYSTEMS,INC.
+00C0B5     (base 16)		CORPORATE NETWORK SYSTEMS,INC.
+				5711 SIX FORKS ROAD--STE #306
+				RALEIGH  NC  27609
+				US
+
+00-C0-ED   (hex)		US ARMY ELECTRONIC
+00C0ED     (base 16)		US ARMY ELECTRONIC
+				PROVING GROUND
+				SIERRA VISTA  AZ  85635
+				US
+
+00-C0-32   (hex)		I-CUBED LIMITED
+00C032     (base 16)		I-CUBED LIMITED
+				UNIT J1, THE POADDOCKS
+				CB1 4DH  CB1 4DH  ENGLAND
+				GB
+
+00-C0-A5   (hex)		DICKENS DATA SYSTEMS
+00C0A5     (base 16)		DICKENS DATA SYSTEMS
+				1175 NORTHMEADOW PKWY-STE #150
+				ROSWELL  GA  30076
+				US
+
+00-C0-EF   (hex)		ABIT CORPORATION
+00C0EF     (base 16)		ABIT CORPORATION
+				29-11 HIRAOKA-CHO
+				  192  
+				JP
+
+00-C0-61   (hex)		SOLECTEK CORPORATION
+00C061     (base 16)		SOLECTEK CORPORATION
+				6370 NANCY RIDGE DR.-STE.#109
+				SAN DIEGO  CA  92121
+				US
+
+00-C0-AD   (hex)		MARBEN COMMUNICATION SYSTEMS
+00C0AD     (base 16)		MARBEN COMMUNICATION SYSTEMS
+				1 RUE DU BOIS CHALAND
+				    
+				FR
+
+00-C0-7F   (hex)		NUPON COMPUTING CORP.
+00C07F     (base 16)		NUPON COMPUTING CORP.
+				1391 WARNER AVE., -SUITE
+				TUSTIN  CA  92680
+				US
+
+00-C0-57   (hex)		MYCO ELECTRONICS
+00C057     (base 16)		MYCO ELECTRONICS
+				MUSSERONGRAND 1G
+				    
+				SE
+
+00-C0-56   (hex)		SOMELEC
+00C056     (base 16)		SOMELEC
+				BP 7010 - 95050
+				    
+				FR
+
+00-C0-27   (hex)		CIPHER SYSTEMS, INC.
+00C027     (base 16)		CIPHER SYSTEMS, INC.
+				22115 NW Imbrie Dr #285
+				Hillsboro  OR  97124
+				US
+
+00-C0-5C   (hex)		ELONEX PLC
+00C05C     (base 16)		ELONEX PLC
+				2 APSLEY WAY
+				  UNITED  KINGDOM
+				GB
+
+00-C0-28   (hex)		JASCO CORPORATION
+00C028     (base 16)		JASCO CORPORATION
+				2967-5 ISHIKAWA-CHO,
+				    
+				JP
+
+00-C0-8D   (hex)		TRONIX PRODUCT DEVELOPMENT
+00C08D     (base 16)		TRONIX PRODUCT DEVELOPMENT
+				4908 E. MCDOWELL RD. STE.#100
+				PHOENIX  AZ  85008
+				US
+
+00-C0-2A   (hex)		OHKURA ELECTRIC CO., LTD.
+00C02A     (base 16)		OHKURA ELECTRIC CO., LTD.
+				2-90-20 SHIRAKO WAKO CITY
+				  351-01  
+				JP
+
+00-C0-FC   (hex)		ELASTIC REALITY, INC.
+00C0FC     (base 16)		ELASTIC REALITY, INC.
+				925 STEWART STREET
+				MADISON  WI  53713
+				US
+
+00-C0-BB   (hex)		FORVAL CREATIVE, INC.
+00C0BB     (base 16)		FORVAL CREATIVE, INC.
+				3-27-12 HONGO
+				    
+				JP
+
+00-C0-E0   (hex)		DSC COMMUNICATION CORP.
+00C0E0     (base 16)		DSC COMMUNICATION CORP.
+				1000 COIT ROAD,  MS#ADVP 3
+				PLANO  TX  75075
+				US
+
+00-C0-5B   (hex)		NETWORKS NORTHWEST, INC.
+00C05B     (base 16)		NETWORKS NORTHWEST, INC.
+				P.O. BOX 1188
+				ISSAQUAH  WA  98027
+				US
+
+00-C0-08   (hex)		SECO SRL
+00C008     (base 16)		SECO SRL
+				VIA CALAMANDREI 91
+				    
+				IT
+
+00-C0-B7   (hex)		AMERICAN POWER CONVERSION CORP
+00C0B7     (base 16)		AMERICAN POWER CONVERSION CORP
+				267 BOSTON ROAD #2
+				NORTH BILLERICA  MA  01862
+				US
+
+00-C0-D3   (hex)		OLYMPUS IMAGE SYSTEMS, INC.
+00C0D3     (base 16)		OLYMPUS IMAGE SYSTEMS, INC.
+				15271 BARRANCA PARKWAY
+				IRVINE  CA  92718-2201
+				US
+
+00-C0-E8   (hex)		PLEXCOM, INC.
+00C0E8     (base 16)		PLEXCOM, INC.
+				65 MORELAND ROADENUYE
+				SIMI VALLEY  CA  93065
+				US
+
+00-C0-DA   (hex)		NICE SYSTEMS LTD.
+00C0DA     (base 16)		NICE SYSTEMS LTD.
+				3 TEVUOT HA'ARETZ ST
+				    
+				IL
+
+00-C0-D1   (hex)		COMTREE TECHNOLOGY CORPORATION
+00C0D1     (base 16)		COMTREE TECHNOLOGY CORPORATION
+				5F-7, NO. 1, FU-HSING NORTH RD
+				  TAIWAN  R.O.C.
+				CN
+
+00-C0-38   (hex)		RASTER IMAGE PROCESSING SYSTEM
+00C038     (base 16)		RASTER IMAGE PROCESSING SYSTEM
+				4665 NAUTILUS COURT SOUTH
+				BOULDER  CO  80301
+				US
+
+00-40-9B   (hex)		HAL COMPUTER SYSTEMS INC.
+00409B     (base 16)		HAL COMPUTER SYSTEMS INC.
+				1315 DELL AVENUE
+				CAMPBELL  CA  95008
+				US
+
+00-40-EB   (hex)		MARTIN MARIETTA CORPORATION
+0040EB     (base 16)		MARTIN MARIETTA CORPORATION
+				12506 LAKE UNDERHILL
+				ORLANDO  FL  32825
+				US
+
+00-40-BD   (hex)		STARLIGHT NETWORKS, INC.
+0040BD     (base 16)		STARLIGHT NETWORKS, INC.
+				444 CASTRO STREET STE
+				MOUNTAIN VIEW  CA  94041
+				US
+
+00-40-ED   (hex)		NETWORK CONTROLS INT'NATL INC.
+0040ED     (base 16)		NETWORK CONTROLS INT'NATL INC.
+				9 WOODLAWN GREEN
+				CHARLOTTE  NC  28217
+				US
+
+00-40-21   (hex)		RASTER GRAPHICS
+004021     (base 16)		RASTER GRAPHICS
+				285 N. WOLFE ROAD
+				SUNNYVALE  CA  94086
+				US
+
+00-40-C1   (hex)		BIZERBA-WERKE WILHEIM KRAUT
+0040C1     (base 16)		BIZERBA-WERKE WILHEIM KRAUT
+				GMBH & CO. KG,
+				D-7460 BALINGEN  D-7460 BALINGEN  
+				DE
+
+00-40-E1   (hex)		MARNER INTERNATIONAL, INC.
+0040E1     (base 16)		MARNER INTERNATIONAL, INC.
+				1617 93RD LANE NE
+				BLAINE  MN  55449
+				US
+
+00-40-FE   (hex)		SYMPLEX COMMUNICATIONS
+0040FE     (base 16)		SYMPLEX COMMUNICATIONS
+				5 RESEARCH DRIVE
+				ANN ARBOR  MI  48103
+				US
+
+00-40-E5   (hex)		SYBUS CORPORATION
+0040E5     (base 16)		SYBUS CORPORATION
+				2300 TALL PINE DRIVE-STE. #100
+				LARGO  FL  34641
+				US
+
+00-40-A5   (hex)		CLINICOMP INTL.
+0040A5     (base 16)		CLINICOMP INTL.
+				4510 EXECCUTIVE DRIVE-STE.#200
+				SAN DIEGO  CA  92121
+				US
+
+00-40-05   (hex)		ANI COMMUNICATIONS INC.
+004005     (base 16)		ANI COMMUNICATIONS INC.
+				8 ANZIO
+				IRVINE  CA  92714
+				US
+
+00-40-D9   (hex)		AMERICAN MEGATRENDS INC.
+0040D9     (base 16)		AMERICAN MEGATRENDS INC.
+				6145F N BELT PARKWAY
+				NORCROSS  GA  30071
+				US
+
+00-40-4C   (hex)		HYPERTEC PTY LTD.
+00404C     (base 16)		HYPERTEC PTY LTD.
+				P.O. BOX 1782
+				    
+				AU
+
+00-C0-30   (hex)		INTEGRATED ENGINEERING B. V.
+00C030     (base 16)		INTEGRATED ENGINEERING B. V.
+				ELLERMANSTRAAT 15
+				  THE  
+				NL
+
+00-C0-A6   (hex)		EXICOM AUSTRALIA PTY. LTD
+00C0A6     (base 16)		EXICOM AUSTRALIA PTY. LTD
+				44-46 MANDARIN STREET
+				    
+				AU
+
+00-C0-CB   (hex)		CONTROL TECHNOLOGY CORPORATION
+00C0CB     (base 16)		CONTROL TECHNOLOGY CORPORATION
+				25 SOUTH STREET
+				HOPKINTON  MA  01748
+				US
+
+00-C0-EB   (hex)		SEH COMPUTERTECHNIK GMBH
+00C0EB     (base 16)		SEH COMPUTERTECHNIK GMBH
+				Suedring 11
+				    
+				DE
+
+00-40-DB   (hex)		ADVANCED TECHNICAL SOLUTIONS
+0040DB     (base 16)		ADVANCED TECHNICAL SOLUTIONS
+				8050 SEMINOLE OFFICE CENTER
+				SEMINOLE  FL  34642
+				US
+
+00-C0-92   (hex)		MENNEN MEDICAL INC.
+00C092     (base 16)		MENNEN MEDICAL INC.
+				10123 MAIN STREET
+				CLARENCE  NY  14031-2095
+				US
+
+00-C0-52   (hex)		BURR-BROWN
+00C052     (base 16)		BURR-BROWN
+				P.O. BOX 11400
+				TUCSON  AZ  85734-1400
+				US
+
+00-40-0E   (hex)		MEMOTEC, INC.
+00400E     (base 16)		MEMOTEC, INC.
+				7755 Henri-Bourassa
+				MONTREAL, QUEBEC     H4S 1P7
+				CA
+
+00-C0-3D   (hex)		WIESEMANN & THEIS GMBH
+00C03D     (base 16)		WIESEMANN & THEIS GMBH
+				WITTENER STR. 312
+				    
+				DE
+
+00-40-C8   (hex)		MILAN TECHNOLOGY CORPORATION
+0040C8     (base 16)		MILAN TECHNOLOGY CORPORATION
+				894 ROSS DRIVE--STE #105
+				SUNNYVALE  CA  94089
+				US
+
+00-40-BA   (hex)		ALLIANT COMPUTER SYSTEMS CORP.
+0040BA     (base 16)		ALLIANT COMPUTER SYSTEMS CORP.
+				ONE MONARCH DRIVE
+				LITTLETON  MA  01460
+				US
+
+00-40-38   (hex)		TALENT ELECTRIC INCORPORATED
+004038     (base 16)		TALENT ELECTRIC INCORPORATED
+				3RD FL., NO. 260, PA TEH ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-40-D8   (hex)		OCEAN OFFICE AUTOMATION LTD.
+0040D8     (base 16)		OCEAN OFFICE AUTOMATION LTD.
+				4TH & 5TH FLOOR, KADER BLDG.
+				  HONG  KONG
+				HK
+
+00-40-88   (hex)		MOBIUS TECHNOLOGIES, INC.
+004088     (base 16)		MOBIUS TECHNOLOGIES, INC.
+				5835 DOYLE STREET
+				EMERYVILLE  CA  94608
+				US
+
+00-40-32   (hex)		DIGITAL COMMUNICATIONS
+004032     (base 16)		DIGITAL COMMUNICATIONS
+				ASSOCIATES, INC.
+				SAN JOSE  CA  95131
+				US
+
+00-40-C2   (hex)		APPLIED COMPUTING DEVICES
+0040C2     (base 16)		APPLIED COMPUTING DEVICES
+				ALEPH PARK
+				TERRE HAUTE  IN  47802
+				US
+
+00-40-D4   (hex)		GAGE TALKER CORP.
+0040D4     (base 16)		GAGE TALKER CORP.
+				13680 NE 16TH STREET
+				BELLEVUE  WA  98005
+				US
+
+00-40-CE   (hex)		NET-SOURCE, INC.
+0040CE     (base 16)		NET-SOURCE, INC.
+				1265 EL CAMINO REAL
+				SANTA CLARA  CA  95050
+				US
+
+00-40-62   (hex)		E-SYSTEMS, INC./GARLAND DIV.
+004062     (base 16)		E-SYSTEMS, INC./GARLAND DIV.
+				P.O. BOX 660023
+				DALLAS  TX  75266-0023
+				US
+
+00-40-34   (hex)		BUSTEK CORPORATION
+004034     (base 16)		BUSTEK CORPORATION
+				4151 BURTON DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-40-1C   (hex)		AST RESEARCH, INC.
+00401C     (base 16)		AST RESEARCH, INC.
+				MS 2-78
+				IRVINE  CA  92618
+				US
+
+00-40-0F   (hex)		DATACOM TECHNOLOGIES
+00400F     (base 16)		DATACOM TECHNOLOGIES
+				11001 31ST PLACE WEST
+				EVERETT  WA  98204
+				US
+
+00-40-06   (hex)		SAMPO TECHNOLOGY CORPORATION
+004006     (base 16)		SAMPO TECHNOLOGY CORPORATION
+				26-2 TING-HU,
+				33334 TAIWAN  33334 TAIWAN  R.O.C.
+				TW
+
+00-80-AA   (hex)		MAXPEED
+0080AA     (base 16)		MAXPEED
+				1120 CHESS DRIVE
+				FOSTER CITY  CA  94404
+				US
+
+00-C0-50   (hex)		TOYO DENKI SEIZO K.K.
+00C050     (base 16)		TOYO DENKI SEIZO K.K.
+				4-6-32 HIGASHIKASHIWAGAYA
+				KANAGAWA  JAPAN  243-04
+				JP
+
+00-40-C6   (hex)		FIBERNET RESEARCH, INC.
+0040C6     (base 16)		FIBERNET RESEARCH, INC.
+				1 TARA BOULEVARD-#405
+				NASHUA  NH  03062
+				US
+
+00-40-47   (hex)		WIND RIVER SYSTEMS
+004047     (base 16)		WIND RIVER SYSTEMS
+				1010 ATLANTIC AVENUE
+				ALAMEDA  CA  94501
+				US
+
+00-40-50   (hex)		IRONICS, INCORPORATED
+004050     (base 16)		IRONICS, INCORPORATED
+				767 WARREN RD
+				ITHACA  N.Y.  14850
+				US
+
+00-80-92   (hex)		Silex Technology, Inc.
+008092     (base 16)		Silex Technology, Inc.
+				2-3-1 Hikaridai,
+				Kyoto    619-0237
+				JP
+
+00-80-93   (hex)		XYRON CORPORATION
+008093     (base 16)		XYRON CORPORATION
+				7864 LILY COURT
+				CUPERTINO  CA  95014
+				US
+
+00-80-5A   (hex)		TULIP COMPUTERS INTERNAT'L B.V
+00805A     (base 16)		TULIP COMPUTERS INTERNAT'L B.V
+				P.O. BOX 3333
+				  THE  
+				NL
+
+00-40-41   (hex)		FUJIKURA LTD.
+004041     (base 16)		FUJIKURA LTD.
+				1-5-1, KIBA, KOTO-KU
+				    
+				JP
+
+00-80-4E   (hex)		APEX COMPUTER COMPANY
+00804E     (base 16)		APEX COMPUTER COMPANY
+				4500 150TH AVENUE, NE
+				REDMOND  WA  98052
+				US
+
+00-80-55   (hex)		FERMILAB
+008055     (base 16)		FERMILAB
+				P.O. BOX 500, MS-234
+				BATAVIA  IL  60510
+				US
+
+00-80-2A   (hex)		TEST SYSTEMS & SIMULATIONS INC
+00802A     (base 16)		TEST SYSTEMS & SIMULATIONS INC
+				32429 INDUSTRIAL DRIVE
+				MADISON HEIGHTS  MI  48071-1528
+				US
+
+00-80-35   (hex)		TECHNOLOGY WORKS, INC.
+008035     (base 16)		TECHNOLOGY WORKS, INC.
+				4030 BRAKER LANE #350
+				AUSTIN  TX  78759
+				US
+
+00-80-7E   (hex)		SOUTHERN PACIFIC LTD.
+00807E     (base 16)		SOUTHERN PACIFIC LTD.
+				SANWA BLDG., 2-16-20
+				JAPAN  JAPAN  220
+				JP
+
+00-80-EF   (hex)		RATIONAL
+0080EF     (base 16)		RATIONAL
+				3320 SCOTT BOULEVARD
+				SANTA CLARA  CA  95054
+				US
+
+00-80-F0   (hex)		Panasonic Communications Co., Ltd.
+0080F0     (base 16)		Panasonic Communications Co., Ltd.
+				4-1-62 Minoshima Hakata Fukuoka
+				    812-8531
+				JP
+
+00-80-1D   (hex)		INTEGRATED INFERENCE MACHINES
+00801D     (base 16)		INTEGRATED INFERENCE MACHINES
+				1468 EAST KATELLA
+				ANAHEIM  CA  92805
+				US
+
+00-80-75   (hex)		PARSYTEC GMBH
+008075     (base 16)		PARSYTEC GMBH
+				JUELICHER STR. 338
+				  F.R.  
+				DE
+
+00-80-51   (hex)		FIBERMUX
+008051     (base 16)		FIBERMUX
+				9310 TOPANGA CANYON BLVD.
+				CHATSWORTH  CA  91311
+				US
+
+00-80-C6   (hex)		NATIONAL DATACOMM CORPORATION
+0080C6     (base 16)		NATIONAL DATACOMM CORPORATION
+				2F, 28, INDUSTRY EAST 9TH RD.
+				TAIWAN  30077  TAIWAN  30077  R.O.C.
+				TW
+
+00-80-C0   (hex)		PENRIL DATACOMM
+0080C0     (base 16)		PENRIL DATACOMM
+				1300 QUINCE ORCHARD BLVD.
+				GAITHERSBURG  MD  20878
+				US
+
+00-80-2E   (hex)		CASTLE ROCK COMPUTING
+00802E     (base 16)		CASTLE ROCK COMPUTING
+				20837 BOYCE LANE
+				SARATOGA  CA  95070-4806
+				US
+
+00-80-F2   (hex)		RAYCOM SYSTEMS INC
+0080F2     (base 16)		RAYCOM SYSTEMS INC
+				16525 SHERMAN WAY #C-8
+				VAN NUYS  CA  91406
+				US
+
+00-80-BD   (hex)		THE FURUKAWA ELECTRIC CO., LTD
+0080BD     (base 16)		THE FURUKAWA ELECTRIC CO., LTD
+				6-1, MARUNOUCHI 2-CHOME
+				  100  
+				JP
+
+00-80-25   (hex)		Telit Wireless Solutions GmbH
+008025     (base 16)		Telit Wireless Solutions GmbH
+				Mendelssohnstrasse15D
+				Hamburg    22761
+				DE
+
+00-80-EA   (hex)		ADVA Optical Networking Ltd.
+0080EA     (base 16)		ADVA Optical Networking Ltd.
+				ADVAntage House
+				York    YO30 4RY
+				GB
+
+00-00-1E   (hex)		TELSIST INDUSTRIA ELECTRONICA
+00001E     (base 16)		TELSIST INDUSTRIA ELECTRONICA
+				RUA VILHENA DE MORAES, 380
+				    
+				BR
+
+00-00-50   (hex)		RADISYS CORPORATION
+000050     (base 16)		RADISYS CORPORATION
+				15025 S.W. KOLL PARKWAY
+				BEAVERTON  OR  97006-6056
+				US
+
+00-80-04   (hex)		ANTLOW COMMUNICATIONS, LTD.
+008004     (base 16)		ANTLOW COMMUNICATIONS, LTD.
+				4 COLTHROP WAY
+				    ENGLAND
+				GB
+
+00-80-D0   (hex)		COMPUTER PERIPHERALS, INC.
+0080D0     (base 16)		COMPUTER PERIPHERALS, INC.
+				667 RANCHO CONEJO BLVD.
+				NEWBURY PARK  CA  91320
+				US
+
+00-80-24   (hex)		KALPANA, INC.
+008024     (base 16)		KALPANA, INC.
+				1154 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-80-40   (hex)		JOHN FLUKE MANUFACTURING CO.
+008040     (base 16)		JOHN FLUKE MANUFACTURING CO.
+				P.O. BOX C9090-M/S 244F
+				EVERETT  WA  98206
+				US
+
+00-80-21   (hex)		Alcatel Canada Inc.
+008021     (base 16)		Alcatel Canada Inc.
+				349 Terry Fox Drive
+				Kanata  Ontario  K2K 2V6
+				CA
+
+00-80-E8   (hex)		CUMULUS CORPORATIION
+0080E8     (base 16)		CUMULUS CORPORATIION
+				23500 MERCANTILE ROAD
+				CLEVELAND  OH  44122
+				US
+
+00-80-69   (hex)		COMPUTONE SYSTEMS
+008069     (base 16)		COMPUTONE SYSTEMS
+				1100 NORTHMEADOW PARKWAY
+				ROSWELL  GA  30076
+				US
+
+00-80-0D   (hex)		VOSSWINKEL F.U.
+00800D     (base 16)		VOSSWINKEL F.U.
+				AM JOSTENHOF 15
+				    
+				DE
+
+00-80-D1   (hex)		KIMTRON CORPORATION
+0080D1     (base 16)		KIMTRON CORPORATION
+				1709 JUNCTION COURT
+				SAN JOSE  CA  95112
+				US
+
+00-80-42   (hex)		Artesyn Embedded Technologies
+008042     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way
+				Tempe  AZ  85282
+				US
+
+00-80-9A   (hex)		NOVUS NETWORKS LTD
+00809A     (base 16)		NOVUS NETWORKS LTD
+				JOHN SCOTT HOUSE
+				    ENGLAND
+				GB
+
+00-80-00   (hex)		MULTITECH SYSTEMS, INC.
+008000     (base 16)		MULTITECH SYSTEMS, INC.
+				2205 WOODALE DRIVE
+				MOUNDS VIEW  MN  55112
+				US
+
+00-80-ED   (hex)		IQ TECHNOLOGIES, INC.
+0080ED     (base 16)		IQ TECHNOLOGIES, INC.
+				11811 NE FIRST STREET
+				BELLEVUE  WA  98005
+				US
+
+00-80-4A   (hex)		PRO-LOG
+00804A     (base 16)		PRO-LOG
+				12 UPPER RAGSDALE DRIVE
+				MONTEREY  CA  93940
+				US
+
+00-00-66   (hex)		TALARIS SYSTEMS, INC.
+000066     (base 16)		TALARIS SYSTEMS, INC.
+				11339 SORRENTO VALLEY ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-00-49   (hex)		APRICOT COMPUTERS, LTD
+000049     (base 16)		APRICOT COMPUTERS, LTD
+				90 VINCENT DRIVE
+				    ENGLAND
+				GB
+
+00-00-FA   (hex)		MICROSAGE COMPUTER SYSTEMS INC
+0000FA     (base 16)		MICROSAGE COMPUTER SYSTEMS INC
+				680 SOUTH ROCK BLVD
+				RENO  NE  89502
+				US
+
+00-00-D4   (hex)		PURE DATA LTD.
+0000D4     (base 16)		PURE DATA LTD.
+				200 WEST BEAVER CREEK ROAD
+				L4B  1B4  
+				CA
+
+00-00-19   (hex)		APPLIED DYNAMICS INTERNATIONAL
+000019     (base 16)		APPLIED DYNAMICS INTERNATIONAL
+				3800 STONE SCHOOL ROAD
+				ANN ARBOR  MI  48104-2499
+				US
+
+00-00-15   (hex)		DATAPOINT CORPORATION
+000015     (base 16)		DATAPOINT CORPORATION
+				9725 DATAPOINT DRIVE
+				SAN ANTONIO  TX  78284
+				US
+
+00-00-1C   (hex)		BELL TECHNOLOGIES
+00001C     (base 16)		BELL TECHNOLOGIES
+				330 WARREN AVENUE
+				FREMONT  CA  94539
+				US
+
+00-00-34   (hex)		NETWORK RESOURCES CORPORATION
+000034     (base 16)		NETWORK RESOURCES CORPORATION
+				61 EAST DAGGETT DRIVE
+				SAN JOSE  CA  95134
+				US
+
+00-00-22   (hex)		VISUAL TECHNOLOGY INC.
+000022     (base 16)		VISUAL TECHNOLOGY INC.
+				1703 MIDDLESEX STREET
+				LOWELL  MA  01851
+				US
+
+00-00-B5   (hex)		DATABILITY SOFTWARE SYS. INC.
+0000B5     (base 16)		DATABILITY SOFTWARE SYS. INC.
+				ONE PALMER TERRACE
+				CARLSTADT  NJ  07072
+				US
+
+00-00-2F   (hex)		TIMEPLEX INC.
+00002F     (base 16)		TIMEPLEX INC.
+				530 CHESTNUT RIDGE ROAD
+				WOODCLIFF LAKE  NJ  07675
+				US
+
+00-00-B8   (hex)		SEIKOSHA CO., LTD.
+0000B8     (base 16)		SEIKOSHA CO., LTD.
+				SYSTEM EQUIPMENT DIVISION
+				    
+				JP
+
+00-00-E6   (hex)		APTOR PRODUITS DE COMM INDUST
+0000E6     (base 16)		APTOR PRODUITS DE COMM INDUST
+				61, CHEMIN DU VIEUX-CHENE
+				    
+				FR
+
+00-00-84   (hex)		SUPERNET
+000084     (base 16)		SUPERNET
+				846 DEL REY AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-00-9A   (hex)		RC COMPUTER A/S
+00009A     (base 16)		RC COMPUTER A/S
+				LAUTRUPBJERG 1
+				    
+				DK
+
+00-00-27   (hex)		JAPAN RADIO COMPANY
+000027     (base 16)		JAPAN RADIO COMPANY
+				LABORATORY
+				    
+				JP
+
+00-00-E8   (hex)		ACCTON TECHNOLOGY CORP.
+0000E8     (base 16)		ACCTON TECHNOLOGY CORP.
+				46750 FREMONT BLVD. #104
+				FREMONT  CA  94538
+				US
+
+00-00-4B   (hex)		ICL DATA OY
+00004B     (base 16)		ICL DATA OY
+				KUTOMOTIE 16-18
+				    
+				FI
+
+00-00-E0   (hex)		QUADRAM CORP.
+0000E0     (base 16)		QUADRAM CORP.
+				ONE QUAD WAY
+				NORCROSS  GA  30093
+				US
+
+00-00-AB   (hex)		LOGIC MODELING CORPORATION
+0000AB     (base 16)		LOGIC MODELING CORPORATION
+				1520 MCCANDLESS DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-80-AC   (hex)		IMLOGIX, DIVISION OF GENESYS
+0080AC     (base 16)		IMLOGIX, DIVISION OF GENESYS
+				1900 SUMMIT TOWER BLVD.STE#770
+				ORLANDO  FL  32810
+				US
+
+00-00-4F   (hex)		LOGICRAFT, INC.
+00004F     (base 16)		LOGICRAFT, INC.
+				22 COTTON ROAD
+				NASHUA  NH  03063
+				US
+
+00-00-6F   (hex)		Madge Ltd.
+00006F     (base 16)		Madge Ltd.
+				Madge House
+				Maindenhead  Berkshire  SL6 2HP
+				GB
+
+00-00-78   (hex)		LABTAM LIMITED
+000078     (base 16)		LABTAM LIMITED
+				43 MALCOLM ROAD   P.O. BOX297
+				    
+				AU
+
+00-00-5A   (hex)		SysKonnect GmbH
+00005A     (base 16)		SysKonnect GmbH
+				SIEMENSSTRAßE 23
+				    
+				DE
+
+00-00-5B   (hex)		ELTEC ELEKTRONIK AG
+00005B     (base 16)		ELTEC ELEKTRONIK AG
+				Galileo-Galilei-Strasse 11
+				    
+				DE
+
+00-00-71   (hex)		ADRA SYSTEMS INC.
+000071     (base 16)		ADRA SYSTEMS INC.
+				59 TECHNOLOGY DRIVE
+				LOWELL  MA  01851
+				US
+
+00-00-73   (hex)		SIECOR CORPORATION
+000073     (base 16)		SIECOR CORPORATION
+				P.O. BOX 13625
+				RESEARCH TRIANGLE PK  NC  27709
+				US
+
+00-00-B9   (hex)		MCDONNELL DOUGLAS COMPUTER SYS
+0000B9     (base 16)		MCDONNELL DOUGLAS COMPUTER SYS
+				DIV MCDONNELL DOUGLAS INF SYS
+				    ENGLAND
+				GB
+
+00-00-BF   (hex)		SYMMETRIC COMPUTER SYSTEMS
+0000BF     (base 16)		SYMMETRIC COMPUTER SYSTEMS
+				1620 OAKLAND ROAD  SUITE D-200
+				SAN JOSE  CA  95131
+				US
+
+00-00-2D   (hex)		CHROMATICS INC
+00002D     (base 16)		CHROMATICS INC
+				2558 MOUNTAIN INDUSTRIAL BLVD
+				TUCKER  GA  30084
+				US
+
+00-00-18   (hex)		WEBSTER COMPUTER CORPORATION
+000018     (base 16)		WEBSTER COMPUTER CORPORATION
+				16040 REDWOOD LODGE ROAD
+				LOS GATOS  CA  95033-9260
+				US
+
+00-00-C8   (hex)		ALTOS COMPUTER SYSTEMS
+0000C8     (base 16)		ALTOS COMPUTER SYSTEMS
+				2641 ORCHARD PARKWAY
+				SAN JOSE  CA  95134
+				US
+
+00-00-D5   (hex)		MICROGNOSIS INTERNATIONAL
+0000D5     (base 16)		MICROGNOSIS INTERNATIONAL
+				63 QUEEN VICTORIA STREET
+				  UNITED  KINGDOM
+				GB
+
+00-00-3A   (hex)		CHYRON CORPORATION
+00003A     (base 16)		CHYRON CORPORATION
+				265 SPAGNOLI ROAD
+				MELVILLE  NY  11747
+				US
+
+00-00-59   (hex)		Hellige GMBH
+000059     (base 16)		Hellige GMBH
+				Heinrich-von-Stephan-Str. 4
+				  West Gernany  
+				DE
+
+00-00-69   (hex)		CONCORD COMMUNICATIONS INC
+000069     (base 16)		CONCORD COMMUNICATIONS INC
+				753 FOREST STREET
+				MARLBOROUGH  MA  01752
+				US
+
+00-00-E7   (hex)		Star Gate Technologies
+0000E7     (base 16)		Star Gate Technologies
+				29300 Aurora Road
+				Solon  OH  44139
+				US
+
+00-00-4D   (hex)		DCI CORPORATION
+00004D     (base 16)		DCI CORPORATION
+				64J PRINCETON-HIGHTSTOWN RD
+				PRINCETON JUNCTION  NJ  08550
+				US
+
+00-00-23   (hex)		ABB INDUSTRIAL SYSTEMS AB
+000023     (base 16)		ABB INDUSTRIAL SYSTEMS AB
+				DEPT. SEISY/LKSB
+				    
+				SE
+
+00-00-BE   (hex)		THE NTI GROUP
+0000BE     (base 16)		THE NTI GROUP
+				4701 PATRICK HENRY DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-D9   (hex)		NIPPON TELEGRAPH & TELEPHONE
+0000D9     (base 16)		NIPPON TELEGRAPH & TELEPHONE
+				CORPORATION (NTT)
+				TOKYO  100-8116  
+				JP
+
+00-00-80   (hex)		CRAY COMMUNICATIONS A/S
+000080     (base 16)		CRAY COMMUNICATIONS A/S
+				SMEDEHOLM 12-14
+				    
+				DK
+
+08-00-2A   (hex)		MOSAIC TECHNOLOGIES INC.
+08002A     (base 16)		MOSAIC TECHNOLOGIES INC.
+				47 MANNING ROAD
+				BILLERICA  MA  01821-3970
+				US
+
+08-00-89   (hex)		Kinetics
+080089     (base 16)		Kinetics
+				
+				Walnut Creek  CA  
+				US
+
+08-00-86   (hex)		KONICA MINOLTA HOLDINGS, INC.
+080086     (base 16)		KONICA MINOLTA HOLDINGS, INC.
+				1-6-1, Marunouchi,
+				Tokyo    100-0005
+				JP
+
+08-00-83   (hex)		Seiko Instruments Inc.
+080083     (base 16)		Seiko Instruments Inc.
+				8, Nakase 1-chome Mihama-ku
+				Chiba-shi  Chiba  261-8507
+				JP
+
+08-00-61   (hex)		JAROGATE LTD.
+080061     (base 16)		JAROGATE LTD.
+				197-213 LYHAM ROAD
+				  UNITED  KINGDOM
+				GB
+
+08-00-5F   (hex)		SABER TECHNOLOGY CORP.
+08005F     (base 16)		SABER TECHNOLOGY CORP.
+				2381 BERING DRIVE
+				SAN JOSE  CA  95131-1125
+				US
+
+08-00-58   (hex)		SYSTEMS CONCEPTS
+080058     (base 16)		SYSTEMS CONCEPTS
+				520 THIRD STREET
+				SAN FRANCISCO  CA  94107
+				US
+
+08-00-49   (hex)		UNIVATION
+080049     (base 16)		UNIVATION
+				1037 NORTH FAIR OAKS AVE.
+				SUNNYVALE  CA  94089
+				US
+
+08-00-24   (hex)		10NET COMMUNICATIONS/DCA
+080024     (base 16)		10NET COMMUNICATIONS/DCA
+				7777 WASHINGTON VILLAGE DR.
+				DAYTON  OH  45459-3957
+				US
+
+08-00-22   (hex)		NBI INC.
+080022     (base 16)		NBI INC.
+				3450 MITCHELL LANE
+				BOULDER  CO  80301
+				US
+
+08-00-20   (hex)		Oracle Corporation
+080020     (base 16)		Oracle Corporation
+				17 Network Circle
+				Menlo Park  CA  95025
+				US
+
+08-00-1F   (hex)		SHARP CORPORATION
+08001F     (base 16)		SHARP CORPORATION
+				ENGINEERING DEPARTMENT 6
+				NARA  639-11  
+				JP
+
+08-00-14   (hex)		EXCELAN
+080014     (base 16)		EXCELAN
+				1599 FLICKINGER AVENUE
+				SAN JOSE  CA  95131
+				US
+
+AA-00-00   (hex)		DIGITAL EQUIPMENT CORPORATION
+AA0000     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+AA-00-01   (hex)		DIGITAL EQUIPMENT CORPORATION
+AA0001     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+AA-00-02   (hex)		DIGITAL EQUIPMENT CORPORATION
+AA0002     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+00-00-07   (hex)		XEROX CORPORATION
+000007     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-80-1F   (hex)		KRUPP ATLAS ELECTRONIK GMBH
+00801F     (base 16)		KRUPP ATLAS ELECTRONIK GMBH
+				P.O. BOX 448545
+				    
+				DE
+
+08-00-06   (hex)		SIEMENS AG
+080006     (base 16)		SIEMENS AG
+				Siemens IT Solutions and Services, SIS GO QM O
+				POB 2353  Fuerth  90713
+				DE
+
+04-E0-C4   (hex)		TRIUMPH-ADLER AG
+04E0C4     (base 16)		TRIUMPH-ADLER AG
+				HUNDINGSTRAßE 11B
+				    
+				DE
+
+02-07-01   (hex)		RACAL-DATACOM
+020701     (base 16)		RACAL-DATACOM
+				LAN INTERNETWORKING DIVISION
+				BOXBOROUGH  MA  01719
+				US
+
+08-00-13   (hex)		Exxon
+080013     (base 16)		Exxon
+				
+				    
+				US
+
+00-DD-08   (hex)		UNGERMANN-BASS INC.
+00DD08     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-05   (hex)		XEROX CORPORATION
+000005     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+02-1C-7C   (hex)		PERQ SYSTEMS CORPORATION
+021C7C     (base 16)		PERQ SYSTEMS CORPORATION
+				2600 LIBERTY AVENUE
+				PITTSBURGH  PA  15230
+				US
+
+08-00-65   (hex)		GENRAD INC.
+080065     (base 16)		GENRAD INC.
+				300 BAKER AVENUE
+				CONCORD  MA  01742
+				US
+
+84-A9-EA   (hex)		Career Technologies USA
+84A9EA     (base 16)		Career Technologies USA
+				9134 Independence Ave
+				Chatsworth  CA  91311
+				US
+
+E4-05-F8   (hex)		Delta Innovation Technology Co., Ltd.
+E405F8     (base 16)		Delta Innovation Technology Co., Ltd.
+				China Digital Kingdom Building, Chaoyang District
+				Beijing  Beijing  100102
+				CN
+
+00-00-09   (hex)		XEROX CORPORATION
+000009     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-80-E9   (hex)		Madge Ltd.
+0080E9     (base 16)		Madge Ltd.
+				Madge House
+				Maindenhead  Berkshire  SL6 2HP
+				GB
+
+00-40-D6   (hex)		LOCAMATION B.V.
+0040D6     (base 16)		LOCAMATION B.V.
+				POSTBOX 360
+				    HOLLAND
+				NL
+
+08-00-4B   (hex)		Planning Research Corp.
+08004B     (base 16)		Planning Research Corp.
+				1508 Kennedy Drive
+				Bellvue  NE  68005
+				US
+
+02-AA-3C   (hex)		OLIVETTI TELECOMM SPA (OLTECO)
+02AA3C     (base 16)		OLIVETTI TELECOMM SPA (OLTECO)
+				20300 STEVENS  CREEK BLVD.
+				CUPERTINO  CA  95014
+				US
+
+08-00-59   (hex)		A/S MYCRON
+080059     (base 16)		A/S MYCRON
+				PO BOX 6199
+				    
+				NO
+
+08-00-08   (hex)		BOLT BERANEK AND NEWMAN INC.
+080008     (base 16)		BOLT BERANEK AND NEWMAN INC.
+				70 FAWCETT STREET
+				CAMBRIDGE  MA  02138
+				US
+
+F4-74-88   (hex)		New H3C Technologies Co., Ltd
+F47488     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+FC-C2-33   (hex)		ASUSTek COMPUTER INC.
+FCC233     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+40-11-75   (hex)		IEEE Registration Authority
+401175     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-31-F0   (hex)		Samsung Electronics Co.,Ltd
+8031F0     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+58-35-26   (hex)		DEEPLET TECHNOLOGY CORP
+583526     (base 16)		DEEPLET TECHNOLOGY CORP
+				5F,No.9,Lane235,Pao-Chiao Rd., Hsin-Tien,
+				New Taipei City      23145
+				TW
+
+34-B5-A3   (hex)		CIG SHANGHAI CO LTD
+34B5A3     (base 16)		CIG SHANGHAI CO LTD
+				5th Floor, Building 8 No 2388 Chenhang Road
+				SHANGHAI    201114
+				CN
+
+6C-1D-EB   (hex)		u-blox AG
+6C1DEB     (base 16)		u-blox AG
+				Zuercherstrasse 68
+				Thalwil    8800
+				CH
+
+28-52-F9   (hex)		Zhongxin Intelligent Times (Shenzhen) Co., Ltd.
+2852F9     (base 16)		Zhongxin Intelligent Times (Shenzhen) Co., Ltd.
+				3rd Floor,Building 46,Cuigang Industrial Zone 5,Fuyong Street,Baoan District
+				Shenzhen  Guangdong  518103
+				CN
+
+B8-F8-53   (hex)		Arcadyan Corporation
+B8F853     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+E0-D0-83   (hex)		Samsung Electronics Co.,Ltd
+E0D083     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+74-3C-18   (hex)		Taicang T&W Electronics
+743C18     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+4C-80-BA   (hex)		Wuhan Tianyu Information Industry Co., Ltd.
+4C80BA     (base 16)		Wuhan Tianyu Information Industry Co., Ltd.
+				HUST Industry Park, East-Lake Development Zone
+				Wuhan  Hubei  430223
+				CN
+
+8C-02-FA   (hex)		COMMANDO Networks Limited
+8C02FA     (base 16)		COMMANDO Networks Limited
+				Rm407, 4th floor, 3-2 HuaYuan Rd., DaLang Subdistrict, LongHua District
+				Shenzhen  Guangdong  518109
+				CN
+
+F0-26-4C   (hex)		Sigrist-Photometer AG
+F0264C     (base 16)		Sigrist-Photometer AG
+				Hofurlistrasse 1
+				Ennetbürgen    6373
+				CH
+
+D0-3D-52   (hex)		Vaion Limited
+D03D52     (base 16)		Vaion Limited
+				The Charter Building, Charter Place
+				Uxbridge    UB8 1JG 
+				GB
+
+D8-0B-9A   (hex)		Samsung Electronics Co.,Ltd
+D80B9A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-8D-34   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC8D34     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-52-99   (hex)		The Chamberlain Group, Inc
+645299     (base 16)		The Chamberlain Group, Inc
+				300 Windsor Drive
+				Oak Brook  IL  60523
+				US
+
+F8-75-A4   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+F875A4     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+00-D2-B1   (hex)		TPV Display Technology (Xiamen) Co.,Ltd.
+00D2B1     (base 16)		TPV Display Technology (Xiamen) Co.,Ltd.
+				No.1, Xianghai Road, Xiamen Torch Hi-Tech Industrial Development Zone
+				XM  Fujian  361101
+				CN
+
+C0-E4-34   (hex)		AzureWave Technology Inc.
+C0E434     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+6C-71-0D   (hex)		Cisco Systems, Inc
+6C710D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+24-6F-8C   (hex)		Huawei Device Co., Ltd.
+246F8C     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+1C-13-86   (hex)		Huawei Device Co., Ltd.
+1C1386     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+BC-2E-F6   (hex)		Huawei Device Co., Ltd.
+BC2EF6     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+44-55-C4   (hex)		Huawei Device Co., Ltd.
+4455C4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-08-29   (hex)		TOKYO ELECTRON DEVICE NAGASAKI LIMITED
+000829     (base 16)		TOKYO ELECTRON DEVICE NAGASAKI LIMITED
+				6-42 Tsukuba-machi, Isahaya-shi
+				Nagasaki  Kyushu  854-0065
+				JP
+
+1C-44-55   (hex)		Sieb & Meyer AG
+1C4455     (base 16)		Sieb & Meyer AG
+				Auf dem Schmaarkamp 21
+				Lueneburg    21339
+				DE
+
+F8-8A-5E   (hex)		Texas Instruments
+F88A5E     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+5C-E7-A0   (hex)		Nokia
+5CE7A0     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+E0-1F-88   (hex)		Xiaomi Communications Co Ltd
+E01F88     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+8C-DC-02   (hex)		zte corporation
+8CDC02     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B4-BC-7C   (hex)		Texas Instruments
+B4BC7C     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+E0-AA-B0   (hex)		SUNTAILI ENTERPRISE CO. LTD,
+E0AAB0     (base 16)		SUNTAILI ENTERPRISE CO. LTD,
+				No. 6 ALY 3,LN 64 XINGFU RD, XINZHUNAG DISTRICT
+				NEW TAIPEI CITY    242
+				TW
+
+68-39-43   (hex)		ittim
+683943     (base 16)		ittim
+				1202, No.6, Zhongguancun South Street, Haidian District,
+				beijing    100080
+				CN
+
+10-C6-5E   (hex)		Adapt-IP
+10C65E     (base 16)		Adapt-IP
+				1671 Dell Avenue, Suite 130
+				Campbell  CA  95008-6900
+				US
+
+7C-A7-B0   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+7CA7B0     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268? Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+20-31-1C   (hex)		vivo Mobile Communication Co., Ltd.
+20311C     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+10-4F-58   (hex)		Aruba, a Hewlett Packard Enterprise Company
+104F58     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+B4-E8-42   (hex)		Hong Kong Bouffalo Lab Limited
+B4E842     (base 16)		Hong Kong Bouffalo Lab Limited
+				RM 1903, 19/F Lee Garden One 33 Hysan Avenue, Causeway Bay
+				HongKong    999077
+				HK
+
+00-03-CB   (hex)		SystemGear Co., Ltd.
+0003CB     (base 16)		SystemGear Co., Ltd.
+				1-9-14 Edobori
+				Osaka  Nishi-ku  550-0002
+				JP
+
+F0-A7-B2   (hex)		FUTABA CORPORATION
+F0A7B2     (base 16)		FUTABA CORPORATION
+				629 Oshiba
+				Mobara  Chiba Prefecture  297-8588
+				JP
+
+60-9B-2D   (hex)		JMACS Japan Co., Ltd.
+609B2D     (base 16)		JMACS Japan Co., Ltd.
+				11F, KM Nishi-Umeda bldg., 7-20-1 Fukushima, Fukushima-ku
+				Osaka-city  Osaka  553-0003
+				JP
+
+14-A3-2F   (hex)		Huawei Device Co., Ltd.
+14A32F     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+04-D3-B5   (hex)		Huawei Device Co., Ltd.
+04D3B5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-BB-1C   (hex)		Huawei Device Co., Ltd.
+00BB1C     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+80-AC-7C   (hex)		Sichuan AI-Link Technology Co., Ltd.
+80AC7C     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+DC-4B-FE   (hex)		Shenzhen Belon Technology CO.,LTD
+DC4BFE     (base 16)		Shenzhen Belon Technology CO.,LTD
+				Tsinghua Information
+				Shenzhen  Guangdong  518052
+				CN
+
+50-62-55   (hex)		IEEE Registration Authority
+506255     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+58-D5-0A   (hex)		Murata Manufacturing Co., Ltd.
+58D50A     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+88-A3-03   (hex)		Samsung Electronics Co.,Ltd
+88A303     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-DE-90   (hex)		Samsung Electronics Co.,Ltd
+FCDE90     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-54-CF   (hex)		Samsung Electronics Co.,Ltd
+1854CF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-79-5D   (hex)		Infinix mobility limited
+80795D     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+E8-84-C6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E884C6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-2C-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+642CAC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-CC-27   (hex)		Motorola Mobility LLC, a Lenovo Company
+08CC27     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+04-D3-95   (hex)		Motorola Mobility LLC, a Lenovo Company
+04D395     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+E0-98-06   (hex)		Espressif Inc.
+E09806     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+F4-CF-A2   (hex)		Espressif Inc.
+F4CFA2     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+F8-1E-6F   (hex)		EBG compleo GmbH
+F81E6F     (base 16)		EBG compleo GmbH
+				Oberste-Wilms-Straße 15a
+				Dortmund  Nordrhein-Westfalen  44309
+				DE
+
+F0-A3-5A   (hex)		Apple, Inc.
+F0A35A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-83-73   (hex)		Apple, Inc.
+608373     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-AD-8D   (hex)		Apple, Inc.
+84AD8D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-42-8B   (hex)		Apple, Inc.
+74428B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-91-38   (hex)		Amazon Technologies Inc.
+149138     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+6C-41-0E   (hex)		Cisco Systems, Inc
+6C410E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-31-0E   (hex)		Cisco Systems, Inc
+6C310E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+28-77-F1   (hex)		Apple, Inc.
+2877F1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-E7-7D   (hex)		Texas Instruments
+A8E77D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+DC-54-3D   (hex)		ITEL MOBILE LIMITED
+DC543D     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+0C-84-47   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+0C8447     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+9C-6B-72   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+9C6B72     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+50-C6-AD   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+50C6AD     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+74-8A-28   (hex)		HMD Global Oy
+748A28     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+D4-24-93   (hex)		GW Technologies Co.,Ltd
+D42493     (base 16)		GW Technologies Co.,Ltd
+				Building 16,No.8,Heying Road,Changping District
+				Beijing  Beijing  102200
+				CN
+
+00-23-E6   (hex)		Innovation Farm, Inc.
+0023E6     (base 16)		Innovation Farm, Inc.
+				47-8, Hasunuma-cho
+				Itabashi-ku  Tokyo  174-8580
+				JP
+
+EC-A9-40   (hex)		ARRIS Group, Inc.
+ECA940     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-85-96   (hex)		Axonne Inc.
+FC8596     (base 16)		Axonne Inc.
+				1290 Kifer Rd. #301
+				Sunnyvale  CA  94086
+				US
+
+5C-B4-E2   (hex)		Inspur Software Group Ltd.
+5CB4E2     (base 16)		Inspur Software Group Ltd.
+				No. 1036, Langchao Road
+				Jinan  Shandong  250101
+				CN
+
+3C-51-0E   (hex)		Cisco Systems, Inc
+3C510E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-AE-D0   (hex)		Shanghai Engineering Science & Technology Co.,LTD CGNPC
+D8AED0     (base 16)		Shanghai Engineering Science & Technology Co.,LTD CGNPC
+				No.1588, Rd Zixing
+				Shanghai  Shanghai  200241
+				CN
+
+E0-85-9A   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+E0859A     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+0C-42-A1   (hex)		Mellanox Technologies, Inc.
+0C42A1     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+B4-7A-F1   (hex)		Hewlett Packard Enterprise
+B47AF1     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+34-9F-7B   (hex)		CANON INC.
+349F7B     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+F4-D9-C6   (hex)		UNIONMAN TECHNOLOGY CO.,LTD
+F4D9C6     (base 16)		UNIONMAN TECHNOLOGY CO.,LTD
+				No.5,Huitai Road,Huinan High-Tech Park,Huiao Highway
+				Huizhou  Guangdong  516025
+				CN
+
+34-F1-50   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+34F150     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+CC-52-89   (hex)		SHENZHEN OPTFOCUS TECHNOLOGY.,LTD
+CC5289     (base 16)		SHENZHEN OPTFOCUS TECHNOLOGY.,LTD
+				Floor 3, Building No.7,Tangtou 3rd Industrial Park,Shiyan Street of BaoAn District
+				ShenZhen    518000
+				CN
+
+CC-5D-78   (hex)		JTD Consulting
+CC5D78     (base 16)		JTD Consulting
+				92 King Street South, Suite 200
+				Waterloo  Ontario  N2J 1P5
+				CA
+
+BC-F9-F2   (hex)		TEKO
+BCF9F2     (base 16)		TEKO
+				Prospect Pobedy, 19
+				Kazan  Republic of Tatarstan  420138
+				RU
+
+00-0E-A4   (hex)		Quantum Corp.
+000EA4     (base 16)		Quantum Corp.
+				8560 Upland Dr.
+				Englewood  CA  80112
+				US
+
+00-50-84   (hex)		Quantum Corp.
+005084     (base 16)		Quantum Corp.
+				8560 Upland Dr.
+				Englewood  CO  80112
+				US
+
+80-9F-9B   (hex)		Sichuan AI-Link Technology Co., Ltd.
+809F9B     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+A8-2B-CD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A82BCD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-DC-2D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48DC2D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-EB-51   (hex)		Universal Electronics, Inc.
+ACEB51     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+60-10-A2   (hex)		Crompton Instruments
+6010A2     (base 16)		Crompton Instruments
+				12 Freebournes Road
+				Witham  Essex  CM8 3AH
+				GB
+
+C4-B2-39   (hex)		Cisco Systems, Inc
+C4B239     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B0-A4-54   (hex)		Tripwire Inc.
+B0A454     (base 16)		Tripwire Inc.
+				308 SW 2nd Avenue Suite 400
+				Portland  OR  97204
+				US
+
+64-90-C1   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+6490C1     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+CC-5C-DE   (hex)		China Mobile Group Device Co.,Ltd.
+CC5CDE     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+60-CE-86   (hex)		Sercomm Corporation.
+60CE86     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+4C-4F-EE   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+4C4FEE     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+4C-E1-75   (hex)		Cisco Systems, Inc
+4CE175     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A8-24-B8   (hex)		Nokia
+A824B8     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-0C-E6   (hex)		Fortinet Inc.
+000CE6     (base 16)		Fortinet Inc.
+				899 Kifer Road
+				Sunnyvale  CA  94086
+				US
+
+90-55-DE   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+9055DE     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-91-0F   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E8910F     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D0-05-E4   (hex)		Huawei Device Co., Ltd.
+D005E4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+30-AA-E4   (hex)		Huawei Device Co., Ltd.
+30AAE4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+14-AB-56   (hex)		WUXI FUNIDE DIGITAL CO.,LTD
+14AB56     (base 16)		WUXI FUNIDE DIGITAL CO.,LTD
+				No. 38 East Chunhui Road, Xishan Economic & Technology Development Zone
+				WUXI  JIANGSU  214101
+				CN
+
+E8-D8-D1   (hex)		HP Inc.
+E8D8D1     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+28-CD-C4   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+28CDC4     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+00-0C-DF   (hex)		JAI Manufacturing
+000CDF     (base 16)		JAI Manufacturing
+				2960-14 Uenojo Nishikata
+				Kushima  Miyazaki  888-0004
+				JP
+
+2C-91-AB   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+2C91AB     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+80-7B-3E   (hex)		Samsung Electronics Co.,Ltd
+807B3E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F8-F1-E6   (hex)		Samsung Electronics Co.,Ltd
+F8F1E6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-A9-B7   (hex)		Apple, Inc.
+88A9B7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-CE-D7   (hex)		Apple, Inc.
+ECCED7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-EB-62   (hex)		Murata Manufacturing Co., Ltd.
+48EB62     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+5C-E1-76   (hex)		Cisco Systems, Inc
+5CE176     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+AC-90-85   (hex)		Apple, Inc.
+AC9085     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-48-ED   (hex)		Dell Inc.
+3448ED     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+3C-57-31   (hex)		Cisco Systems, Inc
+3C5731     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-55-E8   (hex)		Technicolor CH USA Inc.
+6C55E8     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+34-2F-BD   (hex)		Nintendo Co.,Ltd
+342FBD     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+A0-2D-13   (hex)		AirTies Wireless Networks
+A02D13     (base 16)		AirTies Wireless Networks
+				Esentepe Mah., Kore ?ehitleri Cad.
+				Istanbul  ?i?li  34360
+				TR
+
+84-68-C8   (hex)		TOTOLINK TECHNOLOGY INT‘L LIMITED
+8468C8     (base 16)		TOTOLINK TECHNOLOGY INT‘L LIMITED
+				ROOM 702,7/F SPA CENTER NO 53055 LOCKHART ROAD 
+				WAN CHAI    999077
+				HK
+
+9C-28-F7   (hex)		Xiaomi Communications Co Ltd
+9C28F7     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+10-52-1C   (hex)		Espressif Inc.
+10521C     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+6C-42-AB   (hex)		Subscriber Networks, Inc.
+6C42AB     (base 16)		Subscriber Networks, Inc.
+				148 W. State Street
+				Kennett Square  PA  19348
+				US
+
+64-F6-F7   (hex)		Anhui Dynamic Power Co., Ltd.
+64F6F7     (base 16)		Anhui Dynamic Power Co., Ltd.
+				NO.20 Jinniu Mid Road,
+				Xuancheng  Anhui  242100
+				CN
+
+94-1C-56   (hex)		Actiontec Electronics, Inc
+941C56     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+D8-0B-CB   (hex)		Telink Semiconductor (Shanghai) Co., Ltd.
+D80BCB     (base 16)		Telink Semiconductor (Shanghai) Co., Ltd.
+				No. 1500 Zuchongzhi Rd, Building #3
+				Shanghai    201203
+				CN
+
+F0-F0-A4   (hex)		Amazon Technologies Inc.
+F0F0A4     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+C0-D6-82   (hex)		Arista Networks
+C0D682     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+CC-2D-1B   (hex)		SFR
+CC2D1B     (base 16)		SFR
+				12 rue jean-philippe Rameau CS 80001
+				La plaine saint denis   FRANCE  93634
+				FR
+
+80-E5-40   (hex)		ARRIS Group, Inc.
+80E540     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0D-B4   (hex)		Stormshield
+000DB4     (base 16)		Stormshield
+				2-10 rue Marceau
+				ISSY LES MOULINEAUX    92130
+				FR
+
+2C-F0-5D   (hex)		Micro-Star INTL CO., LTD.
+2CF05D     (base 16)		Micro-Star INTL CO., LTD.
+				No.69, Lide St.,
+				New Taipei City  Taiwan  235
+				TW
+
+94-3B-B0   (hex)		New H3C Technologies Co., Ltd
+943BB0     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+90-43-E2   (hex)		Cornami, Inc
+9043E2     (base 16)		Cornami, Inc
+				300 Orchard City Dr, Suite 131
+				Campbell  CA  95008
+				US
+
+80-30-49   (hex)		Liteon Technology Corporation
+803049     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+E8-49-43   (hex)		YUGE Information technology Co. Ltd
+E84943     (base 16)		YUGE Information technology Co. Ltd
+				Room 303, Building No. 6, ShengRong Rd. 88, Pudong, Shanghai
+				Shanghai    201203
+				CN
+
+50-14-08   (hex)		AiNET
+501408     (base 16)		AiNET
+				11700 MONTGOMERY RD
+				BELTSVILLE  MD  20705-1159
+				US
+
+28-9A-F7   (hex)		ADVA Optical Networking Ltd.
+289AF7     (base 16)		ADVA Optical Networking Ltd.
+				ADVAntage House
+				York    YO30 4RY
+				GB
+
+B0-B1-94   (hex)		zte corporation
+B0B194     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-C3-AB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+10C3AB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-11-EC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2811EC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-26-86   (hex)		DWnet Technologies(Suzhou) Corporation
+E42686     (base 16)		DWnet Technologies(Suzhou) Corporation
+				No.8,Tangzhuang Road, Suzhou Industrial Park, Jiangsu, China
+				Suzhou    21500
+				CN
+
+00-69-2D   (hex)		Sunnovo International Limited
+00692D     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+38-EB-47   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38EB47     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-37-96   (hex)		BIZLINK TECHNOLOGY, INC.
+0C3796     (base 16)		BIZLINK TECHNOLOGY, INC.
+				47211 BAYSIDE PARKWAY
+				Fremont  CA  94538
+				US
+
+F4-03-2A   (hex)		Amazon Technologies Inc.
+F4032A     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+14-77-40   (hex)		Huawei Device Co., Ltd.
+147740     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B4-15-7E   (hex)		Celona Inc.
+B4157E     (base 16)		Celona Inc.
+				10061, Bubb Road Suite 300
+				Cupertino  CA  95014
+				US
+
+18-D9-8F   (hex)		Huawei Device Co., Ltd.
+18D98F     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+64-5E-2C   (hex)		IRay Technology Co., Ltd.
+645E2C     (base 16)		IRay Technology Co., Ltd.
+				11th Guiyang St.,
+				Yantai  Shandong  264000
+				CN
+
+00-E0-EC   (hex)		CELESTICA INC.
+00E0EC     (base 16)		CELESTICA INC.
+				1900-5140 Yonge Street PO Box 42   
+				Toronto  Ontario  M2N 6L7
+				CA
+
+70-38-11   (hex)		Siemens Mobility Limited
+703811     (base 16)		Siemens Mobility Limited
+				17 Langley Park Way
+				Chippenham  Wiltshire  SN15 1GG
+				GB
+
+64-62-66   (hex)		IEEE Registration Authority
+646266     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+48-7A-F6   (hex)		NCS ELECTRICAL SDN BHD
+487AF6     (base 16)		NCS ELECTRICAL SDN BHD
+				NO. 20, 22, 24, 26, JALAN 1/3, RAWANG INTEGRATED INDUSTRIAL PARK, 48000 Rawang Selangor, MALAYSIA
+				RAWANG  SELANGOR  48000
+				MY
+
+48-6E-70   (hex)		Zhejiang Tmall Technology Co., Ltd.
+486E70     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+60-1D-9D   (hex)		Sichuan AI-Link Technology Co., Ltd.
+601D9D     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou, Industrial Park
+				Mianyang  Sichuan  622650
+				CN
+
+D8-5F-77   (hex)		Telink Semiconductor (Shanghai) Co., Ltd.
+D85F77     (base 16)		Telink Semiconductor (Shanghai) Co., Ltd.
+				No. 1500 Zuchongzhi Rd, Building #3
+				Shanghai    201203
+				CN
+
+2C-97-ED   (hex)		Sony Imaging Products & Solutions Inc.
+2C97ED     (base 16)		Sony Imaging Products & Solutions Inc.
+				konan 1-7-1
+				minato-ku  Tokyo  108-0075
+				JP
+
+20-82-6A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+20826A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+B8-90-47   (hex)		Apple, Inc.
+B89047     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-9C-4A   (hex)		Apple, Inc.
+909C4A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-8C-43   (hex)		Apple, Inc.
+908C43     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-8A-6A   (hex)		AVPro Global Hldgs
+188A6A     (base 16)		AVPro Global Hldgs
+				2222 E 52nd Steeet N
+				Sioux Falls  SD  57104
+				US
+
+3C-7D-0A   (hex)		Apple, Inc.
+3C7D0A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-8A-39   (hex)		Samsung Electronics Co.,Ltd
+D48A39     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-F3-C4   (hex)		Samsung Electronics Co.,Ltd
+E4F3C4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-2F-4E   (hex)		zte corporation
+9C2F4E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-10-90   (hex)		New H3C Technologies Co., Ltd
+F01090     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+08-BF-A0   (hex)		Samsung Electronics Co.,Ltd
+08BFA0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+70-1F-3C   (hex)		Samsung Electronics Co.,Ltd
+701F3C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-50-E7   (hex)		AMPAK Technology,Inc.
+2050E7     (base 16)		AMPAK Technology,Inc.
+				3F, No.15-1 Zhonghua Road, Hsinchu Industrail Park, Hukou,
+				Hsinchu  Hsinchu,Taiwan R.O.C.  30352
+				TW
+
+D8-A8-C8   (hex)		zte corporation
+D8A8C8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-22-E2   (hex)		HP Inc.
+3822E2     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+08-C0-EB   (hex)		Mellanox Technologies, Inc.
+08C0EB     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+E4-E1-12   (hex)		Texas Instruments
+E4E112     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+34-14-B5   (hex)		Texas Instruments
+3414B5     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D0-03-EB   (hex)		Texas Instruments
+D003EB     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+94-DB-56   (hex)		Sony Home Entertainment&Sound Products Inc
+94DB56     (base 16)		Sony Home Entertainment&Sound Products Inc
+				Sony City Osaki 2-10-1 Osaki Shinagawa-ku
+				Tokyo  Japan  141-8610
+				JP
+
+88-9E-68   (hex)		Technicolor CH USA Inc.
+889E68     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+64-09-AC   (hex)		TCT mobile ltd
+6409AC     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+74-3A-EF   (hex)		Kaonmedia CO., LTD.
+743AEF     (base 16)		Kaonmedia CO., LTD.
+				884-3, Seongnam-daero, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13517
+				KR
+
+18-9E-2C   (hex)		Huawei Device Co., Ltd.
+189E2C     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+5C-55-78   (hex)		iryx corp
+5C5578     (base 16)		iryx corp
+				14 Hughes
+				Irvine  CA  92618
+				US
+
+6C-F7-12   (hex)		Nokia
+6CF712     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+4C-C5-3E   (hex)		Zyxel Communications Corporation
+4CC53E     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+90-56-FC   (hex)		TECNO MOBILE LIMITED
+9056FC     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+B8-63-92   (hex)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+B86392     (base 16)		GUANGDONG GENIUS TECHNOLOGY CO., LTD.
+				No.168, Middle Road Of East Gate
+				Xiaobian Community  Chang'an Town  523851
+				CN
+
+68-B9-D3   (hex)		Shenzhen Trolink Technology CO, LTD
+68B9D3     (base 16)		Shenzhen Trolink Technology CO, LTD
+				201 B building 4 shijie, Chashu industry 505 block, Baoan airport Sanwei community, Hangcheng street Baoan area.
+				Shenzhen  GuangDong  518000
+				CN
+
+B8-C6-AA   (hex)		Earda Technologies co Ltd
+B8C6AA     (base 16)		Earda Technologies co Ltd
+				Block A,Lianfeng Creative Park, #2 Jisheng Rd., Nansha District
+				Guangzhou  Guangdong  511455
+				CN
+
+54-AE-D0   (hex)		DASAN Networks, Inc. 
+54AED0     (base 16)		DASAN Networks, Inc. 
+				DASAN Tower, 49, Daewangpangyo-ro, 644 Beon-gil, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13493
+				KR
+
+10-70-FD   (hex)		Mellanox Technologies, Inc.
+1070FD     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+38-F6-01   (hex)		Solid State Storage Technology Corporation
+38F601     (base 16)		Solid State Storage Technology Corporation
+				21F, 392, Ruey Kuang Road, Neihu
+				 Taipei    11492
+				TW
+
+40-DE-AD   (hex)		Juniper Networks
+40DEAD     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+40-F5-20   (hex)		Espressif Inc.
+40F520     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+78-AA-82   (hex)		New H3C Technologies Co., Ltd
+78AA82     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+20-6C-8A   (hex)		Extreme Networks, Inc.
+206C8A     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+34-85-84   (hex)		Extreme Networks, Inc.
+348584     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+40-18-B1   (hex)		Extreme Networks, Inc.
+4018B1     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+88-5B-DD   (hex)		Extreme Networks, Inc.
+885BDD     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+98-ED-5C   (hex)		Tesla,Inc.
+98ED5C     (base 16)		Tesla,Inc.
+				3500 Deer Creek Road
+				Palo Alto  CA  94304
+				US
+
+C4-42-68   (hex)		CRESTRON ELECTRONICS, INC.
+C44268     (base 16)		CRESTRON ELECTRONICS, INC.
+				15 Volvo Drive
+				Rockleigh  NJ  07647
+				US
+
+54-71-DD   (hex)		Huawei Device Co., Ltd.
+5471DD     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+E4-A7-49   (hex)		Palo Alto Networks
+E4A749     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+84-D6-C5   (hex)		SolarEdge Technologies
+84D6C5     (base 16)		SolarEdge Technologies
+				1 Abba Eban St.
+				Herzelia    46725
+				IL
+
+D8-91-36   (hex)		Dover Fueling Solutions
+D89136     (base 16)		Dover Fueling Solutions
+				Industrieweg 5
+				Bladel  NBR  5531AD
+				NL
+
+C8-83-14   (hex)		Tempo Communications
+C88314     (base 16)		Tempo Communications
+				1390 Aspen Way
+				Vista  CA  92081
+				US
+
+B8-E3-EE   (hex)		Universal Electronics, Inc.
+B8E3EE     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+24-C8-D3   (hex)		McWane India Pvt Ltd
+24C8D3     (base 16)		McWane India Pvt Ltd
+				483, Kamaraj Road, Upplipalayam
+				Coimbatore  Tamil Nadu  641015
+				IN
+
+60-54-64   (hex)		Eyedro Green Solutions Inc.
+605464     (base 16)		Eyedro Green Solutions Inc.
+				130 Weber St W, Suite 201
+				Kitchener  Ontario  N2H4A2
+				CA
+
+FC-95-6A   (hex)		OCTAGON SYSTEMS CORP.
+FC956A     (base 16)		OCTAGON SYSTEMS CORP.
+				7403 Church Ranch Blvd
+				Westminster  CO  80021
+				US
+
+40-B3-1E   (hex)		Universal Electronics, Inc.
+40B31E     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+88-40-33   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+884033     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E0-F6-B5   (hex)		Nintendo Co.,Ltd
+E0F6B5     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+AC-7A-56   (hex)		Cisco Systems, Inc
+AC7A56     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-8D-BF   (hex)		Rhino Mobility LLC
+448DBF     (base 16)		Rhino Mobility LLC
+				8 The Green, Suite A
+				Dover  DE  19901
+				US
+
+94-8A-C6   (hex)		Realme Chongqing Mobile Telecommunications Corp.,Ltd.
+948AC6     (base 16)		Realme Chongqing Mobile Telecommunications Corp.,Ltd.
+				No.178 Yulong Avenue, Yufengshan, Yubei District, Chongqing.
+				Chongqing   China  401120
+				CN
+
+C0-A6-6D   (hex)		Inspur Group Co., Ltd.
+C0A66D     (base 16)		Inspur Group Co., Ltd.
+				No.1036 Langchao Rd.
+				Jinan  Shandong  250101
+				CN
+
+70-F0-96   (hex)		Cisco Systems, Inc
+70F096     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-20-A6   (hex)		Proxim Wireless
+0020A6     (base 16)		Proxim Wireless
+				2114 Ringwood Ave
+				San Jose  CA  95131
+				US
+
+58-50-ED   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+5850ED     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+00-05-1E   (hex)		Brocade Communications Systems LLC
+00051E     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+98-8B-0A   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+988B0A     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+BC-BA-C2   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+BCBAC2     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+AC-CB-51   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+ACCB51     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+E0-D4-62   (hex)		Huawei Device Co., Ltd.
+E0D462     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+90-98-38   (hex)		Huawei Device Co., Ltd.
+909838     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+84-CC-A8   (hex)		Espressif Inc.
+84CCA8     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+C4-F5-7C   (hex)		Brocade Communications Systems LLC
+C4F57C     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-12-F2   (hex)		Brocade Communications Systems LLC
+0012F2     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+6C-2F-8A   (hex)		Samsung Electronics Co.,Ltd
+6C2F8A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-B0-22   (hex)		TOHO Electronics INC.
+F0B022     (base 16)		TOHO Electronics INC.
+				1-13-21 Tanashioda, Chuo-Ku
+				Sagamihara-City  Kanagawa  252-0245
+				JP
+
+98-7E-CA   (hex)		Inventus Power Eletronica do Brasil LTDA
+987ECA     (base 16)		Inventus Power Eletronica do Brasil LTDA
+				Av Buriti, 4285 Distrito Industrial
+				Manaus  Amazonas  69075000
+				BR
+
+2C-9F-FB   (hex)		Wistron Neweb Corporation
+2C9FFB     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+50-38-2F   (hex)		ASE Group Chung-Li
+50382F     (base 16)		ASE Group Chung-Li
+				No 550,Chung-Hwa Road Section1
+				Chung-Li , Taoyuan  Taoyuan  32016
+				TW
+
+0C-14-D2   (hex)		China Mobile Group Device Co.,Ltd.
+0C14D2     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+D4-F8-29   (hex)		Sagemcom Broadband SAS
+D4F829     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E0-62-34   (hex)		Texas Instruments
+E06234     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+70-8C-BB   (hex)		MIMODISPLAYKOREA
+708CBB     (base 16)		MIMODISPLAYKOREA
+				#812, 19, Ojeongongeop-gil
+				Uiwang-si  Gyeonggi-do  16072
+				KR
+
+B8-48-AA   (hex)		EM Microelectronic
+B848AA     (base 16)		EM Microelectronic
+				Rue des Sors 3
+				Marin-Epagnier  Neuchatel  2074
+				CH
+
+D8-34-EE   (hex)		Stem Audio
+D834EE     (base 16)		Stem Audio
+				2552 White Road, Suite A
+				Irvine  CA  92614
+				US
+
+F8-57-2E   (hex)		Core Brands, LLC
+F8572E     (base 16)		Core Brands, LLC
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+00-1C-91   (hex)		Gefen LLC
+001C91     (base 16)		Gefen LLC
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+24-4B-FE   (hex)		ASUSTek COMPUTER INC.
+244BFE     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+7C-DD-E9   (hex)		ATOM tech Inc.
+7CDDE9     (base 16)		ATOM tech Inc.
+				Sky Menor Yokohama 422, 2-11-2 Takashima, Nishi-ku 
+				Yokohama-shi  Kanagawa  220-0011
+				JP
+
+F8-6B-D9   (hex)		Cisco Systems, Inc
+F86BD9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C0-14-FE   (hex)		Cisco Systems, Inc
+C014FE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-AD-4F   (hex)		Cisco Systems, Inc
+7CAD4F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-31-A4   (hex)		Huawei Device Co., Ltd.
+0831A4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A8-E9-78   (hex)		Huawei Device Co., Ltd.
+A8E978     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F8-2F-65   (hex)		Huawei Device Co., Ltd.
+F82F65     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+28-B3-71   (hex)		Ruckus Wireless
+28B371     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+08-AC-C4   (hex)		FMTech
+08ACC4     (base 16)		FMTech
+				yuehai
+				ShenZhen    518000
+				CN
+
+DC-50-3A   (hex)		Nanjing Ticom Tech Co., Ltd.
+DC503A     (base 16)		Nanjing Ticom Tech Co., Ltd.
+				No.35 Fenghui Road, Yuhuatai District
+				Nanjing  Jiangsu  210039
+				CN
+
+18-47-3D   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+18473D     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+D4-77-B2   (hex)		Netix Global B.V.
+D477B2     (base 16)		Netix Global B.V.
+				1119RB Schipol - Rijk, Beechavenue, 113, Schipol,
+				Amsterdam NL    1119
+				NL
+
+70-B5-E8   (hex)		Dell Inc.
+70B5E8     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+94-25-33   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+942533     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-56-61   (hex)		IXECLOUD Tech
+605661     (base 16)		IXECLOUD Tech
+				118, 3rd Floor, Building 195, Area 1 Beiwa Road,Haidian District, Beijing
+				Beijing    100000
+				CN
+
+0C-59-9C   (hex)		Juniper Networks
+0C599C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+44-F4-E7   (hex)		Cohesity Inc
+44F4E7     (base 16)		Cohesity Inc
+				300 park ave
+				san jose  CA  95110
+				US
+
+70-69-79   (hex)		IEEE Registration Authority
+706979     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+FC-60-9B   (hex)		New H3C Technologies Co., Ltd
+FC609B     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+E8-A1-F8   (hex)		zte corporation
+E8A1F8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+98-A9-42   (hex)		Guangzhou Tozed Kangwei Intelligent Technology Co., LTD
+98A942     (base 16)		Guangzhou Tozed Kangwei Intelligent Technology Co., LTD
+				Room 1301, NO. 37 Jinlong , Nansha Street, Xiangjiang Financial Business Center, Nansha District
+				Guangzhou  Guangdong  511458
+				CN
+
+30-42-40   (hex)		zte corporation
+304240     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+4C-21-13   (hex)		Nokia Shanghai Bell Co., Ltd.
+4C2113     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai
+				Shanghai     201206
+				CN
+
+80-2D-BF   (hex)		Cisco Systems, Inc
+802DBF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-F1-50   (hex)		Guangzhou Qi'an Technology Co., Ltd.
+24F150     (base 16)		Guangzhou Qi'an Technology Co., Ltd.
+				No. 3, Dasonggang, Jiangnan Avenue Middle Road, Haizhu District, Guangzhou (office only)
+				Guangzhou  Guangdong  510220
+				CN
+
+10-8B-6A   (hex)		Antailiye Technology Co.,Ltd
+108B6A     (base 16)		Antailiye Technology Co.,Ltd
+				7/F,Zhengjiyuan Buiding,2 Road,Qianjing, Xixiang, Baoan District,Shenzhen
+				SHEN ZHEN  GUANGDONG  518000
+				CN
+
+14-C8-8B   (hex)		Apple, Inc.
+14C88B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-26-51   (hex)		Apple, Inc.
+EC2651     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-3E-EF   (hex)		Apple, Inc.
+183EEF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-7E-C9   (hex)		Apple, Inc.
+607EC9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-88-2F   (hex)		Extreme Networks, Inc.
+40882F     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+E4-3D-1A   (hex)		Broadcom Limited
+E43D1A     (base 16)		Broadcom Limited
+				15191 Alton Parkway
+				Irvine  CA  92618
+				US
+
+64-4C-36   (hex)		Intel Corporate
+644C36     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+48-89-E7   (hex)		Intel Corporate
+4889E7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+24-EE-9A   (hex)		Intel Corporate
+24EE9A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+5C-87-9C   (hex)		Intel Corporate
+5C879C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+50-EB-71   (hex)		Intel Corporate
+50EB71     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+0C-DD-24   (hex)		Intel Corporate
+0CDD24     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+94-B8-6D   (hex)		Intel Corporate
+94B86D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+20-16-B9   (hex)		Intel Corporate
+2016B9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+38-BA-F8   (hex)		Intel Corporate
+38BAF8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+3C-6A-A7   (hex)		Intel Corporate
+3C6AA7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+34-E1-2D   (hex)		Intel Corporate
+34E12D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+00-BB-60   (hex)		Intel Corporate
+00BB60     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+60-F6-77   (hex)		Intel Corporate
+60F677     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A0-88-69   (hex)		Intel Corporate
+A08869     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+74-E5-F9   (hex)		Intel Corporate
+74E5F9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+80-00-0B   (hex)		Intel Corporate
+80000B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+34-41-5D   (hex)		Intel Corporate
+34415D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+FC-77-74   (hex)		Intel Corporate
+FC7774     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+98-2C-BC   (hex)		Intel Corporate
+982CBC     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+3C-F0-11   (hex)		Intel Corporate
+3CF011     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+28-7F-CF   (hex)		Intel Corporate
+287FCF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+80-32-53   (hex)		Intel Corporate
+803253     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D8-C0-A6   (hex)		AzureWave Technology Inc.
+D8C0A6     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+9C-FC-E8   (hex)		Intel Corporate
+9CFCE8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+F8-AC-65   (hex)		Intel Corporate
+F8AC65     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+10-12-FB   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+1012FB     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+08-FA-79   (hex)		vivo Mobile Communication Co., Ltd.
+08FA79     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+F0-9B-B8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F09BB8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-17-B8   (hex)		Intel Corporate
+BC17B8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+B8-CB-29   (hex)		Dell Inc.
+B8CB29     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+44-BB-3B   (hex)		Google, Inc.
+44BB3B     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+14-C1-4E   (hex)		Google, Inc.
+14C14E     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+8C-5E-BD   (hex)		Huawei Device Co., Ltd.
+8C5EBD     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+2C-A0-42   (hex)		Huawei Device Co., Ltd.
+2CA042     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+EC-C0-1B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ECC01B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+98-44-CE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9844CE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-D0-83   (hex)		Aruba, a Hewlett Packard Enterprise Company
+CCD083     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+C0-83-C9   (hex)		Huawei Device Co., Ltd.
+C083C9     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C0-1C-30   (hex)		Shenzhen WIFI-3L Technology Co.,Ltd
+C01C30     (base 16)		Shenzhen WIFI-3L Technology Co.,Ltd
+				East 5 Floor,B Building, WeiHao Technology Park,Sunny Indusrtrial zone, Xili Town, Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+D8-C6-78   (hex)		MitraStar Technology Corp.
+D8C678     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+44-1C-7F   (hex)		Motorola Mobility LLC, a Lenovo Company
+441C7F     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+00-B8-B6   (hex)		Motorola Mobility LLC, a Lenovo Company
+00B8B6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+1C-E6-1D   (hex)		Samsung Electronics Co.,Ltd
+1CE61D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-12-DF   (hex)		Shenzhen SuperElectron Technology Co.,Ltd.
+8012DF     (base 16)		Shenzhen SuperElectron Technology Co.,Ltd.
+				1213-1214, haosheng business center, dongbin road, nanshan street, nanshan district, shenzhen city
+				Shenzhen  Guangdong  518000
+				CN
+
+C4-A1-51   (hex)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+C4A151     (base 16)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+				No.198,First Section,Snow Mountain Avenue, Jinyuan Town, Dayi County
+				Chengdu  Sichuan  611330
+				CN
+
+10-E7-7A   (hex)		STMicrolectronics International NV
+10E77A     (base 16)		STMicrolectronics International NV
+				39, Chemin du Champ-des-Filles
+				 Geneva, Plan-les-Quates    1228
+				CH
+
+80-EA-07   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+80EA07     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+BC-03-A7   (hex)		MFP MICHELIN
+BC03A7     (base 16)		MFP MICHELIN
+				23 place des Carmes Dechaux
+				Clermont-Ferrand    63000
+				FR
+
+90-76-9F   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+90769F     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+98-2F-F8   (hex)		Huawei Device Co., Ltd.
+982FF8     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+40-DC-A5   (hex)		Huawei Device Co., Ltd.
+40DCA5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+2C-6F-51   (hex)		Herospeed Digital Technology Limited
+2C6F51     (base 16)		Herospeed Digital Technology Limited
+				728 Kaichuang Avenue,Huangpu Distric
+				Guangzhou  Guangdong  510530
+				CN
+
+04-A2-F3   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+04A2F3     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+CC-DB-93   (hex)		Cisco Systems, Inc
+CCDB93     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-D6-1C   (hex)		Shenzhen TINNO Mobile Technology Corp.
+18D61C     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+54-48-E6   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+5448E6     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				Xiaomi Campus, No. 33 Xi erqi Middle Road, Haidian District
+				Beijing  Beijing  100085
+				CN
+
+60-D4-E9   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+60D4E9     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+30-C5-0F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30C50F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-68-D2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2868D2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-A9-35   (hex)		JWEntertainment
+90A935     (base 16)		JWEntertainment
+				3f 10 Dwitgol-ro
+				Gwacheon-si  Gyeonggi-do  13814
+				KR
+
+A4-86-AE   (hex)		Quectel Wireless Solutions Co., Ltd.
+A486AE     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				No.1801 Hongmei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+1C-D6-BE   (hex)		Wistron Neweb Corporation
+1CD6BE     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+28-D1-27   (hex)		Beijing Xiaomi Mobile Software Co., Ltd
+28D127     (base 16)		Beijing Xiaomi Mobile Software Co., Ltd
+				The Rainbow City Office Building, 68 Qinghe Middle Street Haidian District
+				Beijing  Beijing  100085
+				CN
+
+C8-68-DE   (hex)		Huawei Device Co., Ltd.
+C868DE     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D0-0D-F7   (hex)		Huawei Device Co., Ltd.
+D00DF7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+48-05-E2   (hex)		Huawei Device Co., Ltd.
+4805E2     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F8-1B-04   (hex)		Zhong Shan City Richsound Electronic Industrial Ltd
+F81B04     (base 16)		Zhong Shan City Richsound Electronic Industrial Ltd
+				Qunle Industrial Area,East ShaGang Road,GangKou ZhongShan,GuangDong,China
+				ZhongShan  GuangDong  528400
+				CN
+
+D8-8C-79   (hex)		Google, Inc.
+D88C79     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+10-34-1B   (hex)		Spacelink
+10341B     (base 16)		Spacelink
+				8830 Complex dr
+				San Diego  CA  92123
+				US
+
+30-A4-52   (hex)		Arrival Elements BV
+30A452     (base 16)		Arrival Elements BV
+				M. Keynesplein 12-46
+				Amsterdam    1066 EP
+				NL
+
+00-1E-68   (hex)		Quanta Computer Inc.
+001E68     (base 16)		Quanta Computer Inc.
+				NO. 211, WEN HWA 2RD., KUEI SHAN HSIANG
+				TAIPEI  TAO YUAN SHIEN  333
+				TW
+
+00-23-8B   (hex)		Quanta Computer Inc.
+00238B     (base 16)		Quanta Computer Inc.
+				NO. 211, WEN HWA 2RD.,KUEI SHAN HSIANG, TAO YUAN SHIEN,
+				TAIPEI  TAIWAN  333
+				TW
+
+2C-60-0C   (hex)		Quanta Computer Inc.
+2C600C     (base 16)		Quanta Computer Inc.
+				No.211, Wen Hwa 2nd Rd
+				Taoyuan  Taiwan  33377
+				TW
+
+8C-C5-B4   (hex)		Sagemcom Broadband SAS
+8CC5B4     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-0B-A2   (hex)		Sumitomo Electric Industries, Ltd
+000BA2     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+00-08-F6   (hex)		Sumitomo Electric Industries, Ltd
+0008F6     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+00-00-5F   (hex)		Sumitomo Electric Industries, Ltd
+00005F     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+18-EC-E7   (hex)		BUFFALO.INC
+18ECE7     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+F4-69-D5   (hex)		IEEE Registration Authority
+F469D5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+08-3A-F2   (hex)		Espressif Inc.
+083AF2     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+74-3A-20   (hex)		New H3C Technologies Co., Ltd
+743A20     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+30-C9-AB   (hex)		CLOUD NETWORK TECHNOLOGY SINGAPORE PTE. LTD.
+30C9AB     (base 16)		CLOUD NETWORK TECHNOLOGY SINGAPORE PTE. LTD.
+				B22 Building,NO.51 Tongle Road, Shajing Town, Jiangnan District, Nanning, Guangxi Province, China
+				Nanning  Guangxi  530007
+				CN
+
+3C-1A-9E   (hex)		VitalThings AS
+3C1A9E     (base 16)		VitalThings AS
+				Jarlsoveien 48
+				Tonsberg    3124
+				NO
+
+C4-D7-38   (hex)		Huawei Device Co., Ltd.
+C4D738     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C8-84-A1   (hex)		Cisco Systems, Inc
+C884A1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D8-77-8B   (hex)		Intelbras
+D8778B     (base 16)		Intelbras
+				BR 101, KM 210
+				São Jose  Santa Catarina  88104-800
+				BR
+
+00-03-E8   (hex)		Wavesight Limited
+0003E8     (base 16)		Wavesight Limited
+				13 Dencora Way
+				Luton  Sundon Business Park  LU3 3HP
+				GB
+
+6C-BA-B8   (hex)		Sagemcom Broadband SAS
+6CBAB8     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E0-D4-64   (hex)		Intel Corporate
+E0D464     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C0-F6-C2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C0F6C2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-AF-F7   (hex)		Arista Networks
+D4AFF7     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+60-07-7C   (hex)		Jala Group
+60077C     (base 16)		Jala Group
+				Melchor Pérez de Holguín N 2643
+				Cochabamba  Cochabamba  0000
+				BO
+
+60-98-66   (hex)		Texas Instruments
+609866     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F8-D0-27   (hex)		Seiko Epson Corporation
+F8D027     (base 16)		Seiko Epson Corporation
+				2070 Kotobuki Koaka
+				Matsumoto-shi  Nagano-ken  399-8702
+				JP
+
+5C-66-6C   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+5C666C     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+4C-4B-F9   (hex)		IEEE Registration Authority
+4C4BF9     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+1C-EA-0B   (hex)		Edgecore Networks Corporation
+1CEA0B     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+44-EF-BF   (hex)		China Dragon Technology Limited
+44EFBF     (base 16)		China Dragon Technology Limited
+				B4 Bldg.Haoshan 1st Industry Park,
+				Shenzhen  Guangdong  518104
+				CN
+
+B8-1F-5E   (hex)		Apption Labs Limited
+B81F5E     (base 16)		Apption Labs Limited
+				7-8 Westbridge Close
+				Leicester    LE3 5LW
+				GB
+
+D8-12-65   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+D81265     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+4C-B4-4A   (hex)		NANOWAVE Technologies Inc.
+4CB44A     (base 16)		NANOWAVE Technologies Inc.
+				425 Horner Avenue
+				Etobicoke  Ontario  M8W 4W3
+				CA
+
+04-8C-9A   (hex)		Huawei Device Co., Ltd.
+048C9A     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+EC-3C-BB   (hex)		Huawei Device Co., Ltd.
+EC3CBB     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+8C-3A-7E   (hex)		Universal Electronics, Inc.
+8C3A7E     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+70-44-1C   (hex)		SHENZHEN KAIFA TECHNOLOGY CO.,LTD.
+70441C     (base 16)		SHENZHEN KAIFA TECHNOLOGY CO.,LTD.
+				7006 Caitian Rd., Futian Dist. 
+				Shen Zhen  Guang Dong  518035
+				CN
+
+B4-7C-59   (hex)		Jiangsu Hengxin Technology Co.,Ltd.
+B47C59     (base 16)		Jiangsu Hengxin Technology Co.,Ltd.
+				No.138 Taodu Road,Yixing city,Jiangsu Province,China
+				Yixing  Jiangsu  214200
+				CN
+
+30-0D-9E   (hex)		Ruijie Networks Co.,LTD
+300D9E     (base 16)		Ruijie Networks Co.,LTD
+				20# Building,Star-net Science Plaza,Juyuanzhou, 618 Jinshan Road
+				Fuzhou  Fujian  350002
+				CN
+
+EC-FA-5C   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+ECFA5C     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+F8-B4-6A   (hex)		Hewlett Packard
+F8B46A     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+BC-B0-E7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BCB0E7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-34-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5434EF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-D5-A8   (hex)		ITEL MOBILE LIMITED
+88D5A8     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+20-85-93   (hex)		IEEE Registration Authority
+208593     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+AC-E3-42   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACE342     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-17-C8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9017C8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-92-2A   (hex)		DBG HOLDINGS LIMITED
+E4922A     (base 16)		DBG HOLDINGS LIMITED
+				UNIT D, 6/F., UNISON INDUSTRIAL CENTRE, 27-31 AUPUI WAN STREET, FOTAN, N.T.
+				Hong Kong    999077
+				HK
+
+2C-64-1F   (hex)		Vizio, Inc
+2C641F     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+20-77-59   (hex)		OPTICAL NETWORK VIDEO TECHNOLOGIES (SHENZHEN) CO., LTD.
+207759     (base 16)		OPTICAL NETWORK VIDEO TECHNOLOGIES (SHENZHEN) CO., LTD.
+				The 4-6th Floor, No. 59, HuaNing Road, Xinwei Community, Dalang Street, Longhua District
+				Shenzhen    518000
+				CN
+
+54-E7-D5   (hex)		Sun Cupid Technology (HK) LTD
+54E7D5     (base 16)		Sun Cupid Technology (HK) LTD
+				Room 1201-3, 12/F., Tower 6
+				Tsim Sha Tsui    
+				HK
+
+18-90-88   (hex)		eero inc.
+189088     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+4C-56-DF   (hex)		Targus US LLC
+4C56DF     (base 16)		Targus US LLC
+				1211 North Miller Street
+				Anaheim  CA  92806
+				US
+
+24-15-10   (hex)		IEEE Registration Authority
+241510     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+6C-4D-51   (hex)		Shenzhen Ceres Technology Co., Ltd.
+6C4D51     (base 16)		Shenzhen Ceres Technology Co., Ltd.
+				#601, Fl6, Bldg F, No.1008  Yangguang Community, Xili, Nanshan
+				Shenzhen  Guangdong  518055
+				CN
+
+88-9D-98   (hex)		Allied-telesisK.K.
+889D98     (base 16)		Allied-telesisK.K.
+				7-21-11 Nishi-Gotannda
+				Shinagawa-ku  Tokyo  141-0031
+				JP
+
+DC-F8-B9   (hex)		zte corporation
+DCF8B9     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+18-BF-1C   (hex)		Jiangsu Huitong Group Co.,Ltd.
+18BF1C     (base 16)		Jiangsu Huitong Group Co.,Ltd.
+				No. 24, Block 2, Taohuawu New District
+				Zhenjiang  Jiangsu  212003
+				CN
+
+AC-DE-48   (hex)		Private
+ACDE48     (base 16)		Private
+
+00-50-C7   (hex)		Private
+0050C7     (base 16)		Private
+
+00-20-67   (hex)		Private
+002067     (base 16)		Private
+
+48-01-C5   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+4801C5     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+B4-EE-25   (hex)		Shenzhen Belon Technology CO.,LTD
+B4EE25     (base 16)		Shenzhen Belon Technology CO.,LTD
+				Tsinghua Information
+				Shenzhen  Guangdong  518052
+				CN
+
+C8-2B-96   (hex)		Espressif Inc.
+C82B96     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+98-52-3D   (hex)		Sunitec Enterprise Co.,Ltd
+98523D     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+D0-15-A6   (hex)		Aruba, a Hewlett Packard Enterprise Company
+D015A6     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-01-63   (hex)		Cisco Systems, Inc
+000163     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-63-4C   (hex)		D-Link International
+60634C     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+20-5F-3D   (hex)		Cambridge Communication Systems Ltd
+205F3D     (base 16)		Cambridge Communication Systems Ltd
+				Victory House, Vision Park, Chivers Way, Histon
+				Cambridge    CB24 9ZR
+				GB
+
+04-81-9B   (hex)		BSkyB Ltd
+04819B     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+E0-00-84   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E00084     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-A8-9C   (hex)		Creatz inc.
+2CA89C     (base 16)		Creatz inc.
+				16, Deogyeong-daero 1556beon-gil, Yeongtong-gu
+				Suwon-si,  Gyeonggi-do,   16690
+				KR
+
+4C-DC-0D   (hex)		Coral Telecom Limited
+4CDC0D     (base 16)		Coral Telecom Limited
+				E-2, Sector 63
+				Noida  Uttar Pradesh  201301
+				IN
+
+00-4E-01   (hex)		Dell Inc.
+004E01     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+C4-E1-A1   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C4E1A1     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+AC-C3-58   (hex)		Continental Automotive Czech Republic s.r.o.
+ACC358     (base 16)		Continental Automotive Czech Republic s.r.o.
+				Průmyslová 1851
+				Brandýs nad Labem    250 01
+				CZ
+
+3C-EC-EF   (hex)		Super Micro Computer, Inc.
+3CECEF     (base 16)		Super Micro Computer, Inc.
+				980 Rock Ave
+				San Jose  CA  95131
+				US
+
+18-55-E3   (hex)		Apple, Inc.
+1855E3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-50-EB   (hex)		Apple, Inc.
+E450EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-64-40   (hex)		Apple, Inc.
+886440     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-70-C0   (hex)		Apple, Inc.
+6070C0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-C3-71   (hex)		Apple, Inc.
+F0C371     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-FF-0A   (hex)		Wistron Neweb Corporation
+64FF0A     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+F0-99-19   (hex)		Garmin International
+F09919     (base 16)		Garmin International
+				1200 E. 151st St
+				Olathe  KS  66062
+				US
+
+00-00-DE   (hex)		CETIA
+0000DE     (base 16)		CETIA
+				150 RUE BERTHELOT
+				    
+				FR
+
+F4-3E-66   (hex)		Bee Computing (HK) Limited
+F43E66     (base 16)		Bee Computing (HK) Limited
+				Room 1902, 19/F, Lee Garden One 33 Hysan Avenue, Causeway Bay
+				Hong Kong    100043
+				HK
+
+DC-39-6F   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+DC396F     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+B4-C4-76   (hex)		Wuhan Maritime Communication Research Institute
+B4C476     (base 16)		Wuhan Maritime Communication Research Institute
+				No.312 Luoyu road, Hongshan District
+				Wuhan  Hubei  430079
+				CN
+
+68-34-89   (hex)		LEA Professional
+683489     (base 16)		LEA Professional
+				635 S. Lafayette Blvd
+				South Bend  IN  46601
+				US
+
+B4-6C-47   (hex)		Panasonic Appliances Company
+B46C47     (base 16)		Panasonic Appliances Company
+				2-3-1-2 Noji-higashi
+				Kusatsu City  Shiga  525-8555
+				JP
+
+44-42-2F   (hex)		TESTOP CO.,LTD.
+44422F     (base 16)		TESTOP CO.,LTD.
+				808RM Hanshin IT Tower ,272, Digital-ro
+				Guro-gu  Seoul  08389
+				KR
+
+54-9C-27   (hex)		Plasma Cloud Limited
+549C27     (base 16)		Plasma Cloud Limited
+				5/F, Yat Chau Building, 262 Des Voeux Road Central
+				Hong Kong    NA
+				HK
+
+D0-4E-50   (hex)		Mobiwire Mobiles (NingBo) Co., LTD
+D04E50     (base 16)		Mobiwire Mobiles (NingBo) Co., LTD
+				No.999 Dacheng East Road, Fenghua District, Ningbo City , Zhejiang Province, PRC
+				Ningbo  Zhejiang  315500
+				CN
+
+94-BF-80   (hex)		zte corporation
+94BF80     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+98-7A-14   (hex)		Microsoft Corporation
+987A14     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+C8-3D-DC   (hex)		Xiaomi Communications Co Ltd
+C83DDC     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+9C-3A-9A   (hex)		Shenzhen Sundray Technologies Company Limited
+9C3A9A     (base 16)		Shenzhen Sundray Technologies Company Limited
+				5th Floor, Block A4, Nanshan ipark,NO.1001 Xue Yuan Road, Nanshan District, Shenzhen 518055, P.R. China
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-B5-E8   (hex)		Ruroc LTD
+B0B5E8     (base 16)		Ruroc LTD
+				Unit 2, Barnett Way, Barnwood Estate
+				Gloucester    GL4 3RT
+				GB
+
+04-D5-90   (hex)		Fortinet, Inc.
+04D590     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale  null  94086
+				US
+
+54-15-89   (hex)		MCS Logic Inc.
+541589     (base 16)		MCS Logic Inc.
+				A-1701, Munjeong-dong, SK V1 GL Metro City, 128, Beobwon-ro, Songpa-gu, 
+				seoul  seoul  05854
+				KR
+
+84-57-33   (hex)		Microsoft Corporation
+845733     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND    98052
+				US
+
+00-24-23   (hex)		AzureWave Technologies (Shanghai) Inc.
+002423     (base 16)		AzureWave Technologies (Shanghai) Inc.
+				NO. 8, LANE 66, CHENGBAO RD.
+				SHANGHAI    201801
+				CN
+
+8C-59-3C   (hex)		IEEE Registration Authority
+8C593C     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+60-29-D5   (hex)		DAVOLINK Inc.
+6029D5     (base 16)		DAVOLINK Inc.
+				112, Beolmal-ro
+				Dongan-gu, Anyang-si  Gyeonggi-do  14057
+				KR
+
+50-97-44   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+509744     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+58-F3-9C   (hex)		Cisco Systems, Inc
+58F39C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C4-41-1E   (hex)		Belkin International Inc.
+C4411E     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  null  90094
+				US
+
+00-77-E4   (hex)		Nokia
+0077E4     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+00-AD-63   (hex)		Dedicated Micros Malta LTD
+00AD63     (base 16)		Dedicated Micros Malta LTD
+				Blb017, Qasam Industrijali Bulebel
+				ZEJTUN    ZTN 3000
+				MT
+
+E4-15-F6   (hex)		Texas Instruments
+E415F6     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+AC-42-28   (hex)		Parta Networks
+AC4228     (base 16)		Parta Networks
+				Teknopark Izmir No:38
+				URLA  IZMIR  35433
+				TR
+
+F4-1D-6B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F41D6B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+7C-EC-9B   (hex)		Fuzhou Teraway Information Technology Co.,Ltd
+7CEC9B     (base 16)		Fuzhou Teraway Information Technology Co.,Ltd
+				2F, Building 5#, No. 59, Yangqi Road, Cangshan District
+				Fuzhou  Fujian  350000
+				CN
+
+CC-90-70   (hex)		Cisco Systems, Inc
+CC9070     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+28-41-C6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2841C6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+38-01-18   (hex)		ULVAC,Inc.
+380118     (base 16)		ULVAC,Inc.
+				2500 Hagizono
+				Chigasaki  Kanagawa  253-8543
+				JP
+
+14-AD-CA   (hex)		China Mobile Iot Limited company
+14ADCA     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+80-91-33   (hex)		AzureWave Technology Inc.
+809133     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+B4-F5-8E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B4F58E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-8F-C1   (hex)		DEEPTRACK S.L.U.
+C48FC1     (base 16)		DEEPTRACK S.L.U.
+				Avenida de Barajas 32, Parque E. Omega, Edificio A
+				Alcobendas    28100
+				ES
+
+F8-23-87   (hex)		Shenzhen Horn Audio Co.,Ltd.
+F82387     (base 16)		Shenzhen Horn Audio Co.,Ltd.
+				NO.6 4th GuiHua road,PingShan,
+				Shenzhen  Guangdong  518118
+				CN
+
+E8-28-C1   (hex)		Eltex Enterprise Ltd.
+E828C1     (base 16)		Eltex Enterprise Ltd.
+				Okruzhnaya st. 29v
+				Novosibirsk    630020
+				RU
+
+78-D3-47   (hex)		Ericsson AB
+78D347     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+A4-A1-79   (hex)		Nanjing dianyan electric power automation co. LTD
+A4A179     (base 16)		Nanjing dianyan electric power automation co. LTD
+				No. 29, liuzhou north road, pukou district
+				Nanjing  Jiangsu  210031
+				CN
+
+68-DB-67   (hex)		Nantong Coship Electronics Co., Ltd.
+68DB67     (base 16)		Nantong Coship Electronics Co., Ltd.
+				No.188 Xinsheng Road
+				Nantong    226000
+				US
+
+18-19-D6   (hex)		Samsung Electronics Co.,Ltd
+1819D6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-98-DF   (hex)		Motorola Mobility LLC, a Lenovo Company
+BC98DF     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+70-FC-8F   (hex)		FREEBOX SAS
+70FC8F     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+50-1B-32   (hex)		Taicang T&W Electronics
+501B32     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+98-0D-67   (hex)		Zyxel Communications Corporation
+980D67     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-02-D8   (hex)		BRECIS Communications Corporation
+0002D8     (base 16)		BRECIS Communications Corporation
+				2025 Gateway Place, Suite 132
+				San Jose  CA  95110
+				US
+
+B0-A6-F5   (hex)		Xaptum, Inc.
+B0A6F5     (base 16)		Xaptum, Inc.
+				350 W Ontario ST FL 4
+				Chicago  IL  60654
+				US
+
+AC-F5-E6   (hex)		Cisco Systems, Inc
+ACF5E6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+DC-B0-82   (hex)		Nokia
+DCB082     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+F8-C3-97   (hex)		NZXT Corp. Ltd.
+F8C397     (base 16)		NZXT Corp. Ltd.
+				13164 E. Temple Ave.
+				City of Industry  California  91746
+				US
+
+70-DD-A8   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+70DDA8     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+4C-6F-9C   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+4C6F9C     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+78-2C-29   (hex)		New H3C Technologies Co., Ltd
+782C29     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+BC-9F-E4   (hex)		Aruba, a Hewlett Packard Enterprise Company
+BC9FE4     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+70-2E-80   (hex)		DIEHL Connectivity Solutions
+702E80     (base 16)		DIEHL Connectivity Solutions
+				Stephanstraße 49
+				Nürnberg  Bayern  90478
+				DE
+
+AC-A4-6E   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+ACA46E     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+C8-B4-22   (hex)		ASKEY COMPUTER CORP
+C8B422     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+94-EE-9F   (hex)		HMD Global Oy
+94EE9F     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+DC-2A-A1   (hex)		MedHab LLC
+DC2AA1     (base 16)		MedHab LLC
+				3501 North US Highway 67
+				San Angelo  TX  76905
+				US
+
+E4-F3-E8   (hex)		Shenzhen SuperElectron Technology Co.,Ltd.
+E4F3E8     (base 16)		Shenzhen SuperElectron Technology Co.,Ltd.
+				1213-1214, haosheng business center, dongbin road, nanshan street, nanshan district, shenzhen city
+				Shenzhen   Guangdong  518000
+				CN
+
+F4-32-3D   (hex)		Sichuan tianyi kanghe communications co., LTD
+F4323D     (base 16)		Sichuan tianyi kanghe communications co., LTD
+				No.198, section 1, xueshan avenue, jinyuan town, dayi county, sichuan province
+				chengdu  sichuan  611330
+				CN
+
+F8-B7-97   (hex)		NEC Platforms, Ltd.
+F8B797     (base 16)		NEC Platforms, Ltd.
+				2-3 Kandatsukasamachi
+				Chiyodaku  Tokyo  101-8532
+				JP
+
+B0-AA-D2   (hex)		Sichuan tianyi kanghe communications co., LTD
+B0AAD2     (base 16)		Sichuan tianyi kanghe communications co., LTD
+				No.198, section 1, xueshan avenue, jinyuan town, dayi county, sichuan province
+				chengdu  sichuan  611330
+				CN
+
+10-93-97   (hex)		ARRIS Group, Inc.
+109397     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+50-75-F1   (hex)		ARRIS Group, Inc.
+5075F1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C4-65-16   (hex)		Hewlett Packard
+C46516     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+E4-1E-0A   (hex)		IEEE Registration Authority
+E41E0A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+CC-A1-2B   (hex)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+CCA12B     (base 16)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+				10F, TCL Multimedia Building, TCL International E City, No.1001 Zhongshanyuan Rd., Nanshan District
+				Shenzhen  Guangdong  518052
+				CN
+
+AC-00-D0   (hex)		zte corporation
+AC00D0     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E8-C4-17   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E8C417     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+00-1E-A3   (hex)		Nokia Danmark A/S
+001EA3     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+38-F3-2E   (hex)		Skullcandy
+38F32E     (base 16)		Skullcandy
+				6301 N. LANDMARK DRIVE
+				Park City    84098
+				US
+
+98-1E-19   (hex)		Sagemcom Broadband SAS
+981E19     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+84-B8-66   (hex)		Beijing XiaoLu technology co. LTD
+84B866     (base 16)		Beijing XiaoLu technology co. LTD
+				Room 002, floor 2, building 1, yard 4, BeiTuCheng East Road, ChaoYang district, Beijing
+				Beijing    100102
+				CN
+
+18-BC-5A   (hex)		Zhejiang Tmall Technology Co., Ltd.
+18BC5A     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, 
+				Shenzhen  Guangdong  518000
+				CN
+
+C4-C1-38   (hex)		OWLink Technology Inc
+C4C138     (base 16)		OWLink Technology Inc
+				760 Roosevelt
+				Irvine  CA  92620
+				US
+
+AC-37-C9   (hex)		RAID Incorporated
+AC37C9     (base 16)		RAID Incorporated
+				200 Brickstone Square
+				Andover  MA  01810
+				US
+
+20-58-69   (hex)		Ruckus Wireless
+205869     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+CC-37-AB   (hex)		Edgecore Networks Corporation
+CC37AB     (base 16)		Edgecore Networks Corporation
+				1 Creation Road 3.
+				Hsinchu  Hsinchu  30077
+				TW
+
+14-22-DB   (hex)		eero inc.
+1422DB     (base 16)		eero inc.
+				230 9th St.
+				San Francisco  CA  94103
+				US
+
+C8-63-14   (hex)		IEEE Registration Authority
+C86314     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+24-31-54   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+243154     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-58-E8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2C58E8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+70-CD-91   (hex)		TERACOM TELEMATICA S.A
+70CD91     (base 16)		TERACOM TELEMATICA S.A
+				RUA AMERICA,1000
+				Eldorado do Sul  Rio Grande do Sul  92990-000
+				BR
+
+2C-18-75   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+2C1875     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-6E-DE   (hex)		Sagemcom Broadband SAS
+D06EDE     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+18-39-9C   (hex)		Skorpios Technologies
+18399C     (base 16)		Skorpios Technologies
+				7401 Snaproll St NE
+				Albuquerque  NM  87109
+				US
+
+94-C2-BD   (hex)		TECNOBIT
+94C2BD     (base 16)		TECNOBIT
+				C/ FUDRE, 18
+				VALDEPEÑAS  CIUDAD REAL  13300
+				ES
+
+48-83-B4   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+4883B4     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+84-B8-B8   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+84B8B8     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+D0-41-C9   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D041C9     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-01-8D   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E8018D     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+10-A3-B8   (hex)		Iskratel d.o.o.
+10A3B8     (base 16)		Iskratel d.o.o.
+				Ljubljanska cesta 24a
+				Kranj    4000
+				SI
+
+E8-EC-A3   (hex)		Dongguan Liesheng Electronic Co.Ltd
+E8ECA3     (base 16)		Dongguan Liesheng Electronic Co.Ltd
+				13th Floor South Building, Gosun Science Park, Hongtu Rd
+				Dongguan  Dongguan  523073
+				CN
+
+08-A6-BC   (hex)		Amazon Technologies Inc.
+08A6BC     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+70-1E-68   (hex)		Hanna Instruments, Inc.
+701E68     (base 16)		Hanna Instruments, Inc.
+				584 Park East Dr.
+				Woonsocket  RI  02895
+				US
+
+1C-B3-E9   (hex)		 Shenzhen Zhongke United Communication Technology 
+1CB3E9     (base 16)		 Shenzhen Zhongke United Communication Technology 
+				6C jiajiahao commercial building, Shennan avenue
+				Shenzhen  Guangdong  518000
+				CN
+
+8C-96-5F   (hex)		Shandong Zhongan Technology Co., Ltd.
+8C965F     (base 16)		Shandong Zhongan Technology Co., Ltd.
+				North of Kejia Road, East District, Jinan High-tech Zone
+				Jinan  Shandong  250100
+				CN
+
+C0-07-4A   (hex)		Brita GmbH
+C0074A     (base 16)		Brita GmbH
+				Heinrich-Hertz-Str. 4
+				Taunusstein    65232
+				DE
+
+E8-B2-FE   (hex)		HUMAX Co., Ltd.
+E8B2FE     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+80-FD-7A   (hex)		BLU Products Inc
+80FD7A     (base 16)		BLU Products Inc
+				10814 NW 33rd Street
+				Miami  FL  33172
+				US
+
+00-17-FA   (hex)		Microsoft Corporation
+0017FA     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+94-16-25   (hex)		Apple, Inc.
+941625     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-3B-30   (hex)		duagon AG
+543B30     (base 16)		duagon AG
+				Riedstrasse 12
+				Zürich  Dietikon  8953
+				CH
+
+40-F2-1C   (hex)		DASAN Zhone Solutions
+40F21C     (base 16)		DASAN Zhone Solutions
+				7195 Oakport Street
+				Oakland  CA  94621
+				US
+
+B0-BB-8B   (hex)		WAVETEL TECHNOLOGY LIMITED
+B0BB8B     (base 16)		WAVETEL TECHNOLOGY LIMITED
+				ROOM 1611B, 16/F, HO KING COMMERCIAL CENTRE, 2-16 FAYUEN STREET, MONGKOK, KOWLOON
+				HONGKONG    999077
+				CN
+
+34-A8-EB   (hex)		Apple, Inc.
+34A8EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-BF-C4   (hex)		Ruckus Wireless
+94BFC4     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+A4-83-E7   (hex)		Apple, Inc.
+A483E7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-AF-E7   (hex)		Apple, Inc.
+F4AFE7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-88-FD   (hex)		Apple, Inc.
+AC88FD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+50-3E-7C   (hex)		LeiShen Intelligent  System Co.Ltd
+503E7C     (base 16)		LeiShen Intelligent  System Co.Ltd
+				4th Floor,No.1 Commercial Building,Cultural Center,Tanggang Road,Tanggang Community,Shajing Street,Baoan District
+				Shenzhen  Guangdong  518104
+				CN
+
+24-58-6E   (hex)		zte corporation
+24586E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B4-A3-05   (hex)		XIAMEN YAXON NETWORK CO., LTD.
+B4A305     (base 16)		XIAMEN YAXON NETWORK CO., LTD.
+				46#,Guanri Road, Software Park II
+				Xiamen  Fujian  361008
+				CN
+
+80-3E-48   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+803E48     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+24-3F-30   (hex)		Oxygen Broadband s.a.
+243F30     (base 16)		Oxygen Broadband s.a.
+				2 Messogeion ave., Athens Tower
+				Athens  Attiki  11527
+				GR
+
+3C-91-80   (hex)		Liteon Technology Corporation
+3C9180     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+20-32-6C   (hex)		Samsung Electronics Co.,Ltd
+20326C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-89-F1   (hex)		Samsung Electronics Co.,Ltd
+6489F1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-34-FB   (hex)		Xiaomi Communications Co Ltd
+2034FB     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+A8-9C-ED   (hex)		Xiaomi Communications Co Ltd
+A89CED     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+6C-A6-04   (hex)		ARRIS Group, Inc.
+6CA604     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-F9-DD   (hex)		Dell Inc.
+5CF9DD     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock    78682
+				US
+
+D0-EC-35   (hex)		Cisco Systems, Inc
+D0EC35     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+10-AE-60   (hex)		Private
+10AE60     (base 16)		Private
+
+00-25-DF   (hex)		Private
+0025DF     (base 16)		Private
+
+BC-CF-4F   (hex)		Zyxel Communications Corporation
+BCCF4F     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+C0-10-B1   (hex)		HMD Global Oy
+C010B1     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+90-89-5F   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+90895F     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road, Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+48-D8-45   (hex)		Shenzhen Mainuoke Electronics Co., Ltd
+48D845     (base 16)		Shenzhen Mainuoke Electronics Co., Ltd
+				9th Floor, Hengtemei Building, Buji
+				Shenzhen  Guangdong  518000
+				CN
+
+0C-E0-41   (hex)		iDruide
+0CE041     (base 16)		iDruide
+				19 Rue de la Turbie
+				MONACO    98000
+				MC
+
+B8-8F-B4   (hex)		JABIL CIRCUIT ITALIA S.R.L
+B88FB4     (base 16)		JABIL CIRCUIT ITALIA S.R.L
+				via andrea appiani 12
+				milano    20121
+				IT
+
+00-52-C2   (hex)		peiker acustic GmbH
+0052C2     (base 16)		peiker acustic GmbH
+				Max-Planck-Strasse 28-32
+				Friedrichsdorf    61381
+				DE
+
+8C-53-D2   (hex)		China Mobile Group Device Co.,Ltd.
+8C53D2     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+D4-53-83   (hex)		Murata Manufacturing Co., Ltd.
+D45383     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+A0-42-46   (hex)		IT Telecom Co., Ltd.
+A04246     (base 16)		IT Telecom Co., Ltd.
+				517 TheOvalley 555-9 Hogye-dong, Dong An-gu
+				Anyang-si   Gyeonggi-do  14117
+				KR
+
+0C-F4-75   (hex)		Zliide Technologies ApS
+0CF475     (base 16)		Zliide Technologies ApS
+				Sverigesgade 6
+				Aarhus    8000
+				DK
+
+68-FF-7B   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+68FF7B     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+80-8F-1D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+808F1D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-12-4E   (hex)		XAC AUTOMATION CORP.
+00124E     (base 16)		XAC AUTOMATION CORP.
+				4F, 30 Industry E. Road IX
+				Hsin-Chu    300
+				US
+
+88-E0-34   (hex)		Shinwa industries(China) ltd.
+88E034     (base 16)		Shinwa industries(China) ltd.
+				No.26,Huifeng West 2 Road,Zhongkai High-tech Zone
+				Huizhou  Guangdong  516006
+				CN
+
+48-BD-0E   (hex)		Quanta Storage Inc.
+48BD0E     (base 16)		Quanta Storage Inc.
+				3F. No.188, Wenhua 2nd Rd
+				Taoyuan City  Guishan District  33383
+				TW
+
+00-0F-69   (hex)		SEW Eurodrive GmbH & Co. KG
+000F69     (base 16)		SEW Eurodrive GmbH & Co. KG
+				Ernst Blickle Str. 42
+				Bruchsal    76646
+				DE
+
+E4-58-E7   (hex)		Samsung Electronics Co.,Ltd
+E458E7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-10-4A   (hex)		The Parvus Corporation
+00104A     (base 16)		The Parvus Corporation
+				3222 S Washington St.
+				Salt Lake City  UT  84115
+				US
+
+D0-58-C0   (hex)		Qingdao Haier Multimedia Limited. 
+D058C0     (base 16)		Qingdao Haier Multimedia Limited. 
+				Pingban Building, Haier Industry Park, Laoshan District,
+				Qingdao  Shandong  266103
+				CN
+
+F8-D4-78   (hex)		Flextronics Tech.(Ind) Pvt Ltd
+F8D478     (base 16)		Flextronics Tech.(Ind) Pvt Ltd
+				SURVEYNO.381, PADUR ROAD, KUTHAMBAKKAM VILLAGE, 602107 POONAMALLEE TALUK, THIRUVALLUR DISTRIC
+				Chennai    602107
+				IN
+
+48-C3-B0   (hex)		Pharos Co.Ltd
+48C3B0     (base 16)		Pharos Co.Ltd
+				503 Ogong-ro 144  Deokjin-gu
+				Jeonju-si     54873
+				KR
+
+DC-58-BC   (hex)		Thomas-Krenn.AG
+DC58BC     (base 16)		Thomas-Krenn.AG
+				Speltenbach-Steinaecker 1
+				Freyung    94078
+				DE
+
+00-10-25   (hex)		Grayhill, Inc
+001025     (base 16)		Grayhill, Inc
+				561 Hillgrove Ave
+				LaGrange  IL  60525
+				US
+
+38-21-C7   (hex)		Aruba, a Hewlett Packard Enterprise Company
+3821C7     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+A4-5F-9B   (hex)		Nexell
+A45F9B     (base 16)		Nexell
+				12F, 31 Hwangsaeul-ro 258 beon-gil, Bundang-gu
+				Seongnam-si, Gyeonggi-do    13595
+				KR
+
+70-EA-1A   (hex)		Cisco Systems, Inc
+70EA1A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+80-8A-8B   (hex)		vivo Mobile Communication Co., Ltd.
+808A8B     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+98-44-B6   (hex)		INFRANOR SAS
+9844B6     (base 16)		INFRANOR SAS
+				Avenue Jean Moulin
+				LOURDES    65100
+				FR
+
+38-83-9A   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+38839A     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+DC-67-23   (hex)		barox Kommunikation GmbH
+DC6723     (base 16)		barox Kommunikation GmbH
+				Marie-Curie-Strasse 8
+				Lörrach    DE-79539
+				DE
+
+44-B4-62   (hex)		Flextronics Tech.(Ind) Pvt Ltd
+44B462     (base 16)		Flextronics Tech.(Ind) Pvt Ltd
+				SURVEYNO.381, PADUR ROAD, KUTHAMBAKKAM VILLAGE, 602107 POONAMALLEE TALUK, THIRUVALLUR DISTRIC
+				Chennai    602107
+				IN
+
+94-B4-0F   (hex)		Aruba, a Hewlett Packard Enterprise Company
+94B40F     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-1A-1E   (hex)		Aruba, a Hewlett Packard Enterprise Company
+001A1E     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-24-6C   (hex)		Aruba, a Hewlett Packard Enterprise Company
+00246C     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+20-1B-C9   (hex)		Juniper Networks
+201BC9     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C8-F6-C8   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+C8F6C8     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+1C-3B-8F   (hex)		Selve GmbH & Co. KG
+1C3B8F     (base 16)		Selve GmbH & Co. KG
+				Werdohler Landstraße 286
+				Lüdenscheid    58513
+				DE
+
+E4-E7-49   (hex)		Hewlett Packard
+E4E749     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+EC-C5-7F   (hex)		Suzhou Pairlink Network Technology
+ECC57F     (base 16)		Suzhou Pairlink Network Technology
+				Room304, Building 4, No.209, Zhu Yuan Road, Suzhou new district
+				Suzhou  Jiangsu  215011
+				CN
+
+38-C2-BA   (hex)		CCTV NEOTECH
+38C2BA     (base 16)		CCTV NEOTECH
+				68, Digital-ro 9-gil, Geumcheon-gu
+				Seoul    ks013
+				KR
+
+A0-F9-B7   (hex)		Ademco Smart Homes Technology(Tianjin)Co.,Ltd.
+A0F9B7     (base 16)		Ademco Smart Homes Technology(Tianjin)Co.,Ltd.
+				No.156 Nanhai Road,TEDA, Jinbin Development Park , 21st Factory Building
+				Tianjin  Tianjin  300457
+				CN
+
+A8-3C-CB   (hex)		ROSSMA
+A83CCB     (base 16)		ROSSMA
+				 Malkova,12-108
+				PERM    614087
+				RU
+
+88-6F-D4   (hex)		Dell Inc.
+886FD4     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+CC-3F-EA   (hex)		BAE Systems, Inc
+CC3FEA     (base 16)		BAE Systems, Inc
+				1098 Clark St
+				Endicott  NY  13760
+				US
+
+4C-F2-BF   (hex)		Cambridge Industries(Group) Co.,Ltd.
+4CF2BF     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22 Floor,Qilai Tower;889 Yishan Road
+				Shanghai    200233
+				CN
+
+CC-9E-A2   (hex)		Amazon Technologies Inc.
+CC9EA2     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno    89507
+				US
+
+AC-43-30   (hex)		Versa Networks
+AC4330     (base 16)		Versa Networks
+				6001 America center Drive, Suite 400
+				San Jose  CA  95070
+				US
+
+E8-5B-B7   (hex)		Ample Systems Inc.
+E85BB7     (base 16)		Ample Systems Inc.
+				11F-2, No. 95 Minquan Rd.
+				New Taipei City     231
+				TW
+
+94-67-7E   (hex)		Belden India Private Limited
+94677E     (base 16)		Belden India Private Limited
+				Plot No. D-228, Chakan MIDC Phase 2, 
+				Village Bhamboli, Taluka:Khed  Pune, Maharashtra  410 507
+				IN
+
+AC-57-75   (hex)		HMD Global Oy
+AC5775     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+D4-3A-2E   (hex)		SHENZHEN MTC CO LTD
+D43A2E     (base 16)		SHENZHEN MTC CO LTD
+				5th Floor, 3rd Building, SHENZHEN MTC Industrial Park, XiaLilang Rd, Nanwan Street, Long’gang District
+				Shenzhen  Guangdong  518100
+				CN
+
+50-AD-92   (hex)		NX Technologies
+50AD92     (base 16)		NX Technologies
+				5F(OS Building), 57, Daeril-2gil, Beomseo-eup
+				Ulsan    44922
+				KR
+
+30-C3-D9   (hex)		ALPS ELECTRIC CO., LTD.
+30C3D9     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+00-32-17   (hex)		Cisco Systems, Inc
+003217     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-FB   (hex)		ALPS ELECTRIC CO., LTD.
+001BFB     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+94-E0-D6   (hex)		China Dragon Technology Limited
+94E0D6     (base 16)		China Dragon Technology Limited
+				B4 Bldg.Haoshan 1st Industry Park,
+				Shenzhen  Guangdong  518104
+				CN
+
+B4-A9-FC   (hex)		Quanta Computer Inc.
+B4A9FC     (base 16)		Quanta Computer Inc.
+				No. 211, Wen-Hwa 2nd Rd.,Kuei-Shan Dist.
+				Taoyuan City  Taiwan  33377
+				TW
+
+6C-A9-36   (hex)		DisplayLink (UK) Ltd
+6CA936     (base 16)		DisplayLink (UK) Ltd
+				140 Science Park, Milton road
+				Cambridge  Cambridgeshire  CB4 0GF
+				GB
+
+70-85-40   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+708540     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+08-F1-EA   (hex)		Hewlett Packard Enterprise
+08F1EA     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F0-0D-F5   (hex)		ACOMA Medical Industry Co,. Ltd.
+F00DF5     (base 16)		ACOMA Medical Industry Co,. Ltd.
+				2-14-14 hongo
+				bunkyo-ku  Tokyo  113-0033
+				JP
+
+68-45-F1   (hex)		TOSHIBA CLIENT SOLUTIONS CO., LTD.
+6845F1     (base 16)		TOSHIBA CLIENT SOLUTIONS CO., LTD.
+				Tachihi Building No.2, 6-1-3, Sakae-Cho
+				Tachikawa-shi  Tokyo  190-0003
+				JP
+
+8C-AE-DB   (hex)		NAG LLC
+8CAEDB     (base 16)		NAG LLC
+				Predelnaya st 57/2
+				Ekaterinburg  Sverdlovskaya oblast   620161
+				RU
+
+78-B2-13   (hex)		DWnet Technologies(Suzhou) Corporation
+78B213     (base 16)		DWnet Technologies(Suzhou) Corporation
+				No.8,Tangzhuang Road, Suzhou Industrial Park, Jiangsu, China
+				Suzhou    21500
+				CN
+
+58-C2-32   (hex)		NEC Corporation
+58C232     (base 16)		NEC Corporation
+				1753, Shimonumabe, Nakahara-Ku, Kawasaki
+				Kanagawa    211-8666
+				JP
+
+38-1D-14   (hex)		Skydio Inc.
+381D14     (base 16)		Skydio Inc.
+				114 Hazel Ave
+				Redwood City  CA  94061
+				US
+
+7C-DB-98   (hex)		ASKEY COMPUTER CORP
+7CDB98     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+38-0B-3C   (hex)		Texas Instruments
+380B3C     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+9C-8C-D8   (hex)		Hewlett Packard Enterprise
+9C8CD8     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+A4-8C-C0   (hex)		JLG Industries, Inc.
+A48CC0     (base 16)		JLG Industries, Inc.
+				13224 Fountainhead Plaza
+				Hagerstown  MD  21742
+				US
+
+3C-28-6D   (hex)		Google, Inc.
+3C286D     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+00-09-3A   (hex)		Molex CMS
+00093A     (base 16)		Molex CMS
+				5224 Katrine Avenue
+				Downers Grove  IL  60515
+				US
+
+04-F9-D9   (hex)		Speaker Electronic(Jiashan) Co.,Ltd
+04F9D9     (base 16)		Speaker Electronic(Jiashan) Co.,Ltd
+				No. 8 Development Zone Road, Huimin Sub-district
+				 Jiashan  Zhejiang  314112
+				CN
+
+DC-08-0F   (hex)		Apple, Inc.
+DC080F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-E9-4E   (hex)		Apple, Inc.
+F8E94E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-2C-E2   (hex)		Apple, Inc.
+EC2CE2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-BC-60   (hex)		Apple, Inc.
+40BC60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-36-17   (hex)		Apple, Inc.
+E83617     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-64-8B   (hex)		Apple, Inc.
+9C648B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-42-62   (hex)		Apple, Inc.
+344262     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-D0-0D   (hex)		Apple, Inc.
+14D00D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-D2-11   (hex)		Eko Devices, Inc.
+88D211     (base 16)		Eko Devices, Inc.
+				2600 10th St Ste 260
+				Berkeley  CA  94710-2597
+				US
+
+B8-C2-27   (hex)		PSTec
+B8C227     (base 16)		PSTec
+				#80, Hwanggeum 3-ro 7beon-gil, Yangchon-eup
+				Gimpo-si  Gyeonggi-do  10048
+				KR
+
+74-F7-37   (hex)		KCE
+74F737     (base 16)		KCE
+				5F KCE B/D,34,Annam-ro 369beon-gil,Bupyoung-gu
+				Incheon    21312
+				KR
+
+48-A4-93   (hex)		TAIYO YUDEN CO.,LTD
+48A493     (base 16)		TAIYO YUDEN CO.,LTD
+				8-1, Sakae-cho
+				Takasaki-shi  Gunma  370-8522
+				JP
+
+E8-2C-6D   (hex)		SmartRG, Inc.
+E82C6D     (base 16)		SmartRG, Inc.
+				501 SE Columbia Shores Blvd
+				Vancouver  WA  98661
+				US
+
+48-E6-95   (hex)		Insigma Inc
+48E695     (base 16)		Insigma Inc
+				43490, Yukon Drive, Suite 102
+				Ashburn  VA  20147
+				US
+
+B4-79-C8   (hex)		Ruckus Wireless
+B479C8     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+B4-0B-78   (hex)		Brusa Elektronik AG
+B40B78     (base 16)		Brusa Elektronik AG
+				Neudorf 14
+				Sennwald  St. Gallen  9466
+				CH
+
+C0-3D-D9   (hex)		MitraStar Technology Corp.
+C03DD9     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+2C-AA-8E   (hex)		Wyze Labs Inc
+2CAA8E     (base 16)		Wyze Labs Inc
+				4030 Lake Washington Boulevard NE
+				Kirkland  WA  98033
+				US
+
+70-3A-51   (hex)		Xiaomi Communications Co Ltd
+703A51     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+DC-48-B2   (hex)		Baraja Pty. Ltd.
+DC48B2     (base 16)		Baraja Pty. Ltd.
+				36 Bradfield Road
+				West Lindfield  NSW  2070
+				AU
+
+AC-AE-19   (hex)		Roku, Inc
+ACAE19     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+18-1E-95   (hex)		AuVerte
+181E95     (base 16)		AuVerte
+				14 Riverview Road
+				Niantic  CT  06357
+				US
+
+0C-95-41   (hex)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+0C9541     (base 16)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+				9F,BLOCK A,GARDEN CITY DIGITAL BUILDING,NO.1079 NANHAI ROAD,NANSHAN DISTRICT
+				SHEN ZHEN  GUANG DONG  518000
+				CN
+
+AC-F8-5C   (hex)		Private
+ACF85C     (base 16)		Private
+
+9C-69-37   (hex)		Qorvo Utrecht B.V.
+9C6937     (base 16)		Qorvo Utrecht B.V.
+				Leidseveer 10
+				Utrecht  Utrecht  3511SB
+				NL
+
+3C-37-86   (hex)		NETGEAR
+3C3786     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+48-35-2E   (hex)		Shenzhen Wolck Network Product Co.,LTD
+48352E     (base 16)		Shenzhen Wolck Network Product Co.,LTD
+				9# BuJi BanTian LongBi Industry Area
+				Shenzhen  Guangdong  518129
+				CN
+
+04-E5-98   (hex)		Xiaomi Communications Co Ltd
+04E598     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+10-12-B4   (hex)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+1012B4     (base 16)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+				NO.198 FIRST SECTION,SNOW MOUNTAIN AVENUE, JINYUAN TOWN, DAYI COUNTY, 
+				CHENGDU  SICHUAN  611330
+				CN
+
+B8-2C-A0   (hex)		Resideo
+B82CA0     (base 16)		Resideo
+				2 Corporate Center Dr.
+				Melville  NY  11747
+				US
+
+6C-C7-EC   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+6CC7EC     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+B0-33-A6   (hex)		Juniper Networks
+B033A6     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+D8-96-85   (hex)		GoPro
+D89685     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+3C-01-EF   (hex)		Sony Mobile Communications Inc
+3C01EF     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+C0-BD-C8   (hex)		Samsung Electronics Co.,Ltd
+C0BDC8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-7B-CE   (hex)		Samsung Electronics Co.,Ltd
+647BCE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-87-B3   (hex)		Samsung Electronics Co.,Ltd
+A887B3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+6C-00-6B   (hex)		Samsung Electronics Co.,Ltd
+6C006B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-10-60   (hex)		BILLIONTON SYSTEMS, INC.
+001060     (base 16)		BILLIONTON SYSTEMS, INC.
+				3F-1, NO. 8, LANE 99
+				HSIN-CHU    
+				TW
+
+C4-D4-89   (hex)		JiangSu Joyque Information Industry Co.,Ltd
+C4D489     (base 16)		JiangSu Joyque Information Industry Co.,Ltd
+				10  Floor YaHua Building, Xi'anBei Road,
+				Xuzhou  JiangSu  221006
+				CN
+
+B4-F9-49   (hex)		optilink networks pvt ltd
+B4F949     (base 16)		optilink networks pvt ltd
+				501/502, sanjona complex, hemu kalani marg, chembur
+				mumbai  maharashtra  400071
+				IN
+
+E4-3C-80   (hex)		University of Oklahoma
+E43C80     (base 16)		University of Oklahoma
+				Advanced Radar Research Center
+				Norman  OK  73019
+				US
+
+3C-2C-30   (hex)		Dell Inc.
+3C2C30     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+70-6D-15   (hex)		Cisco Systems, Inc
+706D15     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-A1-E4   (hex)		Innotube, Inc.
+A4A1E4     (base 16)		Innotube, Inc.
+				#1212 MegaCenter SknTechnoPark 124 Sagimakgol-ro Jungwon-gu
+				Seongnam-si  Gyeonggi-do  462-120
+				KR
+
+94-EA-EA   (hex)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+94EAEA     (base 16)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+				Av. Buriti, 1900 – Setor B – Distrito Industrial
+				Manaus  Amazonas  69075-000
+				BR
+
+1C-FD-08   (hex)		IEEE Registration Authority
+1CFD08     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B8-59-9F   (hex)		Mellanox Technologies, Inc.
+B8599F     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+30-13-89   (hex)		Siemens AG, Automations & Drives,
+301389     (base 16)		Siemens AG, Automations & Drives,
+				Systems Engineering
+				Fürth  Deutschlang  90766
+				DE
+
+04-6B-25   (hex)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+046B25     (base 16)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+				NO.198 FIRST SECTION,SNOW MOUNTAIN AVENUE, JINYUAN TOWN, DAYI COUNTY, 
+				CHENGDU  SICHUAN  611330
+				CN
+
+98-D3-E7   (hex)		Netafim L
+98D3E7     (base 16)		Netafim L
+				Kibutz Magal
+				Kibutz Magal    38845
+				IL
+
+F0-63-F9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F063F9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-C3-85   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7CC385     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-0E-B3   (hex)		Shenzhen Amediatech Technology Co., Ltd.
+900EB3     (base 16)		Shenzhen Amediatech Technology Co., Ltd.
+				2th floor, block A, building B, Minsheng Industrial Zone, Longhua District
+				Shenzhen  Guangdong  518109
+				CN
+
+54-9F-AE   (hex)		iBASE Gaming Inc
+549FAE     (base 16)		iBASE Gaming Inc
+				2F., No.542-17, Zhongzheng Rd
+				Xinzhuang Dist., New Taipei City    24255
+				TW
+
+14-69-A2   (hex)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+1469A2     (base 16)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+				NO.198 FIRST SECTION,SNOW MOUNTAIN AVENUE, JINYUAN TOWN, DAYI COUNTY, 
+				CHENGDU  SICHUAN  611330
+				CN
+
+54-80-28   (hex)		Hewlett Packard Enterprise
+548028     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+00-AD-24   (hex)		D-Link International
+00AD24     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+54-06-8B   (hex)		Ningbo Deli Kebei Technology Co.LTD
+54068B     (base 16)		Ningbo Deli Kebei Technology Co.LTD
+				zone 2nd , 301#, Road Xuxiake, Ninghai yuelong district
+				ningbo  Zhejiang  315600
+				CN
+
+60-CE-92   (hex)		The Refined Industry Company Limited
+60CE92     (base 16)		The Refined Industry Company Limited
+				7/F Sun King Factory Bldg,1 - 7 Shing Chuen Road, Shatin, NT
+				Hong Kong  NT  000000
+				HK
+
+10-5B-AD   (hex)		Mega Well Limited
+105BAD     (base 16)		Mega Well Limited
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+74-BF-C0   (hex)		CANON INC.
+74BFC0     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+C8-D9-D2   (hex)		Hewlett Packard
+C8D9D2     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+24-FC-E5   (hex)		Samsung Electronics Co.,Ltd
+24FCE5     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+80-96-21   (hex)		Lenovo
+809621     (base 16)		Lenovo
+				1009 Think Place
+				Morrisvilee  NC  27560
+				US
+
+78-05-5F   (hex)		Shenzhen WYC Technology Co., Ltd.
+78055F     (base 16)		Shenzhen WYC Technology Co., Ltd.
+				No.618 Wenzhengxin Building，Hi-tech Park，Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+00-EA-BD   (hex)		Cisco Systems, Inc
+00EABD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+48-87-2D   (hex)		SHEN ZHEN DA XIA LONG QUE TECHNOLOGY CO.,LTD
+48872D     (base 16)		SHEN ZHEN DA XIA LONG QUE TECHNOLOGY CO.,LTD
+				Room 511, Building C,  Yuxing Technology Park, Gushu Second Road, Bao’an District
+				SHEN ZHEN  GUANG DONG  518000
+				CN
+
+E8-1A-58   (hex)		TECHNOLOGIC SYSTEMS
+E81A58     (base 16)		TECHNOLOGIC SYSTEMS
+				16525 E Laser Dr
+				Fountain Hills  AZ  85268-6534
+				US
+
+20-B0-01   (hex)		Technicolor
+20B001     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+C0-BF-A7   (hex)		Juniper Networks
+C0BFA7     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F0-54-94   (hex)		Honeywell Connected Building
+F05494     (base 16)		Honeywell Connected Building
+				1985 DOUGLAS DRIVE
+				Golden Valley  MN  55422
+				US
+
+5C-C9-99   (hex)		New H3C Technologies Co., Ltd
+5CC999     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+B0-2A-43   (hex)		Google, Inc.
+B02A43     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+C4-74-F8   (hex)		Hot Pepper, Inc.
+C474F8     (base 16)		Hot Pepper, Inc.
+				5151 California Ave., Suite 100, 
+				Irvine     92617
+				US
+
+14-22-33   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+142233     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+74-34-00   (hex)		MTG Co., Ltd.
+743400     (base 16)		MTG Co., Ltd.
+				MTG No. 2 HIKARI Bldg., 4-13 Honjindori
+				Nakamura-ku, Nagoya  Aichi  453-0041
+				JP
+
+DC-37-57   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+DC3757     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+00-50-99   (hex)		3COM EUROPE LTD
+005099     (base 16)		3COM EUROPE LTD
+				BOUNDARY WAY
+				HERTS. HP2 7YU      vvvvvv
+				GB
+
+04-BC-87   (hex)		Shenzhen JustLink Technology Co., LTD
+04BC87     (base 16)		Shenzhen JustLink Technology Co., LTD
+				Room 5002,The 2nd Unit  of  the   Building  East,   Laobing   Building, No.3012  Xingye Road,Baoan District
+				Shenzhen  Guangdong Province  518101
+				CN
+
+54-C3-3E   (hex)		Ciena Corporation
+54C33E     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+EC-79-F2   (hex)		Startel
+EC79F2     (base 16)		Startel
+				Xi Chuang Industrial Park，Second industrial district of Guan Long Village，Xili town ，Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+BC-B2-2B   (hex)		EM-Tech
+BCB22B     (base 16)		EM-Tech
+				40, Changwon-daero 1144beon-gil
+				Seongsan-gu Changwon  Gyeongsangnam-do  KR 642-120
+				KR
+
+D4-AB-82   (hex)		ARRIS Group, Inc.
+D4AB82     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-4F-B8   (hex)		ARRIS Group, Inc.
+704FB8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-60-EB   (hex)		FOURTHTRACK SYSTEMS
+0060EB     (base 16)		FOURTHTRACK SYSTEMS
+				UNIT 3 THE SYCAMORES
+				MARLOW - SL7 1QB    
+				GB
+
+18-62-E4   (hex)		Texas Instruments
+1862E4     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+60-35-C0   (hex)		SFR
+6035C0     (base 16)		SFR
+				12 rue jean-philippe Rameau CS 80001
+				La plaine saint denis   FRANCE  93634
+				FR
+
+C4-98-5C   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+C4985C     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+30-A1-FA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30A1FA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-2E-90   (hex)		PALIT MICROSYSTEMS, LTD
+242E90     (base 16)		PALIT MICROSYSTEMS, LTD
+				21F.,No.88,Sec.2,Zhongxiao E.Rd.,Golden Tower,
+				TAIPEI    100
+				TW
+
+9C-AA-1B   (hex)		Microsoft Corporation
+9CAA1B     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+A8-9A-93   (hex)		Sagemcom Broadband SAS
+A89A93     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-1A-C5   (hex)		Keysight Technologies, Inc.
+001AC5     (base 16)		Keysight Technologies, Inc.
+				1400 Fountaingrove Pkwy.
+				Santa Rosa  CA  95403
+				US
+
+00-20-1E   (hex)		NETQUEST CORPORATION
+00201E     (base 16)		NETQUEST CORPORATION
+				523 FELLOWSHIP ROAD-STE.#205
+				MT. LAUREL  NJ  08054
+				US
+
+64-62-8A   (hex)		evon GmbH
+64628A     (base 16)		evon GmbH
+				Frank-Stronach-Straße 8
+				Gleisdorf  Styria  8200
+				AT
+
+04-15-D9   (hex)		Viwone
+0415D9     (base 16)		Viwone
+				54 - 56 , Avenue Hoche
+				Paris    75008
+				FR
+
+EC-B3-13   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+ECB313     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+B0-8B-CF   (hex)		Cisco Systems, Inc
+B08BCF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-60-8C   (hex)		3COM
+00608C     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-A0-24   (hex)		3COM
+00A024     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-20-AF   (hex)		3COM
+0020AF     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-10-4B   (hex)		3COM
+00104B     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+A8-5A-F3   (hex)		Shanghai Siflower Communication Technology Co., Ltd
+A85AF3     (base 16)		Shanghai Siflower Communication Technology Co., Ltd
+				 Rm. 408, No. 84, Lane 887. Zhangjiang Hi-Tech Park. Zuchongzhi Rd. Shanghai, China
+				Shanghai  Shanghai  201210
+				CN
+
+70-FD-46   (hex)		Samsung Electronics Co.,Ltd
+70FD46     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-83-E1   (hex)		Samsung Electronics Co.,Ltd
+8C83E1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-9F-6F   (hex)		Samsung Electronics Co.,Ltd
+889F6F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+5C-63-C9   (hex)		Intellithings Ltd.
+5C63C9     (base 16)		Intellithings Ltd.
+				Hanehoshet 10
+				Tel Aviv  Israel  6971072
+				IL
+
+0C-96-E6   (hex)		Cloud Network Technology (Samoa) Limited
+0C96E6     (base 16)		Cloud Network Technology (Samoa) Limited
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+3C-89-94   (hex)		BSkyB Ltd
+3C8994     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+E0-0E-E1   (hex)		We Corporation Inc.
+E00EE1     (base 16)		We Corporation Inc.
+				201, 33, Deokcheon-ro, Manan-gu
+				Anyang-si  Gyeonggi-do  14088
+				KR
+
+00-0C-43   (hex)		Ralink Technology, Corp.
+000C43     (base 16)		Ralink Technology, Corp.
+				4F, No.2, Technology 5th Road,
+				Hsin-Chu    200
+				TW
+
+8C-92-46   (hex)		Oerlikon Textile Gmbh&Co.KG
+8C9246     (base 16)		Oerlikon Textile Gmbh&Co.KG
+				NO.9 Changyang Street
+				Suzhou  Jiangsu  215000
+				CN
+
+00-0E-94   (hex)		Maas International BV
+000E94     (base 16)		Maas International BV
+				Science Park Eindhoven 5051
+				Son  Noord Brabant  NL-5692 EB
+				NL
+
+48-98-CA   (hex)		Sichuan AI-Link Technology Co., Ltd.
+4898CA     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+24-7E-51   (hex)		zte corporation
+247E51     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E8-B5-41   (hex)		zte corporation
+E8B541     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+0C-9D-92   (hex)		ASUSTek COMPUTER INC.
+0C9D92     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+98-8E-D4   (hex)		ITEL MOBILE LIMITED
+988ED4     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+E8-A7-88   (hex)		XIAMEN LEELEN TECHNOLOGY CO., LTD
+E8A788     (base 16)		XIAMEN LEELEN TECHNOLOGY CO., LTD
+				65 Sunban South Rd., Jimei North Industrial Zone, 
+				Xiamen   Fujian  361021
+				CN
+
+58-2D-34   (hex)		Qingping Electronics (Suzhou) Co., Ltd
+582D34     (base 16)		Qingping Electronics (Suzhou) Co., Ltd
+				Room 304, A3 Building, NO.88 Dongchang Road, Suzhou Industrial Park
+				Suzhou  Jiangsu Province  215028
+				CN
+
+20-DE-88   (hex)		IC Realtime LLC
+20DE88     (base 16)		IC Realtime LLC
+				3050 N Andrews Ave Ext.
+				Pompano Beach  FL  33064
+				US
+
+F4-06-8D   (hex)		devolo AG
+F4068D     (base 16)		devolo AG
+				Charlottenburger Allee 67
+				Aachen  NRW  52068
+				DE
+
+00-1A-31   (hex)		SCAN COIN AB
+001A31     (base 16)		SCAN COIN AB
+				Jagershillgatan 26
+				Malmö  Skåne  21375
+				SE
+
+00-1B-84   (hex)		Scan Engineering Telecom
+001B84     (base 16)		Scan Engineering Telecom
+				Svobody str. 75
+				Voronezh    394030
+				RU
+
+48-2C-A0   (hex)		Xiaomi Communications Co Ltd
+482CA0     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+34-12-F9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3412F9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-E2-65   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BCE265     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-D1-A1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CD1A1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-BF-E4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88BFE4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+40-17-E2   (hex)		INTAI TECHNOLOGY CORP.
+4017E2     (base 16)		INTAI TECHNOLOGY CORP.
+				No.9, JINGKE RD.,NANTUN DIST.
+				TAICHUNG CITY    40852
+				TW
+
+0C-CB-85   (hex)		Motorola Mobility LLC, a Lenovo Company
+0CCB85     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+A4-E6-15   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+A4E615     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+74-1F-79   (hex)		YOUNGKOOK ELECTRONICS CO.,LTD
+741F79     (base 16)		YOUNGKOOK ELECTRONICS CO.,LTD
+				#810, Daewoo Frontier Valley 1,16-25, Dongbaekjungang-ro 16beon-gil, Giheung-gu
+				YONGIN  Gyeonggi-do  17015
+				KR
+
+A0-93-51   (hex)		Cisco Systems, Inc
+A09351     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+98-03-9B   (hex)		Mellanox Technologies, Inc.
+98039B     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100
+				Sunnyvale  CA  94085
+				US
+
+20-89-84   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+208984     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				No.25, Third Avenue, A Zone, Kunshan Comprehensive Free Trade Zone
+				KUNSHAN   SUZHOU   215300 
+				CN
+
+B4-CE-FE   (hex)		James Czekaj
+B4CEFE     (base 16)		James Czekaj
+				41716 Waterfall Rd
+				Northville  MI  48168
+				US
+
+F8-CC-6E   (hex)		DEPO Electronics Ltd
+F8CC6E     (base 16)		DEPO Electronics Ltd
+				12, kommunalnaya zona Krasnogorsk-Mitino
+				Krasnogorsk  Moscow region  143404
+				RU
+
+F8-36-9B   (hex)		Texas Instruments
+F8369B     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-AE-1D   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+88AE1D     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD STREET KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+B8-88-E3   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+B888E3     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				No.25, Third Avenue, A Zone, Kunshan Comprehensive Free Trade Zone,, Jiangsu, 
+				KUNSHAN   SUZHOU  215300
+				CN
+
+28-9E-FC   (hex)		Sagemcom Broadband SAS
+289EFC     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-C0-55   (hex)		MODULAR COMPUTING TECHNOLOGIES
+00C055     (base 16)		MODULAR COMPUTING TECHNOLOGIES
+				2352 MAIN STREET
+				CONCORD  MA  01742
+				US
+
+E4-1F-E9   (hex)		Dunkermotoren GmbH
+E41FE9     (base 16)		Dunkermotoren GmbH
+				Allmendstr. 11
+				Bonndorf  Baden-Württemberg  79848
+				DE
+
+C4-51-8D   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+C4518D     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+48-68-34   (hex)		Silicon Motion, Inc.
+486834     (base 16)		Silicon Motion, Inc.
+				8F, No. 36, Taiyuan St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+00-11-33   (hex)		Siemens AG Austria
+001133     (base 16)		Siemens AG Austria
+				Siemensstrasse 90-92
+				Vienna    1210
+				AT
+
+00-0B-23   (hex)		Siemens Home & Office Comm. Devices
+000B23     (base 16)		Siemens Home & Office Comm. Devices
+				4849 Alpha Road
+				Dallas    74244
+				US
+
+64-13-31   (hex)		Bosch Car Multimedia (Wuhu) Co. Ltd.
+641331     (base 16)		Bosch Car Multimedia (Wuhu) Co. Ltd.
+				NO.48 North Yinhu Road
+				Wuhu city  Anhui Province  241000
+				CN
+
+18-3A-48   (hex)		VostroNet
+183A48     (base 16)		VostroNet
+				GPO Box 3154
+				Brisbane  Queensland  4000
+				AU
+
+78-2F-17   (hex)		Xlab Co.,Ltd
+782F17     (base 16)		Xlab Co.,Ltd
+				#401 4F, Achasan-ro, Seongdong-gu
+				SEOUL    04793
+				KR
+
+B0-02-7E   (hex)		MULLER SERVICES
+B0027E     (base 16)		MULLER SERVICES
+				107 Boulevard Ney
+				PARIS  ILE DE FRANCE  75018
+				FR
+
+24-FA-F3   (hex)		Shanghai Flexem Technology Co.,Ltd.
+24FAF3     (base 16)		Shanghai Flexem Technology Co.,Ltd.
+				Room 804, C6 Building,No.52 Bay Valley Technology Park, Lane 1688 North Guoquan Road, Yangpu District.
+				Shanghai    200438
+				CN
+
+88-D2-BF   (hex)		German Autolabs
+88D2BF     (base 16)		German Autolabs
+				Köpenicker Str. 154
+				Berlin  Berlin  10997
+				DE
+
+20-16-3D   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+20163D     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+E0-73-5F   (hex)		NUCOM
+E0735F     (base 16)		NUCOM
+				Arte, 21,5B
+				Madrid  Madrid  28033
+				ES
+
+00-51-ED   (hex)		LG Innotek
+0051ED     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+40-DC-9D   (hex)		HAJEN
+40DC9D     (base 16)		HAJEN
+				102-1302, Sinwon-ro 88, Yeongtong-gu
+				Suwon-Si  Gyeonggi-do  16681
+				KR
+
+34-0A-98   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+340A98     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-6D-6C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+646D6C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-B8-B4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4B8B4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F0-BC-C9   (hex)		PFU LIMITED
+F0BCC9     (base 16)		PFU LIMITED
+				Nu 98-2 Unoke
+				Kahoku-shi, Ishikawa    929-1192
+				JP
+
+48-75-83   (hex)		Intellion AG
+487583     (base 16)		Intellion AG
+				Schuppisstrasse 10
+				St. Gallen  St. Gallen  9016
+				CH
+
+90-4C-81   (hex)		Hewlett Packard Enterprise
+904C81     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+8C-35-79   (hex)		QDIQO Sp. z o.o.
+8C3579     (base 16)		QDIQO Sp. z o.o.
+				Stanisława Wyspiańskiego 11
+				Zielona Góra  lubuskie  65-036
+				PL
+
+38-C7-0A   (hex)		WiFiSong
+38C70A     (base 16)		WiFiSong
+				Rm. 605, Building 3, No. 75 Wenyi West Road
+				Hangzhou  Zhengjiang  310012
+				CN
+
+D8-76-0A   (hex)		Escort, Inc.
+D8760A     (base 16)		Escort, Inc.
+				5440 West Chester Rd.
+				West Chester  Ohio  45069
+				US
+
+5C-2E-D2   (hex)		ABC(XiSheng) Electronics Co.,Ltd
+5C2ED2     (base 16)		ABC(XiSheng) Electronics Co.,Ltd
+				No.2 Industrial building, FuRong 7 Road
+				ShenZhen  GongDong  518100
+				CN
+
+FC-FB-FB   (hex)		Cisco Systems, Inc
+FCFBFB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-7E-95   (hex)		Cisco Systems, Inc
+007E95     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-5A-44   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+9C5A44     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+14-CA-A0   (hex)		Hu&Co
+14CAA0     (base 16)		Hu&Co
+				105 Rue du Jardin
+				Bordeaux    33000
+				FR
+
+08-D4-6A   (hex)		LG Electronics (Mobile Communications)
+08D46A     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+68-3A-1E   (hex)		Cisco Meraki
+683A1E     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+00-10-17   (hex)		Bosch Access Systems GmbH
+001017     (base 16)		Bosch Access Systems GmbH
+				Charlottenburger Allee 50            
+				AACHEN      D-52068 
+				DE
+
+F4-EE-14   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+F4EE14     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+6C-59-40   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+6C5940     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-25-16   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+D02516     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+1C-60-DE   (hex)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+1C60DE     (base 16)		MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				Mid-Fourth Flr.,Building 28,Cui Xi Fourth Road,Ke Yuan West,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-24-77   (hex)		Universal Electric Corporation
+D82477     (base 16)		Universal Electric Corporation
+				168 Georgetown Road
+				Canonsburg  PA  15317
+				US
+
+00-90-7F   (hex)		WatchGuard Technologies, Inc.
+00907F     (base 16)		WatchGuard Technologies, Inc.
+				605 Fifth Ave. S
+				Seattle  WA  98104-3892
+				US
+
+4C-5E-0C   (hex)		Routerboard.com
+4C5E0C     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga    LV1009
+				LV
+
+D4-CA-6D   (hex)		Routerboard.com
+D4CA6D     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga    LV-1009
+				LV
+
+00-14-72   (hex)		China Broadband Wireless IP Standard group(ChinaBWIPS)
+001472     (base 16)		China Broadband Wireless IP Standard group(ChinaBWIPS)
+				P.O.BOX 88,West High-tech
+				Xi'an  Shaan Xi  710075
+				CN
+
+80-B5-75   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80B575     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-BE-2B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4BE2B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+68-E7-C2   (hex)		Samsung Electronics Co.,Ltd
+68E7C2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+58-B1-0F   (hex)		Samsung Electronics Co.,Ltd
+58B10F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+40-06-A0   (hex)		Texas Instruments
+4006A0     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F8-2D-C0   (hex)		ARRIS Group, Inc.
+F82DC0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+18-9C-27   (hex)		ARRIS Group, Inc.
+189C27     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-F5-CC   (hex)		New H3C Technologies Co., Ltd
+3CF5CC     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+D0-8A-91   (hex)		Technicolor CH USA Inc.
+D08A91     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+28-11-A5   (hex)		Bose Corporation
+2811A5     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+D8-F3-DB   (hex)		Post CH AG
+D8F3DB     (base 16)		Post CH AG
+				Wankdorfallee 4
+				Bern    3030
+				CH
+
+DC-B4-AC   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+DCB4AC     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+A4-92-CB   (hex)		Nokia
+A492CB     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+C0-D2-F3   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+C0D2F3     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+B8-83-03   (hex)		Hewlett Packard Enterprise
+B88303     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+20-3D-BD   (hex)		LG Innotek
+203DBD     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+A4-53-85   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+A45385     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road,Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+00-40-2F   (hex)		XLNT DESIGNS INC.
+00402F     (base 16)		XLNT DESIGNS INC.
+				15050 AVENUE OF SCIENCE
+				SAN DIEGO  CA  92128
+				US
+
+04-EC-BB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+04ECBB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+64-A2-F9   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+64A2F9     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+A8-7D-12   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A87D12     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-21-22   (hex)		Sercomm Corporation.
+D42122     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+00-C0-02   (hex)		Sercomm Corporation.
+00C002     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+BC-99-11   (hex)		Zyxel Communications Corporation
+BC9911     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+28-02-45   (hex)		Konze System Technology Co.,Ltd.
+280245     (base 16)		Konze System Technology Co.,Ltd.
+				4F., No.134, Ln. 235, Baoqiao Rd., Xindian Dist.
+				New Taipei City  ---  231
+				TW
+
+E4-8F-65   (hex)		Yelatma Instrument Making Enterprise, JSC
+E48F65     (base 16)		Yelatma Instrument Making Enterprise, JSC
+				Yanina 25
+				Yelatma  Ryazan Region  391351
+				RU
+
+00-00-A8   (hex)		Stratus Technologies
+0000A8     (base 16)		Stratus Technologies
+				5 Mill and Main Place, Suite 500
+				Maynard  MA  01754
+				US
+
+00-04-FC   (hex)		Stratus Technologies
+0004FC     (base 16)		Stratus Technologies
+				5 Mill and Main Place, Suite 500
+				Maynard  MA  01754
+				US
+
+3C-24-F0   (hex)		IEEE Registration Authority
+3C24F0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-BB-3A   (hex)		Amazon Technologies Inc.
+00BB3A     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+0C-B3-4F   (hex)		Shenzhen Xiaoqi Intelligent Technology Co., Ltd.
+0CB34F     (base 16)		Shenzhen Xiaoqi Intelligent Technology Co., Ltd.
+				Room 1501, Block B4, Building 9, Section 2, Shenzhen Bay Science & Technology Ecological Park, West Shahe Road, Nanshan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+3C-F4-F9   (hex)		Moda-InnoChips
+3CF4F9     (base 16)		Moda-InnoChips
+				42-7(Wonsi-Dong),Dongsan-ro 27beon-gil,Danwon-gu
+				Ansan-si   Gyeonggi-Do  15433
+				KR
+
+94-19-3A   (hex)		Elvaco AB
+94193A     (base 16)		Elvaco AB
+				Kabelgatan 2T
+				Kungsbacka    43437
+				SE
+
+C0-81-35   (hex)		Ningbo Forfan technology Co., LTD
+C08135     (base 16)		Ningbo Forfan technology Co., LTD
+				Room B308,Tianjing Building,Tianan Cyber Park,Futian
+				Shenzhen  Guangdong  518040
+				CN
+
+84-0D-8E   (hex)		Espressif Inc.
+840D8E     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+00-20-82   (hex)		ONEAC CORPORATION
+002082     (base 16)		ONEAC CORPORATION
+				27944 N. BRADLEY RD.
+				LIBERTYVILLE  IL  60048
+				US
+
+B4-C0-F5   (hex)		Shenzhen TINNO Mobile Technology Corp.
+B4C0F5     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+40-62-31   (hex)		GIFA
+406231     (base 16)		GIFA
+				11th Fl., Suojia Business Building , No.7 Hangkong Road , Baoan District
+				Shenzhen  Guangdong  518000
+				CN
+
+FC-B7-F0   (hex)		Idaho National Laboratory
+FCB7F0     (base 16)		Idaho National Laboratory
+				2525 N. Fremont Ave
+				Idaho Falls  ID  83415
+				US
+
+2C-28-B7   (hex)		Hangzhou Ruiying technology co., LTD
+2C28B7     (base 16)		Hangzhou Ruiying technology co., LTD
+				No. 1, building 305, Yunqi Town Cloud Computing Industrial Park, Hangzhou City, Xihu District
+				Hangzhou  Zhejiang  310000
+				CN
+
+10-65-30   (hex)		Dell Inc.
+106530     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+04-6B-1B   (hex)		SYSDINE Co., Ltd.
+046B1B     (base 16)		SYSDINE Co., Ltd.
+				506 Convergence technology research commercialization center 218 Gajung-Ro, Yuseong-gu
+				Daejeon-City  Daejeon-City  34129
+				KR
+
+B0-A3-7E   (hex)		QING DAO HAIER TELECOM CO.,LTD.
+B0A37E     (base 16)		QING DAO HAIER TELECOM CO.,LTD.
+				No.1,Haier Road,Qingdao 266101 P.R.China
+				Qingdao  Shandong  266101
+				CN
+
+3C-EA-F9   (hex)		JUBIXCOLTD
+3CEAF9     (base 16)		JUBIXCOLTD
+				Rm 808, 809, B dong, Gunpo IT vally, 17, Gosan-ro 148beon-gil, Gunpo-si, Gyeonggi-do, Republic of Korea
+				GUNPOSI    15850
+				KR
+
+58-DB-15   (hex)		TECNO MOBILE LIMITED
+58DB15     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+50-50-CE   (hex)		Hangzhou Dianyixia Communication Technology Co. Ltd.
+5050CE     (base 16)		Hangzhou Dianyixia Communication Technology Co. Ltd.
+				Room 207, Building 7, 1197 bin 'an road, Binjiang district,
+				Hangzhou  Zhejiang  310011
+				CN
+
+FC-69-47   (hex)		Texas Instruments
+FC6947     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+E0-7D-EA   (hex)		Texas Instruments
+E07DEA     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+DC-DE-4F   (hex)		Gionee Communication Equipment Co Ltd 
+DCDE4F     (base 16)		Gionee Communication Equipment Co Ltd 
+				21/F Times Technology Building, 7028 Shennan Road
+				Shenzhen  Futian District  518040
+				CN
+
+4C-D0-CB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CD0CB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-5D-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+505DAC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-FA-F7   (hex)		Guangdong Uniteddata Holding Group Co., Ltd.
+E8FAF7     (base 16)		Guangdong Uniteddata Holding Group Co., Ltd.
+				39L, Pearl River Tower, No.15 Zhujiang West Road,Tianhe District
+				GUANGZHOU  GUANGDONG  510623
+				CN
+
+94-9D-57   (hex)		Panasonic do Brasil Limitada
+949D57     (base 16)		Panasonic do Brasil Limitada
+				Rua Matrinxa
+				Manaus  Amazonas  69075150
+				BR
+
+88-D3-7B   (hex)		FirmTek, LLC
+88D37B     (base 16)		FirmTek, LLC
+				29300 Kohoutek Way
+				Union City  CA  94587
+				US
+
+1C-66-6D   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+1C666D     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+84-F3-EB   (hex)		Espressif Inc.
+84F3EB     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+00-1B-48   (hex)		Shenzhen Lantech Electronics Co., Ltd.
+001B48     (base 16)		Shenzhen Lantech Electronics Co., Ltd.
+				306 Room, Nanshan Water Building,
+				Shenzhen  Guangdong  518052
+				CN
+
+00-25-0C   (hex)		Senet Inc
+00250C     (base 16)		Senet Inc
+				100 Market Street, Suite 302 
+				 Portsmouth  NH  03801
+				US
+
+0C-80-63   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0C8063     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-72-78   (hex)		Cisco Systems, Inc
+007278     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-5A-ED   (hex)		Apple, Inc.
+645AED     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-B6-58   (hex)		Apple, Inc.
+C0B658     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-A9-1C   (hex)		Apple, Inc.
+48A91C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+50-BC-96   (hex)		Apple, Inc.
+50BC96     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-2A-9C   (hex)		Apple, Inc.
+FC2A9C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-2C-7B   (hex)		Cisco Systems, Inc
+682C7B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-1E-98   (hex)		Ruckus Wireless
+441E98     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+A0-56-F3   (hex)		Apple, Inc.
+A056F3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-99-63   (hex)		Apple, Inc.
+549963     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-DD-5D   (hex)		Apple, Inc.
+90DD5D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-29-19   (hex)		AltoBeam (Xiamen) Technology Ltd, Co.
+DC2919     (base 16)		AltoBeam (Xiamen) Technology Ltd, Co.
+				South Building 203-38,Huoju Square ,No.56-58,Huoju Road, Huoju Park, Huoju High-tech District
+				Xiamen    361000
+				CN
+
+88-5F-E8   (hex)		IEEE Registration Authority
+885FE8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-2F-D9   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+002FD9     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+B4-CD-27   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B4CD27     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C8-19-F7   (hex)		Samsung Electronics Co.,Ltd
+C819F7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-C3-D6   (hex)		Juniper Networks
+64C3D6     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-A0-21   (hex)		General Dynamics Mission Systems
+00A021     (base 16)		General Dynamics Mission Systems
+				150 Rustcraft Road
+				Dedham  MA  02026
+				US
+
+F0-AF-50   (hex)		Phantom Intelligence
+F0AF50     (base 16)		Phantom Intelligence
+				319 Rue Franquet Suite F
+				Quebec  QC  G1P 4R4
+				CA
+
+C4-2C-4F   (hex)		Qingdao Hisense Mobile Communication Technology Co,Ltd
+C42C4F     (base 16)		Qingdao Hisense Mobile Communication Technology Co,Ltd
+				No.399, Song Ling Road
+				Qingdao  Shandong  266100
+				CN
+
+24-CA-CB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+24CACB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+54-3E-64   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+543E64     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+64-02-CB   (hex)		ARRIS Group, Inc.
+6402CB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F4-E1-1E   (hex)		Texas Instruments
+F4E11E     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+38-80-DF   (hex)		Motorola Mobility LLC, a Lenovo Company
+3880DF     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+BC-6A-2F   (hex)		Henge Docks LLC
+BC6A2F     (base 16)		Henge Docks LLC
+				455 10th St.
+				San Francisco  California  94103
+				US
+
+0C-08-B4   (hex)		HUMAX Co., Ltd.
+0C08B4     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+00-27-05   (hex)		Sectronic
+002705     (base 16)		Sectronic
+				Z.I. Les Saulniers
+				Sainte-Maure de Touraine    37800
+				FR
+
+48-BD-3D   (hex)		New H3C Technologies Co., Ltd
+48BD3D     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+18-4C-08   (hex)		Rockwell Automation
+184C08     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+DC-02-65   (hex)		Meditech Kft
+DC0265     (base 16)		Meditech Kft
+				Üllõi út 200.
+				Budapest    1191
+				HU
+
+18-0F-76   (hex)		D-Link International
+180F76     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+14-A7-2B   (hex)		currentoptronics Pvt.Ltd
+14A72B     (base 16)		currentoptronics Pvt.Ltd
+				CRT Building, Jupitor Jn , Near Time kids Koothattukulam - Piravom Rd
+				ERNAKULAM  Time Kids day care  686662
+				IN
+
+A4-DA-22   (hex)		IEEE Registration Authority
+A4DA22     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+3C-17-10   (hex)		Sagemcom Broadband SAS
+3C1710     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+DC-72-9B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC729B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-94-97   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+909497     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-02-9B   (hex)		Plexonics Technologies LImited
+34029B     (base 16)		Plexonics Technologies LImited
+				1st Floor, 181/23 Industrial Area Phase 1
+				Chandigarh  Punjab  160002
+				IN
+
+90-03-72   (hex)		Longnan Junya Digital Technology Co. Ltd. 
+900372     (base 16)		Longnan Junya Digital Technology Co. Ltd. 
+				Champion Asia Road, Xinzhen industrial Park, Longnan national economic and technological development zone, Ganzhou city, JiangXi Province , China
+				ganzhou  jiangxi  341700
+				CN
+
+84-DB-9E   (hex)		Aifloo AB
+84DB9E     (base 16)		Aifloo AB
+				Postbox 2005
+				Stockholm    10311
+				SE
+
+0C-C6-CC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0CC6CC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-58-60   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+785860     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-AB-F3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E8ABF3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-DC-BC   (hex)		Samsung Electronics Co.,Ltd
+3CDCBC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-4E-70   (hex)		Samsung Electronics Co.,Ltd
+804E70     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-E6-B7   (hex)		Samsung Electronics Co.,Ltd
+D4E6B7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+8C-4C-AD   (hex)		Evoluzn Inc.
+8C4CAD     (base 16)		Evoluzn Inc.
+				34 Samoset Lane
+				Schaumburg  IL  60193
+				US
+
+8C-F9-57   (hex)		RuiXingHengFang Network (Shenzhen) Co.,Ltd
+8CF957     (base 16)		RuiXingHengFang Network (Shenzhen) Co.,Ltd
+				Room 507, 2nd tower of KangTai biological building  NO.6 KeFa Rd. NanShan District
+				Shenzhen  Guangdong  518057
+				CN
+
+4C-77-6D   (hex)		Cisco Systems, Inc
+4C776D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-E1-82   (hex)		Texas Instruments
+74E182     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+44-9E-F9   (hex)		vivo Mobile Communication Co., Ltd.
+449EF9     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+6C-C4-D5   (hex)		HMD Global Oy
+6CC4D5     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+80-C5-48   (hex)		Shenzhen Zowee Technology Co.,Ltd
+80C548     (base 16)		Shenzhen Zowee Technology Co.,Ltd
+				NO.5 Zowee technology building, Science & Technology industrial park of privately  Science & Technology industrial park of privately owned enterprises
+				Shenzhen  GuangDong  518055
+				CN
+
+10-C2-5A   (hex)		Technicolor CH USA Inc.
+10C25A     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+E8-DE-FB   (hex)		MESOTIC SAS
+E8DEFB     (base 16)		MESOTIC SAS
+				11, Avenue de la Division Leclerc
+				Cachan    94230
+				FR
+
+C4-00-AD   (hex)		Advantech Technology (CHINA) Co., Ltd.
+C400AD     (base 16)		Advantech Technology (CHINA) Co., Ltd.
+				No.666, Han-Pu Rd. Yu-Shan
+				Kun-Shan  Jiang Su  215316
+				CN
+
+94-FE-9D   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+94FE9D     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				SONGGANG
+				SHENZHEN  GUANGDONG  518105
+				CN
+
+6C-B6-CA   (hex)		DIVUS GmbH
+6CB6CA     (base 16)		DIVUS GmbH
+				Pillhof 51
+				Eppan    39057
+				IT
+
+04-D1-3A   (hex)		Xiaomi Communications Co Ltd
+04D13A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+4C-C2-06   (hex)		Somfy
+4CC206     (base 16)		Somfy
+				50 avenue du nouveau monde
+				Cluses    74300
+				FR
+
+04-09-73   (hex)		Hewlett Packard Enterprise
+040973     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+34-99-D7   (hex)		Universal Flow Monitors, Inc.
+3499D7     (base 16)		Universal Flow Monitors, Inc.
+				1755 E. Nine Mile Rd.
+				Hazel Park  MI  48030
+				US
+
+0C-8B-D3   (hex)		ITEL MOBILE LIMITED
+0C8BD3     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+C0-A8-F0   (hex)		Adamson Systems Engineering
+C0A8F0     (base 16)		Adamson Systems Engineering
+				1401 Scugog Line 6
+				Port Perry  Ontario  L9L 1B2
+				CA
+
+9C-43-1E   (hex)		IEEE Registration Authority
+9C431E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-24-AF   (hex)		Dish Technologies Corp
+0024AF     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+28-2C-02   (hex)		IEEE Registration Authority
+282C02     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+FC-A1-83   (hex)		Amazon Technologies Inc.
+FCA183     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno    89507
+				US
+
+6C-2A-CB   (hex)		Paxton Access Ltd
+6C2ACB     (base 16)		Paxton Access Ltd
+				Paxton House
+				Brighton  East Sussex  BN1 9HU
+				GB
+
+58-3B-D9   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+583BD9     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+DC-A2-66   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+DCA266     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C4-84-66   (hex)		Apple, Inc.
+C48466     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-7C-25   (hex)		Apple, Inc.
+347C25     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-2D-B7   (hex)		Apple, Inc.
+CC2DB7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-BD-CD   (hex)		BSkyB Ltd
+A0BDCD     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+BC-91-B5   (hex)		Infinix mobility limited
+BC91B5     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+28-2F-C2   (hex)		Automotive Data Solutions
+282FC2     (base 16)		Automotive Data Solutions
+				8400 rue Bougainville
+				Montreal  Quebec  H4P2G1
+				CA
+
+98-00-74   (hex)		Raisecom Technology CO., LTD
+980074     (base 16)		Raisecom Technology CO., LTD
+				No. 11, East Area, No. 10 Block, East Xibeiwang Road
+				Beijing    100094
+				CN
+
+18-C1-9D   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+18C19D     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+0C-98-38   (hex)		Xiaomi Communications Co Ltd
+0C9838     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+74-EA-CB   (hex)		New H3C Technologies Co., Ltd
+74EACB     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+D4-1A-3F   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+D41A3F     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D8-B1-22   (hex)		Juniper Networks
+D8B122     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+B4-C7-99   (hex)		Extreme Networks, Inc.
+B4C799     (base 16)		Extreme Networks, Inc.
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+64-6E-6C   (hex)		Radio Datacom LLC
+646E6C     (base 16)		Radio Datacom LLC
+				9601 N 35th St
+				Phoenix  AZ  85028
+				US
+
+E8-8E-60   (hex)		NSD Corporation
+E88E60     (base 16)		NSD Corporation
+				Osu 3-31-28
+				Nagoya  Aichi  460-8302
+				JP
+
+00-0F-9B   (hex)		Ross Video Limited
+000F9B     (base 16)		Ross Video Limited
+				8 John Street
+				Iroquois  Ontario  K0E 1K0
+				CA
+
+00-24-BA   (hex)		Texas Instruments
+0024BA     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+60-51-2C   (hex)		TCT mobile ltd
+60512C     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+64-DB-81   (hex)		Syszone Co., Ltd.
+64DB81     (base 16)		Syszone Co., Ltd.
+				9F Garak, 310 Ogeum-ro
+				Seoul  Seoul, Korea  138-716
+				KR
+
+44-AD-19   (hex)		XINGFEI （H.K）LIMITED 
+44AD19     (base 16)		XINGFEI （H.K）LIMITED 
+				6/F North Tower Wandelai Building  No.29 Kejinan 6th Road, Nanshan District,Shenzhen,China
+				Shenzhen     518057
+				CN
+
+38-AD-BE   (hex)		New H3C Technologies Co., Ltd
+38ADBE     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+5C-AD-76   (hex)		Shenzhen TCL New Technology Co., Ltd
+5CAD76     (base 16)		Shenzhen TCL New Technology Co., Ltd
+				B area,10 Floor, TCL Multimedia Building, TCL International E city, #1001 Zhongshan Park Road, Nanshan District
+				Shenzhen  Guangdong  518052
+				CN
+
+5C-86-5C   (hex)		Samsung Electronics Co.,Ltd
+5C865C     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+04-F1-28   (hex)		HMD Global Oy
+04F128     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+04-B1-67   (hex)		Xiaomi Communications Co Ltd
+04B167     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+EC-83-50   (hex)		Microsoft Corporation
+EC8350     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+D0-07-CA   (hex)		Juniper Networks
+D007CA     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+1C-DF-52   (hex)		Texas Instruments
+1CDF52     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+30-C5-07   (hex)		ECI Telecom Ltd.
+30C507     (base 16)		ECI Telecom Ltd.
+				30 Hasivim St.
+				Petah Tikva    49133
+				IL
+
+C8-45-8F   (hex)		Wyler AG
+C8458F     (base 16)		Wyler AG
+				Im Hoelderli 13
+				Winterthur  ZH  8405
+				CH
+
+00-1B-B9   (hex)		Elitegroup Computer Systems Co.,Ltd.
+001BB9     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22, Alley 38, Lane 91 , Sec. 1 , Nei Hu Road
+				Taipei    114
+				TW
+
+00-24-61   (hex)		Shin Wang Tech.
+002461     (base 16)		Shin Wang Tech.
+				632-62, Guro-Dong, Guro-Gu
+				Seoul    152-866
+				KR
+
+0C-52-03   (hex)		AGM GROUP LIMITED
+0C5203     (base 16)		AGM GROUP LIMITED
+				4F,Building B,HuaFeng Ind park,Gushu,Xixiang,BaoAn,ShenZhen,China
+				ShenZhen  GuangDong  518100
+				CN
+
+2C-54-91   (hex)		Microsoft Corporation
+2C5491     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+38-17-C3   (hex)		Hewlett Packard Enterprise
+3817C3     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+00-1E-1D   (hex)		East Coast Datacom, Inc.
+001E1D     (base 16)		East Coast Datacom, Inc.
+				245 Gus Hipp Blvd., STE 3
+				Rockledge  FL  32955
+				US
+
+78-46-C4   (hex)		DAEHAP HYPER-TECH
+7846C4     (base 16)		DAEHAP HYPER-TECH
+				#A-805, Woolim Lions Vally 5-cha, #144-3 Sangdaewon-dong, Jungwon-Gu
+				Seongnam    462-726
+				US
+
+5C-E2-8C   (hex)		Zyxel Communications Corporation
+5CE28C     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+E4-BD-4B   (hex)		zte corporation
+E4BD4B     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-D7-CA   (hex)		7HUGS LABS
+38D7CA     (base 16)		7HUGS LABS
+				29 bd Romain Rolland 
+				Montrouge     92120
+				FR
+
+00-01-44   (hex)		Dell EMC
+000144     (base 16)		Dell EMC
+				228 South St.
+				Hopkinton  MA  01748
+				US
+
+08-00-1B   (hex)		Dell EMC
+08001B     (base 16)		Dell EMC
+				176 South Street
+				Hopkinton  MA  01748
+				US
+
+7C-01-0A   (hex)		Texas Instruments
+7C010A     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+E4-2B-34   (hex)		Apple, Inc.
+E42B34     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-2E-F9   (hex)		Apple, Inc.
+3C2EF9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-4E-A7   (hex)		Apple, Inc.
+A04EA7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-98-9D   (hex)		Apple, Inc.
+F0989D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-D6-BD   (hex)		Robert Bosch GmbH
+FCD6BD     (base 16)		Robert Bosch GmbH
+				AE-BE/EKE
+				Leonberg  BW  71206
+				DE
+
+70-1F-53   (hex)		Cisco Systems, Inc
+701F53     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-39-6E   (hex)		SUNSEA TELECOMMUNICATIONS CO.,LTD.
+18396E     (base 16)		SUNSEA TELECOMMUNICATIONS CO.,LTD.
+				High tech Industrial Park,Longhua District of Shenzhen City,South central concept
+				Shenzhen    518110
+				CN
+
+EC-7D-11   (hex)		vivo Mobile Communication Co., Ltd.
+EC7D11     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+48-0E-EC   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+480EEC     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+50-3E-AA   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+503EAA     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+58-00-BB   (hex)		Juniper Networks
+5800BB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+48-BA-4E   (hex)		Hewlett Packard
+48BA4E     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+D8-08-31   (hex)		Samsung Electronics Co.,Ltd
+D80831     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-41-C1   (hex)		Mini-Cam Limited
+9441C1     (base 16)		Mini-Cam Limited
+				Unit 4 Yew Tree Way
+				Warrington  Cheshire  WA33JD
+				GB
+
+50-4E-DC   (hex)		Ping Communication
+504EDC     (base 16)		Ping Communication
+				Brenden 18
+				Appenzell Meistersrüte  AI  9050
+				CH
+
+08-67-4E   (hex)		Hisense broadband multimedia technology Co.,Ltd
+08674E     (base 16)		Hisense broadband multimedia technology Co.,Ltd
+				Song ling Road 399
+				Qingdao    266000
+				CN
+
+50-0F-80   (hex)		Cisco Systems, Inc
+500F80     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+10-F1-F2   (hex)		LG Electronics (Mobile Communications)
+10F1F2     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+8C-68-C8   (hex)		zte corporation
+8C68C8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+EC-82-63   (hex)		zte corporation
+EC8263     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+68-3C-7D   (hex)		Magic Intelligence Technology Limited
+683C7D     (base 16)		Magic Intelligence Technology Limited
+				B13/Flat 4,East block,Jinhui Blding.Nanhai Road
+				Nanshan District, Shenzhen  guangdong  518000
+				CN
+
+0C-1C-20   (hex)		Kakao Corp
+0C1C20     (base 16)		Kakao Corp
+				242, Cheomdan-ro
+				Jeju-si  Jeju-do  63309
+				KR
+
+24-F5-A2   (hex)		Belkin International Inc.
+24F5A2     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  null  90094
+				US
+
+74-BB-D3   (hex)		Shenzhen xeme Communication Co., Ltd.
+74BBD3     (base 16)		Shenzhen xeme Communication Co., Ltd.
+				303,Block D,Huayuan  technology innovation park,Bao Yuen road,Xixiang street,Baoan District
+				Shenzhen  Guangdong  518102 
+				CN
+
+94-28-2E   (hex)		New H3C Technologies Co., Ltd
+94282E     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+98-F5-A9   (hex)		OHSUNG
+98F5A9     (base 16)		OHSUNG
+				181
+				GUMI  KYUNGBUK  730-030
+				KR
+
+D8-9E-F3   (hex)		Dell Inc.
+D89EF3     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+38-4F-49   (hex)		Juniper Networks
+384F49     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+4C-BD-8F   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+4CBD8F     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+EC-EB-B8   (hex)		Hewlett Packard Enterprise
+ECEBB8     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+6C-B7-49   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6CB749     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+98-9C-57   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+989C57     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-52-82   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+185282     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+8C-3C-4A   (hex)		NAKAYO Inc
+8C3C4A     (base 16)		NAKAYO Inc
+				Development Support Center 165 Higashiomuro-machi
+				Maebashi-shi  Gunma  379-2105
+				JP
+
+70-86-C1   (hex)		Texas Instruments
+7086C1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F4-D7-B2   (hex)		LGS Innovations, LLC
+F4D7B2     (base 16)		LGS Innovations, LLC
+				13665 Dulles Technology Drive
+				Herndon  VA  20171
+				US
+
+00-15-2A   (hex)		Nokia Corporation
+00152A     (base 16)		Nokia Corporation
+				Rensingstraße 15
+				Bochum  NRW  44807
+				DE
+
+9C-4A-7B   (hex)		Nokia Corporation
+9C4A7B     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+D8-61-62   (hex)		Wistron Neweb Corporation
+D86162     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+28-84-0E   (hex)		silicon valley immigration service 
+28840E     (base 16)		silicon valley immigration service 
+				1410 Sharp Ave,
+				Campbell  CA  95008
+				US
+
+80-61-5F   (hex)		Beijing Sinead Technology Co., Ltd. 
+80615F     (base 16)		Beijing Sinead Technology Co., Ltd. 
+				Room 504,Block A, New material Building, Yongfeng industrial, Haiding District, Beijing.China
+				Beijing  Beijing  100000
+				CN
+
+2C-D2-E7   (hex)		Nokia Corporation
+2CD2E7     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+38-6E-A2   (hex)		vivo Mobile Communication Co., Ltd.
+386EA2     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+98-2D-68   (hex)		Samsung Electronics Co., Ltd
+982D68     (base 16)		Samsung Electronics Co., Ltd
+				Samsung 1-ro
+				Hwaseong-si  Gyeonggi-do  445330
+				KR
+
+BC-2E-48   (hex)		ARRIS Group, Inc.
+BC2E48     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+60-8C-E6   (hex)		ARRIS Group, Inc.
+608CE6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+08-00-70   (hex)		Mitsubishi Precision Co.,LTd.
+080070     (base 16)		Mitsubishi Precision Co.,LTd.
+				325 KAMIMACHIYA
+				000    00
+				JP
+
+44-4A-B0   (hex)		Zhejiang Moorgen Intelligence Technology Co., Ltd
+444AB0     (base 16)		Zhejiang Moorgen Intelligence Technology Co., Ltd
+				No.181 Changluo road Luotuo street Zhenhai district
+				Ningbo  Zhejiang  315202
+				CN
+
+DC-6A-EA   (hex)		Infinix mobility limited
+DC6AEA     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+C4-21-C8   (hex)		KYOCERA CORPORATION 
+C421C8     (base 16)		KYOCERA CORPORATION 
+				2-1-1,Kagahara,
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+80-73-9F   (hex)		KYOCERA CORPORATION 
+80739F     (base 16)		KYOCERA CORPORATION 
+				2-1-1 Kagahara
+				Yokohama-shi  Kanagawa  224-8502
+				JP
+
+48-EC-5B   (hex)		Nokia
+48EC5B     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+70-58-12   (hex)		Panasonic Corporation AVC Networks Company
+705812     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma  Osaka  571-8504
+				JP
+
+04-20-9A   (hex)		Panasonic Corporation AVC Networks Company
+04209A     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma City  Osaka  571-8504
+				JP
+
+34-00-8A   (hex)		IEEE Registration Authority
+34008A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-11-15   (hex)		Robert Bosch Engineering and Business Solutions pvt. Ltd.
+A41115     (base 16)		Robert Bosch Engineering and Business Solutions pvt. Ltd.
+				123, Industrial Layout, Hosur Road, Koramangala,
+				Bangalore  Karnataka  560095
+				IN
+
+40-D6-3C   (hex)		Equitech Industrial(DongGuan)Co.,Ltd
+40D63C     (base 16)		Equitech Industrial(DongGuan)Co.,Ltd
+				4F Building B No.2 ShiChang Road SongYuan Technology Park,DongCheng District
+				DongGuan  GuangDong  523122
+				CN
+
+F4-F3-AA   (hex)		JBL GmbH & Co. KG
+F4F3AA     (base 16)		JBL GmbH & Co. KG
+				Dieselstrasse 3
+				Neuhofen    67141
+				DE
+
+90-50-CA   (hex)		Hitron Technologies. Inc
+9050CA     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+40-99-22   (hex)		AzureWave Technology Inc.
+409922     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+C0-6D-1A   (hex)		Tianjin Henxinhuifeng Technology Co.,Ltd.
+C06D1A     (base 16)		Tianjin Henxinhuifeng Technology Co.,Ltd.
+				Rm 233, Tianjin Technology Innovation Service Center, 12 Keyan West Road, Nankai District, Tianjin, P.R.C.
+				Tianjin  Tianjin  300192
+				CN
+
+10-7B-44   (hex)		ASUSTek COMPUTER INC.
+107B44     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+84-25-3F   (hex)		silex technology, Inc.
+84253F     (base 16)		silex technology, Inc.
+				2-3-1 Hikaridai
+				Seika-cho  Kyoto  619-0237
+				JP
+
+00-08-C9   (hex)		TechniSat Digital GmbH Daun
+0008C9     (base 16)		TechniSat Digital GmbH Daun
+				Gewerbepark Merbitz Nr. 5
+				Dresden    01156
+				US
+
+D8-B1-2A   (hex)		Panasonic Mobile Communications Co.,Ltd.
+D8B12A     (base 16)		Panasonic Mobile Communications Co.,Ltd.
+				600 Saedo-cho Tsuzuki-ku
+				Yokohama City  Kanagawa  224-8539
+				JP
+
+B0-19-C6   (hex)		Apple, Inc.
+B019C6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-66-F0   (hex)		Apple, Inc.
+3866F0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-80-09   (hex)		JUPITER SYSTEMS, INC.
+008009     (base 16)		JUPITER SYSTEMS, INC.
+				3073 TEAGARDEN STREET
+				SAN LEANDRO  CA  94577-5720
+				US
+
+00-C0-64   (hex)		General Datacomm LLC
+00C064     (base 16)		General Datacomm LLC
+				353 Christian Street, Suite 4
+				Oxford  CT  06478
+				US
+
+E8-68-19   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E86819     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-AB-34   (hex)		New H3C Technologies Co., Ltd
+1CAB34     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+3C-78-43   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C7843     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-09-79   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C0979     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-FB-5D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E4FB5D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-01-CC   (hex)		Japan Total Design Communication Co., Ltd.
+0001CC     (base 16)		Japan Total Design Communication Co., Ltd.
+				Enesta Suginamihigashi Build., 3F,
+				    
+				JP
+
+00-30-C8   (hex)		GAD LINE, LTD.
+0030C8     (base 16)		GAD LINE, LTD.
+				BEIT ROKAR HAR HOTZVIM
+				    
+				IL
+
+00-16-E0   (hex)		3Com Ltd
+0016E0     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+D8-DE-CE   (hex)		ISUNG CO.,LTD
+D8DECE     (base 16)		ISUNG CO.,LTD
+				92, Huimanggongwon-ro
+				Siheung-si  Kyunggido  429-859
+				KR
+
+70-3E-AC   (hex)		Apple, Inc.
+703EAC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-11-C0   (hex)		Aday Technology Inc
+0011C0     (base 16)		Aday Technology Inc
+				9F.-3, No. 247, Sec. 1, Taichung Port Rd.,
+				Taichung City    403
+				TW
+
+00-05-F1   (hex)		Vrcom, Inc.
+0005F1     (base 16)		Vrcom, Inc.
+				401, Songam Bldg, 479-1,
+				Seoul    
+				KR
+
+AC-51-2C   (hex)		Infinix mobility limited
+AC512C     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+30-99-35   (hex)		zte corporation
+309935     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+0C-72-D9   (hex)		zte corporation
+0C72D9     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-62-D0   (hex)		Technicolor CH USA Inc.
+1062D0     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+50-64-2B   (hex)		XIAOMI Electronics,CO.,LTD
+50642B     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+28-40-1A   (hex)		C8 MediSensors, Inc.
+28401A     (base 16)		C8 MediSensors, Inc.
+				727 University Ave
+				Los Gatos  CA  95032
+				US
+
+30-C0-1B   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+30C01B     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+88-86-C2   (hex)		STABILO International GmbH
+8886C2     (base 16)		STABILO International GmbH
+				Schwanweg 1
+				Heroldsberg    90562
+				DE
+
+08-A8-A1   (hex)		Cyclotronics Power Concepts, Inc
+08A8A1     (base 16)		Cyclotronics Power Concepts, Inc
+				PO Box 37449
+				Houston  TX  77237-7449
+				US
+
+F4-B5-20   (hex)		Biostar Microtech international corp.
+F4B520     (base 16)		Biostar Microtech international corp.
+				3F. No. 108-2 Min Chuan Road, Hsin Tien District 
+				New Taipei City  Taiwan  231
+				TW
+
+CC-2F-71   (hex)		Intel Corporate
+CC2F71     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1C-C5   (hex)		3Com Ltd
+001CC5     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+88-7A-31   (hex)		Velankani Electronics Pvt. Ltd.
+887A31     (base 16)		Velankani Electronics Pvt. Ltd.
+				43, Electronics City, Phase 1, Hosur road
+				Bangalore  Karnataka  560100
+				IN
+
+8C-0F-6F   (hex)		PEGATRON CORPORATION
+8C0F6F     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+8C-25-05   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C2505     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+8C-3B-AD   (hex)		NETGEAR
+8C3BAD     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+64-CF-D9   (hex)		Texas Instruments
+64CFD9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+74-7D-24   (hex)		Phicomm (Shanghai) Co., Ltd.
+747D24     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+D0-94-66   (hex)		Dell Inc.
+D09466     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+38-E5-95   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+38E595     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				B116,B118,A211-A213,B201-B213,A311-A313,B411-413,BF08-09 Nanshan Medical Instrument Industry Park,
+				Shenzhen  Guangdong  518067
+				CN
+
+BC-96-80   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+BC9680     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				B116,B118,A211-A213,B201-B213,A311-A313,B411-413,BF08-09 Nanshan Medical Instrument Industry Park,
+				Shenzhen  Guangdong  518067
+				CN
+
+A4-7B-9D   (hex)		Espressif Inc.
+A47B9D     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+B8-F8-BE   (hex)		BLUECOM
+B8F8BE     (base 16)		BLUECOM
+				116, Venture-ro, Yeonsu-gu,
+				Incheon    406-840
+				KR
+
+00-24-82   (hex)		Ruckus Wireless
+002482     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+68-92-34   (hex)		Ruckus Wireless
+689234     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+50-A7-33   (hex)		Ruckus Wireless
+50A733     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+2C-5D-93   (hex)		Ruckus Wireless
+2C5D93     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+38-FF-36   (hex)		Ruckus Wireless
+38FF36     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+84-18-3A   (hex)		Ruckus Wireless
+84183A     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+24-C9-A1   (hex)		Ruckus Wireless
+24C9A1     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+7C-2E-DD   (hex)		Samsung Electronics Co.,Ltd
+7C2EDD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-F7-A4   (hex)		Samsung Electronics Co.,Ltd
+3CF7A4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-30-34   (hex)		Cara Systems
+103034     (base 16)		Cara Systems
+				Ruzgarlibahce Mah. Kavak Sok. No: 31/1 Smart Plaza B Blok Kat: 4
+				Istanbul  Kavacik Beykoz  23805
+				TR
+
+00-00-FE   (hex)		Annapolis Micro Systems, Inc.
+0000FE     (base 16)		Annapolis Micro Systems, Inc.
+				190 ADMIRAL COCHRANE DRIVE
+				ANNAPOLIS  MD  21401
+				US
+
+00-D0-1F   (hex)		Senetas Corporation Ltd
+00D01F     (base 16)		Senetas Corporation Ltd
+				1/11 Queens Road
+				consolidation    consolidation
+				AU
+
+E0-CB-BC   (hex)		Cisco Meraki
+E0CBBC     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+64-47-E0   (hex)		Feitian Technologies Co., Ltd
+6447E0     (base 16)		Feitian Technologies Co., Ltd
+				Floor 17, Tower B, Huizhi Mansion, No.9 Xueqing Rd, Haidian District
+				Beijing    100085
+				CN
+
+B4-4F-96   (hex)		Zhejiang Xinzailing Technology co., ltd
+B44F96     (base 16)		Zhejiang Xinzailing Technology co., ltd
+				No.1805, Dongliu Road, Binjiang District 
+				Hangzhou  Zhejiang  310051
+				CN
+
+4C-65-A8   (hex)		IEEE Registration Authority
+4C65A8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B0-DF-C1   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+B0DFC1     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+9C-6F-52   (hex)		zte corporation
+9C6F52     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E8-6D-65   (hex)		AUDIO MOBIL Elektronik GmbH
+E86D65     (base 16)		AUDIO MOBIL Elektronik GmbH
+				Audio-Mobil-Straße 5 - 7
+				Braunau am Inn - Ranshofen    5282
+				AT
+
+70-6E-6D   (hex)		Cisco Systems, Inc
+706E6D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-47-62   (hex)		Beijing Sensoro Technology Co.,Ltd.
+604762     (base 16)		Beijing Sensoro Technology Co.,Ltd.
+				Room 2807, Building 1B, Wangjing SOHO, No10 Wangjing Street, Chaoyang District, Beijing, China
+				Beijing  Beijing  100102 PRC
+				CN
+
+BC-1C-81   (hex)		Sichuan iLink Technology Co., Ltd.
+BC1C81     (base 16)		Sichuan iLink Technology Co., Ltd.
+				Anzhou,Industrial park,Mianyang,Sichuan
+				Mianyang    622651
+				CN
+
+90-0A-1A   (hex)		Taicang T&W Electronics
+900A1A     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+50-6E-92   (hex)		Innocent Technology Co., Ltd.
+506E92     (base 16)		Innocent Technology Co., Ltd.
+				PROSIT AZUMA 3 #201, 1973, NIPPA-CHO, KOHOKU-KU, 
+				YOKOHAMA-SHI  KANAGAWA  2230057
+				JP
+
+30-FE-31   (hex)		Nokia
+30FE31     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+98-F2-B3   (hex)		Hewlett Packard Enterprise
+98F2B3     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+C4-57-1F   (hex)		June Life Inc
+C4571F     (base 16)		June Life Inc
+				649 Front Street
+				San Francisco  CA  94111
+				US
+
+88-6A-E3   (hex)		Alpha Networks Inc.
+886AE3     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing 7th Rd., Science-based Industrial Park, Hsinchu, Taiwan, R.O.C
+				Hsinchu  Taiwan  300
+				TW
+
+1C-4D-70   (hex)		Intel Corporate
+1C4D70     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+D8-22-F4   (hex)		Avnet Silica
+D822F4     (base 16)		Avnet Silica
+				16 av carnot
+				Massy    91349
+				FR
+
+34-8F-27   (hex)		Ruckus Wireless
+348F27     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+2C-9E-EC   (hex)		Jabil Circuit Penang
+2C9EEC     (base 16)		Jabil Circuit Penang
+				Plot 56 , Hilir Sungai Keluang 1, Bayan Lepas Industrial Park, Phase 4
+				George Town  Penang  11900
+				MY
+
+00-1C-FA   (hex)		Alarm.com
+001CFA     (base 16)		Alarm.com
+				8150 Leesburg Pike
+				Vienna  VA  22182
+				US
+
+60-31-3B   (hex)		Sunnovo International Limited
+60313B     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+6C-B2-27   (hex)		Sony Video & Sound Products Inc.
+6CB227     (base 16)		Sony Video & Sound Products Inc.
+				Sony City Osaki, 2-10-1 Osaki
+				Shinagawa-ku  Tokyo  141-8610
+				JP
+
+98-6F-60   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+986F60     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+00-0C-AB   (hex)		Commend International GmbH
+000CAB     (base 16)		Commend International GmbH
+				Hoelzlstrasse 561
+				Wals  Salzburg  A-5071
+				AT
+
+74-54-27   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+745427     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+60-72-0B   (hex)		BLU Products Inc
+60720B     (base 16)		BLU Products Inc
+				10814 NW 33rd Street
+				Miami  FL  33172
+				US
+
+30-89-76   (hex)		DALIAN LAMBA TECHNOLOGY CO.,LTD
+308976     (base 16)		DALIAN LAMBA TECHNOLOGY CO.,LTD
+				Dalian Hi-tech Zone Keypark Room 1201
+				Dalian  Liaoning  116000
+				CN
+
+2C-26-17   (hex)		Oculus VR, LLC
+2C2617     (base 16)		Oculus VR, LLC
+				1 Hacker Way
+				Menlo Park  CA  94025
+				US
+
+34-D9-54   (hex)		WiBotic Inc.
+34D954     (base 16)		WiBotic Inc.
+				4000 15th Ave NE Lab 225, Fluke Hall, Box 352141
+				Seattle  WA  98195
+				US
+
+48-57-DD   (hex)		Facebook Inc
+4857DD     (base 16)		Facebook Inc
+				1 Hacker Way
+				Menlo Park    94025
+				US
+
+48-7D-2E   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+487D2E     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-DA-F9   (hex)		ARRIS Group, Inc.
+B0DAF9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+18-35-D1   (hex)		ARRIS Group, Inc.
+1835D1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C0-A5-DD   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+C0A5DD     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+48-8D-36   (hex)		Arcadyan Corporation
+488D36     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+BC-D7-13   (hex)		Owl Labs
+BCD713     (base 16)		Owl Labs
+				33-1/2 Union Square
+				Somerville  MA  02143
+				US
+
+E8-E1-E1   (hex)		Gemtek Technology Co., Ltd.
+E8E1E1     (base 16)		Gemtek Technology Co., Ltd.
+				No.15-1 Zhonghua Road
+				Hukou  Hsinchu  30352
+				TW
+
+28-07-0D   (hex)		GUANGZHOU WINSOUND INFORMATION TECHNOLOGY CO.,LTD.
+28070D     (base 16)		GUANGZHOU WINSOUND INFORMATION TECHNOLOGY CO.,LTD.
+				Building1 NO.13 DABU ROAD HUADU DISTRICT
+				GUANGZHOU  GUANGDONG  510800
+				CN
+
+00-A3-D1   (hex)		Cisco Systems, Inc
+00A3D1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+FC-4D-8C   (hex)		SHENZHEN PANTE ELECTRONICS TECHNOLOGY CO., LTD
+FC4D8C     (base 16)		SHENZHEN PANTE ELECTRONICS TECHNOLOGY CO., LTD
+				Building 5,Hui Mingsheng industrial park,Tongfu Rd,Fu Yong street
+				Shenzhen  Guangdong  518042
+				CN
+
+FC-06-ED   (hex)		M2Motive Technology Inc.
+FC06ED     (base 16)		M2Motive Technology Inc.
+				Room 148, Lane 999, new two road, Baoshan District
+				Shanghai  Shanghai  200439
+				CN
+
+F0-D4-F6   (hex)		Lars Thrane A/S
+F0D4F6     (base 16)		Lars Thrane A/S
+				Stubbeled 2
+				Vedbæk    2950
+				DK
+
+F4-A9-97   (hex)		CANON INC.
+F4A997     (base 16)		CANON INC.
+				30-2 Shimomaruko 3-chome,
+				Ohta-ku  Tokyo  146-8501
+				JP
+
+64-DF-E9   (hex)		ATEME
+64DFE9     (base 16)		ATEME
+				6 rue Dewoitine
+				Vélizy-Villacoublay    78140
+				FR
+
+10-C6-FC   (hex)		Garmin International
+10C6FC     (base 16)		Garmin International
+				1200 East 151st Street
+				Olathe   KS  66062
+				US
+
+AC-22-05   (hex)		Compal Broadband Networks, Inc.
+AC2205     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+80-A0-36   (hex)		Shanghai MXCHIP Information Technology Co., Ltd.
+80A036     (base 16)		Shanghai MXCHIP Information Technology Co., Ltd.
+				9th Floor, No. 5 Building, 2145 Jinshajiang Rd., Putuo District
+				Shanghai    200333
+				CN
+
+F0-74-85   (hex)		NGD Systems, Inc.
+F07485     (base 16)		NGD Systems, Inc.
+				355 Goddard, Suite 200
+				Irvine  CA  92618
+				US
+
+40-5C-FD   (hex)		Dell Inc.
+405CFD     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+20-F4-52   (hex)		Shanghai IUV Software Development Co. Ltd
+20F452     (base 16)		Shanghai IUV Software Development Co. Ltd
+				No.18, Lane 1387 Zhangdong Rd, Pudong, Shanghai, P.R.C
+				shanghai  shanghai  201203
+				CN
+
+50-9A-4C   (hex)		Dell Inc.
+509A4C     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+A0-09-4C   (hex)		CenturyLink
+A0094C     (base 16)		CenturyLink
+				100 CenturyLink Drive
+				Monroe    71203
+				US
+
+B4-39-34   (hex)		Pen Generations, Inc.
+B43934     (base 16)		Pen Generations, Inc.
+				8th FL., SOLiD Space,
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+74-26-AC   (hex)		Cisco Systems, Inc
+7426AC     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-26-28   (hex)		Broadcom Limited
+B02628     (base 16)		Broadcom Limited
+				5300 California Ave.
+				irvine  CA  92617
+				US
+
+98-74-DA   (hex)		Infinix mobility limited
+9874DA     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+40-B4-F0   (hex)		Juniper Networks
+40B4F0     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+14-3F-27   (hex)		Noccela Oy
+143F27     (base 16)		Noccela Oy
+				Kaarinantie 700
+				Turku    20540
+				FI
+
+10-58-87   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+105887     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+70-4C-A5   (hex)		Fortinet, Inc.
+704CA5     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale  null  94086
+				US
+
+9C-06-1B   (hex)		Hangzhou H3C Technologies Co., Limited
+9C061B     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+50-33-8B   (hex)		Texas Instruments
+50338B     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+68-26-2A   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+68262A     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+E8-DE-8E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+E8DE8E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+D8-D8-66   (hex)		SHENZHEN TOZED TECHNOLOGIES CO.,LTD.
+D8D866     (base 16)		SHENZHEN TOZED TECHNOLOGIES CO.,LTD.
+				 4F/A1,A2,TIANJI BUILDING,TIAN’AN CYBER PARK,FUTIAN
+				SHENZHEN  GUANGDONG  518040
+				CN
+
+D8-C0-6A   (hex)		Hunantv.com Interactive Entertainment Media Co.,Ltd.
+D8C06A     (base 16)		Hunantv.com Interactive Entertainment Media Co.,Ltd.
+				Floor 2U, Hunan International Exhibition Center, Kaifu District, Changsha City, Hunan Province, P.R.C.
+				Changsha  Hunan  410000
+				CN
+
+AC-20-2E   (hex)		Hitron Technologies. Inc
+AC202E     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+9C-32-A9   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+9C32A9     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+1C-5A-0B   (hex)		Tegile Systems
+1C5A0B     (base 16)		Tegile Systems
+				7999 Gateway Blvd Suite 120
+				Newark  CA  94560
+				US
+
+04-6E-02   (hex)		OpenRTLS Group
+046E02     (base 16)		OpenRTLS Group
+				De Nieuwe Ploeg 5
+				Berlicum    5258 EX
+				NL
+
+90-0E-83   (hex)		Monico Monitoring, Inc.
+900E83     (base 16)		Monico Monitoring, Inc.
+				18530 Klein Church Rd
+				Spring  TX  77379
+				US
+
+60-14-66   (hex)		zte corporation
+601466     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+68-54-ED   (hex)		Alcatel-Lucent
+6854ED     (base 16)		Alcatel-Lucent
+				777 E. Middlefield Rd
+				Mountain View  CA  94043
+				US
+
+68-02-35   (hex)		Konten Networks Inc.
+680235     (base 16)		Konten Networks Inc.
+				7F-1, No.108, Minquan Rd., Xindian Dist.,
+				New Taipei City  Taiwan  231
+				TW
+
+38-AC-3D   (hex)		Nephos Inc
+38AC3D     (base 16)		Nephos Inc
+				2840 Junction Ave.  ,
+				San Jose  CA  95134
+				US
+
+E0-37-BF   (hex)		Wistron Neweb Corporation
+E037BF     (base 16)		Wistron Neweb Corporation
+				No.20,Park Avenue II,Hsinchu Science Park
+				Hsin-Chu  R.O.C.  308
+				TW
+
+E8-13-67   (hex)		AIRSOUND Inc.
+E81367     (base 16)		AIRSOUND Inc.
+				515-ho,75,Techno-1ro,Yuseoung-gu
+				Daejeon    34014
+				KR
+
+00-11-92   (hex)		Cisco Systems, Inc
+001192     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-F1-35   (hex)		SensorTec-Canada
+38F135     (base 16)		SensorTec-Canada
+				1Yonge Street, Suite 1801
+				Toronto  ON  M5E 1W7
+				CA
+
+AC-74-09   (hex)		Hangzhou H3C Technologies Co., Limited
+AC7409     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+C4-9D-ED   (hex)		Microsoft Corporation
+C49DED     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+98-A4-0E   (hex)		Snap, Inc.
+98A40E     (base 16)		Snap, Inc.
+				64 Market Street
+				Venice  CA  90291
+				US
+
+F4-03-43   (hex)		Hewlett Packard Enterprise
+F40343     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F0-93-C5   (hex)		Garland Technology
+F093C5     (base 16)		Garland Technology
+				2130 Oak Bend Lane
+				Garland  TX  75040
+				US
+
+98-10-E8   (hex)		Apple, Inc.
+9810E8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-D0-12   (hex)		Apple, Inc.
+C0D012     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-A9-20   (hex)		Apple, Inc.
+BCA920     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-A1-95   (hex)		Apple, Inc.
+48A195     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-03-77   (hex)		Apple, Inc.
+F80377     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-96-34   (hex)		Intel Corporate
+F49634     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-7D-1A   (hex)		Dell Inc.
+107D1A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+70-AF-24   (hex)		TP Vision Belgium NV
+70AF24     (base 16)		TP Vision Belgium NV
+				Technologiepark Zwijnaarde 19
+				Gent    9052
+				BE
+
+A4-11-63   (hex)		IEEE Registration Authority
+A41163     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C4-D1-97   (hex)		Ventia Utility Services
+C4D197     (base 16)		Ventia Utility Services
+				Level 4, Tower 1, 495 Victoria Avenue
+				Chatswood  NSW  2067
+				AU
+
+2C-86-D2   (hex)		Cisco Systems, Inc
+2C86D2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-E9-7C   (hex)		ITEL MOBILE LIMITED
+7CE97C     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+80-58-F8   (hex)		Motorola Mobility LLC, a Lenovo Company
+8058F8     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+DC-A4-CA   (hex)		Apple, Inc.
+DCA4CA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-8F-E9   (hex)		Apple, Inc.
+8C8FE9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-AF-25   (hex)		Nishiyama Industry Co.,LTD.
+70AF25     (base 16)		Nishiyama Industry Co.,LTD.
+				177-2
+				Fuji  Shizuoka  419-0205
+				JP
+
+E8-D1-1B   (hex)		ASKEY COMPUTER CORP
+E8D11B     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+B8-22-4F   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+B8224F     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+98-00-C1   (hex)		GuangZhou CREATOR Technology Co.,Ltd.(CHINA)
+9800C1     (base 16)		GuangZhou CREATOR Technology Co.,Ltd.(CHINA)
+				Level 3,Blg 6,No 9 Keji Yuan,LanYusi St,
+				GuangZhou  GuangDong  510730
+				CN
+
+54-E1-AD   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+54E1AD     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+98-D3-D2   (hex)		MEKRA Lang GmbH & Co. KG
+98D3D2     (base 16)		MEKRA Lang GmbH & Co. KG
+				Buchheimerstr. 4
+				Ergersheim    91465
+				DE
+
+0C-5F-35   (hex)		Niagara Video Corporation
+0C5F35     (base 16)		Niagara Video Corporation
+				5627 Stoneridge Drive, Suite 316
+				Pleasanton  CA  94588
+				US
+
+F8-A3-4F   (hex)		zte corporation
+F8A34F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-19-12   (hex)		Welcat Inc
+001912     (base 16)		Welcat Inc
+				East Tower 6F, Shinagawa Seaside, 4-12-8, Higashi Shinagawa, Shinagawa Section
+				  Tokyo  140-0002
+				JP
+
+8C-78-D7   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+8C78D7     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+B8-EA-AA   (hex)		ICG NETWORKS CO.,ltd
+B8EAAA     (base 16)		ICG NETWORKS CO.,ltd
+				Room 2030，Block B，Yamei Park，Haidian District
+				BEIJING    100010
+				CN
+
+B8-F8-83   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B8F883     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+DC-FE-18   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+DCFE18     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+70-4F-57   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+704F57     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-C4-6C   (hex)		Senseit
+B0C46C     (base 16)		Senseit
+				Suschevsky val 16 str. 4
+				Moscow  Russian Federation  127018
+				RU
+
+00-02-A1   (hex)		World Wide Packets
+0002A1     (base 16)		World Wide Packets
+				PO Box 14645
+				Spokane  WA  99214
+				US
+
+00-E0-22   (hex)		Analog Devices, Inc.
+00E022     (base 16)		Analog Devices, Inc.
+				Three Technology Way
+				Norwood   MA  02062-2666
+				US
+
+14-B7-F8   (hex)		Technicolor CH USA Inc.
+14B7F8     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+90-3D-6B   (hex)		Zicon Technology Corp.
+903D6B     (base 16)		Zicon Technology Corp.
+				15F., No.688-2, Zhongzheng Rd., Zhonghe City, Taipei County 235
+				Taipei    23586
+				TW
+
+B0-40-89   (hex)		Senient Systems LTD
+B04089     (base 16)		Senient Systems LTD
+				152 Morrison St
+				Edinburgh  Other (Non US)  EH3 8EB
+				GB
+
+54-25-EA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5425EA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-7F-6F   (hex)		Telechips, Inc.
+3C7F6F     (base 16)		Telechips, Inc.
+				19F~23F,Luther Bldg.42, Olympic-ro 35da-gil, Songpa-gu,
+				Seoul  Seoul  05510
+				KR
+
+5C-BA-37   (hex)		Microsoft Corporation
+5CBA37     (base 16)		Microsoft Corporation
+				31807 - 25th Ave SW
+				Federal Way    98023
+				US
+
+00-C0-C6   (hex)		PERSONAL MEDIA CORP.
+00C0C6     (base 16)		PERSONAL MEDIA CORP.
+				1-7-7 MY BLDG. HIRATSUKA
+				    
+				JP
+
+28-FE-CD   (hex)		Lemobile Information Technology (Beijing) Co., Ltd.
+28FECD     (base 16)		Lemobile Information Technology (Beijing) Co., Ltd.
+				5/F LeEco Building, 105 Yaojiayuan Road, Chaoyang District 
+				Beijing  Beijing  100025
+				CN
+
+C8-94-BB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C894BB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+10-B1-F8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+10B1F8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-9E-08   (hex)		Google, Inc.
+089E08     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+00-21-0D   (hex)		SAMSIN INNOTEC
+00210D     (base 16)		SAMSIN INNOTEC
+				SARIYUNDONG ILSANDONG-GU
+				GOYANG  KYUNGGI  411530
+				KR
+
+C8-73-24   (hex)		 Sow Cheng Technology Co. Ltd.
+C87324     (base 16)		 Sow Cheng Technology Co. Ltd.
+				No.26, Ln. 181, Xinsheng W. Rd., Dali Dist
+				Taichung    412
+				TW
+
+00-1F-16   (hex)		Wistron Corporation
+001F16     (base 16)		Wistron Corporation
+				21F, 88, Sec.1, Hsin Tai Wu Rd., Hsichih,
+				Taipei Hsien    221
+				TW
+
+00-26-2D   (hex)		Wistron Corporation
+00262D     (base 16)		Wistron Corporation
+				21F, 88, Sec.1, Hsin Tai Wu Rd., Hsichih,
+				Taipei Hsien    221
+				TW
+
+04-95-E6   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+0495E6     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+50-E6-66   (hex)		Shenzhen Techtion Electronics Co., Ltd.
+50E666     (base 16)		Shenzhen Techtion Electronics Co., Ltd.
+				Floor 2, C2 Building, Huafeng Industrial Park, Hangcheng Avenue, Gushu, Xixiang, Baoan
+				Shenzhen  Guangdong  518102
+				CN
+
+00-16-D3   (hex)		Wistron Corporation
+0016D3     (base 16)		Wistron Corporation
+				21F, 88, Sec.1, Hsin Tai Wu Rd., Hsichih,
+				Taipei Hsien    221
+				TW
+
+4C-4E-03   (hex)		TCT mobile ltd
+4C4E03     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+90-86-74   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+908674     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+90-17-11   (hex)		Hagenuk Marinekommunikation GmbH
+901711     (base 16)		Hagenuk Marinekommunikation GmbH
+				Hamburger Chaussee 25
+				Flintbek    24220
+				DE
+
+00-10-DE   (hex)		INTERNATIONAL DATACASTING CORPORATION
+0010DE     (base 16)		INTERNATIONAL DATACASTING CORPORATION
+				2680 QUEENSVIEW DRIVE
+				OTTAWA,  ONTARIO  K2B 8H6
+				CA
+
+C0-D9-F7   (hex)		ShanDong Domor Intelligent S&T CO.,Ltd
+C0D9F7     (base 16)		ShanDong Domor Intelligent S&T CO.,Ltd
+				Jining high-tech zone base of production,education & research
+				Jining  Shandong  272000
+				CN
+
+00-60-8B   (hex)		ConferTech International
+00608B     (base 16)		ConferTech International
+				12110 N. PECOS STREET
+				WESTMINSTER  CO  80234-2074
+				US
+
+70-2D-84   (hex)		i4C Innovations
+702D84     (base 16)		i4C Innovations
+				3800 Concorde Parkway, Suite 400
+				Chantilly  VA  20151
+				US
+
+2C-20-0B   (hex)		Apple, Inc.
+2C200B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-66-A5   (hex)		Apple, Inc.
+8866A5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-02-77   (hex)		Cash Systemes Industrie
+000277     (base 16)		Cash Systemes Industrie
+				Technoparc Epsilon
+				    
+				FR
+
+CC-A2-19   (hex)		SHENZHEN ALONG INVESTMENT CO.,LTD
+CCA219     (base 16)		SHENZHEN ALONG INVESTMENT CO.,LTD
+				Room 1301,13F,Zhenye international Business Center,No.3101-90,Qianhai Road,Nanshan District
+				Shenzhen  Guangdong Province  518052
+				CN
+
+4C-1A-3A   (hex)		PRIMA Research And Production Enterprise Ltd.
+4C1A3A     (base 16)		PRIMA Research And Production Enterprise Ltd.
+				63, Svobody st.
+				  Nizhny Novgorod   603003
+				RU
+
+14-B3-1F   (hex)		Dell Inc.
+14B31F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+AC-C1-EE   (hex)		Xiaomi Communications Co Ltd
+ACC1EE     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+54-19-C8   (hex)		vivo Mobile Communication Co., Ltd.
+5419C8     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+B0-B9-8A   (hex)		NETGEAR
+B0B98A     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+80-5A-04   (hex)		LG Electronics (Mobile Communications)
+805A04     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+8C-A5-A1   (hex)		Oregano Systems - Design & Consulting GmbH
+8CA5A1     (base 16)		Oregano Systems - Design & Consulting GmbH
+				Franzosengraben 8
+				Vienna    1030
+				AT
+
+B8-EC-A3   (hex)		Zyxel Communications Corporation
+B8ECA3     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+BC-83-85   (hex)		Microsoft Corporation
+BC8385     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+00-14-38   (hex)		Hewlett Packard Enterprise
+001438     (base 16)		Hewlett Packard Enterprise
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+E4-B0-05   (hex)		Beijing IQIYI Science & Technology Co., Ltd.
+E4B005     (base 16)		Beijing IQIYI Science & Technology Co., Ltd.
+				Room 1101, Floor 11, Capital Development Tower, No.2 Haidian North 1st Street,Haidian District,
+				Beijing    100080
+				CN
+
+00-00-48   (hex)		Seiko Epson Corporation
+000048     (base 16)		Seiko Epson Corporation
+				80 HIROOKA SHIOJIRI-CITY
+				japan  JAPAN  399-07
+				JP
+
+B0-E8-92   (hex)		Seiko Epson Corporation
+B0E892     (base 16)		Seiko Epson Corporation
+				3-3-5 OWA
+				SUWA-SHI  NAGANO-KEN  392-8502
+				JP
+
+AC-18-26   (hex)		Seiko Epson Corporation
+AC1826     (base 16)		Seiko Epson Corporation
+				3-3-5 OWA
+				SUWA-SHI  NAGANO-KEN  392-8502
+				JP
+
+A4-EE-57   (hex)		Seiko Epson Corporation
+A4EE57     (base 16)		Seiko Epson Corporation
+				3-3-5 OWA
+				SUWA-SHI  NAGANO-KEN  392-8502
+				JP
+
+9C-AE-D3   (hex)		Seiko Epson Corporation
+9CAED3     (base 16)		Seiko Epson Corporation
+				80 Harashinden
+				Shiojiri-shi  Nagano-ken  399-0785
+				JP
+
+70-7C-69   (hex)		Avaya Inc
+707C69     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+50-0B-91   (hex)		IEEE Registration Authority
+500B91     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-46-1C   (hex)		Sony Interactive Entertainment Inc.
+F8461C     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+70-4D-7B   (hex)		ASUSTek COMPUTER INC.
+704D7B     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+64-A6-8F   (hex)		Zhongshan Readboy Electronics Co.,Ltd
+64A68F     (base 16)		Zhongshan Readboy Electronics Co.,Ltd
+				Changmingshui Industrial Park Wuguishan Zhongshan City,Guangdong Province
+				Zhongshan  Guangdong  528400
+				CN
+
+38-BC-01   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38BC01     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-1E-6B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+341E6B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-66-39   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+886639     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-42-5A   (hex)		Cisco Systems, Inc
+00425A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-DB-F2   (hex)		Dell Inc.
+18DBF2     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+18-F8-7A   (hex)		i3 International Inc.
+18F87A     (base 16)		i3 International Inc.
+				780 Birchmount Road
+				Scarborough  Ontario  M1K5H4
+				CA
+
+4C-26-E7   (hex)		Welgate Co., Ltd.
+4C26E7     (base 16)		Welgate Co., Ltd.
+				19F, Geopyeong Bldg. 129
+				Seoul  Seoul  135726
+				KR
+
+00-60-41   (hex)		Yokogawa Digital Computer Corporation
+006041     (base 16)		Yokogawa Digital Computer Corporation
+				Shinjuku MIDWEST Bldg.4-30-3
+				Yoyogi  Shibuya-ku, Tokyo  151-0053
+				JP
+
+C8-16-A5   (hex)		Masimo Corporation
+C816A5     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine  CA  92618
+				US
+
+0C-02-27   (hex)		Technicolor CH USA Inc.
+0C0227     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+4C-11-BF   (hex)		Zhejiang Dahua Technology Co., Ltd.
+4C11BF     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				NO.1199 Bin An Road,Binjiang District,HangZhou,P.R.China
+				HangZhou  ZheJiang  310053
+				CN
+
+2C-59-8A   (hex)		LG Electronics (Mobile Communications)
+2C598A     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+B0-52-16   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+B05216     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+A0-E4-CB   (hex)		Zyxel Communications Corporation
+A0E4CB     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+28-4E-D7   (hex)		OutSmart Power Systems, Inc.
+284ED7     (base 16)		OutSmart Power Systems, Inc.
+				11 Mercer Rd
+				Natick  23  01760
+				
+
+14-A7-8B   (hex)		Zhejiang Dahua Technology Co., Ltd.
+14A78B     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199, Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+A0-B8-F8   (hex)		Amgen U.S.A. Inc.
+A0B8F8     (base 16)		Amgen U.S.A. Inc.
+				1 Amgen Center Drive
+				Thousand Oaks  CA  91320
+				US
+
+88-44-77   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+884477     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-9D-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+149D09     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+68-69-75   (hex)		Angler Labs Inc
+686975     (base 16)		Angler Labs Inc
+				940 Pearce Mill Rd.
+				Wexford  PA  15090
+				US
+
+20-D2-5F   (hex)		SmartCap Technologies
+20D25F     (base 16)		SmartCap Technologies
+				L1 18 Finchley Street
+				Milton  Queensland  4064
+				AU
+
+E4-7D-BD   (hex)		Samsung Electronics Co.,Ltd
+E47DBD     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+9C-FB-D5   (hex)		vivo Mobile Communication Co., Ltd.
+9CFBD5     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+18-F7-6B   (hex)		Zhejiang Winsight Technology CO.,LTD
+18F76B     (base 16)		Zhejiang Winsight Technology CO.,LTD
+				No.3339 Linggongtang Road，NanHu District
+				Jiaxing  Zhejiang   314000
+				CN
+
+58-31-12   (hex)		DRUST
+583112     (base 16)		DRUST
+				8 rue fabre d'églantine
+				Paris    75012
+				FR
+
+9C-83-BF   (hex)		PRO-VISION, Inc.
+9C83BF     (base 16)		PRO-VISION, Inc.
+				8625-B Byron Commerce Dr. SW
+				Byron Center  MI  49315
+				US
+
+78-EF-4C   (hex)		Unetconvergence Co., Ltd.
+78EF4C     (base 16)		Unetconvergence Co., Ltd.
+				101-511, Digital Empire2, 486, Shin-dong, Youngtong-gu
+				Suwon  Kyonggi-do  443-390
+				KR
+
+58-69-6C   (hex)		Ruijie Networks Co.,LTD
+58696C     (base 16)		Ruijie Networks Co.,LTD
+				19# Building,Star-net Science Plaza,Juyuanzhou, 618 Jinshan Road
+				Fuzhou  Fujian  350002
+				CN
+
+48-D3-43   (hex)		ARRIS Group, Inc.
+48D343     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-C0-5A   (hex)		SEMAPHORE COMMUNICATIONS CORP.
+00C05A     (base 16)		SEMAPHORE COMMUNICATIONS CORP.
+				217 HUMBOLDT COURT
+				SUNNYVALE  CA  94089-1300
+				US
+
+00-07-F9   (hex)		Sensaphone
+0007F9     (base 16)		Sensaphone
+				901 Tryens Road
+				Aston  PA  19014
+				US
+
+00-1C-B3   (hex)		Apple, Inc.
+001CB3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-71-83   (hex)		Juniper Networks
+407183     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C8-1B-5C   (hex)		BCTech
+C81B5C     (base 16)		BCTech
+				14 Building, Tiandeng road 259# 
+				shanghai  xuhui district, shanghai   200237
+				CN
+
+5C-E3-0E   (hex)		ARRIS Group, Inc.
+5CE30E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-C0-E1   (hex)		IEEE Registration Authority
+1CC0E1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-1A-39   (hex)		Merten GmbH&CoKG
+001A39     (base 16)		Merten GmbH&CoKG
+				Fritz-Kotz-Str. 8
+				Wiehl  NRW  51674
+				DE
+
+FC-EC-DA   (hex)		Ubiquiti Networks Inc.
+FCECDA     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+00-B0-E1   (hex)		Cisco Systems, Inc
+00B0E1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-93   (hex)		BOEING
+005093     (base 16)		BOEING
+				3370 Miraloma Avenue
+				Anaheim  CA  92803-3105
+				US
+
+90-5C-44   (hex)		Compal Broadband Networks, Inc.
+905C44     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+44-BA-46   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+44BA46     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+E0-7C-13   (hex)		zte corporation
+E07C13     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F4-1F-88   (hex)		zte corporation
+F41F88     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+14-ED-BB   (hex)		2Wire Inc
+14EDBB     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+18-E2-9F   (hex)		vivo Mobile Communication Co., Ltd.
+18E29F     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+28-EE-52   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+28EE52     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+68-72-51   (hex)		Ubiquiti Networks Inc.
+687251     (base 16)		Ubiquiti Networks Inc.
+				91 E. Tasman Dr.
+				San Jose    95134
+				US
+
+B4-FB-E4   (hex)		Ubiquiti Networks Inc.
+B4FBE4     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+70-79-90   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+707990     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-4E-01   (hex)		CENTRAL ENGINEERING co.,ltd.
+A04E01     (base 16)		CENTRAL ENGINEERING co.,ltd.
+				2-3-19 shinyokohama kouhoku-ku
+				yokohama-shi  kanagawa  222-0033
+				JP
+
+28-CA-09   (hex)		ThyssenKrupp Elevators (Shanghai) Co.,Ltd
+28CA09     (base 16)		ThyssenKrupp Elevators (Shanghai) Co.,Ltd
+				No. 2, Xunye Rd, Sheshan Subarea Songjiang Industrial Area
+				Shanghai  Shanghai  201602
+				CN
+
+84-25-19   (hex)		Samsung Electronics
+842519     (base 16)		Samsung Electronics
+				129, Samsung-rom Yeongtong-gu
+				Suwon-si  Gyeonggi-do  16677
+				KR
+
+5C-24-43   (hex)		O-Sung Telecom Co., Ltd.
+5C2443     (base 16)		O-Sung Telecom Co., Ltd.
+				43-9 Pyeongdongro 803-gil , Gwangsan-Gu
+				Gwangju    54611
+				KR
+
+24-92-0E   (hex)		Samsung Electronics Co.,Ltd
+24920E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-42-03   (hex)		Samsung Electronics Co.,Ltd
+FC4203     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-10-81   (hex)		Samsung Electronics Co.,Ltd
+A01081     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+3C-8B-CD   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+3C8BCD     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+4C-F9-5D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CF95D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-21-F1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8421F1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-F2-2C   (hex)		Shanghai B-star Technology Co.,Ltd.
+00F22C     (base 16)		Shanghai B-star Technology Co.,Ltd.
+				4Floor NO.1158 Xiehe Road,Changning District ,shanghai ,China 200335
+				Shanghai     200335
+				CN
+
+00-05-EE   (hex)		Vanderbilt International (SWE) AB 
+0005EE     (base 16)		Vanderbilt International (SWE) AB 
+				Englundavaegen 7
+				Solna    SE-171 41 
+				SE
+
+F0-79-60   (hex)		Apple, Inc.
+F07960     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-D7-95   (hex)		Apple, Inc.
+A0D795     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-90-E7   (hex)		HORSCH ELEKTRONIK AG
+0090E7     (base 16)		HORSCH ELEKTRONIK AG
+				HAAGERSTRASSE
+				CH-9473 GAMS    
+				CH
+
+E4-3E-D7   (hex)		Arcadyan Corporation
+E43ED7     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+54-54-CF   (hex)		PROBEDIGITAL CO.,LTD
+5454CF     (base 16)		PROBEDIGITAL CO.,LTD
+				#107 Hyundai I-Valley, 31, Galmachi-ro 244beon-gil, Jungwon-gu
+				Seongnam-si  Gyeonggi-do  13212
+				KR
+
+F8-63-3F   (hex)		Intel Corporate
+F8633F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+08-86-20   (hex)		TECNO MOBILE LIMITED
+088620     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+F0-D5-BF   (hex)		Intel Corporate
+F0D5BF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+64-74-F6   (hex)		Shooter Detection Systems
+6474F6     (base 16)		Shooter Detection Systems
+				300 Newburyport Turnpike
+				Rowley  MA  01969
+				US
+
+98-13-33   (hex)		zte corporation
+981333     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+20-47-ED   (hex)		BSkyB Ltd
+2047ED     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+74-8A-69   (hex)		Korea Image Technology Co., Ltd
+748A69     (base 16)		Korea Image Technology Co., Ltd
+				125, beolmal road, dongan gu,
+				anyang  gyeonggi  14056
+				KR
+
+BC-47-60   (hex)		Samsung Electronics Co.,Ltd
+BC4760     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-18-0F   (hex)		Samsung Electronics Co.,Ltd
+04180F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-13-E0   (hex)		Samsung Electronics Co.,Ltd
+2013E0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-25-66   (hex)		Samsung Electronics Co.,Ltd
+002566     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-DB-32   (hex)		Nokia Corporation
+D0DB32     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+E8-00-36   (hex)		Befs co,. ltd
+E80036     (base 16)		Befs co,. ltd
+				C-#403, 242 Pangyo-ro, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13487
+				KR
+
+C0-9F-05   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C09F05     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+5C-49-79   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+5C4979     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+C0-F9-45   (hex)		Toshiba Toko Meter Systems Co., LTD.
+C0F945     (base 16)		Toshiba Toko Meter Systems Co., LTD.
+				3484, Sakuragaoka, Kurohama
+				Hasuda-shi  Saitama  349-0192
+				JP
+
+70-F8-E7   (hex)		IEEE Registration Authority
+70F8E7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D4-2C-44   (hex)		Cisco Systems, Inc
+D42C44     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+84-3D-C6   (hex)		Cisco Systems, Inc
+843DC6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-85   (hex)		ConteXtream Ltd
+002485     (base 16)		ConteXtream Ltd
+				94 Em-HaMoshavot
+				Petach-Tikva    49527
+				IL
+
+28-FC-F6   (hex)		Shenzhen Xin KingBrand enterprises Co.,Ltd
+28FCF6     (base 16)		Shenzhen Xin KingBrand enterprises Co.,Ltd
+				Kingbrand Industrial Zone,Nanpu Road,Shang liao ling pi keng,Shajing Town
+				Shenzhen  Guangdong  518000
+				CN
+
+00-1F-58   (hex)		EMH Energiemesstechnik GmbH
+001F58     (base 16)		EMH Energiemesstechnik GmbH
+				Vor dem Hassel 2
+				Brackel    21438
+				DE
+
+68-94-23   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+689423     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+84-4B-F5   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+844BF5     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+08-ED-B9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+08EDB9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+3C-77-E6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+3C77E6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+70-18-8B   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+70188B     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+5C-6D-20   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+5C6D20     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+5C-AC-4C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+5CAC4C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-16-DF   (hex)		Lundinova AB
+0016DF     (base 16)		Lundinova AB
+				Dalbyvägen 1
+				Lund  Skåne  SE-224 60
+				US
+
+00-1D-0C   (hex)		MobileCompia
+001D0C     (base 16)		MobileCompia
+				Dongwon Bldg, 725-30, Yeoksam-dong, Gangnam-gu,
+				Seoul    135-080
+				KR
+
+B8-8E-DF   (hex)		Zencheer Communication Technology Co., Ltd.
+B88EDF     (base 16)		Zencheer Communication Technology Co., Ltd.
+				Room 2706, BLDG#7, Changjiang Building, NO.12, Changjiang Road, New District
+				Wuxi  Jiangsu  214028
+				CN
+
+DC-71-44   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+DC7144     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon    443-743
+				US
+
+98-0C-82   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+980C82     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				Metan Dong 314, Youngtong Gu
+				Suwon  Kyung-gi Do.  443-743
+				KR
+
+A0-0B-BA   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+A00BBA     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				Suwon-Si, Gyeonggi_Do, Korea
+				Suwon  Gyeonggi_Do  443-743
+				KR
+
+60-6B-BD   (hex)		Samsung Electronics Co.,Ltd
+606BBD     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon-si  Gyeonggi-do  443742
+				KR
+
+00-21-4C   (hex)		Samsung Electronics Co.,Ltd
+00214C     (base 16)		Samsung Electronics Co.,Ltd
+				416, METAN-3DONG,
+				SUWON  KYUNGKI-DO  442-742
+				KR
+
+08-C6-B3   (hex)		QTECH LLC
+08C6B3     (base 16)		QTECH LLC
+				Novozavodskaya st. 18 build. 1
+				Moscow  Moscow region  121309
+				RU
+
+00-18-AF   (hex)		Samsung Electronics Co.,Ltd
+0018AF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+00-1E-E1   (hex)		Samsung Electronics Co.,Ltd
+001EE1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-16-6B   (hex)		Samsung Electronics Co.,Ltd
+00166B     (base 16)		Samsung Electronics Co.,Ltd
+				416,Maetan-3Dong,Yeongtong-Gu
+				Suwon-City  Kyeonggi-Do  443-742
+				KR
+
+00-00-F0   (hex)		Samsung Electronics Co.,Ltd
+0000F0     (base 16)		Samsung Electronics Co.,Ltd
+				416, MAETAN-3DONG, PALDAL-GU
+				kwon    442-742
+				KR
+
+8C-C8-CD   (hex)		Samsung Electronics Co.,Ltd
+8CC8CD     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, Yeongtong-gu
+				Suwon  Gyeonggi-do  443742
+				KR
+
+A8-F2-74   (hex)		Samsung Electronics Co.,Ltd
+A8F274     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-87-D8   (hex)		Samsung Electronics Co.,Ltd
+D487D8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-46-17   (hex)		Samsung Electronics Co.,Ltd
+184617     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+38-0A-94   (hex)		Samsung Electronics Co.,Ltd
+380A94     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-DF-C7   (hex)		Samsung Electronics Co.,Ltd
+D0DFC7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-C1-B1   (hex)		Samsung Electronics Co.,Ltd
+D0C1B1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+80-18-A7   (hex)		Samsung Electronics Co.,Ltd
+8018A7     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3dong, Yeongtong-Gu
+				Suwon  Gyeonggi-Do  443742
+				KR
+
+F4-7B-5E   (hex)		Samsung Electronics Co.,Ltd
+F47B5E     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3dong, Yeongtong-Gu
+				Suwon  Gyeonggi-Do  443742
+				KR
+
+70-F9-27   (hex)		Samsung Electronics Co.,Ltd
+70F927     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-E7-1C   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+34E71C     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+88-6A-B1   (hex)		vivo Mobile Communication Co., Ltd.
+886AB1     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+6C-1E-90   (hex)		Hansol Technics Co., Ltd.
+6C1E90     (base 16)		Hansol Technics Co., Ltd.
+				55, Hansam-ro, Deoksan-Myeon
+				Jincheon-Gun  Chungbuk  27850
+				KR
+
+00-5A-13   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+005A13     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-50-06   (hex)		Samsung Electronics Co.,Ltd
+C45006     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-32-9B   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+88329B     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+14-49-E0   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+1449E0     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong    24180
+				US
+
+D0-25-44   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+D02544     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+BC-44-86   (hex)		Samsung Electronics Co.,Ltd
+BC4486     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-D3-90   (hex)		Samsung Electronics Co.,Ltd
+20D390     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-01-C2   (hex)		Samsung Electronics Co.,Ltd
+9401C2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-FC-9F   (hex)		Samsung Electronics Co.,Ltd
+50FC9F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+38-0B-40   (hex)		Samsung Electronics Co.,Ltd
+380B40     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B8-FF-61   (hex)		Apple, Inc.
+B8FF61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-61-24   (hex)		Pason Systems
+946124     (base 16)		Pason Systems
+				6130 - 3rd Street S.E.
+				Calgary  Alberta  T2H1K4
+				CA
+
+F0-72-8C   (hex)		Samsung Electronics Co.,Ltd
+F0728C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-AA-8B   (hex)		Samsung Electronics Co.,Ltd
+34AA8B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+24-DB-ED   (hex)		Samsung Electronics Co.,Ltd
+24DBED     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-DE-51   (hex)		 IntegraOptics
+C8DE51     (base 16)		 IntegraOptics
+				745 Albany Shaker Rd
+				Latham   NY  12110
+				US
+
+98-F0-58   (hex)		Lynxspring, Incl.
+98F058     (base 16)		Lynxspring, Incl.
+				1210 NE Windsor Drive
+				Lees Summit  MO  64086
+				US
+
+68-C4-4D   (hex)		Motorola Mobility LLC, a Lenovo Company
+68C44D     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+40-0D-10   (hex)		ARRIS Group, Inc.
+400D10     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+94-3D-C9   (hex)		Asahi Net, Inc.
+943DC9     (base 16)		Asahi Net, Inc.
+				Ginza 4-12-15 Chuo-ku
+				Tokyo    104-0061
+				JP
+
+44-04-44   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+440444     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+00-17-7E   (hex)		Meshcom Technologies Inc.
+00177E     (base 16)		Meshcom Technologies Inc.
+				Meritullinkatu 1 C
+				Helsinki    00170
+				FI
+
+A0-04-60   (hex)		NETGEAR
+A00460     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+98-84-E3   (hex)		Texas Instruments
+9884E3     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+38-D2-69   (hex)		Texas Instruments
+38D269     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+C8-FD-19   (hex)		Texas Instruments
+C8FD19     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+50-8C-B1   (hex)		Texas Instruments
+508CB1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+C4-F5-A5   (hex)		Kumalift Co., Ltd.
+C4F5A5     (base 16)		Kumalift Co., Ltd.
+				7-2-6 Saito-Asagi
+				Ibaraki  Osaka  567-0085
+				JP
+
+70-B1-4E   (hex)		ARRIS Group, Inc.
+70B14E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+30-44-87   (hex)		Hefei Radio Communication Technology Co., Ltd 
+304487     (base 16)		Hefei Radio Communication Technology Co., Ltd 
+				No.108, YinXing Road, High-tech Development Zone
+				Hefei  Anhui  230088
+				CN
+
+2C-9D-1E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2C9D1E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-81-C4   (hex)		Cisco Systems, Inc
+0081C4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-E8-76   (hex)		IEEE Registration Authority
+58E876     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D0-37-42   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+D03742     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				Coolpad Information Harbor, 2nd Mengxi road, Hi-Tech Industrial Park(North), Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-17-65   (hex)		Nortel Networks
+001765     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-15-E8   (hex)		Nortel Networks
+0015E8     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-15-9B   (hex)		Nortel Networks
+00159B     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0F-06   (hex)		Nortel Networks
+000F06     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+84-B5-41   (hex)		Samsung Electronics Co.,Ltd
+84B541     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-6F-64   (hex)		Samsung Electronics Co.,Ltd
+006F64     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-66-72   (hex)		Samsung Electronics Co.,Ltd
+DC6672     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+EC-8E-B5   (hex)		Hewlett Packard
+EC8EB5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+70-AF-6A   (hex)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+70AF6A     (base 16)		SHENZHEN FENGLIAN TECHNOLOGY CO., LTD.
+				ORIENTAL CYBERPORT, HIGHTECH 6 ROAD
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+20-F5-43   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+20F543     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+E0-DD-C0   (hex)		vivo Mobile Communication Co., Ltd.
+E0DDC0     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+00-16-4D   (hex)		Alcatel-Lucent IPD
+00164D     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield RD.
+				Mountain View  CA  94043
+				US
+
+00-1A-F0   (hex)		Alcatel-Lucent IPD
+001AF0     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94943
+				US
+
+38-52-1A   (hex)		Nokia
+38521A     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-1E-40   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+001E40     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F, lnfo Tech Building, NO.1555 Kongjiang Road,
+				Shanghai    200092
+				CN
+
+94-D7-23   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+94D723     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F Info-Tech Building
+				Shanghai    200092
+				CN
+
+C4-04-7B   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+C4047B     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Shenzhen University-town Business Park,Lishan Road,Taoyuan Street
+				Shenzhen  Guangdong  518055
+				CN
+
+20-F4-1B   (hex)		Shenzhen Bilian electronic CO.,LTD
+20F41B     (base 16)		Shenzhen Bilian electronic CO.,LTD
+				NO 268, Fuqian Rd,Jutang Community,Guanlan town,
+				ShenZhen  Guangdong  518110
+				CN
+
+FC-FA-F7   (hex)		Shanghai Baud Data Communication Co.,Ltd.
+FCFAF7     (base 16)		Shanghai Baud Data Communication Co.,Ltd.
+				NO.123 JULI RD
+				SHANGHAI    201203
+				CN
+
+D8-26-B9   (hex)		Guangdong Coagent Electronics S&amp;T Co.,Ltd.
+D826B9     (base 16)		Guangdong Coagent Electronics S&amp;T Co.,Ltd.
+				Section C,Xi Nan Industrial Zone Sanshui
+				Foshan  Guangdong  528133
+				CN
+
+AC-9C-E4   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+AC9CE4     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+00-23-3E   (hex)		Alcatel-Lucent IPD
+00233E     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+6C-BE-E9   (hex)		Alcatel-Lucent IPD
+6CBEE9     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+00-15-40   (hex)		Nortel Networks
+001540     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1E-CA   (hex)		Nortel Networks
+001ECA     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-13-0A   (hex)		Nortel Networks
+00130A     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1F-0A   (hex)		Nortel Networks
+001F0A     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+F8-E6-1A   (hex)		Samsung Electronics Co.,Ltd
+F8E61A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-91-C8   (hex)		zte corporation
+A091C8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+6C-A8-58   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+6CA858     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+CC-2D-8C   (hex)		LG ELECTRONICS INC
+CC2D8C     (base 16)		LG ELECTRONICS INC
+				19-1,Cheongho-Ri,Jinwi-Myeon
+				Pyeongtaek  Gyeonggi-Do  451-713
+				KR
+
+98-D6-F7   (hex)		LG Electronics (Mobile Communications)
+98D6F7     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+70-05-14   (hex)		LG Electronics (Mobile Communications)
+700514     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+E8-92-A4   (hex)		LG Electronics (Mobile Communications)
+E892A4     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+10-68-3F   (hex)		LG Electronics (Mobile Communications)
+10683F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+40-B0-FA   (hex)		LG Electronics (Mobile Communications)
+40B0FA     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-25-E5   (hex)		LG Electronics (Mobile Communications)
+0025E5     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-21-FB   (hex)		LG Electronics (Mobile Communications)
+0021FB     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+34-FC-EF   (hex)		LG Electronics (Mobile Communications)
+34FCEF     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+BC-F5-AC   (hex)		LG Electronics (Mobile Communications)
+BCF5AC     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+A8-4E-3F   (hex)		Hitron Technologies. Inc
+A84E3F     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+0C-48-85   (hex)		LG Electronics (Mobile Communications)
+0C4885     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-22-A9   (hex)		LG Electronics (Mobile Communications)
+0022A9     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+2C-6A-6F   (hex)		IEEE Registration Authority
+2C6A6F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+08-D8-33   (hex)		Shenzhen RF Technology Co., Ltd
+08D833     (base 16)		Shenzhen RF Technology Co., Ltd
+				5/F,Building 4 ,Baokun science and Technology Industrial Park,Dalang Street,Baoan District,Shenzhen,China
+				Shenzhen  Guangdong  518109
+				CN
+
+A4-60-32   (hex)		MRV Communications (Networks) LTD
+A46032     (base 16)		MRV Communications (Networks) LTD
+				Hayetzira 6
+				Yokneam  Yokneam  20692
+				IL
+
+40-66-7A   (hex)		mediola - connected living AG
+40667A     (base 16)		mediola - connected living AG
+				Nobelring 26
+				Frankfurt am Main  Hessen  60598
+				DE
+
+68-A0-F6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+68A0F6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-0E-5C   (hex)		ARRIS Group, Inc.
+000E5C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+84-5D-D7   (hex)		Shenzhen Netcom Electronics Co.,Ltd
+845DD7     (base 16)		Shenzhen Netcom Electronics Co.,Ltd
+				8/F,1 Building,Finance Base,No.8,Kefa Road,High-Tech Park
+				Shenzhen  Guangdong  518057
+				CN
+
+00-B0-64   (hex)		Cisco Systems, Inc
+00B064     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-2A-83   (hex)		Samsung Electronics Co.,Ltd
+9C2A83     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-02-10   (hex)		LG Innotek
+C80210     (base 16)		LG Innotek
+				Jangduk-dong 978-1
+				Gwang-ju  Gwangsan-gu  506-731
+				KR
+
+A0-39-F7   (hex)		LG Electronics (Mobile Communications)
+A039F7     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+1C-CA-E3   (hex)		IEEE Registration Authority
+1CCAE3     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E4-95-6E   (hex)		IEEE Registration Authority
+E4956E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+B4-37-D1   (hex)		IEEE Registration Authority
+B437D1     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-55-DA   (hex)		IEEE Registration Authority
+0055DA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+78-C2-C0   (hex)		IEEE Registration Authority
+78C2C0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-0E-E8   (hex)		Zioncom Electronics (Shenzhen) Ltd.
+000EE8     (base 16)		Zioncom Electronics (Shenzhen) Ltd.
+				West wing 5/F ., Block 1, GaoXin South Ring Rd/Keji South Rd,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-C0-95   (hex)		ZNYX Networks, Inc.
+00C095     (base 16)		ZNYX Networks, Inc.
+				48421 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-20-25   (hex)		CONTROL TECHNOLOGY, INC.
+002025     (base 16)		CONTROL TECHNOLOGY, INC.
+				5734 MIDDLEBROOK PIKE
+				KNOXVILLE  TN  37921
+				US
+
+00-1A-6B   (hex)		Universal Global Scientific Industrial Co., Ltd.
+001A6B     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+00-16-41   (hex)		Universal Global Scientific Industrial Co., Ltd.
+001641     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+00-10-C6   (hex)		Universal Global Scientific Industrial Co., Ltd.
+0010C6     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+00-24-7E   (hex)		Universal Global Scientific Industrial Co., Ltd.
+00247E     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1,  TAIPING RD.
+				nantou  NANTOU  54261
+				TW
+
+00-DD-0A   (hex)		UNGERMANN-BASS INC.
+00DD0A     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+68-35-63   (hex)		SHENZHEN LIOWN ELECTRONICS CO.,LTD.
+683563     (base 16)		SHENZHEN LIOWN ELECTRONICS CO.,LTD.
+				ROOM 301, NO.7, GONGYE 3RD ROAD
+				SHEKOU, NANSHAN DISTRICT  SHENZHEN  518054
+				CN
+
+00-40-72   (hex)		Applied Innovation Inc.
+004072     (base 16)		Applied Innovation Inc.
+				5800 Innovation Drive
+				Dublin  OH  43016-3271
+				US
+
+00-19-38   (hex)		UMB Communications Co., Ltd.
+001938     (base 16)		UMB Communications Co., Ltd.
+				1010, 5, ACE Techno Tower, 197-22, Guro-dong, Guro-gu
+				Seoul    151-766
+				KR
+
+44-39-C4   (hex)		Universal Global Scientific Industrial Co., Ltd.
+4439C4     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141,Lane351,Taiping Rd.Sec.1
+				nan tou    542
+				TW
+
+40-2C-F4   (hex)		Universal Global Scientific Industrial Co., Ltd.
+402CF4     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, Taiping Rd. Sec. 1, Tsao Tuen, 
+				Nan-Tou Hsien,    542
+				TW
+
+00-1E-37   (hex)		Universal Global Scientific Industrial Co., Ltd.
+001E37     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, LANE 351,SEC.1, TAIPING RD.
+				TSAOTUEN,  NANTOU  54261
+				TW
+
+1C-57-D8   (hex)		Kraftway Corporation PLC
+1C57D8     (base 16)		Kraftway Corporation PLC
+				16, 3rd Mytischinskaya st.
+				Moscow    129626
+				RU
+
+00-23-18   (hex)		Toshiba
+002318     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+B8-6B-23   (hex)		Toshiba
+B86B23     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+00-08-F1   (hex)		Voltaire
+0008F1     (base 16)		Voltaire
+				9 Hamenofim st.
+				Herzelia    46725
+				IL
+
+00-19-9D   (hex)		Vizio, Inc
+00199D     (base 16)		Vizio, Inc
+				39 Tesla
+				Irvine  CA  92618
+				US
+
+00-E0-8B   (hex)		QLogic Corporation
+00E08B     (base 16)		QLogic Corporation
+				26600 Laguna Hills Dr.
+				Aliso Viejo  CA  92656
+				US
+
+D8-EB-97   (hex)		TRENDnet, Inc.
+D8EB97     (base 16)		TRENDnet, Inc.
+				20675 Manhattan Place
+				Torrance  CA  90501
+				US
+
+00-1C-7E   (hex)		Toshiba
+001C7E     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome    1988710
+				JP
+
+00-25-17   (hex)		Venntis, LLC
+002517     (base 16)		Venntis, LLC
+				11301 James Street
+				Holland  MI  49424
+				US
+
+00-60-0F   (hex)		Westell Technologies Inc.
+00600F     (base 16)		Westell Technologies Inc.
+				750 N Commons Dr
+				Aurora  IL  60504
+				US
+
+00-18-3A   (hex)		Westell Technologies Inc.
+00183A     (base 16)		Westell Technologies Inc.
+				750 N Commons Dr
+				Aurora  IL  60504
+				US
+
+60-02-B4   (hex)		Wistron Neweb Corporation
+6002B4     (base 16)		Wistron Neweb Corporation
+				No.20 Park Avenue II
+				Hsinchu    308
+				TW
+
+94-DF-4E   (hex)		Wistron InfoComm(Kunshan)Co.,Ltd.
+94DF4E     (base 16)		Wistron InfoComm(Kunshan)Co.,Ltd.
+				168# First Avence,Kunshan Export Processing Zone ,China
+				Kunsha  JiangSu  215300
+				CN
+
+98-EE-CB   (hex)		Wistron Infocomm (Zhongshan) Corporation
+98EECB     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				No.38,East Keji Road,Zhongshan Torch Development Zone,Zhongshan City,Guangdong,China
+				Zhongshan  Guangdong  528437
+				CN
+
+64-3A-B1   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+643AB1     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road, Chengdu, Sichuan
+				Chengdu  Sichuan  610000
+				CN
+
+00-1B-FE   (hex)		Zavio Inc.
+001BFE     (base 16)		Zavio Inc.
+				No.1,Lising 1st Rd. Science Based Industrial Park,
+				Hsinchu    300
+				TW
+
+54-10-EC   (hex)		Microchip Technology Inc.
+5410EC     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+00-04-A3   (hex)		Microchip Technology Inc.
+0004A3     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+78-9C-E7   (hex)		Shenzhen Aikede Technology Co., Ltd
+789CE7     (base 16)		Shenzhen Aikede Technology Co., Ltd
+				Room 9B,Block B,Neptunus Mansion,
+				Shenzhen  Guangdong  518000
+				CN
+
+50-9F-3B   (hex)		OI ELECTRIC CO.,LTD
+509F3B     (base 16)		OI ELECTRIC CO.,LTD
+				7-3-16 KIKUNA
+				YOKOHAMA  KANAGAWA-KEN  222-0011
+				JP
+
+44-6E-E5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+446EE5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-F7-C7   (hex)		Technicolor CH USA Inc.
+88F7C7     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+80-48-A5   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+8048A5     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,TianYi International Hotel
+				Chengdu  Sichuan  61000
+				CN
+
+68-3E-34   (hex)		MEIZU Technology Co., Ltd.
+683E34     (base 16)		MEIZU Technology Co., Ltd.
+				MEIZU Tech Bldg., Technology & Innovation Coast
+				Zhuhai  Guangdong  519085
+				CN
+
+C8-77-8B   (hex)		Mercury Systems – Trusted Mission Solutions, Inc. 
+C8778B     (base 16)		Mercury Systems – Trusted Mission Solutions, Inc. 
+				47200 Bayside Pkwy
+				Fremont  CA  94538
+				US
+
+00-04-4B   (hex)		NVIDIA
+00044B     (base 16)		NVIDIA
+				3535 Monroe St.
+				Santa Clara  CA  95051
+				US
+
+AC-9B-0A   (hex)		Sony Corporation
+AC9B0A     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+10-4F-A8   (hex)		Sony Corporation
+104FA8     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+00-0B-6B   (hex)		Wistron Neweb Corporation
+000B6B     (base 16)		Wistron Neweb Corporation
+				No. 10-1, Li-Hsin Road I, Science-based
+				Hsinchu    300
+				TW
+
+AC-04-0B   (hex)		Peloton Interactive, Inc
+AC040B     (base 16)		Peloton Interactive, Inc
+				158 W 27th St, 4th Fl
+				New York  NY  10001
+				US
+
+48-FC-B6   (hex)		LAVA INTERNATIONAL(H.K) LIMITED
+48FCB6     (base 16)		LAVA INTERNATIONAL(H.K) LIMITED
+				UNIT L 1/F MAU LAM COMM BLDG 16-18 MAU LAM ST, JORDAN KL, HK
+				Hong kong    999077
+				CN
+
+B0-E2-35   (hex)		Xiaomi Communications Co Ltd
+B0E235     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+40-C7-29   (hex)		Sagemcom Broadband SAS
+40C729     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+14-C9-13   (hex)		LG Electronics
+14C913     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+F8-A0-97   (hex)		ARRIS Group, Inc.
+F8A097     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-23-25   (hex)		EosTek (Shenzhen) Co., Ltd.
+FC2325     (base 16)		EosTek (Shenzhen) Co., Ltd.
+				Room 306, Complex Building Tsinghua High-Tech Park
+				Shenzhen  Guangdong  518057
+				CN
+
+FC-3D-93   (hex)		LONGCHEER TELECOMMUNICATION LIMITED
+FC3D93     (base 16)		LONGCHEER TELECOMMUNICATION LIMITED
+				Building 1,No.401,Caobao Rd
+				Shanghai  Xuhui District  200233
+				CN
+
+D8-E0-B8   (hex)		BULAT LLC
+D8E0B8     (base 16)		BULAT LLC
+				Zagorievsiy proezd 1, room 7
+				Moscow    115547
+				RU
+
+60-31-97   (hex)		Zyxel Communications Corporation
+603197     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+C0-C9-76   (hex)		Shenzhen TINNO Mobile Technology Corp.
+C0C976     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+58-8B-F3   (hex)		Zyxel Communications Corporation
+588BF3     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+50-67-F0   (hex)		Zyxel Communications Corporation
+5067F0     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+00-13-49   (hex)		Zyxel Communications Corporation
+001349     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+E0-98-61   (hex)		Motorola Mobility LLC, a Lenovo Company
+E09861     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+9C-8E-CD   (hex)		Amcrest Technologies
+9C8ECD     (base 16)		Amcrest Technologies
+				16727 Park Row
+				Houston  TX  77084
+				US
+
+A0-09-ED   (hex)		Avaya Inc
+A009ED     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-14-B4   (hex)		General Dynamics United Kingdom Ltd
+0014B4     (base 16)		General Dynamics United Kingdom Ltd
+				Castleham Road
+				St Leonards on Sea  East Sussex  TN38 9NJ
+				GB
+
+A0-B4-37   (hex)		 GD Mission Systems
+A0B437     (base 16)		 GD Mission Systems
+				8220 EAST ROOSEVELT ST R2121
+				SCOTTSDALE  AZ  85257
+				US
+
+8C-6D-50   (hex)		SHENZHEN MTC CO LTD
+8C6D50     (base 16)		SHENZHEN MTC CO LTD
+				5th Floor, 3rd Building, SHENZHEN MTC Industrial Park, XiaLilang Rd, Nanwan Street, Long’gang District
+				Shenzhen  Guangdong  518100
+				CN
+
+00-F6-63   (hex)		Cisco Systems, Inc
+00F663     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-60-90   (hex)		Samsung Electronics Co.,Ltd
+A06090     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-76-5E   (hex)		Samsung Electronics Co.,Ltd
+BC765E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E0-A8-B8   (hex)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+E0A8B8     (base 16)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+				,Le Shi Building, No.105 Yaojiayuan Road,Chaoyang District,Beijing,China
+				beijing  beijing  100025
+				CN
+
+F4-5B-73   (hex)		Wanjiaan Interconnected Technology Co., Ltd
+F45B73     (base 16)		Wanjiaan Interconnected Technology Co., Ltd
+				2nd Floor,Incubation Building, Science Development Institute of China, High-tech South 1st Street, Nanshan District
+				Shenzhen  Guangdong  518040
+				CN
+
+B8-81-98   (hex)		Intel Corporate
+B88198     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B0-D7-CC   (hex)		Tridonic GmbH & Co KG
+B0D7CC     (base 16)		Tridonic GmbH & Co KG
+				Färbergasse 15
+				Dornbirn  Vorarlberg  6851
+				AT
+
+2C-DD-A3   (hex)		Point Grey Research Inc.
+2CDDA3     (base 16)		Point Grey Research Inc.
+				305-1847 West Broadway
+				Vancouver  British Columbia V6J 1Y6  
+				CA
+
+00-80-9F   (hex)		ALE International
+00809F     (base 16)		ALE International
+				32 avenue Kléber
+				Colombes    92700
+				FR
+
+48-C6-63   (hex)		GTO Access Systems LLC
+48C663     (base 16)		GTO Access Systems LLC
+				3121 Hartsfield Road
+				Tallahassee  FL  32303
+				US
+
+00-5F-86   (hex)		Cisco Systems, Inc
+005F86     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-1D-D9   (hex)		FN-LINK TECHNOLOGY LIMITED
+381DD9     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+1C-B9-C4   (hex)		Ruckus Wireless
+1CB9C4     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+8C-59-C3   (hex)		ADB Italia 
+8C59C3     (base 16)		ADB Italia 
+				Viale Sarca 222
+				Milan  Italy  20126
+				IT
+
+B8-24-F0   (hex)		SOYO Technology Development Co., Ltd.
+B824F0     (base 16)		SOYO Technology Development Co., Ltd.
+				4F, 9Bldg, Longbi Industry Zone, Longgang Dist, Shenzhen City, Guangdong Pro, China
+				Shenzhen City   Guangdong Pro  518129
+				CN
+
+D8-5B-2A   (hex)		Samsung Electronics Co.,Ltd
+D85B2A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-A8-9A   (hex)		Sunitec Enterprise Co.,Ltd
+FCA89A     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+1C-7B-23   (hex)		Qingdao Hisense Communications Co.,Ltd.
+1C7B23     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+00-0B-DE   (hex)		TELDIX GmbH
+000BDE     (base 16)		TELDIX GmbH
+				Grenzhoefer Weg 36
+				Heidelberg    69123
+				DE
+
+CC-D3-1E   (hex)		IEEE Registration Authority
+CCD31E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+34-B3-54   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+34B354     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-6E-76   (hex)		Quarion Technology Inc
+1C6E76     (base 16)		Quarion Technology Inc
+				3248 Commerce Drive
+				Newburgh  IN  47630
+				US
+
+90-C1-C6   (hex)		Apple, Inc.
+90C1C6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-0E-E6   (hex)		Chengdu Xiyida Electronic Technology Co,.Ltd
+6C0EE6     (base 16)		Chengdu Xiyida Electronic Technology Co,.Ltd
+				Room 408,Building A,No.33 Wuqing South Road,Wuhou District
+				Chengdu  Sichuan  610000
+				CN
+
+CC-50-0A   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+CC500A     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D0-46-DC   (hex)		Southwest Research Institute
+D046DC     (base 16)		Southwest Research Institute
+				6220 Culebra Road
+				San Antonio  Texas  78238
+				US
+
+70-A2-B3   (hex)		Apple, Inc.
+70A2B3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-0F-24   (hex)		Apple, Inc.
+F40F24     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-57-CA   (hex)		Apple, Inc.
+4C57CA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-07-63   (hex)		Sunniwell Cyber Tech. Co., Ltd.
+000763     (base 16)		Sunniwell Cyber Tech. Co., Ltd.
+				17th Floor Haitai Building #229
+				Beijing    100083
+				CN
+
+00-62-EC   (hex)		Cisco Systems, Inc
+0062EC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-16-7E   (hex)		Cisco Systems, Inc
+CC167E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-6A-B7   (hex)		Xiaomi Communications Co Ltd
+C46AB7     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-0A-ED   (hex)		HARTING Electronics GmbH
+000AED     (base 16)		HARTING Electronics GmbH
+				Wilhelm Harting Str.1
+				Espelkamp  NRW/OWL  32339
+				DE
+
+24-0A-11   (hex)		TCT mobile ltd
+240A11     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+D8-E5-6D   (hex)		TCT mobile ltd
+D8E56D     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+54-05-93   (hex)		WOORI ELEC Co.,Ltd
+540593     (base 16)		WOORI ELEC Co.,Ltd
+				#1401~03, #1411~12, Bucheon Deawoo Techno Park, D-Dong, 261,Doyak-Ro, Wonmi-Gu,Bucheon-Si
+				Gyeonggi-Do    14523
+				KR
+
+C0-2F-F1   (hex)		Volta Networks
+C02FF1     (base 16)		Volta Networks
+				109 Kingston St, 3rd Floor
+				Boston  MA  02111
+				US
+
+E8-A7-F2   (hex)		sTraffic
+E8A7F2     (base 16)		sTraffic
+				4th Fl., KTNET Building, 338 Pangyoro, Bundang-gu
+				Seongnam  Gyeonggi-do  13493
+				KR
+
+00-1F-20   (hex)		Logitech Europe SA
+001F20     (base 16)		Logitech Europe SA
+				EPFL - Quartier de l'Innovation
+				Lausanne  CH  1015
+				CH
+
+74-1F-4A   (hex)		Hangzhou H3C Technologies Co., Limited
+741F4A     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District,
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+E4-1D-2D   (hex)		Mellanox Technologies, Inc.
+E41D2D     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+0C-DA-41   (hex)		Hangzhou H3C Technologies Co., Limited
+0CDA41     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+74-25-8A   (hex)		Hangzhou H3C Technologies Co., Limited
+74258A     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+A0-B6-62   (hex)		Acutvista Innovation Co., Ltd.
+A0B662     (base 16)		Acutvista Innovation Co., Ltd.
+				2F-1, No. 20 Alley 1, Lane 768, Sec. 4
+				Taipei City    11577
+				TW
+
+E4-2F-56   (hex)		OptoMET GmbH
+E42F56     (base 16)		OptoMET GmbH
+				Pfungstaedter Str. 92
+				Darmstadt    64297
+				DE
+
+F8-DA-0C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F8DA0C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+1C-1B-0D   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+1C1B0D     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+48-E9-F1   (hex)		Apple, Inc.
+48E9F1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-38-09   (hex)		Ericsson AB
+903809     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+00-A0-06   (hex)		IMAGE DATA PROCESSING SYSTEM GROUP
+00A006     (base 16)		IMAGE DATA PROCESSING SYSTEM GROUP
+				SHINTOYOFUTA 2-1
+				KASHIWA-CITY, CHIBA 277    
+				JP
+
+C8-3F-26   (hex)		Microsoft Corporation
+C83F26     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+34-97-F6   (hex)		ASUSTek COMPUTER INC.
+3497F6     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+50-68-0A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+50680A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-22-38   (hex)		LOGIPLUS
+002238     (base 16)		LOGIPLUS
+				1, RUE CLEMENT ADER
+				GOSSELIES  HAINAUT  B-6041
+				BE
+
+00-0C-49   (hex)		Dangaard Telecom Denmark A/S
+000C49     (base 16)		Dangaard Telecom Denmark A/S
+				Industrivej 1
+				Padborg    DK-6330
+				DK
+
+00-08-B9   (hex)		Kaonmedia CO., LTD.
+0008B9     (base 16)		Kaonmedia CO., LTD.
+				#113 Imae 1-Dong, Bundang-Gu
+				Sungnam-City  Kyungki-Do  463-829
+				KR
+
+60-B3-87   (hex)		Synergics Technologies GmbH
+60B387     (base 16)		Synergics Technologies GmbH
+				Hummelgasse 74-76/19
+				Vienna  Austria  1130
+				AT
+
+A4-D8-CA   (hex)		HONG KONG WATER WORLD TECHNOLOGY CO. LIMITED
+A4D8CA     (base 16)		HONG KONG WATER WORLD TECHNOLOGY CO. LIMITED
+				RM B-C, 24/F, GOLDEN BEAR INDUSTRIAL CENTRE, 66-82  CHAI WAN KOK STREET,TSUEN WAN. N.T.
+				Hong Kong    999077
+				HK
+
+80-19-FE   (hex)		JianLing Technology CO., LTD
+8019FE     (base 16)		JianLing Technology CO., LTD
+				No. 383-1, Sec. 2, Jinling Rd., Pingzhen Dist.,
+				Tao Yuan    324
+				TW
+
+60-B4-F7   (hex)		Plume Design Inc
+60B4F7     (base 16)		Plume Design Inc
+				200 California Ave
+				Palo Alto  CA  94306
+				US
+
+48-7A-DA   (hex)		Hangzhou H3C Technologies Co., Limited
+487ADA     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+00-1F-45   (hex)		Enterasys
+001F45     (base 16)		Enterasys
+				50 Minuteman Road
+				Andover  MA  01810
+				US
+
+00-1E-90   (hex)		Elitegroup Computer Systems Co.,Ltd.
+001E90     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.239, Sec. 2, Ti Ding Blvd
+				Taipei    11493
+				TW
+
+00-22-B1   (hex)		Elbit Systems Ltd.
+0022B1     (base 16)		Elbit Systems Ltd.
+				p.o.b. 539
+				Haifa    36925
+				IL
+
+00-00-B4   (hex)		Edimax Technology Co. Ltd.
+0000B4     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+00-16-8F   (hex)		GN Netcom A/S
+00168F     (base 16)		GN Netcom A/S
+				Metalbuen 66
+				Ballerup  Skovlunde  DK-2750
+				DK
+
+00-0D-87   (hex)		Elitegroup Computer Systems Co.,Ltd.
+000D87     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22, Alley 38, Lane 91, Sec. 1, Nei Hu
+				Taipei    114
+				TW
+
+10-78-D2   (hex)		Elitegroup Computer Systems Co.,Ltd.
+1078D2     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO. 239, Sec. 2, Ti Ding Blvd.
+				Taipei  Taiwan  11493
+				TW
+
+00-21-97   (hex)		Elitegroup Computer Systems Co.,Ltd.
+002197     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				NO.239, Sec. 2, Ti Ding Blvd.,
+				Taipei    11493
+				TW
+
+E4-F3-F5   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+E4F3F5     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+A0-8C-FD   (hex)		Hewlett Packard
+A08CFD     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+00-0E-03   (hex)		Emulex Corporation
+000E03     (base 16)		Emulex Corporation
+				3333 Susan Street
+				Costa Mesa  CA  92626
+				US
+
+00-CA-E5   (hex)		Cisco Systems, Inc
+00CAE5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-42-68   (hex)		Cisco Systems, Inc
+004268     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+48-83-C7   (hex)		Sagemcom Broadband SAS
+4883C7     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+40-16-3B   (hex)		Samsung Electronics Co.,Ltd
+40163B     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+44-65-0D   (hex)		Amazon Technologies Inc.
+44650D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+D4-F2-07   (hex)		DIAODIAO(Beijing)Technology CO.,Ltd
+D4F207     (base 16)		DIAODIAO(Beijing)Technology CO.,Ltd
+				48D Image Base, No 3 Guangqu Road, Chaoyang District, Beijing, China
+				Beijing    100124
+				CN
+
+D4-AD-2D   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D4AD2D     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+F0-8C-FB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F08CFB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+48-55-5F   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+48555F     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+FC-3F-7C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FC3F7C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-4C-4F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+384C4F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-BF-3F   (hex)		Shenzhen Lencotion Technology Co.,Ltd
+0CBF3F     (base 16)		Shenzhen Lencotion Technology Co.,Ltd
+				LongGang,Buji Xia Shuijing,Hubei Baofeng Lndustrial Area,2/F,TowerB
+				shenzhen  Guangdong  518112
+				CN
+
+50-FF-99   (hex)		IEEE Registration Authority
+50FF99     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+84-E3-23   (hex)		Green Wave Telecommunication SDN BHD
+84E323     (base 16)		Green Wave Telecommunication SDN BHD
+				8, 12, 9 - Menara Mutiara, Bangsar, Jalan Liku, Off Jalan Bangsar
+				Kuala Lumpur    59100
+				MY
+
+70-5A-9E   (hex)		Technicolor CH USA Inc.
+705A9E     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+04-A3-16   (hex)		Texas Instruments
+04A316     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+14-0C-5B   (hex)		PLNetworks
+140C5B     (base 16)		PLNetworks
+				B-613, Tancheonsang-ro 164(Sigma 2)
+				Seongnam-si  Bundang-gu, Gyeonggi-do  13631
+				KR
+
+00-17-06   (hex)		Techfaithwireless Communication Technology Limited.
+001706     (base 16)		Techfaithwireless Communication Technology Limited.
+				2/F M8 West No.1 Jiu Xian Qiao Dong Road,
+				Beijing    100016
+				CN
+
+FC-08-4A   (hex)		FUJITSU LIMITED
+FC084A     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+BC-98-89   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+BC9889     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+24-61-5A   (hex)		China Mobile Group Device Co.,Ltd.
+24615A     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+40-5E-E1   (hex)		Shenzhen H&T Intelligent Control Co.,Ltd.
+405EE1     (base 16)		Shenzhen H&T Intelligent Control Co.,Ltd.
+				D-Zone,10/F,Shenzhen Academy of Aerospace Technology,Hi-Tech Park at Nanshan District,Shenzhen,China 
+				Shenzhen    518000
+				CN
+
+00-25-78   (hex)		JSC Concern Sozvezdie
+002578     (base 16)		JSC Concern Sozvezdie
+				Plekhanovskaya st., 14
+				Voronezh    394018
+				RU
+
+30-B4-9E   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+30B49E     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-38-70   (hex)		Samsung Electronics Co.,Ltd
+C83870     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-55-3A   (hex)		QianGua Corp.
+1C553A     (base 16)		QianGua Corp.
+				Room 1106, block B,No.391,Gui Ping Road
+				Xu Hui District  ShangHai  200223
+				CN
+
+34-E7-0B   (hex)		HAN Networks Co., Ltd
+34E70B     (base 16)		HAN Networks Co., Ltd
+				5F,#37 Building,#8 Dongbeiwang Eest Road
+				Haidian District  Beijing  100193
+				CN
+
+00-78-88   (hex)		Cisco Systems, Inc
+007888     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+90-03-25   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+900325     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+98-E7-F5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+98E7F5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-5B-DA   (hex)		CliniCare LTD
+085BDA     (base 16)		CliniCare LTD
+				HaSadna 11 Suite 207
+				Ra'anana    4365006
+				IL
+
+1C-C0-35   (hex)		PLANEX COMMUNICATIONS INC.
+1CC035     (base 16)		PLANEX COMMUNICATIONS INC.
+				Planex Volta Bldg., 2-11-9 Ebisu-Nishi,Shibuya-ku,Tokyo 150-0021,Japan
+				Tokyo  Tokyo  150-0021
+				JP
+
+34-54-3C   (hex)		TAKAOKA TOKO CO.,LTD.
+34543C     (base 16)		TAKAOKA TOKO CO.,LTD.
+				8F,SIA TOYOSU PRIME SQUARE,5-6-36,Toyosu
+				Koto-ku  Tokyo  1350061
+				JP
+
+18-66-DA   (hex)		Dell Inc.
+1866DA     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+58-32-77   (hex)		Reliance Communications LLC
+583277     (base 16)		Reliance Communications LLC
+				555 Wireless Blvd
+				Hauppauge  NY  11788
+				US
+
+24-8A-07   (hex)		Mellanox Technologies, Inc.
+248A07     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+9C-9D-5D   (hex)		Raden Inc
+9C9D5D     (base 16)		Raden Inc
+				15 Maiden Lane
+				New York  NY  10038
+				US
+
+DC-4D-23   (hex)		MRV Comunications
+DC4D23     (base 16)		MRV Comunications
+				Hayetzira
+				Yokneam    614
+				IL
+
+00-23-B3   (hex)		Lyyn AB
+0023B3     (base 16)		Lyyn AB
+				IDEON Science Park
+				Lund    223 70
+				SE
+
+40-2E-28   (hex)		MiXTelematics
+402E28     (base 16)		MiXTelematics
+				Blaauwklip Office Park 2
+				Stellenbosch  Cape Province  7600
+				ZA
+
+6C-8F-B5   (hex)		Microsoft Mobile Oy
+6C8FB5     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+00-8E-73   (hex)		Cisco Systems, Inc
+008E73     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-C1   (hex)		Sony Interactive Entertainment Inc.
+0015C1     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+A0-9D-91   (hex)		SoundBridge
+A09D91     (base 16)		SoundBridge
+				#810, IT Convergence Industrial Bldg. 47, Gyeongdae-ro 17-Gil, Buk-gu,
+				Daegu    41566
+				KR
+
+40-B6-88   (hex)		LEGIC Identsystems AG
+40B688     (base 16)		LEGIC Identsystems AG
+				Binzackerstrasse 41
+				Wetzikon    8620
+				CH
+
+9C-D4-8B   (hex)		Innolux Technology Europe BV
+9CD48B     (base 16)		Innolux Technology Europe BV
+				Stationstraat 39G
+				Heerlen    6411NK
+				NL
+
+90-A6-2F   (hex)		NAVER
+90A62F     (base 16)		NAVER
+				NAVER Green Factory, 6, Buljeong-ro, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-867
+				KR
+
+C0-C5-22   (hex)		ARRIS Group, Inc.
+C0C522     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-9E-46   (hex)		Apple, Inc.
+1C9E46     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-E5-10   (hex)		Mechatro, Inc.
+C4E510     (base 16)		Mechatro, Inc.
+				169-28, Gasan Digital 2-ro, Geumcheon-Gu
+				Seoul    08500
+				KR
+
+18-A6-F7   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+18A6F7     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+00-35-1A   (hex)		Cisco Systems, Inc
+00351A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-AF-1F   (hex)		Cisco Systems, Inc
+00AF1F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+80-38-96   (hex)		SHARP Corporation
+803896     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+00-60-EC   (hex)		HERMARY OPTO ELECTRONICS INC.
+0060EC     (base 16)		HERMARY OPTO ELECTRONICS INC.
+				201-4050 GRAVELEY ST
+				BURNABY, BC V5C-3T6    
+				CA
+
+C0-CC-F8   (hex)		Apple, Inc.
+C0CCF8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-4F-DA   (hex)		Apple, Inc.
+9C4FDA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-89-AD   (hex)		Apple, Inc.
+8489AD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-3A-7A   (hex)		Roku, Inc.
+AC3A7A     (base 16)		Roku, Inc.
+				12980 Saratoga Ave
+				Saratoga    95070
+				US
+
+B8-3E-59   (hex)		Roku, Inc.
+B83E59     (base 16)		Roku, Inc.
+				12980 Saratoga Ave.
+				Saratoga  CA  95070
+				US
+
+DC-3A-5E   (hex)		Roku, Inc.
+DC3A5E     (base 16)		Roku, Inc.
+				12980 Saratoga Ave.
+				Saratoga  CA  95070
+				US
+
+00-1A-73   (hex)		Gemtek Technology Co., Ltd.
+001A73     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road, Hsinchu Industrial Park, Hukou,
+				Hsinchu    303
+				TW
+
+00-90-4B   (hex)		Gemtek Technology Co., Ltd.
+00904B     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road,
+				Hukou, Hsinchu,  Taiwan  30352
+				TW
+
+00-1A-7F   (hex)		GCI Science & Technology Co.,LTD
+001A7F     (base 16)		GCI Science & Technology Co.,LTD
+				No.381, Xingangzhong Road,
+				guangzhou  guangdong  510310
+				CN
+
+00-18-0F   (hex)		Nokia Danmark A/S
+00180F     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V  Denmark  1790V
+				DK
+
+C8-97-9F   (hex)		Nokia Corporation
+C8979F     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+EC-F3-5B   (hex)		Nokia Corporation
+ECF35B     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+54-44-08   (hex)		Nokia Corporation
+544408     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  Varsinais-Suomi  24101
+				FI
+
+3C-C2-43   (hex)		Nokia Corporation
+3CC243     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  NA  24101
+				FI
+
+00-21-FC   (hex)		Nokia Danmark A/S
+0021FC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1F-5D   (hex)		Nokia Danmark A/S
+001F5D     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1F-01   (hex)		Nokia Danmark A/S
+001F01     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1B-EE   (hex)		Nokia Danmark A/S
+001BEE     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-19-79   (hex)		Nokia Danmark A/S
+001979     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-25-D0   (hex)		Nokia Danmark A/S
+0025D0     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-24-D4   (hex)		FREEBOX SAS
+0024D4     (base 16)		FREEBOX SAS
+				8 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+34-7E-39   (hex)		Nokia Danmark A/S
+347E39     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-50-7F   (hex)		DrayTek Corp.
+00507F     (base 16)		DrayTek Corp.
+				26, Fushing Rd.
+				Hsinchu  Hukou  303
+				TW
+
+64-77-91   (hex)		Samsung Electronics Co.,Ltd
+647791     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-E6-E7   (hex)		Samsung Electronics Co.,Ltd
+9CE6E7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-02-98   (hex)		Samsung Electronics Co.,Ltd
+9C0298     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+28-98-7B   (hex)		Samsung Electronics Co.,Ltd
+28987B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-FA-3E   (hex)		Samsung Electronics Co.,Ltd
+54FA3E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+0C-89-10   (hex)		Samsung Electronics Co.,Ltd
+0C8910     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+78-AB-BB   (hex)		Samsung Electronics Co.,Ltd
+78ABBB     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+D8-C4-E9   (hex)		Samsung Electronics Co.,Ltd
+D8C4E9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-D1-1F   (hex)		Samsung Electronics Co.,Ltd
+BCD11F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-42-8F   (hex)		Samsung Electronics Co.,Ltd
+F4428F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-90-A2   (hex)		CyberTAN Technology Inc.
+0090A2     (base 16)		CyberTAN Technology Inc.
+				99, Park Avenue III
+				Hsinchu    12345
+				TW
+
+00-90-D6   (hex)		Crystal Group, Inc.
+0090D6     (base 16)		Crystal Group, Inc.
+				850 KACENA RD.
+				HIAWATHA  IA  52233
+				US
+
+44-6D-6C   (hex)		Samsung Electronics Co.,Ltd
+446D6C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-F4-6F   (hex)		Samsung Electronics Co.,Ltd
+00F46F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-71-5D   (hex)		Samsung Electronics Co.,Ltd
+0C715D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-80-DF   (hex)		Arcadyan Technology Corporation
+9C80DF     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+00-23-08   (hex)		Arcadyan Technology Corporation
+002308     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+88-03-55   (hex)		Arcadyan Technology Corporation
+880355     (base 16)		Arcadyan Technology Corporation
+				4F., No.9 , Park Avenue II
+				Hsinchu    300
+				TW
+
+34-BB-1F   (hex)		BlackBerry RTS
+34BB1F     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+40-6F-2A   (hex)		BlackBerry RTS
+406F2A     (base 16)		BlackBerry RTS
+				295 Phillip Street
+				Waterloo  Ontario  N2V 2S7
+				CA
+
+7C-1C-F1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C1CF1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-F5-57   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+78F557     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E0-28-61   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E02861     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-D0-4B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D0D04B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-00-31   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+480031     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-76-EA   (hex)		zte corporation
+D476EA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-17-5A   (hex)		Cisco Systems, Inc
+00175A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-96-D7   (hex)		AVM GmbH
+0896D7     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+50-6A-03   (hex)		NETGEAR
+506A03     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+10-0D-7F   (hex)		NETGEAR
+100D7F     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+50-4A-6E   (hex)		NETGEAR
+504A6E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+4C-09-D4   (hex)		Arcadyan Technology Corporation
+4C09D4     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+18-C0-86   (hex)		Broadcom
+18C086     (base 16)		Broadcom
+				5300 California Avenue
+				Irvine  CA  92617
+				US
+
+00-10-18   (hex)		Broadcom
+001018     (base 16)		Broadcom
+				16215 ALTON PARKWAY
+				IRVINE  CA  92619-7013
+				US
+
+C8-FF-28   (hex)		Liteon Technology Corporation
+C8FF28     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+B8-16-19   (hex)		ARRIS Group, Inc.
+B81619     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+B0-77-AC   (hex)		ARRIS Group, Inc.
+B077AC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+FC-B4-E6   (hex)		ASKEY COMPUTER CORP
+FCB4E6     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				TAIWAN  NEW TAIPEI  23585
+				TW
+
+00-19-2C   (hex)		ARRIS Group, Inc.
+00192C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-19-5E   (hex)		ARRIS Group, Inc.
+00195E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-1B   (hex)		ARRIS Group, Inc.
+001A1B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-66   (hex)		ARRIS Group, Inc.
+001A66     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-77   (hex)		ARRIS Group, Inc.
+001A77     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+64-ED-57   (hex)		ARRIS Group, Inc.
+64ED57     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A4-ED-4E   (hex)		ARRIS Group, Inc.
+A4ED4E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-21-1E   (hex)		ARRIS Group, Inc.
+00211E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-21-80   (hex)		ARRIS Group, Inc.
+002180     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1B-DD   (hex)		ARRIS Group, Inc.
+001BDD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-6B   (hex)		ARRIS Group, Inc.
+001D6B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-BE   (hex)		ARRIS Group, Inc.
+001DBE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-12-C9   (hex)		ARRIS Group, Inc.
+0012C9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-A2   (hex)		ARRIS Group, Inc.
+0023A2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-ED   (hex)		ARRIS Group, Inc.
+0023ED     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1B-52   (hex)		ARRIS Group, Inc.
+001B52     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1E-8D   (hex)		ARRIS Group, Inc.
+001E8D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-46-9A   (hex)		NETGEAR
+E0469A     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+30-46-9A   (hex)		NETGEAR
+30469A     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-24-93   (hex)		ARRIS Group, Inc.
+002493     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-41   (hex)		ARRIS Group, Inc.
+002641     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-D0   (hex)		ARRIS Group, Inc.
+0015D0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-96   (hex)		ARRIS Group, Inc.
+001596     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+04-E6-76   (hex)		AMPAK Technology, Inc.
+04E676     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road
+				Hsinchu    30352
+				TW
+
+00-22-F4   (hex)		AMPAK Technology, Inc.
+0022F4     (base 16)		AMPAK Technology, Inc.
+				No. 8-1, Nanyuan 2nd Rd.
+				Jhongli  Taoyuan  320
+				TW
+
+00-1D-BA   (hex)		Sony Corporation
+001DBA     (base 16)		Sony Corporation
+				Gotenyama Tec,5-1-12,
+				Shinagawa-ku  Tokyo  141-0001
+				JP
+
+00-24-BE   (hex)		Sony Corporation
+0024BE     (base 16)		Sony Corporation
+				Gotenyama Tec. 5-1-12
+				Shinagawa-ku  Tokyo  141-0001
+				JP
+
+00-0F-DE   (hex)		Sony Mobile Communications Inc
+000FDE     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+0C-FE-45   (hex)		Sony Interactive Entertainment Inc.
+0CFE45     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+20-16-D8   (hex)		Liteon Technology Corporation
+2016D8     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+E0-63-E5   (hex)		Sony Mobile Communications Inc
+E063E5     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+F8-D0-AC   (hex)		Sony Interactive Entertainment Inc.
+F8D0AC     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+24-21-AB   (hex)		Sony Mobile Communications Inc
+2421AB     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+B8-F9-34   (hex)		Sony Mobile Communications Inc
+B8F934     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+8C-64-22   (hex)		Sony Mobile Communications Inc
+8C6422     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+20-E5-64   (hex)		ARRIS Group, Inc.
+20E564     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+90-B1-34   (hex)		ARRIS Group, Inc.
+90B134     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-B7-F3   (hex)		ARRIS Group, Inc.
+40B7F3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1B-59   (hex)		Sony Mobile Communications Inc
+001B59     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-22-98   (hex)		Sony Mobile Communications Inc
+002298     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-17-E2   (hex)		ARRIS Group, Inc.
+0017E2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-16-75   (hex)		ARRIS Group, Inc.
+001675     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0C-E5   (hex)		ARRIS Group, Inc.
+000CE5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-03-E0   (hex)		ARRIS Group, Inc.
+0003E0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-D0-C9   (hex)		ADVANTECH CO., LTD.
+00D0C9     (base 16)		ADVANTECH CO., LTD.
+				FL. 4, NO.  108-3
+				TAIPEI  TAIPEI  TAIWAN
+				TW
+
+64-87-D7   (hex)		ADB Broadband Italia
+6487D7     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+E0-B2-F1   (hex)		FN-LINK TECHNOLOGY LIMITED
+E0B2F1     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				5th Floor, A Building, Haoye Logistics Park, Shugang Channel, Bao'an District,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+0C-4C-39   (hex)		MitraStar Technology Corp.
+0C4C39     (base 16)		MitraStar Technology Corp.
+				4F No.6 Innovation Road II
+				Hsin-Chu    300
+				TW
+
+74-88-8B   (hex)		ADB Broadband Italia
+74888B     (base 16)		ADB Broadband Italia
+				via Sarca 222
+				Milano    20126
+				IT
+
+00-8C-54   (hex)		ADB Broadband Italia
+008C54     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				US
+
+00-24-7B   (hex)		Actiontec Electronics, Inc
+00247B     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-04-E3   (hex)		Accton Technology Corp
+0004E3     (base 16)		Accton Technology Corp
+				No. 1 Creation Rd. III,
+				Hsinchu  Hsinchu  TAIWAN
+				TW
+
+00-10-B5   (hex)		Accton Technology Corp
+0010B5     (base 16)		Accton Technology Corp
+				NO.1, CREATION RD. III
+				HSINCHU 300    12345
+				TW
+
+00-19-74   (hex)		16063
+001974     (base 16)		16063
+				1F , No. 21, Yanfa 2nd Rd., SBIP
+				Hsinchu City  Hsinchu  300
+				TW
+
+E8-61-7E   (hex)		Liteon Technology Corporation
+E8617E     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+18-CF-5E   (hex)		Liteon Technology Corporation
+18CF5E     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+F0-27-2D   (hex)		Amazon Technologies Inc.
+F0272D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+84-D6-D0   (hex)		Amazon Technologies Inc.
+84D6D0     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+18-FE-34   (hex)		Espressif Inc.
+18FE34     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+38-22-9D   (hex)		ADB Broadband Italia
+38229D     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+A4-52-6F   (hex)		ADB Broadband Italia
+A4526F     (base 16)		ADB Broadband Italia
+				via Sarca 222
+				Milano    20126
+				IT
+
+60-5B-B4   (hex)		AzureWave Technology Inc.
+605BB4     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.,
+				New Taipei City  Taiwan  231
+				TW
+
+64-D9-54   (hex)		Taicang T&W Electronics
+64D954     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD, Lu Du,
+				Taicang  Jiangsu  215412
+				CN
+
+5C-36-B8   (hex)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+5C36B8     (base 16)		TCL King Electrical Appliances (Huizhou) Co., Ltd
+				7/F，TCL Multimedia Building, TCL International E City, No.1001 Zhongshanyuan Road, Nanshan
+				Shenzhen  Guangdong   518052
+				CN
+
+00-AA-01   (hex)		Intel Corporation
+00AA01     (base 16)		Intel Corporation
+				445
+				piscataway  NJ  08554
+				US
+
+98-5F-D3   (hex)		Microsoft Corporation
+985FD3     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+00-DA-55   (hex)		Cisco Systems, Inc
+00DA55     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-E3-BC   (hex)		TCT mobile ltd
+18E3BC     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+CC-1F-C4   (hex)		InVue
+CC1FC4     (base 16)		InVue
+				15015 Lancaster Hwy
+				Charlotte  NC  28277
+				US
+
+00-AA-00   (hex)		Intel Corporation
+00AA00     (base 16)		Intel Corporation
+				5200 NE ELAM YOUNG PARKWAY
+				HILLSBORO  OR  97124
+				US
+
+00-C2-C6   (hex)		Intel Corporate
+00C2C6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+5C-D2-E4   (hex)		Intel Corporate
+5CD2E4     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+28-B2-BD   (hex)		Intel Corporate
+28B2BD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-22-43   (hex)		AzureWave Technology Inc.
+002243     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd., Xindian
+				Taipei    231
+				TW
+
+00-00-6E   (hex)		Artisoft Inc.
+00006E     (base 16)		Artisoft Inc.
+				691 EAST RIVER ROAD
+				TUCSON  AZ  85704
+				US
+
+44-87-23   (hex)		HOYA SERVICE CORPORATION
+448723     (base 16)		HOYA SERVICE CORPORATION
+				4-10-2 Nakano
+				Nakano-ku  Tokyo  164-8545
+				JP
+
+D8-6C-02   (hex)		Huaqin Telecom Technology Co.,Ltd
+D86C02     (base 16)		Huaqin Telecom Technology Co.,Ltd
+				No.1 Building,399 Keyuan Road, Zhangjian Hi-Tech Park, Pudong New Area
+				Shanghai    201203
+				CN
+
+60-BE-B5   (hex)		Motorola Mobility LLC, a Lenovo Company
+60BEB5     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+F8-F1-B6   (hex)		Motorola Mobility LLC, a Lenovo Company
+F8F1B6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+3C-FD-FE   (hex)		Intel Corporate
+3CFDFE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A4-C4-94   (hex)		Intel Corporate
+A4C494     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+90-2E-1C   (hex)		Intel Corporate
+902E1C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A4-34-D9   (hex)		Intel Corporate
+A434D9     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+68-5D-43   (hex)		Intel Corporate
+685D43     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A0-36-9F   (hex)		Intel Corporate
+A0369F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+64-D4-DA   (hex)		Intel Corporate
+64D4DA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+40-25-C2   (hex)		Intel Corporate
+4025C2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+50-2D-A2   (hex)		Intel Corporate
+502DA2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+78-92-9C   (hex)		Intel Corporate
+78929C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+84-3A-4B   (hex)		Intel Corporate
+843A4B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+5C-51-4F   (hex)		Intel Corporate
+5C514F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A4-4E-31   (hex)		Intel Corporate
+A44E31     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+4C-EB-42   (hex)		Intel Corporate
+4CEB42     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+F8-16-54   (hex)		Intel Corporate
+F81654     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+60-6C-66   (hex)		Intel Corporate
+606C66     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+4C-80-93   (hex)		Intel Corporate
+4C8093     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+AC-72-89   (hex)		Intel Corporate
+AC7289     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+44-85-00   (hex)		Intel Corporate
+448500     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+0C-D2-92   (hex)		Intel Corporate
+0CD292     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+DC-A9-71   (hex)		Intel Corporate
+DCA971     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+58-94-6B   (hex)		Intel Corporate
+58946B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-24-D7   (hex)		Intel Corporate
+0024D7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-24-D6   (hex)		Intel Corporate
+0024D6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1D-E0   (hex)		Intel Corporate
+001DE0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+4C-79-BA   (hex)		Intel Corporate
+4C79BA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+84-A6-C8   (hex)		Intel Corporate
+84A6C8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+58-91-CF   (hex)		Intel Corporate
+5891CF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+0C-8B-FD   (hex)		Intel Corporate
+0C8BFD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-21-5C   (hex)		Intel Corporate
+00215C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-21-6B   (hex)		Intel Corporate
+00216B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-22-FB   (hex)		Intel Corporate
+0022FB     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-15-17   (hex)		Intel Corporate
+001517     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+A0-A8-CD   (hex)		Intel Corporate
+A0A8CD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+5C-C5-D4   (hex)		Intel Corporate
+5CC5D4     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1E-64   (hex)		Intel Corporate
+001E64     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+F4-F1-E1   (hex)		Motorola Mobility LLC, a Lenovo Company
+F4F1E1     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+9C-D9-17   (hex)		Motorola Mobility LLC, a Lenovo Company
+9CD917     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+90-68-C3   (hex)		Motorola Mobility LLC, a Lenovo Company
+9068C3     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+3C-19-7D   (hex)		Ericsson AB
+3C197D     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+B4-E1-0F   (hex)		Dell Inc.
+B4E10F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-22-19   (hex)		Dell Inc.
+002219     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+00-24-E8   (hex)		Dell Inc.
+0024E8     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock    78682
+				US
+
+B0-83-FE   (hex)		Dell Inc.
+B083FE     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock    78682
+				US
+
+34-17-EB   (hex)		Dell Inc.
+3417EB     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+F8-BC-12   (hex)		Dell Inc.
+F8BC12     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+18-A9-9B   (hex)		Dell Inc.
+18A99B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-13-72   (hex)		Dell Inc.
+001372     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-11-43   (hex)		Dell Inc.
+001143     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+4C-76-25   (hex)		Dell Inc.
+4C7625     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+44-A8-42   (hex)		Dell Inc.
+44A842     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-25-3C   (hex)		2Wire Inc
+00253C     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+34-EF-44   (hex)		2Wire Inc
+34EF44     (base 16)		2Wire Inc
+				1764 Automation Pkwy
+				San Jose  CA  95131
+				US
+
+B0-E7-54   (hex)		2Wire Inc
+B0E754     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+F0-1F-AF   (hex)		Dell Inc.
+F01FAF     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-18-8B   (hex)		Dell Inc.
+00188B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-08-74   (hex)		Dell Inc.
+000874     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+B8-E6-25   (hex)		2Wire Inc
+B8E625     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+00-1D-5A   (hex)		2Wire Inc
+001D5A     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San  Jose    95131
+				US
+
+1C-44-19   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+1C4419     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-35-3B   (hex)		Compal Broadband Networks, Inc.
+5C353B     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+28-FA-A0   (hex)		vivo Mobile Communication Co., Ltd.
+28FAA0     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+EC-DF-3A   (hex)		vivo Mobile Communication Co., Ltd.
+ECDF3A     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+F4-29-81   (hex)		vivo Mobile Communication Co., Ltd.
+F42981     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+84-F6-FA   (hex)		Miovision Technologies Incorporated
+84F6FA     (base 16)		Miovision Technologies Incorporated
+				148 Manitou Drive
+				KITCHENER  Ontario  N2C1L4
+				CA
+
+70-10-6F   (hex)		Hewlett Packard Enterprise
+70106F     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+F8-E7-1E   (hex)		Ruckus Wireless
+F8E71E     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+08-86-3B   (hex)		Belkin International Inc.
+08863B     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+24-7C-4C   (hex)		Herman Miller
+247C4C     (base 16)		Herman Miller
+				Unit 2, 2/F The Factory, 1 Yip Fat Street
+				Wong Chuk Hang    -
+				HK
+
+E4-6F-13   (hex)		D-Link International
+E46F13     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+2C-56-DC   (hex)		ASUSTek COMPUTER INC.
+2C56DC     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+00-31-46   (hex)		Juniper Networks
+003146     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-60-4C   (hex)		Sagemcom Broadband SAS
+00604C     (base 16)		Sagemcom Broadband SAS
+				27 RUE LEBLANC
+				CEDEX 15  PARIS  75512
+				FR
+
+00-1F-95   (hex)		Sagemcom Broadband SAS
+001F95     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+00-23-48   (hex)		Sagemcom Broadband SAS
+002348     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+00-26-91   (hex)		Sagemcom Broadband SAS
+002691     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+98-8B-5D   (hex)		Sagemcom Broadband SAS
+988B5D     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison    92848
+				FR
+
+90-01-3B   (hex)		Sagemcom Broadband SAS
+90013B     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+7C-03-4C   (hex)		Sagemcom Broadband SAS
+7C034C     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+6C-2E-85   (hex)		Sagemcom Broadband SAS
+6C2E85     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+94-FE-F4   (hex)		Sagemcom Broadband SAS
+94FEF4     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+34-B1-F7   (hex)		Texas Instruments
+34B1F7     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+2C-FD-37   (hex)		Blue Calypso, Inc.
+2CFD37     (base 16)		Blue Calypso, Inc.
+				101 West Renner RD Suite 280
+				Richardson  TX  75082
+				US
+
+0C-61-27   (hex)		Actiontec Electronics, Inc
+0C6127     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+3C-D9-2B   (hex)		Hewlett Packard
+3CD92B     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+78-DE-E4   (hex)		Texas Instruments
+78DEE4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-33   (hex)		Texas Instruments
+001833     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-34   (hex)		Texas Instruments
+001834     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-E3   (hex)		Texas Instruments
+0017E3     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-18-30   (hex)		Texas Instruments
+001830     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-23-D4   (hex)		Texas Instruments
+0023D4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+BC-F6-85   (hex)		D-Link International
+BCF685     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+78-54-2E   (hex)		D-Link International
+78542E     (base 16)		D-Link International
+				1 Internal Business Park, #03-12.
+				SINGAPORE  Singapore  609917
+				TW
+
+C4-A8-1D   (hex)		D-Link International
+C4A81D     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,
+				SINGAPORE  Singapore  609917
+				SG
+
+00-21-91   (hex)		D-Link Corporation
+002191     (base 16)		D-Link Corporation
+				NO.289, Sinhu 3rd Rd.,
+				Neihu District,  Taipei City  114
+				TW
+
+AC-F1-DF   (hex)		D-Link International
+ACF1DF     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+C0-E4-22   (hex)		Texas Instruments
+C0E422     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+D0-07-90   (hex)		Texas Instruments
+D00790     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+3C-7D-B1   (hex)		Texas Instruments
+3C7DB1     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+F4-FC-32   (hex)		Texas Instruments
+F4FC32     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+90-D7-EB   (hex)		Texas Instruments
+90D7EB     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-E8   (hex)		Texas Instruments
+0017E8     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-17-83   (hex)		Texas Instruments
+001783     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-F8-71   (hex)		DGS Denmark A/S
+00F871     (base 16)		DGS Denmark A/S
+				Kongebakken 9
+				Smørum    2765
+				DK
+
+24-35-CC   (hex)		Zhongshan Scinan Internet of Things Co.,Ltd.
+2435CC     (base 16)		Zhongshan Scinan Internet of Things Co.,Ltd.
+				15/F Bldg 1·Dezhong Plaza Torch Development Zone Zhongshan·Guangdong
+				ZhongShan  GuangDong  528437
+				CN
+
+2C-30-33   (hex)		NETGEAR
+2C3033     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+CC-46-D6   (hex)		Cisco Systems, Inc
+CC46D6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-41-D2   (hex)		Cisco Systems, Inc
+0041D2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-AB-00   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2CAB00     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-CA-7B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A8CA7B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-44-34   (hex)		Shenzhen TINNO Mobile Technology Corp.
+BC4434     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+04-BF-6D   (hex)		Zyxel Communications Corporation
+04BF6D     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+F8-8F-CA   (hex)		Google, Inc.
+F88FCA     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View    94043
+				US
+
+38-98-D8   (hex)		MERITECH CO.,LTD
+3898D8     (base 16)		MERITECH CO.,LTD
+				52-17 Sinjeon-Ro 41beon-gil
+				Giheung-gu, Yongin-City Kyungki-do    446-599
+				KR
+
+94-86-CD   (hex)		SEOUL ELECTRONICS&TELECOM
+9486CD     (base 16)		SEOUL ELECTRONICS&TELECOM
+				709, Namkwangcentrex 440-4, Cheongcheon-dong, 
+				Bupyeong-gu  Incheon  403-030
+				KR
+
+38-97-D6   (hex)		Hangzhou H3C Technologies Co., Limited
+3897D6     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+1C-A7-70   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+1CA770     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit A 13-16/F,Skyworth Bldg., Gaoxin Ave.1.S.,Nanshan District
+				ShenZhen  GuangDong  518057
+				CN
+
+44-19-B6   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+4419B6     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+68-DB-CA   (hex)		Apple, Inc.
+68DBCA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-66-98   (hex)		Apple, Inc.
+086698     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-54-36   (hex)		Apple, Inc.
+BC5436     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-4B-ED   (hex)		Apple, Inc.
+044BED     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-8D-C1   (hex)		Apple, Inc.
+6C8DC1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-AC-FB   (hex)		Crouzet Automatismes
+84ACFB     (base 16)		Crouzet Automatismes
+				2 rue du docteur Abel
+				Valence  France  26902
+				FR
+
+7C-BB-8A   (hex)		Nintendo Co., Ltd.
+7CBB8A     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+FC-FF-AA   (hex)		IEEE Registration Authority
+FCFFAA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-D7-46   (hex)		Apple, Inc.
+0CD746     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-A3-7D   (hex)		Apple, Inc.
+60A37D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-A2-5E   (hex)		Juniper Networks
+88A25E     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+54-1E-56   (hex)		Juniper Networks
+541E56     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+88-96-B6   (hex)		Global Fire Equipment S.A.
+8896B6     (base 16)		Global Fire Equipment S.A.
+				Sitio dos Barrabés, Armazém Nave Y,
+				São Brás de Alportel  Faro  8150-016
+				PT
+
+88-B8-D0   (hex)		Dongguan Koppo Electronic Co.,Ltd
+88B8D0     (base 16)		Dongguan Koppo Electronic Co.,Ltd
+				No.2, Third Road, Buxinji Industrial Area, Guanjingtou Village, Fenggang Town, Dongguan City, Guangdong Province, China
+				Dongguan    523705
+				CN
+
+60-19-71   (hex)		ARRIS Group, Inc.
+601971     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-CA-B8   (hex)		Dell Inc.
+F8CAB8     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-11-11   (hex)		Intel Corporation
+001111     (base 16)		Intel Corporation
+				2111 NE 25th Avenue
+				Hillsboro  OR  97124
+				US
+
+00-13-02   (hex)		Intel Corporate
+001302     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+6C-CA-08   (hex)		ARRIS Group, Inc.
+6CCA08     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+78-71-9C   (hex)		ARRIS Group, Inc.
+78719C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D4-05-98   (hex)		ARRIS Group, Inc.
+D40598     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-33-81   (hex)		ARRIS Group, Inc.
+E83381     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+8C-7F-3B   (hex)		ARRIS Group, Inc.
+8C7F3B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-57-1A   (hex)		ARRIS Group, Inc.
+5C571A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-89-2C   (hex)		ARRIS Group, Inc.
+E8892C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+94-87-7C   (hex)		ARRIS Group, Inc.
+94877C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-70-09   (hex)		ARRIS Group, Inc.
+407009     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+08-3E-0C   (hex)		ARRIS Group, Inc.
+083E0C     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-36-E4   (hex)		ARRIS Group, Inc.
+3C36E4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-1B-68   (hex)		ARRIS Group, Inc.
+1C1B68     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-04-23   (hex)		Intel Corporation
+000423     (base 16)		Intel Corporation
+				M/S:  JF3-420
+				Hillsboro  OR  97124
+				US
+
+20-73-55   (hex)		ARRIS Group, Inc.
+207355     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-ED-A5   (hex)		ARRIS Group, Inc.
+F8EDA5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+54-65-DE   (hex)		ARRIS Group, Inc.
+5465DE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+58-AC-78   (hex)		Cisco Systems, Inc
+58AC78     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+78-0A-C7   (hex)		Baofeng TV Co., Ltd.
+780AC7     (base 16)		Baofeng TV Co., Ltd.
+				Room 2D, Building 5D, Nanshan District Software Industry Base
+				ShenZhen  GuangDong  518000
+				CN
+
+00-0D-0B   (hex)		BUFFALO.INC
+000D0B     (base 16)		BUFFALO.INC
+				MELCO HI-TECH CENTER,
+				NAGOYA    457-8520
+				JP
+
+00-1D-73   (hex)		BUFFALO.INC
+001D73     (base 16)		BUFFALO.INC
+				15,Shibata Hondori 4-chome,
+				Nagoya  Aichi Pref.  457-8520
+				JP
+
+00-16-01   (hex)		BUFFALO.INC
+001601     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+74-03-BD   (hex)		BUFFALO.INC
+7403BD     (base 16)		BUFFALO.INC
+				 AKAMONDORI Bldg, 30-20, Ohsu 3-chome,
+				Minami-ku, Nagoya  Aichi Pref.  457-8520
+				JP
+
+B8-FC-9A   (hex)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+B8FC9A     (base 16)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+				,Le Shi Building, No.105 Yaojiayuan Road,Chaoyang District,Beijing,China
+				beijing  beijing  100025
+				CN
+
+A4-5D-36   (hex)		Hewlett Packard
+A45D36     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+F0-92-1C   (hex)		Hewlett Packard
+F0921C     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+A0-48-1C   (hex)		Hewlett Packard
+A0481C     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+A0-1D-48   (hex)		Hewlett Packard
+A01D48     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+40-A8-F0   (hex)		Hewlett Packard
+40A8F0     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+88-51-FB   (hex)		Hewlett Packard
+8851FB     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+08-2E-5F   (hex)		Hewlett Packard
+082E5F     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+E4-11-5B   (hex)		Hewlett Packard
+E4115B     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+28-92-4A   (hex)		Hewlett Packard
+28924A     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+28-80-23   (hex)		Hewlett Packard
+288023     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+CC-3E-5F   (hex)		Hewlett Packard
+CC3E5F     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D8-9D-67   (hex)		Hewlett Packard
+D89D67     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-14-C2   (hex)		Hewlett Packard
+0014C2     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-80-5F   (hex)		Hewlett Packard
+00805F     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-18-FE   (hex)		Hewlett Packard
+0018FE     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-1A-4B   (hex)		Hewlett Packard
+001A4B     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-24-81   (hex)		Hewlett Packard
+002481     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-0F-61   (hex)		Hewlett Packard
+000F61     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+48-0F-CF   (hex)		Hewlett Packard
+480FCF     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D4-0B-1A   (hex)		HTC Corporation
+D40B1A     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd.
+				Taoyuan County  Taiwan  330
+				TW
+
+94-53-30   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+945330     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+A0-8D-16   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A08D16     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+4C-D0-8A   (hex)		HUMAX Co., Ltd.
+4CD08A     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village,216,Hwangsaeul-ro,
+				Seongnam-si  Gyeonggi-do  463875
+				KR
+
+CC-4E-EC   (hex)		HUMAX Co., Ltd.
+CC4EEC     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bundang-gu,
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+40-3D-EC   (hex)		HUMAX Co., Ltd.
+403DEC     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bundang-gu,
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+EC-4D-47   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC4D47     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-40-44   (hex)		RackTop Systems Inc.
+C44044     (base 16)		RackTop Systems Inc.
+				11840 W Market Pl Suite K
+				Fulton  MD  20759
+				US
+
+4C-A1-61   (hex)		Rain Bird Corporation
+4CA161     (base 16)		Rain Bird Corporation
+				970 West Sierra Madre Ave.
+				AZUSA  CA  91702
+				US
+
+8C-AB-8E   (hex)		Shanghai Feixun Communication Co.,Ltd.
+8CAB8E     (base 16)		Shanghai Feixun Communication Co.,Ltd.
+				No.3666,Sixian Rd.,Songjiang District,Shanghai,P.R.China
+				Shanghai  Shanghai  201616
+				CN
+
+FC-64-BA   (hex)		Xiaomi Communications Co Ltd
+FC64BA     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+90-60-F1   (hex)		Apple, Inc.
+9060F1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-D1-11   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F8D111     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+B0-48-7A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B0487A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+94-0C-6D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+940C6D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518000
+				CN
+
+A4-51-6F   (hex)		Microsoft Mobile Oy
+A4516F     (base 16)		Microsoft Mobile Oy
+				Keilalahdentie 4
+				Espoo    02150
+				FI
+
+54-27-58   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+542758     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+00-24-2B   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00242B     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+08-18-1A   (hex)		zte corporation
+08181A     (base 16)		zte corporation
+				12/F ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  GUANGDONG  518057
+				CN
+
+00-1E-73   (hex)		zte corporation
+001E73     (base 16)		zte corporation
+				12/F ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District,
+				Shenzhen  GUANGDONG  518057
+				CN
+
+00-15-EB   (hex)		zte corporation
+0015EB     (base 16)		zte corporation
+				5/F,A Wing,ZTE Plaza,Keji Road South,Hi-Tech Industrial Park,Nanshan District
+				Shenzhen    518057
+				US
+
+00-1C-25   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001C25     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-19-7E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00197E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+90-FB-A6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+90FBA6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+44-37-E6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+4437E6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+CC-AF-78   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+CCAF78     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+F4-B7-E2   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+F4B7E2     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+64-70-02   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+647002     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan,
+				Shenzhen  Guangdong Province,  518057
+				CN
+
+10-FE-ED   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+10FEED     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park
+				Shenzhen  Guangdong  518057
+				CN
+
+64-56-01   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+645601     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+F0-27-65   (hex)		Murata Manufacturing Co., Ltd.
+F02765     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+5C-F8-A1   (hex)		Murata Manufacturing Co., Ltd.
+5CF8A1     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+44-A7-CF   (hex)		Murata Manufacturing Co., Ltd.
+44A7CF     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+00-13-E0   (hex)		Murata Manufacturing Co., Ltd.
+0013E0     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+EC-26-CA   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+EC26CA     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+94-71-AC   (hex)		TCT mobile ltd
+9471AC     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+2C-08-8C   (hex)		HUMAX Co., Ltd.
+2C088C     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+1C-99-4C   (hex)		Murata Manufacturing Co., Ltd.
+1C994C     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+F4-55-9C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4559C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+80-B6-86   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80B686     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+10-C6-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+10C61F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+CC-96-A0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CC96A0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+F8-01-13   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F80113     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+A4-99-47   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A49947     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, 
+				Shenzhen  Guangdong  518057
+				CN
+
+C8-D1-5E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C8D15E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+78-59-68   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+785968     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C0-70-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C07009     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+80-38-BC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8038BC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-07-2F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4072F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-8E-92   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F48E92     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-66-4B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00664B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-C1-72   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9CC172     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-7F-3C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+247F3C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+58-1F-28   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+581F28     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-CB-30   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ECCB30     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-DC-F9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4DCF9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-87-30   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+308730     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+C0-57-BC   (hex)		Avaya Inc
+C057BC     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+64-A7-DD   (hex)		Avaya Inc
+64A7DD     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+24-1F-A0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+241FA0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-C5-8A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+18C58A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+08-00-28   (hex)		Texas Instruments
+080028     (base 16)		Texas Instruments
+				12500 TI Boulevard
+				Dallas    75243
+				US
+
+40-5F-C2   (hex)		Texas Instruments
+405FC2     (base 16)		Texas Instruments
+				12500 TI Boulevard
+				Dallas  TX  75243
+				US
+
+E0-E5-CF   (hex)		Texas Instruments
+E0E5CF     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+68-DF-DD   (hex)		Xiaomi Communications Co Ltd
+68DFDD     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+70-54-F5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7054F5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+DC-D2-FC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DCD2FC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+90-17-AC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9017AC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+34-CD-BE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+34CDBE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+D8-49-0B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D8490B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen    518129
+				CN
+
+44-32-2A   (hex)		Avaya Inc
+44322A     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-38-EE   (hex)		Avaya Inc
+7038EE     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-30-18   (hex)		Avaya Inc
+703018     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+9C-28-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C28EF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+EC-24-B8   (hex)		Texas Instruments
+EC24B8     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+7C-EC-79   (hex)		Texas Instruments
+7CEC79     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+68-9E-19   (hex)		Texas Instruments
+689E19     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+20-CD-39   (hex)		Texas Instruments
+20CD39     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B4-99-4C   (hex)		Texas Instruments
+B4994C     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A4-25-1B   (hex)		Avaya Inc
+A4251B     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+64-6A-52   (hex)		Avaya Inc
+646A52     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-10-0B   (hex)		Cisco Systems, Inc
+00100B     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-17-3B   (hex)		Cisco Systems, Inc
+00173B     (base 16)		Cisco Systems, Inc
+				170 West Tasman Dr.
+				San Jose  CA  95134-1706
+				US
+
+04-DA-D2   (hex)		Cisco Systems, Inc
+04DAD2     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F0-29-29   (hex)		Cisco Systems, Inc
+F02929     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+20-BB-C0   (hex)		Cisco Systems, Inc
+20BBC0     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+4C-4E-35   (hex)		Cisco Systems, Inc
+4C4E35     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+98-FA-E3   (hex)		Xiaomi Communications Co Ltd
+98FAE3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+F0-B4-29   (hex)		Xiaomi Communications Co Ltd
+F0B429     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-50-80   (hex)		Cisco Systems, Inc
+005080     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-50-73   (hex)		Cisco Systems, Inc
+005073     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-90-0C   (hex)		Cisco Systems, Inc
+00900C     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-90-5F   (hex)		Cisco Systems, Inc
+00905F     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-E0-F7   (hex)		Cisco Systems, Inc
+00E0F7     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-1B-D7   (hex)		Cisco SPVTG
+001BD7     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-60-83   (hex)		Cisco Systems, Inc
+006083     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-60-09   (hex)		Cisco Systems, Inc
+006009     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-06-7C   (hex)		Cisco Systems, Inc
+00067C     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-7B   (hex)		Cisco Systems, Inc
+00107B     (base 16)		Cisco Systems, Inc
+				170 W.TASMAN DR.-SJA-2
+				SAN JOSE  CA  95134-1706
+				US
+
+00-50-E2   (hex)		Cisco Systems, Inc
+0050E2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E4-D3-F1   (hex)		Cisco Systems, Inc
+E4D3F1     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+84-78-AC   (hex)		Cisco Systems, Inc
+8478AC     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-90-A6   (hex)		Cisco Systems, Inc
+0090A6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-90-86   (hex)		Cisco Systems, Inc
+009086     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-8C   (hex)		ASUSTek COMPUTER INC.
+00248C     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+00-23-54   (hex)		ASUSTek COMPUTER INC.
+002354     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+1C-87-2C   (hex)		ASUSTek COMPUTER INC.
+1C872C     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.., Peitou,
+				Taipei    112
+				TW
+
+60-18-2E   (hex)		ShenZhen Protruly Electronic Ltd co.
+60182E     (base 16)		ShenZhen Protruly Electronic Ltd co.
+				ShenNan Road 1004
+				Shen Zhen  GuangDong  518000
+				CN
+
+C4-14-3C   (hex)		Cisco Systems, Inc
+C4143C     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+3C-08-F6   (hex)		Cisco Systems, Inc
+3C08F6     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-1E-8C   (hex)		ASUSTek COMPUTER INC.
+001E8C     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou
+				Taipei    112
+				TW
+
+00-13-D4   (hex)		ASUSTek COMPUTER INC.
+0013D4     (base 16)		ASUSTek COMPUTER INC.
+				No.5 Shing Yeh Street
+				Tao Yuan Hsien    333
+				TW
+
+20-CF-30   (hex)		ASUSTek COMPUTER INC.
+20CF30     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+BC-16-65   (hex)		Cisco Systems, Inc
+BC1665     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F8-72-EA   (hex)		Cisco Systems, Inc
+F872EA     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+D0-C7-89   (hex)		Cisco Systems, Inc
+D0C789     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F8-4F-57   (hex)		Cisco Systems, Inc
+F84F57     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+50-1C-BF   (hex)		Cisco Systems, Inc
+501CBF     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-00-B4   (hex)		Cisco Systems, Inc
+B000B4     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+54-4A-00   (hex)		Cisco Systems, Inc
+544A00     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-E1-6D   (hex)		Cisco Systems, Inc
+00E16D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+78-BA-F9   (hex)		Cisco Systems, Inc
+78BAF9     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-22-CE   (hex)		Cisco SPVTG
+0022CE     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30042
+				US
+
+E0-D1-73   (hex)		Cisco Systems, Inc
+E0D173     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E0-89-9D   (hex)		Cisco Systems, Inc
+E0899D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+C4-72-95   (hex)		Cisco Systems, Inc
+C47295     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+7C-69-F6   (hex)		Cisco Systems, Inc
+7C69F6     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+78-DA-6E   (hex)		Cisco Systems, Inc
+78DA6E     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B8-78-2E   (hex)		Apple, Inc.
+B8782E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-05-02   (hex)		Apple, Inc.
+000502     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-0A-95   (hex)		Apple, Inc.
+000A95     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-BD-C8   (hex)		Cisco Systems, Inc
+34BDC8     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+DC-EB-94   (hex)		Cisco Systems, Inc
+DCEB94     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+84-B5-17   (hex)		Cisco Systems, Inc
+84B517     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+1C-6E-4C   (hex)		Logistic Service & Engineering Co.,Ltd
+1C6E4C     (base 16)		Logistic Service & Engineering Co.,Ltd
+				Unit N,9/F,Valiant Ind. Ctr.,2-12 Au Pui Wan St.,Fotan,Shatin,N.T.,Hong Kong
+				Hong Kong    00000
+				HK
+
+00-0F-66   (hex)		Cisco-Linksys, LLC
+000F66     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+24-37-4C   (hex)		Cisco SPVTG
+24374C     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+18-8B-9D   (hex)		Cisco Systems, Inc
+188B9D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E4-AA-5D   (hex)		Cisco Systems, Inc
+E4AA5D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F4-5F-D4   (hex)		Cisco SPVTG
+F45FD4     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+2C-AB-A4   (hex)		Cisco SPVTG
+2CABA4     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-26-4A   (hex)		Apple, Inc.
+00264A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-1E-64   (hex)		Apple, Inc.
+041E64     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-11-24   (hex)		Apple, Inc.
+001124     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-22-41   (hex)		Apple, Inc.
+002241     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-C5-37   (hex)		Apple, Inc.
+7CC537     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-CA-39   (hex)		Apple, Inc.
+78CA39     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-E7-F4   (hex)		Apple, Inc.
+18E7F4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-CD-60   (hex)		Apple, Inc.
+70CD60     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-7B-9D   (hex)		Apple, Inc.
+8C7B9D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-9E-3F   (hex)		Apple, Inc.
+D89E3F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-C7-5D   (hex)		Apple, Inc.
+B8C75D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-74-C2   (hex)		Apple, Inc.
+0C74C2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-30-04   (hex)		Apple, Inc.
+403004     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-29-99   (hex)		Apple, Inc.
+842999     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-E2-F5   (hex)		Apple, Inc.
+74E2F5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-C9-7A   (hex)		Apple, Inc.
+E0C97A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-A8-6D   (hex)		Apple, Inc.
+68A86D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-C3-A1   (hex)		Apple, Inc.
+7CC3A1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-73-CB   (hex)		Apple, Inc.
+7073CB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-84-0D   (hex)		Apple, Inc.
+90840D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-06-88   (hex)		Apple, Inc.
+E80688     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-85-2F   (hex)		Apple, Inc.
+EC852F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-F4-B9   (hex)		Apple, Inc.
+00F4B9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-95-AE   (hex)		Apple, Inc.
+5C95AE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-03-D8   (hex)		Apple, Inc.
+9803D8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-C5-47   (hex)		Apple, Inc.
+60C547     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-5B-35   (hex)		Apple, Inc.
+685B35     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-B4-3A   (hex)		Apple, Inc.
+2CB43A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-9C-70   (hex)		Apple, Inc.
+689C70     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-0F-4A   (hex)		Apple, Inc.
+380F4A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-10-E4   (hex)		Apple, Inc.
+3010E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-86-DD   (hex)		Apple, Inc.
+A886DD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-4C-0C   (hex)		Apple, Inc.
+444C0C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-F0-AB   (hex)		Apple, Inc.
+B4F0AB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-92-9F   (hex)		Apple, Inc.
+80929F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-04-EB   (hex)		Apple, Inc.
+9C04EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-96-9D   (hex)		Apple, Inc.
+5C969D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-92-17   (hex)		Apple, Inc.
+609217     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-B1-53   (hex)		Apple, Inc.
+84B153     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-66-78   (hex)		Apple, Inc.
+E06678     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-D7-05   (hex)		Apple, Inc.
+48D705     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-15-52   (hex)		Apple, Inc.
+041552     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-78-5F   (hex)		Apple, Inc.
+CC785F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-CB-87   (hex)		Apple, Inc.
+88CB87     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-C1-F1   (hex)		Apple, Inc.
+F0C1F1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-38-35   (hex)		Apple, Inc.
+843835     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-00-6D   (hex)		Apple, Inc.
+8C006D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-96-8A   (hex)		Apple, Inc.
+A8968A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-1B-A1   (hex)		Apple, Inc.
+F41BA1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-D9-C7   (hex)		Apple, Inc.
+60D9C7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-AB-8E   (hex)		Apple, Inc.
+3CAB8E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-27-93   (hex)		Apple, Inc.
+F82793     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-72-40   (hex)		Apple, Inc.
+907240     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-8D-6C   (hex)		Apple, Inc.
+908D6C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-09-8A   (hex)		Apple, Inc.
+B8098A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-7C-5F   (hex)		Apple, Inc.
+4C7C5F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-64-4B   (hex)		Apple, Inc.
+68644B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-1E-E7   (hex)		Apple, Inc.
+C81EE7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-31-35   (hex)		Apple, Inc.
+A43135     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-D9-3C   (hex)		Apple, Inc.
+68D93C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-F7-6F   (hex)		Apple, Inc.
+00F76F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C8-85-50   (hex)		Apple, Inc.
+C88550     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-14-A6   (hex)		Apple, Inc.
+7014A6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-5A-EB   (hex)		Apple, Inc.
+985AEB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-D7-5F   (hex)		Apple, Inc.
+78D75F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E0-B5-2D   (hex)		Apple, Inc.
+E0B52D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-94-F8   (hex)		Apple, Inc.
+6C94F8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-CE-CD   (hex)		Apple, Inc.
+C0CECD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-4B-2A   (hex)		Cisco SPVTG
+F44B2A     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+74-6F-19   (hex)		ICARVISIONS (SHENZHEN) TECHNOLOGY CO., LTD.
+746F19     (base 16)		ICARVISIONS (SHENZHEN) TECHNOLOGY CO., LTD.
+				6F-1 ,Block D,Building 2#, Hongwan XinCun Ming JinHai Industry Area, Gushu Community, Xixiang Street, BaoAn District
+				Shenzhen  Guangdong  518000
+				CN
+
+2C-AE-2B   (hex)		Samsung Electronics Co.,Ltd
+2CAE2B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-AD-F1   (hex)		GOPEACE Inc.
+C4ADF1     (base 16)		GOPEACE Inc.
+				Woolim Bldg B-916, 14 Sagimakgol-ro 45beon-gil, Jungwon-gu
+				Seongnam  Gyeonggi  13209
+				KR
+
+58-FC-73   (hex)		Arria Live Media, Inc.
+58FC73     (base 16)		Arria Live Media, Inc.
+				2388 NE Lindsey Drive
+				Hillsboro  OR  97124
+				US
+
+0C-1A-10   (hex)		Acoustic Stream
+0C1A10     (base 16)		Acoustic Stream
+				3213 W Wheeler Street
+				Seattle  WA  98199
+				US
+
+C4-EF-70   (hex)		Home Skinovations
+C4EF70     (base 16)		Home Skinovations
+				Tavor building POB 533
+				Yokneam  Israel  2069206
+				IL
+
+5C-E3-B6   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+5CE3B6     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+7C-5A-67   (hex)		JNC Systems, Inc.
+7C5A67     (base 16)		JNC Systems, Inc.
+				#611, Gyeonggi Venture Yeonsung University
+				Anyang-si  Gyeonggi-do  430731
+				KR
+
+A0-F9-E0   (hex)		VIVATEL COMPANY LIMITED
+A0F9E0     (base 16)		VIVATEL COMPANY LIMITED
+				36/F,Tower Two
+				Causeway Bay  Causeway Bay  999077
+				HK
+
+C8-69-CD   (hex)		Apple, Inc.
+C869CD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-B8-05   (hex)		Apple, Inc.
+A4B805     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-C9-9B   (hex)		Tesorion Nederland B.V.
+90C99B     (base 16)		Tesorion Nederland B.V.
+				Auke Vleerstraat 6-D
+				Enschede    7521 PG
+				NL
+
+5C-AD-CF   (hex)		Apple, Inc.
+5CADCF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+08-0A-4E   (hex)		Planet Bingo® — 3rd Rock Gaming®
+080A4E     (base 16)		Planet Bingo® — 3rd Rock Gaming®
+				75190 Gerald Ford Dr.
+				Palm Desert  CA  92211
+				US
+
+B4-9D-0B   (hex)		BQ
+B49D0B     (base 16)		BQ
+				Sofia, 10
+				Las Rozas de Madrid  Madrid  28230
+				ES
+
+3C-8C-F8   (hex)		TRENDnet, Inc.
+3C8CF8     (base 16)		TRENDnet, Inc.
+				20675 Manhattan Place
+				Torrance  CA  90501
+				US
+
+E8-13-63   (hex)		Comstock RD, Inc.
+E81363     (base 16)		Comstock RD, Inc.
+				4415 Mason St
+				Ashton  ID  83406
+				US
+
+74-18-65   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+741865     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F NO.1555 Kongjiang RD
+				  Shanghai  200092
+				CN
+
+BC-6C-21   (hex)		Apple, Inc.
+BC6C21     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-C3-72   (hex)		TSUZUKI DENKI
+F8C372     (base 16)		TSUZUKI DENKI
+				shinbashi 6-19-15
+				mainato-ku  tokyo-to  105-8665
+				JP
+
+D4-72-08   (hex)		Bragi GmbH
+D47208     (base 16)		Bragi GmbH
+				Herzog-Heinrich-Strasse 20
+				Munich  Bavaria  80336
+				DE
+
+A8-72-85   (hex)		IDT, INC.
+A87285     (base 16)		IDT, INC.
+				6024 SILVER CREEK VALLEY RD
+				SAN JOSE  CA  95138
+				US
+
+78-05-41   (hex)		Queclink Wireless Solutions Co., Ltd
+780541     (base 16)		Queclink Wireless Solutions Co., Ltd
+				Room 501, Building 9, No.99 Tianzhou Road
+				shanghai  shanghai  200233
+				CN
+
+04-41-69   (hex)		GoPro
+044169     (base 16)		GoPro
+				3000 Clearview Way
+				San Mateo  CA  94402
+				US
+
+C0-2D-EE   (hex)		Cuff
+C02DEE     (base 16)		Cuff
+				232 Townsend St
+				San Francisco  CA  94107
+				US
+
+6C-EB-B2   (hex)		Dongguan Sen DongLv Electronics Co.,Ltd
+6CEBB2     (base 16)		Dongguan Sen DongLv Electronics Co.,Ltd
+				Nanjiang RD 111st,Daning
+				Dongguan  Guangdong  523930
+				
+
+3C-7A-8A   (hex)		ARRIS Group, Inc.
+3C7A8A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F4-0E-22   (hex)		Samsung Electronics Co.,Ltd
+F40E22     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-1B-99   (hex)		SHENZHEN XIN FEI JIA ELECTRONIC CO. LTD.
+881B99     (base 16)		SHENZHEN XIN FEI JIA ELECTRONIC CO. LTD.
+				#4 BULIDING, HIGH TECH INDUSTRIAL PARK, HE PING COMMUNITY
+				GUANGDONG  N/A  518000
+				CN
+
+54-4E-90   (hex)		Apple, Inc.
+544E90     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A4-A6-A9   (hex)		Private
+A4A6A9     (base 16)		Private
+
+8C-10-D4   (hex)		Sagemcom Broadband SAS
+8C10D4     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+F8-98-B9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F898B9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-B5-59   (hex)		CNEX Labs
+5CB559     (base 16)		CNEX Labs
+				2880 Stevens Creek Blvd
+				San Jose  CA  95128
+				US
+
+B8-3A-9D   (hex)		Alarm.com
+B83A9D     (base 16)		Alarm.com
+				8281 Greensboro Dr., Suite 100
+				Tysons  VA   22102
+				US
+
+68-58-C5   (hex)		ZF TRW Automotive
+6858C5     (base 16)		ZF TRW Automotive
+				​12001 Tech Center Drive
+				Livonia  MI  48150
+				US
+
+C0-11-73   (hex)		Samsung Electronics Co.,Ltd
+C01173     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-53-F2   (hex)		ROXTON Ltd.
+7853F2     (base 16)		ROXTON Ltd.
+				15 Ostapovsky proezd
+				Moscow  Moscow  109316
+				RU
+
+BC-E6-3F   (hex)		Samsung Electronics Co.,Ltd
+BCE63F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+7C-91-22   (hex)		Samsung Electronics Co.,Ltd
+7C9122     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-BC-32   (hex)		Apple, Inc.
+ACBC32     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-23-EC   (hex)		Availink, Inc.
+9023EC     (base 16)		Availink, Inc.
+				Scotia Centre P.O. Box 268GT,Grand Cayman, Cayman Islands
+				Grand Cayman  Grand Cayman  999159
+				KY
+
+44-1C-A8   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+441CA8     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+B4-29-3D   (hex)		Shenzhen Urovo Technology Co.,Ltd.
+B4293D     (base 16)		Shenzhen Urovo Technology Co.,Ltd.
+				A701-710, Zondy Cyber Building, Keyuan South Road,
+				Nanshan District, Shenzhen  Guangzhou  518057
+				CN
+
+54-FF-82   (hex)		Davit Solution co.
+54FF82     (base 16)		Davit Solution co.
+				103-301,Geudaegapremier,21 Deagyeong-Daero 1484beon-Gil
+				Suwon-Si  Gyeonggi-Do  KS002
+				KR
+
+50-DF-95   (hex)		Lytx
+50DF95     (base 16)		Lytx
+				9785 Towne Centre Drive
+				San Diego  CA  92121
+				US
+
+9C-A6-9D   (hex)		Whaley Technology Co.Ltd
+9CA69D     (base 16)		Whaley Technology Co.Ltd
+				Floor 3, Building E, No666 Shengxia Road
+				  Shanghai  201203
+				CN
+
+58-53-C0   (hex)		Beijing Guang Runtong Technology Development Company co.,Ltd
+5853C0     (base 16)		Beijing Guang Runtong Technology Development Company co.,Ltd
+				Beijing city Haidian District North Third Ring Road 48, Beijing science and Technology Exhibition Center 1 building B block, room 18H
+				Beijing  Bejing  100000
+				CN
+
+2C-A5-39   (hex)		Parallel Wireless, Inc
+2CA539     (base 16)		Parallel Wireless, Inc
+				1 Tara Blvd
+				Nashua  NH  03062
+				US
+
+CC-79-4A   (hex)		BLU Products Inc.
+CC794A     (base 16)		BLU Products Inc.
+				Tower 4, Excellence Century Center
+				Shenzhen  Guangdong  518000
+				CN
+
+F4-E9-26   (hex)		Tianjin Zanpu Technology Inc.
+F4E926     (base 16)		Tianjin Zanpu Technology Inc.
+				3F Haiyi International Center, Huayuan Industrial Park, Tianjin
+				Tianjin  Tianjin  300384
+				CN
+
+90-6F-18   (hex)		Private
+906F18     (base 16)		Private
+
+98-CB-27   (hex)		Galore Networks Pvt. Ltd.
+98CB27     (base 16)		Galore Networks Pvt. Ltd.
+				#D1104, Salarpuria Serenity, 41A,
+				Bangalore  Karnataka  560068
+				IN
+
+E8-F2-E2   (hex)		LG Innotek
+E8F2E2     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+24-72-60   (hex)		IOTTECH Corp
+247260     (base 16)		IOTTECH Corp
+				4F.-1, No.55, Dongguang Rd., East Dist., Hsinchu City 300, TAIWAN ,REPUBLIC OF CHINA
+				Hsinchu  TAIWAN  300
+				TW
+
+24-5B-F0   (hex)		Liteon, Inc.
+245BF0     (base 16)		Liteon, Inc.
+				3001 Summit Avenue, Suite 400
+				Plano  Tx  75074
+				US
+
+E8-55-B4   (hex)		SAI Technology Inc.
+E855B4     (base 16)		SAI Technology Inc.
+				2376 Walsh Avenue
+				Santa Clara  California  95051
+				US
+
+34-0C-ED   (hex)		Moduel AB
+340CED     (base 16)		Moduel AB
+				Hudiksvallsgatan 8
+				Stockholm  Stockholm  11330
+				SE
+
+28-27-BF   (hex)		Samsung Electronics Co.,Ltd
+2827BF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-D8-59   (hex)		TCT mobile ltd
+94D859     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+2C-FC-E4   (hex)		CTEK Sweden AB
+2CFCE4     (base 16)		CTEK Sweden AB
+				Rostugnsvägen 3
+				Vikmanshyttan  Dalarna  SE-776 70
+				SE
+
+C0-EE-40   (hex)		Laird Technologies
+C0EE40     (base 16)		Laird Technologies
+				50 South Main St
+				Akron  Ohio  44308
+				US
+
+F4-B8-A7   (hex)		zte corporation
+F4B8A7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+30-0C-23   (hex)		zte corporation
+300C23     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C0-B7-13   (hex)		Beijing Xiaoyuer Technology Co. Ltd.
+C0B713     (base 16)		Beijing Xiaoyuer Technology Co. Ltd.
+				No.5 Guangshunbei Rd. Rm# B129
+				Beijing  Beijing  100102
+				CN
+
+10-05-B1   (hex)		ARRIS Group, Inc.
+1005B1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+20-63-5F   (hex)		Abeeway
+20635F     (base 16)		Abeeway
+				29 chemin du vieux chêne
+				meylan  Isere  38240
+				FR
+
+08-3A-5C   (hex)		Junilab, Inc.
+083A5C     (base 16)		Junilab, Inc.
+				#205 107 Gyounggyo-Ro, Yeongtong-Gu, Suwon
+				Suwon  Gyeonggi-Do  443-766
+				KR
+
+B8-B3-DC   (hex)		DEREK (SHAOGUAN) LIMITED
+B8B3DC     (base 16)		DEREK (SHAOGUAN) LIMITED
+				Gaojiling, Taiping Town,
+				Shao Guan  Guang Dong  512500
+				CN
+
+70-2A-7D   (hex)		EpSpot AB
+702A7D     (base 16)		EpSpot AB
+				Aluddsparken 7D
+				  Stockholm  11265
+				SE
+
+4C-AE-31   (hex)		ShengHai Electronics (Shenzhen) Ltd
+4CAE31     (base 16)		ShengHai Electronics (Shenzhen) Ltd
+				Block 17&18,Hui Ming Ying Industry,YanChuan,SongGang
+				Shenzhen  Guangdong  518105
+				CN
+
+18-8E-F9   (hex)		G2C Co. Ltd.
+188EF9     (base 16)		G2C Co. Ltd.
+				1004,1591-9, K-Center Kwanyang Dong
+				Anyang Si  Kyeonggido  431-815
+				KR
+
+44-F4-36   (hex)		zte corporation
+44F436     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C4-7D-46   (hex)		FUJITSU LIMITED
+C47D46     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+18-5D-9A   (hex)		BobjGear LLC
+185D9A     (base 16)		BobjGear LLC
+				4327 S Highway 27 # 504
+				Clermont  Florida  34711
+				US
+
+F4-E9-D4   (hex)		QLogic Corporation
+F4E9D4     (base 16)		QLogic Corporation
+				26650 Aliso Viejo Parkway
+				Aliso Viejo  California  
+				US
+
+4C-B7-6D   (hex)		Novi Security
+4CB76D     (base 16)		Novi Security
+				1434 E 820 N
+				Orem  UT  84097
+				US
+
+6C-E0-1E   (hex)		Modcam AB
+6CE01E     (base 16)		Modcam AB
+				Bredgatan 4
+				Malmö  Skåne  21130
+				SE
+
+74-85-2A   (hex)		PEGATRON CORPORATION
+74852A     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+9C-B6-D0   (hex)		Rivet Networks
+9CB6D0     (base 16)		Rivet Networks
+				11940 Jollyville Rd
+				Austin  tx  78759
+				US
+
+40-B8-9A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+40B89A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+1C-B7-2C   (hex)		ASUSTek COMPUTER INC.
+1CB72C     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+40-B8-37   (hex)		Sony Mobile Communications Inc
+40B837     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+4C-EE-B0   (hex)		SHC Netzwerktechnik GmbH
+4CEEB0     (base 16)		SHC Netzwerktechnik GmbH
+				Ludwigstrasse 33-37
+				Frankfurt am Main  Hessen  60327
+				DE
+
+80-01-84   (hex)		HTC Corporation
+800184     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+44-C6-9B   (hex)		Wuhan Feng Tian Information Network CO.,LTD
+44C69B     (base 16)		Wuhan Feng Tian Information Network CO.,LTD
+				Room 1002,10th Floor,Oversea talent Building A,
+				Wuhan City  Hubei Province  430074
+				CN
+
+FC-E3-3C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+FCE33C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-25-67   (hex)		Nexxt Solutions
+C02567     (base 16)		Nexxt Solutions
+				3505 NW 107TH AVENUE
+				MIAMI  FLORIDA  33178
+				US
+
+A8-82-7F   (hex)		CIBN Oriental Network(Beijing) CO.,Ltd
+A8827F     (base 16)		CIBN Oriental Network(Beijing) CO.,Ltd
+				Floor 18B,Block B(International Resources Building),No.18B(Wanda Plaza),Shijingshan Road,Shijingshan,Beijing(100043)
+				Beijing  Beijing  100043
+				CN
+
+D0-48-F3   (hex)		DATTUS Inc
+D048F3     (base 16)		DATTUS Inc
+				3000 Kent Ave
+				W Lafayette  IN  47906
+				US
+
+B8-C3-BF   (hex)		Henan Chengshi NetWork Technology Co.，Ltd
+B8C3BF     (base 16)		Henan Chengshi NetWork Technology Co.，Ltd
+				Ruhe Road South，Kunlun Road West，Zhongyuan District，Zhengzhou，Henan，P.R.China，450007
+				Zhengzhou  Henan  450007
+				CN
+
+44-96-2B   (hex)		Aidon Oy
+44962B     (base 16)		Aidon Oy
+				Piippukatu 11
+				Jyvaskyla  Jyvaskyla  40100
+				FI
+
+E0-76-D0   (hex)		AMPAK Technology, Inc.
+E076D0     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road
+				Hsinchu  Hsinchu  30352
+				TW
+
+B0-08-BF   (hex)		Vital Connect, Inc.
+B008BF     (base 16)		Vital Connect, Inc.
+				900 E HAMILTON AVE STE 500
+				CAMPBELL  CA  95008-0667
+				US
+
+D4-52-2A   (hex)		TangoWiFi.com
+D4522A     (base 16)		TangoWiFi.com
+				TangoWiFi Team
+				Beijing  Beijing  100022
+				CN
+
+E8-07-BF   (hex)		SHENZHEN BOOMTECH INDUSTRY CO.,LTD
+E807BF     (base 16)		SHENZHEN BOOMTECH INDUSTRY CO.,LTD
+				Floor 6 East, Bldg 6, Yusheng Industrial Area, Xixiang, Bao'an District
+				Shenzhen  Guangdong  518000
+				CN
+
+84-F1-29   (hex)		Metrascale Inc.
+84F129     (base 16)		Metrascale Inc.
+				400 Liberty Ave.
+				Brooklyn  NY  11207
+				US
+
+B8-9A-CD   (hex)		ELITE OPTOELECTRONIC(ASIA)CO.,LTD
+B89ACD     (base 16)		ELITE OPTOELECTRONIC(ASIA)CO.,LTD
+				A9 jin Fu 1 Road,Tangchun lndustrial zone,Liaobu Town,Dongguan City,Guangdong Province
+				Liaobu  dongguan /guangdong  523400
+				CN
+
+D4-68-BA   (hex)		Shenzhen Sundray Technologies Company Limited
+D468BA     (base 16)		Shenzhen Sundray Technologies Company Limited
+				6th Floor,Block A1, Nanshan iPark, 
+				Nanshan District, Shenzhen 518055  Guangdong  
+				CN
+
+08-62-66   (hex)		ASUSTek COMPUTER INC.
+086266     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+9C-30-66   (hex)		RWE Effizienz GmbH
+9C3066     (base 16)		RWE Effizienz GmbH
+				Flamingoweg 1
+				Dortmund  NRW  44139
+				DE
+
+18-BD-AD   (hex)		L-TECH CORPORATION
+18BDAD     (base 16)		L-TECH CORPORATION
+				201, Moonbon-dong
+				Ilsandong-gu  Gyeonggi-do  410-560
+				KR
+
+60-E6-BC   (hex)		Sino-Telecom Technology Co.,Ltd.
+60E6BC     (base 16)		Sino-Telecom Technology Co.,Ltd.
+				6F, Building 2, No.115, Lane 1276 Nanle Rd
+				    201613
+				CN
+
+C8-C5-0E   (hex)		Shenzhen Primestone Network Technologies.Co., Ltd.
+C8C50E     (base 16)		Shenzhen Primestone Network Technologies.Co., Ltd.
+				Room 705,Complex Building, Tsinghua Hi-Tech Park
+				Shenzhen  Guangdong  518057
+				CN
+
+D0-6A-1F   (hex)		BSE CO.,LTD.
+D06A1F     (base 16)		BSE CO.,LTD.
+				626-3, Gozan-dong, Namdong-ku
+				Incheon, 405-817    
+				KR
+
+70-01-36   (hex)		FATEK Automation Corporation
+700136     (base 16)		FATEK Automation Corporation
+				5F., NO.300, SEC. 1, NEIHU RD
+				Taipei City    114
+				TW
+
+FC-A2-2A   (hex)		PT. Callysta Multi Engineering
+FCA22A     (base 16)		PT. Callysta Multi Engineering
+				Jl. Taman Cibeunying No. 2
+				Bandung  Jawa Barat  40114
+				ID
+
+A4-56-02   (hex)		fenglian Technology Co.,Ltd.
+A45602     (base 16)		fenglian Technology Co.,Ltd.
+				302 R D Building Oriental Cyberport HighTech Industrial Park Nanshan Shenzhen China
+				  Shenzhen,Guangdong Province  518057
+				CN
+
+94-E2-FD   (hex)		Boge Kompressoren OTTO Boge GmbH & Co. KG
+94E2FD     (base 16)		Boge Kompressoren OTTO Boge GmbH & Co. KG
+				Otto Boge Str. 1-7
+				Bielefeld  Westfalia  33739
+				DE
+
+F0-1E-34   (hex)		ORICO Technologies Co., Ltd
+F01E34     (base 16)		ORICO Technologies Co., Ltd
+				F-9, Block14A, Zhonghaixin Science &Technology Zone
+				ShenZhen  Guangdong  518116
+				CN
+
+DC-E0-26   (hex)		Patrol Tag, Inc
+DCE026     (base 16)		Patrol Tag, Inc
+				2800 Western Ave
+				Seattle  WA  98121
+				US
+
+B4-05-66   (hex)		SP Best Corporation Co., LTD.
+B40566     (base 16)		SP Best Corporation Co., LTD.
+				555/25 B-Avenue, Sukhaphibal 5 Road
+				Saimai  Bangkok  10220
+				TH
+
+1C-C7-2D   (hex)		Shenzhen Huapu Digital CO.,Ltd
+1CC72D     (base 16)		Shenzhen Huapu Digital CO.,Ltd
+				R2305 Malata Technology Building,NO.9998 Shennan Boulevard, Shenzhen,P.R.China 518057
+				Shenzhen  Guangzhou  518057
+				CN
+
+A8-90-08   (hex)		Beijing Yuecheng Technology Co. Ltd.
+A89008     (base 16)		Beijing Yuecheng Technology Co. Ltd.
+				Room 1601, Floor 16
+				Beijing  Beijing  100000
+				CN
+
+18-38-64   (hex)		CAP-TECH INTERNATIONAL CO., LTD.
+183864     (base 16)		CAP-TECH INTERNATIONAL CO., LTD.
+				 Rm. 6, 4F., No.120, Qiaohe Rd., Zhonghe Dist
+				New Taipei City  Taiwan  235
+				TW
+
+6C-F5-E8   (hex)		Mooredoll Inc.
+6CF5E8     (base 16)		Mooredoll Inc.
+				5F,No.50,Ln.316,Ruiguan Rd.,Neihu Dist.,Taipei 114, Taiwan
+				Taipei  Neihu  114
+				TW
+
+8C-BF-A6   (hex)		Samsung Electronics Co.,Ltd
+8CBFA6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-A8-23   (hex)		Samsung Electronics Co.,Ltd
+C8A823     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-C5-59   (hex)		Samsung Electronics Co.,Ltd
+B0C559     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-2C-56   (hex)		SENOR TECH CO LTD
+F42C56     (base 16)		SENOR TECH CO LTD
+				No.165, Kangning St
+				New Taipei City  Taiwan  221
+				TW
+
+FC-DC-4A   (hex)		G-Wearables Corp.
+FCDC4A     (base 16)		G-Wearables Corp.
+				901, S&CTBuilding, No.9 Zhongguancun South Avenue
+				Beijing  Beijing  100081
+				CN
+
+1C-14-B3   (hex)		Airwire Technologies
+1C14B3     (base 16)		Airwire Technologies
+				9670 Gateway Drive, Suite 250
+				Reno  NV  89521
+				US
+
+A4-8C-DB   (hex)		Lenovo
+A48CDB     (base 16)		Lenovo
+				1009 Think Place
+				Morrisvilee  NC  27560
+				US
+
+D8-5D-E2   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D85DE2     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+3C-91-2B   (hex)		Vexata Inc
+3C912B     (base 16)		Vexata Inc
+				1735 Technology Dr Suite 520
+				San Jose  CA  95110
+				US
+
+34-6C-0F   (hex)		Pramod Telecom Pvt. Ltd
+346C0F     (base 16)		Pramod Telecom Pvt. Ltd
+				Plot No. 6-B, Malviya Nagar,
+				Lucknow  Uttar Pradesh  226004
+				IN
+
+BC-14-85   (hex)		Samsung Electronics Co.,Ltd
+BC1485     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+9C-6C-15   (hex)		Microsoft Corporation
+9C6C15     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+44-5E-CD   (hex)		Razer Inc
+445ECD     (base 16)		Razer Inc
+				2035 Corte Del Nogal
+				Carlsbad  CA  92011
+				US
+
+4C-A9-28   (hex)		Insensi
+4CA928     (base 16)		Insensi
+				2025 Broadway, 2CD
+				New York City  New York  10023
+				US
+
+E8-44-7E   (hex)		Bitdefender SRL
+E8447E     (base 16)		Bitdefender SRL
+				24 Delea Veche St.
+				Bucharest  Romania  024102
+				RO
+
+C0-33-5E   (hex)		Microsoft
+C0335E     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+B0-E0-3C   (hex)		TCT mobile ltd
+B0E03C     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+B0-49-5F   (hex)		OMRON HEALTHCARE Co., Ltd.
+B0495F     (base 16)		OMRON HEALTHCARE Co., Ltd.
+				53, Kunotsubo, Terado-cho
+				Muko  Kyoto  6170002
+				JP
+
+60-F1-89   (hex)		Murata Manufacturing Co., Ltd.
+60F189     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+74-2E-FC   (hex)		DirectPacket Research, Inc,
+742EFC     (base 16)		DirectPacket Research, Inc,
+				909 Lake Carolyn Parkway
+				Irving  Texas  75039
+				US
+
+84-CF-BF   (hex)		Fairphone
+84CFBF     (base 16)		Fairphone
+				Piet Heinkade 181A
+				Amsterdam  North Holland  1019HC
+				NL
+
+AC-D1-B8   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+ACD1B8     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+A0-C2-DE   (hex)		Costar Video Systems
+A0C2DE     (base 16)		Costar Video Systems
+				101 Wrangler, Suite 201
+				Coppell  Texas  75019
+				US
+
+88-E1-61   (hex)		Art Beijing Science and Technology Development Co., Ltd.
+88E161     (base 16)		Art Beijing Science and Technology Development Co., Ltd.
+				Room 210,Building 1#, No. 27 Qinghe Longgang Rd., Haidian District, Beijing,100192,China
+				Beijing  Beijing  100192
+				CN
+
+00-A5-09   (hex)		WigWag Inc.
+00A509     (base 16)		WigWag Inc.
+				4009 banister lane
+				austin  texas  78704
+				US
+
+74-91-BD   (hex)		Four systems Co.,Ltd.
+7491BD     (base 16)		Four systems Co.,Ltd.
+				608-608/7 Ramintra Road Kannayao
+				Bangkok  Bangkok  10230
+				TH
+
+F0-FE-6B   (hex)		Shanghai High-Flying Electronics Technology Co., Ltd
+F0FE6B     (base 16)		Shanghai High-Flying Electronics Technology Co., Ltd
+				Room 1002 ,#1Building,No.3000 Longdong Avenue,Pudong District,Shanghai,China
+				shanghai  shanghai  201203
+				CN
+
+3C-AE-69   (hex)		ESA Elektroschaltanlagen Grimma GmbH
+3CAE69     (base 16)		ESA Elektroschaltanlagen Grimma GmbH
+				Broner Ring 30
+				Grimma  Saxony  04668
+				DE
+
+D4-32-66   (hex)		Fike Corporation
+D43266     (base 16)		Fike Corporation
+				704 SW 10th Street
+				Blue Springs  MO  64015
+				US
+
+90-0C-B4   (hex)		Alinket Electronic Technology Co., Ltd
+900CB4     (base 16)		Alinket Electronic Technology Co., Ltd
+				412 Guilin Rd. 3F, Xuhui District
+				Shanghai  Shanghai  201235
+				CN
+
+48-C0-93   (hex)		Xirrus, Inc.
+48C093     (base 16)		Xirrus, Inc.
+				2101 Corporate Center Dr.
+				Thousand Oaks  CA  91320
+				US
+
+DC-09-14   (hex)		Talk-A-Phone Co.
+DC0914     (base 16)		Talk-A-Phone Co.
+				7530 N. Natchez Ave.
+				Niles  IL  60714
+				US
+
+D0-92-9E   (hex)		Microsoft Corporation
+D0929E     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+BC-52-B4   (hex)		Nokia
+BC52B4     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+94-05-B6   (hex)		Liling FullRiver Electronics & Technology Ltd
+9405B6     (base 16)		Liling FullRiver Electronics & Technology Ltd
+				FullRiver Industrial Area Economic Development Zone
+				HuNan Province    412200
+				CN
+
+00-F3-DB   (hex)		WOO Sports
+00F3DB     (base 16)		WOO Sports
+				11 Elkins St.
+				BOSTON  Massachusetts  02127
+				US
+
+78-31-2B   (hex)		zte corporation
+78312B     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C8-1B-6B   (hex)		Innova Security
+C81B6B     (base 16)		Innova Security
+				Av. General Ataliba Leonel, 1205
+				Sao Paulo  Sao Paulo  02033000
+				BR
+
+34-38-AF   (hex)		Inlab Software GmbH
+3438AF     (base 16)		Inlab Software GmbH
+				Josef-Wuerth-Str. 3
+				Gruenwald  Bavaria  82031
+				DE
+
+B4-A8-28   (hex)		Shenzhen Concox Information Technology Co., Ltd
+B4A828     (base 16)		Shenzhen Concox Information Technology Co., Ltd
+				Floor 4th, Building B, Gaoxinqi Industrial Park, Liuxian 1st Road, district 67, Bao’an, Shenzhen, Guangdong,China
+				Shenzhen  Guangdong  518102
+				CN
+
+00-A2-F5   (hex)		Guangzhou Yuanyun Network Technology Co.,Ltd
+00A2F5     (base 16)		Guangzhou Yuanyun Network Technology Co.,Ltd
+				31/F,183 TianHe Bei Rd, Metro Plz
+				GuangZhou  GuangDong  510630
+				CN
+
+10-08-B1   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+1008B1     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+E4-8C-0F   (hex)		Discovery Insure
+E48C0F     (base 16)		Discovery Insure
+				3 Alice lane
+				Sandton  Gauteng  2196
+				ZA
+
+E4-23-54   (hex)		SHENZHEN FUZHI SOFTWARE TECHNOLOGY CO.,LTD
+E42354     (base 16)		SHENZHEN FUZHI SOFTWARE TECHNOLOGY CO.,LTD
+				4/F,Fuxing Bldg,Binlang Road,Futian Free Trade Zone,SHENZHEN.CHINA
+				SHENZHEN  Guang Dong  518038
+				CN
+
+94-BF-95   (hex)		Shenzhen Coship Electronics Co., Ltd
+94BF95     (base 16)		Shenzhen Coship Electronics Co., Ltd
+				Rainbow Bldg., North, Hi-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+44-CE-7D   (hex)		SFR
+44CE7D     (base 16)		SFR
+				5 RUE NOEL PONS
+				NANTERRE    92000
+				FR
+
+34-4D-EA   (hex)		zte corporation
+344DEA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+4C-16-F1   (hex)		zte corporation
+4C16F1     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-FA-CE   (hex)		Reacheng Communication Technology Co.,Ltd
+10FACE     (base 16)		Reacheng Communication Technology Co.,Ltd
+				Building No.5-401,
+				Pu Dong New District,  Shanghai  201203
+				CN
+
+94-70-D2   (hex)		WINFIRM TECHNOLOGY
+9470D2     (base 16)		WINFIRM TECHNOLOGY
+				2-1015 Lotte IT Castle
+				  Seoul  153-768
+				KR
+
+A4-4A-D3   (hex)		ST Electronics(Shanghai) Co.,Ltd
+A44AD3     (base 16)		ST Electronics(Shanghai) Co.,Ltd
+				Floors 1&3, No.6 Building, No.1151 Lianxi Road
+				Shanghai  Shanghai  201204
+				CN
+
+7C-B1-77   (hex)		Satelco AG
+7CB177     (base 16)		Satelco AG
+				Seestrasse 241
+				Au / Waedenswil  ZH  8804
+				CH
+
+CC-30-80   (hex)		VAIO Corporation
+CC3080     (base 16)		VAIO Corporation
+				5432 Toyoshina
+				Azumino  Nagano  399-8282
+				JP
+
+58-7B-E9   (hex)		AirPro Technology India Pvt. Ltd
+587BE9     (base 16)		AirPro Technology India Pvt. Ltd
+				D30, Gautam Marg,
+				Jaipur  Rajasthan  302018
+				IN
+
+8C-18-D9   (hex)		Shenzhen RF Technology Co., Ltd
+8C18D9     (base 16)		Shenzhen RF Technology Co., Ltd
+				5/F,Building 4,Baokun Science and Technology Industial Park
+				Baoan  Guangdong  518100
+				CN
+
+C4-BD-6A   (hex)		SKF GmbH
+C4BD6A     (base 16)		SKF GmbH
+				Gunnar-Wester-Strasse 12
+				Schweinfurt  DE  DE-97421
+				DE
+
+C4-01-CE   (hex)		PRESITION (2000) CO., LTD.
+C401CE     (base 16)		PRESITION (2000) CO., LTD.
+				42/6 Moo6
+				Muang  Samutsakorn  74000
+				TH
+
+18-71-17   (hex)		eta plus electronic gmbh
+187117     (base 16)		eta plus electronic gmbh
+				Lauterstr. 29
+				Nuertingen  BW  72622
+				DE
+
+EC-0E-C4   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+EC0EC4     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+30-FA-B7   (hex)		Tunai Creative
+30FAB7     (base 16)		Tunai Creative
+				12F, No.221, Sec.4, Zongxiao E. Rd, Taipei 106, Taiwan
+				TAIPEI  TAIPEI  10690
+				TW
+
+08-09-B6   (hex)		Masimo Corp
+0809B6     (base 16)		Masimo Corp
+				40 Parker
+				Irvine  CA  92618
+				US
+
+4C-F5-A0   (hex)		Scalable Network Technologies Inc
+4CF5A0     (base 16)		Scalable Network Technologies Inc
+				600 Corporate Pointe
+				Culver City  CA  90230
+				US
+
+D8-FB-11   (hex)		AXACORE
+D8FB11     (base 16)		AXACORE
+				2468 HISTORIC DECATUR RD
+				SAN DIEGO  CA  92106
+				US
+
+4C-E9-33   (hex)		RailComm, LLC
+4CE933     (base 16)		RailComm, LLC
+				1387 Fairport Road
+				Fairport  New York  14450
+				US
+
+CC-E1-7F   (hex)		Juniper Networks
+CCE17F     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+E4-C6-2B   (hex)		Airware
+E4C62B     (base 16)		Airware
+				1045 Bryant St.
+				San Francisco  California  94103
+				US
+
+EC-1D-7F   (hex)		zte corporation
+EC1D7F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+AC-38-70   (hex)		Lenovo Mobile Communication Technology Ltd.
+AC3870     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information & Optoelectronics Park,
+				Xiamen  Fujian  361006
+				
+
+4C-BC-42   (hex)		Shenzhen Hangsheng Electronics Co.,Ltd.
+4CBC42     (base 16)		Shenzhen Hangsheng Electronics Co.,Ltd.
+				Hangsheng Industrial Area, Fuyuan 1st Road,Heping Village, Fuyong Town,Baoan District
+				Shenzhen City  Guangdong  518103
+				CN
+
+70-F1-96   (hex)		Actiontec Electronics, Inc
+70F196     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+18-82-19   (hex)		Alibaba Cloud Computing Ltd.
+188219     (base 16)		Alibaba Cloud Computing Ltd.
+				Yuhang District of Hangzhou Wenyi Road, Building 1, No. 969 Xixi Park, Zhejiang Province
+				Hangzhou  Zhejiang  310000
+				CN
+
+28-A5-EE   (hex)		Shenzhen SDGI CATV Co., Ltd
+28A5EE     (base 16)		Shenzhen SDGI CATV Co., Ltd
+				2/F, NO, 3, QIONGYU ROAD,
+				shenzhen  Guangdong province  518057
+				CN
+
+D0-A0-D6   (hex)		Chengdu TD Tech Ltd.
+D0A0D6     (base 16)		Chengdu TD Tech Ltd.
+				3-5F,Building 3, No.219 Tian Hua Road 2, Software Park C,High-Tech Zone
+				Chengdu  Sichuan  610041
+				CN
+
+EC-B9-07   (hex)		CloudGenix Inc
+ECB907     (base 16)		CloudGenix Inc
+				2933 Bunker Hill Lane
+				Santa Clara  CA  95054
+				US
+
+F4-28-33   (hex)		MMPC Inc.
+F42833     (base 16)		MMPC Inc.
+				#F313, KAIST-ICC, 193 Munjiro Yuseong-gu
+				Daejeon  Daejeon  305-732
+				KR
+
+0C-8C-8F   (hex)		Kamo Technology Limited
+0C8C8F     (base 16)		Kamo Technology Limited
+				Room 1502, 15/F., Yue Xiu Building,
+				Wanchai  Hong Kong  160-174
+				CN
+
+A4-A4-D3   (hex)		Bluebank Communication Technology Co.Ltd
+A4A4D3     (base 16)		Bluebank Communication Technology Co.Ltd
+				No.13-2.Jiang Ying Road,
+				  Chongqing  401336
+				CN
+
+A8-32-9A   (hex)		Digicom Futuristic Technologies Ltd.
+A8329A     (base 16)		Digicom Futuristic Technologies Ltd.
+				406 Mirror Tower, Modi Road, TST
+				    000086
+				HK
+
+F4-D0-32   (hex)		Yunnan Ideal Information&Technology.,Ltd
+F4D032     (base 16)		Yunnan Ideal Information&Technology.,Ltd
+				The 1st Floor, Building Four ,JingdianMingju,Haiyuanzhong road, High Tech Development Zone,Kunming,YunnanP.R.China
+				Kunming  Yunnan  650106
+				CN
+
+60-02-92   (hex)		PEGATRON CORPORATION
+600292     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+B4-B8-59   (hex)		Texa Spa
+B4B859     (base 16)		Texa Spa
+				Via I Maggio, 9
+				Monastier di Treviso  Treviso  31050
+				IT
+
+5C-F9-F0   (hex)		Atomos Engineering P/L
+5CF9F0     (base 16)		Atomos Engineering P/L
+				36 Park St
+				South Melbourne  Victoria  3205
+				AU
+
+70-2D-D1   (hex)		Newings Communication CO., LTD.
+702DD1     (base 16)		Newings Communication CO., LTD.
+				12F, Block 1, NO 7866, Humin Rd, Minhang District, Shanghai, China
+				Shanghai  Shanghai  200000
+				CN
+
+14-75-90   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+147590     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+50-BD-5F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+50BD5F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+98-7E-46   (hex)		Emizon Networks Limited
+987E46     (base 16)		Emizon Networks Limited
+				1 Allerton Road
+				Rugby  Warwickshire  CV23 0PA
+				GB
+
+3C-46-D8   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+3C46D8     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+4C-83-DE   (hex)		Cisco SPVTG
+4C83DE     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+A8-13-74   (hex)		Panasonic Corporation AVC Networks Company
+A81374     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo cho
+				Kadoma city  Osaka  571-8504
+				JP
+
+08-3D-88   (hex)		Samsung Electronics Co.,Ltd
+083D88     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-4E-5D   (hex)		ZhongMiao Technology Co., Ltd.
+BC4E5D     (base 16)		ZhongMiao Technology Co., Ltd.
+				NO.2009 Lihu Avenue,  WuxiStudioA-A3
+				Wuxi  Jiangsu  214000
+				CN
+
+3C-18-9F   (hex)		Nokia Corporation
+3C189F     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+7C-6A-C3   (hex)		GatesAir, Inc
+7C6AC3     (base 16)		GatesAir, Inc
+				5300 Kings Island Drive
+				Mason  Ohio  45040
+				US
+
+5C-5B-C2   (hex)		YIK Corporation
+5C5BC2     (base 16)		YIK Corporation
+				B-4F,Pangyo Silicon Park 613
+				Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+30-59-5B   (hex)		streamnow AG
+30595B     (base 16)		streamnow AG
+				Brandstrasse 33
+				Schlieren  Zürich  8952
+				CH
+
+84-85-0A   (hex)		Hella Sonnen- und Wetterschutztechnik GmbH
+84850A     (base 16)		Hella Sonnen- und Wetterschutztechnik GmbH
+				Abfaltersbach 125
+				Abfaltersbach  Tirol  9913
+				AT
+
+08-CD-9B   (hex)		samtec automotive electronics & software GmbH
+08CD9B     (base 16)		samtec automotive electronics & software GmbH
+				Saarstrasse 27
+				Filderstadt  Baden-Wuerttemberg  70794
+				DE
+
+28-E6-E9   (hex)		SIS Sat Internet Services GmbH
+28E6E9     (base 16)		SIS Sat Internet Services GmbH
+				Justus-von-Liebig Str. 26
+				Neustadt  Niedersachsen  31535
+				DE
+
+F4-FD-2B   (hex)		ZOYI Company
+F4FD2B     (base 16)		ZOYI Company
+				827-66 Yeoksam 1-dong, Second Floor
+				Seoul  Korea  135-935
+				KR
+
+F4-F6-46   (hex)		Dediprog Technology Co. Ltd.
+F4F646     (base 16)		Dediprog Technology Co. Ltd.
+				4F,No.7,Lane 143, Xinming Rd.,
+				Taipei    114
+				TW
+
+30-0D-2A   (hex)		Zhejiang Wellcom Technology Co.,Ltd.
+300D2A     (base 16)		Zhejiang Wellcom Technology Co.,Ltd.
+				Liuhe Road,Binjiang District , Hangzhou
+				Hangzhou  Zhejiang  310012
+				
+
+04-5C-8E   (hex)		gosund GROUP CO.,LTD
+045C8E     (base 16)		gosund GROUP CO.,LTD
+				11/F., FRONT BLOCK, HANG LOK BUILDING
+				SHEUNG WAN, HK    999077
+				HK
+
+7C-C4-EF   (hex)		Devialet
+7CC4EF     (base 16)		Devialet
+				126, rue Réaumur
+				Paris  Paris  75002
+				FR
+
+D8-5D-FB   (hex)		Private
+D85DFB     (base 16)		Private
+
+DC-F1-10   (hex)		Nokia Corporation
+DCF110     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+60-8F-5C   (hex)		Samsung Electronics Co.,Ltd
+608F5C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-38-E1   (hex)		Juniper Networks
+DC38E1     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-8C-63   (hex)		GZ Weedong Networks Technology Co. , Ltd
+908C63     (base 16)		GZ Weedong Networks Technology Co. , Ltd
+				38th Floor,Ren Feng Building
+				Guangzhou  Guangdong  510620
+				CN
+
+E8-EF-89   (hex)		OPMEX Tech.
+E8EF89     (base 16)		OPMEX Tech.
+				18F GDC Building, 9 Gaoxin Central Avenue 3rd, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+10-92-66   (hex)		Samsung Electronics Co.,Ltd
+109266     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+EC-2E-4E   (hex)		HITACHI-LG DATA STORAGE INC
+EC2E4E     (base 16)		HITACHI-LG DATA STORAGE INC
+				4F, MSC CENTER  BLDG., 22-23 KAIGAN 3-CHOME, MINATO-KU,
+				TOKYO  TOKYO  108-0022
+				JP
+
+34-81-C4   (hex)		AVM GmbH
+3481C4     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+98-37-13   (hex)		PT.Navicom Indonesia
+983713     (base 16)		PT.Navicom Indonesia
+				Perkantoran Citragrand Blok CW7 no 10
+				Bekasi  Jawa Barat  17435
+				ID
+
+A4-7E-39   (hex)		zte corporation
+A47E39     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+CC-B6-91   (hex)		NECMagnusCommunications
+CCB691     (base 16)		NECMagnusCommunications
+				4-28 MITA 1Chome
+				 Minato-ku  Tokyo  108-0073
+				JP
+
+40-16-7E   (hex)		ASUSTek COMPUTER INC.
+40167E     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+F8-4A-73   (hex)		EUMTECH CO., LTD
+F84A73     (base 16)		EUMTECH CO., LTD
+				Room 1201, 115, Dongdeok-ro
+				Daegu  Daegu  700-719
+				KR
+
+14-2B-D6   (hex)		Guangdong Appscomm Co.,Ltd
+142BD6     (base 16)		Guangdong Appscomm Co.,Ltd
+				Rm 903, Block C3, Chuangxin Building, No.182,
+				Guangzhou  Guangdong  510663
+				CN
+
+FC-C2-DE   (hex)		Murata Manufacturing Co., Ltd.
+FCC2DE     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+98-34-9D   (hex)		Krauss Maffei Technologies GmbH
+98349D     (base 16)		Krauss Maffei Technologies GmbH
+				Krauss-Mafffei-Str. 2
+				Munich    80997
+				DE
+
+88-0F-B6   (hex)		Jabil Circuits India Pvt Ltd,-EHTP unit
+880FB6     (base 16)		Jabil Circuits India Pvt Ltd,-EHTP unit
+				B-26, MIDC, Ranjangaon, Tal.Shirur
+				Pune  Maharashtra  412220
+				IN
+
+B4-66-98   (hex)		Zealabs srl
+B46698     (base 16)		Zealabs srl
+				via Monte Grappa, 25
+				Lancenigo di Villorba  Italy  31020
+				IT
+
+68-7C-C8   (hex)		Measurement Systems S. de R.L.
+687CC8     (base 16)		Measurement Systems S. de R.L.
+				45999 Regal Plaza
+				Sterling  VA  20165
+				US
+
+74-F8-5D   (hex)		Berkeley Nucleonics Corp
+74F85D     (base 16)		Berkeley Nucleonics Corp
+				2955 Kerner Blvd #D
+				San Rafael  California  94901
+				US
+
+B0-61-C7   (hex)		Ericsson-LG Enterprise
+B061C7     (base 16)		Ericsson-LG Enterprise
+				77, Heungan-daro 81beon-gil,
+				Anyang  Gyeonggi  431-749
+				KR
+
+00-92-FA   (hex)		SHENZHEN WISKY TECHNOLOGY CO.,LTD
+0092FA     (base 16)		SHENZHEN WISKY TECHNOLOGY CO.,LTD
+				5/F W2-A,Hight-tech Park South 1 Road,Nanshan District,Shenzhen,Guangdong,China
+				Shenzhen  Guangdong  518057
+				CN
+
+4C-7F-62   (hex)		Nokia Corporation
+4C7F62     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+10-0F-18   (hex)		Fu Gang Electronic(KunShan)CO.,LTD
+100F18     (base 16)		Fu Gang Electronic(KunShan)CO.,LTD
+				No.6 Zheng Wei West Road, Jin Xi Town, Kun Shan City, Jiang Su Province, China
+				Jiang Su    215324
+				CN
+
+D0-C7-C0   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D0C7C0     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+44-11-C2   (hex)		Telegartner Karl Gartner GmbH
+4411C2     (base 16)		Telegartner Karl Gartner GmbH
+				Lerchenstr. 35
+				Steinenbronn  Baden-Wurttemberg  71144
+				DE
+
+80-59-FD   (hex)		Noviga
+8059FD     (base 16)		Noviga
+				Lefortovskaya nab., 1
+				Moscow  -  105005
+				RU
+
+40-01-07   (hex)		Arista Corp
+400107     (base 16)		Arista Corp
+				40675 Encyclopedia Circle
+				Fremont  CA  94538
+				US
+
+30-C7-50   (hex)		MIC Technology Group
+30C750     (base 16)		MIC Technology Group
+				No. 6 Gaoxin 3 road
+				Xi'an  Shaanxi  710075
+				CN
+
+18-CC-23   (hex)		Philio Technology Corporation
+18CC23     (base 16)		Philio Technology Corporation
+				8F., No.653-2, Zhongzheng Rd
+				New Taipei    242
+				TW
+
+40-78-75   (hex)		IMBEL - Industria de Material Belico do Brasil
+407875     (base 16)		IMBEL - Industria de Material Belico do Brasil
+				Rua Monsenhor Manoel Gomes,   520
+				Rio de Janeiro  RJ  20931-670
+				BR
+
+D8-81-CE   (hex)		AHN INC.
+D881CE     (base 16)		AHN INC.
+				1006,Halla sigma valley, 53, Gasandigital 2-Ro
+				Seoul    153 706
+				KR
+
+28-C8-25   (hex)		DellKing Industrial Co., Ltd
+28C825     (base 16)		DellKing Industrial Co., Ltd
+				2F,Building D,Zhongxing Science Park,  No 3,Ganli 2nd Road,Gankeng Community
+				Shenzhen  GuangDong  518112
+				CN
+
+80-61-8F   (hex)		Shenzhen sangfei consumer communications co.,ltd
+80618F     (base 16)		Shenzhen sangfei consumer communications co.,ltd
+				11 science and technology road,shenzhen hi-tech industrial park nanshan district,shenzhen 518057,PRC
+				ShenZhen  China/GuangDong  518057
+				CN
+
+D8-2A-15   (hex)		Leitner SpA
+D82A15     (base 16)		Leitner SpA
+				Via Brennero 34
+				Vipiteno  Bolzano  39049
+				IT
+
+44-7E-76   (hex)		Trek Technology (S) Pte Ltd
+447E76     (base 16)		Trek Technology (S) Pte Ltd
+				30 Loyang Way #07-15
+				Singapore  Singapore  508769
+				SG
+
+B0-EC-8F   (hex)		GMX SAS
+B0EC8F     (base 16)		GMX SAS
+				32 Rue Brancion
+				PARIS    75015
+				FR
+
+28-DE-F6   (hex)		bioMerieux Inc.
+28DEF6     (base 16)		bioMerieux Inc.
+				595 Anglum Road
+				Hazelwood  MO  63042
+				US
+
+58-05-28   (hex)		LABRIS NETWORKS
+580528     (base 16)		LABRIS NETWORKS
+				Silikon Blok 1 NK 24 Teknokent
+				ANKARA  AN  06540
+				TR
+
+E0-D3-1A   (hex)		EQUES Technology Co., Limited
+E0D31A     (base 16)		EQUES Technology Co., Limited
+				Room 301, Building 1, No.168 Jixin Road,
+				  Shanghai  201199
+				CN
+
+98-77-70   (hex)		Pep Digital Technology (Guangzhou) Co., Ltd
+987770     (base 16)		Pep Digital Technology (Guangzhou) Co., Ltd
+				23F, Yinhui Building, No.117 Longyi Road,
+				Guangzhou  Guangdong Province  510635
+				CN
+
+68-D2-47   (hex)		Portalis LC
+68D247     (base 16)		Portalis LC
+				204 Fort Union Blvd. Ste. 202
+				Midvale  UT  84047
+				US
+
+50-B6-95   (hex)		Micropoint Biotechnologies,Inc.
+50B695     (base 16)		Micropoint Biotechnologies,Inc.
+				6F, No.3, Industry 5 Road, Shekou
+				Shenzhen  Guangdong  518067
+				CN
+
+B4-43-0D   (hex)		Broadlink Pty Ltd
+B4430D     (base 16)		Broadlink Pty Ltd
+				room 1201,  No. 588 jiangnan Rd,
+				Hangzhou  Zhejiang province  310052
+				CN
+
+A0-65-18   (hex)		VNPT TECHNOLOGY
+A06518     (base 16)		VNPT TECHNOLOGY
+				HoaLac Hi-Tech Park
+				  HANOI  10000
+				VN
+
+7C-8D-91   (hex)		Shanghai Hongzhuo Information Technology co.,LTD
+7C8D91     (base 16)		Shanghai Hongzhuo Information Technology co.,LTD
+				Room.161,Building 5,No.311 Jingao RD
+				Pudong  Shanghai  200136
+				CN
+
+74-8F-1B   (hex)		MasterImage 3D
+748F1B     (base 16)		MasterImage 3D
+				131, Gasan Digital 1-ro, Geumcheon-gu
+				Seoul    153-803
+				KR
+
+08-3F-76   (hex)		Intellian Technologies, Inc.
+083F76     (base 16)		Intellian Technologies, Inc.
+				348-5 Chungho-Ri Jinwi-Myeon
+				  Gyeonggi-Do  451-862
+				KR
+
+CC-89-FD   (hex)		Nokia Corporation
+CC89FD     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+34-46-6F   (hex)		HiTEM Engineering
+34466F     (base 16)		HiTEM Engineering
+				7420 Carroll Road
+				San Diego  CA  92121
+				US
+
+38-6C-9B   (hex)		Ivy Biomedical
+386C9B     (base 16)		Ivy Biomedical
+				11 Business Park Drive
+				Branford  Connecticut  06405
+				US
+
+B4-2C-92   (hex)		Zhejiang Weirong Electronic Co., Ltd
+B42C92     (base 16)		Zhejiang Weirong Electronic Co., Ltd
+				North of South Tanghe Road, Lingxi Town,
+				 Wenzhou City   Zhejiang Province  325800
+				CN
+
+A0-77-71   (hex)		Vialis BV
+A07771     (base 16)		Vialis BV
+				Loodsboot 15
+				HOUTEN  Utrecht  3991 CJ
+				US
+
+10-DD-F4   (hex)		Maxway Electronics CO.,LTD
+10DDF4     (base 16)		Maxway Electronics CO.,LTD
+				2F Building 4,A Section,3rd Industrial zone,Tangtou
+				Shenzhen  Guangdong  518018
+				CN
+
+5C-E7-BF   (hex)		New Singularity International Technical Development Co.,Ltd
+5CE7BF     (base 16)		New Singularity International Technical Development Co.,Ltd
+				8F,NorthStar-Ultrapower Tower, No.13 Beiyuan Road, Chaoyang District, Beijing, China
+				Beijing  Beijing  100107
+				CN
+
+6C-64-1A   (hex)		Penguin Computing
+6C641A     (base 16)		Penguin Computing
+				45800 Northport Loop West
+				Fremont  CA  94538
+				US
+
+50-A0-54   (hex)		Actineon
+50A054     (base 16)		Actineon
+				47751 Fremont Blvd
+				Fremont  California  94538
+				US
+
+B4-85-47   (hex)		Amptown System Company GmbH
+B48547     (base 16)		Amptown System Company GmbH
+				Wandsbeker Strasse 26
+				Hamburg  Hamburg  22179
+				DE
+
+50-56-A8   (hex)		Jolla Ltd
+5056A8     (base 16)		Jolla Ltd
+				Itaemerenkatu 11-13
+				  Helsinki  00180
+				US
+
+E8-E7-70   (hex)		Warp9 Tech Design, Inc.
+E8E770     (base 16)		Warp9 Tech Design, Inc.
+				3650 Pheasant Run N.E.
+				Blaine  MN  55449
+				US
+
+60-96-20   (hex)		Private
+609620     (base 16)		Private
+
+C0-F9-91   (hex)		GME Standard Communications P/L
+C0F991     (base 16)		GME Standard Communications P/L
+				17 Gibbon Rd.
+				Winston Hills  New South Wales  2153
+				AU
+
+D8-7C-DD   (hex)		SANIX INCORPORATED
+D87CDD     (base 16)		SANIX INCORPORATED
+				Creation Core Fukuoka 212, 3-2-16 Kamikoga,
+				Chikushino-shi  Fukuoka  818-0041
+				JP
+
+70-7C-18   (hex)		ADATA Technology Co., Ltd
+707C18     (base 16)		ADATA Technology Co., Ltd
+				2F, No.258, Lian Cheng Rd.
+				New Taipei City    23553
+				TW
+
+14-F2-8E   (hex)		ShenYang ZhongKe-Allwin Technology Co.LTD
+14F28E     (base 16)		ShenYang ZhongKe-Allwin Technology Co.LTD
+				No.6, Gaoge Road,
+				ShenYang  Liaoning  110179
+				CN
+
+BC-14-EF   (hex)		ITON Technology Limited
+BC14EF     (base 16)		ITON Technology Limited
+				Room 1302,A ablock, Building 4
+				ShenZhen  GuangDong Pronvice  518000
+				CN
+
+08-03-71   (hex)		KRG CORPORATE
+080371     (base 16)		KRG CORPORATE
+				41 rue Perier
+				Montrouge    92120
+				FR
+
+20-0E-95   (hex)		IEC – TC9 WG43
+200E95     (base 16)		IEC – TC9 WG43
+				3, rue de Varembé
+				Geneva  GE  1211
+				CH
+
+C8-F6-8D   (hex)		S.E.TECHNOLOGIES LIMITED
+C8F68D     (base 16)		S.E.TECHNOLOGIES LIMITED
+				#303 Shiodome building Level3
+				Minato-ku  Tokyo  105-0022
+				JP
+
+3C-D4-D6   (hex)		WirelessWERX, Inc
+3CD4D6     (base 16)		WirelessWERX, Inc
+				22687 Old Canal Rd.
+				Yorba Linda  California  92887
+				US
+
+0C-12-62   (hex)		zte corporation
+0C1262     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+78-EC-74   (hex)		Kyland-USA
+78EC74     (base 16)		Kyland-USA
+				1107 SE Willow Pl
+				Blue Springs  MO  64014
+				US
+
+98-DA-92   (hex)		Vuzix Corporation
+98DA92     (base 16)		Vuzix Corporation
+				2166 Brighton Henrietta Town Line Road
+				Rochester  NY  14623
+				US
+
+38-7B-47   (hex)		AKELA, Inc.
+387B47     (base 16)		AKELA, Inc.
+				5551 Ekwill Street, Suite A
+				Santa Barbara  California  93111
+				US
+
+C0-64-C6   (hex)		Nokia Corporation
+C064C6     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+E4-04-39   (hex)		TomTom Software Ltd
+E40439     (base 16)		TomTom Software Ltd
+				20th Floor Euston Tower
+				London    NW1 3AS
+				GB
+
+D0-C4-2F   (hex)		Tamagawa Seiki Co.,Ltd.
+D0C42F     (base 16)		Tamagawa Seiki Co.,Ltd.
+				1-3-47 Kitainter Kogyodanchi
+				Hachinohe city  Aomori-Pref.  039-2245
+				US
+
+54-93-59   (hex)		SHENZHEN TWOWING TECHNOLOGIES CO.,LTD.
+549359     (base 16)		SHENZHEN TWOWING TECHNOLOGIES CO.,LTD.
+				F 4th ,5th , 6th, No.6 Building,
+				Shenzhen  Guangdong  518129
+				US
+
+90-35-6E   (hex)		Vodafone Omnitel N.V.
+90356E     (base 16)		Vodafone Omnitel N.V.
+				Via Guglielmo Jervis, 13
+				Ivrea  Italy / Tourin  10015
+				IT
+
+28-44-30   (hex)		GenesisTechnical Systems (UK) Ltd
+284430     (base 16)		GenesisTechnical Systems (UK) Ltd
+				Venture Centre
+				Coventry    CV4 7EZ
+				GB
+
+5C-11-93   (hex)		Seal One AG
+5C1193     (base 16)		Seal One AG
+				Berliner Str. 44
+				Frankfurt am Main  Hessen  60311
+				DE
+
+78-3D-5B   (hex)		TELNET Redes Inteligentes S.A.
+783D5B     (base 16)		TELNET Redes Inteligentes S.A.
+				Polígono Industrial Centrovía
+				La Muela  Zaragoza  50198
+				ES
+
+D0-B5-23   (hex)		Bestcare Cloucal Corp.
+D0B523     (base 16)		Bestcare Cloucal Corp.
+				4F.,No.106,Sec.1,Xintai 5th Rd.,
+				New Taipei City    22102
+				TW
+
+24-A4-95   (hex)		Thales Canada Inc.
+24A495     (base 16)		Thales Canada Inc.
+				105 Moatfield Road
+				Toronto  Ontario  M3B 0A4
+				CA
+
+84-76-16   (hex)		Addat s.r.o.
+847616     (base 16)		Addat s.r.o.
+				U krematoria 24
+				Liberec  Liberec  46001
+				CZ
+
+DC-05-75   (hex)		SIEMENS ENERGY AUTOMATION
+DC0575     (base 16)		SIEMENS ENERGY AUTOMATION
+				 GOA WORKS ,L-6 ,
+				VERNA  GOA   403722
+				IN
+
+E0-97-F2   (hex)		Atomax Inc.
+E097F2     (base 16)		Atomax Inc.
+				8F-1, No.300, Sec.1, Nei-hu Rd.
+				  Taipei  114
+				TW
+
+70-30-5E   (hex)		Nanjing Zhongke Menglian Information Technology Co.,LTD
+70305E     (base 16)		Nanjing Zhongke Menglian Information Technology Co.,LTD
+				3rd Floor,Building A,Area 3
+				Nanjing  Jiangsu  210042
+				CN
+
+C0-98-E5   (hex)		University of Michigan
+C098E5     (base 16)		University of Michigan
+				4808 Beyster Bldg,
+				Ann Arbor  Michigan  48109
+				US
+
+50-E1-4A   (hex)		Private
+50E14A     (base 16)		Private
+
+70-8D-09   (hex)		Nokia Corporation
+708D09     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+98-FB-12   (hex)		Grand Electronics (HK) Ltd
+98FB12     (base 16)		Grand Electronics (HK) Ltd
+				Flat/Room 1120, 11/F Beverley Commercial Centre
+				    999077
+				HK
+
+3C-10-40   (hex)		daesung network
+3C1040     (base 16)		daesung network
+				#209 e-space Bldg,Guro-dong,Guro-gu
+				Seoul    152-789
+				KR
+
+44-3C-9C   (hex)		Pintsch Tiefenbach GmbH
+443C9C     (base 16)		Pintsch Tiefenbach GmbH
+				Beisenbruchstrasse 10
+				Sprockhoevel    45549
+				DE
+
+28-FC-51   (hex)		The Electric Controller and Manufacturing Co., LLC
+28FC51     (base 16)		The Electric Controller and Manufacturing Co., LLC
+				PO Box 468
+				Saint Matthews  SC  29135
+				US
+
+40-74-96   (hex)		aFUN TECHNOLOGY INC.
+407496     (base 16)		aFUN TECHNOLOGY INC.
+				2F.,No.3,Lane29,HuLu ST.,Shihlin District,
+				Taipei    11165
+				TW
+
+70-1D-7F   (hex)		Comtech Technology Co., Ltd.
+701D7F     (base 16)		Comtech Technology Co., Ltd.
+				2F, No. 42, Sec. 3 Chung Yang Rd.
+				New Taipei City    23673
+				TW
+
+70-59-86   (hex)		OOO TTV
+705986     (base 16)		OOO TTV
+				No. 75, Okulov Street, Building 8
+				Perm    614068
+				RU
+
+84-4F-03   (hex)		Ablelink Electronics Ltd
+844F03     (base 16)		Ablelink Electronics Ltd
+				Flat 1602,16/F Kodak House 2 39 Healthy Street East,
+				    
+				CN
+
+90-67-17   (hex)		Alphion India Private Limited
+906717     (base 16)		Alphion India Private Limited
+				405 Windfall, Sahar Plaza
+				Mumbai  Maharashtra  400059
+				IN
+
+60-64-A1   (hex)		RADiflow Ltd.
+6064A1     (base 16)		RADiflow Ltd.
+				31 Habarzel St.
+				Tel Aviv    6971045
+				IL
+
+58-B9-61   (hex)		SOLEM Electronique
+58B961     (base 16)		SOLEM Electronique
+				ZAE La Plaine
+				CLAPIERS    34830
+				FR
+
+0C-47-3D   (hex)		Hitron Technologies. Inc
+0C473D     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+8C-CD-A2   (hex)		ACTP, Inc.
+8CCDA2     (base 16)		ACTP, Inc.
+				2400 Sand Lake Rd
+				Orlando  FL  32809
+				US
+
+84-26-2B   (hex)		Nokia
+84262B     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+98-6C-F5   (hex)		zte corporation
+986CF5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-7B-C4   (hex)		DualShine Technology(SZ)Co.,Ltd
+447BC4     (base 16)		DualShine Technology(SZ)Co.,Ltd
+				No.334-1,LuoTian 3rd Industrial Park,
+				Shen Zhen  Guang Dong  518000
+				CN
+
+9C-03-9E   (hex)		Beijing Winchannel Software Technology Co., Ltd
+9C039E     (base 16)		Beijing Winchannel Software Technology Co., Ltd
+				8F, Block E, Dazhongsi Zhongkun Plaza No. A
+				Haidian District  BEIJING  100089
+				CN
+
+68-0A-D7   (hex)		Yancheng Kecheng Optoelectronic Technology Co., Ltd
+680AD7     (base 16)		Yancheng Kecheng Optoelectronic Technology Co., Ltd
+				No.1 East Road, Kaifa Avenue,
+				Yancheng  Jiangsu  224007
+				CN
+
+BC-88-93   (hex)		VILLBAU Ltd.
+BC8893     (base 16)		VILLBAU Ltd.
+				Üllöi ut 611.
+				Budapest  -  H-1182
+				HU
+
+70-61-73   (hex)		Calantec GmbH
+706173     (base 16)		Calantec GmbH
+				Doebelner Str. 4
+				  Berlin  12627
+				DE
+
+7C-49-B9   (hex)		Plexus Manufacturing Sdn Bhd
+7C49B9     (base 16)		Plexus Manufacturing Sdn Bhd
+				Plot 87
+				Bayan Lepas  Penang  11900
+				MY
+
+9C-F8-DB   (hex)		shenzhen eyunmei technology co,.ltd
+9CF8DB     (base 16)		shenzhen eyunmei technology co,.ltd
+				8/F Yiben Building,No.1063 ChaGuang Road,XiLi Town,
+				Shenzhen  Guangdong  518055
+				CN
+
+20-D2-1F   (hex)		Wincal Technology Corp.
+20D21F     (base 16)		Wincal Technology Corp.
+				1028 South Greenwood Ave.
+				Montebello  California  90640
+				US
+
+F8-95-50   (hex)		Proton Products Chengdu Ltd
+F89550     (base 16)		Proton Products Chengdu Ltd
+				1st Ring
+				Chengdu  Sichuan  610051
+				CN
+
+58-63-9A   (hex)		TPL SYSTEMES
+58639A     (base 16)		TPL SYSTEMES
+				ZAE DU PERIGORD NOIR
+				SARLAT    24200
+				FR
+
+18-7E-D5   (hex)		shenzhen kaism technology Co. Ltd
+187ED5     (base 16)		shenzhen kaism technology Co. Ltd
+				37# chuanglong west road pinghu shenzhen
+				shenzhen    518111
+				CN
+
+84-1B-38   (hex)		Shenzhen Excelsecu Data Technology Co.,Ltd
+841B38     (base 16)		Shenzhen Excelsecu Data Technology Co.,Ltd
+				Unit 701-709,7/F，South Block,SDGI Building A, No.2,
+				Shenzhen  Guangdong  518057
+				CN
+
+4C-CB-F5   (hex)		zte corporation
+4CCBF5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+44-70-0B   (hex)		IFFU
+44700B     (base 16)		IFFU
+				33, Annyeom-gil 112 beon-gil,jeongnam-myeon
+				Hwaseong-si  Gyeonggi-do  445-968
+				US
+
+54-A5-4B   (hex)		NSC Communications Siberia Ltd
+54A54B     (base 16)		NSC Communications Siberia Ltd
+				Ordjonikidze 38
+				  Novosibirsk  630099
+				RU
+
+BC-2B-6B   (hex)		Beijing Haier IC Design Co.,Ltd
+BC2B6B     (base 16)		Beijing Haier IC Design Co.,Ltd
+				Room 205, Tongheng Building, No.4 Huayuan Road, Haidian District
+				Beijing  Beijing  100088
+				CN
+
+98-D3-31   (hex)		Shenzhen Bolutek Technology Co.,Ltd.
+98D331     (base 16)		Shenzhen Bolutek Technology Co.,Ltd.
+				Building B, District A, Internet industry base, Baoan
+				Shenzhen  Guangdong  518000
+				CN
+
+38-EC-11   (hex)		Novatek Microelectronics Corp.
+38EC11     (base 16)		Novatek Microelectronics Corp.
+				No.1-2 Innovation Rd I.,
+				Hsinchu    300
+				TW
+
+1C-41-58   (hex)		Gemalto M2M GmbH
+1C4158     (base 16)		Gemalto M2M GmbH
+				Siemensdamm 50
+				Berlin  Berlin  13629
+				DE
+
+9C-28-40   (hex)		Discovery Technology,LTD..
+9C2840     (base 16)		Discovery Technology,LTD..
+				5th floor Building 2,Block A,Internet industrial park,
+				Shenzhen  Guangzhou  518100
+				CN
+
+1C-7B-21   (hex)		Sony Mobile Communications Inc
+1C7B21     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+E0-AF-4B   (hex)		Pluribus Networks, Inc.
+E0AF4B     (base 16)		Pluribus Networks, Inc.
+				1808 Embarcadero Rd Suite B
+				Palo Alto  CA  94303
+				US
+
+84-0F-45   (hex)		Shanghai GMT Digital Technologies Co., Ltd
+840F45     (base 16)		Shanghai GMT Digital Technologies Co., Ltd
+				Room 501-505
+				Zhangjiang Hi-tech Park  Shanghai  201204
+				CN
+
+2C-5F-F3   (hex)		Pertronic Industries
+2C5FF3     (base 16)		Pertronic Industries
+				17 Eastern Hutt Road
+				Wingate    5019
+				NZ
+
+78-49-1D   (hex)		The Will-Burt Company
+78491D     (base 16)		The Will-Burt Company
+				169 S. Main St.
+				Orrivlle  Ohio  44667
+				US
+
+F4-6A-BC   (hex)		Adonit Corp. Ltd.
+F46ABC     (base 16)		Adonit Corp. Ltd.
+				10689 Rm. A, 9F, No.107 Sec.4 Ren-Ai Rd.,
+				Taipei  Taipei  10689
+				TW
+
+28-C6-71   (hex)		Yota Devices OY
+28C671     (base 16)		Yota Devices OY
+				Elektronikkatie 13
+				Oulu    90590
+				FI
+
+D8-69-60   (hex)		Steinsvik
+D86960     (base 16)		Steinsvik
+				Rundhaug 25
+				FOERRESFJORDEN  Rogaland  5563
+				NO
+
+08-EF-3B   (hex)		MCS Logic Inc.
+08EF3B     (base 16)		MCS Logic Inc.
+				6F. Samho Center B Bldg., 275-6,Yangjae-Dong, Secho-Ku,Seoul
+				Seoul    137-941
+				KR
+
+E8-EA-DA   (hex)		Denkovi Assembly Electronics LTD
+E8EADA     (base 16)		Denkovi Assembly Electronics LTD
+				St. Stambolov str. 21
+				Byala  Rousse  7100
+				BG
+
+F8-5B-C9   (hex)		M-Cube Spa
+F85BC9     (base 16)		M-Cube Spa
+				Corso Cavour 2/2d
+				  Trieste  34132
+				IT
+
+7C-B7-7B   (hex)		Paradigm Electronics Inc
+7CB77B     (base 16)		Paradigm Electronics Inc
+				5340 Canotek Rd Unit#4
+				Ottawa  ON  K1J 9C6
+				CA
+
+B0-CE-18   (hex)		Zhejiang shenghui lighting co.,Ltd
+B0CE18     (base 16)		Zhejiang shenghui lighting co.,Ltd
+				Rm801,1th Xinye Building
+				cao he jing Develop Zone  Shanghai  200233
+				CN
+
+6C-F9-7C   (hex)		Nanoptix Inc.
+6CF97C     (base 16)		Nanoptix Inc.
+				699 Champlain St
+				Dieppe  NB  E1A 1P6
+				CA
+
+F8-FF-5F   (hex)		Shenzhen Communication Technology Co.,Ltd
+F8FF5F     (base 16)		Shenzhen Communication Technology Co.,Ltd
+				2F,6 Block, Kupai inforport,No.2 Mengxi Street,(North)High-tech Industrial Park,
+				Shenzhen  Guangdong  518057
+				CN
+
+10-22-79   (hex)		ZeroDesktop, Inc.
+102279     (base 16)		ZeroDesktop, Inc.
+				125 University Ave, Suite 150
+				Palo Alto  California  94301
+				US
+
+7C-1A-FC   (hex)		Dalian Co-Edifice Video Technology Co., Ltd
+7C1AFC     (base 16)		Dalian Co-Edifice Video Technology Co., Ltd
+				23F , Block A , #32 Huoju Road , Hi-Tech Zone
+				Dalian  Liaoning  116023
+				CN
+
+F4-7A-4E   (hex)		Woojeon&Handan
+F47A4E     (base 16)		Woojeon&Handan
+				569-12, Gasan-dong,
+				Seoul    153-803
+				KR
+
+04-84-8A   (hex)		7INOVA TECHNOLOGY LIMITED
+04848A     (base 16)		7INOVA TECHNOLOGY LIMITED
+				3F, A Building, QuanYuanFa Industrial Park, No. 72, GuanLan Rd
+				LongHua District  Shenzhen  518000
+				CN
+
+EC-22-57   (hex)		JiangSu NanJing University Electronic Information Technology Co.,Ltd
+EC2257     (base 16)		JiangSu NanJing University Electronic Information Technology Co.,Ltd
+				F7,Block 06
+				NanJing  JiangSu  210000
+				CN
+
+F0-37-A1   (hex)		Huike Electronics (SHENZHEN) CO., LTD.
+F037A1     (base 16)		Huike Electronics (SHENZHEN) CO., LTD.
+				Huike industrial park,Minying industrial park,Shuitian country,Shiyan,Baoan District
+				SHENZHEN  GUANGDONG  518108
+				CN
+
+70-4C-ED   (hex)		TMRG, Inc.
+704CED     (base 16)		TMRG, Inc.
+				11950 Democracy Drive
+				Reston  VA  20190
+				US
+
+F0-8E-DB   (hex)		VeloCloud Networks
+F08EDB     (base 16)		VeloCloud Networks
+				720 University Ave.
+				Palo Alto  CA  94301
+				US
+
+C0-A3-9E   (hex)		EarthCam, Inc.
+C0A39E     (base 16)		EarthCam, Inc.
+				84 Kennedy Street
+				Hackensack  New Jersey  07601
+				US
+
+10-9A-B9   (hex)		Tosibox Oy
+109AB9     (base 16)		Tosibox Oy
+				Elektroniikkatie 8
+				  Oulu  90590
+				FI
+
+14-2D-8B   (hex)		Incipio Technologies, Inc
+142D8B     (base 16)		Incipio Technologies, Inc
+				6001 Oak Canyon
+				Irvine  CA  92618
+				US
+
+68-EE-96   (hex)		Cisco SPVTG
+68EE96     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+78-D3-8D   (hex)		HONGKONG YUNLINK TECHNOLOGY LIMITED
+78D38D     (base 16)		HONGKONG YUNLINK TECHNOLOGY LIMITED
+				15B 15/F CHEUK NANG PLAZA 250 HENNESSY RD HK
+				ShenzhenCity  Guangdong Province  518103
+				US
+
+DC-AE-04   (hex)		CELOXICA Ltd
+DCAE04     (base 16)		CELOXICA Ltd
+				34 Porchester Road
+				  London  W2 6ES
+				GB
+
+80-05-DF   (hex)		Montage Technology Group Limited
+8005DF     (base 16)		Montage Technology Group Limited
+				Rm#A16F, Technolgy Blgd.,Yishan Rd.
+				Shanghai    200233
+				CN
+
+68-1D-64   (hex)		Sunwave Communications Co., Ltd
+681D64     (base 16)		Sunwave Communications Co., Ltd
+				581,huoju Avenue,BinJiang District
+				 Hangzhou  Zhejiang Province  310053
+				CN
+
+4C-21-D0   (hex)		Sony Mobile Communications Inc
+4C21D0     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+90-7A-0A   (hex)		Gebr. Bode GmbH & Co KG
+907A0A     (base 16)		Gebr. Bode GmbH & Co KG
+				Ochshaeuser Str. 14
+				Kassel    34266
+				DE
+
+A0-C6-EC   (hex)		ShenZhen ANYK Technology Co.,LTD
+A0C6EC     (base 16)		ShenZhen ANYK Technology Co.,LTD
+				5F,12B,ZhongXing Industrial Zone, Venture Road
+				ShenZhen  GuangDong  518054
+				CN
+
+78-E8-B6   (hex)		zte corporation
+78E8B6     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-78-CE   (hex)		Hanvit SI, Inc.
+1078CE     (base 16)		Hanvit SI, Inc.
+				#201 Daeheung Building, 265-18 Yangjae-dong
+				Seoul    137130
+				KR
+
+D8-DA-52   (hex)		APATOR S.A.
+D8DA52     (base 16)		APATOR S.A.
+				ul Gdanska 4A lok. C4
+				Torun  Kujawsko-Pomorskie  87-100
+				PL
+
+58-7A-4D   (hex)		Stonesoft Corporation
+587A4D     (base 16)		Stonesoft Corporation
+				Italahdenkatu 22A
+				Helsinki    00210
+				FI
+
+84-E6-29   (hex)		Bluwan SA
+84E629     (base 16)		Bluwan SA
+				Espace Lumiere, Bat 2
+				Chatou    78400
+				FR
+
+C4-7F-51   (hex)		Inventek Systems
+C47F51     (base 16)		Inventek Systems
+				2 Republic Road
+				Billerica  Ma  01862
+				US
+
+A8-97-DC   (hex)		IBM
+A897DC     (base 16)		IBM
+				4400 North First Street
+				San Jose  CA  95134
+				US
+
+CC-D2-9B   (hex)		Shenzhen Bopengfa Elec&Technology CO.,Ltd
+CCD29B     (base 16)		Shenzhen Bopengfa Elec&Technology CO.,Ltd
+				 Bldg56A,3/F,Baotian Rd3,Xixiang Town
+				shenzhen  guangdong  518000
+				CN
+
+A0-9B-BD   (hex)		Total Aviation Solutions Pty Ltd
+A09BBD     (base 16)		Total Aviation Solutions Pty Ltd
+				Suite 816A / 3 PARKLAND BVDE
+				Brisbane  QLD  4000
+				AU
+
+D4-0B-B9   (hex)		Solid Semecs bv.
+D40BB9     (base 16)		Solid Semecs bv.
+				Oostwijk 18
+				Uden  Noord Brabant  5406 XT
+				NL
+
+F4-15-FD   (hex)		Shanghai Pateo Electronic Equipment Manufacturing Co., Ltd.
+F415FD     (base 16)		Shanghai Pateo Electronic Equipment Manufacturing Co., Ltd.
+				20th Floor, Metro Tower
+				Xuhui District  Shanghai  200030
+				CN
+
+70-E0-27   (hex)		HONGYU COMMUNICATION TECHNOLOGY LIMITED
+70E027     (base 16)		HONGYU COMMUNICATION TECHNOLOGY LIMITED
+				Room4B, East Building 210,
+				Shen Zhen  Guang Dong Province  518040
+				CN
+
+FC-35-E6   (hex)		Visteon corp
+FC35E6     (base 16)		Visteon corp
+				One Village Center Dr
+				Belleville  MI  48111
+				US
+
+E8-48-1F   (hex)		Advanced Automotive Antennas
+E8481F     (base 16)		Advanced Automotive Antennas
+				Pol.Ind Can Mitjans s/n
+				Viladecavalls  Barcelona  08232
+				ES
+
+34-95-DB   (hex)		Logitec Corporation
+3495DB     (base 16)		Logitec Corporation
+				8268 Rokudohara, Misuzu
+				Ina  Nagano  
+				JP
+
+9C-B7-93   (hex)		Creatcomm Technology Inc.
+9CB793     (base 16)		Creatcomm Technology Inc.
+				Rm 619, Buld A, Modern Plaza
+				Kunshan  Jiangsu  201203
+				CN
+
+5C-33-5C   (hex)		Swissphone Telecom AG
+5C335C     (base 16)		Swissphone Telecom AG
+				Faelmisstrasse 21
+				Samstagern  Zurich  CH-8833
+				CH
+
+04-DF-69   (hex)		Car Connectivity Consortium
+04DF69     (base 16)		Car Connectivity Consortium
+				3855 SW 153rd Drive
+				Beaverton  Oregon  97006
+				US
+
+78-DA-B3   (hex)		GBO Technology
+78DAB3     (base 16)		GBO Technology
+				1150 Bayhill Dr. Ste. 111
+				San Bruno  CA  94066
+				US
+
+70-0F-EC   (hex)		Poindus Systems Corp.
+700FEC     (base 16)		Poindus Systems Corp.
+				5F., No. 59, Lane. 77, Xing-Ai Rd., Neihu Dist.,
+				 Taipei City    114
+				TW
+
+F0-24-05   (hex)		OPUS High Technology Corporation
+F02405     (base 16)		OPUS High Technology Corporation
+				1st Floor, No. 367, Gaocui Road
+				Hsinchu City    30064
+				TW
+
+D4-10-90   (hex)		iNFORM Systems AG
+D41090     (base 16)		iNFORM Systems AG
+				Europastrasse 15
+				Glattbrugg    8152
+				CH
+
+78-D5-B5   (hex)		NAVIELEKTRO KY
+78D5B5     (base 16)		NAVIELEKTRO KY
+				HALLIMESTARINKATU 11
+				KAARINA    FIN-20780
+				FI
+
+E4-7D-5A   (hex)		Beijing Hanbang Technology Corp.
+E47D5A     (base 16)		Beijing Hanbang Technology Corp.
+				4/F,Skirt Building
+				Haidian District  Beijing  100080
+				CN
+
+E4-F7-A1   (hex)		Datafox GmbH
+E4F7A1     (base 16)		Datafox GmbH
+				Dermbacher Str. 12 - 14
+				Geisa  Thüringen  36419
+				DE
+
+10-5C-3B   (hex)		Perma-Pipe, Inc.
+105C3B     (base 16)		Perma-Pipe, Inc.
+				7720 Lehigh Ave
+				Niles  IL  60714
+				US
+
+34-9D-90   (hex)		Heinzmann GmbH & CO. KG
+349D90     (base 16)		Heinzmann GmbH & CO. KG
+				Am Haselbach 1
+				Schoenau  Baden Wuertemberg  79677
+				DE
+
+D8-62-DB   (hex)		Eno Inc.
+D862DB     (base 16)		Eno Inc.
+				2-3-18, Komagome, Toshima-ku
+				Tokyo    1700013
+				JP
+
+C4-7D-FE   (hex)		A.N. Solutions GmbH
+C47DFE     (base 16)		A.N. Solutions GmbH
+				Am Brauhaus 12
+				Dresden  Saxony  01099
+				DE
+
+CC-BD-35   (hex)		Steinel GmbH
+CCBD35     (base 16)		Steinel GmbH
+				Dieselstrasse 80-84
+				Herzebrock-Clarholz    33442
+				DE
+
+6C-EC-A1   (hex)		SHENZHEN CLOU ELECTRONICS CO. LTD.
+6CECA1     (base 16)		SHENZHEN CLOU ELECTRONICS CO. LTD.
+				5/F, building. T2, Hi-tech Industrial Park
+				SHENZ  GUANGONG  518057
+				CN
+
+B0-38-50   (hex)		Nanjing CAS-ZDC IOT SYSTEM CO.,LTD
+B03850     (base 16)		Nanjing CAS-ZDC IOT SYSTEM CO.,LTD
+				699-27 Xuanwu Avenue
+				Nanjing  Jiangsu  210000
+				CN
+
+74-8E-08   (hex)		Bestek Corp.
+748E08     (base 16)		Bestek Corp.
+				No. 6, Lane 229, Sec. 3, Chang-Xing Rd.
+				Taoyuan    33852
+				TW
+
+78-F5-E5   (hex)		BEGA Gantenbrink-Leuchten KG
+78F5E5     (base 16)		BEGA Gantenbrink-Leuchten KG
+				Hennenbusch
+				Menden  NRW  58708
+				DE
+
+8C-3C-07   (hex)		Skiva Technologies, Inc.
+8C3C07     (base 16)		Skiva Technologies, Inc.
+				8330 Sterling St
+				Irving  TX  75063
+				US
+
+38-A8-6B   (hex)		Orga BV
+38A86B     (base 16)		Orga BV
+				Strickledeweg 13
+				Schiedam    3125 AT
+				NL
+
+F0-77-65   (hex)		Sourcefire, Inc
+F07765     (base 16)		Sourcefire, Inc
+				9780 Patuxent Woods Drive
+				Columbia  Maryland  21046
+				US
+
+14-41-E2   (hex)		Monaco Enterprises, Inc.
+1441E2     (base 16)		Monaco Enterprises, Inc.
+				14820 E. Sprague Ave.
+				Spokane  WA  99216
+				US
+
+EC-D0-40   (hex)		GEA Farm Technologies GmbH
+ECD040     (base 16)		GEA Farm Technologies GmbH
+				Siemensstrasse 25-27
+				Boenen  Northrhine-Westfalia  59199
+				DE
+
+F8-0D-EA   (hex)		ZyCast Technology Inc.
+F80DEA     (base 16)		ZyCast Technology Inc.
+				No.33, Lane 181, Chung Hwa Road,
+				Hsin Chu    30060
+				TW
+
+B0-88-07   (hex)		Strata Worldwide
+B08807     (base 16)		Strata Worldwide
+				8995 Roswell Road
+				Sandy Springs  GA  30350
+				US
+
+24-95-04   (hex)		SFR
+249504     (base 16)		SFR
+				40-42 QUAI DU POINT DU JOUR
+				BOULOGNE BILLANCOURT  HAUT DE SEINE  92100
+				FR
+
+F4-58-42   (hex)		Boxx TV Ltd
+F45842     (base 16)		Boxx TV Ltd
+				Suite 17, Imperial Studios
+				  London  SW6 2AG
+				GB
+
+10-66-82   (hex)		NEC Platforms, Ltd.
+106682     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+24-62-78   (hex)		sysmocom - systems for mobile communications GmbH
+246278     (base 16)		sysmocom - systems for mobile communications GmbH
+				Alt-Moabit 93
+				  Berlin  10559
+				DE
+
+F0-84-C9   (hex)		zte corporation
+F084C9     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-01-6D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D4016D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+98-5C-93   (hex)		SBG Systems SAS
+985C93     (base 16)		SBG Systems SAS
+				3bis, chemin de la Jonchere
+				Rueil Malmaison  Ile de France  92500
+				FR
+
+A0-8A-87   (hex)		HuiZhou KaiYue Electronic Co.,Ltd
+A08A87     (base 16)		HuiZhou KaiYue Electronic Co.,Ltd
+				3#,Ruttang 2nd area,Tongcheng Avenue
+				Huizhou  Guangdong  516005
+				CN
+
+28-CD-9C   (hex)		Shenzhen Dynamax Software Development Co.,Ltd.
+28CD9C     (base 16)		Shenzhen Dynamax Software Development Co.,Ltd.
+				Room 425-426,Block A,No.30,Hangkong Road
+				Shenzhen  Guangdong  518000
+				CN
+
+C0-C3-B6   (hex)		Automatic Systems
+C0C3B6     (base 16)		Automatic Systems
+				avenue mercator,5
+				Wavre  Belgium  1300
+				BE
+
+A0-EB-76   (hex)		AirCUVE Inc.
+A0EB76     (base 16)		AirCUVE Inc.
+				Guro-gu Digital-ro
+				  Seoul  152-719
+				KR
+
+FC-44-99   (hex)		Swarco LEA d.o.o.
+FC4499     (base 16)		Swarco LEA d.o.o.
+				Finzgarjeva 1A
+				Lesce    4248
+				SI
+
+DC-64-7C   (hex)		C.R.S. iiMotion GmbH
+DC647C     (base 16)		C.R.S. iiMotion GmbH
+				Hermann-Schwer-Str. 3
+				Villingen-Schwenningen    78048
+				DE
+
+14-86-92   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+148692     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+A8-15-4D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+A8154D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+5C-F3-70   (hex)		CC&C Technologies, Inc
+5CF370     (base 16)		CC&C Technologies, Inc
+				8F, 150, Chien I Rd.
+				Chung Ho  Taiwan  235
+				TW
+
+A4-E0-E6   (hex)		FILIZOLA S.A. PESAGEM E AUTOMACAO
+A4E0E6     (base 16)		FILIZOLA S.A. PESAGEM E AUTOMACAO
+				RUA JOAO VENTURA BATISTA, 450
+				  SAO PAULO  02054-100
+				BR
+
+38-17-66   (hex)		PROMZAKAZ LTD.
+381766     (base 16)		PROMZAKAZ LTD.
+				Noviy Arbat street, 21
+				  Moscow  119019
+				RU
+
+18-E8-DD   (hex)		MODULETEK
+18E8DD     (base 16)		MODULETEK
+				Unit 4A.4F.B Building. Shenfubao Science and Technology Industrial Park
+				Shenzhen  Guangdong  518038
+				CN
+
+D0-73-D5   (hex)		LIFI LABS MANAGEMENT PTY LTD
+D073D5     (base 16)		LIFI LABS MANAGEMENT PTY LTD
+				7 Cubitt St
+				Richmond  Victoria  3121
+				AU
+
+14-94-48   (hex)		BLU CASTLE S.A.
+149448     (base 16)		BLU CASTLE S.A.
+				5 RUE BONNEVOIE
+				  LUXEMBOURG  L-1260
+				US
+
+48-F9-25   (hex)		Maestronic
+48F925     (base 16)		Maestronic
+				Futura plaza 2103
+				Kwun Tong    88
+				HK
+
+38-67-93   (hex)		Asia Optical Co., Inc.
+386793     (base 16)		Asia Optical Co., Inc.
+				No. 22-3 South 2nd Road, T.E.P.Z.
+				Taichung  Taiwan  42754
+				TW
+
+0C-82-68   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0C8268     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-1E-DE   (hex)		B&W Group Ltd
+D81EDE     (base 16)		B&W Group Ltd
+				5070 Francois Cusson
+				Lachine  Quebec  H8T1B3
+				CA
+
+24-EA-40   (hex)		Helmholz GmbH & Co. KG
+24EA40     (base 16)		Helmholz GmbH & Co. KG
+				Hannberger Weg 2
+				Grossenseebach  BAY  91091
+				DE
+
+D4-29-EA   (hex)		Zimory GmbH
+D429EA     (base 16)		Zimory GmbH
+				Revalerstrasse 100
+				Berlin  Brandenburg  10245
+				DE
+
+34-AD-E4   (hex)		Shanghai Chint Power Systems Co., Ltd.
+34ADE4     (base 16)		Shanghai Chint Power Systems Co., Ltd.
+				855 Wenhe Road, Block 4
+				    201614
+				CN
+
+3C-94-D5   (hex)		Juniper Networks
+3C94D5     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+68-83-1A   (hex)		Pandora Mobility Corporation
+68831A     (base 16)		Pandora Mobility Corporation
+				1F., No.33, Fude St
+				Taoyuan  Guishan  333
+				TW
+
+FC-DB-96   (hex)		ENERVALLEY CO., LTD
+FCDB96     (base 16)		ENERVALLEY CO., LTD
+				907-101 DIGITAL EMPIRE II
+				SUWON SI  GYEONGGI DO  443 734
+				KR
+
+14-23-D7   (hex)		EUTRONIX CO., LTD.
+1423D7     (base 16)		EUTRONIX CO., LTD.
+				EUTRONIX BLDG. 4TH FLOOR
+				ANYANG  KYEONGGI  431-804
+				US
+
+DC-6F-08   (hex)		Bay Storage Technology
+DC6F08     (base 16)		Bay Storage Technology
+				6200 Stoneridge Mall Road
+				Pleasanton  CA  94588
+				US
+
+90-DA-4E   (hex)		AVANU
+90DA4E     (base 16)		AVANU
+				5205 Prospect Rd
+				San Jose  CA  95129-5034
+				US
+
+28-18-78   (hex)		Microsoft Corporation
+281878     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+70-38-B4   (hex)		Low Tech Solutions
+7038B4     (base 16)		Low Tech Solutions
+				350 N. Orleans
+				Chicago  IL  60654
+				US
+
+74-5F-00   (hex)		Samsung Semiconductor Inc.
+745F00     (base 16)		Samsung Semiconductor Inc.
+				3566 N. 1St Street
+				San Jose  CA  95134
+				US
+
+E0-C3-F3   (hex)		zte corporation
+E0C3F3     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+5C-20-D0   (hex)		Asoni Communication Co., Ltd.
+5C20D0     (base 16)		Asoni Communication Co., Ltd.
+				 21F-1, No.97, Sec. 4, Chongsin Rd., Sanchong District
+				New Taipei City  Taiwan  24161
+				TW
+
+AC-A4-30   (hex)		Peerless AV
+ACA430     (base 16)		Peerless AV
+				2300 White Oak Circle
+				Aurora  illinios  60502
+				US
+
+84-7A-88   (hex)		HTC Corporation
+847A88     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+A4-D8-56   (hex)		Gimbal, Inc
+A4D856     (base 16)		Gimbal, Inc
+				12526 High Bluff Drive
+				San Diego  Ca  92130
+				US
+
+78-55-17   (hex)		SankyuElectronics
+785517     (base 16)		SankyuElectronics
+				2-30-12
+				Ohta-ku  Tokyo  146-0091
+				JP
+
+B4-7F-5E   (hex)		Foresight Manufacture (S) Pte Ltd
+B47F5E     (base 16)		Foresight Manufacture (S) Pte Ltd
+				1 Sims Lane #04-09
+				  Singapore  387355
+				SG
+
+A0-FE-91   (hex)		AVAT Automation GmbH
+A0FE91     (base 16)		AVAT Automation GmbH
+				Derendinger Strasse 40
+				Tuebingen    72072
+				DE
+
+74-EC-F1   (hex)		Acumen
+74ECF1     (base 16)		Acumen
+				6F, No.207-3, Sec 3, Beisin Rd
+				Sindian Dist  New Taipei City  23143
+				US
+
+58-09-E5   (hex)		Kivic Inc.
+5809E5     (base 16)		Kivic Inc.
+				670 Sampyeong-dong, Bundang-gu
+				  Seongnam City  463-400
+				KR
+
+50-4F-94   (hex)		Loxone Electronics GmbH
+504F94     (base 16)		Loxone Electronics GmbH
+				Falkensteinstraße 6
+				Kollerschlag  Upper Austria  4154
+				AT
+
+60-B1-85   (hex)		ATH system
+60B185     (base 16)		ATH system
+				Osady Lezaku 498
+				Chrast    53851
+				CZ
+
+BC-62-9F   (hex)		Telenet Systems P. Ltd.
+BC629F     (base 16)		Telenet Systems P. Ltd.
+				2 Mani Bhuvan, Cama Road
+				Mumbai  Maharashtra  400086
+				IN
+
+38-0F-E4   (hex)		Dedicated Network Partners Oy
+380FE4     (base 16)		Dedicated Network Partners Oy
+				Linnoitustie 6
+				Espoo  -  02600
+				FI
+
+48-F2-30   (hex)		Ubizcore Co.,LTD
+48F230     (base 16)		Ubizcore Co.,LTD
+				Kranz Techno #1420, Sangdaewon 1-dong
+				Seongnam-Si    462-729
+				KR
+
+78-32-4F   (hex)		Millennium Group, Inc.
+78324F     (base 16)		Millennium Group, Inc.
+				16 Tech Circle
+				Natick  MA  01760
+				US
+
+38-43-69   (hex)		Patrol Products Consortium LLC
+384369     (base 16)		Patrol Products Consortium LLC
+				1128 Narragansett Blvd.
+				Cranston  RI  02905
+				US
+
+44-18-4F   (hex)		Fitview
+44184F     (base 16)		Fitview
+				5615 Scotts Valley Drive, Suite 110
+				Scotts Valley  CA  95066
+				US
+
+84-AC-A4   (hex)		Beijing Novel Super Digital TV Technology Co., Ltd
+84ACA4     (base 16)		Beijing Novel Super Digital TV Technology Co., Ltd
+				4F Tower B Jingmeng Hightech building
+				  Beijing  100085
+				CN
+
+54-1F-D5   (hex)		Advantage Electronics
+541FD5     (base 16)		Advantage Electronics
+				PO Box 407
+				Greenwood  IN  46143
+				US
+
+AC-E9-7F   (hex)		IoT Tech Limited
+ACE97F     (base 16)		IoT Tech Limited
+				20b Lough Road
+				Lisburn  Antrim  BT28 2HA
+				GB
+
+E8-5A-A7   (hex)		LLC Emzior
+E85AA7     (base 16)		LLC Emzior
+				Strelna, Svyazi street, 34, Lit A, of. 234
+				Saint-Petersburg    198515
+				RU
+
+9C-9C-1D   (hex)		Starkey Labs Inc.
+9C9C1D     (base 16)		Starkey Labs Inc.
+				6600 Washington Ave. S.
+				Eden Prairie  MN  55344
+				US
+
+D0-D6-CC   (hex)		Wintop
+D0D6CC     (base 16)		Wintop
+				No. 1301,Xinfei Road
+				Songjiang District  Shanghai  201612
+				CN
+
+58-D0-71   (hex)		BW Broadcast
+58D071     (base 16)		BW Broadcast
+				Unit 27 IO Centre
+				Croydon  Surrey  CR0 4WQ
+				GB
+
+1C-52-D6   (hex)		FLAT DISPLAY TECHNOLOGY CORPORATION
+1C52D6     (base 16)		FLAT DISPLAY TECHNOLOGY CORPORATION
+				No.85, Sec. 1, Fuxing Rd., South Dist
+				Taichung    402
+				TW
+
+D0-DF-B2   (hex)		Genie Networks Limited
+D0DFB2     (base 16)		Genie Networks Limited
+				5F, No.15, Lane 360, Sec., 1, Neihu Road,
+				Taipei    114
+				TW
+
+38-66-45   (hex)		OOSIC Technology CO.,Ltd
+386645     (base 16)		OOSIC Technology CO.,Ltd
+				8F,No 1559, Zuchongzhi Road
+				  Shanghai  201203
+				CN
+
+B8-5A-F7   (hex)		Ouya, Inc
+B85AF7     (base 16)		Ouya, Inc
+				11693 San Vicente Blvd
+				Los Angeles  CA  90049
+				US
+
+34-F6-2D   (hex)		SHARP Corporation
+34F62D     (base 16)		SHARP Corporation
+				1 Takumi-cho, Sakai-ku
+				Sakai City  Osaka  590-8522
+				JP
+
+4C-8F-A5   (hex)		Jastec
+4C8FA5     (base 16)		Jastec
+				Jastec B/D 2F, 92-7 Kumgok-dong, 
+				Boondang-gu,    463-804
+				KR
+
+84-ED-33   (hex)		BBMC Co.,Ltd
+84ED33     (base 16)		BBMC Co.,Ltd
+				#301, DaerungPostTower 3, 182-4,
+				Seoul  None  152-746
+				KR
+
+E8-2E-24   (hex)		Out of the Fog Research LLC
+E82E24     (base 16)		Out of the Fog Research LLC
+				565 Clyde Avenue, Suite 620
+				Mountain View  CA  94043
+				US
+
+80-FA-5B   (hex)		CLEVO CO.
+80FA5B     (base 16)		CLEVO CO.
+				NO. 129, XINGDE ROAD
+				New TAIPEI CITY    241
+				TW
+
+C0-B3-39   (hex)		Comigo Ltd.
+C0B339     (base 16)		Comigo Ltd.
+				15 HaPardes St.
+				  Yarkona  45915
+				IL
+
+20-85-8C   (hex)		Assa
+20858C     (base 16)		Assa
+				Gurogu Guro3dong Ace Twintower 2cha 209
+				  Seoul  152-779
+				KR
+
+60-CD-C5   (hex)		Taiwan Carol Electronics., Ltd
+60CDC5     (base 16)		Taiwan Carol Electronics., Ltd
+				No.202, Tung Kuang Road
+				Taichung  Taiwan  40151
+				TW
+
+D8-18-2B   (hex)		Conti Temic Microelectronic GmbH
+D8182B     (base 16)		Conti Temic Microelectronic GmbH
+				Sieboldstraße 19
+				Nuremberg  Bavaria  90411
+				DE
+
+80-CF-41   (hex)		Lenovo Mobile Communication Technology Ltd.
+80CF41     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,Torch Hi-tech Industry Development Zone,
+				Xiamen  Fujian  361006
+				US
+
+9C-E1-D6   (hex)		Junger Audio-Studiotechnik GmbH
+9CE1D6     (base 16)		Junger Audio-Studiotechnik GmbH
+				Justus-von-Liebig-Strasse 7
+				12489 Berlin    
+				US
+
+48-B9-C2   (hex)		Teletics Inc.
+48B9C2     (base 16)		Teletics Inc.
+				103 Edgevalley Close NW
+				Calgary  AB  T3A 5E9
+				CA
+
+58-D6-D3   (hex)		Dairy Cheq Inc
+58D6D3     (base 16)		Dairy Cheq Inc
+				60 Baffin Place, Unit 5
+				Waterloo  Ontario  N2V 1Z7
+				CA
+
+04-6E-49   (hex)		TaiYear Electronic Technology (Suzhou) Co., Ltd
+046E49     (base 16)		TaiYear Electronic Technology (Suzhou) Co., Ltd
+				12-B101 Creative Industrial Park ,No. 328,Xinghu Street ,Suzhou Industrial Park
+				SuZhou  JiangSu  215000
+				CN
+
+2C-3B-FD   (hex)		Netstor Technology Co., Ltd.
+2C3BFD     (base 16)		Netstor Technology Co., Ltd.
+				6F, No. 1, Alley 16, Lane 235, Baoqiao Rd., Xindian District
+				New Taipei City    23145
+				US
+
+AC-3C-B4   (hex)		Nilan A/S
+AC3CB4     (base 16)		Nilan A/S
+				Nilanvej 2
+				Hedensted  Vejle amt  8722
+				DK
+
+B4-9D-B4   (hex)		Axion Technologies Inc.
+B49DB4     (base 16)		Axion Technologies Inc.
+				105-1203, 70, Jingeononam-ro
+				Namyangju  Gyeonggi-do  472-859
+				KR
+
+AC-E8-7E   (hex)		Bytemark Computer Consulting Ltd
+ACE87E     (base 16)		Bytemark Computer Consulting Ltd
+				Unit 2
+				Opus Avenue  York YO26 6BL  
+				GB
+
+80-07-A2   (hex)		Esson Technology Inc.
+8007A2     (base 16)		Esson Technology Inc.
+				Room A2, 5F Longsheng Commericial Building,
+				Baoan District  ShenZhen  518000
+				CN
+
+C0-A0-E2   (hex)		Eden Innovations
+C0A0E2     (base 16)		Eden Innovations
+				ZAC
+				Eguilles  PACA  13510
+				FR
+
+08-0F-FA   (hex)		KSP INC.
+080FFA     (base 16)		KSP INC.
+				RM 501, 138 Kwangdeokdae-ro
+				Danwon-gu, Ansan-si  Gyeonggi-do  425906
+				KR
+
+E8-AB-FA   (hex)		Shenzhen Reecam Tech.Ltd.
+E8ABFA     (base 16)		Shenzhen Reecam Tech.Ltd.
+				Room 03D-1 , North Wing Of 3 rd Floor, Block 1 , Vision Shenzhen Business Park  
+				Nanshan District, Shenzhen  Guangdong  518052
+				CN
+
+DC-B0-58   (hex)		Bürkert Werke GmbH
+DCB058     (base 16)		Bürkert Werke GmbH
+				Christian-Bürkert-Straße 13-17
+				Ingelfingen  Baden-Württemberg  74653
+				DE
+
+6C-5A-34   (hex)		Shenzhen Haitianxiong Electronic Co., Ltd.
+6C5A34     (base 16)		Shenzhen Haitianxiong Electronic Co., Ltd.
+				Rm.407, Block A, University-town Business Park, Taoyuan street, Lishan Road
+				Shenzhen  Guangdong  518055
+				CN
+
+90-38-DF   (hex)		Changzhou Tiannengbo System Co. Ltd.
+9038DF     (base 16)		Changzhou Tiannengbo System Co. Ltd.
+				#9 East Hehai Road, RM 306
+				Changzhou  Jiangsu Province  213000
+				CN
+
+18-52-53   (hex)		Pixord Corporation
+185253     (base 16)		Pixord Corporation
+				6F, No 12, Innovation 1st Road
+				Hsinchu    30076
+				TW
+
+68-3B-1E   (hex)		Countwise LTD
+683B1E     (base 16)		Countwise LTD
+				1149 Sawgrass Corporate Parkway
+				Sunrise  Florida  33323
+				US
+
+AC-A2-2C   (hex)		Baycity Technologies Ltd
+ACA22C     (base 16)		Baycity Technologies Ltd
+				10 Nazareth Ave
+				Christchurch  Canterbury  8024
+				NZ
+
+30-32-94   (hex)		W-IE-NE-R Plein & Baus GmbH
+303294     (base 16)		W-IE-NE-R Plein & Baus GmbH
+				Muellersbaum 20
+				Burscheid  NRW  51399
+				US
+
+7C-82-2D   (hex)		Nortec
+7C822D     (base 16)		Nortec
+				2740 Fenton Rd
+				Ottawa  ON  K1T3T7
+				US
+
+10-FB-F0   (hex)		KangSheng LTD.
+10FBF0     (base 16)		KangSheng LTD.
+				2F., No.11, 
+				New Taipei City    24889
+				TW
+
+6C-9A-C9   (hex)		Valentine Research, Inc.
+6C9AC9     (base 16)		Valentine Research, Inc.
+				10280 Alliance Rd
+				Cincinnati  OH  45242
+				US
+
+AC-8D-14   (hex)		Smartrove Inc
+AC8D14     (base 16)		Smartrove Inc
+				19630 Allendale Ave.
+				Saratoga  CA  95070
+				US
+
+20-91-D9   (hex)		I'M SPA
+2091D9     (base 16)		I'M SPA
+				VIA BIRON 102/3
+				MONTEVIALE  VICENZA  36050
+				IT
+
+AC-72-36   (hex)		Lexking Technology Co., Ltd.
+AC7236     (base 16)		Lexking Technology Co., Ltd.
+				2F, No. 3, Baoqiang Road,
+				New Taipei City  Taiwan  231111
+				TW
+
+3C-D7-DA   (hex)		SK Mtek microelectronics(shenzhen)limited
+3CD7DA     (base 16)		SK Mtek microelectronics(shenzhen)limited
+				12F, Micro-profit Building,South 6 road
+				Shenzhen  Guangdong  518057
+				CN
+
+04-F8-C2   (hex)		Flaircomm Microelectronics, Inc.
+04F8C2     (base 16)		Flaircomm Microelectronics, Inc.
+				7F,Guomai Building,116 East JiangBin Ave
+				Fuzhou  Fujian  350015
+				CN
+
+14-1B-F0   (hex)		Intellimedia Systems Ltd
+141BF0     (base 16)		Intellimedia Systems Ltd
+				Sandhill Barn
+				Washington  West Sussex  RH204TD
+				GB
+
+58-87-E2   (hex)		Shenzhen Coship Electronics Co., Ltd.
+5887E2     (base 16)		Shenzhen Coship Electronics Co., Ltd.
+				Rainbow Bldg., North, Hi-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+68-69-F2   (hex)		ComAp s.r.o.
+6869F2     (base 16)		ComAp s.r.o.
+				Kundratka 17
+				Prague    18000
+				CZ
+
+B8-5A-FE   (hex)		Handaer Communication Technology (Beijing) Co., Ltd
+B85AFE     (base 16)		Handaer Communication Technology (Beijing) Co., Ltd
+				Jiancaicheng West Rd.65,Xisanqi,
+				  Beijing  100096
+				CN
+
+F4-6D-E2   (hex)		zte corporation
+F46DE2     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+F0-AC-A4   (hex)		HBC-radiomatic
+F0ACA4     (base 16)		HBC-radiomatic
+				Haller Str. 45-53
+				Crailsheim  Baden Wurttemberg  74564
+				DE
+
+60-74-8D   (hex)		Atmaca Elektronik
+60748D     (base 16)		Atmaca Elektronik
+				Namik Kemal Mahallesi 177, Sokak No:2
+				Istanbul  Esenyurt  34510
+				TR
+
+B8-B7-D7   (hex)		2GIG Technologies
+B8B7D7     (base 16)		2GIG Technologies
+				2961 West Maple Loop Drive
+				Lehi  Utah  84043
+				US
+
+80-82-87   (hex)		ATCOM Technology Co.Ltd.
+808287     (base 16)		ATCOM Technology Co.Ltd.
+				A-2F, #3 , Crown industry buildings
+				Shenzhen  Guang Dong  518040
+				US
+
+28-A1-86   (hex)		enblink
+28A186     (base 16)		enblink
+				Room 212 Building 105-1 SNU
+				  SEOUL  151-742
+				KR
+
+50-39-55   (hex)		Cisco SPVTG
+503955     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+78-D1-29   (hex)		Vicos
+78D129     (base 16)		Vicos
+				Eugenmuellerstrasse 14
+				Salzburg  Salzburg  5020
+				AT
+
+84-DF-0C   (hex)		NET2GRID BV
+84DF0C     (base 16)		NET2GRID BV
+				Krullelaan 28
+				Zeist  Utrecht  3701 TD
+				NL
+
+38-8E-E7   (hex)		Fanhattan LLC
+388EE7     (base 16)		Fanhattan LLC
+				489 S El Camino Real
+				San Mateo  CA  94402
+				US
+
+5C-D4-1B   (hex)		UCZOON Technology Co., LTD
+5CD41B     (base 16)		UCZOON Technology Co., LTD
+				9 th Floor,Pan Gu Plaza,No.27 North  4 th Ring,
+				Beijing  Beijing  100029
+				CN
+
+CC-E7-98   (hex)		My Social Stuff
+CCE798     (base 16)		My Social Stuff
+				Sint-Hubertussyraat 65
+				Berchem    2600
+				BE
+
+A0-36-F0   (hex)		Comprehensive Power
+A036F0     (base 16)		Comprehensive Power
+				420 Northboro Road Central
+				Marlborough  MA  01752
+				US
+
+18-0C-AC   (hex)		CANON INC.
+180CAC     (base 16)		CANON INC.
+				3-30-2
+				Ohta-Ku  Tokyo  146-8501
+				JP
+
+78-AB-60   (hex)		ABB Australia
+78AB60     (base 16)		ABB Australia
+				PMB 88
+				Berrimah  NT  0828
+				AU
+
+84-82-F4   (hex)		Beijing Huasun Unicreate Technology Co., Ltd
+8482F4     (base 16)		Beijing Huasun Unicreate Technology Co., Ltd
+				North Region 6th Floor, Tower A, Huizhi Mansion,
+				  Beijing  100085
+				CN
+
+00-DB-1E   (hex)		Albedo Telecom SL
+00DB1E     (base 16)		Albedo Telecom SL
+				Joan d'Austria 112
+				Barcelona    08018
+				ES
+
+18-86-3A   (hex)		DIGITAL ART SYSTEM
+18863A     (base 16)		DIGITAL ART SYSTEM
+				838 rue de l'Aiguelongue
+				Montpellier  Etat  34090
+				FR
+
+0C-DC-CC   (hex)		Inala Technologies
+0CDCCC     (base 16)		Inala Technologies
+				Inala House,  557 15th Road
+				Midrand  Gauteng  1685
+				ZA
+
+98-29-1D   (hex)		Jaguar de Mexico, SA de CV
+98291D     (base 16)		Jaguar de Mexico, SA de CV
+				Calle Tabla Grande No.2
+				Jilotzongo  Estado de Mexico  54570
+				MX
+
+34-AF-2C   (hex)		Nintendo Co., Ltd.
+34AF2C     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+7C-D9-FE   (hex)		New Cosmos Electric Co., Ltd.
+7CD9FE     (base 16)		New Cosmos Electric Co., Ltd.
+				2-5-4 Mitsuyanaka
+				Osaka  Osaka-fu  532-0036
+				JP
+
+E4-90-69   (hex)		Rockwell Automation
+E49069     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+CC-C1-04   (hex)		Applied Technical Systems
+CCC104     (base 16)		Applied Technical Systems
+				P.O. Box 5705
+				Shreveport  LA  71135
+				US
+
+A4-B1-E9   (hex)		Technicolor
+A4B1E9     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+60-45-5E   (hex)		Liptel s.r.o.
+60455E     (base 16)		Liptel s.r.o.
+				Hradna 338
+				Liptovsky Hradok    03301
+				SK
+
+D8-06-D1   (hex)		Honeywell Fire System (Shanghai) Co,. Ltd.
+D806D1     (base 16)		Honeywell Fire System (Shanghai) Co,. Ltd.
+				No. 430, Li Bing Road, Pudong
+				Shanghai  Shanghai  201203
+				CN
+
+64-76-57   (hex)		Innovative Security Designs
+647657     (base 16)		Innovative Security Designs
+				18 Technology Drive
+				Irvine  CA  92618
+				US
+
+90-70-25   (hex)		Garea Microsys Co.,Ltd.
+907025     (base 16)		Garea Microsys Co.,Ltd.
+				4th Floor, Building 2, Software Park
+				Suzhou  Jiangsu  215163
+				CN
+
+10-D1-DC   (hex)		INSTAR Deutschland GmbH
+10D1DC     (base 16)		INSTAR Deutschland GmbH
+				Auf der Hostert 17
+				Huenstetten Bechtheim  Hessen  65510
+				DE
+
+34-99-6F   (hex)		VPI Engineering
+34996F     (base 16)		VPI Engineering
+				11814 S. Election Rd., Suite 200
+				Draper  UT  84020
+				US
+
+94-4A-09   (hex)		BitWise Controls
+944A09     (base 16)		BitWise Controls
+				98 Inverness Dr East
+				Englewood  CO  80112
+				US
+
+BC-28-D6   (hex)		Rowley Associates Limited
+BC28D6     (base 16)		Rowley Associates Limited
+				Suite 4B/4C Drake House
+				Dursley  Gloucestershire  GL11 4HH
+				GB
+
+10-BD-18   (hex)		Cisco Systems, Inc
+10BD18     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+58-69-F9   (hex)		Fusion Transactive Ltd.
+5869F9     (base 16)		Fusion Transactive Ltd.
+				PO Box 68281
+				Auckland    1145
+				NZ
+
+D4-1E-35   (hex)		TOHO Electronics INC.
+D41E35     (base 16)		TOHO Electronics INC.
+				1-13-21 Tanashioda, Chuo-Ku
+				Sagamihara-City  Kanagawa  252-0245
+				JP
+
+4C-72-B9   (hex)		PEGATRON CORPORATION
+4C72B9     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+2C-ED-EB   (hex)		Alpheus Digital Company Limited
+2CEDEB     (base 16)		Alpheus Digital Company Limited
+				Room 2, 23/F Tak King Industrial building
+				Hong Kong    852
+				HK
+
+0C-D9-96   (hex)		Cisco Systems, Inc
+0CD996     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+30-F3-3A   (hex)		+plugg srl
+30F33A     (base 16)		+plugg srl
+				via giovanni ventura, 5
+				Milano  MI  20134
+				IT
+
+0C-57-EB   (hex)		Mueller Systems
+0C57EB     (base 16)		Mueller Systems
+				48 Leona Drive, Suite C
+				Middleboro  MA  02346
+				US
+
+74-53-27   (hex)		COMMSEN CO., LIMITED
+745327     (base 16)		COMMSEN CO., LIMITED
+				12/F., San Toi Building,139 Connaught Road Central 
+				    999077
+				HK
+
+D0-8C-FF   (hex)		UPWIS AB
+D08CFF     (base 16)		UPWIS AB
+				Box 3000
+				Uppsala  Uppsala  75003
+				SE
+
+68-CE-4E   (hex)		L-3 Communications Infrared Products
+68CE4E     (base 16)		L-3 Communications Infrared Products
+				3414 Herrmann Drive
+				Garland  TX  75043
+				US
+
+68-D1-FD   (hex)		Shenzhen Trimax Technology Co.,Ltd
+68D1FD     (base 16)		Shenzhen Trimax Technology Co.,Ltd
+				Room 1016, 10F, Max Smart Commercial Center,
+				Shenzhen  Guangdong  518133
+				CN
+
+9C-06-6E   (hex)		Hytera Communications Corporation Limited
+9C066E     (base 16)		Hytera Communications Corporation Limited
+				Hytera Tower, Hi-Tech Industrial Park North, Nanshan District
+				Shenzhen  Guangdong  518057
+				US
+
+3C-EA-FB   (hex)		NSE AG
+3CEAFB     (base 16)		NSE AG
+				Bremgarterstrasse 54
+				Wohlen  AG  5610
+				CH
+
+8C-C7-AA   (hex)		Radinet Communications Inc.
+8CC7AA     (base 16)		Radinet Communications Inc.
+				7F-2, No.229, Fuxing 2nd Rd, Zhubei, 30271
+				Hsinchu  Taiwan  30271
+				US
+
+40-33-6C   (hex)		Godrej & Boyce Mfg. co. ltd
+40336C     (base 16)		Godrej & Boyce Mfg. co. ltd
+				PSS TECH CELL, 2ND FLOOR, PLANT 17, SECURITY SOLUTIONS DIVISION
+				MUMBAI  MAHARASHTRA  400079
+				IN
+
+F8-A0-3D   (hex)		Dinstar Technologies Co., Ltd.
+F8A03D     (base 16)		Dinstar Technologies Co., Ltd.
+				Floor 6, Guoxing Building
+				shenzhen  Guangdong  518052
+				US
+
+2C-D4-44   (hex)		FUJITSU LIMITED
+2CD444     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+BC-81-1F   (hex)		Ingate Systems
+BC811F     (base 16)		Ingate Systems
+				Rissneleden 45
+				Sundbyberg    17444
+				SE
+
+D8-67-D9   (hex)		Cisco Systems, Inc
+D867D9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-E7-31   (hex)		Nokia Corporation
+A4E731     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+98-A7-B0   (hex)		MCST ZAO
+98A7B0     (base 16)		MCST ZAO
+				35/50, Nizhnyaya Krasnoselskaya St.,
+				Moscow    105666
+				RU
+
+4C-06-8A   (hex)		Basler Electric Company
+4C068A     (base 16)		Basler Electric Company
+				12570 State Route 143
+				Highland  Illinois  62249
+				US
+
+E8-56-D6   (hex)		NCTech Ltd
+E856D6     (base 16)		NCTech Ltd
+				20-22 Braid Road
+				Edinburgh    EH10 6AD
+				GB
+
+C0-81-70   (hex)		Effigis GeoSolutions
+C08170     (base 16)		Effigis GeoSolutions
+				4101, rue Molson
+				Montreal  Quebec  H1Y3L1
+				CA
+
+64-22-16   (hex)		Shandong Taixin Electronic co.,Ltd
+642216     (base 16)		Shandong Taixin Electronic co.,Ltd
+				FL.6,Haichen Building
+				Jinan  Shandong  250010
+				CN
+
+44-38-39   (hex)		Cumulus Networks, inc
+443839     (base 16)		Cumulus Networks, inc
+				650 Castro Street, suite 120-245
+				Mountain View  CA  94041
+				US
+
+04-8B-42   (hex)		Skspruce Technologies
+048B42     (base 16)		Skspruce Technologies
+				A1, Tianfu Software Park, 1129 Century City Road
+				High-tech Zone, Chengdu  Sichuan  610041
+				CN
+
+50-76-A6   (hex)		Ecil Informatica Ind. Com. Ltda
+5076A6     (base 16)		Ecil Informatica Ind. Com. Ltda
+				Av. Araguacema, 388
+				Barueri  São Paulo  06460-070
+				BR
+
+A4-4C-11   (hex)		Cisco Systems, Inc
+A44C11     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-84-3B   (hex)		Soladigm, Inc.
+60843B     (base 16)		Soladigm, Inc.
+				195. S Milpitas Blvd
+				Milpitas  CA  95035
+				US
+
+AC-4B-C8   (hex)		Juniper Networks
+AC4BC8     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+20-9B-A5   (hex)		JIAXING GLEAD Electronics Co.,Ltd
+209BA5     (base 16)		JIAXING GLEAD Electronics Co.,Ltd
+				No.66 Zhengyuan Road in Tanghu Industrial Garden 
+				Jiaxing  Zhejiang  314003
+				CN
+
+A0-F4-50   (hex)		HTC Corporation
+A0F450     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+60-89-B1   (hex)		Key Digital Systems
+6089B1     (base 16)		Key Digital Systems
+				521 E 3rd Street
+				Mount Vernon  NY  10553
+				US
+
+44-D1-5E   (hex)		Shanghai Kingto Information Technology Ltd
+44D15E     (base 16)		Shanghai Kingto Information Technology Ltd
+				No.738 Guangji RD.3F shanghai.china
+				  shanghai  200434
+				CN
+
+00-36-FE   (hex)		SuperVision
+0036FE     (base 16)		SuperVision
+				po box 3472
+				palos verdes  CA  90274
+				US
+
+70-9E-86   (hex)		X6D Limited
+709E86     (base 16)		X6D Limited
+				199, Arch. Makariou III
+				Limassol    3030
+				CY
+
+A0-F4-19   (hex)		Nokia Corporation
+A0F419     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+1C-97-3D   (hex)		PRICOM Design
+1C973D     (base 16)		PRICOM Design
+				2755 Slocum Rd
+				Peyton  CO  80831
+				US
+
+BC-02-00   (hex)		Stewart Audio
+BC0200     (base 16)		Stewart Audio
+				100 West El Camino Real
+				Mountain View  CA  94041
+				US
+
+48-91-53   (hex)		Weinmann Geräte für Medizin GmbH + Co. KG
+489153     (base 16)		Weinmann Geräte für Medizin GmbH + Co. KG
+				Kronsaalsweg 40
+				Hamburg    D-22525
+				DE
+
+AC-94-03   (hex)		Envision Peripherals Inc
+AC9403     (base 16)		Envision Peripherals Inc
+				47490 Seabridge Dr
+				Fremont  California  94538
+				US
+
+68-D9-25   (hex)		ProSys Development Services
+68D925     (base 16)		ProSys Development Services
+				Mill House
+				Mitcham  Surrey  CR4 4HY
+				GB
+
+84-8D-84   (hex)		Rajant Corporation
+848D84     (base 16)		Rajant Corporation
+				400 East King Street
+				Malvern  PA  19355
+				US
+
+54-46-6B   (hex)		Shenzhen CZTIC Electronic Technology Co., Ltd  
+54466B     (base 16)		Shenzhen CZTIC Electronic Technology Co., Ltd  
+				Xinghe Building, Zhongxin Road, Shajing Town, Baoan
+				SHENZHEN  GUANGDONG  518104
+				CN
+
+44-B3-82   (hex)		Kuang-chi Institute of Advanced Technology
+44B382     (base 16)		Kuang-chi Institute of Advanced Technology
+				Software building, Gaoxingzhong 1st Road,
+				Shenzhen  Guangdong  518057
+				CN
+
+60-B9-33   (hex)		Deutron Electronics Corp.
+60B933     (base 16)		Deutron Electronics Corp.
+				8F, 68, Sec. 3, Nanking E. Rd.
+				Taipei  Taiwan  104
+				TW
+
+00-43-FF   (hex)		KETRON S.R.L.
+0043FF     (base 16)		KETRON S.R.L.
+				Via Giuseppe Taliercio n. 7
+				Ancona    60131
+				IT
+
+7C-AC-B2   (hex)		Bosch Software Innovations GmbH
+7CACB2     (base 16)		Bosch Software Innovations GmbH
+				Ziegelei 7
+				Immenstaad  BadenWuertemberg  88090
+				DE
+
+18-D6-6A   (hex)		Inmarsat
+18D66A     (base 16)		Inmarsat
+				99 City Road
+				London    EC1Y 1AX
+				GB
+
+1C-7C-45   (hex)		Vitek Industrial Video Products, Inc.
+1C7C45     (base 16)		Vitek Industrial Video Products, Inc.
+				28492 Constellation Rd
+				Valencia  CA  91355
+				US
+
+3C-38-88   (hex)		ConnectQuest, llc
+3C3888     (base 16)		ConnectQuest, llc
+				P.O. Box 425
+				West Simsbury  Connecticut  06092
+				US
+
+48-D7-FF   (hex)		BLANKOM Antennentechnik GmbH
+48D7FF     (base 16)		BLANKOM Antennentechnik GmbH
+				Hermann-Petersilge Str. 1
+				Bad Blankenburg  TH  07422
+				DE
+
+C4-71-30   (hex)		Fon Technology S.L.
+C47130     (base 16)		Fon Technology S.L.
+				Avda. Bruselas, n. 7, Planta 3, Alcobendas
+				  Madrid  28100
+				ES
+
+D8-33-7F   (hex)		Office FA.com Co.,Ltd.
+D8337F     (base 16)		Office FA.com Co.,Ltd.
+				293-21
+				Oyama-shi  Tochigi  329-0216
+				JP
+
+00-36-F8   (hex)		Conti Temic microelectronic GmbH
+0036F8     (base 16)		Conti Temic microelectronic GmbH
+				Dornierstraße 1
+				Markdorf    88677
+				DE
+
+A4-F7-D0   (hex)		LAN Accessories Co., Ltd.
+A4F7D0     (base 16)		LAN Accessories Co., Ltd.
+				8F-1, No. 159, Sec. 1 Hsin Tai Wu Road,
+				New Taipei City,    221
+				US
+
+C8-56-45   (hex)		Intermas France
+C85645     (base 16)		Intermas France
+				Rue de l'industrie
+				Beauvais  Oise  60000
+				FR
+
+44-34-8F   (hex)		MXT INDUSTRIAL LTDA
+44348F     (base 16)		MXT INDUSTRIAL LTDA
+				RODOVIA BR 381, KM 490, JARDIM DAS ALTEROSAS
+				BETIM  MINAS GERAIS  32670790
+				BR
+
+D4-EC-0C   (hex)		Harley-Davidson Motor Company
+D4EC0C     (base 16)		Harley-Davidson Motor Company
+				3700 W. Juneau Avenue
+				Milwaukee  Wisconsin  53208
+				US
+
+28-E6-08   (hex)		Tokheim
+28E608     (base 16)		Tokheim
+				Industrieweg 5
+				Bladel  NBr  5531 AD
+				NL
+
+74-FF-7D   (hex)		Wren Sound Systems, LLC
+74FF7D     (base 16)		Wren Sound Systems, LLC
+				169 Gateshead Way
+				Phoenixville  PA  19460
+				US
+
+AC-F0-B2   (hex)		Becker Electronics Taiwan Ltd.
+ACF0B2     (base 16)		Becker Electronics Taiwan Ltd.
+				No.32, Lane 30, Long Yuan Rd.
+				Long-Tan  Taoyuan  32544
+				TW
+
+54-2A-9C   (hex)		LSY Defense, LLC.
+542A9C     (base 16)		LSY Defense, LLC.
+				4175 Westport Rd.
+				Louisville  Kentucky  40207
+				US
+
+50-4A-5E   (hex)		Masimo Corporation
+504A5E     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine  California  92618
+				US
+
+6C-A9-6F   (hex)		TransPacket AS
+6CA96F     (base 16)		TransPacket AS
+				Drammensveien 134
+				Oslo    0277
+				NO
+
+AC-01-42   (hex)		Uriel Technologies SIA
+AC0142     (base 16)		Uriel Technologies SIA
+				Dzerbenes iela 14
+				Riga    LV-1006
+				LV
+
+C4-7B-A3   (hex)		NAVIS Inc.
+C47BA3     (base 16)		NAVIS Inc.
+				Dmitrovskoe shosse 157
+				Moscow    127411
+				RU
+
+F4-48-48   (hex)		Amscreen Group Ltd
+F44848     (base 16)		Amscreen Group Ltd
+				Paragon Business Park
+				Bolton  Lancs  BL6 6HG
+				GB
+
+50-D2-74   (hex)		Steffes Corporation
+50D274     (base 16)		Steffes Corporation
+				3050 Highway 22 North
+				Dickinson  ND  58601
+				US
+
+C8-F7-04   (hex)		Building Block Video
+C8F704     (base 16)		Building Block Video
+				17 APex Park
+				Hailsham  East Sussex  BN27 2JU
+				GB
+
+50-8A-42   (hex)		Uptmate Technology Co., LTD
+508A42     (base 16)		Uptmate Technology Co., LTD
+				6F., No.5, Jian 1st Rd.,Zhonghe Dist., 
+				New Taipei City    23558
+				TW
+
+BC-EA-2B   (hex)		CityCom GmbH
+BCEA2B     (base 16)		CityCom GmbH
+				Am Kroit 25
+				Amerang  Bavaria  83123
+				DE
+
+0C-A1-38   (hex)		Blinq Wireless Inc.
+0CA138     (base 16)		Blinq Wireless Inc.
+				400 MARCH RD UNIT 240
+				KANATA  ON  K2K3H4
+				CA
+
+5C-6F-4F   (hex)		S.A. SISTEL
+5C6F4F     (base 16)		S.A. SISTEL
+				C/SOLSONES, 87
+				CASTELLAR DEL VALLES  BARCELONA  08211
+				ES
+
+90-1B-0E   (hex)		Fujitsu Technology Solutions GmbH
+901B0E     (base 16)		Fujitsu Technology Solutions GmbH
+				Buergermeister-Ulrich-Strasse 100
+				Augsburg  Bayern  86199
+				DE
+
+F8-50-63   (hex)		Verathon
+F85063     (base 16)		Verathon
+				20001 N Creek Pkwy
+				Bothell  WA  98011
+				US
+
+2C-36-F8   (hex)		Cisco Systems, Inc
+2C36F8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+84-57-87   (hex)		DVR C&C Co., Ltd.
+845787     (base 16)		DVR C&C Co., Ltd.
+				7F 720 Namkwang Centlex Bldg, Cheongcheon-dong, Bupyeong-gu
+				Incheon    403-030
+				KR
+
+58-08-FA   (hex)		Fiber Optic & telecommunication INC.
+5808FA     (base 16)		Fiber Optic & telecommunication INC.
+				161-4 Kumjeong-Dong,
+				Kunpo-city  Gyeonggi-Do  435-824
+				KR
+
+AC-3D-05   (hex)		Instorescreen Aisa
+AC3D05     (base 16)		Instorescreen Aisa
+				Room 207, North Bldg,No 28
+				Shanghai    200237
+				CN
+
+28-60-94   (hex)		CAPELEC
+286094     (base 16)		CAPELEC
+				1130 rue des Marels
+				Montpellier  Hérault  34000
+				FR
+
+A4-56-30   (hex)		Cisco Systems, Inc
+A45630     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-3C-3C   (hex)		CYBELEC SA
+C43C3C     (base 16)		CYBELEC SA
+				Rue des Uttins 27
+				Yverdon-les-Bains    1401
+				CH
+
+B8-26-D4   (hex)		Furukawa Industrial S.A. Produtos Elétricos
+B826D4     (base 16)		Furukawa Industrial S.A. Produtos Elétricos
+				Rua Hasdrubal Bellegard, 820
+				  Parana  81460-120
+				BR
+
+B8-74-47   (hex)		Convergence Technologies
+B87447     (base 16)		Convergence Technologies
+				16W215 83rd Street Suite D
+				Burr Ridge  IL  60527
+				US
+
+74-63-DF   (hex)		VTS GmbH
+7463DF     (base 16)		VTS GmbH
+				Am Königholz Ost 4
+				Eglhausen  Bavaria  85411
+				DE
+
+BC-12-5E   (hex)		Beijing  WisVideo  INC.
+BC125E     (base 16)		Beijing  WisVideo  INC.
+				RM 3A08 Technology&Fortune Center A block No.8 Xue Qing Road,Haidian District , 
+				  Beijing  100192
+				CN
+
+14-E4-EC   (hex)		mLogic LLC
+14E4EC     (base 16)		mLogic LLC
+				8440 Warner Drive
+				Culver City  CA  90232
+				US
+
+38-28-EA   (hex)		Fujian Netcom Technology Co., LTD
+3828EA     (base 16)		Fujian Netcom Technology Co., LTD
+				Netcom Technology Building, B Zone:Tongpan Software Park, 
+				Fuzhou  Fujian  350003
+				CN
+
+D0-1A-A7   (hex)		UniPrint
+D01AA7     (base 16)		UniPrint
+				Unit 309, 1 Eva Road
+				Toronto  Ontario  M9C 4Z5
+				CA
+
+84-6A-ED   (hex)		Wireless Tsukamoto.,co.LTD
+846AED     (base 16)		Wireless Tsukamoto.,co.LTD
+				16-21 1chome,Isoyama
+				Suzuka  Mie-pref  5100256
+				JP
+
+E0-5D-A6   (hex)		Detlef Fink Elektronik & Softwareentwicklung
+E05DA6     (base 16)		Detlef Fink Elektronik & Softwareentwicklung
+				Brühlstraße 13
+				Mössingen    72116
+				DE
+
+04-5A-95   (hex)		Nokia Corporation
+045A95     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+04-F4-BC   (hex)		Xena Networks
+04F4BC     (base 16)		Xena Networks
+				Graabroedretorv 6, 3. sal
+				København  Danmark  1154
+				DK
+
+80-DB-31   (hex)		Power Quotient International Co., Ltd.
+80DB31     (base 16)		Power Quotient International Co., Ltd.
+				8F., No. 49, Sec. 4, Jhongyang Rd., Tu Cheng Dist.,
+				New Taipei City    23675
+				TW
+
+1C-51-B5   (hex)		Techaya LTD
+1C51B5     (base 16)		Techaya LTD
+				P.O.B 1500
+				Pardes Hanna    3700
+				IL
+
+6C-3A-84   (hex)		Shenzhen Aero-Startech. Co.Ltd
+6C3A84     (base 16)		Shenzhen Aero-Startech. Co.Ltd
+				F3-4, Building3,Zhongyuntai Industrial Park.Shiyan Town.,
+				Shenzhen  Guangdong  518108
+				CN
+
+00-D6-32   (hex)		GE Energy
+00D632     (base 16)		GE Energy
+				Lissue Industrial Estate East
+				Lisburn  Co Antrim  BT28 2RE
+				GB
+
+0C-9E-91   (hex)		Sankosha Corporation
+0C9E91     (base 16)		Sankosha Corporation
+				1-12, Miyashimo
+				Sagamihara-shi  Kanagawa-ken  252-0212
+				JP
+
+38-3F-10   (hex)		DBL Technology Ltd.
+383F10     (base 16)		DBL Technology Ltd.
+				Unit 42, 18/F., Block D, Wah Lok Industrial Center
+				    
+				HK
+
+AC-D3-64   (hex)		ABB SPA, ABB SACE DIV.
+ACD364     (base 16)		ABB SPA, ABB SACE DIV.
+				V.LE DELL'INDUSTRIA, 18
+				VITTUONE  MI  20010
+				IT
+
+2C-EE-26   (hex)		Petroleum Geo-Services
+2CEE26     (base 16)		Petroleum Geo-Services
+				12555 Harris Branch Pkwy
+				Austin  TX  78653
+				US
+
+C8-F9-F9   (hex)		Cisco Systems, Inc
+C8F9F9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-EF-52   (hex)		Telewave Co., Ltd.
+A4EF52     (base 16)		Telewave Co., Ltd.
+				A-203, SK Twintech Tower
+				Seoul    153-773
+				KR
+
+A8-26-D9   (hex)		HTC Corporation
+A826D9     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+28-94-0F   (hex)		Cisco Systems, Inc
+28940F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B8-DA-F7   (hex)		Advanced Photonics, Inc.
+B8DAF7     (base 16)		Advanced Photonics, Inc.
+				the University of Tokyo, CCR507
+				Meguro-ku  Tokyo  153-8904
+				JP
+
+14-3A-EA   (hex)		Dynapower Company LLC
+143AEA     (base 16)		Dynapower Company LLC
+				85 Meadowland Drive
+				South Burlington  VT  05403
+				US
+
+A0-86-EC   (hex)		SAEHAN HITEC Co., Ltd
+A086EC     (base 16)		SAEHAN HITEC Co., Ltd
+				16-3, Yongsu-ri, Chowol-eup
+				Gwangju-si, Gyeonggi-do    464-865
+				KR
+
+94-2E-17   (hex)		Schneider Electric Canada Inc
+942E17     (base 16)		Schneider Electric Canada Inc
+				1400 industrielle street
+				La Prairie  Quebec  J5R 2E5
+				CA
+
+C4-60-44   (hex)		Everex Electronics Limited
+C46044     (base 16)		Everex Electronics Limited
+				Unit 3, Block A, 16/F
+				    
+				HK
+
+98-FE-03   (hex)		Ericsson - North America
+98FE03     (base 16)		Ericsson - North America
+				6300 Legacy Drive
+				Plano  TX  75024
+				US
+
+E0-3C-5B   (hex)		SHENZHEN JIAXINJIE ELECTRON CO.,LTD
+E03C5B     (base 16)		SHENZHEN JIAXINJIE ELECTRON CO.,LTD
+				Shenzhen Jiaxinjie Security Industrial park,No 6 Xin He Xin xing Industrial Park, Fuyong Town,Bao'an District 
+				SHENZHEN  GUANGDONG  518103
+				CN
+
+CC-94-4A   (hex)		Pfeiffer Vacuum GmbH
+CC944A     (base 16)		Pfeiffer Vacuum GmbH
+				Berliner Str. 43
+				Asslar  Hessen  35614
+				DE
+
+0C-85-25   (hex)		Cisco Systems, Inc
+0C8525     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B4-D8-A9   (hex)		BetterBots
+B4D8A9     (base 16)		BetterBots
+				1600 Wilson Way SE, Ste. 9
+				Smyrna  GA  30082
+				US
+
+7C-C8-D7   (hex)		Damalisk
+7CC8D7     (base 16)		Damalisk
+				Coriolis 2 
+				ECUISSES    71210
+				FR
+
+9C-B0-08   (hex)		Ubiquitous Computing Technology Corporation
+9CB008     (base 16)		Ubiquitous Computing Technology Corporation
+				2-20-1 Nishi-Gotanda
+				Shinagawa-ku  Tokyo  1410031
+				JP
+
+A8-77-6F   (hex)		Zonoff
+A8776F     (base 16)		Zonoff
+				70E Swedesford Rd
+				Malvern  PA  19355
+				US
+
+64-87-88   (hex)		Juniper Networks
+648788     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+00-FA-3B   (hex)		CLOOS ELECTRONIC GMBH
+00FA3B     (base 16)		CLOOS ELECTRONIC GMBH
+				Jambe ducommun 8
+				LE LOCLE    2400
+				CH
+
+54-1D-FB   (hex)		Freestyle Energy Ltd
+541DFB     (base 16)		Freestyle Energy Ltd
+				18-24 Ricketts Road
+				Mount Waverley  Victoria  3149
+				AU
+
+60-B6-06   (hex)		Phorus
+60B606     (base 16)		Phorus
+				16255 Ventura Boulevard, Suite 310
+				Encino  CA  91436
+				US
+
+90-92-B4   (hex)		Diehl BGT Defence GmbH & Co. KG
+9092B4     (base 16)		Diehl BGT Defence GmbH & Co. KG
+				Alte Nussdorfer Strasse 13
+				Ueberlingen    88662
+				DE
+
+20-AA-4B   (hex)		Cisco-Linksys, LLC
+20AA4B     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+CC-6D-EF   (hex)		TJK Tietolaite Oy
+CC6DEF     (base 16)		TJK Tietolaite Oy
+				PL 443
+				Vaasa    65101
+				FI
+
+A8-5B-F3   (hex)		Audivo GmbH
+A85BF3     (base 16)		Audivo GmbH
+				Irrenloher Damm 17
+				Schwarzenfeld    92521
+				DE
+
+B8-97-5A   (hex)		BIOSTAR Microtech Int'l Corp.
+B8975A     (base 16)		BIOSTAR Microtech Int'l Corp.
+				2Fl.  No. 108-2, Min Chuan Road, Hsin Tien Dist.,
+				 New Taipei    231
+				TW
+
+48-33-DD   (hex)		ZENNIO AVANCE Y TECNOLOGIA, S.L.
+4833DD     (base 16)		ZENNIO AVANCE Y TECNOLOGIA, S.L.
+				RIO JARAMA 132 NAVE P8.11
+				TOLEDO    45007
+				ES
+
+08-75-72   (hex)		Obelux Oy
+087572     (base 16)		Obelux Oy
+				Kutomotie 6 B
+				Helsinki    00380
+				FI
+
+10-C2-BA   (hex)		UTT Co., Ltd.
+10C2BA     (base 16)		UTT Co., Ltd.
+				
+				Seoul  Korea  135-913
+				KR
+
+90-D7-4F   (hex)		Bookeen
+90D74F     (base 16)		Bookeen
+				27, rue de la Vistule
+				Paris    75013
+				FR
+
+64-C5-AA   (hex)		South African Broadcasting Corporation
+64C5AA     (base 16)		South African Broadcasting Corporation
+				77 Twickenham Avenue
+				Auckland Park  Gauteng  2006
+				ZA
+
+98-AA-D7   (hex)		BLUE WAVE NETWORKING CO LTD
+98AAD7     (base 16)		BLUE WAVE NETWORKING CO LTD
+				No. 20, Lane 68, Da-feng RD, 
+				NEW TAIPEI  TAIPEI   23121
+				TW
+
+9C-53-CD   (hex)		ENGICAM s.r.l.
+9C53CD     (base 16)		ENGICAM s.r.l.
+				Via Dei Pratoni n.16
+				Scandicci  FIRENZE  50018
+				IT
+
+60-86-45   (hex)		Avery Weigh-Tronix, LLC
+608645     (base 16)		Avery Weigh-Tronix, LLC
+				1000 Armstrong Drive
+				Fairmont  MN  56031
+				US
+
+FC-8F-C4   (hex)		Intelligent Technology Inc.
+FC8FC4     (base 16)		Intelligent Technology Inc.
+				Yuanhe 3 Street,Tongsha Industrial Zone,
+				Dongguan  Guangdong  523127
+				CN
+
+10-FC-54   (hex)		Shany Electronic Co., Ltd. 
+10FC54     (base 16)		Shany Electronic Co., Ltd. 
+				4F, No. 92, Section 1, Nei-Hu Road
+				Taipei    114
+				TW
+
+C0-29-73   (hex)		Audyssey Laboratories Inc.
+C02973     (base 16)		Audyssey Laboratories Inc.
+				110 E. 9th Street, Suite C700
+				Los Angeles  CA  90079
+				US
+
+78-FE-3D   (hex)		Juniper Networks
+78FE3D     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+28-38-CF   (hex)		Gen2wave
+2838CF     (base 16)		Gen2wave
+				Gumi-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-741
+				KR
+
+24-BC-82   (hex)		Dali Wireless, Inc.
+24BC82     (base 16)		Dali Wireless, Inc.
+				125 University Avenue, Suite 88
+				Palo Alto  CA  94301
+				US
+
+B4-0C-25   (hex)		Palo Alto Networks
+B40C25     (base 16)		Palo Alto Networks
+				4401 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+F8-F7-D3   (hex)		International Communications Corporation
+F8F7D3     (base 16)		International Communications Corporation
+				11801 Pierce St. 2nd FL
+				Riverside  CA  92505
+				US
+
+28-D1-AF   (hex)		Nokia Corporation
+28D1AF     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+24-C0-B3   (hex)		RSF
+24C0B3     (base 16)		RSF
+				45 Av Marcel Dassault
+				Toulouse  Garonne, Haute (31)  31500
+				FR
+
+FC-45-5F   (hex)		JIANGXI SHANSHUI OPTOELECTRONIC TECHNOLOGY CO.,LTD
+FC455F     (base 16)		JIANGXI SHANSHUI OPTOELECTRONIC TECHNOLOGY CO.,LTD
+				No.1010,Anping Road,Eco-Industrial Park,Lushan District
+				Jiujiang  Jiangxi  332000
+				CN
+
+F0-4A-2B   (hex)		PYRAMID Computer GmbH
+F04A2B     (base 16)		PYRAMID Computer GmbH
+				Boetzinger Strasse 60
+				Freiburg  BW  79111
+				DE
+
+30-2D-E8   (hex)		JDA, LLC (JDA Systems)
+302DE8     (base 16)		JDA, LLC (JDA Systems)
+				4080 Pike Lane
+				Concord  CA  94520
+				US
+
+48-A6-D2   (hex)		GJsun Optical Science and Tech Co.,Ltd.
+48A6D2     (base 16)		GJsun Optical Science and Tech Co.,Ltd.
+				First floor National Information Industry Park D-08
+				Guilin  Guangxi  541004
+				CN
+
+50-0B-32   (hex)		Foxda Technology Industrial(ShenZhen)Co.,LTD
+500B32     (base 16)		Foxda Technology Industrial(ShenZhen)Co.,LTD
+				1F of 1st  Building&1F-3F of 2nd Building, Foxda Industrial Zone,North of Lanzhu Road,Pingshan New District,Shenzhen City,Guangdong Province,P.R.China
+				Shenzhen  Guangdong  518122
+				CN
+
+60-35-53   (hex)		Buwon Technology
+603553     (base 16)		Buwon Technology
+				(Cunuitechnopark 102-1507) 200-1,Chunui-dong
+				Buchon-si  Gyeinggi-do  420-857
+				KR
+
+E0-39-D7   (hex)		Plexxi, Inc.
+E039D7     (base 16)		Plexxi, Inc.
+				100 Innovative Way Suite 3322
+				Nashua  NH  03062
+				US
+
+7C-33-6E   (hex)		MEG Electronics Inc.
+7C336E     (base 16)		MEG Electronics Inc.
+				Bogazici Universitesi Kuzey Kampus
+				ISTANBUL    34342
+				TR
+
+D4-E3-3F   (hex)		Nokia
+D4E33F     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+68-CD-0F   (hex)		U Tek Company Limited
+68CD0F     (base 16)		U Tek Company Limited
+				FL5, BLDG12, 3RD DISTRICT, TANGTOU INDUSTRIAL PARK
+				SHENZHEN  GUANGDONG  518018
+				CN
+
+60-3F-C5   (hex)		COX CO., LTD
+603FC5     (base 16)		COX CO., LTD
+				904HO, ACE TWIN TOWER 1-CHA
+				SEOUL    152-779
+				KR
+
+A4-E3-91   (hex)		DENY FONTAINE
+A4E391     (base 16)		DENY FONTAINE
+				ROUTE DE SAINT VALERY
+				SAINT BLIMONT    80960
+				FR
+
+AC-6F-D9   (hex)		Valueplus Inc.
+AC6FD9     (base 16)		Valueplus Inc.
+				#803, Sicox Tower, 513-14, 
+				Seongnam-si  Gyeonggi-do  462-806
+				KR
+
+DC-1E-A3   (hex)		Accensus LLC
+DC1EA3     (base 16)		Accensus LLC
+				200 South Wacker Drive
+				Chicago  IL  60606
+				US
+
+A4-01-30   (hex)		ABIsystems Co., LTD
+A40130     (base 16)		ABIsystems Co., LTD
+				308 ACE Techno Tower8 191-7 Guro-dong
+				  Seoul  
+				KR
+
+90-A7-83   (hex)		JSW PACIFIC CORPORATION 
+90A783     (base 16)		JSW PACIFIC CORPORATION 
+				3F-3, No.700, Chung-Zheng Rd, Zhonghe District
+				New Taipei City    235 
+				TW
+
+F8-46-2D   (hex)		SYNTEC Incorporation
+F8462D     (base 16)		SYNTEC Incorporation
+				3F, NO.105, Shing-shyue St., 
+				Hsinchu    300
+				TW
+
+78-A5-DD   (hex)		Shenzhen Smarteye Digital Electronics Co., Ltd
+78A5DD     (base 16)		Shenzhen Smarteye Digital Electronics Co., Ltd
+				#6 Northen Area
+				Shenzhen  Guangdong  518129
+				CN
+
+EC-E7-44   (hex)		Omntec mfg. inc
+ECE744     (base 16)		Omntec mfg. inc
+				1993 Pond Road.
+				Ronkonkoma  NY  11779
+				US
+
+28-AF-0A   (hex)		Sirius XM Radio Inc
+28AF0A     (base 16)		Sirius XM Radio Inc
+				1221 Avenue of the Americas
+				New York  NY  10020
+				US
+
+5C-D4-AB   (hex)		Zektor
+5CD4AB     (base 16)		Zektor
+				12675 Danielson Ct. Ste 401
+				Poway  CA  92064
+				US
+
+08-FC-52   (hex)		OpenXS BV
+08FC52     (base 16)		OpenXS BV
+				Koaibosk 3
+				Terwispel  Friesland  8407ED
+				NL
+
+4C-32-D9   (hex)		M Rutty Holdings Pty. Ltd.
+4C32D9     (base 16)		M Rutty Holdings Pty. Ltd.
+				Unit 1, 4 Beaumont Road
+				Mount Kuring-Gai  New South Wales  2080
+				AU
+
+08-A1-2B   (hex)		ShenZhen EZL Technology Co., Ltd
+08A12B     (base 16)		ShenZhen EZL Technology Co., Ltd
+				RM21B, Building 2, China Phoenix Building,
+				ShenZhen  GuangDong  518026
+				CN
+
+A0-0C-A1   (hex)		SKTB SKiT
+A00CA1     (base 16)		SKTB SKiT
+				239 B. Sadovaya Str.
+				Saratov  Saratov region  410005
+				RU
+
+64-E8-4F   (hex)		Serialway Communication Technology Co. Ltd
+64E84F     (base 16)		Serialway Communication Technology Co. Ltd
+				Room 315, 706 Painting Room, 
+				Beijing    100096
+				CN
+
+2C-9E-FC   (hex)		CANON INC.
+2C9EFC     (base 16)		CANON INC.
+				3-30-2
+				Ohta-Ku  Tokyo  146-8501
+				JP
+
+18-2B-05   (hex)		8D Technologies
+182B05     (base 16)		8D Technologies
+				416, de Maisonneuve West
+				Montreal,   Quebec  H3A 1L2
+				CA
+
+24-0B-B1   (hex)		KOSTAL Industrie Elektrik GmbH 
+240BB1     (base 16)		KOSTAL Industrie Elektrik GmbH 
+				Gewerbering 20
+				Schalksmuehle  North Rhine-Westphalia  58579
+				DE
+
+20-EE-C6   (hex)		Elefirst Science & Tech Co ., ltd
+20EEC6     (base 16)		Elefirst Science & Tech Co ., ltd
+				Floor 9, No 77 Zijinmingmen Building
+				Nanjing  Jiangsu  210007
+				CN
+
+E0-1E-07   (hex)		Anite Telecoms  US. Inc
+E01E07     (base 16)		Anite Telecoms  US. Inc
+				106 Vista Centre Dr
+				Forest  VA  24551
+				US
+
+7C-6B-33   (hex)		Tenyu Tech Co. Ltd.
+7C6B33     (base 16)		Tenyu Tech Co. Ltd.
+				1F., No.10, Ln. 36, Ganzhen 2nd St.
+				New Taipei City     251
+				TW
+
+14-7D-C5   (hex)		Murata Manufacturing Co., Ltd.
+147DC5     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+00-B9-F6   (hex)		Shenzhen Super Rich Electronics Co.,Ltd
+00B9F6     (base 16)		Shenzhen Super Rich Electronics Co.,Ltd
+				RM.102,Shibida Building,No.55,Zhenhua Road,Shenzhen Futian District,
+				Shenzhen  Guangdong  518031
+				CN
+
+FC-C2-3D   (hex)		Atmel Corporation
+FCC23D     (base 16)		Atmel Corporation
+				1150 E Cheyenne Mtn Blvd
+				Colorado Springs  CO  80906
+				US
+
+88-E7-A6   (hex)		iKnowledge Integration Corp.
+88E7A6     (base 16)		iKnowledge Integration Corp.
+				10F No.2, Sec. 3, Xinsheng S. Rd.,
+				Taipei    10660
+				TW
+
+A4-46-FA   (hex)		AmTRAN Video Corporation
+A446FA     (base 16)		AmTRAN Video Corporation
+				9 Goddard
+				Irvine  CA  92618
+				US
+
+CC-E7-DF   (hex)		American Magnetics, Inc.
+CCE7DF     (base 16)		American Magnetics, Inc.
+				PO Box 2509
+				Oak Ridge  TN  37831-2509
+				US
+
+28-04-E0   (hex)		FERMAX ELECTRONICA S.A.U.
+2804E0     (base 16)		FERMAX ELECTRONICA S.A.U.
+				Tres Cruces 133
+				Valencia    46017
+				ES
+
+64-43-46   (hex)		GuangDong Quick Network Computer CO.,LTD
+644346     (base 16)		GuangDong Quick Network Computer CO.,LTD
+				12F,No.80 of Middle XianLie Road,YueXiu District
+				GuangZhou  GuangDong  510070
+				CN
+
+D4-02-4A   (hex)		Delphian Systems LLC
+D4024A     (base 16)		Delphian Systems LLC
+				720 Dartmouth Lane
+				Buffalo Grove  IL  60089
+				US
+
+00-41-B4   (hex)		Wuxi Zhongxing Optoelectronics Technology Co.,Ltd.
+0041B4     (base 16)		Wuxi Zhongxing Optoelectronics Technology Co.,Ltd.
+				Block 93-C, Sci. & Tech. Industry park,
+				Wuxi  Jiangsu  214028
+				CN
+
+F4-44-50   (hex)		BND Co., Ltd.
+F44450     (base 16)		BND Co., Ltd.
+				573-13 Bokhyeon-dong, Buk-gu
+				Daegu    702-020
+				KR
+
+04-62-D7   (hex)		ALSTOM HYDRO FRANCE
+0462D7     (base 16)		ALSTOM HYDRO FRANCE
+				82 Avenue Leon Blum
+				GRENOBLE    38041
+				FR
+
+D4-50-7A   (hex)		CEIVA Logic, Inc
+D4507A     (base 16)		CEIVA Logic, Inc
+				214 E Magnolia Blvd
+				Burbank  CA  91502
+				US
+
+64-D9-89   (hex)		Cisco Systems, Inc
+64D989     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-5D-D7   (hex)		Shenzhen Lifesense Medical Electronics Co., Ltd.    
+645DD7     (base 16)		Shenzhen Lifesense Medical Electronics Co., Ltd.    
+				China Academy of Science and Technology Development, Room 19A 
+				Shenzhen  Guangdong  518057
+				CN
+
+EC-46-70   (hex)		Meinberg Funkuhren GmbH & Co. KG
+EC4670     (base 16)		Meinberg Funkuhren GmbH & Co. KG
+				Lange Wand 9
+				Bad Pyrmont  NDS  31812
+				DE
+
+D0-5A-0F   (hex)		I-BT DIGITAL CO.,LTD
+D05A0F     (base 16)		I-BT DIGITAL CO.,LTD
+				17F.-8, No.866, Zhongzheng Rd., Zhonghe Dist
+				New Taipei     235
+				TW
+
+EC-96-81   (hex)		2276427 Ontario Inc
+EC9681     (base 16)		2276427 Ontario Inc
+				31-1275 Morningside Ave
+				Toronto  ON  M1B3W1
+				CA
+
+5C-07-6F   (hex)		Thought Creator
+5C076F     (base 16)		Thought Creator
+				Largo da Pirâmide, Nº 3, Sala D
+				Oeiras  Lisboa  2795-156 Linda-a-Velha
+				PT
+
+3C-0F-C1   (hex)		KBC Networks
+3C0FC1     (base 16)		KBC Networks
+				25691 Atlantic Ocean Dr
+				Lake Forest  CA  92630
+				US
+
+58-E6-36   (hex)		EVRsafe Technologies
+58E636     (base 16)		EVRsafe Technologies
+				59 North Terrace 
+				Adelaide  South Australia  5069
+				AU
+
+10-F9-EE   (hex)		Nokia Corporation
+10F9EE     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+74-2B-0F   (hex)		Infinidat Ltd.
+742B0F     (base 16)		Infinidat Ltd.
+				11 Galgalei Haplada St.
+				Herzliya Pituach  Center  46722
+				IL
+
+C8-F9-81   (hex)		Seneca s.r.l.
+C8F981     (base 16)		Seneca s.r.l.
+				Via Germania, 34
+				PADOVA    35127
+				IT
+
+24-49-7B   (hex)		Innovative Converged Devices Inc
+24497B     (base 16)		Innovative Converged Devices Inc
+				424 8th Avenue North
+				Seattle  WA  98109
+				US
+
+98-E7-9A   (hex)		Foxconn(NanJing) Communication Co.,Ltd.
+98E79A     (base 16)		Foxconn(NanJing) Communication Co.,Ltd.
+				A-2FMinfang Building No.189 Guangzhou Rd 
+				Nanjing  Jiang su  210029
+				CN
+
+A0-E9-DB   (hex)		Ningbo FreeWings Technologies Co.,Ltd
+A0E9DB     (base 16)		Ningbo FreeWings Technologies Co.,Ltd
+				Room 1107-1108, No 298 XueShi Road Yinzhou District Ningbo, 
+				Ningbo  Zhejiang  315000
+				CN
+
+78-89-73   (hex)		CMC
+788973     (base 16)		CMC
+				Industriepark De Bruwaan 37B
+				Oudenaarde  Oost-Vlaanderen  9700
+				BE
+
+14-30-7A   (hex)		Avermetrics
+14307A     (base 16)		Avermetrics
+				2973 Glendale Blvd.
+				Los Angeles  CA  90039
+				US
+
+A0-6C-EC   (hex)		RIM
+A06CEC     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+20-37-06   (hex)		Cisco Systems, Inc
+203706     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-B1-64   (hex)		Lightning Telecommunications Technology Co. Ltd
+F4B164     (base 16)		Lightning Telecommunications Technology Co. Ltd
+				Room 1302, Tian¡¯an Hi-Tech Plaza Tower A, Futian District, 
+				ShenZhen  GuangDong  518040
+				CN
+
+70-B0-35   (hex)		Shenzhen Zowee Technology Co., Ltd
+70B035     (base 16)		Shenzhen Zowee Technology Co., Ltd
+				Block 5, Science and Technology Industrial 
+				Shenzhen  Guangdong  518055
+				CN
+
+88-21-E3   (hex)		Nebusens, S.L.
+8821E3     (base 16)		Nebusens, S.L.
+				C/ Adaja S/N, Edificio M2
+				Villamayor de la Armuña  Salamanca  37185
+				ES
+
+90-B9-7D   (hex)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+90B97D     (base 16)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+				1531 E Madison Ave
+				Mankato  MN  56001
+				US
+
+7C-F4-29   (hex)		NUUO Inc. 
+7CF429     (base 16)		NUUO Inc. 
+				C block, 18 Sihyuan St. Jhongjheng District, 
+				Taipei    100
+				TW
+
+CC-B5-5A   (hex)		Fraunhofer ITWM
+CCB55A     (base 16)		Fraunhofer ITWM
+				Fraunhoferplatz 1
+				Kaiserslautern  Rhineland-Palatinae  67663
+				DE
+
+AC-8A-CD   (hex)		ROGER D.Wensker, G.Wensker sp.j.
+AC8ACD     (base 16)		ROGER D.Wensker, G.Wensker sp.j.
+				Gosciszewo 59
+				Sztum  Pomorskie  82-400
+				PL
+
+98-42-46   (hex)		SOL INDUSTRY PTE., LTD
+984246     (base 16)		SOL INDUSTRY PTE., LTD
+				 1 NORTH BRIDGE RD.,
+				    179094
+				SG
+
+34-29-EA   (hex)		MCD ELECTRONICS SP. Z O.O.
+3429EA     (base 16)		MCD ELECTRONICS SP. Z O.O.
+				Lelewela 26
+				Zywiec  slaskie  34-300
+				PL
+
+8C-82-A8   (hex)		Insigma Technology Co.,Ltd
+8C82A8     (base 16)		Insigma Technology Co.,Ltd
+				No.226 Tianmushan Road, 
+				Hangzhou  Zhejiang  310000
+				CN
+
+60-19-0C   (hex)		RRAMAC
+60190C     (base 16)		RRAMAC
+				15400 Medina Rd
+				Plymouth  MN  55447
+				US
+
+D0-5F-CE   (hex)		Hitachi Data Systems
+D05FCE     (base 16)		Hitachi Data Systems
+				750 Central Expressway
+				Santa Clara  CA  95050
+				US
+
+F8-03-32   (hex)		Khomp
+F80332     (base 16)		Khomp
+				Rua Joe Collaço, 253
+				Florianópolis  Santa Catarina  88037-010
+				BR
+
+28-A5-74   (hex)		Miller Electric Mfg. Co.
+28A574     (base 16)		Miller Electric Mfg. Co.
+				N676 Communication Drive
+				Appleton  WI  54914
+				US
+
+10-45-BE   (hex)		Norphonic AS
+1045BE     (base 16)		Norphonic AS
+				Fabrikkgaten 10
+				Bergen    5059
+				NO
+
+90-B8-D0   (hex)		Joyent, Inc.
+90B8D0     (base 16)		Joyent, Inc.
+				345 California Street,
+				San Francisco  CA  94104
+				US
+
+AC-47-23   (hex)		Genelec
+AC4723     (base 16)		Genelec
+				Olvitie 5
+				Iisalmi    74100
+				FI
+
+E8-BA-70   (hex)		Cisco Systems, Inc
+E8BA70     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-A4-25   (hex)		SMAX Technology Co., Ltd.
+D4A425     (base 16)		SMAX Technology Co., Ltd.
+				2F., No. 3, Wuquan 3rd, Wugu Dist.
+				New Taipei City    248
+				TW
+
+28-14-71   (hex)		Lantis co., LTD.
+281471     (base 16)		Lantis co., LTD.
+				busan innobiz center 401
+				busan    616-829
+				KR
+
+24-47-0E   (hex)		PentronicAB
+24470E     (base 16)		PentronicAB
+				Bergsliden 1
+				GUNNEBO    59093
+				SE
+
+D0-9B-05   (hex)		Emtronix
+D09B05     (base 16)		Emtronix
+				5# Gaopeng Dadao
+				Chengdu    610041
+				CN
+
+8C-11-CB   (hex)		ABUS Security-Center GmbH & Co. KG
+8C11CB     (base 16)		ABUS Security-Center GmbH & Co. KG
+				Linker Kreuthweg 5
+				Affing / Muehlhausen  Bavaria  86444
+				DE
+
+FC-83-29   (hex)		Trei technics
+FC8329     (base 16)		Trei technics
+				801 Northpoint Pkwy
+				West Palm Beach  Florida  33407
+				US
+
+14-EB-33   (hex)		BSMediasoft Co., Ltd.
+14EB33     (base 16)		BSMediasoft Co., Ltd.
+				#603, Garden Bldg., 14-13, Yoido-Dong, Youngdeungpo-Gu
+				Seoul    150-871
+				KR
+
+F4-B5-49   (hex)		Xiamen Yeastar Information Technology Co., Ltd.
+F4B549     (base 16)		Xiamen Yeastar Information Technology Co., Ltd.
+				3/F, No. 46 Guanri Road, 2nd Software Park
+				Xiamen  Fujian  361006
+				CN
+
+88-B1-68   (hex)		Delta Control GmbH
+88B168     (base 16)		Delta Control GmbH
+				Rondorfer Hauptstraße 33
+				Cologne  NRW  50997
+				DE
+
+68-87-6B   (hex)		INQ Mobile Limited
+68876B     (base 16)		INQ Mobile Limited
+				6 Hester Road
+				Battersea  London  SW11 4AN
+				GB
+
+1C-AA-07   (hex)		Cisco Systems, Inc
+1CAA07     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+68-5B-36   (hex)		POWERTECH INDUSTRIAL CO., LTD.
+685B36     (base 16)		POWERTECH INDUSTRIAL CO., LTD.
+				10F, No. 407, Chung Shan Rd., Sec 2,
+				Chung Ho  Taipei County  23558
+				TW
+
+28-EE-2C   (hex)		Frontline Test Equipment
+28EE2C     (base 16)		Frontline Test Equipment
+				PO Box 7507
+				Charlottesville  Virginia  22906-7507
+				US
+
+78-2E-EF   (hex)		Nokia Corporation
+782EEF     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+7C-F0-BA   (hex)		Linkwell Telesystems Pvt Ltd
+7CF0BA     (base 16)		Linkwell Telesystems Pvt Ltd
+				1-11-252/1/A, Gowra Klassic
+				Hyderabad  Andhra Pradesh  500016
+				IN
+
+AC-86-74   (hex)		Open Mesh, Inc.
+AC8674     (base 16)		Open Mesh, Inc.
+				111 SW 5th Ave Ste1150
+				Portland  OR  97204
+				US
+
+64-D2-41   (hex)		Keith & Koep GmbH
+64D241     (base 16)		Keith & Koep GmbH
+				Uellendahler Str. 199
+				Wuppertal  NRW  42109
+				DE
+
+18-B7-9E   (hex)		Invoxia
+18B79E     (base 16)		Invoxia
+				87 rue du Gouverneur Général Eboué
+				Issy-Les-Moulineaux    92130
+				FR
+
+8C-44-35   (hex)		Shanghai BroadMobi Communication Technology Co., Ltd.
+8C4435     (base 16)		Shanghai BroadMobi Communication Technology Co., Ltd.
+				Rm. 901, Bld. 9, No.1515 Gumei Rd, Xuhui District
+				Shanghai    200233
+				CN
+
+F8-1D-93   (hex)		Longdhua(Beijing) Controls Technology Co.,Ltd
+F81D93     (base 16)		Longdhua(Beijing) Controls Technology Co.,Ltd
+				Room 1203,Lixiang Building, No.111 Zhichun Road,Haidian District,
+				Beijing    10086
+				CN
+
+94-D9-3C   (hex)		ENELPS
+94D93C     (base 16)		ENELPS
+				Bul Arsenija Carnojevica 117
+				Belgrade    11070
+				RS
+
+B8-BE-BF   (hex)		Cisco Systems, Inc
+B8BEBF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+64-B6-4A   (hex)		ViVOtech, Inc.
+64B64A     (base 16)		ViVOtech, Inc.
+				451 El Camino Real
+				Santa Clara  CA  95050
+				US
+
+38-D1-35   (hex)		EasyIO Corporation Sdn. Bhd.
+38D135     (base 16)		EasyIO Corporation Sdn. Bhd.
+				No. 32-2 & 32-3, Jalan Puteri 2/4
+				Puchong  Selangor  47100
+				MY
+
+CC-F8-41   (hex)		Lumewave
+CCF841     (base 16)		Lumewave
+				4803 B Street
+				Sacramento  CA  95819
+				US
+
+30-EB-25   (hex)		INTEK DIGITAL
+30EB25     (base 16)		INTEK DIGITAL
+				801, 8th Fl., Anyang K-center building, 1591-9
+				Anyang    431-060
+				KR
+
+44-E4-D9   (hex)		Cisco Systems, Inc
+44E4D9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+AC-CA-54   (hex)		Telldus Technologies AB
+ACCA54     (base 16)		Telldus Technologies AB
+				Skiffervägen 102
+				Lund    224 78
+				SE
+
+90-19-00   (hex)		SCS SA
+901900     (base 16)		SCS SA
+				Via Pini, 32
+				Biasca    6710
+				CH
+
+D4-5D-42   (hex)		Nokia Corporation
+D45D42     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+B0-38-29   (hex)		Siliconware Precision Industries Co., Ltd.
+B03829     (base 16)		Siliconware Precision Industries Co., Ltd.
+				No. 123, Sec.3, Da Fong Rd, Tantzu, 
+				Taichung    427
+				TW
+
+7C-6C-39   (hex)		PIXSYS SRL
+7C6C39     (base 16)		PIXSYS SRL
+				VIA DELLA CROCE ROSSA 42
+				PADOVA  PD  35129
+				IT
+
+18-B3-BA   (hex)		Netlogic AB
+18B3BA     (base 16)		Netlogic AB
+				Datavägen 14A
+				ASKIM  Västra Götaland  43632
+				SE
+
+8C-5F-DF   (hex)		Beijing Railway Signal Factory
+8C5FDF     (base 16)		Beijing Railway Signal Factory
+				No.2 Sicun Xilu Langfa,Huangcun,
+				Beiijng    102613
+				CN
+
+D4-7B-75   (hex)		HARTING Electronics GmbH
+D47B75     (base 16)		HARTING Electronics GmbH
+				Marienwerderstraße. 3
+				Espelkamp  North Rhine Westphalia  32339
+				DE
+
+D8-DF-0D   (hex)		beroNet GmbH
+D8DF0D     (base 16)		beroNet GmbH
+				Friedrichstraße 231
+				Berlin    10969
+				DE
+
+AC-F9-7E   (hex)		ELESYS INC.
+ACF97E     (base 16)		ELESYS INC.
+				Suit 623, 812-1, Hyomun-dong
+				Ulsan  Buk-gu  683-360
+				KR
+
+20-40-05   (hex)		feno GmbH
+204005     (base 16)		feno GmbH
+				Kolpingring 22
+				Oberhaching  Bavaria  82041
+				DE
+
+D4-6F-42   (hex)		WAXESS USA Inc
+D46F42     (base 16)		WAXESS USA Inc
+				1401 Dove Street
+				Newport Beach  CA  92660
+				US
+
+30-0B-9C   (hex)		Delta Mobile Systems, Inc.
+300B9C     (base 16)		Delta Mobile Systems, Inc.
+				700 Remington Road
+				Schaumburg  Illinois  60173
+				US
+
+6C-AD-3F   (hex)		Hubbell Building Automation, Inc.
+6CAD3F     (base 16)		Hubbell Building Automation, Inc.
+				9601 Dessau Rd
+				Austin  Texas  78754
+				US
+
+B0-1B-7C   (hex)		Ontrol A.S.
+B01B7C     (base 16)		Ontrol A.S.
+				Turcan Cad No:19 Y.Dudullu
+				Umraniye  Istanbul  34775
+				TR
+
+04-C5-A4   (hex)		Cisco Systems, Inc
+04C5A4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-28-46   (hex)		NextBIT Computing Pvt. Ltd.
+BC2846     (base 16)		NextBIT Computing Pvt. Ltd.
+				30/2, 2nd Floor, R.K. Plaza,
+				Bangalore  Karnataka  560038
+				IN
+
+BC-0F-2B   (hex)		FORTUNE TECHGROUP CO.,LTD
+BC0F2B     (base 16)		FORTUNE TECHGROUP CO.,LTD
+				7-8F,No.1198 North Qinzhou Road,
+				Shanghai    200233
+				CN
+
+64-81-25   (hex)		Alphatron Marine BV
+648125     (base 16)		Alphatron Marine BV
+				Schaardijk 23
+				Rotterdam  Zuid-Holland  3063NH
+				NL
+
+8C-F9-C9   (hex)		MESADA Technology Co.,Ltd.
+8CF9C9     (base 16)		MESADA Technology Co.,Ltd.
+				TongFng Information Harbor,No.11 LangShan Road,HI-tech Park,Nanshan District,
+				Shenzhen  GuangDong  518057
+				CN
+
+C0-62-6B   (hex)		Cisco Systems, Inc
+C0626B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+94-E2-26   (hex)		D. ORtiz Consulting, LLC
+94E226     (base 16)		D. ORtiz Consulting, LLC
+				22601 N. 17th Avenue Suite 270
+				Phoenix  AZ  85027
+				US
+
+D8-C9-9D   (hex)		EA DISPLAY LIMITED
+D8C99D     (base 16)		EA DISPLAY LIMITED
+				22/F DELTA HOUSE 3 ON YIU ST
+				SHATIN NT    
+				HK
+
+10-83-D2   (hex)		Microseven Systems, LLC
+1083D2     (base 16)		Microseven Systems, LLC
+				404 South Lemon Ave., #9
+				Walnut  California  91789
+				US
+
+34-68-4A   (hex)		Teraworks Co., Ltd.
+34684A     (base 16)		Teraworks Co., Ltd.
+				Room No. 201 , 515-30 , Mok-Dong
+				Seoul    158-808
+				KR
+
+CC-FC-6D   (hex)		RIZ TRANSMITTERS
+CCFC6D     (base 16)		RIZ TRANSMITTERS
+				BOZIDAREVICEVA 13
+				ZAGREB    10000
+				HR
+
+E0-3E-7D   (hex)		data-complex GmbH
+E03E7D     (base 16)		data-complex GmbH
+				Düsterngraben 7
+				Halberstadt  Sachsen-Anhalt  38820
+				DE
+
+0C-C6-AC   (hex)		DAGS
+0CC6AC     (base 16)		DAGS
+				Ace High end Tower 7th 1802
+				Seoul  Geumcheon-gu  153-802
+				KR
+
+04-26-05   (hex)		GFR Gesellschaft für Regelungstechnik und Energieeinsparung mbH
+042605     (base 16)		GFR Gesellschaft für Regelungstechnik und Energieeinsparung mbH
+				Kapellenweg 42
+				Verl    33415
+				DE
+
+24-F0-FF   (hex)		GHT Co., Ltd.
+24F0FF     (base 16)		GHT Co., Ltd.
+				#16 Nanyunyi Lu, Guangzhou Science City
+				Guangzhou  Guangdong  510663
+				CN
+
+9C-C0-D2   (hex)		Conductix-Wampfler GmbH
+9CC0D2     (base 16)		Conductix-Wampfler GmbH
+				Rheinstrasse 27+33
+				  Baden-Württemberg  
+				DE
+
+CC-F6-7A   (hex)		Ayecka Communication Systems LTD
+CCF67A     (base 16)		Ayecka Communication Systems LTD
+				POB 3059
+				Hod Hasharon    45130
+				IL
+
+80-65-E9   (hex)		BenQ Corporation
+8065E9     (base 16)		BenQ Corporation
+				16 Jihu Road, Neihu
+				Taipei    114
+				TW
+
+EC-98-6C   (hex)		Lufft Mess- und Regeltechnik GmbH
+EC986C     (base 16)		Lufft Mess- und Regeltechnik GmbH
+				Gutenbergstraße 20
+				Fellbach  Baden-Württemberg  70736
+				DE
+
+D0-93-F8   (hex)		Stonestreet One LLC
+D093F8     (base 16)		Stonestreet One LLC
+				9960 Corporate Campus Drive
+				Louisville  KY  40223
+				US
+
+9C-64-5E   (hex)		Harman Consumer Group
+9C645E     (base 16)		Harman Consumer Group
+				8500 Balboa Blvd
+				Northridge  CA  91329
+				US
+
+1C-33-4D   (hex)		ITS Telecom
+1C334D     (base 16)		ITS Telecom
+				29 Hametzuda st. 
+				Azur  Israel  580001
+				IL
+
+DC-D8-7F   (hex)		Shenzhen JoinCyber Telecom Equipment Ltd
+DCD87F     (base 16)		Shenzhen JoinCyber Telecom Equipment Ltd
+				19CDE, Block A,JinFengBuilding,shangbu South Road,Futian District,
+				Shenzhen  Guangdong  518031
+				CN
+
+B4-E0-CD   (hex)		Fusion-io, Inc
+B4E0CD     (base 16)		Fusion-io, Inc
+				2880 Junction Avenue
+				San Jose  CA  95134-1922
+				US
+
+28-60-46   (hex)		Lantech Communications Global, Inc.
+286046     (base 16)		Lantech Communications Global, Inc.
+				7F, No. 45, Lane 188, Ruiguang Rd., Neihu District
+				Taipei City    11491
+				TW
+
+10-E2-D5   (hex)		Qi Hardware Inc.
+10E2D5     (base 16)		Qi Hardware Inc.
+				555 4TH STREET #403
+				San Francisco  CA  94107
+				US
+
+60-C9-80   (hex)		Trymus
+60C980     (base 16)		Trymus
+				Bucheon Techno Park 303-902
+				Bucheon-si  421-741  Gyunggi-do
+				KR
+
+A0-36-FA   (hex)		Ettus Research LLC
+A036FA     (base 16)		Ettus Research LLC
+				1043 N Shoreline Blvd
+				Mountain View  CA  94043
+				US
+
+EC-83-6C   (hex)		RM Tech Co., Ltd.
+EC836C     (base 16)		RM Tech Co., Ltd.
+				C-801, Bupyeong Woolim Lions Valley
+				Incheon City    403-911
+				KR
+
+30-39-55   (hex)		Shenzhen Jinhengjia Electronic Co., Ltd.
+303955     (base 16)		Shenzhen Jinhengjia Electronic Co., Ltd.
+				4-6 Floors, Factory Building, Jijia Industrial Park,
+				Shenzhen  Guangdong  518112
+				CN
+
+FC-5B-24   (hex)		Weibel Scientific A/S
+FC5B24     (base 16)		Weibel Scientific A/S
+				Solvang 30
+				Alleroed    3450
+				DK
+
+78-59-3E   (hex)		RAFI GmbH & Co.KG
+78593E     (base 16)		RAFI GmbH & Co.KG
+				Ravensburger Str. 128-134
+				Berg  Baden Wurttemberg  88276
+				DE
+
+50-97-72   (hex)		Westinghouse Digital
+509772     (base 16)		Westinghouse Digital
+				500 N. State College Blvd.
+				Orange  CA  92868
+				US
+
+50-3D-E5   (hex)		Cisco Systems, Inc
+503DE5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+54-04-96   (hex)		Gigawave LTD
+540496     (base 16)		Gigawave LTD
+				GIGAWAVE TECHNICAL CENTRE
+				Colchester  ESSEX  CO62NS
+				GB
+
+EC-46-44   (hex)		TTK SAS
+EC4644     (base 16)		TTK SAS
+				4, Rue du Chemin Vert
+				Clichy    92110
+				FR
+
+4C-B9-C8   (hex)		CONET CO., LTD.
+4CB9C8     (base 16)		CONET CO., LTD.
+				2-8,HIGASHIJIMA-CHO
+				ICHINOMIYA  AICHI  491-0074
+				JP
+
+8C-B6-4F   (hex)		Cisco Systems, Inc
+8CB64F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+20-4A-AA   (hex)		Hanscan Spain S.A.
+204AAA     (base 16)		Hanscan Spain S.A.
+				Avda. de la Vega, 1
+				Alcobendas  Madrid  28108
+				ES
+
+20-FE-CD   (hex)		System In Frontier Inc.
+20FECD     (base 16)		System In Frontier Inc.
+				4F Shinsuzuharu Bldg. 2-8-3 Akebonocyo
+				Tachikawa-shi  Tokyo  190-0012
+				JP
+
+F0-93-3A   (hex)		NxtConect
+F0933A     (base 16)		NxtConect
+				Schillerstrasse 4
+				Bad Kissingen    97688
+				DE
+
+B8-41-5F   (hex)		ASP AG
+B8415F     (base 16)		ASP AG
+				Max- Planck-Str. 15 a-c
+				Erkrath  NRW  40699
+				DE
+
+2C-B6-9D   (hex)		RED Digital Cinema
+2CB69D     (base 16)		RED Digital Cinema
+				20291 Valencia Circle
+				Lake Forest  California  92630
+				US
+
+58-2F-42   (hex)		Universal Electric Corporation
+582F42     (base 16)		Universal Electric Corporation
+				168 Georgetown Road
+				Canonsburg  PA  15317
+				US
+
+04-74-A1   (hex)		Aligera Equipamentos Digitais Ltda
+0474A1     (base 16)		Aligera Equipamentos Digitais Ltda
+				Av. Para 330 / 302
+				Porto Alegre  RS  90240-590
+				BR
+
+5C-69-84   (hex)		NUVICO
+5C6984     (base 16)		NUVICO
+				1 Enterprise Place  Unit G
+				Hicksville  NY  11801
+				US
+
+70-DD-A1   (hex)		Tellabs
+70DDA1     (base 16)		Tellabs
+				One Tellabs Center
+				Naperville  Illinois  60563
+				US
+
+94-D0-19   (hex)		Cydle Corp.
+94D019     (base 16)		Cydle Corp.
+				1203, KofomoTower, 16-3 , Sunae-Dong, Bundang-Gu
+				Seongnam-City  Gyeonggi-Do  463825
+				KR
+
+8C-27-8A   (hex)		Vocollect Inc
+8C278A     (base 16)		Vocollect Inc
+				703 Rodi Road
+				Pittsburgh  Pa  15235
+				US
+
+CC-0C-DA   (hex)		Miljovakt AS
+CC0CDA     (base 16)		Miljovakt AS
+				Gannestadveien 2
+				Borre  Vestfold  3184
+				NO
+
+E4-1C-4B   (hex)		V2 TECHNOLOGY, INC.
+E41C4B     (base 16)		V2 TECHNOLOGY, INC.
+				4450 Enterprise Street
+				Fremont  California  94538
+				US
+
+5C-F3-FC   (hex)		IBM Corp
+5CF3FC     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+A8-6A-6F   (hex)		RIM
+A86A6F     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+68-12-2D   (hex)		Special Instrument Development Co., Ltd.
+68122D     (base 16)		Special Instrument Development Co., Ltd.
+				6F-1, No. 123, Lane 235
+				Hsin Tien  Taipei Hsien  231
+				TW
+
+94-F7-20   (hex)		Tianjin Deviser Electronics Instrument Co., Ltd
+94F720     (base 16)		Tianjin Deviser Electronics Instrument Co., Ltd
+				No.40 Yibin Road,Nankai district,
+				Tianjin    300113
+				CN
+
+DC-9C-52   (hex)		Sapphire Technology Limited.
+DC9C52     (base 16)		Sapphire Technology Limited.
+				Unit 1909-1919, 19/F., Tower 2, Grand Central Plaza,
+				    
+				HK
+
+48-91-F6   (hex)		Shenzhen Reach software technology CO.,LTD
+4891F6     (base 16)		Shenzhen Reach software technology CO.,LTD
+				6/F,Block B, Kingdee Software park,#2,Keji 12th South Road,Hi-tech Industrial Park,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+64-9B-24   (hex)		V Technology Co., Ltd.
+649B24     (base 16)		V Technology Co., Ltd.
+				YBP East Tower 5F,
+				Yokohama city  Kanagawa  240-0005
+				JP
+
+84-6E-B1   (hex)		Park Assist LLC
+846EB1     (base 16)		Park Assist LLC
+				111 W28th Street
+				New York  NY  10001
+				US
+
+6C-50-4D   (hex)		Cisco Systems, Inc
+6C504D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B8-D0-6F   (hex)		GUANGZHOU HKUST FOK YING TUNG RESEARCH INSTITUTE
+B8D06F     (base 16)		GUANGZHOU HKUST FOK YING TUNG RESEARCH INSTITUTE
+				Rm 403, North of Software Building,Nansha IT Park,
+				Guangzhou  Guangdong Privince  511458
+				CN
+
+EC-14-F6   (hex)		BioControl AS
+EC14F6     (base 16)		BioControl AS
+				Grimstad Gard 
+				Rakkestad     N-1890
+				NO
+
+E8-99-5A   (hex)		PiiGAB, Processinformation i Goteborg AB
+E8995A     (base 16)		PiiGAB, Processinformation i Goteborg AB
+				Anders Carlssons gata 1
+				Gothenburg    417 55
+				SE
+
+40-1D-59   (hex)		Biometric Associates, LP
+401D59     (base 16)		Biometric Associates, LP
+				9475 Deereco Rd.
+				Timonium  MD  21093
+				US
+
+B8-FF-6F   (hex)		Shanghai Typrotech Technology Co.Ltd
+B8FF6F     (base 16)		Shanghai Typrotech Technology Co.Ltd
+				Design Building 903, NO.63, 
+				Shanghai    200092
+				CN
+
+1C-BD-0E   (hex)		Amplified Engineering Pty Ltd
+1CBD0E     (base 16)		Amplified Engineering Pty Ltd
+				5 Turner Avenue
+				Bentley  WA  6102
+				AU
+
+A0-F2-17   (hex)		GE Medical System(China) Co., Ltd. 
+A0F217     (base 16)		GE Medical System(China) Co., Ltd. 
+				No.19, ChangJiang Road 
+				Wuxi  Jiangsu  214028 
+				CN
+
+F0-A7-64   (hex)		GST Co., Ltd.
+F0A764     (base 16)		GST Co., Ltd.
+				#988-6, Gosaek-Dong, Gwonseon-Gu
+				Suwon-Si  Gyeonggi-Do  441-813
+				KR
+
+1C-06-56   (hex)		IDY Corporation
+1C0656     (base 16)		IDY Corporation
+				IDEMITSU Korakuen Bld 9F
+				Bunkyo-ku  Tokyo  112-0002
+				JP
+
+50-0E-6D   (hex)		TrafficCast International
+500E6D     (base 16)		TrafficCast International
+				2801 Coho Street
+				Madison  WI  53713
+				US
+
+EC-3B-F0   (hex)		NovelSat
+EC3BF0     (base 16)		NovelSat
+				Hataasia 21
+				Raanana    2396
+				IL
+
+4C-ED-DE   (hex)		ASKEY COMPUTER CORP
+4CEDDE     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+E8-E0-8F   (hex)		GRAVOTECH MARKING SAS
+E8E08F     (base 16)		GRAVOTECH MARKING SAS
+				56 AVENUE JEAN JAURES
+				LA CHAPELLE SAINT LUC  AUBE  10600
+				FR
+
+AC-AB-8D   (hex)		Lyngso Marine A/S
+ACAB8D     (base 16)		Lyngso Marine A/S
+				Lyngso Alle 2
+				Horsholm    DK-2970
+				DK
+
+60-83-B2   (hex)		GkWare e.K.
+6083B2     (base 16)		GkWare e.K.
+				Hatzper Str. 172B
+				Essen  NRW  45149
+				DE
+
+80-D0-19   (hex)		Embed, Inc
+80D019     (base 16)		Embed, Inc
+				410 Great Road
+				Littleton  MA  01460
+				US
+
+68-EB-C5   (hex)		Angstrem Telecom
+68EBC5     (base 16)		Angstrem Telecom
+				Yuzhnaya promzona, passage 4806, 4, build 3 
+				Zelenograd  Moscow  124460
+				RU
+
+A0-B5-DA   (hex)		HongKong THTF Co., Ltd
+A0B5DA     (base 16)		HongKong THTF Co., Ltd
+				2F,Sector C of Tsinghua University Academy, 
+				Shenzhen  Guangdong  518057
+				CN
+
+88-86-A0   (hex)		Simton Technologies, Ltd.
+8886A0     (base 16)		Simton Technologies, Ltd.
+				2 Taishan Road, Building C, 3rd Floor
+				Wuxi,   Province of Jiangsu,   214028
+				CN
+
+A4-50-55   (hex)		BUSWARE.DE
+A45055     (base 16)		BUSWARE.DE
+				Lindenstrasse 18
+				Scharbeutz    23684
+				DE
+
+A8-9B-10   (hex)		inMotion Ltd.
+A89B10     (base 16)		inMotion Ltd.
+				Unit 2709 Exchange Tower 
+				    KLN
+				HK
+
+B4-14-89   (hex)		Cisco Systems, Inc
+B41489     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-A8-0F   (hex)		Shenzhen Coship Electronics Co., Ltd.
+A4A80F     (base 16)		Shenzhen Coship Electronics Co., Ltd.
+				Rainbow Bldg., North, Hi-Tech Industrial Park, Nanshan District, 
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-B5-99   (hex)		Guangzhou CHNAVS Digital Technology Co.,Ltd
+F8B599     (base 16)		Guangzhou CHNAVS Digital Technology Co.,Ltd
+				Buliding C, industy base of digital home application and demonstration ,zhongyi road Guangzhou higher education mega center
+				Guangzhou  Guangdong  510006
+				CN
+
+B8-92-1D   (hex)		BG T&A
+B8921D     (base 16)		BG T&A
+				4F, L&C Tower
+				Gunpo-si  Gyeonggi-do  435-845
+				KR
+
+D0-89-99   (hex)		APCON, Inc.
+D08999     (base 16)		APCON, Inc.
+				9255 SW Pioneer Court
+				Wilsonville  OR  97070
+				US
+
+C8-84-47   (hex)		Beautiful Enterprise Co., Ltd
+C88447     (base 16)		Beautiful Enterprise Co., Ltd
+				26th Floor, Beautiful Group Tower 
+				    
+				HK
+
+54-FD-BF   (hex)		Scheidt & Bachmann GmbH
+54FDBF     (base 16)		Scheidt & Bachmann GmbH
+				Breite Strasse 132
+				Moenchengladbach  NRW  41238
+				DE
+
+D0-BB-80   (hex)		SHL Telemedicine International Ltd.
+D0BB80     (base 16)		SHL Telemedicine International Ltd.
+				90 Yigal Alon
+				Tel Aviv    67891
+				IL
+
+5C-17-D3   (hex)		LGE 
+5C17D3     (base 16)		LGE 
+				60-39 , Kasan -dong , Gumcheon-gu.
+				Seoul     153-801
+				KR
+
+1C-DF-0F   (hex)		Cisco Systems, Inc
+1CDF0F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+68-BD-AB   (hex)		Cisco Systems, Inc
+68BDAB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-AD-EF   (hex)		Obihai Technology, Inc.
+9CADEF     (base 16)		Obihai Technology, Inc.
+				2105 S. Bascom Ave #285
+				Campbell  CA  95008
+				US
+
+C8-8B-47   (hex)		Nolangroup S.P.A con Socio Unico
+C88B47     (base 16)		Nolangroup S.P.A con Socio Unico
+				via Terzi di S.Agata 2
+				Brembate di Sopra  Bergamo  24030
+				IT
+
+C4-CD-45   (hex)		Beijing Boomsense Technology CO.,LTD.
+C4CD45     (base 16)		Beijing Boomsense Technology CO.,LTD.
+				803 Building 4 INTERWEST Business Center,No.9 South Shouti Road ,HaidianDistrict,
+				Beijing    100048
+				CN
+
+8C-E7-B3   (hex)		Sonardyne International Ltd
+8CE7B3     (base 16)		Sonardyne International Ltd
+				Blackbushe Business Park
+				Yateley  Hampshire  GU46 6GD
+				GB
+
+08-8D-C8   (hex)		Ryowa Electronics Co.,Ltd
+088DC8     (base 16)		Ryowa Electronics Co.,Ltd
+				1483-1 Takahara-machi
+				Yamagata-shi  Yamagata-pref.  9900002
+				JP
+
+80-C6-CA   (hex)		Endian s.r.l.
+80C6CA     (base 16)		Endian s.r.l.
+				Pillhof 47
+				Frangarto  Bolzano  39010
+				IT
+
+70-76-F0   (hex)		LevelOne Communications (India) Private Limited
+7076F0     (base 16)		LevelOne Communications (India) Private Limited
+				2F, Lane 1, 45 Bharat Nagar
+				New Delhi  DELHI  110025
+				IN
+
+C0-2B-FC   (hex)		iNES. applied informatics GmbH
+C02BFC     (base 16)		iNES. applied informatics GmbH
+				Ohmstrasse 9
+				Ludwigsburg    71642
+				DE
+
+94-C7-AF   (hex)		Raylios Technology
+94C7AF     (base 16)		Raylios Technology
+				12F., No.16, Jian 8th Rd
+				Zhonghe City  Taipei County   23511
+				TW
+
+D8-1C-14   (hex)		Compacta International, Ltd.
+D81C14     (base 16)		Compacta International, Ltd.
+				31342 Via Las Palmas
+				San Juan Capistrano  CA  92675
+				US
+
+00-8C-10   (hex)		Black Box Corp.
+008C10     (base 16)		Black Box Corp.
+				1000 Park Drive
+				Lawrence  PA  15055
+				US
+
+90-90-3C   (hex)		TRISON TECHNOLOGY CORPORATION
+90903C     (base 16)		TRISON TECHNOLOGY CORPORATION
+				No.3, Kung-Yeh 12th Rd., Ping-Jen Industrial Park,
+				Ping-Jen City,   TaoYuan County  32459
+				TW
+
+E0-61-B2   (hex)		HANGZHOU ZENOINTEL TECHNOLOGY CO., LTD
+E061B2     (base 16)		HANGZHOU ZENOINTEL TECHNOLOGY CO., LTD
+				Room 806, F#, Cambridge Combridge, Shenhua Road,District Xihu, 
+				Hangzhou  Zhejiang  310030
+				CN
+
+94-11-DA   (hex)		ITF Fröschl GmbH
+9411DA     (base 16)		ITF Fröschl GmbH
+				Hauserbachstraße 9
+				Walderbach  Bavaria  93194
+				DE
+
+80-39-E5   (hex)		PATLITE CORPORATION
+8039E5     (base 16)		PATLITE CORPORATION
+				19-2
+				SANDA  HYOUGOKEN  669-1339
+				JP
+
+DC-7B-94   (hex)		Cisco Systems, Inc
+DC7B94     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+5C-CA-32   (hex)		Theben AG
+5CCA32     (base 16)		Theben AG
+				Hohenbergstraße 32
+				Haigerloch  Baden-Württemberg  72401
+				DE
+
+74-15-E2   (hex)		Tri-Sen Systems Corporation
+7415E2     (base 16)		Tri-Sen Systems Corporation
+				17625 El Camino Real Suite 200
+				Houston  TX  77058
+				US
+
+EC-C3-8A   (hex)		Accuenergy (CANADA) Inc
+ECC38A     (base 16)		Accuenergy (CANADA) Inc
+				2 Lansing Square, Suite 503
+				Toronto  Ontario  M2J 4P8
+				CA
+
+D4-8F-AA   (hex)		Sogecam Industrial, S.A.
+D48FAA     (base 16)		Sogecam Industrial, S.A.
+				Rosalind Franklin, 22-24
+				Malaga    29590
+				ES
+
+B0-81-D8   (hex)		I-sys Corp
+B081D8     (base 16)		I-sys Corp
+				2457 Aviation Ave
+				N. Charleston  South Carolina  29406
+				US
+
+14-FE-AF   (hex)		SAGITTAR LIMITED
+14FEAF     (base 16)		SAGITTAR LIMITED
+				2-102, BLD34, BAIWANGMOLIYUAN
+				BEIJING    100094
+				CN
+
+B0-B8-D5   (hex)		Nanjing Nengrui Auto Equipment CO.,Ltd
+B0B8D5     (base 16)		Nanjing Nengrui Auto Equipment CO.,Ltd
+				No.108 Ganjiabian East Yaohua Town
+				Nanjing  Jiangsu  210046
+				CN
+
+94-E7-11   (hex)		Xirka Dama Persada PT
+94E711     (base 16)		Xirka Dama Persada PT
+				Gdg CM
+				Jakarta    13150
+				ID
+
+6C-9B-02   (hex)		Nokia Corporation
+6C9B02     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+64-1E-81   (hex)		Dowslake Microsystems
+641E81     (base 16)		Dowslake Microsystems
+				21 High Street, Suite 306
+				North Andover  MA  01845
+				US
+
+EC-54-2E   (hex)		Shanghai XiMei Electronic Technology Co. Ltd
+EC542E     (base 16)		Shanghai XiMei Electronic Technology Co. Ltd
+				Room 503, No.2623, GongHeXin Road
+				Shanghai    200072
+				CN
+
+FC-D4-F6   (hex)		Messana Air.Ray Conditioning s.r.l.
+FCD4F6     (base 16)		Messana Air.Ray Conditioning s.r.l.
+				Via Venezia 18
+				Oderzo  TV  31046
+				IT
+
+D4-66-A8   (hex)		Riedo Networks Ltd
+D466A8     (base 16)		Riedo Networks Ltd
+				Route de la Fonderie 6
+				Fribourg    1700
+				CH
+
+F0-E5-C3   (hex)		Drägerwerk AG & Co. KG aA
+F0E5C3     (base 16)		Drägerwerk AG & Co. KG aA
+				Moislinger Allee 53-55
+				Luebeck  Germany  23452
+				DE
+
+D8-29-86   (hex)		Best Wish Technology LTD
+D82986     (base 16)		Best Wish Technology LTD
+				7E,Hai Yi Business Building,No.310,Tianshan RD.,
+				Shanghai    200336
+				CN
+
+44-61-32   (hex)		ecobee inc
+446132     (base 16)		ecobee inc
+				333 Adelaide St W 6th Floor
+				Toronto  Ontario  M5V1R5
+				CA
+
+F4-1F-0B   (hex)		YAMABISHI Corporation
+F41F0B     (base 16)		YAMABISHI Corporation
+				3-14-12 Kamigou
+				Ebina-city  KANAGAWA  243-0434
+				JP
+
+A0-82-C7   (hex)		P.T.I Co.,LTD
+A082C7     (base 16)		P.T.I Co.,LTD
+				1-5-1,Tsurumidan
+				Koriyama-shi  Fukushima  963-8861
+				JP
+
+04-36-04   (hex)		Gyeyoung I&T
+043604     (base 16)		Gyeyoung I&T
+				6F, Woosung Bldg. 1000-1, Daechi-dong
+				  Seoul  135-502
+				KR
+
+A4-B2-A7   (hex)		Adaxys Solutions AG
+A4B2A7     (base 16)		Adaxys Solutions AG
+				Eichtalstrasse 55
+				Hombrechtikon  CH  8634
+				CH
+
+D0-D0-FD   (hex)		Cisco Systems, Inc
+D0D0FD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-5B-70   (hex)		Innovid, Co., Ltd.
+E05B70     (base 16)		Innovid, Co., Ltd.
+				5th Floor, Boga Building, 821-3, Bangbaedong, Seochogu
+				Seoul    137-060
+				KR
+
+14-1B-BD   (hex)		Volex Inc.
+141BBD     (base 16)		Volex Inc.
+				915 Tate Blvd. SE
+				Hickory  NC  28602
+				US
+
+E8-7A-F3   (hex)		S5 Tech S.r.l.
+E87AF3     (base 16)		S5 Tech S.r.l.
+				Via Tortona 72
+				Milano    20144
+				IT
+
+CC-5C-75   (hex)		Weightech Com. Imp. Exp. Equip. Pesagem Ltda
+CC5C75     (base 16)		Weightech Com. Imp. Exp. Equip. Pesagem Ltda
+				Rodovia Virgílio Várzea, 3110 - Sala 01
+				Florianópolis  SC  88032-001
+				BR
+
+1C-6F-65   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+1C6F65     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+90-E0-F0   (hex)		IEEE 1722a Working Group
+90E0F0     (base 16)		IEEE 1722a Working Group
+				8760 Sandy Parkway
+				Sandy  Utah  84070
+				US
+
+40-52-0D   (hex)		Pico Technology
+40520D     (base 16)		Pico Technology
+				James House, Marlborough Road
+				St Neots  Cambridgeshire   PE19 8YP
+				GB
+
+80-7D-1B   (hex)		Neosystem Co. Ltd.
+807D1B     (base 16)		Neosystem Co. Ltd.
+				4-19-12 Takao
+				Dazaifu-shi  Fukuoka  818-0122
+				JP
+
+18-B2-09   (hex)		Torrey Pines Logic, Inc
+18B209     (base 16)		Torrey Pines Logic, Inc
+				12651 High Bluff Drive, #100
+				San Diego  CA  92130
+				US
+
+D8-4B-2A   (hex)		Cognitas Technologies, Inc.
+D84B2A     (base 16)		Cognitas Technologies, Inc.
+				6406 Laurel Bush Ln.
+				Sugar Land  Texas  77479
+				US
+
+68-4B-88   (hex)		Galtronics Telemetry Inc.
+684B88     (base 16)		Galtronics Telemetry Inc.
+				31 Lupi Ct
+				Palm Coast  Florida  32137
+				US
+
+98-FC-11   (hex)		Cisco-Linksys, LLC
+98FC11     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+34-E0-D7   (hex)		DONGGUAN QISHENG ELECTRONICS INDUSTRIAL CO., LTD
+34E0D7     (base 16)		DONGGUAN QISHENG ELECTRONICS INDUSTRIAL CO., LTD
+				XINJI INDUSTRIAL ZONE, MACHONG TOWN
+				DONGGUAN  GUANGDONG  523123
+				CN
+
+D8-46-06   (hex)		Silicon Valley Global Marketing
+D84606     (base 16)		Silicon Valley Global Marketing
+				830 Stewart Dr. #201
+				Sunnyvale  Ca  94085
+				US
+
+F8-AC-6D   (hex)		Deltenna Ltd
+F8AC6D     (base 16)		Deltenna Ltd
+				First Floor Unit 2
+				Chippenham  Wiltshire  SN15 1BN
+				GB
+
+F4-50-EB   (hex)		Telechips Inc
+F450EB     (base 16)		Telechips Inc
+				KORAD Bldg,1000-12, Daechi-Dong, Gangnam-Gu,
+				Seoul    135-280
+				KR
+
+98-8E-DD   (hex)		TE Connectivity Limerick
+988EDD     (base 16)		TE Connectivity Limerick
+				International Science Centre, Block 1
+				Castletroy  Co. Limerick  
+				IE
+
+A4-AE-9A   (hex)		Maestro Wireless Solutions ltd.
+A4AE9A     (base 16)		Maestro Wireless Solutions ltd.
+				3603-9, 36/F
+				Sai Ying Pun    
+				HK
+
+C8-48-F5   (hex)		MEDISON Xray Co., Ltd
+C848F5     (base 16)		MEDISON Xray Co., Ltd
+				3F Burim B/D 999 Daechi-dong 
+				Seoul    135-280
+				KR
+
+78-A7-14   (hex)		Amphenol
+78A714     (base 16)		Amphenol
+				20 Valley St.
+				Endicott  New York  13760
+				US
+
+F8-93-F3   (hex)		VOLANS
+F893F3     (base 16)		VOLANS
+				3F IJU BD 770-13 YEOKSAM-DONG
+				SEOUL    135-928
+				KR
+
+78-66-AE   (hex)		ZTEC Instruments, Inc.
+7866AE     (base 16)		ZTEC Instruments, Inc.
+				7715 Tiburon St. NE
+				Albuquerque  NM  87109
+				US
+
+4C-02-2E   (hex)		CMR KOREA CO., LTD
+4C022E     (base 16)		CMR KOREA CO., LTD
+				6F, J-Tower, 24-5 Bangi-dong, Songpa-Gu
+				Seoul    138-050
+				KR
+
+34-AA-EE   (hex)		Mikrovisatos Servisas UAB
+34AAEE     (base 16)		Mikrovisatos Servisas UAB
+				Savanoriu pr. 125
+				Kaunas    LT44146
+				LT
+
+44-D6-3D   (hex)		Talari Networks
+44D63D     (base 16)		Talari Networks
+				3200 Glen Royal Rd.
+				Raleigh   NC  27617
+				US
+
+78-A2-A0   (hex)		Nintendo Co., Ltd.
+78A2A0     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+48-FC-B8   (hex)		Woodstream Corporation
+48FCB8     (base 16)		Woodstream Corporation
+				69 N. Locust Street
+				Lititz  PA  17543
+				US
+
+D4-00-0D   (hex)		Phoenix Broadband Technologies, LLC.
+D4000D     (base 16)		Phoenix Broadband Technologies, LLC.
+				589 Bethlehem Pike
+				Montgomeryville  PA  18936
+				US
+
+AC-51-35   (hex)		MPI TECH
+AC5135     (base 16)		MPI TECH
+				Vadstrupvej 35
+				Bagsværd    DK-2880
+				DK
+
+74-B9-EB   (hex)		JinQianMao Technology Co.,Ltd.
+74B9EB     (base 16)		JinQianMao Technology Co.,Ltd.
+				Room 506 YongHeng Building NO.58 JiangBing Raod
+				FuZhou  FuJian  350005
+				CN
+
+D4-52-97   (hex)		nSTREAMS Technologies, Inc.
+D45297     (base 16)		nSTREAMS Technologies, Inc.
+				10F-2, No. 302, Ruiguang Rd., Neihu District,
+				Taipei City    114
+				TW
+
+18-80-CE   (hex)		Barberry Solutions Ltd
+1880CE     (base 16)		Barberry Solutions Ltd
+				2/13 Naviti Place
+				Auckland    0630
+				NZ
+
+24-B6-B8   (hex)		FRIEM SPA
+24B6B8     (base 16)		FRIEM SPA
+				Via Edison 1
+				Segrate  Milano  20090
+				IT
+
+A4-56-1B   (hex)		MCOT Corporation
+A4561B     (base 16)		MCOT Corporation
+				Yogohigashi 1-5-12
+				Matsuyama city  Ehime prefecture  790-0044
+				JP
+
+80-C6-3F   (hex)		Remec Broadband Wireless , LLC
+80C63F     (base 16)		Remec Broadband Wireless , LLC
+				17034 Camino San Bernardo
+				San Diego  CA  92127
+				US
+
+40-D4-0E   (hex)		Biodata Ltd
+40D40E     (base 16)		Biodata Ltd
+				10 Stocks Street
+				Manchester    M8 8QG
+				GB
+
+0C-82-6A   (hex)		Wuhan Huagong Genuine Optics Technology Co., Ltd
+0C826A     (base 16)		Wuhan Huagong Genuine Optics Technology Co., Ltd
+				Science & Technology Region of HUST, Donghu High-Tech Zone 
+				Wuhan  Hubei  430223
+				CN
+
+E0-27-1A   (hex)		TTC Next-generation Home Network System WG
+E0271A     (base 16)		TTC Next-generation Home Network System WG
+				1-1-12 Shiba Kouen
+				Minato-ku  Tokyo  105-0011
+				JP
+
+00-97-FF   (hex)		Heimann Sensor GmbH
+0097FF     (base 16)		Heimann Sensor GmbH
+				Maria-Reiche-Str. 1
+				Dresden  Sachsen  01109
+				DE
+
+E4-AB-46   (hex)		UAB Selteka
+E4AB46     (base 16)		UAB Selteka
+				Draugystës g. 19
+				Kaunas    LT-51230 
+				LT
+
+94-5B-7E   (hex)		TRILOBIT LTDA.
+945B7E     (base 16)		TRILOBIT LTDA.
+				R. ALVARENGA 1377
+				São Paulo    05509002
+				BR
+
+04-E5-48   (hex)		Cohda Wireless Pty Ltd
+04E548     (base 16)		Cohda Wireless Pty Ltd
+				Suite 5 / 83 Fullarton Road
+				Kent Town  South Australia  5067
+				AU
+
+70-71-BC   (hex)		PEGATRON CORPORATION
+7071BC     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+78-84-EE   (hex)		INDRA ESPACIO S.A.
+7884EE     (base 16)		INDRA ESPACIO S.A.
+				C/ ROC BORONAT, 133
+				BARCELONA    08018
+				ES
+
+7C-05-1E   (hex)		RAFAEL LTD.
+7C051E     (base 16)		RAFAEL LTD.
+				GUSH SEGEV POB 2250
+				HAIFA    31008
+				IL
+
+10-09-0C   (hex)		Janome Sewing Machine Co., Ltd.
+10090C     (base 16)		Janome Sewing Machine Co., Ltd.
+				1463 Hazama-Machi
+				Hachioji-Shi  Tokyo  193-0941
+				JP
+
+E0-1C-EE   (hex)		Bravo Tech, Inc.
+E01CEE     (base 16)		Bravo Tech, Inc.
+				6185 Phyllis Dr. Unit D.
+				Cypress  CA  90630
+				US
+
+28-93-FE   (hex)		Cisco Systems, Inc
+2893FE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F4-C7-95   (hex)		WEY Elektronik AG
+F4C795     (base 16)		WEY Elektronik AG
+				Dorfstrasse 57
+				Unterengstringen  Zurich  8103
+				CH
+
+78-11-85   (hex)		NBS Payment Solutions Inc.
+781185     (base 16)		NBS Payment Solutions Inc.
+				703 Evans Ave
+				Toronto  Ontario  M9C 5E9
+				CA
+
+D0-58-75   (hex)		Active Control Technology Inc.
+D05875     (base 16)		Active Control Technology Inc.
+				1800 Appleby Line
+				Burlington  Ontario  L7L 6A1
+				CA
+
+C8-EF-2E   (hex)		Beijing Gefei Tech. Co., Ltd 
+C8EF2E     (base 16)		Beijing Gefei Tech. Co., Ltd 
+				A-603 Power Creative Plaza, NO.1 Shangdi E. Rd.,Haidian District, 
+				Beijing    100085
+				CN
+
+08-F6-F8   (hex)		GET Engineering
+08F6F8     (base 16)		GET Engineering
+				9350 Bond Ave
+				El Cajon  CA  92021
+				US
+
+3C-4C-69   (hex)		Infinity System S.L.
+3C4C69     (base 16)		Infinity System S.L.
+				Crtra. N-II, Km 48,5 Pol. Ind. Cabanillas del Campo, Parc. 12B
+				Guadalajara    19171
+				US
+
+78-30-E1   (hex)		UltraClenz, LLC
+7830E1     (base 16)		UltraClenz, LLC
+				1440 W Indiantown Road
+				Jupiter  FL  33458
+				US
+
+B0-91-34   (hex)		Taleo
+B09134     (base 16)		Taleo
+				4140 Dublin Blvd
+				Dublin  California  94568
+				US
+
+A4-C2-AB   (hex)		Hangzhou LEAD-IT Information & Technology Co.,Ltd
+A4C2AB     (base 16)		Hangzhou LEAD-IT Information & Technology Co.,Ltd
+				F2 Builder B,Xidomen Road NO.22
+				Hangzhou  Zhejiang  310012
+				CN
+
+48-AA-5D   (hex)		Store Electronic Systems
+48AA5D     (base 16)		Store Electronic Systems
+				39 rue de montigny
+				Argenteuil    95100
+				FR
+
+04-2F-56   (hex)		ATOCS (Shenzhen) LTD
+042F56     (base 16)		ATOCS (Shenzhen) LTD
+				4/F., Building 10, Tongfuyu Industry Zone, Xili Town,
+				Shenzhen    
+				CN
+
+E8-5E-53   (hex)		Infratec Datentechnik GmbH
+E85E53     (base 16)		Infratec Datentechnik GmbH
+				Gevener Weg 38
+				Neuenrade  NRW  58579
+				DE
+
+88-BA-7F   (hex)		Qfiednet Co., Ltd.
+88BA7F     (base 16)		Qfiednet Co., Ltd.
+				#204 KJ Bldg. DaeChi-Dong
+				Seoul    135-847
+				KR
+
+64-DB-18   (hex)		OpenPattern
+64DB18     (base 16)		OpenPattern
+				109/111 rue des Côtes
+				Maisons Laffitte  Yvelines  78600
+				FR
+
+90-A2-DA   (hex)		GHEO SA
+90A2DA     (base 16)		GHEO SA
+				Via Soldini, 22
+				Chiasso    CH-6830
+				CH
+
+98-89-ED   (hex)		Anadem Information Inc.
+9889ED     (base 16)		Anadem Information Inc.
+				2nd F, 79 Zhouzi Street, Neihu District, 
+				Taipei    114
+				TW
+
+D8-1B-FE   (hex)		TWINLINX CORPORATION
+D81BFE     (base 16)		TWINLINX CORPORATION
+				ESPACE DESCARTES BAT B
+				AIX EN PROVENCE  PROVENCE  13857
+				FR
+
+FC-44-63   (hex)		Universal Audio, Inc
+FC4463     (base 16)		Universal Audio, Inc
+				4585 Scotts Valley Dr.
+				Scotts Valley  CA  95066
+				US
+
+10-2D-96   (hex)		Looxcie Inc.
+102D96     (base 16)		Looxcie Inc.
+				1196 Borregas Ave.
+				Sunnyvale  CA  94089
+				US
+
+5C-35-DA   (hex)		There Corporation Oy
+5C35DA     (base 16)		There Corporation Oy
+				Elimäenkatu 5
+				Helsinki    00510
+				FI
+
+A0-69-86   (hex)		Wellav Technologies Ltd
+A06986     (base 16)		Wellav Technologies Ltd
+				15F Desay Building
+				Huizhou  Guangdong  516003
+				CN
+
+EC-8E-AD   (hex)		DLX
+EC8EAD     (base 16)		DLX
+				#401, Seoil B/D,1359-45 Seocho2-dong
+				Seoul    137-863
+				KR
+
+34-C6-9A   (hex)		Enecsys Ltd
+34C69A     (base 16)		Enecsys Ltd
+				Harston Mill
+				Cambridge  Cambridgeshire  CB22 7GG
+				GB
+
+D8-AE-90   (hex)		Itibia Technologies
+D8AE90     (base 16)		Itibia Technologies
+				5 Clausen Ct
+				West Windsor  NJ  08550
+				US
+
+B8-65-3B   (hex)		Bolymin, Inc.
+B8653B     (base 16)		Bolymin, Inc.
+				13F-1, No.20, Ta-Long Rd., 
+				Taichung    40310
+				TW
+
+38-E8-DF   (hex)		b gmbh medien + datenbanken
+38E8DF     (base 16)		b gmbh medien + datenbanken
+				Kurfuerstenstrasse 22
+				Ludwigsburg  BW  71636
+				DE
+
+1C-12-9D   (hex)		IEEE PES PSRC/SUB     
+1C129D     (base 16)		IEEE PES PSRC/SUB     
+				 Working Group H7/Sub C7 (IEEE PC37.238)
+				Piscataway  NJ  08854
+				US
+
+E0-CA-4D   (hex)		Shenzhen Unistar Communication Co.,LTD
+E0CA4D     (base 16)		Shenzhen Unistar Communication Co.,LTD
+				9/F,Qinghai Building,7043, Berhuan Road, Futian District, 
+				Shenzhen  Guangdong  518034
+				CN
+
+0C-C9-C6   (hex)		Samwin Hong Kong Limited
+0CC9C6     (base 16)		Samwin Hong Kong Limited
+				Rm 901-902, 9/F, Futura Plaza,
+				Hong Kong    
+				CN
+
+10-62-C9   (hex)		Adatis GmbH & Co. KG
+1062C9     (base 16)		Adatis GmbH & Co. KG
+				Forchheimer Straße 6
+				Nürnberg  Bavaria  90425
+				DE
+
+60-B3-C4   (hex)		Elber Srl
+60B3C4     (base 16)		Elber Srl
+				via Pontevecchio 42 W
+				Carasco  Ge  16042
+				IT
+
+04-C8-80   (hex)		Samtec Inc
+04C880     (base 16)		Samtec Inc
+				520 Park East Blvd
+				New Albany  IN  47150
+				US
+
+F8-8D-EF   (hex)		Tenebraex
+F88DEF     (base 16)		Tenebraex
+				27 Drydock Avenue
+				Boston  MA  02210
+				US
+
+04-22-34   (hex)		Wireless Standard Extensions
+042234     (base 16)		Wireless Standard Extensions
+				1322 Crossman avenue
+				Sunnyvale  California  94089
+				US
+
+F0-B6-EB   (hex)		Poslab Technology Co., Ltd.
+F0B6EB     (base 16)		Poslab Technology Co., Ltd.
+				5F-1, No.490 Bannan Rd.
+				Jhonghe City    235
+				TW
+
+80-C8-62   (hex)		Openpeak, Inc
+80C862     (base 16)		Openpeak, Inc
+				1750 Clint Moore Rd
+				Boca Raton  Florida  33487
+				US
+
+1C-8F-8A   (hex)		Phase Motion Control SpA
+1C8F8A     (base 16)		Phase Motion Control SpA
+				via Adamoli, 461
+				Genova    IT16141
+				IT
+
+FC-CC-E4   (hex)		Ascon Ltd.
+FCCCE4     (base 16)		Ascon Ltd.
+				1-15-27 Minato-machi
+				Fukuyama –shi  Hiroshima-ken  721-0964
+				JP
+
+58-50-E6   (hex)		Best Buy Corporation
+5850E6     (base 16)		Best Buy Corporation
+				7601 Penn Ave South
+				Richfield  MN  55423
+				US
+
+3C-1C-BE   (hex)		JADAK LLC
+3C1CBE     (base 16)		JADAK LLC
+				7279 William Barry Blvd
+				North Syracuse  NY  13212
+				US
+
+BC-D5-B6   (hex)		d2d technologies
+BCD5B6     (base 16)		d2d technologies
+				10611 roundwood glen ct
+				Jacksonville  Fl  32256
+				US
+
+FC-68-3E   (hex)		Directed Perception, Inc
+FC683E     (base 16)		Directed Perception, Inc
+				890C Cowan Road
+				Burlingame  California  94010
+				US
+
+28-E7-94   (hex)		Microtime Computer Inc.
+28E794     (base 16)		Microtime Computer Inc.
+				4F, No. 222, Sec. 4, Cheng-Teh Rd., 
+				Taipei    11167
+				TW
+
+0C-D5-02   (hex)		Westell Technologies Inc.
+0CD502     (base 16)		Westell Technologies Inc.
+				750 N Commons Dr
+				Aurora  IL  60504
+				US
+
+70-82-8E   (hex)		OleumTech Corporation
+70828E     (base 16)		OleumTech Corporation
+				23 Hubble
+				Irvine  CA  92618
+				US
+
+A4-38-FC   (hex)		Plastic Logic
+A438FC     (base 16)		Plastic Logic
+				650 Castro St., Suite 500
+				Mountain View  CA  94041
+				US
+
+18-FC-9F   (hex)		Changhe Electronics Co., Ltd.
+18FC9F     (base 16)		Changhe Electronics Co., Ltd.
+				6th Floor, Building B, Dajiahao Square, Yu¡¯an 1st Road, Bao¡¯an, 
+				Shenzhen  Guangdong  518101
+				CN
+
+94-59-2D   (hex)		EKE Building Technology Systems Ltd
+94592D     (base 16)		EKE Building Technology Systems Ltd
+				Piispanportti 7
+				Espoo  -  02240
+				US
+
+CC-69-B0   (hex)		Global Traffic Technologies, LLC
+CC69B0     (base 16)		Global Traffic Technologies, LLC
+				7800 Third Street North
+				St. Paul  Minnesota  55128
+				US
+
+A0-59-3A   (hex)		V.D.S. Video Display Systems srl
+A0593A     (base 16)		V.D.S. Video Display Systems srl
+				Via Del Pantano 71
+				SCANDICCI  FI  50018
+				IT
+
+CC-EA-1C   (hex)		DCONWORKS  Co., Ltd
+CCEA1C     (base 16)		DCONWORKS  Co., Ltd
+				182-13 Daerung Post Tower 2nd 5F
+				Seoul    152-847
+				KR
+
+7C-08-D9   (hex)		Shanghai B-Star Technology Co
+7C08D9     (base 16)		Shanghai B-Star Technology Co
+				1158 Xiehe Road
+				Shanghai    200335
+				CN
+
+20-59-A0   (hex)		Paragon Technologies Inc.
+2059A0     (base 16)		Paragon Technologies Inc.
+				68 North 4th Ring Rd West,
+				Beijing    100080
+				CN
+
+38-E9-8C   (hex)		Reco S.p.A.
+38E98C     (base 16)		Reco S.p.A.
+				via dell'Industria, 8
+				Montano Lucino  CO  22070
+				IT
+
+A0-BF-A5   (hex)		CORESYS
+A0BFA5     (base 16)		CORESYS
+				267-1 Nonhyundong Gangnamgu
+				Seoul    135-833
+				KR
+
+B0-5B-1F   (hex)		THERMO FISHER SCIENTIFIC S.P.A.
+B05B1F     (base 16)		THERMO FISHER SCIENTIFIC S.P.A.
+				STRADA RIVOLTANA KM 6/7
+				RODANO  MILAN  20090
+				IT
+
+24-D2-CC   (hex)		SmartDrive Systems Inc.
+24D2CC     (base 16)		SmartDrive Systems Inc.
+				9276 Scranton Road
+				San Diego  CA  92121
+				US
+
+0C-EF-7C   (hex)		AnaCom Inc
+0CEF7C     (base 16)		AnaCom Inc
+				1996 Lundy Ave
+				San Jose  CA  95131
+				US
+
+EC-E9-F8   (hex)		Guang Zhou TRI-SUN Electronics Technology  Co., Ltd
+ECE9F8     (base 16)		Guang Zhou TRI-SUN Electronics Technology  Co., Ltd
+				9th floor Guangzhou info port building B, Keyun Road, Tianhe District, Guangzhou ,PRC
+				Guangzhou  Guangdong  510665
+				CN
+
+34-CE-94   (hex)		Parsec (Pty) Ltd
+34CE94     (base 16)		Parsec (Pty) Ltd
+				Building 8-10 Manhattan Office Park
+				Centurion  Gauteng  0157
+				ZA
+
+34-EF-8B   (hex)		NTT Communications Corporation
+34EF8B     (base 16)		NTT Communications Corporation
+				NTT Hibiya Bldg. 7F
+				Chiyoda-ku  Tokyo  100-8019
+				JP
+
+68-7F-74   (hex)		Cisco-Linksys, LLC
+687F74     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+D0-D2-86   (hex)		Beckman Coulter K.K.
+D0D286     (base 16)		Beckman Coulter K.K.
+				454-32 Higashino,
+				Nagaizumi-cho, Sunto-gun,  Shizuoka-ken  411-0943
+				JP
+
+C4-19-8B   (hex)		Dominion Voting Systems Corporation
+C4198B     (base 16)		Dominion Voting Systems Corporation
+				215 Spadina Avenue
+				Toronto  Ontario  M5T 2C7
+				CA
+
+C8-3A-35   (hex)		Tenda Technology Co., Ltd.
+C83A35     (base 16)		Tenda Technology Co., Ltd.
+				Room 601-602,R/D Building Complex,Tsinghua High-Tech Park,nanshan district
+				Shenzhen  Guandong  518057
+				CN
+
+6C-8C-DB   (hex)		Otus Technologies Ltd
+6C8CDB     (base 16)		Otus Technologies Ltd
+				26 Braid Road
+				Edinburgh  Morningside  EH10 6AD
+				GB
+
+40-F5-2E   (hex)		Leica Microsystems (Schweiz) AG
+40F52E     (base 16)		Leica Microsystems (Schweiz) AG
+				Max Schmidheiny-Strasse 201
+				Heerbrugg  SG  9435
+				CH
+
+E4-FF-DD   (hex)		ELECTRON INDIA
+E4FFDD     (base 16)		ELECTRON INDIA
+				TYPE II, NO.9, DR. V.S.I. ESTATE
+				CHENNAI  TAMIL NADU  600 041
+				IN
+
+68-A1-B7   (hex)		Honghao Mingchuan Technology (Beijing) CO.,Ltd.
+68A1B7     (base 16)		Honghao Mingchuan Technology (Beijing) CO.,Ltd.
+				Floor 8,Tower A, Wanliu Yicheng Building
+				Beijing    100089
+				CN
+
+0C-D7-C2   (hex)		Axium Technologies, Inc.
+0CD7C2     (base 16)		Axium Technologies, Inc.
+				6625 N. Calle Eva Miranda
+				Irwindale  CA  91702
+				US
+
+E8-4E-CE   (hex)		Nintendo Co., Ltd.
+E84ECE     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+10-45-F8   (hex)		LNT-Automation GmbH
+1045F8     (base 16)		LNT-Automation GmbH
+				Hans-Paul-Kaysser-Straße 1
+				Leutenbach-Nellmersbach  BW  D-71397
+				DE
+
+DC-E7-1C   (hex)		AUG Elektronik GmbH
+DCE71C     (base 16)		AUG Elektronik GmbH
+				Kleinwoellmiss 53
+				St. Martin a. W.  Styria  A-8580
+				AT
+
+A8-70-A5   (hex)		UniComm Inc.
+A870A5     (base 16)		UniComm Inc.
+				7F-7, No. 716, Chung-Cheng Road,
+				Chung-Ho City  Taipei Hsien  23500
+				TW
+
+F8-47-2D   (hex)		X2gen Digital Corp. Ltd
+F8472D     (base 16)		X2gen Digital Corp. Ltd
+				# 89, Singlong Rd 
+				Pin-Jhen City,     324
+				TW
+
+84-90-00   (hex)		Arnold & Richter Cine Technik
+849000     (base 16)		Arnold & Richter Cine Technik
+				Tuerkenstrasse 89
+				Munich  Bavaria  80799
+				DE
+
+08-18-4C   (hex)		A. S. Thomas, Inc.
+08184C     (base 16)		A. S. Thomas, Inc.
+				355 Providence Hwy
+				Westwood  MA  02090
+				US
+
+10-88-0F   (hex)		Daruma Telecomunicações e Informática S.A.
+10880F     (base 16)		Daruma Telecomunicações e Informática S.A.
+				AVENIDA INDEPENDENCIA, 3500, LOTEAMENTO INDUSTRIAL
+				Taubaté  São Paulo  12032-000
+				BR
+
+FC-61-98   (hex)		NEC Personal Products, Ltd
+FC6198     (base 16)		NEC Personal Products, Ltd
+				6-80, Shimohanazawa 2-chome,
+				Yonezawa-shi  Yamagata  992-8520
+				JP
+
+74-D8-50   (hex)		Evrisko Systems
+74D850     (base 16)		Evrisko Systems
+				2322 Alpine Rd, Ste 10
+				Eau Claire  WI  54703
+				US
+
+54-B6-20   (hex)		SUHDOL E&C Co.Ltd.
+54B620     (base 16)		SUHDOL E&C Co.Ltd.
+				920, Ilsan TechnoTown 1141-1, Baekseok-dong, Ilsandong-gu
+				Goyang-si  Gyunggi-do  410-722
+				KR
+
+78-C4-0E   (hex)		H&D Wireless
+78C40E     (base 16)		H&D Wireless
+				Sjövägen 17
+				Solna    169 55
+				SE
+
+2C-06-23   (hex)		Win Leader Inc.
+2C0623     (base 16)		Win Leader Inc.
+				Level 3 ,Alexander House,
+				Ebene    
+				MU
+
+0C-27-55   (hex)		Valuable Techologies Limited
+0C2755     (base 16)		Valuable Techologies Limited
+				602, Centre Point, J.B.Nagar,
+				Mumbai  Maharashtra  400059
+				IN
+
+78-99-8F   (hex)		MEDILINE ITALIA SRL
+78998F     (base 16)		MEDILINE ITALIA SRL
+				VIA 8 MARZO, 4
+				CORTE TEGGE  REGGIO NELL'EMILIA  42025
+				IT
+
+40-EC-F8   (hex)		Siemens AG
+40ECF8     (base 16)		Siemens AG
+				I IS MS EDM
+				Munich  Germany  85630
+				DE
+
+BC-B1-81   (hex)		SHARP CORPORATION
+BCB181     (base 16)		SHARP CORPORATION
+				22-22,Nagaike-cho,
+				Osaka,    545-8522,
+				JP
+
+C8-87-3B   (hex)		Net Optics
+C8873B     (base 16)		Net Optics
+				5303 Betsy Ross Drive
+				Santa Clara  CA  95054
+				US
+
+A8-CE-90   (hex)		CVC
+A8CE90     (base 16)		CVC
+				No.361,Renhua Rd.,
+				Dali City  Taichung  412
+				TW
+
+E4-1F-13   (hex)		IBM Corp
+E41F13     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+70-1A-ED   (hex)		ADVAS CO., LTD.
+701AED     (base 16)		ADVAS CO., LTD.
+				3-8-8 Shin-yokohama, Kohoku-ku
+				Yokohama-shi  Kanagawa-ken  222-0033
+				JP
+
+64-65-C0   (hex)		Nuvon, Inc
+6465C0     (base 16)		Nuvon, Inc
+				3130 Alpine Road
+				Portola Valley  California  94028
+				US
+
+7C-1E-B3   (hex)		2N TELEKOMUNIKACE a.s.
+7C1EB3     (base 16)		2N TELEKOMUNIKACE a.s.
+				Modranska 621
+				Prague    143 01
+				CZ
+
+44-56-B7   (hex)		Spawn Labs, Inc
+4456B7     (base 16)		Spawn Labs, Inc
+				2209 Granger Lane
+				Austin  TX  78613
+				US
+
+44-C9-A2   (hex)		Greenwald Industries
+44C9A2     (base 16)		Greenwald Industries
+				212 Middlesex Avenue
+				Chester  CT  06412
+				US
+
+90-6D-C8   (hex)		DLG Automação Industrial Ltda
+906DC8     (base 16)		DLG Automação Industrial Ltda
+				Rua José Batista Soares, 53
+				Sertãozinho  São Paulo  14176-119
+				BR
+
+58-4C-EE   (hex)		Digital One Technologies, Limited
+584CEE     (base 16)		Digital One Technologies, Limited
+				Room 2203, No.1 Shangdi Xinxi Road
+				Beijing    100085
+				CN
+
+00-27-21   (hex)		Shenzhen Baoan Fenda Industrial Co., Ltd
+002721     (base 16)		Shenzhen Baoan Fenda Industrial Co., Ltd
+				Fenda Hi-Tech Park
+				Baoan   Shenzhen  518108
+				CN
+
+A0-73-32   (hex)		Cashmaster International Limited
+A07332     (base 16)		Cashmaster International Limited
+				Fairykirk Road
+				Rosyth  Fife  KY11 2QQ
+				GB
+
+64-C6-AF   (hex)		AXERRA Networks Ltd
+64C6AF     (base 16)		AXERRA Networks Ltd
+				24  Raoul Wallenberg St. , 
+				Tel-Aviv    ISRAEL  69719
+				IL
+
+44-56-8D   (hex)		PNC Technologies  Co., Ltd.
+44568D     (base 16)		PNC Technologies  Co., Ltd.
+				Development Center
+				Anyang  Gyeonggi-Do  431-836
+				KR
+
+40-61-86   (hex)		MICRO-STAR INT'L CO.,LTD
+406186     (base 16)		MICRO-STAR INT'L CO.,LTD
+				No.69,Li-De St
+				Jung-Ho City  Taipei Hsien  235
+				TW
+
+00-26-F5   (hex)		XRPLUS Inc.
+0026F5     (base 16)		XRPLUS Inc.
+				#805 Ace Techno Tower 2nd 197-17
+				Seoul    152-766
+				KR
+
+00-26-F8   (hex)		Golden Highway Industry Development Co., Ltd.
+0026F8     (base 16)		Golden Highway Industry Development Co., Ltd.
+				Floor 7, Block 8, Vision Shenzhen Business Park, No.9 Gaoxin 9th South Road
+				Shenzhen City  Guangdong Province  518057
+				CN
+
+00-26-F4   (hex)		Nesslab
+0026F4     (base 16)		Nesslab
+				489-2 Maetan 3-dong, Yeong Tong-gu
+				Suwon-si  Gyeonggi-do  443-803
+				KR
+
+00-26-EE   (hex)		TKM GmbH
+0026EE     (base 16)		TKM GmbH
+				Schlossstraße 123
+				Mönchengladbach  NRW  41238
+				DE
+
+00-26-EF   (hex)		Technology Advancement Group, Inc.
+0026EF     (base 16)		Technology Advancement Group, Inc.
+				22355 Tag Way
+				Dulles  VA  20166-9310
+				US
+
+00-26-B2   (hex)		Setrix GmbH
+0026B2     (base 16)		Setrix GmbH
+				Josephspitalstr. 15
+				Muenchen  Bayern  80331
+				DE
+
+00-26-AF   (hex)		Duelco A/S
+0026AF     (base 16)		Duelco A/S
+				Mommarkvej 5
+				Soenderborg  Soenderjylland  DK6400
+				DK
+
+00-26-B3   (hex)		Thales Communications Inc
+0026B3     (base 16)		Thales Communications Inc
+				22605 Gateway Center Drive
+				Clarksburg  MD  20871
+				US
+
+00-26-A7   (hex)		CONNECT SRL
+0026A7     (base 16)		CONNECT SRL
+				Via Cernaia, 11
+				Milan    20121
+				IT
+
+00-26-A4   (hex)		Novus Produtos Eletronicos Ltda
+0026A4     (base 16)		Novus Produtos Eletronicos Ltda
+				Rua Alvaro Chaves, 155
+				Porto Alegre  RS  90220-040
+				BR
+
+00-26-D8   (hex)		Magic Point Inc.
+0026D8     (base 16)		Magic Point Inc.
+				Suite 203, Building 17, No. 295 Lin Nan Road, Pudong Software Park Sanlin World Expo Block
+				Shanghai    2000126
+				CN
+
+00-26-D6   (hex)		Ningbo Andy Optoelectronic Co., Ltd.
+0026D6     (base 16)		Ningbo Andy Optoelectronic Co., Ltd.
+				Lanjiang Street Industrial Zone
+				Yuyao  Zhejiang  315400
+				CN
+
+00-27-0F   (hex)		Envisionnovation Inc
+00270F     (base 16)		Envisionnovation Inc
+				4 Wareham Drive
+				Mississauga  Ontario  L5M 1B6
+				CA
+
+00-27-0A   (hex)		IEE S.A.
+00270A     (base 16)		IEE S.A.
+				ZAE Weiergewan
+				Contern    L-5326
+				LU
+
+00-27-09   (hex)		Nintendo Co., Ltd.
+002709     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-26-D3   (hex)		Zeno Information System
+0026D3     (base 16)		Zeno Information System
+				#1404 A-Dong Digital Empire Bldg, 980-3, Youngtong-dong, Youngtong-gu
+				Suwon City  Gyeonggi-Do  443-702
+				KR
+
+00-26-D1   (hex)		S Squared Innovations Inc.
+0026D1     (base 16)		S Squared Innovations Inc.
+				6807-104 Street
+				Edmonton  AB  T6H 2L5
+				CA
+
+00-26-CB   (hex)		Cisco Systems, Inc
+0026CB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-27-01   (hex)		INCOstartec GmbH
+002701     (base 16)		INCOstartec GmbH
+				Rheinstraße 17
+				Teltow  Germany  14513
+				DE
+
+00-26-FB   (hex)		AirDio Wireless, Inc.
+0026FB     (base 16)		AirDio Wireless, Inc.
+				13-5, No. 79, Sec. 1, Hsin Tai Wu Road
+				Hsichih City, Taipei County  Taiwan  22101
+				TW
+
+00-27-1A   (hex)		Geenovo Technology Ltd.
+00271A     (base 16)		Geenovo Technology Ltd.
+				Unit 402, 4/F., Tower I,SHUI QING MU HUA YUAN,
+				Beijing    100080
+				CN
+
+00-27-14   (hex)		Grainmustards, Co,ltd.
+002714     (base 16)		Grainmustards, Co,ltd.
+				HEIWA MK Bldg,2-48-4,Nihonbashi-Hama-cho
+				Tokyo    103-0007
+				JP
+
+00-27-15   (hex)		Rebound Telecom. Co., Ltd
+002715     (base 16)		Rebound Telecom. Co., Ltd
+				12F,Building No.82,No.1198,North Qinzhou Rd,
+				Shanghai    200233
+				CN
+
+00-26-E6   (hex)		Visionhitech Co., Ltd.
+0026E6     (base 16)		Visionhitech Co., Ltd.
+				Vision bldg. 150-3
+				Buchon  Kyunggi-Do  420-822
+				KR
+
+00-26-DF   (hex)		TaiDoc Technology Corp.
+0026DF     (base 16)		TaiDoc Technology Corp.
+				7F, No. 127, Wugong 2nd Rd., 24888 Wugu Township
+				Taipei County  Taiwan  24888
+				TW
+
+00-26-6A   (hex)		ESSENSIUM NV
+00266A     (base 16)		ESSENSIUM NV
+				Gaston Geenslaan 9
+				LEUVEN  VL BRABANT  3001
+				BE
+
+00-26-6B   (hex)		SHINE UNION ENTERPRISE LIMITED
+00266B     (base 16)		SHINE UNION ENTERPRISE LIMITED
+				UNIT 1211, 12FL., CHEVALIER COMMERCIAL CENTER,
+				KOWLOON    NIL
+				HK
+
+00-26-67   (hex)		CARECOM CO.,LTD.
+002667     (base 16)		CARECOM CO.,LTD.
+				3-35-4
+				Chofu  Tokyo  182-0025
+				JP
+
+00-26-A2   (hex)		Instrumentation Technology Systems
+0026A2     (base 16)		Instrumentation Technology Systems
+				19360 Business Center Drive
+				Northridge  CA  91324
+				US
+
+00-26-9F   (hex)		Private
+00269F     (base 16)		Private
+
+00-26-99   (hex)		Cisco Systems, Inc
+002699     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-47   (hex)		WFE TECHNOLOGY CORP.
+002647     (base 16)		WFE TECHNOLOGY CORP.
+				17F NO.238,Chin-Hua N Rd,
+				Taichung    404
+				TW
+
+00-26-40   (hex)		Baustem Broadband Technologies, Ltd.
+002640     (base 16)		Baustem Broadband Technologies, Ltd.
+				910 Quantum Plaza
+				Beijing    100191
+				CN
+
+00-26-53   (hex)		DaySequerra Corporation
+002653     (base 16)		DaySequerra Corporation
+				154 Cooper Road
+				West Berlin  NJ  08091
+				US
+
+00-26-7B   (hex)		GSI Helmholtzzentrum für Schwerionenforschung GmbH
+00267B     (base 16)		GSI Helmholtzzentrum für Schwerionenforschung GmbH
+				Planckstraße 1
+				Darmstadt  Hessen  64291
+				DE
+
+00-26-87   (hex)		corega K.K
+002687     (base 16)		corega K.K
+				1-19-20, Shinyokohama
+				Yokohama-city  Kanagawa-ken  222-0033
+				JP
+
+00-26-8D   (hex)		CellTel S.p.A.
+00268D     (base 16)		CellTel S.p.A.
+				Via Romano 72
+				Scarmagno  Torino  10010
+				IT
+
+00-26-28   (hex)		companytec automação e controle ltda.
+002628     (base 16)		companytec automação e controle ltda.
+				Rua Marcilio Dias 3005
+				Pelotas  Rio Grande do Sul  96020-480
+				BR
+
+00-26-1F   (hex)		SAE Magnetics (H.K.) Ltd.
+00261F     (base 16)		SAE Magnetics (H.K.) Ltd.
+				SAE Technology Centre
+				Hong Kong Science Park  Shatin, New Territories  
+				HK
+
+00-26-1E   (hex)		QINGBANG ELEC(SZ) CO., LTD
+00261E     (base 16)		QINGBANG ELEC(SZ) CO., LTD
+				No. 2, qimin Rd. North District, High-tech Industrial Park, Nanshan,
+				Shenzhen  Guangdong  518000
+				CN
+
+00-26-19   (hex)		FRC
+002619     (base 16)		FRC
+				1511 South Benjamin Avenue
+				Mason City  IA  50401
+				US
+
+00-25-EA   (hex)		Iphion BV
+0025EA     (base 16)		Iphion BV
+				Willemstraat 106
+				Eindhoven    5616GE
+				NL
+
+00-25-F0   (hex)		Suga Electronics Limited
+0025F0     (base 16)		Suga Electronics Limited
+				Units 1904-1907, Chevalier Commercial Centre,
+				Kowloon Bay  Hong Kong  
+				CN
+
+00-25-E8   (hex)		Idaho Technology
+0025E8     (base 16)		Idaho Technology
+				390 Wakara way
+				Salt Lake city  UT  84108
+				US
+
+00-25-E4   (hex)		OMNI-WiFi, LLC
+0025E4     (base 16)		OMNI-WiFi, LLC
+				70 Sullivan Street
+				Berwick  Maine  03901
+				US
+
+00-25-FC   (hex)		ENDA ENDUSTRIYEL ELEKTRONIK LTD. STI.
+0025FC     (base 16)		ENDA ENDUSTRIYEL ELEKTRONIK LTD. STI.
+				Y. Dudullu Barbaros C. Kutup S. No. 20
+				Istanbul    34775
+				TR
+
+00-25-FA   (hex)		J&M Analytik AG
+0025FA     (base 16)		J&M Analytik AG
+				Willy-Messerschmitt-Strasse 8
+				Essingen  BW  73457
+				DE
+
+00-26-33   (hex)		MIR - Medical International Research
+002633     (base 16)		MIR - Medical International Research
+				Via del Maggiolino 125
+				Rome  RM  00155
+				IT
+
+00-25-D7   (hex)		CEDO
+0025D7     (base 16)		CEDO
+				Videnska 127
+				BRNO    61900
+				CZ
+
+00-25-D8   (hex)		KOREA MAINTENANCE
+0025D8     (base 16)		KOREA MAINTENANCE
+				3F HAELIM BUIDING 103-7, GURO-5DONG
+				SEOUL    152-842
+				KR
+
+00-25-D2   (hex)		InpegVision Co., Ltd
+0025D2     (base 16)		InpegVision Co., Ltd
+				226-3, Bugok-dong, Geumjeong-gu,
+				Busan    609-320
+				KR
+
+00-26-30   (hex)		ACOREL S.A.S
+002630     (base 16)		ACOREL S.A.S
+				3, Rue Paul LANGEVIN
+				SAINT-PERAY    F-07130
+				FR
+
+00-26-2A   (hex)		Proxense, LLC
+00262A     (base 16)		Proxense, LLC
+				689 NW Stonepine Dr
+				Bend  Oregon  97701
+				US
+
+00-25-FE   (hex)		Pilot Electronics Corporation
+0025FE     (base 16)		Pilot Electronics Corporation
+				No. 2, Tzu-Chiang 3rd Road, Chung-Li Industrial Zone,
+				Taoyuan   Hsien  32063
+				TW
+
+00-25-7B   (hex)		STJ  ELECTRONICS  PVT  LTD
+00257B     (base 16)		STJ  ELECTRONICS  PVT  LTD
+				X-24 OKHLA  INDUSTRIAL  AREA
+				NEW  DELHI  DELHI  110 020
+				IN
+
+00-25-7C   (hex)		Huachentel Technology Development Co., Ltd
+00257C     (base 16)		Huachentel Technology Development Co., Ltd
+				747 XinYu Rd. High-Tech Zone
+				Jinan  Shandong Province  250101
+				CN
+
+00-25-75   (hex)		FiberPlex Technologies, LLC
+002575     (base 16)		FiberPlex Technologies, LLC
+				10840-412 Guilford Rd
+				Annapolis Junction  MD  20701
+				US
+
+00-25-70   (hex)		Eastern Communications Company Limited
+002570     (base 16)		Eastern Communications Company Limited
+				No.398 Wensan Road,
+				Hangzhou  Zhejiang  310013
+				CN
+
+00-25-9B   (hex)		Beijing PKUNITY Microsystems Technology Co., Ltd
+00259B     (base 16)		Beijing PKUNITY Microsystems Technology Co., Ltd
+				11th Floor, Resource Plaza, No.151 North Zhongguancun Street
+				Beijing    100080
+				CN
+
+00-25-96   (hex)		GIGAVISION srl
+002596     (base 16)		GIGAVISION srl
+				Via Figini, 16
+				Muggiò  Milano  20053
+				IT
+
+00-25-95   (hex)		Northwest Signal Supply, Inc
+002595     (base 16)		Northwest Signal Supply, Inc
+				12965 SW Herman Rd
+				Tualatin  OR  97062
+				US
+
+00-25-C9   (hex)		SHENZHEN HUAPU DIGITAL CO., LTD
+0025C9     (base 16)		SHENZHEN HUAPU DIGITAL CO., LTD
+				Futian District,Chegongmiao,TianAn Cyberpark
+				ShenZhen  Guangdong Province  518040
+				CN
+
+00-25-8F   (hex)		Trident Microsystems, Inc.
+00258F     (base 16)		Trident Microsystems, Inc.
+				3408 Garrett Drive
+				Santa Clara  CA  95054
+				US
+
+00-25-89   (hex)		Hills Industries Limited
+002589     (base 16)		Hills Industries Limited
+				5 Cambria Road
+				Melbourne  VIC  3173
+				AU
+
+00-25-85   (hex)		KOKUYO S&T Co., Ltd.
+002585     (base 16)		KOKUYO S&T Co., Ltd.
+				1-8-35
+				Minato-ku  Tokyo  108-8710
+				JP
+
+00-25-81   (hex)		x-star networks Inc.
+002581     (base 16)		x-star networks Inc.
+				1F,NO1-2,Chungching S.Rd.Sec 3
+				Taipei    10076
+				TW
+
+00-25-B5   (hex)		Cisco Systems, Inc
+0025B5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-25-BE   (hex)		Tektrap Systems Inc.
+0025BE     (base 16)		Tektrap Systems Inc.
+				15 Buteau St.
+				Gatineau  Quebec  J8Z 1V4
+				CA
+
+00-25-A0   (hex)		Nintendo Co., Ltd.
+0025A0     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-25-4D   (hex)		Singapore Technologies Electronics Limited
+00254D     (base 16)		Singapore Technologies Electronics Limited
+				24 Ang Mo Kio
+				    569061
+				SG
+
+00-25-4C   (hex)		Videon Central, Inc.
+00254C     (base 16)		Videon Central, Inc.
+				2171 Sandy Drive
+				State College  PA  16803
+				US
+
+00-25-43   (hex)		MONEYTECH
+002543     (base 16)		MONEYTECH
+				Rua Guiratinga 931 un. 103
+				São Paulo  SP  04141-001
+				BR
+
+00-25-5B   (hex)		CoachComm, LLC
+00255B     (base 16)		CoachComm, LLC
+				205 Technology Parkway
+				Auburn  AL  36830
+				US
+
+00-25-16   (hex)		Integrated Design Tools, Inc.
+002516     (base 16)		Integrated Design Tools, Inc.
+				1202 E Park Avenue
+				Tallahassee  FL  32301
+				US
+
+00-25-10   (hex)		Pico-Tesla Magnetic Therapies
+002510     (base 16)		Pico-Tesla Magnetic Therapies
+				7852 South Elati
+				Littleton  CO  80120
+				US
+
+00-25-6A   (hex)		inIT - Institut Industrial IT
+00256A     (base 16)		inIT - Institut Industrial IT
+				Liebigstrasse 87
+				Lemgo  Northrhine-Westfalia  32657
+				DE
+
+00-25-62   (hex)		interbro Co. Ltd.
+002562     (base 16)		interbro Co. Ltd.
+				6F Joyang B/D, 113 Samseong-Dong, Gangnam-Gu
+				Seoul    135-090
+				KR
+
+00-25-20   (hex)		SMA Railway Technology GmbH
+002520     (base 16)		SMA Railway Technology GmbH
+				Miramstraße 87
+				Kassel  Hesse  34123
+				DE
+
+00-25-27   (hex)		Bitrode Corp.
+002527     (base 16)		Bitrode Corp.
+				9787 Green Park Industrial Drive
+				St. Louis  MO  63123
+				US
+
+00-25-25   (hex)		CTERA Networks Ltd.
+002525     (base 16)		CTERA Networks Ltd.
+				24 Imber St.
+				Petach-Tikva    495111
+				IL
+
+00-25-51   (hex)		SE-Elektronic GmbH
+002551     (base 16)		SE-Elektronic GmbH
+				Eythstraße 16
+				Göppingen    73037
+				DE
+
+00-25-3A   (hex)		CEVA, Ltd.
+00253A     (base 16)		CEVA, Ltd.
+				2 Maskit Street.
+				Herzelia    46120
+				IL
+
+00-24-A2   (hex)		Hong Kong Middleware Technology Limited
+0024A2     (base 16)		Hong Kong Middleware Technology Limited
+				Room 1315 ,Leighton Centre,77 Leighton Road
+				Causeway Bay    852
+				HK
+
+00-24-B9   (hex)		Wuhan Higheasy Electronic Technology Development Co.Ltd
+0024B9     (base 16)		Wuhan Higheasy Electronic Technology Development Co.Ltd
+				Bldg A2 Optics Valley Software Park,Guanshan 1st Rd,
+				Wuhan  Hubei  430033
+				CN
+
+00-24-BD   (hex)		Hainzl Industriesysteme GmbH
+0024BD     (base 16)		Hainzl Industriesysteme GmbH
+				Industriezeile 56
+				Linz  Upper Austria  4021
+				AT
+
+00-24-B6   (hex)		Seagate Technology
+0024B6     (base 16)		Seagate Technology
+				1280 Disc Drive
+				Shakopee  MN  55379
+				US
+
+00-24-F7   (hex)		Cisco Systems, Inc
+0024F7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-E5   (hex)		Seer Technology, Inc
+0024E5     (base 16)		Seer Technology, Inc
+				2681 Parleys Way
+				Salt Lake City  Utah  84109
+				US
+
+00-24-E2   (hex)		HASEGAWA ELECTRIC CO.,LTD.
+0024E2     (base 16)		HASEGAWA ELECTRIC CO.,LTD.
+				5-6-20 SHIOE
+				AMAGASAKI  HYOGO  661-0976
+				JP
+
+00-24-E0   (hex)		DS Tech, LLC
+0024E0     (base 16)		DS Tech, LLC
+				2210 Hutton Drive
+				Carrollton  TX  75006
+				US
+
+00-24-F3   (hex)		Nintendo Co., Ltd.
+0024F3     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-25-01   (hex)		JSC Supertel
+002501     (base 16)		JSC Supertel
+				38A Petrogradskaya emb.
+				St.Petersburg    197101
+				RU
+
+00-24-C8   (hex)		Broadband Solutions Group
+0024C8     (base 16)		Broadband Solutions Group
+				1101 Marina Village Parkway
+				Alameda  CA  94501
+				US
+
+00-24-C5   (hex)		Meridian Audio Limited
+0024C5     (base 16)		Meridian Audio Limited
+				11 Latham Road
+				Huntingdon  Cambs  PE29 6YE
+				GB
+
+00-24-96   (hex)		Ginzinger electronic systems
+002496     (base 16)		Ginzinger electronic systems
+				Gewerbegebiet Pirath 16
+				Weng  Upper Austria  4952
+				AT
+
+00-24-99   (hex)		Aquila Technologies
+002499     (base 16)		Aquila Technologies
+				8429A Washington Place NE
+				Albuquerque  NM  87113
+				US
+
+00-24-8A   (hex)		Kaga Electronics Co., Ltd.
+00248A     (base 16)		Kaga Electronics Co., Ltd.
+				Hongo 2-2-9
+				  Tokyo  113-8503
+				JP
+
+00-24-35   (hex)		WIDE CORPORATION
+002435     (base 16)		WIDE CORPORATION
+				LEADERS TOWER 7TH FL., GOMAE-DONG, GIHEUNG-GU
+				YONGIN  GYEONGGI  446-901
+				KR
+
+00-24-31   (hex)		Uni-v co.,ltd
+002431     (base 16)		Uni-v co.,ltd
+				5/F,COFCO Property Tower,
+				Shenzhen  Guangdong  518126
+				CN
+
+00-24-32   (hex)		Neostar Technology Co.,LTD
+002432     (base 16)		Neostar Technology Co.,LTD
+				8F., No.102, Sec. 1, Sintai 5th Rd.
+				Sijhih City  Taipei  22161
+				TW
+
+00-24-43   (hex)		Nortel Networks
+002443     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-24-41   (hex)		Wanzl Metallwarenfabrik GmbH
+002441     (base 16)		Wanzl Metallwarenfabrik GmbH
+				Bubesheimer Straße 4
+				Leipheim  Bavaria  89340
+				DE
+
+00-24-3B   (hex)		CSSI (S) Pte Ltd
+00243B     (base 16)		CSSI (S) Pte Ltd
+				70 Bendemeer Road Unit 04-04
+				    339940
+				SG
+
+00-24-51   (hex)		Cisco Systems, Inc
+002451     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-4A   (hex)		Voyant International
+00244A     (base 16)		Voyant International
+				444 Castro St
+				Mountain View  CA  94041
+				US
+
+00-24-47   (hex)		Kaztek Systems
+002447     (base 16)		Kaztek Systems
+				17 Bromfield Road
+				Acton  MA  01720
+				US
+
+00-24-77   (hex)		Tibbo Technology
+002477     (base 16)		Tibbo Technology
+				9F-3, No 31, Lane 169, Kang-Ning St.,
+				Hsi-Chih  Taipei Hsien  221
+				TW
+
+00-24-6E   (hex)		Phihong USA Corp.
+00246E     (base 16)		Phihong USA Corp.
+				47800 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-24-5D   (hex)		Terberg besturingstechniek B.V.
+00245D     (base 16)		Terberg besturingstechniek B.V.
+				Lage Dijk-Noord 3
+				IJsselstein  Utrecht  3401 VA
+				NL
+
+00-24-50   (hex)		Cisco Systems, Inc
+002450     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-58   (hex)		PA Bastion CC
+002458     (base 16)		PA Bastion CC
+				97, liter K, Buddyonnovsky ave.
+				Rostov-on-Don    344011
+				RU
+
+00-24-73   (hex)		3COM EUROPE LTD
+002473     (base 16)		3COM EUROPE LTD
+				Peoplebuilding 2
+				Hemel Hempstead  HERTS.  HP2 4NW
+				GB
+
+00-24-6B   (hex)		Covia, Inc.
+00246B     (base 16)		Covia, Inc.
+				Benex S-3 Bldg., 3-20-8, Shinyokohama,Kohoku-ku,
+				Yokohama-city  Kanagawa-pref.  222-0033
+				JP
+
+00-23-F5   (hex)		WILO SE
+0023F5     (base 16)		WILO SE
+				Nortkirchenstraße 100
+				D - 44263 Dortmund  NRW  44263
+				DE
+
+00-23-FF   (hex)		Beijing HTTC Technology Ltd.
+0023FF     (base 16)		Beijing HTTC Technology Ltd.
+				B-13D-3 Keshi Building,Jia No.28 Xinxi Road,SHANGDI IT Industry Base
+				Beijing    100085
+				CN
+
+00-23-F6   (hex)		Softwell Technology Co., Ltd.
+0023F6     (base 16)		Softwell Technology Co., Ltd.
+				4F, No. 419, Jhonghe Rd., Yonghe City,
+				Taipei County    234
+				TW
+
+00-23-F3   (hex)		Glocom, Inc.
+0023F3     (base 16)		Glocom, Inc.
+				22 Firstfield Road
+				Gaithersburg  Maryland  20878
+				US
+
+00-23-F0   (hex)		Shanghai Jinghan Weighing Apparatus Co. Ltd.
+0023F0     (base 16)		Shanghai Jinghan Weighing Apparatus Co. Ltd.
+				Building 58, No.99 Chunguang Road, Xinzhuang Industrial Zone,Minhang,
+				Shanghai    201108
+				CN
+
+00-24-10   (hex)		NUETEQ Technology,Inc.
+002410     (base 16)		NUETEQ Technology,Inc.
+				11F, No. 112, Sec. 1, Zhong-Xiao E Rd.
+				Taipei    100
+				TW
+
+00-24-08   (hex)		Pacific Biosciences
+002408     (base 16)		Pacific Biosciences
+				1505 Adams Drive
+				Menlo Park  CA  94025
+				US
+
+00-24-30   (hex)		Ruby Tech Corp.
+002430     (base 16)		Ruby Tech Corp.
+				3F, NO. 1, Lane 50, Nan Kang Road, Sec. 3,
+				Taipei    11510
+				TW
+
+00-24-2E   (hex)		Datastrip Inc.
+00242E     (base 16)		Datastrip Inc.
+				1 Waterview Drive
+				Shelton  CT  06484
+				US
+
+00-24-1D   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+00241D     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+00-24-1A   (hex)		Red Beetle Inc.
+00241A     (base 16)		Red Beetle Inc.
+				898 Silas Deane Highway
+				Wethersfield  CT  06109
+				US
+
+00-24-14   (hex)		Cisco Systems, Inc
+002414     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-0C   (hex)		DELEC GmbH
+00240C     (base 16)		DELEC GmbH
+				Ruheweg 17-21
+				Göllheim  Rheinland-Pfalz  67307
+				DE
+
+00-23-F9   (hex)		Double-Take Software, INC.
+0023F9     (base 16)		Double-Take Software, INC.
+				8470 Allison Pointe Blvd
+				Indianapolis  IN  46250
+				US
+
+00-23-E9   (hex)		F5 Networks, Inc.
+0023E9     (base 16)		F5 Networks, Inc.
+				401 Elliott Ave. W.
+				Seattle  WA  98119
+				US
+
+00-23-EA   (hex)		Cisco Systems, Inc
+0023EA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-E5   (hex)		IPaXiom Networks
+0023E5     (base 16)		IPaXiom Networks
+				Aston Court
+				High Wycombe  Buckinghamshire  HP11 1LA
+				GB
+
+00-23-B6   (hex)		SECURITE COMMUNICATIONS / HONEYWELL
+0023B6     (base 16)		SECURITE COMMUNICATIONS / HONEYWELL
+				FONT DE L'ORME
+				MOUGINS  FRANCE  06250
+				US
+
+00-23-B8   (hex)		Sichuan Jiuzhou Electronic Technology Co.,Ltd
+0023B8     (base 16)		Sichuan Jiuzhou Electronic Technology Co.,Ltd
+				No.259 Jiuzhou Road,
+				Mianyang  Sichuan  621000
+				CN
+
+00-23-BA   (hex)		Chroma
+0023BA     (base 16)		Chroma
+				68, Hwa-Ya 1st Rd., Hwa-Ya Technical Park,
+				Taoyuan Hsien  Taiwan  333
+				TW
+
+00-23-BC   (hex)		EQ-SYS GmbH
+0023BC     (base 16)		EQ-SYS GmbH
+				Hinter den Gärten 15b
+				Treuenbrietzen OT Feldheim  Brandenburg  14929
+				DE
+
+00-23-B1   (hex)		Longcheer Technology (Singapore) Pte Ltd
+0023B1     (base 16)		Longcheer Technology (Singapore) Pte Ltd
+				43 Kaki Bukit View,  #04-01  ,
+				    415970
+				SG
+
+00-23-96   (hex)		ANDES TECHNOLOGY CORPORATION
+002396     (base 16)		ANDES TECHNOLOGY CORPORATION
+				2F,No. 1, Li-Hsin First Road,
+				Hsin-Chu  Taiwan  300
+				TW
+
+00-23-94   (hex)		Samjeon
+002394     (base 16)		Samjeon
+				#1313-1 Joil-Ri, Samdong-Myeun,Ulju-Gun
+				Ulsan City  South Korea  689-934
+				KR
+
+00-23-77   (hex)		Isotek Electronics Ltd
+002377     (base 16)		Isotek Electronics Ltd
+				9 Clayton Wood Bank
+				Leeds    LS16 6QZ
+				GB
+
+00-23-71   (hex)		SOAM Systel
+002371     (base 16)		SOAM Systel
+				182-13, Daerung Post Tower II, 1504
+				Seoul  Guro-dong, Guro-gu  152-847
+				KR
+
+00-23-A1   (hex)		Trend Electronics Ltd
+0023A1     (base 16)		Trend Electronics Ltd
+				Gut No. 350
+				Auranagabad  Maharashtra  431210
+				IN
+
+00-23-A6   (hex)		E-Mon
+0023A6     (base 16)		E-Mon
+				One Oxford Valley, Suite 418
+				Langhorne  PA  19047
+				US
+
+00-23-A8   (hex)		Marshall Electronics
+0023A8     (base 16)		Marshall Electronics
+				20608 Madrona Ave
+				Torrance  CA  90503
+				US
+
+00-23-9A   (hex)		EasyData Hardware GmbH
+00239A     (base 16)		EasyData Hardware GmbH
+				Breslauer Str. 24
+				Wehrheim  Hessen  D-61273
+				DE
+
+00-23-CC   (hex)		Nintendo Co., Ltd.
+0023CC     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-23-79   (hex)		Union Business Machines Co. Ltd.
+002379     (base 16)		Union Business Machines Co. Ltd.
+				Unit 2, 2/F, Block A, Hong Kong Industrial Centre,
+				Lai Chi Kok  Kowloon  
+				HK
+
+00-23-8C   (hex)		Private
+00238C     (base 16)		Private
+
+00-23-C0   (hex)		Broadway Networks
+0023C0     (base 16)		Broadway Networks
+				1754 Technology Drive, Suite 208
+				San Jose  California  95110
+				US
+
+00-23-58   (hex)		SYSTEL SA
+002358     (base 16)		SYSTEL SA
+				ZI DE BELLE AIRE
+				AYTRE    17440
+				FR
+
+00-23-56   (hex)		Packet Forensics LLC
+002356     (base 16)		Packet Forensics LLC
+				420 S Smith Rd
+				Tempe  AZ  85281
+				US
+
+00-23-50   (hex)		RDC, Inc. dba LynTec
+002350     (base 16)		RDC, Inc. dba LynTec
+				8385 Melrose Drive
+				Lenexa  KS  66214
+				US
+
+00-23-4F   (hex)		Luminous Power Technologies Pvt. Ltd.
+00234F     (base 16)		Luminous Power Technologies Pvt. Ltd.
+				C8-C9, Community Center,
+				New Delhi    110058
+				IN
+
+00-23-4B   (hex)		Inyuan Technology Inc.
+00234B     (base 16)		Inyuan Technology Inc.
+				No. 3, Singye St.,
+				Taoyuan County    33341
+				TW
+
+00-23-49   (hex)		Helmholtz Centre Berlin for Material and Energy
+002349     (base 16)		Helmholtz Centre Berlin for Material and Energy
+				Department FMD
+				Berlin    14109
+				DE
+
+00-23-46   (hex)		Vestac
+002346     (base 16)		Vestac
+				P.O. Box 7358
+				Shrewsbury  NJ  07702
+				US
+
+00-23-07   (hex)		FUTURE INNOVATION TECH CO.,LTD
+002307     (base 16)		FUTURE INNOVATION TECH CO.,LTD
+				312 3-DONG, GWANGMYUNG INDUSTRIAL COMPLEX 201
+				GWANGMYUNG  GYUNGGI  423060
+				KR
+
+00-23-05   (hex)		Cisco Systems, Inc
+002305     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-FF   (hex)		NIVIS LLC
+0022FF     (base 16)		NIVIS LLC
+				1000 CIRCLE 75
+				ATLANTA  GA  30339
+				US
+
+00-23-44   (hex)		Objective Interface Systems, Inc.
+002344     (base 16)		Objective Interface Systems, Inc.
+				220 Spring Street, Suite 530
+				Herndon  VA  20170-6201
+				US
+
+00-23-3C   (hex)		Alflex
+00233C     (base 16)		Alflex
+				Blauw-roodlaan 300
+				ZOETERMEER    2718 SK
+				NL
+
+00-23-33   (hex)		Cisco Systems, Inc
+002333     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-2E   (hex)		Kedah Electronics Engineering, LLC
+00232E     (base 16)		Kedah Electronics Engineering, LLC
+				Zelenograd, 445
+				Moscow    124498
+				RU
+
+00-23-20   (hex)		Nicira Networks
+002320     (base 16)		Nicira Networks
+				3460 W. Bayshore Rd.
+				Palo Alto  CA  94303
+				US
+
+00-23-64   (hex)		Power Instruments Pte Ltd
+002364     (base 16)		Power Instruments Pte Ltd
+				BLK 40 TOH GUAN RD EAST, #01-62 ENTERPRISE HUB
+				    608582
+				SG
+
+00-23-17   (hex)		Lasercraft Inc
+002317     (base 16)		Lasercraft Inc
+				1450 Oakbrook Drive
+				Norcross  GA  30093
+				US
+
+00-23-0E   (hex)		Gorba AG
+00230E     (base 16)		Gorba AG
+				Sandackerstrasse
+				Oberbüren  SG  CH - 9245
+				CH
+
+00-23-62   (hex)		Goldline Controls
+002362     (base 16)		Goldline Controls
+				61 Whitecap Dr
+				North Kingstown  RI  02852
+				US
+
+00-23-5E   (hex)		Cisco Systems, Inc
+00235E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-22   (hex)		KISS Teknical Solutions, Inc.
+002322     (base 16)		KISS Teknical Solutions, Inc.
+				1583 S. Navajo Way
+				Chandler  Arizona  85286
+				US
+
+00-22-B6   (hex)		Superflow Technologies Group
+0022B6     (base 16)		Superflow Technologies Group
+				4060 Dixon Street
+				Des Moines  IA  50266
+				US
+
+00-22-B5   (hex)		NOVITA
+0022B5     (base 16)		NOVITA
+				3F301,Namsung B/D 340-30
+				Geumcheon-Gu  Seoul  153-782
+				KR
+
+00-22-B2   (hex)		4RF Communications Ltd
+0022B2     (base 16)		4RF Communications Ltd
+				26 Glover Street
+				Ngauranga  Wellington  6031
+				NZ
+
+00-22-AC   (hex)		Hangzhou Siyuan Tech. Co., Ltd
+0022AC     (base 16)		Hangzhou Siyuan Tech. Co., Ltd
+				5 F, Tower B, No. 37, Xiang Yuan Road
+				Hangzhou  Zhejiang  310012
+				CN
+
+00-22-AD   (hex)		TELESIS TECHNOLOGIES, INC.
+0022AD     (base 16)		TELESIS TECHNOLOGIES, INC.
+				28181 River Drive
+				Circleville  Ohio  43113
+				US
+
+00-22-AE   (hex)		Mattel Inc.
+0022AE     (base 16)		Mattel Inc.
+				333 Continental Blvd.
+				El Segundo  CA  90245
+				US
+
+00-22-D5   (hex)		Eaton Corp. Electrical Group Data Center Solutions - Pulizzi
+0022D5     (base 16)		Eaton Corp. Electrical Group Data Center Solutions - Pulizzi
+				3200 S. Susan St.
+				Santa Ana  CA  92704
+				US
+
+00-22-D1   (hex)		Albrecht Jung GmbH & Co. KG
+0022D1     (base 16)		Albrecht Jung GmbH & Co. KG
+				Volmestraße 1
+				Schalksmühle  NRW  58579
+				DE
+
+00-22-D2   (hex)		All Earth Comércio de Eletrônicos LTDA.
+0022D2     (base 16)		All Earth Comércio de Eletrônicos LTDA.
+				Rua Leonida Reimman Trotti, 343
+				Campinas  São Paulo  13065-704
+				BR
+
+00-22-C2   (hex)		Proview Eletrônica do Brasil LTDA
+0022C2     (base 16)		Proview Eletrônica do Brasil LTDA
+				R. Acará 203 - Distrito Industrial
+				Manaus  Amazonas  69075-030
+				BR
+
+00-22-BD   (hex)		Cisco Systems, Inc
+0022BD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-BA   (hex)		HUTH Elektronik Systeme GmbH
+0022BA     (base 16)		HUTH Elektronik Systeme GmbH
+				Echternacher Str. 10
+				Troisdorf-Spich  NRW  53842
+				DE
+
+00-22-BB   (hex)		beyerdynamic GmbH & Co. KG
+0022BB     (base 16)		beyerdynamic GmbH & Co. KG
+				Theresienstraße 8
+				Heilbronn    74072
+				DE
+
+00-22-A3   (hex)		California Eastern Laboratories
+0022A3     (base 16)		California Eastern Laboratories
+				4590 Patrick Henry Dr.
+				Santa Clara  CA  95054
+				US
+
+00-23-02   (hex)		Cobalt Digital, Inc.
+002302     (base 16)		Cobalt Digital, Inc.
+				2406 East University Avenue
+				Urbana  IL  61802
+				US
+
+00-22-F5   (hex)		Advanced Realtime Tracking GmbH
+0022F5     (base 16)		Advanced Realtime Tracking GmbH
+				Am Oeferl 6
+				Weilheim  Bayern  D-82362
+				DE
+
+00-22-CA   (hex)		Anviz Biometric Tech. Co., Ltd.
+0022CA     (base 16)		Anviz Biometric Tech. Co., Ltd.
+				5th Floor, 4299 Jindu Road,
+				Shanghai    201108
+				CN
+
+00-22-C7   (hex)		SEGGER Microcontroller GmbH & Co. KG
+0022C7     (base 16)		SEGGER Microcontroller GmbH & Co. KG
+				In den Weiden 11
+				Hilden  NRW  40721
+				DE
+
+00-22-C1   (hex)		Active Storage Inc.
+0022C1     (base 16)		Active Storage Inc.
+				2295 Jefferson Street
+				Torrance  CA  90501
+				US
+
+00-22-8F   (hex)		CNRS
+00228F     (base 16)		CNRS
+				MRCT
+				Meudon  Ile de France  92195
+				FR
+
+00-22-97   (hex)		XMOS Semiconductor
+002297     (base 16)		XMOS Semiconductor
+				Venturers House
+				Bristol    BS1 4PB
+				GB
+
+00-22-92   (hex)		Cinetal
+002292     (base 16)		Cinetal
+				8651 Castle Park
+				Indianapolis  IN  46256
+				US
+
+00-22-E5   (hex)		Fisher-Rosemount Systems Inc.
+0022E5     (base 16)		Fisher-Rosemount Systems Inc.
+				12301 Research Blvd
+				Austin  Texas  78759
+				US
+
+00-22-E4   (hex)		APASS TECHNOLOGY CO., LTD.
+0022E4     (base 16)		APASS TECHNOLOGY CO., LTD.
+				2F, No. 267, Sec. 3, Chengde Rd.,
+				TEIPEI    113
+				TW
+
+00-22-4F   (hex)		Byzoro Networks Ltd.
+00224F     (base 16)		Byzoro Networks Ltd.
+				Room 5A1,Block A, Keshi Plaza,No. 28A Info. Road,
+				  Beijing  100085
+				CN
+
+00-22-51   (hex)		Lumasense Technologies
+002251     (base 16)		Lumasense Technologies
+				3033 Scott Blvd.
+				Santa Clara  CA  95054
+				US
+
+00-22-5E   (hex)		Uwin Technologies Co.,LTD
+00225E     (base 16)		Uwin Technologies Co.,LTD
+				2F,No.22.R&D RD II,SBIP
+				Hsinchu    300
+				TW
+
+00-22-58   (hex)		Taiyo Yuden Co., Ltd.
+002258     (base 16)		Taiyo Yuden Co., Ltd.
+				8-1 Sakae-Cho
+				    
+				JP
+
+00-22-5B   (hex)		Teradici Corporation
+00225B     (base 16)		Teradici Corporation
+				101 4621 Canada Way,
+				Burnaby  BC  V6G 4X8
+				CA
+
+00-22-59   (hex)		Guangzhou New Postcom Equipment Co.,Ltd.
+002259     (base 16)		Guangzhou New Postcom Equipment Co.,Ltd.
+				No.3¡¡Guangpuxi Road,Guangzhou Science City,
+				Guangzhou  Guangdong  510663
+				CN
+
+00-22-53   (hex)		Entorian Technologies
+002253     (base 16)		Entorian Technologies
+				8900 Shoal Creek Blvd
+				Austin  TX  78757
+				US
+
+00-22-2C   (hex)		Ceton Corp
+00222C     (base 16)		Ceton Corp
+				8259 122nd Ave NE, Suite 275
+				Kirkland  Washington  98033
+				US
+
+00-22-2D   (hex)		SMC Networks Inc.
+00222D     (base 16)		SMC Networks Inc.
+				20 Mason
+				Irvine  CA  92618
+				US
+
+00-22-2A   (hex)		SoundEar A/S
+00222A     (base 16)		SoundEar A/S
+				Rentemestervej 80
+				Copenhagen NV  Denmark  DK-2400
+				DK
+
+00-22-7E   (hex)		Chengdu 30Kaitian Communication Industry Co.Ltd
+00227E     (base 16)		Chengdu 30Kaitian Communication Industry Co.Ltd
+				No.6 Chuangye Road
+				Chengdu  Sichuan  610041
+				CN
+
+00-22-7C   (hex)		Woori SMT Co.,ltd
+00227C     (base 16)		Woori SMT Co.,ltd
+				649-2,Suwolam-ri,Seotan-Myun
+				Pyongtaek  Kyonggi-Do  451-852
+				KR
+
+00-22-77   (hex)		NEC Australia Pty Ltd
+002277     (base 16)		NEC Australia Pty Ltd
+				649-655 Springvale Rd
+				Mulgrave  Victoria  3170
+				AU
+
+00-22-3D   (hex)		JumpGen Systems, LLC
+00223D     (base 16)		JumpGen Systems, LLC
+				2111 Palomar Airport Rd
+				Carlsbad  CA  92011
+				US
+
+00-22-39   (hex)		Indiana Life Sciences Incorporated
+002239     (base 16)		Indiana Life Sciences Incorporated
+				8875 Bash Street
+				Indianapolis  Indiana  46256
+				US
+
+00-22-35   (hex)		Strukton Systems bv
+002235     (base 16)		Strukton Systems bv
+				Westkanaaldijk 2
+				Utrecht    3542 DA
+				NL
+
+00-22-79   (hex)		Nippon Conlux Co., Ltd.
+002279     (base 16)		Nippon Conlux Co., Ltd.
+				5-3-8, Chiyoda
+				Sakado-shi  Saitama  350-0214
+				JP
+
+00-22-71   (hex)		Jäger Computergesteuerte Meßtechnik GmbH.
+002271     (base 16)		Jäger Computergesteuerte Meßtechnik GmbH.
+				Rheinstraße 2-4
+				Lorsch  Hessen  64653
+				DE
+
+00-22-47   (hex)		DAC ENGINEERING CO., LTD.
+002247     (base 16)		DAC ENGINEERING CO., LTD.
+				1-5 Oyanagi-cho
+				Kyoto    601-8128
+				JP
+
+00-22-1F   (hex)		eSang Technologies Co., Ltd.
+00221F     (base 16)		eSang Technologies Co., Ltd.
+				#1-817, IT Castle 550-1, Gasan-Dong,
+				Seoul    153-768
+				KR
+
+00-21-E6   (hex)		Starlight Video Limited
+0021E6     (base 16)		Starlight Video Limited
+				5/F., Shing Dao Industrial Building,
+				    
+				HK
+
+00-21-E0   (hex)		CommAgility Ltd
+0021E0     (base 16)		CommAgility Ltd
+				Holywell Park
+				Loughborough  Leics  LE11 3AQ
+				GB
+
+00-21-DE   (hex)		Firepro Wireless
+0021DE     (base 16)		Firepro Wireless
+				27, Zamrudpur Community Center,
+				New Delhi  Haryana  110020
+				IN
+
+00-21-F9   (hex)		WIRECOM Technologies
+0021F9     (base 16)		WIRECOM Technologies
+				135, rue Jacques Charles
+				OLIVET  Loiret  45166
+				FR
+
+00-21-FA   (hex)		A4SP Technologies Ltd.
+0021FA     (base 16)		A4SP Technologies Ltd.
+				Keilaranta 19 D
+				Espoo  Uusimaa  02150
+				FI
+
+00-21-F0   (hex)		EW3 Technologies LLC
+0021F0     (base 16)		EW3 Technologies LLC
+				114 E 11th St
+				Connersville  IN  47331
+				US
+
+00-21-D3   (hex)		BOCOM SECURITY(ASIA PACIFIC) LIMITED
+0021D3     (base 16)		BOCOM SECURITY(ASIA PACIFIC) LIMITED
+				Flr.3,NO.29,#69 Guiqing RD
+				Shanghai    200233
+				CN
+
+00-21-CC   (hex)		Flextronics International
+0021CC     (base 16)		Flextronics International
+				Stretton Green Distribution Centre Langford Way
+				Warrington  Cheshire  WA4 4TQ
+				GB
+
+00-21-B9   (hex)		Universal Devices Inc.
+0021B9     (base 16)		Universal Devices Inc.
+				5353 Yarmouth Ave. #209
+				Encino  CA  91316
+				US
+
+00-21-B3   (hex)		Ross Controls
+0021B3     (base 16)		Ross Controls
+				One Ross Way
+				Lavonia  GA  30553
+				US
+
+00-21-B6   (hex)		Triacta Power Technologies Inc.
+0021B6     (base 16)		Triacta Power Technologies Inc.
+				Box 582, 7 Mill Street
+				Almonte  Ontario  K0A 1A0
+				CA
+
+00-22-17   (hex)		Neat Electronics
+002217     (base 16)		Neat Electronics
+				Varuvägen 2
+				Löddeköpinge  Skåne  SE-24642
+				SE
+
+00-22-11   (hex)		Rohati Systems
+002211     (base 16)		Rohati Systems
+				1192 Borregas Ave
+				Sunnyvale  CA  94089
+				US
+
+00-21-CF   (hex)		The Crypto Group
+0021CF     (base 16)		The Crypto Group
+				Zugerstrasse 42
+				Steinhausen  Zug  6312
+				CH
+
+00-21-C5   (hex)		3DSP Corp
+0021C5     (base 16)		3DSP Corp
+				16271 Laguna Canyon Road
+				Irvine,  CA  92618
+				US
+
+00-22-12   (hex)		CAI Networks, Inc.
+002212     (base 16)		CAI Networks, Inc.
+				4790 Irvine Blvd
+				Irvine  California  92620
+				US
+
+00-22-0D   (hex)		Cisco Systems, Inc
+00220D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-08   (hex)		Certicom Corp
+002208     (base 16)		Certicom Corp
+				5520 Explorer Drive, 4th Floor
+				Mississauga  ON  L4W 5L1
+				CA
+
+00-21-EE   (hex)		Full Spectrum Inc.
+0021EE     (base 16)		Full Spectrum Inc.
+				1149 Chestnut Street, Suite 100
+				Menlo Park  California  94025
+				US
+
+00-21-EC   (hex)		Solutronic GmbH
+0021EC     (base 16)		Solutronic GmbH
+				Kueferstrasse 18
+				Koengen    73257
+				DE
+
+00-22-05   (hex)		WeLink Solutions, Inc.
+002205     (base 16)		WeLink Solutions, Inc.
+				3F, No. 88, Sec. 1, Nei-Hu Rd.
+				Taipei    114
+				TW
+
+00-22-09   (hex)		Omron Healthcare Co., Ltd
+002209     (base 16)		Omron Healthcare Co., Ltd
+				24 Yamanoshita-cho Yamanouchi
+				Kyoto    6150084
+				JP
+
+00-21-8C   (hex)		TopControl GMBH
+00218C     (base 16)		TopControl GMBH
+				Enzenbergweg 24/A
+				Terlan (BZ)    39018
+				IT
+
+00-21-8A   (hex)		Electronic Design and Manufacturing Company
+00218A     (base 16)		Electronic Design and Manufacturing Company
+				31 Millrace Dr
+				Lynchburg  VA  24502
+				US
+
+00-21-8B   (hex)		Wescon Technology, Inc.
+00218B     (base 16)		Wescon Technology, Inc.
+				4655-170 Old Ironsides Drive
+				Santa Clara  California  95054
+				US
+
+00-21-84   (hex)		POWERSOFT SRL
+002184     (base 16)		POWERSOFT SRL
+				VIA ENRICO CONTI, 5
+				SCANDICCI  FI  50018
+				IT
+
+00-21-78   (hex)		Matuschek Messtechnik GmbH
+002178     (base 16)		Matuschek Messtechnik GmbH
+				Werner Heisenberg Straße 14
+				Alsdorf  NRW  52477
+				DE
+
+00-21-73   (hex)		Ion Torrent Systems, Inc.
+002173     (base 16)		Ion Torrent Systems, Inc.
+				37 Soundview Rd
+				Guilford  CT  06437
+				US
+
+00-21-77   (hex)		W. L. Gore & Associates
+002177     (base 16)		W. L. Gore & Associates
+				402 Vieves Way
+				Elkton  MD  21921
+				US
+
+00-21-72   (hex)		Seoultek Valley
+002172     (base 16)		Seoultek Valley
+				Bang-i Dong 51-5, Songpa
+				Seoul    138-050
+				KR
+
+00-21-53   (hex)		SeaMicro Inc.
+002153     (base 16)		SeaMicro Inc.
+				3250 Jay Street
+				Santa Clara  CA  95054
+				US
+
+00-21-7A   (hex)		Sejin Electron, Inc.
+00217A     (base 16)		Sejin Electron, Inc.
+				SJ Technoville
+				Seoul    153-801
+				KR
+
+00-21-A4   (hex)		Dbii Networks
+0021A4     (base 16)		Dbii Networks
+				2217 Via Blanca
+				Oceanside  CA  92054
+				US
+
+00-21-99   (hex)		Vacon Plc
+002199     (base 16)		Vacon Plc
+				P.O.Box 25
+				Vaasa    65380
+				FI
+
+00-21-A0   (hex)		Cisco Systems, Inc
+0021A0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-98   (hex)		Thai Radio Co, LTD
+002198     (base 16)		Thai Radio Co, LTD
+				Hi-Tech Industrial Estate
+				Ayutthaya    13160
+				TH
+
+00-21-AE   (hex)		ALCATEL-LUCENT FRANCE - WTD
+0021AE     (base 16)		ALCATEL-LUCENT FRANCE - WTD
+				7-9, Avenue Morane Saulnier
+				VELIZY    78141
+				FR
+
+00-21-AF   (hex)		Radio Frequency Systems
+0021AF     (base 16)		Radio Frequency Systems
+				Kabelkamp 20
+				Hannover    30179
+				DE
+
+00-21-54   (hex)		D-TACQ Solutions Ltd
+002154     (base 16)		D-TACQ Solutions Ltd
+				James Watt Building
+				East Kilbride  Lanarkshire  G75 0QD
+				GB
+
+00-21-69   (hex)		Prologix, LLC.
+002169     (base 16)		Prologix, LLC.
+				17217 NE 133rd Place
+				Redmond  Washington  98052-2153
+				US
+
+00-21-4B   (hex)		Shenzhen HAMP Science & Technology Co.,Ltd
+00214B     (base 16)		Shenzhen HAMP Science & Technology Co.,Ltd
+				No.302-303,3 Floor,District A,TCL Tower,Gaoxin Nan Yi Road,NanShan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-21-45   (hex)		Semptian Technologies Ltd.
+002145     (base 16)		Semptian Technologies Ltd.
+				No. 809,  Tower B, Shi Ji Ke Mao
+				Beijing    100190
+				CN
+
+00-1F-FE   (hex)		HPN Supply Chain
+001FFE     (base 16)		HPN Supply Chain
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+00-1F-FF   (hex)		Respironics, Inc.
+001FFF     (base 16)		Respironics, Inc.
+				1740 Golden Mile Highway
+				Monroeville  PA  15146
+				US
+
+00-1F-FC   (hex)		Riccius+Sohn GmbH
+001FFC     (base 16)		Riccius+Sohn GmbH
+				Haynauer Str. 49
+				Berlin    12249
+				DE
+
+00-1F-FD   (hex)		Indigo Mobile Technologies Corp.
+001FFD     (base 16)		Indigo Mobile Technologies Corp.
+				11F, No22, Lan407,TiDing Blvd Section2, Neihu Technology Park
+				Taipei City    114
+				TW
+
+00-21-21   (hex)		VRmagic GmbH
+002121     (base 16)		VRmagic GmbH
+				Augustaanlage 32
+				Mannheim  BW  68165
+				DE
+
+00-21-23   (hex)		Aerosat Avionics
+002123     (base 16)		Aerosat Avionics
+				62 State Rd.
+				Amherst  NH  03031
+				US
+
+00-21-0A   (hex)		byd:sign Corporation
+00210A     (base 16)		byd:sign Corporation
+				2-10-6 Tsukiji
+				Chuo-ku  Tokyo  104-0045
+				JP
+
+00-21-07   (hex)		Seowonintech Co Ltd.
+002107     (base 16)		Seowonintech Co Ltd.
+				689-47 Geumjeongdong
+				Gunposi  Kyoungkido  436-862
+				KR
+
+00-21-3E   (hex)		TomTom
+00213E     (base 16)		TomTom
+				Oosterdoksstraat 114
+				Amsterdam  North Holland  1011 DK
+				NL
+
+00-21-3F   (hex)		A-Team Technology Ltd.
+00213F     (base 16)		A-Team Technology Ltd.
+				Rm. 1608, 16/F., Metropole Square,
+				New Territories,    
+				HK
+
+00-21-1B   (hex)		Cisco Systems, Inc
+00211B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-2D   (hex)		SCIMOLEX CORPORATION
+00212D     (base 16)		SCIMOLEX CORPORATION
+				2430, Saijou, Showa-cho
+				Nakakoma-gun, Yamanashi    409-3866
+				JP
+
+00-1F-D5   (hex)		MICRORISC s.r.o.
+001FD5     (base 16)		MICRORISC s.r.o.
+				Delnicka 222
+				Jicin  kralovehradecky kraj  50601
+				CZ
+
+00-1F-B1   (hex)		Cybertech Inc.
+001FB1     (base 16)		Cybertech Inc.
+				935 Horsham Rd
+				Horsham  PA  19044
+				US
+
+00-1F-B2   (hex)		Sontheim Industrie Elektronik GmbH
+001FB2     (base 16)		Sontheim Industrie Elektronik GmbH
+				Dieselstrasse 7
+				Kempten Allgaeu  Bavaria  D-87437
+				DE
+
+00-1F-EE   (hex)		ubisys technologies GmbH
+001FEE     (base 16)		ubisys technologies GmbH
+				Am Wehrhahn 45
+				Düsseldorf  NRW  40211
+				DE
+
+00-1F-EF   (hex)		SHINSEI INDUSTRIES CO.,LTD
+001FEF     (base 16)		SHINSEI INDUSTRIES CO.,LTD
+				4-12-15,HORIFUNE, KITA-KU,
+				TOKOYO    114-0004
+				JP
+
+00-1F-EC   (hex)		Synapse Électronique
+001FEC     (base 16)		Synapse Électronique
+				1010, 7e Avenue
+				Grand-Mère  Québec  G9T 2B8
+				CA
+
+00-1F-CA   (hex)		Cisco Systems, Inc
+001FCA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-C3   (hex)		SmartSynch, Inc
+001FC3     (base 16)		SmartSynch, Inc
+				4400 Old Canton Rd
+				Jackson  MS  39211
+				US
+
+00-1F-E0   (hex)		EdgeVelocity Corp
+001FE0     (base 16)		EdgeVelocity Corp
+				68 Stiles Road
+				Hudson  NH  03079
+				US
+
+00-1F-D8   (hex)		A-TRUST COMPUTER CORPORATION
+001FD8     (base 16)		A-TRUST COMPUTER CORPORATION
+				3F., NO.361, FUSING 1ST RD., GUEISHAN TOWNSHIP,
+				TAOYUAN    33375
+				TW
+
+00-1F-D7   (hex)		TELERAD SA
+001FD7     (base 16)		TELERAD SA
+				2, avenue de la butte aux cailles
+				ANGLET    64600
+				FR
+
+00-1F-D3   (hex)		RIVA Networks Inc.
+001FD3     (base 16)		RIVA Networks Inc.
+				555 Riva Ave
+				East Brunswick  NJ  08816
+				US
+
+00-1F-C1   (hex)		Hanlong Technology Co.,LTD
+001FC1     (base 16)		Hanlong Technology Co.,LTD
+				2402 West Tower Building, Fuxin International Building,
+				Nanjing  Jiangsu  210002
+				CN
+
+00-1F-BB   (hex)		Xenatech Co.,LTD
+001FBB     (base 16)		Xenatech Co.,LTD
+				 514-2 Ya Tab-Dong Bun Dang Gu
+				Seong namsi  Gyong gi-do  463-839
+				KR
+
+00-1F-E8   (hex)		KURUSUGAWA Electronics Industry Inc,.
+001FE8     (base 16)		KURUSUGAWA Electronics Industry Inc,.
+				2F, 52-5, Nogata 6chome
+				Nakano-Ku  TOKYO  165-0027
+				JP
+
+00-1F-AB   (hex)		I.S HIGH TECH.INC
+001FAB     (base 16)		I.S HIGH TECH.INC
+				603-1,Sungbon-ri,Daeso-myun
+				Eumsung-gun  Chungcheongbuk-do  369-823
+				KR
+
+00-1F-AC   (hex)		Goodmill Systems Ltd
+001FAC     (base 16)		Goodmill Systems Ltd
+				Sinikalliontie 10
+				Espoo  Uusimaa  02630
+				FI
+
+00-1F-36   (hex)		Bellwin Information Co. Ltd.,
+001F36     (base 16)		Bellwin Information Co. Ltd.,
+				No.336, Beitun Rd., Beitun Dist.,
+				Taichung    406
+				TW
+
+00-1F-3D   (hex)		Qbit GmbH
+001F3D     (base 16)		Qbit GmbH
+				Stegwiesenstrasse 32
+				Bruchsal  Germany  76646
+				DE
+
+00-1F-38   (hex)		POSITRON
+001F38     (base 16)		POSITRON
+				ESTRADA TELEBRAS-UNICAMP, KM0,97 - CJ.01
+				CAMPINAS  São Paulo  13084-971
+				BR
+
+00-1F-2D   (hex)		Electro-Optical Imaging, Inc.
+001F2D     (base 16)		Electro-Optical Imaging, Inc.
+				4300 Fortune Place, Suite C
+				West Melbourne  FL  32904
+				US
+
+00-1F-89   (hex)		Signalion GmbH
+001F89     (base 16)		Signalion GmbH
+				Sudhausweg 5
+				Dresden  Saxony  01099
+				DE
+
+00-1F-8A   (hex)		Ellion Digital Inc.
+001F8A     (base 16)		Ellion Digital Inc.
+				Suite 809, Sicox Tower, 513-14, Sangdaewon-dong, Jungwon-gu
+				Sungnam-city  Kyonggi-do  426-726
+				KR
+
+00-1F-7F   (hex)		Phabrix Limited
+001F7F     (base 16)		Phabrix Limited
+				Blindmans Gate Cottage
+				Newbury  Hampshire  RG20 9XB
+				GB
+
+00-1F-76   (hex)		AirLogic Systems Inc.
+001F76     (base 16)		AirLogic Systems Inc.
+				3022 Peleke St.Suite 1
+				Lihu'e  HI  96766
+				US
+
+00-1F-73   (hex)		Teraview Technology Co., Ltd.
+001F73     (base 16)		Teraview Technology Co., Ltd.
+				23F, No. 29-5, Sec. 2, Jhongjheng E. Road,
+				Taipei County    251
+				TW
+
+00-1F-62   (hex)		JSC Stilsoft
+001F62     (base 16)		JSC Stilsoft
+				Mayakovskogo 15
+				Stavropol    355000
+				RU
+
+00-1F-67   (hex)		Hitachi,Ltd.
+001F67     (base 16)		Hitachi,Ltd.
+				Minamioi 6-27-18, Shinagawa-ku
+				Tokyo  Tokyo  140-8572
+				JP
+
+00-1F-56   (hex)		DIGITAL FORECAST
+001F56     (base 16)		DIGITAL FORECAST
+				5th Fl., 507, E&C Venture Dream Tower III, 197-33
+				Seoul  Gyunggi-do  152-719
+				KR
+
+00-1F-52   (hex)		UVT Unternehmensberatung fur Verkehr und Technik GmbH
+001F52     (base 16)		UVT Unternehmensberatung fur Verkehr und Technik GmbH
+				Josefsstraße 54-56
+				Mainz  RLP  55118
+				DE
+
+00-1F-4F   (hex)		Thinkware Co. Ltd.
+001F4F     (base 16)		Thinkware Co. Ltd.
+				15FL, Hanmi Tower, 45,
+				Seoul    138-724
+				KR
+
+00-1F-2F   (hex)		Berker GmbH & Co. KG
+001F2F     (base 16)		Berker GmbH & Co. KG
+				Klagebach 38
+				Schalksmuehle  NRW  58579
+				DE
+
+00-1F-32   (hex)		Nintendo Co., Ltd.
+001F32     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1F-44   (hex)		GE Transportation Systems
+001F44     (base 16)		GE Transportation Systems
+				2901 East Lake Road
+				Erie  PA  16501
+				US
+
+00-1F-39   (hex)		Construcciones y Auxiliar de Ferrocarriles, S.A.
+001F39     (base 16)		Construcciones y Auxiliar de Ferrocarriles, S.A.
+				C/ J.M. Iturrioz, 26
+				Beasain  Guipúzcoa  E-20200
+				ES
+
+00-1F-7C   (hex)		Witelcom AS
+001F7C     (base 16)		Witelcom AS
+				Verftsgt 10
+				Moss  Ostfold  1511
+				NO
+
+00-1F-7A   (hex)		WiWide Inc.
+001F7A     (base 16)		WiWide Inc.
+				10B10, Hua Jie Plaza
+				Beijing    100089
+				CN
+
+00-1F-77   (hex)		HEOL DESIGN
+001F77     (base 16)		HEOL DESIGN
+				1 bd d'armor
+				LANNION  BRETAGNE  22300
+				FR
+
+00-1F-94   (hex)		Lascar Electronics Ltd
+001F94     (base 16)		Lascar Electronics Ltd
+				Module House
+				Nr Salisbury  Wiltshire  SP5 2SJ
+				GB
+
+00-1F-8E   (hex)		Metris USA Inc.
+001F8E     (base 16)		Metris USA Inc.
+				44880 Falcon Place ste 100
+				Sterling  VA  20166
+				US
+
+00-1F-61   (hex)		Talent Communication Networks Inc.
+001F61     (base 16)		Talent Communication Networks Inc.
+				Rm. 910 R&F Plaza, #76, Huangpu Ave. West,
+				Guangzhou (Canton)  Guangdong Province  510360
+				CN
+
+00-1E-CE   (hex)		BISA Technologies (Hong Kong) Limited
+001ECE     (base 16)		BISA Technologies (Hong Kong) Limited
+				1102, Trans Asia Centre,
+				 Kwai Chung,    
+				HK
+
+00-1E-C8   (hex)		Rapid Mobile (Pty) Ltd
+001EC8     (base 16)		Rapid Mobile (Pty) Ltd
+				Building C,D,E Apex Corporate Park
+				Pretoria  Gauteng  0020
+				ZA
+
+00-1E-CC   (hex)		CDVI
+001ECC     (base 16)		CDVI
+				31 Avenue du Général Leclerc
+				PANTIN  Ile de France  93500
+				FR
+
+00-1E-C5   (hex)		Middle Atlantic Products Inc
+001EC5     (base 16)		Middle Atlantic Products Inc
+				300 Fairfield Road
+				Fairfield  NJ  07004
+				US
+
+00-1F-03   (hex)		NUM AG
+001F03     (base 16)		NUM AG
+				Battenhusstrasse 16
+				Teufen  AR  9053
+				CH
+
+00-1E-FF   (hex)		Mueller-Elektronik GmbH & Co. KG
+001EFF     (base 16)		Mueller-Elektronik GmbH & Co. KG
+				Franz-Kleine-Str. 18
+				Salzkotten  NRW  33154
+				DE
+
+00-1F-05   (hex)		iTAS Technology Corp.
+001F05     (base 16)		iTAS Technology Corp.
+				No. 75, Shuiyuan St.
+				Hsinchu City    30069
+				TW
+
+00-1F-07   (hex)		AZTEQ Mobile
+001F07     (base 16)		AZTEQ Mobile
+				Suite 210, 525 University Ave
+				Palo Alto  CA  94301
+				US
+
+00-1E-F6   (hex)		Cisco Systems, Inc
+001EF6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-F9   (hex)		Pascom Kommunikations systeme GmbH.
+001EF9     (base 16)		Pascom Kommunikations systeme GmbH.
+				Technologiestr. 4
+				Arbing  Upper Austria  4332
+				AT
+
+00-1E-F3   (hex)		From2
+001EF3     (base 16)		From2
+				2F, Mester inc
+				Daejeon    306-230
+				KR
+
+00-1F-19   (hex)		BEN-RI ELECTRONICA S.A.
+001F19     (base 16)		BEN-RI ELECTRONICA S.A.
+				POL. IND. VENTORRO DEL CANO
+				ALCORCON  MADRID  28925
+				ES
+
+00-1F-11   (hex)		OPENMOKO, INC.
+001F11     (base 16)		OPENMOKO, INC.
+				7F, No 300, Yang Guang Street
+				Taipei    11491
+				TW
+
+00-1E-E4   (hex)		ACS Solutions France
+001EE4     (base 16)		ACS Solutions France
+				Rue Claude Chappe
+				Guilherand Granges  Ardeche  07503
+				FR
+
+00-1E-ED   (hex)		Adventiq Ltd.
+001EED     (base 16)		Adventiq Ltd.
+				Technology House
+				Bar Hill  Cambs.  CB3 8SQ
+				GB
+
+00-1E-D2   (hex)		Ray Shine Video Technology Inc
+001ED2     (base 16)		Ray Shine Video Technology Inc
+				6F,No.98,Sec.1,Xintai 5th Rd.
+				Xizhi City  Taipei County  221
+				TW
+
+00-1E-D4   (hex)		Doble Engineering
+001ED4     (base 16)		Doble Engineering
+				85 Walnut St
+				Watertown  MA  02472
+				US
+
+00-1E-FD   (hex)		Microbit 2.0 AB
+001EFD     (base 16)		Microbit 2.0 AB
+				Nystaden 1
+				KALIX    95261
+				SE
+
+00-1E-E7   (hex)		Epic Systems Inc
+001EE7     (base 16)		Epic Systems Inc
+				390 S. Abbott Ave
+				Milpitas  CA  95035
+				US
+
+00-1E-E9   (hex)		Stoneridge Electronics AB
+001EE9     (base 16)		Stoneridge Electronics AB
+				Gårdsfogdevägen 18A
+				Bromma  Stockholm  168 66
+				SE
+
+00-1F-1C   (hex)		KOBISHI ELECTRIC Co.,Ltd.
+001F1C     (base 16)		KOBISHI ELECTRIC Co.,Ltd.
+				1805-1
+				Kounosu-shi  Saitama-ken  365-0027
+				JP
+
+00-1E-79   (hex)		Cisco Systems, Inc
+001E79     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-76   (hex)		Thermo Fisher Scientific
+001E76     (base 16)		Thermo Fisher Scientific
+				2215 Grand Avenue Parkway
+				Austin  Texas  78728
+				US
+
+00-1E-72   (hex)		PCS
+001E72     (base 16)		PCS
+				2 HENRI FARMAN
+				LESCAR  PYRENEES ATLANTIQUES  64230
+				FR
+
+00-1E-5F   (hex)		KwikByte, LLC
+001E5F     (base 16)		KwikByte, LLC
+				2430 W. 12th Street
+				Tempe  AZ  85281
+				US
+
+00-1E-5B   (hex)		Unitron Company, Inc.
+001E5B     (base 16)		Unitron Company, Inc.
+				10925 Miller Road
+				Dallas  TX  75238
+				US
+
+00-1E-5E   (hex)		COmputime Ltd.
+001E5E     (base 16)		COmputime Ltd.
+				17/F Great Eagle Centre
+				Wanchai    
+				HK
+
+00-1E-9D   (hex)		Recall Technologies, Inc.
+001E9D     (base 16)		Recall Technologies, Inc.
+				130 Enterprise Ave.
+				Palm Bay  FL  32909
+				US
+
+00-1E-95   (hex)		SIGMALINK
+001E95     (base 16)		SIGMALINK
+				DooSan VentureDigm 1028,
+				Anyang-City  Kyunggi-do  431-070
+				KR
+
+00-1E-93   (hex)		CiriTech Systems Inc
+001E93     (base 16)		CiriTech Systems Inc
+				920 Hillview Ct
+				Milpitas  CA  95035
+				US
+
+00-1E-A2   (hex)		Symx Systems, Inc.
+001EA2     (base 16)		Symx Systems, Inc.
+				6320 NW 84th Avenue
+				Miami  Florida  33166
+				US
+
+00-1E-A9   (hex)		Nintendo Co., Ltd.
+001EA9     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1E-9E   (hex)		ddm hopt + schuler Gmbh + Co. KG
+001E9E     (base 16)		ddm hopt + schuler Gmbh + Co. KG
+				Koenigsberger Strasse 12
+				Rottweil  Baden-Württemberg  78626
+				DE
+
+00-1E-BE   (hex)		Cisco Systems, Inc
+001EBE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-C3   (hex)		Kozio, Inc.
+001EC3     (base 16)		Kozio, Inc.
+				2015 Ionosphere Street
+				Longmont  CO  80504
+				US
+
+00-1E-BD   (hex)		Cisco Systems, Inc
+001EBD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-B9   (hex)		Sing Fai Technology Limited
+001EB9     (base 16)		Sing Fai Technology Limited
+				No.700, Kaohsiung University Rd., Nan-Tzu Dist.
+				Kaohsiung    811
+				TW
+
+00-1E-B7   (hex)		TBTech, Co., Ltd.
+001EB7     (base 16)		TBTech, Co., Ltd.
+				1109, Hyundai Krim, 1330-18, Seocho-dong,
+				Seoul    137-070
+				KR
+
+00-1E-69   (hex)		Thomson Inc.
+001E69     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290-1102
+				US
+
+00-1E-92   (hex)		JEULIN S.A.
+001E92     (base 16)		JEULIN S.A.
+				ZI N°1
+				Evreux    F27019
+				FR
+
+00-1E-91   (hex)		KIMIN Electronic Co., Ltd.
+001E91     (base 16)		KIMIN Electronic Co., Ltd.
+				293-4, Dongdan-Dong
+				Gumi-city  GyeongBuk  730-906
+				KR
+
+00-1E-89   (hex)		CRFS Limited
+001E89     (base 16)		CRFS Limited
+				Building 7200
+				Waterbeach  Cambridgeshire  CB25 9TL
+				GB
+
+00-1E-86   (hex)		MEL Co.,Ltd.
+001E86     (base 16)		MEL Co.,Ltd.
+				Tsukagoshi 5-5-1,Warabi-shi,Saitama,Japna
+				Warabi  Saitama  335-0002
+				JP
+
+00-1E-88   (hex)		ANDOR SYSTEM SUPPORT CO., LTD.
+001E88     (base 16)		ANDOR SYSTEM SUPPORT CO., LTD.
+				Minami-Shinagawa 2-15-8
+				Sinagawa  Tokyo  140-0004
+				JP
+
+00-1E-0C   (hex)		Sherwood Information Partners, Inc.
+001E0C     (base 16)		Sherwood Information Partners, Inc.
+				1120 W, 122nd Ave, Ste 300
+				Westminster  CO  80234
+				US
+
+00-1E-02   (hex)		Sougou Keikaku Kougyou Co.,Ltd.
+001E02     (base 16)		Sougou Keikaku Kougyou Co.,Ltd.
+				HK2 bld. 2-21-10
+				Suginamiku  Tokyo  167-0053
+				JP
+
+00-1E-01   (hex)		Renesas Technology Sales Co., Ltd.
+001E01     (base 16)		Renesas Technology Sales Co., Ltd.
+				2-6-2
+				Chiyoda-ku  Tokyo  100-0004
+				JP
+
+00-1D-FF   (hex)		Network Critical Solutions Ltd
+001DFF     (base 16)		Network Critical Solutions Ltd
+				12B Southview Park
+				Reading  Berkshire  RG45AF
+				GB
+
+00-1E-00   (hex)		Shantou Institute of Ultrasonic Instruments
+001E00     (base 16)		Shantou Institute of Ultrasonic Instruments
+				No.77, Jinsha Road,
+				Shantou  Guangdong  515041
+				CN
+
+00-1E-54   (hex)		TOYO ELECTRIC Corporation
+001E54     (base 16)		TOYO ELECTRIC Corporation
+				1-39 HIKISAWA
+				KASUGAI  AICHI  480-0393
+				JP
+
+00-1E-3C   (hex)		Lyngbox Media AB
+001E3C     (base 16)		Lyngbox Media AB
+				Diskettgatan 11B
+				Linkoping    SE-58335
+				SE
+
+00-1E-4D   (hex)		Welkin Sciences, LLC
+001E4D     (base 16)		Welkin Sciences, LLC
+				102 S. Tejon St, Suite 200
+				Colorado Springs  CO  80903
+				US
+
+00-1E-4B   (hex)		City Theatrical
+001E4B     (base 16)		City Theatrical
+				475 Barell Ave
+				Carlstadt  New Jersey  07072
+				US
+
+00-1E-4A   (hex)		Cisco Systems, Inc
+001E4A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-13   (hex)		Cisco Systems, Inc
+001E13     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-0D   (hex)		Micran Ltd.
+001E0D     (base 16)		Micran Ltd.
+				Vershinina st. 47
+				Tomsk  Tomsk Region  634034
+				RU
+
+00-1E-09   (hex)		ZEFATEK Co.,LTD
+001E09     (base 16)		ZEFATEK Co.,LTD
+				326-4 Gasandong, Geumcheongu
+				Seoul    153-802
+				KR
+
+00-1E-06   (hex)		WIBRAIN
+001E06     (base 16)		WIBRAIN
+				306 JEI Plats B/D 459-11 Gasan-dong, Geumcheon-gu
+				SEOUL    153-803
+				KR
+
+00-1E-2C   (hex)		CyVerse Corporation
+001E2C     (base 16)		CyVerse Corporation
+				Shoutou Roukubankan Bldg. 4F
+				Shibuya-ku  Tokyo  150-0046
+				JP
+
+00-1E-26   (hex)		Digifriends Co. Ltd
+001E26     (base 16)		Digifriends Co. Ltd
+				Joyang B/D 6th Floor
+				Seoul    135-090
+				KR
+
+00-1E-23   (hex)		Electronic Educational Devices, Inc
+001E23     (base 16)		Electronic Educational Devices, Inc
+				1903 S Grant St
+				Denver  CO  80210
+				US
+
+00-1D-F3   (hex)		SBS Science & Technology Co., Ltd
+001DF3     (base 16)		SBS Science & Technology Co., Ltd
+				W2-B5/6 High-tech industrial park
+				ShenZhen  GuangDong  518057
+				CN
+
+00-1D-EE   (hex)		NEXTVISION SISTEMAS DIGITAIS DE TELEVISÃO LTDA.
+001DEE     (base 16)		NEXTVISION SISTEMAS DIGITAIS DE TELEVISÃO LTDA.
+				Alameda Rio Negro, 1030 - 19o. andar conj. 1904
+				Barueri  São Paulo  06454-000
+				BR
+
+00-1D-EA   (hex)		Commtest Instruments Ltd
+001DEA     (base 16)		Commtest Instruments Ltd
+				Level 2, 22 Moorhouse Ave
+				Christchurch  Canterbury  8243
+				NZ
+
+00-1D-DD   (hex)		DAT H.K. LIMITED
+001DDD     (base 16)		DAT H.K. LIMITED
+				Suite 1405 14/F., City Plaza 4, Tai Koo Wan Rd,
+				Tai Koo Shing  Hong Kong Island  064828
+				HK
+
+00-1D-E4   (hex)		Visioneered Image Systems
+001DE4     (base 16)		Visioneered Image Systems
+				10561 Garden Grove Blvd
+				Garden Grove  California  92843
+				US
+
+00-1D-E2   (hex)		Radionor Communications
+001DE2     (base 16)		Radionor Communications
+				Ingvald Ystgaards veg 23
+				Trondheim  TRD  7046
+				NO
+
+00-1D-D7   (hex)		Algolith
+001DD7     (base 16)		Algolith
+				400 Isabey
+				Saint-Laurent  Qc  H4T 1V3
+				CA
+
+00-1D-C9   (hex)		GainSpan Corp.
+001DC9     (base 16)		GainSpan Corp.
+				P.O. Box 223580
+				Carmel  CA  93922
+				US
+
+00-1D-86   (hex)		Shinwa Industries(China) Ltd.
+001D86     (base 16)		Shinwa Industries(China) Ltd.
+				8 Pingnanzhong Road, Pingnan Industrial Park, Zhongkai No.4 Road,
+				Huizhou City  Guangdong Province  516006
+				CN
+
+00-1D-88   (hex)		Clearwire
+001D88     (base 16)		Clearwire
+				1475 120th Ave NE
+				Bellevue  Washington  98005
+				US
+
+00-1D-81   (hex)		GUANGZHOU GATEWAY ELECTRONICS CO., LTD
+001D81     (base 16)		GUANGZHOU GATEWAY ELECTRONICS CO., LTD
+				B20#,4F,No.9 Jiangong Road,Tianhe Software Park,Tianhe District,
+				GUANGZHOU  Guangdong  510665
+				CN
+
+00-1D-7D   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+001D7D     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+00-1D-C7   (hex)		L-3 Communications Geneva Aerospace
+001DC7     (base 16)		L-3 Communications Geneva Aerospace
+				4240 International Parkway
+				Carrollton  Texas  75007
+				US
+
+00-1D-89   (hex)		VaultStor Corporation
+001D89     (base 16)		VaultStor Corporation
+				1010 Brioso Drive
+				Costa Mesa  CA  92627
+				US
+
+00-1D-66   (hex)		Hyundai Telecom
+001D66     (base 16)		Hyundai Telecom
+				Hyundai Telecom Bldg., 4273-12, Shingil-Dong, Youngdungpo-Gu,
+				Seoul    150-859
+				KR
+
+00-1D-77   (hex)		NSGate
+001D77     (base 16)		NSGate
+				Rm 1304, 39 Kirpichnaya Street
+				Moscow    105187
+				RU
+
+00-1D-A2   (hex)		Cisco Systems, Inc
+001DA2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-99   (hex)		Cyan Optic, Inc.
+001D99     (base 16)		Cyan Optic, Inc.
+				1390 N. McDowell Blvd
+				Petaluma  CA  94954
+				US
+
+00-1D-9B   (hex)		Hokuyo Automatic Co., Ltd.
+001D9B     (base 16)		Hokuyo Automatic Co., Ltd.
+				Niitaka 1-10-9
+				Osaka    532-0033
+				JP
+
+00-1D-BC   (hex)		Nintendo Co., Ltd.
+001DBC     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1D-B6   (hex)		BestComm Networks, Inc.
+001DB6     (base 16)		BestComm Networks, Inc.
+				4400 E. Broadway Blvd.
+				Tucson  AZ  85711
+				US
+
+00-1D-AC   (hex)		Gigamon Systems LLC
+001DAC     (base 16)		Gigamon Systems LLC
+				598 Gibraltar Drive
+				Milpitas  CA  95035
+				US
+
+00-1D-15   (hex)		Shenzhen Dolphin Electronic Co., Ltd
+001D15     (base 16)		Shenzhen Dolphin Electronic Co., Ltd
+				Building21,Baoyuan, No.1 Industrial Zone,
+				Shenzhen  Guangdong  518103
+				CN
+
+00-1D-16   (hex)		SFR
+001D16     (base 16)		SFR
+				40/42 Quai du point du jour
+				Boulongne Billancourt Hauts de Seine     92659
+				FR
+
+00-1D-11   (hex)		Analogue & Micro Ltd
+001D11     (base 16)		Analogue & Micro Ltd
+				Lakeside House
+				Llantarnam Industrial Park  Cwmbran  NP44 3XS
+				GB
+
+00-1D-12   (hex)		ROHM CO., LTD.
+001D12     (base 16)		ROHM CO., LTD.
+				21 Saiin-Mizosaki-cho,
+				Kyoto-shi  KYOTO  615-8585
+				JP
+
+00-1D-47   (hex)		Covote GmbH & Co KG
+001D47     (base 16)		Covote GmbH & Co KG
+				Ritterhufen 30
+				Berlin    14165
+				DE
+
+00-1D-41   (hex)		Hardy Instruments
+001D41     (base 16)		Hardy Instruments
+				3860 Calle Fortunada
+				San Diego  CA  92123
+				US
+
+00-1D-3D   (hex)		Avidyne Corporation
+001D3D     (base 16)		Avidyne Corporation
+				202 West Dr
+				Melbourne  FL  32904
+				US
+
+00-1D-3C   (hex)		Muscle Corporation
+001D3C     (base 16)		Muscle Corporation
+				2-5-35, Kikawa-higashi
+				Osaka    532-0012
+				JP
+
+00-1D-3A   (hex)		mh acoustics LLC
+001D3A     (base 16)		mh acoustics LLC
+				25A Summit Ave
+				Summit  NJ  07901
+				US
+
+00-1D-49   (hex)		Innovation Wireless Inc.
+001D49     (base 16)		Innovation Wireless Inc.
+				4F-1, NO.81, SHUEILI RD.
+				HSINCHU    30059
+				TW
+
+00-1D-46   (hex)		Cisco Systems, Inc
+001D46     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1D-48   (hex)		Sensor-Technik Wiedemann GmbH
+001D48     (base 16)		Sensor-Technik Wiedemann GmbH
+				Am Bärenwald 6
+				Kaufbeuren  Bayern  87600
+				DE
+
+00-1D-76   (hex)		Eyeheight Ltd.
+001D76     (base 16)		Eyeheight Ltd.
+				Unit 34, Park House
+				Watford  Herts  WD18 8PH
+				GB
+
+00-1D-7A   (hex)		Wideband Semiconductor, Inc.
+001D7A     (base 16)		Wideband Semiconductor, Inc.
+				1350 Pear Ave
+				Mountain View  CA  94043
+				US
+
+00-1D-68   (hex)		Thomson Telecom Belgium
+001D68     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-1D-26   (hex)		Rockridgesound Technology Co.
+001D26     (base 16)		Rockridgesound Technology Co.
+				Fumin Industrial Park, Houjie Town
+				Dong Guan  Guang Dong  523956
+				CN
+
+00-1D-35   (hex)		Viconics Electronics Inc.
+001D35     (base 16)		Viconics Electronics Inc.
+				9245 Langelier
+				Saint Leonard  Quebec  H1P3K9
+				CA
+
+00-1D-31   (hex)		HIGHPRO INTERNATIONAL R&D CO,.LTD.
+001D31     (base 16)		HIGHPRO INTERNATIONAL R&D CO,.LTD.
+				3F,No.295,RuiGuang Rd,Nei Hu,
+				Taipei    114
+				TW
+
+00-1D-61   (hex)		BIJ Corporation
+001D61     (base 16)		BIJ Corporation
+				7F Takamizawa Building,2-7-10,
+				Yokohama  Kanagawa  220-0004
+				JP
+
+00-1D-5C   (hex)		Tom Communication Industrial Co.,Ltd.
+001D5C     (base 16)		Tom Communication Industrial Co.,Ltd.
+				1173 Nippa-choh Kohoku-ku
+				Yokohama  Kanagawa  223-0057
+				JP
+
+00-1D-56   (hex)		Kramer Electronics Ltd.
+001D56     (base 16)		Kramer Electronics Ltd.
+				3 Am VeOlamo Street
+				Jerusalem    95463
+				IL
+
+00-1D-4E   (hex)		TCM Mobile LLC
+001D4E     (base 16)		TCM Mobile LLC
+				9218 Metcalf,
+				Overland Park  Kansas  66212
+				US
+
+00-1D-21   (hex)		Alcad SL
+001D21     (base 16)		Alcad SL
+				Pol. Ind. Arreche-Ugalde, 1
+				Irún  Guipúzcoa  E-20305
+				ES
+
+00-1D-1C   (hex)		Gennet s.a.
+001D1C     (base 16)		Gennet s.a.
+				2 Mesogeion ave.
+				Athens  Attiki  11527
+				GR
+
+00-1C-E1   (hex)		INDRA SISTEMAS, S.A.
+001CE1     (base 16)		INDRA SISTEMAS, S.A.
+				Ctra. de Loeches, n.º 9
+				Torrejón de Ardoz  MADRID  28850
+				ES
+
+00-1C-E0   (hex)		DASAN TPS
+001CE0     (base 16)		DASAN TPS
+				HUMAX Village 6F, 11-4 Sunae-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-825
+				KR
+
+00-1C-D9   (hex)		GlobalTop Technology Inc.
+001CD9     (base 16)		GlobalTop Technology Inc.
+				16 Nan-ke 9th Rd. Science-base Industrial Park,
+				ShanHua  Tainan county  741
+				TW
+
+00-1C-DA   (hex)		Exegin Technologies Limited
+001CDA     (base 16)		Exegin Technologies Limited
+				401 - 2071 Kingsway Avenue
+				Port Coquitlam  BC  V3C 6N2
+				CA
+
+00-1C-D2   (hex)		King Champion (Hong Kong) Limited
+001CD2     (base 16)		King Champion (Hong Kong) Limited
+				Unit 1520, 15/F, Phase 1, Metro Centre,
+				Kowloon    
+				HK
+
+00-1C-A6   (hex)		Win4NET
+001CA6     (base 16)		Win4NET
+				1301 KOLON Digital Tower,
+				Kuro-gu  Seoul  152-848
+				KR
+
+00-1C-A9   (hex)		Audiomatica Srl
+001CA9     (base 16)		Audiomatica Srl
+				Via Manfredi 12
+				Florence  Italy  50136
+				IT
+
+00-1C-A1   (hex)		AKAMAI TECHNOLOGIES, INC.
+001CA1     (base 16)		AKAMAI TECHNOLOGIES, INC.
+				8 CAMBRIDGE CENTER
+				CAMBRIDGE  MA  02142
+				US
+
+00-1C-99   (hex)		Shunra Software Ltd.
+001C99     (base 16)		Shunra Software Ltd.
+				20 Hata'as St.
+				Kefar-Saba    44425
+				IL
+
+00-1C-F9   (hex)		Cisco Systems, Inc
+001CF9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-F1   (hex)		SUPoX Technology Co. , LTD.
+001CF1     (base 16)		SUPoX Technology Co. , LTD.
+				7F, 419 , Chung San Rd. , Sec 2
+				Chung Ho  Taipei Hsien  235
+				TW
+
+00-1C-CE   (hex)		By Techdesign
+001CCE     (base 16)		By Techdesign
+				C/ Tomas Edison 5
+				Arganda del Rey  Madrid  28500
+				ES
+
+00-1C-F3   (hex)		EVS BROADCAST EQUIPMENT
+001CF3     (base 16)		EVS BROADCAST EQUIPMENT
+				Liege Science Park
+				Ougree  Liege  4102
+				BE
+
+00-1C-F4   (hex)		Media Technology Systems Inc
+001CF4     (base 16)		Media Technology Systems Inc
+				766 Lakefield Road
+				Westlake Village  CA  91377
+				US
+
+00-1C-E6   (hex)		INNES
+001CE6     (base 16)		INNES
+				80 avenue des Buttes de Coësmes
+				RENNES    35700
+				FR
+
+00-1C-B9   (hex)		KWANG SUNG ELECTRONICS CO., LTD.
+001CB9     (base 16)		KWANG SUNG ELECTRONICS CO., LTD.
+				201, WORLD VENTURE TOWN 60-24, GASAN-DONG GEUMCHUN-GU,
+				SEOUL    153-801
+				KR
+
+00-1D-03   (hex)		Design Solutions Inc.
+001D03     (base 16)		Design Solutions Inc.
+				81 David Love Place
+				Goleta  Ca  93117
+				US
+
+00-1C-A3   (hex)		Terra
+001CA3     (base 16)		Terra
+				Draugystes str. 22
+				Kaunas    LT-51256
+				LT
+
+00-1C-90   (hex)		Empacket Corporation
+001C90     (base 16)		Empacket Corporation
+				2-6-3 Nishi-Gotanda
+				Shinagawa  Tokyo  141-0031
+				JP
+
+00-1C-8E   (hex)		Alcatel-Lucent IPD
+001C8E     (base 16)		Alcatel-Lucent IPD
+				701 E. Middlefield Rd.
+				Mountain View  CA  94043
+				US
+
+00-1C-8F   (hex)		Advanced Electronic Design, Inc.
+001C8F     (base 16)		Advanced Electronic Design, Inc.
+				344 John L Dietsch Blvd., Unit #2
+				North Attleboro  MA  02763
+				US
+
+00-1C-88   (hex)		TRANSYSTEM INC.
+001C88     (base 16)		TRANSYSTEM INC.
+				No. 1-2, Li-Hsin Rd 1, Science-Based Industrial Park
+				Hsinchu    300
+				TW
+
+00-1C-86   (hex)		Cranite Systems, Inc.
+001C86     (base 16)		Cranite Systems, Inc.
+				121 Albright Way
+				Los Gatos  CA  95032
+				US
+
+00-1C-4F   (hex)		MACAB AB
+001C4F     (base 16)		MACAB AB
+				Vannhögsgatan 7
+				Trelleborg    23166
+				SE
+
+00-1C-4E   (hex)		TASA International Limited
+001C4E     (base 16)		TASA International Limited
+				5F£¬Building2£¬No.1295 ,Xin Jinqiao Road,
+				Shanghai    201206
+				CN
+
+00-1C-4B   (hex)		Gener8, Inc.
+001C4B     (base 16)		Gener8, Inc.
+				897 Independence Ave
+				Mountain View  CA  94043
+				US
+
+00-1C-9B   (hex)		FEIG ELECTRONIC GmbH
+001C9B     (base 16)		FEIG ELECTRONIC GmbH
+				Lange Straße 4
+				Weilburg  Hessen  35781
+				DE
+
+00-1C-95   (hex)		Opticomm Corporation
+001C95     (base 16)		Opticomm Corporation
+				6827 Nancy Ridge Dr
+				San Diego  CA  92121
+				US
+
+00-1C-97   (hex)		Enzytek Technology Inc.,
+001C97     (base 16)		Enzytek Technology Inc.,
+				7F, No.35, Hsueh Fu Rd.,
+				Hsinchu    300,
+				TW
+
+00-1C-70   (hex)		NOVACOMM LTDA
+001C70     (base 16)		NOVACOMM LTDA
+				RUA BEIJUI, 70
+				São Paulo    04689-000
+				BR
+
+00-1C-6E   (hex)		Newbury Networks, Inc.
+001C6E     (base 16)		Newbury Networks, Inc.
+				419 Boylston Street
+				Boston  MA  02116
+				US
+
+00-1C-6B   (hex)		COVAX  Co. Ltd
+001C6B     (base 16)		COVAX  Co. Ltd
+				3-27-22 kitahanada-cho kitaku
+				sakai-shi  oosaka  591-8002
+				JP
+
+00-1C-69   (hex)		Packet Vision Ltd
+001C69     (base 16)		Packet Vision Ltd
+				SC House
+				Maidenhead  Berks  SL6 4UB
+				GB
+
+00-1C-3D   (hex)		WaveStorm
+001C3D     (base 16)		WaveStorm
+				Rue d'Oradour-sur-Glâne
+				Paris  ÃŽle-de-France  75015
+				FR
+
+00-1C-7F   (hex)		Check Point Software Technologies
+001C7F     (base 16)		Check Point Software Technologies
+				3A Jabotinsky St.
+				Ramat Gan    52520
+				IL
+
+00-1C-78   (hex)		WYPLAY SAS
+001C78     (base 16)		WYPLAY SAS
+				200 avenue de Provence
+				ALLAUCH  BdR  13190
+				FR
+
+00-1C-58   (hex)		Cisco Systems, Inc
+001C58     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-5A   (hex)		Advanced Relay Corporation
+001C5A     (base 16)		Advanced Relay Corporation
+				1896 Columbia St
+				Eugene  OR  97403
+				US
+
+00-1C-65   (hex)		JoeScan, Inc.
+001C65     (base 16)		JoeScan, Inc.
+				4510 NE 68th Dr, Ste. 124
+				Vancouver  WA  98661
+				US
+
+00-1C-5F   (hex)		Winland Electronics, Inc.
+001C5F     (base 16)		Winland Electronics, Inc.
+				1950 Excel Drive
+				Mankato  MN  56001
+				US
+
+00-1C-40   (hex)		VDG-Security bv
+001C40     (base 16)		VDG-Security bv
+				Radonstraat 10-14
+				Zoetermeer  ZH  2718 TA
+				NL
+
+00-1C-3A   (hex)		Element Labs, Inc.
+001C3A     (base 16)		Element Labs, Inc.
+				3350 Scott Boulevard
+				Santa Clara  CA  95054
+				US
+
+00-1C-18   (hex)		Sicert S.r.L.
+001C18     (base 16)		Sicert S.r.L.
+				Via Bernardino Alimena, 128
+				Rome    00173
+				IT
+
+00-1C-1A   (hex)		Thomas Instrumentation, Inc
+001C1A     (base 16)		Thomas Instrumentation, Inc
+				133 Landing Rd
+				Cape May Court House  NJ  08210
+				US
+
+00-1C-0E   (hex)		Cisco Systems, Inc
+001C0E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-13   (hex)		OPTSYS TECHNOLOGY CO., LTD.
+001C13     (base 16)		OPTSYS TECHNOLOGY CO., LTD.
+				SUITE B-802 BUNDANG TECHNO PARK
+				SEONGNAM-SI  GYEONGGI-DO  463-760
+				KR
+
+00-1C-0B   (hex)		SmartAnt Telecom
+001C0B     (base 16)		SmartAnt Telecom
+				2F, No. 669, Sec. 4, Chung Hsing Rd., Chutung
+				Hsinchu    310
+				TW
+
+00-1B-D0   (hex)		IDENTEC SOLUTIONS
+001BD0     (base 16)		IDENTEC SOLUTIONS
+				Hertzstraße 10
+				Weinheim    69469
+				DE
+
+00-1B-CD   (hex)		DAVISCOMMS (S) PTE LTD
+001BCD     (base 16)		DAVISCOMMS (S) PTE LTD
+				Blk 70 Ubi Crescent #01-07
+				    408570
+				SG
+
+00-1B-CA   (hex)		Beijing Run Technology LTD. Company
+001BCA     (base 16)		Beijing Run Technology LTD. Company
+				4/F, Hangtian Technology Building
+				  Beijing  100037
+				CN
+
+00-1B-CC   (hex)		KINGTEK CCTV ALLIANCE CO., LTD.
+001BCC     (base 16)		KINGTEK CCTV ALLIANCE CO., LTD.
+				5F-3, NO. 106, SEC. 3, HSIN YI ROAD
+				TAIPEI    106
+				TW
+
+00-1B-F4   (hex)		KENWIN INDUSTRIAL(HK) LTD.
+001BF4     (base 16)		KENWIN INDUSTRIAL(HK) LTD.
+				RM.1512 15/F SHATIN GALLERIA
+				    
+				HK
+
+00-1B-F9   (hex)		Intellitect Water Ltd
+001BF9     (base 16)		Intellitect Water Ltd
+				Suite 19, Basepoint Business Centre
+				Christchurch  Dorset  BH23 ^NW
+				GB
+
+00-1B-FA   (hex)		G.i.N. mbH
+001BFA     (base 16)		G.i.N. mbH
+				Raiffeisenstraße 15
+				Griesheim  Hessen  64347
+				DE
+
+00-1B-F3   (hex)		TRANSRADIO SenderSysteme Berlin AG
+001BF3     (base 16)		TRANSRADIO SenderSysteme Berlin AG
+				Mertensstrasse 63
+				Berlin    13587
+				DE
+
+00-1C-21   (hex)		Nucsafe Inc.
+001C21     (base 16)		Nucsafe Inc.
+				601 Oak Ridge Turnpike
+				Oak Ridge  Tennessee  37830
+				US
+
+00-1C-1E   (hex)		emtrion GmbH
+001C1E     (base 16)		emtrion GmbH
+				Alter Schlachthof 45
+				Karlsruhe  Baden Wuerttemberg  76131
+				DE
+
+00-1B-DE   (hex)		Renkus-Heinz, Inc.
+001BDE     (base 16)		Renkus-Heinz, Inc.
+				19201 Cook St.
+				Foothill Ranch  CA  92610
+				US
+
+00-1B-DB   (hex)		Valeo VECS
+001BDB     (base 16)		Valeo VECS
+				2 Avenue Fernand Pouillon
+				CRETEIL  Ile de France  94042
+				FR
+
+00-1B-D8   (hex)		FLIR Systems Inc
+001BD8     (base 16)		FLIR Systems Inc
+				65 Challenger Road
+				Ridgefield Park  NJ  07660-2103
+				US
+
+00-1B-D4   (hex)		Cisco Systems, Inc
+001BD4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-2D   (hex)		FlexRadio Systems
+001C2D     (base 16)		FlexRadio Systems
+				8900 Marybank Dr.
+				Austin  TX  78750
+				US
+
+00-1C-2C   (hex)		Synapse
+001C2C     (base 16)		Synapse
+				132 Export Circle
+				Huntsville  AL  35806
+				US
+
+00-1C-08   (hex)		Echo360, Inc.
+001C08     (base 16)		Echo360, Inc.
+				11955 Freedom Drive
+				Reston  VA  20190
+				US
+
+00-1B-C8   (hex)		MIURA CO.,LTD
+001BC8     (base 16)		MIURA CO.,LTD
+				620-1,Nakanishisoto
+				Matsuyama  Ehime  799-2425
+				JP
+
+00-1B-C1   (hex)		HOLUX Technology, Inc.
+001BC1     (base 16)		HOLUX Technology, Inc.
+				1F, No. 30, R&D Rd. II,
+				Hsinchu    300
+				TW
+
+00-1B-BC   (hex)		Silver Peak Systems, Inc.
+001BBC     (base 16)		Silver Peak Systems, Inc.
+				471 El Camino Real
+				Santa Clara  CA  95050
+				US
+
+00-1B-73   (hex)		DTL Broadcast Ltd
+001B73     (base 16)		DTL Broadcast Ltd
+				Johnson's Estate
+				HAYES  Middlesex  UB3 3BA
+				GB
+
+00-1B-71   (hex)		Telular Corp.
+001B71     (base 16)		Telular Corp.
+				311 South Wacker Drive
+				Chicago  IL  60606
+				US
+
+00-1B-97   (hex)		Violin Technologies
+001B97     (base 16)		Violin Technologies
+				33 Wood Ave South
+				Iselin  NJ  08830
+				US
+
+00-1B-A8   (hex)		UBI&MOBI,.Inc
+001BA8     (base 16)		UBI&MOBI,.Inc
+				3F, Duido Bldg, #288-5, Yangjae-Dong
+				Seocho-Gu  Seoul  137-130
+				KR
+
+00-1B-81   (hex)		DATAQ Instruments, Inc.
+001B81     (base 16)		DATAQ Instruments, Inc.
+				241 Springside Drive
+				Akron  Ohio  44333
+				US
+
+00-1B-7D   (hex)		CXR Anderson Jacobson
+001B7D     (base 16)		CXR Anderson Jacobson
+				Rue de l'ornette
+				Abondant    28410
+				FR
+
+00-1B-79   (hex)		FAIVELEY TRANSPORT
+001B79     (base 16)		FAIVELEY TRANSPORT
+				ZI du bois de plante
+				LA VILLE AUX DAMES    37700
+				FR
+
+00-1B-65   (hex)		China Gridcom Co., Ltd
+001B65     (base 16)		China Gridcom Co., Ltd
+				21/F, Huaneng Building, No. 2068 Shennan Main Road
+				Shenzhen  Guangdong  0086
+				CN
+
+00-1B-88   (hex)		Divinet Access Technologies Ltd
+001B88     (base 16)		Divinet Access Technologies Ltd
+				4th Floor, Media Center,
+				Pune  Maharashtra  411007
+				IN
+
+00-1B-83   (hex)		Finsoft Ltd
+001B83     (base 16)		Finsoft Ltd
+				16-18 Hatton Garden
+				London    EC1N 8AT
+				GB
+
+00-1B-AB   (hex)		Telchemy, Incorporated
+001BAB     (base 16)		Telchemy, Incorporated
+				2905 Premiere Parkway
+				Duluth  GA  30097
+				US
+
+00-1B-AE   (hex)		Micro Control Systems, Inc
+001BAE     (base 16)		Micro Control Systems, Inc
+				5580 Enterprise Parkway
+				Fort Myers  Florida  33905
+				US
+
+00-1B-A0   (hex)		Awox
+001BA0     (base 16)		Awox
+				93, Place Pierre Duhem,
+				Montpellier  Herault  34000
+				FR
+
+00-1B-51   (hex)		Vector Technology Corp.
+001B51     (base 16)		Vector Technology Corp.
+				No.7, Lane12, Yajou Road.
+				Tucheng  Taipei  236
+				TW
+
+00-1B-54   (hex)		Cisco Systems, Inc
+001B54     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-4A   (hex)		W&W Communications, Inc.
+001B4A     (base 16)		W&W Communications, Inc.
+				2903 Bunker Hill Lane
+				Santa Clara  CA  95054
+				US
+
+00-1A-FA   (hex)		Welch Allyn, Inc.
+001AFA     (base 16)		Welch Allyn, Inc.
+				4619 Jordan Road
+				Skaneateles Falls  NY  13153-0187
+				US
+
+00-1A-F7   (hex)		dataschalt e+a GmbH
+001AF7     (base 16)		dataschalt e+a GmbH
+				An der Hülshorst 7-9
+				Lübeck    23568
+				DE
+
+00-1A-F3   (hex)		Samyoung Electronics
+001AF3     (base 16)		Samyoung Electronics
+				146-1, sangdaewon-dong, joongwon-gu
+				sungnam-shi  Gyunggi-do  462-807
+				KR
+
+00-1A-EF   (hex)		Loopcomm Technology, Inc.
+001AEF     (base 16)		Loopcomm Technology, Inc.
+				18F-1, No. 150, Jian Yi Rd.,
+				Chung-Ho City  Taipei Hsien  235
+				TW
+
+00-1A-EC   (hex)		Keumbee Electronics Co.,Ltd.
+001AEC     (base 16)		Keumbee Electronics Co.,Ltd.
+				3-26, Jangsang-dong, Sangrok-gu
+				Ansan-si  Kyungki-do  426-410
+				KR
+
+00-1B-44   (hex)		SanDisk Corporation
+001B44     (base 16)		SanDisk Corporation
+				601 McCarthy Boulevard
+				Milpitas  CA  95035
+				US
+
+00-1B-46   (hex)		Blueone Technology Co.,Ltd
+001B46     (base 16)		Blueone Technology Co.,Ltd
+				Room 309,3 Floor, 404 Building, ShangBu industrial
+				Shenzhen  Guangdong  518028
+				CN
+
+00-1B-40   (hex)		Network Automation mxc AB
+001B40     (base 16)		Network Automation mxc AB
+				Box 7294
+				Stockholm    10390
+				SE
+
+00-1B-42   (hex)		Wise & Blue
+001B42     (base 16)		Wise & Blue
+				#715-3 Anyang Megavalley
+				Anyang-Si  Gyunggi-Do  431-767
+				KR
+
+00-1B-35   (hex)		ChongQing JINOU Science & Technology Development CO.,Ltd
+001B35     (base 16)		ChongQing JINOU Science & Technology Development CO.,Ltd
+				Chuangyeyuan 208# Keyuan 3rd Road 106#
+				Chongqing    400030
+				CN
+
+00-1B-36   (hex)		Tsubata Engineering Co.,Ltd. (Head Office)
+001B36     (base 16)		Tsubata Engineering Co.,Ltd. (Head Office)
+				Koyanagi 1-2
+				Ibaraki  Osaka  567-0852
+				JP
+
+00-1B-39   (hex)		Proxicast
+001B39     (base 16)		Proxicast
+				312 Sunnyfield Drive
+				Glenshaw  PA  15116
+				US
+
+00-1B-3B   (hex)		Yi-Qing CO., LTD
+001B3B     (base 16)		Yi-Qing CO., LTD
+				310 ROOM,12F
+				TAIPEI    100
+				TW
+
+00-1B-20   (hex)		TPine Technology
+001B20     (base 16)		TPine Technology
+				3F, No.1, AN-I Rd,
+				Keelung    111
+				TW
+
+00-1B-22   (hex)		Palit Microsystems ( H.K.) Ltd.
+001B22     (base 16)		Palit Microsystems ( H.K.) Ltd.
+				Room 4-6,11F,Nan Fung Commercial Center
+				Kowloon    111
+				HK
+
+00-1B-1C   (hex)		Coherent
+001B1C     (base 16)		Coherent
+				1280 Blues Hills Ave.
+				Bloomfield  CT  06002
+				US
+
+00-1B-19   (hex)		IEEE I&M Society TC9
+001B19     (base 16)		IEEE I&M Society TC9
+				100 Bureau Dr., Mail Stop 8220
+				Gaithersburg  MD  20899-8220
+				US
+
+00-1B-64   (hex)		IsaacLandKorea Co., Ltd,
+001B64     (base 16)		IsaacLandKorea Co., Ltd,
+				Rm 608, Hangang-Hyundai-Hyel Bldg. 2-36,
+				Seoul    140-871
+				KR
+
+00-1B-26   (hex)		RON-Telecom ZAO
+001B26     (base 16)		RON-Telecom ZAO
+				15 A, Zarechnaya st.
+				Trehgorny  Chelyabinsk region  456080
+				RU
+
+00-1B-13   (hex)		Icron Technologies Corporation
+001B13     (base 16)		Icron Technologies Corporation
+				221 - 4664 Lougheed Highway
+				Burnaby  BC  V5C 5T5
+				CA
+
+00-1B-0F   (hex)		Petratec
+001B0F     (base 16)		Petratec
+				12 Derech HaSharon
+				Kfar Saba  Sharon  44271
+				IL
+
+00-1A-A9   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+001AA9     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building, Star-net Science Plaza, Juyuanzhou,
+				FUZHOU  FUJIAN  350002
+				CN
+
+00-1A-A8   (hex)		Mamiya Digital Imaging Co., Ltd.
+001AA8     (base 16)		Mamiya Digital Imaging Co., Ltd.
+				2-2, 1-chome, Koraku
+				Bunkyo-ku  Tokyo  112-0004
+				JP
+
+00-1A-99   (hex)		Smarty (HZ) Information Electronics Co., Ltd
+001A99     (base 16)		Smarty (HZ) Information Electronics Co., Ltd
+				Yonghua Industrial District,Huishen Road,Zhenlong Town
+				HuiZhou  GuangDong  516227
+				CN
+
+00-1A-A6   (hex)		Telefunken Radio Communication Systems GmbH &CO.KG
+001AA6     (base 16)		Telefunken Radio Communication Systems GmbH &CO.KG
+				Eberhard-Finckh-Strasse 55
+				Ulm  Baden-Wurttemberg  89075
+				DE
+
+00-1A-96   (hex)		ECLER S.A.
+001A96     (base 16)		ECLER S.A.
+				Motors 166-168
+				Barcelona    08038
+				ES
+
+00-1A-91   (hex)		FusionDynamic Ltd.
+001A91     (base 16)		FusionDynamic Ltd.
+				1 B.S.R. towers, 4-th floor
+				Ramat Gan    52573
+				IL
+
+00-1A-8C   (hex)		Sophos Ltd
+001A8C     (base 16)		Sophos Ltd
+				The Pentagon
+				Abingdon  Oxfordshire  OX14 3YP
+				GB
+
+00-1A-B3   (hex)		VISIONITE INC.
+001AB3     (base 16)		VISIONITE INC.
+				#707 Daeryung Technotown-2 569-21
+				Seoul    153-771
+				KR
+
+00-1A-CA   (hex)		Tilera Corporation
+001ACA     (base 16)		Tilera Corporation
+				1900 West Park Drive
+				Westborough  MA  01581
+				US
+
+00-1A-84   (hex)		V One Multimedia Pte Ltd
+001A84     (base 16)		V One Multimedia Pte Ltd
+				Blk 54, Kallang Bahru
+				    339336
+				SG
+
+00-1A-B9   (hex)		PMC
+001AB9     (base 16)		PMC
+				56, avenue Raspail
+				Saint Maur    94100
+				FR
+
+00-1A-BA   (hex)		Caton Overseas Limited
+001ABA     (base 16)		Caton Overseas Limited
+				Room 102, No. 101, Lane 91
+				Shanghai    200127
+				CN
+
+00-1A-D1   (hex)		FARGO CO., LTD.
+001AD1     (base 16)		FARGO CO., LTD.
+				4F. KYEMYUNG B/D
+				SEOUL    135 885
+				KR
+
+00-1A-3A   (hex)		Dongahelecomm
+001A3A     (base 16)		Dongahelecomm
+				678-3,Jeil-ri,Yanggi-myun,Cheoin-gu
+				Yongin-si  Gyeonggi-do  449-821
+				KR
+
+00-1A-3B   (hex)		Doah Elecom Inc.
+001A3B     (base 16)		Doah Elecom Inc.
+				8th fl. Century Plaza, 277-40
+				Seoul    133-123
+				KR
+
+00-1A-3C   (hex)		Technowave Ltd.
+001A3C     (base 16)		Technowave Ltd.
+				Sakurai Bldg.1F,
+				Musashino-shi  Tokyo  180-0006
+				JP
+
+00-1A-40   (hex)		A-FOUR TECH CO., LTD.
+001A40     (base 16)		A-FOUR TECH CO., LTD.
+				6F, No. 108, Min-Chuan Rd.,
+				Hsin-Tien  Taipei  23141
+				TW
+
+00-1A-30   (hex)		Cisco Systems, Inc
+001A30     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-7B   (hex)		Teleco, Inc.
+001A7B     (base 16)		Teleco, Inc.
+				430 Woodruff Rd.
+				Greenville  SC  29607
+				US
+
+00-1A-36   (hex)		Aipermon GmbH & Co. KG
+001A36     (base 16)		Aipermon GmbH & Co. KG
+				Zamdorfer Str. 100
+				Munich  Bavaria  D-81677
+				DE
+
+00-1A-26   (hex)		Deltanode Solutions AB
+001A26     (base 16)		Deltanode Solutions AB
+				Box 92 184
+				Stockholm    120 09
+				SE
+
+00-1A-6D   (hex)		Cisco Systems, Inc
+001A6D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-6E   (hex)		Impro Technologies
+001A6E     (base 16)		Impro Technologies
+				47B Gillits Rd
+				Pinetown  KwaZulu-Natal  3610
+				ZA
+
+00-1A-6C   (hex)		Cisco Systems, Inc
+001A6C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-4A   (hex)		Qumranet Inc.
+001A4A     (base 16)		Qumranet Inc.
+				530 Lakeside Drive
+				Sunnyvale  California  94085
+				US
+
+00-1A-3E   (hex)		Faster Technology LLC
+001A3E     (base 16)		Faster Technology LLC
+				1812 Avenue D
+				Katy  Texas  77493
+				US
+
+00-1A-63   (hex)		Elster Solutions, LLC,
+001A63     (base 16)		Elster Solutions, LLC,
+				208 South Rogers Lane
+				Raleigh  NC  27610
+				US
+
+00-1A-59   (hex)		Ircona
+001A59     (base 16)		Ircona
+				Unit 4B-1, Corporate Park
+				Blanchardstown  Dublin  15
+				IE
+
+00-1A-46   (hex)		Digital Multimedia Technology Co., Ltd
+001A46     (base 16)		Digital Multimedia Technology Co., Ltd
+				Doorim Bldg, 3rd Fl, 164-21 Poi-Dong,
+				Seoul  Kangnam-Gu  135-960
+				KR
+
+00-1A-25   (hex)		DELTA DORE
+001A25     (base 16)		DELTA DORE
+				BONNEMAIN
+				COMBOURG  BRETAGNE 35  35270
+				FR
+
+00-19-FE   (hex)		SHENZHEN SEECOMM TECHNOLOGY CO.,LTD.
+0019FE     (base 16)		SHENZHEN SEECOMM TECHNOLOGY CO.,LTD.
+				Room 609,404Yannan Road
+				ShenZhen  Guangdong  
+				CN
+
+00-19-FD   (hex)		Nintendo Co., Ltd.
+0019FD     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1A-0D   (hex)		HandHeld entertainment, Inc.
+001A0D     (base 16)		HandHeld entertainment, Inc.
+				539 Bryant Street, Suite 403
+				San Francisco  CA  94103
+				US
+
+00-1A-0E   (hex)		Cheng Uei Precision Industry Co.,Ltd
+001A0E     (base 16)		Cheng Uei Precision Industry Co.,Ltd
+				Junda Industry District, Dongkeng Town,Dongguan City
+				DongGuan  Guang Dong  523455
+				CN
+
+00-19-CD   (hex)		Chengdu ethercom information technology Ltd.
+0019CD     (base 16)		Chengdu ethercom information technology Ltd.
+				South Extension of Tianfu Wide Road No.7 department room 201
+				Chengdu  Sichuan  610041
+				CN
+
+00-19-D9   (hex)		Zeutschel GmbH
+0019D9     (base 16)		Zeutschel GmbH
+				Heerweg 2
+				Tübingen-Hirschau  BW  D-72070
+				DE
+
+00-1A-01   (hex)		Smiths Medical
+001A01     (base 16)		Smiths Medical
+				4350 Rivergreen Parkway
+				Duluth  GA  30096
+				US
+
+00-19-CA   (hex)		Broadata Communications, Inc
+0019CA     (base 16)		Broadata Communications, Inc
+				2545 W 237th St Ste K
+				Torrance  CA  90505
+				US
+
+00-19-D3   (hex)		TRAK Microwave
+0019D3     (base 16)		TRAK Microwave
+				4726 Eisenhower Blvd
+				Tampa  FL  33634
+				US
+
+00-19-C3   (hex)		Qualitrol
+0019C3     (base 16)		Qualitrol
+				Wildflower Way
+				Belfast  Co. Antrim  BT12 6TA
+				GB
+
+00-19-BE   (hex)		Altai Technologies Limited
+0019BE     (base 16)		Altai Technologies Limited
+				2/F, East Wing, Lakeside 2, 10 Science Park West Avenue,
+				Shatin  New Territories  
+				HK
+
+00-19-B4   (hex)		Intellio Ltd
+0019B4     (base 16)		Intellio Ltd
+				Gyarmat u. 99/B
+				Budapest    1147
+				HU
+
+00-19-BA   (hex)		Paradox Security Systems Ltd
+0019BA     (base 16)		Paradox Security Systems Ltd
+				780 Industrial Blvd
+				St-Eustache  Quebec  J7R 5V3
+				CA
+
+00-19-A1   (hex)		LG INFORMATION & COMM.
+0019A1     (base 16)		LG INFORMATION & COMM.
+				60-39,Kasan-dong,Kumchon-ku
+				Seoul    153-023
+				KR
+
+00-19-A8   (hex)		WiQuest Communications
+0019A8     (base 16)		WiQuest Communications
+				915 Enterprise Blvd.
+				Allen  Texas  75013
+				US
+
+00-19-ED   (hex)		Axesstel Inc.
+0019ED     (base 16)		Axesstel Inc.
+				6815 Flanders Sr.
+				San Diego  CA  92121
+				US
+
+00-19-F6   (hex)		Acconet (PTE) Ltd
+0019F6     (base 16)		Acconet (PTE) Ltd
+				No. 16 Ayer Rajah Crescent
+				Singapore    139965
+				SG
+
+00-1A-15   (hex)		gemalto e-Payment
+001A15     (base 16)		gemalto e-Payment
+				6 rue de la Verrerie
+				Meudon    92197
+				FR
+
+00-19-68   (hex)		Digital Video Networks(Shanghai) CO. LTD.
+001968     (base 16)		Digital Video Networks(Shanghai) CO. LTD.
+				9th Floor,Hechuan Building, No.1026 YiShan Rd
+				Shanghai    201103
+				CN
+
+00-19-7F   (hex)		PLANTRONICS, INC.
+00197F     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+00-19-7A   (hex)		MAZeT GmbH
+00197A     (base 16)		MAZeT GmbH
+				Goeschwitzer Str. 32
+				Jena    D-07745
+				DE
+
+00-19-78   (hex)		Datum Systems, Inc.
+001978     (base 16)		Datum Systems, Inc.
+				3666 Tiffani Ct.
+				Santa Cruz  CA  95065
+				US
+
+00-19-89   (hex)		Sonitrol Corporation
+001989     (base 16)		Sonitrol Corporation
+				1707 Orlando Central Pkwy.
+				Orlando  FL  32809
+				US
+
+00-19-8E   (hex)		Oticon A/S
+00198E     (base 16)		Oticon A/S
+				Kongebakken 9
+				Smørum    2765
+				DK
+
+00-19-80   (hex)		Gridpoint Systems
+001980     (base 16)		Gridpoint Systems
+				4043 Carling Avenue, Suite 200
+				Ottawa  Ontario  K2K 2A3
+				CA
+
+00-19-83   (hex)		CCT R&D Limited
+001983     (base 16)		CCT R&D Limited
+				18/F CCT Telecom Building
+				Fotan, Shatin  N.T.  000
+				HK
+
+00-19-4C   (hex)		Fujian Stelcom information & Technology CO.,Ltd
+00194C     (base 16)		Fujian Stelcom information & Technology CO.,Ltd
+				4F,Building A,Start Science Park, No.68,Hongshanyuan Rd
+				Fuzhou  Fujian  350002
+				CN
+
+00-19-4A   (hex)		TESTO AG
+00194A     (base 16)		TESTO AG
+				Testo Straße 1
+				Lenzkirch  Baden-Württemberg  79853
+				DE
+
+00-19-8A   (hex)		Northrop Grumman Systems Corp.
+00198A     (base 16)		Northrop Grumman Systems Corp.
+				7055 Troy Hill Drive
+				Elkridge  Maryland  21075
+				US
+
+00-19-60   (hex)		DoCoMo Systems, Inc.
+001960     (base 16)		DoCoMo Systems, Inc.
+				Meguro Techno Bldg. 2nd Floor
+				Shinagawa-ku  Tokyo  141-0031
+				JP
+
+00-19-5A   (hex)		Jenaer Antriebstechnik GmbH
+00195A     (base 16)		Jenaer Antriebstechnik GmbH
+				Buchaer Strasse 1
+				Jena  Thueringen  07745
+				DE
+
+00-19-6D   (hex)		Raybit Systems Korea, Inc
+00196D     (base 16)		Raybit Systems Korea, Inc
+				Dream Tower 1221
+				Seoul    158-718
+				KR
+
+00-19-70   (hex)		Z-Com, Inc.
+001970     (base 16)		Z-Com, Inc.
+				7F-2, NO.9, PROSPERITY 1ST RD.
+				HSINCHU    300
+				TW
+
+00-19-50   (hex)		Harman Multimedia
+001950     (base 16)		Harman Multimedia
+				8400 Balboa Blvd.
+				Northridge  CA  91329
+				US
+
+00-18-EE   (hex)		Videology Imaging Solutions, Inc.
+0018EE     (base 16)		Videology Imaging Solutions, Inc.
+				37 M Lark Industrial Parkway
+				Greenville  RI  02828-3001
+				US
+
+00-18-EB   (hex)		Blue Zen Enterprises Private Limited
+0018EB     (base 16)		Blue Zen Enterprises Private Limited
+				No 2&3 (First Floor) Kurban Ali Street
+				Chennai  Tamil Nadu  600002
+				IN
+
+00-19-24   (hex)		LBNL  Engineering
+001924     (base 16)		LBNL  Engineering
+				1 Cyclotron Rd.
+				Berkeley  CA  94720
+				US
+
+00-19-1A   (hex)		IRLINK
+00191A     (base 16)		IRLINK
+				HanYoung B/D 6F, 4-6
+				SEOUL    138-824
+				KR
+
+00-19-16   (hex)		PayTec AG
+001916     (base 16)		PayTec AG
+				Rosengartenstrasse 3
+				Zollikerberg  ZH  8125
+				CH
+
+00-19-0E   (hex)		Atech Technology Co., Ltd.
+00190E     (base 16)		Atech Technology Co., Ltd.
+				4 Fl., No. 103, Sec 2, Jiuzong Rd.
+				Taipei    114
+				TW
+
+00-19-39   (hex)		Gigamips
+001939     (base 16)		Gigamips
+				5th Floor, Yangjae Building, 261, Yangjae-Dong
+				Seocho-Gu  Seoul  137-130
+				KR
+
+00-19-3A   (hex)		OESOLUTIONS
+00193A     (base 16)		OESOLUTIONS
+				Technopark, 958-3 Daechon-Dong, Buk-Gu
+				Gwangju  Buk-Gu  500-706
+				KR
+
+00-18-E2   (hex)		Topdata Sistemas de Automacao Ltda
+0018E2     (base 16)		Topdata Sistemas de Automacao Ltda
+				Rua Dr Carvalho Chaves, 662
+				Curitiba  PR  80.220-010
+				BR
+
+00-19-22   (hex)		CM Comandos Lineares
+001922     (base 16)		CM Comandos Lineares
+				Av Eng Alberto de Zagottis, 760
+				São Paulo  SP  04675-085
+				BR
+
+00-19-1D   (hex)		Nintendo Co., Ltd.
+00191D     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-19-2F   (hex)		Cisco Systems, Inc
+00192F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-05   (hex)		SCHRACK Seconet AG
+001905     (base 16)		SCHRACK Seconet AG
+				Eibesbrunnergasse 18
+				Wien  Österreich  1122
+				AT
+
+00-19-07   (hex)		Cisco Systems, Inc
+001907     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-FB   (hex)		Compro Technology
+0018FB     (base 16)		Compro Technology
+				3/F No 12, Alley 6, Lane 45, Pao Shin Rd
+				Hsintien    231
+				TW
+
+00-18-C3   (hex)		CS Corporation
+0018C3     (base 16)		CS Corporation
+				CS-building, Pangyo seven venture valley 625
+				 Seongnam-si  Gyeonggi-do  463-400
+				KR
+
+00-18-CA   (hex)		Viprinet GmbH
+0018CA     (base 16)		Viprinet GmbH
+				Basilikastraße 3
+				Bingen am Rhein    55411
+				DE
+
+00-18-C7   (hex)		Real Time Automation
+0018C7     (base 16)		Real Time Automation
+				2825 N Mayfair Rd Ste 11
+				Wauwatosa  WI  53222
+				US
+
+00-18-BB   (hex)		Eliwell Controls srl
+0018BB     (base 16)		Eliwell Controls srl
+				Via dell'Industria, 15
+				Pieve d'Alpago  Belluno  32010
+				IT
+
+00-18-BF   (hex)		Essence Technology Solution, Inc.
+0018BF     (base 16)		Essence Technology Solution, Inc.
+				B1, No. 207, Beisin Rd., Sec. 3
+				Sindian, Taipei County    231
+				TW
+
+00-18-8C   (hex)		Mobile Action Technology Inc.
+00188C     (base 16)		Mobile Action Technology Inc.
+				5F, No. 205-3, Sec. 3, Beishin Rd.
+				Shindian City, Taipei    231
+				TW
+
+00-18-8F   (hex)		Montgomery Technology, Inc.
+00188F     (base 16)		Montgomery Technology, Inc.
+				800 East Commerce Street
+				Greenville  AL  36037
+				US
+
+00-18-84   (hex)		Fon Technology S.L.
+001884     (base 16)		Fon Technology S.L.
+				Avda. Bruselas, n. 7, Planta 3, Alcobendas
+				  Madrid  28100
+				ES
+
+00-18-80   (hex)		Maxim Integrated Products
+001880     (base 16)		Maxim Integrated Products
+				160 Rio Robles
+				San Jose  CA  95134
+				US
+
+00-18-D0   (hex)		AtRoad,  A Trimble Company
+0018D0     (base 16)		AtRoad,  A Trimble Company
+				47071 Bayside Parkway
+				Fremont  California  94538
+				US
+
+00-18-D2   (hex)		High-Gain Antennas LLC
+0018D2     (base 16)		High-Gain Antennas LLC
+				11679 S. Cormorant Circle
+				Parker  CO  80134
+				US
+
+00-18-D3   (hex)		TEAMCAST
+0018D3     (base 16)		TEAMCAST
+				Centre Espace Performance
+				Saint Gregoire    35769
+				FR
+
+00-18-C6   (hex)		OPW Fuel Management Systems
+0018C6     (base 16)		OPW Fuel Management Systems
+				6900 Santa Fe Drive
+				Hodgkins  Illinois  60525
+				US
+
+00-18-7C   (hex)		INTERCROSS, LLC
+00187C     (base 16)		INTERCROSS, LLC
+				Novoselov str., 58/7
+				Ryazan    390049
+				RU
+
+00-18-70   (hex)		E28 Shanghai Limited
+001870     (base 16)		E28 Shanghai Limited
+				2/F Eastern Tower
+				Shanghai    200001
+				CN
+
+00-18-72   (hex)		Expertise Engineering
+001872     (base 16)		Expertise Engineering
+				4186 Sorrento Valley Blvd Suite -J
+				San Diego  CA  92121
+				US
+
+00-18-DC   (hex)		Prostar Co., Ltd.
+0018DC     (base 16)		Prostar Co., Ltd.
+				A-703 Technotown, 250-3 Hagye-dong, Nowon-gu
+				Seoul    139-230
+				KR
+
+00-18-D1   (hex)		Siemens Home & Office Comm. Devices
+0018D1     (base 16)		Siemens Home & Office Comm. Devices
+				4849 Alpha Rd.
+				Dallas  Texas  75244
+				US
+
+00-18-AA   (hex)		Protec Fire Detection plc
+0018AA     (base 16)		Protec Fire Detection plc
+				Protec House
+				Nelson  Lancashire  BB9 6LQ
+				GB
+
+00-18-96   (hex)		Great Well Electronic LTD
+001896     (base 16)		Great Well Electronic LTD
+				The Third Industrial  Area
+				Shenzhen  Guangdong  518110
+				US
+
+00-18-90   (hex)		RadioCOM, s.r.o.
+001890     (base 16)		RadioCOM, s.r.o.
+				Misikova 22
+				Bratislava    811 06
+				SK
+
+00-18-B9   (hex)		Cisco Systems, Inc
+0018B9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-B8   (hex)		New Voice International AG
+0018B8     (base 16)		New Voice International AG
+				St. Gallerstrasse 8
+				Lachen  SZ  8853
+				CH
+
+00-18-A1   (hex)		Tiqit Computers, Inc.
+0018A1     (base 16)		Tiqit Computers, Inc.
+				2215 Old Page Mill Rd
+				Palo Alto  CA  94304
+				US
+
+00-18-12   (hex)		Beijing Xinwei Telecom Technology Co., Ltd.
+001812     (base 16)		Beijing Xinwei Telecom Technology Co., Ltd.
+				Xinwei Bldg., No. 7 Zhongguancun Software Park,
+				Haidian District  Beijing  100094
+				CN
+
+00-18-0B   (hex)		Brilliant Telecommunications
+00180B     (base 16)		Brilliant Telecommunications
+				307 Orchard City Dr.
+				Campbell  CA  95008
+				US
+
+00-18-61   (hex)		Ooma, Inc.
+001861     (base 16)		Ooma, Inc.
+				555 University Avenue
+				Palo Alto  CA  94301
+				US
+
+00-18-5B   (hex)		Network Chemistry, Inc
+00185B     (base 16)		Network Chemistry, Inc
+				1700 Seaport Blvd
+				Redwood City  CA  94063
+				US
+
+00-18-55   (hex)		Aeromaritime Systembau GmbH
+001855     (base 16)		Aeromaritime Systembau GmbH
+				Ludwig-Erhard-Str. 16
+				D-85375  Neufahrn  
+				DE
+
+00-18-51   (hex)		SWsoft
+001851     (base 16)		SWsoft
+				13755 Sunrise Valley Drive, Suite 600
+				Herndon  VA  20171
+				US
+
+00-18-74   (hex)		Cisco Systems, Inc
+001874     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-69   (hex)		KINGJIM
+001869     (base 16)		KINGJIM
+				No.10-18,2-Chome
+				Chiyoda-ku  Tokyo  101-0031
+				JP
+
+00-18-56   (hex)		EyeFi, Inc
+001856     (base 16)		EyeFi, Inc
+				149 Commonwealth Drive
+				Menlo Park  CA  94025
+				US
+
+00-18-4E   (hex)		Lianhe Technologies, Inc.
+00184E     (base 16)		Lianhe Technologies, Inc.
+				3F, #119, DaHu ShanZhuang St.
+				Neihu District  Taipei City  114
+				TW
+
+00-18-4C   (hex)		Bogen Communications
+00184C     (base 16)		Bogen Communications
+				50 Spring St.
+				Ramsey  NJ  07446
+				US
+
+00-18-26   (hex)		Cale Access AB
+001826     (base 16)		Cale Access AB
+				Box 1031
+				Kista    SE-164 21
+				SE
+
+00-18-2D   (hex)		Artec Design
+00182D     (base 16)		Artec Design
+				Teaduspargi 6/1
+				Tallinn    12618
+				EE
+
+00-18-2A   (hex)		Taiwan Video & Monitor
+00182A     (base 16)		Taiwan Video & Monitor
+				3F, 141 Jen Ai Rd Sec. 3
+				Taipei City    106
+				TW
+
+00-18-3B   (hex)		CENITS Co., Ltd.
+00183B     (base 16)		CENITS Co., Ltd.
+				3F, Yangjae Bldg., 264-3
+				Seoul    137-130
+				KR
+
+00-18-3C   (hex)		Encore Software Limited
+00183C     (base 16)		Encore Software Limited
+				6F Leo Complex
+				Bangalore  Karnataka  560025
+				IN
+
+00-18-41   (hex)		High Tech Computer Corp
+001841     (base 16)		High Tech Computer Corp
+				23 Hsin Hua Rd.
+				Taoyuan    330
+				TW
+
+00-18-19   (hex)		Cisco Systems, Inc
+001819     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-0C   (hex)		Optelian Access Networks
+00180C     (base 16)		Optelian Access Networks
+				22A-1051 Baxter Road
+				Ottawa  Ontario  K2C 3P2
+				CA
+
+00-18-10   (hex)		IPTrade S.A.
+001810     (base 16)		IPTrade S.A.
+				Parc Scientifique
+				Sart-Tilman  Wallonie  4031
+				BE
+
+00-18-09   (hex)		CRESYN
+001809     (base 16)		CRESYN
+				8-22,Jamwon-dong
+				Seoul  Seocho-Gu  #137-902
+				KR
+
+00-18-04   (hex)		E-TEK DIGITAL TECHNOLOGY LIMITED
+001804     (base 16)		E-TEK DIGITAL TECHNOLOGY LIMITED
+				UNIT1520,15/F.,TOWER 2,GRAND CENTURY PLACE,193 PRINCE EDWARD ROAD WEST,KOWLOON,
+				    
+				HK
+
+00-18-00   (hex)		UNIGRAND LTD
+001800     (base 16)		UNIGRAND LTD
+				7F-2, No.45, Jingde St., Jhonghe City,
+				    235
+				TW
+
+00-17-FD   (hex)		Amulet Hotkey
+0017FD     (base 16)		Amulet Hotkey
+				Cavalier Road
+				Heathfield  Devon  TQ12 6TQ
+				GB
+
+00-17-FC   (hex)		Suprema Inc.
+0017FC     (base 16)		Suprema Inc.
+				16F Parkview Office Tower,
+				Seongnam  Gyeonggi  463-863
+				KR
+
+00-17-FB   (hex)		FA
+0017FB     (base 16)		FA
+				628-7, Dungchon-Dong
+				Seoul  Kangseo-Ku  157-838
+				KR
+
+00-17-D8   (hex)		Magnum Semiconductor, Inc.
+0017D8     (base 16)		Magnum Semiconductor, Inc.
+				591 Yosemite Drive
+				Milpitas  CA  95035
+				US
+
+00-17-DA   (hex)		Spans Logic
+0017DA     (base 16)		Spans Logic
+				201 San Antonio Circle
+				Mountain View  CA  94040
+				US
+
+00-17-CF   (hex)		iMCA-GmbH
+0017CF     (base 16)		iMCA-GmbH
+				Dorfstrasse 28b
+				Itzehoe  Schleswig-Holstein  25524
+				DE
+
+00-17-B9   (hex)		Gambro Lundia AB
+0017B9     (base 16)		Gambro Lundia AB
+				BOX 10101
+				LUND  Skåne  22010
+				SE
+
+00-17-B3   (hex)		Aftek Infosys Limited
+0017B3     (base 16)		Aftek Infosys Limited
+				Pawan Complex
+				Pune  Maharashtra  411 038
+				IN
+
+00-17-A2   (hex)		Camrivox Ltd.
+0017A2     (base 16)		Camrivox Ltd.
+				The Jeffreys Building
+				Cambridge  Cambridgeshire  CB4 0WS
+				GB
+
+00-17-5F   (hex)		XENOLINK Communications Co., Ltd.
+00175F     (base 16)		XENOLINK Communications Co., Ltd.
+				2nd Fl., Jungyou B/D 797-22
+				Seoul    135-930
+				KR
+
+00-17-5C   (hex)		SHARP CORPORATION
+00175C     (base 16)		SHARP CORPORATION
+				1, Takumi-Cho,
+				Sakai city  Osaka Prefecture  590-8522
+				JP
+
+00-17-9D   (hex)		Kelman Limited
+00179D     (base 16)		Kelman Limited
+				Rathdown Close
+				Lisburn  Co. Antrim  BT28 2RB
+				GB
+
+00-17-90   (hex)		HYUNDAI DIGITECH Co, Ltd.
+001790     (base 16)		HYUNDAI DIGITECH Co, Ltd.
+				13th Fl, Choung-Jin Bldg, 53-5
+				Seoul    140-719
+				KR
+
+00-17-91   (hex)		LinTech GmbH
+001791     (base 16)		LinTech GmbH
+				Friedrich-Engels-Str. 35
+				Berlin    13156
+				DE
+
+00-17-95   (hex)		Cisco Systems, Inc
+001795     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-59   (hex)		Cisco Systems, Inc
+001759     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-54   (hex)		Arkino HiTOP Corporation Limited
+001754     (base 16)		Arkino HiTOP Corporation Limited
+				5F., No.437, Tao Ying Rd
+				Taoyuan City  Taoyuan County  33068,
+				TW
+
+00-17-52   (hex)		DAGS, Inc
+001752     (base 16)		DAGS, Inc
+				C-510, Woolim Lion's Valley, 371-28, Gasan Dong, Geumcheon Ku
+				Seoul    153-786
+				KR
+
+00-17-56   (hex)		Vinci Labs Oy
+001756     (base 16)		Vinci Labs Oy
+				Finlaysoninkuja 21 A
+				Tampere  Länsi-Suomi  33210
+				FI
+
+00-17-77   (hex)		Obsidian Research Corporation
+001777     (base 16)		Obsidian Research Corporation
+				120 - 4445 Calgary Trail NW
+				Edmonton  Alberta  T6H 5R7
+				CA
+
+00-17-6A   (hex)		Avago Technologies
+00176A     (base 16)		Avago Technologies
+				350 West Trimble Rd
+				San Jose  CA  95131
+				US
+
+00-17-86   (hex)		wisembed
+001786     (base 16)		wisembed
+				808, hansin IT tower, 235 guro3-dong, guro-gu
+				Seoul    152-768
+				KR
+
+00-17-82   (hex)		LoBenn Inc.
+001782     (base 16)		LoBenn Inc.
+				150 Katimavik Road
+				Ottawa  Ontario  K2L 2N2
+				CA
+
+00-17-78   (hex)		Central Music Co.
+001778     (base 16)		Central Music Co.
+				0711-0712 Tower D, SOHO New Town
+				Beijing    100022
+				CN
+
+00-17-6B   (hex)		Kiyon, Inc.
+00176B     (base 16)		Kiyon, Inc.
+				9381 Judicial Drive
+				San Diego  CA  92121
+				US
+
+00-17-99   (hex)		SmarTire Systems Inc.
+001799     (base 16)		SmarTire Systems Inc.
+				Suite 150
+				Richmond  BC  V6V 2J1
+				CA
+
+00-17-7F   (hex)		Worldsmart Retech
+00177F     (base 16)		Worldsmart Retech
+				23 Hi-Tech Court
+				Eight Mile Plains  QLD  4113
+				AU
+
+00-17-6E   (hex)		DUCATI SISTEMI
+00176E     (base 16)		DUCATI SISTEMI
+				VIA MARCO EMILIO LEPIDO, 182
+				BOLOGNA    40132
+				IT
+
+00-17-74   (hex)		Elesta GmbH
+001774     (base 16)		Elesta GmbH
+				Gottlieb Daimler Strasse 1
+				Konstanz    78467
+				DE
+
+00-17-0C   (hex)		Twig Com Ltd.
+00170C     (base 16)		Twig Com Ltd.
+				Meriniitynkatu 11
+				  Salo  2400
+				FI
+
+00-17-0D   (hex)		Dust Networks Inc.
+00170D     (base 16)		Dust Networks Inc.
+				30695 Huntwood Ave.
+				Hayward  Ca.  94544
+				US
+
+00-17-0B   (hex)		Contela, Inc.
+00170B     (base 16)		Contela, Inc.
+				6-8 Soonae-dong, Bundang-gu,
+				Sungnam  Kyunggi-do  463-825
+				KR
+
+00-17-0F   (hex)		Cisco Systems, Inc
+00170F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-04   (hex)		Shinco Electronics Group Co.,Ltd
+001704     (base 16)		Shinco Electronics Group Co.,Ltd
+				No.5 Waihuan Road
+				Changzhou  Jiangsu  213022
+				CN
+
+00-17-07   (hex)		InGrid, Inc
+001707     (base 16)		InGrid, Inc
+				920 Cassatt Rd
+				Berwyn  Pa  19312
+				US
+
+00-17-12   (hex)		ISCO International
+001712     (base 16)		ISCO International
+				1001 Cambridge Drive
+				Elk Grove Village  IL  60007
+				US
+
+00-16-D8   (hex)		Senea AB
+0016D8     (base 16)		Senea AB
+				Företagsallen 12
+				Åkersberga    18484
+				SE
+
+00-16-D6   (hex)		TDA Tech Pty Ltd
+0016D6     (base 16)		TDA Tech Pty Ltd
+				210 / 54 Currie Street
+				Adelaide  South Australia  5000
+				AU
+
+00-16-D5   (hex)		Synccom Co., Ltd
+0016D5     (base 16)		Synccom Co., Ltd
+				#306 Myungi e-space  218-20
+				Anyang-si  Kyungki-do  430-817
+				KR
+
+00-16-C9   (hex)		NAT Seattle, Inc.
+0016C9     (base 16)		NAT Seattle, Inc.
+				22125 17th Ave SE
+				Bothell  WA  98021
+				US
+
+00-16-C6   (hex)		North Atlantic Industries
+0016C6     (base 16)		North Atlantic Industries
+				170 Wilbur Place
+				Bohemia  NY  11716
+				US
+
+00-17-24   (hex)		Studer Professional Audio GmbH
+001724     (base 16)		Studer Professional Audio GmbH
+				Althardstrasse 30
+				Regensdorf  Zürich  CH-8105
+				CH
+
+00-17-02   (hex)		Osung Midicom Co., Ltd
+001702     (base 16)		Osung Midicom Co., Ltd
+				231-18, Dorim2-dong,
+				Seoul,  Youngdeungpo-gu  150-832
+				KR
+
+00-16-F7   (hex)		L-3 Communications, Aviation Recorders
+0016F7     (base 16)		L-3 Communications, Aviation Recorders
+				100 Cattlemen Rd.
+				Sarasota  FL  34232
+				US
+
+00-17-2D   (hex)		Axcen Photonics Corporation
+00172D     (base 16)		Axcen Photonics Corporation
+				6F, No. 119, Baujung Rd.,
+				Shindian City, Taipei    231
+				TW
+
+00-17-41   (hex)		DEFIDEV
+001741     (base 16)		DEFIDEV
+				20 rue Raymond Marcheron
+				Vanves    92170
+				FR
+
+00-17-38   (hex)		International Business Machines
+001738     (base 16)		International Business Machines
+				1 Azrieli Center
+				Tel Aviv    67021
+				IL
+
+00-17-1E   (hex)		Theo Benning GmbH & Co. KG
+00171E     (base 16)		Theo Benning GmbH & Co. KG
+				Muensterstraße 135-137
+				Bocholt  NRW  46397
+				DE
+
+00-16-D2   (hex)		Caspian
+0016D2     (base 16)		Caspian
+				170 Baytech Drive
+				San Jose  CA  95134
+				US
+
+00-16-A4   (hex)		Ezurio Ltd
+0016A4     (base 16)		Ezurio Ltd
+				Unit 2
+				London    NW9 5HD
+				GB
+
+00-16-99   (hex)		Tonic DVB Marketing Ltd
+001699     (base 16)		Tonic DVB Marketing Ltd
+				Unit B, 10/F, Summit Building,
+				Hung Hom  Kowloon  
+				HK
+
+00-16-9B   (hex)		Alstom Transport
+00169B     (base 16)		Alstom Transport
+				11, 13 avenue de Bel Air
+				Villeurbanne  Rhone  69100
+				FR
+
+00-16-90   (hex)		J-TEK INCORPORATION
+001690     (base 16)		J-TEK INCORPORATION
+				2F-1, No. 83, Sec. 2, GongDaoWu Rd.,
+				Hsinchu City    30070
+				TW
+
+00-16-93   (hex)		PowerLink Technology Inc.
+001693     (base 16)		PowerLink Technology Inc.
+				N0. 18, Alley 1, Lane 151, Sec. 1, Jhongsing Rd., Wugu Township
+				Taipei Hsien    248
+				TW
+
+00-16-98   (hex)		T&A Mobile Phones
+001698     (base 16)		T&A Mobile Phones
+				4/F, South Building,No.2966, Jinke Road
+				Pudong  Shanghai  201203
+				CN
+
+00-16-62   (hex)		Liyuh Technology Ltd.
+001662     (base 16)		Liyuh Technology Ltd.
+				4F, No.19, Ln.221, Ganqian Rd., Neihu District
+				Taipei    114
+				TW
+
+00-16-61   (hex)		Novatium Solutions (P) Ltd
+001661     (base 16)		Novatium Solutions (P) Ltd
+				3rd Floor, Temple Towers, #672
+				Chennai  Tamil Nadu  600035
+				IN
+
+00-16-64   (hex)		Prod-El SpA
+001664     (base 16)		Prod-El SpA
+				Via Palmanova 185
+				Milano  MI  20132
+				IT
+
+00-16-5E   (hex)		Precision I/O
+00165E     (base 16)		Precision I/O
+				4005 Miranda Ave., Suite 210
+				Palo Alto  CA  94304-1232
+				US
+
+00-16-58   (hex)		Fusiontech Technologies Inc.
+001658     (base 16)		Fusiontech Technologies Inc.
+				6F, No.78, Cheng Kung Rd., Sec. 1,
+				Taipei    115
+				TW
+
+00-16-A5   (hex)		Tandberg Storage ASA
+0016A5     (base 16)		Tandberg Storage ASA
+				Postboks 191
+				    
+				NO
+
+00-16-A1   (hex)		3Leaf Networks
+0016A1     (base 16)		3Leaf Networks
+				3255-1 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-16-66   (hex)		Quantier Communication Inc.
+001666     (base 16)		Quantier Communication Inc.
+				1F, No. 36, Industry E. Rd IV,
+				Hsin-Chu    300
+				TW
+
+00-16-81   (hex)		Vector Informatik GmbH
+001681     (base 16)		Vector Informatik GmbH
+				Ingersheimer Str. 24
+				Stuttgart  Baden-Württemberg  70499
+				DE
+
+00-BA-C0   (hex)		Biometric Access Company
+00BAC0     (base 16)		Biometric Access Company
+				2555 North IH 35
+				Round Rock  Texas  78664
+				US
+
+00-16-85   (hex)		Elisa Oyj
+001685     (base 16)		Elisa Oyj
+				Elektroniikkatie 4
+				90570  Oulu  
+				FI
+
+00-16-80   (hex)		Bally Gaming + Systems
+001680     (base 16)		Bally Gaming + Systems
+				950 Sandhill Road
+				Reno  NV  89521
+				US
+
+00-16-96   (hex)		QDI Technology (H.K.) Limited
+001696     (base 16)		QDI Technology (H.K.) Limited
+				16/F, Standard Chartered Bank Building 4-4A
+				Hong Kong    
+				CN
+
+00-16-BE   (hex)		INFRANET, Inc.
+0016BE     (base 16)		INFRANET, Inc.
+				8th Floor, Cowell B/D, 66-1
+				Seoul    137-040
+				KR
+
+00-16-AB   (hex)		Dansensor A/S
+0016AB     (base 16)		Dansensor A/S
+				Roennedevej 18
+				Ringsted    DK-4100
+				DK
+
+00-16-53   (hex)		LEGO System A/S IE Electronics Division
+001653     (base 16)		LEGO System A/S IE Electronics Division
+				Aastvej 1
+				  Billund Kommune  7190
+				DK
+
+00-16-52   (hex)		Hoatech Technologies, Inc.
+001652     (base 16)		Hoatech Technologies, Inc.
+				1F., No.224, Guosheng St.
+				Zhubei  HsinChu Hsien  30244
+				TW
+
+00-16-50   (hex)		 Kratos EPD    
+001650     (base 16)		 Kratos EPD    
+				Herley General Microwave Israel.
+				KIBBUTZ EYAL    45840
+				IL
+
+00-15-FA   (hex)		Cisco Systems, Inc
+0015FA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-FC   (hex)		Littelfuse Startco
+0015FC     (base 16)		Littelfuse Startco
+				3714 Kinnear Place
+				Saskatoon  SK  S7P 0A6
+				CA
+
+00-15-F7   (hex)		Wintecronics Ltd.
+0015F7     (base 16)		Wintecronics Ltd.
+				No. 716, 11F-3, Jung Jeng Rd.
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-16-30   (hex)		Vativ Technologies
+001630     (base 16)		Vativ Technologies
+				9339 Genesee Avenue
+				San Diego  CA  92121
+				US
+
+00-16-2F   (hex)		Geutebrück GmbH
+00162F     (base 16)		Geutebrück GmbH
+				Im Nassen 7-9
+				Windhagen    53578
+				DE
+
+00-16-2B   (hex)		Togami Electric Mfg.co.,Ltd.
+00162B     (base 16)		Togami Electric Mfg.co.,Ltd.
+				1-1 Ohtakara-Kitamachi
+				  Saga.PRF  840-0802
+				JP
+
+00-16-42   (hex)		Pangolin
+001642     (base 16)		Pangolin
+				9501 Satellite Boulevard, Suite 109
+				Orlando  FL  32837
+				US
+
+00-16-3B   (hex)		VertexRSI/General Dynamics
+00163B     (base 16)		VertexRSI/General Dynamics
+				2120 Old Gatesburg Rd.
+				State college  PA  16803
+				US
+
+00-16-37   (hex)		CITEL SpA
+001637     (base 16)		CITEL SpA
+				Via L. G. Columella, 36
+				Milan  MI  20128
+				IT
+
+00-16-08   (hex)		Sequans Communications
+001608     (base 16)		Sequans Communications
+				19 Le Parvis de la Défense
+				  PARIS LA DEFENSE CEDEX  92073
+				FR
+
+00-16-24   (hex)		Teneros, Inc.
+001624     (base 16)		Teneros, Inc.
+				215 Castro St.
+				Mt. View  CA  94041
+				US
+
+00-15-F8   (hex)		Kingtronics Industrial Co. Ltd.
+0015F8     (base 16)		Kingtronics Industrial Co. Ltd.
+				Penthouse, Century Centre,
+				Kowloon    
+				HK
+
+00-16-1C   (hex)		e:cue
+00161C     (base 16)		e:cue
+				Friedrich-List-Strasse 23
+				Paderborn    33100
+				DE
+
+00-15-B8   (hex)		Tahoe
+0015B8     (base 16)		Tahoe
+				ul. Uniwersytecka 1
+				Wroclaw    50951
+				PL
+
+00-15-B6   (hex)		ShinMaywa Industries, Ltd.
+0015B6     (base 16)		ShinMaywa Industries, Ltd.
+				1-1 Shinmeiwa-cho
+				Takarazuka  Hyogo  665-8550
+				JP
+
+00-15-B0   (hex)		AUTOTELENET CO.,LTD
+0015B0     (base 16)		AUTOTELENET CO.,LTD
+				2F, 898-24, Hogye2-dong, Dongan-gu
+				Anyang-City  Kyunggi-do  431-836
+				KR
+
+00-15-B1   (hex)		Ambient Corporation
+0015B1     (base 16)		Ambient Corporation
+				79 Chapel St.
+				Newton  MA  02458
+				US
+
+00-15-9F   (hex)		Terascala, Inc.
+00159F     (base 16)		Terascala, Inc.
+				145 Bodwell Street
+				Avon  MA  02322
+				US
+
+00-15-9E   (hex)		Mad Catz Interactive Inc
+00159E     (base 16)		Mad Catz Interactive Inc
+				Units 3+4 West Point Row
+				Bristol  South Gloucestershire  BS32 4QG
+				US
+
+00-15-A1   (hex)		ECA-SINTERS
+0015A1     (base 16)		ECA-SINTERS
+				5, rue Paul Mesplé
+				TOULOUSE  Cedex 01  31106
+				FR
+
+00-15-93   (hex)		U4EA Technologies Inc.
+001593     (base 16)		U4EA Technologies Inc.
+				48860 Milmont Drive
+				Fremont  CA  94538
+				US
+
+00-15-81   (hex)		MAKUS Inc.
+001581     (base 16)		MAKUS Inc.
+				4F Daedo Bldg. 748-14 Yeoksam-dong, Kangnam-gu
+				  Seoul  135-080
+				US
+
+00-15-7A   (hex)		Telefin S.p.A.
+00157A     (base 16)		Telefin S.p.A.
+				Via Albere 87/A
+				Verona  VR  37138
+				IT
+
+00-15-C3   (hex)		Ruf Telematik AG
+0015C3     (base 16)		Ruf Telematik AG
+				Ruetistrasse 13
+				Schlieren  ZH  8952
+				CH
+
+00-15-E6   (hex)		MOBILE TECHNIKA Inc.
+0015E6     (base 16)		MOBILE TECHNIKA Inc.
+				Sotobori Sky Bld. 5th Floor
+				Shinjuku-ku  Tokyo  162-0845
+				JP
+
+00-15-DB   (hex)		Canesta Inc.
+0015DB     (base 16)		Canesta Inc.
+				965 West Maude Avenue
+				Sunnyvale  California  94085
+				US
+
+00-15-8D   (hex)		Jennic Ltd
+00158D     (base 16)		Jennic Ltd
+				Furnival Street
+				Sheffield  Yorkshire  S1 4QT
+				US
+
+00-15-84   (hex)		Schenck Process GmbH
+001584     (base 16)		Schenck Process GmbH
+				Pallaswiesenstraße 100
+				Darmstadt  Hessen  64293
+				DE
+
+00-15-CC   (hex)		UQUEST, LTD.
+0015CC     (base 16)		UQUEST, LTD.
+				Sannomiya Intes Bldg. 8F
+				KOBE  HYOGO  651-0086
+				JP
+
+00-15-C6   (hex)		Cisco Systems, Inc
+0015C6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-D7   (hex)		Reti Corporation
+0015D7     (base 16)		Reti Corporation
+				6F,No 13, Lane 120, Sec 1, Neihu Rd.,
+				Taipei City    114
+				TW
+
+00-15-CB   (hex)		Surf Communication Solutions Ltd.
+0015CB     (base 16)		Surf Communication Solutions Ltd.
+				P.O. Box 343
+				Yokneam    20164
+				IL
+
+00-15-A7   (hex)		Robatech AG
+0015A7     (base 16)		Robatech AG
+				Pilatusring 10
+				Muri  AG  5630
+				CH
+
+00-15-23   (hex)		Meteor Communications Corporation
+001523     (base 16)		Meteor Communications Corporation
+				22614 66th Avenue South
+				Kent  WA  98032
+				US
+
+00-15-24   (hex)		Numatics, Inc.
+001524     (base 16)		Numatics, Inc.
+				46280 Dylan Dr.
+				Novi  Michigan  48377
+				US
+
+00-15-1B   (hex)		Isilon Systems Inc.
+00151B     (base 16)		Isilon Systems Inc.
+				3101 Western Avenue
+				Seattle  WA  98121
+				US
+
+00-15-73   (hex)		NewSoft  Technology Corporation
+001573     (base 16)		NewSoft  Technology Corporation
+				3F, 19-3, SanChong RD, NanKang,
+				Taipei    115
+				US
+
+00-15-75   (hex)		Nevis Networks Inc.
+001575     (base 16)		Nevis Networks Inc.
+				3945 Freedom Circle
+				Santa Clara  CA  95054
+				US
+
+00-15-6C   (hex)		SANE SYSTEM CO., LTD
+00156C     (base 16)		SANE SYSTEM CO., LTD
+				0-2 Heungan-daero 439 beon-gil Dongan-gu
+				Anyang-si  Kyunggi-do  431-804
+				KR
+
+00-15-6A   (hex)		DG2L Technologies Pvt. Ltd.
+00156A     (base 16)		DG2L Technologies Pvt. Ltd.
+				AML Center 1, Gnd. Floor, 8 Mahal Indl. Est.
+				Mumbai  Maharashtra  400093
+				IN
+
+00-15-29   (hex)		N3 Corporation
+001529     (base 16)		N3 Corporation
+				#402 GwangMyeong Techno Town
+				GyeongGi-Do    423-031
+				KR
+
+00-15-2D   (hex)		TenX Networks, LLC
+00152D     (base 16)		TenX Networks, LLC
+				4855 Wiley Post Way
+				Salt Lake City  UT  84116
+				US
+
+00-15-6F   (hex)		Xiranet Communications GmbH
+00156F     (base 16)		Xiranet Communications GmbH
+				Bertolt-Brecht-Allee 24
+				Dresden  Saxony  01309
+				US
+
+00-15-72   (hex)		Red-Lemon
+001572     (base 16)		Red-Lemon
+				Unit 4, 9/F, Paramount Building
+				Chai Wan    
+				HK
+
+00-15-67   (hex)		RADWIN Inc.
+001567     (base 16)		RADWIN Inc.
+				900 Corporate Drive
+				Mahwah  NJ  07430
+				US
+
+00-15-5B   (hex)		Sampo Corporation
+00155B     (base 16)		Sampo Corporation
+				216 Chung Shan Road,
+				  Taipei Hsien  220
+				TW
+
+00-15-53   (hex)		Cytyc Corporation
+001553     (base 16)		Cytyc Corporation
+				250 Campus Dive
+				Marlborough  MA  01752
+				US
+
+00-15-51   (hex)		RadioPulse Inc.
+001551     (base 16)		RadioPulse Inc.
+				2nd fl. Hans B/D, 111-55
+				Seoul    134-883
+				KR
+
+00-15-52   (hex)		Wi-Gear Inc.
+001552     (base 16)		Wi-Gear Inc.
+				340 Church Street
+				San Francisco  CA  94114
+				US
+
+00-15-3E   (hex)		Q-Matic Sweden AB
+00153E     (base 16)		Q-Matic Sweden AB
+				Neongatan 8
+				Molndal    431 53
+				SE
+
+00-15-42   (hex)		MICROHARD S.R.L.
+001542     (base 16)		MICROHARD S.R.L.
+				Via Primo Maggio 36
+				San Vittore Olona  Milano  20028
+				IT
+
+00-15-4E   (hex)		IEC
+00154E     (base 16)		IEC
+				3, rue de Varembé
+				CH - 1211  GENEVA  20
+				DE
+
+00-15-50   (hex)		Nits Technology Inc
+001550     (base 16)		Nits Technology Inc
+				2FL. No. 8 Alley 16, Lane 235, Bauchiau Rd.,
+				Shindian City  Taipei Hsien  231
+				TW
+
+00-15-46   (hex)		ITG Worldwide Sdn Bhd
+001546     (base 16)		ITG Worldwide Sdn Bhd
+				2, Jalan AstakaU8/83
+				Shah Alam  Selangor Darul Ehsan  40150
+				MY
+
+00-15-5D   (hex)		Microsoft Corporation
+00155D     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  WA  98052-8300
+				US
+
+00-15-62   (hex)		Cisco Systems, Inc
+001562     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-E1   (hex)		Data Display AG
+0014E1     (base 16)		Data Display AG
+				Industriestraße 1
+				Germering  Bayern  82110
+				DE
+
+00-14-E3   (hex)		mm-lab GmbH
+0014E3     (base 16)		mm-lab GmbH
+				Stammheimer Strasse 10
+				Kornwestheim    
+				DE
+
+00-14-D9   (hex)		IP Fabrics, Inc.
+0014D9     (base 16)		IP Fabrics, Inc.
+				3720 SW 141st Avenue 
+				Beaverton  Oregon  97006
+				US
+
+00-14-D6   (hex)		Jeongmin Electronics Co.,Ltd.
+0014D6     (base 16)		Jeongmin Electronics Co.,Ltd.
+				#710, Byuksan Digital Valley 2,
+				Seoul    153 783
+				KR
+
+00-14-F9   (hex)		Vantage Controls
+0014F9     (base 16)		Vantage Controls
+				1061 South 800 East
+				Orem  UT  84097
+				US
+
+00-14-E7   (hex)		Stolinx,. Inc
+0014E7     (base 16)		Stolinx,. Inc
+				3F Ohchang Bldg., 61 Yangjae-dong
+				Seoul    137-889
+				KR
+
+00-14-E9   (hex)		Nortech International
+0014E9     (base 16)		Nortech International
+				32A Wiganthorpe Road
+				Pietermartizburg  KwaZulu Natal  3201
+				ZA
+
+00-14-ED   (hex)		Airak, Inc.
+0014ED     (base 16)		Airak, Inc.
+				21641 Beaumeade Circle
+				Ashburn  Virginia  20147
+				US
+
+00-14-CE   (hex)		NF CORPORATION
+0014CE     (base 16)		NF CORPORATION
+				6-3-20, Tsunashima-higashi
+				Yokohama  Kanagawa  223-8508
+				JP
+
+00-14-D0   (hex)		BTI Systems Inc.
+0014D0     (base 16)		BTI Systems Inc.
+				50 Northside Road
+				Ottawa  Ontario  K2H 5Z6
+				CA
+
+00-15-03   (hex)		PROFIcomms s.r.o.
+001503     (base 16)		PROFIcomms s.r.o.
+				Turgenevova 5
+				Brno  EU/Europe  618 00
+				CZ
+
+00-15-09   (hex)		Plus Technology Co., Ltd
+001509     (base 16)		Plus Technology Co., Ltd
+				Office #205,  Gayang Techno-town,
+				  Seoul  157-810
+				KR
+
+00-14-F0   (hex)		Business Security OL AB
+0014F0     (base 16)		Business Security OL AB
+				Box 110 65
+				Lund    220 11
+				SE
+
+00-14-F2   (hex)		Cisco Systems, Inc
+0014F2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-10   (hex)		Techsphere Co., Ltd
+001510     (base 16)		Techsphere Co., Ltd
+				4F, Wonil Bldg., 980-54, Bangbae-dong, SeoCho-gu
+				  Seoul  137-060
+				KR
+
+00-15-13   (hex)		EFS sas
+001513     (base 16)		EFS sas
+				BP 34
+				MILLERY    F-69390
+				US
+
+00-14-8B   (hex)		Globo Electronic GmbH & Co. KG
+00148B     (base 16)		Globo Electronic GmbH & Co. KG
+				Industriestrasse 4a
+				Niederlauer  Bayern  97618
+				DE
+
+00-14-90   (hex)		ASP Corporation
+001490     (base 16)		ASP Corporation
+				465 Industrial Park Road
+				Hartwell  GA  30643
+				US
+
+00-14-84   (hex)		Cermate Technologies Inc.
+001484     (base 16)		Cermate Technologies Inc.
+				7F-1, No 168 Lien-Chen Rd.
+				Chung-Ho Dist  New Taipei City  
+				TW
+
+00-14-79   (hex)		NEC Magnus Communications,Ltd.
+001479     (base 16)		NEC Magnus Communications,Ltd.
+				 22-23, Kaigan 3-chome
+				Minato-ku  Tokyo  108-0022
+				JP
+
+00-14-7B   (hex)		Iteris, Inc.
+00147B     (base 16)		Iteris, Inc.
+				1515 S. Manchester Ave.
+				Anaheim  CA  92802
+				US
+
+00-14-BB   (hex)		Open Interface North America
+0014BB     (base 16)		Open Interface North America
+				506 2nd Avenue, Suite 420
+				Seattle  WA  98104
+				US
+
+00-14-70   (hex)		Prokom Software SA
+001470     (base 16)		Prokom Software SA
+				Al. Jerozolimskie 65/79
+				Warszawa  Mazowieckie  00-697
+				PL
+
+00-14-67   (hex)		ArrowSpan Inc.
+001467     (base 16)		ArrowSpan Inc.
+				4699 Old Ironsides Dr. Suite 100
+				Santa Clara  CA  95054
+				US
+
+00-14-5F   (hex)		ADITEC CO. LTD
+00145F     (base 16)		ADITEC CO. LTD
+				4F Hyowon B/D, 99-5,
+				  Seoul  138-805
+				KR
+
+00-14-88   (hex)		Akorri
+001488     (base 16)		Akorri
+				11 Falcon Ridge Dr
+				Hopkinton  MA  01748
+				US
+
+00-14-7A   (hex)		Eubus GmbH
+00147A     (base 16)		Eubus GmbH
+				Gollierstraße 70  Aufgang E  4.Stock
+				Munich  Bavaria  80339
+				DE
+
+00-14-6D   (hex)		RF Technologies
+00146D     (base 16)		RF Technologies
+				3125 N 126th Street
+				Brookfield  WI  53005
+				US
+
+00-14-AC   (hex)		Bountiful WiFi
+0014AC     (base 16)		Bountiful WiFi
+				707 West 700 South
+				Woods Cross  Utah  84087
+				US
+
+00-14-A8   (hex)		Cisco Systems, Inc
+0014A8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-A0   (hex)		Accsense, Inc.
+0014A0     (base 16)		Accsense, Inc.
+				460 Ward Drive
+				Santa Barbara  California  93111
+				US
+
+00-14-59   (hex)		Moram Co., Ltd.
+001459     (base 16)		Moram Co., Ltd.
+				3F, Manwol Bldg., 1022-4
+				Suwon-shi  Gyounggi-do  443-813
+				KR
+
+00-14-57   (hex)		T-VIPS AS
+001457     (base 16)		T-VIPS AS
+				Ostensjoveien 18
+				  Oslo  NO-0661
+				NO
+
+00-14-53   (hex)		ADVANTECH TECHNOLOGIES CO.,LTD
+001453     (base 16)		ADVANTECH TECHNOLOGIES CO.,LTD
+				#1202 ACE TECHNO TOWER, 684-1
+				  Seoul  157-721
+				KR
+
+00-14-54   (hex)		Symwave
+001454     (base 16)		Symwave
+				10251 Vista Sorrento Parkway
+				San Diego  CA  92121
+				US
+
+00-13-F8   (hex)		Dex Security Solutions
+0013F8     (base 16)		Dex Security Solutions
+				10 Junction Road Parktown
+				Johannesburg  Guteng  2000
+				ZA
+
+00-13-F9   (hex)		Cavera Systems
+0013F9     (base 16)		Cavera Systems
+				2355 Oakland Rd, Suite#33
+				San Jose  CA  95131
+				US
+
+00-13-F2   (hex)		Klas Ltd
+0013F2     (base 16)		Klas Ltd
+				Bracetown Business Park
+				Clonee  Co Meath  
+				IE
+
+00-13-F7   (hex)		SMC Networks, Inc.
+0013F7     (base 16)		SMC Networks, Inc.
+				38 Tesla
+				Irvine  CA  92618
+				US
+
+00-14-4B   (hex)		Hifn, Inc.
+00144B     (base 16)		Hifn, Inc.
+				750 University Ave
+				Los Gatos  CA  95032
+				US
+
+00-14-41   (hex)		Innovation Sound Technology Co., LTD.
+001441     (base 16)		Innovation Sound Technology Co., LTD.
+				Building 2th.,Cuihai Industrial Area,
+				Shenzhen  Guangdong  518103
+				CN
+
+00-14-3C   (hex)		Rheinmetall Canada Inc.
+00143C     (base 16)		Rheinmetall Canada Inc.
+				225 boul du seminaire sud
+				St-Jean-sur-Richelieu  Quebec  J3B 8E9
+				CA
+
+00-14-1A   (hex)		DEICY CORPORATION
+00141A     (base 16)		DEICY CORPORATION
+				3-3-6,Sakae-cho,Hamura-shi,
+				  Tokyo  205-0002
+				JP
+
+00-14-1C   (hex)		Cisco Systems, Inc
+00141C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-0C   (hex)		GKB CCTV CO., LTD.
+00140C     (base 16)		GKB CCTV CO., LTD.
+				7F, No. 1, Lane 641,
+				Ta Ya Hsiang,  TAICHUNG  428
+				TW
+
+00-13-FE   (hex)		GRANDTEC ELECTRONIC CORP.
+0013FE     (base 16)		GRANDTEC ELECTRONIC CORP.
+				8F,NO.268,Lian Cheng Rd.,Chung Ho City,
+				Taipei    235
+				TW
+
+00-14-35   (hex)		CityCom Corp.
+001435     (base 16)		CityCom Corp.
+				3F., No.532, Sec. 2,
+				Jhonghe City  Taipei Hsien  23557
+				TW
+
+00-14-48   (hex)		Inventec Multimedia & Telecom Corporation
+001448     (base 16)		Inventec Multimedia & Telecom Corporation
+				5F,NO.396,Sec.1 Nei-Hu Road
+				Taipei    114
+				TW
+
+00-14-16   (hex)		Scosche Industries, Inc.
+001416     (base 16)		Scosche Industries, Inc.
+				PO Box 2901
+				Oxnard  CA  93034
+				US
+
+00-14-26   (hex)		NL Technology
+001426     (base 16)		NL Technology
+				800 Turnpike Street
+				North Andover  MA  01845
+				US
+
+00-13-C5   (hex)		LIGHTRON FIBER-OPTIC DEVICES INC.
+0013C5     (base 16)		LIGHTRON FIBER-OPTIC DEVICES INC.
+				51-1 Moonpyung-Dong, Taeduck-Gu
+				  Taejon  306-220
+				KR
+
+00-13-C4   (hex)		Cisco Systems, Inc
+0013C4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-C2   (hex)		WACOM Co.,Ltd
+0013C2     (base 16)		WACOM Co.,Ltd
+				2-510-1 Toyonodai Otone-machi
+				Kitasaitama-gun  Saitama  349-1148
+				JP
+
+00-13-BF   (hex)		Media System Planning Corp.
+0013BF     (base 16)		Media System Planning Corp.
+				4F Velco-Kuromon Bldg.
+				Taito-ku,  Tokyo  110-0005
+				JP
+
+00-13-BB   (hex)		Smartvue Corporation
+0013BB     (base 16)		Smartvue Corporation
+				102 Woodmont Boulevard
+				Nashville  TN  37205
+				US
+
+00-13-B5   (hex)		Wavesat
+0013B5     (base 16)		Wavesat
+				1375, Trans-Canada Highway
+				Dorval  Quebec  H9P 2W8
+				CA
+
+00-13-AF   (hex)		NUMA Technology,Inc.
+0013AF     (base 16)		NUMA Technology,Inc.
+				4F,No778,Sec 4,Patch Rd.
+				Taipei    115
+				TW
+
+00-13-B0   (hex)		Jablotron
+0013B0     (base 16)		Jablotron
+				Pod Skalkou 33
+				Jablonec nad Nisou    46601
+				CZ
+
+00-13-9A   (hex)		K-ubique ID Corp.
+00139A     (base 16)		K-ubique ID Corp.
+				Yamasan Bldg.8F,
+				Chuo-ku  Tokyo  103-0023
+				JP
+
+00-13-9E   (hex)		Ciara Technologies Inc.
+00139E     (base 16)		Ciara Technologies Inc.
+				9300 Trans Canada Highway
+				Saint-Laurent  Quebec  H4S 1K5
+				CA
+
+00-13-9D   (hex)		MaxLinear Hispania S.L.U.
+00139D     (base 16)		MaxLinear Hispania S.L.U.
+				Ronda Narcis Monturiol 
+				Estarriol, 11D  Paterna  46980
+				ES
+
+00-13-D5   (hex)		RuggedCom
+0013D5     (base 16)		RuggedCom
+				300 Applewood Crescent (Unit 1)
+				Concord,   Ontario  L4K 5C7
+				CA
+
+00-13-D6   (hex)		TII NETWORK TECHNOLOGIES, INC.
+0013D6     (base 16)		TII NETWORK TECHNOLOGIES, INC.
+				1385 AKRON STREET
+				COPIAGUE  NY  11726
+				US
+
+00-13-DB   (hex)		SHOEI Electric Co.,Ltd
+0013DB     (base 16)		SHOEI Electric Co.,Ltd
+				1-29-2,Wakabayashi
+				Setagaya-ku  Tokyo  154-0023
+				JP
+
+00-13-CD   (hex)		MTI co. LTD
+0013CD     (base 16)		MTI co. LTD
+				166-10 Karak-dong
+				Songpa-ku  Seoul  138-810
+				KR
+
+00-13-D3   (hex)		MICRO-STAR INTERNATIONAL CO., LTD.
+0013D3     (base 16)		MICRO-STAR INTERNATIONAL CO., LTD.
+				NO. 69, LI-DE ST.
+				JUNG-HE CITY  TAIPEI HSIEN  235
+				TW
+
+00-13-CA   (hex)		Pico Digital
+0013CA     (base 16)		Pico Digital
+				6260 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-13-E6   (hex)		Technolution
+0013E6     (base 16)		Technolution
+				Zuidelijkhalfrond 1
+				GOUDA  ZH  2801 DD
+				NL
+
+00-13-DF   (hex)		Ryvor Corp.
+0013DF     (base 16)		Ryvor Corp.
+				15145 Red Hill Ave.
+				Tustin  CA  92780
+				US
+
+00-13-8D   (hex)		Kinghold
+00138D     (base 16)		Kinghold
+				11F, No. 965, Jungjeng Rd.
+				Junghe  Taipei  235
+				TW
+
+00-13-ED   (hex)		PSIA
+0013ED     (base 16)		PSIA
+				517-13 Induspis 5th
+				SungNam  KyungGi  
+				KR
+
+00-13-B1   (hex)		Intelligent Control Systems (Asia) Pte Ltd
+0013B1     (base 16)		Intelligent Control Systems (Asia) Pte Ltd
+				70 Ubi Crescent #01-12
+				    408570
+				SG
+
+00-13-3C   (hex)		QUINTRON SYSTEMS INC.
+00133C     (base 16)		QUINTRON SYSTEMS INC.
+				2105 SO. BLOSSER ROAD
+				SANTA MARIA  CALIFORNIA  93458
+				US
+
+00-13-3D   (hex)		Micro Memory Curtiss Wright Co
+00133D     (base 16)		Micro Memory Curtiss Wright Co
+				9540 Vassar Avenue
+				Chatsworth  CA  91311
+				US
+
+00-13-3F   (hex)		Eppendorf Instrumente GmbH
+00133F     (base 16)		Eppendorf Instrumente GmbH
+				Barkhausenweg 1
+				Hamburg  DE  22339
+				DE
+
+00-13-41   (hex)		Shandong New Beiyang Information Technology Co.,Ltd
+001341     (base 16)		Shandong New Beiyang Information Technology Co.,Ltd
+				NO.11 Xinwei Road
+				Weihai city  Shandong  264200
+				CN
+
+00-13-30   (hex)		EURO PROTECTION SURVEILLANCE
+001330     (base 16)		EURO PROTECTION SURVEILLANCE
+				30 Rue du Doubs
+				STRASBOURG    67100
+				FR
+
+00-13-25   (hex)		Cortina Systems Inc
+001325     (base 16)		Cortina Systems Inc
+				840 W California Ave, Suite 100
+				Sunnyvale  CA  94086
+				US
+
+00-13-31   (hex)		CellPoint Connect
+001331     (base 16)		CellPoint Connect
+				Billedvej 4
+				Copenhagen    2100
+				DK
+
+00-13-35   (hex)		VS Industry Berhad
+001335     (base 16)		VS Industry Berhad
+				Plo 47, Senai Ind. Est. II,
+				Senai  Johor  81400
+				MY
+
+00-13-2F   (hex)		Interactek
+00132F     (base 16)		Interactek
+				Sigmal 2 BLDG #C-319, 18 Kumi-dong
+				Seongnam  Kyung-gi  463-741
+				KR
+
+00-13-4C   (hex)		YDT Technology International
+00134C     (base 16)		YDT Technology International
+				2F., No.218, Rueiguang Rd.,
+				Taipei,    114
+				TW
+
+00-13-59   (hex)		ProTelevision Technologies A/S
+001359     (base 16)		ProTelevision Technologies A/S
+				Marielundvej 16,2
+				Herlev  Copenhagen  2730
+				DK
+
+00-13-50   (hex)		Silver Spring Networks, Inc
+001350     (base 16)		Silver Spring Networks, Inc
+				575 Broadway Street
+				Redwood City  CA  94063
+				US
+
+00-13-7F   (hex)		Cisco Systems, Inc
+00137F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-82   (hex)		Cetacea Networks Corporation
+001382     (base 16)		Cetacea Networks Corporation
+				3708 West 36th Avenue
+				Vancouver  British Columbia  V6N 2S4
+				CA
+
+00-13-90   (hex)		Termtek Computer Co., Ltd
+001390     (base 16)		Termtek Computer Co., Ltd
+				2F, No. 100, Li De St.,
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-13-75   (hex)		American Security Products Co.
+001375     (base 16)		American Security Products Co.
+				11925 Pacific ave.
+				Fontana  CA  92335
+				US
+
+00-13-58   (hex)		Realm Systems, Inc.
+001358     (base 16)		Realm Systems, Inc.
+				9350 South 535 East
+				Sandy  Utah  84070
+				US
+
+00-12-C1   (hex)		Check Point Software Technologies
+0012C1     (base 16)		Check Point Software Technologies
+				5 Ha'solelim St.
+				Tel Aviv    67897
+				IL
+
+00-12-BB   (hex)		Telecommunications Industry Association TR-41 Committee
+0012BB     (base 16)		Telecommunications Industry Association TR-41 Committee
+				2500 Wilson Blvd., Suite 300
+				Arlington  VA  22201
+				US
+
+00-12-B6   (hex)		Santa Barbara Infrared, Inc.
+0012B6     (base 16)		Santa Barbara Infrared, Inc.
+				30 S. Calle Cesar Chavez
+				Santa Barbara  CA  93103
+				US
+
+00-12-B9   (hex)		Fusion Digital Technology
+0012B9     (base 16)		Fusion Digital Technology
+				Victoria Mews, 23 Millfield Road
+				Bingley    BD16 1PY
+				GB
+
+00-12-ED   (hex)		AVG Advanced Technologies
+0012ED     (base 16)		AVG Advanced Technologies
+				4140 Utica Ridge Road
+				Bettendorf  IA  52722
+				US
+
+00-12-EA   (hex)		Trane
+0012EA     (base 16)		Trane
+				4833 White Bear Parkway
+				St. Paul  MN  55110
+				US
+
+00-12-E7   (hex)		Projectek Networking Electronics Corp.
+0012E7     (base 16)		Projectek Networking Electronics Corp.
+				5F-9, No. 16, Lane 609, Sec. 5, Chungshin Rd.,
+				Sanchung, Taipei    241
+				TW
+
+00-12-C3   (hex)		WIT S.A.
+0012C3     (base 16)		WIT S.A.
+				138 avenue Léon  Bérenger
+				Saint Laurent du Var  PACA  06700
+				FR
+
+00-12-C8   (hex)		Perfect tech
+0012C8     (base 16)		Perfect tech
+				3F,No.9,LANE175,NANKAN RD.,
+				LUJHU  TAOYUAN  338
+				TW
+
+00-12-C6   (hex)		TGC America, Inc
+0012C6     (base 16)		TGC America, Inc
+				2901 Tasman Drive, Suite 111
+				Santa Clara  CA  95054
+				US
+
+00-12-CC   (hex)		Bitatek CO., LTD
+0012CC     (base 16)		Bitatek CO., LTD
+				6F.,No 115,Wugong 3rd Rd
+				Wugu District  New Taipei City  248
+				TW
+
+00-12-FA   (hex)		THX LTD
+0012FA     (base 16)		THX LTD
+				5201 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+00-13-06   (hex)		Always On Wireless
+001306     (base 16)		Always On Wireless
+				3701 Kirby Dr
+				Houston  TX  77098
+				US
+
+00-12-FD   (hex)		OPTIMUS IC S.A.
+0012FD     (base 16)		OPTIMUS IC S.A.
+				NAWOJOWSKA 118
+				NOWY SACZ  MALOPOLSKA  33-300
+				PL
+
+00-13-05   (hex)		Epicom, Inc.
+001305     (base 16)		Epicom, Inc.
+				PO Box 24839
+				Oakland  CA  94623-1839
+				US
+
+00-12-E4   (hex)		ZIEHL industrie-electronik GmbH + Co KG
+0012E4     (base 16)		ZIEHL industrie-electronik GmbH + Co KG
+				Daimlerstraße 13
+				Schwaebisch Hall    74523
+				DE
+
+00-12-97   (hex)		O2Micro, Inc.
+001297     (base 16)		O2Micro, Inc.
+				3118 Patrick Henry Drive
+				Santa Clara  CA  95054
+				US
+
+00-12-9D   (hex)		First International Computer do Brasil
+00129D     (base 16)		First International Computer do Brasil
+				Rodovia BR 459
+				Santa Rita do Sapucaí  Minas Gerais  
+				BR
+
+00-12-9C   (hex)		Yulinet
+00129C     (base 16)		Yulinet
+				11F, Samhomoolsan B/D 275-6, Yangjae-dong
+				Seocho  Seoul  137-941
+				KR
+
+00-12-90   (hex)		KYOWA Electric & Machinery Corp.
+001290     (base 16)		KYOWA Electric & Machinery Corp.
+				4-8-16,Masuizumi
+				Kanazawa  Ishikawa  921-8025
+				JP
+
+00-12-91   (hex)		KWS Computersysteme GmbH
+001291     (base 16)		KWS Computersysteme GmbH
+				Carl Zeiss Str. 1
+				Ettlingen  BW  76275
+				DE
+
+00-12-95   (hex)		Aiware Inc.
+001295     (base 16)		Aiware Inc.
+				J-Tower 2F
+				Fuchu-shi  Tokyo  183-0044
+				JP
+
+00-12-8B   (hex)		Sensory Networks Inc
+00128B     (base 16)		Sensory Networks Inc
+				Level 6, 140 William St
+				East Sydney  NSW  2011
+				AU
+
+00-12-8F   (hex)		Montilio
+00128F     (base 16)		Montilio
+				1 maskit st.
+				Hertzelia    46763
+				IL
+
+00-12-A3   (hex)		Trust International B.V.
+0012A3     (base 16)		Trust International B.V.
+				Laan van Barcelona 600
+				Dordrecht  Zuid holland  3317 DD
+				NL
+
+00-12-A7   (hex)		ISR TECHNOLOGIES Inc
+0012A7     (base 16)		ISR TECHNOLOGIES Inc
+				1100, rue Notre-Dame Ouest
+				Montreal  Quebec  H3C 1K3
+				CA
+
+00-12-AA   (hex)		IEE, Inc.
+0012AA     (base 16)		IEE, Inc.
+				7740 Lemona Avenue
+				Van Nuys,  CA  91405
+				US
+
+00-12-9F   (hex)		RAE Systems
+00129F     (base 16)		RAE Systems
+				3775 North First Street
+				San Jose  CA  95134
+				US
+
+00-12-B5   (hex)		Vialta, Inc.
+0012B5     (base 16)		Vialta, Inc.
+				48461 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-12-B1   (hex)		Dai Nippon Printing Co., Ltd
+0012B1     (base 16)		Dai Nippon Printing Co., Ltd
+				2-8-21,Akabane-minami
+				Kita-ku  Tokyo  115-0044
+				JP
+
+00-12-89   (hex)		Advance Sterilization Products
+001289     (base 16)		Advance Sterilization Products
+				33 Technology Drive
+				Irvine  California  92618
+				US
+
+00-12-84   (hex)		Lab33 Srl
+001284     (base 16)		Lab33 Srl
+				C.so F. Perrone 24
+				Genoa  GE  16152
+				IT
+
+00-12-81   (hex)		March Networks S.p.A.
+001281     (base 16)		March Networks S.p.A.
+				Via Dei Lavoratori Autobianchi n. 1,
+				Desio  Milano  20033
+				IT
+
+00-12-7E   (hex)		Digital Lifestyles Group, Inc.
+00127E     (base 16)		Digital Lifestyles Group, Inc.
+				801 South Sentous Ave.
+				City of Industry  CA  91748
+				US
+
+00-12-6B   (hex)		Ascalade Communications Limited
+00126B     (base 16)		Ascalade Communications Limited
+				Unit 10-11, 35/F, Cable TV Tower,
+				    
+				HK
+
+00-12-33   (hex)		JRC TOKKI Co.,Ltd.
+001233     (base 16)		JRC TOKKI Co.,Ltd.
+				3-2-1 Shinyoshidahigashi Kohoku-ku
+				Yokohama  Kanagawa  223-8572
+				JP
+
+00-12-5B   (hex)		KAIMEI ELECTRONI
+00125B     (base 16)		KAIMEI ELECTRONI
+				14-3F, NO.81,SEC. 1,HSIN-TAI-WU ROAD,HSICHIH,
+				TAIPEI HSIEN  HSICHIH  221
+				TW
+
+00-12-59   (hex)		THERMO ELECTRON KARLSRUHE
+001259     (base 16)		THERMO ELECTRON KARLSRUHE
+				DIESELSTRAßE 4
+				KARLSRUHE  Baden-Württemberg  76227
+				DE
+
+00-12-5A   (hex)		Microsoft Corporation
+00125A     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+00-12-3D   (hex)		GES Co, Ltd
+00123D     (base 16)		GES Co, Ltd
+				 Room 710, Bundang Technopark, 700
+				Gyeonggi-Do    463-400
+				KR
+
+00-12-39   (hex)		S Net Systems Inc.
+001239     (base 16)		S Net Systems Inc.
+				10F Sungwon Bldg. Samsung-dong
+				Seoul    135-090
+				KR
+
+00-12-2F   (hex)		Sanei Electric Inc.
+00122F     (base 16)		Sanei Electric Inc.
+				5F Taisou-Ikebukuro Bldg.
+				Toshima-ku  Tokyo  171-0014
+				JP
+
+00-12-30   (hex)		Picaso Infocommunication CO., LTD.
+001230     (base 16)		Picaso Infocommunication CO., LTD.
+				3F, Suntechcity, Sangdaewon 1-dong,
+				Sungnam-city  Kyunggi-do  462-725
+				KR
+
+00-12-46   (hex)		T.O.M TECHNOLOGY INC..
+001246     (base 16)		T.O.M TECHNOLOGY INC..
+				906 Woolim E-biz Center 2,
+				Seoul  Guro-Gu  184-1
+				KR
+
+00-12-56   (hex)		LG INFORMATION & COMM.
+001256     (base 16)		LG INFORMATION & COMM.
+				459-9,KASAN-DONG,KUMCHON-GU,
+				SEOUL    153-023
+				KR
+
+00-12-14   (hex)		Koenig & Bauer AG
+001214     (base 16)		Koenig & Bauer AG
+				Friedrich-Koenig-Str. 4
+				Wuerzburg  Bavaria  97080
+				DE
+
+00-12-0F   (hex)		IEEE 802.3
+00120F     (base 16)		IEEE 802.3
+				
+				Oban     PA34 5EJ
+				GB
+
+00-12-1D   (hex)		Netfabric Corporation
+00121D     (base 16)		Netfabric Corporation
+				67 Federal Road
+				Brookfield  CT  06804
+				US
+
+00-12-0C   (hex)		CE-Infosys Pte Ltd
+00120C     (base 16)		CE-Infosys Pte Ltd
+				390 Havelock Road
+				    169662
+				SG
+
+00-11-B3   (hex)		YOSHIMIYA CO.,LTD.
+0011B3     (base 16)		YOSHIMIYA CO.,LTD.
+				2-3-24 Bainan
+				OSAKA  OSAKA-Pref  557-0033
+				JP
+
+00-11-B6   (hex)		Open Systems International
+0011B6     (base 16)		Open Systems International
+				4101 Arrowhead Drive
+				Medina  MN  55340
+				US
+
+00-11-B0   (hex)		Fortelink Inc.
+0011B0     (base 16)		Fortelink Inc.
+				42501 Albrae street suite 202
+				Fremont  CA  94538
+				US
+
+00-11-AC   (hex)		Simtec Electronics
+0011AC     (base 16)		Simtec Electronics
+				Avondale Drive
+				Tarleton  Lancashire  PR4 6AX
+				GB
+
+00-11-AD   (hex)		Shanghai Ruijie Technology
+0011AD     (base 16)		Shanghai Ruijie Technology
+				27F, 420 Jiangning Rd.
+				Shanghai    200041
+				CN
+
+00-11-CD   (hex)		Axsun Technologies
+0011CD     (base 16)		Axsun Technologies
+				1 Fortune Drive
+				Billerica  MA  02460
+				US
+
+00-11-C5   (hex)		TEN Technology
+0011C5     (base 16)		TEN Technology
+				555 East Ocean Blvd.
+				Long Beach  CA  90802
+				US
+
+00-11-BE   (hex)		AGP Telecom Co. Ltd
+0011BE     (base 16)		AGP Telecom Co. Ltd
+				9F, 134 Chung-Hsiao E. RD
+				Taipei    106
+				TW
+
+00-11-BA   (hex)		Elexol Pty Ltd
+0011BA     (base 16)		Elexol Pty Ltd
+				Level 2 / 146 Bundall Road
+				Bundall  Queensland  4217
+				AU
+
+00-11-BC   (hex)		Cisco Systems, Inc
+0011BC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-A8   (hex)		Quest Technologies
+0011A8     (base 16)		Quest Technologies
+				1060 Corporate Center Drive
+				Oconomowoc  Wisconsin  53066
+				US
+
+00-11-A1   (hex)		VISION NETWARE CO.,LTD
+0011A1     (base 16)		VISION NETWARE CO.,LTD
+				Ace Twin Tower (2), #709
+				Seoul  Guro-Gu  152-050
+				KR
+
+00-11-E2   (hex)		Hua Jung Components Co., Ltd.
+0011E2     (base 16)		Hua Jung Components Co., Ltd.
+				5F, No.13, Lane 120, Sec.1, Nei Hu Road
+				Taipei    114
+				TW
+
+00-11-DA   (hex)		Vivaas Technology Inc.
+0011DA     (base 16)		Vivaas Technology Inc.
+				15F, No. 10, Sec 1, Pei-Hsin Rd.,
+				Hsin-Tien city  Taipei Hsien,  231
+				TW
+
+00-11-DD   (hex)		FROMUS TEC. Co., Ltd.
+0011DD     (base 16)		FROMUS TEC. Co., Ltd.
+				2F 896-8 Hogye2-dong Dongan-Gu
+				    431-836
+				KR
+
+00-11-EB   (hex)		Innovative Integration
+0011EB     (base 16)		Innovative Integration
+				2390A Ward Avenue
+				Simi Valley  CA  93065
+				US
+
+00-11-EA   (hex)		IWICS Inc.
+0011EA     (base 16)		IWICS Inc.
+				19125 North Creek Parkway
+				Bothell  WA  98011
+				US
+
+00-11-E4   (hex)		Danelec Electronics A/S
+0011E4     (base 16)		Danelec Electronics A/S
+				Blokken 44
+				Birkeroed  Copenhagen  3460
+				DK
+
+00-11-E1   (hex)		Arcelik A.S
+0011E1     (base 16)		Arcelik A.S
+				Cumhuriyet Mah., E5 Yan Yol, No:1,
+				Istanbul    34520 
+				TR
+
+00-11-FB   (hex)		Heidelberg Engineering GmbH
+0011FB     (base 16)		Heidelberg Engineering GmbH
+				Tiergartenstraße 15
+				Heidelberg  Baden-Württemberg  69121
+				DE
+
+00-11-D6   (hex)		HandEra, Inc.
+0011D6     (base 16)		HandEra, Inc.
+				2859 104th St.
+				Des Moines  IA  50322
+				US
+
+00-11-CA   (hex)		Long Range Systems, Inc.
+0011CA     (base 16)		Long Range Systems, Inc.
+				4550 Excel Parkway
+				Addison  Texas  75001
+				US
+
+00-11-EF   (hex)		Conitec Datensysteme GmbH
+0011EF     (base 16)		Conitec Datensysteme GmbH
+				Dieselstraße 11c
+				Dieburg  Hessen  64807
+				DE
+
+00-11-4F   (hex)		US Digital Television, Inc
+00114F     (base 16)		US Digital Television, Inc
+				5807 N. Andrews Way
+				Fort Lauderdale  FL  33309
+				US
+
+00-11-82   (hex)		IMI Norgren Ltd
+001182     (base 16)		IMI Norgren Ltd
+				PO Box 22
+				Lichfield  Staffordshire  WS13 6SB
+				GB
+
+00-11-7A   (hex)		Singim International Corp.
+00117A     (base 16)		Singim International Corp.
+				6F-2, No. 190, Sec. 2 Chung Hsin Road,
+				Hsin Tien City    231
+				TW
+
+00-11-48   (hex)		Prolon Control Systems
+001148     (base 16)		Prolon Control Systems
+				Herstedvesterstraede 56
+				Albertslund    DK-2620
+				DK
+
+00-11-40   (hex)		Nanometrics Inc.
+001140     (base 16)		Nanometrics Inc.
+				250 Herzberg Rd.
+				Kanata  Ontario  K2K 2A1
+				CA
+
+00-11-44   (hex)		Assurance Technology Corp
+001144     (base 16)		Assurance Technology Corp
+				6304 Potomac Avenue
+				Alexandria  Virginia  22307
+				US
+
+00-11-63   (hex)		SYSTEM SPA DEPT. ELECTRONICS
+001163     (base 16)		SYSTEM SPA DEPT. ELECTRONICS
+				VIA GHIAROLA VECCHIA 73
+				FIORANO MODENESE  MODENA  I-41042
+				IT
+
+00-11-8F   (hex)		EUTECH INSTRUMENTS PTE. LTD.
+00118F     (base 16)		EUTECH INSTRUMENTS PTE. LTD.
+				Blk 55,Ayer Rajah Crescent, #04-16/24.
+				    139949
+				SG
+
+00-11-8D   (hex)		Hanchang System Corp.
+00118D     (base 16)		Hanchang System Corp.
+				1058-2, Shinkil-dong, Danwon-gu,
+				Ansan-si  Gyeonggi-do  425-839
+				KR
+
+00-11-5F   (hex)		ITX Security Co., Ltd.
+00115F     (base 16)		ITX Security Co., Ltd.
+				9F Kolon Digital Tower Aston Bldg. 505-14
+				Gasan-dong Geumcheon-gu  SEOUL  153-803
+				KR
+
+00-11-53   (hex)		Trident Tek, Inc.
+001153     (base 16)		Trident Tek, Inc.
+				8041 Cessna Ave #200
+				Gaithersburg  MD  20879
+				US
+
+00-11-72   (hex)		COTRON CORPORATION
+001172     (base 16)		COTRON CORPORATION
+				12FL,No.150,Sec.4,Cheng-De Rd
+				Taipei City    111
+				TW
+
+00-11-A0   (hex)		Vtech Engineering Canada Ltd
+0011A0     (base 16)		Vtech Engineering Canada Ltd
+				200-7671 Alderbridge Way
+				Richmond  BC  V6X 1Z9
+				CA
+
+00-11-9B   (hex)		Telesynergy Research Inc.
+00119B     (base 16)		Telesynergy Research Inc.
+				4F, No. 49, Tung Hsin Rd.,
+				Taipei    110
+				TW
+
+00-11-91   (hex)		CTS-Clima Temperatur Systeme GmbH
+001191     (base 16)		CTS-Clima Temperatur Systeme GmbH
+				Lotzenäcker 21
+				Hechingen  Baden-Württemberg  72379
+				DE
+
+00-11-89   (hex)		Aerotech Inc
+001189     (base 16)		Aerotech Inc
+				101 Zeta Drive
+				Pittsburgh  PA  15238
+				US
+
+00-0F-FB   (hex)		Nippon Denso Industry Co., Ltd.
+000FFB     (base 16)		Nippon Denso Industry Co., Ltd.
+				3-14-19
+				Shibaura, Minato-ku  Tokyo,  108-8560
+				JP
+
+00-0F-F2   (hex)		Loud Technologies Inc.
+000FF2     (base 16)		Loud Technologies Inc.
+				16220 Wood-Red Rd. NE
+				Woodinville  WA  98072
+				US
+
+00-0F-F1   (hex)		nex-G Systems Pte.Ltd
+000FF1     (base 16)		nex-G Systems Pte.Ltd
+				25 Kallang Ave
+				    339416
+				SG
+
+00-11-01   (hex)		CET Technologies Pte Ltd
+001101     (base 16)		CET Technologies Pte Ltd
+				100 Jurong East Street 21
+				    609602
+				SG
+
+00-0F-FF   (hex)		Control4
+000FFF     (base 16)		Control4
+				11734 S. Election Drive
+				Draper  UT  84020
+				US
+
+00-0F-FC   (hex)		Merit Li-Lin Ent.
+000FFC     (base 16)		Merit Li-Lin Ent.
+				No. 20 Wu-Long 6 Rd.
+				Wu-Ku  Taipei  242
+				TW
+
+00-11-13   (hex)		Fraunhofer FOKUS
+001113     (base 16)		Fraunhofer FOKUS
+				Kaiserin-Augusta-Allee 31
+				Berlin    10589
+				DE
+
+00-11-12   (hex)		Honeywell CMSS
+001112     (base 16)		Honeywell CMSS
+				8323 Lindbergh Ct
+				Sarasota  FL  34243
+				US
+
+00-0F-E0   (hex)		NComputing Co.,Ltd.
+000FE0     (base 16)		NComputing Co.,Ltd.
+				6th Fl, JEI-Platz B/D
+				Seoul  Gasan-dong Geumcheon-Gu  459-11
+				KR
+
+00-0F-E3   (hex)		Damm Cellular Systems A/S
+000FE3     (base 16)		Damm Cellular Systems A/S
+				Moellegade 68
+				Soenderborg    DK-6400
+				DK
+
+00-11-28   (hex)		Streamit
+001128     (base 16)		Streamit
+				Flight Forum 3543
+				  Eindhoven  5657 DW
+				NL
+
+00-11-3F   (hex)		Alcatel DI
+00113F     (base 16)		Alcatel DI
+				ZI lavoisier
+				EU  Normandie  76260
+				FR
+
+00-11-37   (hex)		AICHI ELECTRIC CO., LTD.
+001137     (base 16)		AICHI ELECTRIC CO., LTD.
+				1
+				kasugai city  aichi pref.  486-8666
+				JP
+
+00-0F-F3   (hex)		Jung Myoung Communications&Technology
+000FF3     (base 16)		Jung Myoung Communications&Technology
+				1th FL., Dong IL Bldg.107 Yangjae-Dong
+				Seocho-Ku  Seoul  137-130
+				KR
+
+00-11-3A   (hex)		SHINBORAM
+00113A     (base 16)		SHINBORAM
+				4F DAHNWORLD BUILDING, 154-11 SAMSUNG-DONG
+				SEOUL    135-879
+				KR
+
+00-0F-89   (hex)		Winnertec System Co., Ltd.
+000F89     (base 16)		Winnertec System Co., Ltd.
+				#405, 4th Floor. Ace-Techno Tower III, 197-48,
+				Seoul    152-766
+				KR
+
+00-0F-A4   (hex)		Sprecher Automation GmbH
+000FA4     (base 16)		Sprecher Automation GmbH
+				Franckstrasse 51
+				Linz  Oberösterreich  4018
+				AT
+
+00-0F-A6   (hex)		S2 Security Corporation
+000FA6     (base 16)		S2 Security Corporation
+				6 Abbott Road
+				Wellesley  MA  02481
+				US
+
+00-0F-AA   (hex)		Nexus Technologies
+000FAA     (base 16)		Nexus Technologies
+				10 National Ave.
+				Fletcher  NC  28732
+				US
+
+00-0F-A8   (hex)		Photometrics, Inc.
+000FA8     (base 16)		Photometrics, Inc.
+				3440 E Britannia Drive
+				Tucson  AZ  85706-5006
+				US
+
+00-0F-BD   (hex)		MRV Communications (Networks) LTD
+000FBD     (base 16)		MRV Communications (Networks) LTD
+				P.O Box 614
+				Yokneam    20692
+				IL
+
+00-0F-B4   (hex)		Timespace Technology
+000FB4     (base 16)		Timespace Technology
+				Blackstone Road
+				Huntingdon  Cambridgeshire  PE29 6TT
+				GB
+
+00-0F-9D   (hex)		DisplayLink (UK) Ltd
+000F9D     (base 16)		DisplayLink (UK) Ltd
+				Mount Pleasant House
+				Cambridge  Cambridgeshire  CB3 0RN
+				GB
+
+00-0F-C5   (hex)		KeyMed Ltd
+000FC5     (base 16)		KeyMed Ltd
+				KeyMed House
+				Southend on Sea  Essex  SS2 5QH
+				GB
+
+00-0F-BF   (hex)		DGT Sp. z o.o.
+000FBF     (base 16)		DGT Sp. z o.o.
+				ul. Jaskowa Dolina 15
+				Gdansk  woj. pomorskie  80-252
+				PL
+
+00-0F-92   (hex)		Microhard Systems Inc.
+000F92     (base 16)		Microhard Systems Inc.
+				#17, 2135-32Ave NE
+				Calgary  AB  T2E6Z3
+				CA
+
+00-0F-CB   (hex)		3Com Ltd
+000FCB     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-0F-D5   (hex)		Schwechat - RISE
+000FD5     (base 16)		Schwechat - RISE
+				Am Concorde Park 2A
+				Schwechat    2320
+				AT
+
+00-0F-67   (hex)		West Instruments
+000F67     (base 16)		West Instruments
+				Unit 5, The Hyde, Lower Bevendean
+				Brighton  East Sussex  BN2 4JU
+				GB
+
+00-0F-6E   (hex)		BBox
+000F6E     (base 16)		BBox
+				Gyar u. 2. (115)
+				Budaors    H-2040
+				HU
+
+00-0F-6F   (hex)		FTA Communication Technologies
+000F6F     (base 16)		FTA Communication Technologies
+				11, rue Pierre Werner
+				Betzdorf    L-6832
+				LU
+
+00-0F-63   (hex)		Obzerv Technologies
+000F63     (base 16)		Obzerv Technologies
+				400 Jean Lesage
+				Quebec  QC  G1K8W1
+				CA
+
+00-0F-21   (hex)		Scientific Atlanta, Inc
+000F21     (base 16)		Scientific Atlanta, Inc
+				5030 Sugarloaf Parkway
+				Lawrenceville  Ga  30042
+				US
+
+00-0F-11   (hex)		Prodrive B.V.
+000F11     (base 16)		Prodrive B.V.
+				P.O. 28030
+				Eindhoven    5602 JA
+				NL
+
+00-0F-13   (hex)		Nisca corporation
+000F13     (base 16)		Nisca corporation
+				430-1
+				Masuho-Cho  Yamanashi-Ken  400-0593
+				JP
+
+00-0F-14   (hex)		Mindray Co., Ltd.
+000F14     (base 16)		Mindray Co., Ltd.
+				Mindray Building, Keji 12th Road South
+				Shenzhen  Guangdong  518057
+				CN
+
+00-0F-65   (hex)		icube Corp.
+000F65     (base 16)		icube Corp.
+				Olympia Center 2F,828-10,Yeoksam-dong,Kangnam-ku
+				Seoul  South  135-935
+				KR
+
+00-0F-5D   (hex)		Genexis BV
+000F5D     (base 16)		Genexis BV
+				Lodewijktraat 1A
+				5652 AC  Eindhoven    
+				SE
+
+00-0F-58   (hex)		Adder Technology Limited
+000F58     (base 16)		Adder Technology Limited
+				Technology House
+				Bar Hill  Cambridgeshire  CB3 8SQ
+				GB
+
+00-0F-12   (hex)		Panasonic Europe Ltd.
+000F12     (base 16)		Panasonic Europe Ltd.
+				Hesebergweg 49-51
+				Peine    D-31228
+				DE
+
+00-0F-0E   (hex)		WaveSplitter Technologies, Inc.
+000F0E     (base 16)		WaveSplitter Technologies, Inc.
+				2248 North First Street
+				San Jose  CA  95131
+				US
+
+00-0F-0C   (hex)		SYNCHRONIC ENGINEERING
+000F0C     (base 16)		SYNCHRONIC ENGINEERING
+				25 CAP DARNETAL
+				DARNETAL  FRANCE  76160
+				FR
+
+00-0F-0B   (hex)		Kentima Technologies AB
+000F0B     (base 16)		Kentima Technologies AB
+				Box 174
+				Staffanstorp  Skåne  245 44
+				SE
+
+00-0F-46   (hex)		SINAR AG
+000F46     (base 16)		SINAR AG
+				Stadtweg 24
+				Feuerthalen  ZH  CH-8245
+				CH
+
+00-0F-41   (hex)		Zipher Ltd
+000F41     (base 16)		Zipher Ltd
+				7 Faraday Building
+				Nottingham  Nottinghamshire  NG7 2QP
+				GB
+
+00-0F-4D   (hex)		TalkSwitch
+000F4D     (base 16)		TalkSwitch
+				1545 Carling Ave
+				Ottawa  Ontario  K1Z 8P9
+				CA
+
+00-0F-71   (hex)		Sanmei Electronics Co.,Ltd
+000F71     (base 16)		Sanmei Electronics Co.,Ltd
+				2-2-1,Seikai,Shimizu
+				Shizuoka    424-0924
+				JP
+
+00-0F-6B   (hex)		GateWare Communications GmbH
+000F6B     (base 16)		GateWare Communications GmbH
+				Allersberger Strasse 185 F
+				Nuernberg  Bavaria  D-90461
+				DE
+
+00-0E-D5   (hex)		COPAN Systems Inc.
+000ED5     (base 16)		COPAN Systems Inc.
+				2605 Trade Centre Ave.
+				Longmont  CO  80503
+				US
+
+00-0E-CA   (hex)		WTSS Inc
+000ECA     (base 16)		WTSS Inc
+				5999 Avenida Encinas
+				Carlsbad  CA  92008
+				US
+
+00-0E-CC   (hex)		Tableau, LLC
+000ECC     (base 16)		Tableau, LLC
+				N8 W22195 Johnson Drive, Suite 100
+				Waukesha  WI  53186
+				US
+
+00-0E-CB   (hex)		VineSys Technology
+000ECB     (base 16)		VineSys Technology
+				3350 Scott Blvd. building 15-03
+				Santa Clara  CA  95054
+				US
+
+00-0E-D2   (hex)		Filtronic plc
+000ED2     (base 16)		Filtronic plc
+				The Waterfront
+				Saltaire  W Yorks  BD18 3TT
+				GB
+
+00-0E-C8   (hex)		Zoran Corporation
+000EC8     (base 16)		Zoran Corporation
+				1390 Kifer Rd.
+				Sunnyvale  CA  94086
+				US
+
+00-0E-D9   (hex)		Aksys, Ltd.
+000ED9     (base 16)		Aksys, Ltd.
+				2 Marriott Drive
+				Lincolnshire  IL  60069
+				US
+
+00-0E-B4   (hex)		GUANGZHOU GAOKE COMMUNICATIONS TECHNOLOGY CO.LTD.
+000EB4     (base 16)		GUANGZHOU GAOKE COMMUNICATIONS TECHNOLOGY CO.LTD.
+				AVE. 398 ZHONGSHAN
+				GUANGZHOU  GUANGDONG  510660
+				CN
+
+00-0E-B1   (hex)		Newcotech,Ltd
+000EB1     (base 16)		Newcotech,Ltd
+				Anyang Megavally 715-3
+				Anyang City  Gueonggi-Do  431-160
+				KR
+
+00-0E-A9   (hex)		Shanghai Xun Shi Communications Equipment Ltd. Co.
+000EA9     (base 16)		Shanghai Xun Shi Communications Equipment Ltd. Co.
+				Hi-Tech King World, Unit C603
+				Shanghai    200001
+				CN
+
+00-0E-B6   (hex)		Riverbed Technology, Inc.
+000EB6     (base 16)		Riverbed Technology, Inc.
+				 680 Folsom St.
+				San Francisco  CA  94107
+				US
+
+00-0E-B7   (hex)		Knovative, Inc.
+000EB7     (base 16)		Knovative, Inc.
+				11245 West Bernardo Court
+				San Diego  CA  92127
+				US
+
+00-0E-FA   (hex)		Optoway Technology Incorporation
+000EFA     (base 16)		Optoway Technology Incorporation
+				No. 38, Kuang Fu South Road
+				Hu Kou  Hsin Chu  303
+				TW
+
+00-0E-FD   (hex)		FUJINON CORPORATION
+000EFD     (base 16)		FUJINON CORPORATION
+				1-324 UETAKE, KITA-KU,
+				SAITAMA CITY  SAITAMA  331-9624
+				JP
+
+00-0E-F5   (hex)		iPAC Technology Co., Ltd.
+000EF5     (base 16)		iPAC Technology Co., Ltd.
+				6F, No. 30, Shingjung Road, Neihu
+				Taipei    114
+				TW
+
+00-0E-FB   (hex)		Macey Enterprises
+000EFB     (base 16)		Macey Enterprises
+				P.O. Box 7267
+				Tempe  AZ  85281
+				US
+
+00-0F-09   (hex)		Private
+000F09     (base 16)		Private
+
+00-0E-DC   (hex)		Tellion INC.
+000EDC     (base 16)		Tellion INC.
+				5th Fl. BONA Venture Town
+				Seoul  Seocho-gu.  137-719
+				KR
+
+00-0E-CD   (hex)		SKOV A/S
+000ECD     (base 16)		SKOV A/S
+				Hedelund 4
+				Roslev    DK-7870
+				DK
+
+00-0E-DB   (hex)		XiNCOM Corp.
+000EDB     (base 16)		XiNCOM Corp.
+				2840 Industrial Ave.
+				Hubbard  OR  97032
+				US
+
+00-0E-DD   (hex)		SHURE INCORPORATED
+000EDD     (base 16)		SHURE INCORPORATED
+				5800 W. TOUHY AVE.
+				NILES  IL  60714
+				US
+
+00-0E-C2   (hex)		Lowrance Electronics, Inc.
+000EC2     (base 16)		Lowrance Electronics, Inc.
+				12000 E. Skelly Drive
+				Tulsa  OK  74128
+				US
+
+00-0E-A3   (hex)		CNCR-IT CO.,LTD,HangZhou P.R.CHINA
+000EA3     (base 16)		CNCR-IT CO.,LTD,HangZhou P.R.CHINA
+				Yinjiang mansion NO.5F Wenyi Road
+				HangZhou  ZheJiang  310012
+				CN
+
+00-0E-A2   (hex)		McAfee, Inc
+000EA2     (base 16)		McAfee, Inc
+				350 SW 12th Avenue
+				Deerfield Beach  FL  33442
+				US
+
+00-0E-9B   (hex)		Ambit Microsystems Corporation
+000E9B     (base 16)		Ambit Microsystems Corporation
+				5F-1, 5 Hsin-An Rd. Science-Based Industrial Park
+				Hsinchu    300
+				TW
+
+00-0E-78   (hex)		Amtelco
+000E78     (base 16)		Amtelco
+				4800 Curtin Drive
+				McFarland  WI  53558
+				US
+
+00-0E-71   (hex)		Gemstar Technology Development Ltd.
+000E71     (base 16)		Gemstar Technology Development Ltd.
+				Unit 201, Stulex house, 698 prince edward road east, san po kong, Kolwoon
+				Hong Kong    852
+				HK
+
+00-0E-70   (hex)		in2 Networks
+000E70     (base 16)		in2 Networks
+				320 W  200 S
+				SLC  UT  84101
+				US
+
+00-0E-37   (hex)		Harms & Wende GmbH & Co.KG
+000E37     (base 16)		Harms & Wende GmbH & Co.KG
+				Grossmoorkehre 9
+				Hamburg    D-21079
+				DE
+
+00-0E-31   (hex)		Olympus Soft Imaging Solutions GmbH
+000E31     (base 16)		Olympus Soft Imaging Solutions GmbH
+				Johann-Krane-Weg 39
+				  Münster  48149
+				DE
+
+00-0E-2F   (hex)		Roche Diagnostics GmbH
+000E2F     (base 16)		Roche Diagnostics GmbH
+				Roche Diabetes Care Insulin Delivery Systems
+				D-68305 Mannheim    
+				DE
+
+00-0E-2A   (hex)		Private
+000E2A     (base 16)		Private
+
+00-0E-9E   (hex)		Topfield Co., Ltd
+000E9E     (base 16)		Topfield Co., Ltd
+				4th floor, Deoksan Bldg 260-4, Seohyun-dong
+				Seongnam  Bundang-Ku  463-824
+				KR
+
+00-0E-41   (hex)		NIHON MECHATRONICS CO.,LTD.
+000E41     (base 16)		NIHON MECHATRONICS CO.,LTD.
+				9-6 SHIOMIDAI, MIYAMAE-KU
+				KAWASAKI-SHI  KANAGAWA-KEN  216-0013
+				JP
+
+00-0E-3C   (hex)		Transact Technologies Inc
+000E3C     (base 16)		Transact Technologies Inc
+				20 Bomax Drive
+				Ithaca  New York  14850
+				US
+
+00-0E-63   (hex)		Lemke Diagnostics GmbH
+000E63     (base 16)		Lemke Diagnostics GmbH
+				Radeburger Str. 47
+				Volkersdorf  Saxony  01468
+				DE
+
+00-0E-5B   (hex)		ParkerVision - Direct2Data
+000E5B     (base 16)		ParkerVision - Direct2Data
+				9432 Baymeadows Way
+				Jacksonville  FL  32246
+				US
+
+00-0E-60   (hex)		360SUN Digital Broadband Corporation
+000E60     (base 16)		360SUN Digital Broadband Corporation
+				2F-2, No.2, Jianba Rd.,
+				Chung Ho  Taipei  235
+				TW
+
+00-0E-54   (hex)		AlphaCell Wireless Ltd.
+000E54     (base 16)		AlphaCell Wireless Ltd.
+				22 Zarhin street
+				Raanana    43662
+				IL
+
+00-0E-4E   (hex)		Waveplus Technology Co., Ltd.
+000E4E     (base 16)		Waveplus Technology Co., Ltd.
+				347 HsinHu 2nd Rd., NeiHu
+				Taipei    114
+				TW
+
+00-0E-4A   (hex)		Changchun Huayu WEBPAD Co.,LTD
+000E4A     (base 16)		Changchun Huayu WEBPAD Co.,LTD
+				4370 Gaoxin Road, High-Tech
+				Changchun  Jilin  130012
+				CN
+
+00-0E-93   (hex)		Milénio 3 Sistemas Electrónicos, Lda.
+000E93     (base 16)		Milénio 3 Sistemas Electrónicos, Lda.
+				Edifício Via Norte, R. Espido 164C S403
+				Maia  Minho  4470-177
+				PT
+
+00-0E-8D   (hex)		Systems in Progress Holding GmbH
+000E8D     (base 16)		Systems in Progress Holding GmbH
+				Exerzierplatzstrasse 85
+				Graz  Styria  8051
+				AT
+
+00-0E-76   (hex)		GEMSOC INNOVISION INC.
+000E76     (base 16)		GEMSOC INNOVISION INC.
+				9F,No.516,Sec,1Neihu Rd.,
+				Taipei    114
+				TW
+
+00-0E-7D   (hex)		Electronics Line 3000 Ltd.
+000E7D     (base 16)		Electronics Line 3000 Ltd.
+				2 Granit St.
+				Petah Tikva  Kiryar Arie  449130
+				IL
+
+00-0E-2C   (hex)		Netcodec co.
+000E2C     (base 16)		Netcodec co.
+				401 Daeion S/W Center, 48 Jangdong
+				Daejon    305-715
+				KR
+
+00-0E-23   (hex)		Incipient, Inc.
+000E23     (base 16)		Incipient, Inc.
+				230 Third Ave.
+				Waltham  MA  02451
+				US
+
+00-0E-25   (hex)		Hannae Technology Co., Ltd
+000E25     (base 16)		Hannae Technology Co., Ltd
+				4F, Hyunjin Bldg., #798-30, Yeoksam-Dong
+				SEOUL    135-080
+				KR
+
+00-0E-20   (hex)		ACCESS Systems Americas, Inc.
+000E20     (base 16)		ACCESS Systems Americas, Inc.
+				1188 East Arques Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-0E-21   (hex)		MTU Friedrichshafen GmbH
+000E21     (base 16)		MTU Friedrichshafen GmbH
+				Maybachplatz 1
+				Friedrichshafen  Baden Wuertemberg  88040
+				DE
+
+00-0D-D4   (hex)		Symantec Corporation
+000DD4     (base 16)		Symantec Corporation
+				275 2nd Ave
+				Waltham  MA  02541
+				US
+
+00-0D-D2   (hex)		Simrad Optronics ASA
+000DD2     (base 16)		Simrad Optronics ASA
+				Ensjøveienn 23B
+				PO Box 6114 Etterstad  NO-0602 Oslo  
+				NO
+
+00-0D-D1   (hex)		Stryker Corporation
+000DD1     (base 16)		Stryker Corporation
+				4100 E Milham
+				Kalamazoo  MI  49001
+				US
+
+00-0D-D7   (hex)		Bright
+000DD7     (base 16)		Bright
+				1-12-44 Aobadai
+				Kashiwa-shi  Chiba-ken  277-0055
+				JP
+
+00-0D-D9   (hex)		Anton Paar GmbH
+000DD9     (base 16)		Anton Paar GmbH
+				Anton-Paar-Strasse 20
+				Graz    8054
+				AT
+
+00-0D-DC   (hex)		VAC
+000DDC     (base 16)		VAC
+				20F, N0. 456, Sec. 4, Hsin Yi Rd.,
+				Taipei    110
+				TW
+
+00-0D-E0   (hex)		ICPDAS Co.,LTD
+000DE0     (base 16)		ICPDAS Co.,LTD
+				 No. 111, Kuang-Fu N. Rd., Hsin-Chu Indu
+				HSINCHU    303
+				TW
+
+00-0D-E3   (hex)		AT Sweden AB
+000DE3     (base 16)		AT Sweden AB
+				P.O. Box 1166
+				Kista  Stockholm  SE-164 26
+				SE
+
+00-0D-EA   (hex)		Kingtel Telecommunication Corp.
+000DEA     (base 16)		Kingtel Telecommunication Corp.
+				147 Kang Ning St.
+				Hsi Chih City  Taipei Hsien  221
+				TW
+
+00-0D-ED   (hex)		Cisco Systems, Inc
+000DED     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-E4   (hex)		DIGINICS, Inc.
+000DE4     (base 16)		DIGINICS, Inc.
+				178-7 Poi-dong
+				Kangnam-gu  Seoul  135-961
+				KR
+
+00-0E-09   (hex)		Shenzhen Coship Software Co.,LTD.
+000E09     (base 16)		Shenzhen Coship Software Co.,LTD.
+				7/F,Block A,W2 Bldg,Hi-Tech Industrial Park,Shenzhen,China
+				Shenzhen  Guangdong  518057
+				CN
+
+00-0E-05   (hex)		WIRELESS MATRIX CORP.
+000E05     (base 16)		WIRELESS MATRIX CORP.
+				UNIT 1A-3751 NORTH FRASER WAY
+				BURNABY  BC  V5J 5G4
+				CA
+
+00-0E-22   (hex)		Private
+000E22     (base 16)		Private
+
+00-0E-1C   (hex)		Hach Company
+000E1C     (base 16)		Hach Company
+				5600 Lindbergh Drive
+				Loveland  CO  80538
+				US
+
+00-0E-02   (hex)		Advantech AMT Inc.
+000E02     (base 16)		Advantech AMT Inc.
+				657 Orly Ave.
+				Dorval  Quebec  H9P 1G1
+				CA
+
+00-0D-C9   (hex)		THALES Elektronik Systeme GmbH
+000DC9     (base 16)		THALES Elektronik Systeme GmbH
+				Fritz-Ludwig-Str. 1
+				Koblenz    56070
+				DE
+
+00-0D-81   (hex)		Pepperl+Fuchs GmbH
+000D81     (base 16)		Pepperl+Fuchs GmbH
+				Lilienthalstraße 200
+				Mannheim    68307
+				DE
+
+00-0D-7A   (hex)		DiGATTO Asia Pacific Pte Ltd
+000D7A     (base 16)		DiGATTO Asia Pacific Pte Ltd
+				190 Mddle Road, #19-05 Fortune Center
+				    188979
+				SG
+
+00-0D-77   (hex)		FalconStor Software
+000D77     (base 16)		FalconStor Software
+				125 Baylis Rd
+				Melville  NY  11747
+				US
+
+00-0D-76   (hex)		Hokuto Denshi Co,. Ltd.
+000D76     (base 16)		Hokuto Denshi Co,. Ltd.
+				3-7 Odori Nishi 16-Chome Chuoku
+				Sapporo  Hokkaido  060-0042
+				JP
+
+00-0D-7B   (hex)		Consensys Computers Inc.
+000D7B     (base 16)		Consensys Computers Inc.
+				215 Shields Ct.
+				Markham  ON  L3R 8V2
+				CA
+
+00-0D-8F   (hex)		King Tsushin Kogyo Co., LTD.
+000D8F     (base 16)		King Tsushin Kogyo Co., LTD.
+				 1-10-1 Edanishi Aobaku
+				  Yokohama  225-0014
+				JP
+
+00-0D-89   (hex)		Bils Technology Inc
+000D89     (base 16)		Bils Technology Inc
+				508 S River Oaks Drive
+				Indialantic  FL  32903
+				US
+
+00-0D-86   (hex)		Huber + Suhner AG
+000D86     (base 16)		Huber + Suhner AG
+				Degersheimerstrasse 14
+				9100  Herisau  
+				CH
+
+00-0D-C8   (hex)		AirMagnet, Inc
+000DC8     (base 16)		AirMagnet, Inc
+				830 E. Arques Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-0D-BE   (hex)		Bel Fuse Europe Ltd.,UK
+000DBE     (base 16)		Bel Fuse Europe Ltd.,UK
+				45/46 Riverside 2
+				Rochester  Kent  ME2 4DP
+				GB
+
+00-0D-BC   (hex)		Cisco Systems, Inc
+000DBC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-9F   (hex)		RF Micro Devices
+000D9F     (base 16)		RF Micro Devices
+				2191 Zanker Road
+				San Jose  CA  95131
+				US
+
+00-0D-A5   (hex)		Fabric7 Systems, Inc
+000DA5     (base 16)		Fabric7 Systems, Inc
+				1300 Crittenden Lane
+				Mountain View  CA  94043
+				US
+
+00-0D-C5   (hex)		EchoStar Global B.V. 
+000DC5     (base 16)		EchoStar Global B.V. 
+				Schuilenburglaan 5a
+				Almelo  Overijssel  7604BJ
+				NL
+
+00-0D-99   (hex)		Orbital Sciences Corp.; Launch Systems Group
+000D99     (base 16)		Orbital Sciences Corp.; Launch Systems Group
+				3380 S. Price Rd.
+				Chandler,  AZ  85248
+				US
+
+00-0D-6C   (hex)		M-Audio
+000D6C     (base 16)		M-Audio
+				45 E ST Joseph St.
+				Arcadia  CA  91006
+				US
+
+00-0D-70   (hex)		Datamax Corporation
+000D70     (base 16)		Datamax Corporation
+				4501 Parkway Commerce Blvd
+				Orlando  FL  32808
+				US
+
+00-0D-59   (hex)		Amity Systems, Inc.
+000D59     (base 16)		Amity Systems, Inc.
+				888 Tasman Drive
+				Milpitas  CA  95035
+				US
+
+00-0D-4E   (hex)		NDR Co.,LTD.
+000D4E     (base 16)		NDR Co.,LTD.
+				Sumitomo seimei minatomachi MT BLDG
+				Osak  Kinki  550-0015
+				JP
+
+00-0D-50   (hex)		Galazar Networks
+000D50     (base 16)		Galazar Networks
+				35 Fitzgerald Ave
+				Ottawa  ON  K2H 1E6
+				CA
+
+00-0D-17   (hex)		Turbo Networks Co.Ltd
+000D17     (base 16)		Turbo Networks Co.Ltd
+				2F,No 1223, Chung Cheng Rd.
+				Tao Yuan    330
+				TW
+
+00-0D-18   (hex)		Mega-Trend Electronics CO., LTD.
+000D18     (base 16)		Mega-Trend Electronics CO., LTD.
+				Tong Fu Yu Ind., Ku Keng Village, Guan Lan
+				Shengzhen  Guang Dong  518110
+				CN
+
+00-0D-20   (hex)		ASAHIKASEI TECHNOSYSTEM CO.,LTD.
+000D20     (base 16)		ASAHIKASEI TECHNOSYSTEM CO.,LTD.
+				Kanda Jinbocho 1-105
+				Chiyoda-ku  Tokyo  101-8101
+				JP
+
+00-0D-49   (hex)		Triton Systems of Delaware, Inc.
+000D49     (base 16)		Triton Systems of Delaware, Inc.
+				522 E. Railroad St.
+				Long Beach  MS  39560
+				US
+
+00-0D-48   (hex)		AEWIN Technologies Co., Ltd.
+000D48     (base 16)		AEWIN Technologies Co., Ltd.
+				7F, No. 2, Lane 47, Sec. 3, Nan-Gang Rd.
+				TAIPEI    115
+				TW
+
+00-0D-24   (hex)		SENTEC E&E CO., LTD.
+000D24     (base 16)		SENTEC E&E CO., LTD.
+				No. 32. Gong5 Rd.
+				Lungtan  Taoyuan  325
+				TW
+
+00-0D-22   (hex)		Unitronics LTD
+000D22     (base 16)		Unitronics LTD
+				Unitronics Building
+				Ben Gurion Airport    70100
+				IL
+
+00-0D-14   (hex)		Vtech Innovation LP dba Advanced American Telephones
+000D14     (base 16)		Vtech Innovation LP dba Advanced American Telephones
+				203-600 Parsippany Rd
+				Parsippany  NJ  07054
+				US
+
+00-0D-5B   (hex)		Smart Empire Investments Limited
+000D5B     (base 16)		Smart Empire Investments Limited
+				Suite 2001-2006,Level 20 Landmark North
+				Xin Jie  Hong Kong  00852
+				CN
+
+00-0D-3A   (hex)		Microsoft Corp.
+000D3A     (base 16)		Microsoft Corp.
+				One Microsoft Way
+				Redmond  Wa.  98052
+				US
+
+00-0D-30   (hex)		IceFyre Semiconductor
+000D30     (base 16)		IceFyre Semiconductor
+				Suite 300
+				Kanata  Ontario  K2K 3C9
+				CA
+
+00-0D-31   (hex)		Compellent Technologies, Inc.
+000D31     (base 16)		Compellent Technologies, Inc.
+				7625 Smetana Lane
+				Eden Prairie  Minnesota  55344
+				US
+
+00-0D-2C   (hex)		Net2Edge Limited
+000D2C     (base 16)		Net2Edge Limited
+				Kulite House Stroudley Road
+				Basingstoke  Hampshire  RG24 8UG
+				GB
+
+00-0D-25   (hex)		SANDEN CORPORATION
+000D25     (base 16)		SANDEN CORPORATION
+				20 Kotobuki-cho
+				Isesaki-shi  Gunma  372-8502
+				JP
+
+00-0D-6F   (hex)		Ember Corporation
+000D6F     (base 16)		Ember Corporation
+				343 Congress St
+				Boston  Ma  02210
+				US
+
+00-0D-5E   (hex)		NEC Personal Products
+000D5E     (base 16)		NEC Personal Products
+				6-80, Shimohanazawa 2-Chome
+				Yonezawa-shi  Yamagata  992-8520
+				JP
+
+00-0D-3F   (hex)		VTI Instruments Corporation
+000D3F     (base 16)		VTI Instruments Corporation
+				5425 Warner Road, Suite 13
+				Valley View  OH  44125
+				US
+
+00-0C-E3   (hex)		Option International N.V.
+000CE3     (base 16)		Option International N.V.
+				Kolonel Begaultlaan 45
+				Leuven  Brabant  3012
+				BE
+
+00-0C-E7   (hex)		MediaTek Inc.
+000CE7     (base 16)		MediaTek Inc.
+				1F, No. 13, Innovation Road 1,
+				Hsinchu    300
+				TW
+
+00-0C-E8   (hex)		GuangZhou AnJuBao Co., Ltd
+000CE8     (base 16)		GuangZhou AnJuBao Co., Ltd
+				HeiQiaoTang TangXia TianHe
+				GuangZhou  GuangDong  510665
+				CN
+
+00-0C-E4   (hex)		NeuroCom International, Inc.
+000CE4     (base 16)		NeuroCom International, Inc.
+				9570 SE Lawnfield Rd
+				Clackamas  OR  97015
+				US
+
+00-0C-B5   (hex)		Premier Technolgies, Inc
+000CB5     (base 16)		Premier Technolgies, Inc
+				PO Box 159
+				Long Lake  MN  55356
+				US
+
+00-0C-B6   (hex)		NANJING SEU MOBILE & INTERNET TECHNOLOGY CO.,LTD
+000CB6     (base 16)		NANJING SEU MOBILE & INTERNET TECHNOLOGY CO.,LTD
+				5th floor,Building 5,ChangJiangHou Street No.6
+				Nanjing  Jiangsu  210018
+				CN
+
+00-0C-C3   (hex)		BeWAN systems
+000CC3     (base 16)		BeWAN systems
+				16 rue du Moulin des Bruyères Courbevoie
+				Courbevoie  Hauts de Seine  92400
+				FR
+
+00-0C-B4   (hex)		AutoCell Laboratories, Inc.
+000CB4     (base 16)		AutoCell Laboratories, Inc.
+				174 Concord Street
+				Peterborough,  New Hampshire  03458
+				US
+
+00-0C-B1   (hex)		Salland Engineering (Europe) BV
+000CB1     (base 16)		Salland Engineering (Europe) BV
+				Bedrijvenpark Berkum
+				Zwolle  OV  8024 HA
+				NL
+
+00-0C-BC   (hex)		Iscutum
+000CBC     (base 16)		Iscutum
+				#899-6 Ho-Gye Dong, Dong-An Gu
+				An-Yang City  Kyong-Gi Do  431-080
+				KR
+
+00-0D-04   (hex)		Foxboro Eckardt Development GmbH
+000D04     (base 16)		Foxboro Eckardt Development GmbH
+				Glockenstrasse 52
+				Stuttgart  Baden-Württemberg  70376
+				DE
+
+00-0D-08   (hex)		AboveCable, Inc.
+000D08     (base 16)		AboveCable, Inc.
+				8403 Colesville Road, #825
+				Silver Spring  MD  20910
+				US
+
+00-0D-05   (hex)		cybernet manufacturing inc.
+000D05     (base 16)		cybernet manufacturing inc.
+				5 holland
+				irvine  ca  92618
+				US
+
+00-0C-FE   (hex)		Grand Electronic Co., Ltd
+000CFE     (base 16)		Grand Electronic Co., Ltd
+				Room 1710, Block B Lucky tower, No.3 Don
+				Beijing    100027
+				CN
+
+00-0D-0E   (hex)		Inqnet Systems, Inc.
+000D0E     (base 16)		Inqnet Systems, Inc.
+				321 NKIC Center,
+				Seoul    120-100
+				KR
+
+00-0D-11   (hex)		DENTSPLY - Gendex
+000D11     (base 16)		DENTSPLY - Gendex
+				901 West Oakton Street
+				Des Plaines  IL  60018-1884
+				US
+
+00-0C-C8   (hex)		Xytronix Research & Design, Inc.
+000CC8     (base 16)		Xytronix Research & Design, Inc.
+				1488 East 2300 North
+				North Logan  UT  84341-1627
+				US
+
+00-0C-CA   (hex)		HGST a Western Digital Company
+000CCA     (base 16)		HGST a Western Digital Company
+				3403 Yerba Buena Road
+				San Jose  CA  95135
+				US
+
+00-0C-D0   (hex)		Symetrix
+000CD0     (base 16)		Symetrix
+				6408 216th St SW
+				Mountlake Terrace  WA  98043
+				US
+
+00-0C-D9   (hex)		Itcare Co., Ltd
+000CD9     (base 16)		Itcare Co., Ltd
+				408 KT Seocho, 1001-1 Bangbae-dong,
+				Seoul    137-850
+				KR
+
+00-0C-D5   (hex)		Passave Inc.
+000CD5     (base 16)		Passave Inc.
+				1557 Jasper Dr.
+				Sunnyvale  CA  94087
+				US
+
+00-0C-D2   (hex)		Schaffner EMV AG
+000CD2     (base 16)		Schaffner EMV AG
+				Nordstrasse 1
+				Luterbach    CH-4542
+				CH
+
+00-0A-07   (hex)		WebWayOne Ltd
+000A07     (base 16)		WebWayOne Ltd
+				11 Kingfisher Court,
+				Newbury  Berkshire  RG14 5SJ
+				GB
+
+00-0C-B0   (hex)		Star Semiconductor Corporation
+000CB0     (base 16)		Star Semiconductor Corporation
+				6F, No.17, Li-Hsin Rd
+				Hsinchu City    300
+				TW
+
+00-0C-34   (hex)		Vixen Co., Ltd.
+000C34     (base 16)		Vixen Co., Ltd.
+				5-17-3 Higashitokorozawa
+				Tokorozawa  Saitama  359-0021
+				JP
+
+00-0C-58   (hex)		M&S Systems
+000C58     (base 16)		M&S Systems
+				2861 Congressman Lane
+				Dallas  TX  75220
+				US
+
+00-0C-51   (hex)		Scientific Technologies Inc.
+000C51     (base 16)		Scientific Technologies Inc.
+				6550 Dumbarton Circle
+				Fremont  CA  94560
+				US
+
+00-0C-73   (hex)		TELSON ELECTRONICS CO., LTD
+000C73     (base 16)		TELSON ELECTRONICS CO., LTD
+				Telson Venture Tower., 949-3 Dogok-Dong
+				Seoul  Kangnam-Ku  135-739
+				KR
+
+00-0C-65   (hex)		Sunin Telecom
+000C65     (base 16)		Sunin Telecom
+				1025-5 Dokok-Ri, Wabu-Eub
+				Namyangju-City  Kyunggi-Do  472-900
+				KR
+
+00-0C-6C   (hex)		Eve Systems GmbH
+000C6C     (base 16)		Eve Systems GmbH
+				Rotkreuzplatz 1
+				Munich    80634
+				DE
+
+00-0C-6F   (hex)		Amtek system co.,LTD.
+000C6F     (base 16)		Amtek system co.,LTD.
+				14F-11,No.79,Sec. 1 ,Hsin Tai Wu Rd.,
+				Taipei    221
+				TW
+
+00-0C-7E   (hex)		Tellium Incorporated
+000C7E     (base 16)		Tellium Incorporated
+				2 Crescent Place
+				Oceanport  New Jersey  07757
+				US
+
+00-0C-87   (hex)		AMD
+000C87     (base 16)		AMD
+				4555 Great America Pkwy
+				Santa Clara  CA  95054
+				US
+
+00-0C-98   (hex)		LETEK Communications Inc.
+000C98     (base 16)		LETEK Communications Inc.
+				Taeyang Bd. 2nd Floor, 2486
+				SongNam  Kyunggi-do  462-824
+				KR
+
+00-0C-8E   (hex)		Mentor Engineering Inc
+000C8E     (base 16)		Mentor Engineering Inc
+				2891 Sunridge Way NE
+				Calgary  Alberta  T1Y7K7
+				CA
+
+00-0C-A2   (hex)		Harmonic Video Network
+000CA2     (base 16)		Harmonic Video Network
+				10 Ha'amal st. Park Afek
+				Rosh Ha'ayin    48092
+				IL
+
+00-0C-A4   (hex)		Prompttec Product Management GmbH
+000CA4     (base 16)		Prompttec Product Management GmbH
+				Mariatrosterstr. 41
+				Graz  AUSTRIA  A-8043
+				AT
+
+00-0C-5B   (hex)		HANWANG TECHNOLOGY CO.,LTD
+000C5B     (base 16)		HANWANG TECHNOLOGY CO.,LTD
+				8F,Automation Building,95 Zhongguancun,
+				Beijing    100080
+				CN
+
+00-0C-60   (hex)		ACM Systems
+000C60     (base 16)		ACM Systems
+				3034 Gold Canal Drive
+				Rancho Cordova  CA  95670
+				US
+
+00-0C-83   (hex)		Logical Solutions
+000C83     (base 16)		Logical Solutions
+				100T Washington Street
+				Milford  CT  06460
+				US
+
+00-0C-96   (hex)		OQO, Inc.
+000C96     (base 16)		OQO, Inc.
+				1800 Illinois Street
+				San Francisco  CA  94124
+				US
+
+00-0C-08   (hex)		HUMEX Technologies Corp.
+000C08     (base 16)		HUMEX Technologies Corp.
+				5F, No.5, Lane 44, Szu Wei Rd. Taan Taip
+				Taipei    106
+				TW
+
+00-0C-0D   (hex)		Communications & Power Industries / Satcom Division
+000C0D     (base 16)		Communications & Power Industries / Satcom Division
+				811 Hansen Way MS S-600
+				Palo Alto  CA  94303
+				US
+
+00-0C-04   (hex)		Tecnova
+000C04     (base 16)		Tecnova
+				1486 St. Paul Ave.
+				Gurnee  Illinois  60031
+				US
+
+00-0C-01   (hex)		Abatron AG
+000C01     (base 16)		Abatron AG
+				Lettenstrasse 9
+				Rotkreuz    CH-6343
+				CH
+
+00-0C-39   (hex)		Sentinel Wireless Inc.
+000C39     (base 16)		Sentinel Wireless Inc.
+				439 S. Union St.
+				South Lawrence  MA  01843
+				US
+
+00-0C-33   (hex)		Compucase Enterprise Co. Ltd.
+000C33     (base 16)		Compucase Enterprise Co. Ltd.
+				225 Lane 54, An Ho Road, Section 2nd.
+				Tainan City    70942
+				TW
+
+00-0C-36   (hex)		SHARP TAKAYA ELECTRONICS INDUSTRY CO.,LTD.
+000C36     (base 16)		SHARP TAKAYA ELECTRONICS INDUSTRY CO.,LTD.
+				3121-1 Satomi Satosho-cho
+				Asakuchi-gun  Okayama  719-0301
+				JP
+
+00-0B-F6   (hex)		Nitgen Co., Ltd
+000BF6     (base 16)		Nitgen Co., Ltd
+				4th FL. 1337-31 Seocho-dong, Seocho-ku
+				Seoul    137-860
+				KR
+
+00-0B-FD   (hex)		Cisco Systems, Inc
+000BFD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-FA   (hex)		EXEMYS SRL
+000BFA     (base 16)		EXEMYS SRL
+				LOYOLA 680
+				CAPITAL FEDERAL  BS AS  C1414
+				AR
+
+00-0B-F4   (hex)		Private
+000BF4     (base 16)		Private
+
+00-0B-FB   (hex)		D-NET International Corporation
+000BFB     (base 16)		D-NET International Corporation
+				15, Wu-Chuan 5th Road, Wu-Ku Industrial
+				Taipei  Hsieh    248
+				US
+
+00-0C-1D   (hex)		Mettler & Fuchs AG
+000C1D     (base 16)		Mettler & Fuchs AG
+				Querstrasse 17
+				CH-8951  Fahrweid  
+				CH
+
+00-0C-1E   (hex)		Global Cache
+000C1E     (base 16)		Global Cache
+				160 East California Street
+				Jacksonville  OR  97530
+				US
+
+00-0C-1A   (hex)		Quest Technical Solutions Inc.
+000C1A     (base 16)		Quest Technical Solutions Inc.
+				4110 Mourning Dove Crt.
+				Melbourne  FL  32934
+				US
+
+00-0C-24   (hex)		ANATOR
+000C24     (base 16)		ANATOR
+				44, rue d'Estienne d'Orves
+				sartrouville  yvelines  78500
+				FR
+
+00-0C-19   (hex)		Telio Communications GmbH
+000C19     (base 16)		Telio Communications GmbH
+				Elbchaussee 1
+				Hamburg    22765
+				DE
+
+00-0C-13   (hex)		MediaQ
+000C13     (base 16)		MediaQ
+				2975 San Ysidro Way
+				Santa Clara  CA  95051
+				US
+
+00-0C-06   (hex)		Nixvue Systems  Pte Ltd
+000C06     (base 16)		Nixvue Systems  Pte Ltd
+				30 Loyang Way, #07-02
+				Singapore  Singapore  S508769
+				SG
+
+00-0C-2D   (hex)		FullWave Technology Co., Ltd.
+000C2D     (base 16)		FullWave Technology Co., Ltd.
+				7F-6, No.26, TaiYuan St.,
+				JuBei  Hsin Chu  302
+				TW
+
+00-0C-26   (hex)		Weintek Labs. Inc.
+000C26     (base 16)		Weintek Labs. Inc.
+				3F, No.910, Chung Cheng Rd.
+				Chung Ho city  Taipei Hsien  236
+				TW
+
+00-0C-2B   (hex)		ELIAS Technology, Inc.
+000C2B     (base 16)		ELIAS Technology, Inc.
+				3F, 1015, Yung-An Road,
+				Taoyuan City  Taoyuan  330
+				TW
+
+00-0B-F0   (hex)		MoTEX Products Co., Ltd.
+000BF0     (base 16)		MoTEX Products Co., Ltd.
+				C.P.O.Box 6912
+				Chong-gu  Seoul  82
+				KR
+
+00-0B-F1   (hex)		LAP Laser Applikations
+000BF1     (base 16)		LAP Laser Applikations
+				Zeppelinstraße 23
+				Lüneburg  Niedersachsen  21337
+				DE
+
+00-0B-EE   (hex)		inc.jet, Incorporated
+000BEE     (base 16)		inc.jet, Incorporated
+				One Winnenden Road
+				Norwich  CT  06360
+				US
+
+00-0B-8D   (hex)		Avvio Networks
+000B8D     (base 16)		Avvio Networks
+				11 Donovan Dr
+				Bedford  MA  01730
+				US
+
+00-0B-85   (hex)		Cisco Systems, Inc
+000B85     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-7F   (hex)		Align Engineering LLC
+000B7F     (base 16)		Align Engineering LLC
+				245 Highlands Drive
+				Friday Harbor   WA  98250
+				US
+
+00-0B-A6   (hex)		Miyakawa Electric Works Ltd.
+000BA6     (base 16)		Miyakawa Electric Works Ltd.
+				2-1-6,
+				Yokohama  Kanagawa  222-0001
+				JP
+
+00-0B-93   (hex)		Ritter Elektronik
+000B93     (base 16)		Ritter Elektronik
+				Leverkuser Straße 65
+				Remscheid  NRW  42897
+				DE
+
+00-0B-9B   (hex)		Sirius System Co, Ltd.
+000B9B     (base 16)		Sirius System Co, Ltd.
+				3-27 Funado-cho
+				Ashiya  Hyogo  659-0093
+				JP
+
+00-0B-E2   (hex)		Lumenera Corporation
+000BE2     (base 16)		Lumenera Corporation
+				2520B St. Laurent Blvd.
+				Ottawa  Ontario  K1B 4R8
+				CA
+
+00-0B-E1   (hex)		Nokia NET Product Operations
+000BE1     (base 16)		Nokia NET Product Operations
+				313 Fairchild Drive
+				Mountain View  California  94043
+				US
+
+00-0B-A8   (hex)		HANBACK ELECTRONICS CO., LTD.
+000BA8     (base 16)		HANBACK ELECTRONICS CO., LTD.
+				306-7, Galma-dong, Seo-gu
+				Daejeon    302-171
+				KR
+
+00-0B-A9   (hex)		CloudShield Technologies, Inc.
+000BA9     (base 16)		CloudShield Technologies, Inc.
+				212 Gilbraltar Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0B-A1   (hex)		Fujikura Solutions Ltd.
+000BA1     (base 16)		Fujikura Solutions Ltd.
+				1565-6,Shirakusadai,Fukaya-shi
+				Saitama-ken    369-1106
+				JP
+
+00-0B-8E   (hex)		Ascent Corporation
+000B8E     (base 16)		Ascent Corporation
+				2-16-19, Kawaraya-machi, Chuo-Ku,
+				Osaka-City  Osaka-Pref  542-0066
+				JP
+
+00-0B-8F   (hex)		AKITA ELECTRONICS SYSTEMS CO.,LTD.
+000B8F     (base 16)		AKITA ELECTRONICS SYSTEMS CO.,LTD.
+				85,AZA USHIRONO,AIKAWA,YUWA-MACHI
+				KAWABE-GUN  AKITA-KEN  010-1231
+				JP
+
+00-0B-CB   (hex)		Fagor Automation , S. Coop
+000BCB     (base 16)		Fagor Automation , S. Coop
+				San Andres s/n
+				  Guipuzcoa  20500
+				ES
+
+00-0B-C8   (hex)		AirFlow Networks
+000BC8     (base 16)		AirFlow Networks
+				444 Castro St
+				Mountain View  Ca  94041
+				US
+
+00-0B-CE   (hex)		Free2move AB
+000BCE     (base 16)		Free2move AB
+				Sperlingsgatan 7
+				Halmstad  Halland  30248
+				SE
+
+00-0B-CF   (hex)		AGFA NDT INC.
+000BCF     (base 16)		AGFA NDT INC.
+				50 Industrial Park Road
+				Lewistown  PA  17044
+				US
+
+00-0B-C3   (hex)		Multiplex, Inc.
+000BC3     (base 16)		Multiplex, Inc.
+				5000 Hadley Rd.
+				S. Plainfield  NJ  07040
+				US
+
+00-0B-BE   (hex)		Cisco Systems, Inc
+000BBE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-E0   (hex)		SercoNet Ltd.
+000BE0     (base 16)		SercoNet Ltd.
+				16 Ha'haroshet st.
+				Ra'anana    43657
+				IL
+
+00-0B-BD   (hex)		Connexionz Limited
+000BBD     (base 16)		Connexionz Limited
+				1 Show Place
+				Christchurch    
+				NZ
+
+00-0B-40   (hex)		Cambridge Industries Group (CIG)
+000B40     (base 16)		Cambridge Industries Group (CIG)
+				2560 Junction Avenue
+				San Jose    95134
+				US
+
+00-0B-44   (hex)		Concord IDea Corp.
+000B44     (base 16)		Concord IDea Corp.
+				4118 14th Ave., Unit 4
+				Markham  Ontario  L3R 0J3
+				CA
+
+00-0B-42   (hex)		commax Co., Ltd.
+000B42     (base 16)		commax Co., Ltd.
+				513-11, Sangdaewon-Dong, Jungwon-Ku
+				Sungnam-City  Kyunggi-Do  462-120
+				KR
+
+00-0B-47   (hex)		Advanced Energy
+000B47     (base 16)		Advanced Energy
+				1625 Sharp Point Drive
+				Fort Collins  Colorado  80525
+				US
+
+00-0B-81   (hex)		Kaparel Corporation
+000B81     (base 16)		Kaparel Corporation
+				97 Randall Drive
+				Waterloo  Ontario  N2V-1C5
+				CA
+
+00-0B-82   (hex)		Grandstream Networks, Inc.
+000B82     (base 16)		Grandstream Networks, Inc.
+				1297 Beacon Street
+				Brookline  MA  02446
+				US
+
+00-0B-6E   (hex)		Neff Instrument Corp.
+000B6E     (base 16)		Neff Instrument Corp.
+				700 South Myrtle Ave.
+				Monrovia  CA  91016
+				US
+
+00-0B-72   (hex)		Lawo AG
+000B72     (base 16)		Lawo AG
+				Am Oberwald 8
+				Rastatt  Baden-Württemberg  76437
+				DE
+
+00-0B-31   (hex)		Yantai ZhiYang Scientific and technology industry CO., LTD
+000B31     (base 16)		Yantai ZhiYang Scientific and technology industry CO., LTD
+				5F-4, NO. 64, Gong-Jian Rd.
+				Hsi-Chih City  Taipei County  221
+				CN
+
+00-0B-2F   (hex)		bplan GmbH
+000B2F     (base 16)		bplan GmbH
+				Industriestrasse 23b
+				Steinbach  Hessen  61449
+				DE
+
+00-0B-3D   (hex)		CONTAL OK Ltd.
+000B3D     (base 16)		CONTAL OK Ltd.
+				Frana Mraza 2/289
+				Zilina    01124
+				SK
+
+00-0B-4E   (hex)		VertexRSI, General Dynamics SatCOM Technologies, Inc.
+000B4E     (base 16)		VertexRSI, General Dynamics SatCOM Technologies, Inc.
+				3750 W. Loop 281
+				Longview  TX  75604
+				US
+
+00-0B-4D   (hex)		Emuzed
+000B4D     (base 16)		Emuzed
+				46750 Lakeview Boulevard
+				Fremont  California  94538
+				US
+
+00-0B-24   (hex)		AirLogic
+000B24     (base 16)		AirLogic
+				807-1, Bundangtechnopark D, 151,
+				Sungnam-Si  Kyungki-Do  463-760
+				KR
+
+00-0B-78   (hex)		TAIFATECH INC.
+000B78     (base 16)		TAIFATECH INC.
+				8F-1 No.289, Sec.2  Guangfu Rd.
+				Hsinchu    300
+				TW
+
+00-0B-6C   (hex)		Sychip Inc.
+000B6C     (base 16)		Sychip Inc.
+				2805 N. Dallas Parkway Suite 400
+				Plano  Texas  75093
+				US
+
+00-91-D6   (hex)		Crystal Group, Inc.
+0091D6     (base 16)		Crystal Group, Inc.
+				850 Kacena Rd.
+				Hiawatha  IA  52233
+				US
+
+00-0B-5A   (hex)		HyperEdge
+000B5A     (base 16)		HyperEdge
+				333 Pierce Road Suite #200
+				Itasca  IL  60143
+				US
+
+00-0B-0F   (hex)		Bosch Rexroth
+000B0F     (base 16)		Bosch Rexroth
+				Luchthavenweg 20
+				Eindhoven  Noord Brabant  NL5657 EB
+				NL
+
+00-0B-0C   (hex)		Agile Systems Inc.
+000B0C     (base 16)		Agile Systems Inc.
+				575 Kumpf Drive
+				Waterloo  Ontario  N2V 1K3
+				CA
+
+00-0B-0A   (hex)		dBm Optics
+000B0A     (base 16)		dBm Optics
+				300 S. Public Road
+				Lafayette  Colorado  80026
+				US
+
+00-0B-09   (hex)		Ifoundry Systems Singapore
+000B09     (base 16)		Ifoundry Systems Singapore
+				Block 1, Unit 101B, Innovation Centre, 1
+				    637722
+				SG
+
+00-0B-1D   (hex)		LayerZero Power Systems, Inc.
+000B1D     (base 16)		LayerZero Power Systems, Inc.
+				3559 Townley Road
+				Shaker Heights  OH  44122-5156
+				US
+
+00-0B-19   (hex)		Vernier Networks, Inc.
+000B19     (base 16)		Vernier Networks, Inc.
+				490 E. Middlefield Road
+				Mountain View  CA  94043
+				US
+
+00-0B-16   (hex)		Communication Machinery Corporation
+000B16     (base 16)		Communication Machinery Corporation
+				402 E. Gutierrez St.
+				Santa Barbara  CA  93101
+				US
+
+00-0B-12   (hex)		NURI Telecom Co., Ltd.
+000B12     (base 16)		NURI Telecom Co., Ltd.
+				B-10F Woolim Lion's Valley 371-28
+				Geuncheon-gu  Seoul  153-803
+				KR
+
+00-0A-C5   (hex)		Color Kinetics
+000AC5     (base 16)		Color Kinetics
+				10 Milk Street
+				Boston  Masachusetts  02108
+				US
+
+00-0A-BD   (hex)		Rupprecht & Patashnick Co.
+000ABD     (base 16)		Rupprecht & Patashnick Co.
+				25 Corporate Circle
+				Albany  NY  12203
+				US
+
+00-0A-CB   (hex)		XPAK MSA Group
+000ACB     (base 16)		XPAK MSA Group
+				Care of: Molex Fiber Optics
+				Downers Grove  IL  60515
+				US
+
+00-0A-D5   (hex)		Brainchild Electronic Co., Ltd.
+000AD5     (base 16)		Brainchild Electronic Co., Ltd.
+				No.209, Chung Yang Rd.,
+				Taipei    115
+				TW
+
+00-0A-D6   (hex)		BeamReach Networks
+000AD6     (base 16)		BeamReach Networks
+				755 North Mathilda Ave
+				Sunnyvale  California  94086
+				US
+
+00-0A-FE   (hex)		NovaPal Ltd
+000AFE     (base 16)		NovaPal Ltd
+				Floor 6
+				Ealing  London  W5 2ST
+				GB
+
+00-0A-FD   (hex)		Kentec Electronics
+000AFD     (base 16)		Kentec Electronics
+				620 Allendale Rd
+				King of Prussia  PA  19406
+				US
+
+00-0A-EF   (hex)		OTRUM ASA
+000AEF     (base 16)		OTRUM ASA
+				Brattekleiv
+				Færvik    N-4818
+				NO
+
+00-0A-E5   (hex)		ScottCare Corporation
+000AE5     (base 16)		ScottCare Corporation
+				4791 West 150th Street
+				Cleveland  Ohio  44135
+				US
+
+00-0A-B0   (hex)		LOYTEC electronics GmbH
+000AB0     (base 16)		LOYTEC electronics GmbH
+				Stolzenthalergasse 24/3
+				Vienna    1080
+				AT
+
+00-0A-B5   (hex)		Digital Electronic Network
+000AB5     (base 16)		Digital Electronic Network
+				8 rue du sacré  coeur
+				Saint Laurent sur Sevre  Vendee  85290
+				FR
+
+00-0A-D2   (hex)		JEPICO Corporation
+000AD2     (base 16)		JEPICO Corporation
+				Nishi-shinjyuku2-7-1
+				Shinjyuku-ku  Tokyo  163-0729
+				JP
+
+00-0A-98   (hex)		M+F Gwinner GmbH & Co
+000A98     (base 16)		M+F Gwinner GmbH & Co
+				Weidenbaumsweg 91 a
+				Hamburg    21029
+				DE
+
+00-0A-9B   (hex)		TB Group Inc
+000A9B     (base 16)		TB Group Inc
+				 4F NREG Hongo 3-chome Bldg., 3-26-6, Hngo, Bunkyo-ku, 
+				Tokyo    113-003
+				JP
+
+00-0A-6C   (hex)		Walchem Corporation
+000A6C     (base 16)		Walchem Corporation
+				5 Boynton Road
+				Holliston  MA  01746
+				US
+
+00-0A-5F   (hex)		almedio inc.
+000A5F     (base 16)		almedio inc.
+				32-13, sakae-cho 2 chome
+				higashimurayama-shi  tokyo  189-0013
+				JP
+
+00-0A-6B   (hex)		Tadiran Telecom Business Systems LTD
+000A6B     (base 16)		Tadiran Telecom Business Systems LTD
+				18 Hasivim St.
+				Petach Tikva    49105
+				IL
+
+00-0A-61   (hex)		Cellinx Systems Inc.
+000A61     (base 16)		Cellinx Systems Inc.
+				408 Woosung Character199 officetel
+				Seoul    135-856
+				KR
+
+00-0A-78   (hex)		OLITEC
+000A78     (base 16)		OLITEC
+				B.P. 592
+				NANCY cedex    54009
+				FR
+
+00-0A-A9   (hex)		Brooks Automation GmbH
+000AA9     (base 16)		Brooks Automation GmbH
+				Goeschwitzer Strasse 25
+				Jena  Thuringia  07745
+				DE
+
+00-0A-A5   (hex)		MAXLINK INDUSTRIES LIMITED
+000AA5     (base 16)		MAXLINK INDUSTRIES LIMITED
+				29A SHENZHEN SPECIAL ZONE
+				SHENZHEN  GUANGDONG  518009
+				CN
+
+00-0A-A2   (hex)		SYSTEK INC.
+000AA2     (base 16)		SYSTEK INC.
+				JCOM BUILDING 402, OJEON-DONG 124-4,
+				UIWANG-SI  GYUNGGI-DO  437-070
+				KR
+
+00-0A-5B   (hex)		Power-One as
+000A5B     (base 16)		Power-One as
+				P.O. Box 1543
+				Drammen    3007
+				NO
+
+00-0A-55   (hex)		MARKEM Corporation
+000A55     (base 16)		MARKEM Corporation
+				150 Congress Street
+				Keene  NH  03431
+				US
+
+00-0A-73   (hex)		Scientific Atlanta
+000A73     (base 16)		Scientific Atlanta
+				5030 Sugarloaf Parkway
+				Lawrenceville  Ga  30042
+				US
+
+00-0A-69   (hex)		SUNNY bell Technology Co., Ltd.
+000A69     (base 16)		SUNNY bell Technology Co., Ltd.
+				#502 BUWON B/D 107-45 BANPO-DONG
+				SEOUL    137-806
+				KR
+
+00-0A-84   (hex)		Rainsun Enterprise Co., Ltd.
+000A84     (base 16)		Rainsun Enterprise Co., Ltd.
+				No.14-3 , Lane 235, Ho-Chen Road
+				ShinDian City  TAIPEI  231
+				TW
+
+00-0A-7E   (hex)		The Advantage Group
+000A7E     (base 16)		The Advantage Group
+				1610 Des Peres Road
+				St. Louis  MO  63131
+				US
+
+00-0A-4C   (hex)		Molecular Devices Corporation
+000A4C     (base 16)		Molecular Devices Corporation
+				1311 Orleans Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0A-4D   (hex)		Noritz Corporation
+000A4D     (base 16)		Noritz Corporation
+				5 Minami-Futami,
+				Akashi-shi  Hyogo  674-0093
+				JP
+
+00-0A-91   (hex)		HemoCue AB
+000A91     (base 16)		HemoCue AB
+				Box 1204
+				Ängelholm  Skåne län   26223
+				SE
+
+00-09-F2   (hex)		Cohu, Inc., Electronics Division
+0009F2     (base 16)		Cohu, Inc., Electronics Division
+				3912 Calle Fortunada
+				San Diego  CA  92123
+				US
+
+00-09-E9   (hex)		Cisco Systems, Inc
+0009E9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-DC   (hex)		Galaxis Technology AG
+0009DC     (base 16)		Galaxis Technology AG
+				Steinmetzstraße 7
+				Lübeck  Schleswig-Holstein  23556
+				DE
+
+00-0A-3A   (hex)		J-THREE INTERNATIONAL Holding Co., Ltd.
+000A3A     (base 16)		J-THREE INTERNATIONAL Holding Co., Ltd.
+				No. 1, Yu-3 Rd., Youth Industrial Park
+				Yang-mei, Taoyuan Hsien    326
+				TW
+
+00-0A-47   (hex)		Allied Vision Technologies
+000A47     (base 16)		Allied Vision Technologies
+				Taschenweg 2a
+				Stadtroda  Thüringen  07646
+				DE
+
+00-0A-3C   (hex)		Enerpoint Ltd.
+000A3C     (base 16)		Enerpoint Ltd.
+				Kaivopuistontie 33
+				Rauma    26100
+				FI
+
+00-0A-44   (hex)		Avery Dennison Deutschland GmbH
+000A44     (base 16)		Avery Dennison Deutschland GmbH
+				Ohmstraße 3
+				Eching    85386
+				DE
+
+00-09-F8   (hex)		UNIMO TECHNOLOGY CO., LTD.
+0009F8     (base 16)		UNIMO TECHNOLOGY CO., LTD.
+				BANGBAE DONG 479-12
+				SEOUL    137-820
+				KR
+
+00-09-FF   (hex)		X.net 2000 GmbH
+0009FF     (base 16)		X.net 2000 GmbH
+				Koenigsberger Str. 2c
+				Reinheim    64354
+				DE
+
+00-0A-03   (hex)		ENDESA SERVICIOS, S.L.
+000A03     (base 16)		ENDESA SERVICIOS, S.L.
+				AVGDA PARAL.LEL, 51
+				BARCELONA    08004
+				ES
+
+00-09-FE   (hex)		Daisy Technologies, Inc.
+0009FE     (base 16)		Daisy Technologies, Inc.
+				1209 Orange Street
+				City of Wilmington  DE  19801
+				US
+
+00-0A-28   (hex)		Motorola
+000A28     (base 16)		Motorola
+				600 N. US Hwy 45
+				Libertyville  IL  60048
+				US
+
+00-0A-29   (hex)		Pan Dacom Networking AG
+000A29     (base 16)		Pan Dacom Networking AG
+				Dreieich Plaza 1B
+				Dreieich  Hessen  D-63303
+				DE
+
+00-09-EB   (hex)		HuMANDATA LTD.
+0009EB     (base 16)		HuMANDATA LTD.
+				1-2-10
+				Ibaraki  Osaka  567-0034
+				JP
+
+00-09-E8   (hex)		Cisco Systems, Inc
+0009E8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-ED   (hex)		CipherOptics
+0009ED     (base 16)		CipherOptics
+				701 Corporate Center Drive
+				Raleigh  North Carolina  27607
+				US
+
+00-0A-40   (hex)		Crown Audio -- Harmanm International
+000A40     (base 16)		Crown Audio -- Harmanm International
+				1718 W. Mishawaka Rd
+				Elkhart  IN  46517
+				US
+
+00-0A-26   (hex)		CEIA S.p.A.
+000A26     (base 16)		CEIA S.p.A.
+				Zona Industriale di Viciomaggio 54
+				Arezzo  AR  52040
+				IT
+
+00-0A-1D   (hex)		Optical Communications Products Inc.
+000A1D     (base 16)		Optical Communications Products Inc.
+				20961 Knapp St.
+				Chatsworth  CA  91311
+				US
+
+00-0A-16   (hex)		Lassen Research
+000A16     (base 16)		Lassen Research
+				31695 Forward Road
+				Manton  CA  96059
+				US
+
+00-0A-18   (hex)		Vichel Inc.
+000A18     (base 16)		Vichel Inc.
+				3F Jang Bldg. 92-6 Yangjae-dong, Secho-g
+				Seoul    137-130
+				KR
+
+00-0A-06   (hex)		Teledex LLC
+000A06     (base 16)		Teledex LLC
+				6311 San Ignacio Avenue
+				San Jose  CA  95119
+				US
+
+00-09-A9   (hex)		Ikanos Communications
+0009A9     (base 16)		Ikanos Communications
+				47709 Fremont Blvd
+				Fremont  CA  94538
+				US
+
+00-09-9F   (hex)		VIDEX INC.
+00099F     (base 16)		VIDEX INC.
+				1105 NE Circle Blvd
+				Corvallis  OR  97330
+				US
+
+00-09-A2   (hex)		Interface Co., Ltd.
+0009A2     (base 16)		Interface Co., Ltd.
+				2-5-12-201 Kyonancho
+				Musashino-city  Tokyo  180-0023
+				JP
+
+00-09-A1   (hex)		Telewise Communications, Inc.
+0009A1     (base 16)		Telewise Communications, Inc.
+				2050 Ringwood Avenue
+				San Jose  CA  95131
+				US
+
+00-09-7D   (hex)		SecWell Networks Oy
+00097D     (base 16)		SecWell Networks Oy
+				P.O.BOX 174
+				Tampere    33101
+				FI
+
+00-09-76   (hex)		Datasoft ISDN Systems GmbH
+000976     (base 16)		Datasoft ISDN Systems GmbH
+				Schillerplatz 3
+				St. Poelten  Lower Austria  3100
+				AT
+
+00-09-C6   (hex)		Visionics Corporation
+0009C6     (base 16)		Visionics Corporation
+				5600 Rowland Road
+				Minnetonka  MN  55343
+				US
+
+00-09-D1   (hex)		SERANOA NETWORKS INC
+0009D1     (base 16)		SERANOA NETWORKS INC
+				CONCORD OFFICE CENTER
+				CONCORD  MA  01742
+				US
+
+00-09-CE   (hex)		SpaceBridge Semiconductor Corp.
+0009CE     (base 16)		SpaceBridge Semiconductor Corp.
+				115 rue Champlain
+				Hull  Quebec  J8X3R1
+				CA
+
+00-09-B8   (hex)		Entise Systems
+0009B8     (base 16)		Entise Systems
+				10095 Judy Avenue
+				Cupertino  CA  95014
+				US
+
+00-09-AF   (hex)		e-generis
+0009AF     (base 16)		e-generis
+				13 rue du chene germain
+				cesson sevigne    35510
+				FR
+
+00-09-AD   (hex)		HYUNDAI SYSCOMM, INC.
+0009AD     (base 16)		HYUNDAI SYSCOMM, INC.
+				SAN 136-1, AMI-RI, BUBAL-EUB
+				ICHON  KYOUNGKI-DO  467-701
+				KR
+
+00-09-BD   (hex)		Epygi Technologies, Ltd.
+0009BD     (base 16)		Epygi Technologies, Ltd.
+				5040 Addison Circle
+				Addison  Texas  75001
+				US
+
+00-09-C2   (hex)		Onity, Inc.
+0009C2     (base 16)		Onity, Inc.
+				2232 Northmont Parkway
+				Duluth  GA  30096
+				US
+
+00-09-C3   (hex)		NETAS
+0009C3     (base 16)		NETAS
+				Alemdag Cad. No 171
+				ISTANBUL    81244
+				TR
+
+00-09-B5   (hex)		3J Tech. Co., Ltd.
+0009B5     (base 16)		3J Tech. Co., Ltd.
+				342 Fushing N. Rd., 2F, Taipei, Taiwan
+				Taipei    104
+				TW
+
+00-09-82   (hex)		Loewe Opta GmbH
+000982     (base 16)		Loewe Opta GmbH
+				Industriestrasse 11
+				Kronach    96317
+				DE
+
+00-09-83   (hex)		GlobalTop Technology, Inc.
+000983     (base 16)		GlobalTop Technology, Inc.
+				 #16 Nan-Ke 9th Road
+				Tainan    741
+				TW
+
+00-09-DD   (hex)		Mavin Technology Inc.
+0009DD     (base 16)		Mavin Technology Inc.
+				Room 305, Bldg. 52 No. 195-28
+				Chutung, Hsinchu    310
+				TW
+
+00-09-7A   (hex)		Louis Design Labs.
+00097A     (base 16)		Louis Design Labs.
+				2F,NO 4, Lane 497, Chung-Cheng Rd.,Hsin-
+				Hsin-Tien  Taipei Hsien  231
+				TW
+
+00-09-6B   (hex)		IBM Corp
+00096B     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-09-6D   (hex)		Powernet Technologies Corp.
+00096D     (base 16)		Powernet Technologies Corp.
+				371-51, Gasan-Dong Kumchon-Gu,
+				Seoul    153-803
+				KR
+
+00-09-64   (hex)		Hi-Techniques, Inc.
+000964     (base 16)		Hi-Techniques, Inc.
+				2515 Frazier Ave.
+				Madison  WI  53713-1505
+				US
+
+00-09-65   (hex)		HyunJu Computer Co., Ltd.
+000965     (base 16)		HyunJu Computer Co., Ltd.
+				222-22, Hyunju B/D, Guro 3 Dong, Gurogu
+				Seoul    152-848
+				KR
+
+00-09-39   (hex)		ShibaSoku Co.,Ltd.
+000939     (base 16)		ShibaSoku Co.,Ltd.
+				6-8 Shinbashi 4-chome
+				Minato-ku  Tokyo  105-0004
+				JP
+
+00-09-33   (hex)		Ophit Co.Ltd.
+000933     (base 16)		Ophit Co.Ltd.
+				3F. Suntechnovil, 5-27  Mangpo-Dong ,
+				Kyungki-Do    137-070
+				KR
+
+00-09-32   (hex)		Omnilux
+000932     (base 16)		Omnilux
+				130 W. Union St.
+				Pasadena  CA  91103
+				US
+
+00-09-1C   (hex)		CacheVision, Inc
+00091C     (base 16)		CacheVision, Inc
+				1990 Concourse Drive
+				San Jose  CA  95131
+				US
+
+00-09-1A   (hex)		Macat Optics & Electronics Co., Ltd.
+00091A     (base 16)		Macat Optics & Electronics Co., Ltd.
+				15/F., Macat Center, No. 63 Macat Road
+				Huizhou  Guangdong  516001
+				CN
+
+00-09-1B   (hex)		Digital Generation Inc.
+00091B     (base 16)		Digital Generation Inc.
+				5F, Ho-Sam B/D, #30-3, Bongchun6-Dong
+				Kwanak-Ku,  Seoul  151-089
+				KR
+
+00-09-29   (hex)		Sanyo Industries (UK) Limited
+000929     (base 16)		Sanyo Industries (UK) Limited
+				School Road
+				Lowestoft  Suffolk  NR33 9NA
+				GB
+
+00-09-28   (hex)		Telecore
+000928     (base 16)		Telecore
+				1800 North Glenville
+				Richardson  TX  75081
+				US
+
+00-09-2E   (hex)		B&Tech System Inc.
+00092E     (base 16)		B&Tech System Inc.
+				#601, Seo-Jung B/D, 830-24, Youksam-Dong
+				Seoul    
+				KR
+
+00-09-6F   (hex)		Beijing Zhongqing Elegant Tech. Corp.,Limited
+00096F     (base 16)		Beijing Zhongqing Elegant Tech. Corp.,Limited
+				Rm.508, A-Building, Shangdi Digital Scie
+				Beijing    100084
+				CN
+
+00-09-5E   (hex)		Masstech Group Inc.
+00095E     (base 16)		Masstech Group Inc.
+				2 East Beaver Creek Rd.
+				Richmond Hill  Ontario  L4B 2N3
+				CA
+
+00-09-4F   (hex)		elmegt GmbH & Co. KG
+00094F     (base 16)		elmegt GmbH & Co. KG
+				Kommunikationstechnik
+				Peine  Niedersachsen  D-31228
+				DE
+
+00-09-43   (hex)		Cisco Systems, Inc
+000943     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-02   (hex)		Redline Communications Inc.
+000902     (base 16)		Redline Communications Inc.
+				302 Town Centre Blvd
+				Markham  ON  L3R 0E8
+				CA
+
+00-08-FA   (hex)		KEB Automation KG
+0008FA     (base 16)		KEB Automation KG
+				Südstraße 38
+				Barntrup  NRW  D-32683
+				DE
+
+00-09-59   (hex)		Sitecsoft
+000959     (base 16)		Sitecsoft
+				7th Gugu BD. 145-18 Samsung-Dong
+				Seoul  Seoul  135-090
+				KR
+
+00-09-57   (hex)		Supercaller, Inc.
+000957     (base 16)		Supercaller, Inc.
+				101 Saginaw Drive
+				Redwood City  CA  94063
+				US
+
+00-08-D2   (hex)		ZOOM Networks Inc.
+0008D2     (base 16)		ZOOM Networks Inc.
+				13F,XinLuDao Building,No.1175,Nanshan Ro
+				Shen Zhen  GuangDong Province  518052
+				US
+
+00-08-C5   (hex)		Liontech Co., Ltd.
+0008C5     (base 16)		Liontech Co., Ltd.
+				306, Wooyoung Techno Center, 273-15,
+				Seoul    133-831
+				KR
+
+00-08-AC   (hex)		Eltromat GmbH
+0008AC     (base 16)		Eltromat GmbH
+				Herforder Straße 249-251
+				Leopoldshöhe  Nordrhein-Westfalen  33818
+				DE
+
+00-08-AA   (hex)		KARAM
+0008AA     (base 16)		KARAM
+				98-3,  Hankangro 2-KA, Yongsan
+				Seoul    140-012
+				KR
+
+00-08-AB   (hex)		EnerLinx.com, Inc.
+0008AB     (base 16)		EnerLinx.com, Inc.
+				3965 South Woodhill Lane
+				New Berlin  WI  53151
+				US
+
+00-08-AD   (hex)		Toyo-Linx Co., Ltd.
+0008AD     (base 16)		Toyo-Linx Co., Ltd.
+				Hirakawa-Cho, Chiyada-ku,
+				Tokyo    102-0093
+				JP
+
+00-08-F2   (hex)		C&S Technology
+0008F2     (base 16)		C&S Technology
+				C&S Venture Bldg., NonHyun-Dong,
+				SEOUL    135-829
+				KR
+
+00-08-EA   (hex)		Motion Control Engineering, Inc
+0008EA     (base 16)		Motion Control Engineering, Inc
+				11380 White Rock Road
+				Rancho Cordova  CA  95742
+				US
+
+00-08-ED   (hex)		ST&T Instrument Corp.
+0008ED     (base 16)		ST&T Instrument Corp.
+				16 Shing-Gong Road, Yung-Kung Industrial
+				Yung-Kung  Tainan  710
+				TW
+
+00-08-88   (hex)		OULLIM Information Technology Inc,.
+000888     (base 16)		OULLIM Information Technology Inc,.
+				a-10th FL,. IT Venture Tower,
+				Seoul    138-803
+				KR
+
+00-08-85   (hex)		EMS Dr. Thomas Wünsche
+000885     (base 16)		EMS Dr. Thomas Wünsche
+				Sonnenhang 3
+				    
+				DE
+
+00-08-72   (hex)		Sorenson Communications
+000872     (base 16)		Sorenson Communications
+				4192 South Riverboat Road
+				Salt Lake City  UT  84123
+				US
+
+00-08-9A   (hex)		Alcatel Microelectronics
+00089A     (base 16)		Alcatel Microelectronics
+				Excelsiorlaan 44-46
+				B-1930 Zavantem    
+				BE
+
+00-08-A1   (hex)		CNet Technology Inc.
+0008A1     (base 16)		CNet Technology Inc.
+				No.15, Park Avenue II, Science-Based Ind
+				Hsin-Chu    300
+				TW
+
+00-08-93   (hex)		LE INFORMATION COMMUNICATION INC.
+000893     (base 16)		LE INFORMATION COMMUNICATION INC.
+				Rm, 4501, DA-Dong Chungang Circulation C
+				Seoul    152-721
+				KR
+
+00-08-B0   (hex)		BKtel communications GmbH
+0008B0     (base 16)		BKtel communications GmbH
+				Benzstraße 4
+				41836 Hückelhoven-Baal  NRW  41836
+				DE
+
+00-08-CA   (hex)		TwinHan Technology Co.,Ltd
+0008CA     (base 16)		TwinHan Technology Co.,Ltd
+				13F-6,No 79,Sec 1,Hsin Tai Wu RD.,Hsi-Ch
+				Taipei Hsien    221
+				TW
+
+00-08-B6   (hex)		RouteFree, Inc.
+0008B6     (base 16)		RouteFree, Inc.
+				3400 Hillview Ave., Building 5
+				Palo Alto  CA  94304
+				US
+
+00-08-D8   (hex)		Dowkey Microwave
+0008D8     (base 16)		Dowkey Microwave
+				4822 McGrath Street
+				Ventura  Ca  93003
+				US
+
+00-08-DF   (hex)		Alistel Inc.
+0008DF     (base 16)		Alistel Inc.
+				Midori Bldg. 2F
+				Yokohama  Kanagawa  222-0001
+				JP
+
+00-08-DB   (hex)		Corrigent Systems
+0008DB     (base 16)		Corrigent Systems
+				126 Yigal Alon
+				Tel Aviv    67443
+				IL
+
+00-08-7C   (hex)		Cisco Systems, Inc
+00087C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-79   (hex)		CEM Corporation
+000879     (base 16)		CEM Corporation
+				P.O. Box 200
+				Matthews  NC  28106
+				US
+
+00-08-7D   (hex)		Cisco Systems, Inc
+00087D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-08-75   (hex)		Acorp Electronics Corp.
+000875     (base 16)		Acorp Electronics Corp.
+				8F, No.111-6,Shing Teh Rd,
+				San Chung  Taipei Hsien  241
+				TW
+
+00-08-16   (hex)		Bluelon ApS
+000816     (base 16)		Bluelon ApS
+				Nattergalevej 6
+				    
+				DK
+
+00-08-11   (hex)		VOIX Corporation
+000811     (base 16)		VOIX Corporation
+				1991-3 4th Floor Top's Venture Tower
+				Seoul    138-090
+				KR
+
+00-08-06   (hex)		Raonet Systems, Inc.
+000806     (base 16)		Raonet Systems, Inc.
+				West Wing 14F, IT Venture Tower 78
+				Seoul    138-803
+				KR
+
+00-08-6F   (hex)		Resources Computer Network Ltd.
+00086F     (base 16)		Resources Computer Network Ltd.
+				Rm 324, Tech Centre, 72 Tat Chee Ave.,
+				    
+				HK
+
+00-08-67   (hex)		Uptime Devices
+000867     (base 16)		Uptime Devices
+				11724 Dunfries Lane
+				Austin  Texas  78754
+				US
+
+00-07-F8   (hex)		ITDevices, Inc.
+0007F8     (base 16)		ITDevices, Inc.
+				606 110th Ave. NE
+				Bellevue  WA  98004
+				US
+
+00-07-F3   (hex)		Thinkengine Networks
+0007F3     (base 16)		Thinkengine Networks
+				100 Nickerson Road
+				Marlborough  MA  01752
+				US
+
+00-08-1C   (hex)		@pos.com
+00081C     (base 16)		@pos.com
+				3051 North First Street
+				San Jose  CA  95134
+				US
+
+00-08-1E   (hex)		Repeatit AB
+00081E     (base 16)		Repeatit AB
+				Farogatan 7
+				    
+				SE
+
+00-08-56   (hex)		Gamatronic Electronic Industries Ltd.
+000856     (base 16)		Gamatronic Electronic Industries Ltd.
+				Hartum Street 14
+				    
+				IL
+
+00-08-53   (hex)		Schleicher GmbH & Co. Relaiswerke KG
+000853     (base 16)		Schleicher GmbH & Co. Relaiswerke KG
+				Pichelswerderstrasse 3-5
+				    
+				DE
+
+00-08-26   (hex)		Colorado Med Tech
+000826     (base 16)		Colorado Med Tech
+				6175 Longbow Dr.
+				Boulder  CO  80301
+				US
+
+00-08-5E   (hex)		PCO AG
+00085E     (base 16)		PCO AG
+				Donaupark 11
+				    
+				DE
+
+00-07-9A   (hex)		Verint Systems Inc
+00079A     (base 16)		Verint Systems Inc
+				1800 Berlier, Suite 440
+				Laval,   Quebec  H7L 4S4
+				CA
+
+00-07-74   (hex)		GuangZhou Thinker Technology Co. Ltd.
+000774     (base 16)		GuangZhou Thinker Technology Co. Ltd.
+				109 Zhongshan Ave., Tianhe District
+				    510630
+				CN
+
+00-07-98   (hex)		Selea SRL
+000798     (base 16)		Selea SRL
+				Via A. Moro No. 69
+				    
+				IT
+
+00-07-91   (hex)		International Data Communications, Inc.
+000791     (base 16)		International Data Communications, Inc.
+				47873 Fremont Blvd.
+				Fremont  CA  04538
+				US
+
+00-07-EE   (hex)		telco Informationssysteme GmbH
+0007EE     (base 16)		telco Informationssysteme GmbH
+				Schulstrasse 38
+				    
+				DE
+
+00-07-E2   (hex)		Bitworks, Inc.
+0007E2     (base 16)		Bitworks, Inc.
+				#1 Bitworks Way
+				Prairie Grove  AR  72753
+				US
+
+00-07-E6   (hex)		edgeflow Canada Inc.
+0007E6     (base 16)		edgeflow Canada Inc.
+				329 March Road
+				    K2K 2E1
+				CA
+
+00-07-E5   (hex)		Coup Corporation
+0007E5     (base 16)		Coup Corporation
+				1-24-4 Marusen 2nd Bld. 4F,
+				Tokyo    
+				JP
+
+00-07-DE   (hex)		eCopilt AB
+0007DE     (base 16)		eCopilt AB
+				Veddestavagen 24
+				    
+				SE
+
+00-07-C8   (hex)		Brain21, Inc.
+0007C8     (base 16)		Brain21, Inc.
+				19F Mesa B/D, 204 Hoihyun-Dong
+				Seoul    100-051
+				KR
+
+00-07-C5   (hex)		Gcom, Inc.
+0007C5     (base 16)		Gcom, Inc.
+				1800 Woodfield Dr.
+				Savoy  IL  61874
+				US
+
+00-07-C1   (hex)		Overture Networks, Inc.
+0007C1     (base 16)		Overture Networks, Inc.
+				637 Davis Drive
+				Morrisville  NC  227560
+				US
+
+00-07-A7   (hex)		A-Z Inc.
+0007A7     (base 16)		A-Z Inc.
+				5-5-17 Kamikoushien
+				    
+				JP
+
+00-07-A6   (hex)		Leviton Manufacturing Co., Inc.
+0007A6     (base 16)		Leviton Manufacturing Co., Inc.
+				4330 Michoud Blvd
+				New Orleans  LA  70129
+				US
+
+00-07-A3   (hex)		Ositis Software, Inc.
+0007A3     (base 16)		Ositis Software, Inc.
+				6120 Stoneridge Mall Road
+				Pleasanton  CA  94588
+				US
+
+00-07-C2   (hex)		Netsys Telecom
+0007C2     (base 16)		Netsys Telecom
+				4F, KyungNam B/D, 830-48, YeokSam-Dong
+				Seoul    135-080
+				KR
+
+00-07-8F   (hex)		Emkay Innovative Products
+00078F     (base 16)		Emkay Innovative Products
+				53, Pao Hsing Rd., Hsintien City
+				Taipei    
+				TW
+
+00-07-82   (hex)		Oracle Corporation 
+000782     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-07-AE   (hex)		Britestream Networks, Inc.
+0007AE     (base 16)		Britestream Networks, Inc.
+				12401 Research Blvd.
+				Austin  TX  78759
+				US
+
+00-07-B1   (hex)		Equator Technologies
+0007B1     (base 16)		Equator Technologies
+				1300 White Oaks Rd.
+				Campbell  CA  95008
+				US
+
+00-05-F9   (hex)		TOA Corporation
+0005F9     (base 16)		TOA Corporation
+				2-1 Takamatsu-cho,
+				Hyogo    665-0043
+				JP
+
+00-07-CA   (hex)		Creatix Polymedia Ges Fur Kommunikaitonssysteme
+0007CA     (base 16)		Creatix Polymedia Ges Fur Kommunikaitonssysteme
+				Heinrich-Barth-Straße 3
+				    
+				DE
+
+00-07-DF   (hex)		Vbrick Systems Inc.
+0007DF     (base 16)		Vbrick Systems Inc.
+				12 Beaumont Road
+				Wallingford  CT  06492
+				US
+
+00-07-44   (hex)		Unico, Inc.
+000744     (base 16)		Unico, Inc.
+				3725 Nicholson Rd.
+				Franksville  WI  53126
+				US
+
+00-07-49   (hex)		CENiX Inc.
+000749     (base 16)		CENiX Inc.
+				5141 California Avenue
+				Irvine  CA  92612
+				US
+
+00-07-3D   (hex)		Nanjing Postel Telecommunications Co., Ltd.
+00073D     (base 16)		Nanjing Postel Telecommunications Co., Ltd.
+				No. 187, ShengZhou Road,
+				    210004
+				CN
+
+00-07-39   (hex)		Scotty Group Austria Gmbh
+000739     (base 16)		Scotty Group Austria Gmbh
+				Teslastrasse 4
+				8074 Grambach    8074
+				AT
+
+00-07-4E   (hex)		IPFRONT Inc
+00074E     (base 16)		IPFRONT Inc
+				4F ALT Bldg.,
+				  Tokyo  101-0021
+				JP
+
+00-07-52   (hex)		Rhythm Watch Co., Ltd.
+000752     (base 16)		Rhythm Watch Co., Ltd.
+				321 Shinshukushinden, Showa-Machi,
+				    344-0196
+				JP
+
+00-07-4F   (hex)		Cisco Systems, Inc
+00074F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-43   (hex)		Chelsio Communications
+000743     (base 16)		Chelsio Communications
+				170 S. Whismon Rd.
+				Mountain View  CA  94041-1512
+				US
+
+00-07-47   (hex)		Mecalc
+000747     (base 16)		Mecalc
+				PO Box 7958
+				    
+				ZA
+
+00-07-79   (hex)		Sungil Telecom Co., Ltd.
+000779     (base 16)		Sungil Telecom Co., Ltd.
+				#321, Gongdan-Dong,
+				    730-030
+				KR
+
+00-07-7E   (hex)		Elrest GmbH
+00077E     (base 16)		Elrest GmbH
+				Leibnizstraße 10
+				    
+				DE
+
+00-07-78   (hex)		GERSTEL GmbH & Co. KG
+000778     (base 16)		GERSTEL GmbH & Co. KG
+				Eberhard-Gerstel-Platz 1
+				Mülheim an der Ruhr    
+				DE
+
+00-07-6D   (hex)		Flexlight Networks
+00076D     (base 16)		Flexlight Networks
+				15 Atir Yeda St.
+				    
+				IL
+
+00-07-30   (hex)		Hutchison OPTEL Telecom Technology Co., Ltd.
+000730     (base 16)		Hutchison OPTEL Telecom Technology Co., Ltd.
+				No. 28 Xinwai Street
+				Beijing    
+				CN
+
+00-07-22   (hex)		The Nielsen Company
+000722     (base 16)		The Nielsen Company
+				501 Brooker Creek Blvd.
+				Oldsmar  FL  34677
+				US
+
+00-07-60   (hex)		TOMIS Information & Telecom Corp.
+000760     (base 16)		TOMIS Information & Telecom Corp.
+				Youngdeungpo telephone office - extensio
+				Seoul    
+				KR
+
+00-07-35   (hex)		Flarion Technologies, Inc.
+000735     (base 16)		Flarion Technologies, Inc.
+				135 Route 202/206 South
+				Bedminster  NJ  07921
+				US
+
+00-07-5E   (hex)		Ametek Power Instruments
+00075E     (base 16)		Ametek Power Instruments
+				4050 NW 121 Avenue
+				Coral Springs  FL  33065
+				US
+
+00-07-1F   (hex)		European Systems Integration
+00071F     (base 16)		European Systems Integration
+				455 Promenade Des Anglas
+				    
+				FR
+
+00-07-21   (hex)		Formac Elektronik GmbH
+000721     (base 16)		Formac Elektronik GmbH
+				Dofstraße 33
+				    
+				DE
+
+00-07-86   (hex)		Wireless Networks Inc.
+000786     (base 16)		Wireless Networks Inc.
+				#300, 3016 Fifth Ave. NE
+				    T2A 6K4
+				CA
+
+00-06-BC   (hex)		Macrolink, Inc.
+0006BC     (base 16)		Macrolink, Inc.
+				1500 N Kellogg Dr.
+				Anaheim  CA  92807
+				US
+
+00-06-C2   (hex)		Smartmatic Corporation
+0006C2     (base 16)		Smartmatic Corporation
+				6400 Congress Ave., Suite 1300
+				Boca Raton  FL  33487
+				US
+
+00-06-54   (hex)		Winpresa Building Automation Technologies GmbH
+000654     (base 16)		Winpresa Building Automation Technologies GmbH
+				Vivenotgasse 53/2
+				    
+				AT
+
+00-06-B4   (hex)		Vorne Industries, Inc.
+0006B4     (base 16)		Vorne Industries, Inc.
+				1445 Industrial Dr.
+				Itasca  IL  60143-1849
+				US
+
+00-06-AE   (hex)		Himachal Futuristic Communications Ltd
+0006AE     (base 16)		Himachal Futuristic Communications Ltd
+				8, Commercial Complex
+				New Dehli    110048
+				IN
+
+00-06-E5   (hex)		Fujian Newland Computer Ltd. Co.
+0006E5     (base 16)		Fujian Newland Computer Ltd. Co.
+				141F Sunshine Holiday Hotel
+				Fuzhou Fujian    350005
+				CN
+
+00-06-DE   (hex)		Flash Technology
+0006DE     (base 16)		Flash Technology
+				P.O. Box 681509
+				Franklin  TN  37068
+				US
+
+00-06-DF   (hex)		AIDONIC Corporation
+0006DF     (base 16)		AIDONIC Corporation
+				2-7-10 Otsuka, Bunkyo-ku,
+				  Tokyo,  112-0012
+				JP
+
+00-06-DD   (hex)		AT & T Laboratories - Cambridge Ltd
+0006DD     (base 16)		AT & T Laboratories - Cambridge Ltd
+				24a Trumpington Street
+				  ENGLAND  
+				GB
+
+00-06-F0   (hex)		Digeo, Inc.
+0006F0     (base 16)		Digeo, Inc.
+				8815 122nd Ave., NE
+				Kirkland  WA  98033
+				US
+
+00-07-00   (hex)		Zettamedia Korea
+000700     (base 16)		Zettamedia Korea
+				Suite 1008, Kumkang Venturetel, 1108
+				Kyounggido,    
+				KR
+
+00-06-C5   (hex)		INNOVI Technologies Limited
+0006C5     (base 16)		INNOVI Technologies Limited
+				31st Floor, China Online Centre
+				  Wanchai  
+				HK
+
+00-06-C6   (hex)		lesswire AG
+0006C6     (base 16)		lesswire AG
+				Im Technologiepark 25
+				    
+				DE
+
+00-06-B7   (hex)		TELEM GmbH
+0006B7     (base 16)		TELEM GmbH
+				Lise-Meitner-Allee 31
+				    
+				DE
+
+00-06-EF   (hex)		Maxxan Systems, Inc.
+0006EF     (base 16)		Maxxan Systems, Inc.
+				107 Bonaventura Drive
+				San Jose  CA  95134
+				US
+
+00-06-E9   (hex)		Intime Corp.
+0006E9     (base 16)		Intime Corp.
+				324-4, Yangjae-dong, 2F
+				    
+				KR
+
+00-06-EA   (hex)		ELZET80 Mikrocomputer GmbH&Co. KG
+0006EA     (base 16)		ELZET80 Mikrocomputer GmbH&Co. KG
+				Theaterplatz 9
+				    
+				DE
+
+00-07-08   (hex)		Bitrage Inc.
+000708     (base 16)		Bitrage Inc.
+				100 Southpark Blvd.
+				Saint Augustine  FL  32086
+				US
+
+00-07-12   (hex)		JAL Information Technology
+000712     (base 16)		JAL Information Technology
+				Network Solution Dep. JAL-Tamachi Bldg.
+				Tokyo    
+				JP
+
+00-07-13   (hex)		IP One, Inc.
+000713     (base 16)		IP One, Inc.
+				Sammi Bldg., 1004
+				Seoul,    135-083
+				KR
+
+00-07-07   (hex)		Interalia Inc.
+000707     (base 16)		Interalia Inc.
+				4110-79th Street N.W.
+				    T3B 5C2
+				CA
+
+00-06-F2   (hex)		Platys Communications
+0006F2     (base 16)		Platys Communications
+				3150A Coronado Dr.
+				Santa Clara  CA  95054
+				US
+
+00-06-FA   (hex)		IP SQUARE Co, Ltd.
+0006FA     (base 16)		IP SQUARE Co, Ltd.
+				1-9-11, Hakataekihigashi,
+				Fukuoka    812-0013
+				JP
+
+00-07-03   (hex)		CSEE Transport
+000703     (base 16)		CSEE Transport
+				4, avenue du CANADA
+				    
+				FR
+
+00-07-06   (hex)		Sanritz Corporation
+000706     (base 16)		Sanritz Corporation
+				1-30-13, Narimasu,
+				    175-0094
+				JP
+
+00-06-D1   (hex)		Tahoe Networks, Inc.
+0006D1     (base 16)		Tahoe Networks, Inc.
+				3052 Orchard Drive
+				San Jose  CA  95134
+				US
+
+00-06-D4   (hex)		Interactive Objects, Inc.
+0006D4     (base 16)		Interactive Objects, Inc.
+				12600 SE 38th St.
+				Bellevue  WA  98006
+				US
+
+00-06-CA   (hex)		American Computer & Digital Components, Inc. (ACDC)
+0006CA     (base 16)		American Computer & Digital Components, Inc. (ACDC)
+				440 Cloverleaf Drive
+				Baldwin Park  CA  91706
+				US
+
+00-06-CE   (hex)		DATENO
+0006CE     (base 16)		DATENO
+				Rue Amiral Berenger
+				    
+				FR
+
+00-06-8E   (hex)		HID Corporation
+00068E     (base 16)		HID Corporation
+				9292 Jeronimo Road
+				Irvine  CA  92618-1905
+				US
+
+00-06-8A   (hex)		NeuronNet Co. Ltd. R&D Center
+00068A     (base 16)		NeuronNet Co. Ltd. R&D Center
+				735-34 Dasung Bldg., Yuksam-dong,
+				    
+				KR
+
+00-06-85   (hex)		NetNearU Corporation
+000685     (base 16)		NetNearU Corporation
+				2908 Finfeather Road
+				Bryan  TX  77801
+				US
+
+00-06-50   (hex)		Tiburon Networks, Inc.
+000650     (base 16)		Tiburon Networks, Inc.
+				200 Minuteman Rd.
+				Andover  MA  01810
+				US
+
+00-06-5E   (hex)		Photuris, Inc.
+00065E     (base 16)		Photuris, Inc.
+				20 Corporate Place South
+				Piscataway  NJ  08854
+				US
+
+00-06-7F   (hex)		Digeo, Inc.
+00067F     (base 16)		Digeo, Inc.
+				8815 122nd Avenue NE
+				Kirkland  WA  98033
+				US
+
+00-06-83   (hex)		Bravara Communications, Inc.
+000683     (base 16)		Bravara Communications, Inc.
+				2650 East Bayshore Road
+				Palo Alto  CA  94303
+				US
+
+00-06-55   (hex)		Yipee, Inc.
+000655     (base 16)		Yipee, Inc.
+				555 International Drive
+				Williamsville  NY  14221
+				US
+
+00-06-76   (hex)		Novra Technologies Inc.
+000676     (base 16)		Novra Technologies Inc.
+				900-330 St. Mary Avenue
+				Winnipeg  Manitoba  R3C 3Z5
+				CA
+
+00-06-64   (hex)		Fostex Corporation
+000664     (base 16)		Fostex Corporation
+				3-2-35, Musashino, Akishima,
+				Tokyo    196-0021
+				JP
+
+00-06-7A   (hex)		JMP Systems
+00067A     (base 16)		JMP Systems
+				3rd Fl. Shinwha Bldg.,
+				Seocho-ku  Seoul,  
+				KR
+
+00-06-73   (hex)		TKH Security Solutions USA
+000673     (base 16)		TKH Security Solutions USA
+				12920 Cloverleaf Center Drive
+				Germantown  MD  20874
+				US
+
+00-06-9B   (hex)		AVT Audio Video Technologies GmbH
+00069B     (base 16)		AVT Audio Video Technologies GmbH
+				Rathsbergstraße 17
+				    
+				DE
+
+00-06-93   (hex)		Flexus Computer Technology, Inc.
+000693     (base 16)		Flexus Computer Technology, Inc.
+				8F-2, No.5, Alley22, Lane 513,
+				Taipei 114    
+				TW
+
+00-06-5D   (hex)		Heidelberg Web Systems
+00065D     (base 16)		Heidelberg Web Systems
+				121 Technology Dr.
+				Durham  NH  03824
+				US
+
+00-06-B0   (hex)		Comtech EF Data Corp.
+0006B0     (base 16)		Comtech EF Data Corp.
+				2114 W. 7th St.
+				Tempe  AZ  85281
+				US
+
+00-06-96   (hex)		Advent Networks
+000696     (base 16)		Advent Networks
+				9600 Great Hills Tr.
+				Austin  TX  78759
+				US
+
+00-05-D7   (hex)		Vista Imaging, Inc.
+0005D7     (base 16)		Vista Imaging, Inc.
+				521 Taylor Way
+				San Carlos  CA  94070
+				US
+
+00-05-DB   (hex)		PSI Nentec GmbH
+0005DB     (base 16)		PSI Nentec GmbH
+				Greschbachstraße12
+				Karlsruhe    76229
+				DE
+
+00-05-DD   (hex)		Cisco Systems, Inc
+0005DD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-28   (hex)		Cisco Systems, Inc
+000628     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-1D   (hex)		MIP Telecom, Inc.
+00061D     (base 16)		MIP Telecom, Inc.
+				3rd Floor, Sangil BLDG,
+				Seoul    151-069
+				KR
+
+00-06-19   (hex)		Connection Technology Systems
+000619     (base 16)		Connection Technology Systems
+				18F-6, No. 79, Sec. 1,
+				Hsinchih  Taipei,  
+				TW
+
+00-06-40   (hex)		White Rock Networks
+000640     (base 16)		White Rock Networks
+				Suite #900
+				Dallas  TX  75252
+				US
+
+00-06-44   (hex)		NextGen Business Solutions, Inc
+000644     (base 16)		NextGen Business Solutions, Inc
+				KKS Higashi-Sapporo Bldg.3-5-3-24, Higashi-Sapporo
+				Shiroishi-ku, Sapporo-city  Hokkaido  003-0003
+				JP
+
+00-06-45   (hex)		Meisei Electric Co. Ltd.
+000645     (base 16)		Meisei Electric Co. Ltd.
+				249-1, Moriya-kou, Moriya
+				    302-0192
+				JP
+
+A0-6A-00   (hex)		Verilink Corporation
+A06A00     (base 16)		Verilink Corporation
+				127 Jetplex Circle
+				Madison  AL  35758
+				US
+
+00-05-F8   (hex)		Real Time Access, Inc.
+0005F8     (base 16)		Real Time Access, Inc.
+				455 N. Canyons Pkwy.
+				Livermore  CA  94550
+				US
+
+00-05-EB   (hex)		Blue Ridge Networks, Inc.
+0005EB     (base 16)		Blue Ridge Networks, Inc.
+				14120 Parke Long Court
+				Chantilly  VA  20151
+				US
+
+00-05-E8   (hex)		TurboWave, Inc.
+0005E8     (base 16)		TurboWave, Inc.
+				555 South State
+				Orem  UT  84058
+				US
+
+00-05-F6   (hex)		Young Chang Co. Ltd.
+0005F6     (base 16)		Young Chang Co. Ltd.
+				1432 Main Street
+				Waltham  MA  02451
+				US
+
+00-05-FC   (hex)		Schenck Pegasus Corp.
+0005FC     (base 16)		Schenck Pegasus Corp.
+				2890 John R Road
+				Troy  MI  48083
+				US
+
+00-06-3A   (hex)		Dura Micro, Inc.
+00063A     (base 16)		Dura Micro, Inc.
+				13580 Fifth Street
+				Chino  CA  91710
+				US
+
+00-06-32   (hex)		Mesco Engineering GmbH
+000632     (base 16)		Mesco Engineering GmbH
+				Wiesentalstraße 74
+				    
+				DE
+
+00-06-34   (hex)		GTE Airfone Inc.
+000634     (base 16)		GTE Airfone Inc.
+				2809 Butterfield
+				Oakbrook  IL  60522
+				US
+
+00-06-0C   (hex)		Melco Industries, Inc.
+00060C     (base 16)		Melco Industries, Inc.
+				1575 W. 124th Ave.
+				Denver  CO  80234
+				US
+
+00-06-0E   (hex)		IGYS Systems, Inc.
+00060E     (base 16)		IGYS Systems, Inc.
+				7373 Lincoln Way
+				Garden Grove  CA  92841
+				US
+
+00-06-14   (hex)		Prism Holdings
+000614     (base 16)		Prism Holdings
+				P.O. Box 901,
+				Gauteng    
+				ZA
+
+00-06-08   (hex)		At-Sky SAS
+000608     (base 16)		At-Sky SAS
+				ZI Athelia 3, Voi Atlas
+				    
+				FR
+
+00-05-C3   (hex)		Pacific Instruments, Inc.
+0005C3     (base 16)		Pacific Instruments, Inc.
+				4080 Pike Lane
+				Concord  CA  94520
+				US
+
+00-05-B9   (hex)		Airvana, Inc.
+0005B9     (base 16)		Airvana, Inc.
+				25 Industrial Ave.
+				Chlemsford  MA  01824
+				US
+
+00-05-BC   (hex)		Resource Data Management Ltd
+0005BC     (base 16)		Resource Data Management Ltd
+				80 Johnstone Avenue,
+				Scotland    G52 4NZ
+				GB
+
+00-05-BE   (hex)		Kongsberg Seatex AS
+0005BE     (base 16)		Kongsberg Seatex AS
+				Pirsenteret
+				    
+				NO
+
+00-05-BD   (hex)		ROAX BV
+0005BD     (base 16)		ROAX BV
+				Sterrenbergweg 29
+				    
+				NL
+
+00-05-C1   (hex)		A-Kyung Motion, Inc.
+0005C1     (base 16)		A-Kyung Motion, Inc.
+				54-10, Munjung-Dong
+				Seoul    
+				KR
+
+00-05-B4   (hex)		Aceex Corporation
+0005B4     (base 16)		Aceex Corporation
+				2F, No. 2, Alley 1, Sze-Wei Lane
+				    23138
+				TW
+
+00-05-98   (hex)		CRONOS S.r.l.
+000598     (base 16)		CRONOS S.r.l.
+				Via cavour 58/A
+				    
+				IT
+
+00-05-B7   (hex)		Arbor Technology Corp.
+0005B7     (base 16)		Arbor Technology Corp.
+				5F, No. 738, Zhong Zheng Rd.,
+				    
+				TW
+
+00-05-9B   (hex)		Cisco Systems, Inc
+00059B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-7E   (hex)		Eckelmann Steuerungstechnik GmbH
+00057E     (base 16)		Eckelmann Steuerungstechnik GmbH
+				Berliner Strasse 161
+				    
+				DE
+
+00-05-80   (hex)		FibroLAN Ltd.
+000580     (base 16)		FibroLAN Ltd.
+				2 Hacarmel st., POB 544
+				Yokneam Illit    20692
+				IL
+
+00-05-82   (hex)		ClearCube Technology
+000582     (base 16)		ClearCube Technology
+				8834 Capital of Texas Hwy,
+				Austin  TX  78759
+				US
+
+00-05-D9   (hex)		Techno Valley, Inc.
+0005D9     (base 16)		Techno Valley, Inc.
+				ASIC Venture Town 5F,
+				Seoul    135-072
+				KR
+
+00-05-DC   (hex)		Cisco Systems, Inc
+0005DC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-D0   (hex)		Solinet Systems
+0005D0     (base 16)		Solinet Systems
+				1200-180 Elgin St.
+				    K2P 2K3
+				CA
+
+00-05-9F   (hex)		Yotta Networks, Inc.
+00059F     (base 16)		Yotta Networks, Inc.
+				2201 Avenue K
+				Plano  TX  75074
+				US
+
+00-05-87   (hex)		Locus, Incorporated
+000587     (base 16)		Locus, Incorporated
+				5540 Research Park Drive
+				Madison  WI  53711
+				US
+
+00-05-90   (hex)		Swissvoice Ltd.
+000590     (base 16)		Swissvoice Ltd.
+				Ziegelmattstrasse 1
+				    
+				CH
+
+00-05-95   (hex)		Alesis Corporation
+000595     (base 16)		Alesis Corporation
+				1633 26th Street
+				Santa Monica  CA  90404
+				US
+
+00-05-78   (hex)		Private
+000578     (base 16)		Private
+
+00-05-72   (hex)		Deonet Co., Ltd.
+000572     (base 16)		Deonet Co., Ltd.
+				#127-5 Jinyoung B/D 3th F,
+				Seoul    
+				KR
+
+00-05-76   (hex)		NSM Technology Ltd.
+000576     (base 16)		NSM Technology Ltd.
+				22 Floor, Times Tower
+				Koloon    
+				HK
+
+00-05-6A   (hex)		Heuft Systemtechnik GmbH
+00056A     (base 16)		Heuft Systemtechnik GmbH
+				Brohltalstr 31-33
+				Deutschland    
+				DE
+
+00-05-68   (hex)		Piltofish Networks AB
+000568     (base 16)		Piltofish Networks AB
+				Stora Badhusgatan 18-20
+				    
+				SE
+
+00-05-B6   (hex)		INSYS Microelectronics GmbH
+0005B6     (base 16)		INSYS Microelectronics GmbH
+				Hermann-Köhl-Straße 22
+				    
+				DE
+
+00-05-55   (hex)		Japan Cash Machine Co., Ltd.
+000555     (base 16)		Japan Cash Machine Co., Ltd.
+				No. 3-15, 2-chome, Nishiwaki,
+				    547-0035
+				JP
+
+00-05-52   (hex)		Xycotec Computer GmbH
+000552     (base 16)		Xycotec Computer GmbH
+				Karl-Heinz-Beckurts-Str. 4
+				    
+				DE
+
+00-05-4A   (hex)		Ario Data Networks, Inc.
+00054A     (base 16)		Ario Data Networks, Inc.
+				2890 Zanker Road, Suite 203
+				San Jose  CA  95134
+				US
+
+00-05-48   (hex)		Disco Corporation
+000548     (base 16)		Disco Corporation
+				13-11 Omori-Kita 2-chome
+				Ota-ku  Tokyo  143-8580
+				JP
+
+00-04-F7   (hex)		Omega Band, Inc.
+0004F7     (base 16)		Omega Band, Inc.
+				9020-I Capital of Texas Hghwy N
+				Austin  TX  78759
+				US
+
+00-04-EE   (hex)		Lincoln Electric Company
+0004EE     (base 16)		Lincoln Electric Company
+				22801 St. Clair Avenue
+				Cleveland  OH  44117-1199
+				US
+
+00-04-F0   (hex)		International Computers, Ltd
+0004F0     (base 16)		International Computers, Ltd
+				1 Wenlock Way
+				    UK
+				GB
+
+00-05-27   (hex)		SJ Tek Co. Ltd
+000527     (base 16)		SJ Tek Co. Ltd
+				Ho gae Dong 976-5, Dong An Ku,
+				    
+				KR
+
+00-05-29   (hex)		Shanghai Broadan Communication Technology Co., Ltd
+000529     (base 16)		Shanghai Broadan Communication Technology Co., Ltd
+				15F, Suntime International Mansion
+				    200122
+				CN
+
+00-05-2C   (hex)		Supreme Magic Corporation
+00052C     (base 16)		Supreme Magic Corporation
+				Sun Towers Center Bldg., 13F
+				    154-0024
+				JP
+
+00-05-3E   (hex)		KID Systeme GmbH
+00053E     (base 16)		KID Systeme GmbH
+				Luneburger Schanze 30
+				    
+				DE
+
+00-05-3F   (hex)		VisionTek, Inc.
+00053F     (base 16)		VisionTek, Inc.
+				1175 Lakeside Dr.
+				Gurnee  IL  60031
+				US
+
+00-05-3D   (hex)		Agere Systems
+00053D     (base 16)		Agere Systems
+				1371 McCarthy Blvd.
+				Milpitas  CA  95035
+				US
+
+00-05-00   (hex)		Cisco Systems, Inc
+000500     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-19   (hex)		Siemens Building Technologies AG,
+000519     (base 16)		Siemens Building Technologies AG,
+				Cerberus Division
+				    
+				CH
+
+00-05-0D   (hex)		Midstream Technologies, Inc.
+00050D     (base 16)		Midstream Technologies, Inc.
+				777 108th Ave. NE
+				Bellevue  WA  98004-5140
+				US
+
+00-05-34   (hex)		Northstar Engineering Ltd.
+000534     (base 16)		Northstar Engineering Ltd.
+				P.O. Box 40
+				    
+				GB
+
+00-05-35   (hex)		Chip PC Ltd.
+000535     (base 16)		Chip PC Ltd.
+				20 A.L. Motzkin St.
+				Tirat Carmel    39100
+				IL
+
+00-05-07   (hex)		Fine Appliance Corp.
+000507     (base 16)		Fine Appliance Corp.
+				7Fl., No. 499,
+				    
+				TW
+
+00-04-FD   (hex)		Japan Control Engineering Co., Ltd.
+0004FD     (base 16)		Japan Control Engineering Co., Ltd.
+				1-5-1, Higashiamagawa, Takatsuki-shi
+				    
+				JP
+
+00-05-62   (hex)		Digital View Limited
+000562     (base 16)		Digital View Limited
+				2201 Nan Yang Plaza,
+				Kowloon    
+				HK
+
+00-04-E5   (hex)		Glonet Systems, Inc.
+0004E5     (base 16)		Glonet Systems, Inc.
+				11Fl., Jeil Bldg., 94-46, 7Ka
+				    
+				KR
+
+00-04-D2   (hex)		Adcon Telemetry GmbH
+0004D2     (base 16)		Adcon Telemetry GmbH
+				Inkustraße 24
+				    
+				AT
+
+00-04-D3   (hex)		Toyokeiki Co., Ltd.
+0004D3     (base 16)		Toyokeiki Co., Ltd.
+				Wada 3967-10, Matsumoto-City
+				    
+				JP
+
+00-04-AA   (hex)		Jetstream Communications
+0004AA     (base 16)		Jetstream Communications
+				5400 Hellyer Avenue
+				San Jose  CA  95138-1005
+				US
+
+00-04-A0   (hex)		Verity Instruments, Inc.
+0004A0     (base 16)		Verity Instruments, Inc.
+				2901 Eisenhower St.
+				Carrollton  TX  75007
+				US
+
+00-04-9E   (hex)		Wirelink Co., Ltd.
+00049E     (base 16)		Wirelink Co., Ltd.
+				11F, Geoseong B/D 541, Dowha-Dong,
+				    KOREA
+				KR
+
+00-04-9A   (hex)		Cisco Systems, Inc
+00049A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-79   (hex)		Radius Co., Ltd.
+000479     (base 16)		Radius Co., Ltd.
+				1-48-11, Itabashi
+				    
+				JP
+
+00-04-B0   (hex)		ELESIGN Co., Ltd.
+0004B0     (base 16)		ELESIGN Co., Ltd.
+				9Fl. TaeKyoung Bldg.,
+				  R.O.  KOREA
+				KR
+
+00-04-AB   (hex)		Mavenir Inc.
+0004AB     (base 16)		Mavenir Inc.
+				1700 International Parkway
+				Richardson  TX  75081
+				US
+
+00-04-A7   (hex)		FabiaTech Corporation
+0004A7     (base 16)		FabiaTech Corporation
+				4F-3, No. 18, Lane 609
+				Taipei  Hsien,  TAIWAN R.O.C
+				TW
+
+00-04-98   (hex)		Mahi Networks
+000498     (base 16)		Mahi Networks
+				1039 N. McDowell Blvd.
+				Petaluma  CA  94954
+				US
+
+00-04-97   (hex)		MacroSystem Digital Video AG
+000497     (base 16)		MacroSystem Digital Video AG
+				Schoellinger Feld 28
+				    
+				DE
+
+00-04-D5   (hex)		Hitachi Information & Communication Engineering, Ltd.
+0004D5     (base 16)		Hitachi Information & Communication Engineering, Ltd.
+				Queen's Tower B21F, 2-3-3, Minatomirai,
+				Nishi-ku,  Yokohama,  220-6121
+				JP
+
+00-04-CA   (hex)		FreeMs Corp.
+0004CA     (base 16)		FreeMs Corp.
+				Shinhan Bldg. 6F,
+				Seoul  150-736  KOREA
+				KR
+
+00-04-88   (hex)		Eurotherm Controls
+000488     (base 16)		Eurotherm Controls
+				741F Miller Drive
+				Lessburg  VA  20175
+				US
+
+00-04-85   (hex)		PicoLight
+000485     (base 16)		PicoLight
+				4665 Nautilus Court South
+				Boulder  CO  80301
+				US
+
+00-04-DA   (hex)		Relax Technology, Inc.
+0004DA     (base 16)		Relax Technology, Inc.
+				DBA/ Granite Digital
+				Union City  CA  94587
+				US
+
+00-04-C5   (hex)		ASE Technologies, USA
+0004C5     (base 16)		ASE Technologies, USA
+				6721 Baum Dr.
+				Knoxville  TN  37919
+				US
+
+00-04-36   (hex)		ELANsat Technologies, Inc.
+000436     (base 16)		ELANsat Technologies, Inc.
+				No. 11, Lane 19, Pateh Road,
+				Hsinchu  TAIWAN,  R.O.C.
+				TW
+
+00-04-32   (hex)		Voyetra Turtle Beach, Inc.
+000432     (base 16)		Voyetra Turtle Beach, Inc.
+				150 Clearbrook Road, Suite 162
+				Elmsford  NY  10523
+				US
+
+00-04-35   (hex)		InfiNet LLC
+000435     (base 16)		InfiNet LLC
+				Serafimy Deryabinoy str. 24
+				Yekaterinburg    620149
+				RU
+
+00-04-37   (hex)		Powin Information Technology, Inc.
+000437     (base 16)		Powin Information Technology, Inc.
+				8F, No. 70, Zhou-Z St.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-04-0C   (hex)		Kanno Works, Ltd.
+00040C     (base 16)		Kanno Works, Ltd.
+				1-5-25 Kamitomino,
+				    
+				JP
+
+00-04-08   (hex)		Sanko Electronics Co., Ltd.
+000408     (base 16)		Sanko Electronics Co., Ltd.
+				3-802 ueda tenpaku-ku
+				  nagoya  
+				JP
+
+00-04-07   (hex)		Topcon Positioning Systems, Inc.
+000407     (base 16)		Topcon Positioning Systems, Inc.
+				5758 W. Las Positas Blvd.
+				Pleasanton  CA  94588
+				US
+
+00-04-09   (hex)		Cratos Networks
+000409     (base 16)		Cratos Networks
+				313 Littleton Road
+				Chelmsford  MA  01824
+				US
+
+00-04-55   (hex)		ANTARA.net
+000455     (base 16)		ANTARA.net
+				747 Camden Ave.
+				Campbell  CA  95008
+				US
+
+00-04-57   (hex)		Universal Access Technology, Inc.
+000457     (base 16)		Universal Access Technology, Inc.
+				2 Fl., No. 5, Alley 22,
+				Nei Hu  Taipei,  TAIWAN 114
+				TW
+
+00-04-4D   (hex)		Cisco Systems, Inc
+00044D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-54   (hex)		Quadriga UK
+000454     (base 16)		Quadriga UK
+				Baird House
+				    ENGLAND
+				GB
+
+00-04-48   (hex)		Polaroid Corporation
+000448     (base 16)		Polaroid Corporation
+				300 Baker Avenue
+				Concord  MA  01742
+				US
+
+00-04-47   (hex)		Acrowave Systems Co., Ltd.
+000447     (base 16)		Acrowave Systems Co., Ltd.
+				Maru B/D 86-6, Nonhyun-Dong
+				KOREA  zip:  135-818
+				KR
+
+00-04-3E   (hex)		Telencomm
+00043E     (base 16)		Telencomm
+				2551 Walsh Avenue
+				Santa Clara  CA  95051
+				US
+
+00-04-6D   (hex)		Cisco Systems, Inc
+00046D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-66   (hex)		ARMITEL Co.
+000466     (base 16)		ARMITEL Co.
+				F5, Doman Plaza 353-4,
+				Republic  of  KOREA
+				KR
+
+00-03-E2   (hex)		Comspace Corporation
+0003E2     (base 16)		Comspace Corporation
+				955 Freeport Pkwy
+				Coppell  TX  75019
+				US
+
+00-03-FF   (hex)		Microsoft Corporation
+0003FF     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  WA  98052
+				US
+
+00-04-14   (hex)		Umezawa Musen Denki Co., Ltd.
+000414     (base 16)		Umezawa Musen Denki Co., Ltd.
+				14-3, Minami 1, Nishi 8,
+				Hokkaido  JAPAN  060-0061
+				JP
+
+00-04-28   (hex)		Cisco Systems, Inc
+000428     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-86   (hex)		Ho Net, Inc.
+000386     (base 16)		Ho Net, Inc.
+				Venture Company Center
+				  KOREA  442-760
+				KR
+
+00-03-7D   (hex)		Stellcom
+00037D     (base 16)		Stellcom
+				10525 Vista Sorrento Parkway
+				San Diego  CA  92121
+				US
+
+00-03-83   (hex)		Metera Networks, Inc.
+000383     (base 16)		Metera Networks, Inc.
+				1202 Richardson Dr.
+				Richardson  TX  75080
+				US
+
+00-03-CC   (hex)		Momentum Computer, Inc.
+0003CC     (base 16)		Momentum Computer, Inc.
+				1815 Aston Avenue
+				Carlsbad  CA  92008-7310
+				US
+
+00-03-D7   (hex)		NextNet Wireless, Inc.
+0003D7     (base 16)		NextNet Wireless, Inc.
+				9555 James Ave. So.
+				Bloomington  MN  55431
+				US
+
+00-03-D3   (hex)		Internet Energy Systems, Inc.
+0003D3     (base 16)		Internet Energy Systems, Inc.
+				4218 Trumbo Ct.
+				Fairfax  VA  22033
+				US
+
+00-03-CD   (hex)		Clovertech, Inc.
+0003CD     (base 16)		Clovertech, Inc.
+				3-1-5 Naka-cho Musashino-shi
+				Tokyo  180-0006  
+				JP
+
+00-03-8B   (hex)		PLUS-ONE I&T, Inc.
+00038B     (base 16)		PLUS-ONE I&T, Inc.
+				7F, A-San Venture Tower,
+				    KOREA
+				KR
+
+00-03-8C   (hex)		Total Impact
+00038C     (base 16)		Total Impact
+				295 Willis Ave.
+				Camarillo  CA  93010
+				US
+
+00-03-EE   (hex)		MKNet Corporation
+0003EE     (base 16)		MKNet Corporation
+				711-B Charcot Ave.
+				San Jose  CA  95131
+				US
+
+00-03-EA   (hex)		Mega System Technologies, Inc.
+0003EA     (base 16)		Mega System Technologies, Inc.
+				2F, No. 41, Lane 76,
+				Taipei  Taipei  TAIWAN
+				TW
+
+00-03-E6   (hex)		Entone, Inc.
+0003E6     (base 16)		Entone, Inc.
+				2755 Campus Dr Ste 235
+				San Mateo  CA   94403
+				US
+
+00-03-A9   (hex)		AXCENT Media AG
+0003A9     (base 16)		AXCENT Media AG
+				Technologiepark 13
+				    
+				DE
+
+00-03-9F   (hex)		Cisco Systems, Inc
+00039F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-90   (hex)		Digital Video Communications, Inc.
+000390     (base 16)		Digital Video Communications, Inc.
+				500 W. Cummings Park
+				Woburn  MA  07801
+				US
+
+00-03-B5   (hex)		Entra Technology Co.
+0003B5     (base 16)		Entra Technology Co.
+				Fl. 3, No. 5, Alley 2,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-64   (hex)		Scenix Semiconductor, Inc.
+000364     (base 16)		Scenix Semiconductor, Inc.
+				1330 Charleston Rd.
+				Mountainview  CA  94043
+				US
+
+00-03-5E   (hex)		Metropolitan Area Networks, Inc.
+00035E     (base 16)		Metropolitan Area Networks, Inc.
+				1299 Pennsylvania Avenue, NW
+				Washington  DC  20004
+				US
+
+00-03-5C   (hex)		Saint Song Corp.
+00035C     (base 16)		Saint Song Corp.
+				4F, No. 12, Lane 94, Tsao Ti Wzi
+				    222
+				TW
+
+00-03-5D   (hex)		Bosung Hi-Net Co., Ltd.
+00035D     (base 16)		Bosung Hi-Net Co., Ltd.
+				Youngil B/O 2F,
+				    137-130
+				KR
+
+00-03-79   (hex)		Proscend Communications, Inc.
+000379     (base 16)		Proscend Communications, Inc.
+				2F, No.36, Industry E. Rd. IV,
+				Hsinchu    300
+				TW
+
+00-03-6F   (hex)		Telsey SPA
+00036F     (base 16)		Telsey SPA
+				Viale Dell Industria, 1
+				DiTreviso-    
+				IT
+
+00-03-72   (hex)		ULAN
+000372     (base 16)		ULAN
+				5F-3, No. 31-1, Lane 169,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-34   (hex)		Newport Electronics
+000334     (base 16)		Newport Electronics
+				2229 So. Yale St.
+				Santa Ana  CA  92704
+				US
+
+00-03-3A   (hex)		Silicon Wave, Inc.
+00033A     (base 16)		Silicon Wave, Inc.
+				6256 Greenwich Drive
+				San Diego  CA  92122
+				US
+
+00-03-32   (hex)		Cisco Systems, Inc
+000332     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-0E   (hex)		Core Communications Co., Ltd.
+00030E     (base 16)		Core Communications Co., Ltd.
+				3F Shopping Center Bd. of
+				Seoul (121-050)    (121-050)
+				KR
+
+00-03-12   (hex)		TRsystems GmbH
+000312     (base 16)		TRsystems GmbH
+				Eglishalde 16
+				 Trossingen  Baden-Wuerttemberg  D-78647
+				DE
+
+00-03-41   (hex)		Axon Digital Design
+000341     (base 16)		Axon Digital Design
+				Lange Wagenstraat 55
+				    
+				NL
+
+00-80-37   (hex)		Ericsson Group
+008037     (base 16)		Ericsson Group
+				Telefonaktiebolaget
+				    
+				SE
+
+00-03-3D   (hex)		ILSHin Lab
+00033D     (base 16)		ILSHin Lab
+				KCS B/D 228-13 Young Dap-Dong
+				Seoul    
+				KR
+
+00-03-66   (hex)		ASM Pacific Technology
+000366     (base 16)		ASM Pacific Technology
+				12/F Watson Centre
+				Kwai Chung    
+				HK
+
+00-03-62   (hex)		Vodtel Communications, Inc.
+000362     (base 16)		Vodtel Communications, Inc.
+				12F, No 166 Chien-Yi Road
+				    235
+				TW
+
+00-03-4D   (hex)		Chiaro Networks, Ltd.
+00034D     (base 16)		Chiaro Networks, Ltd.
+				P.O. Box 832427
+				Richardson  TX  75083-2427
+				US
+
+00-03-22   (hex)		IDIS Co., Ltd.
+000322     (base 16)		IDIS Co., Ltd.
+				7th Floor, 646-7 Yuksam-Dong,
+				    
+				KR
+
+00-03-1D   (hex)		Taiwan Commate Computer, Inc.
+00031D     (base 16)		Taiwan Commate Computer, Inc.
+				8F, No. 94, Sec 1,
+				    
+				TW
+
+00-03-26   (hex)		Iwasaki Information Systems Co., Ltd.
+000326     (base 16)		Iwasaki Information Systems Co., Ltd.
+				3361 Oshi
+				    
+				JP
+
+00-02-90   (hex)		Woorigisool, Inc.
+000290     (base 16)		Woorigisool, Inc.
+				Yoopoong Bldg.
+				Seoul  Seoul  KOREA
+				KR
+
+00-02-92   (hex)		Logic Innovations, Inc.
+000292     (base 16)		Logic Innovations, Inc.
+				6205 Lusk Blvd.
+				San Diego  CA  92121-2731
+				US
+
+00-02-86   (hex)		Occam Networks
+000286     (base 16)		Occam Networks
+				4183 State Street
+				Santa Barbara  CA  93110
+				US
+
+00-02-D2   (hex)		Workstation AG
+0002D2     (base 16)		Workstation AG
+				Schaffhauserstrasse 55
+				    
+				CH
+
+00-02-CD   (hex)		TeleDream, Inc.
+0002CD     (base 16)		TeleDream, Inc.
+				Shinhwa Bldg., 940-10 Daechi-Dong
+				    
+				KR
+
+00-02-D0   (hex)		Comdial Corporation
+0002D0     (base 16)		Comdial Corporation
+				1180 Seminole Trail
+				Charlottesville  VA  22901
+				US
+
+00-02-CC   (hex)		M.C.C.I
+0002CC     (base 16)		M.C.C.I
+				3520 Krums Corners Rd.
+				Ithaca  NY  14850
+				US
+
+00-02-B0   (hex)		Hokubu Communication & Industrial Co., Ltd.
+0002B0     (base 16)		Hokubu Communication & Industrial Co., Ltd.
+				Fushiogami-aza-oki 27-1
+				Fukushima    960-8514
+				JP
+
+00-02-AA   (hex)		PLcom Co., Ltd.
+0002AA     (base 16)		PLcom Co., Ltd.
+				Hosung B/D, #1083-1, Hogye-Dong
+				  South  Korea
+				KR
+
+00-02-B5   (hex)		Avnet, Inc.
+0002B5     (base 16)		Avnet, Inc.
+				2211 S. 47th Street
+				Phoenix  AZ  85034
+				US
+
+00-02-B4   (hex)		DAPHNE
+0002B4     (base 16)		DAPHNE
+				101 Chaussee De Binche
+				    
+				BE
+
+00-02-AC   (hex)		3PAR data
+0002AC     (base 16)		3PAR data
+				4209 Technology Drive
+				Fremont  CA  94538
+				US
+
+00-02-D9   (hex)		Reliable Controls
+0002D9     (base 16)		Reliable Controls
+				120 Hallowell Road
+				Victoria,   B.C.  V9A 7K2
+				CA
+
+00-02-EF   (hex)		CCC Network Systems Group Ltd.
+0002EF     (base 16)		CCC Network Systems Group Ltd.
+				13 Farnborough Business Centre
+				  ENGLAND  
+				GB
+
+00-02-E8   (hex)		E.D.&A.
+0002E8     (base 16)		E.D.&A.
+				Energielaan 16
+				    
+				BE
+
+00-02-F2   (hex)		eDevice, Inc.
+0002F2     (base 16)		eDevice, Inc.
+				420 Lexington Avenue
+				New York  NY  10170
+				US
+
+00-02-9D   (hex)		Merix Corp.
+00029D     (base 16)		Merix Corp.
+				Jin-Su Building, 49-16
+				Seoul  Seoul  KOREA
+				KR
+
+00-02-C5   (hex)		Evertz Microsystems Ltd.
+0002C5     (base 16)		Evertz Microsystems Ltd.
+				5292 John Lucas Drive
+				  Ontario  L7L 5Z9
+				CA
+
+00-02-4A   (hex)		Cisco Systems, Inc
+00024A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-49   (hex)		Aviv Infocom Co, Ltd.
+000249     (base 16)		Aviv Infocom Co, Ltd.
+				962-5, Kwanyang-Dong, Dongan-Gu,
+				  Korea  (ROK)
+				KR
+
+00-02-45   (hex)		Lampus Co, Ltd.
+000245     (base 16)		Lampus Co, Ltd.
+				6th Bldg., Samgong,
+				Korea  Korea  137-044
+				KR
+
+00-02-32   (hex)		Avision, Inc.
+000232     (base 16)		Avision, Inc.
+				No. 20, Creation Rd. 1,
+				Hsinchu  Taiwan,  R.O.C.
+				TW
+
+00-02-35   (hex)		Paragon Networks International
+000235     (base 16)		Paragon Networks International
+				61 Commerce Drive
+				Brookfield  CT  06804
+				US
+
+00-02-37   (hex)		Cosmo Research Corp.
+000237     (base 16)		Cosmo Research Corp.
+				Cosmo Bldg, 3-148-5
+				    
+				KW
+
+00-02-28   (hex)		Necsom, Ltd.
+000228     (base 16)		Necsom, Ltd.
+				Necsom Ltd. c/o Koirsto
+				    
+				FI
+
+00-02-46   (hex)		All-Win Tech Co., Ltd.
+000246     (base 16)		All-Win Tech Co., Ltd.
+				11F, No. 111-7, Hsing De Rd.,
+				Taipei Hsien  Taiwan,  R.O.C.
+				TW
+
+00-02-3A   (hex)		ZSK Stickmaschinen GmbH
+00023A     (base 16)		ZSK Stickmaschinen GmbH
+				Magdeburger Straße 38-40
+				    
+				DE
+
+00-02-7F   (hex)		ask-technologies.com
+00027F     (base 16)		ask-technologies.com
+				36 Wellington Business Park
+				    
+				GB
+
+00-02-7E   (hex)		Cisco Systems, Inc
+00027E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-10-95   (hex)		Thomson Inc.
+001095     (base 16)		Thomson Inc.
+				101 West 103rd Street
+				Indianapolis  IN  46290-1102
+				US
+
+00-02-5D   (hex)		Calix Networks
+00025D     (base 16)		Calix Networks
+				1035 North McDowell Blvd.
+				Petaluma  CA  94954
+				US
+
+00-02-7B   (hex)		Amplify Net, Inc.
+00027B     (base 16)		Amplify Net, Inc.
+				47381 Bayside Parkway
+				Fremont  CA  94538
+				US
+
+00-02-73   (hex)		Coriolis Networks
+000273     (base 16)		Coriolis Networks
+				330 Codmanhill Road
+				Boxborough  MA  01719
+				US
+
+00-02-57   (hex)		Microcom Corp.
+000257     (base 16)		Microcom Corp.
+				8333A Green Meadows Dr. N.
+				Westerville  OH  43081
+				US
+
+00-02-53   (hex)		Televideo, Inc.
+000253     (base 16)		Televideo, Inc.
+				2345 Harris Way
+				San Jose  CA  95131
+				US
+
+00-02-6F   (hex)		Senao International Co., Ltd.
+00026F     (base 16)		Senao International Co., Ltd.
+				2F, No. 531, Chung-Cheng Rd.,
+				    TAIWAN
+				TW
+
+00-02-30   (hex)		Intersoft Electronics
+000230     (base 16)		Intersoft Electronics
+				Lammerdries 27
+				    
+				BE
+
+00-02-1C   (hex)		Network Elements, Inc.
+00021C     (base 16)		Network Elements, Inc.
+				9782 SW Nimbus Avenue
+				Beaverton  OR  97008
+				US
+
+00-02-0C   (hex)		Metro-Optix
+00020C     (base 16)		Metro-Optix
+				2201 Avenue K
+				Plano  TX  75074
+				US
+
+00-02-16   (hex)		Cisco Systems, Inc
+000216     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-14   (hex)		DTVRO
+000214     (base 16)		DTVRO
+				813 Daegong Bldg.,
+				KOREA  KOREA  135-080
+				KR
+
+00-02-0F   (hex)		AATR
+00020F     (base 16)		AATR
+				306 Chemin des Miroirs
+				    
+				FR
+
+00-01-C3   (hex)		Acromag, Inc.
+0001C3     (base 16)		Acromag, Inc.
+				30765 S. Wixom Road
+				Wixom  MI  48393
+				US
+
+00-01-C2   (hex)		ARK Research Corp.
+0001C2     (base 16)		ARK Research Corp.
+				1198 Saratoga Ave. #11D
+				San Jose  CA  95129
+				US
+
+00-01-EA   (hex)		Cirilium Corp.
+0001EA     (base 16)		Cirilium Corp.
+				1615 S. 52nd Street
+				Tempe  AZ  85281
+				US
+
+00-01-E0   (hex)		Fast Systems, Inc.
+0001E0     (base 16)		Fast Systems, Inc.
+				87-9 Yang-Jae, Seo-Cho,
+				    KOREA
+				KR
+
+00-01-AC   (hex)		Sitara Networks, Inc.
+0001AC     (base 16)		Sitara Networks, Inc.
+				60 Hickory Drive
+				Waltham  MA  02451
+				US
+
+00-01-ED   (hex)		SETA Corp.
+0001ED     (base 16)		SETA Corp.
+				Ariake Frontier Bldg. B
+				  JAPAN  135-0063
+				JP
+
+00-01-F6   (hex)		Association of Musical Electronics Industry
+0001F6     (base 16)		Association of Musical Electronics Industry
+				Ito Bldg. 4th Floor 2-16-9 Misaki-cho,
+				    
+				JP
+
+00-01-CB   (hex)		EVR
+0001CB     (base 16)		EVR
+				12 Raul Wallenberg St.
+				  Tel Aviv  69719
+				IL
+
+00-01-D6   (hex)		manroland AG
+0001D6     (base 16)		manroland AG
+				Stadtbachstraße 1
+				    
+				DE
+
+00-01-AD   (hex)		Coach Master International  d.b.a. CMI Worldwide, Inc.
+0001AD     (base 16)		Coach Master International  d.b.a. CMI Worldwide, Inc.
+				600 Stewart Street
+				Seattle  WA  98101
+				US
+
+00-01-88   (hex)		LXCO Technologies ag
+000188     (base 16)		LXCO Technologies ag
+				Gimmerstraße 69
+				    
+				DE
+
+00-01-9B   (hex)		Kyoto Microcomputer Co., Ltd.
+00019B     (base 16)		Kyoto Microcomputer Co., Ltd.
+				2-44 nakayama oe nishikyo-ku
+				kyoto    
+				JP
+
+00-01-7F   (hex)		Experience Music Project
+00017F     (base 16)		Experience Music Project
+				110 -110th Avenue NE - Ste. #400
+				Bellevue  WA  98004
+				US
+
+00-01-5A   (hex)		Digital Video Broadcasting
+00015A     (base 16)		Digital Video Broadcasting
+				DVB, % European Broadcasting Union
+				    
+				CH
+
+00-01-2A   (hex)		Telematica Sistems Inteligente
+00012A     (base 16)		Telematica Sistems Inteligente
+				Rua Miguel Casagrande, 200
+				São Paulo    
+				BR
+
+00-01-66   (hex)		TC GROUP A/S
+000166     (base 16)		TC GROUP A/S
+				Sindalsvej 34
+				Risskov    DK-8240
+				DK
+
+00-01-76   (hex)		Orient Silver Enterprises
+000176     (base 16)		Orient Silver Enterprises
+				8740 White Oak Avenue
+				Rancho Cucamonga  CA  91730
+				US
+
+00-01-58   (hex)		Electro Industries/Gauge Tech
+000158     (base 16)		Electro Industries/Gauge Tech
+				1800 Shames Drive
+				Westbury  NY  11590
+				US
+
+00-01-2D   (hex)		Komodo Technology
+00012D     (base 16)		Komodo Technology
+				170 Knowles Drive
+				Los Gatos  CA  95032
+				US
+
+00-01-48   (hex)		X-traWeb Inc.
+000148     (base 16)		X-traWeb Inc.
+				6750 West 93rd Street - Ste. #210
+				Overland Park  KS  66212
+				US
+
+00-01-87   (hex)		I2SE GmbH
+000187     (base 16)		I2SE GmbH
+				Friedrich-Ebert-Str. 61
+				Leipzig    04109
+				DE
+
+00-01-80   (hex)		AOpen, Inc.
+000180     (base 16)		AOpen, Inc.
+				6F, 88, Sec.1, Hsin Tai
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-01-97   (hex)		Cisco Systems, Inc
+000197     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-9A   (hex)		LEUNIG GmbH
+00019A     (base 16)		LEUNIG GmbH
+				Wilhelm-Ostwald-Str. 17
+				    
+				DE
+
+00-01-59   (hex)		S1 Corporation
+000159     (base 16)		S1 Corporation
+				R&D Center, S1 Bldg.
+				  KOREA  135-010
+				KR
+
+00-01-71   (hex)		Allied Data Technologies
+000171     (base 16)		Allied Data Technologies
+				Pascalweg 1,
+				  THE  
+				NL
+
+00-30-AC   (hex)		Systeme Lauer GmbH & Co., Ltd.
+0030AC     (base 16)		Systeme Lauer GmbH & Co., Ltd.
+				Kelterstrasse 59
+				72669 Unterensingen    
+				DE
+
+00-30-FB   (hex)		AZS Technology AG
+0030FB     (base 16)		AZS Technology AG
+				Steinbeisstrasse 2-4
+				72510 Stetten A.K.M.    
+				DE
+
+00-30-AE   (hex)		Times N System, Inc.
+0030AE     (base 16)		Times N System, Inc.
+				1826 Kramer Lane - Ste.
+				Austin  TX  78758
+				US
+
+00-30-03   (hex)		Phasys Ltd.
+003003     (base 16)		Phasys Ltd.
+				#100-9404 41st Avenue
+				Edmonton  Alberta T6X 1R2  
+				CA
+
+00-30-E2   (hex)		GARNET SYSTEMS CO., LTD.
+0030E2     (base 16)		GARNET SYSTEMS CO., LTD.
+				Sungwon Bldg. 545-7
+				Seoul    
+				KR
+
+00-01-3A   (hex)		SHELCAD COMMUNICATIONS, LTD.
+00013A     (base 16)		SHELCAD COMMUNICATIONS, LTD.
+				P.O. Box 8513
+				    
+				IL
+
+00-01-40   (hex)		Sendtek Corporation
+000140     (base 16)		Sendtek Corporation
+				12F-3, 333, Sec.1
+				    TAIWAN
+				TW
+
+00-01-23   (hex)		Schneider Electric Japan Holdings Ltd.
+000123     (base 16)		Schneider Electric Japan Holdings Ltd.
+				Schneider Electric Osaka Building
+				4-4-9 Kitahama  Chuo-ku, Osaka  541-0041
+				JP
+
+00-01-25   (hex)		YAESU MUSEN CO., LTD.
+000125     (base 16)		YAESU MUSEN CO., LTD.
+				Tennozu Parkside Building
+				Shinagawa-ku, Tokyo 140-0002    
+				JP
+
+00-01-26   (hex)		PAC Labs
+000126     (base 16)		PAC Labs
+				3079 Kilgore Road
+				Rancho Cordova  CA  95670
+				US
+
+00-01-1B   (hex)		Unizone Technologies, Inc.
+00011B     (base 16)		Unizone Technologies, Inc.
+				5Floor HaeSung Bldg.
+				SeoCho-Ku  Seoul  
+				KR
+
+00-01-1D   (hex)		Centillium Communications
+00011D     (base 16)		Centillium Communications
+				47211 Lakeview Blvd.
+				Fremont  CA  94538
+				US
+
+00-01-1F   (hex)		RC Networks, Inc.
+00011F     (base 16)		RC Networks, Inc.
+				6727 Flanders Drive - Ste. #212
+				San Diego  CA  92121
+				US
+
+00-B0-80   (hex)		Mannesmann Ipulsys B.V.
+00B080     (base 16)		Mannesmann Ipulsys B.V.
+				Bordewijklaan 18
+				2591 XR The Hague    
+				NL
+
+00-B0-1E   (hex)		Rantic Labs, Inc.
+00B01E     (base 16)		Rantic Labs, Inc.
+				702 Brazos,  Suite #500
+				Austin  TX  78701
+				US
+
+00-B0-F0   (hex)		CALY NETWORKS
+00B0F0     (base 16)		CALY NETWORKS
+				295 Santa Anna Court
+				Sunnyvale  CA  94086
+				US
+
+00-B0-9A   (hex)		Morrow Technologies Corp.
+00B09A     (base 16)		Morrow Technologies Corp.
+				2300 Tall Pines Drive
+				Largo  FL  33771-5342
+				US
+
+00-30-2E   (hex)		Hoft & Wessel AG
+00302E     (base 16)		Hoft & Wessel AG
+				Rotenburger Strasse 20
+				30659 Hannover    
+				DE
+
+00-30-ED   (hex)		Expert Magnetics Corp.
+0030ED     (base 16)		Expert Magnetics Corp.
+				12/F., Unit D, MTG Bldg., 1-3, Nakase
+				Mihama-ku, Chiba-city, 261-8501    
+				JP
+
+00-30-0F   (hex)		IMT - Information Management T
+00300F     (base 16)		IMT - Information Management T
+				Gewerbestrasse 8
+				CH-9470 Buchs    
+				CH
+
+00-30-82   (hex)		TAIHAN ELECTRIC WIRE CO., LTD.
+003082     (base 16)		TAIHAN ELECTRIC WIRE CO., LTD.
+				Communication Engineering Team
+				Seoul    
+				KR
+
+00-30-A9   (hex)		Netiverse, Inc.
+0030A9     (base 16)		Netiverse, Inc.
+				100 Century Center Court
+				San Jose  CA  95112
+				US
+
+00-30-FE   (hex)		DSA GmbH
+0030FE     (base 16)		DSA GmbH
+				Pascalstraße 28
+				52076 Aachen    
+				DE
+
+00-30-C4   (hex)		Canon Imaging Systems Inc.
+0030C4     (base 16)		Canon Imaging Systems Inc.
+				1-24 Yoneyama, Chuo-ku
+				Niigata-shi  Niigata  950-0916
+				JP
+
+00-30-4D   (hex)		ESI
+00304D     (base 16)		ESI
+				3701 E. Plano Parkway
+				Plano  TX  75074
+				US
+
+08-14-43   (hex)		UNIBRAIN S.A.
+081443     (base 16)		UNIBRAIN S.A.
+				84, ETHNIKIS ANTISTASEOS
+				    
+				GR
+
+00-B0-09   (hex)		Grass Valley, A Belden Brand
+00B009     (base 16)		Grass Valley, A Belden Brand
+				3499, Douglas B. Floreani
+				Montreal  Quebec  H4S 2C6
+				CA
+
+00-B0-AC   (hex)		SIAE-Microelettronica S.p.A.
+00B0AC     (base 16)		SIAE-Microelettronica S.p.A.
+				Via Michelangelo Buonarroti, 21
+				20093 Cologno M. (Ml)    
+				IT
+
+00-30-23   (hex)		COGENT COMPUTER SYSTEMS, INC.
+003023     (base 16)		COGENT COMPUTER SYSTEMS, INC.
+				10 RIVER ROAD - STE. #205
+				UXBRIDGE  MA  01569
+				US
+
+00-30-90   (hex)		CYRA TECHNOLOGIES, INC.
+003090     (base 16)		CYRA TECHNOLOGIES, INC.
+				8000 CAPWELL DRIVE
+				OAKLAND  CA  94621
+				US
+
+00-30-A7   (hex)		SCHWEITZER ENGINEERING
+0030A7     (base 16)		SCHWEITZER ENGINEERING
+				LABORATORIES, INC.
+				PULLMAN  WA  99163
+				US
+
+00-30-7C   (hex)		ADID SA
+00307C     (base 16)		ADID SA
+				70 RU ANATOLE FRANCE
+				92 300 LEVALLOIS-PERRET CEDEX    
+				FR
+
+00-30-55   (hex)		Renesas Technology America, Inc.
+003055     (base 16)		Renesas Technology America, Inc.
+				450 Holger Way
+				San Jose  CA  95134
+				US
+
+00-30-2F   (hex)		GE Aviation System
+00302F     (base 16)		GE Aviation System
+				3290 Patterson Ave., S.E.
+				Grand Rapids  MI  49512
+				US
+
+00-30-0E   (hex)		Klotz Digital AG
+00300E     (base 16)		Klotz Digital AG
+				Hans-Stiessbergerstraße 2A
+				D-85540 Haar    
+				DE
+
+00-30-D5   (hex)		DResearch GmbH
+0030D5     (base 16)		DResearch GmbH
+				Otto-Schmirgal-Str.3
+				10319 Berlin    
+				DE
+
+00-30-18   (hex)		Jetway Information Co., Ltd.
+003018     (base 16)		Jetway Information Co., Ltd.
+				4F, No. 168, LI THE ST.
+				Chung Ho City 235  Taipei  
+				TW
+
+00-30-9F   (hex)		AMBER NETWORKS
+00309F     (base 16)		AMBER NETWORKS
+				2475 AUGUSTINE DR.
+				SANTA CLARA  CA  95054
+				US
+
+00-30-A8   (hex)		OL'E COMMUNICATIONS, INC.
+0030A8     (base 16)		OL'E COMMUNICATIONS, INC.
+				1962 ZANKER ROAD
+				SAN JOSE  CA  95112
+				US
+
+00-30-D1   (hex)		INOVA CORPORATION
+0030D1     (base 16)		INOVA CORPORATION
+				110 AVON STREET
+				CHARLOTTESVILE  VA  22902
+				US
+
+00-30-BB   (hex)		CacheFlow, Inc.
+0030BB     (base 16)		CacheFlow, Inc.
+				650 Almanor Drive
+				Sunnyvale  CA  94086
+				US
+
+00-30-AF   (hex)		Honeywell GmbH
+0030AF     (base 16)		Honeywell GmbH
+				Boeblinger Str. 17
+				D-71098 Schoenaich    
+				DE
+
+00-30-AA   (hex)		AXUS MICROSYSTEMS, INC.
+0030AA     (base 16)		AXUS MICROSYSTEMS, INC.
+				2F-4, NO.18/N. 609, SEC. 5
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-89   (hex)		Spectrapoint Wireless, LLC
+003089     (base 16)		Spectrapoint Wireless, LLC
+				1125 E. Collins Blvd.
+				Richardson  TX  75081
+				US
+
+00-30-9A   (hex)		ASTRO TERRA CORP.
+00309A     (base 16)		ASTRO TERRA CORP.
+				11526 SORRENTO VALLEY ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-30-87   (hex)		VEGA GRIESHABER KG
+003087     (base 16)		VEGA GRIESHABER KG
+				AM HOHENSTEIN 113
+				    
+				DE
+
+00-30-62   (hex)		IP Video Networks Inc
+003062     (base 16)		IP Video Networks Inc
+				6650 Lusk Blvd
+				SAN DIEGO  CA  92121
+				US
+
+00-30-2D   (hex)		QUANTUM BRIDGE COMMUNICATIONS
+00302D     (base 16)		QUANTUM BRIDGE COMMUNICATIONS
+				ONE HIGH STREET
+				NORTH ANDOVER  MA  01845
+				US
+
+00-30-CB   (hex)		OMNI FLOW COMPUTERS, INC.
+0030CB     (base 16)		OMNI FLOW COMPUTERS, INC.
+				10701 CORPORATE DRIVE-STE.#300
+				STAFFORD  TX  77477
+				US
+
+00-30-6B   (hex)		CMOS SYSTEMS, INC.
+00306B     (base 16)		CMOS SYSTEMS, INC.
+				23440 HAWTHORNE BLVD-STE #290
+				TORRANCE  CA  90505
+				US
+
+00-30-AD   (hex)		SHANGHAI COMMUNICATION
+0030AD     (base 16)		SHANGHAI COMMUNICATION
+				TECHNOLOGIES CENTER
+				  P.R.  
+				CN
+
+00-30-CF   (hex)		TWO TECHNOLOGIES, INC.
+0030CF     (base 16)		TWO TECHNOLOGIES, INC.
+				419 SARGON WAY
+				HORSHAM  PA  19044
+				US
+
+00-30-B2   (hex)		L-3 Sonoma EO
+0030B2     (base 16)		L-3 Sonoma EO
+				428 Aviation Blvd
+				Santa Rosa  CA  95403
+				US
+
+00-30-35   (hex)		Corning Incorporated
+003035     (base 16)		Corning Incorporated
+				Data Center
+				Corning  NY  14831
+				US
+
+00-30-7F   (hex)		IRLAN LTD.
+00307F     (base 16)		IRLAN LTD.
+				1 HATAMAR STREET
+				    
+				IL
+
+00-D0-15   (hex)		UNIVEX MICROTECHNOLOGY CORP.
+00D015     (base 16)		UNIVEX MICROTECHNOLOGY CORP.
+				2, TZE-CHIANG 3RD ROAD
+				    TAIWAN
+				TW
+
+00-D0-48   (hex)		ECTON, INC.
+00D048     (base 16)		ECTON, INC.
+				5168 CAMPUS DRIVE
+				PLYMOUTH MEETING  PA  19462
+				US
+
+00-D0-A5   (hex)		AMERICAN ARIUM
+00D0A5     (base 16)		AMERICAN ARIUM
+				14281 CHAMBERS ROAD
+				TUSTIN  CA  92780
+				US
+
+00-30-5D   (hex)		DIGITRA SYSTEMS, INC.
+00305D     (base 16)		DIGITRA SYSTEMS, INC.
+				8-61, GAWOL-DONG
+				  KOREA  140-150
+				KR
+
+00-30-36   (hex)		RMP ELEKTRONIKSYSTEME GMBH
+003036     (base 16)		RMP ELEKTRONIKSYSTEME GMBH
+				HANNS-MARTIN-SCHLE'R-STR.12-14
+				    
+				DE
+
+00-D0-CF   (hex)		MORETON BAY
+00D0CF     (base 16)		MORETON BAY
+				12/97 JIJAWS STREET
+				    
+				AU
+
+00-D0-7F   (hex)		STRATEGY & TECHNOLOGY, LIMITED
+00D07F     (base 16)		STRATEGY & TECHNOLOGY, LIMITED
+				Suite 4.2, Clifton Heights
+				  Bristol  BS8 1EJ
+				GB
+
+00-30-E6   (hex)		Draeger Medical Systems, Inc.
+0030E6     (base 16)		Draeger Medical Systems, Inc.
+				6 Tech Drive
+				Andover  MA  01810
+				US
+
+00-30-BD   (hex)		BELKIN COMPONENTS
+0030BD     (base 16)		BELKIN COMPONENTS
+				501 WEST WALNUT STREET
+				COMPTON  CA  90220
+				US
+
+00-30-07   (hex)		OPTI, INC.
+003007     (base 16)		OPTI, INC.
+				1440 MCCARTHY BLVD.
+				MILPITAS  CA  95035
+				US
+
+00-D0-C2   (hex)		BALTHAZAR TECHNOLOGY AB
+00D0C2     (base 16)		BALTHAZAR TECHNOLOGY AB
+				ANKDAMMSGATAN 24
+				    
+				SE
+
+00-D0-22   (hex)		INCREDIBLE TECHNOLOGIES, INC.
+00D022     (base 16)		INCREDIBLE TECHNOLOGIES, INC.
+				1600 HICKS ROAD
+				ROLLING MEADOWS  IL  60008
+				US
+
+00-D0-71   (hex)		ECHELON CORP.
+00D071     (base 16)		ECHELON CORP.
+				2901 Patrick Henry Dr.
+				Santa Clara  CA  95054 
+				US
+
+00-D0-4F   (hex)		BITRONICS, INC.
+00D04F     (base 16)		BITRONICS, INC.
+				P.O. BOX 22290
+				LEHIGH VALLEY  PA  18002-2290
+				US
+
+00-D0-69   (hex)		TECHNOLOGIC SYSTEMS
+00D069     (base 16)		TECHNOLOGIC SYSTEMS
+				16610 E. LASER DRIVE-STE. #10
+				FOUNTAIN HILLS  AZ  85268
+				US
+
+00-D0-90   (hex)		Cisco Systems, Inc
+00D090     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-F5   (hex)		ORANGE MICRO, INC.
+00D0F5     (base 16)		ORANGE MICRO, INC.
+				1400 N. LAKEVIEW AVE.
+				ANAHEIM  CA  92807
+				US
+
+00-D0-E9   (hex)		Advantage Century Telecommunication Corp.
+00D0E9     (base 16)		Advantage Century Telecommunication Corp.
+				4F, 41, Tunghsin Rd.
+				Taipei    
+				TW
+
+00-D0-94   (hex)		Seeion Control LLC
+00D094     (base 16)		Seeion Control LLC
+				117 Stephanie Lane
+				vista  CA  92084-5316
+				US
+
+00-D0-FB   (hex)		TEK MICROSYSTEMS, INCORPORATED
+00D0FB     (base 16)		TEK MICROSYSTEMS, INCORPORATED
+				ONE NORTH AVENUE
+				BURLINGTON  MA  01803
+				US
+
+00-D0-66   (hex)		WINTRISS ENGINEERING CORP.
+00D066     (base 16)		WINTRISS ENGINEERING CORP.
+				6344 FERRIS SQUARE
+				SAN DIEGO  CA  92121
+				US
+
+00-D0-82   (hex)		IOWAVE INC.
+00D082     (base 16)		IOWAVE INC.
+				1010 WISCONSIN AVENUE
+				WASHINGTON  DC  20007
+				US
+
+00-D0-81   (hex)		RTD Embedded Technologies, Inc.
+00D081     (base 16)		RTD Embedded Technologies, Inc.
+				103 Innovation Blvd.
+				State College  PA  16803
+				US
+
+00-D0-02   (hex)		DITECH CORPORATION
+00D002     (base 16)		DITECH CORPORATION
+				825 EAST MIDDLEFIELD RD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-D0-85   (hex)		OTIS ELEVATOR COMPANY
+00D085     (base 16)		OTIS ELEVATOR COMPANY
+				5 FARM SPRINGS RD.
+				FARMINGTON  CT  06032
+				US
+
+00-D0-11   (hex)		PRISM VIDEO, INC.
+00D011     (base 16)		PRISM VIDEO, INC.
+				15851 DALLAS PARKWAY-STE.#1060
+				ADDISON  TX  75001
+				US
+
+00-D0-DF   (hex)		KUZUMI ELECTRONICS, INC.
+00D0DF     (base 16)		KUZUMI ELECTRONICS, INC.
+				28-6 IIJIMA-CHYO, SAKAE-KU
+				    
+				JP
+
+00-D0-9B   (hex)		SPECTEL LTD.
+00D09B     (base 16)		SPECTEL LTD.
+				21 STILLORGAN INDUSTRIAL PARK
+				    
+				IE
+
+00-D0-67   (hex)		CAMPIO COMMUNICATIONS
+00D067     (base 16)		CAMPIO COMMUNICATIONS
+				2033 GATEWAY PL, SUITE #600
+				SAN JOSE  CA  95110
+				US
+
+00-D0-58   (hex)		Cisco Systems, Inc
+00D058     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-32   (hex)		YANO ELECTRIC CO., LTD.
+00D032     (base 16)		YANO ELECTRIC CO., LTD.
+				7-3-1 IBUKIDAIHIGASHIMACHI
+				    
+				JP
+
+00-D0-F1   (hex)		SEGA ENTERPRISES, LTD.
+00D0F1     (base 16)		SEGA ENTERPRISES, LTD.
+				12-14 HIGASHIKOUJIYA 2-CHOME
+				    
+				JP
+
+00-D0-3A   (hex)		ZONEWORX, INC.
+00D03A     (base 16)		ZONEWORX, INC.
+				40925 COUNTY CENTER DRIVE
+				TEMECULA  CA  92592
+				US
+
+00-D0-01   (hex)		VST TECHNOLOGIES, INC.
+00D001     (base 16)		VST TECHNOLOGIES, INC.
+				125 NAGOG PARK
+				ACTON  MA  01720
+				US
+
+00-50-3E   (hex)		Cisco Systems, Inc
+00503E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-20   (hex)		MEDIASTAR CO., LTD.
+005020     (base 16)		MEDIASTAR CO., LTD.
+				3FL, SOHUN BLDG.
+				    KOREA
+				KR
+
+00-D0-75   (hex)		ALARIS MEDICAL SYSTEMS, INC.
+00D075     (base 16)		ALARIS MEDICAL SYSTEMS, INC.
+				P.O. BOX 85335
+				SAN DIEGO  CA  92121-2733
+				US
+
+00-D0-4C   (hex)		EUROTEL TELECOM LTD.
+00D04C     (base 16)		EUROTEL TELECOM LTD.
+				CANISTER HOUSE
+				  UNITED  KINGDOM
+				GB
+
+00-D0-E1   (hex)		AVIONITEK ISRAEL INC.
+00D0E1     (base 16)		AVIONITEK ISRAEL INC.
+				1 ETGAR STREET
+				    
+				IL
+
+00-D0-08   (hex)		MACTELL CORPORATION
+00D008     (base 16)		MACTELL CORPORATION
+				7000 CAMERON ROAD
+				AUSTIN  TX  78752
+				US
+
+00-D0-D9   (hex)		DEDICATED MICROCOMPUTERS
+00D0D9     (base 16)		DEDICATED MICROCOMPUTERS
+				1 Thellow Heath Park
+				Northwich    CW9 6JB
+				GB
+
+00-D0-0B   (hex)		RHK TECHNOLOGY, INC.
+00D00B     (base 16)		RHK TECHNOLOGY, INC.
+				1050 EAST MAPLE ROAD
+				TROY  MI  48083
+				US
+
+00-D0-9C   (hex)		KAPADIA COMMUNICATIONS
+00D09C     (base 16)		KAPADIA COMMUNICATIONS
+				3925 WEST BROKER LANE
+				AUSTIN  TX  78759
+				US
+
+00-D0-F3   (hex)		SOLARI DI UDINE SPA
+00D0F3     (base 16)		SOLARI DI UDINE SPA
+				VIA GINO PIERI 29
+				    
+				IT
+
+00-D0-39   (hex)		UTILICOM, INC.
+00D039     (base 16)		UTILICOM, INC.
+				323 LOVE PLACE
+				SANTA BARBARA  CA  93112-3289
+				US
+
+00-D0-A0   (hex)		MIPS DENMARK
+00D0A0     (base 16)		MIPS DENMARK
+				LAUTRUPVANG 2B
+				DK  -  
+				DK
+
+00-D0-0A   (hex)		LANACCESS TELECOM S.A.
+00D00A     (base 16)		LANACCESS TELECOM S.A.
+				GRAN VIA 8-10  4  1
+				    
+				ES
+
+00-D0-1C   (hex)		SBS TECHNOLOGIES,
+00D01C     (base 16)		SBS TECHNOLOGIES,
+				CONNECTIVITY PRODUCTS
+				ST. PAUL  MN  55121-1245
+				US
+
+00-D0-D5   (hex)		GRUNDIG AG
+00D0D5     (base 16)		GRUNDIG AG
+				KURGARTENSGTREET 37
+				    
+				DE
+
+00-D0-41   (hex)		AMIGO TECHNOLOGY CO., LTD.
+00D041     (base 16)		AMIGO TECHNOLOGY CO., LTD.
+				4F-1B, NO.12, LANE 609, SEC.5,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-D0-9D   (hex)		VERIS INDUSTRIES
+00D09D     (base 16)		VERIS INDUSTRIES
+				10831 SW CASCADE
+				PORTLAND  OR  97223
+				US
+
+00-D0-6D   (hex)		ACRISON, INC.
+00D06D     (base 16)		ACRISON, INC.
+				20 EMPIRE BLVD.
+				MOONACHIE  NJ  07074
+				US
+
+00-D0-2B   (hex)		JETCELL, INC.
+00D02B     (base 16)		JETCELL, INC.
+				173 CONSTITUTION DRIVE
+				MENLO PARK  CA  94025-1106
+				US
+
+00-D0-62   (hex)		DIGIGRAM
+00D062     (base 16)		DIGIGRAM
+				PARC DE PRE MILLIET
+				    
+				FR
+
+00-D0-8D   (hex)		PHOENIX GROUP, INC.
+00D08D     (base 16)		PHOENIX GROUP, INC.
+				123 MARCUS BLVD.
+				HAUPPAUGE  NY  11788
+				US
+
+00-D0-3D   (hex)		GALILEO TECHNOLOGY, LTD.
+00D03D     (base 16)		GALILEO TECHNOLOGY, LTD.
+				MOSHAV MANOF
+				    
+				IL
+
+00-50-C6   (hex)		LOOP TELECOMMUNICATION INTERNATIONAL, INC.
+0050C6     (base 16)		LOOP TELECOMMUNICATION INTERNATIONAL, INC.
+				7F, No. 8, Hsin Ann Road
+				Hsinchu    -   
+				TW
+
+00-50-9F   (hex)		HORIZON COMPUTER
+00509F     (base 16)		HORIZON COMPUTER
+				TRINITY BLDG. 4-22-7
+				 TOKYO 106    
+				JP
+
+00-50-A5   (hex)		CAPITOL BUSINESS SYSTEMS, LTD.
+0050A5     (base 16)		CAPITOL BUSINESS SYSTEMS, LTD.
+				43/44 RIVERSIDE
+				ROCHESTER, KENT  England ME2 4DP  
+				GB
+
+00-50-00   (hex)		NEXO COMMUNICATIONS, INC.
+005000     (base 16)		NEXO COMMUNICATIONS, INC.
+				2ND FL., 160, MINGCHU ROAD
+				HSINCHU CITY    
+				TW
+
+00-50-90   (hex)		DCTRI
+005090     (base 16)		DCTRI
+				NO.40 XUE YUAN RD
+				    
+				CN
+
+00-50-3B   (hex)		MEDIAFIRE CORPORATION
+00503B     (base 16)		MEDIAFIRE CORPORATION
+				11317 FREDERICK AVENUE
+				BELTSVILLE  MD  20705
+				US
+
+00-50-46   (hex)		MENICX INTERNATIONAL CO., LTD.
+005046     (base 16)		MENICX INTERNATIONAL CO., LTD.
+				NO.9, MING TSUN ROAD
+				TAIWAN 310  TAIWAN 310  R.O.C.
+				TW
+
+00-50-41   (hex)		Coretronic Corporation
+005041     (base 16)		Coretronic Corporation
+				NO.11, LI HSIN RD.
+				    
+				TW
+
+00-50-B0   (hex)		TECHNOLOGY ATLANTA CORPORATION
+0050B0     (base 16)		TECHNOLOGY ATLANTA CORPORATION
+				500 Sugar Mill Road
+				Atlanta  GA  30350
+				US
+
+00-50-DD   (hex)		SERRA SOLDADURA, S.A.
+0050DD     (base 16)		SERRA SOLDADURA, S.A.
+				POL. IND. ZONA FRANCA,
+				    
+				ES
+
+00-50-63   (hex)		OY COMSEL SYSTEM AB
+005063     (base 16)		OY COMSEL SYSTEM AB
+				TEGELBRUKSGATAN 5-7
+				FIN-65100 VASA    
+				FI
+
+00-50-8D   (hex)		ABIT COMPUTER CORPORATION
+00508D     (base 16)		ABIT COMPUTER CORPORATION
+				3F-7, NO. 79, SEC.1
+				TAIPEI HSIEN    
+				TW
+
+00-50-A0   (hex)		DELTA COMPUTER SYSTEMS, INC.
+0050A0     (base 16)		DELTA COMPUTER SYSTEMS, INC.
+				11719 NE 95TH STREET - STE.
+				VANCOUVER  WA  98682-2444
+				US
+
+00-50-66   (hex)		AtecoM GmbH advanced telecomunication modules
+005066     (base 16)		AtecoM GmbH advanced telecomunication modules
+				KAISERSTR. 100
+				D-52134 HERZOGENRATH    
+				DE
+
+00-50-59   (hex)		iBAHN
+005059     (base 16)		iBAHN
+				10757 S. River Front Parkway
+				South Jordan  UT  84095
+				US
+
+00-50-D9   (hex)		ENGETRON-ENGENHARIA ELETRONICA IND. e COM. LTDA
+0050D9     (base 16)		ENGETRON-ENGENHARIA ELETRONICA IND. e COM. LTDA
+				VIA SOCRATES M. BITTENCOURT, 1099
+				32010-010 Contagem MG    
+				BR
+
+00-50-01   (hex)		YAMASHITA SYSTEMS CORP.
+005001     (base 16)		YAMASHITA SYSTEMS CORP.
+				5-7-12 IKEGAMI
+				OTA-KU TOKYO    
+				JP
+
+00-50-67   (hex)		AEROCOMM, INC.
+005067     (base 16)		AEROCOMM, INC.
+				13256 W. 98TH STREET
+				LENEXA  KS  66215
+				US
+
+00-50-B6   (hex)		GOOD WAY IND. CO., LTD.
+0050B6     (base 16)		GOOD WAY IND. CO., LTD.
+				5F, NO.8, ALLEY 6,
+				  TAIWAN  R.O.C.
+				TW
+
+00-50-4B   (hex)		BARCONET N.V.
+00504B     (base 16)		BARCONET N.V.
+				LUIPAARDSTRAAT 12
+				    
+				BE
+
+00-50-EA   (hex)		XEL COMMUNICATIONS, INC.
+0050EA     (base 16)		XEL COMMUNICATIONS, INC.
+				17101 E. OHIO DRIVE
+				AURORA  CO  80017
+				US
+
+00-50-C8   (hex)		Addonics Technologies, Inc.
+0050C8     (base 16)		Addonics Technologies, Inc.
+				1918 Junction Ave.,
+				San Jose  CA  95131
+				US
+
+00-50-C4   (hex)		IMD
+0050C4     (base 16)		IMD
+				HERBSTRASSE 8
+				D-82178 PUCHHEIM    
+				DE
+
+00-50-89   (hex)		SAFETY MANAGEMENT SYSTEMS
+005089     (base 16)		SAFETY MANAGEMENT SYSTEMS
+				Burgemeester Burgerslaan 40
+				NH Rosmalen    5245
+				NL
+
+00-50-F4   (hex)		SIGMATEK GMBH & CO. KG
+0050F4     (base 16)		SIGMATEK GMBH & CO. KG
+				A-5112 LAMPRECHTSHAUSEN,
+				    
+				AT
+
+00-50-21   (hex)		EIS INTERNATIONAL, INC.
+005021     (base 16)		EIS INTERNATIONAL, INC.
+				1351 WASHINGTON BLVD.
+				STAMFORD  CT  06902
+				US
+
+00-50-5E   (hex)		DIGITEK MICROLOGIC S.A.
+00505E     (base 16)		DIGITEK MICROLOGIC S.A.
+				SANT JOAN DE LA SALLE 6
+				    
+				ES
+
+00-50-E8   (hex)		NOMADIX INC.
+0050E8     (base 16)		NOMADIX INC.
+				2701 OCEAN PARK BLVD.-STE.#231
+				SANTA MONICA  CA  90405
+				US
+
+00-50-AE   (hex)		FDK Co., Ltd
+0050AE     (base 16)		FDK Co., Ltd
+				2281 Washizu
+				Shizuoka-ken  431-0495  
+				JP
+
+00-50-E7   (hex)		PARADISE INNOVATIONS (ASIA)
+0050E7     (base 16)		PARADISE INNOVATIONS (ASIA)
+				PTE. LTD.
+				  SINGAPORE  554914
+				SG
+
+00-50-FB   (hex)		VSK ELECTRONICS
+0050FB     (base 16)		VSK ELECTRONICS
+				VENETIELAAN 39
+				    
+				BE
+
+00-90-73   (hex)		GAIO TECHNOLOGY
+009073     (base 16)		GAIO TECHNOLOGY
+				OAK-YOKOHAMA BLDG.
+				NISHI-KU YOKOHAMA-CITY  Kanagawa  
+				JP
+
+00-90-7B   (hex)		E-TECH, INC.
+00907B     (base 16)		E-TECH, INC.
+				30, R&D ROAD 2
+				HSINCHU    
+				TW
+
+00-90-81   (hex)		ALOHA NETWORKS, INC.
+009081     (base 16)		ALOHA NETWORKS, INC.
+				1001A O'REILLY AVENUE
+				SAN FRANCISCO  CA  94129-0472
+				US
+
+00-90-1C   (hex)		mps Software Gmbh
+00901C     (base 16)		mps Software Gmbh
+				LUDWIGSTR 36
+				85551 KIRCHHEIM    
+				DE
+
+00-50-86   (hex)		TELKOM SA, LTD.
+005086     (base 16)		TELKOM SA, LTD.
+				TELKOM LABORATORY
+				PRETORIA    
+				ZA
+
+00-50-1A   (hex)		IQinVision
+00501A     (base 16)		IQinVision
+				33122 Valle Road
+				San Juan Capistrano  CA  92675-4853
+				US
+
+00-50-8F   (hex)		ASITA TECHNOLOGIES INT'L LTD.
+00508F     (base 16)		ASITA TECHNOLOGIES INT'L LTD.
+				UNIT 2 BALLYBRIT BUSINESS PARK
+				    
+				IE
+
+00-50-15   (hex)		BRIGHT STAR ENGINEERING
+005015     (base 16)		BRIGHT STAR ENGINEERING
+				19 ENFIELD DRIVE
+				ANDOVER  MA  01810
+				US
+
+00-50-57   (hex)		BROADBAND ACCESS SYSTEMS
+005057     (base 16)		BROADBAND ACCESS SYSTEMS
+				48 South Park St #208
+				Montclair  NJ  01752
+				US
+
+00-50-88   (hex)		AMANO CORPORATION
+005088     (base 16)		AMANO CORPORATION
+				275, MAMEDO-CHO
+				222-8558    
+				JP
+
+00-50-31   (hex)		AEROFLEX LABORATORIES, INC.
+005031     (base 16)		AEROFLEX LABORATORIES, INC.
+				35 SOUTH SERVICE ROAD
+				PLAINVIEW  NY  11803
+				US
+
+00-90-DB   (hex)		NEXT LEVEL COMMUNICATIONS
+0090DB     (base 16)		NEXT LEVEL COMMUNICATIONS
+				6085 STATE FARM DRIVE
+				ROHNERT PARK  CA  94928
+				US
+
+00-90-56   (hex)		TELESTREAM, INC.
+009056     (base 16)		TELESTREAM, INC.
+				848 GOLD FLAT RD., SUITE 1
+				NEVADA CITY  CA  95959
+				US
+
+00-90-68   (hex)		DVT CORP.
+009068     (base 16)		DVT CORP.
+				1670 OAKBROOK DR. - STE. #330
+				NORCROSS  GA  30093
+				US
+
+00-90-5E   (hex)		RAULAND-BORG CORPORATION
+00905E     (base 16)		RAULAND-BORG CORPORATION
+				3450 W. OAKTON ST.
+				SKOKIE  IL  60076
+				US
+
+00-90-AF   (hex)		J. MORITA MFG. CORP.
+0090AF     (base 16)		J. MORITA MFG. CORP.
+				680 HIGASHIHAMA MINAMI-CHO
+				FUSHIMI-KU, KYOTO  612-8213  
+				JP
+
+00-50-03   (hex)		Xrite Inc
+005003     (base 16)		Xrite Inc
+				4300 44TH Street, S.E.
+				Grand Rapids  MI  49512
+				US
+
+00-50-D3   (hex)		DIGITAL AUDIO PROCESSING PTY. LTD.
+0050D3     (base 16)		DIGITAL AUDIO PROCESSING PTY. LTD.
+				PO BOX 40
+				NSW 2138    
+				AU
+
+00-50-AD   (hex)		CommUnique Wireless Corp.
+0050AD     (base 16)		CommUnique Wireless Corp.
+				1070 MARINA VILLAGE PARKWAY
+				ALAMEDA  CA  94501
+				US
+
+00-50-AF   (hex)		INTERGON, INC.
+0050AF     (base 16)		INTERGON, INC.
+				5800 RANCHESTER DRIVE
+				HOUSTON  TX  77036
+				US
+
+00-90-34   (hex)		IMAGIC, INC.
+009034     (base 16)		IMAGIC, INC.
+				235 West Road #7
+				Portsmouth  NH  03801
+				US
+
+00-90-AA   (hex)		INDIGO ACTIVE VISION SYSTEMS LIMITED
+0090AA     (base 16)		INDIGO ACTIVE VISION SYSTEMS LIMITED
+				THE EDINBURGH TECHNOPOLE
+				Edinburgh EH26 OPJ    
+				GB
+
+00-90-5B   (hex)		RAYMOND AND LAE ENGINEERING
+00905B     (base 16)		RAYMOND AND LAE ENGINEERING
+				208 COMMERCE DR.,  UNIT #3C
+				FORT COLLINS  CO  80524
+				US
+
+00-90-BC   (hex)		TELEMANN CO., LTD.
+0090BC     (base 16)		TELEMANN CO., LTD.
+				6F DONGSIN BLDG.
+				SEOUL, 135-270    
+				KR
+
+00-90-0A   (hex)		PROTON ELECTRONIC INDUSTRIAL CO., LTD.
+00900A     (base 16)		PROTON ELECTRONIC INDUSTRIAL CO., LTD.
+				
+				PANCHIAO, Taipei County    
+				TW
+
+00-90-F8   (hex)		MEDIATRIX TELECOM
+0090F8     (base 16)		MEDIATRIX TELECOM
+				4229 GARLOCK
+				QUEBEC J1L 2C8    
+				CA
+
+00-90-10   (hex)		SIMULATION LABORATORIES, INC.
+009010     (base 16)		SIMULATION LABORATORIES, INC.
+				10078 TYLER PLACE #A
+				IJAMSVILLE  MD  21754
+				US
+
+00-90-C6   (hex)		OPTIM SYSTEMS, INC.
+0090C6     (base 16)		OPTIM SYSTEMS, INC.
+				8201 GREENSBORO DR.-STE. #1000
+				MCLEAN  VA  22102
+				US
+
+00-90-2E   (hex)		NAMCO LIMITED
+00902E     (base 16)		NAMCO LIMITED
+				1-1-32 SHIN-URASHIMA-CHO
+				KANAGAWA 221-0031    
+				JP
+
+00-90-37   (hex)		ACUCOMM, INC.
+009037     (base 16)		ACUCOMM, INC.
+				4633 OLD IRONSIDES - STE #310
+				SANTA CLARA  CA  95054
+				US
+
+00-90-78   (hex)		MER TELEMANAGEMENT SOLUTIONS, LTD.
+009078     (base 16)		MER TELEMANAGEMENT SOLUTIONS, LTD.
+				5 HATSOREF STR.
+				HOLON    
+				IL
+
+00-90-B8   (hex)		ROHDE & SCHWARZ GMBH & CO. KG
+0090B8     (base 16)		ROHDE & SCHWARZ GMBH & CO. KG
+				POSTFACH: 80 14 69/ABT.: 3CK
+				D-81614 MUNCHEN    
+				DE
+
+00-90-1A   (hex)		UNISPHERE SOLUTIONS
+00901A     (base 16)		UNISPHERE SOLUTIONS
+				5 CARLISLE ROAD
+				WESTFORD  MA  01886
+				US
+
+00-90-B5   (hex)		NIKON CORPORATION
+0090B5     (base 16)		NIKON CORPORATION
+				Electronic Imaging Division, Designing D
+				TOKYO 140-8601    
+				JP
+
+00-90-05   (hex)		PROTECH SYSTEMS CO., LTD.
+009005     (base 16)		PROTECH SYSTEMS CO., LTD.
+				5F, NO. 34, LANE 80, SEC. 3
+				TAIPEI    
+				TW
+
+00-90-59   (hex)		TELECOM DEVICE K.K.
+009059     (base 16)		TELECOM DEVICE K.K.
+				SANMIYANAGA BLDG. 3F, 1-5-12
+				  TOKYO 107  
+				JP
+
+00-90-CA   (hex)		ACCORD VIDEO TELECOMMUNICATIONS, LTD.
+0090CA     (base 16)		ACCORD VIDEO TELECOMMUNICATIONS, LTD.
+				10, MARTIN GEHL STR, PO BOX 3564
+				Petach-Tikva 49130    
+				IL
+
+00-90-E9   (hex)		JANZ COMPUTER AG
+0090E9     (base 16)		JANZ COMPUTER AG
+				Im Dörener Feld 8
+				D-33100  Paderborn  
+				DE
+
+00-90-EB   (hex)		SENTRY TELECOM SYSTEMS
+0090EB     (base 16)		SENTRY TELECOM SYSTEMS
+				8664 COMMERCE COURT
+				BURNABY  BC V5A 4N7  
+				CA
+
+00-90-FE   (hex)		ELECOM CO., LTD.  (LANEED DIV.)
+0090FE     (base 16)		ELECOM CO., LTD.  (LANEED DIV.)
+				TOKYU BANCHO BLDG.
+				Chiyoda-ku  TOKYO  102-0081
+				JP
+
+00-90-BB   (hex)		TAINET COMMUNICATION SYSTEM Corp.
+0090BB     (base 16)		TAINET COMMUNICATION SYSTEM Corp.
+				3 FL, NO. 6, ALLEY 23, LANE 91 SEC. 1
+				Taipei    
+				TW
+
+00-90-90   (hex)		I-BUS
+009090     (base 16)		I-BUS
+				9174 SKY PARK COURT
+				SAN DIEGO  CA  92123
+				US
+
+00-90-D5   (hex)		EUPHONIX, INC.
+0090D5     (base 16)		EUPHONIX, INC.
+				220 PORTAGE AVE.
+				PALO ALTO  CA  94306
+				US
+
+00-90-4A   (hex)		CONCUR SYSTEM TECHNOLOGIES
+00904A     (base 16)		CONCUR SYSTEM TECHNOLOGIES
+				2525 WALLINGWOOD DR.-STE. #804
+				AUSTIN  TX  78746
+				US
+
+00-90-8F   (hex)		AUDIO CODES LTD.
+00908F     (base 16)		AUDIO CODES LTD.
+				3A NETANYAHU STREET
+				OR YEHUDA 60256    
+				IL
+
+00-90-9E   (hex)		Critical IO, LLC
+00909E     (base 16)		Critical IO, LLC
+				485 E. 17th Street
+				Costa Mesa  CA  92627
+				US
+
+00-10-92   (hex)		NETCORE INC.
+001092     (base 16)		NETCORE INC.
+				12F-2, 537, SEC.2
+				HSINCHU    
+				TW
+
+00-10-1C   (hex)		OHM TECHNOLOGIES INTL, LLC
+00101C     (base 16)		OHM TECHNOLOGIES INTL, LLC
+				4 EXECUTIVE CIRCLE, Suite 185
+				IRVINE  CA  92614
+				US
+
+00-10-46   (hex)		ALCORN MCBRIDE INC.
+001046     (base 16)		ALCORN MCBRIDE INC.
+				3300 S. HIAWASSEE  #105
+				ORLANDO  FL  32835
+				US
+
+00-10-28   (hex)		COMPUTER TECHNICA, INC.
+001028     (base 16)		COMPUTER TECHNICA, INC.
+				3-5-19 HIGASHINAKA HAKATA-KU
+				FUKUOKA  816    
+				JP
+
+00-10-B7   (hex)		COYOTE TECHNOLOGIES, LLC
+0010B7     (base 16)		COYOTE TECHNOLOGIES, LLC
+				4360 PARK TERRACE DRIVE
+				WESTLAKE VILLAGE  CA  91361
+				US
+
+00-90-E5   (hex)		TEKNEMA, INC.
+0090E5     (base 16)		TEKNEMA, INC.
+				2656 E. BAYSHORE ROAD
+				PALO ALTO  CA  94303
+				US
+
+00-90-F4   (hex)		LIGHTNING INSTRUMENTATION
+0090F4     (base 16)		LIGHTNING INSTRUMENTATION
+				BOVERESSES 50
+				1010 LAUSANNE    
+				CH
+
+00-90-74   (hex)		ARGON NETWORKS, INC.
+009074     (base 16)		ARGON NETWORKS, INC.
+				25 PORTER ROAD
+				LITTLETON  MA  01460
+				US
+
+00-90-9F   (hex)		DIGI-DATA CORPORATION
+00909F     (base 16)		DIGI-DATA CORPORATION
+				7165 Columbia Gateway Drive
+				Columbia  MD  21045
+				US
+
+00-90-3B   (hex)		TriEMS Research Lab, Inc.
+00903B     (base 16)		TriEMS Research Lab, Inc.
+				1275 N. TUSTIN AVENUE
+				ANAHEIM  CA  92807
+				US
+
+00-10-C9   (hex)		MITSUBISHI ELECTRONICS LOGISTIC SUPPORT CO.
+0010C9     (base 16)		MITSUBISHI ELECTRONICS LOGISTIC SUPPORT CO.
+				
+				Kamakura-city, Kanagawa 247    
+				JP
+
+00-04-00   (hex)		LEXMARK INTERNATIONAL, INC.
+000400     (base 16)		LEXMARK INTERNATIONAL, INC.
+				740 NEW CIRCLE ROAD
+				LEXINGTON  KY  40550
+				US
+
+00-10-C5   (hex)		PROTOCOL TECHNOLOGIES, INC.
+0010C5     (base 16)		PROTOCOL TECHNOLOGIES, INC.
+				4 FIRST STREET
+				BRIDGEWATER  MA  02324
+				US
+
+00-10-1A   (hex)		PictureTel Corp.
+00101A     (base 16)		PictureTel Corp.
+				100 MINUTEMAN ROAD, MS641
+				ANDOVER  MA  01810
+				US
+
+00-10-47   (hex)		ECHO ELETRIC CO. LTD.
+001047     (base 16)		ECHO ELETRIC CO. LTD.
+				NO.6-17-1-602 Higashi Hongou
+				Yokohama City    226
+				JP
+
+00-90-3F   (hex)		AZTEC RADIOMEDIA
+00903F     (base 16)		AZTEC RADIOMEDIA
+				31, RUE DU CHEMINDEFER
+				67200 STRASBOURG    
+				FR
+
+00-10-43   (hex)		A2 CORPORATION
+001043     (base 16)		A2 CORPORATION
+				6-14-11 YUTAKA-CHO
+				TOKYO    
+				JP
+
+00-10-A5   (hex)		OXFORD INSTRUMENTS
+0010A5     (base 16)		OXFORD INSTRUMENTS
+				Halifax Road
+				Buckinghamshire    HP12 3SE
+				GB
+
+00-10-D7   (hex)		ARGOSY RESEARCH INC.
+0010D7     (base 16)		ARGOSY RESEARCH INC.
+				NO. 44, LANE 411, CHUNG HUA RD
+				    
+				TW
+
+00-10-2C   (hex)		Lasat Networks A/S
+00102C     (base 16)		Lasat Networks A/S
+				Skalhuse 13
+				SK-9240 Nibe    
+				DK
+
+00-10-FD   (hex)		COCOM A/S
+0010FD     (base 16)		COCOM A/S
+				TELETONVEJ 8
+				DK 2860 SOBORG    
+				DK
+
+00-90-19   (hex)		HERMES ELECTRONICS CO., LTD.
+009019     (base 16)		HERMES ELECTRONICS CO., LTD.
+				3-2-12 YUSHIMA, BUNKYO-KU
+				TOKYO, 113-0034    
+				JP
+
+00-90-D8   (hex)		WHITECROSS SYSTEMS
+0090D8     (base 16)		WHITECROSS SYSTEMS
+				3A WATERSIDE PARK, COOKHAM RD
+				BERKSHIRE RG12 1RB    
+				GB
+
+00-10-4E   (hex)		CEOLOGIC
+00104E     (base 16)		CEOLOGIC
+				ZA DE PISSALOOP
+				78192 TRAPPES    
+				FR
+
+00-10-C2   (hex)		WILLNET, INC.
+0010C2     (base 16)		WILLNET, INC.
+				JOWA-TAKANAWA  BLDG. 8F
+				TOKYO    
+				JP
+
+00-10-40   (hex)		INTERMEC CORPORATION
+001040     (base 16)		INTERMEC CORPORATION
+				6001 36TH AVE WEST
+				EVERETT  WA  98203-9280
+				US
+
+00-10-2E   (hex)		NETWORK SYSTEMS & TECHNOLOGIES PVT. LTD.
+00102E     (base 16)		NETWORK SYSTEMS & TECHNOLOGIES PVT. LTD.
+				PLOT NO. 2, COCHIN EXPORT PROCESSING  ZO
+				KAKKANAD, COCHIN 682 030    
+				IN
+
+00-10-B0   (hex)		MERIDIAN TECHNOLOGY CORP.
+0010B0     (base 16)		MERIDIAN TECHNOLOGY CORP.
+				11 MCBRIDE CORP. CENTER DR.
+				CHESTERFIELD  MD  63005
+				US
+
+00-10-21   (hex)		ENCANTO NETWORKS, INC.
+001021     (base 16)		ENCANTO NETWORKS, INC.
+				2953 BUNKER HILL LANE
+				SANTA CLARA  CA  95054
+				US
+
+00-10-64   (hex)		DNPG, LLC
+001064     (base 16)		DNPG, LLC
+				20 North Wentworth Avenue
+				Londonderry  NH  03053
+				US
+
+00-10-74   (hex)		ATEN INTERNATIONAL CO., LTD.
+001074     (base 16)		ATEN INTERNATIONAL CO., LTD.
+				12F, NO.101, SUNG CHIANG RD.
+				TAIPEI, 10428    
+				TW
+
+00-10-9E   (hex)		AWARE, INC.
+00109E     (base 16)		AWARE, INC.
+				ONE OAK PARK
+				BEDFORD  MA  01730
+				US
+
+00-10-05   (hex)		UEC COMMERCIAL
+001005     (base 16)		UEC COMMERCIAL
+				P.O. BOX 54,
+				4300 DURBAN    
+				ZA
+
+00-10-B8   (hex)		ISHIGAKI COMPUTER SYSTEM CO.
+0010B8     (base 16)		ISHIGAKI COMPUTER SYSTEM CO.
+				1-1-1, KYOBASHI,
+				Tokyo    
+				JP
+
+00-10-8B   (hex)		LASERANIMATION SOLLINGER GMBH
+00108B     (base 16)		LASERANIMATION SOLLINGER GMBH
+				CRELLESTR. 19/20
+				D 10827 BERLIN    
+				DE
+
+00-10-C7   (hex)		DATA TRANSMISSION NETWORK
+0010C7     (base 16)		DATA TRANSMISSION NETWORK
+				9110 W. DODGE RD. - STE.#200
+				OMAHA  NE  68114
+				US
+
+00-10-70   (hex)		CARADON TREND LTD.
+001070     (base 16)		CARADON TREND LTD.
+				P.O. BOX 34, HORSHAM
+				WEST SUSSEX, RH12 2YF  ENGLAND  
+				GB
+
+00-10-BA   (hex)		MARTINHO-DAVIS SYSTEMS, INC.
+0010BA     (base 16)		MARTINHO-DAVIS SYSTEMS, INC.
+				1260 OLD INNES ROAD
+				OTTAWA, ONTARIO K1B 3V3    
+				CA
+
+00-10-B4   (hex)		ATMOSPHERE NETWORKS
+0010B4     (base 16)		ATMOSPHERE NETWORKS
+				10460 BANDLEY DRIVE
+				CUPERTINO  CA  95014
+				US
+
+00-04-AC   (hex)		IBM Corp
+0004AC     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-10-67   (hex)		Ericsson
+001067     (base 16)		Ericsson
+				250 Holger Way
+				SAN JOSE  CA  95134
+				US
+
+00-E0-7D   (hex)		NETRONIX, INC.
+00E07D     (base 16)		NETRONIX, INC.
+				340 THOR PLACE
+				BREA  CA  92821
+				US
+
+00-E0-28   (hex)		APTIX CORPORATION
+00E028     (base 16)		APTIX CORPORATION
+				2880 N. FIRST STREET
+				SAN JOSE  CA  95134
+				US
+
+00-E0-8C   (hex)		NEOPARADIGM LABS, INC.
+00E08C     (base 16)		NEOPARADIGM LABS, INC.
+				1735 N. FIRST ST.,  STE #108
+				SAN JOSE  CA  95112
+				US
+
+00-E0-A1   (hex)		HIMA PAUL HILDEBRANDT GmbH Co. KG
+00E0A1     (base 16)		HIMA PAUL HILDEBRANDT GmbH Co. KG
+				POSTBOX 1261
+				D-68777 BRUEHL NEAR MANNHEIM    
+				DE
+
+00-E0-88   (hex)		LTX-Credence CORPORATION
+00E088     (base 16)		LTX-Credence CORPORATION
+				825 UNIVERSITY AVENUE
+				NORWOOD  MA  02062-2643
+				US
+
+00-E0-5D   (hex)		UNITEC CO., LTD.
+00E05D     (base 16)		UNITEC CO., LTD.
+				KISOGAWA-CHO  ICHINOTORI 24
+				HAGURI-GUN AICHI 493    
+				JP
+
+00-E0-5E   (hex)		JAPAN AVIATION ELECTRONICS INDUSTRY, LTD.
+00E05E     (base 16)		JAPAN AVIATION ELECTRONICS INDUSTRY, LTD.
+				
+				TOKYO 196  JAPAN  
+				JP
+
+00-E0-9D   (hex)		SARNOFF CORPORATION
+00E09D     (base 16)		SARNOFF CORPORATION
+				CN 5300
+				PRINCETON  NJ  08543-5300
+				US
+
+00-E0-58   (hex)		PHASE ONE DENMARK A/S
+00E058     (base 16)		PHASE ONE DENMARK A/S
+				ROSKILDEVEJ 39
+				DK-2000 FREDERIKSBERG    
+				DK
+
+00-E0-76   (hex)		DEVELOPMENT CONCEPTS, INC.
+00E076     (base 16)		DEVELOPMENT CONCEPTS, INC.
+				1000 N. BROAD STREET
+				LANSDALE  PA  19446
+				US
+
+00-E0-F8   (hex)		DICNA CONTROL AB
+00E0F8     (base 16)		DICNA CONTROL AB
+				STENYXEGATAN 21 C
+				213 76 MALMOE    
+				SE
+
+00-E0-DF   (hex)		KEYMILE GmbH
+00E0DF     (base 16)		KEYMILE GmbH
+				Wohlenbergstraße 3
+				30179  Hannover  
+				DE
+
+00-E0-F2   (hex)		ARLOTTO COMNET, INC.
+00E0F2     (base 16)		ARLOTTO COMNET, INC.
+				7F-4,55,TUNG-KUANG ROAD
+				HSIN-CHU, 300    
+				TW
+
+00-E0-E1   (hex)		G2 NETWORKS, INC.
+00E0E1     (base 16)		G2 NETWORKS, INC.
+				142 SO. SANTA CRUZ AVE.
+				LOS GATOS  CA  95030-6702
+				US
+
+00-E0-3D   (hex)		FOCON ELECTRONIC SYSTEMS A/S
+00E03D     (base 16)		FOCON ELECTRONIC SYSTEMS A/S
+				DAMVANG, PO BOX 269
+				DK-6400 SONDERBORG    
+				DK
+
+00-E0-46   (hex)		BENTLY NEVADA CORP.
+00E046     (base 16)		BENTLY NEVADA CORP.
+				PO BOX 157
+				MINDEN  NV  89423
+				US
+
+00-E0-7B   (hex)		BAY NETWORKS
+00E07B     (base 16)		BAY NETWORKS
+				125 NAGOG PARK
+				ACTON  MA  01720
+				US
+
+00-E0-1D   (hex)		WebTV NETWORKS, INC.
+00E01D     (base 16)		WebTV NETWORKS, INC.
+				305 LYTTON AVE.
+				PALO ALTO  CA  94301
+				US
+
+00-E0-CD   (hex)		SAAB SENSIS CORPORATION
+00E0CD     (base 16)		SAAB SENSIS CORPORATION
+				85 Collamer Crossings
+				East Syracuse  NY  13057
+				US
+
+00-E0-8D   (hex)		PRESSURE SYSTEMS, INC.
+00E08D     (base 16)		PRESSURE SYSTEMS, INC.
+				34 RESEARCH DRIVE
+				HAMPTON  VA  23666
+				US
+
+00-E0-19   (hex)		ING. GIORDANO ELETTRONICA
+00E019     (base 16)		ING. GIORDANO ELETTRONICA
+				VIA PIETRO COSSA  115/12
+				10146-TORINO    
+				IT
+
+00-E0-47   (hex)		InFocus Corporation
+00E047     (base 16)		InFocus Corporation
+				27500 SW Parkway Avenue
+				Wilsonville  OR  97070-8238
+				US
+
+00-E0-C3   (hex)		SAKAI SYSTEM DEVELOPMENT CORP.
+00E0C3     (base 16)		SAKAI SYSTEM DEVELOPMENT CORP.
+				PORTUS CENTER BLD., 4-45-1
+				OSAKA-FU, 590    
+				JP
+
+00-E0-92   (hex)		ADMTEK INCORPORATED
+00E092     (base 16)		ADMTEK INCORPORATED
+				1962 ZANKER ROAD
+				SAN JOSE  CA  95112
+				US
+
+00-E0-FF   (hex)		SECURITY DYNAMICS TECHNOLOGIES, Inc.
+00E0FF     (base 16)		SECURITY DYNAMICS TECHNOLOGIES, Inc.
+				20 CROSBY DRIVE
+				BEDFORD  MA  01730
+				US
+
+00-E0-AB   (hex)		DIMAT S.A.
+00E0AB     (base 16)		DIMAT S.A.
+				C/BISCAIA 383 3
+				08023  BARCELONA    
+				ES
+
+00-E0-30   (hex)		MELITA INTERNATIONAL CORP.
+00E030     (base 16)		MELITA INTERNATIONAL CORP.
+				5051 PEACHTREE CORNERS CIRCLE
+				NORCROSS  GA  30092
+				US
+
+00-E0-33   (hex)		E.E.P.D. GmbH
+00E033     (base 16)		E.E.P.D. GmbH
+				ROEMER-STRASSE 4
+				85229 MARKT INDERSDORF    
+				DE
+
+00-E0-A2   (hex)		MICROSLATE INC.
+00E0A2     (base 16)		MICROSLATE INC.
+				9625 IGNACE - STE. D
+				BROSSARD  QC J4Y 2P3    
+				CA
+
+00-E0-79   (hex)		A.T.N.R.
+00E079     (base 16)		A.T.N.R.
+				BP 966
+				91976 COURTABOEUF    
+				FR
+
+00-E0-75   (hex)		Verilink Corporation
+00E075     (base 16)		Verilink Corporation
+				127 Jetplex Circle
+				Madison  AL  35758
+				US
+
+00-60-39   (hex)		SanCom Technology, Inc.
+006039     (base 16)		SanCom Technology, Inc.
+				7719 WOOD HOLLOW DRIVE
+				AUSTIN  TX  78731
+				US
+
+00-60-49   (hex)		VINA TECHNOLOGIES
+006049     (base 16)		VINA TECHNOLOGIES
+				6 UNION SQUARE - STE F
+				UNION CITY  CA  94587
+				US
+
+00-60-8D   (hex)		UNIPULSE CORP.
+00608D     (base 16)		UNIPULSE CORP.
+				2-7, SENGENDAI-NISHI
+				SAITAMA 343    
+				JO
+
+00-E0-2E   (hex)		SPC ELECTRONICS CORPORATION
+00E02E     (base 16)		SPC ELECTRONICS CORPORATION
+				2-1-3 SHIBASAKI, CHOFU-SHI
+				TOKYO, 182    
+				JP
+
+00-E0-9A   (hex)		Positron Inc.
+00E09A     (base 16)		Positron Inc.
+				5101 Buchan Street
+				Montreal,  Québec  H4P 2R9
+				CA
+
+00-E0-3E   (hex)		ALFATECH, INC.
+00E03E     (base 16)		ALFATECH, INC.
+				SHIN-OSAKA EITO BLDG.
+				OSAKA    
+				JP
+
+00-60-99   (hex)		SBE, Inc.
+006099     (base 16)		SBE, Inc.
+				4000 Executive Parkway
+				San Ramon  CA  94583
+				US
+
+00-60-B3   (hex)		Z-COM, INC.
+0060B3     (base 16)		Z-COM, INC.
+				7F-2, NO.9, PROSPERITY 1ST RD.
+				HSINCHU    
+				TW
+
+00-60-02   (hex)		SCREEN SUBTITLING SYSTEMS, LTD
+006002     (base 16)		SCREEN SUBTITLING SYSTEMS, LTD
+				THE OLD RECTORY
+				CLAYDON  IPSWICH  IP6 OEQ  
+				GB
+
+00-60-89   (hex)		XATA
+006089     (base 16)		XATA
+				151 EAST CLIFF ROAD-STE.#10
+				BURNSVILLE  MN  55337
+				US
+
+00-60-21   (hex)		DSC CORPORATION
+006021     (base 16)		DSC CORPORATION
+				RECRUIT-SHINOHTSUKA BLDG.,
+				TOKYO 170    
+				JP
+
+00-60-B8   (hex)		CORELIS Inc.
+0060B8     (base 16)		CORELIS Inc.
+				12607 Hiddencreek Way
+				Cerritos  CA  90703
+				US
+
+00-E0-AA   (hex)		ELECTROSONIC LTD.
+00E0AA     (base 16)		ELECTROSONIC LTD.
+				HAWLEY MILL, HAWLEY RD.
+				DARTFORD, KENT DA2 7SY    
+				GB
+
+00-E0-10   (hex)		HESS SB-AUTOMATENBAU GmbH
+00E010     (base 16)		HESS SB-AUTOMATENBAU GmbH
+				HINDENBURGSTRASSE 27-29
+				D-71106 MAGSTADT    
+				DE
+
+00-E0-D2   (hex)		VERSANET COMMUNICATIONS, INC.
+00E0D2     (base 16)		VERSANET COMMUNICATIONS, INC.
+				628 N. DIAMOND BAR BLVD.
+				DIAMOND BAR  CA  91765
+				US
+
+00-60-CE   (hex)		ACCLAIM COMMUNICATIONS
+0060CE     (base 16)		ACCLAIM COMMUNICATIONS
+				5000 OLD IRONSIDES DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-60-36   (hex)		AIT Austrian Institute of Technology GmbH
+006036     (base 16)		AIT Austrian Institute of Technology GmbH
+				Donau-City-Straße 1
+				Vienna    1220
+				AT
+
+00-60-8E   (hex)		HE ELECTRONICS, TECHNOLOGIE & SYSTEMTECHNIK GmbH
+00608E     (base 16)		HE ELECTRONICS, TECHNOLOGIE & SYSTEMTECHNIK GmbH
+				AM GNEISENAUFLOT 8
+				 D-66538 NEUNHIRCHEN    
+				DE
+
+00-60-1A   (hex)		KEITHLEY INSTRUMENTS
+00601A     (base 16)		KEITHLEY INSTRUMENTS
+				30500 BAINBRIDGE RD.
+				SOLON  OH  44139
+				US
+
+00-60-6A   (hex)		MITSUBISHI WIRELESS COMMUNICATIONS. INC.
+00606A     (base 16)		MITSUBISHI WIRELESS COMMUNICATIONS. INC.
+				2001 CHERRY DRIVE
+				BRASELTON  GA  30517
+				US
+
+00-60-AD   (hex)		MegaChips Corporation
+0060AD     (base 16)		MegaChips Corporation
+				4-1-6,Miyahara
+				  Osaka  532-0003
+				JP
+
+00-60-55   (hex)		CORNELL UNIVERSITY
+006055     (base 16)		CORNELL UNIVERSITY
+				729 Rhodes Hall
+				ITHACA  NY  14850-4902
+				US
+
+00-60-6D   (hex)		DIGITAL EQUIPMENT CORP.
+00606D     (base 16)		DIGITAL EQUIPMENT CORP.
+				550 KING STREET
+				LITTLETON  MA  01460
+				US
+
+00-60-B9   (hex)		NEC Platforms, Ltd
+0060B9     (base 16)		NEC Platforms, Ltd
+				2-6-1,Kitamikata,Takatsu-ku
+				Kawasaki    213-8511
+				JP
+
+00-60-9C   (hex)		Perkin-Elmer Incorporated
+00609C     (base 16)		Perkin-Elmer Incorporated
+				710 Bridgeport Ave.
+				Shelton  CT  06484
+				US
+
+00-60-CF   (hex)		ALTEON NETWORKS, INC.
+0060CF     (base 16)		ALTEON NETWORKS, INC.
+				50 GREAT OAKS BLVD.
+				SAN JOSE  CA  95119
+				US
+
+00-60-75   (hex)		PENTEK, INC.
+006075     (base 16)		PENTEK, INC.
+				1 PARK WAY
+				UPPER SADDLE RIVER  NJ  07458
+				US
+
+00-60-B7   (hex)		CHANNELMATIC, INC.
+0060B7     (base 16)		CHANNELMATIC, INC.
+				1700 GILLESPIE WAY
+				EL CAJON  CA  92020-0901
+				US
+
+00-60-06   (hex)		SOTEC CO., LTD
+006006     (base 16)		SOTEC CO., LTD
+				YOKOHAMA BASHAMICHI BLDG.,
+				YOKOHAMA  231    
+				JP
+
+00-60-BA   (hex)		SAHARA NETWORKS, INC.
+0060BA     (base 16)		SAHARA NETWORKS, INC.
+				335 HIGHLAND AVE.
+				CHESHIRE  CT  06410
+				US
+
+00-60-98   (hex)		HT COMMUNICATIONS
+006098     (base 16)		HT COMMUNICATIONS
+				4480 SHOPPING LANE
+				SIMI VALLEY  CA  93063
+				US
+
+00-60-DE   (hex)		Kayser-Threde GmbH
+0060DE     (base 16)		Kayser-Threde GmbH
+				Wolfratshauser Str. 48
+				D-81379  Munich  
+				DE
+
+00-60-D0   (hex)		SNMP RESEARCH INCORPORATED
+0060D0     (base 16)		SNMP RESEARCH INCORPORATED
+				3001 KIMBERLIN HEIGHTS ROAD
+				KNOXVILLE  TN  37920-9716
+				US
+
+00-60-15   (hex)		NET2NET CORPORATION
+006015     (base 16)		NET2NET CORPORATION
+				131 COOLIDGE STREET
+				HUDSON  MA  01749
+				US
+
+00-60-9D   (hex)		PMI FOOD EQUIPMENT GROUP
+00609D     (base 16)		PMI FOOD EQUIPMENT GROUP
+				701 RIDGE AVENUE
+				TROY  OH  45374
+				US
+
+00-60-A2   (hex)		NIHON UNISYS LIMITED CO.
+0060A2     (base 16)		NIHON UNISYS LIMITED CO.
+				P.O. BOX 135
+				SHINONOME 1-10-9    
+				JP
+
+00-60-84   (hex)		DIGITAL VIDEO
+006084     (base 16)		DIGITAL VIDEO
+				4920 AVALON RIDGE PKWY
+				NORCROSS  GA  30092
+				US
+
+00-60-2D   (hex)		ALERTON TECHNOLOGIES, INC.
+00602D     (base 16)		ALERTON TECHNOLOGIES, INC.
+				6670 185TH AVE. N.E.
+				REDMOND  WA  98052
+				US
+
+00-60-F8   (hex)		Loran International Technologies Inc.
+0060F8     (base 16)		Loran International Technologies Inc.
+				955 GREEN VALLEY CRESCENT
+				OTTAWA, ONTARIO K2C 3V4    
+				CA
+
+00-60-78   (hex)		POWER MEASUREMENT LTD.
+006078     (base 16)		POWER MEASUREMENT LTD.
+				2195 KEATING CROSS ROAD
+				SAANICHTON, B.C. V8M 2A5    
+				CA
+
+00-60-E8   (hex)		HITACHI COMPUTER PRODUCTS (AMERICA), INC.
+0060E8     (base 16)		HITACHI COMPUTER PRODUCTS (AMERICA), INC.
+				3101 TASMAN DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-60-F6   (hex)		NEXTEST COMMUNICATIONS PRODUCTS, INC.
+0060F6     (base 16)		NEXTEST COMMUNICATIONS PRODUCTS, INC.
+				TWO MID AMERICA PLAZA, STE.500
+				OAKBROOK TERRACE  IL  60181
+				US
+
+00-60-72   (hex)		VXL INSTRUMENTS, LIMITED
+006072     (base 16)		VXL INSTRUMENTS, LIMITED
+				PLOT NO. 17, KONAPPANA AGRAHARA
+				BANGALORE -  561 229    
+				IN
+
+00-60-51   (hex)		QUALITY SEMICONDUCTOR
+006051     (base 16)		QUALITY SEMICONDUCTOR
+				851 MARTIN AVENUE
+				SANTA CLARA  CA  95050
+				US
+
+00-60-92   (hex)		MICRO/SYS, INC.
+006092     (base 16)		MICRO/SYS, INC.
+				3447 OCEAN VIEW BLVD.
+				GLENDALE  CA  91208
+				US
+
+00-60-9E   (hex)		ASC X3 - INFORMATION TECHNOLOGY STANDARDS SECRETARIATS
+00609E     (base 16)		ASC X3 - INFORMATION TECHNOLOGY STANDARDS SECRETARIATS
+				1250 EYE STREET NW - STE #200
+				WASHINGTON  DC  20005
+				US
+
+00-60-10   (hex)		NETWORK MACHINES, INC.
+006010     (base 16)		NETWORK MACHINES, INC.
+				255 OLD NEW BRUNSWICK RD., # N320
+				PISCATAWAY  NJ  08854
+				US
+
+00-60-44   (hex)		LITTON/POLY-SCIENTIFIC
+006044     (base 16)		LITTON/POLY-SCIENTIFIC
+				2200 SOUTH MAIN STREET
+				BLACKSBURG  VA  24060
+				US
+
+00-60-04   (hex)		COMPUTADORES MODULARES SA
+006004     (base 16)		COMPUTADORES MODULARES SA
+				AVDA MONTESIERRA S/N
+				41020-SEVILLA    
+				ES
+
+00-60-E2   (hex)		QUEST ENGINEERING & DEVELOPMENT
+0060E2     (base 16)		QUEST ENGINEERING & DEVELOPMENT
+				1345 EAST ROCK WREN ROAD
+				PHOENIX  AZ  85048
+				US
+
+00-60-B4   (hex)		GLENAYRE R&D INC.
+0060B4     (base 16)		GLENAYRE R&D INC.
+				1570 KOOTENAY STREET
+				VANCOUVER, BC V5K 5B8    
+				CA
+
+00-A0-1D   (hex)		Red Lion Controls, LP
+00A01D     (base 16)		Red Lion Controls, LP
+				20 Willow Springs Circle
+				York  NY  17402
+				US
+
+00-A0-A6   (hex)		M.I. SYSTEMS, K.K.
+00A0A6     (base 16)		M.I. SYSTEMS, K.K.
+				2-7-12-308 Satsukigaoka
+				Ikeda-Shi  Osaka  563-0029
+				JP
+
+00-A0-51   (hex)		ANGIA COMMUNICATIONS. INC.
+00A051     (base 16)		ANGIA COMMUNICATIONS. INC.
+				441 EAST BAY BLVD.
+				PROVO  UTAH  84606
+				US
+
+00-A0-13   (hex)		TELTREND LTD.
+00A013     (base 16)		TELTREND LTD.
+				RINGWAY HOUSE, BELL ROAD
+				BASINGSTOKE HAMPSHIRE RG24 8F    
+				GB
+
+00-A0-B9   (hex)		EAGLE TECHNOLOGY, INC.
+00A0B9     (base 16)		EAGLE TECHNOLOGY, INC.
+				6800 ORANGETHORPE AVE.UNIT
+				BUENA PARK  CA  90620
+				US
+
+00-A0-19   (hex)		NEBULA CONSULTANTS, INC.
+00A019     (base 16)		NEBULA CONSULTANTS, INC.
+				1449 DUNCAN DRIVE
+				DELTA, BC V4L 1R5    
+				CA
+
+00-A0-ED   (hex)		Brooks Automation, Inc.
+00A0ED     (base 16)		Brooks Automation, Inc.
+				15 Elizabeth Drive
+				Chelmsford  MA  01824
+				US
+
+00-60-CA   (hex)		HARMONIC SYSTEMS INCORPORATED
+0060CA     (base 16)		HARMONIC SYSTEMS INCORPORATED
+				199 1ST STREET - STE #302
+				LOS ALTOS  CA  94022
+				US
+
+00-60-24   (hex)		GRADIENT TECHNOLOGIES, INC.
+006024     (base 16)		GRADIENT TECHNOLOGIES, INC.
+				2 MOUNT ROYAL AVENUE
+				MARLBORO  MA  01752
+				US
+
+00-60-AF   (hex)		PACIFIC MICRO DATA, INC.
+0060AF     (base 16)		PACIFIC MICRO DATA, INC.
+				16751 MILLIKAN AVENUE
+				IRVINE  CA  92714
+				US
+
+00-60-38   (hex)		Nortel Networks
+006038     (base 16)		Nortel Networks
+				Global Operations Engineering
+				Brampton  ON  l6T 5P6 Cana
+				CA
+
+00-60-4F   (hex)		Tattile SRL 
+00604F     (base 16)		Tattile SRL 
+				552-51 AJIGAURA
+				IBARAKI, 311-12    
+				JP
+
+00-A0-D0   (hex)		TEN X TECHNOLOGY, INC.
+00A0D0     (base 16)		TEN X TECHNOLOGY, INC.
+				13091 POND SPRINGS ROAD, Suite B-200
+				AUSTIN  TX  78729
+				US
+
+00-A0-BC   (hex)		VIASAT, INCORPORATED
+00A0BC     (base 16)		VIASAT, INCORPORATED
+				6155 El Camino Real
+				Carlsbad  Ca  92009
+				US
+
+00-A0-5B   (hex)		MARQUIP, INC.
+00A05B     (base 16)		MARQUIP, INC.
+				1245 E. WASHINGTON AVE.
+				MADISON  WI  53703
+				US
+
+00-A0-8C   (hex)		MultiMedia LANs, Inc.
+00A08C     (base 16)		MultiMedia LANs, Inc.
+				5600 EXECUTIVE CENTER DRIVE
+				CHARLOTTE  NC  28212
+				US
+
+00-A0-58   (hex)		GLORY, LTD.
+00A058     (base 16)		GLORY, LTD.
+				1-3-1 SHIMOTENO, HIMEJI
+				HYOGO PREF. 670    
+				JP
+
+00-A0-77   (hex)		FUJITSU NEXION, INC.
+00A077     (base 16)		FUJITSU NEXION, INC.
+				289 GREAT ROAD
+				ACTON  MA  01720-4739
+				US
+
+00-A0-A0   (hex)		COMPACT DATA, LTD.
+00A0A0     (base 16)		COMPACT DATA, LTD.
+				58 DITTON WALK
+				CAMBRIDGE CB5 8QE    
+				GB
+
+00-A0-38   (hex)		EMAIL ELECTRONICS
+00A038     (base 16)		EMAIL ELECTRONICS
+				P.O. BOX 154
+				MOOROOLBARK, 3138    
+				AU
+
+00-A0-65   (hex)		Symantec Corporation
+00A065     (base 16)		Symantec Corporation
+				20330 Stevens Creek Blvd.
+				Cupertino  CA  95014
+				US
+
+00-A0-A3   (hex)		RELIABLE POWER METERS
+00A0A3     (base 16)		RELIABLE POWER METERS
+				400 BLOSSOM HILL ROAD
+				LOS GATOS  CA  95032-4511
+				US
+
+00-A0-1B   (hex)		PREMISYS COMMUNICATIONS, INC.
+00A01B     (base 16)		PREMISYS COMMUNICATIONS, INC.
+				48664 MILMONT DRIVE
+				FREMONT  CA  94538
+				US
+
+00-A0-55   (hex)		Data Device Corporation
+00A055     (base 16)		Data Device Corporation
+				105 Wilbur Place
+				Bohemia  NY  11716
+				US
+
+00-A0-74   (hex)		PERCEPTION TECHNOLOGY
+00A074     (base 16)		PERCEPTION TECHNOLOGY
+				40 SHAWMUT ROAD
+				CANTON  MA  02021-1409
+				US
+
+00-A0-7F   (hex)		GSM-SYNTEL, LTD.
+00A07F     (base 16)		GSM-SYNTEL, LTD.
+				VICTORIA WORKS, QUEENS MILL RD
+				HD1  3PG  ENGLAND
+				GB
+
+00-A0-29   (hex)		COULTER CORPORATION
+00A029     (base 16)		COULTER CORPORATION
+				11800 S.W. 147TH AVE.
+				MIAMI  FL  33196
+				US
+
+00-A0-87   (hex)		Microsemi Corporation
+00A087     (base 16)		Microsemi Corporation
+				400 March Road
+				Ontario    K2K 3H4
+				CA
+
+00-A0-43   (hex)		AMERICAN TECHNOLOGY LABS, INC.
+00A043     (base 16)		AMERICAN TECHNOLOGY LABS, INC.
+				115 WEST 3RD STREET
+				STEVENSVILLE  MT  59870
+				US
+
+00-A0-42   (hex)		SPUR PRODUCTS CORP.
+00A042     (base 16)		SPUR PRODUCTS CORP.
+				9288 W. EMERALD STREET
+				BOISE  ID  83704
+				US
+
+00-A0-C1   (hex)		ORTIVUS MEDICAL AB
+00A0C1     (base 16)		ORTIVUS MEDICAL AB
+				BOX 513
+				    
+				SE
+
+00-A0-4F   (hex)		AMERITEC CORP.
+00A04F     (base 16)		AMERITEC CORP.
+				760 ARROW GRAND CIRCLE
+				COVINA  CA  91722
+				US
+
+00-A0-CF   (hex)		SOTAS, INC.
+00A0CF     (base 16)		SOTAS, INC.
+				2 RESEARCH PLACE, STE.
+				ROCKVILLE  MD  20850
+				US
+
+00-A0-72   (hex)		OVATION SYSTEMS LTD.
+00A072     (base 16)		OVATION SYSTEMS LTD.
+				GREAT HASELEY TRAD. EST.
+				  ENGLAND  
+				GB
+
+00-A0-82   (hex)		NKT ELEKTRONIK A/S
+00A082     (base 16)		NKT ELEKTRONIK A/S
+				NKT ALLE 85
+				    
+				DK
+
+00-A0-F0   (hex)		TORONTO MICROELECTRONICS INC.
+00A0F0     (base 16)		TORONTO MICROELECTRONICS INC.
+				5149 BRADCO BOULEVARD
+				    L4W 2A6
+				CA
+
+00-A0-D7   (hex)		KASTEN CHASE APPLIED RESEARCH
+00A0D7     (base 16)		KASTEN CHASE APPLIED RESEARCH
+				5100 ORBITOR DRIVE
+				    L4W 4Z4
+				CA
+
+00-A0-F1   (hex)		MTI
+00A0F1     (base 16)		MTI
+				4905 E. LA PALMA AVENUE
+				ANAHEIM  CA  92807
+				US
+
+00-A0-B3   (hex)		ZYKRONIX
+00A0B3     (base 16)		ZYKRONIX
+				7248 SOUTH TUCSON WAY
+				ENGLEWOOD  CO  80112
+				US
+
+00-A0-FF   (hex)		TELLABS OPERATIONS, INC.
+00A0FF     (base 16)		TELLABS OPERATIONS, INC.
+				1000 REMINGTON BLVD.
+				    60440
+				US
+
+00-A0-E5   (hex)		NHC COMMUNICATIONS
+00A0E5     (base 16)		NHC COMMUNICATIONS
+				5450 COTE DE LIESSE
+				MONTREAL,  QUEBEC  H4P 1A5
+				CA
+
+00-A0-36   (hex)		APPLIED NETWORK TECHNOLOGY
+00A036     (base 16)		APPLIED NETWORK TECHNOLOGY
+				319 LITTLETON ROAD--STE #101
+				WESTFORD  MA  01886-4133
+				US
+
+00-A0-D2   (hex)		ALLIED TELESIS INTERNATIONAL CORPORATION
+00A0D2     (base 16)		ALLIED TELESIS INTERNATIONAL CORPORATION
+				950 KIFER ROAD
+				SUNNYVALE  CA  94086
+				US
+
+00-A0-9B   (hex)		QPSX COMMUNICATIONS, LTD.
+00A09B     (base 16)		QPSX COMMUNICATIONS, LTD.
+				33 RICHARDSON STREET
+				Western    00000
+				AU
+
+00-A0-00   (hex)		CENTILLION NETWORKS, INC.
+00A000     (base 16)		CENTILLION NETWORKS, INC.
+				359 RAVENDALE DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-A0-8A   (hex)		BROOKTROUT TECHNOLOGY, INC.
+00A08A     (base 16)		BROOKTROUT TECHNOLOGY, INC.
+				144 GOULD STREET- SUITE #200
+				NEEDHAM  MA  02194
+				US
+
+00-A0-7B   (hex)		DAWN COMPUTER INCORPORATION
+00A07B     (base 16)		DAWN COMPUTER INCORPORATION
+				6 KEXUEYUAN SOUTH ROAD
+				    
+				CN
+
+00-A0-5C   (hex)		INVENTORY CONVERSION, INC./
+00A05C     (base 16)		INVENTORY CONVERSION, INC./
+				NEKOTECH DIVISION
+				HAMPTON  NH  03842
+				US
+
+00-20-0F   (hex)		EBRAINS Inc
+00200F     (base 16)		EBRAINS Inc
+				Tachibana Bldg
+				Taito-ku  Tokyo  110-0003
+				JP
+
+00-A0-D3   (hex)		INSTEM COMPUTER SYSTEMS, LTD.
+00A0D3     (base 16)		INSTEM COMPUTER SYSTEMS, LTD.
+				WALTON INDUSTRIAL ESTATE
+				    
+				GB
+
+00-A0-B4   (hex)		TEXAS MICROSYSTEMS, INC.
+00A0B4     (base 16)		TEXAS MICROSYSTEMS, INC.
+				5959 CORPORATE DRIVE
+				HOUSTON  TX  77036
+				US
+
+00-A0-60   (hex)		ACER PERIPHERALS, INC.
+00A060     (base 16)		ACER PERIPHERALS, INC.
+				9F, 135 CHIAN KUO N. RD. SEC 2
+				    
+				TW
+
+00-A0-83   (hex)		ASIMMPHONY TURKEY
+00A083     (base 16)		ASIMMPHONY TURKEY
+				ELECTRONICS, LTD.
+				    V7C 4N1
+				CA
+
+00-A0-AA   (hex)		SPACELABS MEDICAL
+00A0AA     (base 16)		SPACELABS MEDICAL
+				5150 220 Ave SE
+				Issaquah  WA  98027
+				US
+
+00-A0-3B   (hex)		TOSHIN ELECTRIC CO., LTD.
+00A03B     (base 16)		TOSHIN ELECTRIC CO., LTD.
+				3FL. RIVER-STONE 3RD. BLG.234
+				  213  
+				JP
+
+00-A0-F3   (hex)		STAUBLI
+00A0F3     (base 16)		STAUBLI
+				183 RUE DES USINES
+				    
+				FR
+
+00-20-DF   (hex)		KYOSAN ELECTRIC MFG. CO., LTD.
+0020DF     (base 16)		KYOSAN ELECTRIC MFG. CO., LTD.
+				2-29, HEIAN-CHO, TSURUMI-KU
+				    
+				JP
+
+00-20-C7   (hex)		AKAI Professional M.I. Corp.
+0020C7     (base 16)		AKAI Professional M.I. Corp.
+				1-3, Hiranuma 1-Chome,
+				  220-0023  
+				JP
+
+00-A0-04   (hex)		NETPOWER, INC.
+00A004     (base 16)		NETPOWER, INC.
+				545 OAKMEAD PARKWAY
+				SUNNYVALE  CA  94086
+				US
+
+00-20-29   (hex)		TELEPROCESSING PRODUCTS, INC.
+002029     (base 16)		TELEPROCESSING PRODUCTS, INC.
+				4565 E. INDUSTRIAL STREET
+				SIMI VALLEY  CA  93063
+				US
+
+00-20-69   (hex)		ISDN SYSTEMS CORPORATION
+002069     (base 16)		ISDN SYSTEMS CORPORATION
+				8320 OLD COURTHOUSE RD.
+				VIENNA  VA  22182
+				US
+
+00-20-8B   (hex)		LAPIS TECHNOLOGIES, INC.
+00208B     (base 16)		LAPIS TECHNOLOGIES, INC.
+				1100 MARINA VILLAGE PKWY
+				ALAMEDA  CA  94501
+				US
+
+00-20-2B   (hex)		ADVANCED TELECOMMUNICATIONS MODULES, LTD.
+00202B     (base 16)		ADVANCED TELECOMMUNICATIONS MODULES, LTD.
+				
+				Cambridge CB3 OBL    
+				GB
+
+00-20-6B   (hex)		KONICA MINOLTA HOLDINGS, INC.
+00206B     (base 16)		KONICA MINOLTA HOLDINGS, INC.
+				1-6-1, Marunouchi,
+				Tokyo    100-0005
+				JP
+
+00-20-04   (hex)		YAMATAKE-HONEYWELL CO., LTD.
+002004     (base 16)		YAMATAKE-HONEYWELL CO., LTD.
+				54 SUZUKAWA, ISEHARA
+				KANAGAWA 259-11    
+				JP
+
+00-20-15   (hex)		ACTIS COMPUTER SA
+002015     (base 16)		ACTIS COMPUTER SA
+				16 CHEMIN DES AULX
+				    
+				CH
+
+00-20-99   (hex)		BON ELECTRIC CO., LTD.
+002099     (base 16)		BON ELECTRIC CO., LTD.
+				4-4 28, MIZUDO-CHO
+				HYOGO  HYOGO  
+				JP
+
+00-20-F9   (hex)		PARALINK NETWORKS, INC.
+0020F9     (base 16)		PARALINK NETWORKS, INC.
+				4F, NO. 27, SEC.3, PATEH RD.
+				TAIPEI    
+				TW
+
+00-20-92   (hex)		CHESS ENGINEERING B.V.
+002092     (base 16)		CHESS ENGINEERING B.V.
+				NIEUWE GRACHT 74
+				    
+				NL
+
+00-20-43   (hex)		NEURON COMPANY LIMITED
+002043     (base 16)		NEURON COMPANY LIMITED
+				15 KWAI YI ROAD,  BLOCK 2,
+				KWAI CHUNG,   N.T.    
+				HK
+
+00-20-71   (hex)		IBR GMBH
+002071     (base 16)		IBR GMBH
+				KOHLERSTR. 45
+				D-46286 DORSTEN    
+				DE
+
+00-20-7C   (hex)		AUTEC GMBH
+00207C     (base 16)		AUTEC GMBH
+				BAHNHOFSTR. 57
+				55234 FRAMERSHEIM    
+				DE
+
+00-20-57   (hex)		TITZE DATENTECHNIK GmbH
+002057     (base 16)		TITZE DATENTECHNIK GmbH
+				DIESELSTRASSE 10
+				DS-71272 RENNINGEN-2    
+				DE
+
+00-20-E5   (hex)		APEX DATA, INC.
+0020E5     (base 16)		APEX DATA, INC.
+				6624 OWENS DRIVE
+				PLEASANTON  CA  94588
+				US
+
+00-20-87   (hex)		MEMOTEC, INC.
+002087     (base 16)		MEMOTEC, INC.
+				7755 Henri-Bourassa
+				MONTREAL, QUEBEC     H4S 1P7
+				CA
+
+00-20-BC   (hex)		Long Reach Networks Pty Ltd
+0020BC     (base 16)		Long Reach Networks Pty Ltd
+				Unit 3, 118-122 Bowden St
+				MEADOWBANK NSW 2114    
+				AU
+
+00-C0-C0   (hex)		SHORE MICROSYSTEMS, INC.
+00C0C0     (base 16)		SHORE MICROSYSTEMS, INC.
+				23 POCAHONTAS AVENUE
+				OCEANPORT  NJ  07757
+				US
+
+00-C0-0C   (hex)		RELIA TECHNOLGIES
+00C00C     (base 16)		RELIA TECHNOLGIES
+				1F., NO. 24, INDUSTRY E. 9TH
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-C0-73   (hex)		XEDIA CORPORATION
+00C073     (base 16)		XEDIA CORPORATION
+				301 BALLARDVALE STREET
+				WILMINGTON  MA  01887
+				US
+
+00-C0-D4   (hex)		AXON NETWORKS, INC.
+00C0D4     (base 16)		AXON NETWORKS, INC.
+				104 SPRUCE STREET
+				WATERTOWN  MA  02172
+				US
+
+00-C0-CD   (hex)		COMELTA, S.A.
+00C0CD     (base 16)		COMELTA, S.A.
+				AVDA. PARC TECNOLOGIC, 4
+				    
+				ES
+
+00-20-ED   (hex)		GIGA-BYTE TECHNOLOGY CO., LTD.
+0020ED     (base 16)		GIGA-BYTE TECHNOLOGY CO., LTD.
+				365 CLOVERLEAF
+				BALDWIN PARK  CA  91706
+				US
+
+00-20-85   (hex)		Eaton Corporation
+002085     (base 16)		Eaton Corporation
+				8380 Capital Blvd.
+				RALEIGH  NC  27616
+				US
+
+00-20-CD   (hex)		HYBRID NETWORKS, INC.
+0020CD     (base 16)		HYBRID NETWORKS, INC.
+				10201 BUBB ROAD
+				CUPERTINO  CA  95014-4167
+				US
+
+00-20-2E   (hex)		DAYSTAR DIGITAL
+00202E     (base 16)		DAYSTAR DIGITAL
+				5556 ATLANTA HIGHWAY
+				FLOWERY BRANCH  GA  30542
+				US
+
+00-20-B3   (hex)		Tattile SRL 
+0020B3     (base 16)		Tattile SRL 
+				3 APOLLO PLACE
+				    
+				AU
+
+00-20-EE   (hex)		GTECH CORPORATION
+0020EE     (base 16)		GTECH CORPORATION
+				55 TECHNOLOGY WAY
+				WEST GREENWICH  RI  02817
+				US
+
+00-20-4C   (hex)		MITRON COMPUTER PTE LTD.
+00204C     (base 16)		MITRON COMPUTER PTE LTD.
+				1020 HOUGANG AVENUE 1 #03-3504
+				  SINGAPORE  1953
+				SG
+
+00-20-17   (hex)		ORBOTECH
+002017     (base 16)		ORBOTECH
+				INDUSTRIAL ZONE
+				    
+				IL
+
+00-20-93   (hex)		LANDINGS TECHNOLOGY CORP.
+002093     (base 16)		LANDINGS TECHNOLOGY CORP.
+				163 WATER STREET
+				EXETER  NH  03833
+				US
+
+00-20-63   (hex)		WIPRO INFOTECH LTD.
+002063     (base 16)		WIPRO INFOTECH LTD.
+				UNITS 47-48, SDF BLOCK VII
+				    
+				
+
+00-20-16   (hex)		SHOWA ELECTRIC WIRE & CABLE CO
+002016     (base 16)		SHOWA ELECTRIC WIRE & CABLE CO
+				NO. 20-25, SEISHIN 8-CHOME
+				  229  
+				JP
+
+00-20-4D   (hex)		INOVIS GMBH
+00204D     (base 16)		INOVIS GMBH
+				HANNS-BRAUN STRASSE 50
+				    
+				DE
+
+00-20-5F   (hex)		GAMMADATA COMPUTER GMBH
+00205F     (base 16)		GAMMADATA COMPUTER GMBH
+				GUTENBERGSTR. 13
+				    
+				DE
+
+00-20-1F   (hex)		BEST POWER TECHNOLOGY, INC.
+00201F     (base 16)		BEST POWER TECHNOLOGY, INC.
+				P.O. BOX 280
+				NECEDAH  WI  54646
+				US
+
+00-20-B6   (hex)		AGILE NETWORKS, INC.
+0020B6     (base 16)		AGILE NETWORKS, INC.
+				200 BAKER AVENUE
+				CONCORD  MA  01742
+				US
+
+00-20-D1   (hex)		MICROCOMPUTER SYSTEMS (M) SDN.
+0020D1     (base 16)		MICROCOMPUTER SYSTEMS (M) SDN.
+				23-25, JALAN JEJAKA TUJUH
+				    
+				MY
+
+00-20-CE   (hex)		LOGICAL DESIGN GROUP, INC.
+0020CE     (base 16)		LOGICAL DESIGN GROUP, INC.
+				6301 CHAPEL HILL ROAD
+				RALEIGH  NC  27607
+				US
+
+00-20-14   (hex)		GLOBAL VIEW CO., LTD.
+002014     (base 16)		GLOBAL VIEW CO., LTD.
+				4F, NO. 23, LANE 306
+				  TAIWAN  R.O.C.
+				TW
+
+00-20-C2   (hex)		TEXAS MEMORY SYSTEMS, INC.
+0020C2     (base 16)		TEXAS MEMORY SYSTEMS, INC.
+				11200 WESTHEIMER RD-STE#1000
+				HOUSTON  TX  77042
+				US
+
+00-C0-F3   (hex)		NETWORK COMMUNICATIONS CORP.
+00C0F3     (base 16)		NETWORK COMMUNICATIONS CORP.
+				5501 GREEN VALLEY DRIVE
+				BLOOMINGTON  MN  55437-1085
+				US
+
+00-20-56   (hex)		NEOPRODUCTS
+002056     (base 16)		NEOPRODUCTS
+				25 CHAPMAN STREET
+				    
+				AU
+
+00-20-42   (hex)		DATAMETRICS CORP.
+002042     (base 16)		DATAMETRICS CORP.
+				8966 COMANCHE AVE.
+				CHATSWORTH  CA  91311
+				US
+
+00-20-78   (hex)		RUNTOP, INC.
+002078     (base 16)		RUNTOP, INC.
+				5/F, NO. 10, ALLEY 8, LANE 45
+				  TAIWAN  R.O.C.
+				TW
+
+00-20-06   (hex)		GARRETT COMMUNICATIONS, INC.
+002006     (base 16)		GARRETT COMMUNICATIONS, INC.
+				48531 WARMSPRINGS BLVD.
+				FREMONT  CA  94539
+				US
+
+00-20-24   (hex)		PACIFIC COMMUNICATION SCIENCES
+002024     (base 16)		PACIFIC COMMUNICATION SCIENCES
+				9645 SCRANTON ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-20-5D   (hex)		NANOMATIC OY
+00205D     (base 16)		NANOMATIC OY
+				PUISTOLAN RAITTI 4
+				    
+				FI
+
+00-C0-05   (hex)		LIVINGSTON ENTERPRISES, INC.
+00C005     (base 16)		LIVINGSTON ENTERPRISES, INC.
+				6920 KOLL CENTER PARKWAY #220
+				PLEASANTON  CA  94566
+				US
+
+00-C0-77   (hex)		DAEWOO TELECOM LTD.
+00C077     (base 16)		DAEWOO TELECOM LTD.
+				PRODUCTS DESIGN DEPT. 1
+				SEOUL  SEOUL  KOREA
+				KR
+
+00-C0-C8   (hex)		MICRO BYTE PTY. LTD.
+00C0C8     (base 16)		MICRO BYTE PTY. LTD.
+				197 SHERBOURNE RD.
+				  AUSTRALIA  3094
+				AU
+
+00-C0-69   (hex)		Axxcelera Broadband Wireless
+00C069     (base 16)		Axxcelera Broadband Wireless
+				111 Castilian Drive
+				Santa Barbara  CA  93117
+				US
+
+00-C0-67   (hex)		UNITED BARCODE INDUSTRIES
+00C067     (base 16)		UNITED BARCODE INDUSTRIES
+				12240 INDIAN CREEK COURT
+				BELTSVILLE  MD  20705
+				US
+
+00-C0-A3   (hex)		DUAL ENTERPRISES CORPORATION
+00C0A3     (base 16)		DUAL ENTERPRISES CORPORATION
+				9TH FLOOR 48 NAN-KANG ROAD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-C0-18   (hex)		LANART CORPORATION
+00C018     (base 16)		LANART CORPORATION
+				145 ROSEMARY STREET
+				NEEDHAM  MA  02194
+				US
+
+00-9D-8E   (hex)		CARDIAC RECORDERS, INC.
+009D8E     (base 16)		CARDIAC RECORDERS, INC.
+				34 SCARBORO ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-BB-01   (hex)		OCTOTHORPE CORP.
+00BB01     (base 16)		OCTOTHORPE CORP.
+				285 WEST GREEN STREET
+				PASADENA  CA  91105
+				US
+
+00-C0-33   (hex)		TELEBIT COMMUNICATIONS APS
+00C033     (base 16)		TELEBIT COMMUNICATIONS APS
+				SKANDERBORGVEJ 234
+				    
+				DK
+
+00-C0-90   (hex)		PRAIM S.R.L.
+00C090     (base 16)		PRAIM S.R.L.
+				VIA MACCANI, 169
+				    ITALY
+				
+
+00-C0-DE   (hex)		ZCOMM, INC.
+00C0DE     (base 16)		ZCOMM, INC.
+				1050 C EAST DUANE AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-C0-13   (hex)		NETRIX
+00C013     (base 16)		NETRIX
+				13595 DULLES TECHNOLOGY DRIVE
+				HERNDON  VA  22071
+				US
+
+00-C0-6B   (hex)		OSI PLUS CORPORATION
+00C06B     (base 16)		OSI PLUS CORPORATION
+				2-1-23 NAKAMEGURO
+				    
+				JP
+
+00-C0-4C   (hex)		DEPARTMENT OF FOREIGN AFFAIRS
+00C04C     (base 16)		DEPARTMENT OF FOREIGN AFFAIRS
+				& TRADE
+				    
+				AU
+
+00-C0-7C   (hex)		HIGHTECH INFORMATION
+00C07C     (base 16)		HIGHTECH INFORMATION
+				SYSTEM LTD.
+				  HONG  KONG
+				HK
+
+00-C0-B8   (hex)		FRASER'S HILL LTD.
+00C0B8     (base 16)		FRASER'S HILL LTD.
+				27502 W. GILL ROAD
+				MORRISTOWN  AZ  85342
+				US
+
+00-C0-62   (hex)		IMPULSE TECHNOLOGY
+00C062     (base 16)		IMPULSE TECHNOLOGY
+				210 DAHLONEGA ST.#204
+				CUMMING  GA  30130
+				US
+
+00-C0-EC   (hex)		DAUPHIN TECHNOLOGY
+00C0EC     (base 16)		DAUPHIN TECHNOLOGY
+				450 EISENHOWER LANE NORTH
+				LOMBARD  IL  60148
+				US
+
+00-C0-86   (hex)		THE LYNK CORPORATION
+00C086     (base 16)		THE LYNK CORPORATION
+				101 QUEENS DRIVE
+				KING OF PRUSSIA  PA  19406
+				US
+
+00-C0-58   (hex)		DATAEXPERT CORP.
+00C058     (base 16)		DATAEXPERT CORP.
+				1156 SONOPRA COURTN-KANG RD.
+				SUNNYVALE  CA  94086
+				US
+
+00-C0-D0   (hex)		RATOC SYSTEM INC.
+00C0D0     (base 16)		RATOC SYSTEM INC.
+				ASAHI NAMBA BLDG.
+				  556  
+				JP
+
+00-C0-BF   (hex)		TECHNOLOGY CONCEPTS, LTD.
+00C0BF     (base 16)		TECHNOLOGY CONCEPTS, LTD.
+				GRANGE ESTATE
+				  UNITED  KINGDOM
+				GB
+
+00-C0-BA   (hex)		NETVANTAGE
+00C0BA     (base 16)		NETVANTAGE
+				201 CONTINENTAL BLVD.-STE.#201
+				EL SECUNDO  CA  90245
+				US
+
+00-C0-5E   (hex)		VARI-LITE, INC.
+00C05E     (base 16)		VARI-LITE, INC.
+				201 REGAL ROW
+				DALLAS  TX  75247
+				US
+
+00-C0-D5   (hex)		Werbeagentur Jürgen Siebert
+00C0D5     (base 16)		Werbeagentur Jürgen Siebert
+				Im Klostergarten 8
+				D-50321 Brühl    
+				DE
+
+00-C0-63   (hex)		MORNING STAR TECHNOLOGIES, INC
+00C063     (base 16)		MORNING STAR TECHNOLOGIES, INC
+				1760 ZOLLINGER ROAD
+				COLUMBUS  OH  43221
+				US
+
+00-C0-21   (hex)		NETEXPRESS
+00C021     (base 16)		NETEXPRESS
+				989 EAST HILLSDALE BLVD.
+				FOSTER CITY  CA  94404-2113
+				US
+
+00-C0-DB   (hex)		IPC CORPORATION (PTE) LTD.
+00C0DB     (base 16)		IPC CORPORATION (PTE) LTD.
+				122 EUNOS AVE., 7 #05-10
+				  SINGAPORE  1440
+				SG
+
+00-C0-9B   (hex)		RELIANCE COMM/TEC, R-TEC
+00C09B     (base 16)		RELIANCE COMM/TEC, R-TEC
+				SYSTEMS INC.
+				BEDFORD  TX  76021
+				US
+
+00-C0-6A   (hex)		ZAHNER-ELEKTRIK GMBH & CO. KG
+00C06A     (base 16)		ZAHNER-ELEKTRIK GMBH & CO. KG
+				P.O. BOX 1846
+				    
+				DE
+
+00-C0-E3   (hex)		OSITECH COMMUNICATIONS, INC.
+00C0E3     (base 16)		OSITECH COMMUNICATIONS, INC.
+				679 SOUTHGATE DRIVE
+				CANADA  N1G  4S2
+				CA
+
+00-C0-FE   (hex)		APTEC COMPUTER SYSTEMS, INC.
+00C0FE     (base 16)		APTEC COMPUTER SYSTEMS, INC.
+				P.O. BOX 6750
+				PORTLAND  OR  97228-6750
+				US
+
+00-C0-16   (hex)		ELECTRONIC THEATRE CONTROLS
+00C016     (base 16)		ELECTRONIC THEATRE CONTROLS
+				3030 LAURA LANE
+				MIDDLETON  WI  53562
+				US
+
+00-C0-BC   (hex)		TELECOM AUSTRALIA/CSSC
+00C0BC     (base 16)		TELECOM AUSTRALIA/CSSC
+				LOCKED BAG 8812
+				    
+				AU
+
+00-C0-C1   (hex)		QUAD/GRAPHICS, INC.
+00C0C1     (base 16)		QUAD/GRAPHICS, INC.
+				N63 W23075 HWY 74
+				SUSSEX  WI  53089
+				US
+
+00-C0-89   (hex)		TELINDUS DISTRIBUTION
+00C089     (base 16)		TELINDUS DISTRIBUTION
+				GELDENAAKSEBAAN 335
+				    
+				BE
+
+00-C0-B0   (hex)		GCC TECHNOLOGIES,INC.
+00C0B0     (base 16)		GCC TECHNOLOGIES,INC.
+				580 WINTER STREET
+				WALTHAM  MA  02154
+				US
+
+00-C0-0A   (hex)		MICRO CRAFT
+00C00A     (base 16)		MICRO CRAFT
+				2-4-3 NISHIFURUMATSU
+				    
+				JP
+
+00-C0-74   (hex)		TOYODA AUTOMATIC LOOM
+00C074     (base 16)		TOYODA AUTOMATIC LOOM
+				WORKS, LTD.
+				  448  
+				JP
+
+00-40-4E   (hex)		FLUENT, INC.
+00404E     (base 16)		FLUENT, INC.
+				594 WORCESTER ROAD-STE.#308
+				NATICK  MA  01760
+				US
+
+00-40-8D   (hex)		THE GOODYEAR TIRE & RUBBER CO.
+00408D     (base 16)		THE GOODYEAR TIRE & RUBBER CO.
+				1144 EAST MARKET STREET
+				AKRON  OH  44316
+				US
+
+00-40-1B   (hex)		PRINTER SYSTEMS CORP.
+00401B     (base 16)		PRINTER SYSTEMS CORP.
+				207 PERRY PARKWAY
+				GAITHERSBURG  MD  20877-2142
+				US
+
+00-40-A3   (hex)		MICROUNITY SYSTEMS ENGINEERING
+0040A3     (base 16)		MICROUNITY SYSTEMS ENGINEERING
+				255 CASPIAN DRIVE
+				SUNNYVALE  CA  94089-1015
+				US
+
+00-40-B3   (hex)		ParTech Inc.
+0040B3     (base 16)		ParTech Inc.
+				8383 Seneca Turnpike
+				NEW HARTFORD  NY  13413
+				US
+
+00-40-1D   (hex)		INVISIBLE SOFTWARE, INC.
+00401D     (base 16)		INVISIBLE SOFTWARE, INC.
+				1142 CHESS DRIVE
+				FOSTER CITY  CA  94404
+				US
+
+00-C0-CA   (hex)		ALFA, INC.
+00C0CA     (base 16)		ALFA, INC.
+				11-1, INDUSTRY EAST ROAD IV
+				    TAIWAN
+				TW
+
+00-C0-6C   (hex)		SVEC COMPUTER CORP.
+00C06C     (base 16)		SVEC COMPUTER CORP.
+				3F, 531-1 CHUNG CHENG RD.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-40-FF   (hex)		TELEBIT CORPORATION
+0040FF     (base 16)		TELEBIT CORPORATION
+				1315 CHESAPEAKE TERRACE
+				SUNNYVALE  CA  94089-1100
+				US
+
+00-40-1F   (hex)		COLORGRAPH LTD
+00401F     (base 16)		COLORGRAPH LTD
+				UNIT 2, MARS HOUSE
+				RG7 4QW -  UNITED  KINGDOM
+				GB
+
+00-40-AF   (hex)		DIGITAL PRODUCTS, INC.
+0040AF     (base 16)		DIGITAL PRODUCTS, INC.
+				411 WAVERLY OAKS ROAD
+				WALTHAM  MA  02154
+				US
+
+00-40-F7   (hex)		Polaroid Corporation
+0040F7     (base 16)		Polaroid Corporation
+				300 Baker Avenue
+				Concord  MA  01742
+				US
+
+00-40-37   (hex)		SEA-ILAN, INC.
+004037     (base 16)		SEA-ILAN, INC.
+				14602 NORTH US HIGHWAY #31
+				CARMEL  IN  46032
+				US
+
+00-C0-26   (hex)		LANS TECHNOLOGY CO., LTD.
+00C026     (base 16)		LANS TECHNOLOGY CO., LTD.
+				153 MINTSU RD. 2F, TAOYUAN,
+				TAIWAN  R.  O. C.
+				TW
+
+00-40-7E   (hex)		EVERGREEN SYSTEMS, INC.
+00407E     (base 16)		EVERGREEN SYSTEMS, INC.
+				120 LANDING COURT-SUITE
+				NOVATO  CA  94945
+				US
+
+00-40-F9   (hex)		COMBINET
+0040F9     (base 16)		COMBINET
+				333 W. EL CAMINO REAL-STE#310
+				SUNNYVALE  CA  94087
+				US
+
+00-C0-6F   (hex)		KOMATSU LTD.
+00C06F     (base 16)		KOMATSU LTD.
+				2597 SHINOMIYA HIRATSUKA-SHI
+				    
+				JP
+
+00-C0-A7   (hex)		SEEL LTD.
+00C0A7     (base 16)		SEEL LTD.
+				3 YOUNG SQUARE
+				    SCOTLAND
+				GB
+
+00-C0-4A   (hex)		GROUP 2000 AG
+00C04A     (base 16)		GROUP 2000 AG
+				P.O. BOX 331
+				    
+				CH
+
+00-40-54   (hex)		CONNECTION MACHINES SERVICES
+004054     (base 16)		CONNECTION MACHINES SERVICES
+				12 HENSHAW STREET
+				WOBURN  MA  01801-466664
+				US
+
+00-40-04   (hex)		ICM CO. LTD.
+004004     (base 16)		ICM CO. LTD.
+				4-2-9 NIHONBASHI NANIWA-KU
+				    
+				JP
+
+00-40-58   (hex)		KRONOS, INC.
+004058     (base 16)		KRONOS, INC.
+				400 FIFTH AVENUE
+				WALTHAM  MA  02154
+				US
+
+00-40-18   (hex)		ADOBE SYSTEMS, INC.
+004018     (base 16)		ADOBE SYSTEMS, INC.
+				1585 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-40-4A   (hex)		WEST AUSTRALIAN DEPARTMENT
+00404A     (base 16)		WEST AUSTRALIAN DEPARTMENT
+				OF EMPLOYMENT (DEVET)
+				  WESTERN  
+				AU
+
+00-40-3C   (hex)		FORKS, INC.
+00403C     (base 16)		FORKS, INC.
+				1-27-4 IRIYA,
+				  110  
+				JP
+
+00-40-42   (hex)		N.A.T. GMBH
+004042     (base 16)		N.A.T. GMBH
+				GOETHESTR. 2
+				    
+				DE
+
+00-40-F2   (hex)		JANICH & KLASS COMPUTERTECHNIK
+0040F2     (base 16)		JANICH & KLASS COMPUTERTECHNIK
+				ZUM ALTEN ZOLLHAUS 20
+				    
+				DE
+
+00-40-A2   (hex)		KINGSTAR TECHNOLOGY INC.
+0040A2     (base 16)		KINGSTAR TECHNOLOGY INC.
+				1-3F, NO. 185, SEC. 3,
+				TAIPEI  TAIWAN,  R.O.C.
+				TW
+
+00-40-DC   (hex)		TRITEC ELECTRONIC GMBH
+0040DC     (base 16)		TRITEC ELECTRONIC GMBH
+				ROBERT KOCH STR. 35
+				    
+				DE
+
+00-40-60   (hex)		COMENDEC LTD
+004060     (base 16)		COMENDEC LTD
+				ENTERPRISE WAY,
+				BIRMINGHAM  BIRMINGHAM  ENGLAND
+				GB
+
+00-40-56   (hex)		MCM JAPAN LTD.
+004056     (base 16)		MCM JAPAN LTD.
+				SYUUKAEN BLD. 2-11-1
+				    
+				JP
+
+00-40-30   (hex)		GK COMPUTER
+004030     (base 16)		GK COMPUTER
+				BASLER STRASSE 103
+				    
+				DE
+
+00-40-40   (hex)		RING ACCESS, INC.
+004040     (base 16)		RING ACCESS, INC.
+				957-R INDUSTRIAL ROAD
+				SAN CARLOS  CA  94070
+				US
+
+00-80-57   (hex)		ADSOFT, LTD.
+008057     (base 16)		ADSOFT, LTD.
+				Im Baumgarten 6
+				  MOHLIN  CH-4313 
+				CH
+
+00-80-BB   (hex)		HUGHES LAN SYSTEMS
+0080BB     (base 16)		HUGHES LAN SYSTEMS
+				1225 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-40-3D   (hex)		Teradata Corporation
+00403D     (base 16)		Teradata Corporation
+				17095 Via Del Campo
+				San Diego  CA  92127
+				US
+
+00-40-D0   (hex)		MITAC INTERNATIONAL CORP.
+0040D0     (base 16)		MITAC INTERNATIONAL CORP.
+				8TH FL. 585 MING SHENG E. RD.
+				    
+				TW
+
+00-40-B6   (hex)		COMPUTERM  CORPORATION
+0040B6     (base 16)		COMPUTERM  CORPORATION
+				111 WOOD STREET
+				PITTSBURGH  PA  15222
+				US
+
+00-40-A6   (hex)		Cray, Inc.
+0040A6     (base 16)		Cray, Inc.
+				655F LONE OAK DRIVE
+				EAGAN  MN  55121
+				US
+
+00-40-3E   (hex)		RASTER OPS CORPORATION
+00403E     (base 16)		RASTER OPS CORPORATION
+				2500 WALSH AVENUE
+				SANTA CLARA  CA  95051
+				US
+
+00-40-46   (hex)		UDC RESEARCH LIMITED
+004046     (base 16)		UDC RESEARCH LIMITED
+				8A KING WAN INDUSTRIAL BLDG.
+				  HONG  KONG
+				HK
+
+00-C0-D7   (hex)		TAIWAN TRADING CENTER DBA
+00C0D7     (base 16)		TAIWAN TRADING CENTER DBA
+				TTC COMPUTER PRODUCTS
+				IRVING  TX  75038
+				US
+
+00-40-DA   (hex)		TELSPEC LTD
+0040DA     (base 16)		TELSPEC LTD
+				LANCASTER PARKER ROAD
+				    ENGLAND
+				GB
+
+00-40-C7   (hex)		RUBY TECH CORPORATION
+0040C7     (base 16)		RUBY TECH CORPORATION
+				6F-1, NO.3, LANE 250,
+				TAIPEI  TAIWAN,  R.O.C.
+				TW
+
+00-40-52   (hex)		STAR TECHNOLOGIES, INC.
+004052     (base 16)		STAR TECHNOLOGIES, INC.
+				515 SHAW ROAD
+				STERLING  VA  22075
+				US
+
+00-40-2E   (hex)		PRECISION SOFTWARE, INC.
+00402E     (base 16)		PRECISION SOFTWARE, INC.
+				600 S FEDERAL HWY STE
+				DEERFIELD BEACH  FL  33441-4193
+				US
+
+00-40-2B   (hex)		TRIGEM COMPUTER, INC.
+00402B     (base 16)		TRIGEM COMPUTER, INC.
+				KISUNG B/D 4F, 784-6
+				SEOUL  KOREA  135-080
+				KR
+
+00-40-1A   (hex)		FUJI ELECTRIC CO., LTD.
+00401A     (base 16)		FUJI ELECTRIC CO., LTD.
+				NEW YURAKUCHO BLDG
+				    
+				JP
+
+00-40-5F   (hex)		AFE COMPUTERS LTD.
+00405F     (base 16)		AFE COMPUTERS LTD.
+				62 ANCHORAGE ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-40-80   (hex)		ATHENIX CORPORATION
+004080     (base 16)		ATHENIX CORPORATION
+				675 ALMANOR AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-40-51   (hex)		Garbee and Garbee
+004051     (base 16)		Garbee and Garbee
+				4390 Darr Circle
+				Colorado Springs  CO  80908
+				US
+
+00-40-7A   (hex)		SOCIETE D'EXPLOITATION DU CNIT
+00407A     (base 16)		SOCIETE D'EXPLOITATION DU CNIT
+				2 GLACE DE LA DEFENSE 92053
+				    
+				FR
+
+00-40-31   (hex)		KOKUSAI ELECTRIC CO., LTD
+004031     (base 16)		KOKUSAI ELECTRIC CO., LTD
+				2-1 YASUUCHI
+				TOYAMA  939-23  
+				JP
+
+00-40-D3   (hex)		KIMPSION INTERNATIONAL CORP.
+0040D3     (base 16)		KIMPSION INTERNATIONAL CORP.
+				4701 PATRICK HENRY DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-40-EE   (hex)		OPTIMEM
+0040EE     (base 16)		OPTIMEM
+				297 N. BERNARDO AVENUE
+				MOUNTAIN VIEW  CA  94043-5205
+				US
+
+00-40-25   (hex)		MOLECULAR DYNAMICS
+004025     (base 16)		MOLECULAR DYNAMICS
+				880 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94086-4536
+				US
+
+00-40-67   (hex)		OMNIBYTE CORPORATION
+004067     (base 16)		OMNIBYTE CORPORATION
+				245 WEST ROOSEVELT ROAD
+				WEST CHICAGO  IL  60185
+				US
+
+00-40-C3   (hex)		FISCHER AND PORTER CO.
+0040C3     (base 16)		FISCHER AND PORTER CO.
+				125 E. COUNTY LINE ROAD
+				WARMINSTER  PA  18974
+				US
+
+00-40-EC   (hex)		MIKASA SYSTEM ENGINEERING
+0040EC     (base 16)		MIKASA SYSTEM ENGINEERING
+				CO., LTD.
+				    
+				JP
+
+00-80-2F   (hex)		NATIONAL INSTRUMENTS CORP.
+00802F     (base 16)		NATIONAL INSTRUMENTS CORP.
+				11500 North Mopac Expressway
+				AUSTIN  TX  78759-3504
+				US
+
+00-80-54   (hex)		FRONTIER TECHNOLOGIES CORP.
+008054     (base 16)		FRONTIER TECHNOLOGIES CORP.
+				10201 NO. PT. WASHINGTON ROAD
+				MEQUON  WI  53092
+				US
+
+00-80-53   (hex)		INTELLICOM, INC.
+008053     (base 16)		INTELLICOM, INC.
+				20415 NORDHOFF STREET
+				CHATSWORTH  CA  91311
+				US
+
+00-80-26   (hex)		NETWORK PRODUCTS CORPORATION
+008026     (base 16)		NETWORK PRODUCTS CORPORATION
+				1440 WEST COLORADO BLVD.
+				PASADENA  CA  91105
+				US
+
+00-80-B0   (hex)		ADVANCED INFORMATION
+0080B0     (base 16)		ADVANCED INFORMATION
+				TECHNOLOGY, INC.
+				    
+				JP
+
+00-80-FA   (hex)		RWT GMBH
+0080FA     (base 16)		RWT GMBH
+				TALANGERSTR. 5-7
+				  WEST  
+				DE
+
+00-80-FD   (hex)		EXSCEED CORPRATION
+0080FD     (base 16)		EXSCEED CORPRATION
+				1-15-12, KITAKASE, SAIWAI-KU
+				    
+				JP
+
+00-80-FE   (hex)		AZURE TECHNOLOGIES, INC.
+0080FE     (base 16)		AZURE TECHNOLOGIES, INC.
+				63 SOUTH STREET
+				HOPKINTON  MA  01748-2212
+				US
+
+00-80-3C   (hex)		TVS ELECTRONICS LTD
+00803C     (base 16)		TVS ELECTRONICS LTD
+				44, MILLER ROAD
+				    
+				IN
+
+00-80-46   (hex)		Tattile SRL 
+008046     (base 16)		Tattile SRL 
+				DEPT. OF ELECTRICAL ENGIN'ING
+				    
+				CA
+
+00-40-02   (hex)		PERLE SYSTEMS LIMITED
+004002     (base 16)		PERLE SYSTEMS LIMITED
+				60 RENFREW DRIVE
+				CANADA  L3R  0E1
+				CA
+
+00-40-49   (hex)		Roche Diagnostics International Ltd.
+004049     (base 16)		Roche Diagnostics International Ltd.
+				FORRENSTRASSE
+				ROTKREUZ  ZG  6343
+				CH
+
+00-40-29   (hex)		Compex
+004029     (base 16)		Compex
+				
+				    
+				US
+
+00-40-9E   (hex)		CONCURRENT TECHNOLOGIES  LTD.
+00409E     (base 16)		CONCURRENT TECHNOLOGIES  LTD.
+				654 THE CRESCENT
+				  UNITED  KINGDOM
+				GB
+
+00-80-AD   (hex)		CNET TECHNOLOGY, INC.
+0080AD     (base 16)		CNET TECHNOLOGY, INC.
+				2199 ZANKER ROAD
+				SAN JOSE  CA  95131
+				US
+
+00-80-0E   (hex)		ATLANTIX CORPORATION
+00800E     (base 16)		ATLANTIX CORPORATION
+				5401 NW BROKENSOUND BLVD.
+				BOCA RATON  FL  33431
+				US
+
+00-80-AB   (hex)		DUKANE NETWORK INTEGRATION
+0080AB     (base 16)		DUKANE NETWORK INTEGRATION
+				2900 DUKANE DRIVE
+				ST. CHARLES  IL  60174
+				US
+
+00-80-F1   (hex)		OPUS SYSTEMS
+0080F1     (base 16)		OPUS SYSTEMS
+				3000 CORONADO DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-80-29   (hex)		EAGLE TECHNOLOGY, INC.
+008029     (base 16)		EAGLE TECHNOLOGY, INC.
+				6800 ORANGETHORPE AVE.UNIT
+				BUENA PARK  CA  90620
+				US
+
+00-80-72   (hex)		MICROPLEX SYSTEMS LTD.
+008072     (base 16)		MICROPLEX SYSTEMS LTD.
+				301-2071 Kingsway
+				Port Coquitlam  BC  V3C6N2
+				CA
+
+00-40-01   (hex)		Zero One Technology Co. Ltd.
+004001     (base 16)		Zero One Technology Co. Ltd.
+				10 Fl., No. 8, Lane 360, Sec 1, 
+				Neihu Dist.,  Taipei City  114
+				TW
+
+00-40-71   (hex)		ATM COMPUTER GMBH
+004071     (base 16)		ATM COMPUTER GMBH
+				BUCKLESTR. 1-5,POSTFACH 101043
+				    
+				DE
+
+00-80-11   (hex)		DIGITAL SYSTEMS INT'L. INC.
+008011     (base 16)		DIGITAL SYSTEMS INT'L. INC.
+				7659 178TH PL. NE
+				REDMOND  WA  98073-0908
+				US
+
+00-80-34   (hex)		SMT GOUPIL
+008034     (base 16)		SMT GOUPIL
+				3 RUE DES ARCHIVES
+				    
+				FR
+
+00-80-E4   (hex)		NORTHWEST DIGITAL SYSTEMS, INC
+0080E4     (base 16)		NORTHWEST DIGITAL SYSTEMS, INC
+				P.O. BOX 15288
+				SEATTLE  WA  98115
+				US
+
+00-80-EC   (hex)		SUPERCOMPUTING SOLUTIONS, INC.
+0080EC     (base 16)		SUPERCOMPUTING SOLUTIONS, INC.
+				6175 NANCY RIDGE BLVD.
+				SAN DIEGO  CA  92121
+				US
+
+00-80-2C   (hex)		THE SAGE GROUP PLC
+00802C     (base 16)		THE SAGE GROUP PLC
+				SAGE HOUSE, BENTON PARK ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-80-D6   (hex)		NUVOTECH, INC.
+0080D6     (base 16)		NUVOTECH, INC.
+				2015 BRIDGEWAY, SUITE 204
+				SAUSALITO  CA  94965
+				US
+
+00-80-0A   (hex)		JAPAN COMPUTER CORP.
+00800A     (base 16)		JAPAN COMPUTER CORP.
+				L. K. BLDG. HIGASHI KANDA
+				    
+				JP
+
+00-80-4B   (hex)		EAGLE TECHNOLOGIES PTY.LTD.
+00804B     (base 16)		EAGLE TECHNOLOGIES PTY.LTD.
+				70 KEYS ROAD
+				    
+				AU
+
+00-80-C8   (hex)		D-LINK SYSTEMS, INC.
+0080C8     (base 16)		D-LINK SYSTEMS, INC.
+				53 Discover Dr.
+				Irvine  CA  92618
+				US
+
+00-80-12   (hex)		INTEGRATED MEASUREMENT SYSTEMS
+008012     (base 16)		INTEGRATED MEASUREMENT SYSTEMS
+				9525 SW GEMINI DRIVE
+				BEAVERTON  OR  97005
+				US
+
+00-80-27   (hex)		ADAPTIVE SYSTEMS, INC.
+008027     (base 16)		ADAPTIVE SYSTEMS, INC.
+				1400 N.W. COMPTON DRIVE
+				BEAVERTON  OR  97006
+				US
+
+00-80-FC   (hex)		AVATAR CORPORATION
+0080FC     (base 16)		AVATAR CORPORATION
+				65 SOUTH STREET
+				HOPKINTON  MA  01748
+				US
+
+00-80-16   (hex)		WANDEL AND GOLTERMANN
+008016     (base 16)		WANDEL AND GOLTERMANN
+				1030 SWABIA COURT
+				  NC  27709
+				US
+
+00-80-A2   (hex)		CREATIVE ELECTRONIC SYSTEMS
+0080A2     (base 16)		CREATIVE ELECTRONIC SYSTEMS
+				Avenue Eugène-Lance 38bis
+				    
+				CH
+
+00-80-CC   (hex)		MICROWAVE BYPASS SYSTEMS
+0080CC     (base 16)		MICROWAVE BYPASS SYSTEMS
+				25 BRAINTREE HILL OFFICE PARK
+				BRAINTREE  MA  02184
+				US
+
+00-80-A5   (hex)		SPEED INTERNATIONAL
+0080A5     (base 16)		SPEED INTERNATIONAL
+				1320 ARBOLITA DR.
+				LA HABRA  CA  90631
+				US
+
+00-80-79   (hex)		MICROBUS DESIGNS LTD.
+008079     (base 16)		MICROBUS DESIGNS LTD.
+				TREADAWAY HILL
+				  UNITED  KINGDOM
+				GB
+
+00-00-79   (hex)		NETWORTH INCORPORATED
+000079     (base 16)		NETWORTH INCORPORATED
+				8404 ESTERS BOULEVARD
+				IRVING  TX  75063
+				US
+
+00-00-91   (hex)		ANRITSU CORPORATION
+000091     (base 16)		ANRITSU CORPORATION
+				1800, ONNA
+				    
+				JP
+
+00-00-75   (hex)		Nortel Networks
+000075     (base 16)		Nortel Networks
+				Global Operations Engineering
+				Brampton  ON  l6T 5P6 Cana
+				CA
+
+00-00-A5   (hex)		Tattile SRL 
+0000A5     (base 16)		Tattile SRL 
+				P.O. BOX 17220
+				BOULDER  CO  80308-7220
+				US
+
+00-00-36   (hex)		ATARI CORPORATION
+000036     (base 16)		ATARI CORPORATION
+				1196 BORREGAS AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-00-F8   (hex)		DIGITAL EQUIPMENT CORPORATION
+0000F8     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+00-80-5C   (hex)		AGILIS CORPORATION
+00805C     (base 16)		AGILIS CORPORATION
+				1101 SAN ANTONIO ROAD
+				Mountain View  CA  94043-1008
+				US
+
+00-80-C5   (hex)		NOVELLCO DE MEXICO
+0080C5     (base 16)		NOVELLCO DE MEXICO
+				CONSTITUYENTES NO. 907
+				11950 MEXICO  11950 MEXICO  D.F.
+				MX
+
+00-80-78   (hex)		PRACTICAL PERIPHERALS, INC.
+008078     (base 16)		PRACTICAL PERIPHERALS, INC.
+				375 CONEJO RIDGE AVENUE
+				THOUSAND OAKS  CA  91361
+				US
+
+00-80-F6   (hex)		SYNERGY MICROSYSTEMS
+0080F6     (base 16)		SYNERGY MICROSYSTEMS
+				9605 SCRANTON ROAD-STE #700
+				SAN DIEGO  CA  92121-1773
+				US
+
+00-80-7B   (hex)		ARTEL COMMUNICATIONS CORP.
+00807B     (base 16)		ARTEL COMMUNICATIONS CORP.
+				22 KANE INDUSTRIAL DRIVE
+				HUDSON  MA  01749
+				US
+
+00-80-14   (hex)		ESPRIT SYSTEMS
+008014     (base 16)		ESPRIT SYSTEMS
+				14F, NO. 1, SEC. 4
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-80-B7   (hex)		STELLAR COMPUTER
+0080B7     (base 16)		STELLAR COMPUTER
+				95 WELLS AVENUE
+				NEWTON  MA  02159
+				
+
+00-00-ED   (hex)		APRIL
+0000ED     (base 16)		APRIL
+				60, RUE DE CARTALE
+				    
+				FR
+
+00-00-A3   (hex)		NETWORK APPLICATION TECHNOLOGY
+0000A3     (base 16)		NETWORK APPLICATION TECHNOLOGY
+				1686 DELL AVENUE
+				CAMPBELL  CA  95008
+				US
+
+00-00-39   (hex)		TOSHIBA CORPORATION
+000039     (base 16)		TOSHIBA CORPORATION
+				COMPUTER DIVISION
+				TOKYO  105  
+				JP
+
+00-00-3C   (hex)		AUSPEX SYSTEMS INC.
+00003C     (base 16)		AUSPEX SYSTEMS INC.
+				5200 GREAT AMERICA PKWY
+				SANTA CLARA  CA  95054
+				US
+
+00-00-7E   (hex)		CLUSTRIX CORPORATION
+00007E     (base 16)		CLUSTRIX CORPORATION
+				960 HAMLIN COURT
+				SUNNYVALE  CA  94089
+				US
+
+00-00-CB   (hex)		COMPU-SHACK ELECTRONIC GMBH
+0000CB     (base 16)		COMPU-SHACK ELECTRONIC GMBH
+				RINGSTR. 56 - 58, 5450 NEUWIED
+				  WEST  
+				DE
+
+00-00-13   (hex)		CAMEX
+000013     (base 16)		CAMEX
+				75 KNEELAND STREET
+				BOSTON  MA  02111
+				US
+
+00-00-95   (hex)		SONY TEKTRONIX CORP.
+000095     (base 16)		SONY TEKTRONIX CORP.
+				P.O. BOX 5209 TOKYO INT'L
+				    
+				JP
+
+00-00-57   (hex)		SCITEX CORPORATION LTD.
+000057     (base 16)		SCITEX CORPORATION LTD.
+				P.O. BOX 330
+				    
+				IL
+
+00-00-D6   (hex)		PUNCH LINE HOLDING
+0000D6     (base 16)		PUNCH LINE HOLDING
+				P.O. BOX 391708
+				  SOUTH  AFRICA
+				ZA
+
+00-00-9E   (hex)		MARLI S.A.
+00009E     (base 16)		MARLI S.A.
+				CHEMIN TAVERNEY 3
+				    
+				CH
+
+00-00-42   (hex)		METIER MANAGEMENT SYSTEMS LTD.
+000042     (base 16)		METIER MANAGEMENT SYSTEMS LTD.
+				3 FOUNDATION STREET
+				    ENGLAND
+				GB
+
+00-00-7D   (hex)		Oracle Corporation
+00007D     (base 16)		Oracle Corporation
+				17 Network Circle
+				Menlo Park  CA  95025
+				US
+
+00-00-96   (hex)		MARCONI ELECTRONICS LTD.
+000096     (base 16)		MARCONI ELECTRONICS LTD.
+				BROWNS LANE, THE AIRPORT
+				  UNITED  KINGDOM
+				GB
+
+00-00-5E   (hex)		ICANN, IANA Department
+00005E     (base 16)		ICANN, IANA Department
+				INTERNET ASS'NED NOS.AUTHORITY
+				Los Angeles  CA  90094-2536
+				US
+
+00-00-38   (hex)		CSS LABS
+000038     (base 16)		CSS LABS
+				2134 SOUTH RIPCHEY
+				SANTA ANA  CA  92705
+				US
+
+00-00-44   (hex)		CASTELLE CORPORATION
+000044     (base 16)		CASTELLE CORPORATION
+				3255-3 SCOTT BOULEVARD
+				SANTA CLARA  CA  95054
+				US
+
+00-00-CE   (hex)		MEGADATA CORP.
+0000CE     (base 16)		MEGADATA CORP.
+				35 ORVILLE DRIVE
+				BOHEMIA  NY  11716
+				US
+
+00-00-7B   (hex)		RESEARCH MACHINES
+00007B     (base 16)		RESEARCH MACHINES
+				P.O. BOX 75
+				    ENGLAND
+				GB
+
+00-00-0F   (hex)		NEXT, INC.
+00000F     (base 16)		NEXT, INC.
+				3475 DEER CREEK ROAD
+				PALO ALTO  CA  94304
+				US
+
+00-00-BB   (hex)		TRI-DATA
+0000BB     (base 16)		TRI-DATA
+				505 EAST MIDDLEFIELD ROAD
+				MOUNTAIN VIEW  CA  94043-4082
+				US
+
+00-00-1A   (hex)		ADVANCED MICRO DEVICES
+00001A     (base 16)		ADVANCED MICRO DEVICES
+				P.O. BOX 3453
+				SUNNYVALE  CA  94088
+				US
+
+00-00-7F   (hex)		LINOTYPE-HELL AG
+00007F     (base 16)		LINOTYPE-HELL AG
+				POSTFACH 56 60
+				    
+				DE
+
+00-00-60   (hex)		KONTRON ELEKTRONIK GMBH
+000060     (base 16)		KONTRON ELEKTRONIK GMBH
+				OSKAR-VON-MILLER-STR. 1
+				    
+				DE
+
+08-00-6F   (hex)		PHILIPS APELDOORN B.V.
+08006F     (base 16)		PHILIPS APELDOORN B.V.
+				P.O. BOX 105
+				  THE  
+				NL
+
+00-00-40   (hex)		APPLICON, INC.
+000040     (base 16)		APPLICON, INC.
+				4251 PLYMOUTH RD 48015
+				ANN ARBOR  MI  48106-0986
+				US
+
+00-00-5D   (hex)		CS TELECOM
+00005D     (base 16)		CS TELECOM
+				4-16 AVENUE DU GENERAL LECLERC
+				    
+				FR
+
+00-00-12   (hex)		INFORMATION TECHNOLOGY LIMITED
+000012     (base 16)		INFORMATION TECHNOLOGY LIMITED
+				MAYLANDS AVE. HEMEL HEMPSTEAD
+				  HERTS  ENGLAND
+				GB
+
+00-00-8A   (hex)		DATAHOUSE INFORMATION SYSTEMS
+00008A     (base 16)		DATAHOUSE INFORMATION SYSTEMS
+				DIRECTOR OF OPERATIONS
+				GU34  3QW  ENGLAND
+				GB
+
+00-00-32   (hex)		Marconi plc
+000032     (base 16)		Marconi plc
+				28 ELSTREE WAY, BOREHAMWOOD
+				  UNITED  KINGDOM
+				GB
+
+00-00-85   (hex)		CANON INC.
+000085     (base 16)		CANON INC.
+				DVTECH. DEV. CENTER DEPT.12
+				    
+				JP
+
+00-00-4A   (hex)		ADC CODENOLL TECHNOLOGY CORP.
+00004A     (base 16)		ADC CODENOLL TECHNOLOGY CORP.
+				200 CORPORATE BLVD. SO.
+				YONKERS  NY  10701
+				US
+
+08-00-8F   (hex)		CHIPCOM CORPORATION
+08008F     (base 16)		CHIPCOM CORPORATION
+				SOUTHBOROUGH OFFICE
+				SOUTHBOROUGH  MA  01772-1886
+				US
+
+00-00-6A   (hex)		COMPUTER CONSOLES INC.
+00006A     (base 16)		COMPUTER CONSOLES INC.
+				COMPUTER PRODUCTS DIVISION
+				IRVINE  CA  92718
+				US
+
+08-00-3E   (hex)		CODEX CORPORATION
+08003E     (base 16)		CODEX CORPORATION
+				50 EAST COMMERCE DRIVE
+				SCHAUMBURG  IL  60173
+				US
+
+08-00-40   (hex)		FERRANTI COMPUTER SYS. LIMITED
+080040     (base 16)		FERRANTI COMPUTER SYS. LIMITED
+				WYTHENSHAWE DIVISION
+				  UNITED  KINGDOM
+				GB
+
+08-00-3A   (hex)		ORCATECH INC.
+08003A     (base 16)		ORCATECH INC.
+				2680 QUEENSVIEW DRIVE
+				CANADA  K2B  8H6
+				CA
+
+08-00-3D   (hex)		CADNETIX CORPORATIONS
+08003D     (base 16)		CADNETIX CORPORATIONS
+				5797 CENTRAL AVENUE
+				BOULDER  CO  80301
+				US
+
+08-00-38   (hex)		BULL S.A.S.
+080038     (base 16)		BULL S.A.S.
+				rue Jean Jaures B.P.68
+				Les Clayes sous Bois    78430
+				FR
+
+08-00-73   (hex)		TECMAR INC.
+080073     (base 16)		TECMAR INC.
+				6225 COCHRAN ROAD
+				SOLON  OH  44139
+				US
+
+08-00-72   (hex)		XEROX CORP UNIV GRANT PROGRAM
+080072     (base 16)		XEROX CORP UNIV GRANT PROGRAM
+				ZEROX SYSTEMS INSTITUTE
+				WEBSTER  NY  14580
+				US
+
+08-00-6A   (hex)		AT&T
+08006A     (base 16)		AT&T
+				3300 E Renner Road
+				Richardson  TX  75082
+				US
+
+08-00-7A   (hex)		INDATA
+08007A     (base 16)		INDATA
+				GJERDRUMS VEI 12 C
+				    
+				NO
+
+08-00-79   (hex)		THE DROID WORKS
+080079     (base 16)		THE DROID WORKS
+				P.O. BOX CS 8180
+				SAN RAFAEL  CA  94912
+				US
+
+08-00-4D   (hex)		CORVUS SYSTEMS INC.
+08004D     (base 16)		CORVUS SYSTEMS INC.
+				2100 CORVUS DRIVE
+				SAN JOSE  CA  95124
+				US
+
+08-00-2F   (hex)		PRIME COMPUTER INC.
+08002F     (base 16)		PRIME COMPUTER INC.
+				100 CROSBY DRIVE
+				BEDFORD  MA  01730-1402
+				US
+
+08-00-2C   (hex)		BRITTON LEE INC.
+08002C     (base 16)		BRITTON LEE INC.
+				14600 WINCHESTER BLVD
+				LOS GATOS  CA  95030
+				US
+
+08-00-62   (hex)		General Dynamics
+080062     (base 16)		General Dynamics
+				
+				Fort Worth  TX  
+				US
+
+08-00-5C   (hex)		FOUR PHASE SYSTEMS
+08005C     (base 16)		FOUR PHASE SYSTEMS
+				2001 LOGIC DRIVE
+				SAN JOSE  CA  95124-3452
+				US
+
+08-00-5A   (hex)		IBM Corp
+08005A     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+08-00-52   (hex)		INSYSTEC
+080052     (base 16)		INSYSTEC
+				450 LAKEMONT AVENUE
+				WINTER PARK  FL  32792
+				US
+
+08-00-1E   (hex)		APOLLO COMPUTER INC.
+08001E     (base 16)		APOLLO COMPUTER INC.
+				15 ELIZABETH DRIVE
+				CHELMSFORD  MA  01824
+				US
+
+08-00-19   (hex)		GENERAL ELECTRIC CORPORATION
+080019     (base 16)		GENERAL ELECTRIC CORPORATION
+				1285 BOSTON AVENUE
+				BRIDGEPORT  CT  06602
+				US
+
+02-70-01   (hex)		RACAL-DATACOM
+027001     (base 16)		RACAL-DATACOM
+				LAN INTERNETWORKING DIVISION
+				BOXBOROUGH  MA  01719
+				US
+
+08-00-0E   (hex)		NCR CORPORATION
+08000E     (base 16)		NCR CORPORATION
+				WORLD HEADQUARTERS
+				DAYTON  OH  45479
+				US
+
+00-DD-09   (hex)		UNGERMANN-BASS INC.
+00DD09     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-02   (hex)		XEROX CORPORATION
+000002     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-00-03   (hex)		XEROX CORPORATION
+000003     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-00-06   (hex)		XEROX CORPORATION
+000006     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+08-00-01   (hex)		COMPUTERVISION CORPORATION
+080001     (base 16)		COMPUTERVISION CORPORATION
+				14 CROSBY DRIVE MS 5-1
+				BEDFORD  MA  01730
+				US
+
+08-00-05   (hex)		SYMBOLICS INC.
+080005     (base 16)		SYMBOLICS INC.
+				257 VASSAR STREET
+				CAMBRIDGE  MA  02139
+				US
+
+00-DD-07   (hex)		UNGERMANN-BASS INC.
+00DD07     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-00-08   (hex)		XEROX CORPORATION
+000008     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+00-00-3D   (hex)		UNISYS
+00003D     (base 16)		UNISYS
+				MS8-010
+				SAN JOSE  CA  95150-6685
+				US
+
+00-DD-0D   (hex)		UNGERMANN-BASS INC.
+00DD0D     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+08-00-64   (hex)		Sitasys AG
+080064     (base 16)		Sitasys AG
+				Freiburgstrasse 251
+				    
+				CH
+
+08-00-02   (hex)		BRIDGE COMMUNICATIONS INC.
+080002     (base 16)		BRIDGE COMMUNICATIONS INC.
+				2081 STIERLING ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+08-00-1A   (hex)		TIARA/ 10NET
+08001A     (base 16)		TIARA/ 10NET
+				7777 WASHINGTON VILLAGE DRIVE
+				DAYTON  OHIO  45459-3957
+				US
+
+08-00-8B   (hex)		PYRAMID TECHNOLOGY CORP.
+08008B     (base 16)		PYRAMID TECHNOLOGY CORP.
+				1295 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+08-00-12   (hex)		BELL ATLANTIC INTEGRATED SYST.
+080012     (base 16)		BELL ATLANTIC INTEGRATED SYST.
+				40 TALL PINE DRIVE
+				SUDBURY  MA  01776
+				US
+
+14-A1-BF   (hex)		ASSA ABLOY Korea Co., Ltd Unilock
+14A1BF     (base 16)		ASSA ABLOY Korea Co., Ltd Unilock
+				10f of JEI PLATZ Bldg., 186, Gasandigital 1-ro
+				Geumcheon-gu  Seoul  08502
+				KR
+
+94-83-C4   (hex)		GL Technologies (Hong Kong) Limited
+9483C4     (base 16)		GL Technologies (Hong Kong) Limited
+				103B Enterprise Place, 5W Science Park
+				NT    00000
+				HK
+
+08-00-30   (hex)		ROYAL MELBOURNE INST OF TECH
+080030     (base 16)		ROYAL MELBOURNE INST OF TECH
+				GPO BOX 2476V
+				MELBOURNE  VIC  3001
+				AU
+
+00-00-0B   (hex)		MATRIX CORPORATION
+00000B     (base 16)		MATRIX CORPORATION
+				1203 NEW HOPE ROAD
+				RALEIGH  NORTH CAROLINA   276
+				US
+
+00-00-9B   (hex)		INFORMATION INTERNATIONAL, INC
+00009B     (base 16)		INFORMATION INTERNATIONAL, INC
+				5F., THE 7TH INDUSTRY BLDG.
+				  JAPAN  150
+				JP
+
+9C-93-B0   (hex)		Megatronix (Beijing) Technology Co., Ltd.
+9C93B0     (base 16)		Megatronix (Beijing) Technology Co., Ltd.
+				Floor11,Building C, Rongxin Center Chungyuan Road 34#, chaoyang distric, Beijing, P.R.China
+				Beijing  Beijing  100012
+				CN
+
+64-AE-F1   (hex)		Qingdao Hisense Electronics Co.,Ltd.
+64AEF1     (base 16)		Qingdao Hisense Electronics Co.,Ltd.
+				Qianwangang Roard 218
+				Qingdao  Shandong  266510
+				CN
+
+08-00-16   (hex)		BARRISTER INFO SYS CORP
+080016     (base 16)		BARRISTER INFO SYS CORP
+				ONE TECHNOLOGY CENTER
+				BUFFALO  NY  14203
+				US
+
+44-CB-8B   (hex)		LG Innotek
+44CB8B     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+B4-05-5D   (hex)		Inspur Electronic Information Industry Co.,Ltd.
+B4055D     (base 16)		Inspur Electronic Information Industry Co.,Ltd.
+				No 224 Shanda Road
+				Jinan  Shandong  250013
+				CN
+
+98-48-27   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+984827     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+D4-F5-EF   (hex)		Hewlett Packard Enterprise
+D4F5EF     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+28-BD-89   (hex)		Google, Inc.
+28BD89     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+EC-1B-BD   (hex)		Silicon Laboratories
+EC1BBD     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin    78735
+				US
+
+D8-A3-15   (hex)		vivo Mobile Communication Co., Ltd.
+D8A315     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+80-64-7A   (hex)		Ola Sense Inc
+80647A     (base 16)		Ola Sense Inc
+				764 Avenue A
+				Redondo Beach    90277
+				US
+
+70-F8-2B   (hex)		DWnet Technologies(Suzhou) Corporation
+70F82B     (base 16)		DWnet Technologies(Suzhou) Corporation
+				No.8,Tangzhuang Road, Suzhou Industrial Park, Jiangsu, China
+				Suzhou    21500
+				CN
+
+14-24-75   (hex)		4DReplay, Inc
+142475     (base 16)		4DReplay, Inc
+				1286 Folsom Street
+				San Francisco  CA  94103
+				US
+
+10-DC-B6   (hex)		IEEE Registration Authority
+10DCB6     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F8-9E-28   (hex)		Cisco Meraki
+F89E28     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco    94158
+				US
+
+F8-C4-F3   (hex)		Shanghai Infinity Wireless Technologies Co.,Ltd.
+F8C4F3     (base 16)		Shanghai Infinity Wireless Technologies Co.,Ltd.
+				Room 522, Building A, No.1687 Changyang Road, Yangpu District, Shanghai
+				Shanghai  Shanghai  200082
+				CN
+
+D4-77-2B   (hex)		Nanjing Ztlink Network Technology Co.,Ltd
+D4772B     (base 16)		Nanjing Ztlink Network Technology Co.,Ltd
+				No.0 Mozhou East Road , Jiangning Economic & Technological Development Zone, Jiangning District
+				Nanjing  Jiangsu  211111
+				CN
+
+64-F9-C0   (hex)		ANALOG DEVICES
+64F9C0     (base 16)		ANALOG DEVICES
+				32990 ALVARADO NILES RD
+				UNION CITY  CA  94587
+				US
+
+18-D0-C5   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+18D0C5     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+34-ED-1B   (hex)		Cisco Systems, Inc
+34ED1B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-A5-11   (hex)		NETGEAR
+BCA511     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-0A-7B   (hex)		Cornelius Consult
+000A7B     (base 16)		Cornelius Consult
+				Im Vogelsang 21
+				Hattingen  NRW  45527
+				DE
+
+C4-E9-0A   (hex)		D-Link International
+C4E90A     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+C4-44-7D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4447D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+30-E9-8E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30E98E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-8B-34   (hex)		Shanghai Smart System Technology Co., Ltd
+748B34     (base 16)		Shanghai Smart System Technology Co., Ltd
+				Room 902C-1, 560 Shengxia Road, Zhangjiang Hi-Tech Park, Shanghai 201203, China
+				Shanghai  Shanghai  201210
+				CN
+
+AC-BD-70   (hex)		Huawei Device Co., Ltd.
+ACBD70     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C0-2E-26   (hex)		Private
+C02E26     (base 16)		Private
+
+34-D2-62   (hex)		SZ DJI TECHNOLOGY CO.,LTD
+34D262     (base 16)		SZ DJI TECHNOLOGY CO.,LTD
+				6/F,HKUST SZ IER Bldg,9 Yuexing 1st Rd
+				shenzhen  guangdong  518057
+				CN
+
+08-12-A5   (hex)		Amazon Technologies Inc.
+0812A5     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+80-7F-F8   (hex)		Juniper Networks
+807FF8     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+44-03-77   (hex)		IEEE Registration Authority
+440377     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-24-87   (hex)		Transact Campus, Inc.
+002487     (base 16)		Transact Campus, Inc.
+				22601 North 19th Avenue
+				Phoenix  AZ  85027
+				US
+
+B4-E9-A3   (hex)		port industrial automation GmbH
+B4E9A3     (base 16)		port industrial automation GmbH
+				Regensburger Str. 7b
+				Halle (S.)    06132
+				DE
+
+38-E8-EE   (hex)		Nanjing Youkuo Electric Technology Co., Ltd
+38E8EE     (base 16)		Nanjing Youkuo Electric Technology Co., Ltd
+				100 Jiangjun Road,Jiangning
+				Nanjing  Jiangsu  211100
+				CN
+
+90-B8-E0   (hex)		SHENZHEN YANRAY TECHNOLOGY CO.,LTD
+90B8E0     (base 16)		SHENZHEN YANRAY TECHNOLOGY CO.,LTD
+				5A, 4th Building, Huafengzhenbao Industrial Park, Beihuan Road, Shiyan Street, Baoan District, 
+				Shenzhen  Guangdong  518000
+				CN
+
+9C-F5-31   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+9CF531     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+80-E4-55   (hex)		New H3C Technologies Co., Ltd
+80E455     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+2C-4C-C6   (hex)		Murata Manufacturing Co., Ltd.
+2C4CC6     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+7C-21-0D   (hex)		Cisco Systems, Inc
+7C210D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+4C-BC-72   (hex)		Primex Wireless
+4CBC72     (base 16)		Primex Wireless
+				965 Wells Street
+				Lake Geneva  WI  53147
+				US
+
+68-02-B8   (hex)		Compal Broadband Networks, Inc.
+6802B8     (base 16)		Compal Broadband Networks, Inc.
+				13F., No.1, Taiyuan 1st St.
+				Zhubei City  Hsinchu County  30265
+				TW
+
+34-63-D4   (hex)		BIONIX SUPPLYCHAIN TECHNOLOGIES SLU
+3463D4     (base 16)		BIONIX SUPPLYCHAIN TECHNOLOGIES SLU
+				Poligono Pocomaco Avenida Primera Parcela B3 Nave F
+				La Coruña  La Coruña  15190
+				ES
+
+08-F7-E9   (hex)		HRCP Research and Development Partnership
+08F7E9     (base 16)		HRCP Research and Development Partnership
+				1-24-2 Taito, Taito-ku
+				Tokyo    1100016
+				JP
+
+8C-BA-25   (hex)		UNIONMAN TECHNOLOGY CO.,LTD
+8CBA25     (base 16)		UNIONMAN TECHNOLOGY CO.,LTD
+				No.5,Huitai Road,Huinan High-Tech Park,Huiao Highway
+				Huizhou  Guangdong  516025
+				CN
+
+D4-9E-3B   (hex)		Guangzhou Shiyuan Electronic Technology Company Limited
+D49E3B     (base 16)		Guangzhou Shiyuan Electronic Technology Company Limited
+				No.6, 4th Yunpu Road, Yunpu industry District
+				Guangzhou  Guangdong  510530
+				CN
+
+DC-DC-E2   (hex)		Samsung Electronics Co.,Ltd
+DCDCE2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A0-AC-69   (hex)		Samsung Electronics Co.,Ltd
+A0AC69     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-89-FB   (hex)		Samsung Electronics Co.,Ltd
+1089FB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-4B-DD   (hex)		Shenzhen SuperElectron Technology Co.,Ltd.
+DC4BDD     (base 16)		Shenzhen SuperElectron Technology Co.,Ltd.
+				1213-1214, haosheng business center, dongbin road, nanshan street, nanshan district, shenzhen city
+				Shenzhen  Guangdong  518000
+				CN
+
+C0-B5-CD   (hex)		Huawei Device Co., Ltd.
+C0B5CD     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+4C-50-77   (hex)		Huawei Device Co., Ltd.
+4C5077     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+50-2D-BB   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+502DBB     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+84-EA-97   (hex)		Shenzhen iComm Semiconductor Co., Ltd.
+84EA97     (base 16)		Shenzhen iComm Semiconductor Co., Ltd.
+				Room 501A,Block B,Digital Building,Garden City,No.1079 Nanhai Road,Nanshan District
+				Shenzhen    518067
+				CN
+
+5C-3A-3D   (hex)		zte corporation
+5C3A3D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+30-FD-65   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30FD65     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-A1-AE   (hex)		Apple, Inc.
+7CA1AE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-22-FB   (hex)		Apple, Inc.
+3C22FB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-EA-FC   (hex)		ELL-IoT Inc
+58EAFC     (base 16)		ELL-IoT Inc
+				32 Journey
+				Aliso Viejo  CA  92656
+				US
+
+90-13-DA   (hex)		Athom B.V.
+9013DA     (base 16)		Athom B.V.
+				Rigtersbleek-Zandvoort 10
+				Enschede    7521BE 
+				NL
+
+14-11-5D   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+14115D     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+E4-F3-27   (hex)		ATOL LLC
+E4F327     (base 16)		ATOL LLC
+				Bolshaya Novodmitrovskaya str., 14, build 4
+				Moscow    127015
+				RU
+
+68-19-AC   (hex)		Guangzhou Xianyou Intelligent Technogoly CO., LTD
+6819AC     (base 16)		Guangzhou Xianyou Intelligent Technogoly CO., LTD
+				No.32 Xixiu Road, Xiuquan Street,Huadu District
+				Guangzhou  Guangdong  510800
+				CN
+
+E8-2E-0C   (hex)		NETINT Technologies Inc.
+E82E0C     (base 16)		NETINT Technologies Inc.
+				#306, 3500 Gilmore Way
+				Burnaby  BC  V5G0B8
+				CA
+
+18-92-A4   (hex)		Ciena Corporation
+1892A4     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+10-08-2C   (hex)		Texas Instruments
+10082C     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B0-73-5D   (hex)		Huawei Device Co., Ltd.
+B0735D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F0-B4-D2   (hex)		D-Link International
+F0B4D2     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+5C-3A-45   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+5C3A45     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+A0-3C-31   (hex)		Shenzhen Belon Technology CO.,LTD
+A03C31     (base 16)		Shenzhen Belon Technology CO.,LTD
+				Tsinghua Information
+				Shenzhen  Guangdong  518052
+				CN
+
+A8-97-CD   (hex)		ARRIS Group, Inc.
+A897CD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+40-4C-77   (hex)		ARRIS Group, Inc.
+404C77     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+2C-E3-10   (hex)		Stratacache
+2CE310     (base 16)		Stratacache
+				40 N Main St, Suite 2600
+				Dayton  OH  45423
+				US
+
+00-22-A0   (hex)		APTIV SERVICES US, LLC
+0022A0     (base 16)		APTIV SERVICES US, LLC
+				5725 Innovation Drive
+				Troy  MI  48098
+				US
+
+A4-30-7A   (hex)		Samsung Electronics Co.,Ltd
+A4307A     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+FC-8E-5B   (hex)		China Mobile Iot Limited company
+FC8E5B     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+14-2A-14   (hex)		ShenZhen Selenview Digital Technology Co.,Ltd
+142A14     (base 16)		ShenZhen Selenview Digital Technology Co.,Ltd
+				615,Block A,Huafeng internet Creative Park,107 Gonghe Industrial Road,Baoan District,Shenzhen,China
+				Shenzhen  Guangdong  518102
+				CN
+
+D8-7E-76   (hex)		ITEL MOBILE LIMITED
+D87E76     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+38-4B-5B   (hex)		ZTRON TECHNOLOGY LIMITED
+384B5B     (base 16)		ZTRON TECHNOLOGY LIMITED
+				12/F,JunZi Plaza, Qiaoxiang Road, Futian District
+				Shenzhen  Guangdong  518000
+				CN
+
+B8-61-42   (hex)		Beijing Tricolor Technology Co., Ltd
+B86142     (base 16)		Beijing Tricolor Technology Co., Ltd
+				Room 808, Building 1, Yard 39, Linfeng 2nd Road, Haidian
+				Beijing    102206
+				CN
+
+20-0A-0D   (hex)		IEEE Registration Authority
+200A0D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E4-7C-65   (hex)		Sunstar Communication Technology  Co., Ltd
+E47C65     (base 16)		Sunstar Communication Technology  Co., Ltd
+				4F,Building D1, Mould Industrial Park, No.199 of Xiqu Ave,West High-tech Zone
+				Chengdu  Sichuan  611731
+				CN
+
+9C-54-DA   (hex)		SkyBell Technologies Inc.
+9C54DA     (base 16)		SkyBell Technologies Inc.
+				1 Jenner 
+				Irvine  CA  92618
+				US
+
+4C-49-4F   (hex)		zte corporation
+4C494F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C4-74-1E   (hex)		zte corporation
+C4741E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-D0-78   (hex)		Eltex of Sweden AB
+00D078     (base 16)		Eltex of Sweden AB
+				Södra Portgatan 19
+				OSBY  Skåne  283 50
+				SE
+
+5C-78-F8   (hex)		Huawei Device Co., Ltd.
+5C78F8     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B8-27-C5   (hex)		Huawei Device Co., Ltd.
+B827C5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+DC-89-83   (hex)		Samsung Electronics Co.,Ltd
+DC8983     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+5C-CB-99   (hex)		Samsung Electronics Co.,Ltd
+5CCB99     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-60-75   (hex)		Baidu Online Network Technology (Beijing) Co., Ltd
+D46075     (base 16)		Baidu Online Network Technology (Beijing) Co., Ltd
+				Baidu Campus, No.10 Shangdi 10th Street, Haidian District
+				 Beijing    100085
+				CN
+
+78-C5-F8   (hex)		Huawei Device Co., Ltd.
+78C5F8     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D4-5D-64   (hex)		ASUSTek COMPUTER INC.
+D45D64     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+90-B1-44   (hex)		Samsung Electronics Co.,Ltd
+90B144     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+48-DD-0C   (hex)		eero inc.
+48DD0C     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+94-0C-98   (hex)		Apple, Inc.
+940C98     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-FB-E9   (hex)		Apple, Inc.
+E8FBE9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-EC-0D   (hex)		Apple, Inc.
+38EC0D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-27-8C   (hex)		BUFFALO.INC
+58278C     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+14-0A-C5   (hex)		Amazon Technologies Inc.
+140AC5     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+20-83-F8   (hex)		Advanced Digital Broadcast SA
+2083F8     (base 16)		Advanced Digital Broadcast SA
+				Route de Lausanne 319
+				Bellevue    CH-1293
+				SZ
+
+C8-C7-50   (hex)		Motorola Mobility LLC, a Lenovo Company
+C8C750     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+2C-DC-D7   (hex)		AzureWave Technology Inc.
+2CDCD7     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+34-E3-DA   (hex)		Hoval Aktiengesellschaft
+34E3DA     (base 16)		Hoval Aktiengesellschaft
+				Austrasse 70
+				Vaduz    9490
+				LI
+
+E0-BB-9E   (hex)		Seiko Epson Corporation
+E0BB9E     (base 16)		Seiko Epson Corporation
+				2070 Kotobuki Koaka
+				Matsumoto-shi  Nagano-ken  399-8702
+				JP
+
+48-D2-4F   (hex)		Sagemcom Broadband SAS
+48D24F     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E4-AA-EC   (hex)		Tianjin Hualai Technology Co., Ltd
+E4AAEC     (base 16)		Tianjin Hualai Technology Co., Ltd
+				Overseas Chinese business building No. 10, Jinping Road, Nankai District, Tianjin
+				TIANJIN    300190
+				CN
+
+94-BE-46   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+94BE46     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+AC-F8-CC   (hex)		ARRIS Group, Inc.
+ACF8CC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+8C-5A-25   (hex)		ARRIS Group, Inc.
+8C5A25     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+48-3F-DA   (hex)		Espressif Inc.
+483FDA     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+6C-5D-3A   (hex)		Microsoft Corporation
+6C5D3A     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND    98052
+				US
+
+CC-D4-2E   (hex)		Arcadyan Corporation
+CCD42E     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+C8-53-E1   (hex)		Beijing Bytedance Network Technology Co., Ltd
+C853E1     (base 16)		Beijing Bytedance Network Technology Co., Ltd
+				No.1 Building, Zhonghang Square, West Road of the Northern 3rd Circuit, Haidian Distrct
+				Beijing  Beijing  100098
+				CN
+
+14-16-9D   (hex)		Cisco Systems, Inc
+14169D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+48-A2-E6   (hex)		Resideo
+48A2E6     (base 16)		Resideo
+				2 Corporate Center Dr.
+				Melville  NY  11747
+				US
+
+90-E2-FC   (hex)		IEEE Registration Authority
+90E2FC     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F0-08-D1   (hex)		Espressif Inc.
+F008D1     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+58-94-B2   (hex)		BrainCo
+5894B2     (base 16)		BrainCo
+				????????????????1107?
+				???  ???  518000
+				CN
+
+B0-95-75   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+B09575     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+B4-B0-55   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B4B055     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-8C-16   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+048C16     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+98-DD-5B   (hex)		TAKUMI JAPAN LTD
+98DD5B     (base 16)		TAKUMI JAPAN LTD
+				3-9-3 Uchiyama building 7F Nishishinbashi
+				Minato-ku Tokyo  Tokyo  1050003
+				JP
+
+3C-5C-F1   (hex)		eero inc.
+3C5CF1     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+14-AE-85   (hex)		IEEE Registration Authority
+14AE85     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+90-74-9D   (hex)		IRay Technology Co., Ltd.
+90749D     (base 16)		IRay Technology Co., Ltd.
+				11th Guiyang St.,
+				Yantai  Shandong  264000
+				CN
+
+8C-3B-32   (hex)		Microfan B.V.
+8C3B32     (base 16)		Microfan B.V.
+				Industriestraat 23
+				Horst  Limburg  5961 PH
+				NL
+
+D0-D3-E0   (hex)		Aruba, a Hewlett Packard Enterprise Company
+D0D3E0     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+64-5C-F3   (hex)		ParanTek Inc.
+645CF3     (base 16)		ParanTek Inc.
+				3F, 40-15 Gilju-Ro, 411 Beon-Gil
+				Wonmi-Gu, Bucheon City  Gyeonggi-Do  14488
+				KR
+
+B0-CC-FE   (hex)		Huawei Device Co., Ltd.
+B0CCFE     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+54-0D-F9   (hex)		Huawei Device Co., Ltd.
+540DF9     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-66-19   (hex)		Huawei Device Co., Ltd.
+006619     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+FC-39-64   (hex)		ITEL MOBILE LIMITED
+FC3964     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+14-47-2D   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+14472D     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+E4-90-FD   (hex)		Apple, Inc.
+E490FD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-AB-1A   (hex)		Apple, Inc.
+84AB1A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-6D-31   (hex)		FIREWALLA INC
+206D31     (base 16)		FIREWALLA INC
+				75 E. Santa Clara St. STE 600
+				San Jose  CA  95113
+				US
+
+D0-65-44   (hex)		Apple, Inc.
+D06544     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-6F-2D   (hex)		Shenzhen Sundray Technologies Company Limited
+186F2D     (base 16)		Shenzhen Sundray Technologies Company Limited
+				5th Floor, Block A4, Nanshan ipark,NO.1001 Xue Yuan Road, Nanshan District, Shenzhen 518055, P.R. China
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-4F-AD   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+F84FAD     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+4C-0A-3D   (hex)		ADNACOM INC.
+4C0A3D     (base 16)		ADNACOM INC.
+				200-5050 Kingsway
+				Burnaby  BC  V5H 4H2
+				CA
+
+3C-80-6B   (hex)		Hunan Voc Acoustics Technology Co., Ltd.
+3C806B     (base 16)		Hunan Voc Acoustics Technology Co., Ltd.
+				State Industrialpark, Jiulong Development Zone, Yanling County
+				Zhuzhou  Hunan  412500
+				CN
+
+60-DE-35   (hex)		GITSN, Inc.
+60DE35     (base 16)		GITSN, Inc.
+				 #601~602, Daerung Post Tower 1, 288, Digital-ro
+				Guro-gu  Seoul  08390
+				KR
+
+28-31-7E   (hex)		Hongkong Nano IC Technologies Co., Ltd
+28317E     (base 16)		Hongkong Nano IC Technologies Co., Ltd
+				 Rm. 19C, Lockhart Ctr., 301-307 Lockhart Rd., Wan Chai, Hong Kong.
+				Hongkong    999077
+				CN
+
+A8-41-22   (hex)		China Mobile (Hangzhou) Information Technology Co.,Ltd.
+A84122     (base 16)		China Mobile (Hangzhou) Information Technology Co.,Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+6C-DD-BC   (hex)		Samsung Electronics Co.,Ltd
+6CDDBC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-7F-76   (hex)		Cisco Systems, Inc
+CC7F76     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-BC-68   (hex)		Wuhan Funshion Online Technologies Co.,Ltd
+40BC68     (base 16)		Wuhan Funshion Online Technologies Co.,Ltd
+				5th Floor,Financial Port Building A9,No.77 Optical Valley Avenue, East Lake High-Tech Development Zone, Wuhan
+				Wuhan  CN/Hubei  430000
+				CN
+
+DC-98-40   (hex)		Microsoft Corporation
+DC9840     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND    98052
+				US
+
+44-76-54   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+447654     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-D9-A0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7CD9A0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F0-33-E5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F033E5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-F1-8C   (hex)		Huawei Device Co., Ltd.
+B4F18C     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B8-CE-F6   (hex)		Mellanox Technologies, Inc.
+B8CEF6     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+B8-02-A4   (hex)		Aeonsemi, Inc.
+B802A4     (base 16)		Aeonsemi, Inc.
+				Cassia Court, Suite 716, 10 Market Street
+				Camana Bay  Grand Cayman  KY1-9006
+				KY
+
+E4-83-26   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E48326     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-05-BB   (hex)		IEEE Registration Authority
+9405BB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-5F-AD   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+8C5FAD     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+AC-C2-5D   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+ACC25D     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+8C-0C-87   (hex)		Nokia
+8C0C87     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+18-69-D8   (hex)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+1869D8     (base 16)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+				7 Floor, 3 Blvd., More Centre, 87 Gudun Rd., Xihu District
+				Hangzhou  Zhejiang  310012
+				CN
+
+C4-32-D1   (hex)		Farlink Technology Limited
+C432D1     (base 16)		Farlink Technology Limited
+				Flat A&B,9/F,Wing Cheong Factory Building,121 King Lam Street,Cheung Sha Wan,Hong Kong.
+				Hongkong    0000
+				HK
+
+CC-41-8E   (hex)		MSA Innovation
+CC418E     (base 16)		MSA Innovation
+				1100 Cranberry Woods Road
+				Cranberry Township  PA  16066
+				US
+
+CC-A7-C1   (hex)		Google, Inc.
+CCA7C1     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+38-84-79   (hex)		Cisco Meraki
+388479     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco    94158
+				US
+
+7C-9E-BD   (hex)		Espressif Inc.
+7C9EBD     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+1C-02-19   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1C0219     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+C8-D7-78   (hex)		BSH Hausgeraete GmbH
+C8D778     (base 16)		BSH Hausgeraete GmbH
+				Im Gewerbepark B10
+				Regensburg    93059
+				DE
+
+9C-61-1D   (hex)		Panasonic Corporation of North America
+9C611D     (base 16)		Panasonic Corporation of North America
+				1200 Ridgeway Ave
+				Rochester  NY  14615
+				US
+
+C0-95-DA   (hex)		NXP India Private Limited
+C095DA     (base 16)		NXP India Private Limited
+				1st Floor, Muttha Towers, Don Bosco Marg, Off Airport Road, Yerwada
+				Pune  Maharashtra  411006
+				IN
+
+B4-22-00   (hex)		Brother Industries, LTD.
+B42200     (base 16)		Brother Industries, LTD.
+				15-1, Naeshirocho, Mizuho-ku
+				NAGOYA    4678561
+				JP
+
+68-49-B2   (hex)		CARLO GAVAZZI LTD
+6849B2     (base 16)		CARLO GAVAZZI LTD
+				BLB042, Bulebel Industrial Estate 
+				Zejtun     ZTN 3000
+				MT
+
+48-7A-FF   (hex)		ESSYS
+487AFF     (base 16)		ESSYS
+				gaetbeol-ro
+				Incheon    21999
+				KR
+
+40-B6-E7   (hex)		Huawei Device Co., Ltd.
+40B6E7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D0-B4-5D   (hex)		Huawei Device Co., Ltd.
+D0B45D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+88-36-CF   (hex)		Huawei Device Co., Ltd.
+8836CF     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A4-C5-4E   (hex)		Huawei Device Co., Ltd.
+A4C54E     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D4-BB-E6   (hex)		Huawei Device Co., Ltd.
+D4BBE6     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+00-9E-EE   (hex)		Positivo Tecnologia S.A.
+009EEE     (base 16)		Positivo Tecnologia S.A.
+				João Bettega, 5200
+				Curitiba  Paraná  81350-000
+				BR
+
+90-B8-32   (hex)		Extreme Networks, Inc.
+90B832     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+40-2F-86   (hex)		LG Innotek
+402F86     (base 16)		LG Innotek
+				26, Hanamsandan 5beon-ro
+				Gwangju  Gwangsan-gu  506-731
+				KR
+
+D4-22-CD   (hex)		Xsens Technologies B.V.
+D422CD     (base 16)		Xsens Technologies B.V.
+				Pantheon 6-a
+				Enschede    7521 PR
+				NL
+
+C8-67-5E   (hex)		Extreme Networks, Inc.
+C8675E     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+9C-5D-12   (hex)		Extreme Networks, Inc.
+9C5D12     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+F0-9C-E9   (hex)		Extreme Networks, Inc.
+F09CE9     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+C4-13-E2   (hex)		Extreme Networks, Inc.
+C413E2     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+F4-EB-9F   (hex)		Ellu Company 2019 SL
+F4EB9F     (base 16)		Ellu Company 2019 SL
+				Paseo de la Castellana 144 14B
+				Madrid  Madrid  28046
+				ES
+
+E8-98-C2   (hex)		ZETLAB Company
+E898C2     (base 16)		ZETLAB Company
+				Savelkinsky passage, 4
+				Zelenograd  Moscow  124482
+				RU
+
+D4-1A-C8   (hex)		Nippon Printer Engineering
+D41AC8     (base 16)		Nippon Printer Engineering
+				2660 Katsuyama
+				Fujikawaguchiko-town  Yamanashi-Pref.  401-0310
+				JP
+
+50-61-F6   (hex)		Universal Electronics, Inc.
+5061F6     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+00-0C-32   (hex)		Avionic Design GmbH
+000C32     (base 16)		Avionic Design GmbH
+				Wragekamp 10
+				Hamburg    22397
+				DE
+
+00-0A-0D   (hex)		Amphenol
+000A0D     (base 16)		Amphenol
+				Holzhauser Strasse 175
+				Berlin    13509
+				DE
+
+F4-54-20   (hex)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+F45420     (base 16)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+				Av. Buriti, 1900 – Setor B – Distrito Industrial
+				Manaus  Amazonas  69075-000
+				BR
+
+4C-40-88   (hex)		SANSHIN ELECTRONICS CO.,LTD.
+4C4088     (base 16)		SANSHIN ELECTRONICS CO.,LTD.
+				4-4-12, Shiba, Minato-ku,
+				Tokyo    108-8404
+				JP
+
+64-DD-E9   (hex)		Xiaomi Communications Co Ltd
+64DDE9     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+0C-81-7D   (hex)		EEP Elektro-Elektronik Pranjic GmbH
+0C817D     (base 16)		EEP Elektro-Elektronik Pranjic GmbH
+				Am Luftschacht 21
+				Gelsenkirchen    45886
+				DE
+
+04-F5-F4   (hex)		Proxim Wireless
+04F5F4     (base 16)		Proxim Wireless
+				2114 Ringwood Ave
+				San Jose  CA  95131
+				US
+
+C8-BC-E5   (hex)		Sense Things Japan INC.
+C8BCE5     (base 16)		Sense Things Japan INC.
+				3-5-7 Kawaramachi,Chuo-ku
+				Osaka    541-0048
+				JP
+
+E8-B4-70   (hex)		IEEE Registration Authority
+E8B470     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-1B-ED   (hex)		Brocade Communications Systems LLC
+001BED     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-0C-DB   (hex)		Brocade Communications Systems LLC
+000CDB     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-04-80   (hex)		Brocade Communications Systems LLC
+000480     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+60-9C-9F   (hex)		Brocade Communications Systems LLC
+609C9F     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-00-88   (hex)		Brocade Communications Systems LLC
+000088     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-60-DF   (hex)		Brocade Communications Systems LLC
+0060DF     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-60-69   (hex)		Brocade Communications Systems LLC
+006069     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-05-33   (hex)		Brocade Communications Systems LLC
+000533     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+B0-45-02   (hex)		Huawei Device Co., Ltd.
+B04502     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+1C-1F-F1   (hex)		Huawei Device Co., Ltd.
+1C1FF1     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B4-EF-1C   (hex)		360 AI Technology Co.Ltd
+B4EF1C     (base 16)		360 AI Technology Co.Ltd
+				MTK Building B?No.6 Jiuxianqiao Road, Chaoyang District, Beijing, P.R.C. 
+				Beijing  Beijing  100015
+				CN
+
+14-DE-39   (hex)		Huawei Device Co., Ltd.
+14DE39     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B8-F0-09   (hex)		Espressif Inc.
+B8F009     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+FC-71-FA   (hex)		Trane Technologies
+FC71FA     (base 16)		Trane Technologies
+				6200 Troup Hwy.
+				Tyler  TX  75707
+				US
+
+CC-BE-59   (hex)		Calix Inc.
+CCBE59     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+84-A3-B5   (hex)		Propulsion systems
+84A3B5     (base 16)		Propulsion systems
+				Dooren 72
+				Merchtem  Vlaams brabant  1785
+				BE
+
+30-FC-EB   (hex)		LG Electronics (Mobile Communications)
+30FCEB     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+24-68-B0   (hex)		Samsung Electronics Co.,Ltd
+2468B0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-13-38   (hex)		Kimball Electronics Group, LLC
+1C1338     (base 16)		Kimball Electronics Group, LLC
+				1205 Kimball Blvd
+				Jasper  IN  47546
+				US
+
+9C-ED-FA   (hex)		EVUlution AG
+9CEDFA     (base 16)		EVUlution AG
+				Via da Clalt 12
+				Poschiavo  GR  7742
+				CH
+
+EC-63-ED   (hex)		Hyundai Autoever Corp.
+EC63ED     (base 16)		Hyundai Autoever Corp.
+				38, Teheran-ro 114-gil
+				Gangnam-gu, Seoul    06176
+				KR
+
+D4-67-61   (hex)		XonTel Technology Co.
+D46761     (base 16)		XonTel Technology Co.
+				XonTel, Borj ALadel Tower, Fahad Al-Salem St Fl 21
+				Kuwait    0000
+				KW
+
+E4-41-22   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+E44122     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+9C-19-C2   (hex)		Dongguan Liesheng Electronic Co., Ltd.
+9C19C2     (base 16)		Dongguan Liesheng Electronic Co., Ltd.
+				F5, Building B, North Block, Gaosheng Tech Park, No. 84 Zhongli Road, Nancheng District, Dongguan Ci
+				dongguan   guangdong  523000
+				CN
+
+BC-26-A1   (hex)		FACTORY FIVE Corporation
+BC26A1     (base 16)		FACTORY FIVE Corporation
+				3-391-1, Kamikitadai,
+				 Higashiyamato  Tokyo  207-0023
+				JP
+
+74-CB-F3   (hex)		Lava international limited
+74CBF3     (base 16)		Lava international limited
+				A-154D, Sector-63
+				Noida  Uttar Pradesh  201301
+				IN
+
+F0-D1-4F   (hex)		LINEAR LLC
+F0D14F     (base 16)		LINEAR LLC
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+00-11-68   (hex)		HomeLogic LLC
+001168     (base 16)		HomeLogic LLC
+				5919 Sea Otter Place
+				Carlsbad  CA  92010
+				US
+
+18-DF-C1   (hex)		Aetheros
+18DFC1     (base 16)		Aetheros
+				909 Montgomery Street, Suite 104
+				San Francisco    94133
+				US
+
+FC-BC-0E   (hex)		Zhejiang Cainiao Supply Chain Management Co., Ltd
+FCBC0E     (base 16)		Zhejiang Cainiao Supply Chain Management Co., Ltd
+				Block B1, XIXI center, No.588 West Wenyi Road, Xihu District
+				Hangzhou  Zhejiang  310000
+				CN
+
+2C-D0-66   (hex)		Xiaomi Communications Co Ltd
+2CD066     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+B0-5C-DA   (hex)		HP Inc.
+B05CDA     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+DC-BD-7A   (hex)		Guangzhou Shiyuan Electronic Technology Company Limited
+DCBD7A     (base 16)		Guangzhou Shiyuan Electronic Technology Company Limited
+				No.6, 4th Yunpu Road, Yunpu industry District
+				Guangzhou  Guangdong  510530
+				CN
+
+90-16-BA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9016BA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-AA-EF   (hex)		Huawei Device Co., Ltd.
+60AAEF     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D0-F3-F5   (hex)		Huawei Device Co., Ltd.
+D0F3F5     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+D4-46-49   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D44649     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-00-B0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9400B0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+24-79-EF   (hex)		Greenpacket Berhad, Taiwan
+2479EF     (base 16)		Greenpacket Berhad, Taiwan
+				B-23A-3, The Ascent Paradigm, No. 1, Jalan SS7/26A, Kelana Jaya, 47301 Petaling Jaya
+				Petaling Jaya  Selangor  47301
+				MY
+
+AC-23-34   (hex)		Infinix mobility limited
+AC2334     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+00-2B-67   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+002B67     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+F8-BC-0E   (hex)		eero inc.
+F8BC0E     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+50-E0-39   (hex)		Zyxel Communications Corporation
+50E039     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+B8-57-76   (hex)		lignex1
+B85776     (base 16)		lignex1
+				354-25, Sanhodae-ro
+				Gumi-si  Gyeongsangbuk-do, Korea  39262
+				KR
+
+24-00-FA   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd
+2400FA     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  311100
+				CN
+
+C8-3D-FC   (hex)		AlphaTheta Corporation
+C83DFC     (base 16)		AlphaTheta Corporation
+				6F,Yokohama i-Mark Place, 4-4-5 Minatomirai, Nishi-ku
+				Yokohama  Kanagawa  220-0012
+				JP
+
+E0-19-95   (hex)		Nutanix
+E01995     (base 16)		Nutanix
+				1740 Technology Drive Ste #150
+				San Jose  CA  95110
+				US
+
+F8-51-28   (hex)		SimpliSafe
+F85128     (base 16)		SimpliSafe
+				294 Washington St
+				Boston  MA  02108
+				US
+
+AC-1F-09   (hex)		shenzhen RAKwireless technology  Co.,Ltd
+AC1F09     (base 16)		shenzhen RAKwireless technology  Co.,Ltd
+				Room 506, Bldg B, New Compark, Pingshan First Road, Taoyuan Street,Nanshan District
+				shenzhen  guangdong  518057
+				CN
+
+BC-13-A8   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+BC13A8     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+90-77-EE   (hex)		Cisco Systems, Inc
+9077EE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-13-CC   (hex)		Cisco Systems, Inc
+3C13CC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+94-E3-EE   (hex)		zte corporation
+94E3EE     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D8-DC-40   (hex)		Apple, Inc.
+D8DC40     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-5F-C5   (hex)		Apple, Inc.
+805FC5     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-F9-20   (hex)		Cisco Systems, Inc
+10F920     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+20-69-80   (hex)		Apple, Inc.
+206980     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-32-A8   (hex)		Intel Corporate
+6432A8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+80-19-34   (hex)		Intel Corporate
+801934     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+40-A3-CC   (hex)		Intel Corporate
+40A3CC     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E4-A7-A0   (hex)		Intel Corporate
+E4A7A0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+3C-4D-BE   (hex)		Apple, Inc.
+3C4DBE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-26-2C   (hex)		Apple, Inc.
+48262C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-7D-DA   (hex)		Apple, Inc.
+147DDA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C4-91-0C   (hex)		Apple, Inc.
+C4910C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-99-61   (hex)		Sagemcom Broadband SAS
+6C9961     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+50-C7-09   (hex)		Juniper Networks
+50C709     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+80-6D-97   (hex)		Private
+806D97     (base 16)		Private
+
+64-5D-86   (hex)		Intel Corporate
+645D86     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+18-1D-EA   (hex)		Intel Corporate
+181DEA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+18-56-80   (hex)		Intel Corporate
+185680     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A0-A4-C5   (hex)		Intel Corporate
+A0A4C5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+F4-D1-08   (hex)		Intel Corporate
+F4D108     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+20-79-18   (hex)		Intel Corporate
+207918     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A8-6D-AA   (hex)		Intel Corporate
+A86DAA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+38-00-25   (hex)		Intel Corporate
+380025     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C0-E3-A0   (hex)		Renesas Electronics (Penang) Sdn. Bhd.
+C0E3A0     (base 16)		Renesas Electronics (Penang) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+F4-C1-14   (hex)		Technicolor CH USA Inc.
+F4C114     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+8C-E4-68   (hex)		Guangzhou Sageran Technology Co., Ltd.
+8CE468     (base 16)		Guangzhou Sageran Technology Co., Ltd.
+				Room 1902, Ruian Guangzhou Center, 374 Beijing Road, Yuexiu District
+				Guangzhou  Guangdong  510030
+				CN
+
+C8-B2-9B   (hex)		Intel Corporate
+C8B29B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+6C-6A-77   (hex)		Intel Corporate
+6C6A77     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A4-B1-C1   (hex)		Intel Corporate
+A4B1C1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+34-2E-B7   (hex)		Intel Corporate
+342EB7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+8C-C6-81   (hex)		Intel Corporate
+8CC681     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+CC-F9-E4   (hex)		Intel Corporate
+CCF9E4     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+3C-58-C2   (hex)		Intel Corporate
+3C58C2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E4-5E-37   (hex)		Intel Corporate
+E45E37     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+24-41-8C   (hex)		Intel Corporate
+24418C     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+60-F2-62   (hex)		Intel Corporate
+60F262     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C0-B8-83   (hex)		Intel Corporate
+C0B883     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C8-09-A8   (hex)		Intel Corporate
+C809A8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+90-78-41   (hex)		Intel Corporate
+907841     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+58-A0-23   (hex)		Intel Corporate
+58A023     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D4-D2-52   (hex)		Intel Corporate
+D4D252     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+28-48-E7   (hex)		Huawei Device Co., Ltd.
+2848E7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+04-D3-B0   (hex)		Intel Corporate
+04D3B0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E0-6C-A6   (hex)		Creotech Instruments S.A.
+E06CA6     (base 16)		Creotech Instruments S.A.
+				ul. Gen. L. Okulickiego 7/9
+				Piaseczno  Mazovia  05-500
+				PL
+
+44-68-0C   (hex)		Wacom Co.,Ltd.
+44680C     (base 16)		Wacom Co.,Ltd.
+				Sumitomo Fudosan Shinjuku Grand Tower 31F,8-17-1
+				Nishi-shinjuku,Shinjuku-ku  Tokyo  160-6131
+				JP
+
+98-0E-24   (hex)		Phytium Technology Co.,Ltd.
+980E24     (base 16)		Phytium Technology Co.,Ltd.
+				Building5,XinAn Business Square,Haiyuan Middle Road Binhai New District,
+				Tianjin    300450
+				CN
+
+A8-30-BC   (hex)		Samsung Electronics Co.,Ltd
+A830BC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-63-DE   (hex)		CLOUDWALK TECHNOLOGY CO.,LTD
+0063DE     (base 16)		CLOUDWALK TECHNOLOGY CO.,LTD
+				Five Floors of Block 106, West Jinkai Avenue, Yubei District
+				Chongqing  Chongqing  401120
+				CN
+
+60-A4-23   (hex)		Silicon Laboratories
+60A423     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+78-46-D4   (hex)		Samsung Electronics Co.,Ltd
+7846D4     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-3E-C6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E43EC6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-88-1E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38881E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+2C-DB-07   (hex)		Intel Corporate
+2CDB07     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+98-8D-46   (hex)		Intel Corporate
+988D46     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+E4-26-8B   (hex)		Huawei Device Co., Ltd.
+E4268B     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+68-88-A1   (hex)		Universal Electronics, Inc.
+6888A1     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+00-1E-B2   (hex)		LG Innotek
+001EB2     (base 16)		LG Innotek
+				Hanyang Univ. 1271, Sa-dong, Sangrok-gu
+				Ansan-si  Gyeonggi-do  426-791
+				KR
+
+C0-86-B3   (hex)		Shenzhen Voxtech Co., Ltd.
+C086B3     (base 16)		Shenzhen Voxtech Co., Ltd.
+				Floors 1-4,Factory Building 26,Shancheng Industrial Park,Shiyan Street,Bao'an District,Shenzhen, Guangdong,China
+				Shenzhen     518000
+				CN
+
+44-AD-B1   (hex)		Sagemcom Broadband SAS
+44ADB1     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+1C-98-C1   (hex)		CLOUD NETWORK TECHNOLOGY SINGAPORE PTE. LTD.
+1C98C1     (base 16)		CLOUD NETWORK TECHNOLOGY SINGAPORE PTE. LTD.
+				B22 Building,NO.51 Tongle Road, Shajing Town, Jiangnan District, Nanning, Guangxi Province, China
+				Nanning  Guangxi  530007
+				CN
+
+A0-9B-17   (hex)		Taicang T&W Electronics
+A09B17     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+44-01-BB   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+4401BB     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268? Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+A0-D8-3D   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+A0D83D     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+58-F2-FC   (hex)		Huawei Device Co., Ltd.
+58F2FC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+64-3A-EA   (hex)		Cisco Systems, Inc
+643AEA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+50-70-43   (hex)		BSkyB Ltd
+507043     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+D0-14-11   (hex)		IEEE Registration Authority
+D01411     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+3C-53-D7   (hex)		CEDES AG
+3C53D7     (base 16)		CEDES AG
+				Kantonsstrasse 14
+				Landquart    7302
+				CH
+
+00-E5-E4   (hex)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+00E5E4     (base 16)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+				No.198,First Section,Snow Mountain Avenue, Jinyuan Town, Dayi County
+				Chengdu  Sichuan  611330
+				CN
+
+E8-13-6E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E8136E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-AE-13   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CAE13     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-2E-FE   (hex)		Shenzhen Comnect Technology Co.,LTD
+4C2EFE     (base 16)		Shenzhen Comnect Technology Co.,LTD
+				G Zone, 3/F, Building 1, Baisha High-Tech Park, No. 3011, Shahe Road West, XiLi Street, Nanshan District
+				Shenzhen    518055
+				CN
+
+10-BC-97   (hex)		vivo Mobile Communication Co., Ltd.
+10BC97     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+DC-D4-44   (hex)		Huawei Device Co., Ltd.
+DCD444     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+E0-B2-60   (hex)		TENO NETWORK TECHNOLOGIES COMPANY LIMITED
+E0B260     (base 16)		TENO NETWORK TECHNOLOGIES COMPANY LIMITED
+				RM 1302, 13/F CHEONG K BLDG 84-86 DES VOEUX RD CENTRAL  HONG KONG
+				Hong Kong    999077
+				HK
+
+A4-46-B4   (hex)		Huawei Device Co., Ltd.
+A446B4     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+0C-C8-44   (hex)		Cambridge Mobile Telematics, Inc.
+0CC844     (base 16)		Cambridge Mobile Telematics, Inc.
+				One Broadway, 14th Floor
+				Cambridge  MA  02142
+				US
+
+E8-DA-20   (hex)		Nintendo Co.,Ltd
+E8DA20     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+48-23-35   (hex)		Dialog Semiconductor Hellas SA
+482335     (base 16)		Dialog Semiconductor Hellas SA
+				Achileos 8 & Katsoni Str
+				Kalithea, Athens    17674
+				GR
+
+8C-85-C1   (hex)		Aruba, a Hewlett Packard Enterprise Company
+8C85C1     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+20-A1-71   (hex)		Amazon Technologies Inc.
+20A171     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+7C-F9-A0   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+7CF9A0     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+6C-A4-D1   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+6CA4D1     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+54-AB-3A   (hex)		Quanta Computer Inc.
+54AB3A     (base 16)		Quanta Computer Inc.
+				No.211, Wen Hwa 2nd Rd., Kuei Shan Hsiang, Tao Yuan Shien, Taiwan, R. O. C.
+				Taoyuan  Taiwan  33377
+				TW
+
+E8-9A-8F   (hex)		Quanta Computer Inc.
+E89A8F     (base 16)		Quanta Computer Inc.
+				211, Wen Hwa 2nd Rd.,Kuei Shan, Tao Yuan 
+				TAIPEI    33377
+				TW
+
+EC-6C-9A   (hex)		Arcadyan Corporation
+EC6C9A     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+34-6D-9C   (hex)		Carrier Corporation
+346D9C     (base 16)		Carrier Corporation
+				6304 Thompson Rd
+				East Syracuse  NY  13057
+				US
+
+D4-F7-56   (hex)		zte corporation
+D4F756     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E0-69-3A   (hex)		Innophase Inc.
+E0693A     (base 16)		Innophase Inc.
+				6815 Flanders Drive Suite 150
+				San Diego  CA  92121
+				US
+
+54-88-DE   (hex)		Cisco Systems, Inc
+5488DE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+78-2B-64   (hex)		Bose Corporation
+782B64     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+24-FD-0D   (hex)		Intelbras
+24FD0D     (base 16)		Intelbras
+				BR 101, KM 210
+				São Jose  Santa Catarina  88104-800
+				BR
+
+34-55-94   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+345594     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building, Star-net Science Plaza, Juyuanzhou,
+				FUZHOU  FUJIAN  350002
+				CN
+
+9C-6B-37   (hex)		Renesas Electronics (Penang) Sdn. Bhd.
+9C6B37     (base 16)		Renesas Electronics (Penang) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+A8-37-59   (hex)		Huawei Device Co., Ltd.
+A83759     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+40-AA-56   (hex)		China Dragon Technology Limited
+40AA56     (base 16)		China Dragon Technology Limited
+				B4 Bldg.Haoshan 1st Industry Park,
+				Shenzhen  Guangdong  518104
+				CN
+
+68-54-5A   (hex)		Intel Corporate
+68545A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+3C-E3-E7   (hex)		China Mobile Group Device Co.,Ltd.
+3CE3E7     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+CC-47-BD   (hex)		Rhombus Systems
+CC47BD     (base 16)		Rhombus Systems
+				770 L St, Suite 1480
+				Sacramento  CA  95814
+				US
+
+4C-93-A6   (hex)		IEEE Registration Authority
+4C93A6     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-1E-31   (hex)		infomark
+001E31     (base 16)		infomark
+				5F.,Geown Bldg.,1360-53
+				Seoul  Seocho-dong,Seocho-gu  137-863
+				KR
+
+50-F7-ED   (hex)		Huawei Device Co., Ltd.
+50F7ED     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+4C-B9-9B   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+4CB99B     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road, Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+BC-7E-8B   (hex)		Samsung Electronics Co.,Ltd
+BC7E8B     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+0C-31-DC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C31DC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+40-DD-D1   (hex)		Beautiful Card Corporation
+40DDD1     (base 16)		Beautiful Card Corporation
+				Wenming 1st St.,
+				Taoyuan    33383
+				TW
+
+C0-E7-BF   (hex)		Sichuan AI-Link Technology Co., Ltd.
+C0E7BF     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou, Industrial Park
+				Mianyang  Sichuan  622650
+				CN
+
+54-77-8A   (hex)		Hewlett Packard Enterprise
+54778A     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+24-71-52   (hex)		Dell Inc.
+247152     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-12-B4   (hex)		Work Microwave GmbH
+0012B4     (base 16)		Work Microwave GmbH
+				Rudolf-Diesel-Ring 2
+				Holzkirchen    83607
+				DE
+
+00-40-AB   (hex)		ROLAND DG CORPORATION
+0040AB     (base 16)		ROLAND DG CORPORATION
+				1-1-3 Shinmiyakoda, Kita-ku
+				Hamamatsu-shi  Shizuoka-ken  431-2103
+				JP
+
+64-33-DB   (hex)		Texas Instruments
+6433DB     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A4-06-E9   (hex)		Texas Instruments
+A406E9     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B0-B1-13   (hex)		Texas Instruments
+B0B113     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+4C-AE-EC   (hex)		Guangzhou limee technology co.,LTD
+4CAEEC     (base 16)		Guangzhou limee technology co.,LTD
+				No.2, Yichuang Street, Zhongxin Guangzhou Knowledge City, Huangpu District, Guangzhou
+				Guangzhou  Guangdong  510555
+				CN
+
+7C-8A-E1   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+7C8AE1     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+54-E4-A9   (hex)		BHR Tech GmbH
+54E4A9     (base 16)		BHR Tech GmbH
+				Georg-Franz-Koller-Straße 18
+				Bisamberg    2102
+				AT
+
+20-80-58   (hex)		Ciena Corporation
+208058     (base 16)		Ciena Corporation
+				7035 Ridge Road
+				Hanover  MD  21076
+				US
+
+68-4A-AE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+684AAE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-D7-55   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60D755     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-45-CD   (hex)		IoT Diagnostics
+A445CD     (base 16)		IoT Diagnostics
+				10052 Commerce Park Drive
+				Cincinnati  OH  45246
+				US
+
+94-62-69   (hex)		ARRIS Group, Inc.
+946269     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D0-DD-49   (hex)		Juniper Networks
+D0DD49     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C8-63-FC   (hex)		ARRIS Group, Inc.
+C863FC     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+1C-CC-D6   (hex)		Xiaomi Communications Co Ltd
+1CCCD6     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+A8-C2-52   (hex)		Huawei Device Co., Ltd.
+A8C252     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A0-41-47   (hex)		Huawei Device Co., Ltd.
+A04147     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+1C-AE-CB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1CAECB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-F1-9E   (hex)		Groupe Atlantic
+4CF19E     (base 16)		Groupe Atlantic
+				Ideal Boilers, National Ave
+				Hull  East Yorkshire  HU5 4JB
+				GB
+
+20-36-D7   (hex)		Shanghai Reacheng  Communication Technology Co.,Ltd
+2036D7     (base 16)		Shanghai Reacheng  Communication Technology Co.,Ltd
+				No. 80, Lane 1505 Zuchongzhi Road
+				Shanghai  Shanghai  201203
+				CN
+
+68-07-0A   (hex)		TPVision Europe B.V
+68070A     (base 16)		TPVision Europe B.V
+				Prins Bernhardplein 200
+				Amsterdam  Noord-Holland  1097 JB
+				NL
+
+4C-EB-BD   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+4CEBBD     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+7C-C9-26   (hex)		Wuhan GreeNet Information Service Co.,Ltd.
+7CC926     (base 16)		Wuhan GreeNet Information Service Co.,Ltd.
+				4-6F, Building 2, Phase 6, Optical Valley Software Park, East Lake High-Tech Development Zone
+				Wuhan    430000
+				CN
+
+5C-75-AF   (hex)		Fitbit, Inc.
+5C75AF     (base 16)		Fitbit, Inc.
+				199 Fremont Street, 14th Fl
+				San Francisco  CA  94105
+				US
+
+38-BA-B0   (hex)		Broadcom
+38BAB0     (base 16)		Broadcom
+				1320 Ridder Park
+				San Jose  CA  95131
+				US
+
+70-87-9E   (hex)		Beken Corporation
+70879E     (base 16)		Beken Corporation
+				Building 41, Capital of Tech Leaders, 1387 Zhangdong Road, Zhangjiang High-Tech Park, Pudong New District
+				Shanghai    201203
+				CN
+
+B4-50-62   (hex)		EmBestor Technology Inc.
+B45062     (base 16)		EmBestor Technology Inc.
+				7F, No.1, Chin-Shan 8th St
+				Hsin-Chu, Taiwan    300
+				TW
+
+04-4A-6C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+044A6C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-FB-14   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38FB14     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F0-E4-A2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F0E4A2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-51-89   (hex)		SG Wireless Limited
+7C5189     (base 16)		SG Wireless Limited
+				RM 504 5/F Sun Fung Industrial Building 8-12 Ma Kok Street
+				Tsuen Wan    NA
+				HK
+
+10-63-C8   (hex)		Liteon Technology Corporation
+1063C8     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+58-20-59   (hex)		Xiaomi Communications Co Ltd
+582059     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+90-27-2B   (hex)		Algorab S.r.l.
+90272B     (base 16)		Algorab S.r.l.
+				Via Luigi Negrelli, 21/13
+				Lavis  TN  38015
+				IT
+
+4C-BC-B4   (hex)		ABB SpA - DIN Rail
+4CBCB4     (base 16)		ABB SpA - DIN Rail
+				V.le dell'industria 18
+				Vittuone  Milan  20010
+				IT
+
+94-D5-05   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+94D505     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+74-E1-B6   (hex)		Apple, Inc.
+74E1B6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-A5-2C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+24A52C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-27-59   (hex)		Levven Electronics Ltd.
+482759     (base 16)		Levven Electronics Ltd.
+				9741 54 Ave NW
+				Edmonton  Alberta  T6E 5J4
+				CA
+
+AC-77-13   (hex)		Honeywell Safety Products (Shanghai) Co.,Ltd
+AC7713     (base 16)		Honeywell Safety Products (Shanghai) Co.,Ltd
+				430 Li Bing Road Zhang Jiang Hi-Tech ParkPudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+08-84-9D   (hex)		Amazon Technologies Inc.
+08849D     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+90-BD-E6   (hex)		Quectel Wireless Solutions Co., Ltd.
+90BDE6     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+18-A4-A9   (hex)		Vanu Inc.
+18A4A9     (base 16)		Vanu Inc.
+				81 Hartwell Ave
+				Lexington  MA  02421
+				US
+
+80-E8-2C   (hex)		Hewlett Packard
+80E82C     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+D4-AD-BD   (hex)		Cisco Systems, Inc
+D4ADBD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-40-AE   (hex)		NIIC Technology Co., Ltd.
+2440AE     (base 16)		NIIC Technology Co., Ltd.
+				Room 8218, Building 3#B, No. 268 Furong Road, Jingkai District
+				Hefei    230601
+				CN
+
+F4-0E-01   (hex)		Apple, Inc.
+F40E01     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-95-CE   (hex)		Apple, Inc.
+1495CE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+50-DE-06   (hex)		Apple, Inc.
+50DE06     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-D1-35   (hex)		Xtreme Power Systems
+5CD135     (base 16)		Xtreme Power Systems
+				2440 Kiowa Blvd. N. #102
+				Lake Havasu City  AZ  86403
+				US
+
+78-69-D4   (hex)		Shenyang Vibrotech Instruments Inc.
+7869D4     (base 16)		Shenyang Vibrotech Instruments Inc.
+				No 23-2 Yunfeng St. Tiexi Dist. 
+				Shenyang   Liaoning  110021
+				CN
+
+08-26-97   (hex)		Zyxel Communications Corporation
+082697     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+CC-CC-CC   (hex)		Silicon Laboratories
+CCCCCC     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+CC-66-0A   (hex)		Apple, Inc.
+CC660A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-1D-43   (hex)		Apple, Inc.
+FC1D43     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-CB-9F   (hex)		TECNO MOBILE LIMITED
+64CB9F     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+4C-FB-FE   (hex)		Sercomm Japan Corporation
+4CFBFE     (base 16)		Sercomm Japan Corporation
+				8F, 3-1, YuanQu St., NanKang, Taipei 115, Taiwan
+				Taipei     115
+				TW
+
+C0-CB-F1   (hex)		Mobiwire Mobiles (NingBo) Co., LTD
+C0CBF1     (base 16)		Mobiwire Mobiles (NingBo) Co., LTD
+				No.999 Dacheng East Road, Fenghua District, Ningbo City , Zhejiang Province, PRC
+				Ningbo  Zhejiang  315500
+				CN
+
+FC-7D-6C   (hex)		HYESUNG TECHWIN Co., Ltd
+FC7D6C     (base 16)		HYESUNG TECHWIN Co., Ltd
+				#1509,545,Dunchon-daero, Jungwon-gu
+				Seongnam   Gyeonggi-do  13215
+				KR
+
+E4-7E-9A   (hex)		zte corporation
+E47E9A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+2C-16-BD   (hex)		IEEE Registration Authority
+2C16BD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+30-A8-89   (hex)		DECIMATOR DESIGN
+30A889     (base 16)		DECIMATOR DESIGN
+				UNIT 5 / 11 PRECISION PLACE
+				VINEYARD  NSW  2765
+				AU
+
+B4-A2-EB   (hex)		IEEE Registration Authority
+B4A2EB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+1C-D5-E2   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+1CD5E2     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+00-24-E9   (hex)		Samsung Electronics Co.,Ltd
+0024E9     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3Dong, Yeongtong-Gu
+				Suwon City  Geyonggi Do  443-742
+				KR
+
+68-3B-78   (hex)		Cisco Systems, Inc
+683B78     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+F8-60-F0   (hex)		Aruba, a Hewlett Packard Enterprise Company
+F860F0     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+5C-A1-E0   (hex)		EmbedWay Technologies
+5CA1E0     (base 16)		EmbedWay Technologies
+				6F, Building 8, No 2388, Chenhang Rd, Shanghai
+				Shanghai    201114
+				CN
+
+84-D4-12   (hex)		Palo Alto Networks
+84D412     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+68-AB-09   (hex)		Nokia
+68AB09     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+F4-CE-36   (hex)		Nordic Semiconductor ASA
+F4CE36     (base 16)		Nordic Semiconductor ASA
+				Otto Nielsens veg 12
+				Trondheim    NO-7052
+				NO
+
+B4-60-77   (hex)		Sichuan Changhong Electric Ltd.
+B46077     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+00-F6-20   (hex)		Google, Inc.
+00F620     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+F4-33-28   (hex)		CIMCON Lighting Inc.
+F43328     (base 16)		CIMCON Lighting Inc.
+				35 Crosby Drive
+				Bedford  MA  01730
+				US
+
+7C-94-2A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+7C942A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-B7-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1CB796     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-47-BC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3847BC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-92-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+549209     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-59-09   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+745909     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-5A-C7   (hex)		Cisco Systems, Inc
+5C5AC7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-B7-4B   (hex)		Technicolor CH USA Inc.
+3CB74B     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+00-ED-B8   (hex)		KYOCERA Corporation 
+00EDB8     (base 16)		KYOCERA Corporation 
+				30 Hoji
+				Kitami,  Hokkaido  099-1595
+				JP
+
+9C-99-CD   (hex)		Voippartners
+9C99CD     (base 16)		Voippartners
+				Via di Passolombardo 35
+				Rome     00133
+				IT
+
+C4-C6-03   (hex)		Cisco Systems, Inc
+C4C603     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-A1-3A   (hex)		SES-imagotag
+BCA13A     (base 16)		SES-imagotag
+				St.-Peter-Gürtel 10b
+				Graz    8010
+				AT
+
+28-23-F5   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+2823F5     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhangtang Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+F0-10-AB   (hex)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+F010AB     (base 16)		China Mobile (Hangzhou) Information Technology Co., Ltd.
+				No. 1600 Yuhang Tong Road, Wuchang Street, Yuhang District
+				Hangzhou  Zhejiang  310000
+				CN
+
+B4-DC-09   (hex)		Guangzhou Dawei Communication Co.,Ltd
+B4DC09     (base 16)		Guangzhou Dawei Communication Co.,Ltd
+				Zone A 906#, International Business Incubator, No.3 Juquan Road, Huangpu District
+				Guangzhou  Guangdong  510660
+				CN
+
+98-86-5D   (hex)		Nokia Shanghai Bell Co., Ltd.
+98865D     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai
+				Shanghai     201206
+				CN
+
+7C-B5-9B   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+7CB59B     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+2C-4F-52   (hex)		Cisco Systems, Inc
+2C4F52     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+68-A0-3E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+68A03E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+B8-C3-85   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B8C385     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan     523808
+				CN
+
+4C-E9-E4   (hex)		New H3C Technologies Co., Ltd
+4CE9E4     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+AC-DB-48   (hex)		ARRIS Group, Inc.
+ACDB48     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C8-0D-32   (hex)		Holoplot GmbH
+C80D32     (base 16)		Holoplot GmbH
+				Ringbahnstr. 12, Hof A2
+				Berlin    12099
+				DE
+
+D0-57-94   (hex)		Sagemcom Broadband SAS
+D05794     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+04-D9-F5   (hex)		ASUSTek COMPUTER INC.
+04D9F5     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+B8-91-C9   (hex)		Handreamnet
+B891C9     (base 16)		Handreamnet
+				#1203 Ace High-end Tower II, 61, Digital-ro 26-gil, Guro-Gu
+				Seoul    08389
+				KR
+
+C8-A7-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C8A776     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-00-E2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A400E2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-C4-FC   (hex)		Xiaomi Communications Co Ltd
+B4C4FC     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C8-D6-9D   (hex)		Arab International Optronics
+C8D69D     (base 16)		Arab International Optronics
+				El Salam St. 
+				El Salam City   Cairo  11371
+				EG
+
+40-5B-D8   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+405BD8     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+54-EC-2F   (hex)		Ruckus Wireless
+54EC2F     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+28-99-C7   (hex)		LINDSAY BROADBAND INC
+2899C7     (base 16)		LINDSAY BROADBAND INC
+				2035 2 FISHER DRIVE
+				PETERBOROUGH  Ontario  K9J 6X6
+				CA
+
+FC-BD-67   (hex)		Arista Networks
+FCBD67     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+00-25-7E   (hex)		NEW POS TECHNOLOGY LIMITED
+00257E     (base 16)		NEW POS TECHNOLOGY LIMITED
+				6FRM, 6F, China Economic Trade Building
+				Shenzhen  Guangdong  518000
+				CN
+
+F8-AE-27   (hex)		John Deere Electronic Solutions
+F8AE27     (base 16)		John Deere Electronic Solutions
+				1441 44th St N
+				Fargo  ND  58102
+				US
+
+74-45-CE   (hex)		CRESYN
+7445CE     (base 16)		CRESYN
+				8-22,Jamwon-dong
+				Seoul  Seocho-Gu  #137-902
+				KR
+
+C4-F7-D5   (hex)		Cisco Systems, Inc
+C4F7D5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+1C-64-99   (hex)		Comtrend Corporation
+1C6499     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+10-DC-4A   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+10DC4A     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+88-EF-16   (hex)		ARRIS Group, Inc.
+88EF16     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+8C-A9-6F   (hex)		D&M Holdings Inc.
+8CA96F     (base 16)		D&M Holdings Inc.
+				D&M Building, 2-1 Nisshin-cho
+				Kawasaki-shi  Kanagawa    210-8569
+				JP
+
+7C-D6-61   (hex)		Xiaomi Communications Co Ltd
+7CD661     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+B0-FD-0B   (hex)		IEEE Registration Authority
+B0FD0B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+98-B8-BA   (hex)		LG Electronics (Mobile Communications)
+98B8BA     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+0C-E9-9A   (hex)		ATLS ALTEC
+0CE99A     (base 16)		ATLS ALTEC
+				3 RUE DE LA GUIVERNONE ZI DU VERT GALANT 
+				ST OUEN L AUMONE    95310
+				FR
+
+4C-11-AE   (hex)		Espressif Inc.
+4C11AE     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+8C-89-FA   (hex)		Zhejiang Hechuan Technology Co., Ltd.
+8C89FA     (base 16)		Zhejiang Hechuan Technology Co., Ltd.
+				No. 9, Fucai Road, Longyou Industrial Zone
+				Quzhou  Zhejiang  324000
+				CN
+
+4C-BC-48   (hex)		Cisco Systems, Inc
+4CBC48     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+80-D0-4A   (hex)		Technicolor CH USA Inc.
+80D04A     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+48-D8-75   (hex)		China TransInfo Technology Co., Ltd
+48D875     (base 16)		China TransInfo Technology Co., Ltd
+				Qianfang Building, Phase I, Zhongguancun Software Park, 8 Wangxi Road, Haidian District
+				Beijing    100085
+				CN
+
+D4-78-9B   (hex)		Cisco Systems, Inc
+D4789B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+48-3F-E9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+483FE9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+14-3C-C3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+143CC3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A8-E5-44   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A8E544     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+18-20-D5   (hex)		ARRIS Group, Inc.
+1820D5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+30-50-FD   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+3050FD     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-40-BC   (hex)		ALGORITHMICS LTD.
+0040BC     (base 16)		ALGORITHMICS LTD.
+				3 DRAYTON PARK
+				    ENGLAND
+				GB
+
+00-40-65   (hex)		GTE SPACENET
+004065     (base 16)		GTE SPACENET
+				1700 OLD MEADOW ROAD
+				MCLEAN  VA  22102
+				US
+
+88-E6-4B   (hex)		Juniper Networks
+88E64B     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+D8-D0-90   (hex)		Dell Inc.
+D8D090     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+50-C4-DD   (hex)		BUFFALO.INC
+50C4DD     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+00-84-ED   (hex)		Private
+0084ED     (base 16)		Private
+
+E0-02-A5   (hex)		ABB Robotics
+E002A5     (base 16)		ABB Robotics
+				Hydrovägen 10
+				Västerås    721 68
+				SE
+
+F4-2E-7F   (hex)		Aruba, a Hewlett Packard Enterprise Company
+F42E7F     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+B4-CC-04   (hex)		Piranti
+B4CC04     (base 16)		Piranti
+				126, Beolmal-ro
+				Dongan-gu, Anyang-si, Gyeonggi-do    14057
+				KR
+
+B8-D5-26   (hex)		Zyxel Communications Corporation
+B8D526     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+F0-B9-68   (hex)		ITEL MOBILE LIMITED
+F0B968     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+04-E5-6E   (hex)		THUB Co., ltd.
+04E56E     (base 16)		THUB Co., ltd.
+				#607 2, Busandaehak-ro 63beon-gil, Geumjeong-gu
+				Busan    46241
+				KR
+
+1C-7F-2C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C7F2C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+88-BC-C1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88BCC1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-BF-CE   (hex)		Shenzhen Century Xinyang Technology Co., Ltd
+1CBFCE     (base 16)		Shenzhen Century Xinyang Technology Co., Ltd
+				3F, North Building, Bantian High-tech industrial Zone, No. 2 of Bell Road
+				Shenzhen  Guangdong  518129
+				CN
+
+F8-30-02   (hex)		Texas Instruments
+F83002     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A8-A1-59   (hex)		ASRock Incorporation
+A8A159     (base 16)		ASRock Incorporation
+				2F., No. 37, Sec. 2, Jhongyang S. Rd., Beitou District,
+				Taipei    112
+				TW
+
+EC-AD-E0   (hex)		D-Link International
+ECADE0     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+78-DA-07   (hex)		Zhejiang Tmall Technology Co., Ltd.
+78DA07     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, 
+				Shenzhen  Guangdong  518000
+				CN
+
+44-A6-1E   (hex)		INGRAM MICRO SERVICES
+44A61E     (base 16)		INGRAM MICRO SERVICES
+				100 CHEMIN DE BAILLOT
+				MONTAUBAN    82000
+				FR
+
+38-D2-CA   (hex)		Zhejiang Tmall Technology Co., Ltd.
+38D2CA     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, Shenzhen Guangdong province
+				Shenzhen  GuangDong  518000
+				CN
+
+10-9E-3A   (hex)		Zhejiang Tmall Technology Co., Ltd.
+109E3A     (base 16)		Zhejiang Tmall Technology Co., Ltd.
+				Ali Center,No.3331 Keyuan South RD (Shenzhen bay), Nanshan District, 
+				Shenzhen  Guangdong  518000
+				CN
+
+90-4D-C3   (hex)		Flonidan A/S
+904DC3     (base 16)		Flonidan A/S
+				Islandsvej 29
+				Horsens    8700
+				DK
+
+00-0D-F1   (hex)		IONIX INC.
+000DF1     (base 16)		IONIX INC.
+				Ssangyong IT Twin Tower 604, 442-17, Sangdaewon-dong, Jungwon-gu,
+				Seongnam-si  Gyeonggi-do  462-120
+				KR
+
+00-07-7C   (hex)		Westermo Network Technologies AB
+00077C     (base 16)		Westermo Network Technologies AB
+				Stora Sundby
+				Sweden    SE-640 40
+				SE
+
+8C-42-6D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C426D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-F8-91   (hex)		Kaonmedia CO., LTD.
+90F891     (base 16)		Kaonmedia CO., LTD.
+				884-3, Seongnam-daero, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13517
+				KR
+
+44-5D-5E   (hex)		SHENZHEN Coolkit Technology CO.,LTD
+445D5E     (base 16)		SHENZHEN Coolkit Technology CO.,LTD
+				B09 2nd Floor, T6 ArtZone XiLi, Nanshan Dist
+				shenzhen  guangdong  518110
+				CN
+
+50-AD-71   (hex)		Tessolve Semiconductor Private Limited
+50AD71     (base 16)		Tessolve Semiconductor Private Limited
+				Plot No: 31, P2, Electronic City Phase II, Electronic City
+				Bengaluru  Karnataka  560100
+				IN
+
+20-2A-C5   (hex)		Petite-En
+202AC5     (base 16)		Petite-En
+				1, Gwanak-ro, Gwanak-gu
+				Seoul    08826
+				KR
+
+A8-BF-3C   (hex)		HDV Phoelectron Technology Limited
+A8BF3C     (base 16)		HDV Phoelectron Technology Limited
+				 Room 1103, Hang Seng Mongkok Building, 677 Nathan Road,Mongkok
+				Kowloon  Hong Kong  518103
+				CN
+
+D4-F5-27   (hex)		SIEMENS AG
+D4F527     (base 16)		SIEMENS AG
+				Oestliche Rheinbrückenstraße 50
+				Karlsruhe  Baden-Württemberg  76181
+				DE
+
+B8-B2-F8   (hex)		Apple, Inc.
+B8B2F8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-46-0A   (hex)		Apple, Inc.
+98460A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-5D-0A   (hex)		Apple, Inc.
+B85D0A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-9A-1D   (hex)		Apple, Inc.
+7C9A1D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-30-25   (hex)		Apple, Inc.
+103025     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-AC-D7   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+70ACD7     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+54-62-E2   (hex)		Apple, Inc.
+5462E2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-9D-99   (hex)		Apple, Inc.
+149D99     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-7B-AC   (hex)		Nokia
+147BAC     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+90-6D-05   (hex)		BXB ELECTRONICS CO., LTD
+906D05     (base 16)		BXB ELECTRONICS CO., LTD
+				6F.-1, NO.288-5, Xinya Rd., Qianzhen Dist.
+				Kaohsiung    80673
+				TW
+
+D4-BB-C8   (hex)		vivo Mobile Communication Co., Ltd.
+D4BBC8     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+48-95-07   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+489507     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+24-BF-74   (hex)		Private
+24BF74     (base 16)		Private
+
+CC-DC-55   (hex)		Dragonchip Limited
+CCDC55     (base 16)		Dragonchip Limited
+				Room 601-2, 6/F, IC Development Centre, No. 6 Science Park West Avenue, Hong Kong Science Park, Shatin, N.T.
+				Hong Kong    NA
+				HK
+
+28-FF-B2   (hex)		Toshiba Corp.
+28FFB2     (base 16)		Toshiba Corp.
+				1-1 Shibaura 1-Chome, Minato-Ku
+				Tokyo    105-8001
+				JP
+
+1C-60-D2   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+1C60D2     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+F4-B5-AA   (hex)		zte corporation
+F4B5AA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+E8-AC-AD   (hex)		zte corporation
+E8ACAD     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+08-36-C9   (hex)		NETGEAR
+0836C9     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+74-5B-C5   (hex)		IEEE Registration Authority
+745BC5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+94-40-C9   (hex)		Hewlett Packard Enterprise
+9440C9     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+A0-41-A7   (hex)		NL Ministry of Defense
+A041A7     (base 16)		NL Ministry of Defense
+				PO Box 10000
+				  Noord Holland  1780 CA Den Helder
+				NL
+
+E4-46-DA   (hex)		Xiaomi Communications Co Ltd
+E446DA     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+1C-12-B0   (hex)		Amazon Technologies Inc.
+1C12B0     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+4C-C8-A1   (hex)		Cisco Meraki
+4CC8A1     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+4C-BC-98   (hex)		IEEE Registration Authority
+4CBC98     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+2C-F4-32   (hex)		Espressif Inc.
+2CF432     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+64-73-66   (hex)		Shenzhen Siera Technology Ltd
+647366     (base 16)		Shenzhen Siera Technology Ltd
+				Room 2039, Shenhai Building, Wanzhong Village, Bulong Road, Minzhi, Longhua district,  City: Shenzhen
+				Shenzhen  Guangdong  518131
+				CN
+
+04-1E-FA   (hex)		BISSELL Homecare, Inc.
+041EFA     (base 16)		BISSELL Homecare, Inc.
+				2345 Walker Ave NW
+				Grand Rapids  MI  49544
+				US
+
+D8-55-75   (hex)		Samsung Electronics Co.,Ltd
+D85575     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-11-A3   (hex)		Samsung Electronics Co.,Ltd
+D411A3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-BA-8D   (hex)		Samsung Electronics Co.,Ltd
+04BA8D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+74-4D-28   (hex)		Routerboard.com
+744D28     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+00-A0-85   (hex)		Private
+00A085     (base 16)		Private
+
+E0-5A-9F   (hex)		IEEE Registration Authority
+E05A9F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-5A-F8   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+8C5AF8     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+D4-58-00   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D45800     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+90-84-2B   (hex)		LEGO System A/S
+90842B     (base 16)		LEGO System A/S
+				Aastvej 1
+				Billund    DK-7190
+				DK
+
+00-26-7E   (hex)		PARROT SA
+00267E     (base 16)		PARROT SA
+				174 Quai de Jemmapes
+				Paris    75010
+				FR
+
+2C-55-7C   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+2C557C     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+F4-BC-DA   (hex)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+F4BCDA     (base 16)		Shenzhen Jingxun Software Telecommunication Technology Co.,Ltd
+				3/F,A5 Building Zhiyuan Community No.1001,Xueyuan Road Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+00-09-15   (hex)		CAS Corp.
+000915     (base 16)		CAS Corp.
+				#19, Ganap-Ri
+				Yangju-Gun  Kyunggi-Do  482-841
+				KR
+
+58-D9-C3   (hex)		Motorola Mobility LLC, a Lenovo Company
+58D9C3     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+2C-73-A0   (hex)		Cisco Systems, Inc
+2C73A0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-3E-07   (hex)		Electrolux
+443E07     (base 16)		Electrolux
+				Corso Lino Zanussi 24
+				Porcia  PORDENONE  33080
+				IT
+
+84-85-E6   (hex)		Guangdong Asano Technology CO.,Ltd.
+8485E6     (base 16)		Guangdong Asano Technology CO.,Ltd.
+				Changsheng Road, Songxia Industrial Park, Songgang, Shishan Town, Nanhai
+				 Foshan   Guangdong, China.  528200
+				CN
+
+3C-83-75   (hex)		Microsoft Corporation
+3C8375     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+00-0A-A8   (hex)		ePipe Pty. Ltd.
+000AA8     (base 16)		ePipe Pty. Ltd.
+				P.O. Box 1428
+				Brisbane  Queensland  4066
+				AU
+
+00-29-C2   (hex)		Cisco Systems, Inc
+0029C2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-7C-0B   (hex)		Ruckus Wireless
+187C0B     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+D4-7B-35   (hex)		NEO Monitors AS
+D47B35     (base 16)		NEO Monitors AS
+				PoBox 384
+				Loerenskog  Loerenskog  1471
+				NO
+
+00-08-78   (hex)		Benchmark Storage Innovations
+000878     (base 16)		Benchmark Storage Innovations
+				3122 Sterling Circle
+				Boulder  CO  80301
+				US
+
+6C-F3-7F   (hex)		Aruba, a Hewlett Packard Enterprise Company
+6CF37F     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+14-07-08   (hex)		Private
+140708     (base 16)		Private
+
+78-A7-EB   (hex)		1MORE
+78A7EB     (base 16)		1MORE
+				TianliaoBuilding F14
+				New Materials Industrial Park,Xueyuan Blvd  Shenzhen, Nanshan District  518005
+				CN
+
+48-5D-36   (hex)		Verizon 
+485D36     (base 16)		Verizon 
+				One Verizon Way
+				Basking Ridge  NJ  07030
+				US
+
+20-C0-47   (hex)		Verizon 
+20C047     (base 16)		Verizon 
+				One Verizon Way
+				Basking Ridge    07030
+				US
+
+34-6B-46   (hex)		Sagemcom Broadband SAS
+346B46     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+7C-60-4A   (hex)		Avelon
+7C604A     (base 16)		Avelon
+				Bändliweg 20
+				Zurich    8048
+				CH
+
+18-64-72   (hex)		Aruba, a Hewlett Packard Enterprise Company
+186472     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+84-D4-7E   (hex)		Aruba, a Hewlett Packard Enterprise Company
+84D47E     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+24-DE-C6   (hex)		Aruba, a Hewlett Packard Enterprise Company
+24DEC6     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+00-17-A0   (hex)		RoboTech srl
+0017A0     (base 16)		RoboTech srl
+				Via Mazzini 82
+				Sarzana (SP)    I-19038
+				IT
+
+10-3D-0A   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+103D0A     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+94-27-90   (hex)		TCT mobile ltd
+942790     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+A4-17-91   (hex)		Shenzhen Decnta Technology Co.,LTD.
+A41791     (base 16)		Shenzhen Decnta Technology Co.,LTD.
+				F13,No.02,Building Shangqi,Nanhaidadao 4050 Nanshan District,Shenzhen,P.R.China
+				shenzhen  Guangdong  518057
+				CN
+
+34-DA-B7   (hex)		zte corporation
+34DAB7     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+10-9C-70   (hex)		Prusa Research s.r.o.
+109C70     (base 16)		Prusa Research s.r.o.
+				Partyzanska 188/7a
+				Prague    17000
+				CZ
+
+E8-4C-56   (hex)		INTERCEPT SERVICES LIMITED
+E84C56     (base 16)		INTERCEPT SERVICES LIMITED
+				Bates Mill, Colne Road
+				Huddersfield  North Yorkshire  HD1 3AG
+				GB
+
+A4-19-08   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+A41908     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+38-AF-D0   (hex)		Private
+38AFD0     (base 16)		Private
+
+80-D3-36   (hex)		CERN
+80D336     (base 16)		CERN
+				CH-1211 
+				GENEVE  SUISSE/SWITZ  023
+				CH
+
+64-25-5E   (hex)		Observint Technologies, Inc.
+64255E     (base 16)		Observint Technologies, Inc.
+				11000 N Mopac Expressway Suite 300
+				Austin  TX  78759
+				US
+
+90-94-0A   (hex)		Analog Devices, Inc
+90940A     (base 16)		Analog Devices, Inc
+				Unit 2200, Airport Business Park, Kinsale Road
+				Cork    T12 X36X
+				IE
+
+40-B0-76   (hex)		ASUSTek COMPUTER INC.
+40B076     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+D4-3D-39   (hex)		Dialog Semiconductor
+D43D39     (base 16)		Dialog Semiconductor
+				B-7F, SiliconPark, 35, Pangyo-ro 255beon-gil, Bundang-gu
+				Seongnam-si  Gyeonggi-do  13486
+				KR
+
+00-14-A5   (hex)		Gemtek Technology Co., Ltd.
+0014A5     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road
+				Hukou, Hsinchu    303
+				TW
+
+C0-B5-D7   (hex)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+C0B5D7     (base 16)		CHONGQING FUGUI ELECTRONICS CO.,LTD.
+				Building D21,No.1, East Zone 1st Road,Xiyong Town,Shapingba District
+				Chongqing  Chongqing  401332
+				CN
+
+D4-AD-71   (hex)		Cisco Systems, Inc
+D4AD71     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+70-2B-1D   (hex)		E-Domus International Limited
+702B1D     (base 16)		E-Domus International Limited
+				1st Floor
+				London    W1W 7BL
+				GB
+
+F0-85-C1   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+F085C1     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A,6/F,Baotian Rd3,Xixiang Town,Baoan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+60-38-0E   (hex)		ALPS ELECTRIC CO., LTD.
+60380E     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi
+				Soma-city  Fukushima  976-8501
+				JP
+
+FC-62-B9   (hex)		ALPS ELECTRIC CO., LTD.
+FC62B9     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				kakuda-city  Miyagi-Pref  981-1595
+				JP
+
+00-02-C7   (hex)		ALPS ELECTRIC CO., LTD.
+0002C7     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi, Sama-City,
+				Sama    00000
+				JP
+
+00-1E-3D   (hex)		ALPS ELECTRIC CO., LTD.
+001E3D     (base 16)		ALPS ELECTRIC CO., LTD.
+				1-2-1, Okinouchi,
+				Soma-city,  Fukushima-pref.,  976-8501
+				JP
+
+28-A1-83   (hex)		ALPS ELECTRIC CO., LTD.
+28A183     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+4C-DD-7D   (hex)		LHP Telematics LLC
+4CDD7D     (base 16)		LHP Telematics LLC
+				17406 Tiller Ct. STE 100
+				westfield  IN  46074
+				US
+
+48-F0-7B   (hex)		ALPS ELECTRIC CO., LTD.
+48F07B     (base 16)		ALPS ELECTRIC CO., LTD.
+				6-1
+				Kakuda  Miyagi-Pref  981-1595
+				JP
+
+B8-BC-5B   (hex)		Samsung Electronics Co.,Ltd
+B8BC5B     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+10-8E-BA   (hex)		Molekule
+108EBA     (base 16)		Molekule
+				1184 Harrison Street
+				San Francisco    94103
+				US
+
+4C-21-8C   (hex)		Panasonic India Private limited
+4C218C     (base 16)		Panasonic India Private limited
+				12th floor, Ambience tower, Ambience Island
+				Gurgaon  Haryana  122002
+				IN
+
+2C-4E-7D   (hex)		Chunghua Intelligent Network Equipment Inc.
+2C4E7D     (base 16)		Chunghua Intelligent Network Equipment Inc.
+				2F-3, No.5, Sec. 3, New Taipei Blvd.,, XinZhung Dist, 
+				New Taipei City  選擇州  242
+				TW
+
+A4-F4-65   (hex)		ITEL MOBILE LIMITED
+A4F465     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+4C-91-7A   (hex)		IEEE Registration Authority
+4C917A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F4-8C-EB   (hex)		D-Link International
+F48CEB     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+74-3A-65   (hex)		NEC Corporation
+743A65     (base 16)		NEC Corporation
+				7-1, Shiba 5-chome, Minato-ku
+				Tokyo    108-8001
+				JP
+
+00-25-5C   (hex)		NEC Corporation
+00255C     (base 16)		NEC Corporation
+				1753, Shimonumabe, Nakahara-Ku, Kawasaki
+				Kanagawa    211-8666
+				JP
+
+68-4F-64   (hex)		Dell Inc.
+684F64     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+CC-70-ED   (hex)		Cisco Systems, Inc
+CC70ED     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+90-7E-30   (hex)		LARS
+907E30     (base 16)		LARS
+				Swierkowa 14
+				Niepruszewo    64-320
+				PL
+
+84-EB-3E   (hex)		Vivint Smart Home
+84EB3E     (base 16)		Vivint Smart Home
+				4931 N. 300 W.
+				Provo  UT  84604
+				US
+
+00-A0-D5   (hex)		Sierra Wireless
+00A0D5     (base 16)		Sierra Wireless
+				13811 Wireless Way
+				Richmond  RICHMOND B.C.  V6V 3A4
+				CA
+
+18-BB-26   (hex)		FN-LINK TECHNOLOGY LIMITED
+18BB26     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+18-B9-05   (hex)		Hong Kong Bouffalo Lab Limited
+18B905     (base 16)		Hong Kong Bouffalo Lab Limited
+				RM 1903, 19/F Lee Garden One 33 Hysan Avenue, Causeway Bay
+				HongKong    999077
+				HK
+
+EC-F0-FE   (hex)		zte corporation
+ECF0FE     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+94-A4-0C   (hex)		Diehl Metering GmbH
+94A40C     (base 16)		Diehl Metering GmbH
+				Industriestrasse 13
+				Ansbach    91522
+				DE
+
+70-B3-17   (hex)		Cisco Systems, Inc
+70B317     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B0-02-47   (hex)		AMPAK Technology, Inc.
+B00247     (base 16)		AMPAK Technology, Inc.
+				3F.,No.15-1 Zhonghua Road,Hsinchu Industrial Park, Hukou,Hsinchu
+				Hsinchu  Taiwan ROC.  30352
+				TW
+
+BC-E7-96   (hex)		Wireless CCTV Ltd
+BCE796     (base 16)		Wireless CCTV Ltd
+				charles Babbage house
+				Rochdale  Greater Manchester  ol164nw
+				GB
+
+94-8F-CF   (hex)		ARRIS Group, Inc.
+948FCF     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A8-F5-DD   (hex)		ARRIS Group, Inc.
+A8F5DD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+44-D3-AD   (hex)		Shenzhen TINNO Mobile Technology Corp.
+44D3AD     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F, H-3 Building, Qiao Cheng Eastern Industrial Park, Overseas Chinese Town, Shenzhen 
+				Shenzhen   guangdong  518053
+				CN
+
+9C-82-75   (hex)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+9C8275     (base 16)		Yichip Microelectronics (Hangzhou) Co.,Ltd
+				Room 401, Building 15, No.498 Guoshoujing Road, Pudong Software Park
+				Shanghai    200120
+				CN
+
+5C-CB-CA   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+5CCBCA     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building, Star-net Science Plaza, Juyuanzhou,
+				FUZHOU  FUJIAN  350002
+				CN
+
+28-E9-8E   (hex)		Mitsubishi Electric Corporation
+28E98E     (base 16)		Mitsubishi Electric Corporation
+				2-7-3 Marunouchi Chiyoda-ku
+				Tokyo    100-8310
+				JP
+
+34-F8-E7   (hex)		Cisco Systems, Inc
+34F8E7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B0-90-7E   (hex)		Cisco Systems, Inc
+B0907E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-73-60   (hex)		Earda Technologies co Ltd
+2C7360     (base 16)		Earda Technologies co Ltd
+				Block A,Lianfeng Creative Park, #2 Jisheng Rd., Nansha District
+				Guangzhou  Guangdong  511455
+				CN
+
+50-8C-F5   (hex)		China Mobile Group Device Co.,Ltd.
+508CF5     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+1C-54-9E   (hex)		Universal Electronics, Inc.
+1C549E     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+E4-CA-12   (hex)		zte corporation
+E4CA12     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-9E-05   (hex)		zte corporation
+D49E05     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+58-5F-F6   (hex)		zte corporation
+585FF6     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+40-B3-0E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+40B30E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+04-CE-7E   (hex)		NXP France Semiconductors France
+04CE7E     (base 16)		NXP France Semiconductors France
+				Parc les Algorithmes,Saint Aubin
+				Gif sur Yvette    91193
+				FR
+
+C0-9A-D0   (hex)		Apple, Inc.
+C09AD0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+94-B0-1F   (hex)		Apple, Inc.
+94B01F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-CC-4D   (hex)		Shenzhen mantunsci co., LTD
+98CC4D     (base 16)		Shenzhen mantunsci co., LTD
+				3 floor, 3 environmental protection industrial park, Nanshan District
+				Shenzhen   Guangdong  518000
+				CN
+
+C0-1B-23   (hex)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+C01B23     (base 16)		SICHUAN TIANYI COMHEART TELECOM CO.,LTD
+				NO.198 FIRST SECTION,SNOW MOUNTAIN AVENUE, JINYUAN TOWN, DAYI COUNTY,
+				CHENGDU  SICHUAN  611330
+				CN
+
+B8-C7-4A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B8C74A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+D8-CE-3A   (hex)		Xiaomi Communications Co Ltd
+D8CE3A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+10-2C-6B   (hex)		AMPAK Technology, Inc.
+102C6B     (base 16)		AMPAK Technology, Inc.
+				3F.,No.15-1 Zhonghua Road,Hsinchu Industrial Park, Hukou,Hsinchu, Taiwan (R.O.C.)
+				Hsinchu  Taiwan ROC.  30352
+				TW
+
+74-85-C4   (hex)		New H3C Technologies Co., Ltd
+7485C4     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+94-F6-D6   (hex)		Apple, Inc.
+94F6D6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-2D-7C   (hex)		Apple, Inc.
+F82D7C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-BA-E4   (hex)		Shanghai MXCHIP Information Technology Co., Ltd.
+D0BAE4     (base 16)		Shanghai MXCHIP Information Technology Co., Ltd.
+				Room 811,Tongpu Building
+				Shanghai  Shanghai  200333
+				CN
+
+48-D3-5D   (hex)		Private
+48D35D     (base 16)		Private
+
+80-FB-F0   (hex)		Quectel Wireless Solutions Co., Ltd.
+80FBF0     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+C0-13-2B   (hex)		Sichuan Changhong Electric Ltd.
+C0132B     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+0C-B4-A4   (hex)		Xintai Automobile Intelligent Network Technology
+0CB4A4     (base 16)		Xintai Automobile Intelligent Network Technology
+				Room3703E Changfu Jinmao Building，Shihua Road
+				Futian Duty Free Zone，Fubao Street，Futian District  Shenzhen City  518000
+				CN
+
+90-63-3B   (hex)		Samsung Electronics Co.,Ltd
+90633B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+FC-AA-B6   (hex)		Samsung Electronics Co.,Ltd
+FCAAB6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-2E-47   (hex)		Suzhou SmartChip Semiconductor Co., LTD
+C82E47     (base 16)		Suzhou SmartChip Semiconductor Co., LTD
+				9A,Science Plaza,1355 JinJiHu Avenue, Suzhou Industrial Park,
+				Suzhou   Jiangsu  215021
+				CN
+
+C0-22-50   (hex)		Koss Corporation
+C02250     (base 16)		Koss Corporation
+				4129 N. Port Washington Ave.
+				Milwaukee  WI  53212
+				US
+
+A0-B5-49   (hex)		Arcadyan Corporation
+A0B549     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+00-1F-5A   (hex)		Beckwith Electric Co.
+001F5A     (base 16)		Beckwith Electric Co.
+				6190 118th Ave No
+				Largo  Florida  33773
+				US
+
+98-5D-82   (hex)		Arista Networks
+985D82     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+24-53-BF   (hex)		Enernet
+2453BF     (base 16)		Enernet
+				1007 B-dong, Hyundai Knowledge Industry Center, 70 Dusan-ro, Geumcheon-gu, Seoul, KOREA
+				SEOUL    08584
+				KR
+
+04-33-85   (hex)		Nanchang BlackShark Co.,Ltd.
+043385     (base 16)		Nanchang BlackShark Co.,Ltd.
+				Room 319, Jiaoqiao Town Office Building, Economic and Technical development zone, Nanchang City, Jiangxi Province.
+				Nanchang    330013
+				CN
+
+84-E5-D8   (hex)		Guangdong UNIPOE IoT Technology Co.,Ltd.
+84E5D8     (base 16)		Guangdong UNIPOE IoT Technology Co.,Ltd.
+				11th Fl., BLDG. B1, Guangda WE Valley, Songshan Lake District
+				Dongguan  Guangdong  523808
+				CN
+
+A8-BC-9C   (hex)		Cloud Light Technology Limited
+A8BC9C     (base 16)		Cloud Light Technology Limited
+				3/F, 6 Science Park East Avenue Hong Kong Science Park Shatin, N.T., Hong Kong
+				Hong Kong    00000
+				HK
+
+A8-90-42   (hex)		Beijing Wanwei Intelligent Technology Co., Ltd.
+A89042     (base 16)		Beijing Wanwei Intelligent Technology Co., Ltd.
+				Room 616, Section 1, Cuicing, No. 1 Shanyuan Street, Haidian District
+				Beijing  Beijing  100000
+				CN
+
+18-BE-92   (hex)		Delta Networks, Inc.
+18BE92     (base 16)		Delta Networks, Inc.
+				256 Yang Guang Street, Neihu
+				Taipei  Taiwan  11491
+				TW
+
+90-C5-4A   (hex)		vivo Mobile Communication Co., Ltd.
+90C54A     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+BC-75-96   (hex)		Beijing Broadwit Technology Co., Ltd.
+BC7596     (base 16)		Beijing Broadwit Technology Co., Ltd.
+				Beijing Changping District Beijing International Information Industry Base Jizhida Building 3rd Floor Southeast
+				Beijing  Beijing  10000
+				CN
+
+1C-34-DA   (hex)		Mellanox Technologies, Inc.
+1C34DA     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+2C-A0-2F   (hex)		Veroguard Systems Pty Ltd
+2CA02F     (base 16)		Veroguard Systems Pty Ltd
+				PO Box 5003
+				Clayton  VIC  3168
+				AU
+
+6C-5C-3D   (hex)		IEEE Registration Authority
+6C5C3D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+78-23-27   (hex)		Samsung Electronics Co.,Ltd
+782327     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+DC-F7-56   (hex)		Samsung Electronics Co.,Ltd
+DCF756     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+68-A4-7D   (hex)		Sun Cupid Technology (HK) LTD
+68A47D     (base 16)		Sun Cupid Technology (HK) LTD
+				16/F, CEO Tower, 77 Wing Hong Street, Kowloon
+				Hong Kong    00000
+				HK
+
+18-4B-0D   (hex)		Ruckus Wireless
+184B0D     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+D4-12-43   (hex)		AMPAK Technology, Inc.
+D41243     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+48-A6-B8   (hex)		Sonos, Inc.
+48A6B8     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+B8-78-26   (hex)		Nintendo Co.,Ltd
+B87826     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+DC-CB-A8   (hex)		Explora Technologies Inc
+DCCBA8     (base 16)		Explora Technologies Inc
+				360, Franquet Street
+				Quebec    G1P 4N3
+				CA
+
+C0-78-78   (hex)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+C07878     (base 16)		FLEXTRONICS MANUFACTURING(ZHUHAI)CO.,LTD.
+				Xin Qing Science & Technology Industrial Park,Jin An Town,Doumen ,Zhuhai,Guangdong,PRC
+				Zhuhai  Guangdong  519180
+				CN
+
+E4-B9-7A   (hex)		Dell Inc.
+E4B97A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+34-DA-C1   (hex)		SAE Technologies Development(Dongguan) Co., Ltd.
+34DAC1     (base 16)		SAE Technologies Development(Dongguan) Co., Ltd.
+				Winnerway Industrial Area,Nancheng
+				Dongguan City  Guangdong Province  523087
+				CN
+
+70-5D-CC   (hex)		EFM Networks
+705DCC     (base 16)		EFM Networks
+				6F, Benposra II 1197-1 Bojeong Giheung Gu
+				Yong In  Kyunggi do  446913
+				KR
+
+D0-92-FA   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D092FA     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+E8-5A-D1   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E85AD1     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+A8-23-FE   (hex)		LG Electronics
+A823FE     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+E0-5D-5C   (hex)		Oy Everon Ab
+E05D5C     (base 16)		Oy Everon Ab
+				Teräskatu 8
+				Turku    20520
+				FI
+
+68-8F-2E   (hex)		Hitron Technologies. Inc
+688F2E     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+E0-46-E5   (hex)		Gosuncn Technology Group Co., Ltd.
+E046E5     (base 16)		Gosuncn Technology Group Co., Ltd.
+				6F, 2819 KaiChuang Blvd., Science Town, Huangpu District
+				Guangzhou City   Guangdong  510530
+				CN
+
+1C-59-9B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C599B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-BD-1E   (hex)		5VT Technologies,Taiwan LTd.
+D4BD1E     (base 16)		5VT Technologies,Taiwan LTd.
+				6F,No.19-9,SanChong Rd.,Nangang Dist,
+				Taipei    11501
+				TW
+
+BC-9B-68   (hex)		Technicolor CH USA Inc.
+BC9B68     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+CC-D4-A1   (hex)		MitraStar Technology Corp.
+CCD4A1     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+08-BA-5F   (hex)		Qingdao Hisense Electronics Co.,Ltd.
+08BA5F     (base 16)		Qingdao Hisense Electronics Co.,Ltd.
+				Qianwangang Roard 218
+				Qingdao  Shandong  266510
+				CN
+
+10-DF-FC   (hex)		Siemens AG
+10DFFC     (base 16)		Siemens AG
+				Siemensstrasse 10
+				Regensburg    93055
+				DE
+
+84-7F-3D   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+847F3D     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+C4-FD-E6   (hex)		DRTECH
+C4FDE6     (base 16)		DRTECH
+				29, Dunchon-daero 541beon-gil, Jungwon-gu
+				Seongnam  Gyeonggi-do  13216
+				KR
+
+CC-98-8B   (hex)		SONY Visual Products Inc.
+CC988B     (base 16)		SONY Visual Products Inc.
+				2-10-1 Osaki
+				Shinagawa-ku  Tokyo  141-8610
+				JP
+
+30-E3-D6   (hex)		Spotify USA Inc.
+30E3D6     (base 16)		Spotify USA Inc.
+				45 West 18th Street
+				New York  NY  10011
+				US
+
+9C-A5-25   (hex)		Shandong USR IOT Technology Limited
+9CA525     (base 16)		Shandong USR IOT Technology Limited
+				Floor 11,Building 1,No.1166 Xinluo  Street,Gaoxin District,Jinan,Shandong,250101,China
+				Jinan  Shandong  250101
+				CN
+
+E0-45-6D   (hex)		China Mobile Group Device Co.,Ltd.
+E0456D     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+28-39-26   (hex)		CyberTAN Technology Inc.
+283926     (base 16)		CyberTAN Technology Inc.
+				99 Park Ave III, Hsinchu Science Park
+				Hsinchu    308
+				TW
+
+8C-FC-A0   (hex)		Shenzhen Smart Device Technology Co., LTD.
+8CFCA0     (base 16)		Shenzhen Smart Device Technology Co., LTD.
+				SSMEC Building,Gao Xin Nan First Avenue Hi-Tech Park South,Nanshan
+				Shenzhen  GuangDong  518057
+				CN
+
+1C-42-7D   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+1C427D     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+80-69-33   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+806933     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+BC-26-C7   (hex)		Cisco Systems, Inc
+BC26C7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-5E-A1   (hex)		PsiKick, Inc.
+BC5EA1     (base 16)		PsiKick, Inc.
+				2348 Walsh Ave
+				Santa Clara  CA  95051
+				US
+
+94-4F-4C   (hex)		Sound United LLC
+944F4C     (base 16)		Sound United LLC
+				One Viper Way
+				Vista  CA  92081
+				US
+
+98-18-88   (hex)		Cisco Meraki
+981888     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+18-81-0E   (hex)		Apple, Inc.
+18810E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-8C-4A   (hex)		Apple, Inc.
+608C4A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-B5-87   (hex)		Apple, Inc.
+74B587     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-B6-D8   (hex)		Apple, Inc.
+FCB6D8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-6A-2C   (hex)		IEEE Registration Authority
+3C6A2C     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+24-1B-7A   (hex)		Apple, Inc.
+241B7A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-FE-57   (hex)		Apple, Inc.
+8CFE57     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-A6-00   (hex)		Apple, Inc.
+C0A600     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-E8-29   (hex)		Ubiquiti Networks Inc.
+18E829     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+E0-C2-86   (hex)		Aisai Communication Technology Co., Ltd.
+E0C286     (base 16)		Aisai Communication Technology Co., Ltd.
+				Room 2610 Asia Trade Centre,
+				Kwai Chung  N.T.  852
+				HK
+
+74-05-A5   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+7405A5     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+28-6D-CD   (hex)		Beijing Winner Microelectronics Co.,Ltd. 
+286DCD     (base 16)		Beijing Winner Microelectronics Co.,Ltd. 
+				Floor 18, YinDu Building, No.67 FuCheng Road, HaiDian District
+				Beijing    100142
+				CN
+
+54-10-31   (hex)		SMARTO
+541031     (base 16)		SMARTO
+				25 QUAI GALLIENI
+				SURESNES  HAUT DE SEINE  92150
+				FR
+
+44-A4-66   (hex)		GROUPE LDLC
+44A466     (base 16)		GROUPE LDLC
+				Groupe LDLC - 2 rue des Erables
+				LIMONEST  Rhone  69760
+				FR
+
+D8-0D-17   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D80D17     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+18-C2-BF   (hex)		BUFFALO.INC
+18C2BF     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+E8-1C-BA   (hex)		Fortinet, Inc.
+E81CBA     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale  null  94086
+				US
+
+F0-B0-14   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+F0B014     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+18-89-A0   (hex)		Wuhan Funshion Online Technologies Co.,Ltd
+1889A0     (base 16)		Wuhan Funshion Online Technologies Co.,Ltd
+				5th Floor,Financial Port Building A9,No.77 Optical Valley Avenue, East Lake High-Tech Development Zone, Wuhan
+				Wuhan  CN/Hubei  430000
+				CN
+
+0C-2A-86   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+0C2A86     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+FC-61-E9   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+FC61E9     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+40-56-62   (hex)		GuoTengShengHua Electronics LTD.
+405662     (base 16)		GuoTengShengHua Electronics LTD.
+				1st floor,No. 15 of Tech North 2nd Road,Nanshan District,
+				Shenzhen  Guangdong  518000
+				CN
+
+E4-DB-6D   (hex)		Beijing Xiaomi Electronics Co., Ltd.
+E4DB6D     (base 16)		Beijing Xiaomi Electronics Co., Ltd.
+				Building C, QingHe ShunShiJiaYe Technology Park, #66 ZhuFang Rd, HaiDian District
+				Beijing  Beijing  10085
+				CN
+
+00-A0-D1   (hex)		INVENTEC CORPORATION
+00A0D1     (base 16)		INVENTEC CORPORATION
+				INVENTEC BUILDING
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-18-CC   (hex)		AXIOHM SAS
+0018CC     (base 16)		AXIOHM SAS
+				1 RUE D'ARCUEIL
+				MONTROUGE    92120
+				FR
+
+00-18-27   (hex)		NEC UNIFIED SOLUTIONS NEDERLAND B.V.
+001827     (base 16)		NEC UNIFIED SOLUTIONS NEDERLAND B.V.
+				ANTON PHILIPSWEG 1
+				HILVERSUM  NH  1223KZ
+				NL
+
+00-90-04   (hex)		3COM EUROPE LTD
+009004     (base 16)		3COM EUROPE LTD
+				3COM CENTRE, BOUNDARY WAY
+				HERTS.  HP2 7YU    00000
+				GB
+
+00-06-8C   (hex)		3COM
+00068C     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+02-60-8C   (hex)		3COM
+02608C     (base 16)		3COM
+				5400 BAYFRONT PLAZA
+				SANTA CLARA  CA  95052
+				US
+
+00-D0-D8   (hex)		3COM
+00D0D8     (base 16)		3COM
+				2133 LEGHORN STREET
+				MOUNTAIN VIEW  CA  94043
+				US
+
+18-93-7F   (hex)		AMPAK Technology, Inc.
+18937F     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+A4-35-23   (hex)		Guangdong Donyan Network Technologies Co.,Ltd.
+A43523     (base 16)		Guangdong Donyan Network Technologies Co.,Ltd.
+				No.6,Kejizhong Road,Chuangye Building,Hi-tech Zone
+				Shantou  Guangdong  515000
+				CN
+
+B4-A9-4F   (hex)		MERCURY CORPORATION
+B4A94F     (base 16)		MERCURY CORPORATION
+				90, Gajaeul-ro, Seo-gu
+				INCHEON    22830
+				KR
+
+80-3A-F4   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+803AF4     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+48-A0-F8   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+48A0F8     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+F8-5E-3C   (hex)		SHENZHEN ZHIBOTONG ELECTRONICS CO.,LTD
+F85E3C     (base 16)		SHENZHEN ZHIBOTONG ELECTRONICS CO.,LTD
+				4F,Bldg A2,Hedian Industrial Park,NO.8 Shijing Rd,Guanlan,Longhua District,ShenZhen,China
+				shengzhen    518110
+				CN
+
+28-3E-76   (hex)		Common Networks
+283E76     (base 16)		Common Networks
+				1390 Market St. Suite 820
+				San Francisco  CA  94102
+				US
+
+DC-39-79   (hex)		Cisco Systems, Inc
+DC3979     (base 16)		Cisco Systems, Inc
+				280 Hope Street
+				Mountain View  CA  94041
+				US
+
+58-D5-6E   (hex)		D-Link International
+58D56E     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+0C-53-31   (hex)		ETH Zurich
+0C5331     (base 16)		ETH Zurich
+				Dept. Computer Science, Universitätstr. 6
+				Zurich  ZH  8092
+				CH
+
+DC-90-88   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC9088     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-81-2D   (hex)		PAX Computer Technology(Shenzhen) Ltd.
+54812D     (base 16)		PAX Computer Technology(Shenzhen) Ltd.
+				4/F, No.3 Building, Software Park, Second Central Science-Tech Road, High-Tech
+				Shenzhen  GuangDong  518057
+				CN
+
+0C-9A-42   (hex)		FN-LINK TECHNOLOGY LIMITED
+0C9A42     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+00-08-09   (hex)		Systemonic AG
+000809     (base 16)		Systemonic AG
+				Am Waldschloesschen 1
+				    
+				DE
+
+8C-41-F4   (hex)		IPmotion GmbH
+8C41F4     (base 16)		IPmotion GmbH
+				Ludwig-Rinn-Straße 8-16
+				Heuchelheim  Hessen  35452
+				DE
+
+70-4F-08   (hex)		Shenzhen Huisheng Information Technology Co., Ltd.
+704F08     (base 16)		Shenzhen Huisheng Information Technology Co., Ltd.
+				 Room 4A-205, Software Industry Base, Yuehai St
+				Nanshan District, Shenzhen  Guangdong  518000
+				CN
+
+88-35-C1   (hex)		OI ELECTRIC CO.,LTD
+8835C1     (base 16)		OI ELECTRIC CO.,LTD
+				7-3-16 KIKUNA
+				YOKOHAMA  KANAGAWA-KEN  222-0011
+				JP
+
+30-42-A1   (hex)		ilumisys Inc. DBA Toggled
+3042A1     (base 16)		ilumisys Inc. DBA Toggled
+				1820 E. Big Beaver Road
+				Troy  MI  48083
+				US
+
+00-26-B7   (hex)		Kingston Technology Company, Inc.
+0026B7     (base 16)		Kingston Technology Company, Inc.
+				17600 Newhope St.
+				Fountain Valley  CA  92708
+				US
+
+28-D0-CB   (hex)		Cambridge Communication Systems Ltd
+28D0CB     (base 16)		Cambridge Communication Systems Ltd
+				Victory House, Vision Park, Chivers Way, Histon
+				Cambridge    CB24 9ZR
+				GB
+
+40-62-EA   (hex)		China Mobile Group Device Co.,Ltd.
+4062EA     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+4C-0F-C7   (hex)		Earda Technologies co Ltd
+4C0FC7     (base 16)		Earda Technologies co Ltd
+				5/F,Block 2 East area,Haosheng Industrial Park,
+				Guangzhou  Guangdong  511400
+				CN
+
+80-A7-96   (hex)		Neurotek LLC
+80A796     (base 16)		Neurotek LLC
+				3180 18th St, Ste 200
+				San Francisco  CA  94110
+				US
+
+CC-21-19   (hex)		Samsung Electronics Co.,Ltd
+CC2119     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-23-03   (hex)		Belkin International Inc.
+302303     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  null  90094
+				US
+
+9C-F6-DD   (hex)		IEEE Registration Authority
+9CF6DD     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-1E-80   (hex)		Icotera A/S
+001E80     (base 16)		Icotera A/S
+				Vibeholms Allé 16
+				Brøndby    2605
+				DK
+
+48-88-1E   (hex)		EthoSwitch LLC
+48881E     (base 16)		EthoSwitch LLC
+				1298 Evans Road
+				Wall Township   NJ  07719
+				US
+
+3C-71-BF   (hex)		Espressif Inc.
+3C71BF     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+00-03-93   (hex)		Apple, Inc.
+000393     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-00-C3   (hex)		Harris Corporation
+0000C3     (base 16)		Harris Corporation
+				1025 West NASA Blvd
+				Melbourne  FL  32919
+				US
+
+30-4B-07   (hex)		Motorola Mobility LLC, a Lenovo Company
+304B07     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+34-5A-BA   (hex)		tcloud intelligence
+345ABA     (base 16)		tcloud intelligence
+				Bao'an District, No. 400 Xiangshan Avenue
+				ShenZhen  GuangDong  518105
+				CN
+
+50-2F-A8   (hex)		Cisco Systems, Inc
+502FA8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+90-2B-D2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+902BD2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-D5-9D   (hex)		Sagemcom Broadband SAS
+08D59D     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+C0-83-59   (hex)		IEEE Registration Authority
+C08359     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+EC-83-D5   (hex)		GIRD Systems Inc
+EC83D5     (base 16)		GIRD Systems Inc
+				11260 Chester Road, Ste. 600
+				Cincinnati  OH  45246
+				US
+
+14-94-2F   (hex)		USYS CO.,LTD.
+14942F     (base 16)		USYS CO.,LTD.
+				#911, SeoulTechnoPark, 232, Gongneung-ro, Nowon-gu
+				Seoul    KS013
+				KR
+
+FC-B1-0D   (hex)		Shenzhen Tian Kun Technology Co.,LTD.
+FCB10D     (base 16)		Shenzhen Tian Kun Technology Co.,LTD.
+				Layer 8,Nanyuan Maple Building,No.1088 Nanshan Avenue,Nanshan Street,Nanshan District,Shenzhen
+				Shenzhen  Guangdong  518048
+				CN
+
+20-F7-7C   (hex)		vivo Mobile Communication Co., Ltd.
+20F77C     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+00-1E-EC   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+001EEC     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street
+				KUNSHAN CITY  SUZHOU PROVINCE  215300
+				CN
+
+F0-76-1C   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+F0761C     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 15, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE
+				KUNSHAN  SUZHOU  215300
+				CN
+
+00-04-AE   (hex)		Sullair Corporation
+0004AE     (base 16)		Sullair Corporation
+				3700 East Michigan Blvd
+				Michigan City  IN  46360
+				US
+
+00-45-1D   (hex)		Cisco Systems, Inc
+00451D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-D6-35   (hex)		WBS Technology
+A0D635     (base 16)		WBS Technology
+				Unit32, 2 Slough Ave, Slough Business Park
+				Silverwater  New South Wales  2128
+				AU
+
+34-80-0D   (hex)		Cavium Inc
+34800D     (base 16)		Cavium Inc
+				15485 Sand Canyon Ave
+				Irvine  CA  92618
+				US
+
+B4-4B-D6   (hex)		IEEE Registration Authority
+B44BD6     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D8-91-2A   (hex)		Zyxel Communications Corporation
+D8912A     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+3C-42-7E   (hex)		IEEE Registration Authority
+3C427E     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-0B-A3   (hex)		Siemens AG
+000BA3     (base 16)		Siemens AG
+				Werner-von-Siemens-Straße 65
+				Erlangen  Bavaria  91052
+				DE
+
+00-0C-8A   (hex)		Bose Corporation
+000C8A     (base 16)		Bose Corporation
+				Automotive Systems Division (ASD)
+				Stow  MA  01775-9102
+				US
+
+24-3A-82   (hex)		IRTS
+243A82     (base 16)		IRTS
+				639 BD DES ARMARIS, IRTS
+				TOULON  Provence Alpes Cotes d'Azur  83100
+				FR
+
+88-09-07   (hex)		MKT Systemtechnik GmbH & Co. KG
+880907     (base 16)		MKT Systemtechnik GmbH & Co. KG
+				Hasskampstraße 75-77
+				Bünde  NRW  32257
+				DE
+
+58-A4-8E   (hex)		PixArt Imaging Inc.
+58A48E     (base 16)		PixArt Imaging Inc.
+				No.5, Innovation Road 1, HsinChu Science Park,
+				Hsin-Chu    300
+				TW
+
+30-D6-59   (hex)		Merging Technologies SA
+30D659     (base 16)		Merging Technologies SA
+				Le Verney 4
+				Puidoux  Outside the U.S or Canada  1070
+				CH
+
+70-2A-D5   (hex)		Samsung Electronics Co.,Ltd
+702AD5     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+88-97-65   (hex)		exands
+889765     (base 16)		exands
+				RM2202 , No. 666 Gubei road
+				shanghai    200336
+				CN
+
+38-6E-88   (hex)		zte corporation
+386E88     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+B8-85-84   (hex)		Dell Inc.
+B88584     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+40-EE-DD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+40EEDD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-18-86   (hex)		SmarDTV
+B01886     (base 16)		SmarDTV
+				Route de Genève 22
+				Cheseaux    CH-1033 
+				CH
+
+AC-75-1D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC751D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-9E-97   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+289E97     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-15-25   (hex)		Chamberlain Access Solutions
+001525     (base 16)		Chamberlain Access Solutions
+				8271 E. Gelding Drive
+				Scottsdale  AZ  85260
+				US
+
+00-1E-B0   (hex)		ImesD Electronica S.L.
+001EB0     (base 16)		ImesD Electronica S.L.
+				d'Entença 81
+				Barcelona    08015
+				ES
+
+64-1C-67   (hex)		DIGIBRAS INDUSTRIA DO BRASILS/A
+641C67     (base 16)		DIGIBRAS INDUSTRIA DO BRASILS/A
+				Rua Tambaqui, 180-B - MANAUS - AM ¨C BRAZIL
+				manaus  MANAUS  69075-210 
+				BR
+
+60-05-8A   (hex)		Hitachi Metals, Ltd.
+60058A     (base 16)		Hitachi Metals, Ltd.
+				Shinagawa Season Terrace, 2-70, Konan 1-chome
+				Minato-ku  Tokyo  108-8224
+				JP
+
+BC-22-FB   (hex)		RF Industries
+BC22FB     (base 16)		RF Industries
+				PO Box 5
+				Welland  SA  5007
+				AU
+
+00-80-B6   (hex)		Mercury Systems – Trusted Mission Solutions, Inc. 
+0080B6     (base 16)		Mercury Systems – Trusted Mission Solutions, Inc. 
+				6681 OWENS DRIVE
+				PLEASONTON  CA  94588
+				US
+
+08-51-2E   (hex)		Orion Diagnostica Oy
+08512E     (base 16)		Orion Diagnostica Oy
+				Koivu-Mankkaan tie 6
+				Espoo    02100
+				FI
+
+98-A4-04   (hex)		Ericsson AB
+98A404     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+00-CC-3F   (hex)		Universal Electronics, Inc.
+00CC3F     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+74-B9-1E   (hex)		Nanjing Bestway Automation System Co., Ltd
+74B91E     (base 16)		Nanjing Bestway Automation System Co., Ltd
+				#50 Baoxiang Road, Jiangning Bin Jiang Economic Development Zone
+				nanjing  jiangsu  211161
+				CN
+
+A0-19-B2   (hex)		IEEE Registration Authority
+A019B2     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+8C-15-C7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C15C7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-FA-9D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60FA9D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+DC-99-14   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+DC9914     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+4C-3F-D3   (hex)		Texas Instruments
+4C3FD3     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B0-53-65   (hex)		China Mobile IOT Company Limited
+B05365     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+30-88-41   (hex)		Sichuan AI-Link Technology Co., Ltd.
+308841     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou,Industrial Park
+				Anzhou,Industrial Park  Sichuan  621000
+				CN
+
+44-EF-CF   (hex)		UGENE SOLUTION inc.
+44EFCF     (base 16)		UGENE SOLUTION inc.
+				A-1508, 1509, 583, Yangcheon-ro, Gangseo-gu
+				Seoul    KS013
+				KR
+
+30-45-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+304596     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C0-F4-E6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C0F4E6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-EB-80   (hex)		Samsung Electronics Co.,Ltd
+74EB80     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-E0-DC   (hex)		Samsung Electronics Co.,Ltd
+0CE0DC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-68-C3   (hex)		Samsung Electronics Co.,Ltd
+D868C3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-93-D9   (hex)		Samsung Electronics Co.,Ltd
+C493D9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-2B-B9   (hex)		Samsung Electronics Co.,Ltd
+A82BB9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-FD-93   (hex)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+ACFD93     (base 16)		WEIFANG GOERTEK ELECTRONICS CO.,LTD
+				Gaoxin 2 Road,Free Trade Zone,Weifang,Shandong,261205,P.R.China
+				Weifang  Shandong  261205
+				CN
+
+68-57-2D   (hex)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+68572D     (base 16)		HANGZHOU AIXIANGJI TECHNOLOGY CO., LTD
+				7 Floor, 3 Blvd., More Centre, 87 Gudun Rd., Xihu District
+				Hangzhou  Zhejiang  310012
+				CN
+
+00-B8-C2   (hex)		Heights Telecom T ltd
+00B8C2     (base 16)		Heights Telecom T ltd
+				Moshe Lerer 15
+				Nes Ziona     7404996
+				IL
+
+F4-BF-80   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4BF80     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-0E-8F   (hex)		Sercomm Corporation.
+000E8F     (base 16)		Sercomm Corporation.
+				3F,No.81,Yu-Yih Rd.,Chu-Nan Chen
+				Miao-Lih Hsuan    115
+				TW
+
+A0-E6-17   (hex)		MATIS
+A0E617     (base 16)		MATIS
+				2/F,Hatchobori MIYATA Bldg.,1-8-2,
+				Shintomi,Chuo-Ku,  Tokyo  104-0041
+				JP
+
+70-01-B5   (hex)		Cisco Systems, Inc
+7001B5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-49   (hex)		Manhattan TV Ltd
+001F49     (base 16)		Manhattan TV Ltd
+				3 Phoenix Park,
+				London    NW2 7LN
+				GB
+
+88-D6-52   (hex)		AMERGINT Technologies
+88D652     (base 16)		AMERGINT Technologies
+				2315 Briargate Pkwy, Suite 100
+				Colorado Springs  CO  80920
+				US
+
+FC-90-FA   (hex)		Independent Technologies
+FC90FA     (base 16)		Independent Technologies
+				1960 Ridgeview Rd
+				Blair  NE  68008
+				US
+
+D0-B2-14   (hex)		PoeWit Inc
+D0B214     (base 16)		PoeWit Inc
+				2307 Sea Island Dr
+				Fort Lauderdale  FL  33301
+				US
+
+C4-24-56   (hex)		Palo Alto Networks
+C42456     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+B4-B6-86   (hex)		Hewlett Packard
+B4B686     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+4C-ED-FB   (hex)		ASUSTek COMPUTER INC.
+4CEDFB     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+7C-2E-BD   (hex)		Google, Inc.
+7C2EBD     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+6C-AF-15   (hex)		Webasto SE
+6CAF15     (base 16)		Webasto SE
+				Kraillinger Straße 5
+				Stockdorf  Bayern  82131
+				DE
+
+E4-E1-30   (hex)		TCT mobile ltd
+E4E130     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+0C-21-38   (hex)		Hengstler GmbH
+0C2138     (base 16)		Hengstler GmbH
+				Uhlandstrasse49
+				Aldingen  BW  78554
+				DE
+
+E4-60-59   (hex)		Pingtek Co., Ltd.
+E46059     (base 16)		Pingtek Co., Ltd.
+				5F., No.786, Zhongzheng Rd., Zhonghe Dist.
+				New Taipei City    235
+				TW
+
+E0-19-1D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E0191D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+68-D1-BA   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+68D1BA     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+1C-1A-C0   (hex)		Apple, Inc.
+1C1AC0     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+30-78-C2   (hex)		Innowireless / QUCELL Networks
+3078C2     (base 16)		Innowireless / QUCELL Networks
+				Innowireless Bldg.  190 Seohyeon-ro
+				Bundang-gu, Seongnam-si  Gyeonggi-do  13590
+				KR
+
+40-50-B5   (hex)		Shenzhen New Species Technology Co., Ltd.
+4050B5     (base 16)		Shenzhen New Species Technology Co., Ltd.
+				Room 1827,Building R&D,EVOC intelligence valley,No 11,Gao xin west road,Guangming New District
+				Shenzhen    518107
+				CN
+
+3C-15-FB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3C15FB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-93-4A   (hex)		Sierra Wireless
+CC934A     (base 16)		Sierra Wireless
+				1381 Wireless Way 
+				Richmond BC   CA   V6V 3A4 
+				GB
+
+00-CF-C0   (hex)		China Mobile Group Device Co.,Ltd.
+00CFC0     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+DC-33-0D   (hex)		QING DAO HAIER TELECOM CO.,LTD.
+DC330D     (base 16)		QING DAO HAIER TELECOM CO.,LTD.
+				No 1  Haier road,Hi-tech Zone，Qingdao，PR.China
+				Qingdao  Shandong  266101
+				CN
+
+68-89-75   (hex)		nuoxc
+688975     (base 16)		nuoxc
+				龙岗区横岗街道西坑社区西坑梧岗路9号2栋
+				深圳市  广东省  518173
+				CN
+
+40-F0-4E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+40F04E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+00-21-F2   (hex)		EASY3CALL Technology Limited
+0021F2     (base 16)		EASY3CALL Technology Limited
+				Room 1903-6, 19/F., HING YIP Commercial Centre
+				Hong Kong    999077
+				CN
+
+00-15-C4   (hex)		FLOVEL CO., LTD.
+0015C4     (base 16)		FLOVEL CO., LTD.
+				The Tachihi building No,3 hall, 6-1, Sakae-cho,
+				Tokyo    190-0003
+				US
+
+00-11-E6   (hex)		Scientific Atlanta
+0011E6     (base 16)		Scientific Atlanta
+				5030 Sugarloaf Parkway
+				Lawrenceville  Ga  30042
+				US
+
+24-F1-28   (hex)		Telstra
+24F128     (base 16)		Telstra
+				231 Elisabeth St
+				SYDNEY  NSW  2000
+				AU
+
+E0-38-3F   (hex)		zte corporation
+E0383F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-72-26   (hex)		zte corporation
+D47226     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+40-83-1D   (hex)		Apple, Inc.
+40831D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-D3-A2   (hex)		Apple, Inc.
+DCD3A2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-1D-D9   (hex)		Apple, Inc.
+5C1DD9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-05-88   (hex)		Ruijie Networks Co.,LTD
+800588     (base 16)		Ruijie Networks Co.,LTD
+				20# Building,Star-net Science Plaza,Juyuanzhou, 618 Jinshan Road
+				Fuzhou  Fujian  350002
+				CN
+
+F0-0E-1D   (hex)		Megafone Limited
+F00E1D     (base 16)		Megafone Limited
+				Unit 702,7/F,Bankok Bank Building,NO.18 Bonham Strand West
+				Hong Kong    999077
+				HK
+
+88-AE-07   (hex)		Apple, Inc.
+88AE07     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+68-FE-F7   (hex)		Apple, Inc.
+68FEF7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-35-EE   (hex)		FN-LINK TECHNOLOGY LIMITED
+AC35EE     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+88-11-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+881196     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-0E-EE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E40EEE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-D9-97   (hex)		Yuduan Mobile Co., Ltd.
+28D997     (base 16)		Yuduan Mobile Co., Ltd.
+				Room 401 No 84 Lane 887 Zuchongzhi Rd.
+				Shanghai    201203
+				CN
+
+30-1F-9A   (hex)		IEEE Registration Authority
+301F9A     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-2C-54   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0C2C54     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-C1-9E   (hex)		Ruckus Wireless
+D4C19E     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+70-69-5A   (hex)		Cisco Systems, Inc
+70695A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-BF-77   (hex)		Cisco Systems, Inc
+00BF77     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D0-77-14   (hex)		Motorola Mobility LLC, a Lenovo Company
+D07714     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+30-B7-D4   (hex)		Hitron Technologies. Inc
+30B7D4     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+B4-81-BF   (hex)		Meta-Networks, LLC
+B481BF     (base 16)		Meta-Networks, LLC
+				Office 106C, 5/2, Varshavskaya street
+				Saint-Petersburg  Saint-Petersburg  196128
+				RU
+
+94-6A-B0   (hex)		Arcadyan Corporation
+946AB0     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+48-18-FA   (hex)		Nocsys
+4818FA     (base 16)		Nocsys
+				1F, No. 63 Building, No. 421 Hong Cao Road, Xuhui District
+				Shanghai  Shanghai  200233
+				CN
+
+58-7A-6A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+587A6A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+A0-38-F8   (hex)		OURA Health Oy
+A038F8     (base 16)		OURA Health Oy
+				Elektroniikkatie 3
+				Oulu    90590
+				FI
+
+68-79-24   (hex)		ELS-GmbH & Co. KG
+687924     (base 16)		ELS-GmbH & Co. KG
+				Dammstrasse 21
+				Werther  NRW  33824
+				DE
+
+28-FD-80   (hex)		IEEE Registration Authority
+28FD80     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-AE-7D   (hex)		Texas Instruments
+0CAE7D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+30-45-11   (hex)		Texas Instruments
+304511     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+E8-1A-AC   (hex)		ORFEO SOUNDWORKS Inc.
+E81AAC     (base 16)		ORFEO SOUNDWORKS Inc.
+				612, 11-41, Simin-daero 327beon-gil, Dongan-gu
+				Anyang    14055
+				KR
+
+00-07-58   (hex)		DragonWave Inc.
+000758     (base 16)		DragonWave Inc.
+				600-411 Leggett Drive,
+				Kanata,  Ontario  K2K 3C9
+				CA
+
+F0-FC-C8   (hex)		ARRIS Group, Inc.
+F0FCC8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-DF-15   (hex)		Sunitec Enterprise Co.,Ltd
+F8DF15     (base 16)		Sunitec Enterprise Co.,Ltd
+				3F.,No.98-1,Mincyuan Rd.Sindian City
+				Taipei County 231    231141
+				CN
+
+00-1D-B5   (hex)		Juniper Networks
+001DB5     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+B0-26-80   (hex)		Cisco Systems, Inc
+B02680     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-93-98   (hex)		Nokia Corporation
+D49398     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  N.A.  24101
+				FI
+
+00-19-37   (hex)		CommerceGuard AB
+001937     (base 16)		CommerceGuard AB
+				Gustavslundsv 151A
+				BROMMA    16714
+				SE
+
+FC-7C-02   (hex)		Phicomm (Shanghai) Co., Ltd.
+FC7C02     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+A8-61-0A   (hex)		ARDUINO AG
+A8610A     (base 16)		ARDUINO AG
+				Corso San Gottardo 6A
+				Chiasso    6830
+				CH
+
+60-97-DD   (hex)		MicroSys Electronics GmbH
+6097DD     (base 16)		MicroSys Electronics GmbH
+				Muehlweg 1
+				Sauerlach    82054
+				DE
+
+04-79-70   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+047970     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-57-E3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A057E3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-B0-44   (hex)		ASKEY COMPUTER CORP
+1CB044     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+AC-17-C8   (hex)		Cisco Meraki
+AC17C8     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  null  94158
+				US
+
+F4-84-4C   (hex)		Texas Instruments
+F4844C     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+B4-F2-E8   (hex)		ARRIS Group, Inc.
+B4F2E8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-57-4F   (hex)		China Mobile Group Device Co.,Ltd.
+3C574F     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+D4-9C-F4   (hex)		Palo Alto Networks
+D49CF4     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+8C-16-45   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+8C1645     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+68-98-61   (hex)		Beacon Inc
+689861     (base 16)		Beacon Inc
+				82-1, Anyangcheondong-ro, Dongan-gu
+				anyang  Gyeonggi-do  14042
+				KR
+
+60-98-13   (hex)		Shanghai Visking Digital Technology Co. LTD
+609813     (base 16)		Shanghai Visking Digital Technology Co. LTD
+				Room 1301, Building A8, No.1688 Guoquan North Road, Yangpu District
+				Shanghai    200082
+				CN
+
+50-6B-4B   (hex)		Mellanox Technologies, Inc.
+506B4B     (base 16)		Mellanox Technologies, Inc.
+				350 Oakmead Parkway, Suite 100 
+				Sunnyvale  CA  94085
+				US
+
+B4-1C-30   (hex)		zte corporation
+B41C30     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+70-5A-AC   (hex)		Samsung Electronics Co.,Ltd
+705AAC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-95-69   (hex)		ARRIS Group, Inc.
+2C9569     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A0-39-EE   (hex)		Sagemcom Broadband SAS
+A039EE     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+E4-CB-59   (hex)		Beijing Loveair Science and Technology Co. Ltd.
+E4CB59     (base 16)		Beijing Loveair Science and Technology Co. Ltd.
+				103,Block B, Kelin Building, No.107, Dongsi North Street, Dongcheng District,
+				 Beijing    100000
+				CN
+
+B4-E6-2D   (hex)		Espressif Inc.
+B4E62D     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+84-74-60   (hex)		zte corporation
+847460     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+4C-82-CF   (hex)		Dish Technologies Corp
+4C82CF     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+28-57-67   (hex)		Dish Technologies Corp
+285767     (base 16)		Dish Technologies Corp
+				94 Inverness Terrace E
+				Englewood  CO  80112
+				US
+
+70-16-9F   (hex)		EtherCAT Technology Group
+70169F     (base 16)		EtherCAT Technology Group
+				Ostendstr. 196
+				NUremberg    90482
+				DE
+
+68-EF-43   (hex)		Apple, Inc.
+68EF43     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-2B-20   (hex)		Apple, Inc.
+D02B20     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-61-F6   (hex)		Apple, Inc.
+2C61F6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-A3-3D   (hex)		Apple, Inc.
+D4A33D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-76-6F   (hex)		Apple, Inc.
+F0766F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-98-AD   (hex)		Apple, Inc.
+4098AD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-4D-73   (hex)		Apple, Inc.
+6C4D73     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+1C-A0-B8   (hex)		Hon Hai Precision Ind. Co., Ltd.
+1CA0B8     (base 16)		Hon Hai Precision Ind. Co., Ltd.
+				GuangDongShenZhen
+				ShenZhen  GuangDong  518109
+				CN
+
+D8-84-66   (hex)		Extreme Networks, Inc.
+D88466     (base 16)		Extreme Networks, Inc.
+				145 Rio Robles
+				San Jose  CA  95134
+				US
+
+00-04-96   (hex)		Extreme Networks, Inc.
+000496     (base 16)		Extreme Networks, Inc.
+				3585 Monroe Street
+				Santa Clara  CA  95051
+				US
+
+00-E0-2B   (hex)		Extreme Networks, Inc.
+00E02B     (base 16)		Extreme Networks, Inc.
+				10460 BANDLEY DRIVE
+				CUPERINT0  CA  95014
+				US
+
+5C-0E-8B   (hex)		Extreme Networks, Inc.
+5C0E8B     (base 16)		Extreme Networks, Inc.
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+74-67-F7   (hex)		Extreme Networks, Inc.
+7467F7     (base 16)		Extreme Networks, Inc.
+				1 Zebra Plaza
+				Holtsville  NY  11742
+				US
+
+E4-30-22   (hex)		Hanwha Techwin Security Vietnam
+E43022     (base 16)		Hanwha Techwin Security Vietnam
+				Plot O-2, Que Vo industrial park (Expanded area), 
+				Nam Son Commune, Bac Ninh City  Bac Ninh Province  000
+				VN
+
+04-4F-17   (hex)		HUMAX Co., Ltd.
+044F17     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+5C-4A-1F   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+5C4A1F     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+E4-8F-34   (hex)		Vodafone Italia S.p.A.
+E48F34     (base 16)		Vodafone Italia S.p.A.
+				Via Lorenteggio nr. 240
+				Milan  Italy  20147
+				IT
+
+68-5A-CF   (hex)		Samsung Electronics Co.,Ltd
+685ACF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+0C-A8-A7   (hex)		Samsung Electronics Co.,Ltd
+0CA8A7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-67-2F   (hex)		Bowers & Wilkins
+B0672F     (base 16)		Bowers & Wilkins
+				900 Middlefield Rd Floor 4
+				Redwood City  CA  94063
+				US
+
+10-CD-6E   (hex)		FISYS
+10CD6E     (base 16)		FISYS
+				303 Expotel, 44, Dunsan-daero 117beon-gil, Seo-gu, Daejeon, Korea
+				Daejeon, Korea    KS015
+				KR
+
+D8-63-75   (hex)		Xiaomi Communications Co Ltd
+D86375     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+D8-9C-67   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D89C67     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+64-20-9F   (hex)		Tilgin AB
+64209F     (base 16)		Tilgin AB
+				Finlandsgatan 40
+				Kista    16474
+				SE
+
+A4-3E-51   (hex)		ANOV FRANCE
+A43E51     (base 16)		ANOV FRANCE
+				100 CHEMIN DE BAILLOT
+				MONTAUBAN    82000
+				FR
+
+70-26-05   (hex)		SONY Visual Products Inc.
+702605     (base 16)		SONY Visual Products Inc.
+				2-10-1 Osaki
+				Shinagawa-ku  Tokyo  141-8610
+				JP
+
+00-90-F1   (hex)		Seagate Cloud Systems Inc
+0090F1     (base 16)		Seagate Cloud Systems Inc
+				6305 El Camino Real
+				Carlsbad  CA  92009
+				US
+
+84-5A-81   (hex)		ffly4u
+845A81     (base 16)		ffly4u
+				3, avenue Didier Daurat
+				Toulouse    31400
+				FR
+
+CC-81-DA   (hex)		Phicomm (Shanghai) Co., Ltd.
+CC81DA     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+00-80-6C   (hex)		Secure Systems & Services
+00806C     (base 16)		Secure Systems & Services
+				24, Chemin de la Pouranque
+				F-13752  LES PENNES MIRABEAU  CS30084
+				FR
+
+00-72-63   (hex)		Netcore Technology Inc.
+007263     (base 16)		Netcore Technology Inc.
+				ORIENTAL CYBERPORT,HIGHTECH 6 ROAD
+				Shenzhen    518057
+				CN
+
+1C-27-DD   (hex)		Datang Gohighsec(zhejiang)Information Technology Co.,Ltd.
+1C27DD     (base 16)		Datang Gohighsec(zhejiang)Information Technology Co.,Ltd.
+				Beiwu Innovation park, #23 Beiwu Villiage Road
+				Beijing  Beijing  100000
+				CN
+
+B8-C8-EB   (hex)		ITEL MOBILE LIMITED
+B8C8EB     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+80-C5-F2   (hex)		AzureWave Technology Inc.
+80C5F2     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+64-F8-8A   (hex)		China Mobile IOT Company Limited
+64F88A     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+68-DB-54   (hex)		Phicomm (Shanghai) Co., Ltd.
+68DB54     (base 16)		Phicomm (Shanghai) Co., Ltd.
+				3666 SiXian Rd.,Songjiang District
+				Shanghai  Shanghai  201616
+				CN
+
+B4-52-53   (hex)		Seagate Technology
+B45253     (base 16)		Seagate Technology
+				1280 Disc Drive
+				Shakopee  MN  55379
+				US
+
+00-11-C6   (hex)		Seagate Technology
+0011C6     (base 16)		Seagate Technology
+				M/S NW1F01
+				Longmont  CO  80503
+				US
+
+00-1D-38   (hex)		Seagate Technology
+001D38     (base 16)		Seagate Technology
+				M/S NW1F01
+				Longmont  CO  80503
+				US
+
+00-50-13   (hex)		Seagate Cloud Systems Inc
+005013     (base 16)		Seagate Cloud Systems Inc
+				7420 E. Dry Creek Parkway
+				Longmont  CO  80503
+				US
+
+C8-DF-84   (hex)		Texas Instruments
+C8DF84     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+24-0D-6C   (hex)		SMND
+240D6C     (base 16)		SMND
+				16-39, LS-ro 91 beon-gil, Dongan-gu
+				Anyang-si  Gyeonggi-do  14119
+				KR
+
+48-55-5C   (hex)		Wu Qi Technologies,Inc.
+48555C     (base 16)		Wu Qi Technologies,Inc.
+				Xiantao street data on the 19th East Road
+				Chongqing City   Yubei District  401120
+				CN
+
+18-F0-E4   (hex)		Xiaomi Communications Co Ltd
+18F0E4     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources , No.68 Qinghe Middle Street , Haidian District
+				Beijing  Beijing  100089
+				CN
+
+58-8A-5A   (hex)		Dell Inc.
+588A5A     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+9C-8C-6E   (hex)		Samsung Electronics Co.,Ltd
+9C8C6E     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+DC-4F-22   (hex)		Espressif Inc.
+DC4F22     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+F8-6C-E1   (hex)		Taicang T&W Electronics
+F86CE1     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+1C-73-28   (hex)		Connected Home
+1C7328     (base 16)		Connected Home
+				19-22, Rathbone Place
+				London    W1T 1HY
+				GB
+
+D8-E0-04   (hex)		Vodia Networks Inc
+D8E004     (base 16)		Vodia Networks Inc
+				33 Broad St
+				Boston  MA  02109
+				US
+
+2C-FD-AB   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+2CFDAB     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+30-B4-B8   (hex)		LG Electronics
+30B4B8     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+38-0E-4D   (hex)		Cisco Systems, Inc
+380E4D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+38-73-EA   (hex)		IEEE Registration Authority
+3873EA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+4C-52-62   (hex)		Fujitsu Technology Solutions GmbH
+4C5262     (base 16)		Fujitsu Technology Solutions GmbH
+				Buergermeister-Ulrich-Strasse 100
+				Augsburg  Bayern  86199
+				DE
+
+80-3B-F6   (hex)		LOOK EASY INTERNATIONAL LIMITED
+803BF6     (base 16)		LOOK EASY INTERNATIONAL LIMITED
+				4th Floor, No. 551, Guang-Fu South Road
+				Taipei  Xinyi District  11074
+				TW
+
+30-EB-1F   (hex)		Skylab M&C Technology Co.,Ltd
+30EB1F     (base 16)		Skylab M&C Technology Co.,Ltd
+				6 Floor,No.9 Building,Lijincheng Scientific&Technical park,Gongye East Road,Longhua District
+				Shenzhen  Guangdong  518109
+				CN
+
+54-9A-4C   (hex)		GUANGDONG HOMECARE TECHNOLOGY CO.,LTD. 
+549A4C     (base 16)		GUANGDONG HOMECARE TECHNOLOGY CO.,LTD. 
+				8F,12#, Taihua Industrial Park, Hangkong Rd., Gushu， Baoan District
+				Shenzhen  Guangdong  518128
+				CN
+
+EC-1D-8B   (hex)		Cisco Systems, Inc
+EC1D8B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+EC-70-97   (hex)		ARRIS Group, Inc.
+EC7097     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+58-19-F8   (hex)		ARRIS Group, Inc.
+5819F8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D0-7F-C4   (hex)		Ou Wei Technology Co.，Ltd. of Shenzhen City
+D07FC4     (base 16)		Ou Wei Technology Co.，Ltd. of Shenzhen City
+				Registered Address: Room 201, Block D, Huahan Innovation Park, Langshan Road, Xili Street, Nanshan District,
+				Shenzhen  Guangdong  518057
+				CN
+
+14-79-F3   (hex)		China Mobile Group Device Co.,Ltd.
+1479F3     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+0C-CE-F6   (hex)		Guizhou Fortuneship Technology Co., Ltd
+0CCEF6     (base 16)		Guizhou Fortuneship Technology Co., Ltd
+				2nd Floor, Factory Building 4, Hi-Tech Industrial Park, Xinpu Economic Development Zone, Xinpu New District
+				Zunyi City  Guizhou Province  56300
+				CN
+
+18-06-FF   (hex)		Acer Computer(Shanghai) Limited.
+1806FF     (base 16)		Acer Computer(Shanghai) Limited.
+				Room1806-20, No.769, Jiujiang Road, Huangpu District
+				Shanghai    200000
+				CN
+
+C4-CD-82   (hex)		Hangzhou Lowan Information Technology Co., Ltd.
+C4CD82     (base 16)		Hangzhou Lowan Information Technology Co., Ltd.
+				502 Building B, United Mansion, No.2 Zijinghua Road
+				Hangzhou  Zhejiang  310023
+				CN
+
+30-FB-94   (hex)		Shanghai Fangzhiwei Information Technology CO.,Ltd.
+30FB94     (base 16)		Shanghai Fangzhiwei Information Technology CO.,Ltd.
+				The 17th  Building A Unit,No. 1688 Lianhang Road,Minhang District,Shanghai City
+				Shanghai    201100
+				CN
+
+00-23-A0   (hex)		Hana CNS Co., LTD.
+0023A0     (base 16)		Hana CNS Co., LTD.
+				Taejang-dong 1720-52 Taejang-NongGong-Danji
+				Wonju  Gangwon-do  220-962
+				KR
+
+F4-06-A5   (hex)		Hangzhou Bianfeng Networking Technology Co., Ltd.
+F406A5     (base 16)		Hangzhou Bianfeng Networking Technology Co., Ltd.
+				BlockC，2F，Building B，Paradise Software Park
+				Hangzhou  Zhejiang  310012
+				CN
+
+A4-B5-2E   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+A4B52E     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+3C-A5-81   (hex)		vivo Mobile Communication Co., Ltd.
+3CA581     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+34-E9-11   (hex)		vivo Mobile Communication Co., Ltd.
+34E911     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+64-CB-A3   (hex)		Pointmobile
+64CBA3     (base 16)		Pointmobile
+				B-9F kabul Great Valley, 32, Digital-ro 9-gil, Geumcheon-gu
+				Seoul  Seoul  08512
+				KR
+
+EC-FA-BC   (hex)		Espressif Inc.
+ECFABC     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+08-BA-22   (hex)		Swaive Corporation
+08BA22     (base 16)		Swaive Corporation
+				3565 Kettmann Road
+				San Jose  CA  95121
+				US
+
+28-C1-3C   (hex)		Hon Hai Precision Ind. Co., Ltd.
+28C13C     (base 16)		Hon Hai Precision Ind. Co., Ltd.
+				GuangDongShenZhen
+				ShenZhen  GuangDong  518109
+				CN
+
+B0-EC-E1   (hex)		Private
+B0ECE1     (base 16)		Private
+
+60-E7-8A   (hex)		UNISEM
+60E78A     (base 16)		UNISEM
+				10-7,Jangjinam-gil,Dongtan-meyeon
+				Hwaseong-si  Gyeonggi-do  18510
+				KR
+
+28-29-86   (hex)		APC by Schneider Electric
+282986     (base 16)		APC by Schneider Electric
+				800 Federal St.
+				Andover  MA  01810
+				US
+
+70-7D-B9   (hex)		Cisco Systems, Inc
+707DB9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+08-BE-AC   (hex)		Edimax Technology Co. Ltd.
+08BEAC     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+24-8B-E0   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+248BE0     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+00-24-24   (hex)		Ace Axis Limited
+002424     (base 16)		Ace Axis Limited
+				602 Delta Business Park, Welton Road
+				Swindon    SN5 7XP
+				GB
+
+50-C9-A0   (hex)		SKIPPER AS
+50C9A0     (base 16)		SKIPPER AS
+				Enebakkvn 150
+				Oslo    0612
+				NO
+
+74-83-EF   (hex)		Arista Networks
+7483EF     (base 16)		Arista Networks
+				5453 Great America Parkway
+				Santa Clara  CA  95054
+				US
+
+00-E0-F6   (hex)		DECISION EUROPE
+00E0F6     (base 16)		DECISION EUROPE
+				3, rue de Lattre de Tassigny
+				85170 SAINT DENIS LA CHEVASSE    
+				FR
+
+CC-2D-E0   (hex)		Routerboard.com
+CC2DE0     (base 16)		Routerboard.com
+				Mikrotikls SIA
+				Riga  Riga  LV1009
+				LV
+
+00-BF-61   (hex)		Samsung Electronics Co.,Ltd
+00BF61     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+78-67-D7   (hex)		Apple, Inc.
+7867D7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-C1-11   (hex)		Apple, Inc.
+B8C111     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+10-46-B4   (hex)		FormericaOE
+1046B4     (base 16)		FormericaOE
+				5F-11, No.38, Taiyuan Street
+				 Zhubei City   Hsinchu County  302
+				TW
+
+9C-E3-3F   (hex)		Apple, Inc.
+9CE33F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-6B-1C   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+386B1C     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+DC-55-83   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+DC5583     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+00-12-48   (hex)		Dell EMC
+001248     (base 16)		Dell EMC
+				176 South Street
+				Hopkinton  MA  01748
+				US
+
+00-60-48   (hex)		Dell EMC
+006048     (base 16)		Dell EMC
+				171 SOUTH ST.,
+				HOPKINTON  MA  01748
+				US
+
+7C-C9-5A   (hex)		Dell EMC
+7CC95A     (base 16)		Dell EMC
+				176 South Street
+				Hopkinton  MA  01748
+				US
+
+D0-04-01   (hex)		Motorola Mobility LLC, a Lenovo Company
+D00401     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+74-28-57   (hex)		Mayfield Robotics
+742857     (base 16)		Mayfield Robotics
+				400 Convention Way
+				Redwood City  CA  94063
+				US
+
+58-90-43   (hex)		Sagemcom Broadband SAS
+589043     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+B4-A3-82   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+B4A382     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+9C-9C-40   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+9C9C40     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+A4-07-B6   (hex)		Samsung Electronics Co.,Ltd
+A407B6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+40-49-8A   (hex)		Synapticon GmbH
+40498A     (base 16)		Synapticon GmbH
+				Daimlerstr. 26
+				Schönaich    71101
+				DE
+
+38-9D-92   (hex)		Seiko Epson Corporation
+389D92     (base 16)		Seiko Epson Corporation
+				2070 Kotobuki Koaka
+				Matsumoto-shi  Nagano-ken  399-8702
+				JP
+
+8C-0F-83   (hex)		Angie Hospitality LLC
+8C0F83     (base 16)		Angie Hospitality LLC
+				12465 S Fort St, Ste 300
+				Draper  UT  84020-9021
+				US
+
+DC-68-EB   (hex)		Nintendo Co.,Ltd
+DC68EB     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+E8-36-1D   (hex)		Sense Labs, Inc.
+E8361D     (base 16)		Sense Labs, Inc.
+				485 Massachusetts Ave
+				Cambridge  MA  02139
+				US
+
+08-78-08   (hex)		Samsung Electronics Co.,Ltd
+087808     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-75-98   (hex)		Samsung Electronics Co.,Ltd
+887598     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-17-4D   (hex)		Samsung Electronics Co.,Ltd
+C0174D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-F1-9E   (hex)		ARRIS Group, Inc.
+20F19E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C8-9F-42   (hex)		VDII Innovation AB
+C89F42     (base 16)		VDII Innovation AB
+				Nedre Holländaregatan 5
+				Helsingborg    25225 
+				SE
+
+70-91-F3   (hex)		Universal Electronics, Inc.
+7091F3     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+08-00-69   (hex)		Silicon Graphics
+080069     (base 16)		Silicon Graphics
+				2011 N. SHORELINE BLVD.
+				MOUNTAIN VIEW  CA  94039-7311
+				US
+
+00-22-91   (hex)		Cisco Systems, Inc
+002291     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+10-FC-B6   (hex)		mirusystems CO.,LTD
+10FCB6     (base 16)		mirusystems CO.,LTD
+				#1001, 2-dong, Pangoyo seven venture valley, 228-gil, Pangyo-ro
+				Bundang-gu, Seongnam-si, Gyeonggi-do    13487
+				KR
+
+04-D6-AA   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+04D6AA     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+50-A8-3A   (hex)		S Mobile Devices Limited
+50A83A     (base 16)		S Mobile Devices Limited
+				Unit B-303, 3rd Floor, Tower-B, Plot No-7,Advant IT Park Ltd , Sector-142
+				NOIDA  Uttar Pradesh  201301
+				IN
+
+64-05-E9   (hex)		Shenzhen WayOS Technology Crop., Ltd.
+6405E9     (base 16)		Shenzhen WayOS Technology Crop., Ltd.
+				F18, Yousong Business Building, Longhua New District, Shenzhen, China
+				Shenzhen  Guangdong  518109
+				CN
+
+A0-70-99   (hex)		Beijing Huacan Electronics Co., Ltd
+A07099     (base 16)		Beijing Huacan Electronics Co., Ltd
+				NO.122, Room 2006, 20/F, Qingyun Contemporary Tower, Building 9, Manting Fangyuan Residential District, Qing Yun Li, Hai Dian District
+				Beijing    100036
+				CN
+
+48-D6-D5   (hex)		Google, Inc.
+48D6D5     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+0C-58-42   (hex)		DME Micro
+0C5842     (base 16)		DME Micro
+				unit 310 Lakeside 1, 8 Science Park West Ave, Shatin
+				Hong Kong    Hong Kong
+				HK
+
+B8-10-D4   (hex)		Masimo Corporation
+B810D4     (base 16)		Masimo Corporation
+				40 Parker
+				Irvine  CA  92618
+				US
+
+BC-82-5D   (hex)		MITSUMI ELECTRIC CO.,LTD.
+BC825D     (base 16)		MITSUMI ELECTRIC CO.,LTD.
+				2-11-2, Tsurumaki
+				Tama-shi  Tokyo  206-8567
+				JP
+
+D0-66-6D   (hex)		Shenzhen Bus-Lan Technology Co., Ltd.
+D0666D     (base 16)		Shenzhen Bus-Lan Technology Co., Ltd.
+				928-931 Chuangke Building, 72-1 South Huanguan Rd, Guan Lan Jie Dao, Longhua District
+				Shenzhen  Guangdong  518100 
+				CN
+
+08-15-2F   (hex)		Samsung Electronics Co., Ltd. ARTIK
+08152F     (base 16)		Samsung Electronics Co., Ltd. ARTIK
+				1-1, Samsungjeonja-ro
+				Hwaseong-si  Gyeonggi-do  18448
+				KR
+
+F4-F5-DB   (hex)		Xiaomi Communications Co Ltd
+F4F5DB     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+F4-E2-04   (hex)		Traqueur
+F4E204     (base 16)		Traqueur
+				1, rue Royale
+				Saint-Cloud    92210
+				FR
+
+CC-22-37   (hex)		IEEE Registration Authority
+CC2237     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+38-D6-20   (hex)		Limidea Concept Pte. Ltd.
+38D620     (base 16)		Limidea Concept Pte. Ltd.
+				101 Cecil Street #09-07, Tong Eng Building
+				Singapore  Singapore  069533
+				SG
+
+74-F9-1A   (hex)		Onface
+74F91A     (base 16)		Onface
+				#1408, Mario Tower, 30Gil-28, Digital-ro, Guro-gu
+				Seoul    08389
+				KR
+
+A4-34-F1   (hex)		Texas Instruments
+A434F1     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+18-60-24   (hex)		Hewlett Packard
+186024     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+BC-3D-85   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC3D85     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-54-FA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+2054FA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+38-37-8B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+38378B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-5C-4B   (hex)		GN Audio A/S
+745C4B     (base 16)		GN Audio A/S
+				Lautrupbjerg 7
+				Ballerup    DK-2750
+				DK
+
+00-14-9D   (hex)		Sound ID Inc.
+00149D     (base 16)		Sound ID Inc.
+				3430 West Bayshore Road
+				Palo Alto  California  94303
+				US
+
+A8-E8-24   (hex)		INIM ELECTRONICS S.R.L.
+A8E824     (base 16)		INIM ELECTRONICS S.R.L.
+				VIA DEI LAVORATORI 10 - FRAZIONE CENTOBUCHI
+				MONTEPRANDONE  ASCOLI PICENO  63076
+				IT
+
+10-49-63   (hex)		HARTING K.K.
+104963     (base 16)		HARTING K.K.
+				1-7-9, Shin-Yokohama, Kohoku-ku
+				Yokohama-city  Kanagawa  222-0033
+				JP
+
+8C-D4-8E   (hex)		ITEL MOBILE LIMITED
+8CD48E     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+64-2B-8A   (hex)		ALL BEST Industrial Co., Ltd.
+642B8A     (base 16)		ALL BEST Industrial Co., Ltd.
+				6F., No.210-20, Sec. 3, Zhongyang Rd., Tucheng Dist.,
+				New Taipei City    23680
+				TW
+
+B8-EE-0E   (hex)		Sagemcom Broadband SAS
+B8EE0E     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+EC-D0-9F   (hex)		Xiaomi Communications Co Ltd
+ECD09F     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+78-E1-03   (hex)		Amazon Technologies Inc.
+78E103     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+00-06-59   (hex)		EAL (Apeldoorn) B.V.
+000659     (base 16)		EAL (Apeldoorn) B.V.
+				Molenmakershoek 14
+				Apeldoorn    7328JK
+				NL
+
+E4-EC-10   (hex)		Nokia Corporation
+E4EC10     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu  Ou  90590
+				FI
+
+00-26-92   (hex)		Mitsubishi Electric Corporation
+002692     (base 16)		Mitsubishi Electric Corporation
+				2-7-3 Marunouchi
+				Chiyoda-ku  Tokyo  100-8310
+				JP
+
+8C-C1-21   (hex)		Panasonic Corporation AVC Networks Company
+8CC121     (base 16)		Panasonic Corporation AVC Networks Company
+				1-15 Matsuo-cho
+				Kadoma  Osaka  571-8504
+				JP
+
+EC-04-41   (hex)		ShenZhen TIGO Semiconductor Co., Ltd.
+EC0441     (base 16)		ShenZhen TIGO Semiconductor Co., Ltd.
+				Room B6-709, Funian Plaza, No.3 Shihua Road, Futian Bonded Area
+				shenzhen  China / Guangdong  518048
+				CN
+
+AC-BE-75   (hex)		Ufine Technologies Co.,Ltd.
+ACBE75     (base 16)		Ufine Technologies Co.,Ltd.
+				46, Geumgok-dong, Bundang-gu
+				Seong-nam-si  Gyeonggi-do  463-804
+				KR
+
+00-C0-8F   (hex)		Panasonic Electric Works Co., Ltd.
+00C08F     (base 16)		Panasonic Electric Works Co., Ltd.
+				Tsu-Factory
+				Mie-ken  514-8555  0000
+				JP
+
+B0-35-0B   (hex)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+B0350B     (base 16)		MOBIWIRE MOBILES (NINGBO) CO.,LTD
+				No.999,Dacheng East Road,
+				Fenghua  Zhejiang  315500
+				CN
+
+28-A6-AC   (hex)		seca gmbh & co. kg
+28A6AC     (base 16)		seca gmbh & co. kg
+				Hammer Steindamm 3-25
+				Hamburg  Germany  22089
+				DE
+
+A8-BE-27   (hex)		Apple, Inc.
+A8BE27     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-A5-3E   (hex)		Apple, Inc.
+C0A53E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+44-4E-6D   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+444E6D     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+90-B1-E0   (hex)		Beijing Nebula Link Technology Co., Ltd
+90B1E0     (base 16)		Beijing Nebula Link Technology Co., Ltd
+				Room 1201, Building C, Caizhi International Plaza, Haidian District
+				Beijing    100083
+				CN
+
+6C-09-0A   (hex)		GEMATICA SRL
+6C090A     (base 16)		GEMATICA SRL
+				Via Diocleziano, 107
+				NAPOLI    80125
+				IT
+
+70-E1-FD   (hex)		FLEXTRONICS
+70E1FD     (base 16)		FLEXTRONICS
+				Carretera Base Aerea 5850 int 4
+				Zapopan  Jalisco  45136
+				MX
+
+74-E6-0F   (hex)		TECNO MOBILE LIMITED
+74E60F     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+00-1A-A7   (hex)		Torian Wireless
+001AA7     (base 16)		Torian Wireless
+				204 Johnston Street
+				Collingwood  Victoria  3066
+				AU
+
+0C-B4-59   (hex)		Marketech International Corp.
+0CB459     (base 16)		Marketech International Corp.
+				10F.,NO.3-2,Yuancyu St.,Nangang Dist.
+				Taipei    11503
+				TW
+
+80-14-A8   (hex)		Guangzhou V-SOLUTION Electronic Technology Co., Ltd.
+8014A8     (base 16)		Guangzhou V-SOLUTION Electronic Technology Co., Ltd.
+				Room 406,Originality Building B3, NO.162 Science Avenue,Science Town
+				Guangzhou  Guangdong  510663
+				CN
+
+40-9B-CD   (hex)		D-Link International
+409BCD     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+00-2E-C7   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+002EC7     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-8E-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+488EEF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-75-95   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+547595     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+C4-71-54   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+C47154     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+58-61-63   (hex)		Quantum Networks (SG) Pte. Ltd.
+586163     (base 16)		Quantum Networks (SG) Pte. Ltd.
+				8, UBI ROAD, 2 ZERVEX #08-10,
+				Singapore    408538
+				SG
+
+EC-3D-FD   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+EC3DFD     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+94-D0-29   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+94D029     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+30-84-54   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+308454     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+5C-03-39   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C0339     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F8-28-19   (hex)		Liteon Technology Corporation
+F82819     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+00-15-E5   (hex)		Cheertek Inc.
+0015E5     (base 16)		Cheertek Inc.
+				No.2, Du-Sing First Road, Science-Based Industrial Park,
+				Hsinchu    300
+				TW
+
+50-E9-71   (hex)		Jibo, Inc.
+50E971     (base 16)		Jibo, Inc.
+				230 Congress Street
+				Boston  MA  02110
+				US
+
+30-F7-7F   (hex)		S Mobile Devices Limited
+30F77F     (base 16)		S Mobile Devices Limited
+				Unit B-303, 3rd Floor, Tower-B, Plot No-7,Advant IT Park Ltd , Sector-142
+				NOIDA  Uttar Pradesh  201301
+				IN
+
+D8-6C-63   (hex)		Google, Inc.
+D86C63     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+08-40-F3   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+0840F3     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+94-FB-B2   (hex)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+94FBB2     (base 16)		SHENZHEN GONGJIN ELECTRONICS CO.,LT
+				No.1, Songgang Avenue, Songgang Street, Bao’an District
+				Shenzhen  Guangdong  518105
+				CN
+
+00-1E-99   (hex)		Vantanol Industrial Corporation
+001E99     (base 16)		Vantanol Industrial Corporation
+				9F, NO 31 . Shin-Tai Road
+				Jubei City  Shinchu  302
+				TW
+
+58-B6-33   (hex)		Ruckus Wireless
+58B633     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+5C-51-81   (hex)		Samsung Electronics Co.,Ltd
+5C5181     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+60-8E-08   (hex)		Samsung Electronics Co.,Ltd
+608E08     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-3D-37   (hex)		Ruckus Wireless
+543D37     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+2C-E6-CC   (hex)		Ruckus Wireless
+2CE6CC     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-22-7F   (hex)		Ruckus Wireless
+00227F     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+74-91-1A   (hex)		Ruckus Wireless
+74911A     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-C0-5D   (hex)		L&N TECHNOLOGIES
+00C05D     (base 16)		L&N TECHNOLOGIES
+				2899 AGOURA ROAD #196
+				WESTLAKE VILLAGE  CA  91361-3200
+				US
+
+58-C5-83   (hex)		ITEL MOBILE LIMITED
+58C583     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+18-20-4C   (hex)		Kummler+Matter AG
+18204C     (base 16)		Kummler+Matter AG
+				Hohlstrasse 176
+				Zürich    8004
+				CH
+
+18-D2-25   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+18D225     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+18-B4-30   (hex)		Nest Labs Inc.
+18B430     (base 16)		Nest Labs Inc.
+				3400 Hillview Ave.
+				Palo Alto  CA  94304
+				US
+
+30-B1-64   (hex)		Power Electronics International Inc.
+30B164     (base 16)		Power Electronics International Inc.
+				561-8 Plate Drive
+				East Dundee    60118
+				US
+
+F8-8A-3C   (hex)		IEEE Registration Authority
+F88A3C     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+A4-04-50   (hex)		nFore Technology Inc.
+A40450     (base 16)		nFore Technology Inc.
+				5F, NO 31, Ln 258, Rulguang Rd
+				Taipei  Neihu District  11491
+				TW
+
+FC-5A-1D   (hex)		Hitron Technologies. Inc
+FC5A1D     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+94-14-7A   (hex)		vivo Mobile Communication Co., Ltd.
+94147A     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+38-17-E1   (hex)		Technicolor CH USA Inc.
+3817E1     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+98-28-A6   (hex)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+9828A6     (base 16)		COMPAL INFORMATION (KUNSHAN) CO., LTD. 
+				NO. 25, THE 3RD Street KUNSHAN EXPORT PROCESSING ZONE 
+				KUNSHAN  SUZHOU  215300
+				CN
+
+94-3F-C2   (hex)		Hewlett Packard Enterprise
+943FC2     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+68-1D-EF   (hex)		Shenzhen CYX Technology Co., Ltd.
+681DEF     (base 16)		Shenzhen CYX Technology Co., Ltd.
+				2/F, Bldg. 6, Guangxi Industrial Park, Jianshe Rd.,  Longhua New Dist., Shenzhen
+				Shenzhen    518109
+				CN
+
+B4-00-16   (hex)		 INGENICO TERMINALS SAS
+B40016     (base 16)		 INGENICO TERMINALS SAS
+				28-32 BOULEVARD DE GRENELLE
+				PARIS    75015
+				FR
+
+AC-20-3E   (hex)		Wuhan Tianyu Information Industry Co., Ltd.
+AC203E     (base 16)		Wuhan Tianyu Information Industry Co., Ltd.
+				HUST Industry Park, East-Lake Development Zone
+				Wuhan  Hubei  430223
+				CN
+
+B0-1F-29   (hex)		Helvetia INC.
+B01F29     (base 16)		Helvetia INC.
+				8-11 tokaichi-nishimachi, kitaku
+				Okayama  okayama  7000856
+				JP
+
+88-0F-10   (hex)		Huami Information Technology Co.,Ltd.
+880F10     (base 16)		Huami Information Technology Co.,Ltd.
+				Room 1201 Building A4, National Animation Industry Base
+				Hefei  Anhui  230088
+				CN
+
+14-61-2F   (hex)		Avaya Inc
+14612F     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-30-9D   (hex)		Nimble Microsystems, Inc.
+00309D     (base 16)		Nimble Microsystems, Inc.
+				50 Church Street - 5th Floor
+				Cambridge  MA  02138
+				US
+
+8C-21-0A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+8C210A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan
+				shenzhen  guangdong Province  518057
+				CN
+
+4C-18-9A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+4C189A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+CC-4B-73   (hex)		AMPAK Technology, Inc.
+CC4B73     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+00-15-DC   (hex)		KT&C Co., Ltd.
+0015DC     (base 16)		KT&C Co., Ltd.
+				487-4, KT&C Bldg.
+				GangSeo-Ku  Seoul  157-849
+				KR
+
+00-18-7D   (hex)		Armorlink Co .Ltd
+00187D     (base 16)		Armorlink Co .Ltd
+				No. 515 of Xinzhuang Industry Park Shenfu Road
+				Shanghai Province  Shanghai  201108
+				CN
+
+F4-30-B9   (hex)		Hewlett Packard
+F430B9     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+00-19-F0   (hex)		UNIONMAN TECHNOLOGY CO.,LTD
+0019F0     (base 16)		UNIONMAN TECHNOLOGY CO.,LTD
+				18F, HUAYANG TOWER,YANDAYI ROAD
+				HUIZHOU  GUANGDONG  516007
+				CN
+
+C8-DB-26   (hex)		Logitech
+C8DB26     (base 16)		Logitech
+				7700 Gateway Blvd
+				Newark  CA  94560
+				US
+
+A4-0E-2B   (hex)		Facebook Inc
+A40E2B     (base 16)		Facebook Inc
+				1 Hacker Way
+				Menlo Park  CA  94025
+				US
+
+AC-4E-2E   (hex)		Shenzhen JingHanDa Electronics Co.Ltd
+AC4E2E     (base 16)		Shenzhen JingHanDa Electronics Co.Ltd
+				5th Floor,No 4 ,Road 1,ShangXue Technology industrial Park,LongGang district,ShenZhen,GuangDong,China
+				ShenZhen  GuangDong  518129
+				CN
+
+4C-91-0C   (hex)		 Lanix Internacional, S.A. de C.V.
+4C910C     (base 16)		 Lanix Internacional, S.A. de C.V.
+				Carretera Nogales Km8.5
+				Hermosillo  Sonora  83160
+				MX
+
+A4-78-86   (hex)		Avaya Inc
+A47886     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+04-03-D6   (hex)		Nintendo Co.,Ltd
+0403D6     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+5C-1A-6F   (hex)		Cambridge Industries(Group) Co.,Ltd.
+5C1A6F     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				5/F,Building 8, 2388 ChenHang Road, MinHang District
+				shanghai    201114
+				CN
+
+3C-4C-D0   (hex)		CERAGON NETWORKS
+3C4CD0     (base 16)		CERAGON NETWORKS
+				24 RAUEL WALLENBERG STREET
+				TEL-AVIV    96719
+				IL
+
+F4-0E-83   (hex)		ARRIS Group, Inc.
+F40E83     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+98-F7-D7   (hex)		ARRIS Group, Inc.
+98F7D7     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+B4-BF-F6   (hex)		Samsung Electronics Co.,Ltd
+B4BFF6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-3A-E8   (hex)		Espressif Inc.
+2C3AE8     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+88-BD-78   (hex)		Flaircomm Microelectronics,Inc.
+88BD78     (base 16)		Flaircomm Microelectronics,Inc.
+				7F, Guomai Building, Guomai Science and Technology Park,  116 East JiangBin Road,
+				Fuzhou  Fujian  350015
+				CN
+
+58-C5-CB   (hex)		Samsung Electronics Co.,Ltd
+58C5CB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-6B-E7   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+206BE7     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+18-2C-B4   (hex)		Nectarsoft Co., Ltd.
+182CB4     (base 16)		Nectarsoft Co., Ltd.
+				330, Seongam-ro, Mapo-gu
+				Seoul  Seoul  03920
+				KR
+
+54-C9-DF   (hex)		FN-LINK TECHNOLOGY LIMITED
+54C9DF     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+74-F6-1C   (hex)		HTC Corporation
+74F61C     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+B8-FF-B3   (hex)		MitraStar Technology Corp.
+B8FFB3     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+EC-23-7B   (hex)		zte corporation
+EC237B     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A0-C9-A0   (hex)		Murata Manufacturing Co., Ltd.
+A0C9A0     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+98-2D-BA   (hex)		Fibergate Inc.
+982DBA     (base 16)		Fibergate Inc.
+				KDX Shibadaimon.Bld 2F 2-10-12 Shibadaimon
+				Tokyo  Minato-ku  1050012
+				JP
+
+84-C0-EF   (hex)		Samsung Electronics Co.,Ltd
+84C0EF     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-A3-8E   (hex)		Cisco Systems, Inc
+00A38E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-D5-5E   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+E0D55E     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+A0-40-A0   (hex)		NETGEAR
+A040A0     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-0D-2B   (hex)		Racal Instruments
+000D2B     (base 16)		Racal Instruments
+				4 Goodyear Street
+				Irvine  CA  92618
+				US
+
+00-40-66   (hex)		APRESIA Systems Ltd
+004066     (base 16)		APRESIA Systems Ltd
+				 Tsukuba Network Technical Center, Tsukuba Network
+				Tsuchiura-shi  Ibaraki-ken  300-0026
+				JP
+
+48-A7-4E   (hex)		zte corporation
+48A74E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+BC-8A-E8   (hex)		QING DAO HAIER TELECOM CO.,LTD.
+BC8AE8     (base 16)		QING DAO HAIER TELECOM CO.,LTD.
+				No 1 Haier Road Hi-tech Zone
+				Qingdao    266000
+				CN
+
+F4-DE-0C   (hex)		ESPOD Ltd.
+F4DE0C     (base 16)		ESPOD Ltd.
+				6 Marjanishvili St. (Green Building) | 0102 Tbilisi | Georgia
+				Tbilisi  Tbilisi  0102
+				GE
+
+3C-52-82   (hex)		Hewlett Packard
+3C5282     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+08-ED-02   (hex)		IEEE Registration Authority
+08ED02     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E8-FD-E8   (hex)		CeLa Link Corporation
+E8FDE8     (base 16)		CeLa Link Corporation
+				401-1, Partners Tower1, Gasan digital 1-ro 83, Geumcheon-gu
+				Seoul    08589
+				KR
+
+28-C6-3F   (hex)		Intel Corporate
+28C63F     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+88-CC-45   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+88CC45     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+60-08-37   (hex)		ivvi Scientific(Nanchang)Co.Ltd
+600837     (base 16)		ivvi Scientific(Nanchang)Co.Ltd
+				Coolpad Cyber Harbor,2nd Mengxi Road,Hi-TechIndustrial Park(North),NanShan District,ShenZhen,P.R.C.
+				shenzhen  Guangdong  518057
+				CN
+
+EC-36-3F   (hex)		Markov Corporation
+EC363F     (base 16)		Markov Corporation
+				650 Vaqueros Avenue, Suite A
+				Sunnyvale  CA  94085
+				US
+
+58-04-CB   (hex)		Tianjin Huisun Technology Co.,Ltd.
+5804CB     (base 16)		Tianjin Huisun Technology Co.,Ltd.
+				4/f, Building 3, No 1 Haitai Huake Street (outside Ring Road)
+				  Tianjin  300384
+				CN
+
+60-D7-E3   (hex)		IEEE Registration Authority
+60D7E3     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+18-93-D7   (hex)		Texas Instruments
+1893D7     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A8-B8-6E   (hex)		LG Electronics (Mobile Communications)
+A8B86E     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+CC-90-E8   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+CC90E8     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+7C-4F-7D   (hex)		Sawwave
+7C4F7D     (base 16)		Sawwave
+				SKn TechnoPark 1207
+				SeongNam-Si  Gyenggi-do  13207
+				KR
+
+9C-AC-6D   (hex)		Universal Electronics, Inc.
+9CAC6D     (base 16)		Universal Electronics, Inc.
+				201 E. Sandpointe Ave
+				Santa Ana  CA  92707
+				US
+
+08-EA-40   (hex)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+08EA40     (base 16)		SHENZHEN BILIAN ELECTRONIC CO.，LTD
+				NO.268， Fuqian Rd, Jutang community, Guanlan Town, Longhua New district
+				shenzhen  guangdong  518000
+				CN
+
+00-D0-95   (hex)		Alcatel-Lucent Enterprise
+00D095     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				Calabasas  CA  91301
+				US
+
+00-20-DA   (hex)		Alcatel-Lucent Enterprise
+0020DA     (base 16)		Alcatel-Lucent Enterprise
+				26801 West Agoura Road
+				CALABASAS  CA  91301
+				US
+
+6C-59-76   (hex)		Shanghai Tricheer Technology Co.,Ltd.
+6C5976     (base 16)		Shanghai Tricheer Technology Co.,Ltd.
+				Rm 907, Building 1, Lane 399, Shengxia Road,Zhangjiang Hi-Tech Park,Pudong District,Shanghai
+				Shanghai  Shanghai  201203
+				CN
+
+7C-7B-8B   (hex)		Control Concepts, Inc.
+7C7B8B     (base 16)		Control Concepts, Inc.
+				18760 Lake Dr. East
+				Chanhassen  MN  55317
+				US
+
+84-A9-C4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+84A9C4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-08-6F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A0086F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+34-CE-00   (hex)		XIAOMI Electronics,CO.,LTD
+34CE00     (base 16)		XIAOMI Electronics,CO.,LTD
+				Xiaomi Building, No.68 Qinghe Middle Street
+				Haidian District  Beijing  100085
+				CN
+
+D0-6F-82   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D06F82     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-F4-79   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A0F479     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-47-65   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+844765     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-FF-1F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4FF1F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A0-C4-A5   (hex)		SYGN HOUSE CO.,LTD
+A0C4A5     (base 16)		SYGN HOUSE CO.,LTD
+				2-9-14 Tamagawa-denenchofu
+				Setagaya-ku  Tokyo  1580085
+				JP
+
+B8-37-65   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B83765     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+34-5B-BB   (hex)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+345BBB     (base 16)		GD Midea Air-Conditioning Equipment Co.,Ltd.
+				Midea Global Innovation Center,Beijiao Town,Shunde
+				Foshan  Guangdong  528311
+				CN
+
+C4-0B-CB   (hex)		Xiaomi Communications Co Ltd
+C40BCB     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+84-AF-EC   (hex)		BUFFALO.INC
+84AFEC     (base 16)		BUFFALO.INC
+				AKAMONDORI Bld.,30-20,Ohsu 3-chome,Naka-ku
+				Nagoya  Aichi Pref.  460-8315
+				JP
+
+5C-C6-E9   (hex)		Edifier International
+5CC6E9     (base 16)		Edifier International
+				Suit 2207, 22nd floor, Tower II, Lippo centre, 89 Queensway
+				Hong Kong    070
+				CN
+
+98-DD-EA   (hex)		Infinix mobility limited
+98DDEA     (base 16)		Infinix mobility limited
+				RMS 05-15, 13A/F SOUTH TOWER WORLD FINANCE CTR HARBOUR CITY 17 CANTON RD TST KLN HONG KONG
+				HongKong  HongKong  999077
+				HK
+
+00-1D-44   (hex)		Krohne
+001D44     (base 16)		Krohne
+				Ludwig-Krohne-Str. 5
+				Duisburg    47058
+				DE
+
+A8-A1-98   (hex)		TCT mobile ltd
+A8A198     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+E0-C0-D1   (hex)		CK Telecom (Shenzhen) Limited
+E0C0D1     (base 16)		CK Telecom (Shenzhen) Limited
+				Floor 9th, Building 4C,Software Industry Base, Xuefu Road, Hi-Tech Park, Nanshan Dist.
+				Shenzhen  Guangdong  518057
+				CN
+
+00-21-9E   (hex)		Sony Mobile Communications Inc
+00219E     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+AC-B5-7D   (hex)		Liteon Technology Corporation
+ACB57D     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+D4-61-9D   (hex)		Apple, Inc.
+D4619D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-49-8B   (hex)		ZOOM SERVER
+D0498B     (base 16)		ZOOM SERVER
+				North keyuan Road
+				Shenzhen    518057
+				CN
+
+08-27-CE   (hex)		NAGANO KEIKI CO., LTD.
+0827CE     (base 16)		NAGANO KEIKI CO., LTD.
+				2150 IKUTA
+				UEDA  NAGANO  386-0411
+				JP
+
+C0-D3-C0   (hex)		Samsung Electronics Co.,Ltd
+C0D3C0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+94-8B-C1   (hex)		Samsung Electronics Co.,Ltd
+948BC1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-56-8E   (hex)		Samsung Electronics Co.,Ltd
+14568E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-BD-61   (hex)		Apple, Inc.
+14BD61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-E0-61   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+54E061     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+50-3A-7D   (hex)		AlphaTech PLC Int’l Co., Ltd.
+503A7D     (base 16)		AlphaTech PLC Int’l Co., Ltd.
+				13F., No.618, Sec. 7, New Taipei Blvd., Xinzhuang Dist., 
+				New Taipei City    24260
+				TW
+
+F4-C4-D6   (hex)		Shenzhen Xinfa Electronic Co.,ltd
+F4C4D6     (base 16)		Shenzhen Xinfa Electronic Co.,ltd
+				No 57, Baoli Road, Buji Town
+				Longgang District  Shenzhen, Guangdong   518112
+				CN
+
+68-37-E9   (hex)		Amazon Technologies Inc.
+6837E9     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+2C-A1-7D   (hex)		ARRIS Group, Inc.
+2CA17D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+D8-32-14   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+D83214     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+10-95-4B   (hex)		Megabyte Ltd.
+10954B     (base 16)		Megabyte Ltd.
+				Unit 507, 5/F, Building 12W, NO.12 Science Park Avenue, Hong Kong Science Park, Shatin, New Territories
+				Hong Kong    NA
+				HK
+
+D8-32-5A   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+D8325A     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+9C-DA-3E   (hex)		Intel Corporate
+9CDA3E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+28-3F-69   (hex)		Sony Mobile Communications Inc
+283F69     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-2C-C8   (hex)		Cisco Systems, Inc
+002CC8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C0-02-8D   (hex)		WINSTAR Display CO.,Ltd
+C0028D     (base 16)		WINSTAR Display CO.,Ltd
+				1F., No.77, Ln. 188, Pinghe S. Rd., Daya Dist., Taichung City 428, Taiwan (R.O.C.)
+				Taichung City    428
+				TW
+
+E8-9F-EC   (hex)		CHENGDU KT ELECTRONIC HI-TECH CO.,LTD
+E89FEC     (base 16)		CHENGDU KT ELECTRONIC HI-TECH CO.,LTD
+				No.9, 3rd Wuke Road, Wuhou District
+				Chengdu  Sichuan Province  610045
+				CN
+
+80-26-89   (hex)		D-Link International
+802689     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+F8-AB-05   (hex)		Sagemcom Broadband SAS
+F8AB05     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+7C-50-49   (hex)		Apple, Inc.
+7C5049     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-7D-EB   (hex)		Shanghai Notion Information Technology CO.,LTD.
+E47DEB     (base 16)		Shanghai Notion Information Technology CO.,LTD.
+				Room 201,Building 3,NO 289,Bisheng Rd,Pudong district,Shanghai,China
+				Shanghai  Shanghai  201203
+				CN
+
+C4-B9-CD   (hex)		Cisco Systems, Inc
+C4B9CD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D4-61-FE   (hex)		Hangzhou H3C Technologies Co., Limited
+D461FE     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+2C-4D-54   (hex)		ASUSTek COMPUTER INC.
+2C4D54     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+34-96-72   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+349672     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+64-B4-73   (hex)		Xiaomi Communications Co Ltd
+64B473     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+74-51-BA   (hex)		Xiaomi Communications Co Ltd
+7451BA     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+6C-B4-A7   (hex)		Landauer, Inc.
+6CB4A7     (base 16)		Landauer, Inc.
+				2 Science Road
+				Glenwood  IL  60425
+				US
+
+78-02-F8   (hex)		Xiaomi Communications Co Ltd
+7802F8     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-23-8A   (hex)		Ciena Corporation
+00238A     (base 16)		Ciena Corporation
+				920 Elkridge Landing
+				Linthicum  MD  21090
+				US
+
+00-10-81   (hex)		DPS, INC.
+001081     (base 16)		DPS, INC.
+				4922 EAST YALE AVENUE
+				FRESNO  CA  93727
+				US
+
+40-F3-85   (hex)		IEEE Registration Authority
+40F385     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+88-78-73   (hex)		Intel Corporate
+887873     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+F8-75-88   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F87588     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-4C-7F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F44C7F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+28-A2-4B   (hex)		Juniper Networks
+28A24B     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+08-00-27   (hex)		PCS Systemtechnik GmbH
+080027     (base 16)		PCS Systemtechnik GmbH
+				600 Suffold St
+				Lowell  MA  01854
+				US
+
+F8-A5-C5   (hex)		Cisco Systems, Inc
+F8A5C5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-5A-1C   (hex)		Sophos Ltd
+7C5A1C     (base 16)		Sophos Ltd
+				The Pentagon
+				Abingdon  Oxfordshire  OX14 3YP
+				GB
+
+B0-F1-EC   (hex)		AMPAK Technology, Inc.
+B0F1EC     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road Hsinchu Industrial Park, Hukou
+				Hsinchu  Taiwan ROC.  30352 
+				TW
+
+54-2B-57   (hex)		Night Owl SP
+542B57     (base 16)		Night Owl SP
+				4720 Radio Rd
+				Naples  FL  34104
+				US
+
+50-1E-2D   (hex)		StreamUnlimited Engineering GmbH
+501E2D     (base 16)		StreamUnlimited Engineering GmbH
+				Gutheil-Schoder-Gasse 10
+				Vienna    1100
+				AT
+
+E4-5D-51   (hex)		SFR
+E45D51     (base 16)		SFR
+				12 rue jean-philippe Rameau CS 80001
+				La plaine saint denis   FRANCE  93634
+				FR
+
+EC-01-EE   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+EC01EE     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+60-49-C1   (hex)		Avaya Inc
+6049C1     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+70-20-84   (hex)		Hon Hai Precision Ind. Co., Ltd.
+702084     (base 16)		Hon Hai Precision Ind. Co., Ltd.
+				GuangDongShenZhen
+				ShenZhen  GuangDong  518109
+				CN
+
+9C-66-50   (hex)		Glodio Technolies Co.,Ltd Tianjin Branch
+9C6650     (base 16)		Glodio Technolies Co.,Ltd Tianjin Branch
+				Room 904, No.1-2 LanYuan Road, HuaYuan Industrial Area
+				TianJin  TianJin  300384
+				CN
+
+A0-A3-3B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A0A33B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-67-A2   (hex)		Intel Corporate
+7C67A2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-E0-5A   (hex)		GALEA NETWORK SECURITY
+00E05A     (base 16)		GALEA NETWORK SECURITY
+				2 PLACE du COMMERCE - STE #320
+				BROSSARD, QUEBEC J4W 2T8    
+				CA
+
+48-A3-80   (hex)		Gionee Communication Equipment Co.,Ltd.
+48A380     (base 16)		Gionee Communication Equipment Co.,Ltd.
+				21/F,Times Technology Building,No. 7028,Shennan Avenue,Futian District
+				Shenzhen    518000
+				CN
+
+94-65-2D   (hex)		OnePlus Technology (Shenzhen) Co., Ltd
+94652D     (base 16)		OnePlus Technology (Shenzhen) Co., Ltd
+				18C02, 18C03, 18C04 ,18C05,TAIRAN BUILDING,
+				Shenzhen  Guangdong  518000
+				CN
+
+1C-B8-57   (hex)		Becon Technologies Co,.Ltd.
+1CB857     (base 16)		Becon Technologies Co,.Ltd.
+				Room C405-A Induckwon IT Vally, 40, Imiro
+				Uiwang city  Kyunggi-do  16006
+				KR
+
+68-27-37   (hex)		Samsung Electronics Co.,Ltd
+682737     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+F0-6E-32   (hex)		MICROTEL INNOVATION S.R.L.
+F06E32     (base 16)		MICROTEL INNOVATION S.R.L.
+				Via Armentera 8
+				BORGO VALSUGANA  TN  38051
+				IT
+
+54-C4-15   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+54C415     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+3C-F8-62   (hex)		Intel Corporate
+3CF862     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+28-16-AD   (hex)		Intel Corporate
+2816AD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-60-D3   (hex)		AT&T
+0060D3     (base 16)		AT&T
+				3300 E Renner Road
+				Richardson  TX  75082
+				US
+
+84-8D-C7   (hex)		Cisco SPVTG
+848DC7     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+00-19-92   (hex)		Adtran Inc
+001992     (base 16)		Adtran Inc
+				901 Explorer Blvd.
+				Huntsville  AL  35806-2807
+				US
+
+04-5D-4B   (hex)		Sony Corporation
+045D4B     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+78-AF-58   (hex)		GIMASI SA
+78AF58     (base 16)		GIMASI SA
+				Via Luigi Lavizzari 18
+				Mendrisio  TI  6850
+				CH
+
+90-50-5A   (hex)		unGlue, Inc
+90505A     (base 16)		unGlue, Inc
+				7150 Helmsdale Circle
+				West Hils  CA  91307
+				US
+
+8C-93-51   (hex)		Jigowatts Inc.
+8C9351     (base 16)		Jigowatts Inc.
+				5892-5 Endo
+				Fujisawa  Kanagawa  252-0816
+				JP
+
+D8-38-FC   (hex)		Ruckus Wireless
+D838FC     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+34-78-D7   (hex)		Gionee Communication Equipment Co.,Ltd.
+3478D7     (base 16)		Gionee Communication Equipment Co.,Ltd.
+				21/F,Times Technology Building,No. 7028,Shennan Avenue,Futian District
+				Shenzhen    518000
+				CN
+
+5C-CC-A0   (hex)		Gridwiz Inc.
+5CCCA0     (base 16)		Gridwiz Inc.
+				4F, 25 Sanun-ro 208beon-gil, Bundang-gu
+				Seongnam  Gyeonggi  13460
+				KR
+
+68-31-FE   (hex)		Teladin Co.,Ltd.
+6831FE     (base 16)		Teladin Co.,Ltd.
+				Digital-ro 33 gil, Guro-gu
+				Seoul    08377
+				KR
+
+58-00-E3   (hex)		Liteon Technology Corporation
+5800E3     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+2C-0B-E9   (hex)		Cisco Systems, Inc
+2C0BE9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-30-18   (hex)		MCS Logic Inc.
+C43018     (base 16)		MCS Logic Inc.
+				6F. Samho Center B Bldg., 275-6,Yangjae-Dong, Secho-Ku,Seoul
+				Seoul    137-941
+				KR
+
+D0-FF-98   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D0FF98     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-E5-ED   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B0E5ED     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-86-E9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C486E9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-0A-E4   (hex)		Wistron Corporation
+000AE4     (base 16)		Wistron Corporation
+				21F, No. 88, Section 1, Hsin Tai  Wu Rd.
+				Taipei    221
+				TW
+
+34-4B-3D   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+344B3D     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+FC-3C-E9   (hex)		Tsingtong Technologies Co, Ltd.
+FC3CE9     (base 16)		Tsingtong Technologies Co, Ltd.
+				Rm A03-72, Floor B1, Building 1, No.13 Dazhongsi, Haidian District
+				Beijing    100098
+				CN
+
+A4-08-F5   (hex)		Sagemcom Broadband SAS
+A408F5     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-B0-91   (hex)		Transmeta Corp.
+00B091     (base 16)		Transmeta Corp.
+				3940 Freedom Circle
+				Santa Clara  CA  95054
+				US
+
+AC-C6-62   (hex)		MitraStar Technology Corp.
+ACC662     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+88-6B-44   (hex)		Sunnovo International Limited
+886B44     (base 16)		Sunnovo International Limited
+				1717 Haitai Building
+				Beijing  Beijing  100083
+				CN
+
+A4-58-0F   (hex)		IEEE Registration Authority
+A4580F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+C8-F7-33   (hex)		Intel Corporate
+C8F733     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+E0-A7-00   (hex)		Verkada Inc
+E0A700     (base 16)		Verkada Inc
+				325 Sharon Park Drive, Suite 519
+				Menlo Park    94025
+				US
+
+58-40-4E   (hex)		Apple, Inc.
+58404E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-C5-F3   (hex)		Apple, Inc.
+D0C5F3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-9F-EF   (hex)		Apple, Inc.
+BC9FEF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-AB-37   (hex)		Apple, Inc.
+20AB37     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-F4-45   (hex)		Apple, Inc.
+60F445     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-F9-7C   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+48F97C     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+40-B9-3C   (hex)		Hewlett Packard Enterprise
+40B93C     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+C0-BF-C0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C0BFC0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-D9-CB   (hex)		Lesira Manufacturing Pty Ltd
+9CD9CB     (base 16)		Lesira Manufacturing Pty Ltd
+				34 Gemsbok Street
+				Pretoria  Gauteng  0186
+				ZA
+
+94-E9-79   (hex)		Liteon Technology Corporation
+94E979     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+A0-3D-6F   (hex)		Cisco Systems, Inc
+A03D6F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A0-E0-AF   (hex)		Cisco Systems, Inc
+A0E0AF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+18-75-32   (hex)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+187532     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO., LTD
+				FL12, TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+4C-B8-1C   (hex)		SAM Electronics GmbH
+4CB81C     (base 16)		SAM Electronics GmbH
+				Behringstr. 120
+				Hamburg  Hamburg  22763
+				DE
+
+00-30-48   (hex)		Super Micro Computer, Inc.
+003048     (base 16)		Super Micro Computer, Inc.
+				2051 Junction Avenue
+				San Jose  CA  95131
+				US
+
+44-D2-44   (hex)		Seiko Epson Corporation
+44D244     (base 16)		Seiko Epson Corporation
+				80 Harashinden
+				Shiojiri-shi  Nagano-ken  399-0785
+				JP
+
+A0-8C-F8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A08CF8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-F9-5C   (hex)		U.I. Lapp GmbH
+7CF95C     (base 16)		U.I. Lapp GmbH
+				Schulze-Delitzsch-Strasse 25
+				Stuttgart    70565
+				DE
+
+10-13-31   (hex)		Technicolor
+101331     (base 16)		Technicolor
+				Prins Boudewijnlaan 47
+				Edegem - Belgium    B-2650
+				BE
+
+A4-E6-B1   (hex)		Shanghai Joindata Technology Co.,Ltd.
+A4E6B1     (base 16)		Shanghai Joindata Technology Co.,Ltd.
+				26F,Building1,No428,South Yanggao Road,Pudong District
+				Shanghai  Shanghai  200127
+				CN
+
+C0-9C-04   (hex)		Shaanxi GuoLian Digital TV Technology Co.,Ltd.
+C09C04     (base 16)		Shaanxi GuoLian Digital TV Technology Co.,Ltd.
+				No. 15, the first Gaoxin road Hi-tech development district
+				Xi'an  Shaanxi  710075
+				CN
+
+AC-D6-57   (hex)		Shaanxi GuoLian Digital TV Technology Co.,Ltd.
+ACD657     (base 16)		Shaanxi GuoLian Digital TV Technology Co.,Ltd.
+				Chief Building, Fifth Yannan Road, Qujiang New District
+				xi'an  shaanxi  71000
+				CN
+
+00-76-86   (hex)		Cisco Systems, Inc
+007686     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+8C-2F-A6   (hex)		Solid Optics B.V.
+8C2FA6     (base 16)		Solid Optics B.V.
+				Huchtstraat 35
+				Almere    1327EC
+				NL
+
+8C-19-2D   (hex)		IEEE Registration Authority
+8C192D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-AC-E0   (hex)		ARRIS Group, Inc.
+00ACE0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-75-32   (hex)		INID BV
+007532     (base 16)		INID BV
+				Mariettahof 27
+				Haarlem  NH  2033WS
+				NL
+
+64-73-E2   (hex)		Arbiter Systems, Inc.
+6473E2     (base 16)		Arbiter Systems, Inc.
+				1324 Vendels Circle
+				Paso Robles  California  93446
+				US
+
+88-C6-26   (hex)		Logitech, Inc
+88C626     (base 16)		Logitech, Inc
+				4700 NW Camas Meadows Dr
+				Camas  WA  98607
+				US
+
+D0-60-8C   (hex)		zte corporation
+D0608C     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+AC-23-3F   (hex)		Shenzhen Minew Technologies Co., Ltd.
+AC233F     (base 16)		Shenzhen Minew Technologies Co., Ltd.
+				H Building, Gangzhilong Science Park, QInglong Road
+				Shenzhen    518109
+				CN
+
+7C-03-C9   (hex)		Shenzhen YOUHUA Technology Co., Ltd
+7C03C9     (base 16)		Shenzhen YOUHUA Technology Co., Ltd
+				Room 407 Shenzhen University-town Business Park,Lishan Road,Taoyuan Street,Nanshan District
+				Shenzhen  Guangdong  518055
+				CN
+
+B8-E9-37   (hex)		Sonos, Inc.
+B8E937     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+E4-5D-52   (hex)		Avaya Inc
+E45D52     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+00-23-F7   (hex)		Private
+0023F7     (base 16)		Private
+
+3C-80-AA   (hex)		Ransnet Singapore Pte Ltd
+3C80AA     (base 16)		Ransnet Singapore Pte Ltd
+				114, Lavender Street, #08-83, CT Hub 2
+				Singapore  Singapore  338729
+				SG
+
+B4-96-91   (hex)		Intel Corporate
+B49691     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+C8-21-58   (hex)		Intel Corporate
+C82158     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+24-20-C7   (hex)		Sagemcom Broadband SAS
+2420C7     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+D4-C8-B0   (hex)		Prime Electronics & Satellitics Inc.
+D4C8B0     (base 16)		Prime Electronics & Satellitics Inc.
+				69,Tung-Yuan Rd
+				Chung-Li City  Tao-Yuan County  32000
+				TW
+
+44-6A-B7   (hex)		ARRIS Group, Inc.
+446AB7     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-1C-E7   (hex)		Intel Corporate
+701CE7     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+9C-2A-70   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9C2A70     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+70-3D-15   (hex)		Hangzhou H3C Technologies Co., Limited
+703D15     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+E4-9E-12   (hex)		FREEBOX SAS
+E49E12     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+04-81-AE   (hex)		Clack Corporation
+0481AE     (base 16)		Clack Corporation
+				4462 Duraform Lane
+				Windsor  WI  53598
+				US
+
+9C-13-AB   (hex)		Chanson Water Co., Ltd.
+9C13AB     (base 16)		Chanson Water Co., Ltd.
+				2F, No.88-11, Sec 1, Guangfu Rd, Sanchong Dist.
+				New Taipei City  Taiwan  241
+				TW
+
+98-E4-76   (hex)		Zentan
+98E476     (base 16)		Zentan
+				10F-3, No. 260, Sec.2 New Taipei Blvd., Sanchong District
+				New Taipei City    24158
+				TW
+
+14-A5-1A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+14A51A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+04-75-03   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+047503     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-EF-8C   (hex)		Zhejiang Dahua Technology Co., Ltd.
+3CEF8C     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				NO.1199 Bin An Road,Binjiang District,HangZhou,P.R.China
+				HangZhou  ZheJiang  310053
+				CN
+
+FC-37-2B   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+FC372B     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+A4-D9-A4   (hex)		neXus ID Solutions AB
+A4D9A4     (base 16)		neXus ID Solutions AB
+				Telefonvägen 26
+				Stockholm    12626
+				SE
+
+48-4D-7E   (hex)		Dell Inc.
+484D7E     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+D4-E9-0B   (hex)		CVT CO.,LTD
+D4E90B     (base 16)		CVT CO.,LTD
+				Secho gu BangBae 3 dong 1001-1
+				seoul  KangNam  KS013
+				KR
+
+CC-B0-DA   (hex)		Liteon Technology Corporation
+CCB0DA     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+7C-CC-1F   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+7CCC1F     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+18-F2-92   (hex)		Shannon Systems
+18F292     (base 16)		Shannon Systems
+				Suite 1801,Wentong Building,739 Kunming Road, Yangpu, Shanghai
+				Shanghai    200000
+				CN
+
+8C-EA-1B   (hex)		Edgecore Networks Corporation
+8CEA1B     (base 16)		Edgecore Networks Corporation
+				1 Creation RD 3.
+				Hsinchu    30077
+				TW
+
+E0-2C-F3   (hex)		MRS Electronic GmbH
+E02CF3     (base 16)		MRS Electronic GmbH
+				Klaus-Gutsch-Str. 7
+				Rottweil    78628
+				DE
+
+50-B3-63   (hex)		Digitron da Amazonia S/A
+50B363     (base 16)		Digitron da Amazonia S/A
+				Av. Eng. Luis Carlos Berrini , 1297
+				São Paulo  São Paulo  04571010
+				BR
+
+2C-0E-3D   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+2C0E3D     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+58-E1-6C   (hex)		Ying Hua Information Technology (Shanghai)Co., LTD
+58E16C     (base 16)		Ying Hua Information Technology (Shanghai)Co., LTD
+				Room 37 ,Building 13b, No. 4 , lane 600, Tianshan Road ,Changning District Shanghai 
+				Shanghai    201210
+				CN
+
+9C-7D-A3   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C7DA3     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-C6-4F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4C64F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-FD-17   (hex)		TCT mobile ltd
+CCFD17     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+DC-9F-DB   (hex)		Ubiquiti Networks Inc.
+DC9FDB     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Parkway
+				San Jose  CA  95131
+				US
+
+00-27-22   (hex)		Ubiquiti Networks Inc.
+002722     (base 16)		Ubiquiti Networks Inc.
+				91 E Tasman Dr
+				San Jose  CA  95134
+				US
+
+00-15-6D   (hex)		Ubiquiti Networks Inc.
+00156D     (base 16)		Ubiquiti Networks Inc.
+				495 Montague Expwy.
+				Milpitas  CA  95035
+				US
+
+00-D7-8F   (hex)		Cisco Systems, Inc
+00D78F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+2C-BA-BA   (hex)		Samsung Electronics Co.,Ltd
+2CBABA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+40-D3-AE   (hex)		Samsung Electronics Co.,Ltd
+40D3AE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-DD-95   (hex)		Taicang T&W Electronics
+2CDD95     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+88-E8-7F   (hex)		Apple, Inc.
+88E87F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-F4-8E   (hex)		Apple, Inc.
+9CF48E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+5C-F7-E6   (hex)		Apple, Inc.
+5CF7E6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B8-53-AC   (hex)		Apple, Inc.
+B853AC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-3C-AE   (hex)		Apple, Inc.
+203CAE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A0-3B-E3   (hex)		Apple, Inc.
+A03BE3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-32-75   (hex)		Apple, Inc.
+4C3275     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-7A-55   (hex)		ALE International
+487A55     (base 16)		ALE International
+				32 avenue Kléber
+				Colombes    92700
+				FR
+
+00-1E-AE   (hex)		Continental Automotive Systems Inc.
+001EAE     (base 16)		Continental Automotive Systems Inc.
+				21440 West Lake Cook Road
+				Deer Park  IL  60010
+				US
+
+50-2B-73   (hex)		Tenda Technology Co.,Ltd.Dongguan branch
+502B73     (base 16)		Tenda Technology Co.,Ltd.Dongguan branch
+				Room 79,Yuanyi Road,Dalang Town,Dongguan Guangdong 523770
+				Dongguan  Guangdong  523770
+				CN
+
+04-BA-36   (hex)		Li Seng Technology Ltd
+04BA36     (base 16)		Li Seng Technology Ltd
+				Rm901, 9/F Shiu Fung Hong Building, 239-241 Wing Lok Street, Hong Kong
+				Hong Kong    0000
+				HK
+
+10-72-23   (hex)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+107223     (base 16)		TELLESCOM INDUSTRIA E COMERCIO EM TELECOMUNICACAO 
+				Av. Buriti, 1900 – Setor B – Distrito Industrial
+				Manaus  Amazonas  69075-000
+				BR
+
+E0-68-6D   (hex)		Raybased AB
+E0686D     (base 16)		Raybased AB
+				A Odhners Gata 41
+				Västra Frölunda    42130
+				SE
+
+18-61-C7   (hex)		lemonbeat GmbH
+1861C7     (base 16)		lemonbeat GmbH
+				Deutsche Str. 5
+				Dortmund    44339
+				DE
+
+9C-DC-71   (hex)		Hewlett Packard Enterprise
+9CDC71     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+B4-F8-1E   (hex)		Kinova
+B4F81E     (base 16)		Kinova
+				6110, rue Doris-Lussier,
+				Boisbriand  Qc  J7H 0E8
+				CA
+
+D0-3D-C3   (hex)		AQ Corporation
+D03DC3     (base 16)		AQ Corporation
+				205, Saneop-ro 155beon-gil, Gwonseon-gu
+				Suwon  Gyeonggi-do  16648
+				KR
+
+EC-01-E2   (hex)		FOXCONN INTERCONNECT TECHNOLOGY
+EC01E2     (base 16)		FOXCONN INTERCONNECT TECHNOLOGY
+				66-1, Chungshan Rd., Tucheng Dist.
+				New Taipei City  Taiwan (R.O.C.)    23680
+				TW
+
+B4-E7-82   (hex)		Vivalnk
+B4E782     (base 16)		Vivalnk
+				4655 Old Ironsides Dr, #390
+				Santa Clara  CA  95054
+				US
+
+44-09-B8   (hex)		Salcomp (Shenzhen) CO., LTD.
+4409B8     (base 16)		Salcomp (Shenzhen) CO., LTD.
+				Salcomp Road, Furong Industrial Area, Xinqiao, Shajing, Baoan District
+				Shenzhen  Guangdong  518125
+				CN
+
+38-16-D1   (hex)		Samsung Electronics Co.,Ltd
+3816D1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-17-6A   (hex)		Samsung Electronics Co.,Ltd
+D0176A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D4-88-90   (hex)		Samsung Electronics Co.,Ltd
+D48890     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-92-BE   (hex)		Samsung Electronics Co.,Ltd
+5492BE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+20-5D-47   (hex)		vivo Mobile Communication Co., Ltd.
+205D47     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+10-C6-0C   (hex)		Domino UK Ltd
+10C60C     (base 16)		Domino UK Ltd
+				Trafalgar Way
+				Cambridge  Cambridgeshire  CB23 8TU
+				GB
+
+04-31-10   (hex)		Inspur Group Co., Ltd.
+043110     (base 16)		Inspur Group Co., Ltd.
+				No.1036 Langchao Rd.
+				Jinan  Shandong  250101
+				CN
+
+94-9A-A9   (hex)		Microsoft Corporation
+949AA9     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				REDMOND  WA  98052
+				US
+
+AC-AB-2E   (hex)		Beijing LasNubes Technology Co., Ltd.
+ACAB2E     (base 16)		Beijing LasNubes Technology Co., Ltd.
+				Chao-Yang-Bei-Lu No. 103, Room 1109-1110
+				Beijing    100025
+				CN
+
+60-0B-03   (hex)		Hangzhou H3C Technologies Co., Limited
+600B03     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+A0-AB-1B   (hex)		D-Link International
+A0AB1B     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+D8-42-E2   (hex)		Canary Connect, Inc.
+D842E2     (base 16)		Canary Connect, Inc.
+				132 East 43rd Street
+				New York    10017
+				US
+
+C8-B2-1E   (hex)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+C8B21E     (base 16)		CHIPSEA TECHNOLOGIES (SHENZHEN) CORP.
+				9F,BLOCK A,GARDEN CITY DIGITAL BUILDING,NO.1079 NANHAI ROAD,NANSHAN DISTRICT
+				SHEN ZHEN  GUANG DONG  518000
+				CN
+
+00-06-78   (hex)		D&M Holdings Inc.
+000678     (base 16)		D&M Holdings Inc.
+				D&M Building, 2-1 Nisshin-cho
+				Kawasaki-shi  Kanagawa   210-8569
+				JP
+
+E0-28-6D   (hex)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+E0286D     (base 16)		AVM Audiovisuelles Marketing und Computersysteme GmbH
+				Alt-Moabit 95
+				Berlin  Berlin  10559
+				DE
+
+88-4C-CF   (hex)		Pulzze Systems, Inc
+884CCF     (base 16)		Pulzze Systems, Inc
+				1290-B Reamwood Ave
+				Sunnyvale  CA  94089
+				US
+
+50-09-59   (hex)		Technicolor CH USA Inc.
+500959     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+E4-12-18   (hex)		ShenZhen Rapoo Technology Co., Ltd.
+E41218     (base 16)		ShenZhen Rapoo Technology Co., Ltd.
+				22,Jinxiu Road East,Pingshan District,Shenzhen,China
+				Shenzhen  Guangdong  518122
+				CN
+
+00-19-84   (hex)		ESTIC Corporation
+001984     (base 16)		ESTIC Corporation
+				2-5-9 Hashibahigashino-cho
+				Moriguchi  Osaka  570-0031
+				JP
+
+00-16-28   (hex)		Magicard Ltd
+001628     (base 16)		Magicard Ltd
+				Hampshire Road
+				Weymouth  Dorset  DT4 9XD
+				GB
+
+70-2E-22   (hex)		zte corporation
+702E22     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C8-E7-76   (hex)		PTCOM Technology
+C8E776     (base 16)		PTCOM Technology
+				NO.189-8, SEC. 3, NANJING E. RD., ZHONGSHAN DIST.
+				Taipei    10488
+				TW
+
+00-02-78   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+000278     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Mae-tan-dong,
+				Suwon  Suwon  KOREA
+				KR
+
+00-23-99   (hex)		Samsung Electronics Co.,Ltd
+002399     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3dong, yeongtong-gu, Suwon-city
+				suwon    443-742
+				KR
+
+00-17-C9   (hex)		Samsung Electronics Co.,Ltd
+0017C9     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan-3Dong, Yeongtong-Gu
+				Suwon  Geyonggi-Do  443-742
+				KR
+
+90-6E-BB   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+906EBB     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+18-F4-6A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+18F46A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+4C-0F-6E   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+4C0F6E     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+78-E4-00   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+78E400     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-21-2F   (hex)		Phoebe Micro Inc.
+00212F     (base 16)		Phoebe Micro Inc.
+				47606 Kato Rd
+				Fremont  CA  94538
+				US
+
+38-59-F9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+3859F9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+EC-55-F9   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+EC55F9     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C4-73-1E   (hex)		Samsung Electronics Co.,Ltd
+C4731E     (base 16)		Samsung Electronics Co.,Ltd
+				416, Maetan 3dong, Yeongtong-Gu
+				Suwon  Gyeonggi-Do  443742
+				KR
+
+5C-0A-5B   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+5C0A5B     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon    443-743
+				US
+
+7C-E9-D3   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+7CE9D3     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+1C-3E-84   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+1C3E84     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+B8-76-3F   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+B8763F     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+60-F4-94   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+60F494     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+80-56-F2   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+8056F2     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+7C-F8-54   (hex)		Samsung Electronics Co.,Ltd
+7CF854     (base 16)		Samsung Electronics Co.,Ltd
+				415, Maetan-3dong, Yeongtong-gu, Suwon-City Gyeonggi-do 443-742
+				Suwon    443-742
+				KR
+
+00-1B-98   (hex)		Samsung Electronics Co.,Ltd
+001B98     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				GUMI  Gyeong-Buk  730-350
+				KR
+
+00-1A-8A   (hex)		Samsung Electronics Co.,Ltd
+001A8A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi-City  Gyeong-Buk  730-350
+				KR
+
+3C-5A-37   (hex)		Samsung Electronics Co.,Ltd
+3C5A37     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F4-9F-54   (hex)		Samsung Electronics Co.,Ltd
+F49F54     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-C3-AC   (hex)		Samsung Electronics Co.,Ltd
+34C3AC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-F4-59   (hex)		Samsung Electronics Co.,Ltd
+44F459     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-26-5D   (hex)		Samsung Electronics Co.,Ltd
+00265D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-F9-E8   (hex)		Samsung Electronics Co.,Ltd
+CCF9E8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-57-EF   (hex)		Samsung Electronics Co.,Ltd
+D857EF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-E2-C2   (hex)		Samsung Electronics Co.,Ltd
+18E2C2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+98-52-B1   (hex)		Samsung Electronics Co.,Ltd
+9852B1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-40-E2   (hex)		Samsung Electronics Co.,Ltd
+E440E2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-3B-59   (hex)		Samsung Electronics Co.,Ltd
+103B59     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-90-E8   (hex)		Samsung Electronics Co.,Ltd
+D890E8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-62-EA   (hex)		Samsung Electronics Co.,Ltd
+C462EA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+14-F4-2A   (hex)		Samsung Electronics Co.,Ltd
+14F42A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+08-08-C2   (hex)		Samsung Electronics Co.,Ltd
+0808C2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-FE-3C   (hex)		Samsung Electronics Co.,Ltd
+CCFE3C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+28-BA-B5   (hex)		Samsung Electronics Co.,Ltd
+28BAB5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-26-66   (hex)		Samsung Electronics Co.,Ltd
+182666     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-D6-C9   (hex)		Samsung Electronics Co.,Ltd
+30D6C9     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+CC-07-AB   (hex)		Samsung Electronics Co.,Ltd
+CC07AB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-25-67   (hex)		Samsung Electronics Co.,Ltd
+002567     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-B1-F3   (hex)		Samsung Electronics Co.,Ltd
+BCB1F3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-62-B8   (hex)		Samsung Electronics Co.,Ltd
+1C62B8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-3A-28   (hex)		Samsung Electronics Co.,Ltd
+B43A28     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+78-A8-73   (hex)		Samsung Electronics Co.,Ltd
+78A873     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-1C-43   (hex)		Samsung Electronics Co.,Ltd
+001C43     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-23-D6   (hex)		Samsung Electronics Co.,Ltd
+0023D6     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+E4-12-1D   (hex)		Samsung Electronics Co.,Ltd
+E4121D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-D6-E1   (hex)		Snuza International Pty. Ltd.
+44D6E1     (base 16)		Snuza International Pty. Ltd.
+				Unit 11, Roeland Square, Roeland Street
+				Cape Town  Western Cape  8001
+				ZA
+
+FC-91-14   (hex)		Technicolor CH USA Inc.
+FC9114     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+48-6D-BB   (hex)		Vestel Elektronik San ve Tic. A.Ş.
+486DBB     (base 16)		Vestel Elektronik San ve Tic. A.Ş.
+				Organize san
+				Manisa  Turket  45030
+				TR
+
+00-2A-10   (hex)		Cisco Systems, Inc
+002A10     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-A2-89   (hex)		Cisco Systems, Inc
+00A289     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+44-E9-DD   (hex)		Sagemcom Broadband SAS
+44E9DD     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+00-0F-5E   (hex)		Veo
+000F5E     (base 16)		Veo
+				910 Rincon Circle
+				San Jose  CA  95131
+				US
+
+00-13-28   (hex)		Westech Korea Inc.,
+001328     (base 16)		Westech Korea Inc.,
+				548-9, Gajwa3-Dong,Seo-ku,
+				Incheon    404-817
+				KR
+
+B8-BF-83   (hex)		Intel Corporate
+B8BF83     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+8C-61-02   (hex)		Beijing Baofengmojing Technologies Co., Ltd
+8C6102     (base 16)		Beijing Baofengmojing Technologies Co., Ltd
+				7/F, Tower C, Zhizhen Plaza, No.7 Zhichun Rd, Haidian District
+				Beijing    100191
+				CN
+
+54-8C-A0   (hex)		Liteon Technology Corporation
+548CA0     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+7C-79-E8   (hex)		PayRange Inc.
+7C79E8     (base 16)		PayRange Inc.
+				700 NE Multnomah St. Ste 1400
+				Portland  OR  97232
+				US
+
+A4-31-11   (hex)		ZIV
+A43111     (base 16)		ZIV
+				Polígono Parque Tecnológico, 210
+				ZAMUDIO  VIZCAYA  48170
+				ES
+
+00-80-73   (hex)		DWB ASSOCIATES
+008073     (base 16)		DWB ASSOCIATES
+				9360 SW GEMINI DRIVE
+				BEAVERTON  OR  97005-7151
+				US
+
+80-A1-D7   (hex)		Shanghai DareGlobal Technologies Co.,Ltd
+80A1D7     (base 16)		Shanghai DareGlobal Technologies Co.,Ltd
+				22F,Info Tech Building,No.1555,Kongjiang Rd.
+				Shanghai    200092
+				CN
+
+EC-1F-72   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+EC1F72     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93 Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+8C-0D-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C0D76     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-BE-52   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+84BE52     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-9F-B5   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+849FB5     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-CA-A0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A4CAA0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+84-E0-F4   (hex)		IEEE Registration Authority
+84E0F4     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D8-30-62   (hex)		Apple, Inc.
+D83062     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-E5-4D   (hex)		ARRIS Group, Inc.
+D0E54D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A0-C5-62   (hex)		ARRIS Group, Inc.
+A0C562     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+84-96-D8   (hex)		ARRIS Group, Inc.
+8496D8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-D9   (hex)		ARRIS Group, Inc.
+0026D9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E8-50-8B   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+E8508B     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+F8-04-2E   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+F8042E     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak
+				Bangpakong  Chachoengsao  24180
+				TH
+
+00-D0-37   (hex)		ARRIS Group, Inc.
+00D037     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+84-E0-58   (hex)		ARRIS Group, Inc.
+84E058     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+70-76-30   (hex)		ARRIS Group, Inc.
+707630     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+04-BB-F9   (hex)		Pavilion Data Systems Inc
+04BBF9     (base 16)		Pavilion Data Systems Inc
+				2560 N 1st St, #220
+				San Jose  CA  95131
+				US
+
+E4-BE-ED   (hex)		Netcore Technology Inc.
+E4BEED     (base 16)		Netcore Technology Inc.
+				ORIENTAL CYBERPORT,HIGHTECH 6 ROAD
+				Shenzhen    518057
+				CN
+
+58-FB-84   (hex)		Intel Corporate
+58FB84     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-A0-0E   (hex)		NetAlly
+00A00E     (base 16)		NetAlly
+				310 Littleton Road
+				Westford  MA  01886 
+				US
+
+00-C0-17   (hex)		NetAlly
+00C017     (base 16)		NetAlly
+				2075 Research Parkway
+				Colorado Springs  CO  80920
+				US
+
+5C-B0-66   (hex)		ARRIS Group, Inc.
+5CB066     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+BC-8A-A3   (hex)		NHN Entertainment
+BC8AA3     (base 16)		NHN Entertainment
+				Play Museum, 629 Sampyeong-dong, Bundang-gu
+				Seongnam-si, Gyeonggi-do    463-400
+				KR
+
+A8-BD-27   (hex)		Hewlett Packard Enterprise
+A8BD27     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+34-57-60   (hex)		MitraStar Technology Corp.
+345760     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+C0-D3-91   (hex)		IEEE Registration Authority
+C0D391     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D4-9B-5C   (hex)		Chongqing Miedu Technology Co., Ltd.
+D49B5C     (base 16)		Chongqing Miedu Technology Co., Ltd.
+				7-602 No.118 DaPing Main Street Yuzhong District
+				Chongqing    400000
+				CN
+
+E8-EB-11   (hex)		Texas Instruments
+E8EB11     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+44-BF-E3   (hex)		Shenzhen Longtech Electronics Co.,Ltd
+44BFE3     (base 16)		Shenzhen Longtech Electronics Co.,Ltd
+				No.148 Zhengfeng Industrial Area Donghuan RD Huangpu Village Shaijing Town Baoan District
+				Shenzhen  Guangdong  518125
+				CN
+
+3C-6F-EA   (hex)		Panasonic India Pvt. Ltd.
+3C6FEA     (base 16)		Panasonic India Pvt. Ltd.
+				12th Floor, Ambience Tower, Ambience Island, NH - 8
+				Gurgaon  Haryana  122002
+				IN
+
+00-22-61   (hex)		Frontier Silicon Ltd
+002261     (base 16)		Frontier Silicon Ltd
+				137 Euston Road
+				London    NW12AA
+				GB
+
+00-19-88   (hex)		Wi2Wi, Inc
+001988     (base 16)		Wi2Wi, Inc
+				2107 N. 1st Street
+				San Jose  CA  95131
+				US
+
+18-DC-56   (hex)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+18DC56     (base 16)		Yulong Computer Telecommunication Scientific (Shenzhen) Co.,Ltd
+				8/F.high Tech Plaza,TianAn Cyberpark,Chegongmiao
+				Shenzhen  Guangdong  518040
+				CN
+
+00-16-F2   (hex)		Dmobile System Co., Ltd.
+0016F2     (base 16)		Dmobile System Co., Ltd.
+				2F, No.13-20, Sec.6, Mincyuan E.Rd,
+				Taipei    114
+				TW
+
+34-07-4F   (hex)		AccelStor, Inc.
+34074F     (base 16)		AccelStor, Inc.
+				10F, No. 465, Sec. 6, Zhongxiao E. Rd., Nangang Dist.
+				Taipei City    11557
+				TW
+
+B4-A9-84   (hex)		Symantec Corporation
+B4A984     (base 16)		Symantec Corporation
+				350 Ellis Street
+				Mountain View  CA  94043
+				US
+
+B0-B2-8F   (hex)		Sagemcom Broadband SAS
+B0B28F     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+44-14-41   (hex)		AudioControl Inc.
+441441     (base 16)		AudioControl Inc.
+				22410 70Th Ave West, STE 1 
+				Mountlake Terrace  WA  98043
+				US
+
+C8-8D-83   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C88D83     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-E0-11   (hex)		UNIDEN CORPORATION
+00E011     (base 16)		UNIDEN CORPORATION
+				2-12-7 Hatchobori,
+				Chuo-ku  Tokyo  104-8512
+				JP
+
+00-25-55   (hex)		Visonic Technologies 1993 Ltd.
+002555     (base 16)		Visonic Technologies 1993 Ltd.
+				23 Habarzel st'
+				Tel - Aviv    69710
+				IL
+
+58-98-6F   (hex)		Revolution Display
+58986F     (base 16)		Revolution Display
+				912 Ruberta Ave
+				Glendale  CA  91201
+				US
+
+C8-1F-BE   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C81FBE     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+20-3D-B2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+203DB2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-D5-39   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48D539     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-1F-9A   (hex)		Nortel Networks
+001F9A     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75082-4399
+				US
+
+00-0A-0E   (hex)		Invivo Research Inc.
+000A0E     (base 16)		Invivo Research Inc.
+				12601 Research Parkway
+				Orlando  Florida  32826
+				US
+
+00-16-60   (hex)		Nortel Networks
+001660     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-1E-7E   (hex)		Nortel Networks
+001E7E     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-13-65   (hex)		Nortel Networks
+001365     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-04-38   (hex)		Nortel Networks
+000438     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+00-0E-C0   (hex)		Nortel Networks
+000EC0     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+D8-4F-B8   (hex)		LG ELECTRONICS
+D84FB8     (base 16)		LG ELECTRONICS
+				84 Wanam-ro Seongsan-gu
+				Changwon-si  Gyeongsangnam-do  642-713
+				KR
+
+00-0A-EB   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+000AEB     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Hi-Tech Park R1-B3
+				Shenzhen  Guangdong  518057
+				CN
+
+2C-37-31   (hex)		SHENZHEN YIFANG DIGITAL TECHNOLOGY CO.,LTD.
+2C3731     (base 16)		SHENZHEN YIFANG DIGITAL TECHNOLOGY CO.,LTD.
+				Building # 22 and #23, Zone 5, Bai Wang Xin Industrial Park, Song Bai Road
+				ShenZhen  GUANGDONG  518108
+				CN
+
+60-EE-5C   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+60EE5C     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+64-88-FF   (hex)		Sichuan Changhong Electric Ltd.
+6488FF     (base 16)		Sichuan Changhong Electric Ltd.
+				35 East Mianxing Road,High-Tech Park,
+				MianYang  SiChuan  621000
+				CN
+
+00-21-62   (hex)		Nortel Networks
+002162     (base 16)		Nortel Networks
+				8200 Dixie Rd
+				Brampton  Ontario  0000
+				CA
+
+02-E6-D3   (hex)		NIXDORF COMPUTER CORP.
+02E6D3     (base 16)		NIXDORF COMPUTER CORP.
+				NIXDORF TECHNOLOGY CENTER
+				SANTA CLARA  CA  95054
+				US
+
+00-16-B9   (hex)		ProCurve Networking by HP
+0016B9     (base 16)		ProCurve Networking by HP
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+C4-08-4A   (hex)		Nokia
+C4084A     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+00-08-01   (hex)		HighSpeed Surfing Inc.
+000801     (base 16)		HighSpeed Surfing Inc.
+				44790 S. Grimmer Blvd.
+				Fremont  CA  94538
+				US
+
+00-07-72   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+000772     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+E0-30-05   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+E03005     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+3C-40-4F   (hex)		GUANGDONG PISEN ELECTRONICS CO.,LTD
+3C404F     (base 16)		GUANGDONG PISEN ELECTRONICS CO.,LTD
+				Building C,Liuyue Jintang Industry Zone
+				Shenzhen  Guangdong  518173
+				CN
+
+0C-A4-02   (hex)		Alcatel-Lucent IPD
+0CA402     (base 16)		Alcatel-Lucent IPD
+				600 March Drive
+				Kanata  Ontario  K2K2E6
+				CA
+
+A0-F3-E4   (hex)		Alcatel-Lucent IPD
+A0F3E4     (base 16)		Alcatel-Lucent IPD
+				600 March Drive
+				Kanata  Ontario  K2K2E6
+				CA
+
+84-DB-FC   (hex)		Nokia
+84DBFC     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+7C-FC-3C   (hex)		Visteon Corporation
+7CFC3C     (base 16)		Visteon Corporation
+				One Village Center Drive
+				Van Buren Twp  MI  48111
+				US
+
+98-1E-0F   (hex)		Jeelan (Shanghai Jeelan Technology Information Inc
+981E0F     (base 16)		Jeelan (Shanghai Jeelan Technology Information Inc
+				Room 302,Building 17, No.658, Jinzhong Road
+				shanghai    200052
+				CN
+
+48-88-CA   (hex)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+4888CA     (base 16)		Motorola (Wuhan) Mobility Technologies Communication Co., Ltd.
+				No.19, Gaoxin 4th Road, Wuhan East Lake High-tech Zone, Wuhan
+				Wuhan  Hubei  430000
+				CN
+
+38-56-10   (hex)		CANDY HOUSE, Inc.
+385610     (base 16)		CANDY HOUSE, Inc.
+				119 University Ave.
+				Palo Alto  CA  94301
+				US
+
+00-A7-42   (hex)		Cisco Systems, Inc
+00A742     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-AA-70   (hex)		LG Electronics (Mobile Communications)
+00AA70     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+F8-95-C7   (hex)		LG Electronics (Mobile Communications)
+F895C7     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+84-D9-31   (hex)		Hangzhou H3C Technologies Co., Limited
+84D931     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+00-11-6E   (hex)		Peplink International Ltd.
+00116E     (base 16)		Peplink International Ltd.
+				17/F., Park Building
+				Cheung Sha Wan  Kowloon  0000
+				HK
+
+54-09-55   (hex)		zte corporation
+540955     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-1E-75   (hex)		LG Electronics (Mobile Communications)
+001E75     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-1C-62   (hex)		LG Electronics (Mobile Communications)
+001C62     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+50-55-27   (hex)		LG Electronics (Mobile Communications)
+505527     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+88-C9-D0   (hex)		LG Electronics (Mobile Communications)
+88C9D0     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+C0-41-F6   (hex)		LG ELECTRONICS INC
+C041F6     (base 16)		LG ELECTRONICS INC
+				19-1,Cheongho-Ri,Jinwi-Myeon
+				Pyeongtaek  Gyeonggi-Do  451-713
+				KR
+
+8C-3A-E3   (hex)		LG Electronics (Mobile Communications)
+8C3AE3     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+90-A4-6A   (hex)		SISNET CO., LTD
+90A46A     (base 16)		SISNET CO., LTD
+				1409, SJ Technoville 60-19, Gasan-dong, Geumcheon-Gu
+				Seoul    KS013
+				KR
+
+14-E7-C8   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+14E7C8     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+EC-CD-6D   (hex)		Allied Telesis, Inc.
+ECCD6D     (base 16)		Allied Telesis, Inc.
+				3041 Orchard Parkway
+				San Jose    95134
+				US
+
+18-33-9D   (hex)		Cisco Systems, Inc
+18339D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+14-61-02   (hex)		Alpine Electronics, Inc.
+146102     (base 16)		Alpine Electronics, Inc.
+				20-1, Yoshima Industrial Park
+				Iwaki  Fukushima  970-1192
+				JP
+
+54-27-6C   (hex)		Jiangsu Houge Technology Corp.
+54276C     (base 16)		Jiangsu Houge Technology Corp.
+				No.20 Xizhang North Road, Fenghuang Town
+				Zhangjiagang  Jiangsu  215614
+				CN
+
+9C-A3-A9   (hex)		Guangzhou Juan Optical and Electronical Tech Joint Stock Co., Ltd
+9CA3A9     (base 16)		Guangzhou Juan Optical and Electronical Tech Joint Stock Co., Ltd
+				NO.9, street 3, HengLing industrial zone, Tangdong, tianhe district
+				Guangzhou  Guangdong  510000
+				CN
+
+7C-C7-09   (hex)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+7CC709     (base 16)		SHENZHEN RF-LINK TECHNOLOGY CO.,LTD.
+				Bldg56A, 6/F, Baotian Rd3, Baoan District, Shenzhen, P.R.C
+				Shenzhen  Guangdong  518100
+				CN
+
+A0-3E-6B   (hex)		IEEE Registration Authority
+A03E6B     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+98-02-D8   (hex)		IEEE Registration Authority
+9802D8     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+64-FB-81   (hex)		IEEE Registration Authority
+64FB81     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+08-21-EF   (hex)		Samsung Electronics Co.,Ltd
+0821EF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-14-5F   (hex)		Samsung Electronics Co.,Ltd
+34145F     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+2C-26-5F   (hex)		IEEE Registration Authority
+2C265F     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+D0-05-2A   (hex)		Arcadyan Corporation
+D0052A     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+E4-50-9A   (hex)		HW Communications Ltd
+E4509A     (base 16)		HW Communications Ltd
+				Parkfield
+				Lancaster    LA1 4TZ
+				GB
+
+70-29-00   (hex)		Shenzhen ChipTrip Technology Co,Ltd
+702900     (base 16)		Shenzhen ChipTrip Technology Co,Ltd
+				The 8th floor of  VIA Technology Building  NO. 9966 Shennan road , Nanshan Distict  Shenzhen
+				Shenzhen    518000
+				CN
+
+EC-AA-A0   (hex)		PEGATRON CORPORATION
+ECAAA0     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+00-E0-DD   (hex)		Zenith Electronics Corporation
+00E0DD     (base 16)		Zenith Electronics Corporation
+				1000 MILWAUKEE AVENUE
+				GLENVIEW  IL  60025
+				US
+
+50-CE-75   (hex)		Measy Electronics Co., Ltd.
+50CE75     (base 16)		Measy Electronics Co., Ltd.
+				#1506, Block B, Hai Song Bldg, Tairan 9th Road
+				Shenzhen  Guang Dong   518040
+				CN
+
+00-04-5B   (hex)		Techsan Electronics Co., Ltd.
+00045B     (base 16)		Techsan Electronics Co., Ltd.
+				North Wing
+				  UNITED  KINGDOM
+				GB
+
+00-07-BA   (hex)		UTStarcom Inc
+0007BA     (base 16)		UTStarcom Inc
+				1275 Harbor Bay PKWY
+				Alameda  CA  94502
+				US
+
+90-A2-10   (hex)		United Telecoms Ltd
+90A210     (base 16)		United Telecoms Ltd
+				18A/19,Doddanekundi Industrial Area,
+				Bangalore  Karanataka  560048
+				IN
+
+6C-0B-84   (hex)		Universal Global Scientific Industrial Co., Ltd.
+6C0B84     (base 16)		Universal Global Scientific Industrial Co., Ltd.
+				141, Lane 351, TaiPing Road, Sec.1
+				Tsao-Tuen   Nan-Tou  54261
+				TW
+
+00-15-97   (hex)		AETA AUDIO SYSTEMS
+001597     (base 16)		AETA AUDIO SYSTEMS
+				18-22, avenue Edouard Herriot
+				Le Plessis Robinson    92350
+				FR
+
+00-23-97   (hex)		Westell Technologies Inc.
+002397     (base 16)		Westell Technologies Inc.
+				750 N Commons Dr
+				Aurora  IL  60504
+				US
+
+60-E3-AC   (hex)		LG Electronics (Mobile Communications)
+60E3AC     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+90-F0-52   (hex)		MEIZU Technology Co., Ltd.
+90F052     (base 16)		MEIZU Technology Co., Ltd.
+				MEIZU Tech Bldg., Technology & Innovation Coast
+				Zhuhai  Guangdong  519085
+				CN
+
+00-16-39   (hex)		Ubiquam Co., Ltd.
+001639     (base 16)		Ubiquam Co., Ltd.
+				Technovill 4F,272-3 Yatap3
+				Seongnam  Kyeonggi  463-836
+				KR
+
+00-0C-29   (hex)		VMware, Inc.
+000C29     (base 16)		VMware, Inc.
+				3401 Hillview Avenue
+				Palo Alto  CA  94304
+				US
+
+00-05-69   (hex)		VMware, Inc.
+000569     (base 16)		VMware, Inc.
+				3401 Hillview Avenue
+				Palo Alto  CA  94304
+				US
+
+00-0B-0E   (hex)		Trapeze Networks
+000B0E     (base 16)		Trapeze Networks
+				5753 W. Las Positas Blvd
+				Pleasanton  CA  94588
+				US
+
+8C-FD-F0   (hex)		Qualcomm Inc.
+8CFDF0     (base 16)		Qualcomm Inc.
+				5775 Morehouse Drive
+				San Diego  CA  92121
+				US
+
+C4-BB-4C   (hex)		Zebra Information Tech Co. Ltd
+C4BB4C     (base 16)		Zebra Information Tech Co. Ltd
+				Room 415, No.569 Anchi Road, JiaDing District 
+				Shanghai    201804
+				CN
+
+98-CF-53   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+98CF53     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+D4-A1-48   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D4A148     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D0-65-CA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+D065CA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-6B-2C   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+486B2C     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+6C-25-B9   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+6C25B9     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+2C-28-2D   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+2C282D     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+48-13-F3   (hex)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+4813F3     (base 16)		BBK EDUCATIONAL ELECTRONICS CORP.,LTD.
+				 LiWu INDUSTRIAL PARK,Wusha,Chang'an
+				Dong Guan   Guang Dong  523860
+				CN
+
+00-40-9F   (hex)		Telco Systems, Inc. 
+00409F     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield,  MA  02048
+				US
+
+00-00-1F   (hex)		Telco Systems, Inc. 
+00001F     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield  MA  02048
+				US
+
+00-A0-12   (hex)		Telco Systems, Inc. 
+00A012     (base 16)		Telco Systems, Inc. 
+				15 Berkshire Road
+				Mansfield  MA  02048
+				US
+
+8C-EB-C6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8CEBC6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B0-89-00   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B08900     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+78-CB-68   (hex)		DAEHAP HYPER-TECH
+78CB68     (base 16)		DAEHAP HYPER-TECH
+				302,Galmachiro,Woolim Lions Valley 5-cha #A-810,Jungwon-Gu
+				Seongnam,  Gyeonggido  445-918
+				KR
+
+34-ED-0B   (hex)		 Shanghai XZ-COM.CO.,Ltd.
+34ED0B     (base 16)		 Shanghai XZ-COM.CO.,Ltd.
+				11th Floor,B Building ,No.100 Qinzhou  Road  ,Shanghai
+				shanghai  shanghai  200235
+				CN
+
+F0-DE-F1   (hex)		Wistron Infocomm (Zhongshan) Corporation
+F0DEF1     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				168KunShan, 
+				JiangSu    215300
+				CN
+
+F8-0F-41   (hex)		Wistron Infocomm (Zhongshan) Corporation
+F80F41     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				Torch High-tech Industrial Development Zone, 
+				ZhongShan  Guangdong  528437
+				CN
+
+3C-97-0E   (hex)		Wistron InfoComm(Kunshan)Co.,Ltd.
+3C970E     (base 16)		Wistron InfoComm(Kunshan)Co.,Ltd.
+				168# First Avence, 
+				Kunshan  JiangSu  215300
+				CN
+
+30-14-4A   (hex)		Wistron Neweb Corporation
+30144A     (base 16)		Wistron Neweb Corporation
+				20 Park Avenue II, Hsin Science Park, Hsinchu 308, Taiwan
+				HsinChu  Taiwan  308
+				TW
+
+4C-0B-BE   (hex)		Microsoft
+4C0BBE     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+0C-25-76   (hex)		LONGCHEER TELECOMMUNICATION LIMITED
+0C2576     (base 16)		LONGCHEER TELECOMMUNICATION LIMITED
+				Building 1,No.401,Caobao Rd
+				Shanghai  Xuhui District  200233
+				CN
+
+D8-D4-3C   (hex)		Sony Corporation
+D8D43C     (base 16)		Sony Corporation
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+D4-41-65   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+D44165     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road, 
+				Chengdu  Sichuan  610000
+				CN
+
+E4-02-9B   (hex)		Intel Corporate
+E4029B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+DC-1A-C5   (hex)		vivo Mobile Communication Co., Ltd.
+DC1AC5     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong  523860
+				CN
+
+F4-5E-AB   (hex)		Texas Instruments
+F45EAB     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+A8-FC-B7   (hex)		Consolidated Resource Imaging
+A8FCB7     (base 16)		Consolidated Resource Imaging
+				2943 S Wilson CT NW
+				Grand Rapids  MI  49534
+				US
+
+00-C0-00   (hex)		LANOPTICS, LTD.
+00C000     (base 16)		LANOPTICS, LTD.
+				P.O. BOX 184
+				ISRAEL  ISRAEL  10551
+				IL
+
+84-51-81   (hex)		Samsung Electronics Co.,Ltd
+845181     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-C2-87   (hex)		Technicolor CH USA Inc.
+B0C287     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+CC-35-40   (hex)		Technicolor CH USA Inc.
+CC3540     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+8C-04-FF   (hex)		Technicolor CH USA Inc.
+8C04FF     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+FC-94-E3   (hex)		Technicolor CH USA Inc.
+FC94E3     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6
+				Lawrenceville  GA  30044
+				US
+
+B8-8D-12   (hex)		Apple, Inc.
+B88D12     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-EF-68   (hex)		Zyxel Communications Corporation
+90EF68     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+C8-16-BD   (hex)		Qingdao Hisense Communications Co.,Ltd.
+C816BD     (base 16)		Qingdao Hisense Communications Co.,Ltd.
+				Qianwangang Road 218
+				Qingdao  Shandong  266510
+				CN
+
+00-EB-D5   (hex)		Cisco Systems, Inc
+00EBD5     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C4-8F-07   (hex)		Shenzhen Yihao Hulian Science and Technology Co., Ltd.
+C48F07     (base 16)		Shenzhen Yihao Hulian Science and Technology Co., Ltd.
+				Room A, Floor 6, Building 210, Tairan Industry and Trade Park, Che Kung Temple, Futian District, Shenzhen, Guangdong Province
+				ShenZhen  Guangdong  518000
+				CN
+
+DC-78-34   (hex)		LOGICOM SA
+DC7834     (base 16)		LOGICOM SA
+				55 Rue de Lisbonne
+				PARIS    75008
+				FR
+
+CC-CC-81   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CCCC81     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+6C-95-22   (hex)		Scalys
+6C9522     (base 16)		Scalys
+				Lansinkesweg 4
+				Hengelo    7553 AE
+				NL
+
+B4-56-B9   (hex)		Teraspek Technologies Co.,Ltd
+B456B9     (base 16)		Teraspek Technologies Co.,Ltd
+				14th floor,Block C,Beijing International Building, Zhongguancun South Street, Beijng, China, 100081
+				Beijing    100081
+				CN
+
+9C-DD-1F   (hex)		Intelligent Steward Co.,Ltd
+9CDD1F     (base 16)		Intelligent Steward Co.,Ltd
+				Room 508-598 XiTianGeZhuang Town Government Office Building,8# XiTong Road ,Economic Development District ,MiYun County ,BeiJing City 
+				BeiJing City     101509
+				CN
+
+3C-68-16   (hex)		VXi Corporation
+3C6816     (base 16)		VXi Corporation
+				271 Locust Street
+				Dover  NH  03820
+				US
+
+E8-11-CA   (hex)		SHANDONG KAER ELECTRIC.CO.,LTD
+E811CA     (base 16)		SHANDONG KAER ELECTRIC.CO.,LTD
+				No.58, Dalian Road, Weihai, 264209 Shandong Province, P.R.China 
+				Weihai  Shandong  264209
+				CN
+
+70-28-8B   (hex)		Samsung Electronics Co.,Ltd
+70288B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-8A-7B   (hex)		Samsung Electronics Co.,Ltd
+348A7B     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D0-57-7B   (hex)		Intel Corporate
+D0577B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+78-00-9E   (hex)		Samsung Electronics Co.,Ltd
+78009E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-C3-3A   (hex)		Samsung Electronics Co.,Ltd
+ACC33A     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-F2-01   (hex)		Samsung Electronics Co.,Ltd
+54F201     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C4-A3-66   (hex)		zte corporation
+C4A366     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+60-73-BC   (hex)		zte corporation
+6073BC     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+7C-35-48   (hex)		Transcend Information
+7C3548     (base 16)		Transcend Information
+				No.70, XingZhong Rd., NeiHu Dist.,
+				Taipei  Taiwan  114
+				TW
+
+18-B1-69   (hex)		Sonicwall
+18B169     (base 16)		Sonicwall
+				2001 Logic Drive
+				San Jose  CA  95124-3452
+				US
+
+44-44-50   (hex)		OttoQ
+444450     (base 16)		OttoQ
+				20370 Town Center Lane, Suite 205
+				Cupertino  CA  95014
+				US
+
+50-F5-DA   (hex)		Amazon Technologies Inc.
+50F5DA     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+10-12-12   (hex)		Vivo International Corporation Pty Ltd
+101212     (base 16)		Vivo International Corporation Pty Ltd
+				9-13 Bibby Street, 
+				NSW  Chiswick  2046
+				AU
+
+C8-5B-76   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+C85B76     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+78-FF-CA   (hex)		TECNO MOBILE LIMITED
+78FFCA     (base 16)		TECNO MOBILE LIMITED
+				ROOMS 05-15, 13A/F., SOUTH TOWER, WORLD FINANCE CENTRE, HARBOUR CITY, 17 CANTON ROAD, TSIM SHA TSUI, KOWLOON, HONG KONG
+				Hong Kong  Hong Kong  999077
+				HK
+
+04-65-65   (hex)		Testop
+046565     (base 16)		Testop
+				808, Hanshin IT tower, 272 digital-ro
+				Guro-gu  Seoul  KS013
+				KR
+
+A8-BB-50   (hex)		WiZ IoT Company Limited
+A8BB50     (base 16)		WiZ IoT Company Limited
+				148 Electric Road
+				Hong Kong    0000
+				HK
+
+08-C0-21   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+08C021     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-08-10   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+600810     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-43-5A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+48435A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+8C-8E-F2   (hex)		Apple, Inc.
+8C8EF2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+90-B0-ED   (hex)		Apple, Inc.
+90B0ED     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-3E-BF   (hex)		GOGORO TAIWAN LIMITED
+F03EBF     (base 16)		GOGORO TAIWAN LIMITED
+				No.33 Dinghu Rd.
+				GuiShan Dist.  Taoyuan  333
+				TW
+
+3C-92-DC   (hex)		Octopod Technology Co. Ltd.
+3C92DC     (base 16)		Octopod Technology Co. Ltd.
+				822 Lane Zhennan Road
+				Shanghai    200331
+				CN
+
+10-00-FD   (hex)		LaonPeople
+1000FD     (base 16)		LaonPeople
+				402-3, Bundang Techno Park B, 148
+				Sungnam-si  Gyeonggi-do  463-760
+				KR
+
+C4-7C-8D   (hex)		IEEE Registration Authority
+C47C8D     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+74-5C-9F   (hex)		TCT mobile ltd
+745C9F     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+8C-99-E6   (hex)		TCT mobile ltd
+8C99E6     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+44-9F-7F   (hex)		DataCore Software Corporation
+449F7F     (base 16)		DataCore Software Corporation
+				6300 NW 5th Way
+				Fort Lauderdale  FL  33309
+				US
+
+84-83-19   (hex)		Hangzhou Zero Zero Technology Co., Ltd.
+848319     (base 16)		Hangzhou Zero Zero Technology Co., Ltd.
+				Bldg 13&14, Dream Town, Hangzhou, Zhejiang
+				Hangzhou  Zhejiang  310000
+				CN
+
+A8-15-59   (hex)		Breathometer, Inc.
+A81559     (base 16)		Breathometer, Inc.
+				863 Mitten Road, Suite 104
+				Burlingame  CA  94010
+				US
+
+70-BA-EF   (hex)		Hangzhou H3C Technologies Co., Limited
+70BAEF     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District,
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+58-6A-B1   (hex)		Hangzhou H3C Technologies Co., Limited
+586AB1     (base 16)		Hangzhou H3C Technologies Co., Limited
+				466 Changhe Road, Binjiang District,
+				Hangzhou  Zhejiang, P.R.China  310052
+				CN
+
+00-90-06   (hex)		Hamamatsu Photonics K.K.
+009006     (base 16)		Hamamatsu Photonics K.K.
+				812 JOKO-CHO
+				HAMAMATSU    431-3196
+				JP
+
+00-1A-F4   (hex)		Handreamnet
+001AF4     (base 16)		Handreamnet
+				#1209 MarioTower, 28
+				Seoul    152-741
+				KR
+
+04-D3-CF   (hex)		Apple, Inc.
+04D3CF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-82-F2   (hex)		Appel Elektronik GmbH
+4882F2     (base 16)		Appel Elektronik GmbH
+				Ludwig-Rinn-Str.10
+				Heuchelheim  Hessen  35452
+				DE
+
+78-B8-4B   (hex)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+78B84B     (base 16)		SICHUAN TIANYI COMHEART TELECOMCO.,LTD
+				FL12,TowerB,Tianyi international Hotel,No.2 West Section One, Second Ring Road,
+				Chengdu  Sichuan  610000
+				CN
+
+7C-B0-C2   (hex)		Intel Corporate
+7CB0C2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-17-93   (hex)		Tigi Corporation
+001793     (base 16)		Tigi Corporation
+				2070 Chain Bridge road
+				Vienna  Va  22182
+				US
+
+00-03-58   (hex)		Hanyang Digitech Co.Ltd
+000358     (base 16)		Hanyang Digitech Co.Ltd
+				13F, Acetwintower2, 212-30, Guro-Dong
+				Seoul    12304
+				KR
+
+C4-CA-D9   (hex)		Hangzhou H3C Technologies Co., Limited
+C4CAD9     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+58-66-BA   (hex)		Hangzhou H3C Technologies Co., Limited
+5866BA     (base 16)		Hangzhou H3C Technologies Co., Limited
+				310 Liuhe Road, Zhijiang Science Park
+				Hangzhou  Zhejiang,   310053
+				CN
+
+E0-C7-9D   (hex)		Texas Instruments
+E0C79D     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+4C-0B-3A   (hex)		TCT mobile ltd
+4C0B3A     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+E4-2D-02   (hex)		TCT mobile ltd
+E42D02     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+0C-BD-51   (hex)		TCT mobile ltd
+0CBD51     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+40-00-E0   (hex)		Derek(Shaoguan)Limited
+4000E0     (base 16)		Derek(Shaoguan)Limited
+				Gaojiling,Taiping Town, Shixing County
+				Shaoguan  Guangdong  512500
+				CN
+
+FC-BC-9C   (hex)		Vimar Spa
+FCBC9C     (base 16)		Vimar Spa
+				Viale Vicenza 14
+				Marostica  Vicenza  36063
+				IT
+
+14-9E-CF   (hex)		Dell Inc.
+149ECF     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+E8-09-59   (hex)		Guoguang Electric Co.,Ltd
+E80959     (base 16)		Guoguang Electric Co.,Ltd
+				No.8 Jinghu Road, Xinhua Street, Huadu Reg
+				Guangzhou  Guangdong  510800
+				CN
+
+D8-94-03   (hex)		Hewlett Packard Enterprise
+D89403     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+E0-0E-DA   (hex)		Cisco Systems, Inc
+E00EDA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+D0-A4-B1   (hex)		Sonifex Ltd.
+D0A4B1     (base 16)		Sonifex Ltd.
+				61 Station Road
+				Irthlingborough  Northamptonshire  NN9 5QE
+				GB
+
+F4-9E-EF   (hex)		Taicang T&W Electronics
+F49EEF     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+C4-F0-81   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C4F081     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+80-13-82   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+801382     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-FE-22   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94FE22     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-CC-55   (hex)		Juniper Networks
+F4CC55     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+50-DD-4F   (hex)		Automation Components, Inc
+50DD4F     (base 16)		Automation Components, Inc
+				2305 Pleasant View Rd
+				Middleton  WI  53562
+				US
+
+34-1F-E4   (hex)		ARRIS Group, Inc.
+341FE4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-24-F4   (hex)		Kaminario, Ltd.
+0024F4     (base 16)		Kaminario, Ltd.
+				Yatam Industrial Park
+				Yokneam  ISRAEL  20692
+				IL
+
+00-1A-29   (hex)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+001A29     (base 16)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+				1220 Old Alpharetta Rd
+				Alpharetta  GA  30041
+				US
+
+00-90-AE   (hex)		ITALTEL S.p.A/RF-UP-I
+0090AE     (base 16)		ITALTEL S.p.A/RF-UP-I
+				LOCALITA' BOSCHETTO
+				67100 L'AQUILA    na
+				IT
+
+00-17-7D   (hex)		IDT Technology Limited
+00177D     (base 16)		IDT Technology Limited
+				Block C, 9/F, Kaiser Estate, Phase I
+				na    na
+				HK
+
+00-A0-45   (hex)		PHOENIX CONTACT Electronics GmbH
+00A045     (base 16)		PHOENIX CONTACT Electronics GmbH
+				POSTFACH 1341
+				lower saxony    D-31812
+				DE
+
+00-23-78   (hex)		GN Netcom A/S
+002378     (base 16)		GN Netcom A/S
+				Lautrupbjerg 7
+				Ballerup    DK - 2750
+				DK
+
+50-C9-71   (hex)		GN Netcom A/S
+50C971     (base 16)		GN Netcom A/S
+				Lautrupbjerg 7
+				Ballerup    DK - 2750
+				DK
+
+F0-40-7B   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+F0407B     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+94-88-5E   (hex)		Surfilter Network Technology Co., Ltd. 
+94885E     (base 16)		Surfilter Network Technology Co., Ltd. 
+				6/f,2 Building,Kejizhong Rd2,Software Park,High-Tech District,Nanshan,Shenzhen,China
+				Shenzhen  Guangdong  518000
+				CN
+
+C8-25-E1   (hex)		Lemobile Information Technology (Beijing) Co., Ltd
+C825E1     (base 16)		Lemobile Information Technology (Beijing) Co., Ltd
+				WENHUAYING NORTH (No.1, LINKONG 2nd St), GAOLIYING, SHUNYI DISTRICT, BEIJING
+				Beijing  Beijing  101300
+				CN
+
+94-50-89   (hex)		SimonsVoss Technologies GmbH
+945089     (base 16)		SimonsVoss Technologies GmbH
+				Feringastr. 4
+				Unterfoehring  Bavaria  85774
+				DE
+
+04-2A-E2   (hex)		Cisco Systems, Inc
+042AE2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-B6-F5   (hex)		IEEE Registration Authority
+E0B6F5     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-90-FA   (hex)		Emulex Corporation
+0090FA     (base 16)		Emulex Corporation
+				3333 Susan Street
+				Costa Mesa  CA  92626
+				US
+
+00-E0-D5   (hex)		Emulex Corporation
+00E0D5     (base 16)		Emulex Corporation
+				3333 Susan Street
+				Costa Mesa  CA  92626
+				US
+
+00-10-35   (hex)		Elitegroup Computer Systems Co.,Ltd.
+001035     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				6F, NO. 88, SEC. 6
+				Shih Lin  TAIPEI  00000
+				TW
+
+00-0A-E6   (hex)		Elitegroup Computer Systems Co.,Ltd.
+000AE6     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No.22, Alley 38, Lane 91, Sec. 1, Nei Hu
+				Taipei    114
+				TW
+
+74-27-EA   (hex)		Elitegroup Computer Systems Co.,Ltd.
+7427EA     (base 16)		Elitegroup Computer Systems Co.,Ltd.
+				No. 239, Sec. 2, Ti Ding Blvd., 
+				Taipei    11493
+				US
+
+64-99-68   (hex)		Elentec
+649968     (base 16)		Elentec
+				401-13 Chunggye-Ri
+				Dongtan-Myun  Kyunggi  445-811
+				KR
+
+00-40-9C   (hex)		TRANSWARE
+00409C     (base 16)		TRANSWARE
+				21, RUE DU 8 MAI 1945
+				    
+				FR
+
+B0-1B-D2   (hex)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+B01BD2     (base 16)		Le Shi Zhi Xin Electronic Technology (Tianjin) Limited
+				,Le Shi Building, No.105 Yaojiayuan Road,Chaoyang District,Beijing,China
+				beijing  beijing  100025
+				CN
+
+54-48-9C   (hex)		CDOUBLES ELECTRONICS CO. LTD.
+54489C     (base 16)		CDOUBLES ELECTRONICS CO. LTD.
+				11F.-6, No. 7,Sec. 3, New Taipei Blvd., Xinzhuang Dist.
+				New Taipei City    24250
+				TW
+
+E4-A1-E6   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+E4A1E6     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+84-00-2D   (hex)		PEGATRON CORPORATION
+84002D     (base 16)		PEGATRON CORPORATION
+				No. 76, Ligong St., Beitou,
+				Taipei    112
+				TW
+
+40-82-56   (hex)		Continental Automotive GmbH
+408256     (base 16)		Continental Automotive GmbH
+				VD=-Strasse 1
+				Babenhausen  Garmany  64832
+				DE
+
+5C-C7-D7   (hex)		AZROAD TECHNOLOGY COMPANY LIMITED
+5CC7D7     (base 16)		AZROAD TECHNOLOGY COMPANY LIMITED
+				Block B2, No.14 Jian'an rd. Shajing, Bao'an District,
+				Shenzhen    518104
+				CN
+
+98-6B-3D   (hex)		ARRIS Group, Inc.
+986B3D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-07-1B   (hex)		Hewlett Packard Enterprise
+E0071B     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+1C-AB-C0   (hex)		Hitron Technologies. Inc
+1CABC0     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+1C-3A-DE   (hex)		Samsung Electronics Co.,Ltd
+1C3ADE     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-23-60   (hex)		Lookit Technology Co., Ltd
+002360     (base 16)		Lookit Technology Co., Ltd
+				FL 8 Seashore Mansion
+				Shenzhen  Guangdong  518100
+				CN
+
+84-FE-DC   (hex)		Borqs Beijing Ltd.
+84FEDC     (base 16)		Borqs Beijing Ltd.
+				Tower A, Building B23, Universal Business Park, No.10 Jiuxianqiao Road
+				Chaoyang District  Beijing  100015
+				CN
+
+60-83-34   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+608334     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E4-7E-66   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E47E66     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-DB-DA   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+94DBDA     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-D9-E4   (hex)		BRILLIANTTS CO., LTD
+54D9E4     (base 16)		BRILLIANTTS CO., LTD
+				Daewangpangyo-ro
+				Seongnam-si    13494
+				KR
+
+F4-62-D0   (hex)		Not for Radio, LLC
+F462D0     (base 16)		Not for Radio, LLC
+				425 Front St
+				Lititz  PA  17543
+				US
+
+98-DE-D0   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+98DED0     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+50-89-65   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+508965     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+00-5B-A1   (hex)		shanghai huayuan chuangxin software CO., LTD.
+005BA1     (base 16)		shanghai huayuan chuangxin software CO., LTD.
+				Room D13 , Floor 13,Lane 1006, Jinshajiang road,putuo District
+				Shanghai  Shanghai  200333
+				CN
+
+58-D6-7A   (hex)		TCPlink
+58D67A     (base 16)		TCPlink
+				Daerungpost tower 1-cha 1720, 288 digital-ro,Guro-gu
+				seoul    08390
+				KR
+
+98-07-2D   (hex)		Texas Instruments
+98072D     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+F0-C7-7F   (hex)		Texas Instruments
+F0C77F     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+00-0A-C2   (hex)		Wuhan FiberHome Digital Technology Co.,Ltd.
+000AC2     (base 16)		Wuhan FiberHome Digital Technology Co.,Ltd.
+				No.88 YouKeyuan Road,Hongshan District,W
+				Wuhan  Hubei  430074
+				CN
+
+10-DA-43   (hex)		NETGEAR
+10DA43     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+B8-05-AB   (hex)		zte corporation
+B805AB     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+78-96-82   (hex)		zte corporation
+789682     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-67-E7   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D467E7     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+E4-2F-26   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+E42F26     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+04-C1-B9   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+04C1B9     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan City  Hubei Province  430074
+				CN
+
+C4-BE-D4   (hex)		Avaya Inc
+C4BED4     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+D0-17-C2   (hex)		ASUSTek COMPUTER INC.
+D017C2     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+34-99-71   (hex)		Quanta Storage Inc.
+349971     (base 16)		Quanta Storage Inc.
+				3F. No.188, Wenhua 2nd Rd
+				Taoyuan City  Guishan District  33383
+				TW
+
+9C-52-F8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+9C52F8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-13-DB   (hex)		Juniper Networks
+EC13DB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+5C-F2-86   (hex)		IEEE Registration Authority
+5CF286     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+E8-FD-72   (hex)		SHANGHAI LINGUO TECHNOLOGY CO., LTD.
+E8FD72     (base 16)		SHANGHAI LINGUO TECHNOLOGY CO., LTD.
+				No.2,277 Lane,Yongdeng Road,Putuo District,Shanghai,China
+				Shanghai  Shanghai  200000
+				CN
+
+98-BB-1E   (hex)		BYD Precision Manufacture Company Ltd.
+98BB1E     (base 16)		BYD Precision Manufacture Company Ltd.
+				7/Floor, Building 5#, No3000 LongDong Avenue, Pudong District
+				Shanghai  Shanghai  201203
+				CN
+
+AC-5F-3E   (hex)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+AC5F3E     (base 16)		SAMSUNG ELECTRO-MECHANICS(THAILAND)
+				93Moo5T. Bangsamak SEMTHAI, WELLGROW INDUSTRIAL ESTATE
+				Bangpakong  Chachoengsao  24180
+				TH
+
+54-6D-52   (hex)		TOPVIEW OPTRONICS CORP.
+546D52     (base 16)		TOPVIEW OPTRONICS CORP.
+				No.8, Wuquan Rd., New Taipei Industrial Park, Wugu District
+				 New Taipei City     24886
+				TW
+
+04-C1-03   (hex)		Clover Network, Inc.
+04C103     (base 16)		Clover Network, Inc.
+				415 N Mathilda Ave
+				Sunnyvale  CA  94085
+				US
+
+28-0C-28   (hex)		Unigen DataStorage Corporation
+280C28     (base 16)		Unigen DataStorage Corporation
+				11F.-6, No.251, Fuxing 1st St., Zhubei City, Hsinchu County 302, Taiwan (R.O.C.)
+				Zhubei City    30271
+				TW
+
+A4-BF-01   (hex)		Intel Corporate
+A4BF01     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+20-8B-37   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+208B37     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+08-BE-77   (hex)		Green Electronics
+08BE77     (base 16)		Green Electronics
+				47801 Fremont Blvd
+				Fremont  CA  94538
+				US
+
+50-9E-A7   (hex)		Samsung Electronics Co.,Ltd
+509EA7     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-81-95   (hex)		Samsung Electronics Co.,Ltd
+A88195     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+88-AD-D2   (hex)		Samsung Electronics Co.,Ltd
+88ADD2     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-CC-FC   (hex)		Cisco Systems, Inc
+00CCFC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-C5   (hex)		Sony Interactive Entertainment Inc.
+0019C5     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+00-13-15   (hex)		Sony Interactive Entertainment Inc.
+001315     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+1C-23-4F   (hex)		EDMI  Europe Ltd
+1C234F     (base 16)		EDMI  Europe Ltd
+				The Grainger  Suite, Dobson House
+				Newcastle upon Tyne    NE3 3PF
+				GB
+
+A4-44-D1   (hex)		 Wingtech Group (HongKong）Limited
+A444D1     (base 16)		 Wingtech Group (HongKong）Limited
+				 FLAT/RM 1903 19/F PODIUM PLAZA 5HANOI ROAD TSIM SHA TSUI
+				Hong Kong  Hong Kong  999077
+				HK
+
+00-6C-FD   (hex)		Sichuan Changhong Electric Ltd.
+006CFD     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+54-5A-A6   (hex)		Espressif Inc.
+545AA6     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+FC-1A-11   (hex)		vivo Mobile Communication Co., Ltd.
+FC1A11     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+00-1A-57   (hex)		Matrix Design Group, LLC
+001A57     (base 16)		Matrix Design Group, LLC
+				5741 Prospect Dr.
+				Newburgh  IN  47630
+				US
+
+A0-C5-89   (hex)		Intel Corporate
+A0C589     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-1E-1E   (hex)		Honeywell Life Safety
+001E1E     (base 16)		Honeywell Life Safety
+				12 Clintonville Road
+				Northford  CT  0422
+				US
+
+00-23-40   (hex)		MiXTelematics
+002340     (base 16)		MiXTelematics
+				Blaauwklip Office Park 2
+				Stellenbosch  Western Cape  7600
+				ZA
+
+B4-8B-19   (hex)		Apple, Inc.
+B48B19     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+38-FD-FE   (hex)		IEEE Registration Authority
+38FDFE     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+2C-09-CB   (hex)		COBS AB
+2C09CB     (base 16)		COBS AB
+				Box 9242
+				Goteborg    40095
+				SE
+
+BC-EC-5D   (hex)		Apple, Inc.
+BCEC5D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-A0-2B   (hex)		Apple, Inc.
+28A02B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-44-81   (hex)		Nokia Corporation
+A84481     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  NA  24101
+				FI
+
+88-44-F6   (hex)		Nokia Corporation
+8844F6     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo  NA  24101
+				FI
+
+F4-4D-17   (hex)		GOLDCARD HIGH-TECH CO.,LTD.
+F44D17     (base 16)		GOLDCARD HIGH-TECH CO.,LTD.
+				No.158, Jinqiao Stree,Economic&Technological Development Area,
+				Hangzhou   Zhejiang  310018
+				CN
+
+38-B8-EB   (hex)		IEEE Registration Authority
+38B8EB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+98-97-D1   (hex)		MitraStar Technology Corp.
+9897D1     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+B8-32-41   (hex)		Wuhan Tianyu Information Industry Co., Ltd.
+B83241     (base 16)		Wuhan Tianyu Information Industry Co., Ltd.
+				HUST Industry Park, East-Lake Development Zone
+				Wuhan  Hubei  430223
+				CN
+
+00-60-DC   (hex)		NEC Magnus Communications,Ltd.
+0060DC     (base 16)		NEC Magnus Communications,Ltd.
+				18 Nihon-odori,Naka-ku
+				Yokohama, Kanagawa    231-0021
+				JP
+
+90-72-82   (hex)		Sagemcom Broadband SAS
+907282     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+00-1C-35   (hex)		Nokia Danmark A/S
+001C35     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1C-9A   (hex)		Nokia Danmark A/S
+001C9A     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1C-D6   (hex)		Nokia Danmark A/S
+001CD6     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1C-D4   (hex)		Nokia Danmark A/S
+001CD4     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1D-98   (hex)		Nokia Danmark A/S
+001D98     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1D-E9   (hex)		Nokia Danmark A/S
+001DE9     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1E-3A   (hex)		Nokia Danmark A/S
+001E3A     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-25-48   (hex)		Nokia Danmark A/S
+002548     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-22-FC   (hex)		Nokia Danmark A/S
+0022FC     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-22-FD   (hex)		Nokia Danmark A/S
+0022FD     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-21-AA   (hex)		Nokia Danmark A/S
+0021AA     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-1D-6E   (hex)		Nokia Danmark A/S
+001D6E     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen  V  DK-1790
+				DK
+
+00-23-B4   (hex)		Nokia Danmark A/S
+0023B4     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-13-70   (hex)		Nokia Danmark A/S
+001370     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+9C-18-74   (hex)		Nokia Danmark A/S
+9C1874     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790V
+				DK
+
+00-1B-AF   (hex)		Nokia Danmark A/S
+001BAF     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+C8-D1-0B   (hex)		Nokia Corporation
+C8D10B     (base 16)		Nokia Corporation
+				Joensuunkatu 7
+				Salo    24101
+				FI
+
+5C-C6-D0   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+5CC6D0     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1A-9A   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+001A9A     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+CC-6D-A0   (hex)		Roku, Inc.
+CC6DA0     (base 16)		Roku, Inc.
+				12980 Saratoga Ave.
+				Saratoga  CA  95070
+				US
+
+00-16-E4   (hex)		VANGUARD SECURITY ENGINEERING CORP.
+0016E4     (base 16)		VANGUARD SECURITY ENGINEERING CORP.
+				3, LANE 32, KSO CHING RD.
+				YANGMEI  TAOYUAN  326
+				US
+
+3C-89-70   (hex)		Neosfar
+3C8970     (base 16)		Neosfar
+				101 W. Broadway, Suite 300
+				San Diego  CA  92101
+				US
+
+00-17-42   (hex)		FUJITSU LIMITED
+001742     (base 16)		FUJITSU LIMITED
+				403, Kosugi-cho 1-chome, Nakahara-ku
+				Kawasaki  Kanagawa  211-0063
+				JP
+
+00-19-99   (hex)		Fujitsu Technology Solutions GmbH
+001999     (base 16)		Fujitsu Technology Solutions GmbH
+				Buergermeister-Ulrich-Strasse 100
+				Augsburg    86199
+				DE
+
+00-5A-39   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+005A39     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+A0-89-E4   (hex)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+A089E4     (base 16)		Skyworth Digital Technology(Shenzhen) Co.,Ltd
+				7F,Block A,Skyworth Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+78-CA-83   (hex)		IEEE Registration Authority
+78CA83     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+0C-11-67   (hex)		Cisco Systems, Inc
+0C1167     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-EA-E8   (hex)		ARRIS Group, Inc.
+74EAE8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+F8-8E-85   (hex)		Comtrend Corporation
+F88E85     (base 16)		Comtrend Corporation
+				3F-1, 10 Lane 609, Chongxin Road, Section 5, 
+				New Taipei City,  Taiwan  24159
+				TW
+
+02-CF-1C   (hex)		Communication Machinery Corporation
+02CF1C     (base 16)		Communication Machinery Corporation
+				1226 ANACAPA
+				SANTA BARBARA  CA  93101
+				US
+
+00-90-F5   (hex)		CLEVO CO.
+0090F5     (base 16)		CLEVO CO.
+				35, WU-GON 6TH ROAD
+				TAIPEI HSIEN    12345
+				TW
+
+00-30-FF   (hex)		DataFab Systems Inc.
+0030FF     (base 16)		DataFab Systems Inc.
+				ROOM #1910, 19F, NO. 333
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-0F-F6   (hex)		DARFON LIGHTING CORP
+000FF6     (base 16)		DARFON LIGHTING CORP
+				31, Lane17, Zihciang N. Road
+				Taoyuan    333
+				TW
+
+00-21-00   (hex)		Gemtek Technology Co., Ltd.
+002100     (base 16)		Gemtek Technology Co., Ltd.
+				No.1 Jen Ai Road, Hsinchu Industrial Park,
+				Hukou,  Hsinchu  303
+				TW
+
+50-F5-20   (hex)		Samsung Electronics Co.,Ltd
+50F520     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+64-B3-10   (hex)		Samsung Electronics Co.,Ltd
+64B310     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A4-EB-D3   (hex)		Samsung Electronics Co.,Ltd
+A4EBD3     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C8-10-73   (hex)		CENTURY OPTICOMM CO.,LTD
+C81073     (base 16)		CENTURY OPTICOMM CO.,LTD
+				WEITUO COMMUNITY,HECHUAN INDUSTRIAL PARK, HECHUAN DISTRICT,CHONGQING,CHINA
+				Chongqing    401121
+				CN
+
+34-37-59   (hex)		zte corporation
+343759     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+FC-2F-40   (hex)		Calxeda, Inc.
+FC2F40     (base 16)		Calxeda, Inc.
+				7000 North Mopac Expressway
+				Austin  TX  78731
+				US
+
+BC-62-0E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+BC620E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+74-A5-28   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+74A528     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+5C-F6-DC   (hex)		Samsung Electronics Co.,Ltd
+5CF6DC     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-26-E4   (hex)		Canal +
+0026E4     (base 16)		Canal +
+				48 quai du point du jour
+				Boulogne-Billancourt    92659
+				FR
+
+00-01-17   (hex)		Canal +
+000117     (base 16)		Canal +
+				23 Rue LeBlanc
+				75906 Paris Cedex 15    12345
+				FR
+
+E0-1D-3B   (hex)		Cambridge Industries(Group) Co.,Ltd.
+E01D3B     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				22 Floor, Qilai Tower, #889 Yishan Road
+				Shanghai  Shanghai  200233
+				CN
+
+70-C7-6F   (hex)		INNO S
+70C76F     (base 16)		INNO S
+				215beon-gil, 119
+				Guri-si  Gyeonggi-do  471-060
+				KR
+
+38-19-2F   (hex)		Nokia Corporation
+38192F     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+B8-C6-8E   (hex)		Samsung Electronics Co.,Ltd
+B8C68E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-FE-31   (hex)		Samsung Electronics Co.,Ltd
+04FE31     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+4C-BC-A5   (hex)		Samsung Electronics Co.,Ltd
+4CBCA5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+D8-31-CF   (hex)		Samsung Electronics Co.,Ltd
+D831CF     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-83-31   (hex)		Samsung Electronics Co.,Ltd
+188331     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+9C-65-B0   (hex)		Samsung Electronics Co.,Ltd
+9C65B0     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+84-55-A5   (hex)		Samsung Electronics Co.,Ltd
+8455A5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-7C-01   (hex)		Samsung Electronics Co.,Ltd
+A87C01     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-D0-9C   (hex)		Samsung Electronics Co.,Ltd
+B0D09C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+50-C8-E5   (hex)		Samsung Electronics Co.,Ltd
+50C8E5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1,Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+00-20-D4   (hex)		Cabletron Systems, Inc.
+0020D4     (base 16)		Cabletron Systems, Inc.
+				35 INDUSTRIAL WAY
+				ROHESTER  NH  03866-5005
+				US
+
+00-E0-3A   (hex)		Cabletron Systems, Inc.
+00E03A     (base 16)		Cabletron Systems, Inc.
+				35 INDUSTRIAL WAY - BLDG. #36
+				ROCHESTER  NH  03867
+				US
+
+00-10-E7   (hex)		Breezecom, Ltd.
+0010E7     (base 16)		Breezecom, Ltd.
+				PO Box 13139
+				Tel-Aviv    12345
+				IL
+
+94-92-BC   (hex)		SYNTECH(HK) TECHNOLOGY LIMITED
+9492BC     (base 16)		SYNTECH(HK) TECHNOLOGY LIMITED
+				Unit No.1,12/F.,Perfect Industrial Building,31 Tai Yau Street, San Po Kong, Kowloon, Hong Kong 999077
+				Kowloon    999077
+				HK
+
+00-1D-19   (hex)		Arcadyan Technology Corporation
+001D19     (base 16)		Arcadyan Technology Corporation
+				4F., No. 9 , Park Avenue II,
+				Hsinchu    300
+				TW
+
+00-12-BF   (hex)		Arcadyan Technology Corporation
+0012BF     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II
+				Hsinchu    300
+				TW
+
+50-7E-5D   (hex)		Arcadyan Technology Corporation
+507E5D     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+7C-4F-B5   (hex)		Arcadyan Technology Corporation
+7C4FB5     (base 16)		Arcadyan Technology Corporation
+				4F, No. 9, Park Avenue II ,
+				Hsinchu    300
+				TW
+
+00-22-3F   (hex)		NETGEAR
+00223F     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-0F-B5   (hex)		NETGEAR
+000FB5     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-09-5B   (hex)		NETGEAR
+00095B     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-1A-4F   (hex)		AVM GmbH
+001A4F     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+00-1C-4A   (hex)		AVM GmbH
+001C4A     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+00-15-0C   (hex)		AVM GmbH
+00150C     (base 16)		AVM GmbH
+				Alt-Moabit 95
+				Berlin    10559
+				DE
+
+00-26-FF   (hex)		BlackBerry RTS
+0026FF     (base 16)		BlackBerry RTS
+				440 Phillip Street
+				Waterloo  Ontario  N2L 5W9
+				CA
+
+A4-E4-B8   (hex)		BlackBerry RTS
+A4E4B8     (base 16)		BlackBerry RTS
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+00-30-67   (hex)		BIOSTAR Microtech Int'l Corp.
+003067     (base 16)		BIOSTAR Microtech Int'l Corp.
+				2FL. NO. 108-2 MIN CHUAN ROAD
+				HSIN TIEN CITY, TAIPEI HSIEN    12345
+				TW
+
+F4-0B-93   (hex)		BlackBerry RTS
+F40B93     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+1C-69-A5   (hex)		BlackBerry RTS
+1C69A5     (base 16)		BlackBerry RTS
+				451 Phillip Street
+				Waterloo  ON  N2L 3X2
+				CA
+
+94-EB-CD   (hex)		BlackBerry RTS
+94EBCD     (base 16)		BlackBerry RTS
+				295 Phillip Street
+				Waterloo  Ontario  N2L3W8
+				CA
+
+28-C6-8E   (hex)		NETGEAR
+28C68E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+04-A1-51   (hex)		NETGEAR
+04A151     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+F8-73-94   (hex)		NETGEAR
+F87394     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+20-4E-7F   (hex)		NETGEAR
+204E7F     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+C0-3F-0E   (hex)		NETGEAR
+C03F0E     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-26-F2   (hex)		NETGEAR
+0026F2     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-13-8F   (hex)		Asiarock Technology Limited
+00138F     (base 16)		Asiarock Technology Limited
+				P.O. Box957, Offshore Incorporations Centre
+				Road Town  Tortola  12345
+				VG
+
+80-37-73   (hex)		NETGEAR
+803773     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+A4-2B-8C   (hex)		NETGEAR
+A42B8C     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+CC-7D-37   (hex)		ARRIS Group, Inc.
+CC7D37     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A4-7A-A4   (hex)		ARRIS Group, Inc.
+A47AA4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-17-00   (hex)		ARRIS Group, Inc.
+001700     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-16-B5   (hex)		ARRIS Group, Inc.
+0016B5     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-A8   (hex)		ARRIS Group, Inc.
+0015A8     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-15-9A   (hex)		ARRIS Group, Inc.
+00159A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-11-80   (hex)		ARRIS Group, Inc.
+001180     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-0B-06   (hex)		ARRIS Group, Inc.
+000B06     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-D0-88   (hex)		ARRIS Group, Inc.
+00D088     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-12-8A   (hex)		ARRIS Group, Inc.
+00128A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-75   (hex)		ARRIS Group, Inc.
+002375     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-A3   (hex)		ARRIS Group, Inc.
+0023A3     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-DB   (hex)		ARRIS Group, Inc.
+001ADB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1F-7E   (hex)		ARRIS Group, Inc.
+001F7E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-11-AE   (hex)		ARRIS Group, Inc.
+0011AE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+94-CC-B9   (hex)		ARRIS Group, Inc.
+94CCB9     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+3C-43-8E   (hex)		ARRIS Group, Inc.
+3C438E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-24-C1   (hex)		ARRIS Group, Inc.
+0024C1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-25-F2   (hex)		ARRIS Group, Inc.
+0025F2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-25-F1   (hex)		ARRIS Group, Inc.
+0025F1     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-14-04   (hex)		ARRIS Group, Inc.
+001404     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1A-AD   (hex)		ARRIS Group, Inc.
+001AAD     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-26-BA   (hex)		ARRIS Group, Inc.
+0026BA     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-23-0B   (hex)		ARRIS Group, Inc.
+00230B     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+74-E7-C6   (hex)		ARRIS Group, Inc.
+74E7C6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1C-12   (hex)		ARRIS Group, Inc.
+001C12     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+5C-33-8E   (hex)		Alpha Networks Inc.
+5C338E     (base 16)		Alpha Networks Inc.
+				No.8 Li-shing Seventh Road,Science-based
+				Hsinchu    300
+				TW
+
+00-09-41   (hex)		Allied Telesis R&D Center K.K.
+000941     (base 16)		Allied Telesis R&D Center K.K.
+				Technical Center/No.2 TOC Bldg.
+				Shinagawa-ku    141-0031
+				US
+
+28-E3-47   (hex)		Liteon Technology Corporation
+28E347     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+44-6D-57   (hex)		Liteon Technology Corporation
+446D57     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+9C-B7-0D   (hex)		Liteon Technology Corporation
+9CB70D     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+68-A3-C4   (hex)		Liteon Technology Corporation
+68A3C4     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+70-F1-A1   (hex)		Liteon Technology Corporation
+70F1A1     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo,Taipei Hsien,Taiwan,
+				TaiPei  TaiWan  23585
+				TW
+
+84-00-D2   (hex)		Sony Mobile Communications Inc
+8400D2     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+30-39-26   (hex)		Sony Mobile Communications Inc
+303926     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-EB-2D   (hex)		Sony Mobile Communications Inc
+00EB2D     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+B4-52-7D   (hex)		Sony Mobile Communications Inc
+B4527D     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-D9-D1   (hex)		Sony Interactive Entertainment Inc.
+00D9D1     (base 16)		Sony Interactive Entertainment Inc.
+				1-7-1 Konan
+				Minato-ku  Tokyo  108-0075
+				JP
+
+B0-05-94   (hex)		Liteon Technology Corporation
+B00594     (base 16)		Liteon Technology Corporation
+				4F,90,Chien 1 Road,ChungHo
+				New Taipei City  Taipei  23585
+				TW
+
+EC-08-6B   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+EC086B     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+94-A1-A2   (hex)		AMPAK Technology, Inc.
+94A1A2     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road
+				Hukou  Hsinchu  30352
+				TW
+
+00-01-4A   (hex)		Sony Corporation
+00014A     (base 16)		Sony Corporation
+				Gotenyama Tec, 5-1-2 Kitashinagawa
+				Tokyo    141-0001
+				JP
+
+00-1E-DC   (hex)		Sony Mobile Communications Inc
+001EDC     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-1D-28   (hex)		Sony Mobile Communications Inc
+001D28     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+00-18-13   (hex)		Sony Mobile Communications Inc
+001813     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+40-2B-A1   (hex)		Sony Mobile Communications Inc
+402BA1     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+98-3B-16   (hex)		AMPAK Technology, Inc.
+983B16     (base 16)		AMPAK Technology, Inc.
+				No.1,Jen Ai Road
+				Hsinchu    30352
+				TW
+
+40-95-58   (hex)		Aisino Corporation
+409558     (base 16)		Aisino Corporation
+				No.18A, Xingshikou Road,
+				Beijing    100195
+				CN
+
+18-28-61   (hex)		AirTies Wireless Networks
+182861     (base 16)		AirTies Wireless Networks
+				Gulbahar Mahallesi, Avni Diligil Sokak
+				ISTANBUL  ISTANBUL  34394
+				TR
+
+6C-71-D9   (hex)		AzureWave Technology Inc.
+6C71D9     (base 16)		AzureWave Technology Inc.
+				9F.,No.92,Baozhong Rd
+				Xindian District  New Taipei City  231
+				TW
+
+D0-E7-82   (hex)		AzureWave Technology Inc.
+D0E782     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd
+				. New Taipei City  Taiwan  231
+				TW
+
+6C-AD-F8   (hex)		AzureWave Technology Inc.
+6CADF8     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd
+				. New Taipei City  Taiwan  231
+				TW
+
+A8-1D-16   (hex)		AzureWave Technology Inc.
+A81D16     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+34-C3-D2   (hex)		FN-LINK TECHNOLOGY LIMITED
+34C3D2     (base 16)		FN-LINK TECHNOLOGY LIMITED
+				A Building,HuiXin industial park,No 31, YongHe road, Fuyong town, Bao'an District
+				SHENZHEN  GUANGDONG  518100
+				CN
+
+54-F6-C5   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+54F6C5     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building, Star-net Science Plaza, Juyuanzhou,
+				FUZHOU  FUJIAN  350002
+				CN
+
+D0-D4-12   (hex)		ADB Broadband Italia
+D0D412     (base 16)		ADB Broadband Italia
+				VIALE SARCA 336
+				MILANO    20126
+				IT
+
+00-26-B8   (hex)		Actiontec Electronics, Inc
+0026B8     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+00-26-FC   (hex)		AcSiP Technology Corp.
+0026FC     (base 16)		AcSiP Technology Corp.
+				3F., No.22, Dalin Rd.,
+				Taoyuan City,  Taoyuan County  330
+				TW
+
+00-15-AF   (hex)		AzureWave Technology Inc.
+0015AF     (base 16)		AzureWave Technology Inc.
+				8F., No.94, Baozhong Rd., Xindian
+				Taipei    231
+				TW
+
+74-F0-6D   (hex)		AzureWave Technology Inc.
+74F06D     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd., Xindian
+				Taipei    231
+				TW
+
+44-D8-32   (hex)		AzureWave Technology Inc.
+44D832     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd., Xindian
+				Taipei    231
+				TW
+
+E0-B9-A5   (hex)		AzureWave Technology Inc.
+E0B9A5     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baoshong Rd.
+				Xindian City, Taipei County    231
+				TW
+
+78-18-81   (hex)		AzureWave Technology Inc.
+781881     (base 16)		AzureWave Technology Inc.
+				8F., No.94 Baozhong Rd.,
+				Xindian, Taipei    23144
+				TW
+
+B0-46-FC   (hex)		MitraStar Technology Corp.
+B046FC     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu    300
+				TW
+
+E0-41-36   (hex)		MitraStar Technology Corp.
+E04136     (base 16)		MitraStar Technology Corp.
+				No. 6, Innovation Road II,
+				Hsinchu  Taiwan  300
+				TW
+
+00-1C-A2   (hex)		ADB Broadband Italia
+001CA2     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+00-22-33   (hex)		ADB Broadband Italia
+002233     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222
+				MILANO    20126
+				IT
+
+30-39-F2   (hex)		ADB Broadband Italia
+3039F2     (base 16)		ADB Broadband Italia
+				VIALE SARCA 222 
+				MILANO     20126 
+				IT
+
+00-17-C2   (hex)		ADB Broadband Italia
+0017C2     (base 16)		ADB Broadband Italia
+				v.Sarca 222
+				Milano    20126
+				IT
+
+68-9C-5E   (hex)		AcSiP Technology Corp.
+689C5E     (base 16)		AcSiP Technology Corp.
+				3F., No.22, Dalin Rd.
+				Taoyuan  Taoyuan County  33067
+				TW
+
+9C-0E-4A   (hex)		Shenzhen Vastking Electronic Co.,Ltd.
+9C0E4A     (base 16)		Shenzhen Vastking Electronic Co.,Ltd.
+				2/F Building 6,ZhengZhong Industrial Park,Qiaotou Community,Fuyong,Baoan,ShenZhen China
+				Shenzhen  Guangdong  518103
+				CN
+
+A8-58-40   (hex)		Cambridge Industries(Group) Co.,Ltd.
+A85840     (base 16)		Cambridge Industries(Group) Co.,Ltd.
+				5/F,Building 8, 2388 ChenHang Road, MinHang District
+				shanghai    201114
+				CN
+
+A0-D3-7A   (hex)		Intel Corporate
+A0D37A     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+88-96-F2   (hex)		Valeo Schalter und Sensoren GmbH
+8896F2     (base 16)		Valeo Schalter und Sensoren GmbH
+				Laiernstrasse 12
+				Bietigheim-Bissingen  Germany  74321
+				DE
+
+00-10-73   (hex)		TECHNOBOX, INC.
+001073     (base 16)		TECHNOBOX, INC.
+				140 Mount Holly Bypass
+				Lumberton  NJ  08048-1114
+				US
+
+20-93-4D   (hex)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+20934D     (base 16)		FUJIAN STAR-NET COMMUNICATION CO.,LTD
+				19-22# Building,,Star-net Science Plaza
+				Fuzhou  Fujian  350002
+				CN
+
+00-90-27   (hex)		Intel Corporation
+009027     (base 16)		Intel Corporation
+				HF1-06
+				HILLSBORO  OR  97124
+				US
+
+C4-85-08   (hex)		Intel Corporate
+C48508     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+68-05-CA   (hex)		Intel Corporate
+6805CA     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+24-77-03   (hex)		Intel Corporate
+247703     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+74-E5-0B   (hex)		Intel Corporate
+74E50B     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B8-03-05   (hex)		Intel Corporate
+B80305     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-A0-C9   (hex)		Intel Corporation
+00A0C9     (base 16)		Intel Corporation
+				5200 NE ELAM YOUNG PARKWAY
+				HILLSBORO  OR  97124
+				US
+
+14-18-77   (hex)		Dell Inc.
+141877     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock    78682
+				US
+
+E0-97-96   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E09796     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+1C-40-24   (hex)		Dell Inc.
+1C4024     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+18-FB-7B   (hex)		Dell Inc.
+18FB7B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+F8-B1-56   (hex)		Dell Inc.
+F8B156     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+14-1A-A3   (hex)		Motorola Mobility LLC, a Lenovo Company
+141AA3     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 Merchandise Mart Plaza, Suite 1800
+				Chicago  IL  60654
+				US
+
+34-07-FB   (hex)		Ericsson AB
+3407FB     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+A4-A1-C2   (hex)		Ericsson AB
+A4A1C2     (base 16)		Ericsson AB
+				Torshamnsgatan 36
+				Stockholm    SE-164 80
+				SE
+
+00-06-5B   (hex)		Dell Inc.
+00065B     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+84-2B-2B   (hex)		Dell Inc.
+842B2B     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock     78682
+				US
+
+F0-4D-A2   (hex)		Dell Inc.
+F04DA2     (base 16)		Dell Inc.
+				One Dell Way, MS RR5-45
+				Round Rock     78682
+				US
+
+E0-DB-55   (hex)		Dell Inc.
+E0DB55     (base 16)		Dell Inc.
+				One Dell way
+				Round Rock    78682
+				US
+
+00-0F-1F   (hex)		Dell Inc.
+000F1F     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+24-B6-FD   (hex)		Dell Inc.
+24B6FD     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+74-E6-E2   (hex)		Dell Inc.
+74E6E2     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+34-E6-D7   (hex)		Dell Inc.
+34E6D7     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+00-1E-C9   (hex)		Dell Inc.
+001EC9     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+00-21-70   (hex)		Dell Inc.
+002170     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+00-21-9B   (hex)		Dell Inc.
+00219B     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+B8-AC-6F   (hex)		Dell Inc.
+B8AC6F     (base 16)		Dell Inc.
+				One Dell Way,  MS RR5-45
+				Round Rock    78682
+				US
+
+8C-A9-82   (hex)		Intel Corporate
+8CA982     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+BC-77-37   (hex)		Intel Corporate
+BC7737     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+14-30-C6   (hex)		Motorola Mobility LLC, a Lenovo Company
+1430C6     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				600 North US Highway 45
+				Libertyville  IL  60048
+				US
+
+D8-FC-93   (hex)		Intel Corporate
+D8FC93     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+D4-AE-52   (hex)		Dell Inc.
+D4AE52     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+28-16-2E   (hex)		2Wire Inc
+28162E     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+F8-18-97   (hex)		2Wire Inc
+F81897     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose    95131
+				US
+
+94-C1-50   (hex)		2Wire Inc
+94C150     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+5C-F8-21   (hex)		Texas Instruments
+5CF821     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+88-07-4B   (hex)		LG Electronics (Mobile Communications)
+88074B     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+00-0D-72   (hex)		2Wire Inc
+000D72     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  95131
+				US
+
+00-12-88   (hex)		2Wire Inc
+001288     (base 16)		2Wire Inc
+				1704 Automation Parkway
+				San Jose  CA  94538
+				US
+
+00-78-9E   (hex)		Sagemcom Broadband SAS
+00789E     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+E8-BE-81   (hex)		Sagemcom Broadband SAS
+E8BE81     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				Rueil Malmaison Cedex  Hauts de Seine  92848
+				FR
+
+68-15-90   (hex)		Sagemcom Broadband SAS
+681590     (base 16)		Sagemcom Broadband SAS
+				250 ROUTE DE L'EMPEREUR
+				RUEIL MALMAISON CEDEX  Choisissez l'état / la province  92848
+				FR
+
+F4-EB-38   (hex)		Sagemcom Broadband SAS
+F4EB38     (base 16)		Sagemcom Broadband SAS
+				15 Avenue Ambroise  Croizat
+				DOMERAT  Allier  03410
+				FR
+
+00-1B-BF   (hex)		Sagemcom Broadband SAS
+001BBF     (base 16)		Sagemcom Broadband SAS
+				14 Rue Paul Dautier
+				Vélizy    78457
+				FR
+
+00-25-69   (hex)		Sagemcom Broadband SAS
+002569     (base 16)		Sagemcom Broadband SAS
+				Le Ponnant de Paris
+				CEDEX  Paris  75512
+				FR
+
+14-1F-BA   (hex)		IEEE Registration Authority
+141FBA     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+80-7B-85   (hex)		IEEE Registration Authority
+807B85     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+CC-1B-E0   (hex)		IEEE Registration Authority
+CC1BE0     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+F4-0E-11   (hex)		IEEE Registration Authority
+F40E11     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+10-F6-81   (hex)		vivo Mobile Communication Co., Ltd.
+10F681     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+00-21-7C   (hex)		2Wire Inc
+00217C     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+00-1F-B3   (hex)		2Wire Inc
+001FB3     (base 16)		2Wire Inc
+				1764 Automation Parkway
+				San Jose  CA  95131
+				US
+
+00-22-75   (hex)		Belkin International Inc.
+002275     (base 16)		Belkin International Inc.
+				12045 E. Waterfront Drive
+				Playa Vista  CA  90094
+				US
+
+00-57-D2   (hex)		Cisco Systems, Inc
+0057D2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+3C-67-16   (hex)		Lily Robotics
+3C6716     (base 16)		Lily Robotics
+				75 Boardman Pl
+				San Francisco  CA  94103
+				US
+
+00-D0-BD   (hex)		Lattice Semiconductor Corp. (LPA)
+00D0BD     (base 16)		Lattice Semiconductor Corp. (LPA)
+				2115 O’Nel Drive
+				San Jose  CA  95131
+				US
+
+00-1F-3A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001F3A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C8-A0-30   (hex)		Texas Instruments
+C8A030     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+78-C5-E5   (hex)		Texas Instruments
+78C5E5     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+0C-FD-37   (hex)		SUSE Linux GmbH
+0CFD37     (base 16)		SUSE Linux GmbH
+				Maxfeldstraße 5
+				Nürnberg  Bavaria  90409
+				DE
+
+2C-22-8B   (hex)		CTR SRL
+2C228B     (base 16)		CTR SRL
+				Via Lario 33
+				Cantù  Cantù (CO)  22063
+				IT
+
+0C-6F-9C   (hex)		Shaw Communications Inc.
+0C6F9C     (base 16)		Shaw Communications Inc.
+				Suite 900, 630 3rd Avenue S.W.
+				CALGARY  ALBERTA  T2P 4L4
+				CA
+
+00-17-E4   (hex)		Texas Instruments
+0017E4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+04-E4-51   (hex)		Texas Instruments
+04E451     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+50-56-63   (hex)		Texas Instruments
+505663     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+88-33-14   (hex)		Texas Instruments
+883314     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+64-7B-D4   (hex)		Texas Instruments
+647BD4     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+D8-95-2F   (hex)		Texas Instruments
+D8952F     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+B8-FF-FE   (hex)		Texas Instruments
+B8FFFE     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+2C-E4-12   (hex)		Sagemcom Broadband SAS
+2CE412     (base 16)		Sagemcom Broadband SAS
+				250 route de l'Empereur
+				RUEIL MALMAISON CEDEX  Hauts de Seine  92848
+				FR
+
+44-C1-5C   (hex)		Texas Instruments
+44C15C     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+00-22-A5   (hex)		Texas Instruments
+0022A5     (base 16)		Texas Instruments
+				12500 TI Boulevard, MS 8723
+				Dallas  TX  75243
+				US
+
+E0-43-DB   (hex)		Shenzhen ViewAt Technology Co.,Ltd. 
+E043DB     (base 16)		Shenzhen ViewAt Technology Co.,Ltd. 
+				9A,Microprofit,6th Gaoxin South Road, High-Tech Industrial Park, Nanshan, Shenzhen, CHINA.
+				shenzhen  guangdong  518057
+				CN
+
+3C-CF-5B   (hex)		ICOMM HK LIMITED
+3CCF5B     (base 16)		ICOMM HK LIMITED
+				SUITES 2302-6, 23/F GREAT EAGLE CTR 23 HARBOUR RD 
+				WANCHAI    NA
+				HK
+
+24-05-F5   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+2405F5     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+3C-35-56   (hex)		Cognitec Systems GmbH
+3C3556     (base 16)		Cognitec Systems GmbH
+				Großenhainer Str. 101
+				Dresden  Saxony  01127
+				DE
+
+3C-90-66   (hex)		SmartRG, Inc.
+3C9066     (base 16)		SmartRG, Inc.
+				501 SE Columbia Shores Blvd
+				Vancouver  WA  98661
+				US
+
+00-0D-88   (hex)		D-Link Corporation
+000D88     (base 16)		D-Link Corporation
+				No.8, Li-Hsing 7 Road, Science-Based Ind
+				Hsinchu    30077
+				TW
+
+00-11-95   (hex)		D-Link Corporation
+001195     (base 16)		D-Link Corporation
+				2F No. 233-2, Pao-Chiao Road
+				Taipei  Taiwan  0000
+				TW
+
+00-13-46   (hex)		D-Link Corporation
+001346     (base 16)		D-Link Corporation
+				2F, No.233-2, Pao-Chiao Road
+				Hsin-Tien,  Taipei  231
+				TW
+
+78-E3-B5   (hex)		Hewlett Packard
+78E3B5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+78-AC-C0   (hex)		Hewlett Packard
+78ACC0     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+68-B5-99   (hex)		Hewlett Packard
+68B599     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+1C-C1-DE   (hex)		Hewlett Packard
+1CC1DE     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+B8-A3-86   (hex)		D-Link International
+B8A386     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+1C-7E-E5   (hex)		D-Link International
+1C7EE5     (base 16)		D-Link International
+				1 International Business Park, #03-12, The Synergy 
+				SINGAPORE    609917
+				SG
+
+1C-BD-B9   (hex)		D-Link International
+1CBDB9     (base 16)		D-Link International
+				1 INTERNATIONAL  BUSINESS  PARK,
+				SINGAPORE    609917
+				SG
+
+00-14-2F   (hex)		Savvius
+00142F     (base 16)		Savvius
+				1340 Treat Boulevard, Suite 500
+				Walnut Creek  CA  94597
+				US
+
+28-BC-18   (hex)		SourcingOverseas Co. Ltd
+28BC18     (base 16)		SourcingOverseas Co. Ltd
+				2F., No.616, Sec.5, Zhongshan N. Rd., Shilin Dist.,
+				Taipei City    111
+				TW
+
+94-AB-DE   (hex)		OMX Technology - FZE
+94ABDE     (base 16)		OMX Technology - FZE
+				Dubai Silicon Oasis - THUB - 1-D-OFF-124
+				Dubai    65673
+				AE
+
+9C-DF-B1   (hex)		Shenzhen Crave Communication Co., LTD
+9CDFB1     (base 16)		Shenzhen Crave Communication Co., LTD
+				F3,8Building,DongFangMing IndustryZone,No.83 DabaoRD.,33 District BaoAn
+				Shenzhen  Guangdong  518000
+				CN
+
+AC-CF-85   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+ACCF85     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan  Guangdong  523808 
+				CN
+
+38-71-DE   (hex)		Apple, Inc.
+3871DE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-81-EB   (hex)		Apple, Inc.
+7081EB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-73-8D   (hex)		Shenzhen TINNO Mobile Technology Corp.
+00738D     (base 16)		Shenzhen TINNO Mobile Technology Corp.
+				4/F.,H-3 Building,OCT Eastern lndustrial Park. NO.1 XiangShan East Road.
+				GuangDong    518053
+				US
+
+34-BA-75   (hex)		Everest Networks, Inc
+34BA75     (base 16)		Everest Networks, Inc
+				2933 Bunker Hill Ln., Suite 100
+				Santa Clara  CA  95054
+				US
+
+7C-18-CD   (hex)		E-TRON Co.,Ltd.
+7C18CD     (base 16)		E-TRON Co.,Ltd.
+				66-11, Nonhyeon 2-dong, Gangnam-gu
+				Seoul    06049
+				KR
+
+00-E0-FC   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00E0FC     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				KEFA ROAD, SCIENCE-BASED INDUSTRIAL PARK
+				SHENZHEN 518057    12345
+				CN
+
+64-16-F0   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+6416F0     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 2, Zone B,Huawei Industrial Park,Bantian, Longgang District
+				Shenzhen  Guangdong  518129
+				CN
+
+F4-03-04   (hex)		Google, Inc.
+F40304     (base 16)		Google, Inc.
+				1600 Amphitheatre Pkwy
+				Mt. View  CA  94043
+				US
+
+54-60-09   (hex)		Google, Inc.
+546009     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+A4-77-33   (hex)		Google, Inc.
+A47733     (base 16)		Google, Inc.
+				1600 Ampitheatre Parkway
+				Mountain View    94043
+				US
+
+80-7A-BF   (hex)		HTC Corporation
+807ABF     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+78-F8-82   (hex)		LG Electronics (Mobile Communications)
+78F882     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+C0-2C-7A   (hex)		Shenzhen Horn Audio Co.,Ltd.
+C02C7A     (base 16)		Shenzhen Horn Audio Co.,Ltd.
+				Block17,Tongfuyu lnd.Zone,Dalang,Baoan 
+				Shenzhen  Guang Dong   518109 
+				CN
+
+1C-CB-99   (hex)		TCT mobile ltd
+1CCB99     (base 16)		TCT mobile ltd
+				No.86 hechang 7th road, zhongkai, Hi-Tech District
+				Hui Zhou  Guang Dong  516006
+				CN
+
+A4-2B-B0   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+A42BB0     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+18-8B-45   (hex)		Cisco Systems, Inc
+188B45     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+60-69-44   (hex)		Apple, Inc.
+606944     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-C6-9A   (hex)		Juniper Networks
+B0C69A     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+2C-6B-F5   (hex)		Juniper Networks
+2C6BF5     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C4-2F-90   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+C42F90     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.469,Jianghui Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+F4-CA-24   (hex)		FreeBit Co., Ltd.
+F4CA24     (base 16)		FreeBit Co., Ltd.
+				E.Space Tower 3-6 Maruyama-Cho
+				Shibuya-ku  Tokyo  150-0044
+				JP
+
+00-D0-B7   (hex)		Intel Corporation
+00D0B7     (base 16)		Intel Corporation
+				5200 NE ELAM YOUNG PARKWAY
+				HILLSBORO  OR  97124
+				US
+
+00-1D-D6   (hex)		ARRIS Group, Inc.
+001DD6     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+90-3E-AB   (hex)		ARRIS Group, Inc.
+903EAB     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+30-60-23   (hex)		ARRIS Group, Inc.
+306023     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+14-AB-F0   (hex)		ARRIS Group, Inc.
+14ABF0     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-14-F6   (hex)		Juniper Networks
+0014F6     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+90-1A-CA   (hex)		ARRIS Group, Inc.
+901ACA     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+C8-3F-B4   (hex)		ARRIS Group, Inc.
+C83FB4     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+E0-B7-0A   (hex)		ARRIS Group, Inc.
+E0B70A     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-1D-CE   (hex)		ARRIS Group, Inc.
+001DCE     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-13-E8   (hex)		Intel Corporate
+0013E8     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-13-CE   (hex)		Intel Corporate
+0013CE     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+2C-76-8A   (hex)		Hewlett Packard
+2C768A     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+C8-34-8E   (hex)		Intel Corporate
+C8348E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+4C-34-88   (hex)		Intel Corporate
+4C3488     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+10-02-B5   (hex)		Intel Corporate
+1002B5     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-40-26   (hex)		BUFFALO.INC
+004026     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+4C-E6-76   (hex)		BUFFALO.INC
+4CE676     (base 16)		BUFFALO.INC
+				AKAMONDORI Bldg., 30-20,Ohsu 3-chome
+				Naka-ku,Nagoya  Aichi Pref.  460-8315
+				JP
+
+00-0B-CD   (hex)		Hewlett Packard
+000BCD     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-0F-20   (hex)		Hewlett Packard
+000F20     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-11-0A   (hex)		Hewlett Packard
+00110A     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+B8-B8-1E   (hex)		Intel Corporate
+B8B81E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+B4-6D-83   (hex)		Intel Corporate
+B46D83     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3
+				Kulim  Kedah  09000
+				MY
+
+00-0E-35   (hex)		Intel Corporation
+000E35     (base 16)		Intel Corporation
+				2111 NE 25th Ave
+				Hillsboro  OR  97123
+				US
+
+00-07-E9   (hex)		Intel Corporation
+0007E9     (base 16)		Intel Corporation
+				2111 NE 25th Avenue
+				Hillsboro  OR  97124
+				US
+
+00-17-08   (hex)		Hewlett Packard
+001708     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+00-17-A4   (hex)		Hewlett Packard
+0017A4     (base 16)		Hewlett Packard
+				20555 State Highway 249
+				Houston  TX  77070
+				US
+
+C0-05-C2   (hex)		ARRIS Group, Inc.
+C005C2     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-30-C1   (hex)		Hewlett Packard
+0030C1     (base 16)		Hewlett Packard
+				11000 WOLFE ROAD
+				CUPERTINO  CA  95014
+				US
+
+00-80-A0   (hex)		Hewlett Packard
+0080A0     (base 16)		Hewlett Packard
+				ALAMEDA RIO NEGRO,
+				houston  tx  77070
+				BR
+
+D4-85-64   (hex)		Hewlett Packard
+D48564     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+24-BE-05   (hex)		Hewlett Packard
+24BE05     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive W
+				Houston    77070
+				US
+
+FC-3F-DB   (hex)		Hewlett Packard
+FC3FDB     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston  TX  77070
+				US
+
+30-8D-99   (hex)		Hewlett Packard
+308D99     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+58-20-B1   (hex)		Hewlett Packard
+5820B1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+94-57-A5   (hex)		Hewlett Packard
+9457A5     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+00-0E-B3   (hex)		Hewlett Packard
+000EB3     (base 16)		Hewlett Packard
+				2580 55th Street
+				Boulder  CO  80301
+				US
+
+08-00-09   (hex)		Hewlett Packard
+080009     (base 16)		Hewlett Packard
+				ENTERPRISE SYSTEMS TECH.CENTER
+				CUPERTINO  CA  95014
+				US
+
+90-CD-B6   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+90CDB6     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+40-49-0F   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+40490F     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-26-5C   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+00265C     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-22-69   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+002269     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+D8-79-88   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D87988     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+74-A7-8E   (hex)		zte corporation
+74A78E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+00-09-2D   (hex)		HTC Corporation
+00092D     (base 16)		HTC Corporation
+				No.23 Xinghua Road,
+				Taoyuan County     330
+				TW
+
+44-31-92   (hex)		Hewlett Packard
+443192     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+A0-D3-C1   (hex)		Hewlett Packard
+A0D3C1     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+38-EA-A7   (hex)		Hewlett Packard
+38EAA7     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+AC-16-2D   (hex)		Hewlett Packard
+AC162D     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+80-C1-6E   (hex)		Hewlett Packard
+80C16E     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+B4-B5-2F   (hex)		Hewlett Packard
+B4B52F     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D0-7E-28   (hex)		Hewlett Packard
+D07E28     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+D0-BF-9C   (hex)		Hewlett Packard
+D0BF9C     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+7C-61-93   (hex)		HTC Corporation
+7C6193     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., 
+				Taoyuan County    330
+				TW
+
+90-E7-C4   (hex)		HTC Corporation
+90E7C4     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd.
+				Taoyuan County  Taiwan  330
+				TW
+
+BC-EA-FA   (hex)		Hewlett Packard
+BCEAFA     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+74-46-A0   (hex)		Hewlett Packard
+7446A0     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+2C-44-FD   (hex)		Hewlett Packard
+2C44FD     (base 16)		Hewlett Packard
+				11445 Compaq Center Drive
+				Houston    77070
+				US
+
+04-53-D5   (hex)		Sysorex Global Holdings
+0453D5     (base 16)		Sysorex Global Holdings
+				Suite 195 2479 E. Bayshore Road
+				Palo Alto  CA  94303
+				US
+
+EC-52-DC   (hex)		WORLD MEDIA AND TECHNOLOGY Corp.
+EC52DC     (base 16)		WORLD MEDIA AND TECHNOLOGY Corp.
+				600 Brickell World Plaza, suite 1775
+				Miami    33132
+				US
+
+94-B2-CC   (hex)		PIONEER CORPORATION
+94B2CC     (base 16)		PIONEER CORPORATION
+				1-1 Shin-ogura
+				Kawasaki-shi  Kanagawa Prefecture  2120031
+				JP
+
+04-52-F3   (hex)		Apple, Inc.
+0452F3     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-C2-55   (hex)		Texas Instruments
+88C255     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+CC-78-AB   (hex)		Texas Instruments
+CC78AB     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+1C-78-39   (hex)		Shenzhen Tencent Computer System Co., Ltd.
+1C7839     (base 16)		Shenzhen Tencent Computer System Co., Ltd.
+				36/F, Tencent Building, Kejizhongyi Avenue, Hi-Tech Park
+				Shenzhen  Guangdong  518057
+				CN
+
+FC-D7-33   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+FCD733     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+5C-89-9A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+5C899A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+A8-1B-5A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A81B5A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN,DONGGUAN,GUANGDONG,CHINA
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+2C-5B-B8   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+2C5BB8     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,WUSHA,CHANG'AN,DONGGUAN,GUANGDONG,CHINA
+				DONGGUAN  GUANGDONG  523860
+				CN
+
+08-EB-74   (hex)		HUMAX Co., Ltd.
+08EB74     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 11-4, Sunae-dong, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-825
+				KR
+
+E0-05-C5   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+E005C5     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 7, Second Part, Honghualing Industrial Zone
+				Shenzhen  Guangdong  518000
+				CN
+
+38-83-45   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+388345     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park,Shennan Rd, Nanshan, 
+				Shenzhen,  Guangdong Province  518057
+				CN
+
+EC-88-8F   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+EC888F     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park
+				Shenzhen  Guangdong  518057
+				CN
+
+64-66-B3   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+6466B3     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)  Central Science and Technology Park
+				Shenzhen  Guangdong  518057
+				CN
+
+28-32-C5   (hex)		HUMAX Co., Ltd.
+2832C5     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village,216,Hwangsaeul-ro,Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+F0-F3-36   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F0F336     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+BC-46-99   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+BC4699     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4)
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+F4-83-CD   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F483CD     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24 (floors 1,3,4,5) and 28 (floors1-4) 
+				Shennan Rd, Nanshan  Shenzhen,Guangdong Province  518057
+				CN
+
+00-21-27   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+002127     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				South Building, No.5 Keyuan Road, Central Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+5C-63-BF   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+5C63BF     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				1-6F, Building 2, Pingshandayuan Industrial, South Zone,
+				Shenzhen  Guangdong  518000
+				CN
+
+14-2D-27   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+142D27     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+88-E3-AB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+88E3AB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+C4-05-28   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C40528     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+3C-DF-BD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3CDFBD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+50-9F-27   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+509F27     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+80-71-7A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+80717A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-21-E8   (hex)		Murata Manufacturing Co., Ltd.
+0021E8     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+00-0E-6D   (hex)		Murata Manufacturing Co., Ltd.
+000E6D     (base 16)		Murata Manufacturing Co., Ltd.
+				2288, Oaza-Ohshinohara, Yasu-cho,
+				Yasu-gun  Shiga  520-2393
+				JP
+
+90-21-06   (hex)		BSkyB Ltd
+902106     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+D0-27-88   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+D02788     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+90-4C-E5   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+904CE5     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-1F-E2   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+001FE2     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+00-16-CF   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+0016CF     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+20-02-AF   (hex)		Murata Manufacturing Co., Ltd.
+2002AF     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1 Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+98-F5-37   (hex)		zte corporation
+98F537     (base 16)		zte corporation
+				12/F.,zte R&D building,kejinan Road,
+				shenzhen  guangdong  518057
+				CN
+
+5C-4C-A9   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5C4CA9     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+F4-C7-14   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4C714     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District,
+				Shenzhen  Guangdong  518108
+				CN
+
+28-6E-D4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+286ED4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				HUAWEI Industrial Base Bantian,Longgang
+				Shenzhen  guangdong  518129
+				CN
+
+00-1E-10   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+001E10     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				HUAWEI INDUSTRIAL PK BANTIAN, LONGGANG DIST SHENZHEN
+				SHENZHEN  GUANGDONG  518077
+				CN
+
+D4-78-56   (hex)		Avaya Inc
+D47856     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+D8-42-AC   (hex)		Shanghai Feixun Communication Co.,Ltd.
+D842AC     (base 16)		Shanghai Feixun Communication Co.,Ltd.
+				Building 90, No. 4855, Guangfulin Road, Songjiang District
+				Shanghai    201616
+				CN
+
+54-39-DF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5439DF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				Shenzhen  Guangdong  518129
+				CN
+
+28-3C-E4   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+283CE4     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate,Shiyan Baoan District 
+				Shenzhen  Guangdong  518057
+				CN
+
+2C-F4-C5   (hex)		Avaya Inc
+2CF4C5     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+3C-3A-73   (hex)		Avaya Inc
+3C3A73     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+FC-83-99   (hex)		Avaya Inc
+FC8399     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+58-7F-66   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+587F66     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+64-A6-51   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+64A651     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+08-63-61   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+086361     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				Building 17,Nangang Industrial Park, Tangtou 3nd Industrial Estate
+				Shenzhen  GuangDong  518057
+				CN
+
+A0-12-90   (hex)		Avaya Inc
+A01290     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+38-BB-3C   (hex)		Avaya Inc
+38BB3C     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+F8-73-A2   (hex)		Avaya Inc
+F873A2     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+CC-F9-54   (hex)		Avaya Inc
+CCF954     (base 16)		Avaya Inc
+				360 Mt Kemble Ave
+				Morristown  NJ  07960
+				US
+
+8C-34-FD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C34FD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+AC-F7-F3   (hex)		Xiaomi Communications Co Ltd
+ACF7F3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+D4-97-0B   (hex)		Xiaomi Communications Co Ltd
+D4970B     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+8C-BE-BE   (hex)		Xiaomi Communications Co Ltd
+8CBEBE     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+14-F6-5A   (hex)		Xiaomi Communications Co Ltd
+14F65A     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-9E-C8   (hex)		Xiaomi Communications Co Ltd
+009EC8     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+0C-1D-AF   (hex)		Xiaomi Communications Co Ltd
+0C1DAF     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+08-19-A6   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+0819A6     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+3C-F8-08   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+3CF808     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+48-62-76   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+486276     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+B4-15-13   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B41513     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+AC-4E-91   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+AC4E91     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+28-31-52   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+283152     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base,Bantian,Longgang,Shenzhen
+				ShenZhen  GuangDong  518129
+				CN
+
+34-80-B3   (hex)		Xiaomi Communications Co Ltd
+3480B3     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+F4-8B-32   (hex)		Xiaomi Communications Co Ltd
+F48B32     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+00-90-21   (hex)		Cisco Systems, Inc
+009021     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-90-B1   (hex)		Cisco Systems, Inc
+0090B1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-B6   (hex)		Texas Instruments
+001AB6     (base 16)		Texas Instruments
+				108 Wild Basin Ste 350
+				Austin  TX  78746
+				US
+
+00-12-D1   (hex)		Texas Instruments
+0012D1     (base 16)		Texas Instruments
+				12500 TI Boulevard,
+				Dallas    75243
+				US
+
+00-12-37   (hex)		Texas Instruments
+001237     (base 16)		Texas Instruments
+				12500 TI Boulevard,
+				Dallas    75243
+				US
+
+A0-E6-F8   (hex)		Texas Instruments
+A0E6F8     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+70-FF-76   (hex)		Texas Instruments
+70FF76     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D0-39-72   (hex)		Texas Instruments
+D03972     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+5C-31-3E   (hex)		Texas Instruments
+5C313E     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+F4-B8-5E   (hex)		Texas Instruments
+F4B85E     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+68-C9-0B   (hex)		Texas Instruments
+68C90B     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+74-88-2A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+74882A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+4C-B1-6C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+4CB16C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1-4,Huawei Industrial Base,Bantian,Longgang
+				ShenZhen  GuangDong  518129
+				CN
+
+04-BD-70   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+04BD70     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				D1,Huawei Industrial Base
+				Shenzhen  Guangdong  518129
+				CN
+
+D4-F5-13   (hex)		Texas Instruments
+D4F513     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+50-72-24   (hex)		Texas Instruments
+507224     (base 16)		Texas Instruments
+				12500 TI BLVD
+				Dallas    75243
+				US
+
+00-90-D9   (hex)		Cisco Systems, Inc
+0090D9     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-90-92   (hex)		Cisco Systems, Inc
+009092     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-2F   (hex)		Cisco Systems, Inc
+00102F     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-0D   (hex)		Cisco Systems, Inc
+00100D     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-07   (hex)		Cisco Systems, Inc
+001007     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-10-14   (hex)		Cisco Systems, Inc
+001014     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+00-90-BF   (hex)		Cisco Systems, Inc
+0090BF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-50-D1   (hex)		Cisco Systems, Inc
+0050D1     (base 16)		Cisco Systems, Inc
+				170 W. TASMAN DR.
+				SAN JOSE  CA  95134-1706
+				US
+
+1C-E6-C7   (hex)		Cisco Systems, Inc
+1CE6C7     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+CC-D5-39   (hex)		Cisco Systems, Inc
+CCD539     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+4C-00-82   (hex)		Cisco Systems, Inc
+4C0082     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+7C-95-F3   (hex)		Cisco Systems, Inc
+7C95F3     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+34-DB-FD   (hex)		Cisco Systems, Inc
+34DBFD     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+88-5A-92   (hex)		Cisco Systems, Inc
+885A92     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-40-0B   (hex)		Cisco Systems, Inc
+00400B     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-60-70   (hex)		Cisco Systems, Inc
+006070     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+50-06-04   (hex)		Cisco Systems, Inc
+500604     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-E0-1E   (hex)		Cisco Systems, Inc
+00E01E     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+00-11-2F   (hex)		ASUSTek COMPUTER INC.
+00112F     (base 16)		ASUSTek COMPUTER INC.
+				No.150, Li-Te Rd., Peitou
+				Taipei    112
+				TW
+
+00-1B-FC   (hex)		ASUSTek COMPUTER INC.
+001BFC     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou
+				Taipei    112
+				TW
+
+A0-55-4F   (hex)		Cisco Systems, Inc
+A0554F     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+20-4C-9E   (hex)		Cisco Systems, Inc
+204C9E     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+84-B8-02   (hex)		Cisco Systems, Inc
+84B802     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+B0-AA-77   (hex)		Cisco Systems, Inc
+B0AA77     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+BC-C4-93   (hex)		Cisco Systems, Inc
+BCC493     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+A4-6C-2A   (hex)		Cisco Systems, Inc
+A46C2A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+D0-A5-A6   (hex)		Cisco Systems, Inc
+D0A5A6     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+3C-5E-C3   (hex)		Cisco Systems, Inc
+3C5EC3     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+64-F6-9D   (hex)		Cisco Systems, Inc
+64F69D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-03-89   (hex)		PLANTRONICS, INC.
+000389     (base 16)		PLANTRONICS, INC.
+				345 ENCINAL STREET
+				SANTA CRUZ  CA  95060
+				US
+
+D0-72-DC   (hex)		Cisco Systems, Inc
+D072DC     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+28-C7-CE   (hex)		Cisco Systems, Inc
+28C7CE     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F4-0F-1B   (hex)		Cisco Systems, Inc
+F40F1B     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F8-C2-88   (hex)		Cisco Systems, Inc
+F8C288     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+1C-6A-7A   (hex)		Cisco Systems, Inc
+1C6A7A     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-1E-E5   (hex)		Cisco-Linksys, LLC
+001EE5     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine    92612
+				US
+
+48-44-87   (hex)		Cisco SPVTG
+484487     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+38-C8-5C   (hex)		Cisco SPVTG
+38C85C     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+48-5B-39   (hex)		ASUSTek COMPUTER INC.
+485B39     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,Taipei 112 ,Taiwan
+				Taipei  Taiwan  112
+				TW
+
+BC-AE-C5   (hex)		ASUSTek COMPUTER INC.
+BCAEC5     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,
+				Taipei    112
+				TW
+
+10-BF-48   (hex)		ASUSTek COMPUTER INC.
+10BF48     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd.,Peitou,
+				Taipei    112
+				TW
+
+50-67-AE   (hex)		Cisco Systems, Inc
+5067AE     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+F0-9E-63   (hex)		Cisco Systems, Inc
+F09E63     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+6C-99-89   (hex)		Cisco Systems, Inc
+6C9989     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+18-E7-28   (hex)		Cisco Systems, Inc
+18E728     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+00-12-17   (hex)		Cisco-Linksys, LLC
+001217     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+00-13-10   (hex)		Cisco-Linksys, LLC
+001310     (base 16)		Cisco-Linksys, LLC
+				121 Theory Dr.
+				Irvine  CA  92612
+				US
+
+04-6C-9D   (hex)		Cisco Systems, Inc
+046C9D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+84-B2-61   (hex)		Cisco Systems, Inc
+84B261     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+E4-48-C7   (hex)		Cisco SPVTG
+E448C7     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Pkwy
+				Lawrenceville  GA  30044
+				US
+
+00-10-1F   (hex)		Cisco Systems, Inc
+00101F     (base 16)		Cisco Systems, Inc
+				170 WEST TASMAN DRIVE
+				SAN JOSE  CA  95134-1706
+				US
+
+54-A2-74   (hex)		Cisco Systems, Inc
+54A274     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+60-FB-42   (hex)		Apple, Inc.
+60FB42     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+64-B9-E8   (hex)		Apple, Inc.
+64B9E8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-1D-4F   (hex)		Apple, Inc.
+001D4F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-23-12   (hex)		Apple, Inc.
+002312     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+80-E0-1D   (hex)		Cisco Systems, Inc
+80E01D     (base 16)		Cisco Systems, Inc
+				170 West Tasman Drive
+				San Jose  CA  95134
+				US
+
+D8-A2-5E   (hex)		Apple, Inc.
+D8A25E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-0A-27   (hex)		Apple, Inc.
+000A27     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-34-51   (hex)		Apple, Inc.
+183451     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+0C-77-1A   (hex)		Apple, Inc.
+0C771A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-6A-BA   (hex)		Apple, Inc.
+286ABA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+4C-B1-99   (hex)		Apple, Inc.
+4CB199     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+C0-9F-42   (hex)		Apple, Inc.
+C09F42     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D0-23-DB   (hex)		Apple, Inc.
+D023DB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-DE-E2   (hex)		Apple, Inc.
+70DEE2     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-CB-A1   (hex)		Apple, Inc.
+F0CBA1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-20-32   (hex)		Apple, Inc.
+182032     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-3C-FC   (hex)		Apple, Inc.
+403CFC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+48-60-BC   (hex)		Apple, Inc.
+4860BC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-51-C9   (hex)		Apple, Inc.
+3451C9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-6C-8F   (hex)		Apple, Inc.
+406C8F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+58-55-CA   (hex)		Apple, Inc.
+5855CA     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-2B-61   (hex)		Apple, Inc.
+DC2B61     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+40-A6-D9   (hex)		Apple, Inc.
+40A6D9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+60-FA-CD   (hex)		Apple, Inc.
+60FACD     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-3E-E1   (hex)		Apple, Inc.
+003EE1     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-25-3F   (hex)		Apple, Inc.
+FC253F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-F7-E4   (hex)		Apple, Inc.
+04F7E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+34-C0-59   (hex)		Apple, Inc.
+34C059     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-D1-A9   (hex)		Apple, Inc.
+F0D1A9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-56-81   (hex)		Apple, Inc.
+705681     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-10-9F   (hex)		Apple, Inc.
+14109F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-0C-CE   (hex)		Apple, Inc.
+040CCE     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-EA-A8   (hex)		Apple, Inc.
+54EAA8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-E1-4C   (hex)		Apple, Inc.
+28E14C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E4-C6-3D   (hex)		Apple, Inc.
+E4C63D     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-E4-3A   (hex)		Apple, Inc.
+54E43A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-DB-56   (hex)		Apple, Inc.
+04DB56     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-3C-0B   (hex)		Apple, Inc.
+AC3C0B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+70-11-24   (hex)		Apple, Inc.
+701124     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-26-65   (hex)		Apple, Inc.
+042665     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+EC-35-86   (hex)		Apple, Inc.
+EC3586     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+78-FD-94   (hex)		Apple, Inc.
+78FD94     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-BE-08   (hex)		Apple, Inc.
+2CBE08     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+E8-80-2E   (hex)		Apple, Inc.
+E8802E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+00-61-71   (hex)		Apple, Inc.
+006171     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+8C-7C-92   (hex)		Apple, Inc.
+8C7C92     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B0-34-95   (hex)		Apple, Inc.
+B03495     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F4-37-B7   (hex)		Apple, Inc.
+F437B7     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-7F-3E   (hex)		Apple, Inc.
+AC7F3E     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-0B-5C   (hex)		Apple, Inc.
+280B5C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+AC-FD-EC   (hex)		Apple, Inc.
+ACFDEC     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-9B-9C   (hex)		Apple, Inc.
+DC9B9C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+54-72-4F   (hex)		Apple, Inc.
+54724F     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D8-CF-9C   (hex)		Apple, Inc.
+D8CF9C     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+7C-6D-F8   (hex)		Apple, Inc.
+7C6DF8     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+04-E5-36   (hex)		Apple, Inc.
+04E536     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+A8-BB-CF   (hex)		Apple, Inc.
+A8BBCF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-40-08   (hex)		Apple, Inc.
+6C4008     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+FC-A3-86   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+FCA386     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+40-33-1A   (hex)		Apple, Inc.
+40331A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+CC-C7-60   (hex)		Apple, Inc.
+CCC760     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+BC-4C-C4   (hex)		Apple, Inc.
+BC4CC4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+DC-37-14   (hex)		Apple, Inc.
+DC3714     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-A2-E4   (hex)		Apple, Inc.
+20A2E4     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-F0-76   (hex)		Apple, Inc.
+28F076     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+14-13-57   (hex)		ATP Electronics, Inc.
+141357     (base 16)		ATP Electronics, Inc.
+				2590 North First Street Suite 150
+				San Jose  CA  95131
+				US
+
+B8-B2-EB   (hex)		Googol Technology (HK) Limited
+B8B2EB     (base 16)		Googol Technology (HK) Limited
+				Unit 1008-09, 10/F C-Bons International Center
+				Kwun Tong  Kowloon  nil
+				HK
+
+FC-CF-43   (hex)		HUIZHOU CITY HUIYANG DISTRICT MEISIQI INDUSTRY DEVELOPMENT CO,.LTD
+FCCF43     (base 16)		HUIZHOU CITY HUIYANG DISTRICT MEISIQI INDUSTRY DEVELOPMENT CO,.LTD
+				Meisiqi lndustrialPark,Yuechang,
+				Huizhou  Guangdong  516000
+				CN
+
+D8-48-EE   (hex)		Hangzhou Xueji Technology Co., Ltd.
+D848EE     (base 16)		Hangzhou Xueji Technology Co., Ltd.
+				Room 1902, Tower D, West Intime City
+				Hangzhou  Zhejiang  310012
+				CN
+
+B4-EF-04   (hex)		DAIHAN Scientific Co., Ltd.
+B4EF04     (base 16)		DAIHAN Scientific Co., Ltd.
+				326, Sinpyoungsukhwaro
+				Wonju-si,  Gangwon-do  26358
+				KR
+
+A4-DE-C9   (hex)		QLove Mobile Intelligence Information Technology (W.H.) Co. Ltd.
+A4DEC9     (base 16)		QLove Mobile Intelligence Information Technology (W.H.) Co. Ltd.
+				Sun Jia Tuan Township, Huan Cui District, Weihai, P.R.China
+				 Weihai  Shan Dong  264201
+				CN
+
+CC-E0-C3   (hex)		EXTEN Technologies, Inc.
+CCE0C3     (base 16)		EXTEN Technologies, Inc.
+				4201 W Parmer Lane Bldg A, Ste 200
+				Austin  TX  78727
+				US
+
+64-6A-74   (hex)		AUTH-SERVERS, LLC
+646A74     (base 16)		AUTH-SERVERS, LLC
+				43479 Stukely Dr
+				Sterling  VA  20166
+				US
+
+4C-8E-CC   (hex)		SILKAN SA
+4C8ECC     (base 16)		SILKAN SA
+				Immeuble le Sirius
+				Meudon La Foret  Ile de France  92360
+				FR
+
+E4-35-C8   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E435C8     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+0C-54-B9   (hex)		Nokia
+0C54B9     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+84-10-0D   (hex)		Motorola Mobility LLC, a Lenovo Company
+84100D     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+D0-0F-6D   (hex)		T&W Electronics Company
+D00F6D     (base 16)		T&W Electronics Company
+				89# Jiang Nan RD, Lu Du
+				Taicang  Jiangsu  21500
+				CN
+
+90-8D-78   (hex)		D-Link International
+908D78     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+7C-71-76   (hex)		Wuxi iData Technology Company Ltd.
+7C7176     (base 16)		Wuxi iData Technology Company Ltd.
+				Floor 11, Building B1, Wuxi(Binhu) National Sensing Information Center, No. 999 Gaolang East Road, Wuxi City, Jiangsu Province, P.R.C.
+				Wuxi  Jiangsu  214131
+				CN
+
+7C-01-91   (hex)		Apple, Inc.
+7C0191     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+2C-1B-C8   (hex)		Hunan Topview Network System CO.,LTD
+2C1BC8     (base 16)		Hunan Topview Network System CO.,LTD
+				RM 3002,3009,3010 Yuelu High-Tech Zone, Hanpu Couty, Yuelu District
+				Changsha  Hunan  410208
+				CN
+
+A8-47-4A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+A8474A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+C4-00-49   (hex)		Kamama
+C40049     (base 16)		Kamama
+				100 Enterprise Way
+				Scotts Valley  CA  95066
+				US
+
+80-D6-05   (hex)		Apple, Inc.
+80D605     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+98-E8-48   (hex)		Axiim
+98E848     (base 16)		Axiim
+				12126 NE 106th Pl
+				Kirkland  WA  98033
+				US
+
+40-40-A7   (hex)		Sony Mobile Communications Inc
+4040A7     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+C0-4A-09   (hex)		Zhejiang Everbright Communication Equip. Co,. Ltd
+C04A09     (base 16)		Zhejiang Everbright Communication Equip. Co,. Ltd
+				291# Wei 19th Rd.
+				Wenzhou  Zhejiang  325600
+				CN
+
+A0-1E-0B   (hex)		MINIX Technology Limited
+A01E0B     (base 16)		MINIX Technology Limited
+				Unit 1501, Chevalier Commercial Center
+				Kowloon Bay  Kowloon  000000
+				HK
+
+68-E8-EB   (hex)		Linktel Technologies Co.,Ltd
+68E8EB     (base 16)		Linktel Technologies Co.,Ltd
+				No.20 University Science Park Road,
+				Wuhan  Hubei  430223
+				CN
+
+A8-45-CD   (hex)		Siselectron Technology LTD.
+A845CD     (base 16)		Siselectron Technology LTD.
+				5F., No.232, Sec. 2, Sioulang Rd., Yonghe Dist.,
+				New Taipei City  Taiwan  23453
+				TW
+
+D0-C1-93   (hex)		SKYBELL, INC
+D0C193     (base 16)		SKYBELL, INC
+				1 JENNER, SUITE 100
+				IRVINE  CA  92618
+				US
+
+AC-64-62   (hex)		zte corporation
+AC6462     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C0-25-A2   (hex)		NEC Platforms, Ltd.
+C025A2     (base 16)		NEC Platforms, Ltd.
+				2-3 Kandatsukasamachi
+				Chiyodaku  Tokyo  101-8532
+				JP
+
+48-13-7E   (hex)		Samsung Electronics Co.,Ltd
+48137E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-F7-72   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+30F772     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+DC-3C-F6   (hex)		Atomic Rules LLC
+DC3CF6     (base 16)		Atomic Rules LLC
+				287 Chester Rd
+				Auburn  NH  03032
+				US
+
+08-9B-4B   (hex)		iKuai Networks
+089B4B     (base 16)		iKuai Networks
+				So Boss Tech Center 2 # 716
+				Fengtai District  Beijing  100068
+				CN
+
+44-73-D6   (hex)		Logitech
+4473D6     (base 16)		Logitech
+				7700 Gateway Blvd
+				Newark  CA  94560
+				US
+
+10-CC-1B   (hex)		Liverock technologies,INC
+10CC1B     (base 16)		Liverock technologies,INC
+				Shinjuku 5-13-10,Joshu-Bldg. 4F
+				Tokyo  Shinjuku-ku  160-0022
+				JP
+
+E8-07-34   (hex)		Champion Optical Network Engineering, LLC
+E80734     (base 16)		Champion Optical Network Engineering, LLC
+				23645 Mercantile Rd.
+				Beachwood  OH  44122
+				US
+
+A4-38-31   (hex)		RF elements s.r.o.
+A43831     (base 16)		RF elements s.r.o.
+				Jasenovská 2528
+				Humenne  SK  06603
+				SK
+
+38-05-46   (hex)		Foctek Photonics, Inc.
+380546     (base 16)		Foctek Photonics, Inc.
+				No. 8, the 7th Road Phase II of Minhou Tieling Industrial District
+				Fuzhou  Fujian  350100
+				CN
+
+D4-83-04   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+D48304     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+DC-2B-2A   (hex)		Apple, Inc.
+DC2B2A     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+9C-8D-D3   (hex)		Leonton Technologies
+9C8DD3     (base 16)		Leonton Technologies
+				3F, No.501-16, Zhongzheng Rd., Xindian Dist.
+				New Taipei City  Taiwan  231
+				TW
+
+E4-1A-2C   (hex)		ZPE Systems, Inc.
+E41A2C     (base 16)		ZPE Systems, Inc.
+				39420 Liberty Street,  #253
+				Fremont  CA  94538
+				US
+
+E8-BD-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+E8BDD1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+F4-15-35   (hex)		SPON Communication Technology Co.,Ltd
+F41535     (base 16)		SPON Communication Technology Co.,Ltd
+				B Building, Lugu International Industrial Zone, NO.229, Tongzipo Road, Changsha, China
+				changsha  hunan  410000
+				CN
+
+38-0A-AB   (hex)		Formlabs
+380AAB     (base 16)		Formlabs
+				35 Medford St
+				Somerville  MA  02143
+				US
+
+38-2D-E8   (hex)		Samsung Electronics Co.,Ltd
+382DE8     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-89-97   (hex)		Samsung Electronics Co.,Ltd
+C08997     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+A8-15-D6   (hex)		Shenzhen Meione Technology CO., LTD
+A815D6     (base 16)		Shenzhen Meione Technology CO., LTD
+				12th FloorFutian Sports Park Cultural Industries Headquarters Building No. 3030 Fuqiang Road, Futian District
+				Shenzhen  Guangdong  518000
+				CN
+
+C0-7C-D1   (hex)		PEGATRON CORPORATION
+C07CD1     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+90-D8-F3   (hex)		zte corporation
+90D8F3     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+D4-45-E8   (hex)		Jiangxi Hongpai Technology Co., Ltd.
+D445E8     (base 16)		Jiangxi Hongpai Technology Co., Ltd.
+				5th Floor,C Region, Zhejiang University Science Park,No. 698,
+				Nanchang  Jiangxi  330096
+				CN
+
+34-26-06   (hex)		CarePredict, Inc.
+342606     (base 16)		CarePredict, Inc.
+				PO Box 551686
+				Fort Lauderdale  Florida  33355
+				US
+
+38-B7-25   (hex)		Wistron Infocomm (Zhongshan) Corporation
+38B725     (base 16)		Wistron Infocomm (Zhongshan) Corporation
+				No.38,East Keji Road,Zhongshan Torch Development Zone,Zhongshan City,Guangdong,China
+				Zhongshan  Guangdong  528437
+				CN
+
+AC-EC-80   (hex)		ARRIS Group, Inc.
+ACEC80     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+50-7B-9D   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+507B9D     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+6C-72-20   (hex)		D-Link International
+6C7220     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+30-A2-43   (hex)		Shenzhen Prifox Innovation Technology Co., Ltd.
+30A243     (base 16)		Shenzhen Prifox Innovation Technology Co., Ltd.
+				Room B905, Bldg 4, Software Industry Park,
+				Shenzhen  Guangdong Province  518057
+				
+
+38-01-95   (hex)		Samsung Electronics Co.,Ltd
+380195     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+24-6E-96   (hex)		Dell Inc.
+246E96     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+44-97-5A   (hex)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+44975A     (base 16)		SHENZHEN FAST TECHNOLOGIES CO.,LTD
+				Room 202,Building No.5,Section 30,No.2 of Kefa Road,Nanshan District,Shenzhen,P.R.China
+				Shenzhen  Guangdong  518057
+				CN
+
+50-45-F7   (hex)		Liuhe Intelligence Technology Ltd.
+5045F7     (base 16)		Liuhe Intelligence Technology Ltd.
+				7th Floor,Information Building,
+				Beijing  Beijing  100085
+				CN
+
+AC-67-6F   (hex)		Electrocompaniet A.S.
+AC676F     (base 16)		Electrocompaniet A.S.
+				Breivikveien 7
+				Tau  Rogaland  4120
+				NO
+
+64-0D-E6   (hex)		Petra Systems
+640DE6     (base 16)		Petra Systems
+				One Cragwood Road
+				South Plainfield  NJ  07080
+				US
+
+E0-55-3D   (hex)		Cisco Meraki
+E0553D     (base 16)		Cisco Meraki
+				500 Terry A. Francois Blvd
+				San Francisco  California  94158
+				US
+
+FC-33-5F   (hex)		Polyera
+FC335F     (base 16)		Polyera
+				8045 Lamon Avenue
+				Skokie  IL  60077
+				US
+
+84-D4-C8   (hex)		Widex A/S
+84D4C8     (base 16)		Widex A/S
+				Nymoellevej 6
+				Lynge  Alleroed  DK3540
+				DK
+
+EC-21-E5   (hex)		Toshiba
+EC21E5     (base 16)		Toshiba
+				2-9,Suehiro-Cho
+				Ome  Tokyo  1988710
+				JP
+
+04-C2-3E   (hex)		HTC Corporation
+04C23E     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+E0-1A-EA   (hex)		Allied Telesis, Inc.
+E01AEA     (base 16)		Allied Telesis, Inc.
+				3041 Orchard Parkway
+				San Jose  CALIFORNIA  95134
+				US
+
+28-B9-D9   (hex)		Radisys Corporation
+28B9D9     (base 16)		Radisys Corporation
+				5435 NE Dawson Creek Drive
+				Hillsboro  OR  97124
+				US
+
+F4-C6-13   (hex)		Alcatel-Lucent Shanghai Bell Co., Ltd
+F4C613     (base 16)		Alcatel-Lucent Shanghai Bell Co., Ltd
+				No. 389, Ningqiao Road, Pudong Jinqiao
+				Shanghai    201206
+				CN
+
+44-5F-8C   (hex)		Intercel Group Limited
+445F8C     (base 16)		Intercel Group Limited
+				Unit 6, 17/F, Vanta industrial Centre,
+				New Territories, Hong Kong    
+				CN
+
+B8-89-81   (hex)		Chengdu InnoThings Technology Co., Ltd.
+B88981     (base 16)		Chengdu InnoThings Technology Co., Ltd.
+				West Port Technology Enterprise Incubator Park
+				Chengdu  Sichuan  610000
+				CN
+
+F0-26-24   (hex)		WAFA TECHNOLOGIES CO., LTD.
+F02624     (base 16)		WAFA TECHNOLOGIES CO., LTD.
+				Room302, Longtaili Building
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-F4-64   (hex)		Rawe Electonic GmbH
+F8F464     (base 16)		Rawe Electonic GmbH
+				Bregenzer Str. 67-69
+				Weiler im Allgäu  Bavaria  88171
+				DE
+
+5C-51-88   (hex)		Motorola Mobility LLC, a Lenovo Company
+5C5188     (base 16)		Motorola Mobility LLC, a Lenovo Company
+				222 West Merchandise Mart Plaza
+				Chicago  IL  60654
+				US
+
+EC-01-33   (hex)		TRINUS SYSTEMS INC.
+EC0133     (base 16)		TRINUS SYSTEMS INC.
+				UNITECH VENTURE TOWN SUITE 801
+				GOYANG-SI  GYEONGGI-DO  410-722
+				KR
+
+2C-C5-48   (hex)		IAdea Corporation
+2CC548     (base 16)		IAdea Corporation
+				3F, No.33, Lane 77, Xing-ai Road
+				Taipei  Taiwan  114
+				TW
+
+14-DD-A9   (hex)		ASUSTek COMPUTER INC.
+14DDA9     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+18-4F-32   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+184F32     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+DC-A3-AC   (hex)		RBcloudtech
+DCA3AC     (base 16)		RBcloudtech
+				5th Floor, Jiangnan Street NO.3900, Binjiang District, Hangzhou City.
+				Hangzhou  Zhejiang  310052
+				CN
+
+0C-E7-25   (hex)		Microsoft Corporation
+0CE725     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+58-F1-02   (hex)		BLU Products Inc.
+58F102     (base 16)		BLU Products Inc.
+				Tower 4, Excellence Century Center
+				Shenzhen  Guangdong  518000
+				CN
+
+B4-AE-2B   (hex)		Microsoft
+B4AE2B     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+94-9F-3E   (hex)		Sonos, Inc.
+949F3E     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+30-89-D3   (hex)		HONGKONG UCLOUDLINK NETWORK TECHNOLOGY LIMITED
+3089D3     (base 16)		HONGKONG UCLOUDLINK NETWORK TECHNOLOGY LIMITED
+				FLAT A-8 9/F DELYA INDUSTRIAL CENTRE 7 SHEK PAI TAU ROAD
+				Hong Kong    
+				CN
+
+5C-B3-95   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+5CB395     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-6C-AC   (hex)		Fortinet, Inc.
+906CAC     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale  California  94086
+				US
+
+3C-DA-2A   (hex)		zte corporation
+3CDA2A     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+84-2E-27   (hex)		Samsung Electronics Co.,Ltd
+842E27     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+1C-AD-D1   (hex)		Bosung Electronics Co., Ltd.
+1CADD1     (base 16)		Bosung Electronics Co., Ltd.
+				74-12, Saemaeul-ro.
+				Gumi-si  Gyeongsangbuk-do  730-930
+				KR
+
+08-2C-B0   (hex)		Network Instruments
+082CB0     (base 16)		Network Instruments
+				10701 Red Circle Dr
+				Minnetonka  Minnesota  55343
+				US
+
+A0-13-CB   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+A013CB     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+D0-04-92   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D00492     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+14-32-D1   (hex)		Samsung Electronics Co.,Ltd
+1432D1     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+18-16-C9   (hex)		Samsung Electronics Co.,Ltd
+1816C9     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+00-FC-8D   (hex)		Hitron Technologies. Inc
+00FC8D     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+84-DF-19   (hex)		Chuango Security Technology Corporation
+84DF19     (base 16)		Chuango Security Technology Corporation
+				6-17, Overseas Students Pioneer Park,
+				Fuzhou  Fujian  350015
+				CN
+
+DC-15-DB   (hex)		Ge Ruili Intelligent Technology ( Beijing ) Co., Ltd.
+DC15DB     (base 16)		Ge Ruili Intelligent Technology ( Beijing ) Co., Ltd.
+				Room 821, block E, No.6 Taiping Street, Xicheng District
+				Beijing    100005
+				CN
+
+E0-DB-10   (hex)		Samsung Electronics Co.,Ltd
+E0DB10     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-61-72   (hex)		ZODIAC AEROSPACE SAS
+546172     (base 16)		ZODIAC AEROSPACE SAS
+				61 rue Pierre Curie
+				PLAISIR    78370
+				FR
+
+EC-60-E0   (hex)		AVI-ON LABS
+EC60E0     (base 16)		AVI-ON LABS
+				2585 LARKSPUR DR
+				PARK CITY  UT  84060
+				US
+
+B4-6D-35   (hex)		Dalian Seasky Automation Co;Ltd
+B46D35     (base 16)		Dalian Seasky Automation Co;Ltd
+				Room 408, DUT Science & Technology Park Building B, No.80 Software Park Road,          High-Tech Industrial Zone, Dalian, Liaoning, China
+				Dalian  Liao Ning  116023
+				CN
+
+3C-A3-1A   (hex)		Oilfind International LLC
+3CA31A     (base 16)		Oilfind International LLC
+				12651 Briar Forest Dr, Suite 151
+				Houston  Texas  77077
+				US
+
+30-F3-35   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+30F335     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+E8-F2-E3   (hex)		Starcor Beijing Co.,Limited
+E8F2E3     (base 16)		Starcor Beijing Co.,Limited
+				NO.210 Block B, Building 2
+				Beijing  Berijing  100089
+				CN
+
+64-59-F8   (hex)		Vodafone Omnitel B.V.
+6459F8     (base 16)		Vodafone Omnitel B.V.
+				VIA JERVIS, 13 10015 IVREA (TO)
+				    
+				IT
+
+6C-44-18   (hex)		Zappware
+6C4418     (base 16)		Zappware
+				Ilgatlaan 19
+				Hasselt  Limburg  3500
+				BE
+
+A8-D4-09   (hex)		USA 111 Inc
+A8D409     (base 16)		USA 111 Inc
+				5885 Green Pointe Dr. Suite B Groveport, OH 43125
+				Groveport  Ohio  43125
+				US
+
+6C-45-98   (hex)		Antex Electronic Corp.
+6C4598     (base 16)		Antex Electronic Corp.
+				170 He Ping St.,
+				Tainan City    73443
+				TW
+
+68-A3-78   (hex)		FREEBOX SAS
+68A378     (base 16)		FREEBOX SAS
+				16 rue de la Ville l'Eveque
+				PARIS  IdF  75008
+				FR
+
+34-0A-22   (hex)		TOP-ACCESS ELECTRONICS CO LTD
+340A22     (base 16)		TOP-ACCESS ELECTRONICS CO LTD
+				No. 2 Building 
+				MingZhi Street  BaoAn District,ShenzheN  518131
+				CN
+
+E8-66-C4   (hex)		Diamanti
+E866C4     (base 16)		Diamanti
+				111 N. Market Street
+				San Jose  CA  95113
+				US
+
+D4-D7-A9   (hex)		Shanghai Kaixiang Info Tech LTD
+D4D7A9     (base 16)		Shanghai Kaixiang Info Tech LTD
+				A401, NO.509 Caobao Road, Shanghai, PRC
+				Shanghai  Shanghai  200233
+				CN
+
+34-3D-98   (hex)		JinQianMao Technology Co.,Ltd.
+343D98     (base 16)		JinQianMao Technology Co.,Ltd.
+				58#,Jiangbin Road,Taijiang District
+				Fuzhou  Fujian  350009
+				CN
+
+F4-47-13   (hex)		Leading Public Performance Co., Ltd.
+F44713     (base 16)		Leading Public Performance Co., Ltd.
+				137/77-78 Moo 1 Nanthanagarden Soi 12 Pathum-Rangsit Road Banklang Muang Pathumthani 12000 Thailand
+				Pathumthani  Pathumthani  12000
+				TH
+
+5C-A1-78   (hex)		TableTop Media (dba Ziosk)
+5CA178     (base 16)		TableTop Media (dba Ziosk)
+				12404 Park Central Drive
+				Dallas  TX  75251
+				US
+
+9C-BE-E0   (hex)		Biosoundlab Co., Ltd.
+9CBEE0     (base 16)		Biosoundlab Co., Ltd.
+				(Sangdaewon-dong, Sunil Technopia 907-908ho)
+				Jungwon-gu  Seongnam-si Gyeonggi-do,  462726
+				KR
+
+0C-41-3E   (hex)		Microsoft Corporation
+0C413E     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+D0-6F-4A   (hex)		TOPWELL INTERNATIONAL HOLDINGS LIMITED
+D06F4A     (base 16)		TOPWELL INTERNATIONAL HOLDINGS LIMITED
+				Unit 2506, 25/F, Prosperity Place,
+				Hong Kong  N/A  N/A
+				CN
+
+04-92-EE   (hex)		iway AG
+0492EE     (base 16)		iway AG
+				Badenerstrasse 569
+				Zurich  ZH  8048
+				CH
+
+80-74-59   (hex)		K's Co.,Ltd.
+807459     (base 16)		K's Co.,Ltd.
+				2864-16 Ryomitsuyanagi
+				Yonago  Tottori  683-0853
+				JP
+
+60-19-70   (hex)		HUIZHOU QIAOXING ELECTRONICS TECHNOLOGY CO., LTD.
+601970     (base 16)		HUIZHOU QIAOXING ELECTRONICS TECHNOLOGY CO., LTD.
+				Room -611, TianAn High-Tech Plaza II , Futian District, Shenzhen, China
+				Shenzhen  Guangdong  518040
+				CN
+
+A4-08-EA   (hex)		Murata Manufacturing Co., Ltd.
+A408EA     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+B8-78-79   (hex)		Roche Diagnostics GmbH
+B87879     (base 16)		Roche Diagnostics GmbH
+				Sandhofer Strasse 116
+				Mannheim  Baden-Wuerttemberg  68305
+				DE
+
+D0-83-D4   (hex)		Xtel Wireless ApS
+D083D4     (base 16)		Xtel Wireless ApS
+				Alfred Nobels vej 21E
+				Aalborg Oest  Nordjylland  9220
+				DK
+
+08-D3-4B   (hex)		Techman Electronics (Changshu) Co., Ltd.
+08D34B     (base 16)		Techman Electronics (Changshu) Co., Ltd.
+				No.66, Dalian Road, High-Tech Industrial Park
+				Changshu  Jiangsu Province  215500
+				CN
+
+78-A3-51   (hex)		SHENZHEN ZHIBOTONG ELECTRONICS CO.,LTD
+78A351     (base 16)		SHENZHEN ZHIBOTONG ELECTRONICS CO.,LTD
+				2F,Bldg. A,Kangmai Industrial Park,Renmin Rd
+				Shenzhen  Guangdong  518110
+				CN
+
+E4-69-5A   (hex)		Dictum Health, Inc.
+E4695A     (base 16)		Dictum Health, Inc.
+				255 3rd Street, Suite 102
+				Oakland  CA  94607
+				US
+
+7C-7A-53   (hex)		Phytrex Technology Corp.
+7C7A53     (base 16)		Phytrex Technology Corp.
+				8F-16, No.81, Shuili Rd.,
+				Hsinchu  Taiwan  30059
+				TW
+
+10-78-73   (hex)		Shenzhen Jinkeyi Communication Co., Ltd.
+107873     (base 16)		Shenzhen Jinkeyi Communication Co., Ltd.
+				No. 10 Shun King Road, Zhen Ping Xi Cun,
+				Shenzhen  Guangdong  518117
+				CN
+
+48-EE-0C   (hex)		D-Link International
+48EE0C     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+EC-3C-88   (hex)		MCNEX Co.,Ltd.
+EC3C88     (base 16)		MCNEX Co.,Ltd.
+				Hanshin IT Tower2 11F, Digital lo 9 gil
+				Geumcheon-Gu  Seoul  153-712
+				KR
+
+70-AD-54   (hex)		Malvern Instruments Ltd
+70AD54     (base 16)		Malvern Instruments Ltd
+				Grovewood Rd
+				Malvern  Worcestershire  WR14 1XZ
+				GB
+
+90-00-DB   (hex)		Samsung Electronics Co.,Ltd
+9000DB     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B4-EF-39   (hex)		Samsung Electronics Co.,Ltd
+B4EF39     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+F0-2A-23   (hex)		Creative Next Design
+F02A23     (base 16)		Creative Next Design
+				6-6-15, Kaminopporo 3-jo,
+				Sapporo-shi  Hokkaido  004-0033
+				JP
+
+58-47-04   (hex)		 Shenzhen Webridge Technology Co.,Ltd
+584704     (base 16)		 Shenzhen Webridge Technology Co.,Ltd
+				B2-22/F Chinese Technology Development Institute, High South Road, Nanshan District, Shenzhen, China
+				Shenzhen  Guangdong  518000
+				CN
+
+74-A0-63   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+74A063     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-E2-FD   (hex)		SKG Electric Group(Thailand) Co., Ltd.
+ECE2FD     (base 16)		SKG Electric Group(Thailand) Co., Ltd.
+				3F,The Second Building,Sanhe village , Longhua Rd, Baoan Dist., Shenzhen, China
+				Shenzhen  Guangdong  518301
+				CN
+
+14-8F-21   (hex)		Garmin International
+148F21     (base 16)		Garmin International
+				1200 E. 151st St
+				Olathe  KS  66062
+				US
+
+9C-68-5B   (hex)		Octonion SA
+9C685B     (base 16)		Octonion SA
+				EPFL Innovation Park, Bâtiment C
+				Lausanne  Vaud  1015
+				CH
+
+7C-53-4A   (hex)		Metamako
+7C534A     (base 16)		Metamako
+				Suite 207
+				Sydney  Other  2000
+				AU
+
+BC-6E-64   (hex)		Sony Mobile Communications Inc
+BC6E64     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+BC-B3-08   (hex)		HONGKONG RAGENTEK COMMUNICATION TECHNOLOGY CO.,LIMITED
+BCB308     (base 16)		HONGKONG RAGENTEK COMMUNICATION TECHNOLOGY CO.,LIMITED
+				Building D10-D11
+				PuDong District  Shanghai  201315
+				CN
+
+6C-2E-72   (hex)		B&B EXPORTING LIMITED
+6C2E72     (base 16)		B&B EXPORTING LIMITED
+				Bldg.#D,Xinhe Industrial Park
+				Guangzhou  Guangdong  510880
+				CN
+
+5C-CC-FF   (hex)		Techroutes Network Pvt Ltd
+5CCCFF     (base 16)		Techroutes Network Pvt Ltd
+				WW1-SF, Malibu Towne
+				Gurgaon  Haryana  122002
+				IN
+
+90-C3-5F   (hex)		Nanjing Jiahao Technology Co., Ltd.
+90C35F     (base 16)		Nanjing Jiahao Technology Co., Ltd.
+				Moling Industrial Park, Development Zone, Jiangning, Nanjing
+				Nanjing  Jiangsu  211111
+				CN
+
+C8-08-E9   (hex)		LG Electronics
+C808E9     (base 16)		LG Electronics
+				222 LG-ro, JINWI-MYEON
+				Pyeongtaek-si  Gyeonggi-do  451-713
+				KR
+
+18-3A-2D   (hex)		Samsung Electronics Co.,Ltd
+183A2D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+EC-74-BA   (hex)		Hirschmann Automation and Control GmbH
+EC74BA     (base 16)		Hirschmann Automation and Control GmbH
+				Stuttgarter Strasse 45-51
+				Neckartenzlingen  Baden-Württemberg  72654
+				DE
+
+FC-32-88   (hex)		CELOT Wireless Co., Ltd
+FC3288     (base 16)		CELOT Wireless Co., Ltd
+				4Fl.,NongHyup Bldg.,#1588-10 Gwanyang-Dong
+				Anyang City,  Gyeonggi-Do  431-727
+				KR
+
+D8-74-95   (hex)		zte corporation
+D87495     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+5C-3B-35   (hex)		Gehirn Inc.
+5C3B35     (base 16)		Gehirn Inc.
+				1-3-6 Kudan-kita
+				Chiyoda  Tokyo  102-0073
+				JP
+
+E4-FE-D9   (hex)		EDMI Europe Ltd
+E4FED9     (base 16)		EDMI Europe Ltd
+				The Grainger Suite, Dobson House, Regent  Centre
+				Newcastle upon Tyne  Newcastle upon Tyne  NE3 3PF
+				GB
+
+5C-F7-C3   (hex)		SYNTECH (HK) TECHNOLOGY LIMITED
+5CF7C3     (base 16)		SYNTECH (HK) TECHNOLOGY LIMITED
+				Unit No. 1, 12/F., Perfect Industrial Building ,
+				Kowloon, Hong Kong    999077
+				HK
+
+9C-E2-30   (hex)		JULONG CO,.LTD.
+9CE230     (base 16)		JULONG CO,.LTD.
+				308，QianShanZhong Road,TieDong District,AnShan
+				AnShan City  LiaoNing Province  114051
+				CN
+
+5C-41-E7   (hex)		Wiatec International Ltd.
+5C41E7     (base 16)		Wiatec International Ltd.
+				Unit 601-605,TaoJinDi Electronic Commercial
+				Shenzhen  GuangDong  518131
+				CN
+
+34-4C-A4   (hex)		amazipoint technology Ltd.
+344CA4     (base 16)		amazipoint technology Ltd.
+				1F,No. 14, Aly. 32, Ln. 133, Zhongyang Rd.,
+				 New Taipei City,    231
+				TW
+
+A8-F0-38   (hex)		SHEN ZHEN SHI JIN HUA TAI ELECTRONICS CO.,LTD
+A8F038     (base 16)		SHEN ZHEN SHI JIN HUA TAI ELECTRONICS CO.,LTD
+				Room A,Forth Floor,Building B,Hengmingzhu Industrial Park,Xixiang Forist and Fruit Bureau,Qianjin Road, Baoan District,Shenzhen city,Guangdong provice
+				    518126
+				CN
+
+AC-C7-3F   (hex)		VITSMO CO., LTD.
+ACC73F     (base 16)		VITSMO CO., LTD.
+				RM1418-1419, HansinIntervalley 24 Bldg.
+				  SEOUL  135-918
+				KR
+
+44-35-6F   (hex)		Neterix
+44356F     (base 16)		Neterix
+				The Printworks
+				Chester  Cheshire  CH1 4RN
+				GB
+
+74-E2-77   (hex)		Vizmonet Pte Ltd
+74E277     (base 16)		Vizmonet Pte Ltd
+				32,Canberra drive,#05-28
+				    76431
+				SG
+
+14-89-3E   (hex)		VIXTEL TECHNOLOGIES LIMTED
+14893E     (base 16)		VIXTEL TECHNOLOGIES LIMTED
+				ROOM 1409, 14/F, BLOCK B, KAILEY CENTER
+				CHAI WAN    
+				HK
+
+BC-54-F9   (hex)		Drogoo Technology Co., Ltd.
+BC54F9     (base 16)		Drogoo Technology Co., Ltd.
+				Shenzhen Dayun software town 17 2 floor
+				Shenzhen  Guangdong  518172
+				CN
+
+78-FC-14   (hex)		Family Zone Cyber Safety Ltd 
+78FC14     (base 16)		Family Zone Cyber Safety Ltd 
+				175 Heytesbury Rd
+				Subiaco  WA  6008
+				AU
+
+38-09-A4   (hex)		Firefly Integrations
+3809A4     (base 16)		Firefly Integrations
+				1013 Elroy Dr
+				Middlebury  IN  46540
+				US
+
+BC-E7-67   (hex)		Quanzhou  TDX Electronics Co., Ltd
+BCE767     (base 16)		Quanzhou  TDX Electronics Co., Ltd
+				Hi-tech Park economic and tech development zone
+				Quanzhou  Fujian province  362005
+				CN
+
+FC-AF-AC   (hex)		Socionext Inc.
+FCAFAC     (base 16)		Socionext Inc.
+				19 Nishikujo-Kasuga-cho
+				Minaki-ku  Kyoto  601-8413
+				JP
+
+BC-4D-FB   (hex)		Hitron Technologies. Inc
+BC4DFB     (base 16)		Hitron Technologies. Inc
+				No. 1-8, Lising 1st Rd. Hsinchu Science Park, Hsinchu, 300, Taiwan, R.O.C
+				Hsin-chu  Taiwan  300
+				TW
+
+2C-33-7A   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+2C337A     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+84-DD-B7   (hex)		Cilag GmbH International
+84DDB7     (base 16)		Cilag GmbH International
+				Gubelstrasse 34
+				Zug  _  CH-6300
+				CH
+
+08-EF-AB   (hex)		SAYME WIRELESS SENSOR NETWORK
+08EFAB     (base 16)		SAYME WIRELESS SENSOR NETWORK
+				Calle Albert Einstein 18, 4a
+				Santander  Cantabria  39011
+				ES
+
+70-76-FF   (hex)		KERLINK
+7076FF     (base 16)		KERLINK
+				1 rue Jacqueline AURIOL
+				THORIGNE FOUILLARD    35235
+				FR
+
+14-36-C6   (hex)		Lenovo Mobile Communication Technology Ltd.
+1436C6     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information & Optoelectronics Park,
+				Xiamen  Fujian  361006
+				
+
+68-F7-28   (hex)		LCFC(HeFei) Electronics Technology co., ltd
+68F728     (base 16)		LCFC(HeFei) Electronics Technology co., ltd
+				YunGu Road 3188-1
+				Hefei  Anhui  230000
+				CN
+
+38-2C-4A   (hex)		ASUSTek COMPUTER INC.
+382C4A     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+30-73-50   (hex)		Inpeco SA
+307350     (base 16)		Inpeco SA
+				Via San Gottardo 10
+				Lugano  Ticino  6900
+				CH
+
+DC-EC-06   (hex)		Heimi Network Technology Co., Ltd.
+DCEC06     (base 16)		Heimi Network Technology Co., Ltd.
+				Room 12B12, Block A2, Long-Term World Building,
+				Beijing  Beijing  100080
+				CN
+
+CC-BD-D3   (hex)		Ultimaker B.V.
+CCBDD3     (base 16)		Ultimaker B.V.
+				Burgemeester Rozeveld van de Venlaan 11
+				Geldermalsen  Gelderland  4191 PL
+				NL
+
+8C-E7-8C   (hex)		DK Networks
+8CE78C     (base 16)		DK Networks
+				20F-3, No.689, Zhong-Zheng Road, Zhong-He Dist.
+				New Taipei City  Taiwan  235
+				TW
+
+54-51-46   (hex)		AMG Systems Ltd.
+545146     (base 16)		AMG Systems Ltd.
+				3 The Omega Centre
+				Biggleswade  Bedfordshire  SG18 8QB
+				GB
+
+84-63-D6   (hex)		Microsoft Corporation
+8463D6     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+EC-13-B2   (hex)		Netonix
+EC13B2     (base 16)		Netonix
+				6 East Main St
+				Leola  PA  17540
+				US
+
+10-4E-07   (hex)		Shanghai Genvision Industries Co.,Ltd
+104E07     (base 16)		Shanghai Genvision Industries Co.,Ltd
+				2/F Building E,NO.55,Luo Jin Road,MinHang District,Shanghai
+				Shanghai  Shanghai  200237
+				CN
+
+04-9B-9C   (hex)		Eadingcore  Intelligent Technology Co., Ltd.
+049B9C     (base 16)		Eadingcore  Intelligent Technology Co., Ltd.
+				No. 169 Lijia city C District comprehensive 3 layer C3-10 mall，Five-One road
+				Fuzhou  Fujian  350000
+				CN
+
+84-26-90   (hex)		BEIJING THOUGHT SCIENCE CO.,LTD.
+842690     (base 16)		BEIJING THOUGHT SCIENCE CO.,LTD.
+				1-1102,Intermational Business Park,No.1 ShangDi Xinxi Rd,Haidian District,Beijing
+				beijing  beijing  100085
+				CN
+
+80-19-67   (hex)		Shanghai Reallytek Information Technology  Co.,Ltd
+801967     (base 16)		Shanghai Reallytek Information Technology  Co.,Ltd
+				906 Room,No.1 Building,No.3000 Longdong Avenue
+				  Shanghai  201203
+				CN
+
+2C-F7-F1   (hex)		Seeed Technology Inc.
+2CF7F1     (base 16)		Seeed Technology Inc.
+				 5th Floor, 8th Building, Shiling industrial Park, XiLi Town, NanShan dist. Shenzhen
+				ShenZhen  GuangDong  518055
+				CN
+
+3C-1E-13   (hex)		HANGZHOU SUNRISE TECHNOLOGY CO., LTD
+3C1E13     (base 16)		HANGZHOU SUNRISE TECHNOLOGY CO., LTD
+				No.9, LongTan Road, CangQian Town, YuHang District, Hangzhou, China
+				HangZhou  ZheJiang  311121
+				CN
+
+08-11-5E   (hex)		Bitel Co., Ltd.
+08115E     (base 16)		Bitel Co., Ltd.
+				9F Yohyun B/D, 242-29, Nonhyun-dong
+				Seoul  Gangnam-gu  135830
+				KR
+
+08-81-BC   (hex)		HongKong Ipro Technology Co., Limited
+0881BC     (base 16)		HongKong Ipro Technology Co., Limited
+				Flat/Rm A3 9/F Silvercorp Int Tower
+				  HONGKONG  999077
+				HK
+
+C0-98-79   (hex)		Acer Inc.
+C09879     (base 16)		Acer Inc.
+				8F, 88, Sec.1, Xintai 5th Rd.
+				New Taipei City  N/A  221
+				TW
+
+B8-4F-D5   (hex)		Microsoft Corporation
+B84FD5     (base 16)		Microsoft Corporation
+				1 Microsoft Way
+				Redmond  Washington  98052
+				FI
+
+D8-4A-87   (hex)		OI ELECTRIC CO.,LTD
+D84A87     (base 16)		OI ELECTRIC CO.,LTD
+				7-3-16 KIKUNA
+				YOKOHAMA  KANAGAWA-KEN  222-0011
+				JP
+
+F0-3D-29   (hex)		Actility
+F03D29     (base 16)		Actility
+				110 rue des Poissonniers
+				Paris  Paris  75018
+				FR
+
+88-70-8C   (hex)		Lenovo Mobile Communication Technology Ltd.
+88708C     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information & Optoelectronics Park,
+				Xiamen  Fujian  361006
+				
+
+50-14-B5   (hex)		Richfit Information Technology Co., Ltd
+5014B5     (base 16)		Richfit Information Technology Co., Ltd
+				Room 1501, Gehua Tower, Suite N0.1, Qinglong lane, Dongcheng District
+				Beijing  Beijing  100007
+				CN
+
+CC-3F-1D   (hex)		Intesis Software SL
+CC3F1D     (base 16)		Intesis Software SL
+				Mila i Fontanals 1bis 1
+				Igualada  Barcelona  08700
+				ES
+
+DC-DA-4F   (hex)		GETCK TECHNOLOGY,  INC
+DCDA4F     (base 16)		GETCK TECHNOLOGY,  INC
+				Room 508, NO .48 ZhengYi road
+				  SHANGHAI  200082
+				CN
+
+10-12-18   (hex)		Korins Inc.
+101218     (base 16)		Korins Inc.
+				Rm. 608, Suntechcity Bldg.
+				Seongnam  Gyeonggi  462-725
+				KR
+
+34-28-F0   (hex)		ATN International Limited
+3428F0     (base 16)		ATN International Limited
+				4210, Office Tower, Convention Plaza
+				Hong Kong  Hong Kong  00000
+				HK
+
+CC-10-A3   (hex)		Beijing Nan Bao Technology Co., Ltd.
+CC10A3     (base 16)		Beijing Nan Bao Technology Co., Ltd.
+				Room 8476，Floor 8,Building 3
+				Shijingshan District  Beijing  100041
+				CN
+
+5C-AA-FD   (hex)		Sonos, Inc.
+5CAAFD     (base 16)		Sonos, Inc.
+				614 Chapala St
+				Santa Barbara  CA  93101
+				US
+
+14-ED-E4   (hex)		Kaiam Corporation
+14EDE4     (base 16)		Kaiam Corporation
+				39677 Eureka Drive
+				Newark  California  94560
+				US
+
+D0-12-42   (hex)		BIOS Corporation
+D01242     (base 16)		BIOS Corporation
+				2-43-15 Tomigaya
+				Shibuya-ku  TOKYO  151-0063
+				JP
+
+60-36-96   (hex)		The Sapling Company
+603696     (base 16)		The Sapling Company
+				1633 Republic Rd
+				Huntingdon Valley  PA  19006
+				US
+
+54-FF-CF   (hex)		Mopria Alliance
+54FFCF     (base 16)		Mopria Alliance
+				2400 Camino Ramon, Ste #375
+				San Ramon  CA  94583
+				US
+
+F4-F2-6D   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+F4F26D     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+40-4E-EB   (hex)		Higher Way Electronic Co., Ltd.
+404EEB     (base 16)		Higher Way Electronic Co., Ltd.
+				No.15 Jingke E. Rd., Nantun District
+				  Taichung  408
+				TW
+
+C4-56-FE   (hex)		Lava International Ltd.
+C456FE     (base 16)		Lava International Ltd.
+				Room 705, Block A, HengYue Building
+				  Shanghai  518054
+				CN
+
+AC-B7-4F   (hex)		METEL s.r.o.
+ACB74F     (base 16)		METEL s.r.o.
+				Zizkuv Kopec 617
+				Ceska Skalice  NA  55203
+				CZ
+
+C0-EE-FB   (hex)		OnePlus Tech (Shenzhen) Ltd
+C0EEFB     (base 16)		OnePlus Tech (Shenzhen) Ltd
+				18F Tairan Building C, Tairan 8th Road  Chegongmiao, Futian
+				Shenzhen  Guangdong  518040
+				CN
+
+30-42-25   (hex)		BURG-WÄCHTER KG
+304225     (base 16)		BURG-WÄCHTER KG
+				Altenhofer Weg 15
+				Wetter  NRW  58300
+				DE
+
+FC-DB-B3   (hex)		Murata Manufacturing Co., Ltd.
+FCDBB3     (base 16)		Murata Manufacturing Co., Ltd.
+				1-10-1, Higashikotari
+				Nagaokakyo-shi  Kyoto  617-8555
+				JP
+
+CC-F5-38   (hex)		3isysnetworks
+CCF538     (base 16)		3isysnetworks
+				11F-2 No1247 , Jung Jeng RD ,
+				Taipei  Taiwan  0000
+				TW
+
+B8-BD-79   (hex)		TrendPoint Systems
+B8BD79     (base 16)		TrendPoint Systems
+				1595 East 6th Street
+				Corona  CA  92879
+				US
+
+74-F4-13   (hex)		Maxwell Forest
+74F413     (base 16)		Maxwell Forest
+				Level 2, 51 Murray Street
+				Pyrmont  NSW  2009
+				AU
+
+A0-06-27   (hex)		NEXPA System
+A00627     (base 16)		NEXPA System
+				#105, YBS bldg,227-1 Yongdap-Dong
+				  Seoul  ASI/KR/KS013/SEOUL
+				KR
+
+30-33-35   (hex)		Boosty
+303335     (base 16)		Boosty
+				40 Princes Street
+				Ipswich  Suffolk  IP11RJ
+				GB
+
+44-74-6C   (hex)		Sony Mobile Communications Inc
+44746C     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+4C-9E-FF   (hex)		Zyxel Communications Corporation
+4C9EFF     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+BC-9C-C5   (hex)		Beijing Huafei Technology Co., Ltd.
+BC9CC5     (base 16)		Beijing Huafei Technology Co., Ltd.
+				2 floor, Research building, Guanghua Pioneer Park, No.18, Anningzhuang East Rd, Haidian District, Beijing, China.
+				Beijing  Beijing  100085
+				CN
+
+5C-B8-CB   (hex)		Allis Communications
+5CB8CB     (base 16)		Allis Communications
+				10F.-3,No.31-1, Lane 169 Kangning St.,
+				New Taipei City  New Taipei City  221
+				TW
+
+34-F0-CA   (hex)		Shenzhen Linghangyuan Digital Technology Co.,Ltd.
+34F0CA     (base 16)		Shenzhen Linghangyuan Digital Technology Co.,Ltd.
+				Building R, Linghangyuan Industrial Park, No. 163 Banxuegang Road, Longgang Distrial, Shenzhen, China
+				Shenzhen  Guangdong  518129
+				CN
+
+70-72-0D   (hex)		Lenovo Mobile Communication Technology Ltd.
+70720D     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999, Qishan North 2nd Road, Information & Optoelectronics Park, Torch Hi-tech Industry Development Zone, Xiamen, P.R.China
+				Xiamen  Fujian  361000
+				CN
+
+3C-CD-5A   (hex)		Technische Alternative GmbH
+3CCD5A     (base 16)		Technische Alternative GmbH
+				Langestr. 124
+				Amaliendorf  Lower Austria  A-3872
+				AT
+
+FC-AA-14   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+FCAA14     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				Pin-Jen City, Taoyuan, Taiwan, R.O.C.
+				Pin-Jen  Taoyuan  324
+				TW
+
+94-D6-0E   (hex)		shenzhen yunmao information technologies co., ltd
+94D60E     (base 16)		shenzhen yunmao information technologies co., ltd
+				H4-3A, Twelve Oaks Manor, bulong road
+				shenzhen  guanggong  518127
+				CN
+
+74-8F-4D   (hex)		MEN Mikro Elektronik GmbH
+748F4D     (base 16)		MEN Mikro Elektronik GmbH
+				Neuwieder Str. 3 - 7
+				Nuernberg  Bavaria  90411
+				DE
+
+50-67-87   (hex)		Planet Networks
+506787     (base 16)		Planet Networks
+				1 Ivy Crest Ln
+				Rockaway  NJ  07866
+				US
+
+8C-BF-9D   (hex)		Shanghai Xinyou Information Technology Ltd. Co.
+8CBF9D     (base 16)		Shanghai Xinyou Information Technology Ltd. Co.
+				905，418 Guiqing Road, Xuhui District,
+				Shanghai  Shanghai  200233
+				CN
+
+9C-AD-97   (hex)		Hon Hai Precision Ind. Co.,Ltd.
+9CAD97     (base 16)		Hon Hai Precision Ind. Co.,Ltd.
+				Building D21,No.1, East Zone 1st Road
+				Chongqing  Chongqing  401332
+				CN
+
+88-29-50   (hex)		Netmoon Technology Co., Ltd
+882950     (base 16)		Netmoon Technology Co., Ltd
+				2nd Floor, Building No.1, NO.319, Qingpi Avenue
+				Wenjiang District  Chengdu  611130
+				CN
+
+7C-E5-24   (hex)		Quirky, Inc.
+7CE524     (base 16)		Quirky, Inc.
+				606 W 28th Street
+				New York  NY  10001
+				US
+
+F4-D2-61   (hex)		SEMOCON Co., Ltd
+F4D261     (base 16)		SEMOCON Co., Ltd
+				B-19F, Gunpo IT Valley, Dangjeong-dong, 17, Gosan-ro 148beon-gil,
+				Gunpo-si  Gyeonggi-do  435-833
+				KR
+
+48-D8-55   (hex)		Telvent
+48D855     (base 16)		Telvent
+				P.I. Alcobendas c/ Valgrande. 6
+				Alcobendas  Madrid  28108
+				ES
+
+08-F7-28   (hex)		GLOBO Multimedia Sp. z o.o. Sp.k.
+08F728     (base 16)		GLOBO Multimedia Sp. z o.o. Sp.k.
+				Gryfinska 104
+				Szczecin  Zachodniopomorskie  70-772
+				PL
+
+20-6E-9C   (hex)		Samsung Electronics Co.,Ltd
+206E9C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+6C-2F-2C   (hex)		Samsung Electronics Co.,Ltd
+6C2F2C     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+B0-09-D3   (hex)		Avizia
+B009D3     (base 16)		Avizia
+				12018 Sunrise Valley Drive
+				Reston  VA  20191
+				US
+
+60-C1-CB   (hex)		Fujian Great Power PLC Equipment Co.,Ltd
+60C1CB     (base 16)		Fujian Great Power PLC Equipment Co.,Ltd
+				6/F.Bld.34.Zone C.Software Park
+				Fuzhou  Fujian,China  350003
+				CN
+
+BC-25-F0   (hex)		3D Display Technologies Co., Ltd.
+BC25F0     (base 16)		3D Display Technologies Co., Ltd.
+				4F., No.542-17, Zhongzheng Rd
+				New Taipei City    242
+				TW
+
+C0-3D-46   (hex)		Shanghai Sango Network Technology Co.,Ltd
+C03D46     (base 16)		Shanghai Sango Network Technology Co.,Ltd
+				No 666 Zhangheng Road
+				Pudong  Shanghai  210203
+				CN
+
+64-EA-C5   (hex)		SiboTech Automation Co., Ltd.
+64EAC5     (base 16)		SiboTech Automation Co., Ltd.
+				5th Floor, Bld 3
+				Shanghai  Shanghai  201612
+				CN
+
+30-F7-D7   (hex)		Thread Technology Co., Ltd
+30F7D7     (base 16)		Thread Technology Co., Ltd
+				4F, A Block, CYG, No.2,Mid GaoXin
+				Shenzhen  GuangDong  518055
+				CN
+
+18-22-7E   (hex)		Samsung Electronics Co.,Ltd
+18227E     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+30-C7-AE   (hex)		Samsung Electronics Co.,Ltd
+30C7AE     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-D4-E0   (hex)		Sony Mobile Communications Inc
+44D4E0     (base 16)		Sony Mobile Communications Inc
+				4-12-3 Higashi – Shinagawa
+				Shinagawa-ku  Tokyo  140-0002
+				JP
+
+FC-D5-D9   (hex)		Shenzhen SDMC Technology Co., Ltd.
+FCD5D9     (base 16)		Shenzhen SDMC Technology Co., Ltd.
+				7/F,Block A,Huahan Bldg.,
+				Shenzhen  GuangDong  518000
+				CN
+
+74-DA-38   (hex)		Edimax Technology Co. Ltd.
+74DA38     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+E4-F4-C6   (hex)		NETGEAR
+E4F4C6     (base 16)		NETGEAR
+				350 East Plumeria Drive
+				San Jose  CA  95134
+				US
+
+CC-A0-E5   (hex)		DZG Metering GmbH
+CCA0E5     (base 16)		DZG Metering GmbH
+				Heidelberger Str. 32
+				Oranienburg  Brandenburg  16515
+				DE
+
+60-81-2B   (hex)		Custom Control Concepts
+60812B     (base 16)		Custom Control Concepts
+				6020 S 190th ST
+				Kent  Washington  98032
+				US
+
+1C-1C-FD   (hex)		Dalian Hi-Think Computer Technology, Corp
+1C1CFD     (base 16)		Dalian Hi-Think Computer Technology, Corp
+				Hi-Think Software Building,No.6 Hi-Tech Street, Qixianling Industrial Base, Hi-Tech Zone, Dalian, China
+				Dalian  LiaoNing  116023
+				CN
+
+90-AE-1B   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+90AE1B     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+60-E3-27   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+60E327     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+48-D1-8E   (hex)		Metis Communication Co.,Ltd
+48D18E     (base 16)		Metis Communication Co.,Ltd
+				#102-805 Digital Empire2
+				Suwon-Si  GyeongGi-Do  443-734
+				KR
+
+F8-66-01   (hex)		Suzhou Chi-tek information technology Co., Ltd
+F86601     (base 16)		Suzhou Chi-tek information technology Co., Ltd
+				Rm204C、204D, Building A7,
+				 SuZhou  Jiangsu  215123
+				CN
+
+14-56-45   (hex)		Savitech Corp.
+145645     (base 16)		Savitech Corp.
+				3F, No.309, Guangming 1st Rd.,
+				Zhubei  Hsinchu  30259
+				TW
+
+70-62-B8   (hex)		D-Link International
+7062B8     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+AC-A9-19   (hex)		TrekStor GmbH
+ACA919     (base 16)		TrekStor GmbH
+				Kastanienallee 8-10
+				Lorsch  Hessen  64653
+				DE
+
+B0-25-AA   (hex)		Private
+B025AA     (base 16)		Private
+
+D4-B4-3E   (hex)		Messcomp Datentechnik GmbH
+D4B43E     (base 16)		Messcomp Datentechnik GmbH
+				Neudecker Str. 11
+				Wasserburg  Bayern  83512
+				DE
+
+94-C0-14   (hex)		Sorter Sp. j. Konrad Grzeszczyk MichaA, Ziomek
+94C014     (base 16)		Sorter Sp. j. Konrad Grzeszczyk MichaA, Ziomek
+				ul. Gdynska 32
+				PL9482565081  Mazowieckie  26-600
+				PL
+
+9C-FB-F1   (hex)		MESOMATIC GmbH & Co.KG
+9CFBF1     (base 16)		MESOMATIC GmbH & Co.KG
+				Siemensstr. 36
+				Kernen i.R.    71394
+				DE
+
+10-27-BE   (hex)		TVIP
+1027BE     (base 16)		TVIP
+				190000 ul. Decabristov, h.6 А, of.10-Н
+				  Saint-Petersburg  197227
+				RU
+
+20-87-AC   (hex)		AES motomation
+2087AC     (base 16)		AES motomation
+				48501 Warm Springs Blvd.
+				Fremont  CA  94539
+				US
+
+70-93-83   (hex)		Intelligent Optical Network High Tech CO.,LTD.
+709383     (base 16)		Intelligent Optical Network High Tech CO.,LTD.
+				Room 205,Building 11,Jia
+				Changping District  Beijing  102200
+				CN
+
+80-D4-33   (hex)		LzLabs GmbH
+80D433     (base 16)		LzLabs GmbH
+				Alte Winterthurerstrasse 14B
+				Wallisellen  Zurich  8304
+				CH
+
+B0-DA-00   (hex)		CERA ELECTRONIQUE
+B0DA00     (base 16)		CERA ELECTRONIQUE
+				PARC D&#39;ACTIVITES
+				VAL DE REUIL  HAUTE NORMANDIE  27100
+				FR
+
+1C-AB-01   (hex)		Innovolt
+1CAB01     (base 16)		Innovolt
+				14 Piedmont Center
+				Atlanta  GA  30305
+				US
+
+D8-B6-D6   (hex)		Blu Tether Limited
+D8B6D6     (base 16)		Blu Tether Limited
+				7600 Leesburg Pike
+				Falls Church  VA  22043
+				US
+
+6C-2C-06   (hex)		OOO NPP Systemotechnika-NN
+6C2C06     (base 16)		OOO NPP Systemotechnika-NN
+				Nartova lane, 2v
+				Nizhny Novgorod  Nizhegorodskaya oblast  603057
+				RU
+
+C4-91-3A   (hex)		Shenzhen Sanland Electronic Co., ltd.
+C4913A     (base 16)		Shenzhen Sanland Electronic Co., ltd.
+				3 floor,Block D, Glory Technology Industrial Park,
+				ShenZhen  Guangdong  518116
+				CN
+
+68-85-6A   (hex)		OuterLink Corporation
+68856A     (base 16)		OuterLink Corporation
+				187 Ballardvale St., Ste. A260
+				Wilmington  MA  01887
+				US
+
+94-51-BF   (hex)		Hyundai ESG
+9451BF     (base 16)		Hyundai ESG
+				Gangnam-gu
+				Seoul  KOREA, REPUBLIC OF  135-845
+				KR
+
+F0-15-A0   (hex)		KyungDong One Co., Ltd.
+F015A0     (base 16)		KyungDong One Co., Ltd.
+				205-38, Gasan digital 1-ro,
+				  Seoul  153-803
+				KR
+
+C4-4E-1F   (hex)		BlueN
+C44E1F     (base 16)		BlueN
+				121-122 3F
+				Daegu  Korea  700-809
+				KR
+
+B0-86-9E   (hex)		Chloride S.r.L
+B0869E     (base 16)		Chloride S.r.L
+				Via Fornace ,30
+				CastelGuelfo (Bologna)  Italy  40023
+				IT
+
+D0-57-A1   (hex)		Werma Signaltechnik GmbH & Co. KG
+D057A1     (base 16)		Werma Signaltechnik GmbH & Co. KG
+				Duerbheimer Strasse
+				Rietheim-Weilheim    78604
+				DE
+
+B4-B5-42   (hex)		Hubbell Power Systems, Inc.
+B4B542     (base 16)		Hubbell Power Systems, Inc.
+				8100 Churchill Ave
+				Leeds  AL  35094
+				US
+
+54-CD-EE   (hex)		ShenZhen Apexis Electronic Co.,Ltd
+54CDEE     (base 16)		ShenZhen Apexis Electronic Co.,Ltd
+				12th floor,Keji BuildiHigng
+				 ShenZhen   GuangDong   518057
+				CN
+
+88-E8-F8   (hex)		YONG TAI ELECTRONIC (DONGGUAN) LTD.
+88E8F8     (base 16)		YONG TAI ELECTRONIC (DONGGUAN) LTD.
+				Yuan Shan Bei Managed Region
+				Dong Guan  Guang Dong  523583
+				CN
+
+90-98-64   (hex)		Impex-Sat GmbH&amp;Co KG
+909864     (base 16)		Impex-Sat GmbH&amp;Co KG
+				Beim Giesshaus 7
+				Glueckstadt    25348
+				DE
+
+DC-E5-78   (hex)		Experimental Factory of Scientific Engineering and Special Design Department
+DCE578     (base 16)		Experimental Factory of Scientific Engineering and Special Design Department
+				9, Academician Semenov prospect
+				Chernogolovka  Moscow region  142432
+				RU
+
+D8-65-95   (hex)		Toy's Myth Inc.
+D86595     (base 16)		Toy's Myth Inc.
+				304, Yongsan-gu Changup-Jiwon center
+				  Seoul  140-240
+				KR
+
+F4-B5-2F   (hex)		Juniper Networks
+F4B52F     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C0-F7-9D   (hex)		Powercode
+C0F79D     (base 16)		Powercode
+				300 Industrial Dr
+				Random Lake  Wisconsin  53075
+				US
+
+C4-C9-19   (hex)		Energy Imports Ltd
+C4C919     (base 16)		Energy Imports Ltd
+				306a Broadway Ave
+				Palmerston North  Manawatu  4414
+				NZ
+
+38-F0-98   (hex)		Vapor Stone Rail Systems
+38F098     (base 16)		Vapor Stone Rail Systems
+				10000 Cavendish
+				Saint-Laurent  Quebec  H4M2V1
+				CA
+
+64-E8-92   (hex)		Morio Denki Co., Ltd.
+64E892     (base 16)		Morio Denki Co., Ltd.
+				2, Nadooka
+				Ryugasaki  Ibaraki  301-0845
+				JP
+
+D8-DD-5F   (hex)		BALMUDA Inc.
+D8DD5F     (base 16)		BALMUDA Inc.
+				5-1-21 Kyonancho
+				Musashino  Tokyo  180-0023
+				JP
+
+D8-61-94   (hex)		Objetivos y Sevicios de Valor Añadido
+D86194     (base 16)		Objetivos y Sevicios de Valor Añadido
+				Calle Monte Esquinza 28, 1ºD
+				Madrid    28010
+				ES
+
+E8-FC-60   (hex)		ELCOM Innovations Private Limited
+E8FC60     (base 16)		ELCOM Innovations Private Limited
+				9TH FLOOR, MERIDIEN COMMERCIAL TOWER
+				New Delhi    110001
+				US
+
+58-9C-FC   (hex)		FreeBSD Foundation
+589CFC     (base 16)		FreeBSD Foundation
+				P.O. Box 20247
+				Boulder  CO   80308-3247
+				US
+
+70-2C-1F   (hex)		Wisol
+702C1F     (base 16)		Wisol
+				377-3, Gajang-dong, Osan-si
+				    447-210
+				KR
+
+C8-D4-29   (hex)		Muehlbauer AG
+C8D429     (base 16)		Muehlbauer AG
+				Josef-Mühlbauer-Platz 1
+				Roding  Bavaria  93426
+				DE
+
+F8-5C-45   (hex)		IC Nexus Co. Ltd.
+F85C45     (base 16)		IC Nexus Co. Ltd.
+				6F-1, No.3-2 Park Street
+				Taipei    115
+				TW
+
+AC-E0-69   (hex)		ISAAC Instruments
+ACE069     (base 16)		ISAAC Instruments
+				240 Frechette
+				Chambly  Quebec  J3L2Z5
+				CA
+
+30-B5-C2   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+30B5C2     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+E0-7F-53   (hex)		TECHBOARD SRL
+E07F53     (base 16)		TECHBOARD SRL
+				Via Della Scienza, 50
+				Modena    41122
+				IT
+
+48-FE-EA   (hex)		HOMA B.V.
+48FEEA     (base 16)		HOMA B.V.
+				P.O. Box 545
+				Enschede    7500 AM
+				NL
+
+E8-EA-6A   (hex)		StarTech.com
+E8EA6A     (base 16)		StarTech.com
+				45 Artisans Cres
+				London  Ontario  N5V5E9
+				CA
+
+04-DB-8A   (hex)		Suntech International Ltd.
+04DB8A     (base 16)		Suntech International Ltd.
+				Room 605, IT Mirae Tower
+				  Seoul  153-760
+				KR
+
+90-DF-B7   (hex)		s.m.s smart microwave sensors GmbH
+90DFB7     (base 16)		s.m.s smart microwave sensors GmbH
+				In den Waashainen 1
+				Braunschweig  NI  38108
+				DE
+
+08-57-00   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+085700     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+FC-27-A2   (hex)		TRANS ELECTRIC CO., LTD.
+FC27A2     (base 16)		TRANS ELECTRIC CO., LTD.
+				771,Sec.2 Chungsan Rd,Huatang
+				Changhua  Taiwan  503
+				TW
+
+FC-BB-A1   (hex)		Shenzhen Minicreate Technology Co.,Ltd
+FCBBA1     (base 16)		Shenzhen Minicreate Technology Co.,Ltd
+				5/F.,5th,Building,Animation Park,Yuehai Road
+				Shenzhen  Guangdong  518066
+				CN
+
+F0-8A-28   (hex)		JIANGSU HENGSION ELECTRONIC S and T CO.,LTD
+F08A28     (base 16)		JIANGSU HENGSION ELECTRONIC S and T CO.,LTD
+				4F,Building 3
+				ChangZhou  Jiangsu  213125
+				CN
+
+28-BB-59   (hex)		RNET Technologies, Inc.
+28BB59     (base 16)		RNET Technologies, Inc.
+				240. W. Elmwood Dr.
+				Dayton  OHIO  45459-4248
+				US
+
+24-26-42   (hex)		SHARP Corporation.
+242642     (base 16)		SHARP Corporation.
+				22-22,Abeno-ku
+				Osaka-City  Osaka-Prefecture  545-8522
+				JP
+
+34-DE-34   (hex)		zte corporation
+34DE34     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+FC-16-07   (hex)		Taian Technology(Wuxi) Co.,Ltd.
+FC1607     (base 16)		Taian Technology(Wuxi) Co.,Ltd.
+				Gaolang East Road No.29
+				Wuxi  Jiangsu  214000
+				CN
+
+AC-02-CA   (hex)		HI Solutions, Inc.
+AC02CA     (base 16)		HI Solutions, Inc.
+				4105 Royal Drive
+				Kennesaw  GA  30144
+				US
+
+74-6F-3D   (hex)		Contec GmbH
+746F3D     (base 16)		Contec GmbH
+				Oberahrer Straße 9
+				Sainerholz  RP  56244
+				DE
+
+4C-0D-EE   (hex)		JABIL CIRCUIT (SHANGHAI) LTD.
+4C0DEE     (base 16)		JABIL CIRCUIT (SHANGHAI) LTD.
+				FL5-UNIT A2 NO 1528 GUMEI ROAD
+				  SHANGHAI  200233
+				CN
+
+D0-63-4D   (hex)		Meiko Maschinenbau GmbH &amp; Co. KG
+D0634D     (base 16)		Meiko Maschinenbau GmbH &amp; Co. KG
+				Englerstraße 3
+				Offenburg    77652
+				DE
+
+00-8B-43   (hex)		RFTECH
+008B43     (base 16)		RFTECH
+				Cheoin-gu
+				Yongin  Gyeonggi  449-871
+				KR
+
+8C-41-F2   (hex)		RDA Technologies Ltd.
+8C41F2     (base 16)		RDA Technologies Ltd.
+				Suite 2203, CC Wu Building,
+				WanChai  Hong Kong  00000
+				HK
+
+E0-36-E3   (hex)		Stage One International Co., Ltd.
+E036E3     (base 16)		Stage One International Co., Ltd.
+				Fl. 5., No. 10., Lane 321, Yangguang St.,
+				Taipei City    11491
+				TW
+
+DC-05-2F   (hex)		National Products Inc.
+DC052F     (base 16)		National Products Inc.
+				8410 Dallas Ave S.
+				Seattle  WA  98108
+				US
+
+D0-BD-01   (hex)		DS International
+D0BD01     (base 16)		DS International
+				806ho, ACE HITECH21 B/D
+				Busan  Busan  612-020
+				KR
+
+8C-DE-99   (hex)		Comlab Inc.
+8CDE99     (base 16)		Comlab Inc.
+				2300 Leon-Harmel, suite 220
+				Quebec  Quebec  G1N 4L2
+				CA
+
+4C-E1-BB   (hex)		Zhuhai HiFocus Technology Co., Ltd.
+4CE1BB     (base 16)		Zhuhai HiFocus Technology Co., Ltd.
+				The second floor of the friend industrial park,
+				zhuhai  guangdong  519080
+				US
+
+24-A8-7D   (hex)		Panasonic Automotive Systems Asia Pacific(Thailand)Co.,Ltd.
+24A87D     (base 16)		Panasonic Automotive Systems Asia Pacific(Thailand)Co.,Ltd.
+				101 Moo 2 Teparak Road ,
+				Bangsaothong  Samutprakarn  10540
+				TH
+
+EC-71-DB   (hex)		Shenzhen Baichuan Digital Technology Co., Ltd.
+EC71DB     (base 16)		Shenzhen Baichuan Digital Technology Co., Ltd.
+				Room 602, Complex Building, Tsinghua High-Tech Park
+				Shenzhen  Guangdong  518000
+				CN
+
+A4-09-CB   (hex)		Alfred Kaercher GmbH &amp; Co KG
+A409CB     (base 16)		Alfred Kaercher GmbH &amp; Co KG
+				Alfred Kaercher Gmbh &amp; Co KG
+				Winnenden  Baden-Wuerttemberg  71364
+				DE
+
+8C-56-9D   (hex)		Imaging Solutions Group
+8C569D     (base 16)		Imaging Solutions Group
+				1387 Fairport Rd
+				Fairport  NY  14450
+				US
+
+40-B6-B1   (hex)		SUNGSAM CO,.Ltd
+40B6B1     (base 16)		SUNGSAM CO,.Ltd
+				SUNGSAM Bldg, 7-1, BAnga-ro 23beon-gil, Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-829
+				KR
+
+84-FE-9E   (hex)		RTC Industries, Inc.
+84FE9E     (base 16)		RTC Industries, Inc.
+				2800 Golf Road
+				Rolling Meadows  IL  60008
+				US
+
+FC-4B-1C   (hex)		INTERSENSOR S.R.L.
+FC4B1C     (base 16)		INTERSENSOR S.R.L.
+				101 Bd. Iuliu Maniu str., Bl. A2, Sc. 2, #47
+				  Bucharest  061094
+				RO
+
+40-30-67   (hex)		Conlog (Pty) Ltd
+403067     (base 16)		Conlog (Pty) Ltd
+				270 Felix Dlamini Road
+				Durban  Kwa-zulu Natal  4000
+				ZA
+
+E8-61-83   (hex)		Black Diamond Advanced Technology, LLC
+E86183     (base 16)		Black Diamond Advanced Technology, LLC
+				7450 S. Priest Drive
+				Tempe  AZ  85283
+				US
+
+38-C9-A9   (hex)		SMART High Reliability Solutions, Inc.
+38C9A9     (base 16)		SMART High Reliability Solutions, Inc.
+				1325 N Fiesta Blvd., #101
+				Gilbert  AZ  85233
+				US
+
+50-1A-C5   (hex)		Microsoft
+501AC5     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+B0-98-9F   (hex)		LG CNS
+B0989F     (base 16)		LG CNS
+				53-94 Jinwisandan-ro, Jinwuy-Myun
+				Pyungtaek-City  Kyunggi-Do  451-862
+				KR
+
+C0-F1-C4   (hex)		Pacidal Corporation Ltd.
+C0F1C4     (base 16)		Pacidal Corporation Ltd.
+				3F., No. 11, Aly 3, Ln. 123, Sec. 3 Ren'ai Rd.
+				Taipei City    106
+				TW
+
+60-03-47   (hex)		Billion Electric Co. Ltd.
+600347     (base 16)		Billion Electric Co. Ltd.
+				8F., No.192, Sec. 2, Zhongxing Rd.,
+				New Taipei City,    231
+				TW
+
+F0-D3-A7   (hex)		CobaltRay Co., Ltd
+F0D3A7     (base 16)		CobaltRay Co., Ltd
+				Room 409,Humanteco Building,#281-16
+				Seoul    133120
+				KR
+
+38-A5-3C   (hex)		COMECER Netherlands
+38A53C     (base 16)		COMECER Netherlands
+				Madame Curieweg 1
+				Joure  Friesland  8500 AC
+				NL
+
+5C-FF-FF   (hex)		Shenzhen Kezhonglong Optoelectronic Technology Co., Ltd
+5CFFFF     (base 16)		Shenzhen Kezhonglong Optoelectronic Technology Co., Ltd
+				3/F, B5 Building, Xinfu Industrial Park, Heping Village
+				Shenzhen, Guangdong 518101    
+				US
+
+08-52-40   (hex)		EbV Elektronikbau- und Vertriebs GmbH
+085240     (base 16)		EbV Elektronikbau- und Vertriebs GmbH
+				Heisterner Weg 8 - 12
+				Burbach  Nordrhein-Westfalen  57299
+				DE
+
+B8-C1-A2   (hex)		Dragon Path Technologies Co., Limited
+B8C1A2     (base 16)		Dragon Path Technologies Co., Limited
+				12/F., San Toi Building,
+				Central  Hong Kong  
+				HK
+
+80-F2-5E   (hex)		Kyynel
+80F25E     (base 16)		Kyynel
+				Pirttikuja 3
+				  Oulu  90450
+				FI
+
+68-69-2E   (hex)		Zycoo Co.,Ltd
+68692E     (base 16)		Zycoo Co.,Ltd
+				F7,B7,Tianfu Software park
+				Chengdu  Sichuan  610000
+				CN
+
+D4-68-67   (hex)		Neoventus Design Group
+D46867     (base 16)		Neoventus Design Group
+				2350 Commonwealth Dr, Suite E
+				Charlottesville  VA  22901
+				US
+
+2C-18-AE   (hex)		Trend Electronics Co., Ltd.
+2C18AE     (base 16)		Trend Electronics Co., Ltd.
+				4F-3, No 17, Lane 77, Sec. 2
+				Taipei  Taiwan  10446
+				TW
+
+F8-1C-E5   (hex)		Telefonbau Behnke GmbH
+F81CE5     (base 16)		Telefonbau Behnke GmbH
+				Robert-Jungk-Str. 3
+				Kirkel  Saarland  66459
+				DE
+
+88-91-66   (hex)		Viewcooper Corp.
+889166     (base 16)		Viewcooper Corp.
+				Room 1061, A,Seven Block, No.128 Huayuan Rd
+				SHANGHAI    200083
+				CN
+
+10-33-78   (hex)		FLECTRON Co., LTD
+103378     (base 16)		FLECTRON Co., LTD
+				A-625, Sigma2, Tancheonsang-ro 164
+				Seongnam-si  Gyeonggi-do  463-741
+				KR
+
+14-ED-A5   (hex)		Wächter GmbH Sicherheitssysteme
+14EDA5     (base 16)		Wächter GmbH Sicherheitssysteme
+				Alte Ricklinger Str. 3
+				Hannover  Garbsen  30823
+				DE
+
+50-C0-06   (hex)		Carmanah Signs
+50C006     (base 16)		Carmanah Signs
+				#5 6025 12 Street SE
+				Calgary  Alberta  T2H2K1
+				CA
+
+04-CB-1D   (hex)		Traka plc
+04CB1D     (base 16)		Traka plc
+				30 Stilebrook Road
+				Bucks  Buckinghamshire  MK46 5EA
+				GB
+
+A4-E9-A3   (hex)		Honest Technology Co., Ltd
+A4E9A3     (base 16)		Honest Technology Co., Ltd
+				5F, KyungDong Bldg. 906-5,
+				  Daejeon  305-330
+				KR
+
+A0-E5-E9   (hex)		enimai Inc
+A0E5E9     (base 16)		enimai Inc
+				701 Villa St
+				Mountain View  California  94041
+				US
+
+9C-21-6A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+9C216A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+F8-62-AA   (hex)		xn systems
+F862AA     (base 16)		xn systems
+				#917, Worldmerdian 2nd
+				  Seoul  153759
+				KR
+
+10-7B-EF   (hex)		Zyxel Communications Corporation
+107BEF     (base 16)		Zyxel Communications Corporation
+				No. 6 Innovation Road II, Science Park
+				Hsichu  Taiwan  300
+				TW
+
+B4-62-AD   (hex)		Elysia Germany GmbH
+B462AD     (base 16)		Elysia Germany GmbH
+				Benzstr.4
+				Straubenhardt  Baden-Wuerttemberg  75334
+				DE
+
+34-5C-40   (hex)		Cargt Holdings LLC
+345C40     (base 16)		Cargt Holdings LLC
+				8820 Hillside Dr
+				Lenexa  KANSAS (KS)  66227
+				US
+
+68-19-3F   (hex)		Digital Airways
+68193F     (base 16)		Digital Airways
+				5, Place Jean SIARD
+				ARGENTAN  NORMANDY  61200
+				FR
+
+B4-75-0E   (hex)		Belkin International Inc.
+B4750E     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  Ca.   90094
+				US
+
+94-10-3E   (hex)		Belkin International Inc.
+94103E     (base 16)		Belkin International Inc.
+				12045 East Waterfront Drive
+				Playa Vista  Ca.   90094
+				US
+
+7C-B7-33   (hex)		ASKEY COMPUTER CORP
+7CB733     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+30-51-F8   (hex)		BYK-Gardner GmbH
+3051F8     (base 16)		BYK-Gardner GmbH
+				Lausitzer Strasse 8
+				Geretsried  Bavarian  82538
+				DE
+
+E8-F2-26   (hex)		MILLSON CUSTOM SOLUTIONS INC.
+E8F226     (base 16)		MILLSON CUSTOM SOLUTIONS INC.
+				2036 COLUMBIA STREET
+				VANCOUVER  BRITISH COLUMBIA  V5Y 3E1
+				CA
+
+44-EE-30   (hex)		Budelmann Elektronik GmbH
+44EE30     (base 16)		Budelmann Elektronik GmbH
+				Von-Renesse-Weg 60
+				Muenster  North Rhine-Westphalia  48163
+				DE
+
+FC-1E-16   (hex)		IPEVO corp
+FC1E16     (base 16)		IPEVO corp
+				3F,No.53,Bo-ai Road,Taipei 100,Taiwan
+				Taipei    10044
+				TW
+
+3C-6E-63   (hex)		Mitron OY
+3C6E63     (base 16)		Mitron OY
+				Yrittäjankaari 19
+				FORSSA  Kanta-Hame  30420
+				FI
+
+A4-05-9E   (hex)		STA Infinity LLP
+A4059E     (base 16)		STA Infinity LLP
+				WINNINGTON HOUSE
+				London    N12 0DR
+				GB
+
+A0-BF-50   (hex)		S.C. ADD-PRODUCTION S.R.L.
+A0BF50     (base 16)		S.C. ADD-PRODUCTION S.R.L.
+				36, Dragomirna str.
+				Chisinau    MD-2008
+				MD
+
+E8-D4-E0   (hex)		Beijing BenyWave Technology Co., Ltd.
+E8D4E0     (base 16)		Beijing BenyWave Technology Co., Ltd.
+				No.55, Jiachuang Road, Taihu Town
+				  Beijing  101111
+				CN
+
+FC-01-9E   (hex)		VIEVU
+FC019E     (base 16)		VIEVU
+				105 W. John St
+				Seattle  WA  98119
+				US
+
+64-21-84   (hex)		Nippon Denki Kagaku Co.,LTD
+642184     (base 16)		Nippon Denki Kagaku Co.,LTD
+				Nishino Gotochou 18
+				Kyoto City  Kyoto Pref  607-8356
+				JP
+
+24-64-EF   (hex)		CYG SUNRI CO.,LTD.
+2464EF     (base 16)		CYG SUNRI CO.,LTD.
+				No. 3, Langshan 1st Road, North Area of Hi-Tech Industrial Park
+				Shenzhen  Guangdong  518057
+				CN
+
+D8-27-0C   (hex)		MaxTronic International Co., Ltd.
+D8270C     (base 16)		MaxTronic International Co., Ltd.
+				4F., No.529, Zhongzheng Rd., Xindian Dist.
+				New Taipei City  Taiwan  231
+				TW
+
+B4-CC-E9   (hex)		PROSYST
+B4CCE9     (base 16)		PROSYST
+				2C Rue de l' EPINOY
+				TEMPLEMARS    59175
+				FR
+
+C4-D6-55   (hex)		Tercel technology co.,ltd
+C4D655     (base 16)		Tercel technology co.,ltd
+				Huafa South Road, Futian District,
+				SHENZHEN  GUANGDONG  518000
+				CN
+
+58-BD-F9   (hex)		Sigrand
+58BDF9     (base 16)		Sigrand
+				UNIT 602 6/F, Causeway Bay Comm Bldg,
+				  Hong Kong  999077
+				HK
+
+C0-C6-87   (hex)		Cisco SPVTG
+C0C687     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+C4-93-80   (hex)		Speedytel technology
+C49380     (base 16)		Speedytel technology
+				ROOM 1103,HANG SENG MONGKOK BUILDING,677 NATHAN ROAD,MONGKOK,KOWLOON
+				HONG KONG  HONG KONG  
+				HK
+
+00-7D-FA   (hex)		Volkswagen Group of America
+007DFA     (base 16)		Volkswagen Group of America
+				3800 Hamlin Rd
+				Auburn Hills  MI  48326
+				US
+
+2C-71-55   (hex)		HiveMotion
+2C7155     (base 16)		HiveMotion
+				1806, STX-V Tower
+				Seoul    153-803
+				KR
+
+20-18-0E   (hex)		Shenzhen Sunchip Technology Co., Ltd
+20180E     (base 16)		Shenzhen Sunchip Technology Co., Ltd
+				Room 818-831, Building B1, Mingyou Purchasing Center, Bao'an District, Shenzhen, China
+				Shenzhen  Guangdong  518101
+				CN
+
+80-B2-19   (hex)		ELEKTRON TECHNOLOGY UK LIMITED
+80B219     (base 16)		ELEKTRON TECHNOLOGY UK LIMITED
+				BROERS BUILDING,
+				CAMBRIDGE  CAMBS  CB3 0FA
+				US
+
+E0-AE-B2   (hex)		Bender GmbH &amp; Co.KG
+E0AEB2     (base 16)		Bender GmbH &amp; Co.KG
+				Londorfer Straße 65
+				Grünberg  Hessen  35305
+				DE
+
+F8-4A-7F   (hex)		Innometriks Inc
+F84A7F     (base 16)		Innometriks Inc
+				3654 Ocean Ranch Blvd
+				Oceanside  Ca  92056
+				US
+
+74-A4-B5   (hex)		Powerleader Science and Technology Co. Ltd.
+74A4B5     (base 16)		Powerleader Science and Technology Co. Ltd.
+				Powerleader Technology Park, #3 Guanyi Rd.
+				Shenzhen  Guangdong  518110
+				CN
+
+90-9F-43   (hex)		Accutron Instruments Inc.
+909F43     (base 16)		Accutron Instruments Inc.
+				11 Mary Street
+				Sudbury  Ontario  P3C1B4
+				CA
+
+28-94-AF   (hex)		Samhwa Telecom
+2894AF     (base 16)		Samhwa Telecom
+				293-7, Doksan-dong
+				Seoul  Seoul  153-813
+				KR
+
+AC-50-36   (hex)		Pi-Coral Inc
+AC5036     (base 16)		Pi-Coral Inc
+				2130 Gold St
+				San Jose  CA  95002-1177
+				US
+
+0C-9B-13   (hex)		Shanghai Magic Mobile Telecommunication Co.Ltd.
+0C9B13     (base 16)		Shanghai Magic Mobile Telecommunication Co.Ltd.
+				 B7 parts, second floor
+				Waigaoqiao Free Trade Zone  Shanghai  200131
+				CN
+
+94-BF-1E   (hex)		eflow Inc. / Smart Device Planning and Development Division
+94BF1E     (base 16)		eflow Inc. / Smart Device Planning and Development Division
+				Ryoka-Yoyogi building 3F
+				Shibuya-Ku  TOKYO  151-0051
+				JP
+
+E8-51-6E   (hex)		TSMART Inc.
+E8516E     (base 16)		TSMART Inc.
+				The-O-valley 306,
+				Anyang-si  Gyeonggi-do  431-080
+				KR
+
+AC-22-0B   (hex)		ASUSTek COMPUTER INC.
+AC220B     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+B8-87-A8   (hex)		Step Ahead Innovations Inc.
+B887A8     (base 16)		Step Ahead Innovations Inc.
+				20 Wintersport Ln.
+				Williston  VT  05495
+				US
+
+E0-A1-98   (hex)		NOJA Power Switchgear Pty Ltd
+E0A198     (base 16)		NOJA Power Switchgear Pty Ltd
+				16 Archimedes Place
+				Murarrie  QLD  4172
+				AU
+
+88-35-4C   (hex)		Transics
+88354C     (base 16)		Transics
+				p/a Ter Waarde 91
+				Ieper    8900
+				BE
+
+3C-61-04   (hex)		Juniper Networks
+3C6104     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+CC-4A-E1   (hex)		fourtec -Fourier Technologies
+CC4AE1     (base 16)		fourtec -Fourier Technologies
+				16 Hamelacha St. POB 11681
+				Rosh Ha’ayin    48091
+				IL
+
+8C-4B-59   (hex)		3D Imaging & Simulations Corp
+8C4B59     (base 16)		3D Imaging & Simulations Corp
+				815, Timnip-Dong, Yuseong-Gu
+				  Daejeon  305510
+				KR
+
+5C-33-27   (hex)		Spazio Italia srl
+5C3327     (base 16)		Spazio Italia srl
+				Via G.Galilei, 50
+				Padenghe sul Garda  BS  25080
+				IT
+
+50-76-91   (hex)		Tekpea, Inc.
+507691     (base 16)		Tekpea, Inc.
+				2225 East Bayshore Road
+				Palo Alto  California  94303
+				US
+
+28-F5-32   (hex)		ADD-Engineering BV
+28F532     (base 16)		ADD-Engineering BV
+				P.O. BOX 5893
+				ROTTERDAM  ZH  3008 AW
+				NL
+
+94-40-A2   (hex)		Anywave Communication Technologies, Inc.
+9440A2     (base 16)		Anywave Communication Technologies, Inc.
+				300 Knightsbridge Parkway, Suite 150
+				Lincolnshire  IL  60069
+				US
+
+1C-86-AD   (hex)		MCT CO., LTD.
+1C86AD     (base 16)		MCT CO., LTD.
+				C-815/816, Garden5 Works, 52 Chungmin-ro
+				Songpa-gu  Seoul  138-961
+				KR
+
+28-D9-3E   (hex)		Telecor Inc.
+28D93E     (base 16)		Telecor Inc.
+				6205 Kestrel Road
+				Mississauga  Ontario  L5T 2A1
+				CA
+
+64-0B-4A   (hex)		Digital Telecom Technology Limited
+640B4A     (base 16)		Digital Telecom Technology Limited
+				1708 Nan Fung Tower,
+				    00852
+				US
+
+38-42-33   (hex)		Wildeboer Bauteile GmbH
+384233     (base 16)		Wildeboer Bauteile GmbH
+				Marker Weg 11
+				Weener  Niedersachsen  26826
+				US
+
+3C-8A-B0   (hex)		Juniper Networks
+3C8AB0     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C0-34-B4   (hex)		Gigastone Corporation
+C034B4     (base 16)		Gigastone Corporation
+				12F.NO 480. Rueiguang Rd.
+				Taipei    11492
+				TW
+
+CC-E8-AC   (hex)		SOYEA Technology Co.,Ltd.
+CCE8AC     (base 16)		SOYEA Technology Co.,Ltd.
+				STB department,Floor 4,Building 11 south
+				hangzhou  zhejiang  310007
+				CN
+
+70-F1-76   (hex)		Data Modul AG
+70F176     (base 16)		Data Modul AG
+				Landsberger Str. 322
+				Munich  Bavaria  80687
+				DE
+
+B8-47-C6   (hex)		SanJet Technology Corp.
+B847C6     (base 16)		SanJet Technology Corp.
+				4F,No2,Li-Hsin Rd., 6,
+				Hsinchu    30078
+				TW
+
+B8-CD-93   (hex)		Penetek, Inc
+B8CD93     (base 16)		Penetek, Inc
+				6F, No.18, Wuqun 7th Rd, Wugu Dist
+				New Taipei City    248
+				TW
+
+28-DB-81   (hex)		Shanghai Guao Electronic Technology Co., Ltd
+28DB81     (base 16)		Shanghai Guao Electronic Technology Co., Ltd
+				No.6, Alley 1225 TongPu Road,
+				  Shanghai  200333
+				CN
+
+38-06-B4   (hex)		A.D.C. GmbH
+3806B4     (base 16)		A.D.C. GmbH
+				Peter-Dornier-Str. 10
+				Lindau    88131
+				DE
+
+B8-24-1A   (hex)		SWEDA INFORMATICA LTDA
+B8241A     (base 16)		SWEDA INFORMATICA LTDA
+				RUA DONA BRIGIDA, 713
+				SAO PAULO  SP  04111-081
+				BR
+
+A0-B1-00   (hex)		ShenZhen Cando Electronics Co.,Ltd
+A0B100     (base 16)		ShenZhen Cando Electronics Co.,Ltd
+				Building A, Dagang Industrial Zone, Changzhen Community
+				Shenzhen City  Guangdong  518132
+				CN
+
+20-1D-03   (hex)		Elatec GmbH
+201D03     (base 16)		Elatec GmbH
+				Lilienthalstr. 3
+				Puchheim  Bayern  82178
+				DE
+
+E0-67-B3   (hex)		Shenzhen C-Data Technology Co., Ltd
+E067B3     (base 16)		Shenzhen C-Data Technology Co., Ltd
+				#601, Fl6, Bldg F, No.1008  Yangguang Community
+				Shenzhen  Guangdong  518055
+				CN
+
+1C-4A-F7   (hex)		AMON INC
+1C4AF7     (base 16)		AMON INC
+				HANJUN BLDG 4/F, SHINGILDONG 110-4
+				  SEOUL  150839
+				KR
+
+E4-77-6B   (hex)		AARTESYS AG
+E4776B     (base 16)		AARTESYS AG
+				Bahnhofplatz 7
+				Biel  Bern  CH-2501
+				CH
+
+30-F3-1D   (hex)		zte corporation
+30F31D     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A0-EC-80   (hex)		zte corporation
+A0EC80     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+0C-C8-1F   (hex)		Summer Infant, Inc.
+0CC81F     (base 16)		Summer Infant, Inc.
+				1275 Park East Drive
+				Woonsocket  Rhode Island  02895
+				US
+
+A8-FB-70   (hex)		WiseSec L.t.d
+A8FB70     (base 16)		WiseSec L.t.d
+				145 yaffo ST.
+				Haifa  Israel  37503
+				IL
+
+E4-81-B3   (hex)		Shenzhen ACT Industrial Co.,Ltd.
+E481B3     (base 16)		Shenzhen ACT Industrial Co.,Ltd.
+				NO.5 B/D,BEISHAN INDUSTRIAL PARK,BEISHAN R/D,
+				Shenzhen  Guangdong  518083
+				CN
+
+C0-6C-6D   (hex)		MagneMotion, Inc.
+C06C6D     (base 16)		MagneMotion, Inc.
+				139 Barnum Road
+				Devens  Massachusetts  01434
+				US
+
+E8-80-D8   (hex)		GNTEK Electronics Co.,Ltd.
+E880D8     (base 16)		GNTEK Electronics Co.,Ltd.
+				Suzhou Industrial Park
+				Suzhou  Jiangsu  215021
+				CN
+
+30-3E-AD   (hex)		Sonavox Canada Inc
+303EAD     (base 16)		Sonavox Canada Inc
+				81 Zenway Blvd #25
+				Woodbridge  Ontario  L4S0S5
+				CA
+
+F8-35-DD   (hex)		Gemtek Technology Co., Ltd.
+F835DD     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road Hsinchu Industrial Park Hukou, Hsinchu 30352 TAIWAN, REPUBLIC OF CHINA
+				Hsinchu  TAIWAN  30352
+				TW
+
+D8-B0-4C   (hex)		Jinan USR IOT Technology Co., Ltd.
+D8B04C     (base 16)		Jinan USR IOT Technology Co., Ltd.
+				#1-523, Huizhan Guoji Cheng, Gaoxin Qu
+				JINAN  SHANDONG  250101
+				CN
+
+CC-04-B4   (hex)		Select Comfort
+CC04B4     (base 16)		Select Comfort
+				9800 59th Ave N
+				Minneapolis  MN  55442
+				US
+
+5C-15-E1   (hex)		AIDC TECHNOLOGY (S) PTE LTD
+5C15E1     (base 16)		AIDC TECHNOLOGY (S) PTE LTD
+				NO.1 GOLDHILL PLAZA #03-21
+				SINGAPORE    308899
+				SG
+
+E8-51-9D   (hex)		Yeonhab Precision Co.,LTD
+E8519D     (base 16)		Yeonhab Precision Co.,LTD
+				219-27, Haksusosa-Gil, Mokcheon-Eup
+				Cheonan  Chungcheongnamdo  330-844
+				KR
+
+DC-57-26   (hex)		Power-One
+DC5726     (base 16)		Power-One
+				Via San Girgio 642
+				Terranuova  Arezzo  52028
+				IT
+
+F8-DA-DF   (hex)		EcoTech, Inc.
+F8DADF     (base 16)		EcoTech, Inc.
+				999 Postal Road
+				Allentown  PA  18109
+				US
+
+30-AE-7B   (hex)		Deqing Dusun Electron CO., LTD
+30AE7B     (base 16)		Deqing Dusun Electron CO., LTD
+				No. 640 FengQing Street, Deqing
+				Huzhou  Zhejiang  313200
+				CN
+
+68-EC-62   (hex)		YODO Technology Corp. Ltd.
+68EC62     (base 16)		YODO Technology Corp. Ltd.
+				8F., No.168-1, Liancheng Rd
+				Taipei City    235
+				TW
+
+18-88-57   (hex)		Beijing Jinhong Xi-Dian Information Technology Corp.
+188857     (base 16)		Beijing Jinhong Xi-Dian Information Technology Corp.
+				4th -5th Floor, 1# Building NO.1 Zhonghe Road
+				  Beijing  100070
+				CN
+
+B8-C8-55   (hex)		Shanghai GBCOM Communication Technology Co.,Ltd.
+B8C855     (base 16)		Shanghai GBCOM Communication Technology Co.,Ltd.
+				Room 602, Building 6, No.
+				  Shanghai  200241
+				CN
+
+78-30-3B   (hex)		Stephen Technologies Co.,Limited
+78303B     (base 16)		Stephen Technologies Co.,Limited
+				5/F, Building NO.1, TongXin Industry Zone
+				Shenzhen  Guangdong  518115
+				CN
+
+CC-1A-FA   (hex)		zte corporation
+CC1AFA     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+6C-8B-2F   (hex)		zte corporation
+6C8B2F     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+8C-5A-F0   (hex)		Exeltech Solar Products
+8C5AF0     (base 16)		Exeltech Solar Products
+				3001 Northern Cross Blvd #361
+				Fort Worth  TX  76137
+				US
+
+B0-80-8C   (hex)		Laser Light Engines
+B0808C     (base 16)		Laser Light Engines
+				8C Industrial Way
+				Salem  New Hamshire  03079
+				US
+
+D8-DC-E9   (hex)		Kunshan Erlab ductless filtration system Co.,Ltd
+D8DCE9     (base 16)		Kunshan Erlab ductless filtration system Co.,Ltd
+				NO.100 Liu Shi Jin Road
+				Kunshan  Jiangsu  215300
+				CN
+
+DC-D5-2A   (hex)		Sunny Heart Limited
+DCD52A     (base 16)		Sunny Heart Limited
+				Rm. 1516, 15/F, Hewlett Center
+				Kwun Tong Kowloon    852
+				HK
+
+D8-66-C6   (hex)		Shenzhen Daystar Technology Co.,ltd
+D866C6     (base 16)		Shenzhen Daystar Technology Co.,ltd
+				The 5th Floor,#4 Building, Minxing Industria Zone
+				Shenzhen  Guangdong  518131
+				CN
+
+D0-0E-A4   (hex)		Porsche Cars North America
+D00EA4     (base 16)		Porsche Cars North America
+				980 Hammond Drive
+				Atlanta  GA  30328
+				US
+
+78-4B-08   (hex)		f.robotics acquisitions ltd
+784B08     (base 16)		f.robotics acquisitions ltd
+				Yevulim, Industrial Zone
+				Pardesia  Hasharon  42815
+				IL
+
+84-E4-D9   (hex)		Shenzhen NEED technology Ltd.
+84E4D9     (base 16)		Shenzhen NEED technology Ltd.
+				Room 581 ,Jinda technology center,No.8, Kefeng road,
+				Shenzhen  Guangdong  518057
+				CN
+
+40-BC-73   (hex)		Cronoplast  S.L.
+40BC73     (base 16)		Cronoplast  S.L.
+				Pol.Ind.S.Ermengol II -
+				ABRERA  BARCELONA  08630
+				ES
+
+40-07-C0   (hex)		Railtec Systems GmbH
+4007C0     (base 16)		Railtec Systems GmbH
+				Sonnenbergstr. 19
+				Hergiswil  Nidwalden  6052
+				CH
+
+A4-D3-B5   (hex)		GLITEL Stropkov, s.r.o.
+A4D3B5     (base 16)		GLITEL Stropkov, s.r.o.
+				Cintorinska 557/73
+				Stropkov    09101
+				SK
+
+D4-3A-65   (hex)		IGRS Engineering Lab Ltd.
+D43A65     (base 16)		IGRS Engineering Lab Ltd.
+				8F,Taipeng Mansion
+				Haidian District  Beijing  10000
+				CN
+
+F4-99-AC   (hex)		WEBER Schraubautomaten GmbH
+F499AC     (base 16)		WEBER Schraubautomaten GmbH
+				Hans-Urmiller-Ring 56
+				Wolfratshausen  Bayern  82515
+				DE
+
+D0-50-99   (hex)		ASRock Incorporation
+D05099     (base 16)		ASRock Incorporation
+				2F., No.37, Sec. 2, Jhongyang S. Rd.
+				Taipei    112
+				US
+
+A4-9E-DB   (hex)		AutoCrib, Inc.
+A49EDB     (base 16)		AutoCrib, Inc.
+				3011 S. Croddy Way
+				Santa Ana  CA  92704
+				US
+
+1C-76-CA   (hex)		Terasic Technologies Inc.
+1C76CA     (base 16)		Terasic Technologies Inc.
+				9F., No.176, Sec.2, Gongdao 5th Rd
+				Hsinchu City    30070
+				TW
+
+88-89-64   (hex)		GSI Electronics Inc.
+888964     (base 16)		GSI Electronics Inc.
+				5200 Armand-Frappier
+				St-Hubert  Quebec  J3Z 1G5
+				CA
+
+7C-D8-44   (hex)		Enmotus Inc
+7CD844     (base 16)		Enmotus Inc
+				65 Enterprise
+				Aliso Viejo  CA  92656
+				US
+
+44-61-9C   (hex)		FONsystem co. ltd.
+44619C     (base 16)		FONsystem co. ltd.
+				3F annex of Venture support center
+				  GwangJu  500-706
+				KR
+
+70-82-0E   (hex)		as electronics GmbH
+70820E     (base 16)		as electronics GmbH
+				Kantstraße 10
+				Großbettlingen  Baden -Württemberg  72663
+				DE
+
+0C-11-05   (hex)		AKUVOX (XIAMEN) NETWORKS CO., LTD
+0C1105     (base 16)		AKUVOX (XIAMEN) NETWORKS CO., LTD
+				Suite 201-15, 31 WangHai Rd
+				Xiamen  Fujian  361008
+				CN
+
+5C-22-C4   (hex)		DAE EUN ELETRONICS CO., LTD
+5C22C4     (base 16)		DAE EUN ELETRONICS CO., LTD
+				1029 Hokye-Dong, Dongan-Goo
+				Anyang-Shi  Kyongki-Do  431-080
+				KR
+
+F8-FE-A8   (hex)		Technico Japan Corporation
+F8FEA8     (base 16)		Technico Japan Corporation
+				AM Building 9F, 2-5-3,
+				Tokyo    160-0022
+				JP
+
+18-00-DB   (hex)		Fitbit Inc.
+1800DB     (base 16)		Fitbit Inc.
+				150 Spear St Ste 200
+				San Francisco  CA  94105
+				US
+
+78-A1-06   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+78A106     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+6C-61-26   (hex)		Rinicom Holdings
+6C6126     (base 16)		Rinicom Holdings
+				Riverway House
+				Lancaster  Lancashire  LA1 2RX
+				GB
+
+88-68-5C   (hex)		Shenzhen ChuangDao & Perpetual Eternal Technology Co.,Ltd
+88685C     (base 16)		Shenzhen ChuangDao & Perpetual Eternal Technology Co.,Ltd
+				Area c,2/F,Building 1, BaoAn foreign trade industrial zone
+				BaoAn District, Shenzhen  Guangdong province  518100
+				CN
+
+10-28-31   (hex)		Morion Inc.
+102831     (base 16)		Morion Inc.
+				Shosse Kosmonavtov, 111
+				Perm  Permsky Krai  614990
+				US
+
+EC-2C-49   (hex)		University of Tokyo
+EC2C49     (base 16)		University of Tokyo
+				4-6-1 Komaba
+				Meguro-ku  Tokyo  153-8904
+				US
+
+D8-29-16   (hex)		Ascent Communication Technology
+D82916     (base 16)		Ascent Communication Technology
+				13/F., Shum Tower
+				 Hong Kong    9999
+				HK
+
+2C-F2-03   (hex)		EMKO ELEKTRONIK SAN VE TIC AS
+2CF203     (base 16)		EMKO ELEKTRONIK SAN VE TIC AS
+				DOSAB, KARANFIL SOK, NO:6
+				  BURSA  16369
+				TR
+
+B4-FE-8C   (hex)		Centro Sicurezza Italia SpA
+B4FE8C     (base 16)		Centro Sicurezza Italia SpA
+				Via Venaria 28-30
+				Alpignano  Torino  10091
+				IT
+
+40-E7-30   (hex)		DEY Storage Systems, Inc.
+40E730     (base 16)		DEY Storage Systems, Inc.
+				215 South B Street
+				San Mateo  CA  94401
+				US
+
+68-B0-94   (hex)		INESA ELECTRON CO.,LTD
+68B094     (base 16)		INESA ELECTRON CO.,LTD
+				5F, NO.168, Tianlin Road
+				  Shanghai  200233
+				CN
+
+A0-73-FC   (hex)		Rancore Technologies Private Limited
+A073FC     (base 16)		Rancore Technologies Private Limited
+				5th Floor, Court House
+				Dhobi Talao  Maharashtra  400 002
+				IN
+
+44-F8-49   (hex)		Union Pacific Railroad
+44F849     (base 16)		Union Pacific Railroad
+				1400 Douglas St. STOP 0610
+				Omaha  NE  68179
+				US
+
+CC-0D-EC   (hex)		Cisco SPVTG
+CC0DEC     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+1C-37-BF   (hex)		Cloudium Systems Ltd.
+1C37BF     (base 16)		Cloudium Systems Ltd.
+				Hartnett Centre
+				Limerick    00
+				IE
+
+50-AB-BF   (hex)		Hoseo Telecom
+50ABBF     (base 16)		Hoseo Telecom
+				701 ACE Techno Tower 684-1
+				Seoul    157-721
+				KR
+
+0C-72-2C   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+0C722C     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+9C-E6-35   (hex)		Nintendo Co., Ltd.
+9CE635     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+60-A4-4C   (hex)		ASUSTek COMPUTER INC.
+60A44C     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+18-5A-E8   (hex)		Zenotech.Co.,Ltd
+185AE8     (base 16)		Zenotech.Co.,Ltd
+				E-503, BundangTechno Park, Yatap-dong
+				Seongnam    463-760
+				KR
+
+C4-7D-CC   (hex)		Zebra Technologies Inc
+C47DCC     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+E0-AE-ED   (hex)		LOENK
+E0AEED     (base 16)		LOENK
+				F9, Cheongdam Venture Plaza
+				  SEOUL  135-951
+				KR
+
+E4-92-E7   (hex)		Gridlink Tech. Co.,Ltd.
+E492E7     (base 16)		Gridlink Tech. Co.,Ltd.
+				Room No. 619, No. 108 Jiang Bin Dong Road
+				Fuzhou  Fujian  350015
+				CN
+
+CC-04-7C   (hex)		G-WAY Microwave
+CC047C     (base 16)		G-WAY Microwave
+				38 Leuning Street
+				South Hackensack  New Jersey  07078
+				US
+
+64-53-5D   (hex)		Frauscher Sensortechnik
+64535D     (base 16)		Frauscher Sensortechnik
+				Gewerbestraße 1
+				St. Marienkirchen  Upper Austria  4774
+				US
+
+3C-6F-F7   (hex)		EnTek Systems, Inc.
+3C6FF7     (base 16)		EnTek Systems, Inc.
+				562 Starlight Dr.
+				Sautee Nacoochee  GA  30571
+				US
+
+2C-7B-5A   (hex)		Milper Ltd
+2C7B5A     (base 16)		Milper Ltd
+				32 Shaham St.
+				Petach Tikva    49250
+				IL
+
+D4-BF-2D   (hex)		SE Controls Asia Pacific Ltd
+D4BF2D     (base 16)		SE Controls Asia Pacific Ltd
+				Unit 301, 3/F, Hung To Centre,
+				Kwun Tong  Kowloon  
+				HK
+
+E0-D9-A2   (hex)		Hippih aps
+E0D9A2     (base 16)		Hippih aps
+				Sceince Park Scion
+				Lyngby    2800
+				DK
+
+FC-06-47   (hex)		Cortland Research, LLC
+FC0647     (base 16)		Cortland Research, LLC
+				12 S Main St., Ste 207
+				Homer  NY  13077
+				US
+
+6C-D1-46   (hex)		FRAMOS GmbH
+6CD146     (base 16)		FRAMOS GmbH
+				Mehlbeerenstr. 2
+				Taufkirchen    82024
+				DE
+
+54-E0-32   (hex)		Juniper Networks
+54E032     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+54-61-EA   (hex)		Zaplox AB
+5461EA     (base 16)		Zaplox AB
+				Scheelev
+				Lund  Sk  22370
+				SE
+
+D0-8B-7E   (hex)		Passif Semiconductor
+D08B7E     (base 16)		Passif Semiconductor
+				400 S. El Camino Real Suite 250
+				San Mateo  California  94402
+				US
+
+04-58-6F   (hex)		Sichuan Whayer information industry Co.,LTD
+04586F     (base 16)		Sichuan Whayer information industry Co.,LTD
+				Layer 16,Building 10, C Area
+				Chengdu City    610041
+				CN
+
+FC-9F-AE   (hex)		Fidus Systems Inc
+FC9FAE     (base 16)		Fidus Systems Inc
+				35 Fitzgerald Road
+				Ottawa  Ontario  K2H 1E6
+				CA
+
+68-1E-8B   (hex)		InfoSight Corporation
+681E8B     (base 16)		InfoSight Corporation
+				20700 US Hwy 23
+				Chillicothe  Ohio  45601
+				US
+
+D0-52-A8   (hex)		Physical Graph Corporation
+D052A8     (base 16)		Physical Graph Corporation
+				11654 Plaza America Drive
+				Reston  VA  20190
+				US
+
+CC-3A-61   (hex)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+CC3A61     (base 16)		SAMSUNG ELECTRO MECHANICS CO., LTD.
+				314, Maetan3-Dong, Yeongtong-Gu
+				Suwon  Gyunggi-Do  443-743
+				US
+
+F8-D7-BF   (hex)		REV Ritter GmbH
+F8D7BF     (base 16)		REV Ritter GmbH
+				Frankenstra
+				M  Bavaria  63776
+				DE
+
+48-BE-2D   (hex)		Symanitron
+48BE2D     (base 16)		Symanitron
+				Ap.103, 17 Rudnevka str.,111674
+				  Moscow  
+				RU
+
+F0-23-29   (hex)		SHOWA DENKI CO.,LTD.
+F02329     (base 16)		SHOWA DENKI CO.,LTD.
+				1-25
+				Daito-city  Osaka  574-0052
+				JP
+
+F0-73-AE   (hex)		PEAK-System Technik
+F073AE     (base 16)		PEAK-System Technik
+				Otto-Roehm-Str 69
+				Darmstadt  Hessen  64293
+				DE
+
+48-B8-DE   (hex)		HOMEWINS TECHNOLOGY CO.,LTD.
+48B8DE     (base 16)		HOMEWINS TECHNOLOGY CO.,LTD.
+				10F-1, NO. 122, QIAOHE RD.,
+				NEW TAIPEI CITY,    235
+				TW
+
+10-EA-59   (hex)		Cisco SPVTG
+10EA59     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+0C-19-1F   (hex)		Inform Electronik
+0C191F     (base 16)		Inform Electronik
+				Emek mah.Ordu cad.No-49-51-53
+				Sarigazi-Sancaktepe  Istanbul  34785
+				US
+
+10-65-CF   (hex)		IQSIM
+1065CF     (base 16)		IQSIM
+				2000 Route des Lucioles
+				BIOT    06410
+				FR
+
+68-4C-A8   (hex)		Shenzhen Herotel Tech. Co., Ltd.
+684CA8     (base 16)		Shenzhen Herotel Tech. Co., Ltd.
+				Room W1402, West Tower, No.10128, Shennan Road, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+98-20-8E   (hex)		Definium Technologies
+98208E     (base 16)		Definium Technologies
+				34 Fairthorne Road
+				Launceston  Tasmania  7250
+				AU
+
+70-4A-E4   (hex)		Rinstrum Pty Ltd
+704AE4     (base 16)		Rinstrum Pty Ltd
+				41 Success St
+				Acacia Ridge  QLD  4110
+				AU
+
+08-3A-B8   (hex)		Shinoda Plasma Co., Ltd.
+083AB8     (base 16)		Shinoda Plasma Co., Ltd.
+				4-6-7, Minatojima Minamimachi, Chuo-ku
+				Kobe  Hyogo  6500047
+				JP
+
+A0-DD-97   (hex)		PolarLink Technologies, Ltd
+A0DD97     (base 16)		PolarLink Technologies, Ltd
+				6FL 352, Zhonghua 1st Rd. Kaohsiung 804 Taiwan
+				Kaohsiung  Taiwan  804
+				TW
+
+EC-89-F5   (hex)		Lenovo Mobile Communication Technology Ltd.
+EC89F5     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,Torch Hi-tech Industry Development Zone,
+				Xiamen  Fujian  361006
+				US
+
+B4-98-42   (hex)		zte corporation
+B49842     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+70-54-D2   (hex)		PEGATRON CORPORATION
+7054D2     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+64-5A-04   (hex)		Chicony Electronics Co., Ltd.
+645A04     (base 16)		Chicony Electronics Co., Ltd.
+				No.25, Wugong 6th Rd., Wugu Dist.,
+				New Taipei City 248,  TAIWAN, REPUBLIC OF CHINA  248
+				TW
+
+AC-17-02   (hex)		Fibar Group sp. z o.o.
+AC1702     (base 16)		Fibar Group sp. z o.o.
+				ul. Lotnicza 1
+				Poznan    60-421
+				PL
+
+98-4C-D3   (hex)		Mantis Deposition
+984CD3     (base 16)		Mantis Deposition
+				2 Goodson Industrial Mews
+				Thame  Oxfordshire  OX9 3BX
+				GB
+
+08-60-6E   (hex)		ASUSTek COMPUTER INC.
+08606E     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+3C-57-D5   (hex)		FiveCo
+3C57D5     (base 16)		FiveCo
+				Ch. de la Rueyre 116
+				Renens  VD  1020
+				US
+
+F8-48-97   (hex)		Hitachi, Ltd.
+F84897     (base 16)		Hitachi, Ltd.
+				27-18, Minami Oi 6-chome, Shinagawa-ku
+				Tokyo    140-8572
+				JP
+
+F8-0B-D0   (hex)		Datang Telecom communication terminal (Tianjin) Co., Ltd.
+F80BD0     (base 16)		Datang Telecom communication terminal (Tianjin) Co., Ltd.
+				Garden East Roadon the 15th,
+				Haidian District  Beijing  100191
+				CN
+
+E8-9A-FF   (hex)		Fujian LANDI Commercial Equipment Co.,Ltd
+E89AFF     (base 16)		Fujian LANDI Commercial Equipment Co.,Ltd
+				Building 17,the 1st Section ,Fuzhou Software Park
+				No.89 Software Road   Fuzhou ,Fujian  350003
+				CN
+
+0C-8C-DC   (hex)		Suunto Oy
+0C8CDC     (base 16)		Suunto Oy
+				Valimotie 7
+				Vantaa  Uusimaa  02710
+				FI
+
+60-C5-A8   (hex)		Beijing LT Honway Technology Co.,Ltd
+60C5A8     (base 16)		Beijing LT Honway Technology Co.,Ltd
+				Room 1703,A1 Tower, Changyuan Tiandi, No.18,Suzhou Street
+				beijing  beijing  100086
+				CN
+
+28-D2-44   (hex)		LCFC(HeFei) Electronics Technology Co., Ltd.
+28D244     (base 16)		LCFC(HeFei) Electronics Technology Co., Ltd.
+				6 Cui Wei Road
+				Hefei  Anhui  230000
+				CN
+
+B4-DF-3B   (hex)		Chromlech
+B4DF3B     (base 16)		Chromlech
+				19 av. Gabriel Faure
+				THORIGNE FOUILLARD    35235
+				FR
+
+7C-9A-9B   (hex)		VSE valencia smart energy
+7C9A9B     (base 16)		VSE valencia smart energy
+				Sir Alexander Fleming n
+				Paterna  Valencia  46980
+				ES
+
+84-E7-14   (hex)		Liang Herng Enterprise,Co.Ltd.
+84E714     (base 16)		Liang Herng Enterprise,Co.Ltd.
+				1FL,No.27,KweiYang Street,Sanchung District,New Taipei City,Taiwan,R.O.C. 
+				New Taipei City    241
+				TW
+
+B8-29-F7   (hex)		Blaster Tech
+B829F7     (base 16)		Blaster Tech
+				13337 South Street
+				Cerritos  CA  90703
+				US
+
+E4-A7-FD   (hex)		Cellco Partnership
+E4A7FD     (base 16)		Cellco Partnership
+				One Verizon Way
+				Baskin Ridge  New Jersey  07920
+				US
+
+2C-E2-A8   (hex)		DeviceDesign
+2CE2A8     (base 16)		DeviceDesign
+				Yeongtong-dong, Yeongtong-gu
+				Suwon-si  Gyeonggi-do  443-813
+				KR
+
+00-B5-6D   (hex)		David Electronics Co., LTD.
+00B56D     (base 16)		David Electronics Co., LTD.
+				9F, -2, No. 188, Sec. 3, Ta-Tung Rd.,
+				New Taipei City,     22103
+				TW
+
+2C-35-57   (hex)		ELLIY Power CO..Ltd
+2C3557     (base 16)		ELLIY Power CO..Ltd
+				1-6-4, Osaki
+				Shinagawa-ku  TOKYO  141-0032
+				US
+
+B8-04-15   (hex)		Bayan Audio
+B80415     (base 16)		Bayan Audio
+				5 The Pavilions
+				Pease Pottage  West Sussex  RH11 9BJ
+				GB
+
+D4-13-6F   (hex)		Asia Pacific Brands
+D4136F     (base 16)		Asia Pacific Brands
+				PO Box 113001
+				Auckland  Newmarket  1149
+				NZ
+
+C8-E1-A7   (hex)		Vertu Corporation Limited
+C8E1A7     (base 16)		Vertu Corporation Limited
+				Beacon Hill Road
+				Church Crookham  Hampshire  GU52 8DY
+				GB
+
+4C-AB-33   (hex)		KST technology
+4CAB33     (base 16)		KST technology
+				Bangi-dong, songpa-gu
+				  Seoul  138-050
+				KR
+
+F4-47-2A   (hex)		Nanjing Rousing Sci. and Tech. Industrial Co., Ltd
+F4472A     (base 16)		Nanjing Rousing Sci. and Tech. Industrial Co., Ltd
+				A630,F6,NO.58 Nanhu Road,Jianye District
+				Nanjing  Jiangsu  210017
+				CN
+
+DC-02-8E   (hex)		zte corporation
+DC028E     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+A8-45-E9   (hex)		Firich Enterprises CO., LTD.
+A845E9     (base 16)		Firich Enterprises CO., LTD.
+				10F., No. 75, Sec. 1, Xintai 5th Rd., Xizhi Dist.
+				New Taipei City  Taiwan (R.O.C.)  886
+				TW
+
+48-52-61   (hex)		SOREEL
+485261     (base 16)		SOREEL
+				18 Rue de la Gâtine
+				CHOLET  FRANCE  49304
+				FR
+
+64-62-23   (hex)		Cellient Co., Ltd.
+646223     (base 16)		Cellient Co., Ltd.
+				6F Glass Tower, 366-4 Yatap-dong Bundang-gu
+				Seongnam-si  Gyeonggi-do  463-827
+				KR
+
+98-47-3C   (hex)		SHANGHAI SUNMON COMMUNICATION TECHNOGY CO.,LTD
+98473C     (base 16)		SHANGHAI SUNMON COMMUNICATION TECHNOGY CO.,LTD
+				Suite 604-605,Xing Yuan Technology Plaza 418 Gui Ping Road  ShangHAI
+				Shanghai    200233
+				CN
+
+54-81-AD   (hex)		Eagle Research Corporation
+5481AD     (base 16)		Eagle Research Corporation
+				4237 State Route 34
+				Hurricane  West Virginia  25526
+				US
+
+54-A0-4F   (hex)		t-mac Technologies Ltd
+54A04F     (base 16)		t-mac Technologies Ltd
+				Stand Park
+				Chesterfield  Derbyshire  S41 8JT
+				GB
+
+14-DB-85   (hex)		S NET MEDIA
+14DB85     (base 16)		S NET MEDIA
+				4F, SEHYUN BLDG, 1581-7
+				SEOUL    137-875
+				KR
+
+B8-DA-F1   (hex)		Strahlenschutz- Entwicklungs- und Ausruestungsgesellschaft mbH
+B8DAF1     (base 16)		Strahlenschutz- Entwicklungs- und Ausruestungsgesellschaft mbH
+				Ostdamm 139
+				Duelmen  NRW  48249
+				DE
+
+D4-5C-70   (hex)		Wi-Fi Alliance
+D45C70     (base 16)		Wi-Fi Alliance
+				10900-B Stonelake Boulevard
+				Austin  TX  78759
+				US
+
+EC-47-3C   (hex)		Redwire, LLC
+EC473C     (base 16)		Redwire, LLC
+				8 Thorndike St
+				Everett  MA  02149
+				US
+
+3C-C1-2C   (hex)		AES Corporation
+3CC12C     (base 16)		AES Corporation
+				285 Newbury St
+				Peabody  MA  01960
+				US
+
+94-9B-FD   (hex)		Trans New Technology, Inc.
+949BFD     (base 16)		Trans New Technology, Inc.
+				KY Bldg. 8F, 5-14-4 Nishinippori
+				Arakawa  Tokyo  116-0013
+				JP
+
+A0-0A-BF   (hex)		Wieson Technologies Co., Ltd.
+A00ABF     (base 16)		Wieson Technologies Co., Ltd.
+				7F, No. 276, Sec. 1, Datong Rd
+				New Taipei City    221
+				TW
+
+8C-CD-E8   (hex)		Nintendo Co., Ltd.
+8CCDE8     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+7C-B2-32   (hex)		Hui Zhou Gaoshengda Technology Co.,LTD
+7CB232     (base 16)		Hui Zhou Gaoshengda Technology Co.,LTD
+				No.75,Zhongkai High-Tech Development District,Huizhou
+				Hui Zhou  Guangdong  516006
+				CN
+
+00-E6-66   (hex)		ARIMA Communications Corp.
+00E666     (base 16)		ARIMA Communications Corp.
+				6F.,No.866,Zhongzheng Rd.,Zhonghe Dist.,
+				New Taipei City  Taiwan  23586
+				TW
+
+34-BD-FA   (hex)		Cisco SPVTG
+34BDFA     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+F4-1E-26   (hex)		Simon-Kaloi Engineering
+F41E26     (base 16)		Simon-Kaloi Engineering
+				31192 La Baya Drive Unit G
+				Westlake Village  CA  91362
+				US
+
+70-25-26   (hex)		Nokia
+702526     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+18-D9-49   (hex)		Qvis Labs, LLC
+18D949     (base 16)		Qvis Labs, LLC
+				3204 Rustic River Cove
+				Austin  TX  78746-2001
+				US
+
+D8-08-F5   (hex)		Arcadia Networks Co. Ltd. 
+D808F5     (base 16)		Arcadia Networks Co. Ltd. 
+				Cheung Sha Wan 5-B FL
+				Kowloon    0633
+				HK
+
+0C-C4-7E   (hex)		EUCAST Co., Ltd.
+0CC47E     (base 16)		EUCAST Co., Ltd.
+				Room 303, 1018-2 Unjung-dong, Bundang-Gu
+				Seongnam-si  Kyunggi-do  463-440
+				KR
+
+50-72-4D   (hex)		BEG Brueck Electronic GmbH
+50724D     (base 16)		BEG Brueck Electronic GmbH
+				Schlosserstraße 30
+				Lindlar  Nordrhein-Westfalen  51789
+				DE
+
+78-3C-E3   (hex)		Kai-EE
+783CE3     (base 16)		Kai-EE
+				3F.-12, No.79, Sec. 1, Xintai 5th Rd.,
+				 New Taipei City    22101
+				TW
+
+B8-98-B0   (hex)		Atlona Inc.
+B898B0     (base 16)		Atlona Inc.
+				70 Daggett Dr.
+				San Jose  CA  95134
+				US
+
+24-69-4A   (hex)		Jasmine Systems Inc.
+24694A     (base 16)		Jasmine Systems Inc.
+				50 Charles Lindbergh Blvd. Suite 411
+				Uniondale  NY  11553
+				US
+
+08-0C-0B   (hex)		SysMik GmbH Dresden
+080C0B     (base 16)		SysMik GmbH Dresden
+				Bertolt-Brecht-Allee 24
+				Dresden    01309
+				DE
+
+DC-BF-90   (hex)		HUIZHOU QIAOXING TELECOMMUNICATION INDUSTRY CO.,LTD.
+DCBF90     (base 16)		HUIZHOU QIAOXING TELECOMMUNICATION INDUSTRY CO.,LTD.
+				Qiaoxing Science Technological&Industrial Zone Tangquan
+				Huizhou  Guangdong  516023
+				CN
+
+04-9F-06   (hex)		Smobile Co., Ltd.
+049F06     (base 16)		Smobile Co., Ltd.
+				T-1009, Poongrim i-won Plus, 255-1
+				Seohyeon-dong, Bundang-gu  Seongnam-si, Gyeonggi-do  463-862
+				KR
+
+28-9A-4B   (hex)		SteelSeries ApS
+289A4B     (base 16)		SteelSeries ApS
+				656 West Randolph, Suite 2E
+				Chicago  IL  60661
+				US
+
+A0-8C-15   (hex)		Gerhard D. Wempe KG
+A08C15     (base 16)		Gerhard D. Wempe KG
+				Steinstrasse 23
+				  Hamburg  20095
+				DE
+
+90-CF-6F   (hex)		Dlogixs Co Ltd
+90CF6F     (base 16)		Dlogixs Co Ltd
+				DLogixs Bldg, #351-1, Anyang-Dong
+				Anyang-si  Gyeonggi-do  430-010
+				KR
+
+C8-FB-26   (hex)		Cisco SPVTG
+C8FB26     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+B8-58-10   (hex)		NUMERA, INC.
+B85810     (base 16)		NUMERA, INC.
+				1511 3RD AVE
+				SEATTLE  WA  98101
+				US
+
+EC-D9-50   (hex)		IRT SA
+ECD950     (base 16)		IRT SA
+				Puits-Godet 16
+				NEUCHATEL  NE  2000
+				CH
+
+7C-02-BC   (hex)		Hansung Electronics Co. LTD
+7C02BC     (base 16)		Hansung Electronics Co. LTD
+				319, Bong san-ri, San dong-myun
+				Gumi    730-853
+				KR
+
+B8-24-10   (hex)		Magneti Marelli Slovakia s.r.o.
+B82410     (base 16)		Magneti Marelli Slovakia s.r.o.
+				Industrial Park Kechnec
+				Kechnec    04458
+				SK
+
+10-5F-49   (hex)		Cisco SPVTG
+105F49     (base 16)		Cisco SPVTG
+				5030 Sugarloaf Parkway
+				Lawrenceville  GA  30044
+				US
+
+1C-5C-60   (hex)		Shenzhen Belzon Technology Co.,LTD.
+1C5C60     (base 16)		Shenzhen Belzon Technology Co.,LTD.
+				5F Block 1,Zhongxin Building,Chuangye Rd
+				Shenzhen  Guangdong  518054
+				CN
+
+B8-B9-4E   (hex)		Shenzhen iBaby Labs, Inc.
+B8B94E     (base 16)		Shenzhen iBaby Labs, Inc.
+				Room 218, Building 17,Shangsha Innovation Science and Technology Park,Futian District
+				Shenzhen  Guangdong  518047
+				CN
+
+AC-C6-98   (hex)		Kohzu Precision Co., Ltd.
+ACC698     (base 16)		Kohzu Precision Co., Ltd.
+				2-6-15, Kurigi, Asao-ku
+				Kawasaki-shi  Kanagawa  215-8521
+				JP
+
+7C-38-6C   (hex)		Real Time Logic
+7C386C     (base 16)		Real Time Logic
+				12515 Academy Ridge View
+				Colorado Springs  Colorado  80921
+				US
+
+20-67-B1   (hex)		Pluto inc.
+2067B1     (base 16)		Pluto inc.
+				Hongo5-21-1-303
+				Bunkyo-ku  Tokyo  113-0033
+				JP
+
+18-9A-67   (hex)		CSE-Servelec Limited
+189A67     (base 16)		CSE-Servelec Limited
+				Rotherside Road
+				Sheffield    S21 4HL
+				GB
+
+08-7D-21   (hex)		Altasec technology corporation
+087D21     (base 16)		Altasec technology corporation
+				9F-1, No.75, Sec.1, Xintai 5th Rd.,
+				New Taipei City  Taiwan  221
+				TW
+
+F8-05-1C   (hex)		DRS Imaging and Targeting Solutions
+F8051C     (base 16)		DRS Imaging and Targeting Solutions
+				100 N Babcock St
+				Melbourne  FL  32935
+				US
+
+78-D3-4F   (hex)		Pace-O-Matic, Inc.
+78D34F     (base 16)		Pace-O-Matic, Inc.
+				4150 Blue Ridge Industrial Parkway
+				Norcross  GA  30071
+				US
+
+A4-46-6B   (hex)		EOC Technology
+A4466B     (base 16)		EOC Technology
+				#1601 Acro Palace, 1594 Gwanyang-dong, Dongan-gu
+				Anyang-si  Gyeonggi-do  431-060
+				KR
+
+90-1E-DD   (hex)		GREAT COMPUTER CORPORATION
+901EDD     (base 16)		GREAT COMPUTER CORPORATION
+				4F., No.236, Fude 2nd Rd., Xizhi Dist., 
+				New Taipei City    22151
+				TW
+
+34-D7-B4   (hex)		Tributary Systems, Inc.
+34D7B4     (base 16)		Tributary Systems, Inc.
+				3717 Commerce Place
+				Bedford  Texas  76021
+				US
+
+F4-0F-9B   (hex)		WAVELINK
+F40F9B     (base 16)		WAVELINK
+				#701, Dongyoung Venture'stel 3rd, 202-4,
+				Anyang-si  Kyungki-do  430-817
+				KR
+
+64-5F-FF   (hex)		Nicolet Neuro
+645FFF     (base 16)		Nicolet Neuro
+				1850 Deming Way
+				Middleton  WI  53562
+				US
+
+AC-7A-42   (hex)		iConnectivity
+AC7A42     (base 16)		iConnectivity
+				#21, 1725 30th Ave NE
+				Calgary  Alberta  T2E 7P6
+				CA
+
+70-0B-C0   (hex)		Dewav Technology Company
+700BC0     (base 16)		Dewav Technology Company
+				Room 1408, Real Estate Mansion
+				  Shangahi  200120
+				CN
+
+CC-14-A6   (hex)		Yichun MyEnergy Domain, Inc
+CC14A6     (base 16)		Yichun MyEnergy Domain, Inc
+				349W. Yuanshan Rd, Yichun
+				Yichun  Jiangxi  336000
+				CN
+
+10-9F-A9   (hex)		Actiontec Electronics, Inc
+109FA9     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+C0-A3-64   (hex)		3D Systems Massachusetts
+C0A364     (base 16)		3D Systems Massachusetts
+				19 Connector Road
+				Andover  MA  01810
+				US
+
+1C-5F-FF   (hex)		Beijing Ereneben Information Technology Co.,Ltd Shenzhen Branch
+1C5FFF     (base 16)		Beijing Ereneben Information Technology Co.,Ltd Shenzhen Branch
+				Room 14A, Building A, Honglong Central Plaza, No.3001,Heping Road, Luohu District, Shenzhen City
+				Shenzhen  Guangdong  518001
+				CN
+
+60-45-BD   (hex)		Microsoft
+6045BD     (base 16)		Microsoft
+				1 Microsoft Way
+				Redmond  Washington  98052
+				US
+
+24-10-64   (hex)		Shenzhen Ecsino Tecnical Co. Ltd
+241064     (base 16)		Shenzhen Ecsino Tecnical Co. Ltd
+				7F Guoxin build ChangXin Road. Nan'shan District
+				Shenzhen  Guangdong  518000
+				CN
+
+7C-EB-EA   (hex)		ASCT
+7CEBEA     (base 16)		ASCT
+				4F., No.49, Wu-Gong 6th Rd. Wu-Gu Industrial Park,
+				New Taipei City    248
+				TW
+
+9C-0D-AC   (hex)		Tymphany HK Limited
+9C0DAC     (base 16)		Tymphany HK Limited
+				RM 1307-8
+				43-59, Queen's Road East  Wanchai  
+				HK
+
+70-B5-99   (hex)		Embedded Technologies s.r.o.
+70B599     (base 16)		Embedded Technologies s.r.o.
+				Doubravice 134
+				Turnov    51101
+				CZ
+
+EC-4C-4D   (hex)		ZAO NPK RoTeK
+EC4C4D     (base 16)		ZAO NPK RoTeK
+				Bild. 119-1, Prospekt Mira
+				Moscow  Moscow  129223
+				RU
+
+A4-D1-8F   (hex)		Shenzhen Skyee Optical Fiber Communication Technology Ltd. 
+A4D18F     (base 16)		Shenzhen Skyee Optical Fiber Communication Technology Ltd. 
+				No.5 Bldg. Yimin Industrial Park, No.31, Makan South Road, Nanshan District
+				Shenzhen  Guangdong  518000
+				CN
+
+58-34-3B   (hex)		Glovast Technology Ltd.
+58343B     (base 16)		Glovast Technology Ltd.
+				6F., No.23, JianKang Rd., SongShan Dist.,
+				Taipei    105
+				TW
+
+88-96-76   (hex)		TTC MARCONI s.r.o.
+889676     (base 16)		TTC MARCONI s.r.o.
+				Trebohosticka s.r.o.
+				Praha    10000
+				CZ
+
+5C-17-37   (hex)		I-View Now, LLC.
+5C1737     (base 16)		I-View Now, LLC.
+				1421 E. Sunset
+				Las Vegas  NV  89119
+				US
+
+AC-0A-61   (hex)		Labor S.r.L.
+AC0A61     (base 16)		Labor S.r.L.
+				Via della Scrofa 117
+				  Rome  00186
+				IT
+
+1C-43-EC   (hex)		JAPAN CIRCUIT CO.,LTD
+1C43EC     (base 16)		JAPAN CIRCUIT CO.,LTD
+				NKF-Kawasaki-Building 7F
+				Kawasaki  Kanagawa  2100005
+				JP
+
+54-D1-B0   (hex)		Universal Laser Systems, Inc
+54D1B0     (base 16)		Universal Laser Systems, Inc
+				16008 N 81st street
+				scottsdale  az  85260
+				US
+
+78-52-62   (hex)		Shenzhen Hojy Software Co., Ltd.
+785262     (base 16)		Shenzhen Hojy Software Co., Ltd.
+				3F,East of Building25,Keyuanxi,Number 5,Kezhixi Road, Science & Industry Park ,Nan Shan District ,Shenzhen
+				ShenZhen  GuangDong  508057
+				CN
+
+74-6A-89   (hex)		Rezolt Corporation
+746A89     (base 16)		Rezolt Corporation
+				2855 Bowers Avenue
+				Santa Clara  CA  95051
+				US
+
+70-2F-4B   (hex)		PolyVision Inc.
+702F4B     (base 16)		PolyVision Inc.
+				3970 Johns Creek Ct.
+				Suwanee  Georgia  30024
+				US
+
+74-14-89   (hex)		SRT Wireless
+741489     (base 16)		SRT Wireless
+				4101 SW 47th Avenue #102
+				Davie  Florida  33314
+				US
+
+24-1B-13   (hex)		Shanghai Nutshell Electronic Co., Ltd.
+241B13     (base 16)		Shanghai Nutshell Electronic Co., Ltd.
+				365 Guoshoujing RD.,Zhangjiang Hi-Tech Park, Pudong District
+				Shanghai  Shanghai  201203
+				CN
+
+20-01-4F   (hex)		Linea Research Ltd
+20014F     (base 16)		Linea Research Ltd
+				1 Marquis Business Centre
+				Baldock  Hertfordshire  SG7 6XL
+				GB
+
+EC-0E-D6   (hex)		ITECH INSTRUMENTS SAS
+EC0ED6     (base 16)		ITECH INSTRUMENTS SAS
+				3 Avenue de la Maranne
+				Châteauneuf-Les-Martigues    13220
+				FR
+
+24-09-17   (hex)		Devlin Electronics Limited
+240917     (base 16)		Devlin Electronics Limited
+				Unit D1
+				Basingstoke  Hampshire  RG226HZ
+				GB
+
+9C-54-CA   (hex)		Zhengzhou VCOM Science and Technology Co.,Ltd
+9C54CA     (base 16)		Zhengzhou VCOM Science and Technology Co.,Ltd
+				National 863 Software Park£¬No.6 Cuizhu Street, Hi-tech Indusry Developing Park
+				ZhengZhou City  Henan Province  450001
+				CN
+
+B4-35-64   (hex)		Fujian Tian Cheng Electron Science & Technical Development Co.,Ltd.
+B43564     (base 16)		Fujian Tian Cheng Electron Science & Technical Development Co.,Ltd.
+				1801 unit,Tian an Cyber Times Tower A,Futian District
+				Shenzhen  Guangdong  518000
+				CN
+
+00-BF-15   (hex)		Genetec Inc.
+00BF15     (base 16)		Genetec Inc.
+				2280 boul. Alfred-Nobel
+				St,. Laurent  Quebec  H4S 2A4
+				CA
+
+38-EE-9D   (hex)		Anedo Ltd.
+38EE9D     (base 16)		Anedo Ltd.
+				Huelsmeyerstraße 35
+				Eydelstedt    49406
+				DE
+
+78-BE-BD   (hex)		STULZ GmbH
+78BEBD     (base 16)		STULZ GmbH
+				Holsteiner Chausse 283
+				  Hamburg  22457
+				DE
+
+D4-DF-57   (hex)		Alpinion Medical Systems
+D4DF57     (base 16)		Alpinion Medical Systems
+				1F Verdi Tower 222-22 
+				Seoul    181-848
+				KR
+
+50-48-EB   (hex)		BEIJING HAIHEJINSHENG NETWORK TECHNOLOGY CO. LTD.
+5048EB     (base 16)		BEIJING HAIHEJINSHENG NETWORK TECHNOLOGY CO. LTD.
+				RM 701 Unit 2 Huirong Bldg. No.106 Lianhuachi East RD. Xuanwu Dist. Beijing
+				BEIJING  CHINA  100055
+				CN
+
+B4-0E-96   (hex)		HERAN 
+B40E96     (base 16)		HERAN 
+				No.88, Keji 3rd Rd., Guishan Township
+				Taoyuan  R.O.C  333
+				TW
+
+50-8C-77   (hex)		DIRMEIER Schanktechnik GmbH &Co KG
+508C77     (base 16)		DIRMEIER Schanktechnik GmbH &Co KG
+				Alfons-Goppel-Straße 5
+				92526 Oberviechtach    
+				DE
+
+40-70-4A   (hex)		Power Idea Technology Limited
+40704A     (base 16)		Power Idea Technology Limited
+				1401A, Mintai Building, WenXin 5 Road, ShenZhen, PRC
+				Guang Dong  Shen Zhen  518054
+				CN
+
+54-5E-BD   (hex)		NL Technologies
+545EBD     (base 16)		NL Technologies
+				33 Laird Drive
+				Toronto  ON  M4G3S8
+				CA
+
+F4-7F-35   (hex)		Cisco Systems, Inc
+F47F35     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+BC-C1-68   (hex)		DinBox Sverige AB
+BCC168     (base 16)		DinBox Sverige AB
+				Surbrunnsgatan 14
+				Stockholm    11427
+				SE
+
+DC-30-9C   (hex)		Heyrex Limited
+DC309C     (base 16)		Heyrex Limited
+				Level 1, 236-256 Karori Road
+				Wellington    6147
+				NZ
+
+2C-00-F7   (hex)		XOS
+2C00F7     (base 16)		XOS
+				15 Tech Valley Drive
+				East Greenbush  NY  12061
+				US
+
+28-F6-06   (hex)		Syes srl
+28F606     (base 16)		Syes srl
+				Via Zanella 21
+				Lissone (MB)  Monza Brianza  20851
+				IT
+
+0C-AF-5A   (hex)		GENUS POWER INFRASTRUCTURES LIMITED
+0CAF5A     (base 16)		GENUS POWER INFRASTRUCTURES LIMITED
+				SPL-3 RIICO INDUSTRIAL AREA
+				JAIPUR  RAJASTHAN  302022
+				IN
+
+7C-EF-8A   (hex)		Inhon International Ltd.
+7CEF8A     (base 16)		Inhon International Ltd.
+				2F, No.552, Ruiguang Rd, Neihu Dist
+				Taipei  Taiwan  114
+				TW
+
+24-11-25   (hex)		Hutek Co., Ltd.
+241125     (base 16)		Hutek Co., Ltd.
+				E-402 Bundang Technopark 
+				Seongnam-city  Gyeonggi-do  463-760
+				KR
+
+B4-31-B8   (hex)		Aviwest
+B431B8     (base 16)		Aviwest
+				6 rue du Patis Tatelin
+				Rennes    35700
+				FR
+
+CC-18-7B   (hex)		Manzanita Systems, Inc.
+CC187B     (base 16)		Manzanita Systems, Inc.
+				14269 Danielson Street
+				Poway  CA  92064
+				US
+
+08-BE-09   (hex)		Astrol Electronic AG
+08BE09     (base 16)		Astrol Electronic AG
+				Vorderi Böde 3
+				Oberrohrdorf  AG  5452
+				CH
+
+B4-1D-EF   (hex)		Internet Laboratories, Inc.
+B41DEF     (base 16)		Internet Laboratories, Inc.
+				P.O. Box 7697
+				Atlanta  GA  30357
+				US
+
+80-93-93   (hex)		Xapt GmbH
+809393     (base 16)		Xapt GmbH
+				Neidenburger Str. 10
+				Gelsenkirchen  NRW  45897
+				DE
+
+A0-07-B6   (hex)		Advanced Technical Support, Inc.
+A007B6     (base 16)		Advanced Technical Support, Inc.
+				10 Grassmere Ave
+				West Hartford  CT  06110
+				US
+
+0C-D2-B5   (hex)		Binatone Telecommunication Pvt. Ltd
+0CD2B5     (base 16)		Binatone Telecommunication Pvt. Ltd
+				A36, G/F, Sector 4
+				  Uttar Pradesh  201301
+				IN
+
+48-46-F1   (hex)		Uros Oy
+4846F1     (base 16)		Uros Oy
+				Tutkijantie 4
+				OULU    90590
+				FI
+
+B8-27-EB   (hex)		Raspberry Pi Foundation
+B827EB     (base 16)		Raspberry Pi Foundation
+				Mitchell Wood House
+				Caldecote  Cambridgeshire  CB23 7NU
+				US
+
+84-AF-1F   (hex)		Beat System Service Co,. Ltd.
+84AF1F     (base 16)		Beat System Service Co,. Ltd.
+				1-11-1-2F, Nodaya-cho
+				Okayama-city  Okayama  700-0815
+				JP
+
+B0-58-C4   (hex)		Broadcast Microwave Services, Inc
+B058C4     (base 16)		Broadcast Microwave Services, Inc
+				12367 Crosthwaite Circle
+				Poway  CA  92064
+				US
+
+74-57-98   (hex)		TRUMPF Laser GmbH + Co. KG
+745798     (base 16)		TRUMPF Laser GmbH + Co. KG
+				Aichhalder Str. 39
+				Schramberg  BW  78713
+				DE
+
+28-17-CE   (hex)		Omnisense Ltd
+2817CE     (base 16)		Omnisense Ltd
+				3rd Floor St Andrew's House
+				Cambridge  Cambridgeshire  CB2 3BZ
+				GB
+
+3C-CE-73   (hex)		Cisco Systems, Inc
+3CCE73     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B0-BD-6D   (hex)		Echostreams Innovative Solutions
+B0BD6D     (base 16)		Echostreams Innovative Solutions
+				1130 Coiner Ct.
+				City of Industry  CA  91748
+				US
+
+60-44-F5   (hex)		Easy Digital Ltd.
+6044F5     (base 16)		Easy Digital Ltd.
+				Victoria Buildings, 1 Haddington Road
+				Dublin    4
+				IE
+
+90-AC-3F   (hex)		BrightSign LLC
+90AC3F     (base 16)		BrightSign LLC
+				16795 Lark Ave.
+				Los Gatos  CA  95032
+				US
+
+AC-51-EE   (hex)		Cambridge Communication Systems Ltd
+AC51EE     (base 16)		Cambridge Communication Systems Ltd
+				Sheraton House
+				Cambridge  Cambridgeshire  CB3 0AX
+				GB
+
+78-A1-83   (hex)		Advidia
+78A183     (base 16)		Advidia
+				3 Riverway
+				Houston  TX  77056
+				US
+
+A8-D0-E5   (hex)		Juniper Networks
+A8D0E5     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+F8-99-55   (hex)		Fortress Technology Inc
+F89955     (base 16)		Fortress Technology Inc
+				51 Grand Marshall Drive
+				Scarborough  Ontario  M1B 5N6
+				CA
+
+4C-C9-4F   (hex)		Nokia
+4CC94F     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+0C-E5-D3   (hex)		DH electronics GmbH
+0CE5D3     (base 16)		DH electronics GmbH
+				Am Anger 8
+				Bergen    83346
+				DE
+
+E4-25-E9   (hex)		Color-Chip
+E425E9     (base 16)		Color-Chip
+				Tavor Building 1
+				New Industrial Park  Yokneam  20692
+				IL
+
+14-B1-C8   (hex)		InfiniWing, Inc.
+14B1C8     (base 16)		InfiniWing, Inc.
+				19925 Stevens Creek Blvd
+				Cupertino  CA  95014
+				US
+
+E8-40-F2   (hex)		PEGATRON CORPORATION
+E840F2     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+50-05-3D   (hex)		CyWee Group Ltd
+50053D     (base 16)		CyWee Group Ltd
+				3F, No.28, Lane128
+				Taipei    10462
+				TW
+
+F8-8C-1C   (hex)		KAISHUN ELECTRONIC TECHNOLOGY CO., LTD. BEIJING
+F88C1C     (base 16)		KAISHUN ELECTRONIC TECHNOLOGY CO., LTD. BEIJING
+				NO.1 FARM, HENGQIAO VILLAGE WEST, MACHIKOU TOWN, 
+				BEIJING    102200
+				CN
+
+1C-0B-52   (hex)		EPICOM S.A
+1C0B52     (base 16)		EPICOM S.A
+				Autovia Andalucia Km 12.700
+				Getafe  Madrid  28905
+				ES
+
+74-7E-2D   (hex)		Beijing Thomson CITIC Digital Technology Co. LTD.
+747E2D     (base 16)		Beijing Thomson CITIC Digital Technology Co. LTD.
+				8301, No.8 Workshop, 3 Yongchangbei Road
+				Beijing    100176
+				CN
+
+88-5C-47   (hex)		Alcatel Lucent
+885C47     (base 16)		Alcatel Lucent
+				Via Energy Park, 14
+				Vimercate  MB  20871
+				IT
+
+3C-C1-F6   (hex)		Melange Systems Pvt. Ltd.
+3CC1F6     (base 16)		Melange Systems Pvt. Ltd.
+				4/1, 7th Cross, Kumarapark West
+				Bangalore  Karnataka  560020
+				IN
+
+94-FA-E8   (hex)		Shenzhen Eycom Technology Co., Ltd 
+94FAE8     (base 16)		Shenzhen Eycom Technology Co., Ltd 
+				EYANG Building, No. 3 of Qimin Rd, Langshan 2nd Street, North Area of Hi-Tech Industrial Zone, Nanshan District
+				Shenzhen  Guang Dong  518057
+				CN
+
+B4-82-55   (hex)		Research Products Corporation
+B48255     (base 16)		Research Products Corporation
+				1015 E. Washington Ave
+				Madison  WI  53703
+				US
+
+80-16-B7   (hex)		Brunel University
+8016B7     (base 16)		Brunel University
+				School of IS, Computing & Maths
+				Uxbridge  Middlesex  UB8 3PH
+				GB
+
+00-8D-DA   (hex)		Link One Co., Ltd.
+008DDA     (base 16)		Link One Co., Ltd.
+				601F   Chungjuk tower 546-9 
+				Buchion  Gyeonggi-do   420-864
+				KR
+
+C4-98-05   (hex)		Minieum Networks, Inc
+C49805     (base 16)		Minieum Networks, Inc
+				6404 International Parkway
+				Plano  Texas  75093
+				US
+
+90-F4-C1   (hex)		Rand McNally
+90F4C1     (base 16)		Rand McNally
+				9855 Woods Drive
+				Skokie  IL  60077
+				US
+
+18-19-3F   (hex)		Tamtron Oy
+18193F     (base 16)		Tamtron Oy
+				P.O.Box 15 (Vestonkatu 11)
+				Tampere    33561
+				FI
+
+94-44-44   (hex)		LG Innotek
+944444     (base 16)		LG Innotek
+				Jangduk-dong, Gwangsan-gu
+				Gwang-ju    506-731
+				KR
+
+4C-64-D9   (hex)		Guangdong Leawin Group Co., Ltd
+4C64D9     (base 16)		Guangdong Leawin Group Co., Ltd
+				10/F, Domain Bldg,No.8 Keji Road(E),HiTech Development District,
+				Shantou  Guangdong  515041
+				CN
+
+94-01-49   (hex)		AutoHotBox
+940149     (base 16)		AutoHotBox
+				14090 SW Frwy, Ste. 300
+				Sugar Land  TX  77478
+				US
+
+1C-B0-94   (hex)		HTC Corporation
+1CB094     (base 16)		HTC Corporation
+				No. 23, Xinghua Rd., Taoyuan City
+				Taoyuan County  Taiwan  330
+				TW
+
+9C-01-11   (hex)		Shenzhen Newabel Electronic Co., Ltd.
+9C0111     (base 16)		Shenzhen Newabel Electronic Co., Ltd.
+				5Flr, South Tower of Sichuan Bld.,
+				Shenzhen  Guangdong  518028
+				CN
+
+40-0E-67   (hex)		Tremol Ltd.
+400E67     (base 16)		Tremol Ltd.
+				6 Toledo str.
+				Veliko Turnovo    5000
+				BG
+
+C0-DF-77   (hex)		Conrad Electronic SE
+C0DF77     (base 16)		Conrad Electronic SE
+				Klaus Conrad Str. 1
+				Hirschau  Bavaria  92240
+				DE
+
+30-55-ED   (hex)		Trex Network LLC
+3055ED     (base 16)		Trex Network LLC
+				Room 505, Tower B Nongke Building, 
+				Beijing    100097
+				CN
+
+F0-F7-55   (hex)		Cisco Systems, Inc
+F0F755     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+1C-B2-43   (hex)		TDC A/S
+1CB243     (base 16)		TDC A/S
+				Telehøjen 1
+				Odense SØ    5220
+				DK
+
+38-BF-33   (hex)		NEC CASIO Mobile Communications
+38BF33     (base 16)		NEC CASIO Mobile Communications
+				1753,Shimonumabe
+				Kawasaki-shi  Kanagawa  211-8666
+				JP
+
+B4-67-E9   (hex)		Qingdao GoerTek Technology Co., Ltd.
+B467E9     (base 16)		Qingdao GoerTek Technology Co., Ltd.
+				5F, No.3 Building, Fortune Center
+				Qingdao  Shandong  266061
+				CN
+
+18-67-51   (hex)		KOMEG Industrielle Messtechnik GmbH
+186751     (base 16)		KOMEG Industrielle Messtechnik GmbH
+				Zum Wasserwerk 3
+				Völklingen    66333
+				DE
+
+64-5E-BE   (hex)		Yahoo! JAPAN
+645EBE     (base 16)		Yahoo! JAPAN
+				Midtown Tower
+				Minato-ku  Tokyo  107-6211
+				JP
+
+CC-C5-0A   (hex)		SHENZHEN DAJIAHAO TECHNOLOGY CO.,LTD
+CCC50A     (base 16)		SHENZHEN DAJIAHAO TECHNOLOGY CO.,LTD
+				3F Buliding 1, 2th Park TaoHuaYuan Tech- Innovation,
+				Shenzhen  Guangdong  518102
+				CN
+
+1C-B1-7F   (hex)		NEC Platforms, Ltd.
+1CB17F     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+E4-2C-56   (hex)		Lilee Systems, Ltd.
+E42C56     (base 16)		Lilee Systems, Ltd.
+				2905 Stender Way, Suite 78
+				Santa Clara  CA  95054
+				US
+
+48-ED-80   (hex)		daesung eltec
+48ED80     (base 16)		daesung eltec
+				#509 SJ Technoville, 60-19, Gasan-dong
+				Seoul    153-769
+				KR
+
+C8-07-18   (hex)		TDSi
+C80718     (base 16)		TDSi
+				Unit 10 Concept Park
+				Poole  Dorset  BH12 4QT
+				GB
+
+58-1D-91   (hex)		Advanced Mobile Telecom co.,ltd.
+581D91     (base 16)		Advanced Mobile Telecom co.,ltd.
+				#608, Yatap Leaders Bldg. 342-1
+				Seongnam-si  Gyeonggi-do  463-828
+				KR
+
+D8-BF-4C   (hex)		Victory Concept Electronics Limited
+D8BF4C     (base 16)		Victory Concept Electronics Limited
+				4/F., CAC Tower,
+				Kwun Tong  Kowloon  KLN
+				HK
+
+3C-B9-A6   (hex)		Belden Deutschland GmbH
+3CB9A6     (base 16)		Belden Deutschland GmbH
+				Stuttgarter Straße 45-51
+				Neckartenzlingen    72654
+				DE
+
+8C-0C-A3   (hex)		Amper
+8C0CA3     (base 16)		Amper
+				Marconi 3, PTM
+				Tres Cantos  Madrid  28760
+				US
+
+94-DF-58   (hex)		IJ Electron CO.,Ltd.
+94DF58     (base 16)		IJ Electron CO.,Ltd.
+				401 ACE HIGHEND8, 345-4 GASAN-DONG
+				SEOUL    153-802
+				KR
+
+48-D5-4C   (hex)		Jeda Networks
+48D54C     (base 16)		Jeda Networks
+				2618 San Miguel Drive
+				Newport Beach  Ca.  92660
+				US
+
+8C-DE-52   (hex)		ISSC Technologies Corp.
+8CDE52     (base 16)		ISSC Technologies Corp.
+				4F, No.8, Dusing Rd.,
+				Hsinchu City     30078
+				TW
+
+08-25-22   (hex)		ADVANSEE
+082522     (base 16)		ADVANSEE
+				9 Rue Alfred Kastler
+				NANTES    44307
+				FR
+
+4C-2F-9D   (hex)		ICM Controls
+4C2F9D     (base 16)		ICM Controls
+				7313 William Barry Blvd
+				North Syracuse  NY  13212
+				US
+
+E4-67-BA   (hex)		Danish Interpretation Systems A/S
+E467BA     (base 16)		Danish Interpretation Systems A/S
+				Vestre Teglgade 12
+				Copenhagen  SV  2450
+				DK
+
+BC-B8-52   (hex)		Cybera, Inc.
+BCB852     (base 16)		Cybera, Inc.
+				9009 Carothers Parkway
+				Franklin  TN  37067
+				US
+
+C4-93-00   (hex)		8Devices
+C49300     (base 16)		8Devices
+				Gedimino st. 47
+				Kaunas  LT  44242
+				LT
+
+6C-A6-82   (hex)		EDAM information & communications
+6CA682     (base 16)		EDAM information & communications
+				601, Hanlim Veture town, 689-6
+				Gunpo  Gyenggi-Do  435-862
+				KR
+
+28-D5-76   (hex)		Premier Wireless, Inc.
+28D576     (base 16)		Premier Wireless, Inc.
+				4222 E. La Palma Ave.
+				Anaheim  CA  92807
+				US
+
+70-D6-B6   (hex)		Metrum Technologies
+70D6B6     (base 16)		Metrum Technologies
+				315 South University Parks Drive
+				Waco  Texas  76701
+				US
+
+C0-A0-DE   (hex)		Multi Touch Oy
+C0A0DE     (base 16)		Multi Touch Oy
+				Henry Fordin katu 6
+				Helsinki    00150
+				FI
+
+40-BC-8B   (hex)		itelio GmbH
+40BC8B     (base 16)		itelio GmbH
+				Franz-Larcher-Straße 4
+				Kiefersfelden  Bavaria  83088
+				DE
+
+9C-A1-34   (hex)		Nike, Inc.
+9CA134     (base 16)		Nike, Inc.
+				1 Bowerman Drive
+				Beaverton  OR  97005
+				US
+
+50-FC-30   (hex)		Treehouse Labs
+50FC30     (base 16)		Treehouse Labs
+				601 Great Oaks Dr.
+				Round Rock  TX  78681
+				US
+
+B8-96-74   (hex)		AllDSP GmbH & Co. KG
+B89674     (base 16)		AllDSP GmbH & Co. KG
+				Spenglerstrasse 6
+				Hamm  NRW  59067
+				DE
+
+48-E1-AF   (hex)		Vity
+48E1AF     (base 16)		Vity
+				180 rue Pierre Landais
+				Caudan  56  56850
+				FR
+
+1C-BB-A8   (hex)		OJSC Ufimskiy Zavod Promsvyaz
+1CBBA8     (base 16)		OJSC Ufimskiy Zavod Promsvyaz
+				39, 50 let SSSR
+				Ufa  Bashkortostan  450071
+				RU
+
+00-6B-A0   (hex)		SHENZHEN UNIVERSAL INTELLISYS PTE LTD
+006BA0     (base 16)		SHENZHEN UNIVERSAL INTELLISYS PTE LTD
+				ROOM 1607-1608,XINGJI MANSION
+				SHENZHEN  GUANGDONG  518104
+				CN
+
+A8-98-C6   (hex)		Shinbo Co., Ltd.
+A898C6     (base 16)		Shinbo Co., Ltd.
+				203-14, Anyang 7-Dong, Manan-Gu
+				Anyang-Si  Kyungki-Do  430-817
+				KR
+
+B4-21-1D   (hex)		Beijing GuangXin Technology Co., Ltd
+B4211D     (base 16)		Beijing GuangXin Technology Co., Ltd
+				Room 313,B Bld,Horizon International Tower,Zhichun Road,6,Haidian District,Beijing City,P.R.China
+				Beijing    100086
+				CN
+
+90-3C-AE   (hex)		Yunnan KSEC Digital Technology Co.,Ltd.
+903CAE     (base 16)		Yunnan KSEC Digital Technology Co.,Ltd.
+				3F,NO.176 Keyi ROAD,High and New Technological Industrial Development Zone
+				Kunming  Yunnan  650106
+				CN
+
+70-70-4C   (hex)		Purple Communications, Inc
+70704C     (base 16)		Purple Communications, Inc
+				595 Menlo
+				Rocklin  CA  95765
+				US
+
+D8-97-60   (hex)		C2 Development, Inc.
+D89760     (base 16)		C2 Development, Inc.
+				127 S Bell Ave
+				Ames  IA  50010
+				US
+
+F4-7A-CC   (hex)		SolidFire, Inc.
+F47ACC     (base 16)		SolidFire, Inc.
+				1620 Pearl Street
+				Boulder  Colorado  80302
+				US
+
+90-56-82   (hex)		Lenbrook Industries Limited
+905682     (base 16)		Lenbrook Industries Limited
+				633 Granite Court
+				Pickering  Ontario  L1W 3K1
+				CA
+
+F0-DA-7C   (hex)		RLH INDUSTRIES,INC.
+F0DA7C     (base 16)		RLH INDUSTRIES,INC.
+				936 N. MAIN ST.
+				ORANGE  CA  92867
+				US
+
+AC-31-9D   (hex)		Shenzhen TG-NET Botone Technology Co.,Ltd.
+AC319D     (base 16)		Shenzhen TG-NET Botone Technology Co.,Ltd.
+				2nd floor,Building No.6,Pengtengda industrial zone,Huarong road,Dalang Street Office,
+				Shenzhen  Guangdong  518109
+				CN
+
+20-10-7A   (hex)		Gemtek Technology Co., Ltd.
+20107A     (base 16)		Gemtek Technology Co., Ltd.
+				No. 1 Jen Ai Road Hsinchu Industrial Park Hukou, Hsinchu 30352 TAIWAN, REPUBLIC OF CHINA
+				Hsinchu  TAIWAN  30352
+				TW
+
+78-DD-D6   (hex)		c-scape
+78DDD6     (base 16)		c-scape
+				westerkade 22
+				Gouda    2802 SL
+				NL
+
+C0-91-32   (hex)		Patriot Memory
+C09132     (base 16)		Patriot Memory
+				47027 Benicia
+				Fremont  CA  94555
+				US
+
+90-18-5E   (hex)		Apex Tool Group GmbH & Co OHG
+90185E     (base 16)		Apex Tool Group GmbH & Co OHG
+				Industriestraße 1
+				Westhausen    73463
+				DE
+
+F8-FE-5C   (hex)		Reciprocal Labs Corp
+F8FE5C     (base 16)		Reciprocal Labs Corp
+				3 S. Pinckney St.
+				Madison  WI  53703
+				US
+
+6C-9C-ED   (hex)		Cisco Systems, Inc
+6C9CED     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+24-86-F4   (hex)		Ctek, Inc.
+2486F4     (base 16)		Ctek, Inc.
+				34 Miraleste Plaza
+				Rancho Palos Verdes  California  90275
+				US
+
+C4-23-7A   (hex)		WhizNets Inc.
+C4237A     (base 16)		WhizNets Inc.
+				830 Stewart Drive
+				Sunnyvale  California  94085
+				US
+
+F4-E6-D7   (hex)		Solar Power Technologies, Inc.
+F4E6D7     (base 16)		Solar Power Technologies, Inc.
+				3006 Bee Caves Rd.
+				Austin  Texas  78746
+				US
+
+B8-74-24   (hex)		Viessmann Elektronik GmbH
+B87424     (base 16)		Viessmann Elektronik GmbH
+				Beetwiese 2
+				Allendorf (Eder)    35108
+				DE
+
+B4-51-F9   (hex)		NB Software
+B451F9     (base 16)		NB Software
+				Eichhalde 3
+				Weissach i. T.  Baden-Württemberg  71554
+				DE
+
+30-16-8D   (hex)		ProLon
+30168D     (base 16)		ProLon
+				17510 rue Charles, Suite 100
+				Mirabel  Quebec   J7J 1X9
+				CA
+
+E4-AF-A1   (hex)		HES-SO
+E4AFA1     (base 16)		HES-SO
+				Case postale 2134
+				Sion    1950
+				CH
+
+A8-87-ED   (hex)		ARC Wireless LLC
+A887ED     (base 16)		ARC Wireless LLC
+				6330 N. Washington St.
+				Denver  CO  80216
+				US
+
+D4-D2-49   (hex)		Power Ethernet
+D4D249     (base 16)		Power Ethernet
+				4th Floor, Holborn Gate
+				London    WC2A 1AH 
+				GB
+
+80-42-7C   (hex)		Adolf Tedsen GmbH & Co. KG
+80427C     (base 16)		Adolf Tedsen GmbH & Co. KG
+				Otto-Hahn-Str. 13-15
+				Trittau  Schleswig-Holstein  D-22946
+				DE
+
+E0-DA-DC   (hex)		JVC KENWOOD Corporation
+E0DADC     (base 16)		JVC KENWOOD Corporation
+				3-12, Moriyacho, Kanagawa-ku
+				Yokohama-shi  Kanagawa  221-0022
+				JP
+
+E8-43-B6   (hex)		QNAP Systems, Inc.
+E843B6     (base 16)		QNAP Systems, Inc.
+				2F., No.22, Zhongxing Rd., Xizhi Dist.
+				New Taipei City    221
+				TW
+
+B8-9B-C9   (hex)		SMC Networks Inc
+B89BC9     (base 16)		SMC Networks Inc
+				20 Mason 
+				Irvine  CA  92618
+				US
+
+40-9F-C7   (hex)		BAEKCHUN I&C Co., Ltd.
+409FC7     (base 16)		BAEKCHUN I&C Co., Ltd.
+				67-5, Gyesu-dong
+				Bucheon-si  Gyeonggi-do  422-070
+				KR
+
+00-FC-58   (hex)		WebSilicon Ltd.
+00FC58     (base 16)		WebSilicon Ltd.
+				25, Habarzel St.,
+				Tel-Aviv    69710
+				IL
+
+98-35-71   (hex)		Sub10 Systems Ltd
+983571     (base 16)		Sub10 Systems Ltd
+				Ash House
+				Kingsteignton  Devon  TQ12 3RZ
+				GB
+
+54-04-A6   (hex)		ASUSTek COMPUTER INC.
+5404A6     (base 16)		ASUSTek COMPUTER INC.
+				15,Li-Te Rd., Peitou, Taipei 112, Taiwan
+				Taipei  Taiwan  112
+				TW
+
+18-6D-99   (hex)		Adanis Inc.
+186D99     (base 16)		Adanis Inc.
+				#2015-2016 Geumkang Penterium
+				Hakuro, Dongan-Gu, Anyang-Si  Kyunggi-Do  431-060
+				KR
+
+A0-E2-01   (hex)		AVTrace Ltd.(China)
+A0E201     (base 16)		AVTrace Ltd.(China)
+				RM704, District B1, Originality Building, No.162 KeXue Avenue Science Town,GUANGZHOU,CHINA 
+				GUANGZHOU  GUANGDONG  510611
+				US
+
+F0-DE-B9   (hex)		ShangHai Y&Y Electronics Co., Ltd
+F0DEB9     (base 16)		ShangHai Y&Y Electronics Co., Ltd
+				No.3, 588 Tianxiong Road, Shanghai International Medical Zone(SIMZ),
+				Shanghai    201318
+				CN
+
+7C-A6-1D   (hex)		MHL, LLC
+7CA61D     (base 16)		MHL, LLC
+				1140 East Arques Avenue
+				Sunnyvale  CA  94085
+				US
+
+9C-F6-7D   (hex)		Ricardo Prague, s.r.o.
+9CF67D     (base 16)		Ricardo Prague, s.r.o.
+				Thamova 13
+				Praha 8    186 00
+				CZ
+
+F8-2F-5B   (hex)		eGauge Systems LLC
+F82F5B     (base 16)		eGauge Systems LLC
+				1510 28th St, Suite 205
+				Boulder  CO  80303
+				US
+
+98-C8-45   (hex)		PacketAccess
+98C845     (base 16)		PacketAccess
+				611 North Main Street
+				Goldfield  IA  50543
+				US
+
+98-90-80   (hex)		Linkpower Network System Inc Ltd.
+989080     (base 16)		Linkpower Network System Inc Ltd.
+				Room 202, Build 18, Shahe Industrial Zone
+				Shenzhen  Guangdong  518053
+				CN
+
+F8-33-76   (hex)		Good Mind Innovation Co., Ltd.
+F83376     (base 16)		Good Mind Innovation Co., Ltd.
+				20, Lane 200, Cheng Hu Rd. 
+				Kaohsiung    833
+				TW
+
+50-F6-1A   (hex)		Kunshan JADE Technologies co., Ltd.
+50F61A     (base 16)		Kunshan JADE Technologies co., Ltd.
+				12th Floor, Southern Building, Pudong Software Park,828 Xueyuan Road, Bacheng Town 
+				Kunshan  Jiangsu  215311
+				CN
+
+54-20-18   (hex)		Tely Labs
+542018     (base 16)		Tely Labs
+				545 Middlefield Road
+				Menlo Park  CA  94025
+				US
+
+58-1F-EF   (hex)		Tuttnaer LTD
+581FEF     (base 16)		Tuttnaer LTD
+				Har-Tuv B
+				Beith Shemesh    99000
+				IL
+
+58-BD-A3   (hex)		Nintendo Co., Ltd.
+58BDA3     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+F8-F2-5A   (hex)		G-Lab GmbH
+F8F25A     (base 16)		G-Lab GmbH
+				Schiffbaustrasse 10
+				Zurich  CH  8005
+				CH
+
+30-7E-CB   (hex)		SFR
+307ECB     (base 16)		SFR
+				40/42 Quai du point du jour
+				Boulongne Billancourt  Hauts de Seine  92659
+				FR
+
+68-F1-25   (hex)		Data Controls Inc.
+68F125     (base 16)		Data Controls Inc.
+				Fukashiro Bldg, 8F
+				Taito-ku  Tokyo  111-0052
+				JP
+
+BC-76-4E   (hex)		Rackspace US, Inc.
+BC764E     (base 16)		Rackspace US, Inc.
+				5000 Walzem Rd.
+				San Antonio  TX  78218
+				US
+
+CC-C8-D7   (hex)		CIAS Elettronica srl
+CCC8D7     (base 16)		CIAS Elettronica srl
+				Via Giovanni Durando 38
+				Milan    20158
+				IT
+
+84-D3-2A   (hex)		IEEE 1905.1
+84D32A     (base 16)		IEEE 1905.1
+				445 Hoes Lane
+				Piscataway   NJ  08855-1331
+				US
+
+4C-02-89   (hex)		LEX COMPUTECH CO., LTD
+4C0289     (base 16)		LEX COMPUTECH CO., LTD
+				3F, No.77, LI DE St. Chung Ho Dist., 
+				New Taipei City    23556
+				TW
+
+C0-E5-4E   (hex)		ARIES Embedded GmbH
+C0E54E     (base 16)		ARIES Embedded GmbH
+				Schöngeisinger Str. 84
+				 Fürstenfeldbruck    D-82256
+				DE
+
+F8-C0-01   (hex)		Juniper Networks
+F8C001     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+18-7C-81   (hex)		Valeo Vision Systems
+187C81     (base 16)		Valeo Vision Systems
+				Dunmore Road
+				County Galway    
+				IE
+
+AC-CC-8E   (hex)		Axis Communications AB
+ACCC8E     (base 16)		Axis Communications AB
+				Emdalavägen 14
+				LUND    22369
+				SE
+
+8C-94-CF   (hex)		Encell Technology, Inc.
+8C94CF     (base 16)		Encell Technology, Inc.
+				1412 Sachem Place, Suite 204
+				Charlottesville  VA  22901
+				US
+
+6C-A7-80   (hex)		Nokia Corporation
+6CA780     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+30-57-AC   (hex)		IRLAB LTD.
+3057AC     (base 16)		IRLAB LTD.
+				3rd Floor, 2A Biulding, Huihao Industrial Park
+				Shenzhen  Guang Dong  518106
+				CN
+
+84-2B-50   (hex)		Huria Co.,Ltd.
+842B50     (base 16)		Huria Co.,Ltd.
+				#190-28 Chungchun-2Dong
+				Incheon    403-032
+				KR
+
+48-F7-F1   (hex)		Nokia
+48F7F1     (base 16)		Nokia
+				600 March Road
+				Kanata  Ontario  K2K 2E6
+				CA
+
+8C-8E-76   (hex)		taskit GmbH
+8C8E76     (base 16)		taskit GmbH
+				Groß-Berliner Damm 37
+				Berlin    12487
+				DE
+
+A0-13-3B   (hex)		HiTi Digital, Inc.
+A0133B     (base 16)		HiTi Digital, Inc.
+				9F., No.225, Sec. 3, Beixin Rd., Xindian Dist.,
+				Xindian Dist.  New Taipei City  231
+				TW
+
+9C-57-11   (hex)		Feitian Xunda(Beijing) Aeronautical Information Technology Co., Ltd.
+9C5711     (base 16)		Feitian Xunda(Beijing) Aeronautical Information Technology Co., Ltd.
+				Building B,Horizon International Tower,No.6 Zhichun Rd,Haidian District,
+				Beijing    100088
+				CN
+
+88-F4-88   (hex)		cellon communications technology(shenzhen)Co.,Ltd.
+88F488     (base 16)		cellon communications technology(shenzhen)Co.,Ltd.
+				13/F C Building,Gaoxin S.Ave.,Hi-Tech Industrial Park,Nanshan,shenzhen518057,PRC
+				shenzhen  Guangdong  518057
+				CN
+
+44-8E-12   (hex)		DT Research, Inc.
+448E12     (base 16)		DT Research, Inc.
+				2000 Concourse Drive 
+				San Jose  CA  95131
+				US
+
+B8-BB-6D   (hex)		ENERES Co.,Ltd.
+B8BB6D     (base 16)		ENERES Co.,Ltd.
+				1907 Tokyo Art Center
+				Adahci-ku  Tokyo  120-0034
+				JP
+
+14-37-3B   (hex)		PROCOM Systems
+14373B     (base 16)		PROCOM Systems
+				#1001, Kranz Techno, 5442-1
+				Seongnam-si  Gyunggi-do  462-729
+				KR
+
+18-97-FF   (hex)		TechFaith Wireless Technology Limited
+1897FF     (base 16)		TechFaith Wireless Technology Limited
+				Building C, Jia No.5, Rongchang East Street, BDA District, 
+				Beijing    100176
+				CN
+
+4C-55-85   (hex)		Hamilton Systems
+4C5585     (base 16)		Hamilton Systems
+				3143 Production Drive
+				Fairfield  OH  45014
+				US
+
+EC-EA-03   (hex)		DARFON LIGHTING CORP
+ECEA03     (base 16)		DARFON LIGHTING CORP
+				167, Shanying Road
+				Gueishan  Taoyuan  33341
+				TW
+
+30-F9-ED   (hex)		Sony Corporation
+30F9ED     (base 16)		Sony Corporation
+				Gotenyama Tec 5-1-2
+				Tokyo  Shinagawa-ku  141-0001
+				JP
+
+58-2E-FE   (hex)		Lighting Science Group
+582EFE     (base 16)		Lighting Science Group
+				1227 South Patrick Drive
+				Satellite Beach  FL  32937
+				US
+
+CC-60-BB   (hex)		Empower RF Systems
+CC60BB     (base 16)		Empower RF Systems
+				316 W. Florence Ave
+				Inglewood  CA  90301
+				US
+
+7C-DD-20   (hex)		IOXOS Technologies S.A.
+7CDD20     (base 16)		IOXOS Technologies S.A.
+				4 Chemin de Fontenailles
+				GLAND  VAUD  CH-1196
+				CH
+
+EC-F2-36   (hex)		NEOMONTANA ELECTRONICS
+ECF236     (base 16)		NEOMONTANA ELECTRONICS
+				Mladost-4, bl. 483, mag. 13
+				Sofia    1715
+				BG
+
+04-18-B6   (hex)		Private
+0418B6     (base 16)		Private
+
+E4-A5-EF   (hex)		TRON LINK ELECTRONICS CO., LTD.
+E4A5EF     (base 16)		TRON LINK ELECTRONICS CO., LTD.
+				FLAT A, 20/F., BLOCK 4,ON NING GARDEN,
+				KOWLOON    999077
+				HK
+
+30-71-B2   (hex)		Hangzhou Prevail Optoelectronic Equipment Co.,LTD.
+3071B2     (base 16)		Hangzhou Prevail Optoelectronic Equipment Co.,LTD.
+				Industrial Development Area, Guali Town,
+				Hangzhou City  Zhe Jiang  311241
+				CN
+
+DC-CE-41   (hex)		FE GLOBAL HONG KONG LIMITED
+DCCE41     (base 16)		FE GLOBAL HONG KONG LIMITED
+				FLAT 204-205 2/F LAFORD CENTRE838 LAI CHI KOK RD CHEUNG SHA WAN KL
+				SHENZHEN    518057
+				CN
+
+FC-6C-31   (hex)		LXinstruments GmbH
+FC6C31     (base 16)		LXinstruments GmbH
+				Herrenberger Str. 130
+				Boeblingen    71034
+				DE
+
+70-5C-AD   (hex)		Konami Gaming Inc
+705CAD     (base 16)		Konami Gaming Inc
+				585 Trade Center Drive
+				Las Vegas  Nevada  89119
+				US
+
+3C-6F-45   (hex)		Fiberpro Inc.
+3C6F45     (base 16)		Fiberpro Inc.
+				59-4 Jang-dong, Yusong-gu
+				  Deajeon  305-343
+				KR
+
+70-31-87   (hex)		ACX GmbH
+703187     (base 16)		ACX GmbH
+				Äußere Zwickauer Straße 8
+				Zwickau    08064
+				DE
+
+30-E4-DB   (hex)		Cisco Systems, Inc
+30E4DB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+88-E0-F3   (hex)		Juniper Networks
+88E0F3     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+80-97-1B   (hex)		Altenergy Power System,Inc.
+80971B     (base 16)		Altenergy Power System,Inc.
+				No.1 Yatai Road, 
+				Jiaxing City,    Zhejiang Province,  314050
+				CN
+
+58-76-75   (hex)		Beijing ECHO Technologies Co.,Ltd
+587675     (base 16)		Beijing ECHO Technologies Co.,Ltd
+				NO1 Street 4 Shangdi  
+				BeiJing    100085
+				CN
+
+0C-51-F7   (hex)		CHAUVIN ARNOUX
+0C51F7     (base 16)		CHAUVIN ARNOUX
+				LA QUEUE DEVEE
+				REUX  PONT L EVEQUE  14130
+				FR
+
+0C-FC-83   (hex)		Airoha Technology Corp.,
+0CFC83     (base 16)		Airoha Technology Corp.,
+				5F, No.6-5, Dushing Road , Hsinchu Science Park
+				Hsinchu    300
+				TW
+
+00-7F-28   (hex)		Actiontec Electronics, Inc
+007F28     (base 16)		Actiontec Electronics, Inc
+				3301 Olcott St.
+				Santa Clara  CA  95054
+				US
+
+80-47-31   (hex)		Packet Design, Inc.
+804731     (base 16)		Packet Design, Inc.
+				2455 Augustine Drive
+				Santa Clara  CA  95054
+				US
+
+B0-9B-D4   (hex)		GNH Software India Private Limited
+B09BD4     (base 16)		GNH Software India Private Limited
+				9/14 Sengani Amman Koil Street
+				Chennai  Tamilnadu  600032
+				IN
+
+F0-8B-FE   (hex)		COSTEL.,CO.LTD
+F08BFE     (base 16)		COSTEL.,CO.LTD
+				223-39, Sangdaewon-Dong, Jungwon-Gu
+				Seongnam-si  Kyunggi-Do  462-807
+				KR
+
+3C-26-D5   (hex)		Sotera Wireless
+3C26D5     (base 16)		Sotera Wireless
+				9444 Waples Street
+				San Diego  CA  92121
+				US
+
+E8-4E-06   (hex)		EDUP INTERNATIONAL (HK) CO., LTD
+E84E06     (base 16)		EDUP INTERNATIONAL (HK) CO., LTD
+				20D Room, Block B, Modern Windows Buidling, FuTian District,
+				Shenzhen  Guangdong  518028
+				CN
+
+00-07-7D   (hex)		Cisco Systems, Inc
+00077D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+CC-D9-E9   (hex)		SCR Engineers Ltd.
+CCD9E9     (base 16)		SCR Engineers Ltd.
+				6 Haomanut St.
+				Netanya    42504
+				IL
+
+34-A7-09   (hex)		Trevil srl
+34A709     (base 16)		Trevil srl
+				Via Copernico 1
+				Pozzo d'Adda  MI  20060
+				IT
+
+E0-C9-22   (hex)		Jireh Energy Tech., Ltd.
+E0C922     (base 16)		Jireh Energy Tech., Ltd.
+				#606 Seoul Forest Hallasigmavalley, 325-2
+				Seoul  Seongdong-Gu  133-120
+				KR
+
+90-5F-8D   (hex)		modas GmbH
+905F8D     (base 16)		modas GmbH
+				Belziger Str. 69-71
+				Berlin    10823
+				DE
+
+98-29-3F   (hex)		Fujian Start Computer Equipment Co.,Ltd
+98293F     (base 16)		Fujian Start Computer Equipment Co.,Ltd
+				No.68 Hongshangyuan Road,  
+				Fuzhou City,   Fujian Province,  350002
+				CN
+
+B4-5C-A4   (hex)		Thing-talk Wireless Communication Technologies Corporation Limited
+B45CA4     (base 16)		Thing-talk Wireless Communication Technologies Corporation Limited
+				498 Guo Shou Jing Road, Suite 10402
+				Shanghai    201203
+				CN
+
+90-8D-1D   (hex)		GH Technologies
+908D1D     (base 16)		GH Technologies
+				5022 Binhe Road, Block B, United Plaza
+				Shenzhen    518026
+				CN
+
+44-4F-5E   (hex)		Pan Studios Co.,Ltd.
+444F5E     (base 16)		Pan Studios Co.,Ltd.
+				1F., NO.402, SEC. 2, JHONGYANG N. RD., BEITOU DISTRICT,
+				TAIPEI CITY     11258
+				TW
+
+D0-AF-B6   (hex)		Linktop Technology Co., LTD
+D0AFB6     (base 16)		Linktop Technology Co., LTD
+				2F Guangye Buliding, Torch Hi-Tech, 
+				Xiamen  Fujian  361006
+				CN
+
+98-EC-65   (hex)		Cosesy ApS
+98EC65     (base 16)		Cosesy ApS
+				Tyttebaervej 2
+				Ans  Jylland  DK-8643
+				DK
+
+AC-C9-35   (hex)		Ness Corporation
+ACC935     (base 16)		Ness Corporation
+				4/167 Prospect Highway
+				Sydney  NSW  2147
+				AU
+
+00-8D-4E   (hex)		CJSC NII STT
+008D4E     (base 16)		CJSC NII STT
+				N.Leningradskaya str, 10
+				Smolensk    214012
+				RU
+
+98-F8-DB   (hex)		Marini Impianti Industriali s.r.l.
+98F8DB     (base 16)		Marini Impianti Industriali s.r.l.
+				Via delle Province, 6A
+				Cisterna di Latina    04012
+				IT
+
+E4-12-89   (hex)		topsystem Systemhaus GmbH
+E41289     (base 16)		topsystem Systemhaus GmbH
+				Monnetstraße 24
+				Würselen  NRW  52146
+				DE
+
+58-E8-08   (hex)		AUTONICS CORPORATION
+58E808     (base 16)		AUTONICS CORPORATION
+				41-5 YONGDANG-DONG
+				YANGSAN-SI  KYEONGNAM  626-847
+				KR
+
+DC-05-ED   (hex)		Nabtesco  Corporation
+DC05ED     (base 16)		Nabtesco  Corporation
+				9-18, Kaigan 1-chome
+				Minato-ku  Tokyo  105-0022
+				JP
+
+4C-98-EF   (hex)		Zeo
+4C98EF     (base 16)		Zeo
+				320 Nevada St
+				Newton   MA  02460
+				US
+
+00-A1-DE   (hex)		ShenZhen ShiHua Technology CO.,LTD
+00A1DE     (base 16)		ShenZhen ShiHua Technology CO.,LTD
+				Room505,5/F TsingYi Building,LangShan 2ed Road,High-Tech Industrial Park,
+				ShenZhen  GuangDong  518052
+				CN
+
+80-6C-BC   (hex)		NET New Electronic Technology GmbH
+806CBC     (base 16)		NET New Electronic Technology GmbH
+				Lerchenberg 7
+				Finning  Bavarian  86923
+				DE
+
+90-90-60   (hex)		RSI VIDEO TECHNOLOGIES
+909060     (base 16)		RSI VIDEO TECHNOLOGIES
+				56, Rue Jean-Giraudoux - BAT 60
+				STRASBOURG  Bas-Rhin  67200
+				FR
+
+BC-81-99   (hex)		BASIC Co.,Ltd.
+BC8199     (base 16)		BASIC Co.,Ltd.
+				Keiefu-Building 9F
+				Minato-ku  Tokyo  108-0014
+				JP
+
+DC-A7-D9   (hex)		Compressor Controls Corp
+DCA7D9     (base 16)		Compressor Controls Corp
+				4725 121st Street
+				Des Moines  Iowa  50323
+				US
+
+38-FE-C5   (hex)		Ellips B.V.
+38FEC5     (base 16)		Ellips B.V.
+				Esp 300
+				Eindhoven  Noord-Brabant  5633 AE
+				NL
+
+C4-55-A6   (hex)		Cadac Holdings Ltd
+C455A6     (base 16)		Cadac Holdings Ltd
+				1 New Street
+				Luton  Bedfordshire  LU1 5DX
+				GB
+
+5C-77-57   (hex)		Haivision Network Video
+5C7757     (base 16)		Haivision Network Video
+				4445 Garand
+				Montreal  QC  H4R 2H9
+				CA
+
+D4-D8-98   (hex)		Korea CNO Tech Co., Ltd
+D4D898     (base 16)		Korea CNO Tech Co., Ltd
+				#240-1,Uigok-Ri
+				Mungyeong-Si  Gyeongsangbuk-do  745-853
+				KR
+
+B4-AA-4D   (hex)		Ensequence, Inc.
+B4AA4D     (base 16)		Ensequence, Inc.
+				111 SW 5th Ave Suite 1400
+				Portland  OR  97204
+				US
+
+B8-3D-4E   (hex)		Shenzhen Cultraview Digital Technology Co.,Ltd Shanghai Branch
+B83D4E     (base 16)		Shenzhen Cultraview Digital Technology Co.,Ltd Shanghai Branch
+				2/F,Building#5,1690Cailun Road,Zhangjiang Hi-tech Park,
+				Shanghai    201203
+				CN
+
+50-87-B8   (hex)		Nuvyyo Inc
+5087B8     (base 16)		Nuvyyo Inc
+				1 Smythe Rd
+				Carleton Place  Ontario  K7C4J4
+				CA
+
+C0-EA-E4   (hex)		Sonicwall
+C0EAE4     (base 16)		Sonicwall
+				2001 Logic Drive
+				San Jose  CA  95124-3452
+				US
+
+08-38-A5   (hex)		Funkwerk plettac electronic GmbH
+0838A5     (base 16)		Funkwerk plettac electronic GmbH
+				Wuerzburger Str. 150
+				Fuerth  Bavaria  90766
+				DE
+
+CC-1E-FF   (hex)		Metrological Group BV
+CC1EFF     (base 16)		Metrological Group BV
+				Mariniersweg 151
+				Rotterdam  Zuid-Holland  3011NK
+				NL
+
+18-4E-94   (hex)		MESSOA TECHNOLOGIES INC.
+184E94     (base 16)		MESSOA TECHNOLOGIES INC.
+				13611 12th St., Unit B
+				Chino  CA  91710
+				US
+
+6C-39-1D   (hex)		Beijing ZhongHuaHun Network Information center
+6C391D     (base 16)		Beijing ZhongHuaHun Network Information center
+				6F BeiAo Mansion,HuiXin East Street A2,
+				Beijing    100029
+				CN
+
+80-B3-2A   (hex)		UK Grid Solutions Ltd
+80B32A     (base 16)		UK Grid Solutions Ltd
+				Harry Kerr Drive
+				Stafford   Staffordshire  ST17 4LX
+				GB
+
+40-55-39   (hex)		Cisco Systems, Inc
+405539     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+E0-F2-11   (hex)		Digitalwatt
+E0F211     (base 16)		Digitalwatt
+				Via Dante, 18
+				Renate Brianza  MB  20055
+				IT
+
+F8-69-71   (hex)		Seibu Electric Co.,
+F86971     (base 16)		Seibu Electric Co.,
+				1458-7
+				Hachioji  Tokyo  193-0941
+				JP
+
+44-AA-27   (hex)		udworks Co., Ltd.
+44AA27     (base 16)		udworks Co., Ltd.
+				#810, Byuksan3cha Digital Valley, 212-13, Guro-dong, Guro-gu
+				Seoul    152-775
+				KR
+
+E8-F9-28   (hex)		RFTECH SRL
+E8F928     (base 16)		RFTECH SRL
+				VIA VENETO, 22
+				SCHIO  VICENZA  36015
+				IT
+
+1C-95-5D   (hex)		I-LAX ELECTRONICS INC.
+1C955D     (base 16)		I-LAX ELECTRONICS INC.
+				2283 ARGENTIA RD.- UNIT # 10
+				MISSISSAUGA  ON.  L5N 5Z2
+				CA
+
+60-F5-9C   (hex)		CRU-Dataport
+60F59C     (base 16)		CRU-Dataport
+				1000 SE Tech Center Drive
+				Vancouver  WA  98683
+				US
+
+B0-A7-2A   (hex)		Ensemble Designs, Inc.
+B0A72A     (base 16)		Ensemble Designs, Inc.
+				870 Gold Flat Road
+				Nevada City  CA  95959
+				US
+
+64-00-F1   (hex)		Cisco Systems, Inc
+6400F1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+B8-F4-D0   (hex)		Herrmann Ultraschalltechnik GmbH & Co. Kg
+B8F4D0     (base 16)		Herrmann Ultraschalltechnik GmbH & Co. Kg
+				Descostraße 3-9
+				Karlsbad  Baden-Württemberg  76307
+				DE
+
+08-AC-A5   (hex)		Benu Video, Inc.
+08ACA5     (base 16)		Benu Video, Inc.
+				300 Concord Rd., Suite #110
+				Billerica  MA  01821
+				US
+
+58-6D-8F   (hex)		Cisco-Linksys, LLC
+586D8F     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+10-E3-C7   (hex)		Seohwa Telecom
+10E3C7     (base 16)		Seohwa Telecom
+				678 Seohwa Bldg
+				Gasan-Dong, Gumcheon-Gu  Seoul  153-803
+				KR
+
+74-65-D1   (hex)		Atlinks
+7465D1     (base 16)		Atlinks
+				30 Avenue Geroge V
+				Paris    75008
+				FR
+
+04-0A-83   (hex)		Alcatel-Lucent
+040A83     (base 16)		Alcatel-Lucent
+				Via Trento, 30
+				Vimenrcate  MB  2059
+				IT
+
+C4-56-00   (hex)		Galleon Embedded Computing
+C45600     (base 16)		Galleon Embedded Computing
+				Grenseveien 97c
+				Oslo  Oslo  N-0602
+				NO
+
+BC-3E-13   (hex)		Accordance Systems Inc.
+BC3E13     (base 16)		Accordance Systems Inc.
+				2F, No. 31, Sec. 6, Hsin Yi Road
+				Taipei    11085
+				TW
+
+A8-1B-18   (hex)		XTS CORP
+A81B18     (base 16)		XTS CORP
+				10125 NW 116TH WAY, SUITE 5
+				MEDLEY  FLORIDA  33178
+				US
+
+D0-A3-11   (hex)		Neuberger Gebäudeautomation GmbH
+D0A311     (base 16)		Neuberger Gebäudeautomation GmbH
+				Oberer Kaiserweg 6
+				Rothenburg o.d.T.  Bayern  91541
+				DE
+
+04-1D-10   (hex)		Dream Ware Inc.
+041D10     (base 16)		Dream Ware Inc.
+				5-23-7 Masugata, Tama-ku,
+				Kawasaki  Kanagawa  214-0032
+				JP
+
+80-14-40   (hex)		Sunlit System Technology Corp
+801440     (base 16)		Sunlit System Technology Corp
+				8F, No.19,Lane 120, Sec1, Neihu Rd.
+				Tapiei    114
+				TW
+
+18-0B-52   (hex)		Nanotron Technologies GmbH
+180B52     (base 16)		Nanotron Technologies GmbH
+				Alt-Moabit 60
+				Berlin    10555
+				DE
+
+DC-07-C1   (hex)		HangZhou QiYang Technology Co.,Ltd.
+DC07C1     (base 16)		HangZhou QiYang Technology Co.,Ltd.
+				Floor 5, Building 2, Road XiYuanYi, WestLake Technology Park,
+				HangZhou  ZheJiang  310028
+				CN
+
+C0-A2-6D   (hex)		Abbott Point of Care
+C0A26D     (base 16)		Abbott Point of Care
+				400 College Road East
+				Princeton  NJ  08540
+				US
+
+00-BB-8E   (hex)		HME Co., Ltd.
+00BB8E     (base 16)		HME Co., Ltd.
+				No.200 , Liao Bei Str.,San Min Dist.,
+				Kaohsiung    807
+				TW
+
+D8-2A-7E   (hex)		Nokia Corporation
+D82A7E     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+80-1F-02   (hex)		Edimax Technology Co. Ltd.
+801F02     (base 16)		Edimax Technology Co. Ltd.
+				No. 278, Xinhu 1st Road
+				Taipei City  Neihu Dist  248
+				TW
+
+58-EE-CE   (hex)		Icon Time Systems
+58EECE     (base 16)		Icon Time Systems
+				15201 NW Greenbrier Parkway
+				Beaverton  OR  97006
+				US
+
+64-7F-DA   (hex)		TEKTELIC Communications Inc.
+647FDA     (base 16)		TEKTELIC Communications Inc.
+				7657 10th Street NE
+				Calgary  Alberta  T2E 8X2
+				CA
+
+AC-06-13   (hex)		Senselogix Ltd
+AC0613     (base 16)		Senselogix Ltd
+				56 Carlton Court, Ford William Morgan
+				St. Asaph  Debighshire  LL17 0JG
+				GB
+
+74-78-18   (hex)		Jurumani Solutions
+747818     (base 16)		Jurumani Solutions
+				321 14th Road
+				Midrand    1685
+				ZA
+
+E0-1F-0A   (hex)		Xslent Energy Technologies. LLC
+E01F0A     (base 16)		Xslent Energy Technologies. LLC
+				7428 Redwood Blvd
+				Novato  CA  94945
+				US
+
+44-37-19   (hex)		2 Save Energy Ltd
+443719     (base 16)		2 Save Energy Ltd
+				The Annexe, Field House Barn
+				Sherborne St John  Hampshire  RG24 9LR
+				GB
+
+84-EA-99   (hex)		Vieworks
+84EA99     (base 16)		Vieworks
+				6F Suntechcity 2,307-2 Sangdaewon-dong, Jungwon-gu
+				Seongnam   Gyeonggi  462-806
+				KR
+
+E0-0C-7F   (hex)		Nintendo Co., Ltd.
+E00C7F     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+E4-8A-D5   (hex)		RF WINDOW CO., LTD.
+E48AD5     (base 16)		RF WINDOW CO., LTD.
+				14F, Daerung Posttower3
+				Seoul    152-746
+				KR
+
+FC-F1-CD   (hex)		OPTEX-FA CO.,LTD.
+FCF1CD     (base 16)		OPTEX-FA CO.,LTD.
+				91 Awata-cho
+				Kyoto    600-8815
+				JP
+
+44-25-BB   (hex)		Bamboo Entertainment Corporation
+4425BB     (base 16)		Bamboo Entertainment Corporation
+				179 South Street
+				Boston  MA  02111
+				US
+
+7C-DA-84   (hex)		Dongnian Networks Inc.
+7CDA84     (base 16)		Dongnian Networks Inc.
+				90 Wensan Road, Building 8-A303
+				Hangzhou  Zhejiang  310012
+				CN
+
+BC-C6-1A   (hex)		SPECTRA EMBEDDED SYSTEMS
+BCC61A     (base 16)		SPECTRA EMBEDDED SYSTEMS
+				Khasra No. 24, Village Ghumman,1st Floor, Chawla Mansion,
+				Parwanoo  Himachal Pradesh  173 220
+				IN
+
+04-70-BC   (hex)		Globalstar Inc.
+0470BC     (base 16)		Globalstar Inc.
+				461 S Milpitas Blvd
+				Milpitas  CA  95035
+				US
+
+88-DD-79   (hex)		Voltaire
+88DD79     (base 16)		Voltaire
+				13, Zarchin St
+				Raanana    43662
+				IL
+
+64-F9-87   (hex)		Avvasi Inc.
+64F987     (base 16)		Avvasi Inc.
+				103 Randall Dr.
+				Waterloo  ON  N2V 1C5
+				CA
+
+D8-5D-84   (hex)		CAx soft GmbH
+D85D84     (base 16)		CAx soft GmbH
+				Noettinger Strasse 3
+				Karlsbad  BW  76307
+				DE
+
+D4-E3-2C   (hex)		S. Siedle & Sohne
+D4E32C     (base 16)		S. Siedle & Sohne
+				Bregstrasse 1
+				Furtwangen    D-78120
+				DE
+
+7C-6A-DB   (hex)		SafeTone Technology Co.,Ltd
+7C6ADB     (base 16)		SafeTone Technology Co.,Ltd
+				Room 323,ZhuouJi Plaza,No.16 AnDe Road,East District,
+				Beijing    100011
+				CN
+
+90-2E-87   (hex)		LabJack
+902E87     (base 16)		LabJack
+				3232 S Vance St STE 100
+				Lakewood  CO  80227
+				US
+
+A4-24-B3   (hex)		FlatFrog Laboratories AB
+A424B3     (base 16)		FlatFrog Laboratories AB
+				Magistratsvägen 10
+				Lund  Skåne  22643
+				SE
+
+94-CD-AC   (hex)		Creowave Oy
+94CDAC     (base 16)		Creowave Oy
+				Lentokatu 2
+				Oulunsalo    FIN-90460
+				FI
+
+14-4C-1A   (hex)		Max Communication GmbH
+144C1A     (base 16)		Max Communication GmbH
+				Siemensstrasse 47
+				Rellingen    25462
+				DE
+
+34-08-04   (hex)		D-Link Corporation
+340804     (base 16)		D-Link Corporation
+				No.289, Sinhu 3rd Rd., Neihu District, 
+				Taipei City     114
+				TW
+
+F0-5D-89   (hex)		Dycon Limited
+F05D89     (base 16)		Dycon Limited
+				Unit D
+				Mountain Ash  Rhondda Cynon Taff  CF45 4ER
+				GB
+
+AC-80-D6   (hex)		Hexatronic AB
+AC80D6     (base 16)		Hexatronic AB
+				Exportgatan 47B
+				Gothenburg    42246 
+				SE
+
+9C-F9-38   (hex)		AREVA NP GmbH
+9CF938     (base 16)		AREVA NP GmbH
+				Seligenstaedter Str. 100
+				Karlstein  Germany  63791
+				DE
+
+8C-DB-25   (hex)		ESG Solutions
+8CDB25     (base 16)		ESG Solutions
+				20 Hyperion Court
+				Kingston  Ontario  K7K 7K2
+				CA
+
+FC-35-98   (hex)		Favite Inc.
+FC3598     (base 16)		Favite Inc.
+				No.19, Lane 78, Yanhe St.,
+				Jhubei City  Hsinchu County  302
+				TW
+
+90-D9-2C   (hex)		HUG-WITSCHI AG
+90D92C     (base 16)		HUG-WITSCHI AG
+				Auriedstrasse 10
+				Boesingen  Fribourg  3178
+				CH
+
+98-8E-34   (hex)		ZHEJIANG BOXSAM ELECTRONIC CO.,LTD
+988E34     (base 16)		ZHEJIANG BOXSAM ELECTRONIC CO.,LTD
+				No.288,LONGTAN ROAD,
+				JINHUA CITY  ZHEJIANG PROVINCE,  321017
+				CN
+
+C4-71-FE   (hex)		Cisco Systems, Inc
+C471FE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+40-22-ED   (hex)		Digital Projection Ltd
+4022ED     (base 16)		Digital Projection Ltd
+				Greenside Way
+				Manchester  Lancs  M24 1XX
+				GB
+
+98-94-49   (hex)		Skyworth Wireless Technology Ltd.
+989449     (base 16)		Skyworth Wireless Technology Ltd.
+				Unit A Rm.3A01, Skyworth Bldg., Gaoxin Ave. 1.S.,
+				Nanshan District  Shenzhen  518057
+				CN
+
+2C-A1-57   (hex)		acromate, Inc.
+2CA157     (base 16)		acromate, Inc.
+				#1101, JnK Digital Tower, 111
+				Seoul    152-848
+				KR
+
+94-20-53   (hex)		Nokia Corporation
+942053     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+28-85-2D   (hex)		Touch Networks
+28852D     (base 16)		Touch Networks
+				2515 152nd Ave NE
+				Redmond  Washington  98052
+				US
+
+B8-BA-68   (hex)		Xi'an Jizhong Digital Communication Co.,Ltd
+B8BA68     (base 16)		Xi'an Jizhong Digital Communication Co.,Ltd
+				10 Block NO.1 Enterprise Newly-typed Industrial Zone High-Tech Zone Xi¡¯an,China
+				Xi'an  ShaanXi  710119
+				CN
+
+B0-B3-2B   (hex)		Slican Sp. z o.o.
+B0B32B     (base 16)		Slican Sp. z o.o.
+				M. Konopnickiej 18
+				Bydgoszcz  Kujawsko-Pomorskie  85-124
+				PL
+
+58-42-E4   (hex)		Baxter International Inc
+5842E4     (base 16)		Baxter International Inc
+				One Baxter Parkway
+				Deerfield  IL  60015
+				US
+
+B8-79-7E   (hex)		Secure Meters (UK) Limited
+B8797E     (base 16)		Secure Meters (UK) Limited
+				Secure House
+				Winchester  Hampshire  SO23 7RX
+				GB
+
+CC-9E-00   (hex)		Nintendo Co., Ltd.
+CC9E00     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+58-A7-6F   (hex)		iD corporation
+58A76F     (base 16)		iD corporation
+				goryokaku bld. 2F
+				hakodate  hokkaido  040-0011
+				JP
+
+00-06-F6   (hex)		Cisco Systems, Inc
+0006F6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+74-7D-B6   (hex)		Aliwei Communications, Inc
+747DB6     (base 16)		Aliwei Communications, Inc
+				Keji 6 Road , Hi-tech Industrial Park  
+				Shenzhen  Guangdong  518057
+				CN
+
+B0-65-63   (hex)		Shanghai Railway Communication Factory
+B06563     (base 16)		Shanghai Railway Communication Factory
+				No.179 West Jiangchang road
+				Shanghai    200436
+				CN
+
+40-18-D7   (hex)		Smartronix, Inc.
+4018D7     (base 16)		Smartronix, Inc.
+				44150 Smartronix Way
+				Hollywood  MD  20636
+				US
+
+4C-2C-80   (hex)		Beijing Skyway Technologies Co.,Ltd 
+4C2C80     (base 16)		Beijing Skyway Technologies Co.,Ltd 
+				No.5 Jiangtai Road, 
+				Beijing    100015
+				CN
+
+D4-9E-6D   (hex)		Wuhan Zhongyuan Huadian Science & Technology Co.,
+D49E6D     (base 16)		Wuhan Zhongyuan Huadian Science & Technology Co.,
+				NO.6, 6 Road, Sci. & Tech. region of HUST, East Lake Development Zone,
+				Wuhan   Hubei  430223
+				CN
+
+6C-2E-33   (hex)		Accelink Technologies Co.,Ltd.
+6C2E33     (base 16)		Accelink Technologies Co.,Ltd.
+				88 Youkeyuan Road,
+				Wuhan  Hubei  430074
+				CN
+
+40-98-7B   (hex)		Aisino Corporation
+40987B     (base 16)		Aisino Corporation
+				No.18 A,Xingshikou Road,Haidian District,
+				Beijing    100195
+				CN
+
+BC-38-D2   (hex)		Pandachip Limited
+BC38D2     (base 16)		Pandachip Limited
+				Unit 210, 2/F (Lakeside 1), Building 15, No. 8 Science Park West Avenue
+				Shatin, N.T.    
+				HK
+
+20-05-E8   (hex)		OOO InProMedia
+2005E8     (base 16)		OOO InProMedia
+				pr.4806, d.6
+				Zelenograd  Moscow  124466
+				RU
+
+F0-02-48   (hex)		SmarteBuilding
+F00248     (base 16)		SmarteBuilding
+				3267 Bee Cave Road
+				Austin  TX  78746
+				US
+
+AC-6F-4F   (hex)		Enspert Inc
+AC6F4F     (base 16)		Enspert Inc
+				2F., Daehwa B/D, 
+				Seoul    135090
+				KR
+
+E8-28-77   (hex)		TMY Co., Ltd.
+E82877     (base 16)		TMY Co., Ltd.
+				Attic Bldg. 3F, 1-2-10 Ise-cho,
+				Ashikaga-shi  Tochigi  326-0053
+				JP
+
+F0-C8-8C   (hex)		LeddarTech Inc.
+F0C88C     (base 16)		LeddarTech Inc.
+				2740 Einstein Street
+				Quebec City    G1P 4S4
+				CA
+
+40-37-AD   (hex)		Macro Image Technology, Inc.
+4037AD     (base 16)		Macro Image Technology, Inc.
+				East Bldg., 6th Floor, IT Venture Tower,
+				Seoul    138-950
+				KR
+
+28-ED-58   (hex)		JAG Jakob AG
+28ED58     (base 16)		JAG Jakob AG
+				Industriestrasse 20
+				BRUEGG  BE  2555
+				CH
+
+48-6B-91   (hex)		Fleetwood Group Inc.
+486B91     (base 16)		Fleetwood Group Inc.
+				11832 James St
+				Holland  Michigan  49424
+				US
+
+64-34-09   (hex)		BITwave Pte Ltd
+643409     (base 16)		BITwave Pte Ltd
+				2 Serangoon North Ave 5
+				    554911
+				SG
+
+40-C2-45   (hex)		Shenzhen Hexicom Technology Co., Ltd.
+40C245     (base 16)		Shenzhen Hexicom Technology Co., Ltd.
+				1510 West Building,Nanshan Software Park, Nanshan Dist.
+				Shenzhen  Guangdong  518053
+				CN
+
+CC-55-AD   (hex)		RIM
+CC55AD     (base 16)		RIM
+				Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+E8-75-7F   (hex)		FIRS Technologies(Shenzhen) Co., Ltd
+E8757F     (base 16)		FIRS Technologies(Shenzhen) Co., Ltd
+				Rm 12A, Area A, Hongsong Business Building, Tairan 9th Rd, Chegongmiao, 
+				Shenzhen  Guangdong  518040
+				CN
+
+F0-F7-B3   (hex)		Phorm
+F0F7B3     (base 16)		Phorm
+				222 Regent Street
+				London    W1B 5TR
+				GB
+
+00-D3-8D   (hex)		Hotel Technology Next Generation
+00D38D     (base 16)		Hotel Technology Next Generation
+				650 E. Algonquin Road
+				Schaumburg  IL  60173
+				US
+
+C8-3E-A7   (hex)		KUNBUS GmbH
+C83EA7     (base 16)		KUNBUS GmbH
+				Heerweg 15C
+				Denkendorf  BW  D-73770
+				DE
+
+60-89-3C   (hex)		Thermo Fisher Scientific P.O.A.
+60893C     (base 16)		Thermo Fisher Scientific P.O.A.
+				46 Jonspin Rd.
+				Wilmington  MA  01887
+				US
+
+D8-6B-F7   (hex)		Nintendo Co., Ltd.
+D86BF7     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+74-CD-0C   (hex)		Smith Myers Communications Ltd.
+74CD0C     (base 16)		Smith Myers Communications Ltd.
+				The Omega Centre
+				Biggleswade  BEDS  SG18 8QB
+				GB
+
+CC-CE-40   (hex)		Janteq Corp
+CCCE40     (base 16)		Janteq Corp
+				9272 Jeronimo Road
+				Irvine  CA  92618
+				US
+
+B8-EE-79   (hex)		YWire Technologies, Inc.
+B8EE79     (base 16)		YWire Technologies, Inc.
+				1372 Overdale
+				Montreal  QC  H3G 1V3
+				CA
+
+74-D6-75   (hex)		WYMA Tecnologia
+74D675     (base 16)		WYMA Tecnologia
+				Rua Clímaco Barbosa, 171-179
+				São Paulo    01523-000
+				BR
+
+B4-0E-DC   (hex)		LG-Ericsson Co.,Ltd.
+B40EDC     (base 16)		LG-Ericsson Co.,Ltd.
+				533,Hogye-1dong,Dongan-gu
+				Anyang-shi  Kyungki-do  431-749
+				KR
+
+E0-EE-1B   (hex)		Panasonic Automotive Systems Company of America
+E0EE1B     (base 16)		Panasonic Automotive Systems Company of America
+				776 Highway 74 South
+				Peachtree City  Georgia  30269
+				US
+
+74-BE-08   (hex)		ATEK Products, LLC
+74BE08     (base 16)		ATEK Products, LLC
+				210 NE 10th Avenue
+				Brainerd  MN  56401
+				US
+
+60-63-FD   (hex)		Transcend Communication Beijing Co.,Ltd.
+6063FD     (base 16)		Transcend Communication Beijing Co.,Ltd.
+				A-6,Keshi plaza,28#,Information Road
+				Beijing    100085
+				CN
+
+D8-B6-C1   (hex)		NetworkAccountant, Inc.
+D8B6C1     (base 16)		NetworkAccountant, Inc.
+				12101 Tukwila International Blvd.
+				Seattle  Washington  98168
+				US
+
+74-A4-A7   (hex)		QRS Music Technologies, Inc.
+74A4A7     (base 16)		QRS Music Technologies, Inc.
+				269 Quaker Drive
+				Seneca  PA  16346
+				US
+
+70-02-58   (hex)		01DB-METRAVIB
+700258     (base 16)		01DB-METRAVIB
+				200 CHEMIN DES ORMEAUX
+				LIMONEST CEDEX  RHONE  69578
+				FR
+
+F4-55-E0   (hex)		Niceway CNC Technology Co.,Ltd.Hunan Province
+F455E0     (base 16)		Niceway CNC Technology Co.,Ltd.Hunan Province
+				5/F,Innovation-Undertaking Center,HuanBao Industrial Park,199#,ZhenHua Road,
+				Changsha  Hunan  410116
+				CN
+
+20-FD-F1   (hex)		3COM EUROPE LTD
+20FDF1     (base 16)		3COM EUROPE LTD
+				Peoplebuilding 2
+				Hemel Hempstead  HERTS.  HP2 4NW
+				GB
+
+84-97-B8   (hex)		Memjet Inc.
+8497B8     (base 16)		Memjet Inc.
+				15920 Bernardo Center Drive
+				San Diego  CA  92127
+				US
+
+A0-DD-E5   (hex)		SHARP Corporation
+A0DDE5     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+20-6A-FF   (hex)		Atlas Elektronik UK Limited
+206AFF     (base 16)		Atlas Elektronik UK Limited
+				A22 Buliding, Dorset Green Tech. Park
+				Dorchester  Dorset  DT2 8ZB
+				GB
+
+AC-34-CB   (hex)		Shanhai GBCOM Communication Technology Co. Ltd
+AC34CB     (base 16)		Shanhai GBCOM Communication Technology Co. Ltd
+				Room 602, Building 6, No.555 Dongchuan Road
+				Shanghai     200241
+				CN
+
+90-88-A2   (hex)		IONICS TECHNOLOGY ME LTDA
+9088A2     (base 16)		IONICS TECHNOLOGY ME LTDA
+				RUA DEP. ANTONIO EDU VIEIRA
+				FLORIAN POLIS  SANTA CATARINA  88040000
+				BR
+
+40-CD-3A   (hex)		Z3 Technology
+40CD3A     (base 16)		Z3 Technology
+				2720 Harrison St
+				Evanston  IL  60201
+				US
+
+48-2C-EA   (hex)		Motorola Inc Business Light Radios
+482CEA     (base 16)		Motorola Inc Business Light Radios
+				8000 W Sunrise Boulevard
+				Plantation  Florida  33324
+				US
+
+00-33-6C   (hex)		SynapSense Corporation
+00336C     (base 16)		SynapSense Corporation
+				2365 Iron Point Road, Suite 100
+				Folsom  CA  95630
+				US
+
+2C-D1-DA   (hex)		Sanjole, Inc.
+2CD1DA     (base 16)		Sanjole, Inc.
+				2800 Woodlawn Drive, #271
+				Honolulu  Hawaii  96822
+				US
+
+F8-66-F2   (hex)		Cisco Systems, Inc
+F866F2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+AC-61-23   (hex)		Drivven, Inc.
+AC6123     (base 16)		Drivven, Inc.
+				12001 Network Boulevard
+				San Antonio  TX  78249
+				US
+
+10-0C-24   (hex)		pomdevices, LLC
+100C24     (base 16)		pomdevices, LLC
+				178 Colvard Park Dr
+				Durham  NC  27713
+				US
+
+58-F6-BF   (hex)		Kyoto University
+58F6BF     (base 16)		Kyoto University
+				Yoshida-Hommachi
+				Kyoto    6068501
+				JP
+
+78-EC-22   (hex)		Shanghai Qihui Telecom Technology Co., LTD
+78EC22     (base 16)		Shanghai Qihui Telecom Technology Co., LTD
+				Room 501, No 2 BoYun Rd, PuDong New Area, 
+				Shanghai    201203
+				CN
+
+0C-15-C5   (hex)		SDTEC Co., Ltd.
+0C15C5     (base 16)		SDTEC Co., Ltd.
+				167, Churye-2Dong, Sasang-Gu,
+				Busan     617-716
+				KR
+
+FC-75-E6   (hex)		Handreamnet
+FC75E6     (base 16)		Handreamnet
+				#1209 MarioTower, 222-12, Guro-Dong, Guro-Gu
+				Seoul  Guro-Gu  152-848
+				KR
+
+A0-A7-63   (hex)		Polytron Vertrieb GmbH
+A0A763     (base 16)		Polytron Vertrieb GmbH
+				Langwiesenweg 64-71
+				Bad Wildbad  Baden-Württemberg  75323
+				DE
+
+EC-23-68   (hex)		IntelliVoice Co.,Ltd.
+EC2368     (base 16)		IntelliVoice Co.,Ltd.
+				3-6 Kioicho
+				Chiyoda  Tokyo  102-0094
+				JP
+
+74-90-50   (hex)		Renesas Electronics Corporation
+749050     (base 16)		Renesas Electronics Corporation
+				1753, Shimonumabe, Nakahara-Ku
+				Kawasaki  Kanagawa  211-8668
+				JP
+
+38-95-92   (hex)		Beijing Tendyron Corporation
+389592     (base 16)		Beijing Tendyron Corporation
+				1810,Tower B,Jin-ma,Building,17 East Qing Hua Road 
+				Beijing    100083
+				CN
+
+A4-21-8A   (hex)		Nortel Networks
+A4218A     (base 16)		Nortel Networks
+				CARRETERA BASE AEREA # 5850
+				Zapopan  Jalisco  44130
+				MX
+
+F8-FB-2F   (hex)		Santur Corporation
+F8FB2F     (base 16)		Santur Corporation
+				40931 Encyclopedia Circle
+				Fremont  California  94538
+				US
+
+2C-CD-43   (hex)		Summit Technology Group
+2CCD43     (base 16)		Summit Technology Group
+				145 Belmont Drive
+				Somerset  NJ  08873
+				US
+
+64-99-5D   (hex)		LGE 
+64995D     (base 16)		LGE 
+				60-39 , Kasan -dong , Gumcheon-gu.
+				Seoul     153-801
+				KR
+
+7C-EF-18   (hex)		Creative Product Design Pty. Ltd.
+7CEF18     (base 16)		Creative Product Design Pty. Ltd.
+				82 Victoria Street
+				Sandringham  Victoria  3191
+				AU
+
+FC-7C-E7   (hex)		FCI USA LLC
+FC7CE7     (base 16)		FCI USA LLC
+				825 Old Trail Road
+				Etters  PA  17319
+				US
+
+14-54-12   (hex)		Entis Co., Ltd.
+145412     (base 16)		Entis Co., Ltd.
+				2-20-6, Hanaoka Bldg, 6F
+				Tokyo    1030007
+				JP
+
+7C-3E-9D   (hex)		PATECH
+7C3E9D     (base 16)		PATECH
+				#23-17. WonhyoRo-2Ga
+				YongSan-Gu  Seoul  140112
+				KR
+
+24-45-97   (hex)		GEMUE Gebr. Mueller Apparatebau
+244597     (base 16)		GEMUE Gebr. Mueller Apparatebau
+				Fritz-Mueller-Strasse 6-8
+				Ingelfingen Criesbach    74653
+				DE
+
+78-81-8F   (hex)		Server Racks Australia Pty Ltd
+78818F     (base 16)		Server Racks Australia Pty Ltd
+				4 - 6 Endurance Ave
+				Queanbeyan  NSW  2620
+				AU
+
+28-48-46   (hex)		GridCentric Inc.
+284846     (base 16)		GridCentric Inc.
+				350 Bloor St. E
+				Toronto  Ontario  M4W 0A1
+				CA
+
+30-69-4B   (hex)		RIM
+30694B     (base 16)		RIM
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+6C-62-6D   (hex)		Micro-Star INT'L CO., LTD
+6C626D     (base 16)		Micro-Star INT'L CO., LTD
+				No.69, Lide St., Jhonghe City
+				Taipei Conuty    235
+				TW
+
+28-06-8D   (hex)		ITL, LLC
+28068D     (base 16)		ITL, LLC
+				P.O. Box 41875
+				Nashville  TN  37204
+				US
+
+C0-0D-7E   (hex)		Additech, Inc.
+C00D7E     (base 16)		Additech, Inc.
+				10925 Kinghurst
+				Houston  TX  77099
+				US
+
+84-C7-A9   (hex)		C3PO S.A.
+84C7A9     (base 16)		C3PO S.A.
+				Alejandro Goicoechea 6 Local 9
+				Sant Just Desvern  Barcelona  ES08960
+				ES
+
+D8-71-57   (hex)		Lenovo Mobile Communication Technology Ltd.
+D87157     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				No.999,Qishan North 2nd Road,Information&Optoelectronics Park,Torch Hi-tech Industry Development Zone,
+				Xiamen  Fujian  361006
+				CN
+
+60-9A-A4   (hex)		GVI SECURITY INC.
+609AA4     (base 16)		GVI SECURITY INC.
+				2801 TRADE CENTER DR STE.120
+				CARROLLTON  TX  75007
+				US
+
+64-10-84   (hex)		HEXIUM Technical Development Co., Ltd.
+641084     (base 16)		HEXIUM Technical Development Co., Ltd.
+				Vaci ut 51b
+				BUDAPEST    H-1134
+				HU
+
+34-21-09   (hex)		Jensen Scandinavia AS
+342109     (base 16)		Jensen Scandinavia AS
+				Balder Allé 3
+				Jessheim    2050
+				NO
+
+3C-10-6F   (hex)		ALBAHITH TECHNOLOGIES 
+3C106F     (base 16)		ALBAHITH TECHNOLOGIES 
+				165, King Abdullah Second Street
+				Amman    11953
+				JO
+
+0C-DD-EF   (hex)		Nokia Corporation
+0CDDEF     (base 16)		Nokia Corporation
+				Elektroniikkatie 10
+				Oulu    90570
+				FI
+
+EC-FE-7E   (hex)		BlueRadios, Inc.
+ECFE7E     (base 16)		BlueRadios, Inc.
+				7173 S. Havana Street, Suite 600
+				Englewood  Colorado  80112
+				US
+
+E4-AD-7D   (hex)		SCL Elements
+E4AD7D     (base 16)		SCL Elements
+				5800 St-Denis, #222
+				Montreal  Quebec  H2S3l5
+				CA
+
+F0-9C-BB   (hex)		RaonThink Inc.
+F09CBB     (base 16)		RaonThink Inc.
+				916, Byucksan Digital Valley 2-Cha, 481-10, Kasan-Dong, Kumcheon-Gu, 
+				Seoul    153-783
+				KR
+
+10-CC-DB   (hex)		AXIMUM PRODUITS ELECTRONIQUES
+10CCDB     (base 16)		AXIMUM PRODUITS ELECTRONIQUES
+				ZI DELTA INDUSTRIE
+				MARSEILLE CEDEX 11    13368
+				FR
+
+38-C7-BA   (hex)		CS Services Co.,Ltd.
+38C7BA     (base 16)		CS Services Co.,Ltd.
+				Imon BLDG 95 Edomachi
+				Kobe  Hyogo  6500033
+				JP
+
+EC-5C-69   (hex)		MITSUBISHI HEAVY INDUSTRIES MECHATRONICS SYSTEMS,LTD.
+EC5C69     (base 16)		MITSUBISHI HEAVY INDUSTRIES MECHATRONICS SYSTEMS,LTD.
+				1-16,5-CHOME,KOMATSU-DORI,
+				KOBE  HYOGO  652-0865
+				JP
+
+6C-92-BF   (hex)		Inspur Electronic Information Industry Co.,Ltd.
+6C92BF     (base 16)		Inspur Electronic Information Industry Co.,Ltd.
+				No 224 Shanda Road
+				Jinan  Shandong  250013
+				CN
+
+44-A8-C2   (hex)		SEWOO TECH CO., LTD
+44A8C2     (base 16)		SEWOO TECH CO., LTD
+				689-20 GEUMJUNG-DONG 
+				GUNPO-SI  KYUNGGI-DO  435-862
+				KR
+
+80-EE-73   (hex)		Shuttle Inc.
+80EE73     (base 16)		Shuttle Inc.
+				No. 30 Lane 76, Rei Kuang Rd
+				Taipei    114
+				TW
+
+FC-E2-3F   (hex)		CLAY PAKY SPA
+FCE23F     (base 16)		CLAY PAKY SPA
+				Via Pastrengo 3/b
+				Seriate  Bergamo  24068
+				IT
+
+58-57-0D   (hex)		Danfoss Solar Inverters
+58570D     (base 16)		Danfoss Solar Inverters
+				Jyllandsgade 28
+				Sønderborg    DK-6400
+				DK
+
+C4-82-3F   (hex)		Fujian Newland Auto-ID Tech. Co,.Ltd.
+C4823F     (base 16)		Fujian Newland Auto-ID Tech. Co,.Ltd.
+				Newland Science & Technology Park, No.1 Rujiang West Rd., Mawei
+				Fuzhou  Fujian  350015
+				CN
+
+E8-5B-5B   (hex)		LG ELECTRONICS INC
+E85B5B     (base 16)		LG ELECTRONICS INC
+				19-1, CHEONGHO-RI, JINWI-MYEON
+				PYEONGTAEK  GYEONGGI-DO  451-713
+				KR
+
+BC-A9-D6   (hex)		Cyber-Rain, Inc.
+BCA9D6     (base 16)		Cyber-Rain, Inc.
+				5272 Evanwood Avenue
+				Oak Park  California  91377-4809
+				US
+
+6C-3E-9C   (hex)		KE Knestel Elektronik GmbH
+6C3E9C     (base 16)		KE Knestel Elektronik GmbH
+				Osterwalder Str. 12
+				Hopferbach  Bavaria  87496
+				DE
+
+8C-D6-28   (hex)		Ikor Metering
+8CD628     (base 16)		Ikor Metering
+				Francisco Grandmontagne 4
+				San Sebastian  Guipuzcoa  20008
+				ES
+
+24-3C-20   (hex)		Dynamode Group
+243C20     (base 16)		Dynamode Group
+				Head Office, 132a St Albans Road
+				Watford  Herts  WD24 4AE
+				GB
+
+3C-39-C3   (hex)		JW Electronics Co., Ltd.
+3C39C3     (base 16)		JW Electronics Co., Ltd.
+				3A17, No. 5 Hsin-yi Rd., Sec. 5
+				Taipei    110
+				TW
+
+3C-05-AB   (hex)		Product Creation Studio
+3C05AB     (base 16)		Product Creation Studio
+				425 Westlake Ave N
+				Seattle  WA  98109
+				US
+
+F0-43-35   (hex)		DVN(Shanghai)Ltd.
+F04335     (base 16)		DVN(Shanghai)Ltd.
+				11F,Hechuan Building,2016 Yishan Rd,
+				Shanghai    201103
+				CN
+
+A4-79-E4   (hex)		KLINFO Corp
+A479E4     (base 16)		KLINFO Corp
+				301 923 wolpyung-dong
+				Daejeon    302-852
+				KR
+
+48-1B-D2   (hex)		Intron Scientific co., ltd.
+481BD2     (base 16)		Intron Scientific co., ltd.
+				6F., NO. 136,Sec 2,Keelung Rd., Da-an district
+				Taipei    106
+				TW
+
+D0-F0-DB   (hex)		Ericsson
+D0F0DB     (base 16)		Ericsson
+				250 Holger Way
+				SAN JOSE  CA  95134
+				US
+
+7C-14-76   (hex)		Damall Technologies SAS
+7C1476     (base 16)		Damall Technologies SAS
+				Corso della Repubblica 65
+				Fabriano  Ancona  60044
+				IT
+
+8C-54-1D   (hex)		LGE 
+8C541D     (base 16)		LGE 
+				60-39 , Kasan -dong , Gumcheon-gu.
+				Seoul     153-801
+				KR
+
+00-A2-DA   (hex)		INAT GmbH
+00A2DA     (base 16)		INAT GmbH
+				Ostendstraße 50A
+				Nuremberg  Bavaria  90482
+				DE
+
+00-3C-C5   (hex)		WONWOO Engineering Co., Ltd
+003CC5     (base 16)		WONWOO Engineering Co., Ltd
+				7F 201, Techno-Park SsangYong III, 
+				Bucheon City  Gyeonggi-Do  421-808
+				KR
+
+F0-77-D0   (hex)		Xcellen
+F077D0     (base 16)		Xcellen
+				15F KINS Tower 25-1,Jeongja-dong,Bungdang-gu,
+				Seongnam  Gyeonggi  463811
+				KR
+
+4C-C6-02   (hex)		Radios, Inc.
+4CC602     (base 16)		Radios, Inc.
+				31355 State Road 46
+				Sorrenot  Floriad  32776
+				US
+
+80-71-1F   (hex)		Juniper Networks
+80711F     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+88-FD-15   (hex)		LINEEYE CO., LTD
+88FD15     (base 16)		LINEEYE CO., LTD
+				5F Marufuku Bldg. 39-1 Karahashi
+				Kyoto    601-8468
+				JP
+
+88-4B-39   (hex)		Siemens AG, Healthcare Sector
+884B39     (base 16)		Siemens AG, Healthcare Sector
+				Henkestrasse 127
+				Erlangen  Bavaria  91052
+				DE
+
+D8-28-C9   (hex)		General Electric Consumer and Industrial
+D828C9     (base 16)		General Electric Consumer and Industrial
+				AP35-1405
+				Louisville  KY  40225
+				US
+
+44-C2-33   (hex)		Guangzhou Comet Technology Development Co.Ltd
+44C233     (base 16)		Guangzhou Comet Technology Development Co.Ltd
+				Rm 304,FL 3,Block G,Science and  Technology Innovation Base,
+				Guangzhou  Guangdong  510663
+				CN
+
+30-EF-D1   (hex)		Alstom Strongwish (Shenzhen) Co., Ltd.
+30EFD1     (base 16)		Alstom Strongwish (Shenzhen) Co., Ltd.
+				5F,Building No.6, Keji Middle 2 Road High-Tech Industrial Park, 
+				Shen Zhen  Guangdong  518057
+				CN
+
+7C-2C-F3   (hex)		Secure Electrans Ltd
+7C2CF3     (base 16)		Secure Electrans Ltd
+				Pioneer House, Pioneer Business Park
+				Ellesmere Port    CH65 1AD
+				GB
+
+08-16-51   (hex)		SHENZHEN SEA STAR TECHNOLOGY CO.,LTD
+081651     (base 16)		SHENZHEN SEA STAR TECHNOLOGY CO.,LTD
+				Seastar industrial Park, BaoLong  6th Ave
+				ShenZhen  GuangDong  518116
+				CN
+
+A8-63-DF   (hex)		DISPLAIRE CORPORATION
+A863DF     (base 16)		DISPLAIRE CORPORATION
+				1300 Valley House Dr, Ste 100
+				Rohnert Park  CA  94928
+				US
+
+18-3B-D2   (hex)		BYD Precision Manufacture Company Ltd.
+183BD2     (base 16)		BYD Precision Manufacture Company Ltd.
+				No3000 LongDong Avenue, Pudong District
+				Shanghai    201203
+				CN
+
+E4-35-93   (hex)		Hangzhou GoTo technology Co.Ltd
+E43593     (base 16)		Hangzhou GoTo technology Co.Ltd
+				Room 1303,Boee buliding,3760 Nanhuan Road, Binjiang, 
+				Hangzhou  Zhejiang  310053
+				CN
+
+2C-3A-28   (hex)		Fagor Electrónica
+2C3A28     (base 16)		Fagor Electrónica
+				B. San Andres, s/n
+				Mondragón  Guipuzcoa  20500
+				ES
+
+B4-58-61   (hex)		CRemote, LLC
+B45861     (base 16)		CRemote, LLC
+				1195 Noel Drive
+				MENLO PARK  CA  94025
+				US
+
+B0-97-3A   (hex)		E-Fuel Corporation
+B0973A     (base 16)		E-Fuel Corporation
+				15466 Los Gatos Blvd. #37
+				Los Gatos  CA  95032
+				US
+
+20-4E-6B   (hex)		Axxana(israel) ltd
+204E6B     (base 16)		Axxana(israel) ltd
+				Habarzel 38
+				Tel aviv    69710
+				IL
+
+80-F5-93   (hex)		IRCO Sistemas de Telecomunicación S.A.
+80F593     (base 16)		IRCO Sistemas de Telecomunicación S.A.
+				Via Sergia 98
+				Mataró  Barcelona  08302
+				ES
+
+E4-97-F0   (hex)		Shanghai VLC Technologies Ltd. Co.
+E497F0     (base 16)		Shanghai VLC Technologies Ltd. Co.
+				Room 901, B-Zone, East Beijing Road
+				Shanghai    200001
+				CN
+
+B4-08-32   (hex)		TC Communications
+B40832     (base 16)		TC Communications
+				17575 Cartwright Road
+				Irvine  CA  92614
+				US
+
+EC-DE-3D   (hex)		Lamprey Networks, Inc.
+ECDE3D     (base 16)		Lamprey Networks, Inc.
+				58 Dover Road
+				Durham  NH  03824
+				US
+
+6C-FF-BE   (hex)		MPB Communications Inc.
+6CFFBE     (base 16)		MPB Communications Inc.
+				147 Hymus Blvd
+				Pointe-Claire  Quebec  H9R 1E9
+				CA
+
+30-41-74   (hex)		ALTEC LANSING LLC
+304174     (base 16)		ALTEC LANSING LLC
+				535 ROUTES 6 & 209
+				MILFORD  PA  18337
+				US
+
+80-B2-89   (hex)		Forworld Electronics Ltd.
+80B289     (base 16)		Forworld Electronics Ltd.
+				No.16 Keyuan 2nd Rd., Situn District
+				Taichung City    886
+				TW
+
+E8-3A-97   (hex)		Toshiba Corporation
+E83A97     (base 16)		Toshiba Corporation
+				1-1-1, Shibaura, Minato-ku
+				Tokyo    00000
+				JP
+
+10-56-CA   (hex)		Peplink International Ltd.
+1056CA     (base 16)		Peplink International Ltd.
+				17/F, Park Building,
+				Cheung Sha Wan    
+				HK
+
+48-6F-D2   (hex)		StorSimple Inc
+486FD2     (base 16)		StorSimple Inc
+				2350 Mission College Blvd
+				Santa Clara  CA  95054
+				US
+
+A0-3A-75   (hex)		PSS Belgium N.V.
+A03A75     (base 16)		PSS Belgium N.V.
+				Hoogveld 50
+				Dendermonde    9200
+				BE
+
+24-DB-AD   (hex)		ShopperTrak RCT Corporation
+24DBAD     (base 16)		ShopperTrak RCT Corporation
+				200 W. Monroe Street
+				Chicago  IL  60606
+				US
+
+9C-EB-E8   (hex)		BizLink (Kunshan) Co.,Ltd
+9CEBE8     (base 16)		BizLink (Kunshan) Co.,Ltd
+				No.168,Nanhe Road,Economic & Technological Development Zone,
+				Kunshan City  Jiangsu Province  215300
+				CN
+
+04-0E-C2   (hex)		ViewSonic Mobile China Limited
+040EC2     (base 16)		ViewSonic Mobile China Limited
+				Room 601, The Gate Tower B, No.19, Zhongguancun Street, Haidian District
+				Beijing    100080
+				CN
+
+C8-D1-D1   (hex)		AGAiT Technology Corporation
+C8D1D1     (base 16)		AGAiT Technology Corporation
+				5F,No.27-8, Sec. 2, Zhongzheng E. Rd., Danshui Township 
+				Taipei County     25170
+				TW
+
+00-DB-45   (hex)		THAMWAY CO.,LTD.
+00DB45     (base 16)		THAMWAY CO.,LTD.
+				3-9-2
+				Fuji  Shizuoka  417-0001
+				JP
+
+D4-9C-28   (hex)		JayBird LLC
+D49C28     (base 16)		JayBird LLC
+				3676 California Ave
+				Salt Lake City  UT  84104
+				US
+
+74-F7-26   (hex)		Neuron Robotics
+74F726     (base 16)		Neuron Robotics
+				91 Pearson Ave
+				Somerville  MA  02144
+				US
+
+28-72-C5   (hex)		Smartmatic Corp
+2872C5     (base 16)		Smartmatic Corp
+				1001 Broken Sound Pkwy NW Suite D
+				Boca Raton  Florida  33487
+				US
+
+E0-8F-EC   (hex)		REPOTEC CO., LTD.
+E08FEC     (base 16)		REPOTEC CO., LTD.
+				3F, 258. 
+				CHUNG HO CITY, TAIPEI COUNTY    235
+				TW
+
+AC-E9-AA   (hex)		Hay Systems Ltd
+ACE9AA     (base 16)		Hay Systems Ltd
+				Watermark
+				Livingston  West Lothian  EH54 7EG
+				GB
+
+08-2A-D0   (hex)		SRD Innovations Inc.
+082AD0     (base 16)		SRD Innovations Inc.
+				11525 Valley Ridge Dr. NW
+				Calgary  AB  T3B 5T4
+				CA
+
+88-98-21   (hex)		TERAON
+889821     (base 16)		TERAON
+				2F Seohan Bldg., 1552-10, Seocho-Dong, Seocho-Gu,
+				Seoul    137-070
+				KR
+
+E0-E7-51   (hex)		Nintendo Co., Ltd.
+E0E751     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-3A-AF   (hex)		BlueBit Ltd.
+003AAF     (base 16)		BlueBit Ltd.
+				Unit B, 21/F., 78 Hung To Road,
+				Kowloon,     
+				HK
+
+64-16-8D   (hex)		Cisco Systems, Inc
+64168D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-3A-9C   (hex)		Cisco Systems, Inc
+003A9C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+7C-6C-8F   (hex)		AMS NEVE LTD
+7C6C8F     (base 16)		AMS NEVE LTD
+				BILLINGTON ROAD
+				BURNLEY  LANCASHIRE  BB11 5UB
+				GB
+
+9C-B2-06   (hex)		PROCENTEC
+9CB206     (base 16)		PROCENTEC
+				Klopperman 16
+				Wateringen  Zuid Holland  2292JD
+				NL
+
+88-ED-1C   (hex)		Cudo Communication Co., Ltd.
+88ED1C     (base 16)		Cudo Communication Co., Ltd.
+				10F ArirangTV 1467-80, Seocho-3dong, Seocho-gu
+				Seoul    137-868
+				KR
+
+9C-CD-82   (hex)		CHENG UEI PRECISION INDUSTRY CO.,LTD
+9CCD82     (base 16)		CHENG UEI PRECISION INDUSTRY CO.,LTD
+				No.18, Chung Shan Rd., Tu-Cheng Industry Park 
+				Tu Cheng City  Taipei Hsien  23680
+				TW
+
+F0-62-81   (hex)		ProCurve Networking by HP
+F06281     (base 16)		ProCurve Networking by HP
+				60 Alexandra Terrace
+				    118502
+				SG
+
+C0-9C-92   (hex)		COBY
+C09C92     (base 16)		COBY
+				COBY Electronics ShenZhen R&D Center 
+				SHENZHEN  GUANGDONG  518109
+				CN
+
+C0-38-F9   (hex)		Nokia Danmark A/S
+C038F9     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+F4-63-49   (hex)		Diffon Corporation
+F46349     (base 16)		Diffon Corporation
+				Digital Tower Aston 1505
+				Seoul    153803
+				KR
+
+74-F0-7D   (hex)		BnCOM Co.,Ltd
+74F07D     (base 16)		BnCOM Co.,Ltd
+				Room1007, Daehyun Techno World, 174
+				Uiwang-si  Gyeonggi-do  437-753
+				KR
+
+F8-52-DF   (hex)		VNL Europe AB
+F852DF     (base 16)		VNL Europe AB
+				Finlandsgatan 10
+				Kista    164 74
+				SE
+
+A8-CB-95   (hex)		EAST BEST CO., LTD.
+A8CB95     (base 16)		EAST BEST CO., LTD.
+				4F,NO.98,SHING TEH ROAD
+				SAN CHUNG CITY   TAIPEI  241
+				TW
+
+F4-5F-F7   (hex)		DQ Technology Inc.
+F45FF7     (base 16)		DQ Technology Inc.
+				5111 Johnson Drive
+				Pleasanton  CA  94588
+				US
+
+7C-3B-D5   (hex)		Imago Group
+7C3BD5     (base 16)		Imago Group
+				Ramon Marti Alsina 2-4-6
+				Badalona  Barcelona  08911
+				ES
+
+5C-E2-23   (hex)		Delphin Technology AG
+5CE223     (base 16)		Delphin Technology AG
+				Lustheide 81
+				Bergisch-Gladbach    51427
+				DE
+
+F8-71-FE   (hex)		The Goldman Sachs Group, Inc.
+F871FE     (base 16)		The Goldman Sachs Group, Inc.
+				Christchurch Court | 10-15 Newgate Street
+				London  London  EC1A 7HD
+				GB
+
+2C-19-84   (hex)		IDN Telecom, Inc.
+2C1984     (base 16)		IDN Telecom, Inc.
+				2669 Great Arbor Way
+				Union City  CA  94587
+				US
+
+D8-C3-FB   (hex)		DETRACOM
+D8C3FB     (base 16)		DETRACOM
+				41 AVENUE DE L'EUROPE
+				CASTELNAU D'ESTRETEFONDS    31620
+				FR
+
+58-F6-7B   (hex)		Xia Men UnionCore Technology LTD.
+58F67B     (base 16)		Xia Men UnionCore Technology LTD.
+				(224)2F Chuangye Building,Xiamen Pioneering Park for Overseas Chinese Scholars
+				Xia Men  Fu Jian  361009
+				CN
+
+6C-F0-49   (hex)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+6CF049     (base 16)		GIGA-BYTE TECHNOLOGY CO.,LTD.
+				
+				Pin-Jen  Taoyuan  324
+				TW
+
+64-4F-74   (hex)		LENUS Co., Ltd.
+644F74     (base 16)		LENUS Co., Ltd.
+				18-5 Gwacheon-Dong
+				Gwacheon  Gyeonggi-Do  427-060
+				KR
+
+78-7F-62   (hex)		GiK mbH
+787F62     (base 16)		GiK mbH
+				Goethestraße 5
+				Aachen    52064
+				DE
+
+40-15-97   (hex)		Protect America, Inc.
+401597     (base 16)		Protect America, Inc.
+				5100 N IH-35
+				Round Rock  TX  78681
+				US
+
+C4-FC-E4   (hex)		DishTV NZ Ltd
+C4FCE4     (base 16)		DishTV NZ Ltd
+				10 Penney Ave
+				Auckland    1041
+				NZ
+
+E8-0B-13   (hex)		Akib Systems Taiwan, INC
+E80B13     (base 16)		Akib Systems Taiwan, INC
+				No.582-1, RuiGuang Rd
+				Taipei    114
+				TW
+
+EC-6C-9F   (hex)		Chengdu Volans Technology CO.,LTD
+EC6C9F     (base 16)		Chengdu Volans Technology CO.,LTD
+				2nd Floor Building 4B Hi-Tech Incubation Park,Nanyan Xian,Tianfu Ave
+				Chengdu  Sichuan  610041
+				CN
+
+40-EF-4C   (hex)		Fihonest communication co.,Ltd
+40EF4C     (base 16)		Fihonest communication co.,Ltd
+				Room902,Park road,Zhixing business-building
+				Dongguan  Guangdong  523560
+				CN
+
+00-27-1E   (hex)		Xagyl Communications
+00271E     (base 16)		Xagyl Communications
+				1667 Marronier Crt
+				Cumberland  Ontario  K4C 1C2
+				CA
+
+00-27-1D   (hex)		Comba Telecom Systems (China) Ltd.
+00271D     (base 16)		Comba Telecom Systems (China) Ltd.
+				10 Shenzhou Road
+				Guangzhou  Guangdong  510663
+				CN
+
+00-27-20   (hex)		NEW-SOL COM
+002720     (base 16)		NEW-SOL COM
+				Bucheon Tecnopark 403-602
+				Bucheon city  Kyoungki-do  420-734
+				KR
+
+00-26-F0   (hex)		cTrixs International GmbH.
+0026F0     (base 16)		cTrixs International GmbH.
+				Lieferinger Hauptstr. 140
+				Salzburg  Salzburg  5020
+				AT
+
+00-26-EA   (hex)		Cheerchip Electronic Technology (ShangHai) Co., Ltd.
+0026EA     (base 16)		Cheerchip Electronic Technology (ShangHai) Co., Ltd.
+				ROOM 1202, NO. 51, 7 Area, NO. 1467 CAOBAO ROAD;
+				SHANGHAI    201101
+				CN
+
+00-27-08   (hex)		Nordiag ASA
+002708     (base 16)		Nordiag ASA
+				Frysjaveien 40
+				Oslo    0884
+				NO
+
+00-27-02   (hex)		SolarEdge Technologies
+002702     (base 16)		SolarEdge Technologies
+				1 Abba Eban St.
+				Herzelia    46725
+				IL
+
+00-27-04   (hex)		Accelerated Concepts, Inc
+002704     (base 16)		Accelerated Concepts, Inc
+				1208 E Kennedy Blvd
+				Tampa  FL  33602
+				US
+
+00-26-FA   (hex)		BandRich Inc.
+0026FA     (base 16)		BandRich Inc.
+				7F., No.188, Baociao Road
+				Sindian City  Taipei  23145
+				TW
+
+00-26-F9   (hex)		S.E.M. srl
+0026F9     (base 16)		S.E.M. srl
+				via Lecco, 61
+				Vimercate  Monza Brianza  20059
+				IT
+
+00-26-FD   (hex)		Interactive Intelligence
+0026FD     (base 16)		Interactive Intelligence
+				7601 Interactive Way
+				  IN  46278
+				US
+
+00-26-F7   (hex)		Nivetti Systems Pvt. Ltd.
+0026F7     (base 16)		Nivetti Systems Pvt. Ltd.
+				#727,8th Main, JP Nagar 3rd Phase
+				Bangalore    560078
+				IN
+
+00-26-F6   (hex)		Military Communication Institute
+0026F6     (base 16)		Military Communication Institute
+				ul. Warszawska 22A
+				Zegrze    05-130
+				PL
+
+00-26-DD   (hex)		Fival Science & Technology Co.,Ltd.
+0026DD     (base 16)		Fival Science & Technology Co.,Ltd.
+				1/F, Building 57, No.461
+				Shanghai  Shanghai  200233
+				CN
+
+00-26-DE   (hex)		FDI MATELEC
+0026DE     (base 16)		FDI MATELEC
+				Route de saint symphorien
+				Les landes Génusson    85130
+				FR
+
+00-26-DA   (hex)		Universal Media Corporation /Slovakia/ s.r.o.
+0026DA     (base 16)		Universal Media Corporation /Slovakia/ s.r.o.
+				Mickiewiczova 7104/14
+				Bratislava    811 07
+				SK
+
+00-26-DB   (hex)		Ionics EMS Inc.
+0026DB     (base 16)		Ionics EMS Inc.
+				Carmelray Industrial Park 2, Brgy. Tulo
+				Calamba  Laguna  4027
+				PH
+
+00-26-D5   (hex)		Ory Solucoes em Comercio de Informatica Ltda.
+0026D5     (base 16)		Ory Solucoes em Comercio de Informatica Ltda.
+				Av. Unisinos, 615
+				Sao Leopoldo  RS  93022000
+				BR
+
+00-26-CE   (hex)		Kozumi USA Corp.
+0026CE     (base 16)		Kozumi USA Corp.
+				3005 Hartridge Terrace
+				Wellington  FL  33414
+				US
+
+00-27-11   (hex)		LanPro Inc
+002711     (base 16)		LanPro Inc
+				1880 NW 93Av
+				Miami  Florida  33172
+				US
+
+00-26-86   (hex)		Quantenna Communcations, Inc.
+002686     (base 16)		Quantenna Communcations, Inc.
+				3450 W. Warren Ave.
+				Fremont  CA  94538
+				US
+
+00-26-84   (hex)		KISAN SYSTEM
+002684     (base 16)		KISAN SYSTEM
+				GWANGMYEONG TECHNOPARK B-403
+				GWANGMYEONG  GYEONGGI  423-050
+				KR
+
+00-26-80   (hex)		SIL3 Pty.Ltd
+002680     (base 16)		SIL3 Pty.Ltd
+				Factory 10
+				DANDENONG  VICTORIA  3175
+				AU
+
+00-26-BF   (hex)		ShenZhen Temobi Science&Tech Development Co.,Ltd
+0026BF     (base 16)		ShenZhen Temobi Science&Tech Development Co.,Ltd
+				4FloorG, Jinrun Tower, 6019 Shennan Road
+				ShenZhen    518000
+				CN
+
+00-26-B4   (hex)		Ford Motor Company
+0026B4     (base 16)		Ford Motor Company
+				20300 Rotunda Drive
+				Dearborn  MI  48124
+				US
+
+00-26-CA   (hex)		Cisco Systems, Inc
+0026CA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-C9   (hex)		Proventix Systems, Inc.
+0026C9     (base 16)		Proventix Systems, Inc.
+				4518 Valleydale Road
+				Birmingham  AL  35242
+				US
+
+00-26-90   (hex)		I DO IT
+002690     (base 16)		I DO IT
+				1308, WoolimLions2nd Doksan Station
+				Seoul    153-787
+				KR
+
+00-26-8F   (hex)		MTA SpA
+00268F     (base 16)		MTA SpA
+				Viale dell Industria 12
+				Codogno  LODI  26845
+				IT
+
+00-26-79   (hex)		Euphonic Technologies, Inc.
+002679     (base 16)		Euphonic Technologies, Inc.
+				2-5-10 Shin-yokohama, Kouhoku-ku
+				Yokohama    222-0033
+				JP
+
+00-26-AC   (hex)		Shanghai LUSTER Teraband photonic Co., Ltd.
+0026AC     (base 16)		Shanghai LUSTER Teraband photonic Co., Ltd.
+				F4, No.39 ChengZhong Rd.
+				Shanghai    201800
+				CN
+
+00-26-A6   (hex)		TRIXELL
+0026A6     (base 16)		TRIXELL
+				460, Rue du pommarin
+				MOIRANS    38210
+				FR
+
+00-26-9C   (hex)		ITUS JAPAN CO. LTD
+00269C     (base 16)		ITUS JAPAN CO. LTD
+				7F Shinkawa B/D
+				Chuoku  Tokyo  1040033
+				JP
+
+00-26-94   (hex)		Senscient Ltd
+002694     (base 16)		Senscient Ltd
+				Unit 2, Block A, Arena Business Centre
+				Poole  Dorset  BH17 7FJ
+				GB
+
+00-26-76   (hex)		COMMidt AS
+002676     (base 16)		COMMidt AS
+				Kikregata 57-59
+				Levanger  Nord-Troendelag  7600
+				NO
+
+00-26-1D   (hex)		COP SECURITY SYSTEM CORP.
+00261D     (base 16)		COP SECURITY SYSTEM CORP.
+				4~7F, No.5, Lane 130, Min-Chung Rd.,
+				Taipei    23141
+				TW
+
+00-26-17   (hex)		OEM Worldwide
+002617     (base 16)		OEM Worldwide
+				2920 Kelly Ave
+				Watertown  SD  57201
+				US
+
+00-26-13   (hex)		Engel Axil S.L.
+002613     (base 16)		Engel Axil S.L.
+				Puig dels Tudons, 6
+				Barbera del Valles  Barcelona  08210
+				ES
+
+00-26-38   (hex)		Xia Men Joyatech Co., Ltd.
+002638     (base 16)		Xia Men Joyatech Co., Ltd.
+				Room 304, 28th Building, Guanri Road, Xiamen Software Park
+				Xiamen  Fujian Province  361008
+				CN
+
+00-26-3A   (hex)		Digitec Systems
+00263A     (base 16)		Digitec Systems
+				7,1st Street, Kasturibai Nagar
+				Chennai  Tamil Nadu  600054
+				IN
+
+00-26-0F   (hex)		Linn Products Ltd
+00260F     (base 16)		Linn Products Ltd
+				Glasgow Road
+				Glasgow  Scotland  G76 0EQ
+				GB
+
+00-26-0C   (hex)		Dataram
+00260C     (base 16)		Dataram
+				186 Princeton Rd.
+				West Windsor  NJ  08550
+				US
+
+00-26-2B   (hex)		Wongs Electronics Co. Ltd.
+00262B     (base 16)		Wongs Electronics Co. Ltd.
+				Wanfeng Ind. Esata, Shajing, Baoan,
+				Shenzhen  Guang Dong  518104
+				CN
+
+00-26-20   (hex)		ISGUS GmbH
+002620     (base 16)		ISGUS GmbH
+				Oberdorfstraße 18 - 22
+				VS - Schwenningen  BW  78054
+				DE
+
+00-26-01   (hex)		Cutera Inc
+002601     (base 16)		Cutera Inc
+				3240 Bayshore Blvd
+				Brisbane  CA  94405
+				US
+
+00-26-35   (hex)		Bluetechnix GmbH
+002635     (base 16)		Bluetechnix GmbH
+				Waidhausenstr. 3/19
+				Vienna    1140
+				AT
+
+00-26-57   (hex)		OOO NPP EKRA
+002657     (base 16)		OOO NPP EKRA
+				I.Yakovleva St., 3
+				Cheboksary  Chuvash Republic  428003
+				RU
+
+00-26-52   (hex)		Cisco Systems, Inc
+002652     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-26-66   (hex)		EFM Networks
+002666     (base 16)		EFM Networks
+				6F, Benposra II 1197-1 Bojeong Giheung Gu
+				Yong In  Kyunggi do  446913
+				KR
+
+00-25-F5   (hex)		DVS Korea, Co., Ltd
+0025F5     (base 16)		DVS Korea, Co., Ltd
+				497-3, SangHa-Dong, Giheung-gu
+				Yong-In city  Gyeonggi-do  446-914
+				KR
+
+00-25-EB   (hex)		Reutech Radar Systems (PTY) Ltd
+0025EB     (base 16)		Reutech Radar Systems (PTY) Ltd
+				35 Elektron Avenue
+				Stellenbosch  Western Cape  7600
+				ZA
+
+00-25-EE   (hex)		Avtex Ltd
+0025EE     (base 16)		Avtex Ltd
+				Unit G5 Capital Business Park
+				Cardiff    CF3 2PX
+				GB
+
+00-25-AE   (hex)		Microsoft Corporation
+0025AE     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+00-25-AF   (hex)		COMFILE Technology
+0025AF     (base 16)		COMFILE Technology
+				Guro 5 dong, Guro-gu
+				Seoul    152-842
+				KR
+
+00-25-A8   (hex)		Kontron (BeiJing) Technology Co.,Ltd
+0025A8     (base 16)		Kontron (BeiJing) Technology Co.,Ltd
+				17 Building, Block #1,ABP.  188 Western South 4th Ring Road
+				BeiJing    100070
+				CN
+
+00-25-D9   (hex)		DataFab Systems Inc.
+0025D9     (base 16)		DataFab Systems Inc.
+				385-3 Hongzun Road
+				Pingzhen City  Taoyuan County  32466
+				TW
+
+00-25-D6   (hex)		The Kroger Co.
+0025D6     (base 16)		The Kroger Co.
+				11450 Grooms Road
+				Blue Ash  OH  45242
+				US
+
+00-25-D1   (hex)		Eastern Asia Technology Limited
+0025D1     (base 16)		Eastern Asia Technology Limited
+				8F-1, No. 188, Baoqiao Rd., Xindian Dist.
+				New Taipei City    23145
+				TW
+
+00-25-CD   (hex)		Skylane Optics
+0025CD     (base 16)		Skylane Optics
+				Rue d'Arlon, 6
+				Windhof    8399
+				LU
+
+00-25-BF   (hex)		Wireless Cables Inc.
+0025BF     (base 16)		Wireless Cables Inc.
+				1414 Soquel Ave, Ste 212
+				Santa Cruz  CA  95062
+				US
+
+00-25-B9   (hex)		Cypress Solutions Inc
+0025B9     (base 16)		Cypress Solutions Inc
+				3066 Beta Ave
+				  BC  V5G 4K4
+				CA
+
+00-25-B6   (hex)		Telecom FM
+0025B6     (base 16)		Telecom FM
+				895 Plymouth Road
+				Slough  Berkshire  SL1 4LP
+				GB
+
+00-25-A5   (hex)		Walnut Media Network
+0025A5     (base 16)		Walnut Media Network
+				440 N Wolfe Rd
+				Sunnyvale  CA  94085
+				US
+
+00-25-A4   (hex)		EuroDesign embedded technologies GmbH
+0025A4     (base 16)		EuroDesign embedded technologies GmbH
+				Waldstratraße 4A
+				Kirchdorf a.d. Amper  Bayern  85414
+				DE
+
+00-25-C1   (hex)		Nawoo Korea Corp.
+0025C1     (base 16)		Nawoo Korea Corp.
+				4Fl., Hanwon Bldg., 6-1, Sunae-dong, Bundang-gu,
+				Seongnam-si  Gyeonggi-do  463-825
+				KR
+
+00-25-F6   (hex)		netTALK.com, Inc.
+0025F6     (base 16)		netTALK.com, Inc.
+				1100 NW 163RD DRIVE
+				NORTH MIAMI BEACH  FL  33169
+				US
+
+00-25-7A   (hex)		CAMCO Produktions- und Vertriebs-GmbH für  Beschallungs- und Beleuchtungsanlagen
+00257A     (base 16)		CAMCO Produktions- und Vertriebs-GmbH für  Beschallungs- und Beleuchtungsanlagen
+				Fischpicke 5
+				Wenden  NRW  57482
+				DE
+
+00-25-76   (hex)		NELI TECHNOLOGIES
+002576     (base 16)		NELI TECHNOLOGIES
+				Route Nationale
+				LE RHEU    35650
+				FR
+
+00-25-74   (hex)		KUNIMI MEDIA DEVICE Co., Ltd.
+002574     (base 16)		KUNIMI MEDIA DEVICE Co., Ltd.
+				3 KITAMACHIDA YAMAZAKI
+				KUNIMI, DATE  FUKUSHIMA  969-1771
+				JP
+
+00-25-59   (hex)		Syphan Technologies Ltd
+002559     (base 16)		Syphan Technologies Ltd
+				The Watermill
+				Skipton  North Yorkshire  BD23 3AG
+				GB
+
+00-25-54   (hex)		Pixel8 Networks
+002554     (base 16)		Pixel8 Networks
+				22 Great Oaks Blvd, Suite 150
+				San Jose  CA  95119
+				US
+
+00-25-40   (hex)		Quasar Technologies, Inc.
+002540     (base 16)		Quasar Technologies, Inc.
+				1701 Barrett Lakes Boulevard
+				Kennesaw  GA  30144
+				US
+
+00-25-33   (hex)		WITTENSTEIN AG
+002533     (base 16)		WITTENSTEIN AG
+				Walter-Wittenstein-Straße 1
+				Igersheim    97999
+				DE
+
+00-25-30   (hex)		Aetas Systems Inc.
+002530     (base 16)		Aetas Systems Inc.
+				3A3, No. 1, LiHsin Road I
+				HsinChu  Taiwan  30078
+				TW
+
+00-25-2C   (hex)		Entourage Systems, Inc.
+00252C     (base 16)		Entourage Systems, Inc.
+				7901 Jones Branch Drive
+				McLean  Virginia  22102
+				US
+
+00-25-8C   (hex)		ESUS ELEKTRONIK SAN. VE DIS. TIC. LTD. STI.
+00258C     (base 16)		ESUS ELEKTRONIK SAN. VE DIS. TIC. LTD. STI.
+				ESENSEHIR MAHALLESI KURKCULER CADDESI
+				ISTANBUL    34776
+				TR
+
+00-25-5A   (hex)		Tantalus Systems Corp.
+00255A     (base 16)		Tantalus Systems Corp.
+				301-3480 Gilmore Way
+				Burnaby  BC  V5G 4Y1
+				CA
+
+00-25-87   (hex)		Vitality, Inc.
+002587     (base 16)		Vitality, Inc.
+				One Broadway
+				Cambridge  MA  02142
+				US
+
+00-25-73   (hex)		ST Electronics (Info-Security) Pte Ltd
+002573     (base 16)		ST Electronics (Info-Security) Pte Ltd
+				100, Jurong East Street 21, ST Electronics Jurong East Bldg
+				    609602
+				SG
+
+00-25-6F   (hex)		Dantherm Power
+00256F     (base 16)		Dantherm Power
+				Marienlystvej 65
+				Skive    7800
+				DK
+
+00-25-2F   (hex)		Energy, Inc.
+00252F     (base 16)		Energy, Inc.
+				3297 Pacific Street
+				Charleston  SC  29418
+				US
+
+00-25-0A   (hex)		Security Expert Co. Ltd
+00250A     (base 16)		Security Expert Co. Ltd
+				8F-3, No.2, Jian 8th Rd.,
+				Jhonghe  Taipei  235
+				TW
+
+00-25-05   (hex)		eks Engel GmbH & Co. KG
+002505     (base 16)		eks Engel GmbH & Co. KG
+				Schuetzenstrasse 2
+				Wenden-Hillmicke  NRW  57482
+				DE
+
+00-25-09   (hex)		SHARETRONIC Group LTD
+002509     (base 16)		SHARETRONIC Group LTD
+				ShaJing,Bao'an Zone,
+				ShenZhen  Guangdong  518104
+				CN
+
+00-24-DA   (hex)		Innovar Systems Limited
+0024DA     (base 16)		Innovar Systems Limited
+				12155 Commissioner Drive
+				North Jackson  Ohio  44451
+				US
+
+00-24-D8   (hex)		IlSung Precision
+0024D8     (base 16)		IlSung Precision
+				182-2, Jegi-ri, Jeongnam-myeon
+				Hwanseong-si  Gyeonggi-do  445-964
+				KR
+
+00-24-CD   (hex)		Willow Garage, Inc.
+0024CD     (base 16)		Willow Garage, Inc.
+				68 Willow Rd.
+				Menlo Park  CA  94025
+				US
+
+00-24-D3   (hex)		QUALICA Inc.
+0024D3     (base 16)		QUALICA Inc.
+				5-29-15,Toyo,
+				Tokyo    135-0016
+				JP
+
+00-24-CE   (hex)		Exeltech Inc
+0024CE     (base 16)		Exeltech Inc
+				7317 Jack Newell Blvd North
+				Fort Worth  TX  76118
+				US
+
+00-24-CF   (hex)		Inscape Data Corporation
+0024CF     (base 16)		Inscape Data Corporation
+				1611 South Main Street
+				Milpitas  CA  95035
+				US
+
+00-24-C6   (hex)		Hager Electro SAS
+0024C6     (base 16)		Hager Electro SAS
+				132, boulevard d'Europe
+				Obernai  Bas-Rhin  67215
+				FR
+
+00-24-FD   (hex)		Accedian Networks Inc
+0024FD     (base 16)		Accedian Networks Inc
+				2351 Alfred Nobel Blvd
+				Saint Laurent  QC  h4s 2A9
+				CA
+
+00-25-23   (hex)		OCP Inc.
+002523     (base 16)		OCP Inc.
+				18495 S Dixie Hwy    PMB 107
+				Miami  Florida  33157
+				US
+
+00-25-1D   (hex)		DSA Encore, LLC
+00251D     (base 16)		DSA Encore, LLC
+				50 Pocono Rd
+				Brookfield  CT  06804
+				US
+
+00-25-0F   (hex)		On-Ramp Wireless, Inc.
+00250F     (base 16)		On-Ramp Wireless, Inc.
+				16885 West Bernardo Drive
+				San Diego  CA  92127
+				US
+
+00-24-F5   (hex)		NDS Surgical Imaging
+0024F5     (base 16)		NDS Surgical Imaging
+				5750 Hellyer Ave.
+				San Jose  CA.  95138
+				US
+
+00-24-67   (hex)		AOC International (Europe) GmbH
+002467     (base 16)		AOC International (Europe) GmbH
+				Lahnstrasse 86A
+				Berlin    12055
+				DE
+
+00-24-6D   (hex)		Weinzierl Engineering GmbH
+00246D     (base 16)		Weinzierl Engineering GmbH
+				Bahnhofstrasse 6
+				Tyrlaching  Bayern  84558
+				DE
+
+00-24-70   (hex)		AUROTECH ultrasound AS.
+002470     (base 16)		AUROTECH ultrasound AS.
+				Svingen 1
+				Tydal  Sr-Tr  N-7590
+				NO
+
+00-24-6A   (hex)		Solid Year Co., Ltd.
+00246A     (base 16)		Solid Year Co., Ltd.
+				2F-1, No. 94, Bao-chung Road,
+				Hsin-tien City  Taipei Hsien  23147
+				TW
+
+00-24-92   (hex)		Motorola, Broadband Solutions Group
+002492     (base 16)		Motorola, Broadband Solutions Group
+				1101 Marina Village Parkway
+				Alameda  CA  94501
+				US
+
+00-24-8B   (hex)		HYBUS CO., LTD.
+00248B     (base 16)		HYBUS CO., LTD.
+				Rm# 701, Daerung Post Tower 1st
+				SEOUL    152-790
+				KR
+
+00-24-84   (hex)		Bang and Olufsen Medicom a/s
+002484     (base 16)		Bang and Olufsen Medicom a/s
+				Gimsinglundvej 20
+				Struer  DK  DK7600
+				DK
+
+00-24-80   (hex)		Meteocontrol GmbH
+002480     (base 16)		Meteocontrol GmbH
+				Spichererstrasse 48
+				Augsburg  Bavaria  86152
+				DE
+
+00-24-7A   (hex)		FU YI CHENG Technology Co., Ltd.
+00247A     (base 16)		FU YI CHENG Technology Co., Ltd.
+				13F, No. 105-1, Jilin Rd., Luju Shiang,
+				Taoyuan    338
+				TW
+
+00-24-76   (hex)		TAP.tv
+002476     (base 16)		TAP.tv
+				16w361 South Frontage Road
+				Burr Ridge  IL  60527
+				US
+
+00-24-B4   (hex)		ESCATRONIC GmbH
+0024B4     (base 16)		ESCATRONIC GmbH
+				Wuerzburger Str. 8
+				Laatzen  Lower Saxony  30880
+				DE
+
+00-24-B1   (hex)		Coulomb Technologies
+0024B1     (base 16)		Coulomb Technologies
+				1692 Dell Ave
+				Campbell  CA  95008
+				US
+
+00-24-9C   (hex)		Bimeng Comunication System Co. Ltd
+00249C     (base 16)		Bimeng Comunication System Co. Ltd
+				Level 16/f, Tower B,Sinotrans Plaza,No.43, Xi Zhi Men Northern Road,Hai dian District
+				Beijing    100044
+				CN
+
+00-24-98   (hex)		Cisco Systems, Inc
+002498     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-24-52   (hex)		Silicon Software GmbH
+002452     (base 16)		Silicon Software GmbH
+				Steubenstrasse 46
+				Mannheim  Baden-Wuerttemberg  68163
+				DE
+
+00-24-53   (hex)		Initra d.o.o.
+002453     (base 16)		Initra d.o.o.
+				Slomskova 33
+				Ljubljana    1000
+				SI
+
+00-24-4C   (hex)		Solartron Metrology Ltd
+00244C     (base 16)		Solartron Metrology Ltd
+				Steyning Way
+				Bognor Regis  West Sussex  PO20 9ST
+				GB
+
+00-24-48   (hex)		SpiderCloud Wireless, Inc
+002448     (base 16)		SpiderCloud Wireless, Inc
+				475 Sycamore Drive
+				Milpitas  CA  95035
+				US
+
+00-24-4B   (hex)		PERCEPTRON INC
+00244B     (base 16)		PERCEPTRON INC
+				47827 HALYARD DR
+				PLYMOUTH  MI  48170
+				US
+
+00-24-28   (hex)		EnergyICT
+002428     (base 16)		EnergyICT
+				Theodoor Sevenslaan 104a
+				Kortrijk    8500
+				BE
+
+00-24-17   (hex)		Thomson Telecom Belgium
+002417     (base 16)		Thomson Telecom Belgium
+				Prins Boudewijnlaan 47
+				Edegem  Antwerp  B-2650
+				BE
+
+00-24-16   (hex)		Any Use
+002416     (base 16)		Any Use
+				LG APT 211-1805,
+				Yongin City  Gyeong-Gi Province  448-150
+				KR
+
+00-24-2A   (hex)		Hittite Microwave Corporation
+00242A     (base 16)		Hittite Microwave Corporation
+				20 Alpha Rd
+				Chelmsford  MA  01824
+				US
+
+00-24-22   (hex)		Knapp Logistik Automation GmbH
+002422     (base 16)		Knapp Logistik Automation GmbH
+				Günter Knapp-Straße 5-7
+				Hart bei Graz  Styria  8075
+				AT
+
+00-24-1B   (hex)		iWOW Communications Pte Ltd
+00241B     (base 16)		iWOW Communications Pte Ltd
+				1 Lorong 2 Toa Payoh #04-01
+				    319637
+				SG
+
+00-24-5E   (hex)		Hivision Co.,ltd
+00245E     (base 16)		Hivision Co.,ltd
+				2201-2202, COFCO Property Tower,
+				Shenzhen  Guangdong  518101
+				CN
+
+00-24-4D   (hex)		Hokkaido Electronics Corporation
+00244D     (base 16)		Hokkaido Electronics Corporation
+				1-1 East 10 North 10
+				Sapporo  Hokkaido  065-0010
+				JP
+
+00-24-42   (hex)		Axona Limited
+002442     (base 16)		Axona Limited
+				Unit 4U St. Albans Enterprise Centre
+				St. Albans  Herts  AL3 6EN
+				GB
+
+00-24-00   (hex)		Nortel Networks
+002400     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-23-FB   (hex)		IP Datatel, LLC.
+0023FB     (base 16)		IP Datatel, LLC.
+				13110 Southwest Freeway
+				Sugar Land  Texas  77478
+				US
+
+00-24-09   (hex)		The Toro Company
+002409     (base 16)		The Toro Company
+				5825 Jasmine Street
+				Riverside  CA  92504
+				US
+
+00-24-06   (hex)		Pointmobile
+002406     (base 16)		Pointmobile
+				301,World Meridian Verture Center-1 60-24
+				Seoul  Geumcheon-gu  153781
+				KR
+
+00-24-3C   (hex)		S.A.A.A.
+00243C     (base 16)		S.A.A.A.
+				Z.A. Croix Saint Mathieu
+				GALLARDON  Eure et Loir  28320
+				FR
+
+00-23-D3   (hex)		AirLink WiFi Networking Corp.
+0023D3     (base 16)		AirLink WiFi Networking Corp.
+				19F-1 Room A , No.97, Sec 4, Chung Hsin Rd.,
+				San Chung City,  Taipei Hsien  241
+				TW
+
+00-23-CA   (hex)		Behind The Set, LLC
+0023CA     (base 16)		Behind The Set, LLC
+				2185 Knollwood Dr.
+				Boulder  CO  80302
+				US
+
+00-23-CB   (hex)		Shenzhen Full-join Technology Co.,Ltd
+0023CB     (base 16)		Shenzhen Full-join Technology Co.,Ltd
+				9/F,No.1,Xinrui Road,Hourui ,Xixiang Town, Bao'an District
+				ShenZhen  GuangDong  518000
+				CN
+
+00-23-AD   (hex)		Xmark Corporation
+0023AD     (base 16)		Xmark Corporation
+				309 Legget  Drive
+				Ottawa  Ontario  K2K 3A3
+				CA
+
+00-23-AB   (hex)		Cisco Systems, Inc
+0023AB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-23-A4   (hex)		New Concepts Development Corp.
+0023A4     (base 16)		New Concepts Development Corp.
+				2650 Bridge Lane
+				Woodstock  IL  60098
+				US
+
+00-23-DC   (hex)		Benein, Inc
+0023DC     (base 16)		Benein, Inc
+				Hyojachonjesangga228 B9, 297,
+				Sengnam-si  Kyunggi-do  463-818
+				KR
+
+00-23-D1   (hex)		TRG
+0023D1     (base 16)		TRG
+				Wisma Kosgoro 13th Floor
+				Jakarta Pusat    10350
+				ID
+
+00-23-FE   (hex)		Biodevices, SA
+0023FE     (base 16)		Biodevices, SA
+				Rua 5 de Outubro, 309
+				Porto    4100-175
+				PT
+
+00-23-F4   (hex)		Masternaut
+0023F4     (base 16)		Masternaut
+				4, rue Charles Cros
+				Louviers    27407
+				FR
+
+00-23-D0   (hex)		Uniloc USA Inc.
+0023D0     (base 16)		Uniloc USA Inc.
+				3333 Michelson Drive
+				Irvine  CA  92612
+				US
+
+00-23-C7   (hex)		AVSystem
+0023C7     (base 16)		AVSystem
+				ul. Friedleina 4
+				Kraków  małopolskie  30-009
+				PL
+
+00-23-C3   (hex)		LogMeIn, Inc.
+0023C3     (base 16)		LogMeIn, Inc.
+				500 Unicorn Park Drive
+				Woburn  Massachusetts  01801
+				US
+
+00-23-B0   (hex)		COMXION Technology Inc.
+0023B0     (base 16)		COMXION Technology Inc.
+				11F, No. 111, Sec 2, Keelung Rd., Sinyi Distric
+				Taipei  Taiwan  110
+				TW
+
+00-23-E1   (hex)		Cavena Image Products AB
+0023E1     (base 16)		Cavena Image Products AB
+				Nytorpsvägen 26
+				Täby  Stockholm  se-183 53
+				SE
+
+00-23-7E   (hex)		ELSTER GMBH
+00237E     (base 16)		ELSTER GMBH
+				KUHLMANNSTRASSE 10
+				HAMELN    31785
+				DE
+
+00-23-7C   (hex)		NEOTION
+00237C     (base 16)		NEOTION
+				ZI les Paluds
+				AUBAGNE    F-13400
+				FR
+
+00-23-7A   (hex)		RIM
+00237A     (base 16)		RIM
+				295 Phillip Street
+				Waterloo  Ontario  N2L 3W8
+				CA
+
+00-23-6D   (hex)		ResMed Ltd
+00236D     (base 16)		ResMed Ltd
+				1, Elizabeth Macarthur Drive
+				Bella Vista  NSW  2153
+				AU
+
+00-23-6B   (hex)		Xembedded, Inc.
+00236B     (base 16)		Xembedded, Inc.
+				1050 Highland Dr
+				Ann Arbor  MI  48108
+				US
+
+00-23-61   (hex)		Unigen Corporation
+002361     (base 16)		Unigen Corporation
+				45388 Warm Springs Blvd
+				Fremont  CA  94539
+				US
+
+00-23-2C   (hex)		Senticare
+00232C     (base 16)		Senticare
+				161 Worcester Rd
+				Framingham  MA  01701
+				US
+
+00-23-2B   (hex)		IRD A/S
+00232B     (base 16)		IRD A/S
+				Kullinggade 31
+				Svendborg  Fyn  5700
+				DK
+
+00-23-36   (hex)		METEL s.r.o.
+002336     (base 16)		METEL s.r.o.
+				Zizkuv Kopec 617
+				Ceska Skalice  Nachod  55203
+				CZ
+
+00-23-38   (hex)		OJ-Electronics A/S
+002338     (base 16)		OJ-Electronics A/S
+				Stenager 13B
+				Sønderborg    6400
+				DK
+
+00-23-3B   (hex)		C-Matic Systems Ltd
+00233B     (base 16)		C-Matic Systems Ltd
+				Warren Court
+				Crowborough  East Sussex  TN6 2QX
+				GB
+
+00-23-2A   (hex)		eonas IT-Beratung und -Entwicklung GmbH
+00232A     (base 16)		eonas IT-Beratung und -Entwicklung GmbH
+				Greifenhagener Str. 54
+				Berlin    10437
+				DE
+
+00-23-27   (hex)		Shouyo Electronics CO., LTD
+002327     (base 16)		Shouyo Electronics CO., LTD
+				4F., No.8, Lane 345, Yang Kung St.
+				Taipei    11491
+				TW
+
+00-23-28   (hex)		ALCON TELECOMMUNICATIONS CO., LTD.
+002328     (base 16)		ALCON TELECOMMUNICATIONS CO., LTD.
+				2nd FL, NO 480-5, SEC. 6, YEN-PING N. RD.,
+				TAIPEI  TAIWAN  111
+				TW
+
+00-23-72   (hex)		MORE STAR INDUSTRIAL GROUP LIMITED
+002372     (base 16)		MORE STAR INDUSTRIAL GROUP LIMITED
+				Rm1221-1225, F12 Sangda Science and Technology Building ,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-23-4C   (hex)		KTC AB
+00234C     (base 16)		KTC AB
+				F O Petersons gata 6
+				Vastra Frolunda  Gothenburg  SE-42131
+				SE
+
+00-23-43   (hex)		TEM AG
+002343     (base 16)		TEM AG
+				Triststrasse 8
+				Chur    7007
+				CH
+
+00-23-5F   (hex)		Silicon Micro Sensors GmbH
+00235F     (base 16)		Silicon Micro Sensors GmbH
+				Grenzstrasse 28 / Gebäude 32
+				Dresden  Saxony  01109
+				DE
+
+00-23-85   (hex)		ANTIPODE
+002385     (base 16)		ANTIPODE
+				5 RUE DE DOUAI
+				PARIS  ILE DE FRANCE  75009
+				FR
+
+00-22-D8   (hex)		Shenzhen GST Security and Safety Technology Limited
+0022D8     (base 16)		Shenzhen GST Security and Safety Technology Limited
+				Room 502,Building 6 of Kupai Infomation Harbour,
+				Shenzhen  Guangdong  518040
+				CN
+
+00-22-DC   (hex)		Vigil Health Solutions Inc.
+0022DC     (base 16)		Vigil Health Solutions Inc.
+				2102-4464 Markham St
+				Victoria  BC  V8Z 7X8
+				CA
+
+00-22-D9   (hex)		Fortex Industrial Ltd.
+0022D9     (base 16)		Fortex Industrial Ltd.
+				Flat 16, 12 /F.,Pacific Trade Centre
+				Kowloon  Hong Kong  852
+				CN
+
+00-22-D3   (hex)		Hub-Tech
+0022D3     (base 16)		Hub-Tech
+				77, Imae-dong
+				Seongnam-si  Gyeonggi-do  463-829
+				KR
+
+00-22-D4   (hex)		ComWorth Co., Ltd.
+0022D4     (base 16)		ComWorth Co., Ltd.
+				2-35-7 Nishimagome
+				Ohta-ku  Tokyo  143-0026
+				JP
+
+00-22-FE   (hex)		Advanced Illumination
+0022FE     (base 16)		Advanced Illumination
+				440 State Garage Road
+				Rochester  Vermont  05767
+				US
+
+00-23-00   (hex)		Cayee Computer Ltd.
+002300     (base 16)		Cayee Computer Ltd.
+				Units 1002-1003, 10/F, Join-In Hang Sing Centre
+				Kwai Chung  N.T  
+				HK
+
+00-22-F3   (hex)		SHARP Corporation
+0022F3     (base 16)		SHARP Corporation
+				22-22,Nagaike-cho
+				Osaka city  Osaka prefecture  545-8522
+				JP
+
+00-22-F6   (hex)		Syracuse Research Corporation
+0022F6     (base 16)		Syracuse Research Corporation
+				6225 Running Ridge Road
+				North Syracuse  NY  13212
+				US
+
+00-23-0D   (hex)		Nortel Networks
+00230D     (base 16)		Nortel Networks
+				2221 Lakeside Blvd
+				Richardson  TX  75081
+				US
+
+00-23-03   (hex)		LITE-ON IT Corporation
+002303     (base 16)		LITE-ON IT Corporation
+				14F, No. 392, Ruey Kuang Road, Neihu
+				Taipei City    114
+				TW
+
+00-22-ED   (hex)		TSI Power Corporation
+0022ED     (base 16)		TSI Power Corporation
+				1103 West Pierce Avenue
+				Antigo  WI  54409
+				US
+
+00-22-E1   (hex)		ZORT Labs, LLC.
+0022E1     (base 16)		ZORT Labs, LLC.
+				44H Dover Point Road
+				Dover  NH  03820
+				US
+
+00-22-E0   (hex)		Atlantic Software Technologies S.r.L.
+0022E0     (base 16)		Atlantic Software Technologies S.r.L.
+				Via Martino Bassi, 9
+				Milano    20148
+				IT
+
+00-22-DF   (hex)		TAMUZ Monitors
+0022DF     (base 16)		TAMUZ Monitors
+				Tiedenkamp 16
+				Henstedt-Ulzburg  SH  24558
+				DE
+
+00-23-1A   (hex)		ITF Co., Ltd.
+00231A     (base 16)		ITF Co., Ltd.
+				2-2-11 Nishiki-cho
+				Tachikawa-shi  Tokyo  190-0022
+				JP
+
+00-22-BC   (hex)		JDSU France SAS
+0022BC     (base 16)		JDSU France SAS
+				34 rue Necker
+				SAINT ETIENNE  LOIRE  42000
+				FR
+
+00-22-AA   (hex)		Nintendo Co., Ltd.
+0022AA     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-22-C9   (hex)		Lenord, Bauer & Co GmbH
+0022C9     (base 16)		Lenord, Bauer & Co GmbH
+				Dohlenstr 32
+				Oberhausen  NRW  46145
+				DE
+
+00-22-8C   (hex)		Photon Europe GmbH
+00228C     (base 16)		Photon Europe GmbH
+				Jülicher Straße 376
+				Aachen  Nordrhein-Westfalen  52070
+				DE
+
+00-22-8B   (hex)		Kensington Computer Products Group
+00228B     (base 16)		Kensington Computer Products Group
+				333 Twin Dolphin Dr.
+				Redwood Shores  CA  94065
+				US
+
+00-22-8D   (hex)		GBS Laboratories LLC
+00228D     (base 16)		GBS Laboratories LLC
+				2325 Dulles Corner Blvd
+				Herndon  VA  20171
+				US
+
+00-22-4C   (hex)		Nintendo Co., Ltd.
+00224C     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-22-4A   (hex)		RAYLASE AG
+00224A     (base 16)		RAYLASE AG
+				Argelsrieder Feld 2-4
+				Wessling  Bavaria  82234
+				DE
+
+00-22-4B   (hex)		AIRTECH TECHNOLOGIES, INC.
+00224B     (base 16)		AIRTECH TECHNOLOGIES, INC.
+				19fl-4, no.77, Hsin Tai Wu Rd., sec.1, Hsin-Chih
+				Taipei    221
+				TW
+
+00-22-56   (hex)		Cisco Systems, Inc
+002256     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-22-52   (hex)		ZOLL Lifecor Corporation
+002252     (base 16)		ZOLL Lifecor Corporation
+				121 Freeport Road
+				Pittsburgh  PA  15238
+				US
+
+00-22-4D   (hex)		MITAC INTERNATIONAL CORP.
+00224D     (base 16)		MITAC INTERNATIONAL CORP.
+				6TH FL., NO187, TIDING BLVD., SEC. 2
+				Taipei    114
+				TW
+
+00-22-9F   (hex)		Sensys Traffic AB
+00229F     (base 16)		Sensys Traffic AB
+				Slottsgatan 14
+				Jonkoping  Smaland  55322
+				SE
+
+00-22-99   (hex)		SeaMicro Inc.
+002299     (base 16)		SeaMicro Inc.
+				4677 Old Ironsides Dr.,
+				Santa Clara  CA  95054
+				US
+
+00-22-6D   (hex)		Shenzhen GIEC Electronics Co., Ltd.
+00226D     (base 16)		Shenzhen GIEC Electronics Co., Ltd.
+				24/F, XiNian Center, ShenNan Road 6021#, Futian District
+				Shenzhen  Guangdong Province  518040
+				CN
+
+00-22-6E   (hex)		Gowell Electronic Limited
+00226E     (base 16)		Gowell Electronic Limited
+				Room 3601 ,36 Floor,Golden Central Tower,Jintian Road,Futian Central District,
+				Shenzhen  GuangDong  518048
+				CN
+
+00-22-5D   (hex)		Digicable Network India Pvt. Ltd.
+00225D     (base 16)		Digicable Network India Pvt. Ltd.
+				7B, Shah Industrial Estate
+				Andheri - West, Mumbai.  Maharashtra  400 053
+				IN
+
+00-22-7B   (hex)		Apogee Labs, Inc.
+00227B     (base 16)		Apogee Labs, Inc.
+				210 S. 3rd St.
+				North Wales  PA  19454
+				US
+
+00-22-89   (hex)		Vandelrande APC inc.
+002289     (base 16)		Vandelrande APC inc.
+				1280 Lebourgneuf Blvd.
+				Quebec    G2K 0H1
+				CA
+
+00-22-7D   (hex)		YE DATA INC.
+00227D     (base 16)		YE DATA INC.
+				182 Shinko
+				Iruma  Saitama  358-0055
+				JP
+
+00-22-A8   (hex)		Ouman Oy
+0022A8     (base 16)		Ouman Oy
+				Voimatie 6
+				Kempele    FIN-90440
+				FI
+
+00-22-23   (hex)		TimeKeeping Systems, Inc.
+002223     (base 16)		TimeKeeping Systems, Inc.
+				30700 Bainbridge Road
+				Solon  OH  44139
+				US
+
+00-22-1A   (hex)		Audio Precision
+00221A     (base 16)		Audio Precision
+				5750 SW Arctic Drive
+				Beaverton  OR  97005
+				US
+
+00-22-18   (hex)		AKAMAI TECHNOLOGIES INC
+002218     (base 16)		AKAMAI TECHNOLOGIES INC
+				150 BROADWAY
+				CAMBRIDGE  MA  02142
+				US
+
+00-22-3C   (hex)		RATIO Entwicklungen GmbH
+00223C     (base 16)		RATIO Entwicklungen GmbH
+				Ludwig-Erhard-Strasse 22
+				Hamburg    20459
+				DE
+
+00-21-E7   (hex)		Informatics Services Corporation
+0021E7     (base 16)		Informatics Services Corporation
+				140, Negin Bldg.,
+				Tehran    1549534511
+				IR
+
+00-21-DC   (hex)		TECNOALARM S.r.l.
+0021DC     (base 16)		TECNOALARM S.r.l.
+				Via Cirie'
+				San Mauro Torinese  Torino  10099
+				IT
+
+00-21-F1   (hex)		Tutus Data AB
+0021F1     (base 16)		Tutus Data AB
+				Svardvagen 11
+				Danderyd  Stockholm  18233
+				SE
+
+00-21-E3   (hex)		SerialTek LLC
+0021E3     (base 16)		SerialTek LLC
+				1570 Oakland Road
+				San Jose  CA  95131
+				US
+
+00-22-1C   (hex)		Private
+00221C     (base 16)		Private
+
+00-22-22   (hex)		Schaffner Deutschland GmbH
+002222     (base 16)		Schaffner Deutschland GmbH
+				Nürtingen Branch
+				Nürtingen  BW  D-72622
+				DE
+
+00-21-F8   (hex)		Enseo, Inc.
+0021F8     (base 16)		Enseo, Inc.
+				401 International Parkway
+				Richardson  TX  75081
+				US
+
+00-21-F3   (hex)		Si14 SpA
+0021F3     (base 16)		Si14 SpA
+				Via Tommaseo 77
+				Padova  PD  35131
+				IT
+
+00-22-31   (hex)		SMT&C Co., Ltd.
+002231     (base 16)		SMT&C Co., Ltd.
+				2Fr. Haksan Bldg. 110, Gwangjang-dong, Gwangjin-gu
+				Seoul    143-802
+				KR
+
+00-22-13   (hex)		PCI CORPORATION
+002213     (base 16)		PCI CORPORATION
+				No.25, Lane 66, Hebei 1st St.,  Beitun District
+				Taichung    406
+				TW
+
+00-22-01   (hex)		Aksys Networks Inc
+002201     (base 16)		Aksys Networks Inc
+				428, 3553 - 31 Street NW
+				Calgary    T2L 2K7
+				CA
+
+00-21-7B   (hex)		Bastec AB
+00217B     (base 16)		Bastec AB
+				Hästvägen 4A
+				Malmö  SE  212 35
+				SE
+
+00-21-76   (hex)		YMax Telecom Ltd.
+002176     (base 16)		YMax Telecom Ltd.
+				11 Moshe Levi str.
+				Rishon Le Zion    75658
+				IL
+
+00-21-71   (hex)		Wesung TNC Co., Ltd.
+002171     (base 16)		Wesung TNC Co., Ltd.
+				102-1409, Bucheon Chunui Technopark 1st,
+				Bucheon-City,  Gyeongggi-Do  420-857
+				KR
+
+00-21-93   (hex)		Videofon MV
+002193     (base 16)		Videofon MV
+				6 Blackoak Mews
+				Newtown  PA  18940
+				US
+
+00-21-92   (hex)		Baoding Galaxy Electronic Technology  Co.,Ltd
+002192     (base 16)		Baoding Galaxy Electronic Technology  Co.,Ltd
+				NO.91 Fengfan Rd.,GaoKai District,Baoding City,Hebei Prov.China 071051
+				Baoding City  Hebei Prov.  071051
+				CN
+
+00-21-A7   (hex)		Hantle System Co., Ltd.
+0021A7     (base 16)		Hantle System Co., Ltd.
+				481-10 Byucksan Digital Vally II, RM 1511
+				Seoul City  Seoul  153-783
+				KR
+
+00-21-9C   (hex)		Honeywld Technology Corp.
+00219C     (base 16)		Honeywld Technology Corp.
+				No.40,Hsueh-Fu Rd.
+				Hsinchu    300
+				TW
+
+00-21-9A   (hex)		Cambridge Visual Networks Ltd
+00219A     (base 16)		Cambridge Visual Networks Ltd
+				61 Selwyn Road
+				Cambridge  Cambridgeshire  CB3 9EA
+				GB
+
+00-21-D8   (hex)		Cisco Systems, Inc
+0021D8     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-D7   (hex)		Cisco Systems, Inc
+0021D7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-D9   (hex)		SEKONIC CORPORATION
+0021D9     (base 16)		SEKONIC CORPORATION
+				7-24-14
+				NERIMA-KU  TOKYO  178-8686
+				JP
+
+00-21-DA   (hex)		Automation Products Group Inc.
+0021DA     (base 16)		Automation Products Group Inc.
+				1025 West 1700 North
+				Logan  Utah  84321
+				US
+
+00-21-B5   (hex)		Galvanic Ltd
+0021B5     (base 16)		Galvanic Ltd
+				38 Nothumberland Road
+				Dublin    2
+				IE
+
+00-21-BD   (hex)		Nintendo Co., Ltd.
+0021BD     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-21-C4   (hex)		Consilium AB
+0021C4     (base 16)		Consilium AB
+				Västra Finnbodavägen 2-4
+				Nacka  Stockholm  13131
+				SE
+
+00-21-89   (hex)		AppTech, Inc.
+002189     (base 16)		AppTech, Inc.
+				363 E Greyhound Pass
+				Carmel  Indiana  46032
+				US
+
+00-21-22   (hex)		Chip-pro Ltd.
+002122     (base 16)		Chip-pro Ltd.
+				5F.-4, No.63, Siwei Rd., North District,
+				Hsinchu    300
+				TW
+
+00-21-25   (hex)		KUK JE TONG SHIN Co.,LTD
+002125     (base 16)		KUK JE TONG SHIN Co.,LTD
+				476-3
+				Incheon  Kwangyouk-Si  407-060
+				KR
+
+00-21-26   (hex)		Shenzhen Torch Equipment Co., Ltd.
+002126     (base 16)		Shenzhen Torch Equipment Co., Ltd.
+				Floor 5, Block 3, Liming Industrial District, Zhongshanyuan Road, Nanshan,
+				Shenzhen  Guangdong  518052
+				CN
+
+00-21-13   (hex)		Padtec S/A
+002113     (base 16)		Padtec S/A
+				Road Campinas Mogi-Mirim km 118,5
+				Campinas  São Paulo  13086-902
+				BR
+
+00-21-12   (hex)		WISCOM SYSTEM CO.,LTD
+002112     (base 16)		WISCOM SYSTEM CO.,LTD
+				100 Jiangjun Road,Jiangning,
+				Nanjing    211100
+				CN
+
+00-21-0E   (hex)		Orpak Systems L.T.D.
+00210E     (base 16)		Orpak Systems L.T.D.
+				31 Lechi St
+				Bnei - Brak    51114
+				IL
+
+00-21-61   (hex)		Yournet Inc.
+002161     (base 16)		Yournet Inc.
+				KT R&D Center
+				Seoul    137-792
+				KR
+
+00-21-5F   (hex)		IHSE GmbH
+00215F     (base 16)		IHSE GmbH
+				Maybachstraße 11
+				Oberteuringen  Baden-Württemberg  88094
+				DE
+
+00-21-35   (hex)		ALCATEL-LUCENT
+002135     (base 16)		ALCATEL-LUCENT
+				Ramirez de Prado 5
+				Madrid    28045
+				ES
+
+00-21-38   (hex)		Cepheid
+002138     (base 16)		Cepheid
+				904 Caribbean Drive
+				Sunnyvale  CA  94089
+				US
+
+00-21-47   (hex)		Nintendo Co., Ltd.
+002147     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-21-49   (hex)		China Daheng Group ,Inc.
+002149     (base 16)		China Daheng Group ,Inc.
+				12F Daheng Science & Technology Tower ,NO.3 Suzhou Str.
+				Beijing    100080
+				CN
+
+00-21-56   (hex)		Cisco Systems, Inc
+002156     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-51   (hex)		Millinet Co., Ltd.
+002151     (base 16)		Millinet Co., Ltd.
+				2F, West Building, IT Venture Tower, 78, Garakbon-Dong
+				Songpa-gu  Seoul  138-803
+				US
+
+00-21-6C   (hex)		ODVA
+00216C     (base 16)		ODVA
+				4220 Varsity Drive
+				Ann Arbor  MI  48108-5006
+				US
+
+00-21-1C   (hex)		Cisco Systems, Inc
+00211C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-21-18   (hex)		Athena Tech, Inc.
+002118     (base 16)		Athena Tech, Inc.
+				3721 Macintosh Dr
+				Warrenton  VA  20187
+				US
+
+00-1F-BD   (hex)		Kyocera Wireless Corp.
+001FBD     (base 16)		Kyocera Wireless Corp.
+				10300 Campus Point Drive
+				San Diego  CA  92121
+				US
+
+00-1F-B9   (hex)		Paltronics
+001FB9     (base 16)		Paltronics
+				1145 Paltronics Ct
+				Crystal Lake  IL  60014
+				US
+
+00-1F-B7   (hex)		WiMate Technologies Corp.
+001FB7     (base 16)		WiMate Technologies Corp.
+				14A Building 2, Guimiao Garden, Nanguanglu, Nanshan District
+				Shenzhen  Guangdong  518054
+				CN
+
+00-1F-B4   (hex)		SmartShare Systems
+001FB4     (base 16)		SmartShare Systems
+				Tonsbakken 16-18
+				Skovlunde    DK-2740
+				DK
+
+00-1F-B6   (hex)		Chi Lin Technology Co., Ltd.
+001FB6     (base 16)		Chi Lin Technology Co., Ltd.
+				No.18, Sheng Li 1st St., Jen Te Hsiang,
+				Tainan  Taiwan  71758
+				CN
+
+00-1F-C8   (hex)		Up-Today Industrial Co., Ltd.
+001FC8     (base 16)		Up-Today Industrial Co., Ltd.
+				7/F., Unify Commercial & Industrial Building
+				Kowloon    
+				HK
+
+00-1F-C5   (hex)		Nintendo Co., Ltd.
+001FC5     (base 16)		Nintendo Co., Ltd.
+				  11-1 HOKOTATE-CHO KAMITOBA, MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+00-1F-C0   (hex)		Control Express Finland Oy
+001FC0     (base 16)		Control Express Finland Oy
+				Laitaatsillantie 3
+				Savonlinna    57170
+				FI
+
+00-1F-BC   (hex)		EVGA Corporation
+001FBC     (base 16)		EVGA Corporation
+				2900 Saturn St.
+				Brea  CA  92821
+				US
+
+00-1F-F9   (hex)		Advanced Knowledge Associates
+001FF9     (base 16)		Advanced Knowledge Associates
+				3350 Scott Blvd, Suite 40
+				Santa Clara  CA  95054-3119
+				US
+
+00-1F-ED   (hex)		Tecan Systems Inc.
+001FED     (base 16)		Tecan Systems Inc.
+				2450 Zanker Road
+				San Jose  CA  95131
+				US
+
+00-1F-E5   (hex)		In-Circuit GmbH
+001FE5     (base 16)		In-Circuit GmbH
+				Königsbrücker Strasse 69
+				Dresden    01099
+				DE
+
+00-1F-F4   (hex)		Power Monitors, Inc.
+001FF4     (base 16)		Power Monitors, Inc.
+				800 North Main Street
+				Mt. Crawford  Virginia  22841
+				US
+
+00-1F-5F   (hex)		Blatand GmbH
+001F5F     (base 16)		Blatand GmbH
+				Lichtenbergstrße 8
+				Garching  Bavaria  85748
+				DE
+
+00-1F-57   (hex)		Phonik Innovation Co.,LTD
+001F57     (base 16)		Phonik Innovation Co.,LTD
+				29/167 Moo2, 345 Rd, Lampo,
+				Nonthaburi    11110
+				TH
+
+00-1F-59   (hex)		Kronback Tracers
+001F59     (base 16)		Kronback Tracers
+				c/o DTU, R254
+				Ballerup  Copenhagen  2750
+				DK
+
+00-1F-4E   (hex)		ConMed Linvatec
+001F4E     (base 16)		ConMed Linvatec
+				11311 Concept Blvd.
+				Largo  FL  33773
+				US
+
+00-1F-AA   (hex)		Taseon, Inc.
+001FAA     (base 16)		Taseon, Inc.
+				 3099 N. First Street
+				San Jose  CA  95134
+				US
+
+00-1F-7B   (hex)		TechNexion Ltd.
+001F7B     (base 16)		TechNexion Ltd.
+				17F-1, No. 16, Jian Ba Road,
+				Chung Ho   Taipei  235
+				TW
+
+00-1F-7D   (hex)		Embedded Wireless GmbH
+001F7D     (base 16)		Embedded Wireless GmbH
+				Soeflinger Strasse 200
+				Ulm  BW  89077
+				DE
+
+00-1F-8D   (hex)		Ingenieurbuero Stark GmbH und Ko. KG
+001F8D     (base 16)		Ingenieurbuero Stark GmbH und Ko. KG
+				Rudolf-Diesel-Strasse 44
+				Laichingen  BW  89150
+				DE
+
+00-1F-AF   (hex)		NextIO, Inc.
+001FAF     (base 16)		NextIO, Inc.
+				8303 N MoPac Expressway
+				Austin  TX  78759
+				US
+
+00-1F-74   (hex)		Eigen Development
+001F74     (base 16)		Eigen Development
+				1807 W10th Ave
+				Vancouver  BC  V6J 2A9
+				CA
+
+00-1F-75   (hex)		GiBahn Media
+001F75     (base 16)		GiBahn Media
+				1816 Rosedale Suseo-dong
+				Seoul    135-885
+				KR
+
+00-1F-8F   (hex)		Shanghai Bellmann Digital Source Co.,Ltd.
+001F8F     (base 16)		Shanghai Bellmann Digital Source Co.,Ltd.
+				404-408 Main Bd, FDUSP, No.11 Guotai Rd.
+				Shanghai    200433
+				CN
+
+00-1F-84   (hex)		Gigle Semiconductor
+001F84     (base 16)		Gigle Semiconductor
+				Barcelona Activa - Vivero Glorias
+				Barcelona    08018
+				ES
+
+00-1F-6E   (hex)		Vtech Engineering Corporation
+001F6E     (base 16)		Vtech Engineering Corporation
+				20 New England Business Center
+				Andover  MA  01810
+				US
+
+00-1F-66   (hex)		PLANAR LLC
+001F66     (base 16)		PLANAR LLC
+				32, Elkina str
+				Chelyabinsk  SU  454091
+				RU
+
+00-1F-A0   (hex)		A10 Networks
+001FA0     (base 16)		A10 Networks
+				3 West Plumeria Drive
+				San Jose  CA  95134
+				US
+
+00-1F-9E   (hex)		Cisco Systems, Inc
+001F9E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1E-E6   (hex)		Shenzhen Advanced Video Info-Tech Co., Ltd.
+001EE6     (base 16)		Shenzhen Advanced Video Info-Tech Co., Ltd.
+				Tianxiang 11A,  Tian'an Cyber Park , Futian
+				Shenzhen  Guangdong  518048
+				CN
+
+00-1E-F7   (hex)		Cisco Systems, Inc
+001EF7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1F-0B   (hex)		Federal State Unitary Enterprise Industrial UnionElectropribor
+001F0B     (base 16)		Federal State Unitary Enterprise Industrial UnionElectropribor
+				
+				Penza    440011
+				RU
+
+00-1F-0C   (hex)		Intelligent Digital Services GmbH
+001F0C     (base 16)		Intelligent Digital Services GmbH
+				Grevesmuehlener Strasse 8
+				Mallentin  Mecklenburg-Vorpommern  23639
+				DE
+
+00-1F-08   (hex)		RISCO LTD
+001F08     (base 16)		RISCO LTD
+				32 Hacharoshet St
+				Kiriat Malachi    83101
+				IL
+
+00-1F-43   (hex)		ENTES ELEKTRONIK
+001F43     (base 16)		ENTES ELEKTRONIK
+				Y. Dudullu Org. San. Bol. And Sanayi Sit. No.6
+				Istanbul  Dudullu  34775
+				TR
+
+00-1F-14   (hex)		NexG
+001F14     (base 16)		NexG
+				5F Seoul Academy Bldg, Daechi-Dong, Gangnam-Gu,
+				Seoul    135-280
+				KR
+
+00-1E-F1   (hex)		Servimat
+001EF1     (base 16)		Servimat
+				ZAET Les Haies
+				St Maximin  Oise  60740
+				FR
+
+00-1E-F4   (hex)		L-3 Communications Display Systems
+001EF4     (base 16)		L-3 Communications Display Systems
+				1355 Bluegrass Lakes Parkway
+				Alpharetta  GA  30004-8458
+				US
+
+00-1E-F5   (hex)		Hitek Automated Inc.
+001EF5     (base 16)		Hitek Automated Inc.
+				Room C3-901, No.383, Huamen Shijia
+				Hangzhou    310012
+				CN
+
+00-1F-0E   (hex)		Japan Kyastem Co., Ltd
+001F0E     (base 16)		Japan Kyastem Co., Ltd
+				1-4-4
+				Tachikawa  Tokyo  190-0022
+				JP
+
+00-1F-28   (hex)		HPN Supply Chain
+001F28     (base 16)		HPN Supply Chain
+				8000 Foothills Blvd
+				Roseville  CA  95747
+				US
+
+00-1F-1E   (hex)		Astec Technology Co., Ltd
+001F1E     (base 16)		Astec Technology Co., Ltd
+				12F, No.2, Jian Ba Rd.
+				Chung Ho  Taipei Hsien  235
+				TW
+
+00-1F-4A   (hex)		Albentia Systems S.A.
+001F4A     (base 16)		Albentia Systems S.A.
+				Albala 13
+				Madrid    28037
+				ES
+
+00-1E-AA   (hex)		E-Senza Technologies GmbH
+001EAA     (base 16)		E-Senza Technologies GmbH
+				Blarerstrasse 56
+				Konstanz  BW  78462
+				DE
+
+00-1E-9C   (hex)		Fidustron INC
+001E9C     (base 16)		Fidustron INC
+				NO.770-6, Jhongiheng Rd.
+				Jhonghe City  Taipei County  235
+				TW
+
+00-1E-97   (hex)		Medium Link System Technology CO., LTD,
+001E97     (base 16)		Medium Link System Technology CO., LTD,
+				11F.-2, No.7, Alley 92, Lane 77, Sec. 4, Sinhai Rd.,
+				Wunshan District,  Taipei  11693
+				TW
+
+00-1E-8B   (hex)		Infra Access Korea Co., Ltd.
+001E8B     (base 16)		Infra Access Korea Co., Ltd.
+				#902, Sambo Saving Bank B/D,
+				Kwanak-gu,  Seoul  151-830
+				KR
+
+00-1E-BB   (hex)		BLUELIGHT TECHNOLOGY INC.
+001EBB     (base 16)		BLUELIGHT TECHNOLOGY INC.
+				6472 CAMDEN AVE., SUITE 102B
+				SAN JOSE  CA  95120
+				US
+
+00-1E-B5   (hex)		Ever Sparkle Technologies Ltd
+001EB5     (base 16)		Ever Sparkle Technologies Ltd
+				Unit 403, Nan Fung Commercial Centre
+				Kowloon Bay  Kowloon  
+				HK
+
+00-1E-B3   (hex)		Primex Wireless
+001EB3     (base 16)		Primex Wireless
+				965 Wells Street
+				Lake Geneva  WI  53147
+				US
+
+00-1E-85   (hex)		Lagotek Corporation
+001E85     (base 16)		Lagotek Corporation
+				11661 SE 1st St. #208
+				Bellevue  WA  98005
+				US
+
+00-1E-D8   (hex)		Digital United Inc.
+001ED8     (base 16)		Digital United Inc.
+				9F, No.220, Gangcian Rd.
+				Taipei    11444
+				TW
+
+00-1E-D6   (hex)		Alentec & Orion AB
+001ED6     (base 16)		Alentec & Orion AB
+				Grustagsvägen 4
+				138 40  ÄLTA  
+				SE
+
+00-1E-C6   (hex)		Obvius Holdings LLC
+001EC6     (base 16)		Obvius Holdings LLC
+				20811 NW Cornell Road
+				Hillsboro  OR  97124
+				US
+
+00-1E-C4   (hex)		Celio Corp
+001EC4     (base 16)		Celio Corp
+				265 E 100 S  # 280
+				Salt Lake City  UT  84111
+				US
+
+00-1E-C1   (hex)		3COM EUROPE LTD
+001EC1     (base 16)		3COM EUROPE LTD
+				Peoplebuilding 2
+				Hemel Hempstead  HERTS.  HP2 4NW
+				GB
+
+00-1E-B6   (hex)		TAG Heuer SA
+001EB6     (base 16)		TAG Heuer SA
+				Rue Louis-Joseph Chevrolet 6A
+				la Chaux-de-Fonds  NE  2300
+				CH
+
+00-1E-AC   (hex)		Armadeus Systems
+001EAC     (base 16)		Armadeus Systems
+				Business Campus
+				MULHOUSE cedex  Haut-Rhin  68058
+				FR
+
+00-1E-77   (hex)		Air2App
+001E77     (base 16)		Air2App
+				50 Old Forge Rd
+				Hanover  MA  02339
+				US
+
+00-1E-7B   (hex)		R.I.CO. S.r.l.
+001E7B     (base 16)		R.I.CO. S.r.l.
+				via Adriatica, 17
+				Castelfidardo  AN  60022
+				IT
+
+00-1E-6E   (hex)		Shenzhen First Mile Communications Ltd
+001E6E     (base 16)		Shenzhen First Mile Communications Ltd
+				5th Floor, Block R3-A
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1E-6D   (hex)		IT R&D Center
+001E6D     (base 16)		IT R&D Center
+				461-25, Jeonmin-dong,Yuseong-Gu
+				Daejeon    305-811
+				KR
+
+00-1E-34   (hex)		CryptoMetrics
+001E34     (base 16)		CryptoMetrics
+				160 Michael Cowpland Dr
+				Ottawa  Ontario  K2M 1P6
+				CA
+
+00-1E-2D   (hex)		STIM
+001E2D     (base 16)		STIM
+				ZAC les COUSTELLIERS
+				CASTRIES  HERAULT  34160
+				FR
+
+00-1E-41   (hex)		Microwave Communication & Component, Inc.
+001E41     (base 16)		Microwave Communication & Component, Inc.
+				#204, WOOLIM LION`S VALLEY 2, 680
+				Seoul    150-787
+				KR
+
+00-1D-FC   (hex)		KSIC
+001DFC     (base 16)		KSIC
+				#6F, Korea Federation of Teacher's Associations, 114-1, TaeBong-Ro,
+				Seoul  Seocho-Ku  137-715
+				KR
+
+00-1E-55   (hex)		COWON SYSTEMS,Inc.
+001E55     (base 16)		COWON SYSTEMS,Inc.
+				6th Fl. COWON TOWER,689-3,
+				Seoul    135-080
+				KR
+
+00-1E-56   (hex)		Bally Wulff Entertainment GmbH
+001E56     (base 16)		Bally Wulff Entertainment GmbH
+				Maybachufer 48-51
+				Berlin    12045
+				DE
+
+00-1E-3F   (hex)		TrellisWare Technologies, Inc.
+001E3F     (base 16)		TrellisWare Technologies, Inc.
+				16516 Via Esprillo, Suite 300
+				San Diego  CA  92127
+				US
+
+00-1E-57   (hex)		ALCOMA, spol. s r.o.
+001E57     (base 16)		ALCOMA, spol. s r.o.
+				Klukovice 313, Praha - 5
+				Praha    152 00
+				CZ
+
+00-1E-50   (hex)		BATTISTONI RESEARCH
+001E50     (base 16)		BATTISTONI RESEARCH
+				PARCO DONICA 56
+				FISCIANO  SALERNO  84084
+				IT
+
+00-1E-11   (hex)		ELELUX INTERNATIONAL LTD
+001E11     (base 16)		ELELUX INTERNATIONAL LTD
+				3F., NO.103 CHOW TZE STREET
+				TAIPEI    114
+				TW
+
+00-1D-F2   (hex)		Netflix, Inc.
+001DF2     (base 16)		Netflix, Inc.
+				100 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+00-1D-EF   (hex)		TRIMM, INC.
+001DEF     (base 16)		TRIMM, INC.
+				407 RAILROAD STREET
+				BUTNER  NC  27509
+				US
+
+00-1D-F1   (hex)		Intego Systems, Inc.
+001DF1     (base 16)		Intego Systems, Inc.
+				5343 Bowden Road
+				Jacksonville  FL  32216
+				US
+
+00-1D-ED   (hex)		Grid Net, Inc.
+001DED     (base 16)		Grid Net, Inc.
+				340 Brannan Street
+				San Francisco  CA  94107
+				US
+
+00-1D-C3   (hex)		RIKOR TV, Ltd
+001DC3     (base 16)		RIKOR TV, Ltd
+				Kostomarovsky per.,3
+				Moscow    105120
+				RU
+
+00-1D-C1   (hex)		Audinate Pty L
+001DC1     (base 16)		Audinate Pty L
+				Level 1, 458 Wattle St
+				Ultimo  NSW  2007
+				AU
+
+00-1D-B2   (hex)		HOKKAIDO ELECTRIC ENGINEERING CO.,LTD.
+001DB2     (base 16)		HOKKAIDO ELECTRIC ENGINEERING CO.,LTD.
+				Nishinopporo 120-8
+				Ebetu-City  Hokkaido  069-0832
+				JP
+
+00-1D-AD   (hex)		Sinotech Engineering Consultants, Inc.  Geotechnical Enginee
+001DAD     (base 16)		Sinotech Engineering Consultants, Inc.  Geotechnical Enginee
+				Basement No.7 Lane 26, Yat-Sen Rd.
+				Taipei    110
+				TW
+
+00-1D-AB   (hex)		SwissQual License AG
+001DAB     (base 16)		SwissQual License AG
+				Baarerstrasse 78
+				Zug  Postfach  117
+				CH
+
+00-1D-9C   (hex)		Rockwell Automation
+001D9C     (base 16)		Rockwell Automation
+				1 Allen-Bradley Dr.
+				Mayfield Heights  OH  44124-6118
+				US
+
+00-1D-A0   (hex)		Heng Yu Electronic Manufacturing Company Limited
+001DA0     (base 16)		Heng Yu Electronic Manufacturing Company Limited
+				Room 1503-5, Nan Fung Com'l Centre,
+				Kowloon    
+				HK
+
+00-1D-D8   (hex)		Microsoft Corporation
+001DD8     (base 16)		Microsoft Corporation
+				One Microsoft Way
+				Redmond  Washington  98052-6399
+				US
+
+00-1D-C8   (hex)		Navionics Research Inc., dba SCADAmetrics
+001DC8     (base 16)		Navionics Research Inc., dba SCADAmetrics
+				1133 Pond Road
+				Wildwood  Missouri  63038
+				US
+
+00-1D-CC   (hex)		Ayon Cyber Security, Inc
+001DCC     (base 16)		Ayon Cyber Security, Inc
+				2350 Commerce Park Dr.
+				Palm Bay  FL  32905
+				US
+
+00-1D-92   (hex)		MICRO-STAR INT'L CO.,LTD.
+001D92     (base 16)		MICRO-STAR INT'L CO.,LTD.
+				No.69,Li-De St,Jung-Ho City
+				Taipei  Hsien  235
+				TW
+
+00-1D-8A   (hex)		TechTrex Inc
+001D8A     (base 16)		TechTrex Inc
+				6221 Highway 7, Unit 12
+				Woodbridge  Ontalio  L4H 0K8
+				CA
+
+00-1D-80   (hex)		Beijing Huahuan Eletronics Co.,Ltd
+001D80     (base 16)		Beijing Huahuan Eletronics Co.,Ltd
+				No.26,Shangdi 6th St.Haidian District,
+				Beijing    100085
+				CN
+
+00-1D-83   (hex)		Emitech Corporation
+001D83     (base 16)		Emitech Corporation
+				2F,No.7-1,Industry E,Rd.9
+				Hsinchu    308
+				TW
+
+00-1D-74   (hex)		Tianjin China-Silicon Microelectronics Co., Ltd.
+001D74     (base 16)		Tianjin China-Silicon Microelectronics Co., Ltd.
+				301,3F Building 211,No.214 Hongqi Road, Nankai District, Tianjin China
+				Tianjin    300190
+				CN
+
+00-1D-4B   (hex)		Grid Connect Inc.
+001D4B     (base 16)		Grid Connect Inc.
+				1630 W. Diehl Rd
+				Naperville  IL  60563
+				US
+
+00-1D-4D   (hex)		Adaptive Recognition Hungary, Inc
+001D4D     (base 16)		Adaptive Recognition Hungary, Inc
+				Kiralyhago ter 8-9
+				Budapest  Europe  1126
+				HU
+
+00-1D-1E   (hex)		KYUSHU TEN CO.,LTD
+001D1E     (base 16)		KYUSHU TEN CO.,LTD
+				2360 YUNOKIMOTOMACHI
+				SASEBO-City  NAGASAKI Prefecture  857-0115
+				JP
+
+00-1D-1D   (hex)		Inter-M Corporation
+001D1D     (base 16)		Inter-M Corporation
+				653-5 Banghak-Dong, Dobong-Ku
+				Seoul    132-846
+				KR
+
+00-1D-0E   (hex)		Agapha Technology co., Ltd.
+001D0E     (base 16)		Agapha Technology co., Ltd.
+				9F No.121, Shingde Rd.,
+				Sanchung City  Taipei County  241
+				TW
+
+00-1D-0A   (hex)		Davis Instruments, Inc.
+001D0A     (base 16)		Davis Instruments, Inc.
+				3465 Diablo Ave.
+				Hayward  CA  94545
+				US
+
+00-1D-67   (hex)		AMEC
+001D67     (base 16)		AMEC
+				9F,No.360,Ruel Guang Rd,Neihu
+				Taipei    114
+				TW
+
+00-1D-7C   (hex)		ABE Elettronica S.p.A.
+001D7C     (base 16)		ABE Elettronica S.p.A.
+				Via Leonardo da Vinci, 92
+				CARAVAGGIO  BG  24043
+				IT
+
+00-1D-6D   (hex)		Confidant International LLC
+001D6D     (base 16)		Confidant International LLC
+				2530 Meridian Pkwy
+				Durham  North Carolina  27713
+				US
+
+00-1D-75   (hex)		Radioscape PLC
+001D75     (base 16)		Radioscape PLC
+				1 Albany Terrace
+				Regent's Park  London  NW1 4DS
+				GB
+
+00-1D-53   (hex)		S&O Electronics (Malaysia) Sdn. Bhd.
+001D53     (base 16)		S&O Electronics (Malaysia) Sdn. Bhd.
+				Lot 202, Bakar Arang
+				08000 Sungai Petani  Kedah  
+				MY
+
+00-1D-54   (hex)		Sunnic Technology & Merchandise INC.
+001D54     (base 16)		Sunnic Technology & Merchandise INC.
+				6F, NO.74,ZHOU-Z ST.,
+				Taipei    114
+				TW
+
+00-1D-5F   (hex)		OverSpeed SARL
+001D5F     (base 16)		OverSpeed SARL
+				15, allee du Bois Cailley
+				Le Thuit-Signol  Normandie  27370
+				FR
+
+00-1D-58   (hex)		CQ Inc
+001D58     (base 16)		CQ Inc
+				5F, No. 43, Lane 76, Rui Guang Road
+				Taipei    114
+				TW
+
+00-1D-87   (hex)		VigTech Labs Sdn Bhd
+001D87     (base 16)		VigTech Labs Sdn Bhd
+				45-11 The Boulevard Mid Valley City
+				Kuala Lumpur  Selangor  59200
+				MY
+
+00-1D-2F   (hex)		QuantumVision Corporation
+001D2F     (base 16)		QuantumVision Corporation
+				335 Plantation Way
+				Roswell  Ga  30075
+				US
+
+00-1C-E5   (hex)		MBS Electronic Systems GmbH
+001CE5     (base 16)		MBS Electronic Systems GmbH
+				Ringstrasse 3
+				82319 Starnberg  Bavaria  82319
+				DE
+
+00-1C-DD   (hex)		COWBELL ENGINEERING CO., LTD.
+001CDD     (base 16)		COWBELL ENGINEERING CO., LTD.
+				1739-1 Nagatoro
+				SAKU  Nagano  385-0021
+				JP
+
+00-1C-C2   (hex)		Part II Research, Inc.
+001CC2     (base 16)		Part II Research, Inc.
+				4601 E. Airport Dr.
+				Ontario  CA  91761
+				US
+
+00-1C-BD   (hex)		Ezze Mobile Tech., Inc.
+001CBD     (base 16)		Ezze Mobile Tech., Inc.
+				3F, Bubmusa Bldg., 151-31
+				  Seoul  135-824
+				KR
+
+00-1C-B8   (hex)		CBC Co., Ltd
+001CB8     (base 16)		CBC Co., Ltd
+				2-15-13, Tsukishima, Chuo-ku
+				Tokyo    104-0052
+				JP
+
+00-1C-AC   (hex)		Qniq Technology Corp.
+001CAC     (base 16)		Qniq Technology Corp.
+				5F, No.133, Sec.4, Minsheng E. Rd.,
+				Taipei    105
+				TW
+
+00-1C-A5   (hex)		Zygo Corporation
+001CA5     (base 16)		Zygo Corporation
+				21 Laurel Brook Rd.
+				Middlefield  CT  06455
+				US
+
+00-1C-9D   (hex)		Liecthi AG
+001C9D     (base 16)		Liecthi AG
+				10 Unterholz Street
+				Kriegstetten  Solothurn  4566
+				CH
+
+00-1C-FF   (hex)		Napera Networks Inc
+001CFF     (base 16)		Napera Networks Inc
+				7683 SE 27th
+				Mercer Island  WA  98040
+				US
+
+00-1C-DC   (hex)		Custom Computer Services, Inc.
+001CDC     (base 16)		Custom Computer Services, Inc.
+				1020 Spring City Drive
+				Waukesha  WI  53186
+				US
+
+00-1C-D1   (hex)		Waves Audio LTD
+001CD1     (base 16)		Waves Audio LTD
+				Azrilei Center 3, Triangle tower
+				Tel Aviv  Central  67023
+				IL
+
+00-1C-ED   (hex)		ENVIRONNEMENT SA
+001CED     (base 16)		ENVIRONNEMENT SA
+				111 bd. Robespierre
+				POISSY  Yvelines  78300
+				FR
+
+00-1C-BA   (hex)		VerScient, Inc.
+001CBA     (base 16)		VerScient, Inc.
+				7700 Equitable Drive
+				Eden Prairie  MN  55344
+				US
+
+00-1C-B0   (hex)		Cisco Systems, Inc
+001CB0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-4C   (hex)		Petrotest Instruments
+001C4C     (base 16)		Petrotest Instruments
+				Ludwig-Erhard-Ring 13
+				Dahlewitz  BBG  15827
+				DE
+
+00-1C-45   (hex)		Chenbro Micom Co., Ltd.
+001C45     (base 16)		Chenbro Micom Co., Ltd.
+				15Fl., No. 150, Jian Yi Road
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-1C-3C   (hex)		Seon Design Inc.
+001C3C     (base 16)		Seon Design Inc.
+				111-3B Burbidge Street
+				Coquitlam  BC  V3K 7B2
+				CA
+
+00-1C-57   (hex)		Cisco Systems, Inc
+001C57     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1C-5D   (hex)		Leica Microsystems
+001C5D     (base 16)		Leica Microsystems
+				Lothbury House Cambridge Technopark
+				Cambridge    CB5 8PB
+				GB
+
+00-1C-5E   (hex)		ASTON France
+001C5E     (base 16)		ASTON France
+				151 Avenue Gallieni
+				BAGNOLET  ile de france  93177
+				FR
+
+00-1C-55   (hex)		Shenzhen Kaifa Technology Co.
+001C55     (base 16)		Shenzhen Kaifa Technology Co.
+				7006 Caitian Road, Futian District,
+				Shenzhen  Guangdong  518035
+				CN
+
+00-1C-5B   (hex)		Chubb Electronic Security Systems Ltd
+001C5B     (base 16)		Chubb Electronic Security Systems Ltd
+				Shadsworth Road
+				Blackburn  Lancashire  BB1 2PR
+				GB
+
+00-1C-44   (hex)		Bosch Security Systems BV
+001C44     (base 16)		Bosch Security Systems BV
+				Kapittelweg 10
+				4827 HG  Breda  Brabant  4827
+				NL
+
+00-1C-82   (hex)		Genew Technologies
+001C82     (base 16)		Genew Technologies
+				3A3 Building B1, Cyber-tech Zone,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-1C-84   (hex)		STL Solution Co.,Ltd.
+001C84     (base 16)		STL Solution Co.,Ltd.
+				#710, World Meridian Venture Center I
+				Seoul    152781
+				KR
+
+00-1C-79   (hex)		Cohesive Financial Technologies LLC
+001C79     (base 16)		Cohesive Financial Technologies LLC
+				200 South Wacker Dr.
+				Chicago  IL  60606
+				US
+
+00-1C-64   (hex)		Landis+Gyr
+001C64     (base 16)		Landis+Gyr
+				30000 Mill Creek Ave. Suite 100
+				Alpharetta  GA  30022
+				US
+
+00-1C-31   (hex)		Mobile XP Technology Co., LTD
+001C31     (base 16)		Mobile XP Technology Co., LTD
+				Room No.2506,Tri-tower C building,No.66 Zhongguancun East Road,Haidian District
+				Beijing    100080
+				CN
+
+00-1C-8B   (hex)		MJ Innovations Ltd.
+001C8B     (base 16)		MJ Innovations Ltd.
+				333 Wyecroft Road
+				Oakville  Ontario  L6K 2H2
+				CA
+
+00-1C-6D   (hex)		KYOHRITSU ELECTRONIC INDUSTRY CO., LTD.
+001C6D     (base 16)		KYOHRITSU ELECTRONIC INDUSTRY CO., LTD.
+				2-5-1, NIPPONBASHI-NISHI,
+				OSAKA    556-0004
+				JP
+
+00-1C-96   (hex)		Linkwise Technology Pte Ltd
+001C96     (base 16)		Linkwise Technology Pte Ltd
+				Blk 3, Ang Mo Kio Industrial Park 2A
+				    568050
+				SG
+
+00-1C-29   (hex)		CORE DIGITAL ELECTRONICS CO., LTD
+001C29     (base 16)		CORE DIGITAL ELECTRONICS CO., LTD
+				1006# 102 CHUNUITECHNOPARK 200-1
+				BUCHEON-CITY  GYUNGGI-DO  420-857
+				KR
+
+00-1C-24   (hex)		Formosa Wireless Systems Corp.
+001C24     (base 16)		Formosa Wireless Systems Corp.
+				No. 408, Guandong Rd.,
+				HsinChu City    300
+				TW
+
+00-1C-20   (hex)		CLB Benelux
+001C20     (base 16)		CLB Benelux
+				Ramgatseweg 17
+				Raamsdonksveer  NBR  4941 VN
+				NL
+
+00-1C-1C   (hex)		Center Communication Systems GmbH
+001C1C     (base 16)		Center Communication Systems GmbH
+				Ignaz-Koeck-Strasse 19
+				Vienna    A-1210
+				AT
+
+00-1B-DA   (hex)		UTStarcom Inc
+001BDA     (base 16)		UTStarcom Inc
+				1275 Harbor Bay PKWY
+				Alameda  CA  94502
+				US
+
+00-1B-D1   (hex)		SOGESTMATIC
+001BD1     (base 16)		SOGESTMATIC
+				409 Route de la Gare
+				CHATEAUNEUF DE GADAGNE  PACA  84470
+				FR
+
+00-1C-00   (hex)		Entry Point, LLC
+001C00     (base 16)		Entry Point, LLC
+				735 Robins
+				Idaho Falls  Idaho  83401
+				US
+
+00-1B-FD   (hex)		Dignsys Inc.
+001BFD     (base 16)		Dignsys Inc.
+				14F, Digital Empire Bldg., B-1408
+				Suwon  Gyeonggi-do  443-813
+				KR
+
+00-1B-D6   (hex)		Kelvin Hughes Ltd
+001BD6     (base 16)		Kelvin Hughes Ltd
+				New North Road
+				Ilford  Essex  IG6 2UR
+				GB
+
+00-1B-CF   (hex)		Dataupia Corporation
+001BCF     (base 16)		Dataupia Corporation
+				One Alewife Center
+				Cambridge  MA  02140
+				US
+
+00-1B-CB   (hex)		PEMPEK SYSTEMS PTY LTD
+001BCB     (base 16)		PEMPEK SYSTEMS PTY LTD
+				UNIT 3 / 13 HOYLE AVENUE
+				CASTLE HILL  NSW  2154
+				AU
+
+00-1B-F5   (hex)		Tellink Sistemas de Telecomunicación S.L.
+001BF5     (base 16)		Tellink Sistemas de Telecomunicación S.L.
+				C/ María Tubau Nº 5 Bajo B
+				Madrid    28050
+				ES
+
+00-1B-E6   (hex)		VR AG
+001BE6     (base 16)		VR AG
+				Rütistrasse 18
+				Schlieren    CH-8952
+				CH
+
+00-1B-E2   (hex)		AhnLab,Inc.
+001BE2     (base 16)		AhnLab,Inc.
+				6th Fl, CCMM Bldg, 12 Yeouido-dong
+				Seoul    150869
+				KR
+
+00-1B-E0   (hex)		TELENOT ELECTRONIC GmbH
+001BE0     (base 16)		TELENOT ELECTRONIC GmbH
+				Wiesentalstraße 42
+				Aalen  Baden-Württemberg  73434
+				DE
+
+00-1C-34   (hex)		HUEY CHIAO INTERNATIONAL CO., LTD.
+001C34     (base 16)		HUEY CHIAO INTERNATIONAL CO., LTD.
+				5F, NO. 649-1,
+				HSIN CHUANG CITY  TAIPEI  242
+				TW
+
+00-1C-36   (hex)		iNEWiT NV
+001C36     (base 16)		iNEWiT NV
+				Schaliënhoevedreef 20D
+				Mechelen  Antwerp  2800
+				BE
+
+00-1C-15   (hex)		iPhotonix LLC
+001C15     (base 16)		iPhotonix LLC
+				2600 N Central Expressway
+				Richardson  Texas  75080
+				US
+
+00-1C-07   (hex)		Cwlinux Limited
+001C07     (base 16)		Cwlinux Limited
+				Unit 138, 13/F, Weswick Commercial Building,
+				Wan Chai    
+				HK
+
+00-1B-A3   (hex)		Flexit Group GmbH
+001BA3     (base 16)		Flexit Group GmbH
+				Bräuhausstraße 14
+				Salzburg  Salzburg  5020
+				AT
+
+00-1B-9F   (hex)		Calyptech Pty Ltd
+001B9F     (base 16)		Calyptech Pty Ltd
+				5/486 Lower Heidelberg Road
+				Heidelberg  Victoria  3084
+				AU
+
+00-1B-9A   (hex)		Apollo Fire Detectors Ltd
+001B9A     (base 16)		Apollo Fire Detectors Ltd
+				36 Brookside Road
+				Havant  Hampshire  P09 1JR
+				GB
+
+00-1B-BD   (hex)		FMC Kongsberg Subsea AS
+001BBD     (base 16)		FMC Kongsberg Subsea AS
+				Kirkegaardsveien 45
+				Kongsberg  Buskerud  3601
+				NO
+
+00-1B-BE   (hex)		ICOP Digital
+001BBE     (base 16)		ICOP Digital
+				16801 W. 116th St.
+				Lenexa  KS  66219
+				US
+
+00-1B-B3   (hex)		Condalo GmbH
+001BB3     (base 16)		Condalo GmbH
+				Kohlstatt 3
+				Lichtenau  Bavaria  86706
+				DE
+
+00-1B-B7   (hex)		Alta Heights Technology Corp.
+001BB7     (base 16)		Alta Heights Technology Corp.
+				108 Alta Heights Court
+				Los Gatos  California  95030
+				US
+
+00-1B-99   (hex)		KS System GmbH
+001B99     (base 16)		KS System GmbH
+				Alexanderstraße 37
+				Muelheim  NRW  45472
+				DE
+
+00-1B-8F   (hex)		Cisco Systems, Inc
+001B8F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-8C   (hex)		JMicron Technology Corp.
+001B8C     (base 16)		JMicron Technology Corp.
+				1F, No.13, Innovation Road 1
+				Hsinchu    300
+				TW
+
+00-1B-91   (hex)		EFKON AG
+001B91     (base 16)		EFKON AG
+				Dietrich-Keller-Strasse 20
+				8074 Raaba    
+				AT
+
+00-1B-82   (hex)		Taiwan Semiconductor Co., Ltd.
+001B82     (base 16)		Taiwan Semiconductor Co., Ltd.
+				11F, No. 205, Sec. 3, Beishin Rd,
+				Shindian  Taipei  231
+				TW
+
+00-1B-89   (hex)		EMZA Visual Sense Ltd.
+001B89     (base 16)		EMZA Visual Sense Ltd.
+				20 Ha'ta'as St., Beith Hapamon
+				Kfar Saba    44425
+				IL
+
+00-1B-8B   (hex)		NEC Platforms, Ltd.
+001B8B     (base 16)		NEC Platforms, Ltd.
+				800 Shimomata
+				Kakegawa  Shizuoka  436-8501
+				JP
+
+00-1B-AC   (hex)		Curtiss Wright Controls Embedded Computing
+001BAC     (base 16)		Curtiss Wright Controls Embedded Computing
+				10201 Wateridge Circle
+				San Diego  CA  92121
+				US
+
+00-1B-6A   (hex)		Powerwave Technologies Sweden AB
+001B6A     (base 16)		Powerwave Technologies Sweden AB
+				164 26
+				Knarrarnäsgatan 7, Kista    
+				SE
+
+00-1B-67   (hex)		Cisco Systems Inc
+001B67     (base 16)		Cisco Systems Inc
+				The Stella Building
+				Swindon  Wiltshire  SN5 6NX
+				GB
+
+00-1B-7B   (hex)		The Tintometer Ltd
+001B7B     (base 16)		The Tintometer Ltd
+				Solar Way
+				Amesbury  Wiltshire  SP4 7SZ
+				GB
+
+00-1B-75   (hex)		Hypermedia Systems
+001B75     (base 16)		Hypermedia Systems
+				2B Bergman St.
+				Rehovot    76705
+				IL
+
+00-1B-27   (hex)		Merlin CSI
+001B27     (base 16)		Merlin CSI
+				12625 Danielson Court
+				Poway  CA  92064
+				US
+
+00-1B-1B   (hex)		Siemens AG,
+001B1B     (base 16)		Siemens AG,
+				I IA SC MF-K PE 3
+				76187 Karlsruhe   Baden Wuerttemberg  
+				DE
+
+00-1B-1F   (hex)		DELTA - Danish Electronics, Light & Acoustics
+001B1F     (base 16)		DELTA - Danish Electronics, Light & Acoustics
+				Venlighedsvej 4
+				Hørsholm    DK-2970
+				DK
+
+00-1B-57   (hex)		SEMINDIA SYSTEMS PRIVATE LIMITED
+001B57     (base 16)		SEMINDIA SYSTEMS PRIVATE LIMITED
+				#1106/9,A.M.Industrial Estate,Garvebhai palya,
+				BANGALORE  KARNATAKA  560068
+				IN
+
+00-1B-55   (hex)		Hurco Automation Ltd.
+001B55     (base 16)		Hurco Automation Ltd.
+				6F, No. 31, Shintai Rd.
+				Jubei City,  Hsinchu Hsien  30244
+				TW
+
+00-1B-53   (hex)		Cisco Systems, Inc
+001B53     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-49   (hex)		Roberts Radio limited
+001B49     (base 16)		Roberts Radio limited
+				Swinton Works
+				Mexborough  South Yorkshire  S64 8AJ
+				GB
+
+00-1B-0E   (hex)		InoTec GmbH Organisationssysteme
+001B0E     (base 16)		InoTec GmbH Organisationssysteme
+				Biedrichstrasse 11
+				Woelfersheim  Hessen  D-61200
+				DE
+
+00-1B-04   (hex)		Affinity International S.p.a
+001B04     (base 16)		Affinity International S.p.a
+				C.so Savona 51
+				Villastellone    I10029
+				IT
+
+00-1B-06   (hex)		Ateliers R. LAUMONIER
+001B06     (base 16)		Ateliers R. LAUMONIER
+				Ateliers R. LAUMONIER
+				Nesles-la-Vallée  Val d'Oise  95690
+				FR
+
+00-1B-31   (hex)		Neural Image. Co. Ltd.
+001B31     (base 16)		Neural Image. Co. Ltd.
+				A307, CASI, Osaka Univ.
+				Suita city  Osaka  565-0871
+				JP
+
+00-1B-29   (hex)		Avantis.Co.,Ltd
+001B29     (base 16)		Avantis.Co.,Ltd
+				502 SEOIL BLDG.
+				SEOUL    132-872
+				KR
+
+00-1B-2B   (hex)		Cisco Systems, Inc
+001B2B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1B-28   (hex)		POLYGON, JSC
+001B28     (base 16)		POLYGON, JSC
+				37/1, Karl Marx str., floor 5
+				Ufa  Bashkortostan  450077
+				RU
+
+00-1B-43   (hex)		Beijing DG Telecommunications equipment Co.,Ltd
+001B43     (base 16)		Beijing DG Telecommunications equipment Co.,Ltd
+				No.5 Jiangtai Road, Chaoyang District
+				Beijing    100016
+				CN
+
+00-1B-3C   (hex)		Software Technologies Group,Inc.
+001B3C     (base 16)		Software Technologies Group,Inc.
+				10330 W. Roosevelt Road
+				Weschester  IL  60154
+				US
+
+00-1B-3D   (hex)		EuroTel Spa
+001B3D     (base 16)		EuroTel Spa
+				viale Martiri della Liberta,4
+				Lissone  Milan  20035
+				IT
+
+00-1B-66   (hex)		Sennheiser electronic GmbH & Co. KG
+001B66     (base 16)		Sennheiser electronic GmbH & Co. KG
+				Am Labor 1
+				Wedemark  Niedersachsen  30900
+				DE
+
+00-1B-60   (hex)		NAVIGON AG
+001B60     (base 16)		NAVIGON AG
+				Berliner Platz 11
+				Wuerzburg  Bavaria  97080
+				DE
+
+00-1B-05   (hex)		YMC AG
+001B05     (base 16)		YMC AG
+				Sonnenstrasse 4
+				Kreuzlingen  Thurgau  8280
+				CH
+
+00-1A-FF   (hex)		Wizyoung Tech.
+001AFF     (base 16)		Wizyoung Tech.
+				9F, No. 25, Sec. 1, Nanjing E. Rd.
+				Taipei    104
+				TW
+
+00-1B-00   (hex)		Neopost Technologies
+001B00     (base 16)		Neopost Technologies
+				113 rue Jean-Marin Naudin
+				Bagneux    92220
+				FR
+
+00-1B-4E   (hex)		Navman New Zealand
+001B4E     (base 16)		Navman New Zealand
+				7-21 Kawana Street
+				Auckland    0627
+				NZ
+
+00-1B-16   (hex)		Celtro Ltd.
+001B16     (base 16)		Celtro Ltd.
+				Azorim Business Park
+				Petach Tikva    49527
+				IL
+
+00-1A-E6   (hex)		Atlanta Advanced Communications Holdings Limited
+001AE6     (base 16)		Atlanta Advanced Communications Holdings Limited
+				1900 West Oak Circle, Marietta
+				Atlanta  Georgia  30062
+				US
+
+00-1A-D9   (hex)		International Broadband Electric Communications, Inc.
+001AD9     (base 16)		International Broadband Electric Communications, Inc.
+				285 Dunlop Blvd. SW
+				Huntsville  AL  35824
+				US
+
+00-1A-C8   (hex)		ISL (Instrumentation Scientifique de Laboratoire)
+001AC8     (base 16)		ISL (Instrumentation Scientifique de Laboratoire)
+				Impasse des 4 vents
+				VERSON  CALVADOS  14790
+				FR
+
+00-1A-AB   (hex)		eWings s.r.l.
+001AAB     (base 16)		eWings s.r.l.
+				via S. Quasimodo 46
+				Castel Maggiore  Bologna  40013
+				IT
+
+00-1A-AC   (hex)		Corelatus AB
+001AAC     (base 16)		Corelatus AB
+				Tegnergatan 37
+				Stockholm    11161
+				SE
+
+00-1A-AF   (hex)		BLUSENS TECHNOLOGY
+001AAF     (base 16)		BLUSENS TECHNOLOGY
+				EDIFICIO CNL,- AV.
+				15707 - SANTIAGO DE COMPOSTELA  A Coruña  
+				ES
+
+00-1A-B0   (hex)		Signal Networks Pvt. Ltd.,
+001AB0     (base 16)		Signal Networks Pvt. Ltd.,
+				No.12, Kalpataru Apartments,
+				Bangalore  Karnataka  560001
+				IN
+
+00-1A-A1   (hex)		Cisco Systems, Inc
+001AA1     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-1A-C6   (hex)		Micro Control Designs
+001AC6     (base 16)		Micro Control Designs
+				17490 Caribou Dr
+				Monument  Co.  80132
+				US
+
+00-1A-F2   (hex)		Dynavisions Schweiz AG
+001AF2     (base 16)		Dynavisions Schweiz AG
+				Freisinger Landstraße 21
+				D-80939  Muenchen  
+				DE
+
+00-1A-82   (hex)		PROBA Building Automation Co.,LTD
+001A82     (base 16)		PROBA Building Automation Co.,LTD
+				Penghuan Building 501, Shangdi East Road #1, Haidian District,
+				Beijing    100085
+				CN
+
+00-1A-7C   (hex)		Hirschmann Multimedia B.V.
+001A7C     (base 16)		Hirschmann Multimedia B.V.
+				Pampuslaan 170
+				Weesp  Noord-Holland  1382 JS
+				NL
+
+00-1A-7A   (hex)		Lismore Instruments Limited
+001A7A     (base 16)		Lismore Instruments Limited
+				Unit 2 Tristar Centre, Star Road
+				Horsham  West Sussex  RH13 8RA
+				GB
+
+00-1A-78   (hex)		ubtos
+001A78     (base 16)		ubtos
+				Rn.213, Woolim Lions Valley, #680
+				seoul  Gasan-dong  153-803
+				KR
+
+00-1A-76   (hex)		SDT information Technology Co.,LTD.
+001A76     (base 16)		SDT information Technology Co.,LTD.
+				Samil B/B 2F, 5-63 Hyochang-dong
+				Seoul    140-896
+				KR
+
+00-1A-70   (hex)		Cisco-Linksys, LLC
+001A70     (base 16)		Cisco-Linksys, LLC
+				121 Theory Drive
+				Irvine  California  92612
+				US
+
+00-1A-61   (hex)		PacStar Corp.
+001A61     (base 16)		PacStar Corp.
+				15055 SW Sequoia Pkwy, Suite 100
+				Portland  OR  97006
+				US
+
+00-1A-62   (hex)		Data Robotics, Incorporated
+001A62     (base 16)		Data Robotics, Incorporated
+				1881 Landings Dr
+				Mountain View  CA  94043
+				US
+
+00-1A-65   (hex)		Seluxit
+001A65     (base 16)		Seluxit
+				Nyhavnsgade 9, 2.sal
+				Aalborg  Nord Jylland  9000
+				DK
+
+00-1A-54   (hex)		Hip Shing Electronics Ltd.
+001A54     (base 16)		Hip Shing Electronics Ltd.
+				Unit 1/2/3, 20/F, New Treasure Center
+				    
+				HK
+
+00-1A-42   (hex)		Techcity Technology co., Ltd.
+001A42     (base 16)		Techcity Technology co., Ltd.
+				4F, No. 4, Alley 1, Szu Wei Lane, Chung Cheng Rd.,
+				Hsin Tein City  Taipei Hsien  231
+				TW
+
+00-1A-50   (hex)		PheeNet Technology Corp.
+001A50     (base 16)		PheeNet Technology Corp.
+				Rm. 3, 20F, No. 79, Sec. 1 Hsin Tai Wu Rd.
+				Hsi-Chih  New-Taipei City  221
+				TW
+
+00-1A-53   (hex)		Zylaya
+001A53     (base 16)		Zylaya
+				444 N. Frederick Ave.
+				Gaithersburg  MD  20877
+				US
+
+00-1A-4C   (hex)		Crossbow Technology, Inc
+001A4C     (base 16)		Crossbow Technology, Inc
+				4145 N. First Street
+				San Jose  CA  95134
+				US
+
+00-1A-1A   (hex)		Gentex Corporation/Electro-Acoustic Products
+001A1A     (base 16)		Gentex Corporation/Electro-Acoustic Products
+				2456 Brown Avenue
+				Manchester  NH  03103
+				US
+
+00-1A-12   (hex)		Essilor
+001A12     (base 16)		Essilor
+				64 Bis Avenue Aubert
+				94300  Vincennes  
+				FR
+
+00-1A-7D   (hex)		cyber-blue(HK)Ltd
+001A7D     (base 16)		cyber-blue(HK)Ltd
+				Room 1408 block C stars Plaza HongLiRoad,FuTian District
+				Shenzhen  GuangDong  518028
+				CN
+
+00-1A-60   (hex)		Wave Electronics Co.,Ltd.
+001A60     (base 16)		Wave Electronics Co.,Ltd.
+				3th Fl.,DaeSan Plaza B/D,Guun-Dong, 12-1,Gwonseon-Gu
+				Suwon-si  Kyeonggi-Do  441-814
+				KR
+
+00-1A-56   (hex)		ViewTel Co,. Ltd.
+001A56     (base 16)		ViewTel Co,. Ltd.
+				#B-502,Bundang Techno Park 148
+				BunDang-Ku, SeongNam-Si  GyeongGi-Do  463-760
+				KR
+
+00-19-F3   (hex)		Cetis, Inc
+0019F3     (base 16)		Cetis, Inc
+				5025 Galley Rd
+				Colorado Springs  CO  80915
+				US
+
+00-19-EF   (hex)		SHENZHEN LINNKING ELECTRONICS CO.,LTD
+0019EF     (base 16)		SHENZHEN LINNKING ELECTRONICS CO.,LTD
+				Room 901,B Block,Qinghua Information Center Hi-tec park North District,Nanshan District,Shenzhen
+				shenzhen  guangdong  518057
+				CN
+
+00-19-F7   (hex)		Onset Computer Corporation
+0019F7     (base 16)		Onset Computer Corporation
+				P.O. Box 3450
+				Pocasset  MA  02559
+				US
+
+00-19-EE   (hex)		CARLO GAVAZZI CONTROLS SPA-Controls Division
+0019EE     (base 16)		CARLO GAVAZZI CONTROLS SPA-Controls Division
+				Via Safforze 8
+				BELLUNO  BL  I-32100
+				IT
+
+00-19-BF   (hex)		Citiway technology Co.,ltd
+0019BF     (base 16)		Citiway technology Co.,ltd
+				No.2 Building,Jia 32,Beiheyan Avenue,East City
+				Peijing    100006
+				CN
+
+00-19-B6   (hex)		Euro Emme s.r.l.
+0019B6     (base 16)		Euro Emme s.r.l.
+				Via Belvedere, 24
+				Galliate Lombardo  Varese  21020
+				IT
+
+00-19-EB   (hex)		Pyronix Ltd
+0019EB     (base 16)		Pyronix Ltd
+				Braithwell Way
+				Rotherham  South Yorkshire  S66 8QY
+				GB
+
+00-19-E7   (hex)		Cisco Systems, Inc
+0019E7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-E9   (hex)		S-Information Technolgy, Co., Ltd.
+0019E9     (base 16)		S-Information Technolgy, Co., Ltd.
+				Sungwoo Bldg, 717-3 Suseo-dong,
+				Seoul    135-884
+				KR
+
+00-19-DA   (hex)		Welltrans O&E Technology Co. , Ltd.
+0019DA     (base 16)		Welltrans O&E Technology Co. , Ltd.
+				the 3rd Floor, building C-D, Hi-tech Digital Harbor, Guandong Industrial Park
+				Wuhan  Hubei  430074
+				CN
+
+00-1A-14   (hex)		Xin Hua Control Engineering Co.,Ltd.
+001A14     (base 16)		Xin Hua Control Engineering Co.,Ltd.
+				160 Wenjing Rd., Minhang
+				Shanghai    2000245
+				CN
+
+00-1A-10   (hex)		LUCENT TRANS ELECTRONICS CO.,LTD
+001A10     (base 16)		LUCENT TRANS ELECTRONICS CO.,LTD
+				9F-1,No.16,Chien Pah Rd.
+				Chung Ho  Taipei  235
+				TW
+
+00-1A-0C   (hex)		Swe-Dish Satellite Systems AB
+001A0C     (base 16)		Swe-Dish Satellite Systems AB
+				Torggatan 15
+				Solna  Stockholm  SE-171 06
+				SE
+
+00-19-DC   (hex)		ENENSYS Technologies
+0019DC     (base 16)		ENENSYS Technologies
+				Le Germanium
+				RENNES  Brittany  35700
+				FR
+
+00-19-D0   (hex)		Cathexis
+0019D0     (base 16)		Cathexis
+				PO Box 1091
+				Durban  KwaZulu Natal  4320
+				ZA
+
+00-19-D6   (hex)		LS Cable and System Ltd.
+0019D6     (base 16)		LS Cable and System Ltd.
+				12F LS Tower, 1026-6, Hogey-dong
+				Anyang-si  Gyeonggi-do  431-080
+				KR
+
+00-19-D7   (hex)		FORTUNETEK CO., LTD
+0019D7     (base 16)		FORTUNETEK CO., LTD
+				12F, No. 75, Sec 1, Chongqing S. Rd.,
+				Taipei    100
+				TW
+
+00-1A-02   (hex)		SECURE CARE PRODUCTS, INC
+001A02     (base 16)		SECURE CARE PRODUCTS, INC
+				39 CHENELL DRIVE
+				CONCORD  NH  03301
+				US
+
+00-19-F8   (hex)		Embedded Systems Design, Inc.
+0019F8     (base 16)		Embedded Systems Design, Inc.
+				6810 Deerpath Road
+				Elkridge  MD  21075
+				US
+
+00-1A-07   (hex)		Arecont Vision
+001A07     (base 16)		Arecont Vision
+				2400 N. Lincoln Ave
+				Altadena  CA  91001
+				US
+
+00-1A-08   (hex)		Simoco Ltd.
+001A08     (base 16)		Simoco Ltd.
+				Field House
+				Derby    DE1 1NH
+				GB
+
+00-1A-04   (hex)		Interay Solutions BV
+001A04     (base 16)		Interay Solutions BV
+				Mr. W.M. Oppedijk van Veenweg 8
+				BURGUM  Friesland  9251 GA
+				NL
+
+00-19-C9   (hex)		S&C ELECTRIC COMPANY
+0019C9     (base 16)		S&C ELECTRIC COMPANY
+				1135 ATLANTIC AVE
+				ALAMEDA  CA  94501
+				US
+
+00-19-B5   (hex)		Famar Fueguina S.A.
+0019B5     (base 16)		Famar Fueguina S.A.
+				Rodney 70
+				Buenos Aires    1427
+				AR
+
+00-19-B8   (hex)		Boundary Devices
+0019B8     (base 16)		Boundary Devices
+				7200 W. Oakland
+				Chandler  AZ  85226
+				US
+
+00-19-5D   (hex)		ShenZhen XinHuaTong Opto Electronics Co.,Ltd
+00195D     (base 16)		ShenZhen XinHuaTong Opto Electronics Co.,Ltd
+				5F,BaodaZhou,Shancheng Industrial Zone,BaoAn District
+				ShenZhen  GuangDong  518108
+				CN
+
+00-19-53   (hex)		Chainleader Communications Corp.
+001953     (base 16)		Chainleader Communications Corp.
+				5F, No. 400, Sec. 2 Bade Rd.,
+				Taipei    105
+				TW
+
+00-19-55   (hex)		Cisco Systems, Inc
+001955     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-19-59   (hex)		Staccato Communications Inc.
+001959     (base 16)		Staccato Communications Inc.
+				6195 Lusk Blvd.
+				San Diego  CA  92121
+				US
+
+00-19-4D   (hex)		Avago Technologies Sdn Bhd
+00194D     (base 16)		Avago Technologies Sdn Bhd
+				Bayan Lepas Free Industrial Zone
+				Bayan Lepas  Penang  11900
+				MY
+
+00-19-4E   (hex)		Ultra Electronics - TCS (Tactical Communication Systems)
+00194E     (base 16)		Ultra Electronics - TCS (Tactical Communication Systems)
+				5990 Cote De Liesse
+				TMR  Quebec  H4T 1V7
+				CA
+
+00-19-AC   (hex)		GSP SYSTEMS Inc.
+0019AC     (base 16)		GSP SYSTEMS Inc.
+				13FL, 101 Dong, Chunui Techno Park 1,
+				Bucheon-City  Gyeonggi-Do  420-857
+				KR
+
+00-19-B0   (hex)		HanYang System
+0019B0     (base 16)		HanYang System
+				701Ho, Kofomo Techno Center II, 1289-5
+				Shihung-Shi  Kyunggi-Do  429-850
+				KR
+
+00-19-95   (hex)		Jurong Hi-Tech (Suzhou)Co.ltd
+001995     (base 16)		Jurong Hi-Tech (Suzhou)Co.ltd
+				275,Xing Long Street, Suzhou Indudtrial Park
+				Suzhou  Jiang Su  215021
+				CN
+
+00-19-9A   (hex)		EDO-EVI
+00199A     (base 16)		EDO-EVI
+				7065 Columbia Gateway Dr.
+				Columbia  MD  21046
+				US
+
+00-19-94   (hex)		Jorjin Technologies Inc.
+001994     (base 16)		Jorjin Technologies Inc.
+				5F, No.28, Lane141, Sing-ai Rd.
+				Taipei    114
+				TW
+
+00-19-7C   (hex)		Riedel Communications GmbH
+00197C     (base 16)		Riedel Communications GmbH
+				Uellendahler Str. 353
+				Wuppertal  NRW  42109
+				DE
+
+00-19-A0   (hex)		NIHON DATA SYSTENS, INC.
+0019A0     (base 16)		NIHON DATA SYSTENS, INC.
+				6-9, Koyo-cho naka
+				Kobe-shi  Hyogo  658-0032
+				JP
+
+00-19-91   (hex)		avinfo
+001991     (base 16)		avinfo
+				Jiahuiyuan 703,Huaao Center,31# Zizhuyuan Road,
+				Beijing    100089
+				CN
+
+00-19-8C   (hex)		iXSea
+00198C     (base 16)		iXSea
+				55 av auguste Renoir
+				Marly le Roi    78160
+				FR
+
+00-19-62   (hex)		Commerciant, LP
+001962     (base 16)		Commerciant, LP
+				2901 Wilcrest
+				Houston  Texas  77042
+				US
+
+00-19-6F   (hex)		SensoPart GmbH
+00196F     (base 16)		SensoPart GmbH
+				Am Wiedenbach 1
+				Wieden  Baden-Württemberg  D-79695
+				DE
+
+00-18-DD   (hex)		Silicondust Engineering Ltd
+0018DD     (base 16)		Silicondust Engineering Ltd
+				38 Lillington Road
+				Auckland    
+				NZ
+
+00-18-DF   (hex)		The Morey Corporation
+0018DF     (base 16)		The Morey Corporation
+				100 Morey Drive
+				Woodridge  IL  60517
+				US
+
+00-18-E1   (hex)		Verkerk Service Systemen
+0018E1     (base 16)		Verkerk Service Systemen
+				Molenvliet 1
+				Zwijndrecht  Zuid-Holland  NL-3335LH
+				NL
+
+00-18-DA   (hex)		Würth Elektronik eiSos GmbH & Co. KG
+0018DA     (base 16)		Würth Elektronik eiSos GmbH & Co. KG
+				Max-Eyth-Straße 1
+				Waldenburg    74638
+				DE
+
+00-18-D5   (hex)		REIGNCOM
+0018D5     (base 16)		REIGNCOM
+				14F Kamco Yanjae Tower, 949-3
+				Seoul    135-739
+				KR
+
+00-18-E7   (hex)		Cameo Communications, INC.
+0018E7     (base 16)		Cameo Communications, INC.
+				NO.42, Sec. 6, Mincyuan E. Rd.
+				Taipei    114
+				TW
+
+00-18-E4   (hex)		YIGUANG
+0018E4     (base 16)		YIGUANG
+				3/FL.Industry zone,Fuxinlin,Hangcheng,Xixiang,Baoan
+				Shenzhen  Guangdong  518126
+				CN
+
+00-18-E5   (hex)		Adhoco AG
+0018E5     (base 16)		Adhoco AG
+				Technopark
+				Winterthur  ZH  CH-8406 
+				CH
+
+00-19-0A   (hex)		HASWARE INC.
+00190A     (base 16)		HASWARE INC.
+				4-12-3 HIGASHI
+				KUNITACHI  TOKYO  186-0002
+				JP
+
+00-19-23   (hex)		Phonex Korea Co., LTD.
+001923     (base 16)		Phonex Korea Co., LTD.
+				33-3, Geoyeo-Dong
+				Seoul  Songpa-Gu  138-814
+				KR
+
+00-19-1C   (hex)		Sensicast Systems
+00191C     (base 16)		Sensicast Systems
+				200 Reservoir St
+				Needham  MA  02494
+				US
+
+00-19-28   (hex)		Siemens AG, Transportation Systems
+001928     (base 16)		Siemens AG, Transportation Systems
+				Ackerstraße 22
+				Braunschweig    38126
+				DE
+
+00-19-15   (hex)		TECOM Co., Ltd.
+001915     (base 16)		TECOM Co., Ltd.
+				23 R&D Road 2 Science Based Industrial Park
+				Hsin-Chu    300
+				TW
+
+00-19-1B   (hex)		Sputnik Engineering AG
+00191B     (base 16)		Sputnik Engineering AG
+				Höheweg 85
+				Biel-Bienne BE    2502
+				CH
+
+00-19-09   (hex)		DEVI - Danfoss A/S
+001909     (base 16)		DEVI - Danfoss A/S
+				Ulvehavevej 61
+				Vejle    7100
+				DK
+
+00-19-33   (hex)		Strix Systems, Inc.
+001933     (base 16)		Strix Systems, Inc.
+				26610 Agoura Road
+				Calabasas  CA  91302
+				US
+
+00-19-04   (hex)		WB Electronics Sp. z o.o.
+001904     (base 16)		WB Electronics Sp. z o.o.
+				ul. Poznanska 129/133
+				Ozarow Mazowiecki  Mazowieckie  05-850
+				PL
+
+00-19-34   (hex)		TRENDON TOUCH TECHNOLOGY CORP.
+001934     (base 16)		TRENDON TOUCH TECHNOLOGY CORP.
+				2F No.5, Alley 22, Lane 513, Rueiguang Rd., Neihu
+				Taipei City    114
+				TW
+
+00-19-0D   (hex)		IEEE 1394c
+00190D     (base 16)		IEEE 1394c
+				c/o 1394 Trade Association
+				Southlake  TX  76092
+				US
+
+00-18-81   (hex)		Buyang Electronics Industrial Co., Ltd
+001881     (base 16)		Buyang Electronics Industrial Co., Ltd
+				434-140, Oryu-Dong
+				Incheon    404-300
+				KR
+
+00-18-76   (hex)		WowWee Ltd.
+001876     (base 16)		WowWee Ltd.
+				92 Granville Rd. Suite 301A-C
+				T.S.T. East  Kowloon  
+				HK
+
+00-18-7A   (hex)		Wiremold
+00187A     (base 16)		Wiremold
+				60 Woodlawn St.
+				West Hartford  CT  06110
+				US
+
+00-18-6C   (hex)		Neonode AB
+00186C     (base 16)		Neonode AB
+				Biblioteksgatan 11, 1st floor
+				Stockholm    S-111 46
+				SE
+
+00-18-73   (hex)		Cisco Systems, Inc
+001873     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-5F   (hex)		TAC Inc.
+00185F     (base 16)		TAC Inc.
+				66 Nishiishigatsubocho Nishinanajyo Shimogyoku
+				Kyoto    600-8896
+				JP
+
+00-18-D4   (hex)		Unified Display Interface SIG
+0018D4     (base 16)		Unified Display Interface SIG
+				15201 SW Greenbrier Road
+				Beaverton  Oregon  97006
+				US
+
+00-18-A7   (hex)		Yoggie Security Systems LTD.
+0018A7     (base 16)		Yoggie Security Systems LTD.
+				P.P.Box 156
+				Beth Halevy    42870
+				IL
+
+00-18-A2   (hex)		XIP Technology AB
+0018A2     (base 16)		XIP Technology AB
+				PO Box 437
+				Jönköping  Sweden  SE- 551 16
+				SE
+
+00-18-9C   (hex)		Weldex Corporation
+00189C     (base 16)		Weldex Corporation
+				6751 Katella Avenue
+				Cypress  CA  90630
+				US
+
+00-18-9A   (hex)		HANA Micron Inc.
+00189A     (base 16)		HANA Micron Inc.
+				#95-1 Wonnam-Li, Umbong-Myeon
+				Asan-City  Chung-Nam  336-864
+				KR
+
+00-18-64   (hex)		Eaton Corporation
+001864     (base 16)		Eaton Corporation
+				730, rue Commerciale
+				St-Jean-Chrysostome  QC  G6Z 2C5
+				CA
+
+00-18-66   (hex)		Leutron Vision
+001866     (base 16)		Leutron Vision
+				Industriestrasse 57
+				Glattbrugg  ZH  8152
+				CH
+
+00-18-60   (hex)		SIM Technology Group Shanghai Simcom Ltd.,
+001860     (base 16)		SIM Technology Group Shanghai Simcom Ltd.,
+				SIM Technology building,
+				Shanghai    200233
+				CN
+
+00-18-97   (hex)		JESS-LINK PRODUCTS Co., LTD
+001897     (base 16)		JESS-LINK PRODUCTS Co., LTD
+				9F, No. 176, Jian-Yi Rd., Chung Ho City
+				Taipei County    235
+				TW
+
+00-18-9E   (hex)		OMNIKEY GmbH.
+00189E     (base 16)		OMNIKEY GmbH.
+				Ferihumerstrasse 13
+				Linz  Upperaustria  4040
+				AT
+
+00-18-A9   (hex)		Ethernet Direct Corporation
+0018A9     (base 16)		Ethernet Direct Corporation
+				19F,No.345 Chung Ho Road, Yung Ho City
+				Taipei    234
+				TW
+
+00-18-A8   (hex)		AnNeal Technology Inc.
+0018A8     (base 16)		AnNeal Technology Inc.
+				Room 106, No. 47, Science Park Rd. II
+				Hsinchu    300
+				TW
+
+00-18-C2   (hex)		Firetide, Inc
+0018C2     (base 16)		Firetide, Inc
+				16795 Lark Av, Suite 200
+				Los Gatos  CA  95032
+				US
+
+00-18-3E   (hex)		Digilent, Inc
+00183E     (base 16)		Digilent, Inc
+				215 E. Main St.
+				Pullman  WA  99163
+				US
+
+00-18-42   (hex)		Nokia Danmark A/S
+001842     (base 16)		Nokia Danmark A/S
+				Frederikskaj
+				Copenhagen V    DK-1790
+				DK
+
+00-18-40   (hex)		3 Phoenix, Inc.
+001840     (base 16)		3 Phoenix, Inc.
+				14585 Avion Pkway
+				Chantilly  Virginia  20151
+				US
+
+00-18-44   (hex)		Heads Up Technologies, Inc.
+001844     (base 16)		Heads Up Technologies, Inc.
+				2033 Chennault Drive, Suite 100
+				Carrollton  Texas  75006-5119
+				US
+
+00-18-21   (hex)		SINDORICOH
+001821     (base 16)		SINDORICOH
+				277-22, 2ga, Sungsu-dong, Sungdong-gu,
+				Seoul    133-120
+				KR
+
+00-18-23   (hex)		Delta Electronics, Inc.
+001823     (base 16)		Delta Electronics, Inc.
+				186 Ruey Kuang Road, Neihu,
+				Taipei    114
+				TW
+
+00-18-15   (hex)		GZ Technologies, Inc.
+001815     (base 16)		GZ Technologies, Inc.
+				Room 1, 5F., No.94, Baojhong Rd.
+				Taipei    231
+				TW
+
+00-18-57   (hex)		Unilever R&D
+001857     (base 16)		Unilever R&D
+				Bldg. 50
+				Bedford  Bedfordshire  MK44 1LQ
+				GB
+
+00-18-53   (hex)		Atera Networks LTD.
+001853     (base 16)		Atera Networks LTD.
+				31, Habarzel St.
+				Tel-Aviv    69710
+				IL
+
+00-18-59   (hex)		Strawberry Linux Co.,Ltd.
+001859     (base 16)		Strawberry Linux Co.,Ltd.
+				1-28-8-204 Higashiayase
+				Adachiku  Tokyo  120-0004
+				JP
+
+00-18-4F   (hex)		8 Ways Technology Corp.
+00184F     (base 16)		8 Ways Technology Corp.
+				2F-1, No. 216, Sec. 3, Roosevelt Rd.
+				  Taipei  231
+				TW
+
+00-18-06   (hex)		Hokkei Industries Co., Ltd.
+001806     (base 16)		Hokkei Industries Co., Ltd.
+				Imahira 432
+				Hakusan  Ishikawa  924-0827
+				JP
+
+00-18-18   (hex)		Cisco Systems, Inc
+001818     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-18-1A   (hex)		AVerMedia Information Inc.
+00181A     (base 16)		AVerMedia Information Inc.
+				5F., No. 135, Jian 1st Rd.,
+				  New Taipei City  235
+				TW
+
+00-18-16   (hex)		Ubixon Co., Ltd.
+001816     (base 16)		Ubixon Co., Ltd.
+				Cheongdong Building 2F
+				Seoul    137-070
+				KR
+
+00-18-2B   (hex)		Softier
+00182B     (base 16)		Softier
+				Tidhar 3
+				Ra'anana  none  43665
+				IL
+
+00-18-29   (hex)		Gatsometer
+001829     (base 16)		Gatsometer
+				Claes Tillyweg 2
+				Haarlem  Noord-Holland  2031 CW
+				NL
+
+00-18-38   (hex)		PanAccess Communications,Inc.
+001838     (base 16)		PanAccess Communications,Inc.
+				Floor 8,Tower B,Global Trade Center,36 Beisanhuandonglu,Dongcheng District
+				  Beijing  100013
+				CN
+
+00-17-F0   (hex)		SZCOM Broadband Network Technology Co.,Ltd
+0017F0     (base 16)		SZCOM Broadband Network Technology Co.,Ltd
+				Room 602 No.8 Building ,Shenzhen Software Park,
+				Shenzhen  Guangdong  518057
+				CN
+
+00-17-F1   (hex)		Renu Electronics Pvt Ltd
+0017F1     (base 16)		Renu Electronics Pvt Ltd
+				Sr No 2/6, Baner Road,
+				Pune  Maharashtra  411045
+				IN
+
+00-17-FF   (hex)		PLAYLINE Co.,Ltd.
+0017FF     (base 16)		PLAYLINE Co.,Ltd.
+				1-4-21 MOTOAKASAKA
+				TOKYO    107-0051
+				JP
+
+00-17-F6   (hex)		Pyramid Meriden Inc.
+0017F6     (base 16)		Pyramid Meriden Inc.
+				45 Gracey Ave.
+				Meriden  CT  06451
+				US
+
+00-17-C5   (hex)		SonicWALL
+0017C5     (base 16)		SonicWALL
+				1143 Borregas Ave
+				Sunnyvale  CA  95126
+				US
+
+00-17-BE   (hex)		Tratec Telecom B.V.
+0017BE     (base 16)		Tratec Telecom B.V.
+				De Smalle Zijde 12
+				Veenendaal    NL0-3903 LP
+				NL
+
+00-17-C0   (hex)		PureTech Systems, Inc.
+0017C0     (base 16)		PureTech Systems, Inc.
+				1950 W Rose Garden Lane
+				Phoenix  AZ  85027
+				US
+
+00-17-BA   (hex)		SEDO CO., LTD.
+0017BA     (base 16)		SEDO CO., LTD.
+				302, KT Bldg, 1ANNEX, 35-1
+				Seoul    150-038
+				KR
+
+00-17-D4   (hex)		Monsoon Multimedia, Inc
+0017D4     (base 16)		Monsoon Multimedia, Inc
+				1730 South Amphlett blvd. Suite 101
+				San Mateo  CA  94402
+				US
+
+00-17-80   (hex)		Applied Biosystems B.V.
+001780     (base 16)		Applied Biosystems B.V.
+				Blk 33, Marsiling Industrial Estate Road 3,
+				    739256
+				SG
+
+00-17-A5   (hex)		Ralink Technology Corp
+0017A5     (base 16)		Ralink Technology Corp
+				Suite 215, Bldg 53. 195-61 Sec.4, Chung Hsing Rd,
+				Chutung  Hsinchu  310
+				TW
+
+00-17-A8   (hex)		EDM Corporation
+0017A8     (base 16)		EDM Corporation
+				3-5-2 Itabashi
+				Itabashi-ku  Tokyo  173-0004
+				JP
+
+00-17-A9   (hex)		Sentivision
+0017A9     (base 16)		Sentivision
+				Marynarska 19a
+				Warsaw  Mazowieckie  02-674
+				PL
+
+00-17-AF   (hex)		Enermet
+0017AF     (base 16)		Enermet
+				Salvesenintie
+				Jyskä    FIN-40420
+				FI
+
+00-17-AA   (hex)		elab-experience inc.
+0017AA     (base 16)		elab-experience inc.
+				104 Anotsupia
+				Tsu-shi  mie prefecture  514-0131
+				JP
+
+00-17-AE   (hex)		GAI-Tronics
+0017AE     (base 16)		GAI-Tronics
+				Brunel Drive
+				Burton Upon Trent  Staffordshire  DE13 0BZ
+				GB
+
+00-17-B5   (hex)		Peerless Systems Corporation
+0017B5     (base 16)		Peerless Systems Corporation
+				2381 Rosecrans Avenue, Suite 400
+				El Segundo  CA  90245
+				US
+
+00-17-6C   (hex)		Pivot3, Inc.
+00176C     (base 16)		Pivot3, Inc.
+				6605 Cypresswood Drive, Ste 350
+				Spring  TX  77379-7741
+				US
+
+00-17-70   (hex)		Arti Industrial Electronics Ltd.
+001770     (base 16)		Arti Industrial Electronics Ltd.
+				Ger-San Sitesi, 657. Sokak
+				Ankara    06370
+				TR
+
+00-17-8B   (hex)		Teledyne Technologies Incorporated
+00178B     (base 16)		Teledyne Technologies Incorporated
+				12333 West Olympic Blvd
+				Los Angeles  CA  90064
+				US
+
+00-17-DF   (hex)		Cisco Systems, Inc
+0017DF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-17-46   (hex)		Freedom9 Inc.
+001746     (base 16)		Freedom9 Inc.
+				4140B SLADEVIEW CRE.,
+				MISSISSAUGA,  Ontario  L5L6A1
+				CA
+
+00-17-4D   (hex)		DYNAMIC NETWORK FACTORY, INC.
+00174D     (base 16)		DYNAMIC NETWORK FACTORY, INC.
+				26250 EDEN LANDING RD.
+				HAYWARD  CA  94545
+				US
+
+00-17-44   (hex)		Araneo Ltd.
+001744     (base 16)		Araneo Ltd.
+				103 Medinat Hayehudim
+				Herzliya    46733
+				IL
+
+00-17-49   (hex)		HYUNDAE YONG-O-SA CO.,LTD
+001749     (base 16)		HYUNDAE YONG-O-SA CO.,LTD
+				448-10, Hyuckjae B/D Seongnae, Kangdong-gu
+				Seoul    134-847
+				KR
+
+00-17-43   (hex)		Deck Srl
+001743     (base 16)		Deck Srl
+				Via Fabio Filzi 2
+				Milan    20124
+				IT
+
+00-17-28   (hex)		Selex Communications
+001728     (base 16)		Selex Communications
+				Via Pieragostini 80
+				Genova    16151
+				IT
+
+00-17-22   (hex)		Hanazeder Electronic GmbH
+001722     (base 16)		Hanazeder Electronic GmbH
+				J.M. Dimmelstr 10
+				Ried i. I.  Oberösterreich  4910
+				AT
+
+00-17-3D   (hex)		Neology
+00173D     (base 16)		Neology
+				13000 Gregg Street Suite A
+				Poway  CA  92064
+				US
+
+00-17-40   (hex)		Bluberi Gaming Technologies Inc
+001740     (base 16)		Bluberi Gaming Technologies Inc
+				2125, rue Letendre Suite 420
+				Drummondville  Quebec  J2C 7G1
+				CA
+
+00-17-32   (hex)		Science-Technical Center RISSA
+001732     (base 16)		Science-Technical Center RISSA
+				st. Abramtsevskaja, h.9
+				Moscow    128572
+				RU
+
+00-17-6D   (hex)		CORE CORPORATION
+00176D     (base 16)		CORE CORPORATION
+				1-22-3, Sangenjaya,
+				Setagaya-ku  Tokyo-to  154-8552
+				JP
+
+00-17-73   (hex)		Laketune Technologies Co. Ltd
+001773     (base 16)		Laketune Technologies Co. Ltd
+				No. 38 Zijinghua Rd. Westlake District
+				Hangzhou  Zhejiang  310013
+				CN
+
+00-17-3A   (hex)		Cloudastructure Inc
+00173A     (base 16)		Cloudastructure Inc
+				585 Broadway
+				Redwood City  CA  94063
+				US
+
+00-17-2F   (hex)		NeuLion Incorporated
+00172F     (base 16)		NeuLion Incorporated
+				1600 Old Country Road
+				Plainview  NY  11803
+				US
+
+00-17-23   (hex)		Summit Data Communications
+001723     (base 16)		Summit Data Communications
+				526 South Main Street
+				Akron  Ohio  44311
+				US
+
+00-17-1F   (hex)		IMV Corporation
+00171F     (base 16)		IMV Corporation
+				2-6-10 Takejima
+				Osaka    555-0011
+				JP
+
+00-17-53   (hex)		nFore Technology Inc.
+001753     (base 16)		nFore Technology Inc.
+				5F, NO 31, Ln 258, Rulguang Rd
+				Taipei  Neihu District  11491
+				TW
+
+00-17-57   (hex)		RIX TECHNOLOGY LIMITED
+001757     (base 16)		RIX TECHNOLOGY LIMITED
+				17 DAI WANG STREET
+				TAI PO  NEW TERRITORIES  
+				HK
+
+00-16-BB   (hex)		Law-Chain Computer Technology Co Ltd
+0016BB     (base 16)		Law-Chain Computer Technology Co Ltd
+				7F-2, 286-4, hsin ya road, chien chen district
+				Kaohsiung    80673
+				TW
+
+00-16-B4   (hex)		Private
+0016B4     (base 16)		Private
+
+00-16-A7   (hex)		AWETA G&P
+0016A7     (base 16)		AWETA G&P
+				Burg. Winkellaan 3
+				Nootdorp    2631 HG
+				NL
+
+00-17-10   (hex)		Casa Systems Inc.
+001710     (base 16)		Casa Systems Inc.
+				10, New England Business Center Dr.
+				Andover  MA  01810
+				US
+
+00-16-BF   (hex)		PaloDEx Group Oy
+0016BF     (base 16)		PaloDEx Group Oy
+				P.O. Box 64
+				Tuusula    04301
+				FI
+
+00-16-B7   (hex)		Seoul Commtech
+0016B7     (base 16)		Seoul Commtech
+				448-11, Seongnae 3dong. Gangdong gu,
+				Seoul    134033
+				KR
+
+00-16-E1   (hex)		SiliconStor, Inc.
+0016E1     (base 16)		SiliconStor, Inc.
+				48430 Lakeview Blvd.
+				Fremont  CA  94538
+				US
+
+00-16-E2   (hex)		American Fibertek, Inc.
+0016E2     (base 16)		American Fibertek, Inc.
+				120 Belmont Drive
+				Somerset  New Jersey  08873-1204
+				US
+
+00-17-13   (hex)		Tiger NetCom
+001713     (base 16)		Tiger NetCom
+				J-15 Mudan Cun, Yijing Huayuan,
+				Shenzhen  Guangdong  518003
+				CN
+
+00-16-CD   (hex)		HIJI HIGH-TECH CO., LTD.
+0016CD     (base 16)		HIJI HIGH-TECH CO., LTD.
+				Ohga 8133
+				Hayami  Oita  879-1504
+				JP
+
+00-16-EF   (hex)		Koko Fitness, Inc.
+0016EF     (base 16)		Koko Fitness, Inc.
+				136 Longwater Drive
+				Norwell  MA  02061
+				US
+
+00-16-FD   (hex)		Jaty Electronics
+0016FD     (base 16)		Jaty Electronics
+				Jaty Bldg 10F, 1659-5 Bongchun11-Dong
+				Seoul    151-832
+				KR
+
+00-16-78   (hex)		SHENZHEN BAOAN GAOKE ELECTRONICS CO., LTD
+001678     (base 16)		SHENZHEN BAOAN GAOKE ELECTRONICS CO., LTD
+				GAOKE INDUSTRIAL PARK, NO.8 TANGKENG ROAD, SHIYAN TOWN
+				SHENZHEN  GUANGDONG  518108
+				CN
+
+00-16-74   (hex)		EuroCB (Phils.), Inc.
+001674     (base 16)		EuroCB (Phils.), Inc.
+				SFB No.2
+				Lapulapu City  Cebu  6015
+				PH
+
+00-16-70   (hex)		SKNET Corporation
+001670     (base 16)		SKNET Corporation
+				Fontana Shinyokohama
+				Yokohama  Kanagawa  222-0033
+				JP
+
+00-16-89   (hex)		Pilkor Electronics Co., Ltd
+001689     (base 16)		Pilkor Electronics Co., Ltd
+				381,Wonchun-Dong,Yeoungtong-Gu
+				Suwon  Kyung Ki-Do  442-380
+				KR
+
+00-16-8A   (hex)		id-Confirm Inc
+00168A     (base 16)		id-Confirm Inc
+				1800 Boulder St
+				Denver  CO  80211
+				US
+
+00-16-86   (hex)		Karl Storz Imaging
+001686     (base 16)		Karl Storz Imaging
+				175 Cremona Dr.
+				Goleta  CA  93117
+				US
+
+00-16-8D   (hex)		KORWIN CO., Ltd.
+00168D     (base 16)		KORWIN CO., Ltd.
+				3rd Floor, Hana Bldg, 123-7 Nonhyun-dong
+				Seoul    135-010
+				KR
+
+00-16-8E   (hex)		Vimicro corporation
+00168E     (base 16)		Vimicro corporation
+				15/F,Shining Tower,No.35,xueyuan
+				Beijing    100083
+				CN
+
+00-16-4F   (hex)		World Ethnic Broadcastin Inc.
+00164F     (base 16)		World Ethnic Broadcastin Inc.
+				50 California Street, Suite 1500
+				San Francisco  California  94111
+				US
+
+00-16-7E   (hex)		DIBOSS.CO.,LTD
+00167E     (base 16)		DIBOSS.CO.,LTD
+				126-1, Gongdan-dong
+				Gumi  Gyeongbuk  730-902
+				KR
+
+00-16-7B   (hex)		Haver&Boecker
+00167B     (base 16)		Haver&Boecker
+				Carl-Haver-Platz 3
+				Oelde  NRW  59302
+				DE
+
+00-16-79   (hex)		eOn Communications
+001679     (base 16)		eOn Communications
+				4105 Royal Drive, Suite 100
+				Kennesaw  Georgia  30144
+				US
+
+00-16-A3   (hex)		Ingeteam Transmission&Distribution, S.A.
+0016A3     (base 16)		Ingeteam Transmission&Distribution, S.A.
+				C/ Usausuaga, 7
+				Basauri  Bizkaia  48970
+				ES
+
+00-16-A0   (hex)		Auto-Maskin
+0016A0     (base 16)		Auto-Maskin
+				Sophie Radichs Vei 7
+				LILLESTROM  Akershus  2003
+				NO
+
+00-16-5D   (hex)		AirDefense, Inc.
+00165D     (base 16)		AirDefense, Inc.
+				4800 North Point Pkwy
+				Alpharetta  GA  30022
+				US
+
+00-16-5B   (hex)		Grip Audio
+00165B     (base 16)		Grip Audio
+				6345 W. Louise Drive
+				Glendale  Arizona  85310-4243
+				US
+
+00-16-67   (hex)		A-TEC Subsystem INC.
+001667     (base 16)		A-TEC Subsystem INC.
+				4F, No. 86, Chung-Hsing Road, Shijr City,
+				    221
+				TW
+
+00-16-4A   (hex)		Vibration Technology Limited
+00164A     (base 16)		Vibration Technology Limited
+				Vibtech House, Central Boulevard
+				Larbert  Scotland  FK5 4RU
+				GB
+
+00-16-45   (hex)		Power Distribution, Inc.
+001645     (base 16)		Power Distribution, Inc.
+				4200 Oakleys Ct.
+				Richmond  VA  23223
+				US
+
+00-16-3F   (hex)		CReTE SYSTEMS Inc.
+00163F     (base 16)		CReTE SYSTEMS Inc.
+				7F,No.250,Sec.3,Pei Shen Rd.,Shen Keng Hsiang
+				Taipei County    22204
+				TW
+
+00-16-3D   (hex)		Tsinghua Tongfang Legend Silicon Tech. Co., Ltd.
+00163D     (base 16)		Tsinghua Tongfang Legend Silicon Tech. Co., Ltd.
+				26F TSINGHUA TONGFANG HI-TECH PLAZA
+				BEIJING    100083
+				CN
+
+00-16-2D   (hex)		STNet Co., Ltd.
+00162D     (base 16)		STNet Co., Ltd.
+				Shin-wha Building 4F, 954-25
+				Anyang-si  Kyungki-do   431-060
+				KR
+
+00-16-27   (hex)		embedded-logic DESIGN AND MORE GmbH
+001627     (base 16)		embedded-logic DESIGN AND MORE GmbH
+				Hansestrasse 24
+				Muenster  NRW  48153
+				DE
+
+00-16-3A   (hex)		YVES TECHNOLOGY CO., LTD.
+00163A     (base 16)		YVES TECHNOLOGY CO., LTD.
+				No.74, Fusing 2nd Rd.
+				Gueishan  Taoyuan  33377
+				TW
+
+00-16-38   (hex)		TECOM Co., Ltd.
+001638     (base 16)		TECOM Co., Ltd.
+				23 R&D Road 2 Science Based Industrial Park
+				Hsin-Chu    300
+				TW
+
+00-16-33   (hex)		Oxford Diagnostics Ltd.
+001633     (base 16)		Oxford Diagnostics Ltd.
+				Sandybrae
+				Oxford  Oxon.  OX1 5HJ
+				GB
+
+00-15-EC   (hex)		Boca Devices LLC
+0015EC     (base 16)		Boca Devices LLC
+				7647 Sierra Ter
+				Boca Raton  Florida  33433
+				US
+
+00-15-EF   (hex)		NEC TOKIN Corporation
+0015EF     (base 16)		NEC TOKIN Corporation
+				 1-1,Asahi-Cho 7-chome,Shiroishi,
+				Miyagi    989-0223
+				JP
+
+00-15-E4   (hex)		Zimmer Elektromedizin
+0015E4     (base 16)		Zimmer Elektromedizin
+				Junkersstrasse 9
+				Neu-Ulm  Bayern  89231
+				DE
+
+00-16-22   (hex)		BBH SYSTEMS GMBH
+001622     (base 16)		BBH SYSTEMS GMBH
+				Böttgerstraße 40
+				Weiden i.d.OPf.  Bayern  92637
+				DE
+
+00-16-13   (hex)		LibreStream Technologies Inc.
+001613     (base 16)		LibreStream Technologies Inc.
+				895 Waverley Street
+				Winnipeg  Manitoba  R3T 5P4
+				CA
+
+00-16-0F   (hex)		BADGER METER INC
+00160F     (base 16)		BADGER METER INC
+				4545 W BROWN DEER RD
+				MILWAUKEE  WI  53223
+				US
+
+00-16-04   (hex)		Sigpro
+001604     (base 16)		Sigpro
+				655 W Evelyn ST
+				Mountain View  CA  94041
+				US
+
+00-15-FB   (hex)		setex schermuly textile computer gmbh
+0015FB     (base 16)		setex schermuly textile computer gmbh
+				Hauptstraße 25
+				Mengerskirchen  Hessen  35794
+				DE
+
+00-15-FE   (hex)		SCHILLING ROBOTICS LLC
+0015FE     (base 16)		SCHILLING ROBOTICS LLC
+				260 COUSTEAU PL
+				DAVIS  CA  95618
+				US
+
+00-16-0D   (hex)		Be Here Corporation
+00160D     (base 16)		Be Here Corporation
+				39300 Civic Center Dr., Suite 180
+				Fremont  CA  94538
+				US
+
+00-15-C9   (hex)		Gumstix, Inc
+0015C9     (base 16)		Gumstix, Inc
+				3130 Alpine Road
+				Portola Valley  CA  94028
+				US
+
+00-15-BA   (hex)		iba AG
+0015BA     (base 16)		iba AG
+				Koenigswarterstrasse 44
+				Fuerth  Bavaria  90762
+				DE
+
+00-15-BB   (hex)		SMA Solar Technology AG
+0015BB     (base 16)		SMA Solar Technology AG
+				Sonnenallee 1
+				Niestetal  Hessen  34266
+				DE
+
+00-15-BF   (hex)		technicob
+0015BF     (base 16)		technicob
+				4 Rue Camille Saint-Saens
+				LANESTER  Morbihan  56602
+				US
+
+00-15-82   (hex)		Pulse Eight Limited
+001582     (base 16)		Pulse Eight Limited
+				13 The Metro Centre
+				Peterbourugh  PE2 7UH  
+				GB
+
+00-15-7B   (hex)		Leuze electronic GmbH + Co. KG
+00157B     (base 16)		Leuze electronic GmbH + Co. KG
+				In der Braike 1
+				Owen  Baden-Württemberg  73277
+				DE
+
+00-15-78   (hex)		Audio / Video Innovations
+001578     (base 16)		Audio / Video Innovations
+				A3-3375 North Service Road
+				Burlington  ON  L7N 3G2
+				CA
+
+00-15-AE   (hex)		kyung il
+0015AE     (base 16)		kyung il
+				woar rong-myn yougate-ri 101-2
+				paju-city  gyeong gi  413-813
+				KR
+
+00-15-BC   (hex)		Develco
+0015BC     (base 16)		Develco
+				Olof Palmes Allé 40
+				Aarhus N    8200
+				DK
+
+00-15-BD   (hex)		Group 4 Technology Ltd
+0015BD     (base 16)		Group 4 Technology Ltd
+				Challenge House
+				Tewkesbury  Gloucestershire  GL20 8UQ
+				GB
+
+00-15-B5   (hex)		CI Network Corp.
+0015B5     (base 16)		CI Network Corp.
+				2F Daini Inoue Bldg
+				Tokyo    107-0052
+				JP
+
+00-15-CD   (hex)		Exartech International Corp.
+0015CD     (base 16)		Exartech International Corp.
+				3/F, No.62, Lane 188, Ruei Guang Rd., Neihu
+				Taipei    114
+				TW
+
+00-15-D9   (hex)		PKC Electronics Oy
+0015D9     (base 16)		PKC Electronics Oy
+				Pajuniityntie 43
+				RAAHE    92120
+				FI
+
+00-15-DD   (hex)		IP Control Systems Ltd.
+0015DD     (base 16)		IP Control Systems Ltd.
+				Unit 15, Hi-Tech Village,
+				Boldon  Tyne & Wear  NE35 9PE
+				GB
+
+00-15-9C   (hex)		B-KYUNG SYSTEM Co.,Ltd.
+00159C     (base 16)		B-KYUNG SYSTEM Co.,Ltd.
+				#812,WOOLIM E-BIZ CENTER,170-5
+				GURO-DONG  GURO-GU  152-847
+				KR
+
+00-15-95   (hex)		Quester Tangent Corporation
+001595     (base 16)		Quester Tangent Corporation
+				201 - 9865 West Saanich Road
+				Sidney  BC  V8L 5Y8
+				CA
+
+00-15-87   (hex)		Takenaka Seisakusho Co.,Ltd
+001587     (base 16)		Takenaka Seisakusho Co.,Ltd
+				178 HISHIE
+				HIGASHI-OSAKA CITY  OSAKA  578-0984
+				JP
+
+00-15-1A   (hex)		Hunter Engineering Company
+00151A     (base 16)		Hunter Engineering Company
+				11250 Hunter Drive
+				Bridgeton  Missouri  63044
+				US
+
+00-15-14   (hex)		Hu Zhou NAVA Networks&Electronics Ltd.
+001514     (base 16)		Hu Zhou NAVA Networks&Electronics Ltd.
+				3/F,No.328-4,Guang Yuan Rd.
+				Hu Zhou  Zhe Jiang  313000
+				CN
+
+00-15-16   (hex)		URIEL SYSTEMS INC.
+001516     (base 16)		URIEL SYSTEMS INC.
+				#204 Byucksan Digitalvalley 1st, 212-16, Guro-dong, Guro-gu
+				Seoul    152-050
+				KR
+
+00-15-45   (hex)		SEECODE Co., Ltd.
+001545     (base 16)		SEECODE Co., Ltd.
+				4th Floor, Amin Bldg., 110-1, Yangjaedong, Seochogu
+				Seoul    137-891
+				KR
+
+00-15-43   (hex)		Aberdeen Test Center
+001543     (base 16)		Aberdeen Test Center
+				400 Colleran Road
+				Aberdeen Proving Grounds  MD  21005-5059
+				US
+
+00-15-41   (hex)		StrataLight Communications, Inc.
+001541     (base 16)		StrataLight Communications, Inc.
+				2105 S. Bascom Avenue
+				Campbell  CA  95008
+				US
+
+00-15-69   (hex)		PECO II, Inc.
+001569     (base 16)		PECO II, Inc.
+				7060 Huntley Road
+				Columbus  OH  43229
+				US
+
+00-15-64   (hex)		BEHRINGER Spezielle Studiotechnik GmbH
+001564     (base 16)		BEHRINGER Spezielle Studiotechnik GmbH
+				Hanns-Martin-Schleyer-Str. 36-38
+				Willich    
+				DE
+
+00-15-63   (hex)		Cisco Systems, Inc
+001563     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-15-61   (hex)		JJPlus Corporation
+001561     (base 16)		JJPlus Corporation
+				678 Massachusetts Ave
+				Cambridge  MA  02139
+				US
+
+00-15-71   (hex)		Nolan Systems
+001571     (base 16)		Nolan Systems
+				1595 Cleo Springs Dr.
+				San Jose  Ca.  95131
+				US
+
+00-15-65   (hex)		XIAMEN YEALINK NETWORK TECHNOLOGY CO.,LTD
+001565     (base 16)		XIAMEN YEALINK NETWORK TECHNOLOGY CO.,LTD
+				7F Hualian Electronic BLDG.580 Jiahe Road,Xiamen China
+				Xiamen  Fujian  361006
+				CN
+
+00-15-38   (hex)		RFID, Inc.
+001538     (base 16)		RFID, Inc.
+				14100 East Jewell Ave.
+				Aurora  CO  80012
+				US
+
+00-15-2E   (hex)		PacketHop, Inc.
+00152E     (base 16)		PacketHop, Inc.
+				1301 Shoreway Road
+				Belmont  California  94002
+				US
+
+00-15-58   (hex)		FOXCONN
+001558     (base 16)		FOXCONN
+				No.2,2nd DongHuan Road,10th YouSong
+				ShenZhen  GuangDong  518109
+				US
+
+00-15-1F   (hex)		Multivision Intelligent Surveillance (Hong Kong) Ltd
+00151F     (base 16)		Multivision Intelligent Surveillance (Hong Kong) Ltd
+				26/F, Aitken Vanson Centre,
+				    
+				HK
+
+00-15-22   (hex)		Dea Security
+001522     (base 16)		Dea Security
+				Via Togliatti
+				Santo Stefano Magra  SP  19037
+				IT
+
+00-15-4F   (hex)		one RF Technology
+00154F     (base 16)		one RF Technology
+				1360 Route des Dolines
+				Valbonne Sophia-Antipolis  PACA  06560
+				FR
+
+00-15-01   (hex)		LexBox
+001501     (base 16)		LexBox
+				3, avenue Didier Daurat
+				TOULOUSE    31400
+				FR
+
+00-14-A3   (hex)		Vitelec BV
+0014A3     (base 16)		Vitelec BV
+				kapittelweg 18
+				Breda  NB  NL 4827 HG
+				NL
+
+00-14-97   (hex)		ZHIYUAN Eletronics co.,ltd.
+001497     (base 16)		ZHIYUAN Eletronics co.,ltd.
+				2 Floor, NO.3 Building, Huangzhou Industrial Estate, Chebei Road,
+				Guangzhou  Guangdong  510660
+				CN
+
+00-14-99   (hex)		Helicomm Inc
+001499     (base 16)		Helicomm Inc
+				1947 Camino Vida Roble
+				Carlsbad  CA  92008
+				US
+
+00-14-92   (hex)		Liteon, Mobile Media Solution SBU
+001492     (base 16)		Liteon, Mobile Media Solution SBU
+				4F, 3, Lane 768, Sec. 4,
+				Taipei    115
+				TW
+
+00-14-94   (hex)		ESU AG
+001494     (base 16)		ESU AG
+				Lukasstrasse 29
+				St. Gallen    9008
+				CH
+
+00-14-EF   (hex)		TZero Technologies, Inc.
+0014EF     (base 16)		TZero Technologies, Inc.
+				455 W. Maude Avenue
+				Sunnyvale  CA  94085
+				US
+
+00-14-BC   (hex)		SYNECTIC TELECOM EXPORTS PVT. LTD.
+0014BC     (base 16)		SYNECTIC TELECOM EXPORTS PVT. LTD.
+				196, 1st Main, 3rd Stage, 4th Block
+				BANGALORE    560079
+				IN
+
+00-14-B9   (hex)		MSTAR SEMICONDUCTOR
+0014B9     (base 16)		MSTAR SEMICONDUCTOR
+				11-13 rue René Jacques
+				Issy les Moulineaux    92130
+				FR
+
+00-14-BD   (hex)		incNETWORKS, Inc
+0014BD     (base 16)		incNETWORKS, Inc
+				198 Brighton Ave
+				Long Branch  NJ  07740
+				US
+
+00-14-B7   (hex)		AR Infotek Inc.
+0014B7     (base 16)		AR Infotek Inc.
+				9F, No.185, GangQian Road
+				Taipei    11494
+				TW
+
+00-14-CA   (hex)		Key Radio Systems Limited
+0014CA     (base 16)		Key Radio Systems Limited
+				Venus House
+				Aldermaston  Berkshire  RG7 8DA
+				GB
+
+00-14-C8   (hex)		Contemporary Research Corp
+0014C8     (base 16)		Contemporary Research Corp
+				4355 Excel Pkwy
+				Addison  TX  75001
+				US
+
+00-14-C5   (hex)		Alive Technologies Pty Ltd
+0014C5     (base 16)		Alive Technologies Pty Ltd
+				11 Technology Drive
+				Arundel  Queensland  4214
+				AU
+
+00-14-DA   (hex)		Huntleigh Healthcare
+0014DA     (base 16)		Huntleigh Healthcare
+				Huntleigh Healthcare - Diagnostic Products Division
+				Cardiff    CF24 5HN
+				GB
+
+00-14-D5   (hex)		Datang Telecom Technology CO. , LCD,Optical Communication Br
+0014D5     (base 16)		Datang Telecom Technology CO. , LCD,Optical Communication Br
+				3rd Floor,Building 8,Hi-Tech Incubation Park,
+				ChengDu  SiChuan  610041
+				CN
+
+00-14-D3   (hex)		SEPSA
+0014D3     (base 16)		SEPSA
+				calle Albatros, 7 y 9
+				PINTO  Madrid  28320
+				ES
+
+00-14-D8   (hex)		bio-logic SA
+0014D8     (base 16)		bio-logic SA
+				1, rue de l'Europe
+				CLAIX    38640
+				FR
+
+00-14-EE   (hex)		Western Digital Technologies, Inc.
+0014EE     (base 16)		Western Digital Technologies, Inc.
+				20511 Lake Forest Dr.
+				Lake Forest  Ca  92630
+				US
+
+00-14-B5   (hex)		PHYSIOMETRIX,INC
+0014B5     (base 16)		PHYSIOMETRIX,INC
+				101 BILLERICA AVE #5
+				N. BILLERICA  MA  01862
+				US
+
+00-14-9C   (hex)		HF Company
+00149C     (base 16)		HF Company
+				Node Park Touraine
+				BP1 Tauxigny    37310
+				FR
+
+00-14-5C   (hex)		Intronics B.V.
+00145C     (base 16)		Intronics B.V.
+				Koolhovenstraat 1E
+				Barneveld  Gelderland  3772 MT
+				NL
+
+00-14-5A   (hex)		Neratec Solutions AG
+00145A     (base 16)		Neratec Solutions AG
+				Rosswiesstrasse 29
+				CH-8608  Bubikon  ZH
+				CH
+
+00-14-5B   (hex)		SeekerNet Inc.
+00145B     (base 16)		SeekerNet Inc.
+				300 Satellite Blvd.
+				Suwanee  Georgia  30024
+				US
+
+00-14-49   (hex)		Sichuan Changhong Electric Ltd.
+001449     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+00-14-46   (hex)		SuperVision Solutions LLC
+001446     (base 16)		SuperVision Solutions LLC
+				762 Industrial Dr.
+				Elmhurst  IL  60126
+				US
+
+00-14-40   (hex)		ATOMIC Corporation
+001440     (base 16)		ATOMIC Corporation
+				MAMPO BLDG
+				TAITO-KU  TOKYO  111-0053
+				JP
+
+00-14-2E   (hex)		77 Elektronika Kft.
+00142E     (base 16)		77 Elektronika Kft.
+				Fehervari ut 98.
+				  Budapest  H-1163
+				HU
+
+00-14-30   (hex)		ViPowER, Inc
+001430     (base 16)		ViPowER, Inc
+				9F., No.205-3, Sec. 3, Beisin Rd
+				Sindian  Taipei County  231
+				TW
+
+00-14-32   (hex)		Tarallax Wireless, Inc.
+001432     (base 16)		Tarallax Wireless, Inc.
+				10 West 100 South,
+				Salt Lake City  UT  84101
+				US
+
+00-14-85   (hex)		Giga-Byte
+001485     (base 16)		Giga-Byte
+				No.215,Nan-Ping Road,
+				Pin-Jen  Taoyuan  326
+				TW
+
+00-14-83   (hex)		eXS Inc.
+001483     (base 16)		eXS Inc.
+				1900 Alameda de las Pulgas
+				San Mateo  CA  94403
+				US
+
+00-14-71   (hex)		Eastern Asia Technology Limited
+001471     (base 16)		Eastern Asia Technology Limited
+				8F-1, No. 188, Baoqiao Rd., Xindian Dist.
+				New Taipei City    23145
+				TW
+
+00-14-6A   (hex)		Cisco Systems, Inc
+00146A     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-14-4C   (hex)		General Meters Corp.
+00144C     (base 16)		General Meters Corp.
+				1935 Dominion Way
+				Colorado Springs  Colorado  80918
+				US
+
+00-14-43   (hex)		Consultronics Europe Ltd
+001443     (base 16)		Consultronics Europe Ltd
+				Electron Way
+				Chandlers Ford  Hants  SO53 4SE
+				GB
+
+00-14-60   (hex)		Kyocera Wireless Corp.
+001460     (base 16)		Kyocera Wireless Corp.
+				10300 Campus Point Drive
+				San Diego  CA  92121
+				US
+
+00-13-F5   (hex)		Akimbi Systems
+0013F5     (base 16)		Akimbi Systems
+				1400 Fashion Island Blvd
+				San Mateo  CA  94404
+				US
+
+00-13-F1   (hex)		AMOD Technology Co., Ltd.
+0013F1     (base 16)		AMOD Technology Co., Ltd.
+				2F., No. 16, Prosperity Road II
+				Hsinchu,    30078
+				TW
+
+00-13-E7   (hex)		Halcro
+0013E7     (base 16)		Halcro
+				Suite 1, Level 1
+				Wayville  South Australia  5034
+				AU
+
+00-13-EA   (hex)		Kamstrup A/S
+0013EA     (base 16)		Kamstrup A/S
+				Industrivej 28
+				Stilling    8660
+				DK
+
+00-13-E1   (hex)		Iprobe AB
+0013E1     (base 16)		Iprobe AB
+				Finlandsgatan 12
+				  Kista  SE-16474
+				SE
+
+00-13-E3   (hex)		CoVi Technologies, Inc.
+0013E3     (base 16)		CoVi Technologies, Inc.
+				6300 Bridgepoint Parkway
+				Austin  Texas  78730
+				US
+
+00-13-E4   (hex)		YANGJAE SYSTEMS CORP.
+0013E4     (base 16)		YANGJAE SYSTEMS CORP.
+				1202. HANSHIN IT TOWER Guro-3Dong,
+				  Seoul  152-848
+				KR
+
+00-13-C1   (hex)		Asoka USA Corporation
+0013C1     (base 16)		Asoka USA Corporation
+				558 Pilgrim Drive
+				Foster City  CA  94404
+				US
+
+00-13-C0   (hex)		Trix Tecnologia Ltda.
+0013C0     (base 16)		Trix Tecnologia Ltda.
+				Rua da Paz, 1957 - Chácara Santo Antônio
+				São Paulo    04713-002
+				BR
+
+00-14-1F   (hex)		SunKwang Electronics Co., Ltd
+00141F     (base 16)		SunKwang Electronics Co., Ltd
+				#365(Techno-park, 301 dong, 901 ho,) Samjung-dong, Ohjung-ku,
+				Bucheon-shi  Kyunggi-do  421-809
+				KR
+
+00-14-1D   (hex)		LTI-Motion GmbH
+00141D     (base 16)		LTI-Motion GmbH
+				Gewerbestrasse 5-9
+				Lahnau  Hessen  35633
+				DE
+
+00-14-12   (hex)		S-TEC electronics AG
+001412     (base 16)		S-TEC electronics AG
+				Industriestrasse 49
+				  Zug  6300
+				CH
+
+00-14-11   (hex)		Deutschmann Automation GmbH & Co. KG
+001411     (base 16)		Deutschmann Automation GmbH & Co. KG
+				Carl-Zeiss-Str. 8
+				Bad Camberg    D - 65520
+				DE
+
+00-14-05   (hex)		OpenIB, Inc.
+001405     (base 16)		OpenIB, Inc.
+				OpenFabrics, Inc., c/o QLogic Corporation
+				Mountain View  CA  94043-4655
+				US
+
+00-45-01   (hex)		Midmark RTLS
+004501     (base 16)		Midmark RTLS
+				2600 Miller Creek Road
+				Traverse City  MI  49684
+				US
+
+00-14-03   (hex)		Renasis, LLC
+001403     (base 16)		Renasis, LLC
+				1530 N. State St.
+				Lehi  UT  84043
+				US
+
+00-14-01   (hex)		Rivertree Networks Corp.
+001401     (base 16)		Rivertree Networks Corp.
+				R#304, K-Center, 1591-9
+				Anyang-si  Kyunggi-do  431-815
+				KR
+
+00-13-D9   (hex)		Matrix Product Development, Inc.
+0013D9     (base 16)		Matrix Product Development, Inc.
+				13 North Bird Street
+				Sun Prairie  WI  53590
+				US
+
+00-13-CC   (hex)		Tall Maple Systems
+0013CC     (base 16)		Tall Maple Systems
+				85 Saratoga Ave Suite 139
+				Santa Clara  CA  95051
+				US
+
+00-13-94   (hex)		Infohand Co.,Ltd
+001394     (base 16)		Infohand Co.,Ltd
+				Kranz-Techno #1207, 5442-1, Sangdaewon-dong, Jungwon-gu
+				Seongnam-si  Gyeonggi-do  462-819
+				KR
+
+00-13-89   (hex)		Redes de Telefonía Móvil S.A.
+001389     (base 16)		Redes de Telefonía Móvil S.A.
+				C/Puerto de la Morcuera 14 B4
+				Leganés  Madrid  28918
+				ES
+
+00-13-8C   (hex)		Kumyoung.Co.Ltd
+00138C     (base 16)		Kumyoung.Co.Ltd
+				Seoul KY building, 40-17 Hangang Ro, 3Ga, Youngsan-Gu
+				Seoul    140-880
+				KR
+
+00-13-A1   (hex)		Crow Electronic Engeneering
+0013A1     (base 16)		Crow Electronic Engeneering
+				12 Kinneret st.
+				Airport City    
+				IL
+
+00-13-9C   (hex)		Exavera Technologies, Inc.
+00139C     (base 16)		Exavera Technologies, Inc.
+				195 New Hampshire Avenue
+				Portsmouth  NH  03801
+				US
+
+00-13-55   (hex)		TOMEN Cyber-business Solutions, Inc.
+001355     (base 16)		TOMEN Cyber-business Solutions, Inc.
+				2-11-19 Kohnan
+				TOKYO    108-0075
+				JP
+
+00-13-57   (hex)		Soyal Technology Co., Ltd.
+001357     (base 16)		Soyal Technology Co., Ltd.
+				10F, No. 27, Lane 169, Kangning St., Shijr City,
+				Taipei    221
+				TW
+
+00-13-60   (hex)		Cisco Systems, Inc
+001360     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-8E   (hex)		FOAB Elektronik AB
+00138E     (base 16)		FOAB Elektronik AB
+				Sankt Jorgens Vag 8
+				Gothenburg    422 49
+				SE
+
+00-13-76   (hex)		Tabor Electronics Ltd.
+001376     (base 16)		Tabor Electronics Ltd.
+				9 Hatatsia St.
+				Tel Hanan    20302
+				IL
+
+00-13-5D   (hex)		NTTPC Communications, Inc.
+00135D     (base 16)		NTTPC Communications, Inc.
+				3-25 Kanda Jinbo-cho
+				Chiyoda-ku  Tokyo  101-0051
+				JP
+
+00-13-52   (hex)		Naztec, Inc.
+001352     (base 16)		Naztec, Inc.
+				820 Park Two Dr.
+				Sugar Land  TX  77478
+				US
+
+00-13-6C   (hex)		TomTom
+00136C     (base 16)		TomTom
+				Oosterdoksstraat 114
+				1011 DK  Amsterdam  
+				NL
+
+00-13-64   (hex)		Paradigm Technology Inc..
+001364     (base 16)		Paradigm Technology Inc..
+				3F, No. 285, Sec.2, Ti-Ding Blvd Nei-Hu,
+				Taipei    114
+				TW
+
+00-13-6B   (hex)		E-TEC
+00136B     (base 16)		E-TEC
+				2-17-14-503 Hakataekimae
+				Fukuoka  Fukuokaken  812-0011
+				JP
+
+00-13-80   (hex)		Cisco Systems, Inc
+001380     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-13-85   (hex)		Add-On Technology Co., LTD.
+001385     (base 16)		Add-On Technology Co., LTD.
+				1F, No.11, Lane 206, Da-An Road Sec. 1,
+				Taipei    106
+				TW
+
+00-13-B3   (hex)		Ecom Communications Technology Co., Ltd.
+0013B3     (base 16)		Ecom Communications Technology Co., Ltd.
+				Floor 7, Machinery Industry Building, No.22,
+				Beijing    
+				CN
+
+00-13-B7   (hex)		Scantech ID
+0013B7     (base 16)		Scantech ID
+				Vanadiumweg 22
+				Amersfoort  Utrecht  3812 PZ
+				NL
+
+00-13-08   (hex)		Nuvera Fuel Cells
+001308     (base 16)		Nuvera Fuel Cells
+				129 Concord Road, #1
+				Billerica  MA  01821
+				US
+
+00-13-07   (hex)		Paravirtual Corporation
+001307     (base 16)		Paravirtual Corporation
+				2953 Bunker Hill Lane
+				Santa Clara  CA  95054
+				US
+
+00-12-FC   (hex)		PLANET System Co.,LTD
+0012FC     (base 16)		PLANET System Co.,LTD
+				4th Floor, Daehan B/D, 873-29,
+				Seoul    137-064
+				KR
+
+00-12-FE   (hex)		Lenovo Mobile Communication Technology Ltd.
+0012FE     (base 16)		Lenovo Mobile Communication Technology Ltd.
+				Xiamen Overseas Chinese Electronic Science Park,Huoju High Technology Development Zone
+				XIA MEN  FU JIAN  361009
+				CN
+
+00-12-EC   (hex)		Movacolor b.v.
+0012EC     (base 16)		Movacolor b.v.
+				Koperslagersstraat 31
+				Sneek  Friesland  8601 WL
+				NL
+
+00-12-EB   (hex)		PDH Solutions, LLC
+0012EB     (base 16)		PDH Solutions, LLC
+				34154 Bennett Rd
+				Warren  OR  97053
+				US
+
+00-13-43   (hex)		Matsushita Electronic Components (Europe) GmbH
+001343     (base 16)		Matsushita Electronic Components (Europe) GmbH
+				Zeppelinstraße 19
+				Lueneburg  Niedersachsen  21337
+				DE
+
+00-13-3E   (hex)		MetaSwitch
+00133E     (base 16)		MetaSwitch
+				1411 Harbor Bay Parkway
+				Alameda  CA  94502
+				US
+
+00-13-45   (hex)		Eaton Corporation
+001345     (base 16)		Eaton Corporation
+				4201 North 27th Street
+				Milwaukee  Wisconsin  53216
+				US
+
+00-13-47   (hex)		Red Lion Controls, LP
+001347     (base 16)		Red Lion Controls, LP
+				20 Willow Springs Circle
+				York  NY  17402
+				US
+
+00-13-2E   (hex)		ITian Coporation
+00132E     (base 16)		ITian Coporation
+				4F Youngho Bd.1605-1 Seocho-dong
+				Seoul    137-070
+				KR
+
+00-13-39   (hex)		CCV Deutschland GmbH
+001339     (base 16)		CCV Deutschland GmbH
+				Gewerbering 1
+				Au i. d. Hallertau  Bayern  84072
+				DE
+
+00-13-29   (hex)		VSST Co., LTD
+001329     (base 16)		VSST Co., LTD
+				suit 3202, Korea World Trade Center 159-1
+				Seoul    135-729
+				KR
+
+00-13-2B   (hex)		Phoenix Digital
+00132B     (base 16)		Phoenix Digital
+				7650 East Evans Rd. Bldg. A
+				Scottsdale  Az  85260
+				US
+
+00-13-0B   (hex)		Mextal B.V.
+00130B     (base 16)		Mextal B.V.
+				De Tienden 48
+				Nuenen  Noord Brabant  5674TB
+				NL
+
+00-13-0D   (hex)		GALILEO AVIONICA
+00130D     (base 16)		GALILEO AVIONICA
+				VIALE EUROPA
+				 NERVIANO  MILANO  20014
+				IT
+
+00-12-F7   (hex)		Xiamen Xinglian Electronics Co., Ltd.
+0012F7     (base 16)		Xiamen Xinglian Electronics Co., Ltd.
+				Xinglian Electronics (Xingtel) Building,Chuangxin Road,
+				Xiamen  Fujian  361006
+				CN
+
+00-13-1B   (hex)		BeCell Innovations Corp.
+00131B     (base 16)		BeCell Innovations Corp.
+				12F-9, No. 79, Shin-Tai 5th Rd Sec 1,
+				Shih-chih,  Taipei  221
+				TW
+
+00-12-E2   (hex)		ALAXALA Networks Corporation
+0012E2     (base 16)		ALAXALA Networks Corporation
+				890 Kashimada, Saiwai-ku
+				Kawasaki-shi  Kanagawa-ken  212-0058
+				JP
+
+00-12-DF   (hex)		Novomatic AG
+0012DF     (base 16)		Novomatic AG
+				Wiener Strasse 158
+				Gumpoldskirchen  Niederösterreich  A-2352
+				AT
+
+00-12-D4   (hex)		Princeton Technology, Ltd
+0012D4     (base 16)		Princeton Technology, Ltd
+				K.A.I. Bldg. 3F
+				Chiyodaku  Tokyo  101-0032
+				JP
+
+00-12-D9   (hex)		Cisco Systems, Inc
+0012D9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-C2   (hex)		Apex Electronics Factory
+0012C2     (base 16)		Apex Electronics Factory
+				No.3 Industrial Zone, No.4 Block,
+				Shen Zhen  Guang Dong  518103
+				CN
+
+00-12-BE   (hex)		Astek Corporation
+0012BE     (base 16)		Astek Corporation
+				5055 Corporate Plaza Drive
+				Colorado Springs  Colorado  80919
+				US
+
+00-12-E1   (hex)		Alliant Networks, Inc
+0012E1     (base 16)		Alliant Networks, Inc
+				1259 Birchwood Dr.
+				Sunnyvale  CA  94089
+				US
+
+00-12-C5   (hex)		V-Show  Technology (China) Co.,Ltd
+0012C5     (base 16)		V-Show  Technology (China) Co.,Ltd
+				7F, Tengda Plaza, No.168
+				HaiDian District,  Beijing  100089
+				CN
+
+00-12-AD   (hex)		IDS GmbH
+0012AD     (base 16)		IDS GmbH
+				Nobelstraße, 18
+				Ettlingen  Baden-Württemberg  76275
+				DE
+
+00-12-A0   (hex)		NeoMeridian Sdn Bhd
+0012A0     (base 16)		NeoMeridian Sdn Bhd
+				3A-1, Perdana The Place
+				Bandar Damansara Perdana  Selangor  47820
+				MY
+
+00-12-86   (hex)		ENDEVCO CORP
+001286     (base 16)		ENDEVCO CORP
+				30700 RANCHO VIEJO ROAD
+				SAN JUAN CAPISTRANO  CA  92675
+				US
+
+00-12-63   (hex)		Data Voice Technologies GmbH
+001263     (base 16)		Data Voice Technologies GmbH
+				Stockholmer Allee 32b
+				Dortmund  NRW  D-44269
+				DE
+
+00-12-70   (hex)		NGES Denro Systems
+001270     (base 16)		NGES Denro Systems
+				7055 Troy Hill Dr
+				Elkridge  MD  21075
+				US
+
+00-12-6E   (hex)		Seidel Elektronik GmbH Nfg.KG
+00126E     (base 16)		Seidel Elektronik GmbH Nfg.KG
+				Frauentalerstrasse 100
+				Deutschlandsberg  Steiermark  8530
+				AT
+
+00-12-6F   (hex)		Rayson Technology Co., Ltd.
+00126F     (base 16)		Rayson Technology Co., Ltd.
+				1F No.9 R&D Rd.II, Science-Based Industrial Park
+				Hsin-Chu    300
+				TW
+
+00-12-5C   (hex)		Green Hills Software, Inc.
+00125C     (base 16)		Green Hills Software, Inc.
+				30 West Sola Street
+				Santa Barbara  CA  93101
+				US
+
+00-12-5F   (hex)		AWIND Inc.
+00125F     (base 16)		AWIND Inc.
+				17F., No. 886-5, Jungjeng Rd
+				Taipei County    235
+				TW
+
+00-12-2D   (hex)		SiNett Corporation
+00122D     (base 16)		SiNett Corporation
+				640 W. California Avenue
+				Sunnyvale  CA  94086
+				US
+
+00-12-74   (hex)		NIT lab
+001274     (base 16)		NIT lab
+				Skoriny str., 65-3
+				Minsk  Minskaya obl.  220013
+				BY
+
+00-12-53   (hex)		AudioDev AB
+001253     (base 16)		AudioDev AB
+				Kabingatan 9
+				Malmö    SE-212 39
+				SE
+
+00-12-4C   (hex)		BBWM Corporation
+00124C     (base 16)		BBWM Corporation
+				6F, No. 578, Rui Guang Road, Nei Hu
+				Taipei    114
+				TW
+
+00-12-55   (hex)		NetEffect Incorporated
+001255     (base 16)		NetEffect Incorporated
+				9211 Waterford Centre Blvd
+				Austin  Texas  78758
+				US
+
+00-12-44   (hex)		Cisco Systems, Inc
+001244     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-12-2C   (hex)		Soenen Controls N.V.
+00122C     (base 16)		Soenen Controls N.V.
+				Wijnedalestraat 190
+				Roeselare  W-VL  8800
+				BE
+
+00-12-2B   (hex)		Virbiage Pty Ltd
+00122B     (base 16)		Virbiage Pty Ltd
+				Level 4
+				Melbourne  Victoria  3000
+				AU
+
+00-12-32   (hex)		LeWiz Communications Inc.
+001232     (base 16)		LeWiz Communications Inc.
+				1376 N. 4th St. #300
+				San Jose  CA  95112
+				US
+
+00-12-27   (hex)		Franklin Electric Co., Inc.
+001227     (base 16)		Franklin Electric Co., Inc.
+				400 E. Spring Street
+				Bluffton  Indiana  46714
+				US
+
+00-12-1A   (hex)		Techno Soft Systemnics Inc.
+00121A     (base 16)		Techno Soft Systemnics Inc.
+				2-5-17, Ebisu-nishi, Naniwa-ku,
+				Osaka    556-0003
+				JP
+
+00-12-1B   (hex)		Sound Devices, LLC
+00121B     (base 16)		Sound Devices, LLC
+				300 Wengel Drive
+				Reedsburg  WI  53959
+				US
+
+00-11-DF   (hex)		Current Energy
+0011DF     (base 16)		Current Energy
+				5440 Harvest Hill, Ste 100
+				Dallas  TX  75230
+				US
+
+00-11-D7   (hex)		eWerks Inc
+0011D7     (base 16)		eWerks Inc
+				420-2166 Mountain Grove Ave
+				Burlington  Ontario  L7P4X4
+				CA
+
+00-12-04   (hex)		u10 Networks, Inc.
+001204     (base 16)		u10 Networks, Inc.
+				2-2-14 Kakinokizaka
+				Meguro  Tokyo  152-0022
+				JP
+
+00-12-0A   (hex)		Emerson Climate Technologies GmbH
+00120A     (base 16)		Emerson Climate Technologies GmbH
+				Heerstrasse 111
+				Waiblingen  BW  71332
+				DE
+
+00-12-08   (hex)		Gantner Instruments GmbH
+001208     (base 16)		Gantner Instruments GmbH
+				Montafonerstrasse 8
+				Schruns  Vorarlberg  6780
+				AT
+
+00-12-01   (hex)		Cisco Systems, Inc
+001201     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-EE   (hex)		Estari, Inc.
+0011EE     (base 16)		Estari, Inc.
+				1800 Paxton St
+				Harrisburg  PA  17104
+				US
+
+00-12-00   (hex)		Cisco Systems, Inc
+001200     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-E5   (hex)		KCodes Corporation
+0011E5     (base 16)		KCodes Corporation
+				Floor 2, Number 501, Section 2
+				Neihu District  Taipei City  114
+				TW
+
+00-11-DE   (hex)		EURILOGIC
+0011DE     (base 16)		EURILOGIC
+				Centrale Parc Bât 7
+				Chatenay Malabry    92298
+				FR
+
+00-11-C8   (hex)		Powercom Co., Ltd.
+0011C8     (base 16)		Powercom Co., Ltd.
+				8F, No. 246, Lien Chen Rd.
+				Chung Ho  Taipei  235
+				TW
+
+00-11-B8   (hex)		Liebherr - Elektronik GmbH
+0011B8     (base 16)		Liebherr - Elektronik GmbH
+				Peter - Dornier - Strasse 11
+				Lindau (Bodensee)  Bavaria  88131
+				DE
+
+00-11-B4   (hex)		Westermo Network Technologies AB
+0011B4     (base 16)		Westermo Network Technologies AB
+				Stora Sundby
+				Sweden    SE-640 40
+				SE
+
+00-11-78   (hex)		Chiron Technology Ltd
+001178     (base 16)		Chiron Technology Ltd
+				Wyvols Court
+				Reading  Berkshire  RG7 1WY
+				GB
+
+00-11-6A   (hex)		Domo Ltd
+00116A     (base 16)		Domo Ltd
+				Wessex House
+				Eastleigh  Hampshire  SO50 9FD
+				GB
+
+00-11-93   (hex)		Cisco Systems, Inc
+001193     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-8C   (hex)		Missouri Department of Transportation
+00118C     (base 16)		Missouri Department of Transportation
+				P.O. Box 270
+				Jefferson City  Missouri  65102
+				US
+
+00-11-8E   (hex)		Halytech Mace
+00118E     (base 16)		Halytech Mace
+				Unit 11, 22 Lexington Drive
+				Baulkham Hills  NSW  2153
+				AU
+
+00-11-86   (hex)		Prime Systems, Inc.
+001186     (base 16)		Prime Systems, Inc.
+				16267-333
+				Suwa-gun Hara-mura  Nagano  391-0100
+				JP
+
+00-11-83   (hex)		Datalogic ADC, Inc.
+001183     (base 16)		Datalogic ADC, Inc.
+				959 Terry St
+				Eugene  OR  97402
+				US
+
+00-11-7D   (hex)		ZMD America, Inc.
+00117D     (base 16)		ZMD America, Inc.
+				15373 Innovation Drive
+				San Dieo  CA  92128
+				US
+
+00-11-7F   (hex)		Neotune Information Technology Corporation,.LTD
+00117F     (base 16)		Neotune Information Technology Corporation,.LTD
+				1703#  No.737  North of Caoxi Rd.
+				Shanghai    200030
+				CN
+
+00-11-9D   (hex)		Diginfo Technology Corporation
+00119D     (base 16)		Diginfo Technology Corporation
+				10Fl., No.82, Fu Hsing North Road
+				Taipei    106
+				TW
+
+00-11-9C   (hex)		EP&T Energy
+00119C     (base 16)		EP&T Energy
+				358 Eastern Valley Way
+				Sydney  NSW  2067
+				AU
+
+00-11-9A   (hex)		Alkeria srl
+00119A     (base 16)		Alkeria srl
+				25 Via Giuntini
+				Navacchio (PI)    I-56023
+				IT
+
+00-11-C1   (hex)		4P MOBILE DATA PROCESSING
+0011C1     (base 16)		4P MOBILE DATA PROCESSING
+				VIALE REGIONE VENETO 26
+				PADOVA  PD  35127
+				IT
+
+00-11-B2   (hex)		2001 Technology Inc.
+0011B2     (base 16)		2001 Technology Inc.
+				7F-10, 79 Hsin Tai 5th. Rd. Sec.1
+				Hsi Chih  Taipei County  221
+				TW
+
+00-11-AF   (hex)		Medialink-i,Inc
+0011AF     (base 16)		Medialink-i,Inc
+				1-9-10 Hamamatsu-Cho
+				Minato-Ku  Tokyo  105-0013
+				JP
+
+00-11-5E   (hex)		ProMinent Dosiertechnik GmbH
+00115E     (base 16)		ProMinent Dosiertechnik GmbH
+				Im Schumachergewann 5-11
+				Heidelberg  BW  69123
+				DE
+
+00-11-7C   (hex)		e-zy.net
+00117C     (base 16)		e-zy.net
+				Smirnis 14
+				Veria  Imathia  59100
+				GR
+
+00-11-39   (hex)		STOEBER ANTRIEBSTECHNIK GmbH + Co. KG.
+001139     (base 16)		STOEBER ANTRIEBSTECHNIK GmbH + Co. KG.
+				Kieselbronner Str. 12
+				Pforzheim    75177
+				DE
+
+00-11-3E   (hex)		JL Corporation
+00113E     (base 16)		JL Corporation
+				4-4-17 SUGE
+				KAWASAKI-CITY  KANAGAWA-KEN  214-0001
+				JP
+
+00-11-38   (hex)		TAISHIN CO., LTD.
+001138     (base 16)		TAISHIN CO., LTD.
+				200-7 Nakano
+				Nakano  Nagano  383-0013
+				JP
+
+00-11-36   (hex)		Goodrich Sensor Systems
+001136     (base 16)		Goodrich Sensor Systems
+				14300 Judicial Road
+				Burnsville  Minnesota  55306-4898
+				US
+
+00-11-32   (hex)		Synology Incorporated
+001132     (base 16)		Synology Incorporated
+				6F-2, No.106, Chang An W. Rd.,
+				Taipei    103
+				TW
+
+00-11-4B   (hex)		Francotyp-Postalia GmbH
+00114B     (base 16)		Francotyp-Postalia GmbH
+				Triftweg 21-26
+				Birkenwerder  Brandenburg  16547
+				DE
+
+00-11-47   (hex)		Secom-Industry co.LTD.
+001147     (base 16)		Secom-Industry co.LTD.
+				Fukuoka Kuramoto Ichihonki 3-3
+				Shiroishi  Miyagi  989-0295
+				JP
+
+00-11-4A   (hex)		KAYABA INDUSTRY Co,.Ltd.
+00114A     (base 16)		KAYABA INDUSTRY Co,.Ltd.
+				World Trade Center Bldg., 4-1
+				Minato-ku,  Tokyo Meto.  105-6111
+				JP
+
+00-11-42   (hex)		e-SMARTCOM  INC.
+001142     (base 16)		e-SMARTCOM  INC.
+				3F, 216, Imok-Dong
+				Suwon  Kyoungki-Do  440-310
+				KR
+
+00-11-20   (hex)		Cisco Systems, Inc
+001120     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-11-18   (hex)		BLX IC Design Corp., Ltd.
+001118     (base 16)		BLX IC Design Corp., Ltd.
+				Rm 1006, Quantum Plaza
+				Beijing    100083
+				CN
+
+00-11-07   (hex)		RGB Networks Inc.
+001107     (base 16)		RGB Networks Inc.
+				2929 Campus Drive
+				San Mateo  CA  94403
+				US
+
+00-11-08   (hex)		Orbital Data Corporation
+001108     (base 16)		Orbital Data Corporation
+				1900 S. Norfolk St. Ste 320
+				San Mateo  CA  94403
+				US
+
+00-11-0C   (hex)		Atmark Techno, Inc.
+00110C     (base 16)		Atmark Techno, Inc.
+				2F SD BLDG, 2-2-3-14 Atsubetsu-nishi, Atsubetsu-ku
+				Sapporo  Hokkaido  004-0062
+				JP
+
+00-11-4D   (hex)		Atsumi Electric Co.,LTD.
+00114D     (base 16)		Atsumi Electric Co.,LTD.
+				4-2-2 Shin-Miyakoda, Kita-ku
+				Hamamatsu  Shizuoka  431-2103
+				JP
+
+00-11-30   (hex)		Allied Telesis (Hong Kong) Ltd.
+001130     (base 16)		Allied Telesis (Hong Kong) Ltd.
+				Room F, 3/F, Yeung Yiu Chong (no. 8) Industrial building,
+				    
+				HK
+
+00-11-29   (hex)		Paradise Datacom Ltd.
+001129     (base 16)		Paradise Datacom Ltd.
+				1 Wheaton Road
+				Witham  Essex UK  CM8 1UJ
+				GB
+
+00-11-57   (hex)		Oki Electric Industry Co., Ltd.
+001157     (base 16)		Oki Electric Industry Co., Ltd.
+				1-7-12 Toranomon
+				Tokyo 105-8460    
+				JP
+
+00-0F-D9   (hex)		FlexDSL Telecommunications AG
+000FD9     (base 16)		FlexDSL Telecommunications AG
+				Haus zum Engel
+				Altendorf  Schwyz  8852
+				CH
+
+00-0F-D0   (hex)		ASTRI
+000FD0     (base 16)		ASTRI
+				18/F Tower 6, Gateway, 9 Canton Rd
+				    
+				HK
+
+00-0F-CA   (hex)		A-JIN TECHLINE CO, LTD
+000FCA     (base 16)		A-JIN TECHLINE CO, LTD
+				327-35
+				Kumchun-Ku  Seoul  153-802
+				KR
+
+00-0F-EC   (hex)		ARKUS Inc.
+000FEC     (base 16)		ARKUS Inc.
+				3-8 Chuo-cho
+				3-8 Noda, Kitaa-Ku    700-0971
+				JP
+
+00-0F-ED   (hex)		Anam Electronics Co., Ltd
+000FED     (base 16)		Anam Electronics Co., Ltd
+				645 Sungkok-dong
+				Ansan-city  Kyungki-do  425-834
+				KR
+
+00-0F-E5   (hex)		MERCURY SECURITY CORPORATION
+000FE5     (base 16)		MERCURY SECURITY CORPORATION
+				2355 MIRA MAR AVE.
+				LONG BEACH  CA  90815
+				US
+
+00-0F-AE   (hex)		E2O Communications
+000FAE     (base 16)		E2O Communications
+				52 Serangoon North Ave 4
+				    555853
+				SG
+
+00-0F-B1   (hex)		Cognio Inc.
+000FB1     (base 16)		Cognio Inc.
+				101 Orchard Ridge Drive
+				Gaithersburg  MD  20878
+				US
+
+00-0F-A7   (hex)		Raptor Networks Technology
+000FA7     (base 16)		Raptor Networks Technology
+				65 Enterprise Road
+				Aliso Viejo  CA  92656
+				US
+
+00-0F-F0   (hex)		Sunray Co. Ltd.
+000FF0     (base 16)		Sunray Co. Ltd.
+				Osawa2-5-5 Mitaka
+				  Tokyo  181-0015
+				JP
+
+00-11-03   (hex)		kawamura electric inc.
+001103     (base 16)		kawamura electric inc.
+				3-86 akatsuki-cho
+				seto  aichi  489-0071
+				JP
+
+00-0F-DD   (hex)		SORDIN AB
+000FDD     (base 16)		SORDIN AB
+				Rorlaggarvagen 8
+				Varnamo  Smaland  S-331 34
+				SE
+
+00-0F-C3   (hex)		PalmPalm Technology, Inc.
+000FC3     (base 16)		PalmPalm Technology, Inc.
+				Samsung-dong 156-3, Gangnam-gu
+				Seoul    135-091
+				KR
+
+00-0F-88   (hex)		AMETEK, Inc.
+000F88     (base 16)		AMETEK, Inc.
+				150 Freeport Road
+				Pittsburgh  PA  15238
+				US
+
+00-0F-7E   (hex)		Ablerex Electronics Co., LTD
+000F7E     (base 16)		Ablerex Electronics Co., LTD
+				1F, No.3 Lane 7, Paokao Rd.
+				Hsintien  Taipei Hsien  23114
+				TW
+
+00-0F-83   (hex)		Brainium Technologies Inc.
+000F83     (base 16)		Brainium Technologies Inc.
+				#201 - 11491 Kingston Street
+				Maple Ridge  BC  V2X 0Y6
+				CA
+
+00-0F-84   (hex)		Astute Networks, Inc.
+000F84     (base 16)		Astute Networks, Inc.
+				15015 Ave of Science
+				San Diego  CA  92128
+				US
+
+00-0F-5C   (hex)		Day One Digital Media Limited
+000F5C     (base 16)		Day One Digital Media Limited
+				197 Archers Rd
+				Auckland  North Island  1310
+				NZ
+
+00-0F-52   (hex)		YORK Refrigeration, Marine & Controls
+000F52     (base 16)		YORK Refrigeration, Marine & Controls
+				Jens Juulsvej 28
+				Viby J  DK  8362
+				DK
+
+00-0F-4C   (hex)		Elextech INC
+000F4C     (base 16)		Elextech INC
+				554-2, Gasan-Dong, Gumcheon-Gu
+				Seoul    153-023
+				KR
+
+00-0F-93   (hex)		Landis+Gyr Ltd.
+000F93     (base 16)		Landis+Gyr Ltd.
+				Feldstrasse 1
+				Zug    CH-6301
+				CH
+
+00-0F-94   (hex)		Genexis BV
+000F94     (base 16)		Genexis BV
+				Lodewijktraat 1A
+				5652 AC  Eindhoven    
+				SE
+
+00-0F-6C   (hex)		ADDI-DATA GmbH
+000F6C     (base 16)		ADDI-DATA GmbH
+				Airport Boulevard B210
+				RHEINMUENSTER  BW  77836
+				DE
+
+00-0F-8F   (hex)		Cisco Systems, Inc
+000F8F     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-7D   (hex)		Xirrus
+000F7D     (base 16)		Xirrus
+				310 North Westlake Blvd.
+				Westlake Village  CA  91362
+				US
+
+00-0F-76   (hex)		Digital Keystone, Inc.
+000F76     (base 16)		Digital Keystone, Inc.
+				1975 El Camino Real
+				Mountain View  CA  94040
+				US
+
+00-0F-9E   (hex)		Murrelektronik GmbH
+000F9E     (base 16)		Murrelektronik GmbH
+				Falkenstraße 3
+				Oppenweiler  Baden-Württemberg  71570
+				DE
+
+00-0F-79   (hex)		Bluetooth Interest Group Inc.
+000F79     (base 16)		Bluetooth Interest Group Inc.
+				4F, No. 9, Alley 2, Lane 35, Ji-Hu Rd.
+				Taipei    114
+				TW
+
+00-0F-17   (hex)		Insta Elektro GmbH
+000F17     (base 16)		Insta Elektro GmbH
+				Hohe Steinert 10
+				Luedenscheid  NRW  58509
+				DE
+
+00-0F-1E   (hex)		Chengdu KT Electric Co.of High & New Technology
+000F1E     (base 16)		Chengdu KT Electric Co.of High & New Technology
+				No.2 Gaopeng Dong Road,High & New Development Zone
+				Chengdu  Sichuan  610041
+				CN
+
+00-0F-15   (hex)		Icotera A/S
+000F15     (base 16)		Icotera A/S
+				Vibeholms Allé 16
+				Brøndby    2605
+				DK
+
+00-0F-39   (hex)		IRIS SENSORS
+000F39     (base 16)		IRIS SENSORS
+				ZA les Ufernets
+				TOULAUD  Ardeche  F07130
+				FR
+
+00-0F-3E   (hex)		CardioNet, Inc
+000F3E     (base 16)		CardioNet, Inc
+				1010 Second Avenue
+				San Diego  CA  92101
+				US
+
+00-0F-3F   (hex)		Big Bear Networks
+000F3F     (base 16)		Big Bear Networks
+				345 Potrero Ave
+				Sunny Vale  California  94085
+				US
+
+00-0F-35   (hex)		Cisco Systems, Inc
+000F35     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-36   (hex)		Accurate Techhnologies, Inc.
+000F36     (base 16)		Accurate Techhnologies, Inc.
+				47199 Cartier Dr.
+				Wixom  Michigan  48393
+				US
+
+00-0F-28   (hex)		Itronix Corporation
+000F28     (base 16)		Itronix Corporation
+				South 801 Stevens Street
+				Spokane  WA  99204
+				US
+
+00-0F-23   (hex)		Cisco Systems, Inc
+000F23     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0F-22   (hex)		Helius, Inc.
+000F22     (base 16)		Helius, Inc.
+				333 South 520 West
+				Lindon  UT  84042
+				US
+
+00-0F-24   (hex)		Cisco Systems, Inc
+000F24     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-FC   (hex)		JTAG Technologies B.V.
+000EFC     (base 16)		JTAG Technologies B.V.
+				Boschdijk 50
+				Eindhoven  NB  5612 AN
+				NL
+
+00-0E-FE   (hex)		EndRun Technologies LLC
+000EFE     (base 16)		EndRun Technologies LLC
+				2270 Northpoint Parkway
+				Santa Rosa  CA  95407
+				US
+
+00-0F-2C   (hex)		Uplogix, Inc.
+000F2C     (base 16)		Uplogix, Inc.
+				Bldg 1, Suite 235
+				Austin  TX  78730
+				US
+
+00-0F-2B   (hex)		GREENBELL SYSTEMS
+000F2B     (base 16)		GREENBELL SYSTEMS
+				2TH Floor, Doonam Bldg, 236-11 Nonhyun-Dong, Kangnam-Ku
+				Seoul    135-010
+				KR
+
+00-0E-F2   (hex)		Infinico Corporation
+000EF2     (base 16)		Infinico Corporation
+				4F, F-1 Bldg., 1-2-12,
+				Tokyo    105-0013
+				JP
+
+00-0F-0D   (hex)		Hunt Electronic Co., Ltd.
+000F0D     (base 16)		Hunt Electronic Co., Ltd.
+				6FI, NO. 57-59, Jiun H Sien Rd., Chi Tu District
+				Keelung  Taiwan  206
+				TW
+
+00-0F-08   (hex)		Indagon Oy
+000F08     (base 16)		Indagon Oy
+				Nuijamiestentie 5 A
+				Helsinki  -  00400
+				FI
+
+00-0F-04   (hex)		cim-usa inc
+000F04     (base 16)		cim-usa inc
+				10813 nw 30th street
+				miami  florida  33172
+				US
+
+00-0F-42   (hex)		Xalyo Systems
+000F42     (base 16)		Xalyo Systems
+				Grenier 9
+				Commugny  VD  1291
+				CH
+
+00-0E-A5   (hex)		BLIP Systems
+000EA5     (base 16)		BLIP Systems
+				Haekken 2
+				Vodskov  Vester Hassing  9310
+				DK
+
+00-0E-A0   (hex)		NetKlass Technology Inc.
+000EA0     (base 16)		NetKlass Technology Inc.
+				2F-1, No.30,Tai Yuen Street,
+				Chupei City,  Hsinchu,  302
+				TW
+
+00-0E-E4   (hex)		BOE TECHNOLOGY GROUP CO.,LTD
+000EE4     (base 16)		BOE TECHNOLOGY GROUP CO.,LTD
+				No.10 Jiuxianqiao Road,Chaoyang District,Beijing,PRC
+				Beijing    100016
+				CN
+
+00-0E-DE   (hex)		REMEC, Inc.
+000EDE     (base 16)		REMEC, Inc.
+				2144 Franklin Drive NE
+				Palm Bay  Florida  32905-4021
+				US
+
+00-0E-9C   (hex)		Benchmark Electronics 
+000E9C     (base 16)		Benchmark Electronics 
+				3535 Technology Drive
+				Rochester  MN  55901
+				US
+
+00-0E-9A   (hex)		BOE TECHNOLOGY GROUP CO.,LTD
+000E9A     (base 16)		BOE TECHNOLOGY GROUP CO.,LTD
+				No.10 Jiuxianqiao Road,Chaoyang District,Beijing,PRC
+				Beijing    100016
+				CN
+
+00-0E-90   (hex)		PONICO CORP.
+000E90     (base 16)		PONICO CORP.
+				602, Ace Twin Tower 1, 212-1 Guro-dong
+				Gurogu  Seoul  152-766
+				KR
+
+00-0E-8A   (hex)		Avara Technologies Pty. Ltd.
+000E8A     (base 16)		Avara Technologies Pty. Ltd.
+				9 Business Park Drive
+				Notting Hill  Victoria  3168
+				AU
+
+00-0E-B8   (hex)		Iiga co.,Ltd
+000EB8     (base 16)		Iiga co.,Ltd
+				3F TKBldg. 3-5-2 Sotokanda
+				Chiyoda-Ku  Tokyo  101-0021
+				JP
+
+00-0E-BE   (hex)		B&B Electronics Manufacturing Co.
+000EBE     (base 16)		B&B Electronics Manufacturing Co.
+				707 Dayton Road
+				Ottawa  Ilinois  61350
+				US
+
+00-0E-BB   (hex)		Everbee Networks
+000EBB     (base 16)		Everbee Networks
+				41, Boulevard des Capucines
+				Paris    75002
+				FR
+
+00-0E-CE   (hex)		S.I.T.T.I. S.p.A.
+000ECE     (base 16)		S.I.T.T.I. S.p.A.
+				Via Cadorna 69
+				Vimodrone  Milan  I-20090
+				IT
+
+00-0E-D4   (hex)		CRESITT INDUSTRIE
+000ED4     (base 16)		CRESITT INDUSTRIE
+				12 rue de Blois
+				Orleans  BP 6744  45067  cedex
+				FR
+
+00-0E-D6   (hex)		Cisco Systems, Inc
+000ED6     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-D8   (hex)		Positron Access Solutions Corp
+000ED8     (base 16)		Positron Access Solutions Corp
+				5101 Buchan Street
+				  Montreal, Quebec  H4P 2R9
+				CA
+
+00-0E-D1   (hex)		Osaka Micro Computer.
+000ED1     (base 16)		Osaka Micro Computer.
+				Isonokamicyo 3-11-7
+				Kishiwada  Osaka  5960001
+				JP
+
+00-0E-B0   (hex)		Solutions Radio BV
+000EB0     (base 16)		Solutions Radio BV
+				Prinsegracht 82
+				The Hague  ZH  2512 GC
+				NL
+
+00-0E-83   (hex)		Cisco Systems, Inc
+000E83     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-81   (hex)		Devicescape Software, Inc.
+000E81     (base 16)		Devicescape Software, Inc.
+				1000 Marina Blvd
+				Brisbane  CA  94005
+				US
+
+00-0E-88   (hex)		VIDEOTRON CORP.
+000E88     (base 16)		VIDEOTRON CORP.
+				17-16,2-CHOME
+				HACHIOJI  TOKYO  193-0835
+				JP
+
+00-0E-86   (hex)		Alcatel North America
+000E86     (base 16)		Alcatel North America
+				2301 Sugar Bush Road
+				Raleigh  NC  27612
+				US
+
+00-0E-69   (hex)		China Electric Power Research Institute
+000E69     (base 16)		China Electric Power Research Institute
+				No.15 Xiaoying East Road,Qinghe,Beijing,China
+				Beijing    100085
+				CN
+
+00-0E-61   (hex)		MICROTROL LIMITED
+000E61     (base 16)		MICROTROL LIMITED
+				16 ELGAR BUSINESS CENTRE
+				HALLOW  WORCESTER  WR2 6NJ
+				GB
+
+00-0E-64   (hex)		Elphel, Inc
+000E64     (base 16)		Elphel, Inc
+				3200 S. Elpmer St.
+				Magna  UT  84044
+				US
+
+00-0E-49   (hex)		Forsway Scandinavia AB
+000E49     (base 16)		Forsway Scandinavia AB
+				Kanikegränd 3B
+				541 34  Skövde  
+				SE
+
+00-0E-42   (hex)		Motic Incoporation Ltd.
+000E42     (base 16)		Motic Incoporation Ltd.
+				Room 2907-8, Windsor  House
+				Hong Kong    
+				CN
+
+00-0E-3D   (hex)		Televic N.V.
+000E3D     (base 16)		Televic N.V.
+				Leo Bekaertlaan 1
+				Izegem    8870
+				BE
+
+00-0E-39   (hex)		Cisco Systems, Inc
+000E39     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0E-34   (hex)		NexGen City, LP
+000E34     (base 16)		NexGen City, LP
+				1680 Glenville
+				Richardson  Texas  75081
+				US
+
+00-0E-6A   (hex)		3Com Ltd
+000E6A     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-0E-5A   (hex)		TELEFIELD inc.
+000E5A     (base 16)		TELEFIELD inc.
+				3F, Kumbo Bldg, 2-9, Seokchon-Dong
+				Seoul    138-190
+				KR
+
+00-0E-5D   (hex)		Triple Play Technologies A/S
+000E5D     (base 16)		Triple Play Technologies A/S
+				Herstedvang 8
+				Albertslund    DK-2620
+				DK
+
+00-0E-52   (hex)		Optium Corporation
+000E52     (base 16)		Optium Corporation
+				500 Horizon Dr
+				Chalfont  PA  18914
+				US
+
+00-0E-7E   (hex)		ionSign Oy
+000E7E     (base 16)		ionSign Oy
+				P.O.BOX  246
+				Rauma    
+				FI
+
+00-0E-77   (hex)		Decru, Inc.
+000E77     (base 16)		Decru, Inc.
+				275 Shoreline Dr
+				Redwood City  CA  94065
+				US
+
+00-0E-4D   (hex)		Numesa Inc.
+000E4D     (base 16)		Numesa Inc.
+				4444 Westgrove Suite 300
+				Addison  TX  75001
+				US
+
+00-0E-4C   (hex)		Bermai Inc.
+000E4C     (base 16)		Bermai Inc.
+				410 Cambridge Ave
+				Palo Alto  CA  94306
+				US
+
+00-0E-2D   (hex)		Hyundai Digital Technology Co.,Ltd.
+000E2D     (base 16)		Hyundai Digital Technology Co.,Ltd.
+				223-22, Sangdaewon-1dong, Jungwon-gu
+				Seongnam-si  Kyoungki-do  462-807
+				KR
+
+00-0E-30   (hex)		AERAS Networks, Inc.
+000E30     (base 16)		AERAS Networks, Inc.
+				P.O. Box 7330
+				Laguna Niguel  CA  92607-7330
+				US
+
+00-0E-29   (hex)		Shester Communications Inc
+000E29     (base 16)		Shester Communications Inc
+				159 S. Lincoln
+				Spokane  WA  99201
+				US
+
+00-0D-E1   (hex)		Control Products, Inc.
+000DE1     (base 16)		Control Products, Inc.
+				1724 Lake Drive West
+				Chanhassen  MN  55317
+				US
+
+00-0D-D0   (hex)		TetraTec Instruments GmbH
+000DD0     (base 16)		TetraTec Instruments GmbH
+				Gewerbestrasse 8
+				Steinenbronn  BW  71144
+				DE
+
+00-0D-D3   (hex)		SAMWOO Telecommunication Co.,Ltd.
+000DD3     (base 16)		SAMWOO Telecommunication Co.,Ltd.
+				
+				Gunpo  Kyoung-Gi  435-831
+				KR
+
+00-0D-D8   (hex)		BBN
+000DD8     (base 16)		BBN
+				7F-3,NO.186, Jian Yi Rd ., Chung Ho City
+				Taipei    235
+				TW
+
+00-0D-B3   (hex)		SDO Communication Corperation
+000DB3     (base 16)		SDO Communication Corperation
+				6F, No.112, Shin Min Street
+				Chung Ho City  Taipei Hsien  235
+				TW
+
+00-0D-AE   (hex)		SAMSUNG HEAVY INDUSTRIES CO., LTD.
+000DAE     (base 16)		SAMSUNG HEAVY INDUSTRIES CO., LTD.
+				493, Banweol-Ri, Taean-Eup
+				Hwaseong-City  Kyeonggi-Do  445-973
+				KR
+
+00-0D-B2   (hex)		Ammasso, Inc.
+000DB2     (base 16)		Ammasso, Inc.
+				345 Summer Street
+				Boston  MA  02210
+				US
+
+00-0E-0D   (hex)		Hesch Schröder GmbH
+000E0D     (base 16)		Hesch Schröder GmbH
+				Boschstraße 8
+				Neustadt  Niedersachsen  31535
+				DE
+
+00-0D-F6   (hex)		Technology Thesaurus Corp.
+000DF6     (base 16)		Technology Thesaurus Corp.
+				NO. 6, East 4th St. KEPZ
+				KAOHSIUNG    806
+				TW
+
+00-0D-FF   (hex)		CHENMING MOLD INDUSTRY CORP.
+000DFF     (base 16)		CHENMING MOLD INDUSTRY CORP.
+				2F No. 26, Lane 513, Rei Kuang Rd.
+				Taipei    114
+				TW
+
+00-0D-C7   (hex)		COSMIC ENGINEERING INC.
+000DC7     (base 16)		COSMIC ENGINEERING INC.
+				1-3-5, Nishihirayama
+				Hino-shi  TOKYO  191-0055
+				JP
+
+00-0D-C2   (hex)		Private
+000DC2     (base 16)		Private
+
+00-0D-BF   (hex)		TekTone Sound & Signal Mfg., Inc.
+000DBF     (base 16)		TekTone Sound & Signal Mfg., Inc.
+				277 Industrial Park Rd.
+				Franklin  NC  28734
+				US
+
+00-0E-19   (hex)		LogicaCMG Pty Ltd
+000E19     (base 16)		LogicaCMG Pty Ltd
+				17-19 Orion Road
+				Lane Cove  NSW  2066
+				AU
+
+00-0E-1A   (hex)		JPS Communications
+000E1A     (base 16)		JPS Communications
+				5800 Departure Drive
+				Raleigh  NC  27616
+				US
+
+00-0E-06   (hex)		Team Simoco Ltd
+000E06     (base 16)		Team Simoco Ltd
+				Field House
+				Derby  Derbyshire  DE1 1NH
+				GB
+
+00-0D-5C   (hex)		Robert Bosch GmbH, VT-ATMO
+000D5C     (base 16)		Robert Bosch GmbH, VT-ATMO
+				Wernerstrasse 51
+				Stuttgart  BW  70469
+				DE
+
+00-0D-60   (hex)		IBM Corp
+000D60     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-0D-67   (hex)		Ericsson
+000D67     (base 16)		Ericsson
+				349 Terry Fox Drive
+				Kanata  Ottawa  K2K 2V6
+				CA
+
+00-0D-5F   (hex)		Minds Inc
+000D5F     (base 16)		Minds Inc
+				1919 boul lionel bertrand
+				Boisbriand  Quebec  J7H 1N8
+				CA
+
+00-0D-9C   (hex)		Elan GmbH & Co KG
+000D9C     (base 16)		Elan GmbH & Co KG
+				Im Ostpark 2
+				Wettenberg  Hessen  35435
+				DE
+
+00-0D-98   (hex)		S.W.A.C. Schmitt-Walter Automation Consult GmbH
+000D98     (base 16)		S.W.A.C. Schmitt-Walter Automation Consult GmbH
+				Oedenpullach 1
+				Oberhaching  Bavaria  82041
+				DE
+
+00-0D-8C   (hex)		Shanghai Wedone Digital Ltd. CO.
+000D8C     (base 16)		Shanghai Wedone Digital Ltd. CO.
+				893-899 Huashan Road,
+				Shanghai    200031
+				CN
+
+00-0D-94   (hex)		AFAR Communications,Inc
+000D94     (base 16)		AFAR Communications,Inc
+				81 David Love Place
+				Santa Barbara  CA  93117
+				US
+
+00-0D-AA   (hex)		S.A.Tehnology co.,Ltd.
+000DAA     (base 16)		S.A.Tehnology co.,Ltd.
+				80-12 Yangjae 1 Dong
+				Seoul  South Korea  137-890
+				KR
+
+00-0D-A6   (hex)		Universal Switching Corporation
+000DA6     (base 16)		Universal Switching Corporation
+				7671 San Fernando Rd
+				Burbank  CA  91505-1073
+				US
+
+00-0D-8D   (hex)		Prosoft Technology, Inc
+000D8D     (base 16)		Prosoft Technology, Inc
+				5201 Truxtun Ave
+				Bakersfield  CA  93300
+				US
+
+00-0D-84   (hex)		Makus Inc.
+000D84     (base 16)		Makus Inc.
+				4F Daedo Bldg., 748-14 Yeoksam-dong
+				Kangnam-gu  Seoul  135-080
+				KR
+
+00-0D-73   (hex)		Technical Support, Inc.
+000D73     (base 16)		Technical Support, Inc.
+				11253 John Galt Blvd
+				Omaha  Nebraska  68137
+				US
+
+00-0D-69   (hex)		TMT&D Corporation
+000D69     (base 16)		TMT&D Corporation
+				2-24-1
+				Fuchu-si  Tokyo  183-0057
+				JP
+
+00-0D-A2   (hex)		Infrant Technologies, Inc.
+000DA2     (base 16)		Infrant Technologies, Inc.
+				48820 Kato Road
+				Fremont  CA  94538
+				US
+
+00-0D-68   (hex)		Vinci Systems, Inc.
+000D68     (base 16)		Vinci Systems, Inc.
+				8330 Boone Boulevard
+				Vienna  VA  22182
+				US
+
+00-0D-64   (hex)		COMAG Handels AG
+000D64     (base 16)		COMAG Handels AG
+				Zillenhardtstraße 41
+				Goeppingen  Baden-Württemberg  73037
+				DE
+
+00-0D-74   (hex)		Sand Network Systems, Inc.
+000D74     (base 16)		Sand Network Systems, Inc.
+				434 Payran Street, Suite B
+				Petaluma  CA  94952
+				US
+
+00-0D-7D   (hex)		Afco Systems
+000D7D     (base 16)		Afco Systems
+				200 Finn Court
+				Farmingdale  NY  11735
+				US
+
+00-0D-54   (hex)		3Com Ltd
+000D54     (base 16)		3Com Ltd
+				Peoplebuilding 2
+				Hemel Hempstead  Herts  HP2 4NW
+				GB
+
+00-0D-4C   (hex)		Outline Electronics Ltd.
+000D4C     (base 16)		Outline Electronics Ltd.
+				7/F Benson Tower
+				Kwun Tong  Kowloon  
+				HK
+
+00-0D-0F   (hex)		Finlux Ltd
+000D0F     (base 16)		Finlux Ltd
+				Radiomiehenkatu 3
+				Turku    FIN-20321
+				FI
+
+00-0D-12   (hex)		AXELL Corporation
+000D12     (base 16)		AXELL Corporation
+				Akihabara UDX South Wing 10F
+				Chiyoda-ku  Tokyo  101-8973
+				JP
+
+00-0D-34   (hex)		Shell International Exploration and Production, Inc.
+000D34     (base 16)		Shell International Exploration and Production, Inc.
+				BTC-Gasmer
+				Houston  TX  77001
+				US
+
+00-0D-32   (hex)		DispenseSource, Inc.
+000D32     (base 16)		DispenseSource, Inc.
+				29801 Santa Margarita Parkway
+				Rancho Santa Margarita  CA  92688
+				US
+
+00-0C-F6   (hex)		Sitecom Europe BV
+000CF6     (base 16)		Sitecom Europe BV
+				Sevillaweg 122
+				Rotterdam  ZH  3047 AL
+				NL
+
+00-0C-F2   (hex)		GAMESA Eólica
+000CF2     (base 16)		GAMESA Eólica
+				Polígono Agustinos. C/ A s/n.
+				Pamplona  NAVARRA  31013
+				ES
+
+00-0D-2E   (hex)		Matsushita Avionics Systems Corporation
+000D2E     (base 16)		Matsushita Avionics Systems Corporation
+				26200 Enterprise Way
+				Lake Forest  CA  92630
+				US
+
+00-0D-28   (hex)		Cisco Systems, Inc
+000D28     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0D-4D   (hex)		Ninelanes
+000D4D     (base 16)		Ninelanes
+				#405 4F Diplomatic Center
+				Seoul    1376-1
+				KR
+
+00-0D-53   (hex)		Beijing 5w Communication Corp.
+000D53     (base 16)		Beijing 5w Communication Corp.
+				NO.4,Zhong-Guan-Cun South 4 street,
+				Beijing    100080
+				CN
+
+00-0C-FC   (hex)		S2io Technologies Corp
+000CFC     (base 16)		S2io Technologies Corp
+				505 March Rd
+				Ottawa  Ontario  K2K 2M5
+				CA
+
+00-0D-38   (hex)		NISSIN INC.
+000D38     (base 16)		NISSIN INC.
+				10-7 KAMEI-CHO
+				TAKARAZUKA  HYOGO  665-0047
+				JP
+
+00-0D-15   (hex)		Voipac s.r.o.
+000D15     (base 16)		Voipac s.r.o.
+				Ul. Janka Krala 3
+				Trencin    911 01
+				SK
+
+00-0C-A1   (hex)		SIGMACOM Co., LTD.
+000CA1     (base 16)		SIGMACOM Co., LTD.
+				DacomBldg 7F 200-12 Anyang-dong
+				    430-817
+				KR
+
+00-0C-A6   (hex)		Mintera Corporation
+000CA6     (base 16)		Mintera Corporation
+				847 Rogers Street
+				Lowell  MA  01852
+				US
+
+00-0C-C1   (hex)		Eaton Corporation
+000CC1     (base 16)		Eaton Corporation
+				2300 Badger Drive
+				Waukesha  WI  53188
+				US
+
+00-0C-8B   (hex)		Connect Tech Inc
+000C8B     (base 16)		Connect Tech Inc
+				42 Arrow Road
+				Guelph  Ontario  N1K 1S6
+				CA
+
+00-0C-90   (hex)		Octasic Inc.
+000C90     (base 16)		Octasic Inc.
+				4101 Molson St.
+				Montreal  Quebec  H1Y 3L1
+				CA
+
+00-0C-8C   (hex)		KODICOM CO.,LTD.
+000C8C     (base 16)		KODICOM CO.,LTD.
+				A-Dong 5FI.,SK Twin Tower 345-9,
+				Seoul    153-023
+				KR
+
+00-0C-C2   (hex)		ControlNet (India) Private Limited
+000CC2     (base 16)		ControlNet (India) Private Limited
+				L-44, Unit - I
+				Verna, Salcete  Goa  403 722
+				IN
+
+00-0C-94   (hex)		United Electronic Industries, Inc. (EUI)
+000C94     (base 16)		United Electronic Industries, Inc. (EUI)
+				27 Renmar Ave
+				Walpole  MA  02081
+				US
+
+00-0C-9B   (hex)		EE Solutions, Inc
+000C9B     (base 16)		EE Solutions, Inc
+				8F, No. 9, Park II Ave., Science-Based I
+				Hsin Chu    300
+				TW
+
+00-0C-E1   (hex)		The Open Group
+000CE1     (base 16)		The Open Group
+				Apex Plaza
+				Reading  Berks  RG1 1AX
+				GB
+
+00-0C-DC   (hex)		BECS Technology, Inc
+000CDC     (base 16)		BECS Technology, Inc
+				9487 Dielman Rock Island Industrial Driv
+				St. Louis  MO  63132
+				US
+
+00-0C-C5   (hex)		Nextlink Co., Ltd.
+000CC5     (base 16)		Nextlink Co., Ltd.
+				C 605, Technopark #145 Yatop-dong,
+				Seongnam-si  Bundang-gu, Gyeonggi  463-760
+				KR
+
+00-0C-DE   (hex)		ABB STOTZ-KONTAKT GmbH
+000CDE     (base 16)		ABB STOTZ-KONTAKT GmbH
+				Eppelheimer Straße 82
+				Heidelberg  Baden-Württemberg  69123
+				DE
+
+00-0C-BF   (hex)		Holy Stone Ent. Co., Ltd.
+000CBF     (base 16)		Holy Stone Ent. Co., Ltd.
+				1F, No.62, Sec.2, Huang Shan Rd.,
+				Taipei    114
+				US
+
+00-0C-4D   (hex)		Curtiss-Wright Controls Avionics & Electronics
+000C4D     (base 16)		Curtiss-Wright Controls Avionics & Electronics
+				Landscape House,
+				Churchtown,  Dublin  14
+				IE
+
+00-0C-44   (hex)		Automated Interfaces, Inc.
+000C44     (base 16)		Automated Interfaces, Inc.
+				120 Confederate Lane
+				Greer  South Carolina  29651
+				US
+
+00-0C-3B   (hex)		Orion Electric Co., Ltd.
+000C3B     (base 16)		Orion Electric Co., Ltd.
+				41-1, Iehisa-cho
+				Takefu-shi  Fukui  915-8555
+				JP
+
+00-0C-71   (hex)		Wybron, Inc
+000C71     (base 16)		Wybron, Inc
+				4830 LIst Dr
+				Colorado Springs  Colorado  80919
+				US
+
+00-0C-72   (hex)		Tempearl Industrial Co., Ltd.
+000C72     (base 16)		Tempearl Industrial Co., Ltd.
+				3-1-42 Ohzu
+				Hiroshima-shi  Hiroshima  732-0802
+				JP
+
+00-0C-78   (hex)		In-Tech Electronics Limited
+000C78     (base 16)		In-Tech Electronics Limited
+				Unit A, 13th Floor., Wing Tai Centre
+				Kwun Tong  Kowloon  
+				HK
+
+00-0C-59   (hex)		Indyme Electronics, Inc.
+000C59     (base 16)		Indyme Electronics, Inc.
+				9085 Aero Dr.
+				San Diego  CA  92123
+				US
+
+00-0C-5C   (hex)		GTN Systems B.V.
+000C5C     (base 16)		GTN Systems B.V.
+				Postbus 12236
+				Amsterdam    
+				NL
+
+00-0C-55   (hex)		Microlink Communications Inc.
+000C55     (base 16)		Microlink Communications Inc.
+				8F, 31, Hsintai Road
+				Hsinchu    302
+				TW
+
+00-0C-52   (hex)		Roll Systems Inc.
+000C52     (base 16)		Roll Systems Inc.
+				53 Third Avenue
+				Burlington  MA  01803
+				US
+
+00-0C-74   (hex)		RIVERTEC CORPORATION
+000C74     (base 16)		RIVERTEC CORPORATION
+				882-5 MIYAGASAKI
+				IMABARI  EHIME  799-1537
+				JP
+
+00-0C-67   (hex)		OYO ELECTRIC CO.,LTD
+000C67     (base 16)		OYO ELECTRIC CO.,LTD
+				63-1 Nakamichi Omote
+				Joyo  Kyoto  610-0101
+				JP
+
+00-0C-2E   (hex)		Openet information technology(shenzhen) Co., Ltd.
+000C2E     (base 16)		Openet information technology(shenzhen) Co., Ltd.
+				2/F,A tower,international tech-innovatio
+				shenzhen  guangdong  518057
+				CN
+
+00-0C-2C   (hex)		Enwiser Inc.
+000C2C     (base 16)		Enwiser Inc.
+				4F, Cheongseok B/D
+				Seoul  Seoul  135-010
+				KR
+
+00-0C-28   (hex)		RIFATRON
+000C28     (base 16)		RIFATRON
+				9th FL, SHINTAEYANG BLDG
+				SEOUL  SEOCHO-GU  137-041
+				KR
+
+00-0C-3D   (hex)		Glsystech Co., Ltd.
+000C3D     (base 16)		Glsystech Co., Ltd.
+				Song Bo B/D 3F
+				Seoul    
+				KR
+
+00-0C-2F   (hex)		SeorimTechnology Co.,Ltd.
+000C2F     (base 16)		SeorimTechnology Co.,Ltd.
+				2F DIPLOMATIC CENTER B/D 1376-1 SEOCHO2-
+				SEOUL    137-072
+				US
+
+00-0C-31   (hex)		Cisco Systems, Inc
+000C31     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0C-53   (hex)		Private
+000C53     (base 16)		Private
+
+00-0C-48   (hex)		QoStek Corporation
+000C48     (base 16)		QoStek Corporation
+				7F, 22, Taiyuen Street
+				Chupei  Hsinchu Hsien  302
+				TW
+
+00-0C-63   (hex)		Zenith Electronics Corporation
+000C63     (base 16)		Zenith Electronics Corporation
+				2000 Millbrook Drive
+				Lincolnshire  Illinois  60069
+				US
+
+00-0B-BB   (hex)		Etin Systems Co., Ltd
+000BBB     (base 16)		Etin Systems Co., Ltd
+				12F, IT Venture Tower,
+				Seoul    138-803
+				KR
+
+00-0B-BC   (hex)		En Garde Systems, Inc.
+000BBC     (base 16)		En Garde Systems, Inc.
+				2101 White Cloud St. NE
+				Albuquerque  NM  87112
+				US
+
+00-0B-B1   (hex)		Super Star Technology Co., Ltd.
+000BB1     (base 16)		Super Star Technology Co., Ltd.
+				No. 7 Lane 306,Sec. 2,Tai-Lin Rd.
+				Taipei Hsien    243
+				US
+
+00-0B-BF   (hex)		Cisco Systems, Inc
+000BBF     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-AD   (hex)		PC-PoS Inc.
+000BAD     (base 16)		PC-PoS Inc.
+				309 Commissioners Road West
+				London  Ontario  N6J 1Y4
+				CA
+
+00-0B-A0   (hex)		T&L Information Inc.
+000BA0     (base 16)		T&L Information Inc.
+				898-44 Hokye-Dong, Dongan-Gu
+				Anyang  Kyungki-Do  431-836
+				KR
+
+00-0C-17   (hex)		AJA Video Systems Inc
+000C17     (base 16)		AJA Video Systems Inc
+				180 Litton Drive
+				Grass Valley  CA  95945
+				US
+
+00-0C-11   (hex)		NIPPON DEMPA CO.,LTD.
+000C11     (base 16)		NIPPON DEMPA CO.,LTD.
+				1-4-8
+				kakegawa city  shizuoka pref.  436-0028
+				JP
+
+00-0C-14   (hex)		Diagnostic Instruments, Inc.
+000C14     (base 16)		Diagnostic Instruments, Inc.
+				6540 Burroughs
+				Sterling Heights  MI  48314
+				US
+
+00-0B-B5   (hex)		nStor Technologies, Inc.
+000BB5     (base 16)		nStor Technologies, Inc.
+				100 Technology Park
+				Lake Mary  FL  32746
+				US
+
+00-0B-B9   (hex)		Imsys AB
+000BB9     (base 16)		Imsys AB
+				Johanneslundsvagen 3
+				Upplands Vasby    SE-19461
+				SE
+
+00-0C-21   (hex)		Faculty of Science and Technology, Keio University
+000C21     (base 16)		Faculty of Science and Technology, Keio University
+				3-14-1 Hiyoshi, Kohoku-ku
+				Yokohama  Kanagawa  223-8522
+				JP
+
+00-0C-1B   (hex)		ORACOM Co, Ltd.
+000C1B     (base 16)		ORACOM Co, Ltd.
+				3rd Fl, A-Sung Bldg, 999-3
+				Seoul    135-280
+				KR
+
+00-0B-C9   (hex)		Electroline Equipment
+000BC9     (base 16)		Electroline Equipment
+				8265 boul. St-Michel
+				Montreal  Quebec  H1Z 3E4
+				CA
+
+00-0B-C2   (hex)		Corinex Communication Corp.
+000BC2     (base 16)		Corinex Communication Corp.
+				#308 1168 Hamilton Street
+				Vancouver  B.C.  V6B 2S2
+				US
+
+00-0B-F7   (hex)		NIDEK CO.,LTD
+000BF7     (base 16)		NIDEK CO.,LTD
+				34-14 Maehama
+				Gamagori  Aich  443-0038
+				JP
+
+00-0C-00   (hex)		BEB Industrie-Elektronik AG
+000C00     (base 16)		BEB Industrie-Elektronik AG
+				Progressastrasse 31
+				Oberburg  BE  3414
+				CH
+
+00-0B-F3   (hex)		BAE SYSTEMS
+000BF3     (base 16)		BAE SYSTEMS
+				6500 Tracor Lane
+				Austin  Texas  78725
+				US
+
+00-0B-ED   (hex)		ELM Inc.
+000BED     (base 16)		ELM Inc.
+				2398 Kasedamiyahara
+				Minamisatsuma  Kagoshima  897-1124
+				JP
+
+00-0B-91   (hex)		Aglaia Gesellschaft für Bildverarbeitung und Kommunikation mbH
+000B91     (base 16)		Aglaia Gesellschaft für Bildverarbeitung und Kommunikation mbH
+				Tiniusstraße 12-15
+				Berlin    D-13089
+				DE
+
+00-0B-97   (hex)		Matsushita Electric Industrial Co.,Ltd.
+000B97     (base 16)		Matsushita Electric Industrial Co.,Ltd.
+				3-1-1 Yagumo-Naka-Machi
+				Moriguchi City  Osaka  570-8501
+				JP
+
+00-0B-92   (hex)		Ascom Danmark A/S
+000B92     (base 16)		Ascom Danmark A/S
+				Fabriksparken 42
+				Glostrup  Denmark  2600
+				DK
+
+00-0B-9A   (hex)		Shanghai Ulink Telecom Equipment Co. Ltd.
+000B9A     (base 16)		Shanghai Ulink Telecom Equipment Co. Ltd.
+				6 Floor, Building 3
+				Shanghai    200083
+				CN
+
+00-0B-9D   (hex)		TwinMOS Technologies Inc.
+000B9D     (base 16)		TwinMOS Technologies Inc.
+				303 No.3, Tzu Chiang Rd., Hu Kou Xiang,
+				Hsin Chu    303
+				TW
+
+00-0B-96   (hex)		Innotrac Diagnostics Oy
+000B96     (base 16)		Innotrac Diagnostics Oy
+				Kalevantie 25
+				Turku  Åbo  20520
+				FI
+
+00-0B-56   (hex)		Cybernetics
+000B56     (base 16)		Cybernetics
+				111 Cybernetics Way STE 300
+				Yorktown  VA  23693
+				US
+
+00-0B-50   (hex)		Oxygnet
+000B50     (base 16)		Oxygnet
+				402 E. Carrillo St.
+				Santa Barbara  CA  93101
+				US
+
+00-0B-52   (hex)		JOYMAX ELECTRONICS CO. LTD.
+000B52     (base 16)		JOYMAX ELECTRONICS CO. LTD.
+				No.5 Dong-Yuan Road 2, Jhong-Li Industrial Park,
+				Tao-Yuan    32063
+				TW
+
+00-0B-69   (hex)		Franke Finland Oy
+000B69     (base 16)		Franke Finland Oy
+				Vartiokuja 1
+				NAARAJARVI    FIN-76850
+				FI
+
+00-0B-A5   (hex)		Quasar Cipta Mandiri, PT
+000BA5     (base 16)		Quasar Cipta Mandiri, PT
+				Jl. Palasari 9A
+				Bandung  West Java  40262
+				ID
+
+00-0B-49   (hex)		RF-Link System Inc.
+000B49     (base 16)		RF-Link System Inc.
+				No.6, Nan-Ke 5th Rd., Hsin-Shi,
+				Tainan County    744
+				TW
+
+00-0B-46   (hex)		Cisco Systems, Inc
+000B46     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0B-7A   (hex)		L-3 Linkabit
+000B7A     (base 16)		L-3 Linkabit
+				9890 Town Center Drive
+				San Diego  CA  92121
+				US
+
+00-0B-84   (hex)		BODET
+000B84     (base 16)		BODET
+				Route de la Tourlandry
+				TREMENTINES  FRANCE  49340
+				FR
+
+00-0B-77   (hex)		Cogent Systems, Inc.
+000B77     (base 16)		Cogent Systems, Inc.
+				209 Fair Oaks Ave.
+				South Pasadena  CA  91030
+				US
+
+00-0B-66   (hex)		Teralink Communications
+000B66     (base 16)		Teralink Communications
+				Capital Tower 15F,
+				Daejeon    302120
+				KR
+
+00-0B-2C   (hex)		Eiki Industrial Co. Ltd.
+000B2C     (base 16)		Eiki Industrial Co. Ltd.
+				4-12 Manzai-cho, Kita-ku
+				Osaka    530
+				JP
+
+00-0B-26   (hex)		Wetek Corporation
+000B26     (base 16)		Wetek Corporation
+				4F, NO.17, Kuanfu N. Road
+				Hsin Chu Industrial Park    303
+				TW
+
+00-0B-28   (hex)		Quatech Inc.
+000B28     (base 16)		Quatech Inc.
+				662 Wolf Ledges Pkwy.
+				Akron  OH  44311
+				US
+
+00-0B-2A   (hex)		HOWTEL Co., Ltd.
+000B2A     (base 16)		HOWTEL Co., Ltd.
+				J-COM Bd. 4F, 124-4 OJEON-DONG
+				UIWANG-SHI  KYOUNGGI-DO  437-070
+				KR
+
+00-0B-30   (hex)		Beijing Gongye Science & Technology Co.,Ltd
+000B30     (base 16)		Beijing Gongye Science & Technology Co.,Ltd
+				Unit D.17/E,Shenlanhuating mid Road No.6
+				Beijing    100029
+				CN
+
+00-0A-F2   (hex)		NeoAxiom Corp.
+000AF2     (base 16)		NeoAxiom Corp.
+				1520 Montague Expressway
+				San Jose  CA  95131
+				US
+
+00-0A-F5   (hex)		Airgo Networks, Inc.
+000AF5     (base 16)		Airgo Networks, Inc.
+				900 Arastradero Rd
+				Palo Alto  CA  94304
+				US
+
+00-0A-F0   (hex)		SHIN-OH ELECTRONICS CO., LTD. R&D
+000AF0     (base 16)		SHIN-OH ELECTRONICS CO., LTD. R&D
+				#729-5, Bonoh-Dong, Ansan-City, Kyunggi-
+				Ansan-City  Kyunggi-Do  425-180
+				KR
+
+00-0A-F4   (hex)		Cisco Systems, Inc
+000AF4     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-EE   (hex)		GCD Hard- & Software GmbH
+000AEE     (base 16)		GCD Hard- & Software GmbH
+				Henkestraße 79
+				Erlangen  Bayern  91052
+				DE
+
+00-0A-D8   (hex)		IPCserv Technology Corp.
+000AD8     (base 16)		IPCserv Technology Corp.
+				6f,No.107,Pan-Hsin Rd
+				Pan-Chiao  Taipei  22046
+				TW
+
+00-0A-D7   (hex)		Origin ELECTRIC CO.,LTD.
+000AD7     (base 16)		Origin ELECTRIC CO.,LTD.
+				1-18-1
+				TOSHIMA WARD  TOKYO MET.  171-8555
+				JP
+
+00-0B-38   (hex)		Knürr GmbH
+000B38     (base 16)		Knürr GmbH
+				Mariakirchener Straße 38
+				Arnstorf  Bavaria  94424
+				DE
+
+00-0B-32   (hex)		VORMETRIC, INC.
+000B32     (base 16)		VORMETRIC, INC.
+				2060 CORPORATE CT
+				SAN JOSE  CA  95131
+				US
+
+00-0B-07   (hex)		Voxpath Networks
+000B07     (base 16)		Voxpath Networks
+				7600B Capital of Texas Highway  - North
+				Austin  Texas  78731
+				US
+
+00-0B-04   (hex)		Volktek Corporation
+000B04     (base 16)		Volktek Corporation
+				4F., No.192, Lian-Chang Road, Chang-Ho
+				Taipei    
+				TW
+
+00-0A-F9   (hex)		HiConnect, Inc.
+000AF9     (base 16)		HiConnect, Inc.
+				Rm #906, Haksan Cosmostel, 110
+				Kwangjin-Gu  Seoul  143-802
+				KR
+
+00-0B-1F   (hex)		I CON Computer Co.
+000B1F     (base 16)		I CON Computer Co.
+				3F, No. 142 , Hsin Ming Road
+				Neihu  Taipei  114
+				TW
+
+00-0B-13   (hex)		ZETRON INC
+000B13     (base 16)		ZETRON INC
+				PO Box 97004
+				REDMOND  WA  98073
+				US
+
+00-0B-10   (hex)		11wave Technonlogy Co.,Ltd
+000B10     (base 16)		11wave Technonlogy Co.,Ltd
+				10F,no.285 sec.2 ,Ti-Ding Ave,NaiHu.Taip
+				Taipei    114
+				TW
+
+00-0A-E9   (hex)		AirVast Technology Inc.
+000AE9     (base 16)		AirVast Technology Inc.
+				3F.-5, No.6, Lane 609, Sec. 5, Chongsin Rd.
+				Sanchong City  Taipei  241
+				TW
+
+00-0B-2B   (hex)		HOSTNET CORPORATION
+000B2B     (base 16)		HOSTNET CORPORATION
+				10F-12,No. 12 Lane 609, Sec.5,Chunghsin
+				Sanchung  Taipei Hsien  241
+				TW
+
+00-0B-02   (hex)		Dallmeier electronic
+000B02     (base 16)		Dallmeier electronic
+				Würzburgerstraße 5
+				Regensburg  Bavaria  93059
+				DE
+
+00-0A-CD   (hex)		Sunrich Technology Limited
+000ACD     (base 16)		Sunrich Technology Limited
+				Unit 1301, Eastern Centre, 1065 King's R
+				Quarry Bay    
+				HK
+
+00-0A-CC   (hex)		Winnow Networks, Inc.
+000ACC     (base 16)		Winnow Networks, Inc.
+				701 Emerson Road
+				St. Louis  MO  63141
+				US
+
+00-0A-CF   (hex)		PROVIDEO Multimedia Co. Ltd.
+000ACF     (base 16)		PROVIDEO Multimedia Co. Ltd.
+				5F, NO.8, ALLEY 2, TZU-WEI LANE,
+				HSIN TIEN CITY  TAIPEI HSIEN,  231
+				TW
+
+00-0A-D1   (hex)		MWS
+000AD1     (base 16)		MWS
+				12, quai Papacino
+				NICE    06300
+				FR
+
+00-0A-7D   (hex)		Valo, Inc.
+000A7D     (base 16)		Valo, Inc.
+				1351 Redwood Way
+				Petaluma  CA  94954
+				US
+
+00-0A-7F   (hex)		Teradon Industries, Inc
+000A7F     (base 16)		Teradon Industries, Inc
+				7500 2nd ST NW
+				Albuquerque  NM  87120
+				US
+
+00-0A-81   (hex)		TEIMA Audiotex S.L.
+000A81     (base 16)		TEIMA Audiotex S.L.
+				C/ Tirvia, 6, local B
+				Madrid    28040
+				ES
+
+00-0A-87   (hex)		Integrated Micromachines Inc.
+000A87     (base 16)		Integrated Micromachines Inc.
+				1400 S. Shamrock Ave.
+				Monrovia  CA  91016
+				US
+
+00-0A-77   (hex)		Bluewire Technologies LLC
+000A77     (base 16)		Bluewire Technologies LLC
+				420 N. O St.
+				Tulare  Ca  93274
+				US
+
+00-0A-8C   (hex)		Guardware Systems Ltd.
+000A8C     (base 16)		Guardware Systems Ltd.
+				Ulloi ut 102.
+				Budapest    H-1089
+				HU
+
+00-0A-96   (hex)		MEWTEL TECHNOLOGY INC.
+000A96     (base 16)		MEWTEL TECHNOLOGY INC.
+				E15FL. IT VENTURE TOWER
+				SEOUL    138-803
+				KR
+
+00-0A-82   (hex)		TATSUTA SYSTEM ELECTRONICS CO.,LTD.
+000A82     (base 16)		TATSUTA SYSTEM ELECTRONICS CO.,LTD.
+				IWATATYOU2-3-1
+				HIGASHIOOSAKA-SHI  OOSAKA-FU  578-8585
+				JP
+
+00-0A-D3   (hex)		INITECH Co., Ltd
+000AD3     (base 16)		INITECH Co., Ltd
+				3F, INITECH Bldg, 559-5,
+				Seoul  Songpa  138-816
+				KR
+
+00-0A-C8   (hex)		ZPSYS CO.,LTD. (Planning&Management)
+000AC8     (base 16)		ZPSYS CO.,LTD. (Planning&Management)
+				106 Ace Techno Tower1
+				Seoul    152-050
+				KR
+
+00-0A-C6   (hex)		Overture Networks.
+000AC6     (base 16)		Overture Networks.
+				637 Davis Drive
+				Morrisville  NC  27560
+				US
+
+00-0A-AB   (hex)		Toyota Technical Development Corporation
+000AAB     (base 16)		Toyota Technical Development Corporation
+				1-9, Imae, Hanamoto-cho
+				Toyota  Aichi  470-0334
+				JP
+
+00-0A-B4   (hex)		ETIC Telecommunications
+000AB4     (base 16)		ETIC Telecommunications
+				13, chemin du vieux-chene ZIRST
+				MEYLAN  Isere  38240
+				FR
+
+00-0A-7A   (hex)		Kyoritsu Electric Co., Ltd.
+000A7A     (base 16)		Kyoritsu Electric Co., Ltd.
+				2-3-17
+				Komae-shi  Tokyo  201-0005
+				JP
+
+00-0A-9C   (hex)		Server Technology, Inc.
+000A9C     (base 16)		Server Technology, Inc.
+				1040 Sandhill Drive
+				Reno  Nevada  89521
+				US
+
+00-0A-75   (hex)		Caterpillar, Inc
+000A75     (base 16)		Caterpillar, Inc
+				Mailstop Location AC6130
+				Mossville  IL  61552-0610
+				US
+
+00-0A-12   (hex)		Azylex Technology, Inc
+000A12     (base 16)		Azylex Technology, Inc
+				7-2Fl., No. 738 Chung Cheng Road,
+				Chung Ho City  Taipei  235
+				TW
+
+00-0A-13   (hex)		Honeywell Video Systems
+000A13     (base 16)		Honeywell Video Systems
+				6554 176 Street
+				Surrey  BC  V3S 4G5
+				CA
+
+00-0A-09   (hex)		TaraCom Integrated Products, Inc.
+000A09     (base 16)		TaraCom Integrated Products, Inc.
+				830 Stewart Dr.
+				Sunnyvale  CA  94085
+				US
+
+00-0A-41   (hex)		Cisco Systems, Inc
+000A41     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-36   (hex)		Synelec Telecom Multimedia
+000A36     (base 16)		Synelec Telecom Multimedia
+				Zone Industrielle
+				Saint Sernin sur Rance  Aveyron  F-12380
+				FR
+
+00-0A-48   (hex)		Albatron Technology
+000A48     (base 16)		Albatron Technology
+				6F, No 716, Chung Cheng,
+				Chung-Ho City  Taipei Hsien  
+				TW
+
+00-0A-3E   (hex)		EADS Telecom
+000A3E     (base 16)		EADS Telecom
+				Landshuter Strasse 26
+				Munich  Bavaria  85716
+				DE
+
+00-0A-59   (hex)		HW server
+000A59     (base 16)		HW server
+				Italska 15
+				Prague 2  Czech Republic  120 00
+				KM
+
+00-0A-54   (hex)		Laguna Hills, Inc.
+000A54     (base 16)		Laguna Hills, Inc.
+				3-5-2
+				Chiyoda-ku  Tokyo  102-0083
+				JP
+
+00-0A-4F   (hex)		Brain Boxes Limited
+000A4F     (base 16)		Brain Boxes Limited
+				Unit 3c, Wavertree Boulevard South
+				Liverpool  Merseyside  L7 9PF
+				GB
+
+00-0A-52   (hex)		AsiaRF Ltd.
+000A52     (base 16)		AsiaRF Ltd.
+				3F, No.176, Yongzhen Road
+				New Taipei City  Taipei  234
+				TW
+
+00-0A-02   (hex)		ANNSO CO., LTD.
+000A02     (base 16)		ANNSO CO., LTD.
+				5F, No. 100, Min-Chuan Road, Shing-Tien
+				Shing-Tien City Taipei Hsien  Taiwan  221
+				TW
+
+00-0A-65   (hex)		GentechMedia.co.,ltd.
+000A65     (base 16)		GentechMedia.co.,ltd.
+				solvit bldg 2f, 402-8, yangjae-don,
+				seocho-gu,  seoul  137-899
+				KR
+
+00-0A-22   (hex)		Amperion Inc
+000A22     (base 16)		Amperion Inc
+				250 Apollo Drive
+				Chelmsford  MA  01824
+				US
+
+00-0A-1C   (hex)		Bridge Information Co., Ltd.
+000A1C     (base 16)		Bridge Information Co., Ltd.
+				No.3, Lane 106, Wu-Kung 2 Rd.,
+				Taipei    248
+				TW
+
+00-0A-32   (hex)		Xsido Corporation
+000A32     (base 16)		Xsido Corporation
+				3F,2-8-13,Shiba-Daimon,
+				Tokyo    105-0012
+				JP
+
+00-0A-2B   (hex)		Etherstuff
+000A2B     (base 16)		Etherstuff
+				208 W. Mimosa Circle
+				San Marcos  TX  78666
+				US
+
+00-0A-42   (hex)		Cisco Systems, Inc
+000A42     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-0A-38   (hex)		Apani Networks
+000A38     (base 16)		Apani Networks
+				1800 E. Imperial Hwy
+				Brea  CA  92821
+				US
+
+00-09-A8   (hex)		Eastmode Pte Ltd
+0009A8     (base 16)		Eastmode Pte Ltd
+				30 Loyang Way #07-06
+				    508769
+				SG
+
+00-09-AA   (hex)		Data Comm for Business, Inc.
+0009AA     (base 16)		Data Comm for Business, Inc.
+				2949 County Road 1000 East
+				Dewey  IL  61853
+				US
+
+00-09-A4   (hex)		HARTEC Corporation
+0009A4     (base 16)		HARTEC Corporation
+				KOUHOKUKU SHIN-YOKOHAMA
+				YOKOHAMA-SHI  KANAGAWA-KEN  222-0033
+				JP
+
+00-09-A6   (hex)		Ignis Optics, Inc.
+0009A6     (base 16)		Ignis Optics, Inc.
+				482 W. San Carlos
+				San Jose  California  95110
+				US
+
+00-09-A7   (hex)		Bang & Olufsen A/S
+0009A7     (base 16)		Bang & Olufsen A/S
+				Peter Bangs Vej 15
+				Struer    7600
+				DK
+
+00-09-C8   (hex)		SINAGAWA TSUSHIN KEISOU SERVICE
+0009C8     (base 16)		SINAGAWA TSUSHIN KEISOU SERVICE
+				13-5 Fuke , Sumiyoshi , Onahama
+				Iwaki City  Fukushima Prefecture  971-8124
+				JP
+
+00-09-B7   (hex)		Cisco Systems, Inc
+0009B7     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-B2   (hex)		L&F Inc.
+0009B2     (base 16)		L&F Inc.
+				4-2-9
+				ITABASHI-KU  Tokyo  175-0083
+				JP
+
+00-09-F3   (hex)		WELL Communication Corp.
+0009F3     (base 16)		WELL Communication Corp.
+				11F, No.778, Chung Cheng Rd., Chung Ho C
+				Chung Ho    235
+				TW
+
+00-09-EF   (hex)		Vocera Communications
+0009EF     (base 16)		Vocera Communications
+				525 Race St.
+				San Jose  California  95126
+				US
+
+00-09-C4   (hex)		Medicore Co., Ltd
+0009C4     (base 16)		Medicore Co., Ltd
+				72-3 5th Fl., Luna Bldg, Chungdam-dong
+				Seoul    135-080
+				KR
+
+00-09-D9   (hex)		Neoscale Systems, Inc
+0009D9     (base 16)		Neoscale Systems, Inc
+				1500 Mc Candless Drive
+				Milpitas  CA  95035
+				US
+
+00-09-D0   (hex)		Solacom Technologies Inc.
+0009D0     (base 16)		Solacom Technologies Inc.
+				80 Jean-Proulx
+				Gatineau  Quebec  J8Z 1W1
+				CA
+
+00-09-CC   (hex)		Moog GmbH
+0009CC     (base 16)		Moog GmbH
+				Hanns-Klemm-Str. 28
+				Boeblingen    D-71034
+				DE
+
+00-0A-00   (hex)		Mediatek Corp.
+000A00     (base 16)		Mediatek Corp.
+				8F, No 69-5, Sec.2, Chung Cheng East Rd.
+				Taipei    251
+				TW
+
+00-09-F0   (hex)		Shimizu Technology Inc.
+0009F0     (base 16)		Shimizu Technology Inc.
+				15-6, No.107, Chung Shan Rd., Sec.1
+				Hsin Chuan,  Taipei  242
+				US
+
+00-09-E4   (hex)		K Tech Infosystem Inc.
+0009E4     (base 16)		K Tech Infosystem Inc.
+				B-405, Bundang Techno-Park 148, Yatap-do
+				Seongnam  Kyonggi-Do  464-070
+				KR
+
+00-09-72   (hex)		Securebase,Inc
+000972     (base 16)		Securebase,Inc
+				2nd Fl,Seungseung-Bldg,Dokok 2-Dong,Kang
+				Seoul    135-854
+				KR
+
+00-09-78   (hex)		AIJI System Co., Ltd.
+000978     (base 16)		AIJI System Co., Ltd.
+				#208 Samho-Park-Tower Bldg. 1122-10, Ing
+				Suwon  Gyeonggi-do  442-835
+				KR
+
+00-09-73   (hex)		Lenten Technology Co., Ltd.
+000973     (base 16)		Lenten Technology Co., Ltd.
+				16F, No.51, Sec.2, Gungyi Road,
+				Taichung City    408
+				TW
+
+00-09-75   (hex)		fSONA Communications Corporation
+000975     (base 16)		fSONA Communications Corporation
+				#140-11120 Horseshoe Way
+				Richmond  BC  V7A 5H7
+				CA
+
+00-09-77   (hex)		Brunner Elektronik AG
+000977     (base 16)		Brunner Elektronik AG
+				Müllerwis 1
+				Hittnau  Zurich  8335
+				CH
+
+00-09-69   (hex)		Meret Optical Communications
+000969     (base 16)		Meret Optical Communications
+				10070 Mesa Rim Road
+				San Diego  California  92121
+				US
+
+00-09-42   (hex)		Wireless Technologies, Inc
+000942     (base 16)		Wireless Technologies, Inc
+				Ohmori Mitsubishi Bldg., 7F, Sannoh 2-chome
+				Tokyo    143-0023
+				JP
+
+00-09-45   (hex)		Palmmicro Communications Inc
+000945     (base 16)		Palmmicro Communications Inc
+				630 Alder Dr
+				Milpitas  CA  95035
+				US
+
+00-09-3E   (hex)		C&I Technologies
+00093E     (base 16)		C&I Technologies
+				#303 Kwanbo Plaza B/D, 1467-2
+				Anyang-Shi  Kyunggi-Do  431-808
+				KR
+
+00-09-40   (hex)		AGFEO GmbH & Co. KG
+000940     (base 16)		AGFEO GmbH & Co. KG
+				Postfach 140107
+				Bielefeld  Rhine Westfalia  33621
+				DE
+
+00-09-7F   (hex)		Vsecure 2000 LTD.
+00097F     (base 16)		Vsecure 2000 LTD.
+				11 Moshe Levi St.
+				Rishon LeZion    75658
+				IL
+
+00-09-80   (hex)		Power Zenith Inc.
+000980     (base 16)		Power Zenith Inc.
+				Tsujido Nishikaigan 1-10-7
+				Fujisawa  Kanagawa  251-0046
+				JP
+
+00-09-A0   (hex)		Microtechno Corporation
+0009A0     (base 16)		Microtechno Corporation
+				2-33-36 Shimoodanaka
+				Kawasaki  Kanagawa  211-0041
+				JP
+
+00-09-9B   (hex)		Western Telematic Inc.
+00099B     (base 16)		Western Telematic Inc.
+				5 Sterling
+				Irvine  CA  92618
+				US
+
+00-09-90   (hex)		ACKSYS Communications & systems
+000990     (base 16)		ACKSYS Communications & systems
+				ZA du Val Joyeux
+				VILLEPREUX    F-78450
+				FR
+
+00-09-53   (hex)		Linkage System Integration Co.Ltd.
+000953     (base 16)		Linkage System Integration Co.Ltd.
+				40 Gongjianfang
+				Nanjing  Jiangsu  210006
+				CN
+
+00-09-4C   (hex)		Communication Weaver Co.,Ltd.
+00094C     (base 16)		Communication Weaver Co.,Ltd.
+				1~3 COWEAVER B/D 446-19,
+				SEOUL    121-841
+				KR
+
+00-09-6E   (hex)		GIANT ELECTRONICS LTD.
+00096E     (base 16)		GIANT ELECTRONICS LTD.
+				7/F., ELITE INDUSTRIAL BUILDING,
+				KWUN TONG  KOWLOON  
+				HK
+
+00-09-6C   (hex)		Imedia Semiconductor Corp.
+00096C     (base 16)		Imedia Semiconductor Corp.
+				4988 Great America Pkwy.
+				Santa Clara  CA  95054
+				US
+
+00-09-5F   (hex)		Telebyte, Inc.
+00095F     (base 16)		Telebyte, Inc.
+				270 Pulaski Road
+				Greenlawn  NY  11740-1616
+				US
+
+00-09-8A   (hex)		EqualLogic Inc
+00098A     (base 16)		EqualLogic Inc
+				9 Townsend West
+				Nashua  NH  03062
+				US
+
+00-08-F9   (hex)		Artesyn Embedded Technologies
+0008F9     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way Suite 190
+				Tempe  AZ  85282
+				US
+
+00-08-F4   (hex)		Bluetake Technology Co., Ltd.
+0008F4     (base 16)		Bluetake Technology Co., Ltd.
+				6F, No. 33, Lane 155, Sec. 3, Pei Shen R
+				Taipei  Taiwan  222
+				TW
+
+00-08-F7   (hex)		Hitachi Ltd, Semiconductor & Integrated Circuits Gr
+0008F7     (base 16)		Hitachi Ltd, Semiconductor & Integrated Circuits Gr
+				20-1 Josuihon-chou 5chome
+				Kodaira-shi  Tokyo  187-8588
+				JP
+
+00-09-20   (hex)		EpoX COMPUTER CO.,LTD.
+000920     (base 16)		EpoX COMPUTER CO.,LTD.
+				10th Floor, No.346,Chung San Rd.,Sec.2,
+				Chung Ho City,Taipei Hsien    235
+				TW
+
+00-09-22   (hex)		TST Biometrics GmbH
+000922     (base 16)		TST Biometrics GmbH
+				Moehlstraße 39
+				81675  Munich  
+				DE
+
+00-09-16   (hex)		Listman Home Technologies, Inc.
+000916     (base 16)		Listman Home Technologies, Inc.
+				1100 Northmeadow Parkway
+				Roswell  Georgia  30076
+				US
+
+00-09-11   (hex)		Cisco Systems, Inc
+000911     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-12   (hex)		Cisco Systems, Inc
+000912     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-08   (hex)		VTech Technology Corp.
+000908     (base 16)		VTech Technology Corp.
+				2F-2, No. 124, Chung Cheng Rd., Shihlin
+				Taipei    11141
+				TW
+
+00-09-0B   (hex)		MTL  Instruments PLC
+00090B     (base 16)		MTL  Instruments PLC
+				Power Court
+				Luton  Bedfordshire  LU1 3JJ
+				GB
+
+00-09-3B   (hex)		HYUNDAI NETWORKS INC.
+00093B     (base 16)		HYUNDAI NETWORKS INC.
+				SAN 136-1  AMI-RI  BUBAL_EUP
+				ICHON  KYUNGKI-DO  467-701
+				KR
+
+00-09-34   (hex)		Dream-Multimedia-Tv GmbH
+000934     (base 16)		Dream-Multimedia-Tv GmbH
+				Brückstraße 29
+				Menden  Sauerland  58706
+				DE
+
+00-09-31   (hex)		Future Internet, Inc.
+000931     (base 16)		Future Internet, Inc.
+				11'th Floor Samhomoolsan Bldg, B/Bldg, 2
+				Seoul  Kyung-Ki  137-130
+				KP
+
+00-08-F5   (hex)		YESTECHNOLOGY Co.,Ltd.
+0008F5     (base 16)		YESTECHNOLOGY Co.,Ltd.
+				4th FL Kyung-Am B/D 157-27 Samsung-Dong,
+				  Seoul  135-090
+				KR
+
+00-08-EC   (hex)		Optical Zonu Corporation
+0008EC     (base 16)		Optical Zonu Corporation
+				15028 Delano Street
+				Van Nuys  CA  91411-2016
+				US
+
+00-08-E6   (hex)		Littlefeet
+0008E6     (base 16)		Littlefeet
+				13000 Gregg Street
+				Poway  California  92064
+				US
+
+00-09-30   (hex)		AeroConcierge Inc.
+000930     (base 16)		AeroConcierge Inc.
+				10256 Yonge St.
+				Richmond Hill  Ont.  L4C 3B7
+				CA
+
+00-09-1E   (hex)		Firstech Technology Corp.
+00091E     (base 16)		Firstech Technology Corp.
+				8fl.,No.267,section 4,Hsin-Yi Rd. ,Da-An
+				Taipei    106
+				TW
+
+00-08-E2   (hex)		Cisco Systems, Inc
+0008E2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-09-05   (hex)		iTEC Technologies Ltd.
+000905     (base 16)		iTEC Technologies Ltd.
+				160-1, Karak-Dong, Songpa-Gu
+				Seoul    138-809
+				KR
+
+00-08-A5   (hex)		Peninsula Systems Inc.
+0008A5     (base 16)		Peninsula Systems Inc.
+				6902 Verde Ridge Rd.
+				Rancho Palos Verdes  CA  90275
+				US
+
+00-08-A2   (hex)		ADI Engineering, Inc.
+0008A2     (base 16)		ADI Engineering, Inc.
+				1769A Worth Park
+				Charlottesville  VA  22911
+				US
+
+00-08-98   (hex)		Gigabit Optics Corporation
+000898     (base 16)		Gigabit Optics Corporation
+				1156 Aster Ave.
+				Sunnyvale  CA  94086-6810
+				US
+
+00-08-9B   (hex)		ICP Electronics Inc.
+00089B     (base 16)		ICP Electronics Inc.
+				4F, No. 22, Chung-Hsing Rd. Shi-Chi City
+				Taipei    221
+				TW
+
+00-08-9C   (hex)		Elecs Industry Co., Ltd.
+00089C     (base 16)		Elecs Industry Co., Ltd.
+				1-22-23,Shinsaku,Takatsu-Ku
+				Kawasaki  Kanagawa  213-0014
+				JP
+
+00-08-9D   (hex)		UHD-Elektronik
+00089D     (base 16)		UHD-Elektronik
+				Zuercherstrasse 12
+				Baden  AG  5400
+				CH
+
+00-08-CF   (hex)		Nippon Koei Power Systems Co., Ltd.
+0008CF     (base 16)		Nippon Koei Power Systems Co., Ltd.
+				2940 Shinyoshida-cho
+				Kohoku-ku  Yokohama  223-8506
+				JP
+
+00-08-CB   (hex)		Zeta Broadband Inc.
+0008CB     (base 16)		Zeta Broadband Inc.
+				660 Vista Way, Suite B
+				Milpitas  CA  95035
+				US
+
+00-08-D3   (hex)		Hercules Technologies S.A.S.
+0008D3     (base 16)		Hercules Technologies S.A.S.
+				6,place des colombes
+				Rennes  Bretagne  35000
+				FR
+
+00-08-D0   (hex)		Musashi Engineering Co., LTD.
+0008D0     (base 16)		Musashi Engineering Co., LTD.
+				3-11-7, Nishi-shimbashi
+				Minato-ku  Tokyo  105-0003
+				JP
+
+00-08-BA   (hex)		Erskine Systems Ltd
+0008BA     (base 16)		Erskine Systems Ltd
+				Salter Road
+				Scarborough  North Yorkshire  YO11 3DU
+				GB
+
+00-08-B5   (hex)		TAI GUEN ENTERPRISE CO., LTD
+0008B5     (base 16)		TAI GUEN ENTERPRISE CO., LTD
+				N0.400, 10F-7 HUANPEI RD.,
+				CHUNG LI    320-61
+				TW
+
+00-08-B7   (hex)		HIT Incorporated
+0008B7     (base 16)		HIT Incorporated
+				4F, 8, Lane 235, Pao-Chiao Road,
+				Shin Tien  Taipei  231
+				TW
+
+00-08-A9   (hex)		SangSang Technology, Inc.
+0008A9     (base 16)		SangSang Technology, Inc.
+				64-8, Nogok-ri, Docheok-myun,
+				Gwangju  Kyonggi-do  464-882
+				KR
+
+00-08-C8   (hex)		Soneticom, Inc.
+0008C8     (base 16)		Soneticom, Inc.
+				4325 Woodland Park Drive, Suite 102
+				West Melbourne  Florida  32904
+				US
+
+00-08-C4   (hex)		Hikari Co.,Ltd.
+0008C4     (base 16)		Hikari Co.,Ltd.
+				418-4 Minaminoda Chigenobu-cho
+				Onsen-gun  Ehime  791-0297
+				JP
+
+00-08-8F   (hex)		ADVANCED DIGITAL TECHNOLOGY
+00088F     (base 16)		ADVANCED DIGITAL TECHNOLOGY
+				ADT BLDG.,3-3, YANGJAE-DONG,
+				SEOUL    
+				KR
+
+00-08-8B   (hex)		Tropic Networks Inc.
+00088B     (base 16)		Tropic Networks Inc.
+				135 Micheal Cowpland Drive
+				Ottawa  Ontario  K2M2E9
+				CA
+
+00-08-6B   (hex)		MIPSYS
+00086B     (base 16)		MIPSYS
+				19C, Avenue des Indes
+				LES ULIS Cedex    FR-91969
+				FR
+
+00-08-7F   (hex)		SPAUN electronic GmbH & Co. KG
+00087F     (base 16)		SPAUN electronic GmbH & Co. KG
+				Byk-Gulden - Str. 22
+				    
+				DE
+
+00-08-86   (hex)		Hansung Teliann, Inc.
+000886     (base 16)		Hansung Teliann, Inc.
+				195-1, Neungpyung-ri, Opo-eub
+				    
+				KR
+
+00-08-58   (hex)		Novatechnology Inc.
+000858     (base 16)		Novatechnology Inc.
+				Nova Bldg. 4F 641 03
+				Seoul    135-080
+				KR
+
+00-08-50   (hex)		Arizona Instrument Corp.
+000850     (base 16)		Arizona Instrument Corp.
+				1912 W. 4th Street
+				Tempe  AZ  85281
+				US
+
+00-08-5B   (hex)		Hanbit Electronics Co., Ltd.
+00085B     (base 16)		Hanbit Electronics Co., Ltd.
+				414-5, Woncheon-Dong, Paldal-Gu
+				    
+				KR
+
+00-08-2B   (hex)		Wooksung Electronics, Inc.
+00082B     (base 16)		Wooksung Electronics, Inc.
+				Jaho-Bldg. 6F, Tanbang-Dong,
+				    
+				KR
+
+00-08-2E   (hex)		Multitone Electronics PLC
+00082E     (base 16)		Multitone Electronics PLC
+				Multitone House, Beggarwood Lane
+				    
+				GB
+
+00-07-ED   (hex)		Altera Corporation
+0007ED     (base 16)		Altera Corporation
+				101 Innovation Drive
+				San Jose  CA  95134
+				US
+
+00-07-F1   (hex)		TeraBurst Networks Inc.
+0007F1     (base 16)		TeraBurst Networks Inc.
+				985 Stewart Drive
+				Sunnyvale  CA  94086
+				US
+
+00-07-F2   (hex)		IOA Corporation
+0007F2     (base 16)		IOA Corporation
+				350 Potrero Ave.
+				Sunnyvale  CA  94085
+				US
+
+00-07-EA   (hex)		Massana, Inc.
+0007EA     (base 16)		Massana, Inc.
+				2901 Tasman Drive
+				Santa Clara  CA  95054
+				US
+
+00-07-F0   (hex)		LogiSync LLC
+0007F0     (base 16)		LogiSync LLC
+				1313 Lear Industrial Parkway
+				Avon  OH  44011
+				US
+
+00-07-E7   (hex)		FreeWave Technologies
+0007E7     (base 16)		FreeWave Technologies
+				1880 S. Flaitron Ct.
+				Boulder  CO  80301
+				US
+
+00-07-D6   (hex)		Commil Ltd.
+0007D6     (base 16)		Commil Ltd.
+				P.O. Box 10050
+				    
+				IL
+
+00-07-D7   (hex)		Caporis Networks AG
+0007D7     (base 16)		Caporis Networks AG
+				Süggelstraße 31
+				    
+				DE
+
+00-07-D4   (hex)		Zhejiang Yutong Network Communication Co Ltd.
+0007D4     (base 16)		Zhejiang Yutong Network Communication Co Ltd.
+				805 HuaXing Technical Building
+				Zhejiang    
+				CN
+
+00-07-CE   (hex)		Cabletime Limited
+0007CE     (base 16)		Cabletime Limited
+				64 Greenham Road
+				Newbury  Berkshire  RG14 7HX
+				GB
+
+00-07-D3   (hex)		SPGPrints B.V.
+0007D3     (base 16)		SPGPrints B.V.
+				Raamstraat 1-3, 5831 AT Boxmeer
+				Boxmeer    
+				NL
+
+00-08-13   (hex)		Diskbank, Inc.
+000813     (base 16)		Diskbank, Inc.
+				3F Focus Building, 725-25
+				Seoul    135-080
+				KR
+
+00-08-0F   (hex)		Proximion Fiber Optics AB
+00080F     (base 16)		Proximion Fiber Optics AB
+				Isafjordsgatan 9
+				    
+				SE
+
+00-08-12   (hex)		GM-2 Corporation
+000812     (base 16)		GM-2 Corporation
+				Shiba-Matushira-Bldg.
+				Tokyo  Minato-ku  105-0014
+				JP
+
+00-08-0B   (hex)		Birka BPA Informationssystem AB
+00080B     (base 16)		Birka BPA Informationssystem AB
+				Box 20100
+				    
+				SE
+
+00-08-0A   (hex)		Espera-Werke GmbH
+00080A     (base 16)		Espera-Werke GmbH
+				Moltkestrasse 17- 33
+				    
+				DE
+
+00-07-E3   (hex)		Navcom Technology, Inc.
+0007E3     (base 16)		Navcom Technology, Inc.
+				123 West Torrance Blvd.,
+				Redondo Beach  CA  90277
+				US
+
+00-07-E1   (hex)		WIS Communications Co. Ltd.
+0007E1     (base 16)		WIS Communications Co. Ltd.
+				4/F Building 533
+				Shenzhen Guangdong Providence    
+				CN
+
+00-07-E0   (hex)		Palm Inc.
+0007E0     (base 16)		Palm Inc.
+				950 West Maude Ave
+				Sunnyvale  CA  94085-2801
+				US
+
+00-07-FA   (hex)		ITT Co., Ltd.
+0007FA     (base 16)		ITT Co., Ltd.
+				1-14-7, Mukohjyuku,
+				    
+				JP
+
+00-07-F6   (hex)		Qqest Software Systems
+0007F6     (base 16)		Qqest Software Systems
+				860 East 4500 South #200
+				Murray  UT  84107
+				US
+
+00-07-FB   (hex)		Giga Stream UMTS Technologies GmbH
+0007FB     (base 16)		Giga Stream UMTS Technologies GmbH
+				Konrad-Zuse-Strabe 7
+				    
+				DE
+
+00-08-5D   (hex)		Mitel Corporation
+00085D     (base 16)		Mitel Corporation
+				350 Legget Drive
+				-    K2K 2W7
+				CA
+
+00-08-55   (hex)		NASA-Goddard Space Flight Center
+000855     (base 16)		NASA-Goddard Space Flight Center
+				Code 561
+				Greenbelt  MD  20771
+				US
+
+00-08-5A   (hex)		IntiGate Inc.
+00085A     (base 16)		IntiGate Inc.
+				309E IT Venture Tower
+				Seoul    138-803
+				KR
+
+00-08-17   (hex)		EmergeCore Networks LLC
+000817     (base 16)		EmergeCore Networks LLC
+				10542 S. Jordan Gateway
+				South Jordan  UT  84095
+				US
+
+00-08-15   (hex)		CATS Co., Ltd.
+000815     (base 16)		CATS Co., Ltd.
+				751-2 Kachida-cho,
+				    224-0034
+				JP
+
+00-08-18   (hex)		Pixelworks, Inc.
+000818     (base 16)		Pixelworks, Inc.
+				7700 SW Mohawk Street
+				Tualatin  OR  97062
+				US
+
+00-08-2A   (hex)		Powerwallz Network Security
+00082A     (base 16)		Powerwallz Network Security
+				120-13160 Vanier Place,
+				    V6V 2J2
+				CA
+
+00-07-AC   (hex)		Eolring
+0007AC     (base 16)		Eolring
+				10 Rue Alfred Kastler
+				    
+				FR
+
+00-07-AA   (hex)		Quantum Data Inc.
+0007AA     (base 16)		Quantum Data Inc.
+				2111 Big Timber Rd.
+				Elgin  IL  60123-1100
+				US
+
+00-07-A4   (hex)		GN Netcom Ltd.
+0007A4     (base 16)		GN Netcom Ltd.
+				12-13 Sedling Road, Wear Est., District
+				  England  NE38 9BZ
+				GB
+
+00-07-9D   (hex)		Musashi Co., Ltd.
+00079D     (base 16)		Musashi Co., Ltd.
+				3-21-1, Shimo-ochiai,
+				Tokyo    161-0033
+				JP
+
+00-07-9F   (hex)		Action Digital Inc.
+00079F     (base 16)		Action Digital Inc.
+				10650 Main St.
+				Fairfax  VA  22030
+				US
+
+00-04-7C   (hex)		Skidata AG
+00047C     (base 16)		Skidata AG
+				T-697553 Untersbergstr. 40
+				    
+				AT
+
+00-07-BE   (hex)		DataLogic SpA
+0007BE     (base 16)		DataLogic SpA
+				Via Candini, 2
+				Bologna    
+				IT
+
+00-07-AF   (hex)		Red Lion Controls, LP
+0007AF     (base 16)		Red Lion Controls, LP
+				20 Willow Springs Circle
+				York  NY  17402
+				US
+
+00-07-67   (hex)		Yuxing Electronics Company Limited
+000767     (base 16)		Yuxing Electronics Company Limited
+				Unit 1808, 18/F Tower 3,
+				Kowloon Bay,  Kowloon  
+				HK
+
+00-07-5B   (hex)		Gibson Guitars
+00075B     (base 16)		Gibson Guitars
+				309 Park Plus Blvd.
+				Nashville  TN  37217
+				US
+
+00-07-62   (hex)		Group Sense Limited
+000762     (base 16)		Group Sense Limited
+				27/F, Wu Chung House,
+				Wanchai    
+				HK
+
+00-07-84   (hex)		Cisco Systems, Inc
+000784     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-07-76   (hex)		Federal APD
+000776     (base 16)		Federal APD
+				42775 Nine Mile Rd.
+				Novi  MI  48375
+				US
+
+00-07-7A   (hex)		Infoware System Co., Ltd.
+00077A     (base 16)		Infoware System Co., Ltd.
+				Mizorogi Daiichi Bldg 4 F
+				Tokyo    
+				JP
+
+00-07-90   (hex)		Tri-M Technologies (s) Limited
+000790     (base 16)		Tri-M Technologies (s) Limited
+				Blk 25, Kallang Avenue #07-01/04
+				    339416
+				SG
+
+00-07-8D   (hex)		NetEngines Ltd.
+00078D     (base 16)		NetEngines Ltd.
+				146 Walnut Tree Close
+				    GUI 4UB
+				GB
+
+00-07-8A   (hex)		Mentor Data System Inc.
+00078A     (base 16)		Mentor Data System Inc.
+				No. 24-1, Industry East 4 Rd.,
+				Hsin-Chu,    
+				TW
+
+00-07-92   (hex)		Sütron Electronic GmbH
+000792     (base 16)		Sütron Electronic GmbH
+				Kurze Straße 29
+				    
+				DE
+
+00-07-B2   (hex)		Transaccess S.A.
+0007B2     (base 16)		Transaccess S.A.
+				R. Galeno De Castro, 1445
+				São Paulo SP    
+				BR
+
+00-07-AD   (hex)		Pentacon GmbH Foto-und Feinwerktechnik
+0007AD     (base 16)		Pentacon GmbH Foto-und Feinwerktechnik
+				Enderstrabe 94
+				    
+				DE
+
+00-07-D0   (hex)		Automat Engenharia de Automação Ltda.
+0007D0     (base 16)		Automat Engenharia de Automação Ltda.
+				Rua Santo Antonio, 917 - Reboucas
+				    80230-120
+				BR
+
+00-07-6A   (hex)		NEXTEYE Co., Ltd.
+00076A     (base 16)		NEXTEYE Co., Ltd.
+				Shinsegi Plaza 4F, 900-9,
+				Kyunggi    431-070
+				KR
+
+00-06-E6   (hex)		DongYang Telecom Co., Ltd.
+0006E6     (base 16)		DongYang Telecom Co., Ltd.
+				642-7 Deung Chon-Dong, KangSeo-Gu
+				  Seoul  157-841
+				KR
+
+00-06-DC   (hex)		Syabas Technology (Amquest)
+0006DC     (base 16)		Syabas Technology (Amquest)
+				4727 Paseo Padre Parkway
+				Fremont  CA  94555
+				US
+
+00-07-0C   (hex)		SVA-Intrusion.com Co. Ltd.
+00070C     (base 16)		SVA-Intrusion.com Co. Ltd.
+				The 4th Floor, No. 28 Building
+				Shanghai    20233
+				CN
+
+00-07-0F   (hex)		Fujant, Inc.
+00070F     (base 16)		Fujant, Inc.
+				6305 Carpinteria Avenue
+				Carpinteria  CA  93013-2901
+				US
+
+00-07-14   (hex)		Brightcom
+000714     (base 16)		Brightcom
+				6 Hanechoshet St.,
+				    
+				IL
+
+00-06-F3   (hex)		AcceLight Networks
+0006F3     (base 16)		AcceLight Networks
+				70 Abele Road, Building 1200
+				Pittsburgh  PA  15017
+				US
+
+00-06-D2   (hex)		Tundra Semiconductor Corp.
+0006D2     (base 16)		Tundra Semiconductor Corp.
+				603 March Road
+				    K2K-2M5
+				CA
+
+00-06-D8   (hex)		Maple Optical Systems
+0006D8     (base 16)		Maple Optical Systems
+				3200 North First St.
+				San Jose  CA  95134
+				US
+
+00-06-CF   (hex)		Thales Avionics In-Flight Systems, LLC
+0006CF     (base 16)		Thales Avionics In-Flight Systems, LLC
+				17481 Red Hill Avenue
+				Irvine  CA  92614-5630
+				US
+
+00-06-FE   (hex)		Ambrado, Inc
+0006FE     (base 16)		Ambrado, Inc
+				11301 W. President George Bush Fwy.
+				Richardson  TX  75080
+				US
+
+00-06-E7   (hex)		Bit Blitz Communications Inc.
+0006E7     (base 16)		Bit Blitz Communications Inc.
+				830 Hillview Ct., #290
+				Milpitas  CA  95035
+				US
+
+00-06-ED   (hex)		Inara Networks
+0006ED     (base 16)		Inara Networks
+				3031 Tisch Way,
+				San Jose  CA  95128
+				US
+
+00-06-DB   (hex)		ICHIPS Co., Ltd.
+0006DB     (base 16)		ICHIPS Co., Ltd.
+				3F, Samjeon Bldg., 236-3
+				Seoul-City    135-01
+				KR
+
+00-07-27   (hex)		Zi Corporation (HK) Ltd.
+000727     (base 16)		Zi Corporation (HK) Ltd.
+				30/F, China Resources Building
+				    
+				HK
+
+00-07-2E   (hex)		North Node AB
+00072E     (base 16)		North Node AB
+				Skeppsloron 42
+				    
+				SE
+
+00-06-99   (hex)		Vida Design Co.
+000699     (base 16)		Vida Design Co.
+				10F, No. 278 Ho Ping E. Rd.,
+				    
+				TW
+
+00-06-8D   (hex)		SEPATON, Inc.
+00068D     (base 16)		SEPATON, Inc.
+				400 Nickerson Rd.
+				Marlborough  MA  01752
+				US
+
+00-06-A3   (hex)		Bitran Corporation
+0006A3     (base 16)		Bitran Corporation
+				2213 Mochida
+				    
+				JP
+
+00-06-9F   (hex)		Kuokoa Networks
+00069F     (base 16)		Kuokoa Networks
+				2901 Tasman Dr.
+				Santa Clara  CA  95054
+				US
+
+00-06-A2   (hex)		Microtune, Inc.
+0006A2     (base 16)		Microtune, Inc.
+				6440 Lusk Blvd., Suite D205
+				San Diego  CA  92121
+				US
+
+00-06-A6   (hex)		Artistic Licence Engineering Ltd
+0006A6     (base 16)		Artistic Licence Engineering Ltd
+				24 Forward Drive
+				Harrow  Middlesex  HA3 8NT
+				GB
+
+00-06-B8   (hex)		Bandspeed Pty Ltd
+0006B8     (base 16)		Bandspeed Pty Ltd
+				Level 9, 5000 Collins Street
+				    
+				AU
+
+00-06-BB   (hex)		ATI Technologies Inc.
+0006BB     (base 16)		ATI Technologies Inc.
+				75 Tiverton Court
+				    
+				CA
+
+00-06-BD   (hex)		BNTECHNOLOGY Co., Ltd.
+0006BD     (base 16)		BNTECHNOLOGY Co., Ltd.
+				602 Youngshin Bldg. 238-8
+				Seoul    
+				KR
+
+00-06-C3   (hex)		Schindler Elevator Ltd.
+0006C3     (base 16)		Schindler Elevator Ltd.
+				R&D-CO
+				  Ebikon  CH-6030
+				CH
+
+00-06-AA   (hex)		VT Miltope
+0006AA     (base 16)		VT Miltope
+				4900 Pearl East Circle
+				Boulder  CO  80301
+				US
+
+00-06-57   (hex)		Market Central, Inc.
+000657     (base 16)		Market Central, Inc.
+				500 Business Center Drive
+				Pittsburgh  PA  15205-1333
+				US
+
+00-06-97   (hex)		R & D Center
+000697     (base 16)		R & D Center
+				5F, Seungwon B/D, 810-9
+				Seoul    
+				KR
+
+00-06-9A   (hex)		e & Tel
+00069A     (base 16)		e & Tel
+				100 Sejong-no Chongno-gu,
+				    
+				KR
+
+00-06-7D   (hex)		Takasago Ltd.
+00067D     (base 16)		Takasago Ltd.
+				1-24-16 Mizonokuchi Takatsu-ku
+				    
+				JP
+
+00-06-71   (hex)		Softing AG
+000671     (base 16)		Softing AG
+				Richard-Reitzner-Allee 6
+				    
+				DE
+
+00-06-72   (hex)		Netezza
+000672     (base 16)		Netezza
+				1671 Worcester Road
+				Framingham  MA  01701
+				US
+
+00-06-6A   (hex)		InfiniCon Systems, Inc.
+00066A     (base 16)		InfiniCon Systems, Inc.
+				700 American Ave.
+				King of Prussia  PA  19406
+				US
+
+00-06-61   (hex)		NIA Home Technologies Corp.
+000661     (base 16)		NIA Home Technologies Corp.
+				Innovation Incubator, NTHU,
+				Hsinchu  30013,  
+				TW
+
+00-06-B2   (hex)		Linxtek Co.
+0006B2     (base 16)		Linxtek Co.
+				2F Kum-a B/D 31-3 Karak-dong,
+				    138-160
+				KR
+
+00-06-B6   (hex)		Nir-Or Israel Ltd.
+0006B6     (base 16)		Nir-Or Israel Ltd.
+				11 Amal St.
+				    
+				IL
+
+00-06-84   (hex)		Biacore AB
+000684     (base 16)		Biacore AB
+				Software, Electronics and Optics
+				    
+				SE
+
+00-06-82   (hex)		Convedia
+000682     (base 16)		Convedia
+				4190 Still Creek Dr.
+				    V5C 6C6
+				CA
+
+00-05-E3   (hex)		LightSand Communications, Inc.
+0005E3     (base 16)		LightSand Communications, Inc.
+				375 Los Coches St.
+				Milpitas  CA  94539
+				US
+
+00-05-ED   (hex)		Technikum Joanneum GmbH
+0005ED     (base 16)		Technikum Joanneum GmbH
+				Alte Poststrasse 149
+				    
+				AT
+
+00-05-EF   (hex)		ADOIR Digital Technology
+0005EF     (base 16)		ADOIR Digital Technology
+				28 Fl, ZhaoFeng World Trade Bldg.
+				Shanghai  200050,  
+				CN
+
+00-06-00   (hex)		Toshiba Teli Corporation
+000600     (base 16)		Toshiba Teli Corporation
+				 4-7-1 Asahigaoka, Hino-Shi,
+				  Tokyo  191-0065
+				JP
+
+00-06-6B   (hex)		Sysmex Corporation
+00066B     (base 16)		Sysmex Corporation
+				4-4-4 Takatsukadai,
+				    651-2271
+				JP
+
+00-05-5A   (hex)		Power Dsine Ltd.
+00055A     (base 16)		Power Dsine Ltd.
+				1 Hanagar St., P.O. Box 7220
+				    
+				IL
+
+00-06-53   (hex)		Cisco Systems, Inc
+000653     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-06-4F   (hex)		PRO-NETS Technology Corporation
+00064F     (base 16)		PRO-NETS Technology Corporation
+				Pao-Chung Road,
+				Hsin Tien  Taipei,  
+				TW
+
+00-06-12   (hex)		Accusys, Inc.
+000612     (base 16)		Accusys, Inc.
+				5F, No. 38, Taiyuan St
+				Hsinchu County    30265
+				TW
+
+00-06-09   (hex)		Crossport Systems
+000609     (base 16)		Crossport Systems
+				10940 NE 33rd Place
+				Bellevue  WA  98005
+				US
+
+00-06-16   (hex)		Tel Net Co., Ltd.
+000616     (base 16)		Tel Net Co., Ltd.
+				3F BOF Bldg 730-15 Goje Song
+				    
+				KR
+
+00-06-0D   (hex)		Wave7 Optics
+00060D     (base 16)		Wave7 Optics
+				1075 Windward Ridge Pkwy.
+				Alpharetta  GA  30005
+				US
+
+00-06-4A   (hex)		Honeywell Co., Ltd. (KOREA)
+00064A     (base 16)		Honeywell Co., Ltd. (KOREA)
+				56, Chaam-dong, Chonan-city
+				    
+				KR
+
+00-06-3F   (hex)		Everex Communications Inc.
+00063F     (base 16)		Everex Communications Inc.
+				5020A Brandin Ct.
+				Fremont  CA  94538
+				US
+
+00-06-3D   (hex)		Microwave Data Systems Inc.
+00063D     (base 16)		Microwave Data Systems Inc.
+				175 Science Parkway
+				Rochester  NY  14620
+				US
+
+00-06-39   (hex)		Newtec
+000639     (base 16)		Newtec
+				Laarstraat 5
+				    
+				BE
+
+00-06-2F   (hex)		Pivotech Systems Inc.
+00062F     (base 16)		Pivotech Systems Inc.
+				200 Centennial Ave.,
+				Piscataway  NJ  08854
+				US
+
+00-06-36   (hex)		Jedai Broadband Networks
+000636     (base 16)		Jedai Broadband Networks
+				331 Newman Springs Rd.
+				Red Bank  NJ  07701
+				US
+
+00-06-51   (hex)		Aspen Networks Inc.
+000651     (base 16)		Aspen Networks Inc.
+				3777 Stevens Creek Blvd
+				Santa Clara  CA  95051
+				US
+
+00-06-5C   (hex)		Malachite Technologies, Inc.
+00065C     (base 16)		Malachite Technologies, Inc.
+				195 New Hampshire Avenue
+				Portsmouth  NH  03801
+				US
+
+00-06-42   (hex)		Genetel Systems Inc.
+000642     (base 16)		Genetel Systems Inc.
+				Mockwoo B/D, 912 Walpyoung-Dong
+				    302-852
+				KR
+
+00-05-E9   (hex)		Unicess Network, Inc.
+0005E9     (base 16)		Unicess Network, Inc.
+				870 Dorothy Dr. #708
+				Richardson  TX  75081
+				US
+
+00-05-E6   (hex)		Egenera, Inc.
+0005E6     (base 16)		Egenera, Inc.
+				165 Forest St.
+				Marlboro  MA  01752
+				US
+
+00-06-1E   (hex)		Maxan Systems
+00061E     (base 16)		Maxan Systems
+				1-84, Woulam-dong
+				    
+				KR
+
+00-06-22   (hex)		Chung Fu Chen Yeh Enterprise Corp.
+000622     (base 16)		Chung Fu Chen Yeh Enterprise Corp.
+				2F No. 666 Jing Ping Road,
+				Taipei Hsien    
+				TW
+
+00-05-88   (hex)		Sensoria Corp.
+000588     (base 16)		Sensoria Corp.
+				15950 Bernardo Ctr. Dr.
+				San Diego  CA  92127
+				US
+
+00-05-8D   (hex)		Lynx Photonic Networks, Inc.
+00058D     (base 16)		Lynx Photonic Networks, Inc.
+				13 Hamelaha St.
+				    
+				IL
+
+00-05-8A   (hex)		Netcom Co., Ltd.
+00058A     (base 16)		Netcom Co., Ltd.
+				1F, No. 7, Lane 242,
+				Taipei    
+				TW
+
+00-05-91   (hex)		Active Silicon Ltd
+000591     (base 16)		Active Silicon Ltd
+				Pinewood Mews
+				Iver    SL0 0NA
+				GB
+
+00-05-93   (hex)		Grammar Engine Inc.
+000593     (base 16)		Grammar Engine Inc.
+				921 Eastwind Drive
+				Westerville  OH  43081
+				US
+
+00-05-C7   (hex)		I/F-COM A/S
+0005C7     (base 16)		I/F-COM A/S
+				Ellegaardvej 36
+				    
+				DK
+
+00-05-CC   (hex)		Sumtel Communications, Inc.
+0005CC     (base 16)		Sumtel Communications, Inc.
+				1F, No. 173, Gung Yuan Road,
+				Hsinchu City    30054
+				TW
+
+00-05-CF   (hex)		Thunder River Technologies, Inc.
+0005CF     (base 16)		Thunder River Technologies, Inc.
+				23 Corporate Plaza Ste. 250
+				Newport Beach  CA  92660
+				US
+
+00-05-C6   (hex)		Triz Communications
+0005C6     (base 16)		Triz Communications
+				Anwon Bldg. 7th Fl.
+				Seoul    150-010
+				KR
+
+00-05-D6   (hex)		L-3 Linkabit
+0005D6     (base 16)		L-3 Linkabit
+				9890 Town Center Drive
+				San Diego  CA  92121
+				US
+
+00-05-DA   (hex)		Apex Automationstechnik
+0005DA     (base 16)		Apex Automationstechnik
+				Vossenkamp 4
+				    
+				DE
+
+00-05-A1   (hex)		Zenocom
+0005A1     (base 16)		Zenocom
+				No.402, 4th floor, Wongok Bldg.
+				Seoul    
+				KR
+
+00-05-A9   (hex)		Princeton Networks, Inc.
+0005A9     (base 16)		Princeton Networks, Inc.
+				100 Century Center Ct. #100
+				San Jose  CA  95112
+				US
+
+00-05-AF   (hex)		InnoScan Computing A/S
+0005AF     (base 16)		InnoScan Computing A/S
+				Soren Frichsvej 42R
+				    
+				DK
+
+00-05-A6   (hex)		Extron Electronics
+0005A6     (base 16)		Extron Electronics
+				1230 S. Lewis
+				Anahiem  CA  92805
+				US
+
+00-05-A0   (hex)		MOBILINE Kft.
+0005A0     (base 16)		MOBILINE Kft.
+				Lehel Utca 14
+				    H-1134
+				HU
+
+00-05-84   (hex)		AbsoluteValue Systems, Inc.
+000584     (base 16)		AbsoluteValue Systems, Inc.
+				715-D North Dr.
+				Melbourne  FL  32934
+				US
+
+00-05-8F   (hex)		CLCsoft co.
+00058F     (base 16)		CLCsoft co.
+				Dept. of Electrical Engineering
+				    
+				KR
+
+00-05-BB   (hex)		Myspace AB
+0005BB     (base 16)		Myspace AB
+				Sveavagen 33
+				    
+				SE
+
+00-05-17   (hex)		Shellcomm, Inc.
+000517     (base 16)		Shellcomm, Inc.
+				Rm #6122 ETRI TBI Center, 1,
+				    
+				KR
+
+00-05-1C   (hex)		Xnet Technology Corp.
+00051C     (base 16)		Xnet Technology Corp.
+				9F-16, No. 12, Lane 609,
+				    
+				TW
+
+00-04-F9   (hex)		Xtera Communications, Inc.
+0004F9     (base 16)		Xtera Communications, Inc.
+				500 W Bethany Drive
+				Allen  TX  75013
+				US
+
+00-04-FA   (hex)		NBS Technologies Inc.
+0004FA     (base 16)		NBS Technologies Inc.
+				703 Evans Avenue, Suite 400
+				Ontario    M9C 5E9
+				CA
+
+00-05-41   (hex)		Advanced Systems Co., Ltd.
+000541     (base 16)		Advanced Systems Co., Ltd.
+				2-9-7 Nishikicho,
+				    190-0022
+				JP
+
+00-05-45   (hex)		Internet Photonics
+000545     (base 16)		Internet Photonics
+				1030 Broad St., 2nd Floor
+				Shrewsbury  NJ  07702
+				US
+
+00-05-3A   (hex)		Willowglen Services Pte Ltd
+00053A     (base 16)		Willowglen Services Pte Ltd
+				151 Lorong Chuan,
+				    556741
+				SG
+
+00-05-31   (hex)		Cisco Systems, Inc
+000531     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-05-39   (hex)		A Brand New World in Sweden AB
+000539     (base 16)		A Brand New World in Sweden AB
+				Box 1223
+				    
+				SE
+
+00-05-2A   (hex)		Ikegami Tsushinki Co., Ltd.
+00052A     (base 16)		Ikegami Tsushinki Co., Ltd.
+				5-6-16 Ikegami Ohta-ku,
+				    146-8567
+				JP
+
+00-05-2D   (hex)		Zoltrix International Limited
+00052D     (base 16)		Zoltrix International Limited
+				Room 701 Po Hing Centre,
+				    
+				HK
+
+00-05-25   (hex)		Puretek Industrial Co., Ltd.
+000525     (base 16)		Puretek Industrial Co., Ltd.
+				No. 14, 4 Flr. Lane 235
+				    
+				TW
+
+00-05-58   (hex)		Synchronous, Inc.
+000558     (base 16)		Synchronous, Inc.
+				77 Las Colinas Lane
+				San Jose  CA  95119
+				US
+
+00-05-50   (hex)		Vcomms Connect Limited
+000550     (base 16)		Vcomms Connect Limited
+				75 The Esplanade, Level 3
+				Wellington Mail Centre 5045  Wellington  
+				NZ
+
+00-05-12   (hex)		Zebra Technologies Inc
+000512     (base 16)		Zebra Technologies Inc
+				475 Half Day Road
+				Lincolnshire  IL  60069
+				US
+
+00-05-03   (hex)		ICONAG
+000503     (base 16)		ICONAG
+				AM Bahnhof 2
+				    
+				DE
+
+00-05-7A   (hex)		Overture Networks
+00057A     (base 16)		Overture Networks
+				637 Davis Drive
+				Morrisville  NC  27560
+				US
+
+00-05-64   (hex)		Tsinghua Bitway Co., Ltd.
+000564     (base 16)		Tsinghua Bitway Co., Ltd.
+				12 Floor, Tower C, Corporate
+				    
+				CN
+
+00-04-F8   (hex)		QUALICABLE TV Industria E Com., Ltda
+0004F8     (base 16)		QUALICABLE TV Industria E Com., Ltda
+				Av. Joao Paulo Ablas, 308
+				    
+				BR
+
+00-04-F5   (hex)		SnowShore Networks, Inc.
+0004F5     (base 16)		SnowShore Networks, Inc.
+				285 Billerica Road
+				Chelmsford  MA  01824
+				US
+
+00-04-F2   (hex)		Polycom
+0004F2     (base 16)		Polycom
+				1000 West 14th Street
+				  Canada  V7P3P3
+				CA
+
+00-04-F3   (hex)		FS FORTH-SYSTEME GmbH
+0004F3     (base 16)		FS FORTH-SYSTEME GmbH
+				Küferstraße 8
+				    
+				DE
+
+00-04-ED   (hex)		Billion Electric Co., Ltd.
+0004ED     (base 16)		Billion Electric Co., Ltd.
+				8F, No.192, Sec.2, Chung Hsing Rd.,
+				Taiwan  Taiwan  ROC
+				TW
+
+00-04-E7   (hex)		Lightpointe Communications, Inc
+0004E7     (base 16)		Lightpointe Communications, Inc
+				10140 Barnes Canyon Road
+				San Diego  CA  92121
+				US
+
+00-04-E6   (hex)		Banyan Network Private Limited
+0004E6     (base 16)		Banyan Network Private Limited
+				443, 8th Floor, Guna Complex
+				    
+				IN
+
+00-04-DE   (hex)		Cisco Systems, Inc
+0004DE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-A2   (hex)		L.S.I. Japan Co., Ltd.
+0004A2     (base 16)		L.S.I. Japan Co., Ltd.
+				1-8-14 Sendagaya Shibuya-Ku
+				Tokyo  151-0051  
+				JP
+
+00-04-9B   (hex)		Cisco Systems, Inc
+00049B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-99   (hex)		Chino Corporation
+000499     (base 16)		Chino Corporation
+				1 Mori, Fujioka City,
+				  Zip:  375-8505
+				JP
+
+00-04-8E   (hex)		Ohm Tech Labs, Inc.
+00048E     (base 16)		Ohm Tech Labs, Inc.
+				141 Lanza Ave., B-12
+				Garfield  NJ  07026
+				US
+
+00-04-A6   (hex)		SAF Tehnika Ltd.
+0004A6     (base 16)		SAF Tehnika Ltd.
+				91 Dzirnavu Str.,
+				    
+				LV
+
+00-04-A8   (hex)		Broadmax Technologies, Inc.
+0004A8     (base 16)		Broadmax Technologies, Inc.
+				180, Wai Yip Street,
+				  HONG  KONG
+				HK
+
+00-04-A1   (hex)		Pathway Connectivity
+0004A1     (base 16)		Pathway Connectivity
+				1439-17 Avenue SE
+				Calgary  Alberta  T2G 1J9
+				CA
+
+00-04-CE   (hex)		Patria Ailon
+0004CE     (base 16)		Patria Ailon
+				Naulakatu 3
+				    
+				FI
+
+00-04-C7   (hex)		NetMount
+0004C7     (base 16)		NetMount
+				P.O.B. 2325
+				    
+				IL
+
+00-04-8D   (hex)		 Teo Technologies, Inc
+00048D     (base 16)		 Teo Technologies, Inc
+				11609 49th Place West
+				Mukilteo  WA  98275
+				US
+
+00-04-90   (hex)		Optical Access
+000490     (base 16)		Optical Access
+				P.O. Box 114
+				    
+				IL
+
+00-04-E1   (hex)		Infinior Microsystems
+0004E1     (base 16)		Infinior Microsystems
+				2F, Accufar Bldg, 234-10,
+				Seoul  KOREA  138-220
+				KR
+
+00-04-C2   (hex)		Magnipix, Inc.
+0004C2     (base 16)		Magnipix, Inc.
+				3539 St-Charles Blvd., Suite 212
+				  CANADA  H9H3C4
+				CA
+
+00-04-86   (hex)		ITTC, University of Kansas
+000486     (base 16)		ITTC, University of Kansas
+				2335 Irving Hill Rd.
+				Lawrence  KS  66045
+				US
+
+00-04-8B   (hex)		Poscon Corporation
+00048B     (base 16)		Poscon Corporation
+				#606 Ho-Dong, Nam Gu,
+				  SOUTH  KOREA
+				KR
+
+00-04-84   (hex)		Amann GmbH
+000484     (base 16)		Amann GmbH
+				Unteranger 6
+				    
+				DE
+
+00-04-78   (hex)		G. Star Technology Corporation
+000478     (base 16)		G. Star Technology Corporation
+				4th Floor, No. 118, Sector 2
+				Taipei City  Taipei City  TAIWAN
+				TW
+
+00-04-7A   (hex)		AXXESSIT ASA
+00047A     (base 16)		AXXESSIT ASA
+				AXXESSIT ASA HALDEN
+				    
+				NO
+
+00-04-6A   (hex)		Navini Networks
+00046A     (base 16)		Navini Networks
+				3605 E. Plano Pkwy,
+				Plano  TX  75074
+				US
+
+00-04-6B   (hex)		Palm Wireless, Inc.
+00046B     (base 16)		Palm Wireless, Inc.
+				48933 Warm Springs Blvd.
+				Fremont  CA  94539
+				US
+
+00-04-72   (hex)		Telelynx, Inc.
+000472     (base 16)		Telelynx, Inc.
+				3F-1, 66 Nankan Rd.,
+				    TAIWAN
+				TW
+
+00-04-64   (hex)		Pulse-Link Inc
+000464     (base 16)		Pulse-Link Inc
+				1934 Kellogg Avenue
+				Carlsbad  CA  92008
+				US
+
+00-04-65   (hex)		i.s.t isdn-support technik GmbH
+000465     (base 16)		i.s.t isdn-support technik GmbH
+				Rhein Strasse 7E
+				    
+				DE
+
+00-04-5E   (hex)		PolyTrax Information Technology AG
+00045E     (base 16)		PolyTrax Information Technology AG
+				Martin-Kollar - Str. 5
+				    
+				DE
+
+00-04-11   (hex)		Inkra Networks, Inc.
+000411     (base 16)		Inkra Networks, Inc.
+				40971 Encyclopedia Circle
+				Fremont  CA  94538
+				US
+
+00-04-10   (hex)		Spinnaker Networks, Inc.
+000410     (base 16)		Spinnaker Networks, Inc.
+				107 Gamma Drive
+				Pittsburgh  PA  15238
+				US
+
+00-04-12   (hex)		WaveSmith Networks, Inc.
+000412     (base 16)		WaveSmith Networks, Inc.
+				40 Nagog Park
+				Acton  MA  01720-3425
+				US
+
+00-04-42   (hex)		NACT
+000442     (base 16)		NACT
+				191 W. 5200 N.
+				Provo  UT  84604
+				US
+
+00-04-45   (hex)		LMS Skalar Instruments GmbH
+000445     (base 16)		LMS Skalar Instruments GmbH
+				Willi-Eichler-Str 11
+				    
+				DE
+
+00-04-4E   (hex)		Cisco Systems, Inc
+00044E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-52   (hex)		RocketLogix, Inc.
+000452     (base 16)		RocketLogix, Inc.
+				6504 International Parkway
+				Plano  TX  75093
+				US
+
+00-04-27   (hex)		Cisco Systems, Inc
+000427     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-04-20   (hex)		Slim Devices, Inc.
+000420     (base 16)		Slim Devices, Inc.
+				12 South First St.
+				San Jose  CA  95113
+				US
+
+00-04-3D   (hex)		INDEL AG
+00043D     (base 16)		INDEL AG
+				Tufiwis 26
+				    
+				CH
+
+00-04-3B   (hex)		Lava Computer Mfg., Inc.
+00043B     (base 16)		Lava Computer Mfg., Inc.
+				2 Vulcan St.
+				  CANADA  M9W-1L2
+				CA
+
+00-04-31   (hex)		GlobalStreams, Inc.
+000431     (base 16)		GlobalStreams, Inc.
+				2882 Prospect Park Drive
+				Rancho Cordova  CA  95670
+				US
+
+00-03-C4   (hex)		Tomra Systems ASA
+0003C4     (base 16)		Tomra Systems ASA
+				Drengsrudhagen 2
+				    
+				NO
+
+00-03-C5   (hex)		Mobotix AG
+0003C5     (base 16)		Mobotix AG
+				Wingertsweilerhof 6
+				    
+				DE
+
+00-03-BF   (hex)		Centerpoint Broadband Technologies, Inc.
+0003BF     (base 16)		Centerpoint Broadband Technologies, Inc.
+				1741 Technology Drive,
+				San Jose  CA  95110-1310
+				US
+
+00-03-B9   (hex)		Hualong Telecom Co., Ltd.
+0003B9     (base 16)		Hualong Telecom Co., Ltd.
+				9 Guanghua St.
+				  P.R.  
+				CN
+
+00-03-F9   (hex)		Pleiades Communications, Inc.
+0003F9     (base 16)		Pleiades Communications, Inc.
+				2830 Market Loop #104
+				South Lake  TX  76092
+				US
+
+00-03-FE   (hex)		Cisco Systems, Inc
+0003FE     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-F5   (hex)		Chip2Chip
+0003F5     (base 16)		Chip2Chip
+				2249 Zanker Rd.
+				San Jose  CA  95131
+				US
+
+00-03-91   (hex)		Advanced Digital Broadcast, Ltd.
+000391     (base 16)		Advanced Digital Broadcast, Ltd.
+				8F, 145 Chung Shan N. Rd. Sec. 2,
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-03-AC   (hex)		Fronius Schweissmaschinen
+0003AC     (base 16)		Fronius Schweissmaschinen
+				Günter Fronius-Straße 1
+				    
+				AT
+
+00-03-99   (hex)		Dongju Informations & Communications Co., Ltd.
+000399     (base 16)		Dongju Informations & Communications Co., Ltd.
+				#305, Eunsuk Bldg. Samsung-dong
+				Republic  of  KOREA
+				KR
+
+00-03-FD   (hex)		Cisco Systems, Inc
+0003FD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-BA   (hex)		Oracle Corporation
+0003BA     (base 16)		Oracle Corporation
+				17 Network Circle
+				Menlo Park  CA  95025
+				US
+
+00-03-AF   (hex)		Paragea Communications
+0003AF     (base 16)		Paragea Communications
+				207 Perry Parkway
+				Gaithersburg  MD  20877
+				US
+
+00-03-0B   (hex)		Hunter Technology, Inc.
+00030B     (base 16)		Hunter Technology, Inc.
+				1408, Woolim e-biz Center,
+				Seoul    135-270
+				KR
+
+00-03-C9   (hex)		TECOM Co., Ltd.
+0003C9     (base 16)		TECOM Co., Ltd.
+				23, R&D Road 2
+				Hsin-Chu    
+				TW
+
+00-03-C1   (hex)		Packet Dynamics Ltd
+0003C1     (base 16)		Packet Dynamics Ltd
+				2 Buckstane Park
+				UK  EH10  GPA
+				GB
+
+00-03-DE   (hex)		OTC Wireless
+0003DE     (base 16)		OTC Wireless
+				602 Charlot Ave.
+				San Jose  CA  95131
+				US
+
+00-03-28   (hex)		Mace Group, Inc.
+000328     (base 16)		Mace Group, Inc.
+				5101 Commerce Dr.
+				Baldwin Park  CA  91706
+				US
+
+00-03-2B   (hex)		GAI Datenfunksysteme GmbH
+00032B     (base 16)		GAI Datenfunksysteme GmbH
+				Riedleparkstraße 28
+				Friedrichshafen    88045
+				DE
+
+00-03-2C   (hex)		ABB Switzerland Ltd
+00032C     (base 16)		ABB Switzerland Ltd
+				Dept. ATEP
+				Austrasse    
+				CH
+
+00-03-23   (hex)		Cornet Technology, Inc.
+000323     (base 16)		Cornet Technology, Inc.
+				6800 Versar Center, Suite 216
+				Springfield  VA  22151-4147
+				US
+
+00-03-80   (hex)		SSH Communications Security Corp.
+000380     (base 16)		SSH Communications Security Corp.
+				Fredrikinkatu 42
+				    
+				FI
+
+00-03-82   (hex)		A-One Co., Ltd.
+000382     (base 16)		A-One Co., Ltd.
+				6-9-20, Shimoichiba-cho,
+				    
+				JP
+
+00-03-7A   (hex)		Taiyo Yuden Co., Ltd.
+00037A     (base 16)		Taiyo Yuden Co., Ltd.
+				8-1 Sakae-Cho
+				    
+				JP
+
+00-03-75   (hex)		NetMedia, Inc.
+000375     (base 16)		NetMedia, Inc.
+				10940 N. Stallard Place
+				Tuscon  AZ  85737
+				US
+
+00-03-5A   (hex)		Photron Limited
+00035A     (base 16)		Photron Limited
+				1-1-8, Fujimi,
+				Chiyoda-ku    102-0071
+				JP
+
+00-03-53   (hex)		Mitac, Inc.
+000353     (base 16)		Mitac, Inc.
+				No. 2, Chung-Hsiao Street
+				Chitu  Keelung,  
+				TW
+
+00-03-56   (hex)		Wincor Nixdorf International GmbH
+000356     (base 16)		Wincor Nixdorf International GmbH
+				Heinz-Nixdorf Ring 1
+				D-33106  Paderborn  
+				DE
+
+00-03-4F   (hex)		Sur-Gard Security
+00034F     (base 16)		Sur-Gard Security
+				401 Magnetic Drive
+				Ontario    M3J 3H9
+				CA
+
+00-03-7B   (hex)		IDEC IZUMI Corporation
+00037B     (base 16)		IDEC IZUMI Corporation
+				7-31, Nishimiyahara
+				    
+				JP
+
+00-03-67   (hex)		Jasmine Networks, Inc.
+000367     (base 16)		Jasmine Networks, Inc.
+				1940 Zanker Road
+				San Jose  CA  95112
+				US
+
+00-03-6A   (hex)		Mainnet, Ltd.
+00036A     (base 16)		Mainnet, Ltd.
+				P.O. Box 2324
+				    
+				IL
+
+00-03-6B   (hex)		Cisco Systems, Inc
+00036B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-6C   (hex)		Cisco Systems, Inc
+00036C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-8F   (hex)		Weinschel Corporation
+00038F     (base 16)		Weinschel Corporation
+				5305 Spectrum Drive
+				Frederick  MD  21703
+				US
+
+00-03-84   (hex)		AETA
+000384     (base 16)		AETA
+				Kepler 6
+				Le Plessis Robinson    92350
+				FR
+
+00-03-87   (hex)		Blaze Network Products
+000387     (base 16)		Blaze Network Products
+				5180 Hacienda Drive
+				Dublin  CA  94568
+				US
+
+00-03-81   (hex)		Ingenico International
+000381     (base 16)		Ingenico International
+				1/9 Apollo Street
+				    
+				AU
+
+00-03-40   (hex)		Floware Wireless Systems, Ltd.
+000340     (base 16)		Floware Wireless Systems, Ltd.
+				28 Hacharoshet Steet
+				    60250
+				IL
+
+00-01-EC   (hex)		Ericsson Group
+0001EC     (base 16)		Ericsson Group
+				Telefonaktiebolaget
+				    
+				SE
+
+00-03-33   (hex)		Digitel Co., Ltd.
+000333     (base 16)		Digitel Co., Ltd.
+				835-6, Yoksam-dong
+				    
+				KR
+
+00-03-38   (hex)		Oak Technology
+000338     (base 16)		Oak Technology
+				139 Kifer Court
+				Sunnyvale  CA  94086-5160
+				US
+
+00-03-39   (hex)		Eurologic Systems, Ltd.
+000339     (base 16)		Eurologic Systems, Ltd.
+				Clonshaugh Industrial Estate
+				Clonshaugh  Dublin 17  
+				IE
+
+00-03-31   (hex)		Cisco Systems, Inc
+000331     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-30   (hex)		Imagenics, Co., Ltd.
+000330     (base 16)		Imagenics, Co., Ltd.
+				1-31-5 Kokuryo-Cho
+				  182-0022  
+				JP
+
+00-03-4A   (hex)		RIAS Corporation
+00034A     (base 16)		RIAS Corporation
+				46600 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-02-CF   (hex)		ZyGate Communications, Inc.
+0002CF     (base 16)		ZyGate Communications, Inc.
+				2F, No.48, Lung-Chin Road
+				    
+				TW
+
+00-02-D1   (hex)		Vivotek, Inc.
+0002D1     (base 16)		Vivotek, Inc.
+				5F-1, 168-1, Lien-Chen Rd,
+				    
+				TW
+
+00-02-C2   (hex)		Net Vision Telecom
+0002C2     (base 16)		Net Vision Telecom
+				#206 Software Support Center
+				305-343  Rep.  of Korea
+				KR
+
+00-02-B6   (hex)		Acrosser Technology Co., Ltd.
+0002B6     (base 16)		Acrosser Technology Co., Ltd.
+				No. 116-2 Guang-Fu Rd.
+				Taipei  Taipei  R.O.C.
+				TW
+
+00-02-B1   (hex)		Anritsu, Ltd.
+0002B1     (base 16)		Anritsu, Ltd.
+				Rutherford Close
+				  UNITED  KINGDOM
+				GB
+
+00-02-AD   (hex)		HOYA Corporation
+0002AD     (base 16)		HOYA Corporation
+				2-7-5 Naka-Ochiai, Shinjuku-ku,
+				  Tokyo  161-8525
+				JP
+
+00-02-AE   (hex)		Scannex Electronics Ltd.
+0002AE     (base 16)		Scannex Electronics Ltd.
+				Unit 8 English Business Park
+				Hove    BN3 7ET
+				GB
+
+00-03-04   (hex)		Pacific Broadband Communications
+000304     (base 16)		Pacific Broadband Communications
+				3103 North First St.
+				San Jose  CA  95134
+				US
+
+00-03-01   (hex)		EXFO
+000301     (base 16)		EXFO
+				400 Godin Avenue
+				Quebec   G1M 2K2    
+				CA
+
+00-02-FD   (hex)		Cisco Systems, Inc
+0002FD     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-03-00   (hex)		Barracuda Networks, Inc.
+000300     (base 16)		Barracuda Networks, Inc.
+				3175 S. Winchester Blvd
+				Campbell  CA  95008
+				US
+
+00-02-BD   (hex)		Bionet Co., Ltd.
+0002BD     (base 16)		Bionet Co., Ltd.
+				3F, Medison Venture Tower,
+				    KOREA
+				KR
+
+00-02-BE   (hex)		Totsu Engineering, Inc.
+0002BE     (base 16)		Totsu Engineering, Inc.
+				 5-16-20 Roppongi Minato-ku
+				Tokyo    106-8551
+				JP
+
+00-02-B9   (hex)		Cisco Systems, Inc
+0002B9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-BA   (hex)		Cisco Systems, Inc
+0002BA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-F9   (hex)		MIMOS Berhad
+0002F9     (base 16)		MIMOS Berhad
+				Technology Park Malaysia
+				Kuala Lumpur    57000
+				MY
+
+00-02-F3   (hex)		Media Serve Co., Ltd.
+0002F3     (base 16)		Media Serve Co., Ltd.
+				Dongsung Bldg. #17-8, Youido-dong,
+				Seoul    
+				KR
+
+00-02-EA   (hex)		Focus Enhancements
+0002EA     (base 16)		Focus Enhancements
+				1370 Dell Ave.
+				Campbell  CA  95008
+				US
+
+00-03-13   (hex)		Access Media SPA
+000313     (base 16)		Access Media SPA
+				Via delle Industrie, 4/g
+				24035 LALLIO (BG)    
+				IT
+
+00-03-10   (hex)		E-Globaledge Corporation
+000310     (base 16)		E-Globaledge Corporation
+				7F Nakameguro GT Tower 
+				 Meduro-ku, Tokyo    153-0051
+				JP
+
+00-03-0A   (hex)		Argus Technologies
+00030A     (base 16)		Argus Technologies
+				8F, No. 183, Kang Chien Rd.
+				    114
+				TW
+
+00-03-1E   (hex)		Optranet, Inc.
+00031E     (base 16)		Optranet, Inc.
+				7041 Koll Center Pkwy
+				Pleasanton  CA  94566
+				US
+
+00-03-15   (hex)		Cidco Incorporated
+000315     (base 16)		Cidco Incorporated
+				220 Cochrane Circle
+				Morgan Hill  CA  95037
+				US
+
+00-03-19   (hex)		Infineon AG
+000319     (base 16)		Infineon AG
+				P.O. Box 800949
+				    
+				DE
+
+00-02-E7   (hex)		CAB GmbH & Co KG
+0002E7     (base 16)		CAB GmbH & Co KG
+				Wilhelm-Schickard-Str 14
+				    
+				DE
+
+00-02-DF   (hex)		Net Com Systems, Inc.
+0002DF     (base 16)		Net Com Systems, Inc.
+				15-3, Yoido-Dong,
+				Seoul    
+				KR
+
+00-02-DB   (hex)		NETSEC
+0002DB     (base 16)		NETSEC
+				13505 Dulles Technology Dr., Ste. 1
+				Herdon  VA  20171
+				US
+
+00-02-4B   (hex)		Cisco Systems, Inc
+00024B     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-4D   (hex)		Mannesman Dematic Colby Pty. Ltd.
+00024D     (base 16)		Mannesman Dematic Colby Pty. Ltd.
+				24 Narabang Way
+				    
+				AU
+
+00-02-50   (hex)		Geyser Networks, Inc.
+000250     (base 16)		Geyser Networks, Inc.
+				535 Del Rey Avenue
+				Sunnyvale  CA  94086
+				US
+
+00-02-48   (hex)		Pilz GmbH & Co.
+000248     (base 16)		Pilz GmbH & Co.
+				Felix-Wankel-Straße 2
+				    
+				DE
+
+00-02-4C   (hex)		SiByte, Inc.
+00024C     (base 16)		SiByte, Inc.
+				2805 Bowers Avenue
+				Santa Clara  CA  95051-0917
+				US
+
+00-02-5A   (hex)		Catena Networks
+00025A     (base 16)		Catena Networks
+				307 Legget Drive
+				Canada  K2K  3C8
+				CA
+
+00-02-6E   (hex)		NeGeN Access, Inc.
+00026E     (base 16)		NeGeN Access, Inc.
+				33 Boston Post Rd. West
+				Marlborough  MA  01752
+				US
+
+00-02-70   (hex)		Crewave Co., Ltd.
+000270     (base 16)		Crewave Co., Ltd.
+				F7, Pureun Bldg., 28-1
+				Seoul  KOREA  137-030
+				KR
+
+00-02-3B   (hex)		Ericsson
+00023B     (base 16)		Ericsson
+				250 Holger Way
+				SAN JOSE  CA  95134
+				US
+
+00-02-39   (hex)		Visicom
+000239     (base 16)		Visicom
+				10052 Mesa Ridge Ct.
+				San Diego  CA  92121
+				US
+
+00-02-33   (hex)		Mantra Communications, Inc.
+000233     (base 16)		Mantra Communications, Inc.
+				12850 Middlebrook Road
+				Germantown  MD  20874
+				US
+
+00-02-A2   (hex)		Hilscher GmbH
+0002A2     (base 16)		Hilscher GmbH
+				Rheinstraße 15
+				    
+				DE
+
+00-02-54   (hex)		WorldGate
+000254     (base 16)		WorldGate
+				3190 Tremont Avenue
+				Trevose  PA  19053
+				US
+
+00-02-9A   (hex)		Storage Apps
+00029A     (base 16)		Storage Apps
+				3 Princess Road
+				Lawrenceville  NJ  08648
+				US
+
+00-02-8F   (hex)		Globetek, Inc.
+00028F     (base 16)		Globetek, Inc.
+				1607 Akron Peninsula Rd.
+				Akron  OH  44313-5190
+				US
+
+00-02-87   (hex)		Adapcom
+000287     (base 16)		Adapcom
+				172-A Component Drive
+				San Jose  CA  95131
+				US
+
+00-02-81   (hex)		Madge Ltd.
+000281     (base 16)		Madge Ltd.
+				Madge House
+				Maindenhead  Berkshire  SL6 2HP
+				GB
+
+00-02-63   (hex)		UPS Manufacturing SRL
+000263     (base 16)		UPS Manufacturing SRL
+				Via Giordano, 54
+				  Verona  
+				IT
+
+00-02-40   (hex)		Seedek Co., Ltd.
+000240     (base 16)		Seedek Co., Ltd.
+				#709, 1638-32, Sammo
+				    KOREA
+				KR
+
+00-01-F3   (hex)		QPS, Inc.
+0001F3     (base 16)		QPS, Inc.
+				8015 E. Crystal Drive
+				Anaheim  CA  92807
+				US
+
+00-01-E4   (hex)		Sitera, Inc.
+0001E4     (base 16)		Sitera, Inc.
+				1820 Lefthand Circle
+				Longmont  CO  80501
+				US
+
+00-01-E3   (hex)		Siemens AG
+0001E3     (base 16)		Siemens AG
+				Schlavenhorst 88
+				    
+				DE
+
+00-01-EB   (hex)		C-COM Corporation
+0001EB     (base 16)		C-COM Corporation
+				3F, No. 48, Park Ave. II SBIP
+				Hsinchu Taiwan  Hsinchu Taiwan  R.O.C.
+				TW
+
+00-01-F2   (hex)		Mark of the Unicorn, Inc.
+0001F2     (base 16)		Mark of the Unicorn, Inc.
+				1280 Massachusetts Ave.
+				Cambridge  MA  02138
+				US
+
+00-01-D9   (hex)		Sigma, Inc.
+0001D9     (base 16)		Sigma, Inc.
+				32-3 Seijyo 9 Chome
+				    
+				JP
+
+00-01-C5   (hex)		Simpler Networks
+0001C5     (base 16)		Simpler Networks
+				555 Dr Frederick Philips
+				  H4M  2X4
+				CA
+
+00-01-C9   (hex)		Cisco Systems, Inc
+0001C9     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-02-1B   (hex)		Kollmorgen-Servotronix
+00021B     (base 16)		Kollmorgen-Servotronix
+				POB 3919, Petach Tikya
+				  49130  
+				IL
+
+00-02-1E   (hex)		SIMTEL S.R.L.
+00021E     (base 16)		SIMTEL S.R.L.
+				Via Bonifacio Lupi, 25
+				    
+				IT
+
+00-02-21   (hex)		DSP Application, Ltd.
+000221     (base 16)		DSP Application, Ltd.
+				12F-12, No. 79, Sec. 1 Hsin Tai Wu Rd.
+				    TAIWAN
+				TW
+
+00-01-F7   (hex)		Image Display Systems, Inc.
+0001F7     (base 16)		Image Display Systems, Inc.
+				46560 Fremont Blvd.
+				Fremont  CA  94538
+				US
+
+00-02-00   (hex)		Net & Sys Co., Ltd.
+000200     (base 16)		Net & Sys Co., Ltd.
+				Kuro Hitech Industrial Complex 304,
+				    KOREA
+				KR
+
+00-01-C4   (hex)		NeoWave, Inc.
+0001C4     (base 16)		NeoWave, Inc.
+				10th KRIHS Bldg. 1591-6
+				  SOUTH  KOREA
+				KR
+
+00-01-C1   (hex)		Vitesse Semiconductor Corporation
+0001C1     (base 16)		Vitesse Semiconductor Corporation
+				Hoerkaer 18
+				    
+				DK
+
+00-01-D8   (hex)		Teltronics, Inc.
+0001D8     (base 16)		Teltronics, Inc.
+				4125 Keller Springs Road
+				Addison  TX  25001
+				US
+
+00-02-05   (hex)		Hitachi Denshi, Ltd.
+000205     (base 16)		Hitachi Denshi, Ltd.
+				32 Miyaki-cho Kodaira-shi
+				  JAPAN  187-8511
+				JP
+
+00-02-15   (hex)		Cotas Computer Technology A/B
+000215     (base 16)		Cotas Computer Technology A/B
+				Paludan-Mullers Vej 82
+				    
+				DK
+
+00-02-2A   (hex)		Asound Electronic
+00022A     (base 16)		Asound Electronic
+				Xianxi Industries Zone Changan Town
+				    
+				CN
+
+00-01-8C   (hex)		Mega Vision
+00018C     (base 16)		Mega Vision
+				5765 Thornwood Drive
+				Goleta  CA  93117
+				US
+
+00-01-8F   (hex)		Kenetec, Inc.
+00018F     (base 16)		Kenetec, Inc.
+				115 Hurley Road
+				Oxford  CT  06748
+				US
+
+00-01-7B   (hex)		Heidelberger Druckmaschinen AG
+00017B     (base 16)		Heidelberger Druckmaschinen AG
+				Kurfürsten-Anlage  52-60
+				    
+				DE
+
+00-01-9C   (hex)		JDS Uniphase Inc.
+00019C     (base 16)		JDS Uniphase Inc.
+				570 West Hunt Club Road
+				    
+				CA
+
+00-01-A3   (hex)		GENESYS LOGIC, INC.
+0001A3     (base 16)		GENESYS LOGIC, INC.
+				10F, No. 11, Ln.3.,
+				    
+				TW
+
+00-01-82   (hex)		DICA TECHNOLOGIES AG
+000182     (base 16)		DICA TECHNOLOGIES AG
+				Rotherstr, 19
+				    
+				DE
+
+00-01-89   (hex)		Refraction Technology, Inc.
+000189     (base 16)		Refraction Technology, Inc.
+				2626 Lombardy Lane - Ste. #105
+				Dallas  TX  75220
+				US
+
+00-01-93   (hex)		Hanbyul Telecom Co., Ltd.
+000193     (base 16)		Hanbyul Telecom Co., Ltd.
+				5th Fl. Oksan Bldg.
+				    KOREA
+				KR
+
+00-30-F5   (hex)		Wild Lab. Ltd.
+0030F5     (base 16)		Wild Lab. Ltd.
+				1-33-17-604 Harayama
+				Urawa City Saitama prif.  336-0931  
+				JP
+
+00-01-5D   (hex)		Oracle Corporation 
+00015D     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-01-73   (hex)		AMCC
+000173     (base 16)		AMCC
+				6290 Sequence Drive
+				San Diego  CA  92121
+				US
+
+00-01-6C   (hex)		FOXCONN
+00016C     (base 16)		FOXCONN
+				105 S Puente St.
+				Brea  CA  92821
+				US
+
+00-01-75   (hex)		Radiant Communications Corp.
+000175     (base 16)		Radiant Communications Corp.
+				5001 Hadley Road
+				South Plainfield  NJ  07080
+				US
+
+00-01-AF   (hex)		Artesyn Embedded Technologies
+0001AF     (base 16)		Artesyn Embedded Technologies
+				2900 S. Diablo Way
+				Tempe  AZ  85282
+				US
+
+00-01-8A   (hex)		ROI COMPUTER AG
+00018A     (base 16)		ROI COMPUTER AG
+				Werner-von-Siemens-Str. 1
+				    
+				DE
+
+00-01-92   (hex)		Texas Digital Systems
+000192     (base 16)		Texas Digital Systems
+				400 Technology Parkway
+				College Station  TX  77845
+				US
+
+00-01-5C   (hex)		CADANT INC.
+00015C     (base 16)		CADANT INC.
+				4343 Commerce Court - Ste. #207
+				Lisle  IL  60532
+				US
+
+00-01-69   (hex)		Celestix Networks Pte Ltd.
+000169     (base 16)		Celestix Networks Pte Ltd.
+				18 Tannery Lane #05-03
+				  SINGAPORE  347780
+				SG
+
+00-01-6B   (hex)		LightChip, Inc.
+00016B     (base 16)		LightChip, Inc.
+				5 Industrial Way
+				Salem  NH  03079
+				US
+
+00-01-B6   (hex)		SAEJIN T&M Co., Ltd.
+0001B6     (base 16)		SAEJIN T&M Co., Ltd.
+				2nd Fl., Saejin Bldg., 689
+				    KOREA
+				KR
+
+00-01-AB   (hex)		Main Street Networks
+0001AB     (base 16)		Main Street Networks
+				4030 Moorpark Ave.
+				San Jose  CA  95117-1849
+				US
+
+00-01-45   (hex)		WINSYSTEMS, INC.
+000145     (base 16)		WINSYSTEMS, INC.
+				715 Stadium Drive
+				Arlington  TX  76011
+				US
+
+00-01-37   (hex)		IT Farm Corporation
+000137     (base 16)		IT Farm Corporation
+				Asashiseimei Fuchu Bldg. 11F
+				  183-0055  
+				JP
+
+00-01-3C   (hex)		TIW SYSTEMS
+00013C     (base 16)		TIW SYSTEMS
+				2211 Lawson Lane
+				Santa Clara  CA  95054
+				US
+
+00-01-33   (hex)		KYOWA Electronic Instruments C
+000133     (base 16)		KYOWA Electronic Instruments C
+				3-5-1, Cyofugaoka
+				Cyofu  Tokyo  
+				JP
+
+00-01-A5   (hex)		Nextcomm, Inc.
+0001A5     (base 16)		Nextcomm, Inc.
+				12413 Willows Road NE - Ste. #210
+				Kirkland  WA  98034
+				US
+
+00-01-90   (hex)		SMK-M
+000190     (base 16)		SMK-M
+				1055 Tierra Del Rey
+				Chula Vista  CA  91910
+				US
+
+00-01-4C   (hex)		Berkeley Process Control
+00014C     (base 16)		Berkeley Process Control
+				4124 Lakeside Dr
+				Richmond  CA  94806
+				US
+
+00-01-43   (hex)		Cisco Systems, Inc
+000143     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-01-4B   (hex)		Ennovate Networks, Inc.
+00014B     (base 16)		Ennovate Networks, Inc.
+				60 Codman Hill Road
+				Boxborough  MA  01719
+				US
+
+00-01-3D   (hex)		RiscStation Ltd.
+00013D     (base 16)		RiscStation Ltd.
+				168 Elliott Street
+				  UNITED  KINGDOM
+				GB
+
+00-01-20   (hex)		OSCILLOQUARTZ S.A.
+000120     (base 16)		OSCILLOQUARTZ S.A.
+				Rue Des Brevards 16
+				2002 Neuchatel    
+				CH
+
+00-30-46   (hex)		Controlled Electronic Manageme
+003046     (base 16)		Controlled Electronic Manageme
+				Unit 4 Ravenhill Business Park
+				Belfast    
+				IE
+
+00-30-98   (hex)		Global Converging Technologies
+003098     (base 16)		Global Converging Technologies
+				1800 Preston Park Blvd.
+				Plano  TX  75093
+				US
+
+00-30-0D   (hex)		MMC Technology, Inc.
+00300D     (base 16)		MMC Technology, Inc.
+				#1502, Seoul Venture Town, Aju Bldg
+				Seoul 135-080    
+				KR
+
+00-30-75   (hex)		ADTECH
+003075     (base 16)		ADTECH
+				RUE DU VAL ST LAMBERT 191 / i
+				 SERAING    4100
+				BE
+
+00-B0-69   (hex)		Honewell Oy
+00B069     (base 16)		Honewell Oy
+				P.O. Box 168, FIN-78201
+				    
+				FI
+
+00-B0-C2   (hex)		Cisco Systems, Inc
+00B0C2     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-B0-3B   (hex)		HiQ Networks
+00B03B     (base 16)		HiQ Networks
+				2475 Augustine Drive
+				Santa Clara  CA  95054
+				US
+
+00-01-27   (hex)		OPEN Networks Pty Ltd
+000127     (base 16)		OPEN Networks Pty Ltd
+				Level 5, 342 Flinders Street
+				Melbourne    VIC 3000
+				AU
+
+00-01-0E   (hex)		Bri-Link Technologies Co., Ltd
+00010E     (base 16)		Bri-Link Technologies Co., Ltd
+				2F, No. 63, Chow-Tze Street
+				Taipei 114    
+				TW
+
+00-30-37   (hex)		Packard Bell Nec Services
+003037     (base 16)		Packard Bell Nec Services
+				299 avenue Patton, BP 645
+				49006 Angers Cedex 01    
+				FR
+
+00-30-57   (hex)		QTelNet, Inc.
+003057     (base 16)		QTelNet, Inc.
+				400 - 3115 12th Street NE
+				Calgary  Alberta  T2E 7J2
+				CA
+
+00-30-FC   (hex)		Terawave Communications, Inc.
+0030FC     (base 16)		Terawave Communications, Inc.
+				30695 Huntwood Avenue
+				Hayward  CA  94544
+				US
+
+00-B0-86   (hex)		LocSoft Limited
+00B086     (base 16)		LocSoft Limited
+				7 Bright Street
+				Clitheroe  Lancashire  BB7 1NW
+				GB
+
+00-30-A2   (hex)		Lightner Engineering
+0030A2     (base 16)		Lightner Engineering
+				8551 La Jolla Shores Dr
+				La Jolla  CA  92037
+				US
+
+00-30-42   (hex)		DeTeWe-Deutsche Telephonwerke
+003042     (base 16)		DeTeWe-Deutsche Telephonwerke
+				Zeughofstrasse 1
+				D-10997 Berlin    
+				DE
+
+00-B0-C7   (hex)		Tellabs Operations, Inc.
+00B0C7     (base 16)		Tellabs Operations, Inc.
+				One Tellabs Center
+				Naperville  IL  60563
+				US
+
+00-B0-2A   (hex)		ORSYS GmbH
+00B02A     (base 16)		ORSYS GmbH
+				Am Stadtgraben 25
+				D-88677 Markdorf    
+				DE
+
+00-01-04   (hex)		DVICO Co., Ltd.
+000104     (base 16)		DVICO Co., Ltd.
+				Kookmin Card B/D 6F 267-2
+				Sungnam-si Kyungki-do 463-050    
+				KR
+
+00-01-06   (hex)		Tews Datentechnik GmbH
+000106     (base 16)		Tews Datentechnik GmbH
+				Am Bahnhof 7
+				25469 Halstenbek    
+				DE
+
+00-01-09   (hex)		Nagano Japan Radio Co., Ltd.
+000109     (base 16)		Nagano Japan Radio Co., Ltd.
+				Shimohigano 1163, Inasato-machi
+				Nagano 381-2288    
+				JP
+
+00-02-9C   (hex)		3COM
+00029C     (base 16)		3COM
+				405 SPRING HILL ROAD
+				SHARON  NH  03458
+				US
+
+00-B0-19   (hex)		UTC CCS
+00B019     (base 16)		UTC CCS
+				791 Commerce Blvd
+				Boca Raton  FL  33497
+				US
+
+00-30-6F   (hex)		SEYEON TECH. CO., LTD.
+00306F     (base 16)		SEYEON TECH. CO., LTD.
+				NAMCHEON BLDG. 6F,
+				  KOREA  135-280
+				KR
+
+00-30-3D   (hex)		IVA CORPORATION
+00303D     (base 16)		IVA CORPORATION
+				142 NORTH RD STE R
+				SUDBURY  MA  01776
+				US
+
+00-30-F4   (hex)		STARDOT TECHNOLOGIES
+0030F4     (base 16)		STARDOT TECHNOLOGIES
+				6820-H ORANGE THORPE AVE.
+				BUENA PARK  CA  90620
+				US
+
+00-30-52   (hex)		ELASTIC NETWORKS
+003052     (base 16)		ELASTIC NETWORKS
+				6120 WINDWARD PARKWAY -STE#100
+				ALPHARETTA  GA  30005
+				US
+
+00-30-19   (hex)		Cisco Systems, Inc
+003019     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-76   (hex)		Akamba Corporation
+003076     (base 16)		Akamba Corporation
+				15595 Los Gatos Blvd.
+				Los Gatos  CA  95032
+				US
+
+00-30-EC   (hex)		BORGARDT
+0030EC     (base 16)		BORGARDT
+				DIESELSTR. 15
+				    
+				DE
+
+00-30-F3   (hex)		At Work Computers
+0030F3     (base 16)		At Work Computers
+				P.O. Box 947
+				Corvallis  OR  97339
+				US
+
+00-30-CC   (hex)		Tenor Networks, Inc.
+0030CC     (base 16)		Tenor Networks, Inc.
+				100 Nagog Park
+				Acton  MA  01720-3409
+				US
+
+00-30-B0   (hex)		Convergenet Technologies
+0030B0     (base 16)		Convergenet Technologies
+				2222 Trade Zone Boulevard
+				San Jose  CA  95131
+				US
+
+00-30-EB   (hex)		TURBONET COMMUNICATIONS, INC.
+0030EB     (base 16)		TURBONET COMMUNICATIONS, INC.
+				19F-1, NO. 171, SUNG-TEH ROAD
+				TAIPEI    
+				TW
+
+00-30-A1   (hex)		WEBGATE Inc.
+0030A1     (base 16)		WEBGATE Inc.
+				4F, Pika Bldg., 894-20, Hoyke 2-dong
+				Anyang-Si  Kyunggi-Do  
+				KR
+
+00-30-6A   (hex)		PENTA MEDIA CO., LTD.
+00306A     (base 16)		PENTA MEDIA CO., LTD.
+				E-504 Bundang Technopark,151
+				Seongnam  Gyeonggi-do  
+				KR
+
+00-30-86   (hex)		Transistor Devices, Inc.
+003086     (base 16)		Transistor Devices, Inc.
+				36A Newburgh Road
+				Hackettstown  NJ  07840
+				US
+
+00-30-44   (hex)		CradlePoint, Inc
+003044     (base 16)		CradlePoint, Inc
+				805 W. Franklin St.
+				Boise  ID  83702
+				US
+
+00-30-C2   (hex)		COMONE
+0030C2     (base 16)		COMONE
+				Parc De Marticot
+				33610 Cestas    
+				FR
+
+00-30-53   (hex)		Basler AG
+003053     (base 16)		Basler AG
+				An Der Strusbek 60-62
+				22926 Ahrensburg    
+				DE
+
+00-30-D2   (hex)		WIN TECHNOLOGIES, CO., LTD.
+0030D2     (base 16)		WIN TECHNOLOGIES, CO., LTD.
+				4F-6, No. 81, Sec. 1
+				Taipei    
+				TW
+
+00-30-59   (hex)		KONTRON COMPACT COMPUTERS AG
+003059     (base 16)		KONTRON COMPACT COMPUTERS AG
+				Nordstrasse 11/F
+				 LUTERBACH    4542
+				CH
+
+00-30-97   (hex)		AB Regin
+003097     (base 16)		AB Regin
+				Box 366
+				SE-26123  Landskrona  
+				SE
+
+00-30-5F   (hex)		Hasselblad
+00305F     (base 16)		Hasselblad
+				Hejrevej 30
+				Copenhagen  NV  DK-2400
+				DK
+
+00-30-DC   (hex)		RIGHTECH CORPORATION
+0030DC     (base 16)		RIGHTECH CORPORATION
+				4F, NO. 351, CHUNG-SHUN RD.
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-25   (hex)		CHECKOUT COMPUTER SYSTEMS, LTD
+003025     (base 16)		CHECKOUT COMPUTER SYSTEMS, LTD
+				TOWNSEND FARM ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-30-12   (hex)		DIGITAL ENGINEERING LTD.
+003012     (base 16)		DIGITAL ENGINEERING LTD.
+				2 TRENCH ROAD, MALLUSK
+				  NORTHERN  
+				IE
+
+00-30-C6   (hex)		CONTROL SOLUTIONS, INC.
+0030C6     (base 16)		CONTROL SOLUTIONS, INC.
+				201 85TH AVENUE NW
+				MINNEAPOLIS  MN  55433
+				US
+
+00-30-D6   (hex)		MSC VERTRIEBS GMBH
+0030D6     (base 16)		MSC VERTRIEBS GMBH
+				INDUSTRIESTR. 16
+				    
+				DE
+
+00-30-41   (hex)		SAEJIN T & M CO., LTD.
+003041     (base 16)		SAEJIN T & M CO., LTD.
+				2ND FL., SAEJIN BLDG. 689
+				  135-230  KOREA
+				KR
+
+00-30-8C   (hex)		Quantum Corporation
+00308C     (base 16)		Quantum Corporation
+				10125 Federal Drive
+				Colorado Springs  CO  80908
+				US
+
+00-30-E3   (hex)		SEDONA NETWORKS CORP.
+0030E3     (base 16)		SEDONA NETWORKS CORP.
+				10A HEARST WAY
+				CANADA  K2L  2P4
+				CA
+
+00-30-BF   (hex)		MULTIDATA GMBH
+0030BF     (base 16)		MULTIDATA GMBH
+				Dieburger Str. 96a
+				    
+				DE
+
+00-D0-0F   (hex)		SPEECH DESIGN GMBH
+00D00F     (base 16)		SPEECH DESIGN GMBH
+				INDUSTRIESTR. 1
+				    
+				DE
+
+00-30-58   (hex)		API MOTION
+003058     (base 16)		API MOTION
+				45 HAZELWOOD DRIVE
+				AMHERST  NY  14228
+				US
+
+00-30-34   (hex)		SET ENGINEERING
+003034     (base 16)		SET ENGINEERING
+				15750 VINEYARD BLVD. STE. #100
+				MORGAN HILL  CA  95037
+				US
+
+00-30-4A   (hex)		Fraunhofer IPMS
+00304A     (base 16)		Fraunhofer IPMS
+				Maria-Reiche-Strasse 2
+				Dresden    01109
+				DE
+
+00-30-8D   (hex)		Pinnacle Systems, Inc.
+00308D     (base 16)		Pinnacle Systems, Inc.
+				Frankfurter Str. 3c
+				D-38122  Braunschweig  
+				DE
+
+00-30-A6   (hex)		VIANET TECHNOLOGIES, LTD.
+0030A6     (base 16)		VIANET TECHNOLOGIES, LTD.
+				8 HACHARASH STREET
+				    
+				IL
+
+00-D0-BF   (hex)		PIVOTAL TECHNOLOGIES
+00D0BF     (base 16)		PIVOTAL TECHNOLOGIES
+				70 S. LAKE AVENUE - STE. #900
+				PASADENA  CA  91101
+				US
+
+00-30-3C   (hex)		ONNTO CORP.
+00303C     (base 16)		ONNTO CORP.
+				12F-2,  NO. 161
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-30-24   (hex)		Cisco Systems, Inc
+003024     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-30-F6   (hex)		SECURELOGIX CORPORATION
+0030F6     (base 16)		SECURELOGIX CORPORATION
+				13750 SAN PEDRO
+				SAN ANTONIO  TX  78232
+				US
+
+00-D0-2F   (hex)		VLSI TECHNOLOGY INC.
+00D02F     (base 16)		VLSI TECHNOLOGY INC.
+				8375 S. RIVER PARKWAY
+				TEMPE  AZ  85284
+				US
+
+00-30-D8   (hex)		SITEK
+0030D8     (base 16)		SITEK
+				VIA MONTE FIORINO 9
+				    
+				IT
+
+00-30-16   (hex)		ISHIDA CO., LTD.
+003016     (base 16)		ISHIDA CO., LTD.
+				959-1 SHIMOMAGARI
+				    
+				JP
+
+00-D0-B1   (hex)		OMEGA ELECTRONICS SA
+00D0B1     (base 16)		OMEGA ELECTRONICS SA
+				ROUTE DE SOLEURE 68
+				    
+				CH
+
+00-D0-16   (hex)		SCM MICROSYSTEMS, INC.
+00D016     (base 16)		SCM MICROSYSTEMS, INC.
+				160 KNOWLES DRIVE
+				LOS GATOS  CA  95032
+				US
+
+00-D0-43   (hex)		ZONAL RETAIL DATA SYSTEMS
+00D043     (base 16)		ZONAL RETAIL DATA SYSTEMS
+				24 FORTH STREET
+				    SCOTLAND
+				GB
+
+00-D0-C1   (hex)		HARMONIC DATA SYSTEMS, LTD.
+00D0C1     (base 16)		HARMONIC DATA SYSTEMS, LTD.
+				10 BEIT SHAMAI STREET
+				  ISRAEL  67018
+				IL
+
+00-D0-AC   (hex)		Commscope, Inc
+00D0AC     (base 16)		Commscope, Inc
+				140 Vista Centre Drive
+				Forest  VA  24551
+				US
+
+00-D0-7C   (hex)		KOYO ELECTRONICS INC. CO.,LTD.
+00D07C     (base 16)		KOYO ELECTRONICS INC. CO.,LTD.
+				1-171 TENJIN-CHO KODAIRA
+				    
+				JP
+
+00-D0-BC   (hex)		Cisco Systems, Inc
+00D0BC     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-CB   (hex)		DASAN CO., LTD.
+00D0CB     (base 16)		DASAN CO., LTD.
+				DASAN Tower 7F, 49 Daewangpangyo-ro644beon-gil
+				Seonggnam-Si  Gyeoenggi-do  463-4000
+				KR
+
+00-D0-19   (hex)		DAINIPPON SCREEN CORPORATE
+00D019     (base 16)		DAINIPPON SCREEN CORPORATE
+				REPRESENTATIVES OF AMERICA,INC
+				IRVINE  CA  92614
+				US
+
+00-D0-35   (hex)		BEHAVIOR TECH. COMPUTER CORP.
+00D035     (base 16)		BEHAVIOR TECH. COMPUTER CORP.
+				20F-B, No.98, Sec. 1,
+				Sijhih City  Taipei County  22102
+				TW
+
+00-D0-DB   (hex)		MCQUAY INTERNATIONAL
+00D0DB     (base 16)		MCQUAY INTERNATIONAL
+				13600 INDUSTRIAL PARK BLVD.
+				MINNEAPOLIS  MN  55441
+				US
+
+00-D0-70   (hex)		LONG WELL ELECTRONICS CORP.
+00D070     (base 16)		LONG WELL ELECTRONICS CORP.
+				4F, NO. 59-1, TSAO DI WEI
+				TAIWAN 222  TAIWAN 222  R.O.C.
+				TW
+
+00-D0-29   (hex)		WAKEFERN FOOD CORPORATION
+00D029     (base 16)		WAKEFERN FOOD CORPORATION
+				230 RARITAN CENTER PARKWAY
+				EDISON  NJ  08837
+				US
+
+00-D0-C3   (hex)		VIVID TECHNOLOGY PTE, LTD.
+00D0C3     (base 16)		VIVID TECHNOLOGY PTE, LTD.
+				1003 BUKIT MERAH CENTRAL
+				    
+				SG
+
+00-D0-13   (hex)		PRIMEX AEROSPACE COMPANY
+00D013     (base 16)		PRIMEX AEROSPACE COMPANY
+				P.O. BOX 97009
+				REDMOND  WA  98073-9709
+				US
+
+00-D0-A3   (hex)		VOCAL DATA, INC.
+00D0A3     (base 16)		VOCAL DATA, INC.
+				1701 N GREENVILLE #304
+				RICHARDSON  TX  75081
+				US
+
+00-D0-7E   (hex)		KEYCORP LTD.
+00D07E     (base 16)		KEYCORP LTD.
+				P.O. BOX 199
+				    
+				AU
+
+00-D0-20   (hex)		AIM SYSTEM, INC.
+00D020     (base 16)		AIM SYSTEM, INC.
+				4TH FLOOR CHUNGWOO B/D 219-1
+				    KOREA
+				KR
+
+00-D0-C8   (hex)		Prevas A/S
+00D0C8     (base 16)		Prevas A/S
+				Lyskær 3EF
+				DK-2730  Herlev  
+				DK
+
+00-50-17   (hex)		RSR S.R.L.
+005017     (base 16)		RSR S.R.L.
+				VIA SINIGAGLIA, 38
+				  22075  
+				IT
+
+00-50-65   (hex)		TDK-Lambda Corporation
+005065     (base 16)		TDK-Lambda Corporation
+				36-1 Kasuminosato
+				Ami-Machi  Inashiki-Gun Ibaraki,  300-0396
+				JP
+
+00-50-B9   (hex)		XITRON TECHNOLOGIES, INC.
+0050B9     (base 16)		XITRON TECHNOLOGIES, INC.
+				6295-D FERRIS SQUARE
+				SAN DIEGO  CA  92121
+				US
+
+00-50-6B   (hex)		SPX-ATEG
+00506B     (base 16)		SPX-ATEG
+				802 S. MAIN STREET
+				WAYLAND  MI  49348
+				US
+
+00-D0-76   (hex)		Bank of America
+00D076     (base 16)		Bank of America
+				1100 Merrill Drive
+				Pennington  NJ  08534
+				US
+
+00-D0-51   (hex)		O2 MICRO, INC.
+00D051     (base 16)		O2 MICRO, INC.
+				2901 TASMAN DRIVE, STE.#205
+				SANTA CLARA  CA  95054
+				US
+
+00-D0-BB   (hex)		Cisco Systems, Inc
+00D0BB     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-6E   (hex)		TRENDVIEW RECORDERS LTD.
+00D06E     (base 16)		TRENDVIEW RECORDERS LTD.
+				4 AIRFIELD WAY
+				  UNITED  KINGDOM
+				GB
+
+00-D0-5C   (hex)		KATHREIN TechnoTrend GmbH
+00D05C     (base 16)		KATHREIN TechnoTrend GmbH
+				Ing.- Anton-Kathrein Str. 2
+				    
+				DE
+
+00-D0-EA   (hex)		NEXTONE COMMUNICATIONS, INC.
+00D0EA     (base 16)		NEXTONE COMMUNICATIONS, INC.
+				9700 GREAT SENECA HGHWY
+				ROCKVILLE  MD  20850
+				US
+
+00-D0-64   (hex)		MULTITEL
+00D064     (base 16)		MULTITEL
+				2905 RUE DE CELLES
+				CANADA  CANADA  G2C-1W7
+				CA
+
+00-D0-5E   (hex)		STRATABEAM TECHNOLOGY, INC.
+00D05E     (base 16)		STRATABEAM TECHNOLOGY, INC.
+				1943 LANDINGS DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-D0-AA   (hex)		CHASE COMMUNICATIONS
+00D0AA     (base 16)		CHASE COMMUNICATIONS
+				ST. LEONARDS ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-D0-5D   (hex)		INTELLIWORXX, INC.
+00D05D     (base 16)		INTELLIWORXX, INC.
+				1819 MAIN STREET,  STE #1101
+				SARASOTA  FL  34236
+				US
+
+00-D0-A1   (hex)		OSKAR VIERLING GMBH + CO. KG
+00D0A1     (base 16)		OSKAR VIERLING GMBH + CO. KG
+				PRETZFELDER STR. 21
+				    
+				DE
+
+00-D0-06   (hex)		Cisco Systems, Inc
+00D006     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-2A   (hex)		Voxent Systems Ltd.
+00D02A     (base 16)		Voxent Systems Ltd.
+				Unit 2, Rowan House
+				Chippenham  Wiltshire  SN14 0SQ
+				GB
+
+00-D0-8F   (hex)		ARDENT TECHNOLOGIES, INC.
+00D08F     (base 16)		ARDENT TECHNOLOGIES, INC.
+				250 N. WOLFE ROAD
+				SUNNYVALE  CA  94086
+				US
+
+00-D0-FA   (hex)		Thales e-Security Ltd.
+00D0FA     (base 16)		Thales e-Security Ltd.
+				Meadow View House, Crendon Industrial Estate
+				Aylesbury  Buckinghamshire  HP18 9EQ
+				GB
+
+00-D0-EB   (hex)		LIGHTERA NETWORKS, INC.
+00D0EB     (base 16)		LIGHTERA NETWORKS, INC.
+				10201 BUBB ROAD
+				CUPERTINO  CA  95014
+				US
+
+00-50-A1   (hex)		CARLO GAVAZZI, INC.
+0050A1     (base 16)		CARLO GAVAZZI, INC.
+				222 PENNBRIGHT DR. - STE.#210
+				HOUSTON  TX  77090
+				US
+
+00-D0-C0   (hex)		Cisco Systems, Inc
+00D0C0     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-D0-68   (hex)		IWILL CORPORATION
+00D068     (base 16)		IWILL CORPORATION
+				NO.10, WU-CHUAN 3 RD,
+				    TAIWAN
+				TW
+
+00-50-29   (hex)		1394 PRINTER WORKING GROUP
+005029     (base 16)		1394 PRINTER WORKING GROUP
+				P.O. BOX 23158
+				SAN JOSE  CA  95153
+				US
+
+00-50-81   (hex)		MURATA MACHINERY, LTD.
+005081     (base 16)		MURATA MACHINERY, LTD.
+				136, TAKEDA-MUKAISHIRO-CHO
+				FUSHIMI-KU, KYOTO 612-8686    
+				JP
+
+00-50-AC   (hex)		MAPLE COMPUTER CORPORATION
+0050AC     (base 16)		MAPLE COMPUTER CORPORATION
+				2F, NO. 184, SEC. 2
+				Taipei    
+				TJ
+
+00-50-49   (hex)		Arbor Networks Inc
+005049     (base 16)		Arbor Networks Inc
+				6 Omni Way
+				Chelmsford  MA  01824
+				US
+
+00-50-0D   (hex)		SATORI ELECTORIC CO., LTD.
+00500D     (base 16)		SATORI ELECTORIC CO., LTD.
+				TIGUSADAI 38-8  MIDORI-KU
+				YOKOHAMA, KANAGAWA    
+				JP
+
+00-50-A3   (hex)		TransMedia Communications, Inc.
+0050A3     (base 16)		TransMedia Communications, Inc.
+				20 GREAT OAKS BLVD., #210
+				SAN JOSE  CA  95119
+				US
+
+00-50-A4   (hex)		IO TECH, INC.
+0050A4     (base 16)		IO TECH, INC.
+				25971 CANNON ROAD
+				CLEVELAND  OH  44146
+				US
+
+00-50-5C   (hex)		TUNDO CORPORATION
+00505C     (base 16)		TUNDO CORPORATION
+				7 GIBOREI ISRAEL STREET
+				    
+				IL
+
+00-50-B3   (hex)		VOICEBOARD CORPORATION
+0050B3     (base 16)		VOICEBOARD CORPORATION
+				3151 WEST FIFTH STREET
+				OXNARD  CA  93030
+				US
+
+00-50-8C   (hex)		RSI SYSTEMS
+00508C     (base 16)		RSI SYSTEMS
+				5555 W. 78TH STREET, Suite F
+				EDINA  MN  55439
+				US
+
+00-50-E1   (hex)		NS TECH ELECTRONICS SDN BHD
+0050E1     (base 16)		NS TECH ELECTRONICS SDN BHD
+				No. 37, Lorong 23, Geylang
+				Singapore 388371    
+				SG
+
+00-50-DE   (hex)		SIGNUM SYSTEMS CORP.
+0050DE     (base 16)		SIGNUM SYSTEMS CORP.
+				1211 Flynn Rd,
+				Camarillo  CA  93021
+				US
+
+00-50-75   (hex)		KESTREL SOLUTIONS
+005075     (base 16)		KESTREL SOLUTIONS
+				2370 CHARLESTON ROAD
+				MT. VIEW  CA  94043
+				US
+
+00-50-ED   (hex)		ANDA NETWORKS
+0050ED     (base 16)		ANDA NETWORKS
+				2921 COPPER ROAD
+				SANTA CLARA  CA  95051
+				US
+
+00-50-96   (hex)		SALIX TECHNOLOGIES, INC.
+005096     (base 16)		SALIX TECHNOLOGIES, INC.
+				904 WIND RIVER LANE- STE. #101
+				GAITHERSBURG  MD  20878
+				US
+
+00-50-12   (hex)		CBL - GMBH
+005012     (base 16)		CBL - GMBH
+				DARMSTAEDTER STR. 81
+				D-64839 MUENSTER    
+				DE
+
+00-50-F2   (hex)		MICROSOFT CORP.
+0050F2     (base 16)		MICROSOFT CORP.
+				ONE MICROSOFT WAY
+				REDMOND  WA  98052-6399
+				US
+
+00-50-4A   (hex)		ELTECO A.S.
+00504A     (base 16)		ELTECO A.S.
+				ROSINSKA CESTA  P.O. BOX C-9
+				    
+				SK
+
+00-50-C1   (hex)		GEMFLEX NETWORKS, LTD.
+0050C1     (base 16)		GEMFLEX NETWORKS, LTD.
+				230-6651 FRASERWOOD PL.
+				CANADA  V6W  1J3
+				CA
+
+00-50-CF   (hex)		VANLINK COMMUNICATION TECHNOLOGY RESEARCH INSTITUTE
+0050CF     (base 16)		VANLINK COMMUNICATION TECHNOLOGY RESEARCH INSTITUTE
+				210 YADI OFFICE BUILDING
+				BEIJING 100088    
+				CN
+
+00-50-24   (hex)		NAVIC SYSTEMS, INC.
+005024     (base 16)		NAVIC SYSTEMS, INC.
+				74 CRESCENT STREET
+				  NEEDHAM  MA
+				US
+
+00-90-BD   (hex)		OMNIA COMMUNICATIONS, INC.
+0090BD     (base 16)		OMNIA COMMUNICATIONS, INC.
+				100 NICKERSON ROAD
+				MARLBOROUGH  MA  01752
+				US
+
+00-90-B4   (hex)		WILLOWBROOK TECHNOLOGIES
+0090B4     (base 16)		WILLOWBROOK TECHNOLOGIES
+				7120 HAYVENHURST AVE.-STE.#401
+				VAN NUYS  CA  91406
+				US
+
+00-90-03   (hex)		APLIO
+009003     (base 16)		APLIO
+				18 Avenue Du 8 Mai 1945
+				    
+				FR
+
+00-90-31   (hex)		MYSTICOM, LTD.
+009031     (base 16)		MYSTICOM, LTD.
+				P.O. 8364
+				NATANIA 42504    
+				IL
+
+00-90-9D   (hex)		NovaTech Process Solutions, LLC
+00909D     (base 16)		NovaTech Process Solutions, LLC
+				11500 Cronridge Drive
+				Owings Mills  MD  21117
+				US
+
+00-90-DD   (hex)		MIHARU COMMUNICATIONS Inc
+0090DD     (base 16)		MIHARU COMMUNICATIONS Inc
+				
+				KANAGAWA    
+				JP
+
+00-90-28   (hex)		NIPPON SIGNAL CO., LTD.
+009028     (base 16)		NIPPON SIGNAL CO., LTD.
+				11 HIRAIDE-KOGIO-DANCHI
+				UISUNOMIYA TOCHIGI 321-8651    
+				JP
+
+00-90-7D   (hex)		Lake Communications
+00907D     (base 16)		Lake Communications
+				1 Westbrook, Milton Road
+				    
+				IE
+
+00-90-C9   (hex)		DPAC Technologies
+0090C9     (base 16)		DPAC Technologies
+				7321 Lincoln Way
+				Garden Grove  CA  92841
+				US
+
+00-50-7B   (hex)		MERLOT COMMUNICATIONS
+00507B     (base 16)		MERLOT COMMUNICATIONS
+				BERKSHIRE CORPORATE PARK
+				BETHEL  CT  06801
+				US
+
+00-50-CD   (hex)		DIGIANSWER A/S
+0050CD     (base 16)		DIGIANSWER A/S
+				SKALHUSE 5
+				    
+				DK
+
+00-50-2D   (hex)		ACCEL, INC.
+00502D     (base 16)		ACCEL, INC.
+				1F, NO. 7, R&D 1ST ROAD
+				HSINCHU    
+				TW
+
+00-50-3A   (hex)		DATONG ELECTRONICS LTD.
+00503A     (base 16)		DATONG ELECTRONICS LTD.
+				CLAYTON WOOD CLOSE
+				Leeds LS16 6QE    
+				GB
+
+00-50-87   (hex)		TERASAKI ELECTRIC CO., LTD.
+005087     (base 16)		TERASAKI ELECTRIC CO., LTD.
+				7-2-10 HANNAN-CHO ABENO-KU
+				OSAKA, 545-0021    
+				JP
+
+00-50-26   (hex)		COSYSTEMS, INC.
+005026     (base 16)		COSYSTEMS, INC.
+				1263 OAKMEAD PARKWAY
+				SUNNYVALE  CA  94086
+				US
+
+00-90-2C   (hex)		DATA & CONTROL EQUIPMENT LTD.
+00902C     (base 16)		DATA & CONTROL EQUIPMENT LTD.
+				COUNTY FARM, WENDOVER RD.
+				BUCKS. HP22 STA    
+				GB
+
+00-90-1D   (hex)		PEC (NZ) LTD.
+00901D     (base 16)		PEC (NZ) LTD.
+				2 STATION ROAD
+				MARTON    
+				NZ
+
+00-90-97   (hex)		Sycamore Networks
+009097     (base 16)		Sycamore Networks
+				220 Mill Rd
+				Chelmsford  MA  01824
+				US
+
+00-90-25   (hex)		BAE Systems Australia (Electronic Systems) Pty Ltd
+009025     (base 16)		BAE Systems Australia (Electronic Systems) Pty Ltd
+				2 Second Ave
+				Mawson Lakes  South Australia  5095
+				AU
+
+00-90-4C   (hex)		Epigram, Inc.
+00904C     (base 16)		Epigram, Inc.
+				870 West Maude Ave.
+				Sunnyvale  CA  94086
+				US
+
+00-90-84   (hex)		ATECH SYSTEM
+009084     (base 16)		ATECH SYSTEM
+				4F DAEBOONG BLDG. 1451-78
+				 SEOUL  137-070    
+				KR
+
+00-90-6A   (hex)		TURNSTONE SYSTEMS, INC.
+00906A     (base 16)		TURNSTONE SYSTEMS, INC.
+				274 Ferguson Drive
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-90-87   (hex)		ITIS
+009087     (base 16)		ITIS
+				CENTRE ESPACE PERFORMANCE
+				35769 SAINT-GREGOIRE CEDEX    
+				FR
+
+00-90-51   (hex)		ULTIMATE TECHNOLOGY CORP.
+009051     (base 16)		ULTIMATE TECHNOLOGY CORP.
+				100 RAWSON ROAD
+				VICTOR  NY  14564
+				US
+
+00-90-26   (hex)		ADVANCED SWITCHING COMMUNICATIONS, INC.
+009026     (base 16)		ADVANCED SWITCHING COMMUNICATIONS, INC.
+				8330 BOONE BOULEVARD--5TH FL.
+				VIENNA  VA  22182
+				US
+
+00-90-D3   (hex)		GIESECKE & DEVRIENT GmbH
+0090D3     (base 16)		GIESECKE & DEVRIENT GmbH
+				PRINZREGENTENSTRASSE 159
+				D-81677  MUNCHEN    
+				DE
+
+00-90-67   (hex)		WalkAbout Computers, Inc.
+009067     (base 16)		WalkAbout Computers, Inc.
+				2655 N. OCEAN DRIVE--STE. #510
+				SINGER ISLAND  FL  33404
+				US
+
+00-90-2A   (hex)		COMMUNICATION DEVICES, INC.
+00902A     (base 16)		COMMUNICATION DEVICES, INC.
+				85 Fulton Street
+				Boonton  NJ  07005-1912
+				US
+
+00-90-0D   (hex)		Overland Storage Inc.
+00900D     (base 16)		Overland Storage Inc.
+				9112 Spectrum Center Blvd
+				SAN DIEGO  CA  92123
+				US
+
+00-90-CF   (hex)		NORTEL
+0090CF     (base 16)		NORTEL
+				250 SIDNEY STREET
+				Belleville  Ontario K8N 5B7  
+				CA
+
+00-90-72   (hex)		SIMRAD AS
+009072     (base 16)		SIMRAD AS
+				P.O. BOX 111
+				  3191 HORTEN  
+				NO
+
+00-90-2F   (hex)		NETCORE SYSTEMS, INC.
+00902F     (base 16)		NETCORE SYSTEMS, INC.
+				187 BALLARDVALE STREET
+				WILMINGTON  MA  01887
+				US
+
+00-90-98   (hex)		SBC DESIGNS, INC.
+009098     (base 16)		SBC DESIGNS, INC.
+				3077-H LEEMAN FERRY ROAD
+				HUNTSVILLE  AL  35801
+				US
+
+00-90-45   (hex)		Marconi Communications
+009045     (base 16)		Marconi Communications
+				1000 Fore Drive
+				Warrendale  PA  15086-7502
+				US
+
+00-90-36   (hex)		ens, inc.
+009036     (base 16)		ens, inc.
+				P.O. BOX 19207
+				RALEIGH  NC  27619
+				US
+
+00-90-8B   (hex)		Tattile SRL
+00908B     (base 16)		Tattile SRL
+				2600 Fernbrook Lane
+				Plymouth  MN  55447
+				US
+
+00-90-44   (hex)		ASSURED DIGITAL, INC.
+009044     (base 16)		ASSURED DIGITAL, INC.
+				9-11 GOLDSMITH ST.
+				LITTLETON  MA  01460
+				US
+
+00-90-91   (hex)		DigitalScape, Inc.
+009091     (base 16)		DigitalScape, Inc.
+				6 MORGAN  - STE.#100
+				IRVINE  CA  92618
+				US
+
+00-90-7E   (hex)		VETRONIX CORP.
+00907E     (base 16)		VETRONIX CORP.
+				2030 ALAMEDE PADRE SERRA
+				SANTA BARBARA  CA  93103
+				US
+
+00-90-50   (hex)		Teleste Corporation
+009050     (base 16)		Teleste Corporation
+				Telestenkatu 1
+				LITTOINEN    FI-20660
+				FI
+
+00-90-4D   (hex)		SPEC S.A.
+00904D     (base 16)		SPEC S.A.
+				CASP 172 3-B
+				08013 BARCELONA    
+				ES
+
+00-90-FD   (hex)		CopperCom, Inc.
+0090FD     (base 16)		CopperCom, Inc.
+				3255-1 SCOTT BLVD.,--STE.#103
+				SANTA CLARA  CA  95054
+				US
+
+00-90-39   (hex)		SHASTA NETWORKS
+009039     (base 16)		SHASTA NETWORKS
+				249 HUMBOLDT COURT
+				SUNNYVALE  CA  94089-1300
+				US
+
+00-90-FC   (hex)		NETWORK COMPUTING DEVICES
+0090FC     (base 16)		NETWORK COMPUTING DEVICES
+				301 RAVENDALE DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-90-14   (hex)		ROTORK INSTRUMENTS, LTD.
+009014     (base 16)		ROTORK INSTRUMENTS, LTD.
+				CHAUL END LANE
+				LU4 8EZ  England  
+				GB
+
+00-90-8D   (hex)		VICKERS ELECTRONICS SYSTEMS
+00908D     (base 16)		VICKERS ELECTRONICS SYSTEMS
+				1151 W. MASON-MORROW RD.
+				LEBANON  OH  45036
+				US
+
+00-90-42   (hex)		ECCS, Inc.
+009042     (base 16)		ECCS, Inc.
+				ONE SHEILA DRIVE
+				TINTON FALLS  NJ  07724
+				US
+
+00-90-33   (hex)		INNOVAPHONE AG
+009033     (base 16)		INNOVAPHONE AG
+				Boeblinger Str. 76
+				SINDELFINGEN    D71065
+				DE
+
+00-90-02   (hex)		ALLGON AB
+009002     (base 16)		ALLGON AB
+				GARDATORGET 1
+				412 50 GOTEBORG    
+				SE
+
+00-10-D4   (hex)		STORAGE COMPUTER CORPORATION
+0010D4     (base 16)		STORAGE COMPUTER CORPORATION
+				11 RIVERSIDE STREET
+				NASHUA  NH  03062
+				US
+
+00-06-29   (hex)		IBM Corp
+000629     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-10-A9   (hex)		ADHOC TECHNOLOGIES
+0010A9     (base 16)		ADHOC TECHNOLOGIES
+				1150 FIRST STREET
+				SAN JOSE  CA  95112
+				US
+
+00-10-8A   (hex)		TeraLogic, Inc.
+00108A     (base 16)		TeraLogic, Inc.
+				707 CALIFORNIA STREET
+				MOUNTAIN VIEW  CA  94041
+				US
+
+00-10-24   (hex)		NAGOYA ELECTRIC WORKS CO., LTD
+001024     (base 16)		NAGOYA ELECTRIC WORKS CO., LTD
+				29-1 SHINODA, MIWA-CHO
+				AMA-GUN, AICHI 490-12    
+				JP
+
+00-10-D6   (hex)		Exelis
+0010D6     (base 16)		Exelis
+				7310 Innovation Blvd., M/S 536
+				Ft Wayne  IN  46818
+				US
+
+00-10-48   (hex)		HTRC AUTOMATION, INC.
+001048     (base 16)		HTRC AUTOMATION, INC.
+				285 LAVAL STREET
+				QUEBEC J0B 1H0    
+				CA
+
+00-10-97   (hex)		WinNet Metropolitan Communications Systems, Inc.
+001097     (base 16)		WinNet Metropolitan Communications Systems, Inc.
+				661 EAST ARQUES AVE.
+				SUNNYVALE  CA  94086
+				US
+
+00-10-85   (hex)		POLARIS COMMUNICATIONS, INC.
+001085     (base 16)		POLARIS COMMUNICATIONS, INC.
+				10200 SW ALLEN BLVD.
+				BEAVERTON  OR  97005
+				US
+
+00-10-0C   (hex)		ITO CO., LTD.
+00100C     (base 16)		ITO CO., LTD.
+				8-2 MIYANOSHITA-CHO
+				HIRAKATA-CITY, OSAKA    
+				JP
+
+00-10-06   (hex)		Thales Contact Solutions Ltd.
+001006     (base 16)		Thales Contact Solutions Ltd.
+				Tolbar Way
+				Southampton, SO30 2ZP    
+				GB
+
+00-90-09   (hex)		I Controls, Inc.
+009009     (base 16)		I Controls, Inc.
+				2nd Fl, I'Park 302, 11 Jeongja-Dong,
+				Seongnam  Gyeonggi-Do  463-859
+				KR
+
+00-90-8E   (hex)		Nortel Networks Broadband Access
+00908E     (base 16)		Nortel Networks Broadband Access
+				39660 Eureka Drive
+				Newark  CA  94560
+				US
+
+00-90-7C   (hex)		DIGITALCAST, INC.
+00907C     (base 16)		DIGITALCAST, INC.
+				503, ILKWANG BLDG., 1656-2
+				SEOCHO-KU   SEOUL  
+				KR
+
+00-90-D2   (hex)		ARTEL VIDEO SYSTEMS
+0090D2     (base 16)		ARTEL VIDEO SYSTEMS
+				237 CEDAR HILL ST.
+				MARLBORO  MA  01752
+				US
+
+00-01-FE   (hex)		DIGITAL EQUIPMENT CORPORATION
+0001FE     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				301 ROCKRIMMON BLVD, SOUTH
+				COLORADO SPRINGS  CO  80919
+				US
+
+00-90-BE   (hex)		IBC/INTEGRATED BUSINESS COMPUTERS
+0090BE     (base 16)		IBC/INTEGRATED BUSINESS COMPUTERS
+				2685 C PARK CENTER DRIVE
+				SIMI VALLEY  CA  93065
+				US
+
+00-10-3C   (hex)		IC ENSEMBLE, INC.
+00103C     (base 16)		IC ENSEMBLE, INC.
+				3255-2 SCOTT BLVD.--STE.#105
+				SANTA CLARA  CA  95054
+				US
+
+00-10-19   (hex)		SIRONA DENTAL SYSTEMS GmbH & Co. KG
+001019     (base 16)		SIRONA DENTAL SYSTEMS GmbH & Co. KG
+				FABRIKSTRASSE 31
+				64625 BENSHEIM    
+				DE
+
+00-90-DE   (hex)		CARDKEY SYSTEMS, INC.
+0090DE     (base 16)		CARDKEY SYSTEMS, INC.
+				1757 TAPO CANYON ROAD
+				SIMI VALLEY  CA  93063
+				US
+
+00-90-6B   (hex)		APPLIED RESOURCES, INC.
+00906B     (base 16)		APPLIED RESOURCES, INC.
+				9821 WIDMER ROAD
+				LENEXA  KS  66215-1239
+				US
+
+00-10-E2   (hex)		ArrayComm, Inc.
+0010E2     (base 16)		ArrayComm, Inc.
+				3141 ZANKER ROAD
+				SAN JOSE  CA  95134
+				US
+
+00-10-D2   (hex)		NITTO TSUSHINKI CO., LTD
+0010D2     (base 16)		NITTO TSUSHINKI CO., LTD
+				7-27-11, TODOROKI, SETAGAYA-KU
+				TOKYO 151    
+				JP
+
+00-10-D9   (hex)		IBM JAPAN, FUJISAWA MT+D
+0010D9     (base 16)		IBM JAPAN, FUJISAWA MT+D
+				KIRIHARA-CHO 1, FUJISAWA CITY
+				KANAGAWA 252    
+				JP
+
+00-90-66   (hex)		Troika Networks, Inc.
+009066     (base 16)		Troika Networks, Inc.
+				2829 Townsgate Road,
+				Westlake Village  CA  91361
+				US
+
+00-10-94   (hex)		Performance Analysis Broadband, Spirent plc
+001094     (base 16)		Performance Analysis Broadband, Spirent plc
+				27349 Agoura Road
+				Calabasas Hills  CA  91301
+				US
+
+00-10-50   (hex)		RION CO., LTD.
+001050     (base 16)		RION CO., LTD.
+				3-20-41 HIGASHIMOTOMACHI
+				KOKUBUNJI, TOKYO 185    
+				JP
+
+00-10-9C   (hex)		M-SYSTEM CO., LTD.
+00109C     (base 16)		M-SYSTEM CO., LTD.
+				1-1-25 SHIN URASHIMA CHOU
+				 YOKOHAMA 221    
+				JP
+
+00-10-CE   (hex)		VOLAMP, LTD.
+0010CE     (base 16)		VOLAMP, LTD.
+				UNIT 3 RIVERSIDE BUSINESS PARK
+				FARNHAM, SURREY  ENGLAND  
+				GB
+
+00-10-B2   (hex)		COACTIVE AESTHETICS
+0010B2     (base 16)		COACTIVE AESTHETICS
+				4000 BRIDGEWAY - STE. #303
+				SAUSALITA  CA  94965
+				US
+
+00-10-5F   (hex)		ZODIAC DATA SYSTEMS
+00105F     (base 16)		ZODIAC DATA SYSTEMS
+				5 Av Des Andes
+				Les Ulis    91940
+				FR
+
+00-10-3E   (hex)		NETSCHOOLS CORPORATION
+00103E     (base 16)		NETSCHOOLS CORPORATION
+				2003 LANDINGS DRIVE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-10-CB   (hex)		FACIT K.K.
+0010CB     (base 16)		FACIT K.K.
+				HIMEI NIHOMBASHI BLDG. 3F
+				CHUO-KU, TOKYO 103    
+				JP
+
+00-10-E0   (hex)		Oracle Corporation 
+0010E0     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-10-7C   (hex)		P-COM, INC.
+00107C     (base 16)		P-COM, INC.
+				3175 S. WINCHESTER BLVD.
+				CAMPBELL  CA  95008
+				US
+
+00-10-BD   (hex)		THE TELECOMMUNICATION TECHNOLOGY COMMITTEE (TTC)
+0010BD     (base 16)		THE TELECOMMUNICATION TECHNOLOGY COMMITTEE (TTC)
+				1-1-12 Shiba Kouen, Minato-ku
+				MINATO-KU,    TOKYO  105-0011
+				JP
+
+00-10-08   (hex)		VIENNA SYSTEMS CORPORATION
+001008     (base 16)		VIENNA SYSTEMS CORPORATION
+				6651 FRASERWOOD PLACE
+				RICHMOND, B.C. V6W 1J3    
+				CA
+
+00-10-D1   (hex)		Top Layer Networks, Inc.
+0010D1     (base 16)		Top Layer Networks, Inc.
+				4 MECHANIC ST.- STE#212
+				NATICK  MA  01760
+				US
+
+00-10-6A   (hex)		DIGITAL MICROWAVE CORPORATION
+00106A     (base 16)		DIGITAL MICROWAVE CORPORATION
+				170 ROSE ORCHARD WAY
+				SAN JOSE  CA  95134
+				US
+
+00-10-6F   (hex)		TRENTON TECHNOLOGY INC.
+00106F     (base 16)		TRENTON TECHNOLOGY INC.
+				2350 CENTENNIAL DRIVE
+				GAINESVILLE  GA  30504
+				US
+
+00-10-34   (hex)		GNP Computers
+001034     (base 16)		GNP Computers
+				555 E.Huntington Drive
+				Monrovia  CA  91016
+				US
+
+00-10-44   (hex)		InnoLabs Corporation
+001044     (base 16)		InnoLabs Corporation
+				2F-4, NO. 16, LANE 609, CHUNG-HSIN RD.
+				Taipei Hsien    
+				TW
+
+00-10-A1   (hex)		KENDIN SEMICONDUCTOR, INC.
+0010A1     (base 16)		KENDIN SEMICONDUCTOR, INC.
+				1550 S. BASCOM AVE., STE. #250
+				CAMPBELL  CA  95008
+				US
+
+00-10-A8   (hex)		RELIANCE COMPUTER CORP.
+0010A8     (base 16)		RELIANCE COMPUTER CORP.
+				3032 BUNKER HILL LANE
+				SANTA CLARA  CA  95054
+				US
+
+00-10-6E   (hex)		TADIRAN COM. LTD.
+00106E     (base 16)		TADIRAN COM. LTD.
+				26 HASHOFTIM ST.
+				HOLON  58102    
+				IL
+
+00-10-9A   (hex)		NETLINE
+00109A     (base 16)		NETLINE
+				7, Rue de Bievres
+				92140 CLAMART    
+				FR
+
+00-10-89   (hex)		WebSonic
+001089     (base 16)		WebSonic
+				3466 EDWARD AVE.
+				SANTA CLARA  CA  95054
+				US
+
+00-10-E6   (hex)		APPLIED INTELLIGENT SYSTEMS, INC.
+0010E6     (base 16)		APPLIED INTELLIGENT SYSTEMS, INC.
+				3923 RANCHERO DRIVE
+				ANN ARBOR  MI  48108
+				US
+
+00-10-3B   (hex)		HIPPI NETWORKING FORUM
+00103B     (base 16)		HIPPI NETWORKING FORUM
+				PO BOX 10173
+				ALBUQUERQUE  NM  87184-0173
+				US
+
+00-E0-83   (hex)		JATO TECHNOLOGIES, INC.
+00E083     (base 16)		JATO TECHNOLOGIES, INC.
+				505 EAST HUNTLAND DR. STE #550
+				AUSTIN  TX  78752
+				US
+
+00-E0-72   (hex)		LYNK
+00E072     (base 16)		LYNK
+				RABIN BUILDING
+				D.N. MISGAV 201    
+				IL
+
+00-E0-AD   (hex)		EES TECHNOLOGY, LTD.
+00E0AD     (base 16)		EES TECHNOLOGY, LTD.
+				25 EASTWAYS
+				WITHAM, ESSEX, CM8 3AL    
+				GB
+
+00-E0-94   (hex)		OSAI SRL
+00E094     (base 16)		OSAI SRL
+				VIA TORINO
+				603-IVREA (TO)    
+				IT
+
+00-E0-32   (hex)		MISYS FINANCIAL SYSTEMS, LTD.
+00E032     (base 16)		MISYS FINANCIAL SYSTEMS, LTD.
+				BUCKHOLT DRIVE,
+				WARNDON, WORCESTER WR49SR    
+				GB
+
+00-E0-C0   (hex)		SEIWA ELECTRIC MFG. CO., LTD.
+00E0C0     (base 16)		SEIWA ELECTRIC MFG. CO., LTD.
+				86 TARADA SHIN-IKE,
+				KYOTO PREFECTURE    
+				JP
+
+00-E0-D1   (hex)		TELSIS LIMITED
+00E0D1     (base 16)		TELSIS LIMITED
+				16 BARNES WALLACE ROAD
+				FAREHAM, HAMPSHIRE PO15 5TT  ENGLAND  
+				GB
+
+00-E0-F0   (hex)		ABLER TECHNOLOGY, INC.
+00E0F0     (base 16)		ABLER TECHNOLOGY, INC.
+				4F, NO. 54  SEC. 4
+				TAIPEI    
+				TW
+
+00-E0-02   (hex)		CROSSROADS SYSTEMS, INC.
+00E002     (base 16)		CROSSROADS SYSTEMS, INC.
+				9390 RESEARCH BLVD.
+				AUSTIN  TX  78759
+				US
+
+00-E0-D6   (hex)		COMPUTER & COMMUNICATION RESEARCH LAB.
+00E0D6     (base 16)		COMPUTER & COMMUNICATION RESEARCH LAB.
+				
+				CHUTUNG, HSINCHU    
+				TW
+
+00-E0-74   (hex)		TIERNAN COMMUNICATIONS, INC.
+00E074     (base 16)		TIERNAN COMMUNICATIONS, INC.
+				11025 ROSELLE ST.
+				SAN DIEGO  CA  92121
+				US
+
+00-E0-D9   (hex)		TAZMO CO., LTD.
+00E0D9     (base 16)		TAZMO CO., LTD.
+				6186 KINOKO, IBARA-SHI
+				OKAYAMA 715    
+				JP
+
+00-E0-55   (hex)		INGENIERIA ELECTRONICA COMERCIAL INELCOM S.A.
+00E055     (base 16)		INGENIERIA ELECTRONICA COMERCIAL INELCOM S.A.
+				CL. PIQUER NO.3
+				28033 MADRID    
+				ES
+
+00-E0-B4   (hex)		TECHNO SCOPE CO., LTD.
+00E0B4     (base 16)		TECHNO SCOPE CO., LTD.
+				13-6-7 KISHIMATI URAWASI
+				SAITAMA 336    
+				JP
+
+00-E0-71   (hex)		EPIS MICROCOMPUTER
+00E071     (base 16)		EPIS MICROCOMPUTER
+				LAUTLINGER STRASSE 147
+				72458 ALBSTADT    
+				DE
+
+00-E0-66   (hex)		ProMax Systems, Inc.
+00E066     (base 16)		ProMax Systems, Inc.
+				16 TECHNOLOGY DRIVE--BLDG.#106
+				IRVINE  CA  92656
+				US
+
+00-E0-93   (hex)		ACKFIN NETWORKS
+00E093     (base 16)		ACKFIN NETWORKS
+				575 N. PASTORIA AVE.
+				SUNNYVALE  CA  94086
+				US
+
+00-E0-42   (hex)		Pacom Systems Ltd.
+00E042     (base 16)		Pacom Systems Ltd.
+				UNIT 22 38/46 SOUTH ST.
+				RYDALMERE 2116  NSW  
+				AU
+
+00-E0-EB   (hex)		DIGICOM SYSTEMS, INCORPORATED
+00E0EB     (base 16)		DIGICOM SYSTEMS, INCORPORATED
+				188 TOPAZ STREET
+				MILPITAS  CA  95035
+				US
+
+00-E0-1C   (hex)		Cradlepoint, Inc
+00E01C     (base 16)		Cradlepoint, Inc
+				1199 Shoreline Lane
+				Boise  ID  83702
+				US
+
+00-E0-27   (hex)		DUX, INC.
+00E027     (base 16)		DUX, INC.
+				5-18-19, NISHIKAMATA, OTA-KU
+				TOKYO-TO, 144    
+				JP
+
+00-E0-4B   (hex)		JUMP INDUSTRIELLE COMPUTERTECHNIK GmbH
+00E04B     (base 16)		JUMP INDUSTRIELLE COMPUTERTECHNIK GmbH
+				
+				D94469 DEGGENDORF    
+				DE
+
+00-E0-97   (hex)		CARRIER ACCESS CORPORATION
+00E097     (base 16)		CARRIER ACCESS CORPORATION
+				5395 PEARL PARKWAY
+				BOULDER  CO  80301
+				US
+
+00-E0-89   (hex)		ION Networks, Inc.
+00E089     (base 16)		ION Networks, Inc.
+				1551 South Washington Ave.
+				Piscataway  NJ  08854
+				US
+
+00-E0-70   (hex)		DH TECHNOLOGY
+00E070     (base 16)		DH TECHNOLOGY
+				3003 ROLLIE GATES DRIVE
+				PASO ROBLES  CA  93446
+				US
+
+00-E0-5C   (hex)		PHC Corporation
+00E05C     (base 16)		PHC Corporation
+				2-38-5 Nishishimbashi
+				Minato-ku  Tokyo  105-8433
+				JP
+
+00-E0-24   (hex)		GADZOOX NETWORKS
+00E024     (base 16)		GADZOOX NETWORKS
+				5850 HELLYER AVENUE
+				SAN JOSE  CA  95138
+				US
+
+00-60-5B   (hex)		IntraServer Technology, Inc.
+00605B     (base 16)		IntraServer Technology, Inc.
+				125 HOPPING BROOK PARK
+				HOLLISTON  MA  01746
+				US
+
+00-60-D7   (hex)		ECOLE POLYTECHNIQUE FEDERALE DE LAUSANNE (EPFL)
+0060D7     (base 16)		ECOLE POLYTECHNIQUE FEDERALE DE LAUSANNE (EPFL)
+				ECUBLENS
+				CH-1015 LAUSANNE    
+				CH
+
+00-E0-BA   (hex)		BERGHOF AUTOMATIONSTECHNIK GmbH
+00E0BA     (base 16)		BERGHOF AUTOMATIONSTECHNIK GmbH
+				HARRET STRASSE 1
+				D 72800 ENINGEN    
+				DE
+
+00-E0-21   (hex)		FREEGATE CORP.
+00E021     (base 16)		FREEGATE CORP.
+				710 LAKEWAY  STE.#230
+				SUNNYVALE  CA  94086
+				US
+
+00-E0-5B   (hex)		WEST END SYSTEMS CORP.
+00E05B     (base 16)		WEST END SYSTEMS CORP.
+				39 WINNER'S CIRCLE DR.,
+				ARNPRIOR, ONTARIO    K7S 3G9    
+				CA
+
+00-E0-44   (hex)		LSICS CORPORATION
+00E044     (base 16)		LSICS CORPORATION
+				3-8-3 NINOMIYA, TSKUKUBA SHI
+				IBARAGI-KEN, 305    
+				JP
+
+00-E0-CA   (hex)		BEST DATA PRODUCTS
+00E0CA     (base 16)		BEST DATA PRODUCTS
+				21800 NORDHOFF STREET
+				CHATSWORTH  CA  91311
+				US
+
+00-E0-A7   (hex)		IPC INFORMATION SYSTEMS, INC.
+00E0A7     (base 16)		IPC INFORMATION SYSTEMS, INC.
+				METRO CENTER
+				STAMFORD  CT  06907
+				US
+
+00-E0-62   (hex)		HOST ENGINEERING
+00E062     (base 16)		HOST ENGINEERING
+				200 EAST MAIN STREET -STE.#700
+				JOHNSON CITY  TN  37604
+				US
+
+00-E0-CE   (hex)		ARN
+00E0CE     (base 16)		ARN
+				51, RUE GASTON LAURIAU
+				F-93512 MONTREUIL CEDEX    
+				FR
+
+00-E0-5F   (hex)		e-Net, Inc.
+00E05F     (base 16)		e-Net, Inc.
+				12325 HYMEADOW DRIVE
+				AUSTIN  TX  78750
+				US
+
+00-E0-1F   (hex)		AVIDIA Systems, Inc.
+00E01F     (base 16)		AVIDIA Systems, Inc.
+				135 NORTH PLAINS INDUSTRIAL RD
+				WALLINGFORD  CT  06492
+				US
+
+00-E0-D0   (hex)		NETSPEED, INC.
+00E0D0     (base 16)		NETSPEED, INC.
+				12303 TECHNOLOGY BLVD.
+				AUSTIN  TX  78727
+				US
+
+00-E0-60   (hex)		SHERWOOD
+00E060     (base 16)		SHERWOOD
+				21056 FORBES STREET
+				HAYWARD  CA  94545
+				US
+
+00-E0-6A   (hex)		KAPSCH AG
+00E06A     (base 16)		KAPSCH AG
+				WAGENSEILGASSE 1
+				1120-VIENNA    
+				AT
+
+00-E0-01   (hex)		STRAND LIGHTING LIMITED
+00E001     (base 16)		STRAND LIGHTING LIMITED
+				GRANT WAY
+				MIDDLESEX  England TW7 5QD  
+				GB
+
+00-E0-D8   (hex)		LANBit Computer, Inc.
+00E0D8     (base 16)		LANBit Computer, Inc.
+				12F, 552 CHUNG HSIAO E., RD.
+				    
+				TW
+
+00-E0-E7   (hex)		RAYTHEON E-SYSTEMS, INC.
+00E0E7     (base 16)		RAYTHEON E-SYSTEMS, INC.
+				1301 E. COLLINS
+				RICHARDSON  TX  75081
+				US
+
+00-E0-3C   (hex)		AdvanSys
+00E03C     (base 16)		AdvanSys
+				1150 RINGWOOD COURT
+				SAN JOSE  CA  95131
+				US
+
+00-E0-73   (hex)		NATIONAL AMUSEMENT NETWORK, INC.
+00E073     (base 16)		NATIONAL AMUSEMENT NETWORK, INC.
+				401 N. MICHIGAN AVENUE
+				CHICAGO  IL  60611
+				US
+
+00-60-66   (hex)		LACROIX Trafic
+006066     (base 16)		LACROIX Trafic
+				1 ere Avenue, 11 eme rue
+				06516 CARROS    
+				FR
+
+00-60-F4   (hex)		ADVANCED COMPUTER SOLUTIONS, Inc.
+0060F4     (base 16)		ADVANCED COMPUTER SOLUTIONS, Inc.
+				12675 DANIELSON COURT
+				POWAY  CA  92064
+				US
+
+00-60-60   (hex)		Data Innovations North America
+006060     (base 16)		Data Innovations North America
+				120 Kimball Avenue Suite 100
+				South Burlington  VT  05403
+				US
+
+00-60-35   (hex)		DALLAS SEMICONDUCTOR, INC.
+006035     (base 16)		DALLAS SEMICONDUCTOR, INC.
+				4401 SOUTH BELTWOOD PARKWAY
+				DALLAS  TX  75244-3292
+				US
+
+00-60-07   (hex)		ACRES GAMING, INC.
+006007     (base 16)		ACRES GAMING, INC.
+				815 NW 9TH STREET
+				CORVALLIS  OR  97330
+				US
+
+00-60-58   (hex)		COPPER MOUNTAIN COMMUNICATIONS, INC.
+006058     (base 16)		COPPER MOUNTAIN COMMUNICATIONS, INC.
+				6650 LUSK BLVD.-STE #B103
+				SAN DIEGO  CA  92121
+				US
+
+00-60-FB   (hex)		PACKETEER, INC.
+0060FB     (base 16)		PACKETEER, INC.
+				10201 N. DE ANZA BOULEVARD
+				CUPERTINO  CA  95014
+				US
+
+00-60-C1   (hex)		WaveSpan Corporation
+0060C1     (base 16)		WaveSpan Corporation
+				500 N. BERNARDO AVE.
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-60-3C   (hex)		HAGIWARA SYS-COM CO., LTD.
+00603C     (base 16)		HAGIWARA SYS-COM CO., LTD.
+				2-4-3 NISHIKI NAKA-KU
+				AICHI 460    
+				JP
+
+00-60-7D   (hex)		SENTIENT NETWORKS INC.
+00607D     (base 16)		SENTIENT NETWORKS INC.
+				2201 CANTU COURT-STE #205
+				SARASOTA  FL  34232
+				US
+
+00-60-19   (hex)		Roche Diagnostics
+006019     (base 16)		Roche Diagnostics
+				9115 Hague Road
+				Indianapolis  IN  46250-0457
+				US
+
+00-60-59   (hex)		TECHNICAL COMMUNICATIONS CORP.
+006059     (base 16)		TECHNICAL COMMUNICATIONS CORP.
+				100 DOMINO DRIVE
+				CONCORD  MA  01742
+				US
+
+00-60-03   (hex)		TERAOKA WEIGH SYSTEM PTE, LTD.
+006003     (base 16)		TERAOKA WEIGH SYSTEM PTE, LTD.
+				3A TUAS AVENUE 8
+				  SINGAPORE 639128  
+				SG
+
+00-60-7A   (hex)		DVS GMBH
+00607A     (base 16)		DVS GMBH
+				KREPENSTRASSE 8
+				D-30165 HANNOVER    
+				DE
+
+00-60-F3   (hex)		Performance Analysis Broadband, Spirent plc
+0060F3     (base 16)		Performance Analysis Broadband, Spirent plc
+				27349 Agoura Road
+				Calabasas Hills  CA  91301
+				US
+
+00-60-7C   (hex)		WaveAccess, Ltd.
+00607C     (base 16)		WaveAccess, Ltd.
+				P.O. BOX 2473
+				RA'ANANA 43663    
+				IL
+
+00-60-A0   (hex)		SWITCHED NETWORK TECHNOLOGIES, INC.
+0060A0     (base 16)		SWITCHED NETWORK TECHNOLOGIES, INC.
+				13805 1ST AVENUE NORTH
+				PLYMOUTH  MN  55441-5455
+				US
+
+00-60-17   (hex)		TOKIMEC INC.
+006017     (base 16)		TOKIMEC INC.
+				2-16, MINAMI-KAMATA, OHTA-KU
+				TOKYO 144    
+				JP
+
+00-60-26   (hex)		VIKING Modular Solutions
+006026     (base 16)		VIKING Modular Solutions
+				11 COLUMBIA
+				LAGUNA HILLS  CA  92656
+				US
+
+00-60-6E   (hex)		DAVICOM SEMICONDUCTOR, INC.
+00606E     (base 16)		DAVICOM SEMICONDUCTOR, INC.
+				2457 AUGUSTINE DRIVE
+				SANTA CLARA  CA  95054
+				US
+
+00-60-C7   (hex)		AMATI COMMUNICATIONS CORP.
+0060C7     (base 16)		AMATI COMMUNICATIONS CORP.
+				2043 SAMARITAN DRIVE
+				SAN JOSE  CA  95124
+				US
+
+10-00-E8   (hex)		NATIONAL SEMICONDUCTOR
+1000E8     (base 16)		NATIONAL SEMICONDUCTOR
+				2900 SEMICONDUCTOR DRIVE
+				SANTA CLARA  CA  95051
+				US
+
+00-60-73   (hex)		REDCREEK COMMUNICATIONS, INC.
+006073     (base 16)		REDCREEK COMMUNICATIONS, INC.
+				3900 NEWPARK MALL ROAD
+				NEWARK  CA  94560
+				US
+
+00-60-FD   (hex)		NetICs, Inc.
+0060FD     (base 16)		NetICs, Inc.
+				42 NAGOG PARK
+				ACTON  MA  01720
+				US
+
+00-60-CB   (hex)		HITACHI ZOSEN CORPORATION
+0060CB     (base 16)		HITACHI ZOSEN CORPORATION
+				3-4, SAKURAJIMA 1-CHOME
+				KONOHANA-KU, OSAKA 554    
+				JP
+
+00-60-C8   (hex)		KUKA WELDING SYSTEMS & ROBOTS
+0060C8     (base 16)		KUKA WELDING SYSTEMS & ROBOTS
+				BLUECHERSTRASSE 144
+				D-86165 AUGSBURG    
+				DE
+
+00-60-23   (hex)		PERICOM SEMICONDUCTOR CORP.
+006023     (base 16)		PERICOM SEMICONDUCTOR CORP.
+				2380 BERING DRIVE
+				SAN JOSE  CA  95131
+				US
+
+00-60-63   (hex)		PSION DACOM PLC.
+006063     (base 16)		PSION DACOM PLC.
+				PSION DACOM HOUSE
+				CROWNHILL  MILTON KEYNES  MK8 0EF  
+				GB
+
+00-60-31   (hex)		HRK SYSTEMS
+006031     (base 16)		HRK SYSTEMS
+				P.O. BOX 514
+				WESTVILLE 3630    
+				ZA
+
+00-60-0E   (hex)		WAVENET INTERNATIONAL, INC.
+00600E     (base 16)		WAVENET INTERNATIONAL, INC.
+				5825 KENNEDY ROAD
+				MISSISSAUGA, ONTARIO L4Z 2G3    
+				CA
+
+00-60-A3   (hex)		CONTINUUM TECHNOLOGY CORP.
+0060A3     (base 16)		CONTINUUM TECHNOLOGY CORP.
+				220 CONTINUUM DRIVE
+				FLETCHER  NC  28732
+				US
+
+00-60-3D   (hex)		3CX
+00603D     (base 16)		3CX
+				2085 HAMILTON AVE., -STE.#220
+				SAN JOSE  CA  95125
+				US
+
+00-60-ED   (hex)		RICARDO TEST AUTOMATION LTD.
+0060ED     (base 16)		RICARDO TEST AUTOMATION LTD.
+				LOWESMOOR WHARF
+				WORCESTER, WR12RS    
+				GB
+
+00-60-12   (hex)		POWER COMPUTING CORPORATION
+006012     (base 16)		POWER COMPUTING CORPORATION
+				10261 BUBB ROAD
+				CUPERTINO  CA  95014
+				US
+
+00-60-4D   (hex)		MMC NETWORKS, INC.
+00604D     (base 16)		MMC NETWORKS, INC.
+				1134 EAST ARQUES AVENUE
+				SUNNYVALE  CA  94086-4602
+				US
+
+00-60-F7   (hex)		DATAFUSION SYSTEMS
+0060F7     (base 16)		DATAFUSION SYSTEMS
+				P.O. BOX 582
+				STELLENBOSCH,  7599    
+				ZA
+
+00-60-20   (hex)		PIVOTAL NETWORKING, INC.
+006020     (base 16)		PIVOTAL NETWORKING, INC.
+				7246 SHARON DR., STE
+				SAN JOSE  CA  95129
+				US
+
+00-60-C0   (hex)		Nera Networks AS
+0060C0     (base 16)		Nera Networks AS
+				Kokstadveien 23
+				Bergen    5020
+				NO
+
+00-60-77   (hex)		PRISA NETWORKS
+006077     (base 16)		PRISA NETWORKS
+				6620 Mesa Ridge Road,
+				San Diego  CA  92121
+				US
+
+00-60-94   (hex)		IBM Corp
+006094     (base 16)		IBM Corp
+				3039 E Cornwallis Road
+				Research Triangle Park  NC  27709-2195
+				US
+
+00-60-AB   (hex)		LARSCOM INCORPORATED
+0060AB     (base 16)		LARSCOM INCORPORATED
+				1845 MCCANDLESS DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-60-DD   (hex)		MYRICOM, INC.
+0060DD     (base 16)		MYRICOM, INC.
+				325B N. SANTA ANITA AVE.
+				ARCADIA  CA  91006
+				US
+
+00-60-46   (hex)		VMETRO, INC.
+006046     (base 16)		VMETRO, INC.
+				1880 DAIRY ASHFORD- STE #535
+				HOUSTON  TX  77077
+				US
+
+00-60-68   (hex)		Dialogic Corporation
+006068     (base 16)		Dialogic Corporation
+				9800 Cavendish Blvd, 5th Floor
+				Montreal  Quebec  H4M 2V9
+				CA
+
+00-60-5A   (hex)		CELCORE, INC.
+00605A     (base 16)		CELCORE, INC.
+				8001 CENTERVIEW PARKWAY
+				MEMPHIS  TN  38018
+				US
+
+00-60-95   (hex)		ACCU-TIME SYSTEMS, INC.
+006095     (base 16)		ACCU-TIME SYSTEMS, INC.
+				420 SOMERS ROAD
+				ELLINGTON  CT  06029
+				US
+
+00-60-8A   (hex)		CITADEL COMPUTER
+00608A     (base 16)		CITADEL COMPUTER
+				29 ARMORY RD
+				MILFORD  MA  03055
+				US
+
+00-60-93   (hex)		VARIAN
+006093     (base 16)		VARIAN
+				2700 MITCHELL DR.
+				WALNUT GREEK  CA  94598
+				US
+
+00-A0-3F   (hex)		COMPUTER SOCIETY MICROPROCESSOR & MICROPROCESSOR STANDARDS C
+00A03F     (base 16)		COMPUTER SOCIETY MICROPROCESSOR & MICROPROCESSOR STANDARDS C
+				% APPLE COMPUTER, INC.
+				CUPERTINO  CA  95014
+				US
+
+00-A0-2D   (hex)		1394 Trade Association
+00A02D     (base 16)		1394 Trade Association
+				3925 WEST BRAKER LANE
+				AUSTIN  TX  78759
+				US
+
+00-A0-7C   (hex)		TONYANG NYLON CO., LTD.
+00A07C     (base 16)		TONYANG NYLON CO., LTD.
+				ELECTRONIC RESEARCH LAB
+				ANYANG-CITY, KYUNGKI-DO 430-080    
+				KR
+
+00-A0-9A   (hex)		NIHON KOHDEN AMERICA
+00A09A     (base 16)		NIHON KOHDEN AMERICA
+				2446 DUPONT DRIVE
+				IRVINE  CA  92715
+				US
+
+00-A0-93   (hex)		B/E AEROSPACE, Inc.
+00A093     (base 16)		B/E AEROSPACE, Inc.
+				17481 RED HILL
+				IRVINE  CA  92714-5630
+				US
+
+00-A0-78   (hex)		Marconi Communications
+00A078     (base 16)		Marconi Communications
+				1000 Fore Drive
+				Warrendale  PA  15086-7502
+				US
+
+00-A0-BF   (hex)		WIRELESS DATA GROUP MOTOROLA
+00A0BF     (base 16)		WIRELESS DATA GROUP MOTOROLA
+				1201 E. WILEY ROAD
+				SCHAUMBURG  IL  60173
+				US
+
+00-A0-5F   (hex)		BTG Electronics Design BV
+00A05F     (base 16)		BTG Electronics Design BV
+				P.O. Box 1543
+				BA Oud Beijerland    
+				NL
+
+00-A0-CD   (hex)		DR. JOHANNES HEIDENHAIN GmbH
+00A0CD     (base 16)		DR. JOHANNES HEIDENHAIN GmbH
+				DR.-JOHANNES-HEIDENHAIN STR.
+				83301 TRAUNREUT    
+				DE
+
+00-A0-DA   (hex)		INTEGRATED SYSTEMS Technology, Inc.
+00A0DA     (base 16)		INTEGRATED SYSTEMS Technology, Inc.
+				4601 PRESIDENTS DRIVE
+				LANHAM  MD  20706
+				US
+
+00-A0-2A   (hex)		TRANCELL SYSTEMS
+00A02A     (base 16)		TRANCELL SYSTEMS
+				3180 DE LA CRUZ BLVD.-STE#200
+				SANTA CLARA  CA  95054-2402
+				US
+
+00-A0-1C   (hex)		NASCENT NETWORKS CORPORATION
+00A01C     (base 16)		NASCENT NETWORKS CORPORATION
+				277 MAIN STREET,  3RD FLR.
+				MARLBORO  MA  01752
+				US
+
+00-A0-8F   (hex)		DESKNET SYSTEMS, INC.
+00A08F     (base 16)		DESKNET SYSTEMS, INC.
+				80 BUSINESS PARK DRIVE
+				ARMONK  NY  10504
+				US
+
+00-A0-CC   (hex)		LITE-ON COMMUNICATIONS, INC.
+00A0CC     (base 16)		LITE-ON COMMUNICATIONS, INC.
+				720 S. HILLVIEW DRIVE
+				MILPITAS  CA  95035
+				US
+
+00-A0-E6   (hex)		DIALOGIC CORPORATION
+00A0E6     (base 16)		DIALOGIC CORPORATION
+				1515 ROUTE 10
+				PARSIPPANY  NJ  07054
+				US
+
+00-A0-4A   (hex)		NISSHIN ELECTRIC CO., LTD.
+00A04A     (base 16)		NISSHIN ELECTRIC CO., LTD.
+				5, MEOTOGOSHI, MUTSUSHI,
+				AICHI 481    
+				JP
+
+00-A0-35   (hex)		CYLINK CORPORATION
+00A035     (base 16)		CYLINK CORPORATION
+				3131 JAY STREET
+				SANTA CLARA  CA  95054
+				US
+
+00-A0-3D   (hex)		OPTO-22
+00A03D     (base 16)		OPTO-22
+				43044 BUSINESS PARK DR.
+				TEMECULA  CA  92590
+				US
+
+00-A0-56   (hex)		MICROPROSS
+00A056     (base 16)		MICROPROSS
+				33, RUE GANTOIS
+				59000 LILLE    
+				FR
+
+00-A0-E1   (hex)		WESTPORT RESEARCH ASSOCIATES, INC.
+00A0E1     (base 16)		WESTPORT RESEARCH ASSOCIATES, INC.
+				6102 ARLINGTON
+				RAYTOWN  MO  64133
+				US
+
+00-A0-B7   (hex)		CORDANT, INC.
+00A0B7     (base 16)		CORDANT, INC.
+				11400 COMMERCE PARK DR.
+				RESTON  VA  22091-1506
+				US
+
+00-A0-26   (hex)		TELDAT, S.A.
+00A026     (base 16)		TELDAT, S.A.
+				PARQUE TECNOLOGICO MADRID
+				28760 TACS CAN TOS (MADRID)    
+				ES
+
+00-A0-23   (hex)		APPLIED CREATIVE TECHNOLOGY, INC.
+00A023     (base 16)		APPLIED CREATIVE TECHNOLOGY, INC.
+				2626 LOMBARDY LANE--STE.#107
+				DALLAS  TX  75220
+				US
+
+00-A0-89   (hex)		XPOINT TECHNOLOGIES, INC.
+00A089     (base 16)		XPOINT TECHNOLOGIES, INC.
+				902 CLINT MOORE RD.-STE#132
+				BOCA RATON  FL  33487
+				US
+
+00-A0-07   (hex)		APEXX TECHNOLOGY, INC.
+00A007     (base 16)		APEXX TECHNOLOGY, INC.
+				506 S. 11TH
+				BOISE  ID  83707
+				US
+
+00-A0-47   (hex)		INTEGRATED FITNESS CORP.
+00A047     (base 16)		INTEGRATED FITNESS CORP.
+				26 6TH STREET
+				STAMFORD  CT  06905
+				US
+
+00-A0-32   (hex)		GES SINGAPORE PTE. LTD.
+00A032     (base 16)		GES SINGAPORE PTE. LTD.
+				14 SUNGEI KADUT AVENUE
+				  SINGAPORE  2572
+				SG
+
+00-A0-E3   (hex)		XKL SYSTEMS CORP.
+00A0E3     (base 16)		XKL SYSTEMS CORP.
+				8420 154TH AVE. NE
+				REDMOND  WA  98052
+				US
+
+00-A0-14   (hex)		CSIR
+00A014     (base 16)		CSIR
+				P.O. BOX 395
+				  SOUTH  AFRICA
+				ZA
+
+00-A0-15   (hex)		WYLE
+00A015     (base 16)		WYLE
+				3000 BOWERS AVENUE
+				SANTA CLARA  CA  95051
+				US
+
+00-A0-6A   (hex)		Verilink Corporation
+00A06A     (base 16)		Verilink Corporation
+				127 Jetplex Circle
+				Madison  AL  35758
+				US
+
+00-A0-18   (hex)		CREATIVE CONTROLLERS, INC.
+00A018     (base 16)		CREATIVE CONTROLLERS, INC.
+				128 KENDRICK LANE
+				PICAYUNE  MS  39466
+				US
+
+00-A0-FE   (hex)		BOSTON TECHNOLOGY, INC.
+00A0FE     (base 16)		BOSTON TECHNOLOGY, INC.
+				100 QUANNAPOWITT PARKWAY
+				WAKEFIELD  MA  01880
+				US
+
+00-A0-EB   (hex)		Encore Networks, Inc.
+00A0EB     (base 16)		Encore Networks, Inc.
+				3800 Concorde Parkway,
+				Chantilly,  VA  20151
+				US
+
+00-A0-7D   (hex)		SEEQ TECHNOLOGY, INC.
+00A07D     (base 16)		SEEQ TECHNOLOGY, INC.
+				47131 BAYSIDE PARKWAY
+				FREMONT  CA  94538
+				US
+
+00-A0-D9   (hex)		CONVEX COMPUTER CORPORATION
+00A0D9     (base 16)		CONVEX COMPUTER CORPORATION
+				3000 WATERVIEW PARKWAY
+				RICHARDSON  TX  75083-3851
+				US
+
+00-A0-70   (hex)		COASTCOM
+00A070     (base 16)		COASTCOM
+				1151 HARBOR BAY PARKWAY
+				ALAMEDA  CA  94502-6511
+				US
+
+00-20-DE   (hex)		JAPAN DIGITAL LABORAT'Y CO.LTD
+0020DE     (base 16)		JAPAN DIGITAL LABORAT'Y CO.LTD
+				JDL KAWASAKI R & D CENTER
+				KANAGAWA-KEN    215
+				JP
+
+00-20-0B   (hex)		OCTAGON SYSTEMS CORP.
+00200B     (base 16)		OCTAGON SYSTEMS CORP.
+				7403 Church Ranch Blvd
+				Westminster  CO  80021
+				US
+
+00-20-94   (hex)		CUBIX CORPORATION
+002094     (base 16)		CUBIX CORPORATION
+				2800 LOCKHEED WAY
+				CARSON CITY  NV  89706
+				US
+
+00-20-F7   (hex)		CYBERDATA CORPORATION
+0020F7     (base 16)		CYBERDATA CORPORATION
+				3 Justin Court
+				MONTEREY  CA  93940
+				US
+
+00-20-D7   (hex)		JAPAN MINICOMPUTER SYSTEMS CO., Ltd.
+0020D7     (base 16)		JAPAN MINICOMPUTER SYSTEMS CO., Ltd.
+				3-33-18 TAKAIDOHIGASHI
+				TOKYO 168    
+				JP
+
+00-20-C3   (hex)		COUNTER SOLUTIONS LTD.
+0020C3     (base 16)		COUNTER SOLUTIONS LTD.
+				263 HEAGE ROAD
+				RIPLEY, DERBYS DE5 3GH    
+				GB
+
+00-20-47   (hex)		STEINBRECHER CORP.
+002047     (base 16)		STEINBRECHER CORP.
+				30 NORTH AVENUE
+				BURLINGTON  MA  01803
+				US
+
+00-20-D5   (hex)		VIPA GMBH
+0020D5     (base 16)		VIPA GMBH
+				WETTERKREUZ 27
+				    
+				DE
+
+00-20-1A   (hex)		MRV Communications, Inc.
+00201A     (base 16)		MRV Communications, Inc.
+				20415 Nordhoff St.
+				Chatsworth  CA  91311
+				US
+
+00-20-F2   (hex)		Oracle Corporation 
+0020F2     (base 16)		Oracle Corporation 
+				500 Oracle Parkway
+				Redwood Shores  CA  94065
+				US
+
+00-20-B8   (hex)		PRIME OPTION, INC.
+0020B8     (base 16)		PRIME OPTION, INC.
+				2341 W. 205TH STREET #116
+				TORRANCE  CA  90501
+				US
+
+00-20-AD   (hex)		LINQ SYSTEMS
+0020AD     (base 16)		LINQ SYSTEMS
+				P.O. BOX 11040
+				TUCSON  AZ  85734
+				US
+
+00-20-7D   (hex)		ADVANCED COMPUTER APPLICATIONS
+00207D     (base 16)		ADVANCED COMPUTER APPLICATIONS
+				107 PENNS TRAIL
+				NEWTOWN  PA  18940
+				US
+
+00-20-2F   (hex)		ZETA COMMUNICATIONS, LTD.
+00202F     (base 16)		ZETA COMMUNICATIONS, LTD.
+				ZENITH HOUSE
+				WREXHAM, CLWYD, LL12 8LX    
+				GB
+
+00-20-9A   (hex)		THE 3DO COMPANY
+00209A     (base 16)		THE 3DO COMPANY
+				600 GALVESTON DRIVE
+				REDWOOD CITY  CA  94063
+				US
+
+00-20-62   (hex)		SCORPION LOGIC, LTD.
+002062     (base 16)		SCORPION LOGIC, LTD.
+				19 BROOKSIDE ROAD
+				HERTS WD1 4BW    
+				GB
+
+00-20-81   (hex)		TITAN ELECTRONICS
+002081     (base 16)		TITAN ELECTRONICS
+				3033 SCIENCE PARK ROAD
+				SAN DIEGO  CA  92121
+				US
+
+00-20-D9   (hex)		PANASONIC TECHNOLOGIES, INC./MIECO-US
+0020D9     (base 16)		PANASONIC TECHNOLOGIES, INC./MIECO-US
+				1703 N. RANDALL RD.
+				ELGIN  IL  60123
+				US
+
+00-20-6F   (hex)		FLOWPOINT CORPORATION
+00206F     (base 16)		FLOWPOINT CORPORATION
+				7291 CORONADO DRIVE, STE# 4
+				SAN JOSE  CA  95129
+				US
+
+00-20-20   (hex)		MEGATRON COMPUTER INDUSTRIES PTY, LTD.
+002020     (base 16)		MEGATRON COMPUTER INDUSTRIES PTY, LTD.
+				
+				    
+				AU
+
+00-20-1B   (hex)		NORTHERN TELECOM/NETWORK
+00201B     (base 16)		NORTHERN TELECOM/NETWORK
+				SYSTEMS CORPORATION
+				CANADA    K8N 5B7
+				CA
+
+00-20-F3   (hex)		RAYNET CORPORATION
+0020F3     (base 16)		RAYNET CORPORATION
+				155 CONSTITUTION DRIVE
+				MENLO PARK  CA  94025
+				US
+
+00-20-90   (hex)		ADVANCED COMPRESSION TECHNOLOGY, INC.
+002090     (base 16)		ADVANCED COMPRESSION TECHNOLOGY, INC.
+				820 FLYNN ROAD
+				CAMARILLO  CA  93012
+				US
+
+00-20-C0   (hex)		PULSE ELECTRONICS, INC.
+0020C0     (base 16)		PULSE ELECTRONICS, INC.
+				5706 FREDERICK AVENUE
+				ROCKVILLE  MD  20852
+				US
+
+00-20-7E   (hex)		FINECOM CO., LTD.
+00207E     (base 16)		FINECOM CO., LTD.
+				1108 HWAKOK-DONG, KANGSEO-KU
+				SEOUL    
+				KR
+
+00-20-4E   (hex)		NETWORK SECURITY SYSTEMS, INC.
+00204E     (base 16)		NETWORK SECURITY SYSTEMS, INC.
+				9401 WAPLES STREET,STE. #100
+				SAN DIEGO  CA  92121
+				US
+
+00-20-CA   (hex)		DIGITAL OCEAN
+0020CA     (base 16)		DIGITAL OCEAN
+				11206 THOMPSON AVENUE
+				LENEXA  KS  66219-2303
+				US
+
+00-20-95   (hex)		RIVA ELECTRONICS
+002095     (base 16)		RIVA ELECTRONICS
+				UNIT 17, BARRSFOLD RD.
+				LANCASHIRE  ENGLAND  BL5 3XW
+				GB
+
+00-20-FB   (hex)		OCTEL COMMUNICATIONS CORP.
+0020FB     (base 16)		OCTEL COMMUNICATIONS CORP.
+				1001 MURPHY RANCH RD
+				MILPITAS  CA  95035
+				US
+
+00-20-70   (hex)		HYNET, LTD.
+002070     (base 16)		HYNET, LTD.
+				102 JABOTINSKY ST.
+				PETACH TIKVA 49130    
+				IL
+
+00-20-BE   (hex)		LAN ACCESS CORP.
+0020BE     (base 16)		LAN ACCESS CORP.
+				2730 MONTEREY STREET, STE.#102
+				TORRANCE  CA  90503
+				US
+
+00-20-3F   (hex)		JUKI CORPORATION
+00203F     (base 16)		JUKI CORPORATION
+				8-2-1 KOKURYO-CHO
+				    
+				JP
+
+00-20-A9   (hex)		WHITE HORSE INDUSTRIAL
+0020A9     (base 16)		WHITE HORSE INDUSTRIAL
+				4F. NO.16, ALLEY 56, LANE 181
+				    
+				TW
+
+00-20-96   (hex)		Invensys
+002096     (base 16)		Invensys
+				Robershaw Industrial Products
+				Marysville  TN  37801
+				US
+
+00-20-4A   (hex)		PRONET GMBH
+00204A     (base 16)		PRONET GMBH
+				KARLSTRASSE 49
+				    
+				DE
+
+00-20-FF   (hex)		SYMMETRICAL TECHNOLOGIES
+0020FF     (base 16)		SYMMETRICAL TECHNOLOGIES
+				500 HUNTMAR PARK DRIVE
+				HERNDON  VA  22070
+				US
+
+00-20-44   (hex)		GENITECH PTY LTD
+002044     (base 16)		GENITECH PTY LTD
+				P.O. BOX 196
+				    
+				AU
+
+00-20-EF   (hex)		USC CORPORATION
+0020EF     (base 16)		USC CORPORATION
+				6-4, OSAKI 1-CHOME
+				  141  
+				JP
+
+00-20-30   (hex)		ANALOG & DIGITAL SYSTEMS
+002030     (base 16)		ANALOG & DIGITAL SYSTEMS
+				1/2 LAVELLE ROAD
+				    
+				IN
+
+00-20-AC   (hex)		INTERFLEX DATENSYSTEME GMBH
+0020AC     (base 16)		INTERFLEX DATENSYSTEME GMBH
+				GROBWIESENSTRASE 24
+				    WESTGERMANY
+				DE
+
+00-20-D8   (hex)		Nortel Networks
+0020D8     (base 16)		Nortel Networks
+				4401 Great America Pkwy.
+				Santa Clara  CA  94588
+				US
+
+00-20-66   (hex)		GENERAL MAGIC, INC.
+002066     (base 16)		GENERAL MAGIC, INC.
+				2465 LATHAM STREET
+				MOUNTAIN VIEW  CA  94040
+				US
+
+00-20-01   (hex)		DSP SOLUTIONS, INC.
+002001     (base 16)		DSP SOLUTIONS, INC.
+				2464 EMBARCADERO WAY
+				PALO ALTO  CA  94303
+				US
+
+00-20-BF   (hex)		AEHR TEST SYSTEMS
+0020BF     (base 16)		AEHR TEST SYSTEMS
+				1667 PLYMOUTH STREET
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-20-53   (hex)		HUNTSVILLE MICROSYSTEMS, INC.
+002053     (base 16)		HUNTSVILLE MICROSYSTEMS, INC.
+				P.O. BOX 12415
+				HUNTSVILLE  AL  35815
+				US
+
+00-20-A1   (hex)		DOVATRON
+0020A1     (base 16)		DOVATRON
+				PRODUCTS DIVISION
+				LONGMONT  CO  80501
+				US
+
+00-C0-2F   (hex)		OKUMA CORPORATION
+00C02F     (base 16)		OKUMA CORPORATION
+				OGUCHI-CHO, NIWA-GUN
+				    
+				JP
+
+00-C0-1E   (hex)		LA FRANCAISE DES JEUX
+00C01E     (base 16)		LA FRANCAISE DES JEUX
+				CENTRE DE ROUSSY/DTI
+				    
+				FR
+
+00-C0-E1   (hex)		SONIC SOLUTIONS
+00C0E1     (base 16)		SONIC SOLUTIONS
+				1891 E. FRANCISCO BLVD.
+				SAN RAFAEL  CA  94901
+				US
+
+00-20-36   (hex)		BMC SOFTWARE
+002036     (base 16)		BMC SOFTWARE
+				1600 CITY WEST BLVD., #1600
+				HOUSTON  TX  77042
+				US
+
+00-20-F8   (hex)		CARRERA COMPUTERS, INC.
+0020F8     (base 16)		CARRERA COMPUTERS, INC.
+				23181 VERDUGO DRIVE-STE.#105A
+				LAGUNA HILLS  CA  92653
+				US
+
+00-C0-65   (hex)		SCOPE COMMUNICATIONS, INC.
+00C065     (base 16)		SCOPE COMMUNICATIONS, INC.
+				100 OTIS STREET
+				NORTHBORO  MA  01532
+				US
+
+00-C0-79   (hex)		FONSYS CO.,LTD.
+00C079     (base 16)		FONSYS CO.,LTD.
+				209-5, YANGJAE, SEOCHO
+				    KOREA
+				KR
+
+00-C0-0F   (hex)		QUANTUM SOFTWARE SYSTEMS LTD.
+00C00F     (base 16)		QUANTUM SOFTWARE SYSTEMS LTD.
+				175 TERRENCE MATTHEWS CRESCENT
+				  K2L  3T5
+				CA
+
+00-C0-87   (hex)		UUNET TECHNOLOGIES, INC.
+00C087     (base 16)		UUNET TECHNOLOGIES, INC.
+				3110 FAIRVIEW PARK DR. #570
+				FALLS CHURCH  VA  22042
+				US
+
+00-C0-06   (hex)		NIPPON AVIONICS CO., LTD.
+00C006     (base 16)		NIPPON AVIONICS CO., LTD.
+				INDUSTRIAL SYSTEM DIVISION
+				    
+				JP
+
+00-C0-A4   (hex)		UNIGRAF OY
+00C0A4     (base 16)		UNIGRAF OY
+				RUUKINTIE 18
+				    
+				FI
+
+00-C0-29   (hex)		Nexans Deutschland GmbH - ANS
+00C029     (base 16)		Nexans Deutschland GmbH - ANS
+				Bonnenbroicher Str. 100
+				    
+				DE
+
+00-C0-FA   (hex)		CANARY COMMUNICATIONS, INC.
+00C0FA     (base 16)		CANARY COMMUNICATIONS, INC.
+				1851 ZANKER ROAD
+				SAN JOSE  CA  95112-4213
+				US
+
+00-C0-3A   (hex)		MEN-MIKRO ELEKTRONIK GMBH
+00C03A     (base 16)		MEN-MIKRO ELEKTRONIK GMBH
+				WIESENTALSTRASSE 40
+				    
+				DE
+
+00-C0-40   (hex)		ECCI
+00C040     (base 16)		ECCI
+				15070-B AVENUE OF SCIENCE
+				SAN DIEGO  CA  92128
+				US
+
+00-C0-1C   (hex)		INTERLINK COMMUNICATIONS LTD.
+00C01C     (base 16)		INTERLINK COMMUNICATIONS LTD.
+				BRUNEL ROAD,
+				    ENGLAND
+				GB
+
+00-C0-42   (hex)		DATALUX CORP.
+00C042     (base 16)		DATALUX CORP.
+				2836 CESSNA DRIVE
+				WINCHESTER  VA  22601
+				US
+
+00-C0-71   (hex)		AREANEX COMMUNICATIONS, INC.
+00C071     (base 16)		AREANEX COMMUNICATIONS, INC.
+				3333 OCTAVIUS DRIVE UNIT C
+				SANTA CLARA  CA  95051
+				US
+
+00-C0-44   (hex)		EMCOM CORPORATION
+00C044     (base 16)		EMCOM CORPORATION
+				840 AVENUE
+				PLANO  TX  75074
+				US
+
+00-C0-E6   (hex)		Verilink Corporation
+00C0E6     (base 16)		Verilink Corporation
+				127 Jetplex Circle
+				Madison  AL  35758
+				US
+
+00-C0-96   (hex)		TAMURA CORPORATION
+00C096     (base 16)		TAMURA CORPORATION
+				COMMUNICATION SYSTEMS DIV.
+				    
+				JP
+
+00-C0-4E   (hex)		COMTROL CORPORATION
+00C04E     (base 16)		COMTROL CORPORATION
+				2675 PATTON ROAD
+				ST. PAUL  MN  55113
+				US
+
+00-C0-3F   (hex)		STORES AUTOMATED SYSTEMS, INC.
+00C03F     (base 16)		STORES AUTOMATED SYSTEMS, INC.
+				1360 ADAMS ROAD
+				BENSALEM  PA  19020
+				US
+
+00-C0-36   (hex)		RAYTECH ELECTRONIC CORP.
+00C036     (base 16)		RAYTECH ELECTRONIC CORP.
+				2F, NO.6, LANE 497
+				  TAIWAN  R.O.C.
+				TW
+
+00-C0-A2   (hex)		INTERMEDIUM A/S
+00C0A2     (base 16)		INTERMEDIUM A/S
+				ODINSVEJ 19
+				    
+				DK
+
+00-C0-53   (hex)		Aspect Software Inc.
+00C053     (base 16)		Aspect Software Inc.
+				6 Technology Park Drive
+				Westford  MA  01886
+				US
+
+00-C0-CC   (hex)		TELESCIENCES CO SYSTEMS, INC.
+00C0CC     (base 16)		TELESCIENCES CO SYSTEMS, INC.
+				351 NEW ALBANY RD.
+				MOORESTOWN  NJ  08057-1177
+				US
+
+00-C0-CE   (hex)		CEI SYSTEMS & ENGINEERING PTE
+00C0CE     (base 16)		CEI SYSTEMS & ENGINEERING PTE
+				BLK 73 #02-18 AYER RAJAH CRESC
+				  SINGAPORE  0513
+				SG
+
+00-40-4F   (hex)		SPACE & NAVAL WARFARE SYSTEMS
+00404F     (base 16)		SPACE & NAVAL WARFARE SYSTEMS
+				NUWC
+				NEWPORT  RI  02841-5047
+				US
+
+00-40-8F   (hex)		WM-DATA MINFO AB
+00408F     (base 16)		WM-DATA MINFO AB
+				OLOF ASKLUNDS GATA 14
+				    
+				SE
+
+00-40-D7   (hex)		STUDIO GEN INC.
+0040D7     (base 16)		STUDIO GEN INC.
+				3-12-8 TAKANAWA #202
+				    
+				JP
+
+00-40-57   (hex)		LOCKHEED - SANDERS
+004057     (base 16)		LOCKHEED - SANDERS
+				DANIEL WEBSTER HIGHWAY SOUTH
+				NASHUA  NH  03061-0868
+				US
+
+00-40-17   (hex)		Silex Technology America
+004017     (base 16)		Silex Technology America
+				157 West 7065 South
+				Salt Lake City  UT  84047
+				US
+
+00-C0-D9   (hex)		QUINTE NETWORK CONFIDENTIALITY
+00C0D9     (base 16)		QUINTE NETWORK CONFIDENTIALITY
+				EQUIPMENT INC.
+				CANADA  K8N  1C3
+				CA
+
+00-C0-B1   (hex)		GENIUS NET CO.
+00C0B1     (base 16)		GENIUS NET CO.
+				4F, HANSOO B/D 210-5
+				  SOUTH  KOREA
+				KR
+
+00-C0-D2   (hex)		SYNTELLECT, INC.
+00C0D2     (base 16)		SYNTELLECT, INC.
+				15810 N. 28TH AVENUE
+				PHOENIX  AZ  85023
+				US
+
+00-C0-7E   (hex)		KUBOTA CORPORATION ELECTRONIC
+00C07E     (base 16)		KUBOTA CORPORATION ELECTRONIC
+				DEVICE DEPT.
+				  JAPAN  #581
+				JP
+
+00-C0-DD   (hex)		QLogic Corporation
+00C0DD     (base 16)		QLogic Corporation
+				6321 Bury Dr.
+				Eden Prarie  MN  55346
+				US
+
+00-C0-1B   (hex)		SOCKET COMMUNICATIONS, INC.
+00C01B     (base 16)		SOCKET COMMUNICATIONS, INC.
+				2823 WHIPPLE RD.
+				UNION CITY  CA  94587
+				US
+
+00-40-6F   (hex)		SYNC RESEARCH INC.
+00406F     (base 16)		SYNC RESEARCH INC.
+				7 STUDEBAKER
+				IRVINE  CA  92718
+				US
+
+00-40-F3   (hex)		NETCOR
+0040F3     (base 16)		NETCOR
+				850 AUBURN COURT
+				FREMONT  CA  94538
+				US
+
+00-40-4B   (hex)		MAPLE COMPUTER SYSTEMS
+00404B     (base 16)		MAPLE COMPUTER SYSTEMS
+				P.O. BOX 10050
+				CANADA  ALA  4L5
+				CA
+
+00-40-33   (hex)		ADDTRON TECHNOLOGY CO., LTD.
+004033     (base 16)		ADDTRON TECHNOLOGY CO., LTD.
+				46560 FREMONT BLVD. #303
+				FREMONT  CA  94538
+				US
+
+00-C0-8E   (hex)		NETWORK INFORMATION TECHNOLOGY
+00C08E     (base 16)		NETWORK INFORMATION TECHNOLOGY
+				10430 S. DE ANZA BLVD.
+				CUPERTINO  CA  95014
+				US
+
+00-C0-C7   (hex)		SPARKTRUM MICROSYSTEMS, INC.
+00C0C7     (base 16)		SPARKTRUM MICROSYSTEMS, INC.
+				2860 ZANKER ROAD,  STE.#210
+				SAN JOSE  CA  95134
+				US
+
+00-C0-C4   (hex)		COMPUTER OPERATIONAL
+00C0C4     (base 16)		COMPUTER OPERATIONAL
+				REQUIREMENT ANALYSTS LTD
+				GU12 4LZ  GU12 4LZ  ENGLAND
+				GB
+
+00-C0-12   (hex)		NETSPAN CORPORATION
+00C012     (base 16)		NETSPAN CORPORATION
+				1411 E. CAMPBELL RD
+				RICHARDSON  TX  75081
+				US
+
+00-40-AD   (hex)		SMA REGELSYSTEME GMBH
+0040AD     (base 16)		SMA REGELSYSTEME GMBH
+				HANNOVERSCHE STR. 1-5
+				    
+				DE
+
+00-40-6D   (hex)		LANCO, INC.
+00406D     (base 16)		LANCO, INC.
+				800 WEST AIRPORT FREEWAY
+				IRVING  TX  75062
+				US
+
+00-40-CD   (hex)		TERA MICROSYSTEMS, INC.
+0040CD     (base 16)		TERA MICROSYSTEMS, INC.
+				2500 GREAT AMERICA PARKWAY
+				SANTA CLARA  CA  95054
+				US
+
+00-40-F5   (hex)		OEM ENGINES
+0040F5     (base 16)		OEM ENGINES
+				1190 DELL AVENUE, STE.
+				CAMPBELL  CA  95008
+				US
+
+00-40-39   (hex)		OPTEC DAIICHI DENKO CO., LTD.
+004039     (base 16)		OPTEC DAIICHI DENKO CO., LTD.
+				FIBER OPTICS & TELECOM. DIV.
+				    JAPAN
+				
+
+00-40-79   (hex)		JUKO MANUFACTURE COMPANY, LTD.
+004079     (base 16)		JUKO MANUFACTURE COMPANY, LTD.
+				FLAT C, 3RD FLOOR, CDW BLDG.
+				  HONG  KONG
+				HK
+
+00-C0-20   (hex)		ARCO ELECTRONIC, CONTROL LTD.
+00C020     (base 16)		ARCO ELECTRONIC, CONTROL LTD.
+				2750 NORTH 29TH AVE.-STE.#316
+				HOLLYWOOD  FL  33020
+				US
+
+00-C0-E7   (hex)		FIBERDATA AB
+00C0E7     (base 16)		FIBERDATA AB
+				P.O. BOX 20095
+				    
+				SE
+
+00-C0-5F   (hex)		FINE-PAL COMPANY LIMITED
+00C05F     (base 16)		FINE-PAL COMPANY LIMITED
+				RM. 9, 11F, KINGSFORD IND. CTR
+				  HONG  KONG
+				HK
+
+00-40-AE   (hex)		DELTA CONTROLS, INC.
+0040AE     (base 16)		DELTA CONTROLS, INC.
+				13520 78TH AVENUE
+				CANADA  V3W  8J6
+				CA
+
+00-40-F6   (hex)		KATRON COMPUTERS INC.
+0040F6     (base 16)		KATRON COMPUTERS INC.
+				4 FL. NO. 2, ALLEY 23
+				TAIPEI  TAIPEI  TAIWAN
+				TW
+
+00-40-86   (hex)		MICHELS & KLEBERHOFF COMPUTER
+004086     (base 16)		MICHELS & KLEBERHOFF COMPUTER
+				GATHE 117
+				    
+				DE
+
+00-40-92   (hex)		ASP COMPUTER PRODUCTS, INC.
+004092     (base 16)		ASP COMPUTER PRODUCTS, INC.
+				160 SAN GABRIEL DRIVE
+				SUNNYVALE  CA  94086
+				US
+
+00-40-68   (hex)		EXTENDED SYSTEMS
+004068     (base 16)		EXTENDED SYSTEMS
+				6123 NORTH MEEKER AVENUE
+				BOISE  ID  83704
+				US
+
+00-40-78   (hex)		WEARNES AUTOMATION PTE LTD
+004078     (base 16)		WEARNES AUTOMATION PTE LTD
+				801 LORONG 7, TOA PAYOH
+				  SINGAPORE  1231
+				SG
+
+00-40-F4   (hex)		CAMEO COMMUNICATIONS, INC.
+0040F4     (base 16)		CAMEO COMMUNICATIONS, INC.
+				71 SPITBROOK ROAD, STE #410
+				NASHUA  NH  030603
+				US
+
+00-40-B4   (hex)		NEXTCOM K.K.
+0040B4     (base 16)		NEXTCOM K.K.
+				1-12-1 SHIBUYA
+				    
+				JP
+
+00-40-B0   (hex)		BYTEX CORPORATION, ENGINEERING
+0040B0     (base 16)		BYTEX CORPORATION, ENGINEERING
+				13873 PARK CENTER ROAD
+				HERNDON  VA  22071
+				US
+
+00-80-D9   (hex)		EMK Elektronik GmbH & Co. KG
+0080D9     (base 16)		EMK Elektronik GmbH & Co. KG
+				Obere Bergstrasse 28
+				75335  Dobel  
+				DE
+
+00-40-59   (hex)		YOSHIDA KOGYO K. K.
+004059     (base 16)		YOSHIDA KOGYO K. K.
+				TECHNICAL RESEARCH DEPT.
+				  939  
+				JP
+
+00-40-95   (hex)		R.P.T. INTERGROUPS INT'L LTD.
+004095     (base 16)		R.P.T. INTERGROUPS INT'L LTD.
+				9F, 50 MIN CHUAN RD
+				TAIWAN  TAIWAN  R.O.C.
+				TW
+
+00-40-35   (hex)		OPCOM
+004035     (base 16)		OPCOM
+				1215 W. CROSBY RD.
+				CARROLLTON  TX  75006
+				US
+
+00-40-5C   (hex)		FUTURE SYSTEMS, INC.
+00405C     (base 16)		FUTURE SYSTEMS, INC.
+				ROOM 102 DONG BANG B/D,
+				SEOUL 130-080  SEOUL 130-080  KOREA
+				KR
+
+00-40-61   (hex)		DATATECH ENTERPRISES CO., LTD.
+004061     (base 16)		DATATECH ENTERPRISES CO., LTD.
+				(LIN KOU INDUSTRIAL ZONE SEC,4
+				TAOYUAN COUNTY  TAIWAN  R.O.C.
+				TW
+
+00-00-8C   (hex)		Alloy Computer Products (Australia) Pty Ltd
+00008C     (base 16)		Alloy Computer Products (Australia) Pty Ltd
+				Unit 4/585 Blackburn Road
+				Notting Hill  Victoria  3168
+				AU
+
+00-40-B9   (hex)		MACQ ELECTRONIQUE SA
+0040B9     (base 16)		MACQ ELECTRONIQUE SA
+				RUE DE L'AERONEF 2
+				    
+				BE
+
+00-40-BB   (hex)		GOLDSTAR CABLE CO., LTD.
+0040BB     (base 16)		GOLDSTAR CABLE CO., LTD.
+				555, HOGYE-DONG, ANYANG-SHI
+				    KOREA
+				KR
+
+00-40-B1   (hex)		CODONICS INC.
+0040B1     (base 16)		CODONICS INC.
+				17991 ENGLEWOOD DRIVE
+				MIDDLEBURG HTS  OH  44130
+				US
+
+00-40-F8   (hex)		SYSTEMHAUS DISCOM
+0040F8     (base 16)		SYSTEMHAUS DISCOM
+				DISTRIBUTED COMPUTING GMBH
+				    
+				DE
+
+00-40-D2   (hex)		PAGINE CORPORATION
+0040D2     (base 16)		PAGINE CORPORATION
+				1961-A CONCOURSE DRIVE
+				SAN JOSE  CA  95131
+				US
+
+00-40-24   (hex)		COMPAC INC.
+004024     (base 16)		COMPAC INC.
+				16-7 NIHONBASI HAMACHO 3-CHO
+				    
+				JP
+
+00-40-E9   (hex)		ACCORD SYSTEMS, INC.
+0040E9     (base 16)		ACCORD SYSTEMS, INC.
+				572 VALLEY WAY
+				MILPITAS  CA  95035
+				US
+
+00-40-03   (hex)		Emerson Process Management Power & Water Solutions, Inc.
+004003     (base 16)		Emerson Process Management Power & Water Solutions, Inc.
+				200 Beta Drive
+				PITTSBURGH  PA  15238
+				US
+
+00-40-90   (hex)		ANSEL COMMUNICATIONS
+004090     (base 16)		ANSEL COMMUNICATIONS
+				1701 JUNCTION COURT
+				SAN JOSE  CA  95112
+				US
+
+00-40-C5   (hex)		MICOM COMMUNICATIONS INC.
+0040C5     (base 16)		MICOM COMMUNICATIONS INC.
+				4100 LOS ANGELES AVENUE
+				SIMI VALLEY  CA  93063
+				US
+
+00-40-20   (hex)		CommScope Inc
+004020     (base 16)		CommScope Inc
+				Unit 1, Kinmel Park
+				Bodelwyddan  RHYL  LL18 5TZ
+				GB
+
+00-40-48   (hex)		SMD INFORMATICA S.A.
+004048     (base 16)		SMD INFORMATICA S.A.
+				LARGO MOVIMENTO DAS FORCAS
+				    
+				PT
+
+00-40-7C   (hex)		QUME CORPORATION
+00407C     (base 16)		QUME CORPORATION
+				500 YOSEMITE DRIVE, M/S-29
+				MILPITAS  CA  95035-5426
+				US
+
+00-40-7F   (hex)		FLIR Systems
+00407F     (base 16)		FLIR Systems
+				BOX 3
+				    
+				SE
+
+00-40-2D   (hex)		HARRIS ADACOM CORPORATION
+00402D     (base 16)		HARRIS ADACOM CORPORATION
+				1100 VENTURE COURT
+				CARROLLTON  TX  75006-5412
+				US
+
+00-80-A6   (hex)		REPUBLIC TECHNOLOGY, INC.
+0080A6     (base 16)		REPUBLIC TECHNOLOGY, INC.
+				P.O. BOX 141006
+				AUSTIN  TX  78714
+				US
+
+00-40-DE   (hex)		Elsag Datamat spa
+0040DE     (base 16)		Elsag Datamat spa
+				ELSAG S.P.A.
+				GENOVA    16154
+				IT
+
+00-40-C9   (hex)		NCUBE
+0040C9     (base 16)		NCUBE
+				919 EAST HILLSDALE BLVD.
+				FOSTER CITY  CA  94404
+				US
+
+00-80-32   (hex)		ACCESS CO., LTD.
+008032     (base 16)		ACCESS CO., LTD.
+				HIEI-KUDAN BLDG. B1
+				    
+				JP
+
+00-80-CF   (hex)		EMBEDDED PERFORMANCE INC.
+0080CF     (base 16)		EMBEDDED PERFORMANCE INC.
+				3385 SCOTT BLVD.
+				SANTA CLARA  CA  95054-3115
+				US
+
+00-80-90   (hex)		MICROTEK INTERNATIONAL, INC.
+008090     (base 16)		MICROTEK INTERNATIONAL, INC.
+				3300 NW 211TH TERRACE
+				HILLSBOR  OR  97124-7136
+				US
+
+00-40-44   (hex)		QNIX COMPUTER CO., LTD.
+004044     (base 16)		QNIX COMPUTER CO., LTD.
+				8,9F KOREAN TEACHER'S MUT.BLDG
+				SEOUL  KOREA  150-010
+				KR
+
+00-80-C4   (hex)		DOCUMENT TECHNOLOGIES, INC.
+0080C4     (base 16)		DOCUMENT TECHNOLOGIES, INC.
+				1300 CHARLESTON ROAD
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-80-5B   (hex)		CONDOR SYSTEMS, INC.
+00805B     (base 16)		CONDOR SYSTEMS, INC.
+				2133 SAMARILTAN DRIVE
+				SAN JOSE  CA  95124
+				US
+
+00-80-43   (hex)		NETWORLD, INC.
+008043     (base 16)		NETWORLD, INC.
+				KANDA 3 AMEREX BLDG.
+				    
+				JP
+
+00-40-DF   (hex)		DIGALOG SYSTEMS, INC.
+0040DF     (base 16)		DIGALOG SYSTEMS, INC.
+				3180 SOUTH 166TH STREET
+				NEW BERLIN  WI  53151
+				US
+
+00-40-09   (hex)		TACHIBANA TECTRON CO., LTD.
+004009     (base 16)		TACHIBANA TECTRON CO., LTD.
+				SYSTEMATIC EQUIPMENT DIVISION
+				    
+				JP
+
+00-40-A0   (hex)		GOLDSTAR CO., LTD.
+0040A0     (base 16)		GOLDSTAR CO., LTD.
+				6 GA 3B MUNLAE YEONGDEUNGPO
+				    KOREA
+				KR
+
+00-40-FC   (hex)		IBR COMPUTER TECHNIK GMBH
+0040FC     (base 16)		IBR COMPUTER TECHNIK GMBH
+				FRANKFURTER STR. 114
+				  WEST  
+				DE
+
+00-80-AF   (hex)		ALLUMER CO., LTD.
+0080AF     (base 16)		ALLUMER CO., LTD.
+				2-8-8 CHUO-CHO, MEGURO-KU
+				    
+				JP
+
+00-80-84   (hex)		THE CLOUD INC.
+008084     (base 16)		THE CLOUD INC.
+				CLOUD BLDG.
+				    KOREA
+				KR
+
+00-80-F3   (hex)		SUN ELECTRONICS CORP.
+0080F3     (base 16)		SUN ELECTRONICS CORP.
+				250 ASAHI KOCHINO-CHO
+				  483  
+				JP
+
+00-80-99   (hex)		Eaton Industries GmbH
+008099     (base 16)		Eaton Industries GmbH
+				Hein-Moeller - Straße 7-11
+				    
+				DE
+
+00-80-8D   (hex)		WESTCOAST TECHNOLOGY B.V.
+00808D     (base 16)		WESTCOAST TECHNOLOGY B.V.
+				P.O. BOX 3317
+				    
+				NL
+
+00-80-BE   (hex)		ARIES RESEARCH
+0080BE     (base 16)		ARIES RESEARCH
+				46791 FREMOND BLVD.
+				FREMONT  CA  94538
+				US
+
+00-80-15   (hex)		SEIKO SYSTEMS, INC.
+008015     (base 16)		SEIKO SYSTEMS, INC.
+				8,Nakase 1-chome,Mihama-ku
+				    
+				JP
+
+00-80-D2   (hex)		SHINNIHONDENKO CO., LTD.
+0080D2     (base 16)		SHINNIHONDENKO CO., LTD.
+				6-8 NISHITENMA 2 CHOME
+				    
+				JP
+
+00-80-89   (hex)		TECNETICS (PTY) LTD.
+008089     (base 16)		TECNETICS (PTY) LTD.
+				P.O. BOX/POSBUS 56412
+				  SOUTH  AFRICA
+				ZA
+
+00-80-6F   (hex)		ONELAN LTD.
+00806F     (base 16)		ONELAN LTD.
+				P.O. BOX 107
+				  UNITED  KINGDOM
+				GB
+
+00-80-81   (hex)		KENDALL SQUARE RESEARCH CORP.
+008081     (base 16)		KENDALL SQUARE RESEARCH CORP.
+				170 TRACER LANE
+				WALTHAM  MA  02154-1379
+				US
+
+00-80-9C   (hex)		LUXCOM, INC.
+00809C     (base 16)		LUXCOM, INC.
+				3249 LAURELVIEW COURT
+				FREMONT  CA  94538
+				US
+
+00-80-65   (hex)		CYBERGRAPHIC SYSTEMS PTY LTD.
+008065     (base 16)		CYBERGRAPHIC SYSTEMS PTY LTD.
+				290 BURWOOD ROAD
+				    
+				AU
+
+00-80-19   (hex)		DAYNA COMMUNICATIONS, INC.
+008019     (base 16)		DAYNA COMMUNICATIONS, INC.
+				50 SOUTH MAIN STREET-#530
+				SALT LAKE CITY  UTAH  84144
+				US
+
+00-80-50   (hex)		ZIATECH CORPORATION
+008050     (base 16)		ZIATECH CORPORATION
+				3433 ROBERTO COURT
+				SAN LUIS OBISPO  CA  93401
+				US
+
+00-80-A4   (hex)		LIBERTY ELECTRONICS
+0080A4     (base 16)		LIBERTY ELECTRONICS
+				332 HARBOR WAY
+				SOUTH SAN FRANCISCO  CA  94080
+				US
+
+00-80-CD   (hex)		MICRONICS COMPUTER, INC.
+0080CD     (base 16)		MICRONICS COMPUTER, INC.
+				45365 NORTHPORT LOOP WEST
+				FREMONT  CA  94538
+				US
+
+00-80-03   (hex)		HYTEC ELECTRONICS LTD.
+008003     (base 16)		HYTEC ELECTRONICS LTD.
+				5 CRADOCK ROAD
+				    ENGLAND
+				GB
+
+00-80-52   (hex)		TECHNICALLY ELITE CONCEPTS
+008052     (base 16)		TECHNICALLY ELITE CONCEPTS
+				2615 PACIFIC COAST HIGHWAY
+				HERMOSA BEACH  CA  90250
+				US
+
+00-80-5D   (hex)		CANSTAR
+00805D     (base 16)		CANSTAR
+				3900 VICTORIA PARK AVENUE
+				  M2H  3H7
+				CA
+
+00-80-4F   (hex)		DAIKIN INDUSTRIES, LTD.
+00804F     (base 16)		DAIKIN INDUSTRIES, LTD.
+				ELECTRONICS DIVISION
+				  JAPAN  525
+				JP
+
+00-80-05   (hex)		CACTUS COMPUTER INC.
+008005     (base 16)		CACTUS COMPUTER INC.
+				1120 METROCREST DRIVE
+				CARROLLTON  TX  75006
+				US
+
+00-80-6D   (hex)		CENTURY SYSTEMS CORP.
+00806D     (base 16)		CENTURY SYSTEMS CORP.
+				2-8-12 MINAMI-CHO
+				  185  
+				JP
+
+00-80-94   (hex)		ALFA LAVAL AUTOMATION AB
+008094     (base 16)		ALFA LAVAL AUTOMATION AB
+				ADN
+				    
+				SE
+
+00-00-41   (hex)		ICE CORPORATION
+000041     (base 16)		ICE CORPORATION
+				17945 SKYPARK CIRCLE
+				IRVINE  CA  92714
+				US
+
+00-00-86   (hex)		MEGAHERTZ CORPORATION
+000086     (base 16)		MEGAHERTZ CORPORATION
+				605 NORTH--5600 WEST
+				SALT LAKE CITY  UT  84116-3738
+				US
+
+00-00-92   (hex)		COGENT DATA TECHNOLOGIES
+000092     (base 16)		COGENT DATA TECHNOLOGIES
+				640 MULLIS STREET
+				FRIDAY HARBOR  WA  98250
+				US
+
+00-00-58   (hex)		RACORE COMPUTER PRODUCTS INC.
+000058     (base 16)		RACORE COMPUTER PRODUCTS INC.
+				2355 SOUTH 1070 WEST
+				SALT LAKE CITY  UT  84119
+				US
+
+00-80-74   (hex)		FISHER CONTROLS
+008074     (base 16)		FISHER CONTROLS
+				1712 CENTRE CREEK DRIVE
+				AUSTIN  TX  78754
+				US
+
+00-80-30   (hex)		NEXUS ELECTRONICS
+008030     (base 16)		NEXUS ELECTRONICS
+				39 SPRINGFIELD ROAD
+				  UNITED  KINGDOM
+				GB
+
+00-00-55   (hex)		COMMISSARIAT A L`ENERGIE ATOM.
+000055     (base 16)		COMMISSARIAT A L`ENERGIE ATOM.
+				31, RUE DE LA FEDERATION
+				    
+				FR
+
+00-80-C9   (hex)		ALBERTA MICROELECTRONIC CENTRE
+0080C9     (base 16)		ALBERTA MICROELECTRONIC CENTRE
+				318, 11315 - 87 AVENUE
+				    
+				CA
+
+00-80-0C   (hex)		VIDECOM LIMITED
+00800C     (base 16)		VIDECOM LIMITED
+				NEWTOWN ESTATE
+				    ENGLAND
+				GB
+
+00-80-7D   (hex)		EQUINOX SYSTEMS INC.
+00807D     (base 16)		EQUINOX SYSTEMS INC.
+				14260 SW 119TH AVENUE
+				MIAMI  FL  33186
+				US
+
+00-80-63   (hex)		Hirschmann Automation and Control GmbH
+008063     (base 16)		Hirschmann Automation and Control GmbH
+				Stuttgarter Straße 45-51
+				Neckartenzlingen    D-72654
+				DE
+
+00-80-EE   (hex)		THOMSON CSF
+0080EE     (base 16)		THOMSON CSF
+				51 ESPLANADE DU GENERAL
+				    
+				FR
+
+00-80-8E   (hex)		RADSTONE TECHNOLOGY
+00808E     (base 16)		RADSTONE TECHNOLOGY
+				WATER LANE, TOWCESTER
+				    ENGLAND
+				GB
+
+00-80-96   (hex)		HUMAN DESIGNED SYSTEMS, INC.
+008096     (base 16)		HUMAN DESIGNED SYSTEMS, INC.
+				421 FEHELEY DRIVE
+				KING OF PRUSSIA  PA  19406
+				US
+
+00-80-DA   (hex)		Bruel & Kjaer Sound & Vibration Measurement A/S
+0080DA     (base 16)		Bruel & Kjaer Sound & Vibration Measurement A/S
+				Skodsborgvej 307 
+				    
+				DK
+
+00-80-3E   (hex)		SYNERNETICS
+00803E     (base 16)		SYNERNETICS
+				85 RANGEWAY ROAD
+				NORTH BILLERICA  MA  01862
+				US
+
+00-80-CE   (hex)		BROADCAST TELEVISION SYSTEMS
+0080CE     (base 16)		BROADCAST TELEVISION SYSTEMS
+				P.O. BOX 30816
+				  Utah  84130-0816
+				US
+
+00-80-1A   (hex)		BELL ATLANTIC
+00801A     (base 16)		BELL ATLANTIC
+				N92 W14612  ANTHONY AVENUE
+				MENOMONEE FALLS  WI  53051
+				US
+
+00-80-DE   (hex)		GIPSI S.A.
+0080DE     (base 16)		GIPSI S.A.
+				2,BD VAUBAN - B.P. 268
+				    
+				FR
+
+00-80-02   (hex)		SATELCOM (UK) LTD
+008002     (base 16)		SATELCOM (UK) LTD
+				TECHNOLOGY TRANSFER CENTRE
+				    ENGLAND
+				GB
+
+00-80-64   (hex)		WYSE TECHNOLOGY LLC
+008064     (base 16)		WYSE TECHNOLOGY LLC
+				3471 NORTH FIRST STREET M/S
+				SAN JOSE  CA  95134
+				US
+
+00-80-48   (hex)		COMPEX INCORPORATED
+008048     (base 16)		COMPEX INCORPORATED
+				4055 EAST LA PALMA
+				ANAHEIM  CA  92807
+				US
+
+00-80-85   (hex)		H-THREE SYSTEMS CORPORATION
+008085     (base 16)		H-THREE SYSTEMS CORPORATION
+				100 PARK DRIVE, SUITE 204
+				  NC  27709
+				US
+
+00-80-4C   (hex)		CONTEC CO., LTD.
+00804C     (base 16)		CONTEC CO., LTD.
+				3-9-31, HIMESATO
+				    
+				JP
+
+00-80-8F   (hex)		C. ITOH ELECTRONICS, INC.
+00808F     (base 16)		C. ITOH ELECTRONICS, INC.
+				2505 MCCABE WAY
+				IRVINE  CA  92714
+				US
+
+00-00-52   (hex)		Intrusion.com, Inc.
+000052     (base 16)		Intrusion.com, Inc.
+				1101 E. ARAPAHO ROAD
+				RICHARDSON  TX  75081
+				
+
+00-80-FF   (hex)		SOC. DE TELEINFORMATIQUE RTC
+0080FF     (base 16)		SOC. DE TELEINFORMATIQUE RTC
+				P.O. BOX 955 PLACE DU PARC
+				CANADA  H2W  2N1
+				
+
+00-00-F7   (hex)		YOUTH KEEP ENTERPRISE CO LTD
+0000F7     (base 16)		YOUTH KEEP ENTERPRISE CO LTD
+				3/F NO. 712 MINTSU E. ROAD
+				    ROC
+				TW
+
+00-00-C7   (hex)		ARIX CORPORATION
+0000C7     (base 16)		ARIX CORPORATION
+				ENGINEERING MAIL STOP
+				SUNNYVALE  CA  94089
+				US
+
+00-00-D1   (hex)		ADAPTEC INCORPORATED
+0000D1     (base 16)		ADAPTEC INCORPORATED
+				M/S 180
+				MILPITAS  CA  95035
+				US
+
+00-00-16   (hex)		DU PONT PIXEL SYSTEMS     .
+000016     (base 16)		DU PONT PIXEL SYSTEMS     .
+				MEADLAKE PLACE
+				    ENGLAND
+				GB
+
+00-00-E1   (hex)		GRID SYSTEMS
+0000E1     (base 16)		GRID SYSTEMS
+				47211 LAKEVIEW BOULEVARD
+				FREMONT  CA  94537-5003
+				US
+
+00-00-81   (hex)		Bay Networks
+000081     (base 16)		Bay Networks
+				PO Box 58185
+				Santa Clara  CA  95052-8185
+				US
+
+00-00-29   (hex)		IMC NETWORKS CORP.
+000029     (base 16)		IMC NETWORKS CORP.
+				16931 MILLIKEN AVE.
+				IRVINE  CA  92714-5013
+				US
+
+00-00-0A   (hex)		OMRON TATEISI ELECTRONICS CO.
+00000A     (base 16)		OMRON TATEISI ELECTRONICS CO.
+				SECTION NFF, SYSTEM R&D LABS.
+				KYOTO  617  
+				JP
+
+00-00-0D   (hex)		FIBRONICS LTD.
+00000D     (base 16)		FIBRONICS LTD.
+				MATAM TECHNOLOGY CENTER
+				    
+				IL
+
+00-00-24   (hex)		CONNECT AS
+000024     (base 16)		CONNECT AS
+				HOERKAER 7-9
+				    
+				DK
+
+00-00-67   (hex)		SOFT * RITE, INC.
+000067     (base 16)		SOFT * RITE, INC.
+				15392 ASSEMBLY LANE, UNIT A
+				HUNTINGTON BEACH  CA  92649
+				US
+
+00-00-D2   (hex)		SBE, INC.
+0000D2     (base 16)		SBE, INC.
+				4550 NORTH CANYON ROAD
+				SAN RAMON  CA  94583
+				US
+
+00-00-37   (hex)		OXFORD METRICS LIMITED
+000037     (base 16)		OXFORD METRICS LIMITED
+				UNIT 8, 7 WEST WAY,
+				  UNITED  KINGDOM
+				GB
+
+00-00-FB   (hex)		RECHNER ZUR KOMMUNIKATION
+0000FB     (base 16)		RECHNER ZUR KOMMUNIKATION
+				BITZENSTR. 11
+				    
+				DE
+
+00-00-E2   (hex)		ACER TECHNOLOGIES CORP.
+0000E2     (base 16)		ACER TECHNOLOGIES CORP.
+				401 CHARCOT AVE.
+				SAN JOSE  CA  95131
+				US
+
+00-00-BA   (hex)		SIIG, INC.
+0000BA     (base 16)		SIIG, INC.
+				6078 STEWART AVENUE
+				FREMONT  CA  94538
+				US
+
+00-00-2A   (hex)		TRW - SEDD/INP
+00002A     (base 16)		TRW - SEDD/INP
+				1800 GLENN CURTISS STREET
+				CARSON  CA  90746
+				US
+
+00-00-2C   (hex)		AUTOTOTE LIMITED
+00002C     (base 16)		AUTOTOTE LIMITED
+				100 BELLEVUE ROAD
+				NEWARK  DELAWARE  19714
+				US
+
+00-00-83   (hex)		TADPOLE TECHNOLOGY PLC
+000083     (base 16)		TADPOLE TECHNOLOGY PLC
+				137 DITTON WALK
+				    ENGLAND
+				GB
+
+00-00-F3   (hex)		GANDALF DATA LIMITED
+0000F3     (base 16)		GANDALF DATA LIMITED
+				130 COLONNADE ROAD SOUTH
+				    
+				CA
+
+00-00-B0   (hex)		RND-RAD NETWORK DEVICES
+0000B0     (base 16)		RND-RAD NETWORK DEVICES
+				ATIDIM TECHNOL'CL BLDG. 1
+				    
+				IL
+
+00-00-CF   (hex)		HAYES MICROCOMPUTER PRODUCTS
+0000CF     (base 16)		HAYES MICROCOMPUTER PRODUCTS
+				(CANADA) LTD.
+				    
+				CA
+
+00-00-56   (hex)		DR. B. STRUCK
+000056     (base 16)		DR. B. STRUCK
+				POB 1147 BAECKERBARG 6
+				    W-GERMANY
+				DE
+
+00-00-6C   (hex)		Private
+00006C     (base 16)		Private
+
+00-00-A9   (hex)		NETWORK SYSTEMS CORP.
+0000A9     (base 16)		NETWORK SYSTEMS CORP.
+				7600 BOONE AVENUE NORTH
+				MINNEAPOLIS  MN  55428-1099
+				US
+
+00-00-EF   (hex)		KTI
+0000EF     (base 16)		KTI
+				2157 O'TOOLE AVENUE
+				SAN JOSE  CA  95131
+				US
+
+00-00-25   (hex)		RAMTEK CORP.
+000025     (base 16)		RAMTEK CORP.
+				810 W. MAUDE AVENUE
+				SUNNYVALE  CA  94086
+				US
+
+00-00-AF   (hex)		Canberra Industries, Inc.
+0000AF     (base 16)		Canberra Industries, Inc.
+				800 Research Parkway
+				Meriden  CT  06450
+				US
+
+00-00-76   (hex)		ABEKAS VIDEO SYSTEM
+000076     (base 16)		ABEKAS VIDEO SYSTEM
+				101 GALVESTON DRIVE
+				REDWOOD CITY  CA  94063
+				US
+
+08-00-55   (hex)		STANFORD TELECOMM. INC.
+080055     (base 16)		STANFORD TELECOMM. INC.
+				1221 CROSSMAN
+				SUNNYVALE  CA  94089
+				US
+
+08-00-53   (hex)		MIDDLE EAST TECH. UNIVERSITY
+080053     (base 16)		MIDDLE EAST TECH. UNIVERSITY
+				DEPARTMENT OF
+				  ANKARA  
+				TR
+
+08-00-8E   (hex)		Tandem Computers
+08008E     (base 16)		Tandem Computers
+				14231 Tendem Blvd.
+				Austin  TX  78728 - 6610
+				US
+
+08-00-84   (hex)		TOMEN ELECTRONICS CORP.
+080084     (base 16)		TOMEN ELECTRONICS CORP.
+				1-1 UCHISAIWAI-CHO 2CHOME
+				    
+				JP
+
+08-00-85   (hex)		ELXSI
+080085     (base 16)		ELXSI
+				2334 LUNDY PLACE
+				SAN JOSE  CA  95131
+				US
+
+08-00-82   (hex)		VERITAS SOFTWARE
+080082     (base 16)		VERITAS SOFTWARE
+				4800 GREAT AMERICA PARKWAY
+				SANTA CLARA  CA  95054
+				US
+
+08-00-80   (hex)		AES DATA INC.
+080080     (base 16)		AES DATA INC.
+				1900 MINNESOTA COURT
+				CANADA  L5N  L5N 3C9
+				CA
+
+08-00-77   (hex)		TSL COMMUNICATIONS LTD.
+080077     (base 16)		TSL COMMUNICATIONS LTD.
+				THE LANDSBURY ESTATE
+				    ENGLAND
+				GB
+
+08-00-74   (hex)		CASIO COMPUTER CO. LTD.
+080074     (base 16)		CASIO COMPUTER CO. LTD.
+				3-2-1 SAKAE-CHO
+				  190-11  
+				JP
+
+08-00-6E   (hex)		MASSCOMP
+08006E     (base 16)		MASSCOMP
+				ONE TECHNOLOGY PARK
+				WESTFORD  MA  01886
+				US
+
+08-00-68   (hex)		RIDGE COMPUTERS
+080068     (base 16)		RIDGE COMPUTERS
+				2451 MISSION COLLEGE BLVD.
+				SANTA CLARA  CA  95054
+				US
+
+08-00-63   (hex)		PLESSEY
+080063     (base 16)		PLESSEY
+				PLESSEY - UK LIMITED
+				JAMAICA  NY  11434
+				US
+
+08-00-7B   (hex)		SANYO ELECTRIC CO. LTD.
+08007B     (base 16)		SANYO ELECTRIC CO. LTD.
+				1-18-13 HASHIRIDANI
+				OSAKA  573  
+				JP
+
+08-00-7C   (hex)		VITALINK COMMUNICATIONS CORP.
+08007C     (base 16)		VITALINK COMMUNICATIONS CORP.
+				48761 KATO ROAD
+				FREMONT  CA  94538
+				US
+
+00-00-DF   (hex)		BELL & HOWELL PUB SYS DIV
+0000DF     (base 16)		BELL & HOWELL PUB SYS DIV
+				OLD MANSFIELD ROAD
+				WOOSTER  OH  44691-9050
+				US
+
+00-00-F9   (hex)		QUOTRON SYSTEMS INC.
+0000F9     (base 16)		QUOTRON SYSTEMS INC.
+				5454 BEETHOVEN ST.
+				LOS ANGELES  CA  90066
+				US
+
+08-00-60   (hex)		INDUSTRIAL NETWORKING INC.
+080060     (base 16)		INDUSTRIAL NETWORKING INC.
+				3990 FREEDOM CIRCLE
+				SANTA CLARA  CA  95050
+				US
+
+08-00-4C   (hex)		HYDRA COMPUTER SYSTEMS INC.
+08004C     (base 16)		HYDRA COMPUTER SYSTEMS INC.
+				12 MERCER ROAD
+				NATICK  MA  01760
+				US
+
+08-00-47   (hex)		SEQUENT COMPUTER SYSTEMS INC.
+080047     (base 16)		SEQUENT COMPUTER SYSTEMS INC.
+				15450 S.W. KOLL PARKWAY   .
+				BEAVERTON  OR  97006
+				US
+
+08-00-4A   (hex)		BANYAN SYSTEMS INC.
+08004A     (base 16)		BANYAN SYSTEMS INC.
+				135 FLANDERS ROAD
+				WESTBORO  MA  01581
+				US
+
+08-00-44   (hex)		DAVID SYSTEMS INC.
+080044     (base 16)		DAVID SYSTEMS INC.
+				615 TASMAN DRIVE
+				SUNNYVALE  CA  94088
+				US
+
+08-00-41   (hex)		RACAL-MILGO INFORMATION SYS..
+080041     (base 16)		RACAL-MILGO INFORMATION SYS..
+				400 EMBASSY ROW
+				ATLANTA  GA  30328
+				US
+
+08-00-37   (hex)		FUJI-XEROX CO. LTD.
+080037     (base 16)		FUJI-XEROX CO. LTD.
+				ADVANCED TECH & ENG'G CENTER
+				    
+				JP
+
+08-00-35   (hex)		MICROFIVE CORPORATION
+080035     (base 16)		MICROFIVE CORPORATION
+				3560 HYLAND AVENUE
+				COSTA MESA  CA  92626
+				US
+
+08-00-32   (hex)		TIGAN INCORPORATED
+080032     (base 16)		TIGAN INCORPORATED
+				4020 FABIAN WAY
+				PALO ALTO  CA  94303
+				US
+
+08-00-8D   (hex)		XYVISION INC.
+08008D     (base 16)		XYVISION INC.
+				101 EDGEWATER DRIVE
+				WAKEFIELD  MA  01880
+				US
+
+08-00-15   (hex)		STC BUSINESS SYSTEMS
+080015     (base 16)		STC BUSINESS SYSTEMS
+				HOLBROOK HOUSE
+				  UNITED  KINGDOM
+				GB
+
+08-00-42   (hex)		JAPAN MACNICS CORP.
+080042     (base 16)		JAPAN MACNICS CORP.
+				
+				    
+				JP
+
+08-00-66   (hex)		AGFA CORPORATION
+080066     (base 16)		AGFA CORPORATION
+				200 BALLARDVALE STREET
+				WILMINGTON  MA  01887
+				US
+
+08-00-04   (hex)		CROMEMCO INCORPORATED
+080004     (base 16)		CROMEMCO INCORPORATED
+				280 BERNARDO AVENUE
+				MOUNTAIN VIEW  CA  94043
+				US
+
+00-01-C8   (hex)		CONRAD CORP.
+0001C8     (base 16)		CONRAD CORP.
+				
+				    
+				
+
+08-00-3F   (hex)		FRED KOSCHARA ENTERPRISES
+08003F     (base 16)		FRED KOSCHARA ENTERPRISES
+				
+				    
+				
+
+08-00-0B   (hex)		UNISYS CORPORATION
+08000B     (base 16)		UNISYS CORPORATION
+				TOWNSHIP LINE ROAD
+				BLUE BELL  PA  19424
+				US
+
+00-DD-01   (hex)		UNGERMANN-BASS INC.
+00DD01     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-DD-06   (hex)		UNGERMANN-BASS INC.
+00DD06     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+AA-00-03   (hex)		DIGITAL EQUIPMENT CORPORATION
+AA0003     (base 16)		DIGITAL EQUIPMENT CORPORATION
+				LKG 1-2/A19
+				LITTLETON  MA  01460-1289
+				US
+
+00-00-00   (hex)		XEROX CORPORATION
+000000     (base 16)		XEROX CORPORATION
+				M/S 105-50C
+				WEBSTER  NY  14580
+				US
+
+08-00-21   (hex)		3M COMPANY
+080021     (base 16)		3M COMPANY
+				Telecom Division
+				Austin  TX  78726-9000
+				US
+
+02-BB-01   (hex)		OCTOTHORPE CORP.
+02BB01     (base 16)		OCTOTHORPE CORP.
+				285 WEST GREEN STREET
+				PASADENA  CA  91105
+				US
+
+08-00-8A   (hex)		PerfTech, Inc.
+08008A     (base 16)		PerfTech, Inc.
+				613 NW Loop 410
+				SAN ANTONIO  TX  78216
+				US
+
+00-00-3E   (hex)		SIMPACT
+00003E     (base 16)		SIMPACT
+				9210 SKY PARK COURT
+				SAN DIEGO  CA  92123
+				US
+
+00-DD-02   (hex)		UNGERMANN-BASS INC.
+00DD02     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+00-DD-04   (hex)		UNGERMANN-BASS INC.
+00DD04     (base 16)		UNGERMANN-BASS INC.
+				3900 FREEDOM CIRCLE
+				SANTA CLARA  CA  95054
+				US
+
+02-60-86   (hex)		LOGIC REPLACEMENT TECH. LTD.
+026086     (base 16)		LOGIC REPLACEMENT TECH. LTD.
+				14 ARKWRIGHT ROAD
+				  UNITED  KINGDOM
+				GB
+
+08-00-30   (hex)		CERN
+080030     (base 16)		CERN
+				CH-1211 
+				GENEVE  SUISSE/SWITZ  023
+				CH
+
+74-DA-88   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+74DA88     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+CC-32-E5   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+CC32E5     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+1C-3B-F3   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+1C3BF3     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+3C-86-D1   (hex)		vivo Mobile Communication Co., Ltd.
+3C86D1     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+30-1B-97   (hex)		Lierda Science & Technology Group Co.,Ltd
+301B97     (base 16)		Lierda Science & Technology Group Co.,Ltd
+				Lierda Science Park?No.1326 WenyiWestRoad
+				Hangzhou  ZheJiang  311121
+				CN
+
+2C-D2-E3   (hex)		Guangzhou Aoshi Electronic Co.,Ltd
+2CD2E3     (base 16)		Guangzhou Aoshi Electronic Co.,Ltd
+				B1,Huachuang industrial park,Jinshan Avenue,Panyu District
+				Guangzhou  Guangdong  511450
+				CN
+
+14-59-C3   (hex)		Creative Chips GmbH
+1459C3     (base 16)		Creative Chips GmbH
+				Im Bubenstück 1
+				Bingen  Rheinland-Pfalz  55411
+				DE
+
+A0-D8-6F   (hex)		ARGO AI, LLC
+A0D86F     (base 16)		ARGO AI, LLC
+				40, 24th Street, Second Floor
+				Pittsburgh  PA  15222
+				US
+
+E4-67-1E   (hex)		SHEN ZHEN NUO XIN CHENG TECHNOLOGY co., Ltd.
+E4671E     (base 16)		SHEN ZHEN NUO XIN CHENG TECHNOLOGY co., Ltd.
+				Building A2 and 1 F/L, Building A1, 9 Wugang Rd, Xikeng Village, Xikeng Community, Henggang Sub-district, Longgang District
+				Shenzhen    518100
+				CN
+
+68-27-19   (hex)		Microchip Technology Inc.
+682719     (base 16)		Microchip Technology Inc.
+				2355 W. Chandler Blvd.
+				Chandler  AZ  85224
+				US
+
+24-C1-7A   (hex)		BEIJING IACTIVE NETWORK CO.,LTD
+24C17A     (base 16)		BEIJING IACTIVE NETWORK CO.,LTD
+				Room 525, Yiquanhui Building, No. 35 Shangdi East Road, Haidian District
+				BEIJING    100085
+				CN
+
+1C-9C-8C   (hex)		Juniper Networks
+1C9C8C     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+A4-C9-39   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+A4C939     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+34-D7-72   (hex)		Xiamen Yudian Automation Technology Co., Ltd 
+34D772     (base 16)		Xiamen Yudian Automation Technology Co., Ltd 
+				No. 17 North Huoju Rd., Huoju Park, Huoju Hi-Tech District  
+				XIAMEN  FUJIAN   361000 
+				CN
+
+C0-DC-DA   (hex)		Samsung Electronics Co.,Ltd
+C0DCDA     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+04-B4-29   (hex)		Samsung Electronics Co.,Ltd
+04B429     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+48-79-4D   (hex)		Samsung Electronics Co.,Ltd
+48794D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+44-F9-71   (hex)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+44F971     (base 16)		SHENZHEN MERCURY COMMUNICATION TECHNOLOGIES CO.,LTD.
+				3/F, Building R1-B, High-Tech Industrial Park, Nanshan District
+				Shenzhen  Guangdong  518057
+				CN
+
+18-F9-C4   (hex)		BAE Systems
+18F9C4     (base 16)		BAE Systems
+				21 continental boulevard
+				Merrimack  NH  03054
+				US
+
+60-AB-D2   (hex)		Bose Corporation
+60ABD2     (base 16)		Bose Corporation
+				The Mountain
+				Framingham  MA  01701-9168
+				US
+
+F0-EF-86   (hex)		Google, Inc.
+F0EF86     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+E4-C0-CC   (hex)		China Mobile Group Device Co.,Ltd.
+E4C0CC     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+5C-B1-3E   (hex)		Sagemcom Broadband SAS
+5CB13E     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+F4-E5-F2   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4E5F2     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-13-10   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+541310     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+8C-E5-EF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8CE5EF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-CD-23   (hex)		Shenzhenshi Xinzhongxin  Co., Ltd
+A4CD23     (base 16)		Shenzhenshi Xinzhongxin  Co., Ltd
+				Building A3, Donghuan Industrial Zone, Nanpu Road, Shajing Town, Baoan District
+				Shenzhen  Guangdong  518125
+				CN
+
+B8-3A-5A   (hex)		Aruba, a Hewlett Packard Enterprise Company
+B83A5A     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+E4-AA-EA   (hex)		Liteon Technology Corporation
+E4AAEA     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+A0-94-6A   (hex)		Shenzhen XGTEC Technology Co,.Ltd.
+A0946A     (base 16)		Shenzhen XGTEC Technology Co,.Ltd.
+				Room 312, Changhong Science and Technology Building, No.18, South 12 Rd., High-tech Community, Yuehai Street, Nanshan District, Shenzhen
+				Shenzhen  Guangdong  518057
+				CN
+
+1C-2A-A3   (hex)		Shenzhen HongRui Optical Technology Co., Ltd.
+1C2AA3     (base 16)		Shenzhen HongRui Optical Technology Co., Ltd.
+				B#2F Shuangjinhui Industrial Park, Yonghe Road, Heping Village, Fuyong Town, Bao'an Dis
+				Shenzhen  Guangdong  518000
+				CN
+
+38-8E-7A   (hex)		AUTOIT
+388E7A     (base 16)		AUTOIT
+				212, Gasan digital 1-ro
+				Seoul  Geumcheon-gu  08502
+				KR
+
+4C-71-0C   (hex)		Cisco Systems, Inc
+4C710C     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+4C-71-0D   (hex)		Cisco Systems, Inc
+4C710D     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+9C-31-C3   (hex)		BSkyB Ltd
+9C31C3     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+6C-24-A6   (hex)		vivo Mobile Communication Co., Ltd.
+6C24A6     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+9C-5F-5A   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+9C5F5A     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+E4-47-B3   (hex)		zte corporation
+E447B3     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+FC-DB-21   (hex)		SAMSARA NETWORKS INC
+FCDB21     (base 16)		SAMSARA NETWORKS INC
+				525 York St
+				San Francisco  CA  94110
+				US
+
+60-77-71   (hex)		Texas Instruments
+607771     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+D8-CF-89   (hex)		Beijing DoSee Science and Technology Co., Ltd.
+D8CF89     (base 16)		Beijing DoSee Science and Technology Co., Ltd.
+				Room 819-158,Floor 8,XinCaiLiao Chuangye Building,No.7 FengHuiZhong Road, Haidian District
+				Beijing    100094
+				CN
+
+04-AA-E1   (hex)		BEIJING MICROVISION TECHNOLOGY CO.,LTD
+04AAE1     (base 16)		BEIJING MICROVISION TECHNOLOGY CO.,LTD
+				ROOM 207-208,2/F,TAIXIANG COMMERCIAL BUILDING,NO.1A,LONGXIANG ROAD,HAIDIAN DISTRICT,BEIJING,P.R.C
+				BEIJING  BEIJING  100191
+				CN
+
+44-DC-4E   (hex)		ITEL MOBILE LIMITED
+44DC4E     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+38-2A-19   (hex)		Technica Engineering GmbH
+382A19     (base 16)		Technica Engineering GmbH
+				Leopoldstraße 236
+				Munich    80807
+				DE
+
+74-D6-54   (hex)		GINT
+74D654     (base 16)		GINT
+				9F, 47, Daehak-ro, Youngtong-gu
+				Suwon-si  Gyeonggi-do  16225
+				KR
+
+B4-E8-C9   (hex)		XADA Technologies
+B4E8C9     (base 16)		XADA Technologies
+				No. 2-2, Xinyi Road Section 5, Lane 150, 1st Floor
+				Taipei City  Taipei City  110
+				TW
+
+7C-21-0E   (hex)		Cisco Systems, Inc
+7C210E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+94-2D-DC   (hex)		Samsung Electronics Co.,Ltd
+942DDC     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+54-F2-94   (hex)		Huawei Device Co., Ltd.
+54F294     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+24-5A-B5   (hex)		Samsung Electronics Co.,Ltd
+245AB5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+C0-D2-DD   (hex)		Samsung Electronics Co.,Ltd
+C0D2DD     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+AC-1E-92   (hex)		Samsung Electronics Co.,LTD
+AC1E92     (base 16)		Samsung Electronics Co.,LTD
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon    16677
+				KR
+
+00-68-EB   (hex)		HP Inc.
+0068EB     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+7C-B3-7B   (hex)		Qingdao Intelligent&Precise Electronics Co.,Ltd.
+7CB37B     (base 16)		Qingdao Intelligent&Precise Electronics Co.,Ltd.
+				No.218 Qianwangang Road
+				Qingdao  Shangdong  266510
+				CN
+
+48-4C-86   (hex)		Huawei Device Co., Ltd.
+484C86     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+88-12-3D   (hex)		Suzhou Aquila Solutions Inc.
+88123D     (base 16)		Suzhou Aquila Solutions Inc.
+				Room 201, Building 3, 18 Dongchang Road, Suzhou Industry Park, Suzhou, PRC. Zip Code: 215000
+				Suzhou    215000
+				CN
+
+48-21-0B   (hex)		PEGATRON CORPORATION
+48210B     (base 16)		PEGATRON CORPORATION
+				5F No. 76, Ligong St., Beitou District
+				Taipei City  Taiwan  112
+				TW
+
+A0-1C-8D   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+A01C8D     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+7C-31-0E   (hex)		Cisco Systems, Inc
+7C310E     (base 16)		Cisco Systems, Inc
+				80 West Tasman Dr.
+				San Jose  CA  94568
+				US
+
+F4-DE-AF   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+F4DEAF     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+60-12-3C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+60123C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-A5-E7   (hex)		Nintendo Co.,Ltd
+48A5E7     (base 16)		Nintendo Co.,Ltd
+				11-1 HOKOTATE-CHO KAMITOBA,MINAMI-KU
+				KYOTO  KYOTO  601-8501
+				JP
+
+08-2C-B6   (hex)		Apple, Inc.
+082CB6     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F8-4E-73   (hex)		Apple, Inc.
+F84E73     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+B4-26-5D   (hex)		Taicang T&W Electronics
+B4265D     (base 16)		Taicang T&W Electronics
+				89# Jiang Nan RD
+				Suzhou  Jiangsu  215412
+				CN
+
+F0-78-07   (hex)		Apple, Inc.
+F07807     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+3C-CD-36   (hex)		Apple, Inc.
+3CCD36     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-B7-09   (hex)		zte corporation
+D4B709     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+38-14-4E   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+38144E     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+AC-BD-0B   (hex)		Leimac Ltd.
+ACBD0B     (base 16)		Leimac Ltd.
+				1551, Sazukawa-chou
+				Moriyama-shi  Shiga-ken  524-0215
+				JP
+
+E0-CC-F8   (hex)		Xiaomi Communications Co Ltd
+E0CCF8     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+98-52-4A   (hex)		Technicolor CH USA Inc.
+98524A     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+38-68-A4   (hex)		Samsung Electronics Co.,LTD
+3868A4     (base 16)		Samsung Electronics Co.,LTD
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+B4-A5-AC   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+B4A5AC     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+1C-78-4E   (hex)		China Mobile Iot Limited company
+1C784E     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+84-3E-79   (hex)		Shenzhen Belon Technology CO.,LTD
+843E79     (base 16)		Shenzhen Belon Technology CO.,LTD
+				Tsinghua Information
+				Shenzhen  Guangdong  518052
+				CN
+
+B8-19-04   (hex)		Nokia Shanghai Bell Co., Ltd.
+B81904     (base 16)		Nokia Shanghai Bell Co., Ltd.
+				No.388 Ning Qiao Road,Jin Qiao Pudong Shanghai
+				Shanghai     201206
+				CN
+
+F4-A5-9D   (hex)		Huawei Device Co., Ltd.
+F4A59D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+E0-F4-42   (hex)		Huawei Device Co., Ltd.
+E0F442     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+F0-C4-2F   (hex)		Huawei Device Co., Ltd.
+F0C42F     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C0-B4-7D   (hex)		Huawei Device Co., Ltd.
+C0B47D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+44-46-87   (hex)		Realme Chongqing MobileTelecommunications Corp Ltd
+444687     (base 16)		Realme Chongqing MobileTelecommunications Corp Ltd
+				No.24 Nichang Boulevard, Huixing Block, Yubei District, Chongqing.
+				Chongqing  China  401120
+				CN
+
+E8-26-89   (hex)		Aruba, a Hewlett Packard Enterprise Company
+E82689     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+20-F3-75   (hex)		ARRIS Group, Inc.
+20F375     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+84-BB-69   (hex)		ARRIS Group, Inc.
+84BB69     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+10-5F-D4   (hex)		Tendyron Corporation
+105FD4     (base 16)		Tendyron Corporation
+				Tendyron Building,Zhongguancun NO.1 Park,Beiqing Road,Haidian District,Beijing,China
+				Beijing    100000
+				CN
+
+8C-E3-8E   (hex)		Kioxia Corporation
+8CE38E     (base 16)		Kioxia Corporation
+				1-21, Shibaura 3-chome
+				Minato-ku  Tokyo  108-0023
+				JP
+
+A0-B4-39   (hex)		Cisco Systems, Inc
+A0B439     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+A4-B4-39   (hex)		Cisco Systems, Inc
+A4B439     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+00-10-38   (hex)		Micro Research Ltd.
+001038     (base 16)		Micro Research Ltd.
+				2F Minami-Shinagawa N Bldg., 2-2-10 Minami-Shinagawa
+				Tokyo  Shinagawa-Ku  140-0004
+				JP
+
+E8-1B-4B   (hex)		amnimo Inc.
+E81B4B     (base 16)		amnimo Inc.
+				M21-4, 2-9-32 Nakacho
+				Musashino-shi  Tokyo  180-8750
+				JP
+
+CC-F4-11   (hex)		Google, Inc.
+CCF411     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+9C-2D-CF   (hex)		Shishi Tongyun Technology(Chengdu)Co.,Ltd.
+9C2DCF     (base 16)		Shishi Tongyun Technology(Chengdu)Co.,Ltd.
+				No. 1268 Middle Section of Tianfu Avenue, Chengdu High-tech Zone, China (Sichuan) Pilot Free Trade Zone
+				Chengdu  Sichuan  610017
+				CN
+
+94-24-B8   (hex)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+9424B8     (base 16)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+				Jinji West Road, Qianshan,
+				Zhuhai  Guangdong  519070
+				CN
+
+C8-03-F5   (hex)		Ruckus Wireless
+C803F5     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+00-0D-0A   (hex)		Barco Projection Systems NV
+000D0A     (base 16)		Barco Projection Systems NV
+				Beneluxpark 21
+				Kortrijk  West Flanders  8500
+				BE
+
+C4-67-D1   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C467D1     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+9C-8A-CB   (hex)		Juniper Networks
+9C8ACB     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+C8-C4-65   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+C8C465     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+1C-43-63   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C4363     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+94-29-2F   (hex)		New H3C Technologies Co., Ltd
+94292F     (base 16)		New H3C Technologies Co., Ltd
+				466 Changhe Road, Binjiang District
+				Hangzhou  Zhejiang  310052
+				CN
+
+D4-9A-A0   (hex)		VNPT TECHNOLOGY
+D49AA0     (base 16)		VNPT TECHNOLOGY
+				HoaLac Hi-Tech Park
+				HANOI  HANOI  10000
+				VN
+
+F8-0F-F9   (hex)		Google, Inc.
+F80FF9     (base 16)		Google, Inc.
+				1600 Amphitheatre Parkway
+				Mountain View  CA  94043
+				US
+
+8C-5A-C1   (hex)		Huawei Device Co., Ltd.
+8C5AC1     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A8-5A-E0   (hex)		Huawei Device Co., Ltd.
+A85AE0     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A4-B6-1E   (hex)		Huawei Device Co., Ltd.
+A4B61E     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C4-FE-5B   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+C4FE5B     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+C0-39-37   (hex)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+C03937     (base 16)		GREE ELECTRIC APPLIANCES, INC. OF ZHUHAI
+				Jinji West Road, Qianshan,
+				Zhuhai  Guangdong  519070
+				CN
+
+B4-4C-3B   (hex)		Zhejiang Dahua Technology Co., Ltd.
+B44C3B     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+40-A2-DB   (hex)		Amazon Technologies Inc.
+40A2DB     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+4C-6C-13   (hex)		IoT Company Solucoes Tecnologicas Ltda
+4C6C13     (base 16)		IoT Company Solucoes Tecnologicas Ltda
+				Rua Jordao Schiavetto, 436 - Sala 6
+				Hortolandia  Sao Paulo  13184-080
+				BR
+
+A8-85-D7   (hex)		Sangfor Technologies Inc.
+A885D7     (base 16)		Sangfor Technologies Inc.
+				block A1 ?nanshan ipark, No 1001, xueyuan road
+				Shenzhen    518100
+				CN
+
+44-4A-DB   (hex)		Apple, Inc.
+444ADB     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+84-F8-83   (hex)		Luminar Technologies
+84F883     (base 16)		Luminar Technologies
+				12601 Research Pkwy
+				Orlando  FL  32828-7335
+				US
+
+9C-A5-13   (hex)		Samsung Electronics Co.,Ltd
+9CA513     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+10-39-E9   (hex)		Juniper Networks
+1039E9     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+30-90-48   (hex)		Apple, Inc.
+309048     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+D4-1F-0C   (hex)		JAI Manufacturing
+D41F0C     (base 16)		JAI Manufacturing
+				2960-14 Uenojo Nishikata
+				Kushima  Miyazaki  888-0004
+				JP
+
+C8-FA-84   (hex)		Trusonus corp.
+C8FA84     (base 16)		Trusonus corp.
+				6F., No.42, Songjiang Rd., Zhongshan Dist
+				Taipei    10455
+				TW
+
+C4-02-E1   (hex)		Khwahish Technologies Private Limited
+C402E1     (base 16)		Khwahish Technologies Private Limited
+				Plot # 42, Thirugnana Sambandhar Street, Srinivasa Nagar, Madipakkam
+				Chennai  TamilNadu  600091
+				IN
+
+F8-5B-3B   (hex)		ASKEY COMPUTER CORP
+F85B3B     (base 16)		ASKEY COMPUTER CORP
+				10F,No.119,JIANKANG RD,ZHONGHE DIST
+				NEW TAIPEI  TAIWAN  23585
+				TW
+
+78-6D-EB   (hex)		GE Lighting
+786DEB     (base 16)		GE Lighting
+				1975 Noble Rd
+				East Cleveland  OH  44112
+				US
+
+88-E9-A4   (hex)		Hewlett Packard Enterprise
+88E9A4     (base 16)		Hewlett Packard Enterprise
+				8000 Foothills Blvd.
+				Roseville  CA  95747
+				US
+
+28-63-BD   (hex)		APTIV SERVICES US, LLC
+2863BD     (base 16)		APTIV SERVICES US, LLC
+				5725 Innovation Drive
+				Troy  MI  48098
+				US
+
+1C-72-1D   (hex)		Dell Inc.
+1C721D     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+F4-1C-95   (hex)		BEIJING YUNYI TIMES TECHNOLOGY CO,.LTD
+F41C95     (base 16)		BEIJING YUNYI TIMES TECHNOLOGY CO,.LTD
+				Room 2005, 2f, building B, No.1 Kaituo Road, Shangdi Information Industry base, Haidian District
+				BEIJING    100085
+				CN
+
+A0-68-7E   (hex)		ARRIS Group, Inc.
+A0687E     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+A8-70-5D   (hex)		ARRIS Group, Inc.
+A8705D     (base 16)		ARRIS Group, Inc.
+				6450 Sequence Drive
+				San Diego  CA  92121
+				US
+
+54-65-03   (hex)		Quectel Wireless Solutions Co., Ltd.
+546503     (base 16)		Quectel Wireless Solutions Co., Ltd.
+				7th Floor, Hongye Building, No.1801 Hongmei Road, Xuhui District
+				Shanghai    200233
+				CN
+
+9C-97-89   (hex)		1MORE
+9C9789     (base 16)		1MORE
+				TianliaoBuilding F14, New Materials Industrial Park, Xueyuan Blvd?Nanshan
+				Shenzhen  Guangdong  518055
+				CN
+
+1C-05-B7   (hex)		Chongqing Trantor Technology Co., Ltd.
+1C05B7     (base 16)		Chongqing Trantor Technology Co., Ltd.
+				No.69,Huoju Avenue,Jiulongpo District.
+				Chongqing  Chongqing  400050
+				CN
+
+00-0E-F3   (hex)		Smartlabs, Inc. 
+000EF3     (base 16)		Smartlabs, Inc. 
+				1621 Alton Parkway, Suite 100
+				Irvine  CA  92606
+				US
+
+A0-43-B0   (hex)		Hangzhou BroadLink Technology Co.,Ltd
+A043B0     (base 16)		Hangzhou BroadLink Technology Co.,Ltd
+				Room 101,1/F,Unit C,Building 1,No.57 Jiang'er Road,Changhe Street,Binjiang District,Hangzhou,Zhejiang,P.R.China
+				Hangzhou  Zhejiang  310052
+				CN
+
+74-AC-B9   (hex)		Ubiquiti Networks Inc.
+74ACB9     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+F4-92-BF   (hex)		Ubiquiti Networks Inc.
+F492BF     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+D8-C5-61   (hex)		CommFront Communications Pte Ltd
+D8C561     (base 16)		CommFront Communications Pte Ltd
+				No. 1 Yishun Industrial ST 1, #05-31 A'Posh BizHub
+				SG  SG  768160
+				SG
+
+0C-29-EF   (hex)		Dell Inc.
+0C29EF     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+60-D8-9C   (hex)		HMD Global Oy
+60D89C     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+F8-2E-8E   (hex)		Nanjing Kechen Electric Co., Ltd.
+F82E8E     (base 16)		Nanjing Kechen Electric Co., Ltd.
+				Room 202, Building 12, No. 50 Daguang road
+				Nanjing    210001
+				CN
+
+B4-C9-B9   (hex)		Sichuan AI-Link Technology Co., Ltd.
+B4C9B9     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou, Industrial Park
+				Mianyang  Sichuan  622650
+				CN
+
+F0-46-3B   (hex)		Comcast Cable Corporation
+F0463B     (base 16)		Comcast Cable Corporation
+				1800 Arch Street
+				Philadelphia  PA  19103
+				US
+
+68-D7-9A   (hex)		Ubiquiti Networks Inc.
+68D79A     (base 16)		Ubiquiti Networks Inc.
+				2580 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+1C-63-BF   (hex)		SHENZHEN BROADTEL  TELECOM CO.,LTD
+1C63BF     (base 16)		SHENZHEN BROADTEL  TELECOM CO.,LTD
+				No.14-1, Tongqing Road, Baolong street, Longgang District
+				ShenZhen  GuangDong  518116
+				CN
+
+AC-36-51   (hex)		Jiangsu Hengtong Terahertz Technology Co., Ltd.
+AC3651     (base 16)		Jiangsu Hengtong Terahertz Technology Co., Ltd.
+				Room 1312, Beiyou Technology Building, Haidian District
+				Beijing  Beijing  100876
+				CN
+
+68-4A-76   (hex)		eero inc.
+684A76     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco  CA  94107
+				US
+
+68-8F-C9   (hex)		Zhuolian (Shenzhen) Communication Co., Ltd
+688FC9     (base 16)		Zhuolian (Shenzhen) Communication Co., Ltd
+				Shengli electromechanical Co., Ltd. 201, No.19, Xixiang section, Guangshen Road, Jingbei community, Xixiang street, Bao'an District
+				Shenzhen  Shenzhen  518101
+				CN
+
+F0-81-75   (hex)		Sagemcom Broadband SAS
+F08175     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+D8-47-32   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+D84732     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+28-64-B0   (hex)		Huawei Device Co., Ltd.
+2864B0     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+04-F1-69   (hex)		Huawei Device Co., Ltd.
+04F169     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+50-21-EC   (hex)		Huawei Device Co., Ltd.
+5021EC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+8C-68-3A   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+8C683A     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+B4-6E-08   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B46E08     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-5E-0C   (hex)		HMD Global Oy
+005E0C     (base 16)		HMD Global Oy
+				Bertel Jungin aukio 9
+				Espoo    02600
+				FI
+
+B4-81-07   (hex)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+B48107     (base 16)		SHENZHEN CHUANGWEI-RGB ELECTRONICS CO.,LTD
+				Unit East Block22-24/F,Skyworth semiconductor design  Bldg., Gaoxin Ave.4.S.,Nanshan District,Shenzhen,China
+				SHENZHEN  GUANGDONG  518057
+				CN
+
+70-66-55   (hex)		AzureWave Technology Inc.
+706655     (base 16)		AzureWave Technology Inc.
+				8F., No. 94, Baozhong Rd.
+				New Taipei City  Taiwan  231
+				TW
+
+64-7C-34   (hex)		Ubee Interactive Co., Limited
+647C34     (base 16)		Ubee Interactive Co., Limited
+				Flat/RM 1202, 12/F, AT Tower 
+				North Point  Hong Kong  180
+				HK
+
+6C-38-A1   (hex)		Ubee Interactive Co., Limited
+6C38A1     (base 16)		Ubee Interactive Co., Limited
+				Flat/RM 1202, 12/F, AT Tower 
+				North Point  Hong Kong  180
+				HK
+
+78-53-0D   (hex)		Shenzhen Skyworth  Digital  Technology  CO., Ltd
+78530D     (base 16)		Shenzhen Skyworth  Digital  Technology  CO., Ltd
+				4F,Block A, Skyworth?Building,
+				Shenzhen  Guangdong  518057
+				CN
+
+0C-48-C6   (hex)		CELESTICA INC.
+0C48C6     (base 16)		CELESTICA INC.
+				1900-5140 Yonge Street PO Box 42   
+				Toronto  Ontario  M2N 6L7
+				CA
+
+A4-29-85   (hex)		Sichuan AI-Link Technology Co., Ltd.
+A42985     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou, Industrial Park
+				Mianyang  Sichuan  622650
+				CN
+
+78-AC-44   (hex)		Dell Inc.
+78AC44     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+98-C8-B8   (hex)		vivo Mobile Communication Co., Ltd.
+98C8B8     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+B8-D4-E7   (hex)		Aruba, a Hewlett Packard Enterprise Company
+B8D4E7     (base 16)		Aruba, a Hewlett Packard Enterprise Company
+				3333 Scott Blvd
+				Santa Clara  CA  95054
+				US
+
+D8-4C-90   (hex)		Apple, Inc.
+D84C90     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+24-D0-DF   (hex)		Apple, Inc.
+24D0DF     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+6C-4A-85   (hex)		Apple, Inc.
+6C4A85     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+28-F0-33   (hex)		Apple, Inc.
+28F033     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+20-9E-F7   (hex)		Extreme Networks, Inc.
+209EF7     (base 16)		Extreme Networks, Inc.
+				6480 Via Del Oro
+				San Jose  CA  95119
+				US
+
+BC-09-63   (hex)		Apple, Inc.
+BC0963     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+18-58-69   (hex)		Sailer Electronic Co., Ltd
+185869     (base 16)		Sailer Electronic Co., Ltd
+				No. 6, Sanxi Road, Ximagou Industrial Park, Jianxi District
+				Luoyang  Henan  471000
+				CN
+
+BC-2D-EF   (hex)		Realme Chongqing Mobile Telecommunications Corp.,Ltd.
+BC2DEF     (base 16)		Realme Chongqing Mobile Telecommunications Corp.,Ltd.
+				No.178 Yulong Avenue, Yufengshan, Yubei District, Chongqing.
+				Chongqing   China  401120
+				CN
+
+78-81-CE   (hex)		China Mobile Iot Limited company
+7881CE     (base 16)		China Mobile Iot Limited company
+				No. 8 Yangliu North Road, Yubei District, Chongqing, China
+				Chong Qing  Chong Qing  401120
+				CN
+
+BC-FF-21   (hex)		Smart Code(shenzhen)Technology Co.,Ltd
+BCFF21     (base 16)		Smart Code(shenzhen)Technology Co.,Ltd
+				Room 1206, Satellite Building,2002 Keyuan Road, Nanshan 
+				Shenzhen   Guangdong (Province)   518000
+				CN
+
+44-5C-E9   (hex)		Samsung Electronics Co.,Ltd
+445CE9     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+C0-16-92   (hex)		China Mobile Group Device Co.,Ltd.
+C01692     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+38-17-30   (hex)		Ulrich Lippert GmbH & Co KG
+381730     (base 16)		Ulrich Lippert GmbH & Co KG
+				Christian-Henkel-Str. 12
+				Berlin    12349
+				DE
+
+40-2E-71   (hex)		Texas Instruments
+402E71     (base 16)		Texas Instruments
+				12500 TI Blvd
+				Dallas  TX  75243
+				US
+
+70-76-DD   (hex)		OxyGuard Internation A/S
+7076DD     (base 16)		OxyGuard Internation A/S
+				Farum Gydevej 64
+				Farum    DK-3520
+				DK
+
+94-E9-EE   (hex)		Huawei Device Co., Ltd.
+94E9EE     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+28-E3-4E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+28E34E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+D4-52-EE   (hex)		BSkyB Ltd
+D452EE     (base 16)		BSkyB Ltd
+				130 Kings Road
+				Brentwood  Essex  08854
+				GB
+
+E0-23-FF   (hex)		Fortinet, Inc.
+E023FF     (base 16)		Fortinet, Inc.
+				899 Kifer Road
+				Sunnyvale    94086
+				US
+
+8C-59-DC   (hex)		ASR Microelectronics (Shanghai) Co., Ltd.
+8C59DC     (base 16)		ASR Microelectronics (Shanghai) Co., Ltd.
+				Building 2, NO.399 Keyuan Road,Pudong District
+				Shanghai  Shanghai  201210
+				CN
+
+18-82-8C   (hex)		Arcadyan Corporation
+18828C     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+9C-F0-29   (hex)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+9CF029     (base 16)		Integrated Device Technology (Malaysia) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+28-56-C1   (hex)		Harman/Becker Automotive Systems GmbH
+2856C1     (base 16)		Harman/Becker Automotive Systems GmbH
+				15th Fl, 400 Atlantic Street
+				Stamford  CT  06901
+				US
+
+78-B8-D6   (hex)		Zebra Technologies Inc.
+78B8D6     (base 16)		Zebra Technologies Inc.
+				ONE ZEBRA PLAZA
+				HOLTSVILLE  NY  11742
+				US
+
+BC-4A-56   (hex)		Cisco Systems, Inc
+BC4A56     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+6C-61-F4   (hex)		SFR
+6C61F4     (base 16)		SFR
+				12 rue jean-philippe Rameau CS 80001
+				La plaine saint denis   FRANCE  93634
+				FR
+
+F4-90-CB   (hex)		IEEE Registration Authority
+F490CB     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+00-10-7F   (hex)		CRESTRON ELECTRONICS, INC.
+00107F     (base 16)		CRESTRON ELECTRONICS, INC.
+				15 Volvo Drive
+				Rockleigh  NJ  07647
+				US
+
+00-1B-85   (hex)		MAN Energy Solutions
+001B85     (base 16)		MAN Energy Solutions
+				Teglholmsgade 41
+				Copenhagen    2450
+				DK
+
+58-49-3B   (hex)		Palo Alto Networks
+58493B     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+00-1B-17   (hex)		Palo Alto Networks
+001B17     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+58-59-C2   (hex)		Extreme Networks, Inc.
+5859C2     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+B8-2F-CB   (hex)		CMS Electracom
+B82FCB     (base 16)		CMS Electracom
+				24 Binney Road
+				Kings Park  NSW  2148
+				AU
+
+10-CE-45   (hex)		Miromico AG
+10CE45     (base 16)		Miromico AG
+				Gallusstrasse 4
+				Zurich  Zurich  CH-8006
+				CH
+
+78-7D-53   (hex)		Extreme Networks, Inc.
+787D53     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+7C-95-B1   (hex)		Extreme Networks, Inc.
+7C95B1     (base 16)		Extreme Networks, Inc.
+				1011 McCarthy Blvd
+				Milpitas  CA  95035
+				US
+
+EC-68-81   (hex)		Palo Alto Networks
+EC6881     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+78-6D-94   (hex)		Palo Alto Networks
+786D94     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+F8-AF-05   (hex)		Huawei Device Co., Ltd.
+F8AF05     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+4C-FC-AA   (hex)		Tesla,Inc.
+4CFCAA     (base 16)		Tesla,Inc.
+				3500 Deer Creek Rd.
+				PALO ALTO  CA  94304
+				US
+
+CC-AB-2C   (hex)		HUMAX Co., Ltd.
+CCAB2C     (base 16)		HUMAX Co., Ltd.
+				HUMAX Village, 216, Hwangsaeul-ro, Bu
+				Seongnam-si  Gyeonggi-do  463-875
+				KR
+
+6C-6D-09   (hex)		Kyowa Electronics Co.,Ltd.
+6C6D09     (base 16)		Kyowa Electronics Co.,Ltd.
+				4-3-31 Takatsukasa
+				Takarazuka  Hyogo  665-0051
+				JP
+
+24-E1-24   (hex)		 Xiamen Ursalink Technology Co., Ltd.
+24E124     (base 16)		 Xiamen Ursalink Technology Co., Ltd.
+				4/F, No. 63-2 Wanghai Road, 2nd Software Park
+				Xiamen  Fujian  361008
+				CN
+
+24-43-E2   (hex)		DASAN Network Solutions
+2443E2     (base 16)		DASAN Network Solutions
+				DASAN Tower 8F, 49 Daewangpangyo-ro644beon-gil Bundang-gu
+				Seongnam-si  Gyeonggi-do  13493
+				KR
+
+A8-6A-BB   (hex)		Sagemcom Broadband SAS
+A86ABB     (base 16)		Sagemcom Broadband SAS
+				250, route de l'Empereur
+				Rueil Malmaison Cedex  hauts de seine  92848
+				FR
+
+90-17-3F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+90173F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-0E-2D   (hex)		vivo Mobile Communication Co., Ltd.
+540E2D     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+70-8F-47   (hex)		vivo Mobile Communication Co., Ltd.
+708F47     (base 16)		vivo Mobile Communication Co., Ltd.
+				#283,BBK Road
+				Wusha,Chang'An  DongGuan City,Guangdong,  523860
+				CN
+
+A0-FF-70   (hex)		Technicolor CH USA Inc.
+A0FF70     (base 16)		Technicolor CH USA Inc.
+				5030 Sugarloaf Parkway Bldg 6 
+				Lawrenceville  GA  30044
+				US
+
+60-7E-CD   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+607ECD     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+54-8A-BA   (hex)		Cisco Systems, Inc
+548ABA     (base 16)		Cisco Systems, Inc
+				80 West Tasman Drive
+				San Jose  CA  94568
+				US
+
+C8-07-39   (hex)		NAKAYO Inc
+C80739     (base 16)		NAKAYO Inc
+				1-3-2, Soja-machi
+				Maebashi-shi  Gunma  371-0853
+				JP
+
+8C-7C-FF   (hex)		Brocade Communications Systems LLC
+8C7CFF     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+AC-3C-8E   (hex)		Flextronics Computing(Suzhou)Co.,Ltd.
+AC3C8E     (base 16)		Flextronics Computing(Suzhou)Co.,Ltd.
+				No.1 GuanPu Road. Guoxiang street , WuZhong District,Suzhou City, Jiangsu Province. 
+				Suzhou        215124   
+				CN
+
+40-62-34   (hex)		Telink Semiconductor (Shanghai) Co., Ltd.
+406234     (base 16)		Telink Semiconductor (Shanghai) Co., Ltd.
+				No. 1500 Zuchongzhi Rd, Building #3
+				Shanghai    201203
+				CN
+
+88-94-71   (hex)		Brocade Communications Systems LLC
+889471     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+78-A6-E1   (hex)		Brocade Communications Systems LLC
+78A6E1     (base 16)		Brocade Communications Systems LLC
+				1320 Ridder Park Dr
+				San Jose  CA  95131
+				US
+
+00-94-EC   (hex)		Huawei Device Co., Ltd.
+0094EC     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+74-45-2D   (hex)		Huawei Device Co., Ltd.
+74452D     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A4-50-06   (hex)		SHENZHEN HUACHUANG SHIDAI TECHNOLOGYCO.,LTD
+A45006     (base 16)		SHENZHEN HUACHUANG SHIDAI TECHNOLOGYCO.,LTD
+				longhua dalang huaronglu lianjiangongyeyuan 4-5
+				shenzhen  guangdong  518000
+				CN
+
+C8-71-25   (hex)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+C87125     (base 16)		Johnson Outdoors Marine Electronics d/b/a Minnkota
+				1531 E Madison Ave
+				Mankato  MN  56001
+				US
+
+68-6D-BC   (hex)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+686DBC     (base 16)		Hangzhou Hikvision Digital Technology Co.,Ltd.
+				No.555 Qianmo Road
+				Hangzhou  Zhejiang  310052
+				CN
+
+80-CF-A2   (hex)		Huawei Device Co., Ltd.
+80CFA2     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+08-03-42   (hex)		Palo Alto Networks
+080342     (base 16)		Palo Alto Networks
+				3000 Tannery Way
+				Santa Clara  CA  95054
+				US
+
+FC-3D-A5   (hex)		Arcadyan Corporation
+FC3DA5     (base 16)		Arcadyan Corporation
+				No.8, Sec.2, Guangfu Rd.
+				Hsinchu City  Hsinchu  30071
+				TW
+
+EC-4F-82   (hex)		Calix Inc.
+EC4F82     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+44-65-7F   (hex)		Calix Inc.
+44657F     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+48-77-46   (hex)		Calix Inc.
+487746     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+EC-6C-B5   (hex)		zte corporation
+EC6CB5     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+C0-B1-01   (hex)		zte corporation
+C0B101     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+14-01-52   (hex)		Samsung Electronics Co.,Ltd
+140152     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-33-AC   (hex)		Silicon Laboratories
+BC33AC     (base 16)		Silicon Laboratories
+				7000 W. William Cannon Dr.
+				Austin  TX  78735
+				US
+
+94-FB-A7   (hex)		IEEE Registration Authority
+94FBA7     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+98-8E-79   (hex)		Qudelix, Inc.
+988E79     (base 16)		Qudelix, Inc.
+				605-ho, 21, Baekbeom-ro 31-gil, Mapo-gu
+				Seoul    12110
+				KR
+
+98-F6-21   (hex)		Xiaomi Communications Co Ltd
+98F621     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+C0-3E-BA   (hex)		Dell Inc.
+C03EBA     (base 16)		Dell Inc.
+				One Dell Way
+				Round Rock  TX  78682
+				US
+
+C0-39-5A   (hex)		Zhejiang Dahua Technology Co., Ltd.
+C0395A     (base 16)		Zhejiang Dahua Technology Co., Ltd.
+				No.1199,Waterfront Road 
+				Hangzhou  Zhejiang  310053
+				CN
+
+20-64-CB   (hex)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+2064CB     (base 16)		GUANGDONG OPPO MOBILE TELECOMMUNICATIONS CORP.,LTD
+				NO.18 HAIBIN ROAD,
+				DONG GUAN  GUANG DONG  523860
+				CN
+
+F0-55-01   (hex)		Huawei Device Co., Ltd.
+F05501     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+7C-F2-DD   (hex)		Vence Corp
+7CF2DD     (base 16)		Vence Corp
+				16885 W Bernardo Dr., STE 209
+				San Diego  CA  92127
+				US
+
+D0-76-8F   (hex)		Calix Inc.
+D0768F     (base 16)		Calix Inc.
+				2777 Orchard Pkwy
+				San Jose  CA  95131
+				US
+
+1C-FF-59   (hex)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+1CFF59     (base 16)		Sichuan Tianyi Comheart Telecom Co., Ltd.
+				No.198,First Section,Snow Mountain Avenue, Jinyuan Town, Dayi County
+				Chengdu  Sichuan  611330
+				CN
+
+14-13-FB   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1413FB     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+00-E0-B7   (hex)		Cosworth Electronics Ltd
+00E0B7     (base 16)		Cosworth Electronics Ltd
+				The Octagon, St. James Mill Road
+				Northampton  Northamptonshire  NN5 5RA, GB
+				GB
+
+A4-93-40   (hex)		Beijing Supvan Information Technology Co.,Ltd.
+A49340     (base 16)		Beijing Supvan Information Technology Co.,Ltd.
+				206.2/F,Building No.1.No.1 Gaoxin Three Street. Huilongguan Town,Changping District
+				Beijing  Beijing  102206
+				CN
+
+F8-E8-77   (hex)		Harman/Becker Automotive Systems GmbH
+F8E877     (base 16)		Harman/Becker Automotive Systems GmbH
+				Becker-Göring-Straße 16
+				Karlsbad  Baden-Württemberg  76307
+				DE
+
+A0-9B-12   (hex)		China Mobile IOT Company Limited
+A09B12     (base 16)		China Mobile IOT Company Limited
+				NO.8 Yu Ma Road, NanAn Area
+				Chongqing  Chongqing  401336
+				CN
+
+94-08-53   (hex)		Liteon Technology Corporation
+940853     (base 16)		Liteon Technology Corporation
+				4F, 90, Chien 1 Road
+				New Taipei City  Taiwan  23585
+				TW
+
+B4-9E-80   (hex)		Sichuan Changhong Electric Ltd.
+B49E80     (base 16)		Sichuan Changhong Electric Ltd.
+				No.35,East MianXin Road,MianYang,Sichaun,China.
+				MianYang  SiChuan  PRC 621000
+				CN
+
+00-E2-2C   (hex)		China Mobile Group Device Co.,Ltd.
+00E22C     (base 16)		China Mobile Group Device Co.,Ltd.
+				32 Xuanwumen West Street,Xicheng District
+				Beijing    100053
+				CN
+
+78-11-00   (hex)		Quantumsolution
+781100     (base 16)		Quantumsolution
+				Rm 903, STX V-Tower, 128, Gasandigital 1-ro, Geumcheon-gu
+				Seoul    08507
+				KR
+
+E8-7F-95   (hex)		Apple, Inc.
+E87F95     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+88-C0-8B   (hex)		Apple, Inc.
+88C08B     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+74-AB-93   (hex)		Blink by Amazon 
+74AB93     (base 16)		Blink by Amazon 
+				100 Riverpark Drive
+				North Reading   MA  01864
+				US
+
+7C-A9-6B   (hex)		Syrotech Networks. Ltd.
+7CA96B     (base 16)		Syrotech Networks. Ltd.
+				UNIT NO.-5 20F, KIN WING INDUSTERIAL BUILDING,33 KIN WING STREET
+				TUEN MUN    999077
+				HK
+
+98-06-3C   (hex)		Samsung Electronics Co.,Ltd
+98063C     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+38-DE-AD   (hex)		Intel Corporate
+38DEAD     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D4-6D-6D   (hex)		Intel Corporate
+D46D6D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+B4-69-21   (hex)		Intel Corporate
+B46921     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+F8-F2-1E   (hex)		Intel Corporate
+F8F21E     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+74-A7-EA   (hex)		Amazon Technologies Inc.
+74A7EA     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+4C-7C-D9   (hex)		Apple, Inc.
+4C7CD9     (base 16)		Apple, Inc.
+				1 Infinite Loop
+				Cupertino  CA  95014
+				US
+
+F0-D7-AF   (hex)		IEEE Registration Authority
+F0D7AF     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+84-EA-ED   (hex)		Roku, Inc
+84EAED     (base 16)		Roku, Inc
+				150 Winchester Circle
+				Los Gatos  CA  95032
+				US
+
+7C-B2-7D   (hex)		Intel Corporate
+7CB27D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+04-ED-33   (hex)		Intel Corporate
+04ED33     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+5C-80-B6   (hex)		Intel Corporate
+5C80B6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+84-C5-A6   (hex)		Intel Corporate
+84C5A6     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+AC-67-5D   (hex)		Intel Corporate
+AC675D     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+F8-E4-E3   (hex)		Intel Corporate
+F8E4E3     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+D8-4F-37   (hex)		Proxis, spol. s r.o.
+D84F37     (base 16)		Proxis, spol. s r.o.
+				Slovenska 1
+				Bardejov  PSK  08501
+				SK
+
+AC-12-03   (hex)		Intel Corporate
+AC1203     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+DC-1B-A1   (hex)		Intel Corporate
+DC1BA1     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+5C-A5-BC   (hex)		eero inc.
+5CA5BC     (base 16)		eero inc.
+				660 3rd Street
+				San Francisco    94107
+				US
+
+04-33-C2   (hex)		Intel Corporate
+0433C2     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+C8-58-C0   (hex)		Intel Corporate
+C858C0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+64-BC-58   (hex)		Intel Corporate
+64BC58     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+A4-C3-F0   (hex)		Intel Corporate
+A4C3F0     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+50-76-AF   (hex)		Intel Corporate
+5076AF     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+DC-91-BF   (hex)		Amazon Technologies Inc.
+DC91BF     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+98-C9-7C   (hex)		Shenzhen iComm Semiconductor CO,LTD
+98C97C     (base 16)		Shenzhen iComm Semiconductor CO,LTD
+				Room 504A,Block B,Digital Building,Garden City,No.1079 Nanhai Road,Nanshan District,Shenzhen
+				shenzhen  Guangdong  518067
+				CN
+
+E0-92-A7   (hex)		Feitian Technologies Co., Ltd
+E092A7     (base 16)		Feitian Technologies Co., Ltd
+				Floor 17, Tower B, Huizhi Mansion, No.9 Xueqing Rd, Haidian District
+				Beijing    100085
+				CN
+
+08-B0-A7   (hex)		Truebeyond Co., Ltd
+08B0A7     (base 16)		Truebeyond Co., Ltd
+				D-906, 60, Haan-ro
+				Gwangmyeong  Gyeonggi  14322
+				KR
+
+C0-63-69   (hex)		BINXIN TECHNOLOGY(ZHEJIANG) LTD.
+C06369     (base 16)		BINXIN TECHNOLOGY(ZHEJIANG) LTD.
+				B4066 Haichuang Park,368 Liuhe Road, Binjiang District
+				Hangzhou  Zhejiang  310051
+				CN
+
+18-41-FE   (hex)		Digital 14
+1841FE     (base 16)		Digital 14
+				Elektroniikkatie 8
+				Oulu    90590
+				FI
+
+6C-CE-44   (hex)		1MORE
+6CCE44     (base 16)		1MORE
+				TianliaoBuilding F14?New Materials Industrial Park,Xueyuan Blvd,Nanshan
+				Shenzhen  Guangdong  518055
+				CN
+
+B0-76-1B   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+B0761B     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+A4-11-62   (hex)		Arlo Technology
+A41162     (base 16)		Arlo Technology
+				3030 Orchard Parkway
+				San Jose  CA  95134
+				US
+
+00-1D-05   (hex)		Cooper Lighting Solutions
+001D05     (base 16)		Cooper Lighting Solutions
+				1121 Highway 74 S
+				Peachtree City  GA  30269
+				US
+
+8C-0E-60   (hex)		Nanjing Juplink Intelligent Technologies Co., Ltd.
+8C0E60     (base 16)		Nanjing Juplink Intelligent Technologies Co., Ltd.
+				 No. 757 Dixiu Road, Binjiang Economic Development Zone, Jiangning District
+				Nanjing  Jiangsu  211100
+				CN
+
+18-AB-1D   (hex)		Samsung Electronics Co.,Ltd
+18AB1D     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+BC-E9-2F   (hex)		HP Inc.
+BCE92F     (base 16)		HP Inc.
+				10300 Energy Dr
+				Spring  TX  77389
+				US
+
+84-37-D5   (hex)		Samsung Electronics Co.,Ltd
+8437D5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-82-C5   (hex)		Samsung Electronics Co.,Ltd
+3482C5     (base 16)		Samsung Electronics Co.,Ltd
+				#94-1, Imsoo-Dong
+				Gumi  Gyeongbuk  730-350
+				KR
+
+34-0A-33   (hex)		D-Link International
+340A33     (base 16)		D-Link International
+				1 Internal Business Park, #03-12,The Synergy, Singapore
+				Singapore  Singapore  609917
+				SG
+
+84-D8-1B   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+84D81B     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+7C-2A-DB   (hex)		Xiaomi Communications Co Ltd
+7C2ADB     (base 16)		Xiaomi Communications Co Ltd
+				The Rainbow City of China Resources
+				NO.68, Qinghe Middle Street  Haidian District, Beijing  100085
+				CN
+
+E8-A2-45   (hex)		Juniper Networks
+E8A245     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+88-29-49   (hex)		Renesas Electronics (Penang) Sdn. Bhd.
+882949     (base 16)		Renesas Electronics (Penang) Sdn. Bhd.
+				Phase 3, Bayan Lepas FIZ
+				Bayan Lepas  Penang  11900
+				MY
+
+F8-64-B8   (hex)		zte corporation
+F864B8     (base 16)		zte corporation
+				12/F.,zte R&D building ,kejinan Road,Shenzhen,P.R.China
+				shenzhen  guangdong  518057
+				CN
+
+14-51-20   (hex)		Huawei Device Co., Ltd.
+145120     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+C0-D1-93   (hex)		Huawei Device Co., Ltd.
+C0D193     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+3C-84-6A   (hex)		TP-LINK TECHNOLOGIES CO.,LTD.
+3C846A     (base 16)		TP-LINK TECHNOLOGIES CO.,LTD.
+				Building 24(floors 1,3,4,5)and 28(floors 1-4)Central Science and Technology Park,Shennan Road,Nanshan
+				Shenzhen  Guangdong  518057
+				CN
+
+78-04-E3   (hex)		Huawei Device Co., Ltd.
+7804E3     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+A4-3B-0E   (hex)		Huawei Device Co., Ltd.
+A43B0E     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+24-A1-60   (hex)		Espressif Inc.
+24A160     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+DC-AE-EB   (hex)		Ruckus Wireless
+DCAEEB     (base 16)		Ruckus Wireless
+				350 West Java Drive
+				Sunnyvale  CA  94089
+				US
+
+24-81-C7   (hex)		Huawei Device Co., Ltd.
+2481C7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+FC-86-2A   (hex)		Huawei Device Co., Ltd.
+FC862A     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+1C-3D-2F   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+1C3D2F     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+EC-75-3E   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+EC753E     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+90-91-64   (hex)		ChongQing Lavid Technology Co., Ltd.
+909164     (base 16)		ChongQing Lavid Technology Co., Ltd.
+				Plant No. 3, Block M2, Photoelectric Park, Wuqiao Lianhe Economic Development Zone, Wanzhou District
+				Chongqing    404100
+				CN
+
+EC-DB-86   (hex)		API-K
+ECDB86     (base 16)		API-K
+				ZA Tire Poix
+				Saint Vincent de Mercuze  Isère  38660
+				FR
+
+48-43-DD   (hex)		Amazon Technologies Inc.
+4843DD     (base 16)		Amazon Technologies Inc.
+				P.O Box 8102
+				Reno  NV  89507
+				US
+
+08-38-69   (hex)		Hong Kong AMobile Intelligent Corp. Limited Taiwan Branch
+083869     (base 16)		Hong Kong AMobile Intelligent Corp. Limited Taiwan Branch
+				8F.-1, No.700, Zhongzheng Rd., Zhonghe Dist.
+				New Taipei City 235    23552
+				TW
+
+D8-9E-D4   (hex)		Fiberhome Telecommunication Technologies Co.,LTD
+D89ED4     (base 16)		Fiberhome Telecommunication Technologies Co.,LTD
+				No.5 DongXin Road
+				Wuhan  Hubei  430074
+				CN
+
+84-03-28   (hex)		Juniper Networks
+840328     (base 16)		Juniper Networks
+				1133 Innovation Way
+				Sunnyvale  CA  94089
+				US
+
+08-9B-B9   (hex)		Nokia
+089BB9     (base 16)		Nokia
+				Karaportti 3
+				Espoo  Finland  02610
+				FI
+
+00-1C-FC   (hex)		Sumitomo Electric Industries, Ltd
+001CFC     (base 16)		Sumitomo Electric Industries, Ltd
+				1-1-3, Shimaya, Konohana-ku
+				Osaka    554-0024
+				JP
+
+00-16-36   (hex)		Quanta Computer Inc.
+001636     (base 16)		Quanta Computer Inc.
+				No. 211, Wen Hwa 2Rd., Kuei Shan Hsiang
+				Tao Yuan Shien    0000
+				TW
+
+54-F1-5F   (hex)		Sichuan AI-Link Technology Co., Ltd.
+54F15F     (base 16)		Sichuan AI-Link Technology Co., Ltd.
+				Anzhou, Industrial Park
+				Mianyang  Sichuan  622650
+				CN
+
+E0-79-C4   (hex)		iRay Technology Company Limited
+E079C4     (base 16)		iRay Technology Company Limited
+				Building 45, No. 1000, Jinhai RD., Pudong New Area
+				Shanghai    201206
+				CN
+
+88-40-67   (hex)		infomark
+884067     (base 16)		infomark
+				3F. Humaxvillage, 216 Hwangsaeul-ro
+				Seongnam-si    13595
+				KR
+
+AC-95-72   (hex)		Jovision Technology Co., Ltd.
+AC9572     (base 16)		Jovision Technology Co., Ltd.
+				Floor 12, Building 3, Aosheng Square, No.1166 Xinluo Street
+				Jinan  Shandong  250101
+				CN
+
+40-D2-5F   (hex)		ITEL MOBILE LIMITED
+40D25F     (base 16)		ITEL MOBILE LIMITED
+				RM B3 & B4 BLOCK B, KO FAI INDUSTRIAL BUILDING  NO.7 KO FAI ROAD, YAU TONG, KLN, H.K
+				Hong Kong  KOWLOON  999077
+				HK
+
+A8-03-2A   (hex)		Espressif Inc.
+A8032A     (base 16)		Espressif Inc.
+				Room 204, Building 2, 690 Bibo Rd, Pudong New Area
+				Shanghai  Shanghai  201203
+				CN
+
+00-19-F5   (hex)		Imagination Technologies Ltd
+0019F5     (base 16)		Imagination Technologies Ltd
+				Home Park Estate
+				Kings Langley  Hertfordshire  WD4 8LZ
+				GB
+
+00-CB-BD   (hex)		Cambridge Broadband Networks Group
+00CBBD     (base 16)		Cambridge Broadband Networks Group
+				1 Hammersmith Broadway
+				London    W6 9DL
+				GB
+
+58-94-A2   (hex)		KETEK GmbH
+5894A2     (base 16)		KETEK GmbH
+				Hofer Str. 3
+				München    81737
+				DE
+
+4C-22-19   (hex)		YUANFUDAO HK LIMTED
+4C2219     (base 16)		YUANFUDAO HK LIMTED
+				Building C, global creative center, No. 10, Furong street
+				Beijing    100102
+				CN
+
+54-D9-C6   (hex)		Huawei Device Co., Ltd.
+54D9C6     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+30-8A-F7   (hex)		Huawei Device Co., Ltd.
+308AF7     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+64-E7-D8   (hex)		Samsung Electronics Co.,Ltd
+64E7D8     (base 16)		Samsung Electronics Co.,Ltd
+				129, Samsung-ro, Youngtongl-Gu
+				Suwon  Gyeonggi-Do  16677
+				KR
+
+D8-EF-42   (hex)		Huawei Device Co., Ltd.
+D8EF42     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+80-CC-12   (hex)		Huawei Device Co., Ltd.
+80CC12     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+18-AA-0F   (hex)		Huawei Device Co., Ltd.
+18AA0F     (base 16)		Huawei Device Co., Ltd.
+				No.2 of Xincheng Road, Songshan Lake Zone
+				Dongguan  Guangdong  523808
+				CN
+
+B0-A4-60   (hex)		Intel Corporate
+B0A460     (base 16)		Intel Corporate
+				Lot 8, Jalan Hi-Tech 2/3 
+				Kulim  Kedah  09000
+				MY
+
+AC-9A-96   (hex)		Maxlinear, Inc
+AC9A96     (base 16)		Maxlinear, Inc
+				Am Campeon 3
+				Neubiberg  Bavaria  85579
+				DE
+
+00-E4-06   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+00E406     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+44-22-7C   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+44227C     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+CC-B1-82   (hex)		HUAWEI TECHNOLOGIES CO.,LTD
+CCB182     (base 16)		HUAWEI TECHNOLOGIES CO.,LTD
+				No.2 Xin Cheng Road, Room R6,Songshan Lake Technology Park
+				Dongguan    523808
+				CN
+
+48-90-2F   (hex)		LG Electronics (Mobile Communications)
+48902F     (base 16)		LG Electronics (Mobile Communications)
+				60-39, Gasan-dong, Geumcheon-gu
+				Seoul    153-801
+				KR
+
+28-B7-7C   (hex)		IEEE Registration Authority
+28B77C     (base 16)		IEEE Registration Authority
+				445 Hoes Lane
+				Piscataway  NJ  08554
+				US
+
+68-D6-ED   (hex)		GooWi Wireless Technology Co., Limited
+68D6ED     (base 16)		GooWi Wireless Technology Co., Limited
+				RM402 Building212, Tairan Technology Park, Futian District
+				Shenzhen  Guangdong  518000
+				CN
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/fbsocket.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/fbsocket.py
new file mode 100644
index 0000000000000000000000000000000000000000..0e376b3f19fd8500eafaf34a03d4714dacdc680f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/fbsocket.py
@@ -0,0 +1,246 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""Fallback routines for Python's standard library socket module"""
+
+from struct import unpack as _unpack, pack as _pack
+
+from netaddr.compat import _bytes_join, _is_str
+
+AF_INET = 2
+AF_INET6 = 10
+
+
+def inet_ntoa(packed_ip):
+    """
+    Convert an IP address from 32-bit packed binary format to string format.
+    """
+    if not _is_str(packed_ip):
+        raise TypeError('string type expected, not %s' % type(packed_ip))
+
+    if len(packed_ip) != 4:
+        raise ValueError('invalid length of packed IP address string')
+
+    return '%d.%d.%d.%d' % _unpack('4B', packed_ip)
+
+
+def _compact_ipv6_tokens(tokens):
+    new_tokens = []
+
+    positions = []
+    start_index = None
+    num_tokens = 0
+
+    #   Discover all runs of zeros.
+    for idx, token in enumerate(tokens):
+        if token == '0':
+            if start_index is None:
+                start_index = idx
+            num_tokens += 1
+        else:
+            if num_tokens > 1:
+                positions.append((num_tokens, start_index))
+            start_index = None
+            num_tokens = 0
+
+        new_tokens.append(token)
+
+    #   Store any position not saved before loop exit.
+    if num_tokens > 1:
+        positions.append((num_tokens, start_index))
+
+    #   Replace first longest run with an empty string.
+    if len(positions) != 0:
+        #   Locate longest, left-most run of zeros.
+        positions.sort(key=lambda x: x[1])
+        best_position = positions[0]
+        for position in positions:
+            if position[0] > best_position[0]:
+                best_position = position
+        #   Replace chosen zero run.
+        (length, start_idx) = best_position
+        new_tokens = new_tokens[0:start_idx] + [''] + new_tokens[start_idx + length:]
+
+        #   Add start and end blanks so join creates '::'.
+        if new_tokens[0] == '':
+            new_tokens.insert(0, '')
+
+        if new_tokens[-1] == '':
+            new_tokens.append('')
+
+    return new_tokens
+
+
+def inet_ntop(af, packed_ip):
+    """Convert an packed IP address of the given family to string format."""
+    if af == AF_INET:
+        #   IPv4.
+        return inet_ntoa(packed_ip)
+    elif af == AF_INET6:
+        #   IPv6.
+        if len(packed_ip) != 16 or not _is_str(packed_ip):
+            raise ValueError('invalid length of packed IP address string')
+
+        tokens = ['%x' % i for i in _unpack('>8H', packed_ip)]
+
+        #   Convert packed address to an integer value.
+        words = list(_unpack('>8H', packed_ip))
+        int_val = 0
+        for i, num in enumerate(reversed(words)):
+            word = num
+            word = word << 16 * i
+            int_val = int_val | word
+
+        if 0xffff < int_val <= 0xffffffff or int_val >> 32 == 0xffff:
+            #   IPv4 compatible / mapped IPv6.
+            packed_ipv4 = _pack('>2H', *[int(i, 16) for i in tokens[-2:]])
+            ipv4_str = inet_ntoa(packed_ipv4)
+            tokens = tokens[0:-2] + [ipv4_str]
+
+        return ':'.join(_compact_ipv6_tokens(tokens))
+    else:
+        raise ValueError('unknown address family %d' % af)
+
+
+def _inet_pton_af_inet(ip_string):
+    """
+    Convert an IP address in string format (123.45.67.89) to the 32-bit packed
+    binary format used in low-level network functions. Differs from inet_aton
+    by only support decimal octets. Using octal or hexadecimal values will
+    raise a ValueError exception.
+    """
+    #TODO: optimise this ... use inet_aton with mods if available ...
+    if _is_str(ip_string):
+        invalid_addr = ValueError('illegal IP address string %r' % ip_string)
+        #   Support for hexadecimal and octal octets.
+        tokens = ip_string.split('.')
+
+        #   Pack octets.
+        if len(tokens) == 4:
+            words = []
+            for token in tokens:
+                if token.startswith('0x') or (token.startswith('0') and len(token) > 1):
+                    raise invalid_addr
+                try:
+                    octet = int(token)
+                except ValueError:
+                    raise invalid_addr
+
+                if (octet >> 8) != 0:
+                    raise invalid_addr
+                words.append(_pack('B', octet))
+            return _bytes_join(words)
+        else:
+            raise invalid_addr
+
+    raise ValueError('argument should be a string, not %s' % type(ip_string))
+
+
+def inet_pton(af, ip_string):
+    """
+    Convert an IP address from string format to a packed string suitable for
+    use with low-level network functions.
+    """
+    if af == AF_INET:
+        #   IPv4.
+        return _inet_pton_af_inet(ip_string)
+    elif af == AF_INET6:
+        invalid_addr = ValueError('illegal IP address string %r' % ip_string)
+        #   IPv6.
+        values = []
+
+        if not _is_str(ip_string):
+            raise invalid_addr
+
+        if 'x' in ip_string:
+            #   Don't accept hextets with the 0x prefix.
+            raise invalid_addr
+
+        if '::' in ip_string:
+            if ip_string == '::':
+                #   Unspecified address.
+                return '\x00'.encode() * 16
+            #   IPv6 compact mode.
+            try:
+                prefix, suffix = ip_string.split('::')
+            except ValueError:
+                raise invalid_addr
+
+            l_prefix = []
+            l_suffix = []
+
+            if prefix != '':
+                l_prefix = prefix.split(':')
+
+            if suffix != '':
+                l_suffix = suffix.split(':')
+
+            #   IPv6 compact IPv4 compatibility mode.
+            if len(l_suffix) and '.' in l_suffix[-1]:
+                ipv4_str = _inet_pton_af_inet(l_suffix.pop())
+                l_suffix.append('%x' % _unpack('>H', ipv4_str[0:2])[0])
+                l_suffix.append('%x' % _unpack('>H', ipv4_str[2:4])[0])
+
+            token_count = len(l_prefix) + len(l_suffix)
+
+            if not 0 <= token_count <= 8 - 1:
+                raise invalid_addr
+
+            gap_size = 8 - ( len(l_prefix) + len(l_suffix) )
+
+            values = (
+                [_pack('>H', int(i, 16)) for i in l_prefix] +
+                ['\x00\x00'.encode() for i in range(gap_size)] +
+                [_pack('>H', int(i, 16)) for i in l_suffix]
+            )
+            try:
+                for token in l_prefix + l_suffix:
+                    word = int(token, 16)
+                    if not 0 <= word <= 0xffff:
+                        raise invalid_addr
+            except ValueError:
+                raise invalid_addr
+        else:
+            #   IPv6 verbose mode.
+            if ':' in ip_string:
+                tokens = ip_string.split(':')
+
+                if '.' in ip_string:
+                    ipv6_prefix = tokens[:-1]
+                    if ipv6_prefix[:-1] != ['0', '0', '0', '0', '0']:
+                        raise invalid_addr
+
+                    if ipv6_prefix[-1].lower() not in ('0', 'ffff'):
+                        raise invalid_addr
+
+                    #   IPv6 verbose IPv4 compatibility mode.
+                    if len(tokens) != 7:
+                        raise invalid_addr
+
+                    ipv4_str = _inet_pton_af_inet(tokens.pop())
+                    tokens.append('%x' % _unpack('>H', ipv4_str[0:2])[0])
+                    tokens.append('%x' % _unpack('>H', ipv4_str[2:4])[0])
+
+                    values = [_pack('>H', int(i, 16)) for i in tokens]
+                else:
+                    #   IPv6 verbose mode.
+                    if len(tokens) != 8:
+                        raise invalid_addr
+                try:
+                    tokens = [int(token, 16) for token in tokens]
+                    for token in tokens:
+                        if not 0 <= token <= 0xffff:
+                            raise invalid_addr
+
+                except ValueError:
+                    raise invalid_addr
+
+                values = [_pack('>H', i) for i in tokens]
+            else:
+                raise invalid_addr
+
+        return _bytes_join(values)
+    else:
+        raise ValueError('Unknown address family %d' % af)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1232eb8bd33367a9049c80cd60e62322ea658ea
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/__init__.py
@@ -0,0 +1,1972 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""Routines for IPv4 and IPv6 addresses, subnets and ranges."""
+
+import sys as _sys
+
+from netaddr.core import AddrFormatError, AddrConversionError, num_bits, \
+    DictDotLookup, NOHOST, N, INET_PTON, P, ZEROFILL, Z
+
+from netaddr.strategy import ipv4 as _ipv4, ipv6 as _ipv6
+
+from netaddr.compat import _sys_maxint, _iter_next, _iter_range, _is_str, _int_type, \
+    _str_type
+
+
+class BaseIP(object):
+    """
+    An abstract base class for common operations shared between various IP
+    related subclasses.
+
+    """
+    __slots__ = ('_value', '_module', '__weakref__')
+
+    def __init__(self):
+        """Constructor."""
+        self._value = None
+        self._module = None
+
+    def _set_value(self, value):
+        if not isinstance(value, _int_type):
+            raise TypeError('int argument expected, not %s' % type(value))
+        if not 0 <= value <= self._module.max_int:
+            raise AddrFormatError('value out of bounds for an %s address!' \
+                % self._module.family_name)
+        self._value = value
+
+    value = property(lambda self: self._value, _set_value,
+        doc='a positive integer representing the value of IP address/subnet.')
+
+    def key(self):
+        """
+        :return: a key tuple that uniquely identifies this IP address.
+        """
+        return NotImplemented
+
+    def sort_key(self):
+        """
+        :return: A key tuple used to compare and sort this `IPAddress`
+            correctly.
+        """
+        return NotImplemented
+
+    def __hash__(self):
+        """
+        :return: A hash value uniquely indentifying this IP object.
+        """
+        return hash(self.key())
+
+    def __eq__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            equivalent to ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.key() == other.key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def __ne__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            not equivalent to ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.key() != other.key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def __lt__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            less than ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.sort_key() < other.sort_key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def __le__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            less than or equal to ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.sort_key() <= other.sort_key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def __gt__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            greater than ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.sort_key() > other.sort_key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def __ge__(self, other):
+        """
+        :param other: an `IPAddress` or `IPNetwork` object.
+
+        :return: ``True`` if this `IPAddress` or `IPNetwork` object is
+            greater than or equal to ``other``, ``False`` otherwise.
+        """
+        try:
+            return self.sort_key() >= other.sort_key()
+        except (AttributeError, TypeError):
+            return NotImplemented
+
+    def is_unicast(self):
+        """:return: ``True`` if this IP is unicast, ``False`` otherwise"""
+        return not self.is_multicast()
+
+    def is_multicast(self):
+        """:return: ``True`` if this IP is multicast, ``False`` otherwise"""
+        if self._module == _ipv4:
+            return self in IPV4_MULTICAST
+        elif self._module == _ipv6:
+            return self in IPV6_MULTICAST
+
+    def is_loopback(self):
+        """
+        :return: ``True`` if this IP is loopback address (not for network
+            transmission), ``False`` otherwise.
+            References: RFC 3330 and 4291.
+        """
+        if self._module.version == 4:
+            return self in IPV4_LOOPBACK
+        elif self._module.version == 6:
+            return self == IPV6_LOOPBACK
+
+    def is_private(self):
+        """
+        :return: ``True`` if this IP is for internal/private use only
+            (i.e. non-public), ``False`` otherwise. Reference: RFCs 1918,
+            3330, 4193, 3879 and 2365.
+        """
+        if self._module.version == 4:
+            for cidr in IPV4_PRIVATE:
+                if self in cidr:
+                    return True
+        elif self._module.version == 6:
+            for cidr in IPV6_PRIVATE:
+                if self in cidr:
+                    return True
+
+        if self.is_link_local():
+            return True
+
+        return False
+
+    def is_link_local(self):
+        """
+        :return: ``True`` if this IP is link-local address ``False`` otherwise.
+            Reference: RFCs 3927 and 4291.
+        """
+        if self._module.version == 4:
+            return self in IPV4_LINK_LOCAL
+        elif self._module.version == 6:
+            return self in IPV6_LINK_LOCAL
+
+    def is_reserved(self):
+        """
+        :return: ``True`` if this IP is in IANA reserved range, ``False``
+            otherwise. Reference: RFCs 3330 and 3171.
+        """
+        if self._module.version == 4:
+            for cidr in IPV4_RESERVED:
+                if self in cidr:
+                    return True
+        elif self._module.version == 6:
+            for cidr in IPV6_RESERVED:
+                if self in cidr:
+                    return True
+        return False
+
+    def is_ipv4_mapped(self):
+        """
+        :return: ``True`` if this IP is IPv4-compatible IPv6 address, ``False``
+            otherwise.
+        """
+        return self._module.version == 6 and (self._value >> 32) == 0xffff
+
+    def is_ipv4_compat(self):
+        """
+        :return: ``True`` if this IP is IPv4-mapped IPv6 address, ``False``
+            otherwise.
+        """
+        return self._module.version == 6 and (self._value >> 32) == 0
+
+    @property
+    def info(self):
+        """
+        A record dict containing IANA registration details for this IP address
+        if available, None otherwise.
+        """
+        #   Lazy loading of IANA data structures.
+        from netaddr.ip.iana import query
+        return DictDotLookup(query(self))
+
+    @property
+    def version(self):
+        """the IP protocol version represented by this IP object."""
+        return self._module.version
+
+
+class IPAddress(BaseIP):
+    """
+    An individual IPv4 or IPv6 address without a net mask or subnet prefix.
+
+    To support these and other network based operations, see `IPNetwork`.
+
+    """
+    __slots__ = ()
+
+    def __init__(self, addr, version=None, flags=0):
+        """
+        Constructor.
+
+        :param addr: an IPv4 or IPv6 address which may be represented in an
+            accepted string format, as an unsigned integer or as another
+            IPAddress object (copy construction).
+
+        :param version: (optional) optimizes version detection if specified
+            and distinguishes between IPv4 and IPv6 for addresses with an
+            equivalent integer value.
+
+        :param flags: (optional) decides which rules are applied to the
+            interpretation of the addr value. Supported constants are
+            INET_PTON and ZEROFILL. See the netaddr.core docs for further
+            details.
+
+        """
+        super(IPAddress, self).__init__()
+
+        if isinstance(addr, BaseIP):
+            #   Copy constructor.
+            if version is not None and version != addr._module.version:
+                raise ValueError('cannot switch IP versions using '
+                    'copy constructor!')
+            self._value = addr._value
+            self._module = addr._module
+        else:
+            #   Explicit IP address version.
+            if version is not None:
+                if version == 4:
+                    self._module = _ipv4
+                elif version == 6:
+                    self._module = _ipv6
+                else:
+                    raise ValueError('%r is an invalid IP version!' % version)
+
+            if _is_str(addr) and '/' in addr:
+                raise ValueError('%s() does not support netmasks or subnet' \
+                    ' prefixes! See documentation for details.'
+                    % self.__class__.__name__)
+
+            if self._module is None:
+                #   IP version is implicit, detect it from addr.
+                if isinstance(addr, _int_type):
+                    try:
+                        if 0 <= int(addr) <= _ipv4.max_int:
+                            self._value = int(addr)
+                            self._module = _ipv4
+                        elif _ipv4.max_int < int(addr) <= _ipv6.max_int:
+                            self._value = int(addr)
+                            self._module = _ipv6
+                    except ValueError:
+                        pass
+                else:
+                    for module in _ipv4, _ipv6:
+                        try:
+                            self._value = module.str_to_int(addr, flags)
+                        except:
+                            continue
+                        else:
+                            self._module = module
+                            break
+
+                if self._module is None:
+                    raise AddrFormatError('failed to detect a valid IP ' \
+                        'address from %r' % addr)
+            else:
+                #   IP version is explicit.
+                if _is_str(addr):
+                    try:
+                        self._value = self._module.str_to_int(addr, flags)
+                    except AddrFormatError:
+                        raise AddrFormatError('base address %r is not IPv%d'
+                            % (addr, self._module.version))
+                else:
+                    if 0 <= int(addr) <= self._module.max_int:
+                        self._value = int(addr)
+                    else:
+                        raise AddrFormatError('bad address format: %r' % (addr,))
+
+    def __getstate__(self):
+        """:returns: Pickled state of an `IPAddress` object."""
+        return self._value, self._module.version
+
+    def __setstate__(self, state):
+        """
+        :param state: data used to unpickle a pickled `IPAddress` object.
+
+        """
+        value, version = state
+
+        self._value = value
+
+        if version == 4:
+            self._module = _ipv4
+        elif version == 6:
+            self._module = _ipv6
+        else:
+            raise ValueError('unpickling failed for object state: %s' \
+                % str(state))
+
+    def netmask_bits(self):
+        """
+        @return: If this IP is a valid netmask, the number of non-zero
+            bits are returned, otherwise it returns the width in bits for
+            the IP address version.
+        """
+        if not self.is_netmask():
+            return self._module.width
+
+        # the '0' address (e.g. 0.0.0.0 or 0000::) is a valid netmask with
+        # no bits set.
+        if self._value == 0:
+            return 0
+
+        i_val = self._value
+        numbits = 0
+
+        while i_val > 0:
+            if i_val & 1 == 1:
+                break
+            numbits += 1
+            i_val >>= 1
+
+        mask_length = self._module.width - numbits
+
+        if not 0 <= mask_length <= self._module.width:
+            raise ValueError('Unexpected mask length %d for address type!' \
+                % mask_length)
+
+        return mask_length
+
+    def is_hostmask(self):
+        """
+        :return: ``True`` if this IP address host mask, ``False`` otherwise.
+        """
+        int_val = self._value + 1
+        return (int_val & (int_val - 1) == 0)
+
+    def is_netmask(self):
+        """
+        :return: ``True`` if this IP address network mask, ``False`` otherwise.
+        """
+        int_val = (self._value ^ self._module.max_int) + 1
+        return (int_val & (int_val - 1) == 0)
+
+    def __iadd__(self, num):
+        """
+        Increases the numerical value of this IPAddress by num.
+
+        An IndexError is raised if result exceeds maximum IP address value or
+        is less than zero.
+
+        :param num: size of IP address increment.
+        """
+        new_value = int(self._value + num)
+        if 0 <= new_value <= self._module.max_int:
+            self._value = new_value
+            return self
+        raise IndexError('result outside valid IP address boundary!')
+
+    def __isub__(self, num):
+        """
+        Decreases the numerical value of this IPAddress by num.
+
+        An IndexError is raised if result is less than zero or exceeds maximum
+        IP address value.
+
+        :param num: size of IP address decrement.
+        """
+        new_value = int(self._value - num)
+        if 0 <= new_value <= self._module.max_int:
+            self._value = new_value
+            return self
+        raise IndexError('result outside valid IP address boundary!')
+
+    def __add__(self, num):
+        """
+        Add the numerical value of this IP address to num and provide the
+        result as a new IPAddress object.
+
+        :param num: size of IP address increase.
+
+        :return: a new IPAddress object with its numerical value increased by num.
+        """
+        new_value = int(self._value + num)
+        if 0 <= new_value <= self._module.max_int:
+            return self.__class__(new_value, self._module.version)
+        raise IndexError('result outside valid IP address boundary!')
+
+    __radd__ = __add__
+
+    def __sub__(self, num):
+        """
+        Subtract the numerical value of this IP address from num providing
+        the result as a new IPAddress object.
+
+        :param num: size of IP address decrease.
+
+        :return: a new IPAddress object with its numerical value decreased by num.
+        """
+        new_value = int(self._value - num)
+        if 0 <= new_value <= self._module.max_int:
+            return self.__class__(new_value, self._module.version)
+        raise IndexError('result outside valid IP address boundary!')
+
+    def __rsub__(self, num):
+        """
+        Subtract num (lvalue) from the numerical value of this IP address
+        (rvalue) providing the result as a new IPAddress object.
+
+        :param num: size of IP address decrease.
+
+        :return: a new IPAddress object with its numerical value decreased by num.
+        """
+        new_value = int(num - self._value)
+        if 0 <= new_value <= self._module.max_int:
+            return self.__class__(new_value, self._module.version)
+        raise IndexError('result outside valid IP address boundary!')
+
+    def key(self):
+        """
+        :return: a key tuple that uniquely identifies this IP address.
+        """
+        #   NB - we return the value here twice because this IP Address may
+        #   be sorted with a list of networks and it should still end up
+        #   in the expected order.
+        return self._module.version, self._value
+
+    def sort_key(self):
+        """:return: A key tuple used to compare and sort this `IPAddress` correctly."""
+        return self._module.version, self._value, self._module.width
+
+    def __int__(self):
+        """:return: the value of this IP address as an unsigned integer"""
+        return self._value
+
+    def __long__(self):
+        """:return: the value of this IP address as an unsigned integer"""
+        return self._value
+
+    def __oct__(self):
+        """:return: an octal string representation of this IP address."""
+        #   Python 2.x
+        if self._value == 0:
+            return '0'
+        return '0%o' % self._value
+
+    def __hex__(self):
+        """:return: a hexadecimal string representation of this IP address."""
+        #   Python 2.x
+        return '0x%x' % self._value
+
+    def __index__(self):
+        """
+        :return: return the integer value of this IP address when called by \
+            hex(), oct() or bin().
+        """
+        #   Python 3.x
+        return self._value
+
+    def __bytes__(self):
+        """ 
+        :return: a bytes object equivalent to this IP address. In network
+        byte order, big-endian.
+        """
+        #   Python 3.x
+        return self._value.to_bytes(self._module.width//8, 'big')
+
+    def bits(self, word_sep=None):
+        """
+        :param word_sep: (optional) the separator to insert between words.
+            Default: None - use default separator for address type.
+
+        :return: the value of this IP address as a binary digit string."""
+        return self._module.int_to_bits(self._value, word_sep)
+
+    @property
+    def packed(self):
+        """The value of this IP address as a packed binary string."""
+        return self._module.int_to_packed(self._value)
+
+    @property
+    def words(self):
+        """
+        A list of unsigned integer words (octets for IPv4, hextets for IPv6)
+        found in this IP address.
+        """
+        return self._module.int_to_words(self._value)
+
+    @property
+    def bin(self):
+        """
+        The value of this IP adddress in standard Python binary
+        representational form (0bxxx). A back port of the format provided by
+        the builtin bin() function found in Python 2.6.x and higher.
+        """
+        return self._module.int_to_bin(self._value)
+
+    @property
+    def reverse_dns(self):
+        """The reverse DNS lookup record for this IP address"""
+        return self._module.int_to_arpa(self._value)
+
+    def ipv4(self):
+        """
+        Raises an `AddrConversionError` if IPv6 address cannot be converted
+        to IPv4.
+
+        :return: A numerically equivalent version 4 `IPAddress` object.
+        """
+        ip = None
+        klass = self.__class__
+
+        if self._module.version == 4:
+            ip = klass(self._value, 4)
+        elif self._module.version == 6:
+            if 0 <= self._value <= _ipv4.max_int:
+                ip = klass(self._value, 4)
+            elif _ipv4.max_int <= self._value <= 0xffffffffffff:
+                ip = klass(self._value - 0xffff00000000, 4)
+            else:
+                raise AddrConversionError('IPv6 address %s unsuitable for ' \
+                    'conversion to IPv4!' % self)
+        return ip
+
+    def ipv6(self, ipv4_compatible=False):
+        """
+        .. note:: The IPv4-mapped IPv6 address format is now considered \
+            deprecated. See RFC 4291 or later for details.
+
+        :param ipv4_compatible: If ``True`` returns an IPv4-mapped address
+            (::ffff:x.x.x.x), an IPv4-compatible (::x.x.x.x) address
+            otherwise. Default: False (IPv4-mapped).
+
+        :return: A numerically equivalent version 6 `IPAddress` object.
+        """
+        ip = None
+        klass = self.__class__
+
+        if self._module.version == 6:
+            if ipv4_compatible and \
+                (0xffff00000000 <= self._value <= 0xffffffffffff):
+                ip = klass(self._value - 0xffff00000000, 6)
+            else:
+                ip = klass(self._value, 6)
+        elif self._module.version == 4:
+            #   IPv4-Compatible IPv6 address
+            ip = klass(self._value, 6)
+            if not ipv4_compatible:
+                #   IPv4-Mapped IPv6 address
+                ip = klass(0xffff00000000 + self._value, 6)
+
+        return ip
+
+    def format(self, dialect=None):
+        """
+        Only relevant for IPv6 addresses. Has no effect for IPv4.
+
+        :param dialect: An ipv6_* dialect class.
+
+        :return: an alternate string representation for this IP address.
+        """
+        if dialect is not None:
+            if not hasattr(dialect, 'word_fmt'):
+                raise TypeError(
+                    'custom dialects should subclass ipv6_verbose!')
+        return self._module.int_to_str(self._value, dialect=dialect)
+
+    def __or__(self, other):
+        """
+        :param other: An `IPAddress` object (or other int-like object).
+
+        :return: bitwise OR (x | y) between the integer value of this IP
+            address and ``other``.
+        """
+        return self.__class__(self._value | int(other), self._module.version)
+
+    def __and__(self, other):
+        """
+        :param other: An `IPAddress` object (or other int-like object).
+
+        :return: bitwise AND (x & y) between the integer value of this IP
+            address and ``other``.
+        """
+        return self.__class__(self._value & int(other), self._module.version)
+
+    def __xor__(self, other):
+        """
+        :param other: An `IPAddress` object (or other int-like object).
+
+        :return: bitwise exclusive OR (x ^ y) between the integer value of
+            this IP address and ``other``.
+        """
+        return self.__class__(self._value ^ int(other), self._module.version)
+
+    def __lshift__(self, numbits):
+        """
+        :param numbits: size of bitwise shift.
+
+        :return: an `IPAddress` object based on this one with its integer
+            value left shifted by ``numbits``.
+        """
+        return self.__class__(self._value << numbits, self._module.version)
+
+    def __rshift__(self, numbits):
+        """
+        :param numbits: size of bitwise shift.
+
+        :return: an `IPAddress` object based on this one with its integer
+            value right shifted by ``numbits``.
+        """
+        return self.__class__(self._value >> numbits, self._module.version)
+
+    def __nonzero__(self):
+        """:return: ``True`` if the numerical value of this IP address is not \
+            zero, ``False`` otherwise."""
+        #   Python 2.x.
+        return bool(self._value)
+
+    __bool__ = __nonzero__  #   Python 3.x.
+
+    def __str__(self):
+        """:return: IP address in presentational format"""
+        return self._module.int_to_str(self._value)
+
+    def __repr__(self):
+        """:return: Python statement to create an equivalent object"""
+        return "%s('%s')" % (self.__class__.__name__, self)
+
+
+class IPListMixin(object):
+    """
+    A mixin class providing shared list-like functionality to classes
+    representing groups of IP addresses.
+
+    """
+    __slots__ = ()
+    def __iter__(self):
+        """
+        :return: An iterator providing access to all `IPAddress` objects
+            within range represented by this ranged IP object.
+        """
+        start_ip = IPAddress(self.first, self._module.version)
+        end_ip = IPAddress(self.last, self._module.version)
+        return iter_iprange(start_ip, end_ip)
+
+    @property
+    def size(self):
+        """
+        The total number of IP addresses within this ranged IP object.
+        """
+        return int(self.last - self.first + 1)
+
+    def __len__(self):
+        """
+        :return: the number of IP addresses in this ranged IP object. Raises
+            an `IndexError` if size > system max int (a Python 2.x
+            limitation). Use the .size property for subnets of any size.
+        """
+        size = self.size
+        if size > _sys_maxint:
+            raise IndexError(("range contains more than %d (sys.maxint) "
+               "IP addresses! Use the .size property instead." % _sys_maxint))
+        return size
+
+    def __getitem__(self, index):
+        """
+        :return: The IP address(es) in this `IPNetwork` object referenced by
+            index or slice. As slicing can produce large sequences of objects
+            an iterator is returned instead of the more usual `list`.
+        """
+        item = None
+
+        if hasattr(index, 'indices'):
+            if self._module.version == 6:
+                raise TypeError('IPv6 slices are not supported!')
+
+            (start, stop, step) = index.indices(self.size)
+
+            if (start + step < 0) or (step > stop):
+                #   step value exceeds start and stop boundaries.
+                item = iter([IPAddress(self.first, self._module.version)])
+            else:
+                start_ip = IPAddress(self.first + start, self._module.version)
+                end_ip = IPAddress(self.first + stop - step, self._module.version)
+                item = iter_iprange(start_ip, end_ip, step)
+        else:
+            try:
+                index = int(index)
+                if (- self.size) <= index < 0:
+                    #   negative index.
+                    item = IPAddress(self.last + index + 1, self._module.version)
+                elif 0 <= index <= (self.size - 1):
+                    #   Positive index or zero index.
+                    item = IPAddress(self.first + index, self._module.version)
+                else:
+                    raise IndexError('index out range for address range size!')
+            except ValueError:
+                raise TypeError('unsupported index type %r!' % index)
+
+        return item
+
+    def __contains__(self, other):
+        """
+        :param other: an `IPAddress` or ranged IP object.
+
+        :return: ``True`` if other falls within the boundary of this one,
+            ``False`` otherwise.
+        """
+        if isinstance(other, BaseIP):
+            if self._module.version != other._module.version:
+                return False
+            if isinstance(other, IPAddress):
+                return other._value >= self.first and other._value <= self.last
+            # Assume that we (and the other) provide .first and .last.
+            return other.first >= self.first and other.last <= self.last
+
+        # Whatever it is, try to interpret it as IPAddress.
+        return IPAddress(other) in self
+
+    def __nonzero__(self):
+        """
+        Ranged IP objects always represent a sequence of at least one IP
+        address and are therefore always True in the boolean context.
+        """
+        #   Python 2.x.
+        return True
+
+    __bool__ = __nonzero__  #   Python 3.x.
+
+
+def parse_ip_network(module, addr, implicit_prefix=False, flags=0):
+    if isinstance(addr, tuple):
+        #   CIDR integer tuple
+        if len(addr) != 2:
+            raise AddrFormatError('invalid %s tuple!' % module.family_name)
+        value, prefixlen = addr
+
+        if not(0 <= value <= module.max_int):
+            raise AddrFormatError('invalid address value for %s tuple!'
+                % module.family_name)
+        if not(0 <= prefixlen <= module.width):
+            raise AddrFormatError('invalid prefix for %s tuple!' \
+                % module.family_name)
+    elif isinstance(addr, _str_type):
+        #   CIDR-like string subnet
+        if implicit_prefix:
+            #TODO: deprecate this option in netaddr 0.8.x
+            addr = cidr_abbrev_to_verbose(addr)
+
+        if '/' in addr:
+            val1, val2 = addr.split('/', 1)
+        else:
+            val1 = addr
+            val2 = None
+
+        try:
+            ip = IPAddress(val1, module.version, flags=INET_PTON)
+        except AddrFormatError:
+            if module.version == 4:
+                #   Try a partial IPv4 network address...
+                expanded_addr = _ipv4.expand_partial_address(val1)
+                ip = IPAddress(expanded_addr, module.version, flags=INET_PTON)
+            else:
+                raise AddrFormatError('invalid IPNetwork address %s!' % addr)
+        value = ip._value
+
+        try:
+            #   Integer CIDR prefix.
+            prefixlen = int(val2)
+        except TypeError:
+            if val2 is None:
+                #   No prefix was specified.
+                prefixlen = module.width
+        except ValueError:
+            #   Not an integer prefix, try a netmask/hostmask prefix.
+            mask = IPAddress(val2, module.version, flags=INET_PTON)
+            if mask.is_netmask():
+                prefixlen = module.netmask_to_prefix[mask._value]
+            elif mask.is_hostmask():
+                prefixlen = module.hostmask_to_prefix[mask._value]
+            else:
+                raise AddrFormatError('addr %r is not a valid IPNetwork!' \
+                    % addr)
+
+        if not 0 <= prefixlen <= module.width:
+            raise AddrFormatError('invalid prefix for %s address!' \
+                % module.family_name)
+    else:
+        raise TypeError('unexpected type %s for addr arg' % type(addr))
+
+    if flags & NOHOST:
+        #   Remove host bits.
+        netmask = module.prefix_to_netmask[prefixlen]
+        value = value & netmask
+
+    return value, prefixlen
+
+
+class IPNetwork(BaseIP, IPListMixin):
+    """
+    An IPv4 or IPv6 network or subnet.
+
+    A combination of an IP address and a network mask.
+
+    Accepts CIDR and several related variants :
+
+    a) Standard CIDR::
+
+        x.x.x.x/y -> 192.0.2.0/24
+        x::/y -> fe80::/10
+
+    b) Hybrid CIDR format (netmask address instead of prefix), where 'y' \
+       address represent a valid netmask::
+
+        x.x.x.x/y.y.y.y -> 192.0.2.0/255.255.255.0
+        x::/y:: -> fe80::/ffc0::
+
+    c) ACL hybrid CIDR format (hostmask address instead of prefix like \
+       Cisco's ACL bitmasks), where 'y' address represent a valid netmask::
+
+        x.x.x.x/y.y.y.y -> 192.0.2.0/0.0.0.255
+        x::/y:: -> fe80::/3f:ffff:ffff:ffff:ffff:ffff:ffff:ffff
+
+    d) Abbreviated CIDR format (as of netaddr 0.7.x this requires the \
+       optional constructor argument ``implicit_prefix=True``)::
+
+        x       -> 192
+        x/y     -> 10/8
+        x.x/y   -> 192.168/16
+        x.x.x/y -> 192.168.0/24
+
+        which are equivalent to::
+
+        x.0.0.0/y   -> 192.0.0.0/24
+        x.0.0.0/y   -> 10.0.0.0/8
+        x.x.0.0/y   -> 192.168.0.0/16
+        x.x.x.0/y   -> 192.168.0.0/24
+
+    .. warning::
+
+        The next release (0.9.0) will contain a backwards incompatible change
+        connected to handling of RFC 6164 IPv6 addresses (/127 and /128 subnets).
+        When iterating ``IPNetwork`` and ``IPNetwork.iter_hosts()`` the first
+        addresses in the networks will no longer be excluded and ``broadcast``
+        will be ``None``.
+    """
+    __slots__ = ('_prefixlen',)
+
+    def __init__(self, addr, implicit_prefix=False, version=None, flags=0):
+        """
+        Constructor.
+
+        :param addr: an IPv4 or IPv6 address with optional CIDR prefix,
+            netmask or hostmask. May be an IP address in presentation
+            (string) format, an tuple containing and integer address and a
+            network prefix, or another IPAddress/IPNetwork object (copy
+            construction).
+
+        :param implicit_prefix: (optional) if True, the constructor uses
+            classful IPv4 rules to select a default prefix when one is not
+            provided. If False it uses the length of the IP address version.
+            (default: False)
+
+        :param version: (optional) optimizes version detection if specified
+            and distinguishes between IPv4 and IPv6 for addresses with an
+            equivalent integer value.
+
+        :param flags: (optional) decides which rules are applied to the
+            interpretation of the addr value. Currently only supports the
+            NOHOST option. See the netaddr.core docs for further details.
+
+        """
+        super(IPNetwork, self).__init__()
+
+        value, prefixlen, module = None, None, None
+
+        if hasattr(addr, '_prefixlen'):
+            #   IPNetwork object copy constructor
+            value = addr._value
+            module = addr._module
+            prefixlen = addr._prefixlen
+        elif hasattr(addr, '_value'):
+            #   IPAddress object copy constructor
+            value = addr._value
+            module = addr._module
+            prefixlen = module.width
+        elif version == 4:
+            value, prefixlen = parse_ip_network(_ipv4, addr,
+                implicit_prefix=implicit_prefix, flags=flags)
+            module = _ipv4
+        elif version == 6:
+            value, prefixlen = parse_ip_network(_ipv6, addr,
+                implicit_prefix=implicit_prefix, flags=flags)
+            module = _ipv6
+        else:
+            if version is not None:
+                raise ValueError('%r is an invalid IP version!' % version)
+            try:
+                module = _ipv4
+                value, prefixlen = parse_ip_network(module, addr,
+                    implicit_prefix, flags)
+            except AddrFormatError:
+                try:
+                    module = _ipv6
+                    value, prefixlen = parse_ip_network(module, addr,
+                        implicit_prefix, flags)
+                except AddrFormatError:
+                    pass
+
+                if value is None:
+                    raise AddrFormatError('invalid IPNetwork %s' % (addr,))
+
+        self._value = value
+        self._prefixlen = prefixlen
+        self._module = module
+
+    def __getstate__(self):
+        """:return: Pickled state of an `IPNetwork` object."""
+        return self._value, self._prefixlen, self._module.version
+
+    def __setstate__(self, state):
+        """
+        :param state: data used to unpickle a pickled `IPNetwork` object.
+
+        """
+        value, prefixlen, version = state
+
+        self._value = value
+
+        if version == 4:
+            self._module = _ipv4
+        elif version == 6:
+            self._module = _ipv6
+        else:
+            raise ValueError('unpickling failed for object state %s' \
+                % (state,))
+
+        if 0 <= prefixlen <= self._module.width:
+            self._prefixlen = prefixlen
+        else:
+            raise ValueError('unpickling failed for object state %s' \
+                % (state,))
+
+    def _set_prefixlen(self, value):
+        if not isinstance(value, _int_type):
+            raise TypeError('int argument expected, not %s' % type(value))
+        if not 0 <= value <= self._module.width:
+            raise AddrFormatError('invalid prefix for an %s address!' \
+                % self._module.family_name)
+        self._prefixlen = value
+
+    prefixlen = property(lambda self: self._prefixlen, _set_prefixlen,
+        doc='size of the bitmask used to separate the network from the host bits')
+
+    @property
+    def ip(self):
+        """
+        The IP address of this `IPNetwork` object. This is may or may not be
+        the same as the network IP address which varies according to the value
+        of the CIDR subnet prefix.
+        """
+        return IPAddress(self._value, self._module.version)
+
+    @property
+    def network(self):
+        """The network address of this `IPNetwork` object."""
+        return IPAddress(self._value & self._netmask_int, self._module.version)
+
+    @property
+    def broadcast(self):
+        """The broadcast address of this `IPNetwork` object.
+
+        .. warning::
+
+            The next release (0.9.0) will contain a backwards incompatible change
+            connected to handling of RFC 6164 IPv6 addresses (/127 and /128 subnets).
+            ``broadcast`` will be ``None`` when dealing with those networks.
+        """
+        if self._module.version == 4 and (self._module.width - self._prefixlen) <= 1:
+            return None
+        else:
+            return IPAddress(self._value | self._hostmask_int, self._module.version)
+
+    @property
+    def first(self):
+        """
+        The integer value of first IP address found within this `IPNetwork`
+        object.
+        """
+        return self._value & (self._module.max_int ^ self._hostmask_int)
+
+    @property
+    def last(self):
+        """
+        The integer value of last IP address found within this `IPNetwork`
+        object.
+        """
+        hostmask = (1 << (self._module.width - self._prefixlen)) - 1
+        return self._value | hostmask
+
+    @property
+    def netmask(self):
+        """The subnet mask of this `IPNetwork` object."""
+        netmask = self._module.max_int ^ self._hostmask_int
+        return IPAddress(netmask, self._module.version)
+
+    @netmask.setter
+    def netmask(self, value):
+        """Set the prefixlen using a subnet mask"""
+        ip = IPAddress(value)
+
+        if ip.version != self.version:
+            raise ValueError("IP version mismatch: %s and %s" % (ip, self))
+
+        if not ip.is_netmask():
+            raise ValueError("Invalid subnet mask specified: %s" % str(value))
+
+        self.prefixlen = ip.netmask_bits()
+
+    @property
+    def _netmask_int(self):
+        """Same as self.netmask, but in integer format"""
+        return self._module.max_int ^ self._hostmask_int
+
+    @property
+    def hostmask(self):
+        """The host mask of this `IPNetwork` object."""
+        hostmask = (1 << (self._module.width - self._prefixlen)) - 1
+        return IPAddress(hostmask, self._module.version)
+
+    @property
+    def _hostmask_int(self):
+        """Same as self.hostmask, but in integer format"""
+        return (1 << (self._module.width - self._prefixlen)) - 1
+
+    @property
+    def cidr(self):
+        """
+        The true CIDR address for this `IPNetwork` object which omits any
+        host bits to the right of the CIDR subnet prefix.
+        """
+        return IPNetwork(
+                (self._value & self._netmask_int, self._prefixlen),
+                version=self._module.version)
+
+    def __iadd__(self, num):
+        """
+        Increases the value of this `IPNetwork` object by the current size
+        multiplied by ``num``.
+
+        An `IndexError` is raised if result exceeds maximum IP address value
+        or is less than zero.
+
+        :param num: (optional) number of `IPNetwork` blocks to increment \
+            this IPNetwork's value by.
+        """
+        new_value = int(self.network) + (self.size * num)
+
+        if (new_value + (self.size - 1)) > self._module.max_int:
+            raise IndexError('increment exceeds address boundary!')
+        if new_value < 0:
+            raise IndexError('increment is less than zero!')
+
+        self._value = new_value
+        return self
+
+    def __isub__(self, num):
+        """
+        Decreases the value of this `IPNetwork` object by the current size
+        multiplied by ``num``.
+
+        An `IndexError` is raised if result is less than zero or exceeds
+        maximum IP address value.
+
+        :param num: (optional) number of `IPNetwork` blocks to decrement \
+            this IPNetwork's value by.
+        """
+        new_value = int(self.network) - (self.size * num)
+
+        if new_value < 0:
+            raise IndexError('decrement is less than zero!')
+        if (new_value + (self.size - 1)) > self._module.max_int:
+            raise IndexError('decrement exceeds address boundary!')
+
+        self._value = new_value
+        return self
+
+    def __contains__(self, other):
+        """
+        :param other: an `IPAddress` or ranged IP object.
+
+        :return: ``True`` if other falls within the boundary of this one,
+            ``False`` otherwise.
+        """
+        if isinstance(other, BaseIP):
+            if self._module.version != other._module.version:
+                return False
+
+            # self_net will contain only the network bits.
+            shiftwidth = self._module.width - self._prefixlen
+            self_net = self._value >> shiftwidth
+            if isinstance(other, IPRange):
+                # IPRange has no _value.
+                # (self_net+1)<<shiftwidth is not our last address, but the one
+                # after the last one.
+                return ((self_net << shiftwidth) <= other._start._value and
+                        (((self_net + 1) << shiftwidth) > other._end._value))
+
+            other_net = other._value >> shiftwidth
+            if isinstance(other, IPAddress):
+                return other_net == self_net
+            if isinstance(other, IPNetwork):
+                return self_net == other_net and self._prefixlen <= other._prefixlen
+
+        # Whatever it is, try to interpret it as IPNetwork
+        return IPNetwork(other) in self
+
+    def key(self):
+        """
+        :return: A key tuple used to uniquely identify this `IPNetwork`.
+        """
+        return self._module.version, self.first, self.last
+
+    def sort_key(self):
+        """
+        :return: A key tuple used to compare and sort this `IPNetwork` correctly.
+        """
+        net_size_bits = self._prefixlen - 1
+        first = self._value & (self._module.max_int ^ self._hostmask_int)
+        host_bits = self._value - first
+        return self._module.version, first, net_size_bits, host_bits
+
+    def ipv4(self):
+        """
+        :return: A numerically equivalent version 4 `IPNetwork` object. \
+            Raises an `AddrConversionError` if IPv6 address cannot be \
+            converted to IPv4.
+        """
+        ip = None
+        klass = self.__class__
+
+        if self._module.version == 4:
+            ip = klass('%s/%d' % (self.ip, self.prefixlen))
+        elif self._module.version == 6:
+            if 0 <= self._value <= _ipv4.max_int:
+                addr = _ipv4.int_to_str(self._value)
+                ip = klass('%s/%d' % (addr, self.prefixlen - 96))
+            elif _ipv4.max_int <= self._value <= 0xffffffffffff:
+                addr = _ipv4.int_to_str(self._value - 0xffff00000000)
+                ip = klass('%s/%d' % (addr, self.prefixlen - 96))
+            else:
+                raise AddrConversionError('IPv6 address %s unsuitable for ' \
+                    'conversion to IPv4!' % self)
+        return ip
+
+    def ipv6(self, ipv4_compatible=False):
+        """
+        .. note:: the IPv4-mapped IPv6 address format is now considered \
+        deprecated. See RFC 4291 or later for details.
+
+        :param ipv4_compatible: If ``True`` returns an IPv4-mapped address
+            (::ffff:x.x.x.x), an IPv4-compatible (::x.x.x.x) address
+            otherwise. Default: False (IPv4-mapped).
+
+        :return: A numerically equivalent version 6 `IPNetwork` object.
+        """
+        ip = None
+        klass = self.__class__
+
+        if self._module.version == 6:
+            if ipv4_compatible and \
+                (0xffff00000000 <= self._value <= 0xffffffffffff):
+                ip = klass((self._value - 0xffff00000000, self._prefixlen),
+                    version=6)
+            else:
+                ip = klass((self._value, self._prefixlen), version=6)
+        elif self._module.version == 4:
+            if ipv4_compatible:
+                #   IPv4-Compatible IPv6 address
+                ip = klass((self._value, self._prefixlen + 96), version=6)
+            else:
+                #   IPv4-Mapped IPv6 address
+                ip = klass((0xffff00000000 + self._value,
+                            self._prefixlen + 96), version=6)
+
+        return ip
+
+    def previous(self, step=1):
+        """
+        :param step: the number of IP subnets between this `IPNetwork` object
+            and the expected subnet. Default: 1 (the previous IP subnet).
+
+        :return: The adjacent subnet preceding this `IPNetwork` object.
+        """
+        ip_copy = self.__class__('%s/%d' % (self.network, self.prefixlen),
+            self._module.version)
+        ip_copy -= step
+        return ip_copy
+
+    def next(self, step=1):
+        """
+        :param step: the number of IP subnets between this `IPNetwork` object
+            and the expected subnet. Default: 1 (the next IP subnet).
+
+        :return: The adjacent subnet succeeding this `IPNetwork` object.
+        """
+        ip_copy = self.__class__('%s/%d' % (self.network, self.prefixlen),
+            self._module.version)
+        ip_copy += step
+        return ip_copy
+
+    def supernet(self, prefixlen=0):
+        """
+        Provides a list of supernets for this `IPNetwork` object between the
+        size of the current prefix and (if specified) an endpoint prefix.
+
+        :param prefixlen: (optional) a CIDR prefix for the maximum supernet.
+            Default: 0 - returns all possible supernets.
+
+        :return: a tuple of supernet `IPNetwork` objects.
+        """
+        if not 0 <= prefixlen <= self._module.width:
+            raise ValueError('CIDR prefix /%d invalid for IPv%d!' \
+                % (prefixlen, self._module.version))
+
+        supernets = []
+        # Use a copy of self as we'll be editing it.
+        supernet = self.cidr
+        supernet._prefixlen = prefixlen
+        while supernet._prefixlen != self._prefixlen:
+            supernets.append(supernet.cidr)
+            supernet._prefixlen += 1
+        return supernets
+
+    def subnet(self, prefixlen, count=None, fmt=None):
+        """
+        A generator that divides up this IPNetwork's subnet into smaller
+        subnets based on a specified CIDR prefix.
+
+        :param prefixlen: a CIDR prefix indicating size of subnets to be
+            returned.
+
+        :param count: (optional) number of consecutive IP subnets to be
+            returned.
+
+        :return: an iterator containing IPNetwork subnet objects.
+        """
+        if not 0 <= self.prefixlen <= self._module.width:
+            raise ValueError('CIDR prefix /%d invalid for IPv%d!' \
+                % (prefixlen, self._module.version))
+
+        if not self.prefixlen <= prefixlen:
+            #   Don't return anything.
+            return
+
+        #   Calculate number of subnets to be returned.
+        width = self._module.width
+        max_subnets = 2 ** (width - self.prefixlen) // 2 ** (width - prefixlen)
+
+        if count is None:
+            count = max_subnets
+
+        if not 1 <= count <= max_subnets:
+            raise ValueError('count outside of current IP subnet boundary!')
+
+        base_subnet = self._module.int_to_str(self.first)
+        i = 0
+        while(i < count):
+            subnet = self.__class__('%s/%d' % (base_subnet, prefixlen),
+                self._module.version)
+            subnet.value += (subnet.size * i)
+            subnet.prefixlen = prefixlen
+            i += 1
+            yield subnet
+
+    def iter_hosts(self):
+        """
+        A generator that provides all the IP addresses that can be assigned
+        to hosts within the range of this IP object's subnet.
+
+        - for IPv4, the network and broadcast addresses are always excluded. \
+          for subnets that contains less than 4 IP addresses /31 and /32 \
+          report in a manner per RFC 3021
+
+        - for IPv6, only the unspecified address '::' or Subnet-Router anycast \
+          address (first address in the network) is excluded.
+
+        .. warning::
+
+            The next release (0.9.0) will contain a backwards incompatible change
+            connected to handling of RFC 6164 IPv6 addresses (/127 and /128 subnets).
+            When iterating ``IPNetwork`` and ``IPNetwork.iter_hosts()`` the first
+            addresses in the networks will no longer be excluded.
+
+        :return: an IPAddress iterator
+        """
+        it_hosts = iter([])
+
+        if self._module.version == 4:
+            #   IPv4 logic.
+            if self.size >= 4:
+                it_hosts = iter_iprange(
+                        IPAddress(self.first + 1, self._module.version),
+                        IPAddress(self.last - 1, self._module.version))
+            else:
+                it_hosts = iter_iprange(
+                        IPAddress(self.first, self._module.version),
+                        IPAddress(self.last, self._module.version))
+        else:
+            #   IPv6 logic.
+            # RFC 4291 section 2.6.1 says that the first IP in the network is
+            # the Subnet-Router anycast address. This address cannot be
+            # assigned to a host, so use self.first+1.
+            if self.size >= 2:
+                it_hosts = iter_iprange(
+                    IPAddress(self.first + 1, self._module.version),
+                    IPAddress(self.last, self._module.version))
+        return it_hosts
+
+    def __str__(self):
+        """:return: this IPNetwork in CIDR format"""
+        addr = self._module.int_to_str(self._value)
+        return "%s/%s" % (addr, self.prefixlen)
+
+    def __repr__(self):
+        """:return: Python statement to create an equivalent object"""
+        return "%s('%s')" % (self.__class__.__name__, self)
+
+
+class IPRange(BaseIP, IPListMixin):
+    """
+    An arbitrary IPv4 or IPv6 address range.
+
+    Formed from a lower and upper bound IP address. The upper bound IP cannot
+    be numerically smaller than the lower bound and the IP version of both
+    must match.
+
+    """
+    __slots__ = ('_start', '_end')
+
+    def __init__(self, start, end, flags=0):
+        """
+        Constructor.
+
+        :param start: an IPv4 or IPv6 address that forms the lower
+            boundary of this IP range.
+
+        :param end: an IPv4 or IPv6 address that forms the upper
+            boundary of this IP range.
+
+        :param flags: (optional) decides which rules are applied to the
+            interpretation of the start and end values. Supported constants
+            are INET_PTON and ZEROFILL. See the netaddr.core docs for further
+            details.
+
+        """
+        self._start = IPAddress(start, flags=flags)
+        self._module = self._start._module
+        self._end = IPAddress(end, self._module.version, flags=flags)
+        if int(self._start) > int(self._end):
+            raise AddrFormatError('lower bound IP greater than upper bound!')
+
+    def __getstate__(self):
+        """:return: Pickled state of an `IPRange` object."""
+        return self._start.value, self._end.value, self._module.version
+
+    def __setstate__(self, state):
+        """
+        :param state: data used to unpickle a pickled `IPRange` object.
+        """
+        start, end, version = state
+
+        self._start = IPAddress(start, version)
+        self._module = self._start._module
+        self._end = IPAddress(end, version)
+
+    def __contains__(self, other):
+        if isinstance(other, BaseIP):
+            if self._module.version != other._module.version:
+                return False
+            if isinstance(other, IPAddress):
+                return (self._start._value <= other._value and
+                        self._end._value >= other._value)
+            if isinstance(other, IPRange):
+                return (self._start._value <= other._start._value and
+                        self._end._value >= other._end._value)
+            if isinstance(other, IPNetwork):
+                shiftwidth = other._module.width - other._prefixlen
+                other_start = (other._value >> shiftwidth) << shiftwidth
+                # Start of the next network after other
+                other_next_start = other_start + (1 << shiftwidth)
+
+                return (self._start._value <= other_start and
+                        self._end._value > other_next_start)
+
+        # Whatever it is, try to interpret it as IPAddress.
+        return IPAddress(other) in self
+
+    @property
+    def first(self):
+        """The integer value of first IP address in this `IPRange` object."""
+        return int(self._start)
+
+    @property
+    def last(self):
+        """The integer value of last IP address in this `IPRange` object."""
+        return int(self._end)
+
+    def key(self):
+        """
+        :return: A key tuple used to uniquely identify this `IPRange`.
+        """
+        return self._module.version, self.first, self.last
+
+    def sort_key(self):
+        """
+        :return: A key tuple used to compare and sort this `IPRange` correctly.
+        """
+        skey = self._module.width - num_bits(self.size)
+        return self._module.version, self._start._value, skey
+
+    def cidrs(self):
+        """
+        The list of CIDR addresses found within the lower and upper bound
+        addresses of this `IPRange`.
+        """
+        return iprange_to_cidrs(self._start, self._end)
+
+    def __str__(self):
+        """:return: this `IPRange` in a common representational format."""
+        return "%s-%s" % (self._start, self._end)
+
+    def __repr__(self):
+        """:return: Python statement to create an equivalent object"""
+        return "%s('%s', '%s')" % (self.__class__.__name__,
+            self._start, self._end)
+
+
+def iter_unique_ips(*args):
+    """
+    :param args: A list of IP addresses and subnets passed in as arguments.
+
+    :return: A generator that flattens out IP subnets, yielding unique
+        individual IP addresses (no duplicates).
+    """
+    for cidr in cidr_merge(args):
+        for ip in cidr:
+            yield ip
+
+
+def cidr_abbrev_to_verbose(abbrev_cidr):
+    """
+    A function that converts abbreviated IPv4 CIDRs to their more verbose
+    equivalent.
+
+    :param abbrev_cidr: an abbreviated CIDR.
+
+    Uses the old-style classful IP address rules to decide on a default
+    subnet prefix if one is not explicitly provided.
+
+    Only supports IPv4 addresses.
+
+    Examples ::
+
+        10                  - 10.0.0.0/8
+        10/16               - 10.0.0.0/16
+        128                 - 128.0.0.0/16
+        128/8               - 128.0.0.0/8
+        192.168             - 192.168.0.0/16
+
+    :return: A verbose CIDR from an abbreviated CIDR or old-style classful \
+        network address. The original value if it was not recognised as a \
+        supported abbreviation.
+    """
+    #   Internal function that returns a prefix value based on the old IPv4
+    #   classful network scheme that has been superseded (almost) by CIDR.
+    def classful_prefix(octet):
+        octet = int(octet)
+        if not 0 <= octet <= 255:
+            raise IndexError('Invalid octet: %r!' % octet)
+        if 0 <= octet <= 127:       #   Legacy class 'A' classification.
+            return 8
+        elif 128 <= octet <= 191:   #   Legacy class 'B' classification.
+            return 16
+        elif 192 <= octet <= 223:   #   Legacy class 'C' classification.
+            return 24
+        elif 224 <= octet <= 239:   #   Multicast address range.
+            return 4
+        return 32                   #   Default.
+
+    if _is_str(abbrev_cidr):
+        if ':' in abbrev_cidr or abbrev_cidr == '':
+            return abbrev_cidr
+
+    try:
+        #   Single octet partial integer or string address.
+        i = int(abbrev_cidr)
+        return "%s.0.0.0/%s" % (i, classful_prefix(i))
+    except ValueError:
+        #   Multi octet partial string address with optional prefix.
+        if '/' in abbrev_cidr:
+            part_addr, prefix = abbrev_cidr.split('/', 1)
+
+            #   Check prefix for validity.
+            try:
+                if not 0 <= int(prefix) <= 32:
+                    raise ValueError('prefixlen in address %r out of range' \
+                        ' for IPv4!' % (abbrev_cidr,))
+            except ValueError:
+                return abbrev_cidr
+        else:
+            part_addr = abbrev_cidr
+            prefix = None
+
+        tokens = part_addr.split('.')
+        if len(tokens) > 4:
+            #   Not a recognisable format.
+            return abbrev_cidr
+        for i in range(4 - len(tokens)):
+            tokens.append('0')
+
+        if prefix is None:
+            try:
+                prefix = classful_prefix(tokens[0])
+            except ValueError:
+                return abbrev_cidr
+
+        return "%s/%s" % ('.'.join(tokens), prefix)
+    except (TypeError, IndexError):
+        #   Not a recognisable format.
+        return abbrev_cidr
+
+
+
+def cidr_merge(ip_addrs):
+    """
+    A function that accepts an iterable sequence of IP addresses and subnets
+    merging them into the smallest possible list of CIDRs. It merges adjacent
+    subnets where possible, those contained within others and also removes
+    any duplicates.
+
+    :param ip_addrs: an iterable sequence of IP addresses, subnets or ranges.
+
+    :return: a summarized list of `IPNetwork` objects.
+    """
+    # The algorithm is quite simple: For each CIDR we create an IP range.
+    # Sort them and merge when possible.  Afterwars split them again
+    # optimally.
+    if not hasattr(ip_addrs, '__iter__'):
+        raise ValueError('A sequence or iterator is expected!')
+
+    ranges = []
+
+    for ip in ip_addrs:
+        if isinstance(ip, (IPNetwork, IPRange)):
+            net = ip
+        else:
+            net = IPNetwork(ip)
+        # Since non-overlapping ranges are the common case, remember the original
+        ranges.append( (net.version, net.last, net.first, net) )
+
+    ranges.sort()
+    i = len(ranges) - 1
+    while i > 0:
+        if ranges[i][0] == ranges[i - 1][0] and ranges[i][2] - 1 <= ranges[i - 1][1]:
+            ranges[i - 1] = (ranges[i][0], ranges[i][1], min(ranges[i - 1][2], ranges[i][2]))
+            del ranges[i]
+        i -= 1
+    merged = []
+    for range_tuple in ranges:
+        # If this range wasn't merged we can simply use the old cidr.
+        if len(range_tuple) == 4:
+            original = range_tuple[3]
+            if isinstance(original, IPRange):
+                merged.extend(original.cidrs())
+            else:
+                merged.append(original)
+        else:
+            version = range_tuple[0]
+            range_start = IPAddress(range_tuple[2], version=version)
+            range_stop = IPAddress(range_tuple[1], version=version)
+            merged.extend(iprange_to_cidrs(range_start, range_stop))
+    return merged
+
+
+def cidr_exclude(target, exclude):
+    """
+    Removes an exclude IP address or subnet from target IP subnet.
+
+    :param target: the target IP address or subnet to be divided up.
+
+    :param exclude: the IP address or subnet to be removed from target.
+
+    :return: list of `IPNetwork` objects remaining after exclusion.
+    """
+    left, _, right = cidr_partition(target, exclude)
+
+    return left + right
+
+def cidr_partition(target, exclude):
+    """
+    Partitions a target IP subnet on an exclude IP address.
+
+    :param target: the target IP address or subnet to be divided up.
+
+    :param exclude: the IP address or subnet to partition on
+
+    :return: list of `IPNetwork` objects before, the partition and after, sorted.
+
+    Adding the three lists returns the equivalent of the original subnet.
+    """
+
+    target = IPNetwork(target)
+    exclude = IPNetwork(exclude)
+
+    if exclude.last < target.first:
+        #   Exclude subnet's upper bound address less than target
+        #   subnet's lower bound.
+        return [], [], [target.cidr]
+    elif target.last < exclude.first:
+        #   Exclude subnet's lower bound address greater than target
+        #   subnet's upper bound.
+        return [target.cidr], [], []
+
+    if target.prefixlen >= exclude.prefixlen:
+        # Exclude contains the target
+        return [], [target], []
+
+    left = []
+    right = []
+
+    new_prefixlen = target.prefixlen + 1
+    # Some @properties that are expensive to get and don't change below.
+    target_module_width = target._module.width
+
+    target_first = target.first
+    version = exclude.version
+    i_lower = target_first
+    i_upper = target_first + (2 ** (target_module_width - new_prefixlen))
+
+    while exclude.prefixlen >= new_prefixlen:
+        if exclude.first >= i_upper:
+            left.append(IPNetwork((i_lower, new_prefixlen), version=version))
+            matched = i_upper
+        else:
+            right.append(IPNetwork((i_upper, new_prefixlen), version=version))
+            matched = i_lower
+
+        new_prefixlen += 1
+
+        if new_prefixlen > target_module_width:
+            break
+
+        i_lower = matched
+        i_upper = matched + (2 ** (target_module_width - new_prefixlen))
+
+    return left, [exclude], right[::-1]
+
+
+def spanning_cidr(ip_addrs):
+    """
+    Function that accepts a sequence of IP addresses and subnets returning
+    a single `IPNetwork` subnet that is large enough to span the lower and
+    upper bound IP addresses with a possible overlap on either end.
+
+    :param ip_addrs: sequence of IP addresses and subnets.
+
+    :return: a single spanning `IPNetwork` subnet.
+    """
+    ip_addrs_iter = iter(ip_addrs)
+    try:
+        network_a = IPNetwork(_iter_next(ip_addrs_iter))
+        network_b = IPNetwork(_iter_next(ip_addrs_iter))
+    except StopIteration:
+        raise ValueError('IP sequence must contain at least 2 elements!')
+
+    if network_a < network_b:
+        min_network = network_a
+        max_network = network_b
+    else:
+        min_network = network_b
+        max_network = network_a
+
+    for ip in ip_addrs_iter:
+        network = IPNetwork(ip)
+        if network < min_network:
+            min_network = network
+        if network > max_network:
+            max_network = network
+
+    if min_network.version != max_network.version:
+        raise TypeError('IP sequence cannot contain both IPv4 and IPv6!')
+
+    ipnum = max_network.last
+    prefixlen = max_network.prefixlen
+    lowest_ipnum = min_network.first
+    width = max_network._module.width
+
+    while prefixlen > 0 and ipnum > lowest_ipnum:
+        prefixlen -= 1
+        ipnum &= -(1<<(width-prefixlen))
+
+    return IPNetwork( (ipnum, prefixlen), version=min_network.version )
+
+
+def iter_iprange(start, end, step=1):
+    """
+    A generator that produces IPAddress objects between an arbitrary start
+    and stop IP address with intervals of step between them. Sequences
+    produce are inclusive of boundary IPs.
+
+    :param start: start IP address.
+
+    :param end: end IP address.
+
+    :param step: (optional) size of step between IP addresses. Default: 1
+
+    :return: an iterator of one or more `IPAddress` objects.
+    """
+    start = IPAddress(start)
+    end = IPAddress(end)
+
+    if start.version != end.version:
+        raise TypeError('start and stop IP versions do not match!')
+    version = start.version
+
+    step = int(step)
+    if step == 0:
+        raise ValueError('step argument cannot be zero')
+
+    #   We don't need objects from here, just integers.
+    start = int(start)
+    stop = int(end)
+
+    negative_step = False
+
+    if step < 0:
+        negative_step = True
+
+    index = start - step
+    while True:
+        index += step
+        if negative_step:
+            if not index >= stop:
+                break
+        else:
+            if not index <= stop:
+                break
+        yield IPAddress(index, version)
+
+
+
+def iprange_to_cidrs(start, end):
+    """
+    A function that accepts an arbitrary start and end IP address or subnet
+    and returns a list of CIDR subnets that fit exactly between the boundaries
+    of the two with no overlap.
+
+    :param start: the start IP address or subnet.
+
+    :param end: the end IP address or subnet.
+
+    :return: a list of one or more IP addresses and subnets.
+    """
+    cidr_list = []
+
+    start = IPNetwork(start)
+    end = IPNetwork(end)
+
+    iprange = [start.first, end.last]
+
+    #   Get spanning CIDR covering both addresses.
+    cidr_span = spanning_cidr([start, end])
+    width = start._module.width
+
+    if cidr_span.first < iprange[0]:
+        exclude = IPNetwork((iprange[0]-1, width), version=start.version)
+        cidr_list = cidr_partition(cidr_span, exclude)[2]
+        cidr_span = cidr_list.pop()
+    if cidr_span.last > iprange[1]:
+        exclude = IPNetwork((iprange[1]+1, width), version=start.version)
+        cidr_list += cidr_partition(cidr_span, exclude)[0]
+    else:
+        cidr_list.append(cidr_span)
+
+    return cidr_list
+
+
+def smallest_matching_cidr(ip, cidrs):
+    """
+    Matches an IP address or subnet against a given sequence of IP addresses
+    and subnets.
+
+    :param ip: a single IP address or subnet.
+
+    :param cidrs: a sequence of IP addresses and/or subnets.
+
+    :return: the smallest (most specific) matching IPAddress or IPNetwork
+        object from the provided sequence, None if there was no match.
+    """
+    match = None
+
+    if not hasattr(cidrs, '__iter__'):
+        raise TypeError('IP address/subnet sequence expected, not %r!'
+            % (cidrs,))
+
+    ip = IPAddress(ip)
+    for cidr in sorted([IPNetwork(cidr) for cidr in cidrs]):
+        if ip in cidr:
+            match = cidr
+        else:
+            if match is not None and cidr.network not in match:
+                break
+
+    return match
+
+
+def largest_matching_cidr(ip, cidrs):
+    """
+    Matches an IP address or subnet against a given sequence of IP addresses
+    and subnets.
+
+    :param ip: a single IP address or subnet.
+
+    :param cidrs: a sequence of IP addresses and/or subnets.
+
+    :return: the largest (least specific) matching IPAddress or IPNetwork
+        object from the provided sequence, None if there was no match.
+    """
+    match = None
+
+    if not hasattr(cidrs, '__iter__'):
+        raise TypeError('IP address/subnet sequence expected, not %r!'
+            % (cidrs,))
+
+    ip = IPAddress(ip)
+    for cidr in sorted([IPNetwork(cidr) for cidr in cidrs]):
+        if ip in cidr:
+            match = cidr
+            break
+
+    return match
+
+
+def all_matching_cidrs(ip, cidrs):
+    """
+    Matches an IP address or subnet against a given sequence of IP addresses
+    and subnets.
+
+    :param ip: a single IP address.
+
+    :param cidrs: a sequence of IP addresses and/or subnets.
+
+    :return: all matching IPAddress and/or IPNetwork objects from the provided
+        sequence, an empty list if there was no match.
+    """
+    matches = []
+
+    if not hasattr(cidrs, '__iter__'):
+        raise TypeError('IP address/subnet sequence expected, not %r!'
+            % (cidrs,))
+
+    ip = IPAddress(ip)
+    for cidr in sorted([IPNetwork(cidr) for cidr in cidrs]):
+        if ip in cidr:
+            matches.append(cidr)
+        else:
+            if matches and cidr.network not in matches[-1]:
+                break
+
+    return matches
+
+#-----------------------------------------------------------------------------
+#   Cached IPv4 address range lookups.
+#-----------------------------------------------------------------------------
+IPV4_LOOPBACK  = IPNetwork('127.0.0.0/8')    #   Loopback addresses (RFC 990)
+
+IPV4_PRIVATE = (
+    IPNetwork('10.0.0.0/8'),        #   Class A private network local communication (RFC 1918)
+    IPNetwork('100.64.0.0/10'),     #   Carrier grade NAT (RFC 6598)
+    IPNetwork('172.16.0.0/12'),     #   Private network - local communication (RFC 1918)
+    IPNetwork('192.0.0.0/24'),      #   IANA IPv4 Special Purpose Address Registry (RFC 5736)
+    IPNetwork('192.168.0.0/16'),    #   Class B private network local communication (RFC 1918)
+    IPNetwork('198.18.0.0/15'),     #  Testing of inter-network communications between subnets (RFC 2544)
+    IPRange('239.0.0.0', '239.255.255.255'),    #   Administrative Multicast
+)
+
+IPV4_LINK_LOCAL = IPNetwork('169.254.0.0/16')
+
+IPV4_MULTICAST = IPNetwork('224.0.0.0/4')
+
+IPV4_6TO4 = IPNetwork('192.88.99.0/24')    #   6to4 anycast relays (RFC 3068)
+
+IPV4_RESERVED = (
+    IPNetwork('0.0.0.0/8'),         #   Broadcast message (RFC 1700)
+    IPNetwork('192.0.2.0/24'),      #   TEST-NET examples and documentation (RFC 5737)
+    IPNetwork('240.0.0.0/4'),       #   Reserved for  multicast assignments (RFC 5771)
+    IPNetwork('198.51.100.0/24'),   #   TEST-NET-2 examples and documentation (RFC 5737)
+    IPNetwork('203.0.113.0/24'),    #   TEST-NET-3 examples and documentation (RFC 5737)
+
+    #   Reserved multicast
+    IPNetwork('233.252.0.0/24'),    #   Multicast test network
+    IPRange('234.0.0.0', '238.255.255.255'),
+    IPRange('225.0.0.0', '231.255.255.255'),
+) + (IPV4_LOOPBACK, IPV4_6TO4)
+
+#-----------------------------------------------------------------------------
+#   Cached IPv6 address range lookups.
+#-----------------------------------------------------------------------------
+IPV6_LOOPBACK = IPAddress('::1')
+
+IPV6_PRIVATE = (
+    IPNetwork('fc00::/7'),  #   Unique Local Addresses (ULA)
+    IPNetwork('fec0::/10'), #   Site Local Addresses (deprecated - RFC 3879)
+)
+
+IPV6_LINK_LOCAL = IPNetwork('fe80::/10')
+
+IPV6_MULTICAST = IPNetwork('ff00::/8')
+
+IPV6_RESERVED = (
+    IPNetwork('ff00::/12'), IPNetwork('::/8'),
+    IPNetwork('0100::/8'), IPNetwork('0200::/7'),
+    IPNetwork('0400::/6'), IPNetwork('0800::/5'),
+    IPNetwork('1000::/4'), IPNetwork('4000::/3'),
+    IPNetwork('6000::/3'), IPNetwork('8000::/3'),
+    IPNetwork('A000::/3'), IPNetwork('C000::/3'),
+    IPNetwork('E000::/4'), IPNetwork('F000::/5'),
+    IPNetwork('F800::/6'), IPNetwork('FE00::/9'),
+)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/glob.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/glob.py
new file mode 100644
index 0000000000000000000000000000000000000000..ed43b1b7a51d0ae889f77db7e7929e741924f7dc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/glob.py
@@ -0,0 +1,312 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+Routines and classes for supporting and expressing IP address ranges using a
+glob style syntax.
+
+"""
+from netaddr.core import AddrFormatError, AddrConversionError
+from netaddr.ip import IPRange, IPAddress, IPNetwork, iprange_to_cidrs
+from netaddr.compat import _is_str
+
+
+def valid_glob(ipglob):
+    """
+    :param ipglob: An IP address range in a glob-style format.
+
+    :return: ``True`` if IP range glob is valid, ``False`` otherwise.
+    """
+    #TODO: Add support for abbreviated ipglobs.
+    #TODO: e.g. 192.0.*.* == 192.0.*
+    #TODO:      *.*.*.*     == *
+    #TODO: Add strict flag to enable verbose ipglob checking.
+    if not _is_str(ipglob):
+        return False
+
+    seen_hyphen = False
+    seen_asterisk = False
+
+    octets = ipglob.split('.')
+
+    if len(octets) != 4:
+        return False
+
+    for octet in octets:
+        if '-' in octet:
+            if seen_hyphen:
+                return False
+            seen_hyphen = True
+            if seen_asterisk:
+                #   Asterisks cannot precede hyphenated octets.
+                return False
+            try:
+                (octet1, octet2) = [int(i) for i in octet.split('-')]
+            except ValueError:
+                return False
+            if octet1 >= octet2:
+                return False
+            if not 0 <= octet1 <= 254:
+                return False
+            if not 1 <= octet2 <= 255:
+                return False
+        elif octet == '*':
+            seen_asterisk = True
+        else:
+            if seen_hyphen is True:
+                return False
+            if seen_asterisk is True:
+                return False
+            try:
+                if not 0 <= int(octet) <= 255:
+                    return False
+            except ValueError:
+                return False
+    return True
+
+
+def glob_to_iptuple(ipglob):
+    """
+    A function that accepts a glob-style IP range and returns the component
+    lower and upper bound IP address.
+
+    :param ipglob: an IP address range in a glob-style format.
+
+    :return: a tuple contain lower and upper bound IP objects.
+    """
+    if not valid_glob(ipglob):
+        raise AddrFormatError('not a recognised IP glob range: %r!' % (ipglob,))
+
+    start_tokens = []
+    end_tokens = []
+
+    for octet in ipglob.split('.'):
+        if '-' in octet:
+            tokens = octet.split('-')
+            start_tokens.append(tokens[0])
+            end_tokens.append(tokens[1])
+        elif octet == '*':
+            start_tokens.append('0')
+            end_tokens.append('255')
+        else:
+            start_tokens.append(octet)
+            end_tokens.append(octet)
+
+    return IPAddress('.'.join(start_tokens)), IPAddress('.'.join(end_tokens))
+
+
+def glob_to_iprange(ipglob):
+    """
+    A function that accepts a glob-style IP range and returns the equivalent
+    IP range.
+
+    :param ipglob: an IP address range in a glob-style format.
+
+    :return: an IPRange object.
+    """
+    if not valid_glob(ipglob):
+        raise AddrFormatError('not a recognised IP glob range: %r!' % (ipglob,))
+
+    start_tokens = []
+    end_tokens = []
+
+    for octet in ipglob.split('.'):
+        if '-' in octet:
+            tokens = octet.split('-')
+            start_tokens.append(tokens[0])
+            end_tokens.append(tokens[1])
+        elif octet == '*':
+            start_tokens.append('0')
+            end_tokens.append('255')
+        else:
+            start_tokens.append(octet)
+            end_tokens.append(octet)
+
+    return IPRange('.'.join(start_tokens), '.'.join(end_tokens))
+
+
+def iprange_to_globs(start, end):
+    """
+    A function that accepts an arbitrary start and end IP address or subnet
+    and returns one or more glob-style IP ranges.
+
+    :param start: the start IP address or subnet.
+
+    :param end: the end IP address or subnet.
+
+    :return: a list containing one or more IP globs.
+    """
+    start = IPAddress(start)
+    end = IPAddress(end)
+
+    if start.version != 4 and end.version != 4:
+        raise AddrConversionError('IP glob ranges only support IPv4!')
+
+    def _iprange_to_glob(lb, ub):
+        #   Internal function to process individual IP globs.
+        t1 = [int(_) for _ in str(lb).split('.')]
+        t2 = [int(_) for _ in str(ub).split('.')]
+
+        tokens = []
+
+        seen_hyphen = False
+        seen_asterisk = False
+
+        for i in range(4):
+            if t1[i] == t2[i]:
+                #   A normal octet.
+                tokens.append(str(t1[i]))
+            elif (t1[i] == 0) and (t2[i] == 255):
+                #   An asterisk octet.
+                tokens.append('*')
+                seen_asterisk = True
+            else:
+                #   Create a hyphenated octet - only one allowed per IP glob.
+                if not seen_asterisk:
+                    if not seen_hyphen:
+                        tokens.append('%s-%s' % (t1[i], t2[i]))
+                        seen_hyphen = True
+                    else:
+                        raise AddrConversionError(
+                            'only 1 hyphenated octet per IP glob allowed!')
+                else:
+                    raise AddrConversionError(
+                        "asterisks are not allowed before hyphenated octets!")
+
+        return '.'.join(tokens)
+
+    globs = []
+
+    try:
+        #   IP range can be represented by a single glob.
+        ipglob = _iprange_to_glob(start, end)
+        if not valid_glob(ipglob):
+            #TODO: this is a workaround, it is produces non-optimal but valid
+            #TODO: glob conversions. Fix inner function so that is always
+            #TODO: produces a valid glob.
+            raise AddrConversionError('invalid ip glob created')
+        globs.append(ipglob)
+    except AddrConversionError:
+        #   Break IP range up into CIDRs before conversion to globs.
+        #
+        #TODO: this is still not completely optimised but is good enough
+        #TODO: for the moment.
+        #
+        for cidr in iprange_to_cidrs(start, end):
+            ipglob = _iprange_to_glob(cidr[0], cidr[-1])
+            globs.append(ipglob)
+
+    return globs
+
+
+def glob_to_cidrs(ipglob):
+    """
+    A function that accepts a glob-style IP range and returns a list of one
+    or more IP CIDRs that exactly matches it.
+
+    :param ipglob: an IP address range in a glob-style format.
+
+    :return: a list of one or more IP objects.
+    """
+    return iprange_to_cidrs(*glob_to_iptuple(ipglob))
+
+
+def cidr_to_glob(cidr):
+    """
+    A function that accepts an IP subnet in a glob-style format and returns
+    a list of CIDR subnets that exactly matches the specified glob.
+
+    :param cidr: an IP object CIDR subnet.
+
+    :return: a list of one or more IP addresses and subnets.
+    """
+    ip = IPNetwork(cidr)
+    globs = iprange_to_globs(ip[0], ip[-1])
+    if len(globs) != 1:
+        #   There should only ever be a one to one mapping between a CIDR and
+        #   an IP glob range.
+        raise AddrConversionError('bad CIDR to IP glob conversion!')
+    return globs[0]
+
+
+class IPGlob(IPRange):
+    """
+    Represents an IP address range using a glob-style syntax ``x.x.x-y.*``
+
+    Individual octets can be represented using the following shortcuts :
+
+        1. ``*`` - the asterisk octet (represents values ``0`` through ``255``)
+        2. ``x-y`` - the hyphenated octet (represents values ``x`` through ``y``)
+
+    A few basic rules also apply :
+
+        1. ``x`` must always be less than ``y``, therefore :
+
+        - ``x`` can only be ``0`` through ``254``
+        - ``y`` can only be ``1`` through ``255``
+
+        2. only one hyphenated octet per IP glob is allowed
+        3. only asterisks are permitted after a hyphenated octet
+
+    Examples:
+
+    +------------------+------------------------------+
+    | IP glob          | Description                  |
+    +==================+==============================+
+    | ``192.0.2.1``    | a single address             |
+    +------------------+------------------------------+
+    | ``192.0.2.0-31`` | 32 addresses                 |
+    +------------------+------------------------------+
+    | ``192.0.2.*``    | 256 addresses                |
+    +------------------+------------------------------+
+    | ``192.0.2-3.*``  | 512 addresses                |
+    +------------------+------------------------------+
+    | ``192.0-1.*.*``  | 131,072 addresses            |
+    +------------------+------------------------------+
+    | ``*.*.*.*``      | the whole IPv4 address space |
+    +------------------+------------------------------+
+
+    .. note :: \
+    IP glob ranges are not directly equivalent to CIDR blocks. \
+    They can represent address ranges that do not fall on strict bit mask \
+    boundaries. They are suitable for use in configuration files, being \
+    more obvious and readable than their CIDR counterparts, especially for \
+    admins and end users with little or no networking knowledge or \
+    experience. All CIDR addresses can always be represented as IP globs \
+    but the reverse is not always true.
+    """
+    __slots__ = ('_glob',)
+
+    def __init__(self, ipglob):
+        (start, end) = glob_to_iptuple(ipglob)
+        super(IPGlob, self).__init__(start, end)
+        self.glob = iprange_to_globs(self._start, self._end)[0]
+
+    def __getstate__(self):
+        """:return: Pickled state of an `IPGlob` object."""
+        return super(IPGlob, self).__getstate__()
+
+    def __setstate__(self, state):
+        """:param state: data used to unpickle a pickled `IPGlob` object."""
+        super(IPGlob, self).__setstate__(state)
+        self.glob = iprange_to_globs(self._start, self._end)[0]
+
+    def _get_glob(self):
+        return self._glob
+
+    def _set_glob(self, ipglob):
+        (self._start, self._end) = glob_to_iptuple(ipglob)
+        self._glob = iprange_to_globs(self._start, self._end)[0]
+
+    glob = property(_get_glob, _set_glob, None,
+        'an arbitrary IP address range in glob format.')
+
+    def __str__(self):
+        """:return: IP glob in common representational format."""
+        return "%s" % self.glob
+
+    def __repr__(self):
+        """:return: Python statement to create an equivalent object"""
+        return "%s('%s')" % (self.__class__.__name__, self.glob)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/iana.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/iana.py
new file mode 100644
index 0000000000000000000000000000000000000000..49da06e58d0c5dba6add709e6110c50c81fe9747
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/iana.py
@@ -0,0 +1,448 @@
+#!/usr/bin/env python
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+#
+#   DISCLAIMER
+#
+#   netaddr is not sponsored nor endorsed by IANA.
+#
+#   Use of data from IANA (Internet Assigned Numbers Authority) is subject to
+#   copyright and is provided with prior written permission.
+#
+#   IANA data files included with netaddr are not modified in any way but are
+#   parsed and made available to end users through an API.
+#
+#   See README file and source code for URLs to latest copies of the relevant
+#   files.
+#
+#-----------------------------------------------------------------------------
+"""
+Routines for accessing data published by IANA (Internet Assigned Numbers
+Authority).
+
+More details can be found at the following URLs :-
+
+    - IANA Home Page - http://www.iana.org/
+    - IEEE Protocols Information Home Page - http://www.iana.org/protocols/
+"""
+
+import sys as _sys
+from xml.sax import make_parser, handler
+
+from netaddr.core import Publisher, Subscriber
+from netaddr.ip import IPAddress, IPNetwork, IPRange, cidr_abbrev_to_verbose
+from netaddr.compat import _dict_items, _callable, _importlib_resources
+
+
+
+#: Topic based lookup dictionary for IANA information.
+IANA_INFO = {
+    'IPv4': {},
+    'IPv6': {},
+    'IPv6_unicast': {},
+    'multicast': {},
+}
+
+
+class SaxRecordParser(handler.ContentHandler):
+    def __init__(self, callback=None):
+        self._level = 0
+        self._is_active = False
+        self._record = None
+        self._tag_level = None
+        self._tag_payload = None
+        self._tag_feeding = None
+        self._callback = callback
+
+    def startElement(self, name, attrs):
+        self._level += 1
+
+        if self._is_active is False:
+            if name == 'record':
+                self._is_active = True
+                self._tag_level = self._level
+                self._record = {}
+                if 'date' in attrs:
+                    self._record['date'] = attrs['date']
+        elif self._level == self._tag_level + 1:
+            if name == 'xref':
+                if 'type' in attrs and 'data' in attrs:
+                    l = self._record.setdefault(attrs['type'], [])
+                    l.append(attrs['data'])
+            else:
+                self._tag_payload = []
+                self._tag_feeding = True
+        else:
+            self._tag_feeding = False
+
+    def endElement(self, name):
+        if self._is_active is True:
+            if name == 'record' and self._tag_level == self._level:
+                self._is_active = False
+                self._tag_level = None
+                if _callable(self._callback):
+                    self._callback(self._record)
+                self._record = None
+            elif self._level == self._tag_level + 1:
+                if name != 'xref':
+                    self._record[name] = ''.join(self._tag_payload)
+                    self._tag_payload = None
+                    self._tag_feeding = False
+
+        self._level -= 1
+
+    def characters(self, content):
+        if self._tag_feeding is True:
+            self._tag_payload.append(content)
+
+
+class XMLRecordParser(Publisher):
+    """
+    A configurable Parser that understands how to parse XML based records.
+    """
+
+    def __init__(self, fh, **kwargs):
+        """
+        Constructor.
+
+        fh - a valid, open file handle to XML based record data.
+        """
+        super(XMLRecordParser, self).__init__()
+
+        self.xmlparser = make_parser()
+        self.xmlparser.setContentHandler(SaxRecordParser(self.consume_record))
+
+        self.fh = fh
+
+        self.__dict__.update(kwargs)
+
+    def process_record(self, rec):
+        """
+        This is the callback method invoked for every record. It is usually
+        over-ridden by base classes to provide specific record-based logic.
+
+        Any record can be vetoed (not passed to registered Subscriber objects)
+        by simply returning None.
+        """
+        return rec
+
+    def consume_record(self, rec):
+        record = self.process_record(rec)
+        if record is not None:
+            self.notify(record)
+
+    def parse(self):
+        """
+        Parse and normalises records, notifying registered subscribers with
+        record data as it is encountered.
+        """
+        self.xmlparser.parse(self.fh)
+
+
+class IPv4Parser(XMLRecordParser):
+    """
+    A XMLRecordParser that understands how to parse and retrieve data records
+    from the IANA IPv4 address space file.
+
+    It can be found online here :-
+
+        - http://www.iana.org/assignments/ipv4-address-space/ipv4-address-space.xml
+    """
+
+    def __init__(self, fh, **kwargs):
+        """
+        Constructor.
+
+        fh - a valid, open file handle to an IANA IPv4 address space file.
+
+        kwargs - additional parser options.
+        """
+        super(IPv4Parser, self).__init__(fh)
+
+    def process_record(self, rec):
+        """
+        Callback method invoked for every record.
+
+        See base class method for more details.
+        """
+
+        record = {}
+        for key in ('prefix', 'designation', 'date', 'whois', 'status'):
+            record[key] = str(rec.get(key, '')).strip()
+
+        #   Strip leading zeros from octet.
+        if '/' in record['prefix']:
+            (octet, prefix) = record['prefix'].split('/')
+            record['prefix'] = '%d/%d' % (int(octet), int(prefix))
+
+        record['status'] = record['status'].capitalize()
+
+        return record
+
+
+class IPv6Parser(XMLRecordParser):
+    """
+    A XMLRecordParser that understands how to parse and retrieve data records
+    from the IANA IPv6 address space file.
+
+    It can be found online here :-
+
+        - http://www.iana.org/assignments/ipv6-address-space/ipv6-address-space.xml
+    """
+
+    def __init__(self, fh, **kwargs):
+        """
+        Constructor.
+
+        fh - a valid, open file handle to an IANA IPv6 address space file.
+
+        kwargs - additional parser options.
+        """
+        super(IPv6Parser, self).__init__(fh)
+
+    def process_record(self, rec):
+        """
+        Callback method invoked for every record.
+
+        See base class method for more details.
+        """
+
+        record = {
+            'prefix': str(rec.get('prefix', '')).strip(),
+            'allocation': str(rec.get('description', '')).strip(),
+            # HACK: -1 instead of 0 is a hacky hack to get 4291 instead of 3513 from
+            #
+            #     <xref type="rfc" data="rfc3513"/> was later obsoleted by <xref type="rfc" data="rfc4291"/>
+            #
+            # I imagine there's no way to solve this in a general way, maybe we should start returning a list
+            # of RFC-s here?
+            'reference': str(rec.get('rfc', [''])[-1]).strip(),
+        }
+
+        return record
+
+
+class IPv6UnicastParser(XMLRecordParser):
+    """
+    A XMLRecordParser that understands how to parse and retrieve data records
+    from the IANA IPv6 unicast address assignments file.
+
+    It can be found online here :-
+
+        - http://www.iana.org/assignments/ipv6-unicast-address-assignments/ipv6-unicast-address-assignments.xml
+    """
+    def __init__(self, fh, **kwargs):
+        """
+        Constructor.
+
+        fh - a valid, open file handle to an IANA IPv6 address space file.
+
+        kwargs - additional parser options.
+        """
+        super(IPv6UnicastParser, self).__init__(fh)
+
+    def process_record(self, rec):
+        """
+        Callback method invoked for every record.
+
+        See base class method for more details.
+        """
+        record = {
+            'status': str(rec.get('status', '')).strip(),
+            'description': str(rec.get('description', '')).strip(),
+            'prefix': str(rec.get('prefix', '')).strip(),
+            'date': str(rec.get('date', '')).strip(),
+            'whois': str(rec.get('whois', '')).strip(),
+        }
+
+        return record
+
+
+class MulticastParser(XMLRecordParser):
+    """
+    A XMLRecordParser that knows how to process the IANA IPv4 multicast address
+    allocation file.
+
+    It can be found online here :-
+
+        - http://www.iana.org/assignments/multicast-addresses/multicast-addresses.xml
+    """
+
+    def __init__(self, fh, **kwargs):
+        """
+        Constructor.
+
+        fh - a valid, open file handle to an IANA IPv4 multicast address
+             allocation file.
+
+        kwargs - additional parser options.
+        """
+        super(MulticastParser, self).__init__(fh)
+
+    def normalise_addr(self, addr):
+        """
+        Removes variations from address entries found in this particular file.
+        """
+        if '-' in addr:
+            (a1, a2) = addr.split('-')
+            o1 = a1.strip().split('.')
+            o2 = a2.strip().split('.')
+            return '%s-%s' % ('.'.join([str(int(i)) for i in o1]),
+                              '.'.join([str(int(i)) for i in o2]))
+        else:
+            o1 = addr.strip().split('.')
+            return '.'.join([str(int(i)) for i in o1])
+
+    def process_record(self, rec):
+        """
+        Callback method invoked for every record.
+
+        See base class method for more details.
+        """
+
+        if 'addr' in rec:
+            record = {
+                'address': self.normalise_addr(str(rec['addr'])),
+                'descr': str(rec.get('description', '')),
+            }
+            return record
+
+
+class DictUpdater(Subscriber):
+    """
+    Concrete Subscriber that inserts records received from a Publisher into a
+    dictionary.
+    """
+
+    def __init__(self, dct, topic, unique_key):
+        """
+        Constructor.
+
+        dct - lookup dict or dict like object to insert records into.
+
+        topic - high-level category name of data to be processed.
+
+        unique_key - key name in data dict that uniquely identifies it.
+        """
+        self.dct = dct
+        self.topic = topic
+        self.unique_key = unique_key
+
+    def update(self, data):
+        """
+        Callback function used by Publisher to notify this Subscriber about
+        an update. Stores topic based information into dictionary passed to
+        constructor.
+        """
+        data_id = data[self.unique_key]
+
+        if self.topic == 'IPv4':
+            cidr = IPNetwork(cidr_abbrev_to_verbose(data_id))
+            self.dct[cidr] = data
+        elif self.topic == 'IPv6':
+            cidr = IPNetwork(cidr_abbrev_to_verbose(data_id))
+            self.dct[cidr] = data
+        elif self.topic == 'IPv6_unicast':
+            cidr = IPNetwork(data_id)
+            self.dct[cidr] = data
+        elif self.topic == 'multicast':
+            iprange = None
+            if '-' in data_id:
+                #   See if we can manage a single CIDR.
+                (first, last) = data_id.split('-')
+                iprange = IPRange(first, last)
+                cidrs = iprange.cidrs()
+                if len(cidrs) == 1:
+                    iprange = cidrs[0]
+            else:
+                iprange = IPAddress(data_id)
+            self.dct[iprange] = data
+
+
+def load_info():
+    """
+    Parse and load internal IANA data lookups with the latest information from
+    data files.
+    """
+    ipv4 = IPv4Parser(_importlib_resources.open_binary(__package__, 'ipv4-address-space.xml'))
+    ipv4.attach(DictUpdater(IANA_INFO['IPv4'], 'IPv4', 'prefix'))
+    ipv4.parse()
+
+    ipv6 = IPv6Parser(_importlib_resources.open_binary(__package__, 'ipv6-address-space.xml'))
+    ipv6.attach(DictUpdater(IANA_INFO['IPv6'], 'IPv6', 'prefix'))
+    ipv6.parse()
+
+    ipv6ua = IPv6UnicastParser(
+        _importlib_resources.open_binary(__package__, 'ipv6-unicast-address-assignments.xml'),
+    )
+    ipv6ua.attach(DictUpdater(IANA_INFO['IPv6_unicast'], 'IPv6_unicast', 'prefix'))
+    ipv6ua.parse()
+
+    mcast = MulticastParser(_importlib_resources.open_binary(__package__, 'multicast-addresses.xml'))
+    mcast.attach(DictUpdater(IANA_INFO['multicast'], 'multicast', 'address'))
+    mcast.parse()
+
+
+def pprint_info(fh=None):
+    """
+    Pretty prints IANA information to filehandle.
+    """
+    if fh is None:
+        fh = _sys.stdout
+
+    for category in sorted(IANA_INFO):
+        fh.write('-' * len(category) + "\n")
+        fh.write(category + "\n")
+        fh.write('-' * len(category) + "\n")
+        ipranges = IANA_INFO[category]
+        for iprange in sorted(ipranges):
+            details = ipranges[iprange]
+            fh.write('%-45r' % (iprange) + details + "\n")
+
+
+def _within_bounds(ip, ip_range):
+    #   Boundary checking for multiple IP classes.
+    if hasattr(ip_range, 'first'):
+        #   IP network or IP range.
+        return ip in ip_range
+    elif hasattr(ip_range, 'value'):
+        #   IP address.
+        return ip == ip_range
+
+    raise Exception('Unsupported IP range or address: %r!' % (ip_range,))
+
+
+def query(ip_addr):
+    """Returns informational data specific to this IP address."""
+    info = {}
+
+    if ip_addr.version == 4:
+        for cidr, record in _dict_items(IANA_INFO['IPv4']):
+            if _within_bounds(ip_addr, cidr):
+                info.setdefault('IPv4', [])
+                info['IPv4'].append(record)
+
+        if ip_addr.is_multicast():
+            for iprange, record in _dict_items(IANA_INFO['multicast']):
+                if _within_bounds(ip_addr, iprange):
+                    info.setdefault('Multicast', [])
+                    info['Multicast'].append(record)
+
+    elif ip_addr.version == 6:
+        for cidr, record in _dict_items(IANA_INFO['IPv6']):
+            if _within_bounds(ip_addr, cidr):
+                info.setdefault('IPv6', [])
+                info['IPv6'].append(record)
+
+        for cidr, record in _dict_items(IANA_INFO['IPv6_unicast']):
+            if _within_bounds(ip_addr, cidr):
+                info.setdefault('IPv6_unicast', [])
+                info['IPv6_unicast'].append(record)
+
+    return info
+
+#   On module import, read IANA data files and populate lookups dict.
+load_info()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv4-address-space.xml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv4-address-space.xml
new file mode 100644
index 0000000000000000000000000000000000000000..3135826eace47f231fe889c734066a2725777aa7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv4-address-space.xml
@@ -0,0 +1,2644 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<?xml-stylesheet type="text/xsl" href="ipv4-address-space.xsl"?>
+<?oxygen RNGSchema="ipv4-address-space.rng" type="xml"?>
+<registry xmlns="http://www.iana.org/assignments" id="ipv4-address-space">
+  <title>IANA IPv4 Address Space Registry</title>
+  <category>Internet Protocol version 4 (IPv4) Address Space</category>
+  <updated>2019-12-27</updated>
+  <xref type="rfc" data="rfc7249"/>
+  <registration_rule>Allocations to RIRs are made in line with the Global Policy published at <xref type="uri" data="http://www.icann.org/en/resources/policy/global-addressing"/>. 
+All other assignments require IETF Review.</registration_rule>
+  <description>The allocation of Internet Protocol version 4 (IPv4) address space to various registries is listed
+here. Originally, all the IPv4 address spaces was managed directly by the IANA. Later parts of the
+address space were allocated to various other registries to manage for particular purposes or
+regional areas of the world. RFC 1466 <xref type="rfc" data="rfc1466"/> documents most of these allocations.</description>
+  <record>
+    <prefix>000/8</prefix>
+    <designation>IANA - Local Identification</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="2"/>
+  </record>
+  <record>
+    <prefix>001/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>002/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2009-09</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>003/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>004/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1992-12</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>005/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2010-11</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>006/8</prefix>
+    <designation>Army Information Systems Center</designation>
+    <date>1994-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>007/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1995-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>008/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1992-12</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>009/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1992-08</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>010/8</prefix>
+    <designation>IANA - Private Use</designation>
+    <date>1995-06</date>
+    <status>RESERVED</status>
+    <xref type="note" data="3"/>
+  </record>
+  <record>
+    <prefix>011/8</prefix>
+    <designation>DoD Intel Information Systems</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>012/8</prefix>
+    <designation>AT&amp;T Bell Laboratories</designation>
+    <date>1995-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>013/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1991-09</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>014/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-04</date>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <xref type="note" data="4"/>
+  </record>
+  <record>
+    <prefix>015/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>016/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-11</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>017/8</prefix>
+    <designation>Apple Computer Inc.</designation>
+    <date>1992-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>018/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-01</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>019/8</prefix>
+    <designation>Ford Motor Company</designation>
+    <date>1995-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>020/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-10</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>021/8</prefix>
+    <designation>DDN-RVN</designation>
+    <date>1991-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>022/8</prefix>
+    <designation>Defense Information Systems Agency</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>023/8</prefix>
+    <designation>ARIN</designation>
+    <date>2010-11</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>024/8</prefix>
+    <designation>ARIN</designation>
+    <date>2001-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record updated="2018-09-18">
+    <prefix>025/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1995-01</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>026/8</prefix>
+    <designation>Defense Information Systems Agency</designation>
+    <date>1995-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>027/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>028/8</prefix>
+    <designation>DSI-North</designation>
+    <date>1992-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>029/8</prefix>
+    <designation>Defense Information Systems Agency</designation>
+    <date>1991-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>030/8</prefix>
+    <designation>Defense Information Systems Agency</designation>
+    <date>1991-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>031/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2010-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record updated="2015-05-01">
+    <prefix>032/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>033/8</prefix>
+    <designation>DLA Systems Automation Center</designation>
+    <date>1991-01</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>034/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>035/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>036/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-10</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>037/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2010-11</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>038/8</prefix>
+    <designation>PSINet, Inc.</designation>
+    <date>1994-09</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>039/8</prefix>
+    <designation>APNIC</designation>
+    <date>2011-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>040/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1994-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>041/8</prefix>
+    <designation>AFRINIC</designation>
+    <date>2005-04</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>042/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-10</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>043/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1991-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>044/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1992-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>045/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1995-01</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>046/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2009-09</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>047/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1991-01</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>048/8</prefix>
+    <designation>Prudential Securities Inc.</designation>
+    <date>1995-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>049/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-08</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>050/8</prefix>
+    <designation>ARIN</designation>
+    <date>2010-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record updated="2015-05-11">
+    <prefix>051/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1994-08</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record updated="2015-05-01">
+    <prefix>052/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1991-12</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record updated="2014-10-14">
+    <prefix>053/8</prefix>
+    <designation>Daimler AG</designation>
+    <date>1993-10</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>054/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1992-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>055/8</prefix>
+    <designation>DoD Network Information Center</designation>
+    <date>1995-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>056/8</prefix>
+    <designation>US Postal Service</designation>
+    <date>1994-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record updated="2019-12-27">
+    <prefix>057/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1995-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>058/8</prefix>
+    <designation>APNIC</designation>
+    <date>2004-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>059/8</prefix>
+    <designation>APNIC</designation>
+    <date>2004-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>060/8</prefix>
+    <designation>APNIC</designation>
+    <date>2003-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>061/8</prefix>
+    <designation>APNIC</designation>
+    <date>1997-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>062/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1997-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>063/8</prefix>
+    <designation>ARIN</designation>
+    <date>1997-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>064/8</prefix>
+    <designation>ARIN</designation>
+    <date>1999-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>065/8</prefix>
+    <designation>ARIN</designation>
+    <date>2000-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>066/8</prefix>
+    <designation>ARIN</designation>
+    <date>2000-07</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>067/8</prefix>
+    <designation>ARIN</designation>
+    <date>2001-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>068/8</prefix>
+    <designation>ARIN</designation>
+    <date>2001-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>069/8</prefix>
+    <designation>ARIN</designation>
+    <date>2002-08</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>070/8</prefix>
+    <designation>ARIN</designation>
+    <date>2004-01</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>071/8</prefix>
+    <designation>ARIN</designation>
+    <date>2004-08</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>072/8</prefix>
+    <designation>ARIN</designation>
+    <date>2004-08</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>073/8</prefix>
+    <designation>ARIN</designation>
+    <date>2005-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>074/8</prefix>
+    <designation>ARIN</designation>
+    <date>2005-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>075/8</prefix>
+    <designation>ARIN</designation>
+    <date>2005-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>076/8</prefix>
+    <designation>ARIN</designation>
+    <date>2005-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>077/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2006-08</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>078/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2006-08</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>079/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2006-08</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>080/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2001-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>081/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2001-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>082/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2002-11</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>083/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2003-11</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>084/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2003-11</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>085/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2004-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>086/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2004-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>087/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2004-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>088/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2004-04</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>089/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2005-06</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>090/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2005-06</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>091/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2005-06</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>092/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2007-03</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>093/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2007-03</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>094/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2007-07</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>095/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2007-07</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>096/8</prefix>
+    <designation>ARIN</designation>
+    <date>2006-10</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>097/8</prefix>
+    <designation>ARIN</designation>
+    <date>2006-10</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>098/8</prefix>
+    <designation>ARIN</designation>
+    <date>2006-10</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>099/8</prefix>
+    <designation>ARIN</designation>
+    <date>2006-10</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>100/8</prefix>
+    <designation>ARIN</designation>
+    <date>2010-11</date>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <xref type="note" data="5"/>
+  </record>
+  <record>
+    <prefix>101/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-08</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>102/8</prefix>
+    <designation>AFRINIC</designation>
+    <date>2011-02</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>103/8</prefix>
+    <designation>APNIC</designation>
+    <date>2011-02</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>104/8</prefix>
+    <designation>ARIN</designation>
+    <date>2011-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>105/8</prefix>
+    <designation>AFRINIC</designation>
+    <date>2010-11</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>106/8</prefix>
+    <designation>APNIC</designation>
+    <date>2011-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>107/8</prefix>
+    <designation>ARIN</designation>
+    <date>2010-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>108/8</prefix>
+    <designation>ARIN</designation>
+    <date>2008-12</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>109/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2009-01</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>110/8</prefix>
+    <designation>APNIC</designation>
+    <date>2008-11</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>111/8</prefix>
+    <designation>APNIC</designation>
+    <date>2008-11</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>112/8</prefix>
+    <designation>APNIC</designation>
+    <date>2008-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>113/8</prefix>
+    <designation>APNIC</designation>
+    <date>2008-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>114/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-10</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>115/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-10</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>116/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>117/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>118/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>119/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>120/8</prefix>
+    <designation>APNIC</designation>
+    <date>2007-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>121/8</prefix>
+    <designation>APNIC</designation>
+    <date>2006-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>122/8</prefix>
+    <designation>APNIC</designation>
+    <date>2006-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>123/8</prefix>
+    <designation>APNIC</designation>
+    <date>2006-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>124/8</prefix>
+    <designation>APNIC</designation>
+    <date>2005-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>125/8</prefix>
+    <designation>APNIC</designation>
+    <date>2005-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>126/8</prefix>
+    <designation>APNIC</designation>
+    <date>2005-01</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>127/8</prefix>
+    <designation>IANA - Loopback</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="6"/>
+  </record>
+  <record>
+    <prefix>128/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>129/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>130/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>131/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>132/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>133/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1997-03</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>134/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>135/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>136/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>137/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>138/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>139/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>140/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>141/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>142/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>143/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>144/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>145/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>146/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>147/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>148/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>149/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>150/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>151/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>152/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>153/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>154/8</prefix>
+    <designation>Administered by AFRINIC</designation>
+    <date>1993-05</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>155/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>156/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>157/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>158/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>159/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>160/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>161/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>162/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>163/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>164/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>165/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>166/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>167/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>168/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>169/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <status>LEGACY</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <xref type="note" data="7"/>
+  </record>
+  <record>
+    <prefix>170/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>171/8</prefix>
+    <designation>Administered by APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>172/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <status>LEGACY</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <xref type="note" data="8"/>
+  </record>
+  <record>
+    <prefix>173/8</prefix>
+    <designation>ARIN</designation>
+    <date>2008-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>174/8</prefix>
+    <designation>ARIN</designation>
+    <date>2008-02</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>175/8</prefix>
+    <designation>APNIC</designation>
+    <date>2009-08</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>176/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2010-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>177/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2010-06</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>178/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2009-01</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>179/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2011-02</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>180/8</prefix>
+    <designation>APNIC</designation>
+    <date>2009-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>181/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2010-06</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>182/8</prefix>
+    <designation>APNIC</designation>
+    <date>2009-08</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>183/8</prefix>
+    <designation>APNIC</designation>
+    <date>2009-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>184/8</prefix>
+    <designation>ARIN</designation>
+    <date>2008-12</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>185/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2011-02</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>186/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2007-09</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>187/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2007-09</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>188/8</prefix>
+    <designation>Administered by RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>189/8</prefix>
+    <designation>LACNIC</designation>
+    <date>1995-06</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>190/8</prefix>
+    <designation>LACNIC</designation>
+    <date>1995-06</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>191/8</prefix>
+    <designation>Administered by LACNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>192/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <status>LEGACY</status>
+    <xref type="note" data="9"/>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <xref type="note" data="10"/>
+  </record>
+  <record>
+    <prefix>193/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>194/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>195/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1993-05</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>196/8</prefix>
+    <designation>Administered by AFRINIC</designation>
+    <date>1993-05</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>197/8</prefix>
+    <designation>AFRINIC</designation>
+    <date>2008-10</date>
+    <whois>whois.afrinic.net</whois>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>198/8</prefix>
+    <designation>Administered by ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <status>LEGACY</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <xref type="note" data="11"/>
+  </record>
+  <record>
+    <prefix>199/8</prefix>
+    <designation>ARIN</designation>
+    <date>1993-05</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>200/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2002-11</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>201/8</prefix>
+    <designation>LACNIC</designation>
+    <date>2003-04</date>
+    <whois>whois.lacnic.net</whois>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>202/8</prefix>
+    <designation>APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>203/8</prefix>
+    <designation>APNIC</designation>
+    <date>1993-05</date>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <xref type="note" data="12"/>
+  </record>
+  <record>
+    <prefix>204/8</prefix>
+    <designation>ARIN</designation>
+    <date>1994-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>205/8</prefix>
+    <designation>ARIN</designation>
+    <date>1994-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>206/8</prefix>
+    <designation>ARIN</designation>
+    <date>1995-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>207/8</prefix>
+    <designation>ARIN</designation>
+    <date>1995-11</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>208/8</prefix>
+    <designation>ARIN</designation>
+    <date>1996-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>209/8</prefix>
+    <designation>ARIN</designation>
+    <date>1996-06</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>210/8</prefix>
+    <designation>APNIC</designation>
+    <date>1996-06</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>211/8</prefix>
+    <designation>APNIC</designation>
+    <date>1996-06</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>212/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1997-10</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>213/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>1993-10</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>214/8</prefix>
+    <designation>US-DOD</designation>
+    <date>1998-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>215/8</prefix>
+    <designation>US-DOD</designation>
+    <date>1998-03</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>LEGACY</status>
+  </record>
+  <record>
+    <prefix>216/8</prefix>
+    <designation>ARIN</designation>
+    <date>1998-04</date>
+    <whois>whois.arin.net</whois>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>217/8</prefix>
+    <designation>RIPE NCC</designation>
+    <date>2000-06</date>
+    <whois>whois.ripe.net</whois>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>218/8</prefix>
+    <designation>APNIC</designation>
+    <date>2000-12</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>219/8</prefix>
+    <designation>APNIC</designation>
+    <date>2001-09</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>220/8</prefix>
+    <designation>APNIC</designation>
+    <date>2001-12</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>221/8</prefix>
+    <designation>APNIC</designation>
+    <date>2002-07</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>222/8</prefix>
+    <designation>APNIC</designation>
+    <date>2003-02</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>223/8</prefix>
+    <designation>APNIC</designation>
+    <date>2010-04</date>
+    <whois>whois.apnic.net</whois>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <status>ALLOCATED</status>
+  </record>
+  <record>
+    <prefix>224/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>225/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>226/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>227/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>228/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>229/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>230/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>231/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>232/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>233/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>234/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+    <xref type="note" data="14"/>
+  </record>
+  <record>
+    <prefix>235/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>236/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>237/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>238/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+  </record>
+  <record>
+    <prefix>239/8</prefix>
+    <designation>Multicast</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="13"/>
+    <xref type="note" data="15"/>
+  </record>
+  <record>
+    <prefix>240/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>241/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>242/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>243/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>244/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>245/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>246/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>247/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>248/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>249/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>250/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>251/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>252/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>253/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>254/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+  </record>
+  <record>
+    <prefix>255/8</prefix>
+    <designation>Future use</designation>
+    <date>1981-09</date>
+    <status>RESERVED</status>
+    <xref type="note" data="16"/>
+    <xref type="note" data="17"/>
+  </record>
+  <footnote anchor="1">Indicates the status of address blocks as follows:
+RESERVED: designated by the IETF for specific non-global-unicast purposes as noted.
+LEGACY: allocated by the central Internet Registry (IR) prior to the Regional Internet Registries
+(RIRs). This address space is now administered by individual RIRs as noted, including maintenance
+of WHOIS Directory and reverse DNS records. Assignments from these blocks are distributed globally
+on a regional basis.
+ALLOCATED: delegated entirely to specific RIR as indicated.
+UNALLOCATED: not yet allocated or reserved.</footnote>
+  <footnote anchor="2">0.0.0.0/8 reserved for self-identification <xref type="rfc" data="rfc1122"/>, section 3.2.1.3. 
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="3">Reserved for Private-Use Networks <xref type="rfc" data="rfc1918"/>.
+Complete registration details for 10.0.0.0/8 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="4">This was reserved for Public Data Networks <xref type="rfc" data="rfc1356"/>. See <xref type="registry" data="public-data-network-numbers"/>.
+It was recovered in February 2008 and was subsequently allocated to APNIC in April 2010.</footnote>
+  <footnote anchor="5">100.64.0.0/10 reserved for Shared Address Space <xref type="rfc" data="rfc6598"/>. 
+Complete registration details for 100.64.0.0/10 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="6">127.0.0.0/8 reserved for Loopback <xref type="rfc" data="rfc1122"/>, section 3.2.1.3. 
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="7">169.254.0.0/16 reserved for Link Local <xref type="rfc" data="rfc3927"/>.
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="8">172.16.0.0/12 reserved for Private-Use Networks <xref type="rfc" data="rfc1918"/>. 
+Complete registration details are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="9">192.0.2.0/24  reserved for TEST-NET-1 <xref type="rfc" data="rfc5737"/>. 
+Complete registration details for 192.0.2.0/24 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.
+192.88.99.0/24 reserved for 6to4 Relay Anycast <xref type="rfc" data="rfc7526"/>
+Complete registration details for 192.88.99.0/24 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.
+192.88.99.2/32 reserved for 6a44 Relay Anycast <xref type="rfc" data="rfc6751"/> (possibly collocated with 6to4 Relay 
+at 192.88.99.1/32 - see <xref type="rfc" data="rfc7526"/>)
+192.168.0.0/16 reserved for Private-Use Networks <xref type="rfc" data="rfc1918"/>. 
+Complete registration details for 192.168.0.0/16 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="10">192.0.0.0/24 reserved for IANA IPv4 Special Purpose Address Registry <xref type="rfc" data="rfc5736"/>. 
+Complete registration details for 192.0.0.0/24 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="11">198.18.0.0/15 reserved for Network Interconnect Device Benchmark Testing <xref type="rfc" data="rfc2544"/>. 
+Complete registration details for 198.18.0.0/15 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.
+198.51.100.0/24 reserved for TEST-NET-2 <xref type="rfc" data="rfc5737"/>. 
+Complete registration details for 198.51.100.0/24 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="12">203.0.113.0/24 reserved for TEST-NET-3 <xref type="rfc" data="rfc5737"/>. 
+Complete registration details for 203.0.113.0/24 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="13">Multicast (formerly "Class D") <xref type="rfc" data="rfc5771"/> registered in <xref type="registry" data="multicast-addresses"/></footnote>
+  <footnote anchor="14">Unicast-Prefix-Based IPv4 Multicast Addresses <xref type="rfc" data="rfc6034"/></footnote>
+  <footnote anchor="15">Administratively Scoped IP Multicast <xref type="rfc" data="rfc2365"/></footnote>
+  <footnote anchor="16">Reserved for future use (formerly "Class E") <xref type="rfc" data="rfc1112"/>.
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <footnote anchor="17">255.255.255.255 is reserved for "limited broadcast" destination address <xref type="rfc" data="rfc919"/> and <xref type="rfc" data="rfc922"/>.
+Complete registration details for 255.255.255.255/32 are found in <xref type="registry" data="iana-ipv4-special-registry"/>.</footnote>
+  <people/>
+</registry>
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-address-space.xml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-address-space.xml
new file mode 100644
index 0000000000000000000000000000000000000000..51ffefc1251f7a5a18a6fb3758bda348157665d9
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-address-space.xml
@@ -0,0 +1,198 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<?xml-stylesheet type="text/xsl" href="ipv6-address-space.xsl"?>
+<?oxygen RNGSchema="ipv6-address-space.rng" type="xml"?>
+<registry xmlns="http://www.iana.org/assignments" id="ipv6-address-space">
+  <title>Internet Protocol Version 6 Address Space</title>
+  <updated>2019-09-13</updated>
+  <note>The IPv6 address management function was formally delegated to
+IANA in December 1995 <xref type="rfc" data="rfc1881"/>. The registration procedure
+was confirmed with the IETF Chair in March 2010.
+
+As stated in RFC3513, IANA should limit its allocation of IPv6-unicast 
+address space to the range of addresses that start with binary value 001.
+The rest of the global unicast address space (approximately 85% of the IPv6
+address space) is reserved for future definition and use, and is not to be
+assigned by IANA at this time.
+        
+While <xref type="rfc" data="rfc3513"/> was obsoleted by <xref type="rfc" data="rfc4291"/>,
+the guidiance provided to IANA did not change regarding the allocation of IPv6 
+unicast addresses.
+        
+  </note>
+<registry id="ipv6-address-space-1">
+  <registration_rule>IESG Approval</registration_rule>
+  <record>
+    <prefix>0000::/8</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes>
+    <xref type="note" data="1"/>
+    <xref type="note" data="2"/>
+    <xref type="note" data="3"/>
+    <xref type="note" data="4"/>
+    <xref type="note" data="5"/>
+    <xref type="note" data="6"/>
+    </notes>
+  </record>
+  <record>
+    <prefix>0100::/8</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes>0100::/64 reserved for Discard-Only Address Block <xref type="rfc" data="rfc6666"/>. 
+Complete registration details are found in <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record>
+    <prefix>0200::/7</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc4048"/>
+    <notes>Deprecated as of December 2004 <xref type="rfc" data="rfc4048"/>. 
+Formerly an OSI NSAP-mapped prefix set <xref type="rfc" data="rfc4548"/>.</notes>
+  </record>
+  <record>
+    <prefix>0400::/6</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>0800::/5</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>1000::/4</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>2000::/3</prefix>
+    <description>Global Unicast</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes>The IPv6 Unicast space encompasses the entire IPv6 address range 
+with the exception of ff00::/8, per <xref type="rfc" data="rfc4291"/>. IANA unicast address 
+assignments are currently limited to the IPv6 unicast address 
+range of 2000::/3. IANA assignments from this block are registered 
+in <xref type="registry" data="ipv6-unicast-address-assignments"/>.
+      <xref type="note" data="7"/>    
+      <xref type="note" data="8"/>    
+      <xref type="note" data="9"/>      
+      <xref type="note" data="10"/>      
+      <xref type="note" data="11"/>      
+      <xref type="note" data="12"/>
+      <xref type="note" data="13"/>
+      <xref type="note" data="14"/>
+      <xref type="note" data="15"/>
+    </notes>
+  </record>
+  <record>
+    <prefix>4000::/3</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>6000::/3</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>8000::/3</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>a000::/3</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>c000::/3</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>e000::/4</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>f000::/5</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>f800::/6</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>fc00::/7</prefix>
+    <description>Unique Local Unicast</description>
+    <xref type="rfc" data="rfc4193"/>
+    <notes>For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record>
+    <prefix>fe00::/9</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes/>
+  </record>
+  <record>
+    <prefix>fe80::/10</prefix>
+    <description>Link-Scoped Unicast</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes>Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record>
+    <prefix>fec0::/10</prefix>
+    <description>Reserved by IETF</description>
+    <xref type="rfc" data="rfc3879"/>
+    <notes>Deprecated by <xref type="rfc" data="rfc3879"/> in September 2004. Formerly a Site-Local scoped address prefix.</notes>
+  </record>
+  <record>
+    <prefix>ff00::/8</prefix>
+    <description>Multicast</description>
+    <xref type="rfc" data="rfc3513"/><xref type="rfc" data="rfc4291"/>
+    <notes>IANA assignments from this block are registered in <xref type="registry" data="ipv6-multicast-addresses"/>.</notes>
+  </record>
+  <footnote anchor="1">::1/128 reserved for Loopback Address <xref type="rfc" data="rfc4291"/>. 
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+  <footnote anchor="2">::/128 reserved for Unspecified Address <xref type="rfc" data="rfc4291"/>. 
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+  <footnote anchor="3">::ffff:0:0/96 reserved for IPv4-mapped Address <xref type="rfc" data="rfc4291"/>. 
+Reserved by protocol. For authoritative registration, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+  <footnote anchor="4">0::/96 deprecated by <xref type="rfc" data="rfc4291"/>. Formerly defined as the "IPv4-compatible IPv6 address" prefix.</footnote>
+  <footnote anchor="5">The "Well Known Prefix" 64:ff9b::/96 is used in an algorithmic mapping between IPv4 to IPv6 addresses <xref type="rfc" data="rfc6052"/>.</footnote>  
+  <footnote anchor="6">64:ff9b:1::/48 reserved for Local-Use IPv4/IPv6 Translation <xref type="rfc" data="rfc8215"/>.</footnote>
+  <footnote anchor="7">2001:0::/23 reserved for IETF Protocol Assignments <xref type="rfc" data="rfc2928"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>  
+  <footnote anchor="8">2001:0::/32 reserved for TEREDO <xref type="rfc" data="rfc4380"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>  
+  <footnote anchor="9">2001:2::/48 reserved for Benchmarking <xref type="rfc" data="rfc5180"/><xref type="rfc-errata" data="1752"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>  
+  <footnote anchor="10">2001:3::/32 reserved for AMT <xref type="rfc" data="rfc7450"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>  
+  <footnote anchor="11">2001:4:112::/48 reserved for AS112-v6 <xref type="rfc" data="rfc7535"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>     
+  <footnote anchor="12">2001:10::/28 deprecated (formerly ORCHID) <xref type="rfc" data="rfc4843"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>  
+  <footnote anchor="13">2001:20::/28 reserved for ORCHIDv2 <xref type="rfc" data="rfc7343"/>.
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+  <footnote anchor="14">2001:db8::/32 reserved for Documentation <xref type="rfc" data="rfc3849"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+  <footnote anchor="15">2002::/16 reserved for 6to4 <xref type="rfc" data="rfc3056"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</footnote>
+
+
+  <people/>
+</registry>
+ </registry>
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-unicast-address-assignments.xml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-unicast-address-assignments.xml
new file mode 100644
index 0000000000000000000000000000000000000000..6971311b2aa8f6ed852f1b9eed4ba0e8b55b1423
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/ipv6-unicast-address-assignments.xml
@@ -0,0 +1,435 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<?xml-stylesheet type="text/xsl" href="ipv6-unicast-address-assignments.xsl"?>
+<?oxygen RNGSchema="ipv6-unicast-address-assignments.rng" type="xml"?>
+<registry xmlns="http://www.iana.org/assignments" id="ipv6-unicast-address-assignments">
+  <title>IPv6 Global Unicast Address Assignments</title>
+  <category>Internet Protocol version 6 (IPv6) Global Unicast Allocations</category>
+  <updated>2019-11-06</updated>
+  <xref type="rfc" data="rfc7249"/>
+  <registration_rule>Allocations to RIRs are made in line with the Global Policy published at 
+<xref type="uri" data="http://www.icann.org/en/resources/policy/global-addressing"/>. 
+All other assignments require IETF Review.</registration_rule>
+  <description>The allocation of Internet Protocol version 6 (IPv6) unicast address space is listed
+here. References to the various other registries detailing the use of the IPv6 address
+space can be found in the <xref type="registry" data="ipv6-address-space">IPv6 Address Space registry</xref>.</description>
+  <note>The assignable Global Unicast Address space is defined in <xref type="rfc" data="rfc3513"/> as the address block 
+defined by the prefix 2000::/3. <xref type="rfc" data="rfc3513"/> was later obsoleted by <xref type="rfc" data="rfc4291"/>. All address 
+space in this block not listed in the table below is reserved by IANA for future 
+allocation.
+  </note>
+  <record date="1999-07-01">
+    <prefix>2001:0000::/23</prefix>
+    <description>IANA</description>
+    <whois>whois.iana.org</whois>
+    <status>ALLOCATED</status>
+    <notes>2001:0000::/23 is reserved for IETF Protocol Assignments <xref type="rfc" data="rfc2928"/>.
+2001:0000::/32 is reserved for TEREDO <xref type="rfc" data="rfc4380"/>.
+2001:1::1/128 is reserved for Port Control Protocol Anycast <xref type="rfc" data="rfc7723"/>.
+2001:2::/48 is reserved for Benchmarking <xref type="rfc" data="rfc5180"/><xref type="rfc-errata" data="1752"/>.
+2001:3::/32 is reserved for AMT <xref type="rfc" data="rfc7450"/>.
+2001:4:112::/48 is reserved for AS112-v6 <xref type="rfc" data="rfc7535"/>.
+2001:10::/28 is deprecated (previously ORCHID) <xref type="rfc" data="rfc4843"/>. 
+2001:20::/28 is reserved for ORCHIDv2 <xref type="rfc" data="rfc7343"/>.
+2001:db8::/32 is reserved for Documentation <xref type="rfc" data="rfc3849"/>.
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record date="1999-07-01">
+    <prefix>2001:0200::/23</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="1999-07-01">
+    <prefix>2001:0400::/23</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="1999-07-01">
+    <prefix>2001:0600::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  
+  <record date="2002-11-02">
+    <prefix>2001:0800::/22</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes>2001:0800::/23 was allocated on 2002-05-02. The more recent 
+      allocation (2002-11-02) incorporates the previous allocation.</notes>
+  </record>
+  <record date="2002-05-02">
+    <prefix>2001:0c00::/23</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes>2001:db8::/32 reserved for Documentation <xref type="rfc" data="rfc3849"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record date="2003-01-01">
+    <prefix>2001:0e00::/23</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2002-11-01">
+    <prefix>2001:1200::/23</prefix>
+    <description>LACNIC</description>
+    <whois>whois.lacnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <notes/>
+  </record>
+  
+  <record date="2003-07-01">
+    <prefix>2001:1400::/22</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes>2001:1400::/23 was allocated on 2003-02-01. The more recent 
+      allocation (2003-07-01) incorporates the previous allocation.</notes>
+  </record>
+  <record date="2003-04-01">
+    <prefix>2001:1800::/23</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-01-01">
+    <prefix>2001:1a00::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-05-04">
+    <prefix>2001:1c00::/22</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  
+  <record date="2019-03-12">
+    <prefix>2001:2000::/19</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes>2001:2000::/20, 2001:3000::/21, and 2001:3800::/22 
+      were allocated on 2004-05-04. The more recent allocation 
+      (2019-03-12) incorporates all these previous allocations.</notes>
+  </record>
+  <record date="2004-06-11">
+    <prefix>2001:4000::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-06-01">
+    <prefix>2001:4200::/23</prefix>
+    <description>AFRINIC</description>
+    <whois>whois.afrinic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-06-11">
+    <prefix>2001:4400::/23</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-08-17">
+    <prefix>2001:4600::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-08-24">
+    <prefix>2001:4800::/23</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-10-15">
+    <prefix>2001:4a00::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-12-17">
+    <prefix>2001:4c00::/23</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-09-10">
+    <prefix>2001:5000::/20</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-11-30">
+    <prefix>2001:8000::/19</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2004-11-30">
+    <prefix>2001:a000::/20</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2006-03-08">
+    <prefix>2001:b000::/20</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2001-02-01">
+    <prefix>2002:0000::/16</prefix>
+    <description>6to4</description>
+    <whois/>
+    <status>ALLOCATED</status>
+    <notes>2002::/16 is reserved for 6to4 <xref type="rfc" data="rfc3056"/>. 
+For complete registration details, see <xref type="registry" data="iana-ipv6-special-registry"/>.</notes>
+  </record>
+  <record date="2005-01-12">
+    <prefix>2003:0000::/18</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2006-10-03">
+    <prefix>2400:0000::/12</prefix>
+    <description>APNIC</description>
+    <whois>whois.apnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.apnic.net/</server>
+    </rdap>
+    <notes>2400:0000::/19 was allocated on 2005-05-20. 2400:2000::/19 was allocated on 2005-07-08. 2400:4000::/21 was 
+allocated on 2005-08-08.  2404:0000::/23 was allocated on 2006-01-19. The more recent allocation (2006-10-03) 
+incorporates all these previous allocations.</notes>
+  </record>
+  <record date="2006-10-03">
+    <prefix>2600:0000::/12</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes>2600:0000::/22, 2604:0000::/22, 2608:0000::/22 and 260c:0000::/22 were allocated on 2005-04-19. The more 
+recent allocation (2006-10-03) incorporates all these previous allocations.</notes>
+  </record>
+  <record date="2005-11-17">
+    <prefix>2610:0000::/23</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2006-09-12">
+    <prefix>2620:0000::/23</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2019-11-06">
+    <prefix>2630:0000::/12</prefix>
+    <description>ARIN</description>
+    <whois>whois.arin.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.arin.net/registry</server>
+      <server>http://rdap.arin.net/registry</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2006-10-03">
+    <prefix>2800:0000::/12</prefix>
+    <description>LACNIC</description>
+    <whois>whois.lacnic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.lacnic.net/rdap/</server>
+    </rdap>
+    <notes>2800:0000::/23 was allocated on 2005-11-17. The more recent allocation (2006-10-03) incorporates the 
+previous allocation.</notes>
+  </record>
+  <record date="2006-10-03">
+    <prefix>2a00:0000::/12</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes>2a00:0000::/21 was originally allocated on 2005-04-19. 2a01:0000::/23 was allocated on 2005-07-14. 
+2a01:0000::/16 (incorporating the 2a01:0000::/23) was allocated on 2005-12-15. The more recent allocation 
+(2006-10-03) incorporates these previous allocations.</notes>
+  </record>
+  <record date="2019-06-05">
+    <prefix>2a10:0000::/12</prefix>
+    <description>RIPE NCC</description>
+    <whois>whois.ripe.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.db.ripe.net/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="2006-10-03">
+    <prefix>2c00:0000::/12</prefix>
+    <description>AFRINIC</description>
+    <whois>whois.afrinic.net</whois>
+    <status>ALLOCATED</status>
+    <rdap>
+      <server>https://rdap.afrinic.net/rdap/</server>
+      <server>http://rdap.afrinic.net/rdap/</server>
+    </rdap>
+    <notes/>
+  </record>
+  <record date="1999-07-01">
+    <prefix>2d00:0000::/8</prefix>
+    <description>IANA</description>
+    <whois/>
+    <status>RESERVED</status>
+    <notes/>
+  </record>
+  <record date="1999-07-01">
+    <prefix>2e00:0000::/7</prefix>
+    <description>IANA</description>
+    <whois/>
+    <status>RESERVED</status>
+    <notes/>
+  </record>
+  <record date="1999-07-01">
+    <prefix>3000:0000::/4</prefix>
+    <description>IANA</description>
+    <whois/>
+    <status>RESERVED</status>
+    <notes/>
+  </record>
+  <record date="2008-04">
+    <prefix>3ffe::/16</prefix>
+    <description>IANA</description>
+    <whois/>
+    <status>RESERVED</status>
+    <notes>3ffe:831f::/32 was used for Teredo in some old but widely distributed networking stacks. This usage is 
+deprecated in favor of 2001::/32, which was allocated for the purpose in <xref type="rfc" data="rfc4380"/>.
+3ffe::/16 and 5f00::/8 were used for the 6bone but were returned. <xref type="rfc" data="rfc5156"/></notes>
+  </record>
+  <record date="2008-04">
+    <prefix>5f00::/8</prefix>
+    <description>IANA</description>
+    <whois/>
+    <status>RESERVED</status>
+    <notes>3ffe::/16 and 5f00::/8 were used for the 6bone but were returned. <xref type="rfc" data="rfc5156"/></notes>
+  </record>
+  <people/>
+</registry>
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/multicast-addresses.xml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/multicast-addresses.xml
new file mode 100644
index 0000000000000000000000000000000000000000..4338b06a84752ce12948a898e6060284dee16207
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/multicast-addresses.xml
@@ -0,0 +1,4441 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<?xml-stylesheet type="text/xsl" href="multicast-addresses.xsl"?>
+<?oxygen RNGSchema="multicast-addresses.rng" type="xml"?>
+<registry xmlns="http://www.iana.org/assignments" id="multicast-addresses">
+  <title>IPv4 Multicast Address Space Registry</title>
+  <updated>2020-01-21</updated>
+  <expert>Stig Venaas</expert>
+  <note>Host Extensions for IP Multicasting <xref type="rfc" data="rfc1112"/> specifies the extensions
+required of a host implementation of the Internet Protocol (IP) to
+support multicasting.  The multicast addresses are in the range
+224.0.0.0 through 239.255.255.255. Address assignments are listed below.
+
+The range of addresses between 224.0.0.0 and 224.0.0.255, inclusive,
+is reserved for the use of routing protocols and other low-level
+topology discovery or maintenance protocols, such as gateway discovery
+and group membership reporting.  Multicast routers should not forward
+any multicast datagram with destination addresses in this range,
+regardless of its TTL.
+  </note>
+  
+  
+  <registry id="multicast-addresses-1">
+    <title>Local Network Control Block (224.0.0.0 - 224.0.0.255  (224.0.0/24))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <registration_rule>Expert Review, IESG Approval, or Standards Action</registration_rule>
+    <note>(*)  It is only appropriate to use these values in explicitly-
+configured experiments; they MUST NOT be shipped as defaults in
+implementations.  See <xref type="rfc" data="rfc3692"/> for details.</note>
+    <record>
+      <addr>224.0.0.0</addr>
+      <description>Base Address (Reserved)</description>
+      <xref type="rfc" data="rfc1112"/>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.0.1</addr>
+      <description>All Systems on this Subnet</description>
+      <xref type="rfc" data="rfc1112"/>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.0.2</addr>
+      <description>All Routers on this Subnet</description>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.0.3</addr>
+      <description>Unassigned</description>
+    </record>
+    <record>
+      <addr>224.0.0.4</addr>
+      <description>DVMRP    Routers</description>
+      <xref type="rfc" data="rfc1075"/>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.0.5</addr>
+      <description>OSPFIGP  OSPFIGP All Routers</description>
+      <xref type="rfc" data="rfc2328"/>
+      <xref type="person" data="OSPF_WG_Chairs"/>
+    </record>
+    <record>
+      <addr>224.0.0.6</addr>
+      <description>OSPFIGP  OSPFIGP Designated Routers</description>
+      <xref type="rfc" data="rfc2328"/>
+      <xref type="person" data="OSPF_WG_Chairs"/>
+    </record>
+    <record>
+      <addr>224.0.0.7</addr>
+      <description>ST Routers</description>
+      <xref type="rfc" data="rfc1190"/>
+      <xref type="person" data="Karen_Seo"/>
+    </record>
+    <record>
+      <addr>224.0.0.8</addr>
+      <description>ST Hosts</description>
+      <xref type="rfc" data="rfc1190"/>
+      <xref type="person" data="Karen_Seo"/>
+    </record>
+    <record>
+      <addr>224.0.0.9</addr>
+      <description>RIP2 Routers</description>
+      <xref type="rfc" data="rfc1723"/>
+      <xref type="person" data="Gary_S_Malkin"/>
+    </record>
+    <record date="1996-03-01" updated="2016-03-21">
+      <addr>224.0.0.10</addr>
+      <description>EIGRP Routers</description>
+      <xref type="rfc" data="rfc7868"/>
+    </record>
+    <record>
+      <addr>224.0.0.11</addr>
+      <description>Mobile-Agents</description>
+      <xref type="text">[Bill Simpson]</xref>
+    </record>
+    <record>
+      <addr>224.0.0.12</addr>
+      <description>DHCP Server / Relay Agent</description>
+      <xref type="text">[Unknown]</xref>
+    </record>
+    <record date="1996-03-01">
+      <addr>224.0.0.13</addr>
+      <description>All PIM Routers</description>
+      <xref type="person" data="Dino_Farinacci"/>
+    </record>
+    <record date="1996-04-01">
+      <addr>224.0.0.14</addr>
+      <description>RSVP-ENCAPSULATION</description>
+      <xref type="person" data="Bob_Braden"/>
+    </record>
+    <record date="1997-02-01">
+      <addr>224.0.0.15</addr>
+      <description>all-cbt-routers</description>
+      <xref type="person" data="Tony_Ballardie"/>
+      <xref type="rfc" data="rfc2189"/>
+    </record>
+    <record date="1997-06-01">
+      <addr>224.0.0.16</addr>
+      <description>designated-sbm</description>
+      <xref type="person" data="Fred_Baker"/>
+    </record>
+    <record date="1997-06-01">
+      <addr>224.0.0.17</addr>
+      <description>all-sbms</description>
+      <xref type="person" data="Fred_Baker"/>
+    </record>
+    <record>
+      <addr>224.0.0.18</addr>
+      <description>VRRP</description>
+      <xref type="rfc" data="rfc3768"/>
+      <xref type="rfc" data="rfc5798"/>
+    </record>
+    <record date="1999-10-01">
+      <addr>224.0.0.19</addr>
+      <description>IPAllL1ISs</description>
+      <xref type="person" data="Tony_Przygienda"/>
+    </record>
+    <record date="1999-10-01">
+      <addr>224.0.0.20</addr>
+      <description>IPAllL2ISs</description>
+      <xref type="person" data="Tony_Przygienda"/>
+    </record>
+    <record date="1999-10-01">
+      <addr>224.0.0.21</addr>
+      <description>IPAllIntermediate Systems</description>
+      <xref type="person" data="Tony_Przygienda"/>
+    </record>
+    <record date="1999-10-01">
+      <addr>224.0.0.22</addr>
+      <description>IGMP</description>
+      <xref type="person" data="Steve_Deering"/>
+    </record>
+    <record date="2000-03-01">
+      <addr>224.0.0.23</addr>
+      <description>GLOBECAST-ID</description>
+      <xref type="person" data="Piers_Scannell"/>
+    </record>
+    <record>
+      <addr>224.0.0.24</addr>
+      <description>OSPFIGP-TE</description>
+      <xref type="rfc" data="rfc4973"/>
+    </record>
+    <record date="2000-03-01">
+      <addr>224.0.0.25</addr>
+      <description>router-to-switch</description>
+      <xref type="person" data="Ishan_Wu"/>
+    </record>
+    <record>
+      <addr>224.0.0.26</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2000-03-01">
+      <addr>224.0.0.27</addr>
+      <description>Al MPP Hello</description>
+      <xref type="person" data="Brian_Martinicky"/>
+    </record>
+    <record date="2000-03-01">
+      <addr>224.0.0.28</addr>
+      <description>ETC Control</description>
+      <xref type="person" data="Steve_Polishinski"/>
+    </record>
+    <record date="2000-05-01">
+      <addr>224.0.0.29</addr>
+      <description>GE-FANUC</description>
+      <xref type="person" data="Ian_Wacey"/>
+    </record>
+    <record date="2000-05-01">
+      <addr>224.0.0.30</addr>
+      <description>indigo-vhdp</description>
+      <xref type="person" data="Colin_Caughie"/>
+    </record>
+    <record date="2000-05-01">
+      <addr>224.0.0.31</addr>
+      <description>shinbroadband</description>
+      <xref type="person" data="Sakon_Kittivatcharapong"/>
+    </record>
+    <record date="2000-05-01">
+      <addr>224.0.0.32</addr>
+      <description>digistar</description>
+      <xref type="person" data="Brian_Kerkan"/>
+    </record>
+    <record date="2003-03-01">
+      <addr>224.0.0.33</addr>
+      <description>ff-system-management</description>
+      <xref type="person" data="Dave_Glanzer"/>
+    </record>
+    <record date="2000-06-01">
+      <addr>224.0.0.34</addr>
+      <description>pt2-discover</description>
+      <xref type="person" data="Ralph_Kammerlander"/>
+    </record>
+    <record date="2000-07-01">
+      <addr>224.0.0.35</addr>
+      <description>DXCLUSTER</description>
+      <xref type="person" data="Dirk_Koopman"/>
+    </record>
+    <record date="2001-01-01">
+      <addr>224.0.0.36</addr>
+      <description>DTCP Announcement</description>
+      <xref type="person" data="Patrick_Cipiere"/>
+    </record>
+    <record date="2001-12-01">
+      <addr>224.0.0.37-224.0.0.68</addr>
+      <description>zeroconfaddr   (renew 12/02)</description>
+      <xref type="person" data="Erik_Guttman"/>
+    </record>
+    <record>
+      <addr>224.0.0.69-224.0.0.100</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+    <record date="2001-12-01">
+      <addr>224.0.0.101</addr>
+      <description>cisco-nhap</description>
+      <xref type="person" data="Mark_Bakke"/>
+    </record>
+    <record date="2001-12-01">
+      <addr>224.0.0.102</addr>
+      <description>HSRP</description>
+      <xref type="person" data="Ian_Wilson"/>
+    </record>
+    <record date="2002-02-01">
+      <addr>224.0.0.103</addr>
+      <description>MDAP</description>
+      <xref type="person" data="Johan_Deleu"/>
+    </record>
+    <record date="2002-10-01">
+      <addr>224.0.0.104</addr>
+      <description>Nokia MC CH</description>
+      <xref type="person" data="Morteza_Kalhour"/>
+    </record>
+    <record date="2003-03-01">
+      <addr>224.0.0.105</addr>
+      <description>ff-lr-address</description>
+      <xref type="person" data="Dave_Glanzer"/>
+    </record>
+    <record>
+      <addr>224.0.0.106</addr>
+      <description>All-Snoopers</description>
+      <xref type="rfc" data="rfc4286"/>
+    </record>
+    <record date="2007-02-02">
+      <addr>224.0.0.107</addr>
+      <description>PTP-pdelay</description>
+      <xref type="uri" data="http://ieee1588.nist.gov/"/>
+      <xref type="person" data="Kang_Lee"/>
+    </record>
+    <record date="2007-08-30">
+      <addr>224.0.0.108</addr>
+      <description>Saratoga</description>
+      <xref type="person" data="Lloyd_Wood"/>
+      <reviewed>2011-03-17</reviewed>
+    </record>
+    <record>
+      <addr>224.0.0.109</addr>
+      <description>LL-MANET-Routers</description>
+      <xref type="rfc" data="rfc5498"/>
+      <reviewed>2011-02-23</reviewed>
+    </record>
+    <record date="2009-01-20">
+      <addr>224.0.0.110</addr>
+      <description>IGRS</description>
+      <xref type="person" data="Xiaoyu_Zhou"/>
+    </record>
+    <record>
+      <addr>224.0.0.111</addr>
+      <description>Babel</description>
+      <xref type="rfc" data="rfc6126"/>
+    </record>
+    <record date="2011-11-02">
+      
+      <addr>224.0.0.112</addr>
+      <description>MMA Device Discovery</description>
+      <xref type="person" data="Tom_White"/>
+    </record>
+    <record date="2011-11-18">
+      <addr>224.0.0.113</addr>
+      <description>AllJoyn</description>
+      <xref type="person" data="Craig_Dowell"/>
+    </record>
+    <record date="2012-06-12">
+      <addr>224.0.0.114</addr>
+      <description>Inter RFID Reader Protocol</description>
+      <xref type="person" data="Wayne_Wenyu_Liu"/>
+    </record>
+    <record date="2014-07-01">
+      <addr>224.0.0.115</addr>
+      <description>JSDP</description>
+      <xref type="person" data="J._Ryan_Stinnett"/>
+    </record>
+    <record date="2016-10-20">
+      <addr>224.0.0.116</addr>
+      <description>Device discovery/config</description>
+      <xref type="person" data="COMTECH_Kft."/>
+    </record>
+    <record date="2017-04-03">
+      <addr>224.0.0.117</addr>
+      <description>DLEP Discovery</description>
+      <xref type="rfc" data="rfc8175"/>
+    </record>
+    <record date="2017-05-19">
+      <addr>224.0.0.118</addr>
+      <description>MAAS</description>
+      <xref type="person" data="Mike_Pontillo"/>
+    </record>
+    <record date="2017-07-20">
+      <addr>224.0.0.119</addr>
+      <description>ALL_GRASP_NEIGHBORS</description>
+      <xref type="draft" data="RFC-ietf-anima-grasp-15"/>
+    </record>
+    <record>
+      <addr>224.0.0.120-224.0.0.149</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2019-03-13">
+      <addr>224.0.0.150</addr>
+      <description>Ramp AltitudeCDN MulticastPlus</description>
+      <xref type="person" data="Giovanni_Marzot"/>
+      <controller><xref type="person" data="Ramp_Holdings"/></controller>
+    </record>
+    <record>
+      <addr>224.0.0.151-224.0.0.250</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2000-04-01">
+      <addr>224.0.0.251</addr>
+      <description>mDNS</description>
+      <xref type="rfc" data="rfc6762"/>
+    </record>
+    <record>
+      <addr>224.0.0.252</addr>
+      <description>Link-local Multicast Name Resolution</description>
+      <xref type="rfc" data="rfc4795"/>
+      <reviewed>2011-03-17</reviewed>
+    </record>
+    <record>
+      <addr>224.0.0.253</addr>
+      <description>Teredo</description>
+      <xref type="rfc" data="rfc4380"/>
+      <reviewed>2010-02-14</reviewed>
+    </record>
+    <record>
+      <addr>224.0.0.254</addr>
+      <description>RFC3692-style Experiment (*)</description>
+      <xref type="rfc" data="rfc4727"/>
+    </record>
+    <record>
+      <addr>224.0.0.255</addr>
+      <description>Unassigned</description>
+    </record>
+  </registry>
+
+  
+  <registry id="multicast-addresses-2">
+    <title>Internetwork Control Block (224.0.1.0 - 224.0.1.255  (224.0.1/24))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <registration_rule>Expert Review, IESG Approval, or Standards Action</registration_rule>
+    <record>
+      <addr>224.0.1.0</addr>
+      <description>VMTP Managers Group</description>
+      <xref type="rfc" data="rfc1045"/>
+      <xref type="person" data="Dave_Cheriton"/>
+    </record>
+    <record>
+      <addr>224.0.1.1</addr>
+      <description>NTP Network Time Protocol</description>
+      <xref type="rfc" data="rfc1119"/>
+      <xref type="rfc" data="rfc5905"/>
+      <xref type="person" data="David_Mills"/>
+    </record>
+    <record>
+      <addr>224.0.1.2</addr>
+      <description>SGI-Dogfight</description>
+      <xref type="person" data="Andrew_Cherenson"/>
+    </record>
+    <record>
+      <addr>224.0.1.3</addr>
+      <description>Rwhod</description>
+      <xref type="person" data="Steve_Deering_2"/>
+    </record>
+    <record>
+      <addr>224.0.1.4</addr>
+      <description>VNP</description>
+      <xref type="person" data="Dave_Cheriton"/>
+    </record>
+    <record>
+      <addr>224.0.1.5</addr>
+      <description>Artificial Horizons - Aviator</description>
+      <xref type="person" data="Bruce_Factor"/>
+    </record>
+    <record>
+      <addr>224.0.1.6</addr>
+      <description>NSS - Name Service Server</description>
+      <xref type="person" data="Bill_Schilit"/>
+    </record>
+    <record>
+      <addr>224.0.1.7</addr>
+      <description>AUDIONEWS - Audio News Multicast</description>
+      <xref type="person" data="Martin_Forssen"/>
+    </record>
+    <record>
+      <addr>224.0.1.8</addr>
+      <description>SUN NIS+ Information Service</description>
+      <xref type="person" data="Chuck_McManis"/>
+    </record>
+    <record>
+      <addr>224.0.1.9</addr>
+      <description>MTP Multicast Transport Protocol</description>
+      <xref type="person" data="Susie_Armstrong"/>
+    </record>
+    <record>
+      <addr>224.0.1.10</addr>
+      <description>IETF-1-LOW-AUDIO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.11</addr>
+      <description>IETF-1-AUDIO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.12</addr>
+      <description>IETF-1-VIDEO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.13</addr>
+      <description>IETF-2-LOW-AUDIO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.14</addr>
+      <description>IETF-2-AUDIO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.15</addr>
+      <description>IETF-2-VIDEO</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.0.1.16</addr>
+      <description>MUSIC-SERVICE</description>
+    </record>
+    <record>
+      <addr>224.0.1.17</addr>
+      <description>SEANET-TELEMETRY</description>
+    </record>
+    <record>
+      <addr>224.0.1.18</addr>
+      <description>SEANET-IMAGE</description>
+    </record>
+    <record date="1996-04-01">
+      <addr>224.0.1.19</addr>
+      <description>MLOADD</description>
+      <xref type="person" data="Bob_Braden"/>
+    </record>
+    <record>
+      <addr>224.0.1.20</addr>
+      <description>any private experiment</description>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.1.21</addr>
+      <description>DVMRP on MOSPF</description>
+      <xref type="text">[John Moy]</xref>
+    </record>
+    <record date="1995-05-01">
+      <addr>224.0.1.22</addr>
+      <description>SVRLOC</description>
+      <xref type="person" data="John_Veizades"/>
+    </record>
+    <record>
+      <addr>224.0.1.23</addr>
+      <description>XINGTV</description>
+      <xref type="person" data="Howard_Gordon"/>
+    </record>
+    <record>
+      <addr>224.0.1.24</addr>
+      <description>microsoft-ds</description>
+      <xref type="text">&lt;arnoldm&amp;microsoft.com&gt;</xref>
+    </record>
+    <record>
+      <addr>224.0.1.25</addr>
+      <description>nbc-pro</description>
+      <xref type="text">&lt;bloomer&amp;birch.crd.ge.com&gt;</xref>
+    </record>
+    <record>
+      <addr>224.0.1.26</addr>
+      <description>nbc-pfn</description>
+      <xref type="text">&lt;bloomer&amp;birch.crd.ge.com&gt;</xref>
+    </record>
+    <record date="1994-11-01">
+      <addr>224.0.1.27</addr>
+      <description>lmsc-calren-1</description>
+      <xref type="person" data="Yea_Uang"/>
+    </record>
+    <record date="1994-11-01">
+      <addr>224.0.1.28</addr>
+      <description>lmsc-calren-2</description>
+      <xref type="person" data="Yea_Uang"/>
+    </record>
+    <record date="1994-11-01">
+      <addr>224.0.1.29</addr>
+      <description>lmsc-calren-3</description>
+      <xref type="person" data="Yea_Uang"/>
+    </record>
+    <record date="1994-11-01">
+      <addr>224.0.1.30</addr>
+      <description>lmsc-calren-4</description>
+      <xref type="person" data="Yea_Uang"/>
+    </record>
+    <record date="1995-01-01">
+      <addr>224.0.1.31</addr>
+      <description>ampr-info</description>
+      <xref type="person" data="Rob_Janssen"/>
+    </record>
+    <record date="1995-01-01">
+      <addr>224.0.1.32</addr>
+      <description>mtrace</description>
+      <xref type="person" data="Steve_Casner_2"/>
+    </record>
+    <record date="1996-04-01">
+      <addr>224.0.1.33</addr>
+      <description>RSVP-encap-1</description>
+      <xref type="person" data="Bob_Braden"/>
+    </record>
+    <record date="1996-04-01">
+      <addr>224.0.1.34</addr>
+      <description>RSVP-encap-2</description>
+      <xref type="person" data="Bob_Braden"/>
+    </record>
+    <record date="1995-05-01">
+      <addr>224.0.1.35</addr>
+      <description>SVRLOC-DA</description>
+      <xref type="person" data="John_Veizades"/>
+    </record>
+    <record date="1995-08-01">
+      <addr>224.0.1.36</addr>
+      <description>rln-server</description>
+      <xref type="person" data="Brian_Kean"/>
+    </record>
+    <record date="1995-10-01">
+      <addr>224.0.1.37</addr>
+      <description>proshare-mc</description>
+      <xref type="person" data="Mark_Lewis"/>
+    </record>
+    <record>
+      <addr>224.0.1.38</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1996-03-01">
+      <addr>224.0.1.39</addr>
+      <description>cisco-rp-announce</description>
+      <xref type="person" data="Dino_Farinacci"/>
+    </record>
+    <record date="1996-03-01">
+      <addr>224.0.1.40</addr>
+      <description>cisco-rp-discovery</description>
+      <xref type="person" data="Dino_Farinacci"/>
+    </record>
+    <record date="1996-05-01">
+      <addr>224.0.1.41</addr>
+      <description>gatekeeper</description>
+      <xref type="person" data="Jim_Toga"/>
+    </record>
+    <record date="1996-07-01">
+      <addr>224.0.1.42</addr>
+      <description>iberiagames</description>
+      <xref type="person" data="Jose_Luis_Marocho"/>
+    </record>
+    <record date="1996-11-01">
+      <addr>224.0.1.43</addr>
+      <description>nwn-discovery</description>
+      <xref type="person" data="Arnoud_Zwemmer"/>
+    </record>
+    <record date="1996-11-01">
+      <addr>224.0.1.44</addr>
+      <description>nwn-adaptor</description>
+      <xref type="person" data="Arnoud_Zwemmer"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.45</addr>
+      <description>isma-1</description>
+      <xref type="person" data="Stephen_Dunne"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.46</addr>
+      <description>isma-2</description>
+      <xref type="person" data="Stephen_Dunne"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.47</addr>
+      <description>telerate</description>
+      <xref type="person" data="Wenjie_Peng"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.48</addr>
+      <description>ciena</description>
+      <xref type="person" data="Mike_Rodbell"/>
+    </record>
+    <record>
+      <addr>224.0.1.49</addr>
+      <description>dcap-servers</description>
+      <xref type="rfc" data="rfc2114"/>
+    </record>
+    <record>
+      <addr>224.0.1.50</addr>
+      <description>dcap-clients</description>
+      <xref type="rfc" data="rfc2114"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.51</addr>
+      <description>mcntp-directory</description>
+      <xref type="person" data="Heiko_Rupp"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.1.52</addr>
+      <description>mbone-vcr-directory</description>
+      <xref type="person" data="Wieland_Holdfelder"/>
+    </record>
+    <record date="1997-03-01">
+      <addr>224.0.1.53</addr>
+      <description>heartbeat</description>
+      <xref type="person" data="Louis_Mamakos"/>
+    </record>
+    <record date="1997-04-01">
+      <addr>224.0.1.54</addr>
+      <description>sun-mc-grp</description>
+      <xref type="person" data="Michael_DeMoney"/>
+    </record>
+    <record date="1997-04-01">
+      <addr>224.0.1.55</addr>
+      <description>extended-sys</description>
+      <xref type="person" data="David_Poole"/>
+    </record>
+    <record date="1997-06-01">
+      <addr>224.0.1.56</addr>
+      <description>pdrncs</description>
+      <xref type="person" data="Paul_Wissenbach"/>
+    </record>
+    <record date="1997-06-01">
+      <addr>224.0.1.57</addr>
+      <description>tns-adv-multi</description>
+      <xref type="person" data="Jerome_Albin"/>
+    </record>
+    <record date="1997-08-01">
+      <addr>224.0.1.58</addr>
+      <description>vcals-dmu</description>
+      <xref type="person" data="Masato_Shindoh"/>
+    </record>
+    <record date="1997-09-01">
+      <addr>224.0.1.59</addr>
+      <description>zuba</description>
+      <xref type="person" data="Dan_Jackson"/>
+    </record>
+    <record date="1997-07-01">
+      <addr>224.0.1.60</addr>
+      <description>hp-device-disc</description>
+      <xref type="person" data="Shivaun_Albright"/>
+    </record>
+    <record date="1997-07-01">
+      <addr>224.0.1.61</addr>
+      <description>tms-production</description>
+      <xref type="person" data="Asad_Gilani"/>
+    </record>
+    <record date="1997-08-01">
+      <addr>224.0.1.62</addr>
+      <description>sunscalar</description>
+      <xref type="person" data="Terry_Gibson"/>
+    </record>
+    <record date="1997-09-01">
+      <addr>224.0.1.63</addr>
+      <description>mmtp-poll</description>
+      <xref type="person" data="Bryan_Costales"/>
+    </record>
+    <record date="1997-10-01">
+      <addr>224.0.1.64</addr>
+      <description>compaq-peer</description>
+      <xref type="person" data="Victor_Volpe"/>
+    </record>
+    <record date="1997-12-01">
+      <addr>224.0.1.65</addr>
+      <description>iapp</description>
+      <xref type="person" data="Bob_Meier"/>
+    </record>
+    <record date="1997-12-01">
+      <addr>224.0.1.66</addr>
+      <description>multihasc-com</description>
+      <xref type="person" data="Darcy_Brockbank"/>
+    </record>
+    <record date="1997-12-01">
+      <addr>224.0.1.67</addr>
+      <description>serv-discovery</description>
+      <xref type="person" data="Chas_Honton"/>
+    </record>
+    <record>
+      <addr>224.0.1.68</addr>
+      <description>mdhcpdisover</description>
+      <xref type="rfc" data="rfc2730"/>
+    </record>
+    <record date="1998-02-01">
+      <addr>224.0.1.69</addr>
+      <description>MMP-bundle-discovery1</description>
+      <xref type="person" data="Gary_Scott_Malkin"/>
+    </record>
+    <record date="1998-02-01">
+      <addr>224.0.1.70</addr>
+      <description>MMP-bundle-discovery2</description>
+      <xref type="person" data="Gary_Scott_Malkin"/>
+    </record>
+    <record date="1998-02-01" updated="2014-11-07">
+      <addr>224.0.1.71</addr>
+      <description>XYPOINT DGPS Data Feed</description>
+      <xref type="person" data="NE-TEAM_at_telecomsys.com"/>
+    </record>
+    <record date="1998-02-01">
+      <addr>224.0.1.72</addr>
+      <description>GilatSkySurfer</description>
+      <xref type="person" data="Yossi_Gal"/>
+    </record>
+    <record date="1997-03-01">
+      <addr>224.0.1.73</addr>
+      <description>SharesLive</description>
+      <xref type="person" data="Shane_Rowatt"/>
+    </record>
+    <record>
+      <addr>224.0.1.74</addr>
+      <description>NorthernData</description>
+      <xref type="text">[Sheers]</xref>
+    </record>
+    <record>
+      <addr>224.0.1.75</addr>
+      <description>SIP</description>
+      <xref type="text">[Schulzrinne]</xref>
+    </record>
+    <record date="1998-03">
+      <addr>224.0.1.76</addr>
+      <description>IAPP</description>
+      <xref type="person" data="Henri_Moelard"/>
+    </record>
+    <record date="1998-03-01">
+      <addr>224.0.1.77</addr>
+      <description>AGENTVIEW</description>
+      <xref type="person" data="Ram_Iyer"/>
+    </record>
+    <record date="1998-04-01">
+      <addr>224.0.1.78</addr>
+      <description>Tibco Multicast1</description>
+      <xref type="person" data="Raymond_Shum"/>
+    </record>
+    <record date="1998-04-01">
+      <addr>224.0.1.79</addr>
+      <description>Tibco Multicast2</description>
+      <xref type="person" data="Raymond_Shum"/>
+    </record>
+    <record date="1998-06-01">
+      <addr>224.0.1.80</addr>
+      <description>MSP</description>
+      <xref type="person" data="Evan_Caves"/>
+    </record>
+    <record date="1998-06-01">
+      <addr>224.0.1.81</addr>
+      <description>OTT (One-way Trip Time)</description>
+      <xref type="person" data="Beverly_Schwartz"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.82</addr>
+      <description>TRACKTICKER</description>
+      <xref type="person" data="Alan_Novick"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.83</addr>
+      <description>dtn-mc</description>
+      <xref type="person" data="Bob_Gaddie"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.84</addr>
+      <description>jini-announcement</description>
+      <xref type="person" data="Bob_Scheifler"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.85</addr>
+      <description>jini-request</description>
+      <xref type="person" data="Bob_Scheifler"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.86</addr>
+      <description>sde-discovery</description>
+      <xref type="person" data="Peter_Aronson"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.1.87</addr>
+      <description>DirecPC-SI</description>
+      <xref type="person" data="Doug_Dillon"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.88</addr>
+      <description>B1RMonitor</description>
+      <xref type="person" data="Ed_Purkiss"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.89</addr>
+      <description>3Com-AMP3 dRMON</description>
+      <xref type="person" data="Prakash_Banthia"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.90</addr>
+      <description>imFtmSvc</description>
+      <xref type="person" data="Zia_Bhatti"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.91</addr>
+      <description>NQDS4</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.92</addr>
+      <description>NQDS5</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.93</addr>
+      <description>NQDS6</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.94</addr>
+      <description>NLVL12</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.95</addr>
+      <description>NTDS1</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.96</addr>
+      <description>NTDS2</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.97</addr>
+      <description>NODSA</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.98</addr>
+      <description>NODSB</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.99</addr>
+      <description>NODSC</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.100</addr>
+      <description>NODSD</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.101</addr>
+      <description>NQDS4R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.102</addr>
+      <description>NQDS5R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.103</addr>
+      <description>NQDS6R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.104</addr>
+      <description>NLVL12R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.105</addr>
+      <description>NTDS1R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.106</addr>
+      <description>NTDS2R</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.107</addr>
+      <description>NODSAR</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.108</addr>
+      <description>NODSBR</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.109</addr>
+      <description>NODSCR</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-09-01">
+      <addr>224.0.1.110</addr>
+      <description>NODSDR</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1998-10-01">
+      <addr>224.0.1.111</addr>
+      <description>MRM</description>
+      <xref type="person" data="Liming_Wei"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.112</addr>
+      <description>TVE-FILE</description>
+      <xref type="person" data="Dean_Blackketter"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.113</addr>
+      <description>TVE-ANNOUNCE</description>
+      <xref type="person" data="Dean_Blackketter"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.114</addr>
+      <description>Mac Srv Loc</description>
+      <xref type="person" data="Bill_Woodcock"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.115</addr>
+      <description>Simple Multicast</description>
+      <xref type="person" data="Jon_Crowcroft"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.116</addr>
+      <description>SpectraLinkGW</description>
+      <xref type="person" data="Mark_Hamilton"/>
+    </record>
+    <record date="1998-11-01">
+      <addr>224.0.1.117</addr>
+      <description>dieboldmcast</description>
+      <xref type="person" data="Gene_Marsh"/>
+    </record>
+    <record date="1998-12-01">
+      <addr>224.0.1.118</addr>
+      <description>Tivoli Systems</description>
+      <xref type="person" data="Jon_Gabriel"/>
+    </record>
+    <record date="1998-12-01">
+      <addr>224.0.1.119</addr>
+      <description>pq-lic-mcast</description>
+      <xref type="person" data="Bob_Sledge"/>
+    </record>
+    <record date="2007-03-01">
+      <addr>224.0.1.120</addr>
+      <description>SPRYWARE LLC</description>
+      <xref type="person" data="Michael_Kreutzjans"/>
+    </record>
+    <record date="1998-12-01">
+      <addr>224.0.1.121</addr>
+      <description>Pipesplatform</description>
+      <xref type="person" data="Daniel_Dissett"/>
+    </record>
+    <record date="1999-01-01">
+      <addr>224.0.1.122</addr>
+      <description>LiebDevMgmg-DM</description>
+      <xref type="person" data="Mike_Velten"/>
+    </record>
+    <record date="1999-01-01">
+      <addr>224.0.1.123</addr>
+      <description>TRIBALVOICE</description>
+      <xref type="person" data="Nigel_Thompson"/>
+    </record>
+    <record>
+      <addr>224.0.1.124</addr>
+      <description>Unassigned (Retracted 1/29/01)</description>
+    </record>
+    <record>
+      <addr>224.0.1.125</addr>
+      <description>PolyCom Relay1</description>
+      <xref type="text">[Coutiere]</xref>
+    </record>
+    <record date="1999-03-01">
+      <addr>224.0.1.126</addr>
+      <description>Infront Multi1</description>
+      <xref type="person" data="Morten_Lindeman"/>
+    </record>
+    <record date="1999-03-01">
+      <addr>224.0.1.127</addr>
+      <description>XRX DEVICE DISC</description>
+      <xref type="person" data="Michael_Wang"/>
+    </record>
+    <record date="1999-04-01">
+      <addr>224.0.1.128</addr>
+      <description>CNN</description>
+      <xref type="person" data="Joel_Lynch"/>
+    </record>
+    <record date="2007-02-02">
+      <addr>224.0.1.129</addr>
+      <description>PTP-primary</description>
+      <xref type="uri" data="http://ieee1588.nist.gov/"/>
+      <xref type="person" data="Kang_Lee"/>
+    </record>
+    <record date="2007-02-02">
+      <addr>224.0.1.130</addr>
+      <description>PTP-alternate1</description>
+      <xref type="uri" data="http://ieee1588.nist.gov/"/>
+      <xref type="person" data="Kang_Lee"/>
+    </record>
+    <record date="2007-02-02">
+      <addr>224.0.1.131</addr>
+      <description>PTP-alternate2</description>
+      <xref type="uri" data="http://ieee1588.nist.gov/"/>
+      <xref type="person" data="Kang_Lee"/>
+    </record>
+    <record date="2007-02-02">
+      <addr>224.0.1.132</addr>
+      <description>PTP-alternate3</description>
+      <xref type="uri" data="http://ieee1588.nist.gov/"/>
+      <xref type="person" data="Kang_Lee"/>
+    </record>
+    <record date="1999-04-01">
+      <addr>224.0.1.133</addr>
+      <description>ProCast</description>
+      <xref type="person" data="Shai_Revzen"/>
+    </record>
+    <record date="1999-04-01">
+      <addr>224.0.1.134</addr>
+      <description>3Com Discp</description>
+      <xref type="person" data="Peter_White"/>
+    </record>
+    <record date="1999-05-01">
+      <addr>224.0.1.135</addr>
+      <description>CS-Multicasting</description>
+      <xref type="person" data="Nedelcho_Stanev"/>
+    </record>
+    <record date="1999-06-01">
+      <addr>224.0.1.136</addr>
+      <description>TS-MC-1</description>
+      <xref type="person" data="Darrell_Sveistrup"/>
+    </record>
+    <record date="1999-06-01">
+      <addr>224.0.1.137</addr>
+      <description>Make Source</description>
+      <xref type="person" data="Anthony_Daga"/>
+    </record>
+    <record date="1999-06-01">
+      <addr>224.0.1.138</addr>
+      <description>Teleborsa</description>
+      <xref type="person" data="Paolo_Strazzera"/>
+    </record>
+    <record date="1999-07-01">
+      <addr>224.0.1.139</addr>
+      <description>SUMAConfig</description>
+      <xref type="person" data="Walter_Wallach"/>
+    </record>
+    <record>
+      <addr>224.0.1.140</addr>
+      <description>capwap-ac</description>
+      <xref type="rfc" data="rfc5415"/>
+    </record>
+    <record date="1999-10-01">
+      <addr>224.0.1.141</addr>
+      <description>DHCP-SERVERS</description>
+      <xref type="person" data="Eric_Hall"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.142</addr>
+      <description>CN Router-LL</description>
+      <xref type="person" data="Ian_Armitage"/>
+    </record>
+    <record date="2008-02-04">
+      <addr>224.0.1.143</addr>
+      <description>EMWIN</description>
+      <xref type="person" data="Antonio_Querubin"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.144</addr>
+      <description>Alchemy Cluster</description>
+      <xref type="person" data="Stacey_O_Rourke"/>
+      <xref type="person" data="Stacey_O_Rourke_2"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.145</addr>
+      <description>Satcast One</description>
+      <xref type="person" data="Julian_Nevell"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.146</addr>
+      <description>Satcast Two</description>
+      <xref type="person" data="Julian_Nevell"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.147</addr>
+      <description>Satcast Three</description>
+      <xref type="person" data="Julian_Nevell"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.148</addr>
+      <description>Intline</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="1999-09-01">
+      <addr>224.0.1.149</addr>
+      <description>8x8 Multicast</description>
+      <xref type="person" data="Mike_Roper"/>
+    </record>
+    <record date="2019-03-13">
+      <addr>224.0.1.150</addr>
+      <description>Ramp AltitudeCDN MulticastPlus</description>
+      <xref type="person" data="Giovanni_Marzot"/>
+      <controller><xref type="person" data="Ramp_Holdings"/></controller>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.151</addr>
+      <description>Intline-1</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.152</addr>
+      <description>Intline-2</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.153</addr>
+      <description>Intline-3</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.154</addr>
+      <description>Intline-4</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.155</addr>
+      <description>Intline-5</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.156</addr>
+      <description>Intline-6</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.157</addr>
+      <description>Intline-7</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.158</addr>
+      <description>Intline-8</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.159</addr>
+      <description>Intline-9</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.160</addr>
+      <description>Intline-10</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.161</addr>
+      <description>Intline-11</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.162</addr>
+      <description>Intline-12</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.163</addr>
+      <description>Intline-13</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.164</addr>
+      <description>Intline-14</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.165</addr>
+      <description>Intline-15</description>
+      <xref type="person" data="Robert_Sliwinski"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.166</addr>
+      <description>marratech-cc</description>
+      <xref type="person" data="Peter_Parnes"/>
+    </record>
+    <record date="2000-02-01">
+      <addr>224.0.1.167</addr>
+      <description>EMS-InterDev</description>
+      <xref type="person" data="Stephen_T_Lyda"/>
+    </record>
+    <record date="2000-03-01">
+      <addr>224.0.1.168</addr>
+      <description>itb301</description>
+      <xref type="person" data="Bodo_Rueskamp"/>
+    </record>
+    <record date="2000-07-01">
+      <addr>224.0.1.169</addr>
+      <description>rtv-audio</description>
+      <xref type="person" data="Chris_Adams"/>
+    </record>
+    <record date="2000-07-01">
+      <addr>224.0.1.170</addr>
+      <description>rtv-video</description>
+      <xref type="person" data="Chris_Adams"/>
+    </record>
+    <record date="2000-07-01">
+      <addr>224.0.1.171</addr>
+      <description>HAVI-Sim</description>
+      <xref type="person" data="Stephan_Wasserroth"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.1.172</addr>
+      <description>Nokia Cluster</description>
+      <xref type="person" data="Stacey_O_Rourke"/>
+      <xref type="person" data="Stacey_O_Rourke_2"/>
+    </record>
+    <record date="2001-06-01">
+      <addr>224.0.1.173</addr>
+      <description>host-request</description>
+      <xref type="person" data="Keith_Thompson"/>
+    </record>
+    <record date="2001-06-01">
+      <addr>224.0.1.174</addr>
+      <description>host-announce</description>
+      <xref type="person" data="Keith_Thompson"/>
+    </record>
+    <record date="2001-12-01">
+      <addr>224.0.1.175</addr>
+      <description>ptk-cluster</description>
+      <xref type="person" data="Robert_Hodgson"/>
+    </record>
+    <record date="2002-02-01">
+      <addr>224.0.1.176</addr>
+      <description>Proxim Protocol</description>
+      <xref type="person" data="Gajendra_Shukla"/>
+    </record>
+    <record date="2002-10-01">
+      <addr>224.0.1.177</addr>
+      <description>Gemtek Systems</description>
+      <xref type="person" data="Alex_Lee"/>
+    </record>
+    <record date="2003-01-01">
+      <addr>224.0.1.178</addr>
+      <description>IEEE IAPP</description>
+      <xref type="person" data="Stuart_Kerry"/>
+    </record>
+    <record date="2006-04-11">
+      <addr>224.0.1.179</addr>
+      <description>1451_Dot5_802_Discovery</description>
+      <xref type="person" data="Ryon_Coleman"/>
+    </record>
+    <record date="2006-04-11">
+      <addr>224.0.1.180</addr>
+      <description>1451_Dot5_802_Group_1</description>
+      <xref type="person" data="Ryon_Coleman"/>
+    </record>
+    <record date="2006-04-11">
+      <addr>224.0.1.181</addr>
+      <description>1451_Dot5_802_Group_2</description>
+      <xref type="person" data="Ryon_Coleman"/>
+    </record>
+    <record date="2006-04-11">
+      <addr>224.0.1.182</addr>
+      <description>1451_Dot5_802_Group_3</description>
+      <xref type="person" data="Ryon_Coleman"/>
+    </record>
+    <record date="2006-04-11">
+      <addr>224.0.1.183</addr>
+      <description>1451_Dot5_802_Group_4</description>
+      <xref type="person" data="Ryon_Coleman"/>
+    </record>
+    <record date="2007-03-06">
+      <addr>224.0.1.184</addr>
+      <description>VFSDP</description>
+      <xref type="person" data="Adam_Yellen"/>
+    </record>
+    <record>
+      <addr>224.0.1.185</addr>
+      <description>ASAP</description>
+      <xref type="rfc" data="rfc5352"/>
+    </record>
+    <record>
+      <addr>224.0.1.186</addr>
+      <description>SL-MANET-ROUTERS</description>
+      <xref type="rfc" data="rfc6621"/>
+    </record>    
+    <record date="2013-07-25">
+      <addr>224.0.1.187</addr>
+      <description>All CoAP Nodes</description>
+      <xref type="rfc" data="rfc7252"/>
+    </record>
+    <record date="2019-02-20">
+      <addr>224.0.1.188</addr>
+      <description>BRSDP</description>
+      <xref type="person" data="Vanya_Levy"/>
+      <controller><xref type="person" data="Semtech_Corporation"/></controller>
+    </record>
+    <record>
+      <addr>224.0.1.189-224.0.1.255</addr>
+      <description>Unassigned</description>
+    </record>
+  </registry>
+
+  
+  <registry id="multicast-addresses-3">
+    <title>AD-HOC Block I (224.0.2.0 - 224.0.255.255)</title>
+    <xref type="rfc" data="rfc5771"/>
+    <registration_rule>Expert Review, IESG Approval, or Standards Action</registration_rule>
+    <record>
+      <addr>224.0.2.0</addr>
+      <description>Unassigned</description>
+    </record>
+    <record>
+      <addr>224.0.2.1</addr>
+      <description>"rwho" Group (BSD) (unofficial)</description>
+      <xref type="person" data="Jon_Postel"/>
+    </record>
+    <record>
+      <addr>224.0.2.2</addr>
+      <description>SUN RPC PMAPPROC_CALLIT</description>
+      <xref type="person" data="Brendan_Eic"/>
+    </record>
+    <record date="2005-01-01">
+      <addr>224.0.2.3</addr>
+      <description>EPSON-disc-set</description>
+      <xref type="person" data="SEIKO_EPSON_Corp"/>
+    </record>
+    <record date="2009-08-28">
+      <addr>224.0.2.4</addr>
+      <description>All C1222 Nodes</description>
+      <xref type="rfc" data="rfc6142"/>
+    </record>
+    <record date="2012-04-17">
+      <addr>224.0.2.5</addr>
+      <description>Monitoring Discovery Protocol</description>
+      <xref type="person" data="Alan_Robertson"/>
+    </record>
+    <record date="2012-04-25">
+      <addr>224.0.2.6</addr>
+      <description>BitSend MediaStreams</description>
+      <xref type="person" data="Carl-Johan_Sjöberg"/>
+    </record>
+    <record date="2012-11-19">
+      <addr>224.0.2.7-224.0.2.8</addr>
+      <description>rxWARN</description>
+      <xref type="person" data="Caleb_Bell"/>
+    </record>
+    <record date="2016-10-04">
+      <addr>224.0.2.9</addr>
+      <description>DATV streams</description>
+      <xref type="person" data="Grant_Taylor"/>
+    </record>
+    <record date="2017-05-19">
+      <addr>224.0.2.10</addr>
+      <description>swapapp_multicast</description>
+      <xref type="person" data="Applykane"/>
+    </record>
+    <record date="2018-10-17">
+      <addr>224.0.2.11</addr>
+      <description>LDA Discovery Service</description>
+      <xref type="person" data="Juan_Ayas"/>
+      <controller><xref type="person" data="LDA_Audio_Tech"/></controller>
+    </record>
+    <record date="2018-11-15">
+      <addr>224.0.2.12</addr>
+      <description>CNP-HD-PLC</description>
+      <xref type="person" data="Ernst_EDER"/>
+      <controller><xref type="person" data="LonMark_International"/></controller>
+    </record>
+    <record date="2019-01-17">
+      <addr>224.0.2.13</addr>
+      <description>BSE</description>
+      <xref type="person" data="Rami_Chalhoub"/>
+      <controller><xref type="person" data="BSE"/></controller>
+    </record>
+    <record date="2019-08-19">
+      <addr>224.0.2.14</addr>
+      <description>OPC Discovery</description>
+      <xref type="person" data="OPC_Foundation"/>
+      <controller><xref type="person" data="OPC_Foundation"/></controller>
+    </record>
+    <record>
+      <addr>224.0.2.15-224.0.2.63</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1996-04" updated="2018-04-20">
+      <addr>224.0.2.64-224.0.2.95</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+      <reviewed>2007-07</reviewed>
+    </record>
+    <record date="1997-07-01">
+      <addr>224.0.2.96-224.0.2.127</addr>
+      <description>BallisterNet</description>
+      <xref type="person" data="Tom_Ballister"/>
+    </record>
+    <record date="1997-02-01">
+      <addr>224.0.2.128-224.0.2.191</addr>
+      <description>WOZ-Garage</description>
+      <xref type="person" data="Douglas_Marquardt"/>
+    </record>
+    <record date="1997-02-01" updated="2018-04-20">
+      <addr>224.0.2.192-224.0.2.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record>
+      <addr>224.0.3.0-224.0.3.255</addr>
+      <description>RFE Generic Service</description>
+      <xref type="person" data="Daniel_Steinber"/>
+    </record>
+    <record>
+      <addr>224.0.4.0-224.0.4.255</addr>
+      <description>RFE Individual Conferences</description>
+      <xref type="person" data="Daniel_Steinber"/>
+    </record>
+    <record>
+      <addr>224.0.5.0-224.0.5.127</addr>
+      <description>CDPD Groups</description>
+      <xref type="text">[Bob Brenner]</xref>
+    </record>
+    <record date="1998-10-01" updated="2018-04-20">
+      <addr>224.0.5.128-224.0.5.191</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2001-08-01" updated="2018-04-20">
+      <addr>224.0.5.192-224.0.5.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record>
+      <addr>224.0.6.0-224.0.6.127</addr>
+      <description>Cornell ISIS Project</description>
+      <xref type="text">[Tim Clark]</xref>
+    </record>
+    <record date="2009-09-24">
+      <addr>224.0.6.128-224.0.6.143</addr>
+      <description>MoeSingh</description>
+      <xref type="person" data="Moe_Singh"/>
+    </record>
+    <record date="2018-01-03" updated="2018-01-31">
+      <addr>224.0.6.144</addr>
+      <description>QDNE</description>
+      <xref type="person" data="Architecture_Team"/>
+    </record>
+    <record>
+      <addr>224.0.6.145-224.0.6.150</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2014-08-01">
+      <addr>224.0.6.151</addr>
+      <description>Canon-Device-control</description>
+      <xref type="person" data="Hiroshi_Okubo"/>
+    </record>
+    <record>
+      <addr>224.0.6.152-224.0.6.191</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2014-09-19">
+      <addr>224.0.6.192-224.0.6.255</addr>
+      <description>OneChicago multicast</description>
+      <xref type="person" data="Brian_Trudeau"/>
+    </record>
+    <record date="1994-11-01">
+      <addr>224.0.7.0-224.0.7.255</addr>
+      <description>Where-Are-You</description>
+      <xref type="person" data="Bill_Simpson"/>
+    </record>
+    <record date="2017-10-13" updated="2017-10-19">
+      <addr>224.0.8.0</addr>
+      <description>Cell broadcast encapsulation</description>
+      <xref type="person" data="Meridian_Labs_LTD"/>
+      <xref type="person" data="LIRNEasia"/>
+    </record>
+    <record>
+      <addr>224.0.8.1-224.0.8.255</addr>
+      <description>Unassigned</description>
+    </record>
+    
+    <record date="1998-04-01">
+      <addr>224.0.9.0-224.0.9.255</addr>
+      <description>The Thing System</description>
+      <xref type="person" data="Carl_Malamud"/>
+    </record>
+    <record date="1996-04-01">
+      <addr>224.0.10.0-224.0.10.255</addr>
+      <description>DLSw Groups</description>
+      <xref type="person" data="Choon_Lee"/>
+    </record>
+    <record date="1996-08-01">
+      <addr>224.0.11.0-224.0.11.255</addr>
+      <description>NCC.NET Audio</description>
+      <xref type="person" data="David_Rubin"/>
+    </record>
+    <record date="1996-11-01">
+      <addr>224.0.12.0-224.0.12.63</addr>
+      <description>Microsoft and MSNBC</description>
+      <xref type="person" data="Tom_Blank"/>
+    </record>
+    <record>
+      <addr>224.0.12.64-224.0.12.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.13.0-224.0.13.255</addr>
+      <description>WorldCom Broadcast Services</description>
+      <xref type="person" data="Tony_Barber"/>
+    </record>
+    <record date="1997-02-01">
+      <addr>224.0.14.0-224.0.14.255</addr>
+      <description>NLANR</description>
+      <xref type="person" data="Duane_Wessels"/>
+    </record>
+    <record date="1997-02-01" updated="2015-10-12">
+      <addr>224.0.15.0-224.0.15.255</addr>
+      <description>Agilent Technologies</description>
+      <xref type="person" data="IP_Admin"/>
+    </record>
+    <record date="1997-04-01">
+      <addr>224.0.16.0-224.0.16.255</addr>
+      <description>XingNet</description>
+      <xref type="person" data="Mika_Uusitalo"/>
+    </record>
+    <record date="1997-07-01">
+      <addr>224.0.17.0-224.0.17.31</addr>
+      <description>Mercantile &amp; Commodity Exchange</description>
+      <xref type="person" data="Asad_Gilani"/>
+    </record>
+    <record date="1999-03-01">
+      <addr>224.0.17.32-224.0.17.63</addr>
+      <description>NDQMD1</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="1999-03-01">
+      <addr>224.0.17.64-224.0.17.127</addr>
+      <description>ODN-DTV</description>
+      <xref type="person" data="Richard_Hodges"/>
+    </record>
+    <record>
+      <addr>224.0.17.128-224.0.17.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1997-01-01">
+      <addr>224.0.18.0-224.0.18.255</addr>
+      <description>Dow Jones</description>
+      <xref type="person" data="Wenjie_Peng"/>
+    </record>
+    <record date="1997-08-01">
+      <addr>224.0.19.0-224.0.19.63</addr>
+      <description>Walt Disney Company</description>
+      <xref type="person" data="Scott_Watson"/>
+    </record>
+    <record date="1997-10-01">
+      <addr>224.0.19.64-224.0.19.95</addr>
+      <description>Cal Multicast</description>
+      <xref type="person" data="Ed_Moran"/>
+    </record>
+    <record date="1997-10" updated="2018-04-20">
+      <addr>224.0.19.96-224.0.19.127</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+      <reviewed>2007-07</reviewed>
+    </record>
+    <record date="1997-12-01">
+      <addr>224.0.19.128-224.0.19.191</addr>
+      <description>IIG Multicast</description>
+      <xref type="person" data="Wayne_Carr"/>
+    </record>
+    <record date="1998-05-01">
+      <addr>224.0.19.192-224.0.19.207</addr>
+      <description>Metropol</description>
+      <xref type="person" data="James_Crawford"/>
+    </record>
+    <record date="1998-07-01">
+      <addr>224.0.19.208-224.0.19.239</addr>
+      <description>Xenoscience, Inc.</description>
+      <xref type="person" data="Mary_Timm"/>
+    </record>
+    <record date="2007-03-01">
+      <addr>224.0.19.240-224.0.19.255</addr>
+      <description>MJDPM</description>
+      <xref type="person" data="Matthew_Straight"/>
+    </record>
+    <record date="1998-07-01">
+      <addr>224.0.20.0-224.0.20.63</addr>
+      <description>MS-IP/TV</description>
+      <xref type="person" data="Tony_Wong"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.20.64-224.0.20.127</addr>
+      <description>Reliable Network Solutions</description>
+      <xref type="person" data="Werner_Vogels"/>
+    </record>
+    <record date="1998-08-01">
+      <addr>224.0.20.128-224.0.20.143</addr>
+      <description>TRACKTICKER Group</description>
+      <xref type="person" data="Alan_Novick"/>
+    </record>
+    <record date="1999-08-01">
+      <addr>224.0.20.144-224.0.20.207</addr>
+      <description>CNR Rebroadcast MCA</description>
+      <xref type="person" data="Robert_Sautter"/>
+    </record>
+    <record>
+      <addr>224.0.20.208-224.0.20.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1999-01-01">
+      <addr>224.0.21.0-224.0.21.127</addr>
+      <description>Talarian MCAST</description>
+      <xref type="person" data="Geoff_Mendal"/>
+    </record>
+    <record>
+      <addr>224.0.21.128-224.0.21.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="1999-06-01">
+      <addr>224.0.22.0-224.0.22.239</addr>
+      <description>WORLD MCAST</description>
+      <xref type="person" data="Ian_Stewart"/>
+    </record>
+    <record date="2007-10-31">
+      <addr>224.0.22.240-224.0.22.255</addr>
+      <description>Jones International</description>
+      <xref type="person" data="Jim_Ginsburg"/>
+    </record>
+    <record date="2003-02-01">
+      <addr>224.0.23.0</addr>
+      <description>ECHONET</description>
+      <xref type="person" data="Takeshi_Saito"/>
+    </record>
+    <record date="2003-02-01">
+      <addr>224.0.23.1</addr>
+      <description>Ricoh-device-ctrl</description>
+      <xref type="person" data="Akihiro_Nishida"/>
+    </record>
+    <record date="2003-02-01">
+      <addr>224.0.23.2</addr>
+      <description>Ricoh-device-ctrl</description>
+      <xref type="person" data="Akihiro_Nishida"/>
+    </record>
+    <record date="2003-04-01">
+      <addr>224.0.23.3-224.0.23.10</addr>
+      <description>Telefeed</description>
+      <xref type="person" data="Wally_Beddoe"/>
+    </record>
+    <record date="2003-05-01">
+      <addr>224.0.23.11</addr>
+      <description>SpectraTalk</description>
+      <xref type="person" data="Madhav_Karhade"/>
+    </record>
+    <record date="2003-07-01">
+      <addr>224.0.23.12</addr>
+      <description>EIBnet/IP</description>
+      <xref type="person" data="Marc_Goossens"/>
+    </record>
+    <record date="2003-10-01">
+      <addr>224.0.23.13</addr>
+      <description>TVE-ANNOUNCE2</description>
+      <xref type="person" data="Michael_Dolan"/>
+    </record>
+    <record date="2004-01-01">
+      <addr>224.0.23.14</addr>
+      <description>DvbServDisc</description>
+      <xref type="person" data="Bert_van_Willigen"/>
+    </record>
+    <record date="2007-03-01">
+      <addr>224.0.23.15-224.0.23.31</addr>
+      <description>MJDPM</description>
+      <xref type="person" data="Matthew_Straight"/>
+    </record>
+    <record date="2004-02-01">
+      <addr>224.0.23.32</addr>
+      <description>Norman MCMP</description>
+      <xref type="person" data="Kristian_A_Bognaes"/>
+    </record>
+    <record date="2004-06-01">
+      <addr>224.0.23.33</addr>
+      <description>RRDP</description>
+      <xref type="person" data="Tetsuo_Hoshi"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.34</addr>
+      <description>AF_NA</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.35</addr>
+      <description>AF_OPRA_NBBO</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.36</addr>
+      <description>AF_OPRA_FULL</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.37</addr>
+      <description>AF_NEWS</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.38</addr>
+      <description>AF_NA_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.39</addr>
+      <description>AF_OPRA_NBBO_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.40</addr>
+      <description>AF_OPRA_FULL_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.41</addr>
+      <description>AF_NEWS_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-02-01">
+      <addr>224.0.23.42</addr>
+      <description>Control for IP Video</description>
+      <xref type="person" data="Nadine_Guillaume"/>
+    </record>
+    <record date="2005-02-01">
+      <addr>224.0.23.43</addr>
+      <description>acp-discovery</description>
+      <xref type="person" data="Andy_Belk"/>
+    </record>
+    <record date="2005-02-01">
+      <addr>224.0.23.44</addr>
+      <description>acp-management</description>
+      <xref type="person" data="Andy_Belk"/>
+    </record>
+    <record date="2005-02-01">
+      <addr>224.0.23.45</addr>
+      <description>acp-data</description>
+      <xref type="person" data="Andy_Belk"/>
+    </record>
+    <record date="2006-06-16" updated="2015-04-23">
+      <addr>224.0.23.46</addr>
+      <description>dof-multicast</description>
+      <xref type="person" data="Bryant_Eastham"/>
+      <reviewed>2015-04-23</reviewed>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.47</addr>
+      <description>AF_DOB_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.48</addr>
+      <description>AF_OPRA_FULL2_CHI</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.49</addr>
+      <description>AF_DOB</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2005-10-28">
+      <addr>224.0.23.50</addr>
+      <description>AF_OPRA_FULL2</description>
+      <xref type="person" data="Bob_Brzezinski"/>
+    </record>
+    <record date="2006-08-07">
+      <addr>224.0.23.51</addr>
+      <description>Fairview</description>
+      <xref type="person" data="Jim_Lyle"/>
+    </record>
+    <record date="2006-08-11" updated="2018-04-20">
+      <addr>224.0.23.52</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2006-11-30">
+      <addr>224.0.23.53</addr>
+      <description>MCP</description>
+      <xref type="person" data="Tim_DeBaillie"/>
+    </record>
+    <record date="2007-01-17">
+      <addr>224.0.23.54</addr>
+      <description>ServDiscovery</description>
+      <xref type="person" data="Paul_Langille"/>
+    </record>
+    <record date="2008-02-04">
+      <addr>224.0.23.55</addr>
+      <description>noaaport1</description>
+      <xref type="person" data="Antonio_Querubin"/>
+    </record>
+    <record date="2008-02-04">
+      <addr>224.0.23.56</addr>
+      <description>noaaport2</description>
+      <xref type="person" data="Antonio_Querubin"/>
+    </record>
+    <record date="2008-02-04">
+      <addr>224.0.23.57</addr>
+      <description>noaaport3</description>
+      <xref type="person" data="Antonio_Querubin"/>
+    </record>
+    <record date="2008-02-04">
+      <addr>224.0.23.58</addr>
+      <description>noaaport4</description>
+      <xref type="person" data="Antonio_Querubin"/>
+    </record>
+    <record date="2008-02-22">
+      <addr>224.0.23.59</addr>
+      <description>DigacIP7</description>
+      <xref type="person" data="Jonathan_Niedfeldt"/>
+    </record>
+    <record date="2008-12-19">
+      <addr>224.0.23.60</addr>
+      <description>AtscSvcSig</description>
+      <xref type="person" data="Jerry_Whitaker"/>
+    </record>
+    <record date="2009-03-13">
+      <addr>224.0.23.61</addr>
+      <description>SafetyNET p (potentially IGMPv1)</description>
+      <xref type="person" data="Pilz"/>
+    </record>
+    <record date="2009-05-12">
+      <addr>224.0.23.62</addr>
+      <description>BluemoonGamesMC</description>
+      <xref type="person" data="Christopher_Mettin"/>
+    </record>
+    <record date="2009-05-12">
+      <addr>224.0.23.63</addr>
+      <description>iADT Discovery</description>
+      <xref type="person" data="Paul_Suhler"/>
+    </record>
+    <record date="2004-01-01">
+      <addr>224.0.23.64-224.0.23.80</addr>
+      <description>Moneyline</description>
+      <xref type="person" data="Guido_Petronio"/>
+    </record>
+    <record>
+      <addr>224.0.23.81-224.0.23.127</addr>
+      <description>Reserved (Moneyline)</description>
+    </record>
+    <record date="2004-01-01">
+      <addr>224.0.23.128-224.0.23.157</addr>
+      <description>PHLX</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record date="2005-09-01">
+      <addr>224.0.23.158</addr>
+      <description>VSCP</description>
+      <xref type="person" data="Charles_Tewiah"/>
+    </record>
+    <record date="2005-11-04">
+      <addr>224.0.23.159</addr>
+      <description>LXI-EVENT</description>
+      <xref type="person" data="Nick_Barendt"/>
+    </record>
+    <record date="2006-02-09">
+      <addr>224.0.23.160</addr>
+      <description>solera_lmca</description>
+      <xref type="person" data="Mark_Armstrong"/>
+    </record>
+    <record date="2006-03-17">
+      <addr>224.0.23.161</addr>
+      <description>VBooster</description>
+      <xref type="person" data="Alexander_Pevzner"/>
+    </record>
+    <record date="2006-03-17">
+      <addr>224.0.23.162</addr>
+      <description>cajo discovery</description>
+      <xref type="person" data="John_Catherino"/>
+    </record>
+    <record date="2006-03-31">
+      <addr>224.0.23.163</addr>
+      <description>INTELLIDEN</description>
+      <xref type="person" data="Jeff_Schenk"/>
+    </record>
+    <record date="2006-07-11">
+      <addr>224.0.23.164</addr>
+      <description>IceEDCP</description>
+      <xref type="person" data="Oliver_Lewis"/>
+    </record>
+    <record date="2006-07-11">
+      <addr>224.0.23.165</addr>
+      <description>omasg</description>
+      <xref type="person" data="Mark_Lipford"/>
+    </record>
+    <record date="2006-08-15">
+      <addr>224.0.23.166</addr>
+      <description>MEDIASTREAM</description>
+      <xref type="person" data="Maurice_Robberson"/>
+    </record>
+    <record date="2006-08-21">
+      <addr>224.0.23.167</addr>
+      <description>Systech Mcast</description>
+      <xref type="person" data="Dan_Jakubiec"/>
+    </record>
+    <record date="2007-07-06">
+      <addr>224.0.23.168</addr>
+      <description>tricon-system-management</description>
+      <xref type="person" data="John_Gabler"/>
+    </record>
+    <record date="2008-01-14">
+      <addr>224.0.23.169</addr>
+      <description>MNET discovery</description>
+      <xref type="person" data="Andy_Crick"/>
+    </record>
+    <record date="2009-09-24">
+      <addr>224.0.23.170</addr>
+      <description>CCNx (not for global routing)</description>
+      <xref type="person" data="Simon_Barber"/>
+    </record>
+    <record date="2009-11-11">
+      <addr>224.0.23.171</addr>
+      <description>LLAFP</description>
+      <xref type="person" data="Michael_Lyle"/>
+    </record>
+    <record date="2010-02-04" updated="2019-07-01">
+      <addr>224.0.23.172</addr>
+      <description>UFMP</description>
+      <xref type="person" data="Shachar_Dor"/>
+      <controller>
+        <xref type="person" data="Mellanox"/>
+      </controller>
+    </record>
+    <record date="2010-02-26" updated="2019-02-07">
+      <addr>224.0.23.173</addr>
+      <description>PHILIPS-HEALTH</description>
+      <xref type="person" data="Mike_King"/>
+      <controller><xref type="person" data="Philips_Healthcare"/></controller>
+    </record>
+    <record date="2010-02-26" updated="2019-02-07">
+      <addr>224.0.23.174</addr>
+      <description>PHILIPS-HEALTH</description>
+      <xref type="person" data="Mike_King"/>
+      <controller><xref type="person" data="Philips_Healthcare"/></controller>
+    </record>
+    <record date="2010-03-12">
+      <addr>224.0.23.175</addr>
+      <description>QDP</description>
+      <xref type="person" data="Kevin_Gross"/>
+    </record>
+    <record date="2011-06-06">
+      <addr>224.0.23.176</addr>
+      <description>CalAmp WCP</description>
+      <xref type="person" data="Pierre_Oliver"/>
+    </record>
+    <record date="2012-08-28">
+      <addr>224.0.23.177</addr>
+      <description>AES discovery</description>
+      <xref type="person" data="Kevin_Gross_2"/>
+    </record>    
+    <record date="2013-02-08">
+      <addr>224.0.23.178</addr>
+      <description>JDP Java Discovery Protocol</description>
+      <xref type="person" data="Florian_Weimer"/>
+    </record>
+    <record date="2014-06-04">
+      <addr>224.0.23.179</addr>
+      <description>PixelPusher</description>
+      <xref type="person" data="Jasmine_Strong"/>
+    </record>
+    <record date="2014-12-17">
+      <addr>224.0.23.180</addr>
+      <description>network metronome</description>
+      <xref type="person" data="George_Neville-Neil"/>
+    </record>
+    <record date="2016-04-19">
+      <addr>224.0.23.181</addr>
+      <description>polaris-video-transport</description>
+      <xref type="person" data="Geoff_Golder"/>
+    </record>
+    <record>
+      <addr>224.0.23.182-224.0.23.191</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2008-08-12">
+      <addr>224.0.23.192-224.0.23.255</addr>
+      <description>PINKOTC</description>
+      <xref type="person" data="Sergey_Shulgin"/>
+    </record>
+    <record date="2006-06-09">
+      <addr>224.0.24.0-224.0.24.127</addr>
+      <description>AGSC UK VVs</description>
+      <xref type="person" data="Andrew_Rowley"/>
+    </record>
+    <record date="2006-08-07">
+      <addr>224.0.24.128-224.0.24.255</addr>
+      <description>EM-MULTI</description>
+      <xref type="person" data="Soren_Martin_Sorensen"/>
+    </record>
+    <record date="2007-03-22">
+      <addr>224.0.25.0-224.0.28.255</addr>
+      <description>CME Market Data</description>
+      <xref type="person" data="Sarunas_Brakauskas"/>
+    </record>
+    <record date="2007-03-22">
+      <addr>224.0.29.0-224.0.30.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Jan_Drwal"/>
+    </record>
+    <record date="2007-07-17">
+      <addr>224.0.31.0-224.0.34.255</addr>
+      <description>CME Market Data</description>
+      <xref type="person" data="Sarunas_Brakauskas"/>
+    </record>
+    <record date="2007-08-31">
+      <addr>224.0.35.0-224.0.35.255</addr>
+      <description>M2S</description>
+      <xref type="person" data="Itamar_Gilad"/>
+    </record>
+    <record date="2016-09-29">
+      <addr>224.0.36.0-224.0.36.255</addr>
+      <description>DigiPlay</description>
+      <xref type="person" data="Robert_Taylor"/>
+    </record>
+    <record date="2017-03-24">
+      <addr>224.0.37.0-224.0.38.255</addr>
+      <description>LME OMD Addressing</description>
+      <xref type="person" data="Johnathan_Ryder"/>
+    </record>
+    <record date="2007-09-12">
+      <addr>224.0.39.0-224.0.40.255</addr>
+      <description>CDAS</description>
+      <xref type="person" data="Oyvind_H_Olsen"/>
+    </record>
+    <record date="2007-11-28" updated="2018-04-20">
+      <addr>224.0.41.0-224.0.41.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+      <reviewed>2011-02-15</reviewed>
+    </record>
+    <record date="2008-01-15" updated="2020-01-21">
+      <addr>224.0.42.0-224.0.45.255</addr>
+      <description>SINERGIYA</description>
+      <xref type="person" data="SINERGIYA_Ltd."/>
+      <controller><xref type="person" data="SINERGIYA_Ltd."/></controller>
+    </record>
+    <record date="2008-01-25">
+      <addr>224.0.46.0-224.0.50.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Jan_Drwal"/>
+    </record>
+    <record date="2008-04-09" updated="2018-02-20">
+      <addr>224.0.51.0-224.0.51.255</addr>
+      <description>ALCOM-IPTV</description>
+      <xref type="person" data="TV_System_Administrators"/>
+      <controller><xref type="person" data="Ålands_Telekommunikation_Ab"/></controller>
+      <reviewed>2018-02-20</reviewed>
+    </record>
+    <record date="2008-07-23" updated="2014-11-24">
+      <addr>224.0.52.0-224.0.53.255</addr>
+      <description>Euronext</description>
+      <xref type="person" data="Euronext_Admin"/>
+      <reviewed>2014-11-24</reviewed>
+    </record>
+    <record date="2008-08-20" updated="2019-08-29">
+      <addr>224.0.54.0-224.0.57.255</addr>
+      <description>Telia Norway mcast</description>
+      <xref type="person" data="Henrik_Lans"/>
+      <controller>
+        <xref type="person" data="Telia-Norway-Get-NOC"/>
+      </controller>
+    </record>
+    <record date="2008-08-27" updated="2018-04-20">
+      <addr>224.0.58.0-224.0.61.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2008-12-24">
+      <addr>224.0.62.0-224.0.62.255</addr>
+      <description>BATS</description>
+      <xref type="person" data="Andrew_Brown"/>
+    </record>
+    <record date="2009-03-13">
+      <addr>224.0.63.0-224.0.63.255</addr>
+      <description>BATS Trading</description>
+      <xref type="person" data="Tim_Gorsline"/>
+    </record>
+    <record date="2009-03-13" updated="2014-11-24">
+      <addr>224.0.64.0-224.0.67.255</addr>
+      <description>Euronext</description>
+      <xref type="person" data="Euronext_Admin"/>
+      <reviewed>2014-11-24</reviewed>
+    </record>
+    <record date="2009-05-12" updated="2016-05-06">
+      <addr>224.0.68.0-224.0.69.255</addr>
+      <description>ISE</description>
+      <xref type="person" data="ISE-Networks"/>
+    </record>
+    <record date="2009-06-16" updated="2018-04-20">
+      <addr>224.0.70.0-224.0.71.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+      <reviewed>2011-03-01</reviewed>
+    </record>
+    <record date="2009-08-28">
+      <addr>224.0.72.0-224.0.72.255</addr>
+      <description>TMX</description>
+      <xref type="person" data="Michael_Caravetta"/>
+      <xref type="person" data="Boris_Garber"/>
+    </record>
+    <record date="2009-08-28">
+      <addr>224.0.73.0-224.0.74.255</addr>
+      <description>Direct Edge</description>
+      <xref type="person" data="Javier_Landin"/>
+    </record>
+    <record date="2010-01-22" updated="2016-05-06">
+      <addr>224.0.75.0-224.0.75.255</addr>
+      <description>ISE</description>
+      <xref type="person" data="ISE-Networks"/>
+    </record>
+    <record date="2010-02-26" updated="2018-04-20">
+      <addr>224.0.76.0-224.0.76.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+      <reviewed>2011-03-01</reviewed>
+    </record>
+    <record date="2010-02-26" updated="2018-04-20">
+      <addr>224.0.77.0-224.0.77.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2010-03-12" updated="2018-02-20">
+      <addr>224.0.78.0-224.0.78.255</addr>
+      <description>ALCOM-IPTV</description>
+      <xref type="person" data="TV_System_Administrators"/>
+      <controller><xref type="person" data="Ålands_Telekommunikation_Ab"/></controller>
+      <reviewed>2018-02-20</reviewed>
+    </record>
+    <record date="2010-08-24" updated="2016-05-06">
+      <addr>224.0.79.0-224.0.81.255</addr>
+      <description>ISE</description>
+      <xref type="person" data="ISE-Networks"/>
+    </record>
+    <record date="2011-01-31" updated="2017-06-23">
+      <addr>224.0.82.0-224.0.85.255</addr>
+      <description>BATS Trading</description>
+      <xref type="person" data="BATS_Europe_NOC"/>
+    </record>
+    <record date="2011-02-10" updated="2018-04-20">
+      <addr>224.0.86.0-224.0.101.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2011-04-13" updated="2018-04-20">
+      <addr>224.0.102.0-224.0.102.127</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2014-06-12">
+      <addr>224.0.102.128-224.0.102.255</addr>
+      <description>MVS-IPTV-2</description>
+      <xref type="person" data="Midwest_Video_Solutions"/>
+      <controller>
+        <xref type="person" data="Midwest_Video_Solutions"/>
+      </controller>
+    </record>
+    <record date="2011-04-20">
+      <addr>224.0.103.0-224.0.104.255</addr>
+      <description>MVS-IPTV</description>
+      <xref type="person" data="Midwest_Video_Solutions"/>
+      <xref type="person" data="Adam_DeMinter"/>
+      <controller>
+        <xref type="person" data="Midwest_Video_Solutions"/>
+      </controller>
+    </record>
+    <record date="2011-06-06" updated="2018-08-01">
+      <addr>224.0.105.0-224.0.105.127</addr>
+      <description>MIAX Multicast</description>
+      <xref type="person" data="Gamini_Karunaratne"/>
+      <controller><xref type="person" data="MIAX"/></controller>
+    </record>
+    <record date="2017-12-04">
+      <addr>224.0.105.128-224.0.105.255</addr>
+      <description>MVS-IPTV3</description>
+      <xref type="person" data="Justin_Beaman"/>
+      <controller>
+        <xref type="person" data="Midwest_Video_Solutions"/>
+      </controller>
+    </record>
+    <record date="2011-06-16">
+      <addr>224.0.106.0-224.0.106.255</addr>
+      <description>TMX</description>
+      <xref type="person" data="Michael_Caravetta"/>
+      <xref type="person" data="Boris_Garber"/>
+    </record>
+    <record date="2011-07-13">
+      <addr>224.0.107.0-224.0.108.255</addr>
+      <description>Alpha Group</description>
+      <xref type="person" data="Zaklina_Petkovic"/>
+    </record>
+    <record date="2011-10-25">
+      <addr>224.0.109.0-224.0.110.255</addr>
+      <description>Zaklina_Petkovic</description>
+      <xref type="person" data="David_Brett"/>
+    </record>
+    <record date="2011-10-25" updated="2019-10-01"> 
+      <addr>224.0.111.0-224.0.111.255</addr>
+      <description>VoleraDataFeed</description>
+      <xref type="person" data="Gerald_Hanweck"/>
+      <controller>
+        <xref type="person" data="Hanweck_Associates"/>
+      </controller>
+    </record>
+    <record date="2011-12-07">
+      <addr>224.0.112.0-224.0.112.255</addr>
+      <description>JHB-STOCK-EXCH</description>
+      <xref type="person" data="Clem_Verwey"/>
+    </record>
+    <record date="2011-12-19">
+      <addr>224.0.113.0-224.0.114.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Jan_Drwal"/>
+    </record>
+    <record date="2012-06-12">
+      <addr>224.0.115.0-224.0.115.255</addr>
+      <description>TMX</description>
+      <xref type="person" data="Michael_Caravetta"/>
+      <xref type="person" data="Boris_Garber"/>
+    </record>
+    <record date="2012-06-19" updated="2018-04-20">
+      <addr>224.0.116.0-224.0.116.255</addr>
+      <description>Intercontinental Exchange, Inc</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2012-07-12" updated="2016-05-06">
+      <addr>224.0.117.0-224.0.119.255</addr>
+      <description>ISE</description>
+      <xref type="person" data="ISE-Networks"/>
+    </record>
+    <record date="2013-01-15">
+      <addr>224.0.120.0-224.0.120.255</addr>
+      <description>czechbone iptv</description>
+      <xref type="person" data="Jan_Vitek"/>
+    </record>    
+    <record date="2013-05-13" updated="2019-08-28">
+      <addr>224.0.121.0-224.0.121.255</addr>
+      <description>AQUIS-EXCHANGE</description>
+      <xref type="person" data="Paul_Roberts"/>
+      <controller>
+        <xref type="person" data="Aquis_Exchange_PLC"/>
+      </controller>
+    </record>    
+    <record date="2013-05-25">
+      <addr>224.0.122.0-224.0.123.255</addr>
+      <description>DNS:NET TV</description>
+      <xref type="person" data="Marlon_Berlin"/>
+    </record>    
+    <record date="2013-05-30">
+      <addr>224.0.124.0-224.0.124.255</addr>
+      <description>Boston Options Exchange</description>
+      <xref type="person" data="David_Wilson"/>
+      <xref type="person" data="Michael_Caravetta_2"/>
+    </record>    
+    <record date="2013-09-05" updated="2019-10-01">
+      <addr>224.0.125.0-224.0.125.255</addr>
+      <description>Hanweck Associates</description>
+      <xref type="person" data="Gerald_Hanweck"/>
+      <controller>
+        <xref type="person" data="Hanweck_Associates"/>
+      </controller>
+    </record>
+    <record date="2013-10-31" updated="2018-04-20">
+      <addr>224.0.126.0-224.0.129.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2014-03-05">
+      <addr>224.0.130.0-224.0.131.255</addr>
+      <description>BATS Trading</description>
+      <xref type="person" data="Andrew_Brown"/>
+    </record>
+    <record date="2014-04-12">
+      <addr>224.0.132.0-224.0.135.255</addr>
+      <description>Net By Net Holding IPTV</description>
+      <xref type="person" data="Lev_V._Cherednikov"/>
+    </record>
+    <record date="2014-05-16">
+      <addr>224.0.136.0-224.0.139.255</addr>
+      <description>Aequitas Innovations Inc.</description>
+      <xref type="person" data="Zaklina_Petkovic_2"/>
+    </record>
+    <record date="2014-09-04" updated="2019-08-29">
+      <addr>224.0.140.0-224.0.140.255</addr>
+      <description>Instinet</description>
+      <xref type="person" data="Instinet"/>
+      <controller>
+        <xref type="person" data="Instinet"/>
+      </controller>
+    </record>
+    <record date="2015-06-30" updated="2018-08-01">
+      <addr>224.0.141.0-224.0.141.255</addr>
+      <description>MIAX-2</description>
+      <xref type="person" data="Gamini_Karunaratne"/>
+      <controller><xref type="person" data="MIAX"/></controller>
+    </record>
+    <record date="2017-05-19" updated="2018-08-01">
+      <addr>224.0.142.0-224.0.142.255</addr>
+      <description>MIAX M3</description>
+      <xref type="person" data="Gamini_Karunaratne"/>
+      <controller><xref type="person" data="MIAX"/></controller>
+    </record>
+    <record date="2017-06-02">
+      <addr>224.0.143.0-224.0.143.255</addr>
+      <description>A2X-EXCHANGE</description>
+      <xref type="person" data="Neal_Lawrence"/>
+    </record>
+    <record date="2015-03-23">
+      <addr>224.0.144.0-224.0.151.255</addr>
+      <description>VZ-Multicast-Public</description>
+      <xref type="person" data="Stephen_Ray_Middleton"/>
+    </record>
+    <record date="2016-04-19">
+      <addr>224.0.152.0-224.0.152.255</addr>
+      <description>cse-md</description>
+      <xref type="person" data="David_Brett_2"/>
+    </record>
+    <record date="2016-05-24" updated="2019-08-29">
+      <addr>224.0.153.0-224.0.156.255</addr>
+      <description>Telia Norway mcast</description>
+      <xref type="person" data="Henrik_Lans"/>
+      <controller>
+        <xref type="person" data="Telia-Norway-Get-NOC"/>
+      </controller>
+    </record>
+    <record date="2017-01-23">
+      <addr>224.0.157.0-224.0.157.255</addr>
+      <description>LME OMD Addressing</description>
+      <xref type="person" data="James_Williams"/>
+    </record>
+    <record date="2017-01-23">
+      <addr>224.0.158.0-224.0.159.255</addr>
+      <description>TriAct Canada Marketplace LP</description>
+      <xref type="person" data="Hatice_Unal"/>
+    </record>
+    <record date="2016-07-07">
+      <addr>224.0.160.0-224.0.165.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Bernd_Uphoff"/>
+    </record>
+    <record date="2017-02-17">
+      <addr>224.0.166.0-224.0.167.255</addr>
+      <description>Virgin Connect IPTV</description>
+      <xref type="person" data="Vladimir_Shishkov"/>
+    </record>
+    <record date="2017-12-05">
+      <addr>224.0.168.0-224.0.169.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Bernd_Uphoff"/>
+    </record>
+    <record date="2018-06-07">
+      <addr>224.0.170.0-224.0.170.255</addr>
+      <description>MVS-IPTV4</description>
+      <xref type="person" data="Justin_Beaman"/>
+      <controller>
+        <xref type="person" data="Midwest_Video_Solutions"/>
+      </controller>
+    </record>
+    <record date="2019-01-25">
+      <addr>224.0.171.0-224.0.171.255</addr>
+      <description>COINBASE-MARKETS</description>
+      <xref type="person" data="Gavin_McKee"/>
+      <controller><xref type="person" data="Coinbase"/></controller>
+    </record>
+    <record date="2018-06-19">
+      <addr>224.0.172.0-224.0.175.255</addr>
+      <description>Deutsche Boerse</description>
+      <xref type="person" data="Bernd_Uphoff"/>
+    </record>
+    <record date="2018-07-31">
+      <addr>224.0.176.0-224.0.179.255</addr>
+      <description>MIAX-EX-3-4-5</description>
+      <xref type="person" data="Gamini_Karunaratne"/>
+      <controller><xref type="person" data="MIAX"/></controller>
+    </record>
+    <record date="2019-02-13">
+      <addr>224.0.180.0-224.0.181.255</addr>
+      <description>CBOE Europe</description>
+      <xref type="person" data="Jason_Ives"/>
+      <controller><xref type="person" data="CBOE_Europe"/></controller>
+    </record>
+    <record date="2019-02-28">
+      <addr>224.0.182.0-224.0.183.255</addr>
+      <description>ALCOM-TV</description>
+      <xref type="person" data="TV_System_Administrators"/>
+      <controller><xref type="person" data="Ålands_Telekommunikation_Ab"/></controller>
+    </record>
+    <record date="2019-08-28">
+      <addr>224.0.184.0-224.0.184.255</addr>
+      <description>AQUIS-EXCHANGE</description>
+      <xref type="person" data="Paul_Roberts"/>
+      <controller>
+        <xref type="person" data="Aquis_Exchange_PLC"/>
+      </controller>
+    </record>
+    <record date="2019-09-12" updated="2019-10-01">
+      <addr>224.0.185.0-224.0.185.255</addr>
+      <description>Hanweck Associates</description>
+      <xref type="person" data="Svetlana_Kachintseva"/>
+      <controller>
+        <xref type="person" data="Hanweck_Associates"/>
+      </controller>
+    </record>
+    <record date="2019-10-02">
+      <addr>224.0.186.0-224.0.186.255</addr>
+      <description>BOX Options Market</description>
+      <xref type="person" data="Alexandre_Gomes"/>
+      <controller>
+        <xref type="person" data="BOX_TECHNOLOGY_CANADA_INC."/>
+      </controller>
+    </record>
+    <record date="2019-11-13">
+      <addr>224.0.187.0-224.0.188.255</addr>
+      <description>MVS-IPTV5</description>
+      <xref type="person" data="Justin_Beaman"/>
+      <controller>
+        <xref type="person" data="Midwest_Video_Solutions"/>
+      </controller>
+    </record>
+    <record>
+      <addr>224.0.189.0-224.0.249.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2009-09-01">
+      <addr>224.0.250.0-224.0.251.255</addr>
+      <description>KPN Broadcast Services</description>
+      <xref type="person" data="Ad_C_Spelt"/>
+      <xref type="person" data="KPN_IP_Office"/>
+    </record>
+    <record date="2005-08-01">
+      <addr>224.0.252.0-224.0.252.255</addr>
+      <description>KPN Broadcast Services</description>
+      <xref type="person" data="Ad_C_Spelt"/>
+      <xref type="person" data="KPN_IP_Office"/>
+    </record>
+    <record date="2005-08-01">
+      <addr>224.0.253.0-224.0.253.255</addr>
+      <description>KPN Broadcast Services</description>
+      <xref type="person" data="Ad_C_Spelt"/>
+      <xref type="person" data="KPN_IP_Office"/>
+    </record>
+    <record date="2006-03-31">
+      <addr>224.0.254.0-224.0.254.255</addr>
+      <description>Intelsat IPTV</description>
+      <xref type="person" data="Karl_Elad"/>
+      <reviewed>2011-02-22</reviewed>
+    </record>
+    <record date="2006-03-31">
+      <addr>224.0.255.0-224.0.255.255</addr>
+      <description>Intelsat IPTV</description>
+      <xref type="person" data="Karl_Elad"/>
+      <reviewed>2011-02-22</reviewed>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-4">
+    <title>RESERVED (224.1.0.0-224.1.255.255 (224.1/16))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <note>No new assignments are being made in this range for the time being.</note>
+    <record>
+      <addr>224.1.0.0-224.1.0.37</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+    <record date="2004-05-01">
+      <addr>224.1.0.38</addr>
+      <description>dantz</description>
+      <xref type="person" data="Richard_Zulch"/>
+    </record>
+    <record>
+      <addr>224.1.0.39-224.1.1.255</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+    <record date="2006-02-17" updated="2018-04-20">
+      <addr>224.1.2.0-224.1.2.255</addr>
+      <description>Intercontinental Exchange, Inc.</description>
+      <xref type="person" data="RIR_Admin"/>
+      <controller>
+        <xref type="person" data="Intercontinental_Exchange_Inc."/>
+      </controller>
+    </record>
+    <record date="2006-05-22">
+      <addr>224.1.3.0-224.1.4.255</addr>
+      <description>NOB Cross media facilities</description>
+      <xref type="person" data="Technicolor_NL_NOC"/>
+    </record>
+    <record>
+      <addr>224.1.5.0-224.1.255.255</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-5">
+    <title>SDP/SAP Block (224.2.0.0-224.2.255.255 (224.2/16))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <record>
+      <addr>224.2.0.0-224.2.127.253</addr>
+      <description>Multimedia Conference Calls</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.2.127.254</addr>
+      <description>SAPv1 Announcements</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.2.127.255</addr>
+      <description>SAPv0 Announcements (deprecated)</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+    <record>
+      <addr>224.2.128.0-224.2.255.255</addr>
+      <description>SAP Dynamic Assignments</description>
+      <xref type="person" data="Steve_Casner"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-6">
+    <title>AD-HOC Block II (224.3.0.0-224.4.255.255 (224.3/16, 224.4/16))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <registration_rule>Expert Review, IESG Approval, or Standards Action</registration_rule>
+    <record date="1999-03-01">
+      <addr>224.3.0.0-224.3.0.63</addr>
+      <description>Nasdaqmdfeeds  (re-new/March 2003)</description>
+      <xref type="person" data="Michael_Rosenberg"/>
+    </record>
+    <record>
+      <addr>224.3.0.64-224.3.255.255</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+    <record date="2006-03-31">
+      <addr>224.4.0.0-224.4.0.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Guy_Whitehouse"/>
+    </record>
+    <record date="2008-02-25">
+      <addr>224.4.1.0-224.4.1.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Greig_Saunders"/>
+    </record>
+    <record date="2008-02-29">
+      <addr>224.4.2.0-224.4.2.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Greig_Saunders"/>
+    </record>
+    <record date="2008-12-24">
+      <addr>224.4.3.0-224.4.4.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Greig_Saunders"/>
+    </record>
+    <record date="2009-05-12">
+      <addr>224.4.5.0-224.4.6.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Greig_Saunders"/>
+    </record>
+    <record date="2012-04-10">
+      <addr>224.4.7.0-224.4.7.255</addr>
+      <description>CBOE Holdings</description>
+      <xref type="person" data="John_Rittner"/>
+    </record>
+    <record date="2012-04-11" updated="2016-05-06">
+      <addr>224.4.8.0-224.4.9.255</addr>
+      <description>ISE</description>
+      <xref type="person" data="ISE-Networks"/>
+    </record>
+    <record date="2012-04-11">
+      <addr>224.4.10.0-224.4.13.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Tim_Johnson"/>
+    </record>
+    <record date="2018-01-04" updated="2018-01-05">
+      <addr>224.4.14.0-224.4.17.255</addr>
+      <description>London Stock Exchange</description>
+      <xref type="person" data="Aadhil_Abdul_Majeed"/>
+    </record>
+    <record>
+      <addr>224.4.18.0-224.4.255.255</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-7">
+  <title>RESERVED (224.5.0.0-224.251.255.255 (251 /16s))</title>
+  <xref type="rfc" data="rfc5771"/>
+  <record>
+  <addr>224.5.0.0-224.251.255.255</addr>
+  <description>Reserved</description>
+  <xref type="person" data="IANA"/>
+  </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-8">
+    <title>DIS Transient Groups 224.252.0.0-224.255.255.255 (224.252/14))</title>
+   <xref type="rfc" data="rfc2365"/>
+      <record>
+      <addr>224.252.0.0-224.255.255.255</addr>
+      <description>DIS Transient Groups</description>
+      <xref type="person" data="IANA"/>
+      <xref type="rfc" data="rfc2365"/>
+    </record>
+ </registry>
+
+  
+  <registry id="multicast-addresses-9">
+    <title>RESERVED (225.0.0.0-231.255.255.255 (7 /8s))</title>
+    <xref type="rfc" data="rfc5771"/>
+     <record>
+      <addr>225.0.0.0-231.255.255.255</addr>
+      <description>Reserved</description>
+       <xref type="person" data="IANA"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-10">
+    <title>Source-Specific Multicast Block (232.0.0.0-232.255.255.255 (232/8))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <note>Addresses within the 232.0.1.0-232.255.255.255 are dynamically
+allocated by hosts when needed <xref type="rfc" data="rfc4607"/></note>
+    <record>
+      <addr>232.0.0.0</addr>
+      <description>Reserved</description>
+      <xref type="rfc" data="rfc4607"/>
+    </record>
+    <record>
+      <addr>232.0.0.1-232.0.0.255</addr>
+      <description>Reserved for IANA allocation</description>
+      <xref type="rfc" data="rfc4607"/>
+    </record>
+    <record>
+      <addr>232.0.1.0-232.255.255.255</addr>
+      <description>Reserved for local host allocation</description>
+      <xref type="rfc" data="rfc4607"/>
+    </record>
+  </registry>
+  
+  
+ <registry id="glop">
+    <title>GLOP Block</title>
+    <xref type="rfc" data="rfc3180"/>
+    <record>
+      <addr>233.0.0.0-233.251.255.255</addr>
+      <description>GLOP Block</description>
+      <xref type="rfc" data="rfc3180"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-11">
+    <title>AD-HOC Block III (233.252.0.0-233.255.255.255 (233.252/14))</title>
+    <xref type="rfc" data="rfc5771"/>
+    <registration_rule>Expert Review, IESG Approval, or Standards Action</registration_rule>
+    <record date="2010-01-20">
+      <addr>233.252.0.0-233.252.0.255</addr>
+      <description>MCAST-TEST-NET</description>
+      <xref type="person" data="IANA"/>
+      <xref type="rfc" data="rfc5771"/>
+      <xref type="rfc" data="rfc6676"/>
+      <reviewed>2010-01-20</reviewed>
+    </record>
+    <record date="2010-08-12">
+      <addr>233.252.1.0-233.252.1.31</addr>
+      <description>Spryware</description>
+      <xref type="person" data="Kenneth_Felix"/>
+    </record>
+    <record>
+      <addr>233.252.1.32-233.252.1.255</addr>
+      <description>Unassigned</description>
+    </record>
+    <record date="2010-08-12">
+      <addr>233.252.2.0-233.252.7.255</addr>
+      <description>Tradition</description>
+      <xref type="person" data="Tradition_Network_Operations_and_Command_Center"/>
+    </record>
+    <record date="2010-08-12">
+      <addr>233.252.8.0-233.252.11.255</addr>
+      <description>BVMF_MKT_DATA</description>
+      <xref type="person" data="Roberto_Costa_Simoes"/>
+    </record>
+    <record date="2010-09-14">
+      <addr>233.252.12.0-233.252.13.255</addr>
+      <description>blizznet-tv-services</description>
+      <xref type="person" data="Paul_Wallner"/>
+    </record>
+    <record date="2016-09-27">
+      <addr>233.252.14.0-233.252.17.255</addr>
+      <description>BVMF_MKT_DATA_2</description>
+      <xref type="person" data="Guilherme_Longanezi"/>
+    </record>
+    <record>
+      <addr>233.252.18.0-233.255.255.255</addr>
+      <description>Unassigned</description>
+    </record>
+  </registry>
+  
+  <registry id="unicast-prefix-based">
+    <title>Unicast-Prefix-based IPv4 Multicast Addresses</title>
+    <xref type="rfc" data="rfc6034"/>
+    <record date="2010-08-11">
+      <addr>234.0.0.0-234.255.255.255</addr>
+      <description>Unicast-Prefix-based IPv4 Multicast Addresses</description>
+      <xref type="rfc" data="rfc6034"/>
+    </record>
+  </registry>
+
+  
+  <registry id="multicast-addresses-12">
+    <title>Scoped Multicast Ranges</title>
+    <xref type="rfc" data="rfc5771"/>
+    <record>
+      <addr>235.0.0.0-238.255.255.255</addr>
+      <description>Reserved</description>
+      <xref type="person" data="IANA"/>
+    </record>
+    <record date="1997-01-01">
+      <addr>239.0.0.0-239.255.255.255</addr>
+      <description>Organization-Local Scope</description>
+      <xref type="person" data="David_Meyer"/>
+      <xref type="rfc" data="rfc2365"/>
+    </record>
+  </registry>
+  
+  
+  <registry id="multicast-addresses-13">
+    <title>Relative Addresses used with Scoped Multicast Addresses</title>
+    <xref type="rfc" data="rfc5771"/>
+    <note>(*)  It is only appropriate to use these values in explicitly-
+configured experiments; they MUST NOT be shipped as defaults in
+implementations.  See <xref type="rfc" data="rfc3692"/> for details.
+
+These addresses are listed in the Domain Name Service under MCAST.NET
+and 224.IN-ADDR.ARPA.
+
+Note that when used on an Ethernet or IEEE 802 network, the 23
+low-order bits of the IP Multicast address are placed in the low-order
+23 bits of the Ethernet or IEEE 802 net multicast address
+1.0.94.0.0.0.  See the section on "IANA ETHERNET ADDRESS BLOCK".</note>
+    <record date="1998-12-01">
+      <relative>0</relative>
+      <description>SAP Session Announcement Protocol</description>
+      <xref type="person" data="Mark_Handley"/>
+    </record>
+    <record>
+      <relative>1</relative>
+      <description>MADCAP Protocol</description>
+      <xref type="rfc" data="rfc2730"/>
+    </record>
+    <record date="2001-12-01">
+      <relative>2</relative>
+      <description>SLPv2 Discovery</description>
+      <xref type="person" data="Erik_Guttman"/>
+    </record>
+    <record date="2000-06-01">
+      <relative>3</relative>
+      <description>MZAP</description>
+      <xref type="person" data="Dave_Thaler"/>
+    </record>
+    <record date="1999-08-01">
+      <relative>4</relative>
+      <description>Multicast Discovery of DNS Services</description>
+      <xref type="person" data="Bill_Manning"/>
+    </record>
+    <record date="2006-06-27">
+      <relative>5</relative>
+      <description>SSDP</description>
+      <xref type="person" data="UPnP_Forum"/>
+    </record>
+    <record date="1999-10-01">
+      <relative>6</relative>
+      <description>DHCP v4</description>
+      <xref type="person" data="Eric_Hall"/>
+    </record>
+    <record date="2000-07-01">
+      <relative>7</relative>
+      <description>AAP</description>
+      <xref type="person" data="Stephen_Hanna"/>
+    </record>
+    <record>
+      <relative>8</relative>
+      <description>MBUS</description>
+      <xref type="rfc" data="rfc3259"/>
+    </record>
+    <record date="2006-06-27">
+      <relative>9</relative>
+      <description>UPnP</description>
+      <xref type="person" data="UPnP_Forum"/>
+    </record>
+    <record>
+      <relative>10</relative>
+      <description>MCAST-TEST-NET-2</description>
+      <xref type="rfc" data="rfc6676"/>
+    </record>
+    <record>
+      <relative>11-252</relative>
+      <description>Reserved - To be assigned by the IANA</description>
+    </record>
+    <record>
+      <relative>253</relative>
+      <description>Reserved</description>
+    </record>
+    <record>
+      <relative>254</relative>
+      <description>RFC3692-style Experiment (*)</description>
+      <xref type="rfc" data="rfc4727"/>
+    </record>
+    <record>
+      <relative>255</relative>
+      <description>Reserved - To be assigned by the IANA</description>
+    </record>
+  </registry>
+
+  <people>
+    <person id="Aadhil_Abdul_Majeed">
+      <name>Aadhil Abdul Majeed</name>
+      <uri>mailto:aabdulmajeed&amp;lseg.com</uri>
+      <updated>2018-01-04</updated>
+    </person>
+    <person id="Ad_C_Spelt">
+      <name>Ad C. Spelt</name>
+      <uri>mailto:a.c.spelt&amp;kpn.com</uri>
+      <updated>2009-09-01</updated>
+    </person>
+    <person id="Adam_DeMinter">
+      <name>Adam DeMinter</name>
+      <uri>mailto:adam.deminter&amp;mwt.net</uri>
+      <updated>2011-04-20</updated>
+    </person>
+    <person id="Adam_Yellen">
+      <name>Adam Yellen</name>
+      <uri>mailto:adam&amp;videofurnace.com</uri>
+      <updated>2009-08-12</updated>
+    </person>
+    <person id="Akihiro_Nishida">
+      <name>Akihiro Nishida</name>
+      <uri>mailto:nishida&amp;src.ricoh.co.jp</uri>
+      <updated>2003-02-01</updated>
+    </person>
+    <person id="Alan_Novick">
+      <name>Alan Novick</name>
+      <uri>mailto:anovick&amp;tdc.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Alan_Robertson">
+      <name>Alan Robertson</name>
+      <uri>mailto:alanr&amp;unix.sh</uri>
+      <updated>2012-04-17</updated>
+    </person>
+    <person id="Ålands_Telekommunikation_Ab">
+      <name>Ålands Telekommunikation Ab</name>
+      <uri>mailto:tv-noc&amp;alcom.ax</uri>
+      <updated>2019-02-28</updated>
+    </person>
+    <person id="Alex_Lee">
+      <name>Alex Lee</name>
+      <uri>mailto:alex_mrlee&amp;gemtek.com.tw</uri>
+      <updated>2002-10-01</updated>
+    </person>
+    <person id="Alexander_Pevzner">
+      <name>Alexander Pevzner</name>
+      <uri>mailto:pzz&amp;pzz.msk.ru</uri>
+      <updated>2006-03-17</updated>
+    </person>
+    <person id="Alexandre_Gomes">
+      <name>Alexandre Gomes</name>
+      <uri>mailto:agomes&amp;boxtechnology.com</uri>
+      <updated>2019-10-02</updated>
+    </person>
+    <person id="Andrew_Brown">
+      <name>Andrew Brown</name>
+      <uri>mailto:abrown&amp;batstrading.com</uri>
+      <updated>2014-03-05</updated>
+    </person>
+    <person id="Andrew_Cherenson">
+      <name>Andrew Cherenson</name>
+      <uri>mailto:arc&amp;sgi.com</uri>
+    </person>
+    <person id="Andrew_Rowley">
+      <name>Andrew Rowley</name>
+      <uri>mailto:Andrew.Rowley&amp;manchester.ac.uk</uri>
+      <updated>2006-06-09</updated>
+    </person>
+    <person id="Andy_Belk">
+      <name>Andy Belk</name>
+      <uri>mailto:register1&amp;azulsystems.com</uri>
+      <updated>2005-02-01</updated>
+    </person>
+    <person id="Andy_Crick">
+      <name>Andy Crick</name>
+      <uri>mailto:acrick&amp;haascnc.com</uri>
+      <updated>2008-01-14</updated>
+    </person>
+    <person id="Anthony_Daga">
+      <name>Anthony Daga</name>
+      <uri>mailto:anthony&amp;mksrc.com</uri>
+      <updated>1999-06-01</updated>
+    </person>
+    <person id="Antonio_Querubin">
+      <name>Antonio Querubin</name>
+      <uri>mailto:tony&amp;lava.net</uri>
+      <updated>2008-02-04</updated>
+    </person>
+    <person id="Applykane">
+      <name>Applykane Technologies Private Limited</name>
+      <uri>mailto:applykane&amp;gmail.com</uri>
+      <updated>2017-05-19</updated>
+    </person>
+    <person id="Aquis_Exchange_PLC">
+      <name>Aquis Exchange PLC</name>
+      <uri>mailto:networks&amp;aquis.eu</uri>
+      <updated>2019-08-28</updated>
+    </person>
+    <person id="Architecture_Team">
+      <name>Architecture Team</name>
+      <uri>mailto:tech.arch&amp;quantifytechnology.com</uri>
+      <updated>2018-01-31</updated>
+    </person>
+    <person id="Arnoud_Zwemmer">
+      <name>Arnoud Zwemmer</name>
+      <uri>mailto:arnoud&amp;nwn.nl</uri>
+      <updated>1996-11-01</updated>
+    </person>
+    <person id="Asad_Gilani">
+      <name>Asad Gilani</name>
+      <uri>mailto:agilani&amp;nymex.com</uri>
+      <updated>1997-07-01</updated>
+    </person>
+    <person id="BATS_Europe_NOC">
+      <name>BATS Europe NOC</name>
+      <uri>mailto:noceurope&amp;bats.com</uri>
+      <updated>2017-06-23</updated>
+    </person>
+    <person id="Bernd_Uphoff">
+      <name>Bernd Uphoff</name>
+      <uri>mailto:bernd.uphoff&amp;deutsche-boerse.com</uri>
+      <updated>2018-06-19</updated>
+    </person>
+    <person id="Bert_van_Willigen">
+      <name>Bert van Willigen</name>
+      <uri>mailto:bert.vanwilligen&amp;philips.com</uri>
+      <updated>2004-01-01</updated>
+    </person>
+    <person id="Beverly_Schwartz">
+      <name>Beverly Schwartz</name>
+      <uri>mailto:bschwart&amp;bbn.com</uri>
+      <updated>1998-06-01</updated>
+    </person>
+    <person id="Bill_Manning">
+      <name>Bill Manning</name>
+      <uri>mailto:bmanning&amp;isi.edu</uri>
+      <updated>1999-08-01</updated>
+    </person>
+    <person id="Bill_Schilit">
+      <name>Bill Schilit</name>
+      <uri>mailto:schilit&amp;parc.xerox.com</uri>
+    </person>
+    <person id="Bill_Simpson">
+      <name>Bill Simpson</name>
+      <uri>mailto:bill.simpson&amp;um.cc.umich.edu</uri>
+      <updated>1994-11-01</updated>
+    </person>
+    <person id="Bill_Woodcock">
+      <name>Bill Woodcock</name>
+      <uri>mailto:woody&amp;zocalo.net</uri>
+      <updated>1998-11-01</updated>
+    </person>
+    <person id="Bob_Braden">
+      <name>Bob Braden</name>
+      <uri>mailto:braden&amp;isi.edu</uri>
+      <updated>1996-04-01</updated>
+    </person>
+    <person id="Bob_Brzezinski">
+      <name>Bob Brzezinski</name>
+      <uri>mailto:bob.brzezinski&amp;activfinancial.com</uri>
+      <updated>2005-10-28</updated>
+    </person>
+    <person id="Bob_Gaddie">
+      <name>Bob Gaddie</name>
+      <uri>mailto:bobg&amp;dtn.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Bob_Meier">
+      <name>Bob Meier</name>
+      <uri>mailto:meierb&amp;norand.com</uri>
+      <updated>1997-12-01</updated>
+    </person>
+    <person id="Bob_Scheifler">
+      <name>Bob Scheifler</name>
+      <uri>mailto:Bob.Scheifler&amp;sun.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Bob_Sledge">
+      <name>Bob Sledge</name>
+      <uri>mailto:bob&amp;pqsystems.com</uri>
+      <updated>1998-12-01</updated>
+    </person>
+    <person id="Bodo_Rueskamp">
+      <name>Bodo Rueskamp</name>
+      <uri>mailto:br&amp;itchigo.com</uri>
+      <updated>2000-03-01</updated>
+    </person>
+    <person id="Boris_Garber">
+      <name>Boris Garber</name>
+      <uri>mailto:Boris.Garber&amp;tsx.com</uri>
+      <updated>2012-06-12</updated>
+    </person>
+    <person id="BOX_TECHNOLOGY_CANADA_INC.">
+      <name>BOX TECHNOLOGY CANADA INC.</name>
+      <updated>2019-10-04</updated>
+    </person>
+    <person id="Brendan_Eic">
+      <name>Brendan Eic</name>
+      <uri>mailto:brendan&amp;illyria.wpd.sgi.com</uri>
+    </person>
+    <person id="Brian_Kean">
+      <name>Brian Kean</name>
+      <uri>mailto:bkean&amp;dca.com</uri>
+      <updated>1995-08-01</updated>
+    </person>
+    <person id="Brian_Kerkan">
+      <name>Brian Kerkan</name>
+      <uri>mailto:brian&amp;satcomsystems.com</uri>
+      <updated>2000-05-01</updated>
+    </person>
+    <person id="Brian_Martinicky">
+      <name>Brian Martinicky</name>
+      <uri>mailto:Brian_Martinicky&amp;automationintelligence.com</uri>
+      <updated>2000-03-01</updated>
+    </person>
+    <person id="Brian_Trudeau">
+      <name>Brian Trudeau</name>
+      <uri>mailto:btrudeau&amp;onechicago.com</uri>
+      <updated>2014-09-19</updated>
+    </person>
+    <person id="Bruce_Factor">
+      <name>Bruce Factor</name>
+      <uri>mailto:ahi!bigapple!bruce&amp;uunet.uu.net</uri>
+    </person>
+    <person id="Bryan_Costales">
+      <name>Bryan Costales</name>
+      <uri>mailto:bcx&amp;infobeat.com</uri>
+      <updated>1997-09-01</updated>
+    </person>
+    <person id="Bryant_Eastham">
+      <name>Bryant Eastham</name>
+      <uri>mailto:protocol&amp;opendof.org</uri>
+      <updated>2015-04-23</updated>
+    </person>
+    <person id="BSE">
+      <name>Beirut Stock Exchange</name>
+      <uri>mailto:itd&amp;bse.com.lb</uri>
+      <updated>2019-01-17</updated>
+    </person>
+    <person id="Caleb_Bell">
+      <name>Caleb Bell</name>
+      <uri>mailto:cbell&amp;rxnetworks.com</uri>
+      <updated>2012-11-19</updated>
+    </person>
+    <person id="Carl-Johan_Sjöberg">
+      <name>Carl-Johan Sjöberg</name>
+      <uri>mailto:cjs&amp;bitsend.se</uri>
+      <updated>2012-04-25</updated>
+    </person>
+    <person id="Carl_Malamud">
+      <name>Carl Malamud</name>
+      <uri>mailto:carl&amp;media.org</uri>
+      <updated>2014-01-03</updated>
+    </person>
+    <person id="CBOE_Europe">
+      <name>CBOE Europe</name>
+      <uri>mailto:noceurope&amp;cboe.com</uri>
+      <updated>2019-02-13</updated>
+    </person>
+    <person id="Charles_Tewiah">
+      <name>Charles Tewiah</name>
+      <uri>mailto:charles.tewiah&amp;westlb-systems.co.uk</uri>
+      <updated>2005-09-01</updated>
+    </person>
+    <person id="Chas_Honton">
+      <name>Chas Honton</name>
+      <uri>mailto:chas&amp;secant.com</uri>
+      <updated>1997-12-01</updated>
+    </person>
+    <person id="Choon_Lee">
+      <name>Choon Lee</name>
+      <uri>mailto:cwl&amp;nsd.3com.com</uri>
+      <updated>1996-04-01</updated>
+    </person>
+    <person id="Chris_Adams">
+      <name>Chris Adams</name>
+      <uri>mailto:jc.adams&amp;reuters.com</uri>
+      <updated>2000-07-01</updated>
+    </person>
+    <person id="Christopher_Mettin">
+      <name>Christopher Mettin</name>
+      <uri>mailto:cmettin&amp;gqbc-online.com</uri>
+      <updated>2009-05-12</updated>
+    </person>
+    <person id="Chuck_McManis">
+      <name>Chuck McManis</name>
+      <uri>mailto:cmcmanis&amp;sun.com</uri>
+    </person>
+    <person id="Clem_Verwey">
+      <name>Clem Verwey</name>
+      <uri>mailto:clemv&amp;jse.co.za</uri>
+      <updated>2011-12-07</updated>
+    </person>
+    <person id="Colin_Caughie">
+      <name>Colin Caughie</name>
+      <uri>mailto:cfc&amp;indigo-avs.com</uri>
+      <updated>2000-05-01</updated>
+    </person>
+    <person id="Coinbase">
+      <name>Coinbase</name>
+      <uri>mailto:markets-infra&amp;coinbase.com</uri>
+      <updated>2019-01-28</updated>
+    </person>
+    <person id="COMTECH_Kft.">
+      <name>COMTECH Kft.</name>
+      <uri>mailto:dev&amp;comtech.co.hu</uri>
+      <updated>2016-10-20</updated>
+    </person>
+    <person id="Craig_Dowell">
+      <name>Craig Dowell</name>
+      <uri>mailto:cdowell&amp;quicinc.com</uri>
+      <updated>2011-11-18</updated>
+    </person>
+    <person id="Dan_Jackson">
+      <name>Dan Jackson</name>
+      <uri>mailto:jdan&amp;us.ibm.com</uri>
+      <updated>1997-09-01</updated>
+    </person>
+    <person id="Dan_Jakubiec">
+      <name>Dan Jakubiec</name>
+      <uri>mailto:dan.jakubiec&amp;systech.com</uri>
+      <updated>2006-09-21</updated>
+    </person>
+    <person id="Daniel_Dissett">
+      <name>Daniel Dissett</name>
+      <uri>mailto:ddissett&amp;peerlogic.com</uri>
+      <updated>1998-12-01</updated>
+    </person>
+    <person id="Daniel_Steinber">
+      <name>Daniel Steinber</name>
+      <uri>mailto:Daniel.Steinberg&amp;eng.sun.com</uri>
+    </person>
+    <person id="Darcy_Brockbank">
+      <name>Darcy Brockbank</name>
+      <uri>mailto:darcy&amp;hasc.com</uri>
+      <updated>1997-12-01</updated>
+    </person>
+    <person id="Darrell_Sveistrup">
+      <name>Darrell Sveistrup</name>
+      <uri>mailto:darrells&amp;truesolutions.net</uri>
+      <updated>1999-06-01</updated>
+    </person>
+    <person id="Dave_Cheriton">
+      <name>Dave Cheriton</name>
+      <uri>mailto:cheriton&amp;dsg.stanford.edu</uri>
+    </person>
+    <person id="Dave_Glanzer">
+      <name>Dave Glanzer</name>
+      <uri>mailto:dave.glanzer&amp;fieldbus.org</uri>
+      <updated>2003-03-01</updated>
+    </person>
+    <person id="Dave_Thaler">
+      <name>Dave Thaler</name>
+      <uri>mailto:dthaler&amp;microsoft.com</uri>
+      <updated>2000-06-01</updated>
+    </person>    
+    <person id="David_Brett">
+      <name>David Brett</name>
+      <uri>mailto:david.brett&amp;alpha-group.ca</uri>
+      <updated>2011-10-25</updated>
+    </person>
+    <person id="David_Brett_2">
+      <name>David Brett</name>
+      <uri>mailto:david.brett&amp;thecse.com</uri>
+      <updated>2016-04-19</updated>
+    </person>
+    <person id="David_Meyer">
+      <name>David Meyer</name>
+      <uri>mailto:meyer&amp;ns.uoregon.edu</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="David_Mills">
+      <name>David Mills</name>
+      <uri>mailto:mills&amp;udel.edu</uri>
+    </person>
+    <person id="David_Poole">
+      <name>David Poole</name>
+      <uri>mailto:davep&amp;extendsys.com</uri>
+      <updated>1997-04-01</updated>
+    </person>
+    <person id="David_Rubin">
+      <name>David Rubin</name>
+      <uri>mailto:drubin&amp;ncc.net</uri>
+      <updated>1996-08-01</updated>
+    </person>    
+    <person id="David_Wilson">
+      <name>David Wilson</name>
+      <uri>mailto:dwilson&amp;m-x.ca</uri>
+      <updated>2013-05-30</updated>
+    </person>
+    <person id="Dean_Blackketter">
+      <name>Dean Blackketter</name>
+      <uri>mailto:dean&amp;corp.webtv.net</uri>
+      <updated>1998-11-01</updated>
+    </person>
+    <person id="Dino_Farinacci">
+      <name>Dino Farinacci</name>
+      <uri>mailto:dino&amp;procket.com</uri>
+      <updated>1996-03-01</updated>
+    </person>
+    <person id="Dirk_Koopman">
+      <name>Dirk Koopman</name>
+      <uri>mailto:djk&amp;tobit.co.uk</uri>
+      <updated>2000-07-01</updated>
+    </person>
+    <person id="Doug_Dillon">
+      <name>Doug Dillon</name>
+      <uri>mailto:dillon&amp;hns.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Douglas_Marquardt">
+      <name>Douglas Marquardt</name>
+      <uri>mailto:dmarquar&amp;woz.org</uri>
+      <updated>1997-02-01</updated>
+    </person>
+    <person id="Duane_Wessels">
+      <name>Duane Wessels</name>
+      <uri>mailto:wessels&amp;nlanr.net</uri>
+      <updated>1997-02-01</updated>
+    </person>
+    <person id="Ed_Moran">
+      <name>Ed Moran</name>
+      <uri>mailto:admin&amp;cruzjazz.com</uri>
+      <updated>1997-10-01</updated>
+    </person>
+    <person id="Ed_Purkiss">
+      <name>Ed Purkiss</name>
+      <uri>mailto:epurkiss&amp;wdmacodi.com</uri>
+      <updated>1998-09-01</updated>
+    </person>
+    <person id="Eric_Hall">
+      <name>Eric Hall</name>
+      <uri>mailto:ehall&amp;ntrg.com</uri>
+      <updated>1999-10-01</updated>
+    </person>
+    <person id="Erik_Guttman">
+      <name>Erik Guttman</name>
+      <uri>mailto:Erik.Guttman&amp;sun.com</uri>
+      <updated>2001-12-01</updated>
+    </person>
+    <person id="Ernst_EDER">
+      <name>Ernst EDER</name>
+      <uri>mailto:tech&amp;lonmark.org</uri>
+      <updated>2018-11-19</updated>
+    </person>
+    <person id="Euronext_Admin">
+      <name>Euronext Admin</name>
+      <uri>mailto:iana-admin&amp;euronext.com</uri>
+      <updated>2014-11-24</updated>
+    </person>
+    <person id="Evan_Caves">
+      <name>Evan Caves</name>
+      <uri>mailto:evan&amp;acc.com</uri>
+      <updated>1998-06-01</updated>
+    </person>
+    <person id="Florian_Weimer">
+      <name>Florian Weimer</name>
+      <uri>mailto:fweimer&amp;redhat.com</uri>
+      <updated>2013-02-08</updated>
+    </person>
+    <person id="Fred_Baker">
+      <name>Fred Baker</name>
+      <uri>mailto:fred&amp;cisco.com</uri>
+      <updated>1997-06-01</updated>
+    </person>
+    <person id="Gajendra_Shukla">
+      <name>Gajendra Shukla</name>
+      <uri>mailto:gshukla&amp;proxim.com</uri>
+      <updated>2002-02-01</updated>
+    </person>
+    <person id="Gamini_Karunaratne">
+      <name>Gamini Karunaratne</name>
+      <uri>mailto:gkarunaratne&amp;miami-holdings.com</uri>
+      <updated>2018-08-01</updated>
+    </person>
+    <person id="Gary_S_Malkin">
+      <name>Gary S. Malkin</name>
+      <uri>mailto:GMALKIN&amp;xylogics.com</uri>
+    </person>
+    <person id="Gary_Scott_Malkin">
+      <name>Gary Scott Malkin</name>
+      <uri>mailto:gmalkin&amp;baynetworks.com</uri>
+      <updated>1998-02-01</updated>
+    </person>
+    <person id="Gavin_McKee">
+      <name>Gavin McKee</name>
+      <uri>mailto:gav.mckee&amp;coinbase.com</uri>
+      <updated>2019-01-25</updated>
+    </person>
+    <person id="Gene_Marsh">
+      <name>Gene Marsh</name>
+      <uri>mailto:MarshM&amp;diebold.com</uri>
+      <updated>1998-11-01</updated>
+    </person>
+    <person id="Geoff_Golder">
+      <name>Geoff Golder</name>
+      <uri>mailto:geoffgolder&amp;gmail.com</uri>
+      <updated>2016-04-19</updated>
+    </person>
+    <person id="Geoff_Mendal">
+      <name>Geoff Mendal</name>
+      <uri>mailto:mendal&amp;talarian.com</uri>
+      <updated>1999-01-01</updated>
+    </person>
+    <person id="George_Neville-Neil">
+      <name>George Neville-Neil</name>
+      <uri>mailto:gnn&amp;neville-neil.com</uri>
+      <updated>2014-12-17</updated>
+    </person>
+    <person id="Gerald_Hanweck">
+      <name>Gerald Hanweck</name>
+      <uri>mailto:jhanweck&amp;hanweckassoc.com</uri>
+      <updated>2014-09-05</updated>
+    </person>
+    <person id="Giovanni_Marzot">
+      <name>Giovanni Marzot</name>
+      <uri>mailto:gmarzot&amp;ramp.com</uri>
+      <updated>2019-03-13</updated>
+    </person>
+    <person id="Grant_Taylor">
+      <name>Grant Taylor</name>
+      <uri>mailto:grantwtt&amp;gmail.com</uri>
+      <updated>2016-10-04</updated>
+    </person>
+    <person id="Greig_Saunders">
+      <name>Greig Saunders</name>
+      <uri>mailto:gsaunder&amp;londonstockexchange.com</uri>
+      <updated>2009-05-12</updated>
+    </person>
+    <person id="Guido_Petronio">
+      <name>Guido Petronio</name>
+      <uri>mailto:guido.petronio&amp;moneyline.com</uri>
+      <updated>2004-01-01</updated>
+    </person>
+    <person id="Guilherme_Longanezi">
+      <name>Guilherme Longanezi</name>
+      <uri>mailto:glonganezi&amp;bvmf.com.br</uri>
+      <updated>2016-09-27</updated>
+    </person>
+    <person id="Guy_Whitehouse">
+      <name>Guy Whitehouse</name>
+      <uri>mailto:gwhitehouse&amp;londonstockexchange.com</uri>
+      <updated>2006-03-31</updated>
+    </person>
+    <person id="Hanweck_Associates">
+      <name>Hanweck Associates</name>
+      <uri>mailto:iana-change-controller&amp;hanweckassoc.com</uri>
+      <updated>2019-10-01</updated>
+    </person>
+    <person id="Hatice_Unal">
+      <name>Hatice Unal</name>
+      <uri>mailto:CAN-Tech-Network&amp;itg.com</uri>
+      <updated>2019-01-25</updated>
+    </person>
+    <person id="Heiko_Rupp">
+      <name>Heiko Rupp</name>
+      <uri>mailto:hwr&amp;xlink.net</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Henri_Moelard">
+      <name>Henri Moelard</name>
+      <uri>mailto:HMOELARD&amp;wcnd.nl.lucent.com</uri>
+      <updated>1998-03</updated>
+    </person>
+    <person id="Henrik_Lans">
+      <name>Henrik Lans</name>
+      <uri>mailto:henrik.lans&amp;telia.no</uri>
+      <updated>2019-09-27</updated>
+    </person>
+    <person id="Hiroshi_Okubo">
+      <name>Hiroshi Okubo</name>
+      <uri>mailto:okubo.hiroshi&amp;canon.co.jp</uri>
+      <updated>2014-08-01</updated>
+    </person>
+    <person id="Howard_Gordon">
+      <name>Howard Gordon</name>
+      <uri>mailto:hgordon&amp;xingtech.com</uri>
+    </person>
+    <person id="IANA">
+      <name>IANA</name>
+      <uri>mailto:iana&amp;iana.org</uri>
+    </person>
+    <person id="Ian_Armitage">
+      <name>Ian Armitage</name>
+      <uri>mailto:ian&amp;coactive.com</uri>
+      <updated>1999-08-01</updated>
+    </person>
+    <person id="Ian_Stewart">
+      <name>Ian Stewart</name>
+      <uri>mailto:iandbige&amp;yahoo.com</uri>
+      <updated>1999-06-01</updated>
+    </person>
+    <person id="Ian_Wacey">
+      <name>Ian Wacey</name>
+      <uri>mailto:iain.wacey&amp;gefalbany.ge.com</uri>
+      <updated>2000-05-01</updated>
+    </person>
+    <person id="Ian_Wilson">
+      <name>Ian Wilson</name>
+      <uri>mailto:iwilson&amp;cisco.com</uri>
+      <updated>2001-12-01</updated>
+    </person>
+    <person id="Instinet">
+      <name>Instinet</name>
+      <uri>mailto:uk.networks&amp;instinet.co.uk</uri>
+      <updated>2019-08-29</updated>
+    </person>
+    <person id="Intercontinental_Exchange_Inc.">
+      <name>Intercontinental Exchange, Inc.</name>
+      <uri>mailto:riradmin&amp;theice.com</uri>
+      <updated>2018-04-20</updated>
+    </person>
+    <person id="IP_Admin">
+      <name>IP Admin</name>
+      <uri>mailto:ipaddr&amp;agilent.com</uri>
+      <updated>2015-10-12</updated>
+    </person>
+    <person id="ISE-Networks">
+      <name>ISE-Networks</name>
+      <uri>mailto:isenetworks&amp;ise.com</uri>
+      <updated>2016-05-06</updated>
+    </person>
+    <person id="Ishan_Wu">
+      <name>Ishan Wu</name>
+      <uri>mailto:iwu&amp;cisco.com</uri>
+      <updated>2000-03-01</updated>
+    </person>
+    <person id="Itamar_Gilad">
+      <name>Itamar Gilad</name>
+      <uri>mailto:itamar&amp;arootz.com</uri>
+      <updated>2007-08-31</updated>
+    </person>
+    <person id="J._Ryan_Stinnett">
+      <name>J. Ryan Stinnett</name>
+      <uri>mailto:jryans&amp;mozilla.com</uri>
+      <updated>2014-07-01</updated>
+    </person>
+    <person id="James_Crawford">
+      <name>James Crawford</name>
+      <uri>mailto:jcrawford&amp;metropol.net</uri>
+      <updated>1998-05-01</updated>
+    </person>
+    <person id="James_Williams">
+      <name>James Williams</name>
+      <uri>mailto:james.williams&amp;lme.com</uri>
+      <updated>2017-01-23</updated>
+    </person>
+    <person id="Jan_Drwal">
+      <name>Jan Drwal</name>
+      <uri>mailto:Jan.Drwal&amp;deutsche-boerse.com</uri>
+      <updated>2011-12-19</updated>
+    </person>
+    <person id="Jan_Vitek">
+      <name>Jan Vitek</name>
+      <uri>mailto:vitek&amp;selfservis.cz</uri>
+      <updated>2013-01-15</updated>
+    </person>
+    <person id="Jasmine_Strong">
+      <name>Jasmine Strong</name>
+      <uri>mailto:jasmine&amp;heroicrobotics.com</uri>
+      <updated>2014-06-04</updated>
+    </person>
+    <person id="Jason_Ives">
+      <name>Jason Ives</name>
+      <uri>mailto:noceurope&amp;cboe.com</uri>
+      <updated>2019-02-13</updated>
+    </person>
+    <person id="Javier_Landin">
+      <name>Javier Landin</name>
+      <uri>mailto:jlandin&amp;directedge.com</uri>
+      <updated>2009-08-28</updated>
+    </person>
+    <person id="Jeff_Schenk">
+      <name>Jeff Schenk</name>
+      <uri>mailto:Jeff.Schenk&amp;intelliden.com</uri>
+      <updated>2006-03-31</updated>
+    </person>
+    <person id="Jerome_Albin">
+      <name>Jerome Albin</name>
+      <uri>mailto:albin&amp;taec.enet.dec.com</uri>
+      <updated>1997-06-01</updated>
+    </person>
+    <person id="Jerry_Whitaker">
+      <name>Jerry Whitaker</name>
+      <uri>mailto:jwhitaker&amp;atsc.org</uri>
+      <updated>2008-12-19</updated>
+    </person>
+    <person id="Jim_Ginsburg">
+      <name>Jim Ginsburg</name>
+      <uri>mailto:JGinsburg&amp;jonescorp.com</uri>
+      <updated>2007-10-31</updated>
+    </person>
+    <person id="Jim_Lyle">
+      <name>Jim Lyle</name>
+      <uri>mailto:jim.lyle&amp;siliconimage.com</uri>
+      <updated>2006-08-07</updated>
+    </person>
+    <person id="Jim_Toga">
+      <name>Jim Toga</name>
+      <uri>mailto:jtoga&amp;ibeam.jf.intel.com</uri>
+      <updated>1996-05-01</updated>
+    </person>
+    <person id="Joel_Lynch">
+      <name>Joel Lynch</name>
+      <uri>mailto:joel.lynch&amp;cnn.com</uri>
+      <updated>1999-04-01</updated>
+    </person>
+    <person id="Johan_Deleu">
+      <name>Johan Deleu</name>
+      <uri>mailto:johan.deleu&amp;alcatel.be</uri>
+      <updated>2002-02-01</updated>
+    </person>
+    <person id="John_Catherino">
+      <name>John Catherino</name>
+      <uri>mailto:cajo&amp;dev.java.net</uri>
+      <updated>2006-03-31</updated>
+    </person>
+    <person id="John_Gabler">
+      <name>John Gabler</name>
+      <uri>mailto:john.gabler&amp;ips.invensys.com</uri>
+      <updated>2007-07-06</updated>
+    </person>
+    <person id="John_Rittner">
+      <name>John Rittner</name>
+      <uri>mailto:rittnerj&amp;cboe.com</uri>
+      <updated>2012-04-10</updated>
+    </person>
+    <person id="John_Veizades">
+      <name>John Veizades</name>
+      <uri>mailto:veizades&amp;tgv.com</uri>
+      <updated>1995-05-01</updated>
+    </person>
+    <person id="Johnathan_Ryder">
+      <name>Johnathan Ryder</name>
+      <uri>mailto:johnathan.ryder&amp;lme.com</uri>
+      <updated>2017-03-24</updated>
+    </person>
+    <person id="Jon_Crowcroft">
+      <name>Jon Crowcroft</name>
+      <uri>mailto:jon&amp;hocus.cs.ucl.ac.uk</uri>
+      <updated>1998-11-01</updated>
+    </person>
+    <person id="Jon_Gabriel">
+      <name>Jon Gabriel</name>
+      <uri>mailto:grabriel&amp;tivoli.com</uri>
+      <updated>1998-12-01</updated>
+    </person>
+    <person id="Jon_Postel">
+      <name>Jon Postel</name>
+      <uri>mailto:postel&amp;isi.edu</uri>
+    </person>
+    <person id="Jonathan_Niedfeldt">
+      <name>Jonathan Niedfeldt</name>
+      <uri>mailto:jon&amp;digitalacoustics.com</uri>
+      <updated>2008-02-22</updated>
+    </person>
+    <person id="Jose_Luis_Marocho">
+      <name>Jose Luis Marocho</name>
+      <uri>mailto:73374.313&amp;compuserve.com</uri>
+      <updated>1996-07-01</updated>
+    </person>
+    <person id="Juan_Ayas">
+      <name>Juan Ayas</name>
+      <uri>mailto:jayas&amp;lda-audiotech.com</uri>
+      <updated>2018-10-17</updated>
+    </person>
+    <person id="Julian_Nevell">
+      <name>Julian Nevell</name>
+      <uri>mailto:JNEVELL&amp;vbs.bt.co.uk</uri>
+      <updated>1999-08-01</updated>
+    </person>
+    <person id="Justin_Beaman">
+      <name>Justin Beaman</name>
+      <uri>mailto:justin.beaman&amp;midwestvideosolutions.com</uri>
+      <updated>2019-11-13</updated>
+    </person>
+    <person id="Kang_Lee">
+      <name>Kang Lee</name>
+      <uri>mailto:kang.lee&amp;nist.gov</uri>
+      <updated>2007-02-02</updated>
+    </person>
+    <person id="Karen_Seo">
+      <name>Karen Seo</name>
+      <uri>mailto:kseo&amp;bbn.com</uri>
+    </person>
+    <person id="Karl_Elad">
+      <name>Karl Elad</name>
+      <uri>mailto:karl.elad&amp;intelsat.com</uri>
+      <updated>2006-03-31</updated>
+    </person>
+    <person id="Keith_Thompson">
+      <name>Keith Thompson</name>
+      <uri>mailto:thompson&amp;ridgeback.east.sun.com</uri>
+      <updated>2001-06-01</updated>
+    </person>
+    <person id="Kevin_Gross">
+      <name>Kevin Gross</name>
+      <uri>mailto:kvng&amp;ieee.org</uri>
+      <updated>2010-03-12</updated>
+    </person>
+    <person id="Kevin_Gross_2">
+      <name>Kevin Gross</name>
+      <uri>mailto:kevin.gross&amp;avanw.com</uri>
+      <updated>2012-08-28</updated>
+    </person>
+    <person id="KPN_IP_Office">
+      <name>KPN IP Office</name>
+      <uri>mailto:kpn-ip-office&amp;kpn.com</uri>
+      <updated>2011-04-18</updated>
+    </person>
+    <person id="Kristian_A_Bognaes">
+      <name>Kristian A. Bognaes</name>
+      <uri>mailto:kristian.bognaes&amp;norman.com</uri>
+      <updated>2014-01-08</updated>
+    </person>
+    <person id="LDA_Audio_Tech">
+      <name>LDA Audio Tech</name>
+      <uri>mailto:info&amp;lda-audiotech.com</uri>
+      <updated>2018-10-19</updated>
+    </person>
+    <person id="Lev_V._Cherednikov">
+      <name>Lev V. Cherednikov</name>
+      <uri>mailto:lev.cherednikov&amp;nbn-holding.ru</uri>
+      <updated>2014-04-12</updated>
+    </person>
+    <person id="Liming_Wei">
+      <name>Liming Wei</name>
+      <uri>mailto:lwei&amp;cisco.com</uri>
+      <updated>1998-10-01</updated>
+    </person>
+    <person id="LIRNEasia">
+      <name>LIRNEasia</name>
+      <uri>mailto:nuwan&amp;lirneasia.net</uri>
+      <updated>2017-10-19</updated>
+    </person>
+    <person id="Lloyd_Wood">
+      <name>Lloyd Wood</name>
+      <uri>mailto:L.Wood&amp;surrey.ac.uk</uri>
+      <updated>2011-03-17</updated>
+    </person>
+    <person id="LonMark_International">
+      <name>LonMark International</name>
+      <uri>mailto:tech&amp;lonmark.org</uri>
+      <updated>2018-11-19</updated>
+    </person>
+    <person id="Louis_Mamakos">
+      <name>Louis Mamakos</name>
+      <uri>mailto:louie&amp;uu.net</uri>
+      <updated>1997-03-01</updated>
+    </person>
+    <person id="Kenneth_Felix">
+      <name>Kenneth Felix</name>
+      <uri>mailto:ken&amp;spryware.com</uri>
+      <updated>2010-08-12</updated>
+    </person>
+    <person id="Madhav_Karhade">
+      <name>Madhav Karhade</name>
+      <uri>mailto:Madhav.Karhade&amp;wibhu.com</uri>
+      <updated>2003-05-01</updated>
+    </person>
+    <person id="Marc_Goossens">
+      <name>Marc Goossens</name>
+      <uri>mailto:mgoossens&amp;eiba.com</uri>
+      <updated>2003-07-01</updated>
+    </person>
+    <person id="Mark_Armstrong">
+      <name>Mark Armstrong</name>
+      <uri>mailto:Mark.Armstrong&amp;soleratec.com</uri>
+      <updated>2006-02-09</updated>
+    </person>
+    <person id="Mark_Bakke">
+      <name>Mark Bakke</name>
+      <uri>mailto:mbakke&amp;cisco.com</uri>
+      <updated>2001-12-01</updated>
+    </person>
+    <person id="Mark_Hamilton">
+      <name>Mark Hamilton</name>
+      <uri>mailto:mah&amp;spectralink.com</uri>
+      <updated>1998-11-01</updated>
+    </person>
+    <person id="Mark_Handley">
+      <name>Mark Handley</name>
+      <uri>mailto:mjh&amp;isi.edu</uri>
+      <updated>1998-12-01</updated>
+    </person>
+    <person id="Mark_Lewis">
+      <name>Mark Lewis</name>
+      <uri>mailto:Mark_Lewis&amp;ccm.jf.intel.com</uri>
+      <updated>1995-10-01</updated>
+    </person>
+    <person id="Mark_Lipford">
+      <name>Mark Lipford</name>
+      <uri>mailto:mark.a.lipford&amp;sprint.com</uri>
+      <updated>2006-07-11</updated>
+    </person>    
+    <person id="Marlon_Berlin">
+      <name>Marlon Berlin</name>
+      <uri>mailto:marlon.berlin&amp;dns-net.de</uri>
+      <updated>2013-05-25</updated>
+    </person>
+    <person id="Martin_Forssen">
+      <name>Martin Forssen</name>
+      <uri>mailto:maf&amp;dtek.chalmers.se</uri>
+    </person>
+    <person id="Mary_Timm">
+      <name>Mary Timm</name>
+      <uri>mailto:mary&amp;xenoscience.com</uri>
+      <updated>1998-07-01</updated>
+    </person>
+    <person id="Masato_Shindoh">
+      <name>Masato Shindoh</name>
+      <uri>mailto:jl11456&amp;yamato.ibm.co.jp</uri>
+      <updated>1997-08-01</updated>
+    </person>
+    <person id="Matthew_Straight">
+      <name>Matthew Straight</name>
+      <uri>mailto:matt_straight&amp;yahoo.com</uri>
+      <updated>2007-03-01</updated>
+    </person>
+    <person id="Maurice_Robberson">
+      <name>Maurice Robberson</name>
+      <uri>mailto:ceo&amp;mediastreamusa.com</uri>
+      <updated>2006-09-15</updated>
+    </person>
+    <person id="Mellanox">
+      <name>Mellanox Technologies, Inc.</name>
+      <uri>mailto:info&amp;mellanox.com</uri>
+      <updated>2019-07-01</updated>
+    </person>
+    <person id="Meridian_Labs_LTD">
+      <name>Meridian Labs LTD.</name>
+      <uri>mailto:mark.wood&amp;meridianlabs.org</uri>
+      <updated>2017-10-13</updated>
+    </person>
+    <person id="MIAX">
+      <name>Miami International Security Exchange</name>
+      <uri>mailto:networking&amp;miami-holdings.com</uri>
+      <updated>2018-08-01</updated>
+    </person>
+    <person id="Michael_Caravetta">
+      <name>Michael Caravetta</name>
+      <uri>mailto:Michael.Caravetta&amp;tsx.com</uri>
+      <updated>2012-06-15</updated>
+    </person>    
+    <person id="Michael_Caravetta_2">
+      <name>Michael Caravetta</name>
+      <uri>mailto:Network_Reps&amp;tsx.com</uri>
+      <updated>2013-06-03</updated>
+    </person>
+    <person id="Michael_DeMoney">
+      <name>Michael DeMoney</name>
+      <uri>mailto:demoney&amp;eng.sun.com</uri>
+      <updated>1997-04-01</updated>
+    </person>
+    <person id="Michael_Dolan">
+      <name>Michael Dolan</name>
+      <uri>mailto:miked&amp;tbt.com</uri>
+      <updated>2003-10-01</updated>
+    </person>
+    <person id="Michael_Kreutzjans">
+      <name>Michael Kreutzjans</name>
+      <uri>mailto:mike&amp;spryware.com</uri>
+      <updated>2007-03-01</updated>
+    </person>
+    <person id="Michael_Lyle">
+      <name>Michael Lyle</name>
+      <uri>mailto:protocols&amp;translattice.com</uri>
+      <updated>2009-11-11</updated>
+    </person>
+    <person id="Michael_Rosenberg">
+      <name>Michael Rosenberg</name>
+      <uri>mailto:michael.rosenberg&amp;nasdaqomx.com</uri>
+      <updated>2012-03-15</updated>
+    </person>
+    <person id="Michael_Wang">
+      <name>Michael Wang</name>
+      <uri>mailto:Michael.Wang&amp;usa.xerox.com</uri>
+      <updated>1999-03-01</updated>
+    </person>
+    <person id="Midwest_Video_Solutions">
+      <name>Midwest Video Solutions</name>
+      <uri>mailto:support&amp;midwestvideosolutions.com</uri>
+      <updated>2019-11-13</updated>
+    </person>
+    <person id="Mika_Uusitalo">
+      <name>Mika Uusitalo</name>
+      <uri>mailto:msu&amp;xingtech.com</uri>
+      <updated>1997-04-01</updated>
+    </person>
+    <person id="Mike_King">
+      <name>Mike King</name>
+      <uri>mailto:mike.king&amp;philips.com</uri>
+      <updated>2019-02-07</updated>
+    </person>
+    <person id="Mike_Pontillo">
+      <name>Mike Pontillo</name>
+      <uri>mailto:mike.pontillo&amp;canonical.com</uri>
+      <updated>2017-05-19</updated>
+    </person>
+    <person id="Mike_Rodbell">
+      <name>Mike Rodbell</name>
+      <uri>mailto:mrodbell&amp;ciena.com</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Mike_Roper">
+      <name>Mike Roper</name>
+      <uri>mailto:mroper&amp;8x8.com</uri>
+      <updated>1999-09-01</updated>
+    </person>
+    <person id="Mike_Velten">
+      <name>Mike Velten</name>
+      <uri>mailto:mike_velten&amp;liebert.com</uri>
+      <updated>1999-01-01</updated>
+    </person>
+    <person id="Moe_Singh">
+      <name>Moe Singh</name>
+      <uri>mailto:moesingh&amp;hotmail.com</uri>
+      <updated>2009-09-24</updated>
+    </person>
+    <person id="Morten_Lindeman">
+      <name>Morten Lindeman</name>
+      <uri>mailto:Morten.Lindeman&amp;os.telia.no</uri>
+      <updated>1999-03-01</updated>
+    </person>
+    <person id="Morteza_Kalhour">
+      <name>Morteza Kalhour</name>
+      <uri>mailto:morteza.kalhour&amp;nokia.com</uri>
+      <updated>2002-10-01</updated>
+    </person>
+    <person id="Nadine_Guillaume">
+      <name>Nadine Guillaume</name>
+      <uri>mailto:nadine.guillaume&amp;sciatl.com</uri>
+      <updated>2005-02-01</updated>
+    </person>
+    <person id="Neal_Lawrence">
+      <name>Neal Lawrence</name>
+      <uri>mailto:neal.lawrence&amp;a2x.co.za</uri>
+      <updated>2017-06-02</updated>
+    </person>
+    <person id="Nedelcho_Stanev">
+      <name>Nedelcho Stanev</name>
+      <uri>mailto:nstanev&amp;csoft.bg</uri>
+      <updated>1999-05-01</updated>
+    </person>
+    <person id="NE-TEAM_at_telecomsys.com">
+      <name>NE-TEAM_at_telecomsys.com</name>
+      <uri>mailto:NE-TEAM&amp;telecomsys.com</uri>
+      <updated>2014-11-07</updated>
+    </person>
+    <person id="Nick_Barendt">
+      <name>Nick Barendt</name>
+      <uri>mailto:nbarendt&amp;vxitech.com</uri>
+      <updated>2005-11-01</updated>
+    </person>
+    <person id="Nigel_Thompson">
+      <name>Nigel Thompson</name>
+      <uri>mailto:nigelt&amp;tribal.com</uri>
+      <updated>1999-01-01</updated>
+    </person>
+    <person id="Oliver_Lewis">
+      <name>Oliver Lewis</name>
+      <uri>mailto:o.lewis&amp;icerobotics.co.uk</uri>
+      <updated>2006-07-11</updated>
+    </person>
+    <person id="OPC_Foundation">
+      <name>OPC Foundation</name>
+      <uri>mailto:sysadmin&amp;opcfoundation.org</uri>
+      <updated>2019-08-19</updated>
+    </person>
+    <person id="OSPF_WG_Chairs">
+      <name>OSPF WG Chairs</name>
+      <uri>mailto:ospf-chairs&amp;ietf.org</uri>
+    </person>
+    <person id="Oyvind_H_Olsen">
+      <name>Oyvind H. Olsen</name>
+      <uri>mailto:oyvind-hollup.olsen&amp;canaldigital.com</uri>
+      <updated>2007-09-12</updated>
+    </person>
+    <person id="Paolo_Strazzera">
+      <name>Paolo Strazzera</name>
+      <uri>mailto:p.strazzera&amp;telematica.it</uri>
+      <updated>1999-06-01</updated>
+    </person>
+    <person id="Patrick_Cipiere">
+      <name>Patrick Cipiere</name>
+      <uri>mailto:Patrick.Cipiere&amp;udcast.com</uri>
+      <updated>2001-01-01</updated>
+    </person>
+    <person id="Paul_Langille">
+      <name>Paul Langille</name>
+      <uri>mailto:plangille&amp;dnpg.com</uri>
+      <updated>2007-01-17</updated>
+    </person>
+    <person id="Paul_Roberts">
+      <name>Paul Roberts</name>
+      <uri>mailto:networks&amp;aquis.eu</uri>
+      <updated>2019-08-28</updated>
+    </person>
+    <person id="Paul_Suhler">
+      <name>Paul Suhler</name>
+      <uri>mailto:paul.suhler&amp;quantum.com</uri>
+      <updated>2009-05-12</updated>
+    </person>
+    <person id="Paul_Wallner">
+      <name>Paul Wallner</name>
+      <uri>mailto:paul.wallner&amp;wienstrom.at</uri>
+      <updated>2010-09-14</updated>
+    </person>
+    <person id="Paul_Wissenbach">
+      <name>Paul Wissenbach</name>
+      <uri>mailto:paulwi&amp;vnd.tek.com</uri>
+      <updated>1997-06-01</updated>
+    </person>
+    <person id="Peter_Aronson">
+      <name>Peter Aronson</name>
+      <uri>mailto:paronson&amp;esri.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Peter_Parnes">
+      <name>Peter Parnes</name>
+      <uri>mailto:peppar&amp;marratech.com</uri>
+      <updated>2000-02-01</updated>
+    </person>
+    <person id="Peter_White">
+      <name>Peter White</name>
+      <uri>mailto:peter_white&amp;3com.com</uri>
+      <updated>1999-04-01</updated>
+    </person>
+    <person id="Philips_Healthcare">
+      <name>Philips Healthcare</name>
+      <uri>mailto:bill.holden&amp;philips.com</uri>
+      <updated>2019-02-07</updated>
+    </person>
+    <person id="Pierre_Oliver">
+      <name>Pierre Oliver</name>
+      <uri>mailto:polivier&amp;calamp.com</uri>
+      <updated>2011-06-06</updated>
+    </person>
+    <person id="Piers_Scannell">
+      <name>Piers Scannell</name>
+      <uri>mailto:piers&amp;globecastne.com</uri>
+      <updated>2000-03-01</updated>
+    </person>
+    <person id="Pilz">
+      <name>Pilz GmbH and Co. KG</name>
+      <uri>mailto:pilz.gmbh&amp;pilz.de</uri>
+      <updated>2009-03-17</updated>
+    </person>
+    <person id="Prakash_Banthia">
+      <name>Prakash Banthia</name>
+      <uri>mailto:prakash_banthia&amp;3com.com</uri>
+      <updated>1998-09-01</updated>
+    </person>
+    <person id="Ralph_Kammerlander">
+      <name>Ralph Kammerlander</name>
+      <uri>mailto:ralph.kammerlander&amp;khe.siemens.de</uri>
+      <updated>2000-06-01</updated>
+    </person>
+    <person id="Ram_Iyer">
+      <name>Ram Iyer</name>
+      <uri>mailto:ram&amp;aaccorp.com</uri>
+      <updated>1998-03-01</updated>
+    </person>
+    <person id="Rami_Chalhoub">
+      <name>Rami Chalhoub</name>
+      <uri>mailto:itd&amp;bse.com.lb</uri>
+      <updated>2019-01-17</updated>
+    </person>
+    <person id="Ramp_Holdings">
+      <name>Ramp Holdings</name>
+      <uri>mailto:ops&amp;ramp.com</uri>
+      <updated>2019-03-28</updated>
+    </person>
+    <person id="Raymond_Shum">
+      <name>Raymond Shum</name>
+      <uri>mailto:rshum&amp;ms.com</uri>
+      <updated>1998-04-01</updated>
+    </person>
+    <person id="Richard_Hodges">
+      <name>Richard Hodges</name>
+      <uri>mailto:rh&amp;source.net</uri>
+      <updated>1999-03-01</updated>
+    </person>
+    <person id="Richard_Zulch">
+      <name>Richard Zulch</name>
+      <uri>mailto:richard_zulch&amp;dantz.com</uri>
+      <updated>2004-05-01</updated>
+    </person>
+    <person id="RIR_Admin">
+      <name>RIR Admin</name>
+      <uri>mailto:riradmin&amp;theice.com</uri>
+      <updated>2018-04-20</updated>
+    </person>
+    <person id="Rob_Janssen">
+      <name>Rob Janssen</name>
+      <uri>mailto:rob&amp;pe1chl.ampr.org</uri>
+      <updated>1995-01-01</updated>
+    </person>
+    <person id="Robert_Hodgson">
+      <name>Robert Hodgson</name>
+      <uri>mailto:robert&amp;paratek.co.uk</uri>
+      <updated>2001-12-01</updated>
+    </person>
+    <person id="Robert_Sautter">
+      <name>Robert Sautter</name>
+      <uri>mailto:rsautter&amp;acdnj.itt.com</uri>
+      <updated>1999-08-01</updated>
+    </person>
+    <person id="Robert_Sliwinski">
+      <name>Robert Sliwinski</name>
+      <uri>mailto:sliwinre&amp;mail1st.com</uri>
+      <updated>2000-02-01</updated>
+    </person>
+    <person id="Robert_Taylor">
+      <name>Robert Taylor</name>
+      <uri>mailto:rtaylor&amp;digicelgroup.com</uri>
+      <updated>2016-09-29</updated>
+    </person>
+    <person id="Roberto_Costa_Simoes">
+      <name>Roberto Costa Simoes</name>
+      <uri>mailto:rcosta&amp;bvmf.com.br</uri>
+      <updated>2010-08-18</updated>
+    </person>
+    <person id="Ryon_Coleman">
+      <name>Ryon Coleman</name>
+      <uri>mailto:rcoleman&amp;3eti.com</uri>
+      <updated>2006-04-11</updated>
+    </person>
+    <person id="SEIKO_EPSON_Corp">
+      <name>SEIKO EPSON Corp</name>
+      <uri>mailto:ogata.hideaki&amp;exc.epson.co.jp</uri>
+      <updated>2005-01-01</updated>
+    </person>
+    <person id="Sakon_Kittivatcharapong">
+      <name>Sakon Kittivatcharapong</name>
+      <uri>mailto:sakonk&amp;cscoms.net</uri>
+      <updated>2000-05-01</updated>
+    </person>
+    <person id="Sarunas_Brakauskas">
+      <name>Sarunas Brakauskas</name>
+      <uri>mailto:sbrakaus&amp;cme.com</uri>
+      <updated>2007-07-17</updated>
+    </person>
+    <person id="Scott_Watson">
+      <name>Scott Watson</name>
+      <uri>mailto:scott&amp;disney.com</uri>
+      <updated>1997-08-01</updated>
+    </person>
+    <person id="Semtech_Corporation">
+      <name>Semtech Corporation</name>
+      <uri>mailto:aptovision_support&amp;semtech.com</uri>
+      <updated>2019-02-22</updated>
+    </person>
+    <person id="Sergey_Shulgin">
+      <name>Sergey Shulgin</name>
+      <uri>mailto:sshulgin&amp;pinkotc.com</uri>
+      <updated>2008-08-12</updated>
+    </person>
+    <person id="Shachar_Dor">
+      <name>Shachar Dor</name>
+      <uri>mailto:shachard&amp;mellanox.com</uri>
+      <updated>2019-07-01</updated>
+    </person>
+    <person id="Shai_Revzen">
+      <name>Shai Revzen</name>
+      <uri>mailto:shai.revzen&amp;harmonicinc.com</uri>
+      <updated>1999-04-01</updated>
+    </person>
+    <person id="Shane_Rowatt">
+      <name>Shane Rowatt</name>
+      <uri>mailto:shane.rowatt&amp;star.com.au</uri>
+      <updated>1997-03-01</updated>
+    </person>
+    <person id="Shivaun_Albright">
+      <name>Shivaun Albright</name>
+      <uri>mailto:shivaun_albright&amp;hp.com</uri>
+      <updated>1997-07-01</updated>
+    </person>
+    <person id="Simon_Barber">
+      <name>Simon Barber</name>
+      <uri>mailto:simon.barber&amp;parc.com</uri>
+      <updated>2009-09-24</updated>
+    </person>
+    <person id="SINERGIYA_Ltd.">
+      <name>SINERGIYA Ltd.</name>
+      <uri>mailto:noc&amp;snrgt.ru</uri>
+      <updated>2020-01-21</updated>
+    </person>
+    <person id="Soren_Martin_Sorensen">
+      <name>Soren Martin Sorensen</name>
+      <uri>mailto:sms&amp;energimidt.dk</uri>
+      <updated>2006-08-07</updated>
+    </person>
+    <person id="Stacey_O_Rourke">
+      <name>Stacey O'Rourke</name>
+      <uri>mailto:stacey&amp;network-alchemy.com</uri>
+      <updated>1999-08-01</updated>
+    </person>
+    <person id="Stacey_O_Rourke_2">
+      <name>Stacey O'Rourke</name>
+      <uri>mailto:stacey&amp;cips.nokia.com</uri>
+      <updated>2001-01-01</updated>
+    </person>
+    <person id="Stephan_Wasserroth">
+      <name>Stephan Wasserroth</name>
+      <uri>mailto:wasserroth&amp;fokus.gmd.de</uri>
+      <updated>2000-07-01</updated>
+    </person>
+    <person id="Stephen_Dunne">
+      <name>Stephen Dunne</name>
+      <uri>mailto:sdun&amp;isma.co.uk</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Stephen_Hanna">
+      <name>Stephen Hanna</name>
+      <uri>mailto:steve.hanna&amp;sun.com</uri>
+      <updated>2000-07-01</updated>
+    </person>
+    <person id="Stephen_Ray_Middleton">
+      <name>Stephen Ray Middleton</name>
+      <uri>mailto:stephen.r.middleton&amp;verizon.com</uri>
+      <updated>2015-03-23</updated>
+    </person>
+    <person id="Stephen_T_Lyda">
+      <name>Stephen T. Lyda</name>
+      <uri>mailto:slyda&amp;emsg.com</uri>
+      <updated>2000-02-01</updated>
+    </person>
+    <person id="Steve_Casner">
+      <name>Steve Casner</name>
+      <uri>mailto:casner&amp;precept.com</uri>
+    </person>
+    <person id="Steve_Casner_2">
+      <name>Steve Casner</name>
+      <uri>mailto:casner&amp;isi.edu</uri>
+      <updated>1995-01-01</updated>
+    </person>
+    <person id="Steve_Deering">
+      <name>Steve Deering</name>
+      <uri>mailto:deering&amp;cisco.com</uri>
+      <updated>1999-10-01</updated>
+    </person>
+    <person id="Steve_Deering_2">
+      <name>Steve Deering</name>
+      <uri>mailto:deering&amp;parc.xerox.com</uri>
+    </person>
+    <person id="Steve_Polishinski">
+      <name>Steve Polishinski</name>
+      <uri>mailto:spolishinski&amp;etcconnect.com</uri>
+      <updated>2000-03-01</updated>
+    </person>
+    <person id="Stuart_Kerry">
+      <name>Stuart Kerry</name>
+      <uri>mailto:stuart.kerry&amp;philips.com</uri>
+      <updated>2003-01-01</updated>
+    </person>
+    <person id="Svetlana_Kachintseva">
+      <name>Svetlana Kachintseva</name>
+      <uri>mailto:skachintseva&amp;hanweck.com</uri>
+      <updated>2019-09-12</updated>
+    </person>
+    <person id="Susie_Armstrong">
+      <name>Susie Armstrong</name>
+      <uri>mailto:Armstrong.wbst128&amp;xerox.com</uri>
+    </person>
+    <person id="Takeshi_Saito">
+      <name>Takeshi Saito</name>
+      <uri>mailto:takeshi.saito&amp;toshiba.co.jp</uri>
+      <updated>2003-02-01</updated>
+    </person>
+    <person id="Technicolor_NL_NOC">
+      <name>Technicolor NL NOC</name>
+      <uri>mailto:noc&amp;technicolor.com</uri>
+      <updated>2009-12-23</updated>
+    </person>
+    <person id="Telia-Norway-Get-NOC">
+      <name>Telia-Norway-Get-NOC</name>
+      <uri>mailto:noc&amp;get.no</uri>
+      <updated>2019-08-28</updated>
+    </person>
+    <person id="Terry_Gibson">
+      <name>Terry Gibson</name>
+      <uri>mailto:terry.gibson&amp;sun.com</uri>
+      <updated>1997-08-01</updated>
+    </person>
+    <person id="Tetsuo_Hoshi">
+      <name>Tetsuo Hoshi</name>
+      <uri>mailto:tetsuo.hoshi&amp;jp.yokogawa.com</uri>
+      <updated>2004-06-01</updated>
+    </person>
+    <person id="Tim_DeBaillie">
+      <name>Tim DeBaillie</name>
+      <uri>mailto:debaillie&amp;ciholas.com</uri>
+      <updated>2006-11-30</updated>
+    </person>
+    <person id="Tim_Gorsline">
+      <name>Tim Gorsline</name>
+      <uri>mailto:tgorsline&amp;bats.com</uri>
+      <updated>2017-06-23</updated>
+    </person>
+    <person id="Tim_Johnson">
+      <uri>mailto:tjohnson&amp;londonstockexchange.com</uri>
+      <updated>2012-04-11</updated>
+    </person>
+    <person id="TMX_Atrium">
+      <name>TMX Atrium</name>
+      <uri>mailto:tech-arin&amp;tmxatrium.com</uri>
+      <updated>2017-02-09</updated>
+    </person>
+    <person id="Tom_Ballister">
+      <name>Tom Ballister</name>
+      <uri>mailto:tom&amp;ballister.com</uri>
+      <updated>1997-07-01</updated>
+    </person>
+    <person id="Tom_Blank">
+      <name>Tom Blank</name>
+      <uri>mailto:tomblank&amp;microsoft.com</uri>
+      <updated>1996-11-01</updated>
+    </person>
+    <person id="Tom_White">
+      <name>Tom White</name>
+      <uri>mailto:info&amp;midi.org</uri>
+      <updated>2011-11-02</updated>
+    </person>
+    <person id="Tony_Ballardie">
+      <name>Tony Ballardie</name>
+      <uri>mailto:A.Ballardie&amp;cs.ucl.ac.uk</uri>
+      <updated>1997-02-01</updated>
+    </person>
+    <person id="Tony_Barber">
+      <name>Tony Barber</name>
+      <uri>mailto:tony.barber&amp;wcom.com</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Tony_Przygienda">
+      <name>Tony Przygienda</name>
+      <uri>mailto:prz&amp;siara.com</uri>
+      <updated>1999-10-01</updated>
+    </person>
+    <person id="Tony_Wong">
+      <name>Tony Wong</name>
+      <uri>mailto:wongt&amp;ms.com</uri>
+      <updated>1998-07-01</updated>
+    </person>
+    <person id="Tradition_Network_Operations_and_Command_Center">
+      <name>Tradition Network Operations and Command Center</name>
+      <uri>mailto:SH-Networking&amp;tradition.com</uri>
+      <updated>2010-09-22</updated>
+    </person>
+    <person id="TV_System_Administrators">
+      <name>TV System Administrators</name>
+      <org>Ålands Telekommunikation Ab</org>
+      <uri>mailto:tv-noc&amp;alcom.ax</uri>
+      <updated>2019-02-28</updated>
+    </person>
+    <person id="UPnP_Forum">
+      <name>UPnP Forum</name>
+      <uri>mailto:upnpadmin&amp;forum.upnp.org</uri>
+      <updated>2006-06-27</updated>
+    </person>
+    <person id="Vanya_Levy">
+      <name>Vanya Levy</name>
+      <uri>mailto:vlevy&amp;semtech.com</uri>
+      <updated>2019-02-20</updated>
+    </person>
+    <person id="Victor_Volpe">
+      <name>Victor Volpe</name>
+      <uri>mailto:vvolpe&amp;smtp.microcom.com</uri>
+      <updated>1997-10-01</updated>
+    </person>
+    <person id="Vladimir_Shishkov">
+      <name>Vladimir Shishkov</name>
+      <uri>mailto:v.shishkov&amp;vconnect.ru</uri>
+      <updated>2017-02-17</updated>
+    </person>
+    <person id="Wally_Beddoe">
+      <name>Wally Beddoe</name>
+      <uri>mailto:WBeddoe&amp;tkusa.com</uri>
+      <updated>2003-04-01</updated>
+    </person>
+    <person id="Walter_Wallach">
+      <name>Walter Wallach</name>
+      <uri>mailto:walt&amp;sumatech.com</uri>
+      <updated>1999-07-01</updated>
+    </person>
+    <person id="Wayne_Carr">
+      <name>Wayne Carr</name>
+      <uri>mailto:Wayne_Carr&amp;ccm.intel.com</uri>
+      <updated>1997-12-01</updated>
+    </person>
+    <person id="Wayne_Wenyu_Liu">
+      <name>Wayne Wenyu Liu</name>
+      <uri>mailto:wayne.wenyu.liu&amp;gmail.com</uri>
+      <updated>2012-06-12</updated>
+    </person>
+    <person id="Wenjie_Peng">
+      <name>Wenjie Peng</name>
+      <uri>mailto:wpeng&amp;tts.telerate.com</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Werner_Vogels">
+      <name>Werner Vogels</name>
+      <uri>mailto:vogels&amp;rnets.com</uri>
+      <updated>1998-08-01</updated>
+    </person>
+    <person id="Wieland_Holdfelder">
+      <name>Wieland Holdfelder</name>
+      <uri>mailto:whd&amp;pi4.informatik.uni-mannheim.de</uri>
+      <updated>1997-01-01</updated>
+    </person>
+    <person id="Xiaoyu_Zhou">
+      <name>Xiaoyu Zhou</name>
+      <uri>mailto:zhouxyi&amp;lenovo.com</uri>
+      <updated>2009-01-20</updated>
+    </person>
+    <person id="Yea_Uang">
+      <name>Yea Uang</name>
+      <uri>mailto:uang&amp;force.decnet.lockheed.com</uri>
+      <updated>1994-11-01</updated>
+    </person>
+    <person id="Yossi_Gal">
+      <name>Yossi Gal</name>
+      <uri>mailto:yossi&amp;gilat.com</uri>
+      <updated>1998-02-01</updated>
+    </person>
+    <person id="Zaklina_Petkovic">
+      <name>Zaklina Petkovic</name>
+      <uri>mailto:zaklina.petkovic&amp;alphatradingsystems.ca</uri>
+      <updated>2011-07-13</updated>
+    </person>
+    <person id="Zaklina_Petkovic_2">
+      <name>Zaklina Petkovic</name>
+      <uri>mailto:zaklina.petkovic&amp;aequin.com</uri>
+      <updated>2014-05-16</updated>
+    </person>
+    <person id="Zia_Bhatti">
+      <name>Zia Bhatti</name>
+      <uri>mailto:zia&amp;netright.com</uri>
+      <updated>1998-09-01</updated>
+    </person>
+  </people>
+</registry>
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/nmap.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/nmap.py
new file mode 100644
index 0000000000000000000000000000000000000000..bacc5776bb791d21f944da82f81d46306cdf9f12
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/nmap.py
@@ -0,0 +1,117 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+Routines for dealing with nmap-style IPv4 address ranges.
+
+Based on nmap's Target Specification :-
+
+    http://nmap.org/book/man-target-specification.html
+"""
+
+from netaddr.core import AddrFormatError
+from netaddr.ip import IPAddress, IPNetwork
+from netaddr.compat import _iter_range, _is_str, _iter_next
+
+
+def _nmap_octet_target_values(spec):
+    #   Generates sequence of values for an individual octet as defined in the
+    #   nmap Target Specification.
+    values = set()
+
+    for element in spec.split(','):
+        if '-' in element:
+            left, right = element.split('-', 1)
+            if not left:
+                left = 0
+            if not right:
+                right = 255
+            low = int(left)
+            high = int(right)
+            if not ((0 <= low <= 255) and (0 <= high <= 255)):
+                raise ValueError('octet value overflow for spec %s!' % (spec,))
+            if low > high:
+                raise ValueError('left side of hyphen must be <= right %r' % (element,))
+            for octet in _iter_range(low, high + 1):
+                values.add(octet)
+        else:
+            octet = int(element)
+            if not (0 <= octet <= 255):
+                raise ValueError('octet value overflow for spec %s!' % (spec,))
+            values.add(octet)
+
+    return sorted(values)
+
+
+def _generate_nmap_octet_ranges(nmap_target_spec):
+    #   Generate 4 lists containing all octets defined by a given nmap Target
+    #   specification.
+    if not _is_str(nmap_target_spec):
+        raise TypeError('string expected, not %s' % type(nmap_target_spec))
+
+    if not nmap_target_spec:
+        raise ValueError('nmap target specification cannot be blank!')
+
+    tokens = nmap_target_spec.split('.')
+
+    if len(tokens) != 4:
+        raise AddrFormatError('invalid nmap range: %s' % (nmap_target_spec,))
+
+    return (_nmap_octet_target_values(tokens[0]),
+            _nmap_octet_target_values(tokens[1]),
+            _nmap_octet_target_values(tokens[2]),
+            _nmap_octet_target_values(tokens[3]))
+
+
+def _parse_nmap_target_spec(target_spec):
+    if '/' in target_spec:
+        _, prefix = target_spec.split('/', 1)
+        if not (0 < int(prefix) < 33):
+            raise AddrFormatError('CIDR prefix expected, not %s' % (prefix,))
+        net = IPNetwork(target_spec)
+        if net.version != 4:
+            raise AddrFormatError('CIDR only support for IPv4!')
+        for ip in net:
+            yield ip
+    elif ':' in target_spec:
+        #   nmap only currently supports IPv6 addresses without prefixes.
+        yield IPAddress(target_spec)
+    else:
+        octet_ranges = _generate_nmap_octet_ranges(target_spec)
+        for w in octet_ranges[0]:
+            for x in octet_ranges[1]:
+                for y in octet_ranges[2]:
+                    for z in octet_ranges[3]:
+                        yield IPAddress("%d.%d.%d.%d" % (w, x, y, z), 4)
+
+
+def valid_nmap_range(target_spec):
+    """
+    :param target_spec: an nmap-style IP range target specification.
+
+    :return: ``True`` if IP range target spec is valid, ``False`` otherwise.
+    """
+    try:
+        _iter_next(_parse_nmap_target_spec(target_spec))
+        return True
+    except (TypeError, ValueError, AddrFormatError):
+        pass
+    return False
+
+
+def iter_nmap_range(*nmap_target_spec):
+    """
+    An generator that yields IPAddress objects from defined by nmap target
+    specifications.
+
+    See https://nmap.org/book/man-target-specification.html for details.
+
+    :param *nmap_target_spec: one or more nmap IP range target specification.
+
+    :return: an iterator producing IPAddress objects for each IP in the target spec(s).
+    """
+    for target_spec in nmap_target_spec:
+        for addr in _parse_nmap_target_spec(target_spec):
+            yield addr
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/rfc1924.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/rfc1924.py
new file mode 100644
index 0000000000000000000000000000000000000000..54fb96cc70c9a03420459d368a035c07157074c1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/rfc1924.py
@@ -0,0 +1,61 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""A basic implementation of RFC 1924 ;-)"""
+
+from netaddr.core import AddrFormatError
+from netaddr.ip import IPAddress
+
+from netaddr.compat import _zip
+
+
+def chr_range(low, high):
+    """Returns all characters between low and high chars."""
+    return [chr(i) for i in range(ord(low), ord(high) + 1)]
+
+#: Base 85 integer index to character lookup table.
+BASE_85 = (
+    chr_range('0', '9') + chr_range('A', 'Z') +
+    chr_range('a', 'z') +
+    ['!', '#', '$', '%', '&', '(', ')', '*', '+', '-', ';', '<', '=', '>',
+     '?', '@', '^', '_', '`', '{', '|', '}', '~']
+)
+
+#: Base 85 digit to integer lookup table.
+BASE_85_DICT = dict(_zip(BASE_85, range(0, 86)))
+
+
+def ipv6_to_base85(addr):
+    """Convert a regular IPv6 address to base 85."""
+    ip = IPAddress(addr)
+    int_val = int(ip)
+
+    remainder = []
+    while int_val > 0:
+        remainder.append(int_val % 85)
+        int_val //= 85
+
+    encoded = ''.join([BASE_85[w] for w in reversed(remainder)])
+    leading_zeroes = (20 - len(encoded)) * "0"
+    return leading_zeroes + encoded
+
+
+def base85_to_ipv6(addr):
+    """
+    Convert a base 85 IPv6 address to its hexadecimal format.
+    """
+    tokens = list(addr)
+
+    if len(tokens) != 20:
+        raise AddrFormatError('Invalid base 85 IPv6 address: %r' % (addr,))
+
+    result = 0
+    for i, num in enumerate(reversed(tokens)):
+        num = BASE_85_DICT[num]
+        result += (num * 85 ** i)
+
+    ip = IPAddress(result, 6)
+
+    return str(ip)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/sets.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/sets.py
new file mode 100644
index 0000000000000000000000000000000000000000..173224b2cf8c6a6a0f4afa52633e86f2f1ab0185
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/ip/sets.py
@@ -0,0 +1,748 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""Set based operations for IP addresses and subnets."""
+
+import itertools as _itertools
+
+from netaddr.ip import (IPNetwork, IPAddress, IPRange, cidr_merge,
+    cidr_exclude, iprange_to_cidrs)
+
+from netaddr.compat import _sys_maxint, _dict_keys, _int_type
+
+
+def _subtract(supernet, subnets, subnet_idx, ranges):
+    """Calculate IPSet([supernet]) - IPSet(subnets).
+
+    Assumptions: subnets is sorted, subnet_idx points to the first
+    element in subnets that is a subnet of supernet.
+
+    Results are appended to the ranges parameter as tuples of in format
+    (version, first, last). Return value is the first subnet_idx that
+    does not point to a subnet of supernet (or len(subnets) if all
+    subsequents items are a subnet of supernet).
+    """
+    version = supernet._module.version
+    subnet = subnets[subnet_idx]
+    if subnet.first > supernet.first:
+        ranges.append((version, supernet.first, subnet.first - 1))
+
+    subnet_idx += 1
+    prev_subnet = subnet
+    while subnet_idx < len(subnets):
+        cur_subnet = subnets[subnet_idx]
+
+        if cur_subnet not in supernet:
+            break
+        if prev_subnet.last + 1 == cur_subnet.first:
+            # two adjacent, non-mergable IPNetworks
+            pass
+        else:
+            ranges.append((version, prev_subnet.last + 1, cur_subnet.first - 1))
+
+        subnet_idx += 1
+        prev_subnet = cur_subnet
+
+    first = prev_subnet.last + 1
+    last = supernet.last
+    if first <= last:
+        ranges.append((version, first, last))
+
+    return subnet_idx
+
+
+def _iter_merged_ranges(sorted_ranges):
+    """Iterate over sorted_ranges, merging where possible
+
+    Sorted ranges must be a sorted iterable of (version, first, last) tuples.
+    Merging occurs for pairs like [(4, 10, 42), (4, 43, 100)] which is merged
+    into (4, 10, 100), and leads to return value
+    ( IPAddress(10, 4), IPAddress(100, 4) ), which is suitable input for the
+    iprange_to_cidrs function.
+    """
+    if not sorted_ranges:
+        return
+
+    current_version, current_start, current_stop = sorted_ranges[0]
+
+    for next_version, next_start, next_stop in sorted_ranges[1:]:
+        if next_start == current_stop + 1 and next_version == current_version:
+            # Can be merged.
+            current_stop = next_stop
+            continue
+        # Cannot be merged.
+        yield (IPAddress(current_start, current_version),
+               IPAddress(current_stop, current_version))
+        current_start = next_start
+        current_stop = next_stop
+        current_version = next_version
+    yield (IPAddress(current_start, current_version),
+           IPAddress(current_stop, current_version))
+
+
+class IPSet(object):
+    """
+    Represents an unordered collection (set) of unique IP addresses and
+    subnets.
+
+    """
+    __slots__ = ('_cidrs', '__weakref__')
+
+    def __init__(self, iterable=None, flags=0):
+        """
+        Constructor.
+
+        :param iterable: (optional) an iterable containing IP addresses,
+            subnets or ranges.
+
+        :param flags: decides which rules are applied to the interpretation
+            of the addr value. See the netaddr.core namespace documentation
+            for supported constant values.
+
+        """
+        if isinstance(iterable, IPNetwork):
+            self._cidrs = {iterable.cidr: True}
+        elif isinstance(iterable, IPRange):
+            self._cidrs = dict.fromkeys(
+                iprange_to_cidrs(iterable[0], iterable[-1]), True)
+        elif isinstance(iterable, IPSet):
+            self._cidrs = dict.fromkeys(iterable.iter_cidrs(), True)
+        else:
+            self._cidrs = {}
+            if iterable is not None:
+                mergeable = []
+                for addr in iterable:
+                    if isinstance(addr, _int_type):
+                        addr = IPAddress(addr, flags=flags)
+                    mergeable.append(addr)
+
+                for cidr in cidr_merge(mergeable):
+                    self._cidrs[cidr] = True
+
+    def __getstate__(self):
+        """:return: Pickled state of an ``IPSet`` object."""
+        return tuple([cidr.__getstate__() for cidr in self._cidrs])
+
+    def __setstate__(self, state):
+        """
+        :param state: data used to unpickle a pickled ``IPSet`` object.
+
+        """
+        self._cidrs = dict.fromkeys(
+            (IPNetwork((value, prefixlen), version=version)
+             for value, prefixlen, version in state),
+            True)
+
+    def _compact_single_network(self, added_network):
+        """
+        Same as compact(), but assume that added_network is the only change and
+        that this IPSet was properly compacted before added_network was added.
+        This allows to perform compaction much faster. added_network must
+        already be present in self._cidrs.
+        """
+        added_first = added_network.first
+        added_last = added_network.last
+        added_version = added_network.version
+
+        # Check for supernets and subnets of added_network.
+        if added_network._prefixlen == added_network._module.width:
+            # This is a single IP address, i.e. /32 for IPv4 or /128 for IPv6.
+            # It does not have any subnets, so we only need to check for its
+            # potential supernets.
+            for potential_supernet in added_network.supernet():
+                if potential_supernet in self._cidrs:
+                    del self._cidrs[added_network]
+                    return
+        else:
+            # IPNetworks from self._cidrs that are subnets of added_network.
+            to_remove = []
+            for cidr in self._cidrs:
+                if (cidr._module.version != added_version or cidr == added_network):
+                    # We found added_network or some network of a different version.
+                    continue
+                first = cidr.first
+                last = cidr.last
+                if first >= added_first and last <= added_last:
+                    # cidr is a subnet of added_network. Remember to remove it.
+                    to_remove.append(cidr)
+                elif first <= added_first and last >= added_last:
+                    # cidr is a supernet of added_network. Remove added_network.
+                    del self._cidrs[added_network]
+                    # This IPSet was properly compacted before. Since added_network
+                    # is removed now, it must again be properly compacted -> done.
+                    assert (not to_remove)
+                    return
+            for item in to_remove:
+                del self._cidrs[item]
+
+        # Check if added_network can be merged with another network.
+
+        # Note that merging can only happen between networks of the same
+        # prefixlen. This just leaves 2 candidates: The IPNetworks just before
+        # and just after the added_network.
+        # This can be reduced to 1 candidate: 10.0.0.0/24 and 10.0.1.0/24 can
+        # be merged into into 10.0.0.0/23. But 10.0.1.0/24 and 10.0.2.0/24
+        # cannot be merged. With only 1 candidate, we might as well make a
+        # dictionary lookup.
+        shift_width = added_network._module.width - added_network.prefixlen
+        while added_network.prefixlen != 0:
+            # figure out if the least significant bit of the network part is 0 or 1.
+            the_bit = (added_network._value >> shift_width) & 1
+            if the_bit:
+                candidate = added_network.previous()
+            else:
+                candidate = added_network.next()
+
+            if candidate not in self._cidrs:
+                # The only possible merge does not work -> merge done
+                return
+            # Remove added_network&candidate, add merged network.
+            del self._cidrs[candidate]
+            del self._cidrs[added_network]
+            added_network.prefixlen -= 1
+            # Be sure that we set the host bits to 0 when we move the prefixlen.
+            # Otherwise, adding 255.255.255.255/32 will result in a merged
+            # 255.255.255.255/24 network, but we want 255.255.255.0/24.
+            shift_width += 1
+            added_network._value = (added_network._value >> shift_width) << shift_width
+            self._cidrs[added_network] = True
+
+    def compact(self):
+        """
+        Compact internal list of `IPNetwork` objects using a CIDR merge.
+        """
+        cidrs = cidr_merge(self._cidrs)
+        self._cidrs = dict.fromkeys(cidrs, True)
+
+    def __hash__(self):
+        """
+        Raises ``TypeError`` if this method is called.
+
+        .. note:: IPSet objects are not hashable and cannot be used as \
+            dictionary keys or as members of other sets. \
+        """
+        raise TypeError('IP sets are unhashable!')
+
+    def __contains__(self, ip):
+        """
+        :param ip: An IP address or subnet.
+
+        :return: ``True`` if IP address or subnet is a member of this IP set.
+        """
+        # Iterating over self._cidrs is an O(n) operation: 1000 items in
+        # self._cidrs would mean 1000 loops. Iterating over all possible
+        # supernets loops at most 32 times for IPv4 or 128 times for IPv6,
+        # no matter how many CIDRs this object contains.
+        supernet = IPNetwork(ip)
+        if supernet in self._cidrs:
+            return True
+        while supernet._prefixlen:
+            supernet._prefixlen -= 1
+            if supernet in self._cidrs:
+                return True
+        return False
+
+    def __nonzero__(self):
+        """Return True if IPSet contains at least one IP, else False"""
+        return bool(self._cidrs)
+
+    __bool__ = __nonzero__  #   Python 3.x.
+
+    def __iter__(self):
+        """
+        :return: an iterator over the IP addresses within this IP set.
+        """
+        return _itertools.chain(*sorted(self._cidrs))
+
+    def iter_cidrs(self):
+        """
+        :return: an iterator over individual IP subnets within this IP set.
+        """
+        return sorted(self._cidrs)
+
+    def add(self, addr, flags=0):
+        """
+        Adds an IP address or subnet or IPRange to this IP set. Has no effect if
+        it is already present.
+
+        Note that where possible the IP address or subnet is merged with other
+        members of the set to form more concise CIDR blocks.
+
+        :param addr: An IP address or subnet in either string or object form, or
+            an IPRange object.
+
+        :param flags: decides which rules are applied to the interpretation
+            of the addr value. See the netaddr.core namespace documentation
+            for supported constant values.
+
+        """
+        if isinstance(addr, IPRange):
+            new_cidrs = dict.fromkeys(
+                iprange_to_cidrs(addr[0], addr[-1]), True)
+            self._cidrs.update(new_cidrs)
+            self.compact()
+            return
+        if isinstance(addr, IPNetwork):
+            # Networks like 10.1.2.3/8 need to be normalized to 10.0.0.0/8
+            addr = addr.cidr
+        elif isinstance(addr, _int_type):
+            addr = IPNetwork(IPAddress(addr, flags=flags))
+        else:
+            addr = IPNetwork(addr)
+
+        self._cidrs[addr] = True
+        self._compact_single_network(addr)
+
+    def remove(self, addr, flags=0):
+        """
+        Removes an IP address or subnet or IPRange from this IP set. Does
+        nothing if it is not already a member.
+
+        Note that this method behaves more like discard() found in regular
+        Python sets because it doesn't raise KeyError exceptions if the
+        IP address or subnet is question does not exist. It doesn't make sense
+        to fully emulate that behaviour here as IP sets contain groups of
+        individual IP addresses as individual set members using IPNetwork
+        objects.
+
+        :param addr: An IP address or subnet, or an IPRange.
+
+        :param flags: decides which rules are applied to the interpretation
+            of the addr value. See the netaddr.core namespace documentation
+            for supported constant values.
+
+        """
+        if isinstance(addr, IPRange):
+            cidrs = iprange_to_cidrs(addr[0], addr[-1])
+            for cidr in cidrs:
+                self.remove(cidr)
+            return
+
+        if isinstance(addr, _int_type):
+            addr = IPAddress(addr, flags=flags)
+        else:
+            addr = IPNetwork(addr)
+
+        #   This add() is required for address blocks provided that are larger
+        #   than blocks found within the set but have overlaps. e.g. :-
+        #
+        #   >>> IPSet(['192.0.2.0/24']).remove('192.0.2.0/23')
+        #   IPSet([])
+        #
+        self.add(addr)
+
+        remainder = None
+        matching_cidr = None
+
+        #   Search for a matching CIDR and exclude IP from it.
+        for cidr in self._cidrs:
+            if addr in cidr:
+                remainder = cidr_exclude(cidr, addr)
+                matching_cidr = cidr
+                break
+
+        #   Replace matching CIDR with remaining CIDR elements.
+        if remainder is not None:
+            del self._cidrs[matching_cidr]
+            for cidr in remainder:
+                self._cidrs[cidr] = True
+                # No call to self.compact() is needed. Removing an IPNetwork cannot
+                # create mergable networks.
+
+    def pop(self):
+        """
+        Removes and returns an arbitrary IP address or subnet from this IP
+        set.
+
+        :return: An IP address or subnet.
+        """
+        return self._cidrs.popitem()[0]
+
+    def isdisjoint(self, other):
+        """
+        :param other: an IP set.
+
+        :return: ``True`` if this IP set has no elements (IP addresses
+            or subnets) in common with other. Intersection *must* be an
+            empty set.
+        """
+        result = self.intersection(other)
+        return not result
+
+    def copy(self):
+        """:return: a shallow copy of this IP set."""
+        obj_copy = self.__class__()
+        obj_copy._cidrs.update(self._cidrs)
+        return obj_copy
+
+    def update(self, iterable, flags=0):
+        """
+        Update the contents of this IP set with the union of itself and
+        other IP set.
+
+        :param iterable: an iterable containing IP addresses, subnets or ranges.
+
+        :param flags: decides which rules are applied to the interpretation
+            of the addr value. See the netaddr.core namespace documentation
+            for supported constant values.
+
+        """
+        if isinstance(iterable, IPSet):
+            self._cidrs = dict.fromkeys(
+                (ip for ip in cidr_merge(_dict_keys(self._cidrs)
+                                         + _dict_keys(iterable._cidrs))), True)
+            return
+        elif isinstance(iterable, (IPNetwork, IPRange)):
+            self.add(iterable)
+            return
+
+        if not hasattr(iterable, '__iter__'):
+            raise TypeError('an iterable was expected!')
+        #   An iterable containing IP addresses or subnets.
+        mergeable = []
+        for addr in iterable:
+            if isinstance(addr, _int_type):
+                addr = IPAddress(addr, flags=flags)
+            mergeable.append(addr)
+
+        for cidr in cidr_merge(_dict_keys(self._cidrs) + mergeable):
+            self._cidrs[cidr] = True
+
+        self.compact()
+
+    def clear(self):
+        """Remove all IP addresses and subnets from this IP set."""
+        self._cidrs = {}
+
+    def __eq__(self, other):
+        """
+        :param other: an IP set
+
+        :return: ``True`` if this IP set is equivalent to the ``other`` IP set,
+            ``False`` otherwise.
+        """
+        try:
+            return self._cidrs == other._cidrs
+        except AttributeError:
+            return NotImplemented
+
+    def __ne__(self, other):
+        """
+        :param other: an IP set
+
+        :return: ``False`` if this IP set is equivalent to the ``other`` IP set,
+            ``True`` otherwise.
+        """
+        try:
+            return self._cidrs != other._cidrs
+        except AttributeError:
+            return NotImplemented
+
+    def __lt__(self, other):
+        """
+        :param other: an IP set
+
+        :return: ``True`` if this IP set is less than the ``other`` IP set,
+            ``False`` otherwise.
+        """
+        if not hasattr(other, '_cidrs'):
+            return NotImplemented
+
+        return self.size < other.size and self.issubset(other)
+
+    def issubset(self, other):
+        """
+        :param other: an IP set.
+
+        :return: ``True`` if every IP address and subnet in this IP set
+            is found within ``other``.
+        """
+        for cidr in self._cidrs:
+            if cidr not in other:
+                return False
+        return True
+
+    __le__ = issubset
+
+    def __gt__(self, other):
+        """
+        :param other: an IP set.
+
+        :return: ``True`` if this IP set is greater than the ``other`` IP set,
+            ``False`` otherwise.
+        """
+        if not hasattr(other, '_cidrs'):
+            return NotImplemented
+
+        return self.size > other.size and self.issuperset(other)
+
+    def issuperset(self, other):
+        """
+        :param other: an IP set.
+
+        :return: ``True`` if every IP address and subnet in other IP set
+            is found within this one.
+        """
+        if not hasattr(other, '_cidrs'):
+            return NotImplemented
+
+        for cidr in other._cidrs:
+            if cidr not in self:
+                return False
+        return True
+
+    __ge__ = issuperset
+
+    def union(self, other):
+        """
+        :param other: an IP set.
+
+        :return: the union of this IP set and another as a new IP set
+            (combines IP addresses and subnets from both sets).
+        """
+        ip_set = self.copy()
+        ip_set.update(other)
+        return ip_set
+
+    __or__ = union
+
+    def intersection(self, other):
+        """
+        :param other: an IP set.
+
+        :return: the intersection of this IP set and another as a new IP set.
+            (IP addresses and subnets common to both sets).
+        """
+        result_cidrs = {}
+
+        own_nets = sorted(self._cidrs)
+        other_nets = sorted(other._cidrs)
+        own_idx = 0
+        other_idx = 0
+        own_len = len(own_nets)
+        other_len = len(other_nets)
+        while own_idx < own_len and other_idx < other_len:
+            own_cur = own_nets[own_idx]
+            other_cur = other_nets[other_idx]
+
+            if own_cur == other_cur:
+                result_cidrs[own_cur] = True
+                own_idx += 1
+                other_idx += 1
+            elif own_cur in other_cur:
+                result_cidrs[own_cur] = True
+                own_idx += 1
+            elif other_cur in own_cur:
+                result_cidrs[other_cur] = True
+                other_idx += 1
+            else:
+                # own_cur and other_cur have nothing in common
+                if own_cur < other_cur:
+                    own_idx += 1
+                else:
+                    other_idx += 1
+
+        # We ran out of networks in own_nets or other_nets. Either way, there
+        # can be no further result_cidrs.
+        result = IPSet()
+        result._cidrs = result_cidrs
+        return result
+
+    __and__ = intersection
+
+    def symmetric_difference(self, other):
+        """
+        :param other: an IP set.
+
+        :return: the symmetric difference of this IP set and another as a new
+            IP set (all IP addresses and subnets that are in exactly one
+            of the sets).
+        """
+        # In contrast to intersection() and difference(), we cannot construct
+        # the result_cidrs easily. Some cidrs may have to be merged, e.g. for
+        # IPSet(["10.0.0.0/32"]).symmetric_difference(IPSet(["10.0.0.1/32"])).
+        result_ranges = []
+
+        own_nets = sorted(self._cidrs)
+        other_nets = sorted(other._cidrs)
+        own_idx = 0
+        other_idx = 0
+        own_len = len(own_nets)
+        other_len = len(other_nets)
+        while own_idx < own_len and other_idx < other_len:
+            own_cur = own_nets[own_idx]
+            other_cur = other_nets[other_idx]
+
+            if own_cur == other_cur:
+                own_idx += 1
+                other_idx += 1
+            elif own_cur in other_cur:
+                own_idx = _subtract(other_cur, own_nets, own_idx, result_ranges)
+                other_idx += 1
+            elif other_cur in own_cur:
+                other_idx = _subtract(own_cur, other_nets, other_idx, result_ranges)
+                own_idx += 1
+            else:
+                # own_cur and other_cur have nothing in common
+                if own_cur < other_cur:
+                    result_ranges.append((own_cur._module.version,
+                                          own_cur.first, own_cur.last))
+                    own_idx += 1
+                else:
+                    result_ranges.append((other_cur._module.version,
+                                          other_cur.first, other_cur.last))
+                    other_idx += 1
+
+        # If the above loop terminated because it processed all cidrs of
+        # "other", then any remaining cidrs in self must be part of the result.
+        while own_idx < own_len:
+            own_cur = own_nets[own_idx]
+            result_ranges.append((own_cur._module.version,
+                                  own_cur.first, own_cur.last))
+            own_idx += 1
+
+        # If the above loop terminated because it processed all cidrs of
+        # self, then any remaining cidrs in "other" must be part of the result.
+        while other_idx < other_len:
+            other_cur = other_nets[other_idx]
+            result_ranges.append((other_cur._module.version,
+                                  other_cur.first, other_cur.last))
+            other_idx += 1
+
+        result = IPSet()
+        for start, stop in _iter_merged_ranges(result_ranges):
+            cidrs = iprange_to_cidrs(start, stop)
+            for cidr in cidrs:
+                result._cidrs[cidr] = True
+        return result
+
+    __xor__ = symmetric_difference
+
+    def difference(self, other):
+        """
+        :param other: an IP set.
+
+        :return: the difference between this IP set and another as a new IP
+            set (all IP addresses and subnets that are in this IP set but
+            not found in the other.)
+        """
+        result_ranges = []
+        result_cidrs = {}
+
+        own_nets = sorted(self._cidrs)
+        other_nets = sorted(other._cidrs)
+        own_idx = 0
+        other_idx = 0
+        own_len = len(own_nets)
+        other_len = len(other_nets)
+        while own_idx < own_len and other_idx < other_len:
+            own_cur = own_nets[own_idx]
+            other_cur = other_nets[other_idx]
+
+            if own_cur == other_cur:
+                own_idx += 1
+                other_idx += 1
+            elif own_cur in other_cur:
+                own_idx += 1
+            elif other_cur in own_cur:
+                other_idx = _subtract(own_cur, other_nets, other_idx,
+                                      result_ranges)
+                own_idx += 1
+            else:
+                # own_cur and other_cur have nothing in common
+                if own_cur < other_cur:
+                    result_cidrs[own_cur] = True
+                    own_idx += 1
+                else:
+                    other_idx += 1
+
+        # If the above loop terminated because it processed all cidrs of
+        # "other", then any remaining cidrs in self must be part of the result.
+        while own_idx < own_len:
+            result_cidrs[own_nets[own_idx]] = True
+            own_idx += 1
+
+        for start, stop in _iter_merged_ranges(result_ranges):
+            for cidr in iprange_to_cidrs(start, stop):
+                result_cidrs[cidr] = True
+
+        result = IPSet()
+        result._cidrs = result_cidrs
+        return result
+
+    __sub__ = difference
+
+    def __len__(self):
+        """
+        :return: the cardinality of this IP set (i.e. sum of individual IP \
+            addresses). Raises ``IndexError`` if size > maxint (a Python \
+            limitation). Use the .size property for subnets of any size.
+        """
+        size = self.size
+        if size > _sys_maxint:
+            raise IndexError(
+                "range contains more than %d (sys.maxint) IP addresses!"
+                "Use the .size property instead." % _sys_maxint)
+        return size
+
+    @property
+    def size(self):
+        """
+        The cardinality of this IP set (based on the number of individual IP
+        addresses including those implicitly defined in subnets).
+        """
+        return sum([cidr.size for cidr in self._cidrs])
+
+    def __repr__(self):
+        """:return: Python statement to create an equivalent object"""
+        return 'IPSet(%r)' % [str(c) for c in sorted(self._cidrs)]
+
+    __str__ = __repr__
+
+    def iscontiguous(self):
+        """
+        Returns True if the members of the set form a contiguous IP
+        address range (with no gaps), False otherwise.
+
+        :return: ``True`` if the ``IPSet`` object is contiguous.
+        """
+        cidrs = self.iter_cidrs()
+        if len(cidrs) > 1:
+            previous = cidrs[0][0]
+            for cidr in cidrs:
+                if cidr[0] != previous:
+                    return False
+                previous = cidr[-1] + 1
+        return True
+
+    def iprange(self):
+        """
+        Generates an IPRange for this IPSet, if all its members
+        form a single contiguous sequence.
+
+        Raises ``ValueError`` if the set is not contiguous.
+
+        :return: An ``IPRange`` for all IPs in the IPSet.
+        """
+        if self.iscontiguous():
+            cidrs = self.iter_cidrs()
+            if not cidrs:
+                return None
+            return IPRange(cidrs[0][0], cidrs[-1][-1])
+        else:
+            raise ValueError("IPSet is not contiguous")
+
+    def iter_ipranges(self):
+        """Generate the merged IPRanges for this IPSet.
+
+        In contrast to self.iprange(), this will work even when the IPSet is
+        not contiguous. Adjacent IPRanges will be merged together, so you
+        get the minimal number of IPRanges.
+        """
+        sorted_ranges = [(cidr._module.version, cidr.first, cidr.last) for
+                         cidr in self.iter_cidrs()]
+
+        for start, stop in _iter_merged_ranges(sorted_ranges):
+            yield IPRange(start, stop)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..7b5861da0ff250172511c5ba0edd8d8c08406e13
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/__init__.py
@@ -0,0 +1,273 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+Shared logic for various address types.
+"""
+import re as _re
+
+from netaddr.compat import _range, _is_str
+
+
+def bytes_to_bits():
+    """
+    :return: A 256 element list containing 8-bit binary digit strings. The
+        list index value is equivalent to its bit string value.
+    """
+    lookup = []
+    bits_per_byte = _range(7, -1, -1)
+    for num in range(256):
+        bits = 8 * [None]
+        for i in bits_per_byte:
+            bits[i] = '01'[num & 1]
+            num >>= 1
+        lookup.append(''.join(bits))
+    return lookup
+
+#: A lookup table of 8-bit integer values to their binary digit bit strings.
+BYTES_TO_BITS = bytes_to_bits()
+
+
+def valid_words(words, word_size, num_words):
+    """
+    :param words: A sequence of unsigned integer word values.
+
+    :param word_size: Width (in bits) of each unsigned integer word value.
+
+    :param num_words: Number of unsigned integer words expected.
+
+    :return: ``True`` if word sequence is valid for this address type,
+        ``False`` otherwise.
+    """
+    if not hasattr(words, '__iter__'):
+        return False
+
+    if len(words) != num_words:
+        return False
+
+    max_word = 2 ** word_size - 1
+
+    for i in words:
+        if not 0 <= i <= max_word:
+            return False
+
+    return True
+
+
+def int_to_words(int_val, word_size, num_words):
+    """
+    :param int_val: Unsigned integer to be divided into words of equal size.
+
+    :param word_size: Width (in bits) of each unsigned integer word value.
+
+    :param num_words: Number of unsigned integer words expected.
+
+    :return: A tuple contain unsigned integer word values split according
+        to provided arguments.
+    """
+    max_int = 2 ** (num_words * word_size) - 1
+
+    if not 0 <= int_val <= max_int:
+        raise IndexError('integer out of bounds: %r!' % hex(int_val))
+
+    max_word = 2 ** word_size - 1
+
+    words = []
+    for _ in range(num_words):
+        word = int_val & max_word
+        words.append(int(word))
+        int_val >>= word_size
+
+    return tuple(reversed(words))
+
+
+def words_to_int(words, word_size, num_words):
+    """
+    :param words: A sequence of unsigned integer word values.
+
+    :param word_size: Width (in bits) of each unsigned integer word value.
+
+    :param num_words: Number of unsigned integer words expected.
+
+    :return: An unsigned integer that is equivalent to value represented
+        by word sequence.
+    """
+    if not valid_words(words, word_size, num_words):
+        raise ValueError('invalid integer word sequence: %r!' % (words,))
+
+    int_val = 0
+    for i, num in enumerate(reversed(words)):
+        word = num
+        word = word << word_size * i
+        int_val = int_val | word
+
+    return int_val
+
+
+def valid_bits(bits, width, word_sep=''):
+    """
+    :param bits: A network address in a delimited binary string format.
+
+    :param width: Maximum width (in bits) of a network address (excluding
+        delimiters).
+
+    :param word_sep: (optional) character or string used to delimit word
+        groups (default: '', no separator).
+
+    :return: ``True`` if network address is valid, ``False`` otherwise.
+    """
+    if not _is_str(bits):
+        return False
+
+    if word_sep != '':
+        bits = bits.replace(word_sep, '')
+
+    if len(bits) != width:
+        return False
+
+    max_int = 2 ** width - 1
+
+    try:
+        if 0 <= int(bits, 2) <= max_int:
+            return True
+    except ValueError:
+        pass
+
+    return False
+
+
+def bits_to_int(bits, width, word_sep=''):
+    """
+    :param bits: A network address in a delimited binary string format.
+
+    :param width: Maximum width (in bits) of a network address (excluding
+        delimiters).
+
+    :param word_sep: (optional) character or string used to delimit word
+        groups (default: '', no separator).
+
+    :return: An unsigned integer that is equivalent to value represented
+        by network address in readable binary form.
+    """
+    if not valid_bits(bits, width, word_sep):
+        raise ValueError('invalid readable binary string: %r!' % (bits,))
+
+    if word_sep != '':
+        bits = bits.replace(word_sep, '')
+
+    return int(bits, 2)
+
+
+def int_to_bits(int_val, word_size, num_words, word_sep=''):
+    """
+    :param int_val: An unsigned integer.
+
+    :param word_size: Width (in bits) of each unsigned integer word value.
+
+    :param num_words: Number of unsigned integer words expected.
+
+    :param word_sep: (optional) character or string used to delimit word
+        groups (default: '', no separator).
+
+    :return: A network address in a delimited binary string format that is
+        equivalent in value to unsigned integer.
+    """
+    bit_words = []
+
+    for word in int_to_words(int_val, word_size, num_words):
+        bits = []
+        while word:
+            bits.append(BYTES_TO_BITS[word & 255])
+            word >>= 8
+        bits.reverse()
+        bit_str = ''.join(bits) or '0' * word_size
+        bits = ('0' * word_size + bit_str)[-word_size:]
+        bit_words.append(bits)
+
+    if word_sep != '':
+        #   Check custom separator.
+        if not _is_str(word_sep):
+            raise ValueError('word separator is not a string: %r!' % (word_sep,))
+
+    return word_sep.join(bit_words)
+
+
+def valid_bin(bin_val, width):
+    """
+    :param bin_val: A network address in Python's binary representation format
+        ('0bxxx').
+
+    :param width: Maximum width (in bits) of a network address (excluding
+        delimiters).
+
+    :return: ``True`` if network address is valid, ``False`` otherwise.
+    """
+    if not _is_str(bin_val):
+        return False
+
+    if not bin_val.startswith('0b'):
+        return False
+
+    bin_val = bin_val.replace('0b', '')
+
+    if len(bin_val) > width:
+        return False
+
+    max_int = 2 ** width - 1
+
+    try:
+        if 0 <= int(bin_val, 2) <= max_int:
+            return True
+    except ValueError:
+        pass
+
+    return False
+
+
+def int_to_bin(int_val, width):
+    """
+    :param int_val: An unsigned integer.
+
+    :param width: Maximum allowed width (in bits) of a unsigned integer.
+
+    :return: Equivalent string value in Python's binary representation format
+        ('0bxxx').
+    """
+    bin_tokens = []
+
+    try:
+        #   Python 2.6.x and upwards.
+        bin_val = bin(int_val)
+    except NameError:
+        #   Python 2.4.x and 2.5.x
+        i = int_val
+        while i > 0:
+            word = i & 0xff
+            bin_tokens.append(BYTES_TO_BITS[word])
+            i >>= 8
+
+        bin_tokens.reverse()
+        bin_val = '0b' + _re.sub(r'^[0]+([01]+)$', r'\1', ''.join(bin_tokens))
+
+    if len(bin_val[2:]) > width:
+        raise IndexError('binary string out of bounds: %s!' % (bin_val,))
+
+    return bin_val
+
+
+def bin_to_int(bin_val, width):
+    """
+    :param bin_val: A string containing an unsigned integer in Python's binary
+        representation format ('0bxxx').
+
+    :param width: Maximum allowed width (in bits) of a unsigned integer.
+
+    :return: An unsigned integer that is equivalent to value represented
+        by Python binary string format.
+    """
+    if not valid_bin(bin_val, width):
+        raise ValueError('not a valid Python binary string: %r!' % (bin_val,))
+
+    return int(bin_val.replace('0b', ''), 2)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui48.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui48.py
new file mode 100644
index 0000000000000000000000000000000000000000..5685e34eaedead32f517e5774ff2aed6e125c01b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui48.py
@@ -0,0 +1,296 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+IEEE 48-bit EUI (MAC address) logic.
+
+Supports numerous MAC string formats including Cisco's triple hextet as well
+as bare MACs containing no delimiters.
+"""
+import struct as _struct
+import re as _re
+
+#   Check whether we need to use fallback code or not.
+try:
+    from socket import AF_LINK
+except ImportError:
+    AF_LINK = 48
+
+from netaddr.core import AddrFormatError
+from netaddr.compat import _is_str
+from netaddr.strategy import (
+    valid_words as _valid_words, int_to_words as _int_to_words,
+    words_to_int as _words_to_int, valid_bits as _valid_bits,
+    bits_to_int as _bits_to_int, int_to_bits as _int_to_bits,
+    valid_bin as _valid_bin, int_to_bin as _int_to_bin,
+    bin_to_int as _bin_to_int)
+
+#: The width (in bits) of this address type.
+width = 48
+
+#: The AF_* constant value of this address type.
+family = AF_LINK
+
+#: A friendly string name address type.
+family_name = 'MAC'
+
+#: The version of this address type.
+version = 48
+
+#: The maximum integer value that can be represented by this address type.
+max_int = 2 ** width - 1
+
+#-----------------------------------------------------------------------------
+#   Dialect classes.
+#-----------------------------------------------------------------------------
+
+class mac_eui48(object):
+    """A standard IEEE EUI-48 dialect class."""
+    #: The individual word size (in bits) of this address type.
+    word_size = 8
+
+    #: The number of words in this address type.
+    num_words = width // word_size
+
+    #: The maximum integer value for an individual word in this address type.
+    max_word = 2 ** word_size - 1
+
+    #: The separator character used between each word.
+    word_sep = '-'
+
+    #: The format string to be used when converting words to string values.
+    word_fmt = '%.2X'
+
+    #: The number base to be used when interpreting word values as integers.
+    word_base = 16
+
+
+class mac_unix(mac_eui48):
+    """A UNIX-style MAC address dialect class."""
+    word_size = 8
+    num_words = width // word_size
+    word_sep = ':'
+    word_fmt = '%x'
+    word_base = 16
+
+
+class mac_unix_expanded(mac_unix):
+    """A UNIX-style MAC address dialect class with leading zeroes."""
+    word_fmt = '%.2x'
+
+
+class mac_cisco(mac_eui48):
+    """A Cisco 'triple hextet' MAC address dialect class."""
+    word_size = 16
+    num_words = width // word_size
+    word_sep = '.'
+    word_fmt = '%.4x'
+    word_base = 16
+
+
+class mac_bare(mac_eui48):
+    """A bare (no delimiters) MAC address dialect class."""
+    word_size = 48
+    num_words = width // word_size
+    word_sep = ''
+    word_fmt = '%.12X'
+    word_base = 16
+
+
+class mac_pgsql(mac_eui48):
+    """A PostgreSQL style (2 x 24-bit words) MAC address dialect class."""
+    word_size = 24
+    num_words = width // word_size
+    word_sep = ':'
+    word_fmt = '%.6x'
+    word_base = 16
+
+#: The default dialect to be used when not specified by the user.
+DEFAULT_DIALECT = mac_eui48
+
+#-----------------------------------------------------------------------------
+#: Regular expressions to match all supported MAC address formats.
+RE_MAC_FORMATS = (
+    #   2 bytes x 6 (UNIX, Windows, EUI-48)
+    '^' + ':'.join(['([0-9A-F]{1,2})'] * 6) + '$',
+    '^' + '-'.join(['([0-9A-F]{1,2})'] * 6) + '$',
+
+    #   4 bytes x 3 (Cisco)
+    '^' + ':'.join(['([0-9A-F]{1,4})'] * 3) + '$',
+    '^' + '-'.join(['([0-9A-F]{1,4})'] * 3) + '$',
+    '^' + r'\.'.join(['([0-9A-F]{1,4})'] * 3) + '$',
+
+    #   6 bytes x 2 (PostgreSQL)
+    '^' + '-'.join(['([0-9A-F]{5,6})'] * 2) + '$',
+    '^' + ':'.join(['([0-9A-F]{5,6})'] * 2) + '$',
+
+    #   12 bytes (bare, no delimiters)
+    '^(' + ''.join(['[0-9A-F]'] * 12) + ')$',
+    '^(' + ''.join(['[0-9A-F]'] * 11) + ')$',
+)
+#   For efficiency, each string regexp converted in place to its compiled
+#   counterpart.
+RE_MAC_FORMATS = [_re.compile(_, _re.IGNORECASE) for _ in RE_MAC_FORMATS]
+
+
+def valid_str(addr):
+    """
+    :param addr: An IEEE EUI-48 (MAC) address in string form.
+
+    :return: ``True`` if MAC address string is valid, ``False`` otherwise.
+    """
+    for regexp in RE_MAC_FORMATS:
+        try:
+            match_result = regexp.findall(addr)
+            if len(match_result) != 0:
+                return True
+        except TypeError:
+            pass
+
+    return False
+
+
+def str_to_int(addr):
+    """
+    :param addr: An IEEE EUI-48 (MAC) address in string form.
+
+    :return: An unsigned integer that is equivalent to value represented
+        by EUI-48/MAC string address formatted according to the dialect
+        settings.
+    """
+    words = []
+    if _is_str(addr):
+        found_match = False
+        for regexp in RE_MAC_FORMATS:
+            match_result = regexp.findall(addr)
+            if len(match_result) != 0:
+                found_match = True
+                if isinstance(match_result[0], tuple):
+                    words = match_result[0]
+                else:
+                    words = (match_result[0],)
+                break
+        if not found_match:
+            raise AddrFormatError('%r is not a supported MAC format!' % (addr,))
+    else:
+        raise TypeError('%r is not str() or unicode()!' % (addr,))
+
+    int_val = None
+
+    if len(words) == 6:
+        #   2 bytes x 6 (UNIX, Windows, EUI-48)
+        int_val = int(''.join(['%.2x' % int(w, 16) for w in words]), 16)
+    elif len(words) == 3:
+        #   4 bytes x 3 (Cisco)
+        int_val = int(''.join(['%.4x' % int(w, 16) for w in words]), 16)
+    elif len(words) == 2:
+        #   6 bytes x 2 (PostgreSQL)
+        int_val = int(''.join(['%.6x' % int(w, 16) for w in words]), 16)
+    elif len(words) == 1:
+        #   12 bytes (bare, no delimiters)
+        int_val = int('%012x' % int(words[0], 16), 16)
+    else:
+        raise AddrFormatError('unexpected word count in MAC address %r!' % (addr,))
+
+    return int_val
+
+
+def int_to_str(int_val, dialect=None):
+    """
+    :param int_val: An unsigned integer.
+
+    :param dialect: (optional) a Python class defining formatting options.
+
+    :return: An IEEE EUI-48 (MAC) address string that is equivalent to
+        unsigned integer formatted according to the dialect settings.
+    """
+    if dialect is None:
+        dialect = mac_eui48
+
+    words = int_to_words(int_val, dialect)
+    tokens = [dialect.word_fmt % i for i in words]
+    addr = dialect.word_sep.join(tokens)
+
+    return addr
+
+
+def int_to_packed(int_val):
+    """
+    :param int_val: the integer to be packed.
+
+    :return: a packed string that is equivalent to value represented by an
+    unsigned integer.
+    """
+    return _struct.pack(">HI", int_val >> 32, int_val & 0xffffffff)
+
+
+def packed_to_int(packed_int):
+    """
+    :param packed_int: a packed string containing an unsigned integer.
+        It is assumed that string is packed in network byte order.
+
+    :return: An unsigned integer equivalent to value of network address
+        represented by packed binary string.
+    """
+    words = list(_struct.unpack('>6B', packed_int))
+
+    int_val = 0
+    for i, num in enumerate(reversed(words)):
+        word = num
+        word = word << 8 * i
+        int_val = int_val | word
+
+    return int_val
+
+
+def valid_words(words, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _valid_words(words, dialect.word_size, dialect.num_words)
+
+
+def int_to_words(int_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _int_to_words(int_val, dialect.word_size, dialect.num_words)
+
+
+def words_to_int(words, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _words_to_int(words, dialect.word_size, dialect.num_words)
+
+
+def valid_bits(bits, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _valid_bits(bits, width, dialect.word_sep)
+
+
+def bits_to_int(bits, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _bits_to_int(bits, width, dialect.word_sep)
+
+
+def int_to_bits(int_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _int_to_bits(
+        int_val, dialect.word_size, dialect.num_words, dialect.word_sep)
+
+
+def valid_bin(bin_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_DIALECT
+    return _valid_bin(bin_val, width)
+
+
+def int_to_bin(int_val):
+    return _int_to_bin(int_val, width)
+
+
+def bin_to_int(bin_val):
+    return _bin_to_int(bin_val, width)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui64.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui64.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4b0ba7139df81cb19a088923039146100cfbf39
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/eui64.py
@@ -0,0 +1,273 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+IEEE 64-bit EUI (Extended Unique Indentifier) logic.
+"""
+import struct as _struct
+import re as _re
+
+from netaddr.core import AddrFormatError
+from netaddr.strategy import (
+    valid_words as _valid_words, int_to_words as _int_to_words,
+    words_to_int as _words_to_int, valid_bits as _valid_bits,
+    bits_to_int as _bits_to_int, int_to_bits as _int_to_bits,
+    valid_bin as _valid_bin, int_to_bin as _int_to_bin,
+    bin_to_int as _bin_to_int)
+
+
+#   This is a fake constant that doesn't really exist. Here for completeness.
+AF_EUI64 = 64
+
+#: The width (in bits) of this address type.
+width = 64
+
+#: The AF_* constant value of this address type.
+family = AF_EUI64
+
+#: A friendly string name address type.
+family_name = 'EUI-64'
+
+#: The version of this address type.
+version = 64
+
+#: The maximum integer value that can be represented by this address type.
+max_int = 2 ** width - 1
+
+#-----------------------------------------------------------------------------
+#   Dialect classes.
+#-----------------------------------------------------------------------------
+
+class eui64_base(object):
+    """A standard IEEE EUI-64 dialect class."""
+    #: The individual word size (in bits) of this address type.
+    word_size = 8
+
+    #: The number of words in this address type.
+    num_words = width // word_size
+
+    #: The maximum integer value for an individual word in this address type.
+    max_word = 2 ** word_size - 1
+
+    #: The separator character used between each word.
+    word_sep = '-'
+
+    #: The format string to be used when converting words to string values.
+    word_fmt = '%.2X'
+
+    #: The number base to be used when interpreting word values as integers.
+    word_base = 16
+
+
+class eui64_unix(eui64_base):
+    """A UNIX-style MAC address dialect class."""
+    word_size = 8
+    num_words = width // word_size
+    word_sep = ':'
+    word_fmt = '%x'
+    word_base = 16
+
+
+class eui64_unix_expanded(eui64_unix):
+    """A UNIX-style MAC address dialect class with leading zeroes."""
+    word_fmt = '%.2x'
+
+
+class eui64_cisco(eui64_base):
+    """A Cisco 'triple hextet' MAC address dialect class."""
+    word_size = 16
+    num_words = width // word_size
+    word_sep = '.'
+    word_fmt = '%.4x'
+    word_base = 16
+
+
+class eui64_bare(eui64_base):
+    """A bare (no delimiters) MAC address dialect class."""
+    word_size = 64
+    num_words = width // word_size
+    word_sep = ''
+    word_fmt = '%.16X'
+    word_base = 16
+
+
+#: The default dialect to be used when not specified by the user.
+
+DEFAULT_EUI64_DIALECT = eui64_base
+
+#-----------------------------------------------------------------------------
+#: Regular expressions to match all supported MAC address formats.
+RE_EUI64_FORMATS = (
+    #   2 bytes x 8 (UNIX, Windows, EUI-64)
+    '^' + ':'.join(['([0-9A-F]{1,2})'] * 8) + '$',
+    '^' + '-'.join(['([0-9A-F]{1,2})'] * 8) + '$',
+
+    #   4 bytes x 4 (Cisco like)
+    '^' + ':'.join(['([0-9A-F]{1,4})'] * 4) + '$',
+    '^' + '-'.join(['([0-9A-F]{1,4})'] * 4) + '$',
+    '^' + r'\.'.join(['([0-9A-F]{1,4})'] * 4) + '$',
+
+    #   16 bytes (bare, no delimiters)
+    '^(' + ''.join(['[0-9A-F]'] * 16) + ')$',
+)
+#   For efficiency, each string regexp converted in place to its compiled
+#   counterpart.
+RE_EUI64_FORMATS = [_re.compile(_, _re.IGNORECASE) for _ in RE_EUI64_FORMATS]
+
+
+def _get_match_result(address, formats):
+    for regexp in formats:
+        match = regexp.findall(address)
+        if match:
+            return match[0]
+
+
+def valid_str(addr):
+    """
+    :param addr: An IEEE EUI-64 indentifier in string form.
+
+    :return: ``True`` if EUI-64 indentifier is valid, ``False`` otherwise.
+    """
+    try:
+        if _get_match_result(addr, RE_EUI64_FORMATS):
+            return True
+    except TypeError:
+        pass
+
+    return False
+
+
+def str_to_int(addr):
+    """
+    :param addr: An IEEE EUI-64 indentifier in string form.
+
+    :return: An unsigned integer that is equivalent to value represented
+        by EUI-64 string address formatted according to the dialect
+    """
+    words = []
+
+    try:
+        words = _get_match_result(addr, RE_EUI64_FORMATS)
+        if not words:
+            raise TypeError
+    except TypeError:
+        raise AddrFormatError('invalid IEEE EUI-64 identifier: %r!' % (addr,))
+
+    if isinstance(words, tuple):
+        pass
+    else:
+        words = (words,)
+
+    if len(words) == 8:
+        #   2 bytes x 8 (UNIX, Windows, EUI-48)
+        int_val = int(''.join(['%.2x' % int(w, 16) for w in words]), 16)
+    elif len(words) == 4:
+        #   4 bytes x 4 (Cisco like)
+        int_val = int(''.join(['%.4x' % int(w, 16) for w in words]), 16)
+    elif len(words) == 1:
+        #   16 bytes (bare, no delimiters)
+        int_val = int('%016x' % int(words[0], 16), 16)
+    else:
+        raise AddrFormatError(
+            'bad word count for EUI-64 identifier: %r!' % addr)
+
+    return int_val
+
+
+def int_to_str(int_val, dialect=None):
+    """
+    :param int_val: An unsigned integer.
+
+    :param dialect: (optional) a Python class defining formatting options
+
+    :return: An IEEE EUI-64 identifier that is equivalent to unsigned integer.
+    """
+    if dialect is None:
+        dialect = eui64_base
+    words = int_to_words(int_val, dialect)
+    tokens = [dialect.word_fmt % i for i in words]
+    addr = dialect.word_sep.join(tokens)
+    return addr
+
+
+def int_to_packed(int_val):
+    """
+    :param int_val: the integer to be packed.
+
+    :return: a packed string that is equivalent to value represented by an
+    unsigned integer.
+    """
+    words = int_to_words(int_val)
+    return _struct.pack('>8B', *words)
+
+
+def packed_to_int(packed_int):
+    """
+    :param packed_int: a packed string containing an unsigned integer.
+        It is assumed that string is packed in network byte order.
+
+    :return: An unsigned integer equivalent to value of network address
+        represented by packed binary string.
+    """
+    words = list(_struct.unpack('>8B', packed_int))
+
+    int_val = 0
+    for i, num in enumerate(reversed(words)):
+        word = num
+        word = word << 8 * i
+        int_val = int_val | word
+
+    return int_val
+
+
+def valid_words(words, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _valid_words(words, dialect.word_size, dialect.num_words)
+
+
+def int_to_words(int_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _int_to_words(int_val, dialect.word_size, dialect.num_words)
+
+
+def words_to_int(words, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _words_to_int(words, dialect.word_size, dialect.num_words)
+
+
+def valid_bits(bits, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _valid_bits(bits, width, dialect.word_sep)
+
+
+def bits_to_int(bits, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _bits_to_int(bits, width, dialect.word_sep)
+
+
+def int_to_bits(int_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _int_to_bits(
+        int_val, dialect.word_size, dialect.num_words, dialect.word_sep)
+
+
+def valid_bin(bin_val, dialect=None):
+    if dialect is None:
+        dialect = DEFAULT_EUI64_DIALECT
+    return _valid_bin(bin_val, width)
+
+
+def int_to_bin(int_val):
+    return _int_to_bin(int_val, width)
+
+
+def bin_to_int(bin_val):
+    return _bin_to_int(bin_val, width)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv4.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv4.py
new file mode 100644
index 0000000000000000000000000000000000000000..56c4f24e832261c513fa3ef778eda090d4931958
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv4.py
@@ -0,0 +1,279 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""IPv4 address logic."""
+
+import sys as _sys
+import struct as _struct
+
+from socket import inet_aton as _inet_aton
+#   Check whether we need to use fallback code or not.
+if _sys.platform in ('win32', 'cygwin'):
+    #   inet_pton() not available on Windows. inet_pton() under cygwin
+    #   behaves exactly like inet_aton() and is therefore highly unreliable.
+    from netaddr.fbsocket import inet_pton as _inet_pton, AF_INET
+else:
+    #   All other cases, use all functions from the socket module.
+    from socket import inet_pton as _inet_pton, AF_INET
+
+from netaddr.core import AddrFormatError, ZEROFILL, INET_PTON
+
+from netaddr.strategy import (
+    valid_words as _valid_words, valid_bits as _valid_bits,
+    bits_to_int as _bits_to_int, int_to_bits as _int_to_bits,
+    valid_bin as _valid_bin, int_to_bin as _int_to_bin,
+    bin_to_int as _bin_to_int)
+
+from netaddr.compat import _str_type
+
+#: The width (in bits) of this address type.
+width = 32
+
+#: The individual word size (in bits) of this address type.
+word_size = 8
+
+#: The format string to be used when converting words to string values.
+word_fmt = '%d'
+
+#: The separator character used between each word.
+word_sep = '.'
+
+#: The AF_* constant value of this address type.
+family = AF_INET
+
+#: A friendly string name address type.
+family_name = 'IPv4'
+
+#: The version of this address type.
+version = 4
+
+#: The number base to be used when interpreting word values as integers.
+word_base = 10
+
+#: The maximum integer value that can be represented by this address type.
+max_int = 2 ** width - 1
+
+#: The number of words in this address type.
+num_words = width // word_size
+
+#: The maximum integer value for an individual word in this address type.
+max_word = 2 ** word_size - 1
+
+#: A dictionary mapping IPv4 CIDR prefixes to the equivalent netmasks.
+prefix_to_netmask = dict(
+    [(i, max_int ^ (2 ** (width - i) - 1)) for i in range(0, width + 1)])
+
+#: A dictionary mapping IPv4 netmasks to their equivalent CIDR prefixes.
+netmask_to_prefix = dict(
+    [(max_int ^ (2 ** (width - i) - 1), i) for i in range(0, width + 1)])
+
+#: A dictionary mapping IPv4 CIDR prefixes to the equivalent hostmasks.
+prefix_to_hostmask = dict(
+    [(i, (2 ** (width - i) - 1)) for i in range(0, width + 1)])
+
+#: A dictionary mapping IPv4 hostmasks to their equivalent CIDR prefixes.
+hostmask_to_prefix = dict(
+    [((2 ** (width - i) - 1), i) for i in range(0, width + 1)])
+
+
+def valid_str(addr, flags=0):
+    """
+    :param addr: An IPv4 address in presentation (string) format.
+
+    :param flags: decides which rules are applied to the interpretation of the
+        addr value. Supported constants are INET_PTON and ZEROFILL. See the
+        netaddr.core docs for details.
+
+    :return: ``True`` if IPv4 address is valid, ``False`` otherwise.
+    """
+    if addr == '':
+        raise AddrFormatError('Empty strings are not supported!')
+
+    validity = True
+
+    if flags & ZEROFILL:
+        addr = '.'.join(['%d' % int(i) for i in addr.split('.')])
+
+    try:
+        if flags & INET_PTON:
+            _inet_pton(AF_INET, addr)
+        else:
+            _inet_aton(addr)
+    except Exception:
+        validity = False
+
+    return validity
+
+
+def str_to_int(addr, flags=0):
+    """
+    :param addr: An IPv4 dotted decimal address in string form.
+
+    :param flags: decides which rules are applied to the interpretation of the
+        addr value. Supported constants are INET_PTON and ZEROFILL. See the
+        netaddr.core docs for details.
+
+    :return: The equivalent unsigned integer for a given IPv4 address.
+    """
+    if flags & ZEROFILL:
+        addr = '.'.join(['%d' % int(i) for i in addr.split('.')])
+
+    try:
+        if flags & INET_PTON:
+            return _struct.unpack('>I', _inet_pton(AF_INET, addr))[0]
+        else:
+            return _struct.unpack('>I', _inet_aton(addr))[0]
+    except Exception:
+        raise AddrFormatError('%r is not a valid IPv4 address string!' % (addr,))
+
+
+def int_to_str(int_val, dialect=None):
+    """
+    :param int_val: An unsigned integer.
+
+    :param dialect: (unused) Any value passed in is ignored.
+
+    :return: The IPv4 presentation (string) format address equivalent to the
+        unsigned integer provided.
+    """
+    if 0 <= int_val <= max_int:
+        return '%d.%d.%d.%d' % (
+            int_val >> 24,
+            (int_val >> 16) & 0xff,
+            (int_val >> 8) & 0xff,
+            int_val & 0xff)
+    else:
+        raise ValueError('%r is not a valid 32-bit unsigned integer!' % (int_val,))
+
+
+def int_to_arpa(int_val):
+    """
+    :param int_val: An unsigned integer.
+
+    :return: The reverse DNS lookup for an IPv4 address in network byte
+        order integer form.
+    """
+    words = ["%d" % i for i in int_to_words(int_val)]
+    words.reverse()
+    words.extend(['in-addr', 'arpa', ''])
+    return '.'.join(words)
+
+
+def int_to_packed(int_val):
+    """
+    :param int_val: the integer to be packed.
+
+    :return: a packed string that is equivalent to value represented by an
+    unsigned integer.
+    """
+    return _struct.pack('>I', int_val)
+
+
+def packed_to_int(packed_int):
+    """
+    :param packed_int: a packed string containing an unsigned integer.
+        It is assumed that string is packed in network byte order.
+
+    :return: An unsigned integer equivalent to value of network address
+        represented by packed binary string.
+    """
+    return _struct.unpack('>I', packed_int)[0]
+
+
+def valid_words(words):
+    return _valid_words(words, word_size, num_words)
+
+
+def int_to_words(int_val):
+    """
+    :param int_val: An unsigned integer.
+
+    :return: An integer word (octet) sequence that is equivalent to value
+        represented by an unsigned integer.
+    """
+    if not 0 <= int_val <= max_int:
+        raise ValueError('%r is not a valid integer value supported by'
+                         'this address type!' % (int_val,))
+    return ( int_val >> 24,
+            (int_val >> 16) & 0xff,
+            (int_val >>  8) & 0xff,
+             int_val & 0xff)
+
+
+def words_to_int(words):
+    """
+    :param words: A list or tuple containing integer octets.
+
+    :return: An unsigned integer that is equivalent to value represented
+        by word (octet) sequence.
+    """
+    if not valid_words(words):
+        raise ValueError('%r is not a valid octet list for an IPv4 address!' % (words,))
+    return _struct.unpack('>I', _struct.pack('4B', *words))[0]
+
+
+def valid_bits(bits):
+    return _valid_bits(bits, width, word_sep)
+
+
+def bits_to_int(bits):
+    return _bits_to_int(bits, width, word_sep)
+
+
+def int_to_bits(int_val, word_sep=None):
+    if word_sep is None:
+        word_sep = globals()['word_sep']
+    return _int_to_bits(int_val, word_size, num_words, word_sep)
+
+
+def valid_bin(bin_val):
+    return _valid_bin(bin_val, width)
+
+
+def int_to_bin(int_val):
+    return _int_to_bin(int_val, width)
+
+
+def bin_to_int(bin_val):
+    return _bin_to_int(bin_val, width)
+
+
+def expand_partial_address(addr):
+    """
+    Expands a partial IPv4 address into a full 4-octet version.
+
+    :param addr: an partial or abbreviated IPv4 address
+
+    :return: an expanded IP address in presentation format (x.x.x.x)
+
+    """
+    tokens = []
+
+    error = AddrFormatError('invalid partial IPv4 address: %r!' % addr)
+
+    if isinstance(addr, _str_type):
+        if ':' in addr:
+            #   Ignore IPv6 ...
+            raise error
+
+        try:
+            if '.' in addr:
+                tokens = ['%d' % int(o) for o in addr.split('.')]
+            else:
+                tokens = ['%d' % int(addr)]
+        except ValueError:
+            raise error
+
+        if 1 <= len(tokens) <= 4:
+            for i in range(4 - len(tokens)):
+                tokens.append('0')
+        else:
+            raise error
+
+    if not tokens:
+        raise error
+
+    return '%s.%s.%s.%s' % tuple(tokens)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv6.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv6.py
new file mode 100644
index 0000000000000000000000000000000000000000..de2a9354efb3e4ca2f1e57387766164c3ace09cd
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netaddr/strategy/ipv6.py
@@ -0,0 +1,259 @@
+#-----------------------------------------------------------------------------
+#   Copyright (c) 2008 by David P. D. Moss. All rights reserved.
+#
+#   Released under the BSD license. See the LICENSE file for details.
+#-----------------------------------------------------------------------------
+"""
+IPv6 address logic.
+"""
+import struct as _struct
+
+OPT_IMPORTS = False
+
+#   Check whether we need to use fallback code or not.
+try:
+    import socket as _socket
+    #   These might all generate exceptions on different platforms.
+    if not _socket.has_ipv6:
+        raise Exception('IPv6 disabled')
+    _socket.inet_pton
+    _socket.AF_INET6
+    from _socket import (inet_pton as _inet_pton, inet_ntop as _inet_ntop,
+                         AF_INET6)
+    OPT_IMPORTS = True
+except Exception:
+    from netaddr.fbsocket import (inet_pton as _inet_pton, inet_ntop as _inet_ntop,
+                                 AF_INET6)
+
+from netaddr.core import AddrFormatError
+from netaddr.strategy import (
+    valid_words as _valid_words, int_to_words as _int_to_words,
+    words_to_int as _words_to_int, valid_bits as _valid_bits,
+    bits_to_int as _bits_to_int, int_to_bits as _int_to_bits,
+    valid_bin as _valid_bin, int_to_bin as _int_to_bin,
+    bin_to_int as _bin_to_int)
+
+#: The width (in bits) of this address type.
+width = 128
+
+#: The individual word size (in bits) of this address type.
+word_size = 16
+
+#: The separator character used between each word.
+word_sep = ':'
+
+#: The AF_* constant value of this address type.
+family = AF_INET6
+
+#: A friendly string name address type.
+family_name = 'IPv6'
+
+#: The version of this address type.
+version = 6
+
+#: The number base to be used when interpreting word values as integers.
+word_base = 16
+
+#: The maximum integer value that can be represented by this address type.
+max_int = 2 ** width - 1
+
+#: The number of words in this address type.
+num_words = width // word_size
+
+#: The maximum integer value for an individual word in this address type.
+max_word = 2 ** word_size - 1
+
+#: A dictionary mapping IPv6 CIDR prefixes to the equivalent netmasks.
+prefix_to_netmask = dict(
+    [(i, max_int ^ (2 ** (width - i) - 1)) for i in range(0, width+1)])
+
+#: A dictionary mapping IPv6 netmasks to their equivalent CIDR prefixes.
+netmask_to_prefix = dict(
+    [(max_int ^ (2 ** (width - i) - 1), i) for i in range(0, width+1)])
+
+#: A dictionary mapping IPv6 CIDR prefixes to the equivalent hostmasks.
+prefix_to_hostmask = dict(
+    [(i, (2 ** (width - i) - 1)) for i in range(0, width+1)])
+
+#: A dictionary mapping IPv6 hostmasks to their equivalent CIDR prefixes.
+hostmask_to_prefix = dict(
+    [((2 ** (width - i) - 1), i) for i in range(0, width+1)])
+
+#-----------------------------------------------------------------------------
+#   Dialect classes.
+#-----------------------------------------------------------------------------
+
+class ipv6_compact(object):
+    """An IPv6 dialect class - compact form."""
+    #: The format string used to converting words into string values.
+    word_fmt = '%x'
+
+    #: Boolean flag indicating if IPv6 compaction algorithm should be used.
+    compact = True
+
+class ipv6_full(ipv6_compact):
+    """An IPv6 dialect class - 'all zeroes' form."""
+
+    #: Boolean flag indicating if IPv6 compaction algorithm should be used.
+    compact = False
+
+class ipv6_verbose(ipv6_compact):
+    """An IPv6 dialect class - extra wide 'all zeroes' form."""
+
+    #: The format string used to converting words into string values.
+    word_fmt = '%.4x'
+
+    #: Boolean flag indicating if IPv6 compaction algorithm should be used.
+    compact = False
+
+
+def valid_str(addr, flags=0):
+    """
+    :param addr: An IPv6 address in presentation (string) format.
+
+    :param flags: decides which rules are applied to the interpretation of the
+        addr value. Future use - currently has no effect.
+
+    :return: ``True`` if IPv6 address is valid, ``False`` otherwise.
+    """
+    if addr == '':
+        raise AddrFormatError('Empty strings are not supported!')
+
+    try:
+        _inet_pton(AF_INET6, addr)
+    except:
+        return False
+    return True
+
+
+def str_to_int(addr, flags=0):
+    """
+    :param addr: An IPv6 address in string form.
+
+    :param flags: decides which rules are applied to the interpretation of the
+        addr value. Future use - currently has no effect.
+
+    :return: The equivalent unsigned integer for a given IPv6 address.
+    """
+    try:
+        packed_int = _inet_pton(AF_INET6, addr)
+        return packed_to_int(packed_int)
+    except Exception:
+        raise AddrFormatError('%r is not a valid IPv6 address string!' % (addr,))
+
+
+def int_to_str(int_val, dialect=None):
+    """
+    :param int_val: An unsigned integer.
+
+    :param dialect: (optional) a Python class defining formatting options.
+
+    :return: The IPv6 presentation (string) format address equivalent to the
+        unsigned integer provided.
+    """
+    if dialect is None:
+        dialect = ipv6_compact
+
+    addr = None
+
+    try:
+        packed_int = int_to_packed(int_val)
+        if dialect.compact:
+            #   Default return value.
+            addr = _inet_ntop(AF_INET6, packed_int)
+        else:
+            #   Custom return value.
+            words = list(_struct.unpack('>8H', packed_int))
+            tokens = [dialect.word_fmt % word for word in words]
+            addr = word_sep.join(tokens)
+    except Exception:
+        raise ValueError('%r is not a valid 128-bit unsigned integer!' % (int_val,))
+
+    return addr
+
+
+def int_to_arpa(int_val):
+    """
+    :param int_val: An unsigned integer.
+
+    :return: The reverse DNS lookup for an IPv6 address in network byte
+        order integer form.
+    """
+    addr = int_to_str(int_val, ipv6_verbose)
+    tokens = list(addr.replace(':', ''))
+    tokens.reverse()
+    #   We won't support ip6.int here - see RFC 3152 for details.
+    tokens = tokens + ['ip6', 'arpa', '']
+    return '.'.join(tokens)
+
+
+def int_to_packed(int_val):
+    """
+    :param int_val: the integer to be packed.
+
+    :return: a packed string that is equivalent to value represented by an
+    unsigned integer.
+    """
+    words = int_to_words(int_val, 4, 32)
+    return _struct.pack('>4I', *words)
+
+
+def packed_to_int(packed_int):
+    """
+    :param packed_int: a packed string containing an unsigned integer.
+        It is assumed that string is packed in network byte order.
+
+    :return: An unsigned integer equivalent to value of network address
+        represented by packed binary string.
+    """
+    words = list(_struct.unpack('>4I', packed_int))
+
+    int_val = 0
+    for i, num in enumerate(reversed(words)):
+        word = num
+        word = word << 32 * i
+        int_val = int_val | word
+
+    return int_val
+
+
+def valid_words(words):
+    return _valid_words(words, word_size, num_words)
+
+
+def int_to_words(int_val, num_words=None, word_size=None):
+    if num_words is None:
+        num_words = globals()['num_words']
+    if word_size is None:
+        word_size = globals()['word_size']
+    return _int_to_words(int_val, word_size, num_words)
+
+
+def words_to_int(words):
+    return _words_to_int(words, word_size, num_words)
+
+
+def valid_bits(bits):
+    return _valid_bits(bits, width, word_sep)
+
+
+def bits_to_int(bits):
+    return _bits_to_int(bits, width, word_sep)
+
+
+def int_to_bits(int_val, word_sep=None):
+    if word_sep is None:
+        word_sep = globals()['word_sep']
+    return _int_to_bits(int_val, word_size, num_words, word_sep)
+
+
+def valid_bin(bin_val):
+    return _valid_bin(bin_val, width)
+
+
+def int_to_bin(int_val):
+    return _int_to_bin(int_val, width)
+
+
+def bin_to_int(bin_val):
+    return _bin_to_int(bin_val, width)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/LICENSE b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..0b5bad0d1eb12a73851b677a5ade16c69921c86a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2007-2018 Alastair Houghton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..324b77e75fa6660d975ba968504cabd648fe8a05
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/METADATA
@@ -0,0 +1,212 @@
+Metadata-Version: 2.1
+Name: netifaces
+Version: 0.10.9
+Summary: Portable network interface information.
+Home-page: https://github.com/al45tair/netifaces
+Author: Alastair Houghton
+Author-email: alastair@alastairs-place.net
+License: MIT License
+Platform: UNKNOWN
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Topic :: System :: Networking
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.5
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+
+netifaces 0.10.8
+================
+
++-------------+------------------+
+| Linux/macOS | |BuildStatus|    |
++-------------+------------------+
+| Windows     | |WinBuildStatus| |
++-------------+------------------+
+
+.. |BuildStatus| image:: https://travis-ci.org/al45tair/netifaces.svg?branch=master
+   :target: https://travis-ci.org/al45tair/dmgbuild
+   :alt: Build Status (Linux/Mac)
+
+.. |WinBuildStatus| image:: https://ci.appveyor.com/api/projects/status/3ctn1bl0aigpfjoo/branch/master?svg=true
+   :target: https://ci.appveyor.com/project/al45tair/netifaces/branch/master
+   :alt: Build Status (Windows)
+
+1. What is this?
+----------------
+
+It's been annoying me for some time that there's no easy way to get the
+address(es) of the machine's network interfaces from Python.  There is
+a good reason for this difficulty, which is that it is virtually impossible
+to do so in a portable manner.  However, it seems to me that there should
+be a package you can easy_install that will take care of working out the
+details of doing so on the machine you're using, then you can get on with
+writing Python code without concerning yourself with the nitty gritty of
+system-dependent low-level networking APIs.
+
+This package attempts to solve that problem.
+
+2. How do I use it?
+-------------------
+
+First you need to install it, which you can do by typing::
+
+  tar xvzf netifaces-0.10.8.tar.gz
+  cd netifaces-0.10.8
+  python setup.py install
+
+**Note that you will need the relevant developer tools for your platform**,
+as netifaces is written in C and installing this way will compile the extension.
+
+Once that's done, you'll need to start Python and do something like the
+following::
+
+>>> import netifaces
+
+Then if you enter
+
+>>> netifaces.interfaces()
+['lo0', 'gif0', 'stf0', 'en0', 'en1', 'fw0']
+
+you'll see the list of interface identifiers for your machine.
+
+You can ask for the addresses of a particular interface by doing
+
+>>> netifaces.ifaddresses('lo0')
+{18: [{'addr': ''}], 2: [{'peer': '127.0.0.1', 'netmask': '255.0.0.0', 'addr': '127.0.0.1'}], 30: [{'peer': '::1', 'netmask': 'ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff', 'addr': '::1'}, {'peer': '', 'netmask': 'ffff:ffff:ffff:ffff::', 'addr': 'fe80::1%lo0'}]}
+
+Hmmmm.  That result looks a bit cryptic; let's break it apart and explain
+what each piece means.  It returned a dictionary, so let's look there first::
+
+  { 18: [...], 2: [...], 30: [...] }
+
+Each of the numbers refers to a particular address family.  In this case, we
+have three address families listed; on my system, 18 is ``AF_LINK`` (which means
+the link layer interface, e.g. Ethernet), 2 is ``AF_INET`` (normal Internet
+addresses), and 30 is ``AF_INET6`` (IPv6).
+
+But wait!  Don't use these numbers in your code.  The numeric values here are
+system dependent; fortunately, I thought of that when writing netifaces, so
+the module declares a range of values that you might need.  e.g.
+
+>>> netifaces.AF_LINK
+18
+
+Again, on your system, the number may be different.
+
+So, what we've established is that the dictionary that's returned has one
+entry for each address family for which this interface has an address.  Let's
+take a look at the ``AF_INET`` addresses now:
+
+>>> addrs = netifaces.ifaddresses('lo0')
+>>> addrs[netifaces.AF_INET]
+[{'peer': '127.0.0.1', 'netmask': '255.0.0.0', 'addr': '127.0.0.1'}]
+
+You might be wondering why this value is a list.  The reason is that it's
+possible for an interface to have more than one address, even within the
+same family.  I'll say that again: *you can have more than one address of
+the same type associated with each interface*.
+
+*Asking for "the" address of a particular interface doesn't make sense.*
+
+Right, so, we can see that this particular interface only has one address,
+and, because it's a loopback interface, it's point-to-point and therefore
+has a *peer* address rather than a broadcast address.
+
+Let's look at a more interesting interface.
+
+>>> addrs = netifaces.ifaddresses('en0')
+>>> addrs[netifaces.AF_INET]
+[{'broadcast': '10.15.255.255', 'netmask': '255.240.0.0', 'addr': '10.0.1.4'}, {'broadcast': '192.168.0.255', 'addr': '192.168.0.47'}]
+
+This interface has two addresses (see, I told you...)  Both of them are
+regular IPv4 addresses, although in one case the netmask has been changed
+from its default.  The netmask *may not* appear on your system if it's set
+to the default for the address range.
+
+Because this interface isn't point-to-point, it also has broadcast addresses.
+
+Now, say we want, instead of the IP addresses, to get the MAC address; that
+is, the hardware address of the Ethernet adapter running this interface.  We
+can do
+
+>>> addrs[netifaces.AF_LINK]
+[{'addr': '00:12:34:56:78:9a'}]
+
+Note that this may not be available on platforms without getifaddrs(), unless
+they happen to implement ``SIOCGIFHWADDR``.  Note also that you just get the
+address; it's unlikely that you'll see anything else with an ``AF_LINK`` address.
+Oh, and don't assume that all ``AF_LINK`` addresses are Ethernet; you might, for
+instance, be on a Mac, in which case:
+
+>>> addrs = netifaces.ifaddresses('fw0')
+>>> addrs[netifaces.AF_LINK]
+[{'addr': '00:12:34:56:78:9a:bc:de'}]
+
+No, that isn't an exceptionally long Ethernet MAC address---it's a FireWire
+address.
+
+As of version 0.10.0, you can also obtain a list of gateways on your
+machine:
+
+>>> netifaces.gateways()
+{2: [('10.0.1.1', 'en0', True), ('10.2.1.1', 'en1', False)], 30: [('fe80::1', 'en0', True)], 'default': { 2: ('10.0.1.1', 'en0'), 30: ('fe80::1', 'en0') }}
+
+This dictionary is keyed on address family---in this case, ``AF_INET``---and
+each entry is a list of gateways as ``(address, interface, is_default)`` tuples.
+Notice that here we have two separate gateways for IPv4 (``AF_INET``); some
+operating systems support configurations like this and can either route packets
+based on their source, or based on administratively configured routing tables.
+
+For convenience, we also allow you to index the dictionary with the special
+value ``'default'``, which returns a dictionary mapping address families to the
+default gateway in each case.  Thus you can get the default IPv4 gateway with
+
+>>> gws = netifaces.gateways()
+>>> gws['default'][netifaces.AF_INET]
+('10.0.1.1', 'en0')
+
+Do note that there may be no default gateway for any given address family;
+this is currently very common for IPv6 and much less common for IPv4 but it
+can happen even for ``AF_INET``.
+
+BTW, if you're trying to configure your machine to have multiple gateways for
+the same address family, it's a very good idea to check the documentation for
+your operating system *very* carefully, as some systems become extremely
+confused or route packets in a non-obvious manner.
+
+I'm very interested in hearing from anyone (on any platform) for whom the
+``gateways()`` method doesn't produce the expected results.  It's quite
+complicated extracting this information from the operating system (whichever
+operating system we're talking about), and so I expect there's at least one
+system out there where this just won't work.
+
+3. This is great!  What platforms does it work on?
+--------------------------------------------------
+
+It gets regular testing on OS X, Linux and Windows.  It has also been used
+successfully on Solaris, and it's expected to work properly on other UNIX-like
+systems as well.  If you are running something that is not supported, and
+wish to contribute a patch, please use Github to send a pull request.
+
+4. What license is this under?
+------------------------------
+
+It's an MIT-style license. See `LICENSE <./LICENSE>`_.
+
+5. Why the jump to 0.10.0?
+--------------------------
+
+Because someone released a fork of netifaces with the version 0.9.0.
+Hopefully skipping the version number should remove any confusion.  In
+addition starting with 0.10.0 Python 3 is now supported and other
+features/bugfixes have been included as well.  See the CHANGELOG for a
+more complete list of changes.
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..ab0151e536ab3b5f42fcdb103116326c23457717
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/RECORD
@@ -0,0 +1,9 @@
+netifaces-0.10.9.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+netifaces-0.10.9.dist-info/LICENSE,sha256=sguJUWS3K5zAFw5sDWCxT5qqzGhiwFVu7UHqo0iINwU,1066
+netifaces-0.10.9.dist-info/METADATA,sha256=rG8Dtu9BFjWNmas4QKGqkthux0AVpZ1mJ3Ewfj7xbjs,8784
+netifaces-0.10.9.dist-info/RECORD,,
+netifaces-0.10.9.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+netifaces-0.10.9.dist-info/WHEEL,sha256=rjs0dbLt66v8mjOfCbR-uj5Usgl2OLAlmRdCEyNo0L4,104
+netifaces-0.10.9.dist-info/top_level.txt,sha256=PqMTaIuWtSjkdQHX6lH1Lmpv2aqBUYAGqATB8z3A6TQ,10
+netifaces-0.10.9.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+netifaces.cpython-37m-x86_64-linux-gnu.so,sha256=0iyzC0Aq0jU5-LrI_hgehGG7WgJJBk4bBnxzU4bxudI,88328
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/REQUESTED b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..aa5b41c9bcfd55ac012ff014dff384b052ae4e80
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: false
+Tag: cp37-cp37m-linux_x86_64
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3f008fd6c9f629df8691e8eb4b1ebe6ba430ca9c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/top_level.txt
@@ -0,0 +1 @@
+netifaces
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/zip-safe b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/zip-safe
new file mode 100644
index 0000000000000000000000000000000000000000..8b137891791fe96927ad78e64b0aad7bded08bdc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces-0.10.9.dist-info/zip-safe
@@ -0,0 +1 @@
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces.cpython-37m-x86_64-linux-gnu.so b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces.cpython-37m-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..78929c5bf213fec1db4e3db29b2b21e7c83ab0f0
Binary files /dev/null and b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/netifaces.cpython-37m-x86_64-linux-gnu.so differ
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/LICENSE.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..9d4c8417134cd85ebe03c107423e06f30a514b21
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/METADATA
@@ -0,0 +1,167 @@
+Metadata-Version: 2.1
+Name: ops
+Version: 1.0.1
+Summary: The Python library behind great charms
+Home-page: https://github.com/canonical/operator
+Author: The Charmcraft team at Canonical Ltd.
+Author-email: charmcraft@lists.launchpad.net
+License: Apache-2.0
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+Requires-Dist: PyYAML
+
+# The Operator Framework
+
+The Operator Framework provides a simple, lightweight, and powerful way of
+writing Juju charms, the best way to encapsulate operational experience in code.
+
+The framework will help you to:
+
+* model the integration of your services
+* manage the lifecycle of your application
+* create reusable and scalable components
+* keep your code simple and readable
+
+## Getting Started
+
+Charms written using the operator framework are just Python code. The intention
+is for it to feel very natural for somebody used to coding in Python, and
+reasonably easy to pick up for somebody who might be a domain expert but not
+necessarily a pythonista themselves.
+
+The dependencies of the operator framework are kept as minimal as possible;
+currently that's Python 3.5 or greater, and `PyYAML` (both are included by
+default in Ubuntu's cloud images from 16.04 on).
+
+<!--
+If you're new to the world of Juju and charms, you should probably dive into our
+[tutorial](/TBD).
+
+If you know about Juju, and have written charms that didn't use the operator
+framework (be it with reactive or without), we have an [introduction to the
+operator framework](/TBD) just for you.
+
+If you've gone through the above already and just want a refresher, or are
+really impatient and need to dive in, feel free to carry on down.
+-->
+## A Quick Introduction
+
+Operator framework charms are just Python code. The entry point to your charm is
+a particular Python file. It could be anything that makes sense to your project,
+but let's assume this is `src/charm.py`. This file must be executable (and it
+must have the appropriate shebang line).
+
+You need the usual `metadata.yaml` and (probably) `config.yaml` files, and a
+`requirements.txt` for any Python dependencies.  In other words, your project
+might look like this:
+
+```
+my-charm
+├── config.yaml
+├── metadata.yaml
+├── requirements.txt
+└── src/
+    └── charm.py
+```
+
+`src/charm.py` here is the entry point to your charm code. At a minimum, it
+needs to define a subclass of `CharmBase` and pass that into the framework's
+`main` function:
+
+```python
+from ops.charm import CharmBase
+from ops.main import main
+
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.start, self.on_start)
+
+    def on_start(self, event):
+        # Handle the start event here.
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+That should be enough for you to be able to run
+
+```
+$ charmcraft build
+Done, charm left in 'my-charm.charm'
+$ juju deploy ./my-charm.charm
+```
+
+> 🛈 More information on [`charmcraft`](https://pypi.org/project/charmcraft/) can
+> also be found on its [github page](https://github.com/canonical/charmcraft).
+
+Happy charming!
+
+## Testing your charms
+
+The operator framework provides a testing harness, so that you can test that
+your charm does the right thing when presented with different scenarios, without
+having to have a full deployment to do so. `pydoc3 ops.testing` has the details
+for that, including this example:
+
+```python
+harness = Harness(MyCharm)
+# Do initial setup here
+relation_id = harness.add_relation('db', 'postgresql')
+# Now instantiate the charm to see events as the model changes
+harness.begin()
+harness.add_relation_unit(relation_id, 'postgresql/0')
+harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+# Check that charm has properly handled the relation_joined event for postgresql/0
+self.assertEqual(harness.charm. ...)
+```
+
+## Talk to us
+
+If you need help, have ideas, or would just like to chat with us, reach out on
+IRC: we're in [#smooth-operator] on freenode (or try the [webchat]).
+
+We also pay attention to Juju's [discourse]; most discussion at this
+stage is on IRC, however.
+
+You can also deep dive into the [API docs] if that's your thing.
+
+[webchat]: https://webchat.freenode.net/#smooth-operator
+[#smooth-operator]: irc://chat.freenode.net/%23smooth-operator
+[discourse]: https://discourse.juju.is/c/charming
+[API docs]: https://ops.rtfd.io/
+
+## Operator Framework development
+
+If you want to work in the framework *itself* you will need Python >= 3.5 and
+the dependencies declared in `requirements-dev.txt` installed in your system.
+Or you can use a virtualenv:
+
+    virtualenv --python=python3 env
+    source env/bin/activate
+    pip install -r requirements-dev.txt
+
+Then you can try `./run_tests`, it should all go green.
+
+For improved performance on the tests, ensure that you have PyYAML
+installed with the correct extensions:
+
+    apt-get install libyaml-dev
+    pip install --force-reinstall --no-cache-dir pyyaml
+
+If you want to build the documentation you'll need the requirements from
+`docs/requirements.txt`, or in your virtualenv
+
+    pip install -r docs/requirements.txt
+
+and then you can run `./build_docs`.
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..1e85e3a3f1f7bc00d50784f10354adb4b609a735
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/RECORD
@@ -0,0 +1,29 @@
+ops-1.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ops-1.0.1.dist-info/LICENSE.txt,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+ops-1.0.1.dist-info/METADATA,sha256=M6iCFyean4T6_hZyvxDJpfOBOFHyGDiRG4LN8sjRE_I,5531
+ops-1.0.1.dist-info/RECORD,,
+ops-1.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ops-1.0.1.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+ops-1.0.1.dist-info/top_level.txt,sha256=enC05wWafSg8iDKIvj3gvtAtEP2kYCyN5Gmd689q-_I,4
+ops/__init__.py,sha256=WaHb0dfp1KEe6jFV8Pm_mcdJ3ModiWujnQ6xLjNzPNQ,819
+ops/__pycache__/__init__.cpython-37.pyc,,
+ops/__pycache__/charm.cpython-37.pyc,,
+ops/__pycache__/framework.cpython-37.pyc,,
+ops/__pycache__/jujuversion.cpython-37.pyc,,
+ops/__pycache__/log.cpython-37.pyc,,
+ops/__pycache__/main.cpython-37.pyc,,
+ops/__pycache__/model.cpython-37.pyc,,
+ops/__pycache__/storage.cpython-37.pyc,,
+ops/__pycache__/testing.cpython-37.pyc,,
+ops/__pycache__/version.cpython-37.pyc,,
+ops/charm.py,sha256=i6dsuWAyJ5DpLmcRpkcMy0r7RuepSuUlZeVYis3KS-I,32748
+ops/framework.py,sha256=kZtZHgUqyrvlKOG9mAYHxfSKSKUkd078SGLAkmqfL88,41255
+ops/jujuversion.py,sha256=9wMlUmngcAENV9RkgVVLWtZsyRQaf6XNrQQqUeY_fHA,4139
+ops/lib/__init__.py,sha256=QizPpuRWXjqbH5Gv7mnH8CcPR9BX7q2YNFnxyoSsA0g,9213
+ops/lib/__pycache__/__init__.cpython-37.pyc,,
+ops/log.py,sha256=JVpt_Vkf_lWO2cucUcJfXjAWVTattk4xBscSs65Sn3I,2155
+ops/main.py,sha256=PTmvrVPjwfenH9HcpYqiexhgMLaD81yiiHI6ME_eMto,15459
+ops/model.py,sha256=YFV1uamPDV1EMsY1hxua1SJYSo5iyo3ud-WdXP9TmFQ,47924
+ops/storage.py,sha256=jEfszzQGYDrl5wa03I6txvea-7lI661Yq6n7sIPa0fU,14192
+ops/testing.py,sha256=sH8PoNzGmfPdVWM1lBjStxHcNfQHsasFjF-WzHfDhFA,34898
+ops/version.py,sha256=cx1mM2x1Hs9OKr5kdhAdpS0Rfn0IQDMpLjSE3bJ-TY8,46
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/REQUESTED b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops-1.0.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/charm.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..02006b4c7029b84bf9f50d8e25686515de31e7e0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/charm.py
@@ -0,0 +1,821 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Base objects for the Charm, events and metadata."""
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """Events raised by Juju to progress a charm's lifecycle.
+
+    Hooks are callback methods of a charm class (a subclass of
+    :class:`CharmBase`) that are invoked in response to events raised
+    by Juju. These callback methods are the means by which a charm
+    governs the lifecycle of its application.
+
+    The :class:`HookEvent` class is the base of a type hierarchy of events
+    related to the charm's lifecycle.
+
+    :class:`HookEvent` subtypes are grouped into the following categories
+
+    - Core lifecycle events
+    - Relation events
+    - Storage events
+    - Metric events
+    """
+
+
+class ActionEvent(EventBase):
+    """Events raised by Juju when an administrator invokes a Juju Action.
+
+    This class is the data type of events triggered when an administrator
+    invokes a Juju Action. Callbacks bound to these events may be used
+    for responding to the administrator's Juju Action request.
+
+    To read the parameters for the action, see the instance variable :attr:`params`.
+    To respond with the result of the action, call :meth:`set_results`. To add
+    progress messages that are visible as the action is progressing use
+    :meth:`log`.
+
+    Attributes:
+        params: The parameters passed to the action.
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the administrator
+        is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Event triggered when a charm is installed.
+
+    This event is triggered at the beginning of a charm's
+    lifecycle. Any associated callback method should be used to
+    perform one-time setup operations, such as installing prerequisite
+    software.
+    """
+
+
+class StartEvent(HookEvent):
+    """Event triggered immediately after first configuation change.
+
+    This event is triggered immediately after the first
+    :class:`ConfigChangedEvent`. Callback methods bound to the event should be
+    used to ensure that the charm’s software is in a running state. Note that
+    the charm’s software should be configured so as to persist in this state
+    through reboots without further intervention on Juju’s part.
+    """
+
+
+class StopEvent(HookEvent):
+    """Event triggered when a charm is shut down.
+
+    This event is triggered when an application's removal is requested
+    by the client. The event fires immediately before the end of the
+    unit’s destruction sequence. Callback methods bound to this event
+    should be used to ensure that the charm’s software is not running,
+    and that it will not start again on reboot.
+    """
+
+
+class RemoveEvent(HookEvent):
+    """Event triggered when a unit is about to be terminated.
+
+    This event fires prior to Juju removing the charm and terminating its unit.
+    """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Event triggered when a configuration change is requested.
+
+    This event fires in several different situations.
+
+    - immediately after the :class:`install <InstallEvent>` event.
+    - after a :class:`relation is created <RelationCreatedEvent>`.
+    - after a :class:`leader is elected <LeaderElectedEvent>`.
+    - after changing charm configuration using the GUI or command line
+      interface
+    - when the charm :class:`starts <StartEvent>`.
+    - when a new unit :class:`joins a relation <RelationJoinedEvent>`.
+    - when there is a :class:`change to an existing relation <RelationChangedEvent>`.
+
+    Any callback method bound to this event cannot assume that the
+    software has already been started; it should not start stopped
+    software, but should (if appropriate) restart running software to
+    take configuration changes into account.
+    """
+
+
+class UpdateStatusEvent(HookEvent):
+    """Event triggered by a status update request from Juju.
+
+    This event is periodically triggered by Juju so that it can
+    provide constant feedback to the administrator about the status of
+    the application the charm is modeling. Any callback method bound
+    to this event should determine the "health" of the application and
+    set the status appropriately.
+
+    The interval between :class:`update-status <UpdateStatusEvent>` events can
+    be configured model-wide, e.g.  ``juju model-config
+    update-status-hook-interval=1m``.
+    """
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Event triggered by request to upgrade the charm.
+
+    This event will be triggered when an administrator executes ``juju
+    upgrade-charm``. The event fires after Juju has unpacked the upgraded charm
+    code, and so this event will be handled by the callback method bound to the
+    event in the new codebase. The associated callback method is invoked
+    provided there is no existing error state. The callback method should be
+    used to reconcile current state written by an older version of the charm
+    into whatever form that is needed by the current charm version.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Event triggered to prepare a unit for series upgrade.
+
+    This event triggers when an administrator executes ``juju upgrade-series
+    MACHINE prepare``. The event will fire for each unit that is running on the
+    specified machine. Any callback method bound to this event must prepare the
+    charm for an upgrade to the series. This may include things like exporting
+    database content to a version neutral format, or evacuating running
+    instances to other machines.
+
+    It can be assumed that only after all units on a machine have executed the
+    callback method associated with this event, the administrator will initiate
+    steps to actually upgrade the series.  After the upgrade has been completed,
+    the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Event triggered after a series upgrade.
+
+    This event is triggered after the administrator has done a distribution
+    upgrade (or rolled back and kept the same series). It is called in response
+    to ``juju upgrade-series MACHINE complete``. Associated charm callback
+    methods are expected to do whatever steps are necessary to reconfigure their
+    applications for the new series. This may include things like populating the
+    upgraded version of a database. Note however charms are expected to check if
+    the series has actually changed or whether it was rolled back to the
+    original series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Event triggered when a new leader has been elected.
+
+    Juju will trigger this event when a new leader unit is chosen for
+    a given application.
+
+    This event fires at least once after Juju selects a leader
+    unit. Callback methods bound to this event may take any action
+    required for the elected unit to assert leadership. Note that only
+    the elected leader unit will receive this event.
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Event triggered when leader changes any settings.
+
+    DEPRECATED NOTICE
+
+    This event has been deprecated in favor of using a Peer relation,
+    and having the leader set a value in the Application data bag for
+    that peer relation.  (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Event triggered by Juju to collect metrics.
+
+    Juju fires this event every five minutes for the lifetime of the
+    unit. Callback methods bound to this event may use the :meth:`add_metrics`
+    method of this class to send measurements to Juju.
+
+    Note that associated callback methods are currently sandboxed in
+    how they can interact with Juju.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Relation lifecycle events are generated when application units
+    participate in relations.  Units can only participate in relations
+    after they have been "started", and before they have been
+    "stopped". Within that time window, the unit may participate in
+    several different relations at a time, including multiple
+    relations with the same name.
+
+    Attributes:
+        relation: The :class:`~ops.model.Relation` involved in this event
+        app: The remote :class:`~ops.model.Application` that has triggered this
+             event
+        unit: The remote unit that has triggered this event. This may be
+              ``None`` if the relation event was triggered as an
+              :class:`~ops.model.Application` level event
+
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Event triggered when a new relation is created.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Event triggered when a new unit joins a relation.
+
+    This event is triggered whenever a new unit of a related
+    application joins the relation.  The event fires only when that
+    remote unit is first observed by the unit. Callback methods bound
+    to this event may set any local unit settings that can be
+    determined using no more than the name of the joining unit and the
+    remote ``private-address`` setting, which is always available when
+    the relation is created and is by convention not deleted.
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Event triggered when relation data changes.
+
+    This event is triggered whenever there is a change to the data bucket for a
+    related application or unit. Look at ``event.relation.data[event.unit/app]``
+    to see the new information, where ``event`` is the event object passed to
+    the callback method bound to this event.
+
+    This event always fires once, after :class:`RelationJoinedEvent`, and
+    will subsequently fire whenever that remote unit changes its settings for
+    the relation. Callback methods bound to this event should be the only ones
+    that rely on remote relation settings. They should not error if the settings
+    are incomplete, since it can be guaranteed that when the remote unit or
+    application changes its settings, the event will fire again.
+
+    The settings that may be queried, or set, are determined by the relation’s
+    interface.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Event triggered when a unit leaves a relation.
+
+    This is the inverse of the :class:`RelationJoinedEvent`, representing when a
+    unit is leaving the relation (the unit is being removed, the app is being
+    removed, the relation is being removed). It is fired once for each unit that
+    is going away.
+
+    When the remote unit is known to be leaving the relation, this will result
+    in the :class:`RelationChangedEvent` firing at least once, after which the
+    :class:`RelationDepartedEvent` will fire. The :class:`RelationDepartedEvent`
+    will fire once only. Once the :class:`RelationDepartedEvent` has fired no
+    further :class:`RelationChangedEvent` will fire.
+
+    Callback methods bound to this event may be used to remove all
+    references to the departing remote unit, because there’s no
+    guarantee that it’s still part of the system; it’s perfectly
+    probable (although not guaranteed) that the system running that
+    unit has already shut down.
+
+    Once all callback methods bound to this event have been run for such a
+    relation, the unit agent will fire the :class:`RelationBrokenEvent`.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Event triggered when a relation is removed.
+
+    If a relation is being removed (``juju remove-relation`` or ``juju
+    remove-application``), once all the units have been removed, this event will
+    fire to signal that the relationship has been fully terminated.
+
+    The event indicates that the current relation is no longer valid, and that
+    the charm’s software must be configured as though the relation had never
+    existed. It will only be called after every callback method bound to
+    :class:`RelationDepartedEvent` has been run. If a callback method
+    bound to this event is being executed, it is gauranteed that no remote units
+    are currently known locally.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing storage-related events.
+
+    Juju can provide a variety of storage types to a charms. The
+    charms can define several different types of storage that are
+    allocated from Juju. Changes in state of storage trigger sub-types
+    of :class:`StorageEvent`.
+    """
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Event triggered when new storage becomes available.
+
+    This event is triggered when new storage is available for the
+    charm to use.
+
+    Callback methods bound to this event allow the charm to run code
+    when storage has been added. Such methods will be run before the
+    :class:`InstallEvent` fires, so that the installation routine may
+    use the storage. The name prefix of this hook will depend on the
+    storage key defined in the ``metadata.yaml`` file.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Event triggered prior to removal of storage.
+
+    This event is triggered when storage a charm has been using is
+    going away.
+
+    Callback methods bound to this event allow the charm to run code
+    before storage is removed. Such methods will be run before storage
+    is detached, and always before the :class:`StopEvent` fires, thereby
+    allowing the charm to gracefully release resources before they are
+    removed and before the unit terminates. The name prefix of the
+    hook will depend on the storage key defined in the ``metadata.yaml``
+    file.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """Events generated by Juju pertaining to application lifecycle.
+
+    This class is used to create an event descriptor (``self.on``) attribute for
+    a charm class that inherits from :class:`CharmBase`. The event descriptor
+    may be used to set up event handlers for corresponding events.
+
+    By default the following events will be provided through
+    :class:`CharmBase`::
+
+        self.on.install
+        self.on.start
+        self.on.remove
+        self.on.update_status
+        self.on.config_changed
+        self.on.upgrade_charm
+        self.on.pre_series_upgrade
+        self.on.post_series_upgrade
+        self.on.leader_elected
+        self.on.collect_metrics
+
+
+    In addition to these, depending on the charm's metadata (``metadata.yaml``),
+    named relation and storage events may also be defined.  These named events
+    are created by :class:`CharmBase` using charm metadata.  The named events may be
+    accessed as ``self.on[<name>].<relation_or_storage_event>``
+    """
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the charm overall.
+
+    :class:`CharmBase` is used to create a charm. This is done by inheriting
+    from :class:`CharmBase` and customising the sub class as required. So to
+    create your own charm, say ``MyCharm``, define a charm class and set up the
+    required event handlers (“hooks”) in its constructor::
+
+        import logging
+
+        from ops.charm import CharmBase
+        from ops.main import main
+
+        logger = logging.getLogger(__name__)
+
+        def MyCharm(CharmBase):
+            def __init__(self, *args):
+                logger.debug('Initializing Charm')
+
+                super().__init__(*args)
+
+                self.framework.observe(self.on.config_changed, self._on_config_changed)
+                self.framework.observe(self.on.stop, self._on_stop)
+                # ...
+
+        if __name__ == "__main__":
+            main(MyCharm)
+
+    As shown in the example above, a charm class is instantiated by
+    :func:`~ops.main.main` rather than charm authors directly instantiating a
+    charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+
+    """
+
+    # note that without the #: below, sphinx will copy the whole of CharmEvents
+    # docstring inline which is less than ideal.
+    #: Used to set up event handlers; see :class:`CharmEvents`.
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """Metadata of this charm."""
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the charm as it is running."""
+        return self.framework.charm_dir
+
+    @property
+    def config(self) -> model.ConfigData:
+        """A mapping containing the charm's config and current values."""
+        return self.model.config
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from ``metadata.yaml`` and/or ``actions.yaml``. Generally
+    charms will define this information, rather than reading it at runtime. This
+    class is mostly for the framework to understand what the charm has defined.
+
+    The :attr:`maintainers`, :attr:`tags`, :attr:`terms`, :attr:`series`, and
+    :attr:`extra_bindings` attributes are all lists of strings.  The
+    :attr:`requires`, :attr:`provides`, :attr:`peers`, :attr:`relations`,
+    :attr:`storages`, :attr:`resources`, and :attr:`payloads` attributes are all
+    mappings of names to instances of the respective :class:`RelationMeta`,
+    :class:`StorageMeta`, :class:`ResourceMeta`, or :class:`PayloadMeta`.
+
+    The :attr:`relations` attribute is a convenience accessor which includes all
+    of the ``requires``, ``provides``, and ``peers`` :class:`RelationMeta`
+    items.  If needed, the role of the relation definition can be obtained from
+    its :attr:`role <RelationMeta.role>` attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    """An annotation for a charm's role in a relation.
+
+    For each relation a charm's role may be
+
+    - A Peer
+    - A service consumer in the relation ('requires')
+    - A service provider in the relation ('provides')
+    """
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is :class:`RelationRole`; one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition.
+
+    Attributes:
+        storage_name: Name of storage
+        type: Storage type
+        description: A text description of the storage
+        read_only: Whether or not the storage is read only
+        minimum_size: Minimum size of storage
+        location: Mount point of storage
+        multiple_range: Range of numeric qualifiers when multiple storage units are used
+    """
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition.
+
+    Attributes:
+        resource_name: Name of resource
+        filename: Name of file
+        description: A text description of resource
+    """
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition.
+
+    Attributes:
+        payload_name: Name of payload
+        type: Payload type
+    """
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/framework.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/framework.py
new file mode 100644
index 0000000000000000000000000000000000000000..f6e97dbfba4fd6158e420077c827b7a8e883718a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/framework.py
@@ -0,0 +1,1141 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework infrastructure."""
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        """Create a new handle as child of the current one."""
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        """Return own parent handle."""
+        return self._parent
+
+    @property
+    def kind(self):
+        """Return the handle's kind."""
+        return self._kind
+
+    @property
+    def key(self):
+        """Return the handle's key."""
+        return self._key
+
+    @property
+    def path(self):
+        """Return the handle's path."""
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        """Build a handle from the indicated path."""
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+    """The base for all the different Events.
+
+    Inherit this and override 'snapshot' and 'restore' methods to build a custom event.
+    """
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def __repr__(self):
+        return "<%s via %s>" % (self.__class__.__name__, self.handle)
+
+    def defer(self):
+        """Defer the event to the future.
+
+        After being deferred, this event will be re-emited the next time there's
+        any other event for the charm.
+        """
+        logger.debug("Deferring %s.", self)
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+    """Event bound to an Object."""
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+    """Base class of all the charm-related objects."""
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        """Shortcut for more simple access the model."""
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def _event_kinds(self):
+        event_kinds = []
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kinds.append(attr_name)
+        return event_kinds
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events."""
+        return {event_kind: getattr(self, event_kind) for event_kind in self._event_kinds()}
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+    def __repr__(self):
+        k = type(self)
+        event_kinds = ', '.join(sorted(self._event_kinds()))
+        return '<{}.{}: {}>'.format(k.__module__, k.__qualname__, event_kinds)
+
+
+class PrefixedEvents:
+    """Events to be found in all events using a specific prefix."""
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    """Events that will be emited first on commit."""
+
+
+class CommitEvent(EventBase):
+    """Events that will be emited second on commit."""
+
+
+class FrameworkEvents(ObjectEvents):
+    """Manager of all framework events."""
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+    """No class to hold it was found when restoring an event."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+    """Main interface to from the Charm to the Operator Framework internals."""
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse the env var once, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def set_breakpointhook(self):
+        """Hook into sys.breakpointhook so the builtin breakpoint() works as expected.
+
+        This method is called by ``main``, and is not intended to be
+        called by users of the framework itself outside of perhaps
+        some testing scenarios.
+
+        It returns the old value of sys.excepthook.
+
+        The breakpoint function is a Python >= 3.7 feature.
+
+        This method was added in ops 1.0; before that, it was done as
+        part of the Framework's __init__.
+        """
+        old_breakpointhook = getattr(sys, 'breakpointhook', None)
+        if old_breakpointhook is not None:
+            # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+            # breakpoint()
+            sys.breakpointhook = self.breakpoint
+        return old_breakpointhook
+
+    def close(self):
+        """Close the underlying backends."""
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        """Save changes to the underlying backends."""
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        """Register a type to a handle."""
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        """Load a persistent snapshot."""
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        """Discard a persistent snapshot."""
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style::
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as::
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                if single_event_path is None:
+                    logger.debug("Re-emitting %s.", event)
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+    """Manager of the stored data."""
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        """Return the current state."""
+        return self._cache
+
+    def restore(self, snapshot):
+        """Restore current state to the given snapshot."""
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        """Save changes to the storage backend."""
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+    """Stored state data bound to a specific Object."""
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """Set the value of any given key if it has not already been set."""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+class StoredDict(collections.abc.MutableMapping):
+    """A dict-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+
+class StoredList(collections.abc.MutableSequence):
+    """A list-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        """Insert value before index."""
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        """Append value to the end of the list."""
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+
+class StoredSet(collections.abc.MutableSet):
+    """A set-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        """Add a key to a set.
+
+        This has no effect if the key is already present.
+        """
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        """Remove a key from a set if it is a member.
+
+        If the key is not a member, do nothing.
+        """
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/jujuversion.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/jujuversion.py
new file mode 100644
index 0000000000000000000000000000000000000000..61d420d369d9b0e75b9c2c242574ddcd4b89be51
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/jujuversion.py
@@ -0,0 +1,114 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A helper to work with the Juju version."""
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+    """Helper to work with the Juju version.
+
+    It knows how to parse the ``JUJU_VERSION`` environment variable, and exposes different
+    capabilities according to the specific version, allowing also to compare with other
+    versions.
+    """
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if v is None:
+            v = '0.0.0'
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
+
+    def is_dispatch_aware(self) -> bool:
+        """Determine whether this juju version knows about dispatch."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
+
+    def has_controller_storage(self) -> bool:
+        """Determine whether this juju version supports controller-side storage."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/lib/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..22b5a84e517df8a061b7ca2742678536a481b616
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/lib/__init__.py
@@ -0,0 +1,264 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure for the opslib functionality."""
+
+import logging
+import os
+import re
+import sys
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+from typing import List
+
+__all__ = ('use', 'autoimport')
+
+logger = logging.getLogger(__name__)
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except (FileNotFoundError, NotADirectoryError):
+            continue
+        except OSError as e:
+            logger.debug("Tried to look for ops.lib packages under '%s': %s", sys_dir, e)
+            continue
+        logger.debug("Looking for ops.lib packages under '%s'", sys_dir)
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except (FileNotFoundError, NotADirectoryError):
+                continue
+            except OSError as e:
+                logger.debug("  Tried '%s': %s", opslib, e)  # *lots* of things checked here
+                continue
+            else:
+                logger.debug("  Trying '%s'", opslib)
+            finder = get_importer(opslib)
+            if finder is None:
+                logger.debug("  Finder for '%s' is None", opslib)
+                continue
+            if not hasattr(finder, 'find_spec'):
+                logger.debug("  Finder for '%s' has no find_spec", opslib)
+                continue
+            for lib_dir in lib_dirs:
+                spec_name = "{}.opslib.{}".format(top_dir, lib_dir)
+                spec = finder.find_spec(spec_name)
+                if spec is None:
+                    logger.debug("    No spec for %r", spec_name)
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    logger.debug("    No loader for %r (probably a namespace package)", spec_name)
+                    continue
+
+                logger.debug("    Found %r", spec_name)
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+# these keys, with these types, are needed to have an opslib
+_NEEDED_KEYS = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+
+def _join_and(keys: List[str]) -> str:
+    if len(keys) == 0:
+        return ""
+    if len(keys) == 1:
+        return keys[0]
+    return ", ".join(keys[:-1]) + ", and " + keys[-1]
+
+
+class _Missing:
+    """Helper to get the difference between what was found and what was needed when logging."""
+
+    def __init__(self, found):
+        self._found = found
+
+    def __str__(self):
+        exp = set(_NEEDED_KEYS)
+        got = set(self._found)
+        if len(got) == 0:
+            return "missing {}".format(_join_and(sorted(exp)))
+        return "got {}, but missing {}".format(
+            _join_and(sorted(got)),
+            _join_and(sorted(exp - got)))
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        # "can't happen"
+        logger.warning("No origin for %r (no idea why; please report)", spec.name)
+        return None
+
+    logger.debug("    Parsing %r", spec.name)
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_NEEDED_KEYS):
+                    break
+                if n > _MAX_LIB_LINES:
+                    logger.debug(
+                        "      Missing opslib metadata after reading to line %d: %s",
+                        _MAX_LIB_LINES, _Missing(libinfo))
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _NEEDED_KEYS:
+                    value = literal_eval(value)
+                    if not isinstance(value, _NEEDED_KEYS[key]):
+                        logger.debug(
+                            "      Bad type for %s: expected %s, got %s",
+                            key, _NEEDED_KEYS[key].__name__, type(value).__name__)
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_NEEDED_KEYS):
+                    logger.debug(
+                        "      Missing opslib metadata after reading to end of file: %s",
+                        _Missing(libinfo))
+                    return None
+    except Exception as e:
+        logger.debug("      Failed: %s", e)
+        return None
+
+    lib = _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+    logger.debug("    Success: found library %s", lib)
+
+    return lib
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {}>".format(self)
+
+    def __str__(self):
+        return "{0.name} by {0.author}, API {0.api}, patch {0.patch}".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/log.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..b47013dd597c5500ea763d9e4beada10e6f2ca87
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/log.py
@@ -0,0 +1,58 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Interface to emit messages to the Juju logging system."""
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        """Send the specified logging record to the Juju backend.
+
+        This method is not used directly by the Operator Framework code, but by
+        :class:`logging.Handler` itself as part of the logging machinery.
+        """
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/main.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..4710359295f6e63c08878d8d2e638b172290631d
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/main.py
@@ -0,0 +1,405 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Main entry point to the Operator Framework."""
+
+import inspect
+import logging
+import os
+import shutil
+import subprocess
+import sys
+import typing
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+from ops.jujuversion import JujuVersion
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _exe_path(path: Path) -> typing.Optional[Path]:
+    """Find and return the full path to the given binary.
+
+    Here path is the absolute path to a binary, but might be missing an extension.
+    """
+    p = shutil.which(path.name, mode=os.F_OK, path=str(path.parent))
+    if p is None:
+        return None
+    return Path(p)
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event, link_to):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    link_to -- What the event link should point to
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        target_path = os.path.relpath(link_to, str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    # XXX: on windows this function does not accomplish what it wants to:
+    #      it creates symlinks with no extension pointing to a .py
+    #      and juju only knows how to handle .exe, .bat, .cmd, and .ps1
+    #      so it does its job, but does not accomplish anything as the
+    #      hooks aren't 'callable'.
+    link_to = os.path.realpath(os.environ.get("JUJU_DISPATCH_PATH", sys.argv[0]))
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event, link_to)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary, and is that binary present?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(os.environ.get('JUJU_DISPATCH_PATH', sys.argv[0]))
+
+        dispatch = charm_dir / 'dispatch'
+        if JujuVersion.from_environ().is_dispatch_aware() and _exe_path(dispatch) is not None:
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk."""
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = _exe_path(self._charm_dir / self._dispatch_path)
+        if dispatch_path is None:
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == Path(sys.argv[0]).resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning("Legacy %s exited with status %d.", self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        except OSError as e:
+            logger.warning("Unable to run legacy %s: %s", self._dispatch_path, e)
+            sys.exit(1)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def _should_use_controller_storage(db_path: Path, meta: ops.charm.CharmMeta) -> bool:
+    """Figure out whether we want to use controller storage or not."""
+    # if you've previously used local state, carry on using that
+    if db_path.exists():
+        logger.debug("Using local storage: %s already exists", db_path)
+        return False
+
+    # if you're not in k8s you don't need controller storage
+    if 'kubernetes' not in meta.series:
+        logger.debug("Using local storage: not a kubernetes charm")
+        return False
+
+    # are we in a new enough Juju?
+    cur_version = JujuVersion.from_environ()
+
+    if cur_version.has_controller_storage():
+        logger.debug("Using controller storage: JUJU_VERSION=%s", cur_version)
+        return True
+    else:
+        logger.debug("Using local storage: JUJU_VERSION=%s", cur_version)
+        return False
+
+
+def main(charm_class: ops.charm.CharmBase, use_juju_for_storage: bool = None):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+
+    Args:
+        charm_class: your charm class.
+        use_juju_for_storage: whether to use controller-side storage. If not specified
+            then kubernetes charms that haven't previously used local storage and that
+            are running on a new enough Juju default to controller-side storage,
+            otherwise local storage is used.
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+
+    if use_juju_for_storage and not ops.storage.juju_backend_available():
+        # raise an exception; the charm is broken and needs fixing.
+        msg = 'charm set use_juju_for_storage=True, but Juju version {} does not support it'
+        raise RuntimeError(msg.format(JujuVersion.from_environ()))
+
+    if use_juju_for_storage is None:
+        use_juju_for_storage = _should_use_controller_storage(charm_state_path, meta)
+
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    framework.set_breakpointhook()
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made.
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/model.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..94cd523f9618b1ec6b6a4d7b0e8c1f7dd63b2be1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/model.py
@@ -0,0 +1,1314 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Representations of Juju's model, application, unit, and other entities."""
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+import yaml
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+if yaml.__with_libyaml__:
+    _DefaultDumper = yaml.CSafeDumper
+else:
+    _DefaultDumper = yaml.SafeDumper
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self._unit = self.get_unit(self._backend.unit_name)
+        self._relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self._config = ConfigData(self._backend)
+        self._resources = Resources(list(meta.resources), self._backend)
+        self._pod = Pod(self._backend)
+        self._storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def unit(self) -> 'Unit':
+        """A :class:`Unit` that represents the unit that is running this code (eg yourself)."""
+        return self._unit
+
+    @property
+    def app(self):
+        """A :class:`Application` that represents the application this unit is a part of."""
+        return self._unit.app
+
+    @property
+    def relations(self) -> 'RelationMapping':
+        """Mapping of endpoint to list of :class:`Relation`.
+
+        Answers the question "what am I currently related to".
+        See also :meth:`.get_relation`.
+        """
+        return self._relations
+
+    @property
+    def config(self) -> 'ConfigData':
+        """Return a mapping of config for the current application."""
+        return self._config
+
+    @property
+    def resources(self) -> 'Resources':
+        """Access to resources for this charm.
+
+        Use ``model.resources.fetch(resource_name)`` to get the path on disk
+        where the resource can be found.
+        """
+        return self._resources
+
+    @property
+    def storages(self) -> 'StorageMapping':
+        """Mapping of storage_name to :class:`Storage` as defined in metadata.yaml."""
+        return self._storages
+
+    @property
+    def pod(self) -> 'Pod':
+        """Use ``model.pod.set_spec`` to set the container specification for Kubernetes charms."""
+        return self._pod
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworkInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info.get('bind-addresses', []):
+            interface_name = interface_info.get('interface-name')
+            for address_info in interface_info.get('addresses', []):
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info.get('ingress-addresses', []):
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info.get('egress-subnets', []):
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        if self.interfaces:
+            return self.interfaces[0].address
+        else:
+            return None
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        if self.ingress_addresses:
+            return self.ingress_addresses[0]
+        else:
+            return None
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        address = address_info.get('value')
+        # The value field may be empty.
+        if address:
+            self.address = ipaddress.ip_address(address)
+        else:
+            self.address = None
+        cidr = address_info.get('cidr')
+        # The cidr field may be empty, see LP: #1864102.
+        if cidr:
+            self.subnet = ipaddress.ip_network(cidr)
+        elif address:
+            # If we have an address, convert it to a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address)
+        else:
+            self.subnet = None
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`ops.charm.RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+    """Data content of a unit or application in a relation."""
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        """Load the data from the current entity / relation."""
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        """Return if the data content can be modified."""
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                self._data.pop(key, None)
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+    """Configuration data.
+
+    This class should not be created directly. It should be accessed via :attr:`Model.config`.
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        """Forbid the usage of StatusBase directly."""
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        """Get the specific Status for the name (or UnknownStatus if not registered)."""
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        """Register a Status for the child's name."""
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm."""
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+            None
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """Represents a storage as defined in metadata.yaml.
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        """Return the location of the storage."""
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE, check=True)
+        args = (shutil.which(args[0]),) + args[1:]
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.yaml'
+            with spec_path.open("wt", encoding="utf8") as f:
+                yaml.dump(spec, stream=f, Dumper=_DefaultDumper)
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.yaml'
+                with k8s_res_path.open("wt", encoding="utf8") as f:
+                    yaml.dump(k8s_resources, stream=f, Dumper=_DefaultDumper)
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            status: The status to set.
+            message: The message to set in the status.
+            is_app: A boolean indicating whether the status should be set for a unit or an
+                    application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/storage.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/storage.py
new file mode 100644
index 0000000000000000000000000000000000000000..562cde770bcc3b5961aa6086372f0a2529bbd317
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/storage.py
@@ -0,0 +1,374 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Structures to offer storage to the charm (through Juju or locally)."""
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+def _run(args, **kw):
+    cmd = shutil.which(args[0])
+    if cmd is None:
+        raise FileNotFoundError(args[0])
+    return subprocess.run([cmd, *args[1:]], **kw)
+
+
+class SQLiteStorage:
+    """Storage using SQLite backend."""
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        """Make the database ready to be used as storage."""
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend."""
+        self._db.close()
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend."""
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)."""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: str = None) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+                might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, record an notice (event and observer)."""
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str = None):
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if event_path and row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        """Load a notice list from current key.
+
+        Returns:
+            List of (event_path, observer_path, method_name) tuples; empty if no key or is None.
+        """
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        """Save a notice list under current key.
+
+        Args:
+            notices: List of (event_path, observer_path, method_name) tuples.
+        """
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'.
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+def juju_backend_available() -> bool:
+    """Check if Juju state storage is available."""
+    p = shutil.which('state-get')
+    return p is not None
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        _run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = _run(["state-get", key], stdout=subprocess.PIPE, check=True, universal_newlines=True)
+        if p.stdout == '' or p.stdout == '\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        _run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+    """Exception to flag that there is no snapshot for the given handle_path."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/testing.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..e70bc98ff661b51cf45c3085ce6a29809a7b3110
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/testing.py
@@ -0,0 +1,826 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure to build unittests for Charms using the Operator Framework."""
+
+import inspect
+import pathlib
+import random
+import tempfile
+import typing
+import yaml
+from contextlib import contextmanager
+from textwrap import dedent
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+        config: A string or file-like object containing the contents of
+            config.yaml. If not supplied, we will look for a 'config.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None,
+            config: OptionalYAML = None):
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._oci_resources = {}
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+        self._update_config(key_values=self._load_config_defaults(config))
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling :meth:`begin`, there is no Charm instance, so changes to the Model won't
+        emit events. You must call :meth:`.begin` before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def begin_with_initial_hooks(self) -> None:
+        """Called when you want the Harness to fire the same hooks that Juju would fire at startup.
+
+        This triggers install, relation-created, config-changed, start, and any relation-joined
+        hooks. Based on what relations have been defined before you called begin().
+        Note that all of these are fired before returning control to the test suite, so if you
+        want to introspect what happens at each step, you need to fire them directly
+        (eg Charm.on.install.emit()).
+
+        To use this with all the normal hooks, you should instantiate the harness, setup any
+        relations that you want active when the charm starts, and then call this method.
+
+        Example::
+
+            harness = Harness(MyCharm)
+            # Do initial setup here
+            relation_id = harness.add_relation('db', 'postgresql')
+            harness.add_relation_unit(relation_id, 'postgresql/0')
+            harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+            harness.set_leader(True)
+            harness.update_config({'initial': 'config'})
+            harness.begin_with_initial_hooks()
+            # This will cause
+            # install, db-relation-created('postgresql'), leader-elected, config-changed, start
+            # db-relation-joined('postrgesql/0'), db-relation-changed('postgresql/0')
+            # To be fired.
+        """
+        self.begin()
+        # TODO: jam 2020-08-03 This should also handle storage-attached hooks once we have support
+        #  for dealing with storage.
+        self._charm.on.install.emit()
+        # Juju itself iterates what relation to fire based on a map[int]relation, so it doesn't
+        # guarantee a stable ordering between relation events. It *does* give a stable ordering
+        # of joined units for a given relation.
+        items = list(self._meta.relations.items())
+        random.shuffle(items)
+        this_app_name = self._meta.name
+        for relname, rel_meta in items:
+            if rel_meta.role == charm.RelationRole.peer:
+                # If the user has directly added a relation, leave it be, but otherwise ensure
+                # that peer relations are always established at before leader-elected.
+                rel_ids = self._backend._relation_ids_map.get(relname)
+                if rel_ids is None:
+                    self.add_relation(relname, self._meta.name)
+                else:
+                    random.shuffle(rel_ids)
+                    for rel_id in rel_ids:
+                        self._emit_relation_created(relname, rel_id, this_app_name)
+            else:
+                rel_ids = self._backend._relation_ids_map.get(relname, [])
+                random.shuffle(rel_ids)
+                for rel_id in rel_ids:
+                    app_name = self._backend._relation_app_and_units[rel_id]["app"]
+                    self._emit_relation_created(relname, rel_id, app_name)
+        if self._backend._is_leader:
+            self._charm.on.leader_elected.emit()
+        else:
+            self._charm.on.leader_settings_changed.emit()
+        self._charm.on.config_changed.emit()
+        self._charm.on.start.emit()
+        all_ids = list(self._backend._relation_names.items())
+        random.shuffle(all_ids)
+        for rel_id, rel_name in all_ids:
+            rel_app_and_units = self._backend._relation_app_and_units[rel_id]
+            app_name = rel_app_and_units["app"]
+            # Note: Juju *does* fire relation events for a given relation in the sorted order of
+            # the unit names. It also always fires relation-changed immediately after
+            # relation-joined for the same unit.
+            # Juju only fires relation-changed (app) if there is data for the related application
+            relation = self._model.get_relation(rel_name, rel_id)
+            if self._backend._relation_data[rel_id].get(app_name):
+                app = self._model.get_app(app_name)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, app, None)
+            for unit_name in sorted(rel_app_and_units["units"]):
+                remote_unit = self._model.get_unit(unit_name)
+                self._charm.on[rel_name].relation_joined.emit(
+                    relation, remote_unit.app, remote_unit)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, remote_unit.app, remote_unit)
+
+    def cleanup(self) -> None:
+        """Called by your test infrastructure to cleanup any temporary directories/files/etc.
+
+        Currently this only needs to be called if you test with resources. But it is reasonable
+        to always include a `testcase.addCleanup(harness.cleanup)` just in case.
+        """
+        self._backend._cleanup()
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def _load_config_defaults(self, charm_config):
+        """Load default values from config.yaml.
+
+        Handle the case where a user doesn't supply explicit config snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_config is None:
+            config_path = charm_dir / 'config.yaml'
+            if config_path.is_file():
+                charm_config = config_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of config that the framework can support
+                charm_config = '{}'
+        elif isinstance(charm_config, str):
+            charm_config = dedent(charm_config)
+        charm_config = yaml.load(charm_config, Loader=yaml.SafeLoader)
+        charm_config = charm_config.get('options', {})
+        return {key: value['default'] for key, value in charm_config.items()
+                if 'default' in value}
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+
+        as_yaml = yaml.dump(contents, Dumper=yaml.SafeDumper)
+        self._backend._resources_map[resource_name] = ('contents.yaml', as_yaml)
+
+    def add_resource(self, resource_name: str, content: typing.AnyStr) -> None:
+        """Add content for a resource to the backend.
+
+        This will register the content, so that a call to `Model.resources.fetch(resource_name)`
+        will return a path to a file containing that content.
+
+        Args:
+            resource_name: The name of the resource being added
+            content: Either string or bytes content, which will be the content of the filename
+                returned by resource-get. If contents is a string, it will be encoded in utf-8
+        """
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        record = self._meta.resources[resource_name]
+        if record.type != "file":
+            raise RuntimeError(
+                'Resource {} is not a file, but actually {}'.format(resource_name, record.type))
+        filename = record.filename
+        if filename is None:
+            filename = resource_name
+
+        self._backend._resources_map[resource_name] = (filename, content)
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    @contextmanager
+    def hooks_disabled(self):
+        """A context manager to run code with hooks disabled.
+
+        Example::
+
+            with harness.hooks_disabled():
+                # things in here don't fire events
+                harness.set_leader(True)
+                harness.update_config(unset=['foo', 'bar'])
+            # things here will again fire events
+        """
+        if self._hooks_enabled:
+            self.disable_hooks()
+            try:
+                yield None
+            finally:
+                self.enable_hooks()
+        else:
+            yield None
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        self._backend._relation_app_and_units[rel_id] = {
+            "app": remote_app,
+            "units": [],
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        self._emit_relation_created(relation_name, rel_id, remote_app)
+        return rel_id
+
+    def _emit_relation_created(self, relation_name: str, relation_id: int,
+                               remote_app: str) -> None:
+        """Trigger relation-created for a given relation with a given remote application."""
+        if self._charm is None or not self._hooks_enabled:
+            return
+        if self._charm is None or not self._hooks_enabled:
+            return
+        relation = self._model.get_relation(relation_name, relation_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event. This would naturally be
+        followed by a `relation_changed` event, which you can trigger with
+        :meth:`.update_relation_data`. This separation is artificial in the
+        sense that Juju will always fire the two, but is intended to make
+        testing relations and their data bags slightly more natural.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        # TODO: jam 2020-08-03 This is where we could assert that the unit name matches the
+        #  application name (eg you don't have a relation to 'foo' but add units of 'bar/0'
+        self._backend._relation_app_and_units[relation_id]["units"].append(remote_unit_name)
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_pod_spec(self) -> (typing.Mapping, typing.Mapping):
+        """Return the content of the pod spec as last set by the charm.
+
+        This returns both the pod spec and any k8s_resources that were supplied.
+        See the signature of Model.pod.set_spec
+        """
+        return self._backend._pod_spec
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def _update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will *not* trigger a `config_changed` event, and is intended for internal use.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        self._update_config(key_values, unset)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+class _ResourceEntry:
+    """Tracks the contents of a Resource."""
+
+    def __init__(self, resource_name):
+        self.name = resource_name
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        # {relation_id: {"app": app_name, "units": ["app/0",...]}
+        self._relation_app_and_units = {}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}  # {resource_name: resource_content}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+        self._resource_dir = None
+
+    def _cleanup(self):
+        if self._resource_dir is not None:
+            self._resource_dir.cleanup()
+            self._resource_dir = None
+
+    def _get_resource_dir(self) -> pathlib.Path:
+        if self._resource_dir is None:
+            # In actual Juju, the resource path for a charm's resource is
+            # $AGENT_DIR/resources/$RESOURCE_NAME/$RESOURCE_FILENAME
+            # However, charms shouldn't depend on this.
+            self._resource_dir = tempfile.TemporaryDirectory(prefix='tmp-ops-test-resource-')
+        return pathlib.Path(self._resource_dir.name)
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        if resource_name not in self._resources_map:
+            raise model.ModelError(
+                "ERROR could not download resource: HTTP request failed: "
+                "Get https://.../units/unit-{}/resources/{}: resource#{}/{} not found".format(
+                    self.unit_name.replace('/', '-'), resource_name, self.app_name, resource_name
+                ))
+        filename, contents = self._resources_map[resource_name]
+        resource_dir = self._get_resource_dir()
+        resource_filename = resource_dir / resource_name / filename
+        if not resource_filename.exists():
+            if isinstance(contents, bytes):
+                mode = 'wb'
+            else:
+                mode = 'wt'
+            resource_filename.parent.mkdir(exist_ok=True)
+            with resource_filename.open(mode=mode) as resource_file:
+                resource_file.write(contents)
+        return resource_filename
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/version.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..68f5166e2130b4b1c8764b4ae694ae4dcc798dc5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/ops/version.py
@@ -0,0 +1,3 @@
+# this is a generated file
+
+version = '1.0.1'
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/INSTALLER b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/LICENSE b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..0bf4a7fc04a1b7a913868a299680be3a040012ef
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/LICENSE
@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2009, Jay Loden, Dave Daeschler, Giampaolo Rodola'
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name of the psutil authors nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/METADATA b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..93c024357fd11e76c9cfc0963e758c0bd556fed8
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/METADATA
@@ -0,0 +1,561 @@
+Metadata-Version: 2.1
+Name: psutil
+Version: 5.7.3
+Summary: Cross-platform lib for process and system monitoring in Python.
+Home-page: https://github.com/giampaolo/psutil
+Author: Giampaolo Rodola
+Author-email: g.rodola@gmail.com
+License: BSD
+Keywords: ps,top,kill,free,lsof,netstat,nice,tty,ionice,uptime,taskmgr,process,df,iotop,iostat,ifconfig,taskset,who,pidof,pmap,smem,pstree,monitoring,ulimit,prlimit,smem,performance,metrics,agent,observability
+Platform: Platform Independent
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 7
+Classifier: Operating System :: Microsoft :: Windows :: Windows 8
+Classifier: Operating System :: Microsoft :: Windows :: Windows 8.1
+Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2003
+Classifier: Operating System :: Microsoft :: Windows :: Windows Server 2008
+Classifier: Operating System :: Microsoft :: Windows :: Windows Vista
+Classifier: Operating System :: Microsoft
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX :: AIX
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: POSIX :: BSD :: NetBSD
+Classifier: Operating System :: POSIX :: BSD :: OpenBSD
+Classifier: Operating System :: POSIX :: BSD
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: SunOS/Solaris
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.6
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Benchmark
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Networking :: Monitoring :: Hardware Watchdog
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Operating System
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Description-Content-Type: text/x-rst
+Provides-Extra: test
+Requires-Dist: ipaddress ; (python_version < "3.0") and extra == 'test'
+Requires-Dist: mock ; (python_version < "3.0") and extra == 'test'
+Requires-Dist: unittest2 ; (python_version < "3.0") and extra == 'test'
+Requires-Dist: enum34 ; (python_version <= "3.4") and extra == 'test'
+Requires-Dist: pywin32 ; (sys_platform == "win32") and extra == 'test'
+Requires-Dist: wmi ; (sys_platform == "win32") and extra == 'test'
+
+|  |downloads| |stars| |forks| |contributors| |coverage| |quality|
+|  |version| |py-versions| |packages| |license|
+|  |travis| |appveyor| |cirrus| |doc| |twitter| |tidelift|
+
+.. |downloads| image:: https://img.shields.io/pypi/dm/psutil.svg
+    :target: https://pepy.tech/project/psutil
+    :alt: Downloads
+
+.. |stars| image:: https://img.shields.io/github/stars/giampaolo/psutil.svg
+    :target: https://github.com/giampaolo/psutil/stargazers
+    :alt: Github stars
+
+.. |forks| image:: https://img.shields.io/github/forks/giampaolo/psutil.svg
+    :target: https://github.com/giampaolo/psutil/network/members
+    :alt: Github forks
+
+.. |contributors| image:: https://img.shields.io/github/contributors/giampaolo/psutil.svg
+    :target: https://github.com/giampaolo/psutil/graphs/contributors
+    :alt: Contributors
+
+.. |quality| image:: https://img.shields.io/codacy/grade/ce63e7f7f69d44b5b59682196e6fbfca.svg
+    :target: https://www.codacy.com/app/g-rodola/psutil?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=giampaolo/psutil&amp;utm_campaign=Badge_Grade
+    :alt: Code quality
+
+.. |travis| image:: https://img.shields.io/travis/giampaolo/psutil/master.svg?maxAge=3600&label=Linux,%20OSX,%20PyPy
+    :target: https://travis-ci.org/giampaolo/psutil
+    :alt: Linux tests (Travis)
+
+.. |appveyor| image:: https://img.shields.io/appveyor/ci/giampaolo/psutil/master.svg?maxAge=3600&label=Windows
+    :target: https://ci.appveyor.com/project/giampaolo/psutil
+    :alt: Windows tests (Appveyor)
+
+.. |cirrus| image:: https://img.shields.io/cirrus/github/giampaolo/psutil?label=FreeBSD
+    :target: https://cirrus-ci.com/github/giampaolo/psutil-cirrus-ci
+    :alt: FreeBSD tests (Cirrus-Ci)
+
+.. |coverage| image:: https://coveralls.io/repos/github/giampaolo/psutil/badge.svg?branch=master
+    :target: https://coveralls.io/github/giampaolo/psutil?branch=master
+    :alt: Test coverage (coverall.io)
+
+.. |doc| image:: https://readthedocs.org/projects/psutil/badge/?version=latest
+    :target: http://psutil.readthedocs.io/en/latest/?badge=latest
+    :alt: Documentation Status
+
+.. |version| image:: https://img.shields.io/pypi/v/psutil.svg?label=pypi
+    :target: https://pypi.org/project/psutil
+    :alt: Latest version
+
+.. |py-versions| image:: https://img.shields.io/pypi/pyversions/psutil.svg
+    :target: https://pypi.org/project/psutil
+    :alt: Supported Python versions
+
+.. |packages| image:: https://repology.org/badge/tiny-repos/python:psutil.svg
+    :target: https://repology.org/metapackage/python:psutil/versions
+    :alt: Binary packages
+
+.. |license| image:: https://img.shields.io/pypi/l/psutil.svg
+    :target: https://github.com/giampaolo/psutil/blob/master/LICENSE
+    :alt: License
+
+.. |twitter| image:: https://img.shields.io/twitter/follow/grodola.svg?label=follow&style=flat&logo=twitter&logoColor=4FADFF
+    :target: https://twitter.com/grodola
+    :alt: Twitter Follow
+
+.. |tidelift| image:: https://tidelift.com/badges/github/giampaolo/psutil?style=flat
+    :target: https://tidelift.com/subscription/pkg/pypi-psutil?utm_source=pypi-psutil&utm_medium=referral&utm_campaign=readme
+    :alt: Tidelift
+
+-----
+
+Quick links
+===========
+
+- `Home page <https://github.com/giampaolo/psutil>`_
+- `Install <https://github.com/giampaolo/psutil/blob/master/INSTALL.rst>`_
+- `Documentation <http://psutil.readthedocs.io>`_
+- `Download <https://pypi.org/project/psutil/#files>`_
+- `Forum <http://groups.google.com/group/psutil/topics>`_
+- `StackOverflow <https://stackoverflow.com/questions/tagged/psutil>`_
+- `Blog <https://gmpy.dev/tags/psutil>`_
+- `What's new <https://github.com/giampaolo/psutil/blob/master/HISTORY.rst>`_
+
+
+Summary
+=======
+
+psutil (process and system utilities) is a cross-platform library for
+retrieving information on **running processes** and **system utilization**
+(CPU, memory, disks, network, sensors) in Python.
+It is useful mainly for **system monitoring**, **profiling and limiting process
+resources** and **management of running processes**.
+It implements many functionalities offered by classic UNIX command line tools
+such as *ps, top, iotop, lsof, netstat, ifconfig, free* and others.
+psutil currently supports the following platforms:
+
+- **Linux**
+- **Windows**
+- **macOS**
+- **FreeBSD, OpenBSD**, **NetBSD**
+- **Sun Solaris**
+- **AIX**
+
+...both **32-bit** and **64-bit** architectures. Supported Python versions are **2.6**, **2.7** and **3.4+**, `PyPy <http://pypy.org/>`__ 2.7 and 3.X.
+
+Funding
+=======
+
+While psutil is free software and will always be, the project would benefit
+immensely from some funding.
+Keeping up with bug reports and maintenance has become hardly sustainable for
+me alone in terms of time.
+If you're a company that's making significant use of psutil you can consider
+becoming a sponsor via `GitHub <https://github.com/sponsors/giampaolo>`__,
+`Open Collective <https://opencollective.com/psutil>`__ or
+`PayPal <https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=A9ZS7PKKRM3S8>`__
+and have your logo displayed in here and psutil `doc <https://psutil.readthedocs.io>`__.
+
+Sponsors
+========
+
+.. image:: https://github.com/giampaolo/psutil/raw/master/docs/_static/tidelift-logo.png
+  :width: 200
+  :alt: Alternative text
+
+`Add your logo <https://github.com/sponsors/giampaolo>`__.
+
+Example usages
+==============
+
+This represents pretty much the whole psutil API.
+
+CPU
+---
+
+.. code-block:: python
+
+    >>> import psutil
+    >>>
+    >>> psutil.cpu_times()
+    scputimes(user=3961.46, nice=169.729, system=2150.659, idle=16900.540, iowait=629.59, irq=0.0, softirq=19.42, steal=0.0, guest=0, nice=0.0)
+    >>>
+    >>> for x in range(3):
+    ...     psutil.cpu_percent(interval=1)
+    ...
+    4.0
+    5.9
+    3.8
+    >>>
+    >>> for x in range(3):
+    ...     psutil.cpu_percent(interval=1, percpu=True)
+    ...
+    [4.0, 6.9, 3.7, 9.2]
+    [7.0, 8.5, 2.4, 2.1]
+    [1.2, 9.0, 9.9, 7.2]
+    >>>
+    >>> for x in range(3):
+    ...     psutil.cpu_times_percent(interval=1, percpu=False)
+    ...
+    scputimes(user=1.5, nice=0.0, system=0.5, idle=96.5, iowait=1.5, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
+    scputimes(user=1.0, nice=0.0, system=0.0, idle=99.0, iowait=0.0, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
+    scputimes(user=2.0, nice=0.0, system=0.0, idle=98.0, iowait=0.0, irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
+    >>>
+    >>> psutil.cpu_count()
+    4
+    >>> psutil.cpu_count(logical=False)
+    2
+    >>>
+    >>> psutil.cpu_stats()
+    scpustats(ctx_switches=20455687, interrupts=6598984, soft_interrupts=2134212, syscalls=0)
+    >>>
+    >>> psutil.cpu_freq()
+    scpufreq(current=931.42925, min=800.0, max=3500.0)
+    >>>
+    >>> psutil.getloadavg()  # also on Windows (emulated)
+    (3.14, 3.89, 4.67)
+
+Memory
+------
+
+.. code-block:: python
+
+    >>> psutil.virtual_memory()
+    svmem(total=10367352832, available=6472179712, percent=37.6, used=8186245120, free=2181107712, active=4748992512, inactive=2758115328, buffers=790724608, cached=3500347392, shared=787554304)
+    >>> psutil.swap_memory()
+    sswap(total=2097147904, used=296128512, free=1801019392, percent=14.1, sin=304193536, sout=677842944)
+    >>>
+
+Disks
+-----
+
+.. code-block:: python
+
+    >>> psutil.disk_partitions()
+    [sdiskpart(device='/dev/sda1', mountpoint='/', fstype='ext4', opts='rw,nosuid'),
+     sdiskpart(device='/dev/sda2', mountpoint='/home', fstype='ext, opts='rw')]
+    >>>
+    >>> psutil.disk_usage('/')
+    sdiskusage(total=21378641920, used=4809781248, free=15482871808, percent=22.5)
+    >>>
+    >>> psutil.disk_io_counters(perdisk=False)
+    sdiskio(read_count=719566, write_count=1082197, read_bytes=18626220032, write_bytes=24081764352, read_time=5023392, write_time=63199568, read_merged_count=619166, write_merged_count=812396, busy_time=4523412)
+    >>>
+
+Network
+-------
+
+.. code-block:: python
+
+    >>> psutil.net_io_counters(pernic=True)
+    {'eth0': netio(bytes_sent=485291293, bytes_recv=6004858642, packets_sent=3251564, packets_recv=4787798, errin=0, errout=0, dropin=0, dropout=0),
+     'lo': netio(bytes_sent=2838627, bytes_recv=2838627, packets_sent=30567, packets_recv=30567, errin=0, errout=0, dropin=0, dropout=0)}
+    >>>
+    >>> psutil.net_connections()
+    [sconn(fd=115, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=48776), raddr=addr(ip='93.186.135.91', port=80), status='ESTABLISHED', pid=1254),
+     sconn(fd=117, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=43761), raddr=addr(ip='72.14.234.100', port=80), status='CLOSING', pid=2987),
+     ...]
+    >>>
+    >>> psutil.net_if_addrs()
+    {'lo': [snicaddr(family=<AddressFamily.AF_INET: 2>, address='127.0.0.1', netmask='255.0.0.0', broadcast='127.0.0.1', ptp=None),
+            snicaddr(family=<AddressFamily.AF_INET6: 10>, address='::1', netmask='ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff', broadcast=None, ptp=None),
+            snicaddr(family=<AddressFamily.AF_LINK: 17>, address='00:00:00:00:00:00', netmask=None, broadcast='00:00:00:00:00:00', ptp=None)],
+     'wlan0': [snicaddr(family=<AddressFamily.AF_INET: 2>, address='192.168.1.3', netmask='255.255.255.0', broadcast='192.168.1.255', ptp=None),
+               snicaddr(family=<AddressFamily.AF_INET6: 10>, address='fe80::c685:8ff:fe45:641%wlan0', netmask='ffff:ffff:ffff:ffff::', broadcast=None, ptp=None),
+               snicaddr(family=<AddressFamily.AF_LINK: 17>, address='c4:85:08:45:06:41', netmask=None, broadcast='ff:ff:ff:ff:ff:ff', ptp=None)]}
+    >>>
+    >>> psutil.net_if_stats()
+    {'lo': snicstats(isup=True, duplex=<NicDuplex.NIC_DUPLEX_UNKNOWN: 0>, speed=0, mtu=65536),
+     'wlan0': snicstats(isup=True, duplex=<NicDuplex.NIC_DUPLEX_FULL: 2>, speed=100, mtu=1500)}
+    >>>
+
+Sensors
+-------
+
+.. code-block:: python
+
+    >>> import psutil
+    >>> psutil.sensors_temperatures()
+    {'acpitz': [shwtemp(label='', current=47.0, high=103.0, critical=103.0)],
+     'asus': [shwtemp(label='', current=47.0, high=None, critical=None)],
+     'coretemp': [shwtemp(label='Physical id 0', current=52.0, high=100.0, critical=100.0),
+                  shwtemp(label='Core 0', current=45.0, high=100.0, critical=100.0)]}
+    >>>
+    >>> psutil.sensors_fans()
+    {'asus': [sfan(label='cpu_fan', current=3200)]}
+    >>>
+    >>> psutil.sensors_battery()
+    sbattery(percent=93, secsleft=16628, power_plugged=False)
+    >>>
+
+Other system info
+-----------------
+
+.. code-block:: python
+
+    >>> import psutil
+    >>> psutil.users()
+    [suser(name='giampaolo', terminal='pts/2', host='localhost', started=1340737536.0, pid=1352),
+     suser(name='giampaolo', terminal='pts/3', host='localhost', started=1340737792.0, pid=1788)]
+    >>>
+    >>> psutil.boot_time()
+    1365519115.0
+    >>>
+
+Process management
+------------------
+
+.. code-block:: python
+
+    >>> import psutil
+    >>> psutil.pids()
+    [1, 2, 3, 4, 5, 6, 7, 46, 48, 50, 51, 178, 182, 222, 223, 224, 268, 1215, 1216, 1220, 1221, 1243, 1244,
+     1301, 1601, 2237, 2355, 2637, 2774, 3932, 4176, 4177, 4185, 4187, 4189, 4225, 4243, 4245, 4263, 4282,
+     4306, 4311, 4312, 4313, 4314, 4337, 4339, 4357, 4358, 4363, 4383, 4395, 4408, 4433, 4443, 4445, 4446,
+     5167, 5234, 5235, 5252, 5318, 5424, 5644, 6987, 7054, 7055, 7071]
+    >>>
+    >>> p = psutil.Process(7055)
+    >>> p
+    psutil.Process(pid=7055, name='python3', status='running', started='09:04:44')
+    >>> p.name()
+    'python'
+    >>> p.exe()
+    '/usr/bin/python'
+    >>> p.cwd()
+    '/home/giampaolo'
+    >>> p.cmdline()
+    ['/usr/bin/python', 'main.py']
+    >>>
+    >>> p.pid
+    7055
+    >>> p.ppid()
+    7054
+    >>> p.children(recursive=True)
+    [psutil.Process(pid=29835, name='python3', status='sleeping', started='11:45:38'),
+     psutil.Process(pid=29836, name='python3', status='waking', started='11:43:39')]
+    >>>
+    >>> p.parent()
+    psutil.Process(pid=4699, name='bash', status='sleeping', started='09:06:44')
+    >>> p.parents()
+    [psutil.Process(pid=4699, name='bash', started='09:06:44'),
+     psutil.Process(pid=4689, name='gnome-terminal-server', status='sleeping', started='0:06:44'),
+     psutil.Process(pid=1, name='systemd', status='sleeping', started='05:56:55')]
+    >>>
+    >>> p.status()
+    'running'
+    >>> p.username()
+    'giampaolo'
+    >>> p.create_time()
+    1267551141.5019531
+    >>> p.terminal()
+    '/dev/pts/0'
+    >>>
+    >>> p.uids()
+    puids(real=1000, effective=1000, saved=1000)
+    >>> p.gids()
+    pgids(real=1000, effective=1000, saved=1000)
+    >>>
+    >>> p.cpu_times()
+    pcputimes(user=1.02, system=0.31, children_user=0.32, children_system=0.1, iowait=0.0)
+    >>> p.cpu_percent(interval=1.0)
+    12.1
+    >>> p.cpu_affinity()
+    [0, 1, 2, 3]
+    >>> p.cpu_affinity([0, 1])  # set
+    >>> p.cpu_num()
+    1
+    >>>
+    >>> p.memory_info()
+    pmem(rss=10915840, vms=67608576, shared=3313664, text=2310144, lib=0, data=7262208, dirty=0)
+    >>> p.memory_full_info()  # "real" USS memory usage (Linux, macOS, Win only)
+    pfullmem(rss=10199040, vms=52133888, shared=3887104, text=2867200, lib=0, data=5967872, dirty=0, uss=6545408, pss=6872064, swap=0)
+    >>> p.memory_percent()
+    0.7823
+    >>> p.memory_maps()
+    [pmmap_grouped(path='/lib/x8664-linux-gnu/libutil-2.15.so', rss=32768, size=2125824, pss=32768, shared_clean=0, shared_dirty=0, private_clean=20480, private_dirty=12288, referenced=32768, anonymous=12288, swap=0),
+     pmmap_grouped(path='/lib/x8664-linux-gnu/libc-2.15.so', rss=3821568, size=3842048, pss=3821568, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=3821568, referenced=3575808, anonymous=3821568, swap=0),
+     pmmap_grouped(path='[heap]',  rss=32768, size=139264, pss=32768, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=32768, referenced=32768, anonymous=32768, swap=0),
+     pmmap_grouped(path='[stack]', rss=2465792, size=2494464, pss=2465792, shared_clean=0, shared_dirty=0, private_clean=0, private_dirty=2465792, referenced=2277376, anonymous=2465792, swap=0),
+     ...]
+    >>>
+    >>> p.io_counters()
+    pio(read_count=478001, write_count=59371, read_bytes=700416, write_bytes=69632, read_chars=456232, write_chars=517543)
+    >>>
+    >>> p.open_files()
+    [popenfile(path='/home/giampaolo/monit.py', fd=3, position=0, mode='r', flags=32768),
+     popenfile(path='/var/log/monit.log', fd=4, position=235542, mode='a', flags=33793)]
+    >>>
+    >>> p.connections()
+    [pconn(fd=115, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=48776), raddr=addr(ip='93.186.135.91', port=80), status='ESTABLISHED'),
+     pconn(fd=117, family=<AddressFamily.AF_INET: 2>, type=<SocketType.SOCK_STREAM: 1>, laddr=addr(ip='10.0.0.1', port=43761), raddr=addr(ip='72.14.234.100', port=80), status='CLOSING')]
+    >>>
+    >>> p.num_threads()
+    4
+    >>> p.num_fds()
+    8
+    >>> p.threads()
+    [pthread(id=5234, user_time=22.5, system_time=9.2891),
+     pthread(id=5237, user_time=0.0707, system_time=1.1)]
+    >>>
+    >>> p.num_ctx_switches()
+    pctxsw(voluntary=78, involuntary=19)
+    >>>
+    >>> p.nice()
+    0
+    >>> p.nice(10)  # set
+    >>>
+    >>> p.ionice(psutil.IOPRIO_CLASS_IDLE)  # IO priority (Win and Linux only)
+    >>> p.ionice()
+    pionice(ioclass=<IOPriority.IOPRIO_CLASS_IDLE: 3>, value=0)
+    >>>
+    >>> p.rlimit(psutil.RLIMIT_NOFILE, (5, 5))  # set resource limits (Linux only)
+    >>> p.rlimit(psutil.RLIMIT_NOFILE)
+    (5, 5)
+    >>>
+    >>> p.environ()
+    {'LC_PAPER': 'it_IT.UTF-8', 'SHELL': '/bin/bash', 'GREP_OPTIONS': '--color=auto',
+    'XDG_CONFIG_DIRS': '/etc/xdg/xdg-ubuntu:/usr/share/upstart/xdg:/etc/xdg',
+     ...}
+    >>>
+    >>> p.as_dict()
+    {'status': 'running', 'num_ctx_switches': pctxsw(voluntary=63, involuntary=1), 'pid': 5457, ...}
+    >>> p.is_running()
+    True
+    >>> p.suspend()
+    >>> p.resume()
+    >>>
+    >>> p.terminate()
+    >>> p.kill()
+    >>> p.wait(timeout=3)
+    <Exitcode.EX_OK: 0>
+    >>>
+    >>> psutil.test()
+    USER         PID %CPU %MEM     VSZ     RSS TTY        START    TIME  COMMAND
+    root           1  0.0  0.0   24584    2240            Jun17   00:00  init
+    root           2  0.0  0.0       0       0            Jun17   00:00  kthreadd
+    ...
+    giampaolo  31475  0.0  0.0   20760    3024 /dev/pts/0 Jun19   00:00  python2.4
+    giampaolo  31721  0.0  2.2  773060  181896            00:04   10:30  chrome
+    root       31763  0.0  0.0       0       0            00:05   00:00  kworker/0:1
+    >>>
+
+Further process APIs
+--------------------
+
+.. code-block:: python
+
+    >>> import psutil
+    >>> for proc in psutil.process_iter(['pid', 'name']):
+    ...     print(proc.info)
+    ...
+    {'pid': 1, 'name': 'systemd'}
+    {'pid': 2, 'name': 'kthreadd'}
+    {'pid': 3, 'name': 'ksoftirqd/0'}
+    ...
+    >>>
+    >>> psutil.pid_exists(3)
+    True
+    >>>
+    >>> def on_terminate(proc):
+    ...     print("process {} terminated".format(proc))
+    ...
+    >>> # waits for multiple processes to terminate
+    >>> gone, alive = psutil.wait_procs(procs_list, timeout=3, callback=on_terminate)
+    >>>
+
+Popen wrapper:
+
+.. code-block:: python
+
+    >>> import psutil
+    >>> from subprocess import PIPE
+    >>> p = psutil.Popen(["/usr/bin/python", "-c", "print('hello')"], stdout=PIPE)
+    >>> p.name()
+    'python'
+    >>> p.username()
+    'giampaolo'
+    >>> p.communicate()
+    ('hello\n', None)
+    >>> p.wait(timeout=2)
+    0
+    >>>
+
+Windows services
+----------------
+
+.. code-block:: python
+
+    >>> list(psutil.win_service_iter())
+    [<WindowsService(name='AeLookupSvc', display_name='Application Experience') at 38850096>,
+     <WindowsService(name='ALG', display_name='Application Layer Gateway Service') at 38850128>,
+     <WindowsService(name='APNMCP', display_name='Ask Update Service') at 38850160>,
+     <WindowsService(name='AppIDSvc', display_name='Application Identity') at 38850192>,
+     ...]
+    >>> s = psutil.win_service_get('alg')
+    >>> s.as_dict()
+    {'binpath': 'C:\\Windows\\System32\\alg.exe',
+     'description': 'Provides support for 3rd party protocol plug-ins for Internet Connection Sharing',
+     'display_name': 'Application Layer Gateway Service',
+     'name': 'alg',
+     'pid': None,
+     'start_type': 'manual',
+     'status': 'stopped',
+     'username': 'NT AUTHORITY\\LocalService'}
+
+Projects using psutil
+=====================
+
+Here's some I find particularly interesting:
+
+- https://github.com/google/grr
+- https://github.com/facebook/osquery/
+- https://github.com/nicolargo/glances
+- https://github.com/Jahaja/psdash
+- https://github.com/ajenti/ajenti
+- https://github.com/home-assistant/home-assistant/
+
+Portings
+========
+
+- Go: https://github.com/shirou/gopsutil
+- C: https://github.com/hamon-in/cpslib
+- Rust: https://github.com/rust-psutil/rust-psutil
+- Nim: https://github.com/johnscillieri/psutil-nim
+
+Security
+========
+
+To report a security vulnerability, please use the `Tidelift security
+contact`_.  Tidelift will coordinate the fix and disclosure.
+
+.. _`Giampaolo Rodola`: https://gmpy.dev/about
+.. _`donation`: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=A9ZS7PKKRM3S8
+.. _Tidelift security contact: https://tidelift.com/security
+.. _Tidelift Subscription: https://tidelift.com/subscription/pkg/pypi-psutil?utm_source=pypi-psutil&utm_medium=referral&utm_campaign=readme
+
+
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/RECORD b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..625588b0b12ba3b7d2d56234fd95af4a71ba2f76
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/RECORD
@@ -0,0 +1,65 @@
+psutil-5.7.3.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+psutil-5.7.3.dist-info/LICENSE,sha256=JMEphFAMqgf_3OGe68BjlsXm0kS1c7xsQ49KbvjlbBs,1549
+psutil-5.7.3.dist-info/METADATA,sha256=nz9BpzTO0Kl3XVOZbpQLDSQR8PUQWwzcrF6OP_2NoOk,22753
+psutil-5.7.3.dist-info/RECORD,,
+psutil-5.7.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+psutil-5.7.3.dist-info/WHEEL,sha256=rjs0dbLt66v8mjOfCbR-uj5Usgl2OLAlmRdCEyNo0L4,104
+psutil-5.7.3.dist-info/top_level.txt,sha256=gCNhn57wzksDjSAISmgMJ0aiXzQulk0GJhb2-BAyYgw,7
+psutil/__init__.py,sha256=eJ5pJhuV_nF41jLjT6X7Taeo5qXrwMkbnCxReJWI4xc,86277
+psutil/__pycache__/__init__.cpython-37.pyc,,
+psutil/__pycache__/_common.cpython-37.pyc,,
+psutil/__pycache__/_compat.cpython-37.pyc,,
+psutil/__pycache__/_psaix.cpython-37.pyc,,
+psutil/__pycache__/_psbsd.cpython-37.pyc,,
+psutil/__pycache__/_pslinux.cpython-37.pyc,,
+psutil/__pycache__/_psosx.cpython-37.pyc,,
+psutil/__pycache__/_psposix.cpython-37.pyc,,
+psutil/__pycache__/_pssunos.cpython-37.pyc,,
+psutil/__pycache__/_pswindows.cpython-37.pyc,,
+psutil/_common.py,sha256=0ejF34XVXFNPuSJWq3TXfLjfafAGaoSmRkzxxnmEByQ,26159
+psutil/_compat.py,sha256=wiGTaLFqCNUrCFvFfRXp4Y3gn5FiqzLUFVTCp6GA3tY,14474
+psutil/_psaix.py,sha256=u9M_jJqkiGqNgdhum9MZTbnS4pjIfdCHNr3HAYHA0GQ,18458
+psutil/_psbsd.py,sha256=wVVDf5ekCECD9aFin6BNulanQKktrzZ6JRbIN1jEy7g,31034
+psutil/_pslinux.py,sha256=-9auWbNF5PY9flHQPKntz0unzzo0Cz_SC1P1L-20ZgA,80044
+psutil/_psosx.py,sha256=l7ed-nXKGEqp_99QAdjL6OwOqswmySRqKb4oC1eqVlc,17397
+psutil/_psposix.py,sha256=IcXJTdU6osTJwjB2uDohCLnuGPl5BGQYD6vDg0sOJ8c,8045
+psutil/_pssunos.py,sha256=c-0et4xslK83ZiTizQ9W3LH0pMZy11ATEIBbQBJ_v-g,25398
+psutil/_psutil_linux.cpython-37m-x86_64-linux-gnu.so,sha256=nc-Ca4xNNilOq8lrHiSejLyCcNsOP9fm6D5-7DRfVfU,128160
+psutil/_psutil_posix.cpython-37m-x86_64-linux-gnu.so,sha256=MBwAtZhw7GhhKycpSz0MTqiJ6BzB3uqOUumKp_2_d5Q,84000
+psutil/_pswindows.py,sha256=JyffHx0PmRJY-4FnL0eevPdmrnB7d96AuV6mTvUavPc,36841
+psutil/tests/__init__.py,sha256=M_YgVl0clqwC_JKrPg_LLrcw7EanSxL8taq11JKdpZ4,52464
+psutil/tests/__main__.py,sha256=bBfMPu_gPzyiA4gfAFSZLk7LyLSPTUIHQFU1kFcj_Ok,291
+psutil/tests/__pycache__/__init__.cpython-37.pyc,,
+psutil/tests/__pycache__/__main__.cpython-37.pyc,,
+psutil/tests/__pycache__/runner.cpython-37.pyc,,
+psutil/tests/__pycache__/test_aix.cpython-37.pyc,,
+psutil/tests/__pycache__/test_bsd.cpython-37.pyc,,
+psutil/tests/__pycache__/test_connections.cpython-37.pyc,,
+psutil/tests/__pycache__/test_contracts.cpython-37.pyc,,
+psutil/tests/__pycache__/test_linux.cpython-37.pyc,,
+psutil/tests/__pycache__/test_memleaks.cpython-37.pyc,,
+psutil/tests/__pycache__/test_misc.cpython-37.pyc,,
+psutil/tests/__pycache__/test_osx.cpython-37.pyc,,
+psutil/tests/__pycache__/test_posix.cpython-37.pyc,,
+psutil/tests/__pycache__/test_process.cpython-37.pyc,,
+psutil/tests/__pycache__/test_sunos.cpython-37.pyc,,
+psutil/tests/__pycache__/test_system.cpython-37.pyc,,
+psutil/tests/__pycache__/test_testutils.cpython-37.pyc,,
+psutil/tests/__pycache__/test_unicode.cpython-37.pyc,,
+psutil/tests/__pycache__/test_windows.cpython-37.pyc,,
+psutil/tests/runner.py,sha256=PZr_dcVCVNNXqy_jquoe-ZHGLI5VGFfAYS8HgtIoZPU,11331
+psutil/tests/test_aix.py,sha256=r78PBazMdlagip3tnWdZIS6HxQNTirE9c8GWqPkcKTw,4526
+psutil/tests/test_bsd.py,sha256=W-RCW0FRo0bOJnpSnX6NuVKDd6-6zdbsD1rRNDS8Yd0,20665
+psutil/tests/test_connections.py,sha256=6sPpo05JT9Y9yEdXG-kqniYRqHew-0h4hnHIwGAucJA,25104
+psutil/tests/test_contracts.py,sha256=gvPRr62YN-HPJgwKa84ZhSog0beqI_aEG9EGuqIznBw,26188
+psutil/tests/test_linux.py,sha256=lvAMeQ8hYfxW40hnd8KUqIBPlCw9TWeg5Ef_SS-5-SQ,90426
+psutil/tests/test_memleaks.py,sha256=Ppmmo4OutHuVmI-g_ynRxrKe7-gZBIRLI7KKANZCIvk,14895
+psutil/tests/test_misc.py,sha256=Rzt4S-t9KfaDJyw_PJFkI3RMZh17VHEkEbM4StNkayQ,28746
+psutil/tests/test_osx.py,sha256=hEq5CsoVsOaRRqp_nOF1IXVcwcDtKxJ4vi1M1lQDcc0,7564
+psutil/tests/test_posix.py,sha256=j6d_edkkdUs-ukHRf5ekH9IWe621XPGRtqf4hy6AyXI,14816
+psutil/tests/test_process.py,sha256=jDROm3WDVBqVmS2_WX4nrrSZVYTVqbA1y3jkqMm52mg,60154
+psutil/tests/test_sunos.py,sha256=tosB6-4boM6ZlIVaeJZh6YbBY8gVGRm0YIXgb_Z69GU,1351
+psutil/tests/test_system.py,sha256=cN8FPdCZJM-_5LLBN7yqdw0VqEmUMuEAPRX8OxfD6PY,36041
+psutil/tests/test_testutils.py,sha256=A9nneh29Z9rN7wM4ekBg4QdXL5diD4mCUI1Uw6B5jec,14420
+psutil/tests/test_unicode.py,sha256=uypaRYFe9y5T3f308PZ23P4pl_Dgf1WJPaP2NBmW97E,12889
+psutil/tests/test_windows.py,sha256=-xS0SYB2sa0CFwvMsnTaBe5oYua8AOs67hgyJbAQfZE,32620
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/REQUESTED b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/REQUESTED
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/WHEEL b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..aa5b41c9bcfd55ac012ff014dff384b052ae4e80
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: false
+Tag: cp37-cp37m-linux_x86_64
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/top_level.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a4d92cc08db6a0d8bfedbbbd620d1fb11f84677b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil-5.7.3.dist-info/top_level.txt
@@ -0,0 +1 @@
+psutil
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..cc4e79cc7a9b408deb886c02adb2d6ee1f70e679
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/__init__.py
@@ -0,0 +1,2389 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""psutil is a cross-platform library for retrieving information on
+running processes and system utilization (CPU, memory, disks, network,
+sensors) in Python. Supported platforms:
+
+ - Linux
+ - Windows
+ - macOS
+ - FreeBSD
+ - OpenBSD
+ - NetBSD
+ - Sun Solaris
+ - AIX
+
+Works with Python versions from 2.6 to 3.4+.
+"""
+
+from __future__ import division
+import collections
+import contextlib
+import datetime
+import functools
+import os
+import signal
+import subprocess
+import sys
+import threading
+import time
+try:
+    import pwd
+except ImportError:
+    pwd = None
+
+from . import _common
+from ._common import AccessDenied
+from ._common import Error
+from ._common import memoize_when_activated
+from ._common import NoSuchProcess
+from ._common import TimeoutExpired
+from ._common import wrap_numbers as _wrap_numbers
+from ._common import ZombieProcess
+from ._compat import long
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import PY3 as _PY3
+
+from ._common import CONN_CLOSE
+from ._common import CONN_CLOSE_WAIT
+from ._common import CONN_CLOSING
+from ._common import CONN_ESTABLISHED
+from ._common import CONN_FIN_WAIT1
+from ._common import CONN_FIN_WAIT2
+from ._common import CONN_LAST_ACK
+from ._common import CONN_LISTEN
+from ._common import CONN_NONE
+from ._common import CONN_SYN_RECV
+from ._common import CONN_SYN_SENT
+from ._common import CONN_TIME_WAIT
+from ._common import NIC_DUPLEX_FULL
+from ._common import NIC_DUPLEX_HALF
+from ._common import NIC_DUPLEX_UNKNOWN
+from ._common import POWER_TIME_UNKNOWN
+from ._common import POWER_TIME_UNLIMITED
+from ._common import STATUS_DEAD
+from ._common import STATUS_DISK_SLEEP
+from ._common import STATUS_IDLE
+from ._common import STATUS_LOCKED
+from ._common import STATUS_PARKED
+from ._common import STATUS_RUNNING
+from ._common import STATUS_SLEEPING
+from ._common import STATUS_STOPPED
+from ._common import STATUS_TRACING_STOP
+from ._common import STATUS_WAITING
+from ._common import STATUS_WAKING
+from ._common import STATUS_ZOMBIE
+
+from ._common import AIX
+from ._common import BSD
+from ._common import FREEBSD  # NOQA
+from ._common import LINUX
+from ._common import MACOS
+from ._common import NETBSD  # NOQA
+from ._common import OPENBSD  # NOQA
+from ._common import OSX  # deprecated alias
+from ._common import POSIX  # NOQA
+from ._common import SUNOS
+from ._common import WINDOWS
+
+if LINUX:
+    # This is public API and it will be retrieved from _pslinux.py
+    # via sys.modules.
+    PROCFS_PATH = "/proc"
+
+    from . import _pslinux as _psplatform
+
+    from ._pslinux import IOPRIO_CLASS_BE  # NOQA
+    from ._pslinux import IOPRIO_CLASS_IDLE  # NOQA
+    from ._pslinux import IOPRIO_CLASS_NONE  # NOQA
+    from ._pslinux import IOPRIO_CLASS_RT  # NOQA
+
+elif WINDOWS:
+    from . import _pswindows as _psplatform
+    from ._psutil_windows import ABOVE_NORMAL_PRIORITY_CLASS  # NOQA
+    from ._psutil_windows import BELOW_NORMAL_PRIORITY_CLASS  # NOQA
+    from ._psutil_windows import HIGH_PRIORITY_CLASS  # NOQA
+    from ._psutil_windows import IDLE_PRIORITY_CLASS  # NOQA
+    from ._psutil_windows import NORMAL_PRIORITY_CLASS  # NOQA
+    from ._psutil_windows import REALTIME_PRIORITY_CLASS  # NOQA
+    from ._pswindows import CONN_DELETE_TCB  # NOQA
+    from ._pswindows import IOPRIO_VERYLOW  # NOQA
+    from ._pswindows import IOPRIO_LOW  # NOQA
+    from ._pswindows import IOPRIO_NORMAL  # NOQA
+    from ._pswindows import IOPRIO_HIGH  # NOQA
+
+elif MACOS:
+    from . import _psosx as _psplatform
+
+elif BSD:
+    from . import _psbsd as _psplatform
+
+elif SUNOS:
+    from . import _pssunos as _psplatform
+    from ._pssunos import CONN_BOUND  # NOQA
+    from ._pssunos import CONN_IDLE  # NOQA
+
+    # This is public writable API which is read from _pslinux.py and
+    # _pssunos.py via sys.modules.
+    PROCFS_PATH = "/proc"
+
+elif AIX:
+    from . import _psaix as _psplatform
+
+    # This is public API and it will be retrieved from _pslinux.py
+    # via sys.modules.
+    PROCFS_PATH = "/proc"
+
+else:  # pragma: no cover
+    raise NotImplementedError('platform %s is not supported' % sys.platform)
+
+
+__all__ = [
+    # exceptions
+    "Error", "NoSuchProcess", "ZombieProcess", "AccessDenied",
+    "TimeoutExpired",
+
+    # constants
+    "version_info", "__version__",
+
+    "STATUS_RUNNING", "STATUS_IDLE", "STATUS_SLEEPING", "STATUS_DISK_SLEEP",
+    "STATUS_STOPPED", "STATUS_TRACING_STOP", "STATUS_ZOMBIE", "STATUS_DEAD",
+    "STATUS_WAKING", "STATUS_LOCKED", "STATUS_WAITING", "STATUS_LOCKED",
+    "STATUS_PARKED",
+
+    "CONN_ESTABLISHED", "CONN_SYN_SENT", "CONN_SYN_RECV", "CONN_FIN_WAIT1",
+    "CONN_FIN_WAIT2", "CONN_TIME_WAIT", "CONN_CLOSE", "CONN_CLOSE_WAIT",
+    "CONN_LAST_ACK", "CONN_LISTEN", "CONN_CLOSING", "CONN_NONE",
+    # "CONN_IDLE", "CONN_BOUND",
+
+    "AF_LINK",
+
+    "NIC_DUPLEX_FULL", "NIC_DUPLEX_HALF", "NIC_DUPLEX_UNKNOWN",
+
+    "POWER_TIME_UNKNOWN", "POWER_TIME_UNLIMITED",
+
+    "BSD", "FREEBSD", "LINUX", "NETBSD", "OPENBSD", "MACOS", "OSX", "POSIX",
+    "SUNOS", "WINDOWS", "AIX",
+
+    # "RLIM_INFINITY", "RLIMIT_AS", "RLIMIT_CORE", "RLIMIT_CPU", "RLIMIT_DATA",
+    # "RLIMIT_FSIZE", "RLIMIT_LOCKS", "RLIMIT_MEMLOCK", "RLIMIT_NOFILE",
+    # "RLIMIT_NPROC", "RLIMIT_RSS", "RLIMIT_STACK", "RLIMIT_MSGQUEUE",
+    # "RLIMIT_NICE", "RLIMIT_RTPRIO", "RLIMIT_RTTIME", "RLIMIT_SIGPENDING",
+
+    # classes
+    "Process", "Popen",
+
+    # functions
+    "pid_exists", "pids", "process_iter", "wait_procs",             # proc
+    "virtual_memory", "swap_memory",                                # memory
+    "cpu_times", "cpu_percent", "cpu_times_percent", "cpu_count",   # cpu
+    "cpu_stats",  # "cpu_freq", "getloadavg"
+    "net_io_counters", "net_connections", "net_if_addrs",           # network
+    "net_if_stats",
+    "disk_io_counters", "disk_partitions", "disk_usage",            # disk
+    # "sensors_temperatures", "sensors_battery", "sensors_fans"     # sensors
+    "users", "boot_time",                                           # others
+]
+
+__all__.extend(_psplatform.__extra__all__)
+
+if LINUX or FREEBSD:
+    # Populate global namespace with RLIM* constants.
+    from . import _psutil_posix
+
+    _globals = globals()
+    _name = None
+    for _name in dir(_psutil_posix):
+        if _name.startswith('RLIM') and _name.isupper():
+            _globals[_name] = getattr(_psutil_posix, _name)
+            __all__.append(_name)
+    del _globals, _name
+
+AF_LINK = _psplatform.AF_LINK
+
+__author__ = "Giampaolo Rodola'"
+__version__ = "5.7.3"
+version_info = tuple([int(num) for num in __version__.split('.')])
+
+_timer = getattr(time, 'monotonic', time.time)
+_TOTAL_PHYMEM = None
+_LOWEST_PID = None
+_SENTINEL = object()
+
+# Sanity check in case the user messed up with psutil installation
+# or did something weird with sys.path. In this case we might end
+# up importing a python module using a C extension module which
+# was compiled for a different version of psutil.
+# We want to prevent that by failing sooner rather than later.
+# See: https://github.com/giampaolo/psutil/issues/564
+if (int(__version__.replace('.', '')) !=
+        getattr(_psplatform.cext, 'version', None)):
+    msg = "version conflict: %r C extension module was built for another " \
+          "version of psutil" % getattr(_psplatform.cext, "__file__")
+    if hasattr(_psplatform.cext, 'version'):
+        msg += " (%s instead of %s)" % (
+            '.'.join([x for x in str(_psplatform.cext.version)]), __version__)
+    else:
+        msg += " (different than %s)" % __version__
+    msg += "; you may try to 'pip uninstall psutil', manually remove %s" % (
+        getattr(_psplatform.cext, "__file__",
+                "the existing psutil install directory"))
+    msg += " or clean the virtual env somehow, then reinstall"
+    raise ImportError(msg)
+
+
+# =====================================================================
+# --- Utils
+# =====================================================================
+
+
+if hasattr(_psplatform, 'ppid_map'):
+    # Faster version (Windows and Linux).
+    _ppid_map = _psplatform.ppid_map
+else:  # pragma: no cover
+    def _ppid_map():
+        """Return a {pid: ppid, ...} dict for all running processes in
+        one shot. Used to speed up Process.children().
+        """
+        ret = {}
+        for pid in pids():
+            try:
+                ret[pid] = _psplatform.Process(pid).ppid()
+            except (NoSuchProcess, ZombieProcess):
+                pass
+        return ret
+
+
+def _assert_pid_not_reused(fun):
+    """Decorator which raises NoSuchProcess in case a process is no
+    longer running or its PID has been reused.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        if not self.is_running():
+            raise NoSuchProcess(self.pid, self._name)
+        return fun(self, *args, **kwargs)
+    return wrapper
+
+
+def _pprint_secs(secs):
+    """Format seconds in a human readable form."""
+    now = time.time()
+    secs_ago = int(now - secs)
+    if secs_ago < 60 * 60 * 24:
+        fmt = "%H:%M:%S"
+    else:
+        fmt = "%Y-%m-%d %H:%M:%S"
+    return datetime.datetime.fromtimestamp(secs).strftime(fmt)
+
+
+# =====================================================================
+# --- Process class
+# =====================================================================
+
+
+class Process(object):
+    """Represents an OS process with the given PID.
+    If PID is omitted current process PID (os.getpid()) is used.
+    Raise NoSuchProcess if PID does not exist.
+
+    Note that most of the methods of this class do not make sure
+    the PID of the process being queried has been reused over time.
+    That means you might end up retrieving an information referring
+    to another process in case the original one this instance
+    refers to is gone in the meantime.
+
+    The only exceptions for which process identity is pre-emptively
+    checked and guaranteed are:
+
+     - parent()
+     - children()
+     - nice() (set)
+     - ionice() (set)
+     - rlimit() (set)
+     - cpu_affinity (set)
+     - suspend()
+     - resume()
+     - send_signal()
+     - terminate()
+     - kill()
+
+    To prevent this problem for all other methods you can:
+     - use is_running() before querying the process
+     - if you're continuously iterating over a set of Process
+       instances use process_iter() which pre-emptively checks
+     process identity for every yielded instance
+    """
+
+    def __init__(self, pid=None):
+        self._init(pid)
+
+    def _init(self, pid, _ignore_nsp=False):
+        if pid is None:
+            pid = os.getpid()
+        else:
+            if not _PY3 and not isinstance(pid, (int, long)):
+                raise TypeError('pid must be an integer (got %r)' % pid)
+            if pid < 0:
+                raise ValueError('pid must be a positive integer (got %s)'
+                                 % pid)
+        self._pid = pid
+        self._name = None
+        self._exe = None
+        self._create_time = None
+        self._gone = False
+        self._hash = None
+        self._lock = threading.RLock()
+        # used for caching on Windows only (on POSIX ppid may change)
+        self._ppid = None
+        # platform-specific modules define an _psplatform.Process
+        # implementation class
+        self._proc = _psplatform.Process(pid)
+        self._last_sys_cpu_times = None
+        self._last_proc_cpu_times = None
+        self._exitcode = _SENTINEL
+        # cache creation time for later use in is_running() method
+        try:
+            self.create_time()
+        except AccessDenied:
+            # We should never get here as AFAIK we're able to get
+            # process creation time on all platforms even as a
+            # limited user.
+            pass
+        except ZombieProcess:
+            # Zombies can still be queried by this class (although
+            # not always) and pids() return them so just go on.
+            pass
+        except NoSuchProcess:
+            if not _ignore_nsp:
+                msg = 'no process found with pid %s' % pid
+                raise NoSuchProcess(pid, None, msg)
+            else:
+                self._gone = True
+        # This pair is supposed to indentify a Process instance
+        # univocally over time (the PID alone is not enough as
+        # it might refer to a process whose PID has been reused).
+        # This will be used later in __eq__() and is_running().
+        self._ident = (self.pid, self._create_time)
+
+    def __str__(self):
+        try:
+            info = collections.OrderedDict()
+        except AttributeError:  # pragma: no cover
+            info = {}  # Python 2.6
+        info["pid"] = self.pid
+        if self._name:
+            info['name'] = self._name
+        with self.oneshot():
+            try:
+                info["name"] = self.name()
+                info["status"] = self.status()
+            except ZombieProcess:
+                info["status"] = "zombie"
+            except NoSuchProcess:
+                info["status"] = "terminated"
+            except AccessDenied:
+                pass
+            if self._exitcode not in (_SENTINEL, None):
+                info["exitcode"] = self._exitcode
+            if self._create_time:
+                info['started'] = _pprint_secs(self._create_time)
+            return "%s.%s(%s)" % (
+                self.__class__.__module__,
+                self.__class__.__name__,
+                ", ".join(["%s=%r" % (k, v) for k, v in info.items()]))
+
+    __repr__ = __str__
+
+    def __eq__(self, other):
+        # Test for equality with another Process object based
+        # on PID and creation time.
+        if not isinstance(other, Process):
+            return NotImplemented
+        return self._ident == other._ident
+
+    def __ne__(self, other):
+        return not self == other
+
+    def __hash__(self):
+        if self._hash is None:
+            self._hash = hash(self._ident)
+        return self._hash
+
+    @property
+    def pid(self):
+        """The process PID."""
+        return self._pid
+
+    # --- utility methods
+
+    @contextlib.contextmanager
+    def oneshot(self):
+        """Utility context manager which considerably speeds up the
+        retrieval of multiple process information at the same time.
+
+        Internally different process info (e.g. name, ppid, uids,
+        gids, ...) may be fetched by using the same routine, but
+        only one information is returned and the others are discarded.
+        When using this context manager the internal routine is
+        executed once (in the example below on name()) and the
+        other info are cached.
+
+        The cache is cleared when exiting the context manager block.
+        The advice is to use this every time you retrieve more than
+        one information about the process. If you're lucky, you'll
+        get a hell of a speedup.
+
+        >>> import psutil
+        >>> p = psutil.Process()
+        >>> with p.oneshot():
+        ...     p.name()  # collect multiple info
+        ...     p.cpu_times()  # return cached value
+        ...     p.cpu_percent()  # return cached value
+        ...     p.create_time()  # return cached value
+        ...
+        >>>
+        """
+        with self._lock:
+            if hasattr(self, "_cache"):
+                # NOOP: this covers the use case where the user enters the
+                # context twice:
+                #
+                # >>> with p.oneshot():
+                # ...    with p.oneshot():
+                # ...
+                #
+                # Also, since as_dict() internally uses oneshot()
+                # I expect that the code below will be a pretty common
+                # "mistake" that the user will make, so let's guard
+                # against that:
+                #
+                # >>> with p.oneshot():
+                # ...    p.as_dict()
+                # ...
+                yield
+            else:
+                try:
+                    # cached in case cpu_percent() is used
+                    self.cpu_times.cache_activate(self)
+                    # cached in case memory_percent() is used
+                    self.memory_info.cache_activate(self)
+                    # cached in case parent() is used
+                    self.ppid.cache_activate(self)
+                    # cached in case username() is used
+                    if POSIX:
+                        self.uids.cache_activate(self)
+                    # specific implementation cache
+                    self._proc.oneshot_enter()
+                    yield
+                finally:
+                    self.cpu_times.cache_deactivate(self)
+                    self.memory_info.cache_deactivate(self)
+                    self.ppid.cache_deactivate(self)
+                    if POSIX:
+                        self.uids.cache_deactivate(self)
+                    self._proc.oneshot_exit()
+
+    def as_dict(self, attrs=None, ad_value=None):
+        """Utility method returning process information as a
+        hashable dictionary.
+        If *attrs* is specified it must be a list of strings
+        reflecting available Process class' attribute names
+        (e.g. ['cpu_times', 'name']) else all public (read
+        only) attributes are assumed.
+        *ad_value* is the value which gets assigned in case
+        AccessDenied or ZombieProcess exception is raised when
+        retrieving that particular process information.
+        """
+        valid_names = _as_dict_attrnames
+        if attrs is not None:
+            if not isinstance(attrs, (list, tuple, set, frozenset)):
+                raise TypeError("invalid attrs type %s" % type(attrs))
+            attrs = set(attrs)
+            invalid_names = attrs - valid_names
+            if invalid_names:
+                raise ValueError("invalid attr name%s %s" % (
+                    "s" if len(invalid_names) > 1 else "",
+                    ", ".join(map(repr, invalid_names))))
+
+        retdict = dict()
+        ls = attrs or valid_names
+        with self.oneshot():
+            for name in ls:
+                try:
+                    if name == 'pid':
+                        ret = self.pid
+                    else:
+                        meth = getattr(self, name)
+                        ret = meth()
+                except (AccessDenied, ZombieProcess):
+                    ret = ad_value
+                except NotImplementedError:
+                    # in case of not implemented functionality (may happen
+                    # on old or exotic systems) we want to crash only if
+                    # the user explicitly asked for that particular attr
+                    if attrs:
+                        raise
+                    continue
+                retdict[name] = ret
+        return retdict
+
+    def parent(self):
+        """Return the parent process as a Process object pre-emptively
+        checking whether PID has been reused.
+        If no parent is known return None.
+        """
+        lowest_pid = _LOWEST_PID if _LOWEST_PID is not None else pids()[0]
+        if self.pid == lowest_pid:
+            return None
+        ppid = self.ppid()
+        if ppid is not None:
+            ctime = self.create_time()
+            try:
+                parent = Process(ppid)
+                if parent.create_time() <= ctime:
+                    return parent
+                # ...else ppid has been reused by another process
+            except NoSuchProcess:
+                pass
+
+    def parents(self):
+        """Return the parents of this process as a list of Process
+        instances. If no parents are known return an empty list.
+        """
+        parents = []
+        proc = self.parent()
+        while proc is not None:
+            parents.append(proc)
+            proc = proc.parent()
+        return parents
+
+    def is_running(self):
+        """Return whether this process is running.
+        It also checks if PID has been reused by another process in
+        which case return False.
+        """
+        if self._gone:
+            return False
+        try:
+            # Checking if PID is alive is not enough as the PID might
+            # have been reused by another process: we also want to
+            # verify process identity.
+            # Process identity / uniqueness over time is guaranteed by
+            # (PID + creation time) and that is verified in __eq__.
+            return self == Process(self.pid)
+        except ZombieProcess:
+            # We should never get here as it's already handled in
+            # Process.__init__; here just for extra safety.
+            return True
+        except NoSuchProcess:
+            self._gone = True
+            return False
+
+    # --- actual API
+
+    @memoize_when_activated
+    def ppid(self):
+        """The process parent PID.
+        On Windows the return value is cached after first call.
+        """
+        # On POSIX we don't want to cache the ppid as it may unexpectedly
+        # change to 1 (init) in case this process turns into a zombie:
+        # https://github.com/giampaolo/psutil/issues/321
+        # http://stackoverflow.com/questions/356722/
+
+        # XXX should we check creation time here rather than in
+        # Process.parent()?
+        if POSIX:
+            return self._proc.ppid()
+        else:  # pragma: no cover
+            self._ppid = self._ppid or self._proc.ppid()
+            return self._ppid
+
+    def name(self):
+        """The process name. The return value is cached after first call."""
+        # Process name is only cached on Windows as on POSIX it may
+        # change, see:
+        # https://github.com/giampaolo/psutil/issues/692
+        if WINDOWS and self._name is not None:
+            return self._name
+        name = self._proc.name()
+        if POSIX and len(name) >= 15:
+            # On UNIX the name gets truncated to the first 15 characters.
+            # If it matches the first part of the cmdline we return that
+            # one instead because it's usually more explicative.
+            # Examples are "gnome-keyring-d" vs. "gnome-keyring-daemon".
+            try:
+                cmdline = self.cmdline()
+            except AccessDenied:
+                pass
+            else:
+                if cmdline:
+                    extended_name = os.path.basename(cmdline[0])
+                    if extended_name.startswith(name):
+                        name = extended_name
+        self._name = name
+        self._proc._name = name
+        return name
+
+    def exe(self):
+        """The process executable as an absolute path.
+        May also be an empty string.
+        The return value is cached after first call.
+        """
+        def guess_it(fallback):
+            # try to guess exe from cmdline[0] in absence of a native
+            # exe representation
+            cmdline = self.cmdline()
+            if cmdline and hasattr(os, 'access') and hasattr(os, 'X_OK'):
+                exe = cmdline[0]  # the possible exe
+                # Attempt to guess only in case of an absolute path.
+                # It is not safe otherwise as the process might have
+                # changed cwd.
+                if (os.path.isabs(exe) and
+                        os.path.isfile(exe) and
+                        os.access(exe, os.X_OK)):
+                    return exe
+            if isinstance(fallback, AccessDenied):
+                raise fallback
+            return fallback
+
+        if self._exe is None:
+            try:
+                exe = self._proc.exe()
+            except AccessDenied as err:
+                return guess_it(fallback=err)
+            else:
+                if not exe:
+                    # underlying implementation can legitimately return an
+                    # empty string; if that's the case we don't want to
+                    # raise AD while guessing from the cmdline
+                    try:
+                        exe = guess_it(fallback=exe)
+                    except AccessDenied:
+                        pass
+                self._exe = exe
+        return self._exe
+
+    def cmdline(self):
+        """The command line this process has been called with."""
+        return self._proc.cmdline()
+
+    def status(self):
+        """The process current status as a STATUS_* constant."""
+        try:
+            return self._proc.status()
+        except ZombieProcess:
+            return STATUS_ZOMBIE
+
+    def username(self):
+        """The name of the user that owns the process.
+        On UNIX this is calculated by using *real* process uid.
+        """
+        if POSIX:
+            if pwd is None:
+                # might happen if python was installed from sources
+                raise ImportError(
+                    "requires pwd module shipped with standard python")
+            real_uid = self.uids().real
+            try:
+                return pwd.getpwuid(real_uid).pw_name
+            except KeyError:
+                # the uid can't be resolved by the system
+                return str(real_uid)
+        else:
+            return self._proc.username()
+
+    def create_time(self):
+        """The process creation time as a floating point number
+        expressed in seconds since the epoch, in UTC.
+        The return value is cached after first call.
+        """
+        if self._create_time is None:
+            self._create_time = self._proc.create_time()
+        return self._create_time
+
+    def cwd(self):
+        """Process current working directory as an absolute path."""
+        return self._proc.cwd()
+
+    def nice(self, value=None):
+        """Get or set process niceness (priority)."""
+        if value is None:
+            return self._proc.nice_get()
+        else:
+            if not self.is_running():
+                raise NoSuchProcess(self.pid, self._name)
+            self._proc.nice_set(value)
+
+    if POSIX:
+
+        @memoize_when_activated
+        def uids(self):
+            """Return process UIDs as a (real, effective, saved)
+            namedtuple.
+            """
+            return self._proc.uids()
+
+        def gids(self):
+            """Return process GIDs as a (real, effective, saved)
+            namedtuple.
+            """
+            return self._proc.gids()
+
+        def terminal(self):
+            """The terminal associated with this process, if any,
+            else None.
+            """
+            return self._proc.terminal()
+
+        def num_fds(self):
+            """Return the number of file descriptors opened by this
+            process (POSIX only).
+            """
+            return self._proc.num_fds()
+
+    # Linux, BSD, AIX and Windows only
+    if hasattr(_psplatform.Process, "io_counters"):
+
+        def io_counters(self):
+            """Return process I/O statistics as a
+            (read_count, write_count, read_bytes, write_bytes)
+            namedtuple.
+            Those are the number of read/write calls performed and the
+            amount of bytes read and written by the process.
+            """
+            return self._proc.io_counters()
+
+    # Linux and Windows
+    if hasattr(_psplatform.Process, "ionice_get"):
+
+        def ionice(self, ioclass=None, value=None):
+            """Get or set process I/O niceness (priority).
+
+            On Linux *ioclass* is one of the IOPRIO_CLASS_* constants.
+            *value* is a number which goes from 0 to 7. The higher the
+            value, the lower the I/O priority of the process.
+
+            On Windows only *ioclass* is used and it can be set to 2
+            (normal), 1 (low) or 0 (very low).
+
+            Available on Linux and Windows > Vista only.
+            """
+            if ioclass is None:
+                if value is not None:
+                    raise ValueError("'ioclass' argument must be specified")
+                return self._proc.ionice_get()
+            else:
+                return self._proc.ionice_set(ioclass, value)
+
+    # Linux / FreeBSD only
+    if hasattr(_psplatform.Process, "rlimit"):
+
+        def rlimit(self, resource, limits=None):
+            """Get or set process resource limits as a (soft, hard)
+            tuple.
+
+            *resource* is one of the RLIMIT_* constants.
+            *limits* is supposed to be a (soft, hard) tuple.
+
+            See "man prlimit" for further info.
+            Available on Linux and FreeBSD only.
+            """
+            return self._proc.rlimit(resource, limits)
+
+    # Windows, Linux and FreeBSD only
+    if hasattr(_psplatform.Process, "cpu_affinity_get"):
+
+        def cpu_affinity(self, cpus=None):
+            """Get or set process CPU affinity.
+            If specified, *cpus* must be a list of CPUs for which you
+            want to set the affinity (e.g. [0, 1]).
+            If an empty list is passed, all egible CPUs are assumed
+            (and set).
+            (Windows, Linux and BSD only).
+            """
+            if cpus is None:
+                return sorted(set(self._proc.cpu_affinity_get()))
+            else:
+                if not cpus:
+                    if hasattr(self._proc, "_get_eligible_cpus"):
+                        cpus = self._proc._get_eligible_cpus()
+                    else:
+                        cpus = tuple(range(len(cpu_times(percpu=True))))
+                self._proc.cpu_affinity_set(list(set(cpus)))
+
+    # Linux, FreeBSD, SunOS
+    if hasattr(_psplatform.Process, "cpu_num"):
+
+        def cpu_num(self):
+            """Return what CPU this process is currently running on.
+            The returned number should be <= psutil.cpu_count()
+            and <= len(psutil.cpu_percent(percpu=True)).
+            It may be used in conjunction with
+            psutil.cpu_percent(percpu=True) to observe the system
+            workload distributed across CPUs.
+            """
+            return self._proc.cpu_num()
+
+    # All platforms has it, but maybe not in the future.
+    if hasattr(_psplatform.Process, "environ"):
+
+        def environ(self):
+            """The environment variables of the process as a dict.  Note: this
+            might not reflect changes made after the process started.  """
+            return self._proc.environ()
+
+    if WINDOWS:
+
+        def num_handles(self):
+            """Return the number of handles opened by this process
+            (Windows only).
+            """
+            return self._proc.num_handles()
+
+    def num_ctx_switches(self):
+        """Return the number of voluntary and involuntary context
+        switches performed by this process.
+        """
+        return self._proc.num_ctx_switches()
+
+    def num_threads(self):
+        """Return the number of threads used by this process."""
+        return self._proc.num_threads()
+
+    if hasattr(_psplatform.Process, "threads"):
+
+        def threads(self):
+            """Return threads opened by process as a list of
+            (id, user_time, system_time) namedtuples representing
+            thread id and thread CPU times (user/system).
+            On OpenBSD this method requires root access.
+            """
+            return self._proc.threads()
+
+    @_assert_pid_not_reused
+    def children(self, recursive=False):
+        """Return the children of this process as a list of Process
+        instances, pre-emptively checking whether PID has been reused.
+        If *recursive* is True return all the parent descendants.
+
+        Example (A == this process):
+
+         A ─┐
+            │
+            ├─ B (child) ─┐
+            │             └─ X (grandchild) ─┐
+            │                                └─ Y (great grandchild)
+            ├─ C (child)
+            └─ D (child)
+
+        >>> import psutil
+        >>> p = psutil.Process()
+        >>> p.children()
+        B, C, D
+        >>> p.children(recursive=True)
+        B, X, Y, C, D
+
+        Note that in the example above if process X disappears
+        process Y won't be listed as the reference to process A
+        is lost.
+        """
+        ppid_map = _ppid_map()
+        ret = []
+        if not recursive:
+            for pid, ppid in ppid_map.items():
+                if ppid == self.pid:
+                    try:
+                        child = Process(pid)
+                        # if child happens to be older than its parent
+                        # (self) it means child's PID has been reused
+                        if self.create_time() <= child.create_time():
+                            ret.append(child)
+                    except (NoSuchProcess, ZombieProcess):
+                        pass
+        else:
+            # Construct a {pid: [child pids]} dict
+            reverse_ppid_map = collections.defaultdict(list)
+            for pid, ppid in ppid_map.items():
+                reverse_ppid_map[ppid].append(pid)
+            # Recursively traverse that dict, starting from self.pid,
+            # such that we only call Process() on actual children
+            seen = set()
+            stack = [self.pid]
+            while stack:
+                pid = stack.pop()
+                if pid in seen:
+                    # Since pids can be reused while the ppid_map is
+                    # constructed, there may be rare instances where
+                    # there's a cycle in the recorded process "tree".
+                    continue
+                seen.add(pid)
+                for child_pid in reverse_ppid_map[pid]:
+                    try:
+                        child = Process(child_pid)
+                        # if child happens to be older than its parent
+                        # (self) it means child's PID has been reused
+                        intime = self.create_time() <= child.create_time()
+                        if intime:
+                            ret.append(child)
+                            stack.append(child_pid)
+                    except (NoSuchProcess, ZombieProcess):
+                        pass
+        return ret
+
+    def cpu_percent(self, interval=None):
+        """Return a float representing the current process CPU
+        utilization as a percentage.
+
+        When *interval* is 0.0 or None (default) compares process times
+        to system CPU times elapsed since last call, returning
+        immediately (non-blocking). That means that the first time
+        this is called it will return a meaningful 0.0 value.
+
+        When *interval* is > 0.0 compares process times to system CPU
+        times elapsed before and after the interval (blocking).
+
+        In this case is recommended for accuracy that this function
+        be called with at least 0.1 seconds between calls.
+
+        A value > 100.0 can be returned in case of processes running
+        multiple threads on different CPU cores.
+
+        The returned value is explicitly NOT split evenly between
+        all available logical CPUs. This means that a busy loop process
+        running on a system with 2 logical CPUs will be reported as
+        having 100% CPU utilization instead of 50%.
+
+        Examples:
+
+          >>> import psutil
+          >>> p = psutil.Process(os.getpid())
+          >>> # blocking
+          >>> p.cpu_percent(interval=1)
+          2.0
+          >>> # non-blocking (percentage since last call)
+          >>> p.cpu_percent(interval=None)
+          2.9
+          >>>
+        """
+        blocking = interval is not None and interval > 0.0
+        if interval is not None and interval < 0:
+            raise ValueError("interval is not positive (got %r)" % interval)
+        num_cpus = cpu_count() or 1
+
+        def timer():
+            return _timer() * num_cpus
+
+        if blocking:
+            st1 = timer()
+            pt1 = self._proc.cpu_times()
+            time.sleep(interval)
+            st2 = timer()
+            pt2 = self._proc.cpu_times()
+        else:
+            st1 = self._last_sys_cpu_times
+            pt1 = self._last_proc_cpu_times
+            st2 = timer()
+            pt2 = self._proc.cpu_times()
+            if st1 is None or pt1 is None:
+                self._last_sys_cpu_times = st2
+                self._last_proc_cpu_times = pt2
+                return 0.0
+
+        delta_proc = (pt2.user - pt1.user) + (pt2.system - pt1.system)
+        delta_time = st2 - st1
+        # reset values for next call in case of interval == None
+        self._last_sys_cpu_times = st2
+        self._last_proc_cpu_times = pt2
+
+        try:
+            # This is the utilization split evenly between all CPUs.
+            # E.g. a busy loop process on a 2-CPU-cores system at this
+            # point is reported as 50% instead of 100%.
+            overall_cpus_percent = ((delta_proc / delta_time) * 100)
+        except ZeroDivisionError:
+            # interval was too low
+            return 0.0
+        else:
+            # Note 1:
+            # in order to emulate "top" we multiply the value for the num
+            # of CPU cores. This way the busy process will be reported as
+            # having 100% (or more) usage.
+            #
+            # Note 2:
+            # taskmgr.exe on Windows differs in that it will show 50%
+            # instead.
+            #
+            # Note 3:
+            # a percentage > 100 is legitimate as it can result from a
+            # process with multiple threads running on different CPU
+            # cores (top does the same), see:
+            # http://stackoverflow.com/questions/1032357
+            # https://github.com/giampaolo/psutil/issues/474
+            single_cpu_percent = overall_cpus_percent * num_cpus
+            return round(single_cpu_percent, 1)
+
+    @memoize_when_activated
+    def cpu_times(self):
+        """Return a (user, system, children_user, children_system)
+        namedtuple representing the accumulated process time, in
+        seconds.
+        This is similar to os.times() but per-process.
+        On macOS and Windows children_user and children_system are
+        always set to 0.
+        """
+        return self._proc.cpu_times()
+
+    @memoize_when_activated
+    def memory_info(self):
+        """Return a namedtuple with variable fields depending on the
+        platform, representing memory information about the process.
+
+        The "portable" fields available on all plaforms are `rss` and `vms`.
+
+        All numbers are expressed in bytes.
+        """
+        return self._proc.memory_info()
+
+    @_common.deprecated_method(replacement="memory_info")
+    def memory_info_ex(self):
+        return self.memory_info()
+
+    def memory_full_info(self):
+        """This method returns the same information as memory_info(),
+        plus, on some platform (Linux, macOS, Windows), also provides
+        additional metrics (USS, PSS and swap).
+        The additional metrics provide a better representation of actual
+        process memory usage.
+
+        Namely USS is the memory which is unique to a process and which
+        would be freed if the process was terminated right now.
+
+        It does so by passing through the whole process address.
+        As such it usually requires higher user privileges than
+        memory_info() and is considerably slower.
+        """
+        return self._proc.memory_full_info()
+
+    def memory_percent(self, memtype="rss"):
+        """Compare process memory to total physical system memory and
+        calculate process memory utilization as a percentage.
+        *memtype* argument is a string that dictates what type of
+        process memory you want to compare against (defaults to "rss").
+        The list of available strings can be obtained like this:
+
+        >>> psutil.Process().memory_info()._fields
+        ('rss', 'vms', 'shared', 'text', 'lib', 'data', 'dirty', 'uss', 'pss')
+        """
+        valid_types = list(_psplatform.pfullmem._fields)
+        if memtype not in valid_types:
+            raise ValueError("invalid memtype %r; valid types are %r" % (
+                memtype, tuple(valid_types)))
+        fun = self.memory_info if memtype in _psplatform.pmem._fields else \
+            self.memory_full_info
+        metrics = fun()
+        value = getattr(metrics, memtype)
+
+        # use cached value if available
+        total_phymem = _TOTAL_PHYMEM or virtual_memory().total
+        if not total_phymem > 0:
+            # we should never get here
+            raise ValueError(
+                "can't calculate process memory percent because "
+                "total physical system memory is not positive (%r)"
+                % total_phymem)
+        return (value / float(total_phymem)) * 100
+
+    if hasattr(_psplatform.Process, "memory_maps"):
+        def memory_maps(self, grouped=True):
+            """Return process' mapped memory regions as a list of namedtuples
+            whose fields are variable depending on the platform.
+
+            If *grouped* is True the mapped regions with the same 'path'
+            are grouped together and the different memory fields are summed.
+
+            If *grouped* is False every mapped region is shown as a single
+            entity and the namedtuple will also include the mapped region's
+            address space ('addr') and permission set ('perms').
+            """
+            it = self._proc.memory_maps()
+            if grouped:
+                d = {}
+                for tupl in it:
+                    path = tupl[2]
+                    nums = tupl[3:]
+                    try:
+                        d[path] = map(lambda x, y: x + y, d[path], nums)
+                    except KeyError:
+                        d[path] = nums
+                nt = _psplatform.pmmap_grouped
+                return [nt(path, *d[path]) for path in d]  # NOQA
+            else:
+                nt = _psplatform.pmmap_ext
+                return [nt(*x) for x in it]
+
+    def open_files(self):
+        """Return files opened by process as a list of
+        (path, fd) namedtuples including the absolute file name
+        and file descriptor number.
+        """
+        return self._proc.open_files()
+
+    def connections(self, kind='inet'):
+        """Return socket connections opened by process as a list of
+        (fd, family, type, laddr, raddr, status) namedtuples.
+        The *kind* parameter filters for connections that match the
+        following criteria:
+
+        +------------+----------------------------------------------------+
+        | Kind Value | Connections using                                  |
+        +------------+----------------------------------------------------+
+        | inet       | IPv4 and IPv6                                      |
+        | inet4      | IPv4                                               |
+        | inet6      | IPv6                                               |
+        | tcp        | TCP                                                |
+        | tcp4       | TCP over IPv4                                      |
+        | tcp6       | TCP over IPv6                                      |
+        | udp        | UDP                                                |
+        | udp4       | UDP over IPv4                                      |
+        | udp6       | UDP over IPv6                                      |
+        | unix       | UNIX socket (both UDP and TCP protocols)           |
+        | all        | the sum of all the possible families and protocols |
+        +------------+----------------------------------------------------+
+        """
+        return self._proc.connections(kind)
+
+    # --- signals
+
+    if POSIX:
+        def _send_signal(self, sig):
+            assert not self.pid < 0, self.pid
+            if self.pid == 0:
+                # see "man 2 kill"
+                raise ValueError(
+                    "preventing sending signal to process with PID 0 as it "
+                    "would affect every process in the process group of the "
+                    "calling process (os.getpid()) instead of PID 0")
+            try:
+                os.kill(self.pid, sig)
+            except ProcessLookupError:
+                if OPENBSD and pid_exists(self.pid):
+                    # We do this because os.kill() lies in case of
+                    # zombie processes.
+                    raise ZombieProcess(self.pid, self._name, self._ppid)
+                else:
+                    self._gone = True
+                    raise NoSuchProcess(self.pid, self._name)
+            except PermissionError:
+                raise AccessDenied(self.pid, self._name)
+
+    @_assert_pid_not_reused
+    def send_signal(self, sig):
+        """Send a signal *sig* to process pre-emptively checking
+        whether PID has been reused (see signal module constants) .
+        On Windows only SIGTERM is valid and is treated as an alias
+        for kill().
+        """
+        if POSIX:
+            self._send_signal(sig)
+        else:  # pragma: no cover
+            self._proc.send_signal(sig)
+
+    @_assert_pid_not_reused
+    def suspend(self):
+        """Suspend process execution with SIGSTOP pre-emptively checking
+        whether PID has been reused.
+        On Windows this has the effect ot suspending all process threads.
+        """
+        if POSIX:
+            self._send_signal(signal.SIGSTOP)
+        else:  # pragma: no cover
+            self._proc.suspend()
+
+    @_assert_pid_not_reused
+    def resume(self):
+        """Resume process execution with SIGCONT pre-emptively checking
+        whether PID has been reused.
+        On Windows this has the effect of resuming all process threads.
+        """
+        if POSIX:
+            self._send_signal(signal.SIGCONT)
+        else:  # pragma: no cover
+            self._proc.resume()
+
+    @_assert_pid_not_reused
+    def terminate(self):
+        """Terminate the process with SIGTERM pre-emptively checking
+        whether PID has been reused.
+        On Windows this is an alias for kill().
+        """
+        if POSIX:
+            self._send_signal(signal.SIGTERM)
+        else:  # pragma: no cover
+            self._proc.kill()
+
+    @_assert_pid_not_reused
+    def kill(self):
+        """Kill the current process with SIGKILL pre-emptively checking
+        whether PID has been reused.
+        """
+        if POSIX:
+            self._send_signal(signal.SIGKILL)
+        else:  # pragma: no cover
+            self._proc.kill()
+
+    def wait(self, timeout=None):
+        """Wait for process to terminate and, if process is a children
+        of os.getpid(), also return its exit code, else None.
+        On Windows there's no such limitation (exit code is always
+        returned).
+
+        If the process is already terminated immediately return None
+        instead of raising NoSuchProcess.
+
+        If *timeout* (in seconds) is specified and process is still
+        alive raise TimeoutExpired.
+
+        To wait for multiple Process(es) use psutil.wait_procs().
+        """
+        if timeout is not None and not timeout >= 0:
+            raise ValueError("timeout must be a positive integer")
+        if self._exitcode is not _SENTINEL:
+            return self._exitcode
+        self._exitcode = self._proc.wait(timeout)
+        return self._exitcode
+
+
+# The valid attr names which can be processed by Process.as_dict().
+_as_dict_attrnames = set(
+    [x for x in dir(Process) if not x.startswith('_') and x not in
+     ['send_signal', 'suspend', 'resume', 'terminate', 'kill', 'wait',
+      'is_running', 'as_dict', 'parent', 'parents', 'children', 'rlimit',
+      'memory_info_ex', 'oneshot']])
+
+
+# =====================================================================
+# --- Popen class
+# =====================================================================
+
+
+class Popen(Process):
+    """Same as subprocess.Popen, but in addition it provides all
+    psutil.Process methods in a single class.
+    For the following methods which are common to both classes, psutil
+    implementation takes precedence:
+
+    * send_signal()
+    * terminate()
+    * kill()
+
+    This is done in order to avoid killing another process in case its
+    PID has been reused, fixing BPO-6973.
+
+      >>> import psutil
+      >>> from subprocess import PIPE
+      >>> p = psutil.Popen(["python", "-c", "print 'hi'"], stdout=PIPE)
+      >>> p.name()
+      'python'
+      >>> p.uids()
+      user(real=1000, effective=1000, saved=1000)
+      >>> p.username()
+      'giampaolo'
+      >>> p.communicate()
+      ('hi\n', None)
+      >>> p.terminate()
+      >>> p.wait(timeout=2)
+      0
+      >>>
+    """
+
+    def __init__(self, *args, **kwargs):
+        # Explicitly avoid to raise NoSuchProcess in case the process
+        # spawned by subprocess.Popen terminates too quickly, see:
+        # https://github.com/giampaolo/psutil/issues/193
+        self.__subproc = subprocess.Popen(*args, **kwargs)
+        self._init(self.__subproc.pid, _ignore_nsp=True)
+
+    def __dir__(self):
+        return sorted(set(dir(Popen) + dir(subprocess.Popen)))
+
+    def __enter__(self):
+        if hasattr(self.__subproc, '__enter__'):
+            self.__subproc.__enter__()
+        return self
+
+    def __exit__(self, *args, **kwargs):
+        if hasattr(self.__subproc, '__exit__'):
+            return self.__subproc.__exit__(*args, **kwargs)
+        else:
+            if self.stdout:
+                self.stdout.close()
+            if self.stderr:
+                self.stderr.close()
+            try:
+                # Flushing a BufferedWriter may raise an error.
+                if self.stdin:
+                    self.stdin.close()
+            finally:
+                # Wait for the process to terminate, to avoid zombies.
+                self.wait()
+
+    def __getattribute__(self, name):
+        try:
+            return object.__getattribute__(self, name)
+        except AttributeError:
+            try:
+                return object.__getattribute__(self.__subproc, name)
+            except AttributeError:
+                raise AttributeError("%s instance has no attribute '%s'"
+                                     % (self.__class__.__name__, name))
+
+    def wait(self, timeout=None):
+        if self.__subproc.returncode is not None:
+            return self.__subproc.returncode
+        ret = super(Popen, self).wait(timeout)
+        self.__subproc.returncode = ret
+        return ret
+
+
+# =====================================================================
+# --- system processes related functions
+# =====================================================================
+
+
+def pids():
+    """Return a list of current running PIDs."""
+    global _LOWEST_PID
+    ret = sorted(_psplatform.pids())
+    _LOWEST_PID = ret[0]
+    return ret
+
+
+def pid_exists(pid):
+    """Return True if given PID exists in the current process list.
+    This is faster than doing "pid in psutil.pids()" and
+    should be preferred.
+    """
+    if pid < 0:
+        return False
+    elif pid == 0 and POSIX:
+        # On POSIX we use os.kill() to determine PID existence.
+        # According to "man 2 kill" PID 0 has a special meaning
+        # though: it refers to <<every process in the process
+        # group of the calling process>> and that is not we want
+        # to do here.
+        return pid in pids()
+    else:
+        return _psplatform.pid_exists(pid)
+
+
+_pmap = {}
+_lock = threading.Lock()
+
+
+def process_iter(attrs=None, ad_value=None):
+    """Return a generator yielding a Process instance for all
+    running processes.
+
+    Every new Process instance is only created once and then cached
+    into an internal table which is updated every time this is used.
+
+    Cached Process instances are checked for identity so that you're
+    safe in case a PID has been reused by another process, in which
+    case the cached instance is updated.
+
+    The sorting order in which processes are yielded is based on
+    their PIDs.
+
+    *attrs* and *ad_value* have the same meaning as in
+    Process.as_dict(). If *attrs* is specified as_dict() is called
+    and the resulting dict is stored as a 'info' attribute attached
+    to returned Process instance.
+    If *attrs* is an empty list it will retrieve all process info
+    (slow).
+    """
+    def add(pid):
+        proc = Process(pid)
+        if attrs is not None:
+            proc.info = proc.as_dict(attrs=attrs, ad_value=ad_value)
+        with _lock:
+            _pmap[proc.pid] = proc
+        return proc
+
+    def remove(pid):
+        with _lock:
+            _pmap.pop(pid, None)
+
+    a = set(pids())
+    b = set(_pmap.keys())
+    new_pids = a - b
+    gone_pids = b - a
+    for pid in gone_pids:
+        remove(pid)
+
+    with _lock:
+        ls = sorted(list(_pmap.items()) +
+                    list(dict.fromkeys(new_pids).items()))
+
+    for pid, proc in ls:
+        try:
+            if proc is None:  # new process
+                yield add(pid)
+            else:
+                # use is_running() to check whether PID has been reused by
+                # another process in which case yield a new Process instance
+                if proc.is_running():
+                    if attrs is not None:
+                        proc.info = proc.as_dict(
+                            attrs=attrs, ad_value=ad_value)
+                    yield proc
+                else:
+                    yield add(pid)
+        except NoSuchProcess:
+            remove(pid)
+        except AccessDenied:
+            # Process creation time can't be determined hence there's
+            # no way to tell whether the pid of the cached process
+            # has been reused. Just return the cached version.
+            if proc is None and pid in _pmap:
+                try:
+                    yield _pmap[pid]
+                except KeyError:
+                    # If we get here it is likely that 2 threads were
+                    # using process_iter().
+                    pass
+            else:
+                raise
+
+
+def wait_procs(procs, timeout=None, callback=None):
+    """Convenience function which waits for a list of processes to
+    terminate.
+
+    Return a (gone, alive) tuple indicating which processes
+    are gone and which ones are still alive.
+
+    The gone ones will have a new *returncode* attribute indicating
+    process exit status (may be None).
+
+    *callback* is a function which gets called every time a process
+    terminates (a Process instance is passed as callback argument).
+
+    Function will return as soon as all processes terminate or when
+    *timeout* occurs.
+    Differently from Process.wait() it will not raise TimeoutExpired if
+    *timeout* occurs.
+
+    Typical use case is:
+
+     - send SIGTERM to a list of processes
+     - give them some time to terminate
+     - send SIGKILL to those ones which are still alive
+
+    Example:
+
+    >>> def on_terminate(proc):
+    ...     print("process {} terminated".format(proc))
+    ...
+    >>> for p in procs:
+    ...    p.terminate()
+    ...
+    >>> gone, alive = wait_procs(procs, timeout=3, callback=on_terminate)
+    >>> for p in alive:
+    ...     p.kill()
+    """
+    def check_gone(proc, timeout):
+        try:
+            returncode = proc.wait(timeout=timeout)
+        except TimeoutExpired:
+            pass
+        else:
+            if returncode is not None or not proc.is_running():
+                # Set new Process instance attribute.
+                proc.returncode = returncode
+                gone.add(proc)
+                if callback is not None:
+                    callback(proc)
+
+    if timeout is not None and not timeout >= 0:
+        msg = "timeout must be a positive integer, got %s" % timeout
+        raise ValueError(msg)
+    gone = set()
+    alive = set(procs)
+    if callback is not None and not callable(callback):
+        raise TypeError("callback %r is not a callable" % callable)
+    if timeout is not None:
+        deadline = _timer() + timeout
+
+    while alive:
+        if timeout is not None and timeout <= 0:
+            break
+        for proc in alive:
+            # Make sure that every complete iteration (all processes)
+            # will last max 1 sec.
+            # We do this because we don't want to wait too long on a
+            # single process: in case it terminates too late other
+            # processes may disappear in the meantime and their PID
+            # reused.
+            max_timeout = 1.0 / len(alive)
+            if timeout is not None:
+                timeout = min((deadline - _timer()), max_timeout)
+                if timeout <= 0:
+                    break
+                check_gone(proc, timeout)
+            else:
+                check_gone(proc, max_timeout)
+        alive = alive - gone
+
+    if alive:
+        # Last attempt over processes survived so far.
+        # timeout == 0 won't make this function wait any further.
+        for proc in alive:
+            check_gone(proc, 0)
+        alive = alive - gone
+
+    return (list(gone), list(alive))
+
+
+# =====================================================================
+# --- CPU related functions
+# =====================================================================
+
+
+def cpu_count(logical=True):
+    """Return the number of logical CPUs in the system (same as
+    os.cpu_count() in Python 3.4).
+
+    If *logical* is False return the number of physical cores only
+    (e.g. hyper thread CPUs are excluded).
+
+    Return None if undetermined.
+
+    The return value is cached after first call.
+    If desired cache can be cleared like this:
+
+    >>> psutil.cpu_count.cache_clear()
+    """
+    if logical:
+        ret = _psplatform.cpu_count_logical()
+    else:
+        ret = _psplatform.cpu_count_physical()
+    if ret is not None and ret < 1:
+        ret = None
+    return ret
+
+
+def cpu_times(percpu=False):
+    """Return system-wide CPU times as a namedtuple.
+    Every CPU time represents the seconds the CPU has spent in the
+    given mode. The namedtuple's fields availability varies depending on the
+    platform:
+
+     - user
+     - system
+     - idle
+     - nice (UNIX)
+     - iowait (Linux)
+     - irq (Linux, FreeBSD)
+     - softirq (Linux)
+     - steal (Linux >= 2.6.11)
+     - guest (Linux >= 2.6.24)
+     - guest_nice (Linux >= 3.2.0)
+
+    When *percpu* is True return a list of namedtuples for each CPU.
+    First element of the list refers to first CPU, second element
+    to second CPU and so on.
+    The order of the list is consistent across calls.
+    """
+    if not percpu:
+        return _psplatform.cpu_times()
+    else:
+        return _psplatform.per_cpu_times()
+
+
+try:
+    _last_cpu_times = cpu_times()
+except Exception:
+    # Don't want to crash at import time.
+    _last_cpu_times = None
+
+try:
+    _last_per_cpu_times = cpu_times(percpu=True)
+except Exception:
+    # Don't want to crash at import time.
+    _last_per_cpu_times = None
+
+
+def _cpu_tot_time(times):
+    """Given a cpu_time() ntuple calculates the total CPU time
+    (including idle time).
+    """
+    tot = sum(times)
+    if LINUX:
+        # On Linux guest times are already accounted in "user" or
+        # "nice" times, so we subtract them from total.
+        # Htop does the same. References:
+        # https://github.com/giampaolo/psutil/pull/940
+        # http://unix.stackexchange.com/questions/178045
+        # https://github.com/torvalds/linux/blob/
+        #     447976ef4fd09b1be88b316d1a81553f1aa7cd07/kernel/sched/
+        #     cputime.c#L158
+        tot -= getattr(times, "guest", 0)  # Linux 2.6.24+
+        tot -= getattr(times, "guest_nice", 0)  # Linux 3.2.0+
+    return tot
+
+
+def _cpu_busy_time(times):
+    """Given a cpu_time() ntuple calculates the busy CPU time.
+    We do so by subtracting all idle CPU times.
+    """
+    busy = _cpu_tot_time(times)
+    busy -= times.idle
+    # Linux: "iowait" is time during which the CPU does not do anything
+    # (waits for IO to complete). On Linux IO wait is *not* accounted
+    # in "idle" time so we subtract it. Htop does the same.
+    # References:
+    # https://github.com/torvalds/linux/blob/
+    #     447976ef4fd09b1be88b316d1a81553f1aa7cd07/kernel/sched/cputime.c#L244
+    busy -= getattr(times, "iowait", 0)
+    return busy
+
+
+def _cpu_times_deltas(t1, t2):
+    assert t1._fields == t2._fields, (t1, t2)
+    field_deltas = []
+    for field in _psplatform.scputimes._fields:
+        field_delta = getattr(t2, field) - getattr(t1, field)
+        # CPU times are always supposed to increase over time
+        # or at least remain the same and that's because time
+        # cannot go backwards.
+        # Surprisingly sometimes this might not be the case (at
+        # least on Windows and Linux), see:
+        # https://github.com/giampaolo/psutil/issues/392
+        # https://github.com/giampaolo/psutil/issues/645
+        # https://github.com/giampaolo/psutil/issues/1210
+        # Trim negative deltas to zero to ignore decreasing fields.
+        # top does the same. Reference:
+        # https://gitlab.com/procps-ng/procps/blob/v3.3.12/top/top.c#L5063
+        field_delta = max(0, field_delta)
+        field_deltas.append(field_delta)
+    return _psplatform.scputimes(*field_deltas)
+
+
+def cpu_percent(interval=None, percpu=False):
+    """Return a float representing the current system-wide CPU
+    utilization as a percentage.
+
+    When *interval* is > 0.0 compares system CPU times elapsed before
+    and after the interval (blocking).
+
+    When *interval* is 0.0 or None compares system CPU times elapsed
+    since last call or module import, returning immediately (non
+    blocking). That means the first time this is called it will
+    return a meaningless 0.0 value which you should ignore.
+    In this case is recommended for accuracy that this function be
+    called with at least 0.1 seconds between calls.
+
+    When *percpu* is True returns a list of floats representing the
+    utilization as a percentage for each CPU.
+    First element of the list refers to first CPU, second element
+    to second CPU and so on.
+    The order of the list is consistent across calls.
+
+    Examples:
+
+      >>> # blocking, system-wide
+      >>> psutil.cpu_percent(interval=1)
+      2.0
+      >>>
+      >>> # blocking, per-cpu
+      >>> psutil.cpu_percent(interval=1, percpu=True)
+      [2.0, 1.0]
+      >>>
+      >>> # non-blocking (percentage since last call)
+      >>> psutil.cpu_percent(interval=None)
+      2.9
+      >>>
+    """
+    global _last_cpu_times
+    global _last_per_cpu_times
+    blocking = interval is not None and interval > 0.0
+    if interval is not None and interval < 0:
+        raise ValueError("interval is not positive (got %r)" % interval)
+
+    def calculate(t1, t2):
+        times_delta = _cpu_times_deltas(t1, t2)
+
+        all_delta = _cpu_tot_time(times_delta)
+        busy_delta = _cpu_busy_time(times_delta)
+
+        try:
+            busy_perc = (busy_delta / all_delta) * 100
+        except ZeroDivisionError:
+            return 0.0
+        else:
+            return round(busy_perc, 1)
+
+    # system-wide usage
+    if not percpu:
+        if blocking:
+            t1 = cpu_times()
+            time.sleep(interval)
+        else:
+            t1 = _last_cpu_times
+            if t1 is None:
+                # Something bad happened at import time. We'll
+                # get a meaningful result on the next call. See:
+                # https://github.com/giampaolo/psutil/pull/715
+                t1 = cpu_times()
+        _last_cpu_times = cpu_times()
+        return calculate(t1, _last_cpu_times)
+    # per-cpu usage
+    else:
+        ret = []
+        if blocking:
+            tot1 = cpu_times(percpu=True)
+            time.sleep(interval)
+        else:
+            tot1 = _last_per_cpu_times
+            if tot1 is None:
+                # Something bad happened at import time. We'll
+                # get a meaningful result on the next call. See:
+                # https://github.com/giampaolo/psutil/pull/715
+                tot1 = cpu_times(percpu=True)
+        _last_per_cpu_times = cpu_times(percpu=True)
+        for t1, t2 in zip(tot1, _last_per_cpu_times):
+            ret.append(calculate(t1, t2))
+        return ret
+
+
+# Use separate global vars for cpu_times_percent() so that it's
+# independent from cpu_percent() and they can both be used within
+# the same program.
+_last_cpu_times_2 = _last_cpu_times
+_last_per_cpu_times_2 = _last_per_cpu_times
+
+
+def cpu_times_percent(interval=None, percpu=False):
+    """Same as cpu_percent() but provides utilization percentages
+    for each specific CPU time as is returned by cpu_times().
+    For instance, on Linux we'll get:
+
+      >>> cpu_times_percent()
+      cpupercent(user=4.8, nice=0.0, system=4.8, idle=90.5, iowait=0.0,
+                 irq=0.0, softirq=0.0, steal=0.0, guest=0.0, guest_nice=0.0)
+      >>>
+
+    *interval* and *percpu* arguments have the same meaning as in
+    cpu_percent().
+    """
+    global _last_cpu_times_2
+    global _last_per_cpu_times_2
+    blocking = interval is not None and interval > 0.0
+    if interval is not None and interval < 0:
+        raise ValueError("interval is not positive (got %r)" % interval)
+
+    def calculate(t1, t2):
+        nums = []
+        times_delta = _cpu_times_deltas(t1, t2)
+        all_delta = _cpu_tot_time(times_delta)
+        # "scale" is the value to multiply each delta with to get percentages.
+        # We use "max" to avoid division by zero (if all_delta is 0, then all
+        # fields are 0 so percentages will be 0 too. all_delta cannot be a
+        # fraction because cpu times are integers)
+        scale = 100.0 / max(1, all_delta)
+        for field_delta in times_delta:
+            field_perc = field_delta * scale
+            field_perc = round(field_perc, 1)
+            # make sure we don't return negative values or values over 100%
+            field_perc = min(max(0.0, field_perc), 100.0)
+            nums.append(field_perc)
+        return _psplatform.scputimes(*nums)
+
+    # system-wide usage
+    if not percpu:
+        if blocking:
+            t1 = cpu_times()
+            time.sleep(interval)
+        else:
+            t1 = _last_cpu_times_2
+            if t1 is None:
+                # Something bad happened at import time. We'll
+                # get a meaningful result on the next call. See:
+                # https://github.com/giampaolo/psutil/pull/715
+                t1 = cpu_times()
+        _last_cpu_times_2 = cpu_times()
+        return calculate(t1, _last_cpu_times_2)
+    # per-cpu usage
+    else:
+        ret = []
+        if blocking:
+            tot1 = cpu_times(percpu=True)
+            time.sleep(interval)
+        else:
+            tot1 = _last_per_cpu_times_2
+            if tot1 is None:
+                # Something bad happened at import time. We'll
+                # get a meaningful result on the next call. See:
+                # https://github.com/giampaolo/psutil/pull/715
+                tot1 = cpu_times(percpu=True)
+        _last_per_cpu_times_2 = cpu_times(percpu=True)
+        for t1, t2 in zip(tot1, _last_per_cpu_times_2):
+            ret.append(calculate(t1, t2))
+        return ret
+
+
+def cpu_stats():
+    """Return CPU statistics."""
+    return _psplatform.cpu_stats()
+
+
+if hasattr(_psplatform, "cpu_freq"):
+
+    def cpu_freq(percpu=False):
+        """Return CPU frequency as a nameduple including current,
+        min and max frequency expressed in Mhz.
+
+        If *percpu* is True and the system supports per-cpu frequency
+        retrieval (Linux only) a list of frequencies is returned for
+        each CPU. If not a list with one element is returned.
+        """
+        ret = _psplatform.cpu_freq()
+        if percpu:
+            return ret
+        else:
+            num_cpus = float(len(ret))
+            if num_cpus == 0:
+                return None
+            elif num_cpus == 1:
+                return ret[0]
+            else:
+                currs, mins, maxs = 0.0, 0.0, 0.0
+                set_none = False
+                for cpu in ret:
+                    currs += cpu.current
+                    # On Linux if /proc/cpuinfo is used min/max are set
+                    # to None.
+                    if LINUX and cpu.min is None:
+                        set_none = True
+                        continue
+                    mins += cpu.min
+                    maxs += cpu.max
+
+                current = currs / num_cpus
+
+                if set_none:
+                    min_ = max_ = None
+                else:
+                    min_ = mins / num_cpus
+                    max_ = maxs / num_cpus
+
+                return _common.scpufreq(current, min_, max_)
+
+    __all__.append("cpu_freq")
+
+
+if hasattr(os, "getloadavg") or hasattr(_psplatform, "getloadavg"):
+    # Perform this hasattr check once on import time to either use the
+    # platform based code or proxy straight from the os module.
+    if hasattr(os, "getloadavg"):
+        getloadavg = os.getloadavg
+    else:
+        getloadavg = _psplatform.getloadavg
+
+    __all__.append("getloadavg")
+
+
+# =====================================================================
+# --- system memory related functions
+# =====================================================================
+
+
+def virtual_memory():
+    """Return statistics about system memory usage as a namedtuple
+    including the following fields, expressed in bytes:
+
+     - total:
+       total physical memory available.
+
+     - available:
+       the memory that can be given instantly to processes without the
+       system going into swap.
+       This is calculated by summing different memory values depending
+       on the platform and it is supposed to be used to monitor actual
+       memory usage in a cross platform fashion.
+
+     - percent:
+       the percentage usage calculated as (total - available) / total * 100
+
+     - used:
+        memory used, calculated differently depending on the platform and
+        designed for informational purposes only:
+        macOS: active + wired
+        BSD: active + wired + cached
+        Linux: total - free
+
+     - free:
+       memory not being used at all (zeroed) that is readily available;
+       note that this doesn't reflect the actual memory available
+       (use 'available' instead)
+
+    Platform-specific fields:
+
+     - active (UNIX):
+       memory currently in use or very recently used, and so it is in RAM.
+
+     - inactive (UNIX):
+       memory that is marked as not used.
+
+     - buffers (BSD, Linux):
+       cache for things like file system metadata.
+
+     - cached (BSD, macOS):
+       cache for various things.
+
+     - wired (macOS, BSD):
+       memory that is marked to always stay in RAM. It is never moved to disk.
+
+     - shared (BSD):
+       memory that may be simultaneously accessed by multiple processes.
+
+    The sum of 'used' and 'available' does not necessarily equal total.
+    On Windows 'available' and 'free' are the same.
+    """
+    global _TOTAL_PHYMEM
+    ret = _psplatform.virtual_memory()
+    # cached for later use in Process.memory_percent()
+    _TOTAL_PHYMEM = ret.total
+    return ret
+
+
+def swap_memory():
+    """Return system swap memory statistics as a namedtuple including
+    the following fields:
+
+     - total:   total swap memory in bytes
+     - used:    used swap memory in bytes
+     - free:    free swap memory in bytes
+     - percent: the percentage usage
+     - sin:     no. of bytes the system has swapped in from disk (cumulative)
+     - sout:    no. of bytes the system has swapped out from disk (cumulative)
+
+    'sin' and 'sout' on Windows are meaningless and always set to 0.
+    """
+    return _psplatform.swap_memory()
+
+
+# =====================================================================
+# --- disks/paritions related functions
+# =====================================================================
+
+
+def disk_usage(path):
+    """Return disk usage statistics about the given *path* as a
+    namedtuple including total, used and free space expressed in bytes
+    plus the percentage usage.
+    """
+    return _psplatform.disk_usage(path)
+
+
+def disk_partitions(all=False):
+    """Return mounted partitions as a list of
+    (device, mountpoint, fstype, opts) namedtuple.
+    'opts' field is a raw string separated by commas indicating mount
+    options which may vary depending on the platform.
+
+    If *all* parameter is False return physical devices only and ignore
+    all others.
+    """
+    return _psplatform.disk_partitions(all)
+
+
+def disk_io_counters(perdisk=False, nowrap=True):
+    """Return system disk I/O statistics as a namedtuple including
+    the following fields:
+
+     - read_count:  number of reads
+     - write_count: number of writes
+     - read_bytes:  number of bytes read
+     - write_bytes: number of bytes written
+     - read_time:   time spent reading from disk (in ms)
+     - write_time:  time spent writing to disk (in ms)
+
+    Platform specific:
+
+     - busy_time: (Linux, FreeBSD) time spent doing actual I/Os (in ms)
+     - read_merged_count (Linux): number of merged reads
+     - write_merged_count (Linux): number of merged writes
+
+    If *perdisk* is True return the same information for every
+    physical disk installed on the system as a dictionary
+    with partition names as the keys and the namedtuple
+    described above as the values.
+
+    If *nowrap* is True it detects and adjust the numbers which overflow
+    and wrap (restart from 0) and add "old value" to "new value" so that
+    the returned numbers will always be increasing or remain the same,
+    but never decrease.
+    "disk_io_counters.cache_clear()" can be used to invalidate the
+    cache.
+
+    On recent Windows versions 'diskperf -y' command may need to be
+    executed first otherwise this function won't find any disk.
+    """
+    kwargs = dict(perdisk=perdisk) if LINUX else {}
+    rawdict = _psplatform.disk_io_counters(**kwargs)
+    if not rawdict:
+        return {} if perdisk else None
+    if nowrap:
+        rawdict = _wrap_numbers(rawdict, 'psutil.disk_io_counters')
+    nt = getattr(_psplatform, "sdiskio", _common.sdiskio)
+    if perdisk:
+        for disk, fields in rawdict.items():
+            rawdict[disk] = nt(*fields)
+        return rawdict
+    else:
+        return nt(*[sum(x) for x in zip(*rawdict.values())])
+
+
+disk_io_counters.cache_clear = functools.partial(
+    _wrap_numbers.cache_clear, 'psutil.disk_io_counters')
+disk_io_counters.cache_clear.__doc__ = "Clears nowrap argument cache"
+
+
+# =====================================================================
+# --- network related functions
+# =====================================================================
+
+
+def net_io_counters(pernic=False, nowrap=True):
+    """Return network I/O statistics as a namedtuple including
+    the following fields:
+
+     - bytes_sent:   number of bytes sent
+     - bytes_recv:   number of bytes received
+     - packets_sent: number of packets sent
+     - packets_recv: number of packets received
+     - errin:        total number of errors while receiving
+     - errout:       total number of errors while sending
+     - dropin:       total number of incoming packets which were dropped
+     - dropout:      total number of outgoing packets which were dropped
+                     (always 0 on macOS and BSD)
+
+    If *pernic* is True return the same information for every
+    network interface installed on the system as a dictionary
+    with network interface names as the keys and the namedtuple
+    described above as the values.
+
+    If *nowrap* is True it detects and adjust the numbers which overflow
+    and wrap (restart from 0) and add "old value" to "new value" so that
+    the returned numbers will always be increasing or remain the same,
+    but never decrease.
+    "disk_io_counters.cache_clear()" can be used to invalidate the
+    cache.
+    """
+    rawdict = _psplatform.net_io_counters()
+    if not rawdict:
+        return {} if pernic else None
+    if nowrap:
+        rawdict = _wrap_numbers(rawdict, 'psutil.net_io_counters')
+    if pernic:
+        for nic, fields in rawdict.items():
+            rawdict[nic] = _common.snetio(*fields)
+        return rawdict
+    else:
+        return _common.snetio(*[sum(x) for x in zip(*rawdict.values())])
+
+
+net_io_counters.cache_clear = functools.partial(
+    _wrap_numbers.cache_clear, 'psutil.net_io_counters')
+net_io_counters.cache_clear.__doc__ = "Clears nowrap argument cache"
+
+
+def net_connections(kind='inet'):
+    """Return system-wide socket connections as a list of
+    (fd, family, type, laddr, raddr, status, pid) namedtuples.
+    In case of limited privileges 'fd' and 'pid' may be set to -1
+    and None respectively.
+    The *kind* parameter filters for connections that fit the
+    following criteria:
+
+    +------------+----------------------------------------------------+
+    | Kind Value | Connections using                                  |
+    +------------+----------------------------------------------------+
+    | inet       | IPv4 and IPv6                                      |
+    | inet4      | IPv4                                               |
+    | inet6      | IPv6                                               |
+    | tcp        | TCP                                                |
+    | tcp4       | TCP over IPv4                                      |
+    | tcp6       | TCP over IPv6                                      |
+    | udp        | UDP                                                |
+    | udp4       | UDP over IPv4                                      |
+    | udp6       | UDP over IPv6                                      |
+    | unix       | UNIX socket (both UDP and TCP protocols)           |
+    | all        | the sum of all the possible families and protocols |
+    +------------+----------------------------------------------------+
+
+    On macOS this function requires root privileges.
+    """
+    return _psplatform.net_connections(kind)
+
+
+def net_if_addrs():
+    """Return the addresses associated to each NIC (network interface
+    card) installed on the system as a dictionary whose keys are the
+    NIC names and value is a list of namedtuples for each address
+    assigned to the NIC. Each namedtuple includes 5 fields:
+
+     - family: can be either socket.AF_INET, socket.AF_INET6 or
+               psutil.AF_LINK, which refers to a MAC address.
+     - address: is the primary address and it is always set.
+     - netmask: and 'broadcast' and 'ptp' may be None.
+     - ptp: stands for "point to point" and references the
+            destination address on a point to point interface
+            (typically a VPN).
+     - broadcast: and *ptp* are mutually exclusive.
+
+    Note: you can have more than one address of the same family
+    associated with each interface.
+    """
+    has_enums = sys.version_info >= (3, 4)
+    if has_enums:
+        import socket
+    rawlist = _psplatform.net_if_addrs()
+    rawlist.sort(key=lambda x: x[1])  # sort by family
+    ret = collections.defaultdict(list)
+    for name, fam, addr, mask, broadcast, ptp in rawlist:
+        if has_enums:
+            try:
+                fam = socket.AddressFamily(fam)
+            except ValueError:
+                if WINDOWS and fam == -1:
+                    fam = _psplatform.AF_LINK
+                elif (hasattr(_psplatform, "AF_LINK") and
+                        _psplatform.AF_LINK == fam):
+                    # Linux defines AF_LINK as an alias for AF_PACKET.
+                    # We re-set the family here so that repr(family)
+                    # will show AF_LINK rather than AF_PACKET
+                    fam = _psplatform.AF_LINK
+        if fam == _psplatform.AF_LINK:
+            # The underlying C function may return an incomplete MAC
+            # address in which case we fill it with null bytes, see:
+            # https://github.com/giampaolo/psutil/issues/786
+            separator = ":" if POSIX else "-"
+            while addr.count(separator) < 5:
+                addr += "%s00" % separator
+        ret[name].append(_common.snicaddr(fam, addr, mask, broadcast, ptp))
+    return dict(ret)
+
+
+def net_if_stats():
+    """Return information about each NIC (network interface card)
+    installed on the system as a dictionary whose keys are the
+    NIC names and value is a namedtuple with the following fields:
+
+     - isup: whether the interface is up (bool)
+     - duplex: can be either NIC_DUPLEX_FULL, NIC_DUPLEX_HALF or
+               NIC_DUPLEX_UNKNOWN
+     - speed: the NIC speed expressed in mega bits (MB); if it can't
+              be determined (e.g. 'localhost') it will be set to 0.
+     - mtu: the maximum transmission unit expressed in bytes.
+    """
+    return _psplatform.net_if_stats()
+
+
+# =====================================================================
+# --- sensors
+# =====================================================================
+
+
+# Linux, macOS
+if hasattr(_psplatform, "sensors_temperatures"):
+
+    def sensors_temperatures(fahrenheit=False):
+        """Return hardware temperatures. Each entry is a namedtuple
+        representing a certain hardware sensor (it may be a CPU, an
+        hard disk or something else, depending on the OS and its
+        configuration).
+        All temperatures are expressed in celsius unless *fahrenheit*
+        is set to True.
+        """
+        def convert(n):
+            if n is not None:
+                return (float(n) * 9 / 5) + 32 if fahrenheit else n
+
+        ret = collections.defaultdict(list)
+        rawdict = _psplatform.sensors_temperatures()
+
+        for name, values in rawdict.items():
+            while values:
+                label, current, high, critical = values.pop(0)
+                current = convert(current)
+                high = convert(high)
+                critical = convert(critical)
+
+                if high and not critical:
+                    critical = high
+                elif critical and not high:
+                    high = critical
+
+                ret[name].append(
+                    _common.shwtemp(label, current, high, critical))
+
+        return dict(ret)
+
+    __all__.append("sensors_temperatures")
+
+
+# Linux
+if hasattr(_psplatform, "sensors_fans"):
+
+    def sensors_fans():
+        """Return fans speed. Each entry is a namedtuple
+        representing a certain hardware sensor.
+        All speed are expressed in RPM (rounds per minute).
+        """
+        return _psplatform.sensors_fans()
+
+    __all__.append("sensors_fans")
+
+
+# Linux, Windows, FreeBSD, macOS
+if hasattr(_psplatform, "sensors_battery"):
+
+    def sensors_battery():
+        """Return battery information. If no battery is installed
+        returns None.
+
+         - percent: battery power left as a percentage.
+         - secsleft: a rough approximation of how many seconds are left
+                     before the battery runs out of power. May be
+                     POWER_TIME_UNLIMITED or POWER_TIME_UNLIMITED.
+         - power_plugged: True if the AC power cable is connected.
+        """
+        return _psplatform.sensors_battery()
+
+    __all__.append("sensors_battery")
+
+
+# =====================================================================
+# --- other system related functions
+# =====================================================================
+
+
+def boot_time():
+    """Return the system boot time expressed in seconds since the epoch."""
+    # Note: we are not caching this because it is subject to
+    # system clock updates.
+    return _psplatform.boot_time()
+
+
+def users():
+    """Return users currently connected on the system as a list of
+    namedtuples including the following fields.
+
+     - user: the name of the user
+     - terminal: the tty or pseudo-tty associated with the user, if any.
+     - host: the host name associated with the entry, if any.
+     - started: the creation time as a floating point number expressed in
+       seconds since the epoch.
+    """
+    return _psplatform.users()
+
+
+# =====================================================================
+# --- Windows services
+# =====================================================================
+
+
+if WINDOWS:
+
+    def win_service_iter():
+        """Return a generator yielding a WindowsService instance for all
+        Windows services installed.
+        """
+        return _psplatform.win_service_iter()
+
+    def win_service_get(name):
+        """Get a Windows service by *name*.
+        Raise NoSuchProcess if no service with such name exists.
+        """
+        return _psplatform.win_service_get(name)
+
+
+# =====================================================================
+
+
+def test():  # pragma: no cover
+    from ._common import bytes2human
+    from ._compat import get_terminal_size
+
+    today_day = datetime.date.today()
+    templ = "%-10s %5s %5s %7s %7s %5s %6s %6s %6s  %s"
+    attrs = ['pid', 'memory_percent', 'name', 'cmdline', 'cpu_times',
+             'create_time', 'memory_info', 'status', 'nice', 'username']
+    print(templ % ("USER", "PID", "%MEM", "VSZ", "RSS", "NICE",  # NOQA
+                   "STATUS", "START", "TIME", "CMDLINE"))
+    for p in process_iter(attrs, ad_value=None):
+        if p.info['create_time']:
+            ctime = datetime.datetime.fromtimestamp(p.info['create_time'])
+            if ctime.date() == today_day:
+                ctime = ctime.strftime("%H:%M")
+            else:
+                ctime = ctime.strftime("%b%d")
+        else:
+            ctime = ''
+        if p.info['cpu_times']:
+            cputime = time.strftime("%M:%S",
+                                    time.localtime(sum(p.info['cpu_times'])))
+        else:
+            cputime = ''
+
+        user = p.info['username'] or ''
+        if not user and POSIX:
+            try:
+                user = p.uids()[0]
+            except Error:
+                pass
+        if user and WINDOWS and '\\' in user:
+            user = user.split('\\')[1]
+        user = user[:9]
+        vms = bytes2human(p.info['memory_info'].vms) if \
+            p.info['memory_info'] is not None else ''
+        rss = bytes2human(p.info['memory_info'].rss) if \
+            p.info['memory_info'] is not None else ''
+        memp = round(p.info['memory_percent'], 1) if \
+            p.info['memory_percent'] is not None else ''
+        nice = int(p.info['nice']) if p.info['nice'] else ''
+        if p.info['cmdline']:
+            cmdline = ' '.join(p.info['cmdline'])
+        else:
+            cmdline = p.info['name']
+        status = p.info['status'][:5] if p.info['status'] else ''
+
+        line = templ % (
+            user[:10],
+            p.info['pid'],
+            memp,
+            vms,
+            rss,
+            nice,
+            status,
+            ctime,
+            cputime,
+            cmdline)
+        print(line[:get_terminal_size()[0]])  # NOQA
+
+
+del memoize_when_activated, division
+if sys.version_info[0] < 3:
+    del num, x
+
+if __name__ == "__main__":
+    test()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_common.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_common.py
new file mode 100644
index 0000000000000000000000000000000000000000..b7a5478658fe78b9a1537dd893a3a77cc095581f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_common.py
@@ -0,0 +1,845 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Common objects shared by __init__.py and _ps*.py modules."""
+
+# Note: this module is imported by setup.py so it should not import
+# psutil or third-party modules.
+
+from __future__ import division, print_function
+
+import contextlib
+import errno
+import functools
+import os
+import socket
+import stat
+import sys
+import threading
+import warnings
+from collections import defaultdict
+from collections import namedtuple
+from socket import AF_INET
+from socket import SOCK_DGRAM
+from socket import SOCK_STREAM
+
+try:
+    from socket import AF_INET6
+except ImportError:
+    AF_INET6 = None
+try:
+    from socket import AF_UNIX
+except ImportError:
+    AF_UNIX = None
+
+if sys.version_info >= (3, 4):
+    import enum
+else:
+    enum = None
+
+
+# can't take it from _common.py as this script is imported by setup.py
+PY3 = sys.version_info[0] == 3
+
+__all__ = [
+    # OS constants
+    'FREEBSD', 'BSD', 'LINUX', 'NETBSD', 'OPENBSD', 'MACOS', 'OSX', 'POSIX',
+    'SUNOS', 'WINDOWS',
+    # connection constants
+    'CONN_CLOSE', 'CONN_CLOSE_WAIT', 'CONN_CLOSING', 'CONN_ESTABLISHED',
+    'CONN_FIN_WAIT1', 'CONN_FIN_WAIT2', 'CONN_LAST_ACK', 'CONN_LISTEN',
+    'CONN_NONE', 'CONN_SYN_RECV', 'CONN_SYN_SENT', 'CONN_TIME_WAIT',
+    # net constants
+    'NIC_DUPLEX_FULL', 'NIC_DUPLEX_HALF', 'NIC_DUPLEX_UNKNOWN',
+    # process status constants
+    'STATUS_DEAD', 'STATUS_DISK_SLEEP', 'STATUS_IDLE', 'STATUS_LOCKED',
+    'STATUS_RUNNING', 'STATUS_SLEEPING', 'STATUS_STOPPED', 'STATUS_SUSPENDED',
+    'STATUS_TRACING_STOP', 'STATUS_WAITING', 'STATUS_WAKE_KILL',
+    'STATUS_WAKING', 'STATUS_ZOMBIE', 'STATUS_PARKED',
+    # other constants
+    'ENCODING', 'ENCODING_ERRS', 'AF_INET6',
+    # named tuples
+    'pconn', 'pcputimes', 'pctxsw', 'pgids', 'pio', 'pionice', 'popenfile',
+    'pthread', 'puids', 'sconn', 'scpustats', 'sdiskio', 'sdiskpart',
+    'sdiskusage', 'snetio', 'snicaddr', 'snicstats', 'sswap', 'suser',
+    # utility functions
+    'conn_tmap', 'deprecated_method', 'isfile_strict', 'memoize',
+    'parse_environ_block', 'path_exists_strict', 'usage_percent',
+    'supports_ipv6', 'sockfam_to_enum', 'socktype_to_enum', "wrap_numbers",
+    'bytes2human', 'conn_to_ntuple', 'debug',
+    # shell utils
+    'hilite', 'term_supports_colors', 'print_color',
+]
+
+
+# ===================================================================
+# --- OS constants
+# ===================================================================
+
+
+POSIX = os.name == "posix"
+WINDOWS = os.name == "nt"
+LINUX = sys.platform.startswith("linux")
+MACOS = sys.platform.startswith("darwin")
+OSX = MACOS  # deprecated alias
+FREEBSD = sys.platform.startswith("freebsd")
+OPENBSD = sys.platform.startswith("openbsd")
+NETBSD = sys.platform.startswith("netbsd")
+BSD = FREEBSD or OPENBSD or NETBSD
+SUNOS = sys.platform.startswith(("sunos", "solaris"))
+AIX = sys.platform.startswith("aix")
+
+
+# ===================================================================
+# --- API constants
+# ===================================================================
+
+
+# Process.status()
+STATUS_RUNNING = "running"
+STATUS_SLEEPING = "sleeping"
+STATUS_DISK_SLEEP = "disk-sleep"
+STATUS_STOPPED = "stopped"
+STATUS_TRACING_STOP = "tracing-stop"
+STATUS_ZOMBIE = "zombie"
+STATUS_DEAD = "dead"
+STATUS_WAKE_KILL = "wake-kill"
+STATUS_WAKING = "waking"
+STATUS_IDLE = "idle"  # Linux, macOS, FreeBSD
+STATUS_LOCKED = "locked"  # FreeBSD
+STATUS_WAITING = "waiting"  # FreeBSD
+STATUS_SUSPENDED = "suspended"  # NetBSD
+STATUS_PARKED = "parked"  # Linux
+
+# Process.connections() and psutil.net_connections()
+CONN_ESTABLISHED = "ESTABLISHED"
+CONN_SYN_SENT = "SYN_SENT"
+CONN_SYN_RECV = "SYN_RECV"
+CONN_FIN_WAIT1 = "FIN_WAIT1"
+CONN_FIN_WAIT2 = "FIN_WAIT2"
+CONN_TIME_WAIT = "TIME_WAIT"
+CONN_CLOSE = "CLOSE"
+CONN_CLOSE_WAIT = "CLOSE_WAIT"
+CONN_LAST_ACK = "LAST_ACK"
+CONN_LISTEN = "LISTEN"
+CONN_CLOSING = "CLOSING"
+CONN_NONE = "NONE"
+
+# net_if_stats()
+if enum is None:
+    NIC_DUPLEX_FULL = 2
+    NIC_DUPLEX_HALF = 1
+    NIC_DUPLEX_UNKNOWN = 0
+else:
+    class NicDuplex(enum.IntEnum):
+        NIC_DUPLEX_FULL = 2
+        NIC_DUPLEX_HALF = 1
+        NIC_DUPLEX_UNKNOWN = 0
+
+    globals().update(NicDuplex.__members__)
+
+# sensors_battery()
+if enum is None:
+    POWER_TIME_UNKNOWN = -1
+    POWER_TIME_UNLIMITED = -2
+else:
+    class BatteryTime(enum.IntEnum):
+        POWER_TIME_UNKNOWN = -1
+        POWER_TIME_UNLIMITED = -2
+
+    globals().update(BatteryTime.__members__)
+
+# --- others
+
+ENCODING = sys.getfilesystemencoding()
+if not PY3:
+    ENCODING_ERRS = "replace"
+else:
+    try:
+        ENCODING_ERRS = sys.getfilesystemencodeerrors()  # py 3.6
+    except AttributeError:
+        ENCODING_ERRS = "surrogateescape" if POSIX else "replace"
+
+
+# ===================================================================
+# --- namedtuples
+# ===================================================================
+
+# --- for system functions
+
+# psutil.swap_memory()
+sswap = namedtuple('sswap', ['total', 'used', 'free', 'percent', 'sin',
+                             'sout'])
+# psutil.disk_usage()
+sdiskusage = namedtuple('sdiskusage', ['total', 'used', 'free', 'percent'])
+# psutil.disk_io_counters()
+sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
+                                 'read_bytes', 'write_bytes',
+                                 'read_time', 'write_time'])
+# psutil.disk_partitions()
+sdiskpart = namedtuple('sdiskpart', ['device', 'mountpoint', 'fstype', 'opts'])
+# psutil.net_io_counters()
+snetio = namedtuple('snetio', ['bytes_sent', 'bytes_recv',
+                               'packets_sent', 'packets_recv',
+                               'errin', 'errout',
+                               'dropin', 'dropout'])
+# psutil.users()
+suser = namedtuple('suser', ['name', 'terminal', 'host', 'started', 'pid'])
+# psutil.net_connections()
+sconn = namedtuple('sconn', ['fd', 'family', 'type', 'laddr', 'raddr',
+                             'status', 'pid'])
+# psutil.net_if_addrs()
+snicaddr = namedtuple('snicaddr',
+                      ['family', 'address', 'netmask', 'broadcast', 'ptp'])
+# psutil.net_if_stats()
+snicstats = namedtuple('snicstats', ['isup', 'duplex', 'speed', 'mtu'])
+# psutil.cpu_stats()
+scpustats = namedtuple(
+    'scpustats', ['ctx_switches', 'interrupts', 'soft_interrupts', 'syscalls'])
+# psutil.cpu_freq()
+scpufreq = namedtuple('scpufreq', ['current', 'min', 'max'])
+# psutil.sensors_temperatures()
+shwtemp = namedtuple(
+    'shwtemp', ['label', 'current', 'high', 'critical'])
+# psutil.sensors_battery()
+sbattery = namedtuple('sbattery', ['percent', 'secsleft', 'power_plugged'])
+# psutil.sensors_fans()
+sfan = namedtuple('sfan', ['label', 'current'])
+
+# --- for Process methods
+
+# psutil.Process.cpu_times()
+pcputimes = namedtuple('pcputimes',
+                       ['user', 'system', 'children_user', 'children_system'])
+# psutil.Process.open_files()
+popenfile = namedtuple('popenfile', ['path', 'fd'])
+# psutil.Process.threads()
+pthread = namedtuple('pthread', ['id', 'user_time', 'system_time'])
+# psutil.Process.uids()
+puids = namedtuple('puids', ['real', 'effective', 'saved'])
+# psutil.Process.gids()
+pgids = namedtuple('pgids', ['real', 'effective', 'saved'])
+# psutil.Process.io_counters()
+pio = namedtuple('pio', ['read_count', 'write_count',
+                         'read_bytes', 'write_bytes'])
+# psutil.Process.ionice()
+pionice = namedtuple('pionice', ['ioclass', 'value'])
+# psutil.Process.ctx_switches()
+pctxsw = namedtuple('pctxsw', ['voluntary', 'involuntary'])
+# psutil.Process.connections()
+pconn = namedtuple('pconn', ['fd', 'family', 'type', 'laddr', 'raddr',
+                             'status'])
+
+# psutil.connections() and psutil.Process.connections()
+addr = namedtuple('addr', ['ip', 'port'])
+
+
+# ===================================================================
+# --- Process.connections() 'kind' parameter mapping
+# ===================================================================
+
+
+conn_tmap = {
+    "all": ([AF_INET, AF_INET6, AF_UNIX], [SOCK_STREAM, SOCK_DGRAM]),
+    "tcp": ([AF_INET, AF_INET6], [SOCK_STREAM]),
+    "tcp4": ([AF_INET], [SOCK_STREAM]),
+    "udp": ([AF_INET, AF_INET6], [SOCK_DGRAM]),
+    "udp4": ([AF_INET], [SOCK_DGRAM]),
+    "inet": ([AF_INET, AF_INET6], [SOCK_STREAM, SOCK_DGRAM]),
+    "inet4": ([AF_INET], [SOCK_STREAM, SOCK_DGRAM]),
+    "inet6": ([AF_INET6], [SOCK_STREAM, SOCK_DGRAM]),
+}
+
+if AF_INET6 is not None:
+    conn_tmap.update({
+        "tcp6": ([AF_INET6], [SOCK_STREAM]),
+        "udp6": ([AF_INET6], [SOCK_DGRAM]),
+    })
+
+if AF_UNIX is not None:
+    conn_tmap.update({
+        "unix": ([AF_UNIX], [SOCK_STREAM, SOCK_DGRAM]),
+    })
+
+
+# =====================================================================
+# --- Exceptions
+# =====================================================================
+
+
+class Error(Exception):
+    """Base exception class. All other psutil exceptions inherit
+    from this one.
+    """
+    __module__ = 'psutil'
+
+    def __init__(self, msg=""):
+        Exception.__init__(self, msg)
+        self.msg = msg
+
+    def __repr__(self):
+        ret = "psutil.%s %s" % (self.__class__.__name__, self.msg)
+        return ret.strip()
+
+    __str__ = __repr__
+
+
+class NoSuchProcess(Error):
+    """Exception raised when a process with a certain PID doesn't
+    or no longer exists.
+    """
+    __module__ = 'psutil'
+
+    def __init__(self, pid, name=None, msg=None):
+        Error.__init__(self, msg)
+        self.pid = pid
+        self.name = name
+        self.msg = msg
+        if msg is None:
+            if name:
+                details = "(pid=%s, name=%s)" % (self.pid, repr(self.name))
+            else:
+                details = "(pid=%s)" % self.pid
+            self.msg = "process no longer exists " + details
+
+
+class ZombieProcess(NoSuchProcess):
+    """Exception raised when querying a zombie process. This is
+    raised on macOS, BSD and Solaris only, and not always: depending
+    on the query the OS may be able to succeed anyway.
+    On Linux all zombie processes are querable (hence this is never
+    raised). Windows doesn't have zombie processes.
+    """
+    __module__ = 'psutil'
+
+    def __init__(self, pid, name=None, ppid=None, msg=None):
+        NoSuchProcess.__init__(self, msg)
+        self.pid = pid
+        self.ppid = ppid
+        self.name = name
+        self.msg = msg
+        if msg is None:
+            args = ["pid=%s" % pid]
+            if name:
+                args.append("name=%s" % repr(self.name))
+            if ppid:
+                args.append("ppid=%s" % self.ppid)
+            details = "(%s)" % ", ".join(args)
+            self.msg = "process still exists but it's a zombie " + details
+
+
+class AccessDenied(Error):
+    """Exception raised when permission to perform an action is denied."""
+    __module__ = 'psutil'
+
+    def __init__(self, pid=None, name=None, msg=None):
+        Error.__init__(self, msg)
+        self.pid = pid
+        self.name = name
+        self.msg = msg
+        if msg is None:
+            if (pid is not None) and (name is not None):
+                self.msg = "(pid=%s, name=%s)" % (pid, repr(name))
+            elif (pid is not None):
+                self.msg = "(pid=%s)" % self.pid
+            else:
+                self.msg = ""
+
+
+class TimeoutExpired(Error):
+    """Raised on Process.wait(timeout) if timeout expires and process
+    is still alive.
+    """
+    __module__ = 'psutil'
+
+    def __init__(self, seconds, pid=None, name=None):
+        Error.__init__(self, "timeout after %s seconds" % seconds)
+        self.seconds = seconds
+        self.pid = pid
+        self.name = name
+        if (pid is not None) and (name is not None):
+            self.msg += " (pid=%s, name=%s)" % (pid, repr(name))
+        elif (pid is not None):
+            self.msg += " (pid=%s)" % self.pid
+
+
+# ===================================================================
+# --- utils
+# ===================================================================
+
+
+def usage_percent(used, total, round_=None):
+    """Calculate percentage usage of 'used' against 'total'."""
+    try:
+        ret = (float(used) / total) * 100
+    except ZeroDivisionError:
+        return 0.0
+    else:
+        if round_ is not None:
+            ret = round(ret, round_)
+        return ret
+
+
+def memoize(fun):
+    """A simple memoize decorator for functions supporting (hashable)
+    positional arguments.
+    It also provides a cache_clear() function for clearing the cache:
+
+    >>> @memoize
+    ... def foo()
+    ...     return 1
+        ...
+    >>> foo()
+    1
+    >>> foo.cache_clear()
+    >>>
+    """
+    @functools.wraps(fun)
+    def wrapper(*args, **kwargs):
+        key = (args, frozenset(sorted(kwargs.items())))
+        try:
+            return cache[key]
+        except KeyError:
+            ret = cache[key] = fun(*args, **kwargs)
+            return ret
+
+    def cache_clear():
+        """Clear cache."""
+        cache.clear()
+
+    cache = {}
+    wrapper.cache_clear = cache_clear
+    return wrapper
+
+
+def memoize_when_activated(fun):
+    """A memoize decorator which is disabled by default. It can be
+    activated and deactivated on request.
+    For efficiency reasons it can be used only against class methods
+    accepting no arguments.
+
+    >>> class Foo:
+    ...     @memoize
+    ...     def foo()
+    ...         print(1)
+    ...
+    >>> f = Foo()
+    >>> # deactivated (default)
+    >>> foo()
+    1
+    >>> foo()
+    1
+    >>>
+    >>> # activated
+    >>> foo.cache_activate(self)
+    >>> foo()
+    1
+    >>> foo()
+    >>> foo()
+    >>>
+    """
+    @functools.wraps(fun)
+    def wrapper(self):
+        try:
+            # case 1: we previously entered oneshot() ctx
+            ret = self._cache[fun]
+        except AttributeError:
+            # case 2: we never entered oneshot() ctx
+            return fun(self)
+        except KeyError:
+            # case 3: we entered oneshot() ctx but there's no cache
+            # for this entry yet
+            ret = self._cache[fun] = fun(self)
+        return ret
+
+    def cache_activate(proc):
+        """Activate cache. Expects a Process instance. Cache will be
+        stored as a "_cache" instance attribute."""
+        proc._cache = {}
+
+    def cache_deactivate(proc):
+        """Deactivate and clear cache."""
+        try:
+            del proc._cache
+        except AttributeError:
+            pass
+
+    wrapper.cache_activate = cache_activate
+    wrapper.cache_deactivate = cache_deactivate
+    return wrapper
+
+
+def isfile_strict(path):
+    """Same as os.path.isfile() but does not swallow EACCES / EPERM
+    exceptions, see:
+    http://mail.python.org/pipermail/python-dev/2012-June/120787.html
+    """
+    try:
+        st = os.stat(path)
+    except OSError as err:
+        if err.errno in (errno.EPERM, errno.EACCES):
+            raise
+        return False
+    else:
+        return stat.S_ISREG(st.st_mode)
+
+
+def path_exists_strict(path):
+    """Same as os.path.exists() but does not swallow EACCES / EPERM
+    exceptions, see:
+    http://mail.python.org/pipermail/python-dev/2012-June/120787.html
+    """
+    try:
+        os.stat(path)
+    except OSError as err:
+        if err.errno in (errno.EPERM, errno.EACCES):
+            raise
+        return False
+    else:
+        return True
+
+
+@memoize
+def supports_ipv6():
+    """Return True if IPv6 is supported on this platform."""
+    if not socket.has_ipv6 or AF_INET6 is None:
+        return False
+    try:
+        sock = socket.socket(AF_INET6, socket.SOCK_STREAM)
+        with contextlib.closing(sock):
+            sock.bind(("::1", 0))
+        return True
+    except socket.error:
+        return False
+
+
+def parse_environ_block(data):
+    """Parse a C environ block of environment variables into a dictionary."""
+    # The block is usually raw data from the target process.  It might contain
+    # trailing garbage and lines that do not look like assignments.
+    ret = {}
+    pos = 0
+
+    # localize global variable to speed up access.
+    WINDOWS_ = WINDOWS
+    while True:
+        next_pos = data.find("\0", pos)
+        # nul byte at the beginning or double nul byte means finish
+        if next_pos <= pos:
+            break
+        # there might not be an equals sign
+        equal_pos = data.find("=", pos, next_pos)
+        if equal_pos > pos:
+            key = data[pos:equal_pos]
+            value = data[equal_pos + 1:next_pos]
+            # Windows expects environment variables to be uppercase only
+            if WINDOWS_:
+                key = key.upper()
+            ret[key] = value
+        pos = next_pos + 1
+
+    return ret
+
+
+def sockfam_to_enum(num):
+    """Convert a numeric socket family value to an IntEnum member.
+    If it's not a known member, return the numeric value itself.
+    """
+    if enum is None:
+        return num
+    else:  # pragma: no cover
+        try:
+            return socket.AddressFamily(num)
+        except ValueError:
+            return num
+
+
+def socktype_to_enum(num):
+    """Convert a numeric socket type value to an IntEnum member.
+    If it's not a known member, return the numeric value itself.
+    """
+    if enum is None:
+        return num
+    else:  # pragma: no cover
+        try:
+            return socket.SocketKind(num)
+        except ValueError:
+            return num
+
+
+def conn_to_ntuple(fd, fam, type_, laddr, raddr, status, status_map, pid=None):
+    """Convert a raw connection tuple to a proper ntuple."""
+    if fam in (socket.AF_INET, AF_INET6):
+        if laddr:
+            laddr = addr(*laddr)
+        if raddr:
+            raddr = addr(*raddr)
+    if type_ == socket.SOCK_STREAM and fam in (AF_INET, AF_INET6):
+        status = status_map.get(status, CONN_NONE)
+    else:
+        status = CONN_NONE  # ignore whatever C returned to us
+    fam = sockfam_to_enum(fam)
+    type_ = socktype_to_enum(type_)
+    if pid is None:
+        return pconn(fd, fam, type_, laddr, raddr, status)
+    else:
+        return sconn(fd, fam, type_, laddr, raddr, status, pid)
+
+
+def deprecated_method(replacement):
+    """A decorator which can be used to mark a method as deprecated
+    'replcement' is the method name which will be called instead.
+    """
+    def outer(fun):
+        msg = "%s() is deprecated and will be removed; use %s() instead" % (
+            fun.__name__, replacement)
+        if fun.__doc__ is None:
+            fun.__doc__ = msg
+
+        @functools.wraps(fun)
+        def inner(self, *args, **kwargs):
+            warnings.warn(msg, category=DeprecationWarning, stacklevel=2)
+            return getattr(self, replacement)(*args, **kwargs)
+        return inner
+    return outer
+
+
+class _WrapNumbers:
+    """Watches numbers so that they don't overflow and wrap
+    (reset to zero).
+    """
+
+    def __init__(self):
+        self.lock = threading.Lock()
+        self.cache = {}
+        self.reminders = {}
+        self.reminder_keys = {}
+
+    def _add_dict(self, input_dict, name):
+        assert name not in self.cache
+        assert name not in self.reminders
+        assert name not in self.reminder_keys
+        self.cache[name] = input_dict
+        self.reminders[name] = defaultdict(int)
+        self.reminder_keys[name] = defaultdict(set)
+
+    def _remove_dead_reminders(self, input_dict, name):
+        """In case the number of keys changed between calls (e.g. a
+        disk disappears) this removes the entry from self.reminders.
+        """
+        old_dict = self.cache[name]
+        gone_keys = set(old_dict.keys()) - set(input_dict.keys())
+        for gone_key in gone_keys:
+            for remkey in self.reminder_keys[name][gone_key]:
+                del self.reminders[name][remkey]
+            del self.reminder_keys[name][gone_key]
+
+    def run(self, input_dict, name):
+        """Cache dict and sum numbers which overflow and wrap.
+        Return an updated copy of `input_dict`
+        """
+        if name not in self.cache:
+            # This was the first call.
+            self._add_dict(input_dict, name)
+            return input_dict
+
+        self._remove_dead_reminders(input_dict, name)
+
+        old_dict = self.cache[name]
+        new_dict = {}
+        for key in input_dict.keys():
+            input_tuple = input_dict[key]
+            try:
+                old_tuple = old_dict[key]
+            except KeyError:
+                # The input dict has a new key (e.g. a new disk or NIC)
+                # which didn't exist in the previous call.
+                new_dict[key] = input_tuple
+                continue
+
+            bits = []
+            for i in range(len(input_tuple)):
+                input_value = input_tuple[i]
+                old_value = old_tuple[i]
+                remkey = (key, i)
+                if input_value < old_value:
+                    # it wrapped!
+                    self.reminders[name][remkey] += old_value
+                    self.reminder_keys[name][key].add(remkey)
+                bits.append(input_value + self.reminders[name][remkey])
+
+            new_dict[key] = tuple(bits)
+
+        self.cache[name] = input_dict
+        return new_dict
+
+    def cache_clear(self, name=None):
+        """Clear the internal cache, optionally only for function 'name'."""
+        with self.lock:
+            if name is None:
+                self.cache.clear()
+                self.reminders.clear()
+                self.reminder_keys.clear()
+            else:
+                self.cache.pop(name, None)
+                self.reminders.pop(name, None)
+                self.reminder_keys.pop(name, None)
+
+    def cache_info(self):
+        """Return internal cache dicts as a tuple of 3 elements."""
+        with self.lock:
+            return (self.cache, self.reminders, self.reminder_keys)
+
+
+def wrap_numbers(input_dict, name):
+    """Given an `input_dict` and a function `name`, adjust the numbers
+    which "wrap" (restart from zero) across different calls by adding
+    "old value" to "new value" and return an updated dict.
+    """
+    with _wn.lock:
+        return _wn.run(input_dict, name)
+
+
+_wn = _WrapNumbers()
+wrap_numbers.cache_clear = _wn.cache_clear
+wrap_numbers.cache_info = _wn.cache_info
+
+
+def open_binary(fname, **kwargs):
+    return open(fname, "rb", **kwargs)
+
+
+def open_text(fname, **kwargs):
+    """On Python 3 opens a file in text mode by using fs encoding and
+    a proper en/decoding errors handler.
+    On Python 2 this is just an alias for open(name, 'rt').
+    """
+    if PY3:
+        # See:
+        # https://github.com/giampaolo/psutil/issues/675
+        # https://github.com/giampaolo/psutil/pull/733
+        kwargs.setdefault('encoding', ENCODING)
+        kwargs.setdefault('errors', ENCODING_ERRS)
+    return open(fname, "rt", **kwargs)
+
+
+def bytes2human(n, format="%(value).1f%(symbol)s"):
+    """Used by various scripts. See:
+    http://goo.gl/zeJZl
+
+    >>> bytes2human(10000)
+    '9.8K'
+    >>> bytes2human(100001221)
+    '95.4M'
+    """
+    symbols = ('B', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y')
+    prefix = {}
+    for i, s in enumerate(symbols[1:]):
+        prefix[s] = 1 << (i + 1) * 10
+    for symbol in reversed(symbols[1:]):
+        if n >= prefix[symbol]:
+            value = float(n) / prefix[symbol]
+            return format % locals()
+    return format % dict(symbol=symbols[0], value=n)
+
+
+def get_procfs_path():
+    """Return updated psutil.PROCFS_PATH constant."""
+    return sys.modules['psutil'].PROCFS_PATH
+
+
+if PY3:
+    def decode(s):
+        return s.decode(encoding=ENCODING, errors=ENCODING_ERRS)
+else:
+    def decode(s):
+        return s
+
+
+# =====================================================================
+# --- shell utils
+# =====================================================================
+
+
+@memoize
+def term_supports_colors(file=sys.stdout):  # pragma: no cover
+    if os.name == 'nt':
+        return True
+    try:
+        import curses
+        assert file.isatty()
+        curses.setupterm()
+        assert curses.tigetnum("colors") > 0
+    except Exception:
+        return False
+    else:
+        return True
+
+
+def hilite(s, color=None, bold=False):  # pragma: no cover
+    """Return an highlighted version of 'string'."""
+    if not term_supports_colors():
+        return s
+    attr = []
+    colors = dict(green='32', red='91', brown='33', yellow='93', blue='34',
+                  violet='35', lightblue='36', grey='37', darkgrey='30')
+    colors[None] = '29'
+    try:
+        color = colors[color]
+    except KeyError:
+        raise ValueError("invalid color %r; choose between %s" % (
+            list(colors.keys())))
+    attr.append(color)
+    if bold:
+        attr.append('1')
+    return '\x1b[%sm%s\x1b[0m' % (';'.join(attr), s)
+
+
+def print_color(
+        s, color=None, bold=False, file=sys.stdout):  # pragma: no cover
+    """Print a colorized version of string."""
+    if not term_supports_colors():
+        print(s, file=file)  # NOQA
+    elif POSIX:
+        print(hilite(s, color, bold), file=file)  # NOQA
+    else:
+        import ctypes
+
+        DEFAULT_COLOR = 7
+        GetStdHandle = ctypes.windll.Kernel32.GetStdHandle
+        SetConsoleTextAttribute = \
+            ctypes.windll.Kernel32.SetConsoleTextAttribute
+
+        colors = dict(green=2, red=4, brown=6, yellow=6)
+        colors[None] = DEFAULT_COLOR
+        try:
+            color = colors[color]
+        except KeyError:
+            raise ValueError("invalid color %r; choose between %r" % (
+                color, list(colors.keys())))
+        if bold and color <= 7:
+            color += 8
+
+        handle_id = -12 if file is sys.stderr else -11
+        GetStdHandle.restype = ctypes.c_ulong
+        handle = GetStdHandle(handle_id)
+        SetConsoleTextAttribute(handle, color)
+        try:
+            print(s, file=file)    # NOQA
+        finally:
+            SetConsoleTextAttribute(handle, DEFAULT_COLOR)
+
+
+if bool(os.getenv('PSUTIL_DEBUG', 0)):
+    import inspect
+
+    def debug(msg):
+        """If PSUTIL_DEBUG env var is set, print a debug message to stderr."""
+        fname, lineno, func_name, lines, index = inspect.getframeinfo(
+            inspect.currentframe().f_back)
+        print("psutil-debug [%s:%s]> %s" % (fname, lineno, msg),  # NOQA
+              file=sys.stderr)
+else:
+    def debug(msg):
+        pass
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_compat.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..17f38485e9f162766913b42e4e3cc45785e60217
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_compat.py
@@ -0,0 +1,424 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Module which provides compatibility with older Python versions.
+This is more future-compatible rather than the opposite (prefer latest
+Python 3 way of doing things).
+"""
+
+import collections
+import errno
+import functools
+import os
+import sys
+import types
+
+__all__ = [
+    # constants
+    "PY3",
+    # builtins
+    "long", "range", "super", "unicode", "basestring",
+    # literals
+    "u", "b",
+    # collections module
+    "lru_cache",
+    # shutil module
+    "which", "get_terminal_size",
+    # python 3 exceptions
+    "FileNotFoundError", "PermissionError", "ProcessLookupError",
+    "InterruptedError", "ChildProcessError", "FileExistsError"]
+
+
+PY3 = sys.version_info[0] == 3
+_SENTINEL = object()
+
+if PY3:
+    long = int
+    xrange = range
+    unicode = str
+    basestring = str
+    range = range
+
+    def u(s):
+        return s
+
+    def b(s):
+        return s.encode("latin-1")
+else:
+    long = long
+    range = xrange
+    unicode = unicode
+    basestring = basestring
+
+    def u(s):
+        return unicode(s, "unicode_escape")
+
+    def b(s):
+        return s
+
+
+# --- builtins
+
+
+# Python 3 super().
+# Taken from "future" package.
+# Credit: Ryan Kelly
+if PY3:
+    super = super
+else:
+    _builtin_super = super
+
+    def super(type_=_SENTINEL, type_or_obj=_SENTINEL, framedepth=1):
+        """Like Python 3 builtin super(). If called without any arguments
+        it attempts to infer them at runtime.
+        """
+        if type_ is _SENTINEL:
+            f = sys._getframe(framedepth)
+            try:
+                # Get the function's first positional argument.
+                type_or_obj = f.f_locals[f.f_code.co_varnames[0]]
+            except (IndexError, KeyError):
+                raise RuntimeError('super() used in a function with no args')
+            try:
+                # Get the MRO so we can crawl it.
+                mro = type_or_obj.__mro__
+            except (AttributeError, RuntimeError):
+                try:
+                    mro = type_or_obj.__class__.__mro__
+                except AttributeError:
+                    raise RuntimeError('super() used in a non-newstyle class')
+            for type_ in mro:
+                #  Find the class that owns the currently-executing method.
+                for meth in type_.__dict__.values():
+                    # Drill down through any wrappers to the underlying func.
+                    # This handles e.g. classmethod() and staticmethod().
+                    try:
+                        while not isinstance(meth, types.FunctionType):
+                            if isinstance(meth, property):
+                                # Calling __get__ on the property will invoke
+                                # user code which might throw exceptions or
+                                # have side effects
+                                meth = meth.fget
+                            else:
+                                try:
+                                    meth = meth.__func__
+                                except AttributeError:
+                                    meth = meth.__get__(type_or_obj, type_)
+                    except (AttributeError, TypeError):
+                        continue
+                    if meth.func_code is f.f_code:
+                        break  # found
+                else:
+                    # Not found. Move onto the next class in MRO.
+                    continue
+                break  # found
+            else:
+                raise RuntimeError('super() called outside a method')
+
+        # Dispatch to builtin super().
+        if type_or_obj is not _SENTINEL:
+            return _builtin_super(type_, type_or_obj)
+        return _builtin_super(type_)
+
+
+# --- exceptions
+
+
+if PY3:
+    FileNotFoundError = FileNotFoundError  # NOQA
+    PermissionError = PermissionError  # NOQA
+    ProcessLookupError = ProcessLookupError  # NOQA
+    InterruptedError = InterruptedError  # NOQA
+    ChildProcessError = ChildProcessError  # NOQA
+    FileExistsError = FileExistsError  # NOQA
+else:
+    # https://github.com/PythonCharmers/python-future/blob/exceptions/
+    #     src/future/types/exceptions/pep3151.py
+    import platform
+
+    def _instance_checking_exception(base_exception=Exception):
+        def wrapped(instance_checker):
+            class TemporaryClass(base_exception):
+
+                def __init__(self, *args, **kwargs):
+                    if len(args) == 1 and isinstance(args[0], TemporaryClass):
+                        unwrap_me = args[0]
+                        for attr in dir(unwrap_me):
+                            if not attr.startswith('__'):
+                                setattr(self, attr, getattr(unwrap_me, attr))
+                    else:
+                        super(TemporaryClass, self).__init__(*args, **kwargs)
+
+                class __metaclass__(type):
+                    def __instancecheck__(cls, inst):
+                        return instance_checker(inst)
+
+                    def __subclasscheck__(cls, classinfo):
+                        value = sys.exc_info()[1]
+                        return isinstance(value, cls)
+
+            TemporaryClass.__name__ = instance_checker.__name__
+            TemporaryClass.__doc__ = instance_checker.__doc__
+            return TemporaryClass
+
+        return wrapped
+
+    @_instance_checking_exception(EnvironmentError)
+    def FileNotFoundError(inst):
+        return getattr(inst, 'errno', _SENTINEL) == errno.ENOENT
+
+    @_instance_checking_exception(EnvironmentError)
+    def ProcessLookupError(inst):
+        return getattr(inst, 'errno', _SENTINEL) == errno.ESRCH
+
+    @_instance_checking_exception(EnvironmentError)
+    def PermissionError(inst):
+        return getattr(inst, 'errno', _SENTINEL) in (
+            errno.EACCES, errno.EPERM)
+
+    @_instance_checking_exception(EnvironmentError)
+    def InterruptedError(inst):
+        return getattr(inst, 'errno', _SENTINEL) == errno.EINTR
+
+    @_instance_checking_exception(EnvironmentError)
+    def ChildProcessError(inst):
+        return getattr(inst, 'errno', _SENTINEL) == errno.ECHILD
+
+    @_instance_checking_exception(EnvironmentError)
+    def FileExistsError(inst):
+        return getattr(inst, 'errno', _SENTINEL) == errno.EEXIST
+
+    if platform.python_implementation() != "CPython":
+        try:
+            raise OSError(errno.EEXIST, "perm")
+        except FileExistsError:
+            pass
+        except OSError:
+            raise RuntimeError(
+                "broken or incompatible Python implementation, see: "
+                "https://github.com/giampaolo/psutil/issues/1659")
+
+
+# --- stdlib additions
+
+
+# py 3.2 functools.lru_cache
+# Taken from: http://code.activestate.com/recipes/578078
+# Credit: Raymond Hettinger
+try:
+    from functools import lru_cache
+except ImportError:
+    try:
+        from threading import RLock
+    except ImportError:
+        from dummy_threading import RLock
+
+    _CacheInfo = collections.namedtuple(
+        "CacheInfo", ["hits", "misses", "maxsize", "currsize"])
+
+    class _HashedSeq(list):
+        __slots__ = 'hashvalue'
+
+        def __init__(self, tup, hash=hash):
+            self[:] = tup
+            self.hashvalue = hash(tup)
+
+        def __hash__(self):
+            return self.hashvalue
+
+    def _make_key(args, kwds, typed,
+                  kwd_mark=(object(), ),
+                  fasttypes=set((int, str, frozenset, type(None))),
+                  sorted=sorted, tuple=tuple, type=type, len=len):
+        key = args
+        if kwds:
+            sorted_items = sorted(kwds.items())
+            key += kwd_mark
+            for item in sorted_items:
+                key += item
+        if typed:
+            key += tuple(type(v) for v in args)
+            if kwds:
+                key += tuple(type(v) for k, v in sorted_items)
+        elif len(key) == 1 and type(key[0]) in fasttypes:
+            return key[0]
+        return _HashedSeq(key)
+
+    def lru_cache(maxsize=100, typed=False):
+        """Least-recently-used cache decorator, see:
+        http://docs.python.org/3/library/functools.html#functools.lru_cache
+        """
+        def decorating_function(user_function):
+            cache = dict()
+            stats = [0, 0]
+            HITS, MISSES = 0, 1
+            make_key = _make_key
+            cache_get = cache.get
+            _len = len
+            lock = RLock()
+            root = []
+            root[:] = [root, root, None, None]
+            nonlocal_root = [root]
+            PREV, NEXT, KEY, RESULT = 0, 1, 2, 3
+            if maxsize == 0:
+                def wrapper(*args, **kwds):
+                    result = user_function(*args, **kwds)
+                    stats[MISSES] += 1
+                    return result
+            elif maxsize is None:
+                def wrapper(*args, **kwds):
+                    key = make_key(args, kwds, typed)
+                    result = cache_get(key, root)
+                    if result is not root:
+                        stats[HITS] += 1
+                        return result
+                    result = user_function(*args, **kwds)
+                    cache[key] = result
+                    stats[MISSES] += 1
+                    return result
+            else:
+                def wrapper(*args, **kwds):
+                    if kwds or typed:
+                        key = make_key(args, kwds, typed)
+                    else:
+                        key = args
+                    lock.acquire()
+                    try:
+                        link = cache_get(key)
+                        if link is not None:
+                            root, = nonlocal_root
+                            link_prev, link_next, key, result = link
+                            link_prev[NEXT] = link_next
+                            link_next[PREV] = link_prev
+                            last = root[PREV]
+                            last[NEXT] = root[PREV] = link
+                            link[PREV] = last
+                            link[NEXT] = root
+                            stats[HITS] += 1
+                            return result
+                    finally:
+                        lock.release()
+                    result = user_function(*args, **kwds)
+                    lock.acquire()
+                    try:
+                        root, = nonlocal_root
+                        if key in cache:
+                            pass
+                        elif _len(cache) >= maxsize:
+                            oldroot = root
+                            oldroot[KEY] = key
+                            oldroot[RESULT] = result
+                            root = nonlocal_root[0] = oldroot[NEXT]
+                            oldkey = root[KEY]
+                            root[KEY] = root[RESULT] = None
+                            del cache[oldkey]
+                            cache[key] = oldroot
+                        else:
+                            last = root[PREV]
+                            link = [last, root, key, result]
+                            last[NEXT] = root[PREV] = cache[key] = link
+                        stats[MISSES] += 1
+                    finally:
+                        lock.release()
+                    return result
+
+            def cache_info():
+                """Report cache statistics"""
+                lock.acquire()
+                try:
+                    return _CacheInfo(stats[HITS], stats[MISSES], maxsize,
+                                      len(cache))
+                finally:
+                    lock.release()
+
+            def cache_clear():
+                """Clear the cache and cache statistics"""
+                lock.acquire()
+                try:
+                    cache.clear()
+                    root = nonlocal_root[0]
+                    root[:] = [root, root, None, None]
+                    stats[:] = [0, 0]
+                finally:
+                    lock.release()
+
+            wrapper.__wrapped__ = user_function
+            wrapper.cache_info = cache_info
+            wrapper.cache_clear = cache_clear
+            return functools.update_wrapper(wrapper, user_function)
+
+        return decorating_function
+
+
+# python 3.3
+try:
+    from shutil import which
+except ImportError:
+    def which(cmd, mode=os.F_OK | os.X_OK, path=None):
+        """Given a command, mode, and a PATH string, return the path which
+        conforms to the given mode on the PATH, or None if there is no such
+        file.
+
+        `mode` defaults to os.F_OK | os.X_OK. `path` defaults to the result
+        of os.environ.get("PATH"), or can be overridden with a custom search
+        path.
+        """
+        def _access_check(fn, mode):
+            return (os.path.exists(fn) and os.access(fn, mode) and
+                    not os.path.isdir(fn))
+
+        if os.path.dirname(cmd):
+            if _access_check(cmd, mode):
+                return cmd
+            return None
+
+        if path is None:
+            path = os.environ.get("PATH", os.defpath)
+        if not path:
+            return None
+        path = path.split(os.pathsep)
+
+        if sys.platform == "win32":
+            if os.curdir not in path:
+                path.insert(0, os.curdir)
+
+            pathext = os.environ.get("PATHEXT", "").split(os.pathsep)
+            if any(cmd.lower().endswith(ext.lower()) for ext in pathext):
+                files = [cmd]
+            else:
+                files = [cmd + ext for ext in pathext]
+        else:
+            files = [cmd]
+
+        seen = set()
+        for dir in path:
+            normdir = os.path.normcase(dir)
+            if normdir not in seen:
+                seen.add(normdir)
+                for thefile in files:
+                    name = os.path.join(dir, thefile)
+                    if _access_check(name, mode):
+                        return name
+        return None
+
+
+# python 3.3
+try:
+    from shutil import get_terminal_size
+except ImportError:
+    def get_terminal_size(fallback=(80, 24)):
+        try:
+            import fcntl
+            import termios
+            import struct
+        except ImportError:
+            return fallback
+        else:
+            try:
+                # This should work on Linux.
+                res = struct.unpack(
+                    'hh', fcntl.ioctl(1, termios.TIOCGWINSZ, '1234'))
+                return (res[1], res[0])
+            except Exception:
+                return fallback
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psaix.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psaix.py
new file mode 100644
index 0000000000000000000000000000000000000000..994366aaa1b9eb1f4ebaaa17f52ee449e431ef76
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psaix.py
@@ -0,0 +1,550 @@
+# Copyright (c) 2009, Giampaolo Rodola'
+# Copyright (c) 2017, Arnon Yaari
+# All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""AIX platform implementation."""
+
+import functools
+import glob
+import os
+import re
+import subprocess
+import sys
+from collections import namedtuple
+
+from . import _common
+from . import _psposix
+from . import _psutil_aix as cext
+from . import _psutil_posix as cext_posix
+from ._common import AccessDenied
+from ._common import conn_to_ntuple
+from ._common import get_procfs_path
+from ._common import memoize_when_activated
+from ._common import NIC_DUPLEX_FULL
+from ._common import NIC_DUPLEX_HALF
+from ._common import NIC_DUPLEX_UNKNOWN
+from ._common import NoSuchProcess
+from ._common import usage_percent
+from ._common import ZombieProcess
+from ._compat import FileNotFoundError
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import PY3
+
+
+__extra__all__ = ["PROCFS_PATH"]
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+
+HAS_THREADS = hasattr(cext, "proc_threads")
+HAS_NET_IO_COUNTERS = hasattr(cext, "net_io_counters")
+HAS_PROC_IO_COUNTERS = hasattr(cext, "proc_io_counters")
+
+PAGE_SIZE = os.sysconf('SC_PAGE_SIZE')
+AF_LINK = cext_posix.AF_LINK
+
+PROC_STATUSES = {
+    cext.SIDL: _common.STATUS_IDLE,
+    cext.SZOMB: _common.STATUS_ZOMBIE,
+    cext.SACTIVE: _common.STATUS_RUNNING,
+    cext.SSWAP: _common.STATUS_RUNNING,      # TODO what status is this?
+    cext.SSTOP: _common.STATUS_STOPPED,
+}
+
+TCP_STATUSES = {
+    cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
+    cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
+    cext.TCPS_SYN_RCVD: _common.CONN_SYN_RECV,
+    cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
+    cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
+    cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
+    cext.TCPS_CLOSED: _common.CONN_CLOSE,
+    cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
+    cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
+    cext.TCPS_LISTEN: _common.CONN_LISTEN,
+    cext.TCPS_CLOSING: _common.CONN_CLOSING,
+    cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
+}
+
+proc_info_map = dict(
+    ppid=0,
+    rss=1,
+    vms=2,
+    create_time=3,
+    nice=4,
+    num_threads=5,
+    status=6,
+    ttynr=7)
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.Process.memory_info()
+pmem = namedtuple('pmem', ['rss', 'vms'])
+# psutil.Process.memory_full_info()
+pfullmem = pmem
+# psutil.Process.cpu_times()
+scputimes = namedtuple('scputimes', ['user', 'system', 'idle', 'iowait'])
+# psutil.virtual_memory()
+svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
+
+
+# =====================================================================
+# --- memory
+# =====================================================================
+
+
+def virtual_memory():
+    total, avail, free, pinned, inuse = cext.virtual_mem()
+    percent = usage_percent((total - avail), total, round_=1)
+    return svmem(total, avail, percent, inuse, free)
+
+
+def swap_memory():
+    """Swap system memory as a (total, used, free, sin, sout) tuple."""
+    total, free, sin, sout = cext.swap_mem()
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    return _common.sswap(total, used, free, percent, sin, sout)
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return system-wide CPU times as a named tuple"""
+    ret = cext.per_cpu_times()
+    return scputimes(*[sum(x) for x in zip(*ret)])
+
+
+def per_cpu_times():
+    """Return system per-CPU times as a list of named tuples"""
+    ret = cext.per_cpu_times()
+    return [scputimes(*x) for x in ret]
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    try:
+        return os.sysconf("SC_NPROCESSORS_ONLN")
+    except ValueError:
+        # mimic os.cpu_count() behavior
+        return None
+
+
+def cpu_count_physical():
+    cmd = "lsdev -Cc processor"
+    p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE,
+                         stderr=subprocess.PIPE)
+    stdout, stderr = p.communicate()
+    if PY3:
+        stdout, stderr = [x.decode(sys.stdout.encoding)
+                          for x in (stdout, stderr)]
+    if p.returncode != 0:
+        raise RuntimeError("%r command error\n%s" % (cmd, stderr))
+    processors = stdout.strip().splitlines()
+    return len(processors) or None
+
+
+def cpu_stats():
+    """Return various CPU stats as a named tuple."""
+    ctx_switches, interrupts, soft_interrupts, syscalls = cext.cpu_stats()
+    return _common.scpustats(
+        ctx_switches, interrupts, soft_interrupts, syscalls)
+
+
+# =====================================================================
+# --- disks
+# =====================================================================
+
+
+disk_io_counters = cext.disk_io_counters
+disk_usage = _psposix.disk_usage
+
+
+def disk_partitions(all=False):
+    """Return system disk partitions."""
+    # TODO - the filtering logic should be better checked so that
+    # it tries to reflect 'df' as much as possible
+    retlist = []
+    partitions = cext.disk_partitions()
+    for partition in partitions:
+        device, mountpoint, fstype, opts = partition
+        if device == 'none':
+            device = ''
+        if not all:
+            # Differently from, say, Linux, we don't have a list of
+            # common fs types so the best we can do, AFAIK, is to
+            # filter by filesystem having a total size > 0.
+            if not disk_usage(mountpoint).total:
+                continue
+        ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
+        retlist.append(ntuple)
+    return retlist
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+net_if_addrs = cext_posix.net_if_addrs
+
+if HAS_NET_IO_COUNTERS:
+    net_io_counters = cext.net_io_counters
+
+
+def net_connections(kind, _pid=-1):
+    """Return socket connections.  If pid == -1 return system-wide
+    connections (as opposed to connections opened by one process only).
+    """
+    cmap = _common.conn_tmap
+    if kind not in cmap:
+        raise ValueError("invalid %r kind argument; choose between %s"
+                         % (kind, ', '.join([repr(x) for x in cmap])))
+    families, types = _common.conn_tmap[kind]
+    rawlist = cext.net_connections(_pid)
+    ret = []
+    for item in rawlist:
+        fd, fam, type_, laddr, raddr, status, pid = item
+        if fam not in families:
+            continue
+        if type_ not in types:
+            continue
+        nt = conn_to_ntuple(fd, fam, type_, laddr, raddr, status,
+                            TCP_STATUSES, pid=pid if _pid == -1 else None)
+        ret.append(nt)
+    return ret
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    duplex_map = {"Full": NIC_DUPLEX_FULL,
+                  "Half": NIC_DUPLEX_HALF}
+    names = set([x[0] for x in net_if_addrs()])
+    ret = {}
+    for name in names:
+        isup, mtu = cext.net_if_stats(name)
+
+        # try to get speed and duplex
+        # TODO: rewrite this in C (entstat forks, so use truss -f to follow.
+        # looks like it is using an undocumented ioctl?)
+        duplex = ""
+        speed = 0
+        p = subprocess.Popen(["/usr/bin/entstat", "-d", name],
+                             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        stdout, stderr = p.communicate()
+        if PY3:
+            stdout, stderr = [x.decode(sys.stdout.encoding)
+                              for x in (stdout, stderr)]
+        if p.returncode == 0:
+            re_result = re.search(
+                r"Running: (\d+) Mbps.*?(\w+) Duplex", stdout)
+            if re_result is not None:
+                speed = int(re_result.group(1))
+                duplex = re_result.group(2)
+
+        duplex = duplex_map.get(duplex, NIC_DUPLEX_UNKNOWN)
+        ret[name] = _common.snicstats(isup, duplex, speed, mtu)
+    return ret
+
+
+# =====================================================================
+# --- other system functions
+# =====================================================================
+
+
+def boot_time():
+    """The system boot time expressed in seconds since the epoch."""
+    return cext.boot_time()
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    localhost = (':0.0', ':0')
+    for item in rawlist:
+        user, tty, hostname, tstamp, user_process, pid = item
+        # note: the underlying C function includes entries about
+        # system boot, run level and others.  We might want
+        # to use them in the future.
+        if not user_process:
+            continue
+        if hostname in localhost:
+            hostname = 'localhost'
+        nt = _common.suser(user, tty, hostname, tstamp, pid)
+        retlist.append(nt)
+    return retlist
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+def pids():
+    """Returns a list of PIDs currently running on the system."""
+    return [int(x) for x in os.listdir(get_procfs_path()) if x.isdigit()]
+
+
+def pid_exists(pid):
+    """Check for the existence of a unix pid."""
+    return os.path.exists(os.path.join(get_procfs_path(), str(pid), "psinfo"))
+
+
+def wrap_exceptions(fun):
+    """Call callable into a try/except clause and translate ENOENT,
+    EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except (FileNotFoundError, ProcessLookupError):
+            # ENOENT (no such file or directory) gets raised on open().
+            # ESRCH (no such process) can get raised on read() if
+            # process is gone in meantime.
+            if not pid_exists(self.pid):
+                raise NoSuchProcess(self.pid, self._name)
+            else:
+                raise ZombieProcess(self.pid, self._name, self._ppid)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+    return wrapper
+
+
+class Process(object):
+    """Wrapper class around underlying C implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_procfs_path", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+        self._procfs_path = get_procfs_path()
+
+    def oneshot_enter(self):
+        self._proc_basic_info.cache_activate(self)
+        self._proc_cred.cache_activate(self)
+
+    def oneshot_exit(self):
+        self._proc_basic_info.cache_deactivate(self)
+        self._proc_cred.cache_deactivate(self)
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _proc_basic_info(self):
+        return cext.proc_basic_info(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _proc_cred(self):
+        return cext.proc_cred(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    def name(self):
+        if self.pid == 0:
+            return "swapper"
+        # note: max 16 characters
+        return cext.proc_name(self.pid, self._procfs_path).rstrip("\x00")
+
+    @wrap_exceptions
+    def exe(self):
+        # there is no way to get executable path in AIX other than to guess,
+        # and guessing is more complex than what's in the wrapping class
+        cmdline = self.cmdline()
+        if not cmdline:
+            return ''
+        exe = cmdline[0]
+        if os.path.sep in exe:
+            # relative or absolute path
+            if not os.path.isabs(exe):
+                # if cwd has changed, we're out of luck - this may be wrong!
+                exe = os.path.abspath(os.path.join(self.cwd(), exe))
+            if (os.path.isabs(exe) and
+                    os.path.isfile(exe) and
+                    os.access(exe, os.X_OK)):
+                return exe
+            # not found, move to search in PATH using basename only
+            exe = os.path.basename(exe)
+        # search for exe name PATH
+        for path in os.environ["PATH"].split(":"):
+            possible_exe = os.path.abspath(os.path.join(path, exe))
+            if (os.path.isfile(possible_exe) and
+                    os.access(possible_exe, os.X_OK)):
+                return possible_exe
+        return ''
+
+    @wrap_exceptions
+    def cmdline(self):
+        return cext.proc_args(self.pid)
+
+    @wrap_exceptions
+    def environ(self):
+        return cext.proc_environ(self.pid)
+
+    @wrap_exceptions
+    def create_time(self):
+        return self._proc_basic_info()[proc_info_map['create_time']]
+
+    @wrap_exceptions
+    def num_threads(self):
+        return self._proc_basic_info()[proc_info_map['num_threads']]
+
+    if HAS_THREADS:
+        @wrap_exceptions
+        def threads(self):
+            rawlist = cext.proc_threads(self.pid)
+            retlist = []
+            for thread_id, utime, stime in rawlist:
+                ntuple = _common.pthread(thread_id, utime, stime)
+                retlist.append(ntuple)
+            # The underlying C implementation retrieves all OS threads
+            # and filters them by PID.  At this point we can't tell whether
+            # an empty list means there were no connections for process or
+            # process is no longer active so we force NSP in case the PID
+            # is no longer there.
+            if not retlist:
+                # will raise NSP if process is gone
+                os.stat('%s/%s' % (self._procfs_path, self.pid))
+            return retlist
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        ret = net_connections(kind, _pid=self.pid)
+        # The underlying C implementation retrieves all OS connections
+        # and filters them by PID.  At this point we can't tell whether
+        # an empty list means there were no connections for process or
+        # process is no longer active so we force NSP in case the PID
+        # is no longer there.
+        if not ret:
+            # will raise NSP if process is gone
+            os.stat('%s/%s' % (self._procfs_path, self.pid))
+        return ret
+
+    @wrap_exceptions
+    def nice_get(self):
+        return cext_posix.getpriority(self.pid)
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        return cext_posix.setpriority(self.pid, value)
+
+    @wrap_exceptions
+    def ppid(self):
+        self._ppid = self._proc_basic_info()[proc_info_map['ppid']]
+        return self._ppid
+
+    @wrap_exceptions
+    def uids(self):
+        real, effective, saved, _, _, _ = self._proc_cred()
+        return _common.puids(real, effective, saved)
+
+    @wrap_exceptions
+    def gids(self):
+        _, _, _, real, effective, saved = self._proc_cred()
+        return _common.puids(real, effective, saved)
+
+    @wrap_exceptions
+    def cpu_times(self):
+        cpu_times = cext.proc_cpu_times(self.pid, self._procfs_path)
+        return _common.pcputimes(*cpu_times)
+
+    @wrap_exceptions
+    def terminal(self):
+        ttydev = self._proc_basic_info()[proc_info_map['ttynr']]
+        # convert from 64-bit dev_t to 32-bit dev_t and then map the device
+        ttydev = (((ttydev & 0x0000FFFF00000000) >> 16) | (ttydev & 0xFFFF))
+        # try to match rdev of /dev/pts/* files ttydev
+        for dev in glob.glob("/dev/**/*"):
+            if os.stat(dev).st_rdev == ttydev:
+                return dev
+        return None
+
+    @wrap_exceptions
+    def cwd(self):
+        procfs_path = self._procfs_path
+        try:
+            result = os.readlink("%s/%s/cwd" % (procfs_path, self.pid))
+            return result.rstrip('/')
+        except FileNotFoundError:
+            os.stat("%s/%s" % (procfs_path, self.pid))  # raise NSP or AD
+            return None
+
+    @wrap_exceptions
+    def memory_info(self):
+        ret = self._proc_basic_info()
+        rss = ret[proc_info_map['rss']] * 1024
+        vms = ret[proc_info_map['vms']] * 1024
+        return pmem(rss, vms)
+
+    memory_full_info = memory_info
+
+    @wrap_exceptions
+    def status(self):
+        code = self._proc_basic_info()[proc_info_map['status']]
+        # XXX is '?' legit? (we're not supposed to return it anyway)
+        return PROC_STATUSES.get(code, '?')
+
+    def open_files(self):
+        # TODO rewrite without using procfiles (stat /proc/pid/fd/* and then
+        # find matching name of the inode)
+        p = subprocess.Popen(["/usr/bin/procfiles", "-n", str(self.pid)],
+                             stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        stdout, stderr = p.communicate()
+        if PY3:
+            stdout, stderr = [x.decode(sys.stdout.encoding)
+                              for x in (stdout, stderr)]
+        if "no such process" in stderr.lower():
+            raise NoSuchProcess(self.pid, self._name)
+        procfiles = re.findall(r"(\d+): S_IFREG.*\s*.*name:(.*)\n", stdout)
+        retlist = []
+        for fd, path in procfiles:
+            path = path.strip()
+            if path.startswith("//"):
+                path = path[1:]
+            if path.lower() == "cannot be retrieved":
+                continue
+            retlist.append(_common.popenfile(path, int(fd)))
+        return retlist
+
+    @wrap_exceptions
+    def num_fds(self):
+        if self.pid == 0:       # no /proc/0/fd
+            return 0
+        return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
+
+    @wrap_exceptions
+    def num_ctx_switches(self):
+        return _common.pctxsw(
+            *cext.proc_num_ctx_switches(self.pid))
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        return _psposix.wait_pid(self.pid, timeout, self._name)
+
+    if HAS_PROC_IO_COUNTERS:
+        @wrap_exceptions
+        def io_counters(self):
+            try:
+                rc, wc, rb, wb = cext.proc_io_counters(self.pid)
+            except OSError:
+                # if process is terminated, proc_io_counters returns OSError
+                # instead of NSP
+                if not pid_exists(self.pid):
+                    raise NoSuchProcess(self.pid, self._name)
+                raise
+            return _common.pio(rc, wc, rb, wb)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psbsd.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psbsd.py
new file mode 100644
index 0000000000000000000000000000000000000000..428c8bde39a09332851ad144877a8f230ad99a60
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psbsd.py
@@ -0,0 +1,918 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""FreeBSD, OpenBSD and NetBSD platforms implementation."""
+
+import contextlib
+import errno
+import functools
+import os
+import xml.etree.ElementTree as ET
+from collections import namedtuple
+from collections import defaultdict
+
+from . import _common
+from . import _psposix
+from . import _psutil_bsd as cext
+from . import _psutil_posix as cext_posix
+from ._common import AccessDenied
+from ._common import conn_tmap
+from ._common import conn_to_ntuple
+from ._common import FREEBSD
+from ._common import memoize
+from ._common import memoize_when_activated
+from ._common import NETBSD
+from ._common import NoSuchProcess
+from ._common import OPENBSD
+from ._common import usage_percent
+from ._common import ZombieProcess
+from ._compat import FileNotFoundError
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import which
+
+
+__extra__all__ = []
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+
+if FREEBSD:
+    PROC_STATUSES = {
+        cext.SIDL: _common.STATUS_IDLE,
+        cext.SRUN: _common.STATUS_RUNNING,
+        cext.SSLEEP: _common.STATUS_SLEEPING,
+        cext.SSTOP: _common.STATUS_STOPPED,
+        cext.SZOMB: _common.STATUS_ZOMBIE,
+        cext.SWAIT: _common.STATUS_WAITING,
+        cext.SLOCK: _common.STATUS_LOCKED,
+    }
+elif OPENBSD:
+    PROC_STATUSES = {
+        cext.SIDL: _common.STATUS_IDLE,
+        cext.SSLEEP: _common.STATUS_SLEEPING,
+        cext.SSTOP: _common.STATUS_STOPPED,
+        # According to /usr/include/sys/proc.h SZOMB is unused.
+        # test_zombie_process() shows that SDEAD is the right
+        # equivalent. Also it appears there's no equivalent of
+        # psutil.STATUS_DEAD. SDEAD really means STATUS_ZOMBIE.
+        # cext.SZOMB: _common.STATUS_ZOMBIE,
+        cext.SDEAD: _common.STATUS_ZOMBIE,
+        cext.SZOMB: _common.STATUS_ZOMBIE,
+        # From http://www.eecs.harvard.edu/~margo/cs161/videos/proc.h.txt
+        # OpenBSD has SRUN and SONPROC: SRUN indicates that a process
+        # is runnable but *not* yet running, i.e. is on a run queue.
+        # SONPROC indicates that the process is actually executing on
+        # a CPU, i.e. it is no longer on a run queue.
+        # As such we'll map SRUN to STATUS_WAKING and SONPROC to
+        # STATUS_RUNNING
+        cext.SRUN: _common.STATUS_WAKING,
+        cext.SONPROC: _common.STATUS_RUNNING,
+    }
+elif NETBSD:
+    PROC_STATUSES = {
+        cext.SIDL: _common.STATUS_IDLE,
+        cext.SSLEEP: _common.STATUS_SLEEPING,
+        cext.SSTOP: _common.STATUS_STOPPED,
+        cext.SZOMB: _common.STATUS_ZOMBIE,
+        cext.SRUN: _common.STATUS_WAKING,
+        cext.SONPROC: _common.STATUS_RUNNING,
+    }
+
+TCP_STATUSES = {
+    cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
+    cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
+    cext.TCPS_SYN_RECEIVED: _common.CONN_SYN_RECV,
+    cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
+    cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
+    cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
+    cext.TCPS_CLOSED: _common.CONN_CLOSE,
+    cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
+    cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
+    cext.TCPS_LISTEN: _common.CONN_LISTEN,
+    cext.TCPS_CLOSING: _common.CONN_CLOSING,
+    cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
+}
+
+if NETBSD:
+    PAGESIZE = os.sysconf("SC_PAGESIZE")
+else:
+    PAGESIZE = os.sysconf("SC_PAGE_SIZE")
+AF_LINK = cext_posix.AF_LINK
+
+HAS_PER_CPU_TIMES = hasattr(cext, "per_cpu_times")
+HAS_PROC_NUM_THREADS = hasattr(cext, "proc_num_threads")
+HAS_PROC_OPEN_FILES = hasattr(cext, 'proc_open_files')
+HAS_PROC_NUM_FDS = hasattr(cext, 'proc_num_fds')
+
+kinfo_proc_map = dict(
+    ppid=0,
+    status=1,
+    real_uid=2,
+    effective_uid=3,
+    saved_uid=4,
+    real_gid=5,
+    effective_gid=6,
+    saved_gid=7,
+    ttynr=8,
+    create_time=9,
+    ctx_switches_vol=10,
+    ctx_switches_unvol=11,
+    read_io_count=12,
+    write_io_count=13,
+    user_time=14,
+    sys_time=15,
+    ch_user_time=16,
+    ch_sys_time=17,
+    rss=18,
+    vms=19,
+    memtext=20,
+    memdata=21,
+    memstack=22,
+    cpunum=23,
+    name=24,
+)
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.virtual_memory()
+svmem = namedtuple(
+    'svmem', ['total', 'available', 'percent', 'used', 'free',
+              'active', 'inactive', 'buffers', 'cached', 'shared', 'wired'])
+# psutil.cpu_times()
+scputimes = namedtuple(
+    'scputimes', ['user', 'nice', 'system', 'idle', 'irq'])
+# psutil.Process.memory_info()
+pmem = namedtuple('pmem', ['rss', 'vms', 'text', 'data', 'stack'])
+# psutil.Process.memory_full_info()
+pfullmem = pmem
+# psutil.Process.cpu_times()
+pcputimes = namedtuple('pcputimes',
+                       ['user', 'system', 'children_user', 'children_system'])
+# psutil.Process.memory_maps(grouped=True)
+pmmap_grouped = namedtuple(
+    'pmmap_grouped', 'path rss, private, ref_count, shadow_count')
+# psutil.Process.memory_maps(grouped=False)
+pmmap_ext = namedtuple(
+    'pmmap_ext', 'addr, perms path rss, private, ref_count, shadow_count')
+# psutil.disk_io_counters()
+if FREEBSD:
+    sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
+                                     'read_bytes', 'write_bytes',
+                                     'read_time', 'write_time',
+                                     'busy_time'])
+else:
+    sdiskio = namedtuple('sdiskio', ['read_count', 'write_count',
+                                     'read_bytes', 'write_bytes'])
+
+
+# =====================================================================
+# --- memory
+# =====================================================================
+
+
+def virtual_memory():
+    """System virtual memory as a namedtuple."""
+    mem = cext.virtual_mem()
+    total, free, active, inactive, wired, cached, buffers, shared = mem
+    if NETBSD:
+        # On NetBSD buffers and shared mem is determined via /proc.
+        # The C ext set them to 0.
+        with open('/proc/meminfo', 'rb') as f:
+            for line in f:
+                if line.startswith(b'Buffers:'):
+                    buffers = int(line.split()[1]) * 1024
+                elif line.startswith(b'MemShared:'):
+                    shared = int(line.split()[1]) * 1024
+    avail = inactive + cached + free
+    used = active + wired + cached
+    percent = usage_percent((total - avail), total, round_=1)
+    return svmem(total, avail, percent, used, free,
+                 active, inactive, buffers, cached, shared, wired)
+
+
+def swap_memory():
+    """System swap memory as (total, used, free, sin, sout) namedtuple."""
+    total, used, free, sin, sout = cext.swap_mem()
+    percent = usage_percent(used, total, round_=1)
+    return _common.sswap(total, used, free, percent, sin, sout)
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return system per-CPU times as a namedtuple"""
+    user, nice, system, idle, irq = cext.cpu_times()
+    return scputimes(user, nice, system, idle, irq)
+
+
+if HAS_PER_CPU_TIMES:
+    def per_cpu_times():
+        """Return system CPU times as a namedtuple"""
+        ret = []
+        for cpu_t in cext.per_cpu_times():
+            user, nice, system, idle, irq = cpu_t
+            item = scputimes(user, nice, system, idle, irq)
+            ret.append(item)
+        return ret
+else:
+    # XXX
+    # Ok, this is very dirty.
+    # On FreeBSD < 8 we cannot gather per-cpu information, see:
+    # https://github.com/giampaolo/psutil/issues/226
+    # If num cpus > 1, on first call we return single cpu times to avoid a
+    # crash at psutil import time.
+    # Next calls will fail with NotImplementedError
+    def per_cpu_times():
+        """Return system CPU times as a namedtuple"""
+        if cpu_count_logical() == 1:
+            return [cpu_times()]
+        if per_cpu_times.__called__:
+            raise NotImplementedError("supported only starting from FreeBSD 8")
+        per_cpu_times.__called__ = True
+        return [cpu_times()]
+
+    per_cpu_times.__called__ = False
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    return cext.cpu_count_logical()
+
+
+if OPENBSD or NETBSD:
+    def cpu_count_physical():
+        # OpenBSD and NetBSD do not implement this.
+        return 1 if cpu_count_logical() == 1 else None
+else:
+    def cpu_count_physical():
+        """Return the number of physical CPUs in the system."""
+        # From the C module we'll get an XML string similar to this:
+        # http://manpages.ubuntu.com/manpages/precise/man4/smp.4freebsd.html
+        # We may get None in case "sysctl kern.sched.topology_spec"
+        # is not supported on this BSD version, in which case we'll mimic
+        # os.cpu_count() and return None.
+        ret = None
+        s = cext.cpu_count_phys()
+        if s is not None:
+            # get rid of padding chars appended at the end of the string
+            index = s.rfind("</groups>")
+            if index != -1:
+                s = s[:index + 9]
+                root = ET.fromstring(s)
+                try:
+                    ret = len(root.findall('group/children/group/cpu')) or None
+                finally:
+                    # needed otherwise it will memleak
+                    root.clear()
+        if not ret:
+            # If logical CPUs are 1 it's obvious we'll have only 1
+            # physical CPU.
+            if cpu_count_logical() == 1:
+                return 1
+        return ret
+
+
+def cpu_stats():
+    """Return various CPU stats as a named tuple."""
+    if FREEBSD:
+        # Note: the C ext is returning some metrics we are not exposing:
+        # traps.
+        ctxsw, intrs, soft_intrs, syscalls, traps = cext.cpu_stats()
+    elif NETBSD:
+        # XXX
+        # Note about intrs: the C extension returns 0. intrs
+        # can be determined via /proc/stat; it has the same value as
+        # soft_intrs thought so the kernel is faking it (?).
+        #
+        # Note about syscalls: the C extension always sets it to 0 (?).
+        #
+        # Note: the C ext is returning some metrics we are not exposing:
+        # traps, faults and forks.
+        ctxsw, intrs, soft_intrs, syscalls, traps, faults, forks = \
+            cext.cpu_stats()
+        with open('/proc/stat', 'rb') as f:
+            for line in f:
+                if line.startswith(b'intr'):
+                    intrs = int(line.split()[1])
+    elif OPENBSD:
+        # Note: the C ext is returning some metrics we are not exposing:
+        # traps, faults and forks.
+        ctxsw, intrs, soft_intrs, syscalls, traps, faults, forks = \
+            cext.cpu_stats()
+    return _common.scpustats(ctxsw, intrs, soft_intrs, syscalls)
+
+
+# =====================================================================
+# --- disks
+# =====================================================================
+
+
+def disk_partitions(all=False):
+    """Return mounted disk partitions as a list of namedtuples.
+    'all' argument is ignored, see:
+    https://github.com/giampaolo/psutil/issues/906
+    """
+    retlist = []
+    partitions = cext.disk_partitions()
+    for partition in partitions:
+        device, mountpoint, fstype, opts = partition
+        ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
+        retlist.append(ntuple)
+    return retlist
+
+
+disk_usage = _psposix.disk_usage
+disk_io_counters = cext.disk_io_counters
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+net_io_counters = cext.net_io_counters
+net_if_addrs = cext_posix.net_if_addrs
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    names = net_io_counters().keys()
+    ret = {}
+    for name in names:
+        try:
+            mtu = cext_posix.net_if_mtu(name)
+            isup = cext_posix.net_if_is_running(name)
+            duplex, speed = cext_posix.net_if_duplex_speed(name)
+        except OSError as err:
+            # https://github.com/giampaolo/psutil/issues/1279
+            if err.errno != errno.ENODEV:
+                raise
+        else:
+            if hasattr(_common, 'NicDuplex'):
+                duplex = _common.NicDuplex(duplex)
+            ret[name] = _common.snicstats(isup, duplex, speed, mtu)
+    return ret
+
+
+def net_connections(kind):
+    """System-wide network connections."""
+    if OPENBSD:
+        ret = []
+        for pid in pids():
+            try:
+                cons = Process(pid).connections(kind)
+            except (NoSuchProcess, ZombieProcess):
+                continue
+            else:
+                for conn in cons:
+                    conn = list(conn)
+                    conn.append(pid)
+                    ret.append(_common.sconn(*conn))
+        return ret
+
+    if kind not in _common.conn_tmap:
+        raise ValueError("invalid %r kind argument; choose between %s"
+                         % (kind, ', '.join([repr(x) for x in conn_tmap])))
+    families, types = conn_tmap[kind]
+    ret = set()
+    if NETBSD:
+        rawlist = cext.net_connections(-1)
+    else:
+        rawlist = cext.net_connections()
+    for item in rawlist:
+        fd, fam, type, laddr, raddr, status, pid = item
+        # TODO: apply filter at C level
+        if fam in families and type in types:
+            nt = conn_to_ntuple(fd, fam, type, laddr, raddr, status,
+                                TCP_STATUSES, pid)
+            ret.add(nt)
+    return list(ret)
+
+
+# =====================================================================
+#  --- sensors
+# =====================================================================
+
+
+if FREEBSD:
+
+    def sensors_battery():
+        """Return battery info."""
+        try:
+            percent, minsleft, power_plugged = cext.sensors_battery()
+        except NotImplementedError:
+            # See: https://github.com/giampaolo/psutil/issues/1074
+            return None
+        power_plugged = power_plugged == 1
+        if power_plugged:
+            secsleft = _common.POWER_TIME_UNLIMITED
+        elif minsleft == -1:
+            secsleft = _common.POWER_TIME_UNKNOWN
+        else:
+            secsleft = minsleft * 60
+        return _common.sbattery(percent, secsleft, power_plugged)
+
+    def sensors_temperatures():
+        "Return CPU cores temperatures if available, else an empty dict."
+        ret = defaultdict(list)
+        num_cpus = cpu_count_logical()
+        for cpu in range(num_cpus):
+            try:
+                current, high = cext.sensors_cpu_temperature(cpu)
+                if high <= 0:
+                    high = None
+                name = "Core %s" % cpu
+                ret["coretemp"].append(
+                    _common.shwtemp(name, current, high, high))
+            except NotImplementedError:
+                pass
+
+        return ret
+
+    def cpu_freq():
+        """Return frequency metrics for CPUs. As of Dec 2018 only
+        CPU 0 appears to be supported by FreeBSD and all other cores
+        match the frequency of CPU 0.
+        """
+        ret = []
+        num_cpus = cpu_count_logical()
+        for cpu in range(num_cpus):
+            try:
+                current, available_freq = cext.cpu_frequency(cpu)
+            except NotImplementedError:
+                continue
+            if available_freq:
+                try:
+                    min_freq = int(available_freq.split(" ")[-1].split("/")[0])
+                except(IndexError, ValueError):
+                    min_freq = None
+                try:
+                    max_freq = int(available_freq.split(" ")[0].split("/")[0])
+                except(IndexError, ValueError):
+                    max_freq = None
+            ret.append(_common.scpufreq(current, min_freq, max_freq))
+        return ret
+
+
+# =====================================================================
+#  --- other system functions
+# =====================================================================
+
+
+def boot_time():
+    """The system boot time expressed in seconds since the epoch."""
+    return cext.boot_time()
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    for item in rawlist:
+        user, tty, hostname, tstamp, pid = item
+        if pid == -1:
+            assert OPENBSD
+            pid = None
+        if tty == '~':
+            continue  # reboot or shutdown
+        nt = _common.suser(user, tty or None, hostname, tstamp, pid)
+        retlist.append(nt)
+    return retlist
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+@memoize
+def _pid_0_exists():
+    try:
+        Process(0).name()
+    except NoSuchProcess:
+        return False
+    except AccessDenied:
+        return True
+    else:
+        return True
+
+
+def pids():
+    """Returns a list of PIDs currently running on the system."""
+    ret = cext.pids()
+    if OPENBSD and (0 not in ret) and _pid_0_exists():
+        # On OpenBSD the kernel does not return PID 0 (neither does
+        # ps) but it's actually querable (Process(0) will succeed).
+        ret.insert(0, 0)
+    return ret
+
+
+if OPENBSD or NETBSD:
+    def pid_exists(pid):
+        """Return True if pid exists."""
+        exists = _psposix.pid_exists(pid)
+        if not exists:
+            # We do this because _psposix.pid_exists() lies in case of
+            # zombie processes.
+            return pid in pids()
+        else:
+            return True
+else:
+    pid_exists = _psposix.pid_exists
+
+
+def is_zombie(pid):
+    try:
+        st = cext.proc_oneshot_info(pid)[kinfo_proc_map['status']]
+        return st == cext.SZOMB
+    except Exception:
+        return False
+
+
+def wrap_exceptions(fun):
+    """Decorator which translates bare OSError exceptions into
+    NoSuchProcess and AccessDenied.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except ProcessLookupError:
+            if is_zombie(self.pid):
+                raise ZombieProcess(self.pid, self._name, self._ppid)
+            else:
+                raise NoSuchProcess(self.pid, self._name)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+        except OSError:
+            if self.pid == 0:
+                if 0 in pids():
+                    raise AccessDenied(self.pid, self._name)
+                else:
+                    raise
+            raise
+    return wrapper
+
+
+@contextlib.contextmanager
+def wrap_exceptions_procfs(inst):
+    """Same as above, for routines relying on reading /proc fs."""
+    try:
+        yield
+    except (ProcessLookupError, FileNotFoundError):
+        # ENOENT (no such file or directory) gets raised on open().
+        # ESRCH (no such process) can get raised on read() if
+        # process is gone in meantime.
+        if is_zombie(inst.pid):
+            raise ZombieProcess(inst.pid, inst._name, inst._ppid)
+        else:
+            raise NoSuchProcess(inst.pid, inst._name)
+    except PermissionError:
+        raise AccessDenied(inst.pid, inst._name)
+
+
+class Process(object):
+    """Wrapper class around underlying C implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+
+    def _assert_alive(self):
+        """Raise NSP if the process disappeared on us."""
+        # For those C function who do not raise NSP, possibly returning
+        # incorrect or incomplete result.
+        cext.proc_name(self.pid)
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def oneshot(self):
+        """Retrieves multiple process info in one shot as a raw tuple."""
+        ret = cext.proc_oneshot_info(self.pid)
+        assert len(ret) == len(kinfo_proc_map)
+        return ret
+
+    def oneshot_enter(self):
+        self.oneshot.cache_activate(self)
+
+    def oneshot_exit(self):
+        self.oneshot.cache_deactivate(self)
+
+    @wrap_exceptions
+    def name(self):
+        name = self.oneshot()[kinfo_proc_map['name']]
+        return name if name is not None else cext.proc_name(self.pid)
+
+    @wrap_exceptions
+    def exe(self):
+        if FREEBSD:
+            if self.pid == 0:
+                return ''  # else NSP
+            return cext.proc_exe(self.pid)
+        elif NETBSD:
+            if self.pid == 0:
+                # /proc/0 dir exists but /proc/0/exe doesn't
+                return ""
+            with wrap_exceptions_procfs(self):
+                return os.readlink("/proc/%s/exe" % self.pid)
+        else:
+            # OpenBSD: exe cannot be determined; references:
+            # https://chromium.googlesource.com/chromium/src/base/+/
+            #     master/base_paths_posix.cc
+            # We try our best guess by using which against the first
+            # cmdline arg (may return None).
+            cmdline = self.cmdline()
+            if cmdline:
+                return which(cmdline[0]) or ""
+            else:
+                return ""
+
+    @wrap_exceptions
+    def cmdline(self):
+        if OPENBSD and self.pid == 0:
+            return []  # ...else it crashes
+        elif NETBSD:
+            # XXX - most of the times the underlying sysctl() call on Net
+            # and Open BSD returns a truncated string.
+            # Also /proc/pid/cmdline behaves the same so it looks
+            # like this is a kernel bug.
+            try:
+                return cext.proc_cmdline(self.pid)
+            except OSError as err:
+                if err.errno == errno.EINVAL:
+                    if is_zombie(self.pid):
+                        raise ZombieProcess(self.pid, self._name, self._ppid)
+                    elif not pid_exists(self.pid):
+                        raise NoSuchProcess(self.pid, self._name, self._ppid)
+                    else:
+                        # XXX: this happens with unicode tests. It means the C
+                        # routine is unable to decode invalid unicode chars.
+                        return []
+                else:
+                    raise
+        else:
+            return cext.proc_cmdline(self.pid)
+
+    @wrap_exceptions
+    def environ(self):
+        return cext.proc_environ(self.pid)
+
+    @wrap_exceptions
+    def terminal(self):
+        tty_nr = self.oneshot()[kinfo_proc_map['ttynr']]
+        tmap = _psposix.get_terminal_map()
+        try:
+            return tmap[tty_nr]
+        except KeyError:
+            return None
+
+    @wrap_exceptions
+    def ppid(self):
+        self._ppid = self.oneshot()[kinfo_proc_map['ppid']]
+        return self._ppid
+
+    @wrap_exceptions
+    def uids(self):
+        rawtuple = self.oneshot()
+        return _common.puids(
+            rawtuple[kinfo_proc_map['real_uid']],
+            rawtuple[kinfo_proc_map['effective_uid']],
+            rawtuple[kinfo_proc_map['saved_uid']])
+
+    @wrap_exceptions
+    def gids(self):
+        rawtuple = self.oneshot()
+        return _common.pgids(
+            rawtuple[kinfo_proc_map['real_gid']],
+            rawtuple[kinfo_proc_map['effective_gid']],
+            rawtuple[kinfo_proc_map['saved_gid']])
+
+    @wrap_exceptions
+    def cpu_times(self):
+        rawtuple = self.oneshot()
+        return _common.pcputimes(
+            rawtuple[kinfo_proc_map['user_time']],
+            rawtuple[kinfo_proc_map['sys_time']],
+            rawtuple[kinfo_proc_map['ch_user_time']],
+            rawtuple[kinfo_proc_map['ch_sys_time']])
+
+    if FREEBSD:
+        @wrap_exceptions
+        def cpu_num(self):
+            return self.oneshot()[kinfo_proc_map['cpunum']]
+
+    @wrap_exceptions
+    def memory_info(self):
+        rawtuple = self.oneshot()
+        return pmem(
+            rawtuple[kinfo_proc_map['rss']],
+            rawtuple[kinfo_proc_map['vms']],
+            rawtuple[kinfo_proc_map['memtext']],
+            rawtuple[kinfo_proc_map['memdata']],
+            rawtuple[kinfo_proc_map['memstack']])
+
+    memory_full_info = memory_info
+
+    @wrap_exceptions
+    def create_time(self):
+        return self.oneshot()[kinfo_proc_map['create_time']]
+
+    @wrap_exceptions
+    def num_threads(self):
+        if HAS_PROC_NUM_THREADS:
+            # FreeBSD
+            return cext.proc_num_threads(self.pid)
+        else:
+            return len(self.threads())
+
+    @wrap_exceptions
+    def num_ctx_switches(self):
+        rawtuple = self.oneshot()
+        return _common.pctxsw(
+            rawtuple[kinfo_proc_map['ctx_switches_vol']],
+            rawtuple[kinfo_proc_map['ctx_switches_unvol']])
+
+    @wrap_exceptions
+    def threads(self):
+        # Note: on OpenSBD this (/dev/mem) requires root access.
+        rawlist = cext.proc_threads(self.pid)
+        retlist = []
+        for thread_id, utime, stime in rawlist:
+            ntuple = _common.pthread(thread_id, utime, stime)
+            retlist.append(ntuple)
+        if OPENBSD:
+            self._assert_alive()
+        return retlist
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        if kind not in conn_tmap:
+            raise ValueError("invalid %r kind argument; choose between %s"
+                             % (kind, ', '.join([repr(x) for x in conn_tmap])))
+
+        if NETBSD:
+            families, types = conn_tmap[kind]
+            ret = []
+            rawlist = cext.net_connections(self.pid)
+            for item in rawlist:
+                fd, fam, type, laddr, raddr, status, pid = item
+                assert pid == self.pid
+                if fam in families and type in types:
+                    nt = conn_to_ntuple(fd, fam, type, laddr, raddr, status,
+                                        TCP_STATUSES)
+                    ret.append(nt)
+            self._assert_alive()
+            return list(ret)
+
+        families, types = conn_tmap[kind]
+        rawlist = cext.proc_connections(self.pid, families, types)
+        ret = []
+        for item in rawlist:
+            fd, fam, type, laddr, raddr, status = item
+            nt = conn_to_ntuple(fd, fam, type, laddr, raddr, status,
+                                TCP_STATUSES)
+            ret.append(nt)
+
+        if OPENBSD:
+            self._assert_alive()
+
+        return ret
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        return _psposix.wait_pid(self.pid, timeout, self._name)
+
+    @wrap_exceptions
+    def nice_get(self):
+        return cext_posix.getpriority(self.pid)
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        return cext_posix.setpriority(self.pid, value)
+
+    @wrap_exceptions
+    def status(self):
+        code = self.oneshot()[kinfo_proc_map['status']]
+        # XXX is '?' legit? (we're not supposed to return it anyway)
+        return PROC_STATUSES.get(code, '?')
+
+    @wrap_exceptions
+    def io_counters(self):
+        rawtuple = self.oneshot()
+        return _common.pio(
+            rawtuple[kinfo_proc_map['read_io_count']],
+            rawtuple[kinfo_proc_map['write_io_count']],
+            -1,
+            -1)
+
+    @wrap_exceptions
+    def cwd(self):
+        """Return process current working directory."""
+        # sometimes we get an empty string, in which case we turn
+        # it into None
+        if OPENBSD and self.pid == 0:
+            return None  # ...else it would raise EINVAL
+        elif NETBSD or HAS_PROC_OPEN_FILES:
+            # FreeBSD < 8 does not support functions based on
+            # kinfo_getfile() and kinfo_getvmmap()
+            return cext.proc_cwd(self.pid) or None
+        else:
+            raise NotImplementedError(
+                "supported only starting from FreeBSD 8" if
+                FREEBSD else "")
+
+    nt_mmap_grouped = namedtuple(
+        'mmap', 'path rss, private, ref_count, shadow_count')
+    nt_mmap_ext = namedtuple(
+        'mmap', 'addr, perms path rss, private, ref_count, shadow_count')
+
+    def _not_implemented(self):
+        raise NotImplementedError
+
+    # FreeBSD < 8 does not support functions based on kinfo_getfile()
+    # and kinfo_getvmmap()
+    if HAS_PROC_OPEN_FILES:
+        @wrap_exceptions
+        def open_files(self):
+            """Return files opened by process as a list of namedtuples."""
+            rawlist = cext.proc_open_files(self.pid)
+            return [_common.popenfile(path, fd) for path, fd in rawlist]
+    else:
+        open_files = _not_implemented
+
+    # FreeBSD < 8 does not support functions based on kinfo_getfile()
+    # and kinfo_getvmmap()
+    if HAS_PROC_NUM_FDS:
+        @wrap_exceptions
+        def num_fds(self):
+            """Return the number of file descriptors opened by this process."""
+            ret = cext.proc_num_fds(self.pid)
+            if NETBSD:
+                self._assert_alive()
+            return ret
+    else:
+        num_fds = _not_implemented
+
+    # --- FreeBSD only APIs
+
+    if FREEBSD:
+
+        @wrap_exceptions
+        def cpu_affinity_get(self):
+            return cext.proc_cpu_affinity_get(self.pid)
+
+        @wrap_exceptions
+        def cpu_affinity_set(self, cpus):
+            # Pre-emptively check if CPUs are valid because the C
+            # function has a weird behavior in case of invalid CPUs,
+            # see: https://github.com/giampaolo/psutil/issues/586
+            allcpus = tuple(range(len(per_cpu_times())))
+            for cpu in cpus:
+                if cpu not in allcpus:
+                    raise ValueError("invalid CPU #%i (choose between %s)"
+                                     % (cpu, allcpus))
+            try:
+                cext.proc_cpu_affinity_set(self.pid, cpus)
+            except OSError as err:
+                # 'man cpuset_setaffinity' about EDEADLK:
+                # <<the call would leave a thread without a valid CPU to run
+                # on because the set does not overlap with the thread's
+                # anonymous mask>>
+                if err.errno in (errno.EINVAL, errno.EDEADLK):
+                    for cpu in cpus:
+                        if cpu not in allcpus:
+                            raise ValueError(
+                                "invalid CPU #%i (choose between %s)" % (
+                                    cpu, allcpus))
+                raise
+
+        @wrap_exceptions
+        def memory_maps(self):
+            return cext.proc_memory_maps(self.pid)
+
+        @wrap_exceptions
+        def rlimit(self, resource, limits=None):
+            if limits is None:
+                return cext.proc_getrlimit(self.pid, resource)
+            else:
+                if len(limits) != 2:
+                    raise ValueError(
+                        "second argument must be a (soft, hard) tuple, "
+                        "got %s" % repr(limits))
+                soft, hard = limits
+                return cext.proc_setrlimit(self.pid, resource, soft, hard)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pslinux.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pslinux.py
new file mode 100644
index 0000000000000000000000000000000000000000..683cef5d88f1d93898c62fe14eba476d28bdc027
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pslinux.py
@@ -0,0 +1,2096 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Linux platform implementation."""
+
+from __future__ import division
+
+import base64
+import collections
+import errno
+import functools
+import glob
+import os
+import re
+import socket
+import struct
+import sys
+import traceback
+import warnings
+from collections import defaultdict
+from collections import namedtuple
+
+from . import _common
+from . import _psposix
+from . import _psutil_linux as cext
+from . import _psutil_posix as cext_posix
+from ._common import AccessDenied
+from ._common import debug
+from ._common import decode
+from ._common import get_procfs_path
+from ._common import isfile_strict
+from ._common import memoize
+from ._common import memoize_when_activated
+from ._common import NIC_DUPLEX_FULL
+from ._common import NIC_DUPLEX_HALF
+from ._common import NIC_DUPLEX_UNKNOWN
+from ._common import NoSuchProcess
+from ._common import open_binary
+from ._common import open_text
+from ._common import parse_environ_block
+from ._common import path_exists_strict
+from ._common import supports_ipv6
+from ._common import usage_percent
+from ._common import ZombieProcess
+from ._compat import b
+from ._compat import basestring
+from ._compat import FileNotFoundError
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import PY3
+
+if sys.version_info >= (3, 4):
+    import enum
+else:
+    enum = None
+
+
+__extra__all__ = [
+    #
+    'PROCFS_PATH',
+    # io prio constants
+    "IOPRIO_CLASS_NONE", "IOPRIO_CLASS_RT", "IOPRIO_CLASS_BE",
+    "IOPRIO_CLASS_IDLE",
+    # connection status constants
+    "CONN_ESTABLISHED", "CONN_SYN_SENT", "CONN_SYN_RECV", "CONN_FIN_WAIT1",
+    "CONN_FIN_WAIT2", "CONN_TIME_WAIT", "CONN_CLOSE", "CONN_CLOSE_WAIT",
+    "CONN_LAST_ACK", "CONN_LISTEN", "CONN_CLOSING", ]
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+
+POWER_SUPPLY_PATH = "/sys/class/power_supply"
+HAS_SMAPS = os.path.exists('/proc/%s/smaps' % os.getpid())
+HAS_PRLIMIT = hasattr(cext, "linux_prlimit")
+HAS_PROC_IO_PRIORITY = hasattr(cext, "proc_ioprio_get")
+HAS_CPU_AFFINITY = hasattr(cext, "proc_cpu_affinity_get")
+_DEFAULT = object()
+
+# Number of clock ticks per second
+CLOCK_TICKS = os.sysconf("SC_CLK_TCK")
+PAGESIZE = os.sysconf("SC_PAGE_SIZE")
+BOOT_TIME = None  # set later
+# Used when reading "big" files, namely /proc/{pid}/smaps and /proc/net/*.
+# On Python 2, using a buffer with open() for such files may result in a
+# speedup, see: https://github.com/giampaolo/psutil/issues/708
+BIGFILE_BUFFERING = -1 if PY3 else 8192
+LITTLE_ENDIAN = sys.byteorder == 'little'
+
+# "man iostat" states that sectors are equivalent with blocks and have
+# a size of 512 bytes. Despite this value can be queried at runtime
+# via /sys/block/{DISK}/queue/hw_sector_size and results may vary
+# between 1k, 2k, or 4k... 512 appears to be a magic constant used
+# throughout Linux source code:
+# * https://stackoverflow.com/a/38136179/376587
+# * https://lists.gt.net/linux/kernel/2241060
+# * https://github.com/giampaolo/psutil/issues/1305
+# * https://github.com/torvalds/linux/blob/
+#     4f671fe2f9523a1ea206f63fe60a7c7b3a56d5c7/include/linux/bio.h#L99
+# * https://lkml.org/lkml/2015/8/17/234
+DISK_SECTOR_SIZE = 512
+
+if enum is None:
+    AF_LINK = socket.AF_PACKET
+else:
+    AddressFamily = enum.IntEnum('AddressFamily',
+                                 {'AF_LINK': int(socket.AF_PACKET)})
+    AF_LINK = AddressFamily.AF_LINK
+
+# ioprio_* constants http://linux.die.net/man/2/ioprio_get
+if enum is None:
+    IOPRIO_CLASS_NONE = 0
+    IOPRIO_CLASS_RT = 1
+    IOPRIO_CLASS_BE = 2
+    IOPRIO_CLASS_IDLE = 3
+else:
+    class IOPriority(enum.IntEnum):
+        IOPRIO_CLASS_NONE = 0
+        IOPRIO_CLASS_RT = 1
+        IOPRIO_CLASS_BE = 2
+        IOPRIO_CLASS_IDLE = 3
+
+    globals().update(IOPriority.__members__)
+
+# See:
+# https://github.com/torvalds/linux/blame/master/fs/proc/array.c
+# ...and (TASK_* constants):
+# https://github.com/torvalds/linux/blob/master/include/linux/sched.h
+PROC_STATUSES = {
+    "R": _common.STATUS_RUNNING,
+    "S": _common.STATUS_SLEEPING,
+    "D": _common.STATUS_DISK_SLEEP,
+    "T": _common.STATUS_STOPPED,
+    "t": _common.STATUS_TRACING_STOP,
+    "Z": _common.STATUS_ZOMBIE,
+    "X": _common.STATUS_DEAD,
+    "x": _common.STATUS_DEAD,
+    "K": _common.STATUS_WAKE_KILL,
+    "W": _common.STATUS_WAKING,
+    "I": _common.STATUS_IDLE,
+    "P": _common.STATUS_PARKED,
+}
+
+# https://github.com/torvalds/linux/blob/master/include/net/tcp_states.h
+TCP_STATUSES = {
+    "01": _common.CONN_ESTABLISHED,
+    "02": _common.CONN_SYN_SENT,
+    "03": _common.CONN_SYN_RECV,
+    "04": _common.CONN_FIN_WAIT1,
+    "05": _common.CONN_FIN_WAIT2,
+    "06": _common.CONN_TIME_WAIT,
+    "07": _common.CONN_CLOSE,
+    "08": _common.CONN_CLOSE_WAIT,
+    "09": _common.CONN_LAST_ACK,
+    "0A": _common.CONN_LISTEN,
+    "0B": _common.CONN_CLOSING
+}
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.virtual_memory()
+svmem = namedtuple(
+    'svmem', ['total', 'available', 'percent', 'used', 'free',
+              'active', 'inactive', 'buffers', 'cached', 'shared', 'slab'])
+# psutil.disk_io_counters()
+sdiskio = namedtuple(
+    'sdiskio', ['read_count', 'write_count',
+                'read_bytes', 'write_bytes',
+                'read_time', 'write_time',
+                'read_merged_count', 'write_merged_count',
+                'busy_time'])
+# psutil.Process().open_files()
+popenfile = namedtuple(
+    'popenfile', ['path', 'fd', 'position', 'mode', 'flags'])
+# psutil.Process().memory_info()
+pmem = namedtuple('pmem', 'rss vms shared text lib data dirty')
+# psutil.Process().memory_full_info()
+pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', 'pss', 'swap'))
+# psutil.Process().memory_maps(grouped=True)
+pmmap_grouped = namedtuple(
+    'pmmap_grouped',
+    ['path', 'rss', 'size', 'pss', 'shared_clean', 'shared_dirty',
+     'private_clean', 'private_dirty', 'referenced', 'anonymous', 'swap'])
+# psutil.Process().memory_maps(grouped=False)
+pmmap_ext = namedtuple(
+    'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields))
+# psutil.Process.io_counters()
+pio = namedtuple('pio', ['read_count', 'write_count',
+                         'read_bytes', 'write_bytes',
+                         'read_chars', 'write_chars'])
+# psutil.Process.cpu_times()
+pcputimes = namedtuple('pcputimes',
+                       ['user', 'system', 'children_user', 'children_system',
+                        'iowait'])
+
+
+# =====================================================================
+# --- utils
+# =====================================================================
+
+
+def readlink(path):
+    """Wrapper around os.readlink()."""
+    assert isinstance(path, basestring), path
+    path = os.readlink(path)
+    # readlink() might return paths containing null bytes ('\x00')
+    # resulting in "TypeError: must be encoded string without NULL
+    # bytes, not str" errors when the string is passed to other
+    # fs-related functions (os.*, open(), ...).
+    # Apparently everything after '\x00' is garbage (we can have
+    # ' (deleted)', 'new' and possibly others), see:
+    # https://github.com/giampaolo/psutil/issues/717
+    path = path.split('\x00')[0]
+    # Certain paths have ' (deleted)' appended. Usually this is
+    # bogus as the file actually exists. Even if it doesn't we
+    # don't care.
+    if path.endswith(' (deleted)') and not path_exists_strict(path):
+        path = path[:-10]
+    return path
+
+
+def file_flags_to_mode(flags):
+    """Convert file's open() flags into a readable string.
+    Used by Process.open_files().
+    """
+    modes_map = {os.O_RDONLY: 'r', os.O_WRONLY: 'w', os.O_RDWR: 'w+'}
+    mode = modes_map[flags & (os.O_RDONLY | os.O_WRONLY | os.O_RDWR)]
+    if flags & os.O_APPEND:
+        mode = mode.replace('w', 'a', 1)
+    mode = mode.replace('w+', 'r+')
+    # possible values: r, w, a, r+, a+
+    return mode
+
+
+def is_storage_device(name):
+    """Return True if the given name refers to a root device (e.g.
+    "sda", "nvme0n1") as opposed to a logical partition (e.g.  "sda1",
+    "nvme0n1p1"). If name is a virtual device (e.g. "loop1", "ram")
+    return True.
+    """
+    # Readapted from iostat source code, see:
+    # https://github.com/sysstat/sysstat/blob/
+    #     97912938cd476645b267280069e83b1c8dc0e1c7/common.c#L208
+    # Some devices may have a slash in their name (e.g. cciss/c0d0...).
+    name = name.replace('/', '!')
+    including_virtual = True
+    if including_virtual:
+        path = "/sys/block/%s" % name
+    else:
+        path = "/sys/block/%s/device" % name
+    return os.access(path, os.F_OK)
+
+
+@memoize
+def set_scputimes_ntuple(procfs_path):
+    """Set a namedtuple of variable fields depending on the CPU times
+    available on this Linux kernel version which may be:
+    (user, nice, system, idle, iowait, irq, softirq, [steal, [guest,
+     [guest_nice]]])
+    Used by cpu_times() function.
+    """
+    global scputimes
+    with open_binary('%s/stat' % procfs_path) as f:
+        values = f.readline().split()[1:]
+    fields = ['user', 'nice', 'system', 'idle', 'iowait', 'irq', 'softirq']
+    vlen = len(values)
+    if vlen >= 8:
+        # Linux >= 2.6.11
+        fields.append('steal')
+    if vlen >= 9:
+        # Linux >= 2.6.24
+        fields.append('guest')
+    if vlen >= 10:
+        # Linux >= 3.2.0
+        fields.append('guest_nice')
+    scputimes = namedtuple('scputimes', fields)
+
+
+def cat(fname, fallback=_DEFAULT, binary=True):
+    """Return file content.
+    fallback: the value returned in case the file does not exist or
+              cannot be read
+    binary: whether to open the file in binary or text mode.
+    """
+    try:
+        with open_binary(fname) if binary else open_text(fname) as f:
+            return f.read().strip()
+    except (IOError, OSError):
+        if fallback is not _DEFAULT:
+            return fallback
+        else:
+            raise
+
+
+try:
+    set_scputimes_ntuple("/proc")
+except Exception:  # pragma: no cover
+    # Don't want to crash at import time.
+    traceback.print_exc()
+    scputimes = namedtuple('scputimes', 'user system idle')(0.0, 0.0, 0.0)
+
+
+# =====================================================================
+# --- system memory
+# =====================================================================
+
+
+def calculate_avail_vmem(mems):
+    """Fallback for kernels < 3.14 where /proc/meminfo does not provide
+    "MemAvailable:" column, see:
+    https://blog.famzah.net/2014/09/24/
+    This code reimplements the algorithm outlined here:
+    https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/
+        commit/?id=34e431b0ae398fc54ea69ff85ec700722c9da773
+
+    XXX: on recent kernels this calculation differs by ~1.5% than
+    "MemAvailable:" as it's calculated slightly differently, see:
+    https://gitlab.com/procps-ng/procps/issues/42
+    https://github.com/famzah/linux-memavailable-procfs/issues/2
+    It is still way more realistic than doing (free + cached) though.
+    """
+    # Fallback for very old distros. According to
+    # https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/
+    #     commit/?id=34e431b0ae398fc54ea69ff85ec700722c9da773
+    # ...long ago "avail" was calculated as (free + cached).
+    # We might fallback in such cases:
+    # "Active(file)" not available: 2.6.28 / Dec 2008
+    # "Inactive(file)" not available: 2.6.28 / Dec 2008
+    # "SReclaimable:" not available: 2.6.19 / Nov 2006
+    # /proc/zoneinfo not available: 2.6.13 / Aug 2005
+    free = mems[b'MemFree:']
+    fallback = free + mems.get(b"Cached:", 0)
+    try:
+        lru_active_file = mems[b'Active(file):']
+        lru_inactive_file = mems[b'Inactive(file):']
+        slab_reclaimable = mems[b'SReclaimable:']
+    except KeyError:
+        return fallback
+    try:
+        f = open_binary('%s/zoneinfo' % get_procfs_path())
+    except IOError:
+        return fallback  # kernel 2.6.13
+
+    watermark_low = 0
+    with f:
+        for line in f:
+            line = line.strip()
+            if line.startswith(b'low'):
+                watermark_low += int(line.split()[1])
+    watermark_low *= PAGESIZE
+
+    avail = free - watermark_low
+    pagecache = lru_active_file + lru_inactive_file
+    pagecache -= min(pagecache / 2, watermark_low)
+    avail += pagecache
+    avail += slab_reclaimable - min(slab_reclaimable / 2.0, watermark_low)
+    return int(avail)
+
+
+def virtual_memory():
+    """Report virtual memory stats.
+    This implementation matches "free" and "vmstat -s" cmdline
+    utility values and procps-ng-3.3.12 source was used as a reference
+    (2016-09-18):
+    https://gitlab.com/procps-ng/procps/blob/
+        24fd2605c51fccc375ab0287cec33aa767f06718/proc/sysinfo.c
+    For reference, procps-ng-3.3.10 is the version available on Ubuntu
+    16.04.
+
+    Note about "available" memory: up until psutil 4.3 it was
+    calculated as "avail = (free + buffers + cached)". Now
+    "MemAvailable:" column (kernel 3.14) from /proc/meminfo is used as
+    it's more accurate.
+    That matches "available" column in newer versions of "free".
+    """
+    missing_fields = []
+    mems = {}
+    with open_binary('%s/meminfo' % get_procfs_path()) as f:
+        for line in f:
+            fields = line.split()
+            mems[fields[0]] = int(fields[1]) * 1024
+
+    # /proc doc states that the available fields in /proc/meminfo vary
+    # by architecture and compile options, but these 3 values are also
+    # returned by sysinfo(2); as such we assume they are always there.
+    total = mems[b'MemTotal:']
+    free = mems[b'MemFree:']
+    try:
+        buffers = mems[b'Buffers:']
+    except KeyError:
+        # https://github.com/giampaolo/psutil/issues/1010
+        buffers = 0
+        missing_fields.append('buffers')
+    try:
+        cached = mems[b"Cached:"]
+    except KeyError:
+        cached = 0
+        missing_fields.append('cached')
+    else:
+        # "free" cmdline utility sums reclaimable to cached.
+        # Older versions of procps used to add slab memory instead.
+        # This got changed in:
+        # https://gitlab.com/procps-ng/procps/commit/
+        #     05d751c4f076a2f0118b914c5e51cfbb4762ad8e
+        cached += mems.get(b"SReclaimable:", 0)  # since kernel 2.6.19
+
+    try:
+        shared = mems[b'Shmem:']  # since kernel 2.6.32
+    except KeyError:
+        try:
+            shared = mems[b'MemShared:']  # kernels 2.4
+        except KeyError:
+            shared = 0
+            missing_fields.append('shared')
+
+    try:
+        active = mems[b"Active:"]
+    except KeyError:
+        active = 0
+        missing_fields.append('active')
+
+    try:
+        inactive = mems[b"Inactive:"]
+    except KeyError:
+        try:
+            inactive = \
+                mems[b"Inact_dirty:"] + \
+                mems[b"Inact_clean:"] + \
+                mems[b"Inact_laundry:"]
+        except KeyError:
+            inactive = 0
+            missing_fields.append('inactive')
+
+    try:
+        slab = mems[b"Slab:"]
+    except KeyError:
+        slab = 0
+
+    used = total - free - cached - buffers
+    if used < 0:
+        # May be symptomatic of running within a LCX container where such
+        # values will be dramatically distorted over those of the host.
+        used = total - free
+
+    # - starting from 4.4.0 we match free's "available" column.
+    #   Before 4.4.0 we calculated it as (free + buffers + cached)
+    #   which matched htop.
+    # - free and htop available memory differs as per:
+    #   http://askubuntu.com/a/369589
+    #   http://unix.stackexchange.com/a/65852/168884
+    # - MemAvailable has been introduced in kernel 3.14
+    try:
+        avail = mems[b'MemAvailable:']
+    except KeyError:
+        avail = calculate_avail_vmem(mems)
+
+    if avail < 0:
+        avail = 0
+        missing_fields.append('available')
+
+    # If avail is greater than total or our calculation overflows,
+    # that's symptomatic of running within a LCX container where such
+    # values will be dramatically distorted over those of the host.
+    # https://gitlab.com/procps-ng/procps/blob/
+    #     24fd2605c51fccc375ab0287cec33aa767f06718/proc/sysinfo.c#L764
+    if avail > total:
+        avail = free
+
+    percent = usage_percent((total - avail), total, round_=1)
+
+    # Warn about missing metrics which are set to 0.
+    if missing_fields:
+        msg = "%s memory stats couldn't be determined and %s set to 0" % (
+            ", ".join(missing_fields),
+            "was" if len(missing_fields) == 1 else "were")
+        warnings.warn(msg, RuntimeWarning)
+
+    return svmem(total, avail, percent, used, free,
+                 active, inactive, buffers, cached, shared, slab)
+
+
+def swap_memory():
+    """Return swap memory metrics."""
+    mems = {}
+    with open_binary('%s/meminfo' % get_procfs_path()) as f:
+        for line in f:
+            fields = line.split()
+            mems[fields[0]] = int(fields[1]) * 1024
+    # We prefer /proc/meminfo over sysinfo() syscall so that
+    # psutil.PROCFS_PATH can be used in order to allow retrieval
+    # for linux containers, see:
+    # https://github.com/giampaolo/psutil/issues/1015
+    try:
+        total = mems[b'SwapTotal:']
+        free = mems[b'SwapFree:']
+    except KeyError:
+        _, _, _, _, total, free, unit_multiplier = cext.linux_sysinfo()
+        total *= unit_multiplier
+        free *= unit_multiplier
+
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    # get pgin/pgouts
+    try:
+        f = open_binary("%s/vmstat" % get_procfs_path())
+    except IOError as err:
+        # see https://github.com/giampaolo/psutil/issues/722
+        msg = "'sin' and 'sout' swap memory stats couldn't " \
+              "be determined and were set to 0 (%s)" % str(err)
+        warnings.warn(msg, RuntimeWarning)
+        sin = sout = 0
+    else:
+        with f:
+            sin = sout = None
+            for line in f:
+                # values are expressed in 4 kilo bytes, we want
+                # bytes instead
+                if line.startswith(b'pswpin'):
+                    sin = int(line.split(b' ')[1]) * 4 * 1024
+                elif line.startswith(b'pswpout'):
+                    sout = int(line.split(b' ')[1]) * 4 * 1024
+                if sin is not None and sout is not None:
+                    break
+            else:
+                # we might get here when dealing with exotic Linux
+                # flavors, see:
+                # https://github.com/giampaolo/psutil/issues/313
+                msg = "'sin' and 'sout' swap memory stats couldn't " \
+                      "be determined and were set to 0"
+                warnings.warn(msg, RuntimeWarning)
+                sin = sout = 0
+    return _common.sswap(total, used, free, percent, sin, sout)
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return a named tuple representing the following system-wide
+    CPU times:
+    (user, nice, system, idle, iowait, irq, softirq [steal, [guest,
+     [guest_nice]]])
+    Last 3 fields may not be available on all Linux kernel versions.
+    """
+    procfs_path = get_procfs_path()
+    set_scputimes_ntuple(procfs_path)
+    with open_binary('%s/stat' % procfs_path) as f:
+        values = f.readline().split()
+    fields = values[1:len(scputimes._fields) + 1]
+    fields = [float(x) / CLOCK_TICKS for x in fields]
+    return scputimes(*fields)
+
+
+def per_cpu_times():
+    """Return a list of namedtuple representing the CPU times
+    for every CPU available on the system.
+    """
+    procfs_path = get_procfs_path()
+    set_scputimes_ntuple(procfs_path)
+    cpus = []
+    with open_binary('%s/stat' % procfs_path) as f:
+        # get rid of the first line which refers to system wide CPU stats
+        f.readline()
+        for line in f:
+            if line.startswith(b'cpu'):
+                values = line.split()
+                fields = values[1:len(scputimes._fields) + 1]
+                fields = [float(x) / CLOCK_TICKS for x in fields]
+                entry = scputimes(*fields)
+                cpus.append(entry)
+        return cpus
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    try:
+        return os.sysconf("SC_NPROCESSORS_ONLN")
+    except ValueError:
+        # as a second fallback we try to parse /proc/cpuinfo
+        num = 0
+        with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
+            for line in f:
+                if line.lower().startswith(b'processor'):
+                    num += 1
+
+        # unknown format (e.g. amrel/sparc architectures), see:
+        # https://github.com/giampaolo/psutil/issues/200
+        # try to parse /proc/stat as a last resort
+        if num == 0:
+            search = re.compile(r'cpu\d')
+            with open_text('%s/stat' % get_procfs_path()) as f:
+                for line in f:
+                    line = line.split(' ')[0]
+                    if search.match(line):
+                        num += 1
+
+        if num == 0:
+            # mimic os.cpu_count()
+            return None
+        return num
+
+
+def cpu_count_physical():
+    """Return the number of physical cores in the system."""
+    # Method #1
+    ls = set()
+    # These 2 files are the same but */core_cpus_list is newer while
+    # */thread_siblings_list is deprecated and may disappear in the future.
+    # https://www.kernel.org/doc/Documentation/admin-guide/cputopology.rst
+    # https://github.com/giampaolo/psutil/pull/1727#issuecomment-707624964
+    # https://lkml.org/lkml/2019/2/26/41
+    p1 = "/sys/devices/system/cpu/cpu[0-9]*/topology/core_cpus_list"
+    p2 = "/sys/devices/system/cpu/cpu[0-9]*/topology/thread_siblings_list"
+    for path in glob.glob(p1) or glob.glob(p2):
+        with open_binary(path) as f:
+            ls.add(f.read().strip())
+    result = len(ls)
+    if result != 0:
+        return result
+
+    # Method #2
+    mapping = {}
+    current_info = {}
+    with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
+        for line in f:
+            line = line.strip().lower()
+            if not line:
+                # new section
+                try:
+                    mapping[current_info[b'physical id']] = \
+                        current_info[b'cpu cores']
+                except KeyError:
+                    pass
+                current_info = {}
+            else:
+                # ongoing section
+                if line.startswith((b'physical id', b'cpu cores')):
+                    key, value = line.split(b'\t:', 1)
+                    current_info[key] = int(value)
+
+    result = sum(mapping.values())
+    return result or None  # mimic os.cpu_count()
+
+
+def cpu_stats():
+    """Return various CPU stats as a named tuple."""
+    with open_binary('%s/stat' % get_procfs_path()) as f:
+        ctx_switches = None
+        interrupts = None
+        soft_interrupts = None
+        for line in f:
+            if line.startswith(b'ctxt'):
+                ctx_switches = int(line.split()[1])
+            elif line.startswith(b'intr'):
+                interrupts = int(line.split()[1])
+            elif line.startswith(b'softirq'):
+                soft_interrupts = int(line.split()[1])
+            if ctx_switches is not None and soft_interrupts is not None \
+                    and interrupts is not None:
+                break
+    syscalls = 0
+    return _common.scpustats(
+        ctx_switches, interrupts, soft_interrupts, syscalls)
+
+
+if os.path.exists("/sys/devices/system/cpu/cpufreq/policy0") or \
+        os.path.exists("/sys/devices/system/cpu/cpu0/cpufreq"):
+    def cpu_freq():
+        """Return frequency metrics for all CPUs.
+        Contrarily to other OSes, Linux updates these values in
+        real-time.
+        """
+        def get_path(num):
+            for p in ("/sys/devices/system/cpu/cpufreq/policy%s" % num,
+                      "/sys/devices/system/cpu/cpu%s/cpufreq" % num):
+                if os.path.exists(p):
+                    return p
+
+        ret = []
+        for n in range(cpu_count_logical()):
+            path = get_path(n)
+            if not path:
+                continue
+
+            pjoin = os.path.join
+            curr = cat(pjoin(path, "scaling_cur_freq"), fallback=None)
+            if curr is None:
+                # Likely an old RedHat, see:
+                # https://github.com/giampaolo/psutil/issues/1071
+                curr = cat(pjoin(path, "cpuinfo_cur_freq"), fallback=None)
+                if curr is None:
+                    raise NotImplementedError(
+                        "can't find current frequency file")
+            curr = int(curr) / 1000
+            max_ = int(cat(pjoin(path, "scaling_max_freq"))) / 1000
+            min_ = int(cat(pjoin(path, "scaling_min_freq"))) / 1000
+            ret.append(_common.scpufreq(curr, min_, max_))
+        return ret
+
+elif os.path.exists("/proc/cpuinfo"):
+    def cpu_freq():
+        """Alternate implementation using /proc/cpuinfo.
+        min and max frequencies are not available and are set to None.
+        """
+        ret = []
+        with open_binary('%s/cpuinfo' % get_procfs_path()) as f:
+            for line in f:
+                if line.lower().startswith(b'cpu mhz'):
+                    key, value = line.split(b':', 1)
+                    ret.append(_common.scpufreq(float(value), 0., 0.))
+        return ret
+
+else:
+    def cpu_freq():
+        """Dummy implementation when none of the above files are present.
+        """
+        return []
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+net_if_addrs = cext_posix.net_if_addrs
+
+
+class _Ipv6UnsupportedError(Exception):
+    pass
+
+
+class Connections:
+    """A wrapper on top of /proc/net/* files, retrieving per-process
+    and system-wide open connections (TCP, UDP, UNIX) similarly to
+    "netstat -an".
+
+    Note: in case of UNIX sockets we're only able to determine the
+    local endpoint/path, not the one it's connected to.
+    According to [1] it would be possible but not easily.
+
+    [1] http://serverfault.com/a/417946
+    """
+
+    def __init__(self):
+        # The string represents the basename of the corresponding
+        # /proc/net/{proto_name} file.
+        tcp4 = ("tcp", socket.AF_INET, socket.SOCK_STREAM)
+        tcp6 = ("tcp6", socket.AF_INET6, socket.SOCK_STREAM)
+        udp4 = ("udp", socket.AF_INET, socket.SOCK_DGRAM)
+        udp6 = ("udp6", socket.AF_INET6, socket.SOCK_DGRAM)
+        unix = ("unix", socket.AF_UNIX, None)
+        self.tmap = {
+            "all": (tcp4, tcp6, udp4, udp6, unix),
+            "tcp": (tcp4, tcp6),
+            "tcp4": (tcp4,),
+            "tcp6": (tcp6,),
+            "udp": (udp4, udp6),
+            "udp4": (udp4,),
+            "udp6": (udp6,),
+            "unix": (unix,),
+            "inet": (tcp4, tcp6, udp4, udp6),
+            "inet4": (tcp4, udp4),
+            "inet6": (tcp6, udp6),
+        }
+        self._procfs_path = None
+
+    def get_proc_inodes(self, pid):
+        inodes = defaultdict(list)
+        for fd in os.listdir("%s/%s/fd" % (self._procfs_path, pid)):
+            try:
+                inode = readlink("%s/%s/fd/%s" % (self._procfs_path, pid, fd))
+            except (FileNotFoundError, ProcessLookupError):
+                # ENOENT == file which is gone in the meantime;
+                # os.stat('/proc/%s' % self.pid) will be done later
+                # to force NSP (if it's the case)
+                continue
+            except OSError as err:
+                if err.errno == errno.EINVAL:
+                    # not a link
+                    continue
+                raise
+            else:
+                if inode.startswith('socket:['):
+                    # the process is using a socket
+                    inode = inode[8:][:-1]
+                    inodes[inode].append((pid, int(fd)))
+        return inodes
+
+    def get_all_inodes(self):
+        inodes = {}
+        for pid in pids():
+            try:
+                inodes.update(self.get_proc_inodes(pid))
+            except (FileNotFoundError, ProcessLookupError, PermissionError):
+                # os.listdir() is gonna raise a lot of access denied
+                # exceptions in case of unprivileged user; that's fine
+                # as we'll just end up returning a connection with PID
+                # and fd set to None anyway.
+                # Both netstat -an and lsof does the same so it's
+                # unlikely we can do any better.
+                # ENOENT just means a PID disappeared on us.
+                continue
+        return inodes
+
+    @staticmethod
+    def decode_address(addr, family):
+        """Accept an "ip:port" address as displayed in /proc/net/*
+        and convert it into a human readable form, like:
+
+        "0500000A:0016" -> ("10.0.0.5", 22)
+        "0000000000000000FFFF00000100007F:9E49" -> ("::ffff:127.0.0.1", 40521)
+
+        The IP address portion is a little or big endian four-byte
+        hexadecimal number; that is, the least significant byte is listed
+        first, so we need to reverse the order of the bytes to convert it
+        to an IP address.
+        The port is represented as a two-byte hexadecimal number.
+
+        Reference:
+        http://linuxdevcenter.com/pub/a/linux/2000/11/16/LinuxAdmin.html
+        """
+        ip, port = addr.split(':')
+        port = int(port, 16)
+        # this usually refers to a local socket in listen mode with
+        # no end-points connected
+        if not port:
+            return ()
+        if PY3:
+            ip = ip.encode('ascii')
+        if family == socket.AF_INET:
+            # see: https://github.com/giampaolo/psutil/issues/201
+            if LITTLE_ENDIAN:
+                ip = socket.inet_ntop(family, base64.b16decode(ip)[::-1])
+            else:
+                ip = socket.inet_ntop(family, base64.b16decode(ip))
+        else:  # IPv6
+            ip = base64.b16decode(ip)
+            try:
+                # see: https://github.com/giampaolo/psutil/issues/201
+                if LITTLE_ENDIAN:
+                    ip = socket.inet_ntop(
+                        socket.AF_INET6,
+                        struct.pack('>4I', *struct.unpack('<4I', ip)))
+                else:
+                    ip = socket.inet_ntop(
+                        socket.AF_INET6,
+                        struct.pack('<4I', *struct.unpack('<4I', ip)))
+            except ValueError:
+                # see: https://github.com/giampaolo/psutil/issues/623
+                if not supports_ipv6():
+                    raise _Ipv6UnsupportedError
+                else:
+                    raise
+        return _common.addr(ip, port)
+
+    @staticmethod
+    def process_inet(file, family, type_, inodes, filter_pid=None):
+        """Parse /proc/net/tcp* and /proc/net/udp* files."""
+        if file.endswith('6') and not os.path.exists(file):
+            # IPv6 not supported
+            return
+        with open_text(file, buffering=BIGFILE_BUFFERING) as f:
+            f.readline()  # skip the first line
+            for lineno, line in enumerate(f, 1):
+                try:
+                    _, laddr, raddr, status, _, _, _, _, _, inode = \
+                        line.split()[:10]
+                except ValueError:
+                    raise RuntimeError(
+                        "error while parsing %s; malformed line %s %r" % (
+                            file, lineno, line))
+                if inode in inodes:
+                    # # We assume inet sockets are unique, so we error
+                    # # out if there are multiple references to the
+                    # # same inode. We won't do this for UNIX sockets.
+                    # if len(inodes[inode]) > 1 and family != socket.AF_UNIX:
+                    #     raise ValueError("ambiguos inode with multiple "
+                    #                      "PIDs references")
+                    pid, fd = inodes[inode][0]
+                else:
+                    pid, fd = None, -1
+                if filter_pid is not None and filter_pid != pid:
+                    continue
+                else:
+                    if type_ == socket.SOCK_STREAM:
+                        status = TCP_STATUSES[status]
+                    else:
+                        status = _common.CONN_NONE
+                    try:
+                        laddr = Connections.decode_address(laddr, family)
+                        raddr = Connections.decode_address(raddr, family)
+                    except _Ipv6UnsupportedError:
+                        continue
+                    yield (fd, family, type_, laddr, raddr, status, pid)
+
+    @staticmethod
+    def process_unix(file, family, inodes, filter_pid=None):
+        """Parse /proc/net/unix files."""
+        with open_text(file, buffering=BIGFILE_BUFFERING) as f:
+            f.readline()  # skip the first line
+            for line in f:
+                tokens = line.split()
+                try:
+                    _, _, _, _, type_, _, inode = tokens[0:7]
+                except ValueError:
+                    if ' ' not in line:
+                        # see: https://github.com/giampaolo/psutil/issues/766
+                        continue
+                    raise RuntimeError(
+                        "error while parsing %s; malformed line %r" % (
+                            file, line))
+                if inode in inodes:
+                    # With UNIX sockets we can have a single inode
+                    # referencing many file descriptors.
+                    pairs = inodes[inode]
+                else:
+                    pairs = [(None, -1)]
+                for pid, fd in pairs:
+                    if filter_pid is not None and filter_pid != pid:
+                        continue
+                    else:
+                        if len(tokens) == 8:
+                            path = tokens[-1]
+                        else:
+                            path = ""
+                        type_ = _common.socktype_to_enum(int(type_))
+                        # XXX: determining the remote endpoint of a
+                        # UNIX socket on Linux is not possible, see:
+                        # https://serverfault.com/questions/252723/
+                        raddr = ""
+                        status = _common.CONN_NONE
+                        yield (fd, family, type_, path, raddr, status, pid)
+
+    def retrieve(self, kind, pid=None):
+        if kind not in self.tmap:
+            raise ValueError("invalid %r kind argument; choose between %s"
+                             % (kind, ', '.join([repr(x) for x in self.tmap])))
+        self._procfs_path = get_procfs_path()
+        if pid is not None:
+            inodes = self.get_proc_inodes(pid)
+            if not inodes:
+                # no connections for this process
+                return []
+        else:
+            inodes = self.get_all_inodes()
+        ret = set()
+        for proto_name, family, type_ in self.tmap[kind]:
+            path = "%s/net/%s" % (self._procfs_path, proto_name)
+            if family in (socket.AF_INET, socket.AF_INET6):
+                ls = self.process_inet(
+                    path, family, type_, inodes, filter_pid=pid)
+            else:
+                ls = self.process_unix(
+                    path, family, inodes, filter_pid=pid)
+            for fd, family, type_, laddr, raddr, status, bound_pid in ls:
+                if pid:
+                    conn = _common.pconn(fd, family, type_, laddr, raddr,
+                                         status)
+                else:
+                    conn = _common.sconn(fd, family, type_, laddr, raddr,
+                                         status, bound_pid)
+                ret.add(conn)
+        return list(ret)
+
+
+_connections = Connections()
+
+
+def net_connections(kind='inet'):
+    """Return system-wide open connections."""
+    return _connections.retrieve(kind)
+
+
+def net_io_counters():
+    """Return network I/O statistics for every network interface
+    installed on the system as a dict of raw tuples.
+    """
+    with open_text("%s/net/dev" % get_procfs_path()) as f:
+        lines = f.readlines()
+    retdict = {}
+    for line in lines[2:]:
+        colon = line.rfind(':')
+        assert colon > 0, repr(line)
+        name = line[:colon].strip()
+        fields = line[colon + 1:].strip().split()
+
+        # in
+        (bytes_recv,
+         packets_recv,
+         errin,
+         dropin,
+         fifoin,  # unused
+         framein,  # unused
+         compressedin,  # unused
+         multicastin,  # unused
+         # out
+         bytes_sent,
+         packets_sent,
+         errout,
+         dropout,
+         fifoout,  # unused
+         collisionsout,  # unused
+         carrierout,  # unused
+         compressedout) = map(int, fields)
+
+        retdict[name] = (bytes_sent, bytes_recv, packets_sent, packets_recv,
+                         errin, errout, dropin, dropout)
+    return retdict
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    duplex_map = {cext.DUPLEX_FULL: NIC_DUPLEX_FULL,
+                  cext.DUPLEX_HALF: NIC_DUPLEX_HALF,
+                  cext.DUPLEX_UNKNOWN: NIC_DUPLEX_UNKNOWN}
+    names = net_io_counters().keys()
+    ret = {}
+    for name in names:
+        try:
+            mtu = cext_posix.net_if_mtu(name)
+            isup = cext_posix.net_if_is_running(name)
+            duplex, speed = cext.net_if_duplex_speed(name)
+        except OSError as err:
+            # https://github.com/giampaolo/psutil/issues/1279
+            if err.errno != errno.ENODEV:
+                raise
+        else:
+            ret[name] = _common.snicstats(isup, duplex_map[duplex], speed, mtu)
+    return ret
+
+
+# =====================================================================
+# --- disks
+# =====================================================================
+
+
+disk_usage = _psposix.disk_usage
+
+
+def disk_io_counters(perdisk=False):
+    """Return disk I/O statistics for every disk installed on the
+    system as a dict of raw tuples.
+    """
+    def read_procfs():
+        # OK, this is a bit confusing. The format of /proc/diskstats can
+        # have 3 variations.
+        # On Linux 2.4 each line has always 15 fields, e.g.:
+        # "3     0   8 hda 8 8 8 8 8 8 8 8 8 8 8"
+        # On Linux 2.6+ each line *usually* has 14 fields, and the disk
+        # name is in another position, like this:
+        # "3    0   hda 8 8 8 8 8 8 8 8 8 8 8"
+        # ...unless (Linux 2.6) the line refers to a partition instead
+        # of a disk, in which case the line has less fields (7):
+        # "3    1   hda1 8 8 8 8"
+        # 4.18+ has 4 fields added:
+        # "3    0   hda 8 8 8 8 8 8 8 8 8 8 8 0 0 0 0"
+        # 5.5 has 2 more fields.
+        # See:
+        # https://www.kernel.org/doc/Documentation/iostats.txt
+        # https://www.kernel.org/doc/Documentation/ABI/testing/procfs-diskstats
+        with open_text("%s/diskstats" % get_procfs_path()) as f:
+            lines = f.readlines()
+        for line in lines:
+            fields = line.split()
+            flen = len(fields)
+            if flen == 15:
+                # Linux 2.4
+                name = fields[3]
+                reads = int(fields[2])
+                (reads_merged, rbytes, rtime, writes, writes_merged,
+                    wbytes, wtime, _, busy_time, _) = map(int, fields[4:14])
+            elif flen == 14 or flen >= 18:
+                # Linux 2.6+, line referring to a disk
+                name = fields[2]
+                (reads, reads_merged, rbytes, rtime, writes, writes_merged,
+                    wbytes, wtime, _, busy_time, _) = map(int, fields[3:14])
+            elif flen == 7:
+                # Linux 2.6+, line referring to a partition
+                name = fields[2]
+                reads, rbytes, writes, wbytes = map(int, fields[3:])
+                rtime = wtime = reads_merged = writes_merged = busy_time = 0
+            else:
+                raise ValueError("not sure how to interpret line %r" % line)
+            yield (name, reads, writes, rbytes, wbytes, rtime, wtime,
+                   reads_merged, writes_merged, busy_time)
+
+    def read_sysfs():
+        for block in os.listdir('/sys/block'):
+            for root, _, files in os.walk(os.path.join('/sys/block', block)):
+                if 'stat' not in files:
+                    continue
+                with open_text(os.path.join(root, 'stat')) as f:
+                    fields = f.read().strip().split()
+                name = os.path.basename(root)
+                (reads, reads_merged, rbytes, rtime, writes, writes_merged,
+                    wbytes, wtime, _, busy_time) = map(int, fields[:10])
+                yield (name, reads, writes, rbytes, wbytes, rtime,
+                       wtime, reads_merged, writes_merged, busy_time)
+
+    if os.path.exists('%s/diskstats' % get_procfs_path()):
+        gen = read_procfs()
+    elif os.path.exists('/sys/block'):
+        gen = read_sysfs()
+    else:
+        raise NotImplementedError(
+            "%s/diskstats nor /sys/block filesystem are available on this "
+            "system" % get_procfs_path())
+
+    retdict = {}
+    for entry in gen:
+        (name, reads, writes, rbytes, wbytes, rtime, wtime, reads_merged,
+            writes_merged, busy_time) = entry
+        if not perdisk and not is_storage_device(name):
+            # perdisk=False means we want to calculate totals so we skip
+            # partitions (e.g. 'sda1', 'nvme0n1p1') and only include
+            # base disk devices (e.g. 'sda', 'nvme0n1'). Base disks
+            # include a total of all their partitions + some extra size
+            # of their own:
+            #     $ cat /proc/diskstats
+            #     259       0 sda 10485760 ...
+            #     259       1 sda1 5186039 ...
+            #     259       1 sda2 5082039 ...
+            # See:
+            # https://github.com/giampaolo/psutil/pull/1313
+            continue
+
+        rbytes *= DISK_SECTOR_SIZE
+        wbytes *= DISK_SECTOR_SIZE
+        retdict[name] = (reads, writes, rbytes, wbytes, rtime, wtime,
+                         reads_merged, writes_merged, busy_time)
+
+    return retdict
+
+
+def disk_partitions(all=False):
+    """Return mounted disk partitions as a list of namedtuples."""
+    fstypes = set()
+    procfs_path = get_procfs_path()
+    with open_text("%s/filesystems" % procfs_path) as f:
+        for line in f:
+            line = line.strip()
+            if not line.startswith("nodev"):
+                fstypes.add(line.strip())
+            else:
+                # ignore all lines starting with "nodev" except "nodev zfs"
+                fstype = line.split("\t")[1]
+                if fstype == "zfs":
+                    fstypes.add("zfs")
+
+    # See: https://github.com/giampaolo/psutil/issues/1307
+    if procfs_path == "/proc" and os.path.isfile('/etc/mtab'):
+        mounts_path = os.path.realpath("/etc/mtab")
+    else:
+        mounts_path = os.path.realpath("%s/self/mounts" % procfs_path)
+
+    retlist = []
+    partitions = cext.disk_partitions(mounts_path)
+    for partition in partitions:
+        device, mountpoint, fstype, opts = partition
+        if device == 'none':
+            device = ''
+        if not all:
+            if device == '' or fstype not in fstypes:
+                continue
+        ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
+        retlist.append(ntuple)
+
+    return retlist
+
+
+# =====================================================================
+# --- sensors
+# =====================================================================
+
+
+def sensors_temperatures():
+    """Return hardware (CPU and others) temperatures as a dict
+    including hardware name, label, current, max and critical
+    temperatures.
+
+    Implementation notes:
+    - /sys/class/hwmon looks like the most recent interface to
+      retrieve this info, and this implementation relies on it
+      only (old distros will probably use something else)
+    - lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
+    - /sys/class/thermal/thermal_zone* is another one but it's more
+      difficult to parse
+    """
+    ret = collections.defaultdict(list)
+    basenames = glob.glob('/sys/class/hwmon/hwmon*/temp*_*')
+    # CentOS has an intermediate /device directory:
+    # https://github.com/giampaolo/psutil/issues/971
+    # https://github.com/nicolargo/glances/issues/1060
+    basenames.extend(glob.glob('/sys/class/hwmon/hwmon*/device/temp*_*'))
+    basenames.extend(glob.glob(
+        '/sys/devices/platform/coretemp.*/hwmon/hwmon*/temp*_*'))
+    basenames = sorted(set([x.split('_')[0] for x in basenames]))
+
+    for base in basenames:
+        try:
+            path = base + '_input'
+            current = float(cat(path)) / 1000.0
+            path = os.path.join(os.path.dirname(base), 'name')
+            unit_name = cat(path, binary=False)
+        except (IOError, OSError, ValueError):
+            # A lot of things can go wrong here, so let's just skip the
+            # whole entry. Sure thing is Linux's /sys/class/hwmon really
+            # is a stinky broken mess.
+            # https://github.com/giampaolo/psutil/issues/1009
+            # https://github.com/giampaolo/psutil/issues/1101
+            # https://github.com/giampaolo/psutil/issues/1129
+            # https://github.com/giampaolo/psutil/issues/1245
+            # https://github.com/giampaolo/psutil/issues/1323
+            continue
+
+        high = cat(base + '_max', fallback=None)
+        critical = cat(base + '_crit', fallback=None)
+        label = cat(base + '_label', fallback='', binary=False)
+
+        if high is not None:
+            try:
+                high = float(high) / 1000.0
+            except ValueError:
+                high = None
+        if critical is not None:
+            try:
+                critical = float(critical) / 1000.0
+            except ValueError:
+                critical = None
+
+        ret[unit_name].append((label, current, high, critical))
+
+    # Indication that no sensors were detected in /sys/class/hwmon/
+    if not basenames:
+        basenames = glob.glob('/sys/class/thermal/thermal_zone*')
+        basenames = sorted(set(basenames))
+
+        for base in basenames:
+            try:
+                path = os.path.join(base, 'temp')
+                current = float(cat(path)) / 1000.0
+                path = os.path.join(base, 'type')
+                unit_name = cat(path, binary=False)
+            except (IOError, OSError, ValueError) as err:
+                debug("ignoring %r for file %r" % (err, path))
+                continue
+
+            trip_paths = glob.glob(base + '/trip_point*')
+            trip_points = set(['_'.join(
+                os.path.basename(p).split('_')[0:3]) for p in trip_paths])
+            critical = None
+            high = None
+            for trip_point in trip_points:
+                path = os.path.join(base, trip_point + "_type")
+                trip_type = cat(path, fallback='', binary=False)
+                if trip_type == 'critical':
+                    critical = cat(os.path.join(base, trip_point + "_temp"),
+                                   fallback=None)
+                elif trip_type == 'high':
+                    high = cat(os.path.join(base, trip_point + "_temp"),
+                               fallback=None)
+
+                if high is not None:
+                    try:
+                        high = float(high) / 1000.0
+                    except ValueError:
+                        high = None
+                if critical is not None:
+                    try:
+                        critical = float(critical) / 1000.0
+                    except ValueError:
+                        critical = None
+
+            ret[unit_name].append(('', current, high, critical))
+
+    return dict(ret)
+
+
+def sensors_fans():
+    """Return hardware fans info (for CPU and other peripherals) as a
+    dict including hardware label and current speed.
+
+    Implementation notes:
+    - /sys/class/hwmon looks like the most recent interface to
+      retrieve this info, and this implementation relies on it
+      only (old distros will probably use something else)
+    - lm-sensors on Ubuntu 16.04 relies on /sys/class/hwmon
+    """
+    ret = collections.defaultdict(list)
+    basenames = glob.glob('/sys/class/hwmon/hwmon*/fan*_*')
+    if not basenames:
+        # CentOS has an intermediate /device directory:
+        # https://github.com/giampaolo/psutil/issues/971
+        basenames = glob.glob('/sys/class/hwmon/hwmon*/device/fan*_*')
+
+    basenames = sorted(set([x.split('_')[0] for x in basenames]))
+    for base in basenames:
+        try:
+            current = int(cat(base + '_input'))
+        except (IOError, OSError) as err:
+            warnings.warn("ignoring %r" % err, RuntimeWarning)
+            continue
+        unit_name = cat(os.path.join(os.path.dirname(base), 'name'),
+                        binary=False)
+        label = cat(base + '_label', fallback='', binary=False)
+        ret[unit_name].append(_common.sfan(label, current))
+
+    return dict(ret)
+
+
+def sensors_battery():
+    """Return battery information.
+    Implementation note: it appears /sys/class/power_supply/BAT0/
+    directory structure may vary and provide files with the same
+    meaning but under different names, see:
+    https://github.com/giampaolo/psutil/issues/966
+    """
+    null = object()
+
+    def multi_cat(*paths):
+        """Attempt to read the content of multiple files which may
+        not exist. If none of them exist return None.
+        """
+        for path in paths:
+            ret = cat(path, fallback=null)
+            if ret != null:
+                return int(ret) if ret.isdigit() else ret
+        return None
+
+    bats = [x for x in os.listdir(POWER_SUPPLY_PATH) if x.startswith('BAT') or
+            'battery' in x.lower()]
+    if not bats:
+        return None
+    # Get the first available battery. Usually this is "BAT0", except
+    # some rare exceptions:
+    # https://github.com/giampaolo/psutil/issues/1238
+    root = os.path.join(POWER_SUPPLY_PATH, sorted(bats)[0])
+
+    # Base metrics.
+    energy_now = multi_cat(
+        root + "/energy_now",
+        root + "/charge_now")
+    power_now = multi_cat(
+        root + "/power_now",
+        root + "/current_now")
+    energy_full = multi_cat(
+        root + "/energy_full",
+        root + "/charge_full")
+    time_to_empty = multi_cat(root + "/time_to_empty_now")
+
+    # Percent. If we have energy_full the percentage will be more
+    # accurate compared to reading /capacity file (float vs. int).
+    if energy_full is not None and energy_now is not None:
+        try:
+            percent = 100.0 * energy_now / energy_full
+        except ZeroDivisionError:
+            percent = 0.0
+    else:
+        percent = int(cat(root + "/capacity", fallback=-1))
+        if percent == -1:
+            return None
+
+    # Is AC power cable plugged in?
+    # Note: AC0 is not always available and sometimes (e.g. CentOS7)
+    # it's called "AC".
+    power_plugged = None
+    online = multi_cat(
+        os.path.join(POWER_SUPPLY_PATH, "AC0/online"),
+        os.path.join(POWER_SUPPLY_PATH, "AC/online"))
+    if online is not None:
+        power_plugged = online == 1
+    else:
+        status = cat(root + "/status", fallback="", binary=False).lower()
+        if status == "discharging":
+            power_plugged = False
+        elif status in ("charging", "full"):
+            power_plugged = True
+
+    # Seconds left.
+    # Note to self: we may also calculate the charging ETA as per:
+    # https://github.com/thialfihar/dotfiles/blob/
+    #     013937745fd9050c30146290e8f963d65c0179e6/bin/battery.py#L55
+    if power_plugged:
+        secsleft = _common.POWER_TIME_UNLIMITED
+    elif energy_now is not None and power_now is not None:
+        try:
+            secsleft = int(energy_now / power_now * 3600)
+        except ZeroDivisionError:
+            secsleft = _common.POWER_TIME_UNKNOWN
+    elif time_to_empty is not None:
+        secsleft = int(time_to_empty * 60)
+        if secsleft < 0:
+            secsleft = _common.POWER_TIME_UNKNOWN
+    else:
+        secsleft = _common.POWER_TIME_UNKNOWN
+
+    return _common.sbattery(percent, secsleft, power_plugged)
+
+
+# =====================================================================
+# --- other system functions
+# =====================================================================
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    for item in rawlist:
+        user, tty, hostname, tstamp, user_process, pid = item
+        # note: the underlying C function includes entries about
+        # system boot, run level and others.  We might want
+        # to use them in the future.
+        if not user_process:
+            continue
+        if hostname in (':0.0', ':0'):
+            hostname = 'localhost'
+        nt = _common.suser(user, tty or None, hostname, tstamp, pid)
+        retlist.append(nt)
+    return retlist
+
+
+def boot_time():
+    """Return the system boot time expressed in seconds since the epoch."""
+    global BOOT_TIME
+    path = '%s/stat' % get_procfs_path()
+    with open_binary(path) as f:
+        for line in f:
+            if line.startswith(b'btime'):
+                ret = float(line.strip().split()[1])
+                BOOT_TIME = ret
+                return ret
+        raise RuntimeError(
+            "line 'btime' not found in %s" % path)
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+def pids():
+    """Returns a list of PIDs currently running on the system."""
+    return [int(x) for x in os.listdir(b(get_procfs_path())) if x.isdigit()]
+
+
+def pid_exists(pid):
+    """Check for the existence of a unix PID. Linux TIDs are not
+    supported (always return False).
+    """
+    if not _psposix.pid_exists(pid):
+        return False
+    else:
+        # Linux's apparently does not distinguish between PIDs and TIDs
+        # (thread IDs).
+        # listdir("/proc") won't show any TID (only PIDs) but
+        # os.stat("/proc/{tid}") will succeed if {tid} exists.
+        # os.kill() can also be passed a TID. This is quite confusing.
+        # In here we want to enforce this distinction and support PIDs
+        # only, see:
+        # https://github.com/giampaolo/psutil/issues/687
+        try:
+            # Note: already checked that this is faster than using a
+            # regular expr. Also (a lot) faster than doing
+            # 'return pid in pids()'
+            path = "%s/%s/status" % (get_procfs_path(), pid)
+            with open_binary(path) as f:
+                for line in f:
+                    if line.startswith(b"Tgid:"):
+                        tgid = int(line.split()[1])
+                        # If tgid and pid are the same then we're
+                        # dealing with a process PID.
+                        return tgid == pid
+                raise ValueError("'Tgid' line not found in %s" % path)
+        except (EnvironmentError, ValueError):
+            return pid in pids()
+
+
+def ppid_map():
+    """Obtain a {pid: ppid, ...} dict for all running processes in
+    one shot. Used to speed up Process.children().
+    """
+    ret = {}
+    procfs_path = get_procfs_path()
+    for pid in pids():
+        try:
+            with open_binary("%s/%s/stat" % (procfs_path, pid)) as f:
+                data = f.read()
+        except (FileNotFoundError, ProcessLookupError):
+            # Note: we should be able to access /stat for all processes
+            # aka it's unlikely we'll bump into EPERM, which is good.
+            pass
+        else:
+            rpar = data.rfind(b')')
+            dset = data[rpar + 2:].split()
+            ppid = int(dset[1])
+            ret[pid] = ppid
+    return ret
+
+
+def wrap_exceptions(fun):
+    """Decorator which translates bare OSError and IOError exceptions
+    into NoSuchProcess and AccessDenied.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+        except ProcessLookupError:
+            raise NoSuchProcess(self.pid, self._name)
+        except FileNotFoundError:
+            if not os.path.exists("%s/%s" % (self._procfs_path, self.pid)):
+                raise NoSuchProcess(self.pid, self._name)
+            # Note: zombies will keep existing under /proc until they're
+            # gone so there's no way to distinguish them in here.
+            raise
+    return wrapper
+
+
+class Process(object):
+    """Linux process implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_procfs_path", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+        self._procfs_path = get_procfs_path()
+
+    def _assert_alive(self):
+        """Raise NSP if the process disappeared on us."""
+        # For those C function who do not raise NSP, possibly returning
+        # incorrect or incomplete result.
+        os.stat('%s/%s' % (self._procfs_path, self.pid))
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _parse_stat_file(self):
+        """Parse /proc/{pid}/stat file and return a dict with various
+        process info.
+        Using "man proc" as a reference: where "man proc" refers to
+        position N always substract 3 (e.g ppid position 4 in
+        'man proc' == position 1 in here).
+        The return value is cached in case oneshot() ctx manager is
+        in use.
+        """
+        with open_binary("%s/%s/stat" % (self._procfs_path, self.pid)) as f:
+            data = f.read()
+        # Process name is between parentheses. It can contain spaces and
+        # other parentheses. This is taken into account by looking for
+        # the first occurrence of "(" and the last occurence of ")".
+        rpar = data.rfind(b')')
+        name = data[data.find(b'(') + 1:rpar]
+        fields = data[rpar + 2:].split()
+
+        ret = {}
+        ret['name'] = name
+        ret['status'] = fields[0]
+        ret['ppid'] = fields[1]
+        ret['ttynr'] = fields[4]
+        ret['utime'] = fields[11]
+        ret['stime'] = fields[12]
+        ret['children_utime'] = fields[13]
+        ret['children_stime'] = fields[14]
+        ret['create_time'] = fields[19]
+        ret['cpu_num'] = fields[36]
+        ret['blkio_ticks'] = fields[39]  # aka 'delayacct_blkio_ticks'
+
+        return ret
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _read_status_file(self):
+        """Read /proc/{pid}/stat file and return its content.
+        The return value is cached in case oneshot() ctx manager is
+        in use.
+        """
+        with open_binary("%s/%s/status" % (self._procfs_path, self.pid)) as f:
+            return f.read()
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _read_smaps_file(self):
+        with open_binary("%s/%s/smaps" % (self._procfs_path, self.pid),
+                         buffering=BIGFILE_BUFFERING) as f:
+            return f.read().strip()
+
+    def oneshot_enter(self):
+        self._parse_stat_file.cache_activate(self)
+        self._read_status_file.cache_activate(self)
+        self._read_smaps_file.cache_activate(self)
+
+    def oneshot_exit(self):
+        self._parse_stat_file.cache_deactivate(self)
+        self._read_status_file.cache_deactivate(self)
+        self._read_smaps_file.cache_deactivate(self)
+
+    @wrap_exceptions
+    def name(self):
+        name = self._parse_stat_file()['name']
+        if PY3:
+            name = decode(name)
+        # XXX - gets changed later and probably needs refactoring
+        return name
+
+    def exe(self):
+        try:
+            return readlink("%s/%s/exe" % (self._procfs_path, self.pid))
+        except (FileNotFoundError, ProcessLookupError):
+            # no such file error; might be raised also if the
+            # path actually exists for system processes with
+            # low pids (about 0-20)
+            if os.path.lexists("%s/%s" % (self._procfs_path, self.pid)):
+                return ""
+            else:
+                if not pid_exists(self.pid):
+                    raise NoSuchProcess(self.pid, self._name)
+                else:
+                    raise ZombieProcess(self.pid, self._name, self._ppid)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+
+    @wrap_exceptions
+    def cmdline(self):
+        with open_text("%s/%s/cmdline" % (self._procfs_path, self.pid)) as f:
+            data = f.read()
+        if not data:
+            # may happen in case of zombie process
+            return []
+        # 'man proc' states that args are separated by null bytes '\0'
+        # and last char is supposed to be a null byte. Nevertheless
+        # some processes may change their cmdline after being started
+        # (via setproctitle() or similar), they are usually not
+        # compliant with this rule and use spaces instead. Google
+        # Chrome process is an example. See:
+        # https://github.com/giampaolo/psutil/issues/1179
+        sep = '\x00' if data.endswith('\x00') else ' '
+        if data.endswith(sep):
+            data = data[:-1]
+        cmdline = data.split(sep)
+        # Sometimes last char is a null byte '\0' but the args are
+        # separated by spaces, see: https://github.com/giampaolo/psutil/
+        # issues/1179#issuecomment-552984549
+        if sep == '\x00' and len(cmdline) == 1 and ' ' in data:
+            cmdline = data.split(' ')
+        return cmdline
+
+    @wrap_exceptions
+    def environ(self):
+        with open_text("%s/%s/environ" % (self._procfs_path, self.pid)) as f:
+            data = f.read()
+        return parse_environ_block(data)
+
+    @wrap_exceptions
+    def terminal(self):
+        tty_nr = int(self._parse_stat_file()['ttynr'])
+        tmap = _psposix.get_terminal_map()
+        try:
+            return tmap[tty_nr]
+        except KeyError:
+            return None
+
+    # May not be available on old kernels.
+    if os.path.exists('/proc/%s/io' % os.getpid()):
+        @wrap_exceptions
+        def io_counters(self):
+            fname = "%s/%s/io" % (self._procfs_path, self.pid)
+            fields = {}
+            with open_binary(fname) as f:
+                for line in f:
+                    # https://github.com/giampaolo/psutil/issues/1004
+                    line = line.strip()
+                    if line:
+                        try:
+                            name, value = line.split(b': ')
+                        except ValueError:
+                            # https://github.com/giampaolo/psutil/issues/1004
+                            continue
+                        else:
+                            fields[name] = int(value)
+            if not fields:
+                raise RuntimeError("%s file was empty" % fname)
+            try:
+                return pio(
+                    fields[b'syscr'],  # read syscalls
+                    fields[b'syscw'],  # write syscalls
+                    fields[b'read_bytes'],  # read bytes
+                    fields[b'write_bytes'],  # write bytes
+                    fields[b'rchar'],  # read chars
+                    fields[b'wchar'],  # write chars
+                )
+            except KeyError as err:
+                raise ValueError("%r field was not found in %s; found fields "
+                                 "are %r" % (err[0], fname, fields))
+
+    @wrap_exceptions
+    def cpu_times(self):
+        values = self._parse_stat_file()
+        utime = float(values['utime']) / CLOCK_TICKS
+        stime = float(values['stime']) / CLOCK_TICKS
+        children_utime = float(values['children_utime']) / CLOCK_TICKS
+        children_stime = float(values['children_stime']) / CLOCK_TICKS
+        iowait = float(values['blkio_ticks']) / CLOCK_TICKS
+        return pcputimes(utime, stime, children_utime, children_stime, iowait)
+
+    @wrap_exceptions
+    def cpu_num(self):
+        """What CPU the process is on."""
+        return int(self._parse_stat_file()['cpu_num'])
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        return _psposix.wait_pid(self.pid, timeout, self._name)
+
+    @wrap_exceptions
+    def create_time(self):
+        ctime = float(self._parse_stat_file()['create_time'])
+        # According to documentation, starttime is in field 21 and the
+        # unit is jiffies (clock ticks).
+        # We first divide it for clock ticks and then add uptime returning
+        # seconds since the epoch, in UTC.
+        # Also use cached value if available.
+        bt = BOOT_TIME or boot_time()
+        return (ctime / CLOCK_TICKS) + bt
+
+    @wrap_exceptions
+    def memory_info(self):
+        #  ============================================================
+        # | FIELD  | DESCRIPTION                         | AKA  | TOP  |
+        #  ============================================================
+        # | rss    | resident set size                   |      | RES  |
+        # | vms    | total program size                  | size | VIRT |
+        # | shared | shared pages (from shared mappings) |      | SHR  |
+        # | text   | text ('code')                       | trs  | CODE |
+        # | lib    | library (unused in Linux 2.6)       | lrs  |      |
+        # | data   | data + stack                        | drs  | DATA |
+        # | dirty  | dirty pages (unused in Linux 2.6)   | dt   |      |
+        #  ============================================================
+        with open_binary("%s/%s/statm" % (self._procfs_path, self.pid)) as f:
+            vms, rss, shared, text, lib, data, dirty = \
+                [int(x) * PAGESIZE for x in f.readline().split()[:7]]
+        return pmem(rss, vms, shared, text, lib, data, dirty)
+
+    # /proc/pid/smaps does not exist on kernels < 2.6.14 or if
+    # CONFIG_MMU kernel configuration option is not enabled.
+    if HAS_SMAPS:
+
+        @wrap_exceptions
+        def memory_full_info(
+                self,
+                # Gets Private_Clean, Private_Dirty, Private_Hugetlb.
+                _private_re=re.compile(br"\nPrivate.*:\s+(\d+)"),
+                _pss_re=re.compile(br"\nPss\:\s+(\d+)"),
+                _swap_re=re.compile(br"\nSwap\:\s+(\d+)")):
+            basic_mem = self.memory_info()
+            # Note: using 3 regexes is faster than reading the file
+            # line by line.
+            # XXX: on Python 3 the 2 regexes are 30% slower than on
+            # Python 2 though. Figure out why.
+            #
+            # You might be tempted to calculate USS by subtracting
+            # the "shared" value from the "resident" value in
+            # /proc/<pid>/statm. But at least on Linux, statm's "shared"
+            # value actually counts pages backed by files, which has
+            # little to do with whether the pages are actually shared.
+            # /proc/self/smaps on the other hand appears to give us the
+            # correct information.
+            smaps_data = self._read_smaps_file()
+            # Note: smaps file can be empty for certain processes.
+            # The code below will not crash though and will result to 0.
+            uss = sum(map(int, _private_re.findall(smaps_data))) * 1024
+            pss = sum(map(int, _pss_re.findall(smaps_data))) * 1024
+            swap = sum(map(int, _swap_re.findall(smaps_data))) * 1024
+            return pfullmem(*basic_mem + (uss, pss, swap))
+
+    else:
+        memory_full_info = memory_info
+
+    if HAS_SMAPS:
+
+        @wrap_exceptions
+        def memory_maps(self):
+            """Return process's mapped memory regions as a list of named
+            tuples. Fields are explained in 'man proc'; here is an updated
+            (Apr 2012) version: http://goo.gl/fmebo
+
+            /proc/{PID}/smaps does not exist on kernels < 2.6.14 or if
+            CONFIG_MMU kernel configuration option is not enabled.
+            """
+            def get_blocks(lines, current_block):
+                data = {}
+                for line in lines:
+                    fields = line.split(None, 5)
+                    if not fields[0].endswith(b':'):
+                        # new block section
+                        yield (current_block.pop(), data)
+                        current_block.append(line)
+                    else:
+                        try:
+                            data[fields[0]] = int(fields[1]) * 1024
+                        except ValueError:
+                            if fields[0].startswith(b'VmFlags:'):
+                                # see issue #369
+                                continue
+                            else:
+                                raise ValueError("don't know how to inte"
+                                                 "rpret line %r" % line)
+                yield (current_block.pop(), data)
+
+            data = self._read_smaps_file()
+            # Note: smaps file can be empty for certain processes.
+            if not data:
+                return []
+            lines = data.split(b'\n')
+            ls = []
+            first_line = lines.pop(0)
+            current_block = [first_line]
+            for header, data in get_blocks(lines, current_block):
+                hfields = header.split(None, 5)
+                try:
+                    addr, perms, offset, dev, inode, path = hfields
+                except ValueError:
+                    addr, perms, offset, dev, inode, path = \
+                        hfields + ['']
+                if not path:
+                    path = '[anon]'
+                else:
+                    if PY3:
+                        path = decode(path)
+                    path = path.strip()
+                    if (path.endswith(' (deleted)') and not
+                            path_exists_strict(path)):
+                        path = path[:-10]
+                ls.append((
+                    decode(addr), decode(perms), path,
+                    data.get(b'Rss:', 0),
+                    data.get(b'Size:', 0),
+                    data.get(b'Pss:', 0),
+                    data.get(b'Shared_Clean:', 0),
+                    data.get(b'Shared_Dirty:', 0),
+                    data.get(b'Private_Clean:', 0),
+                    data.get(b'Private_Dirty:', 0),
+                    data.get(b'Referenced:', 0),
+                    data.get(b'Anonymous:', 0),
+                    data.get(b'Swap:', 0)
+                ))
+            return ls
+
+    @wrap_exceptions
+    def cwd(self):
+        try:
+            return readlink("%s/%s/cwd" % (self._procfs_path, self.pid))
+        except (FileNotFoundError, ProcessLookupError):
+            # https://github.com/giampaolo/psutil/issues/986
+            if not pid_exists(self.pid):
+                raise NoSuchProcess(self.pid, self._name)
+            else:
+                raise ZombieProcess(self.pid, self._name, self._ppid)
+
+    @wrap_exceptions
+    def num_ctx_switches(self,
+                         _ctxsw_re=re.compile(br'ctxt_switches:\t(\d+)')):
+        data = self._read_status_file()
+        ctxsw = _ctxsw_re.findall(data)
+        if not ctxsw:
+            raise NotImplementedError(
+                "'voluntary_ctxt_switches' and 'nonvoluntary_ctxt_switches'"
+                "lines were not found in %s/%s/status; the kernel is "
+                "probably older than 2.6.23" % (
+                    self._procfs_path, self.pid))
+        else:
+            return _common.pctxsw(int(ctxsw[0]), int(ctxsw[1]))
+
+    @wrap_exceptions
+    def num_threads(self, _num_threads_re=re.compile(br'Threads:\t(\d+)')):
+        # Note: on Python 3 using a re is faster than iterating over file
+        # line by line. On Python 2 is the exact opposite, and iterating
+        # over a file on Python 3 is slower than on Python 2.
+        data = self._read_status_file()
+        return int(_num_threads_re.findall(data)[0])
+
+    @wrap_exceptions
+    def threads(self):
+        thread_ids = os.listdir("%s/%s/task" % (self._procfs_path, self.pid))
+        thread_ids.sort()
+        retlist = []
+        hit_enoent = False
+        for thread_id in thread_ids:
+            fname = "%s/%s/task/%s/stat" % (
+                self._procfs_path, self.pid, thread_id)
+            try:
+                with open_binary(fname) as f:
+                    st = f.read().strip()
+            except FileNotFoundError:
+                # no such file or directory; it means thread
+                # disappeared on us
+                hit_enoent = True
+                continue
+            # ignore the first two values ("pid (exe)")
+            st = st[st.find(b')') + 2:]
+            values = st.split(b' ')
+            utime = float(values[11]) / CLOCK_TICKS
+            stime = float(values[12]) / CLOCK_TICKS
+            ntuple = _common.pthread(int(thread_id), utime, stime)
+            retlist.append(ntuple)
+        if hit_enoent:
+            self._assert_alive()
+        return retlist
+
+    @wrap_exceptions
+    def nice_get(self):
+        # with open_text('%s/%s/stat' % (self._procfs_path, self.pid)) as f:
+        #   data = f.read()
+        #   return int(data.split()[18])
+
+        # Use C implementation
+        return cext_posix.getpriority(self.pid)
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        return cext_posix.setpriority(self.pid, value)
+
+    # starting from CentOS 6.
+    if HAS_CPU_AFFINITY:
+
+        @wrap_exceptions
+        def cpu_affinity_get(self):
+            return cext.proc_cpu_affinity_get(self.pid)
+
+        def _get_eligible_cpus(
+                self, _re=re.compile(br"Cpus_allowed_list:\t(\d+)-(\d+)")):
+            # See: https://github.com/giampaolo/psutil/issues/956
+            data = self._read_status_file()
+            match = _re.findall(data)
+            if match:
+                return list(range(int(match[0][0]), int(match[0][1]) + 1))
+            else:
+                return list(range(len(per_cpu_times())))
+
+        @wrap_exceptions
+        def cpu_affinity_set(self, cpus):
+            try:
+                cext.proc_cpu_affinity_set(self.pid, cpus)
+            except (OSError, ValueError) as err:
+                if isinstance(err, ValueError) or err.errno == errno.EINVAL:
+                    eligible_cpus = self._get_eligible_cpus()
+                    all_cpus = tuple(range(len(per_cpu_times())))
+                    for cpu in cpus:
+                        if cpu not in all_cpus:
+                            raise ValueError(
+                                "invalid CPU number %r; choose between %s" % (
+                                    cpu, eligible_cpus))
+                        if cpu not in eligible_cpus:
+                            raise ValueError(
+                                "CPU number %r is not eligible; choose "
+                                "between %s" % (cpu, eligible_cpus))
+                raise
+
+    # only starting from kernel 2.6.13
+    if HAS_PROC_IO_PRIORITY:
+
+        @wrap_exceptions
+        def ionice_get(self):
+            ioclass, value = cext.proc_ioprio_get(self.pid)
+            if enum is not None:
+                ioclass = IOPriority(ioclass)
+            return _common.pionice(ioclass, value)
+
+        @wrap_exceptions
+        def ionice_set(self, ioclass, value):
+            if value is None:
+                value = 0
+            if value and ioclass in (IOPRIO_CLASS_IDLE, IOPRIO_CLASS_NONE):
+                raise ValueError("%r ioclass accepts no value" % ioclass)
+            if value < 0 or value > 7:
+                raise ValueError("value not in 0-7 range")
+            return cext.proc_ioprio_set(self.pid, ioclass, value)
+
+    if HAS_PRLIMIT:
+
+        @wrap_exceptions
+        def rlimit(self, resource, limits=None):
+            # If pid is 0 prlimit() applies to the calling process and
+            # we don't want that. We should never get here though as
+            # PID 0 is not supported on Linux.
+            if self.pid == 0:
+                raise ValueError("can't use prlimit() against PID 0 process")
+            try:
+                if limits is None:
+                    # get
+                    return cext.linux_prlimit(self.pid, resource)
+                else:
+                    # set
+                    if len(limits) != 2:
+                        raise ValueError(
+                            "second argument must be a (soft, hard) tuple, "
+                            "got %s" % repr(limits))
+                    soft, hard = limits
+                    cext.linux_prlimit(self.pid, resource, soft, hard)
+            except OSError as err:
+                if err.errno == errno.ENOSYS and pid_exists(self.pid):
+                    # I saw this happening on Travis:
+                    # https://travis-ci.org/giampaolo/psutil/jobs/51368273
+                    raise ZombieProcess(self.pid, self._name, self._ppid)
+                else:
+                    raise
+
+    @wrap_exceptions
+    def status(self):
+        letter = self._parse_stat_file()['status']
+        if PY3:
+            letter = letter.decode()
+        # XXX is '?' legit? (we're not supposed to return it anyway)
+        return PROC_STATUSES.get(letter, '?')
+
+    @wrap_exceptions
+    def open_files(self):
+        retlist = []
+        files = os.listdir("%s/%s/fd" % (self._procfs_path, self.pid))
+        hit_enoent = False
+        for fd in files:
+            file = "%s/%s/fd/%s" % (self._procfs_path, self.pid, fd)
+            try:
+                path = readlink(file)
+            except (FileNotFoundError, ProcessLookupError):
+                # ENOENT == file which is gone in the meantime
+                hit_enoent = True
+                continue
+            except OSError as err:
+                if err.errno == errno.EINVAL:
+                    # not a link
+                    continue
+                raise
+            else:
+                # If path is not an absolute there's no way to tell
+                # whether it's a regular file or not, so we skip it.
+                # A regular file is always supposed to be have an
+                # absolute path though.
+                if path.startswith('/') and isfile_strict(path):
+                    # Get file position and flags.
+                    file = "%s/%s/fdinfo/%s" % (
+                        self._procfs_path, self.pid, fd)
+                    try:
+                        with open_binary(file) as f:
+                            pos = int(f.readline().split()[1])
+                            flags = int(f.readline().split()[1], 8)
+                    except FileNotFoundError:
+                        # fd gone in the meantime; process may
+                        # still be alive
+                        hit_enoent = True
+                    else:
+                        mode = file_flags_to_mode(flags)
+                        ntuple = popenfile(
+                            path, int(fd), int(pos), mode, flags)
+                        retlist.append(ntuple)
+        if hit_enoent:
+            self._assert_alive()
+        return retlist
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        ret = _connections.retrieve(kind, self.pid)
+        self._assert_alive()
+        return ret
+
+    @wrap_exceptions
+    def num_fds(self):
+        return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
+
+    @wrap_exceptions
+    def ppid(self):
+        return int(self._parse_stat_file()['ppid'])
+
+    @wrap_exceptions
+    def uids(self, _uids_re=re.compile(br'Uid:\t(\d+)\t(\d+)\t(\d+)')):
+        data = self._read_status_file()
+        real, effective, saved = _uids_re.findall(data)[0]
+        return _common.puids(int(real), int(effective), int(saved))
+
+    @wrap_exceptions
+    def gids(self, _gids_re=re.compile(br'Gid:\t(\d+)\t(\d+)\t(\d+)')):
+        data = self._read_status_file()
+        real, effective, saved = _gids_re.findall(data)[0]
+        return _common.pgids(int(real), int(effective), int(saved))
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psosx.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psosx.py
new file mode 100644
index 0000000000000000000000000000000000000000..6a1899316f7029ae5c7b452ae8e00eff48ccbbef
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psosx.py
@@ -0,0 +1,575 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""macOS platform implementation."""
+
+import contextlib
+import errno
+import functools
+import os
+from collections import namedtuple
+
+from . import _common
+from . import _psposix
+from . import _psutil_osx as cext
+from . import _psutil_posix as cext_posix
+from ._common import AccessDenied
+from ._common import conn_tmap
+from ._common import conn_to_ntuple
+from ._common import isfile_strict
+from ._common import memoize_when_activated
+from ._common import NoSuchProcess
+from ._common import parse_environ_block
+from ._common import usage_percent
+from ._common import ZombieProcess
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+
+
+__extra__all__ = []
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+
+PAGESIZE = os.sysconf("SC_PAGE_SIZE")
+AF_LINK = cext_posix.AF_LINK
+
+TCP_STATUSES = {
+    cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
+    cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
+    cext.TCPS_SYN_RECEIVED: _common.CONN_SYN_RECV,
+    cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
+    cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
+    cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
+    cext.TCPS_CLOSED: _common.CONN_CLOSE,
+    cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
+    cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
+    cext.TCPS_LISTEN: _common.CONN_LISTEN,
+    cext.TCPS_CLOSING: _common.CONN_CLOSING,
+    cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
+}
+
+PROC_STATUSES = {
+    cext.SIDL: _common.STATUS_IDLE,
+    cext.SRUN: _common.STATUS_RUNNING,
+    cext.SSLEEP: _common.STATUS_SLEEPING,
+    cext.SSTOP: _common.STATUS_STOPPED,
+    cext.SZOMB: _common.STATUS_ZOMBIE,
+}
+
+kinfo_proc_map = dict(
+    ppid=0,
+    ruid=1,
+    euid=2,
+    suid=3,
+    rgid=4,
+    egid=5,
+    sgid=6,
+    ttynr=7,
+    ctime=8,
+    status=9,
+    name=10,
+)
+
+pidtaskinfo_map = dict(
+    cpuutime=0,
+    cpustime=1,
+    rss=2,
+    vms=3,
+    pfaults=4,
+    pageins=5,
+    numthreads=6,
+    volctxsw=7,
+)
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.cpu_times()
+scputimes = namedtuple('scputimes', ['user', 'nice', 'system', 'idle'])
+# psutil.virtual_memory()
+svmem = namedtuple(
+    'svmem', ['total', 'available', 'percent', 'used', 'free',
+              'active', 'inactive', 'wired'])
+# psutil.Process.memory_info()
+pmem = namedtuple('pmem', ['rss', 'vms', 'pfaults', 'pageins'])
+# psutil.Process.memory_full_info()
+pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', ))
+
+
+# =====================================================================
+# --- memory
+# =====================================================================
+
+
+def virtual_memory():
+    """System virtual memory as a namedtuple."""
+    total, active, inactive, wired, free, speculative = cext.virtual_mem()
+    # This is how Zabbix calculate avail and used mem:
+    # https://github.com/zabbix/zabbix/blob/trunk/src/libs/zbxsysinfo/
+    #     osx/memory.c
+    # Also see: https://github.com/giampaolo/psutil/issues/1277
+    avail = inactive + free
+    used = active + wired
+    # This is NOT how Zabbix calculates free mem but it matches "free"
+    # cmdline utility.
+    free -= speculative
+    percent = usage_percent((total - avail), total, round_=1)
+    return svmem(total, avail, percent, used, free,
+                 active, inactive, wired)
+
+
+def swap_memory():
+    """Swap system memory as a (total, used, free, sin, sout) tuple."""
+    total, used, free, sin, sout = cext.swap_mem()
+    percent = usage_percent(used, total, round_=1)
+    return _common.sswap(total, used, free, percent, sin, sout)
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return system CPU times as a namedtuple."""
+    user, nice, system, idle = cext.cpu_times()
+    return scputimes(user, nice, system, idle)
+
+
+def per_cpu_times():
+    """Return system CPU times as a named tuple"""
+    ret = []
+    for cpu_t in cext.per_cpu_times():
+        user, nice, system, idle = cpu_t
+        item = scputimes(user, nice, system, idle)
+        ret.append(item)
+    return ret
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    return cext.cpu_count_logical()
+
+
+def cpu_count_physical():
+    """Return the number of physical CPUs in the system."""
+    return cext.cpu_count_phys()
+
+
+def cpu_stats():
+    ctx_switches, interrupts, soft_interrupts, syscalls, traps = \
+        cext.cpu_stats()
+    return _common.scpustats(
+        ctx_switches, interrupts, soft_interrupts, syscalls)
+
+
+def cpu_freq():
+    """Return CPU frequency.
+    On macOS per-cpu frequency is not supported.
+    Also, the returned frequency never changes, see:
+    https://arstechnica.com/civis/viewtopic.php?f=19&t=465002
+    """
+    curr, min_, max_ = cext.cpu_freq()
+    return [_common.scpufreq(curr, min_, max_)]
+
+
+# =====================================================================
+# --- disks
+# =====================================================================
+
+
+disk_usage = _psposix.disk_usage
+disk_io_counters = cext.disk_io_counters
+
+
+def disk_partitions(all=False):
+    """Return mounted disk partitions as a list of namedtuples."""
+    retlist = []
+    partitions = cext.disk_partitions()
+    for partition in partitions:
+        device, mountpoint, fstype, opts = partition
+        if device == 'none':
+            device = ''
+        if not all:
+            if not os.path.isabs(device) or not os.path.exists(device):
+                continue
+        ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
+        retlist.append(ntuple)
+    return retlist
+
+
+# =====================================================================
+# --- sensors
+# =====================================================================
+
+
+def sensors_battery():
+    """Return battery information."""
+    try:
+        percent, minsleft, power_plugged = cext.sensors_battery()
+    except NotImplementedError:
+        # no power source - return None according to interface
+        return None
+    power_plugged = power_plugged == 1
+    if power_plugged:
+        secsleft = _common.POWER_TIME_UNLIMITED
+    elif minsleft == -1:
+        secsleft = _common.POWER_TIME_UNKNOWN
+    else:
+        secsleft = minsleft * 60
+    return _common.sbattery(percent, secsleft, power_plugged)
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+net_io_counters = cext.net_io_counters
+net_if_addrs = cext_posix.net_if_addrs
+
+
+def net_connections(kind='inet'):
+    """System-wide network connections."""
+    # Note: on macOS this will fail with AccessDenied unless
+    # the process is owned by root.
+    ret = []
+    for pid in pids():
+        try:
+            cons = Process(pid).connections(kind)
+        except NoSuchProcess:
+            continue
+        else:
+            if cons:
+                for c in cons:
+                    c = list(c) + [pid]
+                    ret.append(_common.sconn(*c))
+    return ret
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    names = net_io_counters().keys()
+    ret = {}
+    for name in names:
+        try:
+            mtu = cext_posix.net_if_mtu(name)
+            isup = cext_posix.net_if_is_running(name)
+            duplex, speed = cext_posix.net_if_duplex_speed(name)
+        except OSError as err:
+            # https://github.com/giampaolo/psutil/issues/1279
+            if err.errno != errno.ENODEV:
+                raise
+        else:
+            if hasattr(_common, 'NicDuplex'):
+                duplex = _common.NicDuplex(duplex)
+            ret[name] = _common.snicstats(isup, duplex, speed, mtu)
+    return ret
+
+
+# =====================================================================
+# --- other system functions
+# =====================================================================
+
+
+def boot_time():
+    """The system boot time expressed in seconds since the epoch."""
+    return cext.boot_time()
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    for item in rawlist:
+        user, tty, hostname, tstamp, pid = item
+        if tty == '~':
+            continue  # reboot or shutdown
+        if not tstamp:
+            continue
+        nt = _common.suser(user, tty or None, hostname or None, tstamp, pid)
+        retlist.append(nt)
+    return retlist
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+def pids():
+    ls = cext.pids()
+    if 0 not in ls:
+        # On certain macOS versions pids() C doesn't return PID 0 but
+        # "ps" does and the process is querable via sysctl():
+        # https://travis-ci.org/giampaolo/psutil/jobs/309619941
+        try:
+            Process(0).create_time()
+            ls.insert(0, 0)
+        except NoSuchProcess:
+            pass
+        except AccessDenied:
+            ls.insert(0, 0)
+    return ls
+
+
+pid_exists = _psposix.pid_exists
+
+
+def is_zombie(pid):
+    try:
+        st = cext.proc_kinfo_oneshot(pid)[kinfo_proc_map['status']]
+        return st == cext.SZOMB
+    except Exception:
+        return False
+
+
+def wrap_exceptions(fun):
+    """Decorator which translates bare OSError exceptions into
+    NoSuchProcess and AccessDenied.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except ProcessLookupError:
+            if is_zombie(self.pid):
+                raise ZombieProcess(self.pid, self._name, self._ppid)
+            else:
+                raise NoSuchProcess(self.pid, self._name)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+        except cext.ZombieProcessError:
+            raise ZombieProcess(self.pid, self._name, self._ppid)
+    return wrapper
+
+
+@contextlib.contextmanager
+def catch_zombie(proc):
+    """There are some poor C APIs which incorrectly raise ESRCH when
+    the process is still alive or it's a zombie, or even RuntimeError
+    (those who don't set errno). This is here in order to solve:
+    https://github.com/giampaolo/psutil/issues/1044
+    """
+    try:
+        yield
+    except (OSError, RuntimeError) as err:
+        if isinstance(err, RuntimeError) or err.errno == errno.ESRCH:
+            try:
+                # status() is not supposed to lie and correctly detect
+                # zombies so if it raises ESRCH it's true.
+                status = proc.status()
+            except NoSuchProcess:
+                raise err
+            else:
+                if status == _common.STATUS_ZOMBIE:
+                    raise ZombieProcess(proc.pid, proc._name, proc._ppid)
+                else:
+                    raise AccessDenied(proc.pid, proc._name)
+        else:
+            raise
+
+
+class Process(object):
+    """Wrapper class around underlying C implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _get_kinfo_proc(self):
+        # Note: should work with all PIDs without permission issues.
+        ret = cext.proc_kinfo_oneshot(self.pid)
+        assert len(ret) == len(kinfo_proc_map)
+        return ret
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _get_pidtaskinfo(self):
+        # Note: should work for PIDs owned by user only.
+        with catch_zombie(self):
+            ret = cext.proc_pidtaskinfo_oneshot(self.pid)
+        assert len(ret) == len(pidtaskinfo_map)
+        return ret
+
+    def oneshot_enter(self):
+        self._get_kinfo_proc.cache_activate(self)
+        self._get_pidtaskinfo.cache_activate(self)
+
+    def oneshot_exit(self):
+        self._get_kinfo_proc.cache_deactivate(self)
+        self._get_pidtaskinfo.cache_deactivate(self)
+
+    @wrap_exceptions
+    def name(self):
+        name = self._get_kinfo_proc()[kinfo_proc_map['name']]
+        return name if name is not None else cext.proc_name(self.pid)
+
+    @wrap_exceptions
+    def exe(self):
+        with catch_zombie(self):
+            return cext.proc_exe(self.pid)
+
+    @wrap_exceptions
+    def cmdline(self):
+        with catch_zombie(self):
+            return cext.proc_cmdline(self.pid)
+
+    @wrap_exceptions
+    def environ(self):
+        with catch_zombie(self):
+            return parse_environ_block(cext.proc_environ(self.pid))
+
+    @wrap_exceptions
+    def ppid(self):
+        self._ppid = self._get_kinfo_proc()[kinfo_proc_map['ppid']]
+        return self._ppid
+
+    @wrap_exceptions
+    def cwd(self):
+        with catch_zombie(self):
+            return cext.proc_cwd(self.pid)
+
+    @wrap_exceptions
+    def uids(self):
+        rawtuple = self._get_kinfo_proc()
+        return _common.puids(
+            rawtuple[kinfo_proc_map['ruid']],
+            rawtuple[kinfo_proc_map['euid']],
+            rawtuple[kinfo_proc_map['suid']])
+
+    @wrap_exceptions
+    def gids(self):
+        rawtuple = self._get_kinfo_proc()
+        return _common.puids(
+            rawtuple[kinfo_proc_map['rgid']],
+            rawtuple[kinfo_proc_map['egid']],
+            rawtuple[kinfo_proc_map['sgid']])
+
+    @wrap_exceptions
+    def terminal(self):
+        tty_nr = self._get_kinfo_proc()[kinfo_proc_map['ttynr']]
+        tmap = _psposix.get_terminal_map()
+        try:
+            return tmap[tty_nr]
+        except KeyError:
+            return None
+
+    @wrap_exceptions
+    def memory_info(self):
+        rawtuple = self._get_pidtaskinfo()
+        return pmem(
+            rawtuple[pidtaskinfo_map['rss']],
+            rawtuple[pidtaskinfo_map['vms']],
+            rawtuple[pidtaskinfo_map['pfaults']],
+            rawtuple[pidtaskinfo_map['pageins']],
+        )
+
+    @wrap_exceptions
+    def memory_full_info(self):
+        basic_mem = self.memory_info()
+        uss = cext.proc_memory_uss(self.pid)
+        return pfullmem(*basic_mem + (uss, ))
+
+    @wrap_exceptions
+    def cpu_times(self):
+        rawtuple = self._get_pidtaskinfo()
+        return _common.pcputimes(
+            rawtuple[pidtaskinfo_map['cpuutime']],
+            rawtuple[pidtaskinfo_map['cpustime']],
+            # children user / system times are not retrievable (set to 0)
+            0.0, 0.0)
+
+    @wrap_exceptions
+    def create_time(self):
+        return self._get_kinfo_proc()[kinfo_proc_map['ctime']]
+
+    @wrap_exceptions
+    def num_ctx_switches(self):
+        # Unvoluntary value seems not to be available;
+        # getrusage() numbers seems to confirm this theory.
+        # We set it to 0.
+        vol = self._get_pidtaskinfo()[pidtaskinfo_map['volctxsw']]
+        return _common.pctxsw(vol, 0)
+
+    @wrap_exceptions
+    def num_threads(self):
+        return self._get_pidtaskinfo()[pidtaskinfo_map['numthreads']]
+
+    @wrap_exceptions
+    def open_files(self):
+        if self.pid == 0:
+            return []
+        files = []
+        with catch_zombie(self):
+            rawlist = cext.proc_open_files(self.pid)
+        for path, fd in rawlist:
+            if isfile_strict(path):
+                ntuple = _common.popenfile(path, fd)
+                files.append(ntuple)
+        return files
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        if kind not in conn_tmap:
+            raise ValueError("invalid %r kind argument; choose between %s"
+                             % (kind, ', '.join([repr(x) for x in conn_tmap])))
+        families, types = conn_tmap[kind]
+        with catch_zombie(self):
+            rawlist = cext.proc_connections(self.pid, families, types)
+        ret = []
+        for item in rawlist:
+            fd, fam, type, laddr, raddr, status = item
+            nt = conn_to_ntuple(fd, fam, type, laddr, raddr, status,
+                                TCP_STATUSES)
+            ret.append(nt)
+        return ret
+
+    @wrap_exceptions
+    def num_fds(self):
+        if self.pid == 0:
+            return 0
+        with catch_zombie(self):
+            return cext.proc_num_fds(self.pid)
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        return _psposix.wait_pid(self.pid, timeout, self._name)
+
+    @wrap_exceptions
+    def nice_get(self):
+        with catch_zombie(self):
+            return cext_posix.getpriority(self.pid)
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        with catch_zombie(self):
+            return cext_posix.setpriority(self.pid, value)
+
+    @wrap_exceptions
+    def status(self):
+        code = self._get_kinfo_proc()[kinfo_proc_map['status']]
+        # XXX is '?' legit? (we're not supposed to return it anyway)
+        return PROC_STATUSES.get(code, '?')
+
+    @wrap_exceptions
+    def threads(self):
+        rawlist = cext.proc_threads(self.pid)
+        retlist = []
+        for thread_id, utime, stime in rawlist:
+            ntuple = _common.pthread(thread_id, utime, stime)
+            retlist.append(ntuple)
+        return retlist
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psposix.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psposix.py
new file mode 100644
index 0000000000000000000000000000000000000000..706dab9ae8f9ead7d5d31ad62d0177f7cfd9f955
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psposix.py
@@ -0,0 +1,223 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Routines common to all posix systems."""
+
+import glob
+import os
+import signal
+import sys
+import time
+
+from ._common import memoize
+from ._common import sdiskusage
+from ._common import TimeoutExpired
+from ._common import usage_percent
+from ._compat import ChildProcessError
+from ._compat import FileNotFoundError
+from ._compat import InterruptedError
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import PY3
+from ._compat import unicode
+
+if sys.version_info >= (3, 4):
+    import enum
+else:
+    enum = None
+
+
+__all__ = ['pid_exists', 'wait_pid', 'disk_usage', 'get_terminal_map']
+
+
+def pid_exists(pid):
+    """Check whether pid exists in the current process table."""
+    if pid == 0:
+        # According to "man 2 kill" PID 0 has a special meaning:
+        # it refers to <<every process in the process group of the
+        # calling process>> so we don't want to go any further.
+        # If we get here it means this UNIX platform *does* have
+        # a process with id 0.
+        return True
+    try:
+        os.kill(pid, 0)
+    except ProcessLookupError:
+        return False
+    except PermissionError:
+        # EPERM clearly means there's a process to deny access to
+        return True
+    # According to "man 2 kill" possible error values are
+    # (EINVAL, EPERM, ESRCH)
+    else:
+        return True
+
+
+# Python 3.5 signals enum (contributed by me ^^):
+# https://bugs.python.org/issue21076
+if enum is not None and hasattr(signal, "Signals"):
+    Negsignal = enum.IntEnum(
+        'Negsignal', dict([(x.name, -x.value) for x in signal.Signals]))
+
+    def negsig_to_enum(num):
+        """Convert a negative signal value to an enum."""
+        try:
+            return Negsignal(num)
+        except ValueError:
+            return num
+else:  # pragma: no cover
+    def negsig_to_enum(num):
+        return num
+
+
+def wait_pid(pid, timeout=None, proc_name=None,
+             _waitpid=os.waitpid,
+             _timer=getattr(time, 'monotonic', time.time),
+             _min=min,
+             _sleep=time.sleep,
+             _pid_exists=pid_exists):
+    """Wait for a process PID to terminate.
+
+    If the process terminated normally by calling exit(3) or _exit(2),
+    or by returning from main(), the return value is the positive integer
+    passed to *exit().
+
+    If it was terminated by a signal it returns the negated value of the
+    signal which caused the termination (e.g. -SIGTERM).
+
+    If PID is not a children of os.getpid() (current process) just
+    wait until the process disappears and return None.
+
+    If PID does not exist at all return None immediately.
+
+    If *timeout* != None and process is still alive raise TimeoutExpired.
+    timeout=0 is also possible (either return immediately or raise).
+    """
+    if pid <= 0:
+        raise ValueError("can't wait for PID 0")  # see "man waitpid"
+    interval = 0.0001
+    flags = 0
+    if timeout is not None:
+        flags |= os.WNOHANG
+        stop_at = _timer() + timeout
+
+    def sleep(interval):
+        # Sleep for some time and return a new increased interval.
+        if timeout is not None:
+            if _timer() >= stop_at:
+                raise TimeoutExpired(timeout, pid=pid, name=proc_name)
+        _sleep(interval)
+        return _min(interval * 2, 0.04)
+
+    # See: https://linux.die.net/man/2/waitpid
+    while True:
+        try:
+            retpid, status = os.waitpid(pid, flags)
+        except InterruptedError:
+            interval = sleep(interval)
+        except ChildProcessError:
+            # This has two meanings:
+            # - PID is not a child of os.getpid() in which case
+            #   we keep polling until it's gone
+            # - PID never existed in the first place
+            # In both cases we'll eventually return None as we
+            # can't determine its exit status code.
+            while _pid_exists(pid):
+                interval = sleep(interval)
+            return
+        else:
+            if retpid == 0:
+                # WNOHANG flag was used and PID is still running.
+                interval = sleep(interval)
+                continue
+            elif os.WIFEXITED(status):
+                # Process terminated normally by calling exit(3) or _exit(2),
+                # or by returning from main(). The return value is the
+                # positive integer passed to *exit().
+                return os.WEXITSTATUS(status)
+            elif os.WIFSIGNALED(status):
+                # Process exited due to a signal. Return the negative value
+                # of that signal.
+                return negsig_to_enum(-os.WTERMSIG(status))
+            # elif os.WIFSTOPPED(status):
+            #     # Process was stopped via SIGSTOP or is being traced, and
+            #     # waitpid() was called with WUNTRACED flag. PID is still
+            #     # alive. From now on waitpid() will keep returning (0, 0)
+            #     # until the process state doesn't change.
+            #     # It may make sense to catch/enable this since stopped PIDs
+            #     # ignore SIGTERM.
+            #     interval = sleep(interval)
+            #     continue
+            # elif os.WIFCONTINUED(status):
+            #     # Process was resumed via SIGCONT and waitpid() was called
+            #     # with WCONTINUED flag.
+            #     interval = sleep(interval)
+            #     continue
+            else:
+                # Should never happen.
+                raise ValueError("unknown process exit status %r" % status)
+
+
+def disk_usage(path):
+    """Return disk usage associated with path.
+    Note: UNIX usually reserves 5% disk space which is not accessible
+    by user. In this function "total" and "used" values reflect the
+    total and used disk space whereas "free" and "percent" represent
+    the "free" and "used percent" user disk space.
+    """
+    if PY3:
+        st = os.statvfs(path)
+    else:  # pragma: no cover
+        # os.statvfs() does not support unicode on Python 2:
+        # - https://github.com/giampaolo/psutil/issues/416
+        # - http://bugs.python.org/issue18695
+        try:
+            st = os.statvfs(path)
+        except UnicodeEncodeError:
+            if isinstance(path, unicode):
+                try:
+                    path = path.encode(sys.getfilesystemencoding())
+                except UnicodeEncodeError:
+                    pass
+                st = os.statvfs(path)
+            else:
+                raise
+
+    # Total space which is only available to root (unless changed
+    # at system level).
+    total = (st.f_blocks * st.f_frsize)
+    # Remaining free space usable by root.
+    avail_to_root = (st.f_bfree * st.f_frsize)
+    # Remaining free space usable by user.
+    avail_to_user = (st.f_bavail * st.f_frsize)
+    # Total space being used in general.
+    used = (total - avail_to_root)
+    # Total space which is available to user (same as 'total' but
+    # for the user).
+    total_user = used + avail_to_user
+    # User usage percent compared to the total amount of space
+    # the user can use. This number would be higher if compared
+    # to root's because the user has less space (usually -5%).
+    usage_percent_user = usage_percent(used, total_user, round_=1)
+
+    # NB: the percentage is -5% than what shown by df due to
+    # reserved blocks that we are currently not considering:
+    # https://github.com/giampaolo/psutil/issues/829#issuecomment-223750462
+    return sdiskusage(
+        total=total, used=used, free=avail_to_user, percent=usage_percent_user)
+
+
+@memoize
+def get_terminal_map():
+    """Get a map of device-id -> path as a dict.
+    Used by Process.terminal()
+    """
+    ret = {}
+    ls = glob.glob('/dev/tty*') + glob.glob('/dev/pts/*')
+    for name in ls:
+        assert name not in ret, name
+        try:
+            ret[os.stat(name).st_rdev] = name
+        except FileNotFoundError:
+            pass
+    return ret
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pssunos.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pssunos.py
new file mode 100644
index 0000000000000000000000000000000000000000..62362b89c63105a8f23686dd65aeb8d0b6558696
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pssunos.py
@@ -0,0 +1,725 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Sun OS Solaris platform implementation."""
+
+import errno
+import functools
+import os
+import socket
+import subprocess
+import sys
+from collections import namedtuple
+from socket import AF_INET
+
+from . import _common
+from . import _psposix
+from . import _psutil_posix as cext_posix
+from . import _psutil_sunos as cext
+from ._common import AccessDenied
+from ._common import AF_INET6
+from ._common import debug
+from ._common import get_procfs_path
+from ._common import isfile_strict
+from ._common import memoize_when_activated
+from ._common import NoSuchProcess
+from ._common import sockfam_to_enum
+from ._common import socktype_to_enum
+from ._common import usage_percent
+from ._common import ZombieProcess
+from ._compat import b
+from ._compat import FileNotFoundError
+from ._compat import PermissionError
+from ._compat import ProcessLookupError
+from ._compat import PY3
+
+
+__extra__all__ = ["CONN_IDLE", "CONN_BOUND", "PROCFS_PATH"]
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+
+PAGE_SIZE = os.sysconf('SC_PAGE_SIZE')
+AF_LINK = cext_posix.AF_LINK
+IS_64_BIT = sys.maxsize > 2**32
+
+CONN_IDLE = "IDLE"
+CONN_BOUND = "BOUND"
+
+PROC_STATUSES = {
+    cext.SSLEEP: _common.STATUS_SLEEPING,
+    cext.SRUN: _common.STATUS_RUNNING,
+    cext.SZOMB: _common.STATUS_ZOMBIE,
+    cext.SSTOP: _common.STATUS_STOPPED,
+    cext.SIDL: _common.STATUS_IDLE,
+    cext.SONPROC: _common.STATUS_RUNNING,  # same as run
+    cext.SWAIT: _common.STATUS_WAITING,
+}
+
+TCP_STATUSES = {
+    cext.TCPS_ESTABLISHED: _common.CONN_ESTABLISHED,
+    cext.TCPS_SYN_SENT: _common.CONN_SYN_SENT,
+    cext.TCPS_SYN_RCVD: _common.CONN_SYN_RECV,
+    cext.TCPS_FIN_WAIT_1: _common.CONN_FIN_WAIT1,
+    cext.TCPS_FIN_WAIT_2: _common.CONN_FIN_WAIT2,
+    cext.TCPS_TIME_WAIT: _common.CONN_TIME_WAIT,
+    cext.TCPS_CLOSED: _common.CONN_CLOSE,
+    cext.TCPS_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
+    cext.TCPS_LAST_ACK: _common.CONN_LAST_ACK,
+    cext.TCPS_LISTEN: _common.CONN_LISTEN,
+    cext.TCPS_CLOSING: _common.CONN_CLOSING,
+    cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
+    cext.TCPS_IDLE: CONN_IDLE,  # sunos specific
+    cext.TCPS_BOUND: CONN_BOUND,  # sunos specific
+}
+
+proc_info_map = dict(
+    ppid=0,
+    rss=1,
+    vms=2,
+    create_time=3,
+    nice=4,
+    num_threads=5,
+    status=6,
+    ttynr=7,
+    uid=8,
+    euid=9,
+    gid=10,
+    egid=11)
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.cpu_times()
+scputimes = namedtuple('scputimes', ['user', 'system', 'idle', 'iowait'])
+# psutil.cpu_times(percpu=True)
+pcputimes = namedtuple('pcputimes',
+                       ['user', 'system', 'children_user', 'children_system'])
+# psutil.virtual_memory()
+svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
+# psutil.Process.memory_info()
+pmem = namedtuple('pmem', ['rss', 'vms'])
+pfullmem = pmem
+# psutil.Process.memory_maps(grouped=True)
+pmmap_grouped = namedtuple('pmmap_grouped',
+                           ['path', 'rss', 'anonymous', 'locked'])
+# psutil.Process.memory_maps(grouped=False)
+pmmap_ext = namedtuple(
+    'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields))
+
+
+# =====================================================================
+# --- memory
+# =====================================================================
+
+
+def virtual_memory():
+    """Report virtual memory metrics."""
+    # we could have done this with kstat, but IMHO this is good enough
+    total = os.sysconf('SC_PHYS_PAGES') * PAGE_SIZE
+    # note: there's no difference on Solaris
+    free = avail = os.sysconf('SC_AVPHYS_PAGES') * PAGE_SIZE
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    return svmem(total, avail, percent, used, free)
+
+
+def swap_memory():
+    """Report swap memory metrics."""
+    sin, sout = cext.swap_mem()
+    # XXX
+    # we are supposed to get total/free by doing so:
+    # http://cvs.opensolaris.org/source/xref/onnv/onnv-gate/
+    #     usr/src/cmd/swap/swap.c
+    # ...nevertheless I can't manage to obtain the same numbers as 'swap'
+    # cmdline utility, so let's parse its output (sigh!)
+    p = subprocess.Popen(['/usr/bin/env', 'PATH=/usr/sbin:/sbin:%s' %
+                          os.environ['PATH'], 'swap', '-l'],
+                         stdout=subprocess.PIPE)
+    stdout, stderr = p.communicate()
+    if PY3:
+        stdout = stdout.decode(sys.stdout.encoding)
+    if p.returncode != 0:
+        raise RuntimeError("'swap -l' failed (retcode=%s)" % p.returncode)
+
+    lines = stdout.strip().split('\n')[1:]
+    if not lines:
+        raise RuntimeError('no swap device(s) configured')
+    total = free = 0
+    for line in lines:
+        line = line.split()
+        t, f = line[-2:]
+        total += int(int(t) * 512)
+        free += int(int(f) * 512)
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    return _common.sswap(total, used, free, percent,
+                         sin * PAGE_SIZE, sout * PAGE_SIZE)
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return system-wide CPU times as a named tuple"""
+    ret = cext.per_cpu_times()
+    return scputimes(*[sum(x) for x in zip(*ret)])
+
+
+def per_cpu_times():
+    """Return system per-CPU times as a list of named tuples"""
+    ret = cext.per_cpu_times()
+    return [scputimes(*x) for x in ret]
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    try:
+        return os.sysconf("SC_NPROCESSORS_ONLN")
+    except ValueError:
+        # mimic os.cpu_count() behavior
+        return None
+
+
+def cpu_count_physical():
+    """Return the number of physical CPUs in the system."""
+    return cext.cpu_count_phys()
+
+
+def cpu_stats():
+    """Return various CPU stats as a named tuple."""
+    ctx_switches, interrupts, syscalls, traps = cext.cpu_stats()
+    soft_interrupts = 0
+    return _common.scpustats(ctx_switches, interrupts, soft_interrupts,
+                             syscalls)
+
+
+# =====================================================================
+# --- disks
+# =====================================================================
+
+
+disk_io_counters = cext.disk_io_counters
+disk_usage = _psposix.disk_usage
+
+
+def disk_partitions(all=False):
+    """Return system disk partitions."""
+    # TODO - the filtering logic should be better checked so that
+    # it tries to reflect 'df' as much as possible
+    retlist = []
+    partitions = cext.disk_partitions()
+    for partition in partitions:
+        device, mountpoint, fstype, opts = partition
+        if device == 'none':
+            device = ''
+        if not all:
+            # Differently from, say, Linux, we don't have a list of
+            # common fs types so the best we can do, AFAIK, is to
+            # filter by filesystem having a total size > 0.
+            try:
+                if not disk_usage(mountpoint).total:
+                    continue
+            except OSError as err:
+                # https://github.com/giampaolo/psutil/issues/1674
+                debug("skipping %r: %r" % (mountpoint, err))
+                continue
+        ntuple = _common.sdiskpart(device, mountpoint, fstype, opts)
+        retlist.append(ntuple)
+    return retlist
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+net_io_counters = cext.net_io_counters
+net_if_addrs = cext_posix.net_if_addrs
+
+
+def net_connections(kind, _pid=-1):
+    """Return socket connections.  If pid == -1 return system-wide
+    connections (as opposed to connections opened by one process only).
+    Only INET sockets are returned (UNIX are not).
+    """
+    cmap = _common.conn_tmap.copy()
+    if _pid == -1:
+        cmap.pop('unix', 0)
+    if kind not in cmap:
+        raise ValueError("invalid %r kind argument; choose between %s"
+                         % (kind, ', '.join([repr(x) for x in cmap])))
+    families, types = _common.conn_tmap[kind]
+    rawlist = cext.net_connections(_pid)
+    ret = set()
+    for item in rawlist:
+        fd, fam, type_, laddr, raddr, status, pid = item
+        if fam not in families:
+            continue
+        if type_ not in types:
+            continue
+        # TODO: refactor and use _common.conn_to_ntuple.
+        if fam in (AF_INET, AF_INET6):
+            if laddr:
+                laddr = _common.addr(*laddr)
+            if raddr:
+                raddr = _common.addr(*raddr)
+        status = TCP_STATUSES[status]
+        fam = sockfam_to_enum(fam)
+        type_ = socktype_to_enum(type_)
+        if _pid == -1:
+            nt = _common.sconn(fd, fam, type_, laddr, raddr, status, pid)
+        else:
+            nt = _common.pconn(fd, fam, type_, laddr, raddr, status)
+        ret.add(nt)
+    return list(ret)
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    ret = cext.net_if_stats()
+    for name, items in ret.items():
+        isup, duplex, speed, mtu = items
+        if hasattr(_common, 'NicDuplex'):
+            duplex = _common.NicDuplex(duplex)
+        ret[name] = _common.snicstats(isup, duplex, speed, mtu)
+    return ret
+
+
+# =====================================================================
+# --- other system functions
+# =====================================================================
+
+
+def boot_time():
+    """The system boot time expressed in seconds since the epoch."""
+    return cext.boot_time()
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    localhost = (':0.0', ':0')
+    for item in rawlist:
+        user, tty, hostname, tstamp, user_process, pid = item
+        # note: the underlying C function includes entries about
+        # system boot, run level and others.  We might want
+        # to use them in the future.
+        if not user_process:
+            continue
+        if hostname in localhost:
+            hostname = 'localhost'
+        nt = _common.suser(user, tty, hostname, tstamp, pid)
+        retlist.append(nt)
+    return retlist
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+def pids():
+    """Returns a list of PIDs currently running on the system."""
+    return [int(x) for x in os.listdir(b(get_procfs_path())) if x.isdigit()]
+
+
+def pid_exists(pid):
+    """Check for the existence of a unix pid."""
+    return _psposix.pid_exists(pid)
+
+
+def wrap_exceptions(fun):
+    """Call callable into a try/except clause and translate ENOENT,
+    EACCES and EPERM in NoSuchProcess or AccessDenied exceptions.
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except (FileNotFoundError, ProcessLookupError):
+            # ENOENT (no such file or directory) gets raised on open().
+            # ESRCH (no such process) can get raised on read() if
+            # process is gone in meantime.
+            if not pid_exists(self.pid):
+                raise NoSuchProcess(self.pid, self._name)
+            else:
+                raise ZombieProcess(self.pid, self._name, self._ppid)
+        except PermissionError:
+            raise AccessDenied(self.pid, self._name)
+        except OSError:
+            if self.pid == 0:
+                if 0 in pids():
+                    raise AccessDenied(self.pid, self._name)
+                else:
+                    raise
+            raise
+    return wrapper
+
+
+class Process(object):
+    """Wrapper class around underlying C implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_procfs_path", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+        self._procfs_path = get_procfs_path()
+
+    def _assert_alive(self):
+        """Raise NSP if the process disappeared on us."""
+        # For those C function who do not raise NSP, possibly returning
+        # incorrect or incomplete result.
+        os.stat('%s/%s' % (self._procfs_path, self.pid))
+
+    def oneshot_enter(self):
+        self._proc_name_and_args.cache_activate(self)
+        self._proc_basic_info.cache_activate(self)
+        self._proc_cred.cache_activate(self)
+
+    def oneshot_exit(self):
+        self._proc_name_and_args.cache_deactivate(self)
+        self._proc_basic_info.cache_deactivate(self)
+        self._proc_cred.cache_deactivate(self)
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _proc_name_and_args(self):
+        return cext.proc_name_and_args(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _proc_basic_info(self):
+        if self.pid == 0 and not \
+                os.path.exists('%s/%s/psinfo' % (self._procfs_path, self.pid)):
+            raise AccessDenied(self.pid)
+        ret = cext.proc_basic_info(self.pid, self._procfs_path)
+        assert len(ret) == len(proc_info_map)
+        return ret
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def _proc_cred(self):
+        return cext.proc_cred(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    def name(self):
+        # note: max len == 15
+        return self._proc_name_and_args()[0]
+
+    @wrap_exceptions
+    def exe(self):
+        try:
+            return os.readlink(
+                "%s/%s/path/a.out" % (self._procfs_path, self.pid))
+        except OSError:
+            pass    # continue and guess the exe name from the cmdline
+        # Will be guessed later from cmdline but we want to explicitly
+        # invoke cmdline here in order to get an AccessDenied
+        # exception if the user has not enough privileges.
+        self.cmdline()
+        return ""
+
+    @wrap_exceptions
+    def cmdline(self):
+        return self._proc_name_and_args()[1].split(' ')
+
+    @wrap_exceptions
+    def environ(self):
+        return cext.proc_environ(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    def create_time(self):
+        return self._proc_basic_info()[proc_info_map['create_time']]
+
+    @wrap_exceptions
+    def num_threads(self):
+        return self._proc_basic_info()[proc_info_map['num_threads']]
+
+    @wrap_exceptions
+    def nice_get(self):
+        # Note #1: getpriority(3) doesn't work for realtime processes.
+        # Psinfo is what ps uses, see:
+        # https://github.com/giampaolo/psutil/issues/1194
+        return self._proc_basic_info()[proc_info_map['nice']]
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        if self.pid in (2, 3):
+            # Special case PIDs: internally setpriority(3) return ESRCH
+            # (no such process), no matter what.
+            # The process actually exists though, as it has a name,
+            # creation time, etc.
+            raise AccessDenied(self.pid, self._name)
+        return cext_posix.setpriority(self.pid, value)
+
+    @wrap_exceptions
+    def ppid(self):
+        self._ppid = self._proc_basic_info()[proc_info_map['ppid']]
+        return self._ppid
+
+    @wrap_exceptions
+    def uids(self):
+        try:
+            real, effective, saved, _, _, _ = self._proc_cred()
+        except AccessDenied:
+            real = self._proc_basic_info()[proc_info_map['uid']]
+            effective = self._proc_basic_info()[proc_info_map['euid']]
+            saved = None
+        return _common.puids(real, effective, saved)
+
+    @wrap_exceptions
+    def gids(self):
+        try:
+            _, _, _, real, effective, saved = self._proc_cred()
+        except AccessDenied:
+            real = self._proc_basic_info()[proc_info_map['gid']]
+            effective = self._proc_basic_info()[proc_info_map['egid']]
+            saved = None
+        return _common.puids(real, effective, saved)
+
+    @wrap_exceptions
+    def cpu_times(self):
+        try:
+            times = cext.proc_cpu_times(self.pid, self._procfs_path)
+        except OSError as err:
+            if err.errno == errno.EOVERFLOW and not IS_64_BIT:
+                # We may get here if we attempt to query a 64bit process
+                # with a 32bit python.
+                # Error originates from read() and also tools like "cat"
+                # fail in the same way (!).
+                # Since there simply is no way to determine CPU times we
+                # return 0.0 as a fallback. See:
+                # https://github.com/giampaolo/psutil/issues/857
+                times = (0.0, 0.0, 0.0, 0.0)
+            else:
+                raise
+        return _common.pcputimes(*times)
+
+    @wrap_exceptions
+    def cpu_num(self):
+        return cext.proc_cpu_num(self.pid, self._procfs_path)
+
+    @wrap_exceptions
+    def terminal(self):
+        procfs_path = self._procfs_path
+        hit_enoent = False
+        tty = wrap_exceptions(
+            self._proc_basic_info()[proc_info_map['ttynr']])
+        if tty != cext.PRNODEV:
+            for x in (0, 1, 2, 255):
+                try:
+                    return os.readlink(
+                        '%s/%d/path/%d' % (procfs_path, self.pid, x))
+                except FileNotFoundError:
+                    hit_enoent = True
+                    continue
+        if hit_enoent:
+            self._assert_alive()
+
+    @wrap_exceptions
+    def cwd(self):
+        # /proc/PID/path/cwd may not be resolved by readlink() even if
+        # it exists (ls shows it). If that's the case and the process
+        # is still alive return None (we can return None also on BSD).
+        # Reference: http://goo.gl/55XgO
+        procfs_path = self._procfs_path
+        try:
+            return os.readlink("%s/%s/path/cwd" % (procfs_path, self.pid))
+        except FileNotFoundError:
+            os.stat("%s/%s" % (procfs_path, self.pid))  # raise NSP or AD
+            return None
+
+    @wrap_exceptions
+    def memory_info(self):
+        ret = self._proc_basic_info()
+        rss = ret[proc_info_map['rss']] * 1024
+        vms = ret[proc_info_map['vms']] * 1024
+        return pmem(rss, vms)
+
+    memory_full_info = memory_info
+
+    @wrap_exceptions
+    def status(self):
+        code = self._proc_basic_info()[proc_info_map['status']]
+        # XXX is '?' legit? (we're not supposed to return it anyway)
+        return PROC_STATUSES.get(code, '?')
+
+    @wrap_exceptions
+    def threads(self):
+        procfs_path = self._procfs_path
+        ret = []
+        tids = os.listdir('%s/%d/lwp' % (procfs_path, self.pid))
+        hit_enoent = False
+        for tid in tids:
+            tid = int(tid)
+            try:
+                utime, stime = cext.query_process_thread(
+                    self.pid, tid, procfs_path)
+            except EnvironmentError as err:
+                if err.errno == errno.EOVERFLOW and not IS_64_BIT:
+                    # We may get here if we attempt to query a 64bit process
+                    # with a 32bit python.
+                    # Error originates from read() and also tools like "cat"
+                    # fail in the same way (!).
+                    # Since there simply is no way to determine CPU times we
+                    # return 0.0 as a fallback. See:
+                    # https://github.com/giampaolo/psutil/issues/857
+                    continue
+                # ENOENT == thread gone in meantime
+                if err.errno == errno.ENOENT:
+                    hit_enoent = True
+                    continue
+                raise
+            else:
+                nt = _common.pthread(tid, utime, stime)
+                ret.append(nt)
+        if hit_enoent:
+            self._assert_alive()
+        return ret
+
+    @wrap_exceptions
+    def open_files(self):
+        retlist = []
+        hit_enoent = False
+        procfs_path = self._procfs_path
+        pathdir = '%s/%d/path' % (procfs_path, self.pid)
+        for fd in os.listdir('%s/%d/fd' % (procfs_path, self.pid)):
+            path = os.path.join(pathdir, fd)
+            if os.path.islink(path):
+                try:
+                    file = os.readlink(path)
+                except FileNotFoundError:
+                    hit_enoent = True
+                    continue
+                else:
+                    if isfile_strict(file):
+                        retlist.append(_common.popenfile(file, int(fd)))
+        if hit_enoent:
+            self._assert_alive()
+        return retlist
+
+    def _get_unix_sockets(self, pid):
+        """Get UNIX sockets used by process by parsing 'pfiles' output."""
+        # TODO: rewrite this in C (...but the damn netstat source code
+        # does not include this part! Argh!!)
+        cmd = "pfiles %s" % pid
+        p = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE,
+                             stderr=subprocess.PIPE)
+        stdout, stderr = p.communicate()
+        if PY3:
+            stdout, stderr = [x.decode(sys.stdout.encoding)
+                              for x in (stdout, stderr)]
+        if p.returncode != 0:
+            if 'permission denied' in stderr.lower():
+                raise AccessDenied(self.pid, self._name)
+            if 'no such process' in stderr.lower():
+                raise NoSuchProcess(self.pid, self._name)
+            raise RuntimeError("%r command error\n%s" % (cmd, stderr))
+
+        lines = stdout.split('\n')[2:]
+        for i, line in enumerate(lines):
+            line = line.lstrip()
+            if line.startswith('sockname: AF_UNIX'):
+                path = line.split(' ', 2)[2]
+                type = lines[i - 2].strip()
+                if type == 'SOCK_STREAM':
+                    type = socket.SOCK_STREAM
+                elif type == 'SOCK_DGRAM':
+                    type = socket.SOCK_DGRAM
+                else:
+                    type = -1
+                yield (-1, socket.AF_UNIX, type, path, "", _common.CONN_NONE)
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        ret = net_connections(kind, _pid=self.pid)
+        # The underlying C implementation retrieves all OS connections
+        # and filters them by PID.  At this point we can't tell whether
+        # an empty list means there were no connections for process or
+        # process is no longer active so we force NSP in case the PID
+        # is no longer there.
+        if not ret:
+            # will raise NSP if process is gone
+            os.stat('%s/%s' % (self._procfs_path, self.pid))
+
+        # UNIX sockets
+        if kind in ('all', 'unix'):
+            ret.extend([_common.pconn(*conn) for conn in
+                        self._get_unix_sockets(self.pid)])
+        return ret
+
+    nt_mmap_grouped = namedtuple('mmap', 'path rss anon locked')
+    nt_mmap_ext = namedtuple('mmap', 'addr perms path rss anon locked')
+
+    @wrap_exceptions
+    def memory_maps(self):
+        def toaddr(start, end):
+            return '%s-%s' % (hex(start)[2:].strip('L'),
+                              hex(end)[2:].strip('L'))
+
+        procfs_path = self._procfs_path
+        retlist = []
+        try:
+            rawlist = cext.proc_memory_maps(self.pid, procfs_path)
+        except OSError as err:
+            if err.errno == errno.EOVERFLOW and not IS_64_BIT:
+                # We may get here if we attempt to query a 64bit process
+                # with a 32bit python.
+                # Error originates from read() and also tools like "cat"
+                # fail in the same way (!).
+                # Since there simply is no way to determine CPU times we
+                # return 0.0 as a fallback. See:
+                # https://github.com/giampaolo/psutil/issues/857
+                return []
+            else:
+                raise
+        hit_enoent = False
+        for item in rawlist:
+            addr, addrsize, perm, name, rss, anon, locked = item
+            addr = toaddr(addr, addrsize)
+            if not name.startswith('['):
+                try:
+                    name = os.readlink(
+                        '%s/%s/path/%s' % (procfs_path, self.pid, name))
+                except OSError as err:
+                    if err.errno == errno.ENOENT:
+                        # sometimes the link may not be resolved by
+                        # readlink() even if it exists (ls shows it).
+                        # If that's the case we just return the
+                        # unresolved link path.
+                        # This seems an incosistency with /proc similar
+                        # to: http://goo.gl/55XgO
+                        name = '%s/%s/path/%s' % (procfs_path, self.pid, name)
+                        hit_enoent = True
+                    else:
+                        raise
+            retlist.append((addr, perm, name, rss, anon, locked))
+        if hit_enoent:
+            self._assert_alive()
+        return retlist
+
+    @wrap_exceptions
+    def num_fds(self):
+        return len(os.listdir("%s/%s/fd" % (self._procfs_path, self.pid)))
+
+    @wrap_exceptions
+    def num_ctx_switches(self):
+        return _common.pctxsw(
+            *cext.proc_num_ctx_switches(self.pid, self._procfs_path))
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        return _psposix.wait_pid(self.pid, timeout, self._name)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_linux.cpython-37m-x86_64-linux-gnu.so b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_linux.cpython-37m-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..43468996e8841cf3f3efa86a2a25e4ca70b35b52
Binary files /dev/null and b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_linux.cpython-37m-x86_64-linux-gnu.so differ
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_posix.cpython-37m-x86_64-linux-gnu.so b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_posix.cpython-37m-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..3ec00cb9dfcda6c0825bdd321ae449b1bd2ffd91
Binary files /dev/null and b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_psutil_posix.cpython-37m-x86_64-linux-gnu.so differ
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pswindows.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pswindows.py
new file mode 100644
index 0000000000000000000000000000000000000000..98baef5955c243efaca335e575163d8b15f7edcb
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/_pswindows.py
@@ -0,0 +1,1105 @@
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Windows platform implementation."""
+
+import contextlib
+import errno
+import functools
+import os
+import signal
+import sys
+import time
+from collections import namedtuple
+
+from . import _common
+from ._common import AccessDenied
+from ._common import conn_tmap
+from ._common import conn_to_ntuple
+from ._common import debug
+from ._common import ENCODING
+from ._common import ENCODING_ERRS
+from ._common import isfile_strict
+from ._common import memoize
+from ._common import memoize_when_activated
+from ._common import NoSuchProcess
+from ._common import parse_environ_block
+from ._common import TimeoutExpired
+from ._common import usage_percent
+from ._compat import long
+from ._compat import lru_cache
+from ._compat import PY3
+from ._compat import range
+from ._compat import unicode
+from ._psutil_windows import ABOVE_NORMAL_PRIORITY_CLASS
+from ._psutil_windows import BELOW_NORMAL_PRIORITY_CLASS
+from ._psutil_windows import HIGH_PRIORITY_CLASS
+from ._psutil_windows import IDLE_PRIORITY_CLASS
+from ._psutil_windows import NORMAL_PRIORITY_CLASS
+from ._psutil_windows import REALTIME_PRIORITY_CLASS
+
+try:
+    from . import _psutil_windows as cext
+except ImportError as err:
+    if str(err).lower().startswith("dll load failed") and \
+            sys.getwindowsversion()[0] < 6:
+        # We may get here if:
+        # 1) we are on an old Windows version
+        # 2) psutil was installed via pip + wheel
+        # See: https://github.com/giampaolo/psutil/issues/811
+        msg = "this Windows version is too old (< Windows Vista); "
+        msg += "psutil 3.4.2 is the latest version which supports Windows "
+        msg += "2000, XP and 2003 server"
+        raise RuntimeError(msg)
+    else:
+        raise
+
+if sys.version_info >= (3, 4):
+    import enum
+else:
+    enum = None
+
+# process priority constants, import from __init__.py:
+# http://msdn.microsoft.com/en-us/library/ms686219(v=vs.85).aspx
+__extra__all__ = [
+    "win_service_iter", "win_service_get",
+    # Process priority
+    "ABOVE_NORMAL_PRIORITY_CLASS", "BELOW_NORMAL_PRIORITY_CLASS",
+    "HIGH_PRIORITY_CLASS", "IDLE_PRIORITY_CLASS", "NORMAL_PRIORITY_CLASS",
+    "REALTIME_PRIORITY_CLASS",
+    # IO priority
+    "IOPRIO_VERYLOW", "IOPRIO_LOW", "IOPRIO_NORMAL", "IOPRIO_HIGH",
+    # others
+    "CONN_DELETE_TCB", "AF_LINK",
+]
+
+
+# =====================================================================
+# --- globals
+# =====================================================================
+
+CONN_DELETE_TCB = "DELETE_TCB"
+ERROR_PARTIAL_COPY = 299
+PYPY = '__pypy__' in sys.builtin_module_names
+
+if enum is None:
+    AF_LINK = -1
+else:
+    AddressFamily = enum.IntEnum('AddressFamily', {'AF_LINK': -1})
+    AF_LINK = AddressFamily.AF_LINK
+
+TCP_STATUSES = {
+    cext.MIB_TCP_STATE_ESTAB: _common.CONN_ESTABLISHED,
+    cext.MIB_TCP_STATE_SYN_SENT: _common.CONN_SYN_SENT,
+    cext.MIB_TCP_STATE_SYN_RCVD: _common.CONN_SYN_RECV,
+    cext.MIB_TCP_STATE_FIN_WAIT1: _common.CONN_FIN_WAIT1,
+    cext.MIB_TCP_STATE_FIN_WAIT2: _common.CONN_FIN_WAIT2,
+    cext.MIB_TCP_STATE_TIME_WAIT: _common.CONN_TIME_WAIT,
+    cext.MIB_TCP_STATE_CLOSED: _common.CONN_CLOSE,
+    cext.MIB_TCP_STATE_CLOSE_WAIT: _common.CONN_CLOSE_WAIT,
+    cext.MIB_TCP_STATE_LAST_ACK: _common.CONN_LAST_ACK,
+    cext.MIB_TCP_STATE_LISTEN: _common.CONN_LISTEN,
+    cext.MIB_TCP_STATE_CLOSING: _common.CONN_CLOSING,
+    cext.MIB_TCP_STATE_DELETE_TCB: CONN_DELETE_TCB,
+    cext.PSUTIL_CONN_NONE: _common.CONN_NONE,
+}
+
+if enum is not None:
+    class Priority(enum.IntEnum):
+        ABOVE_NORMAL_PRIORITY_CLASS = ABOVE_NORMAL_PRIORITY_CLASS
+        BELOW_NORMAL_PRIORITY_CLASS = BELOW_NORMAL_PRIORITY_CLASS
+        HIGH_PRIORITY_CLASS = HIGH_PRIORITY_CLASS
+        IDLE_PRIORITY_CLASS = IDLE_PRIORITY_CLASS
+        NORMAL_PRIORITY_CLASS = NORMAL_PRIORITY_CLASS
+        REALTIME_PRIORITY_CLASS = REALTIME_PRIORITY_CLASS
+
+    globals().update(Priority.__members__)
+
+if enum is None:
+    IOPRIO_VERYLOW = 0
+    IOPRIO_LOW = 1
+    IOPRIO_NORMAL = 2
+    IOPRIO_HIGH = 3
+else:
+    class IOPriority(enum.IntEnum):
+        IOPRIO_VERYLOW = 0
+        IOPRIO_LOW = 1
+        IOPRIO_NORMAL = 2
+        IOPRIO_HIGH = 3
+    globals().update(IOPriority.__members__)
+
+pinfo_map = dict(
+    num_handles=0,
+    ctx_switches=1,
+    user_time=2,
+    kernel_time=3,
+    create_time=4,
+    num_threads=5,
+    io_rcount=6,
+    io_wcount=7,
+    io_rbytes=8,
+    io_wbytes=9,
+    io_count_others=10,
+    io_bytes_others=11,
+    num_page_faults=12,
+    peak_wset=13,
+    wset=14,
+    peak_paged_pool=15,
+    paged_pool=16,
+    peak_non_paged_pool=17,
+    non_paged_pool=18,
+    pagefile=19,
+    peak_pagefile=20,
+    mem_private=21,
+)
+
+
+# =====================================================================
+# --- named tuples
+# =====================================================================
+
+
+# psutil.cpu_times()
+scputimes = namedtuple('scputimes',
+                       ['user', 'system', 'idle', 'interrupt', 'dpc'])
+# psutil.virtual_memory()
+svmem = namedtuple('svmem', ['total', 'available', 'percent', 'used', 'free'])
+# psutil.Process.memory_info()
+pmem = namedtuple(
+    'pmem', ['rss', 'vms',
+             'num_page_faults', 'peak_wset', 'wset', 'peak_paged_pool',
+             'paged_pool', 'peak_nonpaged_pool', 'nonpaged_pool',
+             'pagefile', 'peak_pagefile', 'private'])
+# psutil.Process.memory_full_info()
+pfullmem = namedtuple('pfullmem', pmem._fields + ('uss', ))
+# psutil.Process.memory_maps(grouped=True)
+pmmap_grouped = namedtuple('pmmap_grouped', ['path', 'rss'])
+# psutil.Process.memory_maps(grouped=False)
+pmmap_ext = namedtuple(
+    'pmmap_ext', 'addr perms ' + ' '.join(pmmap_grouped._fields))
+# psutil.Process.io_counters()
+pio = namedtuple('pio', ['read_count', 'write_count',
+                         'read_bytes', 'write_bytes',
+                         'other_count', 'other_bytes'])
+
+
+# =====================================================================
+# --- utils
+# =====================================================================
+
+
+@lru_cache(maxsize=512)
+def convert_dos_path(s):
+    r"""Convert paths using native DOS format like:
+        "\Device\HarddiskVolume1\Windows\systemew\file.txt"
+    into:
+        "C:\Windows\systemew\file.txt"
+    """
+    rawdrive = '\\'.join(s.split('\\')[:3])
+    driveletter = cext.win32_QueryDosDevice(rawdrive)
+    remainder = s[len(rawdrive):]
+    return os.path.join(driveletter, remainder)
+
+
+def py2_strencode(s):
+    """Encode a unicode string to a byte string by using the default fs
+    encoding + "replace" error handler.
+    """
+    if PY3:
+        return s
+    else:
+        if isinstance(s, str):
+            return s
+        else:
+            return s.encode(ENCODING, ENCODING_ERRS)
+
+
+@memoize
+def getpagesize():
+    return cext.getpagesize()
+
+
+# =====================================================================
+# --- memory
+# =====================================================================
+
+
+def virtual_memory():
+    """System virtual memory as a namedtuple."""
+    mem = cext.virtual_mem()
+    totphys, availphys, totpagef, availpagef, totvirt, freevirt = mem
+    #
+    total = totphys
+    avail = availphys
+    free = availphys
+    used = total - avail
+    percent = usage_percent((total - avail), total, round_=1)
+    return svmem(total, avail, percent, used, free)
+
+
+def swap_memory():
+    """Swap system memory as a (total, used, free, sin, sout) tuple."""
+    mem = cext.virtual_mem()
+    total = mem[2]
+    free = mem[3]
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    return _common.sswap(total, used, free, percent, 0, 0)
+
+
+# =====================================================================
+# --- disk
+# =====================================================================
+
+
+disk_io_counters = cext.disk_io_counters
+
+
+def disk_usage(path):
+    """Return disk usage associated with path."""
+    if PY3 and isinstance(path, bytes):
+        # XXX: do we want to use "strict"? Probably yes, in order
+        # to fail immediately. After all we are accepting input here...
+        path = path.decode(ENCODING, errors="strict")
+    total, free = cext.disk_usage(path)
+    used = total - free
+    percent = usage_percent(used, total, round_=1)
+    return _common.sdiskusage(total, used, free, percent)
+
+
+def disk_partitions(all):
+    """Return disk partitions."""
+    rawlist = cext.disk_partitions(all)
+    return [_common.sdiskpart(*x) for x in rawlist]
+
+
+# =====================================================================
+# --- CPU
+# =====================================================================
+
+
+def cpu_times():
+    """Return system CPU times as a named tuple."""
+    user, system, idle = cext.cpu_times()
+    # Internally, GetSystemTimes() is used, and it doesn't return
+    # interrupt and dpc times. cext.per_cpu_times() does, so we
+    # rely on it to get those only.
+    percpu_summed = scputimes(*[sum(n) for n in zip(*cext.per_cpu_times())])
+    return scputimes(user, system, idle,
+                     percpu_summed.interrupt, percpu_summed.dpc)
+
+
+def per_cpu_times():
+    """Return system per-CPU times as a list of named tuples."""
+    ret = []
+    for user, system, idle, interrupt, dpc in cext.per_cpu_times():
+        item = scputimes(user, system, idle, interrupt, dpc)
+        ret.append(item)
+    return ret
+
+
+def cpu_count_logical():
+    """Return the number of logical CPUs in the system."""
+    return cext.cpu_count_logical()
+
+
+def cpu_count_physical():
+    """Return the number of physical CPU cores in the system."""
+    return cext.cpu_count_phys()
+
+
+def cpu_stats():
+    """Return CPU statistics."""
+    ctx_switches, interrupts, dpcs, syscalls = cext.cpu_stats()
+    soft_interrupts = 0
+    return _common.scpustats(ctx_switches, interrupts, soft_interrupts,
+                             syscalls)
+
+
+def cpu_freq():
+    """Return CPU frequency.
+    On Windows per-cpu frequency is not supported.
+    """
+    curr, max_ = cext.cpu_freq()
+    min_ = 0.0
+    return [_common.scpufreq(float(curr), min_, float(max_))]
+
+
+_loadavg_inititialized = False
+
+
+def getloadavg():
+    """Return the number of processes in the system run queue averaged
+    over the last 1, 5, and 15 minutes respectively as a tuple"""
+    global _loadavg_inititialized
+
+    if not _loadavg_inititialized:
+        cext.init_loadavg_counter()
+        _loadavg_inititialized = True
+
+    # Drop to 2 decimal points which is what Linux does
+    raw_loads = cext.getloadavg()
+    return tuple([round(load, 2) for load in raw_loads])
+
+
+# =====================================================================
+# --- network
+# =====================================================================
+
+
+def net_connections(kind, _pid=-1):
+    """Return socket connections.  If pid == -1 return system-wide
+    connections (as opposed to connections opened by one process only).
+    """
+    if kind not in conn_tmap:
+        raise ValueError("invalid %r kind argument; choose between %s"
+                         % (kind, ', '.join([repr(x) for x in conn_tmap])))
+    families, types = conn_tmap[kind]
+    rawlist = cext.net_connections(_pid, families, types)
+    ret = set()
+    for item in rawlist:
+        fd, fam, type, laddr, raddr, status, pid = item
+        nt = conn_to_ntuple(fd, fam, type, laddr, raddr, status, TCP_STATUSES,
+                            pid=pid if _pid == -1 else None)
+        ret.add(nt)
+    return list(ret)
+
+
+def net_if_stats():
+    """Get NIC stats (isup, duplex, speed, mtu)."""
+    ret = {}
+    rawdict = cext.net_if_stats()
+    for name, items in rawdict.items():
+        if not PY3:
+            assert isinstance(name, unicode), type(name)
+            name = py2_strencode(name)
+        isup, duplex, speed, mtu = items
+        if hasattr(_common, 'NicDuplex'):
+            duplex = _common.NicDuplex(duplex)
+        ret[name] = _common.snicstats(isup, duplex, speed, mtu)
+    return ret
+
+
+def net_io_counters():
+    """Return network I/O statistics for every network interface
+    installed on the system as a dict of raw tuples.
+    """
+    ret = cext.net_io_counters()
+    return dict([(py2_strencode(k), v) for k, v in ret.items()])
+
+
+def net_if_addrs():
+    """Return the addresses associated to each NIC."""
+    ret = []
+    for items in cext.net_if_addrs():
+        items = list(items)
+        items[0] = py2_strencode(items[0])
+        ret.append(items)
+    return ret
+
+
+# =====================================================================
+# --- sensors
+# =====================================================================
+
+
+def sensors_battery():
+    """Return battery information."""
+    # For constants meaning see:
+    # https://msdn.microsoft.com/en-us/library/windows/desktop/
+    #     aa373232(v=vs.85).aspx
+    acline_status, flags, percent, secsleft = cext.sensors_battery()
+    power_plugged = acline_status == 1
+    no_battery = bool(flags & 128)
+    charging = bool(flags & 8)
+
+    if no_battery:
+        return None
+    if power_plugged or charging:
+        secsleft = _common.POWER_TIME_UNLIMITED
+    elif secsleft == -1:
+        secsleft = _common.POWER_TIME_UNKNOWN
+
+    return _common.sbattery(percent, secsleft, power_plugged)
+
+
+# =====================================================================
+# --- other system functions
+# =====================================================================
+
+
+_last_btime = 0
+
+
+def boot_time():
+    """The system boot time expressed in seconds since the epoch."""
+    # This dirty hack is to adjust the precision of the returned
+    # value which may have a 1 second fluctuation, see:
+    # https://github.com/giampaolo/psutil/issues/1007
+    global _last_btime
+    ret = float(cext.boot_time())
+    if abs(ret - _last_btime) <= 1:
+        return _last_btime
+    else:
+        _last_btime = ret
+        return ret
+
+
+def users():
+    """Return currently connected users as a list of namedtuples."""
+    retlist = []
+    rawlist = cext.users()
+    for item in rawlist:
+        user, hostname, tstamp = item
+        user = py2_strencode(user)
+        nt = _common.suser(user, None, hostname, tstamp, None)
+        retlist.append(nt)
+    return retlist
+
+
+# =====================================================================
+# --- Windows services
+# =====================================================================
+
+
+def win_service_iter():
+    """Yields a list of WindowsService instances."""
+    for name, display_name in cext.winservice_enumerate():
+        yield WindowsService(py2_strencode(name), py2_strencode(display_name))
+
+
+def win_service_get(name):
+    """Open a Windows service and return it as a WindowsService instance."""
+    service = WindowsService(name, None)
+    service._display_name = service._query_config()['display_name']
+    return service
+
+
+class WindowsService(object):
+    """Represents an installed Windows service."""
+
+    def __init__(self, name, display_name):
+        self._name = name
+        self._display_name = display_name
+
+    def __str__(self):
+        details = "(name=%r, display_name=%r)" % (
+            self._name, self._display_name)
+        return "%s%s" % (self.__class__.__name__, details)
+
+    def __repr__(self):
+        return "<%s at %s>" % (self.__str__(), id(self))
+
+    def __eq__(self, other):
+        # Test for equality with another WindosService object based
+        # on name.
+        if not isinstance(other, WindowsService):
+            return NotImplemented
+        return self._name == other._name
+
+    def __ne__(self, other):
+        return not self == other
+
+    def _query_config(self):
+        with self._wrap_exceptions():
+            display_name, binpath, username, start_type = \
+                cext.winservice_query_config(self._name)
+        # XXX - update _self.display_name?
+        return dict(
+            display_name=py2_strencode(display_name),
+            binpath=py2_strencode(binpath),
+            username=py2_strencode(username),
+            start_type=py2_strencode(start_type))
+
+    def _query_status(self):
+        with self._wrap_exceptions():
+            status, pid = cext.winservice_query_status(self._name)
+        if pid == 0:
+            pid = None
+        return dict(status=status, pid=pid)
+
+    @contextlib.contextmanager
+    def _wrap_exceptions(self):
+        """Ctx manager which translates bare OSError and WindowsError
+        exceptions into NoSuchProcess and AccessDenied.
+        """
+        try:
+            yield
+        except OSError as err:
+            if is_permission_err(err):
+                raise AccessDenied(
+                    pid=None, name=self._name,
+                    msg="service %r is not querable (not enough privileges)" %
+                        self._name)
+            elif err.winerror in (cext.ERROR_INVALID_NAME,
+                                  cext.ERROR_SERVICE_DOES_NOT_EXIST):
+                raise NoSuchProcess(
+                    pid=None, name=self._name,
+                    msg="service %r does not exist)" % self._name)
+            else:
+                raise
+
+    # config query
+
+    def name(self):
+        """The service name. This string is how a service is referenced
+        and can be passed to win_service_get() to get a new
+        WindowsService instance.
+        """
+        return self._name
+
+    def display_name(self):
+        """The service display name. The value is cached when this class
+        is instantiated.
+        """
+        return self._display_name
+
+    def binpath(self):
+        """The fully qualified path to the service binary/exe file as
+        a string, including command line arguments.
+        """
+        return self._query_config()['binpath']
+
+    def username(self):
+        """The name of the user that owns this service."""
+        return self._query_config()['username']
+
+    def start_type(self):
+        """A string which can either be "automatic", "manual" or
+        "disabled".
+        """
+        return self._query_config()['start_type']
+
+    # status query
+
+    def pid(self):
+        """The process PID, if any, else None. This can be passed
+        to Process class to control the service's process.
+        """
+        return self._query_status()['pid']
+
+    def status(self):
+        """Service status as a string."""
+        return self._query_status()['status']
+
+    def description(self):
+        """Service long description."""
+        return py2_strencode(cext.winservice_query_descr(self.name()))
+
+    # utils
+
+    def as_dict(self):
+        """Utility method retrieving all the information above as a
+        dictionary.
+        """
+        d = self._query_config()
+        d.update(self._query_status())
+        d['name'] = self.name()
+        d['display_name'] = self.display_name()
+        d['description'] = self.description()
+        return d
+
+    # actions
+    # XXX: the necessary C bindings for start() and stop() are
+    # implemented but for now I prefer not to expose them.
+    # I may change my mind in the future. Reasons:
+    # - they require Administrator privileges
+    # - can't implement a timeout for stop() (unless by using a thread,
+    #   which sucks)
+    # - would require adding ServiceAlreadyStarted and
+    #   ServiceAlreadyStopped exceptions, adding two new APIs.
+    # - we might also want to have modify(), which would basically mean
+    #   rewriting win32serviceutil.ChangeServiceConfig, which involves a
+    #   lot of stuff (and API constants which would pollute the API), see:
+    #   http://pyxr.sourceforge.net/PyXR/c/python24/lib/site-packages/
+    #       win32/lib/win32serviceutil.py.html#0175
+    # - psutil is typically about "read only" monitoring stuff;
+    #   win_service_* APIs should only be used to retrieve a service and
+    #   check whether it's running
+
+    # def start(self, timeout=None):
+    #     with self._wrap_exceptions():
+    #         cext.winservice_start(self.name())
+    #         if timeout:
+    #             giveup_at = time.time() + timeout
+    #             while True:
+    #                 if self.status() == "running":
+    #                     return
+    #                 else:
+    #                     if time.time() > giveup_at:
+    #                         raise TimeoutExpired(timeout)
+    #                     else:
+    #                         time.sleep(.1)
+
+    # def stop(self):
+    #     # Note: timeout is not implemented because it's just not
+    #     # possible, see:
+    #     # http://stackoverflow.com/questions/11973228/
+    #     with self._wrap_exceptions():
+    #         return cext.winservice_stop(self.name())
+
+
+# =====================================================================
+# --- processes
+# =====================================================================
+
+
+pids = cext.pids
+pid_exists = cext.pid_exists
+ppid_map = cext.ppid_map  # used internally by Process.children()
+
+
+def is_permission_err(exc):
+    """Return True if this is a permission error."""
+    assert isinstance(exc, OSError), exc
+    # On Python 2 OSError doesn't always have 'winerror'. Sometimes
+    # it does, in which case the original exception was WindowsError
+    # (which is a subclass of OSError).
+    return exc.errno in (errno.EPERM, errno.EACCES) or \
+        getattr(exc, "winerror", -1) in (cext.ERROR_ACCESS_DENIED,
+                                         cext.ERROR_PRIVILEGE_NOT_HELD)
+
+
+def convert_oserror(exc, pid=None, name=None):
+    """Convert OSError into NoSuchProcess or AccessDenied."""
+    assert isinstance(exc, OSError), exc
+    if is_permission_err(exc):
+        return AccessDenied(pid=pid, name=name)
+    if exc.errno == errno.ESRCH:
+        return NoSuchProcess(pid=pid, name=name)
+    raise exc
+
+
+def wrap_exceptions(fun):
+    """Decorator which converts OSError into NoSuchProcess or AccessDenied."""
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except OSError as err:
+            raise convert_oserror(err, pid=self.pid, name=self._name)
+    return wrapper
+
+
+def retry_error_partial_copy(fun):
+    """Workaround for https://github.com/giampaolo/psutil/issues/875.
+    See: https://stackoverflow.com/questions/4457745#4457745
+    """
+    @functools.wraps(fun)
+    def wrapper(self, *args, **kwargs):
+        delay = 0.0001
+        times = 33
+        for x in range(times):  # retries for roughly 1 second
+            try:
+                return fun(self, *args, **kwargs)
+            except WindowsError as _:
+                err = _
+                if err.winerror == ERROR_PARTIAL_COPY:
+                    time.sleep(delay)
+                    delay = min(delay * 2, 0.04)
+                    continue
+                else:
+                    raise
+        else:
+            msg = "%s retried %s times, converted to AccessDenied as it's " \
+                "still returning %r" % (fun, times, err)
+            raise AccessDenied(pid=self.pid, name=self._name, msg=msg)
+    return wrapper
+
+
+class Process(object):
+    """Wrapper class around underlying C implementation."""
+
+    __slots__ = ["pid", "_name", "_ppid", "_cache"]
+
+    def __init__(self, pid):
+        self.pid = pid
+        self._name = None
+        self._ppid = None
+
+    # --- oneshot() stuff
+
+    def oneshot_enter(self):
+        self._proc_info.cache_activate(self)
+        self.exe.cache_activate(self)
+
+    def oneshot_exit(self):
+        self._proc_info.cache_deactivate(self)
+        self.exe.cache_deactivate(self)
+
+    @memoize_when_activated
+    def _proc_info(self):
+        """Return multiple information about this process as a
+        raw tuple.
+        """
+        ret = cext.proc_info(self.pid)
+        assert len(ret) == len(pinfo_map)
+        return ret
+
+    def name(self):
+        """Return process name, which on Windows is always the final
+        part of the executable.
+        """
+        # This is how PIDs 0 and 4 are always represented in taskmgr
+        # and process-hacker.
+        if self.pid == 0:
+            return "System Idle Process"
+        if self.pid == 4:
+            return "System"
+        return os.path.basename(self.exe())
+
+    @wrap_exceptions
+    @memoize_when_activated
+    def exe(self):
+        if PYPY:
+            try:
+                exe = cext.proc_exe(self.pid)
+            except WindowsError as err:
+                # 24 = ERROR_TOO_MANY_OPEN_FILES. Not sure why this happens
+                # (perhaps PyPy's JIT delaying garbage collection of files?).
+                if err.errno == 24:
+                    debug("%r forced into AccessDenied" % err)
+                    raise AccessDenied(self.pid, self._name)
+                raise
+        else:
+            exe = cext.proc_exe(self.pid)
+        if not PY3:
+            exe = py2_strencode(exe)
+        if exe.startswith('\\'):
+            return convert_dos_path(exe)
+        return exe  # May be "Registry", "MemCompression", ...
+
+    @wrap_exceptions
+    @retry_error_partial_copy
+    def cmdline(self):
+        if cext.WINVER >= cext.WINDOWS_8_1:
+            # PEB method detects cmdline changes but requires more
+            # privileges: https://github.com/giampaolo/psutil/pull/1398
+            try:
+                ret = cext.proc_cmdline(self.pid, use_peb=True)
+            except OSError as err:
+                if is_permission_err(err):
+                    ret = cext.proc_cmdline(self.pid, use_peb=False)
+                else:
+                    raise
+        else:
+            ret = cext.proc_cmdline(self.pid, use_peb=True)
+        if PY3:
+            return ret
+        else:
+            return [py2_strencode(s) for s in ret]
+
+    @wrap_exceptions
+    @retry_error_partial_copy
+    def environ(self):
+        ustr = cext.proc_environ(self.pid)
+        if ustr and not PY3:
+            assert isinstance(ustr, unicode), type(ustr)
+        return parse_environ_block(py2_strencode(ustr))
+
+    def ppid(self):
+        try:
+            return ppid_map()[self.pid]
+        except KeyError:
+            raise NoSuchProcess(self.pid, self._name)
+
+    def _get_raw_meminfo(self):
+        try:
+            return cext.proc_memory_info(self.pid)
+        except OSError as err:
+            if is_permission_err(err):
+                # TODO: the C ext can probably be refactored in order
+                # to get this from cext.proc_info()
+                info = self._proc_info()
+                return (
+                    info[pinfo_map['num_page_faults']],
+                    info[pinfo_map['peak_wset']],
+                    info[pinfo_map['wset']],
+                    info[pinfo_map['peak_paged_pool']],
+                    info[pinfo_map['paged_pool']],
+                    info[pinfo_map['peak_non_paged_pool']],
+                    info[pinfo_map['non_paged_pool']],
+                    info[pinfo_map['pagefile']],
+                    info[pinfo_map['peak_pagefile']],
+                    info[pinfo_map['mem_private']],
+                )
+            raise
+
+    @wrap_exceptions
+    def memory_info(self):
+        # on Windows RSS == WorkingSetSize and VSM == PagefileUsage.
+        # Underlying C function returns fields of PROCESS_MEMORY_COUNTERS
+        # struct.
+        t = self._get_raw_meminfo()
+        rss = t[2]  # wset
+        vms = t[7]  # pagefile
+        return pmem(*(rss, vms, ) + t)
+
+    @wrap_exceptions
+    def memory_full_info(self):
+        basic_mem = self.memory_info()
+        uss = cext.proc_memory_uss(self.pid)
+        uss *= getpagesize()
+        return pfullmem(*basic_mem + (uss, ))
+
+    def memory_maps(self):
+        try:
+            raw = cext.proc_memory_maps(self.pid)
+        except OSError as err:
+            # XXX - can't use wrap_exceptions decorator as we're
+            # returning a generator; probably needs refactoring.
+            raise convert_oserror(err, self.pid, self._name)
+        else:
+            for addr, perm, path, rss in raw:
+                path = convert_dos_path(path)
+                if not PY3:
+                    path = py2_strencode(path)
+                addr = hex(addr)
+                yield (addr, perm, path, rss)
+
+    @wrap_exceptions
+    def kill(self):
+        return cext.proc_kill(self.pid)
+
+    @wrap_exceptions
+    def send_signal(self, sig):
+        if sig == signal.SIGTERM:
+            cext.proc_kill(self.pid)
+        # py >= 2.7
+        elif sig in (getattr(signal, "CTRL_C_EVENT", object()),
+                     getattr(signal, "CTRL_BREAK_EVENT", object())):
+            os.kill(self.pid, sig)
+        else:
+            raise ValueError(
+                "only SIGTERM, CTRL_C_EVENT and CTRL_BREAK_EVENT signals "
+                "are supported on Windows")
+
+    @wrap_exceptions
+    def wait(self, timeout=None):
+        if timeout is None:
+            cext_timeout = cext.INFINITE
+        else:
+            # WaitForSingleObject() expects time in milliseconds.
+            cext_timeout = int(timeout * 1000)
+
+        timer = getattr(time, 'monotonic', time.time)
+        stop_at = timer() + timeout if timeout is not None else None
+
+        try:
+            # Exit code is supposed to come from GetExitCodeProcess().
+            # May also be None if OpenProcess() failed with
+            # ERROR_INVALID_PARAMETER, meaning PID is already gone.
+            exit_code = cext.proc_wait(self.pid, cext_timeout)
+        except cext.TimeoutExpired:
+            # WaitForSingleObject() returned WAIT_TIMEOUT. Just raise.
+            raise TimeoutExpired(timeout, self.pid, self._name)
+        except cext.TimeoutAbandoned:
+            # WaitForSingleObject() returned WAIT_ABANDONED, see:
+            # https://github.com/giampaolo/psutil/issues/1224
+            # We'll just rely on the internal polling and return None
+            # when the PID disappears. Subprocess module does the same
+            # (return None):
+            # https://github.com/python/cpython/blob/
+            #     be50a7b627d0aa37e08fa8e2d5568891f19903ce/
+            #     Lib/subprocess.py#L1193-L1194
+            exit_code = None
+
+        # At this point WaitForSingleObject() returned WAIT_OBJECT_0,
+        # meaning the process is gone. Stupidly there are cases where
+        # its PID may still stick around so we do a further internal
+        # polling.
+        delay = 0.0001
+        while True:
+            if not pid_exists(self.pid):
+                return exit_code
+            if stop_at and timer() >= stop_at:
+                raise TimeoutExpired(timeout, pid=self.pid, name=self._name)
+            time.sleep(delay)
+            delay = min(delay * 2, 0.04)  # incremental delay
+
+    @wrap_exceptions
+    def username(self):
+        if self.pid in (0, 4):
+            return 'NT AUTHORITY\\SYSTEM'
+        domain, user = cext.proc_username(self.pid)
+        return py2_strencode(domain) + '\\' + py2_strencode(user)
+
+    @wrap_exceptions
+    def create_time(self):
+        # Note: proc_times() not put under oneshot() 'cause create_time()
+        # is already cached by the main Process class.
+        try:
+            user, system, created = cext.proc_times(self.pid)
+            return created
+        except OSError as err:
+            if is_permission_err(err):
+                return self._proc_info()[pinfo_map['create_time']]
+            raise
+
+    @wrap_exceptions
+    def num_threads(self):
+        return self._proc_info()[pinfo_map['num_threads']]
+
+    @wrap_exceptions
+    def threads(self):
+        rawlist = cext.proc_threads(self.pid)
+        retlist = []
+        for thread_id, utime, stime in rawlist:
+            ntuple = _common.pthread(thread_id, utime, stime)
+            retlist.append(ntuple)
+        return retlist
+
+    @wrap_exceptions
+    def cpu_times(self):
+        try:
+            user, system, created = cext.proc_times(self.pid)
+        except OSError as err:
+            if not is_permission_err(err):
+                raise
+            info = self._proc_info()
+            user = info[pinfo_map['user_time']]
+            system = info[pinfo_map['kernel_time']]
+        # Children user/system times are not retrievable (set to 0).
+        return _common.pcputimes(user, system, 0.0, 0.0)
+
+    @wrap_exceptions
+    def suspend(self):
+        cext.proc_suspend_or_resume(self.pid, True)
+
+    @wrap_exceptions
+    def resume(self):
+        cext.proc_suspend_or_resume(self.pid, False)
+
+    @wrap_exceptions
+    @retry_error_partial_copy
+    def cwd(self):
+        if self.pid in (0, 4):
+            raise AccessDenied(self.pid, self._name)
+        # return a normalized pathname since the native C function appends
+        # "\\" at the and of the path
+        path = cext.proc_cwd(self.pid)
+        return py2_strencode(os.path.normpath(path))
+
+    @wrap_exceptions
+    def open_files(self):
+        if self.pid in (0, 4):
+            return []
+        ret = set()
+        # Filenames come in in native format like:
+        # "\Device\HarddiskVolume1\Windows\systemew\file.txt"
+        # Convert the first part in the corresponding drive letter
+        # (e.g. "C:\") by using Windows's QueryDosDevice()
+        raw_file_names = cext.proc_open_files(self.pid)
+        for _file in raw_file_names:
+            _file = convert_dos_path(_file)
+            if isfile_strict(_file):
+                if not PY3:
+                    _file = py2_strencode(_file)
+                ntuple = _common.popenfile(_file, -1)
+                ret.add(ntuple)
+        return list(ret)
+
+    @wrap_exceptions
+    def connections(self, kind='inet'):
+        return net_connections(kind, _pid=self.pid)
+
+    @wrap_exceptions
+    def nice_get(self):
+        value = cext.proc_priority_get(self.pid)
+        if enum is not None:
+            value = Priority(value)
+        return value
+
+    @wrap_exceptions
+    def nice_set(self, value):
+        return cext.proc_priority_set(self.pid, value)
+
+    @wrap_exceptions
+    def ionice_get(self):
+        ret = cext.proc_io_priority_get(self.pid)
+        if enum is not None:
+            ret = IOPriority(ret)
+        return ret
+
+    @wrap_exceptions
+    def ionice_set(self, ioclass, value):
+        if value:
+            raise TypeError("value argument not accepted on Windows")
+        if ioclass not in (IOPRIO_VERYLOW, IOPRIO_LOW, IOPRIO_NORMAL,
+                           IOPRIO_HIGH):
+            raise ValueError("%s is not a valid priority" % ioclass)
+        cext.proc_io_priority_set(self.pid, ioclass)
+
+    @wrap_exceptions
+    def io_counters(self):
+        try:
+            ret = cext.proc_io_counters(self.pid)
+        except OSError as err:
+            if not is_permission_err(err):
+                raise
+            info = self._proc_info()
+            ret = (
+                info[pinfo_map['io_rcount']],
+                info[pinfo_map['io_wcount']],
+                info[pinfo_map['io_rbytes']],
+                info[pinfo_map['io_wbytes']],
+                info[pinfo_map['io_count_others']],
+                info[pinfo_map['io_bytes_others']],
+            )
+        return pio(*ret)
+
+    @wrap_exceptions
+    def status(self):
+        suspended = cext.proc_is_suspended(self.pid)
+        if suspended:
+            return _common.STATUS_STOPPED
+        else:
+            return _common.STATUS_RUNNING
+
+    @wrap_exceptions
+    def cpu_affinity_get(self):
+        def from_bitmask(x):
+            return [i for i in range(64) if (1 << i) & x]
+        bitmask = cext.proc_cpu_affinity_get(self.pid)
+        return from_bitmask(bitmask)
+
+    @wrap_exceptions
+    def cpu_affinity_set(self, value):
+        def to_bitmask(ls):
+            if not ls:
+                raise ValueError("invalid argument %r" % ls)
+            out = 0
+            for b in ls:
+                out |= 2 ** b
+            return out
+
+        # SetProcessAffinityMask() states that ERROR_INVALID_PARAMETER
+        # is returned for an invalid CPU but this seems not to be true,
+        # therefore we check CPUs validy beforehand.
+        allcpus = list(range(len(per_cpu_times())))
+        for cpu in value:
+            if cpu not in allcpus:
+                if not isinstance(cpu, (int, long)):
+                    raise TypeError(
+                        "invalid CPU %r; an integer is required" % cpu)
+                else:
+                    raise ValueError("invalid CPU %r" % cpu)
+
+        bitmask = to_bitmask(value)
+        cext.proc_cpu_affinity_set(self.pid, bitmask)
+
+    @wrap_exceptions
+    def num_handles(self):
+        try:
+            return cext.proc_num_handles(self.pid)
+        except OSError as err:
+            if is_permission_err(err):
+                return self._proc_info()[pinfo_map['num_handles']]
+            raise
+
+    @wrap_exceptions
+    def num_ctx_switches(self):
+        ctx_switches = self._proc_info()[pinfo_map['ctx_switches']]
+        # only voluntary ctx switches are supported
+        return _common.pctxsw(ctx_switches, 0)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..b508a629f6650769c14d18141270ca2d750d97b4
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__init__.py
@@ -0,0 +1,1639 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Test utilities.
+"""
+
+from __future__ import print_function
+import atexit
+import contextlib
+import ctypes
+import errno
+import functools
+import gc
+import inspect
+import os
+import random
+import re
+import select
+import shutil
+import signal
+import socket
+import stat
+import subprocess
+import sys
+import tempfile
+import textwrap
+import threading
+import time
+import warnings
+from socket import AF_INET
+from socket import AF_INET6
+from socket import SOCK_STREAM
+
+import psutil
+from psutil import AIX
+from psutil import LINUX
+from psutil import MACOS
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._common import bytes2human
+from psutil._common import print_color
+from psutil._common import supports_ipv6
+from psutil._compat import FileExistsError
+from psutil._compat import FileNotFoundError
+from psutil._compat import PY3
+from psutil._compat import range
+from psutil._compat import super
+from psutil._compat import u
+from psutil._compat import unicode
+from psutil._compat import which
+
+if PY3:
+    import unittest
+else:
+    import unittest2 as unittest  # requires "pip install unittest2"
+
+try:
+    from unittest import mock  # py3
+except ImportError:
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore")
+        import mock  # NOQA - requires "pip install mock"
+
+if sys.version_info >= (3, 4):
+    import enum
+else:
+    enum = None
+
+
+__all__ = [
+    # constants
+    'APPVEYOR', 'DEVNULL', 'GLOBAL_TIMEOUT', 'TOLERANCE_SYS_MEM', 'NO_RETRIES',
+    'PYPY', 'PYTHON_EXE', 'ROOT_DIR', 'SCRIPTS_DIR', 'TESTFN_PREFIX',
+    'UNICODE_SUFFIX', 'INVALID_UNICODE_SUFFIX', 'TRAVIS', 'CIRRUS',
+    'CI_TESTING', 'VALID_PROC_STATUSES', 'TOLERANCE_DISK_USAGE', 'IS_64BIT',
+    "HAS_CPU_AFFINITY", "HAS_CPU_FREQ", "HAS_ENVIRON", "HAS_PROC_IO_COUNTERS",
+    "HAS_IONICE", "HAS_MEMORY_MAPS", "HAS_PROC_CPU_NUM", "HAS_RLIMIT",
+    "HAS_SENSORS_BATTERY", "HAS_BATTERY", "HAS_SENSORS_FANS",
+    "HAS_SENSORS_TEMPERATURES", "HAS_MEMORY_FULL_INFO",
+    # subprocesses
+    'pyrun', 'terminate', 'reap_children', 'spawn_testproc', 'spawn_zombie',
+    'spawn_children_pair',
+    # threads
+    'ThreadTask'
+    # test utils
+    'unittest', 'skip_on_access_denied', 'skip_on_not_implemented',
+    'retry_on_failure', 'TestMemoryLeak', 'PsutilTestCase',
+    'process_namespace', 'system_namespace', 'print_sysinfo',
+    # install utils
+    'install_pip', 'install_test_deps',
+    # fs utils
+    'chdir', 'safe_rmpath', 'create_exe', 'decode_path', 'encode_path',
+    'get_testfn',
+    # os
+    'get_winver', 'get_kernel_version',
+    # sync primitives
+    'call_until', 'wait_for_pid', 'wait_for_file',
+    # network
+    'check_net_address',
+    'get_free_port', 'bind_socket', 'bind_unix_socket', 'tcp_socketpair',
+    'unix_socketpair', 'create_sockets',
+    # compat
+    'reload_module', 'import_module_by_path',
+    # others
+    'warn', 'copyload_shared_lib', 'is_namedtuple',
+]
+
+
+# ===================================================================
+# --- constants
+# ===================================================================
+
+# --- platforms
+
+PYPY = '__pypy__' in sys.builtin_module_names
+# whether we're running this test suite on a Continuous Integration service
+TRAVIS = 'TRAVIS' in os.environ
+APPVEYOR = 'APPVEYOR' in os.environ
+CIRRUS = 'CIRRUS' in os.environ
+GITHUB_WHEELS = 'CIBUILDWHEEL' in os.environ
+CI_TESTING = TRAVIS or APPVEYOR or CIRRUS or GITHUB_WHEELS
+# are we a 64 bit process?
+IS_64BIT = sys.maxsize > 2 ** 32
+
+
+# --- configurable defaults
+
+# how many times retry_on_failure() decorator will retry
+NO_RETRIES = 10
+# bytes tolerance for system-wide related tests
+TOLERANCE_SYS_MEM = 5 * 1024 * 1024  # 5MB
+TOLERANCE_DISK_USAGE = 10 * 1024 * 1024  # 10MB
+# the timeout used in functions which have to wait
+GLOBAL_TIMEOUT = 5
+# be more tolerant if we're on travis / appveyor in order to avoid
+# false positives
+if CI_TESTING:
+    NO_RETRIES *= 3
+    GLOBAL_TIMEOUT *= 3
+    TOLERANCE_SYS_MEM *= 3
+    TOLERANCE_DISK_USAGE *= 3
+
+# --- file names
+
+# Disambiguate TESTFN for parallel testing.
+if os.name == 'java':
+    # Jython disallows @ in module names
+    TESTFN_PREFIX = '$psutil-%s-' % os.getpid()
+else:
+    TESTFN_PREFIX = '@psutil-%s-' % os.getpid()
+UNICODE_SUFFIX = u("-ƒőő")
+# An invalid unicode string.
+if PY3:
+    INVALID_UNICODE_SUFFIX = b"f\xc0\x80".decode('utf8', 'surrogateescape')
+else:
+    INVALID_UNICODE_SUFFIX = "f\xc0\x80"
+ASCII_FS = sys.getfilesystemencoding().lower() in ('ascii', 'us-ascii')
+
+# --- paths
+
+ROOT_DIR = os.path.realpath(
+    os.path.join(os.path.dirname(__file__), '..', '..'))
+SCRIPTS_DIR = os.path.join(ROOT_DIR, 'scripts')
+HERE = os.path.realpath(os.path.dirname(__file__))
+
+# --- support
+
+HAS_CONNECTIONS_UNIX = POSIX and not SUNOS
+HAS_CPU_AFFINITY = hasattr(psutil.Process, "cpu_affinity")
+HAS_CPU_FREQ = hasattr(psutil, "cpu_freq")
+HAS_GETLOADAVG = hasattr(psutil, "getloadavg")
+HAS_ENVIRON = hasattr(psutil.Process, "environ")
+HAS_IONICE = hasattr(psutil.Process, "ionice")
+HAS_MEMORY_MAPS = hasattr(psutil.Process, "memory_maps")
+HAS_NET_IO_COUNTERS = hasattr(psutil, "net_io_counters")
+HAS_PROC_CPU_NUM = hasattr(psutil.Process, "cpu_num")
+HAS_PROC_IO_COUNTERS = hasattr(psutil.Process, "io_counters")
+HAS_RLIMIT = hasattr(psutil.Process, "rlimit")
+HAS_SENSORS_BATTERY = hasattr(psutil, "sensors_battery")
+try:
+    HAS_BATTERY = HAS_SENSORS_BATTERY and bool(psutil.sensors_battery())
+except Exception:
+    HAS_BATTERY = False
+HAS_SENSORS_FANS = hasattr(psutil, "sensors_fans")
+HAS_SENSORS_TEMPERATURES = hasattr(psutil, "sensors_temperatures")
+HAS_THREADS = hasattr(psutil.Process, "threads")
+SKIP_SYSCONS = (MACOS or AIX) and os.getuid() != 0
+
+# --- misc
+
+
+def _get_py_exe():
+    def attempt(exe):
+        try:
+            subprocess.check_call(
+                [exe, "-V"], stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        except Exception:
+            return None
+        else:
+            return exe
+
+    if GITHUB_WHEELS:
+        if PYPY:
+            return which("pypy3") if PY3 else which("pypy")
+        else:
+            return which('python')
+    elif MACOS:
+        exe = \
+            attempt(sys.executable) or \
+            attempt(os.path.realpath(sys.executable)) or \
+            attempt(which("python%s.%s" % sys.version_info[:2])) or \
+            attempt(psutil.Process().exe())
+        if not exe:
+            raise ValueError("can't find python exe real abspath")
+        return exe
+    else:
+        exe = os.path.realpath(sys.executable)
+        assert os.path.exists(exe), exe
+        return exe
+
+
+PYTHON_EXE = _get_py_exe()
+DEVNULL = open(os.devnull, 'r+')
+atexit.register(DEVNULL.close)
+
+VALID_PROC_STATUSES = [getattr(psutil, x) for x in dir(psutil)
+                       if x.startswith('STATUS_')]
+AF_UNIX = getattr(socket, "AF_UNIX", object())
+
+_subprocesses_started = set()
+_pids_started = set()
+
+
+# ===================================================================
+# --- threads
+# ===================================================================
+
+
+class ThreadTask(threading.Thread):
+    """A thread task which does nothing expect staying alive."""
+
+    def __init__(self):
+        super().__init__()
+        self._running = False
+        self._interval = 0.001
+        self._flag = threading.Event()
+
+    def __repr__(self):
+        name = self.__class__.__name__
+        return '<%s running=%s at %#x>' % (name, self._running, id(self))
+
+    def __enter__(self):
+        self.start()
+        return self
+
+    def __exit__(self, *args, **kwargs):
+        self.stop()
+
+    def start(self):
+        """Start thread and keep it running until an explicit
+        stop() request. Polls for shutdown every 'timeout' seconds.
+        """
+        if self._running:
+            raise ValueError("already started")
+        threading.Thread.start(self)
+        self._flag.wait()
+
+    def run(self):
+        self._running = True
+        self._flag.set()
+        while self._running:
+            time.sleep(self._interval)
+
+    def stop(self):
+        """Stop thread execution and and waits until it is stopped."""
+        if not self._running:
+            raise ValueError("already stopped")
+        self._running = False
+        self.join()
+
+
+# ===================================================================
+# --- subprocesses
+# ===================================================================
+
+
+def _reap_children_on_err(fun):
+    @functools.wraps(fun)
+    def wrapper(*args, **kwargs):
+        try:
+            return fun(*args, **kwargs)
+        except Exception:
+            reap_children()
+            raise
+    return wrapper
+
+
+@_reap_children_on_err
+def spawn_testproc(cmd=None, **kwds):
+    """Creates a python subprocess which does nothing for 60 secs and
+    return it as a subprocess.Popen instance.
+    If "cmd" is specified that is used instead of python.
+    By default stdin and stdout are redirected to /dev/null.
+    It also attemps to make sure the process is in a reasonably
+    initialized state.
+    The process is registered for cleanup on reap_children().
+    """
+    kwds.setdefault("stdin", DEVNULL)
+    kwds.setdefault("stdout", DEVNULL)
+    kwds.setdefault("cwd", os.getcwd())
+    kwds.setdefault("env", os.environ)
+    if WINDOWS:
+        # Prevents the subprocess to open error dialogs. This will also
+        # cause stderr to be suppressed, which is suboptimal in order
+        # to debug broken tests.
+        CREATE_NO_WINDOW = 0x8000000
+        kwds.setdefault("creationflags", CREATE_NO_WINDOW)
+    if cmd is None:
+        testfn = get_testfn()
+        try:
+            safe_rmpath(testfn)
+            pyline = "from time import sleep;" \
+                     "open(r'%s', 'w').close();" \
+                     "sleep(60);" % testfn
+            cmd = [PYTHON_EXE, "-c", pyline]
+            sproc = subprocess.Popen(cmd, **kwds)
+            _subprocesses_started.add(sproc)
+            wait_for_file(testfn, delete=True, empty=True)
+        finally:
+            safe_rmpath(testfn)
+    else:
+        sproc = subprocess.Popen(cmd, **kwds)
+        _subprocesses_started.add(sproc)
+        wait_for_pid(sproc.pid)
+    return sproc
+
+
+@_reap_children_on_err
+def spawn_children_pair():
+    """Create a subprocess which creates another one as in:
+    A (us) -> B (child) -> C (grandchild).
+    Return a (child, grandchild) tuple.
+    The 2 processes are fully initialized and will live for 60 secs
+    and are registered for cleanup on reap_children().
+    """
+    tfile = None
+    testfn = get_testfn(dir=os.getcwd())
+    try:
+        s = textwrap.dedent("""\
+            import subprocess, os, sys, time
+            s = "import os, time;"
+            s += "f = open('%s', 'w');"
+            s += "f.write(str(os.getpid()));"
+            s += "f.close();"
+            s += "time.sleep(60);"
+            p = subprocess.Popen([r'%s', '-c', s])
+            p.wait()
+            """ % (os.path.basename(testfn), PYTHON_EXE))
+        # On Windows if we create a subprocess with CREATE_NO_WINDOW flag
+        # set (which is the default) a "conhost.exe" extra process will be
+        # spawned as a child. We don't want that.
+        if WINDOWS:
+            subp, tfile = pyrun(s, creationflags=0)
+        else:
+            subp, tfile = pyrun(s)
+        child = psutil.Process(subp.pid)
+        grandchild_pid = int(wait_for_file(testfn, delete=True, empty=False))
+        _pids_started.add(grandchild_pid)
+        grandchild = psutil.Process(grandchild_pid)
+        return (child, grandchild)
+    finally:
+        safe_rmpath(testfn)
+        if tfile is not None:
+            safe_rmpath(tfile)
+
+
+def spawn_zombie():
+    """Create a zombie process and return a (parent, zombie) process tuple.
+    In order to kill the zombie parent must be terminate()d first, then
+    zombie must be wait()ed on.
+    """
+    assert psutil.POSIX
+    unix_file = get_testfn()
+    src = textwrap.dedent("""\
+        import os, sys, time, socket, contextlib
+        child_pid = os.fork()
+        if child_pid > 0:
+            time.sleep(3000)
+        else:
+            # this is the zombie process
+            s = socket.socket(socket.AF_UNIX)
+            with contextlib.closing(s):
+                s.connect('%s')
+                if sys.version_info < (3, ):
+                    pid = str(os.getpid())
+                else:
+                    pid = bytes(str(os.getpid()), 'ascii')
+                s.sendall(pid)
+        """ % unix_file)
+    tfile = None
+    sock = bind_unix_socket(unix_file)
+    try:
+        sock.settimeout(GLOBAL_TIMEOUT)
+        parent, tfile = pyrun(src)
+        conn, _ = sock.accept()
+        try:
+            select.select([conn.fileno()], [], [], GLOBAL_TIMEOUT)
+            zpid = int(conn.recv(1024))
+            _pids_started.add(zpid)
+            zombie = psutil.Process(zpid)
+            call_until(lambda: zombie.status(), "ret == psutil.STATUS_ZOMBIE")
+            return (parent, zombie)
+        finally:
+            conn.close()
+    finally:
+        sock.close()
+        safe_rmpath(unix_file)
+        if tfile is not None:
+            safe_rmpath(tfile)
+
+
+@_reap_children_on_err
+def pyrun(src, **kwds):
+    """Run python 'src' code string in a separate interpreter.
+    Returns a subprocess.Popen instance and the test file where the source
+    code was written.
+    """
+    kwds.setdefault("stdout", None)
+    kwds.setdefault("stderr", None)
+    srcfile = get_testfn()
+    try:
+        with open(srcfile, 'wt') as f:
+            f.write(src)
+        subp = spawn_testproc([PYTHON_EXE, f.name], **kwds)
+        wait_for_pid(subp.pid)
+        return (subp, srcfile)
+    except Exception:
+        safe_rmpath(srcfile)
+        raise
+
+
+@_reap_children_on_err
+def sh(cmd, **kwds):
+    """run cmd in a subprocess and return its output.
+    raises RuntimeError on error.
+    """
+    shell = True if isinstance(cmd, (str, unicode)) else False
+    # Prevents subprocess to open error dialogs in case of error.
+    flags = 0x8000000 if WINDOWS and shell else 0
+    kwds.setdefault("shell", shell)
+    kwds.setdefault("stdout", subprocess.PIPE)
+    kwds.setdefault("stderr", subprocess.PIPE)
+    kwds.setdefault("universal_newlines", True)
+    kwds.setdefault("creationflags", flags)
+    p = subprocess.Popen(cmd, **kwds)
+    _subprocesses_started.add(p)
+    if PY3:
+        stdout, stderr = p.communicate(timeout=GLOBAL_TIMEOUT)
+    else:
+        stdout, stderr = p.communicate()
+    if p.returncode != 0:
+        raise RuntimeError(stderr)
+    if stderr:
+        warn(stderr)
+    if stdout.endswith('\n'):
+        stdout = stdout[:-1]
+    return stdout
+
+
+def terminate(proc_or_pid, sig=signal.SIGTERM, wait_timeout=GLOBAL_TIMEOUT):
+    """Terminate a process and wait() for it.
+    Process can be a PID or an instance of psutil.Process(),
+    subprocess.Popen() or psutil.Popen().
+    If it's a subprocess.Popen() or psutil.Popen() instance also closes
+    its stdin / stdout / stderr fds.
+    PID is wait()ed even if the process is already gone (kills zombies).
+    Does nothing if the process does not exist.
+    Return process exit status.
+    """
+    if POSIX:
+        from psutil._psposix import wait_pid
+
+    def wait(proc, timeout):
+        if isinstance(proc, subprocess.Popen) and not PY3:
+            proc.wait()
+        else:
+            proc.wait(timeout)
+        if WINDOWS and isinstance(proc, subprocess.Popen):
+            # Otherwise PID may still hang around.
+            try:
+                return psutil.Process(proc.pid).wait(timeout)
+            except psutil.NoSuchProcess:
+                pass
+
+    def sendsig(proc, sig):
+        # XXX: otherwise the build hangs for some reason.
+        if MACOS and GITHUB_WHEELS:
+            sig = signal.SIGKILL
+        # If the process received SIGSTOP, SIGCONT is necessary first,
+        # otherwise SIGTERM won't work.
+        if POSIX and sig != signal.SIGKILL:
+            proc.send_signal(signal.SIGCONT)
+        proc.send_signal(sig)
+
+    def term_subproc(proc, timeout):
+        try:
+            sendsig(proc, sig)
+        except OSError as err:
+            if WINDOWS and err.winerror == 6:  # "invalid handle"
+                pass
+            elif err.errno != errno.ESRCH:
+                raise
+        return wait(proc, timeout)
+
+    def term_psproc(proc, timeout):
+        try:
+            sendsig(proc, sig)
+        except psutil.NoSuchProcess:
+            pass
+        return wait(proc, timeout)
+
+    def term_pid(pid, timeout):
+        try:
+            proc = psutil.Process(pid)
+        except psutil.NoSuchProcess:
+            # Needed to kill zombies.
+            if POSIX:
+                return wait_pid(pid, timeout)
+        else:
+            return term_psproc(proc, timeout)
+
+    def flush_popen(proc):
+        if proc.stdout:
+            proc.stdout.close()
+        if proc.stderr:
+            proc.stderr.close()
+        # Flushing a BufferedWriter may raise an error.
+        if proc.stdin:
+            proc.stdin.close()
+
+    p = proc_or_pid
+    try:
+        if isinstance(p, int):
+            return term_pid(p, wait_timeout)
+        elif isinstance(p, (psutil.Process, psutil.Popen)):
+            return term_psproc(p, wait_timeout)
+        elif isinstance(p, subprocess.Popen):
+            return term_subproc(p, wait_timeout)
+        else:
+            raise TypeError("wrong type %r" % p)
+    finally:
+        if isinstance(p, (subprocess.Popen, psutil.Popen)):
+            flush_popen(p)
+        pid = p if isinstance(p, int) else p.pid
+        assert not psutil.pid_exists(pid), pid
+
+
+def reap_children(recursive=False):
+    """Terminate and wait() any subprocess started by this test suite
+    and any children currently running, ensuring that no processes stick
+    around to hog resources.
+    If resursive is True it also tries to terminate and wait()
+    all grandchildren started by this process.
+    """
+    # Get the children here before terminating them, as in case of
+    # recursive=True we don't want to lose the intermediate reference
+    # pointing to the grandchildren.
+    children = psutil.Process().children(recursive=recursive)
+
+    # Terminate subprocess.Popen.
+    while _subprocesses_started:
+        subp = _subprocesses_started.pop()
+        terminate(subp)
+
+    # Collect started pids.
+    while _pids_started:
+        pid = _pids_started.pop()
+        terminate(pid)
+
+    # Terminate children.
+    if children:
+        for p in children:
+            terminate(p, wait_timeout=None)
+        gone, alive = psutil.wait_procs(children, timeout=GLOBAL_TIMEOUT)
+        for p in alive:
+            warn("couldn't terminate process %r; attempting kill()" % p)
+            terminate(p, sig=signal.SIGKILL)
+
+
+# ===================================================================
+# --- OS
+# ===================================================================
+
+
+def get_kernel_version():
+    """Return a tuple such as (2, 6, 36)."""
+    if not POSIX:
+        raise NotImplementedError("not POSIX")
+    s = ""
+    uname = os.uname()[2]
+    for c in uname:
+        if c.isdigit() or c == '.':
+            s += c
+        else:
+            break
+    if not s:
+        raise ValueError("can't parse %r" % uname)
+    minor = 0
+    micro = 0
+    nums = s.split('.')
+    major = int(nums[0])
+    if len(nums) >= 2:
+        minor = int(nums[1])
+    if len(nums) >= 3:
+        micro = int(nums[2])
+    return (major, minor, micro)
+
+
+def get_winver():
+    if not WINDOWS:
+        raise NotImplementedError("not WINDOWS")
+    wv = sys.getwindowsversion()
+    if hasattr(wv, 'service_pack_major'):  # python >= 2.7
+        sp = wv.service_pack_major or 0
+    else:
+        r = re.search(r"\s\d$", wv[4])
+        if r:
+            sp = int(r.group(0))
+        else:
+            sp = 0
+    return (wv[0], wv[1], sp)
+
+
+# ===================================================================
+# --- sync primitives
+# ===================================================================
+
+
+class retry(object):
+    """A retry decorator."""
+
+    def __init__(self,
+                 exception=Exception,
+                 timeout=None,
+                 retries=None,
+                 interval=0.001,
+                 logfun=None,
+                 ):
+        if timeout and retries:
+            raise ValueError("timeout and retries args are mutually exclusive")
+        self.exception = exception
+        self.timeout = timeout
+        self.retries = retries
+        self.interval = interval
+        self.logfun = logfun
+
+    def __iter__(self):
+        if self.timeout:
+            stop_at = time.time() + self.timeout
+            while time.time() < stop_at:
+                yield
+        elif self.retries:
+            for _ in range(self.retries):
+                yield
+        else:
+            while True:
+                yield
+
+    def sleep(self):
+        if self.interval is not None:
+            time.sleep(self.interval)
+
+    def __call__(self, fun):
+        @functools.wraps(fun)
+        def wrapper(*args, **kwargs):
+            exc = None
+            for _ in self:
+                try:
+                    return fun(*args, **kwargs)
+                except self.exception as _:  # NOQA
+                    exc = _
+                    if self.logfun is not None:
+                        self.logfun(exc)
+                    self.sleep()
+                    continue
+            if PY3:
+                raise exc
+            else:
+                raise
+
+        # This way the user of the decorated function can change config
+        # parameters.
+        wrapper.decorator = self
+        return wrapper
+
+
+@retry(exception=psutil.NoSuchProcess, logfun=None, timeout=GLOBAL_TIMEOUT,
+       interval=0.001)
+def wait_for_pid(pid):
+    """Wait for pid to show up in the process list then return.
+    Used in the test suite to give time the sub process to initialize.
+    """
+    psutil.Process(pid)
+    if WINDOWS:
+        # give it some more time to allow better initialization
+        time.sleep(0.01)
+
+
+@retry(exception=(FileNotFoundError, AssertionError), logfun=None,
+       timeout=GLOBAL_TIMEOUT, interval=0.001)
+def wait_for_file(fname, delete=True, empty=False):
+    """Wait for a file to be written on disk with some content."""
+    with open(fname, "rb") as f:
+        data = f.read()
+    if not empty:
+        assert data
+    if delete:
+        safe_rmpath(fname)
+    return data
+
+
+@retry(exception=AssertionError, logfun=None, timeout=GLOBAL_TIMEOUT,
+       interval=0.001)
+def call_until(fun, expr):
+    """Keep calling function for timeout secs and exit if eval()
+    expression is True.
+    """
+    ret = fun()
+    assert eval(expr)
+    return ret
+
+
+# ===================================================================
+# --- fs
+# ===================================================================
+
+
+def safe_rmpath(path):
+    "Convenience function for removing temporary test files or dirs"
+    def retry_fun(fun):
+        # On Windows it could happen that the file or directory has
+        # open handles or references preventing the delete operation
+        # to succeed immediately, so we retry for a while. See:
+        # https://bugs.python.org/issue33240
+        stop_at = time.time() + GLOBAL_TIMEOUT
+        while time.time() < stop_at:
+            try:
+                return fun()
+            except FileNotFoundError:
+                pass
+            except WindowsError as _:
+                err = _
+                warn("ignoring %s" % (str(err)))
+            time.sleep(0.01)
+        raise err
+
+    try:
+        st = os.stat(path)
+        if stat.S_ISDIR(st.st_mode):
+            fun = functools.partial(shutil.rmtree, path)
+        else:
+            fun = functools.partial(os.remove, path)
+        if POSIX:
+            fun()
+        else:
+            retry_fun(fun)
+    except FileNotFoundError:
+        pass
+
+
+def safe_mkdir(dir):
+    "Convenience function for creating a directory"
+    try:
+        os.mkdir(dir)
+    except FileExistsError:
+        pass
+
+
+@contextlib.contextmanager
+def chdir(dirname):
+    "Context manager which temporarily changes the current directory."
+    curdir = os.getcwd()
+    try:
+        os.chdir(dirname)
+        yield
+    finally:
+        os.chdir(curdir)
+
+
+def create_exe(outpath, c_code=None):
+    """Creates an executable file in the given location."""
+    assert not os.path.exists(outpath), outpath
+    if c_code:
+        if not which("gcc"):
+            raise ValueError("gcc is not installed")
+        if isinstance(c_code, bool):        # c_code is True
+            c_code = textwrap.dedent(
+                """
+                #include <unistd.h>
+                int main() {
+                    pause();
+                    return 1;
+                }
+                """)
+        assert isinstance(c_code, str), c_code
+        with open(get_testfn(suffix='.c'), 'wt') as f:
+            f.write(c_code)
+        try:
+            subprocess.check_call(["gcc", f.name, "-o", outpath])
+        finally:
+            safe_rmpath(f.name)
+    else:
+        # copy python executable
+        shutil.copyfile(PYTHON_EXE, outpath)
+        if POSIX:
+            st = os.stat(outpath)
+            os.chmod(outpath, st.st_mode | stat.S_IEXEC)
+
+
+def get_testfn(suffix="", dir=None):
+    """Return an absolute pathname of a file or dir that did not
+    exist at the time this call is made. Also schedule it for safe
+    deletion at interpreter exit. It's technically racy but probably
+    not really due to the time variant.
+    """
+    while True:
+        name = tempfile.mktemp(prefix=TESTFN_PREFIX, suffix=suffix, dir=dir)
+        if not os.path.exists(name):  # also include dirs
+            return os.path.realpath(name)  # needed for OSX
+
+
+# ===================================================================
+# --- testing
+# ===================================================================
+
+
+class TestCase(unittest.TestCase):
+
+    # Print a full path representation of the single unit tests
+    # being run.
+    def __str__(self):
+        fqmod = self.__class__.__module__
+        if not fqmod.startswith('psutil.'):
+            fqmod = 'psutil.tests.' + fqmod
+        return "%s.%s.%s" % (
+            fqmod, self.__class__.__name__, self._testMethodName)
+
+    # assertRaisesRegexp renamed to assertRaisesRegex in 3.3;
+    # add support for the new name.
+    if not hasattr(unittest.TestCase, 'assertRaisesRegex'):
+        assertRaisesRegex = unittest.TestCase.assertRaisesRegexp
+
+    # ...otherwise multiprocessing.Pool complains
+    if not PY3:
+        def runTest(self):
+            pass
+
+
+# monkey patch default unittest.TestCase
+unittest.TestCase = TestCase
+
+
+class PsutilTestCase(TestCase):
+    """Test class providing auto-cleanup wrappers on top of process
+    test utilities.
+    """
+
+    def get_testfn(self, suffix="", dir=None):
+        fname = get_testfn(suffix=suffix, dir=dir)
+        self.addCleanup(safe_rmpath, fname)
+        return fname
+
+    def spawn_testproc(self, *args, **kwds):
+        sproc = spawn_testproc(*args, **kwds)
+        self.addCleanup(terminate, sproc)
+        return sproc
+
+    def spawn_children_pair(self):
+        child1, child2 = spawn_children_pair()
+        self.addCleanup(terminate, child2)
+        self.addCleanup(terminate, child1)  # executed first
+        return (child1, child2)
+
+    def spawn_zombie(self):
+        parent, zombie = spawn_zombie()
+        self.addCleanup(terminate, zombie)
+        self.addCleanup(terminate, parent)  # executed first
+        return (parent, zombie)
+
+    def pyrun(self, *args, **kwds):
+        sproc, srcfile = pyrun(*args, **kwds)
+        self.addCleanup(safe_rmpath, srcfile)
+        self.addCleanup(terminate, sproc)  # executed first
+        return sproc
+
+    def assertProcessGone(self, proc):
+        self.assertRaises(psutil.NoSuchProcess, psutil.Process, proc.pid)
+        if isinstance(proc, (psutil.Process, psutil.Popen)):
+            assert not proc.is_running()
+            self.assertRaises(psutil.NoSuchProcess, proc.status)
+            proc.wait(timeout=0)  # assert not raise TimeoutExpired
+        assert not psutil.pid_exists(proc.pid), proc.pid
+        self.assertNotIn(proc.pid, psutil.pids())
+
+
+@unittest.skipIf(PYPY, "unreliable on PYPY")
+class TestMemoryLeak(PsutilTestCase):
+    """Test framework class for detecting function memory leaks,
+    typically functions implemented in C which forgot to free() memory
+    from the heap. It does so by checking whether the process memory
+    usage increased before and after calling the function many times.
+
+    Note that this is hard (probably impossible) to do reliably, due
+    to how the OS handles memory, the GC and so on (memory can even
+    decrease!). In order to avoid false positives, in case of failure
+    (mem > 0) we retry the test for up to 5 times, increasing call
+    repetitions each time. If the memory keeps increasing then it's a
+    failure.
+
+    If available (Linux, OSX, Windows), USS memory is used for comparison,
+    since it's supposed to be more precise, see:
+    https://gmpy.dev/blog/2016/real-process-memory-and-environ-in-python
+    If not, RSS memory is used. mallinfo() on Linux and _heapwalk() on
+    Windows may give even more precision, but at the moment are not
+    implemented.
+
+    PyPy appears to be completely unstable for this framework, probably
+    because of its JIT, so tests on PYPY are skipped.
+
+    Usage:
+
+        class TestLeaks(psutil.tests.TestMemoryLeak):
+
+            def test_fun(self):
+                self.execute(some_function)
+    """
+    # Configurable class attrs.
+    times = 200
+    warmup_times = 10
+    tolerance = 0  # memory
+    retries = 10 if CI_TESTING else 5
+    verbose = True
+    _thisproc = psutil.Process()
+
+    def _get_mem(self):
+        # USS is the closest thing we have to "real" memory usage and it
+        # should be less likely to produce false positives.
+        mem = self._thisproc.memory_full_info()
+        return getattr(mem, "uss", mem.rss)
+
+    def _get_num_fds(self):
+        if POSIX:
+            return self._thisproc.num_fds()
+        else:
+            return self._thisproc.num_handles()
+
+    def _log(self, msg):
+        if self.verbose:
+            print_color(msg, color="yellow", file=sys.stderr)
+
+    def _check_fds(self, fun):
+        """Makes sure num_fds() (POSIX) or num_handles() (Windows) does
+        not increase after calling a function.  Used to discover forgotten
+        close(2) and CloseHandle syscalls.
+        """
+        before = self._get_num_fds()
+        self.call(fun)
+        after = self._get_num_fds()
+        diff = after - before
+        if diff < 0:
+            raise self.fail("negative diff %r (gc probably collected a "
+                            "resource from a previous test)" % diff)
+        if diff > 0:
+            type_ = "fd" if POSIX else "handle"
+            if diff > 1:
+                type_ += "s"
+            msg = "%s unclosed %s after calling %r" % (diff, type_, fun)
+            raise self.fail(msg)
+
+    def _call_ntimes(self, fun, times):
+        """Get 2 distinct memory samples, before and after having
+        called fun repeadetly, and return the memory difference.
+        """
+        gc.collect(generation=1)
+        mem1 = self._get_mem()
+        for x in range(times):
+            ret = self.call(fun)
+            del x, ret
+        gc.collect(generation=1)
+        mem2 = self._get_mem()
+        self.assertEqual(gc.garbage, [])
+        diff = mem2 - mem1  # can also be negative
+        return diff
+
+    def _check_mem(self, fun, times, warmup_times, retries, tolerance):
+        messages = []
+        prev_mem = 0
+        increase = times
+        for idx in range(1, retries + 1):
+            mem = self._call_ntimes(fun, times)
+            msg = "Run #%s: extra-mem=%s, per-call=%s, calls=%s" % (
+                idx, bytes2human(mem), bytes2human(mem / times), times)
+            messages.append(msg)
+            success = mem <= tolerance or mem <= prev_mem
+            if success:
+                if idx > 1:
+                    self._log(msg)
+                return
+            else:
+                if idx == 1:
+                    print()  # NOQA
+                self._log(msg)
+                times += increase
+                prev_mem = mem
+        raise self.fail(". ".join(messages))
+
+    # ---
+
+    def call(self, fun):
+        return fun()
+
+    def execute(self, fun, times=None, warmup_times=None, retries=None,
+                tolerance=None):
+        """Test a callable."""
+        times = times if times is not None else self.times
+        warmup_times = warmup_times if warmup_times is not None \
+            else self.warmup_times
+        retries = retries if retries is not None else self.retries
+        tolerance = tolerance if tolerance is not None else self.tolerance
+        try:
+            assert times >= 1, "times must be >= 1"
+            assert warmup_times >= 0, "warmup_times must be >= 0"
+            assert retries >= 0, "retries must be >= 0"
+            assert tolerance >= 0, "tolerance must be >= 0"
+        except AssertionError as err:
+            raise ValueError(str(err))
+
+        self._call_ntimes(fun, warmup_times)  # warm up
+        self._check_fds(fun)
+        self._check_mem(fun, times=times, warmup_times=warmup_times,
+                        retries=retries, tolerance=tolerance)
+
+    def execute_w_exc(self, exc, fun, **kwargs):
+        """Convenience method to test a callable while making sure it
+        raises an exception on every call.
+        """
+        def call():
+            self.assertRaises(exc, fun)
+
+        self.execute(call, **kwargs)
+
+
+def print_sysinfo():
+    import collections
+    import datetime
+    import getpass
+    import platform
+
+    info = collections.OrderedDict()
+    info['OS'] = platform.system()
+    if psutil.OSX:
+        info['version'] = str(platform.mac_ver())
+    elif psutil.WINDOWS:
+        info['version'] = ' '.join(map(str, platform.win32_ver()))
+        if hasattr(platform, 'win32_edition'):
+            info['edition'] = platform.win32_edition()
+    else:
+        info['version'] = platform.version()
+    if psutil.POSIX:
+        info['kernel'] = '.'.join(map(str, get_kernel_version()))
+    info['arch'] = ', '.join(
+        list(platform.architecture()) + [platform.machine()])
+    info['hostname'] = platform.node()
+    info['python'] = ', '.join([
+        platform.python_implementation(),
+        platform.python_version(),
+        platform.python_compiler()])
+    if psutil.POSIX:
+        s = platform.libc_ver()[1]
+        if s:
+            info['glibc'] = s
+    info['fs-encoding'] = sys.getfilesystemencoding()
+    info['time'] = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    info['user'] = getpass.getuser()
+    info['pid'] = os.getpid()
+    print("=" * 70)  # NOQA
+    for k, v in info.items():
+        print("%-14s %s" % (k + ':', v))  # NOQA
+    print("=" * 70)  # NOQA
+
+
+def _get_eligible_cpu():
+    p = psutil.Process()
+    if hasattr(p, "cpu_num"):
+        return p.cpu_num()
+    elif hasattr(p, "cpu_affinity"):
+        return p.cpu_affinity()[0]
+    return 0
+
+
+class process_namespace:
+    """A container that lists all Process class method names + some
+    reasonable parameters to be called with. Utility methods (parent(),
+    children(), ...) are excluded.
+
+    >>> ns = process_namespace(psutil.Process())
+    >>> for fun, name in ns.iter(ns.getters):
+    ...    fun()
+    """
+    utils = [
+        ('cpu_percent', (), {}),
+        ('memory_percent', (), {}),
+    ]
+
+    ignored = [
+        ('as_dict', (), {}),
+        ('children', (), {'recursive': True}),
+        ('is_running', (), {}),
+        ('memory_info_ex', (), {}),
+        ('oneshot', (), {}),
+        ('parent', (), {}),
+        ('parents', (), {}),
+        ('pid', (), {}),
+        ('wait', (0, ), {}),
+    ]
+
+    getters = [
+        ('cmdline', (), {}),
+        ('connections', (), {'kind': 'all'}),
+        ('cpu_times', (), {}),
+        ('create_time', (), {}),
+        ('cwd', (), {}),
+        ('exe', (), {}),
+        ('memory_full_info', (), {}),
+        ('memory_info', (), {}),
+        ('name', (), {}),
+        ('nice', (), {}),
+        ('num_ctx_switches', (), {}),
+        ('num_threads', (), {}),
+        ('open_files', (), {}),
+        ('ppid', (), {}),
+        ('status', (), {}),
+        ('threads', (), {}),
+        ('username', (), {}),
+    ]
+    if POSIX:
+        getters += [('uids', (), {})]
+        getters += [('gids', (), {})]
+        getters += [('terminal', (), {})]
+        getters += [('num_fds', (), {})]
+    if HAS_PROC_IO_COUNTERS:
+        getters += [('io_counters', (), {})]
+    if HAS_IONICE:
+        getters += [('ionice', (), {})]
+    if HAS_RLIMIT:
+        getters += [('rlimit', (psutil.RLIMIT_NOFILE, ), {})]
+    if HAS_CPU_AFFINITY:
+        getters += [('cpu_affinity', (), {})]
+    if HAS_PROC_CPU_NUM:
+        getters += [('cpu_num', (), {})]
+    if HAS_ENVIRON:
+        getters += [('environ', (), {})]
+    if WINDOWS:
+        getters += [('num_handles', (), {})]
+    if HAS_MEMORY_MAPS:
+        getters += [('memory_maps', (), {'grouped': False})]
+
+    setters = []
+    if POSIX:
+        setters += [('nice', (0, ), {})]
+    else:
+        setters += [('nice', (psutil.NORMAL_PRIORITY_CLASS, ), {})]
+    if HAS_RLIMIT:
+        setters += [('rlimit', (psutil.RLIMIT_NOFILE, (1024, 4096)), {})]
+    if HAS_IONICE:
+        if LINUX:
+            setters += [('ionice', (psutil.IOPRIO_CLASS_NONE, 0), {})]
+        else:
+            setters += [('ionice', (psutil.IOPRIO_NORMAL, ), {})]
+    if HAS_CPU_AFFINITY:
+        setters += [('cpu_affinity', ([_get_eligible_cpu()], ), {})]
+
+    killers = [
+        ('send_signal', (signal.SIGTERM, ), {}),
+        ('suspend', (), {}),
+        ('resume', (), {}),
+        ('terminate', (), {}),
+        ('kill', (), {}),
+    ]
+    if WINDOWS:
+        killers += [('send_signal', (signal.CTRL_C_EVENT, ), {})]
+        killers += [('send_signal', (signal.CTRL_BREAK_EVENT, ), {})]
+
+    all = utils + getters + setters + killers
+
+    def __init__(self, proc):
+        self._proc = proc
+
+    def iter(self, ls, clear_cache=True):
+        """Given a list of tuples yields a set of (fun, fun_name) tuples
+        in random order.
+        """
+        ls = list(ls)
+        random.shuffle(ls)
+        for fun_name, args, kwds in ls:
+            if clear_cache:
+                self.clear_cache()
+            fun = getattr(self._proc, fun_name)
+            fun = functools.partial(fun, *args, **kwds)
+            yield (fun, fun_name)
+
+    def clear_cache(self):
+        """Clear the cache of a Process instance."""
+        self._proc._init(self._proc.pid, _ignore_nsp=True)
+
+    @classmethod
+    def test_class_coverage(cls, test_class, ls):
+        """Given a TestCase instance and a list of tuples checks that
+        the class defines the required test method names.
+        """
+        for fun_name, _, _ in ls:
+            meth_name = 'test_' + fun_name
+            if not hasattr(test_class, meth_name):
+                msg = "%r class should define a '%s' method" % (
+                    test_class.__class__.__name__, meth_name)
+                raise AttributeError(msg)
+
+    @classmethod
+    def test(cls):
+        this = set([x[0] for x in cls.all])
+        ignored = set([x[0] for x in cls.ignored])
+        klass = set([x for x in dir(psutil.Process) if x[0] != '_'])
+        leftout = (this | ignored) ^ klass
+        if leftout:
+            raise ValueError("uncovered Process class names: %r" % leftout)
+
+
+class system_namespace:
+    """A container that lists all the module-level, system-related APIs.
+    Utilities such as cpu_percent() are excluded. Usage:
+
+    >>> ns = system_namespace
+    >>> for fun, name in ns.iter(ns.getters):
+    ...    fun()
+    """
+    getters = [
+        ('boot_time', (), {}),
+        ('cpu_count', (), {'logical': False}),
+        ('cpu_count', (), {'logical': True}),
+        ('cpu_stats', (), {}),
+        ('cpu_times', (), {'percpu': False}),
+        ('cpu_times', (), {'percpu': True}),
+        ('disk_io_counters', (), {'perdisk': True}),
+        ('disk_partitions', (), {'all': True}),
+        ('disk_usage', (os.getcwd(), ), {}),
+        ('net_connections', (), {'kind': 'all'}),
+        ('net_if_addrs', (), {}),
+        ('net_if_stats', (), {}),
+        ('net_io_counters', (), {'pernic': True}),
+        ('pid_exists', (os.getpid(), ), {}),
+        ('pids', (), {}),
+        ('swap_memory', (), {}),
+        ('users', (), {}),
+        ('virtual_memory', (), {}),
+    ]
+    if HAS_CPU_FREQ:
+        getters += [('cpu_freq', (), {'percpu': True})]
+    if HAS_GETLOADAVG:
+        getters += [('getloadavg', (), {})]
+    if HAS_SENSORS_TEMPERATURES:
+        getters += [('sensors_temperatures', (), {})]
+    if HAS_SENSORS_FANS:
+        getters += [('sensors_fans', (), {})]
+    if HAS_SENSORS_BATTERY:
+        getters += [('sensors_battery', (), {})]
+    if WINDOWS:
+        getters += [('win_service_iter', (), {})]
+        getters += [('win_service_get', ('alg', ), {})]
+
+    ignored = [
+        ('process_iter', (), {}),
+        ('wait_procs', ([psutil.Process()], ), {}),
+        ('cpu_percent', (), {}),
+        ('cpu_times_percent', (), {}),
+    ]
+
+    all = getters
+
+    @staticmethod
+    def iter(ls):
+        """Given a list of tuples yields a set of (fun, fun_name) tuples
+        in random order.
+        """
+        ls = list(ls)
+        random.shuffle(ls)
+        for fun_name, args, kwds in ls:
+            fun = getattr(psutil, fun_name)
+            fun = functools.partial(fun, *args, **kwds)
+            yield (fun, fun_name)
+
+    test_class_coverage = process_namespace.test_class_coverage
+
+
+def serialrun(klass):
+    """A decorator to mark a TestCase class. When running parallel tests,
+    class' unit tests will be run serially (1 process).
+    """
+    # assert issubclass(klass, unittest.TestCase), klass
+    assert inspect.isclass(klass), klass
+    klass._serialrun = True
+    return klass
+
+
+def retry_on_failure(retries=NO_RETRIES):
+    """Decorator which runs a test function and retries N times before
+    actually failing.
+    """
+    def logfun(exc):
+        print("%r, retrying" % exc, file=sys.stderr)  # NOQA
+
+    return retry(exception=AssertionError, timeout=None, retries=retries,
+                 logfun=logfun)
+
+
+def skip_on_access_denied(only_if=None):
+    """Decorator to Ignore AccessDenied exceptions."""
+    def decorator(fun):
+        @functools.wraps(fun)
+        def wrapper(*args, **kwargs):
+            try:
+                return fun(*args, **kwargs)
+            except psutil.AccessDenied:
+                if only_if is not None:
+                    if not only_if:
+                        raise
+                raise unittest.SkipTest("raises AccessDenied")
+        return wrapper
+    return decorator
+
+
+def skip_on_not_implemented(only_if=None):
+    """Decorator to Ignore NotImplementedError exceptions."""
+    def decorator(fun):
+        @functools.wraps(fun)
+        def wrapper(*args, **kwargs):
+            try:
+                return fun(*args, **kwargs)
+            except NotImplementedError:
+                if only_if is not None:
+                    if not only_if:
+                        raise
+                msg = "%r was skipped because it raised NotImplementedError" \
+                      % fun.__name__
+                raise unittest.SkipTest(msg)
+        return wrapper
+    return decorator
+
+
+# ===================================================================
+# --- network
+# ===================================================================
+
+
+def get_free_port(host='127.0.0.1'):
+    """Return an unused TCP port."""
+    with contextlib.closing(socket.socket()) as sock:
+        sock.bind((host, 0))
+        return sock.getsockname()[1]
+
+
+def bind_socket(family=AF_INET, type=SOCK_STREAM, addr=None):
+    """Binds a generic socket."""
+    if addr is None and family in (AF_INET, AF_INET6):
+        addr = ("", 0)
+    sock = socket.socket(family, type)
+    try:
+        if os.name not in ('nt', 'cygwin'):
+            sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
+        sock.bind(addr)
+        if type == socket.SOCK_STREAM:
+            sock.listen(5)
+        return sock
+    except Exception:
+        sock.close()
+        raise
+
+
+def bind_unix_socket(name, type=socket.SOCK_STREAM):
+    """Bind a UNIX socket."""
+    assert psutil.POSIX
+    assert not os.path.exists(name), name
+    sock = socket.socket(socket.AF_UNIX, type)
+    try:
+        sock.bind(name)
+        if type == socket.SOCK_STREAM:
+            sock.listen(5)
+    except Exception:
+        sock.close()
+        raise
+    return sock
+
+
+def tcp_socketpair(family, addr=("", 0)):
+    """Build a pair of TCP sockets connected to each other.
+    Return a (server, client) tuple.
+    """
+    with contextlib.closing(socket.socket(family, SOCK_STREAM)) as ll:
+        ll.bind(addr)
+        ll.listen(5)
+        addr = ll.getsockname()
+        c = socket.socket(family, SOCK_STREAM)
+        try:
+            c.connect(addr)
+            caddr = c.getsockname()
+            while True:
+                a, addr = ll.accept()
+                # check that we've got the correct client
+                if addr == caddr:
+                    return (a, c)
+                a.close()
+        except OSError:
+            c.close()
+            raise
+
+
+def unix_socketpair(name):
+    """Build a pair of UNIX sockets connected to each other through
+    the same UNIX file name.
+    Return a (server, client) tuple.
+    """
+    assert psutil.POSIX
+    server = client = None
+    try:
+        server = bind_unix_socket(name, type=socket.SOCK_STREAM)
+        server.setblocking(0)
+        client = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+        client.setblocking(0)
+        client.connect(name)
+        # new = server.accept()
+    except Exception:
+        if server is not None:
+            server.close()
+        if client is not None:
+            client.close()
+        raise
+    return (server, client)
+
+
+@contextlib.contextmanager
+def create_sockets():
+    """Open as many socket families / types as possible."""
+    socks = []
+    fname1 = fname2 = None
+    try:
+        socks.append(bind_socket(socket.AF_INET, socket.SOCK_STREAM))
+        socks.append(bind_socket(socket.AF_INET, socket.SOCK_DGRAM))
+        if supports_ipv6():
+            socks.append(bind_socket(socket.AF_INET6, socket.SOCK_STREAM))
+            socks.append(bind_socket(socket.AF_INET6, socket.SOCK_DGRAM))
+        if POSIX and HAS_CONNECTIONS_UNIX:
+            fname1 = get_testfn()
+            fname2 = get_testfn()
+            s1, s2 = unix_socketpair(fname1)
+            s3 = bind_unix_socket(fname2, type=socket.SOCK_DGRAM)
+            for s in (s1, s2, s3):
+                socks.append(s)
+        yield socks
+    finally:
+        for s in socks:
+            s.close()
+        for fname in (fname1, fname2):
+            if fname is not None:
+                safe_rmpath(fname)
+
+
+def check_net_address(addr, family):
+    """Check a net address validity. Supported families are IPv4,
+    IPv6 and MAC addresses.
+    """
+    import ipaddress  # python >= 3.3 / requires "pip install ipaddress"
+    if enum and PY3 and not PYPY:
+        assert isinstance(family, enum.IntEnum), family
+    if family == socket.AF_INET:
+        octs = [int(x) for x in addr.split('.')]
+        assert len(octs) == 4, addr
+        for num in octs:
+            assert 0 <= num <= 255, addr
+        if not PY3:
+            addr = unicode(addr)
+        ipaddress.IPv4Address(addr)
+    elif family == socket.AF_INET6:
+        assert isinstance(addr, str), addr
+        if not PY3:
+            addr = unicode(addr)
+        ipaddress.IPv6Address(addr)
+    elif family == psutil.AF_LINK:
+        assert re.match(r'([a-fA-F0-9]{2}[:|\-]?){6}', addr) is not None, addr
+    else:
+        raise ValueError("unknown family %r", family)
+
+
+# ===================================================================
+# --- compatibility
+# ===================================================================
+
+
+def reload_module(module):
+    """Backport of importlib.reload of Python 3.3+."""
+    try:
+        import importlib
+        if not hasattr(importlib, 'reload'):  # python <=3.3
+            raise ImportError
+    except ImportError:
+        import imp
+        return imp.reload(module)
+    else:
+        return importlib.reload(module)
+
+
+def import_module_by_path(path):
+    name = os.path.splitext(os.path.basename(path))[0]
+    if sys.version_info[0] == 2:
+        import imp
+        return imp.load_source(name, path)
+    elif sys.version_info[:2] <= (3, 4):
+        from importlib.machinery import SourceFileLoader
+        return SourceFileLoader(name, path).load_module()
+    else:
+        import importlib.util
+        spec = importlib.util.spec_from_file_location(name, path)
+        mod = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(mod)
+        return mod
+
+
+# ===================================================================
+# --- others
+# ===================================================================
+
+
+def warn(msg):
+    """Raise a warning msg."""
+    warnings.warn(msg, UserWarning)
+
+
+def is_namedtuple(x):
+    """Check if object is an instance of namedtuple."""
+    t = type(x)
+    b = t.__bases__
+    if len(b) != 1 or b[0] != tuple:
+        return False
+    f = getattr(t, '_fields', None)
+    if not isinstance(f, tuple):
+        return False
+    return all(type(n) == str for n in f)
+
+
+if POSIX:
+    @contextlib.contextmanager
+    def copyload_shared_lib(suffix=""):
+        """Ctx manager which picks up a random shared CO lib used
+        by this process, copies it in another location and loads it
+        in memory via ctypes. Return the new absolutized path.
+        """
+        exe = 'pypy' if PYPY else 'python'
+        ext = ".so"
+        dst = get_testfn(suffix=suffix + ext)
+        libs = [x.path for x in psutil.Process().memory_maps() if
+                os.path.splitext(x.path)[1] == ext and
+                exe in x.path.lower()]
+        src = random.choice(libs)
+        shutil.copyfile(src, dst)
+        try:
+            ctypes.CDLL(dst)
+            yield dst
+        finally:
+            safe_rmpath(dst)
+else:
+    @contextlib.contextmanager
+    def copyload_shared_lib(suffix=""):
+        """Ctx manager which picks up a random shared DLL lib used
+        by this process, copies it in another location and loads it
+        in memory via ctypes.
+        Return the new absolutized, normcased path.
+        """
+        from ctypes import wintypes
+        from ctypes import WinError
+        ext = ".dll"
+        dst = get_testfn(suffix=suffix + ext)
+        libs = [x.path for x in psutil.Process().memory_maps() if
+                x.path.lower().endswith(ext) and
+                'python' in os.path.basename(x.path).lower() and
+                'wow64' not in x.path.lower()]
+        if PYPY and not libs:
+            libs = [x.path for x in psutil.Process().memory_maps() if
+                    'pypy' in os.path.basename(x.path).lower()]
+        src = random.choice(libs)
+        shutil.copyfile(src, dst)
+        cfile = None
+        try:
+            cfile = ctypes.WinDLL(dst)
+            yield dst
+        finally:
+            # Work around OverflowError:
+            # - https://ci.appveyor.com/project/giampaolo/psutil/build/1207/
+            #       job/o53330pbnri9bcw7
+            # - http://bugs.python.org/issue30286
+            # - http://stackoverflow.com/questions/23522055
+            if cfile is not None:
+                FreeLibrary = ctypes.windll.kernel32.FreeLibrary
+                FreeLibrary.argtypes = [wintypes.HMODULE]
+                ret = FreeLibrary(cfile._handle)
+                if ret == 0:
+                    WinError()
+            safe_rmpath(dst)
+
+
+# ===================================================================
+# --- Exit funs (first is executed last)
+# ===================================================================
+
+
+# this is executed first
+@atexit.register
+def cleanup_test_procs():
+    reap_children(recursive=True)
+
+
+# atexit module does not execute exit functions in case of SIGTERM, which
+# gets sent to test subprocesses, which is a problem if they import this
+# module. With this it will. See:
+# https://gmpy.dev/blog/2016/how-to-always-execute-exit-functions-in-python
+if POSIX:
+    signal.signal(signal.SIGTERM, lambda sig, frame: sys.exit(sig))
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__main__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__main__.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5cd02eb1c28c5e00ea543968ac1043e21fdbd7a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/__main__.py
@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Run unit tests. This is invoked by:
+$ python -m psutil.tests
+"""
+
+from .runner import main
+main()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/runner.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/runner.py
new file mode 100644
index 0000000000000000000000000000000000000000..0777f5e74d2474bffac55300f935e79992110ea9
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/runner.py
@@ -0,0 +1,348 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Unit test runner, providing new features on top of unittest module:
+- colourized output
+- parallel run (UNIX only)
+- print failures/tracebacks on CTRL+C
+- re-run failed tests only (make test-failed)
+
+Invocation examples:
+- make test
+- make test-failed
+
+Parallel:
+- make test-parallel
+- make test-process ARGS=--parallel
+"""
+
+from __future__ import print_function
+import atexit
+import optparse
+import os
+import sys
+import textwrap
+import time
+import unittest
+try:
+    import ctypes
+except ImportError:
+    ctypes = None
+
+try:
+    import concurrencytest  # pip install concurrencytest
+except ImportError:
+    concurrencytest = None
+
+import psutil
+from psutil._common import hilite
+from psutil._common import print_color
+from psutil._common import term_supports_colors
+from psutil._compat import super
+from psutil.tests import CI_TESTING
+from psutil.tests import import_module_by_path
+from psutil.tests import print_sysinfo
+from psutil.tests import reap_children
+from psutil.tests import safe_rmpath
+
+
+VERBOSITY = 2
+FAILED_TESTS_FNAME = '.failed-tests.txt'
+NWORKERS = psutil.cpu_count() or 1
+USE_COLORS = not CI_TESTING and term_supports_colors()
+
+HERE = os.path.abspath(os.path.dirname(__file__))
+loadTestsFromTestCase = unittest.defaultTestLoader.loadTestsFromTestCase
+
+
+def cprint(msg, color, bold=False, file=None):
+    if file is None:
+        file = sys.stderr if color == 'red' else sys.stdout
+    if USE_COLORS:
+        print_color(msg, color, bold=bold, file=file)
+    else:
+        print(msg, file=file)
+
+
+class TestLoader:
+
+    testdir = HERE
+    skip_files = ['test_memleaks.py']
+    if "WHEELHOUSE_UPLOADER_USERNAME" in os.environ:
+        skip_files.extend(['test_osx.py', 'test_linux.py', 'test_posix.py'])
+
+    def _get_testmods(self):
+        return [os.path.join(self.testdir, x)
+                for x in os.listdir(self.testdir)
+                if x.startswith('test_') and x.endswith('.py') and
+                x not in self.skip_files]
+
+    def _iter_testmod_classes(self):
+        """Iterate over all test files in this directory and return
+        all TestCase classes in them.
+        """
+        for path in self._get_testmods():
+            mod = import_module_by_path(path)
+            for name in dir(mod):
+                obj = getattr(mod, name)
+                if isinstance(obj, type) and \
+                        issubclass(obj, unittest.TestCase):
+                    yield obj
+
+    def all(self):
+        suite = unittest.TestSuite()
+        for obj in self._iter_testmod_classes():
+            test = loadTestsFromTestCase(obj)
+            suite.addTest(test)
+        return suite
+
+    def last_failed(self):
+        # ...from previously failed test run
+        suite = unittest.TestSuite()
+        if not os.path.isfile(FAILED_TESTS_FNAME):
+            return suite
+        with open(FAILED_TESTS_FNAME, 'rt') as f:
+            names = f.read().split()
+        for n in names:
+            test = unittest.defaultTestLoader.loadTestsFromName(n)
+            suite.addTest(test)
+        return suite
+
+    def from_name(self, name):
+        if name.endswith('.py'):
+            name = os.path.splitext(os.path.basename(name))[0]
+        return unittest.defaultTestLoader.loadTestsFromName(name)
+
+
+class ColouredResult(unittest.TextTestResult):
+
+    def addSuccess(self, test):
+        unittest.TestResult.addSuccess(self, test)
+        cprint("OK", "green")
+
+    def addError(self, test, err):
+        unittest.TestResult.addError(self, test, err)
+        cprint("ERROR", "red", bold=True)
+
+    def addFailure(self, test, err):
+        unittest.TestResult.addFailure(self, test, err)
+        cprint("FAIL", "red")
+
+    def addSkip(self, test, reason):
+        unittest.TestResult.addSkip(self, test, reason)
+        cprint("skipped: %s" % reason.strip(), "brown")
+
+    def printErrorList(self, flavour, errors):
+        flavour = hilite(flavour, "red", bold=flavour == 'ERROR')
+        super().printErrorList(flavour, errors)
+
+
+class ColouredTextRunner(unittest.TextTestRunner):
+    """
+    A coloured text runner which also prints failed tests on KeyboardInterrupt
+    and save failed tests in a file so that they can be re-run.
+    """
+    resultclass = ColouredResult if USE_COLORS else unittest.TextTestResult
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.failed_tnames = set()
+
+    def _makeResult(self):
+        # Store result instance so that it can be accessed on
+        # KeyboardInterrupt.
+        self.result = super()._makeResult()
+        return self.result
+
+    def _write_last_failed(self):
+        if self.failed_tnames:
+            with open(FAILED_TESTS_FNAME, 'wt') as f:
+                for tname in self.failed_tnames:
+                    f.write(tname + '\n')
+
+    def _save_result(self, result):
+        if not result.wasSuccessful():
+            for t in result.errors + result.failures:
+                tname = t[0].id()
+                self.failed_tnames.add(tname)
+
+    def _run(self, suite):
+        try:
+            result = super().run(suite)
+        except (KeyboardInterrupt, SystemExit):
+            result = self.runner.result
+            result.printErrors()
+            raise sys.exit(1)
+        else:
+            self._save_result(result)
+            return result
+
+    def _exit(self, success):
+        if success:
+            cprint("SUCCESS", "green", bold=True)
+            safe_rmpath(FAILED_TESTS_FNAME)
+            sys.exit(0)
+        else:
+            cprint("FAILED", "red", bold=True)
+            self._write_last_failed()
+            sys.exit(1)
+
+    def run(self, suite):
+        result = self._run(suite)
+        self._exit(result.wasSuccessful())
+
+
+class ParallelRunner(ColouredTextRunner):
+
+    @staticmethod
+    def _parallelize(suite):
+        def fdopen(fd, mode, *kwds):
+            stream = orig_fdopen(fd, mode)
+            atexit.register(stream.close)
+            return stream
+
+        # Monkey patch concurrencytest lib bug (fdopen() stream not closed).
+        # https://github.com/cgoldberg/concurrencytest/issues/11
+        orig_fdopen = os.fdopen
+        concurrencytest.os.fdopen = fdopen
+        forker = concurrencytest.fork_for_tests(NWORKERS)
+        return concurrencytest.ConcurrentTestSuite(suite, forker)
+
+    @staticmethod
+    def _split_suite(suite):
+        serial = unittest.TestSuite()
+        parallel = unittest.TestSuite()
+        for test in suite:
+            if test.countTestCases() == 0:
+                continue
+            elif isinstance(test, unittest.TestSuite):
+                test_class = test._tests[0].__class__
+            elif isinstance(test, unittest.TestCase):
+                test_class = test
+            else:
+                raise TypeError("can't recognize type %r" % test)
+
+            if getattr(test_class, '_serialrun', False):
+                serial.addTest(test)
+            else:
+                parallel.addTest(test)
+        return (serial, parallel)
+
+    def run(self, suite):
+        ser_suite, par_suite = self._split_suite(suite)
+        par_suite = self._parallelize(par_suite)
+
+        # run parallel
+        cprint("starting parallel tests using %s workers" % NWORKERS,
+               "green", bold=True)
+        t = time.time()
+        par = self._run(par_suite)
+        par_elapsed = time.time() - t
+
+        # At this point we should have N zombies (the workers), which
+        # will disappear with wait().
+        orphans = psutil.Process().children()
+        gone, alive = psutil.wait_procs(orphans, timeout=1)
+        if alive:
+            cprint("alive processes %s" % alive, "red")
+            reap_children()
+
+        # run serial
+        t = time.time()
+        ser = self._run(ser_suite)
+        ser_elapsed = time.time() - t
+
+        # print
+        if not par.wasSuccessful() and ser_suite.countTestCases() > 0:
+            par.printErrors()  # print them again at the bottom
+        par_fails, par_errs, par_skips = map(len, (par.failures,
+                                                   par.errors,
+                                                   par.skipped))
+        ser_fails, ser_errs, ser_skips = map(len, (ser.failures,
+                                                   ser.errors,
+                                                   ser.skipped))
+        print(textwrap.dedent("""
+            +----------+----------+----------+----------+----------+----------+
+            |          |    total | failures |   errors |  skipped |     time |
+            +----------+----------+----------+----------+----------+----------+
+            | parallel |      %3s |      %3s |      %3s |      %3s |    %.2fs |
+            +----------+----------+----------+----------+----------+----------+
+            | serial   |      %3s |      %3s |      %3s |      %3s |    %.2fs |
+            +----------+----------+----------+----------+----------+----------+
+            """ % (par.testsRun, par_fails, par_errs, par_skips, par_elapsed,
+                   ser.testsRun, ser_fails, ser_errs, ser_skips, ser_elapsed)))
+        print("Ran %s tests in %.3fs using %s workers" % (
+            par.testsRun + ser.testsRun, par_elapsed + ser_elapsed, NWORKERS))
+        ok = par.wasSuccessful() and ser.wasSuccessful()
+        self._exit(ok)
+
+
+def get_runner(parallel=False):
+    def warn(msg):
+        cprint(msg + " Running serial tests instead.", "red")
+    if parallel:
+        if psutil.WINDOWS:
+            warn("Can't run parallel tests on Windows.")
+        elif concurrencytest is None:
+            warn("concurrencytest module is not installed.")
+        elif NWORKERS == 1:
+            warn("Only 1 CPU available.")
+        else:
+            return ParallelRunner(verbosity=VERBOSITY)
+    return ColouredTextRunner(verbosity=VERBOSITY)
+
+
+# Used by test_*,py modules.
+def run_from_name(name):
+    suite = TestLoader().from_name(name)
+    runner = get_runner()
+    runner.run(suite)
+
+
+def setup():
+    if 'PSUTIL_TESTING' not in os.environ:
+        # This won't work on Windows but set_testing() below will do it.
+        os.environ['PSUTIL_TESTING'] = '1'
+    psutil._psplatform.cext.set_testing()
+
+
+def main():
+    setup()
+    usage = "python3 -m psutil.tests [opts] [test-name]"
+    parser = optparse.OptionParser(usage=usage, description="run unit tests")
+    parser.add_option("--last-failed",
+                      action="store_true", default=False,
+                      help="only run last failed tests")
+    parser.add_option("--parallel",
+                      action="store_true", default=False,
+                      help="run tests in parallel")
+    opts, args = parser.parse_args()
+
+    if not opts.last_failed:
+        safe_rmpath(FAILED_TESTS_FNAME)
+
+    # loader
+    loader = TestLoader()
+    if args:
+        if len(args) > 1:
+            parser.print_usage()
+            return sys.exit(1)
+        else:
+            suite = loader.from_name(args[0])
+    elif opts.last_failed:
+        suite = loader.last_failed()
+    else:
+        suite = loader.all()
+
+    if CI_TESTING:
+        print_sysinfo()
+    runner = get_runner(opts.parallel)
+    runner.run(suite)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_aix.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_aix.py
new file mode 100644
index 0000000000000000000000000000000000000000..a32c3f6a17f21918c42c71f958edb4fc745157bc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_aix.py
@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'
+# Copyright (c) 2017, Arnon Yaari
+# All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""AIX specific tests."""
+
+import re
+
+from psutil import AIX
+from psutil.tests import PsutilTestCase
+from psutil.tests import sh
+from psutil.tests import unittest
+import psutil
+
+
+@unittest.skipIf(not AIX, "AIX only")
+class AIXSpecificTestCase(PsutilTestCase):
+
+    def test_virtual_memory(self):
+        out = sh('/usr/bin/svmon -O unit=KB')
+        re_pattern = r"memory\s*"
+        for field in ("size inuse free pin virtual available mmode").split():
+            re_pattern += r"(?P<%s>\S+)\s+" % (field,)
+        matchobj = re.search(re_pattern, out)
+
+        self.assertIsNotNone(
+            matchobj, "svmon command returned unexpected output")
+
+        KB = 1024
+        total = int(matchobj.group("size")) * KB
+        available = int(matchobj.group("available")) * KB
+        used = int(matchobj.group("inuse")) * KB
+        free = int(matchobj.group("free")) * KB
+
+        psutil_result = psutil.virtual_memory()
+
+        # TOLERANCE_SYS_MEM from psutil.tests is not enough. For some reason
+        # we're seeing differences of ~1.2 MB. 2 MB is still a good tolerance
+        # when compared to GBs.
+        TOLERANCE_SYS_MEM = 2 * KB * KB   # 2 MB
+        self.assertEqual(psutil_result.total, total)
+        self.assertAlmostEqual(
+            psutil_result.used, used, delta=TOLERANCE_SYS_MEM)
+        self.assertAlmostEqual(
+            psutil_result.available, available, delta=TOLERANCE_SYS_MEM)
+        self.assertAlmostEqual(
+            psutil_result.free, free, delta=TOLERANCE_SYS_MEM)
+
+    def test_swap_memory(self):
+        out = sh('/usr/sbin/lsps -a')
+        # From the man page, "The size is given in megabytes" so we assume
+        # we'll always have 'MB' in the result
+        # TODO maybe try to use "swap -l" to check "used" too, but its units
+        # are not guaranteed to be "MB" so parsing may not be consistent
+        matchobj = re.search(r"(?P<space>\S+)\s+"
+                             r"(?P<vol>\S+)\s+"
+                             r"(?P<vg>\S+)\s+"
+                             r"(?P<size>\d+)MB", out)
+
+        self.assertIsNotNone(
+            matchobj, "lsps command returned unexpected output")
+
+        total_mb = int(matchobj.group("size"))
+        MB = 1024 ** 2
+        psutil_result = psutil.swap_memory()
+        # we divide our result by MB instead of multiplying the lsps value by
+        # MB because lsps may round down, so we round down too
+        self.assertEqual(int(psutil_result.total / MB), total_mb)
+
+    def test_cpu_stats(self):
+        out = sh('/usr/bin/mpstat -a')
+
+        re_pattern = r"ALL\s*"
+        for field in ("min maj mpcs mpcr dev soft dec ph cs ics bound rq "
+                      "push S3pull S3grd S0rd S1rd S2rd S3rd S4rd S5rd "
+                      "sysc").split():
+            re_pattern += r"(?P<%s>\S+)\s+" % (field,)
+        matchobj = re.search(re_pattern, out)
+
+        self.assertIsNotNone(
+            matchobj, "mpstat command returned unexpected output")
+
+        # numbers are usually in the millions so 1000 is ok for tolerance
+        CPU_STATS_TOLERANCE = 1000
+        psutil_result = psutil.cpu_stats()
+        self.assertAlmostEqual(
+            psutil_result.ctx_switches,
+            int(matchobj.group("cs")),
+            delta=CPU_STATS_TOLERANCE)
+        self.assertAlmostEqual(
+            psutil_result.syscalls,
+            int(matchobj.group("sysc")),
+            delta=CPU_STATS_TOLERANCE)
+        self.assertAlmostEqual(
+            psutil_result.interrupts,
+            int(matchobj.group("dev")),
+            delta=CPU_STATS_TOLERANCE)
+        self.assertAlmostEqual(
+            psutil_result.soft_interrupts,
+            int(matchobj.group("soft")),
+            delta=CPU_STATS_TOLERANCE)
+
+    def test_cpu_count_logical(self):
+        out = sh('/usr/bin/mpstat -a')
+        mpstat_lcpu = int(re.search(r"lcpu=(\d+)", out).group(1))
+        psutil_lcpu = psutil.cpu_count(logical=True)
+        self.assertEqual(mpstat_lcpu, psutil_lcpu)
+
+    def test_net_if_addrs_names(self):
+        out = sh('/etc/ifconfig -l')
+        ifconfig_names = set(out.split())
+        psutil_names = set(psutil.net_if_addrs().keys())
+        self.assertSetEqual(ifconfig_names, psutil_names)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_bsd.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_bsd.py
new file mode 100644
index 0000000000000000000000000000000000000000..06a65087a43d3768a94cdb97acfa36145c024d35
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_bsd.py
@@ -0,0 +1,567 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+# TODO: (FreeBSD) add test for comparing connections with 'sockstat' cmd.
+
+
+"""Tests specific to all BSD platforms."""
+
+
+import datetime
+import os
+import re
+import time
+
+import psutil
+from psutil import BSD
+from psutil import FREEBSD
+from psutil import NETBSD
+from psutil import OPENBSD
+from psutil.tests import spawn_testproc
+from psutil.tests import HAS_BATTERY
+from psutil.tests import PsutilTestCase
+from psutil.tests import retry_on_failure
+from psutil.tests import sh
+from psutil.tests import TOLERANCE_SYS_MEM
+from psutil.tests import terminate
+from psutil.tests import unittest
+from psutil.tests import which
+
+
+if BSD:
+    PAGESIZE = os.sysconf("SC_PAGE_SIZE")
+    if os.getuid() == 0:  # muse requires root privileges
+        MUSE_AVAILABLE = which('muse')
+    else:
+        MUSE_AVAILABLE = False
+else:
+    MUSE_AVAILABLE = False
+
+
+def sysctl(cmdline):
+    """Expects a sysctl command with an argument and parse the result
+    returning only the value of interest.
+    """
+    result = sh("sysctl " + cmdline)
+    if FREEBSD:
+        result = result[result.find(": ") + 2:]
+    elif OPENBSD or NETBSD:
+        result = result[result.find("=") + 1:]
+    try:
+        return int(result)
+    except ValueError:
+        return result
+
+
+def muse(field):
+    """Thin wrapper around 'muse' cmdline utility."""
+    out = sh('muse')
+    for line in out.split('\n'):
+        if line.startswith(field):
+            break
+    else:
+        raise ValueError("line not found")
+    return int(line.split()[1])
+
+
+# =====================================================================
+# --- All BSD*
+# =====================================================================
+
+
+@unittest.skipIf(not BSD, "BSD only")
+class BSDTestCase(PsutilTestCase):
+    """Generic tests common to all BSD variants."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    @unittest.skipIf(NETBSD, "-o lstart doesn't work on NETBSD")
+    def test_process_create_time(self):
+        output = sh("ps -o lstart -p %s" % self.pid)
+        start_ps = output.replace('STARTED', '').strip()
+        start_psutil = psutil.Process(self.pid).create_time()
+        start_psutil = time.strftime("%a %b %e %H:%M:%S %Y",
+                                     time.localtime(start_psutil))
+        self.assertEqual(start_ps, start_psutil)
+
+    def test_disks(self):
+        # test psutil.disk_usage() and psutil.disk_partitions()
+        # against "df -a"
+        def df(path):
+            out = sh('df -k "%s"' % path).strip()
+            lines = out.split('\n')
+            lines.pop(0)
+            line = lines.pop(0)
+            dev, total, used, free = line.split()[:4]
+            if dev == 'none':
+                dev = ''
+            total = int(total) * 1024
+            used = int(used) * 1024
+            free = int(free) * 1024
+            return dev, total, used, free
+
+        for part in psutil.disk_partitions(all=False):
+            usage = psutil.disk_usage(part.mountpoint)
+            dev, total, used, free = df(part.mountpoint)
+            self.assertEqual(part.device, dev)
+            self.assertEqual(usage.total, total)
+            # 10 MB tollerance
+            if abs(usage.free - free) > 10 * 1024 * 1024:
+                self.fail("psutil=%s, df=%s" % (usage.free, free))
+            if abs(usage.used - used) > 10 * 1024 * 1024:
+                self.fail("psutil=%s, df=%s" % (usage.used, used))
+
+    @unittest.skipIf(not which('sysctl'), "sysctl cmd not available")
+    def test_cpu_count_logical(self):
+        syst = sysctl("hw.ncpu")
+        self.assertEqual(psutil.cpu_count(logical=True), syst)
+
+    @unittest.skipIf(not which('sysctl'), "sysctl cmd not available")
+    def test_virtual_memory_total(self):
+        num = sysctl('hw.physmem')
+        self.assertEqual(num, psutil.virtual_memory().total)
+
+    def test_net_if_stats(self):
+        for name, stats in psutil.net_if_stats().items():
+            try:
+                out = sh("ifconfig %s" % name)
+            except RuntimeError:
+                pass
+            else:
+                self.assertEqual(stats.isup, 'RUNNING' in out, msg=out)
+                if "mtu" in out:
+                    self.assertEqual(stats.mtu,
+                                     int(re.findall(r'mtu (\d+)', out)[0]))
+
+
+# =====================================================================
+# --- FreeBSD
+# =====================================================================
+
+
+@unittest.skipIf(not FREEBSD, "FREEBSD only")
+class FreeBSDPsutilTestCase(PsutilTestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    @retry_on_failure()
+    def test_memory_maps(self):
+        out = sh('procstat -v %s' % self.pid)
+        maps = psutil.Process(self.pid).memory_maps(grouped=False)
+        lines = out.split('\n')[1:]
+        while lines:
+            line = lines.pop()
+            fields = line.split()
+            _, start, stop, perms, res = fields[:5]
+            map = maps.pop()
+            self.assertEqual("%s-%s" % (start, stop), map.addr)
+            self.assertEqual(int(res), map.rss)
+            if not map.path.startswith('['):
+                self.assertEqual(fields[10], map.path)
+
+    def test_exe(self):
+        out = sh('procstat -b %s' % self.pid)
+        self.assertEqual(psutil.Process(self.pid).exe(),
+                         out.split('\n')[1].split()[-1])
+
+    def test_cmdline(self):
+        out = sh('procstat -c %s' % self.pid)
+        self.assertEqual(' '.join(psutil.Process(self.pid).cmdline()),
+                         ' '.join(out.split('\n')[1].split()[2:]))
+
+    def test_uids_gids(self):
+        out = sh('procstat -s %s' % self.pid)
+        euid, ruid, suid, egid, rgid, sgid = out.split('\n')[1].split()[2:8]
+        p = psutil.Process(self.pid)
+        uids = p.uids()
+        gids = p.gids()
+        self.assertEqual(uids.real, int(ruid))
+        self.assertEqual(uids.effective, int(euid))
+        self.assertEqual(uids.saved, int(suid))
+        self.assertEqual(gids.real, int(rgid))
+        self.assertEqual(gids.effective, int(egid))
+        self.assertEqual(gids.saved, int(sgid))
+
+    @retry_on_failure()
+    def test_ctx_switches(self):
+        tested = []
+        out = sh('procstat -r %s' % self.pid)
+        p = psutil.Process(self.pid)
+        for line in out.split('\n'):
+            line = line.lower().strip()
+            if ' voluntary context' in line:
+                pstat_value = int(line.split()[-1])
+                psutil_value = p.num_ctx_switches().voluntary
+                self.assertEqual(pstat_value, psutil_value)
+                tested.append(None)
+            elif ' involuntary context' in line:
+                pstat_value = int(line.split()[-1])
+                psutil_value = p.num_ctx_switches().involuntary
+                self.assertEqual(pstat_value, psutil_value)
+                tested.append(None)
+        if len(tested) != 2:
+            raise RuntimeError("couldn't find lines match in procstat out")
+
+    @retry_on_failure()
+    def test_cpu_times(self):
+        tested = []
+        out = sh('procstat -r %s' % self.pid)
+        p = psutil.Process(self.pid)
+        for line in out.split('\n'):
+            line = line.lower().strip()
+            if 'user time' in line:
+                pstat_value = float('0.' + line.split()[-1].split('.')[-1])
+                psutil_value = p.cpu_times().user
+                self.assertEqual(pstat_value, psutil_value)
+                tested.append(None)
+            elif 'system time' in line:
+                pstat_value = float('0.' + line.split()[-1].split('.')[-1])
+                psutil_value = p.cpu_times().system
+                self.assertEqual(pstat_value, psutil_value)
+                tested.append(None)
+        if len(tested) != 2:
+            raise RuntimeError("couldn't find lines match in procstat out")
+
+
+@unittest.skipIf(not FREEBSD, "FREEBSD only")
+class FreeBSDSystemTestCase(PsutilTestCase):
+
+    @staticmethod
+    def parse_swapinfo():
+        # the last line is always the total
+        output = sh("swapinfo -k").splitlines()[-1]
+        parts = re.split(r'\s+', output)
+
+        if not parts:
+            raise ValueError("Can't parse swapinfo: %s" % output)
+
+        # the size is in 1k units, so multiply by 1024
+        total, used, free = (int(p) * 1024 for p in parts[1:4])
+        return total, used, free
+
+    def test_cpu_frequency_against_sysctl(self):
+        # Currently only cpu 0 is frequency is supported in FreeBSD
+        # All other cores use the same frequency.
+        sensor = "dev.cpu.0.freq"
+        try:
+            sysctl_result = int(sysctl(sensor))
+        except RuntimeError:
+            self.skipTest("frequencies not supported by kernel")
+        self.assertEqual(psutil.cpu_freq().current, sysctl_result)
+
+        sensor = "dev.cpu.0.freq_levels"
+        sysctl_result = sysctl(sensor)
+        # sysctl returns a string of the format:
+        # <freq_level_1>/<voltage_level_1> <freq_level_2>/<voltage_level_2>...
+        # Ordered highest available to lowest available.
+        max_freq = int(sysctl_result.split()[0].split("/")[0])
+        min_freq = int(sysctl_result.split()[-1].split("/")[0])
+        self.assertEqual(psutil.cpu_freq().max, max_freq)
+        self.assertEqual(psutil.cpu_freq().min, min_freq)
+
+    # --- virtual_memory(); tests against sysctl
+
+    @retry_on_failure()
+    def test_vmem_active(self):
+        syst = sysctl("vm.stats.vm.v_active_count") * PAGESIZE
+        self.assertAlmostEqual(psutil.virtual_memory().active, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_inactive(self):
+        syst = sysctl("vm.stats.vm.v_inactive_count") * PAGESIZE
+        self.assertAlmostEqual(psutil.virtual_memory().inactive, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_wired(self):
+        syst = sysctl("vm.stats.vm.v_wire_count") * PAGESIZE
+        self.assertAlmostEqual(psutil.virtual_memory().wired, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_cached(self):
+        syst = sysctl("vm.stats.vm.v_cache_count") * PAGESIZE
+        self.assertAlmostEqual(psutil.virtual_memory().cached, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_free(self):
+        syst = sysctl("vm.stats.vm.v_free_count") * PAGESIZE
+        self.assertAlmostEqual(psutil.virtual_memory().free, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_buffers(self):
+        syst = sysctl("vfs.bufspace")
+        self.assertAlmostEqual(psutil.virtual_memory().buffers, syst,
+                               delta=TOLERANCE_SYS_MEM)
+
+    # --- virtual_memory(); tests against muse
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    def test_muse_vmem_total(self):
+        num = muse('Total')
+        self.assertEqual(psutil.virtual_memory().total, num)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_active(self):
+        num = muse('Active')
+        self.assertAlmostEqual(psutil.virtual_memory().active, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_inactive(self):
+        num = muse('Inactive')
+        self.assertAlmostEqual(psutil.virtual_memory().inactive, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_wired(self):
+        num = muse('Wired')
+        self.assertAlmostEqual(psutil.virtual_memory().wired, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_cached(self):
+        num = muse('Cache')
+        self.assertAlmostEqual(psutil.virtual_memory().cached, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_free(self):
+        num = muse('Free')
+        self.assertAlmostEqual(psutil.virtual_memory().free, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    @unittest.skipIf(not MUSE_AVAILABLE, "muse not installed")
+    @retry_on_failure()
+    def test_muse_vmem_buffers(self):
+        num = muse('Buffer')
+        self.assertAlmostEqual(psutil.virtual_memory().buffers, num,
+                               delta=TOLERANCE_SYS_MEM)
+
+    def test_cpu_stats_ctx_switches(self):
+        self.assertAlmostEqual(psutil.cpu_stats().ctx_switches,
+                               sysctl('vm.stats.sys.v_swtch'), delta=1000)
+
+    def test_cpu_stats_interrupts(self):
+        self.assertAlmostEqual(psutil.cpu_stats().interrupts,
+                               sysctl('vm.stats.sys.v_intr'), delta=1000)
+
+    def test_cpu_stats_soft_interrupts(self):
+        self.assertAlmostEqual(psutil.cpu_stats().soft_interrupts,
+                               sysctl('vm.stats.sys.v_soft'), delta=1000)
+
+    @retry_on_failure()
+    def test_cpu_stats_syscalls(self):
+        # pretty high tolerance but it looks like it's OK.
+        self.assertAlmostEqual(psutil.cpu_stats().syscalls,
+                               sysctl('vm.stats.sys.v_syscall'), delta=200000)
+
+    # def test_cpu_stats_traps(self):
+    #    self.assertAlmostEqual(psutil.cpu_stats().traps,
+    #                           sysctl('vm.stats.sys.v_trap'), delta=1000)
+
+    # --- swap memory
+
+    def test_swapmem_free(self):
+        total, used, free = self.parse_swapinfo()
+        self.assertAlmostEqual(
+            psutil.swap_memory().free, free, delta=TOLERANCE_SYS_MEM)
+
+    def test_swapmem_used(self):
+        total, used, free = self.parse_swapinfo()
+        self.assertAlmostEqual(
+            psutil.swap_memory().used, used, delta=TOLERANCE_SYS_MEM)
+
+    def test_swapmem_total(self):
+        total, used, free = self.parse_swapinfo()
+        self.assertAlmostEqual(
+            psutil.swap_memory().total, total, delta=TOLERANCE_SYS_MEM)
+
+    # --- others
+
+    def test_boot_time(self):
+        s = sysctl('sysctl kern.boottime')
+        s = s[s.find(" sec = ") + 7:]
+        s = s[:s.find(',')]
+        btime = int(s)
+        self.assertEqual(btime, psutil.boot_time())
+
+    # --- sensors_battery
+
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_sensors_battery(self):
+        def secs2hours(secs):
+            m, s = divmod(secs, 60)
+            h, m = divmod(m, 60)
+            return "%d:%02d" % (h, m)
+
+        out = sh("acpiconf -i 0")
+        fields = dict([(x.split('\t')[0], x.split('\t')[-1])
+                       for x in out.split("\n")])
+        metrics = psutil.sensors_battery()
+        percent = int(fields['Remaining capacity:'].replace('%', ''))
+        remaining_time = fields['Remaining time:']
+        self.assertEqual(metrics.percent, percent)
+        if remaining_time == 'unknown':
+            self.assertEqual(metrics.secsleft, psutil.POWER_TIME_UNLIMITED)
+        else:
+            self.assertEqual(secs2hours(metrics.secsleft), remaining_time)
+
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_sensors_battery_against_sysctl(self):
+        self.assertEqual(psutil.sensors_battery().percent,
+                         sysctl("hw.acpi.battery.life"))
+        self.assertEqual(psutil.sensors_battery().power_plugged,
+                         sysctl("hw.acpi.acline") == 1)
+        secsleft = psutil.sensors_battery().secsleft
+        if secsleft < 0:
+            self.assertEqual(sysctl("hw.acpi.battery.time"), -1)
+        else:
+            self.assertEqual(secsleft, sysctl("hw.acpi.battery.time") * 60)
+
+    @unittest.skipIf(HAS_BATTERY, "has battery")
+    def test_sensors_battery_no_battery(self):
+        # If no battery is present one of these calls is supposed
+        # to fail, see:
+        # https://github.com/giampaolo/psutil/issues/1074
+        with self.assertRaises(RuntimeError):
+            sysctl("hw.acpi.battery.life")
+            sysctl("hw.acpi.battery.time")
+            sysctl("hw.acpi.acline")
+        self.assertIsNone(psutil.sensors_battery())
+
+    # --- sensors_temperatures
+
+    def test_sensors_temperatures_against_sysctl(self):
+        num_cpus = psutil.cpu_count(True)
+        for cpu in range(num_cpus):
+            sensor = "dev.cpu.%s.temperature" % cpu
+            # sysctl returns a string in the format 46.0C
+            try:
+                sysctl_result = int(float(sysctl(sensor)[:-1]))
+            except RuntimeError:
+                self.skipTest("temperatures not supported by kernel")
+            self.assertAlmostEqual(
+                psutil.sensors_temperatures()["coretemp"][cpu].current,
+                sysctl_result, delta=10)
+
+            sensor = "dev.cpu.%s.coretemp.tjmax" % cpu
+            sysctl_result = int(float(sysctl(sensor)[:-1]))
+            self.assertEqual(
+                psutil.sensors_temperatures()["coretemp"][cpu].high,
+                sysctl_result)
+
+
+# =====================================================================
+# --- OpenBSD
+# =====================================================================
+
+
+@unittest.skipIf(not OPENBSD, "OPENBSD only")
+class OpenBSDTestCase(PsutilTestCase):
+
+    def test_boot_time(self):
+        s = sysctl('kern.boottime')
+        sys_bt = datetime.datetime.strptime(s, "%a %b %d %H:%M:%S %Y")
+        psutil_bt = datetime.datetime.fromtimestamp(psutil.boot_time())
+        self.assertEqual(sys_bt, psutil_bt)
+
+
+# =====================================================================
+# --- NetBSD
+# =====================================================================
+
+
+@unittest.skipIf(not NETBSD, "NETBSD only")
+class NetBSDTestCase(PsutilTestCase):
+
+    @staticmethod
+    def parse_meminfo(look_for):
+        with open('/proc/meminfo', 'rt') as f:
+            for line in f:
+                if line.startswith(look_for):
+                    return int(line.split()[1]) * 1024
+        raise ValueError("can't find %s" % look_for)
+
+    def test_vmem_total(self):
+        self.assertEqual(
+            psutil.virtual_memory().total, self.parse_meminfo("MemTotal:"))
+
+    def test_vmem_free(self):
+        self.assertAlmostEqual(
+            psutil.virtual_memory().free, self.parse_meminfo("MemFree:"),
+            delta=TOLERANCE_SYS_MEM)
+
+    def test_vmem_buffers(self):
+        self.assertAlmostEqual(
+            psutil.virtual_memory().buffers, self.parse_meminfo("Buffers:"),
+            delta=TOLERANCE_SYS_MEM)
+
+    def test_vmem_shared(self):
+        self.assertAlmostEqual(
+            psutil.virtual_memory().shared, self.parse_meminfo("MemShared:"),
+            delta=TOLERANCE_SYS_MEM)
+
+    def test_swapmem_total(self):
+        self.assertAlmostEqual(
+            psutil.swap_memory().total, self.parse_meminfo("SwapTotal:"),
+            delta=TOLERANCE_SYS_MEM)
+
+    def test_swapmem_free(self):
+        self.assertAlmostEqual(
+            psutil.swap_memory().free, self.parse_meminfo("SwapFree:"),
+            delta=TOLERANCE_SYS_MEM)
+
+    def test_swapmem_used(self):
+        smem = psutil.swap_memory()
+        self.assertEqual(smem.used, smem.total - smem.free)
+
+    def test_cpu_stats_interrupts(self):
+        with open('/proc/stat', 'rb') as f:
+            for line in f:
+                if line.startswith(b'intr'):
+                    interrupts = int(line.split()[1])
+                    break
+            else:
+                raise ValueError("couldn't find line")
+        self.assertAlmostEqual(
+            psutil.cpu_stats().interrupts, interrupts, delta=1000)
+
+    def test_cpu_stats_ctx_switches(self):
+        with open('/proc/stat', 'rb') as f:
+            for line in f:
+                if line.startswith(b'ctxt'):
+                    ctx_switches = int(line.split()[1])
+                    break
+            else:
+                raise ValueError("couldn't find line")
+        self.assertAlmostEqual(
+            psutil.cpu_stats().ctx_switches, ctx_switches, delta=1000)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_connections.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_connections.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1425bcb1faca906b285e8e06dc712cb604c786e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_connections.py
@@ -0,0 +1,639 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Tests for net_connections() and Process.connections() APIs."""
+
+import contextlib
+import errno
+import os
+import socket
+import textwrap
+from contextlib import closing
+from socket import AF_INET
+from socket import AF_INET6
+from socket import SOCK_DGRAM
+from socket import SOCK_STREAM
+
+import psutil
+from psutil import FREEBSD
+from psutil import LINUX
+from psutil import MACOS
+from psutil import NETBSD
+from psutil import OPENBSD
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._common import supports_ipv6
+from psutil._compat import PY3
+from psutil.tests import AF_UNIX
+from psutil.tests import bind_socket
+from psutil.tests import bind_unix_socket
+from psutil.tests import check_net_address
+from psutil.tests import CIRRUS
+from psutil.tests import create_sockets
+from psutil.tests import enum
+from psutil.tests import get_free_port
+from psutil.tests import HAS_CONNECTIONS_UNIX
+from psutil.tests import PsutilTestCase
+from psutil.tests import reap_children
+from psutil.tests import retry_on_failure
+from psutil.tests import serialrun
+from psutil.tests import skip_on_access_denied
+from psutil.tests import SKIP_SYSCONS
+from psutil.tests import tcp_socketpair
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+from psutil.tests import unix_socketpair
+from psutil.tests import wait_for_file
+
+
+thisproc = psutil.Process()
+SOCK_SEQPACKET = getattr(socket, "SOCK_SEQPACKET", object())
+
+
+@serialrun
+class _ConnTestCase(PsutilTestCase):
+
+    def setUp(self):
+        if not (NETBSD or FREEBSD):
+            # process opens a UNIX socket to /var/log/run.
+            cons = thisproc.connections(kind='all')
+            assert not cons, cons
+
+    def tearDown(self):
+        if not (FREEBSD or NETBSD):
+            # Make sure we closed all resources.
+            # NetBSD opens a UNIX socket to /var/log/run.
+            cons = thisproc.connections(kind='all')
+            assert not cons, cons
+
+    def compare_procsys_connections(self, pid, proc_cons, kind='all'):
+        """Given a process PID and its list of connections compare
+        those against system-wide connections retrieved via
+        psutil.net_connections.
+        """
+        try:
+            sys_cons = psutil.net_connections(kind=kind)
+        except psutil.AccessDenied:
+            # On MACOS, system-wide connections are retrieved by iterating
+            # over all processes
+            if MACOS:
+                return
+            else:
+                raise
+        # Filter for this proc PID and exlucde PIDs from the tuple.
+        sys_cons = [c[:-1] for c in sys_cons if c.pid == pid]
+        sys_cons.sort()
+        proc_cons.sort()
+        self.assertEqual(proc_cons, sys_cons)
+
+    def check_connection_ntuple(self, conn):
+        """Check validity of a connection namedtuple."""
+        def check_ntuple(conn):
+            has_pid = len(conn) == 7
+            self.assertIn(len(conn), (6, 7))
+            self.assertEqual(conn[0], conn.fd)
+            self.assertEqual(conn[1], conn.family)
+            self.assertEqual(conn[2], conn.type)
+            self.assertEqual(conn[3], conn.laddr)
+            self.assertEqual(conn[4], conn.raddr)
+            self.assertEqual(conn[5], conn.status)
+            if has_pid:
+                self.assertEqual(conn[6], conn.pid)
+
+        def check_family(conn):
+            self.assertIn(conn.family, (AF_INET, AF_INET6, AF_UNIX))
+            if enum is not None:
+                assert isinstance(conn.family, enum.IntEnum), conn
+            else:
+                assert isinstance(conn.family, int), conn
+            if conn.family == AF_INET:
+                # actually try to bind the local socket; ignore IPv6
+                # sockets as their address might be represented as
+                # an IPv4-mapped-address (e.g. "::127.0.0.1")
+                # and that's rejected by bind()
+                s = socket.socket(conn.family, conn.type)
+                with contextlib.closing(s):
+                    try:
+                        s.bind((conn.laddr[0], 0))
+                    except socket.error as err:
+                        if err.errno != errno.EADDRNOTAVAIL:
+                            raise
+            elif conn.family == AF_UNIX:
+                self.assertEqual(conn.status, psutil.CONN_NONE)
+
+        def check_type(conn):
+            # SOCK_SEQPACKET may happen in case of AF_UNIX socks
+            self.assertIn(conn.type, (SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET))
+            if enum is not None:
+                assert isinstance(conn.type, enum.IntEnum), conn
+            else:
+                assert isinstance(conn.type, int), conn
+            if conn.type == SOCK_DGRAM:
+                self.assertEqual(conn.status, psutil.CONN_NONE)
+
+        def check_addrs(conn):
+            # check IP address and port sanity
+            for addr in (conn.laddr, conn.raddr):
+                if conn.family in (AF_INET, AF_INET6):
+                    self.assertIsInstance(addr, tuple)
+                    if not addr:
+                        continue
+                    self.assertIsInstance(addr.port, int)
+                    assert 0 <= addr.port <= 65535, addr.port
+                    check_net_address(addr.ip, conn.family)
+                elif conn.family == AF_UNIX:
+                    self.assertIsInstance(addr, str)
+
+        def check_status(conn):
+            self.assertIsInstance(conn.status, str)
+            valids = [getattr(psutil, x) for x in dir(psutil)
+                      if x.startswith('CONN_')]
+            self.assertIn(conn.status, valids)
+            if conn.family in (AF_INET, AF_INET6) and conn.type == SOCK_STREAM:
+                self.assertNotEqual(conn.status, psutil.CONN_NONE)
+            else:
+                self.assertEqual(conn.status, psutil.CONN_NONE)
+
+        check_ntuple(conn)
+        check_family(conn)
+        check_type(conn)
+        check_addrs(conn)
+        check_status(conn)
+
+
+class TestBasicOperations(_ConnTestCase):
+
+    @unittest.skipIf(SKIP_SYSCONS, "requires root")
+    def test_system(self):
+        with create_sockets():
+            for conn in psutil.net_connections(kind='all'):
+                self.check_connection_ntuple(conn)
+
+    def test_process(self):
+        with create_sockets():
+            for conn in psutil.Process().connections(kind='all'):
+                self.check_connection_ntuple(conn)
+
+    def test_invalid_kind(self):
+        self.assertRaises(ValueError, thisproc.connections, kind='???')
+        self.assertRaises(ValueError, psutil.net_connections, kind='???')
+
+
+@serialrun
+class TestUnconnectedSockets(_ConnTestCase):
+    """Tests sockets which are open but not connected to anything."""
+
+    def get_conn_from_sock(self, sock):
+        cons = thisproc.connections(kind='all')
+        smap = dict([(c.fd, c) for c in cons])
+        if NETBSD or FREEBSD:
+            # NetBSD opens a UNIX socket to /var/log/run
+            # so there may be more connections.
+            return smap[sock.fileno()]
+        else:
+            self.assertEqual(len(cons), 1)
+            if cons[0].fd != -1:
+                self.assertEqual(smap[sock.fileno()].fd, sock.fileno())
+            return cons[0]
+
+    def check_socket(self, sock):
+        """Given a socket, makes sure it matches the one obtained
+        via psutil. It assumes this process created one connection
+        only (the one supposed to be checked).
+        """
+        conn = self.get_conn_from_sock(sock)
+        self.check_connection_ntuple(conn)
+
+        # fd, family, type
+        if conn.fd != -1:
+            self.assertEqual(conn.fd, sock.fileno())
+        self.assertEqual(conn.family, sock.family)
+        # see: http://bugs.python.org/issue30204
+        self.assertEqual(
+            conn.type, sock.getsockopt(socket.SOL_SOCKET, socket.SO_TYPE))
+
+        # local address
+        laddr = sock.getsockname()
+        if not laddr and PY3 and isinstance(laddr, bytes):
+            # See: http://bugs.python.org/issue30205
+            laddr = laddr.decode()
+        if sock.family == AF_INET6:
+            laddr = laddr[:2]
+        if sock.family == AF_UNIX and OPENBSD:
+            # No addresses are set for UNIX sockets on OpenBSD.
+            pass
+        else:
+            self.assertEqual(conn.laddr, laddr)
+
+        # XXX Solaris can't retrieve system-wide UNIX sockets
+        if sock.family == AF_UNIX and HAS_CONNECTIONS_UNIX:
+            cons = thisproc.connections(kind='all')
+            self.compare_procsys_connections(os.getpid(), cons, kind='all')
+        return conn
+
+    def test_tcp_v4(self):
+        addr = ("127.0.0.1", get_free_port())
+        with closing(bind_socket(AF_INET, SOCK_STREAM, addr=addr)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_LISTEN)
+
+    @unittest.skipIf(not supports_ipv6(), "IPv6 not supported")
+    def test_tcp_v6(self):
+        addr = ("::1", get_free_port())
+        with closing(bind_socket(AF_INET6, SOCK_STREAM, addr=addr)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_LISTEN)
+
+    def test_udp_v4(self):
+        addr = ("127.0.0.1", get_free_port())
+        with closing(bind_socket(AF_INET, SOCK_DGRAM, addr=addr)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_NONE)
+
+    @unittest.skipIf(not supports_ipv6(), "IPv6 not supported")
+    def test_udp_v6(self):
+        addr = ("::1", get_free_port())
+        with closing(bind_socket(AF_INET6, SOCK_DGRAM, addr=addr)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_NONE)
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_unix_tcp(self):
+        testfn = self.get_testfn()
+        with closing(bind_unix_socket(testfn, type=SOCK_STREAM)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_NONE)
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_unix_udp(self):
+        testfn = self.get_testfn()
+        with closing(bind_unix_socket(testfn, type=SOCK_STREAM)) as sock:
+            conn = self.check_socket(sock)
+            assert not conn.raddr
+            self.assertEqual(conn.status, psutil.CONN_NONE)
+
+
+@serialrun
+class TestConnectedSocket(_ConnTestCase):
+    """Test socket pairs which are are actually connected to
+    each other.
+    """
+
+    # On SunOS, even after we close() it, the server socket stays around
+    # in TIME_WAIT state.
+    @unittest.skipIf(SUNOS, "unreliable on SUONS")
+    def test_tcp(self):
+        addr = ("127.0.0.1", get_free_port())
+        assert not thisproc.connections(kind='tcp4')
+        server, client = tcp_socketpair(AF_INET, addr=addr)
+        try:
+            cons = thisproc.connections(kind='tcp4')
+            self.assertEqual(len(cons), 2)
+            self.assertEqual(cons[0].status, psutil.CONN_ESTABLISHED)
+            self.assertEqual(cons[1].status, psutil.CONN_ESTABLISHED)
+            # May not be fast enough to change state so it stays
+            # commenteed.
+            # client.close()
+            # cons = thisproc.connections(kind='all')
+            # self.assertEqual(len(cons), 1)
+            # self.assertEqual(cons[0].status, psutil.CONN_CLOSE_WAIT)
+        finally:
+            server.close()
+            client.close()
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_unix(self):
+        testfn = self.get_testfn()
+        server, client = unix_socketpair(testfn)
+        try:
+            cons = thisproc.connections(kind='unix')
+            assert not (cons[0].laddr and cons[0].raddr)
+            assert not (cons[1].laddr and cons[1].raddr)
+            if NETBSD or FREEBSD:
+                # On NetBSD creating a UNIX socket will cause
+                # a UNIX connection to  /var/run/log.
+                cons = [c for c in cons if c.raddr != '/var/run/log']
+                if CIRRUS:
+                    cons = [c for c in cons if c.fd in
+                            (server.fileno(), client.fileno())]
+            self.assertEqual(len(cons), 2, msg=cons)
+            if LINUX or FREEBSD or SUNOS:
+                # remote path is never set
+                self.assertEqual(cons[0].raddr, "")
+                self.assertEqual(cons[1].raddr, "")
+                # one local address should though
+                self.assertEqual(testfn, cons[0].laddr or cons[1].laddr)
+            elif OPENBSD:
+                # No addresses whatsoever here.
+                for addr in (cons[0].laddr, cons[0].raddr,
+                             cons[1].laddr, cons[1].raddr):
+                    self.assertEqual(addr, "")
+            else:
+                # On other systems either the laddr or raddr
+                # of both peers are set.
+                self.assertEqual(cons[0].laddr or cons[1].laddr, testfn)
+                self.assertEqual(cons[0].raddr or cons[1].raddr, testfn)
+        finally:
+            server.close()
+            client.close()
+
+
+class TestFilters(_ConnTestCase):
+
+    def test_filters(self):
+        def check(kind, families, types):
+            for conn in thisproc.connections(kind=kind):
+                self.assertIn(conn.family, families)
+                self.assertIn(conn.type, types)
+            if not SKIP_SYSCONS:
+                for conn in psutil.net_connections(kind=kind):
+                    self.assertIn(conn.family, families)
+                    self.assertIn(conn.type, types)
+
+        with create_sockets():
+            check('all',
+                  [AF_INET, AF_INET6, AF_UNIX],
+                  [SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET])
+            check('inet',
+                  [AF_INET, AF_INET6],
+                  [SOCK_STREAM, SOCK_DGRAM])
+            check('inet4',
+                  [AF_INET],
+                  [SOCK_STREAM, SOCK_DGRAM])
+            check('tcp',
+                  [AF_INET, AF_INET6],
+                  [SOCK_STREAM])
+            check('tcp4',
+                  [AF_INET],
+                  [SOCK_STREAM])
+            check('tcp6',
+                  [AF_INET6],
+                  [SOCK_STREAM])
+            check('udp',
+                  [AF_INET, AF_INET6],
+                  [SOCK_DGRAM])
+            check('udp4',
+                  [AF_INET],
+                  [SOCK_DGRAM])
+            check('udp6',
+                  [AF_INET6],
+                  [SOCK_DGRAM])
+            if HAS_CONNECTIONS_UNIX:
+                check('unix',
+                      [AF_UNIX],
+                      [SOCK_STREAM, SOCK_DGRAM, SOCK_SEQPACKET])
+
+    @skip_on_access_denied(only_if=MACOS)
+    def test_combos(self):
+        reap_children()
+
+        def check_conn(proc, conn, family, type, laddr, raddr, status, kinds):
+            all_kinds = ("all", "inet", "inet4", "inet6", "tcp", "tcp4",
+                         "tcp6", "udp", "udp4", "udp6")
+            self.check_connection_ntuple(conn)
+            self.assertEqual(conn.family, family)
+            self.assertEqual(conn.type, type)
+            self.assertEqual(conn.laddr, laddr)
+            self.assertEqual(conn.raddr, raddr)
+            self.assertEqual(conn.status, status)
+            for kind in all_kinds:
+                cons = proc.connections(kind=kind)
+                if kind in kinds:
+                    assert cons
+                else:
+                    assert not cons, cons
+            # compare against system-wide connections
+            # XXX Solaris can't retrieve system-wide UNIX
+            # sockets.
+            if HAS_CONNECTIONS_UNIX:
+                self.compare_procsys_connections(proc.pid, [conn])
+
+        tcp_template = textwrap.dedent("""
+            import socket, time
+            s = socket.socket({family}, socket.SOCK_STREAM)
+            s.bind(('{addr}', 0))
+            s.listen(5)
+            with open('{testfn}', 'w') as f:
+                f.write(str(s.getsockname()[:2]))
+            time.sleep(60)
+            """)
+
+        udp_template = textwrap.dedent("""
+            import socket, time
+            s = socket.socket({family}, socket.SOCK_DGRAM)
+            s.bind(('{addr}', 0))
+            with open('{testfn}', 'w') as f:
+                f.write(str(s.getsockname()[:2]))
+            time.sleep(60)
+            """)
+
+        # must be relative on Windows
+        testfile = os.path.basename(self.get_testfn(dir=os.getcwd()))
+        tcp4_template = tcp_template.format(
+            family=int(AF_INET), addr="127.0.0.1", testfn=testfile)
+        udp4_template = udp_template.format(
+            family=int(AF_INET), addr="127.0.0.1", testfn=testfile)
+        tcp6_template = tcp_template.format(
+            family=int(AF_INET6), addr="::1", testfn=testfile)
+        udp6_template = udp_template.format(
+            family=int(AF_INET6), addr="::1", testfn=testfile)
+
+        # launch various subprocess instantiating a socket of various
+        # families and types to enrich psutil results
+        tcp4_proc = self.pyrun(tcp4_template)
+        tcp4_addr = eval(wait_for_file(testfile, delete=True))
+        udp4_proc = self.pyrun(udp4_template)
+        udp4_addr = eval(wait_for_file(testfile, delete=True))
+        if supports_ipv6():
+            tcp6_proc = self.pyrun(tcp6_template)
+            tcp6_addr = eval(wait_for_file(testfile, delete=True))
+            udp6_proc = self.pyrun(udp6_template)
+            udp6_addr = eval(wait_for_file(testfile, delete=True))
+        else:
+            tcp6_proc = None
+            udp6_proc = None
+            tcp6_addr = None
+            udp6_addr = None
+
+        for p in thisproc.children():
+            cons = p.connections()
+            self.assertEqual(len(cons), 1)
+            for conn in cons:
+                # TCP v4
+                if p.pid == tcp4_proc.pid:
+                    check_conn(p, conn, AF_INET, SOCK_STREAM, tcp4_addr, (),
+                               psutil.CONN_LISTEN,
+                               ("all", "inet", "inet4", "tcp", "tcp4"))
+                # UDP v4
+                elif p.pid == udp4_proc.pid:
+                    check_conn(p, conn, AF_INET, SOCK_DGRAM, udp4_addr, (),
+                               psutil.CONN_NONE,
+                               ("all", "inet", "inet4", "udp", "udp4"))
+                # TCP v6
+                elif p.pid == getattr(tcp6_proc, "pid", None):
+                    check_conn(p, conn, AF_INET6, SOCK_STREAM, tcp6_addr, (),
+                               psutil.CONN_LISTEN,
+                               ("all", "inet", "inet6", "tcp", "tcp6"))
+                # UDP v6
+                elif p.pid == getattr(udp6_proc, "pid", None):
+                    check_conn(p, conn, AF_INET6, SOCK_DGRAM, udp6_addr, (),
+                               psutil.CONN_NONE,
+                               ("all", "inet", "inet6", "udp", "udp6"))
+
+    def test_count(self):
+        with create_sockets():
+            # tcp
+            cons = thisproc.connections(kind='tcp')
+            self.assertEqual(len(cons), 2 if supports_ipv6() else 1)
+            for conn in cons:
+                self.assertIn(conn.family, (AF_INET, AF_INET6))
+                self.assertEqual(conn.type, SOCK_STREAM)
+            # tcp4
+            cons = thisproc.connections(kind='tcp4')
+            self.assertEqual(len(cons), 1)
+            self.assertEqual(cons[0].family, AF_INET)
+            self.assertEqual(cons[0].type, SOCK_STREAM)
+            # tcp6
+            if supports_ipv6():
+                cons = thisproc.connections(kind='tcp6')
+                self.assertEqual(len(cons), 1)
+                self.assertEqual(cons[0].family, AF_INET6)
+                self.assertEqual(cons[0].type, SOCK_STREAM)
+            # udp
+            cons = thisproc.connections(kind='udp')
+            self.assertEqual(len(cons), 2 if supports_ipv6() else 1)
+            for conn in cons:
+                self.assertIn(conn.family, (AF_INET, AF_INET6))
+                self.assertEqual(conn.type, SOCK_DGRAM)
+            # udp4
+            cons = thisproc.connections(kind='udp4')
+            self.assertEqual(len(cons), 1)
+            self.assertEqual(cons[0].family, AF_INET)
+            self.assertEqual(cons[0].type, SOCK_DGRAM)
+            # udp6
+            if supports_ipv6():
+                cons = thisproc.connections(kind='udp6')
+                self.assertEqual(len(cons), 1)
+                self.assertEqual(cons[0].family, AF_INET6)
+                self.assertEqual(cons[0].type, SOCK_DGRAM)
+            # inet
+            cons = thisproc.connections(kind='inet')
+            self.assertEqual(len(cons), 4 if supports_ipv6() else 2)
+            for conn in cons:
+                self.assertIn(conn.family, (AF_INET, AF_INET6))
+                self.assertIn(conn.type, (SOCK_STREAM, SOCK_DGRAM))
+            # inet6
+            if supports_ipv6():
+                cons = thisproc.connections(kind='inet6')
+                self.assertEqual(len(cons), 2)
+                for conn in cons:
+                    self.assertEqual(conn.family, AF_INET6)
+                    self.assertIn(conn.type, (SOCK_STREAM, SOCK_DGRAM))
+            # Skipped on BSD becayse by default the Python process
+            # creates a UNIX socket to '/var/run/log'.
+            if HAS_CONNECTIONS_UNIX and not (FREEBSD or NETBSD):
+                cons = thisproc.connections(kind='unix')
+                self.assertEqual(len(cons), 3)
+                for conn in cons:
+                    self.assertEqual(conn.family, AF_UNIX)
+                    self.assertIn(conn.type, (SOCK_STREAM, SOCK_DGRAM))
+
+
+@unittest.skipIf(SKIP_SYSCONS, "requires root")
+class TestSystemWideConnections(_ConnTestCase):
+    """Tests for net_connections()."""
+
+    def test_it(self):
+        def check(cons, families, types_):
+            for conn in cons:
+                self.assertIn(conn.family, families, msg=conn)
+                if conn.family != AF_UNIX:
+                    self.assertIn(conn.type, types_, msg=conn)
+                self.check_connection_ntuple(conn)
+
+        with create_sockets():
+            from psutil._common import conn_tmap
+            for kind, groups in conn_tmap.items():
+                # XXX: SunOS does not retrieve UNIX sockets.
+                if kind == 'unix' and not HAS_CONNECTIONS_UNIX:
+                    continue
+                families, types_ = groups
+                cons = psutil.net_connections(kind)
+                self.assertEqual(len(cons), len(set(cons)))
+                check(cons, families, types_)
+
+    # See: https://travis-ci.org/giampaolo/psutil/jobs/237566297
+    @unittest.skipIf(MACOS and TRAVIS, "unreliable on MACOS + TRAVIS")
+    @retry_on_failure()
+    def test_multi_sockets_procs(self):
+        # Creates multiple sub processes, each creating different
+        # sockets. For each process check that proc.connections()
+        # and net_connections() return the same results.
+        # This is done mainly to check whether net_connections()'s
+        # pid is properly set, see:
+        # https://github.com/giampaolo/psutil/issues/1013
+        with create_sockets() as socks:
+            expected = len(socks)
+        pids = []
+        times = 10
+        fnames = []
+        for i in range(times):
+            fname = self.get_testfn()
+            fnames.append(fname)
+            src = textwrap.dedent("""\
+                import time, os
+                from psutil.tests import create_sockets
+                with create_sockets():
+                    with open(r'%s', 'w') as f:
+                        f.write("hello")
+                    time.sleep(60)
+                """ % fname)
+            sproc = self.pyrun(src)
+            pids.append(sproc.pid)
+
+        # sync
+        for fname in fnames:
+            wait_for_file(fname)
+
+        syscons = [x for x in psutil.net_connections(kind='all') if x.pid
+                   in pids]
+        for pid in pids:
+            self.assertEqual(len([x for x in syscons if x.pid == pid]),
+                             expected)
+            p = psutil.Process(pid)
+            self.assertEqual(len(p.connections('all')), expected)
+
+
+class TestMisc(PsutilTestCase):
+
+    def test_connection_constants(self):
+        ints = []
+        strs = []
+        for name in dir(psutil):
+            if name.startswith('CONN_'):
+                num = getattr(psutil, name)
+                str_ = str(num)
+                assert str_.isupper(), str_
+                self.assertNotIn(str, strs)
+                self.assertNotIn(num, ints)
+                ints.append(num)
+                strs.append(str_)
+        if SUNOS:
+            psutil.CONN_IDLE
+            psutil.CONN_BOUND
+        if WINDOWS:
+            psutil.CONN_DELETE_TCB
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_contracts.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_contracts.py
new file mode 100644
index 0000000000000000000000000000000000000000..39a525696000f799dfae0c817aeb45a7e8799281
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_contracts.py
@@ -0,0 +1,713 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Contracts tests. These tests mainly check API sanity in terms of
+returned types and APIs availability.
+Some of these are duplicates of tests test_system.py and test_process.py
+"""
+
+import errno
+import multiprocessing
+import os
+import signal
+import stat
+import sys
+import time
+import traceback
+
+from psutil import AIX
+from psutil import BSD
+from psutil import FREEBSD
+from psutil import LINUX
+from psutil import MACOS
+from psutil import NETBSD
+from psutil import OPENBSD
+from psutil import OSX
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._compat import FileNotFoundError
+from psutil._compat import long
+from psutil._compat import range
+from psutil.tests import create_sockets
+from psutil.tests import enum
+from psutil.tests import GITHUB_WHEELS
+from psutil.tests import HAS_CPU_FREQ
+from psutil.tests import HAS_NET_IO_COUNTERS
+from psutil.tests import HAS_SENSORS_FANS
+from psutil.tests import HAS_SENSORS_TEMPERATURES
+from psutil.tests import is_namedtuple
+from psutil.tests import process_namespace
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYPY
+from psutil.tests import serialrun
+from psutil.tests import SKIP_SYSCONS
+from psutil.tests import unittest
+from psutil.tests import VALID_PROC_STATUSES
+import psutil
+
+
+# ===================================================================
+# --- APIs availability
+# ===================================================================
+
+# Make sure code reflects what doc promises in terms of APIs
+# availability.
+
+class TestAvailConstantsAPIs(PsutilTestCase):
+
+    def test_PROCFS_PATH(self):
+        self.assertEqual(hasattr(psutil, "PROCFS_PATH"),
+                         LINUX or SUNOS or AIX)
+
+    def test_win_priority(self):
+        ae = self.assertEqual
+        ae(hasattr(psutil, "ABOVE_NORMAL_PRIORITY_CLASS"), WINDOWS)
+        ae(hasattr(psutil, "BELOW_NORMAL_PRIORITY_CLASS"), WINDOWS)
+        ae(hasattr(psutil, "HIGH_PRIORITY_CLASS"), WINDOWS)
+        ae(hasattr(psutil, "IDLE_PRIORITY_CLASS"), WINDOWS)
+        ae(hasattr(psutil, "NORMAL_PRIORITY_CLASS"), WINDOWS)
+        ae(hasattr(psutil, "REALTIME_PRIORITY_CLASS"), WINDOWS)
+
+    def test_linux_ioprio_linux(self):
+        ae = self.assertEqual
+        ae(hasattr(psutil, "IOPRIO_CLASS_NONE"), LINUX)
+        ae(hasattr(psutil, "IOPRIO_CLASS_RT"), LINUX)
+        ae(hasattr(psutil, "IOPRIO_CLASS_BE"), LINUX)
+        ae(hasattr(psutil, "IOPRIO_CLASS_IDLE"), LINUX)
+
+    def test_linux_ioprio_windows(self):
+        ae = self.assertEqual
+        ae(hasattr(psutil, "IOPRIO_HIGH"), WINDOWS)
+        ae(hasattr(psutil, "IOPRIO_NORMAL"), WINDOWS)
+        ae(hasattr(psutil, "IOPRIO_LOW"), WINDOWS)
+        ae(hasattr(psutil, "IOPRIO_VERYLOW"), WINDOWS)
+
+    @unittest.skipIf(GITHUB_WHEELS, "not exposed via GITHUB_WHEELS")
+    def test_linux_rlimit(self):
+        ae = self.assertEqual
+        ae(hasattr(psutil, "RLIM_INFINITY"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_AS"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_CORE"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_CPU"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_DATA"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_FSIZE"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_MEMLOCK"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_NOFILE"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_NPROC"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_RSS"), LINUX or FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_STACK"), LINUX or FREEBSD)
+
+        ae(hasattr(psutil, "RLIMIT_LOCKS"), LINUX)
+        ae(hasattr(psutil, "RLIMIT_MSGQUEUE"), LINUX)  # requires Linux 2.6.8
+        ae(hasattr(psutil, "RLIMIT_NICE"), LINUX)  # requires Linux 2.6.12
+        ae(hasattr(psutil, "RLIMIT_RTPRIO"), LINUX)  # requires Linux 2.6.12
+        ae(hasattr(psutil, "RLIMIT_RTTIME"), LINUX)  # requires Linux 2.6.25
+        ae(hasattr(psutil, "RLIMIT_SIGPENDING"), LINUX)  # requires Linux 2.6.8
+
+        ae(hasattr(psutil, "RLIMIT_SWAP"), FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_SBSIZE"), FREEBSD)
+        ae(hasattr(psutil, "RLIMIT_NPTS"), FREEBSD)
+
+
+class TestAvailSystemAPIs(PsutilTestCase):
+
+    def test_win_service_iter(self):
+        self.assertEqual(hasattr(psutil, "win_service_iter"), WINDOWS)
+
+    def test_win_service_get(self):
+        self.assertEqual(hasattr(psutil, "win_service_get"), WINDOWS)
+
+    def test_cpu_freq(self):
+        self.assertEqual(hasattr(psutil, "cpu_freq"),
+                         LINUX or MACOS or WINDOWS or FREEBSD)
+
+    def test_sensors_temperatures(self):
+        self.assertEqual(
+            hasattr(psutil, "sensors_temperatures"), LINUX or FREEBSD)
+
+    def test_sensors_fans(self):
+        self.assertEqual(hasattr(psutil, "sensors_fans"), LINUX)
+
+    def test_battery(self):
+        self.assertEqual(hasattr(psutil, "sensors_battery"),
+                         LINUX or WINDOWS or FREEBSD or MACOS)
+
+
+class TestAvailProcessAPIs(PsutilTestCase):
+
+    def test_environ(self):
+        self.assertEqual(hasattr(psutil.Process, "environ"),
+                         LINUX or MACOS or WINDOWS or AIX or SUNOS or
+                         FREEBSD or OPENBSD or NETBSD)
+
+    def test_uids(self):
+        self.assertEqual(hasattr(psutil.Process, "uids"), POSIX)
+
+    def test_gids(self):
+        self.assertEqual(hasattr(psutil.Process, "uids"), POSIX)
+
+    def test_terminal(self):
+        self.assertEqual(hasattr(psutil.Process, "terminal"), POSIX)
+
+    def test_ionice(self):
+        self.assertEqual(hasattr(psutil.Process, "ionice"), LINUX or WINDOWS)
+
+    @unittest.skipIf(GITHUB_WHEELS, "not exposed via GITHUB_WHEELS")
+    def test_rlimit(self):
+        # requires Linux 2.6.36
+        self.assertEqual(hasattr(psutil.Process, "rlimit"), LINUX or FREEBSD)
+
+    def test_io_counters(self):
+        hasit = hasattr(psutil.Process, "io_counters")
+        self.assertEqual(hasit, False if MACOS or SUNOS else True)
+
+    def test_num_fds(self):
+        self.assertEqual(hasattr(psutil.Process, "num_fds"), POSIX)
+
+    def test_num_handles(self):
+        self.assertEqual(hasattr(psutil.Process, "num_handles"), WINDOWS)
+
+    def test_cpu_affinity(self):
+        self.assertEqual(hasattr(psutil.Process, "cpu_affinity"),
+                         LINUX or WINDOWS or FREEBSD)
+
+    def test_cpu_num(self):
+        self.assertEqual(hasattr(psutil.Process, "cpu_num"),
+                         LINUX or FREEBSD or SUNOS)
+
+    def test_memory_maps(self):
+        hasit = hasattr(psutil.Process, "memory_maps")
+        self.assertEqual(
+            hasit, False if OPENBSD or NETBSD or AIX or MACOS else True)
+
+
+# ===================================================================
+# --- API types
+# ===================================================================
+
+
+class TestSystemAPITypes(PsutilTestCase):
+    """Check the return types of system related APIs.
+    Mainly we want to test we never return unicode on Python 2, see:
+    https://github.com/giampaolo/psutil/issues/1039
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        cls.proc = psutil.Process()
+
+    def assert_ntuple_of_nums(self, nt, type_=float, gezero=True):
+        assert is_namedtuple(nt)
+        for n in nt:
+            self.assertIsInstance(n, type_)
+            if gezero:
+                self.assertGreaterEqual(n, 0)
+
+    def test_cpu_times(self):
+        self.assert_ntuple_of_nums(psutil.cpu_times())
+        for nt in psutil.cpu_times(percpu=True):
+            self.assert_ntuple_of_nums(nt)
+
+    def test_cpu_percent(self):
+        self.assertIsInstance(psutil.cpu_percent(interval=None), float)
+        self.assertIsInstance(psutil.cpu_percent(interval=0.00001), float)
+
+    def test_cpu_times_percent(self):
+        self.assert_ntuple_of_nums(psutil.cpu_times_percent(interval=None))
+        self.assert_ntuple_of_nums(psutil.cpu_times_percent(interval=0.0001))
+
+    def test_cpu_count(self):
+        self.assertIsInstance(psutil.cpu_count(), int)
+
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_cpu_freq(self):
+        if psutil.cpu_freq() is None:
+            raise self.skipTest("cpu_freq() returns None")
+        self.assert_ntuple_of_nums(psutil.cpu_freq(), type_=(float, int, long))
+
+    def test_disk_io_counters(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for k, v in psutil.disk_io_counters(perdisk=True).items():
+            self.assertIsInstance(k, str)
+            self.assert_ntuple_of_nums(v, type_=(int, long))
+
+    def test_disk_partitions(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for disk in psutil.disk_partitions():
+            self.assertIsInstance(disk.device, str)
+            self.assertIsInstance(disk.mountpoint, str)
+            self.assertIsInstance(disk.fstype, str)
+            self.assertIsInstance(disk.opts, str)
+
+    @unittest.skipIf(SKIP_SYSCONS, "requires root")
+    def test_net_connections(self):
+        with create_sockets():
+            ret = psutil.net_connections('all')
+            self.assertEqual(len(ret), len(set(ret)))
+            for conn in ret:
+                assert is_namedtuple(conn)
+
+    def test_net_if_addrs(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for ifname, addrs in psutil.net_if_addrs().items():
+            self.assertIsInstance(ifname, str)
+            for addr in addrs:
+                if enum is not None and not PYPY:
+                    self.assertIsInstance(addr.family, enum.IntEnum)
+                else:
+                    self.assertIsInstance(addr.family, int)
+                self.assertIsInstance(addr.address, str)
+                self.assertIsInstance(addr.netmask, (str, type(None)))
+                self.assertIsInstance(addr.broadcast, (str, type(None)))
+
+    def test_net_if_stats(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for ifname, info in psutil.net_if_stats().items():
+            self.assertIsInstance(ifname, str)
+            self.assertIsInstance(info.isup, bool)
+            if enum is not None:
+                self.assertIsInstance(info.duplex, enum.IntEnum)
+            else:
+                self.assertIsInstance(info.duplex, int)
+            self.assertIsInstance(info.speed, int)
+            self.assertIsInstance(info.mtu, int)
+
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, 'not supported')
+    def test_net_io_counters(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for ifname, _ in psutil.net_io_counters(pernic=True).items():
+            self.assertIsInstance(ifname, str)
+
+    @unittest.skipIf(not HAS_SENSORS_FANS, "not supported")
+    def test_sensors_fans(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for name, units in psutil.sensors_fans().items():
+            self.assertIsInstance(name, str)
+            for unit in units:
+                self.assertIsInstance(unit.label, str)
+                self.assertIsInstance(unit.current, (float, int, type(None)))
+
+    @unittest.skipIf(not HAS_SENSORS_TEMPERATURES, "not supported")
+    def test_sensors_temperatures(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for name, units in psutil.sensors_temperatures().items():
+            self.assertIsInstance(name, str)
+            for unit in units:
+                self.assertIsInstance(unit.label, str)
+                self.assertIsInstance(unit.current, (float, int, type(None)))
+                self.assertIsInstance(unit.high, (float, int, type(None)))
+                self.assertIsInstance(unit.critical, (float, int, type(None)))
+
+    def test_boot_time(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        self.assertIsInstance(psutil.boot_time(), float)
+
+    def test_users(self):
+        # Duplicate of test_system.py. Keep it anyway.
+        for user in psutil.users():
+            self.assertIsInstance(user.name, str)
+            self.assertIsInstance(user.terminal, (str, type(None)))
+            self.assertIsInstance(user.host, (str, type(None)))
+            self.assertIsInstance(user.pid, (int, type(None)))
+
+
+class TestProcessWaitType(PsutilTestCase):
+
+    @unittest.skipIf(not POSIX, "not POSIX")
+    def test_negative_signal(self):
+        p = psutil.Process(self.spawn_testproc().pid)
+        p.terminate()
+        code = p.wait()
+        self.assertEqual(code, -signal.SIGTERM)
+        if enum is not None:
+            self.assertIsInstance(code, enum.IntEnum)
+        else:
+            self.assertIsInstance(code, int)
+
+
+# ===================================================================
+# --- Featch all processes test
+# ===================================================================
+
+
+def proc_info(pid):
+    tcase = PsutilTestCase()
+
+    def check_exception(exc, proc, name, ppid):
+        tcase.assertEqual(exc.pid, pid)
+        tcase.assertEqual(exc.name, name)
+        if isinstance(exc, psutil.ZombieProcess):
+            if exc.ppid is not None:
+                tcase.assertGreaterEqual(exc.ppid, 0)
+                tcase.assertEqual(exc.ppid, ppid)
+        elif isinstance(exc, psutil.NoSuchProcess):
+            tcase.assertProcessGone(proc)
+        str(exc)
+        assert exc.msg
+
+    def do_wait():
+        if pid != 0:
+            try:
+                proc.wait(0)
+            except psutil.Error as exc:
+                check_exception(exc, proc, name, ppid)
+
+    try:
+        proc = psutil.Process(pid)
+        d = proc.as_dict(['ppid', 'name'])
+    except psutil.NoSuchProcess:
+        return {}
+
+    name, ppid = d['name'], d['ppid']
+    info = {'pid': proc.pid}
+    ns = process_namespace(proc)
+    with proc.oneshot():
+        for fun, fun_name in ns.iter(ns.getters, clear_cache=False):
+            try:
+                info[fun_name] = fun()
+            except psutil.Error as exc:
+                check_exception(exc, proc, name, ppid)
+                continue
+        do_wait()
+    return info
+
+
+@serialrun
+class TestFetchAllProcesses(PsutilTestCase):
+    """Test which iterates over all running processes and performs
+    some sanity checks against Process API's returned values.
+    Uses a process pool to get info about all processes.
+    """
+
+    def setUp(self):
+        self.pool = multiprocessing.Pool()
+
+    def tearDown(self):
+        self.pool.terminate()
+        self.pool.join()
+
+    def iter_proc_info(self):
+        # Fixes "can't pickle <function proc_info>: it's not the
+        # same object as test_contracts.proc_info".
+        from psutil.tests.test_contracts import proc_info
+        return self.pool.imap_unordered(proc_info, psutil.pids())
+
+    def test_all(self):
+        failures = []
+        for info in self.iter_proc_info():
+            for name, value in info.items():
+                meth = getattr(self, name)
+                try:
+                    meth(value, info)
+                except AssertionError:
+                    s = '\n' + '=' * 70 + '\n'
+                    s += "FAIL: test_%s pid=%s, ret=%s\n" % (
+                        name, info['pid'], repr(value))
+                    s += '-' * 70
+                    s += "\n%s" % traceback.format_exc()
+                    s = "\n".join((" " * 4) + i for i in s.splitlines())
+                    s += '\n'
+                    failures.append(s)
+                else:
+                    if value not in (0, 0.0, [], None, '', {}):
+                        assert value, value
+        if failures:
+            raise self.fail(''.join(failures))
+
+    def cmdline(self, ret, info):
+        self.assertIsInstance(ret, list)
+        for part in ret:
+            self.assertIsInstance(part, str)
+
+    def exe(self, ret, info):
+        self.assertIsInstance(ret, (str, type(None)))
+        if not ret:
+            self.assertEqual(ret, '')
+        else:
+            if WINDOWS and not ret.endswith('.exe'):
+                return  # May be "Registry", "MemCompression", ...
+            assert os.path.isabs(ret), ret
+            # Note: os.stat() may return False even if the file is there
+            # hence we skip the test, see:
+            # http://stackoverflow.com/questions/3112546/os-path-exists-lies
+            if POSIX and os.path.isfile(ret):
+                if hasattr(os, 'access') and hasattr(os, "X_OK"):
+                    # XXX may fail on MACOS
+                    assert os.access(ret, os.X_OK)
+
+    def pid(self, ret, info):
+        self.assertIsInstance(ret, int)
+        self.assertGreaterEqual(ret, 0)
+
+    def ppid(self, ret, info):
+        self.assertIsInstance(ret, (int, long))
+        self.assertGreaterEqual(ret, 0)
+
+    def name(self, ret, info):
+        self.assertIsInstance(ret, str)
+        # on AIX, "<exiting>" processes don't have names
+        if not AIX:
+            assert ret
+
+    def create_time(self, ret, info):
+        self.assertIsInstance(ret, float)
+        try:
+            self.assertGreaterEqual(ret, 0)
+        except AssertionError:
+            # XXX
+            if OPENBSD and info['status'] == psutil.STATUS_ZOMBIE:
+                pass
+            else:
+                raise
+        # this can't be taken for granted on all platforms
+        # self.assertGreaterEqual(ret, psutil.boot_time())
+        # make sure returned value can be pretty printed
+        # with strftime
+        time.strftime("%Y %m %d %H:%M:%S", time.localtime(ret))
+
+    def uids(self, ret, info):
+        assert is_namedtuple(ret)
+        for uid in ret:
+            self.assertIsInstance(uid, int)
+            self.assertGreaterEqual(uid, 0)
+
+    def gids(self, ret, info):
+        assert is_namedtuple(ret)
+        # note: testing all gids as above seems not to be reliable for
+        # gid == 30 (nodoby); not sure why.
+        for gid in ret:
+            self.assertIsInstance(gid, int)
+            if not MACOS and not NETBSD:
+                self.assertGreaterEqual(gid, 0)
+
+    def username(self, ret, info):
+        self.assertIsInstance(ret, str)
+        assert ret
+
+    def status(self, ret, info):
+        self.assertIsInstance(ret, str)
+        assert ret
+        self.assertNotEqual(ret, '?')  # XXX
+        self.assertIn(ret, VALID_PROC_STATUSES)
+
+    def io_counters(self, ret, info):
+        assert is_namedtuple(ret)
+        for field in ret:
+            self.assertIsInstance(field, (int, long))
+            if field != -1:
+                self.assertGreaterEqual(field, 0)
+
+    def ionice(self, ret, info):
+        if LINUX:
+            self.assertIsInstance(ret.ioclass, int)
+            self.assertIsInstance(ret.value, int)
+            self.assertGreaterEqual(ret.ioclass, 0)
+            self.assertGreaterEqual(ret.value, 0)
+        else:  # Windows, Cygwin
+            choices = [
+                psutil.IOPRIO_VERYLOW,
+                psutil.IOPRIO_LOW,
+                psutil.IOPRIO_NORMAL,
+                psutil.IOPRIO_HIGH]
+            self.assertIsInstance(ret, int)
+            self.assertGreaterEqual(ret, 0)
+            self.assertIn(ret, choices)
+
+    def num_threads(self, ret, info):
+        self.assertIsInstance(ret, int)
+        self.assertGreaterEqual(ret, 1)
+
+    def threads(self, ret, info):
+        self.assertIsInstance(ret, list)
+        for t in ret:
+            assert is_namedtuple(t)
+            self.assertGreaterEqual(t.id, 0)
+            self.assertGreaterEqual(t.user_time, 0)
+            self.assertGreaterEqual(t.system_time, 0)
+            for field in t:
+                self.assertIsInstance(field, (int, float))
+
+    def cpu_times(self, ret, info):
+        assert is_namedtuple(ret)
+        for n in ret:
+            self.assertIsInstance(n, float)
+            self.assertGreaterEqual(n, 0)
+        # TODO: check ntuple fields
+
+    def cpu_percent(self, ret, info):
+        self.assertIsInstance(ret, float)
+        assert 0.0 <= ret <= 100.0, ret
+
+    def cpu_num(self, ret, info):
+        self.assertIsInstance(ret, int)
+        if FREEBSD and ret == -1:
+            return
+        self.assertGreaterEqual(ret, 0)
+        if psutil.cpu_count() == 1:
+            self.assertEqual(ret, 0)
+        self.assertIn(ret, list(range(psutil.cpu_count())))
+
+    def memory_info(self, ret, info):
+        assert is_namedtuple(ret)
+        for value in ret:
+            self.assertIsInstance(value, (int, long))
+            self.assertGreaterEqual(value, 0)
+        if WINDOWS:
+            self.assertGreaterEqual(ret.peak_wset, ret.wset)
+            self.assertGreaterEqual(ret.peak_paged_pool, ret.paged_pool)
+            self.assertGreaterEqual(ret.peak_nonpaged_pool, ret.nonpaged_pool)
+            self.assertGreaterEqual(ret.peak_pagefile, ret.pagefile)
+
+    def memory_full_info(self, ret, info):
+        assert is_namedtuple(ret)
+        total = psutil.virtual_memory().total
+        for name in ret._fields:
+            value = getattr(ret, name)
+            self.assertIsInstance(value, (int, long))
+            self.assertGreaterEqual(value, 0, msg=(name, value))
+            if LINUX or OSX and name in ('vms', 'data'):
+                # On Linux there are processes (e.g. 'goa-daemon') whose
+                # VMS is incredibly high for some reason.
+                continue
+            self.assertLessEqual(value, total, msg=(name, value, total))
+
+        if LINUX:
+            self.assertGreaterEqual(ret.pss, ret.uss)
+
+    def open_files(self, ret, info):
+        self.assertIsInstance(ret, list)
+        for f in ret:
+            self.assertIsInstance(f.fd, int)
+            self.assertIsInstance(f.path, str)
+            if WINDOWS:
+                self.assertEqual(f.fd, -1)
+            elif LINUX:
+                self.assertIsInstance(f.position, int)
+                self.assertIsInstance(f.mode, str)
+                self.assertIsInstance(f.flags, int)
+                self.assertGreaterEqual(f.position, 0)
+                self.assertIn(f.mode, ('r', 'w', 'a', 'r+', 'a+'))
+                self.assertGreater(f.flags, 0)
+            elif BSD and not f.path:
+                # XXX see: https://github.com/giampaolo/psutil/issues/595
+                continue
+            assert os.path.isabs(f.path), f
+            try:
+                st = os.stat(f.path)
+            except FileNotFoundError:
+                pass
+            else:
+                assert stat.S_ISREG(st.st_mode), f
+
+    def num_fds(self, ret, info):
+        self.assertIsInstance(ret, int)
+        self.assertGreaterEqual(ret, 0)
+
+    def connections(self, ret, info):
+        with create_sockets():
+            self.assertEqual(len(ret), len(set(ret)))
+            for conn in ret:
+                assert is_namedtuple(conn)
+
+    def cwd(self, ret, info):
+        if ret:     # 'ret' can be None or empty
+            self.assertIsInstance(ret, str)
+            assert os.path.isabs(ret), ret
+            try:
+                st = os.stat(ret)
+            except OSError as err:
+                if WINDOWS and err.errno in \
+                        psutil._psplatform.ACCESS_DENIED_SET:
+                    pass
+                # directory has been removed in mean time
+                elif err.errno != errno.ENOENT:
+                    raise
+            else:
+                assert stat.S_ISDIR(st.st_mode)
+
+    def memory_percent(self, ret, info):
+        self.assertIsInstance(ret, float)
+        assert 0 <= ret <= 100, ret
+
+    def is_running(self, ret, info):
+        self.assertIsInstance(ret, bool)
+
+    def cpu_affinity(self, ret, info):
+        self.assertIsInstance(ret, list)
+        assert ret != [], ret
+        cpus = list(range(psutil.cpu_count()))
+        for n in ret:
+            self.assertIsInstance(n, int)
+            self.assertIn(n, cpus)
+
+    def terminal(self, ret, info):
+        self.assertIsInstance(ret, (str, type(None)))
+        if ret is not None:
+            assert os.path.isabs(ret), ret
+            assert os.path.exists(ret), ret
+
+    def memory_maps(self, ret, info):
+        for nt in ret:
+            self.assertIsInstance(nt.addr, str)
+            self.assertIsInstance(nt.perms, str)
+            self.assertIsInstance(nt.path, str)
+            for fname in nt._fields:
+                value = getattr(nt, fname)
+                if fname == 'path':
+                    if not value.startswith('['):
+                        assert os.path.isabs(nt.path), nt.path
+                        # commented as on Linux we might get
+                        # '/foo/bar (deleted)'
+                        # assert os.path.exists(nt.path), nt.path
+                elif fname == 'addr':
+                    assert value, repr(value)
+                elif fname == 'perms':
+                    if not WINDOWS:
+                        assert value, repr(value)
+                else:
+                    self.assertIsInstance(value, (int, long))
+                    self.assertGreaterEqual(value, 0)
+
+    def num_handles(self, ret, info):
+        self.assertIsInstance(ret, int)
+        self.assertGreaterEqual(ret, 0)
+
+    def nice(self, ret, info):
+        self.assertIsInstance(ret, int)
+        if POSIX:
+            assert -20 <= ret <= 20, ret
+        else:
+            priorities = [getattr(psutil, x) for x in dir(psutil)
+                          if x.endswith('_PRIORITY_CLASS')]
+            self.assertIn(ret, priorities)
+            if sys.version_info > (3, 4):
+                self.assertIsInstance(ret, enum.IntEnum)
+            else:
+                self.assertIsInstance(ret, int)
+
+    def num_ctx_switches(self, ret, info):
+        assert is_namedtuple(ret)
+        for value in ret:
+            self.assertIsInstance(value, (int, long))
+            self.assertGreaterEqual(value, 0)
+
+    def rlimit(self, ret, info):
+        self.assertIsInstance(ret, tuple)
+        self.assertEqual(len(ret), 2)
+        self.assertGreaterEqual(ret[0], -1)
+        self.assertGreaterEqual(ret[1], -1)
+
+    def environ(self, ret, info):
+        self.assertIsInstance(ret, dict)
+        for k, v in ret.items():
+            self.assertIsInstance(k, str)
+            self.assertIsInstance(v, str)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_linux.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_linux.py
new file mode 100644
index 0000000000000000000000000000000000000000..519d4b2e2faaf02302f7605dce6e9cb2f4e03374
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_linux.py
@@ -0,0 +1,2191 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Linux specific tests."""
+
+from __future__ import division
+import collections
+import contextlib
+import errno
+import glob
+import io
+import os
+import re
+import shutil
+import socket
+import struct
+import textwrap
+import time
+import warnings
+
+import psutil
+from psutil import LINUX
+from psutil._compat import basestring
+from psutil._compat import FileNotFoundError
+from psutil._compat import PY3
+from psutil._compat import u
+from psutil.tests import call_until
+from psutil.tests import GLOBAL_TIMEOUT
+from psutil.tests import HAS_BATTERY
+from psutil.tests import HAS_CPU_FREQ
+from psutil.tests import HAS_GETLOADAVG
+from psutil.tests import HAS_RLIMIT
+from psutil.tests import mock
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYPY
+from psutil.tests import reload_module
+from psutil.tests import retry_on_failure
+from psutil.tests import safe_rmpath
+from psutil.tests import sh
+from psutil.tests import skip_on_not_implemented
+from psutil.tests import ThreadTask
+from psutil.tests import TOLERANCE_DISK_USAGE
+from psutil.tests import TOLERANCE_SYS_MEM
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+from psutil.tests import which
+
+
+HERE = os.path.abspath(os.path.dirname(__file__))
+SIOCGIFADDR = 0x8915
+SIOCGIFCONF = 0x8912
+SIOCGIFHWADDR = 0x8927
+SIOCGIFNETMASK = 0x891b
+SIOCGIFBRDADDR = 0x8919
+if LINUX:
+    SECTOR_SIZE = 512
+EMPTY_TEMPERATURES = not glob.glob('/sys/class/hwmon/hwmon*')
+
+# =====================================================================
+# --- utils
+# =====================================================================
+
+
+def get_ipv4_address(ifname):
+    import fcntl
+    ifname = ifname[:15]
+    if PY3:
+        ifname = bytes(ifname, 'ascii')
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    with contextlib.closing(s):
+        return socket.inet_ntoa(
+            fcntl.ioctl(s.fileno(),
+                        SIOCGIFADDR,
+                        struct.pack('256s', ifname))[20:24])
+
+
+def get_ipv4_netmask(ifname):
+    import fcntl
+    ifname = ifname[:15]
+    if PY3:
+        ifname = bytes(ifname, 'ascii')
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    with contextlib.closing(s):
+        return socket.inet_ntoa(
+            fcntl.ioctl(s.fileno(),
+                        SIOCGIFNETMASK,
+                        struct.pack('256s', ifname))[20:24])
+
+
+def get_ipv4_broadcast(ifname):
+    import fcntl
+    ifname = ifname[:15]
+    if PY3:
+        ifname = bytes(ifname, 'ascii')
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    with contextlib.closing(s):
+        return socket.inet_ntoa(
+            fcntl.ioctl(s.fileno(),
+                        SIOCGIFBRDADDR,
+                        struct.pack('256s', ifname))[20:24])
+
+
+def get_ipv6_address(ifname):
+    with open("/proc/net/if_inet6", 'rt') as f:
+        for line in f.readlines():
+            fields = line.split()
+            if fields[-1] == ifname:
+                break
+        else:
+            raise ValueError("could not find interface %r" % ifname)
+    unformatted = fields[0]
+    groups = []
+    for i in range(0, len(unformatted), 4):
+        groups.append(unformatted[i:i + 4])
+    formatted = ":".join(groups)
+    packed = socket.inet_pton(socket.AF_INET6, formatted)
+    return socket.inet_ntop(socket.AF_INET6, packed)
+
+
+def get_mac_address(ifname):
+    import fcntl
+    ifname = ifname[:15]
+    if PY3:
+        ifname = bytes(ifname, 'ascii')
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    with contextlib.closing(s):
+        info = fcntl.ioctl(
+            s.fileno(), SIOCGIFHWADDR, struct.pack('256s', ifname))
+        if PY3:
+            def ord(x):
+                return x
+        else:
+            import __builtin__
+            ord = __builtin__.ord
+        return ''.join(['%02x:' % ord(char) for char in info[18:24]])[:-1]
+
+
+def free_swap():
+    """Parse 'free' cmd and return swap memory's s total, used and free
+    values.
+    """
+    out = sh('free -b', env={"LANG": "C.UTF-8"})
+    lines = out.split('\n')
+    for line in lines:
+        if line.startswith('Swap'):
+            _, total, used, free = line.split()
+            nt = collections.namedtuple('free', 'total used free')
+            return nt(int(total), int(used), int(free))
+    raise ValueError(
+        "can't find 'Swap' in 'free' output:\n%s" % '\n'.join(lines))
+
+
+def free_physmem():
+    """Parse 'free' cmd and return physical memory's total, used
+    and free values.
+    """
+    # Note: free can have 2 different formats, invalidating 'shared'
+    # and 'cached' memory which may have different positions so we
+    # do not return them.
+    # https://github.com/giampaolo/psutil/issues/538#issuecomment-57059946
+    out = sh('free -b', env={"LANG": "C.UTF-8"})
+    lines = out.split('\n')
+    for line in lines:
+        if line.startswith('Mem'):
+            total, used, free, shared = \
+                [int(x) for x in line.split()[1:5]]
+            nt = collections.namedtuple(
+                'free', 'total used free shared output')
+            return nt(total, used, free, shared, out)
+    raise ValueError(
+        "can't find 'Mem' in 'free' output:\n%s" % '\n'.join(lines))
+
+
+def vmstat(stat):
+    out = sh("vmstat -s", env={"LANG": "C.UTF-8"})
+    for line in out.split("\n"):
+        line = line.strip()
+        if stat in line:
+            return int(line.split(' ')[0])
+    raise ValueError("can't find %r in 'vmstat' output" % stat)
+
+
+def get_free_version_info():
+    out = sh("free -V").strip()
+    if 'UNKNOWN' in out:
+        raise unittest.SkipTest("can't determine free version")
+    return tuple(map(int, out.split()[-1].split('.')))
+
+
+@contextlib.contextmanager
+def mock_open_content(for_path, content):
+    """Mock open() builtin and forces it to return a certain `content`
+    on read() if the path being opened matches `for_path`.
+    """
+    def open_mock(name, *args, **kwargs):
+        if name == for_path:
+            if PY3:
+                if isinstance(content, basestring):
+                    return io.StringIO(content)
+                else:
+                    return io.BytesIO(content)
+            else:
+                return io.BytesIO(content)
+        else:
+            return orig_open(name, *args, **kwargs)
+
+    orig_open = open
+    patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+    with mock.patch(patch_point, create=True, side_effect=open_mock) as m:
+        yield m
+
+
+@contextlib.contextmanager
+def mock_open_exception(for_path, exc):
+    """Mock open() builtin and raises `exc` if the path being opened
+    matches `for_path`.
+    """
+    def open_mock(name, *args, **kwargs):
+        if name == for_path:
+            raise exc
+        else:
+            return orig_open(name, *args, **kwargs)
+
+    orig_open = open
+    patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+    with mock.patch(patch_point, create=True, side_effect=open_mock) as m:
+        yield m
+
+
+# =====================================================================
+# --- system virtual memory
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemVirtualMemory(PsutilTestCase):
+
+    def test_total(self):
+        # free_value = free_physmem().total
+        # psutil_value = psutil.virtual_memory().total
+        # self.assertEqual(free_value, psutil_value)
+        vmstat_value = vmstat('total memory') * 1024
+        psutil_value = psutil.virtual_memory().total
+        self.assertAlmostEqual(vmstat_value, psutil_value)
+
+    @retry_on_failure()
+    def test_used(self):
+        # Older versions of procps used slab memory to calculate used memory.
+        # This got changed in:
+        # https://gitlab.com/procps-ng/procps/commit/
+        #     05d751c4f076a2f0118b914c5e51cfbb4762ad8e
+        if get_free_version_info() < (3, 3, 12):
+            raise self.skipTest("old free version")
+        free = free_physmem()
+        free_value = free.used
+        psutil_value = psutil.virtual_memory().used
+        self.assertAlmostEqual(
+            free_value, psutil_value, delta=TOLERANCE_SYS_MEM,
+            msg='%s %s \n%s' % (free_value, psutil_value, free.output))
+
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    @retry_on_failure()
+    def test_free(self):
+        vmstat_value = vmstat('free memory') * 1024
+        psutil_value = psutil.virtual_memory().free
+        self.assertAlmostEqual(
+            vmstat_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_buffers(self):
+        vmstat_value = vmstat('buffer memory') * 1024
+        psutil_value = psutil.virtual_memory().buffers
+        self.assertAlmostEqual(
+            vmstat_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    # https://travis-ci.org/giampaolo/psutil/jobs/226719664
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    @retry_on_failure()
+    def test_active(self):
+        vmstat_value = vmstat('active memory') * 1024
+        psutil_value = psutil.virtual_memory().active
+        self.assertAlmostEqual(
+            vmstat_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    # https://travis-ci.org/giampaolo/psutil/jobs/227242952
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    @retry_on_failure()
+    def test_inactive(self):
+        vmstat_value = vmstat('inactive memory') * 1024
+        psutil_value = psutil.virtual_memory().inactive
+        self.assertAlmostEqual(
+            vmstat_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_shared(self):
+        free = free_physmem()
+        free_value = free.shared
+        if free_value == 0:
+            raise unittest.SkipTest("free does not support 'shared' column")
+        psutil_value = psutil.virtual_memory().shared
+        self.assertAlmostEqual(
+            free_value, psutil_value, delta=TOLERANCE_SYS_MEM,
+            msg='%s %s \n%s' % (free_value, psutil_value, free.output))
+
+    @retry_on_failure()
+    def test_available(self):
+        # "free" output format has changed at some point:
+        # https://github.com/giampaolo/psutil/issues/538#issuecomment-147192098
+        out = sh("free -b")
+        lines = out.split('\n')
+        if 'available' not in lines[0]:
+            raise unittest.SkipTest("free does not support 'available' column")
+        else:
+            free_value = int(lines[1].split()[-1])
+            psutil_value = psutil.virtual_memory().available
+            self.assertAlmostEqual(
+                free_value, psutil_value, delta=TOLERANCE_SYS_MEM,
+                msg='%s %s \n%s' % (free_value, psutil_value, out))
+
+    def test_warnings_on_misses(self):
+        # Emulate a case where /proc/meminfo provides few info.
+        # psutil is supposed to set the missing fields to 0 and
+        # raise a warning.
+        with mock_open_content(
+            '/proc/meminfo',
+            textwrap.dedent("""\
+                Active(anon):    6145416 kB
+                Active(file):    2950064 kB
+                Inactive(anon):   574764 kB
+                Inactive(file):  1567648 kB
+                MemAvailable:         -1 kB
+                MemFree:         2057400 kB
+                MemTotal:       16325648 kB
+                SReclaimable:     346648 kB
+                """).encode()) as m:
+            with warnings.catch_warnings(record=True) as ws:
+                warnings.simplefilter("always")
+                ret = psutil.virtual_memory()
+                assert m.called
+                self.assertEqual(len(ws), 1)
+                w = ws[0]
+                assert w.filename.endswith('psutil/_pslinux.py')
+                self.assertIn(
+                    "memory stats couldn't be determined", str(w.message))
+                self.assertIn("cached", str(w.message))
+                self.assertIn("shared", str(w.message))
+                self.assertIn("active", str(w.message))
+                self.assertIn("inactive", str(w.message))
+                self.assertIn("buffers", str(w.message))
+                self.assertIn("available", str(w.message))
+                self.assertEqual(ret.cached, 0)
+                self.assertEqual(ret.active, 0)
+                self.assertEqual(ret.inactive, 0)
+                self.assertEqual(ret.shared, 0)
+                self.assertEqual(ret.buffers, 0)
+                self.assertEqual(ret.available, 0)
+                self.assertEqual(ret.slab, 0)
+
+    @retry_on_failure()
+    def test_avail_old_percent(self):
+        # Make sure that our calculation of avail mem for old kernels
+        # is off by max 15%.
+        from psutil._pslinux import calculate_avail_vmem
+        from psutil._pslinux import open_binary
+
+        mems = {}
+        with open_binary('/proc/meminfo') as f:
+            for line in f:
+                fields = line.split()
+                mems[fields[0]] = int(fields[1]) * 1024
+
+        a = calculate_avail_vmem(mems)
+        if b'MemAvailable:' in mems:
+            b = mems[b'MemAvailable:']
+            diff_percent = abs(a - b) / a * 100
+            self.assertLess(diff_percent, 15)
+
+    def test_avail_old_comes_from_kernel(self):
+        # Make sure "MemAvailable:" coluimn is used instead of relying
+        # on our internal algorithm to calculate avail mem.
+        with mock_open_content(
+            '/proc/meminfo',
+            textwrap.dedent("""\
+                Active:          9444728 kB
+                Active(anon):    6145416 kB
+                Active(file):    2950064 kB
+                Buffers:          287952 kB
+                Cached:          4818144 kB
+                Inactive(file):  1578132 kB
+                Inactive(anon):   574764 kB
+                Inactive(file):  1567648 kB
+                MemAvailable:    6574984 kB
+                MemFree:         2057400 kB
+                MemTotal:       16325648 kB
+                Shmem:            577588 kB
+                SReclaimable:     346648 kB
+                """).encode()) as m:
+            with warnings.catch_warnings(record=True) as ws:
+                ret = psutil.virtual_memory()
+            assert m.called
+            self.assertEqual(ret.available, 6574984 * 1024)
+            w = ws[0]
+            self.assertIn(
+                "inactive memory stats couldn't be determined", str(w.message))
+
+    def test_avail_old_missing_fields(self):
+        # Remove Active(file), Inactive(file) and SReclaimable
+        # from /proc/meminfo and make sure the fallback is used
+        # (free + cached),
+        with mock_open_content(
+            "/proc/meminfo",
+            textwrap.dedent("""\
+                    Active:          9444728 kB
+                    Active(anon):    6145416 kB
+                    Buffers:          287952 kB
+                    Cached:          4818144 kB
+                    Inactive(file):  1578132 kB
+                    Inactive(anon):   574764 kB
+                    MemFree:         2057400 kB
+                    MemTotal:       16325648 kB
+                    Shmem:            577588 kB
+                    """).encode()) as m:
+            with warnings.catch_warnings(record=True) as ws:
+                ret = psutil.virtual_memory()
+            assert m.called
+            self.assertEqual(ret.available, 2057400 * 1024 + 4818144 * 1024)
+            w = ws[0]
+            self.assertIn(
+                "inactive memory stats couldn't be determined", str(w.message))
+
+    def test_avail_old_missing_zoneinfo(self):
+        # Remove /proc/zoneinfo file. Make sure fallback is used
+        # (free + cached).
+        with mock_open_content(
+                "/proc/meminfo",
+                textwrap.dedent("""\
+                    Active:          9444728 kB
+                    Active(anon):    6145416 kB
+                    Active(file):    2950064 kB
+                    Buffers:          287952 kB
+                    Cached:          4818144 kB
+                    Inactive(file):  1578132 kB
+                    Inactive(anon):   574764 kB
+                    Inactive(file):  1567648 kB
+                    MemFree:         2057400 kB
+                    MemTotal:       16325648 kB
+                    Shmem:            577588 kB
+                    SReclaimable:     346648 kB
+                    """).encode()):
+            with mock_open_exception(
+                    "/proc/zoneinfo",
+                    IOError(errno.ENOENT, 'no such file or directory')):
+                with warnings.catch_warnings(record=True) as ws:
+                    ret = psutil.virtual_memory()
+                    self.assertEqual(
+                        ret.available, 2057400 * 1024 + 4818144 * 1024)
+                    w = ws[0]
+                    self.assertIn(
+                        "inactive memory stats couldn't be determined",
+                        str(w.message))
+
+    def test_virtual_memory_mocked(self):
+        # Emulate /proc/meminfo because neither vmstat nor free return slab.
+        def open_mock(name, *args, **kwargs):
+            if name == '/proc/meminfo':
+                return io.BytesIO(textwrap.dedent("""\
+                    MemTotal:              100 kB
+                    MemFree:               2 kB
+                    MemAvailable:          3 kB
+                    Buffers:               4 kB
+                    Cached:                5 kB
+                    SwapCached:            6 kB
+                    Active:                7 kB
+                    Inactive:              8 kB
+                    Active(anon):          9 kB
+                    Inactive(anon):        10 kB
+                    Active(file):          11 kB
+                    Inactive(file):        12 kB
+                    Unevictable:           13 kB
+                    Mlocked:               14 kB
+                    SwapTotal:             15 kB
+                    SwapFree:              16 kB
+                    Dirty:                 17 kB
+                    Writeback:             18 kB
+                    AnonPages:             19 kB
+                    Mapped:                20 kB
+                    Shmem:                 21 kB
+                    Slab:                  22 kB
+                    SReclaimable:          23 kB
+                    SUnreclaim:            24 kB
+                    KernelStack:           25 kB
+                    PageTables:            26 kB
+                    NFS_Unstable:          27 kB
+                    Bounce:                28 kB
+                    WritebackTmp:          29 kB
+                    CommitLimit:           30 kB
+                    Committed_AS:          31 kB
+                    VmallocTotal:          32 kB
+                    VmallocUsed:           33 kB
+                    VmallocChunk:          34 kB
+                    HardwareCorrupted:     35 kB
+                    AnonHugePages:         36 kB
+                    ShmemHugePages:        37 kB
+                    ShmemPmdMapped:        38 kB
+                    CmaTotal:              39 kB
+                    CmaFree:               40 kB
+                    HugePages_Total:       41 kB
+                    HugePages_Free:        42 kB
+                    HugePages_Rsvd:        43 kB
+                    HugePages_Surp:        44 kB
+                    Hugepagesize:          45 kB
+                    DirectMap46k:          46 kB
+                    DirectMap47M:          47 kB
+                    DirectMap48G:          48 kB
+                    """).encode())
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, create=True, side_effect=open_mock) as m:
+            mem = psutil.virtual_memory()
+            assert m.called
+            self.assertEqual(mem.total, 100 * 1024)
+            self.assertEqual(mem.free, 2 * 1024)
+            self.assertEqual(mem.buffers, 4 * 1024)
+            # cached mem also includes reclaimable memory
+            self.assertEqual(mem.cached, (5 + 23) * 1024)
+            self.assertEqual(mem.shared, 21 * 1024)
+            self.assertEqual(mem.active, 7 * 1024)
+            self.assertEqual(mem.inactive, 8 * 1024)
+            self.assertEqual(mem.slab, 22 * 1024)
+            self.assertEqual(mem.available, 3 * 1024)
+
+
+# =====================================================================
+# --- system swap memory
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemSwapMemory(PsutilTestCase):
+
+    @staticmethod
+    def meminfo_has_swap_info():
+        """Return True if /proc/meminfo provides swap metrics."""
+        with open("/proc/meminfo") as f:
+            data = f.read()
+        return 'SwapTotal:' in data and 'SwapFree:' in data
+
+    def test_total(self):
+        free_value = free_swap().total
+        psutil_value = psutil.swap_memory().total
+        return self.assertAlmostEqual(
+            free_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_used(self):
+        free_value = free_swap().used
+        psutil_value = psutil.swap_memory().used
+        return self.assertAlmostEqual(
+            free_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_free(self):
+        free_value = free_swap().free
+        psutil_value = psutil.swap_memory().free
+        return self.assertAlmostEqual(
+            free_value, psutil_value, delta=TOLERANCE_SYS_MEM)
+
+    def test_missing_sin_sout(self):
+        with mock.patch('psutil._common.open', create=True) as m:
+            with warnings.catch_warnings(record=True) as ws:
+                warnings.simplefilter("always")
+                ret = psutil.swap_memory()
+                assert m.called
+                self.assertEqual(len(ws), 1)
+                w = ws[0]
+                assert w.filename.endswith('psutil/_pslinux.py')
+                self.assertIn(
+                    "'sin' and 'sout' swap memory stats couldn't "
+                    "be determined", str(w.message))
+                self.assertEqual(ret.sin, 0)
+                self.assertEqual(ret.sout, 0)
+
+    def test_no_vmstat_mocked(self):
+        # see https://github.com/giampaolo/psutil/issues/722
+        with mock_open_exception(
+                "/proc/vmstat",
+                IOError(errno.ENOENT, 'no such file or directory')) as m:
+            with warnings.catch_warnings(record=True) as ws:
+                warnings.simplefilter("always")
+                ret = psutil.swap_memory()
+                assert m.called
+                self.assertEqual(len(ws), 1)
+                w = ws[0]
+                assert w.filename.endswith('psutil/_pslinux.py')
+                self.assertIn(
+                    "'sin' and 'sout' swap memory stats couldn't "
+                    "be determined and were set to 0",
+                    str(w.message))
+                self.assertEqual(ret.sin, 0)
+                self.assertEqual(ret.sout, 0)
+
+    def test_meminfo_against_sysinfo(self):
+        # Make sure the content of /proc/meminfo about swap memory
+        # matches sysinfo() syscall, see:
+        # https://github.com/giampaolo/psutil/issues/1015
+        if not self.meminfo_has_swap_info():
+            return unittest.skip("/proc/meminfo has no swap metrics")
+        with mock.patch('psutil._pslinux.cext.linux_sysinfo') as m:
+            swap = psutil.swap_memory()
+        assert not m.called
+        import psutil._psutil_linux as cext
+        _, _, _, _, total, free, unit_multiplier = cext.linux_sysinfo()
+        total *= unit_multiplier
+        free *= unit_multiplier
+        self.assertEqual(swap.total, total)
+        self.assertAlmostEqual(swap.free, free, delta=TOLERANCE_SYS_MEM)
+
+    def test_emulate_meminfo_has_no_metrics(self):
+        # Emulate a case where /proc/meminfo provides no swap metrics
+        # in which case sysinfo() syscall is supposed to be used
+        # as a fallback.
+        with mock_open_content("/proc/meminfo", b"") as m:
+            psutil.swap_memory()
+            assert m.called
+
+
+# =====================================================================
+# --- system CPU
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemCPUTimes(PsutilTestCase):
+
+    @unittest.skipIf(TRAVIS, "unknown failure on travis")
+    def test_fields(self):
+        fields = psutil.cpu_times()._fields
+        kernel_ver = re.findall(r'\d+\.\d+\.\d+', os.uname()[2])[0]
+        kernel_ver_info = tuple(map(int, kernel_ver.split('.')))
+        if kernel_ver_info >= (2, 6, 11):
+            self.assertIn('steal', fields)
+        else:
+            self.assertNotIn('steal', fields)
+        if kernel_ver_info >= (2, 6, 24):
+            self.assertIn('guest', fields)
+        else:
+            self.assertNotIn('guest', fields)
+        if kernel_ver_info >= (3, 2, 0):
+            self.assertIn('guest_nice', fields)
+        else:
+            self.assertNotIn('guest_nice', fields)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemCPUCountLogical(PsutilTestCase):
+
+    @unittest.skipIf(not os.path.exists("/sys/devices/system/cpu/online"),
+                     "/sys/devices/system/cpu/online does not exist")
+    def test_against_sysdev_cpu_online(self):
+        with open("/sys/devices/system/cpu/online") as f:
+            value = f.read().strip()
+        if "-" in str(value):
+            value = int(value.split('-')[1]) + 1
+            self.assertEqual(psutil.cpu_count(), value)
+
+    @unittest.skipIf(not os.path.exists("/sys/devices/system/cpu"),
+                     "/sys/devices/system/cpu does not exist")
+    def test_against_sysdev_cpu_num(self):
+        ls = os.listdir("/sys/devices/system/cpu")
+        count = len([x for x in ls if re.search(r"cpu\d+$", x) is not None])
+        self.assertEqual(psutil.cpu_count(), count)
+
+    @unittest.skipIf(not which("nproc"), "nproc utility not available")
+    def test_against_nproc(self):
+        num = int(sh("nproc --all"))
+        self.assertEqual(psutil.cpu_count(logical=True), num)
+
+    @unittest.skipIf(not which("lscpu"), "lscpu utility not available")
+    def test_against_lscpu(self):
+        out = sh("lscpu -p")
+        num = len([x for x in out.split('\n') if not x.startswith('#')])
+        self.assertEqual(psutil.cpu_count(logical=True), num)
+
+    def test_emulate_fallbacks(self):
+        import psutil._pslinux
+        original = psutil._pslinux.cpu_count_logical()
+        # Here we want to mock os.sysconf("SC_NPROCESSORS_ONLN") in
+        # order to cause the parsing of /proc/cpuinfo and /proc/stat.
+        with mock.patch(
+                'psutil._pslinux.os.sysconf', side_effect=ValueError) as m:
+            self.assertEqual(psutil._pslinux.cpu_count_logical(), original)
+            assert m.called
+
+            # Let's have open() return emtpy data and make sure None is
+            # returned ('cause we mimick os.cpu_count()).
+            with mock.patch('psutil._common.open', create=True) as m:
+                self.assertIsNone(psutil._pslinux.cpu_count_logical())
+                self.assertEqual(m.call_count, 2)
+                # /proc/stat should be the last one
+                self.assertEqual(m.call_args[0][0], '/proc/stat')
+
+            # Let's push this a bit further and make sure /proc/cpuinfo
+            # parsing works as expected.
+            with open('/proc/cpuinfo', 'rb') as f:
+                cpuinfo_data = f.read()
+            fake_file = io.BytesIO(cpuinfo_data)
+            with mock.patch('psutil._common.open',
+                            return_value=fake_file, create=True) as m:
+                self.assertEqual(psutil._pslinux.cpu_count_logical(), original)
+
+            # Finally, let's make /proc/cpuinfo return meaningless data;
+            # this way we'll fall back on relying on /proc/stat
+            with mock_open_content('/proc/cpuinfo', b"") as m:
+                self.assertEqual(psutil._pslinux.cpu_count_logical(), original)
+                m.called
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemCPUCountPhysical(PsutilTestCase):
+
+    @unittest.skipIf(not which("lscpu"), "lscpu utility not available")
+    def test_against_lscpu(self):
+        out = sh("lscpu -p")
+        core_ids = set()
+        for line in out.split('\n'):
+            if not line.startswith('#'):
+                fields = line.split(',')
+                core_ids.add(fields[1])
+        self.assertEqual(psutil.cpu_count(logical=False), len(core_ids))
+
+    def test_method_2(self):
+        meth_1 = psutil._pslinux.cpu_count_physical()
+        with mock.patch('glob.glob', return_value=[]) as m:
+            meth_2 = psutil._pslinux.cpu_count_physical()
+            assert m.called
+        if meth_1 is not None:
+            self.assertEqual(meth_1, meth_2)
+
+    def test_emulate_none(self):
+        with mock.patch('glob.glob', return_value=[]) as m1:
+            with mock.patch('psutil._common.open', create=True) as m2:
+                self.assertIsNone(psutil._pslinux.cpu_count_physical())
+        assert m1.called
+        assert m2.called
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemCPUFrequency(PsutilTestCase):
+
+    @unittest.skipIf(TRAVIS, "fails on Travis")
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_emulate_use_second_file(self):
+        # https://github.com/giampaolo/psutil/issues/981
+        def path_exists_mock(path):
+            if path.startswith("/sys/devices/system/cpu/cpufreq/policy"):
+                return False
+            else:
+                return orig_exists(path)
+
+        orig_exists = os.path.exists
+        with mock.patch("os.path.exists", side_effect=path_exists_mock,
+                        create=True):
+            assert psutil.cpu_freq()
+
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_emulate_use_cpuinfo(self):
+        # Emulate a case where /sys/devices/system/cpu/cpufreq* does not
+        # exist and /proc/cpuinfo is used instead.
+        def path_exists_mock(path):
+            if path.startswith('/sys/devices/system/cpu/'):
+                return False
+            else:
+                if path == "/proc/cpuinfo":
+                    flags.append(None)
+                return os_path_exists(path)
+
+        flags = []
+        os_path_exists = os.path.exists
+        try:
+            with mock.patch("os.path.exists", side_effect=path_exists_mock):
+                reload_module(psutil._pslinux)
+                ret = psutil.cpu_freq()
+                assert ret
+                assert flags
+                self.assertEqual(ret.max, 0.0)
+                self.assertEqual(ret.min, 0.0)
+                for freq in psutil.cpu_freq(percpu=True):
+                    self.assertEqual(ret.max, 0.0)
+                    self.assertEqual(ret.min, 0.0)
+        finally:
+            reload_module(psutil._pslinux)
+            reload_module(psutil)
+
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_emulate_data(self):
+        def open_mock(name, *args, **kwargs):
+            if (name.endswith('/scaling_cur_freq') and
+                    name.startswith("/sys/devices/system/cpu/cpufreq/policy")):
+                return io.BytesIO(b"500000")
+            elif (name.endswith('/scaling_min_freq') and
+                    name.startswith("/sys/devices/system/cpu/cpufreq/policy")):
+                return io.BytesIO(b"600000")
+            elif (name.endswith('/scaling_max_freq') and
+                    name.startswith("/sys/devices/system/cpu/cpufreq/policy")):
+                return io.BytesIO(b"700000")
+            elif name == '/proc/cpuinfo':
+                return io.BytesIO(b"cpu MHz		: 500")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            with mock.patch(
+                    'os.path.exists', return_value=True):
+                freq = psutil.cpu_freq()
+                self.assertEqual(freq.current, 500.0)
+                # when /proc/cpuinfo is used min and max frequencies are not
+                # available and are set to 0.
+                if freq.min != 0.0:
+                    self.assertEqual(freq.min, 600.0)
+                if freq.max != 0.0:
+                    self.assertEqual(freq.max, 700.0)
+
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_emulate_multi_cpu(self):
+        def open_mock(name, *args, **kwargs):
+            n = name
+            if (n.endswith('/scaling_cur_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy0")):
+                return io.BytesIO(b"100000")
+            elif (n.endswith('/scaling_min_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy0")):
+                return io.BytesIO(b"200000")
+            elif (n.endswith('/scaling_max_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy0")):
+                return io.BytesIO(b"300000")
+            elif (n.endswith('/scaling_cur_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy1")):
+                return io.BytesIO(b"400000")
+            elif (n.endswith('/scaling_min_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy1")):
+                return io.BytesIO(b"500000")
+            elif (n.endswith('/scaling_max_freq') and
+                    n.startswith("/sys/devices/system/cpu/cpufreq/policy1")):
+                return io.BytesIO(b"600000")
+            elif name == '/proc/cpuinfo':
+                return io.BytesIO(b"cpu MHz		: 100\n"
+                                  b"cpu MHz		: 400")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            with mock.patch('os.path.exists', return_value=True):
+                with mock.patch('psutil._pslinux.cpu_count_logical',
+                                return_value=2):
+                    freq = psutil.cpu_freq(percpu=True)
+                    self.assertEqual(freq[0].current, 100.0)
+                    if freq[0].min != 0.0:
+                        self.assertEqual(freq[0].min, 200.0)
+                    if freq[0].max != 0.0:
+                        self.assertEqual(freq[0].max, 300.0)
+                    self.assertEqual(freq[1].current, 400.0)
+                    if freq[1].min != 0.0:
+                        self.assertEqual(freq[1].min, 500.0)
+                    if freq[1].max != 0.0:
+                        self.assertEqual(freq[1].max, 600.0)
+
+    @unittest.skipIf(TRAVIS, "fails on Travis")
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_emulate_no_scaling_cur_freq_file(self):
+        # See: https://github.com/giampaolo/psutil/issues/1071
+        def open_mock(name, *args, **kwargs):
+            if name.endswith('/scaling_cur_freq'):
+                raise IOError(errno.ENOENT, "")
+            elif name.endswith('/cpuinfo_cur_freq'):
+                return io.BytesIO(b"200000")
+            elif name == '/proc/cpuinfo':
+                return io.BytesIO(b"cpu MHz		: 200")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            with mock.patch('os.path.exists', return_value=True):
+                with mock.patch('psutil._pslinux.cpu_count_logical',
+                                return_value=1):
+                    freq = psutil.cpu_freq()
+                    self.assertEqual(freq.current, 200)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemCPUStats(PsutilTestCase):
+
+    @unittest.skipIf(TRAVIS, "fails on Travis")
+    def test_ctx_switches(self):
+        vmstat_value = vmstat("context switches")
+        psutil_value = psutil.cpu_stats().ctx_switches
+        self.assertAlmostEqual(vmstat_value, psutil_value, delta=500)
+
+    @unittest.skipIf(TRAVIS, "fails on Travis")
+    def test_interrupts(self):
+        vmstat_value = vmstat("interrupts")
+        psutil_value = psutil.cpu_stats().interrupts
+        self.assertAlmostEqual(vmstat_value, psutil_value, delta=500)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestLoadAvg(PsutilTestCase):
+
+    @unittest.skipIf(not HAS_GETLOADAVG, "not supported")
+    def test_getloadavg(self):
+        psutil_value = psutil.getloadavg()
+        with open("/proc/loadavg", "r") as f:
+            proc_value = f.read().split()
+
+        self.assertAlmostEqual(float(proc_value[0]), psutil_value[0], delta=1)
+        self.assertAlmostEqual(float(proc_value[1]), psutil_value[1], delta=1)
+        self.assertAlmostEqual(float(proc_value[2]), psutil_value[2], delta=1)
+
+
+# =====================================================================
+# --- system network
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemNetIfAddrs(PsutilTestCase):
+
+    def test_ips(self):
+        for name, addrs in psutil.net_if_addrs().items():
+            for addr in addrs:
+                if addr.family == psutil.AF_LINK:
+                    self.assertEqual(addr.address, get_mac_address(name))
+                elif addr.family == socket.AF_INET:
+                    self.assertEqual(addr.address, get_ipv4_address(name))
+                    self.assertEqual(addr.netmask, get_ipv4_netmask(name))
+                    if addr.broadcast is not None:
+                        self.assertEqual(addr.broadcast,
+                                         get_ipv4_broadcast(name))
+                    else:
+                        self.assertEqual(get_ipv4_broadcast(name), '0.0.0.0')
+                elif addr.family == socket.AF_INET6:
+                    # IPv6 addresses can have a percent symbol at the end.
+                    # E.g. these 2 are equivalent:
+                    # "fe80::1ff:fe23:4567:890a"
+                    # "fe80::1ff:fe23:4567:890a%eth0"
+                    # That is the "zone id" portion, which usually is the name
+                    # of the network interface.
+                    address = addr.address.split('%')[0]
+                    self.assertEqual(address, get_ipv6_address(name))
+
+    # XXX - not reliable when having virtual NICs installed by Docker.
+    # @unittest.skipIf(not which('ip'), "'ip' utility not available")
+    # @unittest.skipIf(TRAVIS, "skipped on Travis")
+    # def test_net_if_names(self):
+    #     out = sh("ip addr").strip()
+    #     nics = [x for x in psutil.net_if_addrs().keys() if ':' not in x]
+    #     found = 0
+    #     for line in out.split('\n'):
+    #         line = line.strip()
+    #         if re.search(r"^\d+:", line):
+    #             found += 1
+    #             name = line.split(':')[1].strip()
+    #             self.assertIn(name, nics)
+    #     self.assertEqual(len(nics), found, msg="%s\n---\n%s" % (
+    #         pprint.pformat(nics), out))
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemNetIfStats(PsutilTestCase):
+
+    def test_against_ifconfig(self):
+        for name, stats in psutil.net_if_stats().items():
+            try:
+                out = sh("ifconfig %s" % name)
+            except RuntimeError:
+                pass
+            else:
+                self.assertEqual(stats.isup, 'RUNNING' in out, msg=out)
+                self.assertEqual(stats.mtu,
+                                 int(re.findall(r'(?i)MTU[: ](\d+)', out)[0]))
+
+    def test_mtu(self):
+        for name, stats in psutil.net_if_stats().items():
+            with open("/sys/class/net/%s/mtu" % name, "rt") as f:
+                self.assertEqual(stats.mtu, int(f.read().strip()))
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemNetIOCounters(PsutilTestCase):
+
+    @retry_on_failure()
+    def test_against_ifconfig(self):
+        def ifconfig(nic):
+            ret = {}
+            out = sh("ifconfig %s" % name)
+            ret['packets_recv'] = int(
+                re.findall(r'RX packets[: ](\d+)', out)[0])
+            ret['packets_sent'] = int(
+                re.findall(r'TX packets[: ](\d+)', out)[0])
+            ret['errin'] = int(re.findall(r'errors[: ](\d+)', out)[0])
+            ret['errout'] = int(re.findall(r'errors[: ](\d+)', out)[1])
+            ret['dropin'] = int(re.findall(r'dropped[: ](\d+)', out)[0])
+            ret['dropout'] = int(re.findall(r'dropped[: ](\d+)', out)[1])
+            ret['bytes_recv'] = int(
+                re.findall(r'RX (?:packets \d+ +)?bytes[: ](\d+)', out)[0])
+            ret['bytes_sent'] = int(
+                re.findall(r'TX (?:packets \d+ +)?bytes[: ](\d+)', out)[0])
+            return ret
+
+        nio = psutil.net_io_counters(pernic=True, nowrap=False)
+        for name, stats in nio.items():
+            try:
+                ifconfig_ret = ifconfig(name)
+            except RuntimeError:
+                continue
+            self.assertAlmostEqual(
+                stats.bytes_recv, ifconfig_ret['bytes_recv'], delta=1024 * 5)
+            self.assertAlmostEqual(
+                stats.bytes_sent, ifconfig_ret['bytes_sent'], delta=1024 * 5)
+            self.assertAlmostEqual(
+                stats.packets_recv, ifconfig_ret['packets_recv'], delta=1024)
+            self.assertAlmostEqual(
+                stats.packets_sent, ifconfig_ret['packets_sent'], delta=1024)
+            self.assertAlmostEqual(
+                stats.errin, ifconfig_ret['errin'], delta=10)
+            self.assertAlmostEqual(
+                stats.errout, ifconfig_ret['errout'], delta=10)
+            self.assertAlmostEqual(
+                stats.dropin, ifconfig_ret['dropin'], delta=10)
+            self.assertAlmostEqual(
+                stats.dropout, ifconfig_ret['dropout'], delta=10)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemNetConnections(PsutilTestCase):
+
+    @mock.patch('psutil._pslinux.socket.inet_ntop', side_effect=ValueError)
+    @mock.patch('psutil._pslinux.supports_ipv6', return_value=False)
+    def test_emulate_ipv6_unsupported(self, supports_ipv6, inet_ntop):
+        # see: https://github.com/giampaolo/psutil/issues/623
+        try:
+            s = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
+            self.addCleanup(s.close)
+            s.bind(("::1", 0))
+        except socket.error:
+            pass
+        psutil.net_connections(kind='inet6')
+
+    def test_emulate_unix(self):
+        with mock_open_content(
+            '/proc/net/unix',
+            textwrap.dedent("""\
+                0: 00000003 000 000 0001 03 462170 @/tmp/dbus-Qw2hMPIU3n
+                0: 00000003 000 000 0001 03 35010 @/tmp/dbus-tB2X8h69BQ
+                0: 00000003 000 000 0001 03 34424 @/tmp/dbus-cHy80Y8O
+                000000000000000000000000000000000000000000000000000000
+                """)) as m:
+            psutil.net_connections(kind='unix')
+            assert m.called
+
+
+# =====================================================================
+# --- system disks
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemDiskPartitions(PsutilTestCase):
+
+    @unittest.skipIf(not hasattr(os, 'statvfs'), "os.statvfs() not available")
+    @skip_on_not_implemented()
+    def test_against_df(self):
+        # test psutil.disk_usage() and psutil.disk_partitions()
+        # against "df -a"
+        def df(path):
+            out = sh('df -P -B 1 "%s"' % path).strip()
+            lines = out.split('\n')
+            lines.pop(0)
+            line = lines.pop(0)
+            dev, total, used, free = line.split()[:4]
+            if dev == 'none':
+                dev = ''
+            total, used, free = int(total), int(used), int(free)
+            return dev, total, used, free
+
+        for part in psutil.disk_partitions(all=False):
+            usage = psutil.disk_usage(part.mountpoint)
+            dev, total, used, free = df(part.mountpoint)
+            self.assertEqual(usage.total, total)
+            self.assertAlmostEqual(usage.free, free,
+                                   delta=TOLERANCE_DISK_USAGE)
+            self.assertAlmostEqual(usage.used, used,
+                                   delta=TOLERANCE_DISK_USAGE)
+
+    def test_zfs_fs(self):
+        # Test that ZFS partitions are returned.
+        with open("/proc/filesystems", "r") as f:
+            data = f.read()
+        if 'zfs' in data:
+            for part in psutil.disk_partitions():
+                if part.fstype == 'zfs':
+                    break
+            else:
+                self.fail("couldn't find any ZFS partition")
+        else:
+            # No ZFS partitions on this system. Let's fake one.
+            fake_file = io.StringIO(u("nodev\tzfs\n"))
+            with mock.patch('psutil._common.open',
+                            return_value=fake_file, create=True) as m1:
+                with mock.patch(
+                        'psutil._pslinux.cext.disk_partitions',
+                        return_value=[('/dev/sdb3', '/', 'zfs', 'rw')]) as m2:
+                    ret = psutil.disk_partitions()
+                    assert m1.called
+                    assert m2.called
+                    assert ret
+                    self.assertEqual(ret[0].fstype, 'zfs')
+
+    def test_emulate_realpath_fail(self):
+        # See: https://github.com/giampaolo/psutil/issues/1307
+        try:
+            with mock.patch('os.path.realpath',
+                            return_value='/non/existent') as m:
+                with self.assertRaises(FileNotFoundError):
+                    psutil.disk_partitions()
+                assert m.called
+        finally:
+            psutil.PROCFS_PATH = "/proc"
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSystemDiskIoCounters(PsutilTestCase):
+
+    def test_emulate_kernel_2_4(self):
+        # Tests /proc/diskstats parsing format for 2.4 kernels, see:
+        # https://github.com/giampaolo/psutil/issues/767
+        with mock_open_content(
+                '/proc/diskstats',
+                "   3     0   1 hda 2 3 4 5 6 7 8 9 10 11 12"):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            return_value=True):
+                ret = psutil.disk_io_counters(nowrap=False)
+                self.assertEqual(ret.read_count, 1)
+                self.assertEqual(ret.read_merged_count, 2)
+                self.assertEqual(ret.read_bytes, 3 * SECTOR_SIZE)
+                self.assertEqual(ret.read_time, 4)
+                self.assertEqual(ret.write_count, 5)
+                self.assertEqual(ret.write_merged_count, 6)
+                self.assertEqual(ret.write_bytes, 7 * SECTOR_SIZE)
+                self.assertEqual(ret.write_time, 8)
+                self.assertEqual(ret.busy_time, 10)
+
+    def test_emulate_kernel_2_6_full(self):
+        # Tests /proc/diskstats parsing format for 2.6 kernels,
+        # lines reporting all metrics:
+        # https://github.com/giampaolo/psutil/issues/767
+        with mock_open_content(
+                '/proc/diskstats',
+                "   3    0   hda 1 2 3 4 5 6 7 8 9 10 11"):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            return_value=True):
+                ret = psutil.disk_io_counters(nowrap=False)
+                self.assertEqual(ret.read_count, 1)
+                self.assertEqual(ret.read_merged_count, 2)
+                self.assertEqual(ret.read_bytes, 3 * SECTOR_SIZE)
+                self.assertEqual(ret.read_time, 4)
+                self.assertEqual(ret.write_count, 5)
+                self.assertEqual(ret.write_merged_count, 6)
+                self.assertEqual(ret.write_bytes, 7 * SECTOR_SIZE)
+                self.assertEqual(ret.write_time, 8)
+                self.assertEqual(ret.busy_time, 10)
+
+    def test_emulate_kernel_2_6_limited(self):
+        # Tests /proc/diskstats parsing format for 2.6 kernels,
+        # where one line of /proc/partitions return a limited
+        # amount of metrics when it bumps into a partition
+        # (instead of a disk). See:
+        # https://github.com/giampaolo/psutil/issues/767
+        with mock_open_content(
+                '/proc/diskstats',
+                "   3    1   hda 1 2 3 4"):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            return_value=True):
+                ret = psutil.disk_io_counters(nowrap=False)
+                self.assertEqual(ret.read_count, 1)
+                self.assertEqual(ret.read_bytes, 2 * SECTOR_SIZE)
+                self.assertEqual(ret.write_count, 3)
+                self.assertEqual(ret.write_bytes, 4 * SECTOR_SIZE)
+
+                self.assertEqual(ret.read_merged_count, 0)
+                self.assertEqual(ret.read_time, 0)
+                self.assertEqual(ret.write_merged_count, 0)
+                self.assertEqual(ret.write_time, 0)
+                self.assertEqual(ret.busy_time, 0)
+
+    def test_emulate_include_partitions(self):
+        # Make sure that when perdisk=True disk partitions are returned,
+        # see:
+        # https://github.com/giampaolo/psutil/pull/1313#issuecomment-408626842
+        with mock_open_content(
+                '/proc/diskstats',
+                textwrap.dedent("""\
+                    3    0   nvme0n1 1 2 3 4 5 6 7 8 9 10 11
+                    3    0   nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
+                    """)):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            return_value=False):
+                ret = psutil.disk_io_counters(perdisk=True, nowrap=False)
+                self.assertEqual(len(ret), 2)
+                self.assertEqual(ret['nvme0n1'].read_count, 1)
+                self.assertEqual(ret['nvme0n1p1'].read_count, 1)
+                self.assertEqual(ret['nvme0n1'].write_count, 5)
+                self.assertEqual(ret['nvme0n1p1'].write_count, 5)
+
+    def test_emulate_exclude_partitions(self):
+        # Make sure that when perdisk=False partitions (e.g. 'sda1',
+        # 'nvme0n1p1') are skipped and not included in the total count.
+        # https://github.com/giampaolo/psutil/pull/1313#issuecomment-408626842
+        with mock_open_content(
+                '/proc/diskstats',
+                textwrap.dedent("""\
+                    3    0   nvme0n1 1 2 3 4 5 6 7 8 9 10 11
+                    3    0   nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
+                    """)):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            return_value=False):
+                ret = psutil.disk_io_counters(perdisk=False, nowrap=False)
+                self.assertIsNone(ret)
+
+        #
+        def is_storage_device(name):
+            return name == 'nvme0n1'
+
+        with mock_open_content(
+                '/proc/diskstats',
+                textwrap.dedent("""\
+                    3    0   nvme0n1 1 2 3 4 5 6 7 8 9 10 11
+                    3    0   nvme0n1p1 1 2 3 4 5 6 7 8 9 10 11
+                    """)):
+            with mock.patch('psutil._pslinux.is_storage_device',
+                            create=True, side_effect=is_storage_device):
+                ret = psutil.disk_io_counters(perdisk=False, nowrap=False)
+                self.assertEqual(ret.read_count, 1)
+                self.assertEqual(ret.write_count, 5)
+
+    def test_emulate_use_sysfs(self):
+        def exists(path):
+            if path == '/proc/diskstats':
+                return False
+            return True
+
+        wprocfs = psutil.disk_io_counters(perdisk=True)
+        with mock.patch('psutil._pslinux.os.path.exists',
+                        create=True, side_effect=exists):
+            wsysfs = psutil.disk_io_counters(perdisk=True)
+        self.assertEqual(len(wprocfs), len(wsysfs))
+
+    def test_emulate_not_impl(self):
+        def exists(path):
+            return False
+
+        with mock.patch('psutil._pslinux.os.path.exists',
+                        create=True, side_effect=exists):
+            self.assertRaises(NotImplementedError, psutil.disk_io_counters)
+
+
+# =====================================================================
+# --- misc
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestMisc(PsutilTestCase):
+
+    def test_boot_time(self):
+        vmstat_value = vmstat('boot time')
+        psutil_value = psutil.boot_time()
+        self.assertEqual(int(vmstat_value), int(psutil_value))
+
+    def test_no_procfs_on_import(self):
+        my_procfs = self.get_testfn()
+        os.mkdir(my_procfs)
+
+        with open(os.path.join(my_procfs, 'stat'), 'w') as f:
+            f.write('cpu   0 0 0 0 0 0 0 0 0 0\n')
+            f.write('cpu0  0 0 0 0 0 0 0 0 0 0\n')
+            f.write('cpu1  0 0 0 0 0 0 0 0 0 0\n')
+
+        try:
+            orig_open = open
+
+            def open_mock(name, *args, **kwargs):
+                if name.startswith('/proc'):
+                    raise IOError(errno.ENOENT, 'rejecting access for test')
+                return orig_open(name, *args, **kwargs)
+
+            patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+            with mock.patch(patch_point, side_effect=open_mock):
+                reload_module(psutil)
+
+                self.assertRaises(IOError, psutil.cpu_times)
+                self.assertRaises(IOError, psutil.cpu_times, percpu=True)
+                self.assertRaises(IOError, psutil.cpu_percent)
+                self.assertRaises(IOError, psutil.cpu_percent, percpu=True)
+                self.assertRaises(IOError, psutil.cpu_times_percent)
+                self.assertRaises(
+                    IOError, psutil.cpu_times_percent, percpu=True)
+
+                psutil.PROCFS_PATH = my_procfs
+
+                self.assertEqual(psutil.cpu_percent(), 0)
+                self.assertEqual(sum(psutil.cpu_times_percent()), 0)
+
+                # since we don't know the number of CPUs at import time,
+                # we awkwardly say there are none until the second call
+                per_cpu_percent = psutil.cpu_percent(percpu=True)
+                self.assertEqual(sum(per_cpu_percent), 0)
+
+                # ditto awkward length
+                per_cpu_times_percent = psutil.cpu_times_percent(percpu=True)
+                self.assertEqual(sum(map(sum, per_cpu_times_percent)), 0)
+
+                # much user, very busy
+                with open(os.path.join(my_procfs, 'stat'), 'w') as f:
+                    f.write('cpu   1 0 0 0 0 0 0 0 0 0\n')
+                    f.write('cpu0  1 0 0 0 0 0 0 0 0 0\n')
+                    f.write('cpu1  1 0 0 0 0 0 0 0 0 0\n')
+
+                self.assertNotEqual(psutil.cpu_percent(), 0)
+                self.assertNotEqual(
+                    sum(psutil.cpu_percent(percpu=True)), 0)
+                self.assertNotEqual(sum(psutil.cpu_times_percent()), 0)
+                self.assertNotEqual(
+                    sum(map(sum, psutil.cpu_times_percent(percpu=True))), 0)
+        finally:
+            shutil.rmtree(my_procfs)
+            reload_module(psutil)
+
+        self.assertEqual(psutil.PROCFS_PATH, '/proc')
+
+    def test_cpu_steal_decrease(self):
+        # Test cumulative cpu stats decrease. We should ignore this.
+        # See issue #1210.
+        with mock_open_content(
+            "/proc/stat",
+            textwrap.dedent("""\
+                cpu   0 0 0 0 0 0 0 1 0 0
+                cpu0  0 0 0 0 0 0 0 1 0 0
+                cpu1  0 0 0 0 0 0 0 1 0 0
+                """).encode()) as m:
+            # first call to "percent" functions should read the new stat file
+            # and compare to the "real" file read at import time - so the
+            # values are meaningless
+            psutil.cpu_percent()
+            assert m.called
+            psutil.cpu_percent(percpu=True)
+            psutil.cpu_times_percent()
+            psutil.cpu_times_percent(percpu=True)
+
+        with mock_open_content(
+            "/proc/stat",
+            textwrap.dedent("""\
+                cpu   1 0 0 0 0 0 0 0 0 0
+                cpu0  1 0 0 0 0 0 0 0 0 0
+                cpu1  1 0 0 0 0 0 0 0 0 0
+                """).encode()) as m:
+            # Increase "user" while steal goes "backwards" to zero.
+            cpu_percent = psutil.cpu_percent()
+            assert m.called
+            cpu_percent_percpu = psutil.cpu_percent(percpu=True)
+            cpu_times_percent = psutil.cpu_times_percent()
+            cpu_times_percent_percpu = psutil.cpu_times_percent(percpu=True)
+            self.assertNotEqual(cpu_percent, 0)
+            self.assertNotEqual(sum(cpu_percent_percpu), 0)
+            self.assertNotEqual(sum(cpu_times_percent), 0)
+            self.assertNotEqual(sum(cpu_times_percent), 100.0)
+            self.assertNotEqual(sum(map(sum, cpu_times_percent_percpu)), 0)
+            self.assertNotEqual(sum(map(sum, cpu_times_percent_percpu)), 100.0)
+            self.assertEqual(cpu_times_percent.steal, 0)
+            self.assertNotEqual(cpu_times_percent.user, 0)
+
+    def test_boot_time_mocked(self):
+        with mock.patch('psutil._common.open', create=True) as m:
+            self.assertRaises(
+                RuntimeError,
+                psutil._pslinux.boot_time)
+            assert m.called
+
+    def test_users_mocked(self):
+        # Make sure ':0' and ':0.0' (returned by C ext) are converted
+        # to 'localhost'.
+        with mock.patch('psutil._pslinux.cext.users',
+                        return_value=[('giampaolo', 'pts/2', ':0',
+                                       1436573184.0, True, 2)]) as m:
+            self.assertEqual(psutil.users()[0].host, 'localhost')
+            assert m.called
+        with mock.patch('psutil._pslinux.cext.users',
+                        return_value=[('giampaolo', 'pts/2', ':0.0',
+                                       1436573184.0, True, 2)]) as m:
+            self.assertEqual(psutil.users()[0].host, 'localhost')
+            assert m.called
+        # ...otherwise it should be returned as-is
+        with mock.patch('psutil._pslinux.cext.users',
+                        return_value=[('giampaolo', 'pts/2', 'foo',
+                                       1436573184.0, True, 2)]) as m:
+            self.assertEqual(psutil.users()[0].host, 'foo')
+            assert m.called
+
+    def test_procfs_path(self):
+        tdir = self.get_testfn()
+        os.mkdir(tdir)
+        try:
+            psutil.PROCFS_PATH = tdir
+            self.assertRaises(IOError, psutil.virtual_memory)
+            self.assertRaises(IOError, psutil.cpu_times)
+            self.assertRaises(IOError, psutil.cpu_times, percpu=True)
+            self.assertRaises(IOError, psutil.boot_time)
+            # self.assertRaises(IOError, psutil.pids)
+            self.assertRaises(IOError, psutil.net_connections)
+            self.assertRaises(IOError, psutil.net_io_counters)
+            self.assertRaises(IOError, psutil.net_if_stats)
+            # self.assertRaises(IOError, psutil.disk_io_counters)
+            self.assertRaises(IOError, psutil.disk_partitions)
+            self.assertRaises(psutil.NoSuchProcess, psutil.Process)
+        finally:
+            psutil.PROCFS_PATH = "/proc"
+
+    @retry_on_failure()
+    def test_issue_687(self):
+        # In case of thread ID:
+        # - pid_exists() is supposed to return False
+        # - Process(tid) is supposed to work
+        # - pids() should not return the TID
+        # See: https://github.com/giampaolo/psutil/issues/687
+        t = ThreadTask()
+        t.start()
+        try:
+            p = psutil.Process()
+            threads = p.threads()
+            self.assertEqual(len(threads), 2)
+            tid = sorted(threads, key=lambda x: x.id)[1].id
+            self.assertNotEqual(p.pid, tid)
+            pt = psutil.Process(tid)
+            pt.as_dict()
+            self.assertNotIn(tid, psutil.pids())
+        finally:
+            t.stop()
+
+    def test_pid_exists_no_proc_status(self):
+        # Internally pid_exists relies on /proc/{pid}/status.
+        # Emulate a case where this file is empty in which case
+        # psutil is supposed to fall back on using pids().
+        with mock_open_content("/proc/%s/status", "") as m:
+            assert psutil.pid_exists(os.getpid())
+            assert m.called
+
+
+# =====================================================================
+# --- sensors
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+@unittest.skipIf(not HAS_BATTERY, "no battery")
+class TestSensorsBattery(PsutilTestCase):
+
+    @unittest.skipIf(not which("acpi"), "acpi utility not available")
+    def test_percent(self):
+        out = sh("acpi -b")
+        acpi_value = int(out.split(",")[1].strip().replace('%', ''))
+        psutil_value = psutil.sensors_battery().percent
+        self.assertAlmostEqual(acpi_value, psutil_value, delta=1)
+
+    def test_emulate_power_plugged(self):
+        # Pretend the AC power cable is connected.
+        def open_mock(name, *args, **kwargs):
+            if name.endswith("AC0/online") or name.endswith("AC/online"):
+                return io.BytesIO(b"1")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            self.assertEqual(psutil.sensors_battery().power_plugged, True)
+            self.assertEqual(
+                psutil.sensors_battery().secsleft, psutil.POWER_TIME_UNLIMITED)
+            assert m.called
+
+    def test_emulate_power_plugged_2(self):
+        # Same as above but pretend /AC0/online does not exist in which
+        # case code relies on /status file.
+        def open_mock(name, *args, **kwargs):
+            if name.endswith("AC0/online") or name.endswith("AC/online"):
+                raise IOError(errno.ENOENT, "")
+            elif name.endswith("/status"):
+                return io.StringIO(u("charging"))
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            self.assertEqual(psutil.sensors_battery().power_plugged, True)
+            assert m.called
+
+    def test_emulate_power_not_plugged(self):
+        # Pretend the AC power cable is not connected.
+        def open_mock(name, *args, **kwargs):
+            if name.endswith("AC0/online") or name.endswith("AC/online"):
+                return io.BytesIO(b"0")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            self.assertEqual(psutil.sensors_battery().power_plugged, False)
+            assert m.called
+
+    def test_emulate_power_not_plugged_2(self):
+        # Same as above but pretend /AC0/online does not exist in which
+        # case code relies on /status file.
+        def open_mock(name, *args, **kwargs):
+            if name.endswith("AC0/online") or name.endswith("AC/online"):
+                raise IOError(errno.ENOENT, "")
+            elif name.endswith("/status"):
+                return io.StringIO(u("discharging"))
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            self.assertEqual(psutil.sensors_battery().power_plugged, False)
+            assert m.called
+
+    def test_emulate_power_undetermined(self):
+        # Pretend we can't know whether the AC power cable not
+        # connected (assert fallback to False).
+        def open_mock(name, *args, **kwargs):
+            if name.startswith("/sys/class/power_supply/AC0/online") or \
+                    name.startswith("/sys/class/power_supply/AC/online"):
+                raise IOError(errno.ENOENT, "")
+            elif name.startswith("/sys/class/power_supply/BAT0/status"):
+                return io.BytesIO(b"???")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            self.assertIsNone(psutil.sensors_battery().power_plugged)
+            assert m.called
+
+    def test_emulate_energy_full_0(self):
+        # Emulate a case where energy_full files returns 0.
+        with mock_open_content(
+                "/sys/class/power_supply/BAT0/energy_full", b"0") as m:
+            self.assertEqual(psutil.sensors_battery().percent, 0)
+            assert m.called
+
+    def test_emulate_energy_full_not_avail(self):
+        # Emulate a case where energy_full file does not exist.
+        # Expected fallback on /capacity.
+        with mock_open_exception(
+                "/sys/class/power_supply/BAT0/energy_full",
+                IOError(errno.ENOENT, "")):
+            with mock_open_exception(
+                    "/sys/class/power_supply/BAT0/charge_full",
+                    IOError(errno.ENOENT, "")):
+                with mock_open_content(
+                        "/sys/class/power_supply/BAT0/capacity", b"88"):
+                    self.assertEqual(psutil.sensors_battery().percent, 88)
+
+    def test_emulate_no_power(self):
+        # Emulate a case where /AC0/online file nor /BAT0/status exist.
+        with mock_open_exception(
+                "/sys/class/power_supply/AC/online",
+                IOError(errno.ENOENT, "")):
+            with mock_open_exception(
+                    "/sys/class/power_supply/AC0/online",
+                    IOError(errno.ENOENT, "")):
+                with mock_open_exception(
+                        "/sys/class/power_supply/BAT0/status",
+                        IOError(errno.ENOENT, "")):
+                    self.assertIsNone(psutil.sensors_battery().power_plugged)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSensorsBatteryEmulated(PsutilTestCase):
+
+    def test_it(self):
+        def open_mock(name, *args, **kwargs):
+            if name.endswith("/energy_now"):
+                return io.StringIO(u("60000000"))
+            elif name.endswith("/power_now"):
+                return io.StringIO(u("0"))
+            elif name.endswith("/energy_full"):
+                return io.StringIO(u("60000001"))
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch('os.listdir', return_value=["BAT0"]) as mlistdir:
+            with mock.patch(patch_point, side_effect=open_mock) as mopen:
+                self.assertIsNotNone(psutil.sensors_battery())
+        assert mlistdir.called
+        assert mopen.called
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSensorsTemperatures(PsutilTestCase):
+
+    def test_emulate_class_hwmon(self):
+        def open_mock(name, *args, **kwargs):
+            if name.endswith('/name'):
+                return io.StringIO(u("name"))
+            elif name.endswith('/temp1_label'):
+                return io.StringIO(u("label"))
+            elif name.endswith('/temp1_input'):
+                return io.BytesIO(b"30000")
+            elif name.endswith('/temp1_max'):
+                return io.BytesIO(b"40000")
+            elif name.endswith('/temp1_crit'):
+                return io.BytesIO(b"50000")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            # Test case with /sys/class/hwmon
+            with mock.patch('glob.glob',
+                            return_value=['/sys/class/hwmon/hwmon0/temp1']):
+                temp = psutil.sensors_temperatures()['name'][0]
+                self.assertEqual(temp.label, 'label')
+                self.assertEqual(temp.current, 30.0)
+                self.assertEqual(temp.high, 40.0)
+                self.assertEqual(temp.critical, 50.0)
+
+    def test_emulate_class_thermal(self):
+        def open_mock(name, *args, **kwargs):
+            if name.endswith('0_temp'):
+                return io.BytesIO(b"50000")
+            elif name.endswith('temp'):
+                return io.BytesIO(b"30000")
+            elif name.endswith('0_type'):
+                return io.StringIO(u("critical"))
+            elif name.endswith('type'):
+                return io.StringIO(u("name"))
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        def glob_mock(path):
+            if path == '/sys/class/hwmon/hwmon*/temp*_*':
+                return []
+            elif path == '/sys/class/hwmon/hwmon*/device/temp*_*':
+                return []
+            elif path == '/sys/class/thermal/thermal_zone*':
+                return ['/sys/class/thermal/thermal_zone0']
+            elif path == '/sys/class/thermal/thermal_zone0/trip_point*':
+                return ['/sys/class/thermal/thermal_zone1/trip_point_0_type',
+                        '/sys/class/thermal/thermal_zone1/trip_point_0_temp']
+            return []
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            with mock.patch('glob.glob', create=True, side_effect=glob_mock):
+                temp = psutil.sensors_temperatures()['name'][0]
+                self.assertEqual(temp.label, '')
+                self.assertEqual(temp.current, 30.0)
+                self.assertEqual(temp.high, 50.0)
+                self.assertEqual(temp.critical, 50.0)
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestSensorsFans(PsutilTestCase):
+
+    def test_emulate_data(self):
+        def open_mock(name, *args, **kwargs):
+            if name.endswith('/name'):
+                return io.StringIO(u("name"))
+            elif name.endswith('/fan1_label'):
+                return io.StringIO(u("label"))
+            elif name.endswith('/fan1_input'):
+                return io.StringIO(u("2000"))
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock):
+            with mock.patch('glob.glob',
+                            return_value=['/sys/class/hwmon/hwmon2/fan1']):
+                fan = psutil.sensors_fans()['name'][0]
+                self.assertEqual(fan.label, 'label')
+                self.assertEqual(fan.current, 2000)
+
+
+# =====================================================================
+# --- test process
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestProcess(PsutilTestCase):
+
+    @retry_on_failure()
+    def test_memory_full_info(self):
+        testfn = self.get_testfn()
+        src = textwrap.dedent("""
+            import time
+            with open("%s", "w") as f:
+                time.sleep(10)
+            """ % testfn)
+        sproc = self.pyrun(src)
+        call_until(lambda: os.listdir('.'), "'%s' not in ret" % testfn)
+        p = psutil.Process(sproc.pid)
+        time.sleep(.1)
+        mem = p.memory_full_info()
+        maps = p.memory_maps(grouped=False)
+        self.assertAlmostEqual(
+            mem.uss, sum([x.private_dirty + x.private_clean for x in maps]),
+            delta=4096)
+        self.assertAlmostEqual(
+            mem.pss, sum([x.pss for x in maps]), delta=4096)
+        self.assertAlmostEqual(
+            mem.swap, sum([x.swap for x in maps]), delta=4096)
+
+    def test_memory_full_info_mocked(self):
+        # See: https://github.com/giampaolo/psutil/issues/1222
+        with mock_open_content(
+            "/proc/%s/smaps" % os.getpid(),
+            textwrap.dedent("""\
+                fffff0 r-xp 00000000 00:00 0                  [vsyscall]
+                Size:                  1 kB
+                Rss:                   2 kB
+                Pss:                   3 kB
+                Shared_Clean:          4 kB
+                Shared_Dirty:          5 kB
+                Private_Clean:         6 kB
+                Private_Dirty:         7 kB
+                Referenced:            8 kB
+                Anonymous:             9 kB
+                LazyFree:              10 kB
+                AnonHugePages:         11 kB
+                ShmemPmdMapped:        12 kB
+                Shared_Hugetlb:        13 kB
+                Private_Hugetlb:       14 kB
+                Swap:                  15 kB
+                SwapPss:               16 kB
+                KernelPageSize:        17 kB
+                MMUPageSize:           18 kB
+                Locked:                19 kB
+                VmFlags: rd ex
+                """).encode()) as m:
+            p = psutil.Process()
+            mem = p.memory_full_info()
+            assert m.called
+            self.assertEqual(mem.uss, (6 + 7 + 14) * 1024)
+            self.assertEqual(mem.pss, 3 * 1024)
+            self.assertEqual(mem.swap, 15 * 1024)
+
+    # On PYPY file descriptors are not closed fast enough.
+    @unittest.skipIf(PYPY, "unreliable on PYPY")
+    def test_open_files_mode(self):
+        def get_test_file(fname):
+            p = psutil.Process()
+            giveup_at = time.time() + GLOBAL_TIMEOUT
+            while True:
+                for file in p.open_files():
+                    if file.path == os.path.abspath(fname):
+                        return file
+                    elif time.time() > giveup_at:
+                        break
+            raise RuntimeError("timeout looking for test file")
+
+        #
+        testfn = self.get_testfn()
+        with open(testfn, "w"):
+            self.assertEqual(get_test_file(testfn).mode, "w")
+        with open(testfn, "r"):
+            self.assertEqual(get_test_file(testfn).mode, "r")
+        with open(testfn, "a"):
+            self.assertEqual(get_test_file(testfn).mode, "a")
+        #
+        with open(testfn, "r+"):
+            self.assertEqual(get_test_file(testfn).mode, "r+")
+        with open(testfn, "w+"):
+            self.assertEqual(get_test_file(testfn).mode, "r+")
+        with open(testfn, "a+"):
+            self.assertEqual(get_test_file(testfn).mode, "a+")
+        # note: "x" bit is not supported
+        if PY3:
+            safe_rmpath(testfn)
+            with open(testfn, "x"):
+                self.assertEqual(get_test_file(testfn).mode, "w")
+            safe_rmpath(testfn)
+            with open(testfn, "x+"):
+                self.assertEqual(get_test_file(testfn).mode, "r+")
+
+    def test_open_files_file_gone(self):
+        # simulates a file which gets deleted during open_files()
+        # execution
+        p = psutil.Process()
+        files = p.open_files()
+        with open(self.get_testfn(), 'w'):
+            # give the kernel some time to see the new file
+            call_until(p.open_files, "len(ret) != %i" % len(files))
+            with mock.patch('psutil._pslinux.os.readlink',
+                            side_effect=OSError(errno.ENOENT, "")) as m:
+                files = p.open_files()
+                assert not files
+                assert m.called
+            # also simulate the case where os.readlink() returns EINVAL
+            # in which case psutil is supposed to 'continue'
+            with mock.patch('psutil._pslinux.os.readlink',
+                            side_effect=OSError(errno.EINVAL, "")) as m:
+                self.assertEqual(p.open_files(), [])
+                assert m.called
+
+    def test_open_files_fd_gone(self):
+        # Simulate a case where /proc/{pid}/fdinfo/{fd} disappears
+        # while iterating through fds.
+        # https://travis-ci.org/giampaolo/psutil/jobs/225694530
+        p = psutil.Process()
+        files = p.open_files()
+        with open(self.get_testfn(), 'w'):
+            # give the kernel some time to see the new file
+            call_until(p.open_files, "len(ret) != %i" % len(files))
+            patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+            with mock.patch(patch_point,
+                            side_effect=IOError(errno.ENOENT, "")) as m:
+                files = p.open_files()
+                assert not files
+                assert m.called
+
+    # --- mocked tests
+
+    def test_terminal_mocked(self):
+        with mock.patch('psutil._pslinux._psposix.get_terminal_map',
+                        return_value={}) as m:
+            self.assertIsNone(psutil._pslinux.Process(os.getpid()).terminal())
+            assert m.called
+
+    # TODO: re-enable this test.
+    # def test_num_ctx_switches_mocked(self):
+    #     with mock.patch('psutil._common.open', create=True) as m:
+    #         self.assertRaises(
+    #             NotImplementedError,
+    #             psutil._pslinux.Process(os.getpid()).num_ctx_switches)
+    #         assert m.called
+
+    def test_cmdline_mocked(self):
+        # see: https://github.com/giampaolo/psutil/issues/639
+        p = psutil.Process()
+        fake_file = io.StringIO(u('foo\x00bar\x00'))
+        with mock.patch('psutil._common.open',
+                        return_value=fake_file, create=True) as m:
+            self.assertEqual(p.cmdline(), ['foo', 'bar'])
+            assert m.called
+        fake_file = io.StringIO(u('foo\x00bar\x00\x00'))
+        with mock.patch('psutil._common.open',
+                        return_value=fake_file, create=True) as m:
+            self.assertEqual(p.cmdline(), ['foo', 'bar', ''])
+            assert m.called
+
+    def test_cmdline_spaces_mocked(self):
+        # see: https://github.com/giampaolo/psutil/issues/1179
+        p = psutil.Process()
+        fake_file = io.StringIO(u('foo bar '))
+        with mock.patch('psutil._common.open',
+                        return_value=fake_file, create=True) as m:
+            self.assertEqual(p.cmdline(), ['foo', 'bar'])
+            assert m.called
+        fake_file = io.StringIO(u('foo bar  '))
+        with mock.patch('psutil._common.open',
+                        return_value=fake_file, create=True) as m:
+            self.assertEqual(p.cmdline(), ['foo', 'bar', ''])
+            assert m.called
+
+    def test_cmdline_mixed_separators(self):
+        # https://github.com/giampaolo/psutil/issues/
+        #    1179#issuecomment-552984549
+        p = psutil.Process()
+        fake_file = io.StringIO(u('foo\x20bar\x00'))
+        with mock.patch('psutil._common.open',
+                        return_value=fake_file, create=True) as m:
+            self.assertEqual(p.cmdline(), ['foo', 'bar'])
+            assert m.called
+
+    def test_readlink_path_deleted_mocked(self):
+        with mock.patch('psutil._pslinux.os.readlink',
+                        return_value='/home/foo (deleted)'):
+            self.assertEqual(psutil.Process().exe(), "/home/foo")
+            self.assertEqual(psutil.Process().cwd(), "/home/foo")
+
+    def test_threads_mocked(self):
+        # Test the case where os.listdir() returns a file (thread)
+        # which no longer exists by the time we open() it (race
+        # condition). threads() is supposed to ignore that instead
+        # of raising NSP.
+        def open_mock(name, *args, **kwargs):
+            if name.startswith('/proc/%s/task' % os.getpid()):
+                raise IOError(errno.ENOENT, "")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        orig_open = open
+        patch_point = 'builtins.open' if PY3 else '__builtin__.open'
+        with mock.patch(patch_point, side_effect=open_mock) as m:
+            ret = psutil.Process().threads()
+            assert m.called
+            self.assertEqual(ret, [])
+
+        # ...but if it bumps into something != ENOENT we want an
+        # exception.
+        def open_mock(name, *args, **kwargs):
+            if name.startswith('/proc/%s/task' % os.getpid()):
+                raise IOError(errno.EPERM, "")
+            else:
+                return orig_open(name, *args, **kwargs)
+
+        with mock.patch(patch_point, side_effect=open_mock):
+            self.assertRaises(psutil.AccessDenied, psutil.Process().threads)
+
+    def test_exe_mocked(self):
+        with mock.patch('psutil._pslinux.readlink',
+                        side_effect=OSError(errno.ENOENT, "")) as m1:
+            with mock.patch('psutil.Process.cmdline',
+                            side_effect=psutil.AccessDenied(0, "")) as m2:
+                # No such file error; might be raised also if /proc/pid/exe
+                # path actually exists for system processes with low pids
+                # (about 0-20). In this case psutil is supposed to return
+                # an empty string.
+                ret = psutil.Process().exe()
+                assert m1.called
+                assert m2.called
+                self.assertEqual(ret, "")
+
+                # ...but if /proc/pid no longer exist we're supposed to treat
+                # it as an alias for zombie process
+                with mock.patch('psutil._pslinux.os.path.lexists',
+                                return_value=False):
+                    self.assertRaises(
+                        psutil.ZombieProcess, psutil.Process().exe)
+
+    def test_issue_1014(self):
+        # Emulates a case where smaps file does not exist. In this case
+        # wrap_exception decorator should not raise NoSuchProcess.
+        with mock_open_exception(
+                '/proc/%s/smaps' % os.getpid(),
+                IOError(errno.ENOENT, "")) as m:
+            p = psutil.Process()
+            with self.assertRaises(FileNotFoundError):
+                p.memory_maps()
+            assert m.called
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_zombie(self):
+        # Emulate a case where rlimit() raises ENOSYS, which may
+        # happen in case of zombie process:
+        # https://travis-ci.org/giampaolo/psutil/jobs/51368273
+        with mock.patch("psutil._pslinux.cext.linux_prlimit",
+                        side_effect=OSError(errno.ENOSYS, "")) as m:
+            p = psutil.Process()
+            p.name()
+            with self.assertRaises(psutil.ZombieProcess) as exc:
+                p.rlimit(psutil.RLIMIT_NOFILE)
+            assert m.called
+        self.assertEqual(exc.exception.pid, p.pid)
+        self.assertEqual(exc.exception.name, p.name())
+
+    def test_cwd_zombie(self):
+        with mock.patch("psutil._pslinux.os.readlink",
+                        side_effect=OSError(errno.ENOENT, "")) as m:
+            p = psutil.Process()
+            p.name()
+            with self.assertRaises(psutil.ZombieProcess) as exc:
+                p.cwd()
+            assert m.called
+        self.assertEqual(exc.exception.pid, p.pid)
+        self.assertEqual(exc.exception.name, p.name())
+
+    def test_stat_file_parsing(self):
+        from psutil._pslinux import CLOCK_TICKS
+
+        args = [
+            "0",      # pid
+            "(cat)",  # name
+            "Z",      # status
+            "1",      # ppid
+            "0",      # pgrp
+            "0",      # session
+            "0",      # tty
+            "0",      # tpgid
+            "0",      # flags
+            "0",      # minflt
+            "0",      # cminflt
+            "0",      # majflt
+            "0",      # cmajflt
+            "2",      # utime
+            "3",      # stime
+            "4",      # cutime
+            "5",      # cstime
+            "0",      # priority
+            "0",      # nice
+            "0",      # num_threads
+            "0",      # itrealvalue
+            "6",      # starttime
+            "0",      # vsize
+            "0",      # rss
+            "0",      # rsslim
+            "0",      # startcode
+            "0",      # endcode
+            "0",      # startstack
+            "0",      # kstkesp
+            "0",      # kstkeip
+            "0",      # signal
+            "0",      # blocked
+            "0",      # sigignore
+            "0",      # sigcatch
+            "0",      # wchan
+            "0",      # nswap
+            "0",      # cnswap
+            "0",      # exit_signal
+            "6",      # processor
+            "0",      # rt priority
+            "0",      # policy
+            "7",      # delayacct_blkio_ticks
+        ]
+        content = " ".join(args).encode()
+        with mock_open_content('/proc/%s/stat' % os.getpid(), content):
+            p = psutil.Process()
+            self.assertEqual(p.name(), 'cat')
+            self.assertEqual(p.status(), psutil.STATUS_ZOMBIE)
+            self.assertEqual(p.ppid(), 1)
+            self.assertEqual(
+                p.create_time(), 6 / CLOCK_TICKS + psutil.boot_time())
+            cpu = p.cpu_times()
+            self.assertEqual(cpu.user, 2 / CLOCK_TICKS)
+            self.assertEqual(cpu.system, 3 / CLOCK_TICKS)
+            self.assertEqual(cpu.children_user, 4 / CLOCK_TICKS)
+            self.assertEqual(cpu.children_system, 5 / CLOCK_TICKS)
+            self.assertEqual(cpu.iowait, 7 / CLOCK_TICKS)
+            self.assertEqual(p.cpu_num(), 6)
+
+    def test_status_file_parsing(self):
+        with mock_open_content(
+            '/proc/%s/status' % os.getpid(),
+            textwrap.dedent("""\
+                Uid:\t1000\t1001\t1002\t1003
+                Gid:\t1004\t1005\t1006\t1007
+                Threads:\t66
+                Cpus_allowed:\tf
+                Cpus_allowed_list:\t0-7
+                voluntary_ctxt_switches:\t12
+                nonvoluntary_ctxt_switches:\t13""").encode()):
+            p = psutil.Process()
+            self.assertEqual(p.num_ctx_switches().voluntary, 12)
+            self.assertEqual(p.num_ctx_switches().involuntary, 13)
+            self.assertEqual(p.num_threads(), 66)
+            uids = p.uids()
+            self.assertEqual(uids.real, 1000)
+            self.assertEqual(uids.effective, 1001)
+            self.assertEqual(uids.saved, 1002)
+            gids = p.gids()
+            self.assertEqual(gids.real, 1004)
+            self.assertEqual(gids.effective, 1005)
+            self.assertEqual(gids.saved, 1006)
+            self.assertEqual(p._proc._get_eligible_cpus(), list(range(0, 8)))
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestProcessAgainstStatus(PsutilTestCase):
+    """/proc/pid/stat and /proc/pid/status have many values in common.
+    Whenever possible, psutil uses /proc/pid/stat (it's faster).
+    For all those cases we check that the value found in
+    /proc/pid/stat (by psutil) matches the one found in
+    /proc/pid/status.
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        cls.proc = psutil.Process()
+
+    def read_status_file(self, linestart):
+        with psutil._psplatform.open_text(
+                '/proc/%s/status' % self.proc.pid) as f:
+            for line in f:
+                line = line.strip()
+                if line.startswith(linestart):
+                    value = line.partition('\t')[2]
+                    try:
+                        return int(value)
+                    except ValueError:
+                        return value
+            raise ValueError("can't find %r" % linestart)
+
+    def test_name(self):
+        value = self.read_status_file("Name:")
+        self.assertEqual(self.proc.name(), value)
+
+    def test_status(self):
+        value = self.read_status_file("State:")
+        value = value[value.find('(') + 1:value.rfind(')')]
+        value = value.replace(' ', '-')
+        self.assertEqual(self.proc.status(), value)
+
+    def test_ppid(self):
+        value = self.read_status_file("PPid:")
+        self.assertEqual(self.proc.ppid(), value)
+
+    def test_num_threads(self):
+        value = self.read_status_file("Threads:")
+        self.assertEqual(self.proc.num_threads(), value)
+
+    def test_uids(self):
+        value = self.read_status_file("Uid:")
+        value = tuple(map(int, value.split()[1:4]))
+        self.assertEqual(self.proc.uids(), value)
+
+    def test_gids(self):
+        value = self.read_status_file("Gid:")
+        value = tuple(map(int, value.split()[1:4]))
+        self.assertEqual(self.proc.gids(), value)
+
+    @retry_on_failure()
+    def test_num_ctx_switches(self):
+        value = self.read_status_file("voluntary_ctxt_switches:")
+        self.assertEqual(self.proc.num_ctx_switches().voluntary, value)
+        value = self.read_status_file("nonvoluntary_ctxt_switches:")
+        self.assertEqual(self.proc.num_ctx_switches().involuntary, value)
+
+    def test_cpu_affinity(self):
+        value = self.read_status_file("Cpus_allowed_list:")
+        if '-' in str(value):
+            min_, max_ = map(int, value.split('-'))
+            self.assertEqual(
+                self.proc.cpu_affinity(), list(range(min_, max_ + 1)))
+
+    def test_cpu_affinity_eligible_cpus(self):
+        value = self.read_status_file("Cpus_allowed_list:")
+        with mock.patch("psutil._pslinux.per_cpu_times") as m:
+            self.proc._proc._get_eligible_cpus()
+        if '-' in str(value):
+            assert not m.called
+        else:
+            assert m.called
+
+
+# =====================================================================
+# --- test utils
+# =====================================================================
+
+
+@unittest.skipIf(not LINUX, "LINUX only")
+class TestUtils(PsutilTestCase):
+
+    def test_readlink(self):
+        with mock.patch("os.readlink", return_value="foo (deleted)") as m:
+            self.assertEqual(psutil._psplatform.readlink("bar"), "foo")
+            assert m.called
+
+    def test_cat(self):
+        testfn = self.get_testfn()
+        with open(testfn, "wt") as f:
+            f.write("foo ")
+        self.assertEqual(psutil._psplatform.cat(testfn, binary=False), "foo")
+        self.assertEqual(psutil._psplatform.cat(testfn, binary=True), b"foo")
+        self.assertEqual(
+            psutil._psplatform.cat(testfn + '??', fallback="bar"), "bar")
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_memleaks.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_memleaks.py
new file mode 100644
index 0000000000000000000000000000000000000000..cab91428d2cfb519d4994797771dd24b2b735125
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_memleaks.py
@@ -0,0 +1,487 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Tests for detecting function memory leaks (typically the ones
+implemented in C). It does so by calling a function many times and
+checking whether process memory usage keeps increasing between
+calls or over time.
+Note that this may produce false positives (especially on Windows
+for some reason).
+PyPy appears to be completely unstable for this framework, probably
+because of how its JIT handles memory, so tests are skipped.
+"""
+
+from __future__ import print_function
+import functools
+import os
+
+import psutil
+import psutil._common
+from psutil import LINUX
+from psutil import MACOS
+from psutil import OPENBSD
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._compat import ProcessLookupError
+from psutil._compat import super
+from psutil.tests import create_sockets
+from psutil.tests import get_testfn
+from psutil.tests import HAS_CPU_AFFINITY
+from psutil.tests import HAS_CPU_FREQ
+from psutil.tests import HAS_ENVIRON
+from psutil.tests import HAS_IONICE
+from psutil.tests import HAS_MEMORY_MAPS
+from psutil.tests import HAS_NET_IO_COUNTERS
+from psutil.tests import HAS_PROC_CPU_NUM
+from psutil.tests import HAS_PROC_IO_COUNTERS
+from psutil.tests import HAS_RLIMIT
+from psutil.tests import HAS_SENSORS_BATTERY
+from psutil.tests import HAS_SENSORS_FANS
+from psutil.tests import HAS_SENSORS_TEMPERATURES
+from psutil.tests import process_namespace
+from psutil.tests import skip_on_access_denied
+from psutil.tests import spawn_testproc
+from psutil.tests import system_namespace
+from psutil.tests import terminate
+from psutil.tests import TestMemoryLeak
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+
+
+cext = psutil._psplatform.cext
+thisproc = psutil.Process()
+FEW_TIMES = 5
+
+
+def fewtimes_if_linux():
+    """Decorator for those Linux functions which are implemented in pure
+    Python, and which we want to run faster.
+    """
+    def decorator(fun):
+        @functools.wraps(fun)
+        def wrapper(self, *args, **kwargs):
+            if LINUX:
+                before = self.__class__.times
+                try:
+                    self.__class__.times = FEW_TIMES
+                    return fun(self, *args, **kwargs)
+                finally:
+                    self.__class__.times = before
+            else:
+                return fun(self, *args, **kwargs)
+        return wrapper
+    return decorator
+
+
+# ===================================================================
+# Process class
+# ===================================================================
+
+
+class TestProcessObjectLeaks(TestMemoryLeak):
+    """Test leaks of Process class methods."""
+
+    proc = thisproc
+
+    def test_coverage(self):
+        ns = process_namespace(None)
+        ns.test_class_coverage(self, ns.getters + ns.setters)
+
+    @fewtimes_if_linux()
+    def test_name(self):
+        self.execute(self.proc.name)
+
+    @fewtimes_if_linux()
+    def test_cmdline(self):
+        self.execute(self.proc.cmdline)
+
+    @fewtimes_if_linux()
+    def test_exe(self):
+        self.execute(self.proc.exe)
+
+    @fewtimes_if_linux()
+    def test_ppid(self):
+        self.execute(self.proc.ppid)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @fewtimes_if_linux()
+    def test_uids(self):
+        self.execute(self.proc.uids)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @fewtimes_if_linux()
+    def test_gids(self):
+        self.execute(self.proc.gids)
+
+    @fewtimes_if_linux()
+    def test_status(self):
+        self.execute(self.proc.status)
+
+    def test_nice(self):
+        self.execute(self.proc.nice)
+
+    def test_nice_set(self):
+        niceness = thisproc.nice()
+        self.execute(lambda: self.proc.nice(niceness))
+
+    @unittest.skipIf(not HAS_IONICE, "not supported")
+    def test_ionice(self):
+        self.execute(self.proc.ionice)
+
+    @unittest.skipIf(not HAS_IONICE, "not supported")
+    def test_ionice_set(self):
+        if WINDOWS:
+            value = thisproc.ionice()
+            self.execute(lambda: self.proc.ionice(value))
+        else:
+            self.execute(lambda: self.proc.ionice(psutil.IOPRIO_CLASS_NONE))
+            fun = functools.partial(cext.proc_ioprio_set, os.getpid(), -1, 0)
+            self.execute_w_exc(OSError, fun)
+
+    @unittest.skipIf(not HAS_PROC_IO_COUNTERS, "not supported")
+    @fewtimes_if_linux()
+    def test_io_counters(self):
+        self.execute(self.proc.io_counters)
+
+    @unittest.skipIf(POSIX, "worthless on POSIX")
+    def test_username(self):
+        # always open 1 handle on Windows (only once)
+        psutil.Process().username()
+        self.execute(self.proc.username)
+
+    @fewtimes_if_linux()
+    def test_create_time(self):
+        self.execute(self.proc.create_time)
+
+    @fewtimes_if_linux()
+    @skip_on_access_denied(only_if=OPENBSD)
+    def test_num_threads(self):
+        self.execute(self.proc.num_threads)
+
+    @unittest.skipIf(not WINDOWS, "WINDOWS only")
+    def test_num_handles(self):
+        self.execute(self.proc.num_handles)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @fewtimes_if_linux()
+    def test_num_fds(self):
+        self.execute(self.proc.num_fds)
+
+    @fewtimes_if_linux()
+    def test_num_ctx_switches(self):
+        self.execute(self.proc.num_ctx_switches)
+
+    @fewtimes_if_linux()
+    @skip_on_access_denied(only_if=OPENBSD)
+    def test_threads(self):
+        self.execute(self.proc.threads)
+
+    @fewtimes_if_linux()
+    def test_cpu_times(self):
+        self.execute(self.proc.cpu_times)
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_PROC_CPU_NUM, "not supported")
+    def test_cpu_num(self):
+        self.execute(self.proc.cpu_num)
+
+    @fewtimes_if_linux()
+    def test_memory_info(self):
+        self.execute(self.proc.memory_info)
+
+    @fewtimes_if_linux()
+    def test_memory_full_info(self):
+        self.execute(self.proc.memory_full_info)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @fewtimes_if_linux()
+    def test_terminal(self):
+        self.execute(self.proc.terminal)
+
+    def test_resume(self):
+        times = FEW_TIMES if POSIX else self.times
+        self.execute(self.proc.resume, times=times)
+
+    @fewtimes_if_linux()
+    def test_cwd(self):
+        self.execute(self.proc.cwd)
+
+    @unittest.skipIf(not HAS_CPU_AFFINITY, "not supported")
+    def test_cpu_affinity(self):
+        self.execute(self.proc.cpu_affinity)
+
+    @unittest.skipIf(not HAS_CPU_AFFINITY, "not supported")
+    def test_cpu_affinity_set(self):
+        affinity = thisproc.cpu_affinity()
+        self.execute(lambda: self.proc.cpu_affinity(affinity))
+        if not TRAVIS:
+            self.execute_w_exc(
+                ValueError, lambda: self.proc.cpu_affinity([-1]))
+
+    @fewtimes_if_linux()
+    def test_open_files(self):
+        with open(get_testfn(), 'w'):
+            self.execute(self.proc.open_files)
+
+    @unittest.skipIf(not HAS_MEMORY_MAPS, "not supported")
+    @fewtimes_if_linux()
+    def test_memory_maps(self):
+        self.execute(self.proc.memory_maps)
+
+    @unittest.skipIf(not LINUX, "LINUX only")
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit(self):
+        self.execute(lambda: self.proc.rlimit(psutil.RLIMIT_NOFILE))
+
+    @unittest.skipIf(not LINUX, "LINUX only")
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_set(self):
+        limit = thisproc.rlimit(psutil.RLIMIT_NOFILE)
+        self.execute(lambda: self.proc.rlimit(psutil.RLIMIT_NOFILE, limit))
+        self.execute_w_exc(OSError, lambda: self.proc.rlimit(-1))
+
+    @fewtimes_if_linux()
+    # Windows implementation is based on a single system-wide
+    # function (tested later).
+    @unittest.skipIf(WINDOWS, "worthless on WINDOWS")
+    def test_connections(self):
+        # TODO: UNIX sockets are temporarily implemented by parsing
+        # 'pfiles' cmd  output; we don't want that part of the code to
+        # be executed.
+        with create_sockets():
+            kind = 'inet' if SUNOS else 'all'
+            self.execute(lambda: self.proc.connections(kind))
+
+    @unittest.skipIf(not HAS_ENVIRON, "not supported")
+    def test_environ(self):
+        self.execute(self.proc.environ)
+
+    @unittest.skipIf(not WINDOWS, "WINDOWS only")
+    def test_proc_info(self):
+        self.execute(lambda: cext.proc_info(os.getpid()))
+
+
+class TestTerminatedProcessLeaks(TestProcessObjectLeaks):
+    """Repeat the tests above looking for leaks occurring when dealing
+    with terminated processes raising NoSuchProcess exception.
+    The C functions are still invoked but will follow different code
+    paths. We'll check those code paths.
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        super().setUpClass()
+        cls.subp = spawn_testproc()
+        cls.proc = psutil.Process(cls.subp.pid)
+        cls.proc.kill()
+        cls.proc.wait()
+
+    @classmethod
+    def tearDownClass(cls):
+        super().tearDownClass()
+        terminate(cls.subp)
+
+    def call(self, fun):
+        try:
+            fun()
+        except psutil.NoSuchProcess:
+            pass
+
+    if WINDOWS:
+
+        def test_kill(self):
+            self.execute(self.proc.kill)
+
+        def test_terminate(self):
+            self.execute(self.proc.terminate)
+
+        def test_suspend(self):
+            self.execute(self.proc.suspend)
+
+        def test_resume(self):
+            self.execute(self.proc.resume)
+
+        def test_wait(self):
+            self.execute(self.proc.wait)
+
+        def test_proc_info(self):
+            # test dual implementation
+            def call():
+                try:
+                    return cext.proc_info(self.proc.pid)
+                except ProcessLookupError:
+                    pass
+
+            self.execute(call)
+
+
+@unittest.skipIf(not WINDOWS, "WINDOWS only")
+class TestProcessDualImplementation(TestMemoryLeak):
+
+    def test_cmdline_peb_true(self):
+        self.execute(lambda: cext.proc_cmdline(os.getpid(), use_peb=True))
+
+    def test_cmdline_peb_false(self):
+        self.execute(lambda: cext.proc_cmdline(os.getpid(), use_peb=False))
+
+
+# ===================================================================
+# system APIs
+# ===================================================================
+
+
+class TestModuleFunctionsLeaks(TestMemoryLeak):
+    """Test leaks of psutil module functions."""
+
+    def test_coverage(self):
+        ns = system_namespace()
+        ns.test_class_coverage(self, ns.all)
+
+    # --- cpu
+
+    @fewtimes_if_linux()
+    def test_cpu_count(self):  # logical
+        self.execute(lambda: psutil.cpu_count(logical=True))
+
+    @fewtimes_if_linux()
+    def test_cpu_count_physical(self):
+        self.execute(lambda: psutil.cpu_count(logical=False))
+
+    @fewtimes_if_linux()
+    def test_cpu_times(self):
+        self.execute(psutil.cpu_times)
+
+    @fewtimes_if_linux()
+    def test_per_cpu_times(self):
+        self.execute(lambda: psutil.cpu_times(percpu=True))
+
+    @fewtimes_if_linux()
+    def test_cpu_stats(self):
+        self.execute(psutil.cpu_stats)
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_CPU_FREQ, "not supported")
+    def test_cpu_freq(self):
+        self.execute(psutil.cpu_freq)
+
+    @unittest.skipIf(not WINDOWS, "WINDOWS only")
+    def test_getloadavg(self):
+        psutil.getloadavg()
+        self.execute(psutil.getloadavg)
+
+    # --- mem
+
+    def test_virtual_memory(self):
+        self.execute(psutil.virtual_memory)
+
+    # TODO: remove this skip when this gets fixed
+    @unittest.skipIf(SUNOS, "worthless on SUNOS (uses a subprocess)")
+    def test_swap_memory(self):
+        self.execute(psutil.swap_memory)
+
+    def test_pid_exists(self):
+        times = FEW_TIMES if POSIX else self.times
+        self.execute(lambda: psutil.pid_exists(os.getpid()), times=times)
+
+    # --- disk
+
+    def test_disk_usage(self):
+        times = FEW_TIMES if POSIX else self.times
+        self.execute(lambda: psutil.disk_usage('.'), times=times)
+
+    def test_disk_partitions(self):
+        self.execute(psutil.disk_partitions)
+
+    @unittest.skipIf(LINUX and not os.path.exists('/proc/diskstats'),
+                     '/proc/diskstats not available on this Linux version')
+    @fewtimes_if_linux()
+    def test_disk_io_counters(self):
+        self.execute(lambda: psutil.disk_io_counters(nowrap=False))
+
+    # --- proc
+
+    @fewtimes_if_linux()
+    def test_pids(self):
+        self.execute(psutil.pids)
+
+    # --- net
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, 'not supported')
+    def test_net_io_counters(self):
+        self.execute(lambda: psutil.net_io_counters(nowrap=False))
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(MACOS and os.getuid() != 0, "need root access")
+    def test_net_connections(self):
+        # always opens and handle on Windows() (once)
+        psutil.net_connections(kind='all')
+        with create_sockets():
+            self.execute(lambda: psutil.net_connections(kind='all'))
+
+    def test_net_if_addrs(self):
+        # Note: verified that on Windows this was a false positive.
+        tolerance = 80 * 1024 if WINDOWS else self.tolerance
+        self.execute(psutil.net_if_addrs, tolerance=tolerance)
+
+    # @unittest.skipIf(TRAVIS, "EPERM on travis")
+    def test_net_if_stats(self):
+        self.execute(psutil.net_if_stats)
+
+    # --- sensors
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_SENSORS_BATTERY, "not supported")
+    def test_sensors_battery(self):
+        self.execute(psutil.sensors_battery)
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_SENSORS_TEMPERATURES, "not supported")
+    def test_sensors_temperatures(self):
+        self.execute(psutil.sensors_temperatures)
+
+    @fewtimes_if_linux()
+    @unittest.skipIf(not HAS_SENSORS_FANS, "not supported")
+    def test_sensors_fans(self):
+        self.execute(psutil.sensors_fans)
+
+    # --- others
+
+    @fewtimes_if_linux()
+    def test_boot_time(self):
+        self.execute(psutil.boot_time)
+
+    def test_users(self):
+        self.execute(psutil.users)
+
+    if WINDOWS:
+
+        # --- win services
+
+        def test_win_service_iter(self):
+            self.execute(cext.winservice_enumerate)
+
+        def test_win_service_get(self):
+            pass
+
+        def test_win_service_get_config(self):
+            name = next(psutil.win_service_iter()).name()
+            self.execute(lambda: cext.winservice_query_config(name))
+
+        def test_win_service_get_status(self):
+            name = next(psutil.win_service_iter()).name()
+            self.execute(lambda: cext.winservice_query_status(name))
+
+        def test_win_service_get_description(self):
+            name = next(psutil.win_service_iter()).name()
+            self.execute(lambda: cext.winservice_query_descr(name))
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_misc.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_misc.py
new file mode 100644
index 0000000000000000000000000000000000000000..8fcee12a760c12aa326baec73e142e8adfb4acb8
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_misc.py
@@ -0,0 +1,774 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Miscellaneous tests.
+"""
+
+import ast
+import collections
+import errno
+import json
+import os
+import pickle
+import socket
+import stat
+
+from psutil import LINUX
+from psutil import POSIX
+from psutil import WINDOWS
+from psutil._common import memoize
+from psutil._common import memoize_when_activated
+from psutil._common import supports_ipv6
+from psutil._common import wrap_numbers
+from psutil._compat import PY3
+from psutil.tests import APPVEYOR
+from psutil.tests import CI_TESTING
+from psutil.tests import DEVNULL
+from psutil.tests import HAS_BATTERY
+from psutil.tests import HAS_MEMORY_MAPS
+from psutil.tests import HAS_NET_IO_COUNTERS
+from psutil.tests import HAS_SENSORS_BATTERY
+from psutil.tests import HAS_SENSORS_FANS
+from psutil.tests import HAS_SENSORS_TEMPERATURES
+from psutil.tests import import_module_by_path
+from psutil.tests import mock
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYTHON_EXE
+from psutil.tests import reload_module
+from psutil.tests import ROOT_DIR
+from psutil.tests import SCRIPTS_DIR
+from psutil.tests import sh
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+import psutil
+import psutil.tests
+
+
+# ===================================================================
+# --- Misc / generic tests.
+# ===================================================================
+
+
+class TestMisc(PsutilTestCase):
+
+    def test_process__repr__(self, func=repr):
+        p = psutil.Process(self.spawn_testproc().pid)
+        r = func(p)
+        self.assertIn("psutil.Process", r)
+        self.assertIn("pid=%s" % p.pid, r)
+        self.assertIn("name='%s'" % p.name(), r)
+        self.assertIn("status=", r)
+        self.assertNotIn("exitcode=", r)
+        p.terminate()
+        p.wait()
+        r = func(p)
+        self.assertIn("status='terminated'", r)
+        self.assertIn("exitcode=", r)
+
+        with mock.patch.object(psutil.Process, "name",
+                               side_effect=psutil.ZombieProcess(os.getpid())):
+            p = psutil.Process()
+            r = func(p)
+            self.assertIn("pid=%s" % p.pid, r)
+            self.assertIn("status='zombie'", r)
+            self.assertNotIn("name=", r)
+        with mock.patch.object(psutil.Process, "name",
+                               side_effect=psutil.NoSuchProcess(os.getpid())):
+            p = psutil.Process()
+            r = func(p)
+            self.assertIn("pid=%s" % p.pid, r)
+            self.assertIn("terminated", r)
+            self.assertNotIn("name=", r)
+        with mock.patch.object(psutil.Process, "name",
+                               side_effect=psutil.AccessDenied(os.getpid())):
+            p = psutil.Process()
+            r = func(p)
+            self.assertIn("pid=%s" % p.pid, r)
+            self.assertNotIn("name=", r)
+
+    def test_process__str__(self):
+        self.test_process__repr__(func=str)
+
+    def test_no_such_process__repr__(self, func=repr):
+        self.assertEqual(
+            repr(psutil.NoSuchProcess(321)),
+            "psutil.NoSuchProcess process no longer exists (pid=321)")
+        self.assertEqual(
+            repr(psutil.NoSuchProcess(321, name='foo')),
+            "psutil.NoSuchProcess process no longer exists (pid=321, "
+            "name='foo')")
+        self.assertEqual(
+            repr(psutil.NoSuchProcess(321, msg='foo')),
+            "psutil.NoSuchProcess foo")
+
+    def test_zombie_process__repr__(self, func=repr):
+        self.assertEqual(
+            repr(psutil.ZombieProcess(321)),
+            "psutil.ZombieProcess process still exists but it's a zombie "
+            "(pid=321)")
+        self.assertEqual(
+            repr(psutil.ZombieProcess(321, name='foo')),
+            "psutil.ZombieProcess process still exists but it's a zombie "
+            "(pid=321, name='foo')")
+        self.assertEqual(
+            repr(psutil.ZombieProcess(321, name='foo', ppid=1)),
+            "psutil.ZombieProcess process still exists but it's a zombie "
+            "(pid=321, name='foo', ppid=1)")
+        self.assertEqual(
+            repr(psutil.ZombieProcess(321, msg='foo')),
+            "psutil.ZombieProcess foo")
+
+    def test_access_denied__repr__(self, func=repr):
+        self.assertEqual(
+            repr(psutil.AccessDenied(321)),
+            "psutil.AccessDenied (pid=321)")
+        self.assertEqual(
+            repr(psutil.AccessDenied(321, name='foo')),
+            "psutil.AccessDenied (pid=321, name='foo')")
+        self.assertEqual(
+            repr(psutil.AccessDenied(321, msg='foo')),
+            "psutil.AccessDenied foo")
+
+    def test_timeout_expired__repr__(self, func=repr):
+        self.assertEqual(
+            repr(psutil.TimeoutExpired(321)),
+            "psutil.TimeoutExpired timeout after 321 seconds")
+        self.assertEqual(
+            repr(psutil.TimeoutExpired(321, pid=111)),
+            "psutil.TimeoutExpired timeout after 321 seconds (pid=111)")
+        self.assertEqual(
+            repr(psutil.TimeoutExpired(321, pid=111, name='foo')),
+            "psutil.TimeoutExpired timeout after 321 seconds "
+            "(pid=111, name='foo')")
+
+    def test_process__eq__(self):
+        p1 = psutil.Process()
+        p2 = psutil.Process()
+        self.assertEqual(p1, p2)
+        p2._ident = (0, 0)
+        self.assertNotEqual(p1, p2)
+        self.assertNotEqual(p1, 'foo')
+
+    def test_process__hash__(self):
+        s = set([psutil.Process(), psutil.Process()])
+        self.assertEqual(len(s), 1)
+
+    def test__all__(self):
+        dir_psutil = dir(psutil)
+        for name in dir_psutil:
+            if name in ('long', 'tests', 'test', 'PermissionError',
+                        'ProcessLookupError'):
+                continue
+            if not name.startswith('_'):
+                try:
+                    __import__(name)
+                except ImportError:
+                    if name not in psutil.__all__:
+                        fun = getattr(psutil, name)
+                        if fun is None:
+                            continue
+                        if (fun.__doc__ is not None and
+                                'deprecated' not in fun.__doc__.lower()):
+                            self.fail('%r not in psutil.__all__' % name)
+
+        # Import 'star' will break if __all__ is inconsistent, see:
+        # https://github.com/giampaolo/psutil/issues/656
+        # Can't do `from psutil import *` as it won't work on python 3
+        # so we simply iterate over __all__.
+        for name in psutil.__all__:
+            self.assertIn(name, dir_psutil)
+
+    def test_version(self):
+        self.assertEqual('.'.join([str(x) for x in psutil.version_info]),
+                         psutil.__version__)
+
+    def test_process_as_dict_no_new_names(self):
+        # See https://github.com/giampaolo/psutil/issues/813
+        p = psutil.Process()
+        p.foo = '1'
+        self.assertNotIn('foo', p.as_dict())
+
+    def test_memoize(self):
+        @memoize
+        def foo(*args, **kwargs):
+            "foo docstring"
+            calls.append(None)
+            return (args, kwargs)
+
+        calls = []
+        # no args
+        for x in range(2):
+            ret = foo()
+            expected = ((), {})
+            self.assertEqual(ret, expected)
+            self.assertEqual(len(calls), 1)
+        # with args
+        for x in range(2):
+            ret = foo(1)
+            expected = ((1, ), {})
+            self.assertEqual(ret, expected)
+            self.assertEqual(len(calls), 2)
+        # with args + kwargs
+        for x in range(2):
+            ret = foo(1, bar=2)
+            expected = ((1, ), {'bar': 2})
+            self.assertEqual(ret, expected)
+            self.assertEqual(len(calls), 3)
+        # clear cache
+        foo.cache_clear()
+        ret = foo()
+        expected = ((), {})
+        self.assertEqual(ret, expected)
+        self.assertEqual(len(calls), 4)
+        # docstring
+        self.assertEqual(foo.__doc__, "foo docstring")
+
+    def test_memoize_when_activated(self):
+        class Foo:
+
+            @memoize_when_activated
+            def foo(self):
+                calls.append(None)
+
+        f = Foo()
+        calls = []
+        f.foo()
+        f.foo()
+        self.assertEqual(len(calls), 2)
+
+        # activate
+        calls = []
+        f.foo.cache_activate(f)
+        f.foo()
+        f.foo()
+        self.assertEqual(len(calls), 1)
+
+        # deactivate
+        calls = []
+        f.foo.cache_deactivate(f)
+        f.foo()
+        f.foo()
+        self.assertEqual(len(calls), 2)
+
+    def test_parse_environ_block(self):
+        from psutil._common import parse_environ_block
+
+        def k(s):
+            return s.upper() if WINDOWS else s
+
+        self.assertEqual(parse_environ_block("a=1\0"),
+                         {k("a"): "1"})
+        self.assertEqual(parse_environ_block("a=1\0b=2\0\0"),
+                         {k("a"): "1", k("b"): "2"})
+        self.assertEqual(parse_environ_block("a=1\0b=\0\0"),
+                         {k("a"): "1", k("b"): ""})
+        # ignore everything after \0\0
+        self.assertEqual(parse_environ_block("a=1\0b=2\0\0c=3\0"),
+                         {k("a"): "1", k("b"): "2"})
+        # ignore everything that is not an assignment
+        self.assertEqual(parse_environ_block("xxx\0a=1\0"), {k("a"): "1"})
+        self.assertEqual(parse_environ_block("a=1\0=b=2\0"), {k("a"): "1"})
+        # do not fail if the block is incomplete
+        self.assertEqual(parse_environ_block("a=1\0b=2"), {k("a"): "1"})
+
+    def test_supports_ipv6(self):
+        self.addCleanup(supports_ipv6.cache_clear)
+        if supports_ipv6():
+            with mock.patch('psutil._common.socket') as s:
+                s.has_ipv6 = False
+                supports_ipv6.cache_clear()
+                assert not supports_ipv6()
+
+            supports_ipv6.cache_clear()
+            with mock.patch('psutil._common.socket.socket',
+                            side_effect=socket.error) as s:
+                assert not supports_ipv6()
+                assert s.called
+
+            supports_ipv6.cache_clear()
+            with mock.patch('psutil._common.socket.socket',
+                            side_effect=socket.gaierror) as s:
+                assert not supports_ipv6()
+                supports_ipv6.cache_clear()
+                assert s.called
+
+            supports_ipv6.cache_clear()
+            with mock.patch('psutil._common.socket.socket.bind',
+                            side_effect=socket.gaierror) as s:
+                assert not supports_ipv6()
+                supports_ipv6.cache_clear()
+                assert s.called
+        else:
+            with self.assertRaises(Exception):
+                sock = socket.socket(socket.AF_INET6, socket.SOCK_STREAM)
+                try:
+                    sock.bind(("::1", 0))
+                finally:
+                    sock.close()
+
+    def test_isfile_strict(self):
+        from psutil._common import isfile_strict
+        this_file = os.path.abspath(__file__)
+        assert isfile_strict(this_file)
+        assert not isfile_strict(os.path.dirname(this_file))
+        with mock.patch('psutil._common.os.stat',
+                        side_effect=OSError(errno.EPERM, "foo")):
+            self.assertRaises(OSError, isfile_strict, this_file)
+        with mock.patch('psutil._common.os.stat',
+                        side_effect=OSError(errno.EACCES, "foo")):
+            self.assertRaises(OSError, isfile_strict, this_file)
+        with mock.patch('psutil._common.os.stat',
+                        side_effect=OSError(errno.ENOENT, "foo")):
+            assert not isfile_strict(this_file)
+        with mock.patch('psutil._common.stat.S_ISREG', return_value=False):
+            assert not isfile_strict(this_file)
+
+    def test_serialization(self):
+        def check(ret):
+            if json is not None:
+                json.loads(json.dumps(ret))
+            a = pickle.dumps(ret)
+            b = pickle.loads(a)
+            self.assertEqual(ret, b)
+
+        check(psutil.Process().as_dict())
+        check(psutil.virtual_memory())
+        check(psutil.swap_memory())
+        check(psutil.cpu_times())
+        check(psutil.cpu_times_percent(interval=0))
+        check(psutil.net_io_counters())
+        if LINUX and not os.path.exists('/proc/diskstats'):
+            pass
+        else:
+            if not APPVEYOR:
+                check(psutil.disk_io_counters())
+        check(psutil.disk_partitions())
+        check(psutil.disk_usage(os.getcwd()))
+        check(psutil.users())
+
+    def test_setup_script(self):
+        setup_py = os.path.join(ROOT_DIR, 'setup.py')
+        if CI_TESTING and not os.path.exists(setup_py):
+            return self.skipTest("can't find setup.py")
+        module = import_module_by_path(setup_py)
+        self.assertRaises(SystemExit, module.setup)
+        self.assertEqual(module.get_version(), psutil.__version__)
+
+    def test_ad_on_process_creation(self):
+        # We are supposed to be able to instantiate Process also in case
+        # of zombie processes or access denied.
+        with mock.patch.object(psutil.Process, 'create_time',
+                               side_effect=psutil.AccessDenied) as meth:
+            psutil.Process()
+            assert meth.called
+        with mock.patch.object(psutil.Process, 'create_time',
+                               side_effect=psutil.ZombieProcess(1)) as meth:
+            psutil.Process()
+            assert meth.called
+        with mock.patch.object(psutil.Process, 'create_time',
+                               side_effect=ValueError) as meth:
+            with self.assertRaises(ValueError):
+                psutil.Process()
+            assert meth.called
+
+    def test_sanity_version_check(self):
+        # see: https://github.com/giampaolo/psutil/issues/564
+        with mock.patch(
+                "psutil._psplatform.cext.version", return_value="0.0.0"):
+            with self.assertRaises(ImportError) as cm:
+                reload_module(psutil)
+            self.assertIn("version conflict", str(cm.exception).lower())
+
+
+# ===================================================================
+# --- Tests for wrap_numbers() function.
+# ===================================================================
+
+
+nt = collections.namedtuple('foo', 'a b c')
+
+
+class TestWrapNumbers(PsutilTestCase):
+
+    def setUp(self):
+        wrap_numbers.cache_clear()
+
+    tearDown = setUp
+
+    def test_first_call(self):
+        input = {'disk1': nt(5, 5, 5)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+
+    def test_input_hasnt_changed(self):
+        input = {'disk1': nt(5, 5, 5)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+
+    def test_increase_but_no_wrap(self):
+        input = {'disk1': nt(5, 5, 5)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        input = {'disk1': nt(10, 15, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        input = {'disk1': nt(20, 25, 30)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        input = {'disk1': nt(20, 25, 30)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+
+    def test_wrap(self):
+        # let's say 100 is the threshold
+        input = {'disk1': nt(100, 100, 100)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        # first wrap restarts from 10
+        input = {'disk1': nt(100, 100, 10)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(100, 100, 110)})
+        # then it remains the same
+        input = {'disk1': nt(100, 100, 10)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(100, 100, 110)})
+        # then it goes up
+        input = {'disk1': nt(100, 100, 90)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(100, 100, 190)})
+        # then it wraps again
+        input = {'disk1': nt(100, 100, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(100, 100, 210)})
+        # and remains the same
+        input = {'disk1': nt(100, 100, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(100, 100, 210)})
+        # now wrap another num
+        input = {'disk1': nt(50, 100, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(150, 100, 210)})
+        # and again
+        input = {'disk1': nt(40, 100, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(190, 100, 210)})
+        # keep it the same
+        input = {'disk1': nt(40, 100, 20)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(190, 100, 210)})
+
+    def test_changing_keys(self):
+        # Emulate a case where the second call to disk_io()
+        # (or whatever) provides a new disk, then the new disk
+        # disappears on the third call.
+        input = {'disk1': nt(5, 5, 5)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        input = {'disk1': nt(5, 5, 5),
+                 'disk2': nt(7, 7, 7)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        input = {'disk1': nt(8, 8, 8)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+
+    def test_changing_keys_w_wrap(self):
+        input = {'disk1': nt(50, 50, 50),
+                 'disk2': nt(100, 100, 100)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        # disk 2 wraps
+        input = {'disk1': nt(50, 50, 50),
+                 'disk2': nt(100, 100, 10)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(50, 50, 50),
+                          'disk2': nt(100, 100, 110)})
+        # disk 2 disappears
+        input = {'disk1': nt(50, 50, 50)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+
+        # then it appears again; the old wrap is supposed to be
+        # gone.
+        input = {'disk1': nt(50, 50, 50),
+                 'disk2': nt(100, 100, 100)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        # remains the same
+        input = {'disk1': nt(50, 50, 50),
+                 'disk2': nt(100, 100, 100)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'), input)
+        # and then wraps again
+        input = {'disk1': nt(50, 50, 50),
+                 'disk2': nt(100, 100, 10)}
+        self.assertEqual(wrap_numbers(input, 'disk_io'),
+                         {'disk1': nt(50, 50, 50),
+                          'disk2': nt(100, 100, 110)})
+
+    def test_real_data(self):
+        d = {'nvme0n1': (300, 508, 640, 1571, 5970, 1987, 2049, 451751, 47048),
+             'nvme0n1p1': (1171, 2, 5600256, 1024, 516, 0, 0, 0, 8),
+             'nvme0n1p2': (54, 54, 2396160, 5165056, 4, 24, 30, 1207, 28),
+             'nvme0n1p3': (2389, 4539, 5154, 150, 4828, 1844, 2019, 398, 348)}
+        self.assertEqual(wrap_numbers(d, 'disk_io'), d)
+        self.assertEqual(wrap_numbers(d, 'disk_io'), d)
+        # decrease this   ↓
+        d = {'nvme0n1': (100, 508, 640, 1571, 5970, 1987, 2049, 451751, 47048),
+             'nvme0n1p1': (1171, 2, 5600256, 1024, 516, 0, 0, 0, 8),
+             'nvme0n1p2': (54, 54, 2396160, 5165056, 4, 24, 30, 1207, 28),
+             'nvme0n1p3': (2389, 4539, 5154, 150, 4828, 1844, 2019, 398, 348)}
+        out = wrap_numbers(d, 'disk_io')
+        self.assertEqual(out['nvme0n1'][0], 400)
+
+    # --- cache tests
+
+    def test_cache_first_call(self):
+        input = {'disk1': nt(5, 5, 5)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        self.assertEqual(cache[1], {'disk_io': {}})
+        self.assertEqual(cache[2], {'disk_io': {}})
+
+    def test_cache_call_twice(self):
+        input = {'disk1': nt(5, 5, 5)}
+        wrap_numbers(input, 'disk_io')
+        input = {'disk1': nt(10, 10, 10)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        self.assertEqual(
+            cache[1],
+            {'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 0}})
+        self.assertEqual(cache[2], {'disk_io': {}})
+
+    def test_cache_wrap(self):
+        # let's say 100 is the threshold
+        input = {'disk1': nt(100, 100, 100)}
+        wrap_numbers(input, 'disk_io')
+
+        # first wrap restarts from 10
+        input = {'disk1': nt(100, 100, 10)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        self.assertEqual(
+            cache[1],
+            {'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 100}})
+        self.assertEqual(cache[2], {'disk_io': {'disk1': set([('disk1', 2)])}})
+
+        def assert_():
+            cache = wrap_numbers.cache_info()
+            self.assertEqual(
+                cache[1],
+                {'disk_io': {('disk1', 0): 0, ('disk1', 1): 0,
+                             ('disk1', 2): 100}})
+            self.assertEqual(cache[2],
+                             {'disk_io': {'disk1': set([('disk1', 2)])}})
+
+        # then it remains the same
+        input = {'disk1': nt(100, 100, 10)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        assert_()
+
+        # then it goes up
+        input = {'disk1': nt(100, 100, 90)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        assert_()
+
+        # then it wraps again
+        input = {'disk1': nt(100, 100, 20)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        self.assertEqual(
+            cache[1],
+            {'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 190}})
+        self.assertEqual(cache[2], {'disk_io': {'disk1': set([('disk1', 2)])}})
+
+    def test_cache_changing_keys(self):
+        input = {'disk1': nt(5, 5, 5)}
+        wrap_numbers(input, 'disk_io')
+        input = {'disk1': nt(5, 5, 5),
+                 'disk2': nt(7, 7, 7)}
+        wrap_numbers(input, 'disk_io')
+        cache = wrap_numbers.cache_info()
+        self.assertEqual(cache[0], {'disk_io': input})
+        self.assertEqual(
+            cache[1],
+            {'disk_io': {('disk1', 0): 0, ('disk1', 1): 0, ('disk1', 2): 0}})
+        self.assertEqual(cache[2], {'disk_io': {}})
+
+    def test_cache_clear(self):
+        input = {'disk1': nt(5, 5, 5)}
+        wrap_numbers(input, 'disk_io')
+        wrap_numbers(input, 'disk_io')
+        wrap_numbers.cache_clear('disk_io')
+        self.assertEqual(wrap_numbers.cache_info(), ({}, {}, {}))
+        wrap_numbers.cache_clear('disk_io')
+        wrap_numbers.cache_clear('?!?')
+
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, 'not supported')
+    def test_cache_clear_public_apis(self):
+        if not psutil.disk_io_counters() or not psutil.net_io_counters():
+            return self.skipTest("no disks or NICs available")
+        psutil.disk_io_counters()
+        psutil.net_io_counters()
+        caches = wrap_numbers.cache_info()
+        for cache in caches:
+            self.assertIn('psutil.disk_io_counters', cache)
+            self.assertIn('psutil.net_io_counters', cache)
+
+        psutil.disk_io_counters.cache_clear()
+        caches = wrap_numbers.cache_info()
+        for cache in caches:
+            self.assertIn('psutil.net_io_counters', cache)
+            self.assertNotIn('psutil.disk_io_counters', cache)
+
+        psutil.net_io_counters.cache_clear()
+        caches = wrap_numbers.cache_info()
+        self.assertEqual(caches, ({}, {}, {}))
+
+
+# ===================================================================
+# --- Example script tests
+# ===================================================================
+
+
+@unittest.skipIf(not os.path.exists(SCRIPTS_DIR),
+                 "can't locate scripts directory")
+class TestScripts(PsutilTestCase):
+    """Tests for scripts in the "scripts" directory."""
+
+    @staticmethod
+    def assert_stdout(exe, *args, **kwargs):
+        exe = '%s' % os.path.join(SCRIPTS_DIR, exe)
+        cmd = [PYTHON_EXE, exe]
+        for arg in args:
+            cmd.append(arg)
+        try:
+            out = sh(cmd, **kwargs).strip()
+        except RuntimeError as err:
+            if 'AccessDenied' in str(err):
+                return str(err)
+            else:
+                raise
+        assert out, out
+        return out
+
+    @staticmethod
+    def assert_syntax(exe, args=None):
+        exe = os.path.join(SCRIPTS_DIR, exe)
+        if PY3:
+            f = open(exe, 'rt', encoding='utf8')
+        else:
+            f = open(exe, 'rt')
+        with f:
+            src = f.read()
+        ast.parse(src)
+
+    def test_coverage(self):
+        # make sure all example scripts have a test method defined
+        meths = dir(self)
+        for name in os.listdir(SCRIPTS_DIR):
+            if name.endswith('.py'):
+                if 'test_' + os.path.splitext(name)[0] not in meths:
+                    # self.assert_stdout(name)
+                    self.fail('no test defined for %r script'
+                              % os.path.join(SCRIPTS_DIR, name))
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    def test_executable(self):
+        for name in os.listdir(SCRIPTS_DIR):
+            if name.endswith('.py'):
+                path = os.path.join(SCRIPTS_DIR, name)
+                if not stat.S_IXUSR & os.stat(path)[stat.ST_MODE]:
+                    self.fail('%r is not executable' % path)
+
+    def test_disk_usage(self):
+        self.assert_stdout('disk_usage.py')
+
+    def test_free(self):
+        self.assert_stdout('free.py')
+
+    def test_meminfo(self):
+        self.assert_stdout('meminfo.py')
+
+    def test_procinfo(self):
+        self.assert_stdout('procinfo.py', str(os.getpid()))
+
+    @unittest.skipIf(CI_TESTING and not psutil.users(), "no users")
+    def test_who(self):
+        self.assert_stdout('who.py')
+
+    def test_ps(self):
+        self.assert_stdout('ps.py')
+
+    def test_pstree(self):
+        self.assert_stdout('pstree.py')
+
+    def test_netstat(self):
+        self.assert_stdout('netstat.py')
+
+    # permission denied on travis
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    def test_ifconfig(self):
+        self.assert_stdout('ifconfig.py')
+
+    @unittest.skipIf(not HAS_MEMORY_MAPS, "not supported")
+    def test_pmap(self):
+        self.assert_stdout('pmap.py', str(os.getpid()))
+
+    def test_procsmem(self):
+        if 'uss' not in psutil.Process().memory_full_info()._fields:
+            raise self.skipTest("not supported")
+        self.assert_stdout('procsmem.py', stderr=DEVNULL)
+
+    def test_killall(self):
+        self.assert_syntax('killall.py')
+
+    def test_nettop(self):
+        self.assert_syntax('nettop.py')
+
+    def test_top(self):
+        self.assert_syntax('top.py')
+
+    def test_iotop(self):
+        self.assert_syntax('iotop.py')
+
+    def test_pidof(self):
+        output = self.assert_stdout('pidof.py', psutil.Process().name())
+        self.assertIn(str(os.getpid()), output)
+
+    @unittest.skipIf(not WINDOWS, "WINDOWS only")
+    def test_winservices(self):
+        self.assert_stdout('winservices.py')
+
+    def test_cpu_distribution(self):
+        self.assert_syntax('cpu_distribution.py')
+
+    @unittest.skipIf(not HAS_SENSORS_TEMPERATURES, "not supported")
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    def test_temperatures(self):
+        if not psutil.sensors_temperatures():
+            self.skipTest("no temperatures")
+        self.assert_stdout('temperatures.py')
+
+    @unittest.skipIf(not HAS_SENSORS_FANS, "not supported")
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    def test_fans(self):
+        if not psutil.sensors_fans():
+            self.skipTest("no fans")
+        self.assert_stdout('fans.py')
+
+    @unittest.skipIf(not HAS_SENSORS_BATTERY, "not supported")
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_battery(self):
+        self.assert_stdout('battery.py')
+
+    @unittest.skipIf(not HAS_SENSORS_BATTERY, "not supported")
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_sensors(self):
+        self.assert_stdout('sensors.py')
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_osx.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_osx.py
new file mode 100644
index 0000000000000000000000000000000000000000..097bff10842f72e726c6b216da3880828f02f035
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_osx.py
@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""MACOS specific tests."""
+
+import os
+import re
+import time
+
+import psutil
+from psutil import MACOS
+from psutil.tests import HAS_BATTERY
+from psutil.tests import PsutilTestCase
+from psutil.tests import retry_on_failure
+from psutil.tests import sh
+from psutil.tests import spawn_testproc
+from psutil.tests import terminate
+from psutil.tests import TOLERANCE_DISK_USAGE
+from psutil.tests import TOLERANCE_SYS_MEM
+from psutil.tests import unittest
+
+
+PAGESIZE = os.sysconf("SC_PAGE_SIZE") if MACOS else None
+
+
+def sysctl(cmdline):
+    """Expects a sysctl command with an argument and parse the result
+    returning only the value of interest.
+    """
+    out = sh(cmdline)
+    result = out.split()[1]
+    try:
+        return int(result)
+    except ValueError:
+        return result
+
+
+def vm_stat(field):
+    """Wrapper around 'vm_stat' cmdline utility."""
+    out = sh('vm_stat')
+    for line in out.split('\n'):
+        if field in line:
+            break
+    else:
+        raise ValueError("line not found")
+    return int(re.search(r'\d+', line).group(0)) * PAGESIZE
+
+
+# http://code.activestate.com/recipes/578019/
+def human2bytes(s):
+    SYMBOLS = {
+        'customary': ('B', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y'),
+    }
+    init = s
+    num = ""
+    while s and s[0:1].isdigit() or s[0:1] == '.':
+        num += s[0]
+        s = s[1:]
+    num = float(num)
+    letter = s.strip()
+    for name, sset in SYMBOLS.items():
+        if letter in sset:
+            break
+    else:
+        if letter == 'k':
+            sset = SYMBOLS['customary']
+            letter = letter.upper()
+        else:
+            raise ValueError("can't interpret %r" % init)
+    prefix = {sset[0]: 1}
+    for i, s in enumerate(sset[1:]):
+        prefix[s] = 1 << (i + 1) * 10
+    return int(num * prefix[letter])
+
+
+@unittest.skipIf(not MACOS, "MACOS only")
+class TestProcess(PsutilTestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    def test_process_create_time(self):
+        output = sh("ps -o lstart -p %s" % self.pid)
+        start_ps = output.replace('STARTED', '').strip()
+        hhmmss = start_ps.split(' ')[-2]
+        year = start_ps.split(' ')[-1]
+        start_psutil = psutil.Process(self.pid).create_time()
+        self.assertEqual(
+            hhmmss,
+            time.strftime("%H:%M:%S", time.localtime(start_psutil)))
+        self.assertEqual(
+            year,
+            time.strftime("%Y", time.localtime(start_psutil)))
+
+
+@unittest.skipIf(not MACOS, "MACOS only")
+class TestSystemAPIs(PsutilTestCase):
+
+    # --- disk
+
+    @retry_on_failure()
+    def test_disks(self):
+        # test psutil.disk_usage() and psutil.disk_partitions()
+        # against "df -a"
+        def df(path):
+            out = sh('df -k "%s"' % path).strip()
+            lines = out.split('\n')
+            lines.pop(0)
+            line = lines.pop(0)
+            dev, total, used, free = line.split()[:4]
+            if dev == 'none':
+                dev = ''
+            total = int(total) * 1024
+            used = int(used) * 1024
+            free = int(free) * 1024
+            return dev, total, used, free
+
+        for part in psutil.disk_partitions(all=False):
+            usage = psutil.disk_usage(part.mountpoint)
+            dev, total, used, free = df(part.mountpoint)
+            self.assertEqual(part.device, dev)
+            self.assertEqual(usage.total, total)
+            self.assertAlmostEqual(usage.free, free,
+                                   delta=TOLERANCE_DISK_USAGE)
+            self.assertAlmostEqual(usage.used, used,
+                                   delta=TOLERANCE_DISK_USAGE)
+
+    # --- cpu
+
+    def test_cpu_count_logical(self):
+        num = sysctl("sysctl hw.logicalcpu")
+        self.assertEqual(num, psutil.cpu_count(logical=True))
+
+    def test_cpu_count_physical(self):
+        num = sysctl("sysctl hw.physicalcpu")
+        self.assertEqual(num, psutil.cpu_count(logical=False))
+
+    def test_cpu_freq(self):
+        freq = psutil.cpu_freq()
+        self.assertEqual(
+            freq.current * 1000 * 1000, sysctl("sysctl hw.cpufrequency"))
+        self.assertEqual(
+            freq.min * 1000 * 1000, sysctl("sysctl hw.cpufrequency_min"))
+        self.assertEqual(
+            freq.max * 1000 * 1000, sysctl("sysctl hw.cpufrequency_max"))
+
+    # --- virtual mem
+
+    def test_vmem_total(self):
+        sysctl_hwphymem = sysctl('sysctl hw.memsize')
+        self.assertEqual(sysctl_hwphymem, psutil.virtual_memory().total)
+
+    @retry_on_failure()
+    def test_vmem_free(self):
+        vmstat_val = vm_stat("free")
+        psutil_val = psutil.virtual_memory().free
+        self.assertAlmostEqual(psutil_val, vmstat_val, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_active(self):
+        vmstat_val = vm_stat("active")
+        psutil_val = psutil.virtual_memory().active
+        self.assertAlmostEqual(psutil_val, vmstat_val, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_inactive(self):
+        vmstat_val = vm_stat("inactive")
+        psutil_val = psutil.virtual_memory().inactive
+        self.assertAlmostEqual(psutil_val, vmstat_val, delta=TOLERANCE_SYS_MEM)
+
+    @retry_on_failure()
+    def test_vmem_wired(self):
+        vmstat_val = vm_stat("wired")
+        psutil_val = psutil.virtual_memory().wired
+        self.assertAlmostEqual(psutil_val, vmstat_val, delta=TOLERANCE_SYS_MEM)
+
+    # --- swap mem
+
+    @retry_on_failure()
+    def test_swapmem_sin(self):
+        vmstat_val = vm_stat("Pageins")
+        psutil_val = psutil.swap_memory().sin
+        self.assertEqual(psutil_val, vmstat_val)
+
+    @retry_on_failure()
+    def test_swapmem_sout(self):
+        vmstat_val = vm_stat("Pageout")
+        psutil_val = psutil.swap_memory().sout
+        self.assertEqual(psutil_val, vmstat_val)
+
+    # Not very reliable.
+    # def test_swapmem_total(self):
+    #     out = sh('sysctl vm.swapusage')
+    #     out = out.replace('vm.swapusage: ', '')
+    #     total, used, free = re.findall('\d+.\d+\w', out)
+    #     psutil_smem = psutil.swap_memory()
+    #     self.assertEqual(psutil_smem.total, human2bytes(total))
+    #     self.assertEqual(psutil_smem.used, human2bytes(used))
+    #     self.assertEqual(psutil_smem.free, human2bytes(free))
+
+    # --- network
+
+    def test_net_if_stats(self):
+        for name, stats in psutil.net_if_stats().items():
+            try:
+                out = sh("ifconfig %s" % name)
+            except RuntimeError:
+                pass
+            else:
+                self.assertEqual(stats.isup, 'RUNNING' in out, msg=out)
+                self.assertEqual(stats.mtu,
+                                 int(re.findall(r'mtu (\d+)', out)[0]))
+
+    # --- sensors_battery
+
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_sensors_battery(self):
+        out = sh("pmset -g batt")
+        percent = re.search(r"(\d+)%", out).group(1)
+        drawing_from = re.search("Now drawing from '([^']+)'", out).group(1)
+        power_plugged = drawing_from == "AC Power"
+        psutil_result = psutil.sensors_battery()
+        self.assertEqual(psutil_result.power_plugged, power_plugged)
+        self.assertEqual(psutil_result.percent, int(percent))
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_posix.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_posix.py
new file mode 100644
index 0000000000000000000000000000000000000000..e2d18ccb9fdda941f471719cd0b7636d444fd334
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_posix.py
@@ -0,0 +1,410 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""POSIX specific tests."""
+
+import datetime
+import errno
+import os
+import re
+import subprocess
+import time
+
+import psutil
+from psutil import AIX
+from psutil import BSD
+from psutil import LINUX
+from psutil import MACOS
+from psutil import OPENBSD
+from psutil import POSIX
+from psutil import SUNOS
+from psutil.tests import CI_TESTING
+from psutil.tests import spawn_testproc
+from psutil.tests import HAS_NET_IO_COUNTERS
+from psutil.tests import mock
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYTHON_EXE
+from psutil.tests import retry_on_failure
+from psutil.tests import sh
+from psutil.tests import skip_on_access_denied
+from psutil.tests import terminate
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+from psutil.tests import which
+
+
+def ps(fmt, pid=None):
+    """
+    Wrapper for calling the ps command with a little bit of cross-platform
+    support for a narrow range of features.
+    """
+
+    cmd = ['ps']
+
+    if LINUX:
+        cmd.append('--no-headers')
+
+    if pid is not None:
+        cmd.extend(['-p', str(pid)])
+    else:
+        if SUNOS or AIX:
+            cmd.append('-A')
+        else:
+            cmd.append('ax')
+
+    if SUNOS:
+        fmt_map = set(('command', 'comm', 'start', 'stime'))
+        fmt = fmt_map.get(fmt, fmt)
+
+    cmd.extend(['-o', fmt])
+
+    output = sh(cmd)
+
+    if LINUX:
+        output = output.splitlines()
+    else:
+        output = output.splitlines()[1:]
+
+    all_output = []
+    for line in output:
+        line = line.strip()
+
+        try:
+            line = int(line)
+        except ValueError:
+            pass
+
+        all_output.append(line)
+
+    if pid is None:
+        return all_output
+    else:
+        return all_output[0]
+
+# ps "-o" field names differ wildly between platforms.
+# "comm" means "only executable name" but is not available on BSD platforms.
+# "args" means "command with all its arguments", and is also not available
+# on BSD platforms.
+# "command" is like "args" on most platforms, but like "comm" on AIX,
+# and not available on SUNOS.
+# so for the executable name we can use "comm" on Solaris and split "command"
+# on other platforms.
+# to get the cmdline (with args) we have to use "args" on AIX and
+# Solaris, and can use "command" on all others.
+
+
+def ps_name(pid):
+    field = "command"
+    if SUNOS:
+        field = "comm"
+    return ps(field, pid).split()[0]
+
+
+def ps_args(pid):
+    field = "command"
+    if AIX or SUNOS:
+        field = "args"
+    return ps(field, pid)
+
+
+def ps_rss(pid):
+    field = "rss"
+    if AIX:
+        field = "rssize"
+    return ps(field, pid)
+
+
+def ps_vsz(pid):
+    field = "vsz"
+    if AIX:
+        field = "vsize"
+    return ps(field, pid)
+
+
+@unittest.skipIf(not POSIX, "POSIX only")
+class TestProcess(PsutilTestCase):
+    """Compare psutil results against 'ps' command line utility (mainly)."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc([PYTHON_EXE, "-E", "-O"],
+                                 stdin=subprocess.PIPE).pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    def test_ppid(self):
+        ppid_ps = ps('ppid', self.pid)
+        ppid_psutil = psutil.Process(self.pid).ppid()
+        self.assertEqual(ppid_ps, ppid_psutil)
+
+    def test_uid(self):
+        uid_ps = ps('uid', self.pid)
+        uid_psutil = psutil.Process(self.pid).uids().real
+        self.assertEqual(uid_ps, uid_psutil)
+
+    def test_gid(self):
+        gid_ps = ps('rgid', self.pid)
+        gid_psutil = psutil.Process(self.pid).gids().real
+        self.assertEqual(gid_ps, gid_psutil)
+
+    def test_username(self):
+        username_ps = ps('user', self.pid)
+        username_psutil = psutil.Process(self.pid).username()
+        self.assertEqual(username_ps, username_psutil)
+
+    def test_username_no_resolution(self):
+        # Emulate a case where the system can't resolve the uid to
+        # a username in which case psutil is supposed to return
+        # the stringified uid.
+        p = psutil.Process()
+        with mock.patch("psutil.pwd.getpwuid", side_effect=KeyError) as fun:
+            self.assertEqual(p.username(), str(p.uids().real))
+            assert fun.called
+
+    @skip_on_access_denied()
+    @retry_on_failure()
+    def test_rss_memory(self):
+        # give python interpreter some time to properly initialize
+        # so that the results are the same
+        time.sleep(0.1)
+        rss_ps = ps_rss(self.pid)
+        rss_psutil = psutil.Process(self.pid).memory_info()[0] / 1024
+        self.assertEqual(rss_ps, rss_psutil)
+
+    @skip_on_access_denied()
+    @retry_on_failure()
+    def test_vsz_memory(self):
+        # give python interpreter some time to properly initialize
+        # so that the results are the same
+        time.sleep(0.1)
+        vsz_ps = ps_vsz(self.pid)
+        vsz_psutil = psutil.Process(self.pid).memory_info()[1] / 1024
+        self.assertEqual(vsz_ps, vsz_psutil)
+
+    def test_name(self):
+        name_ps = ps_name(self.pid)
+        # remove path if there is any, from the command
+        name_ps = os.path.basename(name_ps).lower()
+        name_psutil = psutil.Process(self.pid).name().lower()
+        # ...because of how we calculate PYTHON_EXE; on MACOS this may
+        # be "pythonX.Y".
+        name_ps = re.sub(r"\d.\d", "", name_ps)
+        name_psutil = re.sub(r"\d.\d", "", name_psutil)
+        # ...may also be "python.X"
+        name_ps = re.sub(r"\d", "", name_ps)
+        name_psutil = re.sub(r"\d", "", name_psutil)
+        self.assertEqual(name_ps, name_psutil)
+
+    def test_name_long(self):
+        # On UNIX the kernel truncates the name to the first 15
+        # characters. In such a case psutil tries to determine the
+        # full name from the cmdline.
+        name = "long-program-name"
+        cmdline = ["long-program-name-extended", "foo", "bar"]
+        with mock.patch("psutil._psplatform.Process.name",
+                        return_value=name):
+            with mock.patch("psutil._psplatform.Process.cmdline",
+                            return_value=cmdline):
+                p = psutil.Process()
+                self.assertEqual(p.name(), "long-program-name-extended")
+
+    def test_name_long_cmdline_ad_exc(self):
+        # Same as above but emulates a case where cmdline() raises
+        # AccessDenied in which case psutil is supposed to return
+        # the truncated name instead of crashing.
+        name = "long-program-name"
+        with mock.patch("psutil._psplatform.Process.name",
+                        return_value=name):
+            with mock.patch("psutil._psplatform.Process.cmdline",
+                            side_effect=psutil.AccessDenied(0, "")):
+                p = psutil.Process()
+                self.assertEqual(p.name(), "long-program-name")
+
+    def test_name_long_cmdline_nsp_exc(self):
+        # Same as above but emulates a case where cmdline() raises NSP
+        # which is supposed to propagate.
+        name = "long-program-name"
+        with mock.patch("psutil._psplatform.Process.name",
+                        return_value=name):
+            with mock.patch("psutil._psplatform.Process.cmdline",
+                            side_effect=psutil.NoSuchProcess(0, "")):
+                p = psutil.Process()
+                self.assertRaises(psutil.NoSuchProcess, p.name)
+
+    @unittest.skipIf(MACOS or BSD, 'ps -o start not available')
+    def test_create_time(self):
+        time_ps = ps('start', self.pid)
+        time_psutil = psutil.Process(self.pid).create_time()
+        time_psutil_tstamp = datetime.datetime.fromtimestamp(
+            time_psutil).strftime("%H:%M:%S")
+        # sometimes ps shows the time rounded up instead of down, so we check
+        # for both possible values
+        round_time_psutil = round(time_psutil)
+        round_time_psutil_tstamp = datetime.datetime.fromtimestamp(
+            round_time_psutil).strftime("%H:%M:%S")
+        self.assertIn(time_ps, [time_psutil_tstamp, round_time_psutil_tstamp])
+
+    def test_exe(self):
+        ps_pathname = ps_name(self.pid)
+        psutil_pathname = psutil.Process(self.pid).exe()
+        try:
+            self.assertEqual(ps_pathname, psutil_pathname)
+        except AssertionError:
+            # certain platforms such as BSD are more accurate returning:
+            # "/usr/local/bin/python2.7"
+            # ...instead of:
+            # "/usr/local/bin/python"
+            # We do not want to consider this difference in accuracy
+            # an error.
+            adjusted_ps_pathname = ps_pathname[:len(ps_pathname)]
+            self.assertEqual(ps_pathname, adjusted_ps_pathname)
+
+    def test_cmdline(self):
+        ps_cmdline = ps_args(self.pid)
+        psutil_cmdline = " ".join(psutil.Process(self.pid).cmdline())
+        self.assertEqual(ps_cmdline, psutil_cmdline)
+
+    # On SUNOS "ps" reads niceness /proc/pid/psinfo which returns an
+    # incorrect value (20); the real deal is getpriority(2) which
+    # returns 0; psutil relies on it, see:
+    # https://github.com/giampaolo/psutil/issues/1082
+    # AIX has the same issue
+    @unittest.skipIf(SUNOS, "not reliable on SUNOS")
+    @unittest.skipIf(AIX, "not reliable on AIX")
+    def test_nice(self):
+        ps_nice = ps('nice', self.pid)
+        psutil_nice = psutil.Process().nice()
+        self.assertEqual(ps_nice, psutil_nice)
+
+
+@unittest.skipIf(not POSIX, "POSIX only")
+class TestSystemAPIs(PsutilTestCase):
+    """Test some system APIs."""
+
+    @retry_on_failure()
+    def test_pids(self):
+        # Note: this test might fail if the OS is starting/killing
+        # other processes in the meantime
+        pids_ps = sorted(ps("pid"))
+        pids_psutil = psutil.pids()
+
+        # on MACOS and OPENBSD ps doesn't show pid 0
+        if MACOS or OPENBSD and 0 not in pids_ps:
+            pids_ps.insert(0, 0)
+
+        # There will often be one more process in pids_ps for ps itself
+        if len(pids_ps) - len(pids_psutil) > 1:
+            difference = [x for x in pids_psutil if x not in pids_ps] + \
+                         [x for x in pids_ps if x not in pids_psutil]
+            self.fail("difference: " + str(difference))
+
+    # for some reason ifconfig -a does not report all interfaces
+    # returned by psutil
+    @unittest.skipIf(SUNOS, "unreliable on SUNOS")
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")
+    @unittest.skipIf(not which('ifconfig'), "no ifconfig cmd")
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, "not supported")
+    def test_nic_names(self):
+        output = sh("ifconfig -a")
+        for nic in psutil.net_io_counters(pernic=True).keys():
+            for line in output.split():
+                if line.startswith(nic):
+                    break
+            else:
+                self.fail(
+                    "couldn't find %s nic in 'ifconfig -a' output\n%s" % (
+                        nic, output))
+
+    @unittest.skipIf(CI_TESTING and not psutil.users(), "unreliable on CI")
+    @retry_on_failure()
+    def test_users(self):
+        out = sh("who")
+        if not out.strip():
+            raise self.skipTest("no users on this system")
+        lines = out.split('\n')
+        users = [x.split()[0] for x in lines]
+        terminals = [x.split()[1] for x in lines]
+        self.assertEqual(len(users), len(psutil.users()))
+        for u in psutil.users():
+            self.assertIn(u.name, users)
+            self.assertIn(u.terminal, terminals)
+
+    def test_pid_exists_let_raise(self):
+        # According to "man 2 kill" possible error values for kill
+        # are (EINVAL, EPERM, ESRCH). Test that any other errno
+        # results in an exception.
+        with mock.patch("psutil._psposix.os.kill",
+                        side_effect=OSError(errno.EBADF, "")) as m:
+            self.assertRaises(OSError, psutil._psposix.pid_exists, os.getpid())
+            assert m.called
+
+    def test_os_waitpid_let_raise(self):
+        # os.waitpid() is supposed to catch EINTR and ECHILD only.
+        # Test that any other errno results in an exception.
+        with mock.patch("psutil._psposix.os.waitpid",
+                        side_effect=OSError(errno.EBADF, "")) as m:
+            self.assertRaises(OSError, psutil._psposix.wait_pid, os.getpid())
+            assert m.called
+
+    def test_os_waitpid_eintr(self):
+        # os.waitpid() is supposed to "retry" on EINTR.
+        with mock.patch("psutil._psposix.os.waitpid",
+                        side_effect=OSError(errno.EINTR, "")) as m:
+            self.assertRaises(
+                psutil._psposix.TimeoutExpired,
+                psutil._psposix.wait_pid, os.getpid(), timeout=0.01)
+            assert m.called
+
+    def test_os_waitpid_bad_ret_status(self):
+        # Simulate os.waitpid() returning a bad status.
+        with mock.patch("psutil._psposix.os.waitpid",
+                        return_value=(1, -1)) as m:
+            self.assertRaises(ValueError,
+                              psutil._psposix.wait_pid, os.getpid())
+            assert m.called
+
+    # AIX can return '-' in df output instead of numbers, e.g. for /proc
+    @unittest.skipIf(AIX, "unreliable on AIX")
+    def test_disk_usage(self):
+        def df(device):
+            out = sh("df -k %s" % device).strip()
+            line = out.split('\n')[1]
+            fields = line.split()
+            total = int(fields[1]) * 1024
+            used = int(fields[2]) * 1024
+            free = int(fields[3]) * 1024
+            percent = float(fields[4].replace('%', ''))
+            return (total, used, free, percent)
+
+        tolerance = 4 * 1024 * 1024  # 4MB
+        for part in psutil.disk_partitions(all=False):
+            usage = psutil.disk_usage(part.mountpoint)
+            try:
+                total, used, free, percent = df(part.device)
+            except RuntimeError as err:
+                # see:
+                # https://travis-ci.org/giampaolo/psutil/jobs/138338464
+                # https://travis-ci.org/giampaolo/psutil/jobs/138343361
+                err = str(err).lower()
+                if "no such file or directory" in err or \
+                        "raw devices not supported" in err or \
+                        "permission denied" in err:
+                    continue
+                else:
+                    raise
+            else:
+                self.assertAlmostEqual(usage.total, total, delta=tolerance)
+                self.assertAlmostEqual(usage.used, used, delta=tolerance)
+                self.assertAlmostEqual(usage.free, free, delta=tolerance)
+                self.assertAlmostEqual(usage.percent, percent, delta=1)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_process.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_process.py
new file mode 100644
index 0000000000000000000000000000000000000000..0d63979bfab9da1dd34c48f3cb7ac0ffc4c680bb
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_process.py
@@ -0,0 +1,1555 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Tests for psutil.Process class."""
+
+import collections
+import errno
+import getpass
+import itertools
+import os
+import signal
+import socket
+import stat
+import subprocess
+import sys
+import textwrap
+import time
+import types
+
+import psutil
+
+from psutil import AIX
+from psutil import BSD
+from psutil import LINUX
+from psutil import MACOS
+from psutil import NETBSD
+from psutil import OPENBSD
+from psutil import OSX
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._common import open_text
+from psutil._compat import FileNotFoundError
+from psutil._compat import long
+from psutil._compat import PY3
+from psutil._compat import super
+from psutil.tests import APPVEYOR
+from psutil.tests import call_until
+from psutil.tests import CI_TESTING
+from psutil.tests import CIRRUS
+from psutil.tests import copyload_shared_lib
+from psutil.tests import create_exe
+from psutil.tests import GITHUB_WHEELS
+from psutil.tests import GLOBAL_TIMEOUT
+from psutil.tests import HAS_CPU_AFFINITY
+from psutil.tests import HAS_ENVIRON
+from psutil.tests import HAS_IONICE
+from psutil.tests import HAS_MEMORY_MAPS
+from psutil.tests import HAS_PROC_CPU_NUM
+from psutil.tests import HAS_PROC_IO_COUNTERS
+from psutil.tests import HAS_RLIMIT
+from psutil.tests import HAS_THREADS
+from psutil.tests import mock
+from psutil.tests import process_namespace
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYPY
+from psutil.tests import PYTHON_EXE
+from psutil.tests import reap_children
+from psutil.tests import retry_on_failure
+from psutil.tests import sh
+from psutil.tests import skip_on_access_denied
+from psutil.tests import skip_on_not_implemented
+from psutil.tests import ThreadTask
+from psutil.tests import TRAVIS
+from psutil.tests import unittest
+from psutil.tests import wait_for_pid
+
+
+# ===================================================================
+# --- psutil.Process class tests
+# ===================================================================
+
+
+class TestProcess(PsutilTestCase):
+    """Tests for psutil.Process class."""
+
+    def spawn_psproc(self, *args, **kwargs):
+        sproc = self.spawn_testproc(*args, **kwargs)
+        return psutil.Process(sproc.pid)
+
+    # ---
+
+    def test_pid(self):
+        p = psutil.Process()
+        self.assertEqual(p.pid, os.getpid())
+        with self.assertRaises(AttributeError):
+            p.pid = 33
+
+    def test_kill(self):
+        p = self.spawn_psproc()
+        p.kill()
+        code = p.wait()
+        if WINDOWS:
+            self.assertEqual(code, signal.SIGTERM)
+        else:
+            self.assertEqual(code, -signal.SIGKILL)
+        self.assertProcessGone(p)
+
+    def test_terminate(self):
+        p = self.spawn_psproc()
+        p.terminate()
+        code = p.wait()
+        if WINDOWS:
+            self.assertEqual(code, signal.SIGTERM)
+        else:
+            self.assertEqual(code, -signal.SIGTERM)
+        self.assertProcessGone(p)
+
+    def test_send_signal(self):
+        sig = signal.SIGKILL if POSIX else signal.SIGTERM
+        p = self.spawn_psproc()
+        p.send_signal(sig)
+        code = p.wait()
+        if WINDOWS:
+            self.assertEqual(code, sig)
+        else:
+            self.assertEqual(code, -sig)
+        self.assertProcessGone(p)
+
+    @unittest.skipIf(not POSIX, "not POSIX")
+    def test_send_signal_mocked(self):
+        sig = signal.SIGTERM
+        p = self.spawn_psproc()
+        with mock.patch('psutil.os.kill',
+                        side_effect=OSError(errno.ESRCH, "")):
+            self.assertRaises(psutil.NoSuchProcess, p.send_signal, sig)
+
+        p = self.spawn_psproc()
+        with mock.patch('psutil.os.kill',
+                        side_effect=OSError(errno.EPERM, "")):
+            self.assertRaises(psutil.AccessDenied, p.send_signal, sig)
+
+    def test_wait_exited(self):
+        # Test waitpid() + WIFEXITED -> WEXITSTATUS.
+        # normal return, same as exit(0)
+        cmd = [PYTHON_EXE, "-c", "pass"]
+        p = self.spawn_psproc(cmd)
+        code = p.wait()
+        self.assertEqual(code, 0)
+        self.assertProcessGone(p)
+        # exit(1), implicit in case of error
+        cmd = [PYTHON_EXE, "-c", "1 / 0"]
+        p = self.spawn_psproc(cmd, stderr=subprocess.PIPE)
+        code = p.wait()
+        self.assertEqual(code, 1)
+        self.assertProcessGone(p)
+        # via sys.exit()
+        cmd = [PYTHON_EXE, "-c", "import sys; sys.exit(5);"]
+        p = self.spawn_psproc(cmd)
+        code = p.wait()
+        self.assertEqual(code, 5)
+        self.assertProcessGone(p)
+        # via os._exit()
+        cmd = [PYTHON_EXE, "-c", "import os; os._exit(5);"]
+        p = self.spawn_psproc(cmd)
+        code = p.wait()
+        self.assertEqual(code, 5)
+        self.assertProcessGone(p)
+
+    def test_wait_stopped(self):
+        p = self.spawn_psproc()
+        if POSIX:
+            # Test waitpid() + WIFSTOPPED and WIFCONTINUED.
+            # Note: if a process is stopped it ignores SIGTERM.
+            p.send_signal(signal.SIGSTOP)
+            self.assertRaises(psutil.TimeoutExpired, p.wait, timeout=0.001)
+            p.send_signal(signal.SIGCONT)
+            self.assertRaises(psutil.TimeoutExpired, p.wait, timeout=0.001)
+            p.send_signal(signal.SIGTERM)
+            self.assertEqual(p.wait(), -signal.SIGTERM)
+            self.assertEqual(p.wait(), -signal.SIGTERM)
+        else:
+            p.suspend()
+            self.assertRaises(psutil.TimeoutExpired, p.wait, timeout=0.001)
+            p.resume()
+            self.assertRaises(psutil.TimeoutExpired, p.wait, timeout=0.001)
+            p.terminate()
+            self.assertEqual(p.wait(), signal.SIGTERM)
+            self.assertEqual(p.wait(), signal.SIGTERM)
+
+    def test_wait_non_children(self):
+        # Test wait() against a process which is not our direct
+        # child.
+        child, grandchild = self.spawn_children_pair()
+        self.assertRaises(psutil.TimeoutExpired, child.wait, 0.01)
+        self.assertRaises(psutil.TimeoutExpired, grandchild.wait, 0.01)
+        # We also terminate the direct child otherwise the
+        # grandchild will hang until the parent is gone.
+        child.terminate()
+        grandchild.terminate()
+        child_ret = child.wait()
+        grandchild_ret = grandchild.wait()
+        if POSIX:
+            self.assertEqual(child_ret, -signal.SIGTERM)
+            # For processes which are not our children we're supposed
+            # to get None.
+            self.assertEqual(grandchild_ret, None)
+        else:
+            self.assertEqual(child_ret, signal.SIGTERM)
+            self.assertEqual(child_ret, signal.SIGTERM)
+
+    def test_wait_timeout(self):
+        p = self.spawn_psproc()
+        p.name()
+        self.assertRaises(psutil.TimeoutExpired, p.wait, 0.01)
+        self.assertRaises(psutil.TimeoutExpired, p.wait, 0)
+        self.assertRaises(ValueError, p.wait, -1)
+
+    def test_wait_timeout_nonblocking(self):
+        p = self.spawn_psproc()
+        self.assertRaises(psutil.TimeoutExpired, p.wait, 0)
+        p.kill()
+        stop_at = time.time() + GLOBAL_TIMEOUT
+        while time.time() < stop_at:
+            try:
+                code = p.wait(0)
+                break
+            except psutil.TimeoutExpired:
+                pass
+        else:
+            raise self.fail('timeout')
+        if POSIX:
+            self.assertEqual(code, -signal.SIGKILL)
+        else:
+            self.assertEqual(code, signal.SIGTERM)
+        self.assertProcessGone(p)
+
+    def test_cpu_percent(self):
+        p = psutil.Process()
+        p.cpu_percent(interval=0.001)
+        p.cpu_percent(interval=0.001)
+        for x in range(100):
+            percent = p.cpu_percent(interval=None)
+            self.assertIsInstance(percent, float)
+            self.assertGreaterEqual(percent, 0.0)
+        with self.assertRaises(ValueError):
+            p.cpu_percent(interval=-1)
+
+    def test_cpu_percent_numcpus_none(self):
+        # See: https://github.com/giampaolo/psutil/issues/1087
+        with mock.patch('psutil.cpu_count', return_value=None) as m:
+            psutil.Process().cpu_percent()
+            assert m.called
+
+    def test_cpu_times(self):
+        times = psutil.Process().cpu_times()
+        assert (times.user > 0.0) or (times.system > 0.0), times
+        assert (times.children_user >= 0.0), times
+        assert (times.children_system >= 0.0), times
+        if LINUX:
+            assert times.iowait >= 0.0, times
+        # make sure returned values can be pretty printed with strftime
+        for name in times._fields:
+            time.strftime("%H:%M:%S", time.localtime(getattr(times, name)))
+
+    def test_cpu_times_2(self):
+        user_time, kernel_time = psutil.Process().cpu_times()[:2]
+        utime, ktime = os.times()[:2]
+
+        # Use os.times()[:2] as base values to compare our results
+        # using a tolerance  of +/- 0.1 seconds.
+        # It will fail if the difference between the values is > 0.1s.
+        if (max([user_time, utime]) - min([user_time, utime])) > 0.1:
+            self.fail("expected: %s, found: %s" % (utime, user_time))
+
+        if (max([kernel_time, ktime]) - min([kernel_time, ktime])) > 0.1:
+            self.fail("expected: %s, found: %s" % (ktime, kernel_time))
+
+    @unittest.skipIf(not HAS_PROC_CPU_NUM, "not supported")
+    def test_cpu_num(self):
+        p = psutil.Process()
+        num = p.cpu_num()
+        self.assertGreaterEqual(num, 0)
+        if psutil.cpu_count() == 1:
+            self.assertEqual(num, 0)
+        self.assertIn(p.cpu_num(), range(psutil.cpu_count()))
+
+    def test_create_time(self):
+        p = self.spawn_psproc()
+        now = time.time()
+        create_time = p.create_time()
+
+        # Use time.time() as base value to compare our result using a
+        # tolerance of +/- 1 second.
+        # It will fail if the difference between the values is > 2s.
+        difference = abs(create_time - now)
+        if difference > 2:
+            self.fail("expected: %s, found: %s, difference: %s"
+                      % (now, create_time, difference))
+
+        # make sure returned value can be pretty printed with strftime
+        time.strftime("%Y %m %d %H:%M:%S", time.localtime(p.create_time()))
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    @unittest.skipIf(TRAVIS or CIRRUS, 'not reliable on TRAVIS/CIRRUS')
+    def test_terminal(self):
+        terminal = psutil.Process().terminal()
+        if terminal is not None:
+            tty = os.path.realpath(sh('tty'))
+            self.assertEqual(terminal, tty)
+
+    @unittest.skipIf(not HAS_PROC_IO_COUNTERS, 'not supported')
+    @skip_on_not_implemented(only_if=LINUX)
+    def test_io_counters(self):
+        p = psutil.Process()
+        # test reads
+        io1 = p.io_counters()
+        with open(PYTHON_EXE, 'rb') as f:
+            f.read()
+        io2 = p.io_counters()
+        if not BSD and not AIX:
+            self.assertGreater(io2.read_count, io1.read_count)
+            self.assertEqual(io2.write_count, io1.write_count)
+            if LINUX:
+                self.assertGreater(io2.read_chars, io1.read_chars)
+                self.assertEqual(io2.write_chars, io1.write_chars)
+        else:
+            self.assertGreaterEqual(io2.read_bytes, io1.read_bytes)
+            self.assertGreaterEqual(io2.write_bytes, io1.write_bytes)
+
+        # test writes
+        io1 = p.io_counters()
+        with open(self.get_testfn(), 'wb') as f:
+            if PY3:
+                f.write(bytes("x" * 1000000, 'ascii'))
+            else:
+                f.write("x" * 1000000)
+        io2 = p.io_counters()
+        self.assertGreaterEqual(io2.write_count, io1.write_count)
+        self.assertGreaterEqual(io2.write_bytes, io1.write_bytes)
+        self.assertGreaterEqual(io2.read_count, io1.read_count)
+        self.assertGreaterEqual(io2.read_bytes, io1.read_bytes)
+        if LINUX:
+            self.assertGreater(io2.write_chars, io1.write_chars)
+            self.assertGreaterEqual(io2.read_chars, io1.read_chars)
+
+        # sanity check
+        for i in range(len(io2)):
+            if BSD and i >= 2:
+                # On BSD read_bytes and write_bytes are always set to -1.
+                continue
+            self.assertGreaterEqual(io2[i], 0)
+            self.assertGreaterEqual(io2[i], 0)
+
+    @unittest.skipIf(not HAS_IONICE, "not supported")
+    @unittest.skipIf(not LINUX, "linux only")
+    def test_ionice_linux(self):
+        p = psutil.Process()
+        if not CI_TESTING:
+            self.assertEqual(p.ionice()[0], psutil.IOPRIO_CLASS_NONE)
+        self.assertEqual(psutil.IOPRIO_CLASS_NONE, 0)
+        self.assertEqual(psutil.IOPRIO_CLASS_RT, 1)  # high
+        self.assertEqual(psutil.IOPRIO_CLASS_BE, 2)  # normal
+        self.assertEqual(psutil.IOPRIO_CLASS_IDLE, 3)  # low
+        init = p.ionice()
+        try:
+            # low
+            p.ionice(psutil.IOPRIO_CLASS_IDLE)
+            self.assertEqual(tuple(p.ionice()), (psutil.IOPRIO_CLASS_IDLE, 0))
+            with self.assertRaises(ValueError):  # accepts no value
+                p.ionice(psutil.IOPRIO_CLASS_IDLE, value=7)
+            # normal
+            p.ionice(psutil.IOPRIO_CLASS_BE)
+            self.assertEqual(tuple(p.ionice()), (psutil.IOPRIO_CLASS_BE, 0))
+            p.ionice(psutil.IOPRIO_CLASS_BE, value=7)
+            self.assertEqual(tuple(p.ionice()), (psutil.IOPRIO_CLASS_BE, 7))
+            with self.assertRaises(ValueError):
+                p.ionice(psutil.IOPRIO_CLASS_BE, value=8)
+            try:
+                p.ionice(psutil.IOPRIO_CLASS_RT, value=7)
+            except psutil.AccessDenied:
+                pass
+            # errs
+            self.assertRaisesRegex(
+                ValueError, "ioclass accepts no value",
+                p.ionice, psutil.IOPRIO_CLASS_NONE, 1)
+            self.assertRaisesRegex(
+                ValueError, "ioclass accepts no value",
+                p.ionice, psutil.IOPRIO_CLASS_IDLE, 1)
+            self.assertRaisesRegex(
+                ValueError, "'ioclass' argument must be specified",
+                p.ionice, value=1)
+        finally:
+            ioclass, value = init
+            if ioclass == psutil.IOPRIO_CLASS_NONE:
+                value = 0
+            p.ionice(ioclass, value)
+
+    @unittest.skipIf(not HAS_IONICE, "not supported")
+    @unittest.skipIf(not WINDOWS, 'not supported on this win version')
+    def test_ionice_win(self):
+        p = psutil.Process()
+        if not CI_TESTING:
+            self.assertEqual(p.ionice(), psutil.IOPRIO_NORMAL)
+        init = p.ionice()
+        try:
+            # base
+            p.ionice(psutil.IOPRIO_VERYLOW)
+            self.assertEqual(p.ionice(), psutil.IOPRIO_VERYLOW)
+            p.ionice(psutil.IOPRIO_LOW)
+            self.assertEqual(p.ionice(), psutil.IOPRIO_LOW)
+            try:
+                p.ionice(psutil.IOPRIO_HIGH)
+            except psutil.AccessDenied:
+                pass
+            else:
+                self.assertEqual(p.ionice(), psutil.IOPRIO_HIGH)
+            # errs
+            self.assertRaisesRegex(
+                TypeError, "value argument not accepted on Windows",
+                p.ionice, psutil.IOPRIO_NORMAL, value=1)
+            self.assertRaisesRegex(
+                ValueError, "is not a valid priority",
+                p.ionice, psutil.IOPRIO_HIGH + 1)
+        finally:
+            p.ionice(init)
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_get(self):
+        import resource
+        p = psutil.Process(os.getpid())
+        names = [x for x in dir(psutil) if x.startswith('RLIMIT')]
+        assert names, names
+        for name in names:
+            value = getattr(psutil, name)
+            self.assertGreaterEqual(value, 0)
+            if name in dir(resource):
+                self.assertEqual(value, getattr(resource, name))
+                # XXX - On PyPy RLIMIT_INFINITY returned by
+                # resource.getrlimit() is reported as a very big long
+                # number instead of -1. It looks like a bug with PyPy.
+                if PYPY:
+                    continue
+                self.assertEqual(p.rlimit(value), resource.getrlimit(value))
+            else:
+                ret = p.rlimit(value)
+                self.assertEqual(len(ret), 2)
+                self.assertGreaterEqual(ret[0], -1)
+                self.assertGreaterEqual(ret[1], -1)
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_set(self):
+        p = self.spawn_psproc()
+        p.rlimit(psutil.RLIMIT_NOFILE, (5, 5))
+        self.assertEqual(p.rlimit(psutil.RLIMIT_NOFILE), (5, 5))
+        # If pid is 0 prlimit() applies to the calling process and
+        # we don't want that.
+        if LINUX:
+            with self.assertRaisesRegex(ValueError, "can't use prlimit"):
+                psutil._psplatform.Process(0).rlimit(0)
+        with self.assertRaises(ValueError):
+            p.rlimit(psutil.RLIMIT_NOFILE, (5, 5, 5))
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit(self):
+        p = psutil.Process()
+        testfn = self.get_testfn()
+        soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
+        try:
+            p.rlimit(psutil.RLIMIT_FSIZE, (1024, hard))
+            with open(testfn, "wb") as f:
+                f.write(b"X" * 1024)
+            # write() or flush() doesn't always cause the exception
+            # but close() will.
+            with self.assertRaises(IOError) as exc:
+                with open(testfn, "wb") as f:
+                    f.write(b"X" * 1025)
+            self.assertEqual(exc.exception.errno if PY3 else exc.exception[0],
+                             errno.EFBIG)
+        finally:
+            p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
+            self.assertEqual(p.rlimit(psutil.RLIMIT_FSIZE), (soft, hard))
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_infinity(self):
+        # First set a limit, then re-set it by specifying INFINITY
+        # and assume we overridden the previous limit.
+        p = psutil.Process()
+        soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
+        try:
+            p.rlimit(psutil.RLIMIT_FSIZE, (1024, hard))
+            p.rlimit(psutil.RLIMIT_FSIZE, (psutil.RLIM_INFINITY, hard))
+            with open(self.get_testfn(), "wb") as f:
+                f.write(b"X" * 2048)
+        finally:
+            p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
+            self.assertEqual(p.rlimit(psutil.RLIMIT_FSIZE), (soft, hard))
+
+    @unittest.skipIf(not HAS_RLIMIT, "not supported")
+    def test_rlimit_infinity_value(self):
+        # RLIMIT_FSIZE should be RLIM_INFINITY, which will be a really
+        # big number on a platform with large file support.  On these
+        # platforms we need to test that the get/setrlimit functions
+        # properly convert the number to a C long long and that the
+        # conversion doesn't raise an error.
+        p = psutil.Process()
+        soft, hard = p.rlimit(psutil.RLIMIT_FSIZE)
+        self.assertEqual(psutil.RLIM_INFINITY, hard)
+        p.rlimit(psutil.RLIMIT_FSIZE, (soft, hard))
+
+    def test_num_threads(self):
+        # on certain platforms such as Linux we might test for exact
+        # thread number, since we always have with 1 thread per process,
+        # but this does not apply across all platforms (MACOS, Windows)
+        p = psutil.Process()
+        if OPENBSD:
+            try:
+                step1 = p.num_threads()
+            except psutil.AccessDenied:
+                raise unittest.SkipTest("on OpenBSD this requires root access")
+        else:
+            step1 = p.num_threads()
+
+        with ThreadTask():
+            step2 = p.num_threads()
+            self.assertEqual(step2, step1 + 1)
+
+    @unittest.skipIf(not WINDOWS, 'WINDOWS only')
+    def test_num_handles(self):
+        # a better test is done later into test/_windows.py
+        p = psutil.Process()
+        self.assertGreater(p.num_handles(), 0)
+
+    @unittest.skipIf(not HAS_THREADS, 'not supported')
+    def test_threads(self):
+        p = psutil.Process()
+        if OPENBSD:
+            try:
+                step1 = p.threads()
+            except psutil.AccessDenied:
+                raise unittest.SkipTest("on OpenBSD this requires root access")
+        else:
+            step1 = p.threads()
+
+        with ThreadTask():
+            step2 = p.threads()
+            self.assertEqual(len(step2), len(step1) + 1)
+            athread = step2[0]
+            # test named tuple
+            self.assertEqual(athread.id, athread[0])
+            self.assertEqual(athread.user_time, athread[1])
+            self.assertEqual(athread.system_time, athread[2])
+
+    @retry_on_failure()
+    @skip_on_access_denied(only_if=MACOS)
+    @unittest.skipIf(not HAS_THREADS, 'not supported')
+    def test_threads_2(self):
+        p = self.spawn_psproc()
+        if OPENBSD:
+            try:
+                p.threads()
+            except psutil.AccessDenied:
+                raise unittest.SkipTest(
+                    "on OpenBSD this requires root access")
+        self.assertAlmostEqual(
+            p.cpu_times().user,
+            sum([x.user_time for x in p.threads()]), delta=0.1)
+        self.assertAlmostEqual(
+            p.cpu_times().system,
+            sum([x.system_time for x in p.threads()]), delta=0.1)
+
+    @retry_on_failure()
+    def test_memory_info(self):
+        p = psutil.Process()
+
+        # step 1 - get a base value to compare our results
+        rss1, vms1 = p.memory_info()[:2]
+        percent1 = p.memory_percent()
+        self.assertGreater(rss1, 0)
+        self.assertGreater(vms1, 0)
+
+        # step 2 - allocate some memory
+        memarr = [None] * 1500000
+
+        rss2, vms2 = p.memory_info()[:2]
+        percent2 = p.memory_percent()
+
+        # step 3 - make sure that the memory usage bumped up
+        self.assertGreater(rss2, rss1)
+        self.assertGreaterEqual(vms2, vms1)  # vms might be equal
+        self.assertGreater(percent2, percent1)
+        del memarr
+
+        if WINDOWS:
+            mem = p.memory_info()
+            self.assertEqual(mem.rss, mem.wset)
+            self.assertEqual(mem.vms, mem.pagefile)
+
+        mem = p.memory_info()
+        for name in mem._fields:
+            self.assertGreaterEqual(getattr(mem, name), 0)
+
+    def test_memory_full_info(self):
+        p = psutil.Process()
+        total = psutil.virtual_memory().total
+        mem = p.memory_full_info()
+        for name in mem._fields:
+            value = getattr(mem, name)
+            self.assertGreaterEqual(value, 0, msg=(name, value))
+            if name == 'vms' and OSX or LINUX:
+                continue
+            self.assertLessEqual(value, total, msg=(name, value, total))
+        if LINUX or WINDOWS or MACOS:
+            self.assertGreaterEqual(mem.uss, 0)
+        if LINUX:
+            self.assertGreaterEqual(mem.pss, 0)
+            self.assertGreaterEqual(mem.swap, 0)
+
+    @unittest.skipIf(not HAS_MEMORY_MAPS, "not supported")
+    def test_memory_maps(self):
+        p = psutil.Process()
+        maps = p.memory_maps()
+        paths = [x for x in maps]
+        self.assertEqual(len(paths), len(set(paths)))
+        ext_maps = p.memory_maps(grouped=False)
+
+        for nt in maps:
+            if not nt.path.startswith('['):
+                assert os.path.isabs(nt.path), nt.path
+                if POSIX:
+                    try:
+                        assert os.path.exists(nt.path) or \
+                            os.path.islink(nt.path), nt.path
+                    except AssertionError:
+                        if not LINUX:
+                            raise
+                        else:
+                            # https://github.com/giampaolo/psutil/issues/759
+                            with open_text('/proc/self/smaps') as f:
+                                data = f.read()
+                            if "%s (deleted)" % nt.path not in data:
+                                raise
+                else:
+                    # XXX - On Windows we have this strange behavior with
+                    # 64 bit dlls: they are visible via explorer but cannot
+                    # be accessed via os.stat() (wtf?).
+                    if '64' not in os.path.basename(nt.path):
+                        try:
+                            st = os.stat(nt.path)
+                        except FileNotFoundError:
+                            pass
+                        else:
+                            assert stat.S_ISREG(st.st_mode), nt.path
+        for nt in ext_maps:
+            for fname in nt._fields:
+                value = getattr(nt, fname)
+                if fname == 'path':
+                    continue
+                elif fname in ('addr', 'perms'):
+                    assert value, value
+                else:
+                    self.assertIsInstance(value, (int, long))
+                    assert value >= 0, value
+
+    @unittest.skipIf(not HAS_MEMORY_MAPS, "not supported")
+    def test_memory_maps_lists_lib(self):
+        # Make sure a newly loaded shared lib is listed.
+        p = psutil.Process()
+        with copyload_shared_lib() as path:
+            def normpath(p):
+                return os.path.realpath(os.path.normcase(p))
+            libpaths = [normpath(x.path)
+                        for x in p.memory_maps()]
+            self.assertIn(normpath(path), libpaths)
+
+    def test_memory_percent(self):
+        p = psutil.Process()
+        p.memory_percent()
+        self.assertRaises(ValueError, p.memory_percent, memtype="?!?")
+        if LINUX or MACOS or WINDOWS:
+            p.memory_percent(memtype='uss')
+
+    def test_is_running(self):
+        p = self.spawn_psproc()
+        assert p.is_running()
+        assert p.is_running()
+        p.kill()
+        p.wait()
+        assert not p.is_running()
+        assert not p.is_running()
+
+    def test_exe(self):
+        p = self.spawn_psproc()
+        exe = p.exe()
+        try:
+            self.assertEqual(exe, PYTHON_EXE)
+        except AssertionError:
+            if WINDOWS and len(exe) == len(PYTHON_EXE):
+                # on Windows we don't care about case sensitivity
+                normcase = os.path.normcase
+                self.assertEqual(normcase(exe), normcase(PYTHON_EXE))
+            else:
+                # certain platforms such as BSD are more accurate returning:
+                # "/usr/local/bin/python2.7"
+                # ...instead of:
+                # "/usr/local/bin/python"
+                # We do not want to consider this difference in accuracy
+                # an error.
+                ver = "%s.%s" % (sys.version_info[0], sys.version_info[1])
+                try:
+                    self.assertEqual(exe.replace(ver, ''),
+                                     PYTHON_EXE.replace(ver, ''))
+                except AssertionError:
+                    # Tipically MACOS. Really not sure what to do here.
+                    pass
+
+        out = sh([exe, "-c", "import os; print('hey')"])
+        self.assertEqual(out, 'hey')
+
+    def test_cmdline(self):
+        cmdline = [PYTHON_EXE, "-c", "import time; time.sleep(60)"]
+        p = self.spawn_psproc(cmdline)
+        try:
+            self.assertEqual(' '.join(p.cmdline()), ' '.join(cmdline))
+        except AssertionError:
+            # XXX - most of the times the underlying sysctl() call on Net
+            # and Open BSD returns a truncated string.
+            # Also /proc/pid/cmdline behaves the same so it looks
+            # like this is a kernel bug.
+            # XXX - AIX truncates long arguments in /proc/pid/cmdline
+            if NETBSD or OPENBSD or AIX:
+                self.assertEqual(p.cmdline()[0], PYTHON_EXE)
+            else:
+                raise
+
+    @unittest.skipIf(PYPY, "broken on PYPY")
+    def test_long_cmdline(self):
+        testfn = self.get_testfn()
+        create_exe(testfn)
+        cmdline = [testfn] + (["0123456789"] * 20)
+        p = self.spawn_psproc(cmdline)
+        self.assertEqual(p.cmdline(), cmdline)
+
+    def test_name(self):
+        p = self.spawn_psproc(PYTHON_EXE)
+        name = p.name().lower()
+        pyexe = os.path.basename(os.path.realpath(sys.executable)).lower()
+        assert pyexe.startswith(name), (pyexe, name)
+
+    @unittest.skipIf(PYPY, "unreliable on PYPY")
+    def test_long_name(self):
+        testfn = self.get_testfn(suffix="0123456789" * 2)
+        create_exe(testfn)
+        p = self.spawn_psproc(testfn)
+        self.assertEqual(p.name(), os.path.basename(testfn))
+
+    # XXX
+    @unittest.skipIf(SUNOS, "broken on SUNOS")
+    @unittest.skipIf(AIX, "broken on AIX")
+    @unittest.skipIf(PYPY, "broken on PYPY")
+    def test_prog_w_funky_name(self):
+        # Test that name(), exe() and cmdline() correctly handle programs
+        # with funky chars such as spaces and ")", see:
+        # https://github.com/giampaolo/psutil/issues/628
+        funky_path = self.get_testfn(suffix='foo bar )')
+        create_exe(funky_path)
+        cmdline = [funky_path, "-c",
+                   "import time; [time.sleep(0.01) for x in range(3000)];"
+                   "arg1", "arg2", "", "arg3", ""]
+        p = self.spawn_psproc(cmdline)
+        # ...in order to try to prevent occasional failures on travis
+        if TRAVIS:
+            wait_for_pid(p.pid)
+        self.assertEqual(p.cmdline(), cmdline)
+        self.assertEqual(p.name(), os.path.basename(funky_path))
+        self.assertEqual(os.path.normcase(p.exe()),
+                         os.path.normcase(funky_path))
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_uids(self):
+        p = psutil.Process()
+        real, effective, saved = p.uids()
+        # os.getuid() refers to "real" uid
+        self.assertEqual(real, os.getuid())
+        # os.geteuid() refers to "effective" uid
+        self.assertEqual(effective, os.geteuid())
+        # No such thing as os.getsuid() ("saved" uid), but starting
+        # from python 2.7 we have os.getresuid() which returns all
+        # of them.
+        if hasattr(os, "getresuid"):
+            self.assertEqual(os.getresuid(), p.uids())
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_gids(self):
+        p = psutil.Process()
+        real, effective, saved = p.gids()
+        # os.getuid() refers to "real" uid
+        self.assertEqual(real, os.getgid())
+        # os.geteuid() refers to "effective" uid
+        self.assertEqual(effective, os.getegid())
+        # No such thing as os.getsgid() ("saved" gid), but starting
+        # from python 2.7 we have os.getresgid() which returns all
+        # of them.
+        if hasattr(os, "getresuid"):
+            self.assertEqual(os.getresgid(), p.gids())
+
+    def test_nice(self):
+        p = psutil.Process()
+        self.assertRaises(TypeError, p.nice, "str")
+        init = p.nice()
+        try:
+            if WINDOWS:
+                for prio in [psutil.NORMAL_PRIORITY_CLASS,
+                             psutil.IDLE_PRIORITY_CLASS,
+                             psutil.BELOW_NORMAL_PRIORITY_CLASS,
+                             psutil.REALTIME_PRIORITY_CLASS,
+                             psutil.HIGH_PRIORITY_CLASS,
+                             psutil.ABOVE_NORMAL_PRIORITY_CLASS]:
+                    with self.subTest(prio=prio):
+                        try:
+                            p.nice(prio)
+                        except psutil.AccessDenied:
+                            pass
+                        else:
+                            self.assertEqual(p.nice(), prio)
+            else:
+                try:
+                    if hasattr(os, "getpriority"):
+                        self.assertEqual(
+                            os.getpriority(os.PRIO_PROCESS, os.getpid()),
+                            p.nice())
+                    p.nice(1)
+                    self.assertEqual(p.nice(), 1)
+                    if hasattr(os, "getpriority"):
+                        self.assertEqual(
+                            os.getpriority(os.PRIO_PROCESS, os.getpid()),
+                            p.nice())
+                    # XXX - going back to previous nice value raises
+                    # AccessDenied on MACOS
+                    if not MACOS:
+                        p.nice(0)
+                        self.assertEqual(p.nice(), 0)
+                except psutil.AccessDenied:
+                    pass
+        finally:
+            try:
+                p.nice(init)
+            except psutil.AccessDenied:
+                pass
+
+    def test_status(self):
+        p = psutil.Process()
+        self.assertEqual(p.status(), psutil.STATUS_RUNNING)
+
+    def test_username(self):
+        p = self.spawn_psproc()
+        username = p.username()
+        if WINDOWS:
+            domain, username = username.split('\\')
+            self.assertEqual(username, getpass.getuser())
+            if 'USERDOMAIN' in os.environ:
+                self.assertEqual(domain, os.environ['USERDOMAIN'])
+        else:
+            self.assertEqual(username, getpass.getuser())
+
+    def test_cwd(self):
+        p = self.spawn_psproc()
+        self.assertEqual(p.cwd(), os.getcwd())
+
+    def test_cwd_2(self):
+        cmd = [PYTHON_EXE, "-c",
+               "import os, time; os.chdir('..'); time.sleep(60)"]
+        p = self.spawn_psproc(cmd)
+        call_until(p.cwd, "ret == os.path.dirname(os.getcwd())")
+
+    @unittest.skipIf(not HAS_CPU_AFFINITY, 'not supported')
+    def test_cpu_affinity(self):
+        p = psutil.Process()
+        initial = p.cpu_affinity()
+        assert initial, initial
+        self.addCleanup(p.cpu_affinity, initial)
+
+        if hasattr(os, "sched_getaffinity"):
+            self.assertEqual(initial, list(os.sched_getaffinity(p.pid)))
+        self.assertEqual(len(initial), len(set(initial)))
+
+        all_cpus = list(range(len(psutil.cpu_percent(percpu=True))))
+        # Work around travis failure:
+        # https://travis-ci.org/giampaolo/psutil/builds/284173194
+        for n in all_cpus if not TRAVIS else initial:
+            p.cpu_affinity([n])
+            self.assertEqual(p.cpu_affinity(), [n])
+            if hasattr(os, "sched_getaffinity"):
+                self.assertEqual(p.cpu_affinity(),
+                                 list(os.sched_getaffinity(p.pid)))
+            # also test num_cpu()
+            if hasattr(p, "num_cpu"):
+                self.assertEqual(p.cpu_affinity()[0], p.num_cpu())
+
+        # [] is an alias for "all eligible CPUs"; on Linux this may
+        # not be equal to all available CPUs, see:
+        # https://github.com/giampaolo/psutil/issues/956
+        p.cpu_affinity([])
+        if LINUX:
+            self.assertEqual(p.cpu_affinity(), p._proc._get_eligible_cpus())
+        else:
+            self.assertEqual(p.cpu_affinity(), all_cpus)
+        if hasattr(os, "sched_getaffinity"):
+            self.assertEqual(p.cpu_affinity(),
+                             list(os.sched_getaffinity(p.pid)))
+        #
+        self.assertRaises(TypeError, p.cpu_affinity, 1)
+        p.cpu_affinity(initial)
+        # it should work with all iterables, not only lists
+        if not TRAVIS:
+            p.cpu_affinity(set(all_cpus))
+            p.cpu_affinity(tuple(all_cpus))
+
+    @unittest.skipIf(not HAS_CPU_AFFINITY, 'not supported')
+    def test_cpu_affinity_errs(self):
+        p = self.spawn_psproc()
+        invalid_cpu = [len(psutil.cpu_times(percpu=True)) + 10]
+        self.assertRaises(ValueError, p.cpu_affinity, invalid_cpu)
+        self.assertRaises(ValueError, p.cpu_affinity, range(10000, 11000))
+        self.assertRaises(TypeError, p.cpu_affinity, [0, "1"])
+        self.assertRaises(ValueError, p.cpu_affinity, [0, -1])
+
+    @unittest.skipIf(not HAS_CPU_AFFINITY, 'not supported')
+    def test_cpu_affinity_all_combinations(self):
+        p = psutil.Process()
+        initial = p.cpu_affinity()
+        assert initial, initial
+        self.addCleanup(p.cpu_affinity, initial)
+
+        # All possible CPU set combinations.
+        if len(initial) > 12:
+            initial = initial[:12]  # ...otherwise it will take forever
+        combos = []
+        for i in range(0, len(initial) + 1):
+            for subset in itertools.combinations(initial, i):
+                if subset:
+                    combos.append(list(subset))
+
+        for combo in combos:
+            p.cpu_affinity(combo)
+            self.assertEqual(sorted(p.cpu_affinity()), sorted(combo))
+
+    # TODO: #595
+    @unittest.skipIf(BSD, "broken on BSD")
+    # can't find any process file on Appveyor
+    @unittest.skipIf(APPVEYOR, "unreliable on APPVEYOR")
+    def test_open_files(self):
+        p = psutil.Process()
+        testfn = self.get_testfn()
+        files = p.open_files()
+        self.assertNotIn(testfn, files)
+        with open(testfn, 'wb') as f:
+            f.write(b'x' * 1024)
+            f.flush()
+            # give the kernel some time to see the new file
+            files = call_until(p.open_files, "len(ret) != %i" % len(files))
+            filenames = [os.path.normcase(x.path) for x in files]
+            self.assertIn(os.path.normcase(testfn), filenames)
+            if LINUX:
+                for file in files:
+                    if file.path == testfn:
+                        self.assertEqual(file.position, 1024)
+        for file in files:
+            assert os.path.isfile(file.path), file
+
+        # another process
+        cmdline = "import time; f = open(r'%s', 'r'); time.sleep(60);" % testfn
+        p = self.spawn_psproc([PYTHON_EXE, "-c", cmdline])
+
+        for x in range(100):
+            filenames = [os.path.normcase(x.path) for x in p.open_files()]
+            if testfn in filenames:
+                break
+            time.sleep(.01)
+        else:
+            self.assertIn(os.path.normcase(testfn), filenames)
+        for file in filenames:
+            assert os.path.isfile(file), file
+
+    # TODO: #595
+    @unittest.skipIf(BSD, "broken on BSD")
+    # can't find any process file on Appveyor
+    @unittest.skipIf(APPVEYOR, "unreliable on APPVEYOR")
+    def test_open_files_2(self):
+        # test fd and path fields
+        p = psutil.Process()
+        normcase = os.path.normcase
+        testfn = self.get_testfn()
+        with open(testfn, 'w') as fileobj:
+            for file in p.open_files():
+                if normcase(file.path) == normcase(fileobj.name) or \
+                        file.fd == fileobj.fileno():
+                    break
+            else:
+                self.fail("no file found; files=%s" % repr(p.open_files()))
+            self.assertEqual(normcase(file.path), normcase(fileobj.name))
+            if WINDOWS:
+                self.assertEqual(file.fd, -1)
+            else:
+                self.assertEqual(file.fd, fileobj.fileno())
+            # test positions
+            ntuple = p.open_files()[0]
+            self.assertEqual(ntuple[0], ntuple.path)
+            self.assertEqual(ntuple[1], ntuple.fd)
+            # test file is gone
+            self.assertNotIn(fileobj.name, p.open_files())
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_num_fds(self):
+        p = psutil.Process()
+        testfn = self.get_testfn()
+        start = p.num_fds()
+        file = open(testfn, 'w')
+        self.addCleanup(file.close)
+        self.assertEqual(p.num_fds(), start + 1)
+        sock = socket.socket()
+        self.addCleanup(sock.close)
+        self.assertEqual(p.num_fds(), start + 2)
+        file.close()
+        sock.close()
+        self.assertEqual(p.num_fds(), start)
+
+    @skip_on_not_implemented(only_if=LINUX)
+    @unittest.skipIf(OPENBSD or NETBSD, "not reliable on OPENBSD & NETBSD")
+    def test_num_ctx_switches(self):
+        p = psutil.Process()
+        before = sum(p.num_ctx_switches())
+        for x in range(500000):
+            after = sum(p.num_ctx_switches())
+            if after > before:
+                return
+        self.fail("num ctx switches still the same after 50.000 iterations")
+
+    def test_ppid(self):
+        p = psutil.Process()
+        if hasattr(os, 'getppid'):
+            self.assertEqual(p.ppid(), os.getppid())
+        p = self.spawn_psproc()
+        self.assertEqual(p.ppid(), os.getpid())
+        if APPVEYOR:
+            # Occasional failures, see:
+            # https://ci.appveyor.com/project/giampaolo/psutil/build/
+            #     job/0hs623nenj7w4m33
+            return
+
+    def test_parent(self):
+        p = self.spawn_psproc()
+        self.assertEqual(p.parent().pid, os.getpid())
+
+        lowest_pid = psutil.pids()[0]
+        self.assertIsNone(psutil.Process(lowest_pid).parent())
+
+    def test_parent_multi(self):
+        parent = psutil.Process()
+        child, grandchild = self.spawn_children_pair()
+        self.assertEqual(grandchild.parent(), child)
+        self.assertEqual(child.parent(), parent)
+
+    def test_parent_disappeared(self):
+        # Emulate a case where the parent process disappeared.
+        p = self.spawn_psproc()
+        with mock.patch("psutil.Process",
+                        side_effect=psutil.NoSuchProcess(0, 'foo')):
+            self.assertIsNone(p.parent())
+
+    @retry_on_failure()
+    def test_parents(self):
+        parent = psutil.Process()
+        assert parent.parents()
+        child, grandchild = self.spawn_children_pair()
+        self.assertEqual(child.parents()[0], parent)
+        self.assertEqual(grandchild.parents()[0], child)
+        self.assertEqual(grandchild.parents()[1], parent)
+
+    def test_children(self):
+        parent = psutil.Process()
+        self.assertEqual(parent.children(), [])
+        self.assertEqual(parent.children(recursive=True), [])
+        # On Windows we set the flag to 0 in order to cancel out the
+        # CREATE_NO_WINDOW flag (enabled by default) which creates
+        # an extra "conhost.exe" child.
+        child = self.spawn_psproc(creationflags=0)
+        children1 = parent.children()
+        children2 = parent.children(recursive=True)
+        for children in (children1, children2):
+            self.assertEqual(len(children), 1)
+            self.assertEqual(children[0].pid, child.pid)
+            self.assertEqual(children[0].ppid(), parent.pid)
+
+    def test_children_recursive(self):
+        # Test children() against two sub processes, p1 and p2, where
+        # p1 (our child) spawned p2 (our grandchild).
+        parent = psutil.Process()
+        child, grandchild = self.spawn_children_pair()
+        self.assertEqual(parent.children(), [child])
+        self.assertEqual(parent.children(recursive=True), [child, grandchild])
+        # If the intermediate process is gone there's no way for
+        # children() to recursively find it.
+        child.terminate()
+        child.wait()
+        self.assertEqual(parent.children(recursive=True), [])
+
+    def test_children_duplicates(self):
+        # find the process which has the highest number of children
+        table = collections.defaultdict(int)
+        for p in psutil.process_iter():
+            try:
+                table[p.ppid()] += 1
+            except psutil.Error:
+                pass
+        # this is the one, now let's make sure there are no duplicates
+        pid = sorted(table.items(), key=lambda x: x[1])[-1][0]
+        if LINUX and pid == 0:
+            raise self.skipTest("PID 0")
+        p = psutil.Process(pid)
+        try:
+            c = p.children(recursive=True)
+        except psutil.AccessDenied:  # windows
+            pass
+        else:
+            self.assertEqual(len(c), len(set(c)))
+
+    def test_parents_and_children(self):
+        parent = psutil.Process()
+        child, grandchild = self.spawn_children_pair()
+        # forward
+        children = parent.children(recursive=True)
+        self.assertEqual(len(children), 2)
+        self.assertEqual(children[0], child)
+        self.assertEqual(children[1], grandchild)
+        # backward
+        parents = grandchild.parents()
+        self.assertEqual(parents[0], child)
+        self.assertEqual(parents[1], parent)
+
+    def test_suspend_resume(self):
+        p = self.spawn_psproc()
+        p.suspend()
+        for x in range(100):
+            if p.status() == psutil.STATUS_STOPPED:
+                break
+            time.sleep(0.01)
+        p.resume()
+        self.assertNotEqual(p.status(), psutil.STATUS_STOPPED)
+
+    def test_invalid_pid(self):
+        self.assertRaises(TypeError, psutil.Process, "1")
+        self.assertRaises(ValueError, psutil.Process, -1)
+
+    def test_as_dict(self):
+        p = psutil.Process()
+        d = p.as_dict(attrs=['exe', 'name'])
+        self.assertEqual(sorted(d.keys()), ['exe', 'name'])
+
+        p = psutil.Process(min(psutil.pids()))
+        d = p.as_dict(attrs=['connections'], ad_value='foo')
+        if not isinstance(d['connections'], list):
+            self.assertEqual(d['connections'], 'foo')
+
+        # Test ad_value is set on AccessDenied.
+        with mock.patch('psutil.Process.nice', create=True,
+                        side_effect=psutil.AccessDenied):
+            self.assertEqual(
+                p.as_dict(attrs=["nice"], ad_value=1), {"nice": 1})
+
+        # Test that NoSuchProcess bubbles up.
+        with mock.patch('psutil.Process.nice', create=True,
+                        side_effect=psutil.NoSuchProcess(p.pid, "name")):
+            self.assertRaises(
+                psutil.NoSuchProcess, p.as_dict, attrs=["nice"])
+
+        # Test that ZombieProcess is swallowed.
+        with mock.patch('psutil.Process.nice', create=True,
+                        side_effect=psutil.ZombieProcess(p.pid, "name")):
+            self.assertEqual(
+                p.as_dict(attrs=["nice"], ad_value="foo"), {"nice": "foo"})
+
+        # By default APIs raising NotImplementedError are
+        # supposed to be skipped.
+        with mock.patch('psutil.Process.nice', create=True,
+                        side_effect=NotImplementedError):
+            d = p.as_dict()
+            self.assertNotIn('nice', list(d.keys()))
+            # ...unless the user explicitly asked for some attr.
+            with self.assertRaises(NotImplementedError):
+                p.as_dict(attrs=["nice"])
+
+        # errors
+        with self.assertRaises(TypeError):
+            p.as_dict('name')
+        with self.assertRaises(ValueError):
+            p.as_dict(['foo'])
+        with self.assertRaises(ValueError):
+            p.as_dict(['foo', 'bar'])
+
+    def test_oneshot(self):
+        p = psutil.Process()
+        with mock.patch("psutil._psplatform.Process.cpu_times") as m:
+            with p.oneshot():
+                p.cpu_times()
+                p.cpu_times()
+            self.assertEqual(m.call_count, 1)
+
+        with mock.patch("psutil._psplatform.Process.cpu_times") as m:
+            p.cpu_times()
+            p.cpu_times()
+        self.assertEqual(m.call_count, 2)
+
+    def test_oneshot_twice(self):
+        # Test the case where the ctx manager is __enter__ed twice.
+        # The second __enter__ is supposed to resut in a NOOP.
+        p = psutil.Process()
+        with mock.patch("psutil._psplatform.Process.cpu_times") as m1:
+            with mock.patch("psutil._psplatform.Process.oneshot_enter") as m2:
+                with p.oneshot():
+                    p.cpu_times()
+                    p.cpu_times()
+                    with p.oneshot():
+                        p.cpu_times()
+                        p.cpu_times()
+                self.assertEqual(m1.call_count, 1)
+                self.assertEqual(m2.call_count, 1)
+
+        with mock.patch("psutil._psplatform.Process.cpu_times") as m:
+            p.cpu_times()
+            p.cpu_times()
+        self.assertEqual(m.call_count, 2)
+
+    def test_oneshot_cache(self):
+        # Make sure oneshot() cache is nonglobal. Instead it's
+        # supposed to be bound to the Process instance, see:
+        # https://github.com/giampaolo/psutil/issues/1373
+        p1, p2 = self.spawn_children_pair()
+        p1_ppid = p1.ppid()
+        p2_ppid = p2.ppid()
+        self.assertNotEqual(p1_ppid, p2_ppid)
+        with p1.oneshot():
+            self.assertEqual(p1.ppid(), p1_ppid)
+            self.assertEqual(p2.ppid(), p2_ppid)
+        with p2.oneshot():
+            self.assertEqual(p1.ppid(), p1_ppid)
+            self.assertEqual(p2.ppid(), p2_ppid)
+
+    def test_halfway_terminated_process(self):
+        # Test that NoSuchProcess exception gets raised in case the
+        # process dies after we create the Process object.
+        # Example:
+        # >>> proc = Process(1234)
+        # >>> time.sleep(2)  # time-consuming task, process dies in meantime
+        # >>> proc.name()
+        # Refers to Issue #15
+        def assert_raises_nsp(fun, fun_name):
+            try:
+                ret = fun()
+            except psutil.ZombieProcess:  # differentiate from NSP
+                raise
+            except psutil.NoSuchProcess:
+                pass
+            except psutil.AccessDenied:
+                if OPENBSD and fun_name in ('threads', 'num_threads'):
+                    return
+                raise
+            else:
+                # NtQuerySystemInformation succeeds even if process is gone.
+                if WINDOWS and fun_name in ('exe', 'name'):
+                    return
+                raise self.fail("%r didn't raise NSP and returned %r "
+                                "instead" % (fun, ret))
+
+        p = self.spawn_psproc()
+        p.terminate()
+        p.wait()
+        if WINDOWS:  # XXX
+            call_until(psutil.pids, "%s not in ret" % p.pid)
+        self.assertProcessGone(p)
+
+        ns = process_namespace(p)
+        for fun, name in ns.iter(ns.all):
+            assert_raises_nsp(fun, name)
+
+        # NtQuerySystemInformation succeeds even if process is gone.
+        if WINDOWS and not GITHUB_WHEELS:
+            normcase = os.path.normcase
+            self.assertEqual(normcase(p.exe()), normcase(PYTHON_EXE))
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_zombie_process(self):
+        def succeed_or_zombie_p_exc(fun):
+            try:
+                return fun()
+            except (psutil.ZombieProcess, psutil.AccessDenied):
+                pass
+
+        parent, zombie = self.spawn_zombie()
+        # A zombie process should always be instantiable
+        zproc = psutil.Process(zombie.pid)
+        # ...and at least its status always be querable
+        self.assertEqual(zproc.status(), psutil.STATUS_ZOMBIE)
+        # ...and it should be considered 'running'
+        assert zproc.is_running()
+        # ...and as_dict() shouldn't crash
+        zproc.as_dict()
+        # ...its parent should 'see' it (edit: not true on BSD and MACOS
+        # descendants = [x.pid for x in psutil.Process().children(
+        #                recursive=True)]
+        # self.assertIn(zpid, descendants)
+        # XXX should we also assume ppid be usable?  Note: this
+        # would be an important use case as the only way to get
+        # rid of a zombie is to kill its parent.
+        # self.assertEqual(zpid.ppid(), os.getpid())
+        # ...and all other APIs should be able to deal with it
+
+        ns = process_namespace(zproc)
+        for fun, name in ns.iter(ns.all):
+            succeed_or_zombie_p_exc(fun)
+
+        assert psutil.pid_exists(zproc.pid)
+        if not TRAVIS and MACOS:
+            # For some reason this started failing all of the sudden.
+            # Maybe they upgraded MACOS version?
+            # https://travis-ci.org/giampaolo/psutil/jobs/310896404
+            self.assertIn(zproc.pid, psutil.pids())
+            self.assertIn(zproc.pid, [x.pid for x in psutil.process_iter()])
+            psutil._pmap = {}
+            self.assertIn(zproc.pid, [x.pid for x in psutil.process_iter()])
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_zombie_process_is_running_w_exc(self):
+        # Emulate a case where internally is_running() raises
+        # ZombieProcess.
+        p = psutil.Process()
+        with mock.patch("psutil.Process",
+                        side_effect=psutil.ZombieProcess(0)) as m:
+            assert p.is_running()
+            assert m.called
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_zombie_process_status_w_exc(self):
+        # Emulate a case where internally status() raises
+        # ZombieProcess.
+        p = psutil.Process()
+        with mock.patch("psutil._psplatform.Process.status",
+                        side_effect=psutil.ZombieProcess(0)) as m:
+            self.assertEqual(p.status(), psutil.STATUS_ZOMBIE)
+            assert m.called
+
+    def test_pid_0(self):
+        # Process(0) is supposed to work on all platforms except Linux
+        if 0 not in psutil.pids():
+            self.assertRaises(psutil.NoSuchProcess, psutil.Process, 0)
+            # These 2 are a contradiction, but "ps" says PID 1's parent
+            # is PID 0.
+            assert not psutil.pid_exists(0)
+            self.assertEqual(psutil.Process(1).ppid(), 0)
+            return
+
+        p = psutil.Process(0)
+        exc = psutil.AccessDenied if WINDOWS else ValueError
+        self.assertRaises(exc, p.wait)
+        self.assertRaises(exc, p.terminate)
+        self.assertRaises(exc, p.suspend)
+        self.assertRaises(exc, p.resume)
+        self.assertRaises(exc, p.kill)
+        self.assertRaises(exc, p.send_signal, signal.SIGTERM)
+
+        # test all methods
+        ns = process_namespace(p)
+        for fun, name in ns.iter(ns.getters + ns.setters):
+            try:
+                ret = fun()
+            except psutil.AccessDenied:
+                pass
+            else:
+                if name in ("uids", "gids"):
+                    self.assertEqual(ret.real, 0)
+                elif name == "username":
+                    user = 'NT AUTHORITY\\SYSTEM' if WINDOWS else 'root'
+                    self.assertEqual(p.username(), user)
+                elif name == "name":
+                    assert name, name
+
+        if not OPENBSD:
+            self.assertIn(0, psutil.pids())
+            assert psutil.pid_exists(0)
+
+    @unittest.skipIf(not HAS_ENVIRON, "not supported")
+    def test_environ(self):
+        def clean_dict(d):
+            # Most of these are problematic on Travis.
+            d.pop("PSUTIL_TESTING", None)
+            d.pop("PLAT", None)
+            d.pop("HOME", None)
+            if MACOS:
+                d.pop("__CF_USER_TEXT_ENCODING", None)
+                d.pop("VERSIONER_PYTHON_PREFER_32_BIT", None)
+                d.pop("VERSIONER_PYTHON_VERSION", None)
+            return dict(
+                [(k.replace("\r", "").replace("\n", ""),
+                  v.replace("\r", "").replace("\n", ""))
+                 for k, v in d.items()])
+
+        self.maxDiff = None
+        p = psutil.Process()
+        d1 = clean_dict(p.environ())
+        d2 = clean_dict(os.environ.copy())
+        if not OSX and GITHUB_WHEELS:
+            self.assertEqual(d1, d2)
+
+    @unittest.skipIf(not HAS_ENVIRON, "not supported")
+    @unittest.skipIf(not POSIX, "POSIX only")
+    def test_weird_environ(self):
+        # environment variables can contain values without an equals sign
+        code = textwrap.dedent("""
+            #include <unistd.h>
+            #include <fcntl.h>
+            char * const argv[] = {"cat", 0};
+            char * const envp[] = {"A=1", "X", "C=3", 0};
+            int main(void) {
+                /* Close stderr on exec so parent can wait for the execve to
+                 * finish. */
+                if (fcntl(2, F_SETFD, FD_CLOEXEC) != 0)
+                    return 0;
+                return execve("/bin/cat", argv, envp);
+            }
+            """)
+        path = self.get_testfn()
+        create_exe(path, c_code=code)
+        sproc = self.spawn_testproc(
+            [path], stdin=subprocess.PIPE, stderr=subprocess.PIPE)
+        p = psutil.Process(sproc.pid)
+        wait_for_pid(p.pid)
+        assert p.is_running()
+        # Wait for process to exec or exit.
+        self.assertEqual(sproc.stderr.read(), b"")
+        self.assertEqual(p.environ(), {"A": "1", "C": "3"})
+        sproc.communicate()
+        self.assertEqual(sproc.returncode, 0)
+
+
+# ===================================================================
+# --- Limited user tests
+# ===================================================================
+
+
+if POSIX and os.getuid() == 0:
+
+    class LimitedUserTestCase(TestProcess):
+        """Repeat the previous tests by using a limited user.
+        Executed only on UNIX and only if the user who run the test script
+        is root.
+        """
+        # the uid/gid the test suite runs under
+        if hasattr(os, 'getuid'):
+            PROCESS_UID = os.getuid()
+            PROCESS_GID = os.getgid()
+
+        def __init__(self, *args, **kwargs):
+            super().__init__(*args, **kwargs)
+            # re-define all existent test methods in order to
+            # ignore AccessDenied exceptions
+            for attr in [x for x in dir(self) if x.startswith('test')]:
+                meth = getattr(self, attr)
+
+                def test_(self):
+                    try:
+                        meth()
+                    except psutil.AccessDenied:
+                        pass
+                setattr(self, attr, types.MethodType(test_, self))
+
+        def setUp(self):
+            super().setUp()
+            os.setegid(1000)
+            os.seteuid(1000)
+
+        def tearDown(self):
+            os.setegid(self.PROCESS_UID)
+            os.seteuid(self.PROCESS_GID)
+            super().tearDown()
+
+        def test_nice(self):
+            try:
+                psutil.Process().nice(-1)
+            except psutil.AccessDenied:
+                pass
+            else:
+                self.fail("exception not raised")
+
+        @unittest.skipIf(1, "causes problem as root")
+        def test_zombie_process(self):
+            pass
+
+
+# ===================================================================
+# --- psutil.Popen tests
+# ===================================================================
+
+
+class TestPopen(PsutilTestCase):
+    """Tests for psutil.Popen class."""
+
+    @classmethod
+    def tearDownClass(cls):
+        reap_children()
+
+    def test_misc(self):
+        # XXX this test causes a ResourceWarning on Python 3 because
+        # psutil.__subproc instance doesn't get propertly freed.
+        # Not sure what to do though.
+        cmd = [PYTHON_EXE, "-c", "import time; time.sleep(60);"]
+        with psutil.Popen(cmd, stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE) as proc:
+            proc.name()
+            proc.cpu_times()
+            proc.stdin
+            self.assertTrue(dir(proc))
+            self.assertRaises(AttributeError, getattr, proc, 'foo')
+            proc.terminate()
+        if POSIX:
+            self.assertEqual(proc.wait(5), -signal.SIGTERM)
+        else:
+            self.assertEqual(proc.wait(5), signal.SIGTERM)
+
+    def test_ctx_manager(self):
+        with psutil.Popen([PYTHON_EXE, "-V"],
+                          stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE,
+                          stdin=subprocess.PIPE) as proc:
+            proc.communicate()
+        assert proc.stdout.closed
+        assert proc.stderr.closed
+        assert proc.stdin.closed
+        self.assertEqual(proc.returncode, 0)
+
+    def test_kill_terminate(self):
+        # subprocess.Popen()'s terminate(), kill() and send_signal() do
+        # not raise exception after the process is gone. psutil.Popen
+        # diverges from that.
+        cmd = [PYTHON_EXE, "-c", "import time; time.sleep(60);"]
+        with psutil.Popen(cmd, stdout=subprocess.PIPE,
+                          stderr=subprocess.PIPE) as proc:
+            proc.terminate()
+            proc.wait()
+            self.assertRaises(psutil.NoSuchProcess, proc.terminate)
+            self.assertRaises(psutil.NoSuchProcess, proc.kill)
+            self.assertRaises(psutil.NoSuchProcess, proc.send_signal,
+                              signal.SIGTERM)
+            if WINDOWS and sys.version_info >= (2, 7):
+                self.assertRaises(psutil.NoSuchProcess, proc.send_signal,
+                                  signal.CTRL_C_EVENT)
+                self.assertRaises(psutil.NoSuchProcess, proc.send_signal,
+                                  signal.CTRL_BREAK_EVENT)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_sunos.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_sunos.py
new file mode 100644
index 0000000000000000000000000000000000000000..ad94f774d6579d1a367a13bdf2ac8e1ba5a691fb
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_sunos.py
@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Sun OS specific tests."""
+
+import os
+
+import psutil
+from psutil import SUNOS
+from psutil.tests import PsutilTestCase
+from psutil.tests import sh
+from psutil.tests import unittest
+
+
+@unittest.skipIf(not SUNOS, "SUNOS only")
+class SunOSSpecificTestCase(PsutilTestCase):
+
+    def test_swap_memory(self):
+        out = sh('env PATH=/usr/sbin:/sbin:%s swap -l' % os.environ['PATH'])
+        lines = out.strip().split('\n')[1:]
+        if not lines:
+            raise ValueError('no swap device(s) configured')
+        total = free = 0
+        for line in lines:
+            line = line.split()
+            t, f = line[-2:]
+            total += int(int(t) * 512)
+            free += int(int(f) * 512)
+        used = total - free
+
+        psutil_swap = psutil.swap_memory()
+        self.assertEqual(psutil_swap.total, total)
+        self.assertEqual(psutil_swap.used, used)
+        self.assertEqual(psutil_swap.free, free)
+
+    def test_cpu_count(self):
+        out = sh("/usr/sbin/psrinfo")
+        self.assertEqual(psutil.cpu_count(), len(out.split('\n')))
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_system.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_system.py
new file mode 100644
index 0000000000000000000000000000000000000000..787397ad35a9b98b08afbf57940a540bf676c62b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_system.py
@@ -0,0 +1,892 @@
+#!/usr/bin/env python3
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Tests for system APIS."""
+
+import contextlib
+import datetime
+import errno
+import os
+import pprint
+import shutil
+import signal
+import socket
+import sys
+import time
+
+import psutil
+from psutil import AIX
+from psutil import BSD
+from psutil import FREEBSD
+from psutil import LINUX
+from psutil import MACOS
+from psutil import NETBSD
+from psutil import OPENBSD
+from psutil import POSIX
+from psutil import SUNOS
+from psutil import WINDOWS
+from psutil._compat import FileNotFoundError
+from psutil._compat import long
+from psutil.tests import ASCII_FS
+from psutil.tests import check_net_address
+from psutil.tests import CI_TESTING
+from psutil.tests import DEVNULL
+from psutil.tests import enum
+from psutil.tests import GLOBAL_TIMEOUT
+from psutil.tests import HAS_BATTERY
+from psutil.tests import HAS_CPU_FREQ
+from psutil.tests import HAS_GETLOADAVG
+from psutil.tests import HAS_NET_IO_COUNTERS
+from psutil.tests import HAS_SENSORS_BATTERY
+from psutil.tests import HAS_SENSORS_FANS
+from psutil.tests import HAS_SENSORS_TEMPERATURES
+from psutil.tests import IS_64BIT
+from psutil.tests import mock
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYPY
+from psutil.tests import retry_on_failure
+from psutil.tests import TRAVIS
+from psutil.tests import GITHUB_WHEELS
+from psutil.tests import UNICODE_SUFFIX
+from psutil.tests import unittest
+
+
+# ===================================================================
+# --- System-related API tests
+# ===================================================================
+
+
+class TestProcessAPIs(PsutilTestCase):
+
+    def test_process_iter(self):
+        self.assertIn(os.getpid(), [x.pid for x in psutil.process_iter()])
+        sproc = self.spawn_testproc()
+        self.assertIn(sproc.pid, [x.pid for x in psutil.process_iter()])
+        p = psutil.Process(sproc.pid)
+        p.kill()
+        p.wait()
+        self.assertNotIn(sproc.pid, [x.pid for x in psutil.process_iter()])
+
+        with mock.patch('psutil.Process',
+                        side_effect=psutil.NoSuchProcess(os.getpid())):
+            self.assertEqual(list(psutil.process_iter()), [])
+        with mock.patch('psutil.Process',
+                        side_effect=psutil.AccessDenied(os.getpid())):
+            with self.assertRaises(psutil.AccessDenied):
+                list(psutil.process_iter())
+
+    def test_prcess_iter_w_attrs(self):
+        for p in psutil.process_iter(attrs=['pid']):
+            self.assertEqual(list(p.info.keys()), ['pid'])
+        with self.assertRaises(ValueError):
+            list(psutil.process_iter(attrs=['foo']))
+        with mock.patch("psutil._psplatform.Process.cpu_times",
+                        side_effect=psutil.AccessDenied(0, "")) as m:
+            for p in psutil.process_iter(attrs=["pid", "cpu_times"]):
+                self.assertIsNone(p.info['cpu_times'])
+                self.assertGreaterEqual(p.info['pid'], 0)
+            assert m.called
+        with mock.patch("psutil._psplatform.Process.cpu_times",
+                        side_effect=psutil.AccessDenied(0, "")) as m:
+            flag = object()
+            for p in psutil.process_iter(
+                    attrs=["pid", "cpu_times"], ad_value=flag):
+                self.assertIs(p.info['cpu_times'], flag)
+                self.assertGreaterEqual(p.info['pid'], 0)
+            assert m.called
+
+    @unittest.skipIf(PYPY and WINDOWS,
+                     "spawn_testproc() unreliable on PYPY + WINDOWS")
+    def test_wait_procs(self):
+        def callback(p):
+            pids.append(p.pid)
+
+        pids = []
+        sproc1 = self.spawn_testproc()
+        sproc2 = self.spawn_testproc()
+        sproc3 = self.spawn_testproc()
+        procs = [psutil.Process(x.pid) for x in (sproc1, sproc2, sproc3)]
+        self.assertRaises(ValueError, psutil.wait_procs, procs, timeout=-1)
+        self.assertRaises(TypeError, psutil.wait_procs, procs, callback=1)
+        t = time.time()
+        gone, alive = psutil.wait_procs(procs, timeout=0.01, callback=callback)
+
+        self.assertLess(time.time() - t, 0.5)
+        self.assertEqual(gone, [])
+        self.assertEqual(len(alive), 3)
+        self.assertEqual(pids, [])
+        for p in alive:
+            self.assertFalse(hasattr(p, 'returncode'))
+
+        @retry_on_failure(30)
+        def test(procs, callback):
+            gone, alive = psutil.wait_procs(procs, timeout=0.03,
+                                            callback=callback)
+            self.assertEqual(len(gone), 1)
+            self.assertEqual(len(alive), 2)
+            return gone, alive
+
+        sproc3.terminate()
+        gone, alive = test(procs, callback)
+        self.assertIn(sproc3.pid, [x.pid for x in gone])
+        if POSIX:
+            self.assertEqual(gone.pop().returncode, -signal.SIGTERM)
+        else:
+            self.assertEqual(gone.pop().returncode, 1)
+        self.assertEqual(pids, [sproc3.pid])
+        for p in alive:
+            self.assertFalse(hasattr(p, 'returncode'))
+
+        @retry_on_failure(30)
+        def test(procs, callback):
+            gone, alive = psutil.wait_procs(procs, timeout=0.03,
+                                            callback=callback)
+            self.assertEqual(len(gone), 3)
+            self.assertEqual(len(alive), 0)
+            return gone, alive
+
+        sproc1.terminate()
+        sproc2.terminate()
+        gone, alive = test(procs, callback)
+        self.assertEqual(set(pids), set([sproc1.pid, sproc2.pid, sproc3.pid]))
+        for p in gone:
+            self.assertTrue(hasattr(p, 'returncode'))
+
+    @unittest.skipIf(PYPY and WINDOWS,
+                     "spawn_testproc() unreliable on PYPY + WINDOWS")
+    def test_wait_procs_no_timeout(self):
+        sproc1 = self.spawn_testproc()
+        sproc2 = self.spawn_testproc()
+        sproc3 = self.spawn_testproc()
+        procs = [psutil.Process(x.pid) for x in (sproc1, sproc2, sproc3)]
+        for p in procs:
+            p.terminate()
+        gone, alive = psutil.wait_procs(procs)
+
+    def test_pid_exists(self):
+        sproc = self.spawn_testproc()
+        self.assertTrue(psutil.pid_exists(sproc.pid))
+        p = psutil.Process(sproc.pid)
+        p.kill()
+        p.wait()
+        self.assertFalse(psutil.pid_exists(sproc.pid))
+        self.assertFalse(psutil.pid_exists(-1))
+        self.assertEqual(psutil.pid_exists(0), 0 in psutil.pids())
+
+    def test_pid_exists_2(self):
+        pids = psutil.pids()
+        for pid in pids:
+            try:
+                assert psutil.pid_exists(pid)
+            except AssertionError:
+                # in case the process disappeared in meantime fail only
+                # if it is no longer in psutil.pids()
+                time.sleep(.1)
+                if pid in psutil.pids():
+                    self.fail(pid)
+        pids = range(max(pids) + 5000, max(pids) + 6000)
+        for pid in pids:
+            self.assertFalse(psutil.pid_exists(pid), msg=pid)
+
+
+class TestMiscAPIs(PsutilTestCase):
+
+    def test_boot_time(self):
+        bt = psutil.boot_time()
+        self.assertIsInstance(bt, float)
+        self.assertGreater(bt, 0)
+        self.assertLess(bt, time.time())
+
+    @unittest.skipIf(CI_TESTING and not psutil.users(), "unreliable on CI")
+    def test_users(self):
+        users = psutil.users()
+        self.assertNotEqual(users, [])
+        for user in users:
+            assert user.name, user
+            self.assertIsInstance(user.name, str)
+            self.assertIsInstance(user.terminal, (str, type(None)))
+            if user.host is not None:
+                self.assertIsInstance(user.host, (str, type(None)))
+            user.terminal
+            user.host
+            assert user.started > 0.0, user
+            datetime.datetime.fromtimestamp(user.started)
+            if WINDOWS or OPENBSD:
+                self.assertIsNone(user.pid)
+            else:
+                psutil.Process(user.pid)
+
+    @unittest.skipIf(not POSIX, 'POSIX only')
+    def test_PAGESIZE(self):
+        # pagesize is used internally to perform different calculations
+        # and it's determined by using SC_PAGE_SIZE; make sure
+        # getpagesize() returns the same value.
+        import resource
+        self.assertEqual(os.sysconf("SC_PAGE_SIZE"), resource.getpagesize())
+
+    def test_test(self):
+        # test for psutil.test() function
+        stdout = sys.stdout
+        sys.stdout = DEVNULL
+        try:
+            psutil.test()
+        finally:
+            sys.stdout = stdout
+
+    def test_os_constants(self):
+        names = ["POSIX", "WINDOWS", "LINUX", "MACOS", "FREEBSD", "OPENBSD",
+                 "NETBSD", "BSD", "SUNOS"]
+        for name in names:
+            self.assertIsInstance(getattr(psutil, name), bool, msg=name)
+
+        if os.name == 'posix':
+            assert psutil.POSIX
+            assert not psutil.WINDOWS
+            names.remove("POSIX")
+            if "linux" in sys.platform.lower():
+                assert psutil.LINUX
+                names.remove("LINUX")
+            elif "bsd" in sys.platform.lower():
+                assert psutil.BSD
+                self.assertEqual([psutil.FREEBSD, psutil.OPENBSD,
+                                  psutil.NETBSD].count(True), 1)
+                names.remove("BSD")
+                names.remove("FREEBSD")
+                names.remove("OPENBSD")
+                names.remove("NETBSD")
+            elif "sunos" in sys.platform.lower() or \
+                    "solaris" in sys.platform.lower():
+                assert psutil.SUNOS
+                names.remove("SUNOS")
+            elif "darwin" in sys.platform.lower():
+                assert psutil.MACOS
+                names.remove("MACOS")
+        else:
+            assert psutil.WINDOWS
+            assert not psutil.POSIX
+            names.remove("WINDOWS")
+
+        # assert all other constants are set to False
+        for name in names:
+            self.assertIs(getattr(psutil, name), False, msg=name)
+
+
+class TestMemoryAPIs(PsutilTestCase):
+
+    def test_virtual_memory(self):
+        mem = psutil.virtual_memory()
+        assert mem.total > 0, mem
+        assert mem.available > 0, mem
+        assert 0 <= mem.percent <= 100, mem
+        assert mem.used > 0, mem
+        assert mem.free >= 0, mem
+        for name in mem._fields:
+            value = getattr(mem, name)
+            if name != 'percent':
+                self.assertIsInstance(value, (int, long))
+            if name != 'total':
+                if not value >= 0:
+                    self.fail("%r < 0 (%s)" % (name, value))
+                if value > mem.total:
+                    self.fail("%r > total (total=%s, %s=%s)"
+                              % (name, mem.total, name, value))
+
+    def test_swap_memory(self):
+        mem = psutil.swap_memory()
+        self.assertEqual(
+            mem._fields, ('total', 'used', 'free', 'percent', 'sin', 'sout'))
+
+        assert mem.total >= 0, mem
+        assert mem.used >= 0, mem
+        if mem.total > 0:
+            # likely a system with no swap partition
+            assert mem.free > 0, mem
+        else:
+            assert mem.free == 0, mem
+        assert 0 <= mem.percent <= 100, mem
+        assert mem.sin >= 0, mem
+        assert mem.sout >= 0, mem
+
+
+class TestCpuAPIs(PsutilTestCase):
+
+    def test_cpu_count_logical(self):
+        logical = psutil.cpu_count()
+        self.assertIsNotNone(logical)
+        self.assertEqual(logical, len(psutil.cpu_times(percpu=True)))
+        self.assertGreaterEqual(logical, 1)
+        #
+        if os.path.exists("/proc/cpuinfo"):
+            with open("/proc/cpuinfo") as fd:
+                cpuinfo_data = fd.read()
+            if "physical id" not in cpuinfo_data:
+                raise unittest.SkipTest("cpuinfo doesn't include physical id")
+
+    def test_cpu_count_physical(self):
+        logical = psutil.cpu_count()
+        physical = psutil.cpu_count(logical=False)
+        if physical is None:
+            raise self.skipTest("physical cpu_count() is None")
+        if WINDOWS and sys.getwindowsversion()[:2] <= (6, 1):  # <= Vista
+            self.assertIsNone(physical)
+        else:
+            self.assertGreaterEqual(physical, 1)
+            self.assertGreaterEqual(logical, physical)
+
+    def test_cpu_count_none(self):
+        # https://github.com/giampaolo/psutil/issues/1085
+        for val in (-1, 0, None):
+            with mock.patch('psutil._psplatform.cpu_count_logical',
+                            return_value=val) as m:
+                self.assertIsNone(psutil.cpu_count())
+                assert m.called
+            with mock.patch('psutil._psplatform.cpu_count_physical',
+                            return_value=val) as m:
+                self.assertIsNone(psutil.cpu_count(logical=False))
+                assert m.called
+
+    def test_cpu_times(self):
+        # Check type, value >= 0, str().
+        total = 0
+        times = psutil.cpu_times()
+        sum(times)
+        for cp_time in times:
+            self.assertIsInstance(cp_time, float)
+            self.assertGreaterEqual(cp_time, 0.0)
+            total += cp_time
+        self.assertEqual(total, sum(times))
+        str(times)
+        # CPU times are always supposed to increase over time
+        # or at least remain the same and that's because time
+        # cannot go backwards.
+        # Surprisingly sometimes this might not be the case (at
+        # least on Windows and Linux), see:
+        # https://github.com/giampaolo/psutil/issues/392
+        # https://github.com/giampaolo/psutil/issues/645
+        # if not WINDOWS:
+        #     last = psutil.cpu_times()
+        #     for x in range(100):
+        #         new = psutil.cpu_times()
+        #         for field in new._fields:
+        #             new_t = getattr(new, field)
+        #             last_t = getattr(last, field)
+        #             self.assertGreaterEqual(new_t, last_t,
+        #                                     msg="%s %s" % (new_t, last_t))
+        #         last = new
+
+    def test_cpu_times_time_increases(self):
+        # Make sure time increases between calls.
+        t1 = sum(psutil.cpu_times())
+        stop_at = time.time() + GLOBAL_TIMEOUT
+        while time.time() < stop_at:
+            t2 = sum(psutil.cpu_times())
+            if t2 > t1:
+                return
+        self.fail("time remained the same")
+
+    def test_per_cpu_times(self):
+        # Check type, value >= 0, str().
+        for times in psutil.cpu_times(percpu=True):
+            total = 0
+            sum(times)
+            for cp_time in times:
+                self.assertIsInstance(cp_time, float)
+                self.assertGreaterEqual(cp_time, 0.0)
+                total += cp_time
+            self.assertEqual(total, sum(times))
+            str(times)
+        self.assertEqual(len(psutil.cpu_times(percpu=True)[0]),
+                         len(psutil.cpu_times(percpu=False)))
+
+        # Note: in theory CPU times are always supposed to increase over
+        # time or remain the same but never go backwards. In practice
+        # sometimes this is not the case.
+        # This issue seemd to be afflict Windows:
+        # https://github.com/giampaolo/psutil/issues/392
+        # ...but it turns out also Linux (rarely) behaves the same.
+        # last = psutil.cpu_times(percpu=True)
+        # for x in range(100):
+        #     new = psutil.cpu_times(percpu=True)
+        #     for index in range(len(new)):
+        #         newcpu = new[index]
+        #         lastcpu = last[index]
+        #         for field in newcpu._fields:
+        #             new_t = getattr(newcpu, field)
+        #             last_t = getattr(lastcpu, field)
+        #             self.assertGreaterEqual(
+        #                 new_t, last_t, msg="%s %s" % (lastcpu, newcpu))
+        #     last = new
+
+    def test_per_cpu_times_2(self):
+        # Simulate some work load then make sure time have increased
+        # between calls.
+        tot1 = psutil.cpu_times(percpu=True)
+        giveup_at = time.time() + GLOBAL_TIMEOUT
+        while True:
+            if time.time() >= giveup_at:
+                return self.fail("timeout")
+            tot2 = psutil.cpu_times(percpu=True)
+            for t1, t2 in zip(tot1, tot2):
+                t1, t2 = psutil._cpu_busy_time(t1), psutil._cpu_busy_time(t2)
+                difference = t2 - t1
+                if difference >= 0.05:
+                    return
+
+    def test_cpu_times_comparison(self):
+        # Make sure the sum of all per cpu times is almost equal to
+        # base "one cpu" times.
+        base = psutil.cpu_times()
+        per_cpu = psutil.cpu_times(percpu=True)
+        summed_values = base._make([sum(num) for num in zip(*per_cpu)])
+        for field in base._fields:
+            self.assertAlmostEqual(
+                getattr(base, field), getattr(summed_values, field), delta=1)
+
+    def _test_cpu_percent(self, percent, last_ret, new_ret):
+        try:
+            self.assertIsInstance(percent, float)
+            self.assertGreaterEqual(percent, 0.0)
+            self.assertIsNot(percent, -0.0)
+            self.assertLessEqual(percent, 100.0 * psutil.cpu_count())
+        except AssertionError as err:
+            raise AssertionError("\n%s\nlast=%s\nnew=%s" % (
+                err, pprint.pformat(last_ret), pprint.pformat(new_ret)))
+
+    def test_cpu_percent(self):
+        last = psutil.cpu_percent(interval=0.001)
+        for x in range(100):
+            new = psutil.cpu_percent(interval=None)
+            self._test_cpu_percent(new, last, new)
+            last = new
+        with self.assertRaises(ValueError):
+            psutil.cpu_percent(interval=-1)
+
+    def test_per_cpu_percent(self):
+        last = psutil.cpu_percent(interval=0.001, percpu=True)
+        self.assertEqual(len(last), psutil.cpu_count())
+        for x in range(100):
+            new = psutil.cpu_percent(interval=None, percpu=True)
+            for percent in new:
+                self._test_cpu_percent(percent, last, new)
+            last = new
+        with self.assertRaises(ValueError):
+            psutil.cpu_percent(interval=-1, percpu=True)
+
+    def test_cpu_times_percent(self):
+        last = psutil.cpu_times_percent(interval=0.001)
+        for x in range(100):
+            new = psutil.cpu_times_percent(interval=None)
+            for percent in new:
+                self._test_cpu_percent(percent, last, new)
+            self._test_cpu_percent(sum(new), last, new)
+            last = new
+        with self.assertRaises(ValueError):
+            psutil.cpu_times_percent(interval=-1)
+
+    def test_per_cpu_times_percent(self):
+        last = psutil.cpu_times_percent(interval=0.001, percpu=True)
+        self.assertEqual(len(last), psutil.cpu_count())
+        for x in range(100):
+            new = psutil.cpu_times_percent(interval=None, percpu=True)
+            for cpu in new:
+                for percent in cpu:
+                    self._test_cpu_percent(percent, last, new)
+                self._test_cpu_percent(sum(cpu), last, new)
+            last = new
+
+    def test_per_cpu_times_percent_negative(self):
+        # see: https://github.com/giampaolo/psutil/issues/645
+        psutil.cpu_times_percent(percpu=True)
+        zero_times = [x._make([0 for x in range(len(x._fields))])
+                      for x in psutil.cpu_times(percpu=True)]
+        with mock.patch('psutil.cpu_times', return_value=zero_times):
+            for cpu in psutil.cpu_times_percent(percpu=True):
+                for percent in cpu:
+                    self._test_cpu_percent(percent, None, None)
+
+    def test_cpu_stats(self):
+        # Tested more extensively in per-platform test modules.
+        infos = psutil.cpu_stats()
+        self.assertEqual(
+            infos._fields,
+            ('ctx_switches', 'interrupts', 'soft_interrupts', 'syscalls'))
+        for name in infos._fields:
+            value = getattr(infos, name)
+            self.assertGreaterEqual(value, 0)
+            # on AIX, ctx_switches is always 0
+            if not AIX and name in ('ctx_switches', 'interrupts'):
+                self.assertGreater(value, 0)
+
+    @unittest.skipIf(not HAS_CPU_FREQ, "not suported")
+    def test_cpu_freq(self):
+        def check_ls(ls):
+            for nt in ls:
+                self.assertEqual(nt._fields, ('current', 'min', 'max'))
+                if nt.max != 0.0:
+                    self.assertLessEqual(nt.current, nt.max)
+                for name in nt._fields:
+                    value = getattr(nt, name)
+                    self.assertIsInstance(value, (int, long, float))
+                    self.assertGreaterEqual(value, 0)
+
+        ls = psutil.cpu_freq(percpu=True)
+        if TRAVIS and not ls:
+            raise self.skipTest("skipped on Travis")
+        if FREEBSD and not ls:
+            raise self.skipTest("returns empty list on FreeBSD")
+
+        assert ls, ls
+        check_ls([psutil.cpu_freq(percpu=False)])
+
+        if LINUX:
+            self.assertEqual(len(ls), psutil.cpu_count())
+
+    @unittest.skipIf(not HAS_GETLOADAVG, "not supported")
+    def test_getloadavg(self):
+        loadavg = psutil.getloadavg()
+        self.assertEqual(len(loadavg), 3)
+        for load in loadavg:
+            self.assertIsInstance(load, float)
+            self.assertGreaterEqual(load, 0.0)
+
+
+class TestDiskAPIs(PsutilTestCase):
+
+    @unittest.skipIf(PYPY and not IS_64BIT, "unreliable on PYPY32 + 32BIT")
+    def test_disk_usage(self):
+        usage = psutil.disk_usage(os.getcwd())
+        self.assertEqual(usage._fields, ('total', 'used', 'free', 'percent'))
+
+        assert usage.total > 0, usage
+        assert usage.used > 0, usage
+        assert usage.free > 0, usage
+        assert usage.total > usage.used, usage
+        assert usage.total > usage.free, usage
+        assert 0 <= usage.percent <= 100, usage.percent
+        if hasattr(shutil, 'disk_usage'):
+            # py >= 3.3, see: http://bugs.python.org/issue12442
+            shutil_usage = shutil.disk_usage(os.getcwd())
+            tolerance = 5 * 1024 * 1024  # 5MB
+            self.assertEqual(usage.total, shutil_usage.total)
+            self.assertAlmostEqual(usage.free, shutil_usage.free,
+                                   delta=tolerance)
+            self.assertAlmostEqual(usage.used, shutil_usage.used,
+                                   delta=tolerance)
+
+        # if path does not exist OSError ENOENT is expected across
+        # all platforms
+        fname = self.get_testfn()
+        with self.assertRaises(FileNotFoundError):
+            psutil.disk_usage(fname)
+
+    @unittest.skipIf(not ASCII_FS, "not an ASCII fs")
+    def test_disk_usage_unicode(self):
+        # See: https://github.com/giampaolo/psutil/issues/416
+        with self.assertRaises(UnicodeEncodeError):
+            psutil.disk_usage(UNICODE_SUFFIX)
+
+    def test_disk_usage_bytes(self):
+        psutil.disk_usage(b'.')
+
+    def test_disk_partitions(self):
+        # all = False
+        ls = psutil.disk_partitions(all=False)
+        # on travis we get:
+        #     self.assertEqual(p.cpu_affinity(), [n])
+        # AssertionError: Lists differ: [0, 1, 2, 3, 4, 5, 6, 7,... != [0]
+        self.assertTrue(ls, msg=ls)
+        for disk in ls:
+            self.assertIsInstance(disk.device, str)
+            self.assertIsInstance(disk.mountpoint, str)
+            self.assertIsInstance(disk.fstype, str)
+            self.assertIsInstance(disk.opts, str)
+            if WINDOWS and 'cdrom' in disk.opts:
+                continue
+            if not POSIX:
+                assert os.path.exists(disk.device), disk
+            else:
+                # we cannot make any assumption about this, see:
+                # http://goo.gl/p9c43
+                disk.device
+            # on modern systems mount points can also be files
+            assert os.path.exists(disk.mountpoint), disk
+            assert disk.fstype, disk
+
+        # all = True
+        ls = psutil.disk_partitions(all=True)
+        self.assertTrue(ls, msg=ls)
+        for disk in psutil.disk_partitions(all=True):
+            if not WINDOWS and disk.mountpoint:
+                try:
+                    os.stat(disk.mountpoint)
+                except OSError as err:
+                    if (GITHUB_WHEELS or TRAVIS) and \
+                            MACOS and err.errno == errno.EIO:
+                        continue
+                    # http://mail.python.org/pipermail/python-dev/
+                    #     2012-June/120787.html
+                    if err.errno not in (errno.EPERM, errno.EACCES):
+                        raise
+                else:
+                    assert os.path.exists(disk.mountpoint), disk
+            self.assertIsInstance(disk.fstype, str)
+            self.assertIsInstance(disk.opts, str)
+
+        def find_mount_point(path):
+            path = os.path.abspath(path)
+            while not os.path.ismount(path):
+                path = os.path.dirname(path)
+            return path.lower()
+
+        mount = find_mount_point(__file__)
+        mounts = [x.mountpoint.lower() for x in
+                  psutil.disk_partitions(all=True) if x.mountpoint]
+        self.assertIn(mount, mounts)
+        psutil.disk_usage(mount)
+
+    @unittest.skipIf(LINUX and not os.path.exists('/proc/diskstats'),
+                     '/proc/diskstats not available on this linux version')
+    @unittest.skipIf(CI_TESTING and not psutil.disk_io_counters(),
+                     "unreliable on CI")  # no visible disks
+    def test_disk_io_counters(self):
+        def check_ntuple(nt):
+            self.assertEqual(nt[0], nt.read_count)
+            self.assertEqual(nt[1], nt.write_count)
+            self.assertEqual(nt[2], nt.read_bytes)
+            self.assertEqual(nt[3], nt.write_bytes)
+            if not (OPENBSD or NETBSD):
+                self.assertEqual(nt[4], nt.read_time)
+                self.assertEqual(nt[5], nt.write_time)
+                if LINUX:
+                    self.assertEqual(nt[6], nt.read_merged_count)
+                    self.assertEqual(nt[7], nt.write_merged_count)
+                    self.assertEqual(nt[8], nt.busy_time)
+                elif FREEBSD:
+                    self.assertEqual(nt[6], nt.busy_time)
+            for name in nt._fields:
+                assert getattr(nt, name) >= 0, nt
+
+        ret = psutil.disk_io_counters(perdisk=False)
+        assert ret is not None, "no disks on this system?"
+        check_ntuple(ret)
+        ret = psutil.disk_io_counters(perdisk=True)
+        # make sure there are no duplicates
+        self.assertEqual(len(ret), len(set(ret)))
+        for key in ret:
+            assert key, key
+            check_ntuple(ret[key])
+
+    def test_disk_io_counters_no_disks(self):
+        # Emulate a case where no disks are installed, see:
+        # https://github.com/giampaolo/psutil/issues/1062
+        with mock.patch('psutil._psplatform.disk_io_counters',
+                        return_value={}) as m:
+            self.assertIsNone(psutil.disk_io_counters(perdisk=False))
+            self.assertEqual(psutil.disk_io_counters(perdisk=True), {})
+            assert m.called
+
+
+class TestNetAPIs(PsutilTestCase):
+
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, 'not supported')
+    def test_net_io_counters(self):
+        def check_ntuple(nt):
+            self.assertEqual(nt[0], nt.bytes_sent)
+            self.assertEqual(nt[1], nt.bytes_recv)
+            self.assertEqual(nt[2], nt.packets_sent)
+            self.assertEqual(nt[3], nt.packets_recv)
+            self.assertEqual(nt[4], nt.errin)
+            self.assertEqual(nt[5], nt.errout)
+            self.assertEqual(nt[6], nt.dropin)
+            self.assertEqual(nt[7], nt.dropout)
+            assert nt.bytes_sent >= 0, nt
+            assert nt.bytes_recv >= 0, nt
+            assert nt.packets_sent >= 0, nt
+            assert nt.packets_recv >= 0, nt
+            assert nt.errin >= 0, nt
+            assert nt.errout >= 0, nt
+            assert nt.dropin >= 0, nt
+            assert nt.dropout >= 0, nt
+
+        ret = psutil.net_io_counters(pernic=False)
+        check_ntuple(ret)
+        ret = psutil.net_io_counters(pernic=True)
+        self.assertNotEqual(ret, [])
+        for key in ret:
+            self.assertTrue(key)
+            self.assertIsInstance(key, str)
+            check_ntuple(ret[key])
+
+    @unittest.skipIf(not HAS_NET_IO_COUNTERS, 'not supported')
+    def test_net_io_counters_no_nics(self):
+        # Emulate a case where no NICs are installed, see:
+        # https://github.com/giampaolo/psutil/issues/1062
+        with mock.patch('psutil._psplatform.net_io_counters',
+                        return_value={}) as m:
+            self.assertIsNone(psutil.net_io_counters(pernic=False))
+            self.assertEqual(psutil.net_io_counters(pernic=True), {})
+            assert m.called
+
+    def test_net_if_addrs(self):
+        nics = psutil.net_if_addrs()
+        assert nics, nics
+
+        nic_stats = psutil.net_if_stats()
+
+        # Not reliable on all platforms (net_if_addrs() reports more
+        # interfaces).
+        # self.assertEqual(sorted(nics.keys()),
+        #                  sorted(psutil.net_io_counters(pernic=True).keys()))
+
+        families = set([socket.AF_INET, socket.AF_INET6, psutil.AF_LINK])
+        for nic, addrs in nics.items():
+            self.assertIsInstance(nic, str)
+            self.assertEqual(len(set(addrs)), len(addrs))
+            for addr in addrs:
+                self.assertIsInstance(addr.family, int)
+                self.assertIsInstance(addr.address, str)
+                self.assertIsInstance(addr.netmask, (str, type(None)))
+                self.assertIsInstance(addr.broadcast, (str, type(None)))
+                self.assertIn(addr.family, families)
+                if sys.version_info >= (3, 4) and not PYPY:
+                    self.assertIsInstance(addr.family, enum.IntEnum)
+                if nic_stats[nic].isup:
+                    # Do not test binding to addresses of interfaces
+                    # that are down
+                    if addr.family == socket.AF_INET:
+                        s = socket.socket(addr.family)
+                        with contextlib.closing(s):
+                            s.bind((addr.address, 0))
+                    elif addr.family == socket.AF_INET6:
+                        info = socket.getaddrinfo(
+                            addr.address, 0, socket.AF_INET6,
+                            socket.SOCK_STREAM, 0, socket.AI_PASSIVE)[0]
+                        af, socktype, proto, canonname, sa = info
+                        s = socket.socket(af, socktype, proto)
+                        with contextlib.closing(s):
+                            s.bind(sa)
+                for ip in (addr.address, addr.netmask, addr.broadcast,
+                           addr.ptp):
+                    if ip is not None:
+                        # TODO: skip AF_INET6 for now because I get:
+                        # AddressValueError: Only hex digits permitted in
+                        # u'c6f3%lxcbr0' in u'fe80::c8e0:fff:fe54:c6f3%lxcbr0'
+                        if addr.family != socket.AF_INET6:
+                            check_net_address(ip, addr.family)
+                # broadcast and ptp addresses are mutually exclusive
+                if addr.broadcast:
+                    self.assertIsNone(addr.ptp)
+                elif addr.ptp:
+                    self.assertIsNone(addr.broadcast)
+
+        if BSD or MACOS or SUNOS:
+            if hasattr(socket, "AF_LINK"):
+                self.assertEqual(psutil.AF_LINK, socket.AF_LINK)
+        elif LINUX:
+            self.assertEqual(psutil.AF_LINK, socket.AF_PACKET)
+        elif WINDOWS:
+            self.assertEqual(psutil.AF_LINK, -1)
+
+    def test_net_if_addrs_mac_null_bytes(self):
+        # Simulate that the underlying C function returns an incomplete
+        # MAC address. psutil is supposed to fill it with null bytes.
+        # https://github.com/giampaolo/psutil/issues/786
+        if POSIX:
+            ret = [('em1', psutil.AF_LINK, '06:3d:29', None, None, None)]
+        else:
+            ret = [('em1', -1, '06-3d-29', None, None, None)]
+        with mock.patch('psutil._psplatform.net_if_addrs',
+                        return_value=ret) as m:
+            addr = psutil.net_if_addrs()['em1'][0]
+            assert m.called
+            if POSIX:
+                self.assertEqual(addr.address, '06:3d:29:00:00:00')
+            else:
+                self.assertEqual(addr.address, '06-3d-29-00-00-00')
+
+    @unittest.skipIf(TRAVIS, "unreliable on TRAVIS")  # raises EPERM
+    def test_net_if_stats(self):
+        nics = psutil.net_if_stats()
+        assert nics, nics
+        all_duplexes = (psutil.NIC_DUPLEX_FULL,
+                        psutil.NIC_DUPLEX_HALF,
+                        psutil.NIC_DUPLEX_UNKNOWN)
+        for name, stats in nics.items():
+            self.assertIsInstance(name, str)
+            isup, duplex, speed, mtu = stats
+            self.assertIsInstance(isup, bool)
+            self.assertIn(duplex, all_duplexes)
+            self.assertIn(duplex, all_duplexes)
+            self.assertGreaterEqual(speed, 0)
+            self.assertGreaterEqual(mtu, 0)
+
+    @unittest.skipIf(not (LINUX or BSD or MACOS),
+                     "LINUX or BSD or MACOS specific")
+    def test_net_if_stats_enodev(self):
+        # See: https://github.com/giampaolo/psutil/issues/1279
+        with mock.patch('psutil._psutil_posix.net_if_mtu',
+                        side_effect=OSError(errno.ENODEV, "")) as m:
+            ret = psutil.net_if_stats()
+            self.assertEqual(ret, {})
+            assert m.called
+
+
+class TestSensorsAPIs(PsutilTestCase):
+
+    @unittest.skipIf(not HAS_SENSORS_TEMPERATURES, "not supported")
+    def test_sensors_temperatures(self):
+        temps = psutil.sensors_temperatures()
+        for name, entries in temps.items():
+            self.assertIsInstance(name, str)
+            for entry in entries:
+                self.assertIsInstance(entry.label, str)
+                if entry.current is not None:
+                    self.assertGreaterEqual(entry.current, 0)
+                if entry.high is not None:
+                    self.assertGreaterEqual(entry.high, 0)
+                if entry.critical is not None:
+                    self.assertGreaterEqual(entry.critical, 0)
+
+    @unittest.skipIf(not HAS_SENSORS_TEMPERATURES, "not supported")
+    def test_sensors_temperatures_fahreneit(self):
+        d = {'coretemp': [('label', 50.0, 60.0, 70.0)]}
+        with mock.patch("psutil._psplatform.sensors_temperatures",
+                        return_value=d) as m:
+            temps = psutil.sensors_temperatures(
+                fahrenheit=True)['coretemp'][0]
+            assert m.called
+            self.assertEqual(temps.current, 122.0)
+            self.assertEqual(temps.high, 140.0)
+            self.assertEqual(temps.critical, 158.0)
+
+    @unittest.skipIf(not HAS_SENSORS_BATTERY, "not supported")
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_sensors_battery(self):
+        ret = psutil.sensors_battery()
+        self.assertGreaterEqual(ret.percent, 0)
+        self.assertLessEqual(ret.percent, 100)
+        if ret.secsleft not in (psutil.POWER_TIME_UNKNOWN,
+                                psutil.POWER_TIME_UNLIMITED):
+            self.assertGreaterEqual(ret.secsleft, 0)
+        else:
+            if ret.secsleft == psutil.POWER_TIME_UNLIMITED:
+                self.assertTrue(ret.power_plugged)
+        self.assertIsInstance(ret.power_plugged, bool)
+
+    @unittest.skipIf(not HAS_SENSORS_FANS, "not supported")
+    def test_sensors_fans(self):
+        fans = psutil.sensors_fans()
+        for name, entries in fans.items():
+            self.assertIsInstance(name, str)
+            for entry in entries:
+                self.assertIsInstance(entry.label, str)
+                self.assertIsInstance(entry.current, (int, long))
+                self.assertGreaterEqual(entry.current, 0)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_testutils.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_testutils.py
new file mode 100644
index 0000000000000000000000000000000000000000..31ac4dee4c1e20a8f28ad46db8681f0e7ef83a92
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_testutils.py
@@ -0,0 +1,439 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Tests for testing utils (psutil.tests namespace).
+"""
+
+import collections
+import contextlib
+import errno
+import os
+import socket
+import stat
+import subprocess
+
+from psutil import FREEBSD
+from psutil import NETBSD
+from psutil import POSIX
+from psutil._common import open_binary
+from psutil._common import open_text
+from psutil._common import supports_ipv6
+from psutil.tests import bind_socket
+from psutil.tests import bind_unix_socket
+from psutil.tests import call_until
+from psutil.tests import chdir
+from psutil.tests import CI_TESTING
+from psutil.tests import create_sockets
+from psutil.tests import get_free_port
+from psutil.tests import HAS_CONNECTIONS_UNIX
+from psutil.tests import is_namedtuple
+from psutil.tests import mock
+from psutil.tests import process_namespace
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYTHON_EXE
+from psutil.tests import reap_children
+from psutil.tests import retry
+from psutil.tests import retry_on_failure
+from psutil.tests import safe_mkdir
+from psutil.tests import safe_rmpath
+from psutil.tests import serialrun
+from psutil.tests import system_namespace
+from psutil.tests import tcp_socketpair
+from psutil.tests import terminate
+from psutil.tests import TestMemoryLeak
+from psutil.tests import unittest
+from psutil.tests import unix_socketpair
+from psutil.tests import wait_for_file
+from psutil.tests import wait_for_pid
+import psutil
+import psutil.tests
+
+# ===================================================================
+# --- Unit tests for test utilities.
+# ===================================================================
+
+
+class TestRetryDecorator(PsutilTestCase):
+
+    @mock.patch('time.sleep')
+    def test_retry_success(self, sleep):
+        # Fail 3 times out of 5; make sure the decorated fun returns.
+
+        @retry(retries=5, interval=1, logfun=None)
+        def foo():
+            while queue:
+                queue.pop()
+                1 / 0
+            return 1
+
+        queue = list(range(3))
+        self.assertEqual(foo(), 1)
+        self.assertEqual(sleep.call_count, 3)
+
+    @mock.patch('time.sleep')
+    def test_retry_failure(self, sleep):
+        # Fail 6 times out of 5; th function is supposed to raise exc.
+        @retry(retries=5, interval=1, logfun=None)
+        def foo():
+            while queue:
+                queue.pop()
+                1 / 0
+            return 1
+
+        queue = list(range(6))
+        self.assertRaises(ZeroDivisionError, foo)
+        self.assertEqual(sleep.call_count, 5)
+
+    @mock.patch('time.sleep')
+    def test_exception_arg(self, sleep):
+        @retry(exception=ValueError, interval=1)
+        def foo():
+            raise TypeError
+
+        self.assertRaises(TypeError, foo)
+        self.assertEqual(sleep.call_count, 0)
+
+    @mock.patch('time.sleep')
+    def test_no_interval_arg(self, sleep):
+        # if interval is not specified sleep is not supposed to be called
+
+        @retry(retries=5, interval=None, logfun=None)
+        def foo():
+            1 / 0
+
+        self.assertRaises(ZeroDivisionError, foo)
+        self.assertEqual(sleep.call_count, 0)
+
+    @mock.patch('time.sleep')
+    def test_retries_arg(self, sleep):
+
+        @retry(retries=5, interval=1, logfun=None)
+        def foo():
+            1 / 0
+
+        self.assertRaises(ZeroDivisionError, foo)
+        self.assertEqual(sleep.call_count, 5)
+
+    @mock.patch('time.sleep')
+    def test_retries_and_timeout_args(self, sleep):
+        self.assertRaises(ValueError, retry, retries=5, timeout=1)
+
+
+class TestSyncTestUtils(PsutilTestCase):
+
+    def test_wait_for_pid(self):
+        wait_for_pid(os.getpid())
+        nopid = max(psutil.pids()) + 99999
+        with mock.patch('psutil.tests.retry.__iter__', return_value=iter([0])):
+            self.assertRaises(psutil.NoSuchProcess, wait_for_pid, nopid)
+
+    def test_wait_for_file(self):
+        testfn = self.get_testfn()
+        with open(testfn, 'w') as f:
+            f.write('foo')
+        wait_for_file(testfn)
+        assert not os.path.exists(testfn)
+
+    def test_wait_for_file_empty(self):
+        testfn = self.get_testfn()
+        with open(testfn, 'w'):
+            pass
+        wait_for_file(testfn, empty=True)
+        assert not os.path.exists(testfn)
+
+    def test_wait_for_file_no_file(self):
+        testfn = self.get_testfn()
+        with mock.patch('psutil.tests.retry.__iter__', return_value=iter([0])):
+            self.assertRaises(IOError, wait_for_file, testfn)
+
+    def test_wait_for_file_no_delete(self):
+        testfn = self.get_testfn()
+        with open(testfn, 'w') as f:
+            f.write('foo')
+        wait_for_file(testfn, delete=False)
+        assert os.path.exists(testfn)
+
+    def test_call_until(self):
+        ret = call_until(lambda: 1, "ret == 1")
+        self.assertEqual(ret, 1)
+
+
+class TestFSTestUtils(PsutilTestCase):
+
+    def test_open_text(self):
+        with open_text(__file__) as f:
+            self.assertEqual(f.mode, 'rt')
+
+    def test_open_binary(self):
+        with open_binary(__file__) as f:
+            self.assertEqual(f.mode, 'rb')
+
+    def test_safe_mkdir(self):
+        testfn = self.get_testfn()
+        safe_mkdir(testfn)
+        assert os.path.isdir(testfn)
+        safe_mkdir(testfn)
+        assert os.path.isdir(testfn)
+
+    def test_safe_rmpath(self):
+        # test file is removed
+        testfn = self.get_testfn()
+        open(testfn, 'w').close()
+        safe_rmpath(testfn)
+        assert not os.path.exists(testfn)
+        # test no exception if path does not exist
+        safe_rmpath(testfn)
+        # test dir is removed
+        os.mkdir(testfn)
+        safe_rmpath(testfn)
+        assert not os.path.exists(testfn)
+        # test other exceptions are raised
+        with mock.patch('psutil.tests.os.stat',
+                        side_effect=OSError(errno.EINVAL, "")) as m:
+            with self.assertRaises(OSError):
+                safe_rmpath(testfn)
+            assert m.called
+
+    def test_chdir(self):
+        testfn = self.get_testfn()
+        base = os.getcwd()
+        os.mkdir(testfn)
+        with chdir(testfn):
+            self.assertEqual(os.getcwd(), os.path.join(base, testfn))
+        self.assertEqual(os.getcwd(), base)
+
+
+class TestProcessUtils(PsutilTestCase):
+
+    def test_reap_children(self):
+        subp = self.spawn_testproc()
+        p = psutil.Process(subp.pid)
+        assert p.is_running()
+        reap_children()
+        assert not p.is_running()
+        assert not psutil.tests._pids_started
+        assert not psutil.tests._subprocesses_started
+
+    def test_spawn_children_pair(self):
+        child, grandchild = self.spawn_children_pair()
+        self.assertNotEqual(child.pid, grandchild.pid)
+        assert child.is_running()
+        assert grandchild.is_running()
+        children = psutil.Process().children()
+        self.assertEqual(children, [child])
+        children = psutil.Process().children(recursive=True)
+        self.assertEqual(len(children), 2)
+        self.assertIn(child, children)
+        self.assertIn(grandchild, children)
+        self.assertEqual(child.ppid(), os.getpid())
+        self.assertEqual(grandchild.ppid(), child.pid)
+
+        terminate(child)
+        assert not child.is_running()
+        assert grandchild.is_running()
+
+        terminate(grandchild)
+        assert not grandchild.is_running()
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    def test_spawn_zombie(self):
+        parent, zombie = self.spawn_zombie()
+        self.assertEqual(zombie.status(), psutil.STATUS_ZOMBIE)
+
+    def test_terminate(self):
+        # by subprocess.Popen
+        p = self.spawn_testproc()
+        terminate(p)
+        self.assertProcessGone(p)
+        terminate(p)
+        # by psutil.Process
+        p = psutil.Process(self.spawn_testproc().pid)
+        terminate(p)
+        self.assertProcessGone(p)
+        terminate(p)
+        # by psutil.Popen
+        cmd = [PYTHON_EXE, "-c", "import time; time.sleep(60);"]
+        p = psutil.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+        terminate(p)
+        self.assertProcessGone(p)
+        terminate(p)
+        # by PID
+        pid = self.spawn_testproc().pid
+        terminate(pid)
+        self.assertProcessGone(p)
+        terminate(pid)
+        # zombie
+        if POSIX:
+            parent, zombie = self.spawn_zombie()
+            terminate(parent)
+            terminate(zombie)
+            self.assertProcessGone(parent)
+            self.assertProcessGone(zombie)
+
+
+class TestNetUtils(PsutilTestCase):
+
+    def bind_socket(self):
+        port = get_free_port()
+        with contextlib.closing(bind_socket(addr=('', port))) as s:
+            self.assertEqual(s.getsockname()[1], port)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    def test_bind_unix_socket(self):
+        name = self.get_testfn()
+        sock = bind_unix_socket(name)
+        with contextlib.closing(sock):
+            self.assertEqual(sock.family, socket.AF_UNIX)
+            self.assertEqual(sock.type, socket.SOCK_STREAM)
+            self.assertEqual(sock.getsockname(), name)
+            assert os.path.exists(name)
+            assert stat.S_ISSOCK(os.stat(name).st_mode)
+        # UDP
+        name = self.get_testfn()
+        sock = bind_unix_socket(name, type=socket.SOCK_DGRAM)
+        with contextlib.closing(sock):
+            self.assertEqual(sock.type, socket.SOCK_DGRAM)
+
+    def tcp_tcp_socketpair(self):
+        addr = ("127.0.0.1", get_free_port())
+        server, client = tcp_socketpair(socket.AF_INET, addr=addr)
+        with contextlib.closing(server):
+            with contextlib.closing(client):
+                # Ensure they are connected and the positions are
+                # correct.
+                self.assertEqual(server.getsockname(), addr)
+                self.assertEqual(client.getpeername(), addr)
+                self.assertNotEqual(client.getsockname(), addr)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @unittest.skipIf(NETBSD or FREEBSD,
+                     "/var/run/log UNIX socket opened by default")
+    def test_unix_socketpair(self):
+        p = psutil.Process()
+        num_fds = p.num_fds()
+        assert not p.connections(kind='unix')
+        name = self.get_testfn()
+        server, client = unix_socketpair(name)
+        try:
+            assert os.path.exists(name)
+            assert stat.S_ISSOCK(os.stat(name).st_mode)
+            self.assertEqual(p.num_fds() - num_fds, 2)
+            self.assertEqual(len(p.connections(kind='unix')), 2)
+            self.assertEqual(server.getsockname(), name)
+            self.assertEqual(client.getpeername(), name)
+        finally:
+            client.close()
+            server.close()
+
+    def test_create_sockets(self):
+        with create_sockets() as socks:
+            fams = collections.defaultdict(int)
+            types = collections.defaultdict(int)
+            for s in socks:
+                fams[s.family] += 1
+                # work around http://bugs.python.org/issue30204
+                types[s.getsockopt(socket.SOL_SOCKET, socket.SO_TYPE)] += 1
+            self.assertGreaterEqual(fams[socket.AF_INET], 2)
+            if supports_ipv6():
+                self.assertGreaterEqual(fams[socket.AF_INET6], 2)
+            if POSIX and HAS_CONNECTIONS_UNIX:
+                self.assertGreaterEqual(fams[socket.AF_UNIX], 2)
+            self.assertGreaterEqual(types[socket.SOCK_STREAM], 2)
+            self.assertGreaterEqual(types[socket.SOCK_DGRAM], 2)
+
+
+@serialrun
+class TestMemLeakClass(TestMemoryLeak):
+
+    def test_times(self):
+        def fun():
+            cnt['cnt'] += 1
+        cnt = {'cnt': 0}
+        self.execute(fun, times=10, warmup_times=15)
+        self.assertEqual(cnt['cnt'], 26)
+
+    def test_param_err(self):
+        self.assertRaises(ValueError, self.execute, lambda: 0, times=0)
+        self.assertRaises(ValueError, self.execute, lambda: 0, times=-1)
+        self.assertRaises(ValueError, self.execute, lambda: 0, warmup_times=-1)
+        self.assertRaises(ValueError, self.execute, lambda: 0, tolerance=-1)
+        self.assertRaises(ValueError, self.execute, lambda: 0, retries=-1)
+
+    @retry_on_failure()
+    @unittest.skipIf(CI_TESTING, "skipped on CI")
+    def test_leak_mem(self):
+        ls = []
+
+        def fun(ls=ls):
+            ls.append("x" * 24 * 1024)
+
+        try:
+            # will consume around 3M in total
+            self.assertRaisesRegex(AssertionError, "extra-mem",
+                                   self.execute, fun, times=50)
+        finally:
+            del ls
+
+    def test_unclosed_files(self):
+        def fun():
+            f = open(__file__)
+            self.addCleanup(f.close)
+            box.append(f)
+
+        box = []
+        kind = "fd" if POSIX else "handle"
+        self.assertRaisesRegex(AssertionError, "unclosed " + kind,
+                               self.execute, fun)
+
+    def test_tolerance(self):
+        def fun():
+            ls.append("x" * 24 * 1024)
+        ls = []
+        times = 100
+        self.execute(fun, times=times, warmup_times=0,
+                     tolerance=200 * 1024 * 1024)
+        self.assertEqual(len(ls), times + 1)
+
+    def test_execute_w_exc(self):
+        def fun():
+            1 / 0
+        self.execute_w_exc(ZeroDivisionError, fun)
+        with self.assertRaises(ZeroDivisionError):
+            self.execute_w_exc(OSError, fun)
+
+        def fun():
+            pass
+        with self.assertRaises(AssertionError):
+            self.execute_w_exc(ZeroDivisionError, fun)
+
+
+class TestTestingUtils(PsutilTestCase):
+
+    def test_process_namespace(self):
+        p = psutil.Process()
+        ns = process_namespace(p)
+        ns.test()
+        fun = [x for x in ns.iter(ns.getters) if x[1] == 'ppid'][0][0]
+        self.assertEqual(fun(), p.ppid())
+
+    def test_system_namespace(self):
+        ns = system_namespace()
+        fun = [x for x in ns.iter(ns.getters) if x[1] == 'net_if_addrs'][0][0]
+        self.assertEqual(fun(), psutil.net_if_addrs())
+
+
+class TestOtherUtils(PsutilTestCase):
+
+    def test_is_namedtuple(self):
+        assert is_namedtuple(collections.namedtuple('foo', 'a b c')(1, 2, 3))
+        assert not is_namedtuple(tuple())
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_unicode.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_unicode.py
new file mode 100644
index 0000000000000000000000000000000000000000..bae81380b6ad1ef24730d404c34a72938ef54f56
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_unicode.py
@@ -0,0 +1,362 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""
+Notes about unicode handling in psutil
+======================================
+
+Starting from version 5.3.0 psutil adds unicode support, see:
+https://github.com/giampaolo/psutil/issues/1040
+The notes below apply to *any* API returning a string such as
+process exe(), cwd() or username():
+
+* all strings are encoded by using the OS filesystem encoding
+  (sys.getfilesystemencoding()) which varies depending on the platform
+  (e.g. "UTF-8" on macOS, "mbcs" on Win)
+* no API call is supposed to crash with UnicodeDecodeError
+* instead, in case of badly encoded data returned by the OS, the
+  following error handlers are used to replace the corrupted characters in
+  the string:
+    * Python 3: sys.getfilesystemencodeerrors() (PY 3.6+) or
+      "surrogatescape" on POSIX and "replace" on Windows
+    * Python 2: "replace"
+* on Python 2 all APIs return bytes (str type), never unicode
+* on Python 2, you can go back to unicode by doing:
+
+    >>> unicode(p.exe(), sys.getdefaultencoding(), errors="replace")
+
+For a detailed explanation of how psutil handles unicode see #1040.
+
+Tests
+=====
+
+List of APIs returning or dealing with a string:
+('not tested' means they are not tested to deal with non-ASCII strings):
+
+* Process.cmdline()
+* Process.connections('unix')
+* Process.cwd()
+* Process.environ()
+* Process.exe()
+* Process.memory_maps()
+* Process.name()
+* Process.open_files()
+* Process.username()             (not tested)
+
+* disk_io_counters()             (not tested)
+* disk_partitions()              (not tested)
+* disk_usage(str)
+* net_connections('unix')
+* net_if_addrs()                 (not tested)
+* net_if_stats()                 (not tested)
+* net_io_counters()              (not tested)
+* sensors_fans()                 (not tested)
+* sensors_temperatures()         (not tested)
+* users()                        (not tested)
+
+* WindowsService.binpath()       (not tested)
+* WindowsService.description()   (not tested)
+* WindowsService.display_name()  (not tested)
+* WindowsService.name()          (not tested)
+* WindowsService.status()        (not tested)
+* WindowsService.username()      (not tested)
+
+In here we create a unicode path with a funky non-ASCII name and (where
+possible) make psutil return it back (e.g. on name(), exe(), open_files(),
+etc.) and make sure that:
+
+* psutil never crashes with UnicodeDecodeError
+* the returned path matches
+"""
+
+import os
+import shutil
+import traceback
+import warnings
+from contextlib import closing
+
+from psutil import BSD
+from psutil import OPENBSD
+from psutil import POSIX
+from psutil import WINDOWS
+from psutil._compat import PY3
+from psutil._compat import u
+from psutil.tests import APPVEYOR
+from psutil.tests import ASCII_FS
+from psutil.tests import bind_unix_socket
+from psutil.tests import chdir
+from psutil.tests import CI_TESTING
+from psutil.tests import CIRRUS
+from psutil.tests import copyload_shared_lib
+from psutil.tests import create_exe
+from psutil.tests import get_testfn
+from psutil.tests import HAS_CONNECTIONS_UNIX
+from psutil.tests import HAS_ENVIRON
+from psutil.tests import HAS_MEMORY_MAPS
+from psutil.tests import INVALID_UNICODE_SUFFIX
+from psutil.tests import PsutilTestCase
+from psutil.tests import PYPY
+from psutil.tests import safe_mkdir
+from psutil.tests import safe_rmpath
+from psutil.tests import serialrun
+from psutil.tests import skip_on_access_denied
+from psutil.tests import spawn_testproc
+from psutil.tests import terminate
+from psutil.tests import TESTFN_PREFIX
+from psutil.tests import UNICODE_SUFFIX
+from psutil.tests import unittest
+import psutil
+
+
+if APPVEYOR:
+    def safe_rmpath(path):  # NOQA
+        # TODO - this is quite random and I'm not sure why it happens,
+        # nor I can reproduce it locally:
+        # https://ci.appveyor.com/project/giampaolo/psutil/build/job/
+        #     jiq2cgd6stsbtn60
+        # safe_rmpath() happens after reap_children() so this is weird
+        # Perhaps wait_procs() on Windows is broken? Maybe because
+        # of STILL_ACTIVE?
+        # https://github.com/giampaolo/psutil/blob/
+        #     68c7a70728a31d8b8b58f4be6c4c0baa2f449eda/psutil/arch/
+        #     windows/process_info.c#L146
+        from psutil.tests import safe_rmpath as _rm
+        try:
+            return _rm(path)
+        except WindowsError:
+            traceback.print_exc()
+
+
+def try_unicode(suffix):
+    """Return True if both the fs and the subprocess module can
+    deal with a unicode file name.
+    """
+    if PY3:
+        return True
+    sproc = None
+    testfn = get_testfn(suffix=suffix)
+    try:
+        safe_rmpath(testfn)
+        create_exe(testfn)
+        sproc = spawn_testproc(cmd=[testfn])
+        shutil.copyfile(testfn, testfn + '-2')
+        safe_rmpath(testfn + '-2')
+    except (UnicodeEncodeError, IOError):
+        return False
+    else:
+        return True
+    finally:
+        if sproc is not None:
+            terminate(sproc)
+        safe_rmpath(testfn)
+
+
+# ===================================================================
+# FS APIs
+# ===================================================================
+
+
+@serialrun
+@unittest.skipIf(ASCII_FS, "ASCII fs")
+@unittest.skipIf(PYPY and not PY3, "too much trouble on PYPY2")
+class _BaseFSAPIsTests(object):
+    funky_suffix = None
+
+    @classmethod
+    def setUpClass(cls):
+        cls.funky_name = get_testfn(suffix=cls.funky_suffix)
+        create_exe(cls.funky_name)
+
+    @classmethod
+    def tearDownClass(cls):
+        safe_rmpath(cls.funky_name)
+
+    def expect_exact_path_match(self):
+        raise NotImplementedError("must be implemented in subclass")
+
+    # ---
+
+    def test_proc_exe(self):
+        subp = self.spawn_testproc(cmd=[self.funky_name])
+        p = psutil.Process(subp.pid)
+        exe = p.exe()
+        self.assertIsInstance(exe, str)
+        if self.expect_exact_path_match():
+            self.assertEqual(os.path.normcase(exe),
+                             os.path.normcase(self.funky_name))
+
+    def test_proc_name(self):
+        subp = self.spawn_testproc(cmd=[self.funky_name])
+        name = psutil.Process(subp.pid).name()
+        self.assertIsInstance(name, str)
+        if self.expect_exact_path_match():
+            self.assertEqual(name, os.path.basename(self.funky_name))
+
+    def test_proc_cmdline(self):
+        subp = self.spawn_testproc(cmd=[self.funky_name])
+        p = psutil.Process(subp.pid)
+        cmdline = p.cmdline()
+        for part in cmdline:
+            self.assertIsInstance(part, str)
+        if self.expect_exact_path_match():
+            self.assertEqual(cmdline, [self.funky_name])
+
+    def test_proc_cwd(self):
+        dname = self.funky_name + "2"
+        self.addCleanup(safe_rmpath, dname)
+        safe_mkdir(dname)
+        with chdir(dname):
+            p = psutil.Process()
+            cwd = p.cwd()
+        self.assertIsInstance(p.cwd(), str)
+        if self.expect_exact_path_match():
+            self.assertEqual(cwd, dname)
+
+    @unittest.skipIf(PYPY and WINDOWS, "fails on PYPY + WINDOWS")
+    def test_proc_open_files(self):
+        p = psutil.Process()
+        start = set(p.open_files())
+        with open(self.funky_name, 'rb'):
+            new = set(p.open_files())
+        path = (new - start).pop().path
+        self.assertIsInstance(path, str)
+        if BSD and not path:
+            # XXX - see https://github.com/giampaolo/psutil/issues/595
+            return self.skipTest("open_files on BSD is broken")
+        if self.expect_exact_path_match():
+            self.assertEqual(os.path.normcase(path),
+                             os.path.normcase(self.funky_name))
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    def test_proc_connections(self):
+        name = self.get_testfn(suffix=self.funky_suffix)
+        try:
+            sock = bind_unix_socket(name)
+        except UnicodeEncodeError:
+            if PY3:
+                raise
+            else:
+                raise unittest.SkipTest("not supported")
+        with closing(sock):
+            conn = psutil.Process().connections('unix')[0]
+            self.assertIsInstance(conn.laddr, str)
+            # AF_UNIX addr not set on OpenBSD
+            if not OPENBSD and not CIRRUS:  # XXX
+                self.assertEqual(conn.laddr, name)
+
+    @unittest.skipIf(not POSIX, "POSIX only")
+    @unittest.skipIf(not HAS_CONNECTIONS_UNIX, "can't list UNIX sockets")
+    @skip_on_access_denied()
+    def test_net_connections(self):
+        def find_sock(cons):
+            for conn in cons:
+                if os.path.basename(conn.laddr).startswith(TESTFN_PREFIX):
+                    return conn
+            raise ValueError("connection not found")
+
+        name = self.get_testfn(suffix=self.funky_suffix)
+        try:
+            sock = bind_unix_socket(name)
+        except UnicodeEncodeError:
+            if PY3:
+                raise
+            else:
+                raise unittest.SkipTest("not supported")
+        with closing(sock):
+            cons = psutil.net_connections(kind='unix')
+            # AF_UNIX addr not set on OpenBSD
+            if not OPENBSD:
+                conn = find_sock(cons)
+                self.assertIsInstance(conn.laddr, str)
+                self.assertEqual(conn.laddr, name)
+
+    def test_disk_usage(self):
+        dname = self.funky_name + "2"
+        self.addCleanup(safe_rmpath, dname)
+        safe_mkdir(dname)
+        psutil.disk_usage(dname)
+
+    @unittest.skipIf(not HAS_MEMORY_MAPS, "not supported")
+    @unittest.skipIf(not PY3, "ctypes does not support unicode on PY2")
+    @unittest.skipIf(PYPY, "unstable on PYPY")
+    def test_memory_maps(self):
+        # XXX: on Python 2, using ctypes.CDLL with a unicode path
+        # opens a message box which blocks the test run.
+        with copyload_shared_lib(suffix=self.funky_suffix) as funky_path:
+            def normpath(p):
+                return os.path.realpath(os.path.normcase(p))
+            libpaths = [normpath(x.path)
+                        for x in psutil.Process().memory_maps()]
+            # ...just to have a clearer msg in case of failure
+            libpaths = [x for x in libpaths if TESTFN_PREFIX in x]
+            self.assertIn(normpath(funky_path), libpaths)
+            for path in libpaths:
+                self.assertIsInstance(path, str)
+
+
+# https://travis-ci.org/giampaolo/psutil/jobs/440073249
+# @unittest.skipIf(PYPY and TRAVIS, "unreliable on PYPY + TRAVIS")
+# @unittest.skipIf(MACOS and TRAVIS, "unreliable on TRAVIS")  # TODO
+@unittest.skipIf(not try_unicode(UNICODE_SUFFIX),
+                 "can't deal with unicode str")
+class TestFSAPIs(_BaseFSAPIsTests, PsutilTestCase):
+    """Test FS APIs with a funky, valid, UTF8 path name."""
+    funky_suffix = UNICODE_SUFFIX
+
+    def expect_exact_path_match(self):
+        # Do not expect psutil to correctly handle unicode paths on
+        # Python 2 if os.listdir() is not able either.
+        here = '.' if isinstance(self.funky_name, str) else u('.')
+        with warnings.catch_warnings():
+            warnings.simplefilter("ignore")
+            return self.funky_name in os.listdir(here)
+
+
+@unittest.skipIf(CI_TESTING, "unreliable on CI")
+@unittest.skipIf(not try_unicode(INVALID_UNICODE_SUFFIX),
+                 "can't deal with invalid unicode str")
+class TestFSAPIsWithInvalidPath(_BaseFSAPIsTests, PsutilTestCase):
+    """Test FS APIs with a funky, invalid path name."""
+    funky_suffix = INVALID_UNICODE_SUFFIX
+
+    @classmethod
+    def expect_exact_path_match(cls):
+        # Invalid unicode names are supposed to work on Python 2.
+        return True
+
+
+# ===================================================================
+# Non fs APIs
+# ===================================================================
+
+
+class TestNonFSAPIS(PsutilTestCase):
+    """Unicode tests for non fs-related APIs."""
+
+    @unittest.skipIf(not HAS_ENVIRON, "not supported")
+    @unittest.skipIf(PYPY and WINDOWS, "segfaults on PYPY + WINDOWS")
+    def test_proc_environ(self):
+        # Note: differently from others, this test does not deal
+        # with fs paths. On Python 2 subprocess module is broken as
+        # it's not able to handle with non-ASCII env vars, so
+        # we use "è", which is part of the extended ASCII table
+        # (unicode point <= 255).
+        env = os.environ.copy()
+        funky_str = UNICODE_SUFFIX if PY3 else 'è'
+        env['FUNNY_ARG'] = funky_str
+        sproc = self.spawn_testproc(env=env)
+        p = psutil.Process(sproc.pid)
+        env = p.environ()
+        for k, v in env.items():
+            self.assertIsInstance(k, str)
+            self.assertIsInstance(v, str)
+        self.assertEqual(env['FUNNY_ARG'], funky_str)
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_windows.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_windows.py
new file mode 100644
index 0000000000000000000000000000000000000000..580e1e5e09ec59282aef031cdb82f6ca4f39a658
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/psutil/tests/test_windows.py
@@ -0,0 +1,841 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*
+
+# Copyright (c) 2009, Giampaolo Rodola'. All rights reserved.
+# Use of this source code is governed by a BSD-style license that can be
+# found in the LICENSE file.
+
+"""Windows specific tests."""
+
+import datetime
+import errno
+import glob
+import os
+import platform
+import re
+import signal
+import subprocess
+import sys
+import time
+import warnings
+
+import psutil
+from psutil import WINDOWS
+from psutil._compat import FileNotFoundError
+from psutil._compat import super
+from psutil.tests import APPVEYOR
+from psutil.tests import GITHUB_WHEELS
+from psutil.tests import HAS_BATTERY
+from psutil.tests import IS_64BIT
+from psutil.tests import mock
+from psutil.tests import PsutilTestCase
+from psutil.tests import PY3
+from psutil.tests import PYPY
+from psutil.tests import retry_on_failure
+from psutil.tests import sh
+from psutil.tests import spawn_testproc
+from psutil.tests import terminate
+from psutil.tests import TOLERANCE_DISK_USAGE
+from psutil.tests import unittest
+
+
+if WINDOWS and not PYPY:
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore")
+        import win32api  # requires "pip install pywin32"
+        import win32con
+        import win32process
+        import wmi  # requires "pip install wmi" / "make setup-dev-env"
+
+
+cext = psutil._psplatform.cext
+
+
+def wrap_exceptions(fun):
+    def wrapper(self, *args, **kwargs):
+        try:
+            return fun(self, *args, **kwargs)
+        except OSError as err:
+            from psutil._pswindows import ACCESS_DENIED_SET
+            if err.errno in ACCESS_DENIED_SET:
+                raise psutil.AccessDenied(None, None)
+            if err.errno == errno.ESRCH:
+                raise psutil.NoSuchProcess(None, None)
+            raise
+    return wrapper
+
+
+@unittest.skipIf(not WINDOWS, "WINDOWS only")
+@unittest.skipIf(PYPY, "pywin32 not available on PYPY")
+# https://github.com/giampaolo/psutil/pull/1762#issuecomment-632892692
+@unittest.skipIf(GITHUB_WHEELS and (not PY3 or not IS_64BIT),
+                 "pywin32 broken on GITHUB + PY2")
+class WindowsTestCase(PsutilTestCase):
+    pass
+
+
+# ===================================================================
+# System APIs
+# ===================================================================
+
+
+class TestCpuAPIs(WindowsTestCase):
+
+    @unittest.skipIf('NUMBER_OF_PROCESSORS' not in os.environ,
+                     'NUMBER_OF_PROCESSORS env var is not available')
+    def test_cpu_count_vs_NUMBER_OF_PROCESSORS(self):
+        # Will likely fail on many-cores systems:
+        # https://stackoverflow.com/questions/31209256
+        num_cpus = int(os.environ['NUMBER_OF_PROCESSORS'])
+        self.assertEqual(num_cpus, psutil.cpu_count())
+
+    def test_cpu_count_vs_GetSystemInfo(self):
+        # Will likely fail on many-cores systems:
+        # https://stackoverflow.com/questions/31209256
+        sys_value = win32api.GetSystemInfo()[5]
+        psutil_value = psutil.cpu_count()
+        self.assertEqual(sys_value, psutil_value)
+
+    def test_cpu_count_logical_vs_wmi(self):
+        w = wmi.WMI()
+        proc = w.Win32_Processor()[0]
+        self.assertEqual(psutil.cpu_count(), proc.NumberOfLogicalProcessors)
+
+    def test_cpu_count_phys_vs_wmi(self):
+        w = wmi.WMI()
+        proc = w.Win32_Processor()[0]
+        self.assertEqual(psutil.cpu_count(logical=False), proc.NumberOfCores)
+
+    def test_cpu_count_vs_cpu_times(self):
+        self.assertEqual(psutil.cpu_count(),
+                         len(psutil.cpu_times(percpu=True)))
+
+    def test_cpu_freq(self):
+        w = wmi.WMI()
+        proc = w.Win32_Processor()[0]
+        self.assertEqual(proc.CurrentClockSpeed, psutil.cpu_freq().current)
+        self.assertEqual(proc.MaxClockSpeed, psutil.cpu_freq().max)
+
+
+class TestSystemAPIs(WindowsTestCase):
+
+    def test_nic_names(self):
+        out = sh('ipconfig /all')
+        nics = psutil.net_io_counters(pernic=True).keys()
+        for nic in nics:
+            if "pseudo-interface" in nic.replace(' ', '-').lower():
+                continue
+            if nic not in out:
+                self.fail(
+                    "%r nic wasn't found in 'ipconfig /all' output" % nic)
+
+    def test_total_phymem(self):
+        w = wmi.WMI().Win32_ComputerSystem()[0]
+        self.assertEqual(int(w.TotalPhysicalMemory),
+                         psutil.virtual_memory().total)
+
+    # @unittest.skipIf(wmi is None, "wmi module is not installed")
+    # def test__UPTIME(self):
+    #     # _UPTIME constant is not public but it is used internally
+    #     # as value to return for pid 0 creation time.
+    #     # WMI behaves the same.
+    #     w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+    #     p = psutil.Process(0)
+    #     wmic_create = str(w.CreationDate.split('.')[0])
+    #     psutil_create = time.strftime("%Y%m%d%H%M%S",
+    #                                   time.localtime(p.create_time()))
+
+    # Note: this test is not very reliable
+    @unittest.skipIf(APPVEYOR, "test not relieable on appveyor")
+    @retry_on_failure()
+    def test_pids(self):
+        # Note: this test might fail if the OS is starting/killing
+        # other processes in the meantime
+        w = wmi.WMI().Win32_Process()
+        wmi_pids = set([x.ProcessId for x in w])
+        psutil_pids = set(psutil.pids())
+        self.assertEqual(wmi_pids, psutil_pids)
+
+    @retry_on_failure()
+    def test_disks(self):
+        ps_parts = psutil.disk_partitions(all=True)
+        wmi_parts = wmi.WMI().Win32_LogicalDisk()
+        for ps_part in ps_parts:
+            for wmi_part in wmi_parts:
+                if ps_part.device.replace('\\', '') == wmi_part.DeviceID:
+                    if not ps_part.mountpoint:
+                        # this is usually a CD-ROM with no disk inserted
+                        break
+                    if 'cdrom' in ps_part.opts:
+                        break
+                    if ps_part.mountpoint.startswith('A:'):
+                        break  # floppy
+                    try:
+                        usage = psutil.disk_usage(ps_part.mountpoint)
+                    except FileNotFoundError:
+                        # usually this is the floppy
+                        break
+                    self.assertEqual(usage.total, int(wmi_part.Size))
+                    wmi_free = int(wmi_part.FreeSpace)
+                    self.assertEqual(usage.free, wmi_free)
+                    # 10 MB tollerance
+                    if abs(usage.free - wmi_free) > 10 * 1024 * 1024:
+                        self.fail("psutil=%s, wmi=%s" % (
+                            usage.free, wmi_free))
+                    break
+            else:
+                self.fail("can't find partition %s" % repr(ps_part))
+
+    @retry_on_failure()
+    def test_disk_usage(self):
+        for disk in psutil.disk_partitions():
+            if 'cdrom' in disk.opts:
+                continue
+            sys_value = win32api.GetDiskFreeSpaceEx(disk.mountpoint)
+            psutil_value = psutil.disk_usage(disk.mountpoint)
+            self.assertAlmostEqual(sys_value[0], psutil_value.free,
+                                   delta=TOLERANCE_DISK_USAGE)
+            self.assertAlmostEqual(sys_value[1], psutil_value.total,
+                                   delta=TOLERANCE_DISK_USAGE)
+            self.assertEqual(psutil_value.used,
+                             psutil_value.total - psutil_value.free)
+
+    def test_disk_partitions(self):
+        sys_value = [
+            x + '\\' for x in win32api.GetLogicalDriveStrings().split("\\\x00")
+            if x and not x.startswith('A:')]
+        psutil_value = [x.mountpoint for x in psutil.disk_partitions(all=True)
+                        if not x.mountpoint.startswith('A:')]
+        self.assertEqual(sys_value, psutil_value)
+
+    def test_net_if_stats(self):
+        ps_names = set(cext.net_if_stats())
+        wmi_adapters = wmi.WMI().Win32_NetworkAdapter()
+        wmi_names = set()
+        for wmi_adapter in wmi_adapters:
+            wmi_names.add(wmi_adapter.Name)
+            wmi_names.add(wmi_adapter.NetConnectionID)
+        self.assertTrue(ps_names & wmi_names,
+                        "no common entries in %s, %s" % (ps_names, wmi_names))
+
+    def test_boot_time(self):
+        wmi_os = wmi.WMI().Win32_OperatingSystem()
+        wmi_btime_str = wmi_os[0].LastBootUpTime.split('.')[0]
+        wmi_btime_dt = datetime.datetime.strptime(
+            wmi_btime_str, "%Y%m%d%H%M%S")
+        psutil_dt = datetime.datetime.fromtimestamp(psutil.boot_time())
+        diff = abs((wmi_btime_dt - psutil_dt).total_seconds())
+        self.assertLessEqual(diff, 3)
+
+    def test_boot_time_fluctuation(self):
+        # https://github.com/giampaolo/psutil/issues/1007
+        with mock.patch('psutil._pswindows.cext.boot_time', return_value=5):
+            self.assertEqual(psutil.boot_time(), 5)
+        with mock.patch('psutil._pswindows.cext.boot_time', return_value=4):
+            self.assertEqual(psutil.boot_time(), 5)
+        with mock.patch('psutil._pswindows.cext.boot_time', return_value=6):
+            self.assertEqual(psutil.boot_time(), 5)
+        with mock.patch('psutil._pswindows.cext.boot_time', return_value=333):
+            self.assertEqual(psutil.boot_time(), 333)
+
+
+# ===================================================================
+# sensors_battery()
+# ===================================================================
+
+
+class TestSensorsBattery(WindowsTestCase):
+
+    def test_has_battery(self):
+        if win32api.GetPwrCapabilities()['SystemBatteriesPresent']:
+            self.assertIsNotNone(psutil.sensors_battery())
+        else:
+            self.assertIsNone(psutil.sensors_battery())
+
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_percent(self):
+        w = wmi.WMI()
+        battery_wmi = w.query('select * from Win32_Battery')[0]
+        battery_psutil = psutil.sensors_battery()
+        self.assertAlmostEqual(
+            battery_psutil.percent, battery_wmi.EstimatedChargeRemaining,
+            delta=1)
+
+    @unittest.skipIf(not HAS_BATTERY, "no battery")
+    def test_power_plugged(self):
+        w = wmi.WMI()
+        battery_wmi = w.query('select * from Win32_Battery')[0]
+        battery_psutil = psutil.sensors_battery()
+        # Status codes:
+        # https://msdn.microsoft.com/en-us/library/aa394074(v=vs.85).aspx
+        self.assertEqual(battery_psutil.power_plugged,
+                         battery_wmi.BatteryStatus == 2)
+
+    def test_emulate_no_battery(self):
+        with mock.patch("psutil._pswindows.cext.sensors_battery",
+                        return_value=(0, 128, 0, 0)) as m:
+            self.assertIsNone(psutil.sensors_battery())
+            assert m.called
+
+    def test_emulate_power_connected(self):
+        with mock.patch("psutil._pswindows.cext.sensors_battery",
+                        return_value=(1, 0, 0, 0)) as m:
+            self.assertEqual(psutil.sensors_battery().secsleft,
+                             psutil.POWER_TIME_UNLIMITED)
+            assert m.called
+
+    def test_emulate_power_charging(self):
+        with mock.patch("psutil._pswindows.cext.sensors_battery",
+                        return_value=(0, 8, 0, 0)) as m:
+            self.assertEqual(psutil.sensors_battery().secsleft,
+                             psutil.POWER_TIME_UNLIMITED)
+            assert m.called
+
+    def test_emulate_secs_left_unknown(self):
+        with mock.patch("psutil._pswindows.cext.sensors_battery",
+                        return_value=(0, 0, 0, -1)) as m:
+            self.assertEqual(psutil.sensors_battery().secsleft,
+                             psutil.POWER_TIME_UNKNOWN)
+            assert m.called
+
+
+# ===================================================================
+# Process APIs
+# ===================================================================
+
+
+class TestProcess(WindowsTestCase):
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    def test_issue_24(self):
+        p = psutil.Process(0)
+        self.assertRaises(psutil.AccessDenied, p.kill)
+
+    def test_special_pid(self):
+        p = psutil.Process(4)
+        self.assertEqual(p.name(), 'System')
+        # use __str__ to access all common Process properties to check
+        # that nothing strange happens
+        str(p)
+        p.username()
+        self.assertTrue(p.create_time() >= 0.0)
+        try:
+            rss, vms = p.memory_info()[:2]
+        except psutil.AccessDenied:
+            # expected on Windows Vista and Windows 7
+            if not platform.uname()[1] in ('vista', 'win-7', 'win7'):
+                raise
+        else:
+            self.assertTrue(rss > 0)
+
+    def test_send_signal(self):
+        p = psutil.Process(self.pid)
+        self.assertRaises(ValueError, p.send_signal, signal.SIGINT)
+
+    def test_num_handles_increment(self):
+        p = psutil.Process(os.getpid())
+        before = p.num_handles()
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, os.getpid())
+        after = p.num_handles()
+        self.assertEqual(after, before + 1)
+        win32api.CloseHandle(handle)
+        self.assertEqual(p.num_handles(), before)
+
+    @unittest.skipIf(not sys.version_info >= (2, 7),
+                     "CTRL_* signals not supported")
+    def test_ctrl_signals(self):
+        p = psutil.Process(self.spawn_testproc().pid)
+        p.send_signal(signal.CTRL_C_EVENT)
+        p.send_signal(signal.CTRL_BREAK_EVENT)
+        p.kill()
+        p.wait()
+        self.assertRaises(psutil.NoSuchProcess,
+                          p.send_signal, signal.CTRL_C_EVENT)
+        self.assertRaises(psutil.NoSuchProcess,
+                          p.send_signal, signal.CTRL_BREAK_EVENT)
+
+    def test_username(self):
+        self.assertEqual(psutil.Process().username(),
+                         win32api.GetUserNameEx(win32con.NameSamCompatible))
+
+    def test_cmdline(self):
+        sys_value = re.sub(' +', ' ', win32api.GetCommandLine()).strip()
+        psutil_value = ' '.join(psutil.Process().cmdline())
+        self.assertEqual(sys_value, psutil_value)
+
+    # XXX - occasional failures
+
+    # def test_cpu_times(self):
+    #     handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+    #                                   win32con.FALSE, os.getpid())
+    #     self.addCleanup(win32api.CloseHandle, handle)
+    #     sys_value = win32process.GetProcessTimes(handle)
+    #     psutil_value = psutil.Process().cpu_times()
+    #     self.assertAlmostEqual(
+    #         psutil_value.user, sys_value['UserTime'] / 10000000.0,
+    #         delta=0.2)
+    #     self.assertAlmostEqual(
+    #         psutil_value.user, sys_value['KernelTime'] / 10000000.0,
+    #         delta=0.2)
+
+    def test_nice(self):
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, os.getpid())
+        self.addCleanup(win32api.CloseHandle, handle)
+        sys_value = win32process.GetPriorityClass(handle)
+        psutil_value = psutil.Process().nice()
+        self.assertEqual(psutil_value, sys_value)
+
+    def test_memory_info(self):
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, self.pid)
+        self.addCleanup(win32api.CloseHandle, handle)
+        sys_value = win32process.GetProcessMemoryInfo(handle)
+        psutil_value = psutil.Process(self.pid).memory_info()
+        self.assertEqual(
+            sys_value['PeakWorkingSetSize'], psutil_value.peak_wset)
+        self.assertEqual(
+            sys_value['WorkingSetSize'], psutil_value.wset)
+        self.assertEqual(
+            sys_value['QuotaPeakPagedPoolUsage'], psutil_value.peak_paged_pool)
+        self.assertEqual(
+            sys_value['QuotaPagedPoolUsage'], psutil_value.paged_pool)
+        self.assertEqual(
+            sys_value['QuotaPeakNonPagedPoolUsage'],
+            psutil_value.peak_nonpaged_pool)
+        self.assertEqual(
+            sys_value['QuotaNonPagedPoolUsage'], psutil_value.nonpaged_pool)
+        self.assertEqual(
+            sys_value['PagefileUsage'], psutil_value.pagefile)
+        self.assertEqual(
+            sys_value['PeakPagefileUsage'], psutil_value.peak_pagefile)
+
+        self.assertEqual(psutil_value.rss, psutil_value.wset)
+        self.assertEqual(psutil_value.vms, psutil_value.pagefile)
+
+    def test_wait(self):
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, self.pid)
+        self.addCleanup(win32api.CloseHandle, handle)
+        p = psutil.Process(self.pid)
+        p.terminate()
+        psutil_value = p.wait()
+        sys_value = win32process.GetExitCodeProcess(handle)
+        self.assertEqual(psutil_value, sys_value)
+
+    def test_cpu_affinity(self):
+        def from_bitmask(x):
+            return [i for i in range(64) if (1 << i) & x]
+
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, self.pid)
+        self.addCleanup(win32api.CloseHandle, handle)
+        sys_value = from_bitmask(
+            win32process.GetProcessAffinityMask(handle)[0])
+        psutil_value = psutil.Process(self.pid).cpu_affinity()
+        self.assertEqual(psutil_value, sys_value)
+
+    def test_io_counters(self):
+        handle = win32api.OpenProcess(win32con.PROCESS_QUERY_INFORMATION,
+                                      win32con.FALSE, os.getpid())
+        self.addCleanup(win32api.CloseHandle, handle)
+        sys_value = win32process.GetProcessIoCounters(handle)
+        psutil_value = psutil.Process().io_counters()
+        self.assertEqual(
+            psutil_value.read_count, sys_value['ReadOperationCount'])
+        self.assertEqual(
+            psutil_value.write_count, sys_value['WriteOperationCount'])
+        self.assertEqual(
+            psutil_value.read_bytes, sys_value['ReadTransferCount'])
+        self.assertEqual(
+            psutil_value.write_bytes, sys_value['WriteTransferCount'])
+        self.assertEqual(
+            psutil_value.other_count, sys_value['OtherOperationCount'])
+        self.assertEqual(
+            psutil_value.other_bytes, sys_value['OtherTransferCount'])
+
+    def test_num_handles(self):
+        import ctypes
+        import ctypes.wintypes
+        PROCESS_QUERY_INFORMATION = 0x400
+        handle = ctypes.windll.kernel32.OpenProcess(
+            PROCESS_QUERY_INFORMATION, 0, self.pid)
+        self.addCleanup(ctypes.windll.kernel32.CloseHandle, handle)
+
+        hndcnt = ctypes.wintypes.DWORD()
+        ctypes.windll.kernel32.GetProcessHandleCount(
+            handle, ctypes.byref(hndcnt))
+        sys_value = hndcnt.value
+        psutil_value = psutil.Process(self.pid).num_handles()
+        self.assertEqual(psutil_value, sys_value)
+
+    def test_error_partial_copy(self):
+        # https://github.com/giampaolo/psutil/issues/875
+        exc = WindowsError()
+        exc.winerror = 299
+        with mock.patch("psutil._psplatform.cext.proc_cwd", side_effect=exc):
+            with mock.patch("time.sleep") as m:
+                p = psutil.Process()
+                self.assertRaises(psutil.AccessDenied, p.cwd)
+        self.assertGreaterEqual(m.call_count, 5)
+
+    def test_exe(self):
+        # NtQuerySystemInformation succeeds if process is gone. Make sure
+        # it raises NSP for a non existent pid.
+        pid = psutil.pids()[-1] + 99999
+        proc = psutil._psplatform.Process(pid)
+        self.assertRaises(psutil.NoSuchProcess, proc.exe)
+
+
+class TestProcessWMI(WindowsTestCase):
+    """Compare Process API results with WMI."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    def test_name(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        self.assertEqual(p.name(), w.Caption)
+
+    # This fail on github because using virtualenv for test environment
+    @unittest.skipIf(GITHUB_WHEELS, "unreliable path on GITHUB_WHEELS")
+    def test_exe(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        # Note: wmi reports the exe as a lower case string.
+        # Being Windows paths case-insensitive we ignore that.
+        self.assertEqual(p.exe().lower(), w.ExecutablePath.lower())
+
+    def test_cmdline(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        self.assertEqual(' '.join(p.cmdline()),
+                         w.CommandLine.replace('"', ''))
+
+    def test_username(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        domain, _, username = w.GetOwner()
+        username = "%s\\%s" % (domain, username)
+        self.assertEqual(p.username(), username)
+
+    @retry_on_failure()
+    def test_memory_rss(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        rss = p.memory_info().rss
+        self.assertEqual(rss, int(w.WorkingSetSize))
+
+    @retry_on_failure()
+    def test_memory_vms(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        vms = p.memory_info().vms
+        # http://msdn.microsoft.com/en-us/library/aa394372(VS.85).aspx
+        # ...claims that PageFileUsage is represented in Kilo
+        # bytes but funnily enough on certain platforms bytes are
+        # returned instead.
+        wmi_usage = int(w.PageFileUsage)
+        if (vms != wmi_usage) and (vms != wmi_usage * 1024):
+            self.fail("wmi=%s, psutil=%s" % (wmi_usage, vms))
+
+    def test_create_time(self):
+        w = wmi.WMI().Win32_Process(ProcessId=self.pid)[0]
+        p = psutil.Process(self.pid)
+        wmic_create = str(w.CreationDate.split('.')[0])
+        psutil_create = time.strftime("%Y%m%d%H%M%S",
+                                      time.localtime(p.create_time()))
+        self.assertEqual(wmic_create, psutil_create)
+
+
+# ---
+
+
+@unittest.skipIf(not WINDOWS, "WINDOWS only")
+class TestDualProcessImplementation(PsutilTestCase):
+    """
+    Certain APIs on Windows have 2 internal implementations, one
+    based on documented Windows APIs, another one based
+    NtQuerySystemInformation() which gets called as fallback in
+    case the first fails because of limited permission error.
+    Here we test that the two methods return the exact same value,
+    see:
+    https://github.com/giampaolo/psutil/issues/304
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        cls.pid = spawn_testproc().pid
+
+    @classmethod
+    def tearDownClass(cls):
+        terminate(cls.pid)
+
+    def test_memory_info(self):
+        mem_1 = psutil.Process(self.pid).memory_info()
+        with mock.patch("psutil._psplatform.cext.proc_memory_info",
+                        side_effect=OSError(errno.EPERM, "msg")) as fun:
+            mem_2 = psutil.Process(self.pid).memory_info()
+            self.assertEqual(len(mem_1), len(mem_2))
+            for i in range(len(mem_1)):
+                self.assertGreaterEqual(mem_1[i], 0)
+                self.assertGreaterEqual(mem_2[i], 0)
+                self.assertAlmostEqual(mem_1[i], mem_2[i], delta=512)
+            assert fun.called
+
+    def test_create_time(self):
+        ctime = psutil.Process(self.pid).create_time()
+        with mock.patch("psutil._psplatform.cext.proc_times",
+                        side_effect=OSError(errno.EPERM, "msg")) as fun:
+            self.assertEqual(psutil.Process(self.pid).create_time(), ctime)
+            assert fun.called
+
+    def test_cpu_times(self):
+        cpu_times_1 = psutil.Process(self.pid).cpu_times()
+        with mock.patch("psutil._psplatform.cext.proc_times",
+                        side_effect=OSError(errno.EPERM, "msg")) as fun:
+            cpu_times_2 = psutil.Process(self.pid).cpu_times()
+            assert fun.called
+            self.assertAlmostEqual(
+                cpu_times_1.user, cpu_times_2.user, delta=0.01)
+            self.assertAlmostEqual(
+                cpu_times_1.system, cpu_times_2.system, delta=0.01)
+
+    def test_io_counters(self):
+        io_counters_1 = psutil.Process(self.pid).io_counters()
+        with mock.patch("psutil._psplatform.cext.proc_io_counters",
+                        side_effect=OSError(errno.EPERM, "msg")) as fun:
+            io_counters_2 = psutil.Process(self.pid).io_counters()
+            for i in range(len(io_counters_1)):
+                self.assertAlmostEqual(
+                    io_counters_1[i], io_counters_2[i], delta=5)
+            assert fun.called
+
+    def test_num_handles(self):
+        num_handles = psutil.Process(self.pid).num_handles()
+        with mock.patch("psutil._psplatform.cext.proc_num_handles",
+                        side_effect=OSError(errno.EPERM, "msg")) as fun:
+            self.assertEqual(psutil.Process(self.pid).num_handles(),
+                             num_handles)
+            assert fun.called
+
+    def test_cmdline(self):
+        from psutil._pswindows import convert_oserror
+        for pid in psutil.pids():
+            try:
+                a = cext.proc_cmdline(pid, use_peb=True)
+                b = cext.proc_cmdline(pid, use_peb=False)
+            except OSError as err:
+                err = convert_oserror(err)
+                if not isinstance(err, (psutil.AccessDenied,
+                                        psutil.NoSuchProcess)):
+                    raise
+            else:
+                self.assertEqual(a, b)
+
+
+@unittest.skipIf(not WINDOWS, "WINDOWS only")
+class RemoteProcessTestCase(PsutilTestCase):
+    """Certain functions require calling ReadProcessMemory.
+    This trivially works when called on the current process.
+    Check that this works on other processes, especially when they
+    have a different bitness.
+    """
+
+    @staticmethod
+    def find_other_interpreter():
+        # find a python interpreter that is of the opposite bitness from us
+        code = "import sys; sys.stdout.write(str(sys.maxsize > 2**32))"
+
+        # XXX: a different and probably more stable approach might be to access
+        # the registry but accessing 64 bit paths from a 32 bit process
+        for filename in glob.glob(r"C:\Python*\python.exe"):
+            proc = subprocess.Popen(args=[filename, "-c", code],
+                                    stdout=subprocess.PIPE,
+                                    stderr=subprocess.STDOUT)
+            output, _ = proc.communicate()
+            proc.wait()
+            if output == str(not IS_64BIT):
+                return filename
+
+    test_args = ["-c", "import sys; sys.stdin.read()"]
+
+    def setUp(self):
+        super().setUp()
+
+        other_python = self.find_other_interpreter()
+        if other_python is None:
+            raise unittest.SkipTest(
+                "could not find interpreter with opposite bitness")
+        if IS_64BIT:
+            self.python64 = sys.executable
+            self.python32 = other_python
+        else:
+            self.python64 = other_python
+            self.python32 = sys.executable
+
+        env = os.environ.copy()
+        env["THINK_OF_A_NUMBER"] = str(os.getpid())
+        self.proc32 = self.spawn_testproc(
+            [self.python32] + self.test_args,
+            env=env,
+            stdin=subprocess.PIPE)
+        self.proc64 = self.spawn_testproc(
+            [self.python64] + self.test_args,
+            env=env,
+            stdin=subprocess.PIPE)
+
+    def tearDown(self):
+        super().tearDown()
+        self.proc32.communicate()
+        self.proc64.communicate()
+
+    def test_cmdline_32(self):
+        p = psutil.Process(self.proc32.pid)
+        self.assertEqual(len(p.cmdline()), 3)
+        self.assertEqual(p.cmdline()[1:], self.test_args)
+
+    def test_cmdline_64(self):
+        p = psutil.Process(self.proc64.pid)
+        self.assertEqual(len(p.cmdline()), 3)
+        self.assertEqual(p.cmdline()[1:], self.test_args)
+
+    def test_cwd_32(self):
+        p = psutil.Process(self.proc32.pid)
+        self.assertEqual(p.cwd(), os.getcwd())
+
+    def test_cwd_64(self):
+        p = psutil.Process(self.proc64.pid)
+        self.assertEqual(p.cwd(), os.getcwd())
+
+    def test_environ_32(self):
+        p = psutil.Process(self.proc32.pid)
+        e = p.environ()
+        self.assertIn("THINK_OF_A_NUMBER", e)
+        self.assertEquals(e["THINK_OF_A_NUMBER"], str(os.getpid()))
+
+    def test_environ_64(self):
+        p = psutil.Process(self.proc64.pid)
+        try:
+            p.environ()
+        except psutil.AccessDenied:
+            pass
+
+
+# ===================================================================
+# Windows services
+# ===================================================================
+
+
+@unittest.skipIf(not WINDOWS, "WINDOWS only")
+class TestServices(PsutilTestCase):
+
+    def test_win_service_iter(self):
+        valid_statuses = set([
+            "running",
+            "paused",
+            "start",
+            "pause",
+            "continue",
+            "stop",
+            "stopped",
+        ])
+        valid_start_types = set([
+            "automatic",
+            "manual",
+            "disabled",
+        ])
+        valid_statuses = set([
+            "running",
+            "paused",
+            "start_pending",
+            "pause_pending",
+            "continue_pending",
+            "stop_pending",
+            "stopped"
+        ])
+        for serv in psutil.win_service_iter():
+            data = serv.as_dict()
+            self.assertIsInstance(data['name'], str)
+            self.assertNotEqual(data['name'].strip(), "")
+            self.assertIsInstance(data['display_name'], str)
+            self.assertIsInstance(data['username'], str)
+            self.assertIn(data['status'], valid_statuses)
+            if data['pid'] is not None:
+                psutil.Process(data['pid'])
+            self.assertIsInstance(data['binpath'], str)
+            self.assertIsInstance(data['username'], str)
+            self.assertIsInstance(data['start_type'], str)
+            self.assertIn(data['start_type'], valid_start_types)
+            self.assertIn(data['status'], valid_statuses)
+            self.assertIsInstance(data['description'], str)
+            pid = serv.pid()
+            if pid is not None:
+                p = psutil.Process(pid)
+                self.assertTrue(p.is_running())
+            # win_service_get
+            s = psutil.win_service_get(serv.name())
+            # test __eq__
+            self.assertEqual(serv, s)
+
+    def test_win_service_get(self):
+        ERROR_SERVICE_DOES_NOT_EXIST = \
+            psutil._psplatform.cext.ERROR_SERVICE_DOES_NOT_EXIST
+        ERROR_ACCESS_DENIED = psutil._psplatform.cext.ERROR_ACCESS_DENIED
+
+        name = next(psutil.win_service_iter()).name()
+        with self.assertRaises(psutil.NoSuchProcess) as cm:
+            psutil.win_service_get(name + '???')
+        self.assertEqual(cm.exception.name, name + '???')
+
+        # test NoSuchProcess
+        service = psutil.win_service_get(name)
+        if PY3:
+            args = (0, "msg", 0, ERROR_SERVICE_DOES_NOT_EXIST)
+        else:
+            args = (ERROR_SERVICE_DOES_NOT_EXIST, "msg")
+        exc = WindowsError(*args)
+        with mock.patch("psutil._psplatform.cext.winservice_query_status",
+                        side_effect=exc):
+            self.assertRaises(psutil.NoSuchProcess, service.status)
+        with mock.patch("psutil._psplatform.cext.winservice_query_config",
+                        side_effect=exc):
+            self.assertRaises(psutil.NoSuchProcess, service.username)
+
+        # test AccessDenied
+        if PY3:
+            args = (0, "msg", 0, ERROR_ACCESS_DENIED)
+        else:
+            args = (ERROR_ACCESS_DENIED, "msg")
+        exc = WindowsError(*args)
+        with mock.patch("psutil._psplatform.cext.winservice_query_status",
+                        side_effect=exc):
+            self.assertRaises(psutil.AccessDenied, service.status)
+        with mock.patch("psutil._psplatform.cext.winservice_query_config",
+                        side_effect=exc):
+            self.assertRaises(psutil.AccessDenied, service.username)
+
+        # test __str__ and __repr__
+        self.assertIn(service.name(), str(service))
+        self.assertIn(service.display_name(), str(service))
+        self.assertIn(service.name(), repr(service))
+        self.assertIn(service.display_name(), repr(service))
+
+
+if __name__ == '__main__':
+    from psutil.tests.runner import run_from_name
+    run_from_name(__file__)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/__init__.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..13d687c501c854057404469446c680231fbc92e5
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/__init__.py
@@ -0,0 +1,427 @@
+
+from .error import *
+
+from .tokens import *
+from .events import *
+from .nodes import *
+
+from .loader import *
+from .dumper import *
+
+__version__ = '5.3.1'
+try:
+    from .cyaml import *
+    __with_libyaml__ = True
+except ImportError:
+    __with_libyaml__ = False
+
+import io
+
+#------------------------------------------------------------------------------
+# Warnings control
+#------------------------------------------------------------------------------
+
+# 'Global' warnings state:
+_warnings_enabled = {
+    'YAMLLoadWarning': True,
+}
+
+# Get or set global warnings' state
+def warnings(settings=None):
+    if settings is None:
+        return _warnings_enabled
+
+    if type(settings) is dict:
+        for key in settings:
+            if key in _warnings_enabled:
+                _warnings_enabled[key] = settings[key]
+
+# Warn when load() is called without Loader=...
+class YAMLLoadWarning(RuntimeWarning):
+    pass
+
+def load_warning(method):
+    if _warnings_enabled['YAMLLoadWarning'] is False:
+        return
+
+    import warnings
+
+    message = (
+        "calling yaml.%s() without Loader=... is deprecated, as the "
+        "default Loader is unsafe. Please read "
+        "https://msg.pyyaml.org/load for full details."
+    ) % method
+
+    warnings.warn(message, YAMLLoadWarning, stacklevel=3)
+
+#------------------------------------------------------------------------------
+def scan(stream, Loader=Loader):
+    """
+    Scan a YAML stream and produce scanning tokens.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_token():
+            yield loader.get_token()
+    finally:
+        loader.dispose()
+
+def parse(stream, Loader=Loader):
+    """
+    Parse a YAML stream and produce parsing events.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_event():
+            yield loader.get_event()
+    finally:
+        loader.dispose()
+
+def compose(stream, Loader=Loader):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding representation tree.
+    """
+    loader = Loader(stream)
+    try:
+        return loader.get_single_node()
+    finally:
+        loader.dispose()
+
+def compose_all(stream, Loader=Loader):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding representation trees.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_node():
+            yield loader.get_node()
+    finally:
+        loader.dispose()
+
+def load(stream, Loader=None):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+    """
+    if Loader is None:
+        load_warning('load')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        return loader.get_single_data()
+    finally:
+        loader.dispose()
+
+def load_all(stream, Loader=None):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+    """
+    if Loader is None:
+        load_warning('load_all')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        while loader.check_data():
+            yield loader.get_data()
+    finally:
+        loader.dispose()
+
+def full_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, FullLoader)
+
+def full_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, FullLoader)
+
+def safe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load(stream, SafeLoader)
+
+def safe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load_all(stream, SafeLoader)
+
+def unsafe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, UnsafeLoader)
+
+def unsafe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, UnsafeLoader)
+
+def emit(events, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None):
+    """
+    Emit YAML parsing events into a stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        stream = io.StringIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break)
+    try:
+        for event in events:
+            dumper.emit(event)
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize_all(nodes, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None):
+    """
+    Serialize a sequence of representation trees into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end)
+    try:
+        dumper.open()
+        for node in nodes:
+            dumper.serialize(node)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize(node, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a representation tree into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return serialize_all([node], stream, Dumper=Dumper, **kwds)
+
+def dump_all(documents, stream=None, Dumper=Dumper,
+        default_style=None, default_flow_style=False,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None, sort_keys=True):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, default_style=default_style,
+            default_flow_style=default_flow_style,
+            canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end, sort_keys=sort_keys)
+    try:
+        dumper.open()
+        for data in documents:
+            dumper.represent(data)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def dump(data, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=Dumper, **kwds)
+
+def safe_dump_all(documents, stream=None, **kwds):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all(documents, stream, Dumper=SafeDumper, **kwds)
+
+def safe_dump(data, stream=None, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=SafeDumper, **kwds)
+
+def add_implicit_resolver(tag, regexp, first=None,
+        Loader=None, Dumper=Dumper):
+    """
+    Add an implicit scalar detector.
+    If an implicit scalar value matches the given regexp,
+    the corresponding tag is assigned to the scalar.
+    first is a sequence of possible initial characters or None.
+    """
+    if Loader is None:
+        loader.Loader.add_implicit_resolver(tag, regexp, first)
+        loader.FullLoader.add_implicit_resolver(tag, regexp, first)
+        loader.UnsafeLoader.add_implicit_resolver(tag, regexp, first)
+    else:
+        Loader.add_implicit_resolver(tag, regexp, first)
+    Dumper.add_implicit_resolver(tag, regexp, first)
+
+def add_path_resolver(tag, path, kind=None, Loader=None, Dumper=Dumper):
+    """
+    Add a path based resolver for the given tag.
+    A path is a list of keys that forms a path
+    to a node in the representation tree.
+    Keys can be string values, integers, or None.
+    """
+    if Loader is None:
+        loader.Loader.add_path_resolver(tag, path, kind)
+        loader.FullLoader.add_path_resolver(tag, path, kind)
+        loader.UnsafeLoader.add_path_resolver(tag, path, kind)
+    else:
+        Loader.add_path_resolver(tag, path, kind)
+    Dumper.add_path_resolver(tag, path, kind)
+
+def add_constructor(tag, constructor, Loader=None):
+    """
+    Add a constructor for the given tag.
+    Constructor is a function that accepts a Loader instance
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_constructor(tag, constructor)
+        loader.FullLoader.add_constructor(tag, constructor)
+        loader.UnsafeLoader.add_constructor(tag, constructor)
+    else:
+        Loader.add_constructor(tag, constructor)
+
+def add_multi_constructor(tag_prefix, multi_constructor, Loader=None):
+    """
+    Add a multi-constructor for the given tag prefix.
+    Multi-constructor is called for a node if its tag starts with tag_prefix.
+    Multi-constructor accepts a Loader instance, a tag suffix,
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.FullLoader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.UnsafeLoader.add_multi_constructor(tag_prefix, multi_constructor)
+    else:
+        Loader.add_multi_constructor(tag_prefix, multi_constructor)
+
+def add_representer(data_type, representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Representer is a function accepting a Dumper instance
+    and an instance of the given data type
+    and producing the corresponding representation node.
+    """
+    Dumper.add_representer(data_type, representer)
+
+def add_multi_representer(data_type, multi_representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Multi-representer is a function accepting a Dumper instance
+    and an instance of the given data type or subtype
+    and producing the corresponding representation node.
+    """
+    Dumper.add_multi_representer(data_type, multi_representer)
+
+class YAMLObjectMetaclass(type):
+    """
+    The metaclass for YAMLObject.
+    """
+    def __init__(cls, name, bases, kwds):
+        super(YAMLObjectMetaclass, cls).__init__(name, bases, kwds)
+        if 'yaml_tag' in kwds and kwds['yaml_tag'] is not None:
+            if isinstance(cls.yaml_loader, list):
+                for loader in cls.yaml_loader:
+                    loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+            else:
+                cls.yaml_loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+
+            cls.yaml_dumper.add_representer(cls, cls.to_yaml)
+
+class YAMLObject(metaclass=YAMLObjectMetaclass):
+    """
+    An object that can dump itself to a YAML stream
+    and load itself from a YAML stream.
+    """
+
+    __slots__ = ()  # no direct instantiation, so allow immutable subclasses
+
+    yaml_loader = [Loader, FullLoader, UnsafeLoader]
+    yaml_dumper = Dumper
+
+    yaml_tag = None
+    yaml_flow_style = None
+
+    @classmethod
+    def from_yaml(cls, loader, node):
+        """
+        Convert a representation node to a Python object.
+        """
+        return loader.construct_yaml_object(node, cls)
+
+    @classmethod
+    def to_yaml(cls, dumper, data):
+        """
+        Convert a Python object to a representation node.
+        """
+        return dumper.represent_yaml_object(cls.yaml_tag, data, cls,
+                flow_style=cls.yaml_flow_style)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/composer.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/composer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d15cb40e3b4198819c91c6f8d8b32807fcf53b2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/composer.py
@@ -0,0 +1,139 @@
+
+__all__ = ['Composer', 'ComposerError']
+
+from .error import MarkedYAMLError
+from .events import *
+from .nodes import *
+
+class ComposerError(MarkedYAMLError):
+    pass
+
+class Composer:
+
+    def __init__(self):
+        self.anchors = {}
+
+    def check_node(self):
+        # Drop the STREAM-START event.
+        if self.check_event(StreamStartEvent):
+            self.get_event()
+
+        # If there are more documents available?
+        return not self.check_event(StreamEndEvent)
+
+    def get_node(self):
+        # Get the root node of the next document.
+        if not self.check_event(StreamEndEvent):
+            return self.compose_document()
+
+    def get_single_node(self):
+        # Drop the STREAM-START event.
+        self.get_event()
+
+        # Compose a document if the stream is not empty.
+        document = None
+        if not self.check_event(StreamEndEvent):
+            document = self.compose_document()
+
+        # Ensure that the stream contains no more documents.
+        if not self.check_event(StreamEndEvent):
+            event = self.get_event()
+            raise ComposerError("expected a single document in the stream",
+                    document.start_mark, "but found another document",
+                    event.start_mark)
+
+        # Drop the STREAM-END event.
+        self.get_event()
+
+        return document
+
+    def compose_document(self):
+        # Drop the DOCUMENT-START event.
+        self.get_event()
+
+        # Compose the root node.
+        node = self.compose_node(None, None)
+
+        # Drop the DOCUMENT-END event.
+        self.get_event()
+
+        self.anchors = {}
+        return node
+
+    def compose_node(self, parent, index):
+        if self.check_event(AliasEvent):
+            event = self.get_event()
+            anchor = event.anchor
+            if anchor not in self.anchors:
+                raise ComposerError(None, None, "found undefined alias %r"
+                        % anchor, event.start_mark)
+            return self.anchors[anchor]
+        event = self.peek_event()
+        anchor = event.anchor
+        if anchor is not None:
+            if anchor in self.anchors:
+                raise ComposerError("found duplicate anchor %r; first occurrence"
+                        % anchor, self.anchors[anchor].start_mark,
+                        "second occurrence", event.start_mark)
+        self.descend_resolver(parent, index)
+        if self.check_event(ScalarEvent):
+            node = self.compose_scalar_node(anchor)
+        elif self.check_event(SequenceStartEvent):
+            node = self.compose_sequence_node(anchor)
+        elif self.check_event(MappingStartEvent):
+            node = self.compose_mapping_node(anchor)
+        self.ascend_resolver()
+        return node
+
+    def compose_scalar_node(self, anchor):
+        event = self.get_event()
+        tag = event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(ScalarNode, event.value, event.implicit)
+        node = ScalarNode(tag, event.value,
+                event.start_mark, event.end_mark, style=event.style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        return node
+
+    def compose_sequence_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(SequenceNode, None, start_event.implicit)
+        node = SequenceNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        index = 0
+        while not self.check_event(SequenceEndEvent):
+            node.value.append(self.compose_node(node, index))
+            index += 1
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
+    def compose_mapping_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(MappingNode, None, start_event.implicit)
+        node = MappingNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        while not self.check_event(MappingEndEvent):
+            #key_event = self.peek_event()
+            item_key = self.compose_node(node, None)
+            #if item_key in node.value:
+            #    raise ComposerError("while composing a mapping", start_event.start_mark,
+            #            "found duplicate key", key_event.start_mark)
+            item_value = self.compose_node(node, item_key)
+            #node.value[item_key] = item_value
+            node.value.append((item_key, item_value))
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/constructor.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/constructor.py
new file mode 100644
index 0000000000000000000000000000000000000000..1948b125c205261864156b18178c1af3f535ad76
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/constructor.py
@@ -0,0 +1,748 @@
+
+__all__ = [
+    'BaseConstructor',
+    'SafeConstructor',
+    'FullConstructor',
+    'UnsafeConstructor',
+    'Constructor',
+    'ConstructorError'
+]
+
+from .error import *
+from .nodes import *
+
+import collections.abc, datetime, base64, binascii, re, sys, types
+
+class ConstructorError(MarkedYAMLError):
+    pass
+
+class BaseConstructor:
+
+    yaml_constructors = {}
+    yaml_multi_constructors = {}
+
+    def __init__(self):
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.state_generators = []
+        self.deep_construct = False
+
+    def check_data(self):
+        # If there are more documents available?
+        return self.check_node()
+
+    def check_state_key(self, key):
+        """Block special attributes/methods from being set in a newly created
+        object, to prevent user-controlled methods from being called during
+        deserialization"""
+        if self.get_state_keys_blacklist_regexp().match(key):
+            raise ConstructorError(None, None,
+                "blacklisted key '%s' in instance state found" % (key,), None)
+
+    def get_data(self):
+        # Construct and return the next document.
+        if self.check_node():
+            return self.construct_document(self.get_node())
+
+    def get_single_data(self):
+        # Ensure that the stream contains a single document and construct it.
+        node = self.get_single_node()
+        if node is not None:
+            return self.construct_document(node)
+        return None
+
+    def construct_document(self, node):
+        data = self.construct_object(node)
+        while self.state_generators:
+            state_generators = self.state_generators
+            self.state_generators = []
+            for generator in state_generators:
+                for dummy in generator:
+                    pass
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.deep_construct = False
+        return data
+
+    def construct_object(self, node, deep=False):
+        if node in self.constructed_objects:
+            return self.constructed_objects[node]
+        if deep:
+            old_deep = self.deep_construct
+            self.deep_construct = True
+        if node in self.recursive_objects:
+            raise ConstructorError(None, None,
+                    "found unconstructable recursive node", node.start_mark)
+        self.recursive_objects[node] = None
+        constructor = None
+        tag_suffix = None
+        if node.tag in self.yaml_constructors:
+            constructor = self.yaml_constructors[node.tag]
+        else:
+            for tag_prefix in self.yaml_multi_constructors:
+                if tag_prefix is not None and node.tag.startswith(tag_prefix):
+                    tag_suffix = node.tag[len(tag_prefix):]
+                    constructor = self.yaml_multi_constructors[tag_prefix]
+                    break
+            else:
+                if None in self.yaml_multi_constructors:
+                    tag_suffix = node.tag
+                    constructor = self.yaml_multi_constructors[None]
+                elif None in self.yaml_constructors:
+                    constructor = self.yaml_constructors[None]
+                elif isinstance(node, ScalarNode):
+                    constructor = self.__class__.construct_scalar
+                elif isinstance(node, SequenceNode):
+                    constructor = self.__class__.construct_sequence
+                elif isinstance(node, MappingNode):
+                    constructor = self.__class__.construct_mapping
+        if tag_suffix is None:
+            data = constructor(self, node)
+        else:
+            data = constructor(self, tag_suffix, node)
+        if isinstance(data, types.GeneratorType):
+            generator = data
+            data = next(generator)
+            if self.deep_construct:
+                for dummy in generator:
+                    pass
+            else:
+                self.state_generators.append(generator)
+        self.constructed_objects[node] = data
+        del self.recursive_objects[node]
+        if deep:
+            self.deep_construct = old_deep
+        return data
+
+    def construct_scalar(self, node):
+        if not isinstance(node, ScalarNode):
+            raise ConstructorError(None, None,
+                    "expected a scalar node, but found %s" % node.id,
+                    node.start_mark)
+        return node.value
+
+    def construct_sequence(self, node, deep=False):
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError(None, None,
+                    "expected a sequence node, but found %s" % node.id,
+                    node.start_mark)
+        return [self.construct_object(child, deep=deep)
+                for child in node.value]
+
+    def construct_mapping(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        mapping = {}
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            if not isinstance(key, collections.abc.Hashable):
+                raise ConstructorError("while constructing a mapping", node.start_mark,
+                        "found unhashable key", key_node.start_mark)
+            value = self.construct_object(value_node, deep=deep)
+            mapping[key] = value
+        return mapping
+
+    def construct_pairs(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        pairs = []
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            value = self.construct_object(value_node, deep=deep)
+            pairs.append((key, value))
+        return pairs
+
+    @classmethod
+    def add_constructor(cls, tag, constructor):
+        if not 'yaml_constructors' in cls.__dict__:
+            cls.yaml_constructors = cls.yaml_constructors.copy()
+        cls.yaml_constructors[tag] = constructor
+
+    @classmethod
+    def add_multi_constructor(cls, tag_prefix, multi_constructor):
+        if not 'yaml_multi_constructors' in cls.__dict__:
+            cls.yaml_multi_constructors = cls.yaml_multi_constructors.copy()
+        cls.yaml_multi_constructors[tag_prefix] = multi_constructor
+
+class SafeConstructor(BaseConstructor):
+
+    def construct_scalar(self, node):
+        if isinstance(node, MappingNode):
+            for key_node, value_node in node.value:
+                if key_node.tag == 'tag:yaml.org,2002:value':
+                    return self.construct_scalar(value_node)
+        return super().construct_scalar(node)
+
+    def flatten_mapping(self, node):
+        merge = []
+        index = 0
+        while index < len(node.value):
+            key_node, value_node = node.value[index]
+            if key_node.tag == 'tag:yaml.org,2002:merge':
+                del node.value[index]
+                if isinstance(value_node, MappingNode):
+                    self.flatten_mapping(value_node)
+                    merge.extend(value_node.value)
+                elif isinstance(value_node, SequenceNode):
+                    submerge = []
+                    for subnode in value_node.value:
+                        if not isinstance(subnode, MappingNode):
+                            raise ConstructorError("while constructing a mapping",
+                                    node.start_mark,
+                                    "expected a mapping for merging, but found %s"
+                                    % subnode.id, subnode.start_mark)
+                        self.flatten_mapping(subnode)
+                        submerge.append(subnode.value)
+                    submerge.reverse()
+                    for value in submerge:
+                        merge.extend(value)
+                else:
+                    raise ConstructorError("while constructing a mapping", node.start_mark,
+                            "expected a mapping or list of mappings for merging, but found %s"
+                            % value_node.id, value_node.start_mark)
+            elif key_node.tag == 'tag:yaml.org,2002:value':
+                key_node.tag = 'tag:yaml.org,2002:str'
+                index += 1
+            else:
+                index += 1
+        if merge:
+            node.value = merge + node.value
+
+    def construct_mapping(self, node, deep=False):
+        if isinstance(node, MappingNode):
+            self.flatten_mapping(node)
+        return super().construct_mapping(node, deep=deep)
+
+    def construct_yaml_null(self, node):
+        self.construct_scalar(node)
+        return None
+
+    bool_values = {
+        'yes':      True,
+        'no':       False,
+        'true':     True,
+        'false':    False,
+        'on':       True,
+        'off':      False,
+    }
+
+    def construct_yaml_bool(self, node):
+        value = self.construct_scalar(node)
+        return self.bool_values[value.lower()]
+
+    def construct_yaml_int(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '')
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '0':
+            return 0
+        elif value.startswith('0b'):
+            return sign*int(value[2:], 2)
+        elif value.startswith('0x'):
+            return sign*int(value[2:], 16)
+        elif value[0] == '0':
+            return sign*int(value, 8)
+        elif ':' in value:
+            digits = [int(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*int(value)
+
+    inf_value = 1e300
+    while inf_value != inf_value*inf_value:
+        inf_value *= inf_value
+    nan_value = -inf_value/inf_value   # Trying to make a quiet NaN (like C99).
+
+    def construct_yaml_float(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '').lower()
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '.inf':
+            return sign*self.inf_value
+        elif value == '.nan':
+            return self.nan_value
+        elif ':' in value:
+            digits = [float(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0.0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*float(value)
+
+    def construct_yaml_binary(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    timestamp_regexp = re.compile(
+            r'''^(?P<year>[0-9][0-9][0-9][0-9])
+                -(?P<month>[0-9][0-9]?)
+                -(?P<day>[0-9][0-9]?)
+                (?:(?:[Tt]|[ \t]+)
+                (?P<hour>[0-9][0-9]?)
+                :(?P<minute>[0-9][0-9])
+                :(?P<second>[0-9][0-9])
+                (?:\.(?P<fraction>[0-9]*))?
+                (?:[ \t]*(?P<tz>Z|(?P<tz_sign>[-+])(?P<tz_hour>[0-9][0-9]?)
+                (?::(?P<tz_minute>[0-9][0-9]))?))?)?$''', re.X)
+
+    def construct_yaml_timestamp(self, node):
+        value = self.construct_scalar(node)
+        match = self.timestamp_regexp.match(node.value)
+        values = match.groupdict()
+        year = int(values['year'])
+        month = int(values['month'])
+        day = int(values['day'])
+        if not values['hour']:
+            return datetime.date(year, month, day)
+        hour = int(values['hour'])
+        minute = int(values['minute'])
+        second = int(values['second'])
+        fraction = 0
+        tzinfo = None
+        if values['fraction']:
+            fraction = values['fraction'][:6]
+            while len(fraction) < 6:
+                fraction += '0'
+            fraction = int(fraction)
+        if values['tz_sign']:
+            tz_hour = int(values['tz_hour'])
+            tz_minute = int(values['tz_minute'] or 0)
+            delta = datetime.timedelta(hours=tz_hour, minutes=tz_minute)
+            if values['tz_sign'] == '-':
+                delta = -delta
+            tzinfo = datetime.timezone(delta)
+        elif values['tz']:
+            tzinfo = datetime.timezone.utc
+        return datetime.datetime(year, month, day, hour, minute, second, fraction,
+                                 tzinfo=tzinfo)
+
+    def construct_yaml_omap(self, node):
+        # Note: we do not check for duplicate keys, because it's too
+        # CPU-expensive.
+        omap = []
+        yield omap
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing an ordered map", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            omap.append((key, value))
+
+    def construct_yaml_pairs(self, node):
+        # Note: the same code as `construct_yaml_omap`.
+        pairs = []
+        yield pairs
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing pairs", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            pairs.append((key, value))
+
+    def construct_yaml_set(self, node):
+        data = set()
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_yaml_seq(self, node):
+        data = []
+        yield data
+        data.extend(self.construct_sequence(node))
+
+    def construct_yaml_map(self, node):
+        data = {}
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_object(self, node, cls):
+        data = cls.__new__(cls)
+        yield data
+        if hasattr(data, '__setstate__'):
+            state = self.construct_mapping(node, deep=True)
+            data.__setstate__(state)
+        else:
+            state = self.construct_mapping(node)
+            data.__dict__.update(state)
+
+    def construct_undefined(self, node):
+        raise ConstructorError(None, None,
+                "could not determine a constructor for the tag %r" % node.tag,
+                node.start_mark)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:null',
+        SafeConstructor.construct_yaml_null)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:bool',
+        SafeConstructor.construct_yaml_bool)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:int',
+        SafeConstructor.construct_yaml_int)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:float',
+        SafeConstructor.construct_yaml_float)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:binary',
+        SafeConstructor.construct_yaml_binary)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:timestamp',
+        SafeConstructor.construct_yaml_timestamp)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:omap',
+        SafeConstructor.construct_yaml_omap)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:pairs',
+        SafeConstructor.construct_yaml_pairs)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:set',
+        SafeConstructor.construct_yaml_set)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:str',
+        SafeConstructor.construct_yaml_str)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:seq',
+        SafeConstructor.construct_yaml_seq)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:map',
+        SafeConstructor.construct_yaml_map)
+
+SafeConstructor.add_constructor(None,
+        SafeConstructor.construct_undefined)
+
+class FullConstructor(SafeConstructor):
+    # 'extend' is blacklisted because it is used by
+    # construct_python_object_apply to add `listitems` to a newly generate
+    # python instance
+    def get_state_keys_blacklist(self):
+        return ['^extend$', '^__.*__$']
+
+    def get_state_keys_blacklist_regexp(self):
+        if not hasattr(self, 'state_keys_blacklist_regexp'):
+            self.state_keys_blacklist_regexp = re.compile('(' + '|'.join(self.get_state_keys_blacklist()) + ')')
+        return self.state_keys_blacklist_regexp
+
+    def construct_python_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_unicode(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_bytes(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    def construct_python_long(self, node):
+        return self.construct_yaml_int(node)
+
+    def construct_python_complex(self, node):
+       return complex(self.construct_scalar(node))
+
+    def construct_python_tuple(self, node):
+        return tuple(self.construct_sequence(node))
+
+    def find_python_module(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if unsafe:
+            try:
+                __import__(name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python module", mark,
+                        "cannot find module %r (%s)" % (name, exc), mark)
+        if name not in sys.modules:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "module %r is not imported" % name, mark)
+        return sys.modules[name]
+
+    def find_python_name(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if '.' in name:
+            module_name, object_name = name.rsplit('.', 1)
+        else:
+            module_name = 'builtins'
+            object_name = name
+        if unsafe:
+            try:
+                __import__(module_name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python object", mark,
+                        "cannot find module %r (%s)" % (module_name, exc), mark)
+        if module_name not in sys.modules:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "module %r is not imported" % module_name, mark)
+        module = sys.modules[module_name]
+        if not hasattr(module, object_name):
+            raise ConstructorError("while constructing a Python object", mark,
+                    "cannot find %r in the module %r"
+                    % (object_name, module.__name__), mark)
+        return getattr(module, object_name)
+
+    def construct_python_name(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python name", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_name(suffix, node.start_mark)
+
+    def construct_python_module(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python module", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_module(suffix, node.start_mark)
+
+    def make_python_instance(self, suffix, node,
+            args=None, kwds=None, newobj=False, unsafe=False):
+        if not args:
+            args = []
+        if not kwds:
+            kwds = {}
+        cls = self.find_python_name(suffix, node.start_mark)
+        if not (unsafe or isinstance(cls, type)):
+            raise ConstructorError("while constructing a Python instance", node.start_mark,
+                    "expected a class, but found %r" % type(cls),
+                    node.start_mark)
+        if newobj and isinstance(cls, type):
+            return cls.__new__(cls, *args, **kwds)
+        else:
+            return cls(*args, **kwds)
+
+    def set_python_instance_state(self, instance, state, unsafe=False):
+        if hasattr(instance, '__setstate__'):
+            instance.__setstate__(state)
+        else:
+            slotstate = {}
+            if isinstance(state, tuple) and len(state) == 2:
+                state, slotstate = state
+            if hasattr(instance, '__dict__'):
+                if not unsafe and state:
+                    for key in state.keys():
+                        self.check_state_key(key)
+                instance.__dict__.update(state)
+            elif state:
+                slotstate.update(state)
+            for key, value in slotstate.items():
+                if not unsafe:
+                    self.check_state_key(key)
+                setattr(instance, key, value)
+
+    def construct_python_object(self, suffix, node):
+        # Format:
+        #   !!python/object:module.name { ... state ... }
+        instance = self.make_python_instance(suffix, node, newobj=True)
+        yield instance
+        deep = hasattr(instance, '__setstate__')
+        state = self.construct_mapping(node, deep=deep)
+        self.set_python_instance_state(instance, state)
+
+    def construct_python_object_apply(self, suffix, node, newobj=False):
+        # Format:
+        #   !!python/object/apply       # (or !!python/object/new)
+        #   args: [ ... arguments ... ]
+        #   kwds: { ... keywords ... }
+        #   state: ... state ...
+        #   listitems: [ ... listitems ... ]
+        #   dictitems: { ... dictitems ... }
+        # or short format:
+        #   !!python/object/apply [ ... arguments ... ]
+        # The difference between !!python/object/apply and !!python/object/new
+        # is how an object is created, check make_python_instance for details.
+        if isinstance(node, SequenceNode):
+            args = self.construct_sequence(node, deep=True)
+            kwds = {}
+            state = {}
+            listitems = []
+            dictitems = {}
+        else:
+            value = self.construct_mapping(node, deep=True)
+            args = value.get('args', [])
+            kwds = value.get('kwds', {})
+            state = value.get('state', {})
+            listitems = value.get('listitems', [])
+            dictitems = value.get('dictitems', {})
+        instance = self.make_python_instance(suffix, node, args, kwds, newobj)
+        if state:
+            self.set_python_instance_state(instance, state)
+        if listitems:
+            instance.extend(listitems)
+        if dictitems:
+            for key in dictitems:
+                instance[key] = dictitems[key]
+        return instance
+
+    def construct_python_object_new(self, suffix, node):
+        return self.construct_python_object_apply(suffix, node, newobj=True)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/none',
+    FullConstructor.construct_yaml_null)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bool',
+    FullConstructor.construct_yaml_bool)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/str',
+    FullConstructor.construct_python_str)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/unicode',
+    FullConstructor.construct_python_unicode)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bytes',
+    FullConstructor.construct_python_bytes)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/int',
+    FullConstructor.construct_yaml_int)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/long',
+    FullConstructor.construct_python_long)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/float',
+    FullConstructor.construct_yaml_float)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/complex',
+    FullConstructor.construct_python_complex)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/list',
+    FullConstructor.construct_yaml_seq)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/tuple',
+    FullConstructor.construct_python_tuple)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/dict',
+    FullConstructor.construct_yaml_map)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/name:',
+    FullConstructor.construct_python_name)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/module:',
+    FullConstructor.construct_python_module)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object:',
+    FullConstructor.construct_python_object)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/new:',
+    FullConstructor.construct_python_object_new)
+
+class UnsafeConstructor(FullConstructor):
+
+    def find_python_module(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_module(name, mark, unsafe=True)
+
+    def find_python_name(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_name(name, mark, unsafe=True)
+
+    def make_python_instance(self, suffix, node, args=None, kwds=None, newobj=False):
+        return super(UnsafeConstructor, self).make_python_instance(
+            suffix, node, args, kwds, newobj, unsafe=True)
+
+    def set_python_instance_state(self, instance, state):
+        return super(UnsafeConstructor, self).set_python_instance_state(
+            instance, state, unsafe=True)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/apply:',
+    UnsafeConstructor.construct_python_object_apply)
+
+# Constructor is same as UnsafeConstructor. Need to leave this in place in case
+# people have extended it directly.
+class Constructor(UnsafeConstructor):
+    pass
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/cyaml.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/cyaml.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e606c74b9470c3ea0db4bd66629af45d28c2b9a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/cyaml.py
@@ -0,0 +1,101 @@
+
+__all__ = [
+    'CBaseLoader', 'CSafeLoader', 'CFullLoader', 'CUnsafeLoader', 'CLoader',
+    'CBaseDumper', 'CSafeDumper', 'CDumper'
+]
+
+from _yaml import CParser, CEmitter
+
+from .constructor import *
+
+from .serializer import *
+from .representer import *
+
+from .resolver import *
+
+class CBaseLoader(CParser, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class CSafeLoader(CParser, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CFullLoader(CParser, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CUnsafeLoader(CParser, UnsafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        UnsafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CLoader(CParser, Constructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+class CBaseDumper(CEmitter, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CSafeDumper(CEmitter, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CDumper(CEmitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/dumper.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/dumper.py
new file mode 100644
index 0000000000000000000000000000000000000000..6aadba551f3836b02f4752277f4b3027073defad
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/dumper.py
@@ -0,0 +1,62 @@
+
+__all__ = ['BaseDumper', 'SafeDumper', 'Dumper']
+
+from .emitter import *
+from .serializer import *
+from .representer import *
+from .resolver import *
+
+class BaseDumper(Emitter, Serializer, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class SafeDumper(Emitter, Serializer, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class Dumper(Emitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/emitter.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/emitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..a664d011162af69184df2f8e59ab7feec818f7c7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/emitter.py
@@ -0,0 +1,1137 @@
+
+# Emitter expects events obeying the following grammar:
+# stream ::= STREAM-START document* STREAM-END
+# document ::= DOCUMENT-START node DOCUMENT-END
+# node ::= SCALAR | sequence | mapping
+# sequence ::= SEQUENCE-START node* SEQUENCE-END
+# mapping ::= MAPPING-START (node node)* MAPPING-END
+
+__all__ = ['Emitter', 'EmitterError']
+
+from .error import YAMLError
+from .events import *
+
+class EmitterError(YAMLError):
+    pass
+
+class ScalarAnalysis:
+    def __init__(self, scalar, empty, multiline,
+            allow_flow_plain, allow_block_plain,
+            allow_single_quoted, allow_double_quoted,
+            allow_block):
+        self.scalar = scalar
+        self.empty = empty
+        self.multiline = multiline
+        self.allow_flow_plain = allow_flow_plain
+        self.allow_block_plain = allow_block_plain
+        self.allow_single_quoted = allow_single_quoted
+        self.allow_double_quoted = allow_double_quoted
+        self.allow_block = allow_block
+
+class Emitter:
+
+    DEFAULT_TAG_PREFIXES = {
+        '!' : '!',
+        'tag:yaml.org,2002:' : '!!',
+    }
+
+    def __init__(self, stream, canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None):
+
+        # The stream should have the methods `write` and possibly `flush`.
+        self.stream = stream
+
+        # Encoding can be overridden by STREAM-START.
+        self.encoding = None
+
+        # Emitter is a state machine with a stack of states to handle nested
+        # structures.
+        self.states = []
+        self.state = self.expect_stream_start
+
+        # Current event and the event queue.
+        self.events = []
+        self.event = None
+
+        # The current indentation level and the stack of previous indents.
+        self.indents = []
+        self.indent = None
+
+        # Flow level.
+        self.flow_level = 0
+
+        # Contexts.
+        self.root_context = False
+        self.sequence_context = False
+        self.mapping_context = False
+        self.simple_key_context = False
+
+        # Characteristics of the last emitted character:
+        #  - current position.
+        #  - is it a whitespace?
+        #  - is it an indention character
+        #    (indentation space, '-', '?', or ':')?
+        self.line = 0
+        self.column = 0
+        self.whitespace = True
+        self.indention = True
+
+        # Whether the document requires an explicit document indicator
+        self.open_ended = False
+
+        # Formatting details.
+        self.canonical = canonical
+        self.allow_unicode = allow_unicode
+        self.best_indent = 2
+        if indent and 1 < indent < 10:
+            self.best_indent = indent
+        self.best_width = 80
+        if width and width > self.best_indent*2:
+            self.best_width = width
+        self.best_line_break = '\n'
+        if line_break in ['\r', '\n', '\r\n']:
+            self.best_line_break = line_break
+
+        # Tag prefixes.
+        self.tag_prefixes = None
+
+        # Prepared anchor and tag.
+        self.prepared_anchor = None
+        self.prepared_tag = None
+
+        # Scalar analysis and style.
+        self.analysis = None
+        self.style = None
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def emit(self, event):
+        self.events.append(event)
+        while not self.need_more_events():
+            self.event = self.events.pop(0)
+            self.state()
+            self.event = None
+
+    # In some cases, we wait for a few next events before emitting.
+
+    def need_more_events(self):
+        if not self.events:
+            return True
+        event = self.events[0]
+        if isinstance(event, DocumentStartEvent):
+            return self.need_events(1)
+        elif isinstance(event, SequenceStartEvent):
+            return self.need_events(2)
+        elif isinstance(event, MappingStartEvent):
+            return self.need_events(3)
+        else:
+            return False
+
+    def need_events(self, count):
+        level = 0
+        for event in self.events[1:]:
+            if isinstance(event, (DocumentStartEvent, CollectionStartEvent)):
+                level += 1
+            elif isinstance(event, (DocumentEndEvent, CollectionEndEvent)):
+                level -= 1
+            elif isinstance(event, StreamEndEvent):
+                level = -1
+            if level < 0:
+                return False
+        return (len(self.events) < count+1)
+
+    def increase_indent(self, flow=False, indentless=False):
+        self.indents.append(self.indent)
+        if self.indent is None:
+            if flow:
+                self.indent = self.best_indent
+            else:
+                self.indent = 0
+        elif not indentless:
+            self.indent += self.best_indent
+
+    # States.
+
+    # Stream handlers.
+
+    def expect_stream_start(self):
+        if isinstance(self.event, StreamStartEvent):
+            if self.event.encoding and not hasattr(self.stream, 'encoding'):
+                self.encoding = self.event.encoding
+            self.write_stream_start()
+            self.state = self.expect_first_document_start
+        else:
+            raise EmitterError("expected StreamStartEvent, but got %s"
+                    % self.event)
+
+    def expect_nothing(self):
+        raise EmitterError("expected nothing, but got %s" % self.event)
+
+    # Document handlers.
+
+    def expect_first_document_start(self):
+        return self.expect_document_start(first=True)
+
+    def expect_document_start(self, first=False):
+        if isinstance(self.event, DocumentStartEvent):
+            if (self.event.version or self.event.tags) and self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            if self.event.version:
+                version_text = self.prepare_version(self.event.version)
+                self.write_version_directive(version_text)
+            self.tag_prefixes = self.DEFAULT_TAG_PREFIXES.copy()
+            if self.event.tags:
+                handles = sorted(self.event.tags.keys())
+                for handle in handles:
+                    prefix = self.event.tags[handle]
+                    self.tag_prefixes[prefix] = handle
+                    handle_text = self.prepare_tag_handle(handle)
+                    prefix_text = self.prepare_tag_prefix(prefix)
+                    self.write_tag_directive(handle_text, prefix_text)
+            implicit = (first and not self.event.explicit and not self.canonical
+                    and not self.event.version and not self.event.tags
+                    and not self.check_empty_document())
+            if not implicit:
+                self.write_indent()
+                self.write_indicator('---', True)
+                if self.canonical:
+                    self.write_indent()
+            self.state = self.expect_document_root
+        elif isinstance(self.event, StreamEndEvent):
+            if self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.write_stream_end()
+            self.state = self.expect_nothing
+        else:
+            raise EmitterError("expected DocumentStartEvent, but got %s"
+                    % self.event)
+
+    def expect_document_end(self):
+        if isinstance(self.event, DocumentEndEvent):
+            self.write_indent()
+            if self.event.explicit:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.flush_stream()
+            self.state = self.expect_document_start
+        else:
+            raise EmitterError("expected DocumentEndEvent, but got %s"
+                    % self.event)
+
+    def expect_document_root(self):
+        self.states.append(self.expect_document_end)
+        self.expect_node(root=True)
+
+    # Node handlers.
+
+    def expect_node(self, root=False, sequence=False, mapping=False,
+            simple_key=False):
+        self.root_context = root
+        self.sequence_context = sequence
+        self.mapping_context = mapping
+        self.simple_key_context = simple_key
+        if isinstance(self.event, AliasEvent):
+            self.expect_alias()
+        elif isinstance(self.event, (ScalarEvent, CollectionStartEvent)):
+            self.process_anchor('&')
+            self.process_tag()
+            if isinstance(self.event, ScalarEvent):
+                self.expect_scalar()
+            elif isinstance(self.event, SequenceStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_sequence():
+                    self.expect_flow_sequence()
+                else:
+                    self.expect_block_sequence()
+            elif isinstance(self.event, MappingStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_mapping():
+                    self.expect_flow_mapping()
+                else:
+                    self.expect_block_mapping()
+        else:
+            raise EmitterError("expected NodeEvent, but got %s" % self.event)
+
+    def expect_alias(self):
+        if self.event.anchor is None:
+            raise EmitterError("anchor is not specified for alias")
+        self.process_anchor('*')
+        self.state = self.states.pop()
+
+    def expect_scalar(self):
+        self.increase_indent(flow=True)
+        self.process_scalar()
+        self.indent = self.indents.pop()
+        self.state = self.states.pop()
+
+    # Flow sequence handlers.
+
+    def expect_flow_sequence(self):
+        self.write_indicator('[', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_sequence_item
+
+    def expect_first_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    def expect_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Flow mapping handlers.
+
+    def expect_flow_mapping(self):
+        self.write_indicator('{', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_mapping_key
+
+    def expect_first_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_flow_mapping_value(self):
+        if self.canonical or self.column > self.best_width:
+            self.write_indent()
+        self.write_indicator(':', True)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Block sequence handlers.
+
+    def expect_block_sequence(self):
+        indentless = (self.mapping_context and not self.indention)
+        self.increase_indent(flow=False, indentless=indentless)
+        self.state = self.expect_first_block_sequence_item
+
+    def expect_first_block_sequence_item(self):
+        return self.expect_block_sequence_item(first=True)
+
+    def expect_block_sequence_item(self, first=False):
+        if not first and isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            self.write_indicator('-', True, indention=True)
+            self.states.append(self.expect_block_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Block mapping handlers.
+
+    def expect_block_mapping(self):
+        self.increase_indent(flow=False)
+        self.state = self.expect_first_block_mapping_key
+
+    def expect_first_block_mapping_key(self):
+        return self.expect_block_mapping_key(first=True)
+
+    def expect_block_mapping_key(self, first=False):
+        if not first and isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            if self.check_simple_key():
+                self.states.append(self.expect_block_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True, indention=True)
+                self.states.append(self.expect_block_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_block_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_block_mapping_value(self):
+        self.write_indent()
+        self.write_indicator(':', True, indention=True)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Checkers.
+
+    def check_empty_sequence(self):
+        return (isinstance(self.event, SequenceStartEvent) and self.events
+                and isinstance(self.events[0], SequenceEndEvent))
+
+    def check_empty_mapping(self):
+        return (isinstance(self.event, MappingStartEvent) and self.events
+                and isinstance(self.events[0], MappingEndEvent))
+
+    def check_empty_document(self):
+        if not isinstance(self.event, DocumentStartEvent) or not self.events:
+            return False
+        event = self.events[0]
+        return (isinstance(event, ScalarEvent) and event.anchor is None
+                and event.tag is None and event.implicit and event.value == '')
+
+    def check_simple_key(self):
+        length = 0
+        if isinstance(self.event, NodeEvent) and self.event.anchor is not None:
+            if self.prepared_anchor is None:
+                self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+            length += len(self.prepared_anchor)
+        if isinstance(self.event, (ScalarEvent, CollectionStartEvent))  \
+                and self.event.tag is not None:
+            if self.prepared_tag is None:
+                self.prepared_tag = self.prepare_tag(self.event.tag)
+            length += len(self.prepared_tag)
+        if isinstance(self.event, ScalarEvent):
+            if self.analysis is None:
+                self.analysis = self.analyze_scalar(self.event.value)
+            length += len(self.analysis.scalar)
+        return (length < 128 and (isinstance(self.event, AliasEvent)
+            or (isinstance(self.event, ScalarEvent)
+                    and not self.analysis.empty and not self.analysis.multiline)
+            or self.check_empty_sequence() or self.check_empty_mapping()))
+
+    # Anchor, Tag, and Scalar processors.
+
+    def process_anchor(self, indicator):
+        if self.event.anchor is None:
+            self.prepared_anchor = None
+            return
+        if self.prepared_anchor is None:
+            self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+        if self.prepared_anchor:
+            self.write_indicator(indicator+self.prepared_anchor, True)
+        self.prepared_anchor = None
+
+    def process_tag(self):
+        tag = self.event.tag
+        if isinstance(self.event, ScalarEvent):
+            if self.style is None:
+                self.style = self.choose_scalar_style()
+            if ((not self.canonical or tag is None) and
+                ((self.style == '' and self.event.implicit[0])
+                        or (self.style != '' and self.event.implicit[1]))):
+                self.prepared_tag = None
+                return
+            if self.event.implicit[0] and tag is None:
+                tag = '!'
+                self.prepared_tag = None
+        else:
+            if (not self.canonical or tag is None) and self.event.implicit:
+                self.prepared_tag = None
+                return
+        if tag is None:
+            raise EmitterError("tag is not specified")
+        if self.prepared_tag is None:
+            self.prepared_tag = self.prepare_tag(tag)
+        if self.prepared_tag:
+            self.write_indicator(self.prepared_tag, True)
+        self.prepared_tag = None
+
+    def choose_scalar_style(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.event.style == '"' or self.canonical:
+            return '"'
+        if not self.event.style and self.event.implicit[0]:
+            if (not (self.simple_key_context and
+                    (self.analysis.empty or self.analysis.multiline))
+                and (self.flow_level and self.analysis.allow_flow_plain
+                    or (not self.flow_level and self.analysis.allow_block_plain))):
+                return ''
+        if self.event.style and self.event.style in '|>':
+            if (not self.flow_level and not self.simple_key_context
+                    and self.analysis.allow_block):
+                return self.event.style
+        if not self.event.style or self.event.style == '\'':
+            if (self.analysis.allow_single_quoted and
+                    not (self.simple_key_context and self.analysis.multiline)):
+                return '\''
+        return '"'
+
+    def process_scalar(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.style is None:
+            self.style = self.choose_scalar_style()
+        split = (not self.simple_key_context)
+        #if self.analysis.multiline and split    \
+        #        and (not self.style or self.style in '\'\"'):
+        #    self.write_indent()
+        if self.style == '"':
+            self.write_double_quoted(self.analysis.scalar, split)
+        elif self.style == '\'':
+            self.write_single_quoted(self.analysis.scalar, split)
+        elif self.style == '>':
+            self.write_folded(self.analysis.scalar)
+        elif self.style == '|':
+            self.write_literal(self.analysis.scalar)
+        else:
+            self.write_plain(self.analysis.scalar, split)
+        self.analysis = None
+        self.style = None
+
+    # Analyzers.
+
+    def prepare_version(self, version):
+        major, minor = version
+        if major != 1:
+            raise EmitterError("unsupported YAML version: %d.%d" % (major, minor))
+        return '%d.%d' % (major, minor)
+
+    def prepare_tag_handle(self, handle):
+        if not handle:
+            raise EmitterError("tag handle must not be empty")
+        if handle[0] != '!' or handle[-1] != '!':
+            raise EmitterError("tag handle must start and end with '!': %r" % handle)
+        for ch in handle[1:-1]:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the tag handle: %r"
+                        % (ch, handle))
+        return handle
+
+    def prepare_tag_prefix(self, prefix):
+        if not prefix:
+            raise EmitterError("tag prefix must not be empty")
+        chunks = []
+        start = end = 0
+        if prefix[0] == '!':
+            end = 1
+        while end < len(prefix):
+            ch = prefix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?!:@&=+$,_.~*\'()[]':
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(prefix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ord(ch))
+        if start < end:
+            chunks.append(prefix[start:end])
+        return ''.join(chunks)
+
+    def prepare_tag(self, tag):
+        if not tag:
+            raise EmitterError("tag must not be empty")
+        if tag == '!':
+            return tag
+        handle = None
+        suffix = tag
+        prefixes = sorted(self.tag_prefixes.keys())
+        for prefix in prefixes:
+            if tag.startswith(prefix)   \
+                    and (prefix == '!' or len(prefix) < len(tag)):
+                handle = self.tag_prefixes[prefix]
+                suffix = tag[len(prefix):]
+        chunks = []
+        start = end = 0
+        while end < len(suffix):
+            ch = suffix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?:@&=+$,_.~*\'()[]'   \
+                    or (ch == '!' and handle != '!'):
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(suffix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ch)
+        if start < end:
+            chunks.append(suffix[start:end])
+        suffix_text = ''.join(chunks)
+        if handle:
+            return '%s%s' % (handle, suffix_text)
+        else:
+            return '!<%s>' % suffix_text
+
+    def prepare_anchor(self, anchor):
+        if not anchor:
+            raise EmitterError("anchor must not be empty")
+        for ch in anchor:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the anchor: %r"
+                        % (ch, anchor))
+        return anchor
+
+    def analyze_scalar(self, scalar):
+
+        # Empty scalar is a special case.
+        if not scalar:
+            return ScalarAnalysis(scalar=scalar, empty=True, multiline=False,
+                    allow_flow_plain=False, allow_block_plain=True,
+                    allow_single_quoted=True, allow_double_quoted=True,
+                    allow_block=False)
+
+        # Indicators and special characters.
+        block_indicators = False
+        flow_indicators = False
+        line_breaks = False
+        special_characters = False
+
+        # Important whitespace combinations.
+        leading_space = False
+        leading_break = False
+        trailing_space = False
+        trailing_break = False
+        break_space = False
+        space_break = False
+
+        # Check document indicators.
+        if scalar.startswith('---') or scalar.startswith('...'):
+            block_indicators = True
+            flow_indicators = True
+
+        # First character or preceded by a whitespace.
+        preceded_by_whitespace = True
+
+        # Last character or followed by a whitespace.
+        followed_by_whitespace = (len(scalar) == 1 or
+                scalar[1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # The previous character is a space.
+        previous_space = False
+
+        # The previous character is a break.
+        previous_break = False
+
+        index = 0
+        while index < len(scalar):
+            ch = scalar[index]
+
+            # Check for indicators.
+            if index == 0:
+                # Leading indicators are special characters.
+                if ch in '#,[]{}&*!|>\'\"%@`':
+                    flow_indicators = True
+                    block_indicators = True
+                if ch in '?:':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '-' and followed_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+            else:
+                # Some indicators cannot appear within a scalar as well.
+                if ch in ',?[]{}':
+                    flow_indicators = True
+                if ch == ':':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '#' and preceded_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+
+            # Check for line breaks, special, and unicode characters.
+            if ch in '\n\x85\u2028\u2029':
+                line_breaks = True
+            if not (ch == '\n' or '\x20' <= ch <= '\x7E'):
+                if (ch == '\x85' or '\xA0' <= ch <= '\uD7FF'
+                        or '\uE000' <= ch <= '\uFFFD'
+                        or '\U00010000' <= ch < '\U0010ffff') and ch != '\uFEFF':
+                    unicode_characters = True
+                    if not self.allow_unicode:
+                        special_characters = True
+                else:
+                    special_characters = True
+
+            # Detect important whitespace combinations.
+            if ch == ' ':
+                if index == 0:
+                    leading_space = True
+                if index == len(scalar)-1:
+                    trailing_space = True
+                if previous_break:
+                    break_space = True
+                previous_space = True
+                previous_break = False
+            elif ch in '\n\x85\u2028\u2029':
+                if index == 0:
+                    leading_break = True
+                if index == len(scalar)-1:
+                    trailing_break = True
+                if previous_space:
+                    space_break = True
+                previous_space = False
+                previous_break = True
+            else:
+                previous_space = False
+                previous_break = False
+
+            # Prepare for the next character.
+            index += 1
+            preceded_by_whitespace = (ch in '\0 \t\r\n\x85\u2028\u2029')
+            followed_by_whitespace = (index+1 >= len(scalar) or
+                    scalar[index+1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # Let's decide what styles are allowed.
+        allow_flow_plain = True
+        allow_block_plain = True
+        allow_single_quoted = True
+        allow_double_quoted = True
+        allow_block = True
+
+        # Leading and trailing whitespaces are bad for plain scalars.
+        if (leading_space or leading_break
+                or trailing_space or trailing_break):
+            allow_flow_plain = allow_block_plain = False
+
+        # We do not permit trailing spaces for block scalars.
+        if trailing_space:
+            allow_block = False
+
+        # Spaces at the beginning of a new line are only acceptable for block
+        # scalars.
+        if break_space:
+            allow_flow_plain = allow_block_plain = allow_single_quoted = False
+
+        # Spaces followed by breaks, as well as special character are only
+        # allowed for double quoted scalars.
+        if space_break or special_characters:
+            allow_flow_plain = allow_block_plain =  \
+            allow_single_quoted = allow_block = False
+
+        # Although the plain scalar writer supports breaks, we never emit
+        # multiline plain scalars.
+        if line_breaks:
+            allow_flow_plain = allow_block_plain = False
+
+        # Flow indicators are forbidden for flow plain scalars.
+        if flow_indicators:
+            allow_flow_plain = False
+
+        # Block indicators are forbidden for block plain scalars.
+        if block_indicators:
+            allow_block_plain = False
+
+        return ScalarAnalysis(scalar=scalar,
+                empty=False, multiline=line_breaks,
+                allow_flow_plain=allow_flow_plain,
+                allow_block_plain=allow_block_plain,
+                allow_single_quoted=allow_single_quoted,
+                allow_double_quoted=allow_double_quoted,
+                allow_block=allow_block)
+
+    # Writers.
+
+    def flush_stream(self):
+        if hasattr(self.stream, 'flush'):
+            self.stream.flush()
+
+    def write_stream_start(self):
+        # Write BOM if needed.
+        if self.encoding and self.encoding.startswith('utf-16'):
+            self.stream.write('\uFEFF'.encode(self.encoding))
+
+    def write_stream_end(self):
+        self.flush_stream()
+
+    def write_indicator(self, indicator, need_whitespace,
+            whitespace=False, indention=False):
+        if self.whitespace or not need_whitespace:
+            data = indicator
+        else:
+            data = ' '+indicator
+        self.whitespace = whitespace
+        self.indention = self.indention and indention
+        self.column += len(data)
+        self.open_ended = False
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_indent(self):
+        indent = self.indent or 0
+        if not self.indention or self.column > indent   \
+                or (self.column == indent and not self.whitespace):
+            self.write_line_break()
+        if self.column < indent:
+            self.whitespace = True
+            data = ' '*(indent-self.column)
+            self.column = indent
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+
+    def write_line_break(self, data=None):
+        if data is None:
+            data = self.best_line_break
+        self.whitespace = True
+        self.indention = True
+        self.line += 1
+        self.column = 0
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_version_directive(self, version_text):
+        data = '%%YAML %s' % version_text
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    def write_tag_directive(self, handle_text, prefix_text):
+        data = '%%TAG %s %s' % (handle_text, prefix_text)
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    # Scalar streams.
+
+    def write_single_quoted(self, text, split=True):
+        self.write_indicator('\'', True)
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch is None or ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split   \
+                            and start != 0 and end != len(text):
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029' or ch == '\'':
+                    if start < end:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                        start = end
+            if ch == '\'':
+                data = '\'\''
+                self.column += 2
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                start = end + 1
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+        self.write_indicator('\'', False)
+
+    ESCAPE_REPLACEMENTS = {
+        '\0':       '0',
+        '\x07':     'a',
+        '\x08':     'b',
+        '\x09':     't',
+        '\x0A':     'n',
+        '\x0B':     'v',
+        '\x0C':     'f',
+        '\x0D':     'r',
+        '\x1B':     'e',
+        '\"':       '\"',
+        '\\':       '\\',
+        '\x85':     'N',
+        '\xA0':     '_',
+        '\u2028':   'L',
+        '\u2029':   'P',
+    }
+
+    def write_double_quoted(self, text, split=True):
+        self.write_indicator('"', True)
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if ch is None or ch in '"\\\x85\u2028\u2029\uFEFF' \
+                    or not ('\x20' <= ch <= '\x7E'
+                        or (self.allow_unicode
+                            and ('\xA0' <= ch <= '\uD7FF'
+                                or '\uE000' <= ch <= '\uFFFD'))):
+                if start < end:
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+                if ch is not None:
+                    if ch in self.ESCAPE_REPLACEMENTS:
+                        data = '\\'+self.ESCAPE_REPLACEMENTS[ch]
+                    elif ch <= '\xFF':
+                        data = '\\x%02X' % ord(ch)
+                    elif ch <= '\uFFFF':
+                        data = '\\u%04X' % ord(ch)
+                    else:
+                        data = '\\U%08X' % ord(ch)
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end+1
+            if 0 < end < len(text)-1 and (ch == ' ' or start >= end)    \
+                    and self.column+(end-start) > self.best_width and split:
+                data = text[start:end]+'\\'
+                if start < end:
+                    start = end
+                self.column += len(data)
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                self.write_indent()
+                self.whitespace = False
+                self.indention = False
+                if text[start] == ' ':
+                    data = '\\'
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+            end += 1
+        self.write_indicator('"', False)
+
+    def determine_block_hints(self, text):
+        hints = ''
+        if text:
+            if text[0] in ' \n\x85\u2028\u2029':
+                hints += str(self.best_indent)
+            if text[-1] not in '\n\x85\u2028\u2029':
+                hints += '-'
+            elif len(text) == 1 or text[-2] in '\n\x85\u2028\u2029':
+                hints += '+'
+        return hints
+
+    def write_folded(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('>'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        leading_space = True
+        spaces = False
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if not leading_space and ch is not None and ch != ' '   \
+                            and text[start] == '\n':
+                        self.write_line_break()
+                    leading_space = (ch == ' ')
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            elif spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width:
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+                spaces = (ch == ' ')
+            end += 1
+
+    def write_literal(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('|'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in '\n\x85\u2028\u2029':
+                    data = text[start:end]
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+
+    def write_plain(self, text, split=True):
+        if self.root_context:
+            self.open_ended = True
+        if not text:
+            return
+        if not self.whitespace:
+            data = ' '
+            self.column += len(data)
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+        self.whitespace = False
+        self.indention = False
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split:
+                        self.write_indent()
+                        self.whitespace = False
+                        self.indention = False
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    self.whitespace = False
+                    self.indention = False
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/error.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/error.py
new file mode 100644
index 0000000000000000000000000000000000000000..b796b4dc519512c4825ff539a2e6aa20f4d370d0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/error.py
@@ -0,0 +1,75 @@
+
+__all__ = ['Mark', 'YAMLError', 'MarkedYAMLError']
+
+class Mark:
+
+    def __init__(self, name, index, line, column, buffer, pointer):
+        self.name = name
+        self.index = index
+        self.line = line
+        self.column = column
+        self.buffer = buffer
+        self.pointer = pointer
+
+    def get_snippet(self, indent=4, max_length=75):
+        if self.buffer is None:
+            return None
+        head = ''
+        start = self.pointer
+        while start > 0 and self.buffer[start-1] not in '\0\r\n\x85\u2028\u2029':
+            start -= 1
+            if self.pointer-start > max_length/2-1:
+                head = ' ... '
+                start += 5
+                break
+        tail = ''
+        end = self.pointer
+        while end < len(self.buffer) and self.buffer[end] not in '\0\r\n\x85\u2028\u2029':
+            end += 1
+            if end-self.pointer > max_length/2-1:
+                tail = ' ... '
+                end -= 5
+                break
+        snippet = self.buffer[start:end]
+        return ' '*indent + head + snippet + tail + '\n'  \
+                + ' '*(indent+self.pointer-start+len(head)) + '^'
+
+    def __str__(self):
+        snippet = self.get_snippet()
+        where = "  in \"%s\", line %d, column %d"   \
+                % (self.name, self.line+1, self.column+1)
+        if snippet is not None:
+            where += ":\n"+snippet
+        return where
+
+class YAMLError(Exception):
+    pass
+
+class MarkedYAMLError(YAMLError):
+
+    def __init__(self, context=None, context_mark=None,
+            problem=None, problem_mark=None, note=None):
+        self.context = context
+        self.context_mark = context_mark
+        self.problem = problem
+        self.problem_mark = problem_mark
+        self.note = note
+
+    def __str__(self):
+        lines = []
+        if self.context is not None:
+            lines.append(self.context)
+        if self.context_mark is not None  \
+            and (self.problem is None or self.problem_mark is None
+                    or self.context_mark.name != self.problem_mark.name
+                    or self.context_mark.line != self.problem_mark.line
+                    or self.context_mark.column != self.problem_mark.column):
+            lines.append(str(self.context_mark))
+        if self.problem is not None:
+            lines.append(self.problem)
+        if self.problem_mark is not None:
+            lines.append(str(self.problem_mark))
+        if self.note is not None:
+            lines.append(self.note)
+        return '\n'.join(lines)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/events.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/events.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79ad389cb6c9517e391dcd25534866bc9ccd36a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/events.py
@@ -0,0 +1,86 @@
+
+# Abstract classes.
+
+class Event(object):
+    def __init__(self, start_mark=None, end_mark=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in ['anchor', 'tag', 'implicit', 'value']
+                if hasattr(self, key)]
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+class NodeEvent(Event):
+    def __init__(self, anchor, start_mark=None, end_mark=None):
+        self.anchor = anchor
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class CollectionStartEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, start_mark=None, end_mark=None,
+            flow_style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class CollectionEndEvent(Event):
+    pass
+
+# Implementations.
+
+class StreamStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None, encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndEvent(Event):
+    pass
+
+class DocumentStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None, version=None, tags=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+        self.version = version
+        self.tags = tags
+
+class DocumentEndEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+
+class AliasEvent(NodeEvent):
+    pass
+
+class ScalarEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, value,
+            start_mark=None, end_mark=None, style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class SequenceStartEvent(CollectionStartEvent):
+    pass
+
+class SequenceEndEvent(CollectionEndEvent):
+    pass
+
+class MappingStartEvent(CollectionStartEvent):
+    pass
+
+class MappingEndEvent(CollectionEndEvent):
+    pass
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/loader.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..e90c11224c38e559cdf0cb205f0692ebd4fb8681
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/loader.py
@@ -0,0 +1,63 @@
+
+__all__ = ['BaseLoader', 'FullLoader', 'SafeLoader', 'Loader', 'UnsafeLoader']
+
+from .reader import *
+from .scanner import *
+from .parser import *
+from .composer import *
+from .constructor import *
+from .resolver import *
+
+class BaseLoader(Reader, Scanner, Parser, Composer, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class FullLoader(Reader, Scanner, Parser, Composer, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class SafeLoader(Reader, Scanner, Parser, Composer, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class Loader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+# UnsafeLoader is the same as Loader (which is and was always unsafe on
+# untrusted input). Use of either Loader or UnsafeLoader should be rare, since
+# FullLoad should be able to load almost all YAML safely. Loader is left intact
+# to ensure backwards compatibility.
+class UnsafeLoader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/nodes.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4f070c41e1fb1bc01af27d69329e92dded38908
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/nodes.py
@@ -0,0 +1,49 @@
+
+class Node(object):
+    def __init__(self, tag, value, start_mark, end_mark):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        value = self.value
+        #if isinstance(value, list):
+        #    if len(value) == 0:
+        #        value = '<empty>'
+        #    elif len(value) == 1:
+        #        value = '<1 item>'
+        #    else:
+        #        value = '<%d items>' % len(value)
+        #else:
+        #    if len(value) > 75:
+        #        value = repr(value[:70]+u' ... ')
+        #    else:
+        #        value = repr(value)
+        value = repr(value)
+        return '%s(tag=%r, value=%s)' % (self.__class__.__name__, self.tag, value)
+
+class ScalarNode(Node):
+    id = 'scalar'
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class CollectionNode(Node):
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, flow_style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class SequenceNode(CollectionNode):
+    id = 'sequence'
+
+class MappingNode(CollectionNode):
+    id = 'mapping'
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/parser.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..13a5995d292045d0f865a99abf692bd35dc87814
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/parser.py
@@ -0,0 +1,589 @@
+
+# The following YAML grammar is LL(1) and is parsed by a recursive descent
+# parser.
+#
+# stream            ::= STREAM-START implicit_document? explicit_document* STREAM-END
+# implicit_document ::= block_node DOCUMENT-END*
+# explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+# block_node_or_indentless_sequence ::=
+#                       ALIAS
+#                       | properties (block_content | indentless_block_sequence)?
+#                       | block_content
+#                       | indentless_block_sequence
+# block_node        ::= ALIAS
+#                       | properties block_content?
+#                       | block_content
+# flow_node         ::= ALIAS
+#                       | properties flow_content?
+#                       | flow_content
+# properties        ::= TAG ANCHOR? | ANCHOR TAG?
+# block_content     ::= block_collection | flow_collection | SCALAR
+# flow_content      ::= flow_collection | SCALAR
+# block_collection  ::= block_sequence | block_mapping
+# flow_collection   ::= flow_sequence | flow_mapping
+# block_sequence    ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+# indentless_sequence   ::= (BLOCK-ENTRY block_node?)+
+# block_mapping     ::= BLOCK-MAPPING_START
+#                       ((KEY block_node_or_indentless_sequence?)?
+#                       (VALUE block_node_or_indentless_sequence?)?)*
+#                       BLOCK-END
+# flow_sequence     ::= FLOW-SEQUENCE-START
+#                       (flow_sequence_entry FLOW-ENTRY)*
+#                       flow_sequence_entry?
+#                       FLOW-SEQUENCE-END
+# flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+# flow_mapping      ::= FLOW-MAPPING-START
+#                       (flow_mapping_entry FLOW-ENTRY)*
+#                       flow_mapping_entry?
+#                       FLOW-MAPPING-END
+# flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+#
+# FIRST sets:
+#
+# stream: { STREAM-START }
+# explicit_document: { DIRECTIVE DOCUMENT-START }
+# implicit_document: FIRST(block_node)
+# block_node: { ALIAS TAG ANCHOR SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_node: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_content: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# flow_content: { FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# block_collection: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_sequence: { BLOCK-SEQUENCE-START }
+# block_mapping: { BLOCK-MAPPING-START }
+# block_node_or_indentless_sequence: { ALIAS ANCHOR TAG SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START BLOCK-ENTRY }
+# indentless_sequence: { ENTRY }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_sequence: { FLOW-SEQUENCE-START }
+# flow_mapping: { FLOW-MAPPING-START }
+# flow_sequence_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+# flow_mapping_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+
+__all__ = ['Parser', 'ParserError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+from .events import *
+from .scanner import *
+
+class ParserError(MarkedYAMLError):
+    pass
+
+class Parser:
+    # Since writing a recursive-descendant parser is a straightforward task, we
+    # do not give many comments here.
+
+    DEFAULT_TAGS = {
+        '!':   '!',
+        '!!':  'tag:yaml.org,2002:',
+    }
+
+    def __init__(self):
+        self.current_event = None
+        self.yaml_version = None
+        self.tag_handles = {}
+        self.states = []
+        self.marks = []
+        self.state = self.parse_stream_start
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def check_event(self, *choices):
+        # Check the type of the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        if self.current_event is not None:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.current_event, choice):
+                    return True
+        return False
+
+    def peek_event(self):
+        # Get the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        return self.current_event
+
+    def get_event(self):
+        # Get the next event and proceed further.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        value = self.current_event
+        self.current_event = None
+        return value
+
+    # stream    ::= STREAM-START implicit_document? explicit_document* STREAM-END
+    # implicit_document ::= block_node DOCUMENT-END*
+    # explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+
+    def parse_stream_start(self):
+
+        # Parse the stream start.
+        token = self.get_token()
+        event = StreamStartEvent(token.start_mark, token.end_mark,
+                encoding=token.encoding)
+
+        # Prepare the next state.
+        self.state = self.parse_implicit_document_start
+
+        return event
+
+    def parse_implicit_document_start(self):
+
+        # Parse an implicit document.
+        if not self.check_token(DirectiveToken, DocumentStartToken,
+                StreamEndToken):
+            self.tag_handles = self.DEFAULT_TAGS
+            token = self.peek_token()
+            start_mark = end_mark = token.start_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=False)
+
+            # Prepare the next state.
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_block_node
+
+            return event
+
+        else:
+            return self.parse_document_start()
+
+    def parse_document_start(self):
+
+        # Parse any extra document end indicators.
+        while self.check_token(DocumentEndToken):
+            self.get_token()
+
+        # Parse an explicit document.
+        if not self.check_token(StreamEndToken):
+            token = self.peek_token()
+            start_mark = token.start_mark
+            version, tags = self.process_directives()
+            if not self.check_token(DocumentStartToken):
+                raise ParserError(None, None,
+                        "expected '<document start>', but found %r"
+                        % self.peek_token().id,
+                        self.peek_token().start_mark)
+            token = self.get_token()
+            end_mark = token.end_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=True, version=version, tags=tags)
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_document_content
+        else:
+            # Parse the end of the stream.
+            token = self.get_token()
+            event = StreamEndEvent(token.start_mark, token.end_mark)
+            assert not self.states
+            assert not self.marks
+            self.state = None
+        return event
+
+    def parse_document_end(self):
+
+        # Parse the document end.
+        token = self.peek_token()
+        start_mark = end_mark = token.start_mark
+        explicit = False
+        if self.check_token(DocumentEndToken):
+            token = self.get_token()
+            end_mark = token.end_mark
+            explicit = True
+        event = DocumentEndEvent(start_mark, end_mark,
+                explicit=explicit)
+
+        # Prepare the next state.
+        self.state = self.parse_document_start
+
+        return event
+
+    def parse_document_content(self):
+        if self.check_token(DirectiveToken,
+                DocumentStartToken, DocumentEndToken, StreamEndToken):
+            event = self.process_empty_scalar(self.peek_token().start_mark)
+            self.state = self.states.pop()
+            return event
+        else:
+            return self.parse_block_node()
+
+    def process_directives(self):
+        self.yaml_version = None
+        self.tag_handles = {}
+        while self.check_token(DirectiveToken):
+            token = self.get_token()
+            if token.name == 'YAML':
+                if self.yaml_version is not None:
+                    raise ParserError(None, None,
+                            "found duplicate YAML directive", token.start_mark)
+                major, minor = token.value
+                if major != 1:
+                    raise ParserError(None, None,
+                            "found incompatible YAML document (version 1.* is required)",
+                            token.start_mark)
+                self.yaml_version = token.value
+            elif token.name == 'TAG':
+                handle, prefix = token.value
+                if handle in self.tag_handles:
+                    raise ParserError(None, None,
+                            "duplicate tag handle %r" % handle,
+                            token.start_mark)
+                self.tag_handles[handle] = prefix
+        if self.tag_handles:
+            value = self.yaml_version, self.tag_handles.copy()
+        else:
+            value = self.yaml_version, None
+        for key in self.DEFAULT_TAGS:
+            if key not in self.tag_handles:
+                self.tag_handles[key] = self.DEFAULT_TAGS[key]
+        return value
+
+    # block_node_or_indentless_sequence ::= ALIAS
+    #               | properties (block_content | indentless_block_sequence)?
+    #               | block_content
+    #               | indentless_block_sequence
+    # block_node    ::= ALIAS
+    #                   | properties block_content?
+    #                   | block_content
+    # flow_node     ::= ALIAS
+    #                   | properties flow_content?
+    #                   | flow_content
+    # properties    ::= TAG ANCHOR? | ANCHOR TAG?
+    # block_content     ::= block_collection | flow_collection | SCALAR
+    # flow_content      ::= flow_collection | SCALAR
+    # block_collection  ::= block_sequence | block_mapping
+    # flow_collection   ::= flow_sequence | flow_mapping
+
+    def parse_block_node(self):
+        return self.parse_node(block=True)
+
+    def parse_flow_node(self):
+        return self.parse_node()
+
+    def parse_block_node_or_indentless_sequence(self):
+        return self.parse_node(block=True, indentless_sequence=True)
+
+    def parse_node(self, block=False, indentless_sequence=False):
+        if self.check_token(AliasToken):
+            token = self.get_token()
+            event = AliasEvent(token.value, token.start_mark, token.end_mark)
+            self.state = self.states.pop()
+        else:
+            anchor = None
+            tag = None
+            start_mark = end_mark = tag_mark = None
+            if self.check_token(AnchorToken):
+                token = self.get_token()
+                start_mark = token.start_mark
+                end_mark = token.end_mark
+                anchor = token.value
+                if self.check_token(TagToken):
+                    token = self.get_token()
+                    tag_mark = token.start_mark
+                    end_mark = token.end_mark
+                    tag = token.value
+            elif self.check_token(TagToken):
+                token = self.get_token()
+                start_mark = tag_mark = token.start_mark
+                end_mark = token.end_mark
+                tag = token.value
+                if self.check_token(AnchorToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    anchor = token.value
+            if tag is not None:
+                handle, suffix = tag
+                if handle is not None:
+                    if handle not in self.tag_handles:
+                        raise ParserError("while parsing a node", start_mark,
+                                "found undefined tag handle %r" % handle,
+                                tag_mark)
+                    tag = self.tag_handles[handle]+suffix
+                else:
+                    tag = suffix
+            #if tag == '!':
+            #    raise ParserError("while parsing a node", start_mark,
+            #            "found non-specific tag '!'", tag_mark,
+            #            "Please check 'http://pyyaml.org/wiki/YAMLNonSpecificTag' and share your opinion.")
+            if start_mark is None:
+                start_mark = end_mark = self.peek_token().start_mark
+            event = None
+            implicit = (tag is None or tag == '!')
+            if indentless_sequence and self.check_token(BlockEntryToken):
+                end_mark = self.peek_token().end_mark
+                event = SequenceStartEvent(anchor, tag, implicit,
+                        start_mark, end_mark)
+                self.state = self.parse_indentless_sequence_entry
+            else:
+                if self.check_token(ScalarToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    if (token.plain and tag is None) or tag == '!':
+                        implicit = (True, False)
+                    elif tag is None:
+                        implicit = (False, True)
+                    else:
+                        implicit = (False, False)
+                    event = ScalarEvent(anchor, tag, implicit, token.value,
+                            start_mark, end_mark, style=token.style)
+                    self.state = self.states.pop()
+                elif self.check_token(FlowSequenceStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_sequence_first_entry
+                elif self.check_token(FlowMappingStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_mapping_first_key
+                elif block and self.check_token(BlockSequenceStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_sequence_first_entry
+                elif block and self.check_token(BlockMappingStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_mapping_first_key
+                elif anchor is not None or tag is not None:
+                    # Empty scalars are allowed even if a tag or an anchor is
+                    # specified.
+                    event = ScalarEvent(anchor, tag, (implicit, False), '',
+                            start_mark, end_mark)
+                    self.state = self.states.pop()
+                else:
+                    if block:
+                        node = 'block'
+                    else:
+                        node = 'flow'
+                    token = self.peek_token()
+                    raise ParserError("while parsing a %s node" % node, start_mark,
+                            "expected the node content, but found %r" % token.id,
+                            token.start_mark)
+        return event
+
+    # block_sequence ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+
+    def parse_block_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_sequence_entry()
+
+    def parse_block_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken, BlockEndToken):
+                self.states.append(self.parse_block_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_block_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block collection", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    # indentless_sequence ::= (BLOCK-ENTRY block_node?)+
+
+    def parse_indentless_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken,
+                    KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_indentless_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_indentless_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        token = self.peek_token()
+        event = SequenceEndEvent(token.start_mark, token.start_mark)
+        self.state = self.states.pop()
+        return event
+
+    # block_mapping     ::= BLOCK-MAPPING_START
+    #                       ((KEY block_node_or_indentless_sequence?)?
+    #                       (VALUE block_node_or_indentless_sequence?)?)*
+    #                       BLOCK-END
+
+    def parse_block_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_mapping_key()
+
+    def parse_block_mapping_key(self):
+        if self.check_token(KeyToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_value)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_value
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block mapping", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_block_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_key)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_block_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    # flow_sequence     ::= FLOW-SEQUENCE-START
+    #                       (flow_sequence_entry FLOW-ENTRY)*
+    #                       flow_sequence_entry?
+    #                       FLOW-SEQUENCE-END
+    # flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+    #
+    # Note that while production rules for both flow_sequence_entry and
+    # flow_mapping_entry are equal, their interpretations are different.
+    # For `flow_sequence_entry`, the part `KEY flow_node? (VALUE flow_node?)?`
+    # generate an inline mapping (set syntax).
+
+    def parse_flow_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_sequence_entry(first=True)
+
+    def parse_flow_sequence_entry(self, first=False):
+        if not self.check_token(FlowSequenceEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow sequence", self.marks[-1],
+                            "expected ',' or ']', but got %r" % token.id, token.start_mark)
+            
+            if self.check_token(KeyToken):
+                token = self.peek_token()
+                event = MappingStartEvent(None, None, True,
+                        token.start_mark, token.end_mark,
+                        flow_style=True)
+                self.state = self.parse_flow_sequence_entry_mapping_key
+                return event
+            elif not self.check_token(FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_sequence_entry_mapping_key(self):
+        token = self.get_token()
+        if not self.check_token(ValueToken,
+                FlowEntryToken, FlowSequenceEndToken):
+            self.states.append(self.parse_flow_sequence_entry_mapping_value)
+            return self.parse_flow_node()
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_value
+            return self.process_empty_scalar(token.end_mark)
+
+    def parse_flow_sequence_entry_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry_mapping_end)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_sequence_entry_mapping_end
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_end
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_sequence_entry_mapping_end(self):
+        self.state = self.parse_flow_sequence_entry
+        token = self.peek_token()
+        return MappingEndEvent(token.start_mark, token.start_mark)
+
+    # flow_mapping  ::= FLOW-MAPPING-START
+    #                   (flow_mapping_entry FLOW-ENTRY)*
+    #                   flow_mapping_entry?
+    #                   FLOW-MAPPING-END
+    # flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+
+    def parse_flow_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_mapping_key(first=True)
+
+    def parse_flow_mapping_key(self, first=False):
+        if not self.check_token(FlowMappingEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow mapping", self.marks[-1],
+                            "expected ',' or '}', but got %r" % token.id, token.start_mark)
+            if self.check_token(KeyToken):
+                token = self.get_token()
+                if not self.check_token(ValueToken,
+                        FlowEntryToken, FlowMappingEndToken):
+                    self.states.append(self.parse_flow_mapping_value)
+                    return self.parse_flow_node()
+                else:
+                    self.state = self.parse_flow_mapping_value
+                    return self.process_empty_scalar(token.end_mark)
+            elif not self.check_token(FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_empty_value)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_key)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_mapping_empty_value(self):
+        self.state = self.parse_flow_mapping_key
+        return self.process_empty_scalar(self.peek_token().start_mark)
+
+    def process_empty_scalar(self, mark):
+        return ScalarEvent(None, None, (True, False), '', mark, mark)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/reader.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/reader.py
new file mode 100644
index 0000000000000000000000000000000000000000..774b0219b5932a0ee1c27e637371de5ba8d9cb16
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/reader.py
@@ -0,0 +1,185 @@
+# This module contains abstractions for the input stream. You don't have to
+# looks further, there are no pretty code.
+#
+# We define two classes here.
+#
+#   Mark(source, line, column)
+# It's just a record and its only use is producing nice error messages.
+# Parser does not use it for any other purposes.
+#
+#   Reader(source, data)
+# Reader determines the encoding of `data` and converts it to unicode.
+# Reader provides the following methods and attributes:
+#   reader.peek(length=1) - return the next `length` characters
+#   reader.forward(length=1) - move the current position to `length` characters.
+#   reader.index - the number of the current character.
+#   reader.line, stream.column - the line and the column of the current character.
+
+__all__ = ['Reader', 'ReaderError']
+
+from .error import YAMLError, Mark
+
+import codecs, re
+
+class ReaderError(YAMLError):
+
+    def __init__(self, name, position, character, encoding, reason):
+        self.name = name
+        self.character = character
+        self.position = position
+        self.encoding = encoding
+        self.reason = reason
+
+    def __str__(self):
+        if isinstance(self.character, bytes):
+            return "'%s' codec can't decode byte #x%02x: %s\n"  \
+                    "  in \"%s\", position %d"    \
+                    % (self.encoding, ord(self.character), self.reason,
+                            self.name, self.position)
+        else:
+            return "unacceptable character #x%04x: %s\n"    \
+                    "  in \"%s\", position %d"    \
+                    % (self.character, self.reason,
+                            self.name, self.position)
+
+class Reader(object):
+    # Reader:
+    # - determines the data encoding and converts it to a unicode string,
+    # - checks if characters are in allowed range,
+    # - adds '\0' to the end.
+
+    # Reader accepts
+    #  - a `bytes` object,
+    #  - a `str` object,
+    #  - a file-like object with its `read` method returning `str`,
+    #  - a file-like object with its `read` method returning `unicode`.
+
+    # Yeah, it's ugly and slow.
+
+    def __init__(self, stream):
+        self.name = None
+        self.stream = None
+        self.stream_pointer = 0
+        self.eof = True
+        self.buffer = ''
+        self.pointer = 0
+        self.raw_buffer = None
+        self.raw_decode = None
+        self.encoding = None
+        self.index = 0
+        self.line = 0
+        self.column = 0
+        if isinstance(stream, str):
+            self.name = "<unicode string>"
+            self.check_printable(stream)
+            self.buffer = stream+'\0'
+        elif isinstance(stream, bytes):
+            self.name = "<byte string>"
+            self.raw_buffer = stream
+            self.determine_encoding()
+        else:
+            self.stream = stream
+            self.name = getattr(stream, 'name', "<file>")
+            self.eof = False
+            self.raw_buffer = None
+            self.determine_encoding()
+
+    def peek(self, index=0):
+        try:
+            return self.buffer[self.pointer+index]
+        except IndexError:
+            self.update(index+1)
+            return self.buffer[self.pointer+index]
+
+    def prefix(self, length=1):
+        if self.pointer+length >= len(self.buffer):
+            self.update(length)
+        return self.buffer[self.pointer:self.pointer+length]
+
+    def forward(self, length=1):
+        if self.pointer+length+1 >= len(self.buffer):
+            self.update(length+1)
+        while length:
+            ch = self.buffer[self.pointer]
+            self.pointer += 1
+            self.index += 1
+            if ch in '\n\x85\u2028\u2029'  \
+                    or (ch == '\r' and self.buffer[self.pointer] != '\n'):
+                self.line += 1
+                self.column = 0
+            elif ch != '\uFEFF':
+                self.column += 1
+            length -= 1
+
+    def get_mark(self):
+        if self.stream is None:
+            return Mark(self.name, self.index, self.line, self.column,
+                    self.buffer, self.pointer)
+        else:
+            return Mark(self.name, self.index, self.line, self.column,
+                    None, None)
+
+    def determine_encoding(self):
+        while not self.eof and (self.raw_buffer is None or len(self.raw_buffer) < 2):
+            self.update_raw()
+        if isinstance(self.raw_buffer, bytes):
+            if self.raw_buffer.startswith(codecs.BOM_UTF16_LE):
+                self.raw_decode = codecs.utf_16_le_decode
+                self.encoding = 'utf-16-le'
+            elif self.raw_buffer.startswith(codecs.BOM_UTF16_BE):
+                self.raw_decode = codecs.utf_16_be_decode
+                self.encoding = 'utf-16-be'
+            else:
+                self.raw_decode = codecs.utf_8_decode
+                self.encoding = 'utf-8'
+        self.update(1)
+
+    NON_PRINTABLE = re.compile('[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]')
+    def check_printable(self, data):
+        match = self.NON_PRINTABLE.search(data)
+        if match:
+            character = match.group()
+            position = self.index+(len(self.buffer)-self.pointer)+match.start()
+            raise ReaderError(self.name, position, ord(character),
+                    'unicode', "special characters are not allowed")
+
+    def update(self, length):
+        if self.raw_buffer is None:
+            return
+        self.buffer = self.buffer[self.pointer:]
+        self.pointer = 0
+        while len(self.buffer) < length:
+            if not self.eof:
+                self.update_raw()
+            if self.raw_decode is not None:
+                try:
+                    data, converted = self.raw_decode(self.raw_buffer,
+                            'strict', self.eof)
+                except UnicodeDecodeError as exc:
+                    character = self.raw_buffer[exc.start]
+                    if self.stream is not None:
+                        position = self.stream_pointer-len(self.raw_buffer)+exc.start
+                    else:
+                        position = exc.start
+                    raise ReaderError(self.name, position, character,
+                            exc.encoding, exc.reason)
+            else:
+                data = self.raw_buffer
+                converted = len(data)
+            self.check_printable(data)
+            self.buffer += data
+            self.raw_buffer = self.raw_buffer[converted:]
+            if self.eof:
+                self.buffer += '\0'
+                self.raw_buffer = None
+                break
+
+    def update_raw(self, size=4096):
+        data = self.stream.read(size)
+        if self.raw_buffer is None:
+            self.raw_buffer = data
+        else:
+            self.raw_buffer += data
+        self.stream_pointer += len(data)
+        if not data:
+            self.eof = True
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/representer.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/representer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b0b192ef32ed7f5b7015456fe883c3327bb841e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/representer.py
@@ -0,0 +1,389 @@
+
+__all__ = ['BaseRepresenter', 'SafeRepresenter', 'Representer',
+    'RepresenterError']
+
+from .error import *
+from .nodes import *
+
+import datetime, copyreg, types, base64, collections
+
+class RepresenterError(YAMLError):
+    pass
+
+class BaseRepresenter:
+
+    yaml_representers = {}
+    yaml_multi_representers = {}
+
+    def __init__(self, default_style=None, default_flow_style=False, sort_keys=True):
+        self.default_style = default_style
+        self.sort_keys = sort_keys
+        self.default_flow_style = default_flow_style
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent(self, data):
+        node = self.represent_data(data)
+        self.serialize(node)
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent_data(self, data):
+        if self.ignore_aliases(data):
+            self.alias_key = None
+        else:
+            self.alias_key = id(data)
+        if self.alias_key is not None:
+            if self.alias_key in self.represented_objects:
+                node = self.represented_objects[self.alias_key]
+                #if node is None:
+                #    raise RepresenterError("recursive objects are not allowed: %r" % data)
+                return node
+            #self.represented_objects[alias_key] = None
+            self.object_keeper.append(data)
+        data_types = type(data).__mro__
+        if data_types[0] in self.yaml_representers:
+            node = self.yaml_representers[data_types[0]](self, data)
+        else:
+            for data_type in data_types:
+                if data_type in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[data_type](self, data)
+                    break
+            else:
+                if None in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[None](self, data)
+                elif None in self.yaml_representers:
+                    node = self.yaml_representers[None](self, data)
+                else:
+                    node = ScalarNode(None, str(data))
+        #if alias_key is not None:
+        #    self.represented_objects[alias_key] = node
+        return node
+
+    @classmethod
+    def add_representer(cls, data_type, representer):
+        if not 'yaml_representers' in cls.__dict__:
+            cls.yaml_representers = cls.yaml_representers.copy()
+        cls.yaml_representers[data_type] = representer
+
+    @classmethod
+    def add_multi_representer(cls, data_type, representer):
+        if not 'yaml_multi_representers' in cls.__dict__:
+            cls.yaml_multi_representers = cls.yaml_multi_representers.copy()
+        cls.yaml_multi_representers[data_type] = representer
+
+    def represent_scalar(self, tag, value, style=None):
+        if style is None:
+            style = self.default_style
+        node = ScalarNode(tag, value, style=style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        return node
+
+    def represent_sequence(self, tag, sequence, flow_style=None):
+        value = []
+        node = SequenceNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        for item in sequence:
+            node_item = self.represent_data(item)
+            if not (isinstance(node_item, ScalarNode) and not node_item.style):
+                best_style = False
+            value.append(node_item)
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def represent_mapping(self, tag, mapping, flow_style=None):
+        value = []
+        node = MappingNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        if hasattr(mapping, 'items'):
+            mapping = list(mapping.items())
+            if self.sort_keys:
+                try:
+                    mapping = sorted(mapping)
+                except TypeError:
+                    pass
+        for item_key, item_value in mapping:
+            node_key = self.represent_data(item_key)
+            node_value = self.represent_data(item_value)
+            if not (isinstance(node_key, ScalarNode) and not node_key.style):
+                best_style = False
+            if not (isinstance(node_value, ScalarNode) and not node_value.style):
+                best_style = False
+            value.append((node_key, node_value))
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def ignore_aliases(self, data):
+        return False
+
+class SafeRepresenter(BaseRepresenter):
+
+    def ignore_aliases(self, data):
+        if data is None:
+            return True
+        if isinstance(data, tuple) and data == ():
+            return True
+        if isinstance(data, (str, bytes, bool, int, float)):
+            return True
+
+    def represent_none(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:null', 'null')
+
+    def represent_str(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:str', data)
+
+    def represent_binary(self, data):
+        if hasattr(base64, 'encodebytes'):
+            data = base64.encodebytes(data).decode('ascii')
+        else:
+            data = base64.encodestring(data).decode('ascii')
+        return self.represent_scalar('tag:yaml.org,2002:binary', data, style='|')
+
+    def represent_bool(self, data):
+        if data:
+            value = 'true'
+        else:
+            value = 'false'
+        return self.represent_scalar('tag:yaml.org,2002:bool', value)
+
+    def represent_int(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:int', str(data))
+
+    inf_value = 1e300
+    while repr(inf_value) != repr(inf_value*inf_value):
+        inf_value *= inf_value
+
+    def represent_float(self, data):
+        if data != data or (data == 0.0 and data == 1.0):
+            value = '.nan'
+        elif data == self.inf_value:
+            value = '.inf'
+        elif data == -self.inf_value:
+            value = '-.inf'
+        else:
+            value = repr(data).lower()
+            # Note that in some cases `repr(data)` represents a float number
+            # without the decimal parts.  For instance:
+            #   >>> repr(1e17)
+            #   '1e17'
+            # Unfortunately, this is not a valid float representation according
+            # to the definition of the `!!float` tag.  We fix this by adding
+            # '.0' before the 'e' symbol.
+            if '.' not in value and 'e' in value:
+                value = value.replace('e', '.0e', 1)
+        return self.represent_scalar('tag:yaml.org,2002:float', value)
+
+    def represent_list(self, data):
+        #pairs = (len(data) > 0 and isinstance(data, list))
+        #if pairs:
+        #    for item in data:
+        #        if not isinstance(item, tuple) or len(item) != 2:
+        #            pairs = False
+        #            break
+        #if not pairs:
+            return self.represent_sequence('tag:yaml.org,2002:seq', data)
+        #value = []
+        #for item_key, item_value in data:
+        #    value.append(self.represent_mapping(u'tag:yaml.org,2002:map',
+        #        [(item_key, item_value)]))
+        #return SequenceNode(u'tag:yaml.org,2002:pairs', value)
+
+    def represent_dict(self, data):
+        return self.represent_mapping('tag:yaml.org,2002:map', data)
+
+    def represent_set(self, data):
+        value = {}
+        for key in data:
+            value[key] = None
+        return self.represent_mapping('tag:yaml.org,2002:set', value)
+
+    def represent_date(self, data):
+        value = data.isoformat()
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_datetime(self, data):
+        value = data.isoformat(' ')
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_yaml_object(self, tag, data, cls, flow_style=None):
+        if hasattr(data, '__getstate__'):
+            state = data.__getstate__()
+        else:
+            state = data.__dict__.copy()
+        return self.represent_mapping(tag, state, flow_style=flow_style)
+
+    def represent_undefined(self, data):
+        raise RepresenterError("cannot represent an object", data)
+
+SafeRepresenter.add_representer(type(None),
+        SafeRepresenter.represent_none)
+
+SafeRepresenter.add_representer(str,
+        SafeRepresenter.represent_str)
+
+SafeRepresenter.add_representer(bytes,
+        SafeRepresenter.represent_binary)
+
+SafeRepresenter.add_representer(bool,
+        SafeRepresenter.represent_bool)
+
+SafeRepresenter.add_representer(int,
+        SafeRepresenter.represent_int)
+
+SafeRepresenter.add_representer(float,
+        SafeRepresenter.represent_float)
+
+SafeRepresenter.add_representer(list,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(tuple,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(dict,
+        SafeRepresenter.represent_dict)
+
+SafeRepresenter.add_representer(set,
+        SafeRepresenter.represent_set)
+
+SafeRepresenter.add_representer(datetime.date,
+        SafeRepresenter.represent_date)
+
+SafeRepresenter.add_representer(datetime.datetime,
+        SafeRepresenter.represent_datetime)
+
+SafeRepresenter.add_representer(None,
+        SafeRepresenter.represent_undefined)
+
+class Representer(SafeRepresenter):
+
+    def represent_complex(self, data):
+        if data.imag == 0.0:
+            data = '%r' % data.real
+        elif data.real == 0.0:
+            data = '%rj' % data.imag
+        elif data.imag > 0:
+            data = '%r+%rj' % (data.real, data.imag)
+        else:
+            data = '%r%rj' % (data.real, data.imag)
+        return self.represent_scalar('tag:yaml.org,2002:python/complex', data)
+
+    def represent_tuple(self, data):
+        return self.represent_sequence('tag:yaml.org,2002:python/tuple', data)
+
+    def represent_name(self, data):
+        name = '%s.%s' % (data.__module__, data.__name__)
+        return self.represent_scalar('tag:yaml.org,2002:python/name:'+name, '')
+
+    def represent_module(self, data):
+        return self.represent_scalar(
+                'tag:yaml.org,2002:python/module:'+data.__name__, '')
+
+    def represent_object(self, data):
+        # We use __reduce__ API to save the data. data.__reduce__ returns
+        # a tuple of length 2-5:
+        #   (function, args, state, listitems, dictitems)
+
+        # For reconstructing, we calls function(*args), then set its state,
+        # listitems, and dictitems if they are not None.
+
+        # A special case is when function.__name__ == '__newobj__'. In this
+        # case we create the object with args[0].__new__(*args).
+
+        # Another special case is when __reduce__ returns a string - we don't
+        # support it.
+
+        # We produce a !!python/object, !!python/object/new or
+        # !!python/object/apply node.
+
+        cls = type(data)
+        if cls in copyreg.dispatch_table:
+            reduce = copyreg.dispatch_table[cls](data)
+        elif hasattr(data, '__reduce_ex__'):
+            reduce = data.__reduce_ex__(2)
+        elif hasattr(data, '__reduce__'):
+            reduce = data.__reduce__()
+        else:
+            raise RepresenterError("cannot represent an object", data)
+        reduce = (list(reduce)+[None]*5)[:5]
+        function, args, state, listitems, dictitems = reduce
+        args = list(args)
+        if state is None:
+            state = {}
+        if listitems is not None:
+            listitems = list(listitems)
+        if dictitems is not None:
+            dictitems = dict(dictitems)
+        if function.__name__ == '__newobj__':
+            function = args[0]
+            args = args[1:]
+            tag = 'tag:yaml.org,2002:python/object/new:'
+            newobj = True
+        else:
+            tag = 'tag:yaml.org,2002:python/object/apply:'
+            newobj = False
+        function_name = '%s.%s' % (function.__module__, function.__name__)
+        if not args and not listitems and not dictitems \
+                and isinstance(state, dict) and newobj:
+            return self.represent_mapping(
+                    'tag:yaml.org,2002:python/object:'+function_name, state)
+        if not listitems and not dictitems  \
+                and isinstance(state, dict) and not state:
+            return self.represent_sequence(tag+function_name, args)
+        value = {}
+        if args:
+            value['args'] = args
+        if state or not isinstance(state, dict):
+            value['state'] = state
+        if listitems:
+            value['listitems'] = listitems
+        if dictitems:
+            value['dictitems'] = dictitems
+        return self.represent_mapping(tag+function_name, value)
+
+    def represent_ordered_dict(self, data):
+        # Provide uniform representation across different Python versions.
+        data_type = type(data)
+        tag = 'tag:yaml.org,2002:python/object/apply:%s.%s' \
+                % (data_type.__module__, data_type.__name__)
+        items = [[key, value] for key, value in data.items()]
+        return self.represent_sequence(tag, [items])
+
+Representer.add_representer(complex,
+        Representer.represent_complex)
+
+Representer.add_representer(tuple,
+        Representer.represent_tuple)
+
+Representer.add_representer(type,
+        Representer.represent_name)
+
+Representer.add_representer(collections.OrderedDict,
+        Representer.represent_ordered_dict)
+
+Representer.add_representer(types.FunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.BuiltinFunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.ModuleType,
+        Representer.represent_module)
+
+Representer.add_multi_representer(object,
+        Representer.represent_object)
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/resolver.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/resolver.py
new file mode 100644
index 0000000000000000000000000000000000000000..02b82e73eecac9875336617a7ff38300ff4507ef
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/resolver.py
@@ -0,0 +1,227 @@
+
+__all__ = ['BaseResolver', 'Resolver']
+
+from .error import *
+from .nodes import *
+
+import re
+
+class ResolverError(YAMLError):
+    pass
+
+class BaseResolver:
+
+    DEFAULT_SCALAR_TAG = 'tag:yaml.org,2002:str'
+    DEFAULT_SEQUENCE_TAG = 'tag:yaml.org,2002:seq'
+    DEFAULT_MAPPING_TAG = 'tag:yaml.org,2002:map'
+
+    yaml_implicit_resolvers = {}
+    yaml_path_resolvers = {}
+
+    def __init__(self):
+        self.resolver_exact_paths = []
+        self.resolver_prefix_paths = []
+
+    @classmethod
+    def add_implicit_resolver(cls, tag, regexp, first):
+        if not 'yaml_implicit_resolvers' in cls.__dict__:
+            implicit_resolvers = {}
+            for key in cls.yaml_implicit_resolvers:
+                implicit_resolvers[key] = cls.yaml_implicit_resolvers[key][:]
+            cls.yaml_implicit_resolvers = implicit_resolvers
+        if first is None:
+            first = [None]
+        for ch in first:
+            cls.yaml_implicit_resolvers.setdefault(ch, []).append((tag, regexp))
+
+    @classmethod
+    def add_path_resolver(cls, tag, path, kind=None):
+        # Note: `add_path_resolver` is experimental.  The API could be changed.
+        # `new_path` is a pattern that is matched against the path from the
+        # root to the node that is being considered.  `node_path` elements are
+        # tuples `(node_check, index_check)`.  `node_check` is a node class:
+        # `ScalarNode`, `SequenceNode`, `MappingNode` or `None`.  `None`
+        # matches any kind of a node.  `index_check` could be `None`, a boolean
+        # value, a string value, or a number.  `None` and `False` match against
+        # any _value_ of sequence and mapping nodes.  `True` matches against
+        # any _key_ of a mapping node.  A string `index_check` matches against
+        # a mapping value that corresponds to a scalar key which content is
+        # equal to the `index_check` value.  An integer `index_check` matches
+        # against a sequence value with the index equal to `index_check`.
+        if not 'yaml_path_resolvers' in cls.__dict__:
+            cls.yaml_path_resolvers = cls.yaml_path_resolvers.copy()
+        new_path = []
+        for element in path:
+            if isinstance(element, (list, tuple)):
+                if len(element) == 2:
+                    node_check, index_check = element
+                elif len(element) == 1:
+                    node_check = element[0]
+                    index_check = True
+                else:
+                    raise ResolverError("Invalid path element: %s" % element)
+            else:
+                node_check = None
+                index_check = element
+            if node_check is str:
+                node_check = ScalarNode
+            elif node_check is list:
+                node_check = SequenceNode
+            elif node_check is dict:
+                node_check = MappingNode
+            elif node_check not in [ScalarNode, SequenceNode, MappingNode]  \
+                    and not isinstance(node_check, str) \
+                    and node_check is not None:
+                raise ResolverError("Invalid node checker: %s" % node_check)
+            if not isinstance(index_check, (str, int))  \
+                    and index_check is not None:
+                raise ResolverError("Invalid index checker: %s" % index_check)
+            new_path.append((node_check, index_check))
+        if kind is str:
+            kind = ScalarNode
+        elif kind is list:
+            kind = SequenceNode
+        elif kind is dict:
+            kind = MappingNode
+        elif kind not in [ScalarNode, SequenceNode, MappingNode]    \
+                and kind is not None:
+            raise ResolverError("Invalid node kind: %s" % kind)
+        cls.yaml_path_resolvers[tuple(new_path), kind] = tag
+
+    def descend_resolver(self, current_node, current_index):
+        if not self.yaml_path_resolvers:
+            return
+        exact_paths = {}
+        prefix_paths = []
+        if current_node:
+            depth = len(self.resolver_prefix_paths)
+            for path, kind in self.resolver_prefix_paths[-1]:
+                if self.check_resolver_prefix(depth, path, kind,
+                        current_node, current_index):
+                    if len(path) > depth:
+                        prefix_paths.append((path, kind))
+                    else:
+                        exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+        else:
+            for path, kind in self.yaml_path_resolvers:
+                if not path:
+                    exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+                else:
+                    prefix_paths.append((path, kind))
+        self.resolver_exact_paths.append(exact_paths)
+        self.resolver_prefix_paths.append(prefix_paths)
+
+    def ascend_resolver(self):
+        if not self.yaml_path_resolvers:
+            return
+        self.resolver_exact_paths.pop()
+        self.resolver_prefix_paths.pop()
+
+    def check_resolver_prefix(self, depth, path, kind,
+            current_node, current_index):
+        node_check, index_check = path[depth-1]
+        if isinstance(node_check, str):
+            if current_node.tag != node_check:
+                return
+        elif node_check is not None:
+            if not isinstance(current_node, node_check):
+                return
+        if index_check is True and current_index is not None:
+            return
+        if (index_check is False or index_check is None)    \
+                and current_index is None:
+            return
+        if isinstance(index_check, str):
+            if not (isinstance(current_index, ScalarNode)
+                    and index_check == current_index.value):
+                return
+        elif isinstance(index_check, int) and not isinstance(index_check, bool):
+            if index_check != current_index:
+                return
+        return True
+
+    def resolve(self, kind, value, implicit):
+        if kind is ScalarNode and implicit[0]:
+            if value == '':
+                resolvers = self.yaml_implicit_resolvers.get('', [])
+            else:
+                resolvers = self.yaml_implicit_resolvers.get(value[0], [])
+            resolvers += self.yaml_implicit_resolvers.get(None, [])
+            for tag, regexp in resolvers:
+                if regexp.match(value):
+                    return tag
+            implicit = implicit[1]
+        if self.yaml_path_resolvers:
+            exact_paths = self.resolver_exact_paths[-1]
+            if kind in exact_paths:
+                return exact_paths[kind]
+            if None in exact_paths:
+                return exact_paths[None]
+        if kind is ScalarNode:
+            return self.DEFAULT_SCALAR_TAG
+        elif kind is SequenceNode:
+            return self.DEFAULT_SEQUENCE_TAG
+        elif kind is MappingNode:
+            return self.DEFAULT_MAPPING_TAG
+
+class Resolver(BaseResolver):
+    pass
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:bool',
+        re.compile(r'''^(?:yes|Yes|YES|no|No|NO
+                    |true|True|TRUE|false|False|FALSE
+                    |on|On|ON|off|Off|OFF)$''', re.X),
+        list('yYnNtTfFoO'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:float',
+        re.compile(r'''^(?:[-+]?(?:[0-9][0-9_]*)\.[0-9_]*(?:[eE][-+][0-9]+)?
+                    |\.[0-9_]+(?:[eE][-+][0-9]+)?
+                    |[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*
+                    |[-+]?\.(?:inf|Inf|INF)
+                    |\.(?:nan|NaN|NAN))$''', re.X),
+        list('-+0123456789.'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:int',
+        re.compile(r'''^(?:[-+]?0b[0-1_]+
+                    |[-+]?0[0-7_]+
+                    |[-+]?(?:0|[1-9][0-9_]*)
+                    |[-+]?0x[0-9a-fA-F_]+
+                    |[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)$''', re.X),
+        list('-+0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:merge',
+        re.compile(r'^(?:<<)$'),
+        ['<'])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:null',
+        re.compile(r'''^(?: ~
+                    |null|Null|NULL
+                    | )$''', re.X),
+        ['~', 'n', 'N', ''])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:timestamp',
+        re.compile(r'''^(?:[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]
+                    |[0-9][0-9][0-9][0-9] -[0-9][0-9]? -[0-9][0-9]?
+                     (?:[Tt]|[ \t]+)[0-9][0-9]?
+                     :[0-9][0-9] :[0-9][0-9] (?:\.[0-9]*)?
+                     (?:[ \t]*(?:Z|[-+][0-9][0-9]?(?::[0-9][0-9])?))?)$''', re.X),
+        list('0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:value',
+        re.compile(r'^(?:=)$'),
+        ['='])
+
+# The following resolver is only for documentation purposes. It cannot work
+# because plain scalars cannot start with '!', '&', or '*'.
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:yaml',
+        re.compile(r'^(?:!|&|\*)$'),
+        list('!&*'))
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/scanner.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/scanner.py
new file mode 100644
index 0000000000000000000000000000000000000000..7437ede1c608266aaca481955f438844479cab4f
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/scanner.py
@@ -0,0 +1,1435 @@
+
+# Scanner produces tokens of the following types:
+# STREAM-START
+# STREAM-END
+# DIRECTIVE(name, value)
+# DOCUMENT-START
+# DOCUMENT-END
+# BLOCK-SEQUENCE-START
+# BLOCK-MAPPING-START
+# BLOCK-END
+# FLOW-SEQUENCE-START
+# FLOW-MAPPING-START
+# FLOW-SEQUENCE-END
+# FLOW-MAPPING-END
+# BLOCK-ENTRY
+# FLOW-ENTRY
+# KEY
+# VALUE
+# ALIAS(value)
+# ANCHOR(value)
+# TAG(value)
+# SCALAR(value, plain, style)
+#
+# Read comments in the Scanner code for more details.
+#
+
+__all__ = ['Scanner', 'ScannerError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+
+class ScannerError(MarkedYAMLError):
+    pass
+
+class SimpleKey:
+    # See below simple keys treatment.
+
+    def __init__(self, token_number, required, index, line, column, mark):
+        self.token_number = token_number
+        self.required = required
+        self.index = index
+        self.line = line
+        self.column = column
+        self.mark = mark
+
+class Scanner:
+
+    def __init__(self):
+        """Initialize the scanner."""
+        # It is assumed that Scanner and Reader will have a common descendant.
+        # Reader do the dirty work of checking for BOM and converting the
+        # input data to Unicode. It also adds NUL to the end.
+        #
+        # Reader supports the following methods
+        #   self.peek(i=0)       # peek the next i-th character
+        #   self.prefix(l=1)     # peek the next l characters
+        #   self.forward(l=1)    # read the next l characters and move the pointer.
+
+        # Had we reached the end of the stream?
+        self.done = False
+
+        # The number of unclosed '{' and '['. `flow_level == 0` means block
+        # context.
+        self.flow_level = 0
+
+        # List of processed tokens that are not yet emitted.
+        self.tokens = []
+
+        # Add the STREAM-START token.
+        self.fetch_stream_start()
+
+        # Number of tokens that were emitted through the `get_token` method.
+        self.tokens_taken = 0
+
+        # The current indentation level.
+        self.indent = -1
+
+        # Past indentation levels.
+        self.indents = []
+
+        # Variables related to simple keys treatment.
+
+        # A simple key is a key that is not denoted by the '?' indicator.
+        # Example of simple keys:
+        #   ---
+        #   block simple key: value
+        #   ? not a simple key:
+        #   : { flow simple key: value }
+        # We emit the KEY token before all keys, so when we find a potential
+        # simple key, we try to locate the corresponding ':' indicator.
+        # Simple keys should be limited to a single line and 1024 characters.
+
+        # Can a simple key start at the current position? A simple key may
+        # start:
+        # - at the beginning of the line, not counting indentation spaces
+        #       (in block context),
+        # - after '{', '[', ',' (in the flow context),
+        # - after '?', ':', '-' (in the block context).
+        # In the block context, this flag also signifies if a block collection
+        # may start at the current position.
+        self.allow_simple_key = True
+
+        # Keep track of possible simple keys. This is a dictionary. The key
+        # is `flow_level`; there can be no more that one possible simple key
+        # for each level. The value is a SimpleKey record:
+        #   (token_number, required, index, line, column, mark)
+        # A simple key may start with ALIAS, ANCHOR, TAG, SCALAR(flow),
+        # '[', or '{' tokens.
+        self.possible_simple_keys = {}
+
+    # Public methods.
+
+    def check_token(self, *choices):
+        # Check if the next token is one of the given types.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.tokens[0], choice):
+                    return True
+        return False
+
+    def peek_token(self):
+        # Return the next token, but do not delete if from the queue.
+        # Return None if no more tokens.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            return self.tokens[0]
+        else:
+            return None
+
+    def get_token(self):
+        # Return the next token.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            self.tokens_taken += 1
+            return self.tokens.pop(0)
+
+    # Private methods.
+
+    def need_more_tokens(self):
+        if self.done:
+            return False
+        if not self.tokens:
+            return True
+        # The current token may be a potential simple key, so we
+        # need to look further.
+        self.stale_possible_simple_keys()
+        if self.next_possible_simple_key() == self.tokens_taken:
+            return True
+
+    def fetch_more_tokens(self):
+
+        # Eat whitespaces and comments until we reach the next token.
+        self.scan_to_next_token()
+
+        # Remove obsolete possible simple keys.
+        self.stale_possible_simple_keys()
+
+        # Compare the current indentation and column. It may add some tokens
+        # and decrease the current indentation level.
+        self.unwind_indent(self.column)
+
+        # Peek the next character.
+        ch = self.peek()
+
+        # Is it the end of stream?
+        if ch == '\0':
+            return self.fetch_stream_end()
+
+        # Is it a directive?
+        if ch == '%' and self.check_directive():
+            return self.fetch_directive()
+
+        # Is it the document start?
+        if ch == '-' and self.check_document_start():
+            return self.fetch_document_start()
+
+        # Is it the document end?
+        if ch == '.' and self.check_document_end():
+            return self.fetch_document_end()
+
+        # TODO: support for BOM within a stream.
+        #if ch == '\uFEFF':
+        #    return self.fetch_bom()    <-- issue BOMToken
+
+        # Note: the order of the following checks is NOT significant.
+
+        # Is it the flow sequence start indicator?
+        if ch == '[':
+            return self.fetch_flow_sequence_start()
+
+        # Is it the flow mapping start indicator?
+        if ch == '{':
+            return self.fetch_flow_mapping_start()
+
+        # Is it the flow sequence end indicator?
+        if ch == ']':
+            return self.fetch_flow_sequence_end()
+
+        # Is it the flow mapping end indicator?
+        if ch == '}':
+            return self.fetch_flow_mapping_end()
+
+        # Is it the flow entry indicator?
+        if ch == ',':
+            return self.fetch_flow_entry()
+
+        # Is it the block entry indicator?
+        if ch == '-' and self.check_block_entry():
+            return self.fetch_block_entry()
+
+        # Is it the key indicator?
+        if ch == '?' and self.check_key():
+            return self.fetch_key()
+
+        # Is it the value indicator?
+        if ch == ':' and self.check_value():
+            return self.fetch_value()
+
+        # Is it an alias?
+        if ch == '*':
+            return self.fetch_alias()
+
+        # Is it an anchor?
+        if ch == '&':
+            return self.fetch_anchor()
+
+        # Is it a tag?
+        if ch == '!':
+            return self.fetch_tag()
+
+        # Is it a literal scalar?
+        if ch == '|' and not self.flow_level:
+            return self.fetch_literal()
+
+        # Is it a folded scalar?
+        if ch == '>' and not self.flow_level:
+            return self.fetch_folded()
+
+        # Is it a single quoted scalar?
+        if ch == '\'':
+            return self.fetch_single()
+
+        # Is it a double quoted scalar?
+        if ch == '\"':
+            return self.fetch_double()
+
+        # It must be a plain scalar then.
+        if self.check_plain():
+            return self.fetch_plain()
+
+        # No? It's an error. Let's produce a nice error message.
+        raise ScannerError("while scanning for the next token", None,
+                "found character %r that cannot start any token" % ch,
+                self.get_mark())
+
+    # Simple keys treatment.
+
+    def next_possible_simple_key(self):
+        # Return the number of the nearest possible simple key. Actually we
+        # don't need to loop through the whole dictionary. We may replace it
+        # with the following code:
+        #   if not self.possible_simple_keys:
+        #       return None
+        #   return self.possible_simple_keys[
+        #           min(self.possible_simple_keys.keys())].token_number
+        min_token_number = None
+        for level in self.possible_simple_keys:
+            key = self.possible_simple_keys[level]
+            if min_token_number is None or key.token_number < min_token_number:
+                min_token_number = key.token_number
+        return min_token_number
+
+    def stale_possible_simple_keys(self):
+        # Remove entries that are no longer possible simple keys. According to
+        # the YAML specification, simple keys
+        # - should be limited to a single line,
+        # - should be no longer than 1024 characters.
+        # Disabling this procedure will allow simple keys of any length and
+        # height (may cause problems if indentation is broken though).
+        for level in list(self.possible_simple_keys):
+            key = self.possible_simple_keys[level]
+            if key.line != self.line  \
+                    or self.index-key.index > 1024:
+                if key.required:
+                    raise ScannerError("while scanning a simple key", key.mark,
+                            "could not find expected ':'", self.get_mark())
+                del self.possible_simple_keys[level]
+
+    def save_possible_simple_key(self):
+        # The next token may start a simple key. We check if it's possible
+        # and save its position. This function is called for
+        #   ALIAS, ANCHOR, TAG, SCALAR(flow), '[', and '{'.
+
+        # Check if a simple key is required at the current position.
+        required = not self.flow_level and self.indent == self.column
+
+        # The next token might be a simple key. Let's save it's number and
+        # position.
+        if self.allow_simple_key:
+            self.remove_possible_simple_key()
+            token_number = self.tokens_taken+len(self.tokens)
+            key = SimpleKey(token_number, required,
+                    self.index, self.line, self.column, self.get_mark())
+            self.possible_simple_keys[self.flow_level] = key
+
+    def remove_possible_simple_key(self):
+        # Remove the saved possible key position at the current flow level.
+        if self.flow_level in self.possible_simple_keys:
+            key = self.possible_simple_keys[self.flow_level]
+            
+            if key.required:
+                raise ScannerError("while scanning a simple key", key.mark,
+                        "could not find expected ':'", self.get_mark())
+
+            del self.possible_simple_keys[self.flow_level]
+
+    # Indentation functions.
+
+    def unwind_indent(self, column):
+
+        ## In flow context, tokens should respect indentation.
+        ## Actually the condition should be `self.indent >= column` according to
+        ## the spec. But this condition will prohibit intuitively correct
+        ## constructions such as
+        ## key : {
+        ## }
+        #if self.flow_level and self.indent > column:
+        #    raise ScannerError(None, None,
+        #            "invalid indentation or unclosed '[' or '{'",
+        #            self.get_mark())
+
+        # In the flow context, indentation is ignored. We make the scanner less
+        # restrictive then specification requires.
+        if self.flow_level:
+            return
+
+        # In block context, we may need to issue the BLOCK-END tokens.
+        while self.indent > column:
+            mark = self.get_mark()
+            self.indent = self.indents.pop()
+            self.tokens.append(BlockEndToken(mark, mark))
+
+    def add_indent(self, column):
+        # Check if we need to increase indentation.
+        if self.indent < column:
+            self.indents.append(self.indent)
+            self.indent = column
+            return True
+        return False
+
+    # Fetchers.
+
+    def fetch_stream_start(self):
+        # We always add STREAM-START as the first token and STREAM-END as the
+        # last token.
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-START.
+        self.tokens.append(StreamStartToken(mark, mark,
+            encoding=self.encoding))
+        
+
+    def fetch_stream_end(self):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+        self.possible_simple_keys = {}
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-END.
+        self.tokens.append(StreamEndToken(mark, mark))
+
+        # The steam is finished.
+        self.done = True
+
+    def fetch_directive(self):
+        
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Scan and add DIRECTIVE.
+        self.tokens.append(self.scan_directive())
+
+    def fetch_document_start(self):
+        self.fetch_document_indicator(DocumentStartToken)
+
+    def fetch_document_end(self):
+        self.fetch_document_indicator(DocumentEndToken)
+
+    def fetch_document_indicator(self, TokenClass):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys. Note that there could not be a block collection
+        # after '---'.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Add DOCUMENT-START or DOCUMENT-END.
+        start_mark = self.get_mark()
+        self.forward(3)
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_start(self):
+        self.fetch_flow_collection_start(FlowSequenceStartToken)
+
+    def fetch_flow_mapping_start(self):
+        self.fetch_flow_collection_start(FlowMappingStartToken)
+
+    def fetch_flow_collection_start(self, TokenClass):
+
+        # '[' and '{' may start a simple key.
+        self.save_possible_simple_key()
+
+        # Increase the flow level.
+        self.flow_level += 1
+
+        # Simple keys are allowed after '[' and '{'.
+        self.allow_simple_key = True
+
+        # Add FLOW-SEQUENCE-START or FLOW-MAPPING-START.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_end(self):
+        self.fetch_flow_collection_end(FlowSequenceEndToken)
+
+    def fetch_flow_mapping_end(self):
+        self.fetch_flow_collection_end(FlowMappingEndToken)
+
+    def fetch_flow_collection_end(self, TokenClass):
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Decrease the flow level.
+        self.flow_level -= 1
+
+        # No simple keys after ']' or '}'.
+        self.allow_simple_key = False
+
+        # Add FLOW-SEQUENCE-END or FLOW-MAPPING-END.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_entry(self):
+
+        # Simple keys are allowed after ','.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add FLOW-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(FlowEntryToken(start_mark, end_mark))
+
+    def fetch_block_entry(self):
+
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a new entry?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "sequence entries are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-SEQUENCE-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockSequenceStartToken(mark, mark))
+
+        # It's an error for the block entry to occur in the flow context,
+        # but we let the parser detect this.
+        else:
+            pass
+
+        # Simple keys are allowed after '-'.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add BLOCK-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(BlockEntryToken(start_mark, end_mark))
+
+    def fetch_key(self):
+        
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a key (not necessary a simple)?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "mapping keys are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-MAPPING-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockMappingStartToken(mark, mark))
+
+        # Simple keys are allowed after '?' in the block context.
+        self.allow_simple_key = not self.flow_level
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add KEY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(KeyToken(start_mark, end_mark))
+
+    def fetch_value(self):
+
+        # Do we determine a simple key?
+        if self.flow_level in self.possible_simple_keys:
+
+            # Add KEY.
+            key = self.possible_simple_keys[self.flow_level]
+            del self.possible_simple_keys[self.flow_level]
+            self.tokens.insert(key.token_number-self.tokens_taken,
+                    KeyToken(key.mark, key.mark))
+
+            # If this key starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.
+            if not self.flow_level:
+                if self.add_indent(key.column):
+                    self.tokens.insert(key.token_number-self.tokens_taken,
+                            BlockMappingStartToken(key.mark, key.mark))
+
+            # There cannot be two simple keys one after another.
+            self.allow_simple_key = False
+
+        # It must be a part of a complex key.
+        else:
+            
+            # Block context needs additional checks.
+            # (Do we really need them? They will be caught by the parser
+            # anyway.)
+            if not self.flow_level:
+
+                # We are allowed to start a complex value if and only if
+                # we can start a simple key.
+                if not self.allow_simple_key:
+                    raise ScannerError(None, None,
+                            "mapping values are not allowed here",
+                            self.get_mark())
+
+            # If this value starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.  It will be detected as an error later by
+            # the parser.
+            if not self.flow_level:
+                if self.add_indent(self.column):
+                    mark = self.get_mark()
+                    self.tokens.append(BlockMappingStartToken(mark, mark))
+
+            # Simple keys are allowed after ':' in the block context.
+            self.allow_simple_key = not self.flow_level
+
+            # Reset possible simple key on the current level.
+            self.remove_possible_simple_key()
+
+        # Add VALUE.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(ValueToken(start_mark, end_mark))
+
+    def fetch_alias(self):
+
+        # ALIAS could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ALIAS.
+        self.allow_simple_key = False
+
+        # Scan and add ALIAS.
+        self.tokens.append(self.scan_anchor(AliasToken))
+
+    def fetch_anchor(self):
+
+        # ANCHOR could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ANCHOR.
+        self.allow_simple_key = False
+
+        # Scan and add ANCHOR.
+        self.tokens.append(self.scan_anchor(AnchorToken))
+
+    def fetch_tag(self):
+
+        # TAG could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after TAG.
+        self.allow_simple_key = False
+
+        # Scan and add TAG.
+        self.tokens.append(self.scan_tag())
+
+    def fetch_literal(self):
+        self.fetch_block_scalar(style='|')
+
+    def fetch_folded(self):
+        self.fetch_block_scalar(style='>')
+
+    def fetch_block_scalar(self, style):
+
+        # A simple key may follow a block scalar.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_block_scalar(style))
+
+    def fetch_single(self):
+        self.fetch_flow_scalar(style='\'')
+
+    def fetch_double(self):
+        self.fetch_flow_scalar(style='"')
+
+    def fetch_flow_scalar(self, style):
+
+        # A flow scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after flow scalars.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_flow_scalar(style))
+
+    def fetch_plain(self):
+
+        # A plain scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after plain scalars. But note that `scan_plain` will
+        # change this flag if the scan is finished at the beginning of the
+        # line.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR. May change `allow_simple_key`.
+        self.tokens.append(self.scan_plain())
+
+    # Checkers.
+
+    def check_directive(self):
+
+        # DIRECTIVE:        ^ '%' ...
+        # The '%' indicator is already checked.
+        if self.column == 0:
+            return True
+
+    def check_document_start(self):
+
+        # DOCUMENT-START:   ^ '---' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '---'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_document_end(self):
+
+        # DOCUMENT-END:     ^ '...' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '...'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_block_entry(self):
+
+        # BLOCK-ENTRY:      '-' (' '|'\n')
+        return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_key(self):
+
+        # KEY(flow context):    '?'
+        if self.flow_level:
+            return True
+
+        # KEY(block context):   '?' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_value(self):
+
+        # VALUE(flow context):  ':'
+        if self.flow_level:
+            return True
+
+        # VALUE(block context): ':' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_plain(self):
+
+        # A plain scalar may start with any non-space character except:
+        #   '-', '?', ':', ',', '[', ']', '{', '}',
+        #   '#', '&', '*', '!', '|', '>', '\'', '\"',
+        #   '%', '@', '`'.
+        #
+        # It may also start with
+        #   '-', '?', ':'
+        # if it is followed by a non-space character.
+        #
+        # Note that we limit the last rule to the block context (except the
+        # '-' character) because we want the flow context to be space
+        # independent.
+        ch = self.peek()
+        return ch not in '\0 \t\r\n\x85\u2028\u2029-?:,[]{}#&*!|>\'\"%@`'  \
+                or (self.peek(1) not in '\0 \t\r\n\x85\u2028\u2029'
+                        and (ch == '-' or (not self.flow_level and ch in '?:')))
+
+    # Scanners.
+
+    def scan_to_next_token(self):
+        # We ignore spaces, line breaks and comments.
+        # If we find a line break in the block context, we set the flag
+        # `allow_simple_key` on.
+        # The byte order mark is stripped if it's the first character in the
+        # stream. We do not yet support BOM inside the stream as the
+        # specification requires. Any such mark will be considered as a part
+        # of the document.
+        #
+        # TODO: We need to make tab handling rules more sane. A good rule is
+        #   Tabs cannot precede tokens
+        #   BLOCK-SEQUENCE-START, BLOCK-MAPPING-START, BLOCK-END,
+        #   KEY(block), VALUE(block), BLOCK-ENTRY
+        # So the checking code is
+        #   if <TAB>:
+        #       self.allow_simple_keys = False
+        # We also need to add the check for `allow_simple_keys == True` to
+        # `unwind_indent` before issuing BLOCK-END.
+        # Scanners for block, flow, and plain scalars need to be modified.
+
+        if self.index == 0 and self.peek() == '\uFEFF':
+            self.forward()
+        found = False
+        while not found:
+            while self.peek() == ' ':
+                self.forward()
+            if self.peek() == '#':
+                while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                    self.forward()
+            if self.scan_line_break():
+                if not self.flow_level:
+                    self.allow_simple_key = True
+            else:
+                found = True
+
+    def scan_directive(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        self.forward()
+        name = self.scan_directive_name(start_mark)
+        value = None
+        if name == 'YAML':
+            value = self.scan_yaml_directive_value(start_mark)
+            end_mark = self.get_mark()
+        elif name == 'TAG':
+            value = self.scan_tag_directive_value(start_mark)
+            end_mark = self.get_mark()
+        else:
+            end_mark = self.get_mark()
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        self.scan_directive_ignored_line(start_mark)
+        return DirectiveToken(name, value, start_mark, end_mark)
+
+    def scan_directive_name(self, start_mark):
+        # See the specification for details.
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        return value
+
+    def scan_yaml_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        major = self.scan_yaml_directive_number(start_mark)
+        if self.peek() != '.':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or '.', but found %r" % self.peek(),
+                    self.get_mark())
+        self.forward()
+        minor = self.scan_yaml_directive_number(start_mark)
+        if self.peek() not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or ' ', but found %r" % self.peek(),
+                    self.get_mark())
+        return (major, minor)
+
+    def scan_yaml_directive_number(self, start_mark):
+        # See the specification for details.
+        ch = self.peek()
+        if not ('0' <= ch <= '9'):
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit, but found %r" % ch, self.get_mark())
+        length = 0
+        while '0' <= self.peek(length) <= '9':
+            length += 1
+        value = int(self.prefix(length))
+        self.forward(length)
+        return value
+
+    def scan_tag_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        handle = self.scan_tag_directive_handle(start_mark)
+        while self.peek() == ' ':
+            self.forward()
+        prefix = self.scan_tag_directive_prefix(start_mark)
+        return (handle, prefix)
+
+    def scan_tag_directive_handle(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_handle('directive', start_mark)
+        ch = self.peek()
+        if ch != ' ':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_tag_directive_prefix(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_uri('directive', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_directive_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a comment or a line break, but found %r"
+                        % ch, self.get_mark())
+        self.scan_line_break()
+
+    def scan_anchor(self, TokenClass):
+        # The specification does not restrict characters for anchors and
+        # aliases. This may lead to problems, for instance, the document:
+        #   [ *alias, value ]
+        # can be interpreted in two ways, as
+        #   [ "value" ]
+        # and
+        #   [ *alias , "value" ]
+        # Therefore we restrict aliases to numbers and ASCII letters.
+        start_mark = self.get_mark()
+        indicator = self.peek()
+        if indicator == '*':
+            name = 'alias'
+        else:
+            name = 'anchor'
+        self.forward()
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \t\r\n\x85\u2028\u2029?:,]}%@`':
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        end_mark = self.get_mark()
+        return TokenClass(value, start_mark, end_mark)
+
+    def scan_tag(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        ch = self.peek(1)
+        if ch == '<':
+            handle = None
+            self.forward(2)
+            suffix = self.scan_tag_uri('tag', start_mark)
+            if self.peek() != '>':
+                raise ScannerError("while parsing a tag", start_mark,
+                        "expected '>', but found %r" % self.peek(),
+                        self.get_mark())
+            self.forward()
+        elif ch in '\0 \t\r\n\x85\u2028\u2029':
+            handle = None
+            suffix = '!'
+            self.forward()
+        else:
+            length = 1
+            use_handle = False
+            while ch not in '\0 \r\n\x85\u2028\u2029':
+                if ch == '!':
+                    use_handle = True
+                    break
+                length += 1
+                ch = self.peek(length)
+            handle = '!'
+            if use_handle:
+                handle = self.scan_tag_handle('tag', start_mark)
+            else:
+                handle = '!'
+                self.forward()
+            suffix = self.scan_tag_uri('tag', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a tag", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        value = (handle, suffix)
+        end_mark = self.get_mark()
+        return TagToken(value, start_mark, end_mark)
+
+    def scan_block_scalar(self, style):
+        # See the specification for details.
+
+        if style == '>':
+            folded = True
+        else:
+            folded = False
+
+        chunks = []
+        start_mark = self.get_mark()
+
+        # Scan the header.
+        self.forward()
+        chomping, increment = self.scan_block_scalar_indicators(start_mark)
+        self.scan_block_scalar_ignored_line(start_mark)
+
+        # Determine the indentation level and go to the first non-empty line.
+        min_indent = self.indent+1
+        if min_indent < 1:
+            min_indent = 1
+        if increment is None:
+            breaks, max_indent, end_mark = self.scan_block_scalar_indentation()
+            indent = max(min_indent, max_indent)
+        else:
+            indent = min_indent+increment-1
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+        line_break = ''
+
+        # Scan the inner part of the block scalar.
+        while self.column == indent and self.peek() != '\0':
+            chunks.extend(breaks)
+            leading_non_space = self.peek() not in ' \t'
+            length = 0
+            while self.peek(length) not in '\0\r\n\x85\u2028\u2029':
+                length += 1
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            line_break = self.scan_line_break()
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+            if self.column == indent and self.peek() != '\0':
+
+                # Unfortunately, folding rules are ambiguous.
+                #
+                # This is the folding according to the specification:
+                
+                if folded and line_break == '\n'    \
+                        and leading_non_space and self.peek() not in ' \t':
+                    if not breaks:
+                        chunks.append(' ')
+                else:
+                    chunks.append(line_break)
+                
+                # This is Clark Evans's interpretation (also in the spec
+                # examples):
+                #
+                #if folded and line_break == '\n':
+                #    if not breaks:
+                #        if self.peek() not in ' \t':
+                #            chunks.append(' ')
+                #        else:
+                #            chunks.append(line_break)
+                #else:
+                #    chunks.append(line_break)
+            else:
+                break
+
+        # Chomp the tail.
+        if chomping is not False:
+            chunks.append(line_break)
+        if chomping is True:
+            chunks.extend(breaks)
+
+        # We are done.
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    def scan_block_scalar_indicators(self, start_mark):
+        # See the specification for details.
+        chomping = None
+        increment = None
+        ch = self.peek()
+        if ch in '+-':
+            if ch == '+':
+                chomping = True
+            else:
+                chomping = False
+            self.forward()
+            ch = self.peek()
+            if ch in '0123456789':
+                increment = int(ch)
+                if increment == 0:
+                    raise ScannerError("while scanning a block scalar", start_mark,
+                            "expected indentation indicator in the range 1-9, but found 0",
+                            self.get_mark())
+                self.forward()
+        elif ch in '0123456789':
+            increment = int(ch)
+            if increment == 0:
+                raise ScannerError("while scanning a block scalar", start_mark,
+                        "expected indentation indicator in the range 1-9, but found 0",
+                        self.get_mark())
+            self.forward()
+            ch = self.peek()
+            if ch in '+-':
+                if ch == '+':
+                    chomping = True
+                else:
+                    chomping = False
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected chomping or indentation indicators, but found %r"
+                    % ch, self.get_mark())
+        return chomping, increment
+
+    def scan_block_scalar_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected a comment or a line break, but found %r" % ch,
+                    self.get_mark())
+        self.scan_line_break()
+
+    def scan_block_scalar_indentation(self):
+        # See the specification for details.
+        chunks = []
+        max_indent = 0
+        end_mark = self.get_mark()
+        while self.peek() in ' \r\n\x85\u2028\u2029':
+            if self.peek() != ' ':
+                chunks.append(self.scan_line_break())
+                end_mark = self.get_mark()
+            else:
+                self.forward()
+                if self.column > max_indent:
+                    max_indent = self.column
+        return chunks, max_indent, end_mark
+
+    def scan_block_scalar_breaks(self, indent):
+        # See the specification for details.
+        chunks = []
+        end_mark = self.get_mark()
+        while self.column < indent and self.peek() == ' ':
+            self.forward()
+        while self.peek() in '\r\n\x85\u2028\u2029':
+            chunks.append(self.scan_line_break())
+            end_mark = self.get_mark()
+            while self.column < indent and self.peek() == ' ':
+                self.forward()
+        return chunks, end_mark
+
+    def scan_flow_scalar(self, style):
+        # See the specification for details.
+        # Note that we loose indentation rules for quoted scalars. Quoted
+        # scalars don't need to adhere indentation because " and ' clearly
+        # mark the beginning and the end of them. Therefore we are less
+        # restrictive then the specification requires. We only need to check
+        # that document separators are not included in scalars.
+        if style == '"':
+            double = True
+        else:
+            double = False
+        chunks = []
+        start_mark = self.get_mark()
+        quote = self.peek()
+        self.forward()
+        chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        while self.peek() != quote:
+            chunks.extend(self.scan_flow_scalar_spaces(double, start_mark))
+            chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        self.forward()
+        end_mark = self.get_mark()
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    ESCAPE_REPLACEMENTS = {
+        '0':    '\0',
+        'a':    '\x07',
+        'b':    '\x08',
+        't':    '\x09',
+        '\t':   '\x09',
+        'n':    '\x0A',
+        'v':    '\x0B',
+        'f':    '\x0C',
+        'r':    '\x0D',
+        'e':    '\x1B',
+        ' ':    '\x20',
+        '\"':   '\"',
+        '\\':   '\\',
+        '/':    '/',
+        'N':    '\x85',
+        '_':    '\xA0',
+        'L':    '\u2028',
+        'P':    '\u2029',
+    }
+
+    ESCAPE_CODES = {
+        'x':    2,
+        'u':    4,
+        'U':    8,
+    }
+
+    def scan_flow_scalar_non_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            length = 0
+            while self.peek(length) not in '\'\"\\\0 \t\r\n\x85\u2028\u2029':
+                length += 1
+            if length:
+                chunks.append(self.prefix(length))
+                self.forward(length)
+            ch = self.peek()
+            if not double and ch == '\'' and self.peek(1) == '\'':
+                chunks.append('\'')
+                self.forward(2)
+            elif (double and ch == '\'') or (not double and ch in '\"\\'):
+                chunks.append(ch)
+                self.forward()
+            elif double and ch == '\\':
+                self.forward()
+                ch = self.peek()
+                if ch in self.ESCAPE_REPLACEMENTS:
+                    chunks.append(self.ESCAPE_REPLACEMENTS[ch])
+                    self.forward()
+                elif ch in self.ESCAPE_CODES:
+                    length = self.ESCAPE_CODES[ch]
+                    self.forward()
+                    for k in range(length):
+                        if self.peek(k) not in '0123456789ABCDEFabcdef':
+                            raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                                    "expected escape sequence of %d hexdecimal numbers, but found %r" %
+                                        (length, self.peek(k)), self.get_mark())
+                    code = int(self.prefix(length), 16)
+                    chunks.append(chr(code))
+                    self.forward(length)
+                elif ch in '\r\n\x85\u2028\u2029':
+                    self.scan_line_break()
+                    chunks.extend(self.scan_flow_scalar_breaks(double, start_mark))
+                else:
+                    raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                            "found unknown escape character %r" % ch, self.get_mark())
+            else:
+                return chunks
+
+    def scan_flow_scalar_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        length = 0
+        while self.peek(length) in ' \t':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch == '\0':
+            raise ScannerError("while scanning a quoted scalar", start_mark,
+                    "found unexpected end of stream", self.get_mark())
+        elif ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            breaks = self.scan_flow_scalar_breaks(double, start_mark)
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        else:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_flow_scalar_breaks(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            # Instead of checking indentation, we check for document
+            # separators.
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                raise ScannerError("while scanning a quoted scalar", start_mark,
+                        "found unexpected document separator", self.get_mark())
+            while self.peek() in ' \t':
+                self.forward()
+            if self.peek() in '\r\n\x85\u2028\u2029':
+                chunks.append(self.scan_line_break())
+            else:
+                return chunks
+
+    def scan_plain(self):
+        # See the specification for details.
+        # We add an additional restriction for the flow context:
+        #   plain scalars in the flow context cannot contain ',' or '?'.
+        # We also keep track of the `allow_simple_key` flag here.
+        # Indentation rules are loosed for the flow context.
+        chunks = []
+        start_mark = self.get_mark()
+        end_mark = start_mark
+        indent = self.indent+1
+        # We allow zero indentation for scalars, but then we need to check for
+        # document separators at the beginning of the line.
+        #if indent == 0:
+        #    indent = 1
+        spaces = []
+        while True:
+            length = 0
+            if self.peek() == '#':
+                break
+            while True:
+                ch = self.peek(length)
+                if ch in '\0 \t\r\n\x85\u2028\u2029'    \
+                        or (ch == ':' and
+                                self.peek(length+1) in '\0 \t\r\n\x85\u2028\u2029'
+                                      + (u',[]{}' if self.flow_level else u''))\
+                        or (self.flow_level and ch in ',?[]{}'):
+                    break
+                length += 1
+            if length == 0:
+                break
+            self.allow_simple_key = False
+            chunks.extend(spaces)
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            end_mark = self.get_mark()
+            spaces = self.scan_plain_spaces(indent, start_mark)
+            if not spaces or self.peek() == '#' \
+                    or (not self.flow_level and self.column < indent):
+                break
+        return ScalarToken(''.join(chunks), True, start_mark, end_mark)
+
+    def scan_plain_spaces(self, indent, start_mark):
+        # See the specification for details.
+        # The specification is really confusing about tabs in plain scalars.
+        # We just forbid them completely. Do not use tabs in YAML!
+        chunks = []
+        length = 0
+        while self.peek(length) in ' ':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            self.allow_simple_key = True
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return
+            breaks = []
+            while self.peek() in ' \r\n\x85\u2028\u2029':
+                if self.peek() == ' ':
+                    self.forward()
+                else:
+                    breaks.append(self.scan_line_break())
+                    prefix = self.prefix(3)
+                    if (prefix == '---' or prefix == '...')   \
+                            and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                        return
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        elif whitespaces:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_tag_handle(self, name, start_mark):
+        # See the specification for details.
+        # For some strange reasons, the specification does not allow '_' in
+        # tag handles. I have allowed it anyway.
+        ch = self.peek()
+        if ch != '!':
+            raise ScannerError("while scanning a %s" % name, start_mark,
+                    "expected '!', but found %r" % ch, self.get_mark())
+        length = 1
+        ch = self.peek(length)
+        if ch != ' ':
+            while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                    or ch in '-_':
+                length += 1
+                ch = self.peek(length)
+            if ch != '!':
+                self.forward(length)
+                raise ScannerError("while scanning a %s" % name, start_mark,
+                        "expected '!', but found %r" % ch, self.get_mark())
+            length += 1
+        value = self.prefix(length)
+        self.forward(length)
+        return value
+
+    def scan_tag_uri(self, name, start_mark):
+        # See the specification for details.
+        # Note: we do not check if URI is well-formed.
+        chunks = []
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-;/?:@&=+$,_.!~*\'()[]%':
+            if ch == '%':
+                chunks.append(self.prefix(length))
+                self.forward(length)
+                length = 0
+                chunks.append(self.scan_uri_escapes(name, start_mark))
+            else:
+                length += 1
+            ch = self.peek(length)
+        if length:
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            length = 0
+        if not chunks:
+            raise ScannerError("while parsing a %s" % name, start_mark,
+                    "expected URI, but found %r" % ch, self.get_mark())
+        return ''.join(chunks)
+
+    def scan_uri_escapes(self, name, start_mark):
+        # See the specification for details.
+        codes = []
+        mark = self.get_mark()
+        while self.peek() == '%':
+            self.forward()
+            for k in range(2):
+                if self.peek(k) not in '0123456789ABCDEFabcdef':
+                    raise ScannerError("while scanning a %s" % name, start_mark,
+                            "expected URI escape sequence of 2 hexdecimal numbers, but found %r"
+                            % self.peek(k), self.get_mark())
+            codes.append(int(self.prefix(2), 16))
+            self.forward(2)
+        try:
+            value = bytes(codes).decode('utf-8')
+        except UnicodeDecodeError as exc:
+            raise ScannerError("while scanning a %s" % name, start_mark, str(exc), mark)
+        return value
+
+    def scan_line_break(self):
+        # Transforms:
+        #   '\r\n'      :   '\n'
+        #   '\r'        :   '\n'
+        #   '\n'        :   '\n'
+        #   '\x85'      :   '\n'
+        #   '\u2028'    :   '\u2028'
+        #   '\u2029     :   '\u2029'
+        #   default     :   ''
+        ch = self.peek()
+        if ch in '\r\n\x85':
+            if self.prefix(2) == '\r\n':
+                self.forward(2)
+            else:
+                self.forward()
+            return '\n'
+        elif ch in '\u2028\u2029':
+            self.forward()
+            return ch
+        return ''
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/serializer.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe911e67ae7a739abb491fbbc6834b9c37bbda4b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/serializer.py
@@ -0,0 +1,111 @@
+
+__all__ = ['Serializer', 'SerializerError']
+
+from .error import YAMLError
+from .events import *
+from .nodes import *
+
+class SerializerError(YAMLError):
+    pass
+
+class Serializer:
+
+    ANCHOR_TEMPLATE = 'id%03d'
+
+    def __init__(self, encoding=None,
+            explicit_start=None, explicit_end=None, version=None, tags=None):
+        self.use_encoding = encoding
+        self.use_explicit_start = explicit_start
+        self.use_explicit_end = explicit_end
+        self.use_version = version
+        self.use_tags = tags
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+        self.closed = None
+
+    def open(self):
+        if self.closed is None:
+            self.emit(StreamStartEvent(encoding=self.use_encoding))
+            self.closed = False
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        else:
+            raise SerializerError("serializer is already opened")
+
+    def close(self):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif not self.closed:
+            self.emit(StreamEndEvent())
+            self.closed = True
+
+    #def __del__(self):
+    #    self.close()
+
+    def serialize(self, node):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        self.emit(DocumentStartEvent(explicit=self.use_explicit_start,
+            version=self.use_version, tags=self.use_tags))
+        self.anchor_node(node)
+        self.serialize_node(node, None, None)
+        self.emit(DocumentEndEvent(explicit=self.use_explicit_end))
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+
+    def anchor_node(self, node):
+        if node in self.anchors:
+            if self.anchors[node] is None:
+                self.anchors[node] = self.generate_anchor(node)
+        else:
+            self.anchors[node] = None
+            if isinstance(node, SequenceNode):
+                for item in node.value:
+                    self.anchor_node(item)
+            elif isinstance(node, MappingNode):
+                for key, value in node.value:
+                    self.anchor_node(key)
+                    self.anchor_node(value)
+
+    def generate_anchor(self, node):
+        self.last_anchor_id += 1
+        return self.ANCHOR_TEMPLATE % self.last_anchor_id
+
+    def serialize_node(self, node, parent, index):
+        alias = self.anchors[node]
+        if node in self.serialized_nodes:
+            self.emit(AliasEvent(alias))
+        else:
+            self.serialized_nodes[node] = True
+            self.descend_resolver(parent, index)
+            if isinstance(node, ScalarNode):
+                detected_tag = self.resolve(ScalarNode, node.value, (True, False))
+                default_tag = self.resolve(ScalarNode, node.value, (False, True))
+                implicit = (node.tag == detected_tag), (node.tag == default_tag)
+                self.emit(ScalarEvent(alias, node.tag, implicit, node.value,
+                    style=node.style))
+            elif isinstance(node, SequenceNode):
+                implicit = (node.tag
+                            == self.resolve(SequenceNode, node.value, True))
+                self.emit(SequenceStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                index = 0
+                for item in node.value:
+                    self.serialize_node(item, node, index)
+                    index += 1
+                self.emit(SequenceEndEvent())
+            elif isinstance(node, MappingNode):
+                implicit = (node.tag
+                            == self.resolve(MappingNode, node.value, True))
+                self.emit(MappingStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                for key, value in node.value:
+                    self.serialize_node(key, node, None)
+                    self.serialize_node(value, node, key)
+                self.emit(MappingEndEvent())
+            self.ascend_resolver()
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/tokens.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/tokens.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d0b48a394ac8c019b401516a12f688df361cf90
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/charms/srs-enb-ue/venv/yaml/tokens.py
@@ -0,0 +1,104 @@
+
+class Token(object):
+    def __init__(self, start_mark, end_mark):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in self.__dict__
+                if not key.endswith('_mark')]
+        attributes.sort()
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+#class BOMToken(Token):
+#    id = '<byte order mark>'
+
+class DirectiveToken(Token):
+    id = '<directive>'
+    def __init__(self, name, value, start_mark, end_mark):
+        self.name = name
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class DocumentStartToken(Token):
+    id = '<document start>'
+
+class DocumentEndToken(Token):
+    id = '<document end>'
+
+class StreamStartToken(Token):
+    id = '<stream start>'
+    def __init__(self, start_mark=None, end_mark=None,
+            encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndToken(Token):
+    id = '<stream end>'
+
+class BlockSequenceStartToken(Token):
+    id = '<block sequence start>'
+
+class BlockMappingStartToken(Token):
+    id = '<block mapping start>'
+
+class BlockEndToken(Token):
+    id = '<block end>'
+
+class FlowSequenceStartToken(Token):
+    id = '['
+
+class FlowMappingStartToken(Token):
+    id = '{'
+
+class FlowSequenceEndToken(Token):
+    id = ']'
+
+class FlowMappingEndToken(Token):
+    id = '}'
+
+class KeyToken(Token):
+    id = '?'
+
+class ValueToken(Token):
+    id = ':'
+
+class BlockEntryToken(Token):
+    id = '-'
+
+class FlowEntryToken(Token):
+    id = ','
+
+class AliasToken(Token):
+    id = '<alias>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class AnchorToken(Token):
+    id = '<anchor>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class TagToken(Token):
+    id = '<tag>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class ScalarToken(Token):
+    id = '<scalar>'
+    def __init__(self, value, plain, start_mark, end_mark, style=None):
+        self.value = value
+        self.plain = plain
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/magmaagw_init b/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/magmaagw_init
new file mode 100644
index 0000000000000000000000000000000000000000..56829df3fb73cb225bc177f297a33991efcd3132
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/magmaagw_init
@@ -0,0 +1,17 @@
+#cloud-config
+runcmd:
+  # deleting default mgmt route to Internet
+  - route delete -net 0.0.0.0/0 gw 172.21.251.254
+  # adding specific ETSI HIVE mgmt segments through mgmt network
+  - route add -net 10.100.0.0/16 gw 172.21.251.254 
+  - route add -net 10.101.0.0/16 172.21.251.254
+  - route add -net 172.21.0.0/16 gw 172.21.251.254
+  - route add -net 172.22.0.0/16 gw 172.21.251.254
+  - route add -net 192.168.170.0/24 gw 172.21.251.254
+  # adding specific ORCH_IP through mgmt network
+  - route add -host {{ orch_ip }}/32 gw 172.21.251.254
+  # adding new default route to VyOS PNF
+  - route add -net 0.0.0.0/0 gw 192.168.239.7
+  # adding new specific routes to reach MetalLB ranges (Squid and other svcs) through VyOS PNF
+  - route add -net 172.21.250.0/24 gw 192.168.239.7
+  - route add -net 172.21.251.0/24 gw 192.168.239.7
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/srslte_init b/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/srslte_init
new file mode 100644
index 0000000000000000000000000000000000000000..1646c7c567a9fa092e63df6ef95168aef22889fc
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/cloud_init/srslte_init
@@ -0,0 +1,11 @@
+#cloud-config
+password: osm2020
+chpasswd: { expire: False }
+ssh_pwauth: True
+packages:
+  - net-tools
+runcmd:
+  - route add -net 10.0.0.0/8 gw 172.21.251.254 
+  - route add -net 172.21.0.0/16 gw 172.21.251.254
+  - route add -net 172.22.0.0/16 gw 172.21.251.254
+  - route add -net 192.168.170.0/24 gw 172.21.251.254
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/.helmignore b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/.helmignore
new file mode 100644
index 0000000000000000000000000000000000000000..50af0317254197a5a019f4ac2f8ecc223f93f5a7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/.helmignore
@@ -0,0 +1,22 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/Chart.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/Chart.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..414c5f1aa1becbd34d69342874b63db8bb1cb77c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/Chart.yaml
@@ -0,0 +1,5 @@
+apiVersion: v1
+appVersion: "1.0"
+description: OSM EE helm chart
+name: eechart
+version: 0.1.0
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/.helmignore b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/.helmignore
new file mode 100644
index 0000000000000000000000000000000000000000..691fa13d6a54c577aca389fe34f4d9e237824a12
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/.helmignore
@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/Chart.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/Chart.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..374dd55b6c3794be6883e479f49054c1e9368344
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/Chart.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+appVersion: 1.0.0
+description: SNMP Exporter for OSM VNF
+name: snmpexporter
+type: application
+version: 1.0.0
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/generator.yml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/generator.yml
new file mode 100644
index 0000000000000000000000000000000000000000..18c862ce7e24173db3899c2a5b05651ceb1fb001
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/generator.yml
@@ -0,0 +1,14 @@
+modules:
+  osm-snmp:
+    walk: [interfaces]
+    lookups:
+      - source_indexes: [ifIndex]
+        lookup: ifAlias
+      - source_indexes: [ifIndex]
+        lookup: ifDescr
+      - source_indexes: [ifIndex]
+        # Use OID to avoid conflict with Netscaler NS-ROOT-MIB.
+        lookup: 1.3.6.1.2.1.31.1.1.1.1 # ifName
+    auth:
+      # Community string is used with SNMP v1 and v2. Defaults to "public".
+      community: public
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IANAifType-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IANAifType-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..df59fa918c37b24cd0e8eb3a450a6ed32d010cd2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IANAifType-MIB.txt
@@ -0,0 +1,638 @@
+   IANAifType-MIB DEFINITIONS ::= BEGIN
+
+   IMPORTS
+       MODULE-IDENTITY, mib-2      FROM SNMPv2-SMI
+       TEXTUAL-CONVENTION          FROM SNMPv2-TC;
+
+   ianaifType MODULE-IDENTITY
+       LAST-UPDATED "201205170000Z"  -- May 17, 2012
+       ORGANIZATION "IANA"
+       CONTACT-INFO "        Internet Assigned Numbers Authority
+
+                     Postal: ICANN
+                             4676 Admiralty Way, Suite 330
+                             Marina del Rey, CA 90292
+
+                     Tel:    +1 310 823 9358
+                     E-Mail: iana&iana.org"
+       DESCRIPTION  "This MIB module defines the IANAifType Textual
+                     Convention, and thus the enumerated values of
+                     the ifType object defined in MIB-II's ifTable."
+
+       REVISION     "201205170000Z"  -- May 17, 2012
+       DESCRIPTION  "Registration of new IANAifType 272."
+
+       REVISION     "201201110000Z"  -- January 11, 2012
+       DESCRIPTION  "Registration of new IANAifTypes 266-271."
+
+       REVISION     "201112180000Z"  -- December 18, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 263-265."
+
+       REVISION     "201110260000Z"  -- October 26, 2011
+       DESCRIPTION  "Registration of new IANAifType 262."
+
+       REVISION     "201109070000Z"  -- September 7, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 260 and 261."
+
+       REVISION     "201107220000Z"  -- July 22, 2011
+       DESCRIPTION  "Registration of new IANAifType 259."
+
+       REVISION     "201106030000Z"  -- June 03, 2011
+       DESCRIPTION  "Registration of new IANAifType 258."
+
+       REVISION     "201009210000Z"  -- September 21, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 256 and 257."
+
+       REVISION     "201007210000Z"  -- July 21, 2010
+       DESCRIPTION  "Registration of new IANAifType 255."
+
+       REVISION     "201002110000Z"  -- February 11, 2010
+       DESCRIPTION  "Registration of new IANAifType 254."
+
+       REVISION     "201002080000Z"  -- February 08, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 252 and 253."
+
+       REVISION     "200905060000Z"  -- May 06, 2009
+       DESCRIPTION  "Registration of new IANAifType 251."
+
+       REVISION     "200902060000Z"  -- February 06, 2009
+       DESCRIPTION  "Registration of new IANAtunnelType 15."
+
+       REVISION     "200810090000Z"  -- October 09, 2008
+       DESCRIPTION  "Registration of new IANAifType 250."
+
+       REVISION     "200808120000Z"  -- August 12, 2008
+       DESCRIPTION  "Registration of new IANAifType 249."
+
+       REVISION     "200807220000Z"  -- July 22, 2008
+       DESCRIPTION  "Registration of new IANAifTypes 247 and 248."
+
+       REVISION     "200806240000Z"  -- June 24, 2008
+       DESCRIPTION  "Registration of new IANAifType 246."
+
+       REVISION     "200805290000Z"  -- May 29, 2008
+       DESCRIPTION  "Registration of new IANAifType 245."
+
+       REVISION     "200709130000Z"  -- September 13, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 243 and 244."
+
+       REVISION     "200705290000Z"  -- May 29, 2007
+       DESCRIPTION  "Changed the description for IANAifType 228."
+
+       REVISION     "200703080000Z"  -- March 08, 2007
+       DESCRIPTION  "Registration of new IANAifType 242."
+
+       REVISION     "200701230000Z"  -- January 23, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 239, 240, and 241." 
+
+       REVISION     "200610170000Z"  -- October 17, 2006
+       DESCRIPTION  "Deprecated/Obsoleted IANAifType 230.  Registration of 
+                     IANAifType 238." 
+
+       REVISION     "200609250000Z"  -- September 25, 2006
+       DESCRIPTION  "Changed the description for IANA ifType 
+                     184 and added new IANA ifType 237."  
+
+       REVISION     "200608170000Z"  -- August 17, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     20 and 21."   
+
+       REVISION     "200608110000Z"  -- August 11, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     7, 11, 62, 69, and 117."   
+
+       REVISION     "200607250000Z"  -- July 25, 2006
+       DESCRIPTION  "Registration of new IANA ifType 236."
+
+       REVISION     "200606140000Z"  -- June 14, 2006
+       DESCRIPTION  "Registration of new IANA ifType 235."
+
+       REVISION     "200603310000Z"  -- March 31, 2006
+       DESCRIPTION  "Registration of new IANA ifType 234."
+
+       REVISION     "200603300000Z"  -- March 30, 2006
+       DESCRIPTION  "Registration of new IANA ifType 233."
+
+       REVISION     "200512220000Z"  -- December 22, 2005
+       DESCRIPTION  "Registration of new IANA ifTypes 231 and 232."
+
+       REVISION     "200510100000Z"  -- October 10, 2005
+       DESCRIPTION  "Registration of new IANA ifType 230."
+
+       REVISION     "200509090000Z"  -- September 09, 2005
+       DESCRIPTION  "Registration of new IANA ifType 229."
+
+       REVISION     "200505270000Z"  -- May 27, 2005
+       DESCRIPTION  "Registration of new IANA ifType 228."
+
+       REVISION     "200503030000Z"  -- March 3, 2005
+       DESCRIPTION  "Added the IANAtunnelType TC and deprecated
+	                 IANAifType sixToFour (215) per RFC4087."
+
+       REVISION     "200411220000Z"  -- November 22, 2004
+       DESCRIPTION  "Registration of new IANA ifType 227 per RFC4631."
+
+       REVISION     "200406170000Z"  -- June 17, 2004
+       DESCRIPTION  "Registration of new IANA ifType 226."
+
+       REVISION     "200405120000Z"  -- May 12, 2004
+       DESCRIPTION  "Added description for IANAifType 6, and 
+	                 changed the descriptions for IANAifTypes
+                     180, 181, and 182."
+
+       REVISION     "200405070000Z"  -- May 7, 2004
+       DESCRIPTION  "Registration of new IANAifType 225."
+
+       REVISION     "200308250000Z"  -- Aug 25, 2003
+       DESCRIPTION  "Deprecated IANAifTypes 7 and 11. Obsoleted
+                     IANAifTypes 62, 69, and 117.  ethernetCsmacd (6)
+                     should be used instead of these values"
+
+       REVISION     "200308180000Z"  -- Aug 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     224."
+
+       REVISION     "200308070000Z"  -- Aug 7, 2003
+       DESCRIPTION  "Registration of new IANAifTypes
+                     222 and 223."
+
+       REVISION     "200303180000Z"  -- Mar 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     221."
+
+       REVISION     "200301130000Z"  -- Jan 13, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     220."
+
+       REVISION     "200210170000Z"  -- Oct 17, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     219."
+
+       REVISION     "200207160000Z"  -- Jul 16, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     217 and 218."
+
+       REVISION     "200207100000Z"  -- Jul 10, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     215 and 216."
+
+       REVISION     "200206190000Z"  -- Jun 19, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     214."
+
+       REVISION     "200201040000Z"  -- Jan 4, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     211, 212 and 213."
+
+       REVISION     "200112200000Z"  -- Dec 20, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     209 and 210."
+
+       REVISION     "200111150000Z"  -- Nov 15, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     207 and 208."
+
+       REVISION     "200111060000Z"  -- Nov 6, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     206."
+
+       REVISION     "200111020000Z"  -- Nov 2, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     205."
+
+       REVISION     "200110160000Z"  -- Oct 16, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     199, 200, 201, 202, 203, and 204."
+
+       REVISION     "200109190000Z"  -- Sept 19, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     198."
+
+       REVISION     "200105110000Z"  -- May 11, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     197."
+
+       REVISION     "200101120000Z"  -- Jan 12, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     195 and 196."
+
+       REVISION     "200012190000Z"  -- Dec 19, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     193 and 194."
+
+       REVISION     "200012070000Z"  -- Dec 07, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     191 and 192."
+
+       REVISION     "200012040000Z"  -- Dec 04, 2000
+       DESCRIPTION  "Registration of new IANAifType
+                     190."
+
+       REVISION     "200010170000Z"  -- Oct 17, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     188 and 189."  
+
+       REVISION     "200010020000Z"  -- Oct 02, 2000
+       DESCRIPTION  "Registration of new IANAifType 187." 
+
+       REVISION     "200009010000Z"  -- Sept 01, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     184, 185, and 186."			
+
+       REVISION     "200008240000Z"  -- Aug 24, 2000
+       DESCRIPTION  "Registration of new IANAifType 183." 
+
+       REVISION     "200008230000Z"  -- Aug 23, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     174-182."
+
+       REVISION     "200008220000Z"  -- Aug 22, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 170,
+                     171, 172 and 173."
+
+       REVISION     "200004250000Z"  -- Apr 25, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 168 and 169."       
+
+       REVISION     "200003060000Z"  -- Mar 6, 2000
+       DESCRIPTION  "Fixed a missing semi-colon in the IMPORT.
+                     Also cleaned up the REVISION log a bit.
+                     It is not complete, but from now on it will
+                     be maintained and kept up to date with each
+                     change to this MIB module."
+
+       REVISION     "199910081430Z"  -- Oct 08, 1999
+       DESCRIPTION  "Include new name assignments up to cnr(85).
+                     This is the first version available via the WWW
+                     at: ftp://ftp.isi.edu/mib/ianaiftype.mib"
+
+       REVISION     "199401310000Z"  -- Jan 31, 1994
+       DESCRIPTION  "Initial version of this MIB as published in
+                     RFC 1573."
+       ::= { mib-2 30 }
+
+   IANAifType ::= TEXTUAL-CONVENTION
+       STATUS       current
+       DESCRIPTION
+               "This data type is used as the syntax of the ifType
+               object in the (updated) definition of MIB-II's
+               ifTable.
+
+               The definition of this textual convention with the
+               addition of newly assigned values is published
+               periodically by the IANA, in either the Assigned
+               Numbers RFC, or some derivative of it specific to
+               Internet Network Management number assignments.  (The
+               latest arrangements can be obtained by contacting the
+               IANA.)
+
+               Requests for new values should be made to IANA via
+               email (iana&iana.org).
+
+               The relationship between the assignment of ifType
+               values and of OIDs to particular media-specific MIBs
+               is solely the purview of IANA and is subject to change
+               without notice.  Quite often, a media-specific MIB's
+               OID-subtree assignment within MIB-II's 'transmission'
+               subtree will be the same as its ifType value.
+               However, in some circumstances this will not be the
+               case, and implementors must not pre-assume any
+               specific relationship between ifType values and
+               transmission subtree OIDs."
+       SYNTAX  INTEGER {
+                   other(1),          -- none of the following
+                   regular1822(2),
+                   hdh1822(3),
+                   ddnX25(4),
+                   rfc877x25(5),
+                   ethernetCsmacd(6), -- for all ethernet-like interfaces,
+                                      -- regardless of speed, as per RFC3635
+                   iso88023Csmacd(7), -- Deprecated via RFC3635
+                                      -- ethernetCsmacd (6) should be used instead
+                   iso88024TokenBus(8),
+                   iso88025TokenRing(9),
+                   iso88026Man(10),
+                   starLan(11), -- Deprecated via RFC3635
+                                -- ethernetCsmacd (6) should be used instead
+                   proteon10Mbit(12),
+                   proteon80Mbit(13),
+                   hyperchannel(14),
+                   fddi(15),
+                   lapb(16),
+                   sdlc(17),
+                   ds1(18),            -- DS1-MIB
+                   e1(19),             -- Obsolete see DS1-MIB
+                   basicISDN(20),              -- no longer used
+                                               -- see also RFC2127
+                   primaryISDN(21),            -- no longer used
+                                               -- see also RFC2127
+                   propPointToPointSerial(22), -- proprietary serial
+                   ppp(23),
+                   softwareLoopback(24),
+                   eon(25),            -- CLNP over IP 
+                   ethernet3Mbit(26),
+                   nsip(27),           -- XNS over IP
+                   slip(28),           -- generic SLIP
+                   ultra(29),          -- ULTRA technologies
+                   ds3(30),            -- DS3-MIB
+                   sip(31),            -- SMDS, coffee
+                   frameRelay(32),     -- DTE only. 
+                   rs232(33),
+                   para(34),           -- parallel-port
+                   arcnet(35),         -- arcnet
+                   arcnetPlus(36),     -- arcnet plus
+                   atm(37),            -- ATM cells
+                   miox25(38),
+                   sonet(39),          -- SONET or SDH 
+                   x25ple(40),
+                   iso88022llc(41),
+                   localTalk(42),
+                   smdsDxi(43),
+                   frameRelayService(44),  -- FRNETSERV-MIB
+                   v35(45),
+                   hssi(46),
+                   hippi(47),
+                   modem(48),          -- Generic modem
+                   aal5(49),           -- AAL5 over ATM
+                   sonetPath(50),
+                   sonetVT(51),
+                   smdsIcip(52),       -- SMDS InterCarrier Interface
+                   propVirtual(53),    -- proprietary virtual/internal
+                   propMultiplexor(54),-- proprietary multiplexing
+                   ieee80212(55),      -- 100BaseVG
+                   fibreChannel(56),   -- Fibre Channel
+                   hippiInterface(57), -- HIPPI interfaces     
+                   frameRelayInterconnect(58), -- Obsolete, use either
+                                       -- frameRelay(32) or 
+                                       -- frameRelayService(44).
+                   aflane8023(59),     -- ATM Emulated LAN for 802.3
+                   aflane8025(60),     -- ATM Emulated LAN for 802.5
+                   cctEmul(61),        -- ATM Emulated circuit          
+                   fastEther(62),      -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   isdn(63),           -- ISDN and X.25           
+                   v11(64),            -- CCITT V.11/X.21             
+                   v36(65),            -- CCITT V.36                  
+                   g703at64k(66),      -- CCITT G703 at 64Kbps
+                   g703at2mb(67),      -- Obsolete see DS1-MIB
+                   qllc(68),           -- SNA QLLC                    
+                   fastEtherFX(69),    -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   channel(70),        -- channel                     
+                   ieee80211(71),      -- radio spread spectrum       
+                   ibm370parChan(72),  -- IBM System 360/370 OEMI Channel
+                   escon(73),          -- IBM Enterprise Systems Connection
+                   dlsw(74),           -- Data Link Switching
+                   isdns(75),          -- ISDN S/T interface
+                   isdnu(76),          -- ISDN U interface
+                   lapd(77),           -- Link Access Protocol D
+                   ipSwitch(78),       -- IP Switching Objects
+                   rsrb(79),           -- Remote Source Route Bridging
+                   atmLogical(80),     -- ATM Logical Port
+                   ds0(81),            -- Digital Signal Level 0
+                   ds0Bundle(82),      -- group of ds0s on the same ds1
+                   bsc(83),            -- Bisynchronous Protocol
+                   async(84),          -- Asynchronous Protocol
+                   cnr(85),            -- Combat Net Radio
+                   iso88025Dtr(86),    -- ISO 802.5r DTR
+                   eplrs(87),          -- Ext Pos Loc Report Sys
+                   arap(88),           -- Appletalk Remote Access Protocol
+                   propCnls(89),       -- Proprietary Connectionless Protocol
+                   hostPad(90),        -- CCITT-ITU X.29 PAD Protocol
+                   termPad(91),        -- CCITT-ITU X.3 PAD Facility
+                   frameRelayMPI(92),  -- Multiproto Interconnect over FR
+                   x213(93),           -- CCITT-ITU X213
+                   adsl(94),           -- Asymmetric Digital Subscriber Loop
+                   radsl(95),          -- Rate-Adapt. Digital Subscriber Loop
+                   sdsl(96),           -- Symmetric Digital Subscriber Loop
+                   vdsl(97),           -- Very H-Speed Digital Subscrib. Loop
+                   iso88025CRFPInt(98), -- ISO 802.5 CRFP
+                   myrinet(99),        -- Myricom Myrinet
+                   voiceEM(100),       -- voice recEive and transMit
+                   voiceFXO(101),      -- voice Foreign Exchange Office
+                   voiceFXS(102),      -- voice Foreign Exchange Station
+                   voiceEncap(103),    -- voice encapsulation
+                   voiceOverIp(104),   -- voice over IP encapsulation
+                   atmDxi(105),        -- ATM DXI
+                   atmFuni(106),       -- ATM FUNI
+                   atmIma (107),       -- ATM IMA		   
+                   pppMultilinkBundle(108), -- PPP Multilink Bundle
+                   ipOverCdlc (109),   -- IBM ipOverCdlc
+                   ipOverClaw (110),   -- IBM Common Link Access to Workstn
+                   stackToStack (111), -- IBM stackToStack
+                   virtualIpAddress (112), -- IBM VIPA
+                   mpc (113),          -- IBM multi-protocol channel support
+                   ipOverAtm (114),    -- IBM ipOverAtm
+                   iso88025Fiber (115), -- ISO 802.5j Fiber Token Ring
+                   tdlc (116),	       -- IBM twinaxial data link control
+                   gigabitEthernet (117), -- Obsoleted via RFC3635
+                                          -- ethernetCsmacd (6) should be used instead
+                   hdlc (118),         -- HDLC
+                   lapf (119),	       -- LAP F
+                   v37 (120),	       -- V.37
+                   x25mlp (121),       -- Multi-Link Protocol
+                   x25huntGroup (122), -- X25 Hunt Group
+                   transpHdlc (123),   -- Transp HDLC
+                   interleave (124),   -- Interleave channel
+                   fast (125),         -- Fast channel
+                   ip (126),	       -- IP (for APPN HPR in IP networks)
+                   docsCableMaclayer (127),  -- CATV Mac Layer
+                   docsCableDownstream (128), -- CATV Downstream interface
+                   docsCableUpstream (129),  -- CATV Upstream interface
+                   a12MppSwitch (130), -- Avalon Parallel Processor
+                   tunnel (131),       -- Encapsulation interface
+                   coffee (132),       -- coffee pot
+                   ces (133),          -- Circuit Emulation Service
+                   atmSubInterface (134), -- ATM Sub Interface
+                   l2vlan (135),       -- Layer 2 Virtual LAN using 802.1Q
+                   l3ipvlan (136),     -- Layer 3 Virtual LAN using IP
+                   l3ipxvlan (137),    -- Layer 3 Virtual LAN using IPX
+                   digitalPowerline (138), -- IP over Power Lines	
+                   mediaMailOverIp (139), -- Multimedia Mail over IP
+                   dtm (140),        -- Dynamic syncronous Transfer Mode
+                   dcn (141),    -- Data Communications Network
+                   ipForward (142),    -- IP Forwarding Interface
+                   msdsl (143),       -- Multi-rate Symmetric DSL
+                   ieee1394 (144), -- IEEE1394 High Performance Serial Bus
+                   if-gsn (145),       --   HIPPI-6400 
+                   dvbRccMacLayer (146), -- DVB-RCC MAC Layer
+                   dvbRccDownstream (147),  -- DVB-RCC Downstream Channel
+                   dvbRccUpstream (148),  -- DVB-RCC Upstream Channel
+                   atmVirtual (149),   -- ATM Virtual Interface
+                   mplsTunnel (150),   -- MPLS Tunnel Virtual Interface
+                   srp (151),	-- Spatial Reuse Protocol	
+                   voiceOverAtm (152),  -- Voice Over ATM
+                   voiceOverFrameRelay (153),   -- Voice Over Frame Relay 
+                   idsl (154),		-- Digital Subscriber Loop over ISDN
+                   compositeLink (155),  -- Avici Composite Link Interface
+                   ss7SigLink (156),     -- SS7 Signaling Link 
+                   propWirelessP2P (157),  --  Prop. P2P wireless interface
+                   frForward (158),    -- Frame Forward Interface
+                   rfc1483 (159),	-- Multiprotocol over ATM AAL5
+                   usb (160),		-- USB Interface
+                   ieee8023adLag (161),  -- IEEE 802.3ad Link Aggregate
+                   bgppolicyaccounting (162), -- BGP Policy Accounting
+                   frf16MfrBundle (163), -- FRF .16 Multilink Frame Relay 
+                   h323Gatekeeper (164), -- H323 Gatekeeper
+                   h323Proxy (165), -- H323 Voice and Video Proxy
+                   mpls (166), -- MPLS                   
+                   mfSigLink (167), -- Multi-frequency signaling link
+                   hdsl2 (168), -- High Bit-Rate DSL - 2nd generation
+                   shdsl (169), -- Multirate HDSL2
+                   ds1FDL (170), -- Facility Data Link 4Kbps on a DS1
+                   pos (171), -- Packet over SONET/SDH Interface
+                   dvbAsiIn (172), -- DVB-ASI Input
+                   dvbAsiOut (173), -- DVB-ASI Output 
+                   plc (174), -- Power Line Communtications
+                   nfas (175), -- Non Facility Associated Signaling
+                   tr008 (176), -- TR008
+                   gr303RDT (177), -- Remote Digital Terminal
+                   gr303IDT (178), -- Integrated Digital Terminal
+                   isup (179), -- ISUP
+                   propDocsWirelessMaclayer (180), -- Cisco proprietary Maclayer
+                   propDocsWirelessDownstream (181), -- Cisco proprietary Downstream
+                   propDocsWirelessUpstream (182), -- Cisco proprietary Upstream
+                   hiperlan2 (183), -- HIPERLAN Type 2 Radio Interface
+                   propBWAp2Mp (184), -- PropBroadbandWirelessAccesspt2multipt
+                             -- use of this iftype for IEEE 802.16 WMAN
+                             -- interfaces as per IEEE Std 802.16f is
+                             -- deprecated and ifType 237 should be used instead.
+                   sonetOverheadChannel (185), -- SONET Overhead Channel
+                   digitalWrapperOverheadChannel (186), -- Digital Wrapper
+                   aal2 (187), -- ATM adaptation layer 2
+                   radioMAC (188), -- MAC layer over radio links
+                   atmRadio (189), -- ATM over radio links   
+                   imt (190), -- Inter Machine Trunks
+                   mvl (191), -- Multiple Virtual Lines DSL
+                   reachDSL (192), -- Long Reach DSL
+                   frDlciEndPt (193), -- Frame Relay DLCI End Point
+                   atmVciEndPt (194), -- ATM VCI End Point
+                   opticalChannel (195), -- Optical Channel
+                   opticalTransport (196), -- Optical Transport
+                   propAtm (197), --  Proprietary ATM       
+                   voiceOverCable (198), -- Voice Over Cable Interface
+                   infiniband (199), -- Infiniband
+                   teLink (200), -- TE Link
+                   q2931 (201), -- Q.2931
+                   virtualTg (202), -- Virtual Trunk Group
+                   sipTg (203), -- SIP Trunk Group
+                   sipSig (204), -- SIP Signaling   
+                   docsCableUpstreamChannel (205), -- CATV Upstream Channel
+                   econet (206), -- Acorn Econet
+                   pon155 (207), -- FSAN 155Mb Symetrical PON interface
+                   pon622 (208), -- FSAN622Mb Symetrical PON interface
+                   bridge (209), -- Transparent bridge interface
+                   linegroup (210), -- Interface common to multiple lines   
+                   voiceEMFGD (211), -- voice E&M Feature Group D
+                   voiceFGDEANA (212), -- voice FGD Exchange Access North American
+                   voiceDID (213), -- voice Direct Inward Dialing
+                   mpegTransport (214), -- MPEG transport interface
+                   sixToFour (215), -- 6to4 interface (DEPRECATED)
+                   gtp (216), -- GTP (GPRS Tunneling Protocol)
+                   pdnEtherLoop1 (217), -- Paradyne EtherLoop 1
+                   pdnEtherLoop2 (218), -- Paradyne EtherLoop 2
+                   opticalChannelGroup (219), -- Optical Channel Group
+                   homepna (220), -- HomePNA ITU-T G.989
+                   gfp (221), -- Generic Framing Procedure (GFP)
+                   ciscoISLvlan (222), -- Layer 2 Virtual LAN using Cisco ISL
+                   actelisMetaLOOP (223), -- Acteleis proprietary MetaLOOP High Speed Link 
+                   fcipLink (224), -- FCIP Link 
+                   rpr (225), -- Resilient Packet Ring Interface Type
+                   qam (226), -- RF Qam Interface
+                   lmp (227), -- Link Management Protocol
+                   cblVectaStar (228), -- Cambridge Broadband Networks Limited VectaStar
+                   docsCableMCmtsDownstream (229), -- CATV Modular CMTS Downstream Interface
+                   adsl2 (230), -- Asymmetric Digital Subscriber Loop Version 2 
+                                -- (DEPRECATED/OBSOLETED - please use adsl2plus 238 instead)
+                   macSecControlledIF (231), -- MACSecControlled 
+                   macSecUncontrolledIF (232), -- MACSecUncontrolled
+                   aviciOpticalEther (233), -- Avici Optical Ethernet Aggregate
+                   atmbond (234), -- atmbond
+                   voiceFGDOS (235), -- voice FGD Operator Services
+                   mocaVersion1 (236), -- MultiMedia over Coax Alliance (MoCA) Interface
+                             -- as documented in information provided privately to IANA
+                   ieee80216WMAN (237), -- IEEE 802.16 WMAN interface
+                   adsl2plus (238), -- Asymmetric Digital Subscriber Loop Version 2, 
+                                   -- Version 2 Plus and all variants
+                   dvbRcsMacLayer (239), -- DVB-RCS MAC Layer
+                   dvbTdm (240), -- DVB Satellite TDM
+                   dvbRcsTdma (241), -- DVB-RCS TDMA
+                   x86Laps (242), -- LAPS based on ITU-T X.86/Y.1323
+                   wwanPP (243), -- 3GPP WWAN
+                   wwanPP2 (244), -- 3GPP2 WWAN
+                   voiceEBS (245), -- voice P-phone EBS physical interface
+                   ifPwType (246), -- Pseudowire interface type
+                   ilan (247), -- Internal LAN on a bridge per IEEE 802.1ap
+                   pip (248), -- Provider Instance Port on a bridge per IEEE 802.1ah PBB
+                   aluELP (249), -- Alcatel-Lucent Ethernet Link Protection
+                   gpon (250), -- Gigabit-capable passive optical networks (G-PON) as per ITU-T G.948
+                   vdsl2 (251), -- Very high speed digital subscriber line Version 2 (as per ITU-T Recommendation G.993.2)
+                   capwapDot11Profile (252), -- WLAN Profile Interface
+                   capwapDot11Bss (253), -- WLAN BSS Interface
+                   capwapWtpVirtualRadio (254), -- WTP Virtual Radio Interface
+                   bits (255), -- bitsport
+                   docsCableUpstreamRfPort (256), -- DOCSIS CATV Upstream RF Port
+                   cableDownstreamRfPort (257), -- CATV downstream RF port
+                   vmwareVirtualNic (258), -- VMware Virtual Network Interface
+                   ieee802154 (259), -- IEEE 802.15.4 WPAN interface
+                   otnOdu (260), -- OTN Optical Data Unit
+                   otnOtu (261), -- OTN Optical channel Transport Unit
+                   ifVfiType (262), -- VPLS Forwarding Instance Interface Type
+                   g9981 (263), -- G.998.1 bonded interface
+                   g9982 (264), -- G.998.2 bonded interface
+                   g9983 (265), -- G.998.3 bonded interface
+                   aluEpon (266), -- Ethernet Passive Optical Networks (E-PON)
+                   aluEponOnu (267), -- EPON Optical Network Unit
+                   aluEponPhysicalUni (268), -- EPON physical User to Network interface
+                   aluEponLogicalLink (269), -- The emulation of a point-to-point link over the EPON layer
+                   aluGponOnu (270), -- GPON Optical Network Unit
+                   aluGponPhysicalUni (271), -- GPON physical User to Network interface
+                   vmwareNicTeam (272) -- VMware NIC Team
+                   }
+
+IANAtunnelType ::= TEXTUAL-CONVENTION
+    STATUS     current
+    DESCRIPTION
+            "The encapsulation method used by a tunnel. The value
+            direct indicates that a packet is encapsulated
+            directly within a normal IP header, with no
+            intermediate header, and unicast to the remote tunnel
+            endpoint (e.g., an RFC 2003 IP-in-IP tunnel, or an RFC
+            1933 IPv6-in-IPv4 tunnel). The value minimal indicates
+            that a Minimal Forwarding Header (RFC 2004) is
+            inserted between the outer header and the payload
+            packet. The value UDP indicates that the payload
+            packet is encapsulated within a normal UDP packet
+            (e.g., RFC 1234).
+
+            The values sixToFour, sixOverFour, and isatap
+            indicates that an IPv6 packet is encapsulated directly
+            within an IPv4 header, with no intermediate header,
+            and unicast to the destination determined by the 6to4,
+            6over4, or ISATAP protocol.
+
+            The remaining protocol-specific values indicate that a
+            header of the protocol of that name is inserted
+            between the outer header and the payload header.
+
+            The assignment policy for IANAtunnelType values is
+            identical to the policy for assigning IANAifType
+            values."
+    SYNTAX     INTEGER {
+                   other(1),        -- none of the following
+                   direct(2),       -- no intermediate header
+                   gre(3),          -- GRE encapsulation
+                   minimal(4),      -- Minimal encapsulation
+                   l2tp(5),         -- L2TP encapsulation
+                   pptp(6),         -- PPTP encapsulation
+                   l2f(7),          -- L2F encapsulation
+                   udp(8),          -- UDP encapsulation
+                   atmp(9),         -- ATMP encapsulation
+                   msdp(10),        -- MSDP encapsulation
+                   sixToFour(11),   -- 6to4 encapsulation
+                   sixOverFour(12), -- 6over4 encapsulation
+                   isatap(13),      -- ISATAP encapsulation
+                   teredo(14),      -- Teredo encapsulation
+                   ipHttps(15)      -- IPHTTPS
+               }
+
+   END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IF-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IF-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7704f0c257ec0769badc84b0591c06c893e7b001
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/IF-MIB.txt
@@ -0,0 +1,1814 @@
+IF-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64,
+    Integer32, TimeTicks, mib-2,
+    NOTIFICATION-TYPE                        FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION, DisplayString,
+    PhysAddress, TruthValue, RowStatus,
+    TimeStamp, AutonomousType, TestAndIncr   FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP,
+    NOTIFICATION-GROUP                       FROM SNMPv2-CONF
+    snmpTraps                                FROM SNMPv2-MIB
+    IANAifType                               FROM IANAifType-MIB;
+
+ifMIB MODULE-IDENTITY
+    LAST-UPDATED "200006140000Z"
+    ORGANIZATION "IETF Interfaces MIB Working Group"
+    CONTACT-INFO
+            "   Keith McCloghrie
+                Cisco Systems, Inc.
+                170 West Tasman Drive
+                San Jose, CA  95134-1706
+                US
+
+                408-526-5260
+                kzm@cisco.com"
+    DESCRIPTION
+            "The MIB module to describe generic objects for network
+            interface sub-layers.  This MIB is an updated version of
+            MIB-II's ifTable, and incorporates the extensions defined in
+            RFC 1229."
+
+    REVISION      "200006140000Z"
+    DESCRIPTION
+            "Clarifications agreed upon by the Interfaces MIB WG, and
+            published as RFC 2863."
+    REVISION      "199602282155Z"
+    DESCRIPTION
+            "Revisions made by the Interfaces MIB WG, and published in
+            RFC 2233."
+    REVISION      "199311082155Z"
+    DESCRIPTION
+            "Initial revision, published as part of RFC 1573."
+    ::= { mib-2 31 }
+
+ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
+
+interfaces   OBJECT IDENTIFIER ::= { mib-2 2 }
+
+--
+-- Textual Conventions
+--
+
+-- OwnerString has the same semantics as used in RFC 1271
+
+OwnerString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       deprecated
+    DESCRIPTION
+            "This data type is used to model an administratively
+            assigned name of the owner of a resource.  This information
+            is taken from the NVT ASCII character set.  It is suggested
+            that this name contain one or more of the following: ASCII
+            form of the manager station's transport address, management
+            station name (e.g., domain name), network management
+            personnel's name, location, or phone number.  In some cases
+            the agent itself will be the owner of an entry.  In these
+            cases, this string shall be set to a string starting with
+            'agent'."
+    SYNTAX       OCTET STRING (SIZE(0..255))
+
+-- InterfaceIndex contains the semantics of ifIndex and should be used
+-- for any objects defined in other MIB modules that need these semantics.
+
+InterfaceIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface or
+            interface sub-layer in the managed system.  It is
+            recommended that values are assigned contiguously starting
+            from 1.  The value for each interface sub-layer must remain
+            constant at least from one re-initialization of the entity's
+            network management system to the next re-initialization."
+    SYNTAX       Integer32 (1..2147483647)
+
+InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "This textual convention is an extension of the
+            InterfaceIndex convention.  The latter defines a greater
+            than zero value used to identify an interface or interface
+            sub-layer in the managed system.  This extension permits the
+            additional value of zero.  the value zero is object-specific
+            and must therefore be defined as part of the description of
+            any object which uses this syntax.  Examples of the usage of
+            zero might include situations where interface was unknown,
+            or when none or all interfaces need to be referenced."
+    SYNTAX       Integer32 (0..2147483647)
+
+ifNumber  OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of network interfaces (regardless of their
+            current state) present on this system."
+    ::= { interfaces 1 }
+
+ifTableLastChange  OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last creation or
+            deletion of an entry in the ifTable.  If the number of
+            entries has been unchanged since the last re-initialization
+            of the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 5 }
+
+-- the Interfaces table
+
+-- The Interfaces table contains information on the entity's
+
+-- interfaces.  Each sub-layer below the internetwork-layer
+-- of a network interface is considered to be an interface.
+
+ifTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber."
+    ::= { interfaces 2 }
+
+ifEntry OBJECT-TYPE
+    SYNTAX      IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing management information applicable to a
+            particular interface."
+    INDEX   { ifIndex }
+    ::= { ifTable 1 }
+
+IfEntry ::=
+    SEQUENCE {
+        ifIndex                 InterfaceIndex,
+        ifDescr                 DisplayString,
+        ifType                  IANAifType,
+        ifMtu                   Integer32,
+        ifSpeed                 Gauge32,
+        ifPhysAddress           PhysAddress,
+        ifAdminStatus           INTEGER,
+        ifOperStatus            INTEGER,
+        ifLastChange            TimeTicks,
+        ifInOctets              Counter32,
+        ifInUcastPkts           Counter32,
+        ifInNUcastPkts          Counter32,  -- deprecated
+        ifInDiscards            Counter32,
+        ifInErrors              Counter32,
+        ifInUnknownProtos       Counter32,
+        ifOutOctets             Counter32,
+        ifOutUcastPkts          Counter32,
+        ifOutNUcastPkts         Counter32,  -- deprecated
+        ifOutDiscards           Counter32,
+        ifOutErrors             Counter32,
+        ifOutQLen               Gauge32,    -- deprecated
+        ifSpecific              OBJECT IDENTIFIER -- deprecated
+    }
+
+ifIndex OBJECT-TYPE
+    SYNTAX      InterfaceIndex
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface.  It
+            is recommended that values are assigned contiguously
+            starting from 1.  The value for each interface sub-layer
+            must remain constant at least from one re-initialization of
+            the entity's network management system to the next re-
+            initialization."
+    ::= { ifEntry 1 }
+
+ifDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual string containing information about the
+            interface.  This string should include the name of the
+            manufacturer, the product name and the version of the
+            interface hardware/software."
+    ::= { ifEntry 2 }
+
+ifType OBJECT-TYPE
+    SYNTAX      IANAifType
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The type of interface.  Additional values for ifType are
+            assigned by the Internet Assigned Numbers Authority (IANA),
+            through updating the syntax of the IANAifType textual
+            convention."
+    ::= { ifEntry 3 }
+
+ifMtu OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The size of the largest packet which can be sent/received
+            on the interface, specified in octets.  For interfaces that
+            are used for transmitting network datagrams, this is the
+            size of the largest network datagram that can be sent on the
+            interface."
+    ::= { ifEntry 4 }
+
+ifSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in bits
+            per second.  For interfaces which do not vary in bandwidth
+            or for those where no accurate estimation can be made, this
+            object should contain the nominal bandwidth.  If the
+            bandwidth of the interface is greater than the maximum value
+            reportable by this object then this object should report its
+            maximum value (4,294,967,295) and ifHighSpeed must be used
+            to report the interace's speed.  For a sub-layer which has
+            no concept of bandwidth, this object should be zero."
+    ::= { ifEntry 5 }
+
+ifPhysAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The interface's address at its protocol sub-layer.  For
+            example, for an 802.x interface, this object normally
+            contains a MAC address.  The interface's media-specific MIB
+            must define the bit and byte ordering and the format of the
+            value of this object.  For interfaces which do not have such
+            an address (e.g., a serial line), this object should contain
+            an octet string of zero length."
+    ::= { ifEntry 6 }
+
+ifAdminStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),       -- ready to pass packets
+                down(2),
+                testing(3)   -- in some test mode
+            }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The desired state of the interface.  The testing(3) state
+            indicates that no operational packets can be passed.  When a
+            managed system initializes, all interfaces start with
+            ifAdminStatus in the down(2) state.  As a result of either
+            explicit management action or per configuration information
+            retained by the managed system, ifAdminStatus is then
+            changed to either the up(1) or testing(3) states (or remains
+            in the down(2) state)."
+    ::= { ifEntry 7 }
+
+ifOperStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),        -- ready to pass packets
+                down(2),
+                testing(3),   -- in some test mode
+                unknown(4),   -- status can not be determined
+                              -- for some reason.
+                dormant(5),
+                notPresent(6),    -- some component is missing
+                lowerLayerDown(7) -- down due to state of
+                                  -- lower-layer interface(s)
+            }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The current operational state of the interface.  The
+            testing(3) state indicates that no operational packets can
+            be passed.  If ifAdminStatus is down(2) then ifOperStatus
+            should be down(2).  If ifAdminStatus is changed to up(1)
+            then ifOperStatus should change to up(1) if the interface is
+            ready to transmit and receive network traffic; it should
+            change to dormant(5) if the interface is waiting for
+            external actions (such as a serial line waiting for an
+            incoming connection); it should remain in the down(2) state
+            if and only if there is a fault that prevents it from going
+            to the up(1) state; it should remain in the notPresent(6)
+            state if the interface has missing (typically, hardware)
+            components."
+    ::= { ifEntry 8 }
+
+ifLastChange OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time the interface entered
+            its current operational state.  If the current state was
+            entered prior to the last re-initialization of the local
+            network management subsystem, then this object contains a
+            zero value."
+    ::= { ifEntry 9 }
+
+ifInOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 10 }
+
+ifInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 11 }
+
+ifInNUcastPkts OBJECT-TYPE
+    SYNTAX  Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast or
+            broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifInMulticastPkts and
+            ifInBroadcastPkts."
+    ::= { ifEntry 12 }
+
+ifInDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of inbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+
+            their being deliverable to a higher-layer protocol.  One
+            possible reason for discarding such a packet could be to
+            free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 13 }
+
+ifInErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of inbound
+            packets that contained errors preventing them from being
+            deliverable to a higher-layer protocol.  For character-
+            oriented or fixed-length interfaces, the number of inbound
+            transmission units that contained errors preventing them
+            from being deliverable to a higher-layer protocol.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 14 }
+
+ifInUnknownProtos OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of packets
+            received via the interface which were discarded because of
+            an unknown or unsupported protocol.  For character-oriented
+            or fixed-length interfaces that support protocol
+            multiplexing the number of transmission units received via
+            the interface which were discarded because of an unknown or
+            unsupported protocol.  For any interface that does not
+            support protocol multiplexing, this counter will always be
+            0.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 15 }
+
+ifOutOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 16 }
+
+ifOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 17 }
+
+ifOutNUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifOutMulticastPkts
+            and ifOutBroadcastPkts."
+    ::= { ifEntry 18 }
+
+ifOutDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of outbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+            their being transmitted.  One possible reason for discarding
+            such a packet could be to free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 19 }
+
+ifOutErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of outbound
+            packets that could not be transmitted because of errors.
+            For character-oriented or fixed-length interfaces, the
+            number of outbound transmission units that could not be
+            transmitted because of errors.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 20 }
+
+ifOutQLen OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The length of the output packet queue (in packets)."
+    ::= { ifEntry 21 }
+
+ifSpecific OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "A reference to MIB definitions specific to the particular
+            media being used to realize the interface.  It is
+
+            recommended that this value point to an instance of a MIB
+            object in the media-specific MIB, i.e., that this object
+            have the semantics associated with the InstancePointer
+            textual convention defined in RFC 2579.  In fact, it is
+            recommended that the media-specific MIB specify what value
+            ifSpecific should/can take for values of ifType.  If no MIB
+            definitions specific to the particular media are available,
+            the value should be set to the OBJECT IDENTIFIER { 0 0 }."
+    ::= { ifEntry 22 }
+
+--
+--   Extension to the interface table
+--
+-- This table replaces the ifExtnsTable table.
+--
+
+ifXTable        OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber.  This table contains
+            additional objects for the interface table."
+    ::= { ifMIBObjects 1 }
+
+ifXEntry        OBJECT-TYPE
+    SYNTAX      IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing additional management information
+            applicable to a particular interface."
+    AUGMENTS    { ifEntry }
+    ::= { ifXTable 1 }
+
+IfXEntry ::=
+    SEQUENCE {
+        ifName                  DisplayString,
+        ifInMulticastPkts       Counter32,
+        ifInBroadcastPkts       Counter32,
+        ifOutMulticastPkts      Counter32,
+        ifOutBroadcastPkts      Counter32,
+        ifHCInOctets            Counter64,
+        ifHCInUcastPkts         Counter64,
+        ifHCInMulticastPkts     Counter64,
+        ifHCInBroadcastPkts     Counter64,
+        ifHCOutOctets           Counter64,
+        ifHCOutUcastPkts        Counter64,
+        ifHCOutMulticastPkts    Counter64,
+        ifHCOutBroadcastPkts    Counter64,
+        ifLinkUpDownTrapEnable  INTEGER,
+        ifHighSpeed             Gauge32,
+        ifPromiscuousMode       TruthValue,
+        ifConnectorPresent      TruthValue,
+        ifAlias                 DisplayString,
+        ifCounterDiscontinuityTime TimeStamp
+    }
+
+ifName OBJECT-TYPE
+    SYNTAX      DisplayString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The textual name of the interface.  The value of this
+            object should be the name of the interface as assigned by
+            the local device and should be suitable for use in commands
+            entered at the device's `console'.  This might be a text
+            name, such as `le0' or a simple port number, such as `1',
+            depending on the interface naming syntax of the device.  If
+            several entries in the ifTable together represent a single
+            interface as named by the device, then each will have the
+            same value of ifName.  Note that for an agent which responds
+            to SNMP queries concerning an interface on some other
+            (proxied) device, then the value of ifName for such an
+            interface is the proxied device's local name for it.
+
+            If there is no local name, or this object is otherwise not
+            applicable, then this object contains a zero-length string."
+    ::= { ifXEntry 1 }
+
+ifInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 2 }
+
+ifInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 3 }
+
+ifOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 4 }
+
+ifOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 5 }
+
+--
+-- High Capacity Counter objects.  These objects are all
+-- 64 bit versions of the "basic" ifTable counters.  These
+-- objects all have the same basic semantics as their 32-bit
+-- counterparts, however, their syntax has been extended
+-- to 64 bits.
+--
+
+ifHCInOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.  This object is a 64-bit
+            version of ifInOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 6 }
+
+ifHCInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.  This object is a
+            64-bit version of ifInUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 7 }
+
+ifHCInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifInMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 8 }
+
+ifHCInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.  This object is a 64-bit version
+            of ifInBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 9 }
+
+ifHCOutOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.  This object is a
+            64-bit version of ifOutOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 10 }
+
+ifHCOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.  This object is a
+            64-bit version of ifOutUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 11 }
+
+ifHCOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifOutMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 12 }
+
+ifHCOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.  This object is a 64-bit version
+            of ifOutBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 13 }
+
+ifLinkUpDownTrapEnable  OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether linkUp/linkDown traps should be generated
+            for this interface.
+
+            By default, this object should have the value enabled(1) for
+            interfaces which do not operate on 'top' of any other
+            interface (as defined in the ifStackTable), and disabled(2)
+            otherwise."
+    ::= { ifXEntry 14 }
+
+ifHighSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in units
+            of 1,000,000 bits per second.  If this object reports a
+            value of `n' then the speed of the interface is somewhere in
+            the range of `n-500,000' to `n+499,999'.  For interfaces
+            which do not vary in bandwidth or for those where no
+            accurate estimation can be made, this object should contain
+            the nominal bandwidth.  For a sub-layer which has no concept
+            of bandwidth, this object should be zero."
+    ::= { ifXEntry 15 }
+
+ifPromiscuousMode  OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object has a value of false(2) if this interface only
+            accepts packets/frames that are addressed to this station.
+            This object has a value of true(1) when the station accepts
+            all packets/frames transmitted on the media.  The value
+            true(1) is only legal on certain types of media.  If legal,
+            setting this object to a value of true(1) may require the
+            interface to be reset before becoming effective.
+
+            The value of ifPromiscuousMode does not affect the reception
+            of broadcast and multicast packets/frames by the interface."
+    ::= { ifXEntry 16 }
+
+ifConnectorPresent   OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "This object has the value 'true(1)' if the interface
+            sublayer has a physical connector and the value 'false(2)'
+            otherwise."
+    ::= { ifXEntry 17 }
+
+ifAlias   OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE(0..64))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object is an 'alias' name for the interface as
+            specified by a network manager, and provides a non-volatile
+            'handle' for the interface.
+
+            On the first instantiation of an interface, the value of
+            ifAlias associated with that interface is the zero-length
+            string.  As and when a value is written into an instance of
+            ifAlias through a network management set operation, then the
+            agent must retain the supplied value in the ifAlias instance
+            associated with the same interface for as long as that
+            interface remains instantiated, including across all re-
+            initializations/reboots of the network management system,
+            including those which result in a change of the interface's
+            ifIndex value.
+
+            An example of the value which a network manager might store
+            in this object for a WAN interface is the (Telco's) circuit
+            number/identifier of the interface.
+
+            Some agents may support write-access only for interfaces
+            having particular values of ifType.  An agent which supports
+            write access to this object is required to keep the value in
+            non-volatile storage, but it may limit the length of new
+            values depending on how much storage is already occupied by
+            the current values for other interfaces."
+    ::= { ifXEntry 18 }
+
+ifCounterDiscontinuityTime OBJECT-TYPE
+    SYNTAX      TimeStamp
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime on the most recent occasion at which
+            any one or more of this interface's counters suffered a
+            discontinuity.  The relevant counters are the specific
+            instances associated with this interface of any Counter32 or
+
+            Counter64 object contained in the ifTable or ifXTable.  If
+            no such discontinuities have occurred since the last re-
+            initialization of the local management subsystem, then this
+            object contains a zero value."
+    ::= { ifXEntry 19 }
+
+--           The Interface Stack Group
+--
+-- Implementation of this group is optional, but strongly recommended
+-- for all systems
+--
+
+ifStackTable  OBJECT-TYPE
+     SYNTAX        SEQUENCE OF IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The table containing information on the relationships
+            between the multiple sub-layers of network interfaces.  In
+            particular, it contains information on which sub-layers run
+            'on top of' which other sub-layers, where each sub-layer
+            corresponds to a conceptual row in the ifTable.  For
+            example, when the sub-layer with ifIndex value x runs over
+            the sub-layer with ifIndex value y, then this table
+            contains:
+
+              ifStackStatus.x.y=active
+
+            For each ifIndex value, I, which identifies an active
+            interface, there are always at least two instantiated rows
+            in this table associated with I.  For one of these rows, I
+            is the value of ifStackHigherLayer; for the other, I is the
+            value of ifStackLowerLayer.  (If I is not involved in
+            multiplexing, then these are the only two rows associated
+            with I.)
+
+            For example, two rows exist even for an interface which has
+            no others stacked on top or below it:
+
+              ifStackStatus.0.x=active
+              ifStackStatus.x.0=active "
+     ::= { ifMIBObjects 2 }
+
+ifStackEntry  OBJECT-TYPE
+     SYNTAX        IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "Information on a particular relationship between two sub-
+            layers, specifying that one sub-layer runs on 'top' of the
+            other sub-layer.  Each sub-layer corresponds to a conceptual
+            row in the ifTable."
+     INDEX { ifStackHigherLayer, ifStackLowerLayer }
+     ::= { ifStackTable 1 }
+
+IfStackEntry ::=
+    SEQUENCE {
+        ifStackHigherLayer  InterfaceIndexOrZero,
+        ifStackLowerLayer   InterfaceIndexOrZero,
+        ifStackStatus       RowStatus
+     }
+
+ifStackHigherLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the higher sub-layer
+            of the relationship, i.e., the sub-layer which runs on 'top'
+            of the sub-layer identified by the corresponding instance of
+            ifStackLowerLayer.  If there is no higher sub-layer (below
+            the internetwork layer), then this object has the value 0."
+     ::= { ifStackEntry 1 }
+
+ifStackLowerLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the lower sub-layer
+            of the relationship, i.e., the sub-layer which runs 'below'
+            the sub-layer identified by the corresponding instance of
+            ifStackHigherLayer.  If there is no lower sub-layer, then
+            this object has the value 0."
+     ::= { ifStackEntry 2 }
+
+ifStackStatus  OBJECT-TYPE
+    SYNTAX         RowStatus
+    MAX-ACCESS     read-create
+    STATUS         current
+    DESCRIPTION
+            "The status of the relationship between two sub-layers.
+
+            Changing the value of this object from 'active' to
+            'notInService' or 'destroy' will likely have consequences up
+            and down the interface stack.  Thus, write access to this
+            object is likely to be inappropriate for some types of
+            interfaces, and many implementations will choose not to
+            support write-access for any type of interface."
+    ::= { ifStackEntry 3 }
+
+ifStackLastChange OBJECT-TYPE
+    SYNTAX         TimeTicks
+    MAX-ACCESS     read-only
+    STATUS         current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last change of
+            the (whole) interface stack.  A change of the interface
+            stack is defined to be any creation, deletion, or change in
+            value of any instance of ifStackStatus.  If the interface
+            stack has been unchanged since the last re-initialization of
+            the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 6 }
+
+--   Generic Receive Address Table
+--
+-- This group of objects is mandatory for all types of
+-- interfaces which can receive packets/frames addressed to
+-- more than one address.
+--
+-- This table replaces the ifExtnsRcvAddr table.  The main
+-- difference is that this table makes use of the RowStatus
+-- textual convention, while ifExtnsRcvAddr did not.
+
+ifRcvAddressTable  OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "This table contains an entry for each address (broadcast,
+            multicast, or uni-cast) for which the system will receive
+            packets/frames on a particular interface, except as follows:
+
+            - for an interface operating in promiscuous mode, entries
+            are only required for those addresses for which the system
+            would receive frames were it not operating in promiscuous
+            mode.
+
+            - for 802.5 functional addresses, only one entry is
+            required, for the address which has the functional address
+            bit ANDed with the bit mask of all functional addresses for
+            which the interface will accept frames.
+
+            A system is normally able to use any unicast address which
+            corresponds to an entry in this table as a source address."
+    ::= { ifMIBObjects 4 }
+
+ifRcvAddressEntry  OBJECT-TYPE
+    SYNTAX      IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of objects identifying an address for which the
+            system will accept packets/frames on the particular
+            interface identified by the index value ifIndex."
+    INDEX  { ifIndex, ifRcvAddressAddress }
+    ::= { ifRcvAddressTable 1 }
+
+IfRcvAddressEntry ::=
+    SEQUENCE {
+        ifRcvAddressAddress   PhysAddress,
+        ifRcvAddressStatus    RowStatus,
+        ifRcvAddressType      INTEGER
+    }
+
+ifRcvAddressAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An address for which the system will accept packets/frames
+            on this entry's interface."
+    ::= { ifRcvAddressEntry 1 }
+
+ifRcvAddressStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object is used to create and delete rows in the
+            ifRcvAddressTable."
+    ::= { ifRcvAddressEntry 2 }
+
+ifRcvAddressType OBJECT-TYPE
+    SYNTAX      INTEGER {
+
+                    other(1),
+                    volatile(2),
+                    nonVolatile(3)
+                }
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object has the value nonVolatile(3) for those entries
+            in the table which are valid and will not be deleted by the
+            next restart of the managed system.  Entries having the
+            value volatile(2) are valid and exist, but have not been
+            saved, so that will not exist after the next restart of the
+            managed system.  Entries having the value other(1) are valid
+            and exist but are not classified as to whether they will
+            continue to exist after the next restart."
+    DEFVAL  { volatile }
+    ::= { ifRcvAddressEntry 3 }
+
+-- definition of interface-related traps.
+
+linkDown NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkDown trap signifies that the SNMP entity, acting in
+            an agent role, has detected that the ifOperStatus object for
+            one of its communication links is about to enter the down
+            state from some other state (but not from the notPresent
+            state).  This other state is indicated by the included value
+            of ifOperStatus."
+    ::= { snmpTraps 3 }
+
+linkUp NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkUp trap signifies that the SNMP entity, acting in an
+            agent role, has detected that the ifOperStatus object for
+            one of its communication links left the down state and
+            transitioned into some other state (but not into the
+            notPresent state).  This other state is indicated by the
+            included value of ifOperStatus."
+    ::= { snmpTraps 4 }
+
+-- conformance information
+
+ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
+
+ifGroups      OBJECT IDENTIFIER ::= { ifConformance 1 }
+ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
+
+-- compliance statements
+
+ifCompliance3 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which have
+            network interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup,
+                           linkUpDownNotificationsGroup }
+
+-- The groups:
+--        ifFixedLengthGroup
+--        ifHCFixedLengthGroup
+--        ifPacketGroup
+--        ifHCPacketGroup
+--        ifVHCPacketGroup
+-- are mutually exclusive; at most one of these groups is implemented
+-- for a particular interface.  When any of these groups is implemented
+-- for a particular interface, then ifCounterDiscontinuityGroup must
+-- also be implemented for that interface.
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are packet-oriented, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second but less than or equal to 650,000,000
+            bits/second."
+
+        GROUP       ifVHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifCounterDiscontinuityGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces that
+            are required to maintain counters (i.e., those for which one
+            of the ifFixedLengthGroup, ifHCFixedLengthGroup,
+            ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
+            mandatory)."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 3 }
+
+-- units of conformance
+
+ifGeneralInformationGroup    OBJECT-GROUP
+    OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName, ifNumber, ifAlias,
+              ifTableLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information applicable to
+            all network interfaces."
+    ::= { ifGroups 10 }
+
+-- the following five groups are mutually exclusive; at most
+-- one of these groups is implemented for any interface
+
+ifFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) character-oriented or fixed-length-transmission
+            network interfaces."
+    ::= { ifGroups 2 }
+
+ifHCFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second) character-
+            oriented or fixed-length-transmission network interfaces."
+    ::= { ifGroups 3 }
+
+ifPacketGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) packet-oriented network interfaces."
+    ::= { ifGroups 4 }
+
+ifHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second but less
+            than or equal to 650,000,000 bits/second) packet-oriented
+            network interfaces."
+    ::= { ifGroups 5 }
+
+ifVHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
+              ifHCInBroadcastPkts, ifHCOutUcastPkts,
+              ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
+              ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            higher speed (greater than 650,000,000 bits/second) packet-
+            oriented network interfaces."
+    ::= { ifGroups 6 }
+
+ifRcvAddressGroup    OBJECT-GROUP
+    OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            multiple addresses which an interface receives."
+    ::= { ifGroups 7 }
+
+ifStackGroup2    OBJECT-GROUP
+    OBJECTS { ifStackStatus, ifStackLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            layering of MIB-II interfaces."
+    ::= { ifGroups 11 }
+
+ifCounterDiscontinuityGroup  OBJECT-GROUP
+    OBJECTS { ifCounterDiscontinuityTime }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            interface counter discontinuities."
+    ::= { ifGroups 13 }
+
+linkUpDownNotificationsGroup  NOTIFICATION-GROUP
+    NOTIFICATIONS { linkUp, linkDown }
+    STATUS  current
+    DESCRIPTION
+            "The notifications which indicate specific changes in the
+            value of ifOperStatus."
+    ::= { ifGroups 14 }
+
+-- Deprecated Definitions - Objects
+
+--
+--    The Interface Test Table
+--
+-- This group of objects is optional.  However, a media-specific
+
+-- MIB may make implementation of this group mandatory.
+--
+-- This table replaces the ifExtnsTestTable
+--
+
+ifTestTable   OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfTestEntry
+    MAX-ACCESS  not-accessible
+    STATUS      deprecated
+    DESCRIPTION
+            "This table contains one entry per interface.  It defines
+            objects which allow a network manager to instruct an agent
+            to test an interface for various faults.  Tests for an
+            interface are defined in the media-specific MIB for that
+            interface.  After invoking a test, the object ifTestResult
+            can be read to determine the outcome.  If an agent can not
+            perform the test, ifTestResult is set to so indicate.  The
+            object ifTestCode can be used to provide further test-
+            specific or interface-specific (or even enterprise-specific)
+            information concerning the outcome of the test.  Only one
+            test can be in progress on each interface at any one time.
+            If one test is in progress when another test is invoked, the
+            second test is rejected.  Some agents may reject a test when
+            a prior test is active on another interface.
+
+            Before starting a test, a manager-station must first obtain
+            'ownership' of the entry in the ifTestTable for the
+            interface to be tested.  This is accomplished with the
+            ifTestId and ifTestStatus objects as follows:
+
+          try_again:
+              get (ifTestId, ifTestStatus)
+              while (ifTestStatus != notInUse)
+                  /*
+                   * Loop while a test is running or some other
+                   * manager is configuring a test.
+                   */
+                  short delay
+                  get (ifTestId, ifTestStatus)
+              }
+
+              /*
+               * Is not being used right now -- let's compete
+               * to see who gets it.
+               */
+              lock_value = ifTestId
+
+              if ( set(ifTestId = lock_value, ifTestStatus = inUse,
+                       ifTestOwner = 'my-IP-address') == FAILURE)
+                  /*
+                   * Another manager got the ifTestEntry -- go
+                   * try again
+                   */
+                  goto try_again;
+
+              /*
+               * I have the lock
+               */
+              set up any test parameters.
+
+              /*
+               * This starts the test
+               */
+              set(ifTestType = test_to_run);
+
+              wait for test completion by polling ifTestResult
+
+              when test completes, agent sets ifTestResult
+                   agent also sets ifTestStatus = 'notInUse'
+
+              retrieve any additional test results, and ifTestId
+
+              if (ifTestId == lock_value+1) results are valid
+
+            A manager station first retrieves the value of the
+            appropriate ifTestId and ifTestStatus objects, periodically
+            repeating the retrieval if necessary, until the value of
+            ifTestStatus is 'notInUse'.  The manager station then tries
+            to set the same ifTestId object to the value it just
+            retrieved, the same ifTestStatus object to 'inUse', and the
+            corresponding ifTestOwner object to a value indicating
+            itself.  If the set operation succeeds then the manager has
+            obtained ownership of the ifTestEntry, and the value of the
+            ifTestId object is incremented by the agent (per the
+            semantics of TestAndIncr).  Failure of the set operation
+            indicates that some other manager has obtained ownership of
+            the ifTestEntry.
+
+            Once ownership is obtained, any test parameters can be
+            setup, and then the test is initiated by setting ifTestType.
+            On completion of the test, the agent sets ifTestStatus to
+            'notInUse'.  Once this occurs, the manager can retrieve the
+            results.  In the (rare) event that the invocation of tests
+            by two network managers were to overlap, then there would be
+            a possibility that the first test's results might be
+            overwritten by the second test's results prior to the first
+
+            results being read.  This unlikely circumstance can be
+            detected by a network manager retrieving ifTestId at the
+            same time as retrieving the test results, and ensuring that
+            the results are for the desired request.
+
+            If ifTestType is not set within an abnormally long period of
+            time after ownership is obtained, the agent should time-out
+            the manager, and reset the value of the ifTestStatus object
+            back to 'notInUse'.  It is suggested that this time-out
+            period be 5 minutes.
+
+            In general, a management station must not retransmit a
+            request to invoke a test for which it does not receive a
+            response; instead, it properly inspects an agent's MIB to
+            determine if the invocation was successful.  Only if the
+            invocation was unsuccessful, is the invocation request
+            retransmitted.
+
+            Some tests may require the interface to be taken off-line in
+            order to execute them, or may even require the agent to
+            reboot after completion of the test.  In these
+            circumstances, communication with the management station
+            invoking the test may be lost until after completion of the
+            test.  An agent is not required to support such tests.
+            However, if such tests are supported, then the agent should
+            make every effort to transmit a response to the request
+            which invoked the test prior to losing communication.  When
+            the agent is restored to normal service, the results of the
+            test are properly made available in the appropriate objects.
+            Note that this requires that the ifIndex value assigned to
+            an interface must be unchanged even if the test causes a
+            reboot.  An agent must reject any test for which it cannot,
+            perhaps due to resource constraints, make available at least
+            the minimum amount of information after that test
+            completes."
+    ::= { ifMIBObjects 3 }
+
+ifTestEntry OBJECT-TYPE
+    SYNTAX       IfTestEntry
+    MAX-ACCESS   not-accessible
+    STATUS       deprecated
+    DESCRIPTION
+            "An entry containing objects for invoking tests on an
+            interface."
+    AUGMENTS  { ifEntry }
+    ::= { ifTestTable 1 }
+
+IfTestEntry ::=
+
+    SEQUENCE {
+        ifTestId           TestAndIncr,
+        ifTestStatus       INTEGER,
+        ifTestType         AutonomousType,
+        ifTestResult       INTEGER,
+        ifTestCode         OBJECT IDENTIFIER,
+        ifTestOwner        OwnerString
+    }
+
+ifTestId         OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object identifies the current invocation of the
+            interface's test."
+    ::= { ifTestEntry 1 }
+
+ifTestStatus     OBJECT-TYPE
+    SYNTAX       INTEGER { notInUse(1), inUse(2) }
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object indicates whether or not some manager currently
+            has the necessary 'ownership' required to invoke a test on
+            this interface.  A write to this object is only successful
+            when it changes its value from 'notInUse(1)' to 'inUse(2)'.
+            After completion of a test, the agent resets the value back
+            to 'notInUse(1)'."
+    ::= { ifTestEntry 2 }
+
+ifTestType       OBJECT-TYPE
+    SYNTAX       AutonomousType
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "A control variable used to start and stop operator-
+            initiated interface tests.  Most OBJECT IDENTIFIER values
+            assigned to tests are defined elsewhere, in association with
+            specific types of interface.  However, this document assigns
+            a value for a full-duplex loopback test, and defines the
+            special meanings of the subject identifier:
+
+                noTest  OBJECT IDENTIFIER ::= { 0 0 }
+
+            When the value noTest is written to this object, no action
+            is taken unless a test is in progress, in which case the
+            test is aborted.  Writing any other value to this object is
+
+            only valid when no test is currently in progress, in which
+            case the indicated test is initiated.
+
+            When read, this object always returns the most recent value
+            that ifTestType was set to.  If it has not been set since
+            the last initialization of the network management subsystem
+            on the agent, a value of noTest is returned."
+    ::= { ifTestEntry 3 }
+
+ifTestResult  OBJECT-TYPE
+    SYNTAX       INTEGER {
+                     none(1),          -- no test yet requested
+                     success(2),
+                     inProgress(3),
+                     notSupported(4),
+                     unAbleToRun(5),   -- due to state of system
+                     aborted(6),
+                     failed(7)
+                 }
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains the result of the most recently
+            requested test, or the value none(1) if no tests have been
+            requested since the last reset.  Note that this facility
+            provides no provision for saving the results of one test
+            when starting another, as could be required if used by
+            multiple managers concurrently."
+    ::= { ifTestEntry 4 }
+
+ifTestCode  OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains a code which contains more specific
+            information on the test result, for example an error-code
+            after a failed test.  Error codes and other values this
+            object may take are specific to the type of interface and/or
+            test.  The value may have the semantics of either the
+            AutonomousType or InstancePointer textual conventions as
+            defined in RFC 2579.  The identifier:
+
+                testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
+
+            is defined for use if no additional result code is
+            available."
+    ::= { ifTestEntry 5 }
+
+ifTestOwner      OBJECT-TYPE
+    SYNTAX       OwnerString
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "The entity which currently has the 'ownership' required to
+            invoke a test on this interface."
+    ::= { ifTestEntry 6 }
+
+-- Deprecated Definitions - Groups
+
+ifGeneralGroup    OBJECT-GROUP
+    OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects deprecated in favour of
+            ifGeneralInformationGroup."
+    ::= { ifGroups 1 }
+
+ifTestGroup    OBJECT-GROUP
+    OBJECTS { ifTestId, ifTestStatus, ifTestType,
+              ifTestResult, ifTestCode, ifTestOwner }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects providing the ability to invoke
+            tests on an interface."
+    ::= { ifGroups 8 }
+
+ifStackGroup    OBJECT-GROUP
+    OBJECTS { ifStackStatus }
+    STATUS  deprecated
+    DESCRIPTION
+            "The previous collection of objects providing information on
+            the layering of MIB-II interfaces."
+    ::= { ifGroups 9 }
+
+ifOldObjectsGroup    OBJECT-GROUP
+    OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
+              ifOutQLen, ifSpecific }
+    STATUS  deprecated
+    DESCRIPTION
+            "The collection of objects deprecated from the original MIB-
+            II interfaces group."
+    ::= { ifGroups 12 }
+
+-- Deprecated Definitions - Compliance
+
+ifCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifTestGroup
+        DESCRIPTION
+            "This group is optional.  Media-specific MIBs which require
+            interface tests are strongly encouraged to use this group
+            for invoking tests and reporting results.  A medium specific
+            MIB which has mandatory tests may make implementation of
+
+            this group mandatory."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+    ::= { ifCompliances 1 }
+
+ifCompliance2 MODULE-COMPLIANCE
+    STATUS      deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2,
+                           ifCounterDiscontinuityGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 2 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/INET-ADDRESS-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/INET-ADDRESS-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..a778cba6b74249f5a1a731f1437f905946bb1f48
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/INET-ADDRESS-MIB.txt
@@ -0,0 +1,402 @@
+INET-ADDRESS-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, mib-2, Unsigned32 FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                 FROM SNMPv2-TC;
+
+inetAddressMIB MODULE-IDENTITY
+    LAST-UPDATED "200502040000Z"
+    ORGANIZATION
+        "IETF Operations and Management Area"
+    CONTACT-INFO
+        "Juergen Schoenwaelder (Editor)
+         International University Bremen
+         P.O. Box 750 561
+         28725 Bremen, Germany
+
+         Phone: +49 421 200-3587
+         EMail: j.schoenwaelder@iu-bremen.de
+
+         Send comments to <ietfmibs@ops.ietf.org>."
+    DESCRIPTION
+        "This MIB module defines textual conventions for
+         representing Internet addresses.  An Internet
+         address can be an IPv4 address, an IPv6 address,
+         or a DNS domain name.  This module also defines
+         textual conventions for Internet port numbers,
+         autonomous system numbers, and the length of an
+         Internet address prefix.
+
+         Copyright (C) The Internet Society (2005).  This version
+         of this MIB module is part of RFC 4001, see the RFC
+         itself for full legal notices."
+    REVISION     "200502040000Z"
+    DESCRIPTION
+        "Third version, published as RFC 4001.  This revision
+         introduces the InetZoneIndex, InetScopeType, and
+         InetVersion textual conventions."
+    REVISION     "200205090000Z"
+    DESCRIPTION
+        "Second version, published as RFC 3291.  This
+         revision contains several clarifications and
+         introduces several new textual conventions:
+         InetAddressPrefixLength, InetPortNumber,
+         InetAutonomousSystemNumber, InetAddressIPv4z,
+         and InetAddressIPv6z."
+    REVISION     "200006080000Z"
+    DESCRIPTION
+        "Initial version, published as RFC 2851."
+    ::= { mib-2 76 }
+
+InetAddressType ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "A value that represents a type of Internet address.
+
+         unknown(0)  An unknown address type.  This value MUST
+                     be used if the value of the corresponding
+                     InetAddress object is a zero-length string.
+                     It may also be used to indicate an IP address
+                     that is not in one of the formats defined
+                     below.
+
+         ipv4(1)     An IPv4 address as defined by the
+                     InetAddressIPv4 textual convention.
+
+         ipv6(2)     An IPv6 address as defined by the
+                     InetAddressIPv6 textual convention.
+
+         ipv4z(3)    A non-global IPv4 address including a zone
+                     index as defined by the InetAddressIPv4z
+                     textual convention.
+
+         ipv6z(4)    A non-global IPv6 address including a zone
+                     index as defined by the InetAddressIPv6z
+                     textual convention.
+
+         dns(16)     A DNS domain name as defined by the
+                     InetAddressDNS textual convention.
+
+         Each definition of a concrete InetAddressType value must be
+         accompanied by a definition of a textual convention for use
+         with that InetAddressType.
+
+         To support future extensions, the InetAddressType textual
+         convention SHOULD NOT be sub-typed in object type definitions.
+         It MAY be sub-typed in compliance statements in order to
+         require only a subset of these address types for a compliant
+         implementation.
+
+         Implementations must ensure that InetAddressType objects
+         and any dependent objects (e.g., InetAddress objects) are
+         consistent.  An inconsistentValue error must be generated
+         if an attempt to change an InetAddressType object would,
+         for example, lead to an undefined InetAddress value.  In
+
+         particular, InetAddressType/InetAddress pairs must be
+         changed together if the address type changes (e.g., from
+         ipv6(2) to ipv4(1))."
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2),
+                     ipv4z(3),
+                     ipv6z(4),
+                     dns(16)
+                 }
+
+InetAddress ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "Denotes a generic Internet address.
+
+         An InetAddress value is always interpreted within the context
+         of an InetAddressType value.  Every usage of the InetAddress
+         textual convention is required to specify the InetAddressType
+         object that provides the context.  It is suggested that the
+         InetAddressType object be logically registered before the
+         object(s) that use the InetAddress textual convention, if
+         they appear in the same logical row.
+
+         The value of an InetAddress object must always be
+         consistent with the value of the associated InetAddressType
+         object.  Attempts to set an InetAddress object to a value
+         inconsistent with the associated InetAddressType
+         must fail with an inconsistentValue error.
+
+         When this textual convention is used as the syntax of an
+         index object, there may be issues with the limit of 128
+         sub-identifiers specified in SMIv2, STD 58.  In this case,
+         the object definition MUST include a 'SIZE' clause to
+         limit the number of potential instance sub-identifiers;
+         otherwise the applicable constraints MUST be stated in
+         the appropriate conceptual row DESCRIPTION clauses, or
+         in the surrounding documentation if there is no single
+         DESCRIPTION clause that is appropriate."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+InetAddressIPv4 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv4 network address:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+
+         The corresponding InetAddressType value is ipv4(1).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (4))
+
+InetAddressIPv6 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv6 network address:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+
+         The corresponding InetAddressType value is ipv6(2).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (16))
+
+InetAddressIPv4z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv4 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+            5-8     zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv4z(3).
+
+         The zone index (bytes 5-8) is used to disambiguate identical
+         address values on nodes that have interfaces attached to
+         different zones of the same scope.  The zone index may contain
+         the special value 0, which refers to the default zone for each
+         scope.
+
+         This textual convention SHOULD NOT be used directly in object
+
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (8))
+
+InetAddressIPv6z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv6 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+           17-20    zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv6z(4).
+
+         The zone index (bytes 17-20) is used to disambiguate
+         identical address values on nodes that have interfaces
+         attached to different zones of the same scope.  The zone index
+         may contain the special value 0, which refers to the default
+         zone for each scope.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (20))
+
+InetAddressDNS ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+        "Represents a DNS domain name.  The name SHOULD be fully
+         qualified whenever possible.
+
+         The corresponding InetAddressType is dns(16).
+
+         The DESCRIPTION clause of InetAddress objects that may have
+         InetAddressDNS values MUST fully describe how (and when)
+         these names are to be resolved to IP addresses.
+
+         The resolution of an InetAddressDNS value may require to
+         query multiple DNS records (e.g., A for IPv4 and AAAA for
+         IPv6).  The order of the resolution process and which DNS
+         record takes precedence depends on the configuration of the
+         resolver.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+InetAddressPrefixLength ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Denotes the length of a generic Internet network address
+         prefix.  A value of n corresponds to an IP address mask
+         that has n contiguous 1-bits from the most significant
+         bit (MSB), with all other bits set to 0.
+
+         An InetAddressPrefixLength value is always interpreted within
+         the context of an InetAddressType value.  Every usage of the
+         InetAddressPrefixLength textual convention is required to
+         specify the InetAddressType object that provides the
+         context.  It is suggested that the InetAddressType object be
+         logically registered before the object(s) that use the
+         InetAddressPrefixLength textual convention, if they appear
+         in the same logical row.
+
+         InetAddressPrefixLength values larger than
+         the maximum length of an IP address for a specific
+         InetAddressType are treated as the maximum significant
+         value applicable for the InetAddressType.  The maximum
+         significant value is 32 for the InetAddressType
+         'ipv4(1)' and 'ipv4z(3)' and 128 for the InetAddressType
+         'ipv6(2)' and 'ipv6z(4)'.  The maximum significant value
+         for the InetAddressType 'dns(16)' is 0.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where the Internet network address prefix
+         is unknown or does not apply.
+
+         The upper bound of the prefix length has been chosen to
+         be consistent with the maximum size of an InetAddress."
+    SYNTAX       Unsigned32 (0..2040)
+
+InetPortNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a 16 bit port number of an Internet transport
+
+         layer protocol.  Port numbers are assigned by IANA.  A
+         current list of all assignments is available from
+         <http://www.iana.org/>.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where a port number is unknown, or when the
+         value zero is used as a wildcard in a filter."
+    REFERENCE   "STD 6 (RFC 768), STD 7 (RFC 793) and RFC 2960"
+    SYNTAX       Unsigned32 (0..65535)
+
+InetAutonomousSystemNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an autonomous system number that identifies an
+         Autonomous System (AS).  An AS is a set of routers under a
+         single technical administration, using an interior gateway
+         protocol and common metrics to route packets within the AS,
+         and using an exterior gateway protocol to route packets to
+         other ASes'.  IANA maintains the AS number space and has
+         delegated large parts to the regional registries.
+
+         Autonomous system numbers are currently limited to 16 bits
+         (0..65535).  There is, however, work in progress to enlarge the
+         autonomous system number space to 32 bits.  Therefore, this
+         textual convention uses an Unsigned32 value without a
+         range restriction in order to support a larger autonomous
+         system number space."
+    REFERENCE   "RFC 1771, RFC 1930"
+    SYNTAX       Unsigned32
+
+InetScopeType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+        "Represents a scope type.  This textual convention can be used
+         in cases where a MIB has to represent different scope types
+         and there is no context information, such as an InetAddress
+         object, that implicitly defines the scope type.
+
+         Note that not all possible values have been assigned yet, but
+         they may be assigned in future revisions of this specification.
+         Applications should therefore be able to deal with values
+         not yet assigned."
+    REFERENCE   "RFC 3513"
+    SYNTAX       INTEGER {
+                     -- reserved(0),
+                     interfaceLocal(1),
+                     linkLocal(2),
+                     subnetLocal(3),
+                     adminLocal(4),
+                     siteLocal(5), -- site-local unicast addresses
+                                   -- have been deprecated by RFC 3879
+                     -- unassigned(6),
+                     -- unassigned(7),
+                     organizationLocal(8),
+                     -- unassigned(9),
+                     -- unassigned(10),
+                     -- unassigned(11),
+                     -- unassigned(12),
+                     -- unassigned(13),
+                     global(14)
+                     -- reserved(15)
+                 }
+
+InetZoneIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "A zone index identifies an instance of a zone of a
+         specific scope.
+
+         The zone index MUST disambiguate identical address
+         values.  For link-local addresses, the zone index will
+         typically be the interface index (ifIndex as defined in the
+         IF-MIB) of the interface on which the address is configured.
+
+         The zone index may contain the special value 0, which refers
+         to the default zone.  The default zone may be used in cases
+         where the valid zone index is not known (e.g., when a
+         management application has to write a link-local IPv6
+         address without knowing the interface index value).  The
+         default zone SHOULD NOT be used as an easy way out in
+         cases where the zone index for a non-global IPv6 address
+         is known."
+    REFERENCE   "RFC4007"
+    SYNTAX       Unsigned32
+
+InetVersion ::= TEXTUAL-CONVENTION
+    STATUS  current
+    DESCRIPTION
+        "A value representing a version of the IP protocol.
+
+         unknown(0)  An unknown or unspecified version of the IP
+                     protocol.
+
+         ipv4(1)     The IPv4 protocol as defined in RFC 791 (STD 5).
+
+         ipv6(2)     The IPv6 protocol as defined in RFC 2460.
+
+         Note that this textual convention SHOULD NOT be used to
+         distinguish different address types associated with IP
+         protocols.  The InetAddressType has been designed for this
+         purpose."
+    REFERENCE   "RFC 791, RFC 2460"
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2)
+                 }
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-FRAMEWORK-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..aa273c2858406630b179ddcc5711bc9f04e56a6a
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
@@ -0,0 +1,526 @@
+SNMP-FRAMEWORK-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE,
+    OBJECT-IDENTITY,
+    snmpModules                           FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                    FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF;
+
+snmpFrameworkMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-EMail:   snmpv3@lists.tislabs.com
+                  Subscribe:  snmpv3-request@lists.tislabs.com
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  EMail:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair &
+                  Co-editor:  David Harrington
+                              Enterasys Networks
+                  postal:     35 Industrial Way
+                              P. O. Box 5005
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  phone:      +1 603-337-2614
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+                  postal:     2141 North First Street
+                              San Jose, California 95131
+                              USA
+                  EMail:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+
+                  EMail:      bwijnen@lucent.com
+                  phone:      +31 348-680-485
+                    "
+       DESCRIPTION  "The SNMP Management Architecture MIB
+
+                     Copyright (C) The Internet Society (2002). This
+                     version of this MIB module is part of RFC 3411;
+                     see the RFC itself for full legal notices.
+                    "
+
+       REVISION     "200210140000Z"         -- 14 October 2002
+       DESCRIPTION  "Changes in this revision:
+                     - Updated various administrative information.
+                     - Corrected some typos.
+                     - Corrected typo in description of SnmpEngineID
+                       that led to range overlap for 127.
+                     - Changed '255a' to '255t' in definition of
+                       SnmpAdminString to align with current SMI.
+                     - Reworded 'reserved' for value zero in
+                       DESCRIPTION of SnmpSecurityModel.
+                     - The algorithm for allocating security models
+                       should give 256 per enterprise block, rather
+                       than 255.
+                     - The example engine ID of 'abcd' is not
+                       legal. Replaced with '800002b804616263'H based
+                       on example enterprise 696, string 'abc'.
+                     - Added clarification that engineID should
+                       persist across re-initializations.
+                     This revision published as RFC 3411.
+                    "
+       REVISION     "199901190000Z"         -- 19 January 1999
+       DESCRIPTION  "Updated editors' addresses, fixed typos.
+                     Published as RFC 2571.
+                    "
+       REVISION     "199711200000Z"         -- 20 November 1997
+       DESCRIPTION  "The initial version, published in RFC 2271.
+                    "
+       ::= { snmpModules 10 }
+
+   -- Textual Conventions used in the SNMP Management Architecture ***
+
+SnmpEngineID ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+                 Objects of this type are for identification, not for
+                 addressing, even though it is possible that an
+                 address may have been used in the generation of
+                 a specific value.
+
+                 The value for this object may not be all zeros or
+                 all 'ff'H or the empty (zero length) string.
+
+                 The initial value for this object may be configured
+                 via an operator console entry or via an algorithmic
+                 function.  In the latter case, the following
+                 example algorithm is recommended.
+
+                 In cases where there are multiple engines on the
+                 same system, the use of this algorithm is NOT
+                 appropriate, as it would result in all of those
+                 engines ending up with the same ID value.
+
+                 1) The very first bit is used to indicate how the
+                    rest of the data is composed.
+
+                    0 - as defined by enterprise using former methods
+                        that existed before SNMPv3. See item 2 below.
+
+                    1 - as defined by this architecture, see item 3
+                        below.
+
+                    Note that this allows existing uses of the
+                    engineID (also known as AgentID [RFC1910]) to
+                    co-exist with any new uses.
+
+                 2) The snmpEngineID has a length of 12 octets.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The remaining eight octets are determined via
+                    one or more enterprise-specific methods. Such
+                    methods must be designed so as to maximize the
+                    possibility that the value of this object will
+                    be unique in the agent's administrative domain.
+                    For example, it may be the IP address of the SNMP
+                    entity, or the MAC address of one of the
+                    interfaces, with each address suitably padded
+                    with random octets.  If multiple methods are
+                    defined, then it is recommended that the first
+                    octet indicate the method being used and the
+                    remaining octets be a function of the method.
+
+                 3) The length of the octet string varies.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The very first bit is set to 1. For example, the
+                    above value for Acme Networks now changes to be
+                    '800002b8'H.
+
+                    The fifth octet indicates how the rest (6th and
+                    following octets) are formatted. The values for
+                    the fifth octet are:
+
+                      0     - reserved, unused.
+
+                      1     - IPv4 address (4 octets)
+                              lowest non-special IP address
+
+                      2     - IPv6 address (16 octets)
+                              lowest non-special IP address
+
+                      3     - MAC address (6 octets)
+                              lowest IEEE MAC address, canonical
+                              order
+
+                      4     - Text, administratively assigned
+                              Maximum remaining length 27
+
+                      5     - Octets, administratively assigned
+                              Maximum remaining length 27
+
+                      6-127 - reserved, unused
+
+                    128-255 - as defined by the enterprise
+                              Maximum remaining length 27
+                "
+    SYNTAX       OCTET STRING (SIZE(5..32))
+
+SnmpSecurityModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a
+                 Security Model of the Security Subsystem within
+                 this SNMP Management Architecture.
+
+                 The values for securityModel are allocated as
+                 follows:
+
+                 - The zero value does not identify any particular
+                   security model.
+
+                 - Values between 1 and 255, inclusive, are reserved
+                   for standards-track Security Models and are
+                   managed by the Internet Assigned Numbers Authority
+                   (IANA).
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Security Models.  An
+                   enterprise-specific securityModel value is defined
+                   to be:
+
+                   enterpriseID * 256 + security model within
+                   enterprise
+
+                   For example, the fourth Security Model defined by
+                   the enterprise whose enterpriseID is 1 would be
+                   259.
+
+                 This scheme for allocation of securityModel
+                 values allows for a maximum of 255 standards-
+                 based Security Models, and for a maximum of
+                 256 Security Models per enterprise.
+
+                 It is believed that the assignment of new
+                 securityModel values will be rare in practice
+                 because the larger the number of simultaneously
+                 utilized Security Models, the larger the
+                 chance that interoperability will suffer.
+                 Consequently, it is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+
+                 securityModels.  This limits the ability to
+                 define new proprietary implementations of Security
+                 Models to the first 8,388,608 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the securityModel value will normally
+                 require only a single byte since, in practice,
+                 the leftmost bits will be zero for most messages
+                 and sign extension is suppressed by the encoding
+                 rules.
+
+                 As of this writing, there are several values
+                 of securityModel defined for use with SNMP or
+                 reserved for use with supporting MIB objects.
+                 They are as follows:
+
+                     0  reserved for 'any'
+                     1  reserved for SNMPv1
+                     2  reserved for SNMPv2c
+                     3  User-Based Security Model (USM)
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpMessageProcessingModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a Message
+                 Processing Model of the Message Processing
+                 Subsystem within this SNMP Management Architecture.
+
+                 The values for messageProcessingModel are
+                 allocated as follows:
+
+                 - Values between 0 and 255, inclusive, are
+                   reserved for standards-track Message Processing
+                   Models and are managed by the Internet Assigned
+                   Numbers Authority (IANA).
+
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Message Processing Models.
+                   An enterprise messageProcessingModel value is
+                   defined to be:
+
+                   enterpriseID * 256 +
+                        messageProcessingModel within enterprise
+
+                   For example, the fourth Message Processing Model
+                   defined by the enterprise whose enterpriseID
+
+                   is 1 would be 259.
+
+                 This scheme for allocating messageProcessingModel
+                 values allows for a maximum of 255 standards-
+                 based Message Processing Models, and for a
+                 maximum of 256 Message Processing Models per
+                 enterprise.
+
+                 It is believed that the assignment of new
+                 messageProcessingModel values will be rare
+                 in practice because the larger the number of
+                 simultaneously utilized Message Processing Models,
+                 the larger the chance that interoperability
+                 will suffer. It is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+                 messageProcessingModels.  This limits the ability
+                 to define new proprietary implementations of
+                 Message Processing Models to the first 8,388,608
+                 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the messageProcessingModel value will
+                 normally require only a single byte since, in
+                 practice, the leftmost bits will be zero for
+                 most messages and sign extension is suppressed
+                 by the encoding rules.
+
+                 As of this writing, there are several values of
+                 messageProcessingModel defined for use with SNMP.
+                 They are as follows:
+
+                     0  reserved for SNMPv1
+                     1  reserved for SNMPv2c
+                     2  reserved for SNMPv2u and SNMPv2*
+                     3  reserved for SNMPv3
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpSecurityLevel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "A Level of Security at which SNMP messages can be
+                 sent or with which operations are being processed;
+                 in particular, one of:
+
+                   noAuthNoPriv - without authentication and
+                                  without privacy,
+                   authNoPriv   - with authentication but
+                                  without privacy,
+                   authPriv     - with authentication and
+                                  with privacy.
+
+                 These three values are ordered such that
+                 noAuthNoPriv is less than authNoPriv and
+                 authNoPriv is less than authPriv.
+                "
+    SYNTAX       INTEGER { noAuthNoPriv(1),
+                           authNoPriv(2),
+                           authPriv(3)
+                         }
+
+SnmpAdminString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION "An octet string containing administrative
+                 information, preferably in human-readable form.
+
+                 To facilitate internationalization, this
+                 information is represented using the ISO/IEC
+                 IS 10646-1 character set, encoded as an octet
+                 string using the UTF-8 transformation format
+                 described in [RFC2279].
+
+                 Since additional code points are added by
+                 amendments to the 10646 standard from time
+                 to time, implementations must be prepared to
+                 encounter any code point from 0x00000000 to
+                 0x7fffffff.  Byte sequences that do not
+                 correspond to the valid UTF-8 encoding of a
+                 code point or are outside this range are
+                 prohibited.
+
+                 The use of control codes should be avoided.
+
+                 When it is necessary to represent a newline,
+                 the control code sequence CR LF should be used.
+
+                 The use of leading or trailing white space should
+                 be avoided.
+
+                 For code points not directly supported by user
+                 interface hardware or software, an alternative
+                 means of entry and display, such as hexadecimal,
+                 may be provided.
+
+                 For information encoded in 7-bit US-ASCII,
+                 the UTF-8 encoding is identical to the
+                 US-ASCII encoding.
+
+                 UTF-8 may require multiple bytes to represent a
+                 single character / code point; thus the length
+                 of this object in octets may be different from
+                 the number of characters encoded.  Similarly,
+                 size constraints refer to the number of encoded
+                 octets, not the number of characters represented
+                 by an encoding.
+
+                 Note that when this TC is used for an object that
+                 is used or envisioned to be used as an index, then
+                 a SIZE restriction MUST be specified so that the
+                 number of sub-identifiers for any object instance
+                 does not exceed the limit of 128, as defined by
+                 [RFC3416].
+
+                 Note that the size of an SnmpAdminString object is
+                 measured in octets, not characters.
+                "
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+-- Administrative assignments ***************************************
+
+snmpFrameworkAdmin
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 1 }
+snmpFrameworkMIBObjects
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 2 }
+snmpFrameworkMIBConformance
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 3 }
+
+-- the snmpEngine Group ********************************************
+
+snmpEngine OBJECT IDENTIFIER ::= { snmpFrameworkMIBObjects 1 }
+
+snmpEngineID     OBJECT-TYPE
+    SYNTAX       SnmpEngineID
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+
+                 This information SHOULD be stored in non-volatile
+                 storage so that it remains constant across
+                 re-initializations of the SNMP engine.
+                "
+    ::= { snmpEngine 1 }
+
+snmpEngineBoots  OBJECT-TYPE
+    SYNTAX       INTEGER (1..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of times that the SNMP engine has
+                 (re-)initialized itself since snmpEngineID
+                 was last configured.
+                "
+    ::= { snmpEngine 2 }
+
+snmpEngineTime   OBJECT-TYPE
+    SYNTAX       INTEGER (0..2147483647)
+    UNITS        "seconds"
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of seconds since the value of
+                 the snmpEngineBoots object last changed.
+                 When incrementing this object's value would
+                 cause it to exceed its maximum,
+                 snmpEngineBoots is incremented as if a
+                 re-initialization had occurred, and this
+                 object's value consequently reverts to zero.
+                "
+    ::= { snmpEngine 3 }
+
+snmpEngineMaxMessageSize OBJECT-TYPE
+    SYNTAX       INTEGER (484..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The maximum length in octets of an SNMP message
+                 which this SNMP engine can send or receive and
+                 process, determined as the minimum of the maximum
+                 message size values supported among all of the
+                 transports available to and supported by the engine.
+                "
+    ::= { snmpEngine 4 }
+
+-- Registration Points for Authentication and Privacy Protocols **
+
+snmpAuthProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track
+                  authentication protocols used in SNMP Management
+                  Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 1 }
+
+snmpPrivProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track privacy
+                  protocols used in SNMP Management Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 2 }
+
+-- Conformance information ******************************************
+
+snmpFrameworkMIBCompliances
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 1}
+snmpFrameworkMIBGroups
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 2}
+
+-- compliance statements
+
+snmpFrameworkMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP Management Framework MIB.
+                "
+    MODULE    -- this module
+        MANDATORY-GROUPS { snmpEngineGroup }
+    ::= { snmpFrameworkMIBCompliances 1 }
+
+-- units of conformance
+
+snmpEngineGroup OBJECT-GROUP
+    OBJECTS {
+              snmpEngineID,
+              snmpEngineBoots,
+              snmpEngineTime,
+              snmpEngineMaxMessageSize
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects for identifying and
+                 determining the configuration and current timeliness
+
+                 values of an SNMP engine.
+                "
+    ::= { snmpFrameworkMIBGroups 1 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-TARGET-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-TARGET-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..654afdd6941a473b44e10a28ecb5a5ef5937bc6d
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-TARGET-MIB.txt
@@ -0,0 +1,660 @@
+SNMP-TARGET-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY,
+    OBJECT-TYPE,
+    snmpModules,
+    Counter32,
+    Integer32
+        FROM SNMPv2-SMI
+
+    TEXTUAL-CONVENTION,
+    TDomain,
+    TAddress,
+    TimeInterval,
+    RowStatus,
+    StorageType,
+    TestAndIncr
+        FROM SNMPv2-TC
+
+    SnmpSecurityModel,
+    SnmpMessageProcessingModel,
+    SnmpSecurityLevel,
+    SnmpAdminString
+        FROM SNMP-FRAMEWORK-MIB
+
+    MODULE-COMPLIANCE,
+    OBJECT-GROUP
+        FROM SNMPv2-CONF;
+
+snmpTargetMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+        "WG-email:   snmpv3@lists.tislabs.com
+         Subscribe:  majordomo@lists.tislabs.com
+                     In message body:  subscribe snmpv3
+
+         Co-Chair:   Russ Mundy
+                     Network Associates Laboratories
+         Postal:     15204 Omega Drive, Suite 300
+                     Rockville, MD 20850-4601
+                     USA
+         EMail:      mundy@tislabs.com
+         Phone:      +1 301-947-7107
+
+         Co-Chair:   David Harrington
+                     Enterasys Networks
+         Postal:     35 Industrial Way
+                     P. O. Box 5004
+                     Rochester, New Hampshire 03866-5005
+                     USA
+         EMail:      dbh@enterasys.com
+         Phone:      +1 603-337-2614
+
+         Co-editor:  David B. Levi
+                     Nortel Networks
+         Postal:     3505 Kesterwood Drive
+                     Knoxville, Tennessee 37918
+         EMail:      dlevi@nortelnetworks.com
+         Phone:      +1 865 686 0432
+
+         Co-editor:  Paul Meyer
+                     Secure Computing Corporation
+         Postal:     2675 Long Lake Road
+
+                     Roseville, Minnesota 55113
+         EMail:      paul_meyer@securecomputing.com
+         Phone:      +1 651 628 1592
+
+         Co-editor:  Bob Stewart
+                     Retired"
+    DESCRIPTION
+        "This MIB module defines MIB objects which provide
+         mechanisms to remotely configure the parameters used
+         by an SNMP entity for the generation of SNMP messages.
+
+         Copyright (C) The Internet Society (2002). This
+         version of this MIB module is part of RFC 3413;
+         see the RFC itself for full legal notices.
+        "
+    REVISION    "200210140000Z"             -- 14 October 2002
+    DESCRIPTION "Fixed DISPLAY-HINTS for UTF-8 strings, fixed hex
+                 value of LF characters, clarified meaning of zero
+                 length tag values, improved tag list examples.
+                 Published as RFC 3413."
+    REVISION    "199808040000Z"             -- 4 August 1998
+    DESCRIPTION "Clarifications, published as
+                 RFC 2573."
+    REVISION    "199707140000Z"             -- 14 July 1997
+    DESCRIPTION "The initial revision, published as RFC2273."
+    ::= { snmpModules 12 }
+
+snmpTargetObjects       OBJECT IDENTIFIER ::= { snmpTargetMIB 1 }
+snmpTargetConformance   OBJECT IDENTIFIER ::= { snmpTargetMIB 3 }
+
+SnmpTagValue ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a tag value.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, and certain
+
+         control codes are not allowed as described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         Note that when this TC is used for an object that
+         is used or envisioned to be used as an index, then a
+         SIZE restriction must be specified so that the number
+         of sub-identifiers for any object instance does not
+         exceed the limit of 128, as defined by [RFC1905].
+
+         An object of this type contains a single tag value
+         which is used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+         in a tag list.  An object of this type may only
+         contain a single tag value, and so delimiter
+         characters are not allowed in a value of this type.
+
+         Note that a tag value of 0 length means that no tag is
+         defined.  In other words, a tag value of 0 length would
+         never match anything in a tag list, and would never
+         select any table entries.
+
+         Some examples of valid tag values are:
+
+             - 'acme'
+
+             - 'router'
+
+             - 'host'
+
+         The use of a tag value to select table entries is
+         application and MIB specific."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+SnmpTagList ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a list of tag values.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, except as
+         described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         An object of this type contains a list of tag values
+         which are used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+
+         in a tag list.  Only a single delimiter character may
+         occur between two tag values.  A tag value may not
+         have a zero length.  These constraints imply certain
+         restrictions on the contents of this object:
+
+             - There cannot be a leading or trailing delimiter
+               character.
+
+             - There cannot be multiple adjacent delimiter
+               characters.
+
+         Some examples of valid tag lists are:
+
+             - ''                        -- an empty list
+
+             - 'acme'                    -- list of one tag
+
+             - 'host router bridge'      -- list of several tags
+
+         Note that although a tag value may not have a length of
+         zero, an empty string is still valid.  This indicates
+         an empty list (i.e. there are no tag values in the list).
+
+         The use of the tag list to select table entries is
+         application and MIB specific.  Typically, an application
+         will provide one or more tag values, and any entry
+         which contains some combination of these tag values
+         will be selected."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+--
+--
+-- The snmpTargetObjects group
+--
+--
+
+snmpTargetSpinLock OBJECT-TYPE
+    SYNTAX      TestAndIncr
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+        "This object is used to facilitate modification of table
+         entries in the SNMP-TARGET-MIB module by multiple
+         managers.  In particular, it is useful when modifying
+         the value of the snmpTargetAddrTagList object.
+
+         The procedure for modifying the snmpTargetAddrTagList
+         object is as follows:
+
+             1.  Retrieve the value of snmpTargetSpinLock and
+                 of snmpTargetAddrTagList.
+
+             2.  Generate a new value for snmpTargetAddrTagList.
+
+             3.  Set the value of snmpTargetSpinLock to the
+                 retrieved value, and the value of
+                 snmpTargetAddrTagList to the new value.  If
+                 the set fails for the snmpTargetSpinLock
+                 object, go back to step 1."
+    ::= { snmpTargetObjects 1 }
+
+snmpTargetAddrTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of transport addresses to be used in the generation
+         of SNMP messages."
+    ::= { snmpTargetObjects 2 }
+
+snmpTargetAddrEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A transport address to be used in the generation
+         of SNMP operations.
+
+         Entries in the snmpTargetAddrTable are created and
+         deleted using the snmpTargetAddrRowStatus object."
+    INDEX { IMPLIED snmpTargetAddrName }
+    ::= { snmpTargetAddrTable 1 }
+
+SnmpTargetAddrEntry ::= SEQUENCE {
+    snmpTargetAddrName         SnmpAdminString,
+    snmpTargetAddrTDomain      TDomain,
+    snmpTargetAddrTAddress     TAddress,
+    snmpTargetAddrTimeout      TimeInterval,
+    snmpTargetAddrRetryCount   Integer32,
+    snmpTargetAddrTagList      SnmpTagList,
+    snmpTargetAddrParams       SnmpAdminString,
+    snmpTargetAddrStorageType  StorageType,
+    snmpTargetAddrRowStatus    RowStatus
+}
+
+snmpTargetAddrName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetAddrEntry."
+    ::= { snmpTargetAddrEntry 1 }
+
+snmpTargetAddrTDomain OBJECT-TYPE
+    SYNTAX      TDomain
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object indicates the transport type of the address
+         contained in the snmpTargetAddrTAddress object."
+    ::= { snmpTargetAddrEntry 2 }
+
+snmpTargetAddrTAddress OBJECT-TYPE
+    SYNTAX      TAddress
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a transport address.  The format of
+         this address depends on the value of the
+         snmpTargetAddrTDomain object."
+    ::= { snmpTargetAddrEntry 3 }
+
+snmpTargetAddrTimeout OBJECT-TYPE
+    SYNTAX      TimeInterval
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object should reflect the expected maximum round
+         trip time for communicating with the transport address
+         defined by this row.  When a message is sent to this
+         address, and a response (if one is expected) is not
+         received within this time period, an implementation
+         may assume that the response will not be delivered.
+
+         Note that the time interval that an application waits
+         for a response may actually be derived from the value
+         of this object.  The method for deriving the actual time
+         interval is implementation dependent.  One such method
+         is to derive the expected round trip time based on a
+         particular retransmission algorithm and on the number
+         of timeouts which have occurred.  The type of message may
+         also be considered when deriving expected round trip
+         times for retransmissions.  For example, if a message is
+         being sent with a securityLevel that indicates both
+
+         authentication and privacy, the derived value may be
+         increased to compensate for extra processing time spent
+         during authentication and encryption processing."
+    DEFVAL { 1500 }
+    ::= { snmpTargetAddrEntry 4 }
+
+snmpTargetAddrRetryCount OBJECT-TYPE
+    SYNTAX      Integer32 (0..255)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object specifies a default number of retries to be
+         attempted when a response is not received for a generated
+         message.  An application may provide its own retry count,
+         in which case the value of this object is ignored."
+    DEFVAL { 3 }
+    ::= { snmpTargetAddrEntry 5 }
+
+snmpTargetAddrTagList OBJECT-TYPE
+    SYNTAX      SnmpTagList
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a list of tag values which are
+         used to select target addresses for a particular
+         operation."
+    DEFVAL { "" }
+    ::= { snmpTargetAddrEntry 6 }
+
+snmpTargetAddrParams OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The value of this object identifies an entry in the
+         snmpTargetParamsTable.  The identified entry
+         contains SNMP parameters to be used when generating
+         messages to be sent to this transport address."
+    ::= { snmpTargetAddrEntry 7 }
+
+snmpTargetAddrStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetAddrEntry 8 }
+
+snmpTargetAddrRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetAddrRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding instances of
+         snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
+         snmpTargetAddrParams have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetAddrTDomain
+             - snmpTargetAddrTAddress
+         An attempt to set these objects while the value of
+         snmpTargetAddrRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetAddrEntry 9 }
+
+snmpTargetParamsTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of SNMP target information to be used
+         in the generation of SNMP messages."
+    ::= { snmpTargetObjects 3 }
+
+snmpTargetParamsEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A set of SNMP target information.
+
+         Entries in the snmpTargetParamsTable are created and
+         deleted using the snmpTargetParamsRowStatus object."
+    INDEX { IMPLIED snmpTargetParamsName }
+    ::= { snmpTargetParamsTable 1 }
+
+SnmpTargetParamsEntry ::= SEQUENCE {
+    snmpTargetParamsName           SnmpAdminString,
+    snmpTargetParamsMPModel        SnmpMessageProcessingModel,
+    snmpTargetParamsSecurityModel  SnmpSecurityModel,
+    snmpTargetParamsSecurityName   SnmpAdminString,
+    snmpTargetParamsSecurityLevel  SnmpSecurityLevel,
+    snmpTargetParamsStorageType    StorageType,
+    snmpTargetParamsRowStatus      RowStatus
+}
+
+snmpTargetParamsName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetParamsEntry."
+    ::= { snmpTargetParamsEntry 1 }
+
+snmpTargetParamsMPModel OBJECT-TYPE
+    SYNTAX      SnmpMessageProcessingModel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Message Processing Model to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 2 }
+
+snmpTargetParamsSecurityModel OBJECT-TYPE
+    SYNTAX      SnmpSecurityModel (1..2147483647)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Security Model to be used when generating SNMP
+          messages using this entry.  An implementation may
+          choose to return an inconsistentValue error if an
+          attempt is made to set this variable to a value
+          for a security model which the implementation does
+          not support."
+    ::= { snmpTargetParamsEntry 3 }
+
+snmpTargetParamsSecurityName OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The securityName which identifies the Principal on
+         whose behalf SNMP messages will be generated using
+         this entry."
+    ::= { snmpTargetParamsEntry 4 }
+
+snmpTargetParamsSecurityLevel OBJECT-TYPE
+    SYNTAX      SnmpSecurityLevel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Level of Security to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 5 }
+
+snmpTargetParamsStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetParamsEntry 6 }
+
+snmpTargetParamsRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetParamsRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding
+         snmpTargetParamsMPModel,
+         snmpTargetParamsSecurityModel,
+         snmpTargetParamsSecurityName,
+         and snmpTargetParamsSecurityLevel have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetParamsMPModel
+             - snmpTargetParamsSecurityModel
+             - snmpTargetParamsSecurityName
+             - snmpTargetParamsSecurityLevel
+         An attempt to set these objects while the value of
+         snmpTargetParamsRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetParamsEntry 7 }
+
+snmpUnavailableContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unavailable."
+    ::= { snmpTargetObjects 4 }
+
+snmpUnknownContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unknown."
+    ::= { snmpTargetObjects 5 }
+
+--
+--
+-- Conformance information
+--
+--
+
+snmpTargetCompliances OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 1 }
+snmpTargetGroups      OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 2 }
+
+--
+--
+-- Compliance statements
+
+--
+--
+
+snmpTargetCommandResponderCompliance MODULE-COMPLIANCE
+    STATUS      current
+    DESCRIPTION
+        "The compliance statement for SNMP entities which include
+         a command responder application."
+    MODULE -- This Module
+        MANDATORY-GROUPS { snmpTargetCommandResponderGroup }
+    ::= { snmpTargetCompliances 1 }
+
+snmpTargetBasicGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetSpinLock,
+        snmpTargetAddrTDomain,
+        snmpTargetAddrTAddress,
+        snmpTargetAddrTagList,
+        snmpTargetAddrParams,
+        snmpTargetAddrStorageType,
+        snmpTargetAddrRowStatus,
+        snmpTargetParamsMPModel,
+        snmpTargetParamsSecurityModel,
+        snmpTargetParamsSecurityName,
+        snmpTargetParamsSecurityLevel,
+        snmpTargetParamsStorageType,
+        snmpTargetParamsRowStatus
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing basic remote
+         configuration of management targets."
+    ::= { snmpTargetGroups 1 }
+
+snmpTargetResponseGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetAddrTimeout,
+        snmpTargetAddrRetryCount
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing remote configuration
+         of management targets for applications which generate
+         SNMP messages for which a response message would be
+         expected."
+    ::= { snmpTargetGroups 2 }
+
+snmpTargetCommandResponderGroup OBJECT-GROUP
+
+    OBJECTS {
+        snmpUnavailableContexts,
+        snmpUnknownContexts
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects required for command responder
+         applications, used for counting error conditions."
+    ::= { snmpTargetGroups 3 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7244ad0afb5837e33f3d8cea9f0f19fe5f066d43
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
@@ -0,0 +1,830 @@
+SNMP-VIEW-BASED-ACM-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF
+    MODULE-IDENTITY, OBJECT-TYPE,
+    snmpModules                           FROM SNMPv2-SMI
+    TestAndIncr,
+    RowStatus, StorageType                FROM SNMPv2-TC
+    SnmpAdminString,
+    SnmpSecurityLevel,
+    SnmpSecurityModel                     FROM SNMP-FRAMEWORK-MIB;
+
+snmpVacmMIB       MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"          -- 16 Oct 2002, midnight
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
+                  Subscribe:  majordomo@lists.tislabs.com
+                              In message body:  subscribe snmpv3
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  email:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair:   David Harrington
+                              Enterasys Networks
+                  Postal:     35 Industrial Way
+                              P. O. Box 5004
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  Phone:      +1 603-337-2614
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+                  email:      bwijnen@lucent.com
+                  phone:      +31-348-480-685
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+
+                  postal:     2141 North First Street
+                              San Jose, CA 95131
+                              USA
+                  email:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Keith McCloghrie
+                              Cisco Systems, Inc.
+                  postal:     170 West Tasman Drive
+                              San Jose, CA  95134-1706
+                              USA
+                  email:      kzm@cisco.com
+                  phone:      +1-408-526-5260
+                 "
+    DESCRIPTION  "The management information definitions for the
+                  View-based Access Control Model for SNMP.
+
+                  Copyright (C) The Internet Society (2002). This
+                  version of this MIB module is part of RFC 3415;
+                  see the RFC itself for full legal notices.
+                 "
+--  Revision history
+
+    REVISION     "200210160000Z"          -- 16 Oct 2002, midnight
+    DESCRIPTION  "Clarifications, published as RFC3415"
+
+    REVISION     "199901200000Z"          -- 20 Jan 1999, midnight
+    DESCRIPTION  "Clarifications, published as RFC2575"
+
+    REVISION     "199711200000Z"          -- 20 Nov 1997, midnight
+    DESCRIPTION  "Initial version, published as RFC2275"
+    ::= { snmpModules 16 }
+
+-- Administrative assignments ****************************************
+
+vacmMIBObjects      OBJECT IDENTIFIER ::= { snmpVacmMIB 1 }
+vacmMIBConformance  OBJECT IDENTIFIER ::= { snmpVacmMIB 2 }
+
+-- Information about Local Contexts **********************************
+
+vacmContextTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of locally available contexts.
+
+                 This table provides information to SNMP Command
+
+                 Generator applications so that they can properly
+                 configure the vacmAccessTable to control access to
+                 all contexts at the SNMP entity.
+
+                 This table may change dynamically if the SNMP entity
+                 allows that contexts are added/deleted dynamically
+                 (for instance when its configuration changes).  Such
+                 changes would happen only if the management
+                 instrumentation at that SNMP entity recognizes more
+                 (or fewer) contexts.
+
+                 The presence of entries in this table and of entries
+                 in the vacmAccessTable are independent.  That is, a
+                 context identified by an entry in this table is not
+                 necessarily referenced by any entries in the
+                 vacmAccessTable; and the context(s) referenced by an
+                 entry in the vacmAccessTable does not necessarily
+                 currently exist and thus need not be identified by an
+                 entry in this table.
+
+                 This table must be made accessible via the default
+                 context so that Command Responder applications have
+                 a standard way of retrieving the information.
+
+                 This table is read-only.  It cannot be configured via
+                 SNMP.
+                "
+    ::= { vacmMIBObjects 1 }
+
+vacmContextEntry OBJECT-TYPE
+    SYNTAX       VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information about a particular context."
+    INDEX       {
+                  vacmContextName
+                }
+    ::= { vacmContextTable 1 }
+
+VacmContextEntry ::= SEQUENCE
+    {
+        vacmContextName SnmpAdminString
+    }
+
+vacmContextName  OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "A human readable name identifying a particular
+                 context at a particular SNMP entity.
+
+                 The empty contextName (zero length) represents the
+                 default context.
+                "
+    ::= { vacmContextEntry 1 }
+
+-- Information about Groups ******************************************
+
+vacmSecurityToGroupTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "This table maps a combination of securityModel and
+                 securityName into a groupName which is used to define
+                 an access control policy for a group of principals.
+                "
+    ::= { vacmMIBObjects 2 }
+
+vacmSecurityToGroupEntry OBJECT-TYPE
+    SYNTAX       VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An entry in this table maps the combination of a
+                 securityModel and securityName into a groupName.
+                "
+    INDEX       {
+                  vacmSecurityModel,
+                  vacmSecurityName
+                }
+    ::= { vacmSecurityToGroupTable 1 }
+
+VacmSecurityToGroupEntry ::= SEQUENCE
+    {
+        vacmSecurityModel               SnmpSecurityModel,
+        vacmSecurityName                SnmpAdminString,
+        vacmGroupName                   SnmpAdminString,
+        vacmSecurityToGroupStorageType  StorageType,
+        vacmSecurityToGroupStatus       RowStatus
+    }
+
+vacmSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel(1..2147483647)
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The Security Model, by which the vacmSecurityName
+                 referenced by this entry is provided.
+
+                 Note, this object may not take the 'any' (0) value.
+                "
+    ::= { vacmSecurityToGroupEntry 1 }
+
+vacmSecurityName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The securityName for the principal, represented in a
+                 Security Model independent format, which is mapped by
+                 this entry to a groupName.
+                "
+    ::= { vacmSecurityToGroupEntry 2 }
+
+vacmGroupName    OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The name of the group to which this entry (e.g., the
+                 combination of securityModel and securityName)
+                 belongs.
+
+                 This groupName is used as index into the
+                 vacmAccessTable to select an access control policy.
+                 However, a value in this table does not imply that an
+                 instance with the value exists in table vacmAccesTable.
+                "
+    ::= { vacmSecurityToGroupEntry 3 }
+
+vacmSecurityToGroupStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmSecurityToGroupEntry 4 }
+
+vacmSecurityToGroupStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 Until instances of all corresponding columns are
+                 appropriately configured, the value of the
+
+                 corresponding instance of the vacmSecurityToGroupStatus
+                 column is 'notReady'.
+
+                 In particular, a newly created row cannot be made
+                 active until a value has been set for vacmGroupName.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmSecurityToGroupEntry 5 }
+
+-- Information about Access Rights ***********************************
+
+vacmAccessTable  OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of access rights for groups.
+
+                 Each entry is indexed by a groupName, a contextPrefix,
+                 a securityModel and a securityLevel.  To determine
+                 whether access is allowed, one entry from this table
+                 needs to be selected and the proper viewName from that
+                 entry must be used for access control checking.
+
+                 To select the proper entry, follow these steps:
+
+                 1) the set of possible matches is formed by the
+                    intersection of the following sets of entries:
+
+                      the set of entries with identical vacmGroupName
+                      the union of these two sets:
+                       - the set with identical vacmAccessContextPrefix
+                       - the set of entries with vacmAccessContextMatch
+                         value of 'prefix' and matching
+                         vacmAccessContextPrefix
+                      intersected with the union of these two sets:
+                       - the set of entries with identical
+                         vacmSecurityModel
+                       - the set of entries with vacmSecurityModel
+                         value of 'any'
+                      intersected with the set of entries with
+                      vacmAccessSecurityLevel value less than or equal
+                      to the requested securityLevel
+
+                 2) if this set has only one member, we're done
+                    otherwise, it comes down to deciding how to weight
+                    the preferences between ContextPrefixes,
+                    SecurityModels, and SecurityLevels as follows:
+                    a) if the subset of entries with securityModel
+                       matching the securityModel in the message is
+                       not empty, then discard the rest.
+                    b) if the subset of entries with
+                       vacmAccessContextPrefix matching the contextName
+                       in the message is not empty,
+                       then discard the rest
+                    c) discard all entries with ContextPrefixes shorter
+                       than the longest one remaining in the set
+                    d) select the entry with the highest securityLevel
+
+                 Please note that for securityLevel noAuthNoPriv, all
+                 groups are really equivalent since the assumption that
+                 the securityName has been authenticated does not hold.
+                "
+    ::= { vacmMIBObjects 4 }
+
+vacmAccessEntry  OBJECT-TYPE
+    SYNTAX       VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An access right configured in the Local Configuration
+                 Datastore (LCD) authorizing access to an SNMP context.
+
+                 Entries in this table can use an instance value for
+                 object vacmGroupName even if no entry in table
+                 vacmAccessSecurityToGroupTable has a corresponding
+                 value for object vacmGroupName.
+                "
+    INDEX       { vacmGroupName,
+                  vacmAccessContextPrefix,
+                  vacmAccessSecurityModel,
+                  vacmAccessSecurityLevel
+                }
+    ::= { vacmAccessTable 1 }
+
+VacmAccessEntry ::= SEQUENCE
+    {
+        vacmAccessContextPrefix    SnmpAdminString,
+        vacmAccessSecurityModel    SnmpSecurityModel,
+        vacmAccessSecurityLevel    SnmpSecurityLevel,
+        vacmAccessContextMatch     INTEGER,
+        vacmAccessReadViewName     SnmpAdminString,
+        vacmAccessWriteViewName    SnmpAdminString,
+        vacmAccessNotifyViewName   SnmpAdminString,
+        vacmAccessStorageType      StorageType,
+        vacmAccessStatus           RowStatus
+    }
+
+vacmAccessContextPrefix OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, a contextName must match exactly
+                 (if the value of vacmAccessContextMatch is 'exact')
+                 or partially (if the value of vacmAccessContextMatch
+                 is 'prefix') to the value of the instance of this
+                 object.
+                "
+    ::= { vacmAccessEntry 1 }
+
+vacmAccessSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, this securityModel must be in use.
+                "
+    ::= { vacmAccessEntry 2 }
+
+vacmAccessSecurityLevel OBJECT-TYPE
+    SYNTAX       SnmpSecurityLevel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The minimum level of security required in order to
+                 gain the access rights allowed by this conceptual
+                 row.  A securityLevel of noAuthNoPriv is less than
+                 authNoPriv which in turn is less than authPriv.
+
+                 If multiple entries are equally indexed except for
+                 this vacmAccessSecurityLevel index, then the entry
+                 which has the highest value for
+                 vacmAccessSecurityLevel is selected.
+                "
+    ::= { vacmAccessEntry 3 }
+
+vacmAccessContextMatch OBJECT-TYPE
+    SYNTAX       INTEGER
+                { exact (1), -- exact match of prefix and contextName
+                  prefix (2) -- Only match to the prefix
+                }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "If the value of this object is exact(1), then all
+                 rows where the contextName exactly matches
+                 vacmAccessContextPrefix are selected.
+
+                 If the value of this object is prefix(2), then all
+                 rows where the contextName whose starting octets
+                 exactly match vacmAccessContextPrefix are selected.
+                 This allows for a simple form of wildcarding.
+                "
+    DEFVAL      { exact }
+    ::= { vacmAccessEntry 4 }
+
+vacmAccessReadViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes read access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 5 }
+
+vacmAccessWriteViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes write access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 6 }
+
+vacmAccessNotifyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes access for notifications.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 7 }
+
+vacmAccessStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmAccessEntry 8 }
+
+vacmAccessStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmAccessEntry 9 }
+
+-- Information about MIB views ***************************************
+
+-- Support for instance-level granularity is optional.
+--
+-- In some implementations, instance-level access control
+-- granularity may come at a high performance cost.  Managers
+-- should avoid requesting such configurations unnecessarily.
+
+vacmMIBViews     OBJECT IDENTIFIER ::= { vacmMIBObjects 5 }
+
+vacmViewSpinLock OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       current
+    DESCRIPTION "An advisory lock used to allow cooperating SNMP
+                 Command Generator applications to coordinate their
+                 use of the Set operation in creating or modifying
+                 views.
+
+                 When creating a new view or altering an existing
+                 view, it is important to understand the potential
+                 interactions with other uses of the view.  The
+                 vacmViewSpinLock should be retrieved.  The name of
+                 the view to be created should be determined to be
+                 unique by the SNMP Command Generator application by
+                 consulting the vacmViewTreeFamilyTable.  Finally,
+                 the named view may be created (Set), including the
+                 advisory lock.
+                 If another SNMP Command Generator application has
+                 altered the views in the meantime, then the spin
+                 lock's value will have changed, and so this creation
+                 will fail because it will specify the wrong value for
+                 the spin lock.
+
+                 Since this is an advisory lock, the use of this lock
+                 is not enforced.
+                "
+    ::= { vacmMIBViews 1 }
+
+vacmViewTreeFamilyTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Locally held information about families of subtrees
+                 within MIB views.
+
+                 Each MIB view is defined by two sets of view subtrees:
+                   - the included view subtrees, and
+                   - the excluded view subtrees.
+                 Every such view subtree, both the included and the
+
+                 excluded ones, is defined in this table.
+
+                 To determine if a particular object instance is in
+                 a particular MIB view, compare the object instance's
+                 OBJECT IDENTIFIER with each of the MIB view's active
+                 entries in this table.  If none match, then the
+                 object instance is not in the MIB view.  If one or
+                 more match, then the object instance is included in,
+                 or excluded from, the MIB view according to the
+                 value of vacmViewTreeFamilyType in the entry whose
+                 value of vacmViewTreeFamilySubtree has the most
+                 sub-identifiers.  If multiple entries match and have
+                 the same number of sub-identifiers (when wildcarding
+                 is specified with the value of vacmViewTreeFamilyMask),
+                 then the lexicographically greatest instance of
+                 vacmViewTreeFamilyType determines the inclusion or
+                 exclusion.
+
+                 An object instance's OBJECT IDENTIFIER X matches an
+                 active entry in this table when the number of
+                 sub-identifiers in X is at least as many as in the
+                 value of vacmViewTreeFamilySubtree for the entry,
+                 and each sub-identifier in the value of
+                 vacmViewTreeFamilySubtree matches its corresponding
+                 sub-identifier in X.  Two sub-identifiers match
+                 either if the corresponding bit of the value of
+                 vacmViewTreeFamilyMask for the entry is zero (the
+                 'wild card' value), or if they are equal.
+
+                 A 'family' of subtrees is the set of subtrees defined
+                 by a particular combination of values of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask.
+
+                 In the case where no 'wild card' is defined in the
+                 vacmViewTreeFamilyMask, the family of subtrees reduces
+                 to a single subtree.
+
+                 When creating or changing MIB views, an SNMP Command
+                 Generator application should utilize the
+                 vacmViewSpinLock to try to avoid collisions.  See
+                 DESCRIPTION clause of vacmViewSpinLock.
+
+                 When creating MIB views, it is strongly advised that
+                 first the 'excluded' vacmViewTreeFamilyEntries are
+                 created and then the 'included' entries.
+
+                 When deleting MIB views, it is strongly advised that
+                 first the 'included' vacmViewTreeFamilyEntries are
+
+                 deleted and then the 'excluded' entries.
+
+                 If a create for an entry for instance-level access
+                 control is received and the implementation does not
+                 support instance-level granularity, then an
+                 inconsistentName error must be returned.
+                "
+    ::= { vacmMIBViews 2 }
+
+vacmViewTreeFamilyEntry OBJECT-TYPE
+    SYNTAX       VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information on a particular family of view subtrees
+                 included in or excluded from a particular SNMP
+                 context's MIB view.
+
+                 Implementations must not restrict the number of
+                 families of view subtrees for a given MIB view,
+                 except as dictated by resource constraints on the
+                 overall number of entries in the
+                 vacmViewTreeFamilyTable.
+
+                 If no conceptual rows exist in this table for a given
+                 MIB view (viewName), that view may be thought of as
+                 consisting of the empty set of view subtrees.
+                "
+    INDEX       { vacmViewTreeFamilyViewName,
+                  vacmViewTreeFamilySubtree
+                }
+    ::= { vacmViewTreeFamilyTable 1 }
+
+VacmViewTreeFamilyEntry ::= SEQUENCE
+    {
+        vacmViewTreeFamilyViewName     SnmpAdminString,
+        vacmViewTreeFamilySubtree      OBJECT IDENTIFIER,
+        vacmViewTreeFamilyMask         OCTET STRING,
+        vacmViewTreeFamilyType         INTEGER,
+        vacmViewTreeFamilyStorageType  StorageType,
+        vacmViewTreeFamilyStatus       RowStatus
+    }
+
+vacmViewTreeFamilyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The human readable name for a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 1 }
+
+vacmViewTreeFamilySubtree OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The MIB subtree which when combined with the
+                 corresponding instance of vacmViewTreeFamilyMask
+                 defines a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 2 }
+
+vacmViewTreeFamilyMask OBJECT-TYPE
+    SYNTAX       OCTET STRING (SIZE (0..16))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The bit mask which, in combination with the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 defines a family of view subtrees.
+
+                 Each bit of this bit mask corresponds to a
+                 sub-identifier of vacmViewTreeFamilySubtree, with the
+                 most significant bit of the i-th octet of this octet
+                 string value (extended if necessary, see below)
+                 corresponding to the (8*i - 7)-th sub-identifier, and
+                 the least significant bit of the i-th octet of this
+                 octet string corresponding to the (8*i)-th
+                 sub-identifier, where i is in the range 1 through 16.
+
+                 Each bit of this bit mask specifies whether or not
+                 the corresponding sub-identifiers must match when
+                 determining if an OBJECT IDENTIFIER is in this
+                 family of view subtrees; a '1' indicates that an
+                 exact match must occur; a '0' indicates 'wild card',
+                 i.e., any sub-identifier value matches.
+
+                 Thus, the OBJECT IDENTIFIER X of an object instance
+                 is contained in a family of view subtrees if, for
+                 each sub-identifier of the value of
+                 vacmViewTreeFamilySubtree, either:
+
+                   the i-th bit of vacmViewTreeFamilyMask is 0, or
+
+                   the i-th sub-identifier of X is equal to the i-th
+                   sub-identifier of the value of
+                   vacmViewTreeFamilySubtree.
+
+                 If the value of this bit mask is M bits long and
+
+                 there are more than M sub-identifiers in the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 then the bit mask is extended with 1's to be the
+                 required length.
+
+                 Note that when the value of this object is the
+                 zero-length string, this extension rule results in
+                 a mask of all-1's being used (i.e., no 'wild card'),
+                 and the family of view subtrees is the one view
+                 subtree uniquely identified by the corresponding
+                 instance of vacmViewTreeFamilySubtree.
+
+                 Note that masks of length greater than zero length
+                 do not need to be supported.  In this case this
+                 object is made read-only.
+                "
+    DEFVAL      { ''H }
+    ::= { vacmViewTreeFamilyEntry 3 }
+
+vacmViewTreeFamilyType OBJECT-TYPE
+    SYNTAX       INTEGER  { included(1), excluded(2) }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "Indicates whether the corresponding instances of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask
+                 define a family of view subtrees which is included in
+                 or excluded from the MIB view.
+                "
+    DEFVAL      { included }
+    ::= { vacmViewTreeFamilyEntry 4 }
+
+vacmViewTreeFamilyStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmViewTreeFamilyEntry 5 }
+
+vacmViewTreeFamilyStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmViewTreeFamilyEntry 6 }
+
+-- Conformance information *******************************************
+
+vacmMIBCompliances  OBJECT IDENTIFIER ::= { vacmMIBConformance 1 }
+vacmMIBGroups       OBJECT IDENTIFIER ::= { vacmMIBConformance 2 }
+
+-- Compliance statements *********************************************
+
+vacmMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP View-based Access Control Model
+                 configuration MIB.
+                "
+    MODULE -- this module
+        MANDATORY-GROUPS { vacmBasicGroup }
+
+        OBJECT        vacmAccessContextMatch
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessReadViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessWriteViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessNotifyViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+
+                      vacmAccessTable is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyMask
+        WRITE-SYNTAX  OCTET STRING (SIZE (0))
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Support for configuration via SNMP of subtree
+                      families using wild-cards is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+                      vacmViewTreeFamilyTable is not required.
+                     "
+    ::= { vacmMIBCompliances 1 }
+
+-- Units of conformance **********************************************
+
+vacmBasicGroup OBJECT-GROUP
+    OBJECTS {
+              vacmContextName,
+              vacmGroupName,
+              vacmSecurityToGroupStorageType,
+              vacmSecurityToGroupStatus,
+              vacmAccessContextMatch,
+              vacmAccessReadViewName,
+              vacmAccessWriteViewName,
+              vacmAccessNotifyViewName,
+              vacmAccessStorageType,
+              vacmAccessStatus,
+              vacmViewSpinLock,
+              vacmViewTreeFamilyMask,
+              vacmViewTreeFamilyType,
+              vacmViewTreeFamilyStorageType,
+              vacmViewTreeFamilyStatus
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects providing for remote
+                 configuration of an SNMP engine which implements
+
+                 the SNMP View-based Access Control Model.
+                "
+    ::= { vacmMIBGroups 1 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-CONF.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-CONF.txt
new file mode 100644
index 0000000000000000000000000000000000000000..24a1eed95d62f81ea88c3a78017696fa05400340
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-CONF.txt
@@ -0,0 +1,322 @@
+SNMPv2-CONF DEFINITIONS ::= BEGIN
+
+IMPORTS ObjectName, NotificationName, ObjectSyntax
+                                               FROM SNMPv2-SMI;
+
+-- definitions for conformance groups
+
+OBJECT-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+    Objects ::=
+                  Object
+                | Objects "," Object
+    Object ::=
+
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- more definitions for conformance groups
+
+NOTIFICATION-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  NotificationsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    NotificationsPart ::=
+                  "NOTIFICATIONS" "{" Notifications "}"
+    Notifications ::=
+                  Notification
+                | Notifications "," Notification
+    Notification ::=
+                  value(NotificationName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for compliance statements
+
+MODULE-COMPLIANCE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "MODULE" ModuleName
+                  MandatoryPart
+                  CompliancePart
+
+    ModuleName ::=
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+                  -- must not be empty unless contained
+                  -- in MIB Module
+                | empty
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    MandatoryPart ::=
+                  "MANDATORY-GROUPS" "{" Groups "}"
+                | empty
+
+    Groups ::=
+
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    CompliancePart ::=
+                  Compliances
+                | empty
+
+    Compliances ::=
+                  Compliance
+                | Compliances Compliance
+    Compliance ::=
+                  ComplianceGroup
+                | Object
+
+    ComplianceGroup ::=
+                  "GROUP" value(OBJECT IDENTIFIER)
+                  "DESCRIPTION" Text
+
+    Object ::=
+                  "OBJECT" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    -- must be a refinement for object's SYNTAX clause
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "MIN-ACCESS" Access
+                | empty
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for capabilities statements
+
+AGENT-CAPABILITIES MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "PRODUCT-RELEASE" Text
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+                | empty
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "SUPPORTS" ModuleName
+                  "INCLUDES" "{" Groups "}"
+                  VariationPart
+
+    ModuleName ::=
+
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    Groups ::=
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    VariationPart ::=
+                  Variations
+                | empty
+    Variations ::=
+                  Variation
+                | Variations Variation
+
+    Variation ::=
+                  ObjectVariation
+                | NotificationVariation
+
+    NotificationVariation ::=
+                  "VARIATION" value(NotificationName)
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    ObjectVariation ::=
+                  "VARIATION" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  CreationPart
+                  DefValPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "ACCESS" Access
+                | empty
+
+    Access ::=
+                  "not-implemented"
+                -- only "not-implemented" for notifications
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+                -- following is for backward-compatibility only
+                | "write-only"
+
+    CreationPart ::=
+                  "CREATION-REQUIRES" "{" Cells "}"
+                | empty
+    Cells ::=
+                  Cell
+                | Cells "," Cell
+    Cell ::=
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the object's syntax
+                  -- in this macro's SYNTAX clause, if present,
+                  -- or if not, in object's OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-MIB.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-MIB.txt
new file mode 100644
index 0000000000000000000000000000000000000000..8c828305e06fd4a438b62fd6dcec1f30a173af28
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-MIB.txt
@@ -0,0 +1,854 @@
+SNMPv2-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
+    TimeTicks, Counter32, snmpModules, mib-2
+        FROM SNMPv2-SMI
+    DisplayString, TestAndIncr, TimeStamp
+
+        FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
+        FROM SNMPv2-CONF;
+
+snmpMIB MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+            "WG-EMail:   snmpv3@lists.tislabs.com
+             Subscribe:  snmpv3-request@lists.tislabs.com
+
+             Co-Chair:   Russ Mundy
+                         Network Associates Laboratories
+             postal:     15204 Omega Drive, Suite 300
+                         Rockville, MD 20850-4601
+                         USA
+             EMail:      mundy@tislabs.com
+             phone:      +1 301 947-7107
+
+             Co-Chair:   David Harrington
+                         Enterasys Networks
+             postal:     35 Industrial Way
+                         P. O. Box 5005
+                         Rochester, NH 03866-5005
+                         USA
+             EMail:      dbh@enterasys.com
+             phone:      +1 603 337-2614
+
+             Editor:     Randy Presuhn
+                         BMC Software, Inc.
+             postal:     2141 North First Street
+                         San Jose, CA 95131
+                         USA
+             EMail:      randy_presuhn@bmc.com
+             phone:      +1 408 546-1006"
+    DESCRIPTION
+            "The MIB module for SNMP entities.
+
+             Copyright (C) The Internet Society (2002). This
+             version of this MIB module is part of RFC 3418;
+             see the RFC itself for full legal notices.
+            "
+    REVISION      "200210160000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 3418."
+    REVISION      "199511090000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 1907."
+    REVISION      "199304010000Z"
+    DESCRIPTION
+            "The initial revision of this MIB module was published
+            as RFC 1450."
+    ::= { snmpModules 1 }
+
+snmpMIBObjects OBJECT IDENTIFIER ::= { snmpMIB 1 }
+
+--  ::= { snmpMIBObjects 1 }        this OID is obsolete
+--  ::= { snmpMIBObjects 2 }        this OID is obsolete
+--  ::= { snmpMIBObjects 3 }        this OID is obsolete
+
+-- the System group
+--
+-- a collection of objects common to all managed systems.
+
+system   OBJECT IDENTIFIER ::= { mib-2 1 }
+
+sysDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual description of the entity.  This value should
+            include the full name and version identification of
+            the system's hardware type, software operating-system,
+            and networking software."
+    ::= { system 1 }
+
+sysObjectID OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The vendor's authoritative identification of the
+            network management subsystem contained in the entity.
+            This value is allocated within the SMI enterprises
+            subtree (1.3.6.1.4.1) and provides an easy and
+            unambiguous means for determining `what kind of box' is
+            being managed.  For example, if vendor `Flintstones,
+            Inc.' was assigned the subtree 1.3.6.1.4.1.424242,
+            it could assign the identifier 1.3.6.1.4.1.424242.1.1
+            to its `Fred Router'."
+    ::= { system 2 }
+
+sysUpTime OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The time (in hundredths of a second) since the
+            network management portion of the system was last
+            re-initialized."
+    ::= { system 3 }
+
+sysContact OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The textual identification of the contact person for
+            this managed node, together with information on how
+            to contact this person.  If no contact information is
+            known, the value is the zero-length string."
+    ::= { system 4 }
+
+sysName OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "An administratively-assigned name for this managed
+            node.  By convention, this is the node's fully-qualified
+            domain name.  If the name is unknown, the value is
+            the zero-length string."
+    ::= { system 5 }
+
+sysLocation OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The physical location of this node (e.g., 'telephone
+            closet, 3rd floor').  If the location is unknown, the
+            value is the zero-length string."
+    ::= { system 6 }
+
+sysServices OBJECT-TYPE
+    SYNTAX      INTEGER (0..127)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A value which indicates the set of services that this
+            entity may potentially offer.  The value is a sum.
+
+            This sum initially takes the value zero. Then, for
+            each layer, L, in the range 1 through 7, that this node
+            performs transactions for, 2 raised to (L - 1) is added
+            to the sum.  For example, a node which performs only
+            routing functions would have a value of 4 (2^(3-1)).
+            In contrast, a node which is a host offering application
+            services would have a value of 72 (2^(4-1) + 2^(7-1)).
+            Note that in the context of the Internet suite of
+            protocols, values should be calculated accordingly:
+
+                 layer      functionality
+                   1        physical (e.g., repeaters)
+                   2        datalink/subnetwork (e.g., bridges)
+                   3        internet (e.g., supports the IP)
+                   4        end-to-end  (e.g., supports the TCP)
+                   7        applications (e.g., supports the SMTP)
+
+            For systems including OSI protocols, layers 5 and 6
+            may also be counted."
+    ::= { system 7 }
+
+-- object resource information
+--
+-- a collection of objects which describe the SNMP entity's
+-- (statically and dynamically configurable) support of
+-- various MIB modules.
+
+sysORLastChange OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the most recent
+            change in state or value of any instance of sysORID."
+    ::= { system 8 }
+
+sysORTable OBJECT-TYPE
+    SYNTAX     SEQUENCE OF SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The (conceptual) table listing the capabilities of
+            the local SNMP application acting as a command
+            responder with respect to various MIB modules.
+            SNMP entities having dynamically-configurable support
+            of MIB modules will have a dynamically-varying number
+            of conceptual rows."
+    ::= { system 9 }
+
+sysOREntry OBJECT-TYPE
+    SYNTAX     SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "An entry (conceptual row) in the sysORTable."
+    INDEX      { sysORIndex }
+    ::= { sysORTable 1 }
+
+SysOREntry ::= SEQUENCE {
+    sysORIndex     INTEGER,
+    sysORID        OBJECT IDENTIFIER,
+    sysORDescr     DisplayString,
+    sysORUpTime    TimeStamp
+}
+
+sysORIndex OBJECT-TYPE
+    SYNTAX     INTEGER (1..2147483647)
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The auxiliary variable used for identifying instances
+            of the columnar objects in the sysORTable."
+    ::= { sysOREntry 1 }
+
+sysORID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "An authoritative identification of a capabilities
+            statement with respect to various MIB modules supported
+            by the local SNMP application acting as a command
+            responder."
+    ::= { sysOREntry 2 }
+
+sysORDescr OBJECT-TYPE
+    SYNTAX     DisplayString
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "A textual description of the capabilities identified
+            by the corresponding instance of sysORID."
+    ::= { sysOREntry 3 }
+
+sysORUpTime OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time this conceptual
+            row was last instantiated."
+    ::= { sysOREntry 4 }
+
+-- the SNMP group
+--
+-- a collection of objects providing basic instrumentation and
+-- control of an SNMP entity.
+
+snmp     OBJECT IDENTIFIER ::= { mib-2 11 }
+
+snmpInPkts OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of messages delivered to the SNMP
+            entity from the transport service."
+    ::= { snmp 1 }
+
+snmpInBadVersions OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of SNMP messages which were delivered
+            to the SNMP entity and were for an unsupported SNMP
+            version."
+    ::= { snmp 3 }
+
+snmpInBadCommunityNames OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example,  SNMPv1) delivered to the SNMP entity which
+           used an SNMP community name not known to said entity.
+           Also, implementations which authenticate community-based
+           SNMP messages using check(s) in addition to matching
+           the community name (for example, by also checking
+           whether the message originated from a transport address
+           allowed to use a specified community name) MAY include
+           in this value the number of messages which failed the
+           additional check(s).  It is strongly RECOMMENDED that
+
+           the documentation for any security model which is used
+           to authenticate community-based SNMP messages specify
+           the precise conditions that contribute to this value."
+    ::= { snmp 4 }
+
+snmpInBadCommunityUses OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example, SNMPv1) delivered to the SNMP entity which
+           represented an SNMP operation that was not allowed for
+           the SNMP community named in the message.  The precise
+           conditions under which this counter is incremented
+           (if at all) depend on how the SNMP entity implements
+           its access control mechanism and how its applications
+           interact with that access control mechanism.  It is
+           strongly RECOMMENDED that the documentation for any
+           access control mechanism which is used to control access
+           to and visibility of MIB instrumentation specify the
+           precise conditions that contribute to this value."
+    ::= { snmp 5 }
+
+snmpInASNParseErrs OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of ASN.1 or BER errors encountered by
+            the SNMP entity when decoding received SNMP messages."
+    ::= { snmp 6 }
+
+snmpEnableAuthenTraps OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether the SNMP entity is permitted to
+            generate authenticationFailure traps.  The value of this
+            object overrides any configuration information; as such,
+            it provides a means whereby all authenticationFailure
+            traps may be disabled.
+
+            Note that it is strongly recommended that this object
+            be stored in non-volatile memory so that it remains
+            constant across re-initializations of the network
+            management system."
+    ::= { snmp 30 }
+
+snmpSilentDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of Confirmed Class PDUs (such as
+           GetRequest-PDUs, GetNextRequest-PDUs,
+           GetBulkRequest-PDUs, SetRequest-PDUs, and
+           InformRequest-PDUs) delivered to the SNMP entity which
+           were silently dropped because the size of a reply
+           containing an alternate Response Class PDU (such as a
+           Response-PDU) with an empty variable-bindings field
+           was greater than either a local constraint or the
+           maximum message size associated with the originator of
+           the request."
+    ::= { snmp 31 }
+
+snmpProxyDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of Confirmed Class PDUs
+            (such as GetRequest-PDUs, GetNextRequest-PDUs,
+            GetBulkRequest-PDUs, SetRequest-PDUs, and
+            InformRequest-PDUs) delivered to the SNMP entity which
+            were silently dropped because the transmission of
+            the (possibly translated) message to a proxy target
+            failed in a manner (other than a time-out) such that
+            no Response Class PDU (such as a Response-PDU) could
+            be returned."
+    ::= { snmp 32 }
+
+-- information for notifications
+--
+-- a collection of objects which allow the SNMP entity, when
+-- supporting a notification originator application,
+-- to be configured to generate SNMPv2-Trap-PDUs.
+
+snmpTrap       OBJECT IDENTIFIER ::= { snmpMIBObjects 4 }
+
+snmpTrapOID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the notification
+            currently being sent.  This variable occurs as
+            the second varbind in every SNMPv2-Trap-PDU and
+            InformRequest-PDU."
+    ::= { snmpTrap 1 }
+
+--  ::= { snmpTrap 2 }   this OID is obsolete
+
+snmpTrapEnterprise OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the enterprise
+            associated with the trap currently being sent.  When an
+            SNMP proxy agent is mapping an RFC1157 Trap-PDU
+            into a SNMPv2-Trap-PDU, this variable occurs as the
+            last varbind."
+    ::= { snmpTrap 3 }
+
+--  ::= { snmpTrap 4 }   this OID is obsolete
+
+-- well-known traps
+
+snmpTraps      OBJECT IDENTIFIER ::= { snmpMIBObjects 5 }
+
+coldStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A coldStart trap signifies that the SNMP entity,
+            supporting a notification originator application, is
+            reinitializing itself and that its configuration may
+            have been altered."
+    ::= { snmpTraps 1 }
+
+warmStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A warmStart trap signifies that the SNMP entity,
+            supporting a notification originator application,
+            is reinitializing itself such that its configuration
+            is unaltered."
+    ::= { snmpTraps 2 }
+
+-- Note the linkDown NOTIFICATION-TYPE ::= { snmpTraps 3 }
+-- and the linkUp NOTIFICATION-TYPE ::= { snmpTraps 4 }
+-- are defined in RFC 2863 [RFC2863]
+
+authenticationFailure NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "An authenticationFailure trap signifies that the SNMP
+             entity has received a protocol message that is not
+             properly authenticated.  While all implementations
+             of SNMP entities MAY be capable of generating this
+             trap, the snmpEnableAuthenTraps object indicates
+             whether this trap will be generated."
+    ::= { snmpTraps 5 }
+
+-- Note the egpNeighborLoss notification is defined
+-- as { snmpTraps 6 } in RFC 1213
+
+-- the set group
+--
+-- a collection of objects which allow several cooperating
+-- command generator applications to coordinate their use of the
+-- set operation.
+
+snmpSet        OBJECT IDENTIFIER ::= { snmpMIBObjects 6 }
+
+snmpSetSerialNo OBJECT-TYPE
+    SYNTAX     TestAndIncr
+    MAX-ACCESS read-write
+    STATUS     current
+    DESCRIPTION
+            "An advisory lock used to allow several cooperating
+            command generator applications to coordinate their
+            use of the SNMP set operation.
+
+            This object is used for coarse-grain coordination.
+            To achieve fine-grain coordination, one or more similar
+            objects might be defined within each MIB group, as
+            appropriate."
+    ::= { snmpSet 1 }
+
+-- conformance information
+
+snmpMIBConformance
+               OBJECT IDENTIFIER ::= { snmpMIB 2 }
+
+snmpMIBCompliances
+               OBJECT IDENTIFIER ::= { snmpMIBConformance 1 }
+snmpMIBGroups  OBJECT IDENTIFIER ::= { snmpMIBConformance 2 }
+
+-- compliance statements
+
+--    ::= { snmpMIBCompliances 1 }      this OID is obsolete
+snmpBasicCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "The compliance statement for SNMPv2 entities which
+            implement the SNMPv2 MIB.
+
+            This compliance statement is replaced by
+            snmpBasicComplianceRev2."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMPv2 entities which
+            support community-based authentication."
+    ::= { snmpMIBCompliances 2 }
+
+snmpBasicComplianceRev2 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which
+            implement this MIB module."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMP entities which
+            support community-based authentication."
+
+        GROUP   snmpWarmStartNotificationGroup
+        DESCRIPTION
+            "This group is mandatory for an SNMP entity which
+            supports command responder applications, and is
+            able to reinitialize itself such that its
+            configuration is unaltered."
+    ::= { snmpMIBCompliances 3 }
+
+-- units of conformance
+
+--  ::= { snmpMIBGroups 1 }           this OID is obsolete
+--  ::= { snmpMIBGroups 2 }           this OID is obsolete
+--  ::= { snmpMIBGroups 3 }           this OID is obsolete
+
+--  ::= { snmpMIBGroups 4 }           this OID is obsolete
+
+snmpGroup OBJECT-GROUP
+    OBJECTS { snmpInPkts,
+              snmpInBadVersions,
+              snmpInASNParseErrs,
+              snmpSilentDrops,
+              snmpProxyDrops,
+              snmpEnableAuthenTraps }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            and control of an SNMP entity."
+    ::= { snmpMIBGroups 8 }
+
+snmpCommunityGroup OBJECT-GROUP
+    OBJECTS { snmpInBadCommunityNames,
+              snmpInBadCommunityUses }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            of a SNMP entity which supports community-based
+            authentication."
+    ::= { snmpMIBGroups 9 }
+
+snmpSetGroup OBJECT-GROUP
+    OBJECTS { snmpSetSerialNo }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects which allow several cooperating
+            command generator applications to coordinate their
+            use of the set operation."
+    ::= { snmpMIBGroups 5 }
+
+systemGroup OBJECT-GROUP
+    OBJECTS { sysDescr, sysObjectID, sysUpTime,
+              sysContact, sysName, sysLocation,
+              sysServices,
+              sysORLastChange, sysORID,
+              sysORUpTime, sysORDescr }
+    STATUS  current
+    DESCRIPTION
+            "The system group defines objects which are common to all
+            managed systems."
+    ::= { snmpMIBGroups 6 }
+
+snmpBasicNotificationsGroup NOTIFICATION-GROUP
+    NOTIFICATIONS { coldStart, authenticationFailure }
+    STATUS        current
+    DESCRIPTION
+       "The basic notifications implemented by an SNMP entity
+        supporting command responder applications."
+    ::= { snmpMIBGroups 7 }
+
+snmpWarmStartNotificationGroup NOTIFICATION-GROUP
+   NOTIFICATIONS { warmStart }
+   STATUS        current
+   DESCRIPTION
+     "An additional notification for an SNMP entity supporting
+     command responder applications, if it is able to reinitialize
+     itself such that its configuration is unaltered."
+  ::= { snmpMIBGroups 11 }
+
+snmpNotificationGroup OBJECT-GROUP
+    OBJECTS { snmpTrapOID, snmpTrapEnterprise }
+    STATUS  current
+    DESCRIPTION
+            "These objects are required for entities
+            which support notification originator applications."
+    ::= { snmpMIBGroups 12 }
+
+-- definitions in RFC 1213 made obsolete by the inclusion of a
+-- subset of the snmp group in this MIB
+
+snmpOutPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Messages which were
+            passed from the SNMP protocol entity to the
+            transport service."
+    ::= { snmp 2 }
+
+-- { snmp 7 } is not used
+
+snmpInTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `tooBig'."
+    ::= { snmp 8 }
+
+snmpInNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `noSuchName'."
+    ::= { snmp 9 }
+
+snmpInBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `badValue'."
+    ::= { snmp 10 }
+
+snmpInReadOnlys OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number valid SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `readOnly'.  It should
+            be noted that it is a protocol error to generate an
+            SNMP PDU which contains the value `readOnly' in the
+            error-status field, as such this object is provided
+            as a means of detecting incorrect implementations of
+            the SNMP."
+    ::= { snmp 11 }
+
+snmpInGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 12 }
+
+snmpInTotalReqVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            retrieved successfully by the SNMP protocol entity
+            as the result of receiving valid SNMP Get-Request
+            and Get-Next PDUs."
+    ::= { snmp 13 }
+
+snmpInTotalSetVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            altered successfully by the SNMP protocol entity as
+            the result of receiving valid SNMP Set-Request PDUs."
+    ::= { snmp 14 }
+
+snmpInGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been accepted and processed by the SNMP
+            protocol entity."
+    ::= { snmp 15 }
+
+snmpInGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 16 }
+
+snmpInSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 17 }
+
+snmpInGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 18 }
+
+snmpInTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 19 }
+
+snmpOutTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `tooBig.'"
+    ::= { snmp 20 }
+
+snmpOutNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status was `noSuchName'."
+    ::= { snmp 21 }
+
+snmpOutBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `badValue'."
+    ::= { snmp 22 }
+
+-- { snmp 23 } is not used
+
+snmpOutGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 24 }
+
+snmpOutGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 25 }
+
+snmpOutGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 26 }
+
+snmpOutSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 27 }
+
+snmpOutGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 28 }
+
+snmpOutTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 29 }
+
+snmpObsoleteGroup OBJECT-GROUP
+    OBJECTS { snmpOutPkts, snmpInTooBigs, snmpInNoSuchNames,
+              snmpInBadValues, snmpInReadOnlys, snmpInGenErrs,
+              snmpInTotalReqVars, snmpInTotalSetVars,
+              snmpInGetRequests, snmpInGetNexts, snmpInSetRequests,
+              snmpInGetResponses, snmpInTraps, snmpOutTooBigs,
+              snmpOutNoSuchNames, snmpOutBadValues,
+              snmpOutGenErrs, snmpOutGetRequests, snmpOutGetNexts,
+              snmpOutSetRequests, snmpOutGetResponses, snmpOutTraps
+              }
+    STATUS  obsolete
+    DESCRIPTION
+            "A collection of objects from RFC 1213 made obsolete
+            by this MIB module."
+    ::= { snmpMIBGroups 10 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-SMI.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-SMI.txt
new file mode 100644
index 0000000000000000000000000000000000000000..1c01e1dfcdc559a2cca3ee57500760fd8eaeb171
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-SMI.txt
@@ -0,0 +1,344 @@
+SNMPv2-SMI DEFINITIONS ::= BEGIN
+
+-- the path to the root
+
+org            OBJECT IDENTIFIER ::= { iso 3 }  --  "iso" = 1
+dod            OBJECT IDENTIFIER ::= { org 6 }
+internet       OBJECT IDENTIFIER ::= { dod 1 }
+
+directory      OBJECT IDENTIFIER ::= { internet 1 }
+
+mgmt           OBJECT IDENTIFIER ::= { internet 2 }
+mib-2          OBJECT IDENTIFIER ::= { mgmt 1 }
+transmission   OBJECT IDENTIFIER ::= { mib-2 10 }
+
+experimental   OBJECT IDENTIFIER ::= { internet 3 }
+
+private        OBJECT IDENTIFIER ::= { internet 4 }
+enterprises    OBJECT IDENTIFIER ::= { private 1 }
+
+security       OBJECT IDENTIFIER ::= { internet 5 }
+
+snmpV2         OBJECT IDENTIFIER ::= { internet 6 }
+
+-- transport domains
+snmpDomains    OBJECT IDENTIFIER ::= { snmpV2 1 }
+
+-- transport proxies
+snmpProxys     OBJECT IDENTIFIER ::= { snmpV2 2 }
+
+-- module identities
+snmpModules    OBJECT IDENTIFIER ::= { snmpV2 3 }
+
+-- Extended UTCTime, to allow dates with four-digit years
+-- (Note that this definition of ExtUTCTime is not to be IMPORTed
+--  by MIB modules.)
+ExtUTCTime ::= OCTET STRING(SIZE(11 | 13))
+    -- format is YYMMDDHHMMZ or YYYYMMDDHHMMZ
+
+    --   where: YY   - last two digits of year (only years
+    --                 between 1900-1999)
+    --          YYYY - last four digits of the year (any year)
+    --          MM   - month (01 through 12)
+    --          DD   - day of month (01 through 31)
+    --          HH   - hours (00 through 23)
+    --          MM   - minutes (00 through 59)
+    --          Z    - denotes GMT (the ASCII character Z)
+    --
+    -- For example, "9502192015Z" and "199502192015Z" represent
+    -- 8:15pm GMT on 19 February 1995. Years after 1999 must use
+    -- the four digit year format. Years 1900-1999 may use the
+    -- two or four digit format.
+
+-- definitions for information modules
+
+MODULE-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "LAST-UPDATED" value(Update ExtUTCTime)
+                  "ORGANIZATION" Text
+                  "CONTACT-INFO" Text
+                  "DESCRIPTION" Text
+                  RevisionPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    RevisionPart ::=
+                  Revisions
+                | empty
+    Revisions ::=
+                  Revision
+                | Revisions Revision
+    Revision ::=
+                  "REVISION" value(Update ExtUTCTime)
+                  "DESCRIPTION" Text
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+OBJECT-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- names of objects
+-- (Note that these definitions of ObjectName and NotificationName
+--  are not to be IMPORTed by MIB modules.)
+
+ObjectName ::=
+    OBJECT IDENTIFIER
+
+NotificationName ::=
+    OBJECT IDENTIFIER
+
+-- syntax of objects
+
+-- the "base types" defined here are:
+--   3 built-in ASN.1 types: INTEGER, OCTET STRING, OBJECT IDENTIFIER
+--   8 application-defined types: Integer32, IpAddress, Counter32,
+--              Gauge32, Unsigned32, TimeTicks, Opaque, and Counter64
+
+ObjectSyntax ::=
+    CHOICE {
+        simple
+            SimpleSyntax,
+          -- note that SEQUENCEs for conceptual tables and
+          -- rows are not mentioned here...
+
+        application-wide
+            ApplicationSyntax
+    }
+
+-- built-in ASN.1 types
+
+SimpleSyntax ::=
+    CHOICE {
+        -- INTEGERs with a more restrictive range
+        -- may also be used
+        integer-value               -- includes Integer32
+            INTEGER (-2147483648..2147483647),
+        -- OCTET STRINGs with a more restrictive size
+        -- may also be used
+        string-value
+            OCTET STRING (SIZE (0..65535)),
+        objectID-value
+            OBJECT IDENTIFIER
+    }
+
+-- indistinguishable from INTEGER, but never needs more than
+-- 32-bits for a two's complement representation
+Integer32 ::=
+        INTEGER (-2147483648..2147483647)
+
+-- application-wide types
+
+ApplicationSyntax ::=
+    CHOICE {
+        ipAddress-value
+            IpAddress,
+        counter-value
+            Counter32,
+        timeticks-value
+            TimeTicks,
+        arbitrary-value
+            Opaque,
+        big-counter-value
+            Counter64,
+        unsigned-integer-value  -- includes Gauge32
+            Unsigned32
+    }
+
+-- in network-byte order
+
+-- (this is a tagged type for historical reasons)
+IpAddress ::=
+    [APPLICATION 0]
+        IMPLICIT OCTET STRING (SIZE (4))
+
+-- this wraps
+Counter32 ::=
+    [APPLICATION 1]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- this doesn't wrap
+Gauge32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- an unsigned 32-bit quantity
+-- indistinguishable from Gauge32
+Unsigned32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- hundredths of seconds since an epoch
+TimeTicks ::=
+    [APPLICATION 3]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- for backward-compatibility only
+Opaque ::=
+    [APPLICATION 4]
+        IMPLICIT OCTET STRING
+
+-- for counters that wrap in less than one hour with only 32 bits
+Counter64 ::=
+    [APPLICATION 6]
+        IMPLICIT INTEGER (0..18446744073709551615)
+
+-- definition for objects
+
+OBJECT-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "SYNTAX" Syntax
+                  UnitsPart
+                  "MAX-ACCESS" Access
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+                  IndexPart
+                  DefValPart
+
+    VALUE NOTATION ::=
+                  value(VALUE ObjectName)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                   type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+    UnitsPart ::=
+                  "UNITS" Text
+                | empty
+
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    IndexPart ::=
+                  "INDEX"    "{" IndexTypes "}"
+                | "AUGMENTS" "{" Entry      "}"
+                | empty
+    IndexTypes ::=
+                  IndexType
+                | IndexTypes "," IndexType
+    IndexType ::=
+                  "IMPLIED" Index
+                | Index
+
+    Index ::=
+                    -- use the SYNTAX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+    Entry ::=
+                    -- use the INDEX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the type specified in
+                  -- SYNTAX clause of same OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions for notifications
+
+NOTIFICATION-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE NotificationName)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+                | empty
+    Objects ::=
+                  Object
+
+                | Objects "," Object
+    Object ::=
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions of administrative identifiers
+
+zeroDotZero    OBJECT-IDENTITY
+    STATUS     current
+    DESCRIPTION
+            "A value used for null identifiers."
+    ::= { 0 0 }
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-TC.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-TC.txt
new file mode 100644
index 0000000000000000000000000000000000000000..860bf71eeaa9a5322f5223b99b6115e59fcfbcae
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/snmp/mibs/SNMPv2-TC.txt
@@ -0,0 +1,772 @@
+SNMPv2-TC DEFINITIONS ::= BEGIN
+
+IMPORTS
+    TimeTicks         FROM SNMPv2-SMI;
+
+-- definition of textual conventions
+
+TEXTUAL-CONVENTION MACRO ::=
+
+BEGIN
+    TYPE NOTATION ::=
+                  DisplayPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  "SYNTAX" Syntax
+
+    VALUE NOTATION ::=
+                   value(VALUE Syntax)      -- adapted ASN.1
+
+    DisplayPart ::=
+                  "DISPLAY-HINT" Text
+                | empty
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+END
+
+DisplayString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+            "Represents textual information taken from the NVT ASCII
+
+            character set, as defined in pages 4, 10-11 of RFC 854.
+
+            To summarize RFC 854, the NVT ASCII repertoire specifies:
+
+              - the use of character codes 0-127 (decimal)
+
+              - the graphics characters (32-126) are interpreted as
+                US ASCII
+
+              - NUL, LF, CR, BEL, BS, HT, VT and FF have the special
+                meanings specified in RFC 854
+
+              - the other 25 codes have no standard interpretation
+
+              - the sequence 'CR LF' means newline
+
+              - the sequence 'CR NUL' means carriage-return
+
+              - an 'LF' not preceded by a 'CR' means moving to the
+                same column on the next line.
+
+              - the sequence 'CR x' for any x other than LF or NUL is
+                illegal.  (Note that this also means that a string may
+                end with either 'CR LF' or 'CR NUL', but not with CR.)
+
+            Any object defined using this syntax may not exceed 255
+            characters in length."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+PhysAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents media- or physical-level addresses."
+    SYNTAX       OCTET STRING
+
+MacAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents an 802 MAC address represented in the
+            `canonical' order defined by IEEE 802.1a, i.e., as if it
+            were transmitted least significant bit first, even though
+            802.5 (in contrast to other 802.x protocols) requires MAC
+            addresses to be transmitted most significant bit first."
+    SYNTAX       OCTET STRING (SIZE (6))
+
+TruthValue ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a boolean value."
+    SYNTAX       INTEGER { true(1), false(2) }
+
+TestAndIncr ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents integer-valued information used for atomic
+            operations.  When the management protocol is used to specify
+            that an object instance having this syntax is to be
+            modified, the new value supplied via the management protocol
+            must precisely match the value presently held by the
+            instance.  If not, the management protocol set operation
+            fails with an error of `inconsistentValue'.  Otherwise, if
+            the current value is the maximum value of 2^31-1 (2147483647
+            decimal), then the value held by the instance is wrapped to
+            zero; otherwise, the value held by the instance is
+            incremented by one.  (Note that regardless of whether the
+            management protocol set operation succeeds, the variable-
+            binding in the request and response PDUs are identical.)
+
+            The value of the ACCESS clause for objects having this
+            syntax is either `read-write' or `read-create'.  When an
+            instance of a columnar object having this syntax is created,
+            any value may be supplied via the management protocol.
+
+            When the network management portion of the system is re-
+            initialized, the value of every object instance having this
+            syntax must either be incremented from its value prior to
+            the re-initialization, or (if the value prior to the re-
+            initialization is unknown) be set to a pseudo-randomly
+            generated value."
+    SYNTAX       INTEGER (0..2147483647)
+
+AutonomousType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents an independently extensible type identification
+            value.  It may, for example, indicate a particular sub-tree
+            with further MIB definitions, or define a particular type of
+            protocol or hardware."
+    SYNTAX       OBJECT IDENTIFIER
+
+InstancePointer ::= TEXTUAL-CONVENTION
+    STATUS       obsolete
+    DESCRIPTION
+            "A pointer to either a specific instance of a MIB object or
+            a conceptual row of a MIB table in the managed device.  In
+            the latter case, by convention, it is the name of the
+            particular instance of the first accessible columnar object
+            in the conceptual row.
+
+            The two uses of this textual convention are replaced by
+            VariablePointer and RowPointer, respectively."
+    SYNTAX       OBJECT IDENTIFIER
+
+VariablePointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A pointer to a specific object instance.  For example,
+            sysContact.0 or ifInOctets.3."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowPointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a pointer to a conceptual row.  The value is the
+            name of the instance of the first accessible columnar object
+            in the conceptual row.
+
+            For example, ifIndex.3 would point to the 3rd row in the
+            ifTable (note that if ifIndex were not-accessible, then
+            ifDescr.3 would be used instead)."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowStatus ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The RowStatus textual convention is used to manage the
+            creation and deletion of conceptual rows, and is used as the
+            value of the SYNTAX clause for the status column of a
+            conceptual row (as described in Section 7.7.1 of [2].)
+
+            The status column has six defined values:
+
+                 - `active', which indicates that the conceptual row is
+                 available for use by the managed device;
+
+                 - `notInService', which indicates that the conceptual
+                 row exists in the agent, but is unavailable for use by
+                 the managed device (see NOTE below); 'notInService' has
+                 no implication regarding the internal consistency of
+                 the row, availability of resources, or consistency with
+                 the current state of the managed device;
+
+                 - `notReady', which indicates that the conceptual row
+                 exists in the agent, but is missing information
+                 necessary in order to be available for use by the
+                 managed device (i.e., one or more required columns in
+                 the conceptual row have not been instanciated);
+
+                 - `createAndGo', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row and to have its status automatically set
+                 to active, making it available for use by the managed
+                 device;
+
+                 - `createAndWait', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row (but not make it available for use by
+                 the managed device); and,
+                 - `destroy', which is supplied by a management station
+                 wishing to delete all of the instances associated with
+                 an existing conceptual row.
+
+            Whereas five of the six values (all except `notReady') may
+            be specified in a management protocol set operation, only
+            three values will be returned in response to a management
+            protocol retrieval operation:  `notReady', `notInService' or
+            `active'.  That is, when queried, an existing conceptual row
+            has only three states:  it is either available for use by
+            the managed device (the status column has value `active');
+            it is not available for use by the managed device, though
+            the agent has sufficient information to attempt to make it
+            so (the status column has value `notInService'); or, it is
+            not available for use by the managed device, and an attempt
+            to make it so would fail because the agent has insufficient
+            information (the state column has value `notReady').
+
+                                     NOTE WELL
+
+                 This textual convention may be used for a MIB table,
+                 irrespective of whether the values of that table's
+                 conceptual rows are able to be modified while it is
+                 active, or whether its conceptual rows must be taken
+                 out of service in order to be modified.  That is, it is
+                 the responsibility of the DESCRIPTION clause of the
+                 status column to specify whether the status column must
+                 not be `active' in order for the value of some other
+                 column of the same conceptual row to be modified.  If
+                 such a specification is made, affected columns may be
+                 changed by an SNMP set PDU if the RowStatus would not
+                 be equal to `active' either immediately before or after
+                 processing the PDU.  In other words, if the PDU also
+                 contained a varbind that would change the RowStatus
+                 value, the column in question may be changed if the
+                 RowStatus was not equal to `active' as the PDU was
+                 received, or if the varbind sets the status to a value
+                 other than 'active'.
+
+            Also note that whenever any elements of a row exist, the
+            RowStatus column must also exist.
+
+            To summarize the effect of having a conceptual row with a
+            status column having a SYNTAX clause value of RowStatus,
+            consider the following state diagram:
+
+                                         STATE
+              +--------------+-----------+-------------+-------------
+              |      A       |     B     |      C      |      D
+              |              |status col.|status column|
+              |status column |    is     |      is     |status column
+    ACTION    |does not exist|  notReady | notInService|  is active
+--------------+--------------+-----------+-------------+-------------
+set status    |noError    ->D|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndGo   |inconsistent- |           |             |
+              |         Value|           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |noError  see 1|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndWait |wrongValue    |           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError
+column to     |         Value|   entValue|             |
+active        |              |           |             |
+              |              |     or    |             |
+              |              |           |             |
+              |              |see 2   ->D|see 8     ->D|          ->D
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError   ->C
+column to     |         Value|   entValue|             |
+notInService  |              |           |             |
+              |              |     or    |             |      or
+              |              |           |             |
+              |              |see 3   ->C|          ->C|see 6
+--------------+--------------+-----------+-------------+-------------
+set status    |noError       |noError    |noError      |noError   ->A
+column to     |              |           |             |      or
+destroy       |           ->A|        ->A|          ->A|see 7
+--------------+--------------+-----------+-------------+-------------
+set any other |see 4         |noError    |noError      |see 5
+column to some|              |           |             |
+value         |              |      see 1|          ->C|          ->D
+--------------+--------------+-----------+-------------+-------------
+
+            (1) goto B or C, depending on information available to the
+            agent.
+
+            (2) if other variable bindings included in the same PDU,
+            provide values for all columns which are missing but
+            required, and all columns have acceptable values, then
+            return noError and goto D.
+
+            (3) if other variable bindings included in the same PDU,
+            provide legal values for all columns which are missing but
+            required, then return noError and goto C.
+
+            (4) at the discretion of the agent, the return value may be
+            either:
+
+                 inconsistentName:  because the agent does not choose to
+                 create such an instance when the corresponding
+                 RowStatus instance does not exist, or
+
+                 inconsistentValue:  if the supplied value is
+                 inconsistent with the state of some other MIB object's
+                 value, or
+
+                 noError: because the agent chooses to create the
+                 instance.
+
+            If noError is returned, then the instance of the status
+            column must also be created, and the new state is B or C,
+            depending on the information available to the agent.  If
+            inconsistentName or inconsistentValue is returned, the row
+            remains in state A.
+
+            (5) depending on the MIB definition for the column/table,
+            either noError or inconsistentValue may be returned.
+
+            (6) the return value can indicate one of the following
+            errors:
+
+                 wrongValue: because the agent does not support
+                 notInService (e.g., an agent which does not support
+                 createAndWait), or
+
+                 inconsistentValue: because the agent is unable to take
+                 the row out of service at this time, perhaps because it
+                 is in use and cannot be de-activated.
+
+            (7) the return value can indicate the following error:
+
+                 inconsistentValue: because the agent is unable to
+                 remove the row at this time, perhaps because it is in
+                 use and cannot be de-activated.
+
+            (8) the transition to D can fail, e.g., if the values of the
+            conceptual row are inconsistent, then the error code would
+            be inconsistentValue.
+
+            NOTE: Other processing of (this and other varbinds of) the
+            set request may result in a response other than noError
+            being returned, e.g., wrongValue, noCreation, etc.
+
+                              Conceptual Row Creation
+
+            There are four potential interactions when creating a
+            conceptual row:  selecting an instance-identifier which is
+            not in use; creating the conceptual row; initializing any
+            objects for which the agent does not supply a default; and,
+            making the conceptual row available for use by the managed
+            device.
+
+            Interaction 1: Selecting an Instance-Identifier
+
+            The algorithm used to select an instance-identifier varies
+            for each conceptual row.  In some cases, the instance-
+            identifier is semantically significant, e.g., the
+            destination address of a route, and a management station
+            selects the instance-identifier according to the semantics.
+
+            In other cases, the instance-identifier is used solely to
+            distinguish conceptual rows, and a management station
+            without specific knowledge of the conceptual row might
+            examine the instances present in order to determine an
+            unused instance-identifier.  (This approach may be used, but
+            it is often highly sub-optimal; however, it is also a
+            questionable practice for a naive management station to
+            attempt conceptual row creation.)
+
+            Alternately, the MIB module which defines the conceptual row
+            might provide one or more objects which provide assistance
+            in determining an unused instance-identifier.  For example,
+            if the conceptual row is indexed by an integer-value, then
+            an object having an integer-valued SYNTAX clause might be
+            defined for such a purpose, allowing a management station to
+            issue a management protocol retrieval operation.  In order
+            to avoid unnecessary collisions between competing management
+            stations, `adjacent' retrievals of this object should be
+            different.
+
+            Finally, the management station could select a pseudo-random
+            number to use as the index.  In the event that this index
+
+            was already in use and an inconsistentValue was returned in
+            response to the management protocol set operation, the
+            management station should simply select a new pseudo-random
+            number and retry the operation.
+
+            A MIB designer should choose between the two latter
+            algorithms based on the size of the table (and therefore the
+            efficiency of each algorithm).  For tables in which a large
+            number of entries are expected, it is recommended that a MIB
+            object be defined that returns an acceptable index for
+            creation.  For tables with small numbers of entries, it is
+            recommended that the latter pseudo-random index mechanism be
+            used.
+
+            Interaction 2: Creating the Conceptual Row
+
+            Once an unused instance-identifier has been selected, the
+            management station determines if it wishes to create and
+            activate the conceptual row in one transaction or in a
+            negotiated set of interactions.
+
+            Interaction 2a: Creating and Activating the Conceptual Row
+
+            The management station must first determine the column
+            requirements, i.e., it must determine those columns for
+            which it must or must not provide values.  Depending on the
+            complexity of the table and the management station's
+            knowledge of the agent's capabilities, this determination
+            can be made locally by the management station.  Alternately,
+            the management station issues a management protocol get
+            operation to examine all columns in the conceptual row that
+            it wishes to create.  In response, for each column, there
+            are three possible outcomes:
+
+                 - a value is returned, indicating that some other
+                 management station has already created this conceptual
+                 row.  We return to interaction 1.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. For those
+                 columns to which the agent provides read-create access,
+                 the `noSuchInstance' exception tells the management
+                 station that it should supply a value for this column
+                 when the conceptual row is to be created.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            Once the column requirements have been determined, a
+            management protocol set operation is accordingly issued.
+            This operation also sets the new instance of the status
+            column to `createAndGo'.
+
+            When the agent processes the set operation, it verifies that
+            it has sufficient information to make the conceptual row
+            available for use by the managed device.  The information
+            available to the agent is provided by two sources:  the
+            management protocol set operation which creates the
+            conceptual row, and, implementation-specific defaults
+            supplied by the agent (note that an agent must provide
+            implementation-specific defaults for at least those objects
+            which it implements as read-only).  If there is sufficient
+            information available, then the conceptual row is created, a
+            `noError' response is returned, the status column is set to
+            `active', and no further interactions are necessary (i.e.,
+            interactions 3 and 4 are skipped).  If there is insufficient
+            information, then the conceptual row is not created, and the
+            set operation fails with an error of `inconsistentValue'.
+            On this error, the management station can issue a management
+            protocol retrieval operation to determine if this was
+            because it failed to specify a value for a required column,
+            or, because the selected instance of the status column
+            already existed.  In the latter case, we return to
+            interaction 1.  In the former case, the management station
+            can re-issue the set operation with the additional
+            information, or begin interaction 2 again using
+            `createAndWait' in order to negotiate creation of the
+            conceptual row.
+
+                                     NOTE WELL
+
+                 Regardless of the method used to determine the column
+                 requirements, it is possible that the management
+                 station might deem a column necessary when, in fact,
+                 the agent will not allow that particular columnar
+                 instance to be created or written.  In this case, the
+                 management protocol set operation will fail with an
+                 error such as `noCreation' or `notWritable'.  In this
+                 case, the management station decides whether it needs
+                 to be able to set a value for that particular columnar
+                 instance.  If not, the management station re-issues the
+                 management protocol set operation, but without setting
+                 a value for that particular columnar instance;
+                 otherwise, the management station aborts the row
+                 creation algorithm.
+
+            Interaction 2b: Negotiating the Creation of the Conceptual
+            Row
+
+            The management station issues a management protocol set
+            operation which sets the desired instance of the status
+            column to `createAndWait'.  If the agent is unwilling to
+            process a request of this sort, the set operation fails with
+            an error of `wrongValue'.  (As a consequence, such an agent
+            must be prepared to accept a single management protocol set
+            operation, i.e., interaction 2a above, containing all of the
+            columns indicated by its column requirements.)  Otherwise,
+            the conceptual row is created, a `noError' response is
+            returned, and the status column is immediately set to either
+            `notInService' or `notReady', depending on whether it has
+            sufficient information to (attempt to) make the conceptual
+            row available for use by the managed device.  If there is
+            sufficient information available, then the status column is
+            set to `notInService'; otherwise, if there is insufficient
+            information, then the status column is set to `notReady'.
+            Regardless, we proceed to interaction 3.
+
+            Interaction 3: Initializing non-defaulted Objects
+
+            The management station must now determine the column
+            requirements.  It issues a management protocol get operation
+            to examine all columns in the created conceptual row.  In
+            the response, for each column, there are three possible
+            outcomes:
+
+                 - a value is returned, indicating that the agent
+                 implements the object-type associated with this column
+                 and had sufficient information to provide a value.  For
+                 those columns to which the agent provides read-create
+                 access (and for which the agent allows their values to
+                 be changed after their creation), a value return tells
+                 the management station that it may issue additional
+                 management protocol set operations, if it desires, in
+                 order to change the value associated with this column.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. However,
+                 the agent does not have sufficient information to
+                 provide a value, and until a value is provided, the
+                 conceptual row may not be made available for use by the
+                 managed device.  For those columns to which the agent
+                 provides read-create access, the `noSuchInstance'
+                 exception tells the management station that it must
+                 issue additional management protocol set operations, in
+                 order to provide a value associated with this column.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            If the value associated with the status column is
+            `notReady', then the management station must first deal with
+            all `noSuchInstance' columns, if any.  Having done so, the
+            value of the status column becomes `notInService', and we
+            proceed to interaction 4.
+
+            Interaction 4: Making the Conceptual Row Available
+
+            Once the management station is satisfied with the values
+            associated with the columns of the conceptual row, it issues
+            a management protocol set operation to set the status column
+            to `active'.  If the agent has sufficient information to
+            make the conceptual row available for use by the managed
+            device, the management protocol set operation succeeds (a
+            `noError' response is returned).  Otherwise, the management
+            protocol set operation fails with an error of
+            `inconsistentValue'.
+
+                                     NOTE WELL
+
+                 A conceptual row having a status column with value
+                 `notInService' or `notReady' is unavailable to the
+                 managed device.  As such, it is possible for the
+                 managed device to create its own instances during the
+                 time between the management protocol set operation
+                 which sets the status column to `createAndWait' and the
+                 management protocol set operation which sets the status
+                 column to `active'.  In this case, when the management
+                 protocol set operation is issued to set the status
+                 column to `active', the values held in the agent
+                 supersede those used by the managed device.
+
+            If the management station is prevented from setting the
+            status column to `active' (e.g., due to management station
+            or network failure) the conceptual row will be left in the
+            `notInService' or `notReady' state, consuming resources
+            indefinitely.  The agent must detect conceptual rows that
+            have been in either state for an abnormally long period of
+            time and remove them.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate what an
+            abnormally long period of time would be.  This period of
+            time should be long enough to allow for human response time
+            (including `think time') between the creation of the
+            conceptual row and the setting of the status to `active'.
+            In the absence of such information in the DESCRIPTION
+            clause, it is suggested that this period be approximately 5
+            minutes in length.  This removal action applies not only to
+            newly-created rows, but also to previously active rows which
+            are set to, and left in, the notInService state for a
+            prolonged period exceeding that which is considered normal
+            for such a conceptual row.
+
+                             Conceptual Row Suspension
+
+            When a conceptual row is `active', the management station
+            may issue a management protocol set operation which sets the
+            instance of the status column to `notInService'.  If the
+            agent is unwilling to do so, the set operation fails with an
+            error of `wrongValue' or `inconsistentValue'.  Otherwise,
+            the conceptual row is taken out of service, and a `noError'
+            response is returned.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate under
+            what circumstances the status column should be taken out of
+            service (e.g., in order for the value of some other column
+            of the same conceptual row to be modified).
+
+                              Conceptual Row Deletion
+
+            For deletion of conceptual rows, a management protocol set
+            operation is issued which sets the instance of the status
+            column to `destroy'.  This request may be made regardless of
+            the current value of the status column (e.g., it is possible
+            to delete conceptual rows which are either `notReady',
+            `notInService' or `active'.)  If the operation succeeds,
+            then all instances associated with the conceptual row are
+            immediately removed."
+    SYNTAX       INTEGER {
+                     -- the following two values are states:
+                     -- these values may be read or written
+                     active(1),
+                     notInService(2),
+                     -- the following value is a state:
+                     -- this value may be read, but not written
+                     notReady(3),
+                     -- the following three values are
+                     -- actions: these values may be written,
+                     --   but are never read
+                     createAndGo(4),
+                     createAndWait(5),
+                     destroy(6)
+                 }
+
+TimeStamp ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The value of the sysUpTime object at which a specific
+            occurrence happened.  The specific occurrence must be
+
+            defined in the description of any object defined using this
+            type.
+
+            If sysUpTime is reset to zero as a result of a re-
+            initialization of the network management (sub)system, then
+            the values of all TimeStamp objects are also reset.
+            However, after approximately 497 days without a re-
+            initialization, the sysUpTime object will reach 2^^32-1 and
+            then increment around to zero; in this case, existing values
+            of TimeStamp objects do not change.  This can lead to
+            ambiguities in the value of TimeStamp objects."
+    SYNTAX       TimeTicks
+
+TimeInterval ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A period of time, measured in units of 0.01 seconds."
+    SYNTAX       INTEGER (0..2147483647)
+
+DateAndTime ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2d-1d-1d,1d:1d:1d.1d,1a1d:1d"
+    STATUS       current
+    DESCRIPTION
+            "A date-time specification.
+
+            field  octets  contents                  range
+            -----  ------  --------                  -----
+              1      1-2   year*                     0..65536
+              2       3    month                     1..12
+              3       4    day                       1..31
+              4       5    hour                      0..23
+              5       6    minutes                   0..59
+              6       7    seconds                   0..60
+                           (use 60 for leap-second)
+              7       8    deci-seconds              0..9
+              8       9    direction from UTC        '+' / '-'
+              9      10    hours from UTC*           0..13
+             10      11    minutes from UTC          0..59
+
+            * Notes:
+            - the value of year is in network-byte order
+            - daylight saving time in New Zealand is +13
+
+            For example, Tuesday May 26, 1992 at 1:30:15 PM EDT would be
+            displayed as:
+
+                             1992-5-26,13:30:15.0,-4:0
+
+            Note that if only local time is known, then timezone
+            information (fields 8-10) is not present."
+    SYNTAX       OCTET STRING (SIZE (8 | 11))
+
+StorageType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Describes the memory realization of a conceptual row.  A
+            row which is volatile(2) is lost upon reboot.  A row which
+            is either nonVolatile(3), permanent(4) or readOnly(5), is
+            backed up by stable storage.  A row which is permanent(4)
+            can be changed but not deleted.  A row which is readOnly(5)
+            cannot be changed nor deleted.
+
+            If the value of an object with this syntax is either
+            permanent(4) or readOnly(5), it cannot be written.
+            Conversely, if the value is either other(1), volatile(2) or
+            nonVolatile(3), it cannot be modified to be permanent(4) or
+            readOnly(5).  (All illegal modifications result in a
+            'wrongValue' error.)
+
+            Every usage of this textual convention is required to
+            specify the columnar objects which a permanent(4) row must
+            at a minimum allow to be writable."
+    SYNTAX       INTEGER {
+                     other(1),       -- eh?
+                     volatile(2),    -- e.g., in RAM
+                     nonVolatile(3), -- e.g., in NVRAM
+                     permanent(4),   -- e.g., partially in ROM
+                     readOnly(5)     -- e.g., completely in ROM
+                 }
+
+TDomain ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a kind of transport service.
+
+          Some possible values, such as snmpUDPDomain, are defined in
+          the SNMPv2-TM MIB module.  Other possible values are defined
+          in other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OBJECT IDENTIFIER
+
+TAddress ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a transport service address.
+
+          A TAddress value is always interpreted within the context of a
+          TDomain value.  Thus, each definition of a TDomain value must
+          be accompanied by a definition of a textual convention for use
+          with that TDomain.  Some possible textual conventions, such as
+          SnmpUDPAddress for snmpUDPDomain, are defined in the SNMPv2-TM
+          MIB module.  Other possible textual conventions are defined in
+          other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+END
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
new file mode 100644
index 0000000000000000000000000000000000000000..a2aef96ec04b3c6f2e24906331d53467d7be8033
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
@@ -0,0 +1,63 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "snmpexporter.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "snmpexporter.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "snmpexporter.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "snmpexporter.labels" -}}
+helm.sh/chart: {{ include "snmpexporter.chart" . }}
+{{ include "snmpexporter.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "snmpexporter.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "snmpexporter.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "snmpexporter.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "snmpexporter.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..fcf2f18159a0b6ee431b4bcffc8c02817bd79ae0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
@@ -0,0 +1,20071 @@
+
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+  snmp.yml: |-
+    # WARNING: This file was auto-generated using snmp_exporter generator, manual changes will be lost.
+    apcups:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.4.1.318.1.1.1.12
+      - 1.3.6.1.4.1.318.1.1.1.2
+      - 1.3.6.1.4.1.318.1.1.1.3
+      - 1.3.6.1.4.1.318.1.1.1.4
+      - 1.3.6.1.4.1.318.1.1.1.7.2
+      - 1.3.6.1.4.1.318.1.1.10.2.3.2
+      - 1.3.6.1.4.1.318.1.1.26.8.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.318.1.1.1.8.1.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: upsOutletGroupStatusTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.1.1
+      - name: upsOutletGroupStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusGroupState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupStatusOn
+          2: upsOutletGroupStatusOff
+          3: upsOutletGroupStatusUnknown
+      - name: upsOutletGroupStatusCommandPending
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        type: gauge
+        help: Getting this variable will return the command pending state of the outlet
+          group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupCommandPending
+          2: upsOutletGroupNoCommandPending
+      - name: upsOutletGroupStatusOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupStatusGroupFullState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        type: DisplayString
+        help: An ASCII string containing the 32 flags representing the current state(s)
+          of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupConfigTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.2.1
+      - name: upsOutletGroupConfigIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        type: DisplayString
+        help: The name of the outlet group. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOnDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering on when
+          the delayed on, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering off when
+          the delayed off, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigRebootDuration
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        type: gauge
+        help: During a reboot sequence, power is turned off and then back on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigMinReturnRuntime
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        type: gauge
+        help: In an Outlet Group shutdown sequence, the Outlet Group cycles power off
+          then on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupConfigLoadShedControlSkipOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        type: gauge
+        help: Configures whether the outlet group's off delay setting (upsOutletGroupConfigPowerOffDelay)
+          will be used in a load shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigSkipOffDelay
+          2: upsOutletGroupConfigUseOffDelay
+      - name: upsOutletGroupConfigLoadShedControlAutoRestart
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        type: gauge
+        help: Configures whether the outlet group will automatically restart after a load
+          shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigAutoRestart
+          2: upsOutletGroupConfigManualRestart
+      - name: upsOutletGroupConfigLoadShedControlTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) after the
+          UPS's time on battery has exceeded the upsOutletGroupConfigLoadShedTimeOnBattery
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableTimeOnBatteryLoadShed
+          2: upsOutletGroupConfigEnableTimeOnBatteryLoadShed
+      - name: upsOutletGroupConfigLoadShedControlRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is on battery and the remaining runtime is less than the upsOutletGroupConfigLoadShedRuntimeRemaining
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableRuntimeRemainingLoadShed
+          2: upsOutletGroupConfigEnableRuntimeRemainingLoadShed
+      - name: upsOutletGroupConfigLoadShedControlInOverload
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is in an overload condition - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableInOverloadLoadShed
+          2: upsOutletGroupConfigEnableInOverloadLoadShed
+      - name: upsOutletGroupConfigLoadShedTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        type: gauge
+        help: When the UPS has been on battery for more time than this value, the outlet
+          group will turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlTimeOnBattery
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigLoadShedRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        type: gauge
+        help: When the runtime remaining is less than this value, the outlet group will
+          turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlRuntimeRemaining
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupControlTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.3.1
+      - name: upsOutletGroupControlIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlCommand
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupImmediateOn
+          2: upsOutletGroupImmediateOff
+          3: upsOutletGroupImmediateRebootWithOrWithoutAC
+          4: upsOutletGroupDelayedOn
+          5: upsOutletGroupDelayedOff
+          6: upsOutletGroupDelayedRebootWithOrWithoutAC
+          7: upsOutletGroupCancelPendingCommand
+          8: upsOutletGroupControlUnknown
+          9: upsOutletGroupImmediateRebootShutdown
+          10: upsOutletGroupDelayedRebootShutdown
+      - name: upsOutletGroupControlOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsBasicBatteryStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.1
+        type: gauge
+        help: The status of the UPS batteries - 1.3.6.1.4.1.318.1.1.1.2.1.1
+        enum_values:
+          1: unknown
+          2: batteryNormal
+          3: batteryLow
+          4: batteryInFaultCondition
+      - name: upsBasicBatteryTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.2
+        type: gauge
+        help: The elapsed time since the UPS has switched to battery power. - 1.3.6.1.4.1.318.1.1.1.2.1.2
+      - name: upsBasicBatteryLastReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.3
+        type: DisplayString
+        help: The date when the UPS system's batteries were last replaced in mm/dd/yy
+          (or yyyy) format - 1.3.6.1.4.1.318.1.1.1.2.1.3
+      - name: upsAdvBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.1
+        type: gauge
+        help: The remaining battery capacity expressed in percent of full capacity. -
+          1.3.6.1.4.1.318.1.1.1.2.2.1
+      - name: upsAdvBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.2
+        type: gauge
+        help: The current internal UPS temperature expressed in Celsius - 1.3.6.1.4.1.318.1.1.1.2.2.2
+      - name: upsAdvBatteryRunTimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.3
+        type: gauge
+        help: The UPS battery run time remaining before battery exhaustion. - 1.3.6.1.4.1.318.1.1.1.2.2.3
+      - name: upsAdvBatteryReplaceIndicator
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.4
+        type: gauge
+        help: Indicates whether the UPS batteries need replacing. - 1.3.6.1.4.1.318.1.1.1.2.2.4
+        enum_values:
+          1: noBatteryNeedsReplacing
+          2: batteryNeedsReplacing
+      - name: upsAdvBatteryNumOfBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.5
+        type: gauge
+        help: The number of external battery packs connected to the UPS - 1.3.6.1.4.1.318.1.1.1.2.2.5
+      - name: upsAdvBatteryNumOfBadBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.6
+        type: gauge
+        help: The number of external battery packs connected to the UPS that are defective
+          - 1.3.6.1.4.1.318.1.1.1.2.2.6
+      - name: upsAdvBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.7
+        type: gauge
+        help: The nominal battery voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.7
+      - name: upsAdvBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.8
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.8
+      - name: upsAdvBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.9
+        type: gauge
+        help: The battery current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.9
+      - name: upsAdvTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.10
+        type: gauge
+        help: The total DC current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.10
+      - name: upsAdvBatteryFullCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.11
+        type: gauge
+        help: The full chargeable capacity of the battery which is expressed in percentage.
+          - 1.3.6.1.4.1.318.1.1.1.2.2.11
+      - name: upsAdvBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        type: gauge
+        help: The selected Battery Voltage Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        type: gauge
+        help: The selected Battery Current Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvTotalFrameDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        type: gauge
+        help: The Total DC Current of battery in Amperes. - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        type: gauge
+        help: The battery frame identifier. - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        type: gauge
+        help: The selected Battery current polarity - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        type: gauge
+        help: The Battery current measured in Amperes - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryEstimatedChargeTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.15
+        type: gauge
+        help: The estimated remaining time required to charge the UPS to a full state
+          of charge. - 1.3.6.1.4.1.318.1.1.1.2.2.15
+      - name: upsAdvBatteryPower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.16
+        type: gauge
+        help: The measured battery power in kW. - 1.3.6.1.4.1.318.1.1.1.2.2.16
+      - name: upsAdvBatteryChargerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.17
+        type: EnumAsStateSet
+        help: The status of the battery charger - 1.3.6.1.4.1.318.1.1.1.2.2.17
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+          4: floatCharging
+          5: boostCharging
+          6: resting
+          7: notCharging
+          8: equalizationCharging
+          9: testInProgress
+          10: cyclicFloatCharging
+      - name: upsAdvBatteryInternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.19
+        type: DisplayString
+        help: The SKU of the internal battery. - 1.3.6.1.4.1.318.1.1.1.2.2.19
+      - name: upsAdvBatteryExternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.20
+        type: DisplayString
+        help: The SKU of the external battery. - 1.3.6.1.4.1.318.1.1.1.2.2.20
+      - name: upsAdvBatteryRecommendedReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.21
+        type: DisplayString
+        help: The recommended replacement date for the battery based on the UPS internal
+          battery life algorithm. - 1.3.6.1.4.1.318.1.1.1.2.2.21
+      - name: upsAdvBatteryNominalBackupTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.22
+        type: gauge
+        help: Defines the runtime of the user supplied battery in minutes, when battery
+          is new. - 1.3.6.1.4.1.318.1.1.1.2.2.22
+      - name: upsAdvBatteryCondition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.23
+        type: EnumAsStateSet
+        help: Health of the battries based on the battery test. - 1.3.6.1.4.1.318.1.1.1.2.2.23
+        enum_values:
+          1: unknown
+          2: ok
+          3: weak
+          4: poor
+      - name: upsAdvBatteryChargingCurrentRestricted
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.24
+        type: EnumAsStateSet
+        help: Indicates whether battery charging current is restricted or not - 1.3.6.1.4.1.318.1.1.1.2.2.24
+        enum_values:
+          1: "yes"
+          2: "no"
+      - name: upsAdvBatteryTotalCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.25
+        type: gauge
+        help: The actual available battery capacity of the system expressed in ampere
+          hours (Ah) - 1.3.6.1.4.1.318.1.1.1.2.2.25
+      - name: upsAdvBatteryFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.26
+        type: gauge
+        help: If battery system has one common fuse for the battery system, the status
+          is given by this value - 1.3.6.1.4.1.318.1.1.1.2.2.26
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsAdvBatteryBreakerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.27
+        type: gauge
+        help: The value indicates the aggregated status of the battery breakers in the
+          system - 1.3.6.1.4.1.318.1.1.1.2.2.27
+        enum_values:
+          1: disconnected
+          2: closed
+          3: notPresent
+      - name: upsAdvBatteryWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.28
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.2.28
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsHighPrecBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.1
+        type: gauge
+        help: The remaining battery capacity expressed in tenths of percent of full capacity.
+          - 1.3.6.1.4.1.318.1.1.1.2.3.1
+      - name: upsHighPrecBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.2
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.2
+      - name: upsHighPrecBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.3
+        type: gauge
+        help: The nominal battery voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.3
+      - name: upsHighPrecBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.4
+        type: gauge
+        help: The actual battery bus voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.4
+      - name: upsHighPrecBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.5
+        type: gauge
+        help: The battery current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.5
+      - name: upsHighPrecTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.6
+        type: gauge
+        help: The total DC current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.6
+      - name: upsHighPrecBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        type: gauge
+        help: The selected Battery Voltage polarity - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        type: gauge
+        help: The actual battery bus voltage expressed as tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecTotalDCFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        type: gauge
+        help: The total DC current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        type: gauge
+        help: The Battery current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+      - name: upsHighPrecBatteryPackIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryCartridgeIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        type: gauge
+        help: The battery cartridge identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackSerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        type: OctetString
+        help: The battery cartridge health - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        type: DisplayString
+        help: The battery cartridge estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        type: DisplayString
+        help: The battery cartridge install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        type: OctetString
+        help: The battery cartridge status - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+      - name: upsHighPrecBatteryPackOnlyIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlySerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        type: OctetString
+        help: The battery pack health - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        type: DisplayString
+        help: The battery pack estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        type: DisplayString
+        help: The battery pack install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.11
+        type: OctetString
+        help: The battery health - 1.3.6.1.4.1.318.1.1.1.2.3.11
+      - name: upsHighPrecActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.12
+        type: gauge
+        help: Active Power of Battery in tenths of kW - 1.3.6.1.4.1.318.1.1.1.2.3.12
+      - name: upsHighPrecExtdBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.13
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.13
+      - name: upsBatteryNumberOfCabinets
+        oid: 1.3.6.1.4.1.318.1.1.1.2.4
+        type: gauge
+        help: The value indicates the number of battery cabinets in total, internal and
+          external - 1.3.6.1.4.1.318.1.1.1.2.4
+      - name: upsBatteryCabinetIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        type: gauge
+        help: The Battery Cabinet identifier - 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        type: gauge
+        help: The identification number for the actual battery cabinet in the system -
+          1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsBatteryCabinetVoltagePolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        type: gauge
+        help: The battery voltage - 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetVoltagePolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        type: gauge
+        help: The voltage for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        type: gauge
+        help: The battery current - 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        type: gauge
+        help: The current for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        type: gauge
+        help: The measured temperature of the battery cabinet in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        type: gauge
+        help: The highest temperature measured for the battery in the battery cabinet
+          in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        type: gauge
+        help: The lowest temperature measured for the battery in the battery cabinet in
+          tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        type: gauge
+        help: The average temperature for all the battery sensors in the battery cabinet
+          and for the battery strings, if battery strings are present - 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetFuse
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        type: gauge
+        help: If the battery cabinet has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabinetBreaker
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        type: gauge
+        help: The value indicates the battery cabinet breaker status - 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: noBreaker
+          2: unknown
+          3: breakerOpen
+          4: breakerClosed
+      - name: upsBatteryCabinetNumberOfStrings
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        type: gauge
+        help: The number of battery strings in the battery cabinet - 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfVerticalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        type: gauge
+        help: The number of vertical levels or shelves for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfHorizontalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        type: gauge
+        help: The number of horizontal positions for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabStringIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        type: gauge
+        help: The battery cabinet string identifier - 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCabReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        type: gauge
+        help: Reference to the global battery cabinet index where the battery string is
+          placed. - 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        type: gauge
+        help: Local battery string identification index in the actual battery cabinet
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        type: gauge
+        help: The current in a battery string or battery halfstring, in tenths of Amps.
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        type: gauge
+        help: Temperature of the battery string or the average of the aggregated temperature
+          of each battery block/module (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        type: gauge
+        help: The actual highest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        type: gauge
+        help: The actual lowest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        type: gauge
+        help: If the battery string has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabStringNumberOfBlocks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        type: gauge
+        help: The number of battery blocks/modules in a battery string - 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabBlockIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        type: gauge
+        help: The battery cabinet block identifier - 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockStringReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        type: gauge
+        help: Reference to the specific global battery string index - 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery string
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockPresent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        type: gauge
+        help: Value indicates if battery block/module is present in the system - 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: present
+          2: notPresent
+          3: notAvailable
+      - name: upsBatteryCabBlockType
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        type: DisplayString
+        help: Text string value, showing the vendor and model of the battery in the battery
+          block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        type: gauge
+        help: The temperature for the battery block/module in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        type: gauge
+        help: If the battery module has a fuse, the status is given by this value - 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabBlockVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        type: gauge
+        help: The voltage of the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockNumberOfCells
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        type: gauge
+        help: The number of cells in the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockVerticalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        type: gauge
+        help: The vertical position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockHorizontalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        type: gauge
+        help: The horizontal position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        type: gauge
+        help: The battery block cell identifier - 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        type: gauge
+        help: Reference to the specific global battery block/module index. - 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery block
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        type: gauge
+        help: The measured battery cell voltage - 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        type: gauge
+        help: The temperature for the battery cell in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBasicInputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.3.1.1
+        type: gauge
+        help: The current AC input phase. - 1.3.6.1.4.1.318.1.1.1.3.1.1
+      - name: upsAdvInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.1
+        type: gauge
+        help: The current utility line voltage in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.1
+      - name: upsAdvInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.2
+        type: gauge
+        help: The maximum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.2
+      - name: upsAdvInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.3
+        type: gauge
+        help: The minimum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.3
+      - name: upsAdvInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.4
+        type: gauge
+        help: The current input frequency to the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.4
+      - name: upsAdvInputLineFailCause
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.5
+        type: gauge
+        help: The reason for the occurrence of the last transfer to UPS battery power
+          - 1.3.6.1.4.1.318.1.1.1.3.2.5
+        enum_values:
+          1: noTransfer
+          2: highLineVoltage
+          3: brownout
+          4: blackout
+          5: smallMomentarySag
+          6: deepMomentarySag
+          7: smallMomentarySpike
+          8: largeMomentarySpike
+          9: selfTest
+          10: rateOfVoltageChange
+      - name: upsAdvInputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.6
+        type: gauge
+        help: The nominal input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.6
+      - name: upsAdvInputNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.7
+        type: gauge
+        help: The nominal input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.7
+      - name: upsAdvInputBypassNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.8
+        type: gauge
+        help: The nominal bypass input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.8
+      - name: upsAdvInputBypassNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.9
+        type: gauge
+        help: The nominal bypass input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.9
+      - name: upsAdvInputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        type: gauge
+        help: The input identifier. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        type: gauge
+        help: The input apparent power(sum of all of the three phases) measured in kVA.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        type: gauge
+        help: The input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        type: gauge
+        help: The bypass input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        type: gauge
+        help: The input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        type: gauge
+        help: The bypass input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        type: gauge
+        help: The input active power measured in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.11
+        type: gauge
+        help: The input total apparent power(sum of all three phases) of the UPS system
+          in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.11
+      - name: upsAdvInputTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.12
+        type: gauge
+        help: The input total active power(sum of all three phases) of the UPS system
+          in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.12
+      - name: upsAdvInputBypassTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.13
+        type: gauge
+        help: The input bypass total apparent power(sum of all three phases) of the UPS
+          system in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.13
+      - name: upsAdvInputBypassTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.14
+        type: gauge
+        help: The input bypass total active power(sum of all three phases) of the UPS
+          system in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.14
+      - name: upsAdvInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.15
+        type: gauge
+        help: The input energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.3.2.15
+      - name: upsAdvInputDCVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.16
+        type: gauge
+        help: The DC input voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.3.2.16
+      - name: upsAdvInputDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.17
+        type: gauge
+        help: The DC input current in Amps. - 1.3.6.1.4.1.318.1.1.1.3.2.17
+      - name: upsHighPrecInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.1
+        type: gauge
+        help: The current utility line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.1
+      - name: upsHighPrecInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.2
+        type: gauge
+        help: The maximum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.2
+      - name: upsHighPrecInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.3
+        type: gauge
+        help: The minimum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.3
+      - name: upsHighPrecInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.4
+        type: gauge
+        help: The current input frequency to the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.3.3.4
+      - name: upsHighPrecInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.5
+        type: gauge
+        help: The input energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.3.3.5
+      - name: upsHighPrecInputBypassVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.6
+        type: gauge
+        help: The current bypass line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.6
+      - name: upsHighPrecInputBypassFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.7
+        type: gauge
+        help: The current input bypass frequency to the UPS system in tenths of Hz. -
+          1.3.6.1.4.1.318.1.1.1.3.3.7
+      - name: upsBasicOutputStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.1
+        type: gauge
+        help: The current state of the UPS - 1.3.6.1.4.1.318.1.1.1.4.1.1
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: hotStandby
+          15: onBatteryTest
+          16: emergencyStaticBypass
+          17: staticBypassStandby
+          18: powerSavingMode
+          19: spotMode
+          20: eConversion
+          21: chargerSpotmode
+          22: inverterSpotmode
+          23: activeLoad
+          24: batteryDischargeSpotmode
+          25: inverterStandby
+          26: chargerOnly
+      - name: upsBasicOutputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.2
+        type: gauge
+        help: The actual number of output phases in a UPS - 1.3.6.1.4.1.318.1.1.1.4.1.2
+      - name: upsBasicSystemStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.3
+        type: gauge
+        help: Current state for the whole system (UPS and surrounding breakers) - 1.3.6.1.4.1.318.1.1.1.4.1.3
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: inverter
+          15: eConversion
+          16: staticBypassStandby
+          17: efficiencyBoosterMode
+      - name: upsBasicSystemInternalTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.4
+        type: gauge
+        help: The actual internal temperature of the UPS system in Celsius. - 1.3.6.1.4.1.318.1.1.1.4.1.4
+      - name: upsBasicSystemInverterStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.5
+        type: gauge
+        help: The current state of the UPS inverter - 1.3.6.1.4.1.318.1.1.1.4.1.5
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicSystemPFCStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.6
+        type: gauge
+        help: The general status of the power factor correction (AC input stage of the
+          UPS) - 1.3.6.1.4.1.318.1.1.1.4.1.6
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicOutputACwiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.7
+        type: gauge
+        help: Indicates if neutral wire on output side of the UPS is used (load wired
+          line to neutral) - 1.3.6.1.4.1.318.1.1.1.4.1.7
+        enum_values:
+          1: unknown
+          2: noNeutralWiredonSystem
+          3: neutralUsedforSupplyingLoad
+      - name: upsAdvOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.1
+        type: gauge
+        help: The output voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.4.2.1
+      - name: upsAdvOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.2
+        type: gauge
+        help: The current output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.2
+      - name: upsAdvOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.3
+        type: gauge
+        help: The current UPS load expressed in percent of rated capacity. - 1.3.6.1.4.1.318.1.1.1.4.2.3
+      - name: upsAdvOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.4
+        type: gauge
+        help: The current in amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.2.4
+      - name: upsAdvOutputRedundancy
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.5
+        type: gauge
+        help: The number of power modules which can fail or be removed without causing
+          the UPS to generate a Minimum Redundancy Lost event. - 1.3.6.1.4.1.318.1.1.1.4.2.5
+      - name: upsAdvOutputKVACapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.6
+        type: gauge
+        help: The maximum load that this UPS can support - 1.3.6.1.4.1.318.1.1.1.4.2.6
+      - name: upsAdvOutputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.7
+        type: gauge
+        help: The nominal output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.7
+      - name: upsAdvOutputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.8
+        type: gauge
+        help: The total output active power of the UPS system in W - 1.3.6.1.4.1.318.1.1.1.4.2.8
+      - name: upsAdvOutputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.9
+        type: gauge
+        help: The total output apparent power of all phases of the UPS system in VA. -
+          1.3.6.1.4.1.318.1.1.1.4.2.9
+      - name: upsAdvOutputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        type: gauge
+        help: The output identifier. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        type: gauge
+        help: The output peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCurrentTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        type: gauge
+        help: The output current Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCrestFactor
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        type: gauge
+        help: The output current crest factor expressed in tenths. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputNeutralCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.11
+        type: gauge
+        help: The neutral current in amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.11
+      - name: upsAdvOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.12
+        type: gauge
+        help: The output energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.4.2.12
+      - name: upsAdvOutputSourceSynchronization
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.13
+        type: gauge
+        help: Indicates the synchronization source for the inverter output frequency -
+          1.3.6.1.4.1.318.1.1.1.4.2.13
+      - name: upsAdvOutputInverterFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.14
+        type: gauge
+        help: Output frequency in Hz measured at the output of inverter. - 1.3.6.1.4.1.318.1.1.1.4.2.14
+      - name: upsHighPrecOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.1
+        type: gauge
+        help: The output voltage of the UPS system in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.4.3.1
+      - name: upsHighPrecOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.2
+        type: gauge
+        help: The current output frequency of the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.4.3.2
+      - name: upsHighPrecOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.3
+        type: gauge
+        help: The current UPS load expressed in tenths of percent of rated capacity. -
+          1.3.6.1.4.1.318.1.1.1.4.3.3
+      - name: upsHighPrecOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.4
+        type: gauge
+        help: The current in tenths of amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.3.4
+      - name: upsHighPrecOutputEfficiency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.5
+        type: gauge
+        help: The positive values represent efficiency of the UPS in tenths of percent
+          - 1.3.6.1.4.1.318.1.1.1.4.3.5
+      - name: upsHighPrecOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.6
+        type: gauge
+        help: The output energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.4.3.6
+      - name: upsAdvTestDiagnosticSchedule
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.1
+        type: gauge
+        help: The UPS system's automatic battery test schedule. - 1.3.6.1.4.1.318.1.1.1.7.2.1
+        enum_values:
+          1: unknown
+          2: biweekly
+          3: weekly
+          4: atTurnOn
+          5: never
+          6: fourWeeks
+          7: twelveWeeks
+          8: biweeklySinceLastTest
+          9: weeklySinceLastTest
+          10: eightWeeks
+          11: twentysixWeeks
+          12: fiftytwoWeeks
+      - name: upsAdvTestDiagnostics
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.2
+        type: gauge
+        help: Setting this variable to testDiagnostics(2) causes the UPS to perform a
+          diagnostic self test - 1.3.6.1.4.1.318.1.1.1.7.2.2
+        enum_values:
+          1: noTestDiagnostics
+          2: testDiagnostics
+      - name: upsAdvTestDiagnosticsResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.3
+        type: gauge
+        help: The results of the last UPS diagnostics test performed. - 1.3.6.1.4.1.318.1.1.1.7.2.3
+        enum_values:
+          1: ok
+          2: failed
+          3: invalidTest
+          4: testInProgress
+      - name: upsAdvTestLastDiagnosticsDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.4
+        type: DisplayString
+        help: The date the last UPS diagnostics test was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.4
+      - name: upsAdvTestRuntimeCalibration
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.5
+        type: gauge
+        help: Setting this variable to performCalibration(2) causes the UPS to discharge
+          to calibrate the UPS - 1.3.6.1.4.1.318.1.1.1.7.2.5
+        enum_values:
+          1: noPerformCalibration
+          2: performCalibration
+          3: cancelCurrentCalibration
+      - name: upsAdvTestCalibrationResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.6
+        type: gauge
+        help: The results of the last runtime calibration - 1.3.6.1.4.1.318.1.1.1.7.2.6
+        enum_values:
+          1: ok
+          2: invalidCalibration
+          3: calibrationInProgress
+          4: refused
+          5: aborted
+          6: pending
+      - name: upsAdvTestCalibrationDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.7
+        type: DisplayString
+        help: The date the last UPS runtime calibration was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.7
+      - name: upsAdvTestDiagnosticTime
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.8
+        type: DisplayString
+        help: The time of the day to perform automatic battery test - 1.3.6.1.4.1.318.1.1.1.7.2.8
+      - name: upsAdvTestDiagnosticDay
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.9
+        type: gauge
+        help: The day of the week to perform automatic battery test. - 1.3.6.1.4.1.318.1.1.1.7.2.9
+        enum_values:
+          1: monday
+          2: tuesday
+          3: wednesday
+          4: thursday
+          5: friday
+          6: saturday
+          7: sunday
+      - name: upsAdvTestBatteryInterval
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.10
+        type: DisplayString
+        help: The UPS system's automatic battery test period. - 1.3.6.1.4.1.318.1.1.1.7.2.10
+      - name: upsCommStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.8.1
+        type: gauge
+        help: The status of agent's communication with UPS. - 1.3.6.1.4.1.318.1.1.1.8.1
+        enum_values:
+          1: ok
+          2: noComm
+      - name: iemStatusProbeNumber
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        type: gauge
+        help: The index of the probe. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeName
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        type: DisplayString
+        help: A descriptive name for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeStatus
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        type: gauge
+        help: The connected status of the probe, either disconnected(1) or connected(2).
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connected
+      - name: iemStatusProbeCurrentTemp
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        type: gauge
+        help: The current temperature reading from the probe displayed in the units shown
+          in the 'iemStatusProbeTempUnits' OID (Celsius or Fahrenheit). - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeTempUnits
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        type: gauge
+        help: The temperature scale used to display the temperature thresholds of the
+          probe, Celsius(1) or Fahrenheit(2) - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: celsius
+          2: fahrenheit
+      - name: iemStatusProbeCurrentHumid
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        type: gauge
+        help: The current humidity reading from the probe in percent relative humidity.
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeHighTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highTempViolation
+          3: disabled
+      - name: iemStatusProbeLowTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowTempViolation
+          3: disabled
+      - name: iemStatusProbeHighHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        type: gauge
+        help: The high humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highHumidViolation
+          3: disabled
+      - name: iemStatusProbeLowHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        type: gauge
+        help: The low humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowHumidViolation
+          3: disabled
+      - name: iemStatusProbeMaxTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        type: gauge
+        help: The max temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxTempViolation
+          3: disabled
+      - name: iemStatusProbeMinTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        type: gauge
+        help: The minimum temperature violation status of the probe temperature reading
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minTempViolation
+          3: disabled
+      - name: iemStatusProbeMaxHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        type: gauge
+        help: The maximum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxHumidViolation
+          3: disabled
+      - name: iemStatusProbeMinHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        type: gauge
+        help: The minimum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minHumidViolation
+          3: disabled
+      - name: iemStatusProbeLocation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        type: DisplayString
+        help: A descriptive location for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: rPDU2BankStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        type: gauge
+        help: The index to the Rack PDU bank status table entry - 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusModule
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        type: gauge
+        help: The user-defined Rack PDU numeric ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusNumber
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        type: gauge
+        help: The numeric bank ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusLoadState
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        type: EnumAsStateSet
+        help: Indicates the present load status of the Rack PDU bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+        enum_values:
+          1: lowLoad
+          2: normal
+          3: nearOverload
+          4: overload
+      - name: rPDU2BankStatusCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        type: gauge
+        help: Indicates the current draw, in tenths of Amps, of the load on the Rack PDU
+          bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        type: gauge
+        help: The peak current of the Rack PDU bank load in tenths of Amps - 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentTimestamp
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        type: DisplayString
+        help: Indicates the date and time the bank peak current occurred - 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentStartTime
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        type: DisplayString
+        help: Indicates the date and time of the last bank peak current reset - 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      version: 1
+    arista_sw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2.3.1.6
+      - 1.3.6.1.2.1.25.3.3.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.30065.3.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: aristaSwFwdIpStatsIPVersion
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        type: gauge
+        help: The IP version of this row. - 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+      - name: aristaSwFwdIpStatsInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInHdrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        type: counter
+        help: The number of input IP datagrams discarded in software due to errors in
+          their IP headers, including version number mismatch, other format errors, hop
+          count exceeded, errors discovered in processing their IP options, etc - 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        type: counter
+        help: The number of input IP datagrams discarded in software because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInAddrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        type: counter
+        help: The number of input IP datagrams discarded in software because the IP address
+          in their IP header's destination field was not a valid address to be received
+          at this entity - 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInUnknownProtos
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        type: counter
+        help: The number of locally-addressed IP datagrams received successfully in software
+          but discarded because of an unknown or unsupported protocol - 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInTruncatedPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        type: counter
+        help: The number of input IP datagrams discarded in software because the datagram
+          frame didn't carry enough data - 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        type: counter
+        help: The number of IP fragments received that needed to be reassembled at this
+          interface - 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        type: counter
+        help: The number of IP datagrams successfully reassembled - 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.16
+        type: counter
+        help: 'The number of failures detected by the IP re-assembly algorithm (for whatever
+          reason: timed out, errors, etc.) - 1.3.6.1.4.1.30065.3.1.1.1.1.16'
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        type: counter
+        help: The number of input IP datagrams received in software for which no problems
+          were encountered to prevent their continued processing, but were discarded (e.g.,
+          for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        type: counter
+        help: The number of locally generated IP datagrams discarded because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        type: counter
+        help: The number of output IP datagrams for which no problem was encountered to
+          prevent their transmission to their destination, but were discarded in software
+          (e.g., for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        type: counter
+        help: The number of IP datagrams that would require fragmentation in order to
+          be transmitted - 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        type: counter
+        help: The number of IP datagrams that have been successfully fragmented - 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        type: counter
+        help: The number of IP datagrams that have been discarded because they needed
+          to be fragmented but could not be - 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragCreates
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        type: counter
+        help: The number of output datagram fragments that have been generated as a result
+          of IP fragmentation - 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsDiscontinuityTime
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this entry's counters suffered a discontinuity - 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsRefreshRate
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        type: gauge
+        help: The minimum reasonable polling interval for this entry - 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+    cisco_wlc:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.14179.2.1.1.1.2
+      - 1.3.6.1.4.1.14179.2.1.1.1.38
+      - 1.3.6.1.4.1.14179.2.2.1.1.3
+      - 1.3.6.1.4.1.14179.2.2.13.1.3
+      - 1.3.6.1.4.1.14179.2.2.15.1.21
+      - 1.3.6.1.4.1.14179.2.2.2.1.15
+      - 1.3.6.1.4.1.14179.2.2.2.1.2
+      - 1.3.6.1.4.1.14179.2.2.2.1.4
+      - 1.3.6.1.4.1.14179.2.2.6.1
+      metrics:
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: bsnDot11EssNumberOfMobileStations
+        oid: 1.3.6.1.4.1.14179.2.1.1.1.38
+        type: counter
+        help: No of Mobile Stations currently associated with the WLAN. - 1.3.6.1.4.1.14179.2.1.1.1.38
+        indexes:
+        - labelname: bsnDot11EssIndex
+          type: gauge
+        lookups:
+        - labels:
+          - bsnDot11EssIndex
+          labelname: bsnDot11EssSsid
+          oid: 1.3.6.1.4.1.14179.2.1.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: bsnDot11EssIndex
+      - name: bsnAPIfLoadChannelUtilization
+        oid: 1.3.6.1.4.1.14179.2.2.13.1.3
+        type: gauge
+        help: Channel Utilization - 1.3.6.1.4.1.14179.2.2.13.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDBNoisePower
+        oid: 1.3.6.1.4.1.14179.2.2.15.1.21
+        type: gauge
+        help: This is the average noise power in dBm on each channel that is available
+          to Airespace AP - 1.3.6.1.4.1.14179.2.2.15.1.21
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        - labelname: bsnAPIfNoiseChannelNo
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnApIfNoOfUsers
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.15
+        type: counter
+        help: No of Users associated with this radio. - 1.3.6.1.4.1.14179.2.2.2.1.15
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfType
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.2
+        type: gauge
+        help: The type of this interface - 1.3.6.1.4.1.14179.2.2.2.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: dot11b
+          2: dot11a
+          4: uwb
+      - name: bsnAPIfPhyChannelNumber
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.4
+        type: gauge
+        help: Current channel number of the AP Interface - 1.3.6.1.4.1.14179.2.2.2.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: ch1
+          2: ch2
+          3: ch3
+          4: ch4
+          5: ch5
+          6: ch6
+          7: ch7
+          8: ch8
+          9: ch9
+          10: ch10
+          11: ch11
+          12: ch12
+          13: ch13
+          14: ch14
+          20: ch20
+          21: ch21
+          22: ch22
+          23: ch23
+          24: ch24
+          25: ch25
+          26: ch26
+          34: ch34
+          36: ch36
+          38: ch38
+          40: ch40
+          42: ch42
+          44: ch44
+          46: ch46
+          48: ch48
+          52: ch52
+          56: ch56
+          60: ch60
+          64: ch64
+          100: ch100
+          104: ch104
+          108: ch108
+          112: ch112
+          116: ch116
+          120: ch120
+          124: ch124
+          128: ch128
+          132: ch132
+          136: ch136
+          140: ch140
+          149: ch149
+          153: ch153
+          157: ch157
+          161: ch161
+          165: ch165
+          169: ch169
+      - name: bsnAPIfDot11TransmittedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.1
+        type: counter
+        help: This counter shall be incremented for an acknowledged MPDU with an individual
+          address in the address 1 field or an MPDU with a multicast address in the address
+          1 field of type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.1
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastTransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.2
+        type: counter
+        help: This counter shall increment only when the multicast bit is set in the destination
+          MAC address of a successfully transmitted MSDU - 1.3.6.1.4.1.14179.2.2.6.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.3
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          one or more retransmissions. - 1.3.6.1.4.1.14179.2.2.6.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MultipleRetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.4
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          more than one retransmission. - 1.3.6.1.4.1.14179.2.2.6.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FrameDuplicateCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.5
+        type: counter
+        help: This counter shall increment when a frame is received that the Sequence
+          Control field indicates is a duplicate. - 1.3.6.1.4.1.14179.2.2.6.1.5
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSSuccessCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.6
+        type: counter
+        help: This counter shall increment when a CTS is received in response to an RTS.
+          - 1.3.6.1.4.1.14179.2.2.6.1.6
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.7
+        type: counter
+        help: This counter shall increment when a CTS is not received in response to an
+          RTS. - 1.3.6.1.4.1.14179.2.2.6.1.7
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ACKFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.8
+        type: counter
+        help: This counter shall increment when an ACK is not received when expected.
+          - 1.3.6.1.4.1.14179.2.2.6.1.8
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ReceivedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.9
+        type: counter
+        help: This counter shall be incremented for each successfully received MPDU of
+          type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.9
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastReceivedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.10
+        type: counter
+        help: This counter shall increment when a MSDU is received with the multicast
+          bit set in the destination MAC address. - 1.3.6.1.4.1.14179.2.2.6.1.10
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FCSErrorCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.11
+        type: counter
+        help: This counter shall increment when an FCS error is detected in a received
+          MPDU. - 1.3.6.1.4.1.14179.2.2.6.1.11
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11TransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.12
+        type: counter
+        help: This counter shall increment for each successfully transmitted MSDU. - 1.3.6.1.4.1.14179.2.2.6.1.12
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11WEPUndecryptableCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.13
+        type: counter
+        help: This counter shall increment when a frame is received with the WEP subfield
+          of the Frame Control field set to one and the WEPOn value for the key mapped
+          to the TA's MAC address indicates that the frame should not have been encrypted
+          or that frame is discarded due to the receiving STA not implementing the privacy
+          option. - 1.3.6.1.4.1.14179.2.2.6.1.13
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FailedCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.33
+        type: counter
+        help: This counter shall increment when an MSDU is not transmitted successfully
+          due to the number of transmit attempts exceeding either the bsnAPIfDot11ShortRetryLimit
+          or dot11LongRetryLimit. - 1.3.6.1.4.1.14179.2.2.6.1.33
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+    ddwrt:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.11
+      - 1.3.6.1.4.1.2021.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laIndex
+        oid: 1.3.6.1.4.1.2021.10.1.1
+        type: gauge
+        help: reference index/row number for each observed loadave. - 1.3.6.1.4.1.2021.10.1.1
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssIndex
+        oid: 1.3.6.1.4.1.2021.11.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.11.1
+      - name: ssErrorName
+        oid: 1.3.6.1.4.1.2021.11.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.11.2
+      - name: ssSwapIn
+        oid: 1.3.6.1.4.1.2021.11.3
+        type: gauge
+        help: The average amount of memory swapped in from disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.3
+      - name: ssSwapOut
+        oid: 1.3.6.1.4.1.2021.11.4
+        type: gauge
+        help: The average amount of memory swapped out to disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.4
+      - name: ssIOSent
+        oid: 1.3.6.1.4.1.2021.11.5
+        type: gauge
+        help: The average amount of data written to disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.5
+      - name: ssIOReceive
+        oid: 1.3.6.1.4.1.2021.11.6
+        type: gauge
+        help: The average amount of data read from disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.6
+      - name: ssSysInterrupts
+        oid: 1.3.6.1.4.1.2021.11.7
+        type: gauge
+        help: The average rate of interrupts processed (including the clock) calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.7
+      - name: ssSysContext
+        oid: 1.3.6.1.4.1.2021.11.8
+        type: gauge
+        help: The average rate of context switches, calculated over the last minute -
+          1.3.6.1.4.1.2021.11.8
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuRawUser
+        oid: 1.3.6.1.4.1.2021.11.50
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing user-level code
+          - 1.3.6.1.4.1.2021.11.50
+      - name: ssCpuRawNice
+        oid: 1.3.6.1.4.1.2021.11.51
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing reduced-priority
+          code - 1.3.6.1.4.1.2021.11.51
+      - name: ssCpuRawSystem
+        oid: 1.3.6.1.4.1.2021.11.52
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing system-level code
+          - 1.3.6.1.4.1.2021.11.52
+      - name: ssCpuRawIdle
+        oid: 1.3.6.1.4.1.2021.11.53
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent idle - 1.3.6.1.4.1.2021.11.53
+      - name: ssCpuRawWait
+        oid: 1.3.6.1.4.1.2021.11.54
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent waiting for IO - 1.3.6.1.4.1.2021.11.54
+      - name: ssCpuRawKernel
+        oid: 1.3.6.1.4.1.2021.11.55
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing kernel-level code
+          - 1.3.6.1.4.1.2021.11.55
+      - name: ssCpuRawInterrupt
+        oid: 1.3.6.1.4.1.2021.11.56
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing hardware interrupts
+          - 1.3.6.1.4.1.2021.11.56
+      - name: ssIORawSent
+        oid: 1.3.6.1.4.1.2021.11.57
+        type: counter
+        help: Number of blocks sent to a block device - 1.3.6.1.4.1.2021.11.57
+      - name: ssIORawReceived
+        oid: 1.3.6.1.4.1.2021.11.58
+        type: counter
+        help: Number of blocks received from a block device - 1.3.6.1.4.1.2021.11.58
+      - name: ssRawInterrupts
+        oid: 1.3.6.1.4.1.2021.11.59
+        type: counter
+        help: Number of interrupts processed - 1.3.6.1.4.1.2021.11.59
+      - name: ssRawContexts
+        oid: 1.3.6.1.4.1.2021.11.60
+        type: counter
+        help: Number of context switches - 1.3.6.1.4.1.2021.11.60
+      - name: ssCpuRawSoftIRQ
+        oid: 1.3.6.1.4.1.2021.11.61
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing software interrupts
+          - 1.3.6.1.4.1.2021.11.61
+      - name: ssRawSwapIn
+        oid: 1.3.6.1.4.1.2021.11.62
+        type: counter
+        help: Number of blocks swapped in - 1.3.6.1.4.1.2021.11.62
+      - name: ssRawSwapOut
+        oid: 1.3.6.1.4.1.2021.11.63
+        type: counter
+        help: Number of blocks swapped out - 1.3.6.1.4.1.2021.11.63
+      - name: ssCpuRawSteal
+        oid: 1.3.6.1.4.1.2021.11.64
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the hypervisor code to
+          run other VMs even though the CPU in the current VM had something runnable -
+          1.3.6.1.4.1.2021.11.64
+      - name: ssCpuRawGuest
+        oid: 1.3.6.1.4.1.2021.11.65
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a virtual
+          CPU (guest) - 1.3.6.1.4.1.2021.11.65
+      - name: ssCpuRawGuestNice
+        oid: 1.3.6.1.4.1.2021.11.66
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a niced
+          virtual CPU (guest) - 1.3.6.1.4.1.2021.11.66
+      - name: ssCpuNumCpus
+        oid: 1.3.6.1.4.1.2021.11.67
+        type: gauge
+        help: The number of processors, as counted by the agent - 1.3.6.1.4.1.2021.11.67
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+    if_mib:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+    infrapower_pdu:
+      walk:
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.1
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.6
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.7
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: pduMainLoadVoltage
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        type: DisplayString
+        help: The voltage measured on this PDU in tenth of Volts - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainLoadAmp
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        type: DisplayString
+        help: The current load measured on this PDU in tenth of Amps - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainActivePower
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        type: DisplayString
+        help: The active power consumption of this PDU in hundred-thousandth of kW - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: 0$1.$2
+            regex: ^(?:(\d*?)(\d{2}))$
+          - value: 0.0$1
+            regex: ^(?:^(\d))$
+    keepalived:
+      walk:
+      - 1.3.6.1.4.1.9586.100.5.2.1
+      - 1.3.6.1.4.1.9586.100.5.2.3
+      - 1.3.6.1.4.1.9586.100.5.3.1
+      - 1.3.6.1.4.1.9586.100.5.3.3
+      - 1.3.6.1.4.1.9586.100.5.3.4
+      metrics:
+      - name: vrrpSyncGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        type: gauge
+        help: Index of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        type: DisplayString
+        help: Name of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupState
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        type: gauge
+        help: Current state of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpSyncGroupSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        type: gauge
+        help: Will SMTP alert be sent for this synchronisation group? - 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        type: gauge
+        help: Will we execute notification script for this group? - 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupTrackingWeight
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        type: gauge
+        help: Allow differing tracking weights for sync group members - 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        type: gauge
+        help: Index of the VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: static
+      - name: vrrpInstanceName
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        type: DisplayString
+        help: Name of the VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVirtualRouterId
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        type: gauge
+        help: Virtual Router ID (VRID) for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        type: gauge
+        help: Current state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceInitialState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        type: gauge
+        help: Initial state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceWantedState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        type: gauge
+        help: State wanted by the operator for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceBasePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        type: gauge
+        help: Base priority (as defined in the configuration file) for this VRRP instance
+          - 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceEffectivePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        type: gauge
+        help: Effective priority for this VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVipsStatus
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        type: gauge
+        help: Are all VIP of this VRRP instance enabled? - 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: allSet
+          2: notAllSet
+      - name: vrrpInstancePrimaryInterface
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        type: DisplayString
+        help: Primary interface of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceTrackPrimaryIf
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        type: gauge
+        help: Do we track the status of the primary interface? - 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: tracked
+          2: notTracked
+      - name: vrrpInstanceAdvertisementsInt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        type: gauge
+        help: Delay in seconds between two VRRP advertisements and it is in centiseconds
+          between two VRRPV3 advertisements - 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstancePreempt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        type: gauge
+        help: Will a higher priority advertisement preempt a lower instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: preempt
+          2: noPreempt
+      - name: vrrpInstancePreemptDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        type: gauge
+        help: Delay after startup or lower priority advert received until preemption can
+          happen - 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceAuthType
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        type: gauge
+        help: VRRPv2 supports authentication method to authenticate other peers - 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: password
+          2: ah
+      - name: vrrpInstanceSyncGroup
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.18
+        type: DisplayString
+        help: Name of the synchronisation group this VRRP instance belongs, if any. -
+          1.3.6.1.4.1.9586.100.5.2.3.1.18
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceGarpDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        type: gauge
+        help: Delay to launch gratuitous ARP (GARP). - 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        type: gauge
+        help: Will SMTP alert be sent for this VRRP instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        type: gauge
+        help: Will we execute notification script for this instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceAccept
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        type: gauge
+        help: Accept allow the non-master owner to process the packets destined to VIP
+          and it is supported for only VRRPv3. - 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstancePromoteSecondaries
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        type: gauge
+        help: Set promote_secondaries on interface. - 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceUseLinkbeat
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        type: gauge
+        help: Use linkbeat for interface status. - 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceVrrpVersion
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        type: gauge
+        help: VRRP protocol version. - 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          2: vrrpv2
+          3: vrrpv3
+      - name: vrrpInstanceScriptDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        type: DisplayString
+        help: Script to execute when the instance is deleted on reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceNotifyDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        type: gauge
+        help: Send Deleted rather than Fault notifications if instance is deleted on config
+          reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        type: gauge
+        help: Index of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        type: DisplayString
+        help: Name of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        type: gauge
+        help: Index of the virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        type: gauge
+        help: Type of virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: fwmark
+          2: ip
+          3: group
+      - name: virtualServerNameOfGroup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.3
+        type: DisplayString
+        help: If the virtual is defined from a group, this is the name of the group. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerFwMark
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        type: gauge
+        help: If the virtual server is defined from a firewall mark, this is the value
+          of the mark - 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the address family
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: virtualServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        type: InetAddress
+        help: If the virtual server is defined from an IP address, this is the value of
+          the IP - 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the value of the port
+          to listen for requests - 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerProtocol
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        type: gauge
+        help: Which transport protocol should be used for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: tcp
+          2: udp
+          3: sctp
+          4: none
+      - name: virtualServerLoadBalancingAlgo
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        type: gauge
+        help: Which load balancing algorithm (or scheduler) should be used for this virtual
+          server. - 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: rr
+          2: wrr
+          3: lc
+          4: wlc
+          5: lblc
+          6: lblcr
+          7: dh
+          8: sh
+          9: sed
+          10: nq
+          11: fo
+          12: ovf
+          13: mh
+          99: unknown
+      - name: virtualServerLoadBalancingKind
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        type: gauge
+        help: Default forwarding method to use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: virtualServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        type: gauge
+        help: Current status of this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: virtualServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        type: DisplayString
+        help: Virtualhost of this server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersist
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        type: gauge
+        help: Is the virtual service persistence enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerPersistTimeout
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        type: gauge
+        help: If this virtual service is persistence, what is the timeout. - 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.15
+        type: OctetString
+        help: Netmask specifying the granularity of the IPv4 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHaSuspend
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        type: gauge
+        help: If set to true(1), checks will be suspended if the IP of the virtual server
+          is currently not set. - 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerOmega
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        type: gauge
+        help: Is omega mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerRealServersTotal
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        type: gauge
+        help: Total number of real servers for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRealServersUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        type: gauge
+        help: Real servers actually up for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        type: gauge
+        help: Quorum to get amond real servers to consider this virtual server up. - 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        type: gauge
+        help: Current status of the quorum for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: met
+          2: notMet
+          3: shutdown
+      - name: virtualServerQuorumUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        type: DisplayString
+        help: Command to execute when the quorum is met. - 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        type: DisplayString
+        help: Command to execute when the quorum is not met. - 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHysteresis
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        type: gauge
+        help: Hysteresis with respect to quorum count. - 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        type: gauge
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        type: counter
+        help: Total number of incoming bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        type: counter
+        help: Total number of outgoing bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        type: gauge
+        help: Current connection rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        type: gauge
+        help: Current in packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        type: gauge
+        help: Current out packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        type: gauge
+        help: Current incoming rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        type: gauge
+        help: Current outgoing rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerOPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        type: gauge
+        help: If set to true(1), One-Packet-Scheduling will be applied. - 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        type: counter
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity6
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.51
+        type: gauge
+        help: Netmask specifying the granularity of the IPv6 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHashed
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        type: gauge
+        help: If set to true(1), entries will be hashed. - 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        type: gauge
+        help: If set to true(1), SH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        type: gauge
+        help: If set to true(1), SH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSched3
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        type: gauge
+        help: If set to true(1), scheduler flag 3 set. - 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        type: gauge
+        help: What action is performed when the real servers are down - 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: virtualServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        type: gauge
+        help: Default number of seconds between retrying a checker ofter it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        type: gauge
+        help: Default wieght for each real server. - 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        type: gauge
+        help: Will SMTP alert be sent for this virtual server? - 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerMHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        type: gauge
+        help: If set to true(1), MH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerMHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        type: gauge
+        help: If set to true(1), MH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetrUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker ofter it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        type: gauge
+        help: Default forwarding tunnel type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: virtualServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        type: gauge
+        help: Default forwarding tunnel GUE port use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        type: gauge
+        help: Default forwarding tunnel checksum type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+      - name: realServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        type: gauge
+        help: Index of the real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.2
+        type: gauge
+        help: 'Type of real server: either a regular real server or a sorry server. -
+          1.3.6.1.4.1.9586.100.5.3.4.1.2'
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: regular
+          2: sorry
+      - name: realServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        type: gauge
+        help: Address family for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: realServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        type: InetAddress
+        help: IP address of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        type: gauge
+        help: Port of the service. - 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        type: gauge
+        help: Status of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: realServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        type: gauge
+        help: Weight of this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerUpperConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        type: gauge
+        help: Maximum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerLowerConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        type: gauge
+        help: Minimum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        type: gauge
+        help: What action is performed when this server is down - 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: realServerNotifyUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        type: DisplayString
+        help: Command to execute when this server becomes alive. - 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerNotifyDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        type: DisplayString
+        help: Command to execute when this server becomes dead. - 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerFailedChecks
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        type: gauge
+        help: How many failed checks for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        type: gauge
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsActiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        type: gauge
+        help: Current active connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInactiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        type: gauge
+        help: Current inactive connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsPersistentConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        type: gauge
+        help: Current persistent connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        type: counter
+        help: Total number of incoming bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        type: counter
+        help: Total number of outgoing bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        type: gauge
+        help: Current connection rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        type: gauge
+        help: Current in packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        type: gauge
+        help: Current out packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        type: gauge
+        help: Current incoming rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        type: gauge
+        help: Current outgoing rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        type: counter
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerForwardingMethod
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        type: gauge
+        help: Forwarding method to use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: realServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        type: DisplayString
+        help: Virtualhost of this real server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        type: gauge
+        help: Default number of seconds between retrying a checker after it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        type: gauge
+        help: Will SMTP alert be sent for this real server? - 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerDelayBeforeRetryUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker after it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        type: gauge
+        help: Forwarding tunnel type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: realServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        type: gauge
+        help: Forwarding tunnel GUE port use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        type: gauge
+        help: Forwarding tunnel checksum type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+    nec_ix:
+      walk:
+      - 1.3.6.1.4.1.119.2.3.84.11
+      - 1.3.6.1.4.1.119.2.3.84.12
+      - 1.3.6.1.4.1.119.2.3.84.13
+      - 1.3.6.1.4.1.119.2.3.84.2
+      - 1.3.6.1.4.1.119.2.3.84.3
+      - 1.3.6.1.4.1.119.2.3.84.6
+      - 1.3.6.1.4.1.119.2.3.84.7
+      - 1.3.6.1.4.1.119.2.3.84.8
+      - 1.3.6.1.4.1.119.2.3.84.9
+      metrics:
+      - name: picoMobileDeviceIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        type: gauge
+        help: The unique index for each Mobile module. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceVendorName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        type: DisplayString
+        help: The object of the vendor name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        type: DisplayString
+        help: The object of the device name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceProductID
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        type: DisplayString
+        help: The object of the product ID. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSoftwareVersion
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        type: DisplayString
+        help: The object of the software version. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalBar
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        type: gauge
+        help: The object of the signal bar. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalStrength
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7
+        type: gauge
+        help: 'The signal strength can be: unknown(-1) :signal strength is unknown out-range(0):signal
+          strength is 0 weak(1) :signal strength is 1 low(2) :signal strength is 2 high(3)
+          :signal strength is 3 - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          -1: unknown
+          0: out-range
+          1: weak
+          2: low
+          3: high
+      - name: picoMobileDeviceSignalQuality
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        type: DisplayString
+        help: The object of the signal quality. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalElapsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        type: gauge
+        help: The object of the elapsed time after signal acquiring. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceRadioInterface
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        type: DisplayString
+        help: The object of the radio interface. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceCarrier
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        type: DisplayString
+        help: The object of the carrier name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialerString
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        type: DisplayString
+        help: The object of the dialer string. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13
+        type: gauge
+        help: 'The dial status can be: disconnected(0):dial status is disconnected - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          0: disconnected
+          1: connect
+          2: cancel
+          3: connected
+          4: postprocess
+      - name: picoMobileDeviceInRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        type: gauge
+        help: The in-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceOutRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        type: gauge
+        help: The out-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceResetCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        type: gauge
+        help: The reset device statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoIPv4CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.1
+        type: gauge
+        help: The number of current IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.1
+      - name: picoIPv4CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.2
+        type: gauge
+        help: The peak value of IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.2
+      - name: picoIPv4CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.3
+        type: counter
+        help: The total count of created IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.3
+      - name: picoIPv4CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.4
+        type: counter
+        help: The total count of IPv4 cache overflow. - 1.3.6.1.4.1.119.2.3.84.12.1.4
+      - name: picoIPv4UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.1
+        type: gauge
+        help: The number of current IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.1
+      - name: picoIPv4UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.2
+        type: gauge
+        help: The peak value of IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.2
+      - name: picoIPv4UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.3
+        type: counter
+        help: The total count of created IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.3
+      - name: picoIPv4UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.4
+        type: counter
+        help: The total count of IPv4 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.12.2.4
+      - name: picoIPv6CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.1
+        type: gauge
+        help: The number of current IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.1
+      - name: picoIPv6CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.2
+        type: gauge
+        help: The peak value of IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.2
+      - name: picoIPv6CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.3
+        type: counter
+        help: The total count of created IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.3
+      - name: picoIPv6CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.4
+        type: counter
+        help: The total count of IPv6 cache overflow. - 1.3.6.1.4.1.119.2.3.84.13.1.4
+      - name: picoIPv6UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.1
+        type: gauge
+        help: The number of current IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.1
+      - name: picoIPv6UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.2
+        type: gauge
+        help: The peak value of IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.2
+      - name: picoIPv6UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.3
+        type: counter
+        help: The total count of created IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.3
+      - name: picoIPv6UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.4
+        type: counter
+        help: The total count of IPv6 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.13.2.4
+      - name: picoCelsius
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.1
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Celsius).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.1
+      - name: picoFahrenheit
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.2
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Fahrenheit).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.2
+      - name: picoVoltage
+        oid: 1.3.6.1.4.1.119.2.3.84.2.2
+        type: gauge
+        help: Indicates the observed voltage, in milli-volt (mV). - 1.3.6.1.4.1.119.2.3.84.2.2
+      - name: picoFanIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        type: gauge
+        help: Unique index for each fan module. - 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoFanStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        type: gauge
+        help: Status of a fan module - 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: failure
+      - name: picoFanRpm
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        type: gauge
+        help: Fan speed (Revolution Per Minutes) - 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoPowerSupplyIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        type: gauge
+        help: Unique index for each power supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+      - name: picoPowerSupplyType
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        type: gauge
+        help: Power supply module type. - 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: systemACPS
+          2: ieee802dot3af-PoE-ACPS
+      - name: picoPowerSupplyStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        type: gauge
+        help: Status of a Power Supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: normal
+          2: failure
+      - name: picoSchedRtUtl1Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.1
+        type: gauge
+        help: Indicates the observed system utilization for last 1 second, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.1
+      - name: picoSchedRtUtl5Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.2
+        type: gauge
+        help: Indicates the observed system utilization for last 5 seconds, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.2
+      - name: picoSchedRtUtl1Min
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.3
+        type: gauge
+        help: Indicates the observed system utilization for last 1 minute, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.3
+      - name: picoSchedRtUtl1Hour
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.4
+        type: gauge
+        help: Indicates the observed system utilization for last 1 hour, in percent (%).
+          - 1.3.6.1.4.1.119.2.3.84.2.5.4
+      - name: picoHeapSize
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.1
+        type: gauge
+        help: Indicates the observed total heap size, in bytes. - 1.3.6.1.4.1.119.2.3.84.2.6.1
+      - name: picoHeapUtil
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.2
+        type: gauge
+        help: Indicates the observed current heap utilization, in percent (%). - 1.3.6.1.4.1.119.2.3.84.2.6.2
+      - name: pipSecMibLevel
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+        type: gauge
+        help: The version of the IPsec MIB. - 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+      - name: pikeGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+        type: gauge
+        help: The number of currently active IPsec Phase-1 IKE Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+      - name: pikeGlobalInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+        type: counter
+        help: The total number of notifys received by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+      - name: pikeGlobalInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by all currently and
+          previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+      - name: pikeGlobalInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and found
+          to be contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+      - name: pikeGlobalInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and validated
+          but were rejected by the local policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+      - name: pikeGlobalInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by all currently and previously active and IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+      - name: pikeGlobalOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+        type: counter
+        help: The total number of notifys sent by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+      - name: pikeGlobalOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+      - name: pikeGlobalOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent and were flagged
+          by the peer to contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+      - name: pikeGlobalOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent, validated by
+          the peer but were rejected by the peer's policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+      - name: pikeGlobalOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+        type: counter
+        help: The total number of IPsec Phase-2 SA delete requests sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+      - name: pikeGlobalInitTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+      - name: pikeGlobalInitTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+      - name: pikeGlobalRespTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+      - name: pikeGlobalAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+        type: counter
+        help: The total number of authentications which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+      - name: pikeGlobalDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+        type: counter
+        help: The total number of decryptions which ended in failure by all current and
+          previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+      - name: pikeGlobalHashValidFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+        type: counter
+        help: The total number of hash validations which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+      - name: pikeGlobalRespTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+      - name: pikeGlobalInP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+        type: counter
+        help: The total number of ISAKMP security association delete requests received
+          by all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+      - name: pikeGlobalOutP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+        type: counter
+        help: The total number of ISAKMP security association delete requests sent by
+          all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+      - name: pikePeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        type: OctetString
+        help: The IP address of the local peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        type: OctetString
+        help: The IP address of the remote peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        type: gauge
+        help: The length of time that the peer association has existed in hundredths of
+          a second. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        type: gauge
+        help: The index of the active IPsec Phase-1 IKE Tunnel (pikeTunIndex in the pikeTunnelTable)
+          for this peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikeTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunSaRefreshThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        type: gauge
+        help: The security assoication refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+        type: gauge
+        help: The total number of currently active IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+      - name: pipSecGlobalInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+        type: counter
+        help: The total number of octets received by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+      - name: pipSecGlobalInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+        type: counter
+        help: The total number of packets received by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+      - name: pipSecGlobalInDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+        type: counter
+        help: The total number of packets dropped during receive processing by all current
+          and previous IPsec Phase-2 Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+      - name: pipSecGlobalInReplayDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+      - name: pipSecGlobalInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+        type: counter
+        help: The total number of inbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+      - name: pipSecGlobalInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+      - name: pipSecGlobalInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+        type: counter
+        help: The total number of inbound decryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+      - name: pipSecGlobalInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+      - name: pipSecGlobalOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+        type: counter
+        help: The total number of octets sent by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+      - name: pipSecGlobalOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+        type: counter
+        help: The total number of packets sent by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+      - name: pipSecGlobalOutDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+        type: counter
+        help: The total number of packets dropped during send processing by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+      - name: pipSecGlobalOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+        type: counter
+        help: The total number of outbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+      - name: pipSecGlobalOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+      - name: pipSecGlobalOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+        type: counter
+        help: The total number of outbound encryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+      - name: pipSecGlobalOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+      - name: pipSecGlobalNoSaFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+        type: counter
+        help: The total number of non-existent Security Assocication in failures which
+          occurred during processing of all current and previous IPsec Phase-2 Tunnels.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+      - name: pipSecTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        type: gauge
+        help: The index of the associated IPsec Phase-1 IKE Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelAlive
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        type: gauge
+        help: An indicator which specifies whether or not the IPsec Phase-1 IKE Tunnel
+          currently exists. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: pipSecTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeSizeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        type: gauge
+        help: The security association LifeSize refresh threshold in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeTimeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        type: gauge
+        help: The security association LifeTime refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunExpiredSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        type: counter
+        help: The total number of security associations which have expired. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunCurrentSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        type: gauge
+        help: The number of security associations which are currently active or expiring.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        type: gauge
+        help: The Path MTU that has been determined for this IPsec Phase-2 tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecSpiIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        type: gauge
+        help: The number of the SPI associated with the Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiDirection
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        type: gauge
+        help: The direction of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: in
+          2: out
+      - name: pipSecSpiValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        type: gauge
+        help: The value of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiProtocol
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        type: gauge
+        help: The protocol of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: ah
+          2: esp
+          3: ipcomp
+      - name: pipSecSpiStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        type: gauge
+        help: The status of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: expiring
+      - name: pikeTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-1 IKE Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: localFailure
+          9: checkPointReg
+      - name: pikeTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunHistDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunHistEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHistHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunHistAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-1 IKE
+          tunnel was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel was been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-2 Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: seqNumRollOver
+          9: checkPointReq
+      - name: pipSecTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        type: gauge
+        help: The index of the associated IPsec Phase-1 Tunnel (pikeTunIndex in the pikeTunnelTable).
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunHistEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunHistLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-2 Tunnel
+          was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        type: gauge
+        help: The Path MTU that was determined for this IPsec Phase-2 tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: picoExtIfInstalledSlot
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        type: gauge
+        help: The slot number in which the extension card was installed. - 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        type: gauge
+        help: A unique value for each extension card. - 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDescr
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        type: DisplayString
+        help: A textual string containing information about the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfUpperLayer
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        type: gauge
+        help: Index of interface to upper layers. - 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        type: gauge
+        help: The type of interface,, distinguished according to the physical/link protocol(s)
+          immediately `below' the network layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          6: ethernet-csmacd
+          62: fastEther
+      - name: picoExtIfSpeed
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second. - 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDuplex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        type: gauge
+        help: The current mode of this link. - 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: halfduplex
+          2: fullduplex
+      - name: picoExtIfEffectiveMtu
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        type: gauge
+        help: The size of the largest datagram which can be sent/received on the interface,
+          specified in octets. - 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfPhysicalAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        type: PhysAddress48
+        help: The interface's address at the protocol layer immediately `below' the network
+          layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfAdminStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        type: gauge
+        help: The desired state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfOperStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        type: gauge
+        help: The current operational state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfLastChange
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state. - 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoNetmonWatchgroupIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        type: gauge
+        help: Unique index for each Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupName
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        type: DisplayString
+        help: Netmon Watchgroup Name. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupSequenceNumber
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        type: gauge
+        help: Netmon Watchgroup sequence number. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        type: gauge
+        help: Status of a Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: stand
+          3: disable
+      - name: picoNetmonWatchgroupVarianceCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        type: gauge
+        help: Netmon Watchgroup variance statistics. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNgnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN is enabled. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2
+        type: gauge
+        help: 'The mode of the NGN service can be: standard(1) :NGN service is standard
+          - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: standard
+          2: numbergate
+      - name: picoNgnIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3
+        type: gauge
+        help: 'The type of the NGN interface can be: global(1) :NGN interface type is
+          global - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: global
+          2: private
+      - name: picoNgnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4
+        type: gauge
+        help: 'The state of the NGN SIP-UA register can be: notReady(1) :NGN service is
+          not Ready - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: notReady
+          2: initializing
+          3: registering
+          4: registered
+      - name: picoNgnSipServerIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        type: InetAddressIPv4
+        help: The object of the SIP server address. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnSipUri
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        type: DisplayString
+        help: The object of the SIP URI. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnUpTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        type: gauge
+        help: The time elapsed since registered. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnVpnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN binding is enabled.
+          - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2
+        type: gauge
+        help: 'The state of the NGN SIP-UA session can be: disconnected(1):SIP session
+          is disconnected - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2'
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connecting
+          3: connected
+      - name: picoNgnVpnPeerAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        type: DisplayString
+        help: The object of the NGN peer address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnBandwidth
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        type: gauge
+        help: The object of the NGN session bandwidth. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnUsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        type: gauge
+        help: The time elapsed since this connected NGN session. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        type: InetAddressIPv4
+        help: The object of the NGN session SBC address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcPort
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        type: gauge
+        help: The object of the NGN session SBC port. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+    paloalto_fw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.1
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.25.3
+      - 1.3.6.1.4.1.25461.2.1.2.1
+      - 1.3.6.1.4.1.25461.2.1.2.3
+      - 1.3.6.1.4.1.25461.2.1.2.5
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: gauge
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrSystemUptime
+        oid: 1.3.6.1.2.1.25.1.1
+        type: gauge
+        help: The amount of time since this host was last initialized - 1.3.6.1.2.1.25.1.1
+      - name: hrSystemDate
+        oid: 1.3.6.1.2.1.25.1.2
+        type: DateAndTime
+        help: The host's notion of the local date and time of day. - 1.3.6.1.2.1.25.1.2
+      - name: hrSystemInitialLoadDevice
+        oid: 1.3.6.1.2.1.25.1.3
+        type: gauge
+        help: The index of the hrDeviceEntry for the device from which this host is configured
+          to load its initial operating system configuration (i.e., which operating system
+          code and/or boot parameters) - 1.3.6.1.2.1.25.1.3
+      - name: hrSystemInitialLoadParameters
+        oid: 1.3.6.1.2.1.25.1.4
+        type: OctetString
+        help: This object contains the parameters (e.g - 1.3.6.1.2.1.25.1.4
+      - name: hrSystemNumUsers
+        oid: 1.3.6.1.2.1.25.1.5
+        type: gauge
+        help: The number of user sessions for which this host is storing state information
+          - 1.3.6.1.2.1.25.1.5
+      - name: hrSystemProcesses
+        oid: 1.3.6.1.2.1.25.1.6
+        type: gauge
+        help: The number of process contexts currently loaded or running on this system.
+          - 1.3.6.1.2.1.25.1.6
+      - name: hrSystemMaxProcesses
+        oid: 1.3.6.1.2.1.25.1.7
+        type: gauge
+        help: The maximum number of process contexts this system can support - 1.3.6.1.2.1.25.1.7
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrDeviceIndex
+        oid: 1.3.6.1.2.1.25.3.2.1.1
+        type: gauge
+        help: A unique value for each device contained by the host - 1.3.6.1.2.1.25.3.2.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceType
+        oid: 1.3.6.1.2.1.25.3.2.1.2
+        type: OctetString
+        help: An indication of the type of device - 1.3.6.1.2.1.25.3.2.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceDescr
+        oid: 1.3.6.1.2.1.25.3.2.1.3
+        type: DisplayString
+        help: A textual description of this device, including the device's manufacturer
+          and revision, and optionally, its serial number. - 1.3.6.1.2.1.25.3.2.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceID
+        oid: 1.3.6.1.2.1.25.3.2.1.4
+        type: OctetString
+        help: The product ID for this device. - 1.3.6.1.2.1.25.3.2.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceStatus
+        oid: 1.3.6.1.2.1.25.3.2.1.5
+        type: gauge
+        help: The current operational state of the device described by this row of the
+          table - 1.3.6.1.2.1.25.3.2.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: unknown
+          2: running
+          3: warning
+          4: testing
+          5: down
+      - name: hrDeviceErrors
+        oid: 1.3.6.1.2.1.25.3.2.1.6
+        type: counter
+        help: The number of errors detected on this device - 1.3.6.1.2.1.25.3.2.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorFrwID
+        oid: 1.3.6.1.2.1.25.3.3.1.1
+        type: OctetString
+        help: The product ID of the firmware associated with the processor. - 1.3.6.1.2.1.25.3.3.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrNetworkIfIndex
+        oid: 1.3.6.1.2.1.25.3.4.1.1
+        type: gauge
+        help: The value of ifIndex which corresponds to this network device - 1.3.6.1.2.1.25.3.4.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: gauge
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: hrPrinterDetectedErrorState
+        oid: 1.3.6.1.2.1.25.3.5.1.2
+        type: OctetString
+        help: This object represents any error conditions detected by the printer - 1.3.6.1.2.1.25.3.5.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDiskStorageAccess
+        oid: 1.3.6.1.2.1.25.3.6.1.1
+        type: gauge
+        help: An indication if this long-term storage device is readable and writable
+          or only readable - 1.3.6.1.2.1.25.3.6.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrDiskStorageMedia
+        oid: 1.3.6.1.2.1.25.3.6.1.2
+        type: gauge
+        help: An indication of the type of media used in this long- term storage device.
+          - 1.3.6.1.2.1.25.3.6.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: hardDisk
+          4: floppyDisk
+          5: opticalDiskROM
+          6: opticalDiskWORM
+          7: opticalDiskRW
+          8: ramDisk
+      - name: hrDiskStorageRemoveble
+        oid: 1.3.6.1.2.1.25.3.6.1.3
+        type: gauge
+        help: Denotes whether or not the disk media may be removed from the drive. - 1.3.6.1.2.1.25.3.6.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrDiskStorageCapacity
+        oid: 1.3.6.1.2.1.25.3.6.1.4
+        type: gauge
+        help: The total size for this long-term storage device - 1.3.6.1.2.1.25.3.6.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPartitionIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.1
+        type: gauge
+        help: A unique value for each partition on this long-term storage device - 1.3.6.1.2.1.25.3.7.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionLabel
+        oid: 1.3.6.1.2.1.25.3.7.1.2
+        type: OctetString
+        help: A textual description of this partition. - 1.3.6.1.2.1.25.3.7.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionID
+        oid: 1.3.6.1.2.1.25.3.7.1.3
+        type: OctetString
+        help: A descriptor which uniquely represents this partition to the responsible
+          operating system - 1.3.6.1.2.1.25.3.7.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionSize
+        oid: 1.3.6.1.2.1.25.3.7.1.4
+        type: gauge
+        help: The size of this partition. - 1.3.6.1.2.1.25.3.7.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionFSIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.5
+        type: gauge
+        help: The index of the file system mounted on this partition - 1.3.6.1.2.1.25.3.7.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrFSIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.1
+        type: gauge
+        help: A unique value for each file system local to this host - 1.3.6.1.2.1.25.3.8.1.1
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.2
+        type: OctetString
+        help: The path name of the root of this file system. - 1.3.6.1.2.1.25.3.8.1.2
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSRemoteMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.3
+        type: OctetString
+        help: A description of the name and/or address of the server that this file system
+          is mounted from - 1.3.6.1.2.1.25.3.8.1.3
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSType
+        oid: 1.3.6.1.2.1.25.3.8.1.4
+        type: OctetString
+        help: The value of this object identifies the type of this file system. - 1.3.6.1.2.1.25.3.8.1.4
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSAccess
+        oid: 1.3.6.1.2.1.25.3.8.1.5
+        type: gauge
+        help: An indication if this file system is logically configured by the operating
+          system to be readable and writable or only readable - 1.3.6.1.2.1.25.3.8.1.5
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrFSBootable
+        oid: 1.3.6.1.2.1.25.3.8.1.6
+        type: gauge
+        help: A flag indicating whether this file system is bootable. - 1.3.6.1.2.1.25.3.8.1.6
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrFSStorageIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.7
+        type: gauge
+        help: The index of the hrStorageEntry that represents information about this file
+          system - 1.3.6.1.2.1.25.3.8.1.7
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastFullBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.8
+        type: DateAndTime
+        help: The last date at which this complete file system was copied to another storage
+          device for backup - 1.3.6.1.2.1.25.3.8.1.8
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastPartialBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.9
+        type: DateAndTime
+        help: The last date at which a portion of this file system was copied to another
+          storage device for backup - 1.3.6.1.2.1.25.3.8.1.9
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: panAhoSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.1
+        type: counter
+        help: The total usage of software for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.1
+      - name: panDfaSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.2
+        type: counter
+        help: The total number of dfa match using software - 1.3.6.1.4.1.25461.2.1.2.1.19.2
+      - name: panFlowHostServiceAllow
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.3
+        type: counter
+        help: Device management session allowed - 1.3.6.1.4.1.25461.2.1.2.1.19.3
+      - name: panHaPathmonSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.4
+        type: counter
+        help: HA path-monitoring packets sent - 1.3.6.1.4.1.25461.2.1.2.1.19.4
+      - name: panAhoFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.5
+        type: counter
+        help: The total requests to FPGA for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.5
+      - name: panDfaFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.6
+        type: counter
+        help: The total requests to FPGA for DFA - 1.3.6.1.4.1.25461.2.1.2.1.19.6
+      - name: panFpgaPkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.7
+        type: counter
+        help: The packets held because of requests to FPGA - 1.3.6.1.4.1.25461.2.1.2.1.19.7
+      - name: panFlowDosAgMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+        type: counter
+        help: Session limit reached for aggregate profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+      - name: panFlowDosBlkNumEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+        type: counter
+        help: Number of entries in DOS block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+      - name: panFlowDosClMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+        type: counter
+        help: Session limit reached for classified profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+      - name: panFlowDosClSyncookieAckErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.4
+        type: counter
+        help: 'TCP SYN cookies: Invalid ACKs received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.4'
+      - name: panFlowDosClSyncookieAckRcv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.5
+        type: counter
+        help: 'TCP SYN cookies: ACKs to cookies received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.5'
+      - name: panFlowDosClSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.6
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.6'
+      - name: panFlowDosClSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.7
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, classified pro -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.7'
+      - name: panFlowDosClSyncookieSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.8
+        type: counter
+        help: 'TCP SYN cookies: cookies sent, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.8'
+      - name: panFlowMeterVsysThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.9
+        type: counter
+        help: 'Session metering: sessions throttled by vsys configuration - 1.3.6.1.4.1.25461.2.1.2.1.19.8.9'
+      - name: panFlowPolicyDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.10
+        type: counter
+        help: 'Session setup: denied by policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.10'
+      - name: panFlowPolicyNat
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.11
+        type: counter
+        help: 'Session setup: source NAT IP/port allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.8.11'
+      - name: panFlowScanDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.12
+        type: counter
+        help: 'Session setup: denied by scan detection - 1.3.6.1.4.1.25461.2.1.2.1.19.8.12'
+      - name: panFlowDosDropIpBlocked
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.13
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration by oth -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.13'
+      - name: panFlowDosRedIcmp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.14
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.14'
+      - name: panFlowDosRedIcmp6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.15
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmpv6'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.15'
+      - name: panFlowDosRedIp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.16
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''other-ip'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.16'
+      - name: panFlowDosRedTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.17
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''tcp-syn'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.17'
+      - name: panFlowDosRedUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.18
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''udp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.18'
+      - name: panFlowDosRuleAgBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.19
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.19'
+      - name: panFlowDosRuleAgRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.20
+        type: counter
+        help: 'Packets dropped: Activate aggregate RED threshold reached, random ear -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.20'
+      - name: panFlowDosRuleAgRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.21
+        type: counter
+        help: 'Packets dropped: Maximal aggregate RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.21'
+      - name: panFlowDosRuleDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.22
+        type: counter
+        help: 'Packets dropped: Denied action by DoS policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.22'
+      - name: panFlowDosRuleDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.23
+        type: counter
+        help: 'Packets dropped: Rate limited or IP blocked - 1.3.6.1.4.1.25461.2.1.2.1.19.8.23'
+      - name: panFlowDosRuleDropAggr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.24
+        type: counter
+        help: 'Packets dropped: due to aggregate rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.24'
+      - name: panFlowDosRuleDropClBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.25
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.25'
+      - name: panFlowDosRuleDropClRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.26
+        type: counter
+        help: 'Packets dropped: Activate classified RED threshold reached, random ea -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.26'
+      - name: panFlowDosRuleDropClRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.27
+        type: counter
+        help: 'Packets dropped: Maximal classified RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.27'
+      - name: panFlowDosRuleDropClassified
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.28
+        type: counter
+        help: 'Packets dropped: due to classified rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.28'
+      - name: panFlowDosSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.29
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.29'
+      - name: panFlowDosSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.30
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, aggregate prof -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.30'
+      - name: panFlowDosZoneRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.31
+        type: counter
+        help: 'Packets dropped: Activate zone RED threshold reached, random early dr -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.31'
+      - name: panFlowDosZoneRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.32
+        type: counter
+        help: 'Packets dropped: Maximal zone RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.32'
+      - name: panFlowDosBlkSwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+        type: counter
+        help: Number of entries in DOS Software block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+      - name: panFlowDosBlkHwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+        type: counter
+        help: Number of entries in DOS Hardware block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+      - name: panFlowDosSyncookieNotTcpSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN - 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+      - name: panFlowDosSyncookieNotTcpSynAck
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN-ACK - 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+      - name: panFlowDosPfIpspoof
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-spoof' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+      - name: panFlowDosPfIpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+      - name: panFlowDosPfPing0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-ping-zero-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+      - name: panFlowDosPfIcmpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+      - name: panFlowDosPfIcmplpkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-large-packet' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+      - name: panFlowDosPfIcmperr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-error' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+      - name: panFlowDosPfNoreplyttl
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-timeexceeded' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+      - name: panFlowDosPfNoreplyneedfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-needfrag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+      - name: panFlowDosPfStrictsource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-strict-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+      - name: panFlowDosPfLoosesource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-loose-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+      - name: panFlowDosPfTimestamp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-timestamp' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+      - name: panFlowDosPfRecordroute
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-record-route' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+      - name: panFlowDosPfSecurity
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-security' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+      - name: panFlowDosPfSatnetid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-stream-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+      - name: panFlowDosPfUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-unknown-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+      - name: panFlowDosPfBadoption
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-malformed-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+      - name: panFlowDosPfTcpoverlappingmismatch
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-overlapping-tcp-segment-mismatch'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+      - name: panFlowDosPfStrictip
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+        type: counter
+        help: Packets dropped:Zone protection option 'strict-ip-check' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+      - name: panFlowDosPfTcpsplithandshake
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-split-handshake' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+      - name: panFlowDosPfTcpsyndata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-syn-with-data' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+      - name: panFlowDosPfTcpsynackdata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-synack-with-data' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+      - name: panFlowDosIp6Route0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-0' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+      - name: panFlowDosIp6Route1
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-1' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+      - name: panFlowDosIp6Route3
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-3' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+      - name: panFlowDosIp6Route4to252
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-4-252' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+      - name: panFlowDosIp6Route253
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-253' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+      - name: panFlowDosIp6Route254
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-254' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+      - name: panFlowDosIp6Route255
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-255' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+      - name: panFlowDosIp6Ip4cmpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+        type: counter
+        help: Packets dropped:Zone protection option 'ipv4-compatible-address' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+      - name: panFlowDosIp6Acast
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+        type: counter
+        help: Packets dropped:Zone protection option 'anycast-source' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+      - name: panFlowDosIp6OptionsInvalidIPv6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+        type: counter
+        help: Packets dropped:Zone protection option 'options-invalid-ipv6-discard' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+      - name: panFlowDosIp6Icmpv6ErrorInvalid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+        type: counter
+        help: Packets dropped:Zone protection option 'icmpv6-too-big-small-mtu-discard'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+      - name: panFlowDosIp6NeedlessIpv6FragHdr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+        type: counter
+        help: Packets dropped:Zone protection option 'needless-fragment-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+      - name: panFlowDosIp6RsvdSet
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+        type: counter
+        help: Packets dropped:Zone protection option 'reserved-field-set-discard' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+      - name: panFlowDosIPv6ExtHdrHopByHop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+        type: counter
+        help: Packets dropped:Zone protection option 'hop-by-hop-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+      - name: panFlowDosip6IPv6ExtHdrRouting
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+      - name: panFlowDosIp6IPv6ExtHdrDestOpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+        type: counter
+        help: Packets dropped:Zone protection option 'dest-option-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+      - name: panFlowDosPbpDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+        type: counter
+        help: Packets dropped:Dropped by packet buffer protection RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+      - name: panFlowDosCurrSessIncrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+        type: counter
+        help: Unable to increment current session count on session create - 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+      - name: panFlowDosCurrSessDecrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+        type: counter
+        help: Unable to decrement current session count on session delete - 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+      - name: panFlowFwdL3TtlZero
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.1
+        type: counter
+        help: 'Packets dropped: IP TTL reaches zero - 1.3.6.1.4.1.25461.2.1.2.1.19.9.1'
+      - name: panFlowMeterHostThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.2
+        type: counter
+        help: 'Session metering: sessions throttled by management session threshold -
+          1.3.6.1.4.1.25461.2.1.2.1.19.9.2'
+      - name: panFlowHostServiceDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+        type: counter
+        help: Device management session denied - 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+      - name: panFlowHostServiceUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.4
+        type: counter
+        help: 'Session discarded: unknown application to control plane - 1.3.6.1.4.1.25461.2.1.2.1.19.9.4'
+      - name: panPktAllocFailure
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+        type: counter
+        help: Packet allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+      - name: panPktAllocFailureCos
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+        type: counter
+        help: Packet allocation error due to QoS control - 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+      - name: panSessionDiscard
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+        type: counter
+        help: Session set to discard by security policy check - 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+      - name: panFlowIpfragFragErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.1
+        type: counter
+        help: 'Packet dropped: IP fragmentation error - 1.3.6.1.4.1.25461.2.1.2.1.19.10.1'
+      - name: panFlowIpfragRecv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+        type: counter
+        help: IP fragments received - 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+      - name: panTcpAllocWqeFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+        type: counter
+        help: wqe allocation failure in tcp - 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+      - name: panTcpDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+        type: counter
+        help: session denied because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+      - name: panTcpDropOutOfWnd
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+        type: counter
+        help: out-of-window packets dropped - 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+      - name: panTcpDropPacket
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+        type: counter
+        help: packets dropped because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+      - name: panFlowActionClose
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+        type: counter
+        help: TCP sessions closed via injecting RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+      - name: panFlowActionReset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+        type: counter
+        help: TCP clients reset via responding RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+      - name: panFlowTcpNonSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+        type: counter
+        help: Non-SYN TCP packets without session match - 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+      - name: panTcpExceedSegLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+        type: counter
+        help: packets dropped due to the limitation on global tcp out-of-order pack -
+          1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+      - name: panFlowTciGreDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+        type: counter
+        help: Total GRE sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+      - name: panFlowTciGreDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+        type: counter
+        help: Total GRE sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+      - name: panFlowTciGreDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+        type: counter
+        help: Total unknown tunnel inspection packets in GRE tunnel [passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+      - name: panFlowTciIpsecDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+        type: counter
+        help: Total Ipsec sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+      - name: panFlowTciIpsecDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+        type: counter
+        help: Total IPSEC sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+      - name: panFlowTciIpsecDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+        type: counter
+        help: Total unknown tunnel inspection packets in IPSEC tunnel [passed|dropped]
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+      - name: panFlowTciGtpDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+        type: counter
+        help: Total GTP sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+      - name: panFlowTciGtpDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+        type: counter
+        help: Total GTP sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+      - name: panFlowTciGtpDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+        type: counter
+        help: Total unknown tunnel inspection packets in GTP tunnel[passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+      - name: panSysSwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.1
+        type: DisplayString
+        help: Full software version - 1.3.6.1.4.1.25461.2.1.2.1.1
+      - name: panSysHwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.2
+        type: DisplayString
+        help: Hardware version of the unit. - 1.3.6.1.4.1.25461.2.1.2.1.2
+      - name: panSysSerialNumber
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.3
+        type: DisplayString
+        help: The serial number of the unit - 1.3.6.1.4.1.25461.2.1.2.1.3
+      - name: panSysTimeZoneOffset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.4
+        type: gauge
+        help: The offset in seconds from UTC of the system's time zone - 1.3.6.1.4.1.25461.2.1.2.1.4
+      - name: panSysDaylightSaving
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.5
+        type: gauge
+        help: Whether daylight savings are in currently in effect for the system's time
+          zone. - 1.3.6.1.4.1.25461.2.1.2.1.5
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: panSysVpnClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.6
+        type: DisplayString
+        help: Currently installed VPN client package version - 1.3.6.1.4.1.25461.2.1.2.1.6
+      - name: panSysAppVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.7
+        type: DisplayString
+        help: Currently installed application definition version - 1.3.6.1.4.1.25461.2.1.2.1.7
+      - name: panSysAvVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.8
+        type: DisplayString
+        help: Currently installed antivirus version - 1.3.6.1.4.1.25461.2.1.2.1.8
+      - name: panSysThreatVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.9
+        type: DisplayString
+        help: Currently installed threat definition version - 1.3.6.1.4.1.25461.2.1.2.1.9
+      - name: panSysUrlFilteringVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.10
+        type: DisplayString
+        help: Currently installed URL filtering version - 1.3.6.1.4.1.25461.2.1.2.1.10
+      - name: panSysHAState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.11
+        type: DisplayString
+        help: Current high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.11
+      - name: panSysHAPeerState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.12
+        type: DisplayString
+        help: Current peer high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.12
+      - name: panSysHAMode
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.13
+        type: DisplayString
+        help: Current high-availability mode (disabled, active-passive, or active-active).
+          - 1.3.6.1.4.1.25461.2.1.2.1.13
+      - name: panSysUrlFilteringDatabase
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.14
+        type: DisplayString
+        help: Current installed URL filtering database (surfcontrol, brightcloud, etc)
+          - 1.3.6.1.4.1.25461.2.1.2.1.14
+      - name: panSysGlobalProtectClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.15
+        type: DisplayString
+        help: Currently installed global-protect client package version - 1.3.6.1.4.1.25461.2.1.2.1.15
+      - name: panSysOpswatDatafileVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.16
+        type: DisplayString
+        help: Currently installed opswat database version - 1.3.6.1.4.1.25461.2.1.2.1.16
+      - name: panSysWildfireVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.17
+        type: DisplayString
+        help: Currently installed wildfire content version - 1.3.6.1.4.1.25461.2.1.2.1.17
+      - name: panSysWildfirePrivateCloudVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.18
+        type: DisplayString
+        help: Currently installed wildfire private cloud content version - 1.3.6.1.4.1.25461.2.1.2.1.18
+      - name: panSysAppReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.20
+        type: DisplayString
+        help: Currently installed application definition release date - 1.3.6.1.4.1.25461.2.1.2.1.20
+      - name: panSysThreatReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.21
+        type: DisplayString
+        help: Currently installed threat release date - 1.3.6.1.4.1.25461.2.1.2.1.21
+      - name: panSysAvReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.22
+        type: DisplayString
+        help: Currently installed antivirus release date - 1.3.6.1.4.1.25461.2.1.2.1.22
+      - name: panSysWfReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.23
+        type: DisplayString
+        help: Currently installed WildFire release date - 1.3.6.1.4.1.25461.2.1.2.1.23
+      - name: panSessionUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.1
+        type: gauge
+        help: Session table utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.1
+      - name: panSessionMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.2
+        type: gauge
+        help: Total number of sessions supported. - 1.3.6.1.4.1.25461.2.1.2.3.2
+      - name: panSessionActive
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.3
+        type: gauge
+        help: Total number of active sessions. - 1.3.6.1.4.1.25461.2.1.2.3.3
+      - name: panSessionActiveTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.4
+        type: gauge
+        help: Total number of active TCP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.4
+      - name: panSessionActiveUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.5
+        type: gauge
+        help: Total number of active UDP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.5
+      - name: panSessionActiveICMP
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.6
+        type: gauge
+        help: Total number of active ICMP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.6
+      - name: panSessionActiveSslProxy
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.7
+        type: gauge
+        help: Total number of active SSL proxy sessions. - 1.3.6.1.4.1.25461.2.1.2.3.7
+      - name: panSessionSslProxyUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.8
+        type: gauge
+        help: SSL proxy Session utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.8
+      - name: panVsysId
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        type: gauge
+        help: Vsys id - 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        type: DisplayString
+        help: User assigned vsys name (empty string if not available) - 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysSessionUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        type: gauge
+        help: Vsys utilization percentage, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        type: gauge
+        help: Active sessions on this Vsys - 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysMaxSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        type: gauge
+        help: Max sessions on this Vsys, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        type: gauge
+        help: Number of active Tcp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        type: gauge
+        help: Number of active Udp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        type: gauge
+        help: Number of active Other IP Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panZoneName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        type: DisplayString
+        help: Zone name for the interface - 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        type: gauge
+        help: Number of active TCP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        type: gauge
+        help: Number of active UDP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        type: gauge
+        help: Number of active Other IP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifIndex
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        type: gauge
+        help: Index of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        type: DisplayString
+        help: Description (name) of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        type: gauge
+        help: Number of active TCP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        type: gauge
+        help: Number of active UDP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        type: gauge
+        help: Number of active Other IP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panGPGWUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.1
+        type: gauge
+        help: GlobalProtect Gateway utilization percentage - 1.3.6.1.4.1.25461.2.1.2.5.1.1
+      - name: panGPGWUtilizationMaxTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.2
+        type: gauge
+        help: Max tunnels allowed - 1.3.6.1.4.1.25461.2.1.2.5.1.2
+      - name: panGPGWUtilizationActiveTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.3
+        type: gauge
+        help: Number of active tunnels - 1.3.6.1.4.1.25461.2.1.2.5.1.3
+    printer_mib:
+      walk:
+      - 1.3.6.1.2.1.25.3.5.1.1
+      - 1.3.6.1.2.1.43.11.1.1.5
+      - 1.3.6.1.2.1.43.11.1.1.6
+      - 1.3.6.1.2.1.43.11.1.1.8
+      - 1.3.6.1.2.1.43.11.1.1.9
+      - 1.3.6.1.2.1.43.5.1.1.13
+      - 1.3.6.1.2.1.43.5.1.1.16
+      - 1.3.6.1.2.1.43.5.1.1.17
+      - 1.3.6.1.2.1.43.5.1.1.18
+      - 1.3.6.1.2.1.43.5.1.1.19
+      - 1.3.6.1.2.1.43.5.1.1.3
+      - 1.3.6.1.2.1.43.6.1.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: EnumAsStateSet
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: prtMarkerSuppliesType
+        oid: 1.3.6.1.2.1.43.11.1.1.5
+        type: gauge
+        help: The type of this supply. - 1.3.6.1.2.1.43.11.1.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: toner
+          4: wasteToner
+          5: ink
+          6: inkCartridge
+          7: inkRibbon
+          8: wasteInk
+          9: opc
+          10: developer
+          11: fuserOil
+          12: solidWax
+          13: ribbonWax
+          14: wasteWax
+          15: fuser
+          16: coronaWire
+          17: fuserOilWick
+          18: cleanerUnit
+          19: fuserCleaningPad
+          20: transferUnit
+          21: tonerCartridge
+          22: fuserOiler
+          23: water
+          24: wasteWater
+          25: glueWaterAdditive
+          26: wastePaper
+          27: bindingSupply
+          28: bandingSupply
+          29: stitchingWire
+          30: shrinkWrap
+          31: paperWrap
+          32: staples
+          33: inserts
+          34: covers
+          35: matteToner
+          36: matteInk
+      - name: prtMarkerSuppliesDescription
+        oid: 1.3.6.1.2.1.43.11.1.1.6
+        type: DisplayString
+        help: The description of this supply container/receptacle in the localization
+          specified by prtGeneralCurrentLocalization. - 1.3.6.1.2.1.43.11.1.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesMaxCapacity
+        oid: 1.3.6.1.2.1.43.11.1.1.8
+        type: gauge
+        help: The maximum capacity of this supply container/receptacle expressed in prtMarkerSuppliesSupplyUnit
+          - 1.3.6.1.2.1.43.11.1.1.8
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesLevel
+        oid: 1.3.6.1.2.1.43.11.1.1.9
+        type: gauge
+        help: The current level if this supply is a container; the remaining space if
+          this supply is a receptacle - 1.3.6.1.2.1.43.11.1.1.9
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtConsoleDisable
+        oid: 1.3.6.1.2.1.43.5.1.1.13
+        type: EnumAsStateSet
+        help: This value indicates how input is (or is not) accepted from the operator
+          console - 1.3.6.1.2.1.43.5.1.1.13
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: enabled
+          4: disabled
+      - name: prtGeneralPrinterName
+        oid: 1.3.6.1.2.1.43.5.1.1.16
+        type: DisplayString
+        help: An administrator-specified name for this printer - 1.3.6.1.2.1.43.5.1.1.16
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralSerialNumber
+        oid: 1.3.6.1.2.1.43.5.1.1.17
+        type: DisplayString
+        help: A recorded serial number for this device that indexes some type device catalog
+          or inventory - 1.3.6.1.2.1.43.5.1.1.17
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertCriticalEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.18
+        type: counter
+        help: A running counter of the number of critical alert events that have been
+          recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.18
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertAllEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.19
+        type: counter
+        help: A running counter of the total number of alert event entries (critical and
+          non-critical) that have been recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.19
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralReset
+        oid: 1.3.6.1.2.1.43.5.1.1.3
+        type: EnumAsStateSet
+        help: Setting this value to 'powerCycleReset', 'resetToNVRAM', or 'resetToFactoryDefaults'
+          will result in the resetting of the printer - 1.3.6.1.2.1.43.5.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: notResetting
+          4: powerCycleReset
+          5: resetToNVRAM
+          6: resetToFactoryDefaults
+      - name: prtCoverStatus
+        oid: 1.3.6.1.2.1.43.6.1.1.3
+        type: EnumAsStateSet
+        help: The status of this cover sub-unit. - 1.3.6.1.2.1.43.6.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtCoverIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: coverOpen
+          4: coverClosed
+          5: interlockOpen
+          6: interlockClosed
+    raritan:
+      walk:
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.2
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.13742.4.1.3.1.5.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: outletOperationalState
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        type: EnumAsStateSet
+        help: A value for each outlet which describes the operational state of the outlet
+          - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+        enum_values:
+          -1: error
+          0: "off"
+          1: "on"
+          2: cycling
+      - name: outletWattHours
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        type: gauge
+        help: The value of the cumulative active energy for this outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        type: gauge
+        help: A unique value for the current sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletMaxCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        type: gauge
+        help: A unique value for the max - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        type: gauge
+        help: A unique value for the voltage sensor attached to the outlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        type: gauge
+        help: A unique value for the active power sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: inletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        type: gauge
+        help: A unique value for the current sensor attached to the inlet - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        type: gauge
+        help: A unique value for the voltage sensor attached to the intlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        type: gauge
+        help: The active power for the inlet This value is reported in Watts. - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: unitCpuTemp
+        oid: 1.3.6.1.4.1.13742.4.1.3.1.5
+        type: gauge
+        help: The value for the unit's CPU temperature sensor in tenth degrees celsius.
+          - 1.3.6.1.4.1.13742.4.1.3.1.5
+      auth:
+        community: raritan_public
+    servertech_sentry3:
+      walk:
+      - 1.3.6.1.4.1.1718.3.2.2
+      - 1.3.6.1.4.1.1718.3.2.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: infeedIndex
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.1
+        type: gauge
+        help: Index for the input feed table. - 1.3.6.1.4.1.1718.3.2.2.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.2
+        type: DisplayString
+        help: The ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedName
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.3
+        type: DisplayString
+        help: The name of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.4
+        type: Bits
+        help: The capabilities of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: failSafe
+          4: defaultOff
+          5: voltageSense
+          6: powerSense
+          7: branchOnSense
+          8: branchLoadSense
+      - name: infeedStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.5
+        type: gauge
+        help: The status of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: infeedLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.6
+        type: gauge
+        help: The status of the load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: infeedLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.7
+        type: gauge
+        help: The load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.8
+        type: gauge
+        help: The load high threshold value of the input feed line in Amps. - 1.3.6.1.4.1.1718.3.2.2.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedOutletCount
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.9
+        type: gauge
+        help: The number of controlled and/or monitored outlets on the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.10
+        type: gauge
+        help: The load capacity of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.11
+        type: gauge
+        help: The line-to-line voltage of the input feed - 1.3.6.1.4.1.1718.3.2.2.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.12
+        type: gauge
+        help: The active power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.13
+        type: gauge
+        help: The apparent power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.14
+        type: gauge
+        help: The power factor of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.15
+        type: gauge
+        help: The crest factor for the load of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.16
+        type: gauge
+        help: The energy consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedReactance
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.17
+        type: gauge
+        help: The characterization of the phase relation between the voltage and current
+          of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: capacitive
+          2: inductive
+          3: resistive
+      - name: infeedPhaseVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.18
+        type: gauge
+        help: The voltage measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseCurrent
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.19
+        type: gauge
+        help: The current measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.21
+        type: DisplayString
+        help: The ID of the input feed line. - 1.3.6.1.4.1.1718.3.2.2.1.21
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineToLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.22
+        type: DisplayString
+        help: The line-to-line ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.22
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.23
+        type: DisplayString
+        help: The ID of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.23
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVACapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.24
+        type: gauge
+        help: The apparent power capacity of the input feed circuit - 1.3.6.1.4.1.1718.3.2.2.1.24
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: outletIndex
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.1
+        type: gauge
+        help: Index for the outlet table. - 1.3.6.1.4.1.1718.3.2.3.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletID
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.2
+        type: DisplayString
+        help: The ID of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletName
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.3
+        type: DisplayString
+        help: The name of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.4
+        type: Bits
+        help: The capabilities of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: shutdown
+          4: defaultOn
+          5: ownInfeed
+          6: fusedBranch
+          7: voltageSense
+          8: powerSense
+      - name: outletStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.5
+        type: gauge
+        help: The status of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: outletLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.6
+        type: gauge
+        help: The status of the load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: outletLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.7
+        type: gauge
+        help: The load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadLowThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.8
+        type: gauge
+        help: The load low threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.9
+        type: gauge
+        help: The load high threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletControlState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.10
+        type: gauge
+        help: The control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: idleOff
+          1: idleOn
+          2: wakeOff
+          3: wakeOn
+          4: "off"
+          5: "on"
+          6: lockedOff
+          7: lockedOn
+          8: reboot
+          9: shutdown
+          10: pendOn
+          11: pendOff
+          12: minimumOff
+          13: minimumOn
+          14: eventOff
+          15: eventOn
+          16: eventReboot
+          17: eventShutdown
+      - name: outletControlAction
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.11
+        type: gauge
+        help: An action to change the control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: "on"
+          2: "off"
+          3: reboot
+      - name: outletCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.12
+        type: gauge
+        help: The load capacity of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.13
+        type: gauge
+        help: The voltage of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.14
+        type: gauge
+        help: The active power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.15
+        type: gauge
+        help: The apparent power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.16
+        type: gauge
+        help: The power factor of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.17
+        type: gauge
+        help: The crest factor for the load of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.18
+        type: gauge
+        help: The energy consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletWakeupState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.19
+        type: gauge
+        help: The wakeup state of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          1: last
+          2: "off"
+          3: "on"
+      - name: outletPostOnDelay
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.20
+        type: gauge
+        help: The post-on delay of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.20
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+    synology:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.4
+      - 1.3.6.1.4.1.6574.1
+      - 1.3.6.1.4.1.6574.101
+      - 1.3.6.1.4.1.6574.102
+      - 1.3.6.1.4.1.6574.104
+      - 1.3.6.1.4.1.6574.2
+      - 1.3.6.1.4.1.6574.3
+      - 1.3.6.1.4.1.6574.4
+      - 1.3.6.1.4.1.6574.5
+      - 1.3.6.1.4.1.6574.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.2021.11.10.0
+      - 1.3.6.1.4.1.2021.11.11.0
+      - 1.3.6.1.4.1.2021.11.9.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+      - name: systemStatus
+        oid: 1.3.6.1.4.1.6574.1.1
+        type: gauge
+        help: Synology system status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.1
+      - name: temperature
+        oid: 1.3.6.1.4.1.6574.1.2
+        type: gauge
+        help: Synology system temperature The temperature of Disk Station uses Celsius
+          degree. - 1.3.6.1.4.1.6574.1.2
+      - name: powerStatus
+        oid: 1.3.6.1.4.1.6574.1.3
+        type: gauge
+        help: Synology power status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.3
+      - name: systemFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.1
+        type: gauge
+        help: Synology system fan status Each meanings of status represented describe
+          below - 1.3.6.1.4.1.6574.1.4.1
+      - name: cpuFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.2
+        type: gauge
+        help: Synology cpu fan status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.4.2
+      - name: modelName
+        oid: 1.3.6.1.4.1.6574.1.5.1
+        type: OctetString
+        help: The Model name of this NAS - 1.3.6.1.4.1.6574.1.5.1
+      - name: serialNumber
+        oid: 1.3.6.1.4.1.6574.1.5.2
+        type: OctetString
+        help: The serial number of this NAS - 1.3.6.1.4.1.6574.1.5.2
+      - name: version
+        oid: 1.3.6.1.4.1.6574.1.5.3
+        type: OctetString
+        help: The version of this DSM - 1.3.6.1.4.1.6574.1.5.3
+      - name: upgradeAvailable
+        oid: 1.3.6.1.4.1.6574.1.5.4
+        type: gauge
+        help: This oid is for checking whether there is a latest DSM can be upgraded -
+          1.3.6.1.4.1.6574.1.5.4
+      - name: storageIOIndex
+        oid: 1.3.6.1.4.1.6574.101.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.101.1.1.1
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIODevice
+        oid: 1.3.6.1.4.1.6574.101.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.101.1.1.2
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONRead
+        oid: 1.3.6.1.4.1.6574.101.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.3
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWritten
+        oid: 1.3.6.1.4.1.6574.101.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.4
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOReads
+        oid: 1.3.6.1.4.1.6574.101.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.5
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOWrites
+        oid: 1.3.6.1.4.1.6574.101.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.6
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA
+        oid: 1.3.6.1.4.1.6574.101.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.8
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA1
+        oid: 1.3.6.1.4.1.6574.101.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.9
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA5
+        oid: 1.3.6.1.4.1.6574.101.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.10
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA15
+        oid: 1.3.6.1.4.1.6574.101.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.11
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONReadX
+        oid: 1.3.6.1.4.1.6574.101.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.12
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWrittenX
+        oid: 1.3.6.1.4.1.6574.101.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.13
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: spaceIOIndex
+        oid: 1.3.6.1.4.1.6574.102.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.102.1.1.1
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIODevice
+        oid: 1.3.6.1.4.1.6574.102.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.102.1.1.2
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONRead
+        oid: 1.3.6.1.4.1.6574.102.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.3
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWritten
+        oid: 1.3.6.1.4.1.6574.102.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.4
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOReads
+        oid: 1.3.6.1.4.1.6574.102.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.5
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOWrites
+        oid: 1.3.6.1.4.1.6574.102.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.6
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA
+        oid: 1.3.6.1.4.1.6574.102.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.8
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA1
+        oid: 1.3.6.1.4.1.6574.102.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.9
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA5
+        oid: 1.3.6.1.4.1.6574.102.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.10
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA15
+        oid: 1.3.6.1.4.1.6574.102.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.11
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONReadX
+        oid: 1.3.6.1.4.1.6574.102.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.12
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWrittenX
+        oid: 1.3.6.1.4.1.6574.102.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.13
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: iSCSILUNInfoIndex
+        oid: 1.3.6.1.4.1.6574.104.1.1.1
+        type: gauge
+        help: LUN info index - 1.3.6.1.4.1.6574.104.1.1.1
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNUUID
+        oid: 1.3.6.1.4.1.6574.104.1.1.2
+        type: OctetString
+        help: LUN uuid - 1.3.6.1.4.1.6574.104.1.1.2
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNName
+        oid: 1.3.6.1.4.1.6574.104.1.1.3
+        type: OctetString
+        help: LUN name - 1.3.6.1.4.1.6574.104.1.1.3
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.4
+        type: gauge
+        help: LUN read throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.4
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.5
+        type: gauge
+        help: LUN read throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.5
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.6
+        type: gauge
+        help: LUN write throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.6
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.7
+        type: gauge
+        help: LUN write throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.7
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.8
+        type: gauge
+        help: LUN read iops - 1.3.6.1.4.1.6574.104.1.1.8
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.9
+        type: gauge
+        help: LUN write iops - 1.3.6.1.4.1.6574.104.1.1.9
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.10
+        type: gauge
+        help: LUN disk latency when reading - 1.3.6.1.4.1.6574.104.1.1.10
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.11
+        type: gauge
+        help: LUN disk latency when writing - 1.3.6.1.4.1.6574.104.1.1.11
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyTx
+        oid: 1.3.6.1.4.1.6574.104.1.1.12
+        type: gauge
+        help: LUN transfer data network latency - 1.3.6.1.4.1.6574.104.1.1.12
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyRx
+        oid: 1.3.6.1.4.1.6574.104.1.1.13
+        type: gauge
+        help: LUN receive data network latency - 1.3.6.1.4.1.6574.104.1.1.13
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.14
+        type: gauge
+        help: LUN average io size when reading - 1.3.6.1.4.1.6574.104.1.1.14
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.15
+        type: gauge
+        help: LUN average io size when writing - 1.3.6.1.4.1.6574.104.1.1.15
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNQueueDepth
+        oid: 1.3.6.1.4.1.6574.104.1.1.16
+        type: gauge
+        help: Num of iSCSI commands in LUN queue - 1.3.6.1.4.1.6574.104.1.1.16
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNType
+        oid: 1.3.6.1.4.1.6574.104.1.1.17
+        type: OctetString
+        help: LUN type - 1.3.6.1.4.1.6574.104.1.1.17
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: diskIndex
+        oid: 1.3.6.1.4.1.6574.2.1.1.1
+        type: gauge
+        help: The index of disk table - 1.3.6.1.4.1.6574.2.1.1.1
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskID
+        oid: 1.3.6.1.4.1.6574.2.1.1.2
+        type: OctetString
+        help: Synology disk ID The ID of disk is assigned by disk Station. - 1.3.6.1.4.1.6574.2.1.1.2
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskModel
+        oid: 1.3.6.1.4.1.6574.2.1.1.3
+        type: OctetString
+        help: Synology disk model name The disk model name will be showed here. - 1.3.6.1.4.1.6574.2.1.1.3
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskType
+        oid: 1.3.6.1.4.1.6574.2.1.1.4
+        type: OctetString
+        help: Synology disk type The type of disk will be showed here, including SATA,
+          SSD and so on. - 1.3.6.1.4.1.6574.2.1.1.4
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskStatus
+        oid: 1.3.6.1.4.1.6574.2.1.1.5
+        type: gauge
+        help: Synology disk status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.2.1.1.5
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskTemperature
+        oid: 1.3.6.1.4.1.6574.2.1.1.6
+        type: gauge
+        help: Synology disk temperature The temperature of each disk uses Celsius degree.
+          - 1.3.6.1.4.1.6574.2.1.1.6
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: raidIndex
+        oid: 1.3.6.1.4.1.6574.3.1.1.1
+        type: gauge
+        help: The index of raid table - 1.3.6.1.4.1.6574.3.1.1.1
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidName
+        oid: 1.3.6.1.4.1.6574.3.1.1.2
+        type: OctetString
+        help: Synology raid name The name of each raid will be showed here. - 1.3.6.1.4.1.6574.3.1.1.2
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidStatus
+        oid: 1.3.6.1.4.1.6574.3.1.1.3
+        type: gauge
+        help: Synology Raid status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.3.1.1.3
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidFreeSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.4
+        type: counter
+        help: Synology raid freesize Free space in bytes. - 1.3.6.1.4.1.6574.3.1.1.4
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidTotalSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.5
+        type: counter
+        help: Synology raid totalsize Total space in bytes. - 1.3.6.1.4.1.6574.3.1.1.5
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: upsDeviceModel
+        oid: 1.3.6.1.4.1.6574.4.1.1
+        type: DisplayString
+        help: Device model - 1.3.6.1.4.1.6574.4.1.1
+      - name: upsDeviceManufacturer
+        oid: 1.3.6.1.4.1.6574.4.1.2
+        type: DisplayString
+        help: Device manufacturer - 1.3.6.1.4.1.6574.4.1.2
+      - name: upsDeviceSerial
+        oid: 1.3.6.1.4.1.6574.4.1.3
+        type: DisplayString
+        help: Device serial number. - 1.3.6.1.4.1.6574.4.1.3
+      - name: upsDeviceType
+        oid: 1.3.6.1.4.1.6574.4.1.4
+        type: DisplayString
+        help: Device type (ups, pdu, scd, psu) - 1.3.6.1.4.1.6574.4.1.4
+      - name: upsDeviceDescription
+        oid: 1.3.6.1.4.1.6574.4.1.5
+        type: DisplayString
+        help: Device description. - 1.3.6.1.4.1.6574.4.1.5
+      - name: upsDeviceContact
+        oid: 1.3.6.1.4.1.6574.4.1.6
+        type: DisplayString
+        help: Device administrator name. - 1.3.6.1.4.1.6574.4.1.6
+      - name: upsDeviceLocation
+        oid: 1.3.6.1.4.1.6574.4.1.7
+        type: DisplayString
+        help: Device physical location. - 1.3.6.1.4.1.6574.4.1.7
+      - name: upsDevicePart
+        oid: 1.3.6.1.4.1.6574.4.1.8
+        type: DisplayString
+        help: Device part number. - 1.3.6.1.4.1.6574.4.1.8
+      - name: upsDeviceMACAddr
+        oid: 1.3.6.1.4.1.6574.4.1.9
+        type: DisplayString
+        help: Physical network address of the device. - 1.3.6.1.4.1.6574.4.1.9
+      - name: upsInfoStatus
+        oid: 1.3.6.1.4.1.6574.4.2.1
+        type: DisplayString
+        help: UPS status. - 1.3.6.1.4.1.6574.4.2.1
+      - name: upsInfoAlarm
+        oid: 1.3.6.1.4.1.6574.4.2.2
+        type: DisplayString
+        help: UPS alarms - 1.3.6.1.4.1.6574.4.2.2
+      - name: upsInfoTime
+        oid: 1.3.6.1.4.1.6574.4.2.3
+        type: DisplayString
+        help: Internal UPS clock time - 1.3.6.1.4.1.6574.4.2.3
+      - name: upsInfoDate
+        oid: 1.3.6.1.4.1.6574.4.2.4
+        type: DisplayString
+        help: Internal UPS clock date - 1.3.6.1.4.1.6574.4.2.4
+      - name: upsInfoModel
+        oid: 1.3.6.1.4.1.6574.4.2.5
+        type: DisplayString
+        help: UPS model - 1.3.6.1.4.1.6574.4.2.5
+      - name: upsInfoMfrName
+        oid: 1.3.6.1.4.1.6574.4.2.6.1
+        type: DisplayString
+        help: UPS manufacturer - 1.3.6.1.4.1.6574.4.2.6.1
+      - name: upsInfoMfrDate
+        oid: 1.3.6.1.4.1.6574.4.2.6.2
+        type: DisplayString
+        help: UPS manufacturing date - 1.3.6.1.4.1.6574.4.2.6.2
+      - name: upsInfoSerial
+        oid: 1.3.6.1.4.1.6574.4.2.7
+        type: DisplayString
+        help: UPS serial number - 1.3.6.1.4.1.6574.4.2.7
+      - name: upsInfoVendorID
+        oid: 1.3.6.1.4.1.6574.4.2.8
+        type: DisplayString
+        help: Vendor ID for USB devices - 1.3.6.1.4.1.6574.4.2.8
+      - name: upsInfoProductID
+        oid: 1.3.6.1.4.1.6574.4.2.9
+        type: DisplayString
+        help: Product ID for USB devices - 1.3.6.1.4.1.6574.4.2.9
+      - name: upsInfoFirmwareName
+        oid: 1.3.6.1.4.1.6574.4.2.10.1
+        type: DisplayString
+        help: UPS firmware - 1.3.6.1.4.1.6574.4.2.10.1
+      - name: upsInfoFirmwareAux
+        oid: 1.3.6.1.4.1.6574.4.2.10.2
+        type: DisplayString
+        help: Auxiliary device firmware - 1.3.6.1.4.1.6574.4.2.10.2
+      - name: upsInfoTemperature
+        oid: 1.3.6.1.4.1.6574.4.2.11
+        type: Float
+        help: UPS temperature (degrees C) - 1.3.6.1.4.1.6574.4.2.11
+      - name: upsInfoLoadValue
+        oid: 1.3.6.1.4.1.6574.4.2.12.1
+        type: Float
+        help: Load on UPS (percent) - 1.3.6.1.4.1.6574.4.2.12.1
+      - name: upsInfoLoadHigh
+        oid: 1.3.6.1.4.1.6574.4.2.12.2
+        type: Float
+        help: Load when UPS switches to overload condition (OVER) (percent) - 1.3.6.1.4.1.6574.4.2.12.2
+      - name: upsInfoID
+        oid: 1.3.6.1.4.1.6574.4.2.13
+        type: DisplayString
+        help: UPS system identifier - 1.3.6.1.4.1.6574.4.2.13
+      - name: upsInfoDelayStart
+        oid: 1.3.6.1.4.1.6574.4.2.14.1
+        type: gauge
+        help: Interval to wait before restarting the load (seconds) - 1.3.6.1.4.1.6574.4.2.14.1
+      - name: upsInfoDelayReboot
+        oid: 1.3.6.1.4.1.6574.4.2.14.2
+        type: gauge
+        help: Interval to wait before rebooting the UPS (seconds) - 1.3.6.1.4.1.6574.4.2.14.2
+      - name: upsInfoDelayShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.14.3
+        type: gauge
+        help: Interval to wait after shutdown with delay command (seconds) - 1.3.6.1.4.1.6574.4.2.14.3
+      - name: upsInfoTimerStart
+        oid: 1.3.6.1.4.1.6574.4.2.15.1
+        type: gauge
+        help: Time before the load will be started (seconds) - 1.3.6.1.4.1.6574.4.2.15.1
+      - name: upsInfoTimerReboot
+        oid: 1.3.6.1.4.1.6574.4.2.15.2
+        type: gauge
+        help: Time before the load will be rebooted (seconds) - 1.3.6.1.4.1.6574.4.2.15.2
+      - name: upsInfoTimerShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.15.3
+        type: gauge
+        help: Time before the load will be shutdown (seconds) - 1.3.6.1.4.1.6574.4.2.15.3
+      - name: upsInfoTestInterval
+        oid: 1.3.6.1.4.1.6574.4.2.16.1
+        type: gauge
+        help: Interval between self tests - 1.3.6.1.4.1.6574.4.2.16.1
+      - name: upsInfoTestResult
+        oid: 1.3.6.1.4.1.6574.4.2.16.2
+        type: DisplayString
+        help: Results of last self test - 1.3.6.1.4.1.6574.4.2.16.2
+      - name: upsInfoDisplayLanguage
+        oid: 1.3.6.1.4.1.6574.4.2.17
+        type: DisplayString
+        help: Language to use on front panel - 1.3.6.1.4.1.6574.4.2.17
+      - name: upsInfoContacts
+        oid: 1.3.6.1.4.1.6574.4.2.18
+        type: DisplayString
+        help: UPS external contact sensors - 1.3.6.1.4.1.6574.4.2.18
+      - name: upsInfoEffciency
+        oid: 1.3.6.1.4.1.6574.4.2.19
+        type: gauge
+        help: Efficiency of the UPS (ratio of the output current on the input current)
+          (percent) - 1.3.6.1.4.1.6574.4.2.19
+      - name: upsInfoPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.20.1
+        type: Float
+        help: Current value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.1
+      - name: upsInfoPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.20.2
+        type: Float
+        help: Nominal value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.2
+      - name: upsInfoRealPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.21.1
+        type: Float
+        help: Current value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.1
+      - name: upsInfoRealPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.21.2
+        type: Float
+        help: Nominal value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.2
+      - name: upsInfoBeeperStatus
+        oid: 1.3.6.1.4.1.6574.4.2.22
+        type: DisplayString
+        help: UPS beeper status (enabled, disabled or muted) - 1.3.6.1.4.1.6574.4.2.22
+      - name: upsInfoType
+        oid: 1.3.6.1.4.1.6574.4.2.23
+        type: DisplayString
+        help: UPS type - 1.3.6.1.4.1.6574.4.2.23
+      - name: upsInfoWatchdogStatus
+        oid: 1.3.6.1.4.1.6574.4.2.24
+        type: DisplayString
+        help: UPS watchdog status (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.24
+      - name: upsInfoStartAuto
+        oid: 1.3.6.1.4.1.6574.4.2.25.1
+        type: DisplayString
+        help: UPS starts when mains is (re)applied - 1.3.6.1.4.1.6574.4.2.25.1
+      - name: upsInfoStartBattery
+        oid: 1.3.6.1.4.1.6574.4.2.25.2
+        type: DisplayString
+        help: Allow to start UPS from battery - 1.3.6.1.4.1.6574.4.2.25.2
+      - name: upsInfoStartReboot
+        oid: 1.3.6.1.4.1.6574.4.2.25.3
+        type: DisplayString
+        help: UPS coldstarts from battery (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.25.3
+      - name: upsBatteryChargeValue
+        oid: 1.3.6.1.4.1.6574.4.3.1.1
+        type: Float
+        help: Battery charge - 1.3.6.1.4.1.6574.4.3.1.1
+      - name: upsBatteryChargeLow
+        oid: 1.3.6.1.4.1.6574.4.3.1.2
+        type: Float
+        help: Remaining battery level when UPS switches to LB (percent) - 1.3.6.1.4.1.6574.4.3.1.2
+      - name: upsBatteryChargeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.1.3
+        type: Float
+        help: Minimum battery level for UPS restart after power-off - 1.3.6.1.4.1.6574.4.3.1.3
+      - name: upsBatteryChargeWarning
+        oid: 1.3.6.1.4.1.6574.4.3.1.4
+        type: Float
+        help: Battery level when UPS switches to Warning state (percent) - 1.3.6.1.4.1.6574.4.3.1.4
+      - name: upsBatteryVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.3.2.1
+        type: Float
+        help: The magnitude of the present battery voltage. - 1.3.6.1.4.1.6574.4.3.2.1
+      - name: upsBatteryVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.3.2.2
+        type: Float
+        help: Nominal battery voltage. - 1.3.6.1.4.1.6574.4.3.2.2
+      - name: upsBatteryVoltageLow
+        oid: 1.3.6.1.4.1.6574.4.3.2.3
+        type: Float
+        help: Minimum battery voltage, that triggers FSD status . - 1.3.6.1.4.1.6574.4.3.2.3
+      - name: upsBatteryVoltageHigh
+        oid: 1.3.6.1.4.1.6574.4.3.2.4
+        type: Float
+        help: Maximum battery voltage (Ie battery.charge = 100). - 1.3.6.1.4.1.6574.4.3.2.4
+      - name: upsBatteryCapacity
+        oid: 1.3.6.1.4.1.6574.4.3.3
+        type: Float
+        help: Battery capacity (Ah) - 1.3.6.1.4.1.6574.4.3.3
+      - name: upsBatteryCurrent
+        oid: 1.3.6.1.4.1.6574.4.3.4
+        type: Float
+        help: The present battery current. - 1.3.6.1.4.1.6574.4.3.4
+      - name: upsBatteryTemperature
+        oid: 1.3.6.1.4.1.6574.4.3.5
+        type: Float
+        help: The ambient temperature at or near the UPS Battery casing. - 1.3.6.1.4.1.6574.4.3.5
+      - name: upsBatteryRuntimeValue
+        oid: 1.3.6.1.4.1.6574.4.3.6.1
+        type: gauge
+        help: Battery runtime (seconds) - 1.3.6.1.4.1.6574.4.3.6.1
+      - name: upsBatteryRuntimeLow
+        oid: 1.3.6.1.4.1.6574.4.3.6.2
+        type: gauge
+        help: Remaining battery runtime when UPS switches to LB (seconds) - 1.3.6.1.4.1.6574.4.3.6.2
+      - name: upsBatteryRuntimeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.6.3
+        type: gauge
+        help: Minimum battery runtime for UPS restart after power-off (seconds) - 1.3.6.1.4.1.6574.4.3.6.3
+      - name: upsBatteryAlarmThreshold
+        oid: 1.3.6.1.4.1.6574.4.3.7
+        type: DisplayString
+        help: Battery alarm threshold - 1.3.6.1.4.1.6574.4.3.7
+      - name: upsBatteryDate
+        oid: 1.3.6.1.4.1.6574.4.3.8
+        type: DisplayString
+        help: Battery change date - 1.3.6.1.4.1.6574.4.3.8
+      - name: upsBatteryMfrDate
+        oid: 1.3.6.1.4.1.6574.4.3.9
+        type: DisplayString
+        help: Battery manufacturing date - 1.3.6.1.4.1.6574.4.3.9
+      - name: upsBatteryPacks
+        oid: 1.3.6.1.4.1.6574.4.3.10
+        type: gauge
+        help: Number of battery packs - 1.3.6.1.4.1.6574.4.3.10
+      - name: upsBatteryPacksBad
+        oid: 1.3.6.1.4.1.6574.4.3.11
+        type: gauge
+        help: Number of bad battery packs - 1.3.6.1.4.1.6574.4.3.11
+      - name: upsBatteryType
+        oid: 1.3.6.1.4.1.6574.4.3.12
+        type: DisplayString
+        help: Battery chemistry - 1.3.6.1.4.1.6574.4.3.12
+      - name: upsBatteryProtection
+        oid: 1.3.6.1.4.1.6574.4.3.13
+        type: DisplayString
+        help: Prevent deep discharge of battery - 1.3.6.1.4.1.6574.4.3.13
+      - name: upsBatteryEnergySave
+        oid: 1.3.6.1.4.1.6574.4.3.14
+        type: DisplayString
+        help: Switch off when running on battery and no/low load - 1.3.6.1.4.1.6574.4.3.14
+      - name: upsInputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.4.1.1
+        type: Float
+        help: Input voltage - 1.3.6.1.4.1.6574.4.4.1.1
+      - name: upsInputVoltageMax
+        oid: 1.3.6.1.4.1.6574.4.4.1.2
+        type: Float
+        help: Maximum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.2
+      - name: upsInputVoltageMin
+        oid: 1.3.6.1.4.1.6574.4.4.1.3
+        type: Float
+        help: Minimum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.3
+      - name: upsInputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.4.1.4
+        type: Float
+        help: Nominal input voltage - 1.3.6.1.4.1.6574.4.4.1.4
+      - name: upsInputVoltageExtend
+        oid: 1.3.6.1.4.1.6574.4.4.1.5
+        type: DisplayString
+        help: Extended input voltage range - 1.3.6.1.4.1.6574.4.4.1.5
+      - name: upsInputVoltageFault
+        oid: 1.3.6.1.4.1.6574.4.4.1.6
+        type: Float
+        help: Input voltage Fault - 1.3.6.1.4.1.6574.4.4.1.6
+      - name: upsInputTransferReason
+        oid: 1.3.6.1.4.1.6574.4.4.2.1
+        type: DisplayString
+        help: Reason for last transfer to battery - 1.3.6.1.4.1.6574.4.4.2.1
+      - name: upsInputTransferLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.2
+        type: Float
+        help: Low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.2
+      - name: upsInputTransferHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.3
+        type: Float
+        help: High voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.3
+      - name: upsInputTransferLowMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.4
+        type: Float
+        help: smallest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.4
+      - name: upsInputTransferLowMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.5
+        type: Float
+        help: greatest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.5
+      - name: upsInputTransferHighMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.6
+        type: Float
+        help: smallest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.6
+      - name: upsInputTransferHighMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.7
+        type: Float
+        help: greatest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.7
+      - name: upsInputTransferBoostLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.8
+        type: Float
+        help: Low voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.8
+      - name: upsInputTransferBoostHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.9
+        type: Float
+        help: High voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.9
+      - name: upsInputTransferTrimLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.10
+        type: Float
+        help: Low voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.10
+      - name: upsInputTransferTrimHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.11
+        type: Float
+        help: High voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.11
+      - name: upsInputSensitivity
+        oid: 1.3.6.1.4.1.6574.4.4.3
+        type: DisplayString
+        help: Input power sensitivity - 1.3.6.1.4.1.6574.4.4.3
+      - name: upsInputQuality
+        oid: 1.3.6.1.4.1.6574.4.4.4
+        type: DisplayString
+        help: Input power quality - 1.3.6.1.4.1.6574.4.4.4
+      - name: upsInputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.4.5.1
+        type: Float
+        help: Input current (A) - 1.3.6.1.4.1.6574.4.4.5.1
+      - name: upsInputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.4.5.2
+        type: Float
+        help: Nominal input current (A) - 1.3.6.1.4.1.6574.4.4.5.2
+      - name: upsInputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.4.6.1
+        type: Float
+        help: Input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.1
+      - name: upsInputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.4.6.2
+        type: Float
+        help: Nominal input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.2
+      - name: upsInputFrequencyLow
+        oid: 1.3.6.1.4.1.6574.4.4.6.3
+        type: Float
+        help: Input line frequency low (Hz) - 1.3.6.1.4.1.6574.4.4.6.3
+      - name: upsInputFrequencyHigh
+        oid: 1.3.6.1.4.1.6574.4.4.6.4
+        type: Float
+        help: Input line frequency high (Hz) - 1.3.6.1.4.1.6574.4.4.6.4
+      - name: upsInputFrequencyExtend
+        oid: 1.3.6.1.4.1.6574.4.4.6.5
+        type: DisplayString
+        help: Extended input frequency range - 1.3.6.1.4.1.6574.4.4.6.5
+      - name: upsOutputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.5.1.1
+        type: Float
+        help: Output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.1
+      - name: upsOutputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.5.1.2
+        type: Float
+        help: Nominal output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.2
+      - name: upsOutputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.5.2.1
+        type: Float
+        help: Output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.1
+      - name: upsOutputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.5.2.2
+        type: Float
+        help: Nominal output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.2
+      - name: upsOutputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.5.3.1
+        type: Float
+        help: Output current (A) - 1.3.6.1.4.1.6574.4.5.3.1
+      - name: upsOutputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.5.3.2
+        type: Float
+        help: Nominal output current (A) - 1.3.6.1.4.1.6574.4.5.3.2
+      - name: upsAmbientTemperatureValue
+        oid: 1.3.6.1.4.1.6574.4.6.1.1
+        type: Float
+        help: Ambient temperature (degrees C) - 1.3.6.1.4.1.6574.4.6.1.1
+      - name: upsAmbientTemperatureAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.1.2
+        type: DisplayString
+        help: Temperature alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.1.2
+      - name: upsAmbientTemperatureHigh
+        oid: 1.3.6.1.4.1.6574.4.6.1.3
+        type: Float
+        help: Temperature threshold high (degrees C) - 1.3.6.1.4.1.6574.4.6.1.3
+      - name: upsAmbientTemperatureLow
+        oid: 1.3.6.1.4.1.6574.4.6.1.4
+        type: Float
+        help: Temperature threshold low (degrees C) - 1.3.6.1.4.1.6574.4.6.1.4
+      - name: upsAmbientTemperatureMax
+        oid: 1.3.6.1.4.1.6574.4.6.1.5
+        type: Float
+        help: Maximum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.5
+      - name: upsAmbientTemperatureMin
+        oid: 1.3.6.1.4.1.6574.4.6.1.6
+        type: Float
+        help: Minimum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.6
+      - name: upsAmbientHumidityValue
+        oid: 1.3.6.1.4.1.6574.4.6.2.1
+        type: Float
+        help: Ambient relative humidity (percent) - 1.3.6.1.4.1.6574.4.6.2.1
+      - name: upsAmbientHumidityAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.2.2
+        type: DisplayString
+        help: Relative humidity alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.2.2
+      - name: upsAmbientHumidityHigh
+        oid: 1.3.6.1.4.1.6574.4.6.2.3
+        type: Float
+        help: Relative humidity threshold high (percent) - 1.3.6.1.4.1.6574.4.6.2.3
+      - name: upsAmbientHumidityLow
+        oid: 1.3.6.1.4.1.6574.4.6.2.4
+        type: Float
+        help: Relative humidity threshold low (percent) - 1.3.6.1.4.1.6574.4.6.2.4
+      - name: upsAmbientHumidityMax
+        oid: 1.3.6.1.4.1.6574.4.6.2.5
+        type: Float
+        help: Maximum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.5
+      - name: upsAmbientHumidityMin
+        oid: 1.3.6.1.4.1.6574.4.6.2.6
+        type: Float
+        help: Minimum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.6
+      - name: upsDriverName
+        oid: 1.3.6.1.4.1.6574.4.7.1
+        type: DisplayString
+        help: Driver name - 1.3.6.1.4.1.6574.4.7.1
+      - name: upsDriverVersion
+        oid: 1.3.6.1.4.1.6574.4.7.2
+        type: DisplayString
+        help: Driver version (NUT release) - 1.3.6.1.4.1.6574.4.7.2
+      - name: upsDriverVersionData
+        oid: 1.3.6.1.4.1.6574.4.7.3
+        type: DisplayString
+        help: Driver version data - 1.3.6.1.4.1.6574.4.7.3
+      - name: upsDriverVersionInternal
+        oid: 1.3.6.1.4.1.6574.4.7.4
+        type: DisplayString
+        help: Internal driver version (if tracked separately) - 1.3.6.1.4.1.6574.4.7.4
+      - name: upsDriverPollInterval
+        oid: 1.3.6.1.4.1.6574.4.7.5
+        type: gauge
+        help: Poll interval setup in configuration file - 1.3.6.1.4.1.6574.4.7.5
+      - name: upsDriverPort
+        oid: 1.3.6.1.4.1.6574.4.7.6
+        type: DisplayString
+        help: Port setup in configuration file - 1.3.6.1.4.1.6574.4.7.6
+      - name: upsDriverPollFrequency
+        oid: 1.3.6.1.4.1.6574.4.7.7
+        type: gauge
+        help: Poll frequency - 1.3.6.1.4.1.6574.4.7.7
+      - name: upsDriverProductID
+        oid: 1.3.6.1.4.1.6574.4.7.8
+        type: DisplayString
+        help: Product ID - 1.3.6.1.4.1.6574.4.7.8
+      - name: upsDriverSnmpVersion
+        oid: 1.3.6.1.4.1.6574.4.7.9
+        type: DisplayString
+        help: Snmp version - 1.3.6.1.4.1.6574.4.7.9
+      - name: upsServerInfo
+        oid: 1.3.6.1.4.1.6574.4.8.1
+        type: DisplayString
+        help: Server information - 1.3.6.1.4.1.6574.4.8.1
+      - name: upsServerVersion
+        oid: 1.3.6.1.4.1.6574.4.8.2
+        type: DisplayString
+        help: Server version - 1.3.6.1.4.1.6574.4.8.2
+      - name: diskSMARTInfoIndex
+        oid: 1.3.6.1.4.1.6574.5.1.1.1
+        type: gauge
+        help: SMART info index - 1.3.6.1.4.1.6574.5.1.1.1
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTInfoDevName
+        oid: 1.3.6.1.4.1.6574.5.1.1.2
+        type: OctetString
+        help: SMART info device name - 1.3.6.1.4.1.6574.5.1.1.2
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrName
+        oid: 1.3.6.1.4.1.6574.5.1.1.3
+        type: OctetString
+        help: SMART attribute name - 1.3.6.1.4.1.6574.5.1.1.3
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrId
+        oid: 1.3.6.1.4.1.6574.5.1.1.4
+        type: gauge
+        help: SMART attribute ID - 1.3.6.1.4.1.6574.5.1.1.4
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrCurrent
+        oid: 1.3.6.1.4.1.6574.5.1.1.5
+        type: gauge
+        help: SMART attribute current value - 1.3.6.1.4.1.6574.5.1.1.5
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrWorst
+        oid: 1.3.6.1.4.1.6574.5.1.1.6
+        type: gauge
+        help: SMART attribute worst value - 1.3.6.1.4.1.6574.5.1.1.6
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrThreshold
+        oid: 1.3.6.1.4.1.6574.5.1.1.7
+        type: gauge
+        help: SMART attribute threshold value - 1.3.6.1.4.1.6574.5.1.1.7
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrRaw
+        oid: 1.3.6.1.4.1.6574.5.1.1.8
+        type: gauge
+        help: SMART attribute raw value - 1.3.6.1.4.1.6574.5.1.1.8
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrStatus
+        oid: 1.3.6.1.4.1.6574.5.1.1.9
+        type: OctetString
+        help: SMART attribute status - 1.3.6.1.4.1.6574.5.1.1.9
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: serviceInfoIndex
+        oid: 1.3.6.1.4.1.6574.6.1.1.1
+        type: gauge
+        help: Service info index - 1.3.6.1.4.1.6574.6.1.1.1
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceName
+        oid: 1.3.6.1.4.1.6574.6.1.1.2
+        type: OctetString
+        help: Service name - 1.3.6.1.4.1.6574.6.1.1.2
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceUsers
+        oid: 1.3.6.1.4.1.6574.6.1.1.3
+        type: gauge
+        help: Number of users using this service - 1.3.6.1.4.1.6574.6.1.1.3
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+    ubiquiti_airfiber:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: airFiberConfigIndex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.1
+        type: gauge
+        help: Index for the airFiberConfig - 1.3.6.1.4.1.41112.1.3.1.1.1
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: radioEnable
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.2
+        type: gauge
+        help: Radio Enabled State (Enabled/Disabled) - 1.3.6.1.4.1.41112.1.3.1.1.2
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: radioLinkMode
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.3
+        type: gauge
+        help: Radio Operating Mode - 1.3.6.1.4.1.41112.1.3.1.1.3
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: master
+          2: slave
+          3: spectral
+      - name: radioDuplex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.4
+        type: gauge
+        help: Radio Duplex Mode - 1.3.6.1.4.1.41112.1.3.1.1.4
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: halfDuplex
+          2: fullDuplex
+      - name: txFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.5
+        type: gauge
+        help: TX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.5
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.6
+        type: gauge
+        help: RX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.6
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: regDomain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.7
+        type: DisplayString
+        help: Regulatory Domain - 1.3.6.1.4.1.41112.1.3.1.1.7
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: gpsSync
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.8
+        type: gauge
+        help: GPS Synchronization state (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.8
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: txPower
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.9
+        type: gauge
+        help: Radio Transmit Power Setting (dBm) - 1.3.6.1.4.1.41112.1.3.1.1.9
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxGain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.10
+        type: gauge
+        help: Radio Receiver Gain Setting - 1.3.6.1.4.1.41112.1.3.1.1.10
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: low
+          2: high
+      - name: maxTxModRate
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.11
+        type: gauge
+        help: Maximum TX Modulation Rate - 1.3.6.1.4.1.41112.1.3.1.1.11
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: modRateControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.12
+        type: gauge
+        help: Transmit Modulation Rate Control - 1.3.6.1.4.1.41112.1.3.1.1.12
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: manual
+          2: automatic
+      - name: ethDPortLinkSpeed
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.13
+        type: gauge
+        help: Ethernet Data Port Configuration - 1.3.6.1.4.1.41112.1.3.1.1.13
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: auto
+          2: half-10Mbps
+          3: half-100Mbps
+          4: full-10Mbps
+          5: full-100Mbps
+          6: full-1000Mbps
+      - name: linkName
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.14
+        type: DisplayString
+        help: Radio Link Name - 1.3.6.1.4.1.41112.1.3.1.1.14
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: encryptKey
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.15
+        type: DisplayString
+        help: Radio Link Encryption Key - 1.3.6.1.4.1.41112.1.3.1.1.15
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethFlowControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.16
+        type: gauge
+        help: Ethernet DATA port Flow Control (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.16
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethMcastFilter
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.17
+        type: gauge
+        help: Ethernet DATA port Multicast Filter - 1.3.6.1.4.1.41112.1.3.1.1.17
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethTrackRFLink
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.18
+        type: gauge
+        help: Enable Ethernet DATA port state to track RF Link - 1.3.6.1.4.1.41112.1.3.1.1.18
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: use-Timers
+          2: enabled
+      - name: ethLinkOffDuration
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.19
+        type: gauge
+        help: Duration (seconds) of Ethernet Link Drop when ethTrackRFLink is set to Use-Timers
+          - 1.3.6.1.4.1.41112.1.3.1.1.19
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethLinkOffSpacing
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.20
+        type: gauge
+        help: Spacing (seconds) of consecutive Etherenet Link Drops when ethTrackLink
+          is set to Use-Timers - 1.3.6.1.4.1.41112.1.3.1.1.20
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.21
+        type: gauge
+        help: First configured TX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.21
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.22
+        type: gauge
+        help: First configured RX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.22
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.23
+        type: gauge
+        help: Second configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.23
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.24
+        type: gauge
+        help: Second configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.24
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.25
+        type: gauge
+        help: Third configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.25
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.26
+        type: gauge
+        help: Third configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.26
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: channelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.27
+        type: gauge
+        help: Current RF Channel Bandwidth - 1.3.6.1.4.1.41112.1.3.1.1.27
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.28
+        type: gauge
+        help: Current TX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.28
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.29
+        type: gauge
+        help: Current RX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.29
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: airFiberStatusIndex
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.1
+        type: gauge
+        help: Index for the air0 interface - 1.3.6.1.4.1.41112.1.3.2.1.1
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: curTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.2
+        type: gauge
+        help: Current Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.2
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: radioLinkDistFt
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.3
+        type: gauge
+        help: Radio Link Distance (Feet) - 1.3.6.1.4.1.41112.1.3.2.1.3
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkDistM
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.4
+        type: gauge
+        help: Radio Link Distance (Meters) - 1.3.6.1.4.1.41112.1.3.2.1.4
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.5
+        type: gauge
+        help: Radio Receive Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.5
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: txCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.6
+        type: gauge
+        help: Radio Transmit Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.6
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.7
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.7
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.8
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.8
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.9
+        type: gauge
+        help: Radio Chain 1 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.9
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.10
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.10
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.11
+        type: gauge
+        help: Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.11
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.12
+        type: gauge
+        help: Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.12
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.13
+        type: gauge
+        help: Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.13
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.14
+        type: gauge
+        help: Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.14
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.15
+        type: gauge
+        help: Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.15
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.16
+        type: gauge
+        help: Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.16
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteTXPower
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.17
+        type: gauge
+        help: Remote Radio Transmit Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.17
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.18
+        type: gauge
+        help: Remote Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.18
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: remoteRXPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.19
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.19
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.20
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.20
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower0Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.21
+        type: gauge
+        help: Remote Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.21
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.22
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.22
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.23
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.23
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.24
+        type: gauge
+        help: Remote Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.24
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: countryCode
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.25
+        type: gauge
+        help: Configured Country Code - 1.3.6.1.4.1.41112.1.3.2.1.25
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.26
+        type: gauge
+        help: Radio Link State - 1.3.6.1.4.1.41112.1.3.2.1.26
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: ethDataPortState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.27
+        type: gauge
+        help: Ethernet Data Port State - 1.3.6.1.4.1.41112.1.3.2.1.27
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: gpsPulse
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.28
+        type: DisplayString
+        help: GPS Pulse Detected - 1.3.6.1.4.1.41112.1.3.2.1.28
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsFix
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.29
+        type: DisplayString
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.3.2.1.29
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLat
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.30
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.3.2.1.30
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLong
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.31
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.3.2.1.31
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.32
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.3.2.1.32
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.33
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.3.2.1.33
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.34
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.3.2.1.34
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.35
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.3.2.1.35
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.36
+        type: OctetString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.3.2.1.36
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.37
+        type: DisplayString
+        help: Radio DFS State - 1.3.6.1.4.1.41112.1.3.2.1.37
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: upTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.38
+        type: gauge
+        help: Board uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.38
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dateTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.39
+        type: DisplayString
+        help: Board date and time - 1.3.6.1.4.1.41112.1.3.2.1.39
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: fwVersion
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.40
+        type: DisplayString
+        help: Board Firmware Revision - 1.3.6.1.4.1.41112.1.3.2.1.40
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXGain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.41
+        type: DisplayString
+        help: Remote radio Receiver Gain - 1.3.6.1.4.1.41112.1.3.2.1.41
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.42
+        type: DisplayString
+        help: Radio Link Connection Information - 1.3.6.1.4.1.41112.1.3.2.1.42
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: ethDataPortInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.43
+        type: DisplayString
+        help: Ethernet Data Port Link Connection Speed - 1.3.6.1.4.1.41112.1.3.2.1.43
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: linkUpTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.44
+        type: gauge
+        help: Radio Link uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.44
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteMAC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.45
+        type: DisplayString
+        help: Remote radio MAC Address - 1.3.6.1.4.1.41112.1.3.2.1.45
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteIP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.46
+        type: DisplayString
+        help: Remote radio IP Address - 1.3.6.1.4.1.41112.1.3.2.1.46
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDetections
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.47
+        type: gauge
+        help: Number of DFS Detections since boot - 1.3.6.1.4.1.41112.1.3.2.1.47
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDomain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.48
+        type: DisplayString
+        help: DFS Regulatory Domain for current TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.48
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.49
+        type: DisplayString
+        help: State of first TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.49
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.50
+        type: DisplayString
+        help: State of second TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.50
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.51
+        type: DisplayString
+        help: State of third TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.51
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.52
+        type: gauge
+        help: Seconds remaining before first TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.52
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.53
+        type: gauge
+        help: Seconds remaining before second TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.53
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.54
+        type: gauge
+        help: Seconds remaining before third TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.54
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: airFiberStatisticsIndex
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.1
+        type: gauge
+        help: Index for the airFiberStatus - 1.3.6.1.4.1.41112.1.3.3.1.1
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.2
+        type: counter
+        help: Eth Data Port TX Frames - 1.3.6.1.4.1.41112.1.3.3.1.2
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.3
+        type: counter
+        help: Eth Data Port RX Frames - 1.3.6.1.4.1.41112.1.3.3.1.3
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.4
+        type: counter
+        help: Eth Data Port CRC Errors - 1.3.6.1.4.1.41112.1.3.3.1.4
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxAlignErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.5
+        type: counter
+        help: Eth Data Port Receive Alignment Errors - 1.3.6.1.4.1.41112.1.3.3.1.5
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.6
+        type: counter
+        help: Eth Data Port TX Octets - 1.3.6.1.4.1.41112.1.3.3.1.6
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.7
+        type: counter
+        help: Eth Data Port RX Octets - 1.3.6.1.4.1.41112.1.3.3.1.7
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.8
+        type: counter
+        help: Eth Data Port Pause Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.8
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.9
+        type: counter
+        help: Eth Data Port Pause Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.9
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.10
+        type: counter
+        help: Eth Data Port Bad Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.10
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.11
+        type: counter
+        help: Eth Data Port Bad Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.11
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.12
+        type: counter
+        help: Eth Data Port Unicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.12
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.13
+        type: counter
+        help: Eth Data Port Multicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.13
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.14
+        type: counter
+        help: Eth Data Port Broadcast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.14
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.15
+        type: counter
+        help: Eth Data Port Unicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.15
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.16
+        type: counter
+        help: Eth Data Port Multicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.16
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.17
+        type: counter
+        help: Eth Data Port Broadcast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.17
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxDroppedMacErrFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.18
+        type: counter
+        help: Eth Data Port Dropped MAC Receive Errors - 1.3.6.1.4.1.41112.1.3.3.1.18
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalOctets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.19
+        type: counter
+        help: Eth Data Port Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.19
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.20
+        type: counter
+        help: Eth Data Port Total Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.20
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxLess64ByteFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.21
+        type: counter
+        help: Eth Data Port Undersized Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.21
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOverLengthFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.22
+        type: counter
+        help: Eth Data Port Over Max Length Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.22
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx64BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.23
+        type: counter
+        help: Eth Data Port 64 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.23
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx65_127BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.24
+        type: counter
+        help: Eth Data Port 65-127 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.24
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx128_255BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.25
+        type: counter
+        help: Eth Data Port 128-256 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.25
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx256_511BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.26
+        type: counter
+        help: Eth Data Port 256-511 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.26
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx512_1023BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.27
+        type: counter
+        help: Eth Data Port 512-1023 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.27
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1024_1518BytesPackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.28
+        type: counter
+        help: Eth Data Port 1024-1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.28
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1519PlusBytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.29
+        type: counter
+        help: Eth Data Port Greater Than 1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.29
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooLongFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.30
+        type: counter
+        help: Eth Data Port Too Long Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.30
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooShortFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.31
+        type: counter
+        help: Eth Data Port Too Short Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.31
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.32
+        type: counter
+        help: RF TX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.32
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.33
+        type: counter
+        help: RF TX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.33
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.34
+        type: counter
+        help: RF TX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.34
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.35
+        type: counter
+        help: RF TX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.35
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.36
+        type: counter
+        help: RF TX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.36
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.37
+        type: counter
+        help: RF TX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.37
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.38
+        type: counter
+        help: RF TX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.38
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.39
+        type: counter
+        help: RF TX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.39
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.40
+        type: counter
+        help: RF TX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.40
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.41
+        type: counter
+        help: RF TX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.41
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.42
+        type: counter
+        help: RF TX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.42
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.43
+        type: counter
+        help: RF TX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.43
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.44
+        type: counter
+        help: RF TX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.44
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.45
+        type: counter
+        help: RF TX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.45
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.46
+        type: counter
+        help: RF TX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.46
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.47
+        type: counter
+        help: RF TX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.47
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.48
+        type: counter
+        help: RF RX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.48
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.49
+        type: counter
+        help: RF RX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.49
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.50
+        type: counter
+        help: RF RX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.50
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.51
+        type: counter
+        help: RF RX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.51
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.52
+        type: counter
+        help: RF RX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.52
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.53
+        type: counter
+        help: RF RX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.53
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.54
+        type: counter
+        help: RF RX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.54
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.55
+        type: counter
+        help: RF RX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.55
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.56
+        type: counter
+        help: RF RX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.56
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.57
+        type: counter
+        help: RF RX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.57
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.58
+        type: counter
+        help: RF RX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.58
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.59
+        type: counter
+        help: RF RX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.59
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.60
+        type: counter
+        help: RF RX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.60
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.61
+        type: counter
+        help: RF RX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.61
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.62
+        type: counter
+        help: RF RX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.62
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.63
+        type: counter
+        help: RF RX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.63
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.64
+        type: counter
+        help: RF Total Octets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.64
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.65
+        type: counter
+        help: RF Total Packets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.65
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.66
+        type: counter
+        help: RF Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.66
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.67
+        type: counter
+        help: RF Total Packets Received - 1.3.6.1.4.1.41112.1.3.3.1.67
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      version: 1
+    ubiquiti_airmax:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ubntHostLocaltime
+        oid: 1.3.6.1.4.1.41112.1.4.8.1
+        type: DisplayString
+        help: Host local time - 1.3.6.1.4.1.41112.1.4.8.1
+      - name: ubntHostNetrole
+        oid: 1.3.6.1.4.1.41112.1.4.8.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.8.2
+        enum_values:
+          0: unknown
+          1: bridge
+          2: router
+          3: soho
+      - name: ubntHostCpuLoad
+        oid: 1.3.6.1.4.1.41112.1.4.8.3
+        type: gauge
+        help: Host CPU load - 1.3.6.1.4.1.41112.1.4.8.3
+      - name: ubntHostTemperature
+        oid: 1.3.6.1.4.1.41112.1.4.8.4
+        type: gauge
+        help: Host system temperature - 1.3.6.1.4.1.41112.1.4.8.4
+      - name: ubntGpsStatus
+        oid: 1.3.6.1.4.1.41112.1.4.9.1
+        type: gauge
+        help: GPS status - 1.3.6.1.4.1.41112.1.4.9.1
+        enum_values:
+          0: absent
+          1: "off"
+          2: "on"
+      - name: ubntGpsFix
+        oid: 1.3.6.1.4.1.41112.1.4.9.2
+        type: gauge
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.4.9.2
+        enum_values:
+          0: unknown
+          1: nofix
+          2: fix2d
+          3: fix3d
+      - name: ubntGpsLat
+        oid: 1.3.6.1.4.1.41112.1.4.9.3
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.4.9.3
+      - name: ubntGpsLon
+        oid: 1.3.6.1.4.1.41112.1.4.9.4
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.4.9.4
+      - name: ubntGpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.4.9.5
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.4.9.5
+      - name: ubntGpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.4.9.6
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.4.9.6
+      - name: ubntGpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.4.9.7
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.4.9.7
+      - name: ubntGpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.4.9.8
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.4.9.8
+      - name: ubntGpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.4.9.9
+        type: DisplayString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.4.9.9
+      - name: ubntRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.1
+        type: gauge
+        help: Index for the ubntRadioTable - 1.3.6.1.4.1.41112.1.4.1.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioMode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.1.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: sta
+          2: ap
+          3: aprepeater
+          4: apwds
+      - name: ubntRadioCCode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.3
+        type: gauge
+        help: Country code - 1.3.6.1.4.1.41112.1.4.1.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioFreq
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.4
+        type: gauge
+        help: Operating frequency - 1.3.6.1.4.1.41112.1.4.1.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDfsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.5
+        type: gauge
+        help: DFS status - 1.3.6.1.4.1.41112.1.4.1.1.5
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntRadioTxPower
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.6
+        type: gauge
+        help: Transmit power - 1.3.6.1.4.1.41112.1.4.1.1.6
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDistance
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.7
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.1.1.7
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioChainmask
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.8
+        type: gauge
+        help: Chainmask - 1.3.6.1.4.1.41112.1.4.1.1.8
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioAntenna
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.9
+        type: DisplayString
+        help: Antenna - 1.3.6.1.4.1.41112.1.4.1.1.9
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioRssiIndex
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.1
+        type: gauge
+        help: Index for the ubntRadioRssiTable - 1.3.6.1.4.1.41112.1.4.2.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssi
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.2
+        type: gauge
+        help: Data frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiMgmt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.3
+        type: gauge
+        help: Management frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiExt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.4
+        type: gauge
+        help: Extension channel rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntAirMaxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.7
+        type: gauge
+        help: airMAX Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.6.1.7
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxGpsSync
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.8
+        type: gauge
+        help: airMAX GPS sync - on/off - 1.3.6.1.4.1.41112.1.4.6.1.8
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxTdd
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.9
+        type: gauge
+        help: airMAX TDD framing - on/off - 1.3.6.1.4.1.41112.1.4.6.1.9
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.1
+        type: gauge
+        help: Index for the ubntAirMaxTable - 1.3.6.1.4.1.41112.1.4.6.1.1
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.2
+        type: gauge
+        help: airMAX status - on/off - 1.3.6.1.4.1.41112.1.4.6.1.2
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxQuality
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.3
+        type: gauge
+        help: airMAX quality - percentage - 1.3.6.1.4.1.41112.1.4.6.1.3
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.4
+        type: gauge
+        help: airMAX capacity - percentage - 1.3.6.1.4.1.41112.1.4.6.1.4
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxPriority
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.5
+        type: gauge
+        help: airMAX priority - none/high/low/medium - 1.3.6.1.4.1.41112.1.4.6.1.5
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          0: high
+          1: medium
+          2: low
+          3: none
+      - name: ubntAirMaxNoAck
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.6
+        type: gauge
+        help: airMAX NoACK mode - on/off - 1.3.6.1.4.1.41112.1.4.6.1.6
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSyncIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.1
+        type: gauge
+        help: Index for the ubntAirSyncTable - 1.3.6.1.4.1.41112.1.4.3.1.1
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncMode
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.2
+        type: gauge
+        help: airSync mode - master/slave - 1.3.6.1.4.1.41112.1.4.3.1.2
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: master
+          2: slave
+      - name: ubntAirSyncCount
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.3
+        type: gauge
+        help: airSync client count - 1.3.6.1.4.1.41112.1.4.3.1.3
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncDownUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.4
+        type: gauge
+        help: airSync down utilization - 1.3.6.1.4.1.41112.1.4.3.1.4
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncUpUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.5
+        type: gauge
+        help: airSync up utilization - 1.3.6.1.4.1.41112.1.4.3.1.5
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSelIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.1
+        type: gauge
+        help: Index for the ubntAirSelTable - 1.3.6.1.4.1.41112.1.4.4.1.1
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntAirSelEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.2
+        type: gauge
+        help: airSelect status - on/off - 1.3.6.1.4.1.41112.1.4.4.1.2
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSelInterval
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.3
+        type: gauge
+        help: airSelect hop interval (miliseconds) - 1.3.6.1.4.1.41112.1.4.4.1.3
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntWlStatIndex
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.1
+        type: gauge
+        help: Index for the ubntWlStatTable - 1.3.6.1.4.1.41112.1.4.5.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.2
+        type: DisplayString
+        help: SSID - 1.3.6.1.4.1.41112.1.4.5.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatHideSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.3
+        type: gauge
+        help: Hide SSID - on/off - 1.3.6.1.4.1.41112.1.4.5.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApMac
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.4
+        type: PhysAddress48
+        help: AP MAC address - 1.3.6.1.4.1.41112.1.4.5.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSignal
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.5
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.5.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRssi
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.6
+        type: gauge
+        help: RSSI, dBm - 1.3.6.1.4.1.41112.1.4.5.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatCcq
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.7
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.5.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.8
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.5.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.9
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.5.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.10
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.5.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSecurity
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.11
+        type: DisplayString
+        help: Wireless security mode - 1.3.6.1.4.1.41112.1.4.5.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatWdsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.12
+        type: gauge
+        help: WDS - on/off - 1.3.6.1.4.1.41112.1.4.5.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApRepeater
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.13
+        type: gauge
+        help: AP repeater - on/off - 1.3.6.1.4.1.41112.1.4.5.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatChanWidth
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.14
+        type: gauge
+        help: Channel Width - 1.3.6.1.4.1.41112.1.4.5.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatStaCount
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.15
+        type: gauge
+        help: Station count - 1.3.6.1.4.1.41112.1.4.5.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntStaLocalCINR
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.16
+        type: gauge
+        help: Local CINR - 1.3.6.1.4.1.41112.1.4.7.1.16
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.17
+        type: gauge
+        help: Uplink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.17
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.18
+        type: gauge
+        help: Downlink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.18
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.19
+        type: gauge
+        help: Uplink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.19
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.20
+        type: gauge
+        help: Downlink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.20
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxLatency
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.21
+        type: gauge
+        help: Uplink Latency in milliseconds - 1.3.6.1.4.1.41112.1.4.7.1.21
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaMac
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.1
+        type: PhysAddress48
+        help: Station MAC address - 1.3.6.1.4.1.41112.1.4.7.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaName
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.2
+        type: DisplayString
+        help: Station name - 1.3.6.1.4.1.41112.1.4.7.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaSignal
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.3
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.7.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.4
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.7.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaDistance
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.5
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.7.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaCcq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.6
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.7.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.7
+        type: gauge
+        help: airMAX priority - 1.3.6.1.4.1.41112.1.4.7.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.8
+        type: gauge
+        help: airMAX quality - 1.3.6.1.4.1.41112.1.4.7.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmc
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.9
+        type: gauge
+        help: airMAX capacity - 1.3.6.1.4.1.41112.1.4.7.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaLastIp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.10
+        type: InetAddressIPv4
+        help: Last known IP address - 1.3.6.1.4.1.41112.1.4.7.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.11
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.12
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.7.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.13
+        type: counter
+        help: TX bytes - 1.3.6.1.4.1.41112.1.4.7.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.14
+        type: counter
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaConnTime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.15
+        type: gauge
+        help: Connection Time in seconds - 1.3.6.1.4.1.41112.1.4.7.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      version: 1
+    ubiquiti_unifi:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: unifiRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.1'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioName
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.2
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.2'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.3'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.4
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.4'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.5'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuTotal
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.6
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.6'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfRx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.7
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.7'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfTx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.8'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioOtherBss
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.9
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.9'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiVapIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.1'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapBssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.2
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.2'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapCcq
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.3
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.3'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.4
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.4'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapExtChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.5
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.5'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapEssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.6'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapName
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.7
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.7'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapNumStations
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.8'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.9
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.9'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.10'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxCrypts
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.11
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.11'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.12'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.13'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxFrags
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.14'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.15'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.16
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.16'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.17
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.17'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.18
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.18'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.19
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.19'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxRetries
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.20
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.20'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPower
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.21
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.21'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapUp
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.22
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.22'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiVapUsage
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        type: DisplayString
+        help: guest or regular user - 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiIfIndex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.1'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfFullDuplex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.2'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiIfIp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.3
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.3'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfMac
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.4
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.4'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfName
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.5
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.5'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.6
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.6'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.7
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.7'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.8
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.8'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxMulticast
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.9
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.9'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.10'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfSpeed
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.11
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.11'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.12'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.13'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.14'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.15'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfUp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.16
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.16'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemIp
+        oid: 1.3.6.1.4.1.41112.1.6.3.1
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.1'
+      - name: unifiApSystemIsolated
+        oid: 1.3.6.1.4.1.41112.1.6.3.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.2'
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemModel
+        oid: 1.3.6.1.4.1.41112.1.6.3.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.3'
+      - name: unifiApSystemUplink
+        oid: 1.3.6.1.4.1.41112.1.6.3.4
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.4'
+      - name: unifiApSystemUptime
+        oid: 1.3.6.1.4.1.41112.1.6.3.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.5'
+      - name: unifiApSystemVersion
+        oid: 1.3.6.1.4.1.41112.1.6.3.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.6'
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5aef90febced06d2c3b57c4c07d7a1b9281fb269
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
@@ -0,0 +1,54 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    {{- include "snmpexporter.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "snmpexporter.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      labels:
+        {{- include "snmpexporter.selectorLabels" . | nindent 8 }}
+    spec:
+      securityContext:
+        runAsUser: 0
+      initContainers:
+        - name: init-config
+          image: busybox:1.28
+          command: ['sh', '-c', 'if [ ! -f "/etc/snmp_exporter/snmp.yml" ]; then cp /etc/snmp_exporter_init/snmp.yml /etc/snmp_exporter; fi']
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+            - name: init-config-volume
+              mountPath: /etc/snmp_exporter_init
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.version }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - containerPort: 9116
+              protocol: TCP
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+          livenessProbe:
+            exec:
+              command:
+                - /bin/sh
+                - -c
+                - if [ ! -f "/etc/snmp_exporter/generator.yml" ]; then exit 0; else rm -f /etc/snmp_exporter/generator.yml && exit 1; fi
+            failureThreshold: 1
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+      volumes:
+        - name: config-volume
+          hostPath: 
+            path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+        - name: init-config-volume
+          configMap:
+            name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower }}"
+          
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/generator.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/generator.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..96f7e237d85cecfba6f7047c169ba09fdcb8865e
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/generator.yaml
@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower }}"
+data:
+  generator.yml: |-
+    {{ .Files.Get "snmp/generator.yml" | nindent 4}}
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/mibs.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/mibs.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e7b5eab55038ea9e0d17d7c8d0b9fc7dc15ddfe6
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/mibs.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+{{ (.Files.Glob "snmp/mibs/**").AsConfig | indent 2 }}
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/service.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6ec5fb4fb4153956026d8bbb77439ca1cf6234aa
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    {{- include "snmpexporter.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: 9116
+      protocol: TCP
+      name: snmp
+  selector:
+    {{- include "snmpexporter.selectorLabels" . | nindent 4 }}
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/values.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/values.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cbe306fa4886e327d4887e771cc658d4c0a35d7c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/charts/snmpexporter/values.yaml
@@ -0,0 +1,14 @@
+# Default values for snmpexporter.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: prom/snmp-exporter
+  version: v0.17.0
+  pullPolicy: IfNotPresent
+
+service:
+  type: ClusterIP
+  port: 80
\ No newline at end of file
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/prometheus-job-template.j2 b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/prometheus-job-template.j2
new file mode 100644
index 0000000000000000000000000000000000000000..f82adfc1b6fcb70ec0c1d3efd13813439af5f49b
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/prometheus-job-template.j2
@@ -0,0 +1,15 @@
+-   job_name: '{{ JOB_NAME }}'
+    static_configs:
+      - targets:
+          - {{ TARGET_IP }}
+    metrics_path: /snmp
+    params:
+        module: [ osm-snmp ] 
+    relabel_configs:
+      - source_labels: [__address__]
+        target_label: __param_target
+      - source_labels: [__param_target]
+        target_label: instance
+      - target_label: __address__
+        replacement: {{ EXPORTER_POD_IP }}:{{ EXPORTER_POD_PORT }}  # The SNMP exporter's real hostname:port.
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/install.sh b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/install.sh
new file mode 100644
index 0000000000000000000000000000000000000000..175f4b6f9d5108e06b96585b0106d5907e9ccdb0
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/install.sh
@@ -0,0 +1,32 @@
+#!/bin/bash
+##
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+echo "installing libraries for snmp generator"
+
+#apt-get install -y ...
+apt-get update
+
+apt-get install -y python3-pip unzip build-essential libsnmp-dev wget curl
+curl -s https://storage.googleapis.com/golang/go1.11.8.linux-amd64.tar.gz | tar -v -C /usr/local -xz
+export PATH=$PATH:/usr/local/go/bin
+export GOPATH=/go
+
+go get github.com/go-logfmt/logfmt && go get github.com/go-kit/kit/log
+
+wget -q https://github.com/prometheus/snmp_exporter/archive/v0.17.0.tar.gz -P /tmp/ \
+&& tar -C /tmp -xf /tmp/v0.17.0.tar.gz \
+&& (cd /tmp/snmp_exporter-0.17.0/generator && go build) \
+&& cp /tmp/snmp_exporter-0.17.0/generator/generator /usr/local/bin/snmp_generator
+
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/vnf_ee.py b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/vnf_ee.py
new file mode 100644
index 0000000000000000000000000000000000000000..a05012f78635f831a6171a08b6673106383a0fe1
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/source/vnf_ee.py
@@ -0,0 +1,69 @@
+##
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##
+
+import asyncio
+import logging
+import os
+
+
+from osm_ee.exceptions import VnfException
+
+import osm_ee.util.util_ee as util_ee
+
+
+class VnfEE:
+
+    def __init__(self, config_params):
+        self.logger = logging.getLogger('osm_ee.vnf')
+        self.config_params = config_params
+
+    async def config(self, id, params):
+        self.logger.debug("Execute action config params: {}".format(params))
+        # Config action is special, params are merged with previous config calls
+        self.config_params.update(params)
+        required_params = ["ssh-hostname"]
+        self._check_required_params(self.config_params, required_params)
+        yield "OK", "Configured"
+
+    async def sleep(self, id, params):
+        self.logger.debug("Execute action sleep, params: {}".format(params))
+
+        for i in range(3):
+            await asyncio.sleep(5)
+            self.logger.debug("Temporal result return, params: {}".format(params))
+            yield "PROCESSING", f"Processing {i} action id {id}"
+        yield "OK", f"Processed action id {id}"
+
+    async def generate_snmp(self, id, params):
+        self.logger.debug("Executing SNMP exporter configuration generation\nWith params: {}".format(params))
+
+        commands =  ("cp /app/vnf/generator/generator.yml ./",
+                     "snmp_generator generate --output-path=/etc/snmp_exporter/snmp.yml",
+                     "touch /etc/snmp_exporter/generator.yml")
+        for command in commands:
+            return_code, stdout, stderr = await util_ee.local_async_exec(command)
+            if return_code != 0:
+                yield "ERROR", "return code {}: {}".format(return_code, stderr.decode())
+                break
+        else:
+            yield "OK", stdout.decode()
+
+    @staticmethod
+    def _check_required_params(params, required_params):
+        for required_param in required_params:
+            if required_param not in params:
+                raise VnfException("Missing required param: {}".format(required_param))
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/NOTES.txt b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/NOTES.txt
new file mode 100644
index 0000000000000000000000000000000000000000..c52fc2c419ef6f4cccfb63fd93ca7379bfc04cf7
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/NOTES.txt
@@ -0,0 +1,21 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ . }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "eechart.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "eechart.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "eechart.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "eechart.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl port-forward $POD_NAME 8080:80
+{{- end }}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/_helpers.tpl b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/_helpers.tpl
new file mode 100644
index 0000000000000000000000000000000000000000..d3e28e0260b8bff2fdef09046df0abaea885739c
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/_helpers.tpl
@@ -0,0 +1,56 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "eechart.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "eechart.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "eechart.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Common labels
+*/}}
+{{- define "eechart.labels" -}}
+app.kubernetes.io/name: {{ include "eechart.name" . }}
+helm.sh/chart: {{ include "eechart.chart" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end -}}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "eechart.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create -}}
+    {{ default (include "eechart.fullname" .) .Values.serviceAccount.name }}
+{{- else -}}
+    {{ default "default" .Values.serviceAccount.name }}
+{{- end -}}
+{{- end -}}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/configmap.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/configmap.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5b9634c7e1abe64c6f720f708dd5c9664e72e8cf
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/configmap.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "eechart.fullname" . }}
+data:
+{{ (.Files.Glob "source/*").AsConfig | indent 2 }}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/ingress.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/ingress.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..264f89091bee2ba8746edc2841c275d28fef1168
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/ingress.yaml
@@ -0,0 +1,41 @@
+{{- if .Values.ingress.enabled -}}
+{{- $fullName := include "eechart.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+{{- if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1beta1
+{{- else -}}
+apiVersion: extensions/v1beta1
+{{- end }}
+kind: Ingress
+metadata:
+  name: {{ $fullName }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+{{- if .Values.ingress.tls }}
+  tls:
+  {{- range .Values.ingress.tls }}
+    - hosts:
+      {{- range .hosts }}
+        - {{ . | quote }}
+      {{- end }}
+      secretName: {{ .secretName }}
+  {{- end }}
+{{- end }}
+  rules:
+  {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+        {{- range .paths }}
+          - path: {{ . }}
+            backend:
+              serviceName: {{ $fullName }}
+              servicePort: {{ $svcPort }}
+        {{- end }}
+  {{- end }}
+{{- end }}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/service.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/service.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..88d38d66a3997c6e2a96754582736cfb065da6c2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/service.yaml
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: grpc
+      protocol: TCP
+      name: grpc
+  selector:
+    app.kubernetes.io/name: {{ include "eechart.name" . }}
+    app.kubernetes.io/instance: {{ .Release.Name }}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/serviceaccount.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/serviceaccount.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..be615a5f08c7b557446fa74e5e3619e47d2ee804
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/serviceaccount.yaml
@@ -0,0 +1,8 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ template "eechart.serviceAccountName" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+{{- end -}}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/statefulset.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/statefulset.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9af244dea0fec0be8c13ef81a72a832160986ff3
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/statefulset.yaml
@@ -0,0 +1,65 @@
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  serviceName:  {{ include "eechart.fullname" . }} 
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ include "eechart.name" . }}
+      app.kubernetes.io/instance: {{ .Release.Name }}
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ include "eechart.name" . }}
+        app.kubernetes.io/instance: {{ .Release.Name }}
+    spec:
+      imagePullSecrets:
+      - name: regcred 
+      serviceAccountName: {{ template "eechart.serviceAccountName" . }}
+      securityContext:
+        runAsUser: 0
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: grpc
+              containerPort: 50051
+              protocol: TCP          
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}          
+          volumeMounts:
+          - name: osm-ee
+            mountPath: /app/storage  
+          - name: osm-ee-source
+            mountPath: /app/EE/osm_ee/vnf      
+{{- if .Values.snmpexporter.enabled }}
+          - name: snmp-config-volume
+            mountPath: /etc/snmp_exporter
+          - name: vnf-mibs
+            mountPath: /root/.snmp/mibs
+          - name: vnf-generator
+            mountPath: /app/vnf/generator
+{{- end }}
+      volumes:      
+      - name: osm-ee-source
+        configMap: 
+          name:  {{ include "eechart.fullname" . }}
+      - name: osm-ee
+        hostPath:
+          path: /var/lib/osm/osm/osm_osm_packages/_data
+{{- if .Values.snmpexporter.enabled }}
+      - name: snmp-config-volume
+        hostPath: 
+          path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+      - name: vnf-mibs
+        configMap:
+          name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+      - name: vnf-generator
+        configMap:
+          name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower}}"
+{{- end }}
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/tests/test-connection.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/tests/test-connection.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e52b7b8b2515729e582b5efbc22dc5a0bdb0f3b2
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/templates/tests/test-connection.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "eechart.fullname" . }}-test-connection"
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  annotations:
+    "helm.sh/hook": test-success
+spec:
+  containers:
+    - name: wget
+      image: busybox
+      command: ['wget']
+      args:  ['{{ include "eechart.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/values.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/values.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2aa9348740ac9baf5fbff460db8e70d59c6a1c66
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/helm-charts/eechart/values.yaml
@@ -0,0 +1,47 @@
+global:
+  osm:
+    vnf_id: AVNFId
+
+replicaCount: 1
+
+image:
+  repository: illoret/grpcee
+  tag: latest
+  pullPolicy: IfNotPresent
+
+imagePullSecrets: []
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  create: false
+  name:
+
+podSecurityContext: {}
+
+securityContext: {}
+
+service:
+  type: ClusterIP
+  port: 50050
+
+ingress:
+  enabled: false
+  annotations: {}
+    # kubernetes.io/ingress.class: nginx
+    # kubernetes.io/tls-acme: "true"
+  hosts:
+    - host: chart-example.local
+      paths: []
+  tls: []
+
+resources: {}
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
+
+snmpexporter:
+  enabled: true
diff --git a/SOL004/magma/hackfest_magma-agw-enb_vnfd/magma-agw-enb_vnfd.yaml b/SOL004/magma/hackfest_magma-agw-enb_vnfd/magma-agw-enb_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8c955dae81eb186f284849ba96f15936a321cc22
--- /dev/null
+++ b/SOL004/magma/hackfest_magma-agw-enb_vnfd/magma-agw-enb_vnfd.yaml
@@ -0,0 +1,286 @@
+vnfd:
+  description: Magma AGW v1.0.0 with tools & srsLTE VDU
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: magma-agw-vdu
+      - number-of-instances: 1
+        vdu-id: srsLTE-vdu
+    scaling-aspect:
+    - aspect-delta-details:
+        deltas:
+        - id: vdu_autoscale-delta
+          vdu-delta:
+          - id: magma-agw-vdu
+            number-of-instances: 1
+      id: vdu_autoscale
+      max-scale-level: 1
+      name: vdu_autoscale
+      scaling-policy:
+      - cooldown-time: 120
+        name: cpu_util_above_threshold
+        scaling-criteria:
+        - name: cpu_util_above_threshold
+          scale-in-relational-operation: LT
+          scale-in-threshold: 10
+          scale-out-relational-operation: GT
+          scale-out-threshold: 60
+          vnf-monitoring-param-ref: agw_cpu_util
+        scaling-type: automatic
+        threshold-time: 10
+    vdu-profile:
+    - id: magma-agw-vdu
+      max-number-of-instances: 1
+      min-number-of-instances: 1
+    - id: srsLTE-vdu
+      min-number-of-instances: 1
+    virtual-link-profile:
+    - flavour: ''
+      id: internalS1
+      virtual-link-protocol-data:
+        l3-protocol-data:
+          cidr: 192.168.100.0/24
+          description: S1 test network
+          dhcp-enabled: true
+          ip-version: ipv4
+          name: internalS1-l3-protocol-data
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - id: hackfest_magma-agw-enb_vnfd
+          relation:
+          - entities:
+            - endpoint: mme
+              id: srsLTE-vdu
+            - endpoint: agw
+              id: magma-agw-vdu
+            name: agw
+        - config-access:
+            ssh-access:
+              required: true
+          config-primitive:
+          - name: add-gw
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - default-value: <agw_id>
+              name: agw_id
+            - default-value: <agw_name>
+              name: agw_name
+            - default-value: <orch_ip>
+              name: orch_ip
+            - default-value: <orch_net>
+              name: orch_net
+          - name: del-gw
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - default-value: <agw_id>
+              name: agw_id
+            - default-value: <orch_ip>
+              name: orch_ip
+            - default-value: <orch_net>
+              name: orch_net
+          - name: reset-id
+            execution-environment-ref: magmagw-ee
+          - name: restart-magma
+            execution-environment-ref: magmagw-ee
+          id: magma-agw-vdu
+          execution-environment-list:
+          - id: magmagw-ee
+            juju:
+              charm: magmagw
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: magma
+            - name: ssh-password
+              value: magma
+            seq: 1
+          - name: reset-id
+            execution-environment-ref: magmagw-ee
+            seq: 2
+          - name: add-net
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - name: orch_ip
+              value: <orch_ip>
+            - name: orch_net
+              value: <orch_net>
+            seq: 3
+          - name: add-gw
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - name: agw_id
+              value: <agw_id>
+            - name: agw_name
+              value: <agw_name>
+            - name: orch_ip
+              value: <orch_ip>
+            - name: orch_net
+              value: <orch_net>
+            seq: 4
+          - name: add-test-subscriber
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - name: orch_ip
+              value: <orch_ip>
+            - name: orch_net
+              value: <orch_net>
+            seq: 5
+          - name: add-hosts
+            execution-environment-ref: magmagw-ee
+            parameter:
+            - name: orch_ip
+              value: <orch_ip>
+            seq: 6
+          - name: restart-magma
+            execution-environment-ref: magmagw-ee
+            seq: 7
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: attach-ue
+            execution-environment-ref: srs-enb-ue-ee
+            parameter:
+            - data-type: STRING
+              name: usim-imsi
+            - data-type: STRING
+              name: usim-k
+            - data-type: STRING
+              name: usim-opc
+          - name: detach-ue
+            execution-environment-ref: srs-enb-ue-ee
+          id: srsLTE-vdu
+          execution-environment-list:
+          - id: srs-enb-ue-ee
+            juju:
+              charm: srs-enb-ue
+              proxy: false
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: srs-enb-ue-ee
+            parameter:
+            - name: bind-address-subnet
+              value: 192.168.100.0/24
+            seq: 1
+  ext-cpd:
+  - id: agw-sgi-ext
+    int-cpd:
+      cpd: eth1-int
+      vdu-id: magma-agw-vdu
+  - id: agw-mgmt-ext
+    int-cpd:
+      cpd: eth2-int
+      vdu-id: magma-agw-vdu
+  - id: srsLTE-mgmt-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: srsLTE-vdu
+  id: hackfest_magma-agw-enb_vnfd
+  int-virtual-link-desc:
+  - id: internalS1
+  mgmt-cp: agw-mgmt-ext
+  product-name: hackfest_magma-agw-enb_vnfd
+  provider: Whitestack
+  sw-image-desc:
+  - id: magma101_hfmr9
+    image: magma101_hfmr9
+    name: magma101_hfmr9
+  - id: ubuntu20.04
+    image: ubuntu20.04
+    name: ubuntu20.04
+  vdu:
+  - alarm:
+    - actions:
+        alarm:
+        - url: https://webhook.site/4beb0430-7497-4112-a742-434e50e8081a
+      alarm-id: cpu-above-threshold
+      operation: GT
+      value: 80
+      vnf-monitoring-param-ref: agw_cpu_util
+    cloud-init-file: magmaagw_init
+    description: magma-agw-vdu
+    id: magma-agw-vdu
+    int-cpd:
+    - id: eth0-int
+      int-virtual-link-desc: internalS1
+      virtual-network-interface-requirement:
+      - name: eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: eth1-int
+      virtual-network-interface-requirement:
+      - name: eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    - id: eth2-int
+      virtual-network-interface-requirement:
+      - name: eth2
+        position: 3
+        virtual-interface:
+          type: PARAVIRT
+    monitoring-parameter:
+    - id: agw_cpu_util
+      name: agw_cpu_util
+      performance-metric: cpu_utilization
+    - id: agw_memory_util
+      name: agw_memory_util
+      performance-metric: average_memory_utilization
+    - id: agw_packets_received
+      name: agw_packets_received
+      performance-metric: packets_received
+    - id: agw_packets_sent
+      name: agw_packets_sent
+      performance-metric: packets_sent
+    name: magma-agw-vdu
+    sw-image-desc: magma101_hfmr9
+    virtual-compute-desc: magma-agw-vdu-compute
+    virtual-storage-desc:
+    - magma-agw-vdu-storage
+  - cloud-init-file: srslte_init
+    description: srsLTE-vdu
+    id: srsLTE-vdu
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          type: PARAVIRT
+    - id: eth1-int
+      int-virtual-link-desc: internalS1
+      virtual-network-interface-requirement:
+      - name: eth1
+        virtual-interface:
+          type: PARAVIRT
+    name: srsLTE-vdu
+    sw-image-desc: ubuntu20.04
+    virtual-compute-desc: srsLTE-vdu-compute
+    virtual-storage-desc:
+    - srsLTE-vdu-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: magma-agw-vdu-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 4.0
+  - id: srsLTE-vdu-compute
+    virtual-cpu:
+      num-virtual-cpu: 4
+    virtual-memory:
+      size: 6.0
+  virtual-storage-desc:
+  - id: magma-agw-vdu-storage
+    size-of-storage: 50
+  - id: srsLTE-vdu-storage
+    size-of-storage: 8
diff --git a/SOL004/magma/magma_slice.yaml b/SOL004/magma/magma_slice.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5efa1b47749cb86ca74371e8a3fbea094babef18
--- /dev/null
+++ b/SOL004/magma/magma_slice.yaml
@@ -0,0 +1,43 @@
+# Copyright [2020] [Felipe Vicens]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#NST to test VLD connection between Network Services within the same VIM
+nst:
+-   id: magma_slice_hackfest_nst
+    name: magma_slice_hackfest_nst
+    SNSSAI-identifier:
+        slice-service-type: eMBB
+    quality-of-service:
+        id: 1
+
+    netslice-subnet:
+    -   id: slice_hackfest_nsd_epc
+        is-shared-nss: false
+        description: NetSlice Subnet (service) with magma agw
+        nsd-ref: hackfest_magma-agw-enb_nsd
+    -   id: slice_hackfest_nsd_epcmgmt
+        is-shared-nss: true
+        description: NetSlice Subnet (service) with magma orch and nms
+        nsd-ref: fb_magma_ns
+
+    netslice-vld:
+    -   id: slice_vld_mgmt
+        name: slice_vld_mgmt
+        type: ELAN
+        mgmt-network: true
+        nss-connection-point-ref:
+        -   nss-ref: slice_hackfest_nsd_epc
+            nsd-connection-point-ref: nsd_cp_mgmt
+        -   nss-ref: slice_hackfest_nsd_epcmgmt
+            nsd-connection-point-ref: nsd_cp_mgmt
diff --git a/SOL004/magma/params.yaml b/SOL004/magma/params.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d450b05cc58d74259079770d148685ee6a314990
--- /dev/null
+++ b/SOL004/magma/params.yaml
@@ -0,0 +1,19 @@
+netslice-subnet:
+- id: slice_hackfest_nsd_epc
+  #placement-engine: PLA
+  #wimAccountId: False
+  additionalParamsForVnf:
+  - member-vnf-index: 'MagmaAGWsrsLTE'
+    additionalParams:
+      agw_id: 'agw_100'
+      agw_name: 'AGW100'
+      orch_ip: '172.21.250.199'  ## change this to the MetalLB IP address of your orc8r_proxy service.
+      orch_net: 'osmnet'
+
+- id: slice_hackfest_nsd_epcmgmt
+  additionalParamsForVnf:
+  - member-vnf-index: 'orc8r'
+    additionalParamsForKdu:
+    - kdu_name: orc8r  
+      additionalParams:
+        proxyserviceloadBalancerIP: '172.21.250.199' # MetalLB IP Address
diff --git a/SOL004/magma/pdu.yaml b/SOL004/magma/pdu.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aa1da0ab9a12bb3b9e291be377390ffb378a79dd
--- /dev/null
+++ b/SOL004/magma/pdu.yaml
@@ -0,0 +1,12 @@
+name:           router01
+description:    router
+type:           gateway
+vim_accounts: [ 42ee7fda-2996-4de0-877f-61abc792ad92 ]
+shared:         false
+interfaces:
+ -  name:       eth0
+    ip-address: 172.21.250.200
+    mgmt:       true
+ -  name:       eth1
+    ip-address: 192.168.239.7
+    mgmt:       false
diff --git a/SOL004/magma/pil_price_list.yaml b/SOL004/magma/pil_price_list.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..71d500bfd22815749352dd638f87f302eb617c53
--- /dev/null
+++ b/SOL004/magma/pil_price_list.yaml
@@ -0,0 +1,8 @@
+pil:
+  - pil_description: Link between OpenStack1 and OpenStack2
+    pil_price: 0
+    pil_latency: 0
+    pil_jitter: 0
+    pil_endpoints:
+      - http://172.21.7.5:5000/v3
+      - http://172.21.247.1:5000/v3
diff --git a/SOL004/magma/sdn_port_mapping.yaml b/SOL004/magma/sdn_port_mapping.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5be50ac018a3d4bfe186557d6915d536a3ed2aa2
--- /dev/null
+++ b/SOL004/magma/sdn_port_mapping.yaml
@@ -0,0 +1,6 @@
+- compute_node:    "nfvisrv01"
+  ports: [{pci: "0000:18:00.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:00.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:02.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:03.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:04.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:05.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:06.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:07.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:08.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.0", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.1", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.2", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.3", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.4", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.5", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.6", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:18:09.7", switch_port: "1", switch_dpid: "0000000000009001", mac: "3c:fd:fe:e3:55:35"}]
+- compute_node:    "nfvisrv11"
+  ports: [{pci: "0000:1a:00.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:00.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.0", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.1", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.2", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.3", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.4", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.5", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.6", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.7", switch_port: "1", switch_dpid: "0000000000009011", mac: "3c:fd:fe:e3:55:35"}]
+- compute_node:    "nfvisrv12"
+  ports: [{pci: "0000:1a:00.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:00.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:02.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:03.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:04.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:05.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:06.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:07.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:08.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.0", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.1", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.2", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.3", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.4", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.5", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.6", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"},{pci: "0000:1a:09.7", switch_port: "1", switch_dpid: "0000000000009012", mac: "3c:fd:fe:e3:55:35"}]
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid/README.md b/SOL004/magma/squid_cnf/charms/squid/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..1b226214256240e150d1cb34fdc75fb0b0bf412b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/README.md
@@ -0,0 +1,47 @@
+# squid-k8s Charm
+
+## Overview
+
+This is a Kuberentes Charm to deploy [Squid Cache](http://www.squid-cache.org/).
+
+Sugested Actions for this charm:
+* Set allowed URLs
+  Possible way to run action: `juju run-action squid/0 addurl url=google.com`
+* Stop/Start/Restart the squid service - done
+  Run like this: `juju run-action squid/0 restart`
+* Set ftp, http, https proxies
+
+## Quickstart
+
+If you don't have microk8s and juju installed executing the following commands:
+```
+sudo snap install juju --classic
+sudo snap install microk8s --classic
+juju bootstrap microk8s
+juju add-model squid
+```
+
+Afterwards clone the repository and deploy the charm
+```
+git clone https://github.com/DomFleischmann/charm-squid-k8s.git
+cd charm-squid-k8s
+git submodule update --init
+juju deploy .
+```
+Check if the charm is deployed correctly with `juju status`
+
+To test the `addurl` action open another terminal and type the following command:
+`export https_proxy=http://<squid-ip>:3128`
+
+Where squid-ip is the Squid App Address shown in `juju status`
+
+Now when executing `curl https://www.google.com` squid will block access to the url
+
+Execute the `addurl` action:
+`juju run-action squid/0 addurl url=google.com`
+
+Now when executing `curl https://www.google.com` it will give you the google output.
+
+## Contact
+ - Author: Dominik Fleischmann <dominik.fleischmann@canonical.com>
+ - Bug Tracker: [here](https://github.com/DomFleischmann/charm-squid-k8s)
diff --git a/SOL004/magma/squid_cnf/charms/squid/actions.yaml b/SOL004/magma/squid_cnf/charms/squid/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3e57d8e3987419e2857c90ffdef8a8a9bff4256f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/actions.yaml
@@ -0,0 +1,14 @@
+addurl:
+    description: "Add allowed URL to squid config"
+    params:
+        url:
+            description: "URL that will be allowed"
+            type: string
+            default: ""
+deleteurl:
+    description: "Delete allowed URL squid config"
+    params:
+        url:
+            description: "URL that will stop to be allowed"
+            type: string
+            default: ""
diff --git a/SOL004/magma/squid_cnf/charms/squid/config.yaml b/SOL004/magma/squid_cnf/charms/squid/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..450525eeed2cb05b0cf347357d67b3693f8c192f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/config.yaml
@@ -0,0 +1,5 @@
+options:
+    port:
+        type: int
+        description: "Port"
+        default: 3128
diff --git a/SOL004/magma/squid_cnf/charms/squid/dispatch b/SOL004/magma/squid_cnf/charms/squid/dispatch
new file mode 100755
index 0000000000000000000000000000000000000000..fe31c0567bdce62a6542a6470997cb6a874e4bd8
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/dispatch
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+JUJU_DISPATCH_PATH="${JUJU_DISPATCH_PATH:-$0}" PYTHONPATH=lib:venv ./src/charm.py
diff --git a/SOL004/magma/squid_cnf/charms/squid/hooks/install b/SOL004/magma/squid_cnf/charms/squid/hooks/install
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/hooks/install
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid/hooks/start b/SOL004/magma/squid_cnf/charms/squid/hooks/start
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/hooks/start
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid/hooks/upgrade-charm b/SOL004/magma/squid_cnf/charms/squid/hooks/upgrade-charm
new file mode 120000
index 0000000000000000000000000000000000000000..8b970447af1decd19c27ca3c609fc97f56a233e3
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/hooks/upgrade-charm
@@ -0,0 +1 @@
+../dispatch
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid/metadata.yaml b/SOL004/magma/squid_cnf/charms/squid/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aabf09bc24512226f22974867fb69bd768fdae4d
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/metadata.yaml
@@ -0,0 +1,24 @@
+name: squid
+summary: Describe your charm here
+maintainers:
+    - Dominik Fleischmann <dominik.fleischmann@canonical.com>
+description: |
+    A nice long description of what the product does and any
+    high level information about how the charm provides the product,
+    on which platform, etc.
+tags:
+    - misc
+series:
+    - kubernetes
+deployment:
+    type: stateful
+    service: loadbalancer
+storage:
+    spool:
+        type: filesystem
+        location: /var/spool/squid
+resources:
+  image:
+    type: oci-image
+    description: OSM docker image for LCM
+    upstream-source: "domfleischmann/squid-python"
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid/requirements.txt b/SOL004/magma/squid_cnf/charms/squid/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4da6f5fe4169cdf33fb85954f2ea3db2290f3fc8
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/requirements.txt
@@ -0,0 +1,3 @@
+ops
+jinja2
+git+https://github.com/juju-solutions/resource-oci-image/@c5778285d332edf3d9a538f9d0c06154b7ec1b0b#egg=oci-image
diff --git a/SOL004/magma/squid_cnf/charms/squid/squid.charm b/SOL004/magma/squid_cnf/charms/squid/squid.charm
new file mode 100644
index 0000000000000000000000000000000000000000..00ca09ed1e2947b3e934e45bf8fd81abefdbbc5a
Binary files /dev/null and b/SOL004/magma/squid_cnf/charms/squid/squid.charm differ
diff --git a/SOL004/magma/squid_cnf/charms/squid/src/charm.py b/SOL004/magma/squid_cnf/charms/squid/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e861c025273141d723b5d82f14d59b5b4f997a94
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/src/charm.py
@@ -0,0 +1,114 @@
+#! /usr/bin/env python3
+
+import logging
+import subprocess
+
+from ops.main import main
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import ActiveStatus, MaintenanceStatus, BlockedStatus
+
+from oci_image import OCIImageResource, OCIImageResourceError
+
+from jinja2 import Template
+
+SQUID_CONF = "/etc/squid/squid.conf"
+
+logger = logging.getLogger(__name__)
+
+
+class SquidK8SCharm(CharmBase):
+    """Class reprisenting this Operator charm."""
+
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        """Initialize charm and configure states and events to observe."""
+        super().__init__(*args)
+        self._stored.set_default(pod_spec=None, allowedurls=set())
+
+        self.framework.observe(self.on.start, self.configure_pod)
+        self.framework.observe(self.on.config_changed, self.configure_pod)
+        self.framework.observe(self.on.addurl_action, self.on_addurl_action)
+        self.framework.observe(self.on.deleteurl_action, self.on_deleteurl_action)
+
+        self.image = OCIImageResource(self, "image")
+
+    def _update_allowed_urls(self, add: str = None, delete: str = None):
+        if add:
+            self._stored.allowedurls.add(add)
+        if delete and delete in self._stored.allowedurls:
+            self._stored.allowedurls.remove(delete)
+
+    def _update_squid_config(self, add: str = None, delete: str = None):
+        self._update_allowed_urls(add=add, delete=delete)
+        squid_config_text = self._get_squid_config_file_text()
+        if squid_config_text:
+            with open(SQUID_CONF, "w") as f:
+                f.write(squid_config_text)
+            subprocess.Popen(
+                "sleep 1 && kill -HUP `cat /var/run/squid.pid`", shell=True
+            )
+
+    def on_addurl_action(self, event):
+        url = event.params["url"]
+        self._update_squid_config(add=url)
+
+    def on_deleteurl_action(self, event):
+        """Handle the deleteurl action."""
+        url = event.params["url"]
+        self._update_squid_config(delete=url)
+
+    def _get_squid_config_file_text(self):
+        squid_config_text = None
+        allowed_urls_text = ""
+        for url in self._stored.allowedurls:
+            allowed_urls_text += f"acl allowedurls dstdomain .{url}\n"
+        allowed_urls_text += "http_access allow allowedurls\n"
+        with open("template/squid.conf") as template:
+            squid_config_text = Template(template.read()).render(
+                allowed_urls=allowed_urls_text
+            )
+        return squid_config_text
+
+    def configure_pod(self, event):
+        if not self.unit.is_leader():
+            self.unit.status = ActiveStatus("ready")
+            return
+        self.unit.status = MaintenanceStatus("Applying pod spec")
+
+        # Fetch image information
+        try:
+            self.unit.status = MaintenanceStatus("Fetching image information")
+            image_info = self.image.fetch()
+        except OCIImageResourceError:
+            self.unit.status = BlockedStatus("Error fetching image information")
+            return
+
+        pod_spec = self._make_pod_spec(image_info)
+
+        if self._stored.pod_spec != pod_spec:
+            self.model.pod.set_spec(pod_spec)
+            self._stored.pod_spec = pod_spec
+        self.unit.status = ActiveStatus("ready")
+
+    def _make_pod_spec(self, image_info):
+        config = self.config
+        ports = [{"name": "squid", "containerPort": config["port"], "protocol": "TCP"}]
+
+        spec = {
+            "version": 3,
+            "containers": [
+                {
+                    "name": self.framework.model.app.name,
+                    "imageDetails": image_info,
+                    "ports": ports,
+                }
+            ],
+        }
+        return spec
+
+
+if __name__ == "__main__":
+    main(SquidK8SCharm)
diff --git a/SOL004/magma/squid_cnf/charms/squid/template/squid.conf b/SOL004/magma/squid_cnf/charms/squid/template/squid.conf
new file mode 100644
index 0000000000000000000000000000000000000000..9dc7e8b664d007c9d6dc452dffdc7fe47358d1b2
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/template/squid.conf
@@ -0,0 +1,26 @@
+acl SSL_ports port 443
+acl Safe_ports port 80		# http
+acl Safe_ports port 21		# ftp
+acl Safe_ports port 443		# https
+acl Safe_ports port 70		# gopher
+acl Safe_ports port 210		# wais
+acl Safe_ports port 1025-65535	# unregistered ports
+acl Safe_ports port 280		# http-mgmt
+acl Safe_ports port 488		# gss-http
+acl Safe_ports port 591		# filemaker
+acl Safe_ports port 777		# multiling http
+acl CONNECT method CONNECT
+http_access deny !Safe_ports
+http_access deny CONNECT !SSL_ports
+http_access allow localhost manager
+http_access deny manager
+http_access allow localhost
+{{ allowed_urls }}
+http_access deny all
+http_port 3128
+coredump_dir /var/spool/squid
+refresh_pattern ^ftp:		1440	20%	10080
+refresh_pattern ^gopher:	1440	0%	1440
+refresh_pattern -i (/cgi-bin/|\?) 0	0%	0
+refresh_pattern (Release|Packages(.gz)*)$      0       20%     2880
+refresh_pattern .		0	20%	4320
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/functional/requirements.txt b/SOL004/magma/squid_cnf/charms/squid/tests/functional/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b7c9112db138bffa4c67040e8744b42d68d95855
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/functional/requirements.txt
@@ -0,0 +1 @@
+git+https://github.com/openstack-charmers/zaza.git#egg=zaza
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/bionic.yaml b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/bionic.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ef41a680a0b67e54534aac274f6aaa096ac13fbe
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/bionic.yaml
@@ -0,0 +1,6 @@
+series: bionic
+
+applications:
+    squid:
+        charm: ../../../../
+        num_units: 1
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/xenial.yaml b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/xenial.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c4e9580146a4369981ee4c5ce567b5b1db4333e4
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/bundles/xenial.yaml
@@ -0,0 +1,7 @@
+series: xenial
+
+applications:
+    squid:
+        charm: ../../../../
+        num_units: 1
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/tests.yaml b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/tests.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aa92ccb5d20cfc6e7e877aed029f51dd64141146
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/functional/tests/tests.yaml
@@ -0,0 +1,17 @@
+tests:
+# - bionic_model:
+#   - zaza.charm_tests.noop.tests.NoopTestBionic
+# - xenial_model:
+#   - zaza.charm_tests.noop.tests.NoopTestXenial
+ - zaza.charm_tests.noop.tests.NoopTest
+configure:
+# - bionic_model:
+#   - zaza.charm_tests.noop.setup.basic_setup_bionic
+# - xenial_model:
+#   - zaza.charm_tests.noop.setup.basic_setup_xenial
+ - zaza.charm_tests.noop.setup.basic_setup
+gate_bundles:
+    - xenial
+    - bionic
+smoke_bundles:
+    - focal
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/unit/operator_fixtures.py b/SOL004/magma/squid_cnf/charms/squid/tests/unit/operator_fixtures.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9462fc97e0f4174113eb1a4496dac28f99e6394
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/unit/operator_fixtures.py
@@ -0,0 +1,113 @@
+#! /usr/bin/env python3
+# -*- coding: utf-8 -*-
+# vim:fenc=utf-8
+# Copyright © 2020 Dominik Fleischmann dominik.fleischmann@canonical.com
+# Distributed under terms of the GPL license.
+"""Operator Charm test fixtures."""
+
+import os
+import tempfile
+import unittest
+
+import setuppath  # noqa:F401
+import mock
+import ops
+import ops.main
+from src.charm import Squid-K8SCharm
+
+
+class OperatorTestCase(unittest.TestCase):
+    """Fixtures for unit testing operator charms."""
+
+    @classmethod
+    def setUpClass(cls):
+        """Setup class fixture."""
+        # Setup a tmpdir
+        cls.tmpdir = tempfile.TemporaryDirectory()
+
+        # Store patchers for test cases that want them
+        cls.patchers = {}
+
+        # Prevent framwork from trying to call subprocesses
+        run_patcher = mock.patch("ops.model.ModelBackend._run")
+        cls.patchers["ops.model.ModelBackend._run"] = run_patcher.start()
+
+        # Stop unit test from calling fchown
+        fchown_patcher = mock.patch("os.fchown")
+        cls.patchers["os.fchown"] = fchown_patcher.start()
+        chown_patcher = mock.patch("os.chown")
+        cls.patchers["os.chown"] = chown_patcher.start()
+
+        # Setup mock JUJU Environment variables
+        os.environ["JUJU_UNIT_NAME"] = "mock/0"
+        os.environ["JUJU_CHARM_DIR"] = "."
+
+    @classmethod
+    def tearDownClass(cls):
+        """Tear down class fixture."""
+        mock.patch.stopall()
+        cls.tmpdir.cleanup()
+
+    def setUp(self):
+        """Setup test fixture."""
+        # Create a charm instance
+        model_backend = ops.model.ModelBackend()
+        ops.main.setup_root_logging(model_backend)
+        charm_dir = ops.main._get_charm_dir()
+        metadata, actions_metadata = ops.main._load_metadata(charm_dir)
+        meta = ops.charm.CharmMeta(metadata, actions_metadata)
+        unit_name = os.environ["JUJU_UNIT_NAME"]
+        model = ops.model.Model(unit_name, meta, model_backend)
+        framework = ops.framework.Framework(":memory:", charm_dir, meta, model)
+        charm = Squid-K8SCharm(framework, None)
+        self.charm = charm
+
+    def tearDown(self):
+        """Clean up test fixture."""
+        # Remove runtime class attributes to avoid error on next setUp
+
+        for relation_name in self.charm.framework.meta.relations:
+            relation_name = relation_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_joined")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_changed")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_departed")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_broken")
+
+        for storage_name in self.charm.framework.meta.storages:
+            storage_name = storage_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, storage_name + "_storage_attached")
+            delattr(ops.charm.CharmEvents, storage_name + "_storage_detaching")
+
+        for action_name in self.charm.framework.meta.actions:
+            action_name = action_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, action_name + "_action")
+
+    def emit(self, event):
+        """Emit the named hook on the charm."""
+        self.charm.framework.reemit()
+
+        if "_relation_" in event:
+            relation_name = event.split("_relation")[0].replace("_", "-")
+            with mock.patch.dict(
+                "os.environ",
+                {
+                    "JUJU_RELATION": relation_name,
+                    "JUJU_RELATION_ID": "1",
+                    "JUJU_REMOTE_APP": "mock",
+                    "JUJU_REMOTE_UNIT": "mock/0",
+                },
+            ):
+                ops.main._emit_charm_event(self.charm, event)
+        else:
+            ops.main._emit_charm_event(self.charm, event)
+
+    def get_notice_count(self, hook):
+        """Return the notice count for a given charm hook."""
+        notice_count = 0
+        handle = "Squid-K8SCharm/on/{}".format(hook)
+
+        for event_path, _, _ in self.charm.framework._storage.notices(None):
+            if event_path.startswith(handle):
+                notice_count += 1
+
+        return notice_count
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/unit/requirements.txt b/SOL004/magma/squid_cnf/charms/squid/tests/unit/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ba6b0ee1ed8feb744c0fcc2ff0477dc80d32dff3
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/unit/requirements.txt
@@ -0,0 +1,3 @@
+mock
+pyyaml
+coverage
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/unit/setuppath.py b/SOL004/magma/squid_cnf/charms/squid/tests/unit/setuppath.py
new file mode 100644
index 0000000000000000000000000000000000000000..736da20c9af4f47e0184168c10de70e23759495a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/unit/setuppath.py
@@ -0,0 +1,2 @@
+import sys
+sys.path.append('lib')
diff --git a/SOL004/magma/squid_cnf/charms/squid/tests/unit/test_charm.py b/SOL004/magma/squid_cnf/charms/squid/tests/unit/test_charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc64b799608c598358d3d010c53f9dfcbc7b7fb5
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tests/unit/test_charm.py
@@ -0,0 +1,19 @@
+import unittest
+
+import setuppath  # noqa:F401
+from operator_fixtures import OperatorTestCase
+
+
+class TestCharm(OperatorTestCase):
+    def test_create_charm(self):
+        """Verify fixtures and create a charm."""
+        self.assertEqual(self.charm.state.installed, False)
+
+    def test_install(self):
+        """Test emitting an install hook."""
+        self.emit("install")
+        self.assertEqual(self.charm.state.installed, True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/magma/squid_cnf/charms/squid/tox.ini b/SOL004/magma/squid_cnf/charms/squid/tox.ini
new file mode 100644
index 0000000000000000000000000000000000000000..a2476324f8eea6fdb222b4f382057849e8d85f44
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/tox.ini
@@ -0,0 +1,46 @@
+[tox]
+skipsdist = True
+envlist = unit, functional
+skip_missing_interpreters = True
+
+[testenv]
+basepython = python3
+setenv =
+  PYTHONPATH = {toxinidir}/lib/:{toxinidir}
+passenv = HOME
+
+[testenv:unit]
+commands = 
+    coverage run -m unittest discover -s {toxinidir}/tests/unit -v
+    coverage report \
+	--omit tests/*,mod/*,.tox/*
+    coverage html \
+	--omit tests/*,mod/*,.tox/*
+deps = -r{toxinidir}/tests/unit/requirements.txt
+
+[testenv:functional]
+changedir = {toxinidir}/tests/functional
+commands = functest-run-suite {posargs}
+deps = -r{toxinidir}/tests/functional/requirements.txt
+
+[testenv:lint]
+commands = flake8
+deps =
+    flake8
+    flake8-docstrings
+    flake8-import-order
+    pep8-naming
+    flake8-colors
+
+[flake8]
+exclude =
+    .git,
+    __pycache__,
+    .tox,
+    mod,
+max-line-length = 120
+max-complexity = 10
+import-order-style = google
+
+[isort]
+force_to_top=setuppath
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/INSTALLER b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/LICENSE.rst b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/LICENSE.rst
new file mode 100644
index 0000000000000000000000000000000000000000..c37cae49ec77ad6ebb25568c1605f1fee5313cfb
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/LICENSE.rst
@@ -0,0 +1,28 @@
+Copyright 2007 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/METADATA b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..55c0f82692c5a56768a741095b7d4fb3872b4df5
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/METADATA
@@ -0,0 +1,106 @@
+Metadata-Version: 2.1
+Name: Jinja2
+Version: 2.11.2
+Summary: A very fast and expressive template engine.
+Home-page: https://palletsprojects.com/p/jinja/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: Pallets
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://jinja.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/jinja
+Project-URL: Issue tracker, https://github.com/pallets/jinja/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Description-Content-Type: text/x-rst
+Requires-Dist: MarkupSafe (>=0.23)
+Provides-Extra: i18n
+Requires-Dist: Babel (>=0.8) ; extra == 'i18n'
+
+Jinja
+=====
+
+Jinja is a fast, expressive, extensible templating engine. Special
+placeholders in the template allow writing code similar to Python
+syntax. Then the template is passed data to render the final document.
+
+It includes:
+
+-   Template inheritance and inclusion.
+-   Define and import macros within templates.
+-   HTML templates can use autoescaping to prevent XSS from untrusted
+    user input.
+-   A sandboxed environment can safely render untrusted templates.
+-   AsyncIO support for generating templates and calling async
+    functions.
+-   I18N support with Babel.
+-   Templates are compiled to optimized Python code just-in-time and
+    cached, or can be compiled ahead-of-time.
+-   Exceptions point to the correct line in templates to make debugging
+    easier.
+-   Extensible filters, tests, functions, and even syntax.
+
+Jinja's philosophy is that while application logic belongs in Python if
+possible, it shouldn't make the template designer's job difficult by
+restricting functionality too much.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    $ pip install -U Jinja2
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+In A Nutshell
+-------------
+
+.. code-block:: jinja
+
+    {% extends "base.html" %}
+    {% block title %}Members{% endblock %}
+    {% block content %}
+      <ul>
+      {% for user in users %}
+        <li><a href="{{ user.url }}">{{ user.username }}</a></li>
+      {% endfor %}
+      </ul>
+    {% endblock %}
+
+
+Links
+-----
+
+-   Website: https://palletsprojects.com/p/jinja/
+-   Documentation: https://jinja.palletsprojects.com/
+-   Releases: https://pypi.org/project/Jinja2/
+-   Code: https://github.com/pallets/jinja
+-   Issue tracker: https://github.com/pallets/jinja/issues
+-   Test status: https://dev.azure.com/pallets/jinja/_build
+-   Official chat: https://discord.gg/t6rrQZH
+
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/RECORD b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..413fef4bfdf0330f017450293400e102cab65113
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/RECORD
@@ -0,0 +1,61 @@
+Jinja2-2.11.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+Jinja2-2.11.2.dist-info/LICENSE.rst,sha256=O0nc7kEF6ze6wQ-vG-JgQI_oXSUrjp3y4JefweCUQ3s,1475
+Jinja2-2.11.2.dist-info/METADATA,sha256=5ZHRZoIRAMHsJPnqhlJ622_dRPsYePYJ-9EH4-Ry7yI,3535
+Jinja2-2.11.2.dist-info/RECORD,,
+Jinja2-2.11.2.dist-info/WHEEL,sha256=kGT74LWyRUZrL4VgLh6_g12IeVl_9u9ZVhadrgXZUEY,110
+Jinja2-2.11.2.dist-info/entry_points.txt,sha256=Qy_DkVo6Xj_zzOtmErrATe8lHZhOqdjpt3e4JJAGyi8,61
+Jinja2-2.11.2.dist-info/top_level.txt,sha256=PkeVWtLb3-CqjWi1fO29OCbj55EhX_chhKrCdrVe_zs,7
+jinja2/__init__.py,sha256=0QCM_jKKDM10yzSdHRVV4mQbCbDqf0GN0GirAqibn9Y,1549
+jinja2/__pycache__/__init__.cpython-38.pyc,,
+jinja2/__pycache__/_compat.cpython-38.pyc,,
+jinja2/__pycache__/_identifier.cpython-38.pyc,,
+jinja2/__pycache__/asyncfilters.cpython-38.pyc,,
+jinja2/__pycache__/asyncsupport.cpython-38.pyc,,
+jinja2/__pycache__/bccache.cpython-38.pyc,,
+jinja2/__pycache__/compiler.cpython-38.pyc,,
+jinja2/__pycache__/constants.cpython-38.pyc,,
+jinja2/__pycache__/debug.cpython-38.pyc,,
+jinja2/__pycache__/defaults.cpython-38.pyc,,
+jinja2/__pycache__/environment.cpython-38.pyc,,
+jinja2/__pycache__/exceptions.cpython-38.pyc,,
+jinja2/__pycache__/ext.cpython-38.pyc,,
+jinja2/__pycache__/filters.cpython-38.pyc,,
+jinja2/__pycache__/idtracking.cpython-38.pyc,,
+jinja2/__pycache__/lexer.cpython-38.pyc,,
+jinja2/__pycache__/loaders.cpython-38.pyc,,
+jinja2/__pycache__/meta.cpython-38.pyc,,
+jinja2/__pycache__/nativetypes.cpython-38.pyc,,
+jinja2/__pycache__/nodes.cpython-38.pyc,,
+jinja2/__pycache__/optimizer.cpython-38.pyc,,
+jinja2/__pycache__/parser.cpython-38.pyc,,
+jinja2/__pycache__/runtime.cpython-38.pyc,,
+jinja2/__pycache__/sandbox.cpython-38.pyc,,
+jinja2/__pycache__/tests.cpython-38.pyc,,
+jinja2/__pycache__/utils.cpython-38.pyc,,
+jinja2/__pycache__/visitor.cpython-38.pyc,,
+jinja2/_compat.py,sha256=B6Se8HjnXVpzz9-vfHejn-DV2NjaVK-Iewupc5kKlu8,3191
+jinja2/_identifier.py,sha256=EdgGJKi7O1yvr4yFlvqPNEqV6M1qHyQr8Gt8GmVTKVM,1775
+jinja2/asyncfilters.py,sha256=XJtYXTxFvcJ5xwk6SaDL4S0oNnT0wPYvXBCSzc482fI,4250
+jinja2/asyncsupport.py,sha256=ZBFsDLuq3Gtji3Ia87lcyuDbqaHZJRdtShZcqwpFnSQ,7209
+jinja2/bccache.py,sha256=3Pmp4jo65M9FQuIxdxoDBbEDFwe4acDMQf77nEJfrHA,12139
+jinja2/compiler.py,sha256=Ta9W1Lit542wItAHXlDcg0sEOsFDMirCdlFPHAurg4o,66284
+jinja2/constants.py,sha256=RR1sTzNzUmKco6aZicw4JpQpJGCuPuqm1h1YmCNUEFY,1458
+jinja2/debug.py,sha256=neR7GIGGjZH3_ILJGVUYy3eLQCCaWJMXOb7o0kGInWc,8529
+jinja2/defaults.py,sha256=85B6YUUCyWPSdrSeVhcqFVuu_bHUAQXeey--FIwSeVQ,1126
+jinja2/environment.py,sha256=XDSLKc4SqNLMOwTSq3TbWEyA5WyXfuLuVD0wAVjEFwM,50629
+jinja2/exceptions.py,sha256=VjNLawcmf2ODffqVMCQK1cRmvFaUfQWF4u8ouP3QPcE,5425
+jinja2/ext.py,sha256=AtwL5O5enT_L3HR9-oBvhGyUTdGoyaqG_ICtnR_EVd4,26441
+jinja2/filters.py,sha256=_RpPgAlgIj7ExvyDzcHAC3B36cocfWK-1TEketbNeM0,41415
+jinja2/idtracking.py,sha256=J3O4VHsrbf3wzwiBc7Cro26kHb6_5kbULeIOzocchIU,9211
+jinja2/lexer.py,sha256=nUFLRKhhKmmEWkLI65nQePgcQs7qsRdjVYZETMt_v0g,30331
+jinja2/loaders.py,sha256=C-fST_dmFjgWkp0ZuCkrgICAoOsoSIF28wfAFink0oU,17666
+jinja2/meta.py,sha256=QjyYhfNRD3QCXjBJpiPl9KgkEkGXJbAkCUq4-Ur10EQ,4131
+jinja2/nativetypes.py,sha256=Ul__gtVw4xH-0qvUvnCNHedQeNDwmEuyLJztzzSPeRg,2753
+jinja2/nodes.py,sha256=Mk1oJPVgIjnQw9WOqILvcu3rLepcFZ0ahxQm2mbwDwc,31095
+jinja2/optimizer.py,sha256=gQLlMYzvQhluhzmAIFA1tXS0cwgWYOjprN-gTRcHVsc,1457
+jinja2/parser.py,sha256=fcfdqePNTNyvosIvczbytVA332qpsURvYnCGcjDHSkA,35660
+jinja2/runtime.py,sha256=0y-BRyIEZ9ltByL2Id6GpHe1oDRQAwNeQvI0SKobNMw,30618
+jinja2/sandbox.py,sha256=knayyUvXsZ-F0mk15mO2-ehK9gsw04UhB8td-iUOtLc,17127
+jinja2/tests.py,sha256=iO_Y-9Vo60zrVe1lMpSl5sKHqAxe2leZHC08OoZ8K24,4799
+jinja2/utils.py,sha256=OoVMlQe9S2-lWT6jJbTu9tDuDvGNyWUhHDcE51i5_Do,22522
+jinja2/visitor.py,sha256=DUHupl0a4PGp7nxRtZFttUzAi1ccxzqc2hzetPYUz8U,3240
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/WHEEL b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ef99c6cf3283b50a273ac4c6d009a0aa85597070
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/WHEEL
@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/entry_points.txt b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/entry_points.txt
new file mode 100644
index 0000000000000000000000000000000000000000..3619483fd4fca7407f3bd462aefcd70d1de69737
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/entry_points.txt
@@ -0,0 +1,3 @@
+[babel.extractors]
+jinja2 = jinja2.ext:babel_extract [i18n]
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/top_level.txt b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..7f7afbf3bf54b346092be6a72070fcbd305ead1e
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/Jinja2-2.11.2.dist-info/top_level.txt
@@ -0,0 +1 @@
+jinja2
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/INSTALLER b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..9d227a0cc43c3268d15722b763bd94ad298645a1
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/LICENSE.txt
@@ -0,0 +1,28 @@
+Copyright 2010 Pallets
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+2.  Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+
+3.  Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/METADATA b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..c50370d6e8457be099ff654efbacd8d89d1e9d45
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/METADATA
@@ -0,0 +1,105 @@
+Metadata-Version: 2.1
+Name: MarkupSafe
+Version: 1.1.1
+Summary: Safely add untrusted strings to HTML/XML markup.
+Home-page: https://palletsprojects.com/p/markupsafe/
+Author: Armin Ronacher
+Author-email: armin.ronacher@active-4.com
+Maintainer: The Pallets Team
+Maintainer-email: contact@palletsprojects.com
+License: BSD-3-Clause
+Project-URL: Documentation, https://markupsafe.palletsprojects.com/
+Project-URL: Code, https://github.com/pallets/markupsafe
+Project-URL: Issue tracker, https://github.com/pallets/markupsafe/issues
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*
+Description-Content-Type: text/x-rst
+
+MarkupSafe
+==========
+
+MarkupSafe implements a text object that escapes characters so it is
+safe to use in HTML and XML. Characters that have special meanings are
+replaced so that they display as the actual characters. This mitigates
+injection attacks, meaning untrusted user input can safely be displayed
+on a page.
+
+
+Installing
+----------
+
+Install and update using `pip`_:
+
+.. code-block:: text
+
+    pip install -U MarkupSafe
+
+.. _pip: https://pip.pypa.io/en/stable/quickstart/
+
+
+Examples
+--------
+
+.. code-block:: pycon
+
+    >>> from markupsafe import Markup, escape
+    >>> # escape replaces special characters and wraps in Markup
+    >>> escape('<script>alert(document.cookie);</script>')
+    Markup(u'&lt;script&gt;alert(document.cookie);&lt;/script&gt;')
+    >>> # wrap in Markup to mark text "safe" and prevent escaping
+    >>> Markup('<strong>Hello</strong>')
+    Markup('<strong>hello</strong>')
+    >>> escape(Markup('<strong>Hello</strong>'))
+    Markup('<strong>hello</strong>')
+    >>> # Markup is a text subclass (str on Python 3, unicode on Python 2)
+    >>> # methods and operators escape their arguments
+    >>> template = Markup("Hello <em>%s</em>")
+    >>> template % '"World"'
+    Markup('Hello <em>&#34;World&#34;</em>')
+
+
+Donate
+------
+
+The Pallets organization develops and supports MarkupSafe and other
+libraries that use it. In order to grow the community of contributors
+and users, and allow the maintainers to devote more time to the
+projects, `please donate today`_.
+
+.. _please donate today: https://palletsprojects.com/donate
+
+
+Links
+-----
+
+*   Website: https://palletsprojects.com/p/markupsafe/
+*   Documentation: https://markupsafe.palletsprojects.com/
+*   License: `BSD-3-Clause <https://github.com/pallets/markupsafe/blob/master/LICENSE.rst>`_
+*   Releases: https://pypi.org/project/MarkupSafe/
+*   Code: https://github.com/pallets/markupsafe
+*   Issue tracker: https://github.com/pallets/markupsafe/issues
+*   Test status:
+
+    *   Linux, Mac: https://travis-ci.org/pallets/markupsafe
+    *   Windows: https://ci.appveyor.com/project/pallets/markupsafe
+
+*   Test coverage: https://codecov.io/gh/pallets/markupsafe
+*   Official chat: https://discord.gg/t6rrQZH
+
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/RECORD b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..95c3339900402816081ecce4451852f261c9f088
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/RECORD
@@ -0,0 +1,16 @@
+MarkupSafe-1.1.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+MarkupSafe-1.1.1.dist-info/LICENSE.txt,sha256=SJqOEQhQntmKN7uYPhHg9-HTHwvY-Zp5yESOf_N9B-o,1475
+MarkupSafe-1.1.1.dist-info/METADATA,sha256=IFCP4hCNGjXJgMoSvdjPiKDLAMUTTWoxKXQsQvmyMNU,3653
+MarkupSafe-1.1.1.dist-info/RECORD,,
+MarkupSafe-1.1.1.dist-info/WHEEL,sha256=VEyGcIFAmk_1KbI6gaZGw_mMiT-pdGweASQLX-DzYaY,108
+MarkupSafe-1.1.1.dist-info/top_level.txt,sha256=qy0Plje5IJuvsCBjejJyhDCjEAdcDLK_2agVcex8Z6U,11
+markupsafe/__init__.py,sha256=oTblO5f9KFM-pvnq9bB0HgElnqkJyqHnFN1Nx2NIvnY,10126
+markupsafe/__pycache__/__init__.cpython-38.pyc,,
+markupsafe/__pycache__/_compat.cpython-38.pyc,,
+markupsafe/__pycache__/_constants.cpython-38.pyc,,
+markupsafe/__pycache__/_native.cpython-38.pyc,,
+markupsafe/_compat.py,sha256=uEW1ybxEjfxIiuTbRRaJpHsPFf4yQUMMKaPgYEC5XbU,558
+markupsafe/_constants.py,sha256=zo2ajfScG-l1Sb_52EP3MlDCqO7Y1BVHUXXKRsVDRNk,4690
+markupsafe/_native.py,sha256=d-8S_zzYt2y512xYcuSxq0NeG2DUUvG80wVdTn-4KI8,1873
+markupsafe/_speedups.c,sha256=k0fzEIK3CP6MmMqeY0ob43TP90mVN0DTyn7BAl3RqSg,9884
+markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so,sha256=SbJwN321Xn7OPYGv5a6Ghzga75uT8RHQUGkoQUASF-o,48016
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/WHEEL b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..ae40efdd2fb4358a9bd6a35167512e7e822f7f4b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.31.1)
+Root-Is-Purelib: false
+Tag: cp38-cp38-manylinux1_x86_64
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/top_level.txt b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..75bf729258f9daef77370b6df1a57940f90fc23f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/MarkupSafe-1.1.1.dist-info/top_level.txt
@@ -0,0 +1 @@
+markupsafe
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/INSTALLER b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/LICENSE b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..3d82c281ee8ceb45368153139f5935bd8d39c816
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/LICENSE
@@ -0,0 +1,20 @@
+Copyright (c) 2017-2020 Ingy döt Net
+Copyright (c) 2006-2016 Kirill Simonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/METADATA b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..a70dd202d485af74ab22294dfbc7710364d0b127
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/METADATA
@@ -0,0 +1,41 @@
+Metadata-Version: 2.1
+Name: PyYAML
+Version: 5.3.1
+Summary: YAML parser and emitter for Python
+Home-page: https://github.com/yaml/pyyaml
+Author: Kirill Simonov
+Author-email: xi@resolvent.net
+License: MIT
+Download-URL: https://pypi.org/project/PyYAML/
+Platform: Any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+
+YAML is a data serialization format designed for human readability
+and interaction with scripting languages.  PyYAML is a YAML parser
+and emitter for Python.
+
+PyYAML features a complete YAML 1.1 parser, Unicode support, pickle
+support, capable extension API, and sensible error messages.  PyYAML
+supports standard YAML tags and provides Python-specific tags that
+allow to represent an arbitrary Python object.
+
+PyYAML is applicable for a broad range of tasks from complex
+configuration files to object serialization and persistence.
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/RECORD b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..cae61d9785c50e2d66319fde9ccc891f7f960354
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/RECORD
@@ -0,0 +1,40 @@
+PyYAML-5.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+PyYAML-5.3.1.dist-info/LICENSE,sha256=xAESRJ8lS5dTBFklJIMT6ScO-jbSJrItgtTMbEPFfyk,1101
+PyYAML-5.3.1.dist-info/METADATA,sha256=xTsZFjd8T4M-5rC2M3BHgx_KTTpEPy5vFDIXrbzRXPQ,1758
+PyYAML-5.3.1.dist-info/RECORD,,
+PyYAML-5.3.1.dist-info/WHEEL,sha256=TpFVeXF_cAlV118WSIPWtjqW7nPvzoOw-49FmS3fDKQ,103
+PyYAML-5.3.1.dist-info/top_level.txt,sha256=rpj0IVMTisAjh_1vG3Ccf9v5jpCQwAz6cD1IVU5ZdhQ,11
+yaml/__init__.py,sha256=XFUNbKTg4afAd0BETjGQ1mKQ97_g5jbE1C0WoKc74dc,13170
+yaml/__pycache__/__init__.cpython-38.pyc,,
+yaml/__pycache__/composer.cpython-38.pyc,,
+yaml/__pycache__/constructor.cpython-38.pyc,,
+yaml/__pycache__/cyaml.cpython-38.pyc,,
+yaml/__pycache__/dumper.cpython-38.pyc,,
+yaml/__pycache__/emitter.cpython-38.pyc,,
+yaml/__pycache__/error.cpython-38.pyc,,
+yaml/__pycache__/events.cpython-38.pyc,,
+yaml/__pycache__/loader.cpython-38.pyc,,
+yaml/__pycache__/nodes.cpython-38.pyc,,
+yaml/__pycache__/parser.cpython-38.pyc,,
+yaml/__pycache__/reader.cpython-38.pyc,,
+yaml/__pycache__/representer.cpython-38.pyc,,
+yaml/__pycache__/resolver.cpython-38.pyc,,
+yaml/__pycache__/scanner.cpython-38.pyc,,
+yaml/__pycache__/serializer.cpython-38.pyc,,
+yaml/__pycache__/tokens.cpython-38.pyc,,
+yaml/composer.py,sha256=_Ko30Wr6eDWUeUpauUGT3Lcg9QPBnOPVlTnIMRGJ9FM,4883
+yaml/constructor.py,sha256=O3Uaf0_J_5GQBoeI9ZNhpJAhtdagr_X2HzDgGbZOMnw,28627
+yaml/cyaml.py,sha256=LiMkvchNonfoy1F6ec9L2BiUz3r0bwF4hympASJX1Ic,3846
+yaml/dumper.py,sha256=PLctZlYwZLp7XmeUdwRuv4nYOZ2UBnDIUy8-lKfLF-o,2837
+yaml/emitter.py,sha256=jghtaU7eFwg31bG0B7RZea_29Adi9CKmXq_QjgQpCkQ,43006
+yaml/error.py,sha256=Ah9z-toHJUbE9j-M8YpxgSRM5CgLCcwVzJgLLRF2Fxo,2533
+yaml/events.py,sha256=50_TksgQiE4up-lKo_V-nBy-tAIxkIPQxY5qDhKCeHw,2445
+yaml/loader.py,sha256=UVa-zIqmkFSCIYq_PgSGm4NSJttHY2Rf_zQ4_b1fHN0,2061
+yaml/nodes.py,sha256=gPKNj8pKCdh2d4gr3gIYINnPOaOxGhJAUiYhGRnPE84,1440
+yaml/parser.py,sha256=ilWp5vvgoHFGzvOZDItFoGjD6D42nhlZrZyjAwa0oJo,25495
+yaml/reader.py,sha256=0dmzirOiDG4Xo41RnuQS7K9rkY3xjHiVasfDMNTqCNw,6794
+yaml/representer.py,sha256=82UM3ZxUQKqsKAF4ltWOxCS6jGPIFtXpGs7mvqyv4Xs,14184
+yaml/resolver.py,sha256=DJCjpQr8YQCEYYjKEYqTl0GrsZil2H4aFOI9b0Oe-U4,8970
+yaml/scanner.py,sha256=KeQIKGNlSyPE8QDwionHxy9CgbqE5teJEz05FR9-nAg,51277
+yaml/serializer.py,sha256=ChuFgmhU01hj4xgI8GaKv6vfM2Bujwa9i7d2FAHj7cA,4165
+yaml/tokens.py,sha256=lTQIzSVw8Mg9wv459-TjiOQe6wVziqaRlqX2_89rp54,2573
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/WHEEL b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..d193dea988d97c2f7f7bf3c4fc196496d361cd4d
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: false
+Tag: cp38-cp38-linux_x86_64
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/top_level.txt b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..e6475e911f628412049bc4090d86f23ac403adde
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/PyYAML-5.3.1.dist-info/top_level.txt
@@ -0,0 +1,2 @@
+_yaml
+yaml
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/__init__.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..1229ba4275a0549e01dd6e7b10e1ccf17f17389f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/__init__.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+"""Jinja is a template engine written in pure Python. It provides a
+non-XML syntax that supports inline expressions and an optional
+sandboxed environment.
+"""
+from markupsafe import escape
+from markupsafe import Markup
+
+from .bccache import BytecodeCache
+from .bccache import FileSystemBytecodeCache
+from .bccache import MemcachedBytecodeCache
+from .environment import Environment
+from .environment import Template
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateError
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .filters import contextfilter
+from .filters import environmentfilter
+from .filters import evalcontextfilter
+from .loaders import BaseLoader
+from .loaders import ChoiceLoader
+from .loaders import DictLoader
+from .loaders import FileSystemLoader
+from .loaders import FunctionLoader
+from .loaders import ModuleLoader
+from .loaders import PackageLoader
+from .loaders import PrefixLoader
+from .runtime import ChainableUndefined
+from .runtime import DebugUndefined
+from .runtime import make_logging_undefined
+from .runtime import StrictUndefined
+from .runtime import Undefined
+from .utils import clear_caches
+from .utils import contextfunction
+from .utils import environmentfunction
+from .utils import evalcontextfunction
+from .utils import is_undefined
+from .utils import select_autoescape
+
+__version__ = "2.11.2"
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_compat.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..1f044954a02933bcec2277fcdd575821bc18a99a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_compat.py
@@ -0,0 +1,132 @@
+# -*- coding: utf-8 -*-
+# flake8: noqa
+import marshal
+import sys
+
+PY2 = sys.version_info[0] == 2
+PYPY = hasattr(sys, "pypy_translation_info")
+_identity = lambda x: x
+
+if not PY2:
+    unichr = chr
+    range_type = range
+    text_type = str
+    string_types = (str,)
+    integer_types = (int,)
+
+    iterkeys = lambda d: iter(d.keys())
+    itervalues = lambda d: iter(d.values())
+    iteritems = lambda d: iter(d.items())
+
+    import pickle
+    from io import BytesIO, StringIO
+
+    NativeStringIO = StringIO
+
+    def reraise(tp, value, tb=None):
+        if value.__traceback__ is not tb:
+            raise value.with_traceback(tb)
+        raise value
+
+    ifilter = filter
+    imap = map
+    izip = zip
+    intern = sys.intern
+
+    implements_iterator = _identity
+    implements_to_string = _identity
+    encode_filename = _identity
+
+    marshal_dump = marshal.dump
+    marshal_load = marshal.load
+
+else:
+    unichr = unichr
+    text_type = unicode
+    range_type = xrange
+    string_types = (str, unicode)
+    integer_types = (int, long)
+
+    iterkeys = lambda d: d.iterkeys()
+    itervalues = lambda d: d.itervalues()
+    iteritems = lambda d: d.iteritems()
+
+    import cPickle as pickle
+    from cStringIO import StringIO as BytesIO, StringIO
+
+    NativeStringIO = BytesIO
+
+    exec("def reraise(tp, value, tb=None):\n raise tp, value, tb")
+
+    from itertools import imap, izip, ifilter
+
+    intern = intern
+
+    def implements_iterator(cls):
+        cls.next = cls.__next__
+        del cls.__next__
+        return cls
+
+    def implements_to_string(cls):
+        cls.__unicode__ = cls.__str__
+        cls.__str__ = lambda x: x.__unicode__().encode("utf-8")
+        return cls
+
+    def encode_filename(filename):
+        if isinstance(filename, unicode):
+            return filename.encode("utf-8")
+        return filename
+
+    def marshal_dump(code, f):
+        if isinstance(f, file):
+            marshal.dump(code, f)
+        else:
+            f.write(marshal.dumps(code))
+
+    def marshal_load(f):
+        if isinstance(f, file):
+            return marshal.load(f)
+        return marshal.loads(f.read())
+
+
+def with_metaclass(meta, *bases):
+    """Create a base class with a metaclass."""
+    # This requires a bit of explanation: the basic idea is to make a
+    # dummy metaclass for one level of class instantiation that replaces
+    # itself with the actual metaclass.
+    class metaclass(type):
+        def __new__(cls, name, this_bases, d):
+            return meta(name, bases, d)
+
+    return type.__new__(metaclass, "temporary_class", (), {})
+
+
+try:
+    from urllib.parse import quote_from_bytes as url_quote
+except ImportError:
+    from urllib import quote as url_quote
+
+
+try:
+    from collections import abc
+except ImportError:
+    import collections as abc
+
+
+try:
+    from os import fspath
+except ImportError:
+    try:
+        from pathlib import PurePath
+    except ImportError:
+        PurePath = None
+
+    def fspath(path):
+        if hasattr(path, "__fspath__"):
+            return path.__fspath__()
+
+        # Python 3.5 doesn't have __fspath__ yet, use str.
+        if PurePath is not None and isinstance(path, PurePath):
+            return str(path)
+
+        return path
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_identifier.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_identifier.py
new file mode 100644
index 0000000000000000000000000000000000000000..224d5449d138e75f4f3c25d70cb8f1ea54ccd047
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/_identifier.py
@@ -0,0 +1,6 @@
+import re
+
+# generated by scripts/generate_identifier_pattern.py
+pattern = re.compile(
+    r"[\w·̀-ͯ·҃-֑҇-ׇֽֿׁׂׅׄؐ-ًؚ-ٰٟۖ-ۜ۟-۪ۤۧۨ-ܑۭܰ-݊ަ-ް߫-߳ࠖ-࠙ࠛ-ࠣࠥ-ࠧࠩ-࡙࠭-࡛ࣔ-ࣣ࣡-ःऺ-़ा-ॏ॑-ॗॢॣঁ-ঃ়া-ৄেৈো-্ৗৢৣਁ-ਃ਼ਾ-ੂੇੈੋ-੍ੑੰੱੵઁ-ઃ઼ા-ૅે-ૉો-્ૢૣଁ-ଃ଼ା-ୄେୈୋ-୍ୖୗୢୣஂா-ூெ-ைொ-்ௗఀ-ఃా-ౄె-ైొ-్ౕౖౢౣಁ-ಃ಼ಾ-ೄೆ-ೈೊ-್ೕೖೢೣഁ-ഃാ-ൄെ-ൈൊ-്ൗൢൣංඃ්ා-ුූෘ-ෟෲෳัิ-ฺ็-๎ັິ-ູົຼ່-ໍ༹༘༙༵༷༾༿ཱ-྄྆྇ྍ-ྗྙ-ྼ࿆ါ-ှၖ-ၙၞ-ၠၢ-ၤၧ-ၭၱ-ၴႂ-ႍႏႚ-ႝ፝-፟ᜒ-᜔ᜲ-᜴ᝒᝓᝲᝳ឴-៓៝᠋-᠍ᢅᢆᢩᤠ-ᤫᤰ-᤻ᨗ-ᨛᩕ-ᩞ᩠-᩿᩼᪰-᪽ᬀ-ᬄ᬴-᭄᭫-᭳ᮀ-ᮂᮡ-ᮭ᯦-᯳ᰤ-᰷᳐-᳔᳒-᳨᳭ᳲ-᳴᳸᳹᷀-᷵᷻-᷿‿⁀⁔⃐-⃥⃜⃡-⃰℘℮⳯-⵿⳱ⷠ-〪ⷿ-゙゚〯꙯ꙴ-꙽ꚞꚟ꛰꛱ꠂ꠆ꠋꠣ-ꠧꢀꢁꢴ-ꣅ꣠-꣱ꤦ-꤭ꥇ-꥓ꦀ-ꦃ꦳-꧀ꧥꨩ-ꨶꩃꩌꩍꩻ-ꩽꪰꪲ-ꪴꪷꪸꪾ꪿꫁ꫫ-ꫯꫵ꫶ꯣ-ꯪ꯬꯭ﬞ︀-️︠-︯︳︴﹍-﹏＿𐇽𐋠𐍶-𐍺𐨁-𐨃𐨅𐨆𐨌-𐨏𐨸-𐨿𐨺𐫦𐫥𑀀-𑀂𑀸-𑁆𑁿-𑂂𑂰-𑂺𑄀-𑄂𑄧-𑅳𑄴𑆀-𑆂𑆳-𑇊𑇀-𑇌𑈬-𑈷𑈾𑋟-𑋪𑌀-𑌃𑌼𑌾-𑍄𑍇𑍈𑍋-𑍍𑍗𑍢𑍣𑍦-𑍬𑍰-𑍴𑐵-𑑆𑒰-𑓃𑖯-𑖵𑖸-𑗀𑗜𑗝𑘰-𑙀𑚫-𑚷𑜝-𑜫𑰯-𑰶𑰸-𑰿𑲒-𑲧𑲩-𑲶𖫰-𖫴𖬰-𖬶𖽑-𖽾𖾏-𖾒𛲝𛲞𝅥-𝅩𝅭-𝅲𝅻-𝆂𝆅-𝆋𝆪-𝆭𝉂-𝉄𝨀-𝨶𝨻-𝩬𝩵𝪄𝪛-𝪟𝪡-𝪯𞀀-𞀆𞀈-𞀘𞀛-𞀡𞀣𞀤𞀦-𞣐𞀪-𞣖𞥄-𞥊󠄀-󠇯]+"  # noqa: B950
+)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncfilters.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncfilters.py
new file mode 100644
index 0000000000000000000000000000000000000000..3d98dbcc00de104a584b0707df8f0d4e8bbe1376
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncfilters.py
@@ -0,0 +1,158 @@
+from functools import wraps
+
+from . import filters
+from .asyncsupport import auto_aiter
+from .asyncsupport import auto_await
+
+
+async def auto_to_seq(value):
+    seq = []
+    if hasattr(value, "__aiter__"):
+        async for item in value:
+            seq.append(item)
+    else:
+        for item in value:
+            seq.append(item)
+    return seq
+
+
+async def async_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = filters.prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        async for item in auto_aiter(seq):
+            if func(item):
+                yield item
+
+
+def dualfilter(normal_filter, async_filter):
+    wrap_evalctx = False
+    if getattr(normal_filter, "environmentfilter", False) is True:
+
+        def is_async(args):
+            return args[0].is_async
+
+        wrap_evalctx = False
+    else:
+        has_evalctxfilter = getattr(normal_filter, "evalcontextfilter", False) is True
+        has_ctxfilter = getattr(normal_filter, "contextfilter", False) is True
+        wrap_evalctx = not has_evalctxfilter and not has_ctxfilter
+
+        def is_async(args):
+            return args[0].environment.is_async
+
+    @wraps(normal_filter)
+    def wrapper(*args, **kwargs):
+        b = is_async(args)
+        if wrap_evalctx:
+            args = args[1:]
+        if b:
+            return async_filter(*args, **kwargs)
+        return normal_filter(*args, **kwargs)
+
+    if wrap_evalctx:
+        wrapper.evalcontextfilter = True
+
+    wrapper.asyncfiltervariant = True
+
+    return wrapper
+
+
+def asyncfiltervariant(original):
+    def decorator(f):
+        return dualfilter(original, f)
+
+    return decorator
+
+
+@asyncfiltervariant(filters.do_first)
+async def do_first(environment, seq):
+    try:
+        return await auto_aiter(seq).__anext__()
+    except StopAsyncIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@asyncfiltervariant(filters.do_groupby)
+async def do_groupby(environment, value, attribute):
+    expr = filters.make_attrgetter(environment, attribute)
+    return [
+        filters._GroupTuple(key, await auto_to_seq(values))
+        for key, values in filters.groupby(
+            sorted(await auto_to_seq(value), key=expr), expr
+        )
+    ]
+
+
+@asyncfiltervariant(filters.do_join)
+async def do_join(eval_ctx, value, d=u"", attribute=None):
+    return filters.do_join(eval_ctx, await auto_to_seq(value), d, attribute)
+
+
+@asyncfiltervariant(filters.do_list)
+async def do_list(value):
+    return await auto_to_seq(value)
+
+
+@asyncfiltervariant(filters.do_reject)
+async def do_reject(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@asyncfiltervariant(filters.do_rejectattr)
+async def do_rejectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@asyncfiltervariant(filters.do_select)
+async def do_select(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@asyncfiltervariant(filters.do_selectattr)
+async def do_selectattr(*args, **kwargs):
+    return async_select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@asyncfiltervariant(filters.do_map)
+async def do_map(*args, **kwargs):
+    seq, func = filters.prepare_map(args, kwargs)
+    if seq:
+        async for item in auto_aiter(seq):
+            yield await auto_await(func(item))
+
+
+@asyncfiltervariant(filters.do_sum)
+async def do_sum(environment, iterable, attribute=None, start=0):
+    rv = start
+    if attribute is not None:
+        func = filters.make_attrgetter(environment, attribute)
+    else:
+
+        def func(x):
+            return x
+
+    async for item in auto_aiter(iterable):
+        rv += func(item)
+    return rv
+
+
+@asyncfiltervariant(filters.do_slice)
+async def do_slice(value, slices, fill_with=None):
+    return filters.do_slice(await auto_to_seq(value), slices, fill_with)
+
+
+ASYNC_FILTERS = {
+    "first": do_first,
+    "groupby": do_groupby,
+    "join": do_join,
+    "list": do_list,
+    # we intentionally do not support do_last because that would be
+    # ridiculous
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "map": do_map,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "sum": do_sum,
+    "slice": do_slice,
+}
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncsupport.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncsupport.py
new file mode 100644
index 0000000000000000000000000000000000000000..78ba3739d8dee1e644f96e32f833279d941c3f65
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/asyncsupport.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""The code for async support. Importing this patches Jinja on supported
+Python versions.
+"""
+import asyncio
+import inspect
+from functools import update_wrapper
+
+from markupsafe import Markup
+
+from .environment import TemplateModule
+from .runtime import LoopContext
+from .utils import concat
+from .utils import internalcode
+from .utils import missing
+
+
+async def concat_async(async_gen):
+    rv = []
+
+    async def collect():
+        async for event in async_gen:
+            rv.append(event)
+
+    await collect()
+    return concat(rv)
+
+
+async def generate_async(self, *args, **kwargs):
+    vars = dict(*args, **kwargs)
+    try:
+        async for event in self.root_render_func(self.new_context(vars)):
+            yield event
+    except Exception:
+        yield self.environment.handle_exception()
+
+
+def wrap_generate_func(original_generate):
+    def _convert_generator(self, loop, args, kwargs):
+        async_gen = self.generate_async(*args, **kwargs)
+        try:
+            while 1:
+                yield loop.run_until_complete(async_gen.__anext__())
+        except StopAsyncIteration:
+            pass
+
+    def generate(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_generate(self, *args, **kwargs)
+        return _convert_generator(self, asyncio.get_event_loop(), args, kwargs)
+
+    return update_wrapper(generate, original_generate)
+
+
+async def render_async(self, *args, **kwargs):
+    if not self.environment.is_async:
+        raise RuntimeError("The environment was not created with async mode enabled.")
+
+    vars = dict(*args, **kwargs)
+    ctx = self.new_context(vars)
+
+    try:
+        return await concat_async(self.root_render_func(ctx))
+    except Exception:
+        return self.environment.handle_exception()
+
+
+def wrap_render_func(original_render):
+    def render(self, *args, **kwargs):
+        if not self.environment.is_async:
+            return original_render(self, *args, **kwargs)
+        loop = asyncio.get_event_loop()
+        return loop.run_until_complete(self.render_async(*args, **kwargs))
+
+    return update_wrapper(render, original_render)
+
+
+def wrap_block_reference_call(original_call):
+    @internalcode
+    async def async_call(self):
+        rv = await concat_async(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def __call__(self):
+        if not self._context.environment.is_async:
+            return original_call(self)
+        return async_call(self)
+
+    return update_wrapper(__call__, original_call)
+
+
+def wrap_macro_invoke(original_invoke):
+    @internalcode
+    async def async_invoke(self, arguments, autoescape):
+        rv = await self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    @internalcode
+    def _invoke(self, arguments, autoescape):
+        if not self._environment.is_async:
+            return original_invoke(self, arguments, autoescape)
+        return async_invoke(self, arguments, autoescape)
+
+    return update_wrapper(_invoke, original_invoke)
+
+
+@internalcode
+async def get_default_module_async(self):
+    if self._module is not None:
+        return self._module
+    self._module = rv = await self.make_module_async()
+    return rv
+
+
+def wrap_default_module(original_default_module):
+    @internalcode
+    def _get_default_module(self):
+        if self.environment.is_async:
+            raise RuntimeError("Template module attribute is unavailable in async mode")
+        return original_default_module(self)
+
+    return _get_default_module
+
+
+async def make_module_async(self, vars=None, shared=False, locals=None):
+    context = self.new_context(vars, shared, locals)
+    body_stream = []
+    async for item in self.root_render_func(context):
+        body_stream.append(item)
+    return TemplateModule(self, context, body_stream)
+
+
+def patch_template():
+    from . import Template
+
+    Template.generate = wrap_generate_func(Template.generate)
+    Template.generate_async = update_wrapper(generate_async, Template.generate_async)
+    Template.render_async = update_wrapper(render_async, Template.render_async)
+    Template.render = wrap_render_func(Template.render)
+    Template._get_default_module = wrap_default_module(Template._get_default_module)
+    Template._get_default_module_async = get_default_module_async
+    Template.make_module_async = update_wrapper(
+        make_module_async, Template.make_module_async
+    )
+
+
+def patch_runtime():
+    from .runtime import BlockReference, Macro
+
+    BlockReference.__call__ = wrap_block_reference_call(BlockReference.__call__)
+    Macro._invoke = wrap_macro_invoke(Macro._invoke)
+
+
+def patch_filters():
+    from .filters import FILTERS
+    from .asyncfilters import ASYNC_FILTERS
+
+    FILTERS.update(ASYNC_FILTERS)
+
+
+def patch_all():
+    patch_template()
+    patch_runtime()
+    patch_filters()
+
+
+async def auto_await(value):
+    if inspect.isawaitable(value):
+        return await value
+    return value
+
+
+async def auto_aiter(iterable):
+    if hasattr(iterable, "__aiter__"):
+        async for item in iterable:
+            yield item
+        return
+    for item in iterable:
+        yield item
+
+
+class AsyncLoopContext(LoopContext):
+    _to_iterator = staticmethod(auto_aiter)
+
+    @property
+    async def length(self):
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = [x async for x in self._iterator]
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    @property
+    async def revindex0(self):
+        return await self.length - self.index
+
+    @property
+    async def revindex(self):
+        return await self.length - self.index0
+
+    async def _peek_next(self):
+        if self._after is not missing:
+            return self._after
+
+        try:
+            self._after = await self._iterator.__anext__()
+        except StopAsyncIteration:
+            self._after = missing
+
+        return self._after
+
+    @property
+    async def last(self):
+        return await self._peek_next() is missing
+
+    @property
+    async def nextitem(self):
+        rv = await self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def __aiter__(self):
+        return self
+
+    async def __anext__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = await self._iterator.__anext__()
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+
+async def make_async_loop_context(iterable, undefined, recurse=None, depth0=0):
+    import warnings
+
+    warnings.warn(
+        "This template must be recompiled with at least Jinja 2.11, or"
+        " it will fail in 3.0.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return AsyncLoopContext(iterable, undefined, recurse, depth0)
+
+
+patch_all()
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/bccache.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/bccache.py
new file mode 100644
index 0000000000000000000000000000000000000000..9c0661030f7af4b2b186b1726341c910194b7cbd
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/bccache.py
@@ -0,0 +1,350 @@
+# -*- coding: utf-8 -*-
+"""The optional bytecode cache system. This is useful if you have very
+complex template situations and the compilation of all those templates
+slows down your application too much.
+
+Situations where this is useful are often forking web applications that
+are initialized on the first request.
+"""
+import errno
+import fnmatch
+import os
+import stat
+import sys
+import tempfile
+from hashlib import sha1
+from os import listdir
+from os import path
+
+from ._compat import BytesIO
+from ._compat import marshal_dump
+from ._compat import marshal_load
+from ._compat import pickle
+from ._compat import text_type
+from .utils import open_if_exists
+
+bc_version = 4
+# Magic bytes to identify Jinja bytecode cache files. Contains the
+# Python major and minor version to avoid loading incompatible bytecode
+# if a project upgrades its Python version.
+bc_magic = (
+    b"j2"
+    + pickle.dumps(bc_version, 2)
+    + pickle.dumps((sys.version_info[0] << 24) | sys.version_info[1], 2)
+)
+
+
+class Bucket(object):
+    """Buckets are used to store the bytecode for one template.  It's created
+    and initialized by the bytecode cache and passed to the loading functions.
+
+    The buckets get an internal checksum from the cache assigned and use this
+    to automatically reject outdated cache material.  Individual bytecode
+    cache subclasses don't have to care about cache invalidation.
+    """
+
+    def __init__(self, environment, key, checksum):
+        self.environment = environment
+        self.key = key
+        self.checksum = checksum
+        self.reset()
+
+    def reset(self):
+        """Resets the bucket (unloads the bytecode)."""
+        self.code = None
+
+    def load_bytecode(self, f):
+        """Loads bytecode from a file or file like object."""
+        # make sure the magic header is correct
+        magic = f.read(len(bc_magic))
+        if magic != bc_magic:
+            self.reset()
+            return
+        # the source code of the file changed, we need to reload
+        checksum = pickle.load(f)
+        if self.checksum != checksum:
+            self.reset()
+            return
+        # if marshal_load fails then we need to reload
+        try:
+            self.code = marshal_load(f)
+        except (EOFError, ValueError, TypeError):
+            self.reset()
+            return
+
+    def write_bytecode(self, f):
+        """Dump the bytecode into the file or file like object passed."""
+        if self.code is None:
+            raise TypeError("can't write empty bucket")
+        f.write(bc_magic)
+        pickle.dump(self.checksum, f, 2)
+        marshal_dump(self.code, f)
+
+    def bytecode_from_string(self, string):
+        """Load bytecode from a string."""
+        self.load_bytecode(BytesIO(string))
+
+    def bytecode_to_string(self):
+        """Return the bytecode as string."""
+        out = BytesIO()
+        self.write_bytecode(out)
+        return out.getvalue()
+
+
+class BytecodeCache(object):
+    """To implement your own bytecode cache you have to subclass this class
+    and override :meth:`load_bytecode` and :meth:`dump_bytecode`.  Both of
+    these methods are passed a :class:`~jinja2.bccache.Bucket`.
+
+    A very basic bytecode cache that saves the bytecode on the file system::
+
+        from os import path
+
+        class MyCache(BytecodeCache):
+
+            def __init__(self, directory):
+                self.directory = directory
+
+            def load_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                if path.exists(filename):
+                    with open(filename, 'rb') as f:
+                        bucket.load_bytecode(f)
+
+            def dump_bytecode(self, bucket):
+                filename = path.join(self.directory, bucket.key)
+                with open(filename, 'wb') as f:
+                    bucket.write_bytecode(f)
+
+    A more advanced version of a filesystem based bytecode cache is part of
+    Jinja.
+    """
+
+    def load_bytecode(self, bucket):
+        """Subclasses have to override this method to load bytecode into a
+        bucket.  If they are not able to find code in the cache for the
+        bucket, it must not do anything.
+        """
+        raise NotImplementedError()
+
+    def dump_bytecode(self, bucket):
+        """Subclasses have to override this method to write the bytecode
+        from a bucket back to the cache.  If it unable to do so it must not
+        fail silently but raise an exception.
+        """
+        raise NotImplementedError()
+
+    def clear(self):
+        """Clears the cache.  This method is not used by Jinja but should be
+        implemented to allow applications to clear the bytecode cache used
+        by a particular environment.
+        """
+
+    def get_cache_key(self, name, filename=None):
+        """Returns the unique hash key for this template name."""
+        hash = sha1(name.encode("utf-8"))
+        if filename is not None:
+            filename = "|" + filename
+            if isinstance(filename, text_type):
+                filename = filename.encode("utf-8")
+            hash.update(filename)
+        return hash.hexdigest()
+
+    def get_source_checksum(self, source):
+        """Returns a checksum for the source."""
+        return sha1(source.encode("utf-8")).hexdigest()
+
+    def get_bucket(self, environment, name, filename, source):
+        """Return a cache bucket for the given template.  All arguments are
+        mandatory but filename may be `None`.
+        """
+        key = self.get_cache_key(name, filename)
+        checksum = self.get_source_checksum(source)
+        bucket = Bucket(environment, key, checksum)
+        self.load_bytecode(bucket)
+        return bucket
+
+    def set_bucket(self, bucket):
+        """Put the bucket into the cache."""
+        self.dump_bytecode(bucket)
+
+
+class FileSystemBytecodeCache(BytecodeCache):
+    """A bytecode cache that stores bytecode on the filesystem.  It accepts
+    two arguments: The directory where the cache items are stored and a
+    pattern string that is used to build the filename.
+
+    If no directory is specified a default cache directory is selected.  On
+    Windows the user's temp directory is used, on UNIX systems a directory
+    is created for the user in the system temp directory.
+
+    The pattern can be used to have multiple separate caches operate on the
+    same directory.  The default pattern is ``'__jinja2_%s.cache'``.  ``%s``
+    is replaced with the cache key.
+
+    >>> bcc = FileSystemBytecodeCache('/tmp/jinja_cache', '%s.cache')
+
+    This bytecode cache supports clearing of the cache using the clear method.
+    """
+
+    def __init__(self, directory=None, pattern="__jinja2_%s.cache"):
+        if directory is None:
+            directory = self._get_default_cache_dir()
+        self.directory = directory
+        self.pattern = pattern
+
+    def _get_default_cache_dir(self):
+        def _unsafe_dir():
+            raise RuntimeError(
+                "Cannot determine safe temp directory.  You "
+                "need to explicitly provide one."
+            )
+
+        tmpdir = tempfile.gettempdir()
+
+        # On windows the temporary directory is used specific unless
+        # explicitly forced otherwise.  We can just use that.
+        if os.name == "nt":
+            return tmpdir
+        if not hasattr(os, "getuid"):
+            _unsafe_dir()
+
+        dirname = "_jinja2-cache-%d" % os.getuid()
+        actual_dir = os.path.join(tmpdir, dirname)
+
+        try:
+            os.mkdir(actual_dir, stat.S_IRWXU)
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+        try:
+            os.chmod(actual_dir, stat.S_IRWXU)
+            actual_dir_stat = os.lstat(actual_dir)
+            if (
+                actual_dir_stat.st_uid != os.getuid()
+                or not stat.S_ISDIR(actual_dir_stat.st_mode)
+                or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+            ):
+                _unsafe_dir()
+        except OSError as e:
+            if e.errno != errno.EEXIST:
+                raise
+
+        actual_dir_stat = os.lstat(actual_dir)
+        if (
+            actual_dir_stat.st_uid != os.getuid()
+            or not stat.S_ISDIR(actual_dir_stat.st_mode)
+            or stat.S_IMODE(actual_dir_stat.st_mode) != stat.S_IRWXU
+        ):
+            _unsafe_dir()
+
+        return actual_dir
+
+    def _get_cache_filename(self, bucket):
+        return path.join(self.directory, self.pattern % bucket.key)
+
+    def load_bytecode(self, bucket):
+        f = open_if_exists(self._get_cache_filename(bucket), "rb")
+        if f is not None:
+            try:
+                bucket.load_bytecode(f)
+            finally:
+                f.close()
+
+    def dump_bytecode(self, bucket):
+        f = open(self._get_cache_filename(bucket), "wb")
+        try:
+            bucket.write_bytecode(f)
+        finally:
+            f.close()
+
+    def clear(self):
+        # imported lazily here because google app-engine doesn't support
+        # write access on the file system and the function does not exist
+        # normally.
+        from os import remove
+
+        files = fnmatch.filter(listdir(self.directory), self.pattern % "*")
+        for filename in files:
+            try:
+                remove(path.join(self.directory, filename))
+            except OSError:
+                pass
+
+
+class MemcachedBytecodeCache(BytecodeCache):
+    """This class implements a bytecode cache that uses a memcache cache for
+    storing the information.  It does not enforce a specific memcache library
+    (tummy's memcache or cmemcache) but will accept any class that provides
+    the minimal interface required.
+
+    Libraries compatible with this class:
+
+    -   `cachelib <https://github.com/pallets/cachelib>`_
+    -   `python-memcached <https://pypi.org/project/python-memcached/>`_
+
+    (Unfortunately the django cache interface is not compatible because it
+    does not support storing binary data, only unicode.  You can however pass
+    the underlying cache client to the bytecode cache which is available
+    as `django.core.cache.cache._client`.)
+
+    The minimal interface for the client passed to the constructor is this:
+
+    .. class:: MinimalClientInterface
+
+        .. method:: set(key, value[, timeout])
+
+            Stores the bytecode in the cache.  `value` is a string and
+            `timeout` the timeout of the key.  If timeout is not provided
+            a default timeout or no timeout should be assumed, if it's
+            provided it's an integer with the number of seconds the cache
+            item should exist.
+
+        .. method:: get(key)
+
+            Returns the value for the cache key.  If the item does not
+            exist in the cache the return value must be `None`.
+
+    The other arguments to the constructor are the prefix for all keys that
+    is added before the actual cache key and the timeout for the bytecode in
+    the cache system.  We recommend a high (or no) timeout.
+
+    This bytecode cache does not support clearing of used items in the cache.
+    The clear method is a no-operation function.
+
+    .. versionadded:: 2.7
+       Added support for ignoring memcache errors through the
+       `ignore_memcache_errors` parameter.
+    """
+
+    def __init__(
+        self,
+        client,
+        prefix="jinja2/bytecode/",
+        timeout=None,
+        ignore_memcache_errors=True,
+    ):
+        self.client = client
+        self.prefix = prefix
+        self.timeout = timeout
+        self.ignore_memcache_errors = ignore_memcache_errors
+
+    def load_bytecode(self, bucket):
+        try:
+            code = self.client.get(self.prefix + bucket.key)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
+            code = None
+        if code is not None:
+            bucket.bytecode_from_string(code)
+
+    def dump_bytecode(self, bucket):
+        args = (self.prefix + bucket.key, bucket.bytecode_to_string())
+        if self.timeout is not None:
+            args += (self.timeout,)
+        try:
+            self.client.set(*args)
+        except Exception:
+            if not self.ignore_memcache_errors:
+                raise
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/compiler.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/compiler.py
new file mode 100644
index 0000000000000000000000000000000000000000..63297b42c30f17b0c0ae08547047d070e7a53d3c
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/compiler.py
@@ -0,0 +1,1843 @@
+# -*- coding: utf-8 -*-
+"""Compiles nodes from the parser into Python code."""
+from collections import namedtuple
+from functools import update_wrapper
+from itertools import chain
+from keyword import iskeyword as is_python_keyword
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import izip
+from ._compat import NativeStringIO
+from ._compat import range_type
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import TemplateAssertionError
+from .idtracking import Symbols
+from .idtracking import VAR_LOAD_ALIAS
+from .idtracking import VAR_LOAD_PARAMETER
+from .idtracking import VAR_LOAD_RESOLVE
+from .idtracking import VAR_LOAD_UNDEFINED
+from .nodes import EvalContext
+from .optimizer import Optimizer
+from .utils import concat
+from .visitor import NodeVisitor
+
+operators = {
+    "eq": "==",
+    "ne": "!=",
+    "gt": ">",
+    "gteq": ">=",
+    "lt": "<",
+    "lteq": "<=",
+    "in": "in",
+    "notin": "not in",
+}
+
+# what method to iterate over items do we want to use for dict iteration
+# in generated code?  on 2.x let's go with iteritems, on 3.x with items
+if hasattr(dict, "iteritems"):
+    dict_item_iter = "iteritems"
+else:
+    dict_item_iter = "items"
+
+code_features = ["division"]
+
+# does this python version support generator stops? (PEP 0479)
+try:
+    exec("from __future__ import generator_stop")
+    code_features.append("generator_stop")
+except SyntaxError:
+    pass
+
+# does this python version support yield from?
+try:
+    exec("def f(): yield from x()")
+except SyntaxError:
+    supports_yield_from = False
+else:
+    supports_yield_from = True
+
+
+def optimizeconst(f):
+    def new_func(self, node, frame, **kwargs):
+        # Only optimize if the frame is not volatile
+        if self.optimized and not frame.eval_ctx.volatile:
+            new_node = self.optimizer.visit(node, frame.eval_ctx)
+            if new_node != node:
+                return self.visit(new_node, frame)
+        return f(self, node, frame, **kwargs)
+
+    return update_wrapper(new_func, f)
+
+
+def generate(
+    node, environment, name, filename, stream=None, defer_init=False, optimized=True
+):
+    """Generate the python source for a node tree."""
+    if not isinstance(node, nodes.Template):
+        raise TypeError("Can't compile non template nodes")
+    generator = environment.code_generator_class(
+        environment, name, filename, stream, defer_init, optimized
+    )
+    generator.visit(node)
+    if stream is None:
+        return generator.stream.getvalue()
+
+
+def has_safe_repr(value):
+    """Does the node have a safe representation?"""
+    if value is None or value is NotImplemented or value is Ellipsis:
+        return True
+    if type(value) in (bool, int, float, complex, range_type, Markup) + string_types:
+        return True
+    if type(value) in (tuple, list, set, frozenset):
+        for item in value:
+            if not has_safe_repr(item):
+                return False
+        return True
+    elif type(value) is dict:
+        for key, value in iteritems(value):
+            if not has_safe_repr(key):
+                return False
+            if not has_safe_repr(value):
+                return False
+        return True
+    return False
+
+
+def find_undeclared(nodes, names):
+    """Check if the names passed are accessed undeclared.  The return value
+    is a set of all the undeclared names from the sequence of names found.
+    """
+    visitor = UndeclaredNameVisitor(names)
+    try:
+        for node in nodes:
+            visitor.visit(node)
+    except VisitorExit:
+        pass
+    return visitor.undeclared
+
+
+class MacroRef(object):
+    def __init__(self, node):
+        self.node = node
+        self.accesses_caller = False
+        self.accesses_kwargs = False
+        self.accesses_varargs = False
+
+
+class Frame(object):
+    """Holds compile time information for us."""
+
+    def __init__(self, eval_ctx, parent=None, level=None):
+        self.eval_ctx = eval_ctx
+        self.symbols = Symbols(parent and parent.symbols or None, level=level)
+
+        # a toplevel frame is the root + soft frames such as if conditions.
+        self.toplevel = False
+
+        # the root frame is basically just the outermost frame, so no if
+        # conditions.  This information is used to optimize inheritance
+        # situations.
+        self.rootlevel = False
+
+        # in some dynamic inheritance situations the compiler needs to add
+        # write tests around output statements.
+        self.require_output_check = parent and parent.require_output_check
+
+        # inside some tags we are using a buffer rather than yield statements.
+        # this for example affects {% filter %} or {% macro %}.  If a frame
+        # is buffered this variable points to the name of the list used as
+        # buffer.
+        self.buffer = None
+
+        # the name of the block we're in, otherwise None.
+        self.block = parent and parent.block or None
+
+        # the parent of this frame
+        self.parent = parent
+
+        if parent is not None:
+            self.buffer = parent.buffer
+
+    def copy(self):
+        """Create a copy of the current one."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.symbols = self.symbols.copy()
+        return rv
+
+    def inner(self, isolated=False):
+        """Return an inner frame."""
+        if isolated:
+            return Frame(self.eval_ctx, level=self.symbols.level + 1)
+        return Frame(self.eval_ctx, self)
+
+    def soft(self):
+        """Return a soft frame.  A soft frame may not be modified as
+        standalone thing as it shares the resources with the frame it
+        was created of, but it's not a rootlevel frame any longer.
+
+        This is only used to implement if-statements.
+        """
+        rv = self.copy()
+        rv.rootlevel = False
+        return rv
+
+    __copy__ = copy
+
+
+class VisitorExit(RuntimeError):
+    """Exception used by the `UndeclaredNameVisitor` to signal a stop."""
+
+
+class DependencyFinderVisitor(NodeVisitor):
+    """A visitor that collects filter and test calls."""
+
+    def __init__(self):
+        self.filters = set()
+        self.tests = set()
+
+    def visit_Filter(self, node):
+        self.generic_visit(node)
+        self.filters.add(node.name)
+
+    def visit_Test(self, node):
+        self.generic_visit(node)
+        self.tests.add(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting at blocks."""
+
+
+class UndeclaredNameVisitor(NodeVisitor):
+    """A visitor that checks if a name is accessed without being
+    declared.  This is different from the frame visitor as it will
+    not stop at closure frames.
+    """
+
+    def __init__(self, names):
+        self.names = set(names)
+        self.undeclared = set()
+
+    def visit_Name(self, node):
+        if node.ctx == "load" and node.name in self.names:
+            self.undeclared.add(node.name)
+            if self.undeclared == self.names:
+                raise VisitorExit()
+        else:
+            self.names.discard(node.name)
+
+    def visit_Block(self, node):
+        """Stop visiting a blocks."""
+
+
+class CompilerExit(Exception):
+    """Raised if the compiler encountered a situation where it just
+    doesn't make sense to further process the code.  Any block that
+    raises such an exception is not further processed.
+    """
+
+
+class CodeGenerator(NodeVisitor):
+    def __init__(
+        self, environment, name, filename, stream=None, defer_init=False, optimized=True
+    ):
+        if stream is None:
+            stream = NativeStringIO()
+        self.environment = environment
+        self.name = name
+        self.filename = filename
+        self.stream = stream
+        self.created_block_context = False
+        self.defer_init = defer_init
+        self.optimized = optimized
+        if optimized:
+            self.optimizer = Optimizer(environment)
+
+        # aliases for imports
+        self.import_aliases = {}
+
+        # a registry for all blocks.  Because blocks are moved out
+        # into the global python scope they are registered here
+        self.blocks = {}
+
+        # the number of extends statements so far
+        self.extends_so_far = 0
+
+        # some templates have a rootlevel extends.  In this case we
+        # can safely assume that we're a child template and do some
+        # more optimizations.
+        self.has_known_extends = False
+
+        # the current line number
+        self.code_lineno = 1
+
+        # registry of all filters and tests (global, not block local)
+        self.tests = {}
+        self.filters = {}
+
+        # the debug information
+        self.debug_info = []
+        self._write_debug_info = None
+
+        # the number of new lines before the next write()
+        self._new_lines = 0
+
+        # the line number of the last written statement
+        self._last_line = 0
+
+        # true if nothing was written so far.
+        self._first_write = True
+
+        # used by the `temporary_identifier` method to get new
+        # unique, temporary identifier
+        self._last_identifier = 0
+
+        # the current indentation
+        self._indentation = 0
+
+        # Tracks toplevel assignments
+        self._assign_stack = []
+
+        # Tracks parameter definition blocks
+        self._param_def_block = []
+
+        # Tracks the current context.
+        self._context_reference_stack = ["context"]
+
+    # -- Various compilation helpers
+
+    def fail(self, msg, lineno):
+        """Fail with a :exc:`TemplateAssertionError`."""
+        raise TemplateAssertionError(msg, lineno, self.name, self.filename)
+
+    def temporary_identifier(self):
+        """Get a new unique identifier."""
+        self._last_identifier += 1
+        return "t_%d" % self._last_identifier
+
+    def buffer(self, frame):
+        """Enable buffering for the frame from that point onwards."""
+        frame.buffer = self.temporary_identifier()
+        self.writeline("%s = []" % frame.buffer)
+
+    def return_buffer_contents(self, frame, force_unescaped=False):
+        """Return the buffer contents of the frame."""
+        if not force_unescaped:
+            if frame.eval_ctx.volatile:
+                self.writeline("if context.eval_ctx.autoescape:")
+                self.indent()
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                self.outdent()
+                self.writeline("else:")
+                self.indent()
+                self.writeline("return concat(%s)" % frame.buffer)
+                self.outdent()
+                return
+            elif frame.eval_ctx.autoescape:
+                self.writeline("return Markup(concat(%s))" % frame.buffer)
+                return
+        self.writeline("return concat(%s)" % frame.buffer)
+
+    def indent(self):
+        """Indent by one."""
+        self._indentation += 1
+
+    def outdent(self, step=1):
+        """Outdent by step."""
+        self._indentation -= step
+
+    def start_write(self, frame, node=None):
+        """Yield or write into the frame buffer."""
+        if frame.buffer is None:
+            self.writeline("yield ", node)
+        else:
+            self.writeline("%s.append(" % frame.buffer, node)
+
+    def end_write(self, frame):
+        """End the writing process started by `start_write`."""
+        if frame.buffer is not None:
+            self.write(")")
+
+    def simple_write(self, s, frame, node=None):
+        """Simple shortcut for start_write + write + end_write."""
+        self.start_write(frame, node)
+        self.write(s)
+        self.end_write(frame)
+
+    def blockvisit(self, nodes, frame):
+        """Visit a list of nodes as block in a frame.  If the current frame
+        is no buffer a dummy ``if 0: yield None`` is written automatically.
+        """
+        try:
+            self.writeline("pass")
+            for node in nodes:
+                self.visit(node, frame)
+        except CompilerExit:
+            pass
+
+    def write(self, x):
+        """Write a string into the output stream."""
+        if self._new_lines:
+            if not self._first_write:
+                self.stream.write("\n" * self._new_lines)
+                self.code_lineno += self._new_lines
+                if self._write_debug_info is not None:
+                    self.debug_info.append((self._write_debug_info, self.code_lineno))
+                    self._write_debug_info = None
+            self._first_write = False
+            self.stream.write("    " * self._indentation)
+            self._new_lines = 0
+        self.stream.write(x)
+
+    def writeline(self, x, node=None, extra=0):
+        """Combination of newline and write."""
+        self.newline(node, extra)
+        self.write(x)
+
+    def newline(self, node=None, extra=0):
+        """Add one or more newlines before the next write."""
+        self._new_lines = max(self._new_lines, 1 + extra)
+        if node is not None and node.lineno != self._last_line:
+            self._write_debug_info = node.lineno
+            self._last_line = node.lineno
+
+    def signature(self, node, frame, extra_kwargs=None):
+        """Writes a function call to the stream for the current node.
+        A leading comma is added automatically.  The extra keyword
+        arguments may not include python keywords otherwise a syntax
+        error could occur.  The extra keyword arguments should be given
+        as python dict.
+        """
+        # if any of the given keyword arguments is a python keyword
+        # we have to make sure that no invalid call is created.
+        kwarg_workaround = False
+        for kwarg in chain((x.key for x in node.kwargs), extra_kwargs or ()):
+            if is_python_keyword(kwarg):
+                kwarg_workaround = True
+                break
+
+        for arg in node.args:
+            self.write(", ")
+            self.visit(arg, frame)
+
+        if not kwarg_workaround:
+            for kwarg in node.kwargs:
+                self.write(", ")
+                self.visit(kwarg, frame)
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write(", %s=%s" % (key, value))
+        if node.dyn_args:
+            self.write(", *")
+            self.visit(node.dyn_args, frame)
+
+        if kwarg_workaround:
+            if node.dyn_kwargs is not None:
+                self.write(", **dict({")
+            else:
+                self.write(", **{")
+            for kwarg in node.kwargs:
+                self.write("%r: " % kwarg.key)
+                self.visit(kwarg.value, frame)
+                self.write(", ")
+            if extra_kwargs is not None:
+                for key, value in iteritems(extra_kwargs):
+                    self.write("%r: %s, " % (key, value))
+            if node.dyn_kwargs is not None:
+                self.write("}, **")
+                self.visit(node.dyn_kwargs, frame)
+                self.write(")")
+            else:
+                self.write("}")
+
+        elif node.dyn_kwargs is not None:
+            self.write(", **")
+            self.visit(node.dyn_kwargs, frame)
+
+    def pull_dependencies(self, nodes):
+        """Pull all the dependencies."""
+        visitor = DependencyFinderVisitor()
+        for node in nodes:
+            visitor.visit(node)
+        for dependency in "filters", "tests":
+            mapping = getattr(self, dependency)
+            for name in getattr(visitor, dependency):
+                if name not in mapping:
+                    mapping[name] = self.temporary_identifier()
+                self.writeline(
+                    "%s = environment.%s[%r]" % (mapping[name], dependency, name)
+                )
+
+    def enter_frame(self, frame):
+        undefs = []
+        for target, (action, param) in iteritems(frame.symbols.loads):
+            if action == VAR_LOAD_PARAMETER:
+                pass
+            elif action == VAR_LOAD_RESOLVE:
+                self.writeline("%s = %s(%r)" % (target, self.get_resolve_func(), param))
+            elif action == VAR_LOAD_ALIAS:
+                self.writeline("%s = %s" % (target, param))
+            elif action == VAR_LOAD_UNDEFINED:
+                undefs.append(target)
+            else:
+                raise NotImplementedError("unknown load instruction")
+        if undefs:
+            self.writeline("%s = missing" % " = ".join(undefs))
+
+    def leave_frame(self, frame, with_python_scope=False):
+        if not with_python_scope:
+            undefs = []
+            for target, _ in iteritems(frame.symbols.loads):
+                undefs.append(target)
+            if undefs:
+                self.writeline("%s = missing" % " = ".join(undefs))
+
+    def func(self, name):
+        if self.environment.is_async:
+            return "async def %s" % name
+        return "def %s" % name
+
+    def macro_body(self, node, frame):
+        """Dump the function def of a macro or call block."""
+        frame = frame.inner()
+        frame.symbols.analyze_node(node)
+        macro_ref = MacroRef(node)
+
+        explicit_caller = None
+        skip_special_params = set()
+        args = []
+        for idx, arg in enumerate(node.args):
+            if arg.name == "caller":
+                explicit_caller = idx
+            if arg.name in ("kwargs", "varargs"):
+                skip_special_params.add(arg.name)
+            args.append(frame.symbols.ref(arg.name))
+
+        undeclared = find_undeclared(node.body, ("caller", "kwargs", "varargs"))
+
+        if "caller" in undeclared:
+            # In older Jinja versions there was a bug that allowed caller
+            # to retain the special behavior even if it was mentioned in
+            # the argument list.  However thankfully this was only really
+            # working if it was the last argument.  So we are explicitly
+            # checking this now and error out if it is anywhere else in
+            # the argument list.
+            if explicit_caller is not None:
+                try:
+                    node.defaults[explicit_caller - len(node.args)]
+                except IndexError:
+                    self.fail(
+                        "When defining macros or call blocks the "
+                        'special "caller" argument must be omitted '
+                        "or be given a default.",
+                        node.lineno,
+                    )
+            else:
+                args.append(frame.symbols.declare_parameter("caller"))
+            macro_ref.accesses_caller = True
+        if "kwargs" in undeclared and "kwargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("kwargs"))
+            macro_ref.accesses_kwargs = True
+        if "varargs" in undeclared and "varargs" not in skip_special_params:
+            args.append(frame.symbols.declare_parameter("varargs"))
+            macro_ref.accesses_varargs = True
+
+        # macros are delayed, they never require output checks
+        frame.require_output_check = False
+        frame.symbols.analyze_node(node)
+        self.writeline("%s(%s):" % (self.func("macro"), ", ".join(args)), node)
+        self.indent()
+
+        self.buffer(frame)
+        self.enter_frame(frame)
+
+        self.push_parameter_definitions(frame)
+        for idx, arg in enumerate(node.args):
+            ref = frame.symbols.ref(arg.name)
+            self.writeline("if %s is missing:" % ref)
+            self.indent()
+            try:
+                default = node.defaults[idx - len(node.args)]
+            except IndexError:
+                self.writeline(
+                    "%s = undefined(%r, name=%r)"
+                    % (ref, "parameter %r was not provided" % arg.name, arg.name)
+                )
+            else:
+                self.writeline("%s = " % ref)
+                self.visit(default, frame)
+            self.mark_parameter_stored(ref)
+            self.outdent()
+        self.pop_parameter_definitions()
+
+        self.blockvisit(node.body, frame)
+        self.return_buffer_contents(frame, force_unescaped=True)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        return frame, macro_ref
+
+    def macro_def(self, macro_ref, frame):
+        """Dump the macro definition for the def created by macro_body."""
+        arg_tuple = ", ".join(repr(x.name) for x in macro_ref.node.args)
+        name = getattr(macro_ref.node, "name", None)
+        if len(macro_ref.node.args) == 1:
+            arg_tuple += ","
+        self.write(
+            "Macro(environment, macro, %r, (%s), %r, %r, %r, "
+            "context.eval_ctx.autoescape)"
+            % (
+                name,
+                arg_tuple,
+                macro_ref.accesses_kwargs,
+                macro_ref.accesses_varargs,
+                macro_ref.accesses_caller,
+            )
+        )
+
+    def position(self, node):
+        """Return a human readable position for the node."""
+        rv = "line %d" % node.lineno
+        if self.name is not None:
+            rv += " in " + repr(self.name)
+        return rv
+
+    def dump_local_context(self, frame):
+        return "{%s}" % ", ".join(
+            "%r: %s" % (name, target)
+            for name, target in iteritems(frame.symbols.dump_stores())
+        )
+
+    def write_commons(self):
+        """Writes a common preamble that is used by root and block functions.
+        Primarily this sets up common local helpers and enforces a generator
+        through a dead branch.
+        """
+        self.writeline("resolve = context.resolve_or_missing")
+        self.writeline("undefined = environment.undefined")
+        # always use the standard Undefined class for the implicit else of
+        # conditional expressions
+        self.writeline("cond_expr_undefined = Undefined")
+        self.writeline("if 0: yield None")
+
+    def push_parameter_definitions(self, frame):
+        """Pushes all parameter targets from the given frame into a local
+        stack that permits tracking of yet to be assigned parameters.  In
+        particular this enables the optimization from `visit_Name` to skip
+        undefined expressions for parameters in macros as macros can reference
+        otherwise unbound parameters.
+        """
+        self._param_def_block.append(frame.symbols.dump_param_targets())
+
+    def pop_parameter_definitions(self):
+        """Pops the current parameter definitions set."""
+        self._param_def_block.pop()
+
+    def mark_parameter_stored(self, target):
+        """Marks a parameter in the current parameter definitions as stored.
+        This will skip the enforced undefined checks.
+        """
+        if self._param_def_block:
+            self._param_def_block[-1].discard(target)
+
+    def push_context_reference(self, target):
+        self._context_reference_stack.append(target)
+
+    def pop_context_reference(self):
+        self._context_reference_stack.pop()
+
+    def get_context_ref(self):
+        return self._context_reference_stack[-1]
+
+    def get_resolve_func(self):
+        target = self._context_reference_stack[-1]
+        if target == "context":
+            return "resolve"
+        return "%s.resolve" % target
+
+    def derive_context(self, frame):
+        return "%s.derived(%s)" % (
+            self.get_context_ref(),
+            self.dump_local_context(frame),
+        )
+
+    def parameter_is_undeclared(self, target):
+        """Checks if a given target is an undeclared parameter."""
+        if not self._param_def_block:
+            return False
+        return target in self._param_def_block[-1]
+
+    def push_assign_tracking(self):
+        """Pushes a new layer for assignment tracking."""
+        self._assign_stack.append(set())
+
+    def pop_assign_tracking(self, frame):
+        """Pops the topmost level for assignment tracking and updates the
+        context variables if necessary.
+        """
+        vars = self._assign_stack.pop()
+        if not frame.toplevel or not vars:
+            return
+        public_names = [x for x in vars if x[:1] != "_"]
+        if len(vars) == 1:
+            name = next(iter(vars))
+            ref = frame.symbols.ref(name)
+            self.writeline("context.vars[%r] = %s" % (name, ref))
+        else:
+            self.writeline("context.vars.update({")
+            for idx, name in enumerate(vars):
+                if idx:
+                    self.write(", ")
+                ref = frame.symbols.ref(name)
+                self.write("%r: %s" % (name, ref))
+            self.write("})")
+        if public_names:
+            if len(public_names) == 1:
+                self.writeline("context.exported_vars.add(%r)" % public_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.update((%s))"
+                    % ", ".join(imap(repr, public_names))
+                )
+
+    # -- Statement Visitors
+
+    def visit_Template(self, node, frame=None):
+        assert frame is None, "no root frame allowed"
+        eval_ctx = EvalContext(self.environment, self.name)
+
+        from .runtime import exported
+
+        self.writeline("from __future__ import %s" % ", ".join(code_features))
+        self.writeline("from jinja2.runtime import " + ", ".join(exported))
+
+        if self.environment.is_async:
+            self.writeline(
+                "from jinja2.asyncsupport import auto_await, "
+                "auto_aiter, AsyncLoopContext"
+            )
+
+        # if we want a deferred initialization we cannot move the
+        # environment into a local name
+        envenv = not self.defer_init and ", environment=environment" or ""
+
+        # do we have an extends tag at all?  If not, we can save some
+        # overhead by just not processing any inheritance code.
+        have_extends = node.find(nodes.Extends) is not None
+
+        # find all blocks
+        for block in node.find_all(nodes.Block):
+            if block.name in self.blocks:
+                self.fail("block %r defined twice" % block.name, block.lineno)
+            self.blocks[block.name] = block
+
+        # find all imports and import them
+        for import_ in node.find_all(nodes.ImportedName):
+            if import_.importname not in self.import_aliases:
+                imp = import_.importname
+                self.import_aliases[imp] = alias = self.temporary_identifier()
+                if "." in imp:
+                    module, obj = imp.rsplit(".", 1)
+                    self.writeline("from %s import %s as %s" % (module, obj, alias))
+                else:
+                    self.writeline("import %s as %s" % (imp, alias))
+
+        # add the load name
+        self.writeline("name = %r" % self.name)
+
+        # generate the root render function.
+        self.writeline(
+            "%s(context, missing=missing%s):" % (self.func("root"), envenv), extra=1
+        )
+        self.indent()
+        self.write_commons()
+
+        # process the root
+        frame = Frame(eval_ctx)
+        if "self" in find_undeclared(node.body, ("self",)):
+            ref = frame.symbols.declare_parameter("self")
+            self.writeline("%s = TemplateReference(context)" % ref)
+        frame.symbols.analyze_node(node)
+        frame.toplevel = frame.rootlevel = True
+        frame.require_output_check = have_extends and not self.has_known_extends
+        if have_extends:
+            self.writeline("parent_template = None")
+        self.enter_frame(frame)
+        self.pull_dependencies(node.body)
+        self.blockvisit(node.body, frame)
+        self.leave_frame(frame, with_python_scope=True)
+        self.outdent()
+
+        # make sure that the parent root is called.
+        if have_extends:
+            if not self.has_known_extends:
+                self.indent()
+                self.writeline("if parent_template is not None:")
+            self.indent()
+            if supports_yield_from and not self.environment.is_async:
+                self.writeline("yield from parent_template.root_render_func(context)")
+            else:
+                self.writeline(
+                    "%sfor event in parent_template."
+                    "root_render_func(context):"
+                    % (self.environment.is_async and "async " or "")
+                )
+                self.indent()
+                self.writeline("yield event")
+                self.outdent()
+            self.outdent(1 + (not self.has_known_extends))
+
+        # at this point we now have the blocks collected and can visit them too.
+        for name, block in iteritems(self.blocks):
+            self.writeline(
+                "%s(context, missing=missing%s):"
+                % (self.func("block_" + name), envenv),
+                block,
+                1,
+            )
+            self.indent()
+            self.write_commons()
+            # It's important that we do not make this frame a child of the
+            # toplevel template.  This would cause a variety of
+            # interesting issues with identifier tracking.
+            block_frame = Frame(eval_ctx)
+            undeclared = find_undeclared(block.body, ("self", "super"))
+            if "self" in undeclared:
+                ref = block_frame.symbols.declare_parameter("self")
+                self.writeline("%s = TemplateReference(context)" % ref)
+            if "super" in undeclared:
+                ref = block_frame.symbols.declare_parameter("super")
+                self.writeline("%s = context.super(%r, block_%s)" % (ref, name, name))
+            block_frame.symbols.analyze_node(block)
+            block_frame.block = name
+            self.enter_frame(block_frame)
+            self.pull_dependencies(block.body)
+            self.blockvisit(block.body, block_frame)
+            self.leave_frame(block_frame, with_python_scope=True)
+            self.outdent()
+
+        self.writeline(
+            "blocks = {%s}" % ", ".join("%r: block_%s" % (x, x) for x in self.blocks),
+            extra=1,
+        )
+
+        # add a function that returns the debug info
+        self.writeline(
+            "debug_info = %r" % "&".join("%s=%s" % x for x in self.debug_info)
+        )
+
+    def visit_Block(self, node, frame):
+        """Call a block and register it for the template."""
+        level = 0
+        if frame.toplevel:
+            # if we know that we are a child template, there is no need to
+            # check if we are one
+            if self.has_known_extends:
+                return
+            if self.extends_so_far > 0:
+                self.writeline("if parent_template is None:")
+                self.indent()
+                level += 1
+
+        if node.scoped:
+            context = self.derive_context(frame)
+        else:
+            context = self.get_context_ref()
+
+        if (
+            supports_yield_from
+            and not self.environment.is_async
+            and frame.buffer is None
+        ):
+            self.writeline(
+                "yield from context.blocks[%r][0](%s)" % (node.name, context), node
+            )
+        else:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in context.blocks[%r][0](%s):" % (loop, node.name, context),
+                node,
+            )
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        self.outdent(level)
+
+    def visit_Extends(self, node, frame):
+        """Calls the extender."""
+        if not frame.toplevel:
+            self.fail("cannot use extend from a non top-level scope", node.lineno)
+
+        # if the number of extends statements in general is zero so
+        # far, we don't have to add a check if something extended
+        # the template before this one.
+        if self.extends_so_far > 0:
+
+            # if we have a known extends we just add a template runtime
+            # error into the generated code.  We could catch that at compile
+            # time too, but i welcome it not to confuse users by throwing the
+            # same error at different times just "because we can".
+            if not self.has_known_extends:
+                self.writeline("if parent_template is not None:")
+                self.indent()
+            self.writeline("raise TemplateRuntimeError(%r)" % "extended multiple times")
+
+            # if we have a known extends already we don't need that code here
+            # as we know that the template execution will end here.
+            if self.has_known_extends:
+                raise CompilerExit()
+            else:
+                self.outdent()
+
+        self.writeline("parent_template = environment.get_template(", node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        self.writeline(
+            "for name, parent_block in parent_template.blocks.%s():" % dict_item_iter
+        )
+        self.indent()
+        self.writeline("context.blocks.setdefault(name, []).append(parent_block)")
+        self.outdent()
+
+        # if this extends statement was in the root level we can take
+        # advantage of that information and simplify the generated code
+        # in the top level from this point onwards
+        if frame.rootlevel:
+            self.has_known_extends = True
+
+        # and now we have one more
+        self.extends_so_far += 1
+
+    def visit_Include(self, node, frame):
+        """Handles includes."""
+        if node.ignore_missing:
+            self.writeline("try:")
+            self.indent()
+
+        func_name = "get_or_select_template"
+        if isinstance(node.template, nodes.Const):
+            if isinstance(node.template.value, string_types):
+                func_name = "get_template"
+            elif isinstance(node.template.value, (tuple, list)):
+                func_name = "select_template"
+        elif isinstance(node.template, (nodes.Tuple, nodes.List)):
+            func_name = "select_template"
+
+        self.writeline("template = environment.%s(" % func_name, node)
+        self.visit(node.template, frame)
+        self.write(", %r)" % self.name)
+        if node.ignore_missing:
+            self.outdent()
+            self.writeline("except TemplateNotFound:")
+            self.indent()
+            self.writeline("pass")
+            self.outdent()
+            self.writeline("else:")
+            self.indent()
+
+        skip_event_yield = False
+        if node.with_context:
+            loop = self.environment.is_async and "async for" or "for"
+            self.writeline(
+                "%s event in template.root_render_func("
+                "template.new_context(context.get_all(), True, "
+                "%s)):" % (loop, self.dump_local_context(frame))
+            )
+        elif self.environment.is_async:
+            self.writeline(
+                "for event in (await "
+                "template._get_default_module_async())"
+                "._body_stream:"
+            )
+        else:
+            if supports_yield_from:
+                self.writeline("yield from template._get_default_module()._body_stream")
+                skip_event_yield = True
+            else:
+                self.writeline(
+                    "for event in template._get_default_module()._body_stream:"
+                )
+
+        if not skip_event_yield:
+            self.indent()
+            self.simple_write("event", frame)
+            self.outdent()
+
+        if node.ignore_missing:
+            self.outdent()
+
+    def visit_Import(self, node, frame):
+        """Visit regular imports."""
+        self.writeline("%s = " % frame.symbols.ref(node.target), node)
+        if frame.toplevel:
+            self.write("context.vars[%r] = " % node.target)
+        if self.environment.is_async:
+            self.write("await ")
+        self.write("environment.get_template(")
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+        if frame.toplevel and not node.target.startswith("_"):
+            self.writeline("context.exported_vars.discard(%r)" % node.target)
+
+    def visit_FromImport(self, node, frame):
+        """Visit named imports."""
+        self.newline(node)
+        self.write(
+            "included_template = %senvironment.get_template("
+            % (self.environment.is_async and "await " or "")
+        )
+        self.visit(node.template, frame)
+        self.write(", %r)." % self.name)
+        if node.with_context:
+            self.write(
+                "make_module%s(context.get_all(), True, %s)"
+                % (
+                    self.environment.is_async and "_async" or "",
+                    self.dump_local_context(frame),
+                )
+            )
+        elif self.environment.is_async:
+            self.write("_get_default_module_async()")
+        else:
+            self.write("_get_default_module()")
+
+        var_names = []
+        discarded_names = []
+        for name in node.names:
+            if isinstance(name, tuple):
+                name, alias = name
+            else:
+                alias = name
+            self.writeline(
+                "%s = getattr(included_template, "
+                "%r, missing)" % (frame.symbols.ref(alias), name)
+            )
+            self.writeline("if %s is missing:" % frame.symbols.ref(alias))
+            self.indent()
+            self.writeline(
+                "%s = undefined(%r %% "
+                "included_template.__name__, "
+                "name=%r)"
+                % (
+                    frame.symbols.ref(alias),
+                    "the template %%r (imported on %s) does "
+                    "not export the requested name %s"
+                    % (self.position(node), repr(name)),
+                    name,
+                )
+            )
+            self.outdent()
+            if frame.toplevel:
+                var_names.append(alias)
+                if not alias.startswith("_"):
+                    discarded_names.append(alias)
+
+        if var_names:
+            if len(var_names) == 1:
+                name = var_names[0]
+                self.writeline(
+                    "context.vars[%r] = %s" % (name, frame.symbols.ref(name))
+                )
+            else:
+                self.writeline(
+                    "context.vars.update({%s})"
+                    % ", ".join(
+                        "%r: %s" % (name, frame.symbols.ref(name)) for name in var_names
+                    )
+                )
+        if discarded_names:
+            if len(discarded_names) == 1:
+                self.writeline("context.exported_vars.discard(%r)" % discarded_names[0])
+            else:
+                self.writeline(
+                    "context.exported_vars.difference_"
+                    "update((%s))" % ", ".join(imap(repr, discarded_names))
+                )
+
+    def visit_For(self, node, frame):
+        loop_frame = frame.inner()
+        test_frame = frame.inner()
+        else_frame = frame.inner()
+
+        # try to figure out if we have an extended loop.  An extended loop
+        # is necessary if the loop is in recursive mode if the special loop
+        # variable is accessed in the body.
+        extended_loop = node.recursive or "loop" in find_undeclared(
+            node.iter_child_nodes(only=("body",)), ("loop",)
+        )
+
+        loop_ref = None
+        if extended_loop:
+            loop_ref = loop_frame.symbols.declare_parameter("loop")
+
+        loop_frame.symbols.analyze_node(node, for_branch="body")
+        if node.else_:
+            else_frame.symbols.analyze_node(node, for_branch="else")
+
+        if node.test:
+            loop_filter_func = self.temporary_identifier()
+            test_frame.symbols.analyze_node(node, for_branch="test")
+            self.writeline("%s(fiter):" % self.func(loop_filter_func), node.test)
+            self.indent()
+            self.enter_frame(test_frame)
+            self.writeline(self.environment.is_async and "async for " or "for ")
+            self.visit(node.target, loop_frame)
+            self.write(" in ")
+            self.write(self.environment.is_async and "auto_aiter(fiter)" or "fiter")
+            self.write(":")
+            self.indent()
+            self.writeline("if ", node.test)
+            self.visit(node.test, test_frame)
+            self.write(":")
+            self.indent()
+            self.writeline("yield ")
+            self.visit(node.target, loop_frame)
+            self.outdent(3)
+            self.leave_frame(test_frame, with_python_scope=True)
+
+        # if we don't have an recursive loop we have to find the shadowed
+        # variables at that point.  Because loops can be nested but the loop
+        # variable is a special one we have to enforce aliasing for it.
+        if node.recursive:
+            self.writeline(
+                "%s(reciter, loop_render_func, depth=0):" % self.func("loop"), node
+            )
+            self.indent()
+            self.buffer(loop_frame)
+
+            # Use the same buffer for the else frame
+            else_frame.buffer = loop_frame.buffer
+
+        # make sure the loop variable is a special one and raise a template
+        # assertion error if a loop tries to write to loop
+        if extended_loop:
+            self.writeline("%s = missing" % loop_ref)
+
+        for name in node.find_all(nodes.Name):
+            if name.ctx == "store" and name.name == "loop":
+                self.fail(
+                    "Can't assign to special loop variable in for-loop target",
+                    name.lineno,
+                )
+
+        if node.else_:
+            iteration_indicator = self.temporary_identifier()
+            self.writeline("%s = 1" % iteration_indicator)
+
+        self.writeline(self.environment.is_async and "async for " or "for ", node)
+        self.visit(node.target, loop_frame)
+        if extended_loop:
+            if self.environment.is_async:
+                self.write(", %s in AsyncLoopContext(" % loop_ref)
+            else:
+                self.write(", %s in LoopContext(" % loop_ref)
+        else:
+            self.write(" in ")
+
+        if node.test:
+            self.write("%s(" % loop_filter_func)
+        if node.recursive:
+            self.write("reciter")
+        else:
+            if self.environment.is_async and not extended_loop:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async and not extended_loop:
+                self.write(")")
+        if node.test:
+            self.write(")")
+
+        if node.recursive:
+            self.write(", undefined, loop_render_func, depth):")
+        else:
+            self.write(extended_loop and ", undefined):" or ":")
+
+        self.indent()
+        self.enter_frame(loop_frame)
+
+        self.blockvisit(node.body, loop_frame)
+        if node.else_:
+            self.writeline("%s = 0" % iteration_indicator)
+        self.outdent()
+        self.leave_frame(
+            loop_frame, with_python_scope=node.recursive and not node.else_
+        )
+
+        if node.else_:
+            self.writeline("if %s:" % iteration_indicator)
+            self.indent()
+            self.enter_frame(else_frame)
+            self.blockvisit(node.else_, else_frame)
+            self.leave_frame(else_frame)
+            self.outdent()
+
+        # if the node was recursive we have to return the buffer contents
+        # and start the iteration code
+        if node.recursive:
+            self.return_buffer_contents(loop_frame)
+            self.outdent()
+            self.start_write(frame, node)
+            if self.environment.is_async:
+                self.write("await ")
+            self.write("loop(")
+            if self.environment.is_async:
+                self.write("auto_aiter(")
+            self.visit(node.iter, frame)
+            if self.environment.is_async:
+                self.write(")")
+            self.write(", loop)")
+            self.end_write(frame)
+
+    def visit_If(self, node, frame):
+        if_frame = frame.soft()
+        self.writeline("if ", node)
+        self.visit(node.test, if_frame)
+        self.write(":")
+        self.indent()
+        self.blockvisit(node.body, if_frame)
+        self.outdent()
+        for elif_ in node.elif_:
+            self.writeline("elif ", elif_)
+            self.visit(elif_.test, if_frame)
+            self.write(":")
+            self.indent()
+            self.blockvisit(elif_.body, if_frame)
+            self.outdent()
+        if node.else_:
+            self.writeline("else:")
+            self.indent()
+            self.blockvisit(node.else_, if_frame)
+            self.outdent()
+
+    def visit_Macro(self, node, frame):
+        macro_frame, macro_ref = self.macro_body(node, frame)
+        self.newline()
+        if frame.toplevel:
+            if not node.name.startswith("_"):
+                self.write("context.exported_vars.add(%r)" % node.name)
+            self.writeline("context.vars[%r] = " % node.name)
+        self.write("%s = " % frame.symbols.ref(node.name))
+        self.macro_def(macro_ref, macro_frame)
+
+    def visit_CallBlock(self, node, frame):
+        call_frame, macro_ref = self.macro_body(node, frame)
+        self.writeline("caller = ")
+        self.macro_def(macro_ref, call_frame)
+        self.start_write(frame, node)
+        self.visit_Call(node.call, frame, forward_caller=True)
+        self.end_write(frame)
+
+    def visit_FilterBlock(self, node, frame):
+        filter_frame = frame.inner()
+        filter_frame.symbols.analyze_node(node)
+        self.enter_frame(filter_frame)
+        self.buffer(filter_frame)
+        self.blockvisit(node.body, filter_frame)
+        self.start_write(frame, node)
+        self.visit_Filter(node.filter, filter_frame)
+        self.end_write(frame)
+        self.leave_frame(filter_frame)
+
+    def visit_With(self, node, frame):
+        with_frame = frame.inner()
+        with_frame.symbols.analyze_node(node)
+        self.enter_frame(with_frame)
+        for target, expr in izip(node.targets, node.values):
+            self.newline()
+            self.visit(target, with_frame)
+            self.write(" = ")
+            self.visit(expr, frame)
+        self.blockvisit(node.body, with_frame)
+        self.leave_frame(with_frame)
+
+    def visit_ExprStmt(self, node, frame):
+        self.newline(node)
+        self.visit(node.node, frame)
+
+    _FinalizeInfo = namedtuple("_FinalizeInfo", ("const", "src"))
+    #: The default finalize function if the environment isn't configured
+    #: with one. Or if the environment has one, this is called on that
+    #: function's output for constants.
+    _default_finalize = text_type
+    _finalize = None
+
+    def _make_finalize(self):
+        """Build the finalize function to be used on constants and at
+        runtime. Cached so it's only created once for all output nodes.
+
+        Returns a ``namedtuple`` with the following attributes:
+
+        ``const``
+            A function to finalize constant data at compile time.
+
+        ``src``
+            Source code to output around nodes to be evaluated at
+            runtime.
+        """
+        if self._finalize is not None:
+            return self._finalize
+
+        finalize = default = self._default_finalize
+        src = None
+
+        if self.environment.finalize:
+            src = "environment.finalize("
+            env_finalize = self.environment.finalize
+
+            def finalize(value):
+                return default(env_finalize(value))
+
+            if getattr(env_finalize, "contextfunction", False) is True:
+                src += "context, "
+                finalize = None  # noqa: F811
+            elif getattr(env_finalize, "evalcontextfunction", False) is True:
+                src += "context.eval_ctx, "
+                finalize = None
+            elif getattr(env_finalize, "environmentfunction", False) is True:
+                src += "environment, "
+
+                def finalize(value):
+                    return default(env_finalize(self.environment, value))
+
+        self._finalize = self._FinalizeInfo(finalize, src)
+        return self._finalize
+
+    def _output_const_repr(self, group):
+        """Given a group of constant values converted from ``Output``
+        child nodes, produce a string to write to the template module
+        source.
+        """
+        return repr(concat(group))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        """Try to optimize a child of an ``Output`` node by trying to
+        convert it to constant, finalized data at compile time.
+
+        If :exc:`Impossible` is raised, the node is not constant and
+        will be evaluated at runtime. Any other exception will also be
+        evaluated at runtime for easier debugging.
+        """
+        const = node.as_const(frame.eval_ctx)
+
+        if frame.eval_ctx.autoescape:
+            const = escape(const)
+
+        # Template data doesn't go through finalize.
+        if isinstance(node, nodes.TemplateData):
+            return text_type(const)
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        """Output extra source code before visiting a child of an
+        ``Output`` node.
+        """
+        if frame.eval_ctx.volatile:
+            self.write("(escape if context.eval_ctx.autoescape else to_string)(")
+        elif frame.eval_ctx.autoescape:
+            self.write("escape(")
+        else:
+            self.write("to_string(")
+
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        """Output extra source code after visiting a child of an
+        ``Output`` node.
+        """
+        self.write(")")
+
+        if finalize.src is not None:
+            self.write(")")
+
+    def visit_Output(self, node, frame):
+        # If an extends is active, don't render outside a block.
+        if frame.require_output_check:
+            # A top-level extends is known to exist at compile time.
+            if self.has_known_extends:
+                return
+
+            self.writeline("if parent_template is None:")
+            self.indent()
+
+        finalize = self._make_finalize()
+        body = []
+
+        # Evaluate constants at compile time if possible. Each item in
+        # body will be either a list of static data or a node to be
+        # evaluated at runtime.
+        for child in node.nodes:
+            try:
+                if not (
+                    # If the finalize function requires runtime context,
+                    # constants can't be evaluated at compile time.
+                    finalize.const
+                    # Unless it's basic template data that won't be
+                    # finalized anyway.
+                    or isinstance(child, nodes.TemplateData)
+                ):
+                    raise nodes.Impossible()
+
+                const = self._output_child_to_const(child, frame, finalize)
+            except (nodes.Impossible, Exception):
+                # The node was not constant and needs to be evaluated at
+                # runtime. Or another error was raised, which is easier
+                # to debug at runtime.
+                body.append(child)
+                continue
+
+            if body and isinstance(body[-1], list):
+                body[-1].append(const)
+            else:
+                body.append([const])
+
+        if frame.buffer is not None:
+            if len(body) == 1:
+                self.writeline("%s.append(" % frame.buffer)
+            else:
+                self.writeline("%s.extend((" % frame.buffer)
+
+            self.indent()
+
+        for item in body:
+            if isinstance(item, list):
+                # A group of constant data to join and output.
+                val = self._output_const_repr(item)
+
+                if frame.buffer is None:
+                    self.writeline("yield " + val)
+                else:
+                    self.writeline(val + ",")
+            else:
+                if frame.buffer is None:
+                    self.writeline("yield ", item)
+                else:
+                    self.newline(item)
+
+                # A node to be evaluated at runtime.
+                self._output_child_pre(item, frame, finalize)
+                self.visit(item, frame)
+                self._output_child_post(item, frame, finalize)
+
+                if frame.buffer is not None:
+                    self.write(",")
+
+        if frame.buffer is not None:
+            self.outdent()
+            self.writeline(")" if len(body) == 1 else "))")
+
+        if frame.require_output_check:
+            self.outdent()
+
+    def visit_Assign(self, node, frame):
+        self.push_assign_tracking()
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = ")
+        self.visit(node.node, frame)
+        self.pop_assign_tracking(frame)
+
+    def visit_AssignBlock(self, node, frame):
+        self.push_assign_tracking()
+        block_frame = frame.inner()
+        # This is a special case.  Since a set block always captures we
+        # will disable output checks.  This way one can use set blocks
+        # toplevel even in extended templates.
+        block_frame.require_output_check = False
+        block_frame.symbols.analyze_node(node)
+        self.enter_frame(block_frame)
+        self.buffer(block_frame)
+        self.blockvisit(node.body, block_frame)
+        self.newline(node)
+        self.visit(node.target, frame)
+        self.write(" = (Markup if context.eval_ctx.autoescape else identity)(")
+        if node.filter is not None:
+            self.visit_Filter(node.filter, block_frame)
+        else:
+            self.write("concat(%s)" % block_frame.buffer)
+        self.write(")")
+        self.pop_assign_tracking(frame)
+        self.leave_frame(block_frame)
+
+    # -- Expression Visitors
+
+    def visit_Name(self, node, frame):
+        if node.ctx == "store" and frame.toplevel:
+            if self._assign_stack:
+                self._assign_stack[-1].add(node.name)
+        ref = frame.symbols.ref(node.name)
+
+        # If we are looking up a variable we might have to deal with the
+        # case where it's undefined.  We can skip that case if the load
+        # instruction indicates a parameter which are always defined.
+        if node.ctx == "load":
+            load = frame.symbols.find_load(ref)
+            if not (
+                load is not None
+                and load[0] == VAR_LOAD_PARAMETER
+                and not self.parameter_is_undeclared(ref)
+            ):
+                self.write(
+                    "(undefined(name=%r) if %s is missing else %s)"
+                    % (node.name, ref, ref)
+                )
+                return
+
+        self.write(ref)
+
+    def visit_NSRef(self, node, frame):
+        # NSRefs can only be used to store values; since they use the normal
+        # `foo.bar` notation they will be parsed as a normal attribute access
+        # when used anywhere but in a `set` context
+        ref = frame.symbols.ref(node.name)
+        self.writeline("if not isinstance(%s, Namespace):" % ref)
+        self.indent()
+        self.writeline(
+            "raise TemplateRuntimeError(%r)"
+            % "cannot assign attribute on non-namespace object"
+        )
+        self.outdent()
+        self.writeline("%s[%r]" % (ref, node.attr))
+
+    def visit_Const(self, node, frame):
+        val = node.as_const(frame.eval_ctx)
+        if isinstance(val, float):
+            self.write(str(val))
+        else:
+            self.write(repr(val))
+
+    def visit_TemplateData(self, node, frame):
+        try:
+            self.write(repr(node.as_const(frame.eval_ctx)))
+        except nodes.Impossible:
+            self.write(
+                "(Markup if context.eval_ctx.autoescape else identity)(%r)" % node.data
+            )
+
+    def visit_Tuple(self, node, frame):
+        self.write("(")
+        idx = -1
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write(idx == 0 and ",)" or ")")
+
+    def visit_List(self, node, frame):
+        self.write("[")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item, frame)
+        self.write("]")
+
+    def visit_Dict(self, node, frame):
+        self.write("{")
+        for idx, item in enumerate(node.items):
+            if idx:
+                self.write(", ")
+            self.visit(item.key, frame)
+            self.write(": ")
+            self.visit(item.value, frame)
+        self.write("}")
+
+    def binop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_binops
+            ):
+                self.write("environment.call_binop(context, %r, " % operator)
+                self.visit(node.left, frame)
+                self.write(", ")
+                self.visit(node.right, frame)
+            else:
+                self.write("(")
+                self.visit(node.left, frame)
+                self.write(" %s " % operator)
+                self.visit(node.right, frame)
+            self.write(")")
+
+        return visitor
+
+    def uaop(operator, interceptable=True):  # noqa: B902
+        @optimizeconst
+        def visitor(self, node, frame):
+            if (
+                self.environment.sandboxed
+                and operator in self.environment.intercepted_unops
+            ):
+                self.write("environment.call_unop(context, %r, " % operator)
+                self.visit(node.node, frame)
+            else:
+                self.write("(" + operator)
+                self.visit(node.node, frame)
+            self.write(")")
+
+        return visitor
+
+    visit_Add = binop("+")
+    visit_Sub = binop("-")
+    visit_Mul = binop("*")
+    visit_Div = binop("/")
+    visit_FloorDiv = binop("//")
+    visit_Pow = binop("**")
+    visit_Mod = binop("%")
+    visit_And = binop("and", interceptable=False)
+    visit_Or = binop("or", interceptable=False)
+    visit_Pos = uaop("+")
+    visit_Neg = uaop("-")
+    visit_Not = uaop("not ", interceptable=False)
+    del binop, uaop
+
+    @optimizeconst
+    def visit_Concat(self, node, frame):
+        if frame.eval_ctx.volatile:
+            func_name = "(context.eval_ctx.volatile and markup_join or unicode_join)"
+        elif frame.eval_ctx.autoescape:
+            func_name = "markup_join"
+        else:
+            func_name = "unicode_join"
+        self.write("%s((" % func_name)
+        for arg in node.nodes:
+            self.visit(arg, frame)
+            self.write(", ")
+        self.write("))")
+
+    @optimizeconst
+    def visit_Compare(self, node, frame):
+        self.write("(")
+        self.visit(node.expr, frame)
+        for op in node.ops:
+            self.visit(op, frame)
+        self.write(")")
+
+    def visit_Operand(self, node, frame):
+        self.write(" %s " % operators[node.op])
+        self.visit(node.expr, frame)
+
+    @optimizeconst
+    def visit_Getattr(self, node, frame):
+        if self.environment.is_async:
+            self.write("(await auto_await(")
+
+        self.write("environment.getattr(")
+        self.visit(node.node, frame)
+        self.write(", %r)" % node.attr)
+
+        if self.environment.is_async:
+            self.write("))")
+
+    @optimizeconst
+    def visit_Getitem(self, node, frame):
+        # slices bypass the environment getitem method.
+        if isinstance(node.arg, nodes.Slice):
+            self.visit(node.node, frame)
+            self.write("[")
+            self.visit(node.arg, frame)
+            self.write("]")
+        else:
+            if self.environment.is_async:
+                self.write("(await auto_await(")
+
+            self.write("environment.getitem(")
+            self.visit(node.node, frame)
+            self.write(", ")
+            self.visit(node.arg, frame)
+            self.write(")")
+
+            if self.environment.is_async:
+                self.write("))")
+
+    def visit_Slice(self, node, frame):
+        if node.start is not None:
+            self.visit(node.start, frame)
+        self.write(":")
+        if node.stop is not None:
+            self.visit(node.stop, frame)
+        if node.step is not None:
+            self.write(":")
+            self.visit(node.step, frame)
+
+    @optimizeconst
+    def visit_Filter(self, node, frame):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        self.write(self.filters[node.name] + "(")
+        func = self.environment.filters.get(node.name)
+        if func is None:
+            self.fail("no filter named %r" % node.name, node.lineno)
+        if getattr(func, "contextfilter", False) is True:
+            self.write("context, ")
+        elif getattr(func, "evalcontextfilter", False) is True:
+            self.write("context.eval_ctx, ")
+        elif getattr(func, "environmentfilter", False) is True:
+            self.write("environment, ")
+
+        # if the filter node is None we are inside a filter block
+        # and want to write to the current buffer
+        if node.node is not None:
+            self.visit(node.node, frame)
+        elif frame.eval_ctx.volatile:
+            self.write(
+                "(context.eval_ctx.autoescape and"
+                " Markup(concat(%s)) or concat(%s))" % (frame.buffer, frame.buffer)
+            )
+        elif frame.eval_ctx.autoescape:
+            self.write("Markup(concat(%s))" % frame.buffer)
+        else:
+            self.write("concat(%s)" % frame.buffer)
+        self.signature(node, frame)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    @optimizeconst
+    def visit_Test(self, node, frame):
+        self.write(self.tests[node.name] + "(")
+        if node.name not in self.environment.tests:
+            self.fail("no test named %r" % node.name, node.lineno)
+        self.visit(node.node, frame)
+        self.signature(node, frame)
+        self.write(")")
+
+    @optimizeconst
+    def visit_CondExpr(self, node, frame):
+        def write_expr2():
+            if node.expr2 is not None:
+                return self.visit(node.expr2, frame)
+            self.write(
+                "cond_expr_undefined(%r)"
+                % (
+                    "the inline if-"
+                    "expression on %s evaluated to false and "
+                    "no else section was defined." % self.position(node)
+                )
+            )
+
+        self.write("(")
+        self.visit(node.expr1, frame)
+        self.write(" if ")
+        self.visit(node.test, frame)
+        self.write(" else ")
+        write_expr2()
+        self.write(")")
+
+    @optimizeconst
+    def visit_Call(self, node, frame, forward_caller=False):
+        if self.environment.is_async:
+            self.write("await auto_await(")
+        if self.environment.sandboxed:
+            self.write("environment.call(context, ")
+        else:
+            self.write("context.call(")
+        self.visit(node.node, frame)
+        extra_kwargs = forward_caller and {"caller": "caller"} or None
+        self.signature(node, frame, extra_kwargs)
+        self.write(")")
+        if self.environment.is_async:
+            self.write(")")
+
+    def visit_Keyword(self, node, frame):
+        self.write(node.key + "=")
+        self.visit(node.value, frame)
+
+    # -- Unused nodes for extensions
+
+    def visit_MarkSafe(self, node, frame):
+        self.write("Markup(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_MarkSafeIfAutoescape(self, node, frame):
+        self.write("(context.eval_ctx.autoescape and Markup or identity)(")
+        self.visit(node.expr, frame)
+        self.write(")")
+
+    def visit_EnvironmentAttribute(self, node, frame):
+        self.write("environment." + node.name)
+
+    def visit_ExtensionAttribute(self, node, frame):
+        self.write("environment.extensions[%r].%s" % (node.identifier, node.name))
+
+    def visit_ImportedName(self, node, frame):
+        self.write(self.import_aliases[node.importname])
+
+    def visit_InternalName(self, node, frame):
+        self.write(node.name)
+
+    def visit_ContextReference(self, node, frame):
+        self.write("context")
+
+    def visit_DerivedContextReference(self, node, frame):
+        self.write(self.derive_context(frame))
+
+    def visit_Continue(self, node, frame):
+        self.writeline("continue", node)
+
+    def visit_Break(self, node, frame):
+        self.writeline("break", node)
+
+    def visit_Scope(self, node, frame):
+        scope_frame = frame.inner()
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+
+    def visit_OverlayScope(self, node, frame):
+        ctx = self.temporary_identifier()
+        self.writeline("%s = %s" % (ctx, self.derive_context(frame)))
+        self.writeline("%s.vars = " % ctx)
+        self.visit(node.context, frame)
+        self.push_context_reference(ctx)
+
+        scope_frame = frame.inner(isolated=True)
+        scope_frame.symbols.analyze_node(node)
+        self.enter_frame(scope_frame)
+        self.blockvisit(node.body, scope_frame)
+        self.leave_frame(scope_frame)
+        self.pop_context_reference()
+
+    def visit_EvalContextModifier(self, node, frame):
+        for keyword in node.options:
+            self.writeline("context.eval_ctx.%s = " % keyword.key)
+            self.visit(keyword.value, frame)
+            try:
+                val = keyword.value.as_const(frame.eval_ctx)
+            except nodes.Impossible:
+                frame.eval_ctx.volatile = True
+            else:
+                setattr(frame.eval_ctx, keyword.key, val)
+
+    def visit_ScopedEvalContextModifier(self, node, frame):
+        old_ctx_name = self.temporary_identifier()
+        saved_ctx = frame.eval_ctx.save()
+        self.writeline("%s = context.eval_ctx.save()" % old_ctx_name)
+        self.visit_EvalContextModifier(node, frame)
+        for child in node.body:
+            self.visit(child, frame)
+        frame.eval_ctx.revert(saved_ctx)
+        self.writeline("context.eval_ctx.revert(%s)" % old_ctx_name)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/constants.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..bf7f2ca721789052f1e227c5e3432e7712134c55
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/constants.py
@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+#: list of lorem ipsum words used by the lipsum() helper function
+LOREM_IPSUM_WORDS = u"""\
+a ac accumsan ad adipiscing aenean aliquam aliquet amet ante aptent arcu at
+auctor augue bibendum blandit class commodo condimentum congue consectetuer
+consequat conubia convallis cras cubilia cum curabitur curae cursus dapibus
+diam dictum dictumst dignissim dis dolor donec dui duis egestas eget eleifend
+elementum elit enim erat eros est et etiam eu euismod facilisi facilisis fames
+faucibus felis fermentum feugiat fringilla fusce gravida habitant habitasse hac
+hendrerit hymenaeos iaculis id imperdiet in inceptos integer interdum ipsum
+justo lacinia lacus laoreet lectus leo libero ligula litora lobortis lorem
+luctus maecenas magna magnis malesuada massa mattis mauris metus mi molestie
+mollis montes morbi mus nam nascetur natoque nec neque netus nibh nisi nisl non
+nonummy nostra nulla nullam nunc odio orci ornare parturient pede pellentesque
+penatibus per pharetra phasellus placerat platea porta porttitor posuere
+potenti praesent pretium primis proin pulvinar purus quam quis quisque rhoncus
+ridiculus risus rutrum sagittis sapien scelerisque sed sem semper senectus sit
+sociis sociosqu sodales sollicitudin suscipit suspendisse taciti tellus tempor
+tempus tincidunt torquent tortor tristique turpis ullamcorper ultrices
+ultricies urna ut varius vehicula vel velit venenatis vestibulum vitae vivamus
+viverra volutpat vulputate"""
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/debug.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/debug.py
new file mode 100644
index 0000000000000000000000000000000000000000..5d8aec31d05dab0b01b192b9dfe74f2656dc3077
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/debug.py
@@ -0,0 +1,268 @@
+import sys
+from types import CodeType
+
+from . import TemplateSyntaxError
+from ._compat import PYPY
+from .utils import internal_code
+from .utils import missing
+
+
+def rewrite_traceback_stack(source=None):
+    """Rewrite the current exception to replace any tracebacks from
+    within compiled template code with tracebacks that look like they
+    came from the template source.
+
+    This must be called within an ``except`` block.
+
+    :param exc_info: A :meth:`sys.exc_info` tuple. If not provided,
+        the current ``exc_info`` is used.
+    :param source: For ``TemplateSyntaxError``, the original source if
+        known.
+    :return: A :meth:`sys.exc_info` tuple that can be re-raised.
+    """
+    exc_type, exc_value, tb = sys.exc_info()
+
+    if isinstance(exc_value, TemplateSyntaxError) and not exc_value.translated:
+        exc_value.translated = True
+        exc_value.source = source
+
+        try:
+            # Remove the old traceback on Python 3, otherwise the frames
+            # from the compiler still show up.
+            exc_value.with_traceback(None)
+        except AttributeError:
+            pass
+
+        # Outside of runtime, so the frame isn't executing template
+        # code, but it still needs to point at the template.
+        tb = fake_traceback(
+            exc_value, None, exc_value.filename or "<unknown>", exc_value.lineno
+        )
+    else:
+        # Skip the frame for the render function.
+        tb = tb.tb_next
+
+    stack = []
+
+    # Build the stack of traceback object, replacing any in template
+    # code with the source file and line information.
+    while tb is not None:
+        # Skip frames decorated with @internalcode. These are internal
+        # calls that aren't useful in template debugging output.
+        if tb.tb_frame.f_code in internal_code:
+            tb = tb.tb_next
+            continue
+
+        template = tb.tb_frame.f_globals.get("__jinja_template__")
+
+        if template is not None:
+            lineno = template.get_corresponding_lineno(tb.tb_lineno)
+            fake_tb = fake_traceback(exc_value, tb, template.filename, lineno)
+            stack.append(fake_tb)
+        else:
+            stack.append(tb)
+
+        tb = tb.tb_next
+
+    tb_next = None
+
+    # Assign tb_next in reverse to avoid circular references.
+    for tb in reversed(stack):
+        tb_next = tb_set_next(tb, tb_next)
+
+    return exc_type, exc_value, tb_next
+
+
+def fake_traceback(exc_value, tb, filename, lineno):
+    """Produce a new traceback object that looks like it came from the
+    template source instead of the compiled code. The filename, line
+    number, and location name will point to the template, and the local
+    variables will be the current template context.
+
+    :param exc_value: The original exception to be re-raised to create
+        the new traceback.
+    :param tb: The original traceback to get the local variables and
+        code info from.
+    :param filename: The template filename.
+    :param lineno: The line number in the template source.
+    """
+    if tb is not None:
+        # Replace the real locals with the context that would be
+        # available at that point in the template.
+        locals = get_template_locals(tb.tb_frame.f_locals)
+        locals.pop("__jinja_exception__", None)
+    else:
+        locals = {}
+
+    globals = {
+        "__name__": filename,
+        "__file__": filename,
+        "__jinja_exception__": exc_value,
+    }
+    # Raise an exception at the correct line number.
+    code = compile("\n" * (lineno - 1) + "raise __jinja_exception__", filename, "exec")
+
+    # Build a new code object that points to the template file and
+    # replaces the location with a block name.
+    try:
+        location = "template"
+
+        if tb is not None:
+            function = tb.tb_frame.f_code.co_name
+
+            if function == "root":
+                location = "top-level template code"
+            elif function.startswith("block_"):
+                location = 'block "%s"' % function[6:]
+
+        # Collect arguments for the new code object. CodeType only
+        # accepts positional arguments, and arguments were inserted in
+        # new Python versions.
+        code_args = []
+
+        for attr in (
+            "argcount",
+            "posonlyargcount",  # Python 3.8
+            "kwonlyargcount",  # Python 3
+            "nlocals",
+            "stacksize",
+            "flags",
+            "code",  # codestring
+            "consts",  # constants
+            "names",
+            "varnames",
+            ("filename", filename),
+            ("name", location),
+            "firstlineno",
+            "lnotab",
+            "freevars",
+            "cellvars",
+        ):
+            if isinstance(attr, tuple):
+                # Replace with given value.
+                code_args.append(attr[1])
+                continue
+
+            try:
+                # Copy original value if it exists.
+                code_args.append(getattr(code, "co_" + attr))
+            except AttributeError:
+                # Some arguments were added later.
+                continue
+
+        code = CodeType(*code_args)
+    except Exception:
+        # Some environments such as Google App Engine don't support
+        # modifying code objects.
+        pass
+
+    # Execute the new code, which is guaranteed to raise, and return
+    # the new traceback without this frame.
+    try:
+        exec(code, globals, locals)
+    except BaseException:
+        return sys.exc_info()[2].tb_next
+
+
+def get_template_locals(real_locals):
+    """Based on the runtime locals, get the context that would be
+    available at that point in the template.
+    """
+    # Start with the current template context.
+    ctx = real_locals.get("context")
+
+    if ctx:
+        data = ctx.get_all().copy()
+    else:
+        data = {}
+
+    # Might be in a derived context that only sets local variables
+    # rather than pushing a context. Local variables follow the scheme
+    # l_depth_name. Find the highest-depth local that has a value for
+    # each name.
+    local_overrides = {}
+
+    for name, value in real_locals.items():
+        if not name.startswith("l_") or value is missing:
+            # Not a template variable, or no longer relevant.
+            continue
+
+        try:
+            _, depth, name = name.split("_", 2)
+            depth = int(depth)
+        except ValueError:
+            continue
+
+        cur_depth = local_overrides.get(name, (-1,))[0]
+
+        if cur_depth < depth:
+            local_overrides[name] = (depth, value)
+
+    # Modify the context with any derived context.
+    for name, (_, value) in local_overrides.items():
+        if value is missing:
+            data.pop(name, None)
+        else:
+            data[name] = value
+
+    return data
+
+
+if sys.version_info >= (3, 7):
+    # tb_next is directly assignable as of Python 3.7
+    def tb_set_next(tb, tb_next):
+        tb.tb_next = tb_next
+        return tb
+
+
+elif PYPY:
+    # PyPy might have special support, and won't work with ctypes.
+    try:
+        import tputil
+    except ImportError:
+        # Without tproxy support, use the original traceback.
+        def tb_set_next(tb, tb_next):
+            return tb
+
+    else:
+        # With tproxy support, create a proxy around the traceback that
+        # returns the new tb_next.
+        def tb_set_next(tb, tb_next):
+            def controller(op):
+                if op.opname == "__getattribute__" and op.args[0] == "tb_next":
+                    return tb_next
+
+                return op.delegate()
+
+            return tputil.make_proxy(controller, obj=tb)
+
+
+else:
+    # Use ctypes to assign tb_next at the C level since it's read-only
+    # from Python.
+    import ctypes
+
+    class _CTraceback(ctypes.Structure):
+        _fields_ = [
+            # Extra PyObject slots when compiled with Py_TRACE_REFS.
+            ("PyObject_HEAD", ctypes.c_byte * object().__sizeof__()),
+            # Only care about tb_next as an object, not a traceback.
+            ("tb_next", ctypes.py_object),
+        ]
+
+    def tb_set_next(tb, tb_next):
+        c_tb = _CTraceback.from_address(id(tb))
+
+        # Clear out the old tb_next.
+        if tb.tb_next is not None:
+            c_tb_next = ctypes.py_object(tb.tb_next)
+            c_tb.tb_next = ctypes.py_object()
+            ctypes.pythonapi.Py_DecRef(c_tb_next)
+
+        # Assign the new tb_next.
+        if tb_next is not None:
+            c_tb_next = ctypes.py_object(tb_next)
+            ctypes.pythonapi.Py_IncRef(c_tb_next)
+            c_tb.tb_next = c_tb_next
+
+        return tb
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/defaults.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/defaults.py
new file mode 100644
index 0000000000000000000000000000000000000000..8e0e7d771076a8fe0dc71584018338d2caa35fb5
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/defaults.py
@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+from ._compat import range_type
+from .filters import FILTERS as DEFAULT_FILTERS  # noqa: F401
+from .tests import TESTS as DEFAULT_TESTS  # noqa: F401
+from .utils import Cycler
+from .utils import generate_lorem_ipsum
+from .utils import Joiner
+from .utils import Namespace
+
+# defaults for the parser / lexer
+BLOCK_START_STRING = "{%"
+BLOCK_END_STRING = "%}"
+VARIABLE_START_STRING = "{{"
+VARIABLE_END_STRING = "}}"
+COMMENT_START_STRING = "{#"
+COMMENT_END_STRING = "#}"
+LINE_STATEMENT_PREFIX = None
+LINE_COMMENT_PREFIX = None
+TRIM_BLOCKS = False
+LSTRIP_BLOCKS = False
+NEWLINE_SEQUENCE = "\n"
+KEEP_TRAILING_NEWLINE = False
+
+# default filters, tests and namespace
+
+DEFAULT_NAMESPACE = {
+    "range": range_type,
+    "dict": dict,
+    "lipsum": generate_lorem_ipsum,
+    "cycler": Cycler,
+    "joiner": Joiner,
+    "namespace": Namespace,
+}
+
+# default policies
+DEFAULT_POLICIES = {
+    "compiler.ascii_str": True,
+    "urlize.rel": "noopener",
+    "urlize.target": None,
+    "truncate.leeway": 5,
+    "json.dumps_function": None,
+    "json.dumps_kwargs": {"sort_keys": True},
+    "ext.i18n.trimmed": False,
+}
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/environment.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/environment.py
new file mode 100644
index 0000000000000000000000000000000000000000..8430390eeab412b7f3b92d88a4bdecbe1de5f538
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/environment.py
@@ -0,0 +1,1362 @@
+# -*- coding: utf-8 -*-
+"""Classes for managing templates and their runtime and compile time
+options.
+"""
+import os
+import sys
+import weakref
+from functools import partial
+from functools import reduce
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import encode_filename
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import PYPY
+from ._compat import reraise
+from ._compat import string_types
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import generate
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import DEFAULT_FILTERS
+from .defaults import DEFAULT_NAMESPACE
+from .defaults import DEFAULT_POLICIES
+from .defaults import DEFAULT_TESTS
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .exceptions import TemplateNotFound
+from .exceptions import TemplateRuntimeError
+from .exceptions import TemplatesNotFound
+from .exceptions import TemplateSyntaxError
+from .exceptions import UndefinedError
+from .lexer import get_lexer
+from .lexer import TokenStream
+from .nodes import EvalContext
+from .parser import Parser
+from .runtime import Context
+from .runtime import new_context
+from .runtime import Undefined
+from .utils import concat
+from .utils import consume
+from .utils import have_async_gen
+from .utils import import_string
+from .utils import internalcode
+from .utils import LRUCache
+from .utils import missing
+
+# for direct template usage we have up to ten living environments
+_spontaneous_environments = LRUCache(10)
+
+
+def get_spontaneous_environment(cls, *args):
+    """Return a new spontaneous environment. A spontaneous environment
+    is used for templates created directly rather than through an
+    existing environment.
+
+    :param cls: Environment class to create.
+    :param args: Positional arguments passed to environment.
+    """
+    key = (cls, args)
+
+    try:
+        return _spontaneous_environments[key]
+    except KeyError:
+        _spontaneous_environments[key] = env = cls(*args)
+        env.shared = True
+        return env
+
+
+def create_cache(size):
+    """Return the cache class for the given size."""
+    if size == 0:
+        return None
+    if size < 0:
+        return {}
+    return LRUCache(size)
+
+
+def copy_cache(cache):
+    """Create an empty copy of the given cache."""
+    if cache is None:
+        return None
+    elif type(cache) is dict:
+        return {}
+    return LRUCache(cache.capacity)
+
+
+def load_extensions(environment, extensions):
+    """Load the extensions from the list and bind it to the environment.
+    Returns a dict of instantiated environments.
+    """
+    result = {}
+    for extension in extensions:
+        if isinstance(extension, string_types):
+            extension = import_string(extension)
+        result[extension.identifier] = extension(environment)
+    return result
+
+
+def fail_for_missing_callable(string, name):
+    msg = string % name
+    if isinstance(name, Undefined):
+        try:
+            name._fail_with_undefined_error()
+        except Exception as e:
+            msg = "%s (%s; did you forget to quote the callable name?)" % (msg, e)
+    raise TemplateRuntimeError(msg)
+
+
+def _environment_sanity_check(environment):
+    """Perform a sanity check on the environment."""
+    assert issubclass(
+        environment.undefined, Undefined
+    ), "undefined must be a subclass of undefined because filters depend on it."
+    assert (
+        environment.block_start_string
+        != environment.variable_start_string
+        != environment.comment_start_string
+    ), "block, variable and comment start strings must be different"
+    assert environment.newline_sequence in (
+        "\r",
+        "\r\n",
+        "\n",
+    ), "newline_sequence set to unknown line ending string."
+    return environment
+
+
+class Environment(object):
+    r"""The core component of Jinja is the `Environment`.  It contains
+    important shared variables like configuration, filters, tests,
+    globals and others.  Instances of this class may be modified if
+    they are not shared and if no template was loaded so far.
+    Modifications on environments after the first template was loaded
+    will lead to surprising effects and undefined behavior.
+
+    Here are the possible initialization parameters:
+
+        `block_start_string`
+            The string marking the beginning of a block.  Defaults to ``'{%'``.
+
+        `block_end_string`
+            The string marking the end of a block.  Defaults to ``'%}'``.
+
+        `variable_start_string`
+            The string marking the beginning of a print statement.
+            Defaults to ``'{{'``.
+
+        `variable_end_string`
+            The string marking the end of a print statement.  Defaults to
+            ``'}}'``.
+
+        `comment_start_string`
+            The string marking the beginning of a comment.  Defaults to ``'{#'``.
+
+        `comment_end_string`
+            The string marking the end of a comment.  Defaults to ``'#}'``.
+
+        `line_statement_prefix`
+            If given and a string, this will be used as prefix for line based
+            statements.  See also :ref:`line-statements`.
+
+        `line_comment_prefix`
+            If given and a string, this will be used as prefix for line based
+            comments.  See also :ref:`line-statements`.
+
+            .. versionadded:: 2.2
+
+        `trim_blocks`
+            If this is set to ``True`` the first newline after a block is
+            removed (block, not variable tag!).  Defaults to `False`.
+
+        `lstrip_blocks`
+            If this is set to ``True`` leading spaces and tabs are stripped
+            from the start of a line to a block.  Defaults to `False`.
+
+        `newline_sequence`
+            The sequence that starts a newline.  Must be one of ``'\r'``,
+            ``'\n'`` or ``'\r\n'``.  The default is ``'\n'`` which is a
+            useful default for Linux and OS X systems as well as web
+            applications.
+
+        `keep_trailing_newline`
+            Preserve the trailing newline when rendering templates.
+            The default is ``False``, which causes a single newline,
+            if present, to be stripped from the end of the template.
+
+            .. versionadded:: 2.7
+
+        `extensions`
+            List of Jinja extensions to use.  This can either be import paths
+            as strings or extension classes.  For more information have a
+            look at :ref:`the extensions documentation <jinja-extensions>`.
+
+        `optimized`
+            should the optimizer be enabled?  Default is ``True``.
+
+        `undefined`
+            :class:`Undefined` or a subclass of it that is used to represent
+            undefined values in the template.
+
+        `finalize`
+            A callable that can be used to process the result of a variable
+            expression before it is output.  For example one can convert
+            ``None`` implicitly into an empty string here.
+
+        `autoescape`
+            If set to ``True`` the XML/HTML autoescaping feature is enabled by
+            default.  For more details about autoescaping see
+            :class:`~markupsafe.Markup`.  As of Jinja 2.4 this can also
+            be a callable that is passed the template name and has to
+            return ``True`` or ``False`` depending on autoescape should be
+            enabled by default.
+
+            .. versionchanged:: 2.4
+               `autoescape` can now be a function
+
+        `loader`
+            The template loader for this environment.
+
+        `cache_size`
+            The size of the cache.  Per default this is ``400`` which means
+            that if more than 400 templates are loaded the loader will clean
+            out the least recently used template.  If the cache size is set to
+            ``0`` templates are recompiled all the time, if the cache size is
+            ``-1`` the cache will not be cleaned.
+
+            .. versionchanged:: 2.8
+               The cache size was increased to 400 from a low 50.
+
+        `auto_reload`
+            Some loaders load templates from locations where the template
+            sources may change (ie: file system or database).  If
+            ``auto_reload`` is set to ``True`` (default) every time a template is
+            requested the loader checks if the source changed and if yes, it
+            will reload the template.  For higher performance it's possible to
+            disable that.
+
+        `bytecode_cache`
+            If set to a bytecode cache object, this object will provide a
+            cache for the internal Jinja bytecode so that templates don't
+            have to be parsed if they were not changed.
+
+            See :ref:`bytecode-cache` for more information.
+
+        `enable_async`
+            If set to true this enables async template execution which allows
+            you to take advantage of newer Python features.  This requires
+            Python 3.6 or later.
+    """
+
+    #: if this environment is sandboxed.  Modifying this variable won't make
+    #: the environment sandboxed though.  For a real sandboxed environment
+    #: have a look at jinja2.sandbox.  This flag alone controls the code
+    #: generation by the compiler.
+    sandboxed = False
+
+    #: True if the environment is just an overlay
+    overlayed = False
+
+    #: the environment this environment is linked to if it is an overlay
+    linked_to = None
+
+    #: shared environments have this set to `True`.  A shared environment
+    #: must not be modified
+    shared = False
+
+    #: the class that is used for code generation.  See
+    #: :class:`~jinja2.compiler.CodeGenerator` for more information.
+    code_generator_class = CodeGenerator
+
+    #: the context class thatis used for templates.  See
+    #: :class:`~jinja2.runtime.Context` for more information.
+    context_class = Context
+
+    def __init__(
+        self,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        loader=None,
+        cache_size=400,
+        auto_reload=True,
+        bytecode_cache=None,
+        enable_async=False,
+    ):
+        # !!Important notice!!
+        #   The constructor accepts quite a few arguments that should be
+        #   passed by keyword rather than position.  However it's important to
+        #   not change the order of arguments because it's used at least
+        #   internally in those cases:
+        #       -   spontaneous environments (i18n extension and Template)
+        #       -   unittests
+        #   If parameter changes are required only add parameters at the end
+        #   and don't change the arguments (or the defaults!) of the arguments
+        #   existing already.
+
+        # lexer / parser information
+        self.block_start_string = block_start_string
+        self.block_end_string = block_end_string
+        self.variable_start_string = variable_start_string
+        self.variable_end_string = variable_end_string
+        self.comment_start_string = comment_start_string
+        self.comment_end_string = comment_end_string
+        self.line_statement_prefix = line_statement_prefix
+        self.line_comment_prefix = line_comment_prefix
+        self.trim_blocks = trim_blocks
+        self.lstrip_blocks = lstrip_blocks
+        self.newline_sequence = newline_sequence
+        self.keep_trailing_newline = keep_trailing_newline
+
+        # runtime information
+        self.undefined = undefined
+        self.optimized = optimized
+        self.finalize = finalize
+        self.autoescape = autoescape
+
+        # defaults
+        self.filters = DEFAULT_FILTERS.copy()
+        self.tests = DEFAULT_TESTS.copy()
+        self.globals = DEFAULT_NAMESPACE.copy()
+
+        # set the loader provided
+        self.loader = loader
+        self.cache = create_cache(cache_size)
+        self.bytecode_cache = bytecode_cache
+        self.auto_reload = auto_reload
+
+        # configurable policies
+        self.policies = DEFAULT_POLICIES.copy()
+
+        # load extensions
+        self.extensions = load_extensions(self, extensions)
+
+        self.enable_async = enable_async
+        self.is_async = self.enable_async and have_async_gen
+        if self.is_async:
+            # runs patch_all() to enable async support
+            from . import asyncsupport  # noqa: F401
+
+        _environment_sanity_check(self)
+
+    def add_extension(self, extension):
+        """Adds an extension after the environment was created.
+
+        .. versionadded:: 2.5
+        """
+        self.extensions.update(load_extensions(self, [extension]))
+
+    def extend(self, **attributes):
+        """Add the items to the instance of the environment if they do not exist
+        yet.  This is used by :ref:`extensions <writing-extensions>` to register
+        callbacks and configuration values without breaking inheritance.
+        """
+        for key, value in iteritems(attributes):
+            if not hasattr(self, key):
+                setattr(self, key, value)
+
+    def overlay(
+        self,
+        block_start_string=missing,
+        block_end_string=missing,
+        variable_start_string=missing,
+        variable_end_string=missing,
+        comment_start_string=missing,
+        comment_end_string=missing,
+        line_statement_prefix=missing,
+        line_comment_prefix=missing,
+        trim_blocks=missing,
+        lstrip_blocks=missing,
+        extensions=missing,
+        optimized=missing,
+        undefined=missing,
+        finalize=missing,
+        autoescape=missing,
+        loader=missing,
+        cache_size=missing,
+        auto_reload=missing,
+        bytecode_cache=missing,
+    ):
+        """Create a new overlay environment that shares all the data with the
+        current environment except for cache and the overridden attributes.
+        Extensions cannot be removed for an overlayed environment.  An overlayed
+        environment automatically gets all the extensions of the environment it
+        is linked to plus optional extra extensions.
+
+        Creating overlays should happen after the initial environment was set
+        up completely.  Not all attributes are truly linked, some are just
+        copied over so modifications on the original environment may not shine
+        through.
+        """
+        args = dict(locals())
+        del args["self"], args["cache_size"], args["extensions"]
+
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.overlayed = True
+        rv.linked_to = self
+
+        for key, value in iteritems(args):
+            if value is not missing:
+                setattr(rv, key, value)
+
+        if cache_size is not missing:
+            rv.cache = create_cache(cache_size)
+        else:
+            rv.cache = copy_cache(self.cache)
+
+        rv.extensions = {}
+        for key, value in iteritems(self.extensions):
+            rv.extensions[key] = value.bind(rv)
+        if extensions is not missing:
+            rv.extensions.update(load_extensions(rv, extensions))
+
+        return _environment_sanity_check(rv)
+
+    lexer = property(get_lexer, doc="The lexer for this environment.")
+
+    def iter_extensions(self):
+        """Iterates over the extensions by priority."""
+        return iter(sorted(self.extensions.values(), key=lambda x: x.priority))
+
+    def getitem(self, obj, argument):
+        """Get an item or attribute of an object but prefer the item."""
+        try:
+            return obj[argument]
+        except (AttributeError, TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        return getattr(obj, attr)
+                    except AttributeError:
+                        pass
+            return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Get an item or attribute of an object but prefer the attribute.
+        Unlike :meth:`getitem` the attribute *must* be a bytestring.
+        """
+        try:
+            return getattr(obj, attribute)
+        except AttributeError:
+            pass
+        try:
+            return obj[attribute]
+        except (TypeError, LookupError, AttributeError):
+            return self.undefined(obj=obj, name=attribute)
+
+    def call_filter(
+        self, name, value, args=None, kwargs=None, context=None, eval_ctx=None
+    ):
+        """Invokes a filter on a value the same way the compiler does it.
+
+        Note that on Python 3 this might return a coroutine in case the
+        filter is running from an environment in async mode and the filter
+        supports async execution.  It's your responsibility to await this
+        if needed.
+
+        .. versionadded:: 2.7
+        """
+        func = self.filters.get(name)
+        if func is None:
+            fail_for_missing_callable("no filter named %r", name)
+        args = [value] + list(args or ())
+        if getattr(func, "contextfilter", False) is True:
+            if context is None:
+                raise TemplateRuntimeError(
+                    "Attempted to invoke context filter without context"
+                )
+            args.insert(0, context)
+        elif getattr(func, "evalcontextfilter", False) is True:
+            if eval_ctx is None:
+                if context is not None:
+                    eval_ctx = context.eval_ctx
+                else:
+                    eval_ctx = EvalContext(self)
+            args.insert(0, eval_ctx)
+        elif getattr(func, "environmentfilter", False) is True:
+            args.insert(0, self)
+        return func(*args, **(kwargs or {}))
+
+    def call_test(self, name, value, args=None, kwargs=None):
+        """Invokes a test on a value the same way the compiler does it.
+
+        .. versionadded:: 2.7
+        """
+        func = self.tests.get(name)
+        if func is None:
+            fail_for_missing_callable("no test named %r", name)
+        return func(value, *(args or ()), **(kwargs or {}))
+
+    @internalcode
+    def parse(self, source, name=None, filename=None):
+        """Parse the sourcecode and return the abstract syntax tree.  This
+        tree of nodes is used by the compiler to convert the template into
+        executable source- or bytecode.  This is useful for debugging or to
+        extract information from templates.
+
+        If you are :ref:`developing Jinja extensions <writing-extensions>`
+        this gives you a good overview of the node tree generated.
+        """
+        try:
+            return self._parse(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def _parse(self, source, name, filename):
+        """Internal parsing function used by `parse` and `compile`."""
+        return Parser(self, source, name, encode_filename(filename)).parse()
+
+    def lex(self, source, name=None, filename=None):
+        """Lex the given sourcecode and return a generator that yields
+        tokens as tuples in the form ``(lineno, token_type, value)``.
+        This can be useful for :ref:`extension development <writing-extensions>`
+        and debugging templates.
+
+        This does not perform preprocessing.  If you want the preprocessing
+        of the extensions to be applied you have to filter source through
+        the :meth:`preprocess` method.
+        """
+        source = text_type(source)
+        try:
+            return self.lexer.tokeniter(source, name, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source)
+
+    def preprocess(self, source, name=None, filename=None):
+        """Preprocesses the source with all extensions.  This is automatically
+        called for all parsing and compiling methods but *not* for :meth:`lex`
+        because there you usually only want the actual source tokenized.
+        """
+        return reduce(
+            lambda s, e: e.preprocess(s, name, filename),
+            self.iter_extensions(),
+            text_type(source),
+        )
+
+    def _tokenize(self, source, name, filename=None, state=None):
+        """Called by the parser to do the preprocessing and filtering
+        for all the extensions.  Returns a :class:`~jinja2.lexer.TokenStream`.
+        """
+        source = self.preprocess(source, name, filename)
+        stream = self.lexer.tokenize(source, name, filename, state)
+        for ext in self.iter_extensions():
+            stream = ext.filter_stream(stream)
+            if not isinstance(stream, TokenStream):
+                stream = TokenStream(stream, name, filename)
+        return stream
+
+    def _generate(self, source, name, filename, defer_init=False):
+        """Internal hook that can be overridden to hook a different generate
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return generate(
+            source,
+            self,
+            name,
+            filename,
+            defer_init=defer_init,
+            optimized=self.optimized,
+        )
+
+    def _compile(self, source, filename):
+        """Internal hook that can be overridden to hook a different compile
+        method in.
+
+        .. versionadded:: 2.5
+        """
+        return compile(source, filename, "exec")
+
+    @internalcode
+    def compile(self, source, name=None, filename=None, raw=False, defer_init=False):
+        """Compile a node or template source code.  The `name` parameter is
+        the load name of the template after it was joined using
+        :meth:`join_path` if necessary, not the filename on the file system.
+        the `filename` parameter is the estimated filename of the template on
+        the file system.  If the template came from a database or memory this
+        can be omitted.
+
+        The return value of this method is a python code object.  If the `raw`
+        parameter is `True` the return value will be a string with python
+        code equivalent to the bytecode returned otherwise.  This method is
+        mainly used internally.
+
+        `defer_init` is use internally to aid the module code generator.  This
+        causes the generated code to be able to import without the global
+        environment variable to be set.
+
+        .. versionadded:: 2.4
+           `defer_init` parameter added.
+        """
+        source_hint = None
+        try:
+            if isinstance(source, string_types):
+                source_hint = source
+                source = self._parse(source, name, filename)
+            source = self._generate(source, name, filename, defer_init=defer_init)
+            if raw:
+                return source
+            if filename is None:
+                filename = "<template>"
+            else:
+                filename = encode_filename(filename)
+            return self._compile(source, filename)
+        except TemplateSyntaxError:
+            self.handle_exception(source=source_hint)
+
+    def compile_expression(self, source, undefined_to_none=True):
+        """A handy helper method that returns a callable that accepts keyword
+        arguments that appear as variables in the expression.  If called it
+        returns the result of the expression.
+
+        This is useful if applications want to use the same rules as Jinja
+        in template "configuration files" or similar situations.
+
+        Example usage:
+
+        >>> env = Environment()
+        >>> expr = env.compile_expression('foo == 42')
+        >>> expr(foo=23)
+        False
+        >>> expr(foo=42)
+        True
+
+        Per default the return value is converted to `None` if the
+        expression returns an undefined value.  This can be changed
+        by setting `undefined_to_none` to `False`.
+
+        >>> env.compile_expression('var')() is None
+        True
+        >>> env.compile_expression('var', undefined_to_none=False)()
+        Undefined
+
+        .. versionadded:: 2.1
+        """
+        parser = Parser(self, source, state="variable")
+        try:
+            expr = parser.parse_expression()
+            if not parser.stream.eos:
+                raise TemplateSyntaxError(
+                    "chunk after expression", parser.stream.current.lineno, None, None
+                )
+            expr.set_environment(self)
+        except TemplateSyntaxError:
+            if sys.exc_info() is not None:
+                self.handle_exception(source=source)
+
+        body = [nodes.Assign(nodes.Name("result", "store"), expr, lineno=1)]
+        template = self.from_string(nodes.Template(body, lineno=1))
+        return TemplateExpression(template, undefined_to_none)
+
+    def compile_templates(
+        self,
+        target,
+        extensions=None,
+        filter_func=None,
+        zip="deflated",
+        log_function=None,
+        ignore_errors=True,
+        py_compile=False,
+    ):
+        """Finds all the templates the loader can find, compiles them
+        and stores them in `target`.  If `zip` is `None`, instead of in a
+        zipfile, the templates will be stored in a directory.
+        By default a deflate zip algorithm is used. To switch to
+        the stored algorithm, `zip` can be set to ``'stored'``.
+
+        `extensions` and `filter_func` are passed to :meth:`list_templates`.
+        Each template returned will be compiled to the target folder or
+        zipfile.
+
+        By default template compilation errors are ignored.  In case a
+        log function is provided, errors are logged.  If you want template
+        syntax errors to abort the compilation you can set `ignore_errors`
+        to `False` and you will get an exception on syntax errors.
+
+        If `py_compile` is set to `True` .pyc files will be written to the
+        target instead of standard .py files.  This flag does not do anything
+        on pypy and Python 3 where pyc files are not picked up by itself and
+        don't give much benefit.
+
+        .. versionadded:: 2.4
+        """
+        from .loaders import ModuleLoader
+
+        if log_function is None:
+
+            def log_function(x):
+                pass
+
+        if py_compile:
+            if not PY2 or PYPY:
+                import warnings
+
+                warnings.warn(
+                    "'py_compile=True' has no effect on PyPy or Python"
+                    " 3 and will be removed in version 3.0",
+                    DeprecationWarning,
+                    stacklevel=2,
+                )
+                py_compile = False
+            else:
+                import imp
+                import marshal
+
+                py_header = imp.get_magic() + u"\xff\xff\xff\xff".encode("iso-8859-15")
+
+                # Python 3.3 added a source filesize to the header
+                if sys.version_info >= (3, 3):
+                    py_header += u"\x00\x00\x00\x00".encode("iso-8859-15")
+
+        def write_file(filename, data):
+            if zip:
+                info = ZipInfo(filename)
+                info.external_attr = 0o755 << 16
+                zip_file.writestr(info, data)
+            else:
+                if isinstance(data, text_type):
+                    data = data.encode("utf8")
+
+                with open(os.path.join(target, filename), "wb") as f:
+                    f.write(data)
+
+        if zip is not None:
+            from zipfile import ZipFile, ZipInfo, ZIP_DEFLATED, ZIP_STORED
+
+            zip_file = ZipFile(
+                target, "w", dict(deflated=ZIP_DEFLATED, stored=ZIP_STORED)[zip]
+            )
+            log_function('Compiling into Zip archive "%s"' % target)
+        else:
+            if not os.path.isdir(target):
+                os.makedirs(target)
+            log_function('Compiling into folder "%s"' % target)
+
+        try:
+            for name in self.list_templates(extensions, filter_func):
+                source, filename, _ = self.loader.get_source(self, name)
+                try:
+                    code = self.compile(source, name, filename, True, True)
+                except TemplateSyntaxError as e:
+                    if not ignore_errors:
+                        raise
+                    log_function('Could not compile "%s": %s' % (name, e))
+                    continue
+
+                filename = ModuleLoader.get_module_filename(name)
+
+                if py_compile:
+                    c = self._compile(code, encode_filename(filename))
+                    write_file(filename + "c", py_header + marshal.dumps(c))
+                    log_function('Byte-compiled "%s" as %s' % (name, filename + "c"))
+                else:
+                    write_file(filename, code)
+                    log_function('Compiled "%s" as %s' % (name, filename))
+        finally:
+            if zip:
+                zip_file.close()
+
+        log_function("Finished compiling templates")
+
+    def list_templates(self, extensions=None, filter_func=None):
+        """Returns a list of templates for this environment.  This requires
+        that the loader supports the loader's
+        :meth:`~BaseLoader.list_templates` method.
+
+        If there are other files in the template folder besides the
+        actual templates, the returned list can be filtered.  There are two
+        ways: either `extensions` is set to a list of file extensions for
+        templates, or a `filter_func` can be provided which is a callable that
+        is passed a template name and should return `True` if it should end up
+        in the result list.
+
+        If the loader does not support that, a :exc:`TypeError` is raised.
+
+        .. versionadded:: 2.4
+        """
+        names = self.loader.list_templates()
+
+        if extensions is not None:
+            if filter_func is not None:
+                raise TypeError(
+                    "either extensions or filter_func can be passed, but not both"
+                )
+
+            def filter_func(x):
+                return "." in x and x.rsplit(".", 1)[1] in extensions
+
+        if filter_func is not None:
+            names = [name for name in names if filter_func(name)]
+
+        return names
+
+    def handle_exception(self, source=None):
+        """Exception handling helper.  This is used internally to either raise
+        rewritten exceptions or return a rendered traceback for the template.
+        """
+        from .debug import rewrite_traceback_stack
+
+        reraise(*rewrite_traceback_stack(source=source))
+
+    def join_path(self, template, parent):
+        """Join a template with the parent.  By default all the lookups are
+        relative to the loader root so this method returns the `template`
+        parameter unchanged, but if the paths should be relative to the
+        parent template, this function can be used to calculate the real
+        template name.
+
+        Subclasses may override this method and implement template path
+        joining here.
+        """
+        return template
+
+    @internalcode
+    def _load_template(self, name, globals):
+        if self.loader is None:
+            raise TypeError("no loader for this environment specified")
+        cache_key = (weakref.ref(self.loader), name)
+        if self.cache is not None:
+            template = self.cache.get(cache_key)
+            if template is not None and (
+                not self.auto_reload or template.is_up_to_date
+            ):
+                return template
+        template = self.loader.load(self, name, globals)
+        if self.cache is not None:
+            self.cache[cache_key] = template
+        return template
+
+    @internalcode
+    def get_template(self, name, parent=None, globals=None):
+        """Load a template from the loader.  If a loader is configured this
+        method asks the loader for the template and returns a :class:`Template`.
+        If the `parent` parameter is not `None`, :meth:`join_path` is called
+        to get the real template name before loading.
+
+        The `globals` parameter can be used to provide template wide globals.
+        These variables are available in the context at render time.
+
+        If the template does not exist a :exc:`TemplateNotFound` exception is
+        raised.
+
+        .. versionchanged:: 2.4
+           If `name` is a :class:`Template` object it is returned from the
+           function unchanged.
+        """
+        if isinstance(name, Template):
+            return name
+        if parent is not None:
+            name = self.join_path(name, parent)
+        return self._load_template(name, self.make_globals(globals))
+
+    @internalcode
+    def select_template(self, names, parent=None, globals=None):
+        """Works like :meth:`get_template` but tries a number of templates
+        before it fails.  If it cannot find any of the templates, it will
+        raise a :exc:`TemplatesNotFound` exception.
+
+        .. versionchanged:: 2.11
+            If names is :class:`Undefined`, an :exc:`UndefinedError` is
+            raised instead. If no templates were found and names
+            contains :class:`Undefined`, the message is more helpful.
+
+        .. versionchanged:: 2.4
+           If `names` contains a :class:`Template` object it is returned
+           from the function unchanged.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(names, Undefined):
+            names._fail_with_undefined_error()
+
+        if not names:
+            raise TemplatesNotFound(
+                message=u"Tried to select from an empty list " u"of templates."
+            )
+        globals = self.make_globals(globals)
+        for name in names:
+            if isinstance(name, Template):
+                return name
+            if parent is not None:
+                name = self.join_path(name, parent)
+            try:
+                return self._load_template(name, globals)
+            except (TemplateNotFound, UndefinedError):
+                pass
+        raise TemplatesNotFound(names)
+
+    @internalcode
+    def get_or_select_template(self, template_name_or_list, parent=None, globals=None):
+        """Does a typecheck and dispatches to :meth:`select_template`
+        if an iterable of template names is given, otherwise to
+        :meth:`get_template`.
+
+        .. versionadded:: 2.3
+        """
+        if isinstance(template_name_or_list, (string_types, Undefined)):
+            return self.get_template(template_name_or_list, parent, globals)
+        elif isinstance(template_name_or_list, Template):
+            return template_name_or_list
+        return self.select_template(template_name_or_list, parent, globals)
+
+    def from_string(self, source, globals=None, template_class=None):
+        """Load a template from a string.  This parses the source given and
+        returns a :class:`Template` object.
+        """
+        globals = self.make_globals(globals)
+        cls = template_class or self.template_class
+        return cls.from_code(self, self.compile(source), globals, None)
+
+    def make_globals(self, d):
+        """Return a dict for the globals."""
+        if not d:
+            return self.globals
+        return dict(self.globals, **d)
+
+
+class Template(object):
+    """The central template object.  This class represents a compiled template
+    and is used to evaluate it.
+
+    Normally the template object is generated from an :class:`Environment` but
+    it also has a constructor that makes it possible to create a template
+    instance directly using the constructor.  It takes the same arguments as
+    the environment constructor but it's not possible to specify a loader.
+
+    Every template object has a few methods and members that are guaranteed
+    to exist.  However it's important that a template object should be
+    considered immutable.  Modifications on the object are not supported.
+
+    Template objects created from the constructor rather than an environment
+    do have an `environment` attribute that points to a temporary environment
+    that is probably shared with other templates created with the constructor
+    and compatible settings.
+
+    >>> template = Template('Hello {{ name }}!')
+    >>> template.render(name='John Doe') == u'Hello John Doe!'
+    True
+    >>> stream = template.stream(name='John Doe')
+    >>> next(stream) == u'Hello John Doe!'
+    True
+    >>> next(stream)
+    Traceback (most recent call last):
+        ...
+    StopIteration
+    """
+
+    #: Type of environment to create when creating a template directly
+    #: rather than through an existing environment.
+    environment_class = Environment
+
+    def __new__(
+        cls,
+        source,
+        block_start_string=BLOCK_START_STRING,
+        block_end_string=BLOCK_END_STRING,
+        variable_start_string=VARIABLE_START_STRING,
+        variable_end_string=VARIABLE_END_STRING,
+        comment_start_string=COMMENT_START_STRING,
+        comment_end_string=COMMENT_END_STRING,
+        line_statement_prefix=LINE_STATEMENT_PREFIX,
+        line_comment_prefix=LINE_COMMENT_PREFIX,
+        trim_blocks=TRIM_BLOCKS,
+        lstrip_blocks=LSTRIP_BLOCKS,
+        newline_sequence=NEWLINE_SEQUENCE,
+        keep_trailing_newline=KEEP_TRAILING_NEWLINE,
+        extensions=(),
+        optimized=True,
+        undefined=Undefined,
+        finalize=None,
+        autoescape=False,
+        enable_async=False,
+    ):
+        env = get_spontaneous_environment(
+            cls.environment_class,
+            block_start_string,
+            block_end_string,
+            variable_start_string,
+            variable_end_string,
+            comment_start_string,
+            comment_end_string,
+            line_statement_prefix,
+            line_comment_prefix,
+            trim_blocks,
+            lstrip_blocks,
+            newline_sequence,
+            keep_trailing_newline,
+            frozenset(extensions),
+            optimized,
+            undefined,
+            finalize,
+            autoescape,
+            None,
+            0,
+            False,
+            None,
+            enable_async,
+        )
+        return env.from_string(source, template_class=cls)
+
+    @classmethod
+    def from_code(cls, environment, code, globals, uptodate=None):
+        """Creates a template object from compiled code and the globals.  This
+        is used by the loaders and environment to create a template object.
+        """
+        namespace = {"environment": environment, "__file__": code.co_filename}
+        exec(code, namespace)
+        rv = cls._from_namespace(environment, namespace, globals)
+        rv._uptodate = uptodate
+        return rv
+
+    @classmethod
+    def from_module_dict(cls, environment, module_dict, globals):
+        """Creates a template object from a module.  This is used by the
+        module loader to create a template object.
+
+        .. versionadded:: 2.4
+        """
+        return cls._from_namespace(environment, module_dict, globals)
+
+    @classmethod
+    def _from_namespace(cls, environment, namespace, globals):
+        t = object.__new__(cls)
+        t.environment = environment
+        t.globals = globals
+        t.name = namespace["name"]
+        t.filename = namespace["__file__"]
+        t.blocks = namespace["blocks"]
+
+        # render function and module
+        t.root_render_func = namespace["root"]
+        t._module = None
+
+        # debug and loader helpers
+        t._debug_info = namespace["debug_info"]
+        t._uptodate = None
+
+        # store the reference
+        namespace["environment"] = environment
+        namespace["__jinja_template__"] = t
+
+        return t
+
+    def render(self, *args, **kwargs):
+        """This method accepts the same arguments as the `dict` constructor:
+        A dict, a dict subclass or some keyword arguments.  If no arguments
+        are given the context will be empty.  These two calls do the same::
+
+            template.render(knights='that say nih')
+            template.render({'knights': 'that say nih'})
+
+        This will return the rendered template as unicode string.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            return concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            self.environment.handle_exception()
+
+    def render_async(self, *args, **kwargs):
+        """This works similar to :meth:`render` but returns a coroutine
+        that when awaited returns the entire rendered template string.  This
+        requires the async feature to be enabled.
+
+        Example usage::
+
+            await template.render_async(knights='that say nih; asynchronously')
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def stream(self, *args, **kwargs):
+        """Works exactly like :meth:`generate` but returns a
+        :class:`TemplateStream`.
+        """
+        return TemplateStream(self.generate(*args, **kwargs))
+
+    def generate(self, *args, **kwargs):
+        """For very large templates it can be useful to not render the whole
+        template at once but evaluate each statement after another and yield
+        piece for piece.  This method basically does exactly that and returns
+        a generator that yields one item after another as unicode strings.
+
+        It accepts the same arguments as :meth:`render`.
+        """
+        vars = dict(*args, **kwargs)
+        try:
+            for event in self.root_render_func(self.new_context(vars)):
+                yield event
+        except Exception:
+            yield self.environment.handle_exception()
+
+    def generate_async(self, *args, **kwargs):
+        """An async version of :meth:`generate`.  Works very similarly but
+        returns an async iterator instead.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    def new_context(self, vars=None, shared=False, locals=None):
+        """Create a new :class:`Context` for this template.  The vars
+        provided will be passed to the template.  Per default the globals
+        are added to the context.  If shared is set to `True` the data
+        is passed as is to the context without adding the globals.
+
+        `locals` can be a dict of local variables for internal usage.
+        """
+        return new_context(
+            self.environment, self.name, self.blocks, vars, shared, self.globals, locals
+        )
+
+    def make_module(self, vars=None, shared=False, locals=None):
+        """This method works like the :attr:`module` attribute when called
+        without arguments but it will evaluate the template on every call
+        rather than caching it.  It's also possible to provide
+        a dict which is then used as context.  The arguments are the same
+        as for the :meth:`new_context` method.
+        """
+        return TemplateModule(self, self.new_context(vars, shared, locals))
+
+    def make_module_async(self, vars=None, shared=False, locals=None):
+        """As template module creation can invoke template code for
+        asynchronous executions this method must be used instead of the
+        normal :meth:`make_module` one.  Likewise the module attribute
+        becomes unavailable in async mode.
+        """
+        # see asyncsupport for the actual implementation
+        raise NotImplementedError(
+            "This feature is not available for this version of Python"
+        )
+
+    @internalcode
+    def _get_default_module(self):
+        if self._module is not None:
+            return self._module
+        self._module = rv = self.make_module()
+        return rv
+
+    @property
+    def module(self):
+        """The template as module.  This is used for imports in the
+        template runtime but is also useful if one wants to access
+        exported template variables from the Python layer:
+
+        >>> t = Template('{% macro foo() %}42{% endmacro %}23')
+        >>> str(t.module)
+        '23'
+        >>> t.module.foo() == u'42'
+        True
+
+        This attribute is not available if async mode is enabled.
+        """
+        return self._get_default_module()
+
+    def get_corresponding_lineno(self, lineno):
+        """Return the source line number of a line number in the
+        generated bytecode as they are not in sync.
+        """
+        for template_line, code_line in reversed(self.debug_info):
+            if code_line <= lineno:
+                return template_line
+        return 1
+
+    @property
+    def is_up_to_date(self):
+        """If this variable is `False` there is a newer version available."""
+        if self._uptodate is None:
+            return True
+        return self._uptodate()
+
+    @property
+    def debug_info(self):
+        """The debug info mapping."""
+        if self._debug_info:
+            return [tuple(map(int, x.split("="))) for x in self._debug_info.split("&")]
+        return []
+
+    def __repr__(self):
+        if self.name is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.name)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+@implements_to_string
+class TemplateModule(object):
+    """Represents an imported template.  All the exported names of the
+    template are available as attributes on this object.  Additionally
+    converting it into an unicode- or bytestrings renders the contents.
+    """
+
+    def __init__(self, template, context, body_stream=None):
+        if body_stream is None:
+            if context.environment.is_async:
+                raise RuntimeError(
+                    "Async mode requires a body stream "
+                    "to be passed to a template module.  Use "
+                    "the async methods of the API you are "
+                    "using."
+                )
+            body_stream = list(template.root_render_func(context))
+        self._body_stream = body_stream
+        self.__dict__.update(context.get_exported())
+        self.__name__ = template.name
+
+    def __html__(self):
+        return Markup(concat(self._body_stream))
+
+    def __str__(self):
+        return concat(self._body_stream)
+
+    def __repr__(self):
+        if self.__name__ is None:
+            name = "memory:%x" % id(self)
+        else:
+            name = repr(self.__name__)
+        return "<%s %s>" % (self.__class__.__name__, name)
+
+
+class TemplateExpression(object):
+    """The :meth:`jinja2.Environment.compile_expression` method returns an
+    instance of this object.  It encapsulates the expression-like access
+    to the template with an expression it wraps.
+    """
+
+    def __init__(self, template, undefined_to_none):
+        self._template = template
+        self._undefined_to_none = undefined_to_none
+
+    def __call__(self, *args, **kwargs):
+        context = self._template.new_context(dict(*args, **kwargs))
+        consume(self._template.root_render_func(context))
+        rv = context.vars["result"]
+        if self._undefined_to_none and isinstance(rv, Undefined):
+            rv = None
+        return rv
+
+
+@implements_iterator
+class TemplateStream(object):
+    """A template stream works pretty much like an ordinary python generator
+    but it can buffer multiple items to reduce the number of total iterations.
+    Per default the output is unbuffered which means that for every unbuffered
+    instruction in the template one unicode string is yielded.
+
+    If buffering is enabled with a buffer size of 5, five items are combined
+    into a new unicode string.  This is mainly useful if you are streaming
+    big templates to a client via WSGI which flushes after each iteration.
+    """
+
+    def __init__(self, gen):
+        self._gen = gen
+        self.disable_buffering()
+
+    def dump(self, fp, encoding=None, errors="strict"):
+        """Dump the complete stream into a file or file-like object.
+        Per default unicode strings are written, if you want to encode
+        before writing specify an `encoding`.
+
+        Example usage::
+
+            Template('Hello {{ name }}!').stream(name='foo').dump('hello.html')
+        """
+        close = False
+        if isinstance(fp, string_types):
+            if encoding is None:
+                encoding = "utf-8"
+            fp = open(fp, "wb")
+            close = True
+        try:
+            if encoding is not None:
+                iterable = (x.encode(encoding, errors) for x in self)
+            else:
+                iterable = self
+            if hasattr(fp, "writelines"):
+                fp.writelines(iterable)
+            else:
+                for item in iterable:
+                    fp.write(item)
+        finally:
+            if close:
+                fp.close()
+
+    def disable_buffering(self):
+        """Disable the output buffering."""
+        self._next = partial(next, self._gen)
+        self.buffered = False
+
+    def _buffered_generator(self, size):
+        buf = []
+        c_size = 0
+        push = buf.append
+
+        while 1:
+            try:
+                while c_size < size:
+                    c = next(self._gen)
+                    push(c)
+                    if c:
+                        c_size += 1
+            except StopIteration:
+                if not c_size:
+                    return
+            yield concat(buf)
+            del buf[:]
+            c_size = 0
+
+    def enable_buffering(self, size=5):
+        """Enable buffering.  Buffer `size` items before yielding them."""
+        if size <= 1:
+            raise ValueError("buffer size too small")
+
+        self.buffered = True
+        self._next = partial(next, self._buffered_generator(size))
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        return self._next()
+
+
+# hook in default template class.  if anyone reads this comment: ignore that
+# it's possible to use custom templates ;-)
+Environment.template_class = Template
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/exceptions.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/exceptions.py
new file mode 100644
index 0000000000000000000000000000000000000000..0bf2003e30e2a24a54640359bb04f3e98b26e3f6
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/exceptions.py
@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+from ._compat import imap
+from ._compat import implements_to_string
+from ._compat import PY2
+from ._compat import text_type
+
+
+class TemplateError(Exception):
+    """Baseclass for all template errors."""
+
+    if PY2:
+
+        def __init__(self, message=None):
+            if message is not None:
+                message = text_type(message).encode("utf-8")
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message.decode("utf-8", "replace")
+
+        def __unicode__(self):
+            return self.message or u""
+
+    else:
+
+        def __init__(self, message=None):
+            Exception.__init__(self, message)
+
+        @property
+        def message(self):
+            if self.args:
+                message = self.args[0]
+                if message is not None:
+                    return message
+
+
+@implements_to_string
+class TemplateNotFound(IOError, LookupError, TemplateError):
+    """Raised if a template does not exist.
+
+    .. versionchanged:: 2.11
+        If the given name is :class:`Undefined` and no message was
+        provided, an :exc:`UndefinedError` is raised.
+    """
+
+    # looks weird, but removes the warning descriptor that just
+    # bogusly warns us about message being deprecated
+    message = None
+
+    def __init__(self, name, message=None):
+        IOError.__init__(self, name)
+
+        if message is None:
+            from .runtime import Undefined
+
+            if isinstance(name, Undefined):
+                name._fail_with_undefined_error()
+
+            message = name
+
+        self.message = message
+        self.name = name
+        self.templates = [name]
+
+    def __str__(self):
+        return self.message
+
+
+class TemplatesNotFound(TemplateNotFound):
+    """Like :class:`TemplateNotFound` but raised if multiple templates
+    are selected.  This is a subclass of :class:`TemplateNotFound`
+    exception, so just catching the base exception will catch both.
+
+    .. versionchanged:: 2.11
+        If a name in the list of names is :class:`Undefined`, a message
+        about it being undefined is shown rather than the empty string.
+
+    .. versionadded:: 2.2
+    """
+
+    def __init__(self, names=(), message=None):
+        if message is None:
+            from .runtime import Undefined
+
+            parts = []
+
+            for name in names:
+                if isinstance(name, Undefined):
+                    parts.append(name._undefined_message)
+                else:
+                    parts.append(name)
+
+            message = u"none of the templates given were found: " + u", ".join(
+                imap(text_type, parts)
+            )
+        TemplateNotFound.__init__(self, names and names[-1] or None, message)
+        self.templates = list(names)
+
+
+@implements_to_string
+class TemplateSyntaxError(TemplateError):
+    """Raised to tell the user that there is a problem with the template."""
+
+    def __init__(self, message, lineno, name=None, filename=None):
+        TemplateError.__init__(self, message)
+        self.lineno = lineno
+        self.name = name
+        self.filename = filename
+        self.source = None
+
+        # this is set to True if the debug.translate_syntax_error
+        # function translated the syntax error into a new traceback
+        self.translated = False
+
+    def __str__(self):
+        # for translated errors we only return the message
+        if self.translated:
+            return self.message
+
+        # otherwise attach some stuff
+        location = "line %d" % self.lineno
+        name = self.filename or self.name
+        if name:
+            location = 'File "%s", %s' % (name, location)
+        lines = [self.message, "  " + location]
+
+        # if the source is set, add the line to the output
+        if self.source is not None:
+            try:
+                line = self.source.splitlines()[self.lineno - 1]
+            except IndexError:
+                line = None
+            if line:
+                lines.append("    " + line.strip())
+
+        return u"\n".join(lines)
+
+    def __reduce__(self):
+        # https://bugs.python.org/issue1692335 Exceptions that take
+        # multiple required arguments have problems with pickling.
+        # Without this, raises TypeError: __init__() missing 1 required
+        # positional argument: 'lineno'
+        return self.__class__, (self.message, self.lineno, self.name, self.filename)
+
+
+class TemplateAssertionError(TemplateSyntaxError):
+    """Like a template syntax error, but covers cases where something in the
+    template caused an error at compile time that wasn't necessarily caused
+    by a syntax error.  However it's a direct subclass of
+    :exc:`TemplateSyntaxError` and has the same attributes.
+    """
+
+
+class TemplateRuntimeError(TemplateError):
+    """A generic runtime error in the template engine.  Under some situations
+    Jinja may raise this exception.
+    """
+
+
+class UndefinedError(TemplateRuntimeError):
+    """Raised if a template tries to operate on :class:`Undefined`."""
+
+
+class SecurityError(TemplateRuntimeError):
+    """Raised if a template tries to do something insecure if the
+    sandbox is enabled.
+    """
+
+
+class FilterArgumentError(TemplateRuntimeError):
+    """This error is raised if a filter was called with inappropriate
+    arguments
+    """
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/ext.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/ext.py
new file mode 100644
index 0000000000000000000000000000000000000000..9141be4dace15919a68c09ffbd5f96923224f09a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/ext.py
@@ -0,0 +1,704 @@
+# -*- coding: utf-8 -*-
+"""Extension API for adding custom tags and behavior."""
+import pprint
+import re
+from sys import version_info
+
+from markupsafe import Markup
+
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import with_metaclass
+from .defaults import BLOCK_END_STRING
+from .defaults import BLOCK_START_STRING
+from .defaults import COMMENT_END_STRING
+from .defaults import COMMENT_START_STRING
+from .defaults import KEEP_TRAILING_NEWLINE
+from .defaults import LINE_COMMENT_PREFIX
+from .defaults import LINE_STATEMENT_PREFIX
+from .defaults import LSTRIP_BLOCKS
+from .defaults import NEWLINE_SEQUENCE
+from .defaults import TRIM_BLOCKS
+from .defaults import VARIABLE_END_STRING
+from .defaults import VARIABLE_START_STRING
+from .environment import Environment
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .nodes import ContextReference
+from .runtime import concat
+from .utils import contextfunction
+from .utils import import_string
+
+# the only real useful gettext functions for a Jinja template.  Note
+# that ugettext must be assigned to gettext as Jinja doesn't support
+# non unicode strings.
+GETTEXT_FUNCTIONS = ("_", "gettext", "ngettext")
+
+_ws_re = re.compile(r"\s*\n\s*")
+
+
+class ExtensionRegistry(type):
+    """Gives the extension an unique identifier."""
+
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        rv.identifier = rv.__module__ + "." + rv.__name__
+        return rv
+
+
+class Extension(with_metaclass(ExtensionRegistry, object)):
+    """Extensions can be used to add extra functionality to the Jinja template
+    system at the parser level.  Custom extensions are bound to an environment
+    but may not store environment specific data on `self`.  The reason for
+    this is that an extension can be bound to another environment (for
+    overlays) by creating a copy and reassigning the `environment` attribute.
+
+    As extensions are created by the environment they cannot accept any
+    arguments for configuration.  One may want to work around that by using
+    a factory function, but that is not possible as extensions are identified
+    by their import name.  The correct way to configure the extension is
+    storing the configuration values on the environment.  Because this way the
+    environment ends up acting as central configuration storage the
+    attributes may clash which is why extensions have to ensure that the names
+    they choose for configuration are not too generic.  ``prefix`` for example
+    is a terrible name, ``fragment_cache_prefix`` on the other hand is a good
+    name as includes the name of the extension (fragment cache).
+    """
+
+    #: if this extension parses this is the list of tags it's listening to.
+    tags = set()
+
+    #: the priority of that extension.  This is especially useful for
+    #: extensions that preprocess values.  A lower value means higher
+    #: priority.
+    #:
+    #: .. versionadded:: 2.4
+    priority = 100
+
+    def __init__(self, environment):
+        self.environment = environment
+
+    def bind(self, environment):
+        """Create a copy of this extension bound to another environment."""
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.environment = environment
+        return rv
+
+    def preprocess(self, source, name, filename=None):
+        """This method is called before the actual lexing and can be used to
+        preprocess the source.  The `filename` is optional.  The return value
+        must be the preprocessed source.
+        """
+        return source
+
+    def filter_stream(self, stream):
+        """It's passed a :class:`~jinja2.lexer.TokenStream` that can be used
+        to filter tokens returned.  This method has to return an iterable of
+        :class:`~jinja2.lexer.Token`\\s, but it doesn't have to return a
+        :class:`~jinja2.lexer.TokenStream`.
+        """
+        return stream
+
+    def parse(self, parser):
+        """If any of the :attr:`tags` matched this method is called with the
+        parser as first argument.  The token the parser stream is pointing at
+        is the name token that matched.  This method has to return one or a
+        list of multiple nodes.
+        """
+        raise NotImplementedError()
+
+    def attr(self, name, lineno=None):
+        """Return an attribute node for the current extension.  This is useful
+        to pass constants on extensions to generated template code.
+
+        ::
+
+            self.attr('_my_attribute', lineno=lineno)
+        """
+        return nodes.ExtensionAttribute(self.identifier, name, lineno=lineno)
+
+    def call_method(
+        self, name, args=None, kwargs=None, dyn_args=None, dyn_kwargs=None, lineno=None
+    ):
+        """Call a method of the extension.  This is a shortcut for
+        :meth:`attr` + :class:`jinja2.nodes.Call`.
+        """
+        if args is None:
+            args = []
+        if kwargs is None:
+            kwargs = []
+        return nodes.Call(
+            self.attr(name, lineno=lineno),
+            args,
+            kwargs,
+            dyn_args,
+            dyn_kwargs,
+            lineno=lineno,
+        )
+
+
+@contextfunction
+def _gettext_alias(__context, *args, **kwargs):
+    return __context.call(__context.resolve("gettext"), *args, **kwargs)
+
+
+def _make_new_gettext(func):
+    @contextfunction
+    def gettext(__context, __string, **variables):
+        rv = __context.call(func, __string)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, even if there are no
+        # variables. This makes translation strings more consistent
+        # and predictable. This requires escaping
+        return rv % variables
+
+    return gettext
+
+
+def _make_new_ngettext(func):
+    @contextfunction
+    def ngettext(__context, __singular, __plural, __num, **variables):
+        variables.setdefault("num", __num)
+        rv = __context.call(func, __singular, __plural, __num)
+        if __context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        # Always treat as a format string, see gettext comment above.
+        return rv % variables
+
+    return ngettext
+
+
+class InternationalizationExtension(Extension):
+    """This extension adds gettext support to Jinja."""
+
+    tags = {"trans"}
+
+    # TODO: the i18n extension is currently reevaluating values in a few
+    # situations.  Take this example:
+    #   {% trans count=something() %}{{ count }} foo{% pluralize
+    #     %}{{ count }} fooss{% endtrans %}
+    # something is called twice here.  One time for the gettext value and
+    # the other time for the n-parameter of the ngettext function.
+
+    def __init__(self, environment):
+        Extension.__init__(self, environment)
+        environment.globals["_"] = _gettext_alias
+        environment.extend(
+            install_gettext_translations=self._install,
+            install_null_translations=self._install_null,
+            install_gettext_callables=self._install_callables,
+            uninstall_gettext_translations=self._uninstall,
+            extract_translations=self._extract,
+            newstyle_gettext=False,
+        )
+
+    def _install(self, translations, newstyle=None):
+        gettext = getattr(translations, "ugettext", None)
+        if gettext is None:
+            gettext = translations.gettext
+        ngettext = getattr(translations, "ungettext", None)
+        if ngettext is None:
+            ngettext = translations.ngettext
+        self._install_callables(gettext, ngettext, newstyle)
+
+    def _install_null(self, newstyle=None):
+        self._install_callables(
+            lambda x: x, lambda s, p, n: (n != 1 and (p,) or (s,))[0], newstyle
+        )
+
+    def _install_callables(self, gettext, ngettext, newstyle=None):
+        if newstyle is not None:
+            self.environment.newstyle_gettext = newstyle
+        if self.environment.newstyle_gettext:
+            gettext = _make_new_gettext(gettext)
+            ngettext = _make_new_ngettext(ngettext)
+        self.environment.globals.update(gettext=gettext, ngettext=ngettext)
+
+    def _uninstall(self, translations):
+        for key in "gettext", "ngettext":
+            self.environment.globals.pop(key, None)
+
+    def _extract(self, source, gettext_functions=GETTEXT_FUNCTIONS):
+        if isinstance(source, string_types):
+            source = self.environment.parse(source)
+        return extract_from_ast(source, gettext_functions)
+
+    def parse(self, parser):
+        """Parse a translatable tag."""
+        lineno = next(parser.stream).lineno
+        num_called_num = False
+
+        # find all the variables referenced.  Additionally a variable can be
+        # defined in the body of the trans block too, but this is checked at
+        # a later state.
+        plural_expr = None
+        plural_expr_assignment = None
+        variables = {}
+        trimmed = None
+        while parser.stream.current.type != "block_end":
+            if variables:
+                parser.stream.expect("comma")
+
+            # skip colon for python compatibility
+            if parser.stream.skip_if("colon"):
+                break
+
+            name = parser.stream.expect("name")
+            if name.value in variables:
+                parser.fail(
+                    "translatable variable %r defined twice." % name.value,
+                    name.lineno,
+                    exc=TemplateAssertionError,
+                )
+
+            # expressions
+            if parser.stream.current.type == "assign":
+                next(parser.stream)
+                variables[name.value] = var = parser.parse_expression()
+            elif trimmed is None and name.value in ("trimmed", "notrimmed"):
+                trimmed = name.value == "trimmed"
+                continue
+            else:
+                variables[name.value] = var = nodes.Name(name.value, "load")
+
+            if plural_expr is None:
+                if isinstance(var, nodes.Call):
+                    plural_expr = nodes.Name("_trans", "load")
+                    variables[name.value] = plural_expr
+                    plural_expr_assignment = nodes.Assign(
+                        nodes.Name("_trans", "store"), var
+                    )
+                else:
+                    plural_expr = var
+                num_called_num = name.value == "num"
+
+        parser.stream.expect("block_end")
+
+        plural = None
+        have_plural = False
+        referenced = set()
+
+        # now parse until endtrans or pluralize
+        singular_names, singular = self._parse_block(parser, True)
+        if singular_names:
+            referenced.update(singular_names)
+            if plural_expr is None:
+                plural_expr = nodes.Name(singular_names[0], "load")
+                num_called_num = singular_names[0] == "num"
+
+        # if we have a pluralize block, we parse that too
+        if parser.stream.current.test("name:pluralize"):
+            have_plural = True
+            next(parser.stream)
+            if parser.stream.current.type != "block_end":
+                name = parser.stream.expect("name")
+                if name.value not in variables:
+                    parser.fail(
+                        "unknown variable %r for pluralization" % name.value,
+                        name.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                plural_expr = variables[name.value]
+                num_called_num = name.value == "num"
+            parser.stream.expect("block_end")
+            plural_names, plural = self._parse_block(parser, False)
+            next(parser.stream)
+            referenced.update(plural_names)
+        else:
+            next(parser.stream)
+
+        # register free names as simple name expressions
+        for var in referenced:
+            if var not in variables:
+                variables[var] = nodes.Name(var, "load")
+
+        if not have_plural:
+            plural_expr = None
+        elif plural_expr is None:
+            parser.fail("pluralize without variables", lineno)
+
+        if trimmed is None:
+            trimmed = self.environment.policies["ext.i18n.trimmed"]
+        if trimmed:
+            singular = self._trim_whitespace(singular)
+            if plural:
+                plural = self._trim_whitespace(plural)
+
+        node = self._make_node(
+            singular,
+            plural,
+            variables,
+            plural_expr,
+            bool(referenced),
+            num_called_num and have_plural,
+        )
+        node.set_lineno(lineno)
+        if plural_expr_assignment is not None:
+            return [plural_expr_assignment, node]
+        else:
+            return node
+
+    def _trim_whitespace(self, string, _ws_re=_ws_re):
+        return _ws_re.sub(" ", string.strip())
+
+    def _parse_block(self, parser, allow_pluralize):
+        """Parse until the next block tag with a given name."""
+        referenced = []
+        buf = []
+        while 1:
+            if parser.stream.current.type == "data":
+                buf.append(parser.stream.current.value.replace("%", "%%"))
+                next(parser.stream)
+            elif parser.stream.current.type == "variable_begin":
+                next(parser.stream)
+                name = parser.stream.expect("name").value
+                referenced.append(name)
+                buf.append("%%(%s)s" % name)
+                parser.stream.expect("variable_end")
+            elif parser.stream.current.type == "block_begin":
+                next(parser.stream)
+                if parser.stream.current.test("name:endtrans"):
+                    break
+                elif parser.stream.current.test("name:pluralize"):
+                    if allow_pluralize:
+                        break
+                    parser.fail(
+                        "a translatable section can have only one pluralize section"
+                    )
+                parser.fail(
+                    "control structures in translatable sections are not allowed"
+                )
+            elif parser.stream.eos:
+                parser.fail("unclosed translation block")
+            else:
+                raise RuntimeError("internal parser error")
+
+        return referenced, concat(buf)
+
+    def _make_node(
+        self, singular, plural, variables, plural_expr, vars_referenced, num_called_num
+    ):
+        """Generates a useful node from the data provided."""
+        # no variables referenced?  no need to escape for old style
+        # gettext invocations only if there are vars.
+        if not vars_referenced and not self.environment.newstyle_gettext:
+            singular = singular.replace("%%", "%")
+            if plural:
+                plural = plural.replace("%%", "%")
+
+        # singular only:
+        if plural_expr is None:
+            gettext = nodes.Name("gettext", "load")
+            node = nodes.Call(gettext, [nodes.Const(singular)], [], None, None)
+
+        # singular and plural
+        else:
+            ngettext = nodes.Name("ngettext", "load")
+            node = nodes.Call(
+                ngettext,
+                [nodes.Const(singular), nodes.Const(plural), plural_expr],
+                [],
+                None,
+                None,
+            )
+
+        # in case newstyle gettext is used, the method is powerful
+        # enough to handle the variable expansion and autoescape
+        # handling itself
+        if self.environment.newstyle_gettext:
+            for key, value in iteritems(variables):
+                # the function adds that later anyways in case num was
+                # called num, so just skip it.
+                if num_called_num and key == "num":
+                    continue
+                node.kwargs.append(nodes.Keyword(key, value))
+
+        # otherwise do that here
+        else:
+            # mark the return value as safe if we are in an
+            # environment with autoescaping turned on
+            node = nodes.MarkSafeIfAutoescape(node)
+            if variables:
+                node = nodes.Mod(
+                    node,
+                    nodes.Dict(
+                        [
+                            nodes.Pair(nodes.Const(key), value)
+                            for key, value in variables.items()
+                        ]
+                    ),
+                )
+        return nodes.Output([node])
+
+
+class ExprStmtExtension(Extension):
+    """Adds a `do` tag to Jinja that works like the print statement just
+    that it doesn't print the return value.
+    """
+
+    tags = set(["do"])
+
+    def parse(self, parser):
+        node = nodes.ExprStmt(lineno=next(parser.stream).lineno)
+        node.node = parser.parse_tuple()
+        return node
+
+
+class LoopControlExtension(Extension):
+    """Adds break and continue to the template engine."""
+
+    tags = set(["break", "continue"])
+
+    def parse(self, parser):
+        token = next(parser.stream)
+        if token.value == "break":
+            return nodes.Break(lineno=token.lineno)
+        return nodes.Continue(lineno=token.lineno)
+
+
+class WithExtension(Extension):
+    pass
+
+
+class AutoEscapeExtension(Extension):
+    pass
+
+
+class DebugExtension(Extension):
+    """A ``{% debug %}`` tag that dumps the available variables,
+    filters, and tests.
+
+    .. code-block:: html+jinja
+
+        <pre>{% debug %}</pre>
+
+    .. code-block:: text
+
+        {'context': {'cycler': <class 'jinja2.utils.Cycler'>,
+                     ...,
+                     'namespace': <class 'jinja2.utils.Namespace'>},
+         'filters': ['abs', 'attr', 'batch', 'capitalize', 'center', 'count', 'd',
+                     ..., 'urlencode', 'urlize', 'wordcount', 'wordwrap', 'xmlattr'],
+         'tests': ['!=', '<', '<=', '==', '>', '>=', 'callable', 'defined',
+                   ..., 'odd', 'sameas', 'sequence', 'string', 'undefined', 'upper']}
+
+    .. versionadded:: 2.11.0
+    """
+
+    tags = {"debug"}
+
+    def parse(self, parser):
+        lineno = parser.stream.expect("name:debug").lineno
+        context = ContextReference()
+        result = self.call_method("_render", [context], lineno=lineno)
+        return nodes.Output([result], lineno=lineno)
+
+    def _render(self, context):
+        result = {
+            "context": context.get_all(),
+            "filters": sorted(self.environment.filters.keys()),
+            "tests": sorted(self.environment.tests.keys()),
+        }
+
+        # Set the depth since the intent is to show the top few names.
+        if version_info[:2] >= (3, 4):
+            return pprint.pformat(result, depth=3, compact=True)
+        else:
+            return pprint.pformat(result, depth=3)
+
+
+def extract_from_ast(node, gettext_functions=GETTEXT_FUNCTIONS, babel_style=True):
+    """Extract localizable strings from the given template node.  Per
+    default this function returns matches in babel style that means non string
+    parameters as well as keyword arguments are returned as `None`.  This
+    allows Babel to figure out what you really meant if you are using
+    gettext functions that allow keyword arguments for placeholder expansion.
+    If you don't want that behavior set the `babel_style` parameter to `False`
+    which causes only strings to be returned and parameters are always stored
+    in tuples.  As a consequence invalid gettext calls (calls without a single
+    string parameter or string parameters after non-string parameters) are
+    skipped.
+
+    This example explains the behavior:
+
+    >>> from jinja2 import Environment
+    >>> env = Environment()
+    >>> node = env.parse('{{ (_("foo"), _(), ngettext("foo", "bar", 42)) }}')
+    >>> list(extract_from_ast(node))
+    [(1, '_', 'foo'), (1, '_', ()), (1, 'ngettext', ('foo', 'bar', None))]
+    >>> list(extract_from_ast(node, babel_style=False))
+    [(1, '_', ('foo',)), (1, 'ngettext', ('foo', 'bar'))]
+
+    For every string found this function yields a ``(lineno, function,
+    message)`` tuple, where:
+
+    * ``lineno`` is the number of the line on which the string was found,
+    * ``function`` is the name of the ``gettext`` function used (if the
+      string was extracted from embedded Python code), and
+    *  ``message`` is the string itself (a ``unicode`` object, or a tuple
+       of ``unicode`` objects for functions with multiple string arguments).
+
+    This extraction function operates on the AST and is because of that unable
+    to extract any comments.  For comment support you have to use the babel
+    extraction interface or extract comments yourself.
+    """
+    for node in node.find_all(nodes.Call):
+        if (
+            not isinstance(node.node, nodes.Name)
+            or node.node.name not in gettext_functions
+        ):
+            continue
+
+        strings = []
+        for arg in node.args:
+            if isinstance(arg, nodes.Const) and isinstance(arg.value, string_types):
+                strings.append(arg.value)
+            else:
+                strings.append(None)
+
+        for _ in node.kwargs:
+            strings.append(None)
+        if node.dyn_args is not None:
+            strings.append(None)
+        if node.dyn_kwargs is not None:
+            strings.append(None)
+
+        if not babel_style:
+            strings = tuple(x for x in strings if x is not None)
+            if not strings:
+                continue
+        else:
+            if len(strings) == 1:
+                strings = strings[0]
+            else:
+                strings = tuple(strings)
+        yield node.lineno, node.node.name, strings
+
+
+class _CommentFinder(object):
+    """Helper class to find comments in a token stream.  Can only
+    find comments for gettext calls forwards.  Once the comment
+    from line 4 is found, a comment for line 1 will not return a
+    usable value.
+    """
+
+    def __init__(self, tokens, comment_tags):
+        self.tokens = tokens
+        self.comment_tags = comment_tags
+        self.offset = 0
+        self.last_lineno = 0
+
+    def find_backwards(self, offset):
+        try:
+            for _, token_type, token_value in reversed(
+                self.tokens[self.offset : offset]
+            ):
+                if token_type in ("comment", "linecomment"):
+                    try:
+                        prefix, comment = token_value.split(None, 1)
+                    except ValueError:
+                        continue
+                    if prefix in self.comment_tags:
+                        return [comment.rstrip()]
+            return []
+        finally:
+            self.offset = offset
+
+    def find_comments(self, lineno):
+        if not self.comment_tags or self.last_lineno > lineno:
+            return []
+        for idx, (token_lineno, _, _) in enumerate(self.tokens[self.offset :]):
+            if token_lineno > lineno:
+                return self.find_backwards(self.offset + idx)
+        return self.find_backwards(len(self.tokens))
+
+
+def babel_extract(fileobj, keywords, comment_tags, options):
+    """Babel extraction method for Jinja templates.
+
+    .. versionchanged:: 2.3
+       Basic support for translation comments was added.  If `comment_tags`
+       is now set to a list of keywords for extraction, the extractor will
+       try to find the best preceding comment that begins with one of the
+       keywords.  For best results, make sure to not have more than one
+       gettext call in one line of code and the matching comment in the
+       same line or the line before.
+
+    .. versionchanged:: 2.5.1
+       The `newstyle_gettext` flag can be set to `True` to enable newstyle
+       gettext calls.
+
+    .. versionchanged:: 2.7
+       A `silent` option can now be provided.  If set to `False` template
+       syntax errors are propagated instead of being ignored.
+
+    :param fileobj: the file-like object the messages should be extracted from
+    :param keywords: a list of keywords (i.e. function names) that should be
+                     recognized as translation functions
+    :param comment_tags: a list of translator tags to search for and include
+                         in the results.
+    :param options: a dictionary of additional options (optional)
+    :return: an iterator over ``(lineno, funcname, message, comments)`` tuples.
+             (comments will be empty currently)
+    """
+    extensions = set()
+    for extension in options.get("extensions", "").split(","):
+        extension = extension.strip()
+        if not extension:
+            continue
+        extensions.add(import_string(extension))
+    if InternationalizationExtension not in extensions:
+        extensions.add(InternationalizationExtension)
+
+    def getbool(options, key, default=False):
+        return options.get(key, str(default)).lower() in ("1", "on", "yes", "true")
+
+    silent = getbool(options, "silent", True)
+    environment = Environment(
+        options.get("block_start_string", BLOCK_START_STRING),
+        options.get("block_end_string", BLOCK_END_STRING),
+        options.get("variable_start_string", VARIABLE_START_STRING),
+        options.get("variable_end_string", VARIABLE_END_STRING),
+        options.get("comment_start_string", COMMENT_START_STRING),
+        options.get("comment_end_string", COMMENT_END_STRING),
+        options.get("line_statement_prefix") or LINE_STATEMENT_PREFIX,
+        options.get("line_comment_prefix") or LINE_COMMENT_PREFIX,
+        getbool(options, "trim_blocks", TRIM_BLOCKS),
+        getbool(options, "lstrip_blocks", LSTRIP_BLOCKS),
+        NEWLINE_SEQUENCE,
+        getbool(options, "keep_trailing_newline", KEEP_TRAILING_NEWLINE),
+        frozenset(extensions),
+        cache_size=0,
+        auto_reload=False,
+    )
+
+    if getbool(options, "trimmed"):
+        environment.policies["ext.i18n.trimmed"] = True
+    if getbool(options, "newstyle_gettext"):
+        environment.newstyle_gettext = True
+
+    source = fileobj.read().decode(options.get("encoding", "utf-8"))
+    try:
+        node = environment.parse(source)
+        tokens = list(environment.lex(environment.preprocess(source)))
+    except TemplateSyntaxError:
+        if not silent:
+            raise
+        # skip templates with syntax errors
+        return
+
+    finder = _CommentFinder(tokens, comment_tags)
+    for lineno, func, message in extract_from_ast(node, keywords):
+        yield lineno, func, message, finder.find_comments(lineno)
+
+
+#: nicer import names
+i18n = InternationalizationExtension
+do = ExprStmtExtension
+loopcontrols = LoopControlExtension
+with_ = WithExtension
+autoescape = AutoEscapeExtension
+debug = DebugExtension
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/filters.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/filters.py
new file mode 100644
index 0000000000000000000000000000000000000000..974156735123b88ed996997cf18e2db03bc3c7be
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/filters.py
@@ -0,0 +1,1382 @@
+# -*- coding: utf-8 -*-
+"""Built-in template filters used with the ``|`` operator."""
+import math
+import random
+import re
+import warnings
+from collections import namedtuple
+from itertools import chain
+from itertools import groupby
+
+from markupsafe import escape
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import iteritems
+from ._compat import string_types
+from ._compat import text_type
+from .exceptions import FilterArgumentError
+from .runtime import Undefined
+from .utils import htmlsafe_json_dumps
+from .utils import pformat
+from .utils import unicode_urlencode
+from .utils import urlize
+
+_word_re = re.compile(r"\w+", re.UNICODE)
+_word_beginning_split_re = re.compile(r"([-\s\(\{\[\<]+)", re.UNICODE)
+
+
+def contextfilter(f):
+    """Decorator for marking context dependent filters. The current
+    :class:`Context` will be passed as first argument.
+    """
+    f.contextfilter = True
+    return f
+
+
+def evalcontextfilter(f):
+    """Decorator for marking eval-context dependent filters.  An eval
+    context object is passed as first argument.  For more information
+    about the eval context, see :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfilter = True
+    return f
+
+
+def environmentfilter(f):
+    """Decorator for marking environment dependent filters.  The current
+    :class:`Environment` is passed to the filter as first argument.
+    """
+    f.environmentfilter = True
+    return f
+
+
+def ignore_case(value):
+    """For use as a postprocessor for :func:`make_attrgetter`. Converts strings
+    to lowercase and returns other types as-is."""
+    return value.lower() if isinstance(value, string_types) else value
+
+
+def make_attrgetter(environment, attribute, postprocess=None, default=None):
+    """Returns a callable that looks up the given attribute from a
+    passed object with the rules of the environment.  Dots are allowed
+    to access attributes of attributes.  Integer parts in paths are
+    looked up as integers.
+    """
+    attribute = _prepare_attribute_parts(attribute)
+
+    def attrgetter(item):
+        for part in attribute:
+            item = environment.getitem(item, part)
+
+            if default and isinstance(item, Undefined):
+                item = default
+
+        if postprocess is not None:
+            item = postprocess(item)
+
+        return item
+
+    return attrgetter
+
+
+def make_multi_attrgetter(environment, attribute, postprocess=None):
+    """Returns a callable that looks up the given comma separated
+    attributes from a passed object with the rules of the environment.
+    Dots are allowed to access attributes of each attribute.  Integer
+    parts in paths are looked up as integers.
+
+    The value returned by the returned callable is a list of extracted
+    attribute values.
+
+    Examples of attribute: "attr1,attr2", "attr1.inner1.0,attr2.inner2.0", etc.
+    """
+    attribute_parts = (
+        attribute.split(",") if isinstance(attribute, string_types) else [attribute]
+    )
+    attribute = [
+        _prepare_attribute_parts(attribute_part) for attribute_part in attribute_parts
+    ]
+
+    def attrgetter(item):
+        items = [None] * len(attribute)
+        for i, attribute_part in enumerate(attribute):
+            item_i = item
+            for part in attribute_part:
+                item_i = environment.getitem(item_i, part)
+
+            if postprocess is not None:
+                item_i = postprocess(item_i)
+
+            items[i] = item_i
+        return items
+
+    return attrgetter
+
+
+def _prepare_attribute_parts(attr):
+    if attr is None:
+        return []
+    elif isinstance(attr, string_types):
+        return [int(x) if x.isdigit() else x for x in attr.split(".")]
+    else:
+        return [attr]
+
+
+def do_forceescape(value):
+    """Enforce HTML escaping.  This will probably double escape variables."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return escape(text_type(value))
+
+
+def do_urlencode(value):
+    """Quote data for use in a URL path or query using UTF-8.
+
+    Basic wrapper around :func:`urllib.parse.quote` when given a
+    string, or :func:`urllib.parse.urlencode` for a dict or iterable.
+
+    :param value: Data to quote. A string will be quoted directly. A
+        dict or iterable of ``(key, value)`` pairs will be joined as a
+        query string.
+
+    When given a string, "/" is not quoted. HTTP servers treat "/" and
+    "%2F" equivalently in paths. If you need quoted slashes, use the
+    ``|replace("/", "%2F")`` filter.
+
+    .. versionadded:: 2.7
+    """
+    if isinstance(value, string_types) or not isinstance(value, abc.Iterable):
+        return unicode_urlencode(value)
+
+    if isinstance(value, dict):
+        items = iteritems(value)
+    else:
+        items = iter(value)
+
+    return u"&".join(
+        "%s=%s" % (unicode_urlencode(k, for_qs=True), unicode_urlencode(v, for_qs=True))
+        for k, v in items
+    )
+
+
+@evalcontextfilter
+def do_replace(eval_ctx, s, old, new, count=None):
+    """Return a copy of the value with all occurrences of a substring
+    replaced with a new one. The first argument is the substring
+    that should be replaced, the second is the replacement string.
+    If the optional third argument ``count`` is given, only the first
+    ``count`` occurrences are replaced:
+
+    .. sourcecode:: jinja
+
+        {{ "Hello World"|replace("Hello", "Goodbye") }}
+            -> Goodbye World
+
+        {{ "aaaaargh"|replace("a", "d'oh, ", 2) }}
+            -> d'oh, d'oh, aaargh
+    """
+    if count is None:
+        count = -1
+    if not eval_ctx.autoescape:
+        return text_type(s).replace(text_type(old), text_type(new), count)
+    if (
+        hasattr(old, "__html__")
+        or hasattr(new, "__html__")
+        and not hasattr(s, "__html__")
+    ):
+        s = escape(s)
+    else:
+        s = soft_unicode(s)
+    return s.replace(soft_unicode(old), soft_unicode(new), count)
+
+
+def do_upper(s):
+    """Convert a value to uppercase."""
+    return soft_unicode(s).upper()
+
+
+def do_lower(s):
+    """Convert a value to lowercase."""
+    return soft_unicode(s).lower()
+
+
+@evalcontextfilter
+def do_xmlattr(_eval_ctx, d, autospace=True):
+    """Create an SGML/XML attribute string based on the items in a dict.
+    All values that are neither `none` nor `undefined` are automatically
+    escaped:
+
+    .. sourcecode:: html+jinja
+
+        <ul{{ {'class': 'my_list', 'missing': none,
+                'id': 'list-%d'|format(variable)}|xmlattr }}>
+        ...
+        </ul>
+
+    Results in something like this:
+
+    .. sourcecode:: html
+
+        <ul class="my_list" id="list-42">
+        ...
+        </ul>
+
+    As you can see it automatically prepends a space in front of the item
+    if the filter returned something unless the second parameter is false.
+    """
+    rv = u" ".join(
+        u'%s="%s"' % (escape(key), escape(value))
+        for key, value in iteritems(d)
+        if value is not None and not isinstance(value, Undefined)
+    )
+    if autospace and rv:
+        rv = u" " + rv
+    if _eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_capitalize(s):
+    """Capitalize a value. The first character will be uppercase, all others
+    lowercase.
+    """
+    return soft_unicode(s).capitalize()
+
+
+def do_title(s):
+    """Return a titlecased version of the value. I.e. words will start with
+    uppercase letters, all remaining characters are lowercase.
+    """
+    return "".join(
+        [
+            item[0].upper() + item[1:].lower()
+            for item in _word_beginning_split_re.split(soft_unicode(s))
+            if item
+        ]
+    )
+
+
+def do_dictsort(value, case_sensitive=False, by="key", reverse=False):
+    """Sort a dict and yield (key, value) pairs. Because python dicts are
+    unsorted you may want to use this function to order them by either
+    key or value:
+
+    .. sourcecode:: jinja
+
+        {% for item in mydict|dictsort %}
+            sort the dict by key, case insensitive
+
+        {% for item in mydict|dictsort(reverse=true) %}
+            sort the dict by key, case insensitive, reverse order
+
+        {% for item in mydict|dictsort(true) %}
+            sort the dict by key, case sensitive
+
+        {% for item in mydict|dictsort(false, 'value') %}
+            sort the dict by value, case insensitive
+    """
+    if by == "key":
+        pos = 0
+    elif by == "value":
+        pos = 1
+    else:
+        raise FilterArgumentError('You can only sort by either "key" or "value"')
+
+    def sort_func(item):
+        value = item[pos]
+
+        if not case_sensitive:
+            value = ignore_case(value)
+
+        return value
+
+    return sorted(value.items(), key=sort_func, reverse=reverse)
+
+
+@environmentfilter
+def do_sort(environment, value, reverse=False, case_sensitive=False, attribute=None):
+    """Sort an iterable using Python's :func:`sorted`.
+
+    .. sourcecode:: jinja
+
+        {% for city in cities|sort %}
+            ...
+        {% endfor %}
+
+    :param reverse: Sort descending instead of ascending.
+    :param case_sensitive: When sorting strings, sort upper and lower
+        case separately.
+    :param attribute: When sorting objects or dicts, an attribute or
+        key to sort by. Can use dot notation like ``"address.city"``.
+        Can be a list of attributes like ``"age,name"``.
+
+    The sort is stable, it does not change the relative order of
+    elements that compare equal. This makes it is possible to chain
+    sorts on different attributes and ordering.
+
+    .. sourcecode:: jinja
+
+        {% for user in users|sort(attribute="name")
+            |sort(reverse=true, attribute="age") %}
+            ...
+        {% endfor %}
+
+    As a shortcut to chaining when the direction is the same for all
+    attributes, pass a comma separate list of attributes.
+
+    .. sourcecode:: jinja
+
+        {% for user users|sort(attribute="age,name") %}
+            ...
+        {% endfor %}
+
+    .. versionchanged:: 2.11.0
+        The ``attribute`` parameter can be a comma separated list of
+        attributes, e.g. ``"age,name"``.
+
+    .. versionchanged:: 2.6
+       The ``attribute`` parameter was added.
+    """
+    key_func = make_multi_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return sorted(value, key=key_func, reverse=reverse)
+
+
+@environmentfilter
+def do_unique(environment, value, case_sensitive=False, attribute=None):
+    """Returns a list of unique items from the given iterable.
+
+    .. sourcecode:: jinja
+
+        {{ ['foo', 'bar', 'foobar', 'FooBar']|unique|list }}
+            -> ['foo', 'bar', 'foobar']
+
+    The unique items are yielded in the same order as their first occurrence in
+    the iterable passed to the filter.
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Filter objects with unique values for this attribute.
+    """
+    getter = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    seen = set()
+
+    for item in value:
+        key = getter(item)
+
+        if key not in seen:
+            seen.add(key)
+            yield item
+
+
+def _min_or_max(environment, value, func, case_sensitive, attribute):
+    it = iter(value)
+
+    try:
+        first = next(it)
+    except StopIteration:
+        return environment.undefined("No aggregated item, sequence was empty.")
+
+    key_func = make_attrgetter(
+        environment, attribute, postprocess=ignore_case if not case_sensitive else None
+    )
+    return func(chain([first], it), key=key_func)
+
+
+@environmentfilter
+def do_min(environment, value, case_sensitive=False, attribute=None):
+    """Return the smallest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|min }}
+            -> 1
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the min value of this attribute.
+    """
+    return _min_or_max(environment, value, min, case_sensitive, attribute)
+
+
+@environmentfilter
+def do_max(environment, value, case_sensitive=False, attribute=None):
+    """Return the largest item from the sequence.
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|max }}
+            -> 3
+
+    :param case_sensitive: Treat upper and lower case strings as distinct.
+    :param attribute: Get the object with the max value of this attribute.
+    """
+    return _min_or_max(environment, value, max, case_sensitive, attribute)
+
+
+def do_default(value, default_value=u"", boolean=False):
+    """If the value is undefined it will return the passed default value,
+    otherwise the value of the variable:
+
+    .. sourcecode:: jinja
+
+        {{ my_variable|default('my_variable is not defined') }}
+
+    This will output the value of ``my_variable`` if the variable was
+    defined, otherwise ``'my_variable is not defined'``. If you want
+    to use default with variables that evaluate to false you have to
+    set the second parameter to `true`:
+
+    .. sourcecode:: jinja
+
+        {{ ''|default('the string was empty', true) }}
+
+    .. versionchanged:: 2.11
+       It's now possible to configure the :class:`~jinja2.Environment` with
+       :class:`~jinja2.ChainableUndefined` to make the `default` filter work
+       on nested elements and attributes that may contain undefined values
+       in the chain without getting an :exc:`~jinja2.UndefinedError`.
+    """
+    if isinstance(value, Undefined) or (boolean and not value):
+        return default_value
+    return value
+
+
+@evalcontextfilter
+def do_join(eval_ctx, value, d=u"", attribute=None):
+    """Return a string which is the concatenation of the strings in the
+    sequence. The separator between elements is an empty string per
+    default, you can define it with the optional parameter:
+
+    .. sourcecode:: jinja
+
+        {{ [1, 2, 3]|join('|') }}
+            -> 1|2|3
+
+        {{ [1, 2, 3]|join }}
+            -> 123
+
+    It is also possible to join certain attributes of an object:
+
+    .. sourcecode:: jinja
+
+        {{ users|join(', ', attribute='username') }}
+
+    .. versionadded:: 2.6
+       The `attribute` parameter was added.
+    """
+    if attribute is not None:
+        value = imap(make_attrgetter(eval_ctx.environment, attribute), value)
+
+    # no automatic escaping?  joining is a lot easier then
+    if not eval_ctx.autoescape:
+        return text_type(d).join(imap(text_type, value))
+
+    # if the delimiter doesn't have an html representation we check
+    # if any of the items has.  If yes we do a coercion to Markup
+    if not hasattr(d, "__html__"):
+        value = list(value)
+        do_escape = False
+        for idx, item in enumerate(value):
+            if hasattr(item, "__html__"):
+                do_escape = True
+            else:
+                value[idx] = text_type(item)
+        if do_escape:
+            d = escape(d)
+        else:
+            d = text_type(d)
+        return d.join(value)
+
+    # no html involved, to normal joining
+    return soft_unicode(d).join(imap(soft_unicode, value))
+
+
+def do_center(value, width=80):
+    """Centers the value in a field of a given width."""
+    return text_type(value).center(width)
+
+
+@environmentfilter
+def do_first(environment, seq):
+    """Return the first item of a sequence."""
+    try:
+        return next(iter(seq))
+    except StopIteration:
+        return environment.undefined("No first item, sequence was empty.")
+
+
+@environmentfilter
+def do_last(environment, seq):
+    """
+    Return the last item of a sequence.
+
+    Note: Does not work with generators. You may want to explicitly
+    convert it to a list:
+
+    .. sourcecode:: jinja
+
+        {{ data | selectattr('name', '==', 'Jinja') | list | last }}
+    """
+    try:
+        return next(iter(reversed(seq)))
+    except StopIteration:
+        return environment.undefined("No last item, sequence was empty.")
+
+
+@contextfilter
+def do_random(context, seq):
+    """Return a random item from the sequence."""
+    try:
+        return random.choice(seq)
+    except IndexError:
+        return context.environment.undefined("No random item, sequence was empty.")
+
+
+def do_filesizeformat(value, binary=False):
+    """Format the value like a 'human-readable' file size (i.e. 13 kB,
+    4.1 MB, 102 Bytes, etc).  Per default decimal prefixes are used (Mega,
+    Giga, etc.), if the second parameter is set to `True` the binary
+    prefixes are used (Mebi, Gibi).
+    """
+    bytes = float(value)
+    base = binary and 1024 or 1000
+    prefixes = [
+        (binary and "KiB" or "kB"),
+        (binary and "MiB" or "MB"),
+        (binary and "GiB" or "GB"),
+        (binary and "TiB" or "TB"),
+        (binary and "PiB" or "PB"),
+        (binary and "EiB" or "EB"),
+        (binary and "ZiB" or "ZB"),
+        (binary and "YiB" or "YB"),
+    ]
+    if bytes == 1:
+        return "1 Byte"
+    elif bytes < base:
+        return "%d Bytes" % bytes
+    else:
+        for i, prefix in enumerate(prefixes):
+            unit = base ** (i + 2)
+            if bytes < unit:
+                return "%.1f %s" % ((base * bytes / unit), prefix)
+        return "%.1f %s" % ((base * bytes / unit), prefix)
+
+
+def do_pprint(value, verbose=False):
+    """Pretty print a variable. Useful for debugging.
+
+    With Jinja 1.2 onwards you can pass it a parameter.  If this parameter
+    is truthy the output will be more verbose (this requires `pretty`)
+    """
+    return pformat(value, verbose=verbose)
+
+
+@evalcontextfilter
+def do_urlize(
+    eval_ctx, value, trim_url_limit=None, nofollow=False, target=None, rel=None
+):
+    """Converts URLs in plain text into clickable links.
+
+    If you pass the filter an additional integer it will shorten the urls
+    to that number. Also a third argument exists that makes the urls
+    "nofollow":
+
+    .. sourcecode:: jinja
+
+        {{ mytext|urlize(40, true) }}
+            links are shortened to 40 chars and defined with rel="nofollow"
+
+    If *target* is specified, the ``target`` attribute will be added to the
+    ``<a>`` tag:
+
+    .. sourcecode:: jinja
+
+       {{ mytext|urlize(40, target='_blank') }}
+
+    .. versionchanged:: 2.8+
+       The *target* parameter was added.
+    """
+    policies = eval_ctx.environment.policies
+    rel = set((rel or "").split() or [])
+    if nofollow:
+        rel.add("nofollow")
+    rel.update((policies["urlize.rel"] or "").split())
+    if target is None:
+        target = policies["urlize.target"]
+    rel = " ".join(sorted(rel)) or None
+    rv = urlize(value, trim_url_limit, rel=rel, target=target)
+    if eval_ctx.autoescape:
+        rv = Markup(rv)
+    return rv
+
+
+def do_indent(s, width=4, first=False, blank=False, indentfirst=None):
+    """Return a copy of the string with each line indented by 4 spaces. The
+    first line and blank lines are not indented by default.
+
+    :param width: Number of spaces to indent by.
+    :param first: Don't skip indenting the first line.
+    :param blank: Don't skip indenting empty lines.
+
+    .. versionchanged:: 2.10
+        Blank lines are not indented by default.
+
+        Rename the ``indentfirst`` argument to ``first``.
+    """
+    if indentfirst is not None:
+        warnings.warn(
+            "The 'indentfirst' argument is renamed to 'first' and will"
+            " be removed in version 3.0.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        first = indentfirst
+
+    indention = u" " * width
+    newline = u"\n"
+
+    if isinstance(s, Markup):
+        indention = Markup(indention)
+        newline = Markup(newline)
+
+    s += newline  # this quirk is necessary for splitlines method
+
+    if blank:
+        rv = (newline + indention).join(s.splitlines())
+    else:
+        lines = s.splitlines()
+        rv = lines.pop(0)
+
+        if lines:
+            rv += newline + newline.join(
+                indention + line if line else line for line in lines
+            )
+
+    if first:
+        rv = indention + rv
+
+    return rv
+
+
+@environmentfilter
+def do_truncate(env, s, length=255, killwords=False, end="...", leeway=None):
+    """Return a truncated copy of the string. The length is specified
+    with the first parameter which defaults to ``255``. If the second
+    parameter is ``true`` the filter will cut the text at length. Otherwise
+    it will discard the last word. If the text was in fact
+    truncated it will append an ellipsis sign (``"..."``). If you want a
+    different ellipsis sign than ``"..."`` you can specify it using the
+    third parameter. Strings that only exceed the length by the tolerance
+    margin given in the fourth parameter will not be truncated.
+
+    .. sourcecode:: jinja
+
+        {{ "foo bar baz qux"|truncate(9) }}
+            -> "foo..."
+        {{ "foo bar baz qux"|truncate(9, True) }}
+            -> "foo ba..."
+        {{ "foo bar baz qux"|truncate(11) }}
+            -> "foo bar baz qux"
+        {{ "foo bar baz qux"|truncate(11, False, '...', 0) }}
+            -> "foo bar..."
+
+    The default leeway on newer Jinja versions is 5 and was 0 before but
+    can be reconfigured globally.
+    """
+    if leeway is None:
+        leeway = env.policies["truncate.leeway"]
+    assert length >= len(end), "expected length >= %s, got %s" % (len(end), length)
+    assert leeway >= 0, "expected leeway >= 0, got %s" % leeway
+    if len(s) <= length + leeway:
+        return s
+    if killwords:
+        return s[: length - len(end)] + end
+    result = s[: length - len(end)].rsplit(" ", 1)[0]
+    return result + end
+
+
+@environmentfilter
+def do_wordwrap(
+    environment,
+    s,
+    width=79,
+    break_long_words=True,
+    wrapstring=None,
+    break_on_hyphens=True,
+):
+    """Wrap a string to the given width. Existing newlines are treated
+    as paragraphs to be wrapped separately.
+
+    :param s: Original text to wrap.
+    :param width: Maximum length of wrapped lines.
+    :param break_long_words: If a word is longer than ``width``, break
+        it across lines.
+    :param break_on_hyphens: If a word contains hyphens, it may be split
+        across lines.
+    :param wrapstring: String to join each wrapped line. Defaults to
+        :attr:`Environment.newline_sequence`.
+
+    .. versionchanged:: 2.11
+        Existing newlines are treated as paragraphs wrapped separately.
+
+    .. versionchanged:: 2.11
+        Added the ``break_on_hyphens`` parameter.
+
+    .. versionchanged:: 2.7
+        Added the ``wrapstring`` parameter.
+    """
+
+    import textwrap
+
+    if not wrapstring:
+        wrapstring = environment.newline_sequence
+
+    # textwrap.wrap doesn't consider existing newlines when wrapping.
+    # If the string has a newline before width, wrap will still insert
+    # a newline at width, resulting in a short line. Instead, split and
+    # wrap each paragraph individually.
+    return wrapstring.join(
+        [
+            wrapstring.join(
+                textwrap.wrap(
+                    line,
+                    width=width,
+                    expand_tabs=False,
+                    replace_whitespace=False,
+                    break_long_words=break_long_words,
+                    break_on_hyphens=break_on_hyphens,
+                )
+            )
+            for line in s.splitlines()
+        ]
+    )
+
+
+def do_wordcount(s):
+    """Count the words in that string."""
+    return len(_word_re.findall(soft_unicode(s)))
+
+
+def do_int(value, default=0, base=10):
+    """Convert the value into an integer. If the
+    conversion doesn't work it will return ``0``. You can
+    override this default using the first parameter. You
+    can also override the default base (10) in the second
+    parameter, which handles input with prefixes such as
+    0b, 0o and 0x for bases 2, 8 and 16 respectively.
+    The base is ignored for decimal numbers and non-string values.
+    """
+    try:
+        if isinstance(value, string_types):
+            return int(value, base)
+        return int(value)
+    except (TypeError, ValueError):
+        # this quirk is necessary so that "42.23"|int gives 42.
+        try:
+            return int(float(value))
+        except (TypeError, ValueError):
+            return default
+
+
+def do_float(value, default=0.0):
+    """Convert the value into a floating point number. If the
+    conversion doesn't work it will return ``0.0``. You can
+    override this default using the first parameter.
+    """
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default
+
+
+def do_format(value, *args, **kwargs):
+    """Apply the given values to a `printf-style`_ format string, like
+    ``string % values``.
+
+    .. sourcecode:: jinja
+
+        {{ "%s, %s!"|format(greeting, name) }}
+        Hello, World!
+
+    In most cases it should be more convenient and efficient to use the
+    ``%`` operator or :meth:`str.format`.
+
+    .. code-block:: text
+
+        {{ "%s, %s!" % (greeting, name) }}
+        {{ "{}, {}!".format(greeting, name) }}
+
+    .. _printf-style: https://docs.python.org/library/stdtypes.html
+        #printf-style-string-formatting
+    """
+    if args and kwargs:
+        raise FilterArgumentError(
+            "can't handle positional and keyword arguments at the same time"
+        )
+    return soft_unicode(value) % (kwargs or args)
+
+
+def do_trim(value, chars=None):
+    """Strip leading and trailing characters, by default whitespace."""
+    return soft_unicode(value).strip(chars)
+
+
+def do_striptags(value):
+    """Strip SGML/XML tags and replace adjacent whitespace by one space."""
+    if hasattr(value, "__html__"):
+        value = value.__html__()
+    return Markup(text_type(value)).striptags()
+
+
+def do_slice(value, slices, fill_with=None):
+    """Slice an iterator and return a list of lists containing
+    those items. Useful if you want to create a div containing
+    three ul tags that represent columns:
+
+    .. sourcecode:: html+jinja
+
+        <div class="columnwrapper">
+          {%- for column in items|slice(3) %}
+            <ul class="column-{{ loop.index }}">
+            {%- for item in column %}
+              <li>{{ item }}</li>
+            {%- endfor %}
+            </ul>
+          {%- endfor %}
+        </div>
+
+    If you pass it a second argument it's used to fill missing
+    values on the last iteration.
+    """
+    seq = list(value)
+    length = len(seq)
+    items_per_slice = length // slices
+    slices_with_extra = length % slices
+    offset = 0
+    for slice_number in range(slices):
+        start = offset + slice_number * items_per_slice
+        if slice_number < slices_with_extra:
+            offset += 1
+        end = offset + (slice_number + 1) * items_per_slice
+        tmp = seq[start:end]
+        if fill_with is not None and slice_number >= slices_with_extra:
+            tmp.append(fill_with)
+        yield tmp
+
+
+def do_batch(value, linecount, fill_with=None):
+    """
+    A filter that batches items. It works pretty much like `slice`
+    just the other way round. It returns a list of lists with the
+    given number of items. If you provide a second parameter this
+    is used to fill up missing items. See this example:
+
+    .. sourcecode:: html+jinja
+
+        <table>
+        {%- for row in items|batch(3, '&nbsp;') %}
+          <tr>
+          {%- for column in row %}
+            <td>{{ column }}</td>
+          {%- endfor %}
+          </tr>
+        {%- endfor %}
+        </table>
+    """
+    tmp = []
+    for item in value:
+        if len(tmp) == linecount:
+            yield tmp
+            tmp = []
+        tmp.append(item)
+    if tmp:
+        if fill_with is not None and len(tmp) < linecount:
+            tmp += [fill_with] * (linecount - len(tmp))
+        yield tmp
+
+
+def do_round(value, precision=0, method="common"):
+    """Round the number to a given precision. The first
+    parameter specifies the precision (default is ``0``), the
+    second the rounding method:
+
+    - ``'common'`` rounds either up or down
+    - ``'ceil'`` always rounds up
+    - ``'floor'`` always rounds down
+
+    If you don't specify a method ``'common'`` is used.
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round }}
+            -> 43.0
+        {{ 42.55|round(1, 'floor') }}
+            -> 42.5
+
+    Note that even if rounded to 0 precision, a float is returned.  If
+    you need a real integer, pipe it through `int`:
+
+    .. sourcecode:: jinja
+
+        {{ 42.55|round|int }}
+            -> 43
+    """
+    if method not in {"common", "ceil", "floor"}:
+        raise FilterArgumentError("method must be common, ceil or floor")
+    if method == "common":
+        return round(value, precision)
+    func = getattr(math, method)
+    return func(value * (10 ** precision)) / (10 ** precision)
+
+
+# Use a regular tuple repr here.  This is what we did in the past and we
+# really want to hide this custom type as much as possible.  In particular
+# we do not want to accidentally expose an auto generated repr in case
+# people start to print this out in comments or something similar for
+# debugging.
+_GroupTuple = namedtuple("_GroupTuple", ["grouper", "list"])
+_GroupTuple.__repr__ = tuple.__repr__
+_GroupTuple.__str__ = tuple.__str__
+
+
+@environmentfilter
+def do_groupby(environment, value, attribute):
+    """Group a sequence of objects by an attribute using Python's
+    :func:`itertools.groupby`. The attribute can use dot notation for
+    nested access, like ``"address.city"``. Unlike Python's ``groupby``,
+    the values are sorted first so only one group is returned for each
+    unique value.
+
+    For example, a list of ``User`` objects with a ``city`` attribute
+    can be rendered in groups. In this example, ``grouper`` refers to
+    the ``city`` value of the group.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for city, items in users|groupby("city") %}
+          <li>{{ city }}
+            <ul>{% for user in items %}
+              <li>{{ user.name }}
+            {% endfor %}</ul>
+          </li>
+        {% endfor %}</ul>
+
+    ``groupby`` yields namedtuples of ``(grouper, list)``, which
+    can be used instead of the tuple unpacking above. ``grouper`` is the
+    value of the attribute, and ``list`` is the items with that value.
+
+    .. sourcecode:: html+jinja
+
+        <ul>{% for group in users|groupby("city") %}
+          <li>{{ group.grouper }}: {{ group.list|join(", ") }}
+        {% endfor %}</ul>
+
+    .. versionchanged:: 2.6
+        The attribute supports dot notation for nested access.
+    """
+    expr = make_attrgetter(environment, attribute)
+    return [
+        _GroupTuple(key, list(values))
+        for key, values in groupby(sorted(value, key=expr), expr)
+    ]
+
+
+@environmentfilter
+def do_sum(environment, iterable, attribute=None, start=0):
+    """Returns the sum of a sequence of numbers plus the value of parameter
+    'start' (which defaults to 0).  When the sequence is empty it returns
+    start.
+
+    It is also possible to sum up only certain attributes:
+
+    .. sourcecode:: jinja
+
+        Total: {{ items|sum(attribute='price') }}
+
+    .. versionchanged:: 2.6
+       The `attribute` parameter was added to allow suming up over
+       attributes.  Also the `start` parameter was moved on to the right.
+    """
+    if attribute is not None:
+        iterable = imap(make_attrgetter(environment, attribute), iterable)
+    return sum(iterable, start)
+
+
+def do_list(value):
+    """Convert the value into a list.  If it was a string the returned list
+    will be a list of characters.
+    """
+    return list(value)
+
+
+def do_mark_safe(value):
+    """Mark the value as safe which means that in an environment with automatic
+    escaping enabled this variable will not be escaped.
+    """
+    return Markup(value)
+
+
+def do_mark_unsafe(value):
+    """Mark a value as unsafe.  This is the reverse operation for :func:`safe`."""
+    return text_type(value)
+
+
+def do_reverse(value):
+    """Reverse the object or return an iterator that iterates over it the other
+    way round.
+    """
+    if isinstance(value, string_types):
+        return value[::-1]
+    try:
+        return reversed(value)
+    except TypeError:
+        try:
+            rv = list(value)
+            rv.reverse()
+            return rv
+        except TypeError:
+            raise FilterArgumentError("argument must be iterable")
+
+
+@environmentfilter
+def do_attr(environment, obj, name):
+    """Get an attribute of an object.  ``foo|attr("bar")`` works like
+    ``foo.bar`` just that always an attribute is returned and items are not
+    looked up.
+
+    See :ref:`Notes on subscriptions <notes-on-subscriptions>` for more details.
+    """
+    try:
+        name = str(name)
+    except UnicodeError:
+        pass
+    else:
+        try:
+            value = getattr(obj, name)
+        except AttributeError:
+            pass
+        else:
+            if environment.sandboxed and not environment.is_safe_attribute(
+                obj, name, value
+            ):
+                return environment.unsafe_undefined(obj, name)
+            return value
+    return environment.undefined(obj=obj, name=name)
+
+
+@contextfilter
+def do_map(*args, **kwargs):
+    """Applies a filter on a sequence of objects or looks up an attribute.
+    This is useful when dealing with lists of objects but you are really
+    only interested in a certain value of it.
+
+    The basic usage is mapping on an attribute.  Imagine you have a list
+    of users but you are only interested in a list of usernames:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ users|map(attribute='username')|join(', ') }}
+
+    You can specify a ``default`` value to use if an object in the list
+    does not have the given attribute.
+
+    .. sourcecode:: jinja
+
+        {{ users|map(attribute="username", default="Anonymous")|join(", ") }}
+
+    Alternatively you can let it invoke a filter by passing the name of the
+    filter and the arguments afterwards.  A good example would be applying a
+    text conversion filter on a sequence:
+
+    .. sourcecode:: jinja
+
+        Users on this page: {{ titles|map('lower')|join(', ') }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u.username for u in users)
+        (u.username or "Anonymous" for u in users)
+        (do_lower(x) for x in titles)
+
+    .. versionchanged:: 2.11.0
+        Added the ``default`` parameter.
+
+    .. versionadded:: 2.7
+    """
+    seq, func = prepare_map(args, kwargs)
+    if seq:
+        for item in seq:
+            yield func(item)
+
+
+@contextfilter
+def do_select(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and only selecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|select("odd") }}
+        {{ numbers|select("odd") }}
+        {{ numbers|select("divisibleby", 3) }}
+        {{ numbers|select("lessthan", 42) }}
+        {{ strings|select("equalto", "mystring") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if test_odd(n))
+        (n for n in numbers if test_divisibleby(n, 3))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, False)
+
+
+@contextfilter
+def do_reject(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to each object,
+    and rejecting the objects with the test succeeding.
+
+    If no test is specified, each object will be evaluated as a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ numbers|reject("odd") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (n for n in numbers if not test_odd(n))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, False)
+
+
+@contextfilter
+def do_selectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and only selecting the objects with the
+    test succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    Example usage:
+
+    .. sourcecode:: jinja
+
+        {{ users|selectattr("is_active") }}
+        {{ users|selectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if user.is_active)
+        (u for user in users if test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: x, True)
+
+
+@contextfilter
+def do_rejectattr(*args, **kwargs):
+    """Filters a sequence of objects by applying a test to the specified
+    attribute of each object, and rejecting the objects with the test
+    succeeding.
+
+    If no test is specified, the attribute's value will be evaluated as
+    a boolean.
+
+    .. sourcecode:: jinja
+
+        {{ users|rejectattr("is_active") }}
+        {{ users|rejectattr("email", "none") }}
+
+    Similar to a generator comprehension such as:
+
+    .. code-block:: python
+
+        (u for user in users if not user.is_active)
+        (u for user in users if not test_none(user.email))
+
+    .. versionadded:: 2.7
+    """
+    return select_or_reject(args, kwargs, lambda x: not x, True)
+
+
+@evalcontextfilter
+def do_tojson(eval_ctx, value, indent=None):
+    """Dumps a structure to JSON so that it's safe to use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+
+    The indent parameter can be used to enable pretty printing.  Set it to
+    the number of spaces that the structures should be indented with.
+
+    Note that this filter is for use in HTML contexts only.
+
+    .. versionadded:: 2.9
+    """
+    policies = eval_ctx.environment.policies
+    dumper = policies["json.dumps_function"]
+    options = policies["json.dumps_kwargs"]
+    if indent is not None:
+        options = dict(options)
+        options["indent"] = indent
+    return htmlsafe_json_dumps(value, dumper=dumper, **options)
+
+
+def prepare_map(args, kwargs):
+    context = args[0]
+    seq = args[1]
+    default = None
+
+    if len(args) == 2 and "attribute" in kwargs:
+        attribute = kwargs.pop("attribute")
+        default = kwargs.pop("default", None)
+        if kwargs:
+            raise FilterArgumentError(
+                "Unexpected keyword argument %r" % next(iter(kwargs))
+            )
+        func = make_attrgetter(context.environment, attribute, default=default)
+    else:
+        try:
+            name = args[2]
+            args = args[3:]
+        except LookupError:
+            raise FilterArgumentError("map requires a filter argument")
+
+        def func(item):
+            return context.environment.call_filter(
+                name, item, args, kwargs, context=context
+            )
+
+    return seq, func
+
+
+def prepare_select_or_reject(args, kwargs, modfunc, lookup_attr):
+    context = args[0]
+    seq = args[1]
+    if lookup_attr:
+        try:
+            attr = args[2]
+        except LookupError:
+            raise FilterArgumentError("Missing parameter for attribute name")
+        transfunc = make_attrgetter(context.environment, attr)
+        off = 1
+    else:
+        off = 0
+
+        def transfunc(x):
+            return x
+
+    try:
+        name = args[2 + off]
+        args = args[3 + off :]
+
+        def func(item):
+            return context.environment.call_test(name, item, args, kwargs)
+
+    except LookupError:
+        func = bool
+
+    return seq, lambda item: modfunc(func(transfunc(item)))
+
+
+def select_or_reject(args, kwargs, modfunc, lookup_attr):
+    seq, func = prepare_select_or_reject(args, kwargs, modfunc, lookup_attr)
+    if seq:
+        for item in seq:
+            if func(item):
+                yield item
+
+
+FILTERS = {
+    "abs": abs,
+    "attr": do_attr,
+    "batch": do_batch,
+    "capitalize": do_capitalize,
+    "center": do_center,
+    "count": len,
+    "d": do_default,
+    "default": do_default,
+    "dictsort": do_dictsort,
+    "e": escape,
+    "escape": escape,
+    "filesizeformat": do_filesizeformat,
+    "first": do_first,
+    "float": do_float,
+    "forceescape": do_forceescape,
+    "format": do_format,
+    "groupby": do_groupby,
+    "indent": do_indent,
+    "int": do_int,
+    "join": do_join,
+    "last": do_last,
+    "length": len,
+    "list": do_list,
+    "lower": do_lower,
+    "map": do_map,
+    "min": do_min,
+    "max": do_max,
+    "pprint": do_pprint,
+    "random": do_random,
+    "reject": do_reject,
+    "rejectattr": do_rejectattr,
+    "replace": do_replace,
+    "reverse": do_reverse,
+    "round": do_round,
+    "safe": do_mark_safe,
+    "select": do_select,
+    "selectattr": do_selectattr,
+    "slice": do_slice,
+    "sort": do_sort,
+    "string": soft_unicode,
+    "striptags": do_striptags,
+    "sum": do_sum,
+    "title": do_title,
+    "trim": do_trim,
+    "truncate": do_truncate,
+    "unique": do_unique,
+    "upper": do_upper,
+    "urlencode": do_urlencode,
+    "urlize": do_urlize,
+    "wordcount": do_wordcount,
+    "wordwrap": do_wordwrap,
+    "xmlattr": do_xmlattr,
+    "tojson": do_tojson,
+}
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/idtracking.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/idtracking.py
new file mode 100644
index 0000000000000000000000000000000000000000..9a0d838017c938fa7a2c4279c4e8edc125608aaf
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/idtracking.py
@@ -0,0 +1,290 @@
+from ._compat import iteritems
+from .visitor import NodeVisitor
+
+VAR_LOAD_PARAMETER = "param"
+VAR_LOAD_RESOLVE = "resolve"
+VAR_LOAD_ALIAS = "alias"
+VAR_LOAD_UNDEFINED = "undefined"
+
+
+def find_symbols(nodes, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    visitor = FrameSymbolVisitor(sym)
+    for node in nodes:
+        visitor.visit(node)
+    return sym
+
+
+def symbols_for_node(node, parent_symbols=None):
+    sym = Symbols(parent=parent_symbols)
+    sym.analyze_node(node)
+    return sym
+
+
+class Symbols(object):
+    def __init__(self, parent=None, level=None):
+        if level is None:
+            if parent is None:
+                level = 0
+            else:
+                level = parent.level + 1
+        self.level = level
+        self.parent = parent
+        self.refs = {}
+        self.loads = {}
+        self.stores = set()
+
+    def analyze_node(self, node, **kwargs):
+        visitor = RootVisitor(self)
+        visitor.visit(node, **kwargs)
+
+    def _define_ref(self, name, load=None):
+        ident = "l_%d_%s" % (self.level, name)
+        self.refs[name] = ident
+        if load is not None:
+            self.loads[ident] = load
+        return ident
+
+    def find_load(self, target):
+        if target in self.loads:
+            return self.loads[target]
+        if self.parent is not None:
+            return self.parent.find_load(target)
+
+    def find_ref(self, name):
+        if name in self.refs:
+            return self.refs[name]
+        if self.parent is not None:
+            return self.parent.find_ref(name)
+
+    def ref(self, name):
+        rv = self.find_ref(name)
+        if rv is None:
+            raise AssertionError(
+                "Tried to resolve a name to a reference that "
+                "was unknown to the frame (%r)" % name
+            )
+        return rv
+
+    def copy(self):
+        rv = object.__new__(self.__class__)
+        rv.__dict__.update(self.__dict__)
+        rv.refs = self.refs.copy()
+        rv.loads = self.loads.copy()
+        rv.stores = self.stores.copy()
+        return rv
+
+    def store(self, name):
+        self.stores.add(name)
+
+        # If we have not see the name referenced yet, we need to figure
+        # out what to set it to.
+        if name not in self.refs:
+            # If there is a parent scope we check if the name has a
+            # reference there.  If it does it means we might have to alias
+            # to a variable there.
+            if self.parent is not None:
+                outer_ref = self.parent.find_ref(name)
+                if outer_ref is not None:
+                    self._define_ref(name, load=(VAR_LOAD_ALIAS, outer_ref))
+                    return
+
+            # Otherwise we can just set it to undefined.
+            self._define_ref(name, load=(VAR_LOAD_UNDEFINED, None))
+
+    def declare_parameter(self, name):
+        self.stores.add(name)
+        return self._define_ref(name, load=(VAR_LOAD_PARAMETER, None))
+
+    def load(self, name):
+        target = self.find_ref(name)
+        if target is None:
+            self._define_ref(name, load=(VAR_LOAD_RESOLVE, name))
+
+    def branch_update(self, branch_symbols):
+        stores = {}
+        for branch in branch_symbols:
+            for target in branch.stores:
+                if target in self.stores:
+                    continue
+                stores[target] = stores.get(target, 0) + 1
+
+        for sym in branch_symbols:
+            self.refs.update(sym.refs)
+            self.loads.update(sym.loads)
+            self.stores.update(sym.stores)
+
+        for name, branch_count in iteritems(stores):
+            if branch_count == len(branch_symbols):
+                continue
+            target = self.find_ref(name)
+            assert target is not None, "should not happen"
+
+            if self.parent is not None:
+                outer_target = self.parent.find_ref(name)
+                if outer_target is not None:
+                    self.loads[target] = (VAR_LOAD_ALIAS, outer_target)
+                    continue
+            self.loads[target] = (VAR_LOAD_RESOLVE, name)
+
+    def dump_stores(self):
+        rv = {}
+        node = self
+        while node is not None:
+            for name in node.stores:
+                if name not in rv:
+                    rv[name] = self.find_ref(name)
+            node = node.parent
+        return rv
+
+    def dump_param_targets(self):
+        rv = set()
+        node = self
+        while node is not None:
+            for target, (instr, _) in iteritems(self.loads):
+                if instr == VAR_LOAD_PARAMETER:
+                    rv.add(target)
+            node = node.parent
+        return rv
+
+
+class RootVisitor(NodeVisitor):
+    def __init__(self, symbols):
+        self.sym_visitor = FrameSymbolVisitor(symbols)
+
+    def _simple_visit(self, node, **kwargs):
+        for child in node.iter_child_nodes():
+            self.sym_visitor.visit(child)
+
+    visit_Template = (
+        visit_Block
+    ) = (
+        visit_Macro
+    ) = (
+        visit_FilterBlock
+    ) = visit_Scope = visit_If = visit_ScopedEvalContextModifier = _simple_visit
+
+    def visit_AssignBlock(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_CallBlock(self, node, **kwargs):
+        for child in node.iter_child_nodes(exclude=("call",)):
+            self.sym_visitor.visit(child)
+
+    def visit_OverlayScope(self, node, **kwargs):
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def visit_For(self, node, for_branch="body", **kwargs):
+        if for_branch == "body":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            branch = node.body
+        elif for_branch == "else":
+            branch = node.else_
+        elif for_branch == "test":
+            self.sym_visitor.visit(node.target, store_as_param=True)
+            if node.test is not None:
+                self.sym_visitor.visit(node.test)
+            return
+        else:
+            raise RuntimeError("Unknown for branch")
+        for item in branch or ():
+            self.sym_visitor.visit(item)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.targets:
+            self.sym_visitor.visit(target)
+        for child in node.body:
+            self.sym_visitor.visit(child)
+
+    def generic_visit(self, node, *args, **kwargs):
+        raise NotImplementedError(
+            "Cannot find symbols for %r" % node.__class__.__name__
+        )
+
+
+class FrameSymbolVisitor(NodeVisitor):
+    """A visitor for `Frame.inspect`."""
+
+    def __init__(self, symbols):
+        self.symbols = symbols
+
+    def visit_Name(self, node, store_as_param=False, **kwargs):
+        """All assignments to names go through this function."""
+        if store_as_param or node.ctx == "param":
+            self.symbols.declare_parameter(node.name)
+        elif node.ctx == "store":
+            self.symbols.store(node.name)
+        elif node.ctx == "load":
+            self.symbols.load(node.name)
+
+    def visit_NSRef(self, node, **kwargs):
+        self.symbols.load(node.name)
+
+    def visit_If(self, node, **kwargs):
+        self.visit(node.test, **kwargs)
+
+        original_symbols = self.symbols
+
+        def inner_visit(nodes):
+            self.symbols = rv = original_symbols.copy()
+            for subnode in nodes:
+                self.visit(subnode, **kwargs)
+            self.symbols = original_symbols
+            return rv
+
+        body_symbols = inner_visit(node.body)
+        elif_symbols = inner_visit(node.elif_)
+        else_symbols = inner_visit(node.else_ or ())
+
+        self.symbols.branch_update([body_symbols, elif_symbols, else_symbols])
+
+    def visit_Macro(self, node, **kwargs):
+        self.symbols.store(node.name)
+
+    def visit_Import(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        self.symbols.store(node.target)
+
+    def visit_FromImport(self, node, **kwargs):
+        self.generic_visit(node, **kwargs)
+        for name in node.names:
+            if isinstance(name, tuple):
+                self.symbols.store(name[1])
+            else:
+                self.symbols.store(name)
+
+    def visit_Assign(self, node, **kwargs):
+        """Visit assignments in the correct order."""
+        self.visit(node.node, **kwargs)
+        self.visit(node.target, **kwargs)
+
+    def visit_For(self, node, **kwargs):
+        """Visiting stops at for blocks.  However the block sequence
+        is visited as part of the outer scope.
+        """
+        self.visit(node.iter, **kwargs)
+
+    def visit_CallBlock(self, node, **kwargs):
+        self.visit(node.call, **kwargs)
+
+    def visit_FilterBlock(self, node, **kwargs):
+        self.visit(node.filter, **kwargs)
+
+    def visit_With(self, node, **kwargs):
+        for target in node.values:
+            self.visit(target)
+
+    def visit_AssignBlock(self, node, **kwargs):
+        """Stop visiting at block assigns."""
+        self.visit(node.target, **kwargs)
+
+    def visit_Scope(self, node, **kwargs):
+        """Stop visiting at scopes."""
+
+    def visit_Block(self, node, **kwargs):
+        """Stop visiting at blocks."""
+
+    def visit_OverlayScope(self, node, **kwargs):
+        """Do not visit into overlay scopes."""
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/lexer.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/lexer.py
new file mode 100644
index 0000000000000000000000000000000000000000..552356a12d1d812397bc5b4f0491a1c115c3797a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/lexer.py
@@ -0,0 +1,848 @@
+# -*- coding: utf-8 -*-
+"""Implements a Jinja / Python combination lexer. The ``Lexer`` class
+is used to do some preprocessing. It filters out invalid operators like
+the bitshift operators we don't allow in templates. It separates
+template code and python code in expressions.
+"""
+import re
+from ast import literal_eval
+from collections import deque
+from operator import itemgetter
+
+from ._compat import implements_iterator
+from ._compat import intern
+from ._compat import iteritems
+from ._compat import text_type
+from .exceptions import TemplateSyntaxError
+from .utils import LRUCache
+
+# cache for the lexers. Exists in order to be able to have multiple
+# environments with the same lexer
+_lexer_cache = LRUCache(50)
+
+# static regular expressions
+whitespace_re = re.compile(r"\s+", re.U)
+newline_re = re.compile(r"(\r\n|\r|\n)")
+string_re = re.compile(
+    r"('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S
+)
+integer_re = re.compile(r"(\d+_)*\d+")
+float_re = re.compile(
+    r"""
+    (?<!\.)  # doesn't start with a .
+    (\d+_)*\d+  # digits, possibly _ separated
+    (
+        (\.(\d+_)*\d+)?  # optional fractional part
+        e[+\-]?(\d+_)*\d+  # exponent part
+    |
+        \.(\d+_)*\d+  # required fractional part
+    )
+    """,
+    re.IGNORECASE | re.VERBOSE,
+)
+
+try:
+    # check if this Python supports Unicode identifiers
+    compile("föö", "<unknown>", "eval")
+except SyntaxError:
+    # Python 2, no Unicode support, use ASCII identifiers
+    name_re = re.compile(r"[a-zA-Z_][a-zA-Z0-9_]*")
+    check_ident = False
+else:
+    # Unicode support, import generated re pattern and set flag to use
+    # str.isidentifier to validate during lexing.
+    from ._identifier import pattern as name_re
+
+    check_ident = True
+
+# internal the tokens and keep references to them
+TOKEN_ADD = intern("add")
+TOKEN_ASSIGN = intern("assign")
+TOKEN_COLON = intern("colon")
+TOKEN_COMMA = intern("comma")
+TOKEN_DIV = intern("div")
+TOKEN_DOT = intern("dot")
+TOKEN_EQ = intern("eq")
+TOKEN_FLOORDIV = intern("floordiv")
+TOKEN_GT = intern("gt")
+TOKEN_GTEQ = intern("gteq")
+TOKEN_LBRACE = intern("lbrace")
+TOKEN_LBRACKET = intern("lbracket")
+TOKEN_LPAREN = intern("lparen")
+TOKEN_LT = intern("lt")
+TOKEN_LTEQ = intern("lteq")
+TOKEN_MOD = intern("mod")
+TOKEN_MUL = intern("mul")
+TOKEN_NE = intern("ne")
+TOKEN_PIPE = intern("pipe")
+TOKEN_POW = intern("pow")
+TOKEN_RBRACE = intern("rbrace")
+TOKEN_RBRACKET = intern("rbracket")
+TOKEN_RPAREN = intern("rparen")
+TOKEN_SEMICOLON = intern("semicolon")
+TOKEN_SUB = intern("sub")
+TOKEN_TILDE = intern("tilde")
+TOKEN_WHITESPACE = intern("whitespace")
+TOKEN_FLOAT = intern("float")
+TOKEN_INTEGER = intern("integer")
+TOKEN_NAME = intern("name")
+TOKEN_STRING = intern("string")
+TOKEN_OPERATOR = intern("operator")
+TOKEN_BLOCK_BEGIN = intern("block_begin")
+TOKEN_BLOCK_END = intern("block_end")
+TOKEN_VARIABLE_BEGIN = intern("variable_begin")
+TOKEN_VARIABLE_END = intern("variable_end")
+TOKEN_RAW_BEGIN = intern("raw_begin")
+TOKEN_RAW_END = intern("raw_end")
+TOKEN_COMMENT_BEGIN = intern("comment_begin")
+TOKEN_COMMENT_END = intern("comment_end")
+TOKEN_COMMENT = intern("comment")
+TOKEN_LINESTATEMENT_BEGIN = intern("linestatement_begin")
+TOKEN_LINESTATEMENT_END = intern("linestatement_end")
+TOKEN_LINECOMMENT_BEGIN = intern("linecomment_begin")
+TOKEN_LINECOMMENT_END = intern("linecomment_end")
+TOKEN_LINECOMMENT = intern("linecomment")
+TOKEN_DATA = intern("data")
+TOKEN_INITIAL = intern("initial")
+TOKEN_EOF = intern("eof")
+
+# bind operators to token types
+operators = {
+    "+": TOKEN_ADD,
+    "-": TOKEN_SUB,
+    "/": TOKEN_DIV,
+    "//": TOKEN_FLOORDIV,
+    "*": TOKEN_MUL,
+    "%": TOKEN_MOD,
+    "**": TOKEN_POW,
+    "~": TOKEN_TILDE,
+    "[": TOKEN_LBRACKET,
+    "]": TOKEN_RBRACKET,
+    "(": TOKEN_LPAREN,
+    ")": TOKEN_RPAREN,
+    "{": TOKEN_LBRACE,
+    "}": TOKEN_RBRACE,
+    "==": TOKEN_EQ,
+    "!=": TOKEN_NE,
+    ">": TOKEN_GT,
+    ">=": TOKEN_GTEQ,
+    "<": TOKEN_LT,
+    "<=": TOKEN_LTEQ,
+    "=": TOKEN_ASSIGN,
+    ".": TOKEN_DOT,
+    ":": TOKEN_COLON,
+    "|": TOKEN_PIPE,
+    ",": TOKEN_COMMA,
+    ";": TOKEN_SEMICOLON,
+}
+
+reverse_operators = dict([(v, k) for k, v in iteritems(operators)])
+assert len(operators) == len(reverse_operators), "operators dropped"
+operator_re = re.compile(
+    "(%s)" % "|".join(re.escape(x) for x in sorted(operators, key=lambda x: -len(x)))
+)
+
+ignored_tokens = frozenset(
+    [
+        TOKEN_COMMENT_BEGIN,
+        TOKEN_COMMENT,
+        TOKEN_COMMENT_END,
+        TOKEN_WHITESPACE,
+        TOKEN_LINECOMMENT_BEGIN,
+        TOKEN_LINECOMMENT_END,
+        TOKEN_LINECOMMENT,
+    ]
+)
+ignore_if_empty = frozenset(
+    [TOKEN_WHITESPACE, TOKEN_DATA, TOKEN_COMMENT, TOKEN_LINECOMMENT]
+)
+
+
+def _describe_token_type(token_type):
+    if token_type in reverse_operators:
+        return reverse_operators[token_type]
+    return {
+        TOKEN_COMMENT_BEGIN: "begin of comment",
+        TOKEN_COMMENT_END: "end of comment",
+        TOKEN_COMMENT: "comment",
+        TOKEN_LINECOMMENT: "comment",
+        TOKEN_BLOCK_BEGIN: "begin of statement block",
+        TOKEN_BLOCK_END: "end of statement block",
+        TOKEN_VARIABLE_BEGIN: "begin of print statement",
+        TOKEN_VARIABLE_END: "end of print statement",
+        TOKEN_LINESTATEMENT_BEGIN: "begin of line statement",
+        TOKEN_LINESTATEMENT_END: "end of line statement",
+        TOKEN_DATA: "template data / text",
+        TOKEN_EOF: "end of template",
+    }.get(token_type, token_type)
+
+
+def describe_token(token):
+    """Returns a description of the token."""
+    if token.type == TOKEN_NAME:
+        return token.value
+    return _describe_token_type(token.type)
+
+
+def describe_token_expr(expr):
+    """Like `describe_token` but for token expressions."""
+    if ":" in expr:
+        type, value = expr.split(":", 1)
+        if type == TOKEN_NAME:
+            return value
+    else:
+        type = expr
+    return _describe_token_type(type)
+
+
+def count_newlines(value):
+    """Count the number of newline characters in the string.  This is
+    useful for extensions that filter a stream.
+    """
+    return len(newline_re.findall(value))
+
+
+def compile_rules(environment):
+    """Compiles all the rules from the environment into a list of rules."""
+    e = re.escape
+    rules = [
+        (
+            len(environment.comment_start_string),
+            TOKEN_COMMENT_BEGIN,
+            e(environment.comment_start_string),
+        ),
+        (
+            len(environment.block_start_string),
+            TOKEN_BLOCK_BEGIN,
+            e(environment.block_start_string),
+        ),
+        (
+            len(environment.variable_start_string),
+            TOKEN_VARIABLE_BEGIN,
+            e(environment.variable_start_string),
+        ),
+    ]
+
+    if environment.line_statement_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_statement_prefix),
+                TOKEN_LINESTATEMENT_BEGIN,
+                r"^[ \t\v]*" + e(environment.line_statement_prefix),
+            )
+        )
+    if environment.line_comment_prefix is not None:
+        rules.append(
+            (
+                len(environment.line_comment_prefix),
+                TOKEN_LINECOMMENT_BEGIN,
+                r"(?:^|(?<=\S))[^\S\r\n]*" + e(environment.line_comment_prefix),
+            )
+        )
+
+    return [x[1:] for x in sorted(rules, reverse=True)]
+
+
+class Failure(object):
+    """Class that raises a `TemplateSyntaxError` if called.
+    Used by the `Lexer` to specify known errors.
+    """
+
+    def __init__(self, message, cls=TemplateSyntaxError):
+        self.message = message
+        self.error_class = cls
+
+    def __call__(self, lineno, filename):
+        raise self.error_class(self.message, lineno, filename)
+
+
+class Token(tuple):
+    """Token class."""
+
+    __slots__ = ()
+    lineno, type, value = (property(itemgetter(x)) for x in range(3))
+
+    def __new__(cls, lineno, type, value):
+        return tuple.__new__(cls, (lineno, intern(str(type)), value))
+
+    def __str__(self):
+        if self.type in reverse_operators:
+            return reverse_operators[self.type]
+        elif self.type == "name":
+            return self.value
+        return self.type
+
+    def test(self, expr):
+        """Test a token against a token expression.  This can either be a
+        token type or ``'token_type:token_value'``.  This can only test
+        against string values and types.
+        """
+        # here we do a regular string equality check as test_any is usually
+        # passed an iterable of not interned strings.
+        if self.type == expr:
+            return True
+        elif ":" in expr:
+            return expr.split(":", 1) == [self.type, self.value]
+        return False
+
+    def test_any(self, *iterable):
+        """Test against multiple token expressions."""
+        for expr in iterable:
+            if self.test(expr):
+                return True
+        return False
+
+    def __repr__(self):
+        return "Token(%r, %r, %r)" % (self.lineno, self.type, self.value)
+
+
+@implements_iterator
+class TokenStreamIterator(object):
+    """The iterator for tokenstreams.  Iterate over the stream
+    until the eof token is reached.
+    """
+
+    def __init__(self, stream):
+        self.stream = stream
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        token = self.stream.current
+        if token.type is TOKEN_EOF:
+            self.stream.close()
+            raise StopIteration()
+        next(self.stream)
+        return token
+
+
+@implements_iterator
+class TokenStream(object):
+    """A token stream is an iterable that yields :class:`Token`\\s.  The
+    parser however does not iterate over it but calls :meth:`next` to go
+    one token ahead.  The current active token is stored as :attr:`current`.
+    """
+
+    def __init__(self, generator, name, filename):
+        self._iter = iter(generator)
+        self._pushed = deque()
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.current = Token(1, TOKEN_INITIAL, "")
+        next(self)
+
+    def __iter__(self):
+        return TokenStreamIterator(self)
+
+    def __bool__(self):
+        return bool(self._pushed) or self.current.type is not TOKEN_EOF
+
+    __nonzero__ = __bool__  # py2
+
+    @property
+    def eos(self):
+        """Are we at the end of the stream?"""
+        return not self
+
+    def push(self, token):
+        """Push a token back to the stream."""
+        self._pushed.append(token)
+
+    def look(self):
+        """Look at the next token."""
+        old_token = next(self)
+        result = self.current
+        self.push(result)
+        self.current = old_token
+        return result
+
+    def skip(self, n=1):
+        """Got n tokens ahead."""
+        for _ in range(n):
+            next(self)
+
+    def next_if(self, expr):
+        """Perform the token test and return the token if it matched.
+        Otherwise the return value is `None`.
+        """
+        if self.current.test(expr):
+            return next(self)
+
+    def skip_if(self, expr):
+        """Like :meth:`next_if` but only returns `True` or `False`."""
+        return self.next_if(expr) is not None
+
+    def __next__(self):
+        """Go one token ahead and return the old one.
+
+        Use the built-in :func:`next` instead of calling this directly.
+        """
+        rv = self.current
+        if self._pushed:
+            self.current = self._pushed.popleft()
+        elif self.current.type is not TOKEN_EOF:
+            try:
+                self.current = next(self._iter)
+            except StopIteration:
+                self.close()
+        return rv
+
+    def close(self):
+        """Close the stream."""
+        self.current = Token(self.current.lineno, TOKEN_EOF, "")
+        self._iter = None
+        self.closed = True
+
+    def expect(self, expr):
+        """Expect a given token type and return it.  This accepts the same
+        argument as :meth:`jinja2.lexer.Token.test`.
+        """
+        if not self.current.test(expr):
+            expr = describe_token_expr(expr)
+            if self.current.type is TOKEN_EOF:
+                raise TemplateSyntaxError(
+                    "unexpected end of template, expected %r." % expr,
+                    self.current.lineno,
+                    self.name,
+                    self.filename,
+                )
+            raise TemplateSyntaxError(
+                "expected token %r, got %r" % (expr, describe_token(self.current)),
+                self.current.lineno,
+                self.name,
+                self.filename,
+            )
+        try:
+            return self.current
+        finally:
+            next(self)
+
+
+def get_lexer(environment):
+    """Return a lexer which is probably cached."""
+    key = (
+        environment.block_start_string,
+        environment.block_end_string,
+        environment.variable_start_string,
+        environment.variable_end_string,
+        environment.comment_start_string,
+        environment.comment_end_string,
+        environment.line_statement_prefix,
+        environment.line_comment_prefix,
+        environment.trim_blocks,
+        environment.lstrip_blocks,
+        environment.newline_sequence,
+        environment.keep_trailing_newline,
+    )
+    lexer = _lexer_cache.get(key)
+    if lexer is None:
+        lexer = Lexer(environment)
+        _lexer_cache[key] = lexer
+    return lexer
+
+
+class OptionalLStrip(tuple):
+    """A special tuple for marking a point in the state that can have
+    lstrip applied.
+    """
+
+    __slots__ = ()
+
+    # Even though it looks like a no-op, creating instances fails
+    # without this.
+    def __new__(cls, *members, **kwargs):
+        return super(OptionalLStrip, cls).__new__(cls, members)
+
+
+class Lexer(object):
+    """Class that implements a lexer for a given environment. Automatically
+    created by the environment class, usually you don't have to do that.
+
+    Note that the lexer is not automatically bound to an environment.
+    Multiple environments can share the same lexer.
+    """
+
+    def __init__(self, environment):
+        # shortcuts
+        e = re.escape
+
+        def c(x):
+            return re.compile(x, re.M | re.S)
+
+        # lexing rules for tags
+        tag_rules = [
+            (whitespace_re, TOKEN_WHITESPACE, None),
+            (float_re, TOKEN_FLOAT, None),
+            (integer_re, TOKEN_INTEGER, None),
+            (name_re, TOKEN_NAME, None),
+            (string_re, TOKEN_STRING, None),
+            (operator_re, TOKEN_OPERATOR, None),
+        ]
+
+        # assemble the root lexing rule. because "|" is ungreedy
+        # we have to sort by length so that the lexer continues working
+        # as expected when we have parsing rules like <% for block and
+        # <%= for variables. (if someone wants asp like syntax)
+        # variables are just part of the rules if variable processing
+        # is required.
+        root_tag_rules = compile_rules(environment)
+
+        # block suffix if trimming is enabled
+        block_suffix_re = environment.trim_blocks and "\\n?" or ""
+
+        # If lstrip is enabled, it should not be applied if there is any
+        # non-whitespace between the newline and block.
+        self.lstrip_unless_re = c(r"[^ \t]") if environment.lstrip_blocks else None
+
+        self.newline_sequence = environment.newline_sequence
+        self.keep_trailing_newline = environment.keep_trailing_newline
+
+        # global lexing rules
+        self.rules = {
+            "root": [
+                # directives
+                (
+                    c(
+                        "(.*?)(?:%s)"
+                        % "|".join(
+                            [
+                                r"(?P<raw_begin>%s(\-|\+|)\s*raw\s*(?:\-%s\s*|%s))"
+                                % (
+                                    e(environment.block_start_string),
+                                    e(environment.block_end_string),
+                                    e(environment.block_end_string),
+                                )
+                            ]
+                            + [
+                                r"(?P<%s>%s(\-|\+|))" % (n, r)
+                                for n, r in root_tag_rules
+                            ]
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, "#bygroup"),
+                    "#bygroup",
+                ),
+                # data
+                (c(".+"), TOKEN_DATA, None),
+            ],
+            # comments
+            TOKEN_COMMENT_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:\-%s\s*|%s)%s)"
+                        % (
+                            e(environment.comment_end_string),
+                            e(environment.comment_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    (TOKEN_COMMENT, TOKEN_COMMENT_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of comment tag"),), None),
+            ],
+            # blocks
+            TOKEN_BLOCK_BEGIN: [
+                (
+                    c(
+                        r"(?:\-%s\s*|%s)%s"
+                        % (
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    TOKEN_BLOCK_END,
+                    "#pop",
+                ),
+            ]
+            + tag_rules,
+            # variables
+            TOKEN_VARIABLE_BEGIN: [
+                (
+                    c(
+                        r"\-%s\s*|%s"
+                        % (
+                            e(environment.variable_end_string),
+                            e(environment.variable_end_string),
+                        )
+                    ),
+                    TOKEN_VARIABLE_END,
+                    "#pop",
+                )
+            ]
+            + tag_rules,
+            # raw block
+            TOKEN_RAW_BEGIN: [
+                (
+                    c(
+                        r"(.*?)((?:%s(\-|\+|))\s*endraw\s*(?:\-%s\s*|%s%s))"
+                        % (
+                            e(environment.block_start_string),
+                            e(environment.block_end_string),
+                            e(environment.block_end_string),
+                            block_suffix_re,
+                        )
+                    ),
+                    OptionalLStrip(TOKEN_DATA, TOKEN_RAW_END),
+                    "#pop",
+                ),
+                (c("(.)"), (Failure("Missing end of raw directive"),), None),
+            ],
+            # line statements
+            TOKEN_LINESTATEMENT_BEGIN: [
+                (c(r"\s*(\n|$)"), TOKEN_LINESTATEMENT_END, "#pop")
+            ]
+            + tag_rules,
+            # line comments
+            TOKEN_LINECOMMENT_BEGIN: [
+                (
+                    c(r"(.*?)()(?=\n|$)"),
+                    (TOKEN_LINECOMMENT, TOKEN_LINECOMMENT_END),
+                    "#pop",
+                )
+            ],
+        }
+
+    def _normalize_newlines(self, value):
+        """Called for strings and template data to normalize it to unicode."""
+        return newline_re.sub(self.newline_sequence, value)
+
+    def tokenize(self, source, name=None, filename=None, state=None):
+        """Calls tokeniter + tokenize and wraps it in a token stream."""
+        stream = self.tokeniter(source, name, filename, state)
+        return TokenStream(self.wrap(stream, name, filename), name, filename)
+
+    def wrap(self, stream, name=None, filename=None):
+        """This is called with the stream as returned by `tokenize` and wraps
+        every token in a :class:`Token` and converts the value.
+        """
+        for lineno, token, value in stream:
+            if token in ignored_tokens:
+                continue
+            elif token == TOKEN_LINESTATEMENT_BEGIN:
+                token = TOKEN_BLOCK_BEGIN
+            elif token == TOKEN_LINESTATEMENT_END:
+                token = TOKEN_BLOCK_END
+            # we are not interested in those tokens in the parser
+            elif token in (TOKEN_RAW_BEGIN, TOKEN_RAW_END):
+                continue
+            elif token == TOKEN_DATA:
+                value = self._normalize_newlines(value)
+            elif token == "keyword":
+                token = value
+            elif token == TOKEN_NAME:
+                value = str(value)
+                if check_ident and not value.isidentifier():
+                    raise TemplateSyntaxError(
+                        "Invalid character in identifier", lineno, name, filename
+                    )
+            elif token == TOKEN_STRING:
+                # try to unescape string
+                try:
+                    value = (
+                        self._normalize_newlines(value[1:-1])
+                        .encode("ascii", "backslashreplace")
+                        .decode("unicode-escape")
+                    )
+                except Exception as e:
+                    msg = str(e).split(":")[-1].strip()
+                    raise TemplateSyntaxError(msg, lineno, name, filename)
+            elif token == TOKEN_INTEGER:
+                value = int(value.replace("_", ""))
+            elif token == TOKEN_FLOAT:
+                # remove all "_" first to support more Python versions
+                value = literal_eval(value.replace("_", ""))
+            elif token == TOKEN_OPERATOR:
+                token = operators[value]
+            yield Token(lineno, token, value)
+
+    def tokeniter(self, source, name, filename=None, state=None):
+        """This method tokenizes the text and returns the tokens in a
+        generator.  Use this method if you just want to tokenize a template.
+        """
+        source = text_type(source)
+        lines = source.splitlines()
+        if self.keep_trailing_newline and source:
+            for newline in ("\r\n", "\r", "\n"):
+                if source.endswith(newline):
+                    lines.append("")
+                    break
+        source = "\n".join(lines)
+        pos = 0
+        lineno = 1
+        stack = ["root"]
+        if state is not None and state != "root":
+            assert state in ("variable", "block"), "invalid state"
+            stack.append(state + "_begin")
+        statetokens = self.rules[stack[-1]]
+        source_length = len(source)
+        balancing_stack = []
+        lstrip_unless_re = self.lstrip_unless_re
+        newlines_stripped = 0
+        line_starting = True
+
+        while 1:
+            # tokenizer loop
+            for regex, tokens, new_state in statetokens:
+                m = regex.match(source, pos)
+                # if no match we try again with the next rule
+                if m is None:
+                    continue
+
+                # we only match blocks and variables if braces / parentheses
+                # are balanced. continue parsing with the lower rule which
+                # is the operator rule. do this only if the end tags look
+                # like operators
+                if balancing_stack and tokens in (
+                    TOKEN_VARIABLE_END,
+                    TOKEN_BLOCK_END,
+                    TOKEN_LINESTATEMENT_END,
+                ):
+                    continue
+
+                # tuples support more options
+                if isinstance(tokens, tuple):
+                    groups = m.groups()
+
+                    if isinstance(tokens, OptionalLStrip):
+                        # Rule supports lstrip. Match will look like
+                        # text, block type, whitespace control, type, control, ...
+                        text = groups[0]
+
+                        # Skipping the text and first type, every other group is the
+                        # whitespace control for each type. One of the groups will be
+                        # -, +, or empty string instead of None.
+                        strip_sign = next(g for g in groups[2::2] if g is not None)
+
+                        if strip_sign == "-":
+                            # Strip all whitespace between the text and the tag.
+                            stripped = text.rstrip()
+                            newlines_stripped = text[len(stripped) :].count("\n")
+                            groups = (stripped,) + groups[1:]
+                        elif (
+                            # Not marked for preserving whitespace.
+                            strip_sign != "+"
+                            # lstrip is enabled.
+                            and lstrip_unless_re is not None
+                            # Not a variable expression.
+                            and not m.groupdict().get(TOKEN_VARIABLE_BEGIN)
+                        ):
+                            # The start of text between the last newline and the tag.
+                            l_pos = text.rfind("\n") + 1
+                            if l_pos > 0 or line_starting:
+                                # If there's only whitespace between the newline and the
+                                # tag, strip it.
+                                if not lstrip_unless_re.search(text, l_pos):
+                                    groups = (text[:l_pos],) + groups[1:]
+
+                    for idx, token in enumerate(tokens):
+                        # failure group
+                        if token.__class__ is Failure:
+                            raise token(lineno, filename)
+                        # bygroup is a bit more complex, in that case we
+                        # yield for the current token the first named
+                        # group that matched
+                        elif token == "#bygroup":
+                            for key, value in iteritems(m.groupdict()):
+                                if value is not None:
+                                    yield lineno, key, value
+                                    lineno += value.count("\n")
+                                    break
+                            else:
+                                raise RuntimeError(
+                                    "%r wanted to resolve "
+                                    "the token dynamically"
+                                    " but no group matched" % regex
+                                )
+                        # normal group
+                        else:
+                            data = groups[idx]
+                            if data or token not in ignore_if_empty:
+                                yield lineno, token, data
+                            lineno += data.count("\n") + newlines_stripped
+                            newlines_stripped = 0
+
+                # strings as token just are yielded as it.
+                else:
+                    data = m.group()
+                    # update brace/parentheses balance
+                    if tokens == TOKEN_OPERATOR:
+                        if data == "{":
+                            balancing_stack.append("}")
+                        elif data == "(":
+                            balancing_stack.append(")")
+                        elif data == "[":
+                            balancing_stack.append("]")
+                        elif data in ("}", ")", "]"):
+                            if not balancing_stack:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s'" % data, lineno, name, filename
+                                )
+                            expected_op = balancing_stack.pop()
+                            if expected_op != data:
+                                raise TemplateSyntaxError(
+                                    "unexpected '%s', "
+                                    "expected '%s'" % (data, expected_op),
+                                    lineno,
+                                    name,
+                                    filename,
+                                )
+                    # yield items
+                    if data or tokens not in ignore_if_empty:
+                        yield lineno, tokens, data
+                    lineno += data.count("\n")
+
+                line_starting = m.group()[-1:] == "\n"
+
+                # fetch new position into new variable so that we can check
+                # if there is a internal parsing error which would result
+                # in an infinite loop
+                pos2 = m.end()
+
+                # handle state changes
+                if new_state is not None:
+                    # remove the uppermost state
+                    if new_state == "#pop":
+                        stack.pop()
+                    # resolve the new state by group checking
+                    elif new_state == "#bygroup":
+                        for key, value in iteritems(m.groupdict()):
+                            if value is not None:
+                                stack.append(key)
+                                break
+                        else:
+                            raise RuntimeError(
+                                "%r wanted to resolve the "
+                                "new state dynamically but"
+                                " no group matched" % regex
+                            )
+                    # direct state name given
+                    else:
+                        stack.append(new_state)
+                    statetokens = self.rules[stack[-1]]
+                # we are still at the same position and no stack change.
+                # this means a loop without break condition, avoid that and
+                # raise error
+                elif pos2 == pos:
+                    raise RuntimeError(
+                        "%r yielded empty string without stack change" % regex
+                    )
+                # publish new function and start again
+                pos = pos2
+                break
+            # if loop terminated without break we haven't found a single match
+            # either we are at the end of the file or we have a problem
+            else:
+                # end of text
+                if pos >= source_length:
+                    return
+                # something went wrong
+                raise TemplateSyntaxError(
+                    "unexpected char %r at %d" % (source[pos], pos),
+                    lineno,
+                    name,
+                    filename,
+                )
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/loaders.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/loaders.py
new file mode 100644
index 0000000000000000000000000000000000000000..457c4b59a72173f726a6aa9e980d2d321ce1e183
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/loaders.py
@@ -0,0 +1,504 @@
+# -*- coding: utf-8 -*-
+"""API and implementations for loading templates from different data
+sources.
+"""
+import os
+import sys
+import weakref
+from hashlib import sha1
+from os import path
+from types import ModuleType
+
+from ._compat import abc
+from ._compat import fspath
+from ._compat import iteritems
+from ._compat import string_types
+from .exceptions import TemplateNotFound
+from .utils import internalcode
+from .utils import open_if_exists
+
+
+def split_template_path(template):
+    """Split a path into segments and perform a sanity check.  If it detects
+    '..' in the path it will raise a `TemplateNotFound` error.
+    """
+    pieces = []
+    for piece in template.split("/"):
+        if (
+            path.sep in piece
+            or (path.altsep and path.altsep in piece)
+            or piece == path.pardir
+        ):
+            raise TemplateNotFound(template)
+        elif piece and piece != ".":
+            pieces.append(piece)
+    return pieces
+
+
+class BaseLoader(object):
+    """Baseclass for all loaders.  Subclass this and override `get_source` to
+    implement a custom loading mechanism.  The environment provides a
+    `get_template` method that calls the loader's `load` method to get the
+    :class:`Template` object.
+
+    A very basic example for a loader that looks up templates on the file
+    system could look like this::
+
+        from jinja2 import BaseLoader, TemplateNotFound
+        from os.path import join, exists, getmtime
+
+        class MyLoader(BaseLoader):
+
+            def __init__(self, path):
+                self.path = path
+
+            def get_source(self, environment, template):
+                path = join(self.path, template)
+                if not exists(path):
+                    raise TemplateNotFound(template)
+                mtime = getmtime(path)
+                with file(path) as f:
+                    source = f.read().decode('utf-8')
+                return source, path, lambda: mtime == getmtime(path)
+    """
+
+    #: if set to `False` it indicates that the loader cannot provide access
+    #: to the source of templates.
+    #:
+    #: .. versionadded:: 2.4
+    has_source_access = True
+
+    def get_source(self, environment, template):
+        """Get the template source, filename and reload helper for a template.
+        It's passed the environment and template name and has to return a
+        tuple in the form ``(source, filename, uptodate)`` or raise a
+        `TemplateNotFound` error if it can't locate the template.
+
+        The source part of the returned tuple must be the source of the
+        template as unicode string or a ASCII bytestring.  The filename should
+        be the name of the file on the filesystem if it was loaded from there,
+        otherwise `None`.  The filename is used by python for the tracebacks
+        if no loader extension is used.
+
+        The last item in the tuple is the `uptodate` function.  If auto
+        reloading is enabled it's always called to check if the template
+        changed.  No arguments are passed so the function must store the
+        old state somewhere (for example in a closure).  If it returns `False`
+        the template will be reloaded.
+        """
+        if not self.has_source_access:
+            raise RuntimeError(
+                "%s cannot provide access to the source" % self.__class__.__name__
+            )
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        """Iterates over all templates.  If the loader does not support that
+        it should raise a :exc:`TypeError` which is the default behavior.
+        """
+        raise TypeError("this loader cannot iterate over all templates")
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        """Loads a template.  This method looks up the template in the cache
+        or loads one by calling :meth:`get_source`.  Subclasses should not
+        override this method as loaders working on collections of other
+        loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
+        will not call this method but `get_source` directly.
+        """
+        code = None
+        if globals is None:
+            globals = {}
+
+        # first we try to get the source for this template together
+        # with the filename and the uptodate function.
+        source, filename, uptodate = self.get_source(environment, name)
+
+        # try to load the code from the bytecode cache if there is a
+        # bytecode cache configured.
+        bcc = environment.bytecode_cache
+        if bcc is not None:
+            bucket = bcc.get_bucket(environment, name, filename, source)
+            code = bucket.code
+
+        # if we don't have code so far (not cached, no longer up to
+        # date) etc. we compile the template
+        if code is None:
+            code = environment.compile(source, name, filename)
+
+        # if the bytecode cache is available and the bucket doesn't
+        # have a code so far, we give the bucket the new code and put
+        # it back to the bytecode cache.
+        if bcc is not None and bucket.code is None:
+            bucket.code = code
+            bcc.set_bucket(bucket)
+
+        return environment.template_class.from_code(
+            environment, code, globals, uptodate
+        )
+
+
+class FileSystemLoader(BaseLoader):
+    """Loads templates from the file system.  This loader can find templates
+    in folders on the file system and is the preferred way to load them.
+
+    The loader takes the path to the templates as string, or if multiple
+    locations are wanted a list of them which is then looked up in the
+    given order::
+
+    >>> loader = FileSystemLoader('/path/to/templates')
+    >>> loader = FileSystemLoader(['/path/to/templates', '/other/path'])
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.
+
+    To follow symbolic links, set the *followlinks* parameter to ``True``::
+
+    >>> loader = FileSystemLoader('/path/to/templates', followlinks=True)
+
+    .. versionchanged:: 2.8
+       The ``followlinks`` parameter was added.
+    """
+
+    def __init__(self, searchpath, encoding="utf-8", followlinks=False):
+        if not isinstance(searchpath, abc.Iterable) or isinstance(
+            searchpath, string_types
+        ):
+            searchpath = [searchpath]
+
+        # In Python 3.5, os.path.join doesn't support Path. This can be
+        # simplified to list(searchpath) when Python 3.5 is dropped.
+        self.searchpath = [fspath(p) for p in searchpath]
+
+        self.encoding = encoding
+        self.followlinks = followlinks
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        for searchpath in self.searchpath:
+            filename = path.join(searchpath, *pieces)
+            f = open_if_exists(filename)
+            if f is None:
+                continue
+            try:
+                contents = f.read().decode(self.encoding)
+            finally:
+                f.close()
+
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+            return contents, filename, uptodate
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        found = set()
+        for searchpath in self.searchpath:
+            walk_dir = os.walk(searchpath, followlinks=self.followlinks)
+            for dirpath, _, filenames in walk_dir:
+                for filename in filenames:
+                    template = (
+                        os.path.join(dirpath, filename)[len(searchpath) :]
+                        .strip(os.path.sep)
+                        .replace(os.path.sep, "/")
+                    )
+                    if template[:2] == "./":
+                        template = template[2:]
+                    if template not in found:
+                        found.add(template)
+        return sorted(found)
+
+
+class PackageLoader(BaseLoader):
+    """Load templates from python eggs or packages.  It is constructed with
+    the name of the python package and the path to the templates in that
+    package::
+
+        loader = PackageLoader('mypackage', 'views')
+
+    If the package path is not given, ``'templates'`` is assumed.
+
+    Per default the template encoding is ``'utf-8'`` which can be changed
+    by setting the `encoding` parameter to something else.  Due to the nature
+    of eggs it's only possible to reload templates if the package was loaded
+    from the file system and not a zip file.
+    """
+
+    def __init__(self, package_name, package_path="templates", encoding="utf-8"):
+        from pkg_resources import DefaultProvider
+        from pkg_resources import get_provider
+        from pkg_resources import ResourceManager
+
+        provider = get_provider(package_name)
+        self.encoding = encoding
+        self.manager = ResourceManager()
+        self.filesystem_bound = isinstance(provider, DefaultProvider)
+        self.provider = provider
+        self.package_path = package_path
+
+    def get_source(self, environment, template):
+        pieces = split_template_path(template)
+        p = "/".join((self.package_path,) + tuple(pieces))
+
+        if not self.provider.has_resource(p):
+            raise TemplateNotFound(template)
+
+        filename = uptodate = None
+
+        if self.filesystem_bound:
+            filename = self.provider.get_resource_filename(self.manager, p)
+            mtime = path.getmtime(filename)
+
+            def uptodate():
+                try:
+                    return path.getmtime(filename) == mtime
+                except OSError:
+                    return False
+
+        source = self.provider.get_resource_string(self.manager, p)
+        return source.decode(self.encoding), filename, uptodate
+
+    def list_templates(self):
+        path = self.package_path
+
+        if path[:2] == "./":
+            path = path[2:]
+        elif path == ".":
+            path = ""
+
+        offset = len(path)
+        results = []
+
+        def _walk(path):
+            for filename in self.provider.resource_listdir(path):
+                fullname = path + "/" + filename
+
+                if self.provider.resource_isdir(fullname):
+                    _walk(fullname)
+                else:
+                    results.append(fullname[offset:].lstrip("/"))
+
+        _walk(path)
+        results.sort()
+        return results
+
+
+class DictLoader(BaseLoader):
+    """Loads a template from a python dict.  It's passed a dict of unicode
+    strings bound to template names.  This loader is useful for unittesting:
+
+    >>> loader = DictLoader({'index.html': 'source here'})
+
+    Because auto reloading is rarely useful this is disabled per default.
+    """
+
+    def __init__(self, mapping):
+        self.mapping = mapping
+
+    def get_source(self, environment, template):
+        if template in self.mapping:
+            source = self.mapping[template]
+            return source, None, lambda: source == self.mapping.get(template)
+        raise TemplateNotFound(template)
+
+    def list_templates(self):
+        return sorted(self.mapping)
+
+
+class FunctionLoader(BaseLoader):
+    """A loader that is passed a function which does the loading.  The
+    function receives the name of the template and has to return either
+    an unicode string with the template source, a tuple in the form ``(source,
+    filename, uptodatefunc)`` or `None` if the template does not exist.
+
+    >>> def load_template(name):
+    ...     if name == 'index.html':
+    ...         return '...'
+    ...
+    >>> loader = FunctionLoader(load_template)
+
+    The `uptodatefunc` is a function that is called if autoreload is enabled
+    and has to return `True` if the template is still up to date.  For more
+    details have a look at :meth:`BaseLoader.get_source` which has the same
+    return value.
+    """
+
+    def __init__(self, load_func):
+        self.load_func = load_func
+
+    def get_source(self, environment, template):
+        rv = self.load_func(template)
+        if rv is None:
+            raise TemplateNotFound(template)
+        elif isinstance(rv, string_types):
+            return rv, None, None
+        return rv
+
+
+class PrefixLoader(BaseLoader):
+    """A loader that is passed a dict of loaders where each loader is bound
+    to a prefix.  The prefix is delimited from the template by a slash per
+    default, which can be changed by setting the `delimiter` argument to
+    something else::
+
+        loader = PrefixLoader({
+            'app1':     PackageLoader('mypackage.app1'),
+            'app2':     PackageLoader('mypackage.app2')
+        })
+
+    By loading ``'app1/index.html'`` the file from the app1 package is loaded,
+    by loading ``'app2/index.html'`` the file from the second.
+    """
+
+    def __init__(self, mapping, delimiter="/"):
+        self.mapping = mapping
+        self.delimiter = delimiter
+
+    def get_loader(self, template):
+        try:
+            prefix, name = template.split(self.delimiter, 1)
+            loader = self.mapping[prefix]
+        except (ValueError, KeyError):
+            raise TemplateNotFound(template)
+        return loader, name
+
+    def get_source(self, environment, template):
+        loader, name = self.get_loader(template)
+        try:
+            return loader.get_source(environment, name)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        loader, local_name = self.get_loader(name)
+        try:
+            return loader.load(environment, local_name, globals)
+        except TemplateNotFound:
+            # re-raise the exception with the correct filename here.
+            # (the one that includes the prefix)
+            raise TemplateNotFound(name)
+
+    def list_templates(self):
+        result = []
+        for prefix, loader in iteritems(self.mapping):
+            for template in loader.list_templates():
+                result.append(prefix + self.delimiter + template)
+        return result
+
+
+class ChoiceLoader(BaseLoader):
+    """This loader works like the `PrefixLoader` just that no prefix is
+    specified.  If a template could not be found by one loader the next one
+    is tried.
+
+    >>> loader = ChoiceLoader([
+    ...     FileSystemLoader('/path/to/user/templates'),
+    ...     FileSystemLoader('/path/to/system/templates')
+    ... ])
+
+    This is useful if you want to allow users to override builtin templates
+    from a different location.
+    """
+
+    def __init__(self, loaders):
+        self.loaders = loaders
+
+    def get_source(self, environment, template):
+        for loader in self.loaders:
+            try:
+                return loader.get_source(environment, template)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(template)
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        for loader in self.loaders:
+            try:
+                return loader.load(environment, name, globals)
+            except TemplateNotFound:
+                pass
+        raise TemplateNotFound(name)
+
+    def list_templates(self):
+        found = set()
+        for loader in self.loaders:
+            found.update(loader.list_templates())
+        return sorted(found)
+
+
+class _TemplateModule(ModuleType):
+    """Like a normal module but with support for weak references"""
+
+
+class ModuleLoader(BaseLoader):
+    """This loader loads templates from precompiled templates.
+
+    Example usage:
+
+    >>> loader = ChoiceLoader([
+    ...     ModuleLoader('/path/to/compiled/templates'),
+    ...     FileSystemLoader('/path/to/templates')
+    ... ])
+
+    Templates can be precompiled with :meth:`Environment.compile_templates`.
+    """
+
+    has_source_access = False
+
+    def __init__(self, path):
+        package_name = "_jinja2_module_templates_%x" % id(self)
+
+        # create a fake module that looks for the templates in the
+        # path given.
+        mod = _TemplateModule(package_name)
+
+        if not isinstance(path, abc.Iterable) or isinstance(path, string_types):
+            path = [path]
+
+        mod.__path__ = [fspath(p) for p in path]
+
+        sys.modules[package_name] = weakref.proxy(
+            mod, lambda x: sys.modules.pop(package_name, None)
+        )
+
+        # the only strong reference, the sys.modules entry is weak
+        # so that the garbage collector can remove it once the
+        # loader that created it goes out of business.
+        self.module = mod
+        self.package_name = package_name
+
+    @staticmethod
+    def get_template_key(name):
+        return "tmpl_" + sha1(name.encode("utf-8")).hexdigest()
+
+    @staticmethod
+    def get_module_filename(name):
+        return ModuleLoader.get_template_key(name) + ".py"
+
+    @internalcode
+    def load(self, environment, name, globals=None):
+        key = self.get_template_key(name)
+        module = "%s.%s" % (self.package_name, key)
+        mod = getattr(self.module, module, None)
+        if mod is None:
+            try:
+                mod = __import__(module, None, None, ["root"])
+            except ImportError:
+                raise TemplateNotFound(name)
+
+            # remove the entry from sys.modules, we only want the attribute
+            # on the module object we have stored on the loader.
+            sys.modules.pop(module, None)
+
+        return environment.template_class.from_module_dict(
+            environment, mod.__dict__, globals
+        )
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/meta.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/meta.py
new file mode 100644
index 0000000000000000000000000000000000000000..3795aace59da12815544dfcd5bb9973e196f7a43
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/meta.py
@@ -0,0 +1,101 @@
+# -*- coding: utf-8 -*-
+"""Functions that expose information about templates that might be
+interesting for introspection.
+"""
+from . import nodes
+from ._compat import iteritems
+from ._compat import string_types
+from .compiler import CodeGenerator
+
+
+class TrackingCodeGenerator(CodeGenerator):
+    """We abuse the code generator for introspection."""
+
+    def __init__(self, environment):
+        CodeGenerator.__init__(self, environment, "<introspection>", "<introspection>")
+        self.undeclared_identifiers = set()
+
+    def write(self, x):
+        """Don't write."""
+
+    def enter_frame(self, frame):
+        """Remember all undeclared identifiers."""
+        CodeGenerator.enter_frame(self, frame)
+        for _, (action, param) in iteritems(frame.symbols.loads):
+            if action == "resolve" and param not in self.environment.globals:
+                self.undeclared_identifiers.add(param)
+
+
+def find_undeclared_variables(ast):
+    """Returns a set of all variables in the AST that will be looked up from
+    the context at runtime.  Because at compile time it's not known which
+    variables will be used depending on the path the execution takes at
+    runtime, all variables are returned.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% set foo = 42 %}{{ bar + foo }}')
+    >>> meta.find_undeclared_variables(ast) == set(['bar'])
+    True
+
+    .. admonition:: Implementation
+
+       Internally the code generator is used for finding undeclared variables.
+       This is good to know because the code generator might raise a
+       :exc:`TemplateAssertionError` during compilation and as a matter of
+       fact this function can currently raise that exception as well.
+    """
+    codegen = TrackingCodeGenerator(ast.environment)
+    codegen.visit(ast)
+    return codegen.undeclared_identifiers
+
+
+def find_referenced_templates(ast):
+    """Finds all the referenced templates from the AST.  This will return an
+    iterator over all the hardcoded template extensions, inclusions and
+    imports.  If dynamic inheritance or inclusion is used, `None` will be
+    yielded.
+
+    >>> from jinja2 import Environment, meta
+    >>> env = Environment()
+    >>> ast = env.parse('{% extends "layout.html" %}{% include helper %}')
+    >>> list(meta.find_referenced_templates(ast))
+    ['layout.html', None]
+
+    This function is useful for dependency tracking.  For example if you want
+    to rebuild parts of the website after a layout template has changed.
+    """
+    for node in ast.find_all(
+        (nodes.Extends, nodes.FromImport, nodes.Import, nodes.Include)
+    ):
+        if not isinstance(node.template, nodes.Const):
+            # a tuple with some non consts in there
+            if isinstance(node.template, (nodes.Tuple, nodes.List)):
+                for template_name in node.template.items:
+                    # something const, only yield the strings and ignore
+                    # non-string consts that really just make no sense
+                    if isinstance(template_name, nodes.Const):
+                        if isinstance(template_name.value, string_types):
+                            yield template_name.value
+                    # something dynamic in there
+                    else:
+                        yield None
+            # something dynamic we don't know about here
+            else:
+                yield None
+            continue
+        # constant is a basestring, direct template name
+        if isinstance(node.template.value, string_types):
+            yield node.template.value
+        # a tuple or list (latter *should* not happen) made of consts,
+        # yield the consts that are strings.  We could warn here for
+        # non string values
+        elif isinstance(node, nodes.Include) and isinstance(
+            node.template.value, (tuple, list)
+        ):
+            for template_name in node.template.value:
+                if isinstance(template_name, string_types):
+                    yield template_name
+        # something else we don't care about, we could warn here
+        else:
+            yield None
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nativetypes.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nativetypes.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9ead4e2bbf09b881993b4c7112d83c684604c5c
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nativetypes.py
@@ -0,0 +1,94 @@
+from ast import literal_eval
+from itertools import chain
+from itertools import islice
+
+from . import nodes
+from ._compat import text_type
+from .compiler import CodeGenerator
+from .compiler import has_safe_repr
+from .environment import Environment
+from .environment import Template
+
+
+def native_concat(nodes):
+    """Return a native Python type from the list of compiled nodes. If
+    the result is a single node, its value is returned. Otherwise, the
+    nodes are concatenated as strings. If the result can be parsed with
+    :func:`ast.literal_eval`, the parsed value is returned. Otherwise,
+    the string is returned.
+
+    :param nodes: Iterable of nodes to concatenate.
+    """
+    head = list(islice(nodes, 2))
+
+    if not head:
+        return None
+
+    if len(head) == 1:
+        raw = head[0]
+    else:
+        raw = u"".join([text_type(v) for v in chain(head, nodes)])
+
+    try:
+        return literal_eval(raw)
+    except (ValueError, SyntaxError, MemoryError):
+        return raw
+
+
+class NativeCodeGenerator(CodeGenerator):
+    """A code generator which renders Python types by not adding
+    ``to_string()`` around output nodes.
+    """
+
+    @staticmethod
+    def _default_finalize(value):
+        return value
+
+    def _output_const_repr(self, group):
+        return repr(u"".join([text_type(v) for v in group]))
+
+    def _output_child_to_const(self, node, frame, finalize):
+        const = node.as_const(frame.eval_ctx)
+
+        if not has_safe_repr(const):
+            raise nodes.Impossible()
+
+        if isinstance(node, nodes.TemplateData):
+            return const
+
+        return finalize.const(const)
+
+    def _output_child_pre(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(finalize.src)
+
+    def _output_child_post(self, node, frame, finalize):
+        if finalize.src is not None:
+            self.write(")")
+
+
+class NativeEnvironment(Environment):
+    """An environment that renders templates to native Python types."""
+
+    code_generator_class = NativeCodeGenerator
+
+
+class NativeTemplate(Template):
+    environment_class = NativeEnvironment
+
+    def render(self, *args, **kwargs):
+        """Render the template to produce a native Python type. If the
+        result is a single node, its value is returned. Otherwise, the
+        nodes are concatenated as strings. If the result can be parsed
+        with :func:`ast.literal_eval`, the parsed value is returned.
+        Otherwise, the string is returned.
+        """
+        vars = dict(*args, **kwargs)
+
+        try:
+            return native_concat(self.root_render_func(self.new_context(vars)))
+        except Exception:
+            return self.environment.handle_exception()
+
+
+NativeEnvironment.template_class = NativeTemplate
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nodes.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..95bd614a140a8cd8da3642831650215c7e8ac105
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/nodes.py
@@ -0,0 +1,1088 @@
+# -*- coding: utf-8 -*-
+"""AST nodes generated by the parser for the compiler. Also provides
+some node tree helper functions used by the parser and compiler in order
+to normalize nodes.
+"""
+import operator
+from collections import deque
+
+from markupsafe import Markup
+
+from ._compat import izip
+from ._compat import PY2
+from ._compat import text_type
+from ._compat import with_metaclass
+
+_binop_to_func = {
+    "*": operator.mul,
+    "/": operator.truediv,
+    "//": operator.floordiv,
+    "**": operator.pow,
+    "%": operator.mod,
+    "+": operator.add,
+    "-": operator.sub,
+}
+
+_uaop_to_func = {"not": operator.not_, "+": operator.pos, "-": operator.neg}
+
+_cmpop_to_func = {
+    "eq": operator.eq,
+    "ne": operator.ne,
+    "gt": operator.gt,
+    "gteq": operator.ge,
+    "lt": operator.lt,
+    "lteq": operator.le,
+    "in": lambda a, b: a in b,
+    "notin": lambda a, b: a not in b,
+}
+
+
+class Impossible(Exception):
+    """Raised if the node could not perform a requested action."""
+
+
+class NodeType(type):
+    """A metaclass for nodes that handles the field and attribute
+    inheritance.  fields and attributes from the parent class are
+    automatically forwarded to the child."""
+
+    def __new__(mcs, name, bases, d):
+        for attr in "fields", "attributes":
+            storage = []
+            storage.extend(getattr(bases[0], attr, ()))
+            storage.extend(d.get(attr, ()))
+            assert len(bases) == 1, "multiple inheritance not allowed"
+            assert len(storage) == len(set(storage)), "layout conflict"
+            d[attr] = tuple(storage)
+        d.setdefault("abstract", False)
+        return type.__new__(mcs, name, bases, d)
+
+
+class EvalContext(object):
+    """Holds evaluation time information.  Custom attributes can be attached
+    to it in extensions.
+    """
+
+    def __init__(self, environment, template_name=None):
+        self.environment = environment
+        if callable(environment.autoescape):
+            self.autoescape = environment.autoescape(template_name)
+        else:
+            self.autoescape = environment.autoescape
+        self.volatile = False
+
+    def save(self):
+        return self.__dict__.copy()
+
+    def revert(self, old):
+        self.__dict__.clear()
+        self.__dict__.update(old)
+
+
+def get_eval_context(node, ctx):
+    if ctx is None:
+        if node.environment is None:
+            raise RuntimeError(
+                "if no eval context is passed, the "
+                "node must have an attached "
+                "environment."
+            )
+        return EvalContext(node.environment)
+    return ctx
+
+
+class Node(with_metaclass(NodeType, object)):
+    """Baseclass for all Jinja nodes.  There are a number of nodes available
+    of different types.  There are four major types:
+
+    -   :class:`Stmt`: statements
+    -   :class:`Expr`: expressions
+    -   :class:`Helper`: helper nodes
+    -   :class:`Template`: the outermost wrapper node
+
+    All nodes have fields and attributes.  Fields may be other nodes, lists,
+    or arbitrary values.  Fields are passed to the constructor as regular
+    positional arguments, attributes as keyword arguments.  Each node has
+    two attributes: `lineno` (the line number of the node) and `environment`.
+    The `environment` attribute is set at the end of the parsing process for
+    all nodes automatically.
+    """
+
+    fields = ()
+    attributes = ("lineno", "environment")
+    abstract = True
+
+    def __init__(self, *fields, **attributes):
+        if self.abstract:
+            raise TypeError("abstract nodes are not instantiable")
+        if fields:
+            if len(fields) != len(self.fields):
+                if not self.fields:
+                    raise TypeError("%r takes 0 arguments" % self.__class__.__name__)
+                raise TypeError(
+                    "%r takes 0 or %d argument%s"
+                    % (
+                        self.__class__.__name__,
+                        len(self.fields),
+                        len(self.fields) != 1 and "s" or "",
+                    )
+                )
+            for name, arg in izip(self.fields, fields):
+                setattr(self, name, arg)
+        for attr in self.attributes:
+            setattr(self, attr, attributes.pop(attr, None))
+        if attributes:
+            raise TypeError("unknown attribute %r" % next(iter(attributes)))
+
+    def iter_fields(self, exclude=None, only=None):
+        """This method iterates over all fields that are defined and yields
+        ``(key, value)`` tuples.  Per default all fields are returned, but
+        it's possible to limit that to some fields by providing the `only`
+        parameter or to exclude some using the `exclude` parameter.  Both
+        should be sets or tuples of field names.
+        """
+        for name in self.fields:
+            if (
+                (exclude is only is None)
+                or (exclude is not None and name not in exclude)
+                or (only is not None and name in only)
+            ):
+                try:
+                    yield name, getattr(self, name)
+                except AttributeError:
+                    pass
+
+    def iter_child_nodes(self, exclude=None, only=None):
+        """Iterates over all direct child nodes of the node.  This iterates
+        over all fields and yields the values of they are nodes.  If the value
+        of a field is a list all the nodes in that list are returned.
+        """
+        for _, item in self.iter_fields(exclude, only):
+            if isinstance(item, list):
+                for n in item:
+                    if isinstance(n, Node):
+                        yield n
+            elif isinstance(item, Node):
+                yield item
+
+    def find(self, node_type):
+        """Find the first node of a given type.  If no such node exists the
+        return value is `None`.
+        """
+        for result in self.find_all(node_type):
+            return result
+
+    def find_all(self, node_type):
+        """Find all the nodes of a given type.  If the type is a tuple,
+        the check is performed for any of the tuple items.
+        """
+        for child in self.iter_child_nodes():
+            if isinstance(child, node_type):
+                yield child
+            for result in child.find_all(node_type):
+                yield result
+
+    def set_ctx(self, ctx):
+        """Reset the context of a node and all child nodes.  Per default the
+        parser will all generate nodes that have a 'load' context as it's the
+        most common one.  This method is used in the parser to set assignment
+        targets and other nodes to a store context.
+        """
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "ctx" in node.fields:
+                node.ctx = ctx
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_lineno(self, lineno, override=False):
+        """Set the line numbers of the node and children."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            if "lineno" in node.attributes:
+                if node.lineno is None or override:
+                    node.lineno = lineno
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def set_environment(self, environment):
+        """Set the environment for all nodes."""
+        todo = deque([self])
+        while todo:
+            node = todo.popleft()
+            node.environment = environment
+            todo.extend(node.iter_child_nodes())
+        return self
+
+    def __eq__(self, other):
+        return type(self) is type(other) and tuple(self.iter_fields()) == tuple(
+            other.iter_fields()
+        )
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    # Restore Python 2 hashing behavior on Python 3
+    __hash__ = object.__hash__
+
+    def __repr__(self):
+        return "%s(%s)" % (
+            self.__class__.__name__,
+            ", ".join("%s=%r" % (arg, getattr(self, arg, None)) for arg in self.fields),
+        )
+
+    def dump(self):
+        def _dump(node):
+            if not isinstance(node, Node):
+                buf.append(repr(node))
+                return
+
+            buf.append("nodes.%s(" % node.__class__.__name__)
+            if not node.fields:
+                buf.append(")")
+                return
+            for idx, field in enumerate(node.fields):
+                if idx:
+                    buf.append(", ")
+                value = getattr(node, field)
+                if isinstance(value, list):
+                    buf.append("[")
+                    for idx, item in enumerate(value):
+                        if idx:
+                            buf.append(", ")
+                        _dump(item)
+                    buf.append("]")
+                else:
+                    _dump(value)
+            buf.append(")")
+
+        buf = []
+        _dump(self)
+        return "".join(buf)
+
+
+class Stmt(Node):
+    """Base node for all statements."""
+
+    abstract = True
+
+
+class Helper(Node):
+    """Nodes that exist in a specific context only."""
+
+    abstract = True
+
+
+class Template(Node):
+    """Node that represents a template.  This must be the outermost node that
+    is passed to the compiler.
+    """
+
+    fields = ("body",)
+
+
+class Output(Stmt):
+    """A node that holds multiple expressions which are then printed out.
+    This is used both for the `print` statement and the regular template data.
+    """
+
+    fields = ("nodes",)
+
+
+class Extends(Stmt):
+    """Represents an extends statement."""
+
+    fields = ("template",)
+
+
+class For(Stmt):
+    """The for loop.  `target` is the target for the iteration (usually a
+    :class:`Name` or :class:`Tuple`), `iter` the iterable.  `body` is a list
+    of nodes that are used as loop-body, and `else_` a list of nodes for the
+    `else` block.  If no else node exists it has to be an empty list.
+
+    For filtered nodes an expression can be stored as `test`, otherwise `None`.
+    """
+
+    fields = ("target", "iter", "body", "else_", "test", "recursive")
+
+
+class If(Stmt):
+    """If `test` is true, `body` is rendered, else `else_`."""
+
+    fields = ("test", "body", "elif_", "else_")
+
+
+class Macro(Stmt):
+    """A macro definition.  `name` is the name of the macro, `args` a list of
+    arguments and `defaults` a list of defaults if there are any.  `body` is
+    a list of nodes for the macro body.
+    """
+
+    fields = ("name", "args", "defaults", "body")
+
+
+class CallBlock(Stmt):
+    """Like a macro without a name but a call instead.  `call` is called with
+    the unnamed macro as `caller` argument this node holds.
+    """
+
+    fields = ("call", "args", "defaults", "body")
+
+
+class FilterBlock(Stmt):
+    """Node for filter sections."""
+
+    fields = ("body", "filter")
+
+
+class With(Stmt):
+    """Specific node for with statements.  In older versions of Jinja the
+    with statement was implemented on the base of the `Scope` node instead.
+
+    .. versionadded:: 2.9.3
+    """
+
+    fields = ("targets", "values", "body")
+
+
+class Block(Stmt):
+    """A node that represents a block."""
+
+    fields = ("name", "body", "scoped")
+
+
+class Include(Stmt):
+    """A node that represents the include tag."""
+
+    fields = ("template", "with_context", "ignore_missing")
+
+
+class Import(Stmt):
+    """A node that represents the import tag."""
+
+    fields = ("template", "target", "with_context")
+
+
+class FromImport(Stmt):
+    """A node that represents the from import tag.  It's important to not
+    pass unsafe names to the name attribute.  The compiler translates the
+    attribute lookups directly into getattr calls and does *not* use the
+    subscript callback of the interface.  As exported variables may not
+    start with double underscores (which the parser asserts) this is not a
+    problem for regular Jinja code, but if this node is used in an extension
+    extra care must be taken.
+
+    The list of names may contain tuples if aliases are wanted.
+    """
+
+    fields = ("template", "names", "with_context")
+
+
+class ExprStmt(Stmt):
+    """A statement that evaluates an expression and discards the result."""
+
+    fields = ("node",)
+
+
+class Assign(Stmt):
+    """Assigns an expression to a target."""
+
+    fields = ("target", "node")
+
+
+class AssignBlock(Stmt):
+    """Assigns a block to a target."""
+
+    fields = ("target", "filter", "body")
+
+
+class Expr(Node):
+    """Baseclass for all expressions."""
+
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        """Return the value of the expression as constant or raise
+        :exc:`Impossible` if this was not possible.
+
+        An :class:`EvalContext` can be provided, if none is given
+        a default context is created which requires the nodes to have
+        an attached environment.
+
+        .. versionchanged:: 2.4
+           the `eval_ctx` parameter was added.
+        """
+        raise Impossible()
+
+    def can_assign(self):
+        """Check if it's possible to assign something to this node."""
+        return False
+
+
+class BinExpr(Expr):
+    """Baseclass for all binary expressions."""
+
+    fields = ("left", "right")
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_binops
+        ):
+            raise Impossible()
+        f = _binop_to_func[self.operator]
+        try:
+            return f(self.left.as_const(eval_ctx), self.right.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class UnaryExpr(Expr):
+    """Baseclass for all unary expressions."""
+
+    fields = ("node",)
+    operator = None
+    abstract = True
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        # intercepted operators cannot be folded at compile time
+        if (
+            self.environment.sandboxed
+            and self.operator in self.environment.intercepted_unops
+        ):
+            raise Impossible()
+        f = _uaop_to_func[self.operator]
+        try:
+            return f(self.node.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+
+class Name(Expr):
+    """Looks up a name or stores a value in a name.
+    The `ctx` of the node can be one of the following values:
+
+    -   `store`: store a value in the name
+    -   `load`: load that name
+    -   `param`: like `store` but if the name was defined as function parameter.
+    """
+
+    fields = ("name", "ctx")
+
+    def can_assign(self):
+        return self.name not in ("true", "false", "none", "True", "False", "None")
+
+
+class NSRef(Expr):
+    """Reference to a namespace value assignment"""
+
+    fields = ("name", "attr")
+
+    def can_assign(self):
+        # We don't need any special checks here; NSRef assignments have a
+        # runtime check to ensure the target is a namespace object which will
+        # have been checked already as it is created using a normal assignment
+        # which goes through a `Name` node.
+        return True
+
+
+class Literal(Expr):
+    """Baseclass for literals."""
+
+    abstract = True
+
+
+class Const(Literal):
+    """All constant values.  The parser will return this node for simple
+    constants such as ``42`` or ``"foo"`` but it can be used to store more
+    complex values such as lists too.  Only constants with a safe
+    representation (objects where ``eval(repr(x)) == x`` is true).
+    """
+
+    fields = ("value",)
+
+    def as_const(self, eval_ctx=None):
+        rv = self.value
+        if (
+            PY2
+            and type(rv) is text_type
+            and self.environment.policies["compiler.ascii_str"]
+        ):
+            try:
+                rv = rv.encode("ascii")
+            except UnicodeError:
+                pass
+        return rv
+
+    @classmethod
+    def from_untrusted(cls, value, lineno=None, environment=None):
+        """Return a const object if the value is representable as
+        constant value in the generated code, otherwise it will raise
+        an `Impossible` exception.
+        """
+        from .compiler import has_safe_repr
+
+        if not has_safe_repr(value):
+            raise Impossible()
+        return cls(value, lineno=lineno, environment=environment)
+
+
+class TemplateData(Literal):
+    """A constant template string."""
+
+    fields = ("data",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        if eval_ctx.autoescape:
+            return Markup(self.data)
+        return self.data
+
+
+class Tuple(Literal):
+    """For loop unpacking and some other things like multiple arguments
+    for subscripts.  Like for :class:`Name` `ctx` specifies if the tuple
+    is used for loading the names or storing.
+    """
+
+    fields = ("items", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return tuple(x.as_const(eval_ctx) for x in self.items)
+
+    def can_assign(self):
+        for item in self.items:
+            if not item.can_assign():
+                return False
+        return True
+
+
+class List(Literal):
+    """Any list literal such as ``[1, 2, 3]``"""
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return [x.as_const(eval_ctx) for x in self.items]
+
+
+class Dict(Literal):
+    """Any dict literal such as ``{1: 2, 3: 4}``.  The items must be a list of
+    :class:`Pair` nodes.
+    """
+
+    fields = ("items",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return dict(x.as_const(eval_ctx) for x in self.items)
+
+
+class Pair(Helper):
+    """A key, value pair for dicts."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key.as_const(eval_ctx), self.value.as_const(eval_ctx)
+
+
+class Keyword(Helper):
+    """A key, value pair for keyword arguments where key is a string."""
+
+    fields = ("key", "value")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.key, self.value.as_const(eval_ctx)
+
+
+class CondExpr(Expr):
+    """A conditional expression (inline if expression).  (``{{
+    foo if bar else baz }}``)
+    """
+
+    fields = ("test", "expr1", "expr2")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.test.as_const(eval_ctx):
+            return self.expr1.as_const(eval_ctx)
+
+        # if we evaluate to an undefined object, we better do that at runtime
+        if self.expr2 is None:
+            raise Impossible()
+
+        return self.expr2.as_const(eval_ctx)
+
+
+def args_as_const(node, eval_ctx):
+    args = [x.as_const(eval_ctx) for x in node.args]
+    kwargs = dict(x.as_const(eval_ctx) for x in node.kwargs)
+
+    if node.dyn_args is not None:
+        try:
+            args.extend(node.dyn_args.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    if node.dyn_kwargs is not None:
+        try:
+            kwargs.update(node.dyn_kwargs.as_const(eval_ctx))
+        except Exception:
+            raise Impossible()
+
+    return args, kwargs
+
+
+class Filter(Expr):
+    """This node applies a filter on an expression.  `name` is the name of
+    the filter, the rest of the fields are the same as for :class:`Call`.
+
+    If the `node` of a filter is `None` the contents of the last buffer are
+    filtered.  Buffers are created by macros and filter blocks.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        if eval_ctx.volatile or self.node is None:
+            raise Impossible()
+
+        # we have to be careful here because we call filter_ below.
+        # if this variable would be called filter, 2to3 would wrap the
+        # call in a list because it is assuming we are talking about the
+        # builtin filter function here which no longer returns a list in
+        # python 3.  because of that, do not rename filter_ to filter!
+        filter_ = self.environment.filters.get(self.name)
+
+        if filter_ is None or getattr(filter_, "contextfilter", False) is True:
+            raise Impossible()
+
+        # We cannot constant handle async filters, so we need to make sure
+        # to not go down this path.
+        if eval_ctx.environment.is_async and getattr(
+            filter_, "asyncfiltervariant", False
+        ):
+            raise Impossible()
+
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        if getattr(filter_, "evalcontextfilter", False) is True:
+            args.insert(0, eval_ctx)
+        elif getattr(filter_, "environmentfilter", False) is True:
+            args.insert(0, self.environment)
+
+        try:
+            return filter_(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Test(Expr):
+    """Applies a test on an expression.  `name` is the name of the test, the
+    rest of the fields are the same as for :class:`Call`.
+    """
+
+    fields = ("node", "name", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+    def as_const(self, eval_ctx=None):
+        test = self.environment.tests.get(self.name)
+
+        if test is None:
+            raise Impossible()
+
+        eval_ctx = get_eval_context(self, eval_ctx)
+        args, kwargs = args_as_const(self, eval_ctx)
+        args.insert(0, self.node.as_const(eval_ctx))
+
+        try:
+            return test(*args, **kwargs)
+        except Exception:
+            raise Impossible()
+
+
+class Call(Expr):
+    """Calls an expression.  `args` is a list of arguments, `kwargs` a list
+    of keyword arguments (list of :class:`Keyword` nodes), and `dyn_args`
+    and `dyn_kwargs` has to be either `None` or a node that is used as
+    node for dynamic positional (``*args``) or keyword (``**kwargs``)
+    arguments.
+    """
+
+    fields = ("node", "args", "kwargs", "dyn_args", "dyn_kwargs")
+
+
+class Getitem(Expr):
+    """Get an attribute or item from an expression and prefer the item."""
+
+    fields = ("node", "arg", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            return self.environment.getitem(
+                self.node.as_const(eval_ctx), self.arg.as_const(eval_ctx)
+            )
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Getattr(Expr):
+    """Get an attribute or item from an expression that is a ascii-only
+    bytestring and prefer the attribute.
+    """
+
+    fields = ("node", "attr", "ctx")
+
+    def as_const(self, eval_ctx=None):
+        if self.ctx != "load":
+            raise Impossible()
+        try:
+            eval_ctx = get_eval_context(self, eval_ctx)
+            return self.environment.getattr(self.node.as_const(eval_ctx), self.attr)
+        except Exception:
+            raise Impossible()
+
+    def can_assign(self):
+        return False
+
+
+class Slice(Expr):
+    """Represents a slice object.  This must only be used as argument for
+    :class:`Subscript`.
+    """
+
+    fields = ("start", "stop", "step")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+
+        def const(obj):
+            if obj is None:
+                return None
+            return obj.as_const(eval_ctx)
+
+        return slice(const(self.start), const(self.stop), const(self.step))
+
+
+class Concat(Expr):
+    """Concatenates the list of expressions provided after converting them to
+    unicode.
+    """
+
+    fields = ("nodes",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return "".join(text_type(x.as_const(eval_ctx)) for x in self.nodes)
+
+
+class Compare(Expr):
+    """Compares an expression with some other expressions.  `ops` must be a
+    list of :class:`Operand`\\s.
+    """
+
+    fields = ("expr", "ops")
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        result = value = self.expr.as_const(eval_ctx)
+
+        try:
+            for op in self.ops:
+                new_value = op.expr.as_const(eval_ctx)
+                result = _cmpop_to_func[op.op](value, new_value)
+
+                if not result:
+                    return False
+
+                value = new_value
+        except Exception:
+            raise Impossible()
+
+        return result
+
+
+class Operand(Helper):
+    """Holds an operator and an expression."""
+
+    fields = ("op", "expr")
+
+
+if __debug__:
+    Operand.__doc__ += "\nThe following operators are available: " + ", ".join(
+        sorted(
+            "``%s``" % x
+            for x in set(_binop_to_func) | set(_uaop_to_func) | set(_cmpop_to_func)
+        )
+    )
+
+
+class Mul(BinExpr):
+    """Multiplies the left with the right node."""
+
+    operator = "*"
+
+
+class Div(BinExpr):
+    """Divides the left by the right node."""
+
+    operator = "/"
+
+
+class FloorDiv(BinExpr):
+    """Divides the left by the right node and truncates conver the
+    result into an integer by truncating.
+    """
+
+    operator = "//"
+
+
+class Add(BinExpr):
+    """Add the left to the right node."""
+
+    operator = "+"
+
+
+class Sub(BinExpr):
+    """Subtract the right from the left node."""
+
+    operator = "-"
+
+
+class Mod(BinExpr):
+    """Left modulo right."""
+
+    operator = "%"
+
+
+class Pow(BinExpr):
+    """Left to the power of right."""
+
+    operator = "**"
+
+
+class And(BinExpr):
+    """Short circuited AND."""
+
+    operator = "and"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) and self.right.as_const(eval_ctx)
+
+
+class Or(BinExpr):
+    """Short circuited OR."""
+
+    operator = "or"
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return self.left.as_const(eval_ctx) or self.right.as_const(eval_ctx)
+
+
+class Not(UnaryExpr):
+    """Negate the expression."""
+
+    operator = "not"
+
+
+class Neg(UnaryExpr):
+    """Make the expression negative."""
+
+    operator = "-"
+
+
+class Pos(UnaryExpr):
+    """Make the expression positive (noop for most expressions)"""
+
+    operator = "+"
+
+
+# Helpers for extensions
+
+
+class EnvironmentAttribute(Expr):
+    """Loads an attribute from the environment object.  This is useful for
+    extensions that want to call a callback stored on the environment.
+    """
+
+    fields = ("name",)
+
+
+class ExtensionAttribute(Expr):
+    """Returns the attribute of an extension bound to the environment.
+    The identifier is the identifier of the :class:`Extension`.
+
+    This node is usually constructed by calling the
+    :meth:`~jinja2.ext.Extension.attr` method on an extension.
+    """
+
+    fields = ("identifier", "name")
+
+
+class ImportedName(Expr):
+    """If created with an import name the import name is returned on node
+    access.  For example ``ImportedName('cgi.escape')`` returns the `escape`
+    function from the cgi module on evaluation.  Imports are optimized by the
+    compiler so there is no need to assign them to local variables.
+    """
+
+    fields = ("importname",)
+
+
+class InternalName(Expr):
+    """An internal name in the compiler.  You cannot create these nodes
+    yourself but the parser provides a
+    :meth:`~jinja2.parser.Parser.free_identifier` method that creates
+    a new identifier for you.  This identifier is not available from the
+    template and is not threated specially by the compiler.
+    """
+
+    fields = ("name",)
+
+    def __init__(self):
+        raise TypeError(
+            "Can't create internal names.  Use the "
+            "`free_identifier` method on a parser."
+        )
+
+
+class MarkSafe(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`)."""
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        return Markup(self.expr.as_const(eval_ctx))
+
+
+class MarkSafeIfAutoescape(Expr):
+    """Mark the wrapped expression as safe (wrap it as `Markup`) but
+    only if autoescaping is active.
+
+    .. versionadded:: 2.5
+    """
+
+    fields = ("expr",)
+
+    def as_const(self, eval_ctx=None):
+        eval_ctx = get_eval_context(self, eval_ctx)
+        if eval_ctx.volatile:
+            raise Impossible()
+        expr = self.expr.as_const(eval_ctx)
+        if eval_ctx.autoescape:
+            return Markup(expr)
+        return expr
+
+
+class ContextReference(Expr):
+    """Returns the current template context.  It can be used like a
+    :class:`Name` node, with a ``'load'`` ctx and will return the
+    current :class:`~jinja2.runtime.Context` object.
+
+    Here an example that assigns the current template name to a
+    variable named `foo`::
+
+        Assign(Name('foo', ctx='store'),
+               Getattr(ContextReference(), 'name'))
+
+    This is basically equivalent to using the
+    :func:`~jinja2.contextfunction` decorator when using the
+    high-level API, which causes a reference to the context to be passed
+    as the first argument to a function.
+    """
+
+
+class DerivedContextReference(Expr):
+    """Return the current template context including locals. Behaves
+    exactly like :class:`ContextReference`, but includes local
+    variables, such as from a ``for`` loop.
+
+    .. versionadded:: 2.11
+    """
+
+
+class Continue(Stmt):
+    """Continue a loop."""
+
+
+class Break(Stmt):
+    """Break a loop."""
+
+
+class Scope(Stmt):
+    """An artificial scope."""
+
+    fields = ("body",)
+
+
+class OverlayScope(Stmt):
+    """An overlay scope for extensions.  This is a largely unoptimized scope
+    that however can be used to introduce completely arbitrary variables into
+    a sub scope from a dictionary or dictionary like object.  The `context`
+    field has to evaluate to a dictionary object.
+
+    Example usage::
+
+        OverlayScope(context=self.call_method('get_context'),
+                     body=[...])
+
+    .. versionadded:: 2.10
+    """
+
+    fields = ("context", "body")
+
+
+class EvalContextModifier(Stmt):
+    """Modifies the eval context.  For each option that should be modified,
+    a :class:`Keyword` has to be added to the :attr:`options` list.
+
+    Example to change the `autoescape` setting::
+
+        EvalContextModifier(options=[Keyword('autoescape', Const(True))])
+    """
+
+    fields = ("options",)
+
+
+class ScopedEvalContextModifier(EvalContextModifier):
+    """Modifies the eval context and reverts it later.  Works exactly like
+    :class:`EvalContextModifier` but will only modify the
+    :class:`~jinja2.nodes.EvalContext` for nodes in the :attr:`body`.
+    """
+
+    fields = ("body",)
+
+
+# make sure nobody creates custom nodes
+def _failing_new(*args, **kwargs):
+    raise TypeError("can't create custom node types")
+
+
+NodeType.__new__ = staticmethod(_failing_new)
+del _failing_new
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/optimizer.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/optimizer.py
new file mode 100644
index 0000000000000000000000000000000000000000..7bc78c4524ab59dd7218cfe5f23b5de29a4a170c
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/optimizer.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""The optimizer tries to constant fold expressions and modify the AST
+in place so that it should be faster to evaluate.
+
+Because the AST does not contain all the scoping information and the
+compiler has to find that out, we cannot do all the optimizations we
+want. For example, loop unrolling doesn't work because unrolled loops
+would have a different scope. The solution would be a second syntax tree
+that stored the scoping rules.
+"""
+from . import nodes
+from .visitor import NodeTransformer
+
+
+def optimize(node, environment):
+    """The context hint can be used to perform an static optimization
+    based on the context given."""
+    optimizer = Optimizer(environment)
+    return optimizer.visit(node)
+
+
+class Optimizer(NodeTransformer):
+    def __init__(self, environment):
+        self.environment = environment
+
+    def generic_visit(self, node, *args, **kwargs):
+        node = super(Optimizer, self).generic_visit(node, *args, **kwargs)
+
+        # Do constant folding. Some other nodes besides Expr have
+        # as_const, but folding them causes errors later on.
+        if isinstance(node, nodes.Expr):
+            try:
+                return nodes.Const.from_untrusted(
+                    node.as_const(args[0] if args else None),
+                    lineno=node.lineno,
+                    environment=self.environment,
+                )
+            except nodes.Impossible:
+                pass
+
+        return node
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/parser.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..d5881066f7461b01291067f19c356d39dc75d38b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/parser.py
@@ -0,0 +1,939 @@
+# -*- coding: utf-8 -*-
+"""Parse tokens from the lexer into nodes for the compiler."""
+from . import nodes
+from ._compat import imap
+from .exceptions import TemplateAssertionError
+from .exceptions import TemplateSyntaxError
+from .lexer import describe_token
+from .lexer import describe_token_expr
+
+_statement_keywords = frozenset(
+    [
+        "for",
+        "if",
+        "block",
+        "extends",
+        "print",
+        "macro",
+        "include",
+        "from",
+        "import",
+        "set",
+        "with",
+        "autoescape",
+    ]
+)
+_compare_operators = frozenset(["eq", "ne", "lt", "lteq", "gt", "gteq"])
+
+_math_nodes = {
+    "add": nodes.Add,
+    "sub": nodes.Sub,
+    "mul": nodes.Mul,
+    "div": nodes.Div,
+    "floordiv": nodes.FloorDiv,
+    "mod": nodes.Mod,
+}
+
+
+class Parser(object):
+    """This is the central parsing class Jinja uses.  It's passed to
+    extensions and can be used to parse expressions or statements.
+    """
+
+    def __init__(self, environment, source, name=None, filename=None, state=None):
+        self.environment = environment
+        self.stream = environment._tokenize(source, name, filename, state)
+        self.name = name
+        self.filename = filename
+        self.closed = False
+        self.extensions = {}
+        for extension in environment.iter_extensions():
+            for tag in extension.tags:
+                self.extensions[tag] = extension.parse
+        self._last_identifier = 0
+        self._tag_stack = []
+        self._end_token_stack = []
+
+    def fail(self, msg, lineno=None, exc=TemplateSyntaxError):
+        """Convenience method that raises `exc` with the message, passed
+        line number or last line number as well as the current name and
+        filename.
+        """
+        if lineno is None:
+            lineno = self.stream.current.lineno
+        raise exc(msg, lineno, self.name, self.filename)
+
+    def _fail_ut_eof(self, name, end_token_stack, lineno):
+        expected = []
+        for exprs in end_token_stack:
+            expected.extend(imap(describe_token_expr, exprs))
+        if end_token_stack:
+            currently_looking = " or ".join(
+                "'%s'" % describe_token_expr(expr) for expr in end_token_stack[-1]
+            )
+        else:
+            currently_looking = None
+
+        if name is None:
+            message = ["Unexpected end of template."]
+        else:
+            message = ["Encountered unknown tag '%s'." % name]
+
+        if currently_looking:
+            if name is not None and name in expected:
+                message.append(
+                    "You probably made a nesting mistake. Jinja "
+                    "is expecting this tag, but currently looking "
+                    "for %s." % currently_looking
+                )
+            else:
+                message.append(
+                    "Jinja was looking for the following tags: "
+                    "%s." % currently_looking
+                )
+
+        if self._tag_stack:
+            message.append(
+                "The innermost block that needs to be "
+                "closed is '%s'." % self._tag_stack[-1]
+            )
+
+        self.fail(" ".join(message), lineno)
+
+    def fail_unknown_tag(self, name, lineno=None):
+        """Called if the parser encounters an unknown tag.  Tries to fail
+        with a human readable error message that could help to identify
+        the problem.
+        """
+        return self._fail_ut_eof(name, self._end_token_stack, lineno)
+
+    def fail_eof(self, end_tokens=None, lineno=None):
+        """Like fail_unknown_tag but for end of template situations."""
+        stack = list(self._end_token_stack)
+        if end_tokens is not None:
+            stack.append(end_tokens)
+        return self._fail_ut_eof(None, stack, lineno)
+
+    def is_tuple_end(self, extra_end_rules=None):
+        """Are we at the end of a tuple?"""
+        if self.stream.current.type in ("variable_end", "block_end", "rparen"):
+            return True
+        elif extra_end_rules is not None:
+            return self.stream.current.test_any(extra_end_rules)
+        return False
+
+    def free_identifier(self, lineno=None):
+        """Return a new free identifier as :class:`~jinja2.nodes.InternalName`."""
+        self._last_identifier += 1
+        rv = object.__new__(nodes.InternalName)
+        nodes.Node.__init__(rv, "fi%d" % self._last_identifier, lineno=lineno)
+        return rv
+
+    def parse_statement(self):
+        """Parse a single statement."""
+        token = self.stream.current
+        if token.type != "name":
+            self.fail("tag name expected", token.lineno)
+        self._tag_stack.append(token.value)
+        pop_tag = True
+        try:
+            if token.value in _statement_keywords:
+                return getattr(self, "parse_" + self.stream.current.value)()
+            if token.value == "call":
+                return self.parse_call_block()
+            if token.value == "filter":
+                return self.parse_filter_block()
+            ext = self.extensions.get(token.value)
+            if ext is not None:
+                return ext(self)
+
+            # did not work out, remove the token we pushed by accident
+            # from the stack so that the unknown tag fail function can
+            # produce a proper error message.
+            self._tag_stack.pop()
+            pop_tag = False
+            self.fail_unknown_tag(token.value, token.lineno)
+        finally:
+            if pop_tag:
+                self._tag_stack.pop()
+
+    def parse_statements(self, end_tokens, drop_needle=False):
+        """Parse multiple statements into a list until one of the end tokens
+        is reached.  This is used to parse the body of statements as it also
+        parses template data if appropriate.  The parser checks first if the
+        current token is a colon and skips it if there is one.  Then it checks
+        for the block end and parses until if one of the `end_tokens` is
+        reached.  Per default the active token in the stream at the end of
+        the call is the matched end token.  If this is not wanted `drop_needle`
+        can be set to `True` and the end token is removed.
+        """
+        # the first token may be a colon for python compatibility
+        self.stream.skip_if("colon")
+
+        # in the future it would be possible to add whole code sections
+        # by adding some sort of end of statement token and parsing those here.
+        self.stream.expect("block_end")
+        result = self.subparse(end_tokens)
+
+        # we reached the end of the template too early, the subparser
+        # does not check for this, so we do that now
+        if self.stream.current.type == "eof":
+            self.fail_eof(end_tokens)
+
+        if drop_needle:
+            next(self.stream)
+        return result
+
+    def parse_set(self):
+        """Parse an assign statement."""
+        lineno = next(self.stream).lineno
+        target = self.parse_assign_target(with_namespace=True)
+        if self.stream.skip_if("assign"):
+            expr = self.parse_tuple()
+            return nodes.Assign(target, expr, lineno=lineno)
+        filter_node = self.parse_filter(None)
+        body = self.parse_statements(("name:endset",), drop_needle=True)
+        return nodes.AssignBlock(target, filter_node, body, lineno=lineno)
+
+    def parse_for(self):
+        """Parse a for loop."""
+        lineno = self.stream.expect("name:for").lineno
+        target = self.parse_assign_target(extra_end_rules=("name:in",))
+        self.stream.expect("name:in")
+        iter = self.parse_tuple(
+            with_condexpr=False, extra_end_rules=("name:recursive",)
+        )
+        test = None
+        if self.stream.skip_if("name:if"):
+            test = self.parse_expression()
+        recursive = self.stream.skip_if("name:recursive")
+        body = self.parse_statements(("name:endfor", "name:else"))
+        if next(self.stream).value == "endfor":
+            else_ = []
+        else:
+            else_ = self.parse_statements(("name:endfor",), drop_needle=True)
+        return nodes.For(target, iter, body, else_, test, recursive, lineno=lineno)
+
+    def parse_if(self):
+        """Parse an if construct."""
+        node = result = nodes.If(lineno=self.stream.expect("name:if").lineno)
+        while 1:
+            node.test = self.parse_tuple(with_condexpr=False)
+            node.body = self.parse_statements(("name:elif", "name:else", "name:endif"))
+            node.elif_ = []
+            node.else_ = []
+            token = next(self.stream)
+            if token.test("name:elif"):
+                node = nodes.If(lineno=self.stream.current.lineno)
+                result.elif_.append(node)
+                continue
+            elif token.test("name:else"):
+                result.else_ = self.parse_statements(("name:endif",), drop_needle=True)
+            break
+        return result
+
+    def parse_with(self):
+        node = nodes.With(lineno=next(self.stream).lineno)
+        targets = []
+        values = []
+        while self.stream.current.type != "block_end":
+            if targets:
+                self.stream.expect("comma")
+            target = self.parse_assign_target()
+            target.set_ctx("param")
+            targets.append(target)
+            self.stream.expect("assign")
+            values.append(self.parse_expression())
+        node.targets = targets
+        node.values = values
+        node.body = self.parse_statements(("name:endwith",), drop_needle=True)
+        return node
+
+    def parse_autoescape(self):
+        node = nodes.ScopedEvalContextModifier(lineno=next(self.stream).lineno)
+        node.options = [nodes.Keyword("autoescape", self.parse_expression())]
+        node.body = self.parse_statements(("name:endautoescape",), drop_needle=True)
+        return nodes.Scope([node])
+
+    def parse_block(self):
+        node = nodes.Block(lineno=next(self.stream).lineno)
+        node.name = self.stream.expect("name").value
+        node.scoped = self.stream.skip_if("name:scoped")
+
+        # common problem people encounter when switching from django
+        # to jinja.  we do not support hyphens in block names, so let's
+        # raise a nicer error message in that case.
+        if self.stream.current.type == "sub":
+            self.fail(
+                "Block names in Jinja have to be valid Python "
+                "identifiers and may not contain hyphens, use an "
+                "underscore instead."
+            )
+
+        node.body = self.parse_statements(("name:endblock",), drop_needle=True)
+        self.stream.skip_if("name:" + node.name)
+        return node
+
+    def parse_extends(self):
+        node = nodes.Extends(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        return node
+
+    def parse_import_context(self, node, default):
+        if self.stream.current.test_any(
+            "name:with", "name:without"
+        ) and self.stream.look().test("name:context"):
+            node.with_context = next(self.stream).value == "with"
+            self.stream.skip()
+        else:
+            node.with_context = default
+        return node
+
+    def parse_include(self):
+        node = nodes.Include(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        if self.stream.current.test("name:ignore") and self.stream.look().test(
+            "name:missing"
+        ):
+            node.ignore_missing = True
+            self.stream.skip(2)
+        else:
+            node.ignore_missing = False
+        return self.parse_import_context(node, True)
+
+    def parse_import(self):
+        node = nodes.Import(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:as")
+        node.target = self.parse_assign_target(name_only=True).name
+        return self.parse_import_context(node, False)
+
+    def parse_from(self):
+        node = nodes.FromImport(lineno=next(self.stream).lineno)
+        node.template = self.parse_expression()
+        self.stream.expect("name:import")
+        node.names = []
+
+        def parse_context():
+            if self.stream.current.value in (
+                "with",
+                "without",
+            ) and self.stream.look().test("name:context"):
+                node.with_context = next(self.stream).value == "with"
+                self.stream.skip()
+                return True
+            return False
+
+        while 1:
+            if node.names:
+                self.stream.expect("comma")
+            if self.stream.current.type == "name":
+                if parse_context():
+                    break
+                target = self.parse_assign_target(name_only=True)
+                if target.name.startswith("_"):
+                    self.fail(
+                        "names starting with an underline can not be imported",
+                        target.lineno,
+                        exc=TemplateAssertionError,
+                    )
+                if self.stream.skip_if("name:as"):
+                    alias = self.parse_assign_target(name_only=True)
+                    node.names.append((target.name, alias.name))
+                else:
+                    node.names.append(target.name)
+                if parse_context() or self.stream.current.type != "comma":
+                    break
+            else:
+                self.stream.expect("name")
+        if not hasattr(node, "with_context"):
+            node.with_context = False
+        return node
+
+    def parse_signature(self, node):
+        node.args = args = []
+        node.defaults = defaults = []
+        self.stream.expect("lparen")
+        while self.stream.current.type != "rparen":
+            if args:
+                self.stream.expect("comma")
+            arg = self.parse_assign_target(name_only=True)
+            arg.set_ctx("param")
+            if self.stream.skip_if("assign"):
+                defaults.append(self.parse_expression())
+            elif defaults:
+                self.fail("non-default argument follows default argument")
+            args.append(arg)
+        self.stream.expect("rparen")
+
+    def parse_call_block(self):
+        node = nodes.CallBlock(lineno=next(self.stream).lineno)
+        if self.stream.current.type == "lparen":
+            self.parse_signature(node)
+        else:
+            node.args = []
+            node.defaults = []
+
+        node.call = self.parse_expression()
+        if not isinstance(node.call, nodes.Call):
+            self.fail("expected call", node.lineno)
+        node.body = self.parse_statements(("name:endcall",), drop_needle=True)
+        return node
+
+    def parse_filter_block(self):
+        node = nodes.FilterBlock(lineno=next(self.stream).lineno)
+        node.filter = self.parse_filter(None, start_inline=True)
+        node.body = self.parse_statements(("name:endfilter",), drop_needle=True)
+        return node
+
+    def parse_macro(self):
+        node = nodes.Macro(lineno=next(self.stream).lineno)
+        node.name = self.parse_assign_target(name_only=True).name
+        self.parse_signature(node)
+        node.body = self.parse_statements(("name:endmacro",), drop_needle=True)
+        return node
+
+    def parse_print(self):
+        node = nodes.Output(lineno=next(self.stream).lineno)
+        node.nodes = []
+        while self.stream.current.type != "block_end":
+            if node.nodes:
+                self.stream.expect("comma")
+            node.nodes.append(self.parse_expression())
+        return node
+
+    def parse_assign_target(
+        self,
+        with_tuple=True,
+        name_only=False,
+        extra_end_rules=None,
+        with_namespace=False,
+    ):
+        """Parse an assignment target.  As Jinja allows assignments to
+        tuples, this function can parse all allowed assignment targets.  Per
+        default assignments to tuples are parsed, that can be disable however
+        by setting `with_tuple` to `False`.  If only assignments to names are
+        wanted `name_only` can be set to `True`.  The `extra_end_rules`
+        parameter is forwarded to the tuple parsing function.  If
+        `with_namespace` is enabled, a namespace assignment may be parsed.
+        """
+        if with_namespace and self.stream.look().type == "dot":
+            token = self.stream.expect("name")
+            next(self.stream)  # dot
+            attr = self.stream.expect("name")
+            target = nodes.NSRef(token.value, attr.value, lineno=token.lineno)
+        elif name_only:
+            token = self.stream.expect("name")
+            target = nodes.Name(token.value, "store", lineno=token.lineno)
+        else:
+            if with_tuple:
+                target = self.parse_tuple(
+                    simplified=True, extra_end_rules=extra_end_rules
+                )
+            else:
+                target = self.parse_primary()
+            target.set_ctx("store")
+        if not target.can_assign():
+            self.fail(
+                "can't assign to %r" % target.__class__.__name__.lower(), target.lineno
+            )
+        return target
+
+    def parse_expression(self, with_condexpr=True):
+        """Parse an expression.  Per default all expressions are parsed, if
+        the optional `with_condexpr` parameter is set to `False` conditional
+        expressions are not parsed.
+        """
+        if with_condexpr:
+            return self.parse_condexpr()
+        return self.parse_or()
+
+    def parse_condexpr(self):
+        lineno = self.stream.current.lineno
+        expr1 = self.parse_or()
+        while self.stream.skip_if("name:if"):
+            expr2 = self.parse_or()
+            if self.stream.skip_if("name:else"):
+                expr3 = self.parse_condexpr()
+            else:
+                expr3 = None
+            expr1 = nodes.CondExpr(expr2, expr1, expr3, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return expr1
+
+    def parse_or(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_and()
+        while self.stream.skip_if("name:or"):
+            right = self.parse_and()
+            left = nodes.Or(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_and(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_not()
+        while self.stream.skip_if("name:and"):
+            right = self.parse_not()
+            left = nodes.And(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_not(self):
+        if self.stream.current.test("name:not"):
+            lineno = next(self.stream).lineno
+            return nodes.Not(self.parse_not(), lineno=lineno)
+        return self.parse_compare()
+
+    def parse_compare(self):
+        lineno = self.stream.current.lineno
+        expr = self.parse_math1()
+        ops = []
+        while 1:
+            token_type = self.stream.current.type
+            if token_type in _compare_operators:
+                next(self.stream)
+                ops.append(nodes.Operand(token_type, self.parse_math1()))
+            elif self.stream.skip_if("name:in"):
+                ops.append(nodes.Operand("in", self.parse_math1()))
+            elif self.stream.current.test("name:not") and self.stream.look().test(
+                "name:in"
+            ):
+                self.stream.skip(2)
+                ops.append(nodes.Operand("notin", self.parse_math1()))
+            else:
+                break
+            lineno = self.stream.current.lineno
+        if not ops:
+            return expr
+        return nodes.Compare(expr, ops, lineno=lineno)
+
+    def parse_math1(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_concat()
+        while self.stream.current.type in ("add", "sub"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_concat()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_concat(self):
+        lineno = self.stream.current.lineno
+        args = [self.parse_math2()]
+        while self.stream.current.type == "tilde":
+            next(self.stream)
+            args.append(self.parse_math2())
+        if len(args) == 1:
+            return args[0]
+        return nodes.Concat(args, lineno=lineno)
+
+    def parse_math2(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_pow()
+        while self.stream.current.type in ("mul", "div", "floordiv", "mod"):
+            cls = _math_nodes[self.stream.current.type]
+            next(self.stream)
+            right = self.parse_pow()
+            left = cls(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_pow(self):
+        lineno = self.stream.current.lineno
+        left = self.parse_unary()
+        while self.stream.current.type == "pow":
+            next(self.stream)
+            right = self.parse_unary()
+            left = nodes.Pow(left, right, lineno=lineno)
+            lineno = self.stream.current.lineno
+        return left
+
+    def parse_unary(self, with_filter=True):
+        token_type = self.stream.current.type
+        lineno = self.stream.current.lineno
+        if token_type == "sub":
+            next(self.stream)
+            node = nodes.Neg(self.parse_unary(False), lineno=lineno)
+        elif token_type == "add":
+            next(self.stream)
+            node = nodes.Pos(self.parse_unary(False), lineno=lineno)
+        else:
+            node = self.parse_primary()
+        node = self.parse_postfix(node)
+        if with_filter:
+            node = self.parse_filter_expr(node)
+        return node
+
+    def parse_primary(self):
+        token = self.stream.current
+        if token.type == "name":
+            if token.value in ("true", "false", "True", "False"):
+                node = nodes.Const(token.value in ("true", "True"), lineno=token.lineno)
+            elif token.value in ("none", "None"):
+                node = nodes.Const(None, lineno=token.lineno)
+            else:
+                node = nodes.Name(token.value, "load", lineno=token.lineno)
+            next(self.stream)
+        elif token.type == "string":
+            next(self.stream)
+            buf = [token.value]
+            lineno = token.lineno
+            while self.stream.current.type == "string":
+                buf.append(self.stream.current.value)
+                next(self.stream)
+            node = nodes.Const("".join(buf), lineno=lineno)
+        elif token.type in ("integer", "float"):
+            next(self.stream)
+            node = nodes.Const(token.value, lineno=token.lineno)
+        elif token.type == "lparen":
+            next(self.stream)
+            node = self.parse_tuple(explicit_parentheses=True)
+            self.stream.expect("rparen")
+        elif token.type == "lbracket":
+            node = self.parse_list()
+        elif token.type == "lbrace":
+            node = self.parse_dict()
+        else:
+            self.fail("unexpected '%s'" % describe_token(token), token.lineno)
+        return node
+
+    def parse_tuple(
+        self,
+        simplified=False,
+        with_condexpr=True,
+        extra_end_rules=None,
+        explicit_parentheses=False,
+    ):
+        """Works like `parse_expression` but if multiple expressions are
+        delimited by a comma a :class:`~jinja2.nodes.Tuple` node is created.
+        This method could also return a regular expression instead of a tuple
+        if no commas where found.
+
+        The default parsing mode is a full tuple.  If `simplified` is `True`
+        only names and literals are parsed.  The `no_condexpr` parameter is
+        forwarded to :meth:`parse_expression`.
+
+        Because tuples do not require delimiters and may end in a bogus comma
+        an extra hint is needed that marks the end of a tuple.  For example
+        for loops support tuples between `for` and `in`.  In that case the
+        `extra_end_rules` is set to ``['name:in']``.
+
+        `explicit_parentheses` is true if the parsing was triggered by an
+        expression in parentheses.  This is used to figure out if an empty
+        tuple is a valid expression or not.
+        """
+        lineno = self.stream.current.lineno
+        if simplified:
+            parse = self.parse_primary
+        elif with_condexpr:
+            parse = self.parse_expression
+        else:
+
+            def parse():
+                return self.parse_expression(with_condexpr=False)
+
+        args = []
+        is_tuple = False
+        while 1:
+            if args:
+                self.stream.expect("comma")
+            if self.is_tuple_end(extra_end_rules):
+                break
+            args.append(parse())
+            if self.stream.current.type == "comma":
+                is_tuple = True
+            else:
+                break
+            lineno = self.stream.current.lineno
+
+        if not is_tuple:
+            if args:
+                return args[0]
+
+            # if we don't have explicit parentheses, an empty tuple is
+            # not a valid expression.  This would mean nothing (literally
+            # nothing) in the spot of an expression would be an empty
+            # tuple.
+            if not explicit_parentheses:
+                self.fail(
+                    "Expected an expression, got '%s'"
+                    % describe_token(self.stream.current)
+                )
+
+        return nodes.Tuple(args, "load", lineno=lineno)
+
+    def parse_list(self):
+        token = self.stream.expect("lbracket")
+        items = []
+        while self.stream.current.type != "rbracket":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbracket":
+                break
+            items.append(self.parse_expression())
+        self.stream.expect("rbracket")
+        return nodes.List(items, lineno=token.lineno)
+
+    def parse_dict(self):
+        token = self.stream.expect("lbrace")
+        items = []
+        while self.stream.current.type != "rbrace":
+            if items:
+                self.stream.expect("comma")
+            if self.stream.current.type == "rbrace":
+                break
+            key = self.parse_expression()
+            self.stream.expect("colon")
+            value = self.parse_expression()
+            items.append(nodes.Pair(key, value, lineno=key.lineno))
+        self.stream.expect("rbrace")
+        return nodes.Dict(items, lineno=token.lineno)
+
+    def parse_postfix(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "dot" or token_type == "lbracket":
+                node = self.parse_subscript(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_filter_expr(self, node):
+        while 1:
+            token_type = self.stream.current.type
+            if token_type == "pipe":
+                node = self.parse_filter(node)
+            elif token_type == "name" and self.stream.current.value == "is":
+                node = self.parse_test(node)
+            # calls are valid both after postfix expressions (getattr
+            # and getitem) as well as filters and tests
+            elif token_type == "lparen":
+                node = self.parse_call(node)
+            else:
+                break
+        return node
+
+    def parse_subscript(self, node):
+        token = next(self.stream)
+        if token.type == "dot":
+            attr_token = self.stream.current
+            next(self.stream)
+            if attr_token.type == "name":
+                return nodes.Getattr(
+                    node, attr_token.value, "load", lineno=token.lineno
+                )
+            elif attr_token.type != "integer":
+                self.fail("expected name or number", attr_token.lineno)
+            arg = nodes.Const(attr_token.value, lineno=attr_token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        if token.type == "lbracket":
+            args = []
+            while self.stream.current.type != "rbracket":
+                if args:
+                    self.stream.expect("comma")
+                args.append(self.parse_subscribed())
+            self.stream.expect("rbracket")
+            if len(args) == 1:
+                arg = args[0]
+            else:
+                arg = nodes.Tuple(args, "load", lineno=token.lineno)
+            return nodes.Getitem(node, arg, "load", lineno=token.lineno)
+        self.fail("expected subscript expression", token.lineno)
+
+    def parse_subscribed(self):
+        lineno = self.stream.current.lineno
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            args = [None]
+        else:
+            node = self.parse_expression()
+            if self.stream.current.type != "colon":
+                return node
+            next(self.stream)
+            args = [node]
+
+        if self.stream.current.type == "colon":
+            args.append(None)
+        elif self.stream.current.type not in ("rbracket", "comma"):
+            args.append(self.parse_expression())
+        else:
+            args.append(None)
+
+        if self.stream.current.type == "colon":
+            next(self.stream)
+            if self.stream.current.type not in ("rbracket", "comma"):
+                args.append(self.parse_expression())
+            else:
+                args.append(None)
+        else:
+            args.append(None)
+
+        return nodes.Slice(lineno=lineno, *args)
+
+    def parse_call(self, node):
+        token = self.stream.expect("lparen")
+        args = []
+        kwargs = []
+        dyn_args = dyn_kwargs = None
+        require_comma = False
+
+        def ensure(expr):
+            if not expr:
+                self.fail("invalid syntax for function call expression", token.lineno)
+
+        while self.stream.current.type != "rparen":
+            if require_comma:
+                self.stream.expect("comma")
+                # support for trailing comma
+                if self.stream.current.type == "rparen":
+                    break
+            if self.stream.current.type == "mul":
+                ensure(dyn_args is None and dyn_kwargs is None)
+                next(self.stream)
+                dyn_args = self.parse_expression()
+            elif self.stream.current.type == "pow":
+                ensure(dyn_kwargs is None)
+                next(self.stream)
+                dyn_kwargs = self.parse_expression()
+            else:
+                if (
+                    self.stream.current.type == "name"
+                    and self.stream.look().type == "assign"
+                ):
+                    # Parsing a kwarg
+                    ensure(dyn_kwargs is None)
+                    key = self.stream.current.value
+                    self.stream.skip(2)
+                    value = self.parse_expression()
+                    kwargs.append(nodes.Keyword(key, value, lineno=value.lineno))
+                else:
+                    # Parsing an arg
+                    ensure(dyn_args is None and dyn_kwargs is None and not kwargs)
+                    args.append(self.parse_expression())
+
+            require_comma = True
+        self.stream.expect("rparen")
+
+        if node is None:
+            return args, kwargs, dyn_args, dyn_kwargs
+        return nodes.Call(node, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno)
+
+    def parse_filter(self, node, start_inline=False):
+        while self.stream.current.type == "pipe" or start_inline:
+            if not start_inline:
+                next(self.stream)
+            token = self.stream.expect("name")
+            name = token.value
+            while self.stream.current.type == "dot":
+                next(self.stream)
+                name += "." + self.stream.expect("name").value
+            if self.stream.current.type == "lparen":
+                args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+            else:
+                args = []
+                kwargs = []
+                dyn_args = dyn_kwargs = None
+            node = nodes.Filter(
+                node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+            )
+            start_inline = False
+        return node
+
+    def parse_test(self, node):
+        token = next(self.stream)
+        if self.stream.current.test("name:not"):
+            next(self.stream)
+            negated = True
+        else:
+            negated = False
+        name = self.stream.expect("name").value
+        while self.stream.current.type == "dot":
+            next(self.stream)
+            name += "." + self.stream.expect("name").value
+        dyn_args = dyn_kwargs = None
+        kwargs = []
+        if self.stream.current.type == "lparen":
+            args, kwargs, dyn_args, dyn_kwargs = self.parse_call(None)
+        elif self.stream.current.type in (
+            "name",
+            "string",
+            "integer",
+            "float",
+            "lparen",
+            "lbracket",
+            "lbrace",
+        ) and not self.stream.current.test_any("name:else", "name:or", "name:and"):
+            if self.stream.current.test("name:is"):
+                self.fail("You cannot chain multiple tests with is")
+            arg_node = self.parse_primary()
+            arg_node = self.parse_postfix(arg_node)
+            args = [arg_node]
+        else:
+            args = []
+        node = nodes.Test(
+            node, name, args, kwargs, dyn_args, dyn_kwargs, lineno=token.lineno
+        )
+        if negated:
+            node = nodes.Not(node, lineno=token.lineno)
+        return node
+
+    def subparse(self, end_tokens=None):
+        body = []
+        data_buffer = []
+        add_data = data_buffer.append
+
+        if end_tokens is not None:
+            self._end_token_stack.append(end_tokens)
+
+        def flush_data():
+            if data_buffer:
+                lineno = data_buffer[0].lineno
+                body.append(nodes.Output(data_buffer[:], lineno=lineno))
+                del data_buffer[:]
+
+        try:
+            while self.stream:
+                token = self.stream.current
+                if token.type == "data":
+                    if token.value:
+                        add_data(nodes.TemplateData(token.value, lineno=token.lineno))
+                    next(self.stream)
+                elif token.type == "variable_begin":
+                    next(self.stream)
+                    add_data(self.parse_tuple(with_condexpr=True))
+                    self.stream.expect("variable_end")
+                elif token.type == "block_begin":
+                    flush_data()
+                    next(self.stream)
+                    if end_tokens is not None and self.stream.current.test_any(
+                        *end_tokens
+                    ):
+                        return body
+                    rv = self.parse_statement()
+                    if isinstance(rv, list):
+                        body.extend(rv)
+                    else:
+                        body.append(rv)
+                    self.stream.expect("block_end")
+                else:
+                    raise AssertionError("internal parsing error")
+
+            flush_data()
+        finally:
+            if end_tokens is not None:
+                self._end_token_stack.pop()
+
+        return body
+
+    def parse(self):
+        """Parse the whole template into a `Template` node."""
+        result = nodes.Template(self.subparse(), lineno=1)
+        result.set_environment(self.environment)
+        return result
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/runtime.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/runtime.py
new file mode 100644
index 0000000000000000000000000000000000000000..3ad79686242d35b2ce587ac8267259621d4769e4
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/runtime.py
@@ -0,0 +1,1011 @@
+# -*- coding: utf-8 -*-
+"""The runtime functions and state used by compiled templates."""
+import sys
+from itertools import chain
+from types import MethodType
+
+from markupsafe import escape  # noqa: F401
+from markupsafe import Markup
+from markupsafe import soft_unicode
+
+from ._compat import abc
+from ._compat import imap
+from ._compat import implements_iterator
+from ._compat import implements_to_string
+from ._compat import iteritems
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import with_metaclass
+from .exceptions import TemplateNotFound  # noqa: F401
+from .exceptions import TemplateRuntimeError  # noqa: F401
+from .exceptions import UndefinedError
+from .nodes import EvalContext
+from .utils import concat
+from .utils import evalcontextfunction
+from .utils import internalcode
+from .utils import missing
+from .utils import Namespace  # noqa: F401
+from .utils import object_type_repr
+
+# these variables are exported to the template runtime
+exported = [
+    "LoopContext",
+    "TemplateReference",
+    "Macro",
+    "Markup",
+    "TemplateRuntimeError",
+    "missing",
+    "concat",
+    "escape",
+    "markup_join",
+    "unicode_join",
+    "to_string",
+    "identity",
+    "TemplateNotFound",
+    "Namespace",
+    "Undefined",
+]
+
+#: the name of the function that is used to convert something into
+#: a string.  We can just use the text type here.
+to_string = text_type
+
+
+def identity(x):
+    """Returns its argument. Useful for certain things in the
+    environment.
+    """
+    return x
+
+
+def markup_join(seq):
+    """Concatenation that escapes if necessary and converts to unicode."""
+    buf = []
+    iterator = imap(soft_unicode, seq)
+    for arg in iterator:
+        buf.append(arg)
+        if hasattr(arg, "__html__"):
+            return Markup(u"").join(chain(buf, iterator))
+    return concat(buf)
+
+
+def unicode_join(seq):
+    """Simple args to unicode conversion and concatenation."""
+    return concat(imap(text_type, seq))
+
+
+def new_context(
+    environment,
+    template_name,
+    blocks,
+    vars=None,
+    shared=None,
+    globals=None,
+    locals=None,
+):
+    """Internal helper for context creation."""
+    if vars is None:
+        vars = {}
+    if shared:
+        parent = vars
+    else:
+        parent = dict(globals or (), **vars)
+    if locals:
+        # if the parent is shared a copy should be created because
+        # we don't want to modify the dict passed
+        if shared:
+            parent = dict(parent)
+        for key, value in iteritems(locals):
+            if value is not missing:
+                parent[key] = value
+    return environment.context_class(environment, parent, template_name, blocks)
+
+
+class TemplateReference(object):
+    """The `self` in templates."""
+
+    def __init__(self, context):
+        self.__context = context
+
+    def __getitem__(self, name):
+        blocks = self.__context.blocks[name]
+        return BlockReference(name, self.__context, blocks, 0)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self.__context.name)
+
+
+def _get_func(x):
+    return getattr(x, "__func__", x)
+
+
+class ContextMeta(type):
+    def __new__(mcs, name, bases, d):
+        rv = type.__new__(mcs, name, bases, d)
+        if bases == ():
+            return rv
+
+        resolve = _get_func(rv.resolve)
+        default_resolve = _get_func(Context.resolve)
+        resolve_or_missing = _get_func(rv.resolve_or_missing)
+        default_resolve_or_missing = _get_func(Context.resolve_or_missing)
+
+        # If we have a changed resolve but no changed default or missing
+        # resolve we invert the call logic.
+        if (
+            resolve is not default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._legacy_resolve_mode = True
+        elif (
+            resolve is default_resolve
+            and resolve_or_missing is default_resolve_or_missing
+        ):
+            rv._fast_resolve_mode = True
+
+        return rv
+
+
+def resolve_or_missing(context, key, missing=missing):
+    if key in context.vars:
+        return context.vars[key]
+    if key in context.parent:
+        return context.parent[key]
+    return missing
+
+
+class Context(with_metaclass(ContextMeta)):
+    """The template context holds the variables of a template.  It stores the
+    values passed to the template and also the names the template exports.
+    Creating instances is neither supported nor useful as it's created
+    automatically at various stages of the template evaluation and should not
+    be created by hand.
+
+    The context is immutable.  Modifications on :attr:`parent` **must not**
+    happen and modifications on :attr:`vars` are allowed from generated
+    template code only.  Template filters and global functions marked as
+    :func:`contextfunction`\\s get the active context passed as first argument
+    and are allowed to access the context read-only.
+
+    The template context supports read only dict operations (`get`,
+    `keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`,
+    `__getitem__`, `__contains__`).  Additionally there is a :meth:`resolve`
+    method that doesn't fail with a `KeyError` but returns an
+    :class:`Undefined` object for missing variables.
+    """
+
+    # XXX: we want to eventually make this be a deprecation warning and
+    # remove it.
+    _legacy_resolve_mode = False
+    _fast_resolve_mode = False
+
+    def __init__(self, environment, parent, name, blocks):
+        self.parent = parent
+        self.vars = {}
+        self.environment = environment
+        self.eval_ctx = EvalContext(self.environment, name)
+        self.exported_vars = set()
+        self.name = name
+
+        # create the initial mapping of blocks.  Whenever template inheritance
+        # takes place the runtime will update this mapping with the new blocks
+        # from the template.
+        self.blocks = dict((k, [v]) for k, v in iteritems(blocks))
+
+        # In case we detect the fast resolve mode we can set up an alias
+        # here that bypasses the legacy code logic.
+        if self._fast_resolve_mode:
+            self.resolve_or_missing = MethodType(resolve_or_missing, self)
+
+    def super(self, name, current):
+        """Render a parent block."""
+        try:
+            blocks = self.blocks[name]
+            index = blocks.index(current) + 1
+            blocks[index]
+        except LookupError:
+            return self.environment.undefined(
+                "there is no parent block called %r." % name, name="super"
+            )
+        return BlockReference(name, self, blocks, index)
+
+    def get(self, key, default=None):
+        """Returns an item from the template context, if it doesn't exist
+        `default` is returned.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def resolve(self, key):
+        """Looks up a variable like `__getitem__` or `get` but returns an
+        :class:`Undefined` object with the name of the name looked up.
+        """
+        if self._legacy_resolve_mode:
+            rv = resolve_or_missing(self, key)
+        else:
+            rv = self.resolve_or_missing(key)
+        if rv is missing:
+            return self.environment.undefined(name=key)
+        return rv
+
+    def resolve_or_missing(self, key):
+        """Resolves a variable like :meth:`resolve` but returns the
+        special `missing` value if it cannot be found.
+        """
+        if self._legacy_resolve_mode:
+            rv = self.resolve(key)
+            if isinstance(rv, Undefined):
+                rv = missing
+            return rv
+        return resolve_or_missing(self, key)
+
+    def get_exported(self):
+        """Get a new dict with the exported variables."""
+        return dict((k, self.vars[k]) for k in self.exported_vars)
+
+    def get_all(self):
+        """Return the complete context as dict including the exported
+        variables.  For optimizations reasons this might not return an
+        actual copy so be careful with using it.
+        """
+        if not self.vars:
+            return self.parent
+        if not self.parent:
+            return self.vars
+        return dict(self.parent, **self.vars)
+
+    @internalcode
+    def call(__self, __obj, *args, **kwargs):  # noqa: B902
+        """Call the callable with the arguments and keyword arguments
+        provided but inject the active context or environment as first
+        argument if the callable is a :func:`contextfunction` or
+        :func:`environmentfunction`.
+        """
+        if __debug__:
+            __traceback_hide__ = True  # noqa
+
+        # Allow callable classes to take a context
+        if hasattr(__obj, "__call__"):  # noqa: B004
+            fn = __obj.__call__
+            for fn_type in (
+                "contextfunction",
+                "evalcontextfunction",
+                "environmentfunction",
+            ):
+                if hasattr(fn, fn_type):
+                    __obj = fn
+                    break
+
+        if callable(__obj):
+            if getattr(__obj, "contextfunction", False) is True:
+                args = (__self,) + args
+            elif getattr(__obj, "evalcontextfunction", False) is True:
+                args = (__self.eval_ctx,) + args
+            elif getattr(__obj, "environmentfunction", False) is True:
+                args = (__self.environment,) + args
+        try:
+            return __obj(*args, **kwargs)
+        except StopIteration:
+            return __self.environment.undefined(
+                "value was undefined because "
+                "a callable raised a "
+                "StopIteration exception"
+            )
+
+    def derived(self, locals=None):
+        """Internal helper function to create a derived context.  This is
+        used in situations where the system needs a new context in the same
+        template that is independent.
+        """
+        context = new_context(
+            self.environment, self.name, {}, self.get_all(), True, None, locals
+        )
+        context.eval_ctx = self.eval_ctx
+        context.blocks.update((k, list(v)) for k, v in iteritems(self.blocks))
+        return context
+
+    def _all(meth):  # noqa: B902
+        def proxy(self):
+            return getattr(self.get_all(), meth)()
+
+        proxy.__doc__ = getattr(dict, meth).__doc__
+        proxy.__name__ = meth
+        return proxy
+
+    keys = _all("keys")
+    values = _all("values")
+    items = _all("items")
+
+    # not available on python 3
+    if PY2:
+        iterkeys = _all("iterkeys")
+        itervalues = _all("itervalues")
+        iteritems = _all("iteritems")
+    del _all
+
+    def __contains__(self, name):
+        return name in self.vars or name in self.parent
+
+    def __getitem__(self, key):
+        """Lookup a variable or raise `KeyError` if the variable is
+        undefined.
+        """
+        item = self.resolve_or_missing(key)
+        if item is missing:
+            raise KeyError(key)
+        return item
+
+    def __repr__(self):
+        return "<%s %s of %r>" % (
+            self.__class__.__name__,
+            repr(self.get_all()),
+            self.name,
+        )
+
+
+abc.Mapping.register(Context)
+
+
+class BlockReference(object):
+    """One block on a template reference."""
+
+    def __init__(self, name, context, stack, depth):
+        self.name = name
+        self._context = context
+        self._stack = stack
+        self._depth = depth
+
+    @property
+    def super(self):
+        """Super the block."""
+        if self._depth + 1 >= len(self._stack):
+            return self._context.environment.undefined(
+                "there is no parent block called %r." % self.name, name="super"
+            )
+        return BlockReference(self.name, self._context, self._stack, self._depth + 1)
+
+    @internalcode
+    def __call__(self):
+        rv = concat(self._stack[self._depth](self._context))
+        if self._context.eval_ctx.autoescape:
+            rv = Markup(rv)
+        return rv
+
+
+@implements_iterator
+class LoopContext:
+    """A wrapper iterable for dynamic ``for`` loops, with information
+    about the loop and iteration.
+    """
+
+    #: Current iteration of the loop, starting at 0.
+    index0 = -1
+
+    _length = None
+    _after = missing
+    _current = missing
+    _before = missing
+    _last_changed_value = missing
+
+    def __init__(self, iterable, undefined, recurse=None, depth0=0):
+        """
+        :param iterable: Iterable to wrap.
+        :param undefined: :class:`Undefined` class to use for next and
+            previous items.
+        :param recurse: The function to render the loop body when the
+            loop is marked recursive.
+        :param depth0: Incremented when looping recursively.
+        """
+        self._iterable = iterable
+        self._iterator = self._to_iterator(iterable)
+        self._undefined = undefined
+        self._recurse = recurse
+        #: How many levels deep a recursive loop currently is, starting at 0.
+        self.depth0 = depth0
+
+    @staticmethod
+    def _to_iterator(iterable):
+        return iter(iterable)
+
+    @property
+    def length(self):
+        """Length of the iterable.
+
+        If the iterable is a generator or otherwise does not have a
+        size, it is eagerly evaluated to get a size.
+        """
+        if self._length is not None:
+            return self._length
+
+        try:
+            self._length = len(self._iterable)
+        except TypeError:
+            iterable = list(self._iterator)
+            self._iterator = self._to_iterator(iterable)
+            self._length = len(iterable) + self.index + (self._after is not missing)
+
+        return self._length
+
+    def __len__(self):
+        return self.length
+
+    @property
+    def depth(self):
+        """How many levels deep a recursive loop currently is, starting at 1."""
+        return self.depth0 + 1
+
+    @property
+    def index(self):
+        """Current iteration of the loop, starting at 1."""
+        return self.index0 + 1
+
+    @property
+    def revindex0(self):
+        """Number of iterations from the end of the loop, ending at 0.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index
+
+    @property
+    def revindex(self):
+        """Number of iterations from the end of the loop, ending at 1.
+
+        Requires calculating :attr:`length`.
+        """
+        return self.length - self.index0
+
+    @property
+    def first(self):
+        """Whether this is the first iteration of the loop."""
+        return self.index0 == 0
+
+    def _peek_next(self):
+        """Return the next element in the iterable, or :data:`missing`
+        if the iterable is exhausted. Only peeks one item ahead, caching
+        the result in :attr:`_last` for use in subsequent checks. The
+        cache is reset when :meth:`__next__` is called.
+        """
+        if self._after is not missing:
+            return self._after
+
+        self._after = next(self._iterator, missing)
+        return self._after
+
+    @property
+    def last(self):
+        """Whether this is the last iteration of the loop.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        return self._peek_next() is missing
+
+    @property
+    def previtem(self):
+        """The item in the previous iteration. Undefined during the
+        first iteration.
+        """
+        if self.first:
+            return self._undefined("there is no previous item")
+
+        return self._before
+
+    @property
+    def nextitem(self):
+        """The item in the next iteration. Undefined during the last
+        iteration.
+
+        Causes the iterable to advance early. See
+        :func:`itertools.groupby` for issues this can cause.
+        The :func:`groupby` filter avoids that issue.
+        """
+        rv = self._peek_next()
+
+        if rv is missing:
+            return self._undefined("there is no next item")
+
+        return rv
+
+    def cycle(self, *args):
+        """Return a value from the given args, cycling through based on
+        the current :attr:`index0`.
+
+        :param args: One or more values to cycle through.
+        """
+        if not args:
+            raise TypeError("no items for cycling given")
+
+        return args[self.index0 % len(args)]
+
+    def changed(self, *value):
+        """Return ``True`` if previously called with a different value
+        (including when called for the first time).
+
+        :param value: One or more values to compare to the last call.
+        """
+        if self._last_changed_value != value:
+            self._last_changed_value = value
+            return True
+
+        return False
+
+    def __iter__(self):
+        return self
+
+    def __next__(self):
+        if self._after is not missing:
+            rv = self._after
+            self._after = missing
+        else:
+            rv = next(self._iterator)
+
+        self.index0 += 1
+        self._before = self._current
+        self._current = rv
+        return rv, self
+
+    @internalcode
+    def __call__(self, iterable):
+        """When iterating over nested data, render the body of the loop
+        recursively with the given inner iterable data.
+
+        The loop must have the ``recursive`` marker for this to work.
+        """
+        if self._recurse is None:
+            raise TypeError(
+                "The loop must have the 'recursive' marker to be called recursively."
+            )
+
+        return self._recurse(iterable, self._recurse, depth=self.depth)
+
+    def __repr__(self):
+        return "<%s %d/%d>" % (self.__class__.__name__, self.index, self.length)
+
+
+class Macro(object):
+    """Wraps a macro function."""
+
+    def __init__(
+        self,
+        environment,
+        func,
+        name,
+        arguments,
+        catch_kwargs,
+        catch_varargs,
+        caller,
+        default_autoescape=None,
+    ):
+        self._environment = environment
+        self._func = func
+        self._argument_count = len(arguments)
+        self.name = name
+        self.arguments = arguments
+        self.catch_kwargs = catch_kwargs
+        self.catch_varargs = catch_varargs
+        self.caller = caller
+        self.explicit_caller = "caller" in arguments
+        if default_autoescape is None:
+            default_autoescape = environment.autoescape
+        self._default_autoescape = default_autoescape
+
+    @internalcode
+    @evalcontextfunction
+    def __call__(self, *args, **kwargs):
+        # This requires a bit of explanation,  In the past we used to
+        # decide largely based on compile-time information if a macro is
+        # safe or unsafe.  While there was a volatile mode it was largely
+        # unused for deciding on escaping.  This turns out to be
+        # problematic for macros because whether a macro is safe depends not
+        # on the escape mode when it was defined, but rather when it was used.
+        #
+        # Because however we export macros from the module system and
+        # there are historic callers that do not pass an eval context (and
+        # will continue to not pass one), we need to perform an instance
+        # check here.
+        #
+        # This is considered safe because an eval context is not a valid
+        # argument to callables otherwise anyway.  Worst case here is
+        # that if no eval context is passed we fall back to the compile
+        # time autoescape flag.
+        if args and isinstance(args[0], EvalContext):
+            autoescape = args[0].autoescape
+            args = args[1:]
+        else:
+            autoescape = self._default_autoescape
+
+        # try to consume the positional arguments
+        arguments = list(args[: self._argument_count])
+        off = len(arguments)
+
+        # For information why this is necessary refer to the handling
+        # of caller in the `macro_body` handler in the compiler.
+        found_caller = False
+
+        # if the number of arguments consumed is not the number of
+        # arguments expected we start filling in keyword arguments
+        # and defaults.
+        if off != self._argument_count:
+            for name in self.arguments[len(arguments) :]:
+                try:
+                    value = kwargs.pop(name)
+                except KeyError:
+                    value = missing
+                if name == "caller":
+                    found_caller = True
+                arguments.append(value)
+        else:
+            found_caller = self.explicit_caller
+
+        # it's important that the order of these arguments does not change
+        # if not also changed in the compiler's `function_scoping` method.
+        # the order is caller, keyword arguments, positional arguments!
+        if self.caller and not found_caller:
+            caller = kwargs.pop("caller", None)
+            if caller is None:
+                caller = self._environment.undefined("No caller defined", name="caller")
+            arguments.append(caller)
+
+        if self.catch_kwargs:
+            arguments.append(kwargs)
+        elif kwargs:
+            if "caller" in kwargs:
+                raise TypeError(
+                    "macro %r was invoked with two values for "
+                    "the special caller argument.  This is "
+                    "most likely a bug." % self.name
+                )
+            raise TypeError(
+                "macro %r takes no keyword argument %r"
+                % (self.name, next(iter(kwargs)))
+            )
+        if self.catch_varargs:
+            arguments.append(args[self._argument_count :])
+        elif len(args) > self._argument_count:
+            raise TypeError(
+                "macro %r takes not more than %d argument(s)"
+                % (self.name, len(self.arguments))
+            )
+
+        return self._invoke(arguments, autoescape)
+
+    def _invoke(self, arguments, autoescape):
+        """This method is being swapped out by the async implementation."""
+        rv = self._func(*arguments)
+        if autoescape:
+            rv = Markup(rv)
+        return rv
+
+    def __repr__(self):
+        return "<%s %s>" % (
+            self.__class__.__name__,
+            self.name is None and "anonymous" or repr(self.name),
+        )
+
+
+@implements_to_string
+class Undefined(object):
+    """The default undefined type.  This undefined type can be printed and
+    iterated over, but every other access will raise an :exc:`UndefinedError`:
+
+    >>> foo = Undefined(name='foo')
+    >>> str(foo)
+    ''
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = (
+        "_undefined_hint",
+        "_undefined_obj",
+        "_undefined_name",
+        "_undefined_exception",
+    )
+
+    def __init__(self, hint=None, obj=missing, name=None, exc=UndefinedError):
+        self._undefined_hint = hint
+        self._undefined_obj = obj
+        self._undefined_name = name
+        self._undefined_exception = exc
+
+    @property
+    def _undefined_message(self):
+        """Build a message about the undefined value based on how it was
+        accessed.
+        """
+        if self._undefined_hint:
+            return self._undefined_hint
+
+        if self._undefined_obj is missing:
+            return "%r is undefined" % self._undefined_name
+
+        if not isinstance(self._undefined_name, string_types):
+            return "%s has no element %r" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+
+        return "%r has no attribute %r" % (
+            object_type_repr(self._undefined_obj),
+            self._undefined_name,
+        )
+
+    @internalcode
+    def _fail_with_undefined_error(self, *args, **kwargs):
+        """Raise an :exc:`UndefinedError` when operations are performed
+        on the undefined value.
+        """
+        raise self._undefined_exception(self._undefined_message)
+
+    @internalcode
+    def __getattr__(self, name):
+        if name[:2] == "__":
+            raise AttributeError(name)
+        return self._fail_with_undefined_error()
+
+    __add__ = (
+        __radd__
+    ) = (
+        __mul__
+    ) = (
+        __rmul__
+    ) = (
+        __div__
+    ) = (
+        __rdiv__
+    ) = (
+        __truediv__
+    ) = (
+        __rtruediv__
+    ) = (
+        __floordiv__
+    ) = (
+        __rfloordiv__
+    ) = (
+        __mod__
+    ) = (
+        __rmod__
+    ) = (
+        __pos__
+    ) = (
+        __neg__
+    ) = (
+        __call__
+    ) = (
+        __getitem__
+    ) = (
+        __lt__
+    ) = (
+        __le__
+    ) = (
+        __gt__
+    ) = (
+        __ge__
+    ) = (
+        __int__
+    ) = (
+        __float__
+    ) = (
+        __complex__
+    ) = __pow__ = __rpow__ = __sub__ = __rsub__ = _fail_with_undefined_error
+
+    def __eq__(self, other):
+        return type(self) is type(other)
+
+    def __ne__(self, other):
+        return not self.__eq__(other)
+
+    def __hash__(self):
+        return id(type(self))
+
+    def __str__(self):
+        return u""
+
+    def __len__(self):
+        return 0
+
+    def __iter__(self):
+        if 0:
+            yield None
+
+    def __nonzero__(self):
+        return False
+
+    __bool__ = __nonzero__
+
+    def __repr__(self):
+        return "Undefined"
+
+
+def make_logging_undefined(logger=None, base=None):
+    """Given a logger object this returns a new undefined class that will
+    log certain failures.  It will log iterations and printing.  If no
+    logger is given a default logger is created.
+
+    Example::
+
+        logger = logging.getLogger(__name__)
+        LoggingUndefined = make_logging_undefined(
+            logger=logger,
+            base=Undefined
+        )
+
+    .. versionadded:: 2.8
+
+    :param logger: the logger to use.  If not provided, a default logger
+                   is created.
+    :param base: the base class to add logging functionality to.  This
+                 defaults to :class:`Undefined`.
+    """
+    if logger is None:
+        import logging
+
+        logger = logging.getLogger(__name__)
+        logger.addHandler(logging.StreamHandler(sys.stderr))
+    if base is None:
+        base = Undefined
+
+    def _log_message(undef):
+        if undef._undefined_hint is None:
+            if undef._undefined_obj is missing:
+                hint = "%s is undefined" % undef._undefined_name
+            elif not isinstance(undef._undefined_name, string_types):
+                hint = "%s has no element %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+            else:
+                hint = "%s has no attribute %s" % (
+                    object_type_repr(undef._undefined_obj),
+                    undef._undefined_name,
+                )
+        else:
+            hint = undef._undefined_hint
+        logger.warning("Template variable warning: %s", hint)
+
+    class LoggingUndefined(base):
+        def _fail_with_undefined_error(self, *args, **kwargs):
+            try:
+                return base._fail_with_undefined_error(self, *args, **kwargs)
+            except self._undefined_exception as e:
+                logger.error("Template variable error: %s", str(e))
+                raise e
+
+        def __str__(self):
+            rv = base.__str__(self)
+            _log_message(self)
+            return rv
+
+        def __iter__(self):
+            rv = base.__iter__(self)
+            _log_message(self)
+            return rv
+
+        if PY2:
+
+            def __nonzero__(self):
+                rv = base.__nonzero__(self)
+                _log_message(self)
+                return rv
+
+            def __unicode__(self):
+                rv = base.__unicode__(self)
+                _log_message(self)
+                return rv
+
+        else:
+
+            def __bool__(self):
+                rv = base.__bool__(self)
+                _log_message(self)
+                return rv
+
+    return LoggingUndefined
+
+
+# No @implements_to_string decorator here because __str__
+# is not overwritten from Undefined in this class.
+# This would cause a recursion error in Python 2.
+class ChainableUndefined(Undefined):
+    """An undefined that is chainable, where both ``__getattr__`` and
+    ``__getitem__`` return itself rather than raising an
+    :exc:`UndefinedError`.
+
+    >>> foo = ChainableUndefined(name='foo')
+    >>> str(foo.bar['baz'])
+    ''
+    >>> foo.bar['baz'] + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+
+    .. versionadded:: 2.11.0
+    """
+
+    __slots__ = ()
+
+    def __html__(self):
+        return self.__str__()
+
+    def __getattr__(self, _):
+        return self
+
+    __getitem__ = __getattr__
+
+
+@implements_to_string
+class DebugUndefined(Undefined):
+    """An undefined that returns the debug info when printed.
+
+    >>> foo = DebugUndefined(name='foo')
+    >>> str(foo)
+    '{{ foo }}'
+    >>> not foo
+    True
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+
+    def __str__(self):
+        if self._undefined_hint is None:
+            if self._undefined_obj is missing:
+                return u"{{ %s }}" % self._undefined_name
+            return "{{ no such element: %s[%r] }}" % (
+                object_type_repr(self._undefined_obj),
+                self._undefined_name,
+            )
+        return u"{{ undefined value printed: %s }}" % self._undefined_hint
+
+
+@implements_to_string
+class StrictUndefined(Undefined):
+    """An undefined that barks on print and iteration as well as boolean
+    tests and all kinds of comparisons.  In other words: you can do nothing
+    with it except checking if it's defined using the `defined` test.
+
+    >>> foo = StrictUndefined(name='foo')
+    >>> str(foo)
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> not foo
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    >>> foo + 42
+    Traceback (most recent call last):
+      ...
+    jinja2.exceptions.UndefinedError: 'foo' is undefined
+    """
+
+    __slots__ = ()
+    __iter__ = (
+        __str__
+    ) = (
+        __len__
+    ) = (
+        __nonzero__
+    ) = __eq__ = __ne__ = __bool__ = __hash__ = Undefined._fail_with_undefined_error
+
+
+# remove remaining slots attributes, after the metaclass did the magic they
+# are unneeded and irritating as they contain wrong data for the subclasses.
+del (
+    Undefined.__slots__,
+    ChainableUndefined.__slots__,
+    DebugUndefined.__slots__,
+    StrictUndefined.__slots__,
+)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/sandbox.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/sandbox.py
new file mode 100644
index 0000000000000000000000000000000000000000..cfd7993aee3358d332495cbcbcc46336a191006f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/sandbox.py
@@ -0,0 +1,510 @@
+# -*- coding: utf-8 -*-
+"""A sandbox layer that ensures unsafe operations cannot be performed.
+Useful when the template itself comes from an untrusted source.
+"""
+import operator
+import types
+import warnings
+from collections import deque
+from string import Formatter
+
+from markupsafe import EscapeFormatter
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import PY2
+from ._compat import range_type
+from ._compat import string_types
+from .environment import Environment
+from .exceptions import SecurityError
+
+#: maximum number of items a range may produce
+MAX_RANGE = 100000
+
+#: attributes of function objects that are considered unsafe.
+if PY2:
+    UNSAFE_FUNCTION_ATTRIBUTES = {
+        "func_closure",
+        "func_code",
+        "func_dict",
+        "func_defaults",
+        "func_globals",
+    }
+else:
+    # On versions > python 2 the special attributes on functions are gone,
+    # but they remain on methods and generators for whatever reason.
+    UNSAFE_FUNCTION_ATTRIBUTES = set()
+
+#: unsafe method attributes.  function attributes are unsafe for methods too
+UNSAFE_METHOD_ATTRIBUTES = {"im_class", "im_func", "im_self"}
+
+#: unsafe generator attributes.
+UNSAFE_GENERATOR_ATTRIBUTES = {"gi_frame", "gi_code"}
+
+#: unsafe attributes on coroutines
+UNSAFE_COROUTINE_ATTRIBUTES = {"cr_frame", "cr_code"}
+
+#: unsafe attributes on async generators
+UNSAFE_ASYNC_GENERATOR_ATTRIBUTES = {"ag_code", "ag_frame"}
+
+# make sure we don't warn in python 2.6 about stuff we don't care about
+warnings.filterwarnings(
+    "ignore", "the sets module", DeprecationWarning, module=__name__
+)
+
+_mutable_set_types = (set,)
+_mutable_mapping_types = (dict,)
+_mutable_sequence_types = (list,)
+
+# on python 2.x we can register the user collection types
+try:
+    from UserDict import UserDict, DictMixin
+    from UserList import UserList
+
+    _mutable_mapping_types += (UserDict, DictMixin)
+    _mutable_set_types += (UserList,)
+except ImportError:
+    pass
+
+# if sets is still available, register the mutable set from there as well
+try:
+    from sets import Set
+
+    _mutable_set_types += (Set,)
+except ImportError:
+    pass
+
+#: register Python 2.6 abstract base classes
+_mutable_set_types += (abc.MutableSet,)
+_mutable_mapping_types += (abc.MutableMapping,)
+_mutable_sequence_types += (abc.MutableSequence,)
+
+_mutable_spec = (
+    (
+        _mutable_set_types,
+        frozenset(
+            [
+                "add",
+                "clear",
+                "difference_update",
+                "discard",
+                "pop",
+                "remove",
+                "symmetric_difference_update",
+                "update",
+            ]
+        ),
+    ),
+    (
+        _mutable_mapping_types,
+        frozenset(["clear", "pop", "popitem", "setdefault", "update"]),
+    ),
+    (
+        _mutable_sequence_types,
+        frozenset(["append", "reverse", "insert", "sort", "extend", "remove"]),
+    ),
+    (
+        deque,
+        frozenset(
+            [
+                "append",
+                "appendleft",
+                "clear",
+                "extend",
+                "extendleft",
+                "pop",
+                "popleft",
+                "remove",
+                "rotate",
+            ]
+        ),
+    ),
+)
+
+
+class _MagicFormatMapping(abc.Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See https://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+def inspect_format_method(callable):
+    if not isinstance(
+        callable, (types.MethodType, types.BuiltinMethodType)
+    ) or callable.__name__ not in ("format", "format_map"):
+        return None
+    obj = callable.__self__
+    if isinstance(obj, string_types):
+        return obj
+
+
+def safe_range(*args):
+    """A range that can't generate ranges with a length of more than
+    MAX_RANGE items.
+    """
+    rng = range_type(*args)
+
+    if len(rng) > MAX_RANGE:
+        raise OverflowError(
+            "Range too big. The sandbox blocks ranges larger than"
+            " MAX_RANGE (%d)." % MAX_RANGE
+        )
+
+    return rng
+
+
+def unsafe(f):
+    """Marks a function or method as unsafe.
+
+    ::
+
+        @unsafe
+        def delete(self):
+            pass
+    """
+    f.unsafe_callable = True
+    return f
+
+
+def is_internal_attribute(obj, attr):
+    """Test if the attribute given is an internal python attribute.  For
+    example this function returns `True` for the `func_code` attribute of
+    python objects.  This is useful if the environment method
+    :meth:`~SandboxedEnvironment.is_safe_attribute` is overridden.
+
+    >>> from jinja2.sandbox import is_internal_attribute
+    >>> is_internal_attribute(str, "mro")
+    True
+    >>> is_internal_attribute(str, "upper")
+    False
+    """
+    if isinstance(obj, types.FunctionType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES:
+            return True
+    elif isinstance(obj, types.MethodType):
+        if attr in UNSAFE_FUNCTION_ATTRIBUTES or attr in UNSAFE_METHOD_ATTRIBUTES:
+            return True
+    elif isinstance(obj, type):
+        if attr == "mro":
+            return True
+    elif isinstance(obj, (types.CodeType, types.TracebackType, types.FrameType)):
+        return True
+    elif isinstance(obj, types.GeneratorType):
+        if attr in UNSAFE_GENERATOR_ATTRIBUTES:
+            return True
+    elif hasattr(types, "CoroutineType") and isinstance(obj, types.CoroutineType):
+        if attr in UNSAFE_COROUTINE_ATTRIBUTES:
+            return True
+    elif hasattr(types, "AsyncGeneratorType") and isinstance(
+        obj, types.AsyncGeneratorType
+    ):
+        if attr in UNSAFE_ASYNC_GENERATOR_ATTRIBUTES:
+            return True
+    return attr.startswith("__")
+
+
+def modifies_known_mutable(obj, attr):
+    """This function checks if an attribute on a builtin mutable object
+    (list, dict, set or deque) would modify it if called.  It also supports
+    the "user"-versions of the objects (`sets.Set`, `UserDict.*` etc.) and
+    with Python 2.6 onwards the abstract base classes `MutableSet`,
+    `MutableMapping`, and `MutableSequence`.
+
+    >>> modifies_known_mutable({}, "clear")
+    True
+    >>> modifies_known_mutable({}, "keys")
+    False
+    >>> modifies_known_mutable([], "append")
+    True
+    >>> modifies_known_mutable([], "index")
+    False
+
+    If called with an unsupported object (such as unicode) `False` is
+    returned.
+
+    >>> modifies_known_mutable("foo", "upper")
+    False
+    """
+    for typespec, unsafe in _mutable_spec:
+        if isinstance(obj, typespec):
+            return attr in unsafe
+    return False
+
+
+class SandboxedEnvironment(Environment):
+    """The sandboxed environment.  It works like the regular environment but
+    tells the compiler to generate sandboxed code.  Additionally subclasses of
+    this environment may override the methods that tell the runtime what
+    attributes or functions are safe to access.
+
+    If the template tries to access insecure code a :exc:`SecurityError` is
+    raised.  However also other exceptions may occur during the rendering so
+    the caller has to ensure that all exceptions are caught.
+    """
+
+    sandboxed = True
+
+    #: default callback table for the binary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`binop_table`
+    default_binop_table = {
+        "+": operator.add,
+        "-": operator.sub,
+        "*": operator.mul,
+        "/": operator.truediv,
+        "//": operator.floordiv,
+        "**": operator.pow,
+        "%": operator.mod,
+    }
+
+    #: default callback table for the unary operators.  A copy of this is
+    #: available on each instance of a sandboxed environment as
+    #: :attr:`unop_table`
+    default_unop_table = {"+": operator.pos, "-": operator.neg}
+
+    #: a set of binary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_binop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`binop_table`.
+    #:
+    #: The following binary operators are interceptable:
+    #: ``//``, ``%``, ``+``, ``*``, ``-``, ``/``, and ``**``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_binops = frozenset()
+
+    #: a set of unary operators that should be intercepted.  Each operator
+    #: that is added to this set (empty by default) is delegated to the
+    #: :meth:`call_unop` method that will perform the operator.  The default
+    #: operator callback is specified by :attr:`unop_table`.
+    #:
+    #: The following unary operators are interceptable: ``+``, ``-``
+    #:
+    #: The default operation form the operator table corresponds to the
+    #: builtin function.  Intercepted calls are always slower than the native
+    #: operator call, so make sure only to intercept the ones you are
+    #: interested in.
+    #:
+    #: .. versionadded:: 2.6
+    intercepted_unops = frozenset()
+
+    def intercept_unop(self, operator):
+        """Called during template compilation with the name of a unary
+        operator to check if it should be intercepted at runtime.  If this
+        method returns `True`, :meth:`call_unop` is executed for this unary
+        operator.  The default implementation of :meth:`call_unop` will use
+        the :attr:`unop_table` dictionary to perform the operator with the
+        same logic as the builtin one.
+
+        The following unary operators are interceptable: ``+`` and ``-``
+
+        Intercepted calls are always slower than the native operator call,
+        so make sure only to intercept the ones you are interested in.
+
+        .. versionadded:: 2.6
+        """
+        return False
+
+    def __init__(self, *args, **kwargs):
+        Environment.__init__(self, *args, **kwargs)
+        self.globals["range"] = safe_range
+        self.binop_table = self.default_binop_table.copy()
+        self.unop_table = self.default_unop_table.copy()
+
+    def is_safe_attribute(self, obj, attr, value):
+        """The sandboxed environment will call this method to check if the
+        attribute of an object is safe to access.  Per default all attributes
+        starting with an underscore are considered private as well as the
+        special attributes of internal python objects as returned by the
+        :func:`is_internal_attribute` function.
+        """
+        return not (attr.startswith("_") or is_internal_attribute(obj, attr))
+
+    def is_safe_callable(self, obj):
+        """Check if an object is safely callable.  Per default a function is
+        considered safe unless the `unsafe_callable` attribute exists and is
+        True.  Override this method to alter the behavior, but this won't
+        affect the `unsafe` decorator from this module.
+        """
+        return not (
+            getattr(obj, "unsafe_callable", False) or getattr(obj, "alters_data", False)
+        )
+
+    def call_binop(self, context, operator, left, right):
+        """For intercepted binary operator calls (:meth:`intercepted_binops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.binop_table[operator](left, right)
+
+    def call_unop(self, context, operator, arg):
+        """For intercepted unary operator calls (:meth:`intercepted_unops`)
+        this function is executed instead of the builtin operator.  This can
+        be used to fine tune the behavior of certain operators.
+
+        .. versionadded:: 2.6
+        """
+        return self.unop_table[operator](arg)
+
+    def getitem(self, obj, argument):
+        """Subscribe an object from sandboxed code."""
+        try:
+            return obj[argument]
+        except (TypeError, LookupError):
+            if isinstance(argument, string_types):
+                try:
+                    attr = str(argument)
+                except Exception:
+                    pass
+                else:
+                    try:
+                        value = getattr(obj, attr)
+                    except AttributeError:
+                        pass
+                    else:
+                        if self.is_safe_attribute(obj, argument, value):
+                            return value
+                        return self.unsafe_undefined(obj, argument)
+        return self.undefined(obj=obj, name=argument)
+
+    def getattr(self, obj, attribute):
+        """Subscribe an object from sandboxed code and prefer the
+        attribute.  The attribute passed *must* be a bytestring.
+        """
+        try:
+            value = getattr(obj, attribute)
+        except AttributeError:
+            try:
+                return obj[attribute]
+            except (TypeError, LookupError):
+                pass
+        else:
+            if self.is_safe_attribute(obj, attribute, value):
+                return value
+            return self.unsafe_undefined(obj, attribute)
+        return self.undefined(obj=obj, name=attribute)
+
+    def unsafe_undefined(self, obj, attribute):
+        """Return an undefined object for unsafe attributes."""
+        return self.undefined(
+            "access to attribute %r of %r "
+            "object is unsafe." % (attribute, obj.__class__.__name__),
+            name=attribute,
+            obj=obj,
+            exc=SecurityError,
+        )
+
+    def format_string(self, s, args, kwargs, format_func=None):
+        """If a format call is detected, then this is routed through this
+        method so that our safety sandbox can be used for it.
+        """
+        if isinstance(s, Markup):
+            formatter = SandboxedEscapeFormatter(self, s.escape)
+        else:
+            formatter = SandboxedFormatter(self)
+
+        if format_func is not None and format_func.__name__ == "format_map":
+            if len(args) != 1 or kwargs:
+                raise TypeError(
+                    "format_map() takes exactly one argument %d given"
+                    % (len(args) + (kwargs is not None))
+                )
+
+            kwargs = args[0]
+            args = None
+
+        kwargs = _MagicFormatMapping(args, kwargs)
+        rv = formatter.vformat(s, args, kwargs)
+        return type(s)(rv)
+
+    def call(__self, __context, __obj, *args, **kwargs):  # noqa: B902
+        """Call an object from sandboxed code."""
+        fmt = inspect_format_method(__obj)
+        if fmt is not None:
+            return __self.format_string(fmt, args, kwargs, __obj)
+
+        # the double prefixes are to avoid double keyword argument
+        # errors when proxying the call.
+        if not __self.is_safe_callable(__obj):
+            raise SecurityError("%r is not safely callable" % (__obj,))
+        return __context.call(__obj, *args, **kwargs)
+
+
+class ImmutableSandboxedEnvironment(SandboxedEnvironment):
+    """Works exactly like the regular `SandboxedEnvironment` but does not
+    permit modifications on the builtin mutable objects `list`, `set`, and
+    `dict` by using the :func:`modifies_known_mutable` function.
+    """
+
+    def is_safe_attribute(self, obj, attr, value):
+        if not SandboxedEnvironment.is_safe_attribute(self, obj, attr, value):
+            return False
+        return not modifies_known_mutable(obj, attr)
+
+
+# This really is not a public API apparently.
+try:
+    from _string import formatter_field_name_split
+except ImportError:
+
+    def formatter_field_name_split(field_name):
+        return field_name._formatter_field_name_split()
+
+
+class SandboxedFormatterMixin(object):
+    def __init__(self, env):
+        self._env = env
+
+    def get_field(self, field_name, args, kwargs):
+        first, rest = formatter_field_name_split(field_name)
+        obj = self.get_value(first, args, kwargs)
+        for is_attr, i in rest:
+            if is_attr:
+                obj = self._env.getattr(obj, i)
+            else:
+                obj = self._env.getitem(obj, i)
+        return obj, first
+
+
+class SandboxedFormatter(SandboxedFormatterMixin, Formatter):
+    def __init__(self, env):
+        SandboxedFormatterMixin.__init__(self, env)
+        Formatter.__init__(self)
+
+
+class SandboxedEscapeFormatter(SandboxedFormatterMixin, EscapeFormatter):
+    def __init__(self, env, escape):
+        SandboxedFormatterMixin.__init__(self, env)
+        EscapeFormatter.__init__(self, escape)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/tests.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/tests.py
new file mode 100644
index 0000000000000000000000000000000000000000..fabd4ce51b6a049955d903762986974f59c625d0
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/tests.py
@@ -0,0 +1,215 @@
+# -*- coding: utf-8 -*-
+"""Built-in template tests used with the ``is`` operator."""
+import decimal
+import operator
+import re
+
+from ._compat import abc
+from ._compat import integer_types
+from ._compat import string_types
+from ._compat import text_type
+from .runtime import Undefined
+
+number_re = re.compile(r"^-?\d+(\.\d+)?$")
+regex_type = type(number_re)
+test_callable = callable
+
+
+def test_odd(value):
+    """Return true if the variable is odd."""
+    return value % 2 == 1
+
+
+def test_even(value):
+    """Return true if the variable is even."""
+    return value % 2 == 0
+
+
+def test_divisibleby(value, num):
+    """Check if a variable is divisible by a number."""
+    return value % num == 0
+
+
+def test_defined(value):
+    """Return true if the variable is defined:
+
+    .. sourcecode:: jinja
+
+        {% if variable is defined %}
+            value of variable: {{ variable }}
+        {% else %}
+            variable is not defined
+        {% endif %}
+
+    See the :func:`default` filter for a simple way to set undefined
+    variables.
+    """
+    return not isinstance(value, Undefined)
+
+
+def test_undefined(value):
+    """Like :func:`defined` but the other way round."""
+    return isinstance(value, Undefined)
+
+
+def test_none(value):
+    """Return true if the variable is none."""
+    return value is None
+
+
+def test_boolean(value):
+    """Return true if the object is a boolean value.
+
+    .. versionadded:: 2.11
+    """
+    return value is True or value is False
+
+
+def test_false(value):
+    """Return true if the object is False.
+
+    .. versionadded:: 2.11
+    """
+    return value is False
+
+
+def test_true(value):
+    """Return true if the object is True.
+
+    .. versionadded:: 2.11
+    """
+    return value is True
+
+
+# NOTE: The existing 'number' test matches booleans and floats
+def test_integer(value):
+    """Return true if the object is an integer.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, integer_types) and value is not True and value is not False
+
+
+# NOTE: The existing 'number' test matches booleans and integers
+def test_float(value):
+    """Return true if the object is a float.
+
+    .. versionadded:: 2.11
+    """
+    return isinstance(value, float)
+
+
+def test_lower(value):
+    """Return true if the variable is lowercased."""
+    return text_type(value).islower()
+
+
+def test_upper(value):
+    """Return true if the variable is uppercased."""
+    return text_type(value).isupper()
+
+
+def test_string(value):
+    """Return true if the object is a string."""
+    return isinstance(value, string_types)
+
+
+def test_mapping(value):
+    """Return true if the object is a mapping (dict etc.).
+
+    .. versionadded:: 2.6
+    """
+    return isinstance(value, abc.Mapping)
+
+
+def test_number(value):
+    """Return true if the variable is a number."""
+    return isinstance(value, integer_types + (float, complex, decimal.Decimal))
+
+
+def test_sequence(value):
+    """Return true if the variable is a sequence. Sequences are variables
+    that are iterable.
+    """
+    try:
+        len(value)
+        value.__getitem__
+    except Exception:
+        return False
+    return True
+
+
+def test_sameas(value, other):
+    """Check if an object points to the same memory address than another
+    object:
+
+    .. sourcecode:: jinja
+
+        {% if foo.attribute is sameas false %}
+            the foo attribute really is the `False` singleton
+        {% endif %}
+    """
+    return value is other
+
+
+def test_iterable(value):
+    """Check if it's possible to iterate over an object."""
+    try:
+        iter(value)
+    except TypeError:
+        return False
+    return True
+
+
+def test_escaped(value):
+    """Check if the value is escaped."""
+    return hasattr(value, "__html__")
+
+
+def test_in(value, seq):
+    """Check if value is in seq.
+
+    .. versionadded:: 2.10
+    """
+    return value in seq
+
+
+TESTS = {
+    "odd": test_odd,
+    "even": test_even,
+    "divisibleby": test_divisibleby,
+    "defined": test_defined,
+    "undefined": test_undefined,
+    "none": test_none,
+    "boolean": test_boolean,
+    "false": test_false,
+    "true": test_true,
+    "integer": test_integer,
+    "float": test_float,
+    "lower": test_lower,
+    "upper": test_upper,
+    "string": test_string,
+    "mapping": test_mapping,
+    "number": test_number,
+    "sequence": test_sequence,
+    "iterable": test_iterable,
+    "callable": test_callable,
+    "sameas": test_sameas,
+    "escaped": test_escaped,
+    "in": test_in,
+    "==": operator.eq,
+    "eq": operator.eq,
+    "equalto": operator.eq,
+    "!=": operator.ne,
+    "ne": operator.ne,
+    ">": operator.gt,
+    "gt": operator.gt,
+    "greaterthan": operator.gt,
+    "ge": operator.ge,
+    ">=": operator.ge,
+    "<": operator.lt,
+    "lt": operator.lt,
+    "lessthan": operator.lt,
+    "<=": operator.le,
+    "le": operator.le,
+}
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/utils.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/utils.py
new file mode 100644
index 0000000000000000000000000000000000000000..b422ba9686fa5f3224564c7af4db7f4ce7ca3368
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/utils.py
@@ -0,0 +1,732 @@
+# -*- coding: utf-8 -*-
+import json
+import os
+import re
+import warnings
+from collections import deque
+from random import choice
+from random import randrange
+from threading import Lock
+
+from markupsafe import escape
+from markupsafe import Markup
+
+from ._compat import abc
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import url_quote
+
+_word_split_re = re.compile(r"(\s+)")
+_punctuation_re = re.compile(
+    "^(?P<lead>(?:%s)*)(?P<middle>.*?)(?P<trail>(?:%s)*)$"
+    % (
+        "|".join(map(re.escape, ("(", "<", "&lt;"))),
+        "|".join(map(re.escape, (".", ",", ")", ">", "\n", "&gt;"))),
+    )
+)
+_simple_email_re = re.compile(r"^\S+@[a-zA-Z0-9._-]+\.[a-zA-Z0-9._-]+$")
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^;]+);")
+_letters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
+_digits = "0123456789"
+
+# special singleton representing missing values for the runtime
+missing = type("MissingType", (), {"__repr__": lambda x: "missing"})()
+
+# internal code
+internal_code = set()
+
+concat = u"".join
+
+_slash_escape = "\\/" not in json.dumps("/")
+
+
+def contextfunction(f):
+    """This decorator can be used to mark a function or method context callable.
+    A context callable is passed the active :class:`Context` as first argument when
+    called from the template.  This is useful if a function wants to get access
+    to the context or functions provided on the context object.  For example
+    a function that returns a sorted list of template variables the current
+    template exports could look like this::
+
+        @contextfunction
+        def get_exported_names(context):
+            return sorted(context.exported_vars)
+    """
+    f.contextfunction = True
+    return f
+
+
+def evalcontextfunction(f):
+    """This decorator can be used to mark a function or method as an eval
+    context callable.  This is similar to the :func:`contextfunction`
+    but instead of passing the context, an evaluation context object is
+    passed.  For more information about the eval context, see
+    :ref:`eval-context`.
+
+    .. versionadded:: 2.4
+    """
+    f.evalcontextfunction = True
+    return f
+
+
+def environmentfunction(f):
+    """This decorator can be used to mark a function or method as environment
+    callable.  This decorator works exactly like the :func:`contextfunction`
+    decorator just that the first argument is the active :class:`Environment`
+    and not context.
+    """
+    f.environmentfunction = True
+    return f
+
+
+def internalcode(f):
+    """Marks the function as internally used"""
+    internal_code.add(f.__code__)
+    return f
+
+
+def is_undefined(obj):
+    """Check if the object passed is undefined.  This does nothing more than
+    performing an instance check against :class:`Undefined` but looks nicer.
+    This can be used for custom filters or tests that want to react to
+    undefined variables.  For example a custom default filter can look like
+    this::
+
+        def default(var, default=''):
+            if is_undefined(var):
+                return default
+            return var
+    """
+    from .runtime import Undefined
+
+    return isinstance(obj, Undefined)
+
+
+def consume(iterable):
+    """Consumes an iterable without doing anything with it."""
+    for _ in iterable:
+        pass
+
+
+def clear_caches():
+    """Jinja keeps internal caches for environments and lexers.  These are
+    used so that Jinja doesn't have to recreate environments and lexers all
+    the time.  Normally you don't have to care about that but if you are
+    measuring memory consumption you may want to clean the caches.
+    """
+    from .environment import _spontaneous_environments
+    from .lexer import _lexer_cache
+
+    _spontaneous_environments.clear()
+    _lexer_cache.clear()
+
+
+def import_string(import_name, silent=False):
+    """Imports an object based on a string.  This is useful if you want to
+    use import paths as endpoints or something similar.  An import path can
+    be specified either in dotted notation (``xml.sax.saxutils.escape``)
+    or with a colon as object delimiter (``xml.sax.saxutils:escape``).
+
+    If the `silent` is True the return value will be `None` if the import
+    fails.
+
+    :return: imported object
+    """
+    try:
+        if ":" in import_name:
+            module, obj = import_name.split(":", 1)
+        elif "." in import_name:
+            module, _, obj = import_name.rpartition(".")
+        else:
+            return __import__(import_name)
+        return getattr(__import__(module, None, None, [obj]), obj)
+    except (ImportError, AttributeError):
+        if not silent:
+            raise
+
+
+def open_if_exists(filename, mode="rb"):
+    """Returns a file descriptor for the filename if that file exists,
+    otherwise ``None``.
+    """
+    if not os.path.isfile(filename):
+        return None
+
+    return open(filename, mode)
+
+
+def object_type_repr(obj):
+    """Returns the name of the object's type.  For some recognized
+    singletons the name of the object is returned instead. (For
+    example for `None` and `Ellipsis`).
+    """
+    if obj is None:
+        return "None"
+    elif obj is Ellipsis:
+        return "Ellipsis"
+
+    cls = type(obj)
+
+    # __builtin__ in 2.x, builtins in 3.x
+    if cls.__module__ in ("__builtin__", "builtins"):
+        name = cls.__name__
+    else:
+        name = cls.__module__ + "." + cls.__name__
+
+    return "%s object" % name
+
+
+def pformat(obj, verbose=False):
+    """Prettyprint an object.  Either use the `pretty` library or the
+    builtin `pprint`.
+    """
+    try:
+        from pretty import pretty
+
+        return pretty(obj, verbose=verbose)
+    except ImportError:
+        from pprint import pformat
+
+        return pformat(obj)
+
+
+def urlize(text, trim_url_limit=None, rel=None, target=None):
+    """Converts any URLs in text into clickable links. Works on http://,
+    https:// and www. links. Links can have trailing punctuation (periods,
+    commas, close-parens) and leading punctuation (opening parens) and
+    it'll still do the right thing.
+
+    If trim_url_limit is not None, the URLs in link text will be limited
+    to trim_url_limit characters.
+
+    If nofollow is True, the URLs in link text will get a rel="nofollow"
+    attribute.
+
+    If target is not None, a target attribute will be added to the link.
+    """
+    trim_url = (
+        lambda x, limit=trim_url_limit: limit is not None
+        and (x[:limit] + (len(x) >= limit and "..." or ""))
+        or x
+    )
+    words = _word_split_re.split(text_type(escape(text)))
+    rel_attr = rel and ' rel="%s"' % text_type(escape(rel)) or ""
+    target_attr = target and ' target="%s"' % escape(target) or ""
+
+    for i, word in enumerate(words):
+        match = _punctuation_re.match(word)
+        if match:
+            lead, middle, trail = match.groups()
+            if middle.startswith("www.") or (
+                "@" not in middle
+                and not middle.startswith("http://")
+                and not middle.startswith("https://")
+                and len(middle) > 0
+                and middle[0] in _letters + _digits
+                and (
+                    middle.endswith(".org")
+                    or middle.endswith(".net")
+                    or middle.endswith(".com")
+                )
+            ):
+                middle = '<a href="http://%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if middle.startswith("http://") or middle.startswith("https://"):
+                middle = '<a href="%s"%s%s>%s</a>' % (
+                    middle,
+                    rel_attr,
+                    target_attr,
+                    trim_url(middle),
+                )
+            if (
+                "@" in middle
+                and not middle.startswith("www.")
+                and ":" not in middle
+                and _simple_email_re.match(middle)
+            ):
+                middle = '<a href="mailto:%s">%s</a>' % (middle, middle)
+            if lead + middle + trail != word:
+                words[i] = lead + middle + trail
+    return u"".join(words)
+
+
+def generate_lorem_ipsum(n=5, html=True, min=20, max=100):
+    """Generate some lorem ipsum for the template."""
+    from .constants import LOREM_IPSUM_WORDS
+
+    words = LOREM_IPSUM_WORDS.split()
+    result = []
+
+    for _ in range(n):
+        next_capitalized = True
+        last_comma = last_fullstop = 0
+        word = None
+        last = None
+        p = []
+
+        # each paragraph contains out of 20 to 100 words.
+        for idx, _ in enumerate(range(randrange(min, max))):
+            while True:
+                word = choice(words)
+                if word != last:
+                    last = word
+                    break
+            if next_capitalized:
+                word = word.capitalize()
+                next_capitalized = False
+            # add commas
+            if idx - randrange(3, 8) > last_comma:
+                last_comma = idx
+                last_fullstop += 2
+                word += ","
+            # add end of sentences
+            if idx - randrange(10, 20) > last_fullstop:
+                last_comma = last_fullstop = idx
+                word += "."
+                next_capitalized = True
+            p.append(word)
+
+        # ensure that the paragraph ends with a dot.
+        p = u" ".join(p)
+        if p.endswith(","):
+            p = p[:-1] + "."
+        elif not p.endswith("."):
+            p += "."
+        result.append(p)
+
+    if not html:
+        return u"\n\n".join(result)
+    return Markup(u"\n".join(u"<p>%s</p>" % escape(x) for x in result))
+
+
+def unicode_urlencode(obj, charset="utf-8", for_qs=False):
+    """Quote a string for use in a URL using the given charset.
+
+    This function is misnamed, it is a wrapper around
+    :func:`urllib.parse.quote`.
+
+    :param obj: String or bytes to quote. Other types are converted to
+        string then encoded to bytes using the given charset.
+    :param charset: Encode text to bytes using this charset.
+    :param for_qs: Quote "/" and use "+" for spaces.
+    """
+    if not isinstance(obj, string_types):
+        obj = text_type(obj)
+
+    if isinstance(obj, text_type):
+        obj = obj.encode(charset)
+
+    safe = b"" if for_qs else b"/"
+    rv = url_quote(obj, safe)
+
+    if not isinstance(rv, text_type):
+        rv = rv.decode("utf-8")
+
+    if for_qs:
+        rv = rv.replace("%20", "+")
+
+    return rv
+
+
+class LRUCache(object):
+    """A simple LRU Cache implementation."""
+
+    # this is fast for small capacities (something below 1000) but doesn't
+    # scale.  But as long as it's only used as storage for templates this
+    # won't do any harm.
+
+    def __init__(self, capacity):
+        self.capacity = capacity
+        self._mapping = {}
+        self._queue = deque()
+        self._postinit()
+
+    def _postinit(self):
+        # alias all queue methods for faster lookup
+        self._popleft = self._queue.popleft
+        self._pop = self._queue.pop
+        self._remove = self._queue.remove
+        self._wlock = Lock()
+        self._append = self._queue.append
+
+    def __getstate__(self):
+        return {
+            "capacity": self.capacity,
+            "_mapping": self._mapping,
+            "_queue": self._queue,
+        }
+
+    def __setstate__(self, d):
+        self.__dict__.update(d)
+        self._postinit()
+
+    def __getnewargs__(self):
+        return (self.capacity,)
+
+    def copy(self):
+        """Return a shallow copy of the instance."""
+        rv = self.__class__(self.capacity)
+        rv._mapping.update(self._mapping)
+        rv._queue.extend(self._queue)
+        return rv
+
+    def get(self, key, default=None):
+        """Return an item from the cache dict or `default`"""
+        try:
+            return self[key]
+        except KeyError:
+            return default
+
+    def setdefault(self, key, default=None):
+        """Set `default` if the key is not in the cache otherwise
+        leave unchanged. Return the value of this key.
+        """
+        try:
+            return self[key]
+        except KeyError:
+            self[key] = default
+            return default
+
+    def clear(self):
+        """Clear the cache."""
+        self._wlock.acquire()
+        try:
+            self._mapping.clear()
+            self._queue.clear()
+        finally:
+            self._wlock.release()
+
+    def __contains__(self, key):
+        """Check if a key exists in this cache."""
+        return key in self._mapping
+
+    def __len__(self):
+        """Return the current size of the cache."""
+        return len(self._mapping)
+
+    def __repr__(self):
+        return "<%s %r>" % (self.__class__.__name__, self._mapping)
+
+    def __getitem__(self, key):
+        """Get an item from the cache. Moves the item up so that it has the
+        highest priority then.
+
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            rv = self._mapping[key]
+            if self._queue[-1] != key:
+                try:
+                    self._remove(key)
+                except ValueError:
+                    # if something removed the key from the container
+                    # when we read, ignore the ValueError that we would
+                    # get otherwise.
+                    pass
+                self._append(key)
+            return rv
+        finally:
+            self._wlock.release()
+
+    def __setitem__(self, key, value):
+        """Sets the value for an item. Moves the item up so that it
+        has the highest priority then.
+        """
+        self._wlock.acquire()
+        try:
+            if key in self._mapping:
+                self._remove(key)
+            elif len(self._mapping) == self.capacity:
+                del self._mapping[self._popleft()]
+            self._append(key)
+            self._mapping[key] = value
+        finally:
+            self._wlock.release()
+
+    def __delitem__(self, key):
+        """Remove an item from the cache dict.
+        Raise a `KeyError` if it does not exist.
+        """
+        self._wlock.acquire()
+        try:
+            del self._mapping[key]
+            try:
+                self._remove(key)
+            except ValueError:
+                pass
+        finally:
+            self._wlock.release()
+
+    def items(self):
+        """Return a list of items."""
+        result = [(key, self._mapping[key]) for key in list(self._queue)]
+        result.reverse()
+        return result
+
+    def iteritems(self):
+        """Iterate over all items."""
+        warnings.warn(
+            "'iteritems()' will be removed in version 3.0. Use"
+            " 'iter(cache.items())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.items())
+
+    def values(self):
+        """Return a list of all values."""
+        return [x[1] for x in self.items()]
+
+    def itervalue(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalue()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def itervalues(self):
+        """Iterate over all values."""
+        warnings.warn(
+            "'itervalues()' will be removed in version 3.0. Use"
+            " 'iter(cache.values())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self.values())
+
+    def keys(self):
+        """Return a list of all keys ordered by most recent usage."""
+        return list(self)
+
+    def iterkeys(self):
+        """Iterate over all keys in the cache dict, ordered by
+        the most recent usage.
+        """
+        warnings.warn(
+            "'iterkeys()' will be removed in version 3.0. Use"
+            " 'iter(cache.keys())' instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return iter(self)
+
+    def __iter__(self):
+        return reversed(tuple(self._queue))
+
+    def __reversed__(self):
+        """Iterate over the keys in the cache dict, oldest items
+        coming first.
+        """
+        return iter(tuple(self._queue))
+
+    __copy__ = copy
+
+
+abc.MutableMapping.register(LRUCache)
+
+
+def select_autoescape(
+    enabled_extensions=("html", "htm", "xml"),
+    disabled_extensions=(),
+    default_for_string=True,
+    default=False,
+):
+    """Intelligently sets the initial value of autoescaping based on the
+    filename of the template.  This is the recommended way to configure
+    autoescaping if you do not want to write a custom function yourself.
+
+    If you want to enable it for all templates created from strings or
+    for all templates with `.html` and `.xml` extensions::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            enabled_extensions=('html', 'xml'),
+            default_for_string=True,
+        ))
+
+    Example configuration to turn it on at all times except if the template
+    ends with `.txt`::
+
+        from jinja2 import Environment, select_autoescape
+        env = Environment(autoescape=select_autoescape(
+            disabled_extensions=('txt',),
+            default_for_string=True,
+            default=True,
+        ))
+
+    The `enabled_extensions` is an iterable of all the extensions that
+    autoescaping should be enabled for.  Likewise `disabled_extensions` is
+    a list of all templates it should be disabled for.  If a template is
+    loaded from a string then the default from `default_for_string` is used.
+    If nothing matches then the initial value of autoescaping is set to the
+    value of `default`.
+
+    For security reasons this function operates case insensitive.
+
+    .. versionadded:: 2.9
+    """
+    enabled_patterns = tuple("." + x.lstrip(".").lower() for x in enabled_extensions)
+    disabled_patterns = tuple("." + x.lstrip(".").lower() for x in disabled_extensions)
+
+    def autoescape(template_name):
+        if template_name is None:
+            return default_for_string
+        template_name = template_name.lower()
+        if template_name.endswith(enabled_patterns):
+            return True
+        if template_name.endswith(disabled_patterns):
+            return False
+        return default
+
+    return autoescape
+
+
+def htmlsafe_json_dumps(obj, dumper=None, **kwargs):
+    """Works exactly like :func:`dumps` but is safe for use in ``<script>``
+    tags.  It accepts the same arguments and returns a JSON string.  Note that
+    this is available in templates through the ``|tojson`` filter which will
+    also mark the result as safe.  Due to how this function escapes certain
+    characters this is safe even if used outside of ``<script>`` tags.
+
+    The following characters are escaped in strings:
+
+    -   ``<``
+    -   ``>``
+    -   ``&``
+    -   ``'``
+
+    This makes it safe to embed such strings in any place in HTML with the
+    notable exception of double quoted attributes.  In that case single
+    quote your attributes or HTML escape it in addition.
+    """
+    if dumper is None:
+        dumper = json.dumps
+    rv = (
+        dumper(obj, **kwargs)
+        .replace(u"<", u"\\u003c")
+        .replace(u">", u"\\u003e")
+        .replace(u"&", u"\\u0026")
+        .replace(u"'", u"\\u0027")
+    )
+    return Markup(rv)
+
+
+class Cycler(object):
+    """Cycle through values by yield them one at a time, then restarting
+    once the end is reached. Available as ``cycler`` in templates.
+
+    Similar to ``loop.cycle``, but can be used outside loops or across
+    multiple loops. For example, render a list of folders and files in a
+    list, alternating giving them "odd" and "even" classes.
+
+    .. code-block:: html+jinja
+
+        {% set row_class = cycler("odd", "even") %}
+        <ul class="browser">
+        {% for folder in folders %}
+          <li class="folder {{ row_class.next() }}">{{ folder }}
+        {% endfor %}
+        {% for file in files %}
+          <li class="file {{ row_class.next() }}">{{ file }}
+        {% endfor %}
+        </ul>
+
+    :param items: Each positional argument will be yielded in the order
+        given for each cycle.
+
+    .. versionadded:: 2.1
+    """
+
+    def __init__(self, *items):
+        if not items:
+            raise RuntimeError("at least one item has to be provided")
+        self.items = items
+        self.pos = 0
+
+    def reset(self):
+        """Resets the current item to the first item."""
+        self.pos = 0
+
+    @property
+    def current(self):
+        """Return the current item. Equivalent to the item that will be
+        returned next time :meth:`next` is called.
+        """
+        return self.items[self.pos]
+
+    def next(self):
+        """Return the current item, then advance :attr:`current` to the
+        next item.
+        """
+        rv = self.current
+        self.pos = (self.pos + 1) % len(self.items)
+        return rv
+
+    __next__ = next
+
+
+class Joiner(object):
+    """A joining helper for templates."""
+
+    def __init__(self, sep=u", "):
+        self.sep = sep
+        self.used = False
+
+    def __call__(self):
+        if not self.used:
+            self.used = True
+            return u""
+        return self.sep
+
+
+class Namespace(object):
+    """A namespace object that can hold arbitrary attributes.  It may be
+    initialized from a dictionary or with keyword arguments."""
+
+    def __init__(*args, **kwargs):  # noqa: B902
+        self, args = args[0], args[1:]
+        self.__attrs = dict(*args, **kwargs)
+
+    def __getattribute__(self, name):
+        # __class__ is needed for the awaitable check in async mode
+        if name in {"_Namespace__attrs", "__class__"}:
+            return object.__getattribute__(self, name)
+        try:
+            return self.__attrs[name]
+        except KeyError:
+            raise AttributeError(name)
+
+    def __setitem__(self, name, value):
+        self.__attrs[name] = value
+
+    def __repr__(self):
+        return "<Namespace %r>" % self.__attrs
+
+
+# does this python version support async for in and async generators?
+try:
+    exec("async def _():\n async for _ in ():\n  yield _")
+    have_async_gen = True
+except SyntaxError:
+    have_async_gen = False
+
+
+def soft_unicode(s):
+    from markupsafe import soft_unicode
+
+    warnings.warn(
+        "'jinja2.utils.soft_unicode' will be removed in version 3.0."
+        " Use 'markupsafe.soft_unicode' instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return soft_unicode(s)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/visitor.py b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/visitor.py
new file mode 100644
index 0000000000000000000000000000000000000000..d1365bf10e5346a60df625faa5e118d4086b1395
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/jinja2/visitor.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""API for traversing the AST nodes. Implemented by the compiler and
+meta introspection.
+"""
+from .nodes import Node
+
+
+class NodeVisitor(object):
+    """Walks the abstract syntax tree and call visitor functions for every
+    node found.  The visitor functions may return values which will be
+    forwarded by the `visit` method.
+
+    Per default the visitor functions for the nodes are ``'visit_'`` +
+    class name of the node.  So a `TryFinally` node visit function would
+    be `visit_TryFinally`.  This behavior can be changed by overriding
+    the `get_visitor` function.  If no visitor function exists for a node
+    (return value `None`) the `generic_visit` visitor is used instead.
+    """
+
+    def get_visitor(self, node):
+        """Return the visitor function for this node or `None` if no visitor
+        exists for this node.  In that case the generic visit function is
+        used instead.
+        """
+        method = "visit_" + node.__class__.__name__
+        return getattr(self, method, None)
+
+    def visit(self, node, *args, **kwargs):
+        """Visit a node."""
+        f = self.get_visitor(node)
+        if f is not None:
+            return f(node, *args, **kwargs)
+        return self.generic_visit(node, *args, **kwargs)
+
+    def generic_visit(self, node, *args, **kwargs):
+        """Called if no explicit visitor function exists for a node."""
+        for node in node.iter_child_nodes():
+            self.visit(node, *args, **kwargs)
+
+
+class NodeTransformer(NodeVisitor):
+    """Walks the abstract syntax tree and allows modifications of nodes.
+
+    The `NodeTransformer` will walk the AST and use the return value of the
+    visitor functions to replace or remove the old node.  If the return
+    value of the visitor function is `None` the node will be removed
+    from the previous location otherwise it's replaced with the return
+    value.  The return value may be the original node in which case no
+    replacement takes place.
+    """
+
+    def generic_visit(self, node, *args, **kwargs):
+        for field, old_value in node.iter_fields():
+            if isinstance(old_value, list):
+                new_values = []
+                for value in old_value:
+                    if isinstance(value, Node):
+                        value = self.visit(value, *args, **kwargs)
+                        if value is None:
+                            continue
+                        elif not isinstance(value, Node):
+                            new_values.extend(value)
+                            continue
+                    new_values.append(value)
+                old_value[:] = new_values
+            elif isinstance(old_value, Node):
+                new_node = self.visit(old_value, *args, **kwargs)
+                if new_node is None:
+                    delattr(node, field)
+                else:
+                    setattr(node, field, new_node)
+        return node
+
+    def visit_list(self, node, *args, **kwargs):
+        """As transformers may return lists in some places this method
+        can be used to enforce a list as return value.
+        """
+        rv = self.visit(node, *args, **kwargs)
+        if not isinstance(rv, list):
+            rv = [rv]
+        return rv
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/__init__.py b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..da05ed328a476bdcea7c0bd4d335d9e721cbab77
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/__init__.py
@@ -0,0 +1,327 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe
+~~~~~~~~~~
+
+Implements an escape function and a Markup string to replace HTML
+special characters with safe representations.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import re
+import string
+
+from ._compat import int_types
+from ._compat import iteritems
+from ._compat import Mapping
+from ._compat import PY2
+from ._compat import string_types
+from ._compat import text_type
+from ._compat import unichr
+
+__version__ = "1.1.1"
+
+__all__ = ["Markup", "soft_unicode", "escape", "escape_silent"]
+
+_striptags_re = re.compile(r"(<!--.*?-->|<[^>]*>)")
+_entity_re = re.compile(r"&([^& ;]+);")
+
+
+class Markup(text_type):
+    """A string that is ready to be safely inserted into an HTML or XML
+    document, either because it was escaped or because it was marked
+    safe.
+
+    Passing an object to the constructor converts it to text and wraps
+    it to mark it safe without escaping. To escape the text, use the
+    :meth:`escape` class method instead.
+
+    >>> Markup('Hello, <em>World</em>!')
+    Markup('Hello, <em>World</em>!')
+    >>> Markup(42)
+    Markup('42')
+    >>> Markup.escape('Hello, <em>World</em>!')
+    Markup('Hello &lt;em&gt;World&lt;/em&gt;!')
+
+    This implements the ``__html__()`` interface that some frameworks
+    use. Passing an object that implements ``__html__()`` will wrap the
+    output of that method, marking it safe.
+
+    >>> class Foo:
+    ...     def __html__(self):
+    ...         return '<a href="/foo">foo</a>'
+    ...
+    >>> Markup(Foo())
+    Markup('<a href="/foo">foo</a>')
+
+    This is a subclass of the text type (``str`` in Python 3,
+    ``unicode`` in Python 2). It has the same methods as that type, but
+    all methods escape their arguments and return a ``Markup`` instance.
+
+    >>> Markup('<em>%s</em>') % 'foo & bar'
+    Markup('<em>foo &amp; bar</em>')
+    >>> Markup('<em>Hello</em> ') + '<foo>'
+    Markup('<em>Hello</em> &lt;foo&gt;')
+    """
+
+    __slots__ = ()
+
+    def __new__(cls, base=u"", encoding=None, errors="strict"):
+        if hasattr(base, "__html__"):
+            base = base.__html__()
+        if encoding is None:
+            return text_type.__new__(cls, base)
+        return text_type.__new__(cls, base, encoding, errors)
+
+    def __html__(self):
+        return self
+
+    def __add__(self, other):
+        if isinstance(other, string_types) or hasattr(other, "__html__"):
+            return self.__class__(super(Markup, self).__add__(self.escape(other)))
+        return NotImplemented
+
+    def __radd__(self, other):
+        if hasattr(other, "__html__") or isinstance(other, string_types):
+            return self.escape(other).__add__(self)
+        return NotImplemented
+
+    def __mul__(self, num):
+        if isinstance(num, int_types):
+            return self.__class__(text_type.__mul__(self, num))
+        return NotImplemented
+
+    __rmul__ = __mul__
+
+    def __mod__(self, arg):
+        if isinstance(arg, tuple):
+            arg = tuple(_MarkupEscapeHelper(x, self.escape) for x in arg)
+        else:
+            arg = _MarkupEscapeHelper(arg, self.escape)
+        return self.__class__(text_type.__mod__(self, arg))
+
+    def __repr__(self):
+        return "%s(%s)" % (self.__class__.__name__, text_type.__repr__(self))
+
+    def join(self, seq):
+        return self.__class__(text_type.join(self, map(self.escape, seq)))
+
+    join.__doc__ = text_type.join.__doc__
+
+    def split(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.split(self, *args, **kwargs)))
+
+    split.__doc__ = text_type.split.__doc__
+
+    def rsplit(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.rsplit(self, *args, **kwargs)))
+
+    rsplit.__doc__ = text_type.rsplit.__doc__
+
+    def splitlines(self, *args, **kwargs):
+        return list(map(self.__class__, text_type.splitlines(self, *args, **kwargs)))
+
+    splitlines.__doc__ = text_type.splitlines.__doc__
+
+    def unescape(self):
+        """Convert escaped markup back into a text string. This replaces
+        HTML entities with the characters they represent.
+
+        >>> Markup('Main &raquo; <em>About</em>').unescape()
+        'Main » <em>About</em>'
+        """
+        from ._constants import HTML_ENTITIES
+
+        def handle_match(m):
+            name = m.group(1)
+            if name in HTML_ENTITIES:
+                return unichr(HTML_ENTITIES[name])
+            try:
+                if name[:2] in ("#x", "#X"):
+                    return unichr(int(name[2:], 16))
+                elif name.startswith("#"):
+                    return unichr(int(name[1:]))
+            except ValueError:
+                pass
+            # Don't modify unexpected input.
+            return m.group()
+
+        return _entity_re.sub(handle_match, text_type(self))
+
+    def striptags(self):
+        """:meth:`unescape` the markup, remove tags, and normalize
+        whitespace to single spaces.
+
+        >>> Markup('Main &raquo;\t<em>About</em>').striptags()
+        'Main » About'
+        """
+        stripped = u" ".join(_striptags_re.sub("", self).split())
+        return Markup(stripped).unescape()
+
+    @classmethod
+    def escape(cls, s):
+        """Escape a string. Calls :func:`escape` and ensures that for
+        subclasses the correct type is returned.
+        """
+        rv = escape(s)
+        if rv.__class__ is not cls:
+            return cls(rv)
+        return rv
+
+    def make_simple_escaping_wrapper(name):  # noqa: B902
+        orig = getattr(text_type, name)
+
+        def func(self, *args, **kwargs):
+            args = _escape_argspec(list(args), enumerate(args), self.escape)
+            _escape_argspec(kwargs, iteritems(kwargs), self.escape)
+            return self.__class__(orig(self, *args, **kwargs))
+
+        func.__name__ = orig.__name__
+        func.__doc__ = orig.__doc__
+        return func
+
+    for method in (
+        "__getitem__",
+        "capitalize",
+        "title",
+        "lower",
+        "upper",
+        "replace",
+        "ljust",
+        "rjust",
+        "lstrip",
+        "rstrip",
+        "center",
+        "strip",
+        "translate",
+        "expandtabs",
+        "swapcase",
+        "zfill",
+    ):
+        locals()[method] = make_simple_escaping_wrapper(method)
+
+    def partition(self, sep):
+        return tuple(map(self.__class__, text_type.partition(self, self.escape(sep))))
+
+    def rpartition(self, sep):
+        return tuple(map(self.__class__, text_type.rpartition(self, self.escape(sep))))
+
+    def format(self, *args, **kwargs):
+        formatter = EscapeFormatter(self.escape)
+        kwargs = _MagicFormatMapping(args, kwargs)
+        return self.__class__(formatter.vformat(self, args, kwargs))
+
+    def __html_format__(self, format_spec):
+        if format_spec:
+            raise ValueError("Unsupported format specification " "for Markup.")
+        return self
+
+    # not in python 3
+    if hasattr(text_type, "__getslice__"):
+        __getslice__ = make_simple_escaping_wrapper("__getslice__")
+
+    del method, make_simple_escaping_wrapper
+
+
+class _MagicFormatMapping(Mapping):
+    """This class implements a dummy wrapper to fix a bug in the Python
+    standard library for string formatting.
+
+    See http://bugs.python.org/issue13598 for information about why
+    this is necessary.
+    """
+
+    def __init__(self, args, kwargs):
+        self._args = args
+        self._kwargs = kwargs
+        self._last_index = 0
+
+    def __getitem__(self, key):
+        if key == "":
+            idx = self._last_index
+            self._last_index += 1
+            try:
+                return self._args[idx]
+            except LookupError:
+                pass
+            key = str(idx)
+        return self._kwargs[key]
+
+    def __iter__(self):
+        return iter(self._kwargs)
+
+    def __len__(self):
+        return len(self._kwargs)
+
+
+if hasattr(text_type, "format"):
+
+    class EscapeFormatter(string.Formatter):
+        def __init__(self, escape):
+            self.escape = escape
+
+        def format_field(self, value, format_spec):
+            if hasattr(value, "__html_format__"):
+                rv = value.__html_format__(format_spec)
+            elif hasattr(value, "__html__"):
+                if format_spec:
+                    raise ValueError(
+                        "Format specifier {0} given, but {1} does not"
+                        " define __html_format__. A class that defines"
+                        " __html__ must define __html_format__ to work"
+                        " with format specifiers.".format(format_spec, type(value))
+                    )
+                rv = value.__html__()
+            else:
+                # We need to make sure the format spec is unicode here as
+                # otherwise the wrong callback methods are invoked.  For
+                # instance a byte string there would invoke __str__ and
+                # not __unicode__.
+                rv = string.Formatter.format_field(self, value, text_type(format_spec))
+            return text_type(self.escape(rv))
+
+
+def _escape_argspec(obj, iterable, escape):
+    """Helper for various string-wrapped functions."""
+    for key, value in iterable:
+        if hasattr(value, "__html__") or isinstance(value, string_types):
+            obj[key] = escape(value)
+    return obj
+
+
+class _MarkupEscapeHelper(object):
+    """Helper for Markup.__mod__"""
+
+    def __init__(self, obj, escape):
+        self.obj = obj
+        self.escape = escape
+
+    def __getitem__(self, item):
+        return _MarkupEscapeHelper(self.obj[item], self.escape)
+
+    def __str__(self):
+        return text_type(self.escape(self.obj))
+
+    __unicode__ = __str__
+
+    def __repr__(self):
+        return str(self.escape(repr(self.obj)))
+
+    def __int__(self):
+        return int(self.obj)
+
+    def __float__(self):
+        return float(self.obj)
+
+
+# we have to import it down here as the speedups and native
+# modules imports the markup type which is define above.
+try:
+    from ._speedups import escape, escape_silent, soft_unicode
+except ImportError:
+    from ._native import escape, escape_silent, soft_unicode
+
+if not PY2:
+    soft_str = soft_unicode
+    __all__.append("soft_str")
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_compat.py b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_compat.py
new file mode 100644
index 0000000000000000000000000000000000000000..bc05090f9e88da2c16a75844bcb6d5043025581b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_compat.py
@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._compat
+~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+import sys
+
+PY2 = sys.version_info[0] == 2
+
+if not PY2:
+    text_type = str
+    string_types = (str,)
+    unichr = chr
+    int_types = (int,)
+
+    def iteritems(x):
+        return iter(x.items())
+
+    from collections.abc import Mapping
+
+else:
+    text_type = unicode
+    string_types = (str, unicode)
+    unichr = unichr
+    int_types = (int, long)
+
+    def iteritems(x):
+        return x.iteritems()
+
+    from collections import Mapping
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_constants.py b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_constants.py
new file mode 100644
index 0000000000000000000000000000000000000000..7c57c2d29452a94c22708e1b749f0b7e8c14bf1b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_constants.py
@@ -0,0 +1,264 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._constants
+~~~~~~~~~~~~~~~~~~~~~
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+
+HTML_ENTITIES = {
+    "AElig": 198,
+    "Aacute": 193,
+    "Acirc": 194,
+    "Agrave": 192,
+    "Alpha": 913,
+    "Aring": 197,
+    "Atilde": 195,
+    "Auml": 196,
+    "Beta": 914,
+    "Ccedil": 199,
+    "Chi": 935,
+    "Dagger": 8225,
+    "Delta": 916,
+    "ETH": 208,
+    "Eacute": 201,
+    "Ecirc": 202,
+    "Egrave": 200,
+    "Epsilon": 917,
+    "Eta": 919,
+    "Euml": 203,
+    "Gamma": 915,
+    "Iacute": 205,
+    "Icirc": 206,
+    "Igrave": 204,
+    "Iota": 921,
+    "Iuml": 207,
+    "Kappa": 922,
+    "Lambda": 923,
+    "Mu": 924,
+    "Ntilde": 209,
+    "Nu": 925,
+    "OElig": 338,
+    "Oacute": 211,
+    "Ocirc": 212,
+    "Ograve": 210,
+    "Omega": 937,
+    "Omicron": 927,
+    "Oslash": 216,
+    "Otilde": 213,
+    "Ouml": 214,
+    "Phi": 934,
+    "Pi": 928,
+    "Prime": 8243,
+    "Psi": 936,
+    "Rho": 929,
+    "Scaron": 352,
+    "Sigma": 931,
+    "THORN": 222,
+    "Tau": 932,
+    "Theta": 920,
+    "Uacute": 218,
+    "Ucirc": 219,
+    "Ugrave": 217,
+    "Upsilon": 933,
+    "Uuml": 220,
+    "Xi": 926,
+    "Yacute": 221,
+    "Yuml": 376,
+    "Zeta": 918,
+    "aacute": 225,
+    "acirc": 226,
+    "acute": 180,
+    "aelig": 230,
+    "agrave": 224,
+    "alefsym": 8501,
+    "alpha": 945,
+    "amp": 38,
+    "and": 8743,
+    "ang": 8736,
+    "apos": 39,
+    "aring": 229,
+    "asymp": 8776,
+    "atilde": 227,
+    "auml": 228,
+    "bdquo": 8222,
+    "beta": 946,
+    "brvbar": 166,
+    "bull": 8226,
+    "cap": 8745,
+    "ccedil": 231,
+    "cedil": 184,
+    "cent": 162,
+    "chi": 967,
+    "circ": 710,
+    "clubs": 9827,
+    "cong": 8773,
+    "copy": 169,
+    "crarr": 8629,
+    "cup": 8746,
+    "curren": 164,
+    "dArr": 8659,
+    "dagger": 8224,
+    "darr": 8595,
+    "deg": 176,
+    "delta": 948,
+    "diams": 9830,
+    "divide": 247,
+    "eacute": 233,
+    "ecirc": 234,
+    "egrave": 232,
+    "empty": 8709,
+    "emsp": 8195,
+    "ensp": 8194,
+    "epsilon": 949,
+    "equiv": 8801,
+    "eta": 951,
+    "eth": 240,
+    "euml": 235,
+    "euro": 8364,
+    "exist": 8707,
+    "fnof": 402,
+    "forall": 8704,
+    "frac12": 189,
+    "frac14": 188,
+    "frac34": 190,
+    "frasl": 8260,
+    "gamma": 947,
+    "ge": 8805,
+    "gt": 62,
+    "hArr": 8660,
+    "harr": 8596,
+    "hearts": 9829,
+    "hellip": 8230,
+    "iacute": 237,
+    "icirc": 238,
+    "iexcl": 161,
+    "igrave": 236,
+    "image": 8465,
+    "infin": 8734,
+    "int": 8747,
+    "iota": 953,
+    "iquest": 191,
+    "isin": 8712,
+    "iuml": 239,
+    "kappa": 954,
+    "lArr": 8656,
+    "lambda": 955,
+    "lang": 9001,
+    "laquo": 171,
+    "larr": 8592,
+    "lceil": 8968,
+    "ldquo": 8220,
+    "le": 8804,
+    "lfloor": 8970,
+    "lowast": 8727,
+    "loz": 9674,
+    "lrm": 8206,
+    "lsaquo": 8249,
+    "lsquo": 8216,
+    "lt": 60,
+    "macr": 175,
+    "mdash": 8212,
+    "micro": 181,
+    "middot": 183,
+    "minus": 8722,
+    "mu": 956,
+    "nabla": 8711,
+    "nbsp": 160,
+    "ndash": 8211,
+    "ne": 8800,
+    "ni": 8715,
+    "not": 172,
+    "notin": 8713,
+    "nsub": 8836,
+    "ntilde": 241,
+    "nu": 957,
+    "oacute": 243,
+    "ocirc": 244,
+    "oelig": 339,
+    "ograve": 242,
+    "oline": 8254,
+    "omega": 969,
+    "omicron": 959,
+    "oplus": 8853,
+    "or": 8744,
+    "ordf": 170,
+    "ordm": 186,
+    "oslash": 248,
+    "otilde": 245,
+    "otimes": 8855,
+    "ouml": 246,
+    "para": 182,
+    "part": 8706,
+    "permil": 8240,
+    "perp": 8869,
+    "phi": 966,
+    "pi": 960,
+    "piv": 982,
+    "plusmn": 177,
+    "pound": 163,
+    "prime": 8242,
+    "prod": 8719,
+    "prop": 8733,
+    "psi": 968,
+    "quot": 34,
+    "rArr": 8658,
+    "radic": 8730,
+    "rang": 9002,
+    "raquo": 187,
+    "rarr": 8594,
+    "rceil": 8969,
+    "rdquo": 8221,
+    "real": 8476,
+    "reg": 174,
+    "rfloor": 8971,
+    "rho": 961,
+    "rlm": 8207,
+    "rsaquo": 8250,
+    "rsquo": 8217,
+    "sbquo": 8218,
+    "scaron": 353,
+    "sdot": 8901,
+    "sect": 167,
+    "shy": 173,
+    "sigma": 963,
+    "sigmaf": 962,
+    "sim": 8764,
+    "spades": 9824,
+    "sub": 8834,
+    "sube": 8838,
+    "sum": 8721,
+    "sup": 8835,
+    "sup1": 185,
+    "sup2": 178,
+    "sup3": 179,
+    "supe": 8839,
+    "szlig": 223,
+    "tau": 964,
+    "there4": 8756,
+    "theta": 952,
+    "thetasym": 977,
+    "thinsp": 8201,
+    "thorn": 254,
+    "tilde": 732,
+    "times": 215,
+    "trade": 8482,
+    "uArr": 8657,
+    "uacute": 250,
+    "uarr": 8593,
+    "ucirc": 251,
+    "ugrave": 249,
+    "uml": 168,
+    "upsih": 978,
+    "upsilon": 965,
+    "uuml": 252,
+    "weierp": 8472,
+    "xi": 958,
+    "yacute": 253,
+    "yen": 165,
+    "yuml": 255,
+    "zeta": 950,
+    "zwj": 8205,
+    "zwnj": 8204,
+}
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_native.py b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_native.py
new file mode 100644
index 0000000000000000000000000000000000000000..cd08752cd8940f01f85e51a6477cf72b3e5e517e
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_native.py
@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*-
+"""
+markupsafe._native
+~~~~~~~~~~~~~~~~~~
+
+Native Python implementation used when the C module is not compiled.
+
+:copyright: 2010 Pallets
+:license: BSD-3-Clause
+"""
+from . import Markup
+from ._compat import text_type
+
+
+def escape(s):
+    """Replace the characters ``&``, ``<``, ``>``, ``'``, and ``"`` in
+    the string with HTML-safe sequences. Use this if you need to display
+    text that might contain such characters in HTML.
+
+    If the object has an ``__html__`` method, it is called and the
+    return value is assumed to already be safe for HTML.
+
+    :param s: An object to be converted to a string and escaped.
+    :return: A :class:`Markup` string with the escaped text.
+    """
+    if hasattr(s, "__html__"):
+        return Markup(s.__html__())
+    return Markup(
+        text_type(s)
+        .replace("&", "&amp;")
+        .replace(">", "&gt;")
+        .replace("<", "&lt;")
+        .replace("'", "&#39;")
+        .replace('"', "&#34;")
+    )
+
+
+def escape_silent(s):
+    """Like :func:`escape` but treats ``None`` as the empty string.
+    Useful with optional values, as otherwise you get the string
+    ``'None'`` when the value is ``None``.
+
+    >>> escape(None)
+    Markup('None')
+    >>> escape_silent(None)
+    Markup('')
+    """
+    if s is None:
+        return Markup()
+    return escape(s)
+
+
+def soft_unicode(s):
+    """Convert an object to a string if it isn't already. This preserves
+    a :class:`Markup` string rather than converting it back to a basic
+    string, so it will still be marked as safe and won't be escaped
+    again.
+
+    >>> value = escape('<User 1>')
+    >>> value
+    Markup('&lt;User 1&gt;')
+    >>> escape(str(value))
+    Markup('&amp;lt;User 1&amp;gt;')
+    >>> escape(soft_unicode(value))
+    Markup('&lt;User 1&gt;')
+    """
+    if not isinstance(s, text_type):
+        s = text_type(s)
+    return s
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.c b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.c
new file mode 100644
index 0000000000000000000000000000000000000000..12d2c4a7d8352f6bf1deb19790453eb529827a78
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.c
@@ -0,0 +1,423 @@
+/**
+ * markupsafe._speedups
+ * ~~~~~~~~~~~~~~~~~~~~
+ *
+ * C implementation of escaping for better performance. Used instead of
+ * the native Python implementation when compiled.
+ *
+ * :copyright: 2010 Pallets
+ * :license: BSD-3-Clause
+ */
+#include <Python.h>
+
+#if PY_MAJOR_VERSION < 3
+#define ESCAPED_CHARS_TABLE_SIZE 63
+#define UNICHR(x) (PyUnicode_AS_UNICODE((PyUnicodeObject*)PyUnicode_DecodeASCII(x, strlen(x), NULL)));
+
+static Py_ssize_t escaped_chars_delta_len[ESCAPED_CHARS_TABLE_SIZE];
+static Py_UNICODE *escaped_chars_repl[ESCAPED_CHARS_TABLE_SIZE];
+#endif
+
+static PyObject* markup;
+
+static int
+init_constants(void)
+{
+	PyObject *module;
+
+#if PY_MAJOR_VERSION < 3
+	/* mapping of characters to replace */
+	escaped_chars_repl['"'] = UNICHR("&#34;");
+	escaped_chars_repl['\''] = UNICHR("&#39;");
+	escaped_chars_repl['&'] = UNICHR("&amp;");
+	escaped_chars_repl['<'] = UNICHR("&lt;");
+	escaped_chars_repl['>'] = UNICHR("&gt;");
+
+	/* lengths of those characters when replaced - 1 */
+	memset(escaped_chars_delta_len, 0, sizeof (escaped_chars_delta_len));
+	escaped_chars_delta_len['"'] = escaped_chars_delta_len['\''] = \
+		escaped_chars_delta_len['&'] = 4;
+	escaped_chars_delta_len['<'] = escaped_chars_delta_len['>'] = 3;
+#endif
+
+	/* import markup type so that we can mark the return value */
+	module = PyImport_ImportModule("markupsafe");
+	if (!module)
+		return 0;
+	markup = PyObject_GetAttrString(module, "Markup");
+	Py_DECREF(module);
+
+	return 1;
+}
+
+#if PY_MAJOR_VERSION < 3
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	PyUnicodeObject *out;
+	Py_UNICODE *inp = PyUnicode_AS_UNICODE(in);
+	const Py_UNICODE *inp_end = PyUnicode_AS_UNICODE(in) + PyUnicode_GET_SIZE(in);
+	Py_UNICODE *next_escp;
+	Py_UNICODE *outp;
+	Py_ssize_t delta=0, erepl=0, delta_len=0;
+
+	/* First we need to figure out how long the escaped string will be */
+	while (*(inp) || inp < inp_end) {
+		if (*inp < ESCAPED_CHARS_TABLE_SIZE) {
+			delta += escaped_chars_delta_len[*inp];
+			erepl += !!escaped_chars_delta_len[*inp];
+		}
+		++inp;
+	}
+
+	/* Do we need to escape anything at all? */
+	if (!erepl) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = (PyUnicodeObject*)PyUnicode_FromUnicode(NULL, PyUnicode_GET_SIZE(in) + delta);
+	if (!out)
+		return NULL;
+
+	outp = PyUnicode_AS_UNICODE(out);
+	inp = PyUnicode_AS_UNICODE(in);
+	while (erepl-- > 0) {
+		/* look for the next substitution */
+		next_escp = inp;
+		while (next_escp < inp_end) {
+			if (*next_escp < ESCAPED_CHARS_TABLE_SIZE &&
+			    (delta_len = escaped_chars_delta_len[*next_escp])) {
+				++delta_len;
+				break;
+			}
+			++next_escp;
+		}
+
+		if (next_escp > inp) {
+			/* copy unescaped chars between inp and next_escp */
+			Py_UNICODE_COPY(outp, inp, next_escp-inp);
+			outp += next_escp - inp;
+		}
+
+		/* escape 'next_escp' */
+		Py_UNICODE_COPY(outp, escaped_chars_repl[*next_escp], delta_len);
+		outp += delta_len;
+
+		inp = next_escp + 1;
+	}
+	if (inp < inp_end)
+		Py_UNICODE_COPY(outp, inp, PyUnicode_GET_SIZE(in) - (inp - PyUnicode_AS_UNICODE(in)));
+
+	return (PyObject*)out;
+}
+#else /* PY_MAJOR_VERSION < 3 */
+
+#define GET_DELTA(inp, inp_end, delta) \
+	while (inp < inp_end) {	 \
+		switch (*inp++) {	   \
+		case '"':			   \
+		case '\'':			  \
+		case '&':			   \
+			delta += 4;		 \
+			break;			  \
+		case '<':			   \
+		case '>':			   \
+			delta += 3;		 \
+			break;			  \
+		}					   \
+	}
+
+#define DO_ESCAPE(inp, inp_end, outp) \
+	{  \
+		Py_ssize_t ncopy = 0;  \
+		while (inp < inp_end) {  \
+			switch (*inp) {  \
+			case '"':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '4';  \
+				*outp++ = ';';  \
+				break;  \
+			case '\'':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = '#';  \
+				*outp++ = '3';  \
+				*outp++ = '9';  \
+				*outp++ = ';';  \
+				break;  \
+			case '&':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'a';  \
+				*outp++ = 'm';  \
+				*outp++ = 'p';  \
+				*outp++ = ';';  \
+				break;  \
+			case '<':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'l';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			case '>':  \
+				memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+				outp += ncopy; ncopy = 0; \
+				*outp++ = '&';  \
+				*outp++ = 'g';  \
+				*outp++ = 't';  \
+				*outp++ = ';';  \
+				break;  \
+			default:  \
+				ncopy++; \
+			}  \
+            inp++; \
+		}  \
+		memcpy(outp, inp-ncopy, sizeof(*outp)*ncopy); \
+	}
+
+static PyObject*
+escape_unicode_kind1(PyUnicodeObject *in)
+{
+	Py_UCS1 *inp = PyUnicode_1BYTE_DATA(in);
+	Py_UCS1 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS1 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta,
+						PyUnicode_IS_ASCII(in) ? 127 : 255);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_1BYTE_DATA(in);
+	outp = PyUnicode_1BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode_kind2(PyUnicodeObject *in)
+{
+	Py_UCS2 *inp = PyUnicode_2BYTE_DATA(in);
+	Py_UCS2 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS2 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 65535);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_2BYTE_DATA(in);
+	outp = PyUnicode_2BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+
+static PyObject*
+escape_unicode_kind4(PyUnicodeObject *in)
+{
+	Py_UCS4 *inp = PyUnicode_4BYTE_DATA(in);
+	Py_UCS4 *inp_end = inp + PyUnicode_GET_LENGTH(in);
+	Py_UCS4 *outp;
+	PyObject *out;
+	Py_ssize_t delta = 0;
+
+	GET_DELTA(inp, inp_end, delta);
+	if (!delta) {
+		Py_INCREF(in);
+		return (PyObject*)in;
+	}
+
+	out = PyUnicode_New(PyUnicode_GET_LENGTH(in) + delta, 1114111);
+	if (!out)
+		return NULL;
+
+	inp = PyUnicode_4BYTE_DATA(in);
+	outp = PyUnicode_4BYTE_DATA(out);
+	DO_ESCAPE(inp, inp_end, outp);
+	return out;
+}
+
+static PyObject*
+escape_unicode(PyUnicodeObject *in)
+{
+	if (PyUnicode_READY(in))
+		return NULL;
+
+	switch (PyUnicode_KIND(in)) {
+	case PyUnicode_1BYTE_KIND:
+		return escape_unicode_kind1(in);
+	case PyUnicode_2BYTE_KIND:
+		return escape_unicode_kind2(in);
+	case PyUnicode_4BYTE_KIND:
+		return escape_unicode_kind4(in);
+	}
+	assert(0);  /* shouldn't happen */
+	return NULL;
+}
+#endif /* PY_MAJOR_VERSION < 3 */
+
+static PyObject*
+escape(PyObject *self, PyObject *text)
+{
+	static PyObject *id_html;
+	PyObject *s = NULL, *rv = NULL, *html;
+
+	if (id_html == NULL) {
+#if PY_MAJOR_VERSION < 3
+		id_html = PyString_InternFromString("__html__");
+#else
+		id_html = PyUnicode_InternFromString("__html__");
+#endif
+		if (id_html == NULL) {
+			return NULL;
+		}
+	}
+
+	/* we don't have to escape integers, bools or floats */
+	if (PyLong_CheckExact(text) ||
+#if PY_MAJOR_VERSION < 3
+	    PyInt_CheckExact(text) ||
+#endif
+	    PyFloat_CheckExact(text) || PyBool_Check(text) ||
+	    text == Py_None)
+		return PyObject_CallFunctionObjArgs(markup, text, NULL);
+
+	/* if the object has an __html__ method that performs the escaping */
+	html = PyObject_GetAttr(text ,id_html);
+	if (html) {
+		s = PyObject_CallObject(html, NULL);
+		Py_DECREF(html);
+		if (s == NULL) {
+			return NULL;
+		}
+		/* Convert to Markup object */
+		rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+		Py_DECREF(s);
+		return rv;
+	}
+
+	/* otherwise make the object unicode if it isn't, then escape */
+	PyErr_Clear();
+	if (!PyUnicode_Check(text)) {
+#if PY_MAJOR_VERSION < 3
+		PyObject *unicode = PyObject_Unicode(text);
+#else
+		PyObject *unicode = PyObject_Str(text);
+#endif
+		if (!unicode)
+			return NULL;
+		s = escape_unicode((PyUnicodeObject*)unicode);
+		Py_DECREF(unicode);
+	}
+	else
+		s = escape_unicode((PyUnicodeObject*)text);
+
+	/* convert the unicode string into a markup object. */
+	rv = PyObject_CallFunctionObjArgs(markup, (PyObject*)s, NULL);
+	Py_DECREF(s);
+	return rv;
+}
+
+
+static PyObject*
+escape_silent(PyObject *self, PyObject *text)
+{
+	if (text != Py_None)
+		return escape(self, text);
+	return PyObject_CallFunctionObjArgs(markup, NULL);
+}
+
+
+static PyObject*
+soft_unicode(PyObject *self, PyObject *s)
+{
+	if (!PyUnicode_Check(s))
+#if PY_MAJOR_VERSION < 3
+		return PyObject_Unicode(s);
+#else
+		return PyObject_Str(s);
+#endif
+	Py_INCREF(s);
+	return s;
+}
+
+
+static PyMethodDef module_methods[] = {
+	{"escape", (PyCFunction)escape, METH_O,
+	 "escape(s) -> markup\n\n"
+	 "Convert the characters &, <, >, ', and \" in string s to HTML-safe\n"
+	 "sequences.  Use this if you need to display text that might contain\n"
+	 "such characters in HTML.  Marks return value as markup string."},
+	{"escape_silent", (PyCFunction)escape_silent, METH_O,
+	 "escape_silent(s) -> markup\n\n"
+	 "Like escape but converts None to an empty string."},
+	{"soft_unicode", (PyCFunction)soft_unicode, METH_O,
+	 "soft_unicode(object) -> string\n\n"
+         "Make a string unicode if it isn't already.  That way a markup\n"
+         "string is not converted back to unicode."},
+	{NULL, NULL, 0, NULL}		/* Sentinel */
+};
+
+
+#if PY_MAJOR_VERSION < 3
+
+#ifndef PyMODINIT_FUNC	/* declarations for DLL import/export */
+#define PyMODINIT_FUNC void
+#endif
+PyMODINIT_FUNC
+init_speedups(void)
+{
+	if (!init_constants())
+		return;
+
+	Py_InitModule3("markupsafe._speedups", module_methods, "");
+}
+
+#else /* Python 3.x module initialization */
+
+static struct PyModuleDef module_definition = {
+        PyModuleDef_HEAD_INIT,
+	"markupsafe._speedups",
+	NULL,
+	-1,
+	module_methods,
+	NULL,
+	NULL,
+	NULL,
+	NULL
+};
+
+PyMODINIT_FUNC
+PyInit__speedups(void)
+{
+	if (!init_constants())
+		return NULL;
+
+	return PyModule_Create(&module_definition);
+}
+
+#endif
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so
new file mode 100755
index 0000000000000000000000000000000000000000..005f5a3e3cf25313405c250aca7b44aaef87886e
Binary files /dev/null and b/SOL004/magma/squid_cnf/charms/squid/venv/markupsafe/_speedups.cpython-38-x86_64-linux-gnu.so differ
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/INSTALLER b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/METADATA b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..b21b997f84c57165c6e89728ebe53da0b518e944
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/METADATA
@@ -0,0 +1,63 @@
+Metadata-Version: 2.1
+Name: oci-image
+Version: 1.0.0
+Summary: Helper for dealing with OCI Image resources in the charm operator framework
+Home-page: https://github.com/juju-solutions/resource-oci-image
+Author: Cory Johns
+Author-email: johnsca@gmail.com
+License: Apache License 2.0
+Platform: UNKNOWN
+
+# OCI Image Resource helper
+
+This is a helper for working with OCI image resources in the charm operator
+framework.
+
+## Installation
+
+Add it to your `requirements.txt`.  Since it's not in PyPI, you'll need to use
+the GitHub archive URL (or `git+` URL, if you want to pin to a specific commit):
+
+```
+https://github.com/juju-solutions/resource-oci-image/archive/master.zip
+```
+
+## Usage
+
+The `OCIImageResource` class will wrap the framework resource for the given
+resource name, and calling `fetch` on it will either return the image info
+or raise an `OCIImageResourceError` if it can't fetch or parse the image
+info. The exception will have a `status` attribute you can use directly,
+or a `status_message` attribute if you just want that.
+
+Example usage:
+
+```python
+from ops.charm import CharmBase
+from ops.main import main
+from oci_image import OCIImageResource, OCIImageResourceError
+
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.image = OCIImageResource(self, 'resource-name')
+        self.framework.observe(self.on.start, self.on_start)
+
+    def on_start(self, event):
+        try:
+            image_info = self.image.fetch()
+        except OCIImageResourceError as e:
+            self.model.unit.status = e.status
+            event.defer()
+            return
+
+        self.model.pod.set_spec({'containers': [{
+            'name': 'my-charm',
+            'imageDetails': image_info,
+        }]})
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/RECORD b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..c265196b2ce5ac15b3705d0bca4e6da2474d7556
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/RECORD
@@ -0,0 +1,7 @@
+__pycache__/oci_image.cpython-38.pyc,,
+oci_image-1.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+oci_image-1.0.0.dist-info/METADATA,sha256=QIpPa4JcSPa_Ci0n-DaCNp4PkKovZudFW8FnpnauJnQ,1808
+oci_image-1.0.0.dist-info/RECORD,,
+oci_image-1.0.0.dist-info/WHEEL,sha256=EVRjI69F5qVjm_YgqcTXPnTAv3BfSUr0WVAHuSP3Xoo,92
+oci_image-1.0.0.dist-info/top_level.txt,sha256=M4dLaObLx7irI4EO-A4_VJP_b-A6dDD7hB5QyVKdHOY,10
+oci_image.py,sha256=c75VR2vSmOp9pPTP2cnsxo23CqhhFbRtnIOtMjzDyXY,1794
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/WHEEL b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..83ff02e961fce5ad7befce746ff02635e1616315
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.35.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/top_level.txt b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..cd6962384eaf5e60f5976c60d221b84ba5561a1d
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image-1.0.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+oci_image
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/oci_image.py b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image.py
new file mode 100644
index 0000000000000000000000000000000000000000..f4d3818f47c3bde81c97dd43a702e2aa4d0dde7f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/oci_image.py
@@ -0,0 +1,53 @@
+from pathlib import Path
+
+import yaml
+from ops.framework import Object
+from ops.model import BlockedStatus, ModelError
+
+
+class OCIImageResource(Object):
+    def __init__(self, charm, resource_name):
+        super().__init__(charm, resource_name)
+        self.resource_name = resource_name
+
+    def fetch(self):
+        try:
+            resource_path = self.model.resources.fetch(self.resource_name)
+        except ModelError as e:
+            raise MissingResourceError(self.resource_name) from e
+        if not resource_path.exists():
+            raise MissingResourceError(self.resource_name)
+        resource_text = Path(resource_path).read_text()
+        if not resource_text:
+            raise MissingResourceError(self.resource_name)
+        try:
+            resource_data = yaml.safe_load(resource_text)
+        except yaml.YAMLError as e:
+            raise InvalidResourceError(self.resource_name) from e
+        else:
+            # Translate the data from the format used by the charm store to the
+            # format used by the Juju K8s pod spec, since that is how this is
+            # typically used.
+            return {
+                'imagePath': resource_data['registrypath'],
+                'username': resource_data['username'],
+                'password': resource_data['password'],
+            }
+
+
+class OCIImageResourceError(ModelError):
+    status_type = BlockedStatus
+    status_message = 'Resource error'
+
+    def __init__(self, resource_name):
+        super().__init__(resource_name)
+        self.status = self.status_type(
+            f'{self.status_message}: {resource_name}')
+
+
+class MissingResourceError(OCIImageResourceError):
+    status_message = 'Missing resource'
+
+
+class InvalidResourceError(OCIImageResourceError):
+    status_message = 'Invalid resource'
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/INSTALLER b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/INSTALLER
new file mode 100644
index 0000000000000000000000000000000000000000..a1b589e38a32041e49332e5e81c2d363dc418d68
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/INSTALLER
@@ -0,0 +1 @@
+pip
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/LICENSE.txt b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/LICENSE.txt
new file mode 100644
index 0000000000000000000000000000000000000000..d645695673349e3947e8e5ae42332d0ac3164cd7
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/LICENSE.txt
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/METADATA b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/METADATA
new file mode 100644
index 0000000000000000000000000000000000000000..cd45af9374c8209252a546c5a4c5a4221c8fb8af
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/METADATA
@@ -0,0 +1,263 @@
+Metadata-Version: 2.1
+Name: ops
+Version: 1.1.0
+Summary: The Python library behind great charms
+Home-page: https://github.com/canonical/operator
+Author: The Charmcraft team at Canonical Ltd.
+Author-email: charmcraft@lists.launchpad.net
+License: Apache-2.0
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Requires-Python: >=3.5
+Description-Content-Type: text/markdown
+Requires-Dist: PyYAML
+
+# The Operator Framework
+
+This Operator Framework simplifies [Kubernetes
+operator](https://charmhub.io/about) development for 
+[model-driven application
+management](https://juju.is/model-driven-operations).
+
+A Kubernetes operator is a container that drives lifecycle management,
+configuration, integration and daily actions for an application.
+Operators simplify software management and operations. They capture
+reusable app domain knowledge from experts in a software component that
+can be shared.
+
+This project extends the operator pattern to enable 
+[universal operators](https://juju.is/universal-operators), not just
+for Kubernetes but also operators for traditional Linux or Windows
+application management.
+
+Operators use an [Operator Lifecycle Manager
+(OLM)](https://juju.is/operator-lifecycle-manager) to coordinate their
+work in a cluster. The system uses Golang for concurrent event
+processing under the hood, but enables the operators to be written in
+Python.
+
+## Simple, composable operators
+
+Operators should 'do one thing and do it well'. Each operator drives a
+single microservice and can be [composed with other 
+operators](https://juju.is/integration) to deliver a complex application.
+
+It is better to have small, reusable operators that each drive a single
+microservice very well. The operator handles instantiation, scaling,
+configuration, optimisation, networking, service mesh, observability,
+and day-2 operations specific to that microservice.
+
+Operator composition takes place through declarative integration in
+the OLM. Operators declare integration endpoints, and discover lines of
+integration between those endpoints dynamically at runtime.
+
+## Pure Python operators
+
+The framework provides a standard Python library and object model that
+represents the application graph, and an event distribution mechanism for
+distributed system coordination and communication.
+
+The OLM is written in Golang for efficient concurrency in event handling
+and distribution. Operators can be written in any language. We recommend
+this Python framework for ease of design, development and collaboration.
+
+## Better collaboration
+
+Operator developers publish Python libraries that make it easy to integrate
+your operator with their operator. The framework includes standard tools
+to distribute these integration libraries and keep them up to date.
+
+Development collaboration happens at [Charmhub.io](https://charmhub.io/) where
+operators are published along with integration libraries. Design and
+code review discussions are hosted in the
+[Charmhub forum](https://discourse.charmhub.io/). We recommend the
+[Open Operator Manifesto](https://charmhub.io/manifesto) as a guideline for
+high quality operator engineering.
+
+## Event serialization and operator services
+
+Distributed systems can be hard! So this framework exists to make it much
+simpler to reason about operator behaviour, especially in complex deployments.
+The OLM provides [operator services](https://juju.is/operator-services) such
+as provisioning, event delivery, leader election and model management.
+
+Coordination between operators is provided by a cluster-wide event
+distribution system. Events are serialized to avoid race conditions in any
+given container or machine. This greatly simplifies the development of
+operators for high availability, scale-out and integrated applications.
+
+## Model-driven Operator Lifecycle Manager
+
+A key goal of the project is to improve the user experience for admins
+working with multiple different operators.
+
+We embrace [model-driven operations](https://juju.is/model-driven-operations)
+in the Operator Lifecycle Manager. The model encompasses capacity,
+storage, networking, the application graph and administrative access.
+
+Admins describe the application graph of integrated microservices, and
+the OLM then drives instantiation. A change in the model is propagated
+to all affected operators, reducing the duplication of effort and
+repetition normally found in operating a complex topology of services.
+
+Administrative actions, updates, configuration and integration are all
+driven through the OLM.
+
+# Getting started
+
+A package of operator code is called a charm. You will use `charmcraft`
+to register your operator name, and publish it when you are ready.
+
+```
+$ sudo snap install charmcraft --beta
+charmcraft (beta) 0.6.0 from John Lenton (chipaca) installed
+```
+
+Charms written using the operator framework are just Python code. The goal
+is to feel natural for somebody used to coding in Python, and reasonably
+easy to learn for somebody who is not a pythonista.
+
+The dependencies of the operator framework are kept as minimal as possible;
+currently that's Python 3.5 or greater, and `PyYAML` (both are included by
+default in Ubuntu's cloud images from 16.04 on).
+
+# A quick introduction
+
+Make an empty directory `my-charm` and cd into it. Then start a new charm
+with:
+
+```
+$ charmcraft init
+All done.
+There are some notes about things we think you should do.
+These are marked with ‘TODO:’, as is customary. Namely:
+      README.md: fill out the description
+      README.md: explain how to use the charm
+  metadata.yaml: fill out the charm's description
+  metadata.yaml: fill out the charm's summary
+```
+
+Charmed operators are just Python code. The entry point to your charm can
+be any filename, by default this is `src/charm.py` which must be executable
+(and probably have `#!/usr/bin/env python3` on the first line).
+
+You need a `metadata.yaml` to describe your charm, and if you will support
+configuration of your charm then `config.yaml` files is required too. The
+`requirements.txt` specifies any Python dependencies.
+
+```
+$ tree my-charm/
+my-charm/
+├── actions.yaml
+├── config.yaml
+├── LICENSE
+├── metadata.yaml
+├── README.md
+├── requirements-dev.txt
+├── requirements.txt
+├── run_tests
+├── src
+│   └── charm.py
+├── tests
+│   ├── __init__.py
+│   └── my_charm.py
+```
+
+`src/charm.py` here is the entry point to your charm code. At a minimum, it
+needs to define a subclass of `CharmBase` and pass that into the framework
+`main` function:
+
+```python
+from ops.charm import CharmBase
+from ops.main import main
+
+class MyCharm(CharmBase):
+    def __init__(self, *args):
+        super().__init__(*args)
+        self.framework.observe(self.on.start, self.on_start)
+
+    def on_start(self, event):
+        # Handle the start event here.
+
+if __name__ == "__main__":
+    main(MyCharm)
+```
+
+That should be enough for you to be able to run
+
+```
+$ charmcraft build
+Done, charm left in 'my-charm.charm'
+$ juju deploy ./my-charm.charm
+```
+
+> 🛈 More information on [`charmcraft`](https://pypi.org/project/charmcraft/) can
+> also be found on its [github page](https://github.com/canonical/charmcraft).
+
+Happy charming!
+
+# Testing your charms
+
+The operator framework provides a testing harness, so you can check your
+charm does the right thing in different scenarios, without having to create
+a full deployment. `pydoc3 ops.testing` has the details, including this
+example:
+
+```python
+harness = Harness(MyCharm)
+# Do initial setup here
+relation_id = harness.add_relation('db', 'postgresql')
+# Now instantiate the charm to see events as the model changes
+harness.begin()
+harness.add_relation_unit(relation_id, 'postgresql/0')
+harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+# Check that charm has properly handled the relation_joined event for postgresql/0
+self.assertEqual(harness.charm. ...)
+```
+
+## Talk to us
+
+If you need help, have ideas, or would just like to chat with us, reach out on
+IRC: we're in [#smooth-operator] on freenode (or try the [webchat]).
+
+We also pay attention to [Charmhub discourse](https://discourse.charmhub.io/)
+
+You can also deep dive into the [API docs] if that's your thing.
+
+[webchat]: https://webchat.freenode.net/#smooth-operator
+[#smooth-operator]: irc://chat.freenode.net/%23smooth-operator
+[discourse]: https://discourse.juju.is/c/charming
+[API docs]: https://ops.rtfd.io/
+
+## Operator Framework development
+
+To work in the framework itself you will need Python >= 3.5 and the
+dependencies in `requirements-dev.txt` installed in your system, or a
+virtualenv:
+
+    virtualenv --python=python3 env
+    source env/bin/activate
+    pip install -r requirements-dev.txt
+
+Then you can try `./run_tests`, it should all go green.
+
+For improved performance on the tests, ensure that you have PyYAML
+installed with the correct extensions:
+
+    apt-get install libyaml-dev
+    pip install --force-reinstall --no-cache-dir pyyaml
+
+If you want to build the documentation you'll need the requirements from
+`docs/requirements.txt`, or in your virtualenv
+
+    pip install -r docs/requirements.txt
+
+and then you can run `./build_docs`.
+
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/RECORD b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/RECORD
new file mode 100644
index 0000000000000000000000000000000000000000..35eb15f5359c1b967188c151b20fdcbc2d251c27
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/RECORD
@@ -0,0 +1,28 @@
+ops-1.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
+ops-1.1.0.dist-info/LICENSE.txt,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+ops-1.1.0.dist-info/METADATA,sha256=ffVuqPnEob6-iBYjEf3lPShSbToJL17obFFufoW2F4g,9485
+ops-1.1.0.dist-info/RECORD,,
+ops-1.1.0.dist-info/WHEEL,sha256=g4nMs7d-Xl9-xC9XovUrsDHGXt-FT0E17Yqo92DEfvY,92
+ops-1.1.0.dist-info/top_level.txt,sha256=enC05wWafSg8iDKIvj3gvtAtEP2kYCyN5Gmd689q-_I,4
+ops/__init__.py,sha256=WaHb0dfp1KEe6jFV8Pm_mcdJ3ModiWujnQ6xLjNzPNQ,819
+ops/__pycache__/__init__.cpython-38.pyc,,
+ops/__pycache__/charm.cpython-38.pyc,,
+ops/__pycache__/framework.cpython-38.pyc,,
+ops/__pycache__/jujuversion.cpython-38.pyc,,
+ops/__pycache__/log.cpython-38.pyc,,
+ops/__pycache__/main.cpython-38.pyc,,
+ops/__pycache__/model.cpython-38.pyc,,
+ops/__pycache__/storage.cpython-38.pyc,,
+ops/__pycache__/testing.cpython-38.pyc,,
+ops/__pycache__/version.cpython-38.pyc,,
+ops/charm.py,sha256=7KyaNNA0t_a0h0hrzehSEWm4xU_Y5JIqGWHTg747qfU,32817
+ops/framework.py,sha256=1ByOtFKRR6kRzOEbfWnGEMNevixOYf18U0oZxKq8LsA,43769
+ops/jujuversion.py,sha256=9wMlUmngcAENV9RkgVVLWtZsyRQaf6XNrQQqUeY_fHA,4139
+ops/lib/__init__.py,sha256=QizPpuRWXjqbH5Gv7mnH8CcPR9BX7q2YNFnxyoSsA0g,9213
+ops/lib/__pycache__/__init__.cpython-38.pyc,,
+ops/log.py,sha256=JVpt_Vkf_lWO2cucUcJfXjAWVTattk4xBscSs65Sn3I,2155
+ops/main.py,sha256=BUJZM4soFpsY4bO6zJ1bSHQeWJcm028gq0MhJT3rC8M,15523
+ops/model.py,sha256=yvM1yhidNyGpVdxkG365jPJRhQuE42EiiojBHJ7tL3c,47930
+ops/storage.py,sha256=jEfszzQGYDrl5wa03I6txvea-7lI661Yq6n7sIPa0fU,14192
+ops/testing.py,sha256=sH8PoNzGmfPdVWM1lBjStxHcNfQHsasFjF-WzHfDhFA,34898
+ops/version.py,sha256=UuaLFU_UN-InNFu4I23Y22huxQdbsOgTQ_d_r623fx4,46
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/WHEEL b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/WHEEL
new file mode 100644
index 0000000000000000000000000000000000000000..b552003ff90e66227ec90d1b159324f140d46001
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/WHEEL
@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.34.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/top_level.txt b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/top_level.txt
new file mode 100644
index 0000000000000000000000000000000000000000..2d81d3bb6fea804d1db7a1549d67244b513aa145
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops-1.1.0.dist-info/top_level.txt
@@ -0,0 +1 @@
+ops
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/__init__.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..f17b2969db298b21bc47bbe1d3614ccff93e9c6e
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/__init__.py
@@ -0,0 +1,20 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework."""
+
+from .version import version as __version__  # noqa: F401 (imported but unused)
+
+# Import here the bare minimum to break the circular import between modules
+from . import charm  # noqa: F401 (imported but unused)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/charm.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..82ed2fdd8b85d423eb8645bddb4b64426ad180e1
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/charm.py
@@ -0,0 +1,823 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Base objects for the Charm, events and metadata."""
+
+import enum
+import os
+import pathlib
+import typing
+
+import yaml
+
+from ops.framework import Object, EventSource, EventBase, Framework, ObjectEvents
+from ops import model
+
+
+def _loadYaml(source):
+    if yaml.__with_libyaml__:
+        return yaml.load(source, Loader=yaml.CSafeLoader)
+    return yaml.load(source, Loader=yaml.SafeLoader)
+
+
+class HookEvent(EventBase):
+    """Events raised by Juju to progress a charm's lifecycle.
+
+    Hooks are callback methods of a charm class (a subclass of
+    :class:`CharmBase`) that are invoked in response to events raised
+    by Juju. These callback methods are the means by which a charm
+    governs the lifecycle of its application.
+
+    The :class:`HookEvent` class is the base of a type hierarchy of events
+    related to the charm's lifecycle.
+
+    :class:`HookEvent` subtypes are grouped into the following categories
+
+    - Core lifecycle events
+    - Relation events
+    - Storage events
+    - Metric events
+    """
+
+
+class ActionEvent(EventBase):
+    """Events raised by Juju when an administrator invokes a Juju Action.
+
+    This class is the data type of events triggered when an administrator
+    invokes a Juju Action. Callbacks bound to these events may be used
+    for responding to the administrator's Juju Action request.
+
+    To read the parameters for the action, see the instance variable :attr:`params`.
+    To respond with the result of the action, call :meth:`set_results`. To add
+    progress messages that are visible as the action is progressing use
+    :meth:`log`.
+
+    Attributes:
+        params: The parameters passed to the action.
+    """
+
+    def defer(self):
+        """Action events are not deferable like other events.
+
+        This is because an action runs synchronously and the administrator
+        is waiting for the result.
+        """
+        raise RuntimeError('cannot defer action events')
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the operator framework to record the action.
+
+        Not meant to be called directly by charm code.
+        """
+        env_action_name = os.environ.get('JUJU_ACTION_NAME')
+        event_action_name = self.handle.kind[:-len('_action')].replace('_', '-')
+        if event_action_name != env_action_name:
+            # This could only happen if the dev manually emits the action, or from a bug.
+            raise RuntimeError('action event kind does not match current action')
+        # Params are loaded at restore rather than __init__ because
+        # the model is not available in __init__.
+        self.params = self.framework.model._backend.action_get()
+
+    def set_results(self, results: typing.Mapping) -> None:
+        """Report the result of the action.
+
+        Args:
+            results: The result of the action as a Dict
+        """
+        self.framework.model._backend.action_set(results)
+
+    def log(self, message: str) -> None:
+        """Send a message that a user will see while the action is running.
+
+        Args:
+            message: The message for the user.
+        """
+        self.framework.model._backend.action_log(message)
+
+    def fail(self, message: str = '') -> None:
+        """Report that this action has failed.
+
+        Args:
+            message: Optional message to record why it has failed.
+        """
+        self.framework.model._backend.action_fail(message)
+
+
+class InstallEvent(HookEvent):
+    """Event triggered when a charm is installed.
+
+    This event is triggered at the beginning of a charm's
+    lifecycle. Any associated callback method should be used to
+    perform one-time setup operations, such as installing prerequisite
+    software.
+    """
+
+
+class StartEvent(HookEvent):
+    """Event triggered immediately after first configuation change.
+
+    This event is triggered immediately after the first
+    :class:`ConfigChangedEvent`. Callback methods bound to the event should be
+    used to ensure that the charm’s software is in a running state. Note that
+    the charm’s software should be configured so as to persist in this state
+    through reboots without further intervention on Juju’s part.
+    """
+
+
+class StopEvent(HookEvent):
+    """Event triggered when a charm is shut down.
+
+    This event is triggered when an application's removal is requested
+    by the client. The event fires immediately before the end of the
+    unit’s destruction sequence. Callback methods bound to this event
+    should be used to ensure that the charm’s software is not running,
+    and that it will not start again on reboot.
+    """
+
+
+class RemoveEvent(HookEvent):
+    """Event triggered when a unit is about to be terminated.
+
+    This event fires prior to Juju removing the charm and terminating its unit.
+    """
+
+
+class ConfigChangedEvent(HookEvent):
+    """Event triggered when a configuration change is requested.
+
+    This event fires in several different situations.
+
+    - immediately after the :class:`install <InstallEvent>` event.
+    - after a :class:`relation is created <RelationCreatedEvent>`.
+    - after a :class:`leader is elected <LeaderElectedEvent>`.
+    - after changing charm configuration using the GUI or command line
+      interface
+    - when the charm :class:`starts <StartEvent>`.
+    - when a new unit :class:`joins a relation <RelationJoinedEvent>`.
+    - when there is a :class:`change to an existing relation <RelationChangedEvent>`.
+
+    Any callback method bound to this event cannot assume that the
+    software has already been started; it should not start stopped
+    software, but should (if appropriate) restart running software to
+    take configuration changes into account.
+    """
+
+
+class UpdateStatusEvent(HookEvent):
+    """Event triggered by a status update request from Juju.
+
+    This event is periodically triggered by Juju so that it can
+    provide constant feedback to the administrator about the status of
+    the application the charm is modeling. Any callback method bound
+    to this event should determine the "health" of the application and
+    set the status appropriately.
+
+    The interval between :class:`update-status <UpdateStatusEvent>` events can
+    be configured model-wide, e.g.  ``juju model-config
+    update-status-hook-interval=1m``.
+    """
+
+
+class UpgradeCharmEvent(HookEvent):
+    """Event triggered by request to upgrade the charm.
+
+    This event will be triggered when an administrator executes ``juju
+    upgrade-charm``. The event fires after Juju has unpacked the upgraded charm
+    code, and so this event will be handled by the callback method bound to the
+    event in the new codebase. The associated callback method is invoked
+    provided there is no existing error state. The callback method should be
+    used to reconcile current state written by an older version of the charm
+    into whatever form that is needed by the current charm version.
+    """
+
+
+class PreSeriesUpgradeEvent(HookEvent):
+    """Event triggered to prepare a unit for series upgrade.
+
+    This event triggers when an administrator executes ``juju upgrade-series
+    MACHINE prepare``. The event will fire for each unit that is running on the
+    specified machine. Any callback method bound to this event must prepare the
+    charm for an upgrade to the series. This may include things like exporting
+    database content to a version neutral format, or evacuating running
+    instances to other machines.
+
+    It can be assumed that only after all units on a machine have executed the
+    callback method associated with this event, the administrator will initiate
+    steps to actually upgrade the series.  After the upgrade has been completed,
+    the :class:`PostSeriesUpgradeEvent` will fire.
+    """
+
+
+class PostSeriesUpgradeEvent(HookEvent):
+    """Event triggered after a series upgrade.
+
+    This event is triggered after the administrator has done a distribution
+    upgrade (or rolled back and kept the same series). It is called in response
+    to ``juju upgrade-series MACHINE complete``. Associated charm callback
+    methods are expected to do whatever steps are necessary to reconfigure their
+    applications for the new series. This may include things like populating the
+    upgraded version of a database. Note however charms are expected to check if
+    the series has actually changed or whether it was rolled back to the
+    original series.
+    """
+
+
+class LeaderElectedEvent(HookEvent):
+    """Event triggered when a new leader has been elected.
+
+    Juju will trigger this event when a new leader unit is chosen for
+    a given application.
+
+    This event fires at least once after Juju selects a leader
+    unit. Callback methods bound to this event may take any action
+    required for the elected unit to assert leadership. Note that only
+    the elected leader unit will receive this event.
+    """
+
+
+class LeaderSettingsChangedEvent(HookEvent):
+    """Event triggered when leader changes any settings.
+
+    DEPRECATED NOTICE
+
+    This event has been deprecated in favor of using a Peer relation,
+    and having the leader set a value in the Application data bag for
+    that peer relation.  (see :class:`RelationChangedEvent`).
+    """
+
+
+class CollectMetricsEvent(HookEvent):
+    """Event triggered by Juju to collect metrics.
+
+    Juju fires this event every five minutes for the lifetime of the
+    unit. Callback methods bound to this event may use the :meth:`add_metrics`
+    method of this class to send measurements to Juju.
+
+    Note that associated callback methods are currently sandboxed in
+    how they can interact with Juju.
+    """
+
+    def add_metrics(self, metrics: typing.Mapping, labels: typing.Mapping = None) -> None:
+        """Record metrics that have been gathered by the charm for this unit.
+
+        Args:
+            metrics: A collection of {key: float} pairs that contains the
+              metrics that have been gathered
+            labels: {key:value} strings that can be applied to the
+                metrics that are being gathered
+        """
+        self.framework.model._backend.add_metrics(metrics, labels)
+
+
+class RelationEvent(HookEvent):
+    """A base class representing the various relation lifecycle events.
+
+    Relation lifecycle events are generated when application units
+    participate in relations.  Units can only participate in relations
+    after they have been "started", and before they have been
+    "stopped". Within that time window, the unit may participate in
+    several different relations at a time, including multiple
+    relations with the same name.
+
+    Attributes:
+        relation: The :class:`~ops.model.Relation` involved in this event
+        app: The remote :class:`~ops.model.Application` that has triggered this
+             event
+        unit: The remote unit that has triggered this event. This may be
+              ``None`` if the relation event was triggered as an
+              :class:`~ops.model.Application` level event
+
+    """
+
+    def __init__(self, handle, relation, app=None, unit=None):
+        super().__init__(handle)
+
+        if unit is not None and unit.app != app:
+            raise RuntimeError(
+                'cannot create RelationEvent with application {} and unit {}'.format(app, unit))
+
+        self.relation = relation
+        self.app = app
+        self.unit = unit
+
+    def snapshot(self) -> dict:
+        """Used by the framework to serialize the event to disk.
+
+        Not meant to be called by charm code.
+        """
+        snapshot = {
+            'relation_name': self.relation.name,
+            'relation_id': self.relation.id,
+        }
+        if self.app:
+            snapshot['app_name'] = self.app.name
+        if self.unit:
+            snapshot['unit_name'] = self.unit.name
+        return snapshot
+
+    def restore(self, snapshot: dict) -> None:
+        """Used by the framework to deserialize the event from disk.
+
+        Not meant to be called by charm code.
+        """
+        self.relation = self.framework.model.get_relation(
+            snapshot['relation_name'], snapshot['relation_id'])
+
+        app_name = snapshot.get('app_name')
+        if app_name:
+            self.app = self.framework.model.get_app(app_name)
+        else:
+            self.app = None
+
+        unit_name = snapshot.get('unit_name')
+        if unit_name:
+            self.unit = self.framework.model.get_unit(unit_name)
+        else:
+            self.unit = None
+
+
+class RelationCreatedEvent(RelationEvent):
+    """Event triggered when a new relation is created.
+
+    This is triggered when a new relation to another app is added in Juju. This
+    can occur before units for those applications have started. All existing
+    relations should be established before start.
+    """
+
+
+class RelationJoinedEvent(RelationEvent):
+    """Event triggered when a new unit joins a relation.
+
+    This event is triggered whenever a new unit of a related
+    application joins the relation.  The event fires only when that
+    remote unit is first observed by the unit. Callback methods bound
+    to this event may set any local unit settings that can be
+    determined using no more than the name of the joining unit and the
+    remote ``private-address`` setting, which is always available when
+    the relation is created and is by convention not deleted.
+    """
+
+
+class RelationChangedEvent(RelationEvent):
+    """Event triggered when relation data changes.
+
+    This event is triggered whenever there is a change to the data bucket for a
+    related application or unit. Look at ``event.relation.data[event.unit/app]``
+    to see the new information, where ``event`` is the event object passed to
+    the callback method bound to this event.
+
+    This event always fires once, after :class:`RelationJoinedEvent`, and
+    will subsequently fire whenever that remote unit changes its settings for
+    the relation. Callback methods bound to this event should be the only ones
+    that rely on remote relation settings. They should not error if the settings
+    are incomplete, since it can be guaranteed that when the remote unit or
+    application changes its settings, the event will fire again.
+
+    The settings that may be queried, or set, are determined by the relation’s
+    interface.
+    """
+
+
+class RelationDepartedEvent(RelationEvent):
+    """Event triggered when a unit leaves a relation.
+
+    This is the inverse of the :class:`RelationJoinedEvent`, representing when a
+    unit is leaving the relation (the unit is being removed, the app is being
+    removed, the relation is being removed). It is fired once for each unit that
+    is going away.
+
+    When the remote unit is known to be leaving the relation, this will result
+    in the :class:`RelationChangedEvent` firing at least once, after which the
+    :class:`RelationDepartedEvent` will fire. The :class:`RelationDepartedEvent`
+    will fire once only. Once the :class:`RelationDepartedEvent` has fired no
+    further :class:`RelationChangedEvent` will fire.
+
+    Callback methods bound to this event may be used to remove all
+    references to the departing remote unit, because there’s no
+    guarantee that it’s still part of the system; it’s perfectly
+    probable (although not guaranteed) that the system running that
+    unit has already shut down.
+
+    Once all callback methods bound to this event have been run for such a
+    relation, the unit agent will fire the :class:`RelationBrokenEvent`.
+    """
+
+
+class RelationBrokenEvent(RelationEvent):
+    """Event triggered when a relation is removed.
+
+    If a relation is being removed (``juju remove-relation`` or ``juju
+    remove-application``), once all the units have been removed, this event will
+    fire to signal that the relationship has been fully terminated.
+
+    The event indicates that the current relation is no longer valid, and that
+    the charm’s software must be configured as though the relation had never
+    existed. It will only be called after every callback method bound to
+    :class:`RelationDepartedEvent` has been run. If a callback method
+    bound to this event is being executed, it is gauranteed that no remote units
+    are currently known locally.
+    """
+
+
+class StorageEvent(HookEvent):
+    """Base class representing storage-related events.
+
+    Juju can provide a variety of storage types to a charms. The
+    charms can define several different types of storage that are
+    allocated from Juju. Changes in state of storage trigger sub-types
+    of :class:`StorageEvent`.
+    """
+
+
+class StorageAttachedEvent(StorageEvent):
+    """Event triggered when new storage becomes available.
+
+    This event is triggered when new storage is available for the
+    charm to use.
+
+    Callback methods bound to this event allow the charm to run code
+    when storage has been added. Such methods will be run before the
+    :class:`InstallEvent` fires, so that the installation routine may
+    use the storage. The name prefix of this hook will depend on the
+    storage key defined in the ``metadata.yaml`` file.
+    """
+
+
+class StorageDetachingEvent(StorageEvent):
+    """Event triggered prior to removal of storage.
+
+    This event is triggered when storage a charm has been using is
+    going away.
+
+    Callback methods bound to this event allow the charm to run code
+    before storage is removed. Such methods will be run before storage
+    is detached, and always before the :class:`StopEvent` fires, thereby
+    allowing the charm to gracefully release resources before they are
+    removed and before the unit terminates. The name prefix of the
+    hook will depend on the storage key defined in the ``metadata.yaml``
+    file.
+    """
+
+
+class CharmEvents(ObjectEvents):
+    """Events generated by Juju pertaining to application lifecycle.
+
+    This class is used to create an event descriptor (``self.on``) attribute for
+    a charm class that inherits from :class:`CharmBase`. The event descriptor
+    may be used to set up event handlers for corresponding events.
+
+    By default the following events will be provided through
+    :class:`CharmBase`::
+
+        self.on.install
+        self.on.start
+        self.on.remove
+        self.on.update_status
+        self.on.config_changed
+        self.on.upgrade_charm
+        self.on.pre_series_upgrade
+        self.on.post_series_upgrade
+        self.on.leader_elected
+        self.on.collect_metrics
+
+
+    In addition to these, depending on the charm's metadata (``metadata.yaml``),
+    named relation and storage events may also be defined.  These named events
+    are created by :class:`CharmBase` using charm metadata.  The named events may be
+    accessed as ``self.on[<name>].<relation_or_storage_event>``
+    """
+
+    install = EventSource(InstallEvent)
+    start = EventSource(StartEvent)
+    stop = EventSource(StopEvent)
+    remove = EventSource(RemoveEvent)
+    update_status = EventSource(UpdateStatusEvent)
+    config_changed = EventSource(ConfigChangedEvent)
+    upgrade_charm = EventSource(UpgradeCharmEvent)
+    pre_series_upgrade = EventSource(PreSeriesUpgradeEvent)
+    post_series_upgrade = EventSource(PostSeriesUpgradeEvent)
+    leader_elected = EventSource(LeaderElectedEvent)
+    leader_settings_changed = EventSource(LeaderSettingsChangedEvent)
+    collect_metrics = EventSource(CollectMetricsEvent)
+
+
+class CharmBase(Object):
+    """Base class that represents the charm overall.
+
+    :class:`CharmBase` is used to create a charm. This is done by inheriting
+    from :class:`CharmBase` and customising the sub class as required. So to
+    create your own charm, say ``MyCharm``, define a charm class and set up the
+    required event handlers (“hooks”) in its constructor::
+
+        import logging
+
+        from ops.charm import CharmBase
+        from ops.main import main
+
+        logger = logging.getLogger(__name__)
+
+        def MyCharm(CharmBase):
+            def __init__(self, *args):
+                logger.debug('Initializing Charm')
+
+                super().__init__(*args)
+
+                self.framework.observe(self.on.config_changed, self._on_config_changed)
+                self.framework.observe(self.on.stop, self._on_stop)
+                # ...
+
+        if __name__ == "__main__":
+            main(MyCharm)
+
+    As shown in the example above, a charm class is instantiated by
+    :func:`~ops.main.main` rather than charm authors directly instantiating a
+    charm.
+
+    Args:
+        framework: The framework responsible for managing the Model and events for this
+            charm.
+        key: Ignored; will remove after deprecation period of the signature change.
+
+    """
+
+    # note that without the #: below, sphinx will copy the whole of CharmEvents
+    # docstring inline which is less than ideal.
+    #: Used to set up event handlers; see :class:`CharmEvents`.
+    on = CharmEvents()
+
+    def __init__(self, framework: Framework, key: typing.Optional = None):
+        super().__init__(framework, None)
+
+        for relation_name in self.framework.meta.relations:
+            relation_name = relation_name.replace('-', '_')
+            self.on.define_event(relation_name + '_relation_created', RelationCreatedEvent)
+            self.on.define_event(relation_name + '_relation_joined', RelationJoinedEvent)
+            self.on.define_event(relation_name + '_relation_changed', RelationChangedEvent)
+            self.on.define_event(relation_name + '_relation_departed', RelationDepartedEvent)
+            self.on.define_event(relation_name + '_relation_broken', RelationBrokenEvent)
+
+        for storage_name in self.framework.meta.storages:
+            storage_name = storage_name.replace('-', '_')
+            self.on.define_event(storage_name + '_storage_attached', StorageAttachedEvent)
+            self.on.define_event(storage_name + '_storage_detaching', StorageDetachingEvent)
+
+        for action_name in self.framework.meta.actions:
+            action_name = action_name.replace('-', '_')
+            self.on.define_event(action_name + '_action', ActionEvent)
+
+    @property
+    def app(self) -> model.Application:
+        """Application that this unit is part of."""
+        return self.framework.model.app
+
+    @property
+    def unit(self) -> model.Unit:
+        """Unit that this execution is responsible for."""
+        return self.framework.model.unit
+
+    @property
+    def meta(self) -> 'CharmMeta':
+        """Metadata of this charm."""
+        return self.framework.meta
+
+    @property
+    def charm_dir(self) -> pathlib.Path:
+        """Root directory of the charm as it is running."""
+        return self.framework.charm_dir
+
+    @property
+    def config(self) -> model.ConfigData:
+        """A mapping containing the charm's config and current values."""
+        return self.model.config
+
+
+class CharmMeta:
+    """Object containing the metadata for the charm.
+
+    This is read from ``metadata.yaml`` and/or ``actions.yaml``. Generally
+    charms will define this information, rather than reading it at runtime. This
+    class is mostly for the framework to understand what the charm has defined.
+
+    The :attr:`maintainers`, :attr:`tags`, :attr:`terms`, :attr:`series`, and
+    :attr:`extra_bindings` attributes are all lists of strings.  The
+    :attr:`requires`, :attr:`provides`, :attr:`peers`, :attr:`relations`,
+    :attr:`storages`, :attr:`resources`, and :attr:`payloads` attributes are all
+    mappings of names to instances of the respective :class:`RelationMeta`,
+    :class:`StorageMeta`, :class:`ResourceMeta`, or :class:`PayloadMeta`.
+
+    The :attr:`relations` attribute is a convenience accessor which includes all
+    of the ``requires``, ``provides``, and ``peers`` :class:`RelationMeta`
+    items.  If needed, the role of the relation definition can be obtained from
+    its :attr:`role <RelationMeta.role>` attribute.
+
+    Attributes:
+        name: The name of this charm
+        summary: Short description of what this charm does
+        description: Long description for this charm
+        maintainers: A list of strings of the email addresses of the maintainers
+                     of this charm.
+        tags: Charm store tag metadata for categories associated with this charm.
+        terms: Charm store terms that should be agreed to before this charm can
+               be deployed. (Used for things like licensing issues.)
+        series: The list of supported OS series that this charm can support.
+                The first entry in the list is the default series that will be
+                used by deploy if no other series is requested by the user.
+        subordinate: True/False whether this charm is intended to be used as a
+                     subordinate charm.
+        min_juju_version: If supplied, indicates this charm needs features that
+                          are not available in older versions of Juju.
+        requires: A dict of {name: :class:`RelationMeta` } for each 'requires' relation.
+        provides: A dict of {name: :class:`RelationMeta` } for each 'provides' relation.
+        peers: A dict of {name: :class:`RelationMeta` } for each 'peer' relation.
+        relations: A dict containing all :class:`RelationMeta` attributes (merged from other
+                   sections)
+        storages: A dict of {name: :class:`StorageMeta`} for each defined storage.
+        resources: A dict of {name: :class:`ResourceMeta`} for each defined resource.
+        payloads: A dict of {name: :class:`PayloadMeta`} for each defined payload.
+        extra_bindings: A dict of additional named bindings that a charm can use
+                        for network configuration.
+        actions: A dict of {name: :class:`ActionMeta`} for actions that the charm has defined.
+    Args:
+        raw: a mapping containing the contents of metadata.yaml
+        actions_raw: a mapping containing the contents of actions.yaml
+
+    """
+
+    def __init__(self, raw: dict = {}, actions_raw: dict = {}):
+        self.name = raw.get('name', '')
+        self.summary = raw.get('summary', '')
+        self.description = raw.get('description', '')
+        self.maintainers = []
+        if 'maintainer' in raw:
+            self.maintainers.append(raw['maintainer'])
+        if 'maintainers' in raw:
+            self.maintainers.extend(raw['maintainers'])
+        self.tags = raw.get('tags', [])
+        self.terms = raw.get('terms', [])
+        self.series = raw.get('series', [])
+        self.subordinate = raw.get('subordinate', False)
+        self.min_juju_version = raw.get('min-juju-version')
+        self.requires = {name: RelationMeta(RelationRole.requires, name, rel)
+                         for name, rel in raw.get('requires', {}).items()}
+        self.provides = {name: RelationMeta(RelationRole.provides, name, rel)
+                         for name, rel in raw.get('provides', {}).items()}
+        self.peers = {name: RelationMeta(RelationRole.peer, name, rel)
+                      for name, rel in raw.get('peers', {}).items()}
+        self.relations = {}
+        self.relations.update(self.requires)
+        self.relations.update(self.provides)
+        self.relations.update(self.peers)
+        self.storages = {name: StorageMeta(name, storage)
+                         for name, storage in raw.get('storage', {}).items()}
+        self.resources = {name: ResourceMeta(name, res)
+                          for name, res in raw.get('resources', {}).items()}
+        self.payloads = {name: PayloadMeta(name, payload)
+                         for name, payload in raw.get('payloads', {}).items()}
+        self.extra_bindings = raw.get('extra-bindings', {})
+        self.actions = {name: ActionMeta(name, action) for name, action in actions_raw.items()}
+
+    @classmethod
+    def from_yaml(
+            cls, metadata: typing.Union[str, typing.TextIO],
+            actions: typing.Optional[typing.Union[str, typing.TextIO]] = None):
+        """Instantiate a CharmMeta from a YAML description of metadata.yaml.
+
+        Args:
+            metadata: A YAML description of charm metadata (name, relations, etc.)
+                This can be a simple string, or a file-like object. (passed to `yaml.safe_load`).
+            actions: YAML description of Actions for this charm (eg actions.yaml)
+        """
+        meta = _loadYaml(metadata)
+        raw_actions = {}
+        if actions is not None:
+            raw_actions = _loadYaml(actions)
+            if raw_actions is None:
+                raw_actions = {}
+        return cls(meta, raw_actions)
+
+
+class RelationRole(enum.Enum):
+    """An annotation for a charm's role in a relation.
+
+    For each relation a charm's role may be
+
+    - A Peer
+    - A service consumer in the relation ('requires')
+    - A service provider in the relation ('provides')
+    """
+    peer = 'peer'
+    requires = 'requires'
+    provides = 'provides'
+
+    def is_peer(self) -> bool:
+        """Return whether the current role is peer.
+
+        A convenience to avoid having to import charm.
+        """
+        return self is RelationRole.peer
+
+
+class RelationMeta:
+    """Object containing metadata about a relation definition.
+
+    Should not be constructed directly by charm code. Is gotten from one of
+    :attr:`CharmMeta.peers`, :attr:`CharmMeta.requires`, :attr:`CharmMeta.provides`,
+    or :attr:`CharmMeta.relations`.
+
+    Attributes:
+        role: This is :class:`RelationRole`; one of peer/requires/provides
+        relation_name: Name of this relation from metadata.yaml
+        interface_name: Optional definition of the interface protocol.
+        scope: "global" or "container" scope based on how the relation should be used.
+    """
+
+    def __init__(self, role: RelationRole, relation_name: str, raw: dict):
+        if not isinstance(role, RelationRole):
+            raise TypeError("role should be a Role, not {!r}".format(role))
+        self.role = role
+        self.relation_name = relation_name
+        self.interface_name = raw['interface']
+        self.scope = raw.get('scope')
+
+
+class StorageMeta:
+    """Object containing metadata about a storage definition.
+
+    Attributes:
+        storage_name: Name of storage
+        type: Storage type
+        description: A text description of the storage
+        read_only: Whether or not the storage is read only
+        minimum_size: Minimum size of storage
+        location: Mount point of storage
+        multiple_range: Range of numeric qualifiers when multiple storage units are used
+    """
+
+    def __init__(self, name, raw):
+        self.storage_name = name
+        self.type = raw['type']
+        self.description = raw.get('description', '')
+        self.shared = raw.get('shared', False)
+        self.read_only = raw.get('read-only', False)
+        self.minimum_size = raw.get('minimum-size')
+        self.location = raw.get('location')
+        self.multiple_range = None
+        if 'multiple' in raw:
+            range = raw['multiple']['range']
+            if '-' not in range:
+                self.multiple_range = (int(range), int(range))
+            else:
+                range = range.split('-')
+                self.multiple_range = (int(range[0]), int(range[1]) if range[1] else None)
+
+
+class ResourceMeta:
+    """Object containing metadata about a resource definition.
+
+    Attributes:
+        resource_name: Name of resource
+        filename: Name of file
+        description: A text description of resource
+    """
+
+    def __init__(self, name, raw):
+        self.resource_name = name
+        self.type = raw['type']
+        self.filename = raw.get('filename', None)
+        self.description = raw.get('description', '')
+
+
+class PayloadMeta:
+    """Object containing metadata about a payload definition.
+
+    Attributes:
+        payload_name: Name of payload
+        type: Payload type
+    """
+
+    def __init__(self, name, raw):
+        self.payload_name = name
+        self.type = raw['type']
+
+
+class ActionMeta:
+    """Object containing metadata about an action's definition."""
+
+    def __init__(self, name, raw=None):
+        raw = raw or {}
+        self.name = name
+        self.title = raw.get('title', '')
+        self.description = raw.get('description', '')
+        self.parameters = raw.get('params', {})  # {<parameter name>: <JSON Schema definition>}
+        self.required = raw.get('required', [])  # [<parameter name>, ...]
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/framework.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/framework.py
new file mode 100644
index 0000000000000000000000000000000000000000..d20c0007ebcd58456a0bac90ae5dc0eaacb9a407
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/framework.py
@@ -0,0 +1,1199 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""The Operator Framework infrastructure."""
+
+import collections
+import collections.abc
+import inspect
+import keyword
+import logging
+import marshal
+import os
+import pathlib
+import pdb
+import re
+import sys
+import types
+import weakref
+
+from ops import charm
+from ops.storage import (
+    NoSnapshotError,
+    SQLiteStorage,
+)
+
+logger = logging.getLogger(__name__)
+
+
+class Handle:
+    """Handle defines a name for an object in the form of a hierarchical path.
+
+    The provided parent is the object (or that object's handle) that this handle
+    sits under, or None if the object identified by this handle stands by itself
+    as the root of its own hierarchy.
+
+    The handle kind is a string that defines a namespace so objects with the
+    same parent and kind will have unique keys.
+
+    The handle key is a string uniquely identifying the object. No other objects
+    under the same parent and kind may have the same key.
+    """
+
+    def __init__(self, parent, kind, key):
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        self._parent = parent
+        self._kind = kind
+        self._key = key
+        if parent:
+            if key:
+                self._path = "{}/{}[{}]".format(parent, kind, key)
+            else:
+                self._path = "{}/{}".format(parent, kind)
+        else:
+            if key:
+                self._path = "{}[{}]".format(kind, key)
+            else:
+                self._path = "{}".format(kind)
+
+    def nest(self, kind, key):
+        """Create a new handle as child of the current one."""
+        return Handle(self, kind, key)
+
+    def __hash__(self):
+        return hash((self.parent, self.kind, self.key))
+
+    def __eq__(self, other):
+        return (self.parent, self.kind, self.key) == (other.parent, other.kind, other.key)
+
+    def __str__(self):
+        return self.path
+
+    @property
+    def parent(self):
+        """Return own parent handle."""
+        return self._parent
+
+    @property
+    def kind(self):
+        """Return the handle's kind."""
+        return self._kind
+
+    @property
+    def key(self):
+        """Return the handle's key."""
+        return self._key
+
+    @property
+    def path(self):
+        """Return the handle's path."""
+        return self._path
+
+    @classmethod
+    def from_path(cls, path):
+        """Build a handle from the indicated path."""
+        handle = None
+        for pair in path.split("/"):
+            pair = pair.split("[")
+            good = False
+            if len(pair) == 1:
+                kind, key = pair[0], None
+                good = True
+            elif len(pair) == 2:
+                kind, key = pair
+                if key and key[-1] == ']':
+                    key = key[:-1]
+                    good = True
+            if not good:
+                raise RuntimeError("attempted to restore invalid handle path {}".format(path))
+            handle = Handle(handle, kind, key)
+        return handle
+
+
+class EventBase:
+    """The base for all the different Events.
+
+    Inherit this and override 'snapshot' and 'restore' methods to build a custom event.
+    """
+
+    def __init__(self, handle):
+        self.handle = handle
+        self.deferred = False
+
+    def __repr__(self):
+        return "<%s via %s>" % (self.__class__.__name__, self.handle)
+
+    def defer(self):
+        """Defer the event to the future.
+
+        Deferring an event from a handler puts that handler into a queue, to be
+        called again the next time the charm is invoked. This invocation may be
+        the result of an action, or any event other than metric events. The
+        queue of events will be dispatched before the new event is processed.
+
+        From the above you may deduce, but it's important to point out:
+
+        * ``defer()`` does not interrupt the execution of the current event
+          handler. In almost all cases, a call to ``defer()`` should be followed
+          by an explicit ``return`` from the handler;
+
+        * the re-execution of the deferred event handler starts from the top of
+          the handler method (not where defer was called);
+
+        * only the handlers that actually called ``defer()`` are called again
+          (that is: despite talking about “deferring an event” it is actually
+          the handler/event combination that is deferred); and
+
+        * any deferred events get processed before the event (or action) that
+          caused the current invocation of the charm.
+
+        The general desire to call ``defer()`` happens when some precondition
+        isn't yet met. However, care should be exercised as to whether it is
+        better to defer this event so that you see it again, or whether it is
+        better to just wait for the event that indicates the precondition has
+        been met.
+
+        For example, if ``config-changed`` is fired, and you are waiting for
+        different config, there is no reason to defer the event because there
+        will be a *different* ``config-changed`` event when the config actually
+        changes, rather than checking to see if maybe config has changed prior
+        to every other event that occurs.
+
+        Similarly, if you need 2 events to occur before you are ready to
+        proceed (say event A and B). When you see event A, you could chose to
+        ``defer()`` it because you haven't seen B yet. However, that leads to:
+
+        1. event A fires, calls defer()
+
+        2. event B fires, event A handler is called first, still hasn't seen B
+           happen, so is deferred again. Then B happens, which progresses since
+           it has seen A.
+
+        3. At some future time, event C happens, which also checks if A can
+           proceed.
+
+        """
+        logger.debug("Deferring %s.", self)
+        self.deferred = True
+
+    def snapshot(self):
+        """Return the snapshot data that should be persisted.
+
+        Subclasses must override to save any custom state.
+        """
+        return None
+
+    def restore(self, snapshot):
+        """Restore the value state from the given snapshot.
+
+        Subclasses must override to restore their custom state.
+        """
+        self.deferred = False
+
+
+class EventSource:
+    """EventSource wraps an event type with a descriptor to facilitate observing and emitting.
+
+    It is generally used as:
+
+        class SomethingHappened(EventBase):
+            pass
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    With that, instances of that type will offer the someobj.something_happened
+    attribute which is a BoundEvent and may be used to emit and observe the event.
+    """
+
+    def __init__(self, event_type):
+        if not isinstance(event_type, type) or not issubclass(event_type, EventBase):
+            raise RuntimeError(
+                'Event requires a subclass of EventBase as an argument, got {}'.format(event_type))
+        self.event_type = event_type
+        self.event_kind = None
+        self.emitter_type = None
+
+    def _set_name(self, emitter_type, event_kind):
+        if self.event_kind is not None:
+            raise RuntimeError(
+                'EventSource({}) reused as {}.{} and {}.{}'.format(
+                    self.event_type.__name__,
+                    self.emitter_type.__name__,
+                    self.event_kind,
+                    emitter_type.__name__,
+                    event_kind,
+                ))
+        self.event_kind = event_kind
+        self.emitter_type = emitter_type
+
+    def __get__(self, emitter, emitter_type=None):
+        if emitter is None:
+            return self
+        # Framework might not be available if accessed as CharmClass.on.event
+        # rather than charm_instance.on.event, but in that case it couldn't be
+        # emitted anyway, so there's no point to registering it.
+        framework = getattr(emitter, 'framework', None)
+        if framework is not None:
+            framework.register_type(self.event_type, emitter, self.event_kind)
+        return BoundEvent(emitter, self.event_type, self.event_kind)
+
+
+class BoundEvent:
+    """Event bound to an Object."""
+
+    def __repr__(self):
+        return '<BoundEvent {} bound to {}.{} at {}>'.format(
+            self.event_type.__name__,
+            type(self.emitter).__name__,
+            self.event_kind,
+            hex(id(self)),
+        )
+
+    def __init__(self, emitter, event_type, event_kind):
+        self.emitter = emitter
+        self.event_type = event_type
+        self.event_kind = event_kind
+
+    def emit(self, *args, **kwargs):
+        """Emit event to all registered observers.
+
+        The current storage state is committed before and after each observer is notified.
+        """
+        framework = self.emitter.framework
+        key = framework._next_event_key()
+        event = self.event_type(Handle(self.emitter, self.event_kind, key), *args, **kwargs)
+        framework._emit(event)
+
+
+class HandleKind:
+    """Helper descriptor to define the Object.handle_kind field.
+
+    The handle_kind for an object defaults to its type name, but it may
+    be explicitly overridden if desired.
+    """
+
+    def __get__(self, obj, obj_type):
+        kind = obj_type.__dict__.get("handle_kind")
+        if kind:
+            return kind
+        return obj_type.__name__
+
+
+class _Metaclass(type):
+    """Helper class to ensure proper instantiation of Object-derived classes.
+
+    This class currently has a single purpose: events derived from EventSource
+    that are class attributes of Object-derived classes need to be told what
+    their name is in that class. For example, in
+
+        class SomeObject(Object):
+            something_happened = EventSource(SomethingHappened)
+
+    the instance of EventSource needs to know it's called 'something_happened'.
+
+    Starting from python 3.6 we could use __set_name__ on EventSource for this,
+    but until then this (meta)class does the equivalent work.
+
+    TODO: when we drop support for 3.5 drop this class, and rename _set_name in
+          EventSource to __set_name__; everything should continue to work.
+
+    """
+
+    def __new__(typ, *a, **kw):
+        k = super().__new__(typ, *a, **kw)
+        # k is now the Object-derived class; loop over its class attributes
+        for n, v in vars(k).items():
+            # we could do duck typing here if we want to support
+            # non-EventSource-derived shenanigans. We don't.
+            if isinstance(v, EventSource):
+                # this is what 3.6+ does automatically for us:
+                v._set_name(k, n)
+        return k
+
+
+class Object(metaclass=_Metaclass):
+    """Base class of all the charm-related objects."""
+
+    handle_kind = HandleKind()
+
+    def __init__(self, parent, key):
+        kind = self.handle_kind
+        if isinstance(parent, Framework):
+            self.framework = parent
+            # Avoid Framework instances having a circular reference to themselves.
+            if self.framework is self:
+                self.framework = weakref.proxy(self.framework)
+            self.handle = Handle(None, kind, key)
+        else:
+            self.framework = parent.framework
+            self.handle = Handle(parent, kind, key)
+        self.framework._track(self)
+
+        # TODO Detect conflicting handles here.
+
+    @property
+    def model(self):
+        """Shortcut for more simple access the model."""
+        return self.framework.model
+
+
+class ObjectEvents(Object):
+    """Convenience type to allow defining .on attributes at class level."""
+
+    handle_kind = "on"
+
+    def __init__(self, parent=None, key=None):
+        if parent is not None:
+            super().__init__(parent, key)
+        else:
+            self._cache = weakref.WeakKeyDictionary()
+
+    def __get__(self, emitter, emitter_type):
+        if emitter is None:
+            return self
+        instance = self._cache.get(emitter)
+        if instance is None:
+            # Same type, different instance, more data. Doing this unusual construct
+            # means people can subclass just this one class to have their own 'on'.
+            instance = self._cache[emitter] = type(self)(emitter)
+        return instance
+
+    @classmethod
+    def define_event(cls, event_kind, event_type):
+        """Define an event on this type at runtime.
+
+        cls: a type to define an event on.
+
+        event_kind: an attribute name that will be used to access the
+                    event. Must be a valid python identifier, not be a keyword
+                    or an existing attribute.
+
+        event_type: a type of the event to define.
+
+        """
+        prefix = 'unable to define an event with event_kind that '
+        if not event_kind.isidentifier():
+            raise RuntimeError(prefix + 'is not a valid python identifier: ' + event_kind)
+        elif keyword.iskeyword(event_kind):
+            raise RuntimeError(prefix + 'is a python keyword: ' + event_kind)
+        try:
+            getattr(cls, event_kind)
+            raise RuntimeError(
+                prefix + 'overlaps with an existing type {} attribute: {}'.format(cls, event_kind))
+        except AttributeError:
+            pass
+
+        event_descriptor = EventSource(event_type)
+        event_descriptor._set_name(cls, event_kind)
+        setattr(cls, event_kind, event_descriptor)
+
+    def _event_kinds(self):
+        event_kinds = []
+        # We have to iterate over the class rather than instance to allow for properties which
+        # might call this method (e.g., event views), leading to infinite recursion.
+        for attr_name, attr_value in inspect.getmembers(type(self)):
+            if isinstance(attr_value, EventSource):
+                # We actually care about the bound_event, however, since it
+                # provides the most info for users of this method.
+                event_kinds.append(attr_name)
+        return event_kinds
+
+    def events(self):
+        """Return a mapping of event_kinds to bound_events for all available events."""
+        return {event_kind: getattr(self, event_kind) for event_kind in self._event_kinds()}
+
+    def __getitem__(self, key):
+        return PrefixedEvents(self, key)
+
+    def __repr__(self):
+        k = type(self)
+        event_kinds = ', '.join(sorted(self._event_kinds()))
+        return '<{}.{}: {}>'.format(k.__module__, k.__qualname__, event_kinds)
+
+
+class PrefixedEvents:
+    """Events to be found in all events using a specific prefix."""
+
+    def __init__(self, emitter, key):
+        self._emitter = emitter
+        self._prefix = key.replace("-", "_") + '_'
+
+    def __getattr__(self, name):
+        return getattr(self._emitter, self._prefix + name)
+
+
+class PreCommitEvent(EventBase):
+    """Events that will be emited first on commit."""
+
+
+class CommitEvent(EventBase):
+    """Events that will be emited second on commit."""
+
+
+class FrameworkEvents(ObjectEvents):
+    """Manager of all framework events."""
+    pre_commit = EventSource(PreCommitEvent)
+    commit = EventSource(CommitEvent)
+
+
+class NoTypeError(Exception):
+    """No class to hold it was found when restoring an event."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return "cannot restore {} since no class was registered for it".format(self.handle_path)
+
+
+# the message to show to the user when a pdb breakpoint goes active
+_BREAKPOINT_WELCOME_MESSAGE = """
+Starting pdb to debug charm operator.
+Run `h` for help, `c` to continue, or `exit`/CTRL-d to abort.
+Future breakpoints may interrupt execution again.
+More details at https://discourse.jujucharms.com/t/debugging-charm-hooks
+
+"""
+
+
+_event_regex = r'^(|.*/)on/[a-zA-Z_]+\[\d+\]$'
+
+
+class Framework(Object):
+    """Main interface to from the Charm to the Operator Framework internals."""
+
+    on = FrameworkEvents()
+
+    # Override properties from Object so that we can set them in __init__.
+    model = None
+    meta = None
+    charm_dir = None
+
+    def __init__(self, storage, charm_dir, meta, model):
+
+        super().__init__(self, None)
+
+        self.charm_dir = charm_dir
+        self.meta = meta
+        self.model = model
+        self._observers = []      # [(observer_path, method_name, parent_path, event_key)]
+        self._observer = weakref.WeakValueDictionary()       # {observer_path: observer}
+        self._objects = weakref.WeakValueDictionary()
+        self._type_registry = {}  # {(parent_path, kind): cls}
+        self._type_known = set()  # {cls}
+
+        if isinstance(storage, (str, pathlib.Path)):
+            logger.warning(
+                "deprecated: Framework now takes a Storage not a path")
+            storage = SQLiteStorage(storage)
+        self._storage = storage
+
+        # We can't use the higher-level StoredState because it relies on events.
+        self.register_type(StoredStateData, None, StoredStateData.handle_kind)
+        stored_handle = Handle(None, StoredStateData.handle_kind, '_stored')
+        try:
+            self._stored = self.load_snapshot(stored_handle)
+        except NoSnapshotError:
+            self._stored = StoredStateData(self, '_stored')
+            self._stored['event_count'] = 0
+
+        # Flag to indicate that we already presented the welcome message in a debugger breakpoint
+        self._breakpoint_welcomed = False
+
+        # Parse the env var once, which may be used multiple times later
+        debug_at = os.environ.get('JUJU_DEBUG_AT')
+        self._juju_debug_at = debug_at.split(',') if debug_at else ()
+
+    def set_breakpointhook(self):
+        """Hook into sys.breakpointhook so the builtin breakpoint() works as expected.
+
+        This method is called by ``main``, and is not intended to be
+        called by users of the framework itself outside of perhaps
+        some testing scenarios.
+
+        It returns the old value of sys.excepthook.
+
+        The breakpoint function is a Python >= 3.7 feature.
+
+        This method was added in ops 1.0; before that, it was done as
+        part of the Framework's __init__.
+        """
+        old_breakpointhook = getattr(sys, 'breakpointhook', None)
+        if old_breakpointhook is not None:
+            # Hook into builtin breakpoint, so if Python >= 3.7, devs will be able to just do
+            # breakpoint()
+            sys.breakpointhook = self.breakpoint
+        return old_breakpointhook
+
+    def close(self):
+        """Close the underlying backends."""
+        self._storage.close()
+
+    def _track(self, obj):
+        """Track object and ensure it is the only object created using its handle path."""
+        if obj is self:
+            # Framework objects don't track themselves
+            return
+        if obj.handle.path in self.framework._objects:
+            raise RuntimeError(
+                'two objects claiming to be {} have been created'.format(obj.handle.path))
+        self._objects[obj.handle.path] = obj
+
+    def _forget(self, obj):
+        """Stop tracking the given object. See also _track."""
+        self._objects.pop(obj.handle.path, None)
+
+    def commit(self):
+        """Save changes to the underlying backends."""
+        # Give a chance for objects to persist data they want to before a commit is made.
+        self.on.pre_commit.emit()
+        # Make sure snapshots are saved by instances of StoredStateData. Any possible state
+        # modifications in on_commit handlers of instances of other classes will not be persisted.
+        self.on.commit.emit()
+        # Save our event count after all events have been emitted.
+        self.save_snapshot(self._stored)
+        self._storage.commit()
+
+    def register_type(self, cls, parent, kind=None):
+        """Register a type to a handle."""
+        if parent and not isinstance(parent, Handle):
+            parent = parent.handle
+        if parent:
+            parent_path = parent.path
+        else:
+            parent_path = None
+        if not kind:
+            kind = cls.handle_kind
+        self._type_registry[(parent_path, kind)] = cls
+        self._type_known.add(cls)
+
+    def save_snapshot(self, value):
+        """Save a persistent snapshot of the provided value.
+
+        The provided value must implement the following interface:
+
+        value.handle = Handle(...)
+        value.snapshot() => {...}  # Simple builtin types only.
+        value.restore(snapshot)    # Restore custom state from prior snapshot.
+        """
+        if type(value) not in self._type_known:
+            raise RuntimeError(
+                'cannot save {} values before registering that type'.format(type(value).__name__))
+        data = value.snapshot()
+
+        # Use marshal as a validator, enforcing the use of simple types, as we later the
+        # information is really pickled, which is too error prone for future evolution of the
+        # stored data (e.g. if the developer stores a custom object and later changes its
+        # class name; when unpickling the original class will not be there and event
+        # data loading will fail).
+        try:
+            marshal.dumps(data)
+        except ValueError:
+            msg = "unable to save the data for {}, it must contain only simple types: {!r}"
+            raise ValueError(msg.format(value.__class__.__name__, data))
+
+        self._storage.save_snapshot(value.handle.path, data)
+
+    def load_snapshot(self, handle):
+        """Load a persistent snapshot."""
+        parent_path = None
+        if handle.parent:
+            parent_path = handle.parent.path
+        cls = self._type_registry.get((parent_path, handle.kind))
+        if not cls:
+            raise NoTypeError(handle.path)
+        data = self._storage.load_snapshot(handle.path)
+        obj = cls.__new__(cls)
+        obj.framework = self
+        obj.handle = handle
+        obj.restore(data)
+        self._track(obj)
+        return obj
+
+    def drop_snapshot(self, handle):
+        """Discard a persistent snapshot."""
+        self._storage.drop_snapshot(handle.path)
+
+    def observe(self, bound_event: BoundEvent, observer: types.MethodType):
+        """Register observer to be called when bound_event is emitted.
+
+        The bound_event is generally provided as an attribute of the object that emits
+        the event, and is created in this style::
+
+            class SomeObject:
+                something_happened = Event(SomethingHappened)
+
+        That event may be observed as::
+
+            framework.observe(someobj.something_happened, self._on_something_happened)
+
+        Raises:
+            RuntimeError: if bound_event or observer are the wrong type.
+        """
+        if not isinstance(bound_event, BoundEvent):
+            raise RuntimeError(
+                'Framework.observe requires a BoundEvent as second parameter, got {}'.format(
+                    bound_event))
+        if not isinstance(observer, types.MethodType):
+            # help users of older versions of the framework
+            if isinstance(observer, charm.CharmBase):
+                raise TypeError(
+                    'observer methods must now be explicitly provided;'
+                    ' please replace observe(self.on.{0}, self)'
+                    ' with e.g. observe(self.on.{0}, self._on_{0})'.format(
+                        bound_event.event_kind))
+            raise RuntimeError(
+                'Framework.observe requires a method as third parameter, got {}'.format(observer))
+
+        event_type = bound_event.event_type
+        event_kind = bound_event.event_kind
+        emitter = bound_event.emitter
+
+        self.register_type(event_type, emitter, event_kind)
+
+        if hasattr(emitter, "handle"):
+            emitter_path = emitter.handle.path
+        else:
+            raise RuntimeError(
+                'event emitter {} must have a "handle" attribute'.format(type(emitter).__name__))
+
+        # Validate that the method has an acceptable call signature.
+        sig = inspect.signature(observer)
+        # Self isn't included in the params list, so the first arg will be the event.
+        extra_params = list(sig.parameters.values())[1:]
+
+        method_name = observer.__name__
+        observer = observer.__self__
+        if not sig.parameters:
+            raise TypeError(
+                '{}.{} must accept event parameter'.format(type(observer).__name__, method_name))
+        elif any(param.default is inspect.Parameter.empty for param in extra_params):
+            # Allow for additional optional params, since there's no reason to exclude them, but
+            # required params will break.
+            raise TypeError(
+                '{}.{} has extra required parameter'.format(type(observer).__name__, method_name))
+
+        # TODO Prevent the exact same parameters from being registered more than once.
+
+        self._observer[observer.handle.path] = observer
+        self._observers.append((observer.handle.path, method_name, emitter_path, event_kind))
+
+    def _next_event_key(self):
+        """Return the next event key that should be used, incrementing the internal counter."""
+        # Increment the count first; this means the keys will start at 1, and 0
+        # means no events have been emitted.
+        self._stored['event_count'] += 1
+        return str(self._stored['event_count'])
+
+    def _emit(self, event):
+        """See BoundEvent.emit for the public way to call this."""
+        saved = False
+        event_path = event.handle.path
+        event_kind = event.handle.kind
+        parent_path = event.handle.parent.path
+        # TODO Track observers by (parent_path, event_kind) rather than as a list of
+        # all observers. Avoiding linear search through all observers for every event
+        for observer_path, method_name, _parent_path, _event_kind in self._observers:
+            if _parent_path != parent_path:
+                continue
+            if _event_kind and _event_kind != event_kind:
+                continue
+            if not saved:
+                # Save the event for all known observers before the first notification
+                # takes place, so that either everyone interested sees it, or nobody does.
+                self.save_snapshot(event)
+                saved = True
+            # Again, only commit this after all notices are saved.
+            self._storage.save_notice(event_path, observer_path, method_name)
+        if saved:
+            self._reemit(event_path)
+
+    def reemit(self):
+        """Reemit previously deferred events to the observers that deferred them.
+
+        Only the specific observers that have previously deferred the event will be
+        notified again. Observers that asked to be notified about events after it's
+        been first emitted won't be notified, as that would mean potentially observing
+        events out of order.
+        """
+        self._reemit()
+
+    def _reemit(self, single_event_path=None):
+        last_event_path = None
+        deferred = True
+        for event_path, observer_path, method_name in self._storage.notices(single_event_path):
+            event_handle = Handle.from_path(event_path)
+
+            if last_event_path != event_path:
+                if not deferred and last_event_path is not None:
+                    self._storage.drop_snapshot(last_event_path)
+                last_event_path = event_path
+                deferred = False
+
+            try:
+                event = self.load_snapshot(event_handle)
+            except NoTypeError:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+                continue
+
+            event.deferred = False
+            observer = self._observer.get(observer_path)
+            if observer:
+                if single_event_path is None:
+                    logger.debug("Re-emitting %s.", event)
+                custom_handler = getattr(observer, method_name, None)
+                if custom_handler:
+                    event_is_from_juju = isinstance(event, charm.HookEvent)
+                    event_is_action = isinstance(event, charm.ActionEvent)
+                    if (event_is_from_juju or event_is_action) and 'hook' in self._juju_debug_at:
+                        # Present the welcome message and run under PDB.
+                        self._show_debug_code_message()
+                        pdb.runcall(custom_handler, event)
+                    else:
+                        # Regular call to the registered method.
+                        custom_handler(event)
+
+            if event.deferred:
+                deferred = True
+            else:
+                self._storage.drop_notice(event_path, observer_path, method_name)
+            # We intentionally consider this event to be dead and reload it from
+            # scratch in the next path.
+            self.framework._forget(event)
+
+        if not deferred and last_event_path is not None:
+            self._storage.drop_snapshot(last_event_path)
+
+    def _show_debug_code_message(self):
+        """Present the welcome message (only once!) when using debugger functionality."""
+        if not self._breakpoint_welcomed:
+            self._breakpoint_welcomed = True
+            print(_BREAKPOINT_WELCOME_MESSAGE, file=sys.stderr, end='')
+
+    def breakpoint(self, name=None):
+        """Add breakpoint, optionally named, at the place where this method is called.
+
+        For the breakpoint to be activated the JUJU_DEBUG_AT environment variable
+        must be set to "all" or to the specific name parameter provided, if any. In every
+        other situation calling this method does nothing.
+
+        The framework also provides a standard breakpoint named "hook", that will
+        stop execution when a hook event is about to be handled.
+
+        For those reasons, the "all" and "hook" breakpoint names are reserved.
+        """
+        # If given, validate the name comply with all the rules
+        if name is not None:
+            if not isinstance(name, str):
+                raise TypeError('breakpoint names must be strings')
+            if name in ('hook', 'all'):
+                raise ValueError('breakpoint names "all" and "hook" are reserved')
+            if not re.match(r'^[a-z0-9]([a-z0-9\-]*[a-z0-9])?$', name):
+                raise ValueError('breakpoint names must look like "foo" or "foo-bar"')
+
+        indicated_breakpoints = self._juju_debug_at
+        if not indicated_breakpoints:
+            return
+
+        if 'all' in indicated_breakpoints or name in indicated_breakpoints:
+            self._show_debug_code_message()
+
+            # If we call set_trace() directly it will open the debugger *here*, so indicating
+            # it to use our caller's frame
+            code_frame = inspect.currentframe().f_back
+            pdb.Pdb().set_trace(code_frame)
+        else:
+            logger.warning(
+                "Breakpoint %r skipped (not found in the requested breakpoints: %s)",
+                name, indicated_breakpoints)
+
+    def remove_unreferenced_events(self):
+        """Remove events from storage that are not referenced.
+
+        In older versions of the framework, events that had no observers would get recorded but
+        never deleted. This makes a best effort to find these events and remove them from the
+        database.
+        """
+        event_regex = re.compile(_event_regex)
+        to_remove = []
+        for handle_path in self._storage.list_snapshots():
+            if event_regex.match(handle_path):
+                notices = self._storage.notices(handle_path)
+                if next(notices, None) is None:
+                    # There are no notices for this handle_path, it is valid to remove it
+                    to_remove.append(handle_path)
+        for handle_path in to_remove:
+            self._storage.drop_snapshot(handle_path)
+
+
+class StoredStateData(Object):
+    """Manager of the stored data."""
+
+    def __init__(self, parent, attr_name):
+        super().__init__(parent, attr_name)
+        self._cache = {}
+        self.dirty = False
+
+    def __getitem__(self, key):
+        return self._cache.get(key)
+
+    def __setitem__(self, key, value):
+        self._cache[key] = value
+        self.dirty = True
+
+    def __contains__(self, key):
+        return key in self._cache
+
+    def snapshot(self):
+        """Return the current state."""
+        return self._cache
+
+    def restore(self, snapshot):
+        """Restore current state to the given snapshot."""
+        self._cache = snapshot
+        self.dirty = False
+
+    def on_commit(self, event):
+        """Save changes to the storage backend."""
+        if self.dirty:
+            self.framework.save_snapshot(self)
+            self.dirty = False
+
+
+class BoundStoredState:
+    """Stored state data bound to a specific Object."""
+
+    def __init__(self, parent, attr_name):
+        parent.framework.register_type(StoredStateData, parent)
+
+        handle = Handle(parent, StoredStateData.handle_kind, attr_name)
+        try:
+            data = parent.framework.load_snapshot(handle)
+        except NoSnapshotError:
+            data = StoredStateData(parent, attr_name)
+
+        # __dict__ is used to avoid infinite recursion.
+        self.__dict__["_data"] = data
+        self.__dict__["_attr_name"] = attr_name
+
+        parent.framework.observe(parent.framework.on.commit, self._data.on_commit)
+
+    def __getattr__(self, key):
+        # "on" is the only reserved key that can't be used in the data map.
+        if key == "on":
+            return self._data.on
+        if key not in self._data:
+            raise AttributeError("attribute '{}' is not stored".format(key))
+        return _wrap_stored(self._data, self._data[key])
+
+    def __setattr__(self, key, value):
+        if key == "on":
+            raise AttributeError("attribute 'on' is reserved and cannot be set")
+
+        value = _unwrap_stored(self._data, value)
+
+        if not isinstance(value, (type(None), int, float, str, bytes, list, dict, set)):
+            raise AttributeError(
+                'attribute {!r} cannot be a {}: must be int/float/dict/list/etc'.format(
+                    key, type(value).__name__))
+
+        self._data[key] = _unwrap_stored(self._data, value)
+
+    def set_default(self, **kwargs):
+        """Set the value of any given key if it has not already been set."""
+        for k, v in kwargs.items():
+            if k not in self._data:
+                self._data[k] = v
+
+
+class StoredState:
+    """A class used to store data the charm needs persisted across invocations.
+
+    Example::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+    Instances of `MyClass` can transparently save state between invocations by
+    setting attributes on `_stored`. Initial state should be set with
+    `set_default` on the bound object, that is::
+
+        class MyClass(Object):
+            _stored = StoredState()
+
+        def __init__(self, parent, key):
+            super().__init__(parent, key)
+            self._stored.set_default(seen=set())
+            self.framework.observe(self.on.seen, self._on_seen)
+
+        def _on_seen(self, event):
+            self._stored.seen.add(event.uuid)
+
+    """
+
+    def __init__(self):
+        self.parent_type = None
+        self.attr_name = None
+
+    def __get__(self, parent, parent_type=None):
+        if self.parent_type is not None and self.parent_type not in parent_type.mro():
+            # the StoredState instance is being shared between two unrelated classes
+            # -> unclear what is exepcted of us -> bail out
+            raise RuntimeError(
+                'StoredState shared by {} and {}'.format(
+                    self.parent_type.__name__, parent_type.__name__))
+
+        if parent is None:
+            # accessing via the class directly (e.g. MyClass.stored)
+            return self
+
+        bound = None
+        if self.attr_name is not None:
+            bound = parent.__dict__.get(self.attr_name)
+            if bound is not None:
+                # we already have the thing from a previous pass, huzzah
+                return bound
+
+        # need to find ourselves amongst the parent's bases
+        for cls in parent_type.mro():
+            for attr_name, attr_value in cls.__dict__.items():
+                if attr_value is not self:
+                    continue
+                # we've found ourselves! is it the first time?
+                if bound is not None:
+                    # the StoredState instance is being stored in two different
+                    # attributes -> unclear what is expected of us -> bail out
+                    raise RuntimeError("StoredState shared by {0}.{1} and {0}.{2}".format(
+                        cls.__name__, self.attr_name, attr_name))
+                # we've found ourselves for the first time; save where, and bind the object
+                self.attr_name = attr_name
+                self.parent_type = cls
+                bound = BoundStoredState(parent, attr_name)
+
+        if bound is not None:
+            # cache the bound object to avoid the expensive lookup the next time
+            # (don't use setattr, to keep things symmetric with the fast-path lookup above)
+            parent.__dict__[self.attr_name] = bound
+            return bound
+
+        raise AttributeError(
+            'cannot find {} attribute in type {}'.format(
+                self.__class__.__name__, parent_type.__name__))
+
+
+def _wrap_stored(parent_data, value):
+    t = type(value)
+    if t is dict:
+        return StoredDict(parent_data, value)
+    if t is list:
+        return StoredList(parent_data, value)
+    if t is set:
+        return StoredSet(parent_data, value)
+    return value
+
+
+def _unwrap_stored(parent_data, value):
+    t = type(value)
+    if t is StoredDict or t is StoredList or t is StoredSet:
+        return value._under
+    return value
+
+
+def _wrapped_repr(obj):
+    t = type(obj)
+    if obj._under:
+        return "{}.{}({!r})".format(t.__module__, t.__name__, obj._under)
+    else:
+        return "{}.{}()".format(t.__module__, t.__name__)
+
+
+class StoredDict(collections.abc.MutableMapping):
+    """A dict-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, key):
+        return _wrap_stored(self._stored_data, self._under[key])
+
+    def __setitem__(self, key, value):
+        self._under[key] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, key):
+        del self._under[key]
+        self._stored_data.dirty = True
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    def __eq__(self, other):
+        if isinstance(other, StoredDict):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Mapping):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
+
+
+class StoredList(collections.abc.MutableSequence):
+    """A list-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def __getitem__(self, index):
+        return _wrap_stored(self._stored_data, self._under[index])
+
+    def __setitem__(self, index, value):
+        self._under[index] = _unwrap_stored(self._stored_data, value)
+        self._stored_data.dirty = True
+
+    def __delitem__(self, index):
+        del self._under[index]
+        self._stored_data.dirty = True
+
+    def __len__(self):
+        return len(self._under)
+
+    def insert(self, index, value):
+        """Insert value before index."""
+        self._under.insert(index, value)
+        self._stored_data.dirty = True
+
+    def append(self, value):
+        """Append value to the end of the list."""
+        self._under.append(value)
+        self._stored_data.dirty = True
+
+    def __eq__(self, other):
+        if isinstance(other, StoredList):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    def __lt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under < other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under < other
+        else:
+            return NotImplemented
+
+    def __le__(self, other):
+        if isinstance(other, StoredList):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __gt__(self, other):
+        if isinstance(other, StoredList):
+            return self._under > other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under > other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredList):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Sequence):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
+
+
+class StoredSet(collections.abc.MutableSet):
+    """A set-like object that uses the StoredState as backend."""
+
+    def __init__(self, stored_data, under):
+        self._stored_data = stored_data
+        self._under = under
+
+    def add(self, key):
+        """Add a key to a set.
+
+        This has no effect if the key is already present.
+        """
+        self._under.add(key)
+        self._stored_data.dirty = True
+
+    def discard(self, key):
+        """Remove a key from a set if it is a member.
+
+        If the key is not a member, do nothing.
+        """
+        self._under.discard(key)
+        self._stored_data.dirty = True
+
+    def __contains__(self, key):
+        return key in self._under
+
+    def __iter__(self):
+        return self._under.__iter__()
+
+    def __len__(self):
+        return len(self._under)
+
+    @classmethod
+    def _from_iterable(cls, it):
+        """Construct an instance of the class from any iterable input.
+
+        Per https://docs.python.org/3/library/collections.abc.html
+        if the Set mixin is being used in a class with a different constructor signature,
+        you will need to override _from_iterable() with a classmethod that can construct
+        new instances from an iterable argument.
+        """
+        return set(it)
+
+    def __le__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under <= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under <= other
+        else:
+            return NotImplemented
+
+    def __ge__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under >= other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under >= other
+        else:
+            return NotImplemented
+
+    def __eq__(self, other):
+        if isinstance(other, StoredSet):
+            return self._under == other._under
+        elif isinstance(other, collections.abc.Set):
+            return self._under == other
+        else:
+            return NotImplemented
+
+    __repr__ = _wrapped_repr
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/jujuversion.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/jujuversion.py
new file mode 100644
index 0000000000000000000000000000000000000000..61d420d369d9b0e75b9c2c242574ddcd4b89be51
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/jujuversion.py
@@ -0,0 +1,114 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A helper to work with the Juju version."""
+
+import os
+import re
+from functools import total_ordering
+
+
+@total_ordering
+class JujuVersion:
+    """Helper to work with the Juju version.
+
+    It knows how to parse the ``JUJU_VERSION`` environment variable, and exposes different
+    capabilities according to the specific version, allowing also to compare with other
+    versions.
+    """
+
+    PATTERN = r'''^
+    (?P<major>\d{1,9})\.(?P<minor>\d{1,9})       # <major> and <minor> numbers are always there
+    ((?:\.|-(?P<tag>[a-z]+))(?P<patch>\d{1,9}))? # sometimes with .<patch> or -<tag><patch>
+    (\.(?P<build>\d{1,9}))?$                     # and sometimes with a <build> number.
+    '''
+
+    def __init__(self, version):
+        m = re.match(self.PATTERN, version, re.VERBOSE)
+        if not m:
+            raise RuntimeError('"{}" is not a valid Juju version string'.format(version))
+
+        d = m.groupdict()
+        self.major = int(m.group('major'))
+        self.minor = int(m.group('minor'))
+        self.tag = d['tag'] or ''
+        self.patch = int(d['patch'] or 0)
+        self.build = int(d['build'] or 0)
+
+    def __repr__(self):
+        if self.tag:
+            s = '{}.{}-{}{}'.format(self.major, self.minor, self.tag, self.patch)
+        else:
+            s = '{}.{}.{}'.format(self.major, self.minor, self.patch)
+        if self.build > 0:
+            s += '.{}'.format(self.build)
+        return s
+
+    def __eq__(self, other):
+        if self is other:
+            return True
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+        return (
+            self.major == other.major
+            and self.minor == other.minor
+            and self.tag == other.tag
+            and self.build == other.build
+            and self.patch == other.patch)
+
+    def __lt__(self, other):
+        if self is other:
+            return False
+        if isinstance(other, str):
+            other = type(self)(other)
+        elif not isinstance(other, JujuVersion):
+            raise RuntimeError('cannot compare Juju version "{}" with "{}"'.format(self, other))
+
+        if self.major != other.major:
+            return self.major < other.major
+        elif self.minor != other.minor:
+            return self.minor < other.minor
+        elif self.tag != other.tag:
+            if not self.tag:
+                return False
+            elif not other.tag:
+                return True
+            return self.tag < other.tag
+        elif self.patch != other.patch:
+            return self.patch < other.patch
+        elif self.build != other.build:
+            return self.build < other.build
+        return False
+
+    @classmethod
+    def from_environ(cls) -> 'JujuVersion':
+        """Build a JujuVersion from JUJU_VERSION."""
+        v = os.environ.get('JUJU_VERSION')
+        if v is None:
+            v = '0.0.0'
+        return cls(v)
+
+    def has_app_data(self) -> bool:
+        """Determine whether this juju version knows about app data."""
+        return (self.major, self.minor, self.patch) >= (2, 7, 0)
+
+    def is_dispatch_aware(self) -> bool:
+        """Determine whether this juju version knows about dispatch."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
+
+    def has_controller_storage(self) -> bool:
+        """Determine whether this juju version supports controller-side storage."""
+        return (self.major, self.minor, self.patch) >= (2, 8, 0)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/lib/__init__.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/lib/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..22b5a84e517df8a061b7ca2742678536a481b616
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/lib/__init__.py
@@ -0,0 +1,264 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure for the opslib functionality."""
+
+import logging
+import os
+import re
+import sys
+
+from ast import literal_eval
+from importlib.util import module_from_spec
+from importlib.machinery import ModuleSpec
+from pkgutil import get_importer
+from types import ModuleType
+from typing import List
+
+__all__ = ('use', 'autoimport')
+
+logger = logging.getLogger(__name__)
+
+_libraries = None
+
+_libline_re = re.compile(r'''^LIB([A-Z]+)\s*=\s*([0-9]+|['"][a-zA-Z0-9_.\-@]+['"])''')
+_libname_re = re.compile(r'''^[a-z][a-z0-9]+$''')
+
+# Not perfect, but should do for now.
+_libauthor_re = re.compile(r'''^[A-Za-z0-9_+.-]+@[a-z0-9_-]+(?:\.[a-z0-9_-]+)*\.[a-z]{2,3}$''')
+
+
+def use(name: str, api: int, author: str) -> ModuleType:
+    """Use a library from the ops libraries.
+
+    Args:
+        name: the name of the library requested.
+        api: the API version of the library.
+        author: the author of the library. If not given, requests the
+            one in the standard library.
+
+    Raises:
+        ImportError: if the library cannot be found.
+        TypeError: if the name, api, or author are the wrong type.
+        ValueError: if the name, api, or author are invalid.
+    """
+    if not isinstance(name, str):
+        raise TypeError("invalid library name: {!r} (must be a str)".format(name))
+    if not isinstance(author, str):
+        raise TypeError("invalid library author: {!r} (must be a str)".format(author))
+    if not isinstance(api, int):
+        raise TypeError("invalid library API: {!r} (must be an int)".format(api))
+    if api < 0:
+        raise ValueError('invalid library api: {} (must be ≥0)'.format(api))
+    if not _libname_re.match(name):
+        raise ValueError("invalid library name: {!r} (chars and digits only)".format(name))
+    if not _libauthor_re.match(author):
+        raise ValueError("invalid library author email: {!r}".format(author))
+
+    if _libraries is None:
+        autoimport()
+
+    versions = _libraries.get((name, author), ())
+    for lib in versions:
+        if lib.api == api:
+            return lib.import_module()
+
+    others = ', '.join(str(lib.api) for lib in versions)
+    if others:
+        msg = 'cannot find "{}" from "{}" with API version {} (have {})'.format(
+            name, author, api, others)
+    else:
+        msg = 'cannot find library "{}" from "{}"'.format(name, author)
+
+    raise ImportError(msg, name=name)
+
+
+def autoimport():
+    """Find all libs in the path and enable use of them.
+
+    You only need to call this if you've installed a package or
+    otherwise changed sys.path in the current run, and need to see the
+    changes. Otherwise libraries are found on first call of `use`.
+    """
+    global _libraries
+    _libraries = {}
+    for spec in _find_all_specs(sys.path):
+        lib = _parse_lib(spec)
+        if lib is None:
+            continue
+
+        versions = _libraries.setdefault((lib.name, lib.author), [])
+        versions.append(lib)
+        versions.sort(reverse=True)
+
+
+def _find_all_specs(path):
+    for sys_dir in path:
+        if sys_dir == "":
+            sys_dir = "."
+        try:
+            top_dirs = os.listdir(sys_dir)
+        except (FileNotFoundError, NotADirectoryError):
+            continue
+        except OSError as e:
+            logger.debug("Tried to look for ops.lib packages under '%s': %s", sys_dir, e)
+            continue
+        logger.debug("Looking for ops.lib packages under '%s'", sys_dir)
+        for top_dir in top_dirs:
+            opslib = os.path.join(sys_dir, top_dir, 'opslib')
+            try:
+                lib_dirs = os.listdir(opslib)
+            except (FileNotFoundError, NotADirectoryError):
+                continue
+            except OSError as e:
+                logger.debug("  Tried '%s': %s", opslib, e)  # *lots* of things checked here
+                continue
+            else:
+                logger.debug("  Trying '%s'", opslib)
+            finder = get_importer(opslib)
+            if finder is None:
+                logger.debug("  Finder for '%s' is None", opslib)
+                continue
+            if not hasattr(finder, 'find_spec'):
+                logger.debug("  Finder for '%s' has no find_spec", opslib)
+                continue
+            for lib_dir in lib_dirs:
+                spec_name = "{}.opslib.{}".format(top_dir, lib_dir)
+                spec = finder.find_spec(spec_name)
+                if spec is None:
+                    logger.debug("    No spec for %r", spec_name)
+                    continue
+                if spec.loader is None:
+                    # a namespace package; not supported
+                    logger.debug("    No loader for %r (probably a namespace package)", spec_name)
+                    continue
+
+                logger.debug("    Found %r", spec_name)
+                yield spec
+
+
+# only the first this many lines of a file are looked at for the LIB* constants
+_MAX_LIB_LINES = 99
+# these keys, with these types, are needed to have an opslib
+_NEEDED_KEYS = {'NAME': str, 'AUTHOR': str, 'API': int, 'PATCH': int}
+
+
+def _join_and(keys: List[str]) -> str:
+    if len(keys) == 0:
+        return ""
+    if len(keys) == 1:
+        return keys[0]
+    return ", ".join(keys[:-1]) + ", and " + keys[-1]
+
+
+class _Missing:
+    """Helper to get the difference between what was found and what was needed when logging."""
+
+    def __init__(self, found):
+        self._found = found
+
+    def __str__(self):
+        exp = set(_NEEDED_KEYS)
+        got = set(self._found)
+        if len(got) == 0:
+            return "missing {}".format(_join_and(sorted(exp)))
+        return "got {}, but missing {}".format(
+            _join_and(sorted(got)),
+            _join_and(sorted(exp - got)))
+
+
+def _parse_lib(spec):
+    if spec.origin is None:
+        # "can't happen"
+        logger.warning("No origin for %r (no idea why; please report)", spec.name)
+        return None
+
+    logger.debug("    Parsing %r", spec.name)
+
+    try:
+        with open(spec.origin, 'rt', encoding='utf-8') as f:
+            libinfo = {}
+            for n, line in enumerate(f):
+                if len(libinfo) == len(_NEEDED_KEYS):
+                    break
+                if n > _MAX_LIB_LINES:
+                    logger.debug(
+                        "      Missing opslib metadata after reading to line %d: %s",
+                        _MAX_LIB_LINES, _Missing(libinfo))
+                    return None
+                m = _libline_re.match(line)
+                if m is None:
+                    continue
+                key, value = m.groups()
+                if key in _NEEDED_KEYS:
+                    value = literal_eval(value)
+                    if not isinstance(value, _NEEDED_KEYS[key]):
+                        logger.debug(
+                            "      Bad type for %s: expected %s, got %s",
+                            key, _NEEDED_KEYS[key].__name__, type(value).__name__)
+                        return None
+                    libinfo[key] = value
+            else:
+                if len(libinfo) != len(_NEEDED_KEYS):
+                    logger.debug(
+                        "      Missing opslib metadata after reading to end of file: %s",
+                        _Missing(libinfo))
+                    return None
+    except Exception as e:
+        logger.debug("      Failed: %s", e)
+        return None
+
+    lib = _Lib(spec, libinfo['NAME'], libinfo['AUTHOR'], libinfo['API'], libinfo['PATCH'])
+    logger.debug("    Success: found library %s", lib)
+
+    return lib
+
+
+class _Lib:
+
+    def __init__(self, spec: ModuleSpec, name: str, author: str, api: int, patch: int):
+        self.spec = spec
+        self.name = name
+        self.author = author
+        self.api = api
+        self.patch = patch
+
+        self._module = None
+
+    def __repr__(self):
+        return "<_Lib {}>".format(self)
+
+    def __str__(self):
+        return "{0.name} by {0.author}, API {0.api}, patch {0.patch}".format(self)
+
+    def import_module(self) -> ModuleType:
+        if self._module is None:
+            module = module_from_spec(self.spec)
+            self.spec.loader.exec_module(module)
+            self._module = module
+        return self._module
+
+    def __eq__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a == b
+
+    def __lt__(self, other):
+        if not isinstance(other, _Lib):
+            return NotImplemented
+        a = (self.name, self.author, self.api, self.patch)
+        b = (other.name, other.author, other.api, other.patch)
+        return a < b
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/log.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/log.py
new file mode 100644
index 0000000000000000000000000000000000000000..b47013dd597c5500ea763d9e4beada10e6f2ca87
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/log.py
@@ -0,0 +1,58 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Interface to emit messages to the Juju logging system."""
+
+import sys
+import logging
+
+
+class JujuLogHandler(logging.Handler):
+    """A handler for sending logs to Juju via juju-log."""
+
+    def __init__(self, model_backend, level=logging.DEBUG):
+        super().__init__(level)
+        self.model_backend = model_backend
+
+    def emit(self, record):
+        """Send the specified logging record to the Juju backend.
+
+        This method is not used directly by the Operator Framework code, but by
+        :class:`logging.Handler` itself as part of the logging machinery.
+        """
+        self.model_backend.juju_log(record.levelname, self.format(record))
+
+
+def setup_root_logging(model_backend, debug=False):
+    """Setup python logging to forward messages to juju-log.
+
+    By default, logging is set to DEBUG level, and messages will be filtered by Juju.
+    Charmers can also set their own default log level with::
+
+      logging.getLogger().setLevel(logging.INFO)
+
+    model_backend -- a ModelBackend to use for juju-log
+    debug -- if True, write logs to stderr as well as to juju-log.
+    """
+    logger = logging.getLogger()
+    logger.setLevel(logging.DEBUG)
+    logger.addHandler(JujuLogHandler(model_backend))
+    if debug:
+        handler = logging.StreamHandler()
+        formatter = logging.Formatter('%(asctime)s %(levelname)-8s %(message)s')
+        handler.setFormatter(formatter)
+        logger.addHandler(handler)
+
+    sys.excepthook = lambda etype, value, tb: logger.error(
+        "Uncaught exception while in charm code:", exc_info=(etype, value, tb))
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/main.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/main.py
new file mode 100644
index 0000000000000000000000000000000000000000..f18f88ae0eff807e065e5df778a16cd83ca560eb
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/main.py
@@ -0,0 +1,406 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Main entry point to the Operator Framework."""
+
+import inspect
+import logging
+import os
+import shutil
+import subprocess
+import sys
+import typing
+import warnings
+from pathlib import Path
+
+import yaml
+
+import ops.charm
+import ops.framework
+import ops.model
+import ops.storage
+
+from ops.log import setup_root_logging
+from ops.jujuversion import JujuVersion
+
+CHARM_STATE_FILE = '.unit-state.db'
+
+
+logger = logging.getLogger()
+
+
+def _exe_path(path: Path) -> typing.Optional[Path]:
+    """Find and return the full path to the given binary.
+
+    Here path is the absolute path to a binary, but might be missing an extension.
+    """
+    p = shutil.which(path.name, mode=os.F_OK, path=str(path.parent))
+    if p is None:
+        return None
+    return Path(p)
+
+
+def _get_charm_dir():
+    charm_dir = os.environ.get("JUJU_CHARM_DIR")
+    if charm_dir is None:
+        # Assume $JUJU_CHARM_DIR/lib/op/main.py structure.
+        charm_dir = Path('{}/../../..'.format(__file__)).resolve()
+    else:
+        charm_dir = Path(charm_dir).resolve()
+    return charm_dir
+
+
+def _create_event_link(charm, bound_event, link_to):
+    """Create a symlink for a particular event.
+
+    charm -- A charm object.
+    bound_event -- An event for which to create a symlink.
+    link_to -- What the event link should point to
+    """
+    if issubclass(bound_event.event_type, ops.charm.HookEvent):
+        event_dir = charm.framework.charm_dir / 'hooks'
+        event_path = event_dir / bound_event.event_kind.replace('_', '-')
+    elif issubclass(bound_event.event_type, ops.charm.ActionEvent):
+        if not bound_event.event_kind.endswith("_action"):
+            raise RuntimeError(
+                'action event name {} needs _action suffix'.format(bound_event.event_kind))
+        event_dir = charm.framework.charm_dir / 'actions'
+        # The event_kind is suffixed with "_action" while the executable is not.
+        event_path = event_dir / bound_event.event_kind[:-len('_action')].replace('_', '-')
+    else:
+        raise RuntimeError(
+            'cannot create a symlink: unsupported event type {}'.format(bound_event.event_type))
+
+    event_dir.mkdir(exist_ok=True)
+    if not event_path.exists():
+        target_path = os.path.relpath(link_to, str(event_dir))
+
+        # Ignore the non-symlink files or directories
+        # assuming the charm author knows what they are doing.
+        logger.debug(
+            'Creating a new relative symlink at %s pointing to %s',
+            event_path, target_path)
+        event_path.symlink_to(target_path)
+
+
+def _setup_event_links(charm_dir, charm):
+    """Set up links for supported events that originate from Juju.
+
+    Whether a charm can handle an event or not can be determined by
+    introspecting which events are defined on it.
+
+    Hooks or actions are created as symlinks to the charm code file
+    which is determined by inspecting symlinks provided by the charm
+    author at hooks/install or hooks/start.
+
+    charm_dir -- A root directory of the charm.
+    charm -- An instance of the Charm class.
+
+    """
+    # XXX: on windows this function does not accomplish what it wants to:
+    #      it creates symlinks with no extension pointing to a .py
+    #      and juju only knows how to handle .exe, .bat, .cmd, and .ps1
+    #      so it does its job, but does not accomplish anything as the
+    #      hooks aren't 'callable'.
+    link_to = os.path.realpath(os.environ.get("JUJU_DISPATCH_PATH", sys.argv[0]))
+    for bound_event in charm.on.events().values():
+        # Only events that originate from Juju need symlinks.
+        if issubclass(bound_event.event_type, (ops.charm.HookEvent, ops.charm.ActionEvent)):
+            _create_event_link(charm, bound_event, link_to)
+
+
+def _emit_charm_event(charm, event_name):
+    """Emits a charm event based on a Juju event name.
+
+    charm -- A charm instance to emit an event from.
+    event_name -- A Juju event name to emit on a charm.
+    """
+    event_to_emit = None
+    try:
+        event_to_emit = getattr(charm.on, event_name)
+    except AttributeError:
+        logger.debug("Event %s not defined for %s.", event_name, charm)
+
+    # If the event is not supported by the charm implementation, do
+    # not error out or try to emit it. This is to support rollbacks.
+    if event_to_emit is not None:
+        args, kwargs = _get_event_args(charm, event_to_emit)
+        logger.debug('Emitting Juju event %s.', event_name)
+        event_to_emit.emit(*args, **kwargs)
+
+
+def _get_event_args(charm, bound_event):
+    event_type = bound_event.event_type
+    model = charm.framework.model
+
+    if issubclass(event_type, ops.charm.RelationEvent):
+        relation_name = os.environ['JUJU_RELATION']
+        relation_id = int(os.environ['JUJU_RELATION_ID'].split(':')[-1])
+        relation = model.get_relation(relation_name, relation_id)
+    else:
+        relation = None
+
+    remote_app_name = os.environ.get('JUJU_REMOTE_APP', '')
+    remote_unit_name = os.environ.get('JUJU_REMOTE_UNIT', '')
+    if remote_app_name or remote_unit_name:
+        if not remote_app_name:
+            if '/' not in remote_unit_name:
+                raise RuntimeError('invalid remote unit name: {}'.format(remote_unit_name))
+            remote_app_name = remote_unit_name.split('/')[0]
+        args = [relation, model.get_app(remote_app_name)]
+        if remote_unit_name:
+            args.append(model.get_unit(remote_unit_name))
+        return args, {}
+    elif relation:
+        return [relation], {}
+    return [], {}
+
+
+class _Dispatcher:
+    """Encapsulate how to figure out what event Juju wants us to run.
+
+    Also knows how to run “legacy” hooks when Juju called us via a top-level
+    ``dispatch`` binary.
+
+    Args:
+        charm_dir: the toplevel directory of the charm
+
+    Attributes:
+        event_name: the name of the event to run
+        is_dispatch_aware: are we running under a Juju that knows about the
+            dispatch binary, and is that binary present?
+
+    """
+
+    def __init__(self, charm_dir: Path):
+        self._charm_dir = charm_dir
+        self._exec_path = Path(os.environ.get('JUJU_DISPATCH_PATH', sys.argv[0]))
+
+        dispatch = charm_dir / 'dispatch'
+        if JujuVersion.from_environ().is_dispatch_aware() and _exe_path(dispatch) is not None:
+            self._init_dispatch()
+        else:
+            self._init_legacy()
+
+    def ensure_event_links(self, charm):
+        """Make sure necessary symlinks are present on disk."""
+        if self.is_dispatch_aware:
+            # links aren't needed
+            return
+
+        # When a charm is force-upgraded and a unit is in an error state Juju
+        # does not run upgrade-charm and instead runs the failed hook followed
+        # by config-changed. Given the nature of force-upgrading the hook setup
+        # code is not triggered on config-changed.
+        #
+        # 'start' event is included as Juju does not fire the install event for
+        # K8s charms (see LP: #1854635).
+        if (self.event_name in ('install', 'start', 'upgrade_charm')
+                or self.event_name.endswith('_storage_attached')):
+            _setup_event_links(self._charm_dir, charm)
+
+    def run_any_legacy_hook(self):
+        """Run any extant legacy hook.
+
+        If there is both a dispatch file and a legacy hook for the
+        current event, run the wanted legacy hook.
+        """
+        if not self.is_dispatch_aware:
+            # we *are* the legacy hook
+            return
+
+        dispatch_path = _exe_path(self._charm_dir / self._dispatch_path)
+        if dispatch_path is None:
+            logger.debug("Legacy %s does not exist.", self._dispatch_path)
+            return
+
+        # super strange that there isn't an is_executable
+        if not os.access(str(dispatch_path), os.X_OK):
+            logger.warning("Legacy %s exists but is not executable.", self._dispatch_path)
+            return
+
+        if dispatch_path.resolve() == Path(sys.argv[0]).resolve():
+            logger.debug("Legacy %s is just a link to ourselves.", self._dispatch_path)
+            return
+
+        argv = sys.argv.copy()
+        argv[0] = str(dispatch_path)
+        logger.info("Running legacy %s.", self._dispatch_path)
+        try:
+            subprocess.run(argv, check=True)
+        except subprocess.CalledProcessError as e:
+            logger.warning("Legacy %s exited with status %d.", self._dispatch_path, e.returncode)
+            sys.exit(e.returncode)
+        except OSError as e:
+            logger.warning("Unable to run legacy %s: %s", self._dispatch_path, e)
+            sys.exit(1)
+        else:
+            logger.debug("Legacy %s exited with status 0.", self._dispatch_path)
+
+    def _set_name_from_path(self, path: Path):
+        """Sets the name attribute to that which can be inferred from the given path."""
+        name = path.name.replace('-', '_')
+        if path.parent.name == 'actions':
+            name = '{}_action'.format(name)
+        self.event_name = name
+
+    def _init_legacy(self):
+        """Set up the 'legacy' dispatcher.
+
+        The current Juju doesn't know about 'dispatch' and calls hooks
+        explicitly.
+        """
+        self.is_dispatch_aware = False
+        self._set_name_from_path(self._exec_path)
+
+    def _init_dispatch(self):
+        """Set up the new 'dispatch' dispatcher.
+
+        The current Juju will run 'dispatch' if it exists, and otherwise fall
+        back to the old behaviour.
+
+        JUJU_DISPATCH_PATH will be set to the wanted hook, e.g. hooks/install,
+        in both cases.
+        """
+        self._dispatch_path = Path(os.environ['JUJU_DISPATCH_PATH'])
+
+        if 'OPERATOR_DISPATCH' in os.environ:
+            logger.debug("Charm called itself via %s.", self._dispatch_path)
+            sys.exit(0)
+        os.environ['OPERATOR_DISPATCH'] = '1'
+
+        self.is_dispatch_aware = True
+        self._set_name_from_path(self._dispatch_path)
+
+    def is_restricted_context(self):
+        """Return True if we are running in a restricted Juju context.
+
+        When in a restricted context, most commands (relation-get, config-get,
+        state-get) are not available. As such, we change how we interact with
+        Juju.
+        """
+        return self.event_name in ('collect_metrics',)
+
+
+def _should_use_controller_storage(db_path: Path, meta: ops.charm.CharmMeta) -> bool:
+    """Figure out whether we want to use controller storage or not."""
+    # if you've previously used local state, carry on using that
+    if db_path.exists():
+        logger.debug("Using local storage: %s already exists", db_path)
+        return False
+
+    # if you're not in k8s you don't need controller storage
+    if 'kubernetes' not in meta.series:
+        logger.debug("Using local storage: not a kubernetes charm")
+        return False
+
+    # are we in a new enough Juju?
+    cur_version = JujuVersion.from_environ()
+
+    if cur_version.has_controller_storage():
+        logger.debug("Using controller storage: JUJU_VERSION=%s", cur_version)
+        return True
+    else:
+        logger.debug("Using local storage: JUJU_VERSION=%s", cur_version)
+        return False
+
+
+def main(charm_class: ops.charm.CharmBase, use_juju_for_storage: bool = None):
+    """Setup the charm and dispatch the observed event.
+
+    The event name is based on the way this executable was called (argv[0]).
+
+    Args:
+        charm_class: your charm class.
+        use_juju_for_storage: whether to use controller-side storage. If not specified
+            then kubernetes charms that haven't previously used local storage and that
+            are running on a new enough Juju default to controller-side storage,
+            otherwise local storage is used.
+    """
+    charm_dir = _get_charm_dir()
+
+    model_backend = ops.model._ModelBackend()
+    debug = ('JUJU_DEBUG' in os.environ)
+    setup_root_logging(model_backend, debug=debug)
+    logger.debug("Operator Framework %s up and running.", ops.__version__)
+
+    dispatcher = _Dispatcher(charm_dir)
+    dispatcher.run_any_legacy_hook()
+
+    metadata = (charm_dir / 'metadata.yaml').read_text()
+    actions_meta = charm_dir / 'actions.yaml'
+    if actions_meta.exists():
+        actions_metadata = actions_meta.read_text()
+    else:
+        actions_metadata = None
+
+    if not yaml.__with_libyaml__:
+        logger.debug('yaml does not have libyaml extensions, using slower pure Python yaml loader')
+    meta = ops.charm.CharmMeta.from_yaml(metadata, actions_metadata)
+    model = ops.model.Model(meta, model_backend)
+
+    charm_state_path = charm_dir / CHARM_STATE_FILE
+
+    if use_juju_for_storage and not ops.storage.juju_backend_available():
+        # raise an exception; the charm is broken and needs fixing.
+        msg = 'charm set use_juju_for_storage=True, but Juju version {} does not support it'
+        raise RuntimeError(msg.format(JujuVersion.from_environ()))
+
+    if use_juju_for_storage is None:
+        use_juju_for_storage = _should_use_controller_storage(charm_state_path, meta)
+
+    if use_juju_for_storage:
+        if dispatcher.is_restricted_context():
+            # TODO: jam 2020-06-30 This unconditionally avoids running a collect metrics event
+            #  Though we eventually expect that juju will run collect-metrics in a
+            #  non-restricted context. Once we can determine that we are running collect-metrics
+            #  in a non-restricted context, we should fire the event as normal.
+            logger.debug('"%s" is not supported when using Juju for storage\n'
+                         'see: https://github.com/canonical/operator/issues/348',
+                         dispatcher.event_name)
+            # Note that we don't exit nonzero, because that would cause Juju to rerun the hook
+            return
+        store = ops.storage.JujuStorage()
+    else:
+        store = ops.storage.SQLiteStorage(charm_state_path)
+    framework = ops.framework.Framework(store, charm_dir, meta, model)
+    framework.set_breakpointhook()
+    try:
+        sig = inspect.signature(charm_class)
+        try:
+            sig.bind(framework)
+        except TypeError:
+            msg = (
+                "the second argument, 'key', has been deprecated and will be "
+                "removed after the 0.7 release")
+            warnings.warn(msg, DeprecationWarning)
+            charm = charm_class(framework, None)
+        else:
+            charm = charm_class(framework)
+        dispatcher.ensure_event_links(charm)
+
+        # TODO: Remove the collect_metrics check below as soon as the relevant
+        #       Juju changes are made. Also adjust the docstring on
+        #       EventBase.defer().
+        #
+        # Skip reemission of deferred events for collect-metrics events because
+        # they do not have the full access to all hook tools.
+        if not dispatcher.is_restricted_context():
+            framework.reemit()
+
+        _emit_charm_event(charm, dispatcher.event_name)
+
+        framework.commit()
+    finally:
+        framework.close()
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/model.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/model.py
new file mode 100644
index 0000000000000000000000000000000000000000..d446d63647807db570192c690a6d245244b8f19d
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/model.py
@@ -0,0 +1,1314 @@
+# Copyright 2019 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Representations of Juju's model, application, unit, and other entities."""
+
+import datetime
+import decimal
+import ipaddress
+import json
+import os
+import re
+import shutil
+import tempfile
+import time
+import typing
+import weakref
+
+from abc import ABC, abstractmethod
+from collections.abc import Mapping, MutableMapping
+from pathlib import Path
+from subprocess import run, PIPE, CalledProcessError
+import yaml
+
+import ops
+from ops.jujuversion import JujuVersion
+
+
+if yaml.__with_libyaml__:
+    _DefaultDumper = yaml.CSafeDumper
+else:
+    _DefaultDumper = yaml.SafeDumper
+
+
+class Model:
+    """Represents the Juju Model as seen from this unit.
+
+    This should not be instantiated directly by Charmers, but can be accessed as `self.model`
+    from any class that derives from Object.
+    """
+
+    def __init__(self, meta: 'ops.charm.CharmMeta', backend: '_ModelBackend'):
+        self._cache = _ModelCache(backend)
+        self._backend = backend
+        self._unit = self.get_unit(self._backend.unit_name)
+        self._relations = RelationMapping(meta.relations, self.unit, self._backend, self._cache)
+        self._config = ConfigData(self._backend)
+        self._resources = Resources(list(meta.resources), self._backend)
+        self._pod = Pod(self._backend)
+        self._storages = StorageMapping(list(meta.storages), self._backend)
+        self._bindings = BindingMapping(self._backend)
+
+    @property
+    def unit(self) -> 'Unit':
+        """A :class:`Unit` that represents the unit that is running this code (eg yourself)."""
+        return self._unit
+
+    @property
+    def app(self):
+        """A :class:`Application` that represents the application this unit is a part of."""
+        return self._unit.app
+
+    @property
+    def relations(self) -> 'RelationMapping':
+        """Mapping of endpoint to list of :class:`Relation`.
+
+        Answers the question "what am I currently related to".
+        See also :meth:`.get_relation`.
+        """
+        return self._relations
+
+    @property
+    def config(self) -> 'ConfigData':
+        """Return a mapping of config for the current application."""
+        return self._config
+
+    @property
+    def resources(self) -> 'Resources':
+        """Access to resources for this charm.
+
+        Use ``model.resources.fetch(resource_name)`` to get the path on disk
+        where the resource can be found.
+        """
+        return self._resources
+
+    @property
+    def storages(self) -> 'StorageMapping':
+        """Mapping of storage_name to :class:`Storage` as defined in metadata.yaml."""
+        return self._storages
+
+    @property
+    def pod(self) -> 'Pod':
+        """Use ``model.pod.set_spec`` to set the container specification for Kubernetes charms."""
+        return self._pod
+
+    @property
+    def name(self) -> str:
+        """Return the name of the Model that this unit is running in.
+
+        This is read from the environment variable ``JUJU_MODEL_NAME``.
+        """
+        return self._backend.model_name
+
+    def get_unit(self, unit_name: str) -> 'Unit':
+        """Get an arbitrary unit by name.
+
+        Internally this uses a cache, so asking for the same unit two times will
+        return the same object.
+        """
+        return self._cache.get(Unit, unit_name)
+
+    def get_app(self, app_name: str) -> 'Application':
+        """Get an application by name.
+
+        Internally this uses a cache, so asking for the same application two times will
+        return the same object.
+        """
+        return self._cache.get(Application, app_name)
+
+    def get_relation(
+            self, relation_name: str,
+            relation_id: typing.Optional[int] = None) -> 'Relation':
+        """Get a specific Relation instance.
+
+        If relation_id is not given, this will return the Relation instance if the
+        relation is established only once or None if it is not established. If this
+        same relation is established multiple times the error TooManyRelatedAppsError is raised.
+
+        Args:
+            relation_name: The name of the endpoint for this charm
+            relation_id: An identifier for a specific relation. Used to disambiguate when a
+                given application has more than one relation on a given endpoint.
+
+        Raises:
+            TooManyRelatedAppsError: is raised if there is more than one relation to the
+                supplied relation_name and no relation_id was supplied
+        """
+        return self.relations._get_unique(relation_name, relation_id)
+
+    def get_binding(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a network space binding.
+
+        Args:
+            binding_key: The relation name or instance to obtain bindings for.
+
+        Returns:
+            If ``binding_key`` is a relation name, the method returns the default binding
+            for that relation. If a relation instance is provided, the method first looks
+            up a more specific binding for that specific relation ID, and if none is found
+            falls back to the default binding for the relation name.
+        """
+        return self._bindings.get(binding_key)
+
+
+class _ModelCache:
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._weakrefs = weakref.WeakValueDictionary()
+
+    def get(self, entity_type, *args):
+        key = (entity_type,) + args
+        entity = self._weakrefs.get(key)
+        if entity is None:
+            entity = entity_type(*args, backend=self._backend, cache=self)
+            self._weakrefs[key] = entity
+        return entity
+
+
+class Application:
+    """Represents a named application in the model.
+
+    This might be your application, or might be an application that you are related to.
+    Charmers should not instantiate Application objects directly, but should use
+    :meth:`Model.get_app` if they need a reference to a given application.
+
+    Attributes:
+        name: The name of this application (eg, 'mysql'). This name may differ from the name of
+            the charm, if the user has deployed it to a different name.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+        self._backend = backend
+        self._cache = cache
+        self._is_our_app = self.name == self._backend.app_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of the overall application.
+
+        Can only be read and set by the lead unit of the application.
+
+        The status of remote units is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of another application, or if you try to
+                set the status of this application as a unit that is not the leader.
+            InvalidStatusError: if you try to set the status to something that is not a
+                :class:`StatusBase`
+
+        Example::
+
+            self.model.app.status = BlockedStatus('I need a human to come help me')
+        """
+        if not self._is_our_app:
+            return UnknownStatus()
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot get application status as a non-leader unit')
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=True)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for application {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_app:
+            raise RuntimeError('cannot to set status for a remote application {}'.format(self))
+
+        if not self._backend.is_leader():
+            raise RuntimeError('cannot set application status as a non-leader unit')
+
+        self._backend.status_set(value.name, value.message, is_app=True)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+
+class Unit:
+    """Represents a named unit in the model.
+
+    This might be your unit, another unit of your application, or a unit of another application
+    that you are related to.
+
+    Attributes:
+        name: The name of the unit (eg, 'mysql/0')
+        app: The Application the unit is a part of.
+    """
+
+    def __init__(self, name, backend, cache):
+        self.name = name
+
+        app_name = name.split('/')[0]
+        self.app = cache.get(Application, app_name)
+
+        self._backend = backend
+        self._cache = cache
+        self._is_our_unit = self.name == self._backend.unit_name
+        self._status = None
+
+    def _invalidate(self):
+        self._status = None
+
+    @property
+    def status(self) -> 'StatusBase':
+        """Used to report or read the status of a specific unit.
+
+        The status of any unit other than yourself is always Unknown.
+
+        Raises:
+            RuntimeError: if you try to set the status of a unit other than yourself.
+            InvalidStatusError: if you try to set the status to something other than
+                a :class:`StatusBase`
+        Example::
+
+            self.model.unit.status = MaintenanceStatus('reconfiguring the frobnicators')
+        """
+        if not self._is_our_unit:
+            return UnknownStatus()
+
+        if self._status:
+            return self._status
+
+        s = self._backend.status_get(is_app=False)
+        self._status = StatusBase.from_name(s['status'], s['message'])
+        return self._status
+
+    @status.setter
+    def status(self, value: 'StatusBase'):
+        if not isinstance(value, StatusBase):
+            raise InvalidStatusError(
+                'invalid value provided for unit {} status: {}'.format(self, value)
+            )
+
+        if not self._is_our_unit:
+            raise RuntimeError('cannot set status for a remote unit {}'.format(self))
+
+        self._backend.status_set(value.name, value.message, is_app=False)
+        self._status = value
+
+    def __repr__(self):
+        return '<{}.{} {}>'.format(type(self).__module__, type(self).__name__, self.name)
+
+    def is_leader(self) -> bool:
+        """Return whether this unit is the leader of its application.
+
+        This can only be called for your own unit.
+
+        Returns:
+            True if you are the leader, False otherwise
+        Raises:
+            RuntimeError: if called for a unit that is not yourself
+        """
+        if self._is_our_unit:
+            # This value is not cached as it is not guaranteed to persist for the whole duration
+            # of a hook execution.
+            return self._backend.is_leader()
+        else:
+            raise RuntimeError(
+                'leadership status of remote units ({}) is not visible to other'
+                ' applications'.format(self)
+            )
+
+    def set_workload_version(self, version: str) -> None:
+        """Record the version of the software running as the workload.
+
+        This shouldn't be confused with the revision of the charm. This is informative only;
+        shown in the output of 'juju status'.
+        """
+        if not isinstance(version, str):
+            raise TypeError("workload version must be a str, not {}: {!r}".format(
+                type(version).__name__, version))
+        self._backend.application_version_set(version)
+
+
+class LazyMapping(Mapping, ABC):
+    """Represents a dict that isn't populated until it is accessed.
+
+    Charm authors should generally never need to use this directly, but it forms
+    the basis for many of the dicts that the framework tracks.
+    """
+
+    _lazy_data = None
+
+    @abstractmethod
+    def _load(self):
+        raise NotImplementedError()
+
+    @property
+    def _data(self):
+        data = self._lazy_data
+        if data is None:
+            data = self._lazy_data = self._load()
+        return data
+
+    def _invalidate(self):
+        self._lazy_data = None
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+class RelationMapping(Mapping):
+    """Map of relation names to lists of :class:`Relation` instances."""
+
+    def __init__(self, relations_meta, our_unit, backend, cache):
+        self._peers = set()
+        for name, relation_meta in relations_meta.items():
+            if relation_meta.role.is_peer():
+                self._peers.add(name)
+        self._our_unit = our_unit
+        self._backend = backend
+        self._cache = cache
+        self._data = {relation_name: None for relation_name in relations_meta}
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, relation_name):
+        is_peer = relation_name in self._peers
+        relation_list = self._data[relation_name]
+        if relation_list is None:
+            relation_list = self._data[relation_name] = []
+            for rid in self._backend.relation_ids(relation_name):
+                relation = Relation(relation_name, rid, is_peer,
+                                    self._our_unit, self._backend, self._cache)
+                relation_list.append(relation)
+        return relation_list
+
+    def _invalidate(self, relation_name):
+        """Used to wipe the cache of a given relation_name.
+
+        Not meant to be used by Charm authors. The content of relation data is
+        static for the lifetime of a hook, so it is safe to cache in memory once
+        accessed.
+        """
+        self._data[relation_name] = None
+
+    def _get_unique(self, relation_name, relation_id=None):
+        if relation_id is not None:
+            if not isinstance(relation_id, int):
+                raise ModelError('relation id {} must be int or None not {}'.format(
+                    relation_id,
+                    type(relation_id).__name__))
+            for relation in self[relation_name]:
+                if relation.id == relation_id:
+                    return relation
+            else:
+                # The relation may be dead, but it is not forgotten.
+                is_peer = relation_name in self._peers
+                return Relation(relation_name, relation_id, is_peer,
+                                self._our_unit, self._backend, self._cache)
+        num_related = len(self[relation_name])
+        if num_related == 0:
+            return None
+        elif num_related == 1:
+            return self[relation_name][0]
+        else:
+            # TODO: We need something in the framework to catch and gracefully handle
+            # errors, ideally integrating the error catching with Juju's mechanisms.
+            raise TooManyRelatedAppsError(relation_name, num_related, 1)
+
+
+class BindingMapping:
+    """Mapping of endpoints to network bindings.
+
+    Charm authors should not instantiate this directly, but access it via
+    :meth:`Model.get_binding`
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+        self._data = {}
+
+    def get(self, binding_key: typing.Union[str, 'Relation']) -> 'Binding':
+        """Get a specific Binding for an endpoint/relation.
+
+        Not used directly by Charm authors. See :meth:`Model.get_binding`
+        """
+        if isinstance(binding_key, Relation):
+            binding_name = binding_key.name
+            relation_id = binding_key.id
+        elif isinstance(binding_key, str):
+            binding_name = binding_key
+            relation_id = None
+        else:
+            raise ModelError('binding key must be str or relation instance, not {}'
+                             ''.format(type(binding_key).__name__))
+        binding = self._data.get(binding_key)
+        if binding is None:
+            binding = Binding(binding_name, relation_id, self._backend)
+            self._data[binding_key] = binding
+        return binding
+
+
+class Binding:
+    """Binding to a network space.
+
+    Attributes:
+        name: The name of the endpoint this binding represents (eg, 'db')
+    """
+
+    def __init__(self, name, relation_id, backend):
+        self.name = name
+        self._relation_id = relation_id
+        self._backend = backend
+        self._network = None
+
+    @property
+    def network(self) -> 'Network':
+        """The network information for this binding."""
+        if self._network is None:
+            try:
+                self._network = Network(self._backend.network_get(self.name, self._relation_id))
+            except RelationNotFoundError:
+                if self._relation_id is None:
+                    raise
+                # If a relation is dead, we can still get network info associated with an
+                # endpoint itself
+                self._network = Network(self._backend.network_get(self.name))
+        return self._network
+
+
+class Network:
+    """Network space details.
+
+    Charm authors should not instantiate this directly, but should get access to the Network
+    definition from :meth:`Model.get_binding` and its ``network`` attribute.
+
+    Attributes:
+        interfaces: A list of :class:`NetworkInterface` details. This includes the
+            information about how your application should be configured (eg, what
+            IP addresses should you bind to.)
+            Note that multiple addresses for a single interface are represented as multiple
+            interfaces. (eg, ``[NetworkInfo('ens1', '10.1.1.1/32'),
+            NetworkInfo('ens1', '10.1.2.1/32'])``)
+        ingress_addresses: A list of :class:`ipaddress.ip_address` objects representing the IP
+            addresses that other units should use to get in touch with you.
+        egress_subnets: A list of :class:`ipaddress.ip_network` representing the subnets that
+            other units will see you connecting from. Due to things like NAT it isn't always
+            possible to narrow it down to a single address, but when it is clear, the CIDRs
+            will be constrained to a single address. (eg, 10.0.0.1/32)
+    Args:
+        network_info: A dict of network information as returned by ``network-get``.
+    """
+
+    def __init__(self, network_info: dict):
+        self.interfaces = []
+        # Treat multiple addresses on an interface as multiple logical
+        # interfaces with the same name.
+        for interface_info in network_info.get('bind-addresses', []):
+            interface_name = interface_info.get('interface-name')
+            for address_info in interface_info.get('addresses', []):
+                self.interfaces.append(NetworkInterface(interface_name, address_info))
+        self.ingress_addresses = []
+        for address in network_info.get('ingress-addresses', []):
+            self.ingress_addresses.append(ipaddress.ip_address(address))
+        self.egress_subnets = []
+        for subnet in network_info.get('egress-subnets', []):
+            self.egress_subnets.append(ipaddress.ip_network(subnet))
+
+    @property
+    def bind_address(self):
+        """A single address that your application should bind() to.
+
+        For the common case where there is a single answer. This represents a single
+        address from :attr:`.interfaces` that can be used to configure where your
+        application should bind() and listen().
+        """
+        if self.interfaces:
+            return self.interfaces[0].address
+        else:
+            return None
+
+    @property
+    def ingress_address(self):
+        """The address other applications should use to connect to your unit.
+
+        Due to things like public/private addresses, NAT and tunneling, the address you bind()
+        to is not always the address other people can use to connect() to you.
+        This is just the first address from :attr:`.ingress_addresses`.
+        """
+        if self.ingress_addresses:
+            return self.ingress_addresses[0]
+        else:
+            return None
+
+
+class NetworkInterface:
+    """Represents a single network interface that the charm needs to know about.
+
+    Charmers should not instantiate this type directly. Instead use :meth:`Model.get_binding`
+    to get the network information for a given endpoint.
+
+    Attributes:
+        name: The name of the interface (eg. 'eth0', or 'ens1')
+        subnet: An :class:`ipaddress.ip_network` representation of the IP for the network
+            interface. This may be a single address (eg '10.0.1.2/32')
+    """
+
+    def __init__(self, name: str, address_info: dict):
+        self.name = name
+        # TODO: expose a hardware address here, see LP: #1864070.
+        address = address_info.get('value')
+        # The value field may be empty.
+        if address:
+            self.address = ipaddress.ip_address(address)
+        else:
+            self.address = None
+        cidr = address_info.get('cidr')
+        # The cidr field may be empty, see LP: #1864102.
+        if cidr:
+            self.subnet = ipaddress.ip_network(cidr)
+        elif address:
+            # If we have an address, convert it to a /32 or /128 IP network.
+            self.subnet = ipaddress.ip_network(address)
+        else:
+            self.subnet = None
+        # TODO: expose a hostname/canonical name for the address here, see LP: #1864086.
+
+
+class Relation:
+    """Represents an established relation between this application and another application.
+
+    This class should not be instantiated directly, instead use :meth:`Model.get_relation`
+    or :attr:`ops.charm.RelationEvent.relation`.
+
+    Attributes:
+        name: The name of the local endpoint of the relation (eg 'db')
+        id: The identifier for a particular relation (integer)
+        app: An :class:`Application` representing the remote application of this relation.
+            For peer relations this will be the local application.
+        units: A set of :class:`Unit` for units that have started and joined this relation.
+        data: A :class:`RelationData` holding the data buckets for each entity
+            of a relation. Accessed via eg Relation.data[unit]['foo']
+    """
+
+    def __init__(
+            self, relation_name: str, relation_id: int, is_peer: bool, our_unit: Unit,
+            backend: '_ModelBackend', cache: '_ModelCache'):
+        self.name = relation_name
+        self.id = relation_id
+        self.app = None
+        self.units = set()
+
+        # For peer relations, both the remote and the local app are the same.
+        if is_peer:
+            self.app = our_unit.app
+        try:
+            for unit_name in backend.relation_list(self.id):
+                unit = cache.get(Unit, unit_name)
+                self.units.add(unit)
+                if self.app is None:
+                    self.app = unit.app
+        except RelationNotFoundError:
+            # If the relation is dead, just treat it as if it has no remote units.
+            pass
+        self.data = RelationData(self, our_unit, backend)
+
+    def __repr__(self):
+        return '<{}.{} {}:{}>'.format(type(self).__module__,
+                                      type(self).__name__,
+                                      self.name,
+                                      self.id)
+
+
+class RelationData(Mapping):
+    """Represents the various data buckets of a given relation.
+
+    Each unit and application involved in a relation has their own data bucket.
+    Eg: ``{entity: RelationDataContent}``
+    where entity can be either a :class:`Unit` or a :class:`Application`.
+
+    Units can read and write their own data, and if they are the leader,
+    they can read and write their application data. They are allowed to read
+    remote unit and application data.
+
+    This class should not be created directly. It should be accessed via
+    :attr:`Relation.data`
+    """
+
+    def __init__(self, relation: Relation, our_unit: Unit, backend: '_ModelBackend'):
+        self.relation = weakref.proxy(relation)
+        self._data = {
+            our_unit: RelationDataContent(self.relation, our_unit, backend),
+            our_unit.app: RelationDataContent(self.relation, our_unit.app, backend),
+        }
+        self._data.update({
+            unit: RelationDataContent(self.relation, unit, backend)
+            for unit in self.relation.units})
+        # The relation might be dead so avoid a None key here.
+        if self.relation.app is not None:
+            self._data.update({
+                self.relation.app: RelationDataContent(self.relation, self.relation.app, backend),
+            })
+
+    def __contains__(self, key):
+        return key in self._data
+
+    def __len__(self):
+        return len(self._data)
+
+    def __iter__(self):
+        return iter(self._data)
+
+    def __getitem__(self, key):
+        return self._data[key]
+
+    def __repr__(self):
+        return repr(self._data)
+
+
+# We mix in MutableMapping here to get some convenience implementations, but whether it's actually
+# mutable or not is controlled by the flag.
+class RelationDataContent(LazyMapping, MutableMapping):
+    """Data content of a unit or application in a relation."""
+
+    def __init__(self, relation, entity, backend):
+        self.relation = relation
+        self._entity = entity
+        self._backend = backend
+        self._is_app = isinstance(entity, Application)
+
+    def _load(self):
+        """Load the data from the current entity / relation."""
+        try:
+            return self._backend.relation_get(self.relation.id, self._entity.name, self._is_app)
+        except RelationNotFoundError:
+            # Dead relations tell no tales (and have no data).
+            return {}
+
+    def _is_mutable(self):
+        """Return if the data content can be modified."""
+        if self._is_app:
+            is_our_app = self._backend.app_name == self._entity.name
+            if not is_our_app:
+                return False
+            # Whether the application data bag is mutable or not depends on
+            # whether this unit is a leader or not, but this is not guaranteed
+            # to be always true during the same hook execution.
+            return self._backend.is_leader()
+        else:
+            is_our_unit = self._backend.unit_name == self._entity.name
+            if is_our_unit:
+                return True
+        return False
+
+    def __setitem__(self, key, value):
+        if not self._is_mutable():
+            raise RelationDataError('cannot set relation data for {}'.format(self._entity.name))
+        if not isinstance(value, str):
+            raise RelationDataError('relation data values must be strings')
+
+        self._backend.relation_set(self.relation.id, key, value, self._is_app)
+
+        # Don't load data unnecessarily if we're only updating.
+        if self._lazy_data is not None:
+            if value == '':
+                # Match the behavior of Juju, which is that setting the value to an
+                # empty string will remove the key entirely from the relation data.
+                self._data.pop(key, None)
+            else:
+                self._data[key] = value
+
+    def __delitem__(self, key):
+        # Match the behavior of Juju, which is that setting the value to an empty
+        # string will remove the key entirely from the relation data.
+        self.__setitem__(key, '')
+
+
+class ConfigData(LazyMapping):
+    """Configuration data.
+
+    This class should not be created directly. It should be accessed via :attr:`Model.config`.
+    """
+
+    def __init__(self, backend):
+        self._backend = backend
+
+    def _load(self):
+        return self._backend.config_get()
+
+
+class StatusBase:
+    """Status values specific to applications and units.
+
+    To access a status by name, see :meth:`StatusBase.from_name`, most use cases will just
+    directly use the child class to indicate their status.
+    """
+
+    _statuses = {}
+    name = None
+
+    def __init__(self, message: str):
+        self.message = message
+
+    def __new__(cls, *args, **kwargs):
+        """Forbid the usage of StatusBase directly."""
+        if cls is StatusBase:
+            raise TypeError("cannot instantiate a base class")
+        return super().__new__(cls)
+
+    def __eq__(self, other):
+        if not isinstance(self, type(other)):
+            return False
+        return self.message == other.message
+
+    def __repr__(self):
+        return "{.__class__.__name__}({!r})".format(self, self.message)
+
+    @classmethod
+    def from_name(cls, name: str, message: str):
+        """Get the specific Status for the name (or UnknownStatus if not registered)."""
+        if name == 'unknown':
+            # unknown is special
+            return UnknownStatus()
+        else:
+            return cls._statuses[name](message)
+
+    @classmethod
+    def register(cls, child):
+        """Register a Status for the child's name."""
+        if child.name is None:
+            raise AttributeError('cannot register a Status which has no name')
+        cls._statuses[child.name] = child
+        return child
+
+
+@StatusBase.register
+class UnknownStatus(StatusBase):
+    """The unit status is unknown.
+
+    A unit-agent has finished calling install, config-changed and start, but the
+    charm has not called status-set yet.
+
+    """
+    name = 'unknown'
+
+    def __init__(self):
+        # Unknown status cannot be set and does not have a message associated with it.
+        super().__init__('')
+
+    def __repr__(self):
+        return "UnknownStatus()"
+
+
+@StatusBase.register
+class ActiveStatus(StatusBase):
+    """The unit is ready.
+
+    The unit believes it is correctly offering all the services it has been asked to offer.
+    """
+    name = 'active'
+
+    def __init__(self, message: str = ''):
+        super().__init__(message)
+
+
+@StatusBase.register
+class BlockedStatus(StatusBase):
+    """The unit requires manual intervention.
+
+    An operator has to manually intervene to unblock the unit and let it proceed.
+    """
+    name = 'blocked'
+
+
+@StatusBase.register
+class MaintenanceStatus(StatusBase):
+    """The unit is performing maintenance tasks.
+
+    The unit is not yet providing services, but is actively doing work in preparation
+    for providing those services.  This is a "spinning" state, not an error state. It
+    reflects activity on the unit itself, not on peers or related units.
+
+    """
+    name = 'maintenance'
+
+
+@StatusBase.register
+class WaitingStatus(StatusBase):
+    """A unit is unable to progress.
+
+    The unit is unable to progress to an active state because an application to which
+    it is related is not running.
+
+    """
+    name = 'waiting'
+
+
+class Resources:
+    """Object representing resources for the charm."""
+
+    def __init__(self, names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._paths = {name: None for name in names}
+
+    def fetch(self, name: str) -> Path:
+        """Fetch the resource from the controller or store.
+
+        If successfully fetched, this returns a Path object to where the resource is stored
+        on disk, otherwise it raises a ModelError.
+        """
+        if name not in self._paths:
+            raise RuntimeError('invalid resource name: {}'.format(name))
+        if self._paths[name] is None:
+            self._paths[name] = Path(self._backend.resource_get(name))
+        return self._paths[name]
+
+
+class Pod:
+    """Represents the definition of a pod spec in Kubernetes models.
+
+    Currently only supports simple access to setting the Juju pod spec via :attr:`.set_spec`.
+    """
+
+    def __init__(self, backend: '_ModelBackend'):
+        self._backend = backend
+
+    def set_spec(self, spec: typing.Mapping, k8s_resources: typing.Mapping = None):
+        """Set the specification for pods that Juju should start in kubernetes.
+
+        See `juju help-tool pod-spec-set` for details of what should be passed.
+
+        Args:
+            spec: The mapping defining the pod specification
+            k8s_resources: Additional kubernetes specific specification.
+
+        Returns:
+            None
+        """
+        if not self._backend.is_leader():
+            raise ModelError('cannot set a pod spec as this unit is not a leader')
+        self._backend.pod_spec_set(spec, k8s_resources)
+
+
+class StorageMapping(Mapping):
+    """Map of storage names to lists of Storage instances."""
+
+    def __init__(self, storage_names: typing.Iterable[str], backend: '_ModelBackend'):
+        self._backend = backend
+        self._storage_map = {storage_name: None for storage_name in storage_names}
+
+    def __contains__(self, key: str):
+        return key in self._storage_map
+
+    def __len__(self):
+        return len(self._storage_map)
+
+    def __iter__(self):
+        return iter(self._storage_map)
+
+    def __getitem__(self, storage_name: str) -> typing.List['Storage']:
+        storage_list = self._storage_map[storage_name]
+        if storage_list is None:
+            storage_list = self._storage_map[storage_name] = []
+            for storage_id in self._backend.storage_list(storage_name):
+                storage_list.append(Storage(storage_name, storage_id, self._backend))
+        return storage_list
+
+    def request(self, storage_name: str, count: int = 1):
+        """Requests new storage instances of a given name.
+
+        Uses storage-add tool to request additional storage. Juju will notify the unit
+        via <storage-name>-storage-attached events when it becomes available.
+        """
+        if storage_name not in self._storage_map:
+            raise ModelError(('cannot add storage {!r}:'
+                              ' it is not present in the charm metadata').format(storage_name))
+        self._backend.storage_add(storage_name, count)
+
+
+class Storage:
+    """Represents a storage as defined in metadata.yaml.
+
+    Attributes:
+        name: Simple string name of the storage
+        id: The provider id for storage
+    """
+
+    def __init__(self, storage_name, storage_id, backend):
+        self.name = storage_name
+        self.id = storage_id
+        self._backend = backend
+        self._location = None
+
+    @property
+    def location(self):
+        """Return the location of the storage."""
+        if self._location is None:
+            raw = self._backend.storage_get('{}/{}'.format(self.name, self.id), "location")
+            self._location = Path(raw)
+        return self._location
+
+
+class ModelError(Exception):
+    """Base class for exceptions raised when interacting with the Model."""
+    pass
+
+
+class TooManyRelatedAppsError(ModelError):
+    """Raised by :meth:`Model.get_relation` if there is more than one related application."""
+
+    def __init__(self, relation_name, num_related, max_supported):
+        super().__init__('Too many remote applications on {} ({} > {})'.format(
+            relation_name, num_related, max_supported))
+        self.relation_name = relation_name
+        self.num_related = num_related
+        self.max_supported = max_supported
+
+
+class RelationDataError(ModelError):
+    """Raised by ``Relation.data[entity][key] = 'foo'`` if the data is invalid.
+
+    This is raised if you're either trying to set a value to something that isn't a string,
+    or if you are trying to set a value in a bucket that you don't have access to. (eg,
+    another application/unit or setting your application data but you aren't the leader.)
+    """
+
+
+class RelationNotFoundError(ModelError):
+    """Backend error when querying juju for a given relation and that relation doesn't exist."""
+
+
+class InvalidStatusError(ModelError):
+    """Raised if trying to set an Application or Unit status to something invalid."""
+
+
+class _ModelBackend:
+    """Represents the connection between the Model representation and talking to Juju.
+
+    Charm authors should not directly interact with the ModelBackend, it is a private
+    implementation of Model.
+    """
+
+    LEASE_RENEWAL_PERIOD = datetime.timedelta(seconds=30)
+
+    def __init__(self, unit_name=None, model_name=None):
+        if unit_name is None:
+            self.unit_name = os.environ['JUJU_UNIT_NAME']
+        else:
+            self.unit_name = unit_name
+        if model_name is None:
+            model_name = os.environ.get('JUJU_MODEL_NAME')
+        self.model_name = model_name
+        self.app_name = self.unit_name.split('/')[0]
+
+        self._is_leader = None
+        self._leader_check_time = None
+
+    def _run(self, *args, return_output=False, use_json=False):
+        kwargs = dict(stdout=PIPE, stderr=PIPE, check=True)
+        args = (shutil.which(args[0]),) + args[1:]
+        if use_json:
+            args += ('--format=json',)
+        try:
+            result = run(args, **kwargs)
+        except CalledProcessError as e:
+            raise ModelError(e.stderr)
+        if return_output:
+            if result.stdout is None:
+                return ''
+            else:
+                text = result.stdout.decode('utf8')
+                if use_json:
+                    return json.loads(text)
+                else:
+                    return text
+
+    def relation_ids(self, relation_name):
+        relation_ids = self._run('relation-ids', relation_name, return_output=True, use_json=True)
+        return [int(relation_id.split(':')[-1]) for relation_id in relation_ids]
+
+    def relation_list(self, relation_id):
+        try:
+            return self._run('relation-list', '-r', str(relation_id),
+                             return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_get must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'getting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-get', '-r', str(relation_id), '-', member_name]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def relation_set(self, relation_id, key, value, is_app):
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter to relation_set must be a boolean')
+
+        if is_app:
+            version = JujuVersion.from_environ()
+            if not version.has_app_data():
+                raise RuntimeError(
+                    'setting application data is not supported on Juju version {}'.format(version))
+
+        args = ['relation-set', '-r', str(relation_id), '{}={}'.format(key, value)]
+        if is_app:
+            args.append('--app')
+
+        try:
+            return self._run(*args)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def config_get(self):
+        return self._run('config-get', return_output=True, use_json=True)
+
+    def is_leader(self):
+        """Obtain the current leadership status for the unit the charm code is executing on.
+
+        The value is cached for the duration of a lease which is 30s in Juju.
+        """
+        now = time.monotonic()
+        if self._leader_check_time is None:
+            check = True
+        else:
+            time_since_check = datetime.timedelta(seconds=now - self._leader_check_time)
+            check = (time_since_check > self.LEASE_RENEWAL_PERIOD or self._is_leader is None)
+        if check:
+            # Current time MUST be saved before running is-leader to ensure the cache
+            # is only used inside the window that is-leader itself asserts.
+            self._leader_check_time = now
+            self._is_leader = self._run('is-leader', return_output=True, use_json=True)
+
+        return self._is_leader
+
+    def resource_get(self, resource_name):
+        return self._run('resource-get', resource_name, return_output=True).strip()
+
+    def pod_spec_set(self, spec, k8s_resources):
+        tmpdir = Path(tempfile.mkdtemp('-pod-spec-set'))
+        try:
+            spec_path = tmpdir / 'spec.yaml'
+            with spec_path.open("wt", encoding="utf8") as f:
+                yaml.dump(spec, stream=f, Dumper=_DefaultDumper)
+            args = ['--file', str(spec_path)]
+            if k8s_resources:
+                k8s_res_path = tmpdir / 'k8s-resources.yaml'
+                with k8s_res_path.open("wt", encoding="utf8") as f:
+                    yaml.dump(k8s_resources, stream=f, Dumper=_DefaultDumper)
+                args.extend(['--k8s-resources', str(k8s_res_path)])
+            self._run('pod-spec-set', *args)
+        finally:
+            shutil.rmtree(str(tmpdir))
+
+    def status_get(self, *, is_app=False):
+        """Get a status of a unit or an application.
+
+        Args:
+            is_app: A boolean indicating whether the status should be retrieved for a unit
+                or an application.
+        """
+        content = self._run(
+            'status-get', '--include-data', '--application={}'.format(is_app),
+            use_json=True,
+            return_output=True)
+        # Unit status looks like (in YAML):
+        # message: 'load: 0.28 0.26 0.26'
+        # status: active
+        # status-data: {}
+        # Application status looks like (in YAML):
+        # application-status:
+        #   message: 'load: 0.28 0.26 0.26'
+        #   status: active
+        #   status-data: {}
+        #   units:
+        #     uo/0:
+        #       message: 'load: 0.28 0.26 0.26'
+        #       status: active
+        #       status-data: {}
+
+        if is_app:
+            return {'status': content['application-status']['status'],
+                    'message': content['application-status']['message']}
+        else:
+            return content
+
+    def status_set(self, status, message='', *, is_app=False):
+        """Set a status of a unit or an application.
+
+        Args:
+            status: The status to set.
+            message: The message to set in the status.
+            is_app: A boolean indicating whether the status should be set for a unit or an
+                    application.
+        """
+        if not isinstance(is_app, bool):
+            raise TypeError('is_app parameter must be boolean')
+        return self._run('status-set', '--application={}'.format(is_app), status, message)
+
+    def storage_list(self, name):
+        return [int(s.split('/')[1]) for s in self._run('storage-list', name,
+                                                        return_output=True, use_json=True)]
+
+    def storage_get(self, storage_name_id, attribute):
+        return self._run('storage-get', '-s', storage_name_id, attribute,
+                         return_output=True, use_json=True)
+
+    def storage_add(self, name, count=1):
+        if not isinstance(count, int) or isinstance(count, bool):
+            raise TypeError('storage count must be integer, got: {} ({})'.format(count,
+                                                                                 type(count)))
+        self._run('storage-add', '{}={}'.format(name, count))
+
+    def action_get(self):
+        return self._run('action-get', return_output=True, use_json=True)
+
+    def action_set(self, results):
+        self._run('action-set', *["{}={}".format(k, v) for k, v in results.items()])
+
+    def action_log(self, message):
+        self._run('action-log', message)
+
+    def action_fail(self, message=''):
+        self._run('action-fail', message)
+
+    def application_version_set(self, version):
+        self._run('application-version-set', '--', version)
+
+    def juju_log(self, level, message):
+        self._run('juju-log', '--log-level', level, "--", message)
+
+    def network_get(self, binding_name, relation_id=None):
+        """Return network info provided by network-get for a given binding.
+
+        Args:
+            binding_name: A name of a binding (relation name or extra-binding name).
+            relation_id: An optional relation id to get network info for.
+        """
+        cmd = ['network-get', binding_name]
+        if relation_id is not None:
+            cmd.extend(['-r', str(relation_id)])
+        try:
+            return self._run(*cmd, return_output=True, use_json=True)
+        except ModelError as e:
+            if 'relation not found' in str(e):
+                raise RelationNotFoundError() from e
+            raise
+
+    def add_metrics(self, metrics, labels=None):
+        cmd = ['add-metric']
+
+        if labels:
+            label_args = []
+            for k, v in labels.items():
+                _ModelBackendValidator.validate_metric_label(k)
+                _ModelBackendValidator.validate_label_value(k, v)
+                label_args.append('{}={}'.format(k, v))
+            cmd.extend(['--labels', ','.join(label_args)])
+
+        metric_args = []
+        for k, v in metrics.items():
+            _ModelBackendValidator.validate_metric_key(k)
+            metric_value = _ModelBackendValidator.format_metric_value(v)
+            metric_args.append('{}={}'.format(k, metric_value))
+        cmd.extend(metric_args)
+        self._run(*cmd)
+
+
+class _ModelBackendValidator:
+    """Provides facilities for validating inputs and formatting them for model backends."""
+
+    METRIC_KEY_REGEX = re.compile(r'^[a-zA-Z](?:[a-zA-Z0-9-_]*[a-zA-Z0-9])?$')
+
+    @classmethod
+    def validate_metric_key(cls, key):
+        if cls.METRIC_KEY_REGEX.match(key) is None:
+            raise ModelError(
+                'invalid metric key {!r}: must match {}'.format(
+                    key, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def validate_metric_label(cls, label_name):
+        if cls.METRIC_KEY_REGEX.match(label_name) is None:
+            raise ModelError(
+                'invalid metric label name {!r}: must match {}'.format(
+                    label_name, cls.METRIC_KEY_REGEX.pattern))
+
+    @classmethod
+    def format_metric_value(cls, value):
+        try:
+            decimal_value = decimal.Decimal.from_float(value)
+        except TypeError as e:
+            e2 = ModelError('invalid metric value {!r} provided:'
+                            ' must be a positive finite float'.format(value))
+            raise e2 from e
+        if decimal_value.is_nan() or decimal_value.is_infinite() or decimal_value < 0:
+            raise ModelError('invalid metric value {!r} provided:'
+                             ' must be a positive finite float'.format(value))
+        return str(decimal_value)
+
+    @classmethod
+    def validate_label_value(cls, label, value):
+        # Label values cannot be empty, contain commas or equal signs as those are
+        # used by add-metric as separators.
+        if not value:
+            raise ModelError(
+                'metric label {} has an empty value, which is not allowed'.format(label))
+        v = str(value)
+        if re.search('[,=]', v) is not None:
+            raise ModelError(
+                'metric label values must not contain "," or "=": {}={!r}'.format(label, value))
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/storage.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/storage.py
new file mode 100644
index 0000000000000000000000000000000000000000..562cde770bcc3b5961aa6086372f0a2529bbd317
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/storage.py
@@ -0,0 +1,374 @@
+# Copyright 2019-2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Structures to offer storage to the charm (through Juju or locally)."""
+
+from datetime import timedelta
+import pickle
+import shutil
+import subprocess
+import sqlite3
+import typing
+
+import yaml
+
+
+def _run(args, **kw):
+    cmd = shutil.which(args[0])
+    if cmd is None:
+        raise FileNotFoundError(args[0])
+    return subprocess.run([cmd, *args[1:]], **kw)
+
+
+class SQLiteStorage:
+    """Storage using SQLite backend."""
+
+    DB_LOCK_TIMEOUT = timedelta(hours=1)
+
+    def __init__(self, filename):
+        # The isolation_level argument is set to None such that the implicit
+        # transaction management behavior of the sqlite3 module is disabled.
+        self._db = sqlite3.connect(str(filename),
+                                   isolation_level=None,
+                                   timeout=self.DB_LOCK_TIMEOUT.total_seconds())
+        self._setup()
+
+    def _setup(self):
+        """Make the database ready to be used as storage."""
+        # Make sure that the database is locked until the connection is closed,
+        # not until the transaction ends.
+        self._db.execute("PRAGMA locking_mode=EXCLUSIVE")
+        c = self._db.execute("BEGIN")
+        c.execute("SELECT count(name) FROM sqlite_master WHERE type='table' AND name='snapshot'")
+        if c.fetchone()[0] == 0:
+            # Keep in mind what might happen if the process dies somewhere below.
+            # The system must not be rendered permanently broken by that.
+            self._db.execute("CREATE TABLE snapshot (handle TEXT PRIMARY KEY, data BLOB)")
+            self._db.execute('''
+                CREATE TABLE notice (
+                  sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+                  event_path TEXT,
+                  observer_path TEXT,
+                  method_name TEXT)
+                ''')
+            self._db.commit()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend."""
+        self._db.close()
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend."""
+        self._db.commit()
+
+    # There's commit but no rollback. For abort to be supported, we'll need logic that
+    # can rollback decisions made by third-party code in terms of the internal state
+    # of objects that have been snapshotted, and hooks to let them know about it and
+    # take the needed actions to undo their logic until the last snapshot.
+    # This is doable but will increase significantly the chances for mistakes.
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+            might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        # Use pickle for serialization, so the value remains portable.
+        raw_data = pickle.dumps(snapshot_data)
+        self._db.execute("REPLACE INTO snapshot VALUES (?, ?)", (handle_path, raw_data))
+
+    def load_snapshot(self, handle_path: str) -> typing.Any:
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        c = self._db.cursor()
+        c.execute("SELECT data FROM snapshot WHERE handle=?", (handle_path,))
+        row = c.fetchone()
+        if row:
+            return pickle.loads(row[0])
+        raise NoSnapshotError(handle_path)
+
+    def drop_snapshot(self, handle_path: str):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._db.execute("DELETE FROM snapshot WHERE handle=?", (handle_path,))
+
+    def list_snapshots(self) -> typing.Generator[str, None, None]:
+        """Return the name of all snapshots that are currently saved."""
+        c = self._db.cursor()
+        c.execute("SELECT handle FROM snapshot")
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield row[0]
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, record an notice (event and observer)."""
+        self._db.execute('INSERT INTO notice VALUES (NULL, ?, ?, ?)',
+                         (event_path, observer_path, method_name))
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str) -> None:
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        self._db.execute('''
+            DELETE FROM notice
+             WHERE event_path=?
+               AND observer_path=?
+               AND method_name=?
+            ''', (event_path, observer_path, method_name))
+
+    def notices(self, event_path: str = None) ->\
+            typing.Generator[typing.Tuple[str, str, str], None, None]:
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        if event_path:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 WHERE event_path=?
+                 ORDER BY sequence
+                ''', (event_path,))
+        else:
+            c = self._db.execute('''
+                SELECT event_path, observer_path, method_name
+                  FROM notice
+                 ORDER BY sequence
+                ''')
+        while True:
+            rows = c.fetchmany()
+            if not rows:
+                break
+            for row in rows:
+                yield tuple(row)
+
+
+class JujuStorage:
+    """Storing the content tracked by the Framework in Juju.
+
+    This uses :class:`_JujuStorageBackend` to interact with state-get/state-set
+    as the way to store state for the framework and for components.
+    """
+
+    NOTICE_KEY = "#notices#"
+
+    def __init__(self, backend: '_JujuStorageBackend' = None):
+        self._backend = backend
+        if backend is None:
+            self._backend = _JujuStorageBackend()
+
+    def close(self):
+        """Part of the Storage API, close the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def commit(self):
+        """Part of the Storage API, commit latest changes in the storage backend.
+
+        Nothing to be done for Juju backend, as it's transactional.
+        """
+
+    def save_snapshot(self, handle_path: str, snapshot_data: typing.Any) -> None:
+        """Part of the Storage API, persist a snapshot data under the given handle.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+            snapshot_data: The data to be persisted. (as returned by Object.snapshot()). This
+                might be a dict/tuple/int, but must only contain 'simple' python types.
+        """
+        self._backend.set(handle_path, snapshot_data)
+
+    def load_snapshot(self, handle_path):
+        """Part of the Storage API, retrieve a snapshot that was previously saved.
+
+        Args:
+            handle_path: The string identifying the snapshot.
+
+        Raises:
+            NoSnapshotError: if there is no snapshot for the given handle_path.
+        """
+        try:
+            content = self._backend.get(handle_path)
+        except KeyError:
+            raise NoSnapshotError(handle_path)
+        return content
+
+    def drop_snapshot(self, handle_path):
+        """Part of the Storage API, remove a snapshot that was previously saved.
+
+        Dropping a snapshot that doesn't exist is treated as a no-op.
+        """
+        self._backend.delete(handle_path)
+
+    def save_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, record an notice (event and observer)."""
+        notice_list = self._load_notice_list()
+        notice_list.append([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def drop_notice(self, event_path: str, observer_path: str, method_name: str):
+        """Part of the Storage API, remove a notice that was previously recorded."""
+        notice_list = self._load_notice_list()
+        notice_list.remove([event_path, observer_path, method_name])
+        self._save_notice_list(notice_list)
+
+    def notices(self, event_path: str = None):
+        """Part of the Storage API, return all notices that begin with event_path.
+
+        Args:
+            event_path: If supplied, will only yield events that match event_path. If not
+                supplied (or None/'') will return all events.
+
+        Returns:
+            Iterable of (event_path, observer_path, method_name) tuples
+        """
+        notice_list = self._load_notice_list()
+        for row in notice_list:
+            if event_path and row[0] != event_path:
+                continue
+            yield tuple(row)
+
+    def _load_notice_list(self) -> typing.List[typing.Tuple[str]]:
+        """Load a notice list from current key.
+
+        Returns:
+            List of (event_path, observer_path, method_name) tuples; empty if no key or is None.
+        """
+        try:
+            notice_list = self._backend.get(self.NOTICE_KEY)
+        except KeyError:
+            return []
+        if notice_list is None:
+            return []
+        return notice_list
+
+    def _save_notice_list(self, notices: typing.List[typing.Tuple[str]]) -> None:
+        """Save a notice list under current key.
+
+        Args:
+            notices: List of (event_path, observer_path, method_name) tuples.
+        """
+        self._backend.set(self.NOTICE_KEY, notices)
+
+
+class _SimpleLoader(getattr(yaml, 'CSafeLoader', yaml.SafeLoader)):
+    """Handle a couple basic python types.
+
+    yaml.SafeLoader can handle all the basic int/float/dict/set/etc that we want. The only one
+    that it *doesn't* handle is tuples. We don't want to support arbitrary types, so we just
+    subclass SafeLoader and add tuples back in.
+    """
+    # Taken from the example at:
+    # https://stackoverflow.com/questions/9169025/how-can-i-add-a-python-tuple-to-a-yaml-file-using-pyyaml
+
+    construct_python_tuple = yaml.Loader.construct_python_tuple
+
+
+_SimpleLoader.add_constructor(
+    u'tag:yaml.org,2002:python/tuple',
+    _SimpleLoader.construct_python_tuple)
+
+
+class _SimpleDumper(getattr(yaml, 'CSafeDumper', yaml.SafeDumper)):
+    """Add types supported by 'marshal'.
+
+    YAML can support arbitrary types, but that is generally considered unsafe (like pickle). So
+    we want to only support dumping out types that are safe to load.
+    """
+
+
+_SimpleDumper.represent_tuple = yaml.Dumper.represent_tuple
+_SimpleDumper.add_representer(tuple, _SimpleDumper.represent_tuple)
+
+
+def juju_backend_available() -> bool:
+    """Check if Juju state storage is available."""
+    p = shutil.which('state-get')
+    return p is not None
+
+
+class _JujuStorageBackend:
+    """Implements the interface from the Operator framework to Juju's state-get/set/etc."""
+
+    def set(self, key: str, value: typing.Any) -> None:
+        """Set a key to a given value.
+
+        Args:
+            key: The string key that will be used to find the value later
+            value: Arbitrary content that will be returned by get().
+
+        Raises:
+            CalledProcessError: if 'state-set' returns an error code.
+        """
+        # default_flow_style=None means that it can use Block for
+        # complex types (types that have nested types) but use flow
+        # for simple types (like an array). Not all versions of PyYAML
+        # have the same default style.
+        encoded_value = yaml.dump(value, Dumper=_SimpleDumper, default_flow_style=None)
+        content = yaml.dump(
+            {key: encoded_value}, encoding='utf8', default_style='|',
+            default_flow_style=False,
+            Dumper=_SimpleDumper)
+        _run(["state-set", "--file", "-"], input=content, check=True)
+
+    def get(self, key: str) -> typing.Any:
+        """Get the bytes value associated with a given key.
+
+        Args:
+            key: The string key that will be used to find the value
+        Raises:
+            CalledProcessError: if 'state-get' returns an error code.
+        """
+        # We don't capture stderr here so it can end up in debug logs.
+        p = _run(["state-get", key], stdout=subprocess.PIPE, check=True, universal_newlines=True)
+        if p.stdout == '' or p.stdout == '\n':
+            raise KeyError(key)
+        return yaml.load(p.stdout, Loader=_SimpleLoader)
+
+    def delete(self, key: str) -> None:
+        """Remove a key from being tracked.
+
+        Args:
+            key: The key to stop storing
+        Raises:
+            CalledProcessError: if 'state-delete' returns an error code.
+        """
+        _run(["state-delete", key], check=True)
+
+
+class NoSnapshotError(Exception):
+    """Exception to flag that there is no snapshot for the given handle_path."""
+
+    def __init__(self, handle_path):
+        self.handle_path = handle_path
+
+    def __str__(self):
+        return 'no snapshot data found for {} object'.format(self.handle_path)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/testing.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/testing.py
new file mode 100644
index 0000000000000000000000000000000000000000..e70bc98ff661b51cf45c3085ce6a29809a7b3110
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/testing.py
@@ -0,0 +1,826 @@
+# Copyright 2020 Canonical Ltd.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Infrastructure to build unittests for Charms using the Operator Framework."""
+
+import inspect
+import pathlib
+import random
+import tempfile
+import typing
+import yaml
+from contextlib import contextmanager
+from textwrap import dedent
+
+from ops import (
+    charm,
+    framework,
+    model,
+    storage,
+)
+
+
+# OptionalYAML is something like metadata.yaml or actions.yaml. You can
+# pass in a file-like object or the string directly.
+OptionalYAML = typing.Optional[typing.Union[str, typing.TextIO]]
+
+
+# noinspection PyProtectedMember
+class Harness:
+    """This class represents a way to build up the model that will drive a test suite.
+
+    The model that is created is from the viewpoint of the charm that you are testing.
+
+    Example::
+
+        harness = Harness(MyCharm)
+        # Do initial setup here
+        relation_id = harness.add_relation('db', 'postgresql')
+        # Now instantiate the charm to see events as the model changes
+        harness.begin()
+        harness.add_relation_unit(relation_id, 'postgresql/0')
+        harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+        # Check that charm has properly handled the relation_joined event for postgresql/0
+        self.assertEqual(harness.charm. ...)
+
+    Args:
+        charm_cls: The Charm class that you'll be testing.
+        meta: charm.CharmBase is a A string or file-like object containing the contents of
+            metadata.yaml. If not supplied, we will look for a 'metadata.yaml' file in the
+            parent directory of the Charm, and if not found fall back to a trivial
+            'name: test-charm' metadata.
+        actions: A string or file-like object containing the contents of
+            actions.yaml. If not supplied, we will look for a 'actions.yaml' file in the
+            parent directory of the Charm.
+        config: A string or file-like object containing the contents of
+            config.yaml. If not supplied, we will look for a 'config.yaml' file in the
+            parent directory of the Charm.
+    """
+
+    def __init__(
+            self,
+            charm_cls: typing.Type[charm.CharmBase],
+            *,
+            meta: OptionalYAML = None,
+            actions: OptionalYAML = None,
+            config: OptionalYAML = None):
+        self._charm_cls = charm_cls
+        self._charm = None
+        self._charm_dir = 'no-disk-path'  # this may be updated by _create_meta
+        self._meta = self._create_meta(meta, actions)
+        self._unit_name = self._meta.name + '/0'
+        self._framework = None
+        self._hooks_enabled = True
+        self._relation_id_counter = 0
+        self._backend = _TestingModelBackend(self._unit_name, self._meta)
+        self._model = model.Model(self._meta, self._backend)
+        self._storage = storage.SQLiteStorage(':memory:')
+        self._oci_resources = {}
+        self._framework = framework.Framework(
+            self._storage, self._charm_dir, self._meta, self._model)
+        self._update_config(key_values=self._load_config_defaults(config))
+
+    @property
+    def charm(self) -> charm.CharmBase:
+        """Return the instance of the charm class that was passed to __init__.
+
+        Note that the Charm is not instantiated until you have called
+        :meth:`.begin()`.
+        """
+        return self._charm
+
+    @property
+    def model(self) -> model.Model:
+        """Return the :class:`~ops.model.Model` that is being driven by this Harness."""
+        return self._model
+
+    @property
+    def framework(self) -> framework.Framework:
+        """Return the Framework that is being driven by this Harness."""
+        return self._framework
+
+    def begin(self) -> None:
+        """Instantiate the Charm and start handling events.
+
+        Before calling :meth:`begin`, there is no Charm instance, so changes to the Model won't
+        emit events. You must call :meth:`.begin` before :attr:`.charm` is valid.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot call the begin method on the harness more than once')
+
+        # The Framework adds attributes to class objects for events, etc. As such, we can't re-use
+        # the original class against multiple Frameworks. So create a locally defined class
+        # and register it.
+        # TODO: jam 2020-03-16 We are looking to changes this to Instance attributes instead of
+        #       Class attributes which should clean up this ugliness. The API can stay the same
+        class TestEvents(self._charm_cls.on.__class__):
+            pass
+
+        TestEvents.__name__ = self._charm_cls.on.__class__.__name__
+
+        class TestCharm(self._charm_cls):
+            on = TestEvents()
+
+        # Note: jam 2020-03-01 This is so that errors in testing say MyCharm has no attribute foo,
+        # rather than TestCharm has no attribute foo.
+        TestCharm.__name__ = self._charm_cls.__name__
+        self._charm = TestCharm(self._framework)
+
+    def begin_with_initial_hooks(self) -> None:
+        """Called when you want the Harness to fire the same hooks that Juju would fire at startup.
+
+        This triggers install, relation-created, config-changed, start, and any relation-joined
+        hooks. Based on what relations have been defined before you called begin().
+        Note that all of these are fired before returning control to the test suite, so if you
+        want to introspect what happens at each step, you need to fire them directly
+        (eg Charm.on.install.emit()).
+
+        To use this with all the normal hooks, you should instantiate the harness, setup any
+        relations that you want active when the charm starts, and then call this method.
+
+        Example::
+
+            harness = Harness(MyCharm)
+            # Do initial setup here
+            relation_id = harness.add_relation('db', 'postgresql')
+            harness.add_relation_unit(relation_id, 'postgresql/0')
+            harness.update_relation_data(relation_id, 'postgresql/0', {'key': 'val'})
+            harness.set_leader(True)
+            harness.update_config({'initial': 'config'})
+            harness.begin_with_initial_hooks()
+            # This will cause
+            # install, db-relation-created('postgresql'), leader-elected, config-changed, start
+            # db-relation-joined('postrgesql/0'), db-relation-changed('postgresql/0')
+            # To be fired.
+        """
+        self.begin()
+        # TODO: jam 2020-08-03 This should also handle storage-attached hooks once we have support
+        #  for dealing with storage.
+        self._charm.on.install.emit()
+        # Juju itself iterates what relation to fire based on a map[int]relation, so it doesn't
+        # guarantee a stable ordering between relation events. It *does* give a stable ordering
+        # of joined units for a given relation.
+        items = list(self._meta.relations.items())
+        random.shuffle(items)
+        this_app_name = self._meta.name
+        for relname, rel_meta in items:
+            if rel_meta.role == charm.RelationRole.peer:
+                # If the user has directly added a relation, leave it be, but otherwise ensure
+                # that peer relations are always established at before leader-elected.
+                rel_ids = self._backend._relation_ids_map.get(relname)
+                if rel_ids is None:
+                    self.add_relation(relname, self._meta.name)
+                else:
+                    random.shuffle(rel_ids)
+                    for rel_id in rel_ids:
+                        self._emit_relation_created(relname, rel_id, this_app_name)
+            else:
+                rel_ids = self._backend._relation_ids_map.get(relname, [])
+                random.shuffle(rel_ids)
+                for rel_id in rel_ids:
+                    app_name = self._backend._relation_app_and_units[rel_id]["app"]
+                    self._emit_relation_created(relname, rel_id, app_name)
+        if self._backend._is_leader:
+            self._charm.on.leader_elected.emit()
+        else:
+            self._charm.on.leader_settings_changed.emit()
+        self._charm.on.config_changed.emit()
+        self._charm.on.start.emit()
+        all_ids = list(self._backend._relation_names.items())
+        random.shuffle(all_ids)
+        for rel_id, rel_name in all_ids:
+            rel_app_and_units = self._backend._relation_app_and_units[rel_id]
+            app_name = rel_app_and_units["app"]
+            # Note: Juju *does* fire relation events for a given relation in the sorted order of
+            # the unit names. It also always fires relation-changed immediately after
+            # relation-joined for the same unit.
+            # Juju only fires relation-changed (app) if there is data for the related application
+            relation = self._model.get_relation(rel_name, rel_id)
+            if self._backend._relation_data[rel_id].get(app_name):
+                app = self._model.get_app(app_name)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, app, None)
+            for unit_name in sorted(rel_app_and_units["units"]):
+                remote_unit = self._model.get_unit(unit_name)
+                self._charm.on[rel_name].relation_joined.emit(
+                    relation, remote_unit.app, remote_unit)
+                self._charm.on[rel_name].relation_changed.emit(
+                    relation, remote_unit.app, remote_unit)
+
+    def cleanup(self) -> None:
+        """Called by your test infrastructure to cleanup any temporary directories/files/etc.
+
+        Currently this only needs to be called if you test with resources. But it is reasonable
+        to always include a `testcase.addCleanup(harness.cleanup)` just in case.
+        """
+        self._backend._cleanup()
+
+    def _create_meta(self, charm_metadata, action_metadata):
+        """Create a CharmMeta object.
+
+        Handle the cases where a user doesn't supply explicit metadata snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_metadata is None:
+            metadata_path = charm_dir / 'metadata.yaml'
+            if metadata_path.is_file():
+                charm_metadata = metadata_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of metadata that the framework can support
+                charm_metadata = 'name: test-charm'
+        elif isinstance(charm_metadata, str):
+            charm_metadata = dedent(charm_metadata)
+
+        if action_metadata is None:
+            actions_path = charm_dir / 'actions.yaml'
+            if actions_path.is_file():
+                action_metadata = actions_path.read_text()
+                self._charm_dir = charm_dir
+        elif isinstance(action_metadata, str):
+            action_metadata = dedent(action_metadata)
+
+        return charm.CharmMeta.from_yaml(charm_metadata, action_metadata)
+
+    def _load_config_defaults(self, charm_config):
+        """Load default values from config.yaml.
+
+        Handle the case where a user doesn't supply explicit config snippets.
+        """
+        filename = inspect.getfile(self._charm_cls)
+        charm_dir = pathlib.Path(filename).parents[1]
+
+        if charm_config is None:
+            config_path = charm_dir / 'config.yaml'
+            if config_path.is_file():
+                charm_config = config_path.read_text()
+                self._charm_dir = charm_dir
+            else:
+                # The simplest of config that the framework can support
+                charm_config = '{}'
+        elif isinstance(charm_config, str):
+            charm_config = dedent(charm_config)
+        charm_config = yaml.load(charm_config, Loader=yaml.SafeLoader)
+        charm_config = charm_config.get('options', {})
+        return {key: value['default'] for key, value in charm_config.items()
+                if 'default' in value}
+
+    def add_oci_resource(self, resource_name: str,
+                         contents: typing.Mapping[str, str] = None) -> None:
+        """Add oci resources to the backend.
+
+        This will register an oci resource and create a temporary file for processing metadata
+        about the resource. A default set of values will be used for all the file contents
+        unless a specific contents dict is provided.
+
+        Args:
+            resource_name: Name of the resource to add custom contents to.
+            contents: Optional custom dict to write for the named resource.
+        """
+        if not contents:
+            contents = {'registrypath': 'registrypath',
+                        'username': 'username',
+                        'password': 'password',
+                        }
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        if self._meta.resources[resource_name].type != "oci-image":
+            raise RuntimeError('Resource {} is not an OCI Image'.format(resource_name))
+
+        as_yaml = yaml.dump(contents, Dumper=yaml.SafeDumper)
+        self._backend._resources_map[resource_name] = ('contents.yaml', as_yaml)
+
+    def add_resource(self, resource_name: str, content: typing.AnyStr) -> None:
+        """Add content for a resource to the backend.
+
+        This will register the content, so that a call to `Model.resources.fetch(resource_name)`
+        will return a path to a file containing that content.
+
+        Args:
+            resource_name: The name of the resource being added
+            content: Either string or bytes content, which will be the content of the filename
+                returned by resource-get. If contents is a string, it will be encoded in utf-8
+        """
+        if resource_name not in self._meta.resources.keys():
+            raise RuntimeError('Resource {} is not a defined resources'.format(resource_name))
+        record = self._meta.resources[resource_name]
+        if record.type != "file":
+            raise RuntimeError(
+                'Resource {} is not a file, but actually {}'.format(resource_name, record.type))
+        filename = record.filename
+        if filename is None:
+            filename = resource_name
+
+        self._backend._resources_map[resource_name] = (filename, content)
+
+    def populate_oci_resources(self) -> None:
+        """Populate all OCI resources."""
+        for name, data in self._meta.resources.items():
+            if data.type == "oci-image":
+                self.add_oci_resource(name)
+
+    def disable_hooks(self) -> None:
+        """Stop emitting hook events when the model changes.
+
+        This can be used by developers to stop changes to the model from emitting events that
+        the charm will react to. Call :meth:`.enable_hooks`
+        to re-enable them.
+        """
+        self._hooks_enabled = False
+
+    def enable_hooks(self) -> None:
+        """Re-enable hook events from charm.on when the model is changed.
+
+        By default hook events are enabled once you call :meth:`.begin`,
+        but if you have used :meth:`.disable_hooks`, this can be used to
+        enable them again.
+        """
+        self._hooks_enabled = True
+
+    @contextmanager
+    def hooks_disabled(self):
+        """A context manager to run code with hooks disabled.
+
+        Example::
+
+            with harness.hooks_disabled():
+                # things in here don't fire events
+                harness.set_leader(True)
+                harness.update_config(unset=['foo', 'bar'])
+            # things here will again fire events
+        """
+        if self._hooks_enabled:
+            self.disable_hooks()
+            try:
+                yield None
+            finally:
+                self.enable_hooks()
+        else:
+            yield None
+
+    def _next_relation_id(self):
+        rel_id = self._relation_id_counter
+        self._relation_id_counter += 1
+        return rel_id
+
+    def add_relation(self, relation_name: str, remote_app: str) -> int:
+        """Declare that there is a new relation between this app and `remote_app`.
+
+        Args:
+            relation_name: The relation on Charm that is being related to
+            remote_app: The name of the application that is being related to
+
+        Return:
+            The relation_id created by this add_relation.
+        """
+        rel_id = self._next_relation_id()
+        self._backend._relation_ids_map.setdefault(relation_name, []).append(rel_id)
+        self._backend._relation_names[rel_id] = relation_name
+        self._backend._relation_list_map[rel_id] = []
+        self._backend._relation_data[rel_id] = {
+            remote_app: {},
+            self._backend.unit_name: {},
+            self._backend.app_name: {},
+        }
+        self._backend._relation_app_and_units[rel_id] = {
+            "app": remote_app,
+            "units": [],
+        }
+        # Reload the relation_ids list
+        if self._model is not None:
+            self._model.relations._invalidate(relation_name)
+        self._emit_relation_created(relation_name, rel_id, remote_app)
+        return rel_id
+
+    def _emit_relation_created(self, relation_name: str, relation_id: int,
+                               remote_app: str) -> None:
+        """Trigger relation-created for a given relation with a given remote application."""
+        if self._charm is None or not self._hooks_enabled:
+            return
+        if self._charm is None or not self._hooks_enabled:
+            return
+        relation = self._model.get_relation(relation_name, relation_id)
+        app = self._model.get_app(remote_app)
+        self._charm.on[relation_name].relation_created.emit(
+            relation, app)
+
+    def add_relation_unit(self, relation_id: int, remote_unit_name: str) -> None:
+        """Add a new unit to a relation.
+
+        Example::
+
+          rel_id = harness.add_relation('db', 'postgresql')
+          harness.add_relation_unit(rel_id, 'postgresql/0')
+
+        This will trigger a `relation_joined` event. This would naturally be
+        followed by a `relation_changed` event, which you can trigger with
+        :meth:`.update_relation_data`. This separation is artificial in the
+        sense that Juju will always fire the two, but is intended to make
+        testing relations and their data bags slightly more natural.
+
+        Args:
+            relation_id: The integer relation identifier (as returned by add_relation).
+            remote_unit_name: A string representing the remote unit that is being added.
+
+        Return:
+            None
+        """
+        self._backend._relation_list_map[relation_id].append(remote_unit_name)
+        self._backend._relation_data[relation_id][remote_unit_name] = {}
+        # TODO: jam 2020-08-03 This is where we could assert that the unit name matches the
+        #  application name (eg you don't have a relation to 'foo' but add units of 'bar/0'
+        self._backend._relation_app_and_units[relation_id]["units"].append(remote_unit_name)
+        relation_name = self._backend._relation_names[relation_id]
+        # Make sure that the Model reloads the relation_list for this relation_id, as well as
+        # reloading the relation data for this unit.
+        if self._model is not None:
+            remote_unit = self._model.get_unit(remote_unit_name)
+            relation = self._model.get_relation(relation_name, relation_id)
+            unit_cache = relation.data.get(remote_unit, None)
+            if unit_cache is not None:
+                unit_cache._invalidate()
+            self._model.relations._invalidate(relation_name)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on[relation_name].relation_joined.emit(
+            relation, remote_unit.app, remote_unit)
+
+    def get_relation_data(self, relation_id: int, app_or_unit: str) -> typing.Mapping:
+        """Get the relation data bucket for a single app or unit in a given relation.
+
+        This ignores all of the safety checks of who can and can't see data in relations (eg,
+        non-leaders can't read their own application's relation data because there are no events
+        that keep that data up-to-date for the unit).
+
+        Args:
+            relation_id: The relation whose content we want to look at.
+            app_or_unit: The name of the application or unit whose data we want to read
+        Return:
+            a dict containing the relation data for `app_or_unit` or None.
+
+        Raises:
+            KeyError: if relation_id doesn't exist
+        """
+        return self._backend._relation_data[relation_id].get(app_or_unit, None)
+
+    def get_pod_spec(self) -> (typing.Mapping, typing.Mapping):
+        """Return the content of the pod spec as last set by the charm.
+
+        This returns both the pod spec and any k8s_resources that were supplied.
+        See the signature of Model.pod.set_spec
+        """
+        return self._backend._pod_spec
+
+    def get_workload_version(self) -> str:
+        """Read the workload version that was set by the unit."""
+        return self._backend._workload_version
+
+    def set_model_name(self, name: str) -> None:
+        """Set the name of the Model that this is representing.
+
+        This cannot be called once begin() has been called. But it lets you set the value that
+        will be returned by Model.name.
+        """
+        if self._charm is not None:
+            raise RuntimeError('cannot set the Model name after begin()')
+        self._backend.model_name = name
+
+    def update_relation_data(
+            self,
+            relation_id: int,
+            app_or_unit: str,
+            key_values: typing.Mapping,
+    ) -> None:
+        """Update the relation data for a given unit or application in a given relation.
+
+        This also triggers the `relation_changed` event for this relation_id.
+
+        Args:
+            relation_id: The integer relation_id representing this relation.
+            app_or_unit: The unit or application name that is being updated.
+                This can be the local or remote application.
+            key_values: Each key/value will be updated in the relation data.
+        """
+        relation_name = self._backend._relation_names[relation_id]
+        relation = self._model.get_relation(relation_name, relation_id)
+        if '/' in app_or_unit:
+            entity = self._model.get_unit(app_or_unit)
+        else:
+            entity = self._model.get_app(app_or_unit)
+        rel_data = relation.data.get(entity, None)
+        if rel_data is not None:
+            # rel_data may have cached now-stale data, so _invalidate() it.
+            # Note, this won't cause the data to be loaded if it wasn't already.
+            rel_data._invalidate()
+
+        new_values = self._backend._relation_data[relation_id][app_or_unit].copy()
+        for k, v in key_values.items():
+            if v == '':
+                new_values.pop(k, None)
+            else:
+                new_values[k] = v
+        self._backend._relation_data[relation_id][app_or_unit] = new_values
+
+        if app_or_unit == self._model.unit.name:
+            # No events for our own unit
+            return
+        if app_or_unit == self._model.app.name:
+            # updating our own app only generates an event if it is a peer relation and we
+            # aren't the leader
+            is_peer = self._meta.relations[relation_name].role.is_peer()
+            if not is_peer:
+                return
+            if self._model.unit.is_leader():
+                return
+        self._emit_relation_changed(relation_id, app_or_unit)
+
+    def _emit_relation_changed(self, relation_id, app_or_unit):
+        if self._charm is None or not self._hooks_enabled:
+            return
+        rel_name = self._backend._relation_names[relation_id]
+        relation = self.model.get_relation(rel_name, relation_id)
+        if '/' in app_or_unit:
+            app_name = app_or_unit.split('/')[0]
+            unit_name = app_or_unit
+            app = self.model.get_app(app_name)
+            unit = self.model.get_unit(unit_name)
+            args = (relation, app, unit)
+        else:
+            app_name = app_or_unit
+            app = self.model.get_app(app_name)
+            args = (relation, app)
+        self._charm.on[rel_name].relation_changed.emit(*args)
+
+    def _update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will *not* trigger a `config_changed` event, and is intended for internal use.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        # NOTE: jam 2020-03-01 Note that this sort of works "by accident". Config
+        # is a LazyMapping, but its _load returns a dict and this method mutates
+        # the dict that Config is caching. Arguably we should be doing some sort
+        # of charm.framework.model.config._invalidate()
+        config = self._backend._config
+        if key_values is not None:
+            for key, value in key_values.items():
+                config[key] = value
+        for key in unset:
+            config.pop(key, None)
+
+    def update_config(
+            self,
+            key_values: typing.Mapping[str, str] = None,
+            unset: typing.Iterable[str] = (),
+    ) -> None:
+        """Update the config as seen by the charm.
+
+        This will trigger a `config_changed` event.
+
+        Note that the `key_values` mapping will only add or update configuration items.
+        To remove existing ones, see the `unset` parameter.
+
+        Args:
+            key_values: A Mapping of key:value pairs to update in config.
+            unset: An iterable of keys to remove from Config. (Note that this does
+                not currently reset the config values to the default defined in config.yaml.)
+        """
+        self._update_config(key_values, unset)
+        if self._charm is None or not self._hooks_enabled:
+            return
+        self._charm.on.config_changed.emit()
+
+    def set_leader(self, is_leader: bool = True) -> None:
+        """Set whether this unit is the leader or not.
+
+        If this charm becomes a leader then `leader_elected` will be triggered.
+
+        Args:
+            is_leader: True/False as to whether this unit is the leader.
+        """
+        was_leader = self._backend._is_leader
+        self._backend._is_leader = is_leader
+        # Note: jam 2020-03-01 currently is_leader is cached at the ModelBackend level, not in
+        # the Model objects, so this automatically gets noticed.
+        if is_leader and not was_leader and self._charm is not None and self._hooks_enabled:
+            self._charm.on.leader_elected.emit()
+
+    def _get_backend_calls(self, reset: bool = True) -> list:
+        """Return the calls that we have made to the TestingModelBackend.
+
+        This is useful mostly for testing the framework itself, so that we can assert that we
+        do/don't trigger extra calls.
+
+        Args:
+            reset: If True, reset the calls list back to empty, if false, the call list is
+                preserved.
+
+        Return:
+            ``[(call1, args...), (call2, args...)]``
+        """
+        calls = self._backend._calls.copy()
+        if reset:
+            self._backend._calls.clear()
+        return calls
+
+
+def _record_calls(cls):
+    """Replace methods on cls with methods that record that they have been called.
+
+    Iterate all attributes of cls, and for public methods, replace them with a wrapped method
+    that records the method called along with the arguments and keyword arguments.
+    """
+    for meth_name, orig_method in cls.__dict__.items():
+        if meth_name.startswith('_'):
+            continue
+
+        def decorator(orig_method):
+            def wrapped(self, *args, **kwargs):
+                full_args = (orig_method.__name__,) + args
+                if kwargs:
+                    full_args = full_args + (kwargs,)
+                self._calls.append(full_args)
+                return orig_method(self, *args, **kwargs)
+            return wrapped
+
+        setattr(cls, meth_name, decorator(orig_method))
+    return cls
+
+
+class _ResourceEntry:
+    """Tracks the contents of a Resource."""
+
+    def __init__(self, resource_name):
+        self.name = resource_name
+
+
+@_record_calls
+class _TestingModelBackend:
+    """This conforms to the interface for ModelBackend but provides canned data.
+
+    DO NOT use this class directly, it is used by `Harness`_ to drive the model.
+    `Harness`_ is responsible for maintaining the internal consistency of the values here,
+    as the only public methods of this type are for implementing ModelBackend.
+    """
+
+    def __init__(self, unit_name, meta):
+        self.unit_name = unit_name
+        self.app_name = self.unit_name.split('/')[0]
+        self.model_name = None
+        self._calls = []
+        self._meta = meta
+        self._is_leader = None
+        self._relation_ids_map = {}  # relation name to [relation_ids,...]
+        self._relation_names = {}  # reverse map from relation_id to relation_name
+        self._relation_list_map = {}  # relation_id: [unit_name,...]
+        self._relation_data = {}  # {relation_id: {name: data}}
+        # {relation_id: {"app": app_name, "units": ["app/0",...]}
+        self._relation_app_and_units = {}
+        self._config = {}
+        self._is_leader = False
+        self._resources_map = {}  # {resource_name: resource_content}
+        self._pod_spec = None
+        self._app_status = {'status': 'unknown', 'message': ''}
+        self._unit_status = {'status': 'maintenance', 'message': ''}
+        self._workload_version = None
+        self._resource_dir = None
+
+    def _cleanup(self):
+        if self._resource_dir is not None:
+            self._resource_dir.cleanup()
+            self._resource_dir = None
+
+    def _get_resource_dir(self) -> pathlib.Path:
+        if self._resource_dir is None:
+            # In actual Juju, the resource path for a charm's resource is
+            # $AGENT_DIR/resources/$RESOURCE_NAME/$RESOURCE_FILENAME
+            # However, charms shouldn't depend on this.
+            self._resource_dir = tempfile.TemporaryDirectory(prefix='tmp-ops-test-resource-')
+        return pathlib.Path(self._resource_dir.name)
+
+    def relation_ids(self, relation_name):
+        try:
+            return self._relation_ids_map[relation_name]
+        except KeyError as e:
+            if relation_name not in self._meta.relations:
+                raise model.ModelError('{} is not a known relation'.format(relation_name)) from e
+            return []
+
+    def relation_list(self, relation_id):
+        try:
+            return self._relation_list_map[relation_id]
+        except KeyError as e:
+            raise model.RelationNotFoundError from e
+
+    def relation_get(self, relation_id, member_name, is_app):
+        if is_app and '/' in member_name:
+            member_name = member_name.split('/')[0]
+        if relation_id not in self._relation_data:
+            raise model.RelationNotFoundError()
+        return self._relation_data[relation_id][member_name].copy()
+
+    def relation_set(self, relation_id, key, value, is_app):
+        relation = self._relation_data[relation_id]
+        if is_app:
+            bucket_key = self.app_name
+        else:
+            bucket_key = self.unit_name
+        if bucket_key not in relation:
+            relation[bucket_key] = {}
+        bucket = relation[bucket_key]
+        if value == '':
+            bucket.pop(key, None)
+        else:
+            bucket[key] = value
+
+    def config_get(self):
+        return self._config
+
+    def is_leader(self):
+        return self._is_leader
+
+    def application_version_set(self, version):
+        self._workload_version = version
+
+    def resource_get(self, resource_name):
+        if resource_name not in self._resources_map:
+            raise model.ModelError(
+                "ERROR could not download resource: HTTP request failed: "
+                "Get https://.../units/unit-{}/resources/{}: resource#{}/{} not found".format(
+                    self.unit_name.replace('/', '-'), resource_name, self.app_name, resource_name
+                ))
+        filename, contents = self._resources_map[resource_name]
+        resource_dir = self._get_resource_dir()
+        resource_filename = resource_dir / resource_name / filename
+        if not resource_filename.exists():
+            if isinstance(contents, bytes):
+                mode = 'wb'
+            else:
+                mode = 'wt'
+            resource_filename.parent.mkdir(exist_ok=True)
+            with resource_filename.open(mode=mode) as resource_file:
+                resource_file.write(contents)
+        return resource_filename
+
+    def pod_spec_set(self, spec, k8s_resources):
+        self._pod_spec = (spec, k8s_resources)
+
+    def status_get(self, *, is_app=False):
+        if is_app:
+            return self._app_status
+        else:
+            return self._unit_status
+
+    def status_set(self, status, message='', *, is_app=False):
+        if is_app:
+            self._app_status = {'status': status, 'message': message}
+        else:
+            self._unit_status = {'status': status, 'message': message}
+
+    def storage_list(self, name):
+        raise NotImplementedError(self.storage_list)
+
+    def storage_get(self, storage_name_id, attribute):
+        raise NotImplementedError(self.storage_get)
+
+    def storage_add(self, name, count=1):
+        raise NotImplementedError(self.storage_add)
+
+    def action_get(self):
+        raise NotImplementedError(self.action_get)
+
+    def action_set(self, results):
+        raise NotImplementedError(self.action_set)
+
+    def action_log(self, message):
+        raise NotImplementedError(self.action_log)
+
+    def action_fail(self, message=''):
+        raise NotImplementedError(self.action_fail)
+
+    def network_get(self, endpoint_name, relation_id=None):
+        raise NotImplementedError(self.network_get)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/ops/version.py b/SOL004/magma/squid_cnf/charms/squid/venv/ops/version.py
new file mode 100644
index 0000000000000000000000000000000000000000..db9e98175100d8045815d0ee215d2f5f76ad468f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/ops/version.py
@@ -0,0 +1,3 @@
+# this is a generated file
+
+version = '1.1.0'
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/__init__.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/__init__.py
new file mode 100644
index 0000000000000000000000000000000000000000..13d687c501c854057404469446c680231fbc92e5
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/__init__.py
@@ -0,0 +1,427 @@
+
+from .error import *
+
+from .tokens import *
+from .events import *
+from .nodes import *
+
+from .loader import *
+from .dumper import *
+
+__version__ = '5.3.1'
+try:
+    from .cyaml import *
+    __with_libyaml__ = True
+except ImportError:
+    __with_libyaml__ = False
+
+import io
+
+#------------------------------------------------------------------------------
+# Warnings control
+#------------------------------------------------------------------------------
+
+# 'Global' warnings state:
+_warnings_enabled = {
+    'YAMLLoadWarning': True,
+}
+
+# Get or set global warnings' state
+def warnings(settings=None):
+    if settings is None:
+        return _warnings_enabled
+
+    if type(settings) is dict:
+        for key in settings:
+            if key in _warnings_enabled:
+                _warnings_enabled[key] = settings[key]
+
+# Warn when load() is called without Loader=...
+class YAMLLoadWarning(RuntimeWarning):
+    pass
+
+def load_warning(method):
+    if _warnings_enabled['YAMLLoadWarning'] is False:
+        return
+
+    import warnings
+
+    message = (
+        "calling yaml.%s() without Loader=... is deprecated, as the "
+        "default Loader is unsafe. Please read "
+        "https://msg.pyyaml.org/load for full details."
+    ) % method
+
+    warnings.warn(message, YAMLLoadWarning, stacklevel=3)
+
+#------------------------------------------------------------------------------
+def scan(stream, Loader=Loader):
+    """
+    Scan a YAML stream and produce scanning tokens.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_token():
+            yield loader.get_token()
+    finally:
+        loader.dispose()
+
+def parse(stream, Loader=Loader):
+    """
+    Parse a YAML stream and produce parsing events.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_event():
+            yield loader.get_event()
+    finally:
+        loader.dispose()
+
+def compose(stream, Loader=Loader):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding representation tree.
+    """
+    loader = Loader(stream)
+    try:
+        return loader.get_single_node()
+    finally:
+        loader.dispose()
+
+def compose_all(stream, Loader=Loader):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding representation trees.
+    """
+    loader = Loader(stream)
+    try:
+        while loader.check_node():
+            yield loader.get_node()
+    finally:
+        loader.dispose()
+
+def load(stream, Loader=None):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+    """
+    if Loader is None:
+        load_warning('load')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        return loader.get_single_data()
+    finally:
+        loader.dispose()
+
+def load_all(stream, Loader=None):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+    """
+    if Loader is None:
+        load_warning('load_all')
+        Loader = FullLoader
+
+    loader = Loader(stream)
+    try:
+        while loader.check_data():
+            yield loader.get_data()
+    finally:
+        loader.dispose()
+
+def full_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, FullLoader)
+
+def full_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags except those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, FullLoader)
+
+def safe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load(stream, SafeLoader)
+
+def safe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve only basic YAML tags. This is known
+    to be safe for untrusted input.
+    """
+    return load_all(stream, SafeLoader)
+
+def unsafe_load(stream):
+    """
+    Parse the first YAML document in a stream
+    and produce the corresponding Python object.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load(stream, UnsafeLoader)
+
+def unsafe_load_all(stream):
+    """
+    Parse all YAML documents in a stream
+    and produce corresponding Python objects.
+
+    Resolve all tags, even those known to be
+    unsafe on untrusted input.
+    """
+    return load_all(stream, UnsafeLoader)
+
+def emit(events, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None):
+    """
+    Emit YAML parsing events into a stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        stream = io.StringIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break)
+    try:
+        for event in events:
+            dumper.emit(event)
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize_all(nodes, stream=None, Dumper=Dumper,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None):
+    """
+    Serialize a sequence of representation trees into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end)
+    try:
+        dumper.open()
+        for node in nodes:
+            dumper.serialize(node)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def serialize(node, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a representation tree into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return serialize_all([node], stream, Dumper=Dumper, **kwds)
+
+def dump_all(documents, stream=None, Dumper=Dumper,
+        default_style=None, default_flow_style=False,
+        canonical=None, indent=None, width=None,
+        allow_unicode=None, line_break=None,
+        encoding=None, explicit_start=None, explicit_end=None,
+        version=None, tags=None, sort_keys=True):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    getvalue = None
+    if stream is None:
+        if encoding is None:
+            stream = io.StringIO()
+        else:
+            stream = io.BytesIO()
+        getvalue = stream.getvalue
+    dumper = Dumper(stream, default_style=default_style,
+            default_flow_style=default_flow_style,
+            canonical=canonical, indent=indent, width=width,
+            allow_unicode=allow_unicode, line_break=line_break,
+            encoding=encoding, version=version, tags=tags,
+            explicit_start=explicit_start, explicit_end=explicit_end, sort_keys=sort_keys)
+    try:
+        dumper.open()
+        for data in documents:
+            dumper.represent(data)
+        dumper.close()
+    finally:
+        dumper.dispose()
+    if getvalue:
+        return getvalue()
+
+def dump(data, stream=None, Dumper=Dumper, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=Dumper, **kwds)
+
+def safe_dump_all(documents, stream=None, **kwds):
+    """
+    Serialize a sequence of Python objects into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all(documents, stream, Dumper=SafeDumper, **kwds)
+
+def safe_dump(data, stream=None, **kwds):
+    """
+    Serialize a Python object into a YAML stream.
+    Produce only basic YAML tags.
+    If stream is None, return the produced string instead.
+    """
+    return dump_all([data], stream, Dumper=SafeDumper, **kwds)
+
+def add_implicit_resolver(tag, regexp, first=None,
+        Loader=None, Dumper=Dumper):
+    """
+    Add an implicit scalar detector.
+    If an implicit scalar value matches the given regexp,
+    the corresponding tag is assigned to the scalar.
+    first is a sequence of possible initial characters or None.
+    """
+    if Loader is None:
+        loader.Loader.add_implicit_resolver(tag, regexp, first)
+        loader.FullLoader.add_implicit_resolver(tag, regexp, first)
+        loader.UnsafeLoader.add_implicit_resolver(tag, regexp, first)
+    else:
+        Loader.add_implicit_resolver(tag, regexp, first)
+    Dumper.add_implicit_resolver(tag, regexp, first)
+
+def add_path_resolver(tag, path, kind=None, Loader=None, Dumper=Dumper):
+    """
+    Add a path based resolver for the given tag.
+    A path is a list of keys that forms a path
+    to a node in the representation tree.
+    Keys can be string values, integers, or None.
+    """
+    if Loader is None:
+        loader.Loader.add_path_resolver(tag, path, kind)
+        loader.FullLoader.add_path_resolver(tag, path, kind)
+        loader.UnsafeLoader.add_path_resolver(tag, path, kind)
+    else:
+        Loader.add_path_resolver(tag, path, kind)
+    Dumper.add_path_resolver(tag, path, kind)
+
+def add_constructor(tag, constructor, Loader=None):
+    """
+    Add a constructor for the given tag.
+    Constructor is a function that accepts a Loader instance
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_constructor(tag, constructor)
+        loader.FullLoader.add_constructor(tag, constructor)
+        loader.UnsafeLoader.add_constructor(tag, constructor)
+    else:
+        Loader.add_constructor(tag, constructor)
+
+def add_multi_constructor(tag_prefix, multi_constructor, Loader=None):
+    """
+    Add a multi-constructor for the given tag prefix.
+    Multi-constructor is called for a node if its tag starts with tag_prefix.
+    Multi-constructor accepts a Loader instance, a tag suffix,
+    and a node object and produces the corresponding Python object.
+    """
+    if Loader is None:
+        loader.Loader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.FullLoader.add_multi_constructor(tag_prefix, multi_constructor)
+        loader.UnsafeLoader.add_multi_constructor(tag_prefix, multi_constructor)
+    else:
+        Loader.add_multi_constructor(tag_prefix, multi_constructor)
+
+def add_representer(data_type, representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Representer is a function accepting a Dumper instance
+    and an instance of the given data type
+    and producing the corresponding representation node.
+    """
+    Dumper.add_representer(data_type, representer)
+
+def add_multi_representer(data_type, multi_representer, Dumper=Dumper):
+    """
+    Add a representer for the given type.
+    Multi-representer is a function accepting a Dumper instance
+    and an instance of the given data type or subtype
+    and producing the corresponding representation node.
+    """
+    Dumper.add_multi_representer(data_type, multi_representer)
+
+class YAMLObjectMetaclass(type):
+    """
+    The metaclass for YAMLObject.
+    """
+    def __init__(cls, name, bases, kwds):
+        super(YAMLObjectMetaclass, cls).__init__(name, bases, kwds)
+        if 'yaml_tag' in kwds and kwds['yaml_tag'] is not None:
+            if isinstance(cls.yaml_loader, list):
+                for loader in cls.yaml_loader:
+                    loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+            else:
+                cls.yaml_loader.add_constructor(cls.yaml_tag, cls.from_yaml)
+
+            cls.yaml_dumper.add_representer(cls, cls.to_yaml)
+
+class YAMLObject(metaclass=YAMLObjectMetaclass):
+    """
+    An object that can dump itself to a YAML stream
+    and load itself from a YAML stream.
+    """
+
+    __slots__ = ()  # no direct instantiation, so allow immutable subclasses
+
+    yaml_loader = [Loader, FullLoader, UnsafeLoader]
+    yaml_dumper = Dumper
+
+    yaml_tag = None
+    yaml_flow_style = None
+
+    @classmethod
+    def from_yaml(cls, loader, node):
+        """
+        Convert a representation node to a Python object.
+        """
+        return loader.construct_yaml_object(node, cls)
+
+    @classmethod
+    def to_yaml(cls, dumper, data):
+        """
+        Convert a Python object to a representation node.
+        """
+        return dumper.represent_yaml_object(cls.yaml_tag, data, cls,
+                flow_style=cls.yaml_flow_style)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/composer.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/composer.py
new file mode 100644
index 0000000000000000000000000000000000000000..6d15cb40e3b4198819c91c6f8d8b32807fcf53b2
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/composer.py
@@ -0,0 +1,139 @@
+
+__all__ = ['Composer', 'ComposerError']
+
+from .error import MarkedYAMLError
+from .events import *
+from .nodes import *
+
+class ComposerError(MarkedYAMLError):
+    pass
+
+class Composer:
+
+    def __init__(self):
+        self.anchors = {}
+
+    def check_node(self):
+        # Drop the STREAM-START event.
+        if self.check_event(StreamStartEvent):
+            self.get_event()
+
+        # If there are more documents available?
+        return not self.check_event(StreamEndEvent)
+
+    def get_node(self):
+        # Get the root node of the next document.
+        if not self.check_event(StreamEndEvent):
+            return self.compose_document()
+
+    def get_single_node(self):
+        # Drop the STREAM-START event.
+        self.get_event()
+
+        # Compose a document if the stream is not empty.
+        document = None
+        if not self.check_event(StreamEndEvent):
+            document = self.compose_document()
+
+        # Ensure that the stream contains no more documents.
+        if not self.check_event(StreamEndEvent):
+            event = self.get_event()
+            raise ComposerError("expected a single document in the stream",
+                    document.start_mark, "but found another document",
+                    event.start_mark)
+
+        # Drop the STREAM-END event.
+        self.get_event()
+
+        return document
+
+    def compose_document(self):
+        # Drop the DOCUMENT-START event.
+        self.get_event()
+
+        # Compose the root node.
+        node = self.compose_node(None, None)
+
+        # Drop the DOCUMENT-END event.
+        self.get_event()
+
+        self.anchors = {}
+        return node
+
+    def compose_node(self, parent, index):
+        if self.check_event(AliasEvent):
+            event = self.get_event()
+            anchor = event.anchor
+            if anchor not in self.anchors:
+                raise ComposerError(None, None, "found undefined alias %r"
+                        % anchor, event.start_mark)
+            return self.anchors[anchor]
+        event = self.peek_event()
+        anchor = event.anchor
+        if anchor is not None:
+            if anchor in self.anchors:
+                raise ComposerError("found duplicate anchor %r; first occurrence"
+                        % anchor, self.anchors[anchor].start_mark,
+                        "second occurrence", event.start_mark)
+        self.descend_resolver(parent, index)
+        if self.check_event(ScalarEvent):
+            node = self.compose_scalar_node(anchor)
+        elif self.check_event(SequenceStartEvent):
+            node = self.compose_sequence_node(anchor)
+        elif self.check_event(MappingStartEvent):
+            node = self.compose_mapping_node(anchor)
+        self.ascend_resolver()
+        return node
+
+    def compose_scalar_node(self, anchor):
+        event = self.get_event()
+        tag = event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(ScalarNode, event.value, event.implicit)
+        node = ScalarNode(tag, event.value,
+                event.start_mark, event.end_mark, style=event.style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        return node
+
+    def compose_sequence_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(SequenceNode, None, start_event.implicit)
+        node = SequenceNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        index = 0
+        while not self.check_event(SequenceEndEvent):
+            node.value.append(self.compose_node(node, index))
+            index += 1
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
+    def compose_mapping_node(self, anchor):
+        start_event = self.get_event()
+        tag = start_event.tag
+        if tag is None or tag == '!':
+            tag = self.resolve(MappingNode, None, start_event.implicit)
+        node = MappingNode(tag, [],
+                start_event.start_mark, None,
+                flow_style=start_event.flow_style)
+        if anchor is not None:
+            self.anchors[anchor] = node
+        while not self.check_event(MappingEndEvent):
+            #key_event = self.peek_event()
+            item_key = self.compose_node(node, None)
+            #if item_key in node.value:
+            #    raise ComposerError("while composing a mapping", start_event.start_mark,
+            #            "found duplicate key", key_event.start_mark)
+            item_value = self.compose_node(node, item_key)
+            #node.value[item_key] = item_value
+            node.value.append((item_key, item_value))
+        end_event = self.get_event()
+        node.end_mark = end_event.end_mark
+        return node
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/constructor.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/constructor.py
new file mode 100644
index 0000000000000000000000000000000000000000..1948b125c205261864156b18178c1af3f535ad76
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/constructor.py
@@ -0,0 +1,748 @@
+
+__all__ = [
+    'BaseConstructor',
+    'SafeConstructor',
+    'FullConstructor',
+    'UnsafeConstructor',
+    'Constructor',
+    'ConstructorError'
+]
+
+from .error import *
+from .nodes import *
+
+import collections.abc, datetime, base64, binascii, re, sys, types
+
+class ConstructorError(MarkedYAMLError):
+    pass
+
+class BaseConstructor:
+
+    yaml_constructors = {}
+    yaml_multi_constructors = {}
+
+    def __init__(self):
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.state_generators = []
+        self.deep_construct = False
+
+    def check_data(self):
+        # If there are more documents available?
+        return self.check_node()
+
+    def check_state_key(self, key):
+        """Block special attributes/methods from being set in a newly created
+        object, to prevent user-controlled methods from being called during
+        deserialization"""
+        if self.get_state_keys_blacklist_regexp().match(key):
+            raise ConstructorError(None, None,
+                "blacklisted key '%s' in instance state found" % (key,), None)
+
+    def get_data(self):
+        # Construct and return the next document.
+        if self.check_node():
+            return self.construct_document(self.get_node())
+
+    def get_single_data(self):
+        # Ensure that the stream contains a single document and construct it.
+        node = self.get_single_node()
+        if node is not None:
+            return self.construct_document(node)
+        return None
+
+    def construct_document(self, node):
+        data = self.construct_object(node)
+        while self.state_generators:
+            state_generators = self.state_generators
+            self.state_generators = []
+            for generator in state_generators:
+                for dummy in generator:
+                    pass
+        self.constructed_objects = {}
+        self.recursive_objects = {}
+        self.deep_construct = False
+        return data
+
+    def construct_object(self, node, deep=False):
+        if node in self.constructed_objects:
+            return self.constructed_objects[node]
+        if deep:
+            old_deep = self.deep_construct
+            self.deep_construct = True
+        if node in self.recursive_objects:
+            raise ConstructorError(None, None,
+                    "found unconstructable recursive node", node.start_mark)
+        self.recursive_objects[node] = None
+        constructor = None
+        tag_suffix = None
+        if node.tag in self.yaml_constructors:
+            constructor = self.yaml_constructors[node.tag]
+        else:
+            for tag_prefix in self.yaml_multi_constructors:
+                if tag_prefix is not None and node.tag.startswith(tag_prefix):
+                    tag_suffix = node.tag[len(tag_prefix):]
+                    constructor = self.yaml_multi_constructors[tag_prefix]
+                    break
+            else:
+                if None in self.yaml_multi_constructors:
+                    tag_suffix = node.tag
+                    constructor = self.yaml_multi_constructors[None]
+                elif None in self.yaml_constructors:
+                    constructor = self.yaml_constructors[None]
+                elif isinstance(node, ScalarNode):
+                    constructor = self.__class__.construct_scalar
+                elif isinstance(node, SequenceNode):
+                    constructor = self.__class__.construct_sequence
+                elif isinstance(node, MappingNode):
+                    constructor = self.__class__.construct_mapping
+        if tag_suffix is None:
+            data = constructor(self, node)
+        else:
+            data = constructor(self, tag_suffix, node)
+        if isinstance(data, types.GeneratorType):
+            generator = data
+            data = next(generator)
+            if self.deep_construct:
+                for dummy in generator:
+                    pass
+            else:
+                self.state_generators.append(generator)
+        self.constructed_objects[node] = data
+        del self.recursive_objects[node]
+        if deep:
+            self.deep_construct = old_deep
+        return data
+
+    def construct_scalar(self, node):
+        if not isinstance(node, ScalarNode):
+            raise ConstructorError(None, None,
+                    "expected a scalar node, but found %s" % node.id,
+                    node.start_mark)
+        return node.value
+
+    def construct_sequence(self, node, deep=False):
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError(None, None,
+                    "expected a sequence node, but found %s" % node.id,
+                    node.start_mark)
+        return [self.construct_object(child, deep=deep)
+                for child in node.value]
+
+    def construct_mapping(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        mapping = {}
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            if not isinstance(key, collections.abc.Hashable):
+                raise ConstructorError("while constructing a mapping", node.start_mark,
+                        "found unhashable key", key_node.start_mark)
+            value = self.construct_object(value_node, deep=deep)
+            mapping[key] = value
+        return mapping
+
+    def construct_pairs(self, node, deep=False):
+        if not isinstance(node, MappingNode):
+            raise ConstructorError(None, None,
+                    "expected a mapping node, but found %s" % node.id,
+                    node.start_mark)
+        pairs = []
+        for key_node, value_node in node.value:
+            key = self.construct_object(key_node, deep=deep)
+            value = self.construct_object(value_node, deep=deep)
+            pairs.append((key, value))
+        return pairs
+
+    @classmethod
+    def add_constructor(cls, tag, constructor):
+        if not 'yaml_constructors' in cls.__dict__:
+            cls.yaml_constructors = cls.yaml_constructors.copy()
+        cls.yaml_constructors[tag] = constructor
+
+    @classmethod
+    def add_multi_constructor(cls, tag_prefix, multi_constructor):
+        if not 'yaml_multi_constructors' in cls.__dict__:
+            cls.yaml_multi_constructors = cls.yaml_multi_constructors.copy()
+        cls.yaml_multi_constructors[tag_prefix] = multi_constructor
+
+class SafeConstructor(BaseConstructor):
+
+    def construct_scalar(self, node):
+        if isinstance(node, MappingNode):
+            for key_node, value_node in node.value:
+                if key_node.tag == 'tag:yaml.org,2002:value':
+                    return self.construct_scalar(value_node)
+        return super().construct_scalar(node)
+
+    def flatten_mapping(self, node):
+        merge = []
+        index = 0
+        while index < len(node.value):
+            key_node, value_node = node.value[index]
+            if key_node.tag == 'tag:yaml.org,2002:merge':
+                del node.value[index]
+                if isinstance(value_node, MappingNode):
+                    self.flatten_mapping(value_node)
+                    merge.extend(value_node.value)
+                elif isinstance(value_node, SequenceNode):
+                    submerge = []
+                    for subnode in value_node.value:
+                        if not isinstance(subnode, MappingNode):
+                            raise ConstructorError("while constructing a mapping",
+                                    node.start_mark,
+                                    "expected a mapping for merging, but found %s"
+                                    % subnode.id, subnode.start_mark)
+                        self.flatten_mapping(subnode)
+                        submerge.append(subnode.value)
+                    submerge.reverse()
+                    for value in submerge:
+                        merge.extend(value)
+                else:
+                    raise ConstructorError("while constructing a mapping", node.start_mark,
+                            "expected a mapping or list of mappings for merging, but found %s"
+                            % value_node.id, value_node.start_mark)
+            elif key_node.tag == 'tag:yaml.org,2002:value':
+                key_node.tag = 'tag:yaml.org,2002:str'
+                index += 1
+            else:
+                index += 1
+        if merge:
+            node.value = merge + node.value
+
+    def construct_mapping(self, node, deep=False):
+        if isinstance(node, MappingNode):
+            self.flatten_mapping(node)
+        return super().construct_mapping(node, deep=deep)
+
+    def construct_yaml_null(self, node):
+        self.construct_scalar(node)
+        return None
+
+    bool_values = {
+        'yes':      True,
+        'no':       False,
+        'true':     True,
+        'false':    False,
+        'on':       True,
+        'off':      False,
+    }
+
+    def construct_yaml_bool(self, node):
+        value = self.construct_scalar(node)
+        return self.bool_values[value.lower()]
+
+    def construct_yaml_int(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '')
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '0':
+            return 0
+        elif value.startswith('0b'):
+            return sign*int(value[2:], 2)
+        elif value.startswith('0x'):
+            return sign*int(value[2:], 16)
+        elif value[0] == '0':
+            return sign*int(value, 8)
+        elif ':' in value:
+            digits = [int(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*int(value)
+
+    inf_value = 1e300
+    while inf_value != inf_value*inf_value:
+        inf_value *= inf_value
+    nan_value = -inf_value/inf_value   # Trying to make a quiet NaN (like C99).
+
+    def construct_yaml_float(self, node):
+        value = self.construct_scalar(node)
+        value = value.replace('_', '').lower()
+        sign = +1
+        if value[0] == '-':
+            sign = -1
+        if value[0] in '+-':
+            value = value[1:]
+        if value == '.inf':
+            return sign*self.inf_value
+        elif value == '.nan':
+            return self.nan_value
+        elif ':' in value:
+            digits = [float(part) for part in value.split(':')]
+            digits.reverse()
+            base = 1
+            value = 0.0
+            for digit in digits:
+                value += digit*base
+                base *= 60
+            return sign*value
+        else:
+            return sign*float(value)
+
+    def construct_yaml_binary(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    timestamp_regexp = re.compile(
+            r'''^(?P<year>[0-9][0-9][0-9][0-9])
+                -(?P<month>[0-9][0-9]?)
+                -(?P<day>[0-9][0-9]?)
+                (?:(?:[Tt]|[ \t]+)
+                (?P<hour>[0-9][0-9]?)
+                :(?P<minute>[0-9][0-9])
+                :(?P<second>[0-9][0-9])
+                (?:\.(?P<fraction>[0-9]*))?
+                (?:[ \t]*(?P<tz>Z|(?P<tz_sign>[-+])(?P<tz_hour>[0-9][0-9]?)
+                (?::(?P<tz_minute>[0-9][0-9]))?))?)?$''', re.X)
+
+    def construct_yaml_timestamp(self, node):
+        value = self.construct_scalar(node)
+        match = self.timestamp_regexp.match(node.value)
+        values = match.groupdict()
+        year = int(values['year'])
+        month = int(values['month'])
+        day = int(values['day'])
+        if not values['hour']:
+            return datetime.date(year, month, day)
+        hour = int(values['hour'])
+        minute = int(values['minute'])
+        second = int(values['second'])
+        fraction = 0
+        tzinfo = None
+        if values['fraction']:
+            fraction = values['fraction'][:6]
+            while len(fraction) < 6:
+                fraction += '0'
+            fraction = int(fraction)
+        if values['tz_sign']:
+            tz_hour = int(values['tz_hour'])
+            tz_minute = int(values['tz_minute'] or 0)
+            delta = datetime.timedelta(hours=tz_hour, minutes=tz_minute)
+            if values['tz_sign'] == '-':
+                delta = -delta
+            tzinfo = datetime.timezone(delta)
+        elif values['tz']:
+            tzinfo = datetime.timezone.utc
+        return datetime.datetime(year, month, day, hour, minute, second, fraction,
+                                 tzinfo=tzinfo)
+
+    def construct_yaml_omap(self, node):
+        # Note: we do not check for duplicate keys, because it's too
+        # CPU-expensive.
+        omap = []
+        yield omap
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing an ordered map", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing an ordered map", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            omap.append((key, value))
+
+    def construct_yaml_pairs(self, node):
+        # Note: the same code as `construct_yaml_omap`.
+        pairs = []
+        yield pairs
+        if not isinstance(node, SequenceNode):
+            raise ConstructorError("while constructing pairs", node.start_mark,
+                    "expected a sequence, but found %s" % node.id, node.start_mark)
+        for subnode in node.value:
+            if not isinstance(subnode, MappingNode):
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a mapping of length 1, but found %s" % subnode.id,
+                        subnode.start_mark)
+            if len(subnode.value) != 1:
+                raise ConstructorError("while constructing pairs", node.start_mark,
+                        "expected a single mapping item, but found %d items" % len(subnode.value),
+                        subnode.start_mark)
+            key_node, value_node = subnode.value[0]
+            key = self.construct_object(key_node)
+            value = self.construct_object(value_node)
+            pairs.append((key, value))
+
+    def construct_yaml_set(self, node):
+        data = set()
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_yaml_seq(self, node):
+        data = []
+        yield data
+        data.extend(self.construct_sequence(node))
+
+    def construct_yaml_map(self, node):
+        data = {}
+        yield data
+        value = self.construct_mapping(node)
+        data.update(value)
+
+    def construct_yaml_object(self, node, cls):
+        data = cls.__new__(cls)
+        yield data
+        if hasattr(data, '__setstate__'):
+            state = self.construct_mapping(node, deep=True)
+            data.__setstate__(state)
+        else:
+            state = self.construct_mapping(node)
+            data.__dict__.update(state)
+
+    def construct_undefined(self, node):
+        raise ConstructorError(None, None,
+                "could not determine a constructor for the tag %r" % node.tag,
+                node.start_mark)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:null',
+        SafeConstructor.construct_yaml_null)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:bool',
+        SafeConstructor.construct_yaml_bool)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:int',
+        SafeConstructor.construct_yaml_int)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:float',
+        SafeConstructor.construct_yaml_float)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:binary',
+        SafeConstructor.construct_yaml_binary)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:timestamp',
+        SafeConstructor.construct_yaml_timestamp)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:omap',
+        SafeConstructor.construct_yaml_omap)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:pairs',
+        SafeConstructor.construct_yaml_pairs)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:set',
+        SafeConstructor.construct_yaml_set)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:str',
+        SafeConstructor.construct_yaml_str)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:seq',
+        SafeConstructor.construct_yaml_seq)
+
+SafeConstructor.add_constructor(
+        'tag:yaml.org,2002:map',
+        SafeConstructor.construct_yaml_map)
+
+SafeConstructor.add_constructor(None,
+        SafeConstructor.construct_undefined)
+
+class FullConstructor(SafeConstructor):
+    # 'extend' is blacklisted because it is used by
+    # construct_python_object_apply to add `listitems` to a newly generate
+    # python instance
+    def get_state_keys_blacklist(self):
+        return ['^extend$', '^__.*__$']
+
+    def get_state_keys_blacklist_regexp(self):
+        if not hasattr(self, 'state_keys_blacklist_regexp'):
+            self.state_keys_blacklist_regexp = re.compile('(' + '|'.join(self.get_state_keys_blacklist()) + ')')
+        return self.state_keys_blacklist_regexp
+
+    def construct_python_str(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_unicode(self, node):
+        return self.construct_scalar(node)
+
+    def construct_python_bytes(self, node):
+        try:
+            value = self.construct_scalar(node).encode('ascii')
+        except UnicodeEncodeError as exc:
+            raise ConstructorError(None, None,
+                    "failed to convert base64 data into ascii: %s" % exc,
+                    node.start_mark)
+        try:
+            if hasattr(base64, 'decodebytes'):
+                return base64.decodebytes(value)
+            else:
+                return base64.decodestring(value)
+        except binascii.Error as exc:
+            raise ConstructorError(None, None,
+                    "failed to decode base64 data: %s" % exc, node.start_mark)
+
+    def construct_python_long(self, node):
+        return self.construct_yaml_int(node)
+
+    def construct_python_complex(self, node):
+       return complex(self.construct_scalar(node))
+
+    def construct_python_tuple(self, node):
+        return tuple(self.construct_sequence(node))
+
+    def find_python_module(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if unsafe:
+            try:
+                __import__(name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python module", mark,
+                        "cannot find module %r (%s)" % (name, exc), mark)
+        if name not in sys.modules:
+            raise ConstructorError("while constructing a Python module", mark,
+                    "module %r is not imported" % name, mark)
+        return sys.modules[name]
+
+    def find_python_name(self, name, mark, unsafe=False):
+        if not name:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "expected non-empty name appended to the tag", mark)
+        if '.' in name:
+            module_name, object_name = name.rsplit('.', 1)
+        else:
+            module_name = 'builtins'
+            object_name = name
+        if unsafe:
+            try:
+                __import__(module_name)
+            except ImportError as exc:
+                raise ConstructorError("while constructing a Python object", mark,
+                        "cannot find module %r (%s)" % (module_name, exc), mark)
+        if module_name not in sys.modules:
+            raise ConstructorError("while constructing a Python object", mark,
+                    "module %r is not imported" % module_name, mark)
+        module = sys.modules[module_name]
+        if not hasattr(module, object_name):
+            raise ConstructorError("while constructing a Python object", mark,
+                    "cannot find %r in the module %r"
+                    % (object_name, module.__name__), mark)
+        return getattr(module, object_name)
+
+    def construct_python_name(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python name", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_name(suffix, node.start_mark)
+
+    def construct_python_module(self, suffix, node):
+        value = self.construct_scalar(node)
+        if value:
+            raise ConstructorError("while constructing a Python module", node.start_mark,
+                    "expected the empty value, but found %r" % value, node.start_mark)
+        return self.find_python_module(suffix, node.start_mark)
+
+    def make_python_instance(self, suffix, node,
+            args=None, kwds=None, newobj=False, unsafe=False):
+        if not args:
+            args = []
+        if not kwds:
+            kwds = {}
+        cls = self.find_python_name(suffix, node.start_mark)
+        if not (unsafe or isinstance(cls, type)):
+            raise ConstructorError("while constructing a Python instance", node.start_mark,
+                    "expected a class, but found %r" % type(cls),
+                    node.start_mark)
+        if newobj and isinstance(cls, type):
+            return cls.__new__(cls, *args, **kwds)
+        else:
+            return cls(*args, **kwds)
+
+    def set_python_instance_state(self, instance, state, unsafe=False):
+        if hasattr(instance, '__setstate__'):
+            instance.__setstate__(state)
+        else:
+            slotstate = {}
+            if isinstance(state, tuple) and len(state) == 2:
+                state, slotstate = state
+            if hasattr(instance, '__dict__'):
+                if not unsafe and state:
+                    for key in state.keys():
+                        self.check_state_key(key)
+                instance.__dict__.update(state)
+            elif state:
+                slotstate.update(state)
+            for key, value in slotstate.items():
+                if not unsafe:
+                    self.check_state_key(key)
+                setattr(instance, key, value)
+
+    def construct_python_object(self, suffix, node):
+        # Format:
+        #   !!python/object:module.name { ... state ... }
+        instance = self.make_python_instance(suffix, node, newobj=True)
+        yield instance
+        deep = hasattr(instance, '__setstate__')
+        state = self.construct_mapping(node, deep=deep)
+        self.set_python_instance_state(instance, state)
+
+    def construct_python_object_apply(self, suffix, node, newobj=False):
+        # Format:
+        #   !!python/object/apply       # (or !!python/object/new)
+        #   args: [ ... arguments ... ]
+        #   kwds: { ... keywords ... }
+        #   state: ... state ...
+        #   listitems: [ ... listitems ... ]
+        #   dictitems: { ... dictitems ... }
+        # or short format:
+        #   !!python/object/apply [ ... arguments ... ]
+        # The difference between !!python/object/apply and !!python/object/new
+        # is how an object is created, check make_python_instance for details.
+        if isinstance(node, SequenceNode):
+            args = self.construct_sequence(node, deep=True)
+            kwds = {}
+            state = {}
+            listitems = []
+            dictitems = {}
+        else:
+            value = self.construct_mapping(node, deep=True)
+            args = value.get('args', [])
+            kwds = value.get('kwds', {})
+            state = value.get('state', {})
+            listitems = value.get('listitems', [])
+            dictitems = value.get('dictitems', {})
+        instance = self.make_python_instance(suffix, node, args, kwds, newobj)
+        if state:
+            self.set_python_instance_state(instance, state)
+        if listitems:
+            instance.extend(listitems)
+        if dictitems:
+            for key in dictitems:
+                instance[key] = dictitems[key]
+        return instance
+
+    def construct_python_object_new(self, suffix, node):
+        return self.construct_python_object_apply(suffix, node, newobj=True)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/none',
+    FullConstructor.construct_yaml_null)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bool',
+    FullConstructor.construct_yaml_bool)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/str',
+    FullConstructor.construct_python_str)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/unicode',
+    FullConstructor.construct_python_unicode)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/bytes',
+    FullConstructor.construct_python_bytes)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/int',
+    FullConstructor.construct_yaml_int)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/long',
+    FullConstructor.construct_python_long)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/float',
+    FullConstructor.construct_yaml_float)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/complex',
+    FullConstructor.construct_python_complex)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/list',
+    FullConstructor.construct_yaml_seq)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/tuple',
+    FullConstructor.construct_python_tuple)
+
+FullConstructor.add_constructor(
+    'tag:yaml.org,2002:python/dict',
+    FullConstructor.construct_yaml_map)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/name:',
+    FullConstructor.construct_python_name)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/module:',
+    FullConstructor.construct_python_module)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object:',
+    FullConstructor.construct_python_object)
+
+FullConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/new:',
+    FullConstructor.construct_python_object_new)
+
+class UnsafeConstructor(FullConstructor):
+
+    def find_python_module(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_module(name, mark, unsafe=True)
+
+    def find_python_name(self, name, mark):
+        return super(UnsafeConstructor, self).find_python_name(name, mark, unsafe=True)
+
+    def make_python_instance(self, suffix, node, args=None, kwds=None, newobj=False):
+        return super(UnsafeConstructor, self).make_python_instance(
+            suffix, node, args, kwds, newobj, unsafe=True)
+
+    def set_python_instance_state(self, instance, state):
+        return super(UnsafeConstructor, self).set_python_instance_state(
+            instance, state, unsafe=True)
+
+UnsafeConstructor.add_multi_constructor(
+    'tag:yaml.org,2002:python/object/apply:',
+    UnsafeConstructor.construct_python_object_apply)
+
+# Constructor is same as UnsafeConstructor. Need to leave this in place in case
+# people have extended it directly.
+class Constructor(UnsafeConstructor):
+    pass
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/cyaml.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/cyaml.py
new file mode 100644
index 0000000000000000000000000000000000000000..1e606c74b9470c3ea0db4bd66629af45d28c2b9a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/cyaml.py
@@ -0,0 +1,101 @@
+
+__all__ = [
+    'CBaseLoader', 'CSafeLoader', 'CFullLoader', 'CUnsafeLoader', 'CLoader',
+    'CBaseDumper', 'CSafeDumper', 'CDumper'
+]
+
+from _yaml import CParser, CEmitter
+
+from .constructor import *
+
+from .serializer import *
+from .representer import *
+
+from .resolver import *
+
+class CBaseLoader(CParser, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class CSafeLoader(CParser, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CFullLoader(CParser, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CUnsafeLoader(CParser, UnsafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        UnsafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class CLoader(CParser, Constructor, Resolver):
+
+    def __init__(self, stream):
+        CParser.__init__(self, stream)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+class CBaseDumper(CEmitter, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CSafeDumper(CEmitter, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class CDumper(CEmitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        CEmitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width, encoding=encoding,
+                allow_unicode=allow_unicode, line_break=line_break,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/dumper.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/dumper.py
new file mode 100644
index 0000000000000000000000000000000000000000..6aadba551f3836b02f4752277f4b3027073defad
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/dumper.py
@@ -0,0 +1,62 @@
+
+__all__ = ['BaseDumper', 'SafeDumper', 'Dumper']
+
+from .emitter import *
+from .serializer import *
+from .representer import *
+from .resolver import *
+
+class BaseDumper(Emitter, Serializer, BaseRepresenter, BaseResolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class SafeDumper(Emitter, Serializer, SafeRepresenter, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        SafeRepresenter.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
+class Dumper(Emitter, Serializer, Representer, Resolver):
+
+    def __init__(self, stream,
+            default_style=None, default_flow_style=False,
+            canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None,
+            encoding=None, explicit_start=None, explicit_end=None,
+            version=None, tags=None, sort_keys=True):
+        Emitter.__init__(self, stream, canonical=canonical,
+                indent=indent, width=width,
+                allow_unicode=allow_unicode, line_break=line_break)
+        Serializer.__init__(self, encoding=encoding,
+                explicit_start=explicit_start, explicit_end=explicit_end,
+                version=version, tags=tags)
+        Representer.__init__(self, default_style=default_style,
+                default_flow_style=default_flow_style, sort_keys=sort_keys)
+        Resolver.__init__(self)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/emitter.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/emitter.py
new file mode 100644
index 0000000000000000000000000000000000000000..a664d011162af69184df2f8e59ab7feec818f7c7
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/emitter.py
@@ -0,0 +1,1137 @@
+
+# Emitter expects events obeying the following grammar:
+# stream ::= STREAM-START document* STREAM-END
+# document ::= DOCUMENT-START node DOCUMENT-END
+# node ::= SCALAR | sequence | mapping
+# sequence ::= SEQUENCE-START node* SEQUENCE-END
+# mapping ::= MAPPING-START (node node)* MAPPING-END
+
+__all__ = ['Emitter', 'EmitterError']
+
+from .error import YAMLError
+from .events import *
+
+class EmitterError(YAMLError):
+    pass
+
+class ScalarAnalysis:
+    def __init__(self, scalar, empty, multiline,
+            allow_flow_plain, allow_block_plain,
+            allow_single_quoted, allow_double_quoted,
+            allow_block):
+        self.scalar = scalar
+        self.empty = empty
+        self.multiline = multiline
+        self.allow_flow_plain = allow_flow_plain
+        self.allow_block_plain = allow_block_plain
+        self.allow_single_quoted = allow_single_quoted
+        self.allow_double_quoted = allow_double_quoted
+        self.allow_block = allow_block
+
+class Emitter:
+
+    DEFAULT_TAG_PREFIXES = {
+        '!' : '!',
+        'tag:yaml.org,2002:' : '!!',
+    }
+
+    def __init__(self, stream, canonical=None, indent=None, width=None,
+            allow_unicode=None, line_break=None):
+
+        # The stream should have the methods `write` and possibly `flush`.
+        self.stream = stream
+
+        # Encoding can be overridden by STREAM-START.
+        self.encoding = None
+
+        # Emitter is a state machine with a stack of states to handle nested
+        # structures.
+        self.states = []
+        self.state = self.expect_stream_start
+
+        # Current event and the event queue.
+        self.events = []
+        self.event = None
+
+        # The current indentation level and the stack of previous indents.
+        self.indents = []
+        self.indent = None
+
+        # Flow level.
+        self.flow_level = 0
+
+        # Contexts.
+        self.root_context = False
+        self.sequence_context = False
+        self.mapping_context = False
+        self.simple_key_context = False
+
+        # Characteristics of the last emitted character:
+        #  - current position.
+        #  - is it a whitespace?
+        #  - is it an indention character
+        #    (indentation space, '-', '?', or ':')?
+        self.line = 0
+        self.column = 0
+        self.whitespace = True
+        self.indention = True
+
+        # Whether the document requires an explicit document indicator
+        self.open_ended = False
+
+        # Formatting details.
+        self.canonical = canonical
+        self.allow_unicode = allow_unicode
+        self.best_indent = 2
+        if indent and 1 < indent < 10:
+            self.best_indent = indent
+        self.best_width = 80
+        if width and width > self.best_indent*2:
+            self.best_width = width
+        self.best_line_break = '\n'
+        if line_break in ['\r', '\n', '\r\n']:
+            self.best_line_break = line_break
+
+        # Tag prefixes.
+        self.tag_prefixes = None
+
+        # Prepared anchor and tag.
+        self.prepared_anchor = None
+        self.prepared_tag = None
+
+        # Scalar analysis and style.
+        self.analysis = None
+        self.style = None
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def emit(self, event):
+        self.events.append(event)
+        while not self.need_more_events():
+            self.event = self.events.pop(0)
+            self.state()
+            self.event = None
+
+    # In some cases, we wait for a few next events before emitting.
+
+    def need_more_events(self):
+        if not self.events:
+            return True
+        event = self.events[0]
+        if isinstance(event, DocumentStartEvent):
+            return self.need_events(1)
+        elif isinstance(event, SequenceStartEvent):
+            return self.need_events(2)
+        elif isinstance(event, MappingStartEvent):
+            return self.need_events(3)
+        else:
+            return False
+
+    def need_events(self, count):
+        level = 0
+        for event in self.events[1:]:
+            if isinstance(event, (DocumentStartEvent, CollectionStartEvent)):
+                level += 1
+            elif isinstance(event, (DocumentEndEvent, CollectionEndEvent)):
+                level -= 1
+            elif isinstance(event, StreamEndEvent):
+                level = -1
+            if level < 0:
+                return False
+        return (len(self.events) < count+1)
+
+    def increase_indent(self, flow=False, indentless=False):
+        self.indents.append(self.indent)
+        if self.indent is None:
+            if flow:
+                self.indent = self.best_indent
+            else:
+                self.indent = 0
+        elif not indentless:
+            self.indent += self.best_indent
+
+    # States.
+
+    # Stream handlers.
+
+    def expect_stream_start(self):
+        if isinstance(self.event, StreamStartEvent):
+            if self.event.encoding and not hasattr(self.stream, 'encoding'):
+                self.encoding = self.event.encoding
+            self.write_stream_start()
+            self.state = self.expect_first_document_start
+        else:
+            raise EmitterError("expected StreamStartEvent, but got %s"
+                    % self.event)
+
+    def expect_nothing(self):
+        raise EmitterError("expected nothing, but got %s" % self.event)
+
+    # Document handlers.
+
+    def expect_first_document_start(self):
+        return self.expect_document_start(first=True)
+
+    def expect_document_start(self, first=False):
+        if isinstance(self.event, DocumentStartEvent):
+            if (self.event.version or self.event.tags) and self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            if self.event.version:
+                version_text = self.prepare_version(self.event.version)
+                self.write_version_directive(version_text)
+            self.tag_prefixes = self.DEFAULT_TAG_PREFIXES.copy()
+            if self.event.tags:
+                handles = sorted(self.event.tags.keys())
+                for handle in handles:
+                    prefix = self.event.tags[handle]
+                    self.tag_prefixes[prefix] = handle
+                    handle_text = self.prepare_tag_handle(handle)
+                    prefix_text = self.prepare_tag_prefix(prefix)
+                    self.write_tag_directive(handle_text, prefix_text)
+            implicit = (first and not self.event.explicit and not self.canonical
+                    and not self.event.version and not self.event.tags
+                    and not self.check_empty_document())
+            if not implicit:
+                self.write_indent()
+                self.write_indicator('---', True)
+                if self.canonical:
+                    self.write_indent()
+            self.state = self.expect_document_root
+        elif isinstance(self.event, StreamEndEvent):
+            if self.open_ended:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.write_stream_end()
+            self.state = self.expect_nothing
+        else:
+            raise EmitterError("expected DocumentStartEvent, but got %s"
+                    % self.event)
+
+    def expect_document_end(self):
+        if isinstance(self.event, DocumentEndEvent):
+            self.write_indent()
+            if self.event.explicit:
+                self.write_indicator('...', True)
+                self.write_indent()
+            self.flush_stream()
+            self.state = self.expect_document_start
+        else:
+            raise EmitterError("expected DocumentEndEvent, but got %s"
+                    % self.event)
+
+    def expect_document_root(self):
+        self.states.append(self.expect_document_end)
+        self.expect_node(root=True)
+
+    # Node handlers.
+
+    def expect_node(self, root=False, sequence=False, mapping=False,
+            simple_key=False):
+        self.root_context = root
+        self.sequence_context = sequence
+        self.mapping_context = mapping
+        self.simple_key_context = simple_key
+        if isinstance(self.event, AliasEvent):
+            self.expect_alias()
+        elif isinstance(self.event, (ScalarEvent, CollectionStartEvent)):
+            self.process_anchor('&')
+            self.process_tag()
+            if isinstance(self.event, ScalarEvent):
+                self.expect_scalar()
+            elif isinstance(self.event, SequenceStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_sequence():
+                    self.expect_flow_sequence()
+                else:
+                    self.expect_block_sequence()
+            elif isinstance(self.event, MappingStartEvent):
+                if self.flow_level or self.canonical or self.event.flow_style   \
+                        or self.check_empty_mapping():
+                    self.expect_flow_mapping()
+                else:
+                    self.expect_block_mapping()
+        else:
+            raise EmitterError("expected NodeEvent, but got %s" % self.event)
+
+    def expect_alias(self):
+        if self.event.anchor is None:
+            raise EmitterError("anchor is not specified for alias")
+        self.process_anchor('*')
+        self.state = self.states.pop()
+
+    def expect_scalar(self):
+        self.increase_indent(flow=True)
+        self.process_scalar()
+        self.indent = self.indents.pop()
+        self.state = self.states.pop()
+
+    # Flow sequence handlers.
+
+    def expect_flow_sequence(self):
+        self.write_indicator('[', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_sequence_item
+
+    def expect_first_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    def expect_flow_sequence_item(self):
+        if isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator(']', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            self.states.append(self.expect_flow_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Flow mapping handlers.
+
+    def expect_flow_mapping(self):
+        self.write_indicator('{', True, whitespace=True)
+        self.flow_level += 1
+        self.increase_indent(flow=True)
+        self.state = self.expect_first_flow_mapping_key
+
+    def expect_first_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_key(self):
+        if isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.flow_level -= 1
+            if self.canonical:
+                self.write_indicator(',', False)
+                self.write_indent()
+            self.write_indicator('}', False)
+            self.state = self.states.pop()
+        else:
+            self.write_indicator(',', False)
+            if self.canonical or self.column > self.best_width:
+                self.write_indent()
+            if not self.canonical and self.check_simple_key():
+                self.states.append(self.expect_flow_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True)
+                self.states.append(self.expect_flow_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_flow_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_flow_mapping_value(self):
+        if self.canonical or self.column > self.best_width:
+            self.write_indent()
+        self.write_indicator(':', True)
+        self.states.append(self.expect_flow_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Block sequence handlers.
+
+    def expect_block_sequence(self):
+        indentless = (self.mapping_context and not self.indention)
+        self.increase_indent(flow=False, indentless=indentless)
+        self.state = self.expect_first_block_sequence_item
+
+    def expect_first_block_sequence_item(self):
+        return self.expect_block_sequence_item(first=True)
+
+    def expect_block_sequence_item(self, first=False):
+        if not first and isinstance(self.event, SequenceEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            self.write_indicator('-', True, indention=True)
+            self.states.append(self.expect_block_sequence_item)
+            self.expect_node(sequence=True)
+
+    # Block mapping handlers.
+
+    def expect_block_mapping(self):
+        self.increase_indent(flow=False)
+        self.state = self.expect_first_block_mapping_key
+
+    def expect_first_block_mapping_key(self):
+        return self.expect_block_mapping_key(first=True)
+
+    def expect_block_mapping_key(self, first=False):
+        if not first and isinstance(self.event, MappingEndEvent):
+            self.indent = self.indents.pop()
+            self.state = self.states.pop()
+        else:
+            self.write_indent()
+            if self.check_simple_key():
+                self.states.append(self.expect_block_mapping_simple_value)
+                self.expect_node(mapping=True, simple_key=True)
+            else:
+                self.write_indicator('?', True, indention=True)
+                self.states.append(self.expect_block_mapping_value)
+                self.expect_node(mapping=True)
+
+    def expect_block_mapping_simple_value(self):
+        self.write_indicator(':', False)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    def expect_block_mapping_value(self):
+        self.write_indent()
+        self.write_indicator(':', True, indention=True)
+        self.states.append(self.expect_block_mapping_key)
+        self.expect_node(mapping=True)
+
+    # Checkers.
+
+    def check_empty_sequence(self):
+        return (isinstance(self.event, SequenceStartEvent) and self.events
+                and isinstance(self.events[0], SequenceEndEvent))
+
+    def check_empty_mapping(self):
+        return (isinstance(self.event, MappingStartEvent) and self.events
+                and isinstance(self.events[0], MappingEndEvent))
+
+    def check_empty_document(self):
+        if not isinstance(self.event, DocumentStartEvent) or not self.events:
+            return False
+        event = self.events[0]
+        return (isinstance(event, ScalarEvent) and event.anchor is None
+                and event.tag is None and event.implicit and event.value == '')
+
+    def check_simple_key(self):
+        length = 0
+        if isinstance(self.event, NodeEvent) and self.event.anchor is not None:
+            if self.prepared_anchor is None:
+                self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+            length += len(self.prepared_anchor)
+        if isinstance(self.event, (ScalarEvent, CollectionStartEvent))  \
+                and self.event.tag is not None:
+            if self.prepared_tag is None:
+                self.prepared_tag = self.prepare_tag(self.event.tag)
+            length += len(self.prepared_tag)
+        if isinstance(self.event, ScalarEvent):
+            if self.analysis is None:
+                self.analysis = self.analyze_scalar(self.event.value)
+            length += len(self.analysis.scalar)
+        return (length < 128 and (isinstance(self.event, AliasEvent)
+            or (isinstance(self.event, ScalarEvent)
+                    and not self.analysis.empty and not self.analysis.multiline)
+            or self.check_empty_sequence() or self.check_empty_mapping()))
+
+    # Anchor, Tag, and Scalar processors.
+
+    def process_anchor(self, indicator):
+        if self.event.anchor is None:
+            self.prepared_anchor = None
+            return
+        if self.prepared_anchor is None:
+            self.prepared_anchor = self.prepare_anchor(self.event.anchor)
+        if self.prepared_anchor:
+            self.write_indicator(indicator+self.prepared_anchor, True)
+        self.prepared_anchor = None
+
+    def process_tag(self):
+        tag = self.event.tag
+        if isinstance(self.event, ScalarEvent):
+            if self.style is None:
+                self.style = self.choose_scalar_style()
+            if ((not self.canonical or tag is None) and
+                ((self.style == '' and self.event.implicit[0])
+                        or (self.style != '' and self.event.implicit[1]))):
+                self.prepared_tag = None
+                return
+            if self.event.implicit[0] and tag is None:
+                tag = '!'
+                self.prepared_tag = None
+        else:
+            if (not self.canonical or tag is None) and self.event.implicit:
+                self.prepared_tag = None
+                return
+        if tag is None:
+            raise EmitterError("tag is not specified")
+        if self.prepared_tag is None:
+            self.prepared_tag = self.prepare_tag(tag)
+        if self.prepared_tag:
+            self.write_indicator(self.prepared_tag, True)
+        self.prepared_tag = None
+
+    def choose_scalar_style(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.event.style == '"' or self.canonical:
+            return '"'
+        if not self.event.style and self.event.implicit[0]:
+            if (not (self.simple_key_context and
+                    (self.analysis.empty or self.analysis.multiline))
+                and (self.flow_level and self.analysis.allow_flow_plain
+                    or (not self.flow_level and self.analysis.allow_block_plain))):
+                return ''
+        if self.event.style and self.event.style in '|>':
+            if (not self.flow_level and not self.simple_key_context
+                    and self.analysis.allow_block):
+                return self.event.style
+        if not self.event.style or self.event.style == '\'':
+            if (self.analysis.allow_single_quoted and
+                    not (self.simple_key_context and self.analysis.multiline)):
+                return '\''
+        return '"'
+
+    def process_scalar(self):
+        if self.analysis is None:
+            self.analysis = self.analyze_scalar(self.event.value)
+        if self.style is None:
+            self.style = self.choose_scalar_style()
+        split = (not self.simple_key_context)
+        #if self.analysis.multiline and split    \
+        #        and (not self.style or self.style in '\'\"'):
+        #    self.write_indent()
+        if self.style == '"':
+            self.write_double_quoted(self.analysis.scalar, split)
+        elif self.style == '\'':
+            self.write_single_quoted(self.analysis.scalar, split)
+        elif self.style == '>':
+            self.write_folded(self.analysis.scalar)
+        elif self.style == '|':
+            self.write_literal(self.analysis.scalar)
+        else:
+            self.write_plain(self.analysis.scalar, split)
+        self.analysis = None
+        self.style = None
+
+    # Analyzers.
+
+    def prepare_version(self, version):
+        major, minor = version
+        if major != 1:
+            raise EmitterError("unsupported YAML version: %d.%d" % (major, minor))
+        return '%d.%d' % (major, minor)
+
+    def prepare_tag_handle(self, handle):
+        if not handle:
+            raise EmitterError("tag handle must not be empty")
+        if handle[0] != '!' or handle[-1] != '!':
+            raise EmitterError("tag handle must start and end with '!': %r" % handle)
+        for ch in handle[1:-1]:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the tag handle: %r"
+                        % (ch, handle))
+        return handle
+
+    def prepare_tag_prefix(self, prefix):
+        if not prefix:
+            raise EmitterError("tag prefix must not be empty")
+        chunks = []
+        start = end = 0
+        if prefix[0] == '!':
+            end = 1
+        while end < len(prefix):
+            ch = prefix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?!:@&=+$,_.~*\'()[]':
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(prefix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ord(ch))
+        if start < end:
+            chunks.append(prefix[start:end])
+        return ''.join(chunks)
+
+    def prepare_tag(self, tag):
+        if not tag:
+            raise EmitterError("tag must not be empty")
+        if tag == '!':
+            return tag
+        handle = None
+        suffix = tag
+        prefixes = sorted(self.tag_prefixes.keys())
+        for prefix in prefixes:
+            if tag.startswith(prefix)   \
+                    and (prefix == '!' or len(prefix) < len(tag)):
+                handle = self.tag_prefixes[prefix]
+                suffix = tag[len(prefix):]
+        chunks = []
+        start = end = 0
+        while end < len(suffix):
+            ch = suffix[end]
+            if '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z' \
+                    or ch in '-;/?:@&=+$,_.~*\'()[]'   \
+                    or (ch == '!' and handle != '!'):
+                end += 1
+            else:
+                if start < end:
+                    chunks.append(suffix[start:end])
+                start = end = end+1
+                data = ch.encode('utf-8')
+                for ch in data:
+                    chunks.append('%%%02X' % ch)
+        if start < end:
+            chunks.append(suffix[start:end])
+        suffix_text = ''.join(chunks)
+        if handle:
+            return '%s%s' % (handle, suffix_text)
+        else:
+            return '!<%s>' % suffix_text
+
+    def prepare_anchor(self, anchor):
+        if not anchor:
+            raise EmitterError("anchor must not be empty")
+        for ch in anchor:
+            if not ('0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'    \
+                    or ch in '-_'):
+                raise EmitterError("invalid character %r in the anchor: %r"
+                        % (ch, anchor))
+        return anchor
+
+    def analyze_scalar(self, scalar):
+
+        # Empty scalar is a special case.
+        if not scalar:
+            return ScalarAnalysis(scalar=scalar, empty=True, multiline=False,
+                    allow_flow_plain=False, allow_block_plain=True,
+                    allow_single_quoted=True, allow_double_quoted=True,
+                    allow_block=False)
+
+        # Indicators and special characters.
+        block_indicators = False
+        flow_indicators = False
+        line_breaks = False
+        special_characters = False
+
+        # Important whitespace combinations.
+        leading_space = False
+        leading_break = False
+        trailing_space = False
+        trailing_break = False
+        break_space = False
+        space_break = False
+
+        # Check document indicators.
+        if scalar.startswith('---') or scalar.startswith('...'):
+            block_indicators = True
+            flow_indicators = True
+
+        # First character or preceded by a whitespace.
+        preceded_by_whitespace = True
+
+        # Last character or followed by a whitespace.
+        followed_by_whitespace = (len(scalar) == 1 or
+                scalar[1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # The previous character is a space.
+        previous_space = False
+
+        # The previous character is a break.
+        previous_break = False
+
+        index = 0
+        while index < len(scalar):
+            ch = scalar[index]
+
+            # Check for indicators.
+            if index == 0:
+                # Leading indicators are special characters.
+                if ch in '#,[]{}&*!|>\'\"%@`':
+                    flow_indicators = True
+                    block_indicators = True
+                if ch in '?:':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '-' and followed_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+            else:
+                # Some indicators cannot appear within a scalar as well.
+                if ch in ',?[]{}':
+                    flow_indicators = True
+                if ch == ':':
+                    flow_indicators = True
+                    if followed_by_whitespace:
+                        block_indicators = True
+                if ch == '#' and preceded_by_whitespace:
+                    flow_indicators = True
+                    block_indicators = True
+
+            # Check for line breaks, special, and unicode characters.
+            if ch in '\n\x85\u2028\u2029':
+                line_breaks = True
+            if not (ch == '\n' or '\x20' <= ch <= '\x7E'):
+                if (ch == '\x85' or '\xA0' <= ch <= '\uD7FF'
+                        or '\uE000' <= ch <= '\uFFFD'
+                        or '\U00010000' <= ch < '\U0010ffff') and ch != '\uFEFF':
+                    unicode_characters = True
+                    if not self.allow_unicode:
+                        special_characters = True
+                else:
+                    special_characters = True
+
+            # Detect important whitespace combinations.
+            if ch == ' ':
+                if index == 0:
+                    leading_space = True
+                if index == len(scalar)-1:
+                    trailing_space = True
+                if previous_break:
+                    break_space = True
+                previous_space = True
+                previous_break = False
+            elif ch in '\n\x85\u2028\u2029':
+                if index == 0:
+                    leading_break = True
+                if index == len(scalar)-1:
+                    trailing_break = True
+                if previous_space:
+                    space_break = True
+                previous_space = False
+                previous_break = True
+            else:
+                previous_space = False
+                previous_break = False
+
+            # Prepare for the next character.
+            index += 1
+            preceded_by_whitespace = (ch in '\0 \t\r\n\x85\u2028\u2029')
+            followed_by_whitespace = (index+1 >= len(scalar) or
+                    scalar[index+1] in '\0 \t\r\n\x85\u2028\u2029')
+
+        # Let's decide what styles are allowed.
+        allow_flow_plain = True
+        allow_block_plain = True
+        allow_single_quoted = True
+        allow_double_quoted = True
+        allow_block = True
+
+        # Leading and trailing whitespaces are bad for plain scalars.
+        if (leading_space or leading_break
+                or trailing_space or trailing_break):
+            allow_flow_plain = allow_block_plain = False
+
+        # We do not permit trailing spaces for block scalars.
+        if trailing_space:
+            allow_block = False
+
+        # Spaces at the beginning of a new line are only acceptable for block
+        # scalars.
+        if break_space:
+            allow_flow_plain = allow_block_plain = allow_single_quoted = False
+
+        # Spaces followed by breaks, as well as special character are only
+        # allowed for double quoted scalars.
+        if space_break or special_characters:
+            allow_flow_plain = allow_block_plain =  \
+            allow_single_quoted = allow_block = False
+
+        # Although the plain scalar writer supports breaks, we never emit
+        # multiline plain scalars.
+        if line_breaks:
+            allow_flow_plain = allow_block_plain = False
+
+        # Flow indicators are forbidden for flow plain scalars.
+        if flow_indicators:
+            allow_flow_plain = False
+
+        # Block indicators are forbidden for block plain scalars.
+        if block_indicators:
+            allow_block_plain = False
+
+        return ScalarAnalysis(scalar=scalar,
+                empty=False, multiline=line_breaks,
+                allow_flow_plain=allow_flow_plain,
+                allow_block_plain=allow_block_plain,
+                allow_single_quoted=allow_single_quoted,
+                allow_double_quoted=allow_double_quoted,
+                allow_block=allow_block)
+
+    # Writers.
+
+    def flush_stream(self):
+        if hasattr(self.stream, 'flush'):
+            self.stream.flush()
+
+    def write_stream_start(self):
+        # Write BOM if needed.
+        if self.encoding and self.encoding.startswith('utf-16'):
+            self.stream.write('\uFEFF'.encode(self.encoding))
+
+    def write_stream_end(self):
+        self.flush_stream()
+
+    def write_indicator(self, indicator, need_whitespace,
+            whitespace=False, indention=False):
+        if self.whitespace or not need_whitespace:
+            data = indicator
+        else:
+            data = ' '+indicator
+        self.whitespace = whitespace
+        self.indention = self.indention and indention
+        self.column += len(data)
+        self.open_ended = False
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_indent(self):
+        indent = self.indent or 0
+        if not self.indention or self.column > indent   \
+                or (self.column == indent and not self.whitespace):
+            self.write_line_break()
+        if self.column < indent:
+            self.whitespace = True
+            data = ' '*(indent-self.column)
+            self.column = indent
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+
+    def write_line_break(self, data=None):
+        if data is None:
+            data = self.best_line_break
+        self.whitespace = True
+        self.indention = True
+        self.line += 1
+        self.column = 0
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+
+    def write_version_directive(self, version_text):
+        data = '%%YAML %s' % version_text
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    def write_tag_directive(self, handle_text, prefix_text):
+        data = '%%TAG %s %s' % (handle_text, prefix_text)
+        if self.encoding:
+            data = data.encode(self.encoding)
+        self.stream.write(data)
+        self.write_line_break()
+
+    # Scalar streams.
+
+    def write_single_quoted(self, text, split=True):
+        self.write_indicator('\'', True)
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch is None or ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split   \
+                            and start != 0 and end != len(text):
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029' or ch == '\'':
+                    if start < end:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                        start = end
+            if ch == '\'':
+                data = '\'\''
+                self.column += 2
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                start = end + 1
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+        self.write_indicator('\'', False)
+
+    ESCAPE_REPLACEMENTS = {
+        '\0':       '0',
+        '\x07':     'a',
+        '\x08':     'b',
+        '\x09':     't',
+        '\x0A':     'n',
+        '\x0B':     'v',
+        '\x0C':     'f',
+        '\x0D':     'r',
+        '\x1B':     'e',
+        '\"':       '\"',
+        '\\':       '\\',
+        '\x85':     'N',
+        '\xA0':     '_',
+        '\u2028':   'L',
+        '\u2029':   'P',
+    }
+
+    def write_double_quoted(self, text, split=True):
+        self.write_indicator('"', True)
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if ch is None or ch in '"\\\x85\u2028\u2029\uFEFF' \
+                    or not ('\x20' <= ch <= '\x7E'
+                        or (self.allow_unicode
+                            and ('\xA0' <= ch <= '\uD7FF'
+                                or '\uE000' <= ch <= '\uFFFD'))):
+                if start < end:
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+                if ch is not None:
+                    if ch in self.ESCAPE_REPLACEMENTS:
+                        data = '\\'+self.ESCAPE_REPLACEMENTS[ch]
+                    elif ch <= '\xFF':
+                        data = '\\x%02X' % ord(ch)
+                    elif ch <= '\uFFFF':
+                        data = '\\u%04X' % ord(ch)
+                    else:
+                        data = '\\U%08X' % ord(ch)
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end+1
+            if 0 < end < len(text)-1 and (ch == ' ' or start >= end)    \
+                    and self.column+(end-start) > self.best_width and split:
+                data = text[start:end]+'\\'
+                if start < end:
+                    start = end
+                self.column += len(data)
+                if self.encoding:
+                    data = data.encode(self.encoding)
+                self.stream.write(data)
+                self.write_indent()
+                self.whitespace = False
+                self.indention = False
+                if text[start] == ' ':
+                    data = '\\'
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+            end += 1
+        self.write_indicator('"', False)
+
+    def determine_block_hints(self, text):
+        hints = ''
+        if text:
+            if text[0] in ' \n\x85\u2028\u2029':
+                hints += str(self.best_indent)
+            if text[-1] not in '\n\x85\u2028\u2029':
+                hints += '-'
+            elif len(text) == 1 or text[-2] in '\n\x85\u2028\u2029':
+                hints += '+'
+        return hints
+
+    def write_folded(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('>'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        leading_space = True
+        spaces = False
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    if not leading_space and ch is not None and ch != ' '   \
+                            and text[start] == '\n':
+                        self.write_line_break()
+                    leading_space = (ch == ' ')
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            elif spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width:
+                        self.write_indent()
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+                spaces = (ch == ' ')
+            end += 1
+
+    def write_literal(self, text):
+        hints = self.determine_block_hints(text)
+        self.write_indicator('|'+hints, True)
+        if hints[-1:] == '+':
+            self.open_ended = True
+        self.write_line_break()
+        breaks = True
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if breaks:
+                if ch is None or ch not in '\n\x85\u2028\u2029':
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    if ch is not None:
+                        self.write_indent()
+                    start = end
+            else:
+                if ch is None or ch in '\n\x85\u2028\u2029':
+                    data = text[start:end]
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    if ch is None:
+                        self.write_line_break()
+                    start = end
+            if ch is not None:
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
+
+    def write_plain(self, text, split=True):
+        if self.root_context:
+            self.open_ended = True
+        if not text:
+            return
+        if not self.whitespace:
+            data = ' '
+            self.column += len(data)
+            if self.encoding:
+                data = data.encode(self.encoding)
+            self.stream.write(data)
+        self.whitespace = False
+        self.indention = False
+        spaces = False
+        breaks = False
+        start = end = 0
+        while end <= len(text):
+            ch = None
+            if end < len(text):
+                ch = text[end]
+            if spaces:
+                if ch != ' ':
+                    if start+1 == end and self.column > self.best_width and split:
+                        self.write_indent()
+                        self.whitespace = False
+                        self.indention = False
+                    else:
+                        data = text[start:end]
+                        self.column += len(data)
+                        if self.encoding:
+                            data = data.encode(self.encoding)
+                        self.stream.write(data)
+                    start = end
+            elif breaks:
+                if ch not in '\n\x85\u2028\u2029':
+                    if text[start] == '\n':
+                        self.write_line_break()
+                    for br in text[start:end]:
+                        if br == '\n':
+                            self.write_line_break()
+                        else:
+                            self.write_line_break(br)
+                    self.write_indent()
+                    self.whitespace = False
+                    self.indention = False
+                    start = end
+            else:
+                if ch is None or ch in ' \n\x85\u2028\u2029':
+                    data = text[start:end]
+                    self.column += len(data)
+                    if self.encoding:
+                        data = data.encode(self.encoding)
+                    self.stream.write(data)
+                    start = end
+            if ch is not None:
+                spaces = (ch == ' ')
+                breaks = (ch in '\n\x85\u2028\u2029')
+            end += 1
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/error.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/error.py
new file mode 100644
index 0000000000000000000000000000000000000000..b796b4dc519512c4825ff539a2e6aa20f4d370d0
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/error.py
@@ -0,0 +1,75 @@
+
+__all__ = ['Mark', 'YAMLError', 'MarkedYAMLError']
+
+class Mark:
+
+    def __init__(self, name, index, line, column, buffer, pointer):
+        self.name = name
+        self.index = index
+        self.line = line
+        self.column = column
+        self.buffer = buffer
+        self.pointer = pointer
+
+    def get_snippet(self, indent=4, max_length=75):
+        if self.buffer is None:
+            return None
+        head = ''
+        start = self.pointer
+        while start > 0 and self.buffer[start-1] not in '\0\r\n\x85\u2028\u2029':
+            start -= 1
+            if self.pointer-start > max_length/2-1:
+                head = ' ... '
+                start += 5
+                break
+        tail = ''
+        end = self.pointer
+        while end < len(self.buffer) and self.buffer[end] not in '\0\r\n\x85\u2028\u2029':
+            end += 1
+            if end-self.pointer > max_length/2-1:
+                tail = ' ... '
+                end -= 5
+                break
+        snippet = self.buffer[start:end]
+        return ' '*indent + head + snippet + tail + '\n'  \
+                + ' '*(indent+self.pointer-start+len(head)) + '^'
+
+    def __str__(self):
+        snippet = self.get_snippet()
+        where = "  in \"%s\", line %d, column %d"   \
+                % (self.name, self.line+1, self.column+1)
+        if snippet is not None:
+            where += ":\n"+snippet
+        return where
+
+class YAMLError(Exception):
+    pass
+
+class MarkedYAMLError(YAMLError):
+
+    def __init__(self, context=None, context_mark=None,
+            problem=None, problem_mark=None, note=None):
+        self.context = context
+        self.context_mark = context_mark
+        self.problem = problem
+        self.problem_mark = problem_mark
+        self.note = note
+
+    def __str__(self):
+        lines = []
+        if self.context is not None:
+            lines.append(self.context)
+        if self.context_mark is not None  \
+            and (self.problem is None or self.problem_mark is None
+                    or self.context_mark.name != self.problem_mark.name
+                    or self.context_mark.line != self.problem_mark.line
+                    or self.context_mark.column != self.problem_mark.column):
+            lines.append(str(self.context_mark))
+        if self.problem is not None:
+            lines.append(self.problem)
+        if self.problem_mark is not None:
+            lines.append(str(self.problem_mark))
+        if self.note is not None:
+            lines.append(self.note)
+        return '\n'.join(lines)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/events.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/events.py
new file mode 100644
index 0000000000000000000000000000000000000000..f79ad389cb6c9517e391dcd25534866bc9ccd36a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/events.py
@@ -0,0 +1,86 @@
+
+# Abstract classes.
+
+class Event(object):
+    def __init__(self, start_mark=None, end_mark=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in ['anchor', 'tag', 'implicit', 'value']
+                if hasattr(self, key)]
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+class NodeEvent(Event):
+    def __init__(self, anchor, start_mark=None, end_mark=None):
+        self.anchor = anchor
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class CollectionStartEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, start_mark=None, end_mark=None,
+            flow_style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class CollectionEndEvent(Event):
+    pass
+
+# Implementations.
+
+class StreamStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None, encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndEvent(Event):
+    pass
+
+class DocumentStartEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None, version=None, tags=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+        self.version = version
+        self.tags = tags
+
+class DocumentEndEvent(Event):
+    def __init__(self, start_mark=None, end_mark=None,
+            explicit=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.explicit = explicit
+
+class AliasEvent(NodeEvent):
+    pass
+
+class ScalarEvent(NodeEvent):
+    def __init__(self, anchor, tag, implicit, value,
+            start_mark=None, end_mark=None, style=None):
+        self.anchor = anchor
+        self.tag = tag
+        self.implicit = implicit
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class SequenceStartEvent(CollectionStartEvent):
+    pass
+
+class SequenceEndEvent(CollectionEndEvent):
+    pass
+
+class MappingStartEvent(CollectionStartEvent):
+    pass
+
+class MappingEndEvent(CollectionEndEvent):
+    pass
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/loader.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/loader.py
new file mode 100644
index 0000000000000000000000000000000000000000..e90c11224c38e559cdf0cb205f0692ebd4fb8681
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/loader.py
@@ -0,0 +1,63 @@
+
+__all__ = ['BaseLoader', 'FullLoader', 'SafeLoader', 'Loader', 'UnsafeLoader']
+
+from .reader import *
+from .scanner import *
+from .parser import *
+from .composer import *
+from .constructor import *
+from .resolver import *
+
+class BaseLoader(Reader, Scanner, Parser, Composer, BaseConstructor, BaseResolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        BaseConstructor.__init__(self)
+        BaseResolver.__init__(self)
+
+class FullLoader(Reader, Scanner, Parser, Composer, FullConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        FullConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class SafeLoader(Reader, Scanner, Parser, Composer, SafeConstructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        SafeConstructor.__init__(self)
+        Resolver.__init__(self)
+
+class Loader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
+
+# UnsafeLoader is the same as Loader (which is and was always unsafe on
+# untrusted input). Use of either Loader or UnsafeLoader should be rare, since
+# FullLoad should be able to load almost all YAML safely. Loader is left intact
+# to ensure backwards compatibility.
+class UnsafeLoader(Reader, Scanner, Parser, Composer, Constructor, Resolver):
+
+    def __init__(self, stream):
+        Reader.__init__(self, stream)
+        Scanner.__init__(self)
+        Parser.__init__(self)
+        Composer.__init__(self)
+        Constructor.__init__(self)
+        Resolver.__init__(self)
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/nodes.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/nodes.py
new file mode 100644
index 0000000000000000000000000000000000000000..c4f070c41e1fb1bc01af27d69329e92dded38908
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/nodes.py
@@ -0,0 +1,49 @@
+
+class Node(object):
+    def __init__(self, tag, value, start_mark, end_mark):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        value = self.value
+        #if isinstance(value, list):
+        #    if len(value) == 0:
+        #        value = '<empty>'
+        #    elif len(value) == 1:
+        #        value = '<1 item>'
+        #    else:
+        #        value = '<%d items>' % len(value)
+        #else:
+        #    if len(value) > 75:
+        #        value = repr(value[:70]+u' ... ')
+        #    else:
+        #        value = repr(value)
+        value = repr(value)
+        return '%s(tag=%r, value=%s)' % (self.__class__.__name__, self.tag, value)
+
+class ScalarNode(Node):
+    id = 'scalar'
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
+class CollectionNode(Node):
+    def __init__(self, tag, value,
+            start_mark=None, end_mark=None, flow_style=None):
+        self.tag = tag
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.flow_style = flow_style
+
+class SequenceNode(CollectionNode):
+    id = 'sequence'
+
+class MappingNode(CollectionNode):
+    id = 'mapping'
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/parser.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/parser.py
new file mode 100644
index 0000000000000000000000000000000000000000..13a5995d292045d0f865a99abf692bd35dc87814
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/parser.py
@@ -0,0 +1,589 @@
+
+# The following YAML grammar is LL(1) and is parsed by a recursive descent
+# parser.
+#
+# stream            ::= STREAM-START implicit_document? explicit_document* STREAM-END
+# implicit_document ::= block_node DOCUMENT-END*
+# explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+# block_node_or_indentless_sequence ::=
+#                       ALIAS
+#                       | properties (block_content | indentless_block_sequence)?
+#                       | block_content
+#                       | indentless_block_sequence
+# block_node        ::= ALIAS
+#                       | properties block_content?
+#                       | block_content
+# flow_node         ::= ALIAS
+#                       | properties flow_content?
+#                       | flow_content
+# properties        ::= TAG ANCHOR? | ANCHOR TAG?
+# block_content     ::= block_collection | flow_collection | SCALAR
+# flow_content      ::= flow_collection | SCALAR
+# block_collection  ::= block_sequence | block_mapping
+# flow_collection   ::= flow_sequence | flow_mapping
+# block_sequence    ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+# indentless_sequence   ::= (BLOCK-ENTRY block_node?)+
+# block_mapping     ::= BLOCK-MAPPING_START
+#                       ((KEY block_node_or_indentless_sequence?)?
+#                       (VALUE block_node_or_indentless_sequence?)?)*
+#                       BLOCK-END
+# flow_sequence     ::= FLOW-SEQUENCE-START
+#                       (flow_sequence_entry FLOW-ENTRY)*
+#                       flow_sequence_entry?
+#                       FLOW-SEQUENCE-END
+# flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+# flow_mapping      ::= FLOW-MAPPING-START
+#                       (flow_mapping_entry FLOW-ENTRY)*
+#                       flow_mapping_entry?
+#                       FLOW-MAPPING-END
+# flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+#
+# FIRST sets:
+#
+# stream: { STREAM-START }
+# explicit_document: { DIRECTIVE DOCUMENT-START }
+# implicit_document: FIRST(block_node)
+# block_node: { ALIAS TAG ANCHOR SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_node: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_content: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# flow_content: { FLOW-SEQUENCE-START FLOW-MAPPING-START SCALAR }
+# block_collection: { BLOCK-SEQUENCE-START BLOCK-MAPPING-START }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# block_sequence: { BLOCK-SEQUENCE-START }
+# block_mapping: { BLOCK-MAPPING-START }
+# block_node_or_indentless_sequence: { ALIAS ANCHOR TAG SCALAR BLOCK-SEQUENCE-START BLOCK-MAPPING-START FLOW-SEQUENCE-START FLOW-MAPPING-START BLOCK-ENTRY }
+# indentless_sequence: { ENTRY }
+# flow_collection: { FLOW-SEQUENCE-START FLOW-MAPPING-START }
+# flow_sequence: { FLOW-SEQUENCE-START }
+# flow_mapping: { FLOW-MAPPING-START }
+# flow_sequence_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+# flow_mapping_entry: { ALIAS ANCHOR TAG SCALAR FLOW-SEQUENCE-START FLOW-MAPPING-START KEY }
+
+__all__ = ['Parser', 'ParserError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+from .events import *
+from .scanner import *
+
+class ParserError(MarkedYAMLError):
+    pass
+
+class Parser:
+    # Since writing a recursive-descendant parser is a straightforward task, we
+    # do not give many comments here.
+
+    DEFAULT_TAGS = {
+        '!':   '!',
+        '!!':  'tag:yaml.org,2002:',
+    }
+
+    def __init__(self):
+        self.current_event = None
+        self.yaml_version = None
+        self.tag_handles = {}
+        self.states = []
+        self.marks = []
+        self.state = self.parse_stream_start
+
+    def dispose(self):
+        # Reset the state attributes (to clear self-references)
+        self.states = []
+        self.state = None
+
+    def check_event(self, *choices):
+        # Check the type of the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        if self.current_event is not None:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.current_event, choice):
+                    return True
+        return False
+
+    def peek_event(self):
+        # Get the next event.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        return self.current_event
+
+    def get_event(self):
+        # Get the next event and proceed further.
+        if self.current_event is None:
+            if self.state:
+                self.current_event = self.state()
+        value = self.current_event
+        self.current_event = None
+        return value
+
+    # stream    ::= STREAM-START implicit_document? explicit_document* STREAM-END
+    # implicit_document ::= block_node DOCUMENT-END*
+    # explicit_document ::= DIRECTIVE* DOCUMENT-START block_node? DOCUMENT-END*
+
+    def parse_stream_start(self):
+
+        # Parse the stream start.
+        token = self.get_token()
+        event = StreamStartEvent(token.start_mark, token.end_mark,
+                encoding=token.encoding)
+
+        # Prepare the next state.
+        self.state = self.parse_implicit_document_start
+
+        return event
+
+    def parse_implicit_document_start(self):
+
+        # Parse an implicit document.
+        if not self.check_token(DirectiveToken, DocumentStartToken,
+                StreamEndToken):
+            self.tag_handles = self.DEFAULT_TAGS
+            token = self.peek_token()
+            start_mark = end_mark = token.start_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=False)
+
+            # Prepare the next state.
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_block_node
+
+            return event
+
+        else:
+            return self.parse_document_start()
+
+    def parse_document_start(self):
+
+        # Parse any extra document end indicators.
+        while self.check_token(DocumentEndToken):
+            self.get_token()
+
+        # Parse an explicit document.
+        if not self.check_token(StreamEndToken):
+            token = self.peek_token()
+            start_mark = token.start_mark
+            version, tags = self.process_directives()
+            if not self.check_token(DocumentStartToken):
+                raise ParserError(None, None,
+                        "expected '<document start>', but found %r"
+                        % self.peek_token().id,
+                        self.peek_token().start_mark)
+            token = self.get_token()
+            end_mark = token.end_mark
+            event = DocumentStartEvent(start_mark, end_mark,
+                    explicit=True, version=version, tags=tags)
+            self.states.append(self.parse_document_end)
+            self.state = self.parse_document_content
+        else:
+            # Parse the end of the stream.
+            token = self.get_token()
+            event = StreamEndEvent(token.start_mark, token.end_mark)
+            assert not self.states
+            assert not self.marks
+            self.state = None
+        return event
+
+    def parse_document_end(self):
+
+        # Parse the document end.
+        token = self.peek_token()
+        start_mark = end_mark = token.start_mark
+        explicit = False
+        if self.check_token(DocumentEndToken):
+            token = self.get_token()
+            end_mark = token.end_mark
+            explicit = True
+        event = DocumentEndEvent(start_mark, end_mark,
+                explicit=explicit)
+
+        # Prepare the next state.
+        self.state = self.parse_document_start
+
+        return event
+
+    def parse_document_content(self):
+        if self.check_token(DirectiveToken,
+                DocumentStartToken, DocumentEndToken, StreamEndToken):
+            event = self.process_empty_scalar(self.peek_token().start_mark)
+            self.state = self.states.pop()
+            return event
+        else:
+            return self.parse_block_node()
+
+    def process_directives(self):
+        self.yaml_version = None
+        self.tag_handles = {}
+        while self.check_token(DirectiveToken):
+            token = self.get_token()
+            if token.name == 'YAML':
+                if self.yaml_version is not None:
+                    raise ParserError(None, None,
+                            "found duplicate YAML directive", token.start_mark)
+                major, minor = token.value
+                if major != 1:
+                    raise ParserError(None, None,
+                            "found incompatible YAML document (version 1.* is required)",
+                            token.start_mark)
+                self.yaml_version = token.value
+            elif token.name == 'TAG':
+                handle, prefix = token.value
+                if handle in self.tag_handles:
+                    raise ParserError(None, None,
+                            "duplicate tag handle %r" % handle,
+                            token.start_mark)
+                self.tag_handles[handle] = prefix
+        if self.tag_handles:
+            value = self.yaml_version, self.tag_handles.copy()
+        else:
+            value = self.yaml_version, None
+        for key in self.DEFAULT_TAGS:
+            if key not in self.tag_handles:
+                self.tag_handles[key] = self.DEFAULT_TAGS[key]
+        return value
+
+    # block_node_or_indentless_sequence ::= ALIAS
+    #               | properties (block_content | indentless_block_sequence)?
+    #               | block_content
+    #               | indentless_block_sequence
+    # block_node    ::= ALIAS
+    #                   | properties block_content?
+    #                   | block_content
+    # flow_node     ::= ALIAS
+    #                   | properties flow_content?
+    #                   | flow_content
+    # properties    ::= TAG ANCHOR? | ANCHOR TAG?
+    # block_content     ::= block_collection | flow_collection | SCALAR
+    # flow_content      ::= flow_collection | SCALAR
+    # block_collection  ::= block_sequence | block_mapping
+    # flow_collection   ::= flow_sequence | flow_mapping
+
+    def parse_block_node(self):
+        return self.parse_node(block=True)
+
+    def parse_flow_node(self):
+        return self.parse_node()
+
+    def parse_block_node_or_indentless_sequence(self):
+        return self.parse_node(block=True, indentless_sequence=True)
+
+    def parse_node(self, block=False, indentless_sequence=False):
+        if self.check_token(AliasToken):
+            token = self.get_token()
+            event = AliasEvent(token.value, token.start_mark, token.end_mark)
+            self.state = self.states.pop()
+        else:
+            anchor = None
+            tag = None
+            start_mark = end_mark = tag_mark = None
+            if self.check_token(AnchorToken):
+                token = self.get_token()
+                start_mark = token.start_mark
+                end_mark = token.end_mark
+                anchor = token.value
+                if self.check_token(TagToken):
+                    token = self.get_token()
+                    tag_mark = token.start_mark
+                    end_mark = token.end_mark
+                    tag = token.value
+            elif self.check_token(TagToken):
+                token = self.get_token()
+                start_mark = tag_mark = token.start_mark
+                end_mark = token.end_mark
+                tag = token.value
+                if self.check_token(AnchorToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    anchor = token.value
+            if tag is not None:
+                handle, suffix = tag
+                if handle is not None:
+                    if handle not in self.tag_handles:
+                        raise ParserError("while parsing a node", start_mark,
+                                "found undefined tag handle %r" % handle,
+                                tag_mark)
+                    tag = self.tag_handles[handle]+suffix
+                else:
+                    tag = suffix
+            #if tag == '!':
+            #    raise ParserError("while parsing a node", start_mark,
+            #            "found non-specific tag '!'", tag_mark,
+            #            "Please check 'http://pyyaml.org/wiki/YAMLNonSpecificTag' and share your opinion.")
+            if start_mark is None:
+                start_mark = end_mark = self.peek_token().start_mark
+            event = None
+            implicit = (tag is None or tag == '!')
+            if indentless_sequence and self.check_token(BlockEntryToken):
+                end_mark = self.peek_token().end_mark
+                event = SequenceStartEvent(anchor, tag, implicit,
+                        start_mark, end_mark)
+                self.state = self.parse_indentless_sequence_entry
+            else:
+                if self.check_token(ScalarToken):
+                    token = self.get_token()
+                    end_mark = token.end_mark
+                    if (token.plain and tag is None) or tag == '!':
+                        implicit = (True, False)
+                    elif tag is None:
+                        implicit = (False, True)
+                    else:
+                        implicit = (False, False)
+                    event = ScalarEvent(anchor, tag, implicit, token.value,
+                            start_mark, end_mark, style=token.style)
+                    self.state = self.states.pop()
+                elif self.check_token(FlowSequenceStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_sequence_first_entry
+                elif self.check_token(FlowMappingStartToken):
+                    end_mark = self.peek_token().end_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=True)
+                    self.state = self.parse_flow_mapping_first_key
+                elif block and self.check_token(BlockSequenceStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = SequenceStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_sequence_first_entry
+                elif block and self.check_token(BlockMappingStartToken):
+                    end_mark = self.peek_token().start_mark
+                    event = MappingStartEvent(anchor, tag, implicit,
+                            start_mark, end_mark, flow_style=False)
+                    self.state = self.parse_block_mapping_first_key
+                elif anchor is not None or tag is not None:
+                    # Empty scalars are allowed even if a tag or an anchor is
+                    # specified.
+                    event = ScalarEvent(anchor, tag, (implicit, False), '',
+                            start_mark, end_mark)
+                    self.state = self.states.pop()
+                else:
+                    if block:
+                        node = 'block'
+                    else:
+                        node = 'flow'
+                    token = self.peek_token()
+                    raise ParserError("while parsing a %s node" % node, start_mark,
+                            "expected the node content, but found %r" % token.id,
+                            token.start_mark)
+        return event
+
+    # block_sequence ::= BLOCK-SEQUENCE-START (BLOCK-ENTRY block_node?)* BLOCK-END
+
+    def parse_block_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_sequence_entry()
+
+    def parse_block_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken, BlockEndToken):
+                self.states.append(self.parse_block_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_block_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block collection", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    # indentless_sequence ::= (BLOCK-ENTRY block_node?)+
+
+    def parse_indentless_sequence_entry(self):
+        if self.check_token(BlockEntryToken):
+            token = self.get_token()
+            if not self.check_token(BlockEntryToken,
+                    KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_indentless_sequence_entry)
+                return self.parse_block_node()
+            else:
+                self.state = self.parse_indentless_sequence_entry
+                return self.process_empty_scalar(token.end_mark)
+        token = self.peek_token()
+        event = SequenceEndEvent(token.start_mark, token.start_mark)
+        self.state = self.states.pop()
+        return event
+
+    # block_mapping     ::= BLOCK-MAPPING_START
+    #                       ((KEY block_node_or_indentless_sequence?)?
+    #                       (VALUE block_node_or_indentless_sequence?)?)*
+    #                       BLOCK-END
+
+    def parse_block_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_block_mapping_key()
+
+    def parse_block_mapping_key(self):
+        if self.check_token(KeyToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_value)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_value
+                return self.process_empty_scalar(token.end_mark)
+        if not self.check_token(BlockEndToken):
+            token = self.peek_token()
+            raise ParserError("while parsing a block mapping", self.marks[-1],
+                    "expected <block end>, but found %r" % token.id, token.start_mark)
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_block_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(KeyToken, ValueToken, BlockEndToken):
+                self.states.append(self.parse_block_mapping_key)
+                return self.parse_block_node_or_indentless_sequence()
+            else:
+                self.state = self.parse_block_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_block_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    # flow_sequence     ::= FLOW-SEQUENCE-START
+    #                       (flow_sequence_entry FLOW-ENTRY)*
+    #                       flow_sequence_entry?
+    #                       FLOW-SEQUENCE-END
+    # flow_sequence_entry   ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+    #
+    # Note that while production rules for both flow_sequence_entry and
+    # flow_mapping_entry are equal, their interpretations are different.
+    # For `flow_sequence_entry`, the part `KEY flow_node? (VALUE flow_node?)?`
+    # generate an inline mapping (set syntax).
+
+    def parse_flow_sequence_first_entry(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_sequence_entry(first=True)
+
+    def parse_flow_sequence_entry(self, first=False):
+        if not self.check_token(FlowSequenceEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow sequence", self.marks[-1],
+                            "expected ',' or ']', but got %r" % token.id, token.start_mark)
+            
+            if self.check_token(KeyToken):
+                token = self.peek_token()
+                event = MappingStartEvent(None, None, True,
+                        token.start_mark, token.end_mark,
+                        flow_style=True)
+                self.state = self.parse_flow_sequence_entry_mapping_key
+                return event
+            elif not self.check_token(FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = SequenceEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_sequence_entry_mapping_key(self):
+        token = self.get_token()
+        if not self.check_token(ValueToken,
+                FlowEntryToken, FlowSequenceEndToken):
+            self.states.append(self.parse_flow_sequence_entry_mapping_value)
+            return self.parse_flow_node()
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_value
+            return self.process_empty_scalar(token.end_mark)
+
+    def parse_flow_sequence_entry_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowSequenceEndToken):
+                self.states.append(self.parse_flow_sequence_entry_mapping_end)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_sequence_entry_mapping_end
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_sequence_entry_mapping_end
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_sequence_entry_mapping_end(self):
+        self.state = self.parse_flow_sequence_entry
+        token = self.peek_token()
+        return MappingEndEvent(token.start_mark, token.start_mark)
+
+    # flow_mapping  ::= FLOW-MAPPING-START
+    #                   (flow_mapping_entry FLOW-ENTRY)*
+    #                   flow_mapping_entry?
+    #                   FLOW-MAPPING-END
+    # flow_mapping_entry    ::= flow_node | KEY flow_node? (VALUE flow_node?)?
+
+    def parse_flow_mapping_first_key(self):
+        token = self.get_token()
+        self.marks.append(token.start_mark)
+        return self.parse_flow_mapping_key(first=True)
+
+    def parse_flow_mapping_key(self, first=False):
+        if not self.check_token(FlowMappingEndToken):
+            if not first:
+                if self.check_token(FlowEntryToken):
+                    self.get_token()
+                else:
+                    token = self.peek_token()
+                    raise ParserError("while parsing a flow mapping", self.marks[-1],
+                            "expected ',' or '}', but got %r" % token.id, token.start_mark)
+            if self.check_token(KeyToken):
+                token = self.get_token()
+                if not self.check_token(ValueToken,
+                        FlowEntryToken, FlowMappingEndToken):
+                    self.states.append(self.parse_flow_mapping_value)
+                    return self.parse_flow_node()
+                else:
+                    self.state = self.parse_flow_mapping_value
+                    return self.process_empty_scalar(token.end_mark)
+            elif not self.check_token(FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_empty_value)
+                return self.parse_flow_node()
+        token = self.get_token()
+        event = MappingEndEvent(token.start_mark, token.end_mark)
+        self.state = self.states.pop()
+        self.marks.pop()
+        return event
+
+    def parse_flow_mapping_value(self):
+        if self.check_token(ValueToken):
+            token = self.get_token()
+            if not self.check_token(FlowEntryToken, FlowMappingEndToken):
+                self.states.append(self.parse_flow_mapping_key)
+                return self.parse_flow_node()
+            else:
+                self.state = self.parse_flow_mapping_key
+                return self.process_empty_scalar(token.end_mark)
+        else:
+            self.state = self.parse_flow_mapping_key
+            token = self.peek_token()
+            return self.process_empty_scalar(token.start_mark)
+
+    def parse_flow_mapping_empty_value(self):
+        self.state = self.parse_flow_mapping_key
+        return self.process_empty_scalar(self.peek_token().start_mark)
+
+    def process_empty_scalar(self, mark):
+        return ScalarEvent(None, None, (True, False), '', mark, mark)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/reader.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/reader.py
new file mode 100644
index 0000000000000000000000000000000000000000..774b0219b5932a0ee1c27e637371de5ba8d9cb16
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/reader.py
@@ -0,0 +1,185 @@
+# This module contains abstractions for the input stream. You don't have to
+# looks further, there are no pretty code.
+#
+# We define two classes here.
+#
+#   Mark(source, line, column)
+# It's just a record and its only use is producing nice error messages.
+# Parser does not use it for any other purposes.
+#
+#   Reader(source, data)
+# Reader determines the encoding of `data` and converts it to unicode.
+# Reader provides the following methods and attributes:
+#   reader.peek(length=1) - return the next `length` characters
+#   reader.forward(length=1) - move the current position to `length` characters.
+#   reader.index - the number of the current character.
+#   reader.line, stream.column - the line and the column of the current character.
+
+__all__ = ['Reader', 'ReaderError']
+
+from .error import YAMLError, Mark
+
+import codecs, re
+
+class ReaderError(YAMLError):
+
+    def __init__(self, name, position, character, encoding, reason):
+        self.name = name
+        self.character = character
+        self.position = position
+        self.encoding = encoding
+        self.reason = reason
+
+    def __str__(self):
+        if isinstance(self.character, bytes):
+            return "'%s' codec can't decode byte #x%02x: %s\n"  \
+                    "  in \"%s\", position %d"    \
+                    % (self.encoding, ord(self.character), self.reason,
+                            self.name, self.position)
+        else:
+            return "unacceptable character #x%04x: %s\n"    \
+                    "  in \"%s\", position %d"    \
+                    % (self.character, self.reason,
+                            self.name, self.position)
+
+class Reader(object):
+    # Reader:
+    # - determines the data encoding and converts it to a unicode string,
+    # - checks if characters are in allowed range,
+    # - adds '\0' to the end.
+
+    # Reader accepts
+    #  - a `bytes` object,
+    #  - a `str` object,
+    #  - a file-like object with its `read` method returning `str`,
+    #  - a file-like object with its `read` method returning `unicode`.
+
+    # Yeah, it's ugly and slow.
+
+    def __init__(self, stream):
+        self.name = None
+        self.stream = None
+        self.stream_pointer = 0
+        self.eof = True
+        self.buffer = ''
+        self.pointer = 0
+        self.raw_buffer = None
+        self.raw_decode = None
+        self.encoding = None
+        self.index = 0
+        self.line = 0
+        self.column = 0
+        if isinstance(stream, str):
+            self.name = "<unicode string>"
+            self.check_printable(stream)
+            self.buffer = stream+'\0'
+        elif isinstance(stream, bytes):
+            self.name = "<byte string>"
+            self.raw_buffer = stream
+            self.determine_encoding()
+        else:
+            self.stream = stream
+            self.name = getattr(stream, 'name', "<file>")
+            self.eof = False
+            self.raw_buffer = None
+            self.determine_encoding()
+
+    def peek(self, index=0):
+        try:
+            return self.buffer[self.pointer+index]
+        except IndexError:
+            self.update(index+1)
+            return self.buffer[self.pointer+index]
+
+    def prefix(self, length=1):
+        if self.pointer+length >= len(self.buffer):
+            self.update(length)
+        return self.buffer[self.pointer:self.pointer+length]
+
+    def forward(self, length=1):
+        if self.pointer+length+1 >= len(self.buffer):
+            self.update(length+1)
+        while length:
+            ch = self.buffer[self.pointer]
+            self.pointer += 1
+            self.index += 1
+            if ch in '\n\x85\u2028\u2029'  \
+                    or (ch == '\r' and self.buffer[self.pointer] != '\n'):
+                self.line += 1
+                self.column = 0
+            elif ch != '\uFEFF':
+                self.column += 1
+            length -= 1
+
+    def get_mark(self):
+        if self.stream is None:
+            return Mark(self.name, self.index, self.line, self.column,
+                    self.buffer, self.pointer)
+        else:
+            return Mark(self.name, self.index, self.line, self.column,
+                    None, None)
+
+    def determine_encoding(self):
+        while not self.eof and (self.raw_buffer is None or len(self.raw_buffer) < 2):
+            self.update_raw()
+        if isinstance(self.raw_buffer, bytes):
+            if self.raw_buffer.startswith(codecs.BOM_UTF16_LE):
+                self.raw_decode = codecs.utf_16_le_decode
+                self.encoding = 'utf-16-le'
+            elif self.raw_buffer.startswith(codecs.BOM_UTF16_BE):
+                self.raw_decode = codecs.utf_16_be_decode
+                self.encoding = 'utf-16-be'
+            else:
+                self.raw_decode = codecs.utf_8_decode
+                self.encoding = 'utf-8'
+        self.update(1)
+
+    NON_PRINTABLE = re.compile('[^\x09\x0A\x0D\x20-\x7E\x85\xA0-\uD7FF\uE000-\uFFFD\U00010000-\U0010ffff]')
+    def check_printable(self, data):
+        match = self.NON_PRINTABLE.search(data)
+        if match:
+            character = match.group()
+            position = self.index+(len(self.buffer)-self.pointer)+match.start()
+            raise ReaderError(self.name, position, ord(character),
+                    'unicode', "special characters are not allowed")
+
+    def update(self, length):
+        if self.raw_buffer is None:
+            return
+        self.buffer = self.buffer[self.pointer:]
+        self.pointer = 0
+        while len(self.buffer) < length:
+            if not self.eof:
+                self.update_raw()
+            if self.raw_decode is not None:
+                try:
+                    data, converted = self.raw_decode(self.raw_buffer,
+                            'strict', self.eof)
+                except UnicodeDecodeError as exc:
+                    character = self.raw_buffer[exc.start]
+                    if self.stream is not None:
+                        position = self.stream_pointer-len(self.raw_buffer)+exc.start
+                    else:
+                        position = exc.start
+                    raise ReaderError(self.name, position, character,
+                            exc.encoding, exc.reason)
+            else:
+                data = self.raw_buffer
+                converted = len(data)
+            self.check_printable(data)
+            self.buffer += data
+            self.raw_buffer = self.raw_buffer[converted:]
+            if self.eof:
+                self.buffer += '\0'
+                self.raw_buffer = None
+                break
+
+    def update_raw(self, size=4096):
+        data = self.stream.read(size)
+        if self.raw_buffer is None:
+            self.raw_buffer = data
+        else:
+            self.raw_buffer += data
+        self.stream_pointer += len(data)
+        if not data:
+            self.eof = True
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/representer.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/representer.py
new file mode 100644
index 0000000000000000000000000000000000000000..3b0b192ef32ed7f5b7015456fe883c3327bb841e
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/representer.py
@@ -0,0 +1,389 @@
+
+__all__ = ['BaseRepresenter', 'SafeRepresenter', 'Representer',
+    'RepresenterError']
+
+from .error import *
+from .nodes import *
+
+import datetime, copyreg, types, base64, collections
+
+class RepresenterError(YAMLError):
+    pass
+
+class BaseRepresenter:
+
+    yaml_representers = {}
+    yaml_multi_representers = {}
+
+    def __init__(self, default_style=None, default_flow_style=False, sort_keys=True):
+        self.default_style = default_style
+        self.sort_keys = sort_keys
+        self.default_flow_style = default_flow_style
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent(self, data):
+        node = self.represent_data(data)
+        self.serialize(node)
+        self.represented_objects = {}
+        self.object_keeper = []
+        self.alias_key = None
+
+    def represent_data(self, data):
+        if self.ignore_aliases(data):
+            self.alias_key = None
+        else:
+            self.alias_key = id(data)
+        if self.alias_key is not None:
+            if self.alias_key in self.represented_objects:
+                node = self.represented_objects[self.alias_key]
+                #if node is None:
+                #    raise RepresenterError("recursive objects are not allowed: %r" % data)
+                return node
+            #self.represented_objects[alias_key] = None
+            self.object_keeper.append(data)
+        data_types = type(data).__mro__
+        if data_types[0] in self.yaml_representers:
+            node = self.yaml_representers[data_types[0]](self, data)
+        else:
+            for data_type in data_types:
+                if data_type in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[data_type](self, data)
+                    break
+            else:
+                if None in self.yaml_multi_representers:
+                    node = self.yaml_multi_representers[None](self, data)
+                elif None in self.yaml_representers:
+                    node = self.yaml_representers[None](self, data)
+                else:
+                    node = ScalarNode(None, str(data))
+        #if alias_key is not None:
+        #    self.represented_objects[alias_key] = node
+        return node
+
+    @classmethod
+    def add_representer(cls, data_type, representer):
+        if not 'yaml_representers' in cls.__dict__:
+            cls.yaml_representers = cls.yaml_representers.copy()
+        cls.yaml_representers[data_type] = representer
+
+    @classmethod
+    def add_multi_representer(cls, data_type, representer):
+        if not 'yaml_multi_representers' in cls.__dict__:
+            cls.yaml_multi_representers = cls.yaml_multi_representers.copy()
+        cls.yaml_multi_representers[data_type] = representer
+
+    def represent_scalar(self, tag, value, style=None):
+        if style is None:
+            style = self.default_style
+        node = ScalarNode(tag, value, style=style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        return node
+
+    def represent_sequence(self, tag, sequence, flow_style=None):
+        value = []
+        node = SequenceNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        for item in sequence:
+            node_item = self.represent_data(item)
+            if not (isinstance(node_item, ScalarNode) and not node_item.style):
+                best_style = False
+            value.append(node_item)
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def represent_mapping(self, tag, mapping, flow_style=None):
+        value = []
+        node = MappingNode(tag, value, flow_style=flow_style)
+        if self.alias_key is not None:
+            self.represented_objects[self.alias_key] = node
+        best_style = True
+        if hasattr(mapping, 'items'):
+            mapping = list(mapping.items())
+            if self.sort_keys:
+                try:
+                    mapping = sorted(mapping)
+                except TypeError:
+                    pass
+        for item_key, item_value in mapping:
+            node_key = self.represent_data(item_key)
+            node_value = self.represent_data(item_value)
+            if not (isinstance(node_key, ScalarNode) and not node_key.style):
+                best_style = False
+            if not (isinstance(node_value, ScalarNode) and not node_value.style):
+                best_style = False
+            value.append((node_key, node_value))
+        if flow_style is None:
+            if self.default_flow_style is not None:
+                node.flow_style = self.default_flow_style
+            else:
+                node.flow_style = best_style
+        return node
+
+    def ignore_aliases(self, data):
+        return False
+
+class SafeRepresenter(BaseRepresenter):
+
+    def ignore_aliases(self, data):
+        if data is None:
+            return True
+        if isinstance(data, tuple) and data == ():
+            return True
+        if isinstance(data, (str, bytes, bool, int, float)):
+            return True
+
+    def represent_none(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:null', 'null')
+
+    def represent_str(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:str', data)
+
+    def represent_binary(self, data):
+        if hasattr(base64, 'encodebytes'):
+            data = base64.encodebytes(data).decode('ascii')
+        else:
+            data = base64.encodestring(data).decode('ascii')
+        return self.represent_scalar('tag:yaml.org,2002:binary', data, style='|')
+
+    def represent_bool(self, data):
+        if data:
+            value = 'true'
+        else:
+            value = 'false'
+        return self.represent_scalar('tag:yaml.org,2002:bool', value)
+
+    def represent_int(self, data):
+        return self.represent_scalar('tag:yaml.org,2002:int', str(data))
+
+    inf_value = 1e300
+    while repr(inf_value) != repr(inf_value*inf_value):
+        inf_value *= inf_value
+
+    def represent_float(self, data):
+        if data != data or (data == 0.0 and data == 1.0):
+            value = '.nan'
+        elif data == self.inf_value:
+            value = '.inf'
+        elif data == -self.inf_value:
+            value = '-.inf'
+        else:
+            value = repr(data).lower()
+            # Note that in some cases `repr(data)` represents a float number
+            # without the decimal parts.  For instance:
+            #   >>> repr(1e17)
+            #   '1e17'
+            # Unfortunately, this is not a valid float representation according
+            # to the definition of the `!!float` tag.  We fix this by adding
+            # '.0' before the 'e' symbol.
+            if '.' not in value and 'e' in value:
+                value = value.replace('e', '.0e', 1)
+        return self.represent_scalar('tag:yaml.org,2002:float', value)
+
+    def represent_list(self, data):
+        #pairs = (len(data) > 0 and isinstance(data, list))
+        #if pairs:
+        #    for item in data:
+        #        if not isinstance(item, tuple) or len(item) != 2:
+        #            pairs = False
+        #            break
+        #if not pairs:
+            return self.represent_sequence('tag:yaml.org,2002:seq', data)
+        #value = []
+        #for item_key, item_value in data:
+        #    value.append(self.represent_mapping(u'tag:yaml.org,2002:map',
+        #        [(item_key, item_value)]))
+        #return SequenceNode(u'tag:yaml.org,2002:pairs', value)
+
+    def represent_dict(self, data):
+        return self.represent_mapping('tag:yaml.org,2002:map', data)
+
+    def represent_set(self, data):
+        value = {}
+        for key in data:
+            value[key] = None
+        return self.represent_mapping('tag:yaml.org,2002:set', value)
+
+    def represent_date(self, data):
+        value = data.isoformat()
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_datetime(self, data):
+        value = data.isoformat(' ')
+        return self.represent_scalar('tag:yaml.org,2002:timestamp', value)
+
+    def represent_yaml_object(self, tag, data, cls, flow_style=None):
+        if hasattr(data, '__getstate__'):
+            state = data.__getstate__()
+        else:
+            state = data.__dict__.copy()
+        return self.represent_mapping(tag, state, flow_style=flow_style)
+
+    def represent_undefined(self, data):
+        raise RepresenterError("cannot represent an object", data)
+
+SafeRepresenter.add_representer(type(None),
+        SafeRepresenter.represent_none)
+
+SafeRepresenter.add_representer(str,
+        SafeRepresenter.represent_str)
+
+SafeRepresenter.add_representer(bytes,
+        SafeRepresenter.represent_binary)
+
+SafeRepresenter.add_representer(bool,
+        SafeRepresenter.represent_bool)
+
+SafeRepresenter.add_representer(int,
+        SafeRepresenter.represent_int)
+
+SafeRepresenter.add_representer(float,
+        SafeRepresenter.represent_float)
+
+SafeRepresenter.add_representer(list,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(tuple,
+        SafeRepresenter.represent_list)
+
+SafeRepresenter.add_representer(dict,
+        SafeRepresenter.represent_dict)
+
+SafeRepresenter.add_representer(set,
+        SafeRepresenter.represent_set)
+
+SafeRepresenter.add_representer(datetime.date,
+        SafeRepresenter.represent_date)
+
+SafeRepresenter.add_representer(datetime.datetime,
+        SafeRepresenter.represent_datetime)
+
+SafeRepresenter.add_representer(None,
+        SafeRepresenter.represent_undefined)
+
+class Representer(SafeRepresenter):
+
+    def represent_complex(self, data):
+        if data.imag == 0.0:
+            data = '%r' % data.real
+        elif data.real == 0.0:
+            data = '%rj' % data.imag
+        elif data.imag > 0:
+            data = '%r+%rj' % (data.real, data.imag)
+        else:
+            data = '%r%rj' % (data.real, data.imag)
+        return self.represent_scalar('tag:yaml.org,2002:python/complex', data)
+
+    def represent_tuple(self, data):
+        return self.represent_sequence('tag:yaml.org,2002:python/tuple', data)
+
+    def represent_name(self, data):
+        name = '%s.%s' % (data.__module__, data.__name__)
+        return self.represent_scalar('tag:yaml.org,2002:python/name:'+name, '')
+
+    def represent_module(self, data):
+        return self.represent_scalar(
+                'tag:yaml.org,2002:python/module:'+data.__name__, '')
+
+    def represent_object(self, data):
+        # We use __reduce__ API to save the data. data.__reduce__ returns
+        # a tuple of length 2-5:
+        #   (function, args, state, listitems, dictitems)
+
+        # For reconstructing, we calls function(*args), then set its state,
+        # listitems, and dictitems if they are not None.
+
+        # A special case is when function.__name__ == '__newobj__'. In this
+        # case we create the object with args[0].__new__(*args).
+
+        # Another special case is when __reduce__ returns a string - we don't
+        # support it.
+
+        # We produce a !!python/object, !!python/object/new or
+        # !!python/object/apply node.
+
+        cls = type(data)
+        if cls in copyreg.dispatch_table:
+            reduce = copyreg.dispatch_table[cls](data)
+        elif hasattr(data, '__reduce_ex__'):
+            reduce = data.__reduce_ex__(2)
+        elif hasattr(data, '__reduce__'):
+            reduce = data.__reduce__()
+        else:
+            raise RepresenterError("cannot represent an object", data)
+        reduce = (list(reduce)+[None]*5)[:5]
+        function, args, state, listitems, dictitems = reduce
+        args = list(args)
+        if state is None:
+            state = {}
+        if listitems is not None:
+            listitems = list(listitems)
+        if dictitems is not None:
+            dictitems = dict(dictitems)
+        if function.__name__ == '__newobj__':
+            function = args[0]
+            args = args[1:]
+            tag = 'tag:yaml.org,2002:python/object/new:'
+            newobj = True
+        else:
+            tag = 'tag:yaml.org,2002:python/object/apply:'
+            newobj = False
+        function_name = '%s.%s' % (function.__module__, function.__name__)
+        if not args and not listitems and not dictitems \
+                and isinstance(state, dict) and newobj:
+            return self.represent_mapping(
+                    'tag:yaml.org,2002:python/object:'+function_name, state)
+        if not listitems and not dictitems  \
+                and isinstance(state, dict) and not state:
+            return self.represent_sequence(tag+function_name, args)
+        value = {}
+        if args:
+            value['args'] = args
+        if state or not isinstance(state, dict):
+            value['state'] = state
+        if listitems:
+            value['listitems'] = listitems
+        if dictitems:
+            value['dictitems'] = dictitems
+        return self.represent_mapping(tag+function_name, value)
+
+    def represent_ordered_dict(self, data):
+        # Provide uniform representation across different Python versions.
+        data_type = type(data)
+        tag = 'tag:yaml.org,2002:python/object/apply:%s.%s' \
+                % (data_type.__module__, data_type.__name__)
+        items = [[key, value] for key, value in data.items()]
+        return self.represent_sequence(tag, [items])
+
+Representer.add_representer(complex,
+        Representer.represent_complex)
+
+Representer.add_representer(tuple,
+        Representer.represent_tuple)
+
+Representer.add_representer(type,
+        Representer.represent_name)
+
+Representer.add_representer(collections.OrderedDict,
+        Representer.represent_ordered_dict)
+
+Representer.add_representer(types.FunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.BuiltinFunctionType,
+        Representer.represent_name)
+
+Representer.add_representer(types.ModuleType,
+        Representer.represent_module)
+
+Representer.add_multi_representer(object,
+        Representer.represent_object)
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/resolver.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/resolver.py
new file mode 100644
index 0000000000000000000000000000000000000000..02b82e73eecac9875336617a7ff38300ff4507ef
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/resolver.py
@@ -0,0 +1,227 @@
+
+__all__ = ['BaseResolver', 'Resolver']
+
+from .error import *
+from .nodes import *
+
+import re
+
+class ResolverError(YAMLError):
+    pass
+
+class BaseResolver:
+
+    DEFAULT_SCALAR_TAG = 'tag:yaml.org,2002:str'
+    DEFAULT_SEQUENCE_TAG = 'tag:yaml.org,2002:seq'
+    DEFAULT_MAPPING_TAG = 'tag:yaml.org,2002:map'
+
+    yaml_implicit_resolvers = {}
+    yaml_path_resolvers = {}
+
+    def __init__(self):
+        self.resolver_exact_paths = []
+        self.resolver_prefix_paths = []
+
+    @classmethod
+    def add_implicit_resolver(cls, tag, regexp, first):
+        if not 'yaml_implicit_resolvers' in cls.__dict__:
+            implicit_resolvers = {}
+            for key in cls.yaml_implicit_resolvers:
+                implicit_resolvers[key] = cls.yaml_implicit_resolvers[key][:]
+            cls.yaml_implicit_resolvers = implicit_resolvers
+        if first is None:
+            first = [None]
+        for ch in first:
+            cls.yaml_implicit_resolvers.setdefault(ch, []).append((tag, regexp))
+
+    @classmethod
+    def add_path_resolver(cls, tag, path, kind=None):
+        # Note: `add_path_resolver` is experimental.  The API could be changed.
+        # `new_path` is a pattern that is matched against the path from the
+        # root to the node that is being considered.  `node_path` elements are
+        # tuples `(node_check, index_check)`.  `node_check` is a node class:
+        # `ScalarNode`, `SequenceNode`, `MappingNode` or `None`.  `None`
+        # matches any kind of a node.  `index_check` could be `None`, a boolean
+        # value, a string value, or a number.  `None` and `False` match against
+        # any _value_ of sequence and mapping nodes.  `True` matches against
+        # any _key_ of a mapping node.  A string `index_check` matches against
+        # a mapping value that corresponds to a scalar key which content is
+        # equal to the `index_check` value.  An integer `index_check` matches
+        # against a sequence value with the index equal to `index_check`.
+        if not 'yaml_path_resolvers' in cls.__dict__:
+            cls.yaml_path_resolvers = cls.yaml_path_resolvers.copy()
+        new_path = []
+        for element in path:
+            if isinstance(element, (list, tuple)):
+                if len(element) == 2:
+                    node_check, index_check = element
+                elif len(element) == 1:
+                    node_check = element[0]
+                    index_check = True
+                else:
+                    raise ResolverError("Invalid path element: %s" % element)
+            else:
+                node_check = None
+                index_check = element
+            if node_check is str:
+                node_check = ScalarNode
+            elif node_check is list:
+                node_check = SequenceNode
+            elif node_check is dict:
+                node_check = MappingNode
+            elif node_check not in [ScalarNode, SequenceNode, MappingNode]  \
+                    and not isinstance(node_check, str) \
+                    and node_check is not None:
+                raise ResolverError("Invalid node checker: %s" % node_check)
+            if not isinstance(index_check, (str, int))  \
+                    and index_check is not None:
+                raise ResolverError("Invalid index checker: %s" % index_check)
+            new_path.append((node_check, index_check))
+        if kind is str:
+            kind = ScalarNode
+        elif kind is list:
+            kind = SequenceNode
+        elif kind is dict:
+            kind = MappingNode
+        elif kind not in [ScalarNode, SequenceNode, MappingNode]    \
+                and kind is not None:
+            raise ResolverError("Invalid node kind: %s" % kind)
+        cls.yaml_path_resolvers[tuple(new_path), kind] = tag
+
+    def descend_resolver(self, current_node, current_index):
+        if not self.yaml_path_resolvers:
+            return
+        exact_paths = {}
+        prefix_paths = []
+        if current_node:
+            depth = len(self.resolver_prefix_paths)
+            for path, kind in self.resolver_prefix_paths[-1]:
+                if self.check_resolver_prefix(depth, path, kind,
+                        current_node, current_index):
+                    if len(path) > depth:
+                        prefix_paths.append((path, kind))
+                    else:
+                        exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+        else:
+            for path, kind in self.yaml_path_resolvers:
+                if not path:
+                    exact_paths[kind] = self.yaml_path_resolvers[path, kind]
+                else:
+                    prefix_paths.append((path, kind))
+        self.resolver_exact_paths.append(exact_paths)
+        self.resolver_prefix_paths.append(prefix_paths)
+
+    def ascend_resolver(self):
+        if not self.yaml_path_resolvers:
+            return
+        self.resolver_exact_paths.pop()
+        self.resolver_prefix_paths.pop()
+
+    def check_resolver_prefix(self, depth, path, kind,
+            current_node, current_index):
+        node_check, index_check = path[depth-1]
+        if isinstance(node_check, str):
+            if current_node.tag != node_check:
+                return
+        elif node_check is not None:
+            if not isinstance(current_node, node_check):
+                return
+        if index_check is True and current_index is not None:
+            return
+        if (index_check is False or index_check is None)    \
+                and current_index is None:
+            return
+        if isinstance(index_check, str):
+            if not (isinstance(current_index, ScalarNode)
+                    and index_check == current_index.value):
+                return
+        elif isinstance(index_check, int) and not isinstance(index_check, bool):
+            if index_check != current_index:
+                return
+        return True
+
+    def resolve(self, kind, value, implicit):
+        if kind is ScalarNode and implicit[0]:
+            if value == '':
+                resolvers = self.yaml_implicit_resolvers.get('', [])
+            else:
+                resolvers = self.yaml_implicit_resolvers.get(value[0], [])
+            resolvers += self.yaml_implicit_resolvers.get(None, [])
+            for tag, regexp in resolvers:
+                if regexp.match(value):
+                    return tag
+            implicit = implicit[1]
+        if self.yaml_path_resolvers:
+            exact_paths = self.resolver_exact_paths[-1]
+            if kind in exact_paths:
+                return exact_paths[kind]
+            if None in exact_paths:
+                return exact_paths[None]
+        if kind is ScalarNode:
+            return self.DEFAULT_SCALAR_TAG
+        elif kind is SequenceNode:
+            return self.DEFAULT_SEQUENCE_TAG
+        elif kind is MappingNode:
+            return self.DEFAULT_MAPPING_TAG
+
+class Resolver(BaseResolver):
+    pass
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:bool',
+        re.compile(r'''^(?:yes|Yes|YES|no|No|NO
+                    |true|True|TRUE|false|False|FALSE
+                    |on|On|ON|off|Off|OFF)$''', re.X),
+        list('yYnNtTfFoO'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:float',
+        re.compile(r'''^(?:[-+]?(?:[0-9][0-9_]*)\.[0-9_]*(?:[eE][-+][0-9]+)?
+                    |\.[0-9_]+(?:[eE][-+][0-9]+)?
+                    |[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\.[0-9_]*
+                    |[-+]?\.(?:inf|Inf|INF)
+                    |\.(?:nan|NaN|NAN))$''', re.X),
+        list('-+0123456789.'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:int',
+        re.compile(r'''^(?:[-+]?0b[0-1_]+
+                    |[-+]?0[0-7_]+
+                    |[-+]?(?:0|[1-9][0-9_]*)
+                    |[-+]?0x[0-9a-fA-F_]+
+                    |[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)$''', re.X),
+        list('-+0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:merge',
+        re.compile(r'^(?:<<)$'),
+        ['<'])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:null',
+        re.compile(r'''^(?: ~
+                    |null|Null|NULL
+                    | )$''', re.X),
+        ['~', 'n', 'N', ''])
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:timestamp',
+        re.compile(r'''^(?:[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]
+                    |[0-9][0-9][0-9][0-9] -[0-9][0-9]? -[0-9][0-9]?
+                     (?:[Tt]|[ \t]+)[0-9][0-9]?
+                     :[0-9][0-9] :[0-9][0-9] (?:\.[0-9]*)?
+                     (?:[ \t]*(?:Z|[-+][0-9][0-9]?(?::[0-9][0-9])?))?)$''', re.X),
+        list('0123456789'))
+
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:value',
+        re.compile(r'^(?:=)$'),
+        ['='])
+
+# The following resolver is only for documentation purposes. It cannot work
+# because plain scalars cannot start with '!', '&', or '*'.
+Resolver.add_implicit_resolver(
+        'tag:yaml.org,2002:yaml',
+        re.compile(r'^(?:!|&|\*)$'),
+        list('!&*'))
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/scanner.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/scanner.py
new file mode 100644
index 0000000000000000000000000000000000000000..7437ede1c608266aaca481955f438844479cab4f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/scanner.py
@@ -0,0 +1,1435 @@
+
+# Scanner produces tokens of the following types:
+# STREAM-START
+# STREAM-END
+# DIRECTIVE(name, value)
+# DOCUMENT-START
+# DOCUMENT-END
+# BLOCK-SEQUENCE-START
+# BLOCK-MAPPING-START
+# BLOCK-END
+# FLOW-SEQUENCE-START
+# FLOW-MAPPING-START
+# FLOW-SEQUENCE-END
+# FLOW-MAPPING-END
+# BLOCK-ENTRY
+# FLOW-ENTRY
+# KEY
+# VALUE
+# ALIAS(value)
+# ANCHOR(value)
+# TAG(value)
+# SCALAR(value, plain, style)
+#
+# Read comments in the Scanner code for more details.
+#
+
+__all__ = ['Scanner', 'ScannerError']
+
+from .error import MarkedYAMLError
+from .tokens import *
+
+class ScannerError(MarkedYAMLError):
+    pass
+
+class SimpleKey:
+    # See below simple keys treatment.
+
+    def __init__(self, token_number, required, index, line, column, mark):
+        self.token_number = token_number
+        self.required = required
+        self.index = index
+        self.line = line
+        self.column = column
+        self.mark = mark
+
+class Scanner:
+
+    def __init__(self):
+        """Initialize the scanner."""
+        # It is assumed that Scanner and Reader will have a common descendant.
+        # Reader do the dirty work of checking for BOM and converting the
+        # input data to Unicode. It also adds NUL to the end.
+        #
+        # Reader supports the following methods
+        #   self.peek(i=0)       # peek the next i-th character
+        #   self.prefix(l=1)     # peek the next l characters
+        #   self.forward(l=1)    # read the next l characters and move the pointer.
+
+        # Had we reached the end of the stream?
+        self.done = False
+
+        # The number of unclosed '{' and '['. `flow_level == 0` means block
+        # context.
+        self.flow_level = 0
+
+        # List of processed tokens that are not yet emitted.
+        self.tokens = []
+
+        # Add the STREAM-START token.
+        self.fetch_stream_start()
+
+        # Number of tokens that were emitted through the `get_token` method.
+        self.tokens_taken = 0
+
+        # The current indentation level.
+        self.indent = -1
+
+        # Past indentation levels.
+        self.indents = []
+
+        # Variables related to simple keys treatment.
+
+        # A simple key is a key that is not denoted by the '?' indicator.
+        # Example of simple keys:
+        #   ---
+        #   block simple key: value
+        #   ? not a simple key:
+        #   : { flow simple key: value }
+        # We emit the KEY token before all keys, so when we find a potential
+        # simple key, we try to locate the corresponding ':' indicator.
+        # Simple keys should be limited to a single line and 1024 characters.
+
+        # Can a simple key start at the current position? A simple key may
+        # start:
+        # - at the beginning of the line, not counting indentation spaces
+        #       (in block context),
+        # - after '{', '[', ',' (in the flow context),
+        # - after '?', ':', '-' (in the block context).
+        # In the block context, this flag also signifies if a block collection
+        # may start at the current position.
+        self.allow_simple_key = True
+
+        # Keep track of possible simple keys. This is a dictionary. The key
+        # is `flow_level`; there can be no more that one possible simple key
+        # for each level. The value is a SimpleKey record:
+        #   (token_number, required, index, line, column, mark)
+        # A simple key may start with ALIAS, ANCHOR, TAG, SCALAR(flow),
+        # '[', or '{' tokens.
+        self.possible_simple_keys = {}
+
+    # Public methods.
+
+    def check_token(self, *choices):
+        # Check if the next token is one of the given types.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            if not choices:
+                return True
+            for choice in choices:
+                if isinstance(self.tokens[0], choice):
+                    return True
+        return False
+
+    def peek_token(self):
+        # Return the next token, but do not delete if from the queue.
+        # Return None if no more tokens.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            return self.tokens[0]
+        else:
+            return None
+
+    def get_token(self):
+        # Return the next token.
+        while self.need_more_tokens():
+            self.fetch_more_tokens()
+        if self.tokens:
+            self.tokens_taken += 1
+            return self.tokens.pop(0)
+
+    # Private methods.
+
+    def need_more_tokens(self):
+        if self.done:
+            return False
+        if not self.tokens:
+            return True
+        # The current token may be a potential simple key, so we
+        # need to look further.
+        self.stale_possible_simple_keys()
+        if self.next_possible_simple_key() == self.tokens_taken:
+            return True
+
+    def fetch_more_tokens(self):
+
+        # Eat whitespaces and comments until we reach the next token.
+        self.scan_to_next_token()
+
+        # Remove obsolete possible simple keys.
+        self.stale_possible_simple_keys()
+
+        # Compare the current indentation and column. It may add some tokens
+        # and decrease the current indentation level.
+        self.unwind_indent(self.column)
+
+        # Peek the next character.
+        ch = self.peek()
+
+        # Is it the end of stream?
+        if ch == '\0':
+            return self.fetch_stream_end()
+
+        # Is it a directive?
+        if ch == '%' and self.check_directive():
+            return self.fetch_directive()
+
+        # Is it the document start?
+        if ch == '-' and self.check_document_start():
+            return self.fetch_document_start()
+
+        # Is it the document end?
+        if ch == '.' and self.check_document_end():
+            return self.fetch_document_end()
+
+        # TODO: support for BOM within a stream.
+        #if ch == '\uFEFF':
+        #    return self.fetch_bom()    <-- issue BOMToken
+
+        # Note: the order of the following checks is NOT significant.
+
+        # Is it the flow sequence start indicator?
+        if ch == '[':
+            return self.fetch_flow_sequence_start()
+
+        # Is it the flow mapping start indicator?
+        if ch == '{':
+            return self.fetch_flow_mapping_start()
+
+        # Is it the flow sequence end indicator?
+        if ch == ']':
+            return self.fetch_flow_sequence_end()
+
+        # Is it the flow mapping end indicator?
+        if ch == '}':
+            return self.fetch_flow_mapping_end()
+
+        # Is it the flow entry indicator?
+        if ch == ',':
+            return self.fetch_flow_entry()
+
+        # Is it the block entry indicator?
+        if ch == '-' and self.check_block_entry():
+            return self.fetch_block_entry()
+
+        # Is it the key indicator?
+        if ch == '?' and self.check_key():
+            return self.fetch_key()
+
+        # Is it the value indicator?
+        if ch == ':' and self.check_value():
+            return self.fetch_value()
+
+        # Is it an alias?
+        if ch == '*':
+            return self.fetch_alias()
+
+        # Is it an anchor?
+        if ch == '&':
+            return self.fetch_anchor()
+
+        # Is it a tag?
+        if ch == '!':
+            return self.fetch_tag()
+
+        # Is it a literal scalar?
+        if ch == '|' and not self.flow_level:
+            return self.fetch_literal()
+
+        # Is it a folded scalar?
+        if ch == '>' and not self.flow_level:
+            return self.fetch_folded()
+
+        # Is it a single quoted scalar?
+        if ch == '\'':
+            return self.fetch_single()
+
+        # Is it a double quoted scalar?
+        if ch == '\"':
+            return self.fetch_double()
+
+        # It must be a plain scalar then.
+        if self.check_plain():
+            return self.fetch_plain()
+
+        # No? It's an error. Let's produce a nice error message.
+        raise ScannerError("while scanning for the next token", None,
+                "found character %r that cannot start any token" % ch,
+                self.get_mark())
+
+    # Simple keys treatment.
+
+    def next_possible_simple_key(self):
+        # Return the number of the nearest possible simple key. Actually we
+        # don't need to loop through the whole dictionary. We may replace it
+        # with the following code:
+        #   if not self.possible_simple_keys:
+        #       return None
+        #   return self.possible_simple_keys[
+        #           min(self.possible_simple_keys.keys())].token_number
+        min_token_number = None
+        for level in self.possible_simple_keys:
+            key = self.possible_simple_keys[level]
+            if min_token_number is None or key.token_number < min_token_number:
+                min_token_number = key.token_number
+        return min_token_number
+
+    def stale_possible_simple_keys(self):
+        # Remove entries that are no longer possible simple keys. According to
+        # the YAML specification, simple keys
+        # - should be limited to a single line,
+        # - should be no longer than 1024 characters.
+        # Disabling this procedure will allow simple keys of any length and
+        # height (may cause problems if indentation is broken though).
+        for level in list(self.possible_simple_keys):
+            key = self.possible_simple_keys[level]
+            if key.line != self.line  \
+                    or self.index-key.index > 1024:
+                if key.required:
+                    raise ScannerError("while scanning a simple key", key.mark,
+                            "could not find expected ':'", self.get_mark())
+                del self.possible_simple_keys[level]
+
+    def save_possible_simple_key(self):
+        # The next token may start a simple key. We check if it's possible
+        # and save its position. This function is called for
+        #   ALIAS, ANCHOR, TAG, SCALAR(flow), '[', and '{'.
+
+        # Check if a simple key is required at the current position.
+        required = not self.flow_level and self.indent == self.column
+
+        # The next token might be a simple key. Let's save it's number and
+        # position.
+        if self.allow_simple_key:
+            self.remove_possible_simple_key()
+            token_number = self.tokens_taken+len(self.tokens)
+            key = SimpleKey(token_number, required,
+                    self.index, self.line, self.column, self.get_mark())
+            self.possible_simple_keys[self.flow_level] = key
+
+    def remove_possible_simple_key(self):
+        # Remove the saved possible key position at the current flow level.
+        if self.flow_level in self.possible_simple_keys:
+            key = self.possible_simple_keys[self.flow_level]
+            
+            if key.required:
+                raise ScannerError("while scanning a simple key", key.mark,
+                        "could not find expected ':'", self.get_mark())
+
+            del self.possible_simple_keys[self.flow_level]
+
+    # Indentation functions.
+
+    def unwind_indent(self, column):
+
+        ## In flow context, tokens should respect indentation.
+        ## Actually the condition should be `self.indent >= column` according to
+        ## the spec. But this condition will prohibit intuitively correct
+        ## constructions such as
+        ## key : {
+        ## }
+        #if self.flow_level and self.indent > column:
+        #    raise ScannerError(None, None,
+        #            "invalid indentation or unclosed '[' or '{'",
+        #            self.get_mark())
+
+        # In the flow context, indentation is ignored. We make the scanner less
+        # restrictive then specification requires.
+        if self.flow_level:
+            return
+
+        # In block context, we may need to issue the BLOCK-END tokens.
+        while self.indent > column:
+            mark = self.get_mark()
+            self.indent = self.indents.pop()
+            self.tokens.append(BlockEndToken(mark, mark))
+
+    def add_indent(self, column):
+        # Check if we need to increase indentation.
+        if self.indent < column:
+            self.indents.append(self.indent)
+            self.indent = column
+            return True
+        return False
+
+    # Fetchers.
+
+    def fetch_stream_start(self):
+        # We always add STREAM-START as the first token and STREAM-END as the
+        # last token.
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-START.
+        self.tokens.append(StreamStartToken(mark, mark,
+            encoding=self.encoding))
+        
+
+    def fetch_stream_end(self):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+        self.possible_simple_keys = {}
+
+        # Read the token.
+        mark = self.get_mark()
+        
+        # Add STREAM-END.
+        self.tokens.append(StreamEndToken(mark, mark))
+
+        # The steam is finished.
+        self.done = True
+
+    def fetch_directive(self):
+        
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Scan and add DIRECTIVE.
+        self.tokens.append(self.scan_directive())
+
+    def fetch_document_start(self):
+        self.fetch_document_indicator(DocumentStartToken)
+
+    def fetch_document_end(self):
+        self.fetch_document_indicator(DocumentEndToken)
+
+    def fetch_document_indicator(self, TokenClass):
+
+        # Set the current indentation to -1.
+        self.unwind_indent(-1)
+
+        # Reset simple keys. Note that there could not be a block collection
+        # after '---'.
+        self.remove_possible_simple_key()
+        self.allow_simple_key = False
+
+        # Add DOCUMENT-START or DOCUMENT-END.
+        start_mark = self.get_mark()
+        self.forward(3)
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_start(self):
+        self.fetch_flow_collection_start(FlowSequenceStartToken)
+
+    def fetch_flow_mapping_start(self):
+        self.fetch_flow_collection_start(FlowMappingStartToken)
+
+    def fetch_flow_collection_start(self, TokenClass):
+
+        # '[' and '{' may start a simple key.
+        self.save_possible_simple_key()
+
+        # Increase the flow level.
+        self.flow_level += 1
+
+        # Simple keys are allowed after '[' and '{'.
+        self.allow_simple_key = True
+
+        # Add FLOW-SEQUENCE-START or FLOW-MAPPING-START.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_sequence_end(self):
+        self.fetch_flow_collection_end(FlowSequenceEndToken)
+
+    def fetch_flow_mapping_end(self):
+        self.fetch_flow_collection_end(FlowMappingEndToken)
+
+    def fetch_flow_collection_end(self, TokenClass):
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Decrease the flow level.
+        self.flow_level -= 1
+
+        # No simple keys after ']' or '}'.
+        self.allow_simple_key = False
+
+        # Add FLOW-SEQUENCE-END or FLOW-MAPPING-END.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(TokenClass(start_mark, end_mark))
+
+    def fetch_flow_entry(self):
+
+        # Simple keys are allowed after ','.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add FLOW-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(FlowEntryToken(start_mark, end_mark))
+
+    def fetch_block_entry(self):
+
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a new entry?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "sequence entries are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-SEQUENCE-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockSequenceStartToken(mark, mark))
+
+        # It's an error for the block entry to occur in the flow context,
+        # but we let the parser detect this.
+        else:
+            pass
+
+        # Simple keys are allowed after '-'.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add BLOCK-ENTRY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(BlockEntryToken(start_mark, end_mark))
+
+    def fetch_key(self):
+        
+        # Block context needs additional checks.
+        if not self.flow_level:
+
+            # Are we allowed to start a key (not necessary a simple)?
+            if not self.allow_simple_key:
+                raise ScannerError(None, None,
+                        "mapping keys are not allowed here",
+                        self.get_mark())
+
+            # We may need to add BLOCK-MAPPING-START.
+            if self.add_indent(self.column):
+                mark = self.get_mark()
+                self.tokens.append(BlockMappingStartToken(mark, mark))
+
+        # Simple keys are allowed after '?' in the block context.
+        self.allow_simple_key = not self.flow_level
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Add KEY.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(KeyToken(start_mark, end_mark))
+
+    def fetch_value(self):
+
+        # Do we determine a simple key?
+        if self.flow_level in self.possible_simple_keys:
+
+            # Add KEY.
+            key = self.possible_simple_keys[self.flow_level]
+            del self.possible_simple_keys[self.flow_level]
+            self.tokens.insert(key.token_number-self.tokens_taken,
+                    KeyToken(key.mark, key.mark))
+
+            # If this key starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.
+            if not self.flow_level:
+                if self.add_indent(key.column):
+                    self.tokens.insert(key.token_number-self.tokens_taken,
+                            BlockMappingStartToken(key.mark, key.mark))
+
+            # There cannot be two simple keys one after another.
+            self.allow_simple_key = False
+
+        # It must be a part of a complex key.
+        else:
+            
+            # Block context needs additional checks.
+            # (Do we really need them? They will be caught by the parser
+            # anyway.)
+            if not self.flow_level:
+
+                # We are allowed to start a complex value if and only if
+                # we can start a simple key.
+                if not self.allow_simple_key:
+                    raise ScannerError(None, None,
+                            "mapping values are not allowed here",
+                            self.get_mark())
+
+            # If this value starts a new block mapping, we need to add
+            # BLOCK-MAPPING-START.  It will be detected as an error later by
+            # the parser.
+            if not self.flow_level:
+                if self.add_indent(self.column):
+                    mark = self.get_mark()
+                    self.tokens.append(BlockMappingStartToken(mark, mark))
+
+            # Simple keys are allowed after ':' in the block context.
+            self.allow_simple_key = not self.flow_level
+
+            # Reset possible simple key on the current level.
+            self.remove_possible_simple_key()
+
+        # Add VALUE.
+        start_mark = self.get_mark()
+        self.forward()
+        end_mark = self.get_mark()
+        self.tokens.append(ValueToken(start_mark, end_mark))
+
+    def fetch_alias(self):
+
+        # ALIAS could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ALIAS.
+        self.allow_simple_key = False
+
+        # Scan and add ALIAS.
+        self.tokens.append(self.scan_anchor(AliasToken))
+
+    def fetch_anchor(self):
+
+        # ANCHOR could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after ANCHOR.
+        self.allow_simple_key = False
+
+        # Scan and add ANCHOR.
+        self.tokens.append(self.scan_anchor(AnchorToken))
+
+    def fetch_tag(self):
+
+        # TAG could start a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after TAG.
+        self.allow_simple_key = False
+
+        # Scan and add TAG.
+        self.tokens.append(self.scan_tag())
+
+    def fetch_literal(self):
+        self.fetch_block_scalar(style='|')
+
+    def fetch_folded(self):
+        self.fetch_block_scalar(style='>')
+
+    def fetch_block_scalar(self, style):
+
+        # A simple key may follow a block scalar.
+        self.allow_simple_key = True
+
+        # Reset possible simple key on the current level.
+        self.remove_possible_simple_key()
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_block_scalar(style))
+
+    def fetch_single(self):
+        self.fetch_flow_scalar(style='\'')
+
+    def fetch_double(self):
+        self.fetch_flow_scalar(style='"')
+
+    def fetch_flow_scalar(self, style):
+
+        # A flow scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after flow scalars.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR.
+        self.tokens.append(self.scan_flow_scalar(style))
+
+    def fetch_plain(self):
+
+        # A plain scalar could be a simple key.
+        self.save_possible_simple_key()
+
+        # No simple keys after plain scalars. But note that `scan_plain` will
+        # change this flag if the scan is finished at the beginning of the
+        # line.
+        self.allow_simple_key = False
+
+        # Scan and add SCALAR. May change `allow_simple_key`.
+        self.tokens.append(self.scan_plain())
+
+    # Checkers.
+
+    def check_directive(self):
+
+        # DIRECTIVE:        ^ '%' ...
+        # The '%' indicator is already checked.
+        if self.column == 0:
+            return True
+
+    def check_document_start(self):
+
+        # DOCUMENT-START:   ^ '---' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '---'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_document_end(self):
+
+        # DOCUMENT-END:     ^ '...' (' '|'\n')
+        if self.column == 0:
+            if self.prefix(3) == '...'  \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return True
+
+    def check_block_entry(self):
+
+        # BLOCK-ENTRY:      '-' (' '|'\n')
+        return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_key(self):
+
+        # KEY(flow context):    '?'
+        if self.flow_level:
+            return True
+
+        # KEY(block context):   '?' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_value(self):
+
+        # VALUE(flow context):  ':'
+        if self.flow_level:
+            return True
+
+        # VALUE(block context): ':' (' '|'\n')
+        else:
+            return self.peek(1) in '\0 \t\r\n\x85\u2028\u2029'
+
+    def check_plain(self):
+
+        # A plain scalar may start with any non-space character except:
+        #   '-', '?', ':', ',', '[', ']', '{', '}',
+        #   '#', '&', '*', '!', '|', '>', '\'', '\"',
+        #   '%', '@', '`'.
+        #
+        # It may also start with
+        #   '-', '?', ':'
+        # if it is followed by a non-space character.
+        #
+        # Note that we limit the last rule to the block context (except the
+        # '-' character) because we want the flow context to be space
+        # independent.
+        ch = self.peek()
+        return ch not in '\0 \t\r\n\x85\u2028\u2029-?:,[]{}#&*!|>\'\"%@`'  \
+                or (self.peek(1) not in '\0 \t\r\n\x85\u2028\u2029'
+                        and (ch == '-' or (not self.flow_level and ch in '?:')))
+
+    # Scanners.
+
+    def scan_to_next_token(self):
+        # We ignore spaces, line breaks and comments.
+        # If we find a line break in the block context, we set the flag
+        # `allow_simple_key` on.
+        # The byte order mark is stripped if it's the first character in the
+        # stream. We do not yet support BOM inside the stream as the
+        # specification requires. Any such mark will be considered as a part
+        # of the document.
+        #
+        # TODO: We need to make tab handling rules more sane. A good rule is
+        #   Tabs cannot precede tokens
+        #   BLOCK-SEQUENCE-START, BLOCK-MAPPING-START, BLOCK-END,
+        #   KEY(block), VALUE(block), BLOCK-ENTRY
+        # So the checking code is
+        #   if <TAB>:
+        #       self.allow_simple_keys = False
+        # We also need to add the check for `allow_simple_keys == True` to
+        # `unwind_indent` before issuing BLOCK-END.
+        # Scanners for block, flow, and plain scalars need to be modified.
+
+        if self.index == 0 and self.peek() == '\uFEFF':
+            self.forward()
+        found = False
+        while not found:
+            while self.peek() == ' ':
+                self.forward()
+            if self.peek() == '#':
+                while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                    self.forward()
+            if self.scan_line_break():
+                if not self.flow_level:
+                    self.allow_simple_key = True
+            else:
+                found = True
+
+    def scan_directive(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        self.forward()
+        name = self.scan_directive_name(start_mark)
+        value = None
+        if name == 'YAML':
+            value = self.scan_yaml_directive_value(start_mark)
+            end_mark = self.get_mark()
+        elif name == 'TAG':
+            value = self.scan_tag_directive_value(start_mark)
+            end_mark = self.get_mark()
+        else:
+            end_mark = self.get_mark()
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        self.scan_directive_ignored_line(start_mark)
+        return DirectiveToken(name, value, start_mark, end_mark)
+
+    def scan_directive_name(self, start_mark):
+        # See the specification for details.
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        return value
+
+    def scan_yaml_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        major = self.scan_yaml_directive_number(start_mark)
+        if self.peek() != '.':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or '.', but found %r" % self.peek(),
+                    self.get_mark())
+        self.forward()
+        minor = self.scan_yaml_directive_number(start_mark)
+        if self.peek() not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit or ' ', but found %r" % self.peek(),
+                    self.get_mark())
+        return (major, minor)
+
+    def scan_yaml_directive_number(self, start_mark):
+        # See the specification for details.
+        ch = self.peek()
+        if not ('0' <= ch <= '9'):
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a digit, but found %r" % ch, self.get_mark())
+        length = 0
+        while '0' <= self.peek(length) <= '9':
+            length += 1
+        value = int(self.prefix(length))
+        self.forward(length)
+        return value
+
+    def scan_tag_directive_value(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        handle = self.scan_tag_directive_handle(start_mark)
+        while self.peek() == ' ':
+            self.forward()
+        prefix = self.scan_tag_directive_prefix(start_mark)
+        return (handle, prefix)
+
+    def scan_tag_directive_handle(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_handle('directive', start_mark)
+        ch = self.peek()
+        if ch != ' ':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_tag_directive_prefix(self, start_mark):
+        # See the specification for details.
+        value = self.scan_tag_uri('directive', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        return value
+
+    def scan_directive_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a directive", start_mark,
+                    "expected a comment or a line break, but found %r"
+                        % ch, self.get_mark())
+        self.scan_line_break()
+
+    def scan_anchor(self, TokenClass):
+        # The specification does not restrict characters for anchors and
+        # aliases. This may lead to problems, for instance, the document:
+        #   [ *alias, value ]
+        # can be interpreted in two ways, as
+        #   [ "value" ]
+        # and
+        #   [ *alias , "value" ]
+        # Therefore we restrict aliases to numbers and ASCII letters.
+        start_mark = self.get_mark()
+        indicator = self.peek()
+        if indicator == '*':
+            name = 'alias'
+        else:
+            name = 'anchor'
+        self.forward()
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-_':
+            length += 1
+            ch = self.peek(length)
+        if not length:
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        value = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch not in '\0 \t\r\n\x85\u2028\u2029?:,]}%@`':
+            raise ScannerError("while scanning an %s" % name, start_mark,
+                    "expected alphabetic or numeric character, but found %r"
+                    % ch, self.get_mark())
+        end_mark = self.get_mark()
+        return TokenClass(value, start_mark, end_mark)
+
+    def scan_tag(self):
+        # See the specification for details.
+        start_mark = self.get_mark()
+        ch = self.peek(1)
+        if ch == '<':
+            handle = None
+            self.forward(2)
+            suffix = self.scan_tag_uri('tag', start_mark)
+            if self.peek() != '>':
+                raise ScannerError("while parsing a tag", start_mark,
+                        "expected '>', but found %r" % self.peek(),
+                        self.get_mark())
+            self.forward()
+        elif ch in '\0 \t\r\n\x85\u2028\u2029':
+            handle = None
+            suffix = '!'
+            self.forward()
+        else:
+            length = 1
+            use_handle = False
+            while ch not in '\0 \r\n\x85\u2028\u2029':
+                if ch == '!':
+                    use_handle = True
+                    break
+                length += 1
+                ch = self.peek(length)
+            handle = '!'
+            if use_handle:
+                handle = self.scan_tag_handle('tag', start_mark)
+            else:
+                handle = '!'
+                self.forward()
+            suffix = self.scan_tag_uri('tag', start_mark)
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a tag", start_mark,
+                    "expected ' ', but found %r" % ch, self.get_mark())
+        value = (handle, suffix)
+        end_mark = self.get_mark()
+        return TagToken(value, start_mark, end_mark)
+
+    def scan_block_scalar(self, style):
+        # See the specification for details.
+
+        if style == '>':
+            folded = True
+        else:
+            folded = False
+
+        chunks = []
+        start_mark = self.get_mark()
+
+        # Scan the header.
+        self.forward()
+        chomping, increment = self.scan_block_scalar_indicators(start_mark)
+        self.scan_block_scalar_ignored_line(start_mark)
+
+        # Determine the indentation level and go to the first non-empty line.
+        min_indent = self.indent+1
+        if min_indent < 1:
+            min_indent = 1
+        if increment is None:
+            breaks, max_indent, end_mark = self.scan_block_scalar_indentation()
+            indent = max(min_indent, max_indent)
+        else:
+            indent = min_indent+increment-1
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+        line_break = ''
+
+        # Scan the inner part of the block scalar.
+        while self.column == indent and self.peek() != '\0':
+            chunks.extend(breaks)
+            leading_non_space = self.peek() not in ' \t'
+            length = 0
+            while self.peek(length) not in '\0\r\n\x85\u2028\u2029':
+                length += 1
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            line_break = self.scan_line_break()
+            breaks, end_mark = self.scan_block_scalar_breaks(indent)
+            if self.column == indent and self.peek() != '\0':
+
+                # Unfortunately, folding rules are ambiguous.
+                #
+                # This is the folding according to the specification:
+                
+                if folded and line_break == '\n'    \
+                        and leading_non_space and self.peek() not in ' \t':
+                    if not breaks:
+                        chunks.append(' ')
+                else:
+                    chunks.append(line_break)
+                
+                # This is Clark Evans's interpretation (also in the spec
+                # examples):
+                #
+                #if folded and line_break == '\n':
+                #    if not breaks:
+                #        if self.peek() not in ' \t':
+                #            chunks.append(' ')
+                #        else:
+                #            chunks.append(line_break)
+                #else:
+                #    chunks.append(line_break)
+            else:
+                break
+
+        # Chomp the tail.
+        if chomping is not False:
+            chunks.append(line_break)
+        if chomping is True:
+            chunks.extend(breaks)
+
+        # We are done.
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    def scan_block_scalar_indicators(self, start_mark):
+        # See the specification for details.
+        chomping = None
+        increment = None
+        ch = self.peek()
+        if ch in '+-':
+            if ch == '+':
+                chomping = True
+            else:
+                chomping = False
+            self.forward()
+            ch = self.peek()
+            if ch in '0123456789':
+                increment = int(ch)
+                if increment == 0:
+                    raise ScannerError("while scanning a block scalar", start_mark,
+                            "expected indentation indicator in the range 1-9, but found 0",
+                            self.get_mark())
+                self.forward()
+        elif ch in '0123456789':
+            increment = int(ch)
+            if increment == 0:
+                raise ScannerError("while scanning a block scalar", start_mark,
+                        "expected indentation indicator in the range 1-9, but found 0",
+                        self.get_mark())
+            self.forward()
+            ch = self.peek()
+            if ch in '+-':
+                if ch == '+':
+                    chomping = True
+                else:
+                    chomping = False
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0 \r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected chomping or indentation indicators, but found %r"
+                    % ch, self.get_mark())
+        return chomping, increment
+
+    def scan_block_scalar_ignored_line(self, start_mark):
+        # See the specification for details.
+        while self.peek() == ' ':
+            self.forward()
+        if self.peek() == '#':
+            while self.peek() not in '\0\r\n\x85\u2028\u2029':
+                self.forward()
+        ch = self.peek()
+        if ch not in '\0\r\n\x85\u2028\u2029':
+            raise ScannerError("while scanning a block scalar", start_mark,
+                    "expected a comment or a line break, but found %r" % ch,
+                    self.get_mark())
+        self.scan_line_break()
+
+    def scan_block_scalar_indentation(self):
+        # See the specification for details.
+        chunks = []
+        max_indent = 0
+        end_mark = self.get_mark()
+        while self.peek() in ' \r\n\x85\u2028\u2029':
+            if self.peek() != ' ':
+                chunks.append(self.scan_line_break())
+                end_mark = self.get_mark()
+            else:
+                self.forward()
+                if self.column > max_indent:
+                    max_indent = self.column
+        return chunks, max_indent, end_mark
+
+    def scan_block_scalar_breaks(self, indent):
+        # See the specification for details.
+        chunks = []
+        end_mark = self.get_mark()
+        while self.column < indent and self.peek() == ' ':
+            self.forward()
+        while self.peek() in '\r\n\x85\u2028\u2029':
+            chunks.append(self.scan_line_break())
+            end_mark = self.get_mark()
+            while self.column < indent and self.peek() == ' ':
+                self.forward()
+        return chunks, end_mark
+
+    def scan_flow_scalar(self, style):
+        # See the specification for details.
+        # Note that we loose indentation rules for quoted scalars. Quoted
+        # scalars don't need to adhere indentation because " and ' clearly
+        # mark the beginning and the end of them. Therefore we are less
+        # restrictive then the specification requires. We only need to check
+        # that document separators are not included in scalars.
+        if style == '"':
+            double = True
+        else:
+            double = False
+        chunks = []
+        start_mark = self.get_mark()
+        quote = self.peek()
+        self.forward()
+        chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        while self.peek() != quote:
+            chunks.extend(self.scan_flow_scalar_spaces(double, start_mark))
+            chunks.extend(self.scan_flow_scalar_non_spaces(double, start_mark))
+        self.forward()
+        end_mark = self.get_mark()
+        return ScalarToken(''.join(chunks), False, start_mark, end_mark,
+                style)
+
+    ESCAPE_REPLACEMENTS = {
+        '0':    '\0',
+        'a':    '\x07',
+        'b':    '\x08',
+        't':    '\x09',
+        '\t':   '\x09',
+        'n':    '\x0A',
+        'v':    '\x0B',
+        'f':    '\x0C',
+        'r':    '\x0D',
+        'e':    '\x1B',
+        ' ':    '\x20',
+        '\"':   '\"',
+        '\\':   '\\',
+        '/':    '/',
+        'N':    '\x85',
+        '_':    '\xA0',
+        'L':    '\u2028',
+        'P':    '\u2029',
+    }
+
+    ESCAPE_CODES = {
+        'x':    2,
+        'u':    4,
+        'U':    8,
+    }
+
+    def scan_flow_scalar_non_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            length = 0
+            while self.peek(length) not in '\'\"\\\0 \t\r\n\x85\u2028\u2029':
+                length += 1
+            if length:
+                chunks.append(self.prefix(length))
+                self.forward(length)
+            ch = self.peek()
+            if not double and ch == '\'' and self.peek(1) == '\'':
+                chunks.append('\'')
+                self.forward(2)
+            elif (double and ch == '\'') or (not double and ch in '\"\\'):
+                chunks.append(ch)
+                self.forward()
+            elif double and ch == '\\':
+                self.forward()
+                ch = self.peek()
+                if ch in self.ESCAPE_REPLACEMENTS:
+                    chunks.append(self.ESCAPE_REPLACEMENTS[ch])
+                    self.forward()
+                elif ch in self.ESCAPE_CODES:
+                    length = self.ESCAPE_CODES[ch]
+                    self.forward()
+                    for k in range(length):
+                        if self.peek(k) not in '0123456789ABCDEFabcdef':
+                            raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                                    "expected escape sequence of %d hexdecimal numbers, but found %r" %
+                                        (length, self.peek(k)), self.get_mark())
+                    code = int(self.prefix(length), 16)
+                    chunks.append(chr(code))
+                    self.forward(length)
+                elif ch in '\r\n\x85\u2028\u2029':
+                    self.scan_line_break()
+                    chunks.extend(self.scan_flow_scalar_breaks(double, start_mark))
+                else:
+                    raise ScannerError("while scanning a double-quoted scalar", start_mark,
+                            "found unknown escape character %r" % ch, self.get_mark())
+            else:
+                return chunks
+
+    def scan_flow_scalar_spaces(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        length = 0
+        while self.peek(length) in ' \t':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch == '\0':
+            raise ScannerError("while scanning a quoted scalar", start_mark,
+                    "found unexpected end of stream", self.get_mark())
+        elif ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            breaks = self.scan_flow_scalar_breaks(double, start_mark)
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        else:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_flow_scalar_breaks(self, double, start_mark):
+        # See the specification for details.
+        chunks = []
+        while True:
+            # Instead of checking indentation, we check for document
+            # separators.
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                raise ScannerError("while scanning a quoted scalar", start_mark,
+                        "found unexpected document separator", self.get_mark())
+            while self.peek() in ' \t':
+                self.forward()
+            if self.peek() in '\r\n\x85\u2028\u2029':
+                chunks.append(self.scan_line_break())
+            else:
+                return chunks
+
+    def scan_plain(self):
+        # See the specification for details.
+        # We add an additional restriction for the flow context:
+        #   plain scalars in the flow context cannot contain ',' or '?'.
+        # We also keep track of the `allow_simple_key` flag here.
+        # Indentation rules are loosed for the flow context.
+        chunks = []
+        start_mark = self.get_mark()
+        end_mark = start_mark
+        indent = self.indent+1
+        # We allow zero indentation for scalars, but then we need to check for
+        # document separators at the beginning of the line.
+        #if indent == 0:
+        #    indent = 1
+        spaces = []
+        while True:
+            length = 0
+            if self.peek() == '#':
+                break
+            while True:
+                ch = self.peek(length)
+                if ch in '\0 \t\r\n\x85\u2028\u2029'    \
+                        or (ch == ':' and
+                                self.peek(length+1) in '\0 \t\r\n\x85\u2028\u2029'
+                                      + (u',[]{}' if self.flow_level else u''))\
+                        or (self.flow_level and ch in ',?[]{}'):
+                    break
+                length += 1
+            if length == 0:
+                break
+            self.allow_simple_key = False
+            chunks.extend(spaces)
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            end_mark = self.get_mark()
+            spaces = self.scan_plain_spaces(indent, start_mark)
+            if not spaces or self.peek() == '#' \
+                    or (not self.flow_level and self.column < indent):
+                break
+        return ScalarToken(''.join(chunks), True, start_mark, end_mark)
+
+    def scan_plain_spaces(self, indent, start_mark):
+        # See the specification for details.
+        # The specification is really confusing about tabs in plain scalars.
+        # We just forbid them completely. Do not use tabs in YAML!
+        chunks = []
+        length = 0
+        while self.peek(length) in ' ':
+            length += 1
+        whitespaces = self.prefix(length)
+        self.forward(length)
+        ch = self.peek()
+        if ch in '\r\n\x85\u2028\u2029':
+            line_break = self.scan_line_break()
+            self.allow_simple_key = True
+            prefix = self.prefix(3)
+            if (prefix == '---' or prefix == '...')   \
+                    and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                return
+            breaks = []
+            while self.peek() in ' \r\n\x85\u2028\u2029':
+                if self.peek() == ' ':
+                    self.forward()
+                else:
+                    breaks.append(self.scan_line_break())
+                    prefix = self.prefix(3)
+                    if (prefix == '---' or prefix == '...')   \
+                            and self.peek(3) in '\0 \t\r\n\x85\u2028\u2029':
+                        return
+            if line_break != '\n':
+                chunks.append(line_break)
+            elif not breaks:
+                chunks.append(' ')
+            chunks.extend(breaks)
+        elif whitespaces:
+            chunks.append(whitespaces)
+        return chunks
+
+    def scan_tag_handle(self, name, start_mark):
+        # See the specification for details.
+        # For some strange reasons, the specification does not allow '_' in
+        # tag handles. I have allowed it anyway.
+        ch = self.peek()
+        if ch != '!':
+            raise ScannerError("while scanning a %s" % name, start_mark,
+                    "expected '!', but found %r" % ch, self.get_mark())
+        length = 1
+        ch = self.peek(length)
+        if ch != ' ':
+            while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                    or ch in '-_':
+                length += 1
+                ch = self.peek(length)
+            if ch != '!':
+                self.forward(length)
+                raise ScannerError("while scanning a %s" % name, start_mark,
+                        "expected '!', but found %r" % ch, self.get_mark())
+            length += 1
+        value = self.prefix(length)
+        self.forward(length)
+        return value
+
+    def scan_tag_uri(self, name, start_mark):
+        # See the specification for details.
+        # Note: we do not check if URI is well-formed.
+        chunks = []
+        length = 0
+        ch = self.peek(length)
+        while '0' <= ch <= '9' or 'A' <= ch <= 'Z' or 'a' <= ch <= 'z'  \
+                or ch in '-;/?:@&=+$,_.!~*\'()[]%':
+            if ch == '%':
+                chunks.append(self.prefix(length))
+                self.forward(length)
+                length = 0
+                chunks.append(self.scan_uri_escapes(name, start_mark))
+            else:
+                length += 1
+            ch = self.peek(length)
+        if length:
+            chunks.append(self.prefix(length))
+            self.forward(length)
+            length = 0
+        if not chunks:
+            raise ScannerError("while parsing a %s" % name, start_mark,
+                    "expected URI, but found %r" % ch, self.get_mark())
+        return ''.join(chunks)
+
+    def scan_uri_escapes(self, name, start_mark):
+        # See the specification for details.
+        codes = []
+        mark = self.get_mark()
+        while self.peek() == '%':
+            self.forward()
+            for k in range(2):
+                if self.peek(k) not in '0123456789ABCDEFabcdef':
+                    raise ScannerError("while scanning a %s" % name, start_mark,
+                            "expected URI escape sequence of 2 hexdecimal numbers, but found %r"
+                            % self.peek(k), self.get_mark())
+            codes.append(int(self.prefix(2), 16))
+            self.forward(2)
+        try:
+            value = bytes(codes).decode('utf-8')
+        except UnicodeDecodeError as exc:
+            raise ScannerError("while scanning a %s" % name, start_mark, str(exc), mark)
+        return value
+
+    def scan_line_break(self):
+        # Transforms:
+        #   '\r\n'      :   '\n'
+        #   '\r'        :   '\n'
+        #   '\n'        :   '\n'
+        #   '\x85'      :   '\n'
+        #   '\u2028'    :   '\u2028'
+        #   '\u2029     :   '\u2029'
+        #   default     :   ''
+        ch = self.peek()
+        if ch in '\r\n\x85':
+            if self.prefix(2) == '\r\n':
+                self.forward(2)
+            else:
+                self.forward()
+            return '\n'
+        elif ch in '\u2028\u2029':
+            self.forward()
+            return ch
+        return ''
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/serializer.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/serializer.py
new file mode 100644
index 0000000000000000000000000000000000000000..fe911e67ae7a739abb491fbbc6834b9c37bbda4b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/serializer.py
@@ -0,0 +1,111 @@
+
+__all__ = ['Serializer', 'SerializerError']
+
+from .error import YAMLError
+from .events import *
+from .nodes import *
+
+class SerializerError(YAMLError):
+    pass
+
+class Serializer:
+
+    ANCHOR_TEMPLATE = 'id%03d'
+
+    def __init__(self, encoding=None,
+            explicit_start=None, explicit_end=None, version=None, tags=None):
+        self.use_encoding = encoding
+        self.use_explicit_start = explicit_start
+        self.use_explicit_end = explicit_end
+        self.use_version = version
+        self.use_tags = tags
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+        self.closed = None
+
+    def open(self):
+        if self.closed is None:
+            self.emit(StreamStartEvent(encoding=self.use_encoding))
+            self.closed = False
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        else:
+            raise SerializerError("serializer is already opened")
+
+    def close(self):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif not self.closed:
+            self.emit(StreamEndEvent())
+            self.closed = True
+
+    #def __del__(self):
+    #    self.close()
+
+    def serialize(self, node):
+        if self.closed is None:
+            raise SerializerError("serializer is not opened")
+        elif self.closed:
+            raise SerializerError("serializer is closed")
+        self.emit(DocumentStartEvent(explicit=self.use_explicit_start,
+            version=self.use_version, tags=self.use_tags))
+        self.anchor_node(node)
+        self.serialize_node(node, None, None)
+        self.emit(DocumentEndEvent(explicit=self.use_explicit_end))
+        self.serialized_nodes = {}
+        self.anchors = {}
+        self.last_anchor_id = 0
+
+    def anchor_node(self, node):
+        if node in self.anchors:
+            if self.anchors[node] is None:
+                self.anchors[node] = self.generate_anchor(node)
+        else:
+            self.anchors[node] = None
+            if isinstance(node, SequenceNode):
+                for item in node.value:
+                    self.anchor_node(item)
+            elif isinstance(node, MappingNode):
+                for key, value in node.value:
+                    self.anchor_node(key)
+                    self.anchor_node(value)
+
+    def generate_anchor(self, node):
+        self.last_anchor_id += 1
+        return self.ANCHOR_TEMPLATE % self.last_anchor_id
+
+    def serialize_node(self, node, parent, index):
+        alias = self.anchors[node]
+        if node in self.serialized_nodes:
+            self.emit(AliasEvent(alias))
+        else:
+            self.serialized_nodes[node] = True
+            self.descend_resolver(parent, index)
+            if isinstance(node, ScalarNode):
+                detected_tag = self.resolve(ScalarNode, node.value, (True, False))
+                default_tag = self.resolve(ScalarNode, node.value, (False, True))
+                implicit = (node.tag == detected_tag), (node.tag == default_tag)
+                self.emit(ScalarEvent(alias, node.tag, implicit, node.value,
+                    style=node.style))
+            elif isinstance(node, SequenceNode):
+                implicit = (node.tag
+                            == self.resolve(SequenceNode, node.value, True))
+                self.emit(SequenceStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                index = 0
+                for item in node.value:
+                    self.serialize_node(item, node, index)
+                    index += 1
+                self.emit(SequenceEndEvent())
+            elif isinstance(node, MappingNode):
+                implicit = (node.tag
+                            == self.resolve(MappingNode, node.value, True))
+                self.emit(MappingStartEvent(alias, node.tag, implicit,
+                    flow_style=node.flow_style))
+                for key, value in node.value:
+                    self.serialize_node(key, node, None)
+                    self.serialize_node(value, node, key)
+                self.emit(MappingEndEvent())
+            self.ascend_resolver()
+
diff --git a/SOL004/magma/squid_cnf/charms/squid/venv/yaml/tokens.py b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/tokens.py
new file mode 100644
index 0000000000000000000000000000000000000000..4d0b48a394ac8c019b401516a12f688df361cf90
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid/venv/yaml/tokens.py
@@ -0,0 +1,104 @@
+
+class Token(object):
+    def __init__(self, start_mark, end_mark):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+    def __repr__(self):
+        attributes = [key for key in self.__dict__
+                if not key.endswith('_mark')]
+        attributes.sort()
+        arguments = ', '.join(['%s=%r' % (key, getattr(self, key))
+                for key in attributes])
+        return '%s(%s)' % (self.__class__.__name__, arguments)
+
+#class BOMToken(Token):
+#    id = '<byte order mark>'
+
+class DirectiveToken(Token):
+    id = '<directive>'
+    def __init__(self, name, value, start_mark, end_mark):
+        self.name = name
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class DocumentStartToken(Token):
+    id = '<document start>'
+
+class DocumentEndToken(Token):
+    id = '<document end>'
+
+class StreamStartToken(Token):
+    id = '<stream start>'
+    def __init__(self, start_mark=None, end_mark=None,
+            encoding=None):
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.encoding = encoding
+
+class StreamEndToken(Token):
+    id = '<stream end>'
+
+class BlockSequenceStartToken(Token):
+    id = '<block sequence start>'
+
+class BlockMappingStartToken(Token):
+    id = '<block mapping start>'
+
+class BlockEndToken(Token):
+    id = '<block end>'
+
+class FlowSequenceStartToken(Token):
+    id = '['
+
+class FlowMappingStartToken(Token):
+    id = '{'
+
+class FlowSequenceEndToken(Token):
+    id = ']'
+
+class FlowMappingEndToken(Token):
+    id = '}'
+
+class KeyToken(Token):
+    id = '?'
+
+class ValueToken(Token):
+    id = ':'
+
+class BlockEntryToken(Token):
+    id = '-'
+
+class FlowEntryToken(Token):
+    id = ','
+
+class AliasToken(Token):
+    id = '<alias>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class AnchorToken(Token):
+    id = '<anchor>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class TagToken(Token):
+    id = '<tag>'
+    def __init__(self, value, start_mark, end_mark):
+        self.value = value
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+
+class ScalarToken(Token):
+    id = '<scalar>'
+    def __init__(self, value, plain, start_mark, end_mark, style=None):
+        self.value = value
+        self.plain = plain
+        self.start_mark = start_mark
+        self.end_mark = end_mark
+        self.style = style
+
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/README.md b/SOL004/magma/squid_cnf/charms/squid_src/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..1b226214256240e150d1cb34fdc75fb0b0bf412b
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/README.md
@@ -0,0 +1,47 @@
+# squid-k8s Charm
+
+## Overview
+
+This is a Kuberentes Charm to deploy [Squid Cache](http://www.squid-cache.org/).
+
+Sugested Actions for this charm:
+* Set allowed URLs
+  Possible way to run action: `juju run-action squid/0 addurl url=google.com`
+* Stop/Start/Restart the squid service - done
+  Run like this: `juju run-action squid/0 restart`
+* Set ftp, http, https proxies
+
+## Quickstart
+
+If you don't have microk8s and juju installed executing the following commands:
+```
+sudo snap install juju --classic
+sudo snap install microk8s --classic
+juju bootstrap microk8s
+juju add-model squid
+```
+
+Afterwards clone the repository and deploy the charm
+```
+git clone https://github.com/DomFleischmann/charm-squid-k8s.git
+cd charm-squid-k8s
+git submodule update --init
+juju deploy .
+```
+Check if the charm is deployed correctly with `juju status`
+
+To test the `addurl` action open another terminal and type the following command:
+`export https_proxy=http://<squid-ip>:3128`
+
+Where squid-ip is the Squid App Address shown in `juju status`
+
+Now when executing `curl https://www.google.com` squid will block access to the url
+
+Execute the `addurl` action:
+`juju run-action squid/0 addurl url=google.com`
+
+Now when executing `curl https://www.google.com` it will give you the google output.
+
+## Contact
+ - Author: Dominik Fleischmann <dominik.fleischmann@canonical.com>
+ - Bug Tracker: [here](https://github.com/DomFleischmann/charm-squid-k8s)
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/actions.yaml b/SOL004/magma/squid_cnf/charms/squid_src/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3e57d8e3987419e2857c90ffdef8a8a9bff4256f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/actions.yaml
@@ -0,0 +1,14 @@
+addurl:
+    description: "Add allowed URL to squid config"
+    params:
+        url:
+            description: "URL that will be allowed"
+            type: string
+            default: ""
+deleteurl:
+    description: "Delete allowed URL squid config"
+    params:
+        url:
+            description: "URL that will stop to be allowed"
+            type: string
+            default: ""
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/config.yaml b/SOL004/magma/squid_cnf/charms/squid_src/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..450525eeed2cb05b0cf347357d67b3693f8c192f
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/config.yaml
@@ -0,0 +1,5 @@
+options:
+    port:
+        type: int
+        description: "Port"
+        default: 3128
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/metadata.yaml b/SOL004/magma/squid_cnf/charms/squid_src/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aabf09bc24512226f22974867fb69bd768fdae4d
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/metadata.yaml
@@ -0,0 +1,24 @@
+name: squid
+summary: Describe your charm here
+maintainers:
+    - Dominik Fleischmann <dominik.fleischmann@canonical.com>
+description: |
+    A nice long description of what the product does and any
+    high level information about how the charm provides the product,
+    on which platform, etc.
+tags:
+    - misc
+series:
+    - kubernetes
+deployment:
+    type: stateful
+    service: loadbalancer
+storage:
+    spool:
+        type: filesystem
+        location: /var/spool/squid
+resources:
+  image:
+    type: oci-image
+    description: OSM docker image for LCM
+    upstream-source: "domfleischmann/squid-python"
\ No newline at end of file
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/requirements.txt b/SOL004/magma/squid_cnf/charms/squid_src/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4da6f5fe4169cdf33fb85954f2ea3db2290f3fc8
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/requirements.txt
@@ -0,0 +1,3 @@
+ops
+jinja2
+git+https://github.com/juju-solutions/resource-oci-image/@c5778285d332edf3d9a538f9d0c06154b7ec1b0b#egg=oci-image
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/squid.charm b/SOL004/magma/squid_cnf/charms/squid_src/squid.charm
new file mode 100644
index 0000000000000000000000000000000000000000..00ca09ed1e2947b3e934e45bf8fd81abefdbbc5a
Binary files /dev/null and b/SOL004/magma/squid_cnf/charms/squid_src/squid.charm differ
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/src/charm.py b/SOL004/magma/squid_cnf/charms/squid_src/src/charm.py
new file mode 100755
index 0000000000000000000000000000000000000000..e861c025273141d723b5d82f14d59b5b4f997a94
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/src/charm.py
@@ -0,0 +1,114 @@
+#! /usr/bin/env python3
+
+import logging
+import subprocess
+
+from ops.main import main
+from ops.charm import CharmBase
+from ops.framework import StoredState
+from ops.main import main
+from ops.model import ActiveStatus, MaintenanceStatus, BlockedStatus
+
+from oci_image import OCIImageResource, OCIImageResourceError
+
+from jinja2 import Template
+
+SQUID_CONF = "/etc/squid/squid.conf"
+
+logger = logging.getLogger(__name__)
+
+
+class SquidK8SCharm(CharmBase):
+    """Class reprisenting this Operator charm."""
+
+    _stored = StoredState()
+
+    def __init__(self, *args):
+        """Initialize charm and configure states and events to observe."""
+        super().__init__(*args)
+        self._stored.set_default(pod_spec=None, allowedurls=set())
+
+        self.framework.observe(self.on.start, self.configure_pod)
+        self.framework.observe(self.on.config_changed, self.configure_pod)
+        self.framework.observe(self.on.addurl_action, self.on_addurl_action)
+        self.framework.observe(self.on.deleteurl_action, self.on_deleteurl_action)
+
+        self.image = OCIImageResource(self, "image")
+
+    def _update_allowed_urls(self, add: str = None, delete: str = None):
+        if add:
+            self._stored.allowedurls.add(add)
+        if delete and delete in self._stored.allowedurls:
+            self._stored.allowedurls.remove(delete)
+
+    def _update_squid_config(self, add: str = None, delete: str = None):
+        self._update_allowed_urls(add=add, delete=delete)
+        squid_config_text = self._get_squid_config_file_text()
+        if squid_config_text:
+            with open(SQUID_CONF, "w") as f:
+                f.write(squid_config_text)
+            subprocess.Popen(
+                "sleep 1 && kill -HUP `cat /var/run/squid.pid`", shell=True
+            )
+
+    def on_addurl_action(self, event):
+        url = event.params["url"]
+        self._update_squid_config(add=url)
+
+    def on_deleteurl_action(self, event):
+        """Handle the deleteurl action."""
+        url = event.params["url"]
+        self._update_squid_config(delete=url)
+
+    def _get_squid_config_file_text(self):
+        squid_config_text = None
+        allowed_urls_text = ""
+        for url in self._stored.allowedurls:
+            allowed_urls_text += f"acl allowedurls dstdomain .{url}\n"
+        allowed_urls_text += "http_access allow allowedurls\n"
+        with open("template/squid.conf") as template:
+            squid_config_text = Template(template.read()).render(
+                allowed_urls=allowed_urls_text
+            )
+        return squid_config_text
+
+    def configure_pod(self, event):
+        if not self.unit.is_leader():
+            self.unit.status = ActiveStatus("ready")
+            return
+        self.unit.status = MaintenanceStatus("Applying pod spec")
+
+        # Fetch image information
+        try:
+            self.unit.status = MaintenanceStatus("Fetching image information")
+            image_info = self.image.fetch()
+        except OCIImageResourceError:
+            self.unit.status = BlockedStatus("Error fetching image information")
+            return
+
+        pod_spec = self._make_pod_spec(image_info)
+
+        if self._stored.pod_spec != pod_spec:
+            self.model.pod.set_spec(pod_spec)
+            self._stored.pod_spec = pod_spec
+        self.unit.status = ActiveStatus("ready")
+
+    def _make_pod_spec(self, image_info):
+        config = self.config
+        ports = [{"name": "squid", "containerPort": config["port"], "protocol": "TCP"}]
+
+        spec = {
+            "version": 3,
+            "containers": [
+                {
+                    "name": self.framework.model.app.name,
+                    "imageDetails": image_info,
+                    "ports": ports,
+                }
+            ],
+        }
+        return spec
+
+
+if __name__ == "__main__":
+    main(SquidK8SCharm)
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/template/squid.conf b/SOL004/magma/squid_cnf/charms/squid_src/template/squid.conf
new file mode 100644
index 0000000000000000000000000000000000000000..9dc7e8b664d007c9d6dc452dffdc7fe47358d1b2
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/template/squid.conf
@@ -0,0 +1,26 @@
+acl SSL_ports port 443
+acl Safe_ports port 80		# http
+acl Safe_ports port 21		# ftp
+acl Safe_ports port 443		# https
+acl Safe_ports port 70		# gopher
+acl Safe_ports port 210		# wais
+acl Safe_ports port 1025-65535	# unregistered ports
+acl Safe_ports port 280		# http-mgmt
+acl Safe_ports port 488		# gss-http
+acl Safe_ports port 591		# filemaker
+acl Safe_ports port 777		# multiling http
+acl CONNECT method CONNECT
+http_access deny !Safe_ports
+http_access deny CONNECT !SSL_ports
+http_access allow localhost manager
+http_access deny manager
+http_access allow localhost
+{{ allowed_urls }}
+http_access deny all
+http_port 3128
+coredump_dir /var/spool/squid
+refresh_pattern ^ftp:		1440	20%	10080
+refresh_pattern ^gopher:	1440	0%	1440
+refresh_pattern -i (/cgi-bin/|\?) 0	0%	0
+refresh_pattern (Release|Packages(.gz)*)$      0       20%     2880
+refresh_pattern .		0	20%	4320
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/requirements.txt b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..b7c9112db138bffa4c67040e8744b42d68d95855
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/requirements.txt
@@ -0,0 +1 @@
+git+https://github.com/openstack-charmers/zaza.git#egg=zaza
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/bionic.yaml b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/bionic.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ef41a680a0b67e54534aac274f6aaa096ac13fbe
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/bionic.yaml
@@ -0,0 +1,6 @@
+series: bionic
+
+applications:
+    squid:
+        charm: ../../../../
+        num_units: 1
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/xenial.yaml b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/xenial.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c4e9580146a4369981ee4c5ce567b5b1db4333e4
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/bundles/xenial.yaml
@@ -0,0 +1,7 @@
+series: xenial
+
+applications:
+    squid:
+        charm: ../../../../
+        num_units: 1
+
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/tests.yaml b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/tests.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aa92ccb5d20cfc6e7e877aed029f51dd64141146
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/functional/tests/tests.yaml
@@ -0,0 +1,17 @@
+tests:
+# - bionic_model:
+#   - zaza.charm_tests.noop.tests.NoopTestBionic
+# - xenial_model:
+#   - zaza.charm_tests.noop.tests.NoopTestXenial
+ - zaza.charm_tests.noop.tests.NoopTest
+configure:
+# - bionic_model:
+#   - zaza.charm_tests.noop.setup.basic_setup_bionic
+# - xenial_model:
+#   - zaza.charm_tests.noop.setup.basic_setup_xenial
+ - zaza.charm_tests.noop.setup.basic_setup
+gate_bundles:
+    - xenial
+    - bionic
+smoke_bundles:
+    - focal
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/operator_fixtures.py b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/operator_fixtures.py
new file mode 100644
index 0000000000000000000000000000000000000000..a9462fc97e0f4174113eb1a4496dac28f99e6394
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/operator_fixtures.py
@@ -0,0 +1,113 @@
+#! /usr/bin/env python3
+# -*- coding: utf-8 -*-
+# vim:fenc=utf-8
+# Copyright © 2020 Dominik Fleischmann dominik.fleischmann@canonical.com
+# Distributed under terms of the GPL license.
+"""Operator Charm test fixtures."""
+
+import os
+import tempfile
+import unittest
+
+import setuppath  # noqa:F401
+import mock
+import ops
+import ops.main
+from src.charm import Squid-K8SCharm
+
+
+class OperatorTestCase(unittest.TestCase):
+    """Fixtures for unit testing operator charms."""
+
+    @classmethod
+    def setUpClass(cls):
+        """Setup class fixture."""
+        # Setup a tmpdir
+        cls.tmpdir = tempfile.TemporaryDirectory()
+
+        # Store patchers for test cases that want them
+        cls.patchers = {}
+
+        # Prevent framwork from trying to call subprocesses
+        run_patcher = mock.patch("ops.model.ModelBackend._run")
+        cls.patchers["ops.model.ModelBackend._run"] = run_patcher.start()
+
+        # Stop unit test from calling fchown
+        fchown_patcher = mock.patch("os.fchown")
+        cls.patchers["os.fchown"] = fchown_patcher.start()
+        chown_patcher = mock.patch("os.chown")
+        cls.patchers["os.chown"] = chown_patcher.start()
+
+        # Setup mock JUJU Environment variables
+        os.environ["JUJU_UNIT_NAME"] = "mock/0"
+        os.environ["JUJU_CHARM_DIR"] = "."
+
+    @classmethod
+    def tearDownClass(cls):
+        """Tear down class fixture."""
+        mock.patch.stopall()
+        cls.tmpdir.cleanup()
+
+    def setUp(self):
+        """Setup test fixture."""
+        # Create a charm instance
+        model_backend = ops.model.ModelBackend()
+        ops.main.setup_root_logging(model_backend)
+        charm_dir = ops.main._get_charm_dir()
+        metadata, actions_metadata = ops.main._load_metadata(charm_dir)
+        meta = ops.charm.CharmMeta(metadata, actions_metadata)
+        unit_name = os.environ["JUJU_UNIT_NAME"]
+        model = ops.model.Model(unit_name, meta, model_backend)
+        framework = ops.framework.Framework(":memory:", charm_dir, meta, model)
+        charm = Squid-K8SCharm(framework, None)
+        self.charm = charm
+
+    def tearDown(self):
+        """Clean up test fixture."""
+        # Remove runtime class attributes to avoid error on next setUp
+
+        for relation_name in self.charm.framework.meta.relations:
+            relation_name = relation_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_joined")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_changed")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_departed")
+            delattr(ops.charm.CharmEvents, relation_name + "_relation_broken")
+
+        for storage_name in self.charm.framework.meta.storages:
+            storage_name = storage_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, storage_name + "_storage_attached")
+            delattr(ops.charm.CharmEvents, storage_name + "_storage_detaching")
+
+        for action_name in self.charm.framework.meta.actions:
+            action_name = action_name.replace("-", "_")
+            delattr(ops.charm.CharmEvents, action_name + "_action")
+
+    def emit(self, event):
+        """Emit the named hook on the charm."""
+        self.charm.framework.reemit()
+
+        if "_relation_" in event:
+            relation_name = event.split("_relation")[0].replace("_", "-")
+            with mock.patch.dict(
+                "os.environ",
+                {
+                    "JUJU_RELATION": relation_name,
+                    "JUJU_RELATION_ID": "1",
+                    "JUJU_REMOTE_APP": "mock",
+                    "JUJU_REMOTE_UNIT": "mock/0",
+                },
+            ):
+                ops.main._emit_charm_event(self.charm, event)
+        else:
+            ops.main._emit_charm_event(self.charm, event)
+
+    def get_notice_count(self, hook):
+        """Return the notice count for a given charm hook."""
+        notice_count = 0
+        handle = "Squid-K8SCharm/on/{}".format(hook)
+
+        for event_path, _, _ in self.charm.framework._storage.notices(None):
+            if event_path.startswith(handle):
+                notice_count += 1
+
+        return notice_count
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/requirements.txt b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/requirements.txt
new file mode 100644
index 0000000000000000000000000000000000000000..ba6b0ee1ed8feb744c0fcc2ff0477dc80d32dff3
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/requirements.txt
@@ -0,0 +1,3 @@
+mock
+pyyaml
+coverage
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/setuppath.py b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/setuppath.py
new file mode 100644
index 0000000000000000000000000000000000000000..736da20c9af4f47e0184168c10de70e23759495a
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/setuppath.py
@@ -0,0 +1,2 @@
+import sys
+sys.path.append('lib')
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/test_charm.py b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/test_charm.py
new file mode 100644
index 0000000000000000000000000000000000000000..dc64b799608c598358d3d010c53f9dfcbc7b7fb5
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tests/unit/test_charm.py
@@ -0,0 +1,19 @@
+import unittest
+
+import setuppath  # noqa:F401
+from operator_fixtures import OperatorTestCase
+
+
+class TestCharm(OperatorTestCase):
+    def test_create_charm(self):
+        """Verify fixtures and create a charm."""
+        self.assertEqual(self.charm.state.installed, False)
+
+    def test_install(self):
+        """Test emitting an install hook."""
+        self.emit("install")
+        self.assertEqual(self.charm.state.installed, True)
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/SOL004/magma/squid_cnf/charms/squid_src/tox.ini b/SOL004/magma/squid_cnf/charms/squid_src/tox.ini
new file mode 100644
index 0000000000000000000000000000000000000000..a2476324f8eea6fdb222b4f382057849e8d85f44
--- /dev/null
+++ b/SOL004/magma/squid_cnf/charms/squid_src/tox.ini
@@ -0,0 +1,46 @@
+[tox]
+skipsdist = True
+envlist = unit, functional
+skip_missing_interpreters = True
+
+[testenv]
+basepython = python3
+setenv =
+  PYTHONPATH = {toxinidir}/lib/:{toxinidir}
+passenv = HOME
+
+[testenv:unit]
+commands = 
+    coverage run -m unittest discover -s {toxinidir}/tests/unit -v
+    coverage report \
+	--omit tests/*,mod/*,.tox/*
+    coverage html \
+	--omit tests/*,mod/*,.tox/*
+deps = -r{toxinidir}/tests/unit/requirements.txt
+
+[testenv:functional]
+changedir = {toxinidir}/tests/functional
+commands = functest-run-suite {posargs}
+deps = -r{toxinidir}/tests/functional/requirements.txt
+
+[testenv:lint]
+commands = flake8
+deps =
+    flake8
+    flake8-docstrings
+    flake8-import-order
+    pep8-naming
+    flake8-colors
+
+[flake8]
+exclude =
+    .git,
+    __pycache__,
+    .tox,
+    mod,
+max-line-length = 120
+max-complexity = 10
+import-order-style = google
+
+[isort]
+force_to_top=setuppath
diff --git a/SOL004/magma/squid_cnf/juju-bundles/bundle.yaml b/SOL004/magma/squid_cnf/juju-bundles/bundle.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..aa5ef70788be0248f3391051c59aeaf38c0d3c4c
--- /dev/null
+++ b/SOL004/magma/squid_cnf/juju-bundles/bundle.yaml
@@ -0,0 +1,9 @@
+description: Squid Bundle
+bundle: kubernetes
+applications:
+  squid:
+    charm: cs:~charmed-osm/squid
+    scale: 1
+    #    storage:
+    #      docker: 50M
+    #      spool: 50M
diff --git a/SOL004/magma/squid_cnf/squid_vnfd.yaml b/SOL004/magma/squid_cnf/squid_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..424020aff05ef6304160e7abfd9606ed52d22fca
--- /dev/null
+++ b/SOL004/magma/squid_cnf/squid_vnfd.yaml
@@ -0,0 +1,39 @@
+vnfd:
+  description: K8s container deployment of Squid Web Proxy
+  df:
+  - id: default-df
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+          - id: squid-kdu
+            config-primitive:
+            - name: addurl
+              parameter:
+              - data-type: STRING
+                default-value: squid
+                name: application-name
+              - data-type: STRING
+                default-value: ''
+                name: url
+            - name: deleteurl
+              parameter:
+              - data-type: STRING
+                default-value: squid
+                name: application-name
+              - data-type: STRING
+                default-value: ''
+                name: url
+  ext-cpd:
+  - id: mgmtnet-ext
+    k8s-cluster-net: mgmtnet
+  id: squid_cnf
+  k8s-cluster:
+    nets:
+    - id: mgmtnet
+  kdu:
+  - name: squid-kdu
+    juju-bundle: bundle.yaml     
+  mgmt-cp: mgmtnet-ext
+  product-name: squid_cnf
+  provider: Canonical
+  version: '1.0'
diff --git a/SOL004/magma/squid_cnf_ns/squid_cnf_nsd.yaml b/SOL004/magma/squid_cnf_ns/squid_cnf_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..871a35feeb39b777e13f0848c925f77894fc8bc0
--- /dev/null
+++ b/SOL004/magma/squid_cnf_ns/squid_cnf_nsd.yaml
@@ -0,0 +1,23 @@
+nsd:
+  nsd:
+  - description: NS with 1 KDU connected to the mgmtnet VL
+    designer: Canonical
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: squid_cnf
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: squid_cnf
+            constituent-cpd-id: mgmtnet-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: squid_cnf
+    id: squid_cnf_ns
+    name: squid_cnf_ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+      vim-network-name: mgmt
+    vnfd-id:
+    - squid_cnf
diff --git a/SOL004/magma/vnf_price_list.yaml b/SOL004/magma/vnf_price_list.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..78e60c44e340cbe6bd2790c5cb6e8aa1826e1b71
--- /dev/null
+++ b/SOL004/magma/vnf_price_list.yaml
@@ -0,0 +1,994 @@
+- vnfd: hackfest_magma-agw-enb_vnfd
+  osm_hackfest_1:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-1
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-1-lowcost
+        price: 1
+  osm_hackfest_2:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-2
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-2-lowcost
+        price: 1
+  osm_hackfest_3:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-3
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-3-lowcost
+        price: 1
+  osm_hackfest_4:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-4
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-4-lowcost
+        price: 1
+  osm_hackfest_5:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-5
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-5-lowcost
+        price: 1
+  osm_hackfest_6:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-6
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-6-lowcost
+        price: 1
+  osm_hackfest_7:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-7
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-7-lowcost
+        price: 1
+  osm_hackfest_8:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-8
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-8-lowcost
+        price: 1
+  osm_hackfest_9:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-9
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-9-lowcost
+        price: 1
+  osm_hackfest_10:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-10
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-10-lowcost
+        price: 1
+  osm_hackfest_11:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-11
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-11-lowcost
+        price: 1
+  osm_hackfest_12:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-12
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-12-lowcost
+        price: 1
+  osm_hackfest_13:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-13
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-13-lowcost
+        price: 1
+  osm_hackfest_14:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-14
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-14-lowcost
+        price: 1
+  osm_hackfest_15:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-15
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-15-lowcost
+        price: 1
+  osm_hackfest_16:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-16
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-16-lowcost
+        price: 1
+  osm_hackfest_17:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-17
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-17-lowcost
+        price: 1
+  osm_hackfest_18:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-18
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-18-lowcost
+        price: 1
+  osm_hackfest_19:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-19
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-19-lowcost
+        price: 1
+  osm_hackfest_20:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-20
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-20-lowcost
+        price: 1
+  osm_hackfest_21:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-21
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-21-lowcost
+        price: 1
+  osm_hackfest_22:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-22
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-22-lowcost
+        price: 1
+  osm_hackfest_23:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-23
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-23-lowcost
+        price: 1
+  osm_hackfest_24:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-24
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-24-lowcost
+        price: 1
+  osm_hackfest_25:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-25
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-25-lowcost
+        price: 1
+  osm_hackfest_26:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-26
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-26-lowcost
+        price: 1
+  osm_hackfest_27:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-27
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-27-lowcost
+        price: 1
+  osm_hackfest_28:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-28
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-28-lowcost
+        price: 1
+  osm_hackfest_29:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-29
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-29-lowcost
+        price: 1
+  osm_hackfest_30:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-30
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-30-lowcost
+        price: 1
+  osm_hackfest_31:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-31
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-31-lowcost
+        price: 1
+  osm_hackfest_32:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-32
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-32-lowcost
+        price: 1
+  osm_hackfest_33:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-33
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-33-lowcost
+        price: 1
+  osm_hackfest_34:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-34
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-34-lowcost
+        price: 1
+  osm_hackfest_35:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-35
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-35-lowcost
+        price: 1
+  osm_hackfest_36:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-36
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-36-lowcost
+        price: 1
+  osm_hackfest_37:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-37
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-37-lowcost
+        price: 1
+  osm_hackfest_38:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-38
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-38-lowcost
+        price: 1
+  osm_hackfest_39:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-39
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-39-lowcost
+        price: 1
+  osm_hackfest_40:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-40
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-40-lowcost
+        price: 1
+  osm_hackfest_41:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-41
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-41-lowcost
+        price: 1
+  osm_hackfest_42:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-42
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-42-lowcost
+        price: 1
+  osm_hackfest_43:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-43
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-43-lowcost
+        price: 1
+  osm_hackfest_44:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-44
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-44-lowcost
+        price: 1
+  osm_hackfest_45:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-45
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-45-lowcost
+        price: 1
+  osm_hackfest_46:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-46
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-46-lowcost
+        price: 1
+  osm_hackfest_47:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-47
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-47-lowcost
+        price: 1
+  osm_hackfest_48:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-48
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-48-lowcost
+        price: 1
+  osm_hackfest_49:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-49
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-49-lowcost
+        price: 1
+  osm_hackfest_50:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-50
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-50-lowcost
+        price: 1
+  osm_hackfest_51:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-51
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-51-lowcost
+        price: 1
+  osm_hackfest_52:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-52
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-52-lowcost
+        price: 1
+  osm_hackfest_53:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-53
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-53-lowcost
+        price: 1
+  osm_hackfest_54:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-54
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-54-lowcost
+        price: 1
+  osm_hackfest_55:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-55
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-55-lowcost
+        price: 1
+  osm_hackfest_56:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-56
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-56-lowcost
+        price: 1
+  osm_hackfest_57:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-57
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-57-lowcost
+        price: 1
+  osm_hackfest_58:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-58
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-58-lowcost
+        price: 1
+  osm_hackfest_59:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-59
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-59-lowcost
+        price: 1
+  osm_hackfest_60:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-60
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-60-lowcost
+        price: 1
+  admin:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-lowcost
+        price: 1
+  hackfest:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-lowcost
+        price: 1
+- vnfd: hackfest_gateway_vnfd
+  osm_hackfest_1:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-1
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-1-lowcost
+        price: 1
+  osm_hackfest_2:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-2
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-2-lowcost
+        price: 1
+  osm_hackfest_3:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-3
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-3-lowcost
+        price: 1
+  osm_hackfest_4:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-4
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-4-lowcost
+        price: 1
+  osm_hackfest_5:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-5
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-5-lowcost
+        price: 1
+  osm_hackfest_6:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-6
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-6-lowcost
+        price: 1
+  osm_hackfest_7:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-7
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-7-lowcost
+        price: 1
+  osm_hackfest_8:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-8
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-8-lowcost
+        price: 1
+  osm_hackfest_9:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-9
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-9-lowcost
+        price: 1
+  osm_hackfest_10:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-10
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-10-lowcost
+        price: 1
+  osm_hackfest_11:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-11
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-11-lowcost
+        price: 1
+  osm_hackfest_12:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-12
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-12-lowcost
+        price: 1
+  osm_hackfest_13:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-13
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-13-lowcost
+        price: 1
+  osm_hackfest_14:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-14
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-14-lowcost
+        price: 1
+  osm_hackfest_15:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-15
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-15-lowcost
+        price: 1
+  osm_hackfest_16:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-16
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-16-lowcost
+        price: 1
+  osm_hackfest_17:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-17
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-17-lowcost
+        price: 1
+  osm_hackfest_18:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-18
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-18-lowcost
+        price: 1
+  osm_hackfest_19:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-19
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-19-lowcost
+        price: 1
+  osm_hackfest_20:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-20
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-20-lowcost
+        price: 1
+  osm_hackfest_21:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-21
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-21-lowcost
+        price: 1
+  osm_hackfest_22:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-22
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-22-lowcost
+        price: 1
+  osm_hackfest_23:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-23
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-23-lowcost
+        price: 1
+  osm_hackfest_24:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-24
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-24-lowcost
+        price: 1
+  osm_hackfest_25:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-25
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-25-lowcost
+        price: 1
+  osm_hackfest_26:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-26
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-26-lowcost
+        price: 1
+  osm_hackfest_27:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-27
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-27-lowcost
+        price: 1
+  osm_hackfest_28:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-28
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-28-lowcost
+        price: 1
+  osm_hackfest_29:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-29
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-29-lowcost
+        price: 1
+  osm_hackfest_30:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-30
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-30-lowcost
+        price: 1
+  osm_hackfest_31:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-31
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-31-lowcost
+        price: 1
+  osm_hackfest_32:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-32
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-32-lowcost
+        price: 1
+  osm_hackfest_33:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-33
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-33-lowcost
+        price: 1
+  osm_hackfest_34:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-34
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-34-lowcost
+        price: 1
+  osm_hackfest_35:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-35
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-35-lowcost
+        price: 1
+  osm_hackfest_36:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-36
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-36-lowcost
+        price: 1
+  osm_hackfest_37:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-37
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-37-lowcost
+        price: 1
+  osm_hackfest_38:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-38
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-38-lowcost
+        price: 1
+  osm_hackfest_39:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-39
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-39-lowcost
+        price: 1
+  osm_hackfest_40:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-40
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-40-lowcost
+        price: 1
+  osm_hackfest_41:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-41
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-41-lowcost
+        price: 1
+  osm_hackfest_42:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-42
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-42-lowcost
+        price: 1
+  osm_hackfest_43:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-43
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-43-lowcost
+        price: 1
+  osm_hackfest_44:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-44
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-44-lowcost
+        price: 1
+  osm_hackfest_45:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-45
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-45-lowcost
+        price: 1
+  osm_hackfest_46:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-46
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-46-lowcost
+        price: 1
+  osm_hackfest_47:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-47
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-47-lowcost
+        price: 1
+  osm_hackfest_48:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-48
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-48-lowcost
+        price: 1
+  osm_hackfest_49:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-49
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-49-lowcost
+        price: 1
+  osm_hackfest_50:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-50
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-50-lowcost
+        price: 1
+  osm_hackfest_51:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-51
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-51-lowcost
+        price: 1
+  osm_hackfest_52:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-52
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-52-lowcost
+        price: 1
+  osm_hackfest_53:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-53
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-53-lowcost
+        price: 1
+  osm_hackfest_54:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-54
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-54-lowcost
+        price: 1
+  osm_hackfest_55:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-55
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-55-lowcost
+        price: 1
+  osm_hackfest_56:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-56
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-56-lowcost
+        price: 1
+  osm_hackfest_57:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-57
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-57-lowcost
+        price: 1
+  osm_hackfest_58:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-58
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-58-lowcost
+        price: 1
+  osm_hackfest_59:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-59
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-59-lowcost
+        price: 1
+  osm_hackfest_60:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack-60
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-60-lowcost
+        price: 1
+  admin:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-lowcost
+        price: 1
+  hackfest:
+    - prices:
+      - vim_url: http://172.21.247.1:5000/v3
+        vim_name: etsi-openstack
+        price: 5
+      - vim_url: http://172.21.7.5:5000/v3
+        vim_name: etsi-openstack-lowcost
+        price: 1
diff --git a/SOL004/nscharm_ns/charms/layers/ns/README.md b/SOL004/nscharm_ns/charms/layers/ns/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..1bc51de483e4486c91b3084035a2a2dff38103f2
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/README.md
@@ -0,0 +1,117 @@
+# Overview
+
+This is an example of an Open Source Mano (OSM) Network Service (ns) charm. This is an **experimental** feature, expected to be released with OSM R6 in the spring of 2019.
+
+This allows a charm to coordinate the execution of [actions] across multiple charms within a model.
+
+# Usage
+
+# Application Names
+
+Each deployed application is named using a set of runtime variables, such as the network service name, the vnf or vdu name, and the vnf-member-index. Because of that, we'll need to provide those values to the NS charm through its configuration.
+
+# Configuration
+
+The `config.yaml` file contains a mapping of properties that will be passed from OSM to your deployed charm. Some of those properties are automatically included by the underlying `osm-ns` layer:
+- juju-username
+- juju-password
+
+You'll need to pass the name of the network service that you deployed. Even though your network service may be named `nscharm` in the descriptor, the operator provides a name at instantiation time, and `osm-ns` needs this name in order to resolve the application names. You can call it anything you like, as long as it's consistent between the NS charm and the NS Descriptor.
+
+For each VNF or VDU with a charm you wish to interact with, you need to also pass it's id from the VNF Descriptor. Again, you can call this anything you like, as long as it's consistent between the NS charm and NS Descriptor.
+
+`config.yaml`:
+```yaml
+options:
+    nsr-name:
+        default:
+        description: The runtime name of the Network Service, i.e., what its deployed name is.
+        type: string
+
+    user-member-index:
+        default:
+        description: The vnf-member-index of the user VNF.
+        type: string
+    user-vdu-id:
+        default:
+        description: The id of the VDU containing the charm.
+        type: string
+
+    policy-member-index:
+        default:
+        description: The vnf-member-index of the policy VNF.
+        type: string
+    policy-vdu-id:
+        default:
+        description: The id of the VDU containing the charm.
+        type: string
+```
+
+# NS Descriptor
+
+The NS descriptor contains a new `ns-configuration` element, similar to that of `vnf-configuration` and `vdu-configuration` available in VNF descriptors.
+
+The key here is to pass the juju credentials from your environment, available in `~/.local/share/juju/accounts.yaml`. This enables the charm to speak directly to Juju, via the `osm-ns` layer.
+
+Next, you must map the runtime parameters of your Network Service so that the charm is aware of your topology.
+
+Lastly, you can then define the primitives, under `config-primitive`, to be available to the operator for day-2 operation.
+
+```yaml
+        ns-configuration:
+            juju:
+                charm: ns
+            initial-config-primitive:
+            -   seq: '1'
+                name: config
+                parameter:
+                # Configure Juju credentials
+                -   name: juju-username
+                    value: 'admin'
+                -   name: juju-password
+                    value: '50b4491a7a42d3542e317e3ae94c6c96'
+
+                # Set the runtime name of the network service
+                -   name: nsr-name
+                    value: 'test'
+
+                # For each vnf, map the vnf-member-index and vdu-id
+                -   name: user-member-index
+                    value: '1'
+                -   name: user-vdu-id
+                    value: 'userVM'
+
+                -   name: policy-member-index
+                    value: '2'
+                -   name: policy-vdu-id
+                    value: 'policyVM'
+
+            -   seq: '2'
+                name: add-user
+                parameter:
+                -   name: username
+                    value: root
+            config-primitive:
+            -   name: add-user
+                parameter:
+                -   name: username
+                    data-type: STRING
+```
+
+## Known Limitations and Issues
+
+This functionality is EXPERIMENTAL.
+
+# Configuration
+
+# Contact Information
+
+
+## Open Source Mano (OSM)
+
+  - [OSM website](https://osm.etsi.org/)
+  - [OSM bug tracker](https://osm.etsi.org/bugzilla/)
+  - [OSM_TECH](mailto:OSM_TECH@list.etsi.org) mailing list
+  - [Slack](https://join.slack.com/t/opensourcemano/shared_invite/enQtMzQ3MzYzNTQ0NDIyLWJkMzRjNDM0MjFjODYzMGQ3ODIzMzJlNTg2ZGI5OTdiZjFiNDMyMzYxMjRjNDU4N2FmNjRjNzY5NTE1MjgzOTQ)
+
+[actions]: https://docs.jujucharms.com/2.5/en/actions
diff --git a/SOL004/nscharm_ns/charms/layers/ns/actions.yaml b/SOL004/nscharm_ns/charms/layers/ns/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..59063a412eec30dd9b03fff6dedfb1daa40a35c0
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/actions.yaml
@@ -0,0 +1,42 @@
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+add-user:
+    description: "Add a user"
+    params:
+        username:
+            description: "The username to add"
+            type: string
+            default: ""
+        bw:
+            description: ""
+            type: integer
+            default: 0
+        qos:
+            description: ""
+            type: integer
+            default: 0
+        tariff:
+            description: ""
+            type: integer
+            default: 0
+
+    required:
+        # We're only requiring username here, and will use the default values
+        # for the remaining parameters. This can be changed by adding the
+        # required parameter names below.
+        - username
diff --git a/SOL004/nscharm_ns/charms/layers/ns/actions/add-user b/SOL004/nscharm_ns/charms/layers/ns/actions/add-user
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/actions/add-user
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/nscharm_ns/charms/layers/ns/config.yaml b/SOL004/nscharm_ns/charms/layers/ns/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..446fb46768315e8f1f5922d86755a1bae91435aa
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/config.yaml
@@ -0,0 +1,18 @@
+options:
+    user-member-index:
+        default:
+        description: The vnf-member-index of the user VNF.
+        type: string
+    user-vdu-id:
+        default:
+        description: The id of the VDU containing the charm.
+        type: string
+
+    policy-member-index:
+        default:
+        description: The vnf-member-index of the policy VNF.
+        type: string
+    policy-vdu-id:
+        default:
+        description: The id of the VDU containing the charm.
+        type: string
diff --git a/SOL004/nscharm_ns/charms/layers/ns/icon.svg b/SOL004/nscharm_ns/charms/layers/ns/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..96a5d0c068d4b3271c7e397f76cf77fdf0651038
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/nscharm_ns/charms/layers/ns/layer.yaml b/SOL004/nscharm_ns/charms/layers/ns/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ca5c75eb483ff9efbd2a34556397cfd92605f895
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/layer.yaml
@@ -0,0 +1,6 @@
+includes:
+  - 'layer:basic'
+  - 'layer:osm-ns'
+options:
+  basic:
+    use_venv: false
diff --git a/SOL004/nscharm_ns/charms/layers/ns/metadata.yaml b/SOL004/nscharm_ns/charms/layers/ns/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3880a8e3f9637a4bb90654011b00868c20cfa824
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/metadata.yaml
@@ -0,0 +1,13 @@
+name: ns
+summary: <Fill in summary here>
+maintainer: Adam Israel <Adam.Israel@maidalchini>
+description: |
+  <Multi-line description here>
+tags:
+  # Replace "misc" with one or more whitelisted tags from this list:
+  # https://jujucharms.com/docs/stable/authors-charm-metadata
+  - misc
+series:
+  - xenial
+  - bionic
+subordinate: false
diff --git a/SOL004/nscharm_ns/charms/layers/ns/reactive/ns.py b/SOL004/nscharm_ns/charms/layers/ns/reactive/ns.py
new file mode 100644
index 0000000000000000000000000000000000000000..6b58334772b543d69cfa03279e6fc48ed73b3ae5
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/reactive/ns.py
@@ -0,0 +1,135 @@
+"""asdfself"""
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+    log,
+    config,
+)
+
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+import charms.osm.ns
+import json
+import traceback
+
+
+@when_not('ns.installed')
+def install_ns():
+    set_flag('ns.installed')
+    status_set('active', 'Ready!')
+
+
+@when('actions.add-user')
+def action_add_user():
+    """Add a user to the database."""
+    err = ''
+    output = ''
+    try:
+        username = action_get('username')
+        bw = action_get('bw')
+        qos = action_get('qos')
+        tariff = action_get('tariff')
+
+        # Get the configuration, which should contain the juju username and
+        # password. The endpoint and model will be discovered automatically
+        cfg = config()
+
+        client = charms.osm.ns.NetworkService(
+            user=cfg['juju-username'],
+            secret=cfg['juju-password'],
+        )
+
+        user_id = add_user(client, username, tariff)
+        if user_id > 0:
+            success = set_policy(client, user_id, bw, qos)
+        else:
+            log("user_id is 0; add_user failed.")
+
+        log("Output from charm: {}".format(output))
+
+    except Exception as err:
+        log(str(err))
+        log(str(traceback.format_exc()))
+        action_fail(str(err))
+    else:
+        action_set({
+            'user-id': user_id,
+            'policy-set': success,
+        })
+    finally:
+        clear_flag('actions.add-user')
+
+
+def add_user(client, username, tariff):
+    """Add a user to the database and return the id."""
+
+    cfg = config()
+
+    ns_config_info = json.loads(cfg['ns_config_info'])
+
+    application = ns_config_info['osm-config-mapping']['{}.{}.{}'.format(
+        '1', # member-vnf-index
+        'userVM', # vdu_id
+        '0', # vdu_count_index
+    )]
+
+    output = client.ExecutePrimitiveGetOutput(
+        # The name of the application for adding a user
+        application,
+
+        # The name of the action to call
+        "add-user",
+
+        # The parameter(s) required by the above charm and action
+        params={
+            'username': username,
+            'tariff': tariff,
+        },
+        # How long to wait (in seconds) for the action to finish
+        timeout=500
+    )
+
+    # Get the output from the `add-user` function
+    user_id = int(output['user-id'])
+    return user_id
+
+
+def set_policy(client, user_id, bw, qos):
+    """Set the policy for a user."""
+    success = False
+
+    cfg = config()
+    ns_config_info = json.loads(cfg['ns_config_info'])
+
+    application = ns_config_info['osm-config-mapping']['{}.{}.{}'.format(
+        '2', # member-vnf-index
+        'policyVM', # vdu_id
+        '0', # vdu_count_index
+    )]
+
+    success = client.ExecutePrimitiveGetOutput(
+        # The name of the application for policy management
+        application,
+
+        # The name of the action to call
+        "set-policy",
+
+        # The parameter(s) required by the above charm and action
+        params={
+            'user_id': user_id,
+            'bw': bw,
+            'qos': qos,
+        },
+
+        # How long to wait (in seconds) for the action to finish
+        timeout=500
+    )
+
+    # Get the output from the `add-user` function
+    return success
diff --git a/SOL004/nscharm_ns/charms/layers/ns/tests/00-setup b/SOL004/nscharm_ns/charms/layers/ns/tests/00-setup
new file mode 100755
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/nscharm_ns/charms/layers/ns/tests/10-deploy b/SOL004/nscharm_ns/charms/layers/ns/tests/10-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..52efc97fd622de5c6b6bf857f53145fbd87fcabf
--- /dev/null
+++ b/SOL004/nscharm_ns/charms/layers/ns/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('ns')
+        self.d.expose('ns')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['ns'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/nscharm_ns/nscharm_nsd.yaml b/SOL004/nscharm_ns/nscharm_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5aaaeecaf6b1d1e393cbaa783b0fe1bf4084fe1f
--- /dev/null
+++ b/SOL004/nscharm_ns/nscharm_nsd.yaml
@@ -0,0 +1,52 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: nscharm-user-vnf
+      - id: '2'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '2'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: nscharm-policy-vnf
+    id: nscharm-ns
+    name: nscharm-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+      vim-network-name: osm-ext
+    vnfd-id:
+    - nscharm-user-vnf
+    - nscharm-policy-vnf
+    ns-configuration:
+      juju:
+        charm: ns
+      initial-config-primitive:
+      - seq: '1'
+        name: config
+        parameter:
+        # Configure Juju credentials
+        - name: juju-username
+          value: 'admin'
+        - name: juju-password
+          value: 'a5611fc6452349cc6e45705d34c501d4'
+      - seq: '2'
+        name: add-user
+        parameter:
+        - name: username
+          value: root
+      config-primitive:
+      - name: add-user
+        parameter:
+        - name: username
+          data-type: STRING
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/README.md b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..bf5324ebf87ca73451897edc752449d8a3263a6f
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/README.md
@@ -0,0 +1,24 @@
+# Overview
+
+This is an example of an Open Source Mano (OSM) charm used with the Network Service (ns) example. 
+
+# Usage
+
+
+## Known Limitations and Issues
+
+Network Service charms are an **experimental** feature, expected to be released with OSM R6 in the spring of 2019.
+
+
+# Configuration
+
+None
+
+# Contact Information
+## Open Source Mano (OSM)
+
+  - [OSM website](https://osm.etsi.org/)
+  - [OSM bug tracker](https://osm.etsi.org/bugzilla/)
+  - [OSM_TECH](mailto:OSM_TECH@list.etsi.org) mailing list
+  - [Slack](https://join.slack.com/t/opensourcemano/shared_invite/enQtMzQ3MzYzNTQ0NDIyLWJkMzRjNDM0MjFjODYzMGQ3ODIzMzJlNTg2ZGI5OTdiZjFiNDMyMzYxMjRjNDU4N2FmNjRjNzY5NTE1MjgzOTQ)
+
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions.yaml b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..995a197ac33b2078a3d344442b777e23145d102f
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions.yaml
@@ -0,0 +1,19 @@
+set-policy:
+    description: "Set a user policy"
+    params:
+        user_id:
+            description: "The user_id to modify the policy of"
+            type: integer
+            default: 0
+        bw:
+            description: ""
+            type: integer
+            default: 0
+        qos:
+            description: ""
+            type: integer
+            default: 0
+    required:
+        - user_id
+        - bw
+        - qos
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions/set-policy b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions/set-policy
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/actions/set-policy
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/icon.svg b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..96a5d0c068d4b3271c7e397f76cf77fdf0651038
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/layer.yaml b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a0649a97718a7882882222ca5aa845298bdd73b0
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/layer.yaml
@@ -0,0 +1,8 @@
+includes:
+    - 'layer:basic'
+    - 'layer:vnfproxy'
+    - 'layer:sshproxy'
+options:
+    basic:
+        use_venv: false
+
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/metadata.yaml b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..1f79bfdf93f9bf02cdc0bd50943924c5330df41a
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/metadata.yaml
@@ -0,0 +1,13 @@
+name: vnf-policy
+summary: <Fill in summary here>
+maintainer: Adam Israel <Adam.Israel@maidalchini>
+description: |
+  <Multi-line description here>
+tags:
+  # Replace "misc" with one or more whitelisted tags from this list:
+  # https://jujucharms.com/docs/stable/authors-charm-metadata
+  - misc
+series:
+  - xenial
+  - bionic
+subordinate: false
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/reactive/vnf_policy.py b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/reactive/vnf_policy.py
new file mode 100644
index 0000000000000000000000000000000000000000..d589dfee4fdfc20420e7bee6f66846e6fa5384ab
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/reactive/vnf_policy.py
@@ -0,0 +1,46 @@
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+    log,
+)
+
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+
+
+@when('sshproxy.configured')
+@when_not('vnf-policy.installed')
+def install_vnf_b():
+    set_flag('vnf-policy.installed')
+    status_set('active', 'Ready!')
+
+
+@when('actions.set-policy')
+def action_set_policy():
+    """Set the policy for a given user.
+
+    Sets the policy (bw and qos) for the specified user_id
+    """
+    err = ''
+    updated = False
+    try:
+        user_id = action_get('user_id')
+        bw = action_get('bw')
+        qos = action_get('qos')
+
+        # If this were a functional vnf, you would perform your operation here
+        # and may return a value to indicate success or failure.
+        updated = True
+
+    except Exception as err:
+        action_fail(str(err))
+    else:
+        action_set({'updated': updated})
+    finally:
+        clear_flag('actions.set-policy')
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/00-setup b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/00-setup
new file mode 100755
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/10-deploy b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/10-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..065c79e39c12fcd23f6e48579d6265bf912686f5
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/charms/layers/vnf-policy/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('vnf-b')
+        self.d.expose('vnf-b')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['vnf-b'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/nscharm_policy_vnf/cloud_init/cloud-config.txt b/SOL004/nscharm_policy_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..f6c1b9dcf3a0506e7366e58d0318a5df5f2639ce
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,13 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
+
diff --git a/SOL004/nscharm_policy_vnf/nscharm_policy_vnfd.yaml b/SOL004/nscharm_policy_vnf/nscharm_policy_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ca1030e094f7f6d49cd7183e5acff52065c1f9cd
--- /dev/null
+++ b/SOL004/nscharm_policy_vnf/nscharm_policy_vnfd.yaml
@@ -0,0 +1,78 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs w/proxy charm
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: policyVM
+    vdu-profile:
+    - id: policyVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - id: policyVM
+          execution-environment-list:
+          - id: vnf-policy-ee
+            juju:
+              charm: vnf-policy
+              proxy: true
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: vnf-policy-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm4u
+            seq: '1'
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: policyVM-eth0-int
+      vdu-id: policyVM
+  id: nscharm-policy-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: nscharm-policy-vnf
+  sw-image-desc:
+  - id: ubuntu1604
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: policyVM
+    int-cpd:
+    - id: policyVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: policyVM-eth0
+        position: 1
+        virtual-interface:
+          type: VIRTIO
+    - id: policyVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: policyVM-eth1
+        position: 2
+        virtual-interface:
+          type: VIRTIO
+    name: policyVM
+    sw-image-desc: ubuntu1604
+    virtual-compute-desc: policyVM-compute
+    virtual-storage-desc:
+    - policyVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: policyVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: policyVM-storage
+    size-of-storage: 10
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/README.md b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..30175122ed7fc2dca2cef911451cc4f99d922562
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/README.md
@@ -0,0 +1,26 @@
+# Overview
+
+This is an example of an Open Source Mano (OSM) charm used with the Network Service (ns) example. 
+
+Network Service charms are an **experimental** feature, expected to be released with OSM R6 in the spring of 2019.
+
+# Usage
+
+
+## Known Limitations and Issues
+
+This not only helps users but gives people a place to start if they want to help
+you add features to your charm.
+
+# Configuration
+
+None
+
+# Contact Information
+## Open Source Mano (OSM)
+
+  - [OSM website](https://osm.etsi.org/)
+  - [OSM bug tracker](https://osm.etsi.org/bugzilla/)
+  - [OSM_TECH](mailto:OSM_TECH@list.etsi.org) mailing list
+  - [Slack](https://join.slack.com/t/opensourcemano/shared_invite/enQtMzQ3MzYzNTQ0NDIyLWJkMzRjNDM0MjFjODYzMGQ3ODIzMzJlNTg2ZGI5OTdiZjFiNDMyMzYxMjRjNDU4N2FmNjRjNzY5NTE1MjgzOTQ)
+
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions.yaml b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..1bd4c757facd6179cbd818ce2503ed7939d772e4
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions.yaml
@@ -0,0 +1,13 @@
+add-user:
+    description: "Add a new username to the database"
+    params:
+        username:
+            description: "The username to add"
+            type: string
+            default: ""
+        tariff:
+            description: ""
+            type: integer
+            default: 0
+    required:
+        - username
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions/add-user b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions/add-user
new file mode 100755
index 0000000000000000000000000000000000000000..7e30af4cfa084120a9343bf71c421b69ec3f2967
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/actions/add-user
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main, set_flag
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_flag('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/icon.svg b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..96a5d0c068d4b3271c7e397f76cf77fdf0651038
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/layer.yaml b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ba9c189068dd2cb000b68780692067d6467697ee
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/layer.yaml
@@ -0,0 +1,8 @@
+includes:
+    - 'layer:basic'
+    - 'layer:vnfproxy'
+    - 'layer:sshproxy'
+options:
+  basic:
+    use_venv: false
+    
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/metadata.yaml b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7afdca211279614cbcdcf63d5e6830b039841266
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/metadata.yaml
@@ -0,0 +1,11 @@
+name: vnf-user
+summary: <Fill in summary here>
+maintainer: Adam Israel <Adam.Israel@maidalchini>
+description: |
+  <Multi-line description here>
+tags:
+  - misc
+series:
+  - xenial
+  - bionic
+subordinate: false
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/reactive/vnf_user.py b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/reactive/vnf_user.py
new file mode 100644
index 0000000000000000000000000000000000000000..10e01741cefecd03985909ad13b5e0cd22aa47f3
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/reactive/vnf_user.py
@@ -0,0 +1,51 @@
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+    log,
+)
+
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+import random
+
+
+@when('sshproxy.configured')
+@when_not('vnf-user.installed')
+def install_vnf_user():
+    set_flag('vnf-a.installed')
+    status_set('active', 'Ready!')
+
+
+@when('actions.add-user')
+def action_add_user():
+    """Run the touch command.
+
+    Runs touch on vnf-a and vnf-b and returns the success or failure for each.
+    """
+    err = ''
+    user_id = 0
+    try:
+        username = action_get('username')
+        tariff = action_get('tariff')
+
+        # If this were a functional VNF, it would add the username to its
+        # database. For the purposes of demonstrating actions, this will return
+        # a random number.
+        user_id = random.randint(1, 100)
+
+    except Exception as err:
+        # This marks the action as having failed, so the ns charm knows not to
+        # continue with the add_user operation.
+        action_fail(str(err))
+    else:
+        # This will put the user_id in the action output, which will be read
+        # by the ns charm. Multiple values could be returned here.
+        action_set({'user-id': user_id})
+    finally:
+        clear_flag('actions.add-user')
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/00-setup b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/00-setup
new file mode 100755
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/10-deploy b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/10-deploy
new file mode 100755
index 0000000000000000000000000000000000000000..5012ce68890027e16e72572bbda164fa69fd1023
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/charms/layers/vnf-user/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('vnf-a')
+        self.d.expose('vnf-a')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['vnf-a'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/nscharm_user_vnf/cloud_init/cloud-config.txt b/SOL004/nscharm_user_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..f6c1b9dcf3a0506e7366e58d0318a5df5f2639ce
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,13 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
+
diff --git a/SOL004/nscharm_user_vnf/nscharm_user_vnfd.yaml b/SOL004/nscharm_user_vnf/nscharm_user_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7859261fc12c920132301b8ec61fefc37b0fb52d
--- /dev/null
+++ b/SOL004/nscharm_user_vnf/nscharm_user_vnfd.yaml
@@ -0,0 +1,78 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs w/proxy charm
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: userVM
+    vdu-profile:
+    - id: userVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - id: userVM
+          execution-environment-list:
+          - id: vnf-user-ee
+            juju:
+              charm: vnf-user
+              proxy: true
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: vnf-user-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm4u
+            seq: '1'
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: userVM-eth0-int
+      vdu-id: userVM
+  id: nscharm-user-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: nscharm-user-vnf
+  sw-image-desc:
+  - id: ubuntu1604
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: userVM
+    int-cpd:
+    - id: userVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: userVM-eth0
+        position: 1
+        virtual-interface:
+          type: VIRTIO
+    - id: userVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: userVM-eth1
+        position: 2
+        virtual-interface:
+          type: VIRTIO
+    name: userVM
+    sw-image-desc: ubuntu1604
+    virtual-compute-desc: userVM-compute
+    virtual-storage-desc:
+    - userVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: userVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: userVM-storage
+    size-of-storage: 10
diff --git a/SOL004/openldap_knf/openldap_vnfd.yaml b/SOL004/openldap_knf/openldap_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..152efa66499c94955afd1e6dc69f3864e25e9a2c
--- /dev/null
+++ b/SOL004/openldap_knf/openldap_vnfd.yaml
@@ -0,0 +1,18 @@
+vnfd:
+  description: KNF with single KDU using a helm-chart for openldap version 1.2.3
+  df:
+  - id: default-df
+  ext-cpd:
+  - id: mgmt-ext
+    k8s-cluster-net: mgmtnet
+  id: openldap_knf
+  k8s-cluster:
+    nets:
+    - id: mgmtnet
+  kdu:
+  - name: ldap
+    helm-chart: stable/openldap
+  mgmt-cp: mgmt-ext
+  product-name: openldap_knf
+  provider: Telefonica
+  version: '1.0'
diff --git a/SOL004/openldap_ns/README.md b/SOL004/openldap_ns/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..93fb79c6bfbb5bb6723650a7b2a6c3a0fb19844c
--- /dev/null
+++ b/SOL004/openldap_ns/README.md
@@ -0,0 +1,46 @@
+# SIMPLE OPEN-LDAP CHART
+
+Descriptors that installs an openldap version 1.2.1 chart in a K8s cluster
+
+There is one VNF (openldap\_vnf) with only one KDU.
+
+There is one NS that connects the VNF to a mgmt network
+
+## Onboarding and instantiation
+
+```bash
+osm nfpkg-create openldap_knf.tar.gz
+osm nspkg-create openldap_ns.tar.gz
+osm ns-create --ns_name ldap --nsd_name openldap_ns --vim_account <VIM_ACCOUNT_NAME>|<VIM_ACCOUNT_ID> --ssh_keys ${HOME}/.ssh/id_rsa.pub
+```
+
+### Instantiation option
+
+Some parameters could be passed during the instantiation.
+
+* replicaCount: Number of Open LDAP replicas that will be created
+
+```bash
+osm ns-create --ns_name ldap --nsd_name openldap_ns --vim_account <VIM_ACCOUNT_NAME>|<VIM_ACCOUNT_ID> --config '{additionalParamsForVnf: [{"member-vnf-index": "openldap", "additionalParams": {"replicaCount": "2"}}]}'
+osm ns-create --ns_name ldap --nsd_name openldap_ns --vim_account <VIM_ACCOUNT_NAME>|<VIM_ACCOUNT_ID> --config_file params.yaml
+```
+
+## Test deployment
+
+```bash
+helm -n <PROJECT_ID> list
+kubectl -n <PROJECT_ID> get all
+kubectl -n <PROJECT_ID> get service
+```
+
+## Testing LDAP server
+
+```bash
+sudo apt-get update
+sudo apt-get install ldap-utils
+# With LB:
+ldapsearch -x -H ldap://<LB_IP>:389 -b dc=example,dc=org -D "cn=admin,dc=example,dc=org" -w osm4u
+# With NodePort
+ldapsearch -x -H ldap://<NODE_IP>:<NODE_PORT> -b dc=example,dc=org -D "cn=admin,dc=example,dc=org" -w osm4u
+```
+
diff --git a/SOL004/openldap_ns/openldap_nsd.yaml b/SOL004/openldap_ns/openldap_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..b995164c2e9783383d8f2f571a19aa281f060c1e
--- /dev/null
+++ b/SOL004/openldap_ns/openldap_nsd.yaml
@@ -0,0 +1,22 @@
+nsd:
+  nsd:
+  - description: NS consisting of a single KNF openldap_knf connected to mgmt network
+    designer: OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: openldap
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: openldap
+            constituent-cpd-id: mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: openldap_knf
+    id: openldap_ns
+    name: openldap_ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: 'true'
+    vnfd-id:
+    - openldap_knf
diff --git a/SOL004/openldap_ns/params/params.yaml b/SOL004/openldap_ns/params/params.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8844ecb1777d8f4d4e7bb0a347fadca0e1cb04df
--- /dev/null
+++ b/SOL004/openldap_ns/params/params.yaml
@@ -0,0 +1,24 @@
+vld:
+- name: mgmtnet
+  vim-network-name: internal
+additionalParamsForVnf:
+- member-vnf-index: openldap
+  additionalParamsForKdu:
+  - kdu_name: ldap
+    additionalParams:
+      # replicaCount: 2  
+      # service.loadBalancerIP: '172.21.251.X' # MetalLB IP Address
+      # service.type: NodePort
+      service:
+        type: NodePort
+        # loadBalancerIP: '172.21.251.X' # MetalLB IP Address
+      adminPassword: osm4u
+      configPassword: osm4u
+      env:
+        LDAP_ORGANISATION: "Example Inc."
+        LDAP_DOMAIN: "example.org"
+        LDAP_BACKEND: "hdb"
+        LDAP_TLS: "true"
+        LDAP_TLS_ENFORCE: "false"
+        LDAP_REMOVE_CONFIG_AFTER_SETUP: "true"
+
diff --git a/SOL004/simple_ee_ns/icons/osm.png b/SOL004/simple_ee_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/simple_ee_ns/icons/osm.png differ
diff --git a/SOL004/simple_ee_ns/simple_ee_nsd.yaml b/SOL004/simple_ee_ns/simple_ee_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..1321f126a1af35b77c81e01cec19d911cb397914
--- /dev/null
+++ b/SOL004/simple_ee_ns/simple_ee_nsd.yaml
@@ -0,0 +1,21 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs with cloudinit connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: simple
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: simple
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: simple_ee-vnf
+    id: simple_ee-ns
+    name: simple_ee-ns
+    version: 1.0
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - simple_ee-vnf
diff --git a/SOL004/simple_ee_vnf/cloud_init/cloud-config.txt b/SOL004/simple_ee_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..a9acf62700fbcaed336d7a5213143e22da63a8c7
--- /dev/null
+++ b/SOL004/simple_ee_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,4 @@
+#cloud-config
+password: osm2020
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/.helmignore b/SOL004/simple_ee_vnf/helm-charts/eechart/.helmignore
new file mode 100755
index 0000000000000000000000000000000000000000..50af0317254197a5a019f4ac2f8ecc223f93f5a7
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/.helmignore
@@ -0,0 +1,22 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/Chart.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/Chart.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..414c5f1aa1becbd34d69342874b63db8bb1cb77c
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/Chart.yaml
@@ -0,0 +1,5 @@
+apiVersion: v1
+appVersion: "1.0"
+description: OSM EE helm chart
+name: eechart
+version: 0.1.0
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/source/install.sh b/SOL004/simple_ee_vnf/helm-charts/eechart/source/install.sh
new file mode 100755
index 0000000000000000000000000000000000000000..248ec4819f981c16cf71f1605646eef294a92697
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/source/install.sh
@@ -0,0 +1,29 @@
+#!/bin/bash
+##
+# Copyright 2015 Telefonica Investigacion y Desarrollo, S.A.U.
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+# This script is intended for launching RO from a docker container.
+# It waits for mysql server ready, normally running on a separate container, ...
+# then it checks if database is present and creates it if needed.
+# Finally it launches RO server.
+
+echo "Sample install.sh from source dir"
+
+# Install libraries
+#apt-get install -y ...
+
+# Install library to execute command remotely by ssh
+python3 -m pip install asyncssh
+
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/source/vnf_ee.py b/SOL004/simple_ee_vnf/helm-charts/eechart/source/vnf_ee.py
new file mode 100755
index 0000000000000000000000000000000000000000..3f4a15bb0496871c95576a351019c7bf99f950cc
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/source/vnf_ee.py
@@ -0,0 +1,92 @@
+##
+# Copyright 2019 Telefonica Investigacion y Desarrollo, S.A.U.
+# This file is part of OSM
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# For those usages not covered by the Apache License, Version 2.0 please
+# contact with: nfvlabs@tid.es
+##
+
+import asyncio
+import logging
+import asyncssh
+
+
+from osm_ee.exceptions import VnfException
+
+
+class VnfEE:
+
+    def __init__(self, config_params):
+        self.logger = logging.getLogger('osm_ee.vnf')
+        self.config_params = config_params
+
+    async def config(self, id, params):
+        self.logger.debug("Execute action config params: {}".format(params))
+        # Config action is special, params are merged with previous config calls
+        self.config_params.update(params)
+        required_params = ["ssh-hostname"]
+        self._check_required_params(self.config_params, required_params)
+        yield "OK", "Configured"
+
+    async def touch(self, id, params):
+        self.logger.debug("Execute action touch params: '{}', type: {}".format(params, type(params)))
+
+        try:
+            self._check_required_params(params, ["file-path"])
+
+            # Check if filename is a single file or a list
+            file_list = params["file-path"] if isinstance(params["file-path"], list) else [params["file-path"]]
+            file_list_length = len(file_list)
+
+            async with asyncssh.connect(self.config_params["ssh-hostname"],
+                                        password=self.config_params.get("ssh-password"),
+                                        username=self.config_params.get("ssh-username"),
+                                        known_hosts=None) as conn:
+                for index, file_name in enumerate(file_list):
+                    command = "touch {}".format(file_name)
+                    self.logger.debug("Execute remote  command: '{}'".format(command))
+                    result = await conn.run(command)
+                    self.logger.debug("Create command result: {}".format(result))
+
+                    if result.exit_status != 0:
+                        detailed_status = result.stderr
+                        # TODO - ok but with some errors
+                    else:
+                        detailed_status = "Created file {}".format(file_name)
+
+                    if index + 1 != file_list_length:
+                        yield "PROCESSING", detailed_status
+                    else:
+                        yield "OK", detailed_status
+        except Exception as e:
+            self.logger.error("Error creating remote file: {}".format(repr(e)))
+            yield "ERROR", str(e)
+
+    async def sleep(self, id, params):
+        self.logger.debug("Execute action sleep, params: {}".format(params))
+
+        for i in range(3):
+            await asyncio.sleep(5)
+            self.logger.debug("Temporal result return, params: {}".format(params))
+            yield "PROCESSING", f"Processing {i} action id {id}"
+        yield "OK", f"Processed action id {id}"
+
+    @staticmethod
+    def _check_required_params(params, required_params):
+        for required_param in required_params:
+            if required_param not in params:
+                raise VnfException("Missing required param: {}".format(required_param))
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/NOTES.txt b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/NOTES.txt
new file mode 100755
index 0000000000000000000000000000000000000000..c52fc2c419ef6f4cccfb63fd93ca7379bfc04cf7
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/NOTES.txt
@@ -0,0 +1,21 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ . }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "eechart.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "eechart.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "eechart.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "eechart.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl port-forward $POD_NAME 8080:80
+{{- end }}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/_helpers.tpl b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
new file mode 100755
index 0000000000000000000000000000000000000000..d3e28e0260b8bff2fdef09046df0abaea885739c
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
@@ -0,0 +1,56 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "eechart.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "eechart.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "eechart.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Common labels
+*/}}
+{{- define "eechart.labels" -}}
+app.kubernetes.io/name: {{ include "eechart.name" . }}
+helm.sh/chart: {{ include "eechart.chart" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end -}}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "eechart.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create -}}
+    {{ default (include "eechart.fullname" .) .Values.serviceAccount.name }}
+{{- else -}}
+    {{ default "default" .Values.serviceAccount.name }}
+{{- end -}}
+{{- end -}}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/configmap.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/configmap.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..5b9634c7e1abe64c6f720f708dd5c9664e72e8cf
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/configmap.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "eechart.fullname" . }}
+data:
+{{ (.Files.Glob "source/*").AsConfig | indent 2 }}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/ingress.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/ingress.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..264f89091bee2ba8746edc2841c275d28fef1168
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/ingress.yaml
@@ -0,0 +1,41 @@
+{{- if .Values.ingress.enabled -}}
+{{- $fullName := include "eechart.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+{{- if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1beta1
+{{- else -}}
+apiVersion: extensions/v1beta1
+{{- end }}
+kind: Ingress
+metadata:
+  name: {{ $fullName }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+{{- if .Values.ingress.tls }}
+  tls:
+  {{- range .Values.ingress.tls }}
+    - hosts:
+      {{- range .hosts }}
+        - {{ . | quote }}
+      {{- end }}
+      secretName: {{ .secretName }}
+  {{- end }}
+{{- end }}
+  rules:
+  {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+        {{- range .paths }}
+          - path: {{ . }}
+            backend:
+              serviceName: {{ $fullName }}
+              servicePort: {{ $svcPort }}
+        {{- end }}
+  {{- end }}
+{{- end }}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/service.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/service.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..88d38d66a3997c6e2a96754582736cfb065da6c2
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/service.yaml
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: grpc
+      protocol: TCP
+      name: grpc
+  selector:
+    app.kubernetes.io/name: {{ include "eechart.name" . }}
+    app.kubernetes.io/instance: {{ .Release.Name }}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..be615a5f08c7b557446fa74e5e3619e47d2ee804
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
@@ -0,0 +1,8 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ template "eechart.serviceAccountName" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+{{- end -}}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/statefulset.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..3d721fe2d53ef73ba7b00af3d9567542c3799028
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
@@ -0,0 +1,65 @@
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  serviceName:  {{ include "eechart.fullname" . }} 
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ include "eechart.name" . }}
+      app.kubernetes.io/instance: {{ .Release.Name }}
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ include "eechart.name" . }}
+        app.kubernetes.io/instance: {{ .Release.Name }}
+    spec:
+      imagePullSecrets:
+      - name: regcred 
+      serviceAccountName: {{ template "eechart.serviceAccountName" . }}
+      securityContext:
+        {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      containers:
+        - name: {{ .Chart.Name }}
+          securityContext:
+            {{- toYaml .Values.securityContext | nindent 12 }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: grpc
+              containerPort: 50051
+              protocol: TCP          
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}          
+          volumeMounts:
+          - name: osm-ee
+            mountPath: /app/storage  
+          - name: osm-ee-source
+            mountPath: /app/EE/osm_ee/vnf      
+      volumes:      
+      - name: osm-ee-source
+        configMap: 
+          name:  {{ include "eechart.fullname" . }}
+  volumeClaimTemplates:
+    - metadata:
+        name: osm-ee
+      spec:
+        accessModes: [ "ReadWriteOnce" ]
+        resources:
+          requests:
+            storage: 1Gi
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+    {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+    {{- end }}
+    {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+    {{- end }}
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..e52b7b8b2515729e582b5efbc22dc5a0bdb0f3b2
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "eechart.fullname" . }}-test-connection"
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  annotations:
+    "helm.sh/hook": test-success
+spec:
+  containers:
+    - name: wget
+      image: busybox
+      command: ['wget']
+      args:  ['{{ include "eechart.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
diff --git a/SOL004/simple_ee_vnf/helm-charts/eechart/values.yaml b/SOL004/simple_ee_vnf/helm-charts/eechart/values.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..84cb21b701265e7f293d7b771d389907dba8c988
--- /dev/null
+++ b/SOL004/simple_ee_vnf/helm-charts/eechart/values.yaml
@@ -0,0 +1,68 @@
+# Default values for eechart.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: illoret/grpcee
+  tag: latest
+  pullPolicy: IfNotPresent
+
+imagePullSecrets: []
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  # Specifies whether a service account should be created
+  create: false
+  # The name of the service account to use.
+  # If not set and create is true, a name is generated using the fullname template
+  name:
+
+podSecurityContext: {}
+  # fsGroup: 2000
+
+securityContext: {}
+  # capabilities:
+  #   drop:
+  #   - ALL
+  # readOnlyRootFilesystem: true
+  # runAsNonRoot: true
+  # runAsUser: 1000
+
+service:
+  type: ClusterIP
+  port: 50050
+
+ingress:
+  enabled: false
+  annotations: {}
+    # kubernetes.io/ingress.class: nginx
+    # kubernetes.io/tls-acme: "true"
+  hosts:
+    - host: chart-example.local
+      paths: []
+
+  tls: []
+  #  - secretName: chart-example-tls
+  #    hosts:
+  #      - chart-example.local
+
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 100m
+  #   memory: 128Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
diff --git a/SOL004/simple_ee_vnf/icons/osm.png b/SOL004/simple_ee_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/simple_ee_vnf/icons/osm.png differ
diff --git a/SOL004/simple_ee_vnf/simple_ee_vnfd.yaml b/SOL004/simple_ee_vnf/simple_ee_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..c6ea1482aba70e05df14cc888b5fe0b6c5475e6d
--- /dev/null
+++ b/SOL004/simple_ee_vnf/simple_ee_vnfd.yaml
@@ -0,0 +1,99 @@
+vnfd:
+  description: A VNF consisting of 1 VDU with cloud-init, and a monitoring ee
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - execution-environment-primitive: touch
+            execution-environment-ref: monitor
+            name: touch
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: file-path
+          - execution-environment-primitive: sleep
+            execution-environment-ref: monitor
+            name: sleep
+          execution-environment-list:
+          - external-connection-point-ref: vnf-mgmt-ext
+            helm-chart: eechart
+            id: monitor
+          id: simple_ee-vnf
+          initial-config-primitive:
+          - execution-environment-ref: monitor
+            name: config
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            - name: ssh-password
+              value: osm2020
+            seq: '1'
+          - execution-environment-ref: monitor
+            name: touch
+            parameter:
+            - name: file-path
+              value: /home/ubuntu/first-touch
+            seq: '2'
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  id: simple_ee-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: simple_ee-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+      pinning:
+        policy: static
+        thread-policy: PREFER
+    virtual-memory:
+      mempage-size: LARGE
+      numa-enabled: true
+      numa-node-policy:
+        mem-policy: STRICT
+        node:
+        - id: '1'
+        node-cnt: '1'
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 20
diff --git a/SOL004/simple_nopasswd_ns/README b/SOL004/simple_nopasswd_ns/README
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/simple_nopasswd_ns/icons/osm.png b/SOL004/simple_nopasswd_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/simple_nopasswd_ns/icons/osm.png differ
diff --git a/SOL004/simple_nopasswd_ns/simple_nopasswd_nsd.yaml b/SOL004/simple_nopasswd_ns/simple_nopasswd_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..3190ed042f17a69e03efe7b25badc9fc00017d04
--- /dev/null
+++ b/SOL004/simple_nopasswd_ns/simple_nopasswd_nsd.yaml
@@ -0,0 +1,27 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs simple_nopasswd-vnf connected by datanet and mgmtnet
+      VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: simple_nopasswd-vnf
+    id: simple_nopasswd-ns
+    name: simple_nopasswd-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - simple_nopasswd-vnf
diff --git a/SOL004/simple_nopasswd_vnf/README b/SOL004/simple_nopasswd_vnf/README
new file mode 100644
index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/README.ex b/SOL004/simple_nopasswd_vnf/charms/layers/simple/README.ex
new file mode 100644
index 0000000000000000000000000000000000000000..b6816b22ade2fa36326d7e1f612b6f6203768949
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/README.ex
@@ -0,0 +1,65 @@
+# Overview
+
+Describe the intended usage of this charm and anything unique about how this
+charm relates to others here.
+
+This README will be displayed in the Charm Store, it should be either Markdown
+or RST. Ideal READMEs include instructions on how to use the charm, expected
+usage, and charm features that your audience might be interested in. For an
+example of a well written README check out Hadoop:
+http://jujucharms.com/charms/precise/hadoop
+
+Use this as a Markdown reference if you need help with the formatting of this
+README: http://askubuntu.com/editing-help
+
+This charm provides [service][]. Add a description here of what the service
+itself actually does.
+
+Also remember to check the [icon guidelines][] so that your charm looks good
+in the Juju GUI.
+
+# Usage
+
+Step by step instructions on using the charm:
+
+juju deploy servicename
+
+and so on. If you're providing a web service or something that the end user
+needs to go to, tell them here, especially if you're deploying a service that
+might listen to a non-default port.
+
+You can then browse to http://ip-address to configure the service.
+
+## Scale out Usage
+
+If the charm has any recommendations for running at scale, outline them in
+examples here. For example if you have a memcached relation that improves
+performance, mention it here.
+
+## Known Limitations and Issues
+
+This not only helps users but gives people a place to start if they want to help
+you add features to your charm.
+
+# Configuration
+
+The configuration options will be listed on the charm store, however If you're
+making assumptions or opinionated decisions in the charm (like setting a default
+administrator password), you should detail that here so the user knows how to
+change it immediately, etc.
+
+# Contact Information
+
+Though this will be listed in the charm store itself don't assume a user will
+know that, so include that information here:
+
+## Upstream Project Name
+
+  - Upstream website
+  - Upstream bug tracker
+  - Upstream mailing list or contact information
+  - Feel free to add things if it's useful for users
+
+
+[service]: http://example.com
+[icon guidelines]: https://jujucharms.com/docs/stable/authors-charm-icon
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions.yaml b/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f40782a27dddc1038166a686ad85a041565b4f54
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions.yaml
@@ -0,0 +1,26 @@
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+"touch":
+  "description": "Touch a file on the VNF."
+  "params":
+    "filename":
+      "description": "The name of the file to touch."
+      "type": "string"
+      "default": ""
+  "required":
+  - "filename"
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions/touch b/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions/touch
new file mode 100755
index 0000000000000000000000000000000000000000..d85d3facc597b486ac5b5cfa26ee9d74089c90cb
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/actions/touch
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+##
+# Copyright 2016 Canonical Ltd.
+# All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+import sys
+sys.path.append('lib')
+
+from charms.reactive import main
+from charms.reactive import set_state
+from charmhelpers.core.hookenv import action_fail, action_name
+
+"""
+`set_state` only works here because it's flushed to disk inside the `main()`
+loop. remove_state will need to be called inside the action method.
+"""
+set_state('actions.{}'.format(action_name()))
+
+try:
+    main()
+except Exception as e:
+    action_fail(repr(e))
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/config.yaml b/SOL004/simple_nopasswd_vnf/charms/layers/simple/config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..51f2ce4a07bddfbc72679ec14280fd6461cb307d
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/config.yaml
@@ -0,0 +1,14 @@
+options:
+  string-option:
+    type: string
+    default: "Default Value"
+    description: "A short description of the configuration option"
+  boolean-option:
+    type: boolean
+    default: False
+    description: "A short description of the configuration option"
+  int-option:
+    type: int
+    default: 9001
+    description: "A short description of the configuration option"
+
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/icon.svg b/SOL004/simple_nopasswd_vnf/charms/layers/simple/icon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..96a5d0c068d4b3271c7e397f76cf77fdf0651038
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/icon.svg
@@ -0,0 +1,279 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="96"
+   height="96"
+   id="svg6517"
+   version="1.1"
+   inkscape:version="0.48+devel r12274"
+   sodipodi:docname="Juju_charm_icon_template.svg">
+  <defs
+     id="defs6519">
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#Background"
+       id="linearGradient6461"
+       gradientUnits="userSpaceOnUse"
+       x1="0"
+       y1="970.29498"
+       x2="144"
+       y2="970.29498"
+       gradientTransform="matrix(0,-0.66666669,0.6660448,0,-866.25992,731.29077)" />
+    <linearGradient
+       id="Background">
+      <stop
+         id="stop4178"
+         offset="0"
+         style="stop-color:#b8b8b8;stop-opacity:1" />
+      <stop
+         id="stop4180"
+         offset="1"
+         style="stop-color:#c9c9c9;stop-opacity:1" />
+    </linearGradient>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Inner Shadow"
+       id="filter1121">
+      <feFlood
+         flood-opacity="0.59999999999999998"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood1123" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="out"
+         result="composite1"
+         id="feComposite1125" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur1127" />
+      <feOffset
+         dx="0"
+         dy="2"
+         result="offset"
+         id="feOffset1129" />
+      <feComposite
+         in="offset"
+         in2="SourceGraphic"
+         operator="atop"
+         result="composite2"
+         id="feComposite1131" />
+    </filter>
+    <filter
+       style="color-interpolation-filters:sRGB;"
+       inkscape:label="Drop Shadow"
+       id="filter950">
+      <feFlood
+         flood-opacity="0.25"
+         flood-color="rgb(0,0,0)"
+         result="flood"
+         id="feFlood952" />
+      <feComposite
+         in="flood"
+         in2="SourceGraphic"
+         operator="in"
+         result="composite1"
+         id="feComposite954" />
+      <feGaussianBlur
+         in="composite1"
+         stdDeviation="1"
+         result="blur"
+         id="feGaussianBlur956" />
+      <feOffset
+         dx="0"
+         dy="1"
+         result="offset"
+         id="feOffset958" />
+      <feComposite
+         in="SourceGraphic"
+         in2="offset"
+         operator="over"
+         result="composite2"
+         id="feComposite960" />
+    </filter>
+    <clipPath
+       clipPathUnits="userSpaceOnUse"
+       id="clipPath873">
+      <g
+         transform="matrix(0,-0.66666667,0.66604479,0,-258.25992,677.00001)"
+         id="g875"
+         inkscape:label="Layer 1"
+         style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline">
+        <path
+           style="fill:#ff00ff;fill-opacity:1;stroke:none;display:inline"
+           d="m 46.702703,898.22775 50.594594,0 C 138.16216,898.22775 144,904.06497 144,944.92583 l 0,50.73846 c 0,40.86071 -5.83784,46.69791 -46.702703,46.69791 l -50.594594,0 C 5.8378378,1042.3622 0,1036.525 0,995.66429 L 0,944.92583 C 0,904.06497 5.8378378,898.22775 46.702703,898.22775 Z"
+           id="path877"
+           inkscape:connector-curvature="0"
+           sodipodi:nodetypes="sssssssss" />
+      </g>
+    </clipPath>
+    <filter
+       inkscape:collect="always"
+       id="filter891"
+       inkscape:label="Badge Shadow">
+      <feGaussianBlur
+         inkscape:collect="always"
+         stdDeviation="0.71999962"
+         id="feGaussianBlur893" />
+    </filter>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="4.0745362"
+     inkscape:cx="18.514671"
+     inkscape:cy="49.018169"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="true"
+     fit-margin-top="0"
+     fit-margin-left="0"
+     fit-margin-right="0"
+     fit-margin-bottom="0"
+     inkscape:window-width="1920"
+     inkscape:window-height="1029"
+     inkscape:window-x="0"
+     inkscape:window-y="24"
+     inkscape:window-maximized="1"
+     showborder="true"
+     showguides="true"
+     inkscape:guide-bbox="true"
+     inkscape:showpageshadow="false">
+    <inkscape:grid
+       type="xygrid"
+       id="grid821" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="16,48"
+       id="guide823" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,80"
+       id="guide825" />
+    <sodipodi:guide
+       orientation="1,0"
+       position="80,40"
+       id="guide827" />
+    <sodipodi:guide
+       orientation="0,1"
+       position="64,16"
+       id="guide829" />
+  </sodipodi:namedview>
+  <metadata
+     id="metadata6522">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="BACKGROUND"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(268,-635.29076)"
+     style="display:inline">
+    <path
+       style="fill:url(#linearGradient6461);fill-opacity:1;stroke:none;display:inline;filter:url(#filter1121)"
+       d="m -268,700.15563 0,-33.72973 c 0,-27.24324 3.88785,-31.13513 31.10302,-31.13513 l 33.79408,0 c 27.21507,0 31.1029,3.89189 31.1029,31.13513 l 0,33.72973 c 0,27.24325 -3.88783,31.13514 -31.1029,31.13514 l -33.79408,0 C -264.11215,731.29077 -268,727.39888 -268,700.15563 Z"
+       id="path6455"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="sssssssss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer3"
+     inkscape:label="PLACE YOUR PICTOGRAM HERE"
+     style="display:inline" />
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="BADGE"
+     style="display:none"
+     sodipodi:insensitive="true">
+    <g
+       style="display:inline"
+       transform="translate(-340.00001,-581)"
+       id="g4394"
+       clip-path="none">
+      <g
+         id="g855">
+        <g
+           inkscape:groupmode="maskhelper"
+           id="g870"
+           clip-path="url(#clipPath873)"
+           style="opacity:0.6;filter:url(#filter891)">
+          <path
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-237.54282)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path844"
+             style="color:#000000;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+        </g>
+        <g
+           id="g862">
+          <path
+             sodipodi:type="arc"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4398"
+             sodipodi:cx="252"
+             sodipodi:cy="552.36218"
+             sodipodi:rx="12"
+             sodipodi:ry="12"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             transform="matrix(1.4999992,0,0,1.4999992,-29.999795,-238.54282)" />
+          <path
+             transform="matrix(1.25,0,0,1.25,33,-100.45273)"
+             d="m 264,552.36218 a 12,12 0 1 1 -24,0 A 12,12 0 1 1 264,552.36218 Z"
+             sodipodi:ry="12"
+             sodipodi:rx="12"
+             sodipodi:cy="552.36218"
+             sodipodi:cx="252"
+             id="path4400"
+             style="color:#000000;fill:#dd4814;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:4;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             sodipodi:type="arc" />
+          <path
+             sodipodi:type="star"
+             style="color:#000000;fill:#f5f5f5;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+             id="path4459"
+             sodipodi:sides="5"
+             sodipodi:cx="666.19574"
+             sodipodi:cy="589.50385"
+             sodipodi:r1="7.2431178"
+             sodipodi:r2="4.3458705"
+             sodipodi:arg1="1.0471976"
+             sodipodi:arg2="1.6755161"
+             inkscape:flatsided="false"
+             inkscape:rounded="0.1"
+             inkscape:randomized="0"
+             d="m 669.8173,595.77657 c -0.39132,0.22593 -3.62645,-1.90343 -4.07583,-1.95066 -0.44938,-0.0472 -4.05653,1.36297 -4.39232,1.06062 -0.3358,-0.30235 0.68963,-4.03715 0.59569,-4.47913 -0.0939,-0.44198 -2.5498,-3.43681 -2.36602,-3.8496 0.18379,-0.41279 4.05267,-0.59166 4.44398,-0.81759 0.39132,-0.22593 2.48067,-3.48704 2.93005,-3.4398 0.44938,0.0472 1.81505,3.67147 2.15084,3.97382 0.3358,0.30236 4.08294,1.2817 4.17689,1.72369 0.0939,0.44198 -2.9309,2.86076 -3.11469,3.27355 C 669.9821,591.68426 670.20862,595.55064 669.8173,595.77657 Z"
+             transform="matrix(1.511423,-0.16366377,0.16366377,1.511423,-755.37346,-191.93651)" />
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/layer.yaml b/SOL004/simple_nopasswd_vnf/charms/layers/simple/layer.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..9187216ba37080c543adb1a4a7950391e8bd5724
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/layer.yaml
@@ -0,0 +1,4 @@
+includes: ['layer:basic', 'layer:vnfproxy']
+options:
+  basic:
+    use_venv: false
\ No newline at end of file
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/metadata.yaml b/SOL004/simple_nopasswd_vnf/charms/layers/simple/metadata.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..72df2a6f3ae0377fba3018d9b7bcacc8a698b150
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/metadata.yaml
@@ -0,0 +1,16 @@
+name: simple
+summary: A simple VNF proxy charm
+maintainer: Adam Israel <adam.israel@canonical.com>
+description: |
+  VNF proxy charms are a lightweight version of a charm that, rather than
+  installing software on the same machine, execute commands over an ssh channel.
+tags:
+  # Replace misc with one or more whitelisted tags from this list:
+  # https://jujucharms.com/docs/stable/authors-charm-metadata
+  - misc
+  - osm
+  - vnf
+series:
+- xenial
+- trusty
+subordinate: false
\ No newline at end of file
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/reactive/simple.py b/SOL004/simple_nopasswd_vnf/charms/layers/simple/reactive/simple.py
new file mode 100644
index 0000000000000000000000000000000000000000..21e3ff9175516ff66fa3eeac0cd3d4229a8ed9e8
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/reactive/simple.py
@@ -0,0 +1,35 @@
+from charmhelpers.core.hookenv import (
+    action_get,
+    action_fail,
+    action_set,
+    status_set,
+)
+from charms.reactive import (
+    clear_flag,
+    set_flag,
+    when,
+    when_not,
+)
+import charms.sshproxy
+
+
+@when('sshproxy.configured')
+@when_not('simple.installed')
+def install_simple_proxy_charm():
+    set_flag('simple.installed')
+    status_set('active', 'Ready!')
+
+
+@when('actions.touch')
+def touch():
+    err = ''
+    try:
+        filename = action_get('filename')
+        cmd = ['touch {}'.format(filename)]
+        result, err = charms.sshproxy._run(cmd)
+    except:
+        action_fail('command failed:' + err)
+    else:
+        action_set({'outout': result})
+    finally:
+        clear_flag('actions.touch')
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/00-setup b/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/00-setup
new file mode 100644
index 0000000000000000000000000000000000000000..f0616a560a811bae78d7872dd433d612909c73cd
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/00-setup
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+sudo add-apt-repository ppa:juju/stable -y
+sudo apt-get update
+sudo apt-get install amulet python-requests -y
diff --git a/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/10-deploy b/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/10-deploy
new file mode 100644
index 0000000000000000000000000000000000000000..9a26117089498423ebba7dda3f7e3acb50ba54e7
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/charms/layers/simple/tests/10-deploy
@@ -0,0 +1,35 @@
+#!/usr/bin/python3
+
+import amulet
+import requests
+import unittest
+
+
+class TestCharm(unittest.TestCase):
+    def setUp(self):
+        self.d = amulet.Deployment()
+
+        self.d.add('simple')
+        self.d.expose('simple')
+
+        self.d.setup(timeout=900)
+        self.d.sentry.wait()
+
+        self.unit = self.d.sentry['simple'][0]
+
+    def test_service(self):
+        # test we can access over http
+        page = requests.get('http://{}'.format(self.unit.info['public-address']))
+        self.assertEqual(page.status_code, 200)
+        # Now you can use self.d.sentry[SERVICE][UNIT] to address each of the units and perform
+        # more in-depth steps. Each self.d.sentry[SERVICE][UNIT] has the following methods:
+        # - .info - An array of the information of that unit from Juju
+        # - .file(PATH) - Get the details of a file on that unit
+        # - .file_contents(PATH) - Get plain text output of PATH file from that unit
+        # - .directory(PATH) - Get details of directory
+        # - .directory_contents(PATH) - List files and folders in PATH on that unit
+        # - .relation(relation, service:rel) - Get relation data from return service
+
+        
+if __name__ == '__main__':
+    unittest.main()
diff --git a/SOL004/simple_nopasswd_vnf/cloud_init/cloud-config.txt b/SOL004/simple_nopasswd_vnf/cloud_init/cloud-config.txt
new file mode 100644
index 0000000000000000000000000000000000000000..f6c1b9dcf3a0506e7366e58d0318a5df5f2639ce
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,13 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # My new helloworld file
+
+    owner: root:root
+    permissions: '0644'
+    path: /root/helloworld.txt
+
diff --git a/SOL004/simple_nopasswd_vnf/icons/osm.png b/SOL004/simple_nopasswd_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/simple_nopasswd_vnf/icons/osm.png differ
diff --git a/SOL004/simple_nopasswd_vnf/simple_nopasswd_vnfd.yaml b/SOL004/simple_nopasswd_vnf/simple_nopasswd_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..d94d716ef499157f6c0aa71c950351d0d50962de
--- /dev/null
+++ b/SOL004/simple_nopasswd_vnf/simple_nopasswd_vnfd.yaml
@@ -0,0 +1,128 @@
+vnfd:
+  description: A VNF consisting of 2 VDUs connected to an internal VL, and one VDU
+    with cloud-init
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          config-primitive:
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - data-type: STRING
+              default-value: /home/ubuntu/touched
+              name: filename
+          id: simple_nopasswd-vnf
+          execution-environment-list:
+          - id: simple-ee
+            juju:
+              charm: simple
+          initial-config-primitive:
+          - name: config
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: ubuntu
+            seq: '1'
+          - name: touch
+            execution-environment-ref: simple-ee
+            parameter:
+            - name: filename
+              value: /home/ubuntu/first-touch
+            seq: '2'
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: dataVM
+  id: simple_nopasswd-vnf
+  int-virtual-link-desc:
+  - id: internal
+  mgmt-cp: vnf-mgmt-ext
+  product-name: simple_nopasswd-vnf
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - id: dataVM
+    int-cpd:
+    - id: dataVM-eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: dataVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: dataVM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/slice_basic_middle_ns/slice_basic_middle_nsd.yaml b/SOL004/slice_basic_middle_ns/slice_basic_middle_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..2da176c60ae6dbcda3664f3e807f26413d691936
--- /dev/null
+++ b/SOL004/slice_basic_middle_ns/slice_basic_middle_nsd.yaml
@@ -0,0 +1,43 @@
+nsd:
+  nsd:
+  - id: slice_basic_middle_ns
+    name: slice_basic_middle_ns
+    description: NSD to be used on Slice Testing
+    designer: OSM
+    version: '1.0'
+
+    vnfd-id:
+    - slice_basic_middle_vnf
+
+    sapd:
+    - id: nsd_cp_mgmt
+      virtual-link-desc: nsd_vnfd_vld_mgmt
+    - id: nsd_cp_data1
+      virtual-link-desc: nsd_vnfd_vld_data1
+    - id: nsd_cp_data2
+      virtual-link-desc: nsd_vnfd_vld_data2
+
+    virtual-link-desc:
+    - id: nsd_vnfd_vld_mgmt
+      mgmt-network: true
+    - id: nsd_vnfd_vld_data1
+    - id: nsd_vnfd_vld_data2
+
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: middle
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: middle
+            constituent-cpd-id: eth0-ext
+          virtual-link-profile-id: nsd_vnfd_vld_mgmt
+        - constituent-cpd-id:
+          - constituent-base-element-id: middle
+            constituent-cpd-id: eth1-ext
+          virtual-link-profile-id: nsd_vnfd_vld_data1
+        - constituent-cpd-id:
+          - constituent-base-element-id: middle
+            constituent-cpd-id: eth2-ext
+          virtual-link-profile-id: nsd_vnfd_vld_data2
+        vnfd-id: slice_basic_middle_vnf
diff --git a/SOL004/slice_basic_middle_vnf/cloud_init/cloud-config.txt b/SOL004/slice_basic_middle_vnf/cloud_init/cloud-config.txt
new file mode 100644
index 0000000000000000000000000000000000000000..4903eb73358379913d928495903ef14361fd7039
--- /dev/null
+++ b/SOL004/slice_basic_middle_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,23 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        network:
+            version: 2
+            ethernets:
+                ens3:
+                    dhcp4: true
+                ens4:
+                    dhcp4: true
+                ens5:
+                    dhcp4: true
+    owner: root:root
+    permissions: '0644'
+    path: /etc/netplan/01-netcfg.yaml
+
+runcmd:
+-   [ mv, /etc/netplan/50-cloud-init.yaml, /etc/netplan/50-cloud-init.yaml.bak ]
+-   [ netplan, apply ]
diff --git a/SOL004/slice_basic_middle_vnf/slice_basic_middle_vnfd.yaml b/SOL004/slice_basic_middle_vnf/slice_basic_middle_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a3ba8c83787353f94207857940f685bcafffbed0
--- /dev/null
+++ b/SOL004/slice_basic_middle_vnf/slice_basic_middle_vnfd.yaml
@@ -0,0 +1,74 @@
+vnfd:
+  description: VNFD with 3 CPs to be used on Slice Testing
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: ubuntu_slice-VM
+    vdu-profile:
+    - id: ubuntu_slice-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: eth0-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: ubuntu_slice-VM
+  - id: eth1-ext
+    int-cpd:
+      cpd: eth1-int
+      vdu-id: ubuntu_slice-VM
+  - id: eth2-ext
+    int-cpd:
+      cpd: eth2-int
+      vdu-id: ubuntu_slice-VM
+  id: slice_basic_middle_vnf
+  mgmt-cp: eth0-ext
+  product-name: slice_basic_middle_vnf
+  provider: OSM
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    description: ubuntu_slice-VM
+    id: ubuntu_slice-VM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    - id: eth1-int
+      virtual-network-interface-requirement:
+      - name: eth1
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    - id: eth2-int
+      virtual-network-interface-requirement:
+      - name: eth2
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    name: ubuntu_slice-VM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: ubuntu_slice-VM-compute
+    virtual-storage-desc:
+    - ubuntu_slice-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: ubuntu_slice-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: ubuntu_slice-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/slice_basic_ns/README.md b/SOL004/slice_basic_ns/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..4f499fb45fb173a58aa22c1ba219088ce28e83db
--- /dev/null
+++ b/SOL004/slice_basic_ns/README.md
@@ -0,0 +1,3 @@
+# Descriptor created by OSM descriptor package generated
+
+**Created on 11/16/2019, 21:57:41 **
\ No newline at end of file
diff --git a/SOL004/slice_basic_ns/checksum.txt b/SOL004/slice_basic_ns/checksum.txt
new file mode 100644
index 0000000000000000000000000000000000000000..9a624070a4a203ce1b588f612fc3e2eff305854a
--- /dev/null
+++ b/SOL004/slice_basic_ns/checksum.txt
@@ -0,0 +1,2 @@
+795fae75abfafb4c8d26d76b535c0b97	slice_hackfest_ns/slice_hackfest_nsd.yaml
+5c407322d4361b1594e897cffc9c6977	slice_hackfest_ns/README.md
diff --git a/SOL004/slice_basic_ns/slice_basic_nsd.yaml b/SOL004/slice_basic_ns/slice_basic_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..bb84cc1e2614c5bb95978f7e32cbe93d3cc876c2
--- /dev/null
+++ b/SOL004/slice_basic_ns/slice_basic_nsd.yaml
@@ -0,0 +1,39 @@
+nsd:
+  nsd:
+  - id: slice_basic_ns
+    name: slice_basic_ns
+    description: NSD to be used on Slice Testing
+    designer: OSM
+    version: '1.0'
+
+    vnfd-id:
+    - slice_basic_vnf
+
+    sapd:
+    - id: nsd_cp_mgmt
+      virtual-link-desc: nsd_vnfd_vld_mgmt
+    - id: nsd_cp_data
+      virtual-link-desc: nsd_vnfd_vld_data
+
+    virtual-link-desc:
+    - id: nsd_vnfd_vld_mgmt
+      mgmt-network: true
+    - id: nsd_vnfd_vld_data
+
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: edge
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: edge
+            constituent-cpd-id: eth0-ext
+          virtual-link-profile-id: nsd_vnfd_vld_mgmt
+        - constituent-cpd-id:
+          - constituent-base-element-id: edge
+            constituent-cpd-id: eth1-ext
+          virtual-link-profile-id: nsd_vnfd_vld_data
+        vnfd-id: slice_basic_vnf
+
+
+
diff --git a/SOL004/slice_basic_nst/slice_basic_2nd_nst.yaml b/SOL004/slice_basic_nst/slice_basic_2nd_nst.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..02c0dc2bda44157810d87c00f6c0c6a24ed4d4c9
--- /dev/null
+++ b/SOL004/slice_basic_nst/slice_basic_2nd_nst.yaml
@@ -0,0 +1,51 @@
+# Copyright [2018] [Felipe Vicens, Pol Alemany, Ricard Vilalta]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#NST to test VLD connection between Network Services within the same VIM
+nst:
+-   id: slice_basic_nst2
+    name: slice_basic_nst2
+    SNSSAI-identifier:
+        slice-service-type: eMBB
+    quality-of-service:
+        id: 1
+
+    netslice-subnet:
+    -   id: slice_basic_nsd_2
+        is-shared-nss: true
+        description: NetSlice Subnet (service) composed by 1 vnf with 3 cp
+        nsd-ref: slice_basic_middle_ns
+    -   id: slice_basic_nsd_3
+        is-shared-nss: false
+        description: NetSlice Subnet (service) composed by 1 vnf with 2 cp
+        nsd-ref: slice_basic_ns
+
+    netslice-vld:
+    -   id: slice_vld_mgmt
+        name: slice_vld_mgmt
+        type: ELAN
+        mgmt-network: true
+        nss-connection-point-ref:
+        -   nss-ref: slice_basic_nsd_2
+            nsd-connection-point-ref: nsd_cp_mgmt
+        -   nss-ref: slice_basic_nsd_3
+            nsd-connection-point-ref: nsd_cp_mgmt
+    -   id: slice_vld_data2
+        name: slice_vld_data2
+        type: ELAN
+        nss-connection-point-ref:
+        -   nss-ref: slice_basic_nsd_2
+            nsd-connection-point-ref: nsd_cp_data2
+        -   nss-ref: slice_basic_nsd_3
+            nsd-connection-point-ref: nsd_cp_data
diff --git a/SOL004/slice_basic_nst/slice_basic_nst.yaml b/SOL004/slice_basic_nst/slice_basic_nst.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..eb2982ed01971da741fd9e748a292c5ea5bda60e
--- /dev/null
+++ b/SOL004/slice_basic_nst/slice_basic_nst.yaml
@@ -0,0 +1,65 @@
+# Copyright [2018] [Felipe Vicens, Pol Alemany, Ricard Vilalta]
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+#NST to test VLD connection between Network Services within the same VIM
+nst:
+-   id: slice_basic_nst
+    name: slice_basic_nst
+    SNSSAI-identifier:
+        slice-service-type: eMBB
+    quality-of-service:
+        id: 1
+
+    netslice-subnet:
+    -   id: slice_basic_nsd_1
+        is-shared-nss: false
+        description: NetSlice Subnet (service) composed by 1 vnf with 2 cp
+        nsd-ref: slice_basic_ns
+    -   id: slice_basic_nsd_2
+        is-shared-nss: true
+        description: NetSlice Subnet (service) composed by 1 vnf with 3 cp
+        nsd-ref: slice_basic_middle_ns
+    -   id: slice_basic_nsd_3
+        is-shared-nss: false
+        description: NetSlice Subnet (service) composed by 1 vnf with 2 cp
+        nsd-ref: slice_basic_ns
+
+    netslice-vld:
+    -   id: slice_vld_mgmt
+        name: slice_vld_mgmt
+        type: ELAN
+        mgmt-network: true
+        nss-connection-point-ref:
+        -   nss-ref: slice_basic_nsd_1
+            nsd-connection-point-ref: nsd_cp_mgmt
+        -   nss-ref: slice_basic_nsd_2
+            nsd-connection-point-ref: nsd_cp_mgmt
+        -   nss-ref: slice_basic_nsd_3
+            nsd-connection-point-ref: nsd_cp_mgmt
+    -   id: slice_vld_data1
+        name: slice_vld_data1
+        type: ELAN
+        nss-connection-point-ref:
+        -   nss-ref: slice_basic_nsd_1
+            nsd-connection-point-ref: nsd_cp_data
+        -   nss-ref: slice_basic_nsd_2
+            nsd-connection-point-ref: nsd_cp_data1
+    -   id: slice_vld_data2
+        name: slice_vld_data2
+        type: ELAN
+        nss-connection-point-ref:
+        -   nss-ref: slice_basic_nsd_2
+            nsd-connection-point-ref: nsd_cp_data2
+        -   nss-ref: slice_basic_nsd_3
+            nsd-connection-point-ref: nsd_cp_data
diff --git a/SOL004/slice_basic_vnf/README.md b/SOL004/slice_basic_vnf/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c838736fd6138970466a01379e2f2951fe544742
--- /dev/null
+++ b/SOL004/slice_basic_vnf/README.md
@@ -0,0 +1,3 @@
+# Descriptor created by OSM descriptor package generated
+
+**Created on 11/16/2019, 21:57:47 **
\ No newline at end of file
diff --git a/SOL004/slice_basic_vnf/checksum.txt b/SOL004/slice_basic_vnf/checksum.txt
new file mode 100644
index 0000000000000000000000000000000000000000..90b1d514aced5f7646b9bb26c147981b4805c3f1
--- /dev/null
+++ b/SOL004/slice_basic_vnf/checksum.txt
@@ -0,0 +1,3 @@
+6e520d5ea4d901d93b3d867b359a3f01	slice_hackfest_vnf/README.md
+d61c2ce4cb9e19e774d08a1b60596247	slice_hackfest_vnf/slice_hackfest_vnfd.yaml
+3a4799d01502c86f56b0412dc33cf647	slice_hackfest_vnf/cloud_init/cloud-config.txt
diff --git a/SOL004/slice_basic_vnf/cloud_init/cloud-config.txt b/SOL004/slice_basic_vnf/cloud_init/cloud-config.txt
new file mode 100644
index 0000000000000000000000000000000000000000..853ce1020fa411266064f7b6ad66efca2bcedbdd
--- /dev/null
+++ b/SOL004/slice_basic_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,22 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        network:
+            version: 2
+            ethernets:
+                ens3:
+                    dhcp4: true
+                ens4:
+                    dhcp4: true
+    owner: root:root
+    permissions: '0644'
+    path: /etc/netplan/01-netcfg.yaml
+
+runcmd:
+-   [ mv, /etc/netplan/50-cloud-init.yaml, /etc/netplan/50-cloud-init.yaml.bak ]
+-   [ netplan, apply ]
+
diff --git a/SOL004/slice_basic_vnf/slice_basic_vnfd.yaml b/SOL004/slice_basic_vnf/slice_basic_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ab17e0d95f9ad28a3ed0ffb77c32c914fab1b7cc
--- /dev/null
+++ b/SOL004/slice_basic_vnf/slice_basic_vnfd.yaml
@@ -0,0 +1,63 @@
+vnfd:
+  description: VNFD with 2 CPs to be used on Slice Testing
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: ubuntu_slice-VM
+    vdu-profile:
+    - id: ubuntu_slice-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: eth0-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: ubuntu_slice-VM
+  - id: eth1-ext
+    int-cpd:
+      cpd: eth1-int
+      vdu-id: ubuntu_slice-VM
+  id: slice_basic_vnf
+  mgmt-cp: eth0-ext
+  product-name: slice_basic_vnf
+  provider: OSM
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    description: ubuntu_slice-VM
+    id: ubuntu_slice-VM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    - id: eth1-int
+      virtual-network-interface-requirement:
+      - name: eth1
+        virtual-interface:
+          bandwidth: 0
+          type: VIRTIO
+          vpci: 0000:00:0a.0
+    name: ubuntu_slice-VM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: ubuntu_slice-VM-compute
+    virtual-storage-desc:
+    - ubuntu_slice-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: ubuntu_slice-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 1.0
+  virtual-storage-desc:
+  - id: ubuntu_slice-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/snmp_ee_ns/snmp_ee_nsd.yaml b/SOL004/snmp_ee_ns/snmp_ee_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ae6de4d5d719b0f9acae5f032404c72b3e9a960e
--- /dev/null
+++ b/SOL004/snmp_ee_ns/snmp_ee_nsd.yaml
@@ -0,0 +1,31 @@
+nsd:
+  nsd:
+  - description: Single VyOS Router VNF with SNMP metrics
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: VyOS Router
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-internal-ext
+          virtual-link-profile-id: internal
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-external-ext
+          virtual-link-profile-id: external
+        vnfd-id: snmp_ee-vnf
+    id: snmp_ee-ns
+    name: snmp_ee-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: internal
+    - id: external
+    vnfd-id:
+    - snmp_ee-vnf
diff --git a/SOL004/snmp_ee_vnf/cloud_init/vyos-userdata b/SOL004/snmp_ee_vnf/cloud_init/vyos-userdata
new file mode 100644
index 0000000000000000000000000000000000000000..6466aa9deea47c9d115ec2a8967d1a82ebd4cfc8
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/cloud_init/vyos-userdata
@@ -0,0 +1,22 @@
+#!/bin/vbash
+source /opt/vyatta/etc/functions/script-template
+# Interface Config eth0
+set interfaces ethernet eth0 address dhcp
+set interfaces ethernet eth0 description VyOS-eth0
+# Interface Config eth1
+set interfaces ethernet eth1 address 10.0.0.1/24
+set interfaces ethernet eth1 description VyOS-eth1
+# Interface Config eth2
+set interfaces ethernet eth2 address 10.1.0.1/24
+set interfaces ethernet eth2 description VyOS-eth2
+# System config
+set system host-name vyos-osmTest
+set service ssh listen-address 0.0.0.0
+set service ssh port 22
+set system login user osm authentication plaintext-password osm2020
+# SNMP
+set service snmp community public authorization ro
+set service snmp location "OSM Labs"
+# Save
+commit
+save
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/.helmignore b/SOL004/snmp_ee_vnf/helm-charts/eechart/.helmignore
new file mode 100755
index 0000000000000000000000000000000000000000..50af0317254197a5a019f4ac2f8ecc223f93f5a7
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/.helmignore
@@ -0,0 +1,22 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/Chart.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/Chart.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..414c5f1aa1becbd34d69342874b63db8bb1cb77c
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/Chart.yaml
@@ -0,0 +1,5 @@
+apiVersion: v1
+appVersion: "1.0"
+description: OSM EE helm chart
+name: eechart
+version: 0.1.0
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore
new file mode 100644
index 0000000000000000000000000000000000000000..691fa13d6a54c577aca389fe34f4d9e237824a12
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore
@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..eeb867cb0b4c7dfbdb2d2a7d99391ec703b34836
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml
@@ -0,0 +1,10 @@
+apiVersion: v1
+name: snmpexporter
+description: SNMP Exporter for OSM VNF
+type: application
+version: 1.0.0
+appVersion: 1.0.0
+dependencies:
+  - name: snmp-exporter
+    version: "0.17.0"
+    repository: "https://hub.docker.com/r/prom/snmp-exporter"
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
new file mode 100644
index 0000000000000000000000000000000000000000..a2aef96ec04b3c6f2e24906331d53467d7be8033
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
@@ -0,0 +1,63 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "snmpexporter.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "snmpexporter.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "snmpexporter.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "snmpexporter.labels" -}}
+helm.sh/chart: {{ include "snmpexporter.chart" . }}
+{{ include "snmpexporter.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "snmpexporter.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "snmpexporter.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "snmpexporter.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "snmpexporter.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..fcf2f18159a0b6ee431b4bcffc8c02817bd79ae0
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
@@ -0,0 +1,20071 @@
+
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+  snmp.yml: |-
+    # WARNING: This file was auto-generated using snmp_exporter generator, manual changes will be lost.
+    apcups:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.4.1.318.1.1.1.12
+      - 1.3.6.1.4.1.318.1.1.1.2
+      - 1.3.6.1.4.1.318.1.1.1.3
+      - 1.3.6.1.4.1.318.1.1.1.4
+      - 1.3.6.1.4.1.318.1.1.1.7.2
+      - 1.3.6.1.4.1.318.1.1.10.2.3.2
+      - 1.3.6.1.4.1.318.1.1.26.8.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.318.1.1.1.8.1.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: upsOutletGroupStatusTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.1.1
+      - name: upsOutletGroupStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusGroupState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupStatusOn
+          2: upsOutletGroupStatusOff
+          3: upsOutletGroupStatusUnknown
+      - name: upsOutletGroupStatusCommandPending
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        type: gauge
+        help: Getting this variable will return the command pending state of the outlet
+          group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupCommandPending
+          2: upsOutletGroupNoCommandPending
+      - name: upsOutletGroupStatusOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupStatusGroupFullState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        type: DisplayString
+        help: An ASCII string containing the 32 flags representing the current state(s)
+          of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupConfigTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.2.1
+      - name: upsOutletGroupConfigIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        type: DisplayString
+        help: The name of the outlet group. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOnDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering on when
+          the delayed on, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering off when
+          the delayed off, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigRebootDuration
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        type: gauge
+        help: During a reboot sequence, power is turned off and then back on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigMinReturnRuntime
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        type: gauge
+        help: In an Outlet Group shutdown sequence, the Outlet Group cycles power off
+          then on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupConfigLoadShedControlSkipOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        type: gauge
+        help: Configures whether the outlet group's off delay setting (upsOutletGroupConfigPowerOffDelay)
+          will be used in a load shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigSkipOffDelay
+          2: upsOutletGroupConfigUseOffDelay
+      - name: upsOutletGroupConfigLoadShedControlAutoRestart
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        type: gauge
+        help: Configures whether the outlet group will automatically restart after a load
+          shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigAutoRestart
+          2: upsOutletGroupConfigManualRestart
+      - name: upsOutletGroupConfigLoadShedControlTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) after the
+          UPS's time on battery has exceeded the upsOutletGroupConfigLoadShedTimeOnBattery
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableTimeOnBatteryLoadShed
+          2: upsOutletGroupConfigEnableTimeOnBatteryLoadShed
+      - name: upsOutletGroupConfigLoadShedControlRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is on battery and the remaining runtime is less than the upsOutletGroupConfigLoadShedRuntimeRemaining
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableRuntimeRemainingLoadShed
+          2: upsOutletGroupConfigEnableRuntimeRemainingLoadShed
+      - name: upsOutletGroupConfigLoadShedControlInOverload
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is in an overload condition - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableInOverloadLoadShed
+          2: upsOutletGroupConfigEnableInOverloadLoadShed
+      - name: upsOutletGroupConfigLoadShedTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        type: gauge
+        help: When the UPS has been on battery for more time than this value, the outlet
+          group will turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlTimeOnBattery
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigLoadShedRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        type: gauge
+        help: When the runtime remaining is less than this value, the outlet group will
+          turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlRuntimeRemaining
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupControlTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.3.1
+      - name: upsOutletGroupControlIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlCommand
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupImmediateOn
+          2: upsOutletGroupImmediateOff
+          3: upsOutletGroupImmediateRebootWithOrWithoutAC
+          4: upsOutletGroupDelayedOn
+          5: upsOutletGroupDelayedOff
+          6: upsOutletGroupDelayedRebootWithOrWithoutAC
+          7: upsOutletGroupCancelPendingCommand
+          8: upsOutletGroupControlUnknown
+          9: upsOutletGroupImmediateRebootShutdown
+          10: upsOutletGroupDelayedRebootShutdown
+      - name: upsOutletGroupControlOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsBasicBatteryStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.1
+        type: gauge
+        help: The status of the UPS batteries - 1.3.6.1.4.1.318.1.1.1.2.1.1
+        enum_values:
+          1: unknown
+          2: batteryNormal
+          3: batteryLow
+          4: batteryInFaultCondition
+      - name: upsBasicBatteryTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.2
+        type: gauge
+        help: The elapsed time since the UPS has switched to battery power. - 1.3.6.1.4.1.318.1.1.1.2.1.2
+      - name: upsBasicBatteryLastReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.3
+        type: DisplayString
+        help: The date when the UPS system's batteries were last replaced in mm/dd/yy
+          (or yyyy) format - 1.3.6.1.4.1.318.1.1.1.2.1.3
+      - name: upsAdvBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.1
+        type: gauge
+        help: The remaining battery capacity expressed in percent of full capacity. -
+          1.3.6.1.4.1.318.1.1.1.2.2.1
+      - name: upsAdvBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.2
+        type: gauge
+        help: The current internal UPS temperature expressed in Celsius - 1.3.6.1.4.1.318.1.1.1.2.2.2
+      - name: upsAdvBatteryRunTimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.3
+        type: gauge
+        help: The UPS battery run time remaining before battery exhaustion. - 1.3.6.1.4.1.318.1.1.1.2.2.3
+      - name: upsAdvBatteryReplaceIndicator
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.4
+        type: gauge
+        help: Indicates whether the UPS batteries need replacing. - 1.3.6.1.4.1.318.1.1.1.2.2.4
+        enum_values:
+          1: noBatteryNeedsReplacing
+          2: batteryNeedsReplacing
+      - name: upsAdvBatteryNumOfBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.5
+        type: gauge
+        help: The number of external battery packs connected to the UPS - 1.3.6.1.4.1.318.1.1.1.2.2.5
+      - name: upsAdvBatteryNumOfBadBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.6
+        type: gauge
+        help: The number of external battery packs connected to the UPS that are defective
+          - 1.3.6.1.4.1.318.1.1.1.2.2.6
+      - name: upsAdvBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.7
+        type: gauge
+        help: The nominal battery voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.7
+      - name: upsAdvBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.8
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.8
+      - name: upsAdvBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.9
+        type: gauge
+        help: The battery current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.9
+      - name: upsAdvTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.10
+        type: gauge
+        help: The total DC current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.10
+      - name: upsAdvBatteryFullCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.11
+        type: gauge
+        help: The full chargeable capacity of the battery which is expressed in percentage.
+          - 1.3.6.1.4.1.318.1.1.1.2.2.11
+      - name: upsAdvBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        type: gauge
+        help: The selected Battery Voltage Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        type: gauge
+        help: The selected Battery Current Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvTotalFrameDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        type: gauge
+        help: The Total DC Current of battery in Amperes. - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        type: gauge
+        help: The battery frame identifier. - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        type: gauge
+        help: The selected Battery current polarity - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        type: gauge
+        help: The Battery current measured in Amperes - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryEstimatedChargeTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.15
+        type: gauge
+        help: The estimated remaining time required to charge the UPS to a full state
+          of charge. - 1.3.6.1.4.1.318.1.1.1.2.2.15
+      - name: upsAdvBatteryPower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.16
+        type: gauge
+        help: The measured battery power in kW. - 1.3.6.1.4.1.318.1.1.1.2.2.16
+      - name: upsAdvBatteryChargerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.17
+        type: EnumAsStateSet
+        help: The status of the battery charger - 1.3.6.1.4.1.318.1.1.1.2.2.17
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+          4: floatCharging
+          5: boostCharging
+          6: resting
+          7: notCharging
+          8: equalizationCharging
+          9: testInProgress
+          10: cyclicFloatCharging
+      - name: upsAdvBatteryInternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.19
+        type: DisplayString
+        help: The SKU of the internal battery. - 1.3.6.1.4.1.318.1.1.1.2.2.19
+      - name: upsAdvBatteryExternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.20
+        type: DisplayString
+        help: The SKU of the external battery. - 1.3.6.1.4.1.318.1.1.1.2.2.20
+      - name: upsAdvBatteryRecommendedReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.21
+        type: DisplayString
+        help: The recommended replacement date for the battery based on the UPS internal
+          battery life algorithm. - 1.3.6.1.4.1.318.1.1.1.2.2.21
+      - name: upsAdvBatteryNominalBackupTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.22
+        type: gauge
+        help: Defines the runtime of the user supplied battery in minutes, when battery
+          is new. - 1.3.6.1.4.1.318.1.1.1.2.2.22
+      - name: upsAdvBatteryCondition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.23
+        type: EnumAsStateSet
+        help: Health of the battries based on the battery test. - 1.3.6.1.4.1.318.1.1.1.2.2.23
+        enum_values:
+          1: unknown
+          2: ok
+          3: weak
+          4: poor
+      - name: upsAdvBatteryChargingCurrentRestricted
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.24
+        type: EnumAsStateSet
+        help: Indicates whether battery charging current is restricted or not - 1.3.6.1.4.1.318.1.1.1.2.2.24
+        enum_values:
+          1: "yes"
+          2: "no"
+      - name: upsAdvBatteryTotalCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.25
+        type: gauge
+        help: The actual available battery capacity of the system expressed in ampere
+          hours (Ah) - 1.3.6.1.4.1.318.1.1.1.2.2.25
+      - name: upsAdvBatteryFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.26
+        type: gauge
+        help: If battery system has one common fuse for the battery system, the status
+          is given by this value - 1.3.6.1.4.1.318.1.1.1.2.2.26
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsAdvBatteryBreakerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.27
+        type: gauge
+        help: The value indicates the aggregated status of the battery breakers in the
+          system - 1.3.6.1.4.1.318.1.1.1.2.2.27
+        enum_values:
+          1: disconnected
+          2: closed
+          3: notPresent
+      - name: upsAdvBatteryWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.28
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.2.28
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsHighPrecBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.1
+        type: gauge
+        help: The remaining battery capacity expressed in tenths of percent of full capacity.
+          - 1.3.6.1.4.1.318.1.1.1.2.3.1
+      - name: upsHighPrecBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.2
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.2
+      - name: upsHighPrecBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.3
+        type: gauge
+        help: The nominal battery voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.3
+      - name: upsHighPrecBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.4
+        type: gauge
+        help: The actual battery bus voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.4
+      - name: upsHighPrecBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.5
+        type: gauge
+        help: The battery current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.5
+      - name: upsHighPrecTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.6
+        type: gauge
+        help: The total DC current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.6
+      - name: upsHighPrecBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        type: gauge
+        help: The selected Battery Voltage polarity - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        type: gauge
+        help: The actual battery bus voltage expressed as tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecTotalDCFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        type: gauge
+        help: The total DC current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        type: gauge
+        help: The Battery current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+      - name: upsHighPrecBatteryPackIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryCartridgeIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        type: gauge
+        help: The battery cartridge identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackSerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        type: OctetString
+        help: The battery cartridge health - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        type: DisplayString
+        help: The battery cartridge estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        type: DisplayString
+        help: The battery cartridge install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        type: OctetString
+        help: The battery cartridge status - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+      - name: upsHighPrecBatteryPackOnlyIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlySerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        type: OctetString
+        help: The battery pack health - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        type: DisplayString
+        help: The battery pack estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        type: DisplayString
+        help: The battery pack install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.11
+        type: OctetString
+        help: The battery health - 1.3.6.1.4.1.318.1.1.1.2.3.11
+      - name: upsHighPrecActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.12
+        type: gauge
+        help: Active Power of Battery in tenths of kW - 1.3.6.1.4.1.318.1.1.1.2.3.12
+      - name: upsHighPrecExtdBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.13
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.13
+      - name: upsBatteryNumberOfCabinets
+        oid: 1.3.6.1.4.1.318.1.1.1.2.4
+        type: gauge
+        help: The value indicates the number of battery cabinets in total, internal and
+          external - 1.3.6.1.4.1.318.1.1.1.2.4
+      - name: upsBatteryCabinetIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        type: gauge
+        help: The Battery Cabinet identifier - 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        type: gauge
+        help: The identification number for the actual battery cabinet in the system -
+          1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsBatteryCabinetVoltagePolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        type: gauge
+        help: The battery voltage - 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetVoltagePolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        type: gauge
+        help: The voltage for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        type: gauge
+        help: The battery current - 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        type: gauge
+        help: The current for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        type: gauge
+        help: The measured temperature of the battery cabinet in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        type: gauge
+        help: The highest temperature measured for the battery in the battery cabinet
+          in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        type: gauge
+        help: The lowest temperature measured for the battery in the battery cabinet in
+          tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        type: gauge
+        help: The average temperature for all the battery sensors in the battery cabinet
+          and for the battery strings, if battery strings are present - 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetFuse
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        type: gauge
+        help: If the battery cabinet has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabinetBreaker
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        type: gauge
+        help: The value indicates the battery cabinet breaker status - 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: noBreaker
+          2: unknown
+          3: breakerOpen
+          4: breakerClosed
+      - name: upsBatteryCabinetNumberOfStrings
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        type: gauge
+        help: The number of battery strings in the battery cabinet - 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfVerticalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        type: gauge
+        help: The number of vertical levels or shelves for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfHorizontalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        type: gauge
+        help: The number of horizontal positions for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabStringIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        type: gauge
+        help: The battery cabinet string identifier - 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCabReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        type: gauge
+        help: Reference to the global battery cabinet index where the battery string is
+          placed. - 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        type: gauge
+        help: Local battery string identification index in the actual battery cabinet
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        type: gauge
+        help: The current in a battery string or battery halfstring, in tenths of Amps.
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        type: gauge
+        help: Temperature of the battery string or the average of the aggregated temperature
+          of each battery block/module (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        type: gauge
+        help: The actual highest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        type: gauge
+        help: The actual lowest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        type: gauge
+        help: If the battery string has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabStringNumberOfBlocks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        type: gauge
+        help: The number of battery blocks/modules in a battery string - 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabBlockIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        type: gauge
+        help: The battery cabinet block identifier - 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockStringReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        type: gauge
+        help: Reference to the specific global battery string index - 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery string
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockPresent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        type: gauge
+        help: Value indicates if battery block/module is present in the system - 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: present
+          2: notPresent
+          3: notAvailable
+      - name: upsBatteryCabBlockType
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        type: DisplayString
+        help: Text string value, showing the vendor and model of the battery in the battery
+          block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        type: gauge
+        help: The temperature for the battery block/module in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        type: gauge
+        help: If the battery module has a fuse, the status is given by this value - 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabBlockVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        type: gauge
+        help: The voltage of the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockNumberOfCells
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        type: gauge
+        help: The number of cells in the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockVerticalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        type: gauge
+        help: The vertical position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockHorizontalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        type: gauge
+        help: The horizontal position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        type: gauge
+        help: The battery block cell identifier - 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        type: gauge
+        help: Reference to the specific global battery block/module index. - 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery block
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        type: gauge
+        help: The measured battery cell voltage - 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        type: gauge
+        help: The temperature for the battery cell in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBasicInputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.3.1.1
+        type: gauge
+        help: The current AC input phase. - 1.3.6.1.4.1.318.1.1.1.3.1.1
+      - name: upsAdvInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.1
+        type: gauge
+        help: The current utility line voltage in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.1
+      - name: upsAdvInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.2
+        type: gauge
+        help: The maximum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.2
+      - name: upsAdvInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.3
+        type: gauge
+        help: The minimum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.3
+      - name: upsAdvInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.4
+        type: gauge
+        help: The current input frequency to the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.4
+      - name: upsAdvInputLineFailCause
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.5
+        type: gauge
+        help: The reason for the occurrence of the last transfer to UPS battery power
+          - 1.3.6.1.4.1.318.1.1.1.3.2.5
+        enum_values:
+          1: noTransfer
+          2: highLineVoltage
+          3: brownout
+          4: blackout
+          5: smallMomentarySag
+          6: deepMomentarySag
+          7: smallMomentarySpike
+          8: largeMomentarySpike
+          9: selfTest
+          10: rateOfVoltageChange
+      - name: upsAdvInputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.6
+        type: gauge
+        help: The nominal input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.6
+      - name: upsAdvInputNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.7
+        type: gauge
+        help: The nominal input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.7
+      - name: upsAdvInputBypassNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.8
+        type: gauge
+        help: The nominal bypass input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.8
+      - name: upsAdvInputBypassNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.9
+        type: gauge
+        help: The nominal bypass input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.9
+      - name: upsAdvInputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        type: gauge
+        help: The input identifier. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        type: gauge
+        help: The input apparent power(sum of all of the three phases) measured in kVA.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        type: gauge
+        help: The input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        type: gauge
+        help: The bypass input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        type: gauge
+        help: The input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        type: gauge
+        help: The bypass input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        type: gauge
+        help: The input active power measured in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.11
+        type: gauge
+        help: The input total apparent power(sum of all three phases) of the UPS system
+          in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.11
+      - name: upsAdvInputTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.12
+        type: gauge
+        help: The input total active power(sum of all three phases) of the UPS system
+          in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.12
+      - name: upsAdvInputBypassTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.13
+        type: gauge
+        help: The input bypass total apparent power(sum of all three phases) of the UPS
+          system in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.13
+      - name: upsAdvInputBypassTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.14
+        type: gauge
+        help: The input bypass total active power(sum of all three phases) of the UPS
+          system in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.14
+      - name: upsAdvInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.15
+        type: gauge
+        help: The input energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.3.2.15
+      - name: upsAdvInputDCVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.16
+        type: gauge
+        help: The DC input voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.3.2.16
+      - name: upsAdvInputDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.17
+        type: gauge
+        help: The DC input current in Amps. - 1.3.6.1.4.1.318.1.1.1.3.2.17
+      - name: upsHighPrecInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.1
+        type: gauge
+        help: The current utility line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.1
+      - name: upsHighPrecInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.2
+        type: gauge
+        help: The maximum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.2
+      - name: upsHighPrecInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.3
+        type: gauge
+        help: The minimum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.3
+      - name: upsHighPrecInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.4
+        type: gauge
+        help: The current input frequency to the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.3.3.4
+      - name: upsHighPrecInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.5
+        type: gauge
+        help: The input energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.3.3.5
+      - name: upsHighPrecInputBypassVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.6
+        type: gauge
+        help: The current bypass line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.6
+      - name: upsHighPrecInputBypassFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.7
+        type: gauge
+        help: The current input bypass frequency to the UPS system in tenths of Hz. -
+          1.3.6.1.4.1.318.1.1.1.3.3.7
+      - name: upsBasicOutputStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.1
+        type: gauge
+        help: The current state of the UPS - 1.3.6.1.4.1.318.1.1.1.4.1.1
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: hotStandby
+          15: onBatteryTest
+          16: emergencyStaticBypass
+          17: staticBypassStandby
+          18: powerSavingMode
+          19: spotMode
+          20: eConversion
+          21: chargerSpotmode
+          22: inverterSpotmode
+          23: activeLoad
+          24: batteryDischargeSpotmode
+          25: inverterStandby
+          26: chargerOnly
+      - name: upsBasicOutputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.2
+        type: gauge
+        help: The actual number of output phases in a UPS - 1.3.6.1.4.1.318.1.1.1.4.1.2
+      - name: upsBasicSystemStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.3
+        type: gauge
+        help: Current state for the whole system (UPS and surrounding breakers) - 1.3.6.1.4.1.318.1.1.1.4.1.3
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: inverter
+          15: eConversion
+          16: staticBypassStandby
+          17: efficiencyBoosterMode
+      - name: upsBasicSystemInternalTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.4
+        type: gauge
+        help: The actual internal temperature of the UPS system in Celsius. - 1.3.6.1.4.1.318.1.1.1.4.1.4
+      - name: upsBasicSystemInverterStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.5
+        type: gauge
+        help: The current state of the UPS inverter - 1.3.6.1.4.1.318.1.1.1.4.1.5
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicSystemPFCStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.6
+        type: gauge
+        help: The general status of the power factor correction (AC input stage of the
+          UPS) - 1.3.6.1.4.1.318.1.1.1.4.1.6
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicOutputACwiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.7
+        type: gauge
+        help: Indicates if neutral wire on output side of the UPS is used (load wired
+          line to neutral) - 1.3.6.1.4.1.318.1.1.1.4.1.7
+        enum_values:
+          1: unknown
+          2: noNeutralWiredonSystem
+          3: neutralUsedforSupplyingLoad
+      - name: upsAdvOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.1
+        type: gauge
+        help: The output voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.4.2.1
+      - name: upsAdvOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.2
+        type: gauge
+        help: The current output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.2
+      - name: upsAdvOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.3
+        type: gauge
+        help: The current UPS load expressed in percent of rated capacity. - 1.3.6.1.4.1.318.1.1.1.4.2.3
+      - name: upsAdvOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.4
+        type: gauge
+        help: The current in amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.2.4
+      - name: upsAdvOutputRedundancy
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.5
+        type: gauge
+        help: The number of power modules which can fail or be removed without causing
+          the UPS to generate a Minimum Redundancy Lost event. - 1.3.6.1.4.1.318.1.1.1.4.2.5
+      - name: upsAdvOutputKVACapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.6
+        type: gauge
+        help: The maximum load that this UPS can support - 1.3.6.1.4.1.318.1.1.1.4.2.6
+      - name: upsAdvOutputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.7
+        type: gauge
+        help: The nominal output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.7
+      - name: upsAdvOutputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.8
+        type: gauge
+        help: The total output active power of the UPS system in W - 1.3.6.1.4.1.318.1.1.1.4.2.8
+      - name: upsAdvOutputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.9
+        type: gauge
+        help: The total output apparent power of all phases of the UPS system in VA. -
+          1.3.6.1.4.1.318.1.1.1.4.2.9
+      - name: upsAdvOutputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        type: gauge
+        help: The output identifier. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        type: gauge
+        help: The output peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCurrentTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        type: gauge
+        help: The output current Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCrestFactor
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        type: gauge
+        help: The output current crest factor expressed in tenths. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputNeutralCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.11
+        type: gauge
+        help: The neutral current in amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.11
+      - name: upsAdvOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.12
+        type: gauge
+        help: The output energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.4.2.12
+      - name: upsAdvOutputSourceSynchronization
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.13
+        type: gauge
+        help: Indicates the synchronization source for the inverter output frequency -
+          1.3.6.1.4.1.318.1.1.1.4.2.13
+      - name: upsAdvOutputInverterFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.14
+        type: gauge
+        help: Output frequency in Hz measured at the output of inverter. - 1.3.6.1.4.1.318.1.1.1.4.2.14
+      - name: upsHighPrecOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.1
+        type: gauge
+        help: The output voltage of the UPS system in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.4.3.1
+      - name: upsHighPrecOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.2
+        type: gauge
+        help: The current output frequency of the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.4.3.2
+      - name: upsHighPrecOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.3
+        type: gauge
+        help: The current UPS load expressed in tenths of percent of rated capacity. -
+          1.3.6.1.4.1.318.1.1.1.4.3.3
+      - name: upsHighPrecOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.4
+        type: gauge
+        help: The current in tenths of amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.3.4
+      - name: upsHighPrecOutputEfficiency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.5
+        type: gauge
+        help: The positive values represent efficiency of the UPS in tenths of percent
+          - 1.3.6.1.4.1.318.1.1.1.4.3.5
+      - name: upsHighPrecOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.6
+        type: gauge
+        help: The output energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.4.3.6
+      - name: upsAdvTestDiagnosticSchedule
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.1
+        type: gauge
+        help: The UPS system's automatic battery test schedule. - 1.3.6.1.4.1.318.1.1.1.7.2.1
+        enum_values:
+          1: unknown
+          2: biweekly
+          3: weekly
+          4: atTurnOn
+          5: never
+          6: fourWeeks
+          7: twelveWeeks
+          8: biweeklySinceLastTest
+          9: weeklySinceLastTest
+          10: eightWeeks
+          11: twentysixWeeks
+          12: fiftytwoWeeks
+      - name: upsAdvTestDiagnostics
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.2
+        type: gauge
+        help: Setting this variable to testDiagnostics(2) causes the UPS to perform a
+          diagnostic self test - 1.3.6.1.4.1.318.1.1.1.7.2.2
+        enum_values:
+          1: noTestDiagnostics
+          2: testDiagnostics
+      - name: upsAdvTestDiagnosticsResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.3
+        type: gauge
+        help: The results of the last UPS diagnostics test performed. - 1.3.6.1.4.1.318.1.1.1.7.2.3
+        enum_values:
+          1: ok
+          2: failed
+          3: invalidTest
+          4: testInProgress
+      - name: upsAdvTestLastDiagnosticsDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.4
+        type: DisplayString
+        help: The date the last UPS diagnostics test was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.4
+      - name: upsAdvTestRuntimeCalibration
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.5
+        type: gauge
+        help: Setting this variable to performCalibration(2) causes the UPS to discharge
+          to calibrate the UPS - 1.3.6.1.4.1.318.1.1.1.7.2.5
+        enum_values:
+          1: noPerformCalibration
+          2: performCalibration
+          3: cancelCurrentCalibration
+      - name: upsAdvTestCalibrationResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.6
+        type: gauge
+        help: The results of the last runtime calibration - 1.3.6.1.4.1.318.1.1.1.7.2.6
+        enum_values:
+          1: ok
+          2: invalidCalibration
+          3: calibrationInProgress
+          4: refused
+          5: aborted
+          6: pending
+      - name: upsAdvTestCalibrationDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.7
+        type: DisplayString
+        help: The date the last UPS runtime calibration was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.7
+      - name: upsAdvTestDiagnosticTime
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.8
+        type: DisplayString
+        help: The time of the day to perform automatic battery test - 1.3.6.1.4.1.318.1.1.1.7.2.8
+      - name: upsAdvTestDiagnosticDay
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.9
+        type: gauge
+        help: The day of the week to perform automatic battery test. - 1.3.6.1.4.1.318.1.1.1.7.2.9
+        enum_values:
+          1: monday
+          2: tuesday
+          3: wednesday
+          4: thursday
+          5: friday
+          6: saturday
+          7: sunday
+      - name: upsAdvTestBatteryInterval
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.10
+        type: DisplayString
+        help: The UPS system's automatic battery test period. - 1.3.6.1.4.1.318.1.1.1.7.2.10
+      - name: upsCommStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.8.1
+        type: gauge
+        help: The status of agent's communication with UPS. - 1.3.6.1.4.1.318.1.1.1.8.1
+        enum_values:
+          1: ok
+          2: noComm
+      - name: iemStatusProbeNumber
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        type: gauge
+        help: The index of the probe. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeName
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        type: DisplayString
+        help: A descriptive name for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeStatus
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        type: gauge
+        help: The connected status of the probe, either disconnected(1) or connected(2).
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connected
+      - name: iemStatusProbeCurrentTemp
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        type: gauge
+        help: The current temperature reading from the probe displayed in the units shown
+          in the 'iemStatusProbeTempUnits' OID (Celsius or Fahrenheit). - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeTempUnits
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        type: gauge
+        help: The temperature scale used to display the temperature thresholds of the
+          probe, Celsius(1) or Fahrenheit(2) - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: celsius
+          2: fahrenheit
+      - name: iemStatusProbeCurrentHumid
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        type: gauge
+        help: The current humidity reading from the probe in percent relative humidity.
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeHighTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highTempViolation
+          3: disabled
+      - name: iemStatusProbeLowTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowTempViolation
+          3: disabled
+      - name: iemStatusProbeHighHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        type: gauge
+        help: The high humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highHumidViolation
+          3: disabled
+      - name: iemStatusProbeLowHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        type: gauge
+        help: The low humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowHumidViolation
+          3: disabled
+      - name: iemStatusProbeMaxTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        type: gauge
+        help: The max temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxTempViolation
+          3: disabled
+      - name: iemStatusProbeMinTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        type: gauge
+        help: The minimum temperature violation status of the probe temperature reading
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minTempViolation
+          3: disabled
+      - name: iemStatusProbeMaxHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        type: gauge
+        help: The maximum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxHumidViolation
+          3: disabled
+      - name: iemStatusProbeMinHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        type: gauge
+        help: The minimum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minHumidViolation
+          3: disabled
+      - name: iemStatusProbeLocation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        type: DisplayString
+        help: A descriptive location for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: rPDU2BankStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        type: gauge
+        help: The index to the Rack PDU bank status table entry - 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusModule
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        type: gauge
+        help: The user-defined Rack PDU numeric ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusNumber
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        type: gauge
+        help: The numeric bank ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusLoadState
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        type: EnumAsStateSet
+        help: Indicates the present load status of the Rack PDU bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+        enum_values:
+          1: lowLoad
+          2: normal
+          3: nearOverload
+          4: overload
+      - name: rPDU2BankStatusCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        type: gauge
+        help: Indicates the current draw, in tenths of Amps, of the load on the Rack PDU
+          bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        type: gauge
+        help: The peak current of the Rack PDU bank load in tenths of Amps - 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentTimestamp
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        type: DisplayString
+        help: Indicates the date and time the bank peak current occurred - 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentStartTime
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        type: DisplayString
+        help: Indicates the date and time of the last bank peak current reset - 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      version: 1
+    arista_sw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2.3.1.6
+      - 1.3.6.1.2.1.25.3.3.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.30065.3.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: aristaSwFwdIpStatsIPVersion
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        type: gauge
+        help: The IP version of this row. - 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+      - name: aristaSwFwdIpStatsInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInHdrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        type: counter
+        help: The number of input IP datagrams discarded in software due to errors in
+          their IP headers, including version number mismatch, other format errors, hop
+          count exceeded, errors discovered in processing their IP options, etc - 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        type: counter
+        help: The number of input IP datagrams discarded in software because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInAddrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        type: counter
+        help: The number of input IP datagrams discarded in software because the IP address
+          in their IP header's destination field was not a valid address to be received
+          at this entity - 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInUnknownProtos
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        type: counter
+        help: The number of locally-addressed IP datagrams received successfully in software
+          but discarded because of an unknown or unsupported protocol - 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInTruncatedPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        type: counter
+        help: The number of input IP datagrams discarded in software because the datagram
+          frame didn't carry enough data - 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        type: counter
+        help: The number of IP fragments received that needed to be reassembled at this
+          interface - 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        type: counter
+        help: The number of IP datagrams successfully reassembled - 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.16
+        type: counter
+        help: 'The number of failures detected by the IP re-assembly algorithm (for whatever
+          reason: timed out, errors, etc.) - 1.3.6.1.4.1.30065.3.1.1.1.1.16'
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        type: counter
+        help: The number of input IP datagrams received in software for which no problems
+          were encountered to prevent their continued processing, but were discarded (e.g.,
+          for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        type: counter
+        help: The number of locally generated IP datagrams discarded because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        type: counter
+        help: The number of output IP datagrams for which no problem was encountered to
+          prevent their transmission to their destination, but were discarded in software
+          (e.g., for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        type: counter
+        help: The number of IP datagrams that would require fragmentation in order to
+          be transmitted - 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        type: counter
+        help: The number of IP datagrams that have been successfully fragmented - 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        type: counter
+        help: The number of IP datagrams that have been discarded because they needed
+          to be fragmented but could not be - 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragCreates
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        type: counter
+        help: The number of output datagram fragments that have been generated as a result
+          of IP fragmentation - 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsDiscontinuityTime
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this entry's counters suffered a discontinuity - 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsRefreshRate
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        type: gauge
+        help: The minimum reasonable polling interval for this entry - 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+    cisco_wlc:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.14179.2.1.1.1.2
+      - 1.3.6.1.4.1.14179.2.1.1.1.38
+      - 1.3.6.1.4.1.14179.2.2.1.1.3
+      - 1.3.6.1.4.1.14179.2.2.13.1.3
+      - 1.3.6.1.4.1.14179.2.2.15.1.21
+      - 1.3.6.1.4.1.14179.2.2.2.1.15
+      - 1.3.6.1.4.1.14179.2.2.2.1.2
+      - 1.3.6.1.4.1.14179.2.2.2.1.4
+      - 1.3.6.1.4.1.14179.2.2.6.1
+      metrics:
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: bsnDot11EssNumberOfMobileStations
+        oid: 1.3.6.1.4.1.14179.2.1.1.1.38
+        type: counter
+        help: No of Mobile Stations currently associated with the WLAN. - 1.3.6.1.4.1.14179.2.1.1.1.38
+        indexes:
+        - labelname: bsnDot11EssIndex
+          type: gauge
+        lookups:
+        - labels:
+          - bsnDot11EssIndex
+          labelname: bsnDot11EssSsid
+          oid: 1.3.6.1.4.1.14179.2.1.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: bsnDot11EssIndex
+      - name: bsnAPIfLoadChannelUtilization
+        oid: 1.3.6.1.4.1.14179.2.2.13.1.3
+        type: gauge
+        help: Channel Utilization - 1.3.6.1.4.1.14179.2.2.13.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDBNoisePower
+        oid: 1.3.6.1.4.1.14179.2.2.15.1.21
+        type: gauge
+        help: This is the average noise power in dBm on each channel that is available
+          to Airespace AP - 1.3.6.1.4.1.14179.2.2.15.1.21
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        - labelname: bsnAPIfNoiseChannelNo
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnApIfNoOfUsers
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.15
+        type: counter
+        help: No of Users associated with this radio. - 1.3.6.1.4.1.14179.2.2.2.1.15
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfType
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.2
+        type: gauge
+        help: The type of this interface - 1.3.6.1.4.1.14179.2.2.2.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: dot11b
+          2: dot11a
+          4: uwb
+      - name: bsnAPIfPhyChannelNumber
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.4
+        type: gauge
+        help: Current channel number of the AP Interface - 1.3.6.1.4.1.14179.2.2.2.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: ch1
+          2: ch2
+          3: ch3
+          4: ch4
+          5: ch5
+          6: ch6
+          7: ch7
+          8: ch8
+          9: ch9
+          10: ch10
+          11: ch11
+          12: ch12
+          13: ch13
+          14: ch14
+          20: ch20
+          21: ch21
+          22: ch22
+          23: ch23
+          24: ch24
+          25: ch25
+          26: ch26
+          34: ch34
+          36: ch36
+          38: ch38
+          40: ch40
+          42: ch42
+          44: ch44
+          46: ch46
+          48: ch48
+          52: ch52
+          56: ch56
+          60: ch60
+          64: ch64
+          100: ch100
+          104: ch104
+          108: ch108
+          112: ch112
+          116: ch116
+          120: ch120
+          124: ch124
+          128: ch128
+          132: ch132
+          136: ch136
+          140: ch140
+          149: ch149
+          153: ch153
+          157: ch157
+          161: ch161
+          165: ch165
+          169: ch169
+      - name: bsnAPIfDot11TransmittedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.1
+        type: counter
+        help: This counter shall be incremented for an acknowledged MPDU with an individual
+          address in the address 1 field or an MPDU with a multicast address in the address
+          1 field of type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.1
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastTransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.2
+        type: counter
+        help: This counter shall increment only when the multicast bit is set in the destination
+          MAC address of a successfully transmitted MSDU - 1.3.6.1.4.1.14179.2.2.6.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.3
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          one or more retransmissions. - 1.3.6.1.4.1.14179.2.2.6.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MultipleRetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.4
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          more than one retransmission. - 1.3.6.1.4.1.14179.2.2.6.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FrameDuplicateCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.5
+        type: counter
+        help: This counter shall increment when a frame is received that the Sequence
+          Control field indicates is a duplicate. - 1.3.6.1.4.1.14179.2.2.6.1.5
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSSuccessCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.6
+        type: counter
+        help: This counter shall increment when a CTS is received in response to an RTS.
+          - 1.3.6.1.4.1.14179.2.2.6.1.6
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.7
+        type: counter
+        help: This counter shall increment when a CTS is not received in response to an
+          RTS. - 1.3.6.1.4.1.14179.2.2.6.1.7
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ACKFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.8
+        type: counter
+        help: This counter shall increment when an ACK is not received when expected.
+          - 1.3.6.1.4.1.14179.2.2.6.1.8
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ReceivedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.9
+        type: counter
+        help: This counter shall be incremented for each successfully received MPDU of
+          type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.9
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastReceivedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.10
+        type: counter
+        help: This counter shall increment when a MSDU is received with the multicast
+          bit set in the destination MAC address. - 1.3.6.1.4.1.14179.2.2.6.1.10
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FCSErrorCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.11
+        type: counter
+        help: This counter shall increment when an FCS error is detected in a received
+          MPDU. - 1.3.6.1.4.1.14179.2.2.6.1.11
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11TransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.12
+        type: counter
+        help: This counter shall increment for each successfully transmitted MSDU. - 1.3.6.1.4.1.14179.2.2.6.1.12
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11WEPUndecryptableCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.13
+        type: counter
+        help: This counter shall increment when a frame is received with the WEP subfield
+          of the Frame Control field set to one and the WEPOn value for the key mapped
+          to the TA's MAC address indicates that the frame should not have been encrypted
+          or that frame is discarded due to the receiving STA not implementing the privacy
+          option. - 1.3.6.1.4.1.14179.2.2.6.1.13
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FailedCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.33
+        type: counter
+        help: This counter shall increment when an MSDU is not transmitted successfully
+          due to the number of transmit attempts exceeding either the bsnAPIfDot11ShortRetryLimit
+          or dot11LongRetryLimit. - 1.3.6.1.4.1.14179.2.2.6.1.33
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+    ddwrt:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.11
+      - 1.3.6.1.4.1.2021.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laIndex
+        oid: 1.3.6.1.4.1.2021.10.1.1
+        type: gauge
+        help: reference index/row number for each observed loadave. - 1.3.6.1.4.1.2021.10.1.1
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssIndex
+        oid: 1.3.6.1.4.1.2021.11.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.11.1
+      - name: ssErrorName
+        oid: 1.3.6.1.4.1.2021.11.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.11.2
+      - name: ssSwapIn
+        oid: 1.3.6.1.4.1.2021.11.3
+        type: gauge
+        help: The average amount of memory swapped in from disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.3
+      - name: ssSwapOut
+        oid: 1.3.6.1.4.1.2021.11.4
+        type: gauge
+        help: The average amount of memory swapped out to disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.4
+      - name: ssIOSent
+        oid: 1.3.6.1.4.1.2021.11.5
+        type: gauge
+        help: The average amount of data written to disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.5
+      - name: ssIOReceive
+        oid: 1.3.6.1.4.1.2021.11.6
+        type: gauge
+        help: The average amount of data read from disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.6
+      - name: ssSysInterrupts
+        oid: 1.3.6.1.4.1.2021.11.7
+        type: gauge
+        help: The average rate of interrupts processed (including the clock) calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.7
+      - name: ssSysContext
+        oid: 1.3.6.1.4.1.2021.11.8
+        type: gauge
+        help: The average rate of context switches, calculated over the last minute -
+          1.3.6.1.4.1.2021.11.8
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuRawUser
+        oid: 1.3.6.1.4.1.2021.11.50
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing user-level code
+          - 1.3.6.1.4.1.2021.11.50
+      - name: ssCpuRawNice
+        oid: 1.3.6.1.4.1.2021.11.51
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing reduced-priority
+          code - 1.3.6.1.4.1.2021.11.51
+      - name: ssCpuRawSystem
+        oid: 1.3.6.1.4.1.2021.11.52
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing system-level code
+          - 1.3.6.1.4.1.2021.11.52
+      - name: ssCpuRawIdle
+        oid: 1.3.6.1.4.1.2021.11.53
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent idle - 1.3.6.1.4.1.2021.11.53
+      - name: ssCpuRawWait
+        oid: 1.3.6.1.4.1.2021.11.54
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent waiting for IO - 1.3.6.1.4.1.2021.11.54
+      - name: ssCpuRawKernel
+        oid: 1.3.6.1.4.1.2021.11.55
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing kernel-level code
+          - 1.3.6.1.4.1.2021.11.55
+      - name: ssCpuRawInterrupt
+        oid: 1.3.6.1.4.1.2021.11.56
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing hardware interrupts
+          - 1.3.6.1.4.1.2021.11.56
+      - name: ssIORawSent
+        oid: 1.3.6.1.4.1.2021.11.57
+        type: counter
+        help: Number of blocks sent to a block device - 1.3.6.1.4.1.2021.11.57
+      - name: ssIORawReceived
+        oid: 1.3.6.1.4.1.2021.11.58
+        type: counter
+        help: Number of blocks received from a block device - 1.3.6.1.4.1.2021.11.58
+      - name: ssRawInterrupts
+        oid: 1.3.6.1.4.1.2021.11.59
+        type: counter
+        help: Number of interrupts processed - 1.3.6.1.4.1.2021.11.59
+      - name: ssRawContexts
+        oid: 1.3.6.1.4.1.2021.11.60
+        type: counter
+        help: Number of context switches - 1.3.6.1.4.1.2021.11.60
+      - name: ssCpuRawSoftIRQ
+        oid: 1.3.6.1.4.1.2021.11.61
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing software interrupts
+          - 1.3.6.1.4.1.2021.11.61
+      - name: ssRawSwapIn
+        oid: 1.3.6.1.4.1.2021.11.62
+        type: counter
+        help: Number of blocks swapped in - 1.3.6.1.4.1.2021.11.62
+      - name: ssRawSwapOut
+        oid: 1.3.6.1.4.1.2021.11.63
+        type: counter
+        help: Number of blocks swapped out - 1.3.6.1.4.1.2021.11.63
+      - name: ssCpuRawSteal
+        oid: 1.3.6.1.4.1.2021.11.64
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the hypervisor code to
+          run other VMs even though the CPU in the current VM had something runnable -
+          1.3.6.1.4.1.2021.11.64
+      - name: ssCpuRawGuest
+        oid: 1.3.6.1.4.1.2021.11.65
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a virtual
+          CPU (guest) - 1.3.6.1.4.1.2021.11.65
+      - name: ssCpuRawGuestNice
+        oid: 1.3.6.1.4.1.2021.11.66
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a niced
+          virtual CPU (guest) - 1.3.6.1.4.1.2021.11.66
+      - name: ssCpuNumCpus
+        oid: 1.3.6.1.4.1.2021.11.67
+        type: gauge
+        help: The number of processors, as counted by the agent - 1.3.6.1.4.1.2021.11.67
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+    if_mib:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+    infrapower_pdu:
+      walk:
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.1
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.6
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.7
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: pduMainLoadVoltage
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        type: DisplayString
+        help: The voltage measured on this PDU in tenth of Volts - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainLoadAmp
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        type: DisplayString
+        help: The current load measured on this PDU in tenth of Amps - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainActivePower
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        type: DisplayString
+        help: The active power consumption of this PDU in hundred-thousandth of kW - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: 0$1.$2
+            regex: ^(?:(\d*?)(\d{2}))$
+          - value: 0.0$1
+            regex: ^(?:^(\d))$
+    keepalived:
+      walk:
+      - 1.3.6.1.4.1.9586.100.5.2.1
+      - 1.3.6.1.4.1.9586.100.5.2.3
+      - 1.3.6.1.4.1.9586.100.5.3.1
+      - 1.3.6.1.4.1.9586.100.5.3.3
+      - 1.3.6.1.4.1.9586.100.5.3.4
+      metrics:
+      - name: vrrpSyncGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        type: gauge
+        help: Index of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        type: DisplayString
+        help: Name of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupState
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        type: gauge
+        help: Current state of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpSyncGroupSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        type: gauge
+        help: Will SMTP alert be sent for this synchronisation group? - 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        type: gauge
+        help: Will we execute notification script for this group? - 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupTrackingWeight
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        type: gauge
+        help: Allow differing tracking weights for sync group members - 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        type: gauge
+        help: Index of the VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: static
+      - name: vrrpInstanceName
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        type: DisplayString
+        help: Name of the VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVirtualRouterId
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        type: gauge
+        help: Virtual Router ID (VRID) for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        type: gauge
+        help: Current state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceInitialState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        type: gauge
+        help: Initial state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceWantedState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        type: gauge
+        help: State wanted by the operator for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceBasePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        type: gauge
+        help: Base priority (as defined in the configuration file) for this VRRP instance
+          - 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceEffectivePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        type: gauge
+        help: Effective priority for this VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVipsStatus
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        type: gauge
+        help: Are all VIP of this VRRP instance enabled? - 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: allSet
+          2: notAllSet
+      - name: vrrpInstancePrimaryInterface
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        type: DisplayString
+        help: Primary interface of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceTrackPrimaryIf
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        type: gauge
+        help: Do we track the status of the primary interface? - 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: tracked
+          2: notTracked
+      - name: vrrpInstanceAdvertisementsInt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        type: gauge
+        help: Delay in seconds between two VRRP advertisements and it is in centiseconds
+          between two VRRPV3 advertisements - 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstancePreempt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        type: gauge
+        help: Will a higher priority advertisement preempt a lower instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: preempt
+          2: noPreempt
+      - name: vrrpInstancePreemptDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        type: gauge
+        help: Delay after startup or lower priority advert received until preemption can
+          happen - 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceAuthType
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        type: gauge
+        help: VRRPv2 supports authentication method to authenticate other peers - 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: password
+          2: ah
+      - name: vrrpInstanceSyncGroup
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.18
+        type: DisplayString
+        help: Name of the synchronisation group this VRRP instance belongs, if any. -
+          1.3.6.1.4.1.9586.100.5.2.3.1.18
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceGarpDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        type: gauge
+        help: Delay to launch gratuitous ARP (GARP). - 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        type: gauge
+        help: Will SMTP alert be sent for this VRRP instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        type: gauge
+        help: Will we execute notification script for this instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceAccept
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        type: gauge
+        help: Accept allow the non-master owner to process the packets destined to VIP
+          and it is supported for only VRRPv3. - 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstancePromoteSecondaries
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        type: gauge
+        help: Set promote_secondaries on interface. - 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceUseLinkbeat
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        type: gauge
+        help: Use linkbeat for interface status. - 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceVrrpVersion
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        type: gauge
+        help: VRRP protocol version. - 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          2: vrrpv2
+          3: vrrpv3
+      - name: vrrpInstanceScriptDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        type: DisplayString
+        help: Script to execute when the instance is deleted on reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceNotifyDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        type: gauge
+        help: Send Deleted rather than Fault notifications if instance is deleted on config
+          reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        type: gauge
+        help: Index of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        type: DisplayString
+        help: Name of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        type: gauge
+        help: Index of the virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        type: gauge
+        help: Type of virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: fwmark
+          2: ip
+          3: group
+      - name: virtualServerNameOfGroup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.3
+        type: DisplayString
+        help: If the virtual is defined from a group, this is the name of the group. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerFwMark
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        type: gauge
+        help: If the virtual server is defined from a firewall mark, this is the value
+          of the mark - 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the address family
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: virtualServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        type: InetAddress
+        help: If the virtual server is defined from an IP address, this is the value of
+          the IP - 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the value of the port
+          to listen for requests - 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerProtocol
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        type: gauge
+        help: Which transport protocol should be used for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: tcp
+          2: udp
+          3: sctp
+          4: none
+      - name: virtualServerLoadBalancingAlgo
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        type: gauge
+        help: Which load balancing algorithm (or scheduler) should be used for this virtual
+          server. - 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: rr
+          2: wrr
+          3: lc
+          4: wlc
+          5: lblc
+          6: lblcr
+          7: dh
+          8: sh
+          9: sed
+          10: nq
+          11: fo
+          12: ovf
+          13: mh
+          99: unknown
+      - name: virtualServerLoadBalancingKind
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        type: gauge
+        help: Default forwarding method to use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: virtualServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        type: gauge
+        help: Current status of this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: virtualServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        type: DisplayString
+        help: Virtualhost of this server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersist
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        type: gauge
+        help: Is the virtual service persistence enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerPersistTimeout
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        type: gauge
+        help: If this virtual service is persistence, what is the timeout. - 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.15
+        type: OctetString
+        help: Netmask specifying the granularity of the IPv4 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHaSuspend
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        type: gauge
+        help: If set to true(1), checks will be suspended if the IP of the virtual server
+          is currently not set. - 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerOmega
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        type: gauge
+        help: Is omega mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerRealServersTotal
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        type: gauge
+        help: Total number of real servers for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRealServersUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        type: gauge
+        help: Real servers actually up for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        type: gauge
+        help: Quorum to get amond real servers to consider this virtual server up. - 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        type: gauge
+        help: Current status of the quorum for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: met
+          2: notMet
+          3: shutdown
+      - name: virtualServerQuorumUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        type: DisplayString
+        help: Command to execute when the quorum is met. - 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        type: DisplayString
+        help: Command to execute when the quorum is not met. - 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHysteresis
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        type: gauge
+        help: Hysteresis with respect to quorum count. - 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        type: gauge
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        type: counter
+        help: Total number of incoming bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        type: counter
+        help: Total number of outgoing bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        type: gauge
+        help: Current connection rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        type: gauge
+        help: Current in packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        type: gauge
+        help: Current out packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        type: gauge
+        help: Current incoming rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        type: gauge
+        help: Current outgoing rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerOPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        type: gauge
+        help: If set to true(1), One-Packet-Scheduling will be applied. - 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        type: counter
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity6
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.51
+        type: gauge
+        help: Netmask specifying the granularity of the IPv6 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHashed
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        type: gauge
+        help: If set to true(1), entries will be hashed. - 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        type: gauge
+        help: If set to true(1), SH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        type: gauge
+        help: If set to true(1), SH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSched3
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        type: gauge
+        help: If set to true(1), scheduler flag 3 set. - 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        type: gauge
+        help: What action is performed when the real servers are down - 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: virtualServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        type: gauge
+        help: Default number of seconds between retrying a checker ofter it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        type: gauge
+        help: Default wieght for each real server. - 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        type: gauge
+        help: Will SMTP alert be sent for this virtual server? - 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerMHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        type: gauge
+        help: If set to true(1), MH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerMHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        type: gauge
+        help: If set to true(1), MH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetrUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker ofter it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        type: gauge
+        help: Default forwarding tunnel type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: virtualServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        type: gauge
+        help: Default forwarding tunnel GUE port use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        type: gauge
+        help: Default forwarding tunnel checksum type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+      - name: realServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        type: gauge
+        help: Index of the real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.2
+        type: gauge
+        help: 'Type of real server: either a regular real server or a sorry server. -
+          1.3.6.1.4.1.9586.100.5.3.4.1.2'
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: regular
+          2: sorry
+      - name: realServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        type: gauge
+        help: Address family for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: realServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        type: InetAddress
+        help: IP address of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        type: gauge
+        help: Port of the service. - 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        type: gauge
+        help: Status of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: realServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        type: gauge
+        help: Weight of this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerUpperConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        type: gauge
+        help: Maximum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerLowerConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        type: gauge
+        help: Minimum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        type: gauge
+        help: What action is performed when this server is down - 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: realServerNotifyUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        type: DisplayString
+        help: Command to execute when this server becomes alive. - 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerNotifyDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        type: DisplayString
+        help: Command to execute when this server becomes dead. - 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerFailedChecks
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        type: gauge
+        help: How many failed checks for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        type: gauge
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsActiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        type: gauge
+        help: Current active connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInactiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        type: gauge
+        help: Current inactive connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsPersistentConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        type: gauge
+        help: Current persistent connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        type: counter
+        help: Total number of incoming bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        type: counter
+        help: Total number of outgoing bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        type: gauge
+        help: Current connection rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        type: gauge
+        help: Current in packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        type: gauge
+        help: Current out packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        type: gauge
+        help: Current incoming rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        type: gauge
+        help: Current outgoing rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        type: counter
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerForwardingMethod
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        type: gauge
+        help: Forwarding method to use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: realServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        type: DisplayString
+        help: Virtualhost of this real server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        type: gauge
+        help: Default number of seconds between retrying a checker after it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        type: gauge
+        help: Will SMTP alert be sent for this real server? - 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerDelayBeforeRetryUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker after it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        type: gauge
+        help: Forwarding tunnel type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: realServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        type: gauge
+        help: Forwarding tunnel GUE port use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        type: gauge
+        help: Forwarding tunnel checksum type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+    nec_ix:
+      walk:
+      - 1.3.6.1.4.1.119.2.3.84.11
+      - 1.3.6.1.4.1.119.2.3.84.12
+      - 1.3.6.1.4.1.119.2.3.84.13
+      - 1.3.6.1.4.1.119.2.3.84.2
+      - 1.3.6.1.4.1.119.2.3.84.3
+      - 1.3.6.1.4.1.119.2.3.84.6
+      - 1.3.6.1.4.1.119.2.3.84.7
+      - 1.3.6.1.4.1.119.2.3.84.8
+      - 1.3.6.1.4.1.119.2.3.84.9
+      metrics:
+      - name: picoMobileDeviceIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        type: gauge
+        help: The unique index for each Mobile module. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceVendorName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        type: DisplayString
+        help: The object of the vendor name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        type: DisplayString
+        help: The object of the device name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceProductID
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        type: DisplayString
+        help: The object of the product ID. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSoftwareVersion
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        type: DisplayString
+        help: The object of the software version. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalBar
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        type: gauge
+        help: The object of the signal bar. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalStrength
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7
+        type: gauge
+        help: 'The signal strength can be: unknown(-1) :signal strength is unknown out-range(0):signal
+          strength is 0 weak(1) :signal strength is 1 low(2) :signal strength is 2 high(3)
+          :signal strength is 3 - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          -1: unknown
+          0: out-range
+          1: weak
+          2: low
+          3: high
+      - name: picoMobileDeviceSignalQuality
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        type: DisplayString
+        help: The object of the signal quality. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalElapsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        type: gauge
+        help: The object of the elapsed time after signal acquiring. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceRadioInterface
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        type: DisplayString
+        help: The object of the radio interface. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceCarrier
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        type: DisplayString
+        help: The object of the carrier name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialerString
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        type: DisplayString
+        help: The object of the dialer string. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13
+        type: gauge
+        help: 'The dial status can be: disconnected(0):dial status is disconnected - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          0: disconnected
+          1: connect
+          2: cancel
+          3: connected
+          4: postprocess
+      - name: picoMobileDeviceInRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        type: gauge
+        help: The in-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceOutRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        type: gauge
+        help: The out-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceResetCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        type: gauge
+        help: The reset device statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoIPv4CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.1
+        type: gauge
+        help: The number of current IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.1
+      - name: picoIPv4CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.2
+        type: gauge
+        help: The peak value of IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.2
+      - name: picoIPv4CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.3
+        type: counter
+        help: The total count of created IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.3
+      - name: picoIPv4CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.4
+        type: counter
+        help: The total count of IPv4 cache overflow. - 1.3.6.1.4.1.119.2.3.84.12.1.4
+      - name: picoIPv4UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.1
+        type: gauge
+        help: The number of current IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.1
+      - name: picoIPv4UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.2
+        type: gauge
+        help: The peak value of IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.2
+      - name: picoIPv4UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.3
+        type: counter
+        help: The total count of created IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.3
+      - name: picoIPv4UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.4
+        type: counter
+        help: The total count of IPv4 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.12.2.4
+      - name: picoIPv6CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.1
+        type: gauge
+        help: The number of current IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.1
+      - name: picoIPv6CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.2
+        type: gauge
+        help: The peak value of IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.2
+      - name: picoIPv6CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.3
+        type: counter
+        help: The total count of created IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.3
+      - name: picoIPv6CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.4
+        type: counter
+        help: The total count of IPv6 cache overflow. - 1.3.6.1.4.1.119.2.3.84.13.1.4
+      - name: picoIPv6UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.1
+        type: gauge
+        help: The number of current IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.1
+      - name: picoIPv6UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.2
+        type: gauge
+        help: The peak value of IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.2
+      - name: picoIPv6UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.3
+        type: counter
+        help: The total count of created IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.3
+      - name: picoIPv6UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.4
+        type: counter
+        help: The total count of IPv6 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.13.2.4
+      - name: picoCelsius
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.1
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Celsius).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.1
+      - name: picoFahrenheit
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.2
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Fahrenheit).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.2
+      - name: picoVoltage
+        oid: 1.3.6.1.4.1.119.2.3.84.2.2
+        type: gauge
+        help: Indicates the observed voltage, in milli-volt (mV). - 1.3.6.1.4.1.119.2.3.84.2.2
+      - name: picoFanIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        type: gauge
+        help: Unique index for each fan module. - 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoFanStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        type: gauge
+        help: Status of a fan module - 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: failure
+      - name: picoFanRpm
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        type: gauge
+        help: Fan speed (Revolution Per Minutes) - 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoPowerSupplyIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        type: gauge
+        help: Unique index for each power supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+      - name: picoPowerSupplyType
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        type: gauge
+        help: Power supply module type. - 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: systemACPS
+          2: ieee802dot3af-PoE-ACPS
+      - name: picoPowerSupplyStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        type: gauge
+        help: Status of a Power Supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: normal
+          2: failure
+      - name: picoSchedRtUtl1Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.1
+        type: gauge
+        help: Indicates the observed system utilization for last 1 second, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.1
+      - name: picoSchedRtUtl5Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.2
+        type: gauge
+        help: Indicates the observed system utilization for last 5 seconds, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.2
+      - name: picoSchedRtUtl1Min
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.3
+        type: gauge
+        help: Indicates the observed system utilization for last 1 minute, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.3
+      - name: picoSchedRtUtl1Hour
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.4
+        type: gauge
+        help: Indicates the observed system utilization for last 1 hour, in percent (%).
+          - 1.3.6.1.4.1.119.2.3.84.2.5.4
+      - name: picoHeapSize
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.1
+        type: gauge
+        help: Indicates the observed total heap size, in bytes. - 1.3.6.1.4.1.119.2.3.84.2.6.1
+      - name: picoHeapUtil
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.2
+        type: gauge
+        help: Indicates the observed current heap utilization, in percent (%). - 1.3.6.1.4.1.119.2.3.84.2.6.2
+      - name: pipSecMibLevel
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+        type: gauge
+        help: The version of the IPsec MIB. - 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+      - name: pikeGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+        type: gauge
+        help: The number of currently active IPsec Phase-1 IKE Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+      - name: pikeGlobalInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+        type: counter
+        help: The total number of notifys received by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+      - name: pikeGlobalInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by all currently and
+          previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+      - name: pikeGlobalInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and found
+          to be contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+      - name: pikeGlobalInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and validated
+          but were rejected by the local policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+      - name: pikeGlobalInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by all currently and previously active and IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+      - name: pikeGlobalOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+        type: counter
+        help: The total number of notifys sent by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+      - name: pikeGlobalOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+      - name: pikeGlobalOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent and were flagged
+          by the peer to contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+      - name: pikeGlobalOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent, validated by
+          the peer but were rejected by the peer's policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+      - name: pikeGlobalOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+        type: counter
+        help: The total number of IPsec Phase-2 SA delete requests sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+      - name: pikeGlobalInitTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+      - name: pikeGlobalInitTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+      - name: pikeGlobalRespTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+      - name: pikeGlobalAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+        type: counter
+        help: The total number of authentications which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+      - name: pikeGlobalDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+        type: counter
+        help: The total number of decryptions which ended in failure by all current and
+          previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+      - name: pikeGlobalHashValidFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+        type: counter
+        help: The total number of hash validations which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+      - name: pikeGlobalRespTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+      - name: pikeGlobalInP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+        type: counter
+        help: The total number of ISAKMP security association delete requests received
+          by all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+      - name: pikeGlobalOutP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+        type: counter
+        help: The total number of ISAKMP security association delete requests sent by
+          all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+      - name: pikePeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        type: OctetString
+        help: The IP address of the local peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        type: OctetString
+        help: The IP address of the remote peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        type: gauge
+        help: The length of time that the peer association has existed in hundredths of
+          a second. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        type: gauge
+        help: The index of the active IPsec Phase-1 IKE Tunnel (pikeTunIndex in the pikeTunnelTable)
+          for this peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikeTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunSaRefreshThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        type: gauge
+        help: The security assoication refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+        type: gauge
+        help: The total number of currently active IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+      - name: pipSecGlobalInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+        type: counter
+        help: The total number of octets received by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+      - name: pipSecGlobalInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+        type: counter
+        help: The total number of packets received by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+      - name: pipSecGlobalInDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+        type: counter
+        help: The total number of packets dropped during receive processing by all current
+          and previous IPsec Phase-2 Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+      - name: pipSecGlobalInReplayDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+      - name: pipSecGlobalInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+        type: counter
+        help: The total number of inbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+      - name: pipSecGlobalInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+      - name: pipSecGlobalInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+        type: counter
+        help: The total number of inbound decryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+      - name: pipSecGlobalInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+      - name: pipSecGlobalOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+        type: counter
+        help: The total number of octets sent by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+      - name: pipSecGlobalOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+        type: counter
+        help: The total number of packets sent by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+      - name: pipSecGlobalOutDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+        type: counter
+        help: The total number of packets dropped during send processing by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+      - name: pipSecGlobalOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+        type: counter
+        help: The total number of outbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+      - name: pipSecGlobalOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+      - name: pipSecGlobalOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+        type: counter
+        help: The total number of outbound encryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+      - name: pipSecGlobalOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+      - name: pipSecGlobalNoSaFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+        type: counter
+        help: The total number of non-existent Security Assocication in failures which
+          occurred during processing of all current and previous IPsec Phase-2 Tunnels.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+      - name: pipSecTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        type: gauge
+        help: The index of the associated IPsec Phase-1 IKE Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelAlive
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        type: gauge
+        help: An indicator which specifies whether or not the IPsec Phase-1 IKE Tunnel
+          currently exists. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: pipSecTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeSizeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        type: gauge
+        help: The security association LifeSize refresh threshold in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeTimeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        type: gauge
+        help: The security association LifeTime refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunExpiredSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        type: counter
+        help: The total number of security associations which have expired. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunCurrentSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        type: gauge
+        help: The number of security associations which are currently active or expiring.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        type: gauge
+        help: The Path MTU that has been determined for this IPsec Phase-2 tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecSpiIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        type: gauge
+        help: The number of the SPI associated with the Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiDirection
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        type: gauge
+        help: The direction of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: in
+          2: out
+      - name: pipSecSpiValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        type: gauge
+        help: The value of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiProtocol
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        type: gauge
+        help: The protocol of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: ah
+          2: esp
+          3: ipcomp
+      - name: pipSecSpiStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        type: gauge
+        help: The status of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: expiring
+      - name: pikeTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-1 IKE Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: localFailure
+          9: checkPointReg
+      - name: pikeTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunHistDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunHistEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHistHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunHistAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-1 IKE
+          tunnel was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel was been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-2 Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: seqNumRollOver
+          9: checkPointReq
+      - name: pipSecTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        type: gauge
+        help: The index of the associated IPsec Phase-1 Tunnel (pikeTunIndex in the pikeTunnelTable).
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunHistEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunHistLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-2 Tunnel
+          was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        type: gauge
+        help: The Path MTU that was determined for this IPsec Phase-2 tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: picoExtIfInstalledSlot
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        type: gauge
+        help: The slot number in which the extension card was installed. - 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        type: gauge
+        help: A unique value for each extension card. - 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDescr
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        type: DisplayString
+        help: A textual string containing information about the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfUpperLayer
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        type: gauge
+        help: Index of interface to upper layers. - 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        type: gauge
+        help: The type of interface,, distinguished according to the physical/link protocol(s)
+          immediately `below' the network layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          6: ethernet-csmacd
+          62: fastEther
+      - name: picoExtIfSpeed
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second. - 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDuplex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        type: gauge
+        help: The current mode of this link. - 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: halfduplex
+          2: fullduplex
+      - name: picoExtIfEffectiveMtu
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        type: gauge
+        help: The size of the largest datagram which can be sent/received on the interface,
+          specified in octets. - 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfPhysicalAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        type: PhysAddress48
+        help: The interface's address at the protocol layer immediately `below' the network
+          layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfAdminStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        type: gauge
+        help: The desired state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfOperStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        type: gauge
+        help: The current operational state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfLastChange
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state. - 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoNetmonWatchgroupIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        type: gauge
+        help: Unique index for each Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupName
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        type: DisplayString
+        help: Netmon Watchgroup Name. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupSequenceNumber
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        type: gauge
+        help: Netmon Watchgroup sequence number. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        type: gauge
+        help: Status of a Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: stand
+          3: disable
+      - name: picoNetmonWatchgroupVarianceCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        type: gauge
+        help: Netmon Watchgroup variance statistics. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNgnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN is enabled. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2
+        type: gauge
+        help: 'The mode of the NGN service can be: standard(1) :NGN service is standard
+          - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: standard
+          2: numbergate
+      - name: picoNgnIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3
+        type: gauge
+        help: 'The type of the NGN interface can be: global(1) :NGN interface type is
+          global - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: global
+          2: private
+      - name: picoNgnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4
+        type: gauge
+        help: 'The state of the NGN SIP-UA register can be: notReady(1) :NGN service is
+          not Ready - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: notReady
+          2: initializing
+          3: registering
+          4: registered
+      - name: picoNgnSipServerIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        type: InetAddressIPv4
+        help: The object of the SIP server address. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnSipUri
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        type: DisplayString
+        help: The object of the SIP URI. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnUpTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        type: gauge
+        help: The time elapsed since registered. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnVpnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN binding is enabled.
+          - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2
+        type: gauge
+        help: 'The state of the NGN SIP-UA session can be: disconnected(1):SIP session
+          is disconnected - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2'
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connecting
+          3: connected
+      - name: picoNgnVpnPeerAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        type: DisplayString
+        help: The object of the NGN peer address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnBandwidth
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        type: gauge
+        help: The object of the NGN session bandwidth. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnUsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        type: gauge
+        help: The time elapsed since this connected NGN session. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        type: InetAddressIPv4
+        help: The object of the NGN session SBC address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcPort
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        type: gauge
+        help: The object of the NGN session SBC port. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+    paloalto_fw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.1
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.25.3
+      - 1.3.6.1.4.1.25461.2.1.2.1
+      - 1.3.6.1.4.1.25461.2.1.2.3
+      - 1.3.6.1.4.1.25461.2.1.2.5
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: gauge
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrSystemUptime
+        oid: 1.3.6.1.2.1.25.1.1
+        type: gauge
+        help: The amount of time since this host was last initialized - 1.3.6.1.2.1.25.1.1
+      - name: hrSystemDate
+        oid: 1.3.6.1.2.1.25.1.2
+        type: DateAndTime
+        help: The host's notion of the local date and time of day. - 1.3.6.1.2.1.25.1.2
+      - name: hrSystemInitialLoadDevice
+        oid: 1.3.6.1.2.1.25.1.3
+        type: gauge
+        help: The index of the hrDeviceEntry for the device from which this host is configured
+          to load its initial operating system configuration (i.e., which operating system
+          code and/or boot parameters) - 1.3.6.1.2.1.25.1.3
+      - name: hrSystemInitialLoadParameters
+        oid: 1.3.6.1.2.1.25.1.4
+        type: OctetString
+        help: This object contains the parameters (e.g - 1.3.6.1.2.1.25.1.4
+      - name: hrSystemNumUsers
+        oid: 1.3.6.1.2.1.25.1.5
+        type: gauge
+        help: The number of user sessions for which this host is storing state information
+          - 1.3.6.1.2.1.25.1.5
+      - name: hrSystemProcesses
+        oid: 1.3.6.1.2.1.25.1.6
+        type: gauge
+        help: The number of process contexts currently loaded or running on this system.
+          - 1.3.6.1.2.1.25.1.6
+      - name: hrSystemMaxProcesses
+        oid: 1.3.6.1.2.1.25.1.7
+        type: gauge
+        help: The maximum number of process contexts this system can support - 1.3.6.1.2.1.25.1.7
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrDeviceIndex
+        oid: 1.3.6.1.2.1.25.3.2.1.1
+        type: gauge
+        help: A unique value for each device contained by the host - 1.3.6.1.2.1.25.3.2.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceType
+        oid: 1.3.6.1.2.1.25.3.2.1.2
+        type: OctetString
+        help: An indication of the type of device - 1.3.6.1.2.1.25.3.2.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceDescr
+        oid: 1.3.6.1.2.1.25.3.2.1.3
+        type: DisplayString
+        help: A textual description of this device, including the device's manufacturer
+          and revision, and optionally, its serial number. - 1.3.6.1.2.1.25.3.2.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceID
+        oid: 1.3.6.1.2.1.25.3.2.1.4
+        type: OctetString
+        help: The product ID for this device. - 1.3.6.1.2.1.25.3.2.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceStatus
+        oid: 1.3.6.1.2.1.25.3.2.1.5
+        type: gauge
+        help: The current operational state of the device described by this row of the
+          table - 1.3.6.1.2.1.25.3.2.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: unknown
+          2: running
+          3: warning
+          4: testing
+          5: down
+      - name: hrDeviceErrors
+        oid: 1.3.6.1.2.1.25.3.2.1.6
+        type: counter
+        help: The number of errors detected on this device - 1.3.6.1.2.1.25.3.2.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorFrwID
+        oid: 1.3.6.1.2.1.25.3.3.1.1
+        type: OctetString
+        help: The product ID of the firmware associated with the processor. - 1.3.6.1.2.1.25.3.3.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrNetworkIfIndex
+        oid: 1.3.6.1.2.1.25.3.4.1.1
+        type: gauge
+        help: The value of ifIndex which corresponds to this network device - 1.3.6.1.2.1.25.3.4.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: gauge
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: hrPrinterDetectedErrorState
+        oid: 1.3.6.1.2.1.25.3.5.1.2
+        type: OctetString
+        help: This object represents any error conditions detected by the printer - 1.3.6.1.2.1.25.3.5.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDiskStorageAccess
+        oid: 1.3.6.1.2.1.25.3.6.1.1
+        type: gauge
+        help: An indication if this long-term storage device is readable and writable
+          or only readable - 1.3.6.1.2.1.25.3.6.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrDiskStorageMedia
+        oid: 1.3.6.1.2.1.25.3.6.1.2
+        type: gauge
+        help: An indication of the type of media used in this long- term storage device.
+          - 1.3.6.1.2.1.25.3.6.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: hardDisk
+          4: floppyDisk
+          5: opticalDiskROM
+          6: opticalDiskWORM
+          7: opticalDiskRW
+          8: ramDisk
+      - name: hrDiskStorageRemoveble
+        oid: 1.3.6.1.2.1.25.3.6.1.3
+        type: gauge
+        help: Denotes whether or not the disk media may be removed from the drive. - 1.3.6.1.2.1.25.3.6.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrDiskStorageCapacity
+        oid: 1.3.6.1.2.1.25.3.6.1.4
+        type: gauge
+        help: The total size for this long-term storage device - 1.3.6.1.2.1.25.3.6.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPartitionIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.1
+        type: gauge
+        help: A unique value for each partition on this long-term storage device - 1.3.6.1.2.1.25.3.7.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionLabel
+        oid: 1.3.6.1.2.1.25.3.7.1.2
+        type: OctetString
+        help: A textual description of this partition. - 1.3.6.1.2.1.25.3.7.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionID
+        oid: 1.3.6.1.2.1.25.3.7.1.3
+        type: OctetString
+        help: A descriptor which uniquely represents this partition to the responsible
+          operating system - 1.3.6.1.2.1.25.3.7.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionSize
+        oid: 1.3.6.1.2.1.25.3.7.1.4
+        type: gauge
+        help: The size of this partition. - 1.3.6.1.2.1.25.3.7.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionFSIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.5
+        type: gauge
+        help: The index of the file system mounted on this partition - 1.3.6.1.2.1.25.3.7.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrFSIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.1
+        type: gauge
+        help: A unique value for each file system local to this host - 1.3.6.1.2.1.25.3.8.1.1
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.2
+        type: OctetString
+        help: The path name of the root of this file system. - 1.3.6.1.2.1.25.3.8.1.2
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSRemoteMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.3
+        type: OctetString
+        help: A description of the name and/or address of the server that this file system
+          is mounted from - 1.3.6.1.2.1.25.3.8.1.3
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSType
+        oid: 1.3.6.1.2.1.25.3.8.1.4
+        type: OctetString
+        help: The value of this object identifies the type of this file system. - 1.3.6.1.2.1.25.3.8.1.4
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSAccess
+        oid: 1.3.6.1.2.1.25.3.8.1.5
+        type: gauge
+        help: An indication if this file system is logically configured by the operating
+          system to be readable and writable or only readable - 1.3.6.1.2.1.25.3.8.1.5
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrFSBootable
+        oid: 1.3.6.1.2.1.25.3.8.1.6
+        type: gauge
+        help: A flag indicating whether this file system is bootable. - 1.3.6.1.2.1.25.3.8.1.6
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrFSStorageIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.7
+        type: gauge
+        help: The index of the hrStorageEntry that represents information about this file
+          system - 1.3.6.1.2.1.25.3.8.1.7
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastFullBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.8
+        type: DateAndTime
+        help: The last date at which this complete file system was copied to another storage
+          device for backup - 1.3.6.1.2.1.25.3.8.1.8
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastPartialBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.9
+        type: DateAndTime
+        help: The last date at which a portion of this file system was copied to another
+          storage device for backup - 1.3.6.1.2.1.25.3.8.1.9
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: panAhoSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.1
+        type: counter
+        help: The total usage of software for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.1
+      - name: panDfaSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.2
+        type: counter
+        help: The total number of dfa match using software - 1.3.6.1.4.1.25461.2.1.2.1.19.2
+      - name: panFlowHostServiceAllow
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.3
+        type: counter
+        help: Device management session allowed - 1.3.6.1.4.1.25461.2.1.2.1.19.3
+      - name: panHaPathmonSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.4
+        type: counter
+        help: HA path-monitoring packets sent - 1.3.6.1.4.1.25461.2.1.2.1.19.4
+      - name: panAhoFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.5
+        type: counter
+        help: The total requests to FPGA for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.5
+      - name: panDfaFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.6
+        type: counter
+        help: The total requests to FPGA for DFA - 1.3.6.1.4.1.25461.2.1.2.1.19.6
+      - name: panFpgaPkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.7
+        type: counter
+        help: The packets held because of requests to FPGA - 1.3.6.1.4.1.25461.2.1.2.1.19.7
+      - name: panFlowDosAgMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+        type: counter
+        help: Session limit reached for aggregate profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+      - name: panFlowDosBlkNumEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+        type: counter
+        help: Number of entries in DOS block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+      - name: panFlowDosClMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+        type: counter
+        help: Session limit reached for classified profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+      - name: panFlowDosClSyncookieAckErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.4
+        type: counter
+        help: 'TCP SYN cookies: Invalid ACKs received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.4'
+      - name: panFlowDosClSyncookieAckRcv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.5
+        type: counter
+        help: 'TCP SYN cookies: ACKs to cookies received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.5'
+      - name: panFlowDosClSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.6
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.6'
+      - name: panFlowDosClSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.7
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, classified pro -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.7'
+      - name: panFlowDosClSyncookieSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.8
+        type: counter
+        help: 'TCP SYN cookies: cookies sent, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.8'
+      - name: panFlowMeterVsysThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.9
+        type: counter
+        help: 'Session metering: sessions throttled by vsys configuration - 1.3.6.1.4.1.25461.2.1.2.1.19.8.9'
+      - name: panFlowPolicyDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.10
+        type: counter
+        help: 'Session setup: denied by policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.10'
+      - name: panFlowPolicyNat
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.11
+        type: counter
+        help: 'Session setup: source NAT IP/port allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.8.11'
+      - name: panFlowScanDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.12
+        type: counter
+        help: 'Session setup: denied by scan detection - 1.3.6.1.4.1.25461.2.1.2.1.19.8.12'
+      - name: panFlowDosDropIpBlocked
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.13
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration by oth -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.13'
+      - name: panFlowDosRedIcmp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.14
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.14'
+      - name: panFlowDosRedIcmp6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.15
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmpv6'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.15'
+      - name: panFlowDosRedIp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.16
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''other-ip'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.16'
+      - name: panFlowDosRedTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.17
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''tcp-syn'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.17'
+      - name: panFlowDosRedUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.18
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''udp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.18'
+      - name: panFlowDosRuleAgBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.19
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.19'
+      - name: panFlowDosRuleAgRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.20
+        type: counter
+        help: 'Packets dropped: Activate aggregate RED threshold reached, random ear -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.20'
+      - name: panFlowDosRuleAgRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.21
+        type: counter
+        help: 'Packets dropped: Maximal aggregate RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.21'
+      - name: panFlowDosRuleDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.22
+        type: counter
+        help: 'Packets dropped: Denied action by DoS policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.22'
+      - name: panFlowDosRuleDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.23
+        type: counter
+        help: 'Packets dropped: Rate limited or IP blocked - 1.3.6.1.4.1.25461.2.1.2.1.19.8.23'
+      - name: panFlowDosRuleDropAggr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.24
+        type: counter
+        help: 'Packets dropped: due to aggregate rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.24'
+      - name: panFlowDosRuleDropClBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.25
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.25'
+      - name: panFlowDosRuleDropClRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.26
+        type: counter
+        help: 'Packets dropped: Activate classified RED threshold reached, random ea -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.26'
+      - name: panFlowDosRuleDropClRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.27
+        type: counter
+        help: 'Packets dropped: Maximal classified RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.27'
+      - name: panFlowDosRuleDropClassified
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.28
+        type: counter
+        help: 'Packets dropped: due to classified rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.28'
+      - name: panFlowDosSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.29
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.29'
+      - name: panFlowDosSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.30
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, aggregate prof -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.30'
+      - name: panFlowDosZoneRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.31
+        type: counter
+        help: 'Packets dropped: Activate zone RED threshold reached, random early dr -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.31'
+      - name: panFlowDosZoneRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.32
+        type: counter
+        help: 'Packets dropped: Maximal zone RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.32'
+      - name: panFlowDosBlkSwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+        type: counter
+        help: Number of entries in DOS Software block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+      - name: panFlowDosBlkHwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+        type: counter
+        help: Number of entries in DOS Hardware block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+      - name: panFlowDosSyncookieNotTcpSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN - 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+      - name: panFlowDosSyncookieNotTcpSynAck
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN-ACK - 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+      - name: panFlowDosPfIpspoof
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-spoof' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+      - name: panFlowDosPfIpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+      - name: panFlowDosPfPing0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-ping-zero-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+      - name: panFlowDosPfIcmpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+      - name: panFlowDosPfIcmplpkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-large-packet' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+      - name: panFlowDosPfIcmperr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-error' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+      - name: panFlowDosPfNoreplyttl
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-timeexceeded' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+      - name: panFlowDosPfNoreplyneedfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-needfrag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+      - name: panFlowDosPfStrictsource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-strict-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+      - name: panFlowDosPfLoosesource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-loose-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+      - name: panFlowDosPfTimestamp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-timestamp' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+      - name: panFlowDosPfRecordroute
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-record-route' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+      - name: panFlowDosPfSecurity
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-security' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+      - name: panFlowDosPfSatnetid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-stream-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+      - name: panFlowDosPfUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-unknown-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+      - name: panFlowDosPfBadoption
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-malformed-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+      - name: panFlowDosPfTcpoverlappingmismatch
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-overlapping-tcp-segment-mismatch'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+      - name: panFlowDosPfStrictip
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+        type: counter
+        help: Packets dropped:Zone protection option 'strict-ip-check' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+      - name: panFlowDosPfTcpsplithandshake
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-split-handshake' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+      - name: panFlowDosPfTcpsyndata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-syn-with-data' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+      - name: panFlowDosPfTcpsynackdata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-synack-with-data' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+      - name: panFlowDosIp6Route0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-0' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+      - name: panFlowDosIp6Route1
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-1' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+      - name: panFlowDosIp6Route3
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-3' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+      - name: panFlowDosIp6Route4to252
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-4-252' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+      - name: panFlowDosIp6Route253
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-253' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+      - name: panFlowDosIp6Route254
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-254' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+      - name: panFlowDosIp6Route255
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-255' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+      - name: panFlowDosIp6Ip4cmpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+        type: counter
+        help: Packets dropped:Zone protection option 'ipv4-compatible-address' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+      - name: panFlowDosIp6Acast
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+        type: counter
+        help: Packets dropped:Zone protection option 'anycast-source' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+      - name: panFlowDosIp6OptionsInvalidIPv6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+        type: counter
+        help: Packets dropped:Zone protection option 'options-invalid-ipv6-discard' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+      - name: panFlowDosIp6Icmpv6ErrorInvalid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+        type: counter
+        help: Packets dropped:Zone protection option 'icmpv6-too-big-small-mtu-discard'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+      - name: panFlowDosIp6NeedlessIpv6FragHdr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+        type: counter
+        help: Packets dropped:Zone protection option 'needless-fragment-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+      - name: panFlowDosIp6RsvdSet
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+        type: counter
+        help: Packets dropped:Zone protection option 'reserved-field-set-discard' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+      - name: panFlowDosIPv6ExtHdrHopByHop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+        type: counter
+        help: Packets dropped:Zone protection option 'hop-by-hop-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+      - name: panFlowDosip6IPv6ExtHdrRouting
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+      - name: panFlowDosIp6IPv6ExtHdrDestOpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+        type: counter
+        help: Packets dropped:Zone protection option 'dest-option-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+      - name: panFlowDosPbpDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+        type: counter
+        help: Packets dropped:Dropped by packet buffer protection RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+      - name: panFlowDosCurrSessIncrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+        type: counter
+        help: Unable to increment current session count on session create - 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+      - name: panFlowDosCurrSessDecrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+        type: counter
+        help: Unable to decrement current session count on session delete - 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+      - name: panFlowFwdL3TtlZero
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.1
+        type: counter
+        help: 'Packets dropped: IP TTL reaches zero - 1.3.6.1.4.1.25461.2.1.2.1.19.9.1'
+      - name: panFlowMeterHostThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.2
+        type: counter
+        help: 'Session metering: sessions throttled by management session threshold -
+          1.3.6.1.4.1.25461.2.1.2.1.19.9.2'
+      - name: panFlowHostServiceDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+        type: counter
+        help: Device management session denied - 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+      - name: panFlowHostServiceUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.4
+        type: counter
+        help: 'Session discarded: unknown application to control plane - 1.3.6.1.4.1.25461.2.1.2.1.19.9.4'
+      - name: panPktAllocFailure
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+        type: counter
+        help: Packet allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+      - name: panPktAllocFailureCos
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+        type: counter
+        help: Packet allocation error due to QoS control - 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+      - name: panSessionDiscard
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+        type: counter
+        help: Session set to discard by security policy check - 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+      - name: panFlowIpfragFragErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.1
+        type: counter
+        help: 'Packet dropped: IP fragmentation error - 1.3.6.1.4.1.25461.2.1.2.1.19.10.1'
+      - name: panFlowIpfragRecv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+        type: counter
+        help: IP fragments received - 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+      - name: panTcpAllocWqeFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+        type: counter
+        help: wqe allocation failure in tcp - 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+      - name: panTcpDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+        type: counter
+        help: session denied because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+      - name: panTcpDropOutOfWnd
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+        type: counter
+        help: out-of-window packets dropped - 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+      - name: panTcpDropPacket
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+        type: counter
+        help: packets dropped because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+      - name: panFlowActionClose
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+        type: counter
+        help: TCP sessions closed via injecting RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+      - name: panFlowActionReset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+        type: counter
+        help: TCP clients reset via responding RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+      - name: panFlowTcpNonSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+        type: counter
+        help: Non-SYN TCP packets without session match - 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+      - name: panTcpExceedSegLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+        type: counter
+        help: packets dropped due to the limitation on global tcp out-of-order pack -
+          1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+      - name: panFlowTciGreDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+        type: counter
+        help: Total GRE sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+      - name: panFlowTciGreDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+        type: counter
+        help: Total GRE sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+      - name: panFlowTciGreDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+        type: counter
+        help: Total unknown tunnel inspection packets in GRE tunnel [passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+      - name: panFlowTciIpsecDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+        type: counter
+        help: Total Ipsec sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+      - name: panFlowTciIpsecDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+        type: counter
+        help: Total IPSEC sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+      - name: panFlowTciIpsecDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+        type: counter
+        help: Total unknown tunnel inspection packets in IPSEC tunnel [passed|dropped]
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+      - name: panFlowTciGtpDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+        type: counter
+        help: Total GTP sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+      - name: panFlowTciGtpDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+        type: counter
+        help: Total GTP sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+      - name: panFlowTciGtpDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+        type: counter
+        help: Total unknown tunnel inspection packets in GTP tunnel[passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+      - name: panSysSwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.1
+        type: DisplayString
+        help: Full software version - 1.3.6.1.4.1.25461.2.1.2.1.1
+      - name: panSysHwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.2
+        type: DisplayString
+        help: Hardware version of the unit. - 1.3.6.1.4.1.25461.2.1.2.1.2
+      - name: panSysSerialNumber
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.3
+        type: DisplayString
+        help: The serial number of the unit - 1.3.6.1.4.1.25461.2.1.2.1.3
+      - name: panSysTimeZoneOffset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.4
+        type: gauge
+        help: The offset in seconds from UTC of the system's time zone - 1.3.6.1.4.1.25461.2.1.2.1.4
+      - name: panSysDaylightSaving
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.5
+        type: gauge
+        help: Whether daylight savings are in currently in effect for the system's time
+          zone. - 1.3.6.1.4.1.25461.2.1.2.1.5
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: panSysVpnClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.6
+        type: DisplayString
+        help: Currently installed VPN client package version - 1.3.6.1.4.1.25461.2.1.2.1.6
+      - name: panSysAppVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.7
+        type: DisplayString
+        help: Currently installed application definition version - 1.3.6.1.4.1.25461.2.1.2.1.7
+      - name: panSysAvVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.8
+        type: DisplayString
+        help: Currently installed antivirus version - 1.3.6.1.4.1.25461.2.1.2.1.8
+      - name: panSysThreatVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.9
+        type: DisplayString
+        help: Currently installed threat definition version - 1.3.6.1.4.1.25461.2.1.2.1.9
+      - name: panSysUrlFilteringVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.10
+        type: DisplayString
+        help: Currently installed URL filtering version - 1.3.6.1.4.1.25461.2.1.2.1.10
+      - name: panSysHAState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.11
+        type: DisplayString
+        help: Current high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.11
+      - name: panSysHAPeerState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.12
+        type: DisplayString
+        help: Current peer high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.12
+      - name: panSysHAMode
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.13
+        type: DisplayString
+        help: Current high-availability mode (disabled, active-passive, or active-active).
+          - 1.3.6.1.4.1.25461.2.1.2.1.13
+      - name: panSysUrlFilteringDatabase
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.14
+        type: DisplayString
+        help: Current installed URL filtering database (surfcontrol, brightcloud, etc)
+          - 1.3.6.1.4.1.25461.2.1.2.1.14
+      - name: panSysGlobalProtectClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.15
+        type: DisplayString
+        help: Currently installed global-protect client package version - 1.3.6.1.4.1.25461.2.1.2.1.15
+      - name: panSysOpswatDatafileVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.16
+        type: DisplayString
+        help: Currently installed opswat database version - 1.3.6.1.4.1.25461.2.1.2.1.16
+      - name: panSysWildfireVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.17
+        type: DisplayString
+        help: Currently installed wildfire content version - 1.3.6.1.4.1.25461.2.1.2.1.17
+      - name: panSysWildfirePrivateCloudVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.18
+        type: DisplayString
+        help: Currently installed wildfire private cloud content version - 1.3.6.1.4.1.25461.2.1.2.1.18
+      - name: panSysAppReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.20
+        type: DisplayString
+        help: Currently installed application definition release date - 1.3.6.1.4.1.25461.2.1.2.1.20
+      - name: panSysThreatReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.21
+        type: DisplayString
+        help: Currently installed threat release date - 1.3.6.1.4.1.25461.2.1.2.1.21
+      - name: panSysAvReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.22
+        type: DisplayString
+        help: Currently installed antivirus release date - 1.3.6.1.4.1.25461.2.1.2.1.22
+      - name: panSysWfReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.23
+        type: DisplayString
+        help: Currently installed WildFire release date - 1.3.6.1.4.1.25461.2.1.2.1.23
+      - name: panSessionUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.1
+        type: gauge
+        help: Session table utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.1
+      - name: panSessionMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.2
+        type: gauge
+        help: Total number of sessions supported. - 1.3.6.1.4.1.25461.2.1.2.3.2
+      - name: panSessionActive
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.3
+        type: gauge
+        help: Total number of active sessions. - 1.3.6.1.4.1.25461.2.1.2.3.3
+      - name: panSessionActiveTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.4
+        type: gauge
+        help: Total number of active TCP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.4
+      - name: panSessionActiveUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.5
+        type: gauge
+        help: Total number of active UDP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.5
+      - name: panSessionActiveICMP
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.6
+        type: gauge
+        help: Total number of active ICMP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.6
+      - name: panSessionActiveSslProxy
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.7
+        type: gauge
+        help: Total number of active SSL proxy sessions. - 1.3.6.1.4.1.25461.2.1.2.3.7
+      - name: panSessionSslProxyUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.8
+        type: gauge
+        help: SSL proxy Session utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.8
+      - name: panVsysId
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        type: gauge
+        help: Vsys id - 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        type: DisplayString
+        help: User assigned vsys name (empty string if not available) - 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysSessionUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        type: gauge
+        help: Vsys utilization percentage, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        type: gauge
+        help: Active sessions on this Vsys - 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysMaxSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        type: gauge
+        help: Max sessions on this Vsys, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        type: gauge
+        help: Number of active Tcp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        type: gauge
+        help: Number of active Udp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        type: gauge
+        help: Number of active Other IP Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panZoneName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        type: DisplayString
+        help: Zone name for the interface - 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        type: gauge
+        help: Number of active TCP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        type: gauge
+        help: Number of active UDP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        type: gauge
+        help: Number of active Other IP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifIndex
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        type: gauge
+        help: Index of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        type: DisplayString
+        help: Description (name) of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        type: gauge
+        help: Number of active TCP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        type: gauge
+        help: Number of active UDP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        type: gauge
+        help: Number of active Other IP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panGPGWUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.1
+        type: gauge
+        help: GlobalProtect Gateway utilization percentage - 1.3.6.1.4.1.25461.2.1.2.5.1.1
+      - name: panGPGWUtilizationMaxTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.2
+        type: gauge
+        help: Max tunnels allowed - 1.3.6.1.4.1.25461.2.1.2.5.1.2
+      - name: panGPGWUtilizationActiveTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.3
+        type: gauge
+        help: Number of active tunnels - 1.3.6.1.4.1.25461.2.1.2.5.1.3
+    printer_mib:
+      walk:
+      - 1.3.6.1.2.1.25.3.5.1.1
+      - 1.3.6.1.2.1.43.11.1.1.5
+      - 1.3.6.1.2.1.43.11.1.1.6
+      - 1.3.6.1.2.1.43.11.1.1.8
+      - 1.3.6.1.2.1.43.11.1.1.9
+      - 1.3.6.1.2.1.43.5.1.1.13
+      - 1.3.6.1.2.1.43.5.1.1.16
+      - 1.3.6.1.2.1.43.5.1.1.17
+      - 1.3.6.1.2.1.43.5.1.1.18
+      - 1.3.6.1.2.1.43.5.1.1.19
+      - 1.3.6.1.2.1.43.5.1.1.3
+      - 1.3.6.1.2.1.43.6.1.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: EnumAsStateSet
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: prtMarkerSuppliesType
+        oid: 1.3.6.1.2.1.43.11.1.1.5
+        type: gauge
+        help: The type of this supply. - 1.3.6.1.2.1.43.11.1.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: toner
+          4: wasteToner
+          5: ink
+          6: inkCartridge
+          7: inkRibbon
+          8: wasteInk
+          9: opc
+          10: developer
+          11: fuserOil
+          12: solidWax
+          13: ribbonWax
+          14: wasteWax
+          15: fuser
+          16: coronaWire
+          17: fuserOilWick
+          18: cleanerUnit
+          19: fuserCleaningPad
+          20: transferUnit
+          21: tonerCartridge
+          22: fuserOiler
+          23: water
+          24: wasteWater
+          25: glueWaterAdditive
+          26: wastePaper
+          27: bindingSupply
+          28: bandingSupply
+          29: stitchingWire
+          30: shrinkWrap
+          31: paperWrap
+          32: staples
+          33: inserts
+          34: covers
+          35: matteToner
+          36: matteInk
+      - name: prtMarkerSuppliesDescription
+        oid: 1.3.6.1.2.1.43.11.1.1.6
+        type: DisplayString
+        help: The description of this supply container/receptacle in the localization
+          specified by prtGeneralCurrentLocalization. - 1.3.6.1.2.1.43.11.1.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesMaxCapacity
+        oid: 1.3.6.1.2.1.43.11.1.1.8
+        type: gauge
+        help: The maximum capacity of this supply container/receptacle expressed in prtMarkerSuppliesSupplyUnit
+          - 1.3.6.1.2.1.43.11.1.1.8
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesLevel
+        oid: 1.3.6.1.2.1.43.11.1.1.9
+        type: gauge
+        help: The current level if this supply is a container; the remaining space if
+          this supply is a receptacle - 1.3.6.1.2.1.43.11.1.1.9
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtConsoleDisable
+        oid: 1.3.6.1.2.1.43.5.1.1.13
+        type: EnumAsStateSet
+        help: This value indicates how input is (or is not) accepted from the operator
+          console - 1.3.6.1.2.1.43.5.1.1.13
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: enabled
+          4: disabled
+      - name: prtGeneralPrinterName
+        oid: 1.3.6.1.2.1.43.5.1.1.16
+        type: DisplayString
+        help: An administrator-specified name for this printer - 1.3.6.1.2.1.43.5.1.1.16
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralSerialNumber
+        oid: 1.3.6.1.2.1.43.5.1.1.17
+        type: DisplayString
+        help: A recorded serial number for this device that indexes some type device catalog
+          or inventory - 1.3.6.1.2.1.43.5.1.1.17
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertCriticalEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.18
+        type: counter
+        help: A running counter of the number of critical alert events that have been
+          recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.18
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertAllEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.19
+        type: counter
+        help: A running counter of the total number of alert event entries (critical and
+          non-critical) that have been recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.19
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralReset
+        oid: 1.3.6.1.2.1.43.5.1.1.3
+        type: EnumAsStateSet
+        help: Setting this value to 'powerCycleReset', 'resetToNVRAM', or 'resetToFactoryDefaults'
+          will result in the resetting of the printer - 1.3.6.1.2.1.43.5.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: notResetting
+          4: powerCycleReset
+          5: resetToNVRAM
+          6: resetToFactoryDefaults
+      - name: prtCoverStatus
+        oid: 1.3.6.1.2.1.43.6.1.1.3
+        type: EnumAsStateSet
+        help: The status of this cover sub-unit. - 1.3.6.1.2.1.43.6.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtCoverIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: coverOpen
+          4: coverClosed
+          5: interlockOpen
+          6: interlockClosed
+    raritan:
+      walk:
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.2
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.13742.4.1.3.1.5.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: outletOperationalState
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        type: EnumAsStateSet
+        help: A value for each outlet which describes the operational state of the outlet
+          - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+        enum_values:
+          -1: error
+          0: "off"
+          1: "on"
+          2: cycling
+      - name: outletWattHours
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        type: gauge
+        help: The value of the cumulative active energy for this outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        type: gauge
+        help: A unique value for the current sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletMaxCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        type: gauge
+        help: A unique value for the max - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        type: gauge
+        help: A unique value for the voltage sensor attached to the outlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        type: gauge
+        help: A unique value for the active power sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: inletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        type: gauge
+        help: A unique value for the current sensor attached to the inlet - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        type: gauge
+        help: A unique value for the voltage sensor attached to the intlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        type: gauge
+        help: The active power for the inlet This value is reported in Watts. - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: unitCpuTemp
+        oid: 1.3.6.1.4.1.13742.4.1.3.1.5
+        type: gauge
+        help: The value for the unit's CPU temperature sensor in tenth degrees celsius.
+          - 1.3.6.1.4.1.13742.4.1.3.1.5
+      auth:
+        community: raritan_public
+    servertech_sentry3:
+      walk:
+      - 1.3.6.1.4.1.1718.3.2.2
+      - 1.3.6.1.4.1.1718.3.2.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: infeedIndex
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.1
+        type: gauge
+        help: Index for the input feed table. - 1.3.6.1.4.1.1718.3.2.2.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.2
+        type: DisplayString
+        help: The ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedName
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.3
+        type: DisplayString
+        help: The name of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.4
+        type: Bits
+        help: The capabilities of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: failSafe
+          4: defaultOff
+          5: voltageSense
+          6: powerSense
+          7: branchOnSense
+          8: branchLoadSense
+      - name: infeedStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.5
+        type: gauge
+        help: The status of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: infeedLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.6
+        type: gauge
+        help: The status of the load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: infeedLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.7
+        type: gauge
+        help: The load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.8
+        type: gauge
+        help: The load high threshold value of the input feed line in Amps. - 1.3.6.1.4.1.1718.3.2.2.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedOutletCount
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.9
+        type: gauge
+        help: The number of controlled and/or monitored outlets on the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.10
+        type: gauge
+        help: The load capacity of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.11
+        type: gauge
+        help: The line-to-line voltage of the input feed - 1.3.6.1.4.1.1718.3.2.2.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.12
+        type: gauge
+        help: The active power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.13
+        type: gauge
+        help: The apparent power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.14
+        type: gauge
+        help: The power factor of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.15
+        type: gauge
+        help: The crest factor for the load of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.16
+        type: gauge
+        help: The energy consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedReactance
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.17
+        type: gauge
+        help: The characterization of the phase relation between the voltage and current
+          of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: capacitive
+          2: inductive
+          3: resistive
+      - name: infeedPhaseVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.18
+        type: gauge
+        help: The voltage measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseCurrent
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.19
+        type: gauge
+        help: The current measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.21
+        type: DisplayString
+        help: The ID of the input feed line. - 1.3.6.1.4.1.1718.3.2.2.1.21
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineToLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.22
+        type: DisplayString
+        help: The line-to-line ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.22
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.23
+        type: DisplayString
+        help: The ID of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.23
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVACapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.24
+        type: gauge
+        help: The apparent power capacity of the input feed circuit - 1.3.6.1.4.1.1718.3.2.2.1.24
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: outletIndex
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.1
+        type: gauge
+        help: Index for the outlet table. - 1.3.6.1.4.1.1718.3.2.3.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletID
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.2
+        type: DisplayString
+        help: The ID of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletName
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.3
+        type: DisplayString
+        help: The name of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.4
+        type: Bits
+        help: The capabilities of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: shutdown
+          4: defaultOn
+          5: ownInfeed
+          6: fusedBranch
+          7: voltageSense
+          8: powerSense
+      - name: outletStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.5
+        type: gauge
+        help: The status of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: outletLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.6
+        type: gauge
+        help: The status of the load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: outletLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.7
+        type: gauge
+        help: The load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadLowThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.8
+        type: gauge
+        help: The load low threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.9
+        type: gauge
+        help: The load high threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletControlState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.10
+        type: gauge
+        help: The control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: idleOff
+          1: idleOn
+          2: wakeOff
+          3: wakeOn
+          4: "off"
+          5: "on"
+          6: lockedOff
+          7: lockedOn
+          8: reboot
+          9: shutdown
+          10: pendOn
+          11: pendOff
+          12: minimumOff
+          13: minimumOn
+          14: eventOff
+          15: eventOn
+          16: eventReboot
+          17: eventShutdown
+      - name: outletControlAction
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.11
+        type: gauge
+        help: An action to change the control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: "on"
+          2: "off"
+          3: reboot
+      - name: outletCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.12
+        type: gauge
+        help: The load capacity of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.13
+        type: gauge
+        help: The voltage of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.14
+        type: gauge
+        help: The active power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.15
+        type: gauge
+        help: The apparent power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.16
+        type: gauge
+        help: The power factor of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.17
+        type: gauge
+        help: The crest factor for the load of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.18
+        type: gauge
+        help: The energy consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletWakeupState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.19
+        type: gauge
+        help: The wakeup state of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          1: last
+          2: "off"
+          3: "on"
+      - name: outletPostOnDelay
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.20
+        type: gauge
+        help: The post-on delay of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.20
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+    synology:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.4
+      - 1.3.6.1.4.1.6574.1
+      - 1.3.6.1.4.1.6574.101
+      - 1.3.6.1.4.1.6574.102
+      - 1.3.6.1.4.1.6574.104
+      - 1.3.6.1.4.1.6574.2
+      - 1.3.6.1.4.1.6574.3
+      - 1.3.6.1.4.1.6574.4
+      - 1.3.6.1.4.1.6574.5
+      - 1.3.6.1.4.1.6574.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.2021.11.10.0
+      - 1.3.6.1.4.1.2021.11.11.0
+      - 1.3.6.1.4.1.2021.11.9.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+      - name: systemStatus
+        oid: 1.3.6.1.4.1.6574.1.1
+        type: gauge
+        help: Synology system status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.1
+      - name: temperature
+        oid: 1.3.6.1.4.1.6574.1.2
+        type: gauge
+        help: Synology system temperature The temperature of Disk Station uses Celsius
+          degree. - 1.3.6.1.4.1.6574.1.2
+      - name: powerStatus
+        oid: 1.3.6.1.4.1.6574.1.3
+        type: gauge
+        help: Synology power status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.3
+      - name: systemFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.1
+        type: gauge
+        help: Synology system fan status Each meanings of status represented describe
+          below - 1.3.6.1.4.1.6574.1.4.1
+      - name: cpuFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.2
+        type: gauge
+        help: Synology cpu fan status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.4.2
+      - name: modelName
+        oid: 1.3.6.1.4.1.6574.1.5.1
+        type: OctetString
+        help: The Model name of this NAS - 1.3.6.1.4.1.6574.1.5.1
+      - name: serialNumber
+        oid: 1.3.6.1.4.1.6574.1.5.2
+        type: OctetString
+        help: The serial number of this NAS - 1.3.6.1.4.1.6574.1.5.2
+      - name: version
+        oid: 1.3.6.1.4.1.6574.1.5.3
+        type: OctetString
+        help: The version of this DSM - 1.3.6.1.4.1.6574.1.5.3
+      - name: upgradeAvailable
+        oid: 1.3.6.1.4.1.6574.1.5.4
+        type: gauge
+        help: This oid is for checking whether there is a latest DSM can be upgraded -
+          1.3.6.1.4.1.6574.1.5.4
+      - name: storageIOIndex
+        oid: 1.3.6.1.4.1.6574.101.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.101.1.1.1
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIODevice
+        oid: 1.3.6.1.4.1.6574.101.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.101.1.1.2
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONRead
+        oid: 1.3.6.1.4.1.6574.101.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.3
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWritten
+        oid: 1.3.6.1.4.1.6574.101.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.4
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOReads
+        oid: 1.3.6.1.4.1.6574.101.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.5
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOWrites
+        oid: 1.3.6.1.4.1.6574.101.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.6
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA
+        oid: 1.3.6.1.4.1.6574.101.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.8
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA1
+        oid: 1.3.6.1.4.1.6574.101.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.9
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA5
+        oid: 1.3.6.1.4.1.6574.101.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.10
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA15
+        oid: 1.3.6.1.4.1.6574.101.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.11
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONReadX
+        oid: 1.3.6.1.4.1.6574.101.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.12
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWrittenX
+        oid: 1.3.6.1.4.1.6574.101.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.13
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: spaceIOIndex
+        oid: 1.3.6.1.4.1.6574.102.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.102.1.1.1
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIODevice
+        oid: 1.3.6.1.4.1.6574.102.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.102.1.1.2
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONRead
+        oid: 1.3.6.1.4.1.6574.102.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.3
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWritten
+        oid: 1.3.6.1.4.1.6574.102.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.4
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOReads
+        oid: 1.3.6.1.4.1.6574.102.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.5
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOWrites
+        oid: 1.3.6.1.4.1.6574.102.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.6
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA
+        oid: 1.3.6.1.4.1.6574.102.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.8
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA1
+        oid: 1.3.6.1.4.1.6574.102.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.9
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA5
+        oid: 1.3.6.1.4.1.6574.102.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.10
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA15
+        oid: 1.3.6.1.4.1.6574.102.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.11
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONReadX
+        oid: 1.3.6.1.4.1.6574.102.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.12
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWrittenX
+        oid: 1.3.6.1.4.1.6574.102.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.13
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: iSCSILUNInfoIndex
+        oid: 1.3.6.1.4.1.6574.104.1.1.1
+        type: gauge
+        help: LUN info index - 1.3.6.1.4.1.6574.104.1.1.1
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNUUID
+        oid: 1.3.6.1.4.1.6574.104.1.1.2
+        type: OctetString
+        help: LUN uuid - 1.3.6.1.4.1.6574.104.1.1.2
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNName
+        oid: 1.3.6.1.4.1.6574.104.1.1.3
+        type: OctetString
+        help: LUN name - 1.3.6.1.4.1.6574.104.1.1.3
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.4
+        type: gauge
+        help: LUN read throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.4
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.5
+        type: gauge
+        help: LUN read throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.5
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.6
+        type: gauge
+        help: LUN write throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.6
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.7
+        type: gauge
+        help: LUN write throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.7
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.8
+        type: gauge
+        help: LUN read iops - 1.3.6.1.4.1.6574.104.1.1.8
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.9
+        type: gauge
+        help: LUN write iops - 1.3.6.1.4.1.6574.104.1.1.9
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.10
+        type: gauge
+        help: LUN disk latency when reading - 1.3.6.1.4.1.6574.104.1.1.10
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.11
+        type: gauge
+        help: LUN disk latency when writing - 1.3.6.1.4.1.6574.104.1.1.11
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyTx
+        oid: 1.3.6.1.4.1.6574.104.1.1.12
+        type: gauge
+        help: LUN transfer data network latency - 1.3.6.1.4.1.6574.104.1.1.12
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyRx
+        oid: 1.3.6.1.4.1.6574.104.1.1.13
+        type: gauge
+        help: LUN receive data network latency - 1.3.6.1.4.1.6574.104.1.1.13
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.14
+        type: gauge
+        help: LUN average io size when reading - 1.3.6.1.4.1.6574.104.1.1.14
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.15
+        type: gauge
+        help: LUN average io size when writing - 1.3.6.1.4.1.6574.104.1.1.15
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNQueueDepth
+        oid: 1.3.6.1.4.1.6574.104.1.1.16
+        type: gauge
+        help: Num of iSCSI commands in LUN queue - 1.3.6.1.4.1.6574.104.1.1.16
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNType
+        oid: 1.3.6.1.4.1.6574.104.1.1.17
+        type: OctetString
+        help: LUN type - 1.3.6.1.4.1.6574.104.1.1.17
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: diskIndex
+        oid: 1.3.6.1.4.1.6574.2.1.1.1
+        type: gauge
+        help: The index of disk table - 1.3.6.1.4.1.6574.2.1.1.1
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskID
+        oid: 1.3.6.1.4.1.6574.2.1.1.2
+        type: OctetString
+        help: Synology disk ID The ID of disk is assigned by disk Station. - 1.3.6.1.4.1.6574.2.1.1.2
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskModel
+        oid: 1.3.6.1.4.1.6574.2.1.1.3
+        type: OctetString
+        help: Synology disk model name The disk model name will be showed here. - 1.3.6.1.4.1.6574.2.1.1.3
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskType
+        oid: 1.3.6.1.4.1.6574.2.1.1.4
+        type: OctetString
+        help: Synology disk type The type of disk will be showed here, including SATA,
+          SSD and so on. - 1.3.6.1.4.1.6574.2.1.1.4
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskStatus
+        oid: 1.3.6.1.4.1.6574.2.1.1.5
+        type: gauge
+        help: Synology disk status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.2.1.1.5
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskTemperature
+        oid: 1.3.6.1.4.1.6574.2.1.1.6
+        type: gauge
+        help: Synology disk temperature The temperature of each disk uses Celsius degree.
+          - 1.3.6.1.4.1.6574.2.1.1.6
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: raidIndex
+        oid: 1.3.6.1.4.1.6574.3.1.1.1
+        type: gauge
+        help: The index of raid table - 1.3.6.1.4.1.6574.3.1.1.1
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidName
+        oid: 1.3.6.1.4.1.6574.3.1.1.2
+        type: OctetString
+        help: Synology raid name The name of each raid will be showed here. - 1.3.6.1.4.1.6574.3.1.1.2
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidStatus
+        oid: 1.3.6.1.4.1.6574.3.1.1.3
+        type: gauge
+        help: Synology Raid status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.3.1.1.3
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidFreeSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.4
+        type: counter
+        help: Synology raid freesize Free space in bytes. - 1.3.6.1.4.1.6574.3.1.1.4
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidTotalSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.5
+        type: counter
+        help: Synology raid totalsize Total space in bytes. - 1.3.6.1.4.1.6574.3.1.1.5
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: upsDeviceModel
+        oid: 1.3.6.1.4.1.6574.4.1.1
+        type: DisplayString
+        help: Device model - 1.3.6.1.4.1.6574.4.1.1
+      - name: upsDeviceManufacturer
+        oid: 1.3.6.1.4.1.6574.4.1.2
+        type: DisplayString
+        help: Device manufacturer - 1.3.6.1.4.1.6574.4.1.2
+      - name: upsDeviceSerial
+        oid: 1.3.6.1.4.1.6574.4.1.3
+        type: DisplayString
+        help: Device serial number. - 1.3.6.1.4.1.6574.4.1.3
+      - name: upsDeviceType
+        oid: 1.3.6.1.4.1.6574.4.1.4
+        type: DisplayString
+        help: Device type (ups, pdu, scd, psu) - 1.3.6.1.4.1.6574.4.1.4
+      - name: upsDeviceDescription
+        oid: 1.3.6.1.4.1.6574.4.1.5
+        type: DisplayString
+        help: Device description. - 1.3.6.1.4.1.6574.4.1.5
+      - name: upsDeviceContact
+        oid: 1.3.6.1.4.1.6574.4.1.6
+        type: DisplayString
+        help: Device administrator name. - 1.3.6.1.4.1.6574.4.1.6
+      - name: upsDeviceLocation
+        oid: 1.3.6.1.4.1.6574.4.1.7
+        type: DisplayString
+        help: Device physical location. - 1.3.6.1.4.1.6574.4.1.7
+      - name: upsDevicePart
+        oid: 1.3.6.1.4.1.6574.4.1.8
+        type: DisplayString
+        help: Device part number. - 1.3.6.1.4.1.6574.4.1.8
+      - name: upsDeviceMACAddr
+        oid: 1.3.6.1.4.1.6574.4.1.9
+        type: DisplayString
+        help: Physical network address of the device. - 1.3.6.1.4.1.6574.4.1.9
+      - name: upsInfoStatus
+        oid: 1.3.6.1.4.1.6574.4.2.1
+        type: DisplayString
+        help: UPS status. - 1.3.6.1.4.1.6574.4.2.1
+      - name: upsInfoAlarm
+        oid: 1.3.6.1.4.1.6574.4.2.2
+        type: DisplayString
+        help: UPS alarms - 1.3.6.1.4.1.6574.4.2.2
+      - name: upsInfoTime
+        oid: 1.3.6.1.4.1.6574.4.2.3
+        type: DisplayString
+        help: Internal UPS clock time - 1.3.6.1.4.1.6574.4.2.3
+      - name: upsInfoDate
+        oid: 1.3.6.1.4.1.6574.4.2.4
+        type: DisplayString
+        help: Internal UPS clock date - 1.3.6.1.4.1.6574.4.2.4
+      - name: upsInfoModel
+        oid: 1.3.6.1.4.1.6574.4.2.5
+        type: DisplayString
+        help: UPS model - 1.3.6.1.4.1.6574.4.2.5
+      - name: upsInfoMfrName
+        oid: 1.3.6.1.4.1.6574.4.2.6.1
+        type: DisplayString
+        help: UPS manufacturer - 1.3.6.1.4.1.6574.4.2.6.1
+      - name: upsInfoMfrDate
+        oid: 1.3.6.1.4.1.6574.4.2.6.2
+        type: DisplayString
+        help: UPS manufacturing date - 1.3.6.1.4.1.6574.4.2.6.2
+      - name: upsInfoSerial
+        oid: 1.3.6.1.4.1.6574.4.2.7
+        type: DisplayString
+        help: UPS serial number - 1.3.6.1.4.1.6574.4.2.7
+      - name: upsInfoVendorID
+        oid: 1.3.6.1.4.1.6574.4.2.8
+        type: DisplayString
+        help: Vendor ID for USB devices - 1.3.6.1.4.1.6574.4.2.8
+      - name: upsInfoProductID
+        oid: 1.3.6.1.4.1.6574.4.2.9
+        type: DisplayString
+        help: Product ID for USB devices - 1.3.6.1.4.1.6574.4.2.9
+      - name: upsInfoFirmwareName
+        oid: 1.3.6.1.4.1.6574.4.2.10.1
+        type: DisplayString
+        help: UPS firmware - 1.3.6.1.4.1.6574.4.2.10.1
+      - name: upsInfoFirmwareAux
+        oid: 1.3.6.1.4.1.6574.4.2.10.2
+        type: DisplayString
+        help: Auxiliary device firmware - 1.3.6.1.4.1.6574.4.2.10.2
+      - name: upsInfoTemperature
+        oid: 1.3.6.1.4.1.6574.4.2.11
+        type: Float
+        help: UPS temperature (degrees C) - 1.3.6.1.4.1.6574.4.2.11
+      - name: upsInfoLoadValue
+        oid: 1.3.6.1.4.1.6574.4.2.12.1
+        type: Float
+        help: Load on UPS (percent) - 1.3.6.1.4.1.6574.4.2.12.1
+      - name: upsInfoLoadHigh
+        oid: 1.3.6.1.4.1.6574.4.2.12.2
+        type: Float
+        help: Load when UPS switches to overload condition (OVER) (percent) - 1.3.6.1.4.1.6574.4.2.12.2
+      - name: upsInfoID
+        oid: 1.3.6.1.4.1.6574.4.2.13
+        type: DisplayString
+        help: UPS system identifier - 1.3.6.1.4.1.6574.4.2.13
+      - name: upsInfoDelayStart
+        oid: 1.3.6.1.4.1.6574.4.2.14.1
+        type: gauge
+        help: Interval to wait before restarting the load (seconds) - 1.3.6.1.4.1.6574.4.2.14.1
+      - name: upsInfoDelayReboot
+        oid: 1.3.6.1.4.1.6574.4.2.14.2
+        type: gauge
+        help: Interval to wait before rebooting the UPS (seconds) - 1.3.6.1.4.1.6574.4.2.14.2
+      - name: upsInfoDelayShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.14.3
+        type: gauge
+        help: Interval to wait after shutdown with delay command (seconds) - 1.3.6.1.4.1.6574.4.2.14.3
+      - name: upsInfoTimerStart
+        oid: 1.3.6.1.4.1.6574.4.2.15.1
+        type: gauge
+        help: Time before the load will be started (seconds) - 1.3.6.1.4.1.6574.4.2.15.1
+      - name: upsInfoTimerReboot
+        oid: 1.3.6.1.4.1.6574.4.2.15.2
+        type: gauge
+        help: Time before the load will be rebooted (seconds) - 1.3.6.1.4.1.6574.4.2.15.2
+      - name: upsInfoTimerShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.15.3
+        type: gauge
+        help: Time before the load will be shutdown (seconds) - 1.3.6.1.4.1.6574.4.2.15.3
+      - name: upsInfoTestInterval
+        oid: 1.3.6.1.4.1.6574.4.2.16.1
+        type: gauge
+        help: Interval between self tests - 1.3.6.1.4.1.6574.4.2.16.1
+      - name: upsInfoTestResult
+        oid: 1.3.6.1.4.1.6574.4.2.16.2
+        type: DisplayString
+        help: Results of last self test - 1.3.6.1.4.1.6574.4.2.16.2
+      - name: upsInfoDisplayLanguage
+        oid: 1.3.6.1.4.1.6574.4.2.17
+        type: DisplayString
+        help: Language to use on front panel - 1.3.6.1.4.1.6574.4.2.17
+      - name: upsInfoContacts
+        oid: 1.3.6.1.4.1.6574.4.2.18
+        type: DisplayString
+        help: UPS external contact sensors - 1.3.6.1.4.1.6574.4.2.18
+      - name: upsInfoEffciency
+        oid: 1.3.6.1.4.1.6574.4.2.19
+        type: gauge
+        help: Efficiency of the UPS (ratio of the output current on the input current)
+          (percent) - 1.3.6.1.4.1.6574.4.2.19
+      - name: upsInfoPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.20.1
+        type: Float
+        help: Current value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.1
+      - name: upsInfoPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.20.2
+        type: Float
+        help: Nominal value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.2
+      - name: upsInfoRealPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.21.1
+        type: Float
+        help: Current value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.1
+      - name: upsInfoRealPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.21.2
+        type: Float
+        help: Nominal value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.2
+      - name: upsInfoBeeperStatus
+        oid: 1.3.6.1.4.1.6574.4.2.22
+        type: DisplayString
+        help: UPS beeper status (enabled, disabled or muted) - 1.3.6.1.4.1.6574.4.2.22
+      - name: upsInfoType
+        oid: 1.3.6.1.4.1.6574.4.2.23
+        type: DisplayString
+        help: UPS type - 1.3.6.1.4.1.6574.4.2.23
+      - name: upsInfoWatchdogStatus
+        oid: 1.3.6.1.4.1.6574.4.2.24
+        type: DisplayString
+        help: UPS watchdog status (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.24
+      - name: upsInfoStartAuto
+        oid: 1.3.6.1.4.1.6574.4.2.25.1
+        type: DisplayString
+        help: UPS starts when mains is (re)applied - 1.3.6.1.4.1.6574.4.2.25.1
+      - name: upsInfoStartBattery
+        oid: 1.3.6.1.4.1.6574.4.2.25.2
+        type: DisplayString
+        help: Allow to start UPS from battery - 1.3.6.1.4.1.6574.4.2.25.2
+      - name: upsInfoStartReboot
+        oid: 1.3.6.1.4.1.6574.4.2.25.3
+        type: DisplayString
+        help: UPS coldstarts from battery (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.25.3
+      - name: upsBatteryChargeValue
+        oid: 1.3.6.1.4.1.6574.4.3.1.1
+        type: Float
+        help: Battery charge - 1.3.6.1.4.1.6574.4.3.1.1
+      - name: upsBatteryChargeLow
+        oid: 1.3.6.1.4.1.6574.4.3.1.2
+        type: Float
+        help: Remaining battery level when UPS switches to LB (percent) - 1.3.6.1.4.1.6574.4.3.1.2
+      - name: upsBatteryChargeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.1.3
+        type: Float
+        help: Minimum battery level for UPS restart after power-off - 1.3.6.1.4.1.6574.4.3.1.3
+      - name: upsBatteryChargeWarning
+        oid: 1.3.6.1.4.1.6574.4.3.1.4
+        type: Float
+        help: Battery level when UPS switches to Warning state (percent) - 1.3.6.1.4.1.6574.4.3.1.4
+      - name: upsBatteryVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.3.2.1
+        type: Float
+        help: The magnitude of the present battery voltage. - 1.3.6.1.4.1.6574.4.3.2.1
+      - name: upsBatteryVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.3.2.2
+        type: Float
+        help: Nominal battery voltage. - 1.3.6.1.4.1.6574.4.3.2.2
+      - name: upsBatteryVoltageLow
+        oid: 1.3.6.1.4.1.6574.4.3.2.3
+        type: Float
+        help: Minimum battery voltage, that triggers FSD status . - 1.3.6.1.4.1.6574.4.3.2.3
+      - name: upsBatteryVoltageHigh
+        oid: 1.3.6.1.4.1.6574.4.3.2.4
+        type: Float
+        help: Maximum battery voltage (Ie battery.charge = 100). - 1.3.6.1.4.1.6574.4.3.2.4
+      - name: upsBatteryCapacity
+        oid: 1.3.6.1.4.1.6574.4.3.3
+        type: Float
+        help: Battery capacity (Ah) - 1.3.6.1.4.1.6574.4.3.3
+      - name: upsBatteryCurrent
+        oid: 1.3.6.1.4.1.6574.4.3.4
+        type: Float
+        help: The present battery current. - 1.3.6.1.4.1.6574.4.3.4
+      - name: upsBatteryTemperature
+        oid: 1.3.6.1.4.1.6574.4.3.5
+        type: Float
+        help: The ambient temperature at or near the UPS Battery casing. - 1.3.6.1.4.1.6574.4.3.5
+      - name: upsBatteryRuntimeValue
+        oid: 1.3.6.1.4.1.6574.4.3.6.1
+        type: gauge
+        help: Battery runtime (seconds) - 1.3.6.1.4.1.6574.4.3.6.1
+      - name: upsBatteryRuntimeLow
+        oid: 1.3.6.1.4.1.6574.4.3.6.2
+        type: gauge
+        help: Remaining battery runtime when UPS switches to LB (seconds) - 1.3.6.1.4.1.6574.4.3.6.2
+      - name: upsBatteryRuntimeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.6.3
+        type: gauge
+        help: Minimum battery runtime for UPS restart after power-off (seconds) - 1.3.6.1.4.1.6574.4.3.6.3
+      - name: upsBatteryAlarmThreshold
+        oid: 1.3.6.1.4.1.6574.4.3.7
+        type: DisplayString
+        help: Battery alarm threshold - 1.3.6.1.4.1.6574.4.3.7
+      - name: upsBatteryDate
+        oid: 1.3.6.1.4.1.6574.4.3.8
+        type: DisplayString
+        help: Battery change date - 1.3.6.1.4.1.6574.4.3.8
+      - name: upsBatteryMfrDate
+        oid: 1.3.6.1.4.1.6574.4.3.9
+        type: DisplayString
+        help: Battery manufacturing date - 1.3.6.1.4.1.6574.4.3.9
+      - name: upsBatteryPacks
+        oid: 1.3.6.1.4.1.6574.4.3.10
+        type: gauge
+        help: Number of battery packs - 1.3.6.1.4.1.6574.4.3.10
+      - name: upsBatteryPacksBad
+        oid: 1.3.6.1.4.1.6574.4.3.11
+        type: gauge
+        help: Number of bad battery packs - 1.3.6.1.4.1.6574.4.3.11
+      - name: upsBatteryType
+        oid: 1.3.6.1.4.1.6574.4.3.12
+        type: DisplayString
+        help: Battery chemistry - 1.3.6.1.4.1.6574.4.3.12
+      - name: upsBatteryProtection
+        oid: 1.3.6.1.4.1.6574.4.3.13
+        type: DisplayString
+        help: Prevent deep discharge of battery - 1.3.6.1.4.1.6574.4.3.13
+      - name: upsBatteryEnergySave
+        oid: 1.3.6.1.4.1.6574.4.3.14
+        type: DisplayString
+        help: Switch off when running on battery and no/low load - 1.3.6.1.4.1.6574.4.3.14
+      - name: upsInputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.4.1.1
+        type: Float
+        help: Input voltage - 1.3.6.1.4.1.6574.4.4.1.1
+      - name: upsInputVoltageMax
+        oid: 1.3.6.1.4.1.6574.4.4.1.2
+        type: Float
+        help: Maximum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.2
+      - name: upsInputVoltageMin
+        oid: 1.3.6.1.4.1.6574.4.4.1.3
+        type: Float
+        help: Minimum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.3
+      - name: upsInputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.4.1.4
+        type: Float
+        help: Nominal input voltage - 1.3.6.1.4.1.6574.4.4.1.4
+      - name: upsInputVoltageExtend
+        oid: 1.3.6.1.4.1.6574.4.4.1.5
+        type: DisplayString
+        help: Extended input voltage range - 1.3.6.1.4.1.6574.4.4.1.5
+      - name: upsInputVoltageFault
+        oid: 1.3.6.1.4.1.6574.4.4.1.6
+        type: Float
+        help: Input voltage Fault - 1.3.6.1.4.1.6574.4.4.1.6
+      - name: upsInputTransferReason
+        oid: 1.3.6.1.4.1.6574.4.4.2.1
+        type: DisplayString
+        help: Reason for last transfer to battery - 1.3.6.1.4.1.6574.4.4.2.1
+      - name: upsInputTransferLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.2
+        type: Float
+        help: Low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.2
+      - name: upsInputTransferHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.3
+        type: Float
+        help: High voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.3
+      - name: upsInputTransferLowMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.4
+        type: Float
+        help: smallest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.4
+      - name: upsInputTransferLowMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.5
+        type: Float
+        help: greatest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.5
+      - name: upsInputTransferHighMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.6
+        type: Float
+        help: smallest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.6
+      - name: upsInputTransferHighMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.7
+        type: Float
+        help: greatest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.7
+      - name: upsInputTransferBoostLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.8
+        type: Float
+        help: Low voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.8
+      - name: upsInputTransferBoostHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.9
+        type: Float
+        help: High voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.9
+      - name: upsInputTransferTrimLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.10
+        type: Float
+        help: Low voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.10
+      - name: upsInputTransferTrimHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.11
+        type: Float
+        help: High voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.11
+      - name: upsInputSensitivity
+        oid: 1.3.6.1.4.1.6574.4.4.3
+        type: DisplayString
+        help: Input power sensitivity - 1.3.6.1.4.1.6574.4.4.3
+      - name: upsInputQuality
+        oid: 1.3.6.1.4.1.6574.4.4.4
+        type: DisplayString
+        help: Input power quality - 1.3.6.1.4.1.6574.4.4.4
+      - name: upsInputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.4.5.1
+        type: Float
+        help: Input current (A) - 1.3.6.1.4.1.6574.4.4.5.1
+      - name: upsInputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.4.5.2
+        type: Float
+        help: Nominal input current (A) - 1.3.6.1.4.1.6574.4.4.5.2
+      - name: upsInputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.4.6.1
+        type: Float
+        help: Input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.1
+      - name: upsInputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.4.6.2
+        type: Float
+        help: Nominal input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.2
+      - name: upsInputFrequencyLow
+        oid: 1.3.6.1.4.1.6574.4.4.6.3
+        type: Float
+        help: Input line frequency low (Hz) - 1.3.6.1.4.1.6574.4.4.6.3
+      - name: upsInputFrequencyHigh
+        oid: 1.3.6.1.4.1.6574.4.4.6.4
+        type: Float
+        help: Input line frequency high (Hz) - 1.3.6.1.4.1.6574.4.4.6.4
+      - name: upsInputFrequencyExtend
+        oid: 1.3.6.1.4.1.6574.4.4.6.5
+        type: DisplayString
+        help: Extended input frequency range - 1.3.6.1.4.1.6574.4.4.6.5
+      - name: upsOutputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.5.1.1
+        type: Float
+        help: Output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.1
+      - name: upsOutputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.5.1.2
+        type: Float
+        help: Nominal output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.2
+      - name: upsOutputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.5.2.1
+        type: Float
+        help: Output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.1
+      - name: upsOutputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.5.2.2
+        type: Float
+        help: Nominal output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.2
+      - name: upsOutputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.5.3.1
+        type: Float
+        help: Output current (A) - 1.3.6.1.4.1.6574.4.5.3.1
+      - name: upsOutputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.5.3.2
+        type: Float
+        help: Nominal output current (A) - 1.3.6.1.4.1.6574.4.5.3.2
+      - name: upsAmbientTemperatureValue
+        oid: 1.3.6.1.4.1.6574.4.6.1.1
+        type: Float
+        help: Ambient temperature (degrees C) - 1.3.6.1.4.1.6574.4.6.1.1
+      - name: upsAmbientTemperatureAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.1.2
+        type: DisplayString
+        help: Temperature alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.1.2
+      - name: upsAmbientTemperatureHigh
+        oid: 1.3.6.1.4.1.6574.4.6.1.3
+        type: Float
+        help: Temperature threshold high (degrees C) - 1.3.6.1.4.1.6574.4.6.1.3
+      - name: upsAmbientTemperatureLow
+        oid: 1.3.6.1.4.1.6574.4.6.1.4
+        type: Float
+        help: Temperature threshold low (degrees C) - 1.3.6.1.4.1.6574.4.6.1.4
+      - name: upsAmbientTemperatureMax
+        oid: 1.3.6.1.4.1.6574.4.6.1.5
+        type: Float
+        help: Maximum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.5
+      - name: upsAmbientTemperatureMin
+        oid: 1.3.6.1.4.1.6574.4.6.1.6
+        type: Float
+        help: Minimum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.6
+      - name: upsAmbientHumidityValue
+        oid: 1.3.6.1.4.1.6574.4.6.2.1
+        type: Float
+        help: Ambient relative humidity (percent) - 1.3.6.1.4.1.6574.4.6.2.1
+      - name: upsAmbientHumidityAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.2.2
+        type: DisplayString
+        help: Relative humidity alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.2.2
+      - name: upsAmbientHumidityHigh
+        oid: 1.3.6.1.4.1.6574.4.6.2.3
+        type: Float
+        help: Relative humidity threshold high (percent) - 1.3.6.1.4.1.6574.4.6.2.3
+      - name: upsAmbientHumidityLow
+        oid: 1.3.6.1.4.1.6574.4.6.2.4
+        type: Float
+        help: Relative humidity threshold low (percent) - 1.3.6.1.4.1.6574.4.6.2.4
+      - name: upsAmbientHumidityMax
+        oid: 1.3.6.1.4.1.6574.4.6.2.5
+        type: Float
+        help: Maximum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.5
+      - name: upsAmbientHumidityMin
+        oid: 1.3.6.1.4.1.6574.4.6.2.6
+        type: Float
+        help: Minimum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.6
+      - name: upsDriverName
+        oid: 1.3.6.1.4.1.6574.4.7.1
+        type: DisplayString
+        help: Driver name - 1.3.6.1.4.1.6574.4.7.1
+      - name: upsDriverVersion
+        oid: 1.3.6.1.4.1.6574.4.7.2
+        type: DisplayString
+        help: Driver version (NUT release) - 1.3.6.1.4.1.6574.4.7.2
+      - name: upsDriverVersionData
+        oid: 1.3.6.1.4.1.6574.4.7.3
+        type: DisplayString
+        help: Driver version data - 1.3.6.1.4.1.6574.4.7.3
+      - name: upsDriverVersionInternal
+        oid: 1.3.6.1.4.1.6574.4.7.4
+        type: DisplayString
+        help: Internal driver version (if tracked separately) - 1.3.6.1.4.1.6574.4.7.4
+      - name: upsDriverPollInterval
+        oid: 1.3.6.1.4.1.6574.4.7.5
+        type: gauge
+        help: Poll interval setup in configuration file - 1.3.6.1.4.1.6574.4.7.5
+      - name: upsDriverPort
+        oid: 1.3.6.1.4.1.6574.4.7.6
+        type: DisplayString
+        help: Port setup in configuration file - 1.3.6.1.4.1.6574.4.7.6
+      - name: upsDriverPollFrequency
+        oid: 1.3.6.1.4.1.6574.4.7.7
+        type: gauge
+        help: Poll frequency - 1.3.6.1.4.1.6574.4.7.7
+      - name: upsDriverProductID
+        oid: 1.3.6.1.4.1.6574.4.7.8
+        type: DisplayString
+        help: Product ID - 1.3.6.1.4.1.6574.4.7.8
+      - name: upsDriverSnmpVersion
+        oid: 1.3.6.1.4.1.6574.4.7.9
+        type: DisplayString
+        help: Snmp version - 1.3.6.1.4.1.6574.4.7.9
+      - name: upsServerInfo
+        oid: 1.3.6.1.4.1.6574.4.8.1
+        type: DisplayString
+        help: Server information - 1.3.6.1.4.1.6574.4.8.1
+      - name: upsServerVersion
+        oid: 1.3.6.1.4.1.6574.4.8.2
+        type: DisplayString
+        help: Server version - 1.3.6.1.4.1.6574.4.8.2
+      - name: diskSMARTInfoIndex
+        oid: 1.3.6.1.4.1.6574.5.1.1.1
+        type: gauge
+        help: SMART info index - 1.3.6.1.4.1.6574.5.1.1.1
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTInfoDevName
+        oid: 1.3.6.1.4.1.6574.5.1.1.2
+        type: OctetString
+        help: SMART info device name - 1.3.6.1.4.1.6574.5.1.1.2
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrName
+        oid: 1.3.6.1.4.1.6574.5.1.1.3
+        type: OctetString
+        help: SMART attribute name - 1.3.6.1.4.1.6574.5.1.1.3
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrId
+        oid: 1.3.6.1.4.1.6574.5.1.1.4
+        type: gauge
+        help: SMART attribute ID - 1.3.6.1.4.1.6574.5.1.1.4
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrCurrent
+        oid: 1.3.6.1.4.1.6574.5.1.1.5
+        type: gauge
+        help: SMART attribute current value - 1.3.6.1.4.1.6574.5.1.1.5
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrWorst
+        oid: 1.3.6.1.4.1.6574.5.1.1.6
+        type: gauge
+        help: SMART attribute worst value - 1.3.6.1.4.1.6574.5.1.1.6
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrThreshold
+        oid: 1.3.6.1.4.1.6574.5.1.1.7
+        type: gauge
+        help: SMART attribute threshold value - 1.3.6.1.4.1.6574.5.1.1.7
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrRaw
+        oid: 1.3.6.1.4.1.6574.5.1.1.8
+        type: gauge
+        help: SMART attribute raw value - 1.3.6.1.4.1.6574.5.1.1.8
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrStatus
+        oid: 1.3.6.1.4.1.6574.5.1.1.9
+        type: OctetString
+        help: SMART attribute status - 1.3.6.1.4.1.6574.5.1.1.9
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: serviceInfoIndex
+        oid: 1.3.6.1.4.1.6574.6.1.1.1
+        type: gauge
+        help: Service info index - 1.3.6.1.4.1.6574.6.1.1.1
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceName
+        oid: 1.3.6.1.4.1.6574.6.1.1.2
+        type: OctetString
+        help: Service name - 1.3.6.1.4.1.6574.6.1.1.2
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceUsers
+        oid: 1.3.6.1.4.1.6574.6.1.1.3
+        type: gauge
+        help: Number of users using this service - 1.3.6.1.4.1.6574.6.1.1.3
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+    ubiquiti_airfiber:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: airFiberConfigIndex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.1
+        type: gauge
+        help: Index for the airFiberConfig - 1.3.6.1.4.1.41112.1.3.1.1.1
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: radioEnable
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.2
+        type: gauge
+        help: Radio Enabled State (Enabled/Disabled) - 1.3.6.1.4.1.41112.1.3.1.1.2
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: radioLinkMode
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.3
+        type: gauge
+        help: Radio Operating Mode - 1.3.6.1.4.1.41112.1.3.1.1.3
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: master
+          2: slave
+          3: spectral
+      - name: radioDuplex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.4
+        type: gauge
+        help: Radio Duplex Mode - 1.3.6.1.4.1.41112.1.3.1.1.4
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: halfDuplex
+          2: fullDuplex
+      - name: txFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.5
+        type: gauge
+        help: TX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.5
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.6
+        type: gauge
+        help: RX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.6
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: regDomain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.7
+        type: DisplayString
+        help: Regulatory Domain - 1.3.6.1.4.1.41112.1.3.1.1.7
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: gpsSync
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.8
+        type: gauge
+        help: GPS Synchronization state (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.8
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: txPower
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.9
+        type: gauge
+        help: Radio Transmit Power Setting (dBm) - 1.3.6.1.4.1.41112.1.3.1.1.9
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxGain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.10
+        type: gauge
+        help: Radio Receiver Gain Setting - 1.3.6.1.4.1.41112.1.3.1.1.10
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: low
+          2: high
+      - name: maxTxModRate
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.11
+        type: gauge
+        help: Maximum TX Modulation Rate - 1.3.6.1.4.1.41112.1.3.1.1.11
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: modRateControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.12
+        type: gauge
+        help: Transmit Modulation Rate Control - 1.3.6.1.4.1.41112.1.3.1.1.12
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: manual
+          2: automatic
+      - name: ethDPortLinkSpeed
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.13
+        type: gauge
+        help: Ethernet Data Port Configuration - 1.3.6.1.4.1.41112.1.3.1.1.13
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: auto
+          2: half-10Mbps
+          3: half-100Mbps
+          4: full-10Mbps
+          5: full-100Mbps
+          6: full-1000Mbps
+      - name: linkName
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.14
+        type: DisplayString
+        help: Radio Link Name - 1.3.6.1.4.1.41112.1.3.1.1.14
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: encryptKey
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.15
+        type: DisplayString
+        help: Radio Link Encryption Key - 1.3.6.1.4.1.41112.1.3.1.1.15
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethFlowControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.16
+        type: gauge
+        help: Ethernet DATA port Flow Control (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.16
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethMcastFilter
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.17
+        type: gauge
+        help: Ethernet DATA port Multicast Filter - 1.3.6.1.4.1.41112.1.3.1.1.17
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethTrackRFLink
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.18
+        type: gauge
+        help: Enable Ethernet DATA port state to track RF Link - 1.3.6.1.4.1.41112.1.3.1.1.18
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: use-Timers
+          2: enabled
+      - name: ethLinkOffDuration
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.19
+        type: gauge
+        help: Duration (seconds) of Ethernet Link Drop when ethTrackRFLink is set to Use-Timers
+          - 1.3.6.1.4.1.41112.1.3.1.1.19
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethLinkOffSpacing
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.20
+        type: gauge
+        help: Spacing (seconds) of consecutive Etherenet Link Drops when ethTrackLink
+          is set to Use-Timers - 1.3.6.1.4.1.41112.1.3.1.1.20
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.21
+        type: gauge
+        help: First configured TX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.21
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.22
+        type: gauge
+        help: First configured RX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.22
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.23
+        type: gauge
+        help: Second configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.23
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.24
+        type: gauge
+        help: Second configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.24
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.25
+        type: gauge
+        help: Third configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.25
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.26
+        type: gauge
+        help: Third configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.26
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: channelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.27
+        type: gauge
+        help: Current RF Channel Bandwidth - 1.3.6.1.4.1.41112.1.3.1.1.27
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.28
+        type: gauge
+        help: Current TX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.28
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.29
+        type: gauge
+        help: Current RX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.29
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: airFiberStatusIndex
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.1
+        type: gauge
+        help: Index for the air0 interface - 1.3.6.1.4.1.41112.1.3.2.1.1
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: curTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.2
+        type: gauge
+        help: Current Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.2
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: radioLinkDistFt
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.3
+        type: gauge
+        help: Radio Link Distance (Feet) - 1.3.6.1.4.1.41112.1.3.2.1.3
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkDistM
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.4
+        type: gauge
+        help: Radio Link Distance (Meters) - 1.3.6.1.4.1.41112.1.3.2.1.4
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.5
+        type: gauge
+        help: Radio Receive Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.5
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: txCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.6
+        type: gauge
+        help: Radio Transmit Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.6
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.7
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.7
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.8
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.8
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.9
+        type: gauge
+        help: Radio Chain 1 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.9
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.10
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.10
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.11
+        type: gauge
+        help: Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.11
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.12
+        type: gauge
+        help: Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.12
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.13
+        type: gauge
+        help: Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.13
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.14
+        type: gauge
+        help: Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.14
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.15
+        type: gauge
+        help: Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.15
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.16
+        type: gauge
+        help: Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.16
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteTXPower
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.17
+        type: gauge
+        help: Remote Radio Transmit Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.17
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.18
+        type: gauge
+        help: Remote Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.18
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: remoteRXPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.19
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.19
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.20
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.20
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower0Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.21
+        type: gauge
+        help: Remote Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.21
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.22
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.22
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.23
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.23
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.24
+        type: gauge
+        help: Remote Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.24
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: countryCode
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.25
+        type: gauge
+        help: Configured Country Code - 1.3.6.1.4.1.41112.1.3.2.1.25
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.26
+        type: gauge
+        help: Radio Link State - 1.3.6.1.4.1.41112.1.3.2.1.26
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: ethDataPortState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.27
+        type: gauge
+        help: Ethernet Data Port State - 1.3.6.1.4.1.41112.1.3.2.1.27
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: gpsPulse
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.28
+        type: DisplayString
+        help: GPS Pulse Detected - 1.3.6.1.4.1.41112.1.3.2.1.28
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsFix
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.29
+        type: DisplayString
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.3.2.1.29
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLat
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.30
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.3.2.1.30
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLong
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.31
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.3.2.1.31
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.32
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.3.2.1.32
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.33
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.3.2.1.33
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.34
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.3.2.1.34
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.35
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.3.2.1.35
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.36
+        type: OctetString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.3.2.1.36
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.37
+        type: DisplayString
+        help: Radio DFS State - 1.3.6.1.4.1.41112.1.3.2.1.37
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: upTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.38
+        type: gauge
+        help: Board uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.38
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dateTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.39
+        type: DisplayString
+        help: Board date and time - 1.3.6.1.4.1.41112.1.3.2.1.39
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: fwVersion
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.40
+        type: DisplayString
+        help: Board Firmware Revision - 1.3.6.1.4.1.41112.1.3.2.1.40
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXGain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.41
+        type: DisplayString
+        help: Remote radio Receiver Gain - 1.3.6.1.4.1.41112.1.3.2.1.41
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.42
+        type: DisplayString
+        help: Radio Link Connection Information - 1.3.6.1.4.1.41112.1.3.2.1.42
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: ethDataPortInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.43
+        type: DisplayString
+        help: Ethernet Data Port Link Connection Speed - 1.3.6.1.4.1.41112.1.3.2.1.43
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: linkUpTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.44
+        type: gauge
+        help: Radio Link uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.44
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteMAC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.45
+        type: DisplayString
+        help: Remote radio MAC Address - 1.3.6.1.4.1.41112.1.3.2.1.45
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteIP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.46
+        type: DisplayString
+        help: Remote radio IP Address - 1.3.6.1.4.1.41112.1.3.2.1.46
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDetections
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.47
+        type: gauge
+        help: Number of DFS Detections since boot - 1.3.6.1.4.1.41112.1.3.2.1.47
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDomain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.48
+        type: DisplayString
+        help: DFS Regulatory Domain for current TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.48
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.49
+        type: DisplayString
+        help: State of first TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.49
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.50
+        type: DisplayString
+        help: State of second TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.50
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.51
+        type: DisplayString
+        help: State of third TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.51
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.52
+        type: gauge
+        help: Seconds remaining before first TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.52
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.53
+        type: gauge
+        help: Seconds remaining before second TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.53
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.54
+        type: gauge
+        help: Seconds remaining before third TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.54
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: airFiberStatisticsIndex
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.1
+        type: gauge
+        help: Index for the airFiberStatus - 1.3.6.1.4.1.41112.1.3.3.1.1
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.2
+        type: counter
+        help: Eth Data Port TX Frames - 1.3.6.1.4.1.41112.1.3.3.1.2
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.3
+        type: counter
+        help: Eth Data Port RX Frames - 1.3.6.1.4.1.41112.1.3.3.1.3
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.4
+        type: counter
+        help: Eth Data Port CRC Errors - 1.3.6.1.4.1.41112.1.3.3.1.4
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxAlignErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.5
+        type: counter
+        help: Eth Data Port Receive Alignment Errors - 1.3.6.1.4.1.41112.1.3.3.1.5
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.6
+        type: counter
+        help: Eth Data Port TX Octets - 1.3.6.1.4.1.41112.1.3.3.1.6
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.7
+        type: counter
+        help: Eth Data Port RX Octets - 1.3.6.1.4.1.41112.1.3.3.1.7
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.8
+        type: counter
+        help: Eth Data Port Pause Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.8
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.9
+        type: counter
+        help: Eth Data Port Pause Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.9
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.10
+        type: counter
+        help: Eth Data Port Bad Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.10
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.11
+        type: counter
+        help: Eth Data Port Bad Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.11
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.12
+        type: counter
+        help: Eth Data Port Unicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.12
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.13
+        type: counter
+        help: Eth Data Port Multicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.13
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.14
+        type: counter
+        help: Eth Data Port Broadcast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.14
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.15
+        type: counter
+        help: Eth Data Port Unicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.15
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.16
+        type: counter
+        help: Eth Data Port Multicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.16
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.17
+        type: counter
+        help: Eth Data Port Broadcast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.17
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxDroppedMacErrFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.18
+        type: counter
+        help: Eth Data Port Dropped MAC Receive Errors - 1.3.6.1.4.1.41112.1.3.3.1.18
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalOctets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.19
+        type: counter
+        help: Eth Data Port Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.19
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.20
+        type: counter
+        help: Eth Data Port Total Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.20
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxLess64ByteFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.21
+        type: counter
+        help: Eth Data Port Undersized Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.21
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOverLengthFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.22
+        type: counter
+        help: Eth Data Port Over Max Length Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.22
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx64BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.23
+        type: counter
+        help: Eth Data Port 64 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.23
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx65_127BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.24
+        type: counter
+        help: Eth Data Port 65-127 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.24
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx128_255BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.25
+        type: counter
+        help: Eth Data Port 128-256 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.25
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx256_511BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.26
+        type: counter
+        help: Eth Data Port 256-511 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.26
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx512_1023BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.27
+        type: counter
+        help: Eth Data Port 512-1023 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.27
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1024_1518BytesPackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.28
+        type: counter
+        help: Eth Data Port 1024-1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.28
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1519PlusBytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.29
+        type: counter
+        help: Eth Data Port Greater Than 1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.29
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooLongFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.30
+        type: counter
+        help: Eth Data Port Too Long Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.30
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooShortFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.31
+        type: counter
+        help: Eth Data Port Too Short Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.31
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.32
+        type: counter
+        help: RF TX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.32
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.33
+        type: counter
+        help: RF TX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.33
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.34
+        type: counter
+        help: RF TX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.34
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.35
+        type: counter
+        help: RF TX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.35
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.36
+        type: counter
+        help: RF TX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.36
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.37
+        type: counter
+        help: RF TX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.37
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.38
+        type: counter
+        help: RF TX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.38
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.39
+        type: counter
+        help: RF TX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.39
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.40
+        type: counter
+        help: RF TX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.40
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.41
+        type: counter
+        help: RF TX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.41
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.42
+        type: counter
+        help: RF TX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.42
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.43
+        type: counter
+        help: RF TX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.43
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.44
+        type: counter
+        help: RF TX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.44
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.45
+        type: counter
+        help: RF TX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.45
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.46
+        type: counter
+        help: RF TX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.46
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.47
+        type: counter
+        help: RF TX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.47
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.48
+        type: counter
+        help: RF RX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.48
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.49
+        type: counter
+        help: RF RX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.49
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.50
+        type: counter
+        help: RF RX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.50
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.51
+        type: counter
+        help: RF RX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.51
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.52
+        type: counter
+        help: RF RX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.52
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.53
+        type: counter
+        help: RF RX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.53
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.54
+        type: counter
+        help: RF RX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.54
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.55
+        type: counter
+        help: RF RX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.55
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.56
+        type: counter
+        help: RF RX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.56
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.57
+        type: counter
+        help: RF RX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.57
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.58
+        type: counter
+        help: RF RX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.58
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.59
+        type: counter
+        help: RF RX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.59
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.60
+        type: counter
+        help: RF RX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.60
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.61
+        type: counter
+        help: RF RX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.61
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.62
+        type: counter
+        help: RF RX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.62
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.63
+        type: counter
+        help: RF RX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.63
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.64
+        type: counter
+        help: RF Total Octets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.64
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.65
+        type: counter
+        help: RF Total Packets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.65
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.66
+        type: counter
+        help: RF Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.66
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.67
+        type: counter
+        help: RF Total Packets Received - 1.3.6.1.4.1.41112.1.3.3.1.67
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      version: 1
+    ubiquiti_airmax:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ubntHostLocaltime
+        oid: 1.3.6.1.4.1.41112.1.4.8.1
+        type: DisplayString
+        help: Host local time - 1.3.6.1.4.1.41112.1.4.8.1
+      - name: ubntHostNetrole
+        oid: 1.3.6.1.4.1.41112.1.4.8.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.8.2
+        enum_values:
+          0: unknown
+          1: bridge
+          2: router
+          3: soho
+      - name: ubntHostCpuLoad
+        oid: 1.3.6.1.4.1.41112.1.4.8.3
+        type: gauge
+        help: Host CPU load - 1.3.6.1.4.1.41112.1.4.8.3
+      - name: ubntHostTemperature
+        oid: 1.3.6.1.4.1.41112.1.4.8.4
+        type: gauge
+        help: Host system temperature - 1.3.6.1.4.1.41112.1.4.8.4
+      - name: ubntGpsStatus
+        oid: 1.3.6.1.4.1.41112.1.4.9.1
+        type: gauge
+        help: GPS status - 1.3.6.1.4.1.41112.1.4.9.1
+        enum_values:
+          0: absent
+          1: "off"
+          2: "on"
+      - name: ubntGpsFix
+        oid: 1.3.6.1.4.1.41112.1.4.9.2
+        type: gauge
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.4.9.2
+        enum_values:
+          0: unknown
+          1: nofix
+          2: fix2d
+          3: fix3d
+      - name: ubntGpsLat
+        oid: 1.3.6.1.4.1.41112.1.4.9.3
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.4.9.3
+      - name: ubntGpsLon
+        oid: 1.3.6.1.4.1.41112.1.4.9.4
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.4.9.4
+      - name: ubntGpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.4.9.5
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.4.9.5
+      - name: ubntGpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.4.9.6
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.4.9.6
+      - name: ubntGpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.4.9.7
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.4.9.7
+      - name: ubntGpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.4.9.8
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.4.9.8
+      - name: ubntGpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.4.9.9
+        type: DisplayString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.4.9.9
+      - name: ubntRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.1
+        type: gauge
+        help: Index for the ubntRadioTable - 1.3.6.1.4.1.41112.1.4.1.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioMode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.1.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: sta
+          2: ap
+          3: aprepeater
+          4: apwds
+      - name: ubntRadioCCode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.3
+        type: gauge
+        help: Country code - 1.3.6.1.4.1.41112.1.4.1.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioFreq
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.4
+        type: gauge
+        help: Operating frequency - 1.3.6.1.4.1.41112.1.4.1.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDfsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.5
+        type: gauge
+        help: DFS status - 1.3.6.1.4.1.41112.1.4.1.1.5
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntRadioTxPower
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.6
+        type: gauge
+        help: Transmit power - 1.3.6.1.4.1.41112.1.4.1.1.6
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDistance
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.7
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.1.1.7
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioChainmask
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.8
+        type: gauge
+        help: Chainmask - 1.3.6.1.4.1.41112.1.4.1.1.8
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioAntenna
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.9
+        type: DisplayString
+        help: Antenna - 1.3.6.1.4.1.41112.1.4.1.1.9
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioRssiIndex
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.1
+        type: gauge
+        help: Index for the ubntRadioRssiTable - 1.3.6.1.4.1.41112.1.4.2.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssi
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.2
+        type: gauge
+        help: Data frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiMgmt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.3
+        type: gauge
+        help: Management frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiExt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.4
+        type: gauge
+        help: Extension channel rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntAirMaxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.7
+        type: gauge
+        help: airMAX Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.6.1.7
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxGpsSync
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.8
+        type: gauge
+        help: airMAX GPS sync - on/off - 1.3.6.1.4.1.41112.1.4.6.1.8
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxTdd
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.9
+        type: gauge
+        help: airMAX TDD framing - on/off - 1.3.6.1.4.1.41112.1.4.6.1.9
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.1
+        type: gauge
+        help: Index for the ubntAirMaxTable - 1.3.6.1.4.1.41112.1.4.6.1.1
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.2
+        type: gauge
+        help: airMAX status - on/off - 1.3.6.1.4.1.41112.1.4.6.1.2
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxQuality
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.3
+        type: gauge
+        help: airMAX quality - percentage - 1.3.6.1.4.1.41112.1.4.6.1.3
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.4
+        type: gauge
+        help: airMAX capacity - percentage - 1.3.6.1.4.1.41112.1.4.6.1.4
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxPriority
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.5
+        type: gauge
+        help: airMAX priority - none/high/low/medium - 1.3.6.1.4.1.41112.1.4.6.1.5
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          0: high
+          1: medium
+          2: low
+          3: none
+      - name: ubntAirMaxNoAck
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.6
+        type: gauge
+        help: airMAX NoACK mode - on/off - 1.3.6.1.4.1.41112.1.4.6.1.6
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSyncIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.1
+        type: gauge
+        help: Index for the ubntAirSyncTable - 1.3.6.1.4.1.41112.1.4.3.1.1
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncMode
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.2
+        type: gauge
+        help: airSync mode - master/slave - 1.3.6.1.4.1.41112.1.4.3.1.2
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: master
+          2: slave
+      - name: ubntAirSyncCount
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.3
+        type: gauge
+        help: airSync client count - 1.3.6.1.4.1.41112.1.4.3.1.3
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncDownUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.4
+        type: gauge
+        help: airSync down utilization - 1.3.6.1.4.1.41112.1.4.3.1.4
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncUpUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.5
+        type: gauge
+        help: airSync up utilization - 1.3.6.1.4.1.41112.1.4.3.1.5
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSelIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.1
+        type: gauge
+        help: Index for the ubntAirSelTable - 1.3.6.1.4.1.41112.1.4.4.1.1
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntAirSelEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.2
+        type: gauge
+        help: airSelect status - on/off - 1.3.6.1.4.1.41112.1.4.4.1.2
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSelInterval
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.3
+        type: gauge
+        help: airSelect hop interval (miliseconds) - 1.3.6.1.4.1.41112.1.4.4.1.3
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntWlStatIndex
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.1
+        type: gauge
+        help: Index for the ubntWlStatTable - 1.3.6.1.4.1.41112.1.4.5.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.2
+        type: DisplayString
+        help: SSID - 1.3.6.1.4.1.41112.1.4.5.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatHideSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.3
+        type: gauge
+        help: Hide SSID - on/off - 1.3.6.1.4.1.41112.1.4.5.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApMac
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.4
+        type: PhysAddress48
+        help: AP MAC address - 1.3.6.1.4.1.41112.1.4.5.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSignal
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.5
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.5.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRssi
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.6
+        type: gauge
+        help: RSSI, dBm - 1.3.6.1.4.1.41112.1.4.5.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatCcq
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.7
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.5.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.8
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.5.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.9
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.5.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.10
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.5.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSecurity
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.11
+        type: DisplayString
+        help: Wireless security mode - 1.3.6.1.4.1.41112.1.4.5.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatWdsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.12
+        type: gauge
+        help: WDS - on/off - 1.3.6.1.4.1.41112.1.4.5.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApRepeater
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.13
+        type: gauge
+        help: AP repeater - on/off - 1.3.6.1.4.1.41112.1.4.5.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatChanWidth
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.14
+        type: gauge
+        help: Channel Width - 1.3.6.1.4.1.41112.1.4.5.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatStaCount
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.15
+        type: gauge
+        help: Station count - 1.3.6.1.4.1.41112.1.4.5.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntStaLocalCINR
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.16
+        type: gauge
+        help: Local CINR - 1.3.6.1.4.1.41112.1.4.7.1.16
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.17
+        type: gauge
+        help: Uplink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.17
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.18
+        type: gauge
+        help: Downlink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.18
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.19
+        type: gauge
+        help: Uplink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.19
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.20
+        type: gauge
+        help: Downlink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.20
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxLatency
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.21
+        type: gauge
+        help: Uplink Latency in milliseconds - 1.3.6.1.4.1.41112.1.4.7.1.21
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaMac
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.1
+        type: PhysAddress48
+        help: Station MAC address - 1.3.6.1.4.1.41112.1.4.7.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaName
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.2
+        type: DisplayString
+        help: Station name - 1.3.6.1.4.1.41112.1.4.7.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaSignal
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.3
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.7.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.4
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.7.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaDistance
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.5
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.7.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaCcq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.6
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.7.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.7
+        type: gauge
+        help: airMAX priority - 1.3.6.1.4.1.41112.1.4.7.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.8
+        type: gauge
+        help: airMAX quality - 1.3.6.1.4.1.41112.1.4.7.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmc
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.9
+        type: gauge
+        help: airMAX capacity - 1.3.6.1.4.1.41112.1.4.7.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaLastIp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.10
+        type: InetAddressIPv4
+        help: Last known IP address - 1.3.6.1.4.1.41112.1.4.7.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.11
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.12
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.7.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.13
+        type: counter
+        help: TX bytes - 1.3.6.1.4.1.41112.1.4.7.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.14
+        type: counter
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaConnTime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.15
+        type: gauge
+        help: Connection Time in seconds - 1.3.6.1.4.1.41112.1.4.7.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      version: 1
+    ubiquiti_unifi:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: unifiRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.1'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioName
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.2
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.2'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.3'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.4
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.4'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.5'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuTotal
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.6
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.6'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfRx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.7
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.7'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfTx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.8'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioOtherBss
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.9
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.9'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiVapIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.1'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapBssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.2
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.2'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapCcq
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.3
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.3'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.4
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.4'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapExtChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.5
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.5'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapEssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.6'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapName
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.7
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.7'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapNumStations
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.8'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.9
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.9'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.10'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxCrypts
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.11
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.11'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.12'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.13'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxFrags
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.14'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.15'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.16
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.16'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.17
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.17'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.18
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.18'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.19
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.19'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxRetries
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.20
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.20'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPower
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.21
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.21'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapUp
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.22
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.22'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiVapUsage
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        type: DisplayString
+        help: guest or regular user - 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiIfIndex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.1'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfFullDuplex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.2'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiIfIp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.3
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.3'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfMac
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.4
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.4'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfName
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.5
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.5'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.6
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.6'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.7
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.7'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.8
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.8'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxMulticast
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.9
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.9'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.10'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfSpeed
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.11
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.11'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.12'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.13'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.14'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.15'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfUp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.16
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.16'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemIp
+        oid: 1.3.6.1.4.1.41112.1.6.3.1
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.1'
+      - name: unifiApSystemIsolated
+        oid: 1.3.6.1.4.1.41112.1.6.3.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.2'
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemModel
+        oid: 1.3.6.1.4.1.41112.1.6.3.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.3'
+      - name: unifiApSystemUplink
+        oid: 1.3.6.1.4.1.41112.1.6.3.4
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.4'
+      - name: unifiApSystemUptime
+        oid: 1.3.6.1.4.1.41112.1.6.3.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.5'
+      - name: unifiApSystemVersion
+        oid: 1.3.6.1.4.1.41112.1.6.3.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.6'
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..be0692bf9b655cf0c613f740091c7b0981439ce6
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
@@ -0,0 +1,64 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    vnf: {{ .Values.global.osm.vnf_id | lower}}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "snmpexporter.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      labels:
+        {{- include "snmpexporter.selectorLabels" . | nindent 8 }}
+    spec:
+      affinity:
+        podAffinity:
+          requiredDuringSchedulingIgnoredDuringExecution:
+          - labelSelector:
+              matchExpressions:
+              - key: vnf
+                operator: In
+                values:
+                - {{ .Values.global.osm.vnf_id | lower}}
+            topologyKey: "kubernetes.io/hostname"
+      securityContext:
+        runAsUser: 0
+      initContainers:
+        - name: init-config
+          image: busybox:1.28
+          command: ['sh', '-c', 'if [ ! -f "/etc/snmp_exporter/snmp.yml" ]; then cp /etc/snmp_exporter_init/snmp.yml /etc/snmp_exporter; fi']
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+            - name: init-config-volume
+              mountPath: /etc/snmp_exporter_init
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.version }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - containerPort: 9116
+              protocol: TCP
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+          livenessProbe:
+            exec:
+              command:
+                - /bin/sh
+                - -c
+                - if [ ! -f "/etc/snmp_exporter/generator.yml" ]; then exit 0; else rm -f /etc/snmp_exporter/generator.yml && exit 1; fi
+            failureThreshold: 1
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+      volumes:
+        - name: config-volume
+          hostPath: 
+            path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+        - name: init-config-volume
+          configMap:
+            name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower }}"
+          
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6ec5fb4fb4153956026d8bbb77439ca1cf6234aa
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    {{- include "snmpexporter.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: 9116
+      protocol: TCP
+      name: snmp
+  selector:
+    {{- include "snmpexporter.selectorLabels" . | nindent 4 }}
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cbe306fa4886e327d4887e771cc658d4c0a35d7c
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml
@@ -0,0 +1,14 @@
+# Default values for snmpexporter.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: prom/snmp-exporter
+  version: v0.17.0
+  pullPolicy: IfNotPresent
+
+service:
+  type: ClusterIP
+  port: 80
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/prometheus-job-template.j2 b/SOL004/snmp_ee_vnf/helm-charts/eechart/prometheus-job-template.j2
new file mode 100644
index 0000000000000000000000000000000000000000..f82adfc1b6fcb70ec0c1d3efd13813439af5f49b
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/prometheus-job-template.j2
@@ -0,0 +1,15 @@
+-   job_name: '{{ JOB_NAME }}'
+    static_configs:
+      - targets:
+          - {{ TARGET_IP }}
+    metrics_path: /snmp
+    params:
+        module: [ osm-snmp ] 
+    relabel_configs:
+      - source_labels: [__address__]
+        target_label: __param_target
+      - source_labels: [__param_target]
+        target_label: instance
+      - target_label: __address__
+        replacement: {{ EXPORTER_POD_IP }}:{{ EXPORTER_POD_PORT }}  # The SNMP exporter's real hostname:port.
+
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/generator.yml b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/generator.yml
new file mode 100644
index 0000000000000000000000000000000000000000..18c862ce7e24173db3899c2a5b05651ceb1fb001
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/generator.yml
@@ -0,0 +1,14 @@
+modules:
+  osm-snmp:
+    walk: [interfaces]
+    lookups:
+      - source_indexes: [ifIndex]
+        lookup: ifAlias
+      - source_indexes: [ifIndex]
+        lookup: ifDescr
+      - source_indexes: [ifIndex]
+        # Use OID to avoid conflict with Netscaler NS-ROOT-MIB.
+        lookup: 1.3.6.1.2.1.31.1.1.1.1 # ifName
+    auth:
+      # Community string is used with SNMP v1 and v2. Defaults to "public".
+      community: public
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..df59fa918c37b24cd0e8eb3a450a6ed32d010cd2
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt
@@ -0,0 +1,638 @@
+   IANAifType-MIB DEFINITIONS ::= BEGIN
+
+   IMPORTS
+       MODULE-IDENTITY, mib-2      FROM SNMPv2-SMI
+       TEXTUAL-CONVENTION          FROM SNMPv2-TC;
+
+   ianaifType MODULE-IDENTITY
+       LAST-UPDATED "201205170000Z"  -- May 17, 2012
+       ORGANIZATION "IANA"
+       CONTACT-INFO "        Internet Assigned Numbers Authority
+
+                     Postal: ICANN
+                             4676 Admiralty Way, Suite 330
+                             Marina del Rey, CA 90292
+
+                     Tel:    +1 310 823 9358
+                     E-Mail: iana&iana.org"
+       DESCRIPTION  "This MIB module defines the IANAifType Textual
+                     Convention, and thus the enumerated values of
+                     the ifType object defined in MIB-II's ifTable."
+
+       REVISION     "201205170000Z"  -- May 17, 2012
+       DESCRIPTION  "Registration of new IANAifType 272."
+
+       REVISION     "201201110000Z"  -- January 11, 2012
+       DESCRIPTION  "Registration of new IANAifTypes 266-271."
+
+       REVISION     "201112180000Z"  -- December 18, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 263-265."
+
+       REVISION     "201110260000Z"  -- October 26, 2011
+       DESCRIPTION  "Registration of new IANAifType 262."
+
+       REVISION     "201109070000Z"  -- September 7, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 260 and 261."
+
+       REVISION     "201107220000Z"  -- July 22, 2011
+       DESCRIPTION  "Registration of new IANAifType 259."
+
+       REVISION     "201106030000Z"  -- June 03, 2011
+       DESCRIPTION  "Registration of new IANAifType 258."
+
+       REVISION     "201009210000Z"  -- September 21, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 256 and 257."
+
+       REVISION     "201007210000Z"  -- July 21, 2010
+       DESCRIPTION  "Registration of new IANAifType 255."
+
+       REVISION     "201002110000Z"  -- February 11, 2010
+       DESCRIPTION  "Registration of new IANAifType 254."
+
+       REVISION     "201002080000Z"  -- February 08, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 252 and 253."
+
+       REVISION     "200905060000Z"  -- May 06, 2009
+       DESCRIPTION  "Registration of new IANAifType 251."
+
+       REVISION     "200902060000Z"  -- February 06, 2009
+       DESCRIPTION  "Registration of new IANAtunnelType 15."
+
+       REVISION     "200810090000Z"  -- October 09, 2008
+       DESCRIPTION  "Registration of new IANAifType 250."
+
+       REVISION     "200808120000Z"  -- August 12, 2008
+       DESCRIPTION  "Registration of new IANAifType 249."
+
+       REVISION     "200807220000Z"  -- July 22, 2008
+       DESCRIPTION  "Registration of new IANAifTypes 247 and 248."
+
+       REVISION     "200806240000Z"  -- June 24, 2008
+       DESCRIPTION  "Registration of new IANAifType 246."
+
+       REVISION     "200805290000Z"  -- May 29, 2008
+       DESCRIPTION  "Registration of new IANAifType 245."
+
+       REVISION     "200709130000Z"  -- September 13, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 243 and 244."
+
+       REVISION     "200705290000Z"  -- May 29, 2007
+       DESCRIPTION  "Changed the description for IANAifType 228."
+
+       REVISION     "200703080000Z"  -- March 08, 2007
+       DESCRIPTION  "Registration of new IANAifType 242."
+
+       REVISION     "200701230000Z"  -- January 23, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 239, 240, and 241." 
+
+       REVISION     "200610170000Z"  -- October 17, 2006
+       DESCRIPTION  "Deprecated/Obsoleted IANAifType 230.  Registration of 
+                     IANAifType 238." 
+
+       REVISION     "200609250000Z"  -- September 25, 2006
+       DESCRIPTION  "Changed the description for IANA ifType 
+                     184 and added new IANA ifType 237."  
+
+       REVISION     "200608170000Z"  -- August 17, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     20 and 21."   
+
+       REVISION     "200608110000Z"  -- August 11, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     7, 11, 62, 69, and 117."   
+
+       REVISION     "200607250000Z"  -- July 25, 2006
+       DESCRIPTION  "Registration of new IANA ifType 236."
+
+       REVISION     "200606140000Z"  -- June 14, 2006
+       DESCRIPTION  "Registration of new IANA ifType 235."
+
+       REVISION     "200603310000Z"  -- March 31, 2006
+       DESCRIPTION  "Registration of new IANA ifType 234."
+
+       REVISION     "200603300000Z"  -- March 30, 2006
+       DESCRIPTION  "Registration of new IANA ifType 233."
+
+       REVISION     "200512220000Z"  -- December 22, 2005
+       DESCRIPTION  "Registration of new IANA ifTypes 231 and 232."
+
+       REVISION     "200510100000Z"  -- October 10, 2005
+       DESCRIPTION  "Registration of new IANA ifType 230."
+
+       REVISION     "200509090000Z"  -- September 09, 2005
+       DESCRIPTION  "Registration of new IANA ifType 229."
+
+       REVISION     "200505270000Z"  -- May 27, 2005
+       DESCRIPTION  "Registration of new IANA ifType 228."
+
+       REVISION     "200503030000Z"  -- March 3, 2005
+       DESCRIPTION  "Added the IANAtunnelType TC and deprecated
+	                 IANAifType sixToFour (215) per RFC4087."
+
+       REVISION     "200411220000Z"  -- November 22, 2004
+       DESCRIPTION  "Registration of new IANA ifType 227 per RFC4631."
+
+       REVISION     "200406170000Z"  -- June 17, 2004
+       DESCRIPTION  "Registration of new IANA ifType 226."
+
+       REVISION     "200405120000Z"  -- May 12, 2004
+       DESCRIPTION  "Added description for IANAifType 6, and 
+	                 changed the descriptions for IANAifTypes
+                     180, 181, and 182."
+
+       REVISION     "200405070000Z"  -- May 7, 2004
+       DESCRIPTION  "Registration of new IANAifType 225."
+
+       REVISION     "200308250000Z"  -- Aug 25, 2003
+       DESCRIPTION  "Deprecated IANAifTypes 7 and 11. Obsoleted
+                     IANAifTypes 62, 69, and 117.  ethernetCsmacd (6)
+                     should be used instead of these values"
+
+       REVISION     "200308180000Z"  -- Aug 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     224."
+
+       REVISION     "200308070000Z"  -- Aug 7, 2003
+       DESCRIPTION  "Registration of new IANAifTypes
+                     222 and 223."
+
+       REVISION     "200303180000Z"  -- Mar 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     221."
+
+       REVISION     "200301130000Z"  -- Jan 13, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     220."
+
+       REVISION     "200210170000Z"  -- Oct 17, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     219."
+
+       REVISION     "200207160000Z"  -- Jul 16, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     217 and 218."
+
+       REVISION     "200207100000Z"  -- Jul 10, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     215 and 216."
+
+       REVISION     "200206190000Z"  -- Jun 19, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     214."
+
+       REVISION     "200201040000Z"  -- Jan 4, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     211, 212 and 213."
+
+       REVISION     "200112200000Z"  -- Dec 20, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     209 and 210."
+
+       REVISION     "200111150000Z"  -- Nov 15, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     207 and 208."
+
+       REVISION     "200111060000Z"  -- Nov 6, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     206."
+
+       REVISION     "200111020000Z"  -- Nov 2, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     205."
+
+       REVISION     "200110160000Z"  -- Oct 16, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     199, 200, 201, 202, 203, and 204."
+
+       REVISION     "200109190000Z"  -- Sept 19, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     198."
+
+       REVISION     "200105110000Z"  -- May 11, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     197."
+
+       REVISION     "200101120000Z"  -- Jan 12, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     195 and 196."
+
+       REVISION     "200012190000Z"  -- Dec 19, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     193 and 194."
+
+       REVISION     "200012070000Z"  -- Dec 07, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     191 and 192."
+
+       REVISION     "200012040000Z"  -- Dec 04, 2000
+       DESCRIPTION  "Registration of new IANAifType
+                     190."
+
+       REVISION     "200010170000Z"  -- Oct 17, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     188 and 189."  
+
+       REVISION     "200010020000Z"  -- Oct 02, 2000
+       DESCRIPTION  "Registration of new IANAifType 187." 
+
+       REVISION     "200009010000Z"  -- Sept 01, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     184, 185, and 186."			
+
+       REVISION     "200008240000Z"  -- Aug 24, 2000
+       DESCRIPTION  "Registration of new IANAifType 183." 
+
+       REVISION     "200008230000Z"  -- Aug 23, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     174-182."
+
+       REVISION     "200008220000Z"  -- Aug 22, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 170,
+                     171, 172 and 173."
+
+       REVISION     "200004250000Z"  -- Apr 25, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 168 and 169."       
+
+       REVISION     "200003060000Z"  -- Mar 6, 2000
+       DESCRIPTION  "Fixed a missing semi-colon in the IMPORT.
+                     Also cleaned up the REVISION log a bit.
+                     It is not complete, but from now on it will
+                     be maintained and kept up to date with each
+                     change to this MIB module."
+
+       REVISION     "199910081430Z"  -- Oct 08, 1999
+       DESCRIPTION  "Include new name assignments up to cnr(85).
+                     This is the first version available via the WWW
+                     at: ftp://ftp.isi.edu/mib/ianaiftype.mib"
+
+       REVISION     "199401310000Z"  -- Jan 31, 1994
+       DESCRIPTION  "Initial version of this MIB as published in
+                     RFC 1573."
+       ::= { mib-2 30 }
+
+   IANAifType ::= TEXTUAL-CONVENTION
+       STATUS       current
+       DESCRIPTION
+               "This data type is used as the syntax of the ifType
+               object in the (updated) definition of MIB-II's
+               ifTable.
+
+               The definition of this textual convention with the
+               addition of newly assigned values is published
+               periodically by the IANA, in either the Assigned
+               Numbers RFC, or some derivative of it specific to
+               Internet Network Management number assignments.  (The
+               latest arrangements can be obtained by contacting the
+               IANA.)
+
+               Requests for new values should be made to IANA via
+               email (iana&iana.org).
+
+               The relationship between the assignment of ifType
+               values and of OIDs to particular media-specific MIBs
+               is solely the purview of IANA and is subject to change
+               without notice.  Quite often, a media-specific MIB's
+               OID-subtree assignment within MIB-II's 'transmission'
+               subtree will be the same as its ifType value.
+               However, in some circumstances this will not be the
+               case, and implementors must not pre-assume any
+               specific relationship between ifType values and
+               transmission subtree OIDs."
+       SYNTAX  INTEGER {
+                   other(1),          -- none of the following
+                   regular1822(2),
+                   hdh1822(3),
+                   ddnX25(4),
+                   rfc877x25(5),
+                   ethernetCsmacd(6), -- for all ethernet-like interfaces,
+                                      -- regardless of speed, as per RFC3635
+                   iso88023Csmacd(7), -- Deprecated via RFC3635
+                                      -- ethernetCsmacd (6) should be used instead
+                   iso88024TokenBus(8),
+                   iso88025TokenRing(9),
+                   iso88026Man(10),
+                   starLan(11), -- Deprecated via RFC3635
+                                -- ethernetCsmacd (6) should be used instead
+                   proteon10Mbit(12),
+                   proteon80Mbit(13),
+                   hyperchannel(14),
+                   fddi(15),
+                   lapb(16),
+                   sdlc(17),
+                   ds1(18),            -- DS1-MIB
+                   e1(19),             -- Obsolete see DS1-MIB
+                   basicISDN(20),              -- no longer used
+                                               -- see also RFC2127
+                   primaryISDN(21),            -- no longer used
+                                               -- see also RFC2127
+                   propPointToPointSerial(22), -- proprietary serial
+                   ppp(23),
+                   softwareLoopback(24),
+                   eon(25),            -- CLNP over IP 
+                   ethernet3Mbit(26),
+                   nsip(27),           -- XNS over IP
+                   slip(28),           -- generic SLIP
+                   ultra(29),          -- ULTRA technologies
+                   ds3(30),            -- DS3-MIB
+                   sip(31),            -- SMDS, coffee
+                   frameRelay(32),     -- DTE only. 
+                   rs232(33),
+                   para(34),           -- parallel-port
+                   arcnet(35),         -- arcnet
+                   arcnetPlus(36),     -- arcnet plus
+                   atm(37),            -- ATM cells
+                   miox25(38),
+                   sonet(39),          -- SONET or SDH 
+                   x25ple(40),
+                   iso88022llc(41),
+                   localTalk(42),
+                   smdsDxi(43),
+                   frameRelayService(44),  -- FRNETSERV-MIB
+                   v35(45),
+                   hssi(46),
+                   hippi(47),
+                   modem(48),          -- Generic modem
+                   aal5(49),           -- AAL5 over ATM
+                   sonetPath(50),
+                   sonetVT(51),
+                   smdsIcip(52),       -- SMDS InterCarrier Interface
+                   propVirtual(53),    -- proprietary virtual/internal
+                   propMultiplexor(54),-- proprietary multiplexing
+                   ieee80212(55),      -- 100BaseVG
+                   fibreChannel(56),   -- Fibre Channel
+                   hippiInterface(57), -- HIPPI interfaces     
+                   frameRelayInterconnect(58), -- Obsolete, use either
+                                       -- frameRelay(32) or 
+                                       -- frameRelayService(44).
+                   aflane8023(59),     -- ATM Emulated LAN for 802.3
+                   aflane8025(60),     -- ATM Emulated LAN for 802.5
+                   cctEmul(61),        -- ATM Emulated circuit          
+                   fastEther(62),      -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   isdn(63),           -- ISDN and X.25           
+                   v11(64),            -- CCITT V.11/X.21             
+                   v36(65),            -- CCITT V.36                  
+                   g703at64k(66),      -- CCITT G703 at 64Kbps
+                   g703at2mb(67),      -- Obsolete see DS1-MIB
+                   qllc(68),           -- SNA QLLC                    
+                   fastEtherFX(69),    -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   channel(70),        -- channel                     
+                   ieee80211(71),      -- radio spread spectrum       
+                   ibm370parChan(72),  -- IBM System 360/370 OEMI Channel
+                   escon(73),          -- IBM Enterprise Systems Connection
+                   dlsw(74),           -- Data Link Switching
+                   isdns(75),          -- ISDN S/T interface
+                   isdnu(76),          -- ISDN U interface
+                   lapd(77),           -- Link Access Protocol D
+                   ipSwitch(78),       -- IP Switching Objects
+                   rsrb(79),           -- Remote Source Route Bridging
+                   atmLogical(80),     -- ATM Logical Port
+                   ds0(81),            -- Digital Signal Level 0
+                   ds0Bundle(82),      -- group of ds0s on the same ds1
+                   bsc(83),            -- Bisynchronous Protocol
+                   async(84),          -- Asynchronous Protocol
+                   cnr(85),            -- Combat Net Radio
+                   iso88025Dtr(86),    -- ISO 802.5r DTR
+                   eplrs(87),          -- Ext Pos Loc Report Sys
+                   arap(88),           -- Appletalk Remote Access Protocol
+                   propCnls(89),       -- Proprietary Connectionless Protocol
+                   hostPad(90),        -- CCITT-ITU X.29 PAD Protocol
+                   termPad(91),        -- CCITT-ITU X.3 PAD Facility
+                   frameRelayMPI(92),  -- Multiproto Interconnect over FR
+                   x213(93),           -- CCITT-ITU X213
+                   adsl(94),           -- Asymmetric Digital Subscriber Loop
+                   radsl(95),          -- Rate-Adapt. Digital Subscriber Loop
+                   sdsl(96),           -- Symmetric Digital Subscriber Loop
+                   vdsl(97),           -- Very H-Speed Digital Subscrib. Loop
+                   iso88025CRFPInt(98), -- ISO 802.5 CRFP
+                   myrinet(99),        -- Myricom Myrinet
+                   voiceEM(100),       -- voice recEive and transMit
+                   voiceFXO(101),      -- voice Foreign Exchange Office
+                   voiceFXS(102),      -- voice Foreign Exchange Station
+                   voiceEncap(103),    -- voice encapsulation
+                   voiceOverIp(104),   -- voice over IP encapsulation
+                   atmDxi(105),        -- ATM DXI
+                   atmFuni(106),       -- ATM FUNI
+                   atmIma (107),       -- ATM IMA		   
+                   pppMultilinkBundle(108), -- PPP Multilink Bundle
+                   ipOverCdlc (109),   -- IBM ipOverCdlc
+                   ipOverClaw (110),   -- IBM Common Link Access to Workstn
+                   stackToStack (111), -- IBM stackToStack
+                   virtualIpAddress (112), -- IBM VIPA
+                   mpc (113),          -- IBM multi-protocol channel support
+                   ipOverAtm (114),    -- IBM ipOverAtm
+                   iso88025Fiber (115), -- ISO 802.5j Fiber Token Ring
+                   tdlc (116),	       -- IBM twinaxial data link control
+                   gigabitEthernet (117), -- Obsoleted via RFC3635
+                                          -- ethernetCsmacd (6) should be used instead
+                   hdlc (118),         -- HDLC
+                   lapf (119),	       -- LAP F
+                   v37 (120),	       -- V.37
+                   x25mlp (121),       -- Multi-Link Protocol
+                   x25huntGroup (122), -- X25 Hunt Group
+                   transpHdlc (123),   -- Transp HDLC
+                   interleave (124),   -- Interleave channel
+                   fast (125),         -- Fast channel
+                   ip (126),	       -- IP (for APPN HPR in IP networks)
+                   docsCableMaclayer (127),  -- CATV Mac Layer
+                   docsCableDownstream (128), -- CATV Downstream interface
+                   docsCableUpstream (129),  -- CATV Upstream interface
+                   a12MppSwitch (130), -- Avalon Parallel Processor
+                   tunnel (131),       -- Encapsulation interface
+                   coffee (132),       -- coffee pot
+                   ces (133),          -- Circuit Emulation Service
+                   atmSubInterface (134), -- ATM Sub Interface
+                   l2vlan (135),       -- Layer 2 Virtual LAN using 802.1Q
+                   l3ipvlan (136),     -- Layer 3 Virtual LAN using IP
+                   l3ipxvlan (137),    -- Layer 3 Virtual LAN using IPX
+                   digitalPowerline (138), -- IP over Power Lines	
+                   mediaMailOverIp (139), -- Multimedia Mail over IP
+                   dtm (140),        -- Dynamic syncronous Transfer Mode
+                   dcn (141),    -- Data Communications Network
+                   ipForward (142),    -- IP Forwarding Interface
+                   msdsl (143),       -- Multi-rate Symmetric DSL
+                   ieee1394 (144), -- IEEE1394 High Performance Serial Bus
+                   if-gsn (145),       --   HIPPI-6400 
+                   dvbRccMacLayer (146), -- DVB-RCC MAC Layer
+                   dvbRccDownstream (147),  -- DVB-RCC Downstream Channel
+                   dvbRccUpstream (148),  -- DVB-RCC Upstream Channel
+                   atmVirtual (149),   -- ATM Virtual Interface
+                   mplsTunnel (150),   -- MPLS Tunnel Virtual Interface
+                   srp (151),	-- Spatial Reuse Protocol	
+                   voiceOverAtm (152),  -- Voice Over ATM
+                   voiceOverFrameRelay (153),   -- Voice Over Frame Relay 
+                   idsl (154),		-- Digital Subscriber Loop over ISDN
+                   compositeLink (155),  -- Avici Composite Link Interface
+                   ss7SigLink (156),     -- SS7 Signaling Link 
+                   propWirelessP2P (157),  --  Prop. P2P wireless interface
+                   frForward (158),    -- Frame Forward Interface
+                   rfc1483 (159),	-- Multiprotocol over ATM AAL5
+                   usb (160),		-- USB Interface
+                   ieee8023adLag (161),  -- IEEE 802.3ad Link Aggregate
+                   bgppolicyaccounting (162), -- BGP Policy Accounting
+                   frf16MfrBundle (163), -- FRF .16 Multilink Frame Relay 
+                   h323Gatekeeper (164), -- H323 Gatekeeper
+                   h323Proxy (165), -- H323 Voice and Video Proxy
+                   mpls (166), -- MPLS                   
+                   mfSigLink (167), -- Multi-frequency signaling link
+                   hdsl2 (168), -- High Bit-Rate DSL - 2nd generation
+                   shdsl (169), -- Multirate HDSL2
+                   ds1FDL (170), -- Facility Data Link 4Kbps on a DS1
+                   pos (171), -- Packet over SONET/SDH Interface
+                   dvbAsiIn (172), -- DVB-ASI Input
+                   dvbAsiOut (173), -- DVB-ASI Output 
+                   plc (174), -- Power Line Communtications
+                   nfas (175), -- Non Facility Associated Signaling
+                   tr008 (176), -- TR008
+                   gr303RDT (177), -- Remote Digital Terminal
+                   gr303IDT (178), -- Integrated Digital Terminal
+                   isup (179), -- ISUP
+                   propDocsWirelessMaclayer (180), -- Cisco proprietary Maclayer
+                   propDocsWirelessDownstream (181), -- Cisco proprietary Downstream
+                   propDocsWirelessUpstream (182), -- Cisco proprietary Upstream
+                   hiperlan2 (183), -- HIPERLAN Type 2 Radio Interface
+                   propBWAp2Mp (184), -- PropBroadbandWirelessAccesspt2multipt
+                             -- use of this iftype for IEEE 802.16 WMAN
+                             -- interfaces as per IEEE Std 802.16f is
+                             -- deprecated and ifType 237 should be used instead.
+                   sonetOverheadChannel (185), -- SONET Overhead Channel
+                   digitalWrapperOverheadChannel (186), -- Digital Wrapper
+                   aal2 (187), -- ATM adaptation layer 2
+                   radioMAC (188), -- MAC layer over radio links
+                   atmRadio (189), -- ATM over radio links   
+                   imt (190), -- Inter Machine Trunks
+                   mvl (191), -- Multiple Virtual Lines DSL
+                   reachDSL (192), -- Long Reach DSL
+                   frDlciEndPt (193), -- Frame Relay DLCI End Point
+                   atmVciEndPt (194), -- ATM VCI End Point
+                   opticalChannel (195), -- Optical Channel
+                   opticalTransport (196), -- Optical Transport
+                   propAtm (197), --  Proprietary ATM       
+                   voiceOverCable (198), -- Voice Over Cable Interface
+                   infiniband (199), -- Infiniband
+                   teLink (200), -- TE Link
+                   q2931 (201), -- Q.2931
+                   virtualTg (202), -- Virtual Trunk Group
+                   sipTg (203), -- SIP Trunk Group
+                   sipSig (204), -- SIP Signaling   
+                   docsCableUpstreamChannel (205), -- CATV Upstream Channel
+                   econet (206), -- Acorn Econet
+                   pon155 (207), -- FSAN 155Mb Symetrical PON interface
+                   pon622 (208), -- FSAN622Mb Symetrical PON interface
+                   bridge (209), -- Transparent bridge interface
+                   linegroup (210), -- Interface common to multiple lines   
+                   voiceEMFGD (211), -- voice E&M Feature Group D
+                   voiceFGDEANA (212), -- voice FGD Exchange Access North American
+                   voiceDID (213), -- voice Direct Inward Dialing
+                   mpegTransport (214), -- MPEG transport interface
+                   sixToFour (215), -- 6to4 interface (DEPRECATED)
+                   gtp (216), -- GTP (GPRS Tunneling Protocol)
+                   pdnEtherLoop1 (217), -- Paradyne EtherLoop 1
+                   pdnEtherLoop2 (218), -- Paradyne EtherLoop 2
+                   opticalChannelGroup (219), -- Optical Channel Group
+                   homepna (220), -- HomePNA ITU-T G.989
+                   gfp (221), -- Generic Framing Procedure (GFP)
+                   ciscoISLvlan (222), -- Layer 2 Virtual LAN using Cisco ISL
+                   actelisMetaLOOP (223), -- Acteleis proprietary MetaLOOP High Speed Link 
+                   fcipLink (224), -- FCIP Link 
+                   rpr (225), -- Resilient Packet Ring Interface Type
+                   qam (226), -- RF Qam Interface
+                   lmp (227), -- Link Management Protocol
+                   cblVectaStar (228), -- Cambridge Broadband Networks Limited VectaStar
+                   docsCableMCmtsDownstream (229), -- CATV Modular CMTS Downstream Interface
+                   adsl2 (230), -- Asymmetric Digital Subscriber Loop Version 2 
+                                -- (DEPRECATED/OBSOLETED - please use adsl2plus 238 instead)
+                   macSecControlledIF (231), -- MACSecControlled 
+                   macSecUncontrolledIF (232), -- MACSecUncontrolled
+                   aviciOpticalEther (233), -- Avici Optical Ethernet Aggregate
+                   atmbond (234), -- atmbond
+                   voiceFGDOS (235), -- voice FGD Operator Services
+                   mocaVersion1 (236), -- MultiMedia over Coax Alliance (MoCA) Interface
+                             -- as documented in information provided privately to IANA
+                   ieee80216WMAN (237), -- IEEE 802.16 WMAN interface
+                   adsl2plus (238), -- Asymmetric Digital Subscriber Loop Version 2, 
+                                   -- Version 2 Plus and all variants
+                   dvbRcsMacLayer (239), -- DVB-RCS MAC Layer
+                   dvbTdm (240), -- DVB Satellite TDM
+                   dvbRcsTdma (241), -- DVB-RCS TDMA
+                   x86Laps (242), -- LAPS based on ITU-T X.86/Y.1323
+                   wwanPP (243), -- 3GPP WWAN
+                   wwanPP2 (244), -- 3GPP2 WWAN
+                   voiceEBS (245), -- voice P-phone EBS physical interface
+                   ifPwType (246), -- Pseudowire interface type
+                   ilan (247), -- Internal LAN on a bridge per IEEE 802.1ap
+                   pip (248), -- Provider Instance Port on a bridge per IEEE 802.1ah PBB
+                   aluELP (249), -- Alcatel-Lucent Ethernet Link Protection
+                   gpon (250), -- Gigabit-capable passive optical networks (G-PON) as per ITU-T G.948
+                   vdsl2 (251), -- Very high speed digital subscriber line Version 2 (as per ITU-T Recommendation G.993.2)
+                   capwapDot11Profile (252), -- WLAN Profile Interface
+                   capwapDot11Bss (253), -- WLAN BSS Interface
+                   capwapWtpVirtualRadio (254), -- WTP Virtual Radio Interface
+                   bits (255), -- bitsport
+                   docsCableUpstreamRfPort (256), -- DOCSIS CATV Upstream RF Port
+                   cableDownstreamRfPort (257), -- CATV downstream RF port
+                   vmwareVirtualNic (258), -- VMware Virtual Network Interface
+                   ieee802154 (259), -- IEEE 802.15.4 WPAN interface
+                   otnOdu (260), -- OTN Optical Data Unit
+                   otnOtu (261), -- OTN Optical channel Transport Unit
+                   ifVfiType (262), -- VPLS Forwarding Instance Interface Type
+                   g9981 (263), -- G.998.1 bonded interface
+                   g9982 (264), -- G.998.2 bonded interface
+                   g9983 (265), -- G.998.3 bonded interface
+                   aluEpon (266), -- Ethernet Passive Optical Networks (E-PON)
+                   aluEponOnu (267), -- EPON Optical Network Unit
+                   aluEponPhysicalUni (268), -- EPON physical User to Network interface
+                   aluEponLogicalLink (269), -- The emulation of a point-to-point link over the EPON layer
+                   aluGponOnu (270), -- GPON Optical Network Unit
+                   aluGponPhysicalUni (271), -- GPON physical User to Network interface
+                   vmwareNicTeam (272) -- VMware NIC Team
+                   }
+
+IANAtunnelType ::= TEXTUAL-CONVENTION
+    STATUS     current
+    DESCRIPTION
+            "The encapsulation method used by a tunnel. The value
+            direct indicates that a packet is encapsulated
+            directly within a normal IP header, with no
+            intermediate header, and unicast to the remote tunnel
+            endpoint (e.g., an RFC 2003 IP-in-IP tunnel, or an RFC
+            1933 IPv6-in-IPv4 tunnel). The value minimal indicates
+            that a Minimal Forwarding Header (RFC 2004) is
+            inserted between the outer header and the payload
+            packet. The value UDP indicates that the payload
+            packet is encapsulated within a normal UDP packet
+            (e.g., RFC 1234).
+
+            The values sixToFour, sixOverFour, and isatap
+            indicates that an IPv6 packet is encapsulated directly
+            within an IPv4 header, with no intermediate header,
+            and unicast to the destination determined by the 6to4,
+            6over4, or ISATAP protocol.
+
+            The remaining protocol-specific values indicate that a
+            header of the protocol of that name is inserted
+            between the outer header and the payload header.
+
+            The assignment policy for IANAtunnelType values is
+            identical to the policy for assigning IANAifType
+            values."
+    SYNTAX     INTEGER {
+                   other(1),        -- none of the following
+                   direct(2),       -- no intermediate header
+                   gre(3),          -- GRE encapsulation
+                   minimal(4),      -- Minimal encapsulation
+                   l2tp(5),         -- L2TP encapsulation
+                   pptp(6),         -- PPTP encapsulation
+                   l2f(7),          -- L2F encapsulation
+                   udp(8),          -- UDP encapsulation
+                   atmp(9),         -- ATMP encapsulation
+                   msdp(10),        -- MSDP encapsulation
+                   sixToFour(11),   -- 6to4 encapsulation
+                   sixOverFour(12), -- 6over4 encapsulation
+                   isatap(13),      -- ISATAP encapsulation
+                   teredo(14),      -- Teredo encapsulation
+                   ipHttps(15)      -- IPHTTPS
+               }
+
+   END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..7704f0c257ec0769badc84b0591c06c893e7b001
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt
@@ -0,0 +1,1814 @@
+IF-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64,
+    Integer32, TimeTicks, mib-2,
+    NOTIFICATION-TYPE                        FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION, DisplayString,
+    PhysAddress, TruthValue, RowStatus,
+    TimeStamp, AutonomousType, TestAndIncr   FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP,
+    NOTIFICATION-GROUP                       FROM SNMPv2-CONF
+    snmpTraps                                FROM SNMPv2-MIB
+    IANAifType                               FROM IANAifType-MIB;
+
+ifMIB MODULE-IDENTITY
+    LAST-UPDATED "200006140000Z"
+    ORGANIZATION "IETF Interfaces MIB Working Group"
+    CONTACT-INFO
+            "   Keith McCloghrie
+                Cisco Systems, Inc.
+                170 West Tasman Drive
+                San Jose, CA  95134-1706
+                US
+
+                408-526-5260
+                kzm@cisco.com"
+    DESCRIPTION
+            "The MIB module to describe generic objects for network
+            interface sub-layers.  This MIB is an updated version of
+            MIB-II's ifTable, and incorporates the extensions defined in
+            RFC 1229."
+
+    REVISION      "200006140000Z"
+    DESCRIPTION
+            "Clarifications agreed upon by the Interfaces MIB WG, and
+            published as RFC 2863."
+    REVISION      "199602282155Z"
+    DESCRIPTION
+            "Revisions made by the Interfaces MIB WG, and published in
+            RFC 2233."
+    REVISION      "199311082155Z"
+    DESCRIPTION
+            "Initial revision, published as part of RFC 1573."
+    ::= { mib-2 31 }
+
+ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
+
+interfaces   OBJECT IDENTIFIER ::= { mib-2 2 }
+
+--
+-- Textual Conventions
+--
+
+-- OwnerString has the same semantics as used in RFC 1271
+
+OwnerString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       deprecated
+    DESCRIPTION
+            "This data type is used to model an administratively
+            assigned name of the owner of a resource.  This information
+            is taken from the NVT ASCII character set.  It is suggested
+            that this name contain one or more of the following: ASCII
+            form of the manager station's transport address, management
+            station name (e.g., domain name), network management
+            personnel's name, location, or phone number.  In some cases
+            the agent itself will be the owner of an entry.  In these
+            cases, this string shall be set to a string starting with
+            'agent'."
+    SYNTAX       OCTET STRING (SIZE(0..255))
+
+-- InterfaceIndex contains the semantics of ifIndex and should be used
+-- for any objects defined in other MIB modules that need these semantics.
+
+InterfaceIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface or
+            interface sub-layer in the managed system.  It is
+            recommended that values are assigned contiguously starting
+            from 1.  The value for each interface sub-layer must remain
+            constant at least from one re-initialization of the entity's
+            network management system to the next re-initialization."
+    SYNTAX       Integer32 (1..2147483647)
+
+InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "This textual convention is an extension of the
+            InterfaceIndex convention.  The latter defines a greater
+            than zero value used to identify an interface or interface
+            sub-layer in the managed system.  This extension permits the
+            additional value of zero.  the value zero is object-specific
+            and must therefore be defined as part of the description of
+            any object which uses this syntax.  Examples of the usage of
+            zero might include situations where interface was unknown,
+            or when none or all interfaces need to be referenced."
+    SYNTAX       Integer32 (0..2147483647)
+
+ifNumber  OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of network interfaces (regardless of their
+            current state) present on this system."
+    ::= { interfaces 1 }
+
+ifTableLastChange  OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last creation or
+            deletion of an entry in the ifTable.  If the number of
+            entries has been unchanged since the last re-initialization
+            of the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 5 }
+
+-- the Interfaces table
+
+-- The Interfaces table contains information on the entity's
+
+-- interfaces.  Each sub-layer below the internetwork-layer
+-- of a network interface is considered to be an interface.
+
+ifTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber."
+    ::= { interfaces 2 }
+
+ifEntry OBJECT-TYPE
+    SYNTAX      IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing management information applicable to a
+            particular interface."
+    INDEX   { ifIndex }
+    ::= { ifTable 1 }
+
+IfEntry ::=
+    SEQUENCE {
+        ifIndex                 InterfaceIndex,
+        ifDescr                 DisplayString,
+        ifType                  IANAifType,
+        ifMtu                   Integer32,
+        ifSpeed                 Gauge32,
+        ifPhysAddress           PhysAddress,
+        ifAdminStatus           INTEGER,
+        ifOperStatus            INTEGER,
+        ifLastChange            TimeTicks,
+        ifInOctets              Counter32,
+        ifInUcastPkts           Counter32,
+        ifInNUcastPkts          Counter32,  -- deprecated
+        ifInDiscards            Counter32,
+        ifInErrors              Counter32,
+        ifInUnknownProtos       Counter32,
+        ifOutOctets             Counter32,
+        ifOutUcastPkts          Counter32,
+        ifOutNUcastPkts         Counter32,  -- deprecated
+        ifOutDiscards           Counter32,
+        ifOutErrors             Counter32,
+        ifOutQLen               Gauge32,    -- deprecated
+        ifSpecific              OBJECT IDENTIFIER -- deprecated
+    }
+
+ifIndex OBJECT-TYPE
+    SYNTAX      InterfaceIndex
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface.  It
+            is recommended that values are assigned contiguously
+            starting from 1.  The value for each interface sub-layer
+            must remain constant at least from one re-initialization of
+            the entity's network management system to the next re-
+            initialization."
+    ::= { ifEntry 1 }
+
+ifDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual string containing information about the
+            interface.  This string should include the name of the
+            manufacturer, the product name and the version of the
+            interface hardware/software."
+    ::= { ifEntry 2 }
+
+ifType OBJECT-TYPE
+    SYNTAX      IANAifType
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The type of interface.  Additional values for ifType are
+            assigned by the Internet Assigned Numbers Authority (IANA),
+            through updating the syntax of the IANAifType textual
+            convention."
+    ::= { ifEntry 3 }
+
+ifMtu OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The size of the largest packet which can be sent/received
+            on the interface, specified in octets.  For interfaces that
+            are used for transmitting network datagrams, this is the
+            size of the largest network datagram that can be sent on the
+            interface."
+    ::= { ifEntry 4 }
+
+ifSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in bits
+            per second.  For interfaces which do not vary in bandwidth
+            or for those where no accurate estimation can be made, this
+            object should contain the nominal bandwidth.  If the
+            bandwidth of the interface is greater than the maximum value
+            reportable by this object then this object should report its
+            maximum value (4,294,967,295) and ifHighSpeed must be used
+            to report the interace's speed.  For a sub-layer which has
+            no concept of bandwidth, this object should be zero."
+    ::= { ifEntry 5 }
+
+ifPhysAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The interface's address at its protocol sub-layer.  For
+            example, for an 802.x interface, this object normally
+            contains a MAC address.  The interface's media-specific MIB
+            must define the bit and byte ordering and the format of the
+            value of this object.  For interfaces which do not have such
+            an address (e.g., a serial line), this object should contain
+            an octet string of zero length."
+    ::= { ifEntry 6 }
+
+ifAdminStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),       -- ready to pass packets
+                down(2),
+                testing(3)   -- in some test mode
+            }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The desired state of the interface.  The testing(3) state
+            indicates that no operational packets can be passed.  When a
+            managed system initializes, all interfaces start with
+            ifAdminStatus in the down(2) state.  As a result of either
+            explicit management action or per configuration information
+            retained by the managed system, ifAdminStatus is then
+            changed to either the up(1) or testing(3) states (or remains
+            in the down(2) state)."
+    ::= { ifEntry 7 }
+
+ifOperStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),        -- ready to pass packets
+                down(2),
+                testing(3),   -- in some test mode
+                unknown(4),   -- status can not be determined
+                              -- for some reason.
+                dormant(5),
+                notPresent(6),    -- some component is missing
+                lowerLayerDown(7) -- down due to state of
+                                  -- lower-layer interface(s)
+            }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The current operational state of the interface.  The
+            testing(3) state indicates that no operational packets can
+            be passed.  If ifAdminStatus is down(2) then ifOperStatus
+            should be down(2).  If ifAdminStatus is changed to up(1)
+            then ifOperStatus should change to up(1) if the interface is
+            ready to transmit and receive network traffic; it should
+            change to dormant(5) if the interface is waiting for
+            external actions (such as a serial line waiting for an
+            incoming connection); it should remain in the down(2) state
+            if and only if there is a fault that prevents it from going
+            to the up(1) state; it should remain in the notPresent(6)
+            state if the interface has missing (typically, hardware)
+            components."
+    ::= { ifEntry 8 }
+
+ifLastChange OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time the interface entered
+            its current operational state.  If the current state was
+            entered prior to the last re-initialization of the local
+            network management subsystem, then this object contains a
+            zero value."
+    ::= { ifEntry 9 }
+
+ifInOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 10 }
+
+ifInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 11 }
+
+ifInNUcastPkts OBJECT-TYPE
+    SYNTAX  Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast or
+            broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifInMulticastPkts and
+            ifInBroadcastPkts."
+    ::= { ifEntry 12 }
+
+ifInDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of inbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+
+            their being deliverable to a higher-layer protocol.  One
+            possible reason for discarding such a packet could be to
+            free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 13 }
+
+ifInErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of inbound
+            packets that contained errors preventing them from being
+            deliverable to a higher-layer protocol.  For character-
+            oriented or fixed-length interfaces, the number of inbound
+            transmission units that contained errors preventing them
+            from being deliverable to a higher-layer protocol.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 14 }
+
+ifInUnknownProtos OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of packets
+            received via the interface which were discarded because of
+            an unknown or unsupported protocol.  For character-oriented
+            or fixed-length interfaces that support protocol
+            multiplexing the number of transmission units received via
+            the interface which were discarded because of an unknown or
+            unsupported protocol.  For any interface that does not
+            support protocol multiplexing, this counter will always be
+            0.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 15 }
+
+ifOutOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 16 }
+
+ifOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 17 }
+
+ifOutNUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifOutMulticastPkts
+            and ifOutBroadcastPkts."
+    ::= { ifEntry 18 }
+
+ifOutDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of outbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+            their being transmitted.  One possible reason for discarding
+            such a packet could be to free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 19 }
+
+ifOutErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of outbound
+            packets that could not be transmitted because of errors.
+            For character-oriented or fixed-length interfaces, the
+            number of outbound transmission units that could not be
+            transmitted because of errors.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 20 }
+
+ifOutQLen OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The length of the output packet queue (in packets)."
+    ::= { ifEntry 21 }
+
+ifSpecific OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "A reference to MIB definitions specific to the particular
+            media being used to realize the interface.  It is
+
+            recommended that this value point to an instance of a MIB
+            object in the media-specific MIB, i.e., that this object
+            have the semantics associated with the InstancePointer
+            textual convention defined in RFC 2579.  In fact, it is
+            recommended that the media-specific MIB specify what value
+            ifSpecific should/can take for values of ifType.  If no MIB
+            definitions specific to the particular media are available,
+            the value should be set to the OBJECT IDENTIFIER { 0 0 }."
+    ::= { ifEntry 22 }
+
+--
+--   Extension to the interface table
+--
+-- This table replaces the ifExtnsTable table.
+--
+
+ifXTable        OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber.  This table contains
+            additional objects for the interface table."
+    ::= { ifMIBObjects 1 }
+
+ifXEntry        OBJECT-TYPE
+    SYNTAX      IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing additional management information
+            applicable to a particular interface."
+    AUGMENTS    { ifEntry }
+    ::= { ifXTable 1 }
+
+IfXEntry ::=
+    SEQUENCE {
+        ifName                  DisplayString,
+        ifInMulticastPkts       Counter32,
+        ifInBroadcastPkts       Counter32,
+        ifOutMulticastPkts      Counter32,
+        ifOutBroadcastPkts      Counter32,
+        ifHCInOctets            Counter64,
+        ifHCInUcastPkts         Counter64,
+        ifHCInMulticastPkts     Counter64,
+        ifHCInBroadcastPkts     Counter64,
+        ifHCOutOctets           Counter64,
+        ifHCOutUcastPkts        Counter64,
+        ifHCOutMulticastPkts    Counter64,
+        ifHCOutBroadcastPkts    Counter64,
+        ifLinkUpDownTrapEnable  INTEGER,
+        ifHighSpeed             Gauge32,
+        ifPromiscuousMode       TruthValue,
+        ifConnectorPresent      TruthValue,
+        ifAlias                 DisplayString,
+        ifCounterDiscontinuityTime TimeStamp
+    }
+
+ifName OBJECT-TYPE
+    SYNTAX      DisplayString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The textual name of the interface.  The value of this
+            object should be the name of the interface as assigned by
+            the local device and should be suitable for use in commands
+            entered at the device's `console'.  This might be a text
+            name, such as `le0' or a simple port number, such as `1',
+            depending on the interface naming syntax of the device.  If
+            several entries in the ifTable together represent a single
+            interface as named by the device, then each will have the
+            same value of ifName.  Note that for an agent which responds
+            to SNMP queries concerning an interface on some other
+            (proxied) device, then the value of ifName for such an
+            interface is the proxied device's local name for it.
+
+            If there is no local name, or this object is otherwise not
+            applicable, then this object contains a zero-length string."
+    ::= { ifXEntry 1 }
+
+ifInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 2 }
+
+ifInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 3 }
+
+ifOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 4 }
+
+ifOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 5 }
+
+--
+-- High Capacity Counter objects.  These objects are all
+-- 64 bit versions of the "basic" ifTable counters.  These
+-- objects all have the same basic semantics as their 32-bit
+-- counterparts, however, their syntax has been extended
+-- to 64 bits.
+--
+
+ifHCInOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.  This object is a 64-bit
+            version of ifInOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 6 }
+
+ifHCInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.  This object is a
+            64-bit version of ifInUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 7 }
+
+ifHCInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifInMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 8 }
+
+ifHCInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.  This object is a 64-bit version
+            of ifInBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 9 }
+
+ifHCOutOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.  This object is a
+            64-bit version of ifOutOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 10 }
+
+ifHCOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.  This object is a
+            64-bit version of ifOutUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 11 }
+
+ifHCOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifOutMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 12 }
+
+ifHCOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.  This object is a 64-bit version
+            of ifOutBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 13 }
+
+ifLinkUpDownTrapEnable  OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether linkUp/linkDown traps should be generated
+            for this interface.
+
+            By default, this object should have the value enabled(1) for
+            interfaces which do not operate on 'top' of any other
+            interface (as defined in the ifStackTable), and disabled(2)
+            otherwise."
+    ::= { ifXEntry 14 }
+
+ifHighSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in units
+            of 1,000,000 bits per second.  If this object reports a
+            value of `n' then the speed of the interface is somewhere in
+            the range of `n-500,000' to `n+499,999'.  For interfaces
+            which do not vary in bandwidth or for those where no
+            accurate estimation can be made, this object should contain
+            the nominal bandwidth.  For a sub-layer which has no concept
+            of bandwidth, this object should be zero."
+    ::= { ifXEntry 15 }
+
+ifPromiscuousMode  OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object has a value of false(2) if this interface only
+            accepts packets/frames that are addressed to this station.
+            This object has a value of true(1) when the station accepts
+            all packets/frames transmitted on the media.  The value
+            true(1) is only legal on certain types of media.  If legal,
+            setting this object to a value of true(1) may require the
+            interface to be reset before becoming effective.
+
+            The value of ifPromiscuousMode does not affect the reception
+            of broadcast and multicast packets/frames by the interface."
+    ::= { ifXEntry 16 }
+
+ifConnectorPresent   OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "This object has the value 'true(1)' if the interface
+            sublayer has a physical connector and the value 'false(2)'
+            otherwise."
+    ::= { ifXEntry 17 }
+
+ifAlias   OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE(0..64))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object is an 'alias' name for the interface as
+            specified by a network manager, and provides a non-volatile
+            'handle' for the interface.
+
+            On the first instantiation of an interface, the value of
+            ifAlias associated with that interface is the zero-length
+            string.  As and when a value is written into an instance of
+            ifAlias through a network management set operation, then the
+            agent must retain the supplied value in the ifAlias instance
+            associated with the same interface for as long as that
+            interface remains instantiated, including across all re-
+            initializations/reboots of the network management system,
+            including those which result in a change of the interface's
+            ifIndex value.
+
+            An example of the value which a network manager might store
+            in this object for a WAN interface is the (Telco's) circuit
+            number/identifier of the interface.
+
+            Some agents may support write-access only for interfaces
+            having particular values of ifType.  An agent which supports
+            write access to this object is required to keep the value in
+            non-volatile storage, but it may limit the length of new
+            values depending on how much storage is already occupied by
+            the current values for other interfaces."
+    ::= { ifXEntry 18 }
+
+ifCounterDiscontinuityTime OBJECT-TYPE
+    SYNTAX      TimeStamp
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime on the most recent occasion at which
+            any one or more of this interface's counters suffered a
+            discontinuity.  The relevant counters are the specific
+            instances associated with this interface of any Counter32 or
+
+            Counter64 object contained in the ifTable or ifXTable.  If
+            no such discontinuities have occurred since the last re-
+            initialization of the local management subsystem, then this
+            object contains a zero value."
+    ::= { ifXEntry 19 }
+
+--           The Interface Stack Group
+--
+-- Implementation of this group is optional, but strongly recommended
+-- for all systems
+--
+
+ifStackTable  OBJECT-TYPE
+     SYNTAX        SEQUENCE OF IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The table containing information on the relationships
+            between the multiple sub-layers of network interfaces.  In
+            particular, it contains information on which sub-layers run
+            'on top of' which other sub-layers, where each sub-layer
+            corresponds to a conceptual row in the ifTable.  For
+            example, when the sub-layer with ifIndex value x runs over
+            the sub-layer with ifIndex value y, then this table
+            contains:
+
+              ifStackStatus.x.y=active
+
+            For each ifIndex value, I, which identifies an active
+            interface, there are always at least two instantiated rows
+            in this table associated with I.  For one of these rows, I
+            is the value of ifStackHigherLayer; for the other, I is the
+            value of ifStackLowerLayer.  (If I is not involved in
+            multiplexing, then these are the only two rows associated
+            with I.)
+
+            For example, two rows exist even for an interface which has
+            no others stacked on top or below it:
+
+              ifStackStatus.0.x=active
+              ifStackStatus.x.0=active "
+     ::= { ifMIBObjects 2 }
+
+ifStackEntry  OBJECT-TYPE
+     SYNTAX        IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "Information on a particular relationship between two sub-
+            layers, specifying that one sub-layer runs on 'top' of the
+            other sub-layer.  Each sub-layer corresponds to a conceptual
+            row in the ifTable."
+     INDEX { ifStackHigherLayer, ifStackLowerLayer }
+     ::= { ifStackTable 1 }
+
+IfStackEntry ::=
+    SEQUENCE {
+        ifStackHigherLayer  InterfaceIndexOrZero,
+        ifStackLowerLayer   InterfaceIndexOrZero,
+        ifStackStatus       RowStatus
+     }
+
+ifStackHigherLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the higher sub-layer
+            of the relationship, i.e., the sub-layer which runs on 'top'
+            of the sub-layer identified by the corresponding instance of
+            ifStackLowerLayer.  If there is no higher sub-layer (below
+            the internetwork layer), then this object has the value 0."
+     ::= { ifStackEntry 1 }
+
+ifStackLowerLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the lower sub-layer
+            of the relationship, i.e., the sub-layer which runs 'below'
+            the sub-layer identified by the corresponding instance of
+            ifStackHigherLayer.  If there is no lower sub-layer, then
+            this object has the value 0."
+     ::= { ifStackEntry 2 }
+
+ifStackStatus  OBJECT-TYPE
+    SYNTAX         RowStatus
+    MAX-ACCESS     read-create
+    STATUS         current
+    DESCRIPTION
+            "The status of the relationship between two sub-layers.
+
+            Changing the value of this object from 'active' to
+            'notInService' or 'destroy' will likely have consequences up
+            and down the interface stack.  Thus, write access to this
+            object is likely to be inappropriate for some types of
+            interfaces, and many implementations will choose not to
+            support write-access for any type of interface."
+    ::= { ifStackEntry 3 }
+
+ifStackLastChange OBJECT-TYPE
+    SYNTAX         TimeTicks
+    MAX-ACCESS     read-only
+    STATUS         current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last change of
+            the (whole) interface stack.  A change of the interface
+            stack is defined to be any creation, deletion, or change in
+            value of any instance of ifStackStatus.  If the interface
+            stack has been unchanged since the last re-initialization of
+            the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 6 }
+
+--   Generic Receive Address Table
+--
+-- This group of objects is mandatory for all types of
+-- interfaces which can receive packets/frames addressed to
+-- more than one address.
+--
+-- This table replaces the ifExtnsRcvAddr table.  The main
+-- difference is that this table makes use of the RowStatus
+-- textual convention, while ifExtnsRcvAddr did not.
+
+ifRcvAddressTable  OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "This table contains an entry for each address (broadcast,
+            multicast, or uni-cast) for which the system will receive
+            packets/frames on a particular interface, except as follows:
+
+            - for an interface operating in promiscuous mode, entries
+            are only required for those addresses for which the system
+            would receive frames were it not operating in promiscuous
+            mode.
+
+            - for 802.5 functional addresses, only one entry is
+            required, for the address which has the functional address
+            bit ANDed with the bit mask of all functional addresses for
+            which the interface will accept frames.
+
+            A system is normally able to use any unicast address which
+            corresponds to an entry in this table as a source address."
+    ::= { ifMIBObjects 4 }
+
+ifRcvAddressEntry  OBJECT-TYPE
+    SYNTAX      IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of objects identifying an address for which the
+            system will accept packets/frames on the particular
+            interface identified by the index value ifIndex."
+    INDEX  { ifIndex, ifRcvAddressAddress }
+    ::= { ifRcvAddressTable 1 }
+
+IfRcvAddressEntry ::=
+    SEQUENCE {
+        ifRcvAddressAddress   PhysAddress,
+        ifRcvAddressStatus    RowStatus,
+        ifRcvAddressType      INTEGER
+    }
+
+ifRcvAddressAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An address for which the system will accept packets/frames
+            on this entry's interface."
+    ::= { ifRcvAddressEntry 1 }
+
+ifRcvAddressStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object is used to create and delete rows in the
+            ifRcvAddressTable."
+    ::= { ifRcvAddressEntry 2 }
+
+ifRcvAddressType OBJECT-TYPE
+    SYNTAX      INTEGER {
+
+                    other(1),
+                    volatile(2),
+                    nonVolatile(3)
+                }
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object has the value nonVolatile(3) for those entries
+            in the table which are valid and will not be deleted by the
+            next restart of the managed system.  Entries having the
+            value volatile(2) are valid and exist, but have not been
+            saved, so that will not exist after the next restart of the
+            managed system.  Entries having the value other(1) are valid
+            and exist but are not classified as to whether they will
+            continue to exist after the next restart."
+    DEFVAL  { volatile }
+    ::= { ifRcvAddressEntry 3 }
+
+-- definition of interface-related traps.
+
+linkDown NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkDown trap signifies that the SNMP entity, acting in
+            an agent role, has detected that the ifOperStatus object for
+            one of its communication links is about to enter the down
+            state from some other state (but not from the notPresent
+            state).  This other state is indicated by the included value
+            of ifOperStatus."
+    ::= { snmpTraps 3 }
+
+linkUp NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkUp trap signifies that the SNMP entity, acting in an
+            agent role, has detected that the ifOperStatus object for
+            one of its communication links left the down state and
+            transitioned into some other state (but not into the
+            notPresent state).  This other state is indicated by the
+            included value of ifOperStatus."
+    ::= { snmpTraps 4 }
+
+-- conformance information
+
+ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
+
+ifGroups      OBJECT IDENTIFIER ::= { ifConformance 1 }
+ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
+
+-- compliance statements
+
+ifCompliance3 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which have
+            network interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup,
+                           linkUpDownNotificationsGroup }
+
+-- The groups:
+--        ifFixedLengthGroup
+--        ifHCFixedLengthGroup
+--        ifPacketGroup
+--        ifHCPacketGroup
+--        ifVHCPacketGroup
+-- are mutually exclusive; at most one of these groups is implemented
+-- for a particular interface.  When any of these groups is implemented
+-- for a particular interface, then ifCounterDiscontinuityGroup must
+-- also be implemented for that interface.
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are packet-oriented, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second but less than or equal to 650,000,000
+            bits/second."
+
+        GROUP       ifVHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifCounterDiscontinuityGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces that
+            are required to maintain counters (i.e., those for which one
+            of the ifFixedLengthGroup, ifHCFixedLengthGroup,
+            ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
+            mandatory)."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 3 }
+
+-- units of conformance
+
+ifGeneralInformationGroup    OBJECT-GROUP
+    OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName, ifNumber, ifAlias,
+              ifTableLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information applicable to
+            all network interfaces."
+    ::= { ifGroups 10 }
+
+-- the following five groups are mutually exclusive; at most
+-- one of these groups is implemented for any interface
+
+ifFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) character-oriented or fixed-length-transmission
+            network interfaces."
+    ::= { ifGroups 2 }
+
+ifHCFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second) character-
+            oriented or fixed-length-transmission network interfaces."
+    ::= { ifGroups 3 }
+
+ifPacketGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) packet-oriented network interfaces."
+    ::= { ifGroups 4 }
+
+ifHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second but less
+            than or equal to 650,000,000 bits/second) packet-oriented
+            network interfaces."
+    ::= { ifGroups 5 }
+
+ifVHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
+              ifHCInBroadcastPkts, ifHCOutUcastPkts,
+              ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
+              ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            higher speed (greater than 650,000,000 bits/second) packet-
+            oriented network interfaces."
+    ::= { ifGroups 6 }
+
+ifRcvAddressGroup    OBJECT-GROUP
+    OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            multiple addresses which an interface receives."
+    ::= { ifGroups 7 }
+
+ifStackGroup2    OBJECT-GROUP
+    OBJECTS { ifStackStatus, ifStackLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            layering of MIB-II interfaces."
+    ::= { ifGroups 11 }
+
+ifCounterDiscontinuityGroup  OBJECT-GROUP
+    OBJECTS { ifCounterDiscontinuityTime }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            interface counter discontinuities."
+    ::= { ifGroups 13 }
+
+linkUpDownNotificationsGroup  NOTIFICATION-GROUP
+    NOTIFICATIONS { linkUp, linkDown }
+    STATUS  current
+    DESCRIPTION
+            "The notifications which indicate specific changes in the
+            value of ifOperStatus."
+    ::= { ifGroups 14 }
+
+-- Deprecated Definitions - Objects
+
+--
+--    The Interface Test Table
+--
+-- This group of objects is optional.  However, a media-specific
+
+-- MIB may make implementation of this group mandatory.
+--
+-- This table replaces the ifExtnsTestTable
+--
+
+ifTestTable   OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfTestEntry
+    MAX-ACCESS  not-accessible
+    STATUS      deprecated
+    DESCRIPTION
+            "This table contains one entry per interface.  It defines
+            objects which allow a network manager to instruct an agent
+            to test an interface for various faults.  Tests for an
+            interface are defined in the media-specific MIB for that
+            interface.  After invoking a test, the object ifTestResult
+            can be read to determine the outcome.  If an agent can not
+            perform the test, ifTestResult is set to so indicate.  The
+            object ifTestCode can be used to provide further test-
+            specific or interface-specific (or even enterprise-specific)
+            information concerning the outcome of the test.  Only one
+            test can be in progress on each interface at any one time.
+            If one test is in progress when another test is invoked, the
+            second test is rejected.  Some agents may reject a test when
+            a prior test is active on another interface.
+
+            Before starting a test, a manager-station must first obtain
+            'ownership' of the entry in the ifTestTable for the
+            interface to be tested.  This is accomplished with the
+            ifTestId and ifTestStatus objects as follows:
+
+          try_again:
+              get (ifTestId, ifTestStatus)
+              while (ifTestStatus != notInUse)
+                  /*
+                   * Loop while a test is running or some other
+                   * manager is configuring a test.
+                   */
+                  short delay
+                  get (ifTestId, ifTestStatus)
+              }
+
+              /*
+               * Is not being used right now -- let's compete
+               * to see who gets it.
+               */
+              lock_value = ifTestId
+
+              if ( set(ifTestId = lock_value, ifTestStatus = inUse,
+                       ifTestOwner = 'my-IP-address') == FAILURE)
+                  /*
+                   * Another manager got the ifTestEntry -- go
+                   * try again
+                   */
+                  goto try_again;
+
+              /*
+               * I have the lock
+               */
+              set up any test parameters.
+
+              /*
+               * This starts the test
+               */
+              set(ifTestType = test_to_run);
+
+              wait for test completion by polling ifTestResult
+
+              when test completes, agent sets ifTestResult
+                   agent also sets ifTestStatus = 'notInUse'
+
+              retrieve any additional test results, and ifTestId
+
+              if (ifTestId == lock_value+1) results are valid
+
+            A manager station first retrieves the value of the
+            appropriate ifTestId and ifTestStatus objects, periodically
+            repeating the retrieval if necessary, until the value of
+            ifTestStatus is 'notInUse'.  The manager station then tries
+            to set the same ifTestId object to the value it just
+            retrieved, the same ifTestStatus object to 'inUse', and the
+            corresponding ifTestOwner object to a value indicating
+            itself.  If the set operation succeeds then the manager has
+            obtained ownership of the ifTestEntry, and the value of the
+            ifTestId object is incremented by the agent (per the
+            semantics of TestAndIncr).  Failure of the set operation
+            indicates that some other manager has obtained ownership of
+            the ifTestEntry.
+
+            Once ownership is obtained, any test parameters can be
+            setup, and then the test is initiated by setting ifTestType.
+            On completion of the test, the agent sets ifTestStatus to
+            'notInUse'.  Once this occurs, the manager can retrieve the
+            results.  In the (rare) event that the invocation of tests
+            by two network managers were to overlap, then there would be
+            a possibility that the first test's results might be
+            overwritten by the second test's results prior to the first
+
+            results being read.  This unlikely circumstance can be
+            detected by a network manager retrieving ifTestId at the
+            same time as retrieving the test results, and ensuring that
+            the results are for the desired request.
+
+            If ifTestType is not set within an abnormally long period of
+            time after ownership is obtained, the agent should time-out
+            the manager, and reset the value of the ifTestStatus object
+            back to 'notInUse'.  It is suggested that this time-out
+            period be 5 minutes.
+
+            In general, a management station must not retransmit a
+            request to invoke a test for which it does not receive a
+            response; instead, it properly inspects an agent's MIB to
+            determine if the invocation was successful.  Only if the
+            invocation was unsuccessful, is the invocation request
+            retransmitted.
+
+            Some tests may require the interface to be taken off-line in
+            order to execute them, or may even require the agent to
+            reboot after completion of the test.  In these
+            circumstances, communication with the management station
+            invoking the test may be lost until after completion of the
+            test.  An agent is not required to support such tests.
+            However, if such tests are supported, then the agent should
+            make every effort to transmit a response to the request
+            which invoked the test prior to losing communication.  When
+            the agent is restored to normal service, the results of the
+            test are properly made available in the appropriate objects.
+            Note that this requires that the ifIndex value assigned to
+            an interface must be unchanged even if the test causes a
+            reboot.  An agent must reject any test for which it cannot,
+            perhaps due to resource constraints, make available at least
+            the minimum amount of information after that test
+            completes."
+    ::= { ifMIBObjects 3 }
+
+ifTestEntry OBJECT-TYPE
+    SYNTAX       IfTestEntry
+    MAX-ACCESS   not-accessible
+    STATUS       deprecated
+    DESCRIPTION
+            "An entry containing objects for invoking tests on an
+            interface."
+    AUGMENTS  { ifEntry }
+    ::= { ifTestTable 1 }
+
+IfTestEntry ::=
+
+    SEQUENCE {
+        ifTestId           TestAndIncr,
+        ifTestStatus       INTEGER,
+        ifTestType         AutonomousType,
+        ifTestResult       INTEGER,
+        ifTestCode         OBJECT IDENTIFIER,
+        ifTestOwner        OwnerString
+    }
+
+ifTestId         OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object identifies the current invocation of the
+            interface's test."
+    ::= { ifTestEntry 1 }
+
+ifTestStatus     OBJECT-TYPE
+    SYNTAX       INTEGER { notInUse(1), inUse(2) }
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object indicates whether or not some manager currently
+            has the necessary 'ownership' required to invoke a test on
+            this interface.  A write to this object is only successful
+            when it changes its value from 'notInUse(1)' to 'inUse(2)'.
+            After completion of a test, the agent resets the value back
+            to 'notInUse(1)'."
+    ::= { ifTestEntry 2 }
+
+ifTestType       OBJECT-TYPE
+    SYNTAX       AutonomousType
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "A control variable used to start and stop operator-
+            initiated interface tests.  Most OBJECT IDENTIFIER values
+            assigned to tests are defined elsewhere, in association with
+            specific types of interface.  However, this document assigns
+            a value for a full-duplex loopback test, and defines the
+            special meanings of the subject identifier:
+
+                noTest  OBJECT IDENTIFIER ::= { 0 0 }
+
+            When the value noTest is written to this object, no action
+            is taken unless a test is in progress, in which case the
+            test is aborted.  Writing any other value to this object is
+
+            only valid when no test is currently in progress, in which
+            case the indicated test is initiated.
+
+            When read, this object always returns the most recent value
+            that ifTestType was set to.  If it has not been set since
+            the last initialization of the network management subsystem
+            on the agent, a value of noTest is returned."
+    ::= { ifTestEntry 3 }
+
+ifTestResult  OBJECT-TYPE
+    SYNTAX       INTEGER {
+                     none(1),          -- no test yet requested
+                     success(2),
+                     inProgress(3),
+                     notSupported(4),
+                     unAbleToRun(5),   -- due to state of system
+                     aborted(6),
+                     failed(7)
+                 }
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains the result of the most recently
+            requested test, or the value none(1) if no tests have been
+            requested since the last reset.  Note that this facility
+            provides no provision for saving the results of one test
+            when starting another, as could be required if used by
+            multiple managers concurrently."
+    ::= { ifTestEntry 4 }
+
+ifTestCode  OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains a code which contains more specific
+            information on the test result, for example an error-code
+            after a failed test.  Error codes and other values this
+            object may take are specific to the type of interface and/or
+            test.  The value may have the semantics of either the
+            AutonomousType or InstancePointer textual conventions as
+            defined in RFC 2579.  The identifier:
+
+                testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
+
+            is defined for use if no additional result code is
+            available."
+    ::= { ifTestEntry 5 }
+
+ifTestOwner      OBJECT-TYPE
+    SYNTAX       OwnerString
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "The entity which currently has the 'ownership' required to
+            invoke a test on this interface."
+    ::= { ifTestEntry 6 }
+
+-- Deprecated Definitions - Groups
+
+ifGeneralGroup    OBJECT-GROUP
+    OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects deprecated in favour of
+            ifGeneralInformationGroup."
+    ::= { ifGroups 1 }
+
+ifTestGroup    OBJECT-GROUP
+    OBJECTS { ifTestId, ifTestStatus, ifTestType,
+              ifTestResult, ifTestCode, ifTestOwner }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects providing the ability to invoke
+            tests on an interface."
+    ::= { ifGroups 8 }
+
+ifStackGroup    OBJECT-GROUP
+    OBJECTS { ifStackStatus }
+    STATUS  deprecated
+    DESCRIPTION
+            "The previous collection of objects providing information on
+            the layering of MIB-II interfaces."
+    ::= { ifGroups 9 }
+
+ifOldObjectsGroup    OBJECT-GROUP
+    OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
+              ifOutQLen, ifSpecific }
+    STATUS  deprecated
+    DESCRIPTION
+            "The collection of objects deprecated from the original MIB-
+            II interfaces group."
+    ::= { ifGroups 12 }
+
+-- Deprecated Definitions - Compliance
+
+ifCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifTestGroup
+        DESCRIPTION
+            "This group is optional.  Media-specific MIBs which require
+            interface tests are strongly encouraged to use this group
+            for invoking tests and reporting results.  A medium specific
+            MIB which has mandatory tests may make implementation of
+
+            this group mandatory."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+    ::= { ifCompliances 1 }
+
+ifCompliance2 MODULE-COMPLIANCE
+    STATUS      deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2,
+                           ifCounterDiscontinuityGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 2 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..a778cba6b74249f5a1a731f1437f905946bb1f48
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt
@@ -0,0 +1,402 @@
+INET-ADDRESS-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, mib-2, Unsigned32 FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                 FROM SNMPv2-TC;
+
+inetAddressMIB MODULE-IDENTITY
+    LAST-UPDATED "200502040000Z"
+    ORGANIZATION
+        "IETF Operations and Management Area"
+    CONTACT-INFO
+        "Juergen Schoenwaelder (Editor)
+         International University Bremen
+         P.O. Box 750 561
+         28725 Bremen, Germany
+
+         Phone: +49 421 200-3587
+         EMail: j.schoenwaelder@iu-bremen.de
+
+         Send comments to <ietfmibs@ops.ietf.org>."
+    DESCRIPTION
+        "This MIB module defines textual conventions for
+         representing Internet addresses.  An Internet
+         address can be an IPv4 address, an IPv6 address,
+         or a DNS domain name.  This module also defines
+         textual conventions for Internet port numbers,
+         autonomous system numbers, and the length of an
+         Internet address prefix.
+
+         Copyright (C) The Internet Society (2005).  This version
+         of this MIB module is part of RFC 4001, see the RFC
+         itself for full legal notices."
+    REVISION     "200502040000Z"
+    DESCRIPTION
+        "Third version, published as RFC 4001.  This revision
+         introduces the InetZoneIndex, InetScopeType, and
+         InetVersion textual conventions."
+    REVISION     "200205090000Z"
+    DESCRIPTION
+        "Second version, published as RFC 3291.  This
+         revision contains several clarifications and
+         introduces several new textual conventions:
+         InetAddressPrefixLength, InetPortNumber,
+         InetAutonomousSystemNumber, InetAddressIPv4z,
+         and InetAddressIPv6z."
+    REVISION     "200006080000Z"
+    DESCRIPTION
+        "Initial version, published as RFC 2851."
+    ::= { mib-2 76 }
+
+InetAddressType ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "A value that represents a type of Internet address.
+
+         unknown(0)  An unknown address type.  This value MUST
+                     be used if the value of the corresponding
+                     InetAddress object is a zero-length string.
+                     It may also be used to indicate an IP address
+                     that is not in one of the formats defined
+                     below.
+
+         ipv4(1)     An IPv4 address as defined by the
+                     InetAddressIPv4 textual convention.
+
+         ipv6(2)     An IPv6 address as defined by the
+                     InetAddressIPv6 textual convention.
+
+         ipv4z(3)    A non-global IPv4 address including a zone
+                     index as defined by the InetAddressIPv4z
+                     textual convention.
+
+         ipv6z(4)    A non-global IPv6 address including a zone
+                     index as defined by the InetAddressIPv6z
+                     textual convention.
+
+         dns(16)     A DNS domain name as defined by the
+                     InetAddressDNS textual convention.
+
+         Each definition of a concrete InetAddressType value must be
+         accompanied by a definition of a textual convention for use
+         with that InetAddressType.
+
+         To support future extensions, the InetAddressType textual
+         convention SHOULD NOT be sub-typed in object type definitions.
+         It MAY be sub-typed in compliance statements in order to
+         require only a subset of these address types for a compliant
+         implementation.
+
+         Implementations must ensure that InetAddressType objects
+         and any dependent objects (e.g., InetAddress objects) are
+         consistent.  An inconsistentValue error must be generated
+         if an attempt to change an InetAddressType object would,
+         for example, lead to an undefined InetAddress value.  In
+
+         particular, InetAddressType/InetAddress pairs must be
+         changed together if the address type changes (e.g., from
+         ipv6(2) to ipv4(1))."
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2),
+                     ipv4z(3),
+                     ipv6z(4),
+                     dns(16)
+                 }
+
+InetAddress ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "Denotes a generic Internet address.
+
+         An InetAddress value is always interpreted within the context
+         of an InetAddressType value.  Every usage of the InetAddress
+         textual convention is required to specify the InetAddressType
+         object that provides the context.  It is suggested that the
+         InetAddressType object be logically registered before the
+         object(s) that use the InetAddress textual convention, if
+         they appear in the same logical row.
+
+         The value of an InetAddress object must always be
+         consistent with the value of the associated InetAddressType
+         object.  Attempts to set an InetAddress object to a value
+         inconsistent with the associated InetAddressType
+         must fail with an inconsistentValue error.
+
+         When this textual convention is used as the syntax of an
+         index object, there may be issues with the limit of 128
+         sub-identifiers specified in SMIv2, STD 58.  In this case,
+         the object definition MUST include a 'SIZE' clause to
+         limit the number of potential instance sub-identifiers;
+         otherwise the applicable constraints MUST be stated in
+         the appropriate conceptual row DESCRIPTION clauses, or
+         in the surrounding documentation if there is no single
+         DESCRIPTION clause that is appropriate."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+InetAddressIPv4 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv4 network address:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+
+         The corresponding InetAddressType value is ipv4(1).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (4))
+
+InetAddressIPv6 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv6 network address:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+
+         The corresponding InetAddressType value is ipv6(2).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (16))
+
+InetAddressIPv4z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv4 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+            5-8     zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv4z(3).
+
+         The zone index (bytes 5-8) is used to disambiguate identical
+         address values on nodes that have interfaces attached to
+         different zones of the same scope.  The zone index may contain
+         the special value 0, which refers to the default zone for each
+         scope.
+
+         This textual convention SHOULD NOT be used directly in object
+
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (8))
+
+InetAddressIPv6z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv6 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+           17-20    zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv6z(4).
+
+         The zone index (bytes 17-20) is used to disambiguate
+         identical address values on nodes that have interfaces
+         attached to different zones of the same scope.  The zone index
+         may contain the special value 0, which refers to the default
+         zone for each scope.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (20))
+
+InetAddressDNS ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+        "Represents a DNS domain name.  The name SHOULD be fully
+         qualified whenever possible.
+
+         The corresponding InetAddressType is dns(16).
+
+         The DESCRIPTION clause of InetAddress objects that may have
+         InetAddressDNS values MUST fully describe how (and when)
+         these names are to be resolved to IP addresses.
+
+         The resolution of an InetAddressDNS value may require to
+         query multiple DNS records (e.g., A for IPv4 and AAAA for
+         IPv6).  The order of the resolution process and which DNS
+         record takes precedence depends on the configuration of the
+         resolver.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+InetAddressPrefixLength ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Denotes the length of a generic Internet network address
+         prefix.  A value of n corresponds to an IP address mask
+         that has n contiguous 1-bits from the most significant
+         bit (MSB), with all other bits set to 0.
+
+         An InetAddressPrefixLength value is always interpreted within
+         the context of an InetAddressType value.  Every usage of the
+         InetAddressPrefixLength textual convention is required to
+         specify the InetAddressType object that provides the
+         context.  It is suggested that the InetAddressType object be
+         logically registered before the object(s) that use the
+         InetAddressPrefixLength textual convention, if they appear
+         in the same logical row.
+
+         InetAddressPrefixLength values larger than
+         the maximum length of an IP address for a specific
+         InetAddressType are treated as the maximum significant
+         value applicable for the InetAddressType.  The maximum
+         significant value is 32 for the InetAddressType
+         'ipv4(1)' and 'ipv4z(3)' and 128 for the InetAddressType
+         'ipv6(2)' and 'ipv6z(4)'.  The maximum significant value
+         for the InetAddressType 'dns(16)' is 0.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where the Internet network address prefix
+         is unknown or does not apply.
+
+         The upper bound of the prefix length has been chosen to
+         be consistent with the maximum size of an InetAddress."
+    SYNTAX       Unsigned32 (0..2040)
+
+InetPortNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a 16 bit port number of an Internet transport
+
+         layer protocol.  Port numbers are assigned by IANA.  A
+         current list of all assignments is available from
+         <http://www.iana.org/>.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where a port number is unknown, or when the
+         value zero is used as a wildcard in a filter."
+    REFERENCE   "STD 6 (RFC 768), STD 7 (RFC 793) and RFC 2960"
+    SYNTAX       Unsigned32 (0..65535)
+
+InetAutonomousSystemNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an autonomous system number that identifies an
+         Autonomous System (AS).  An AS is a set of routers under a
+         single technical administration, using an interior gateway
+         protocol and common metrics to route packets within the AS,
+         and using an exterior gateway protocol to route packets to
+         other ASes'.  IANA maintains the AS number space and has
+         delegated large parts to the regional registries.
+
+         Autonomous system numbers are currently limited to 16 bits
+         (0..65535).  There is, however, work in progress to enlarge the
+         autonomous system number space to 32 bits.  Therefore, this
+         textual convention uses an Unsigned32 value without a
+         range restriction in order to support a larger autonomous
+         system number space."
+    REFERENCE   "RFC 1771, RFC 1930"
+    SYNTAX       Unsigned32
+
+InetScopeType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+        "Represents a scope type.  This textual convention can be used
+         in cases where a MIB has to represent different scope types
+         and there is no context information, such as an InetAddress
+         object, that implicitly defines the scope type.
+
+         Note that not all possible values have been assigned yet, but
+         they may be assigned in future revisions of this specification.
+         Applications should therefore be able to deal with values
+         not yet assigned."
+    REFERENCE   "RFC 3513"
+    SYNTAX       INTEGER {
+                     -- reserved(0),
+                     interfaceLocal(1),
+                     linkLocal(2),
+                     subnetLocal(3),
+                     adminLocal(4),
+                     siteLocal(5), -- site-local unicast addresses
+                                   -- have been deprecated by RFC 3879
+                     -- unassigned(6),
+                     -- unassigned(7),
+                     organizationLocal(8),
+                     -- unassigned(9),
+                     -- unassigned(10),
+                     -- unassigned(11),
+                     -- unassigned(12),
+                     -- unassigned(13),
+                     global(14)
+                     -- reserved(15)
+                 }
+
+InetZoneIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "A zone index identifies an instance of a zone of a
+         specific scope.
+
+         The zone index MUST disambiguate identical address
+         values.  For link-local addresses, the zone index will
+         typically be the interface index (ifIndex as defined in the
+         IF-MIB) of the interface on which the address is configured.
+
+         The zone index may contain the special value 0, which refers
+         to the default zone.  The default zone may be used in cases
+         where the valid zone index is not known (e.g., when a
+         management application has to write a link-local IPv6
+         address without knowing the interface index value).  The
+         default zone SHOULD NOT be used as an easy way out in
+         cases where the zone index for a non-global IPv6 address
+         is known."
+    REFERENCE   "RFC4007"
+    SYNTAX       Unsigned32
+
+InetVersion ::= TEXTUAL-CONVENTION
+    STATUS  current
+    DESCRIPTION
+        "A value representing a version of the IP protocol.
+
+         unknown(0)  An unknown or unspecified version of the IP
+                     protocol.
+
+         ipv4(1)     The IPv4 protocol as defined in RFC 791 (STD 5).
+
+         ipv6(2)     The IPv6 protocol as defined in RFC 2460.
+
+         Note that this textual convention SHOULD NOT be used to
+         distinguish different address types associated with IP
+         protocols.  The InetAddressType has been designed for this
+         purpose."
+    REFERENCE   "RFC 791, RFC 2460"
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2)
+                 }
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..aa273c2858406630b179ddcc5711bc9f04e56a6a
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
@@ -0,0 +1,526 @@
+SNMP-FRAMEWORK-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE,
+    OBJECT-IDENTITY,
+    snmpModules                           FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                    FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF;
+
+snmpFrameworkMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-EMail:   snmpv3@lists.tislabs.com
+                  Subscribe:  snmpv3-request@lists.tislabs.com
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  EMail:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair &
+                  Co-editor:  David Harrington
+                              Enterasys Networks
+                  postal:     35 Industrial Way
+                              P. O. Box 5005
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  phone:      +1 603-337-2614
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+                  postal:     2141 North First Street
+                              San Jose, California 95131
+                              USA
+                  EMail:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+
+                  EMail:      bwijnen@lucent.com
+                  phone:      +31 348-680-485
+                    "
+       DESCRIPTION  "The SNMP Management Architecture MIB
+
+                     Copyright (C) The Internet Society (2002). This
+                     version of this MIB module is part of RFC 3411;
+                     see the RFC itself for full legal notices.
+                    "
+
+       REVISION     "200210140000Z"         -- 14 October 2002
+       DESCRIPTION  "Changes in this revision:
+                     - Updated various administrative information.
+                     - Corrected some typos.
+                     - Corrected typo in description of SnmpEngineID
+                       that led to range overlap for 127.
+                     - Changed '255a' to '255t' in definition of
+                       SnmpAdminString to align with current SMI.
+                     - Reworded 'reserved' for value zero in
+                       DESCRIPTION of SnmpSecurityModel.
+                     - The algorithm for allocating security models
+                       should give 256 per enterprise block, rather
+                       than 255.
+                     - The example engine ID of 'abcd' is not
+                       legal. Replaced with '800002b804616263'H based
+                       on example enterprise 696, string 'abc'.
+                     - Added clarification that engineID should
+                       persist across re-initializations.
+                     This revision published as RFC 3411.
+                    "
+       REVISION     "199901190000Z"         -- 19 January 1999
+       DESCRIPTION  "Updated editors' addresses, fixed typos.
+                     Published as RFC 2571.
+                    "
+       REVISION     "199711200000Z"         -- 20 November 1997
+       DESCRIPTION  "The initial version, published in RFC 2271.
+                    "
+       ::= { snmpModules 10 }
+
+   -- Textual Conventions used in the SNMP Management Architecture ***
+
+SnmpEngineID ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+                 Objects of this type are for identification, not for
+                 addressing, even though it is possible that an
+                 address may have been used in the generation of
+                 a specific value.
+
+                 The value for this object may not be all zeros or
+                 all 'ff'H or the empty (zero length) string.
+
+                 The initial value for this object may be configured
+                 via an operator console entry or via an algorithmic
+                 function.  In the latter case, the following
+                 example algorithm is recommended.
+
+                 In cases where there are multiple engines on the
+                 same system, the use of this algorithm is NOT
+                 appropriate, as it would result in all of those
+                 engines ending up with the same ID value.
+
+                 1) The very first bit is used to indicate how the
+                    rest of the data is composed.
+
+                    0 - as defined by enterprise using former methods
+                        that existed before SNMPv3. See item 2 below.
+
+                    1 - as defined by this architecture, see item 3
+                        below.
+
+                    Note that this allows existing uses of the
+                    engineID (also known as AgentID [RFC1910]) to
+                    co-exist with any new uses.
+
+                 2) The snmpEngineID has a length of 12 octets.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The remaining eight octets are determined via
+                    one or more enterprise-specific methods. Such
+                    methods must be designed so as to maximize the
+                    possibility that the value of this object will
+                    be unique in the agent's administrative domain.
+                    For example, it may be the IP address of the SNMP
+                    entity, or the MAC address of one of the
+                    interfaces, with each address suitably padded
+                    with random octets.  If multiple methods are
+                    defined, then it is recommended that the first
+                    octet indicate the method being used and the
+                    remaining octets be a function of the method.
+
+                 3) The length of the octet string varies.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The very first bit is set to 1. For example, the
+                    above value for Acme Networks now changes to be
+                    '800002b8'H.
+
+                    The fifth octet indicates how the rest (6th and
+                    following octets) are formatted. The values for
+                    the fifth octet are:
+
+                      0     - reserved, unused.
+
+                      1     - IPv4 address (4 octets)
+                              lowest non-special IP address
+
+                      2     - IPv6 address (16 octets)
+                              lowest non-special IP address
+
+                      3     - MAC address (6 octets)
+                              lowest IEEE MAC address, canonical
+                              order
+
+                      4     - Text, administratively assigned
+                              Maximum remaining length 27
+
+                      5     - Octets, administratively assigned
+                              Maximum remaining length 27
+
+                      6-127 - reserved, unused
+
+                    128-255 - as defined by the enterprise
+                              Maximum remaining length 27
+                "
+    SYNTAX       OCTET STRING (SIZE(5..32))
+
+SnmpSecurityModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a
+                 Security Model of the Security Subsystem within
+                 this SNMP Management Architecture.
+
+                 The values for securityModel are allocated as
+                 follows:
+
+                 - The zero value does not identify any particular
+                   security model.
+
+                 - Values between 1 and 255, inclusive, are reserved
+                   for standards-track Security Models and are
+                   managed by the Internet Assigned Numbers Authority
+                   (IANA).
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Security Models.  An
+                   enterprise-specific securityModel value is defined
+                   to be:
+
+                   enterpriseID * 256 + security model within
+                   enterprise
+
+                   For example, the fourth Security Model defined by
+                   the enterprise whose enterpriseID is 1 would be
+                   259.
+
+                 This scheme for allocation of securityModel
+                 values allows for a maximum of 255 standards-
+                 based Security Models, and for a maximum of
+                 256 Security Models per enterprise.
+
+                 It is believed that the assignment of new
+                 securityModel values will be rare in practice
+                 because the larger the number of simultaneously
+                 utilized Security Models, the larger the
+                 chance that interoperability will suffer.
+                 Consequently, it is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+
+                 securityModels.  This limits the ability to
+                 define new proprietary implementations of Security
+                 Models to the first 8,388,608 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the securityModel value will normally
+                 require only a single byte since, in practice,
+                 the leftmost bits will be zero for most messages
+                 and sign extension is suppressed by the encoding
+                 rules.
+
+                 As of this writing, there are several values
+                 of securityModel defined for use with SNMP or
+                 reserved for use with supporting MIB objects.
+                 They are as follows:
+
+                     0  reserved for 'any'
+                     1  reserved for SNMPv1
+                     2  reserved for SNMPv2c
+                     3  User-Based Security Model (USM)
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpMessageProcessingModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a Message
+                 Processing Model of the Message Processing
+                 Subsystem within this SNMP Management Architecture.
+
+                 The values for messageProcessingModel are
+                 allocated as follows:
+
+                 - Values between 0 and 255, inclusive, are
+                   reserved for standards-track Message Processing
+                   Models and are managed by the Internet Assigned
+                   Numbers Authority (IANA).
+
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Message Processing Models.
+                   An enterprise messageProcessingModel value is
+                   defined to be:
+
+                   enterpriseID * 256 +
+                        messageProcessingModel within enterprise
+
+                   For example, the fourth Message Processing Model
+                   defined by the enterprise whose enterpriseID
+
+                   is 1 would be 259.
+
+                 This scheme for allocating messageProcessingModel
+                 values allows for a maximum of 255 standards-
+                 based Message Processing Models, and for a
+                 maximum of 256 Message Processing Models per
+                 enterprise.
+
+                 It is believed that the assignment of new
+                 messageProcessingModel values will be rare
+                 in practice because the larger the number of
+                 simultaneously utilized Message Processing Models,
+                 the larger the chance that interoperability
+                 will suffer. It is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+                 messageProcessingModels.  This limits the ability
+                 to define new proprietary implementations of
+                 Message Processing Models to the first 8,388,608
+                 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the messageProcessingModel value will
+                 normally require only a single byte since, in
+                 practice, the leftmost bits will be zero for
+                 most messages and sign extension is suppressed
+                 by the encoding rules.
+
+                 As of this writing, there are several values of
+                 messageProcessingModel defined for use with SNMP.
+                 They are as follows:
+
+                     0  reserved for SNMPv1
+                     1  reserved for SNMPv2c
+                     2  reserved for SNMPv2u and SNMPv2*
+                     3  reserved for SNMPv3
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpSecurityLevel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "A Level of Security at which SNMP messages can be
+                 sent or with which operations are being processed;
+                 in particular, one of:
+
+                   noAuthNoPriv - without authentication and
+                                  without privacy,
+                   authNoPriv   - with authentication but
+                                  without privacy,
+                   authPriv     - with authentication and
+                                  with privacy.
+
+                 These three values are ordered such that
+                 noAuthNoPriv is less than authNoPriv and
+                 authNoPriv is less than authPriv.
+                "
+    SYNTAX       INTEGER { noAuthNoPriv(1),
+                           authNoPriv(2),
+                           authPriv(3)
+                         }
+
+SnmpAdminString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION "An octet string containing administrative
+                 information, preferably in human-readable form.
+
+                 To facilitate internationalization, this
+                 information is represented using the ISO/IEC
+                 IS 10646-1 character set, encoded as an octet
+                 string using the UTF-8 transformation format
+                 described in [RFC2279].
+
+                 Since additional code points are added by
+                 amendments to the 10646 standard from time
+                 to time, implementations must be prepared to
+                 encounter any code point from 0x00000000 to
+                 0x7fffffff.  Byte sequences that do not
+                 correspond to the valid UTF-8 encoding of a
+                 code point or are outside this range are
+                 prohibited.
+
+                 The use of control codes should be avoided.
+
+                 When it is necessary to represent a newline,
+                 the control code sequence CR LF should be used.
+
+                 The use of leading or trailing white space should
+                 be avoided.
+
+                 For code points not directly supported by user
+                 interface hardware or software, an alternative
+                 means of entry and display, such as hexadecimal,
+                 may be provided.
+
+                 For information encoded in 7-bit US-ASCII,
+                 the UTF-8 encoding is identical to the
+                 US-ASCII encoding.
+
+                 UTF-8 may require multiple bytes to represent a
+                 single character / code point; thus the length
+                 of this object in octets may be different from
+                 the number of characters encoded.  Similarly,
+                 size constraints refer to the number of encoded
+                 octets, not the number of characters represented
+                 by an encoding.
+
+                 Note that when this TC is used for an object that
+                 is used or envisioned to be used as an index, then
+                 a SIZE restriction MUST be specified so that the
+                 number of sub-identifiers for any object instance
+                 does not exceed the limit of 128, as defined by
+                 [RFC3416].
+
+                 Note that the size of an SnmpAdminString object is
+                 measured in octets, not characters.
+                "
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+-- Administrative assignments ***************************************
+
+snmpFrameworkAdmin
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 1 }
+snmpFrameworkMIBObjects
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 2 }
+snmpFrameworkMIBConformance
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 3 }
+
+-- the snmpEngine Group ********************************************
+
+snmpEngine OBJECT IDENTIFIER ::= { snmpFrameworkMIBObjects 1 }
+
+snmpEngineID     OBJECT-TYPE
+    SYNTAX       SnmpEngineID
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+
+                 This information SHOULD be stored in non-volatile
+                 storage so that it remains constant across
+                 re-initializations of the SNMP engine.
+                "
+    ::= { snmpEngine 1 }
+
+snmpEngineBoots  OBJECT-TYPE
+    SYNTAX       INTEGER (1..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of times that the SNMP engine has
+                 (re-)initialized itself since snmpEngineID
+                 was last configured.
+                "
+    ::= { snmpEngine 2 }
+
+snmpEngineTime   OBJECT-TYPE
+    SYNTAX       INTEGER (0..2147483647)
+    UNITS        "seconds"
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of seconds since the value of
+                 the snmpEngineBoots object last changed.
+                 When incrementing this object's value would
+                 cause it to exceed its maximum,
+                 snmpEngineBoots is incremented as if a
+                 re-initialization had occurred, and this
+                 object's value consequently reverts to zero.
+                "
+    ::= { snmpEngine 3 }
+
+snmpEngineMaxMessageSize OBJECT-TYPE
+    SYNTAX       INTEGER (484..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The maximum length in octets of an SNMP message
+                 which this SNMP engine can send or receive and
+                 process, determined as the minimum of the maximum
+                 message size values supported among all of the
+                 transports available to and supported by the engine.
+                "
+    ::= { snmpEngine 4 }
+
+-- Registration Points for Authentication and Privacy Protocols **
+
+snmpAuthProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track
+                  authentication protocols used in SNMP Management
+                  Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 1 }
+
+snmpPrivProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track privacy
+                  protocols used in SNMP Management Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 2 }
+
+-- Conformance information ******************************************
+
+snmpFrameworkMIBCompliances
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 1}
+snmpFrameworkMIBGroups
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 2}
+
+-- compliance statements
+
+snmpFrameworkMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP Management Framework MIB.
+                "
+    MODULE    -- this module
+        MANDATORY-GROUPS { snmpEngineGroup }
+    ::= { snmpFrameworkMIBCompliances 1 }
+
+-- units of conformance
+
+snmpEngineGroup OBJECT-GROUP
+    OBJECTS {
+              snmpEngineID,
+              snmpEngineBoots,
+              snmpEngineTime,
+              snmpEngineMaxMessageSize
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects for identifying and
+                 determining the configuration and current timeliness
+
+                 values of an SNMP engine.
+                "
+    ::= { snmpFrameworkMIBGroups 1 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..654afdd6941a473b44e10a28ecb5a5ef5937bc6d
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt
@@ -0,0 +1,660 @@
+SNMP-TARGET-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY,
+    OBJECT-TYPE,
+    snmpModules,
+    Counter32,
+    Integer32
+        FROM SNMPv2-SMI
+
+    TEXTUAL-CONVENTION,
+    TDomain,
+    TAddress,
+    TimeInterval,
+    RowStatus,
+    StorageType,
+    TestAndIncr
+        FROM SNMPv2-TC
+
+    SnmpSecurityModel,
+    SnmpMessageProcessingModel,
+    SnmpSecurityLevel,
+    SnmpAdminString
+        FROM SNMP-FRAMEWORK-MIB
+
+    MODULE-COMPLIANCE,
+    OBJECT-GROUP
+        FROM SNMPv2-CONF;
+
+snmpTargetMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+        "WG-email:   snmpv3@lists.tislabs.com
+         Subscribe:  majordomo@lists.tislabs.com
+                     In message body:  subscribe snmpv3
+
+         Co-Chair:   Russ Mundy
+                     Network Associates Laboratories
+         Postal:     15204 Omega Drive, Suite 300
+                     Rockville, MD 20850-4601
+                     USA
+         EMail:      mundy@tislabs.com
+         Phone:      +1 301-947-7107
+
+         Co-Chair:   David Harrington
+                     Enterasys Networks
+         Postal:     35 Industrial Way
+                     P. O. Box 5004
+                     Rochester, New Hampshire 03866-5005
+                     USA
+         EMail:      dbh@enterasys.com
+         Phone:      +1 603-337-2614
+
+         Co-editor:  David B. Levi
+                     Nortel Networks
+         Postal:     3505 Kesterwood Drive
+                     Knoxville, Tennessee 37918
+         EMail:      dlevi@nortelnetworks.com
+         Phone:      +1 865 686 0432
+
+         Co-editor:  Paul Meyer
+                     Secure Computing Corporation
+         Postal:     2675 Long Lake Road
+
+                     Roseville, Minnesota 55113
+         EMail:      paul_meyer@securecomputing.com
+         Phone:      +1 651 628 1592
+
+         Co-editor:  Bob Stewart
+                     Retired"
+    DESCRIPTION
+        "This MIB module defines MIB objects which provide
+         mechanisms to remotely configure the parameters used
+         by an SNMP entity for the generation of SNMP messages.
+
+         Copyright (C) The Internet Society (2002). This
+         version of this MIB module is part of RFC 3413;
+         see the RFC itself for full legal notices.
+        "
+    REVISION    "200210140000Z"             -- 14 October 2002
+    DESCRIPTION "Fixed DISPLAY-HINTS for UTF-8 strings, fixed hex
+                 value of LF characters, clarified meaning of zero
+                 length tag values, improved tag list examples.
+                 Published as RFC 3413."
+    REVISION    "199808040000Z"             -- 4 August 1998
+    DESCRIPTION "Clarifications, published as
+                 RFC 2573."
+    REVISION    "199707140000Z"             -- 14 July 1997
+    DESCRIPTION "The initial revision, published as RFC2273."
+    ::= { snmpModules 12 }
+
+snmpTargetObjects       OBJECT IDENTIFIER ::= { snmpTargetMIB 1 }
+snmpTargetConformance   OBJECT IDENTIFIER ::= { snmpTargetMIB 3 }
+
+SnmpTagValue ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a tag value.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, and certain
+
+         control codes are not allowed as described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         Note that when this TC is used for an object that
+         is used or envisioned to be used as an index, then a
+         SIZE restriction must be specified so that the number
+         of sub-identifiers for any object instance does not
+         exceed the limit of 128, as defined by [RFC1905].
+
+         An object of this type contains a single tag value
+         which is used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+         in a tag list.  An object of this type may only
+         contain a single tag value, and so delimiter
+         characters are not allowed in a value of this type.
+
+         Note that a tag value of 0 length means that no tag is
+         defined.  In other words, a tag value of 0 length would
+         never match anything in a tag list, and would never
+         select any table entries.
+
+         Some examples of valid tag values are:
+
+             - 'acme'
+
+             - 'router'
+
+             - 'host'
+
+         The use of a tag value to select table entries is
+         application and MIB specific."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+SnmpTagList ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a list of tag values.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, except as
+         described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         An object of this type contains a list of tag values
+         which are used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+
+         in a tag list.  Only a single delimiter character may
+         occur between two tag values.  A tag value may not
+         have a zero length.  These constraints imply certain
+         restrictions on the contents of this object:
+
+             - There cannot be a leading or trailing delimiter
+               character.
+
+             - There cannot be multiple adjacent delimiter
+               characters.
+
+         Some examples of valid tag lists are:
+
+             - ''                        -- an empty list
+
+             - 'acme'                    -- list of one tag
+
+             - 'host router bridge'      -- list of several tags
+
+         Note that although a tag value may not have a length of
+         zero, an empty string is still valid.  This indicates
+         an empty list (i.e. there are no tag values in the list).
+
+         The use of the tag list to select table entries is
+         application and MIB specific.  Typically, an application
+         will provide one or more tag values, and any entry
+         which contains some combination of these tag values
+         will be selected."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+--
+--
+-- The snmpTargetObjects group
+--
+--
+
+snmpTargetSpinLock OBJECT-TYPE
+    SYNTAX      TestAndIncr
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+        "This object is used to facilitate modification of table
+         entries in the SNMP-TARGET-MIB module by multiple
+         managers.  In particular, it is useful when modifying
+         the value of the snmpTargetAddrTagList object.
+
+         The procedure for modifying the snmpTargetAddrTagList
+         object is as follows:
+
+             1.  Retrieve the value of snmpTargetSpinLock and
+                 of snmpTargetAddrTagList.
+
+             2.  Generate a new value for snmpTargetAddrTagList.
+
+             3.  Set the value of snmpTargetSpinLock to the
+                 retrieved value, and the value of
+                 snmpTargetAddrTagList to the new value.  If
+                 the set fails for the snmpTargetSpinLock
+                 object, go back to step 1."
+    ::= { snmpTargetObjects 1 }
+
+snmpTargetAddrTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of transport addresses to be used in the generation
+         of SNMP messages."
+    ::= { snmpTargetObjects 2 }
+
+snmpTargetAddrEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A transport address to be used in the generation
+         of SNMP operations.
+
+         Entries in the snmpTargetAddrTable are created and
+         deleted using the snmpTargetAddrRowStatus object."
+    INDEX { IMPLIED snmpTargetAddrName }
+    ::= { snmpTargetAddrTable 1 }
+
+SnmpTargetAddrEntry ::= SEQUENCE {
+    snmpTargetAddrName         SnmpAdminString,
+    snmpTargetAddrTDomain      TDomain,
+    snmpTargetAddrTAddress     TAddress,
+    snmpTargetAddrTimeout      TimeInterval,
+    snmpTargetAddrRetryCount   Integer32,
+    snmpTargetAddrTagList      SnmpTagList,
+    snmpTargetAddrParams       SnmpAdminString,
+    snmpTargetAddrStorageType  StorageType,
+    snmpTargetAddrRowStatus    RowStatus
+}
+
+snmpTargetAddrName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetAddrEntry."
+    ::= { snmpTargetAddrEntry 1 }
+
+snmpTargetAddrTDomain OBJECT-TYPE
+    SYNTAX      TDomain
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object indicates the transport type of the address
+         contained in the snmpTargetAddrTAddress object."
+    ::= { snmpTargetAddrEntry 2 }
+
+snmpTargetAddrTAddress OBJECT-TYPE
+    SYNTAX      TAddress
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a transport address.  The format of
+         this address depends on the value of the
+         snmpTargetAddrTDomain object."
+    ::= { snmpTargetAddrEntry 3 }
+
+snmpTargetAddrTimeout OBJECT-TYPE
+    SYNTAX      TimeInterval
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object should reflect the expected maximum round
+         trip time for communicating with the transport address
+         defined by this row.  When a message is sent to this
+         address, and a response (if one is expected) is not
+         received within this time period, an implementation
+         may assume that the response will not be delivered.
+
+         Note that the time interval that an application waits
+         for a response may actually be derived from the value
+         of this object.  The method for deriving the actual time
+         interval is implementation dependent.  One such method
+         is to derive the expected round trip time based on a
+         particular retransmission algorithm and on the number
+         of timeouts which have occurred.  The type of message may
+         also be considered when deriving expected round trip
+         times for retransmissions.  For example, if a message is
+         being sent with a securityLevel that indicates both
+
+         authentication and privacy, the derived value may be
+         increased to compensate for extra processing time spent
+         during authentication and encryption processing."
+    DEFVAL { 1500 }
+    ::= { snmpTargetAddrEntry 4 }
+
+snmpTargetAddrRetryCount OBJECT-TYPE
+    SYNTAX      Integer32 (0..255)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object specifies a default number of retries to be
+         attempted when a response is not received for a generated
+         message.  An application may provide its own retry count,
+         in which case the value of this object is ignored."
+    DEFVAL { 3 }
+    ::= { snmpTargetAddrEntry 5 }
+
+snmpTargetAddrTagList OBJECT-TYPE
+    SYNTAX      SnmpTagList
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a list of tag values which are
+         used to select target addresses for a particular
+         operation."
+    DEFVAL { "" }
+    ::= { snmpTargetAddrEntry 6 }
+
+snmpTargetAddrParams OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The value of this object identifies an entry in the
+         snmpTargetParamsTable.  The identified entry
+         contains SNMP parameters to be used when generating
+         messages to be sent to this transport address."
+    ::= { snmpTargetAddrEntry 7 }
+
+snmpTargetAddrStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetAddrEntry 8 }
+
+snmpTargetAddrRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetAddrRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding instances of
+         snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
+         snmpTargetAddrParams have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetAddrTDomain
+             - snmpTargetAddrTAddress
+         An attempt to set these objects while the value of
+         snmpTargetAddrRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetAddrEntry 9 }
+
+snmpTargetParamsTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of SNMP target information to be used
+         in the generation of SNMP messages."
+    ::= { snmpTargetObjects 3 }
+
+snmpTargetParamsEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A set of SNMP target information.
+
+         Entries in the snmpTargetParamsTable are created and
+         deleted using the snmpTargetParamsRowStatus object."
+    INDEX { IMPLIED snmpTargetParamsName }
+    ::= { snmpTargetParamsTable 1 }
+
+SnmpTargetParamsEntry ::= SEQUENCE {
+    snmpTargetParamsName           SnmpAdminString,
+    snmpTargetParamsMPModel        SnmpMessageProcessingModel,
+    snmpTargetParamsSecurityModel  SnmpSecurityModel,
+    snmpTargetParamsSecurityName   SnmpAdminString,
+    snmpTargetParamsSecurityLevel  SnmpSecurityLevel,
+    snmpTargetParamsStorageType    StorageType,
+    snmpTargetParamsRowStatus      RowStatus
+}
+
+snmpTargetParamsName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetParamsEntry."
+    ::= { snmpTargetParamsEntry 1 }
+
+snmpTargetParamsMPModel OBJECT-TYPE
+    SYNTAX      SnmpMessageProcessingModel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Message Processing Model to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 2 }
+
+snmpTargetParamsSecurityModel OBJECT-TYPE
+    SYNTAX      SnmpSecurityModel (1..2147483647)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Security Model to be used when generating SNMP
+          messages using this entry.  An implementation may
+          choose to return an inconsistentValue error if an
+          attempt is made to set this variable to a value
+          for a security model which the implementation does
+          not support."
+    ::= { snmpTargetParamsEntry 3 }
+
+snmpTargetParamsSecurityName OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The securityName which identifies the Principal on
+         whose behalf SNMP messages will be generated using
+         this entry."
+    ::= { snmpTargetParamsEntry 4 }
+
+snmpTargetParamsSecurityLevel OBJECT-TYPE
+    SYNTAX      SnmpSecurityLevel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Level of Security to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 5 }
+
+snmpTargetParamsStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetParamsEntry 6 }
+
+snmpTargetParamsRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetParamsRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding
+         snmpTargetParamsMPModel,
+         snmpTargetParamsSecurityModel,
+         snmpTargetParamsSecurityName,
+         and snmpTargetParamsSecurityLevel have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetParamsMPModel
+             - snmpTargetParamsSecurityModel
+             - snmpTargetParamsSecurityName
+             - snmpTargetParamsSecurityLevel
+         An attempt to set these objects while the value of
+         snmpTargetParamsRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetParamsEntry 7 }
+
+snmpUnavailableContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unavailable."
+    ::= { snmpTargetObjects 4 }
+
+snmpUnknownContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unknown."
+    ::= { snmpTargetObjects 5 }
+
+--
+--
+-- Conformance information
+--
+--
+
+snmpTargetCompliances OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 1 }
+snmpTargetGroups      OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 2 }
+
+--
+--
+-- Compliance statements
+
+--
+--
+
+snmpTargetCommandResponderCompliance MODULE-COMPLIANCE
+    STATUS      current
+    DESCRIPTION
+        "The compliance statement for SNMP entities which include
+         a command responder application."
+    MODULE -- This Module
+        MANDATORY-GROUPS { snmpTargetCommandResponderGroup }
+    ::= { snmpTargetCompliances 1 }
+
+snmpTargetBasicGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetSpinLock,
+        snmpTargetAddrTDomain,
+        snmpTargetAddrTAddress,
+        snmpTargetAddrTagList,
+        snmpTargetAddrParams,
+        snmpTargetAddrStorageType,
+        snmpTargetAddrRowStatus,
+        snmpTargetParamsMPModel,
+        snmpTargetParamsSecurityModel,
+        snmpTargetParamsSecurityName,
+        snmpTargetParamsSecurityLevel,
+        snmpTargetParamsStorageType,
+        snmpTargetParamsRowStatus
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing basic remote
+         configuration of management targets."
+    ::= { snmpTargetGroups 1 }
+
+snmpTargetResponseGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetAddrTimeout,
+        snmpTargetAddrRetryCount
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing remote configuration
+         of management targets for applications which generate
+         SNMP messages for which a response message would be
+         expected."
+    ::= { snmpTargetGroups 2 }
+
+snmpTargetCommandResponderGroup OBJECT-GROUP
+
+    OBJECTS {
+        snmpUnavailableContexts,
+        snmpUnknownContexts
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects required for command responder
+         applications, used for counting error conditions."
+    ::= { snmpTargetGroups 3 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..7244ad0afb5837e33f3d8cea9f0f19fe5f066d43
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
@@ -0,0 +1,830 @@
+SNMP-VIEW-BASED-ACM-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF
+    MODULE-IDENTITY, OBJECT-TYPE,
+    snmpModules                           FROM SNMPv2-SMI
+    TestAndIncr,
+    RowStatus, StorageType                FROM SNMPv2-TC
+    SnmpAdminString,
+    SnmpSecurityLevel,
+    SnmpSecurityModel                     FROM SNMP-FRAMEWORK-MIB;
+
+snmpVacmMIB       MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"          -- 16 Oct 2002, midnight
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
+                  Subscribe:  majordomo@lists.tislabs.com
+                              In message body:  subscribe snmpv3
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  email:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair:   David Harrington
+                              Enterasys Networks
+                  Postal:     35 Industrial Way
+                              P. O. Box 5004
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  Phone:      +1 603-337-2614
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+                  email:      bwijnen@lucent.com
+                  phone:      +31-348-480-685
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+
+                  postal:     2141 North First Street
+                              San Jose, CA 95131
+                              USA
+                  email:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Keith McCloghrie
+                              Cisco Systems, Inc.
+                  postal:     170 West Tasman Drive
+                              San Jose, CA  95134-1706
+                              USA
+                  email:      kzm@cisco.com
+                  phone:      +1-408-526-5260
+                 "
+    DESCRIPTION  "The management information definitions for the
+                  View-based Access Control Model for SNMP.
+
+                  Copyright (C) The Internet Society (2002). This
+                  version of this MIB module is part of RFC 3415;
+                  see the RFC itself for full legal notices.
+                 "
+--  Revision history
+
+    REVISION     "200210160000Z"          -- 16 Oct 2002, midnight
+    DESCRIPTION  "Clarifications, published as RFC3415"
+
+    REVISION     "199901200000Z"          -- 20 Jan 1999, midnight
+    DESCRIPTION  "Clarifications, published as RFC2575"
+
+    REVISION     "199711200000Z"          -- 20 Nov 1997, midnight
+    DESCRIPTION  "Initial version, published as RFC2275"
+    ::= { snmpModules 16 }
+
+-- Administrative assignments ****************************************
+
+vacmMIBObjects      OBJECT IDENTIFIER ::= { snmpVacmMIB 1 }
+vacmMIBConformance  OBJECT IDENTIFIER ::= { snmpVacmMIB 2 }
+
+-- Information about Local Contexts **********************************
+
+vacmContextTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of locally available contexts.
+
+                 This table provides information to SNMP Command
+
+                 Generator applications so that they can properly
+                 configure the vacmAccessTable to control access to
+                 all contexts at the SNMP entity.
+
+                 This table may change dynamically if the SNMP entity
+                 allows that contexts are added/deleted dynamically
+                 (for instance when its configuration changes).  Such
+                 changes would happen only if the management
+                 instrumentation at that SNMP entity recognizes more
+                 (or fewer) contexts.
+
+                 The presence of entries in this table and of entries
+                 in the vacmAccessTable are independent.  That is, a
+                 context identified by an entry in this table is not
+                 necessarily referenced by any entries in the
+                 vacmAccessTable; and the context(s) referenced by an
+                 entry in the vacmAccessTable does not necessarily
+                 currently exist and thus need not be identified by an
+                 entry in this table.
+
+                 This table must be made accessible via the default
+                 context so that Command Responder applications have
+                 a standard way of retrieving the information.
+
+                 This table is read-only.  It cannot be configured via
+                 SNMP.
+                "
+    ::= { vacmMIBObjects 1 }
+
+vacmContextEntry OBJECT-TYPE
+    SYNTAX       VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information about a particular context."
+    INDEX       {
+                  vacmContextName
+                }
+    ::= { vacmContextTable 1 }
+
+VacmContextEntry ::= SEQUENCE
+    {
+        vacmContextName SnmpAdminString
+    }
+
+vacmContextName  OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "A human readable name identifying a particular
+                 context at a particular SNMP entity.
+
+                 The empty contextName (zero length) represents the
+                 default context.
+                "
+    ::= { vacmContextEntry 1 }
+
+-- Information about Groups ******************************************
+
+vacmSecurityToGroupTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "This table maps a combination of securityModel and
+                 securityName into a groupName which is used to define
+                 an access control policy for a group of principals.
+                "
+    ::= { vacmMIBObjects 2 }
+
+vacmSecurityToGroupEntry OBJECT-TYPE
+    SYNTAX       VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An entry in this table maps the combination of a
+                 securityModel and securityName into a groupName.
+                "
+    INDEX       {
+                  vacmSecurityModel,
+                  vacmSecurityName
+                }
+    ::= { vacmSecurityToGroupTable 1 }
+
+VacmSecurityToGroupEntry ::= SEQUENCE
+    {
+        vacmSecurityModel               SnmpSecurityModel,
+        vacmSecurityName                SnmpAdminString,
+        vacmGroupName                   SnmpAdminString,
+        vacmSecurityToGroupStorageType  StorageType,
+        vacmSecurityToGroupStatus       RowStatus
+    }
+
+vacmSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel(1..2147483647)
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The Security Model, by which the vacmSecurityName
+                 referenced by this entry is provided.
+
+                 Note, this object may not take the 'any' (0) value.
+                "
+    ::= { vacmSecurityToGroupEntry 1 }
+
+vacmSecurityName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The securityName for the principal, represented in a
+                 Security Model independent format, which is mapped by
+                 this entry to a groupName.
+                "
+    ::= { vacmSecurityToGroupEntry 2 }
+
+vacmGroupName    OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The name of the group to which this entry (e.g., the
+                 combination of securityModel and securityName)
+                 belongs.
+
+                 This groupName is used as index into the
+                 vacmAccessTable to select an access control policy.
+                 However, a value in this table does not imply that an
+                 instance with the value exists in table vacmAccesTable.
+                "
+    ::= { vacmSecurityToGroupEntry 3 }
+
+vacmSecurityToGroupStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmSecurityToGroupEntry 4 }
+
+vacmSecurityToGroupStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 Until instances of all corresponding columns are
+                 appropriately configured, the value of the
+
+                 corresponding instance of the vacmSecurityToGroupStatus
+                 column is 'notReady'.
+
+                 In particular, a newly created row cannot be made
+                 active until a value has been set for vacmGroupName.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmSecurityToGroupEntry 5 }
+
+-- Information about Access Rights ***********************************
+
+vacmAccessTable  OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of access rights for groups.
+
+                 Each entry is indexed by a groupName, a contextPrefix,
+                 a securityModel and a securityLevel.  To determine
+                 whether access is allowed, one entry from this table
+                 needs to be selected and the proper viewName from that
+                 entry must be used for access control checking.
+
+                 To select the proper entry, follow these steps:
+
+                 1) the set of possible matches is formed by the
+                    intersection of the following sets of entries:
+
+                      the set of entries with identical vacmGroupName
+                      the union of these two sets:
+                       - the set with identical vacmAccessContextPrefix
+                       - the set of entries with vacmAccessContextMatch
+                         value of 'prefix' and matching
+                         vacmAccessContextPrefix
+                      intersected with the union of these two sets:
+                       - the set of entries with identical
+                         vacmSecurityModel
+                       - the set of entries with vacmSecurityModel
+                         value of 'any'
+                      intersected with the set of entries with
+                      vacmAccessSecurityLevel value less than or equal
+                      to the requested securityLevel
+
+                 2) if this set has only one member, we're done
+                    otherwise, it comes down to deciding how to weight
+                    the preferences between ContextPrefixes,
+                    SecurityModels, and SecurityLevels as follows:
+                    a) if the subset of entries with securityModel
+                       matching the securityModel in the message is
+                       not empty, then discard the rest.
+                    b) if the subset of entries with
+                       vacmAccessContextPrefix matching the contextName
+                       in the message is not empty,
+                       then discard the rest
+                    c) discard all entries with ContextPrefixes shorter
+                       than the longest one remaining in the set
+                    d) select the entry with the highest securityLevel
+
+                 Please note that for securityLevel noAuthNoPriv, all
+                 groups are really equivalent since the assumption that
+                 the securityName has been authenticated does not hold.
+                "
+    ::= { vacmMIBObjects 4 }
+
+vacmAccessEntry  OBJECT-TYPE
+    SYNTAX       VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An access right configured in the Local Configuration
+                 Datastore (LCD) authorizing access to an SNMP context.
+
+                 Entries in this table can use an instance value for
+                 object vacmGroupName even if no entry in table
+                 vacmAccessSecurityToGroupTable has a corresponding
+                 value for object vacmGroupName.
+                "
+    INDEX       { vacmGroupName,
+                  vacmAccessContextPrefix,
+                  vacmAccessSecurityModel,
+                  vacmAccessSecurityLevel
+                }
+    ::= { vacmAccessTable 1 }
+
+VacmAccessEntry ::= SEQUENCE
+    {
+        vacmAccessContextPrefix    SnmpAdminString,
+        vacmAccessSecurityModel    SnmpSecurityModel,
+        vacmAccessSecurityLevel    SnmpSecurityLevel,
+        vacmAccessContextMatch     INTEGER,
+        vacmAccessReadViewName     SnmpAdminString,
+        vacmAccessWriteViewName    SnmpAdminString,
+        vacmAccessNotifyViewName   SnmpAdminString,
+        vacmAccessStorageType      StorageType,
+        vacmAccessStatus           RowStatus
+    }
+
+vacmAccessContextPrefix OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, a contextName must match exactly
+                 (if the value of vacmAccessContextMatch is 'exact')
+                 or partially (if the value of vacmAccessContextMatch
+                 is 'prefix') to the value of the instance of this
+                 object.
+                "
+    ::= { vacmAccessEntry 1 }
+
+vacmAccessSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, this securityModel must be in use.
+                "
+    ::= { vacmAccessEntry 2 }
+
+vacmAccessSecurityLevel OBJECT-TYPE
+    SYNTAX       SnmpSecurityLevel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The minimum level of security required in order to
+                 gain the access rights allowed by this conceptual
+                 row.  A securityLevel of noAuthNoPriv is less than
+                 authNoPriv which in turn is less than authPriv.
+
+                 If multiple entries are equally indexed except for
+                 this vacmAccessSecurityLevel index, then the entry
+                 which has the highest value for
+                 vacmAccessSecurityLevel is selected.
+                "
+    ::= { vacmAccessEntry 3 }
+
+vacmAccessContextMatch OBJECT-TYPE
+    SYNTAX       INTEGER
+                { exact (1), -- exact match of prefix and contextName
+                  prefix (2) -- Only match to the prefix
+                }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "If the value of this object is exact(1), then all
+                 rows where the contextName exactly matches
+                 vacmAccessContextPrefix are selected.
+
+                 If the value of this object is prefix(2), then all
+                 rows where the contextName whose starting octets
+                 exactly match vacmAccessContextPrefix are selected.
+                 This allows for a simple form of wildcarding.
+                "
+    DEFVAL      { exact }
+    ::= { vacmAccessEntry 4 }
+
+vacmAccessReadViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes read access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 5 }
+
+vacmAccessWriteViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes write access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 6 }
+
+vacmAccessNotifyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes access for notifications.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 7 }
+
+vacmAccessStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmAccessEntry 8 }
+
+vacmAccessStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmAccessEntry 9 }
+
+-- Information about MIB views ***************************************
+
+-- Support for instance-level granularity is optional.
+--
+-- In some implementations, instance-level access control
+-- granularity may come at a high performance cost.  Managers
+-- should avoid requesting such configurations unnecessarily.
+
+vacmMIBViews     OBJECT IDENTIFIER ::= { vacmMIBObjects 5 }
+
+vacmViewSpinLock OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       current
+    DESCRIPTION "An advisory lock used to allow cooperating SNMP
+                 Command Generator applications to coordinate their
+                 use of the Set operation in creating or modifying
+                 views.
+
+                 When creating a new view or altering an existing
+                 view, it is important to understand the potential
+                 interactions with other uses of the view.  The
+                 vacmViewSpinLock should be retrieved.  The name of
+                 the view to be created should be determined to be
+                 unique by the SNMP Command Generator application by
+                 consulting the vacmViewTreeFamilyTable.  Finally,
+                 the named view may be created (Set), including the
+                 advisory lock.
+                 If another SNMP Command Generator application has
+                 altered the views in the meantime, then the spin
+                 lock's value will have changed, and so this creation
+                 will fail because it will specify the wrong value for
+                 the spin lock.
+
+                 Since this is an advisory lock, the use of this lock
+                 is not enforced.
+                "
+    ::= { vacmMIBViews 1 }
+
+vacmViewTreeFamilyTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Locally held information about families of subtrees
+                 within MIB views.
+
+                 Each MIB view is defined by two sets of view subtrees:
+                   - the included view subtrees, and
+                   - the excluded view subtrees.
+                 Every such view subtree, both the included and the
+
+                 excluded ones, is defined in this table.
+
+                 To determine if a particular object instance is in
+                 a particular MIB view, compare the object instance's
+                 OBJECT IDENTIFIER with each of the MIB view's active
+                 entries in this table.  If none match, then the
+                 object instance is not in the MIB view.  If one or
+                 more match, then the object instance is included in,
+                 or excluded from, the MIB view according to the
+                 value of vacmViewTreeFamilyType in the entry whose
+                 value of vacmViewTreeFamilySubtree has the most
+                 sub-identifiers.  If multiple entries match and have
+                 the same number of sub-identifiers (when wildcarding
+                 is specified with the value of vacmViewTreeFamilyMask),
+                 then the lexicographically greatest instance of
+                 vacmViewTreeFamilyType determines the inclusion or
+                 exclusion.
+
+                 An object instance's OBJECT IDENTIFIER X matches an
+                 active entry in this table when the number of
+                 sub-identifiers in X is at least as many as in the
+                 value of vacmViewTreeFamilySubtree for the entry,
+                 and each sub-identifier in the value of
+                 vacmViewTreeFamilySubtree matches its corresponding
+                 sub-identifier in X.  Two sub-identifiers match
+                 either if the corresponding bit of the value of
+                 vacmViewTreeFamilyMask for the entry is zero (the
+                 'wild card' value), or if they are equal.
+
+                 A 'family' of subtrees is the set of subtrees defined
+                 by a particular combination of values of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask.
+
+                 In the case where no 'wild card' is defined in the
+                 vacmViewTreeFamilyMask, the family of subtrees reduces
+                 to a single subtree.
+
+                 When creating or changing MIB views, an SNMP Command
+                 Generator application should utilize the
+                 vacmViewSpinLock to try to avoid collisions.  See
+                 DESCRIPTION clause of vacmViewSpinLock.
+
+                 When creating MIB views, it is strongly advised that
+                 first the 'excluded' vacmViewTreeFamilyEntries are
+                 created and then the 'included' entries.
+
+                 When deleting MIB views, it is strongly advised that
+                 first the 'included' vacmViewTreeFamilyEntries are
+
+                 deleted and then the 'excluded' entries.
+
+                 If a create for an entry for instance-level access
+                 control is received and the implementation does not
+                 support instance-level granularity, then an
+                 inconsistentName error must be returned.
+                "
+    ::= { vacmMIBViews 2 }
+
+vacmViewTreeFamilyEntry OBJECT-TYPE
+    SYNTAX       VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information on a particular family of view subtrees
+                 included in or excluded from a particular SNMP
+                 context's MIB view.
+
+                 Implementations must not restrict the number of
+                 families of view subtrees for a given MIB view,
+                 except as dictated by resource constraints on the
+                 overall number of entries in the
+                 vacmViewTreeFamilyTable.
+
+                 If no conceptual rows exist in this table for a given
+                 MIB view (viewName), that view may be thought of as
+                 consisting of the empty set of view subtrees.
+                "
+    INDEX       { vacmViewTreeFamilyViewName,
+                  vacmViewTreeFamilySubtree
+                }
+    ::= { vacmViewTreeFamilyTable 1 }
+
+VacmViewTreeFamilyEntry ::= SEQUENCE
+    {
+        vacmViewTreeFamilyViewName     SnmpAdminString,
+        vacmViewTreeFamilySubtree      OBJECT IDENTIFIER,
+        vacmViewTreeFamilyMask         OCTET STRING,
+        vacmViewTreeFamilyType         INTEGER,
+        vacmViewTreeFamilyStorageType  StorageType,
+        vacmViewTreeFamilyStatus       RowStatus
+    }
+
+vacmViewTreeFamilyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The human readable name for a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 1 }
+
+vacmViewTreeFamilySubtree OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The MIB subtree which when combined with the
+                 corresponding instance of vacmViewTreeFamilyMask
+                 defines a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 2 }
+
+vacmViewTreeFamilyMask OBJECT-TYPE
+    SYNTAX       OCTET STRING (SIZE (0..16))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The bit mask which, in combination with the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 defines a family of view subtrees.
+
+                 Each bit of this bit mask corresponds to a
+                 sub-identifier of vacmViewTreeFamilySubtree, with the
+                 most significant bit of the i-th octet of this octet
+                 string value (extended if necessary, see below)
+                 corresponding to the (8*i - 7)-th sub-identifier, and
+                 the least significant bit of the i-th octet of this
+                 octet string corresponding to the (8*i)-th
+                 sub-identifier, where i is in the range 1 through 16.
+
+                 Each bit of this bit mask specifies whether or not
+                 the corresponding sub-identifiers must match when
+                 determining if an OBJECT IDENTIFIER is in this
+                 family of view subtrees; a '1' indicates that an
+                 exact match must occur; a '0' indicates 'wild card',
+                 i.e., any sub-identifier value matches.
+
+                 Thus, the OBJECT IDENTIFIER X of an object instance
+                 is contained in a family of view subtrees if, for
+                 each sub-identifier of the value of
+                 vacmViewTreeFamilySubtree, either:
+
+                   the i-th bit of vacmViewTreeFamilyMask is 0, or
+
+                   the i-th sub-identifier of X is equal to the i-th
+                   sub-identifier of the value of
+                   vacmViewTreeFamilySubtree.
+
+                 If the value of this bit mask is M bits long and
+
+                 there are more than M sub-identifiers in the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 then the bit mask is extended with 1's to be the
+                 required length.
+
+                 Note that when the value of this object is the
+                 zero-length string, this extension rule results in
+                 a mask of all-1's being used (i.e., no 'wild card'),
+                 and the family of view subtrees is the one view
+                 subtree uniquely identified by the corresponding
+                 instance of vacmViewTreeFamilySubtree.
+
+                 Note that masks of length greater than zero length
+                 do not need to be supported.  In this case this
+                 object is made read-only.
+                "
+    DEFVAL      { ''H }
+    ::= { vacmViewTreeFamilyEntry 3 }
+
+vacmViewTreeFamilyType OBJECT-TYPE
+    SYNTAX       INTEGER  { included(1), excluded(2) }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "Indicates whether the corresponding instances of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask
+                 define a family of view subtrees which is included in
+                 or excluded from the MIB view.
+                "
+    DEFVAL      { included }
+    ::= { vacmViewTreeFamilyEntry 4 }
+
+vacmViewTreeFamilyStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmViewTreeFamilyEntry 5 }
+
+vacmViewTreeFamilyStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmViewTreeFamilyEntry 6 }
+
+-- Conformance information *******************************************
+
+vacmMIBCompliances  OBJECT IDENTIFIER ::= { vacmMIBConformance 1 }
+vacmMIBGroups       OBJECT IDENTIFIER ::= { vacmMIBConformance 2 }
+
+-- Compliance statements *********************************************
+
+vacmMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP View-based Access Control Model
+                 configuration MIB.
+                "
+    MODULE -- this module
+        MANDATORY-GROUPS { vacmBasicGroup }
+
+        OBJECT        vacmAccessContextMatch
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessReadViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessWriteViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessNotifyViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+
+                      vacmAccessTable is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyMask
+        WRITE-SYNTAX  OCTET STRING (SIZE (0))
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Support for configuration via SNMP of subtree
+                      families using wild-cards is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+                      vacmViewTreeFamilyTable is not required.
+                     "
+    ::= { vacmMIBCompliances 1 }
+
+-- Units of conformance **********************************************
+
+vacmBasicGroup OBJECT-GROUP
+    OBJECTS {
+              vacmContextName,
+              vacmGroupName,
+              vacmSecurityToGroupStorageType,
+              vacmSecurityToGroupStatus,
+              vacmAccessContextMatch,
+              vacmAccessReadViewName,
+              vacmAccessWriteViewName,
+              vacmAccessNotifyViewName,
+              vacmAccessStorageType,
+              vacmAccessStatus,
+              vacmViewSpinLock,
+              vacmViewTreeFamilyMask,
+              vacmViewTreeFamilyType,
+              vacmViewTreeFamilyStorageType,
+              vacmViewTreeFamilyStatus
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects providing for remote
+                 configuration of an SNMP engine which implements
+
+                 the SNMP View-based Access Control Model.
+                "
+    ::= { vacmMIBGroups 1 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt
new file mode 100755
index 0000000000000000000000000000000000000000..24a1eed95d62f81ea88c3a78017696fa05400340
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt
@@ -0,0 +1,322 @@
+SNMPv2-CONF DEFINITIONS ::= BEGIN
+
+IMPORTS ObjectName, NotificationName, ObjectSyntax
+                                               FROM SNMPv2-SMI;
+
+-- definitions for conformance groups
+
+OBJECT-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+    Objects ::=
+                  Object
+                | Objects "," Object
+    Object ::=
+
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- more definitions for conformance groups
+
+NOTIFICATION-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  NotificationsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    NotificationsPart ::=
+                  "NOTIFICATIONS" "{" Notifications "}"
+    Notifications ::=
+                  Notification
+                | Notifications "," Notification
+    Notification ::=
+                  value(NotificationName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for compliance statements
+
+MODULE-COMPLIANCE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "MODULE" ModuleName
+                  MandatoryPart
+                  CompliancePart
+
+    ModuleName ::=
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+                  -- must not be empty unless contained
+                  -- in MIB Module
+                | empty
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    MandatoryPart ::=
+                  "MANDATORY-GROUPS" "{" Groups "}"
+                | empty
+
+    Groups ::=
+
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    CompliancePart ::=
+                  Compliances
+                | empty
+
+    Compliances ::=
+                  Compliance
+                | Compliances Compliance
+    Compliance ::=
+                  ComplianceGroup
+                | Object
+
+    ComplianceGroup ::=
+                  "GROUP" value(OBJECT IDENTIFIER)
+                  "DESCRIPTION" Text
+
+    Object ::=
+                  "OBJECT" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    -- must be a refinement for object's SYNTAX clause
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "MIN-ACCESS" Access
+                | empty
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for capabilities statements
+
+AGENT-CAPABILITIES MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "PRODUCT-RELEASE" Text
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+                | empty
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "SUPPORTS" ModuleName
+                  "INCLUDES" "{" Groups "}"
+                  VariationPart
+
+    ModuleName ::=
+
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    Groups ::=
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    VariationPart ::=
+                  Variations
+                | empty
+    Variations ::=
+                  Variation
+                | Variations Variation
+
+    Variation ::=
+                  ObjectVariation
+                | NotificationVariation
+
+    NotificationVariation ::=
+                  "VARIATION" value(NotificationName)
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    ObjectVariation ::=
+                  "VARIATION" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  CreationPart
+                  DefValPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "ACCESS" Access
+                | empty
+
+    Access ::=
+                  "not-implemented"
+                -- only "not-implemented" for notifications
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+                -- following is for backward-compatibility only
+                | "write-only"
+
+    CreationPart ::=
+                  "CREATION-REQUIRES" "{" Cells "}"
+                | empty
+    Cells ::=
+                  Cell
+                | Cells "," Cell
+    Cell ::=
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the object's syntax
+                  -- in this macro's SYNTAX clause, if present,
+                  -- or if not, in object's OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..8c828305e06fd4a438b62fd6dcec1f30a173af28
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt
@@ -0,0 +1,854 @@
+SNMPv2-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
+    TimeTicks, Counter32, snmpModules, mib-2
+        FROM SNMPv2-SMI
+    DisplayString, TestAndIncr, TimeStamp
+
+        FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
+        FROM SNMPv2-CONF;
+
+snmpMIB MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+            "WG-EMail:   snmpv3@lists.tislabs.com
+             Subscribe:  snmpv3-request@lists.tislabs.com
+
+             Co-Chair:   Russ Mundy
+                         Network Associates Laboratories
+             postal:     15204 Omega Drive, Suite 300
+                         Rockville, MD 20850-4601
+                         USA
+             EMail:      mundy@tislabs.com
+             phone:      +1 301 947-7107
+
+             Co-Chair:   David Harrington
+                         Enterasys Networks
+             postal:     35 Industrial Way
+                         P. O. Box 5005
+                         Rochester, NH 03866-5005
+                         USA
+             EMail:      dbh@enterasys.com
+             phone:      +1 603 337-2614
+
+             Editor:     Randy Presuhn
+                         BMC Software, Inc.
+             postal:     2141 North First Street
+                         San Jose, CA 95131
+                         USA
+             EMail:      randy_presuhn@bmc.com
+             phone:      +1 408 546-1006"
+    DESCRIPTION
+            "The MIB module for SNMP entities.
+
+             Copyright (C) The Internet Society (2002). This
+             version of this MIB module is part of RFC 3418;
+             see the RFC itself for full legal notices.
+            "
+    REVISION      "200210160000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 3418."
+    REVISION      "199511090000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 1907."
+    REVISION      "199304010000Z"
+    DESCRIPTION
+            "The initial revision of this MIB module was published
+            as RFC 1450."
+    ::= { snmpModules 1 }
+
+snmpMIBObjects OBJECT IDENTIFIER ::= { snmpMIB 1 }
+
+--  ::= { snmpMIBObjects 1 }        this OID is obsolete
+--  ::= { snmpMIBObjects 2 }        this OID is obsolete
+--  ::= { snmpMIBObjects 3 }        this OID is obsolete
+
+-- the System group
+--
+-- a collection of objects common to all managed systems.
+
+system   OBJECT IDENTIFIER ::= { mib-2 1 }
+
+sysDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual description of the entity.  This value should
+            include the full name and version identification of
+            the system's hardware type, software operating-system,
+            and networking software."
+    ::= { system 1 }
+
+sysObjectID OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The vendor's authoritative identification of the
+            network management subsystem contained in the entity.
+            This value is allocated within the SMI enterprises
+            subtree (1.3.6.1.4.1) and provides an easy and
+            unambiguous means for determining `what kind of box' is
+            being managed.  For example, if vendor `Flintstones,
+            Inc.' was assigned the subtree 1.3.6.1.4.1.424242,
+            it could assign the identifier 1.3.6.1.4.1.424242.1.1
+            to its `Fred Router'."
+    ::= { system 2 }
+
+sysUpTime OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The time (in hundredths of a second) since the
+            network management portion of the system was last
+            re-initialized."
+    ::= { system 3 }
+
+sysContact OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The textual identification of the contact person for
+            this managed node, together with information on how
+            to contact this person.  If no contact information is
+            known, the value is the zero-length string."
+    ::= { system 4 }
+
+sysName OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "An administratively-assigned name for this managed
+            node.  By convention, this is the node's fully-qualified
+            domain name.  If the name is unknown, the value is
+            the zero-length string."
+    ::= { system 5 }
+
+sysLocation OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The physical location of this node (e.g., 'telephone
+            closet, 3rd floor').  If the location is unknown, the
+            value is the zero-length string."
+    ::= { system 6 }
+
+sysServices OBJECT-TYPE
+    SYNTAX      INTEGER (0..127)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A value which indicates the set of services that this
+            entity may potentially offer.  The value is a sum.
+
+            This sum initially takes the value zero. Then, for
+            each layer, L, in the range 1 through 7, that this node
+            performs transactions for, 2 raised to (L - 1) is added
+            to the sum.  For example, a node which performs only
+            routing functions would have a value of 4 (2^(3-1)).
+            In contrast, a node which is a host offering application
+            services would have a value of 72 (2^(4-1) + 2^(7-1)).
+            Note that in the context of the Internet suite of
+            protocols, values should be calculated accordingly:
+
+                 layer      functionality
+                   1        physical (e.g., repeaters)
+                   2        datalink/subnetwork (e.g., bridges)
+                   3        internet (e.g., supports the IP)
+                   4        end-to-end  (e.g., supports the TCP)
+                   7        applications (e.g., supports the SMTP)
+
+            For systems including OSI protocols, layers 5 and 6
+            may also be counted."
+    ::= { system 7 }
+
+-- object resource information
+--
+-- a collection of objects which describe the SNMP entity's
+-- (statically and dynamically configurable) support of
+-- various MIB modules.
+
+sysORLastChange OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the most recent
+            change in state or value of any instance of sysORID."
+    ::= { system 8 }
+
+sysORTable OBJECT-TYPE
+    SYNTAX     SEQUENCE OF SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The (conceptual) table listing the capabilities of
+            the local SNMP application acting as a command
+            responder with respect to various MIB modules.
+            SNMP entities having dynamically-configurable support
+            of MIB modules will have a dynamically-varying number
+            of conceptual rows."
+    ::= { system 9 }
+
+sysOREntry OBJECT-TYPE
+    SYNTAX     SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "An entry (conceptual row) in the sysORTable."
+    INDEX      { sysORIndex }
+    ::= { sysORTable 1 }
+
+SysOREntry ::= SEQUENCE {
+    sysORIndex     INTEGER,
+    sysORID        OBJECT IDENTIFIER,
+    sysORDescr     DisplayString,
+    sysORUpTime    TimeStamp
+}
+
+sysORIndex OBJECT-TYPE
+    SYNTAX     INTEGER (1..2147483647)
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The auxiliary variable used for identifying instances
+            of the columnar objects in the sysORTable."
+    ::= { sysOREntry 1 }
+
+sysORID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "An authoritative identification of a capabilities
+            statement with respect to various MIB modules supported
+            by the local SNMP application acting as a command
+            responder."
+    ::= { sysOREntry 2 }
+
+sysORDescr OBJECT-TYPE
+    SYNTAX     DisplayString
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "A textual description of the capabilities identified
+            by the corresponding instance of sysORID."
+    ::= { sysOREntry 3 }
+
+sysORUpTime OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time this conceptual
+            row was last instantiated."
+    ::= { sysOREntry 4 }
+
+-- the SNMP group
+--
+-- a collection of objects providing basic instrumentation and
+-- control of an SNMP entity.
+
+snmp     OBJECT IDENTIFIER ::= { mib-2 11 }
+
+snmpInPkts OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of messages delivered to the SNMP
+            entity from the transport service."
+    ::= { snmp 1 }
+
+snmpInBadVersions OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of SNMP messages which were delivered
+            to the SNMP entity and were for an unsupported SNMP
+            version."
+    ::= { snmp 3 }
+
+snmpInBadCommunityNames OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example,  SNMPv1) delivered to the SNMP entity which
+           used an SNMP community name not known to said entity.
+           Also, implementations which authenticate community-based
+           SNMP messages using check(s) in addition to matching
+           the community name (for example, by also checking
+           whether the message originated from a transport address
+           allowed to use a specified community name) MAY include
+           in this value the number of messages which failed the
+           additional check(s).  It is strongly RECOMMENDED that
+
+           the documentation for any security model which is used
+           to authenticate community-based SNMP messages specify
+           the precise conditions that contribute to this value."
+    ::= { snmp 4 }
+
+snmpInBadCommunityUses OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example, SNMPv1) delivered to the SNMP entity which
+           represented an SNMP operation that was not allowed for
+           the SNMP community named in the message.  The precise
+           conditions under which this counter is incremented
+           (if at all) depend on how the SNMP entity implements
+           its access control mechanism and how its applications
+           interact with that access control mechanism.  It is
+           strongly RECOMMENDED that the documentation for any
+           access control mechanism which is used to control access
+           to and visibility of MIB instrumentation specify the
+           precise conditions that contribute to this value."
+    ::= { snmp 5 }
+
+snmpInASNParseErrs OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of ASN.1 or BER errors encountered by
+            the SNMP entity when decoding received SNMP messages."
+    ::= { snmp 6 }
+
+snmpEnableAuthenTraps OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether the SNMP entity is permitted to
+            generate authenticationFailure traps.  The value of this
+            object overrides any configuration information; as such,
+            it provides a means whereby all authenticationFailure
+            traps may be disabled.
+
+            Note that it is strongly recommended that this object
+            be stored in non-volatile memory so that it remains
+            constant across re-initializations of the network
+            management system."
+    ::= { snmp 30 }
+
+snmpSilentDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of Confirmed Class PDUs (such as
+           GetRequest-PDUs, GetNextRequest-PDUs,
+           GetBulkRequest-PDUs, SetRequest-PDUs, and
+           InformRequest-PDUs) delivered to the SNMP entity which
+           were silently dropped because the size of a reply
+           containing an alternate Response Class PDU (such as a
+           Response-PDU) with an empty variable-bindings field
+           was greater than either a local constraint or the
+           maximum message size associated with the originator of
+           the request."
+    ::= { snmp 31 }
+
+snmpProxyDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of Confirmed Class PDUs
+            (such as GetRequest-PDUs, GetNextRequest-PDUs,
+            GetBulkRequest-PDUs, SetRequest-PDUs, and
+            InformRequest-PDUs) delivered to the SNMP entity which
+            were silently dropped because the transmission of
+            the (possibly translated) message to a proxy target
+            failed in a manner (other than a time-out) such that
+            no Response Class PDU (such as a Response-PDU) could
+            be returned."
+    ::= { snmp 32 }
+
+-- information for notifications
+--
+-- a collection of objects which allow the SNMP entity, when
+-- supporting a notification originator application,
+-- to be configured to generate SNMPv2-Trap-PDUs.
+
+snmpTrap       OBJECT IDENTIFIER ::= { snmpMIBObjects 4 }
+
+snmpTrapOID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the notification
+            currently being sent.  This variable occurs as
+            the second varbind in every SNMPv2-Trap-PDU and
+            InformRequest-PDU."
+    ::= { snmpTrap 1 }
+
+--  ::= { snmpTrap 2 }   this OID is obsolete
+
+snmpTrapEnterprise OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the enterprise
+            associated with the trap currently being sent.  When an
+            SNMP proxy agent is mapping an RFC1157 Trap-PDU
+            into a SNMPv2-Trap-PDU, this variable occurs as the
+            last varbind."
+    ::= { snmpTrap 3 }
+
+--  ::= { snmpTrap 4 }   this OID is obsolete
+
+-- well-known traps
+
+snmpTraps      OBJECT IDENTIFIER ::= { snmpMIBObjects 5 }
+
+coldStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A coldStart trap signifies that the SNMP entity,
+            supporting a notification originator application, is
+            reinitializing itself and that its configuration may
+            have been altered."
+    ::= { snmpTraps 1 }
+
+warmStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A warmStart trap signifies that the SNMP entity,
+            supporting a notification originator application,
+            is reinitializing itself such that its configuration
+            is unaltered."
+    ::= { snmpTraps 2 }
+
+-- Note the linkDown NOTIFICATION-TYPE ::= { snmpTraps 3 }
+-- and the linkUp NOTIFICATION-TYPE ::= { snmpTraps 4 }
+-- are defined in RFC 2863 [RFC2863]
+
+authenticationFailure NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "An authenticationFailure trap signifies that the SNMP
+             entity has received a protocol message that is not
+             properly authenticated.  While all implementations
+             of SNMP entities MAY be capable of generating this
+             trap, the snmpEnableAuthenTraps object indicates
+             whether this trap will be generated."
+    ::= { snmpTraps 5 }
+
+-- Note the egpNeighborLoss notification is defined
+-- as { snmpTraps 6 } in RFC 1213
+
+-- the set group
+--
+-- a collection of objects which allow several cooperating
+-- command generator applications to coordinate their use of the
+-- set operation.
+
+snmpSet        OBJECT IDENTIFIER ::= { snmpMIBObjects 6 }
+
+snmpSetSerialNo OBJECT-TYPE
+    SYNTAX     TestAndIncr
+    MAX-ACCESS read-write
+    STATUS     current
+    DESCRIPTION
+            "An advisory lock used to allow several cooperating
+            command generator applications to coordinate their
+            use of the SNMP set operation.
+
+            This object is used for coarse-grain coordination.
+            To achieve fine-grain coordination, one or more similar
+            objects might be defined within each MIB group, as
+            appropriate."
+    ::= { snmpSet 1 }
+
+-- conformance information
+
+snmpMIBConformance
+               OBJECT IDENTIFIER ::= { snmpMIB 2 }
+
+snmpMIBCompliances
+               OBJECT IDENTIFIER ::= { snmpMIBConformance 1 }
+snmpMIBGroups  OBJECT IDENTIFIER ::= { snmpMIBConformance 2 }
+
+-- compliance statements
+
+--    ::= { snmpMIBCompliances 1 }      this OID is obsolete
+snmpBasicCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "The compliance statement for SNMPv2 entities which
+            implement the SNMPv2 MIB.
+
+            This compliance statement is replaced by
+            snmpBasicComplianceRev2."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMPv2 entities which
+            support community-based authentication."
+    ::= { snmpMIBCompliances 2 }
+
+snmpBasicComplianceRev2 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which
+            implement this MIB module."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMP entities which
+            support community-based authentication."
+
+        GROUP   snmpWarmStartNotificationGroup
+        DESCRIPTION
+            "This group is mandatory for an SNMP entity which
+            supports command responder applications, and is
+            able to reinitialize itself such that its
+            configuration is unaltered."
+    ::= { snmpMIBCompliances 3 }
+
+-- units of conformance
+
+--  ::= { snmpMIBGroups 1 }           this OID is obsolete
+--  ::= { snmpMIBGroups 2 }           this OID is obsolete
+--  ::= { snmpMIBGroups 3 }           this OID is obsolete
+
+--  ::= { snmpMIBGroups 4 }           this OID is obsolete
+
+snmpGroup OBJECT-GROUP
+    OBJECTS { snmpInPkts,
+              snmpInBadVersions,
+              snmpInASNParseErrs,
+              snmpSilentDrops,
+              snmpProxyDrops,
+              snmpEnableAuthenTraps }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            and control of an SNMP entity."
+    ::= { snmpMIBGroups 8 }
+
+snmpCommunityGroup OBJECT-GROUP
+    OBJECTS { snmpInBadCommunityNames,
+              snmpInBadCommunityUses }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            of a SNMP entity which supports community-based
+            authentication."
+    ::= { snmpMIBGroups 9 }
+
+snmpSetGroup OBJECT-GROUP
+    OBJECTS { snmpSetSerialNo }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects which allow several cooperating
+            command generator applications to coordinate their
+            use of the set operation."
+    ::= { snmpMIBGroups 5 }
+
+systemGroup OBJECT-GROUP
+    OBJECTS { sysDescr, sysObjectID, sysUpTime,
+              sysContact, sysName, sysLocation,
+              sysServices,
+              sysORLastChange, sysORID,
+              sysORUpTime, sysORDescr }
+    STATUS  current
+    DESCRIPTION
+            "The system group defines objects which are common to all
+            managed systems."
+    ::= { snmpMIBGroups 6 }
+
+snmpBasicNotificationsGroup NOTIFICATION-GROUP
+    NOTIFICATIONS { coldStart, authenticationFailure }
+    STATUS        current
+    DESCRIPTION
+       "The basic notifications implemented by an SNMP entity
+        supporting command responder applications."
+    ::= { snmpMIBGroups 7 }
+
+snmpWarmStartNotificationGroup NOTIFICATION-GROUP
+   NOTIFICATIONS { warmStart }
+   STATUS        current
+   DESCRIPTION
+     "An additional notification for an SNMP entity supporting
+     command responder applications, if it is able to reinitialize
+     itself such that its configuration is unaltered."
+  ::= { snmpMIBGroups 11 }
+
+snmpNotificationGroup OBJECT-GROUP
+    OBJECTS { snmpTrapOID, snmpTrapEnterprise }
+    STATUS  current
+    DESCRIPTION
+            "These objects are required for entities
+            which support notification originator applications."
+    ::= { snmpMIBGroups 12 }
+
+-- definitions in RFC 1213 made obsolete by the inclusion of a
+-- subset of the snmp group in this MIB
+
+snmpOutPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Messages which were
+            passed from the SNMP protocol entity to the
+            transport service."
+    ::= { snmp 2 }
+
+-- { snmp 7 } is not used
+
+snmpInTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `tooBig'."
+    ::= { snmp 8 }
+
+snmpInNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `noSuchName'."
+    ::= { snmp 9 }
+
+snmpInBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `badValue'."
+    ::= { snmp 10 }
+
+snmpInReadOnlys OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number valid SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `readOnly'.  It should
+            be noted that it is a protocol error to generate an
+            SNMP PDU which contains the value `readOnly' in the
+            error-status field, as such this object is provided
+            as a means of detecting incorrect implementations of
+            the SNMP."
+    ::= { snmp 11 }
+
+snmpInGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 12 }
+
+snmpInTotalReqVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            retrieved successfully by the SNMP protocol entity
+            as the result of receiving valid SNMP Get-Request
+            and Get-Next PDUs."
+    ::= { snmp 13 }
+
+snmpInTotalSetVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            altered successfully by the SNMP protocol entity as
+            the result of receiving valid SNMP Set-Request PDUs."
+    ::= { snmp 14 }
+
+snmpInGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been accepted and processed by the SNMP
+            protocol entity."
+    ::= { snmp 15 }
+
+snmpInGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 16 }
+
+snmpInSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 17 }
+
+snmpInGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 18 }
+
+snmpInTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 19 }
+
+snmpOutTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `tooBig.'"
+    ::= { snmp 20 }
+
+snmpOutNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status was `noSuchName'."
+    ::= { snmp 21 }
+
+snmpOutBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `badValue'."
+    ::= { snmp 22 }
+
+-- { snmp 23 } is not used
+
+snmpOutGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 24 }
+
+snmpOutGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 25 }
+
+snmpOutGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 26 }
+
+snmpOutSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 27 }
+
+snmpOutGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 28 }
+
+snmpOutTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 29 }
+
+snmpObsoleteGroup OBJECT-GROUP
+    OBJECTS { snmpOutPkts, snmpInTooBigs, snmpInNoSuchNames,
+              snmpInBadValues, snmpInReadOnlys, snmpInGenErrs,
+              snmpInTotalReqVars, snmpInTotalSetVars,
+              snmpInGetRequests, snmpInGetNexts, snmpInSetRequests,
+              snmpInGetResponses, snmpInTraps, snmpOutTooBigs,
+              snmpOutNoSuchNames, snmpOutBadValues,
+              snmpOutGenErrs, snmpOutGetRequests, snmpOutGetNexts,
+              snmpOutSetRequests, snmpOutGetResponses, snmpOutTraps
+              }
+    STATUS  obsolete
+    DESCRIPTION
+            "A collection of objects from RFC 1213 made obsolete
+            by this MIB module."
+    ::= { snmpMIBGroups 10 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt
new file mode 100755
index 0000000000000000000000000000000000000000..1c01e1dfcdc559a2cca3ee57500760fd8eaeb171
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt
@@ -0,0 +1,344 @@
+SNMPv2-SMI DEFINITIONS ::= BEGIN
+
+-- the path to the root
+
+org            OBJECT IDENTIFIER ::= { iso 3 }  --  "iso" = 1
+dod            OBJECT IDENTIFIER ::= { org 6 }
+internet       OBJECT IDENTIFIER ::= { dod 1 }
+
+directory      OBJECT IDENTIFIER ::= { internet 1 }
+
+mgmt           OBJECT IDENTIFIER ::= { internet 2 }
+mib-2          OBJECT IDENTIFIER ::= { mgmt 1 }
+transmission   OBJECT IDENTIFIER ::= { mib-2 10 }
+
+experimental   OBJECT IDENTIFIER ::= { internet 3 }
+
+private        OBJECT IDENTIFIER ::= { internet 4 }
+enterprises    OBJECT IDENTIFIER ::= { private 1 }
+
+security       OBJECT IDENTIFIER ::= { internet 5 }
+
+snmpV2         OBJECT IDENTIFIER ::= { internet 6 }
+
+-- transport domains
+snmpDomains    OBJECT IDENTIFIER ::= { snmpV2 1 }
+
+-- transport proxies
+snmpProxys     OBJECT IDENTIFIER ::= { snmpV2 2 }
+
+-- module identities
+snmpModules    OBJECT IDENTIFIER ::= { snmpV2 3 }
+
+-- Extended UTCTime, to allow dates with four-digit years
+-- (Note that this definition of ExtUTCTime is not to be IMPORTed
+--  by MIB modules.)
+ExtUTCTime ::= OCTET STRING(SIZE(11 | 13))
+    -- format is YYMMDDHHMMZ or YYYYMMDDHHMMZ
+
+    --   where: YY   - last two digits of year (only years
+    --                 between 1900-1999)
+    --          YYYY - last four digits of the year (any year)
+    --          MM   - month (01 through 12)
+    --          DD   - day of month (01 through 31)
+    --          HH   - hours (00 through 23)
+    --          MM   - minutes (00 through 59)
+    --          Z    - denotes GMT (the ASCII character Z)
+    --
+    -- For example, "9502192015Z" and "199502192015Z" represent
+    -- 8:15pm GMT on 19 February 1995. Years after 1999 must use
+    -- the four digit year format. Years 1900-1999 may use the
+    -- two or four digit format.
+
+-- definitions for information modules
+
+MODULE-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "LAST-UPDATED" value(Update ExtUTCTime)
+                  "ORGANIZATION" Text
+                  "CONTACT-INFO" Text
+                  "DESCRIPTION" Text
+                  RevisionPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    RevisionPart ::=
+                  Revisions
+                | empty
+    Revisions ::=
+                  Revision
+                | Revisions Revision
+    Revision ::=
+                  "REVISION" value(Update ExtUTCTime)
+                  "DESCRIPTION" Text
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+OBJECT-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- names of objects
+-- (Note that these definitions of ObjectName and NotificationName
+--  are not to be IMPORTed by MIB modules.)
+
+ObjectName ::=
+    OBJECT IDENTIFIER
+
+NotificationName ::=
+    OBJECT IDENTIFIER
+
+-- syntax of objects
+
+-- the "base types" defined here are:
+--   3 built-in ASN.1 types: INTEGER, OCTET STRING, OBJECT IDENTIFIER
+--   8 application-defined types: Integer32, IpAddress, Counter32,
+--              Gauge32, Unsigned32, TimeTicks, Opaque, and Counter64
+
+ObjectSyntax ::=
+    CHOICE {
+        simple
+            SimpleSyntax,
+          -- note that SEQUENCEs for conceptual tables and
+          -- rows are not mentioned here...
+
+        application-wide
+            ApplicationSyntax
+    }
+
+-- built-in ASN.1 types
+
+SimpleSyntax ::=
+    CHOICE {
+        -- INTEGERs with a more restrictive range
+        -- may also be used
+        integer-value               -- includes Integer32
+            INTEGER (-2147483648..2147483647),
+        -- OCTET STRINGs with a more restrictive size
+        -- may also be used
+        string-value
+            OCTET STRING (SIZE (0..65535)),
+        objectID-value
+            OBJECT IDENTIFIER
+    }
+
+-- indistinguishable from INTEGER, but never needs more than
+-- 32-bits for a two's complement representation
+Integer32 ::=
+        INTEGER (-2147483648..2147483647)
+
+-- application-wide types
+
+ApplicationSyntax ::=
+    CHOICE {
+        ipAddress-value
+            IpAddress,
+        counter-value
+            Counter32,
+        timeticks-value
+            TimeTicks,
+        arbitrary-value
+            Opaque,
+        big-counter-value
+            Counter64,
+        unsigned-integer-value  -- includes Gauge32
+            Unsigned32
+    }
+
+-- in network-byte order
+
+-- (this is a tagged type for historical reasons)
+IpAddress ::=
+    [APPLICATION 0]
+        IMPLICIT OCTET STRING (SIZE (4))
+
+-- this wraps
+Counter32 ::=
+    [APPLICATION 1]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- this doesn't wrap
+Gauge32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- an unsigned 32-bit quantity
+-- indistinguishable from Gauge32
+Unsigned32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- hundredths of seconds since an epoch
+TimeTicks ::=
+    [APPLICATION 3]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- for backward-compatibility only
+Opaque ::=
+    [APPLICATION 4]
+        IMPLICIT OCTET STRING
+
+-- for counters that wrap in less than one hour with only 32 bits
+Counter64 ::=
+    [APPLICATION 6]
+        IMPLICIT INTEGER (0..18446744073709551615)
+
+-- definition for objects
+
+OBJECT-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "SYNTAX" Syntax
+                  UnitsPart
+                  "MAX-ACCESS" Access
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+                  IndexPart
+                  DefValPart
+
+    VALUE NOTATION ::=
+                  value(VALUE ObjectName)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                   type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+    UnitsPart ::=
+                  "UNITS" Text
+                | empty
+
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    IndexPart ::=
+                  "INDEX"    "{" IndexTypes "}"
+                | "AUGMENTS" "{" Entry      "}"
+                | empty
+    IndexTypes ::=
+                  IndexType
+                | IndexTypes "," IndexType
+    IndexType ::=
+                  "IMPLIED" Index
+                | Index
+
+    Index ::=
+                    -- use the SYNTAX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+    Entry ::=
+                    -- use the INDEX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the type specified in
+                  -- SYNTAX clause of same OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions for notifications
+
+NOTIFICATION-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE NotificationName)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+                | empty
+    Objects ::=
+                  Object
+
+                | Objects "," Object
+    Object ::=
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions of administrative identifiers
+
+zeroDotZero    OBJECT-IDENTITY
+    STATUS     current
+    DESCRIPTION
+            "A value used for null identifiers."
+    ::= { 0 0 }
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt
new file mode 100755
index 0000000000000000000000000000000000000000..860bf71eeaa9a5322f5223b99b6115e59fcfbcae
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt
@@ -0,0 +1,772 @@
+SNMPv2-TC DEFINITIONS ::= BEGIN
+
+IMPORTS
+    TimeTicks         FROM SNMPv2-SMI;
+
+-- definition of textual conventions
+
+TEXTUAL-CONVENTION MACRO ::=
+
+BEGIN
+    TYPE NOTATION ::=
+                  DisplayPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  "SYNTAX" Syntax
+
+    VALUE NOTATION ::=
+                   value(VALUE Syntax)      -- adapted ASN.1
+
+    DisplayPart ::=
+                  "DISPLAY-HINT" Text
+                | empty
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+END
+
+DisplayString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+            "Represents textual information taken from the NVT ASCII
+
+            character set, as defined in pages 4, 10-11 of RFC 854.
+
+            To summarize RFC 854, the NVT ASCII repertoire specifies:
+
+              - the use of character codes 0-127 (decimal)
+
+              - the graphics characters (32-126) are interpreted as
+                US ASCII
+
+              - NUL, LF, CR, BEL, BS, HT, VT and FF have the special
+                meanings specified in RFC 854
+
+              - the other 25 codes have no standard interpretation
+
+              - the sequence 'CR LF' means newline
+
+              - the sequence 'CR NUL' means carriage-return
+
+              - an 'LF' not preceded by a 'CR' means moving to the
+                same column on the next line.
+
+              - the sequence 'CR x' for any x other than LF or NUL is
+                illegal.  (Note that this also means that a string may
+                end with either 'CR LF' or 'CR NUL', but not with CR.)
+
+            Any object defined using this syntax may not exceed 255
+            characters in length."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+PhysAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents media- or physical-level addresses."
+    SYNTAX       OCTET STRING
+
+MacAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents an 802 MAC address represented in the
+            `canonical' order defined by IEEE 802.1a, i.e., as if it
+            were transmitted least significant bit first, even though
+            802.5 (in contrast to other 802.x protocols) requires MAC
+            addresses to be transmitted most significant bit first."
+    SYNTAX       OCTET STRING (SIZE (6))
+
+TruthValue ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a boolean value."
+    SYNTAX       INTEGER { true(1), false(2) }
+
+TestAndIncr ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents integer-valued information used for atomic
+            operations.  When the management protocol is used to specify
+            that an object instance having this syntax is to be
+            modified, the new value supplied via the management protocol
+            must precisely match the value presently held by the
+            instance.  If not, the management protocol set operation
+            fails with an error of `inconsistentValue'.  Otherwise, if
+            the current value is the maximum value of 2^31-1 (2147483647
+            decimal), then the value held by the instance is wrapped to
+            zero; otherwise, the value held by the instance is
+            incremented by one.  (Note that regardless of whether the
+            management protocol set operation succeeds, the variable-
+            binding in the request and response PDUs are identical.)
+
+            The value of the ACCESS clause for objects having this
+            syntax is either `read-write' or `read-create'.  When an
+            instance of a columnar object having this syntax is created,
+            any value may be supplied via the management protocol.
+
+            When the network management portion of the system is re-
+            initialized, the value of every object instance having this
+            syntax must either be incremented from its value prior to
+            the re-initialization, or (if the value prior to the re-
+            initialization is unknown) be set to a pseudo-randomly
+            generated value."
+    SYNTAX       INTEGER (0..2147483647)
+
+AutonomousType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents an independently extensible type identification
+            value.  It may, for example, indicate a particular sub-tree
+            with further MIB definitions, or define a particular type of
+            protocol or hardware."
+    SYNTAX       OBJECT IDENTIFIER
+
+InstancePointer ::= TEXTUAL-CONVENTION
+    STATUS       obsolete
+    DESCRIPTION
+            "A pointer to either a specific instance of a MIB object or
+            a conceptual row of a MIB table in the managed device.  In
+            the latter case, by convention, it is the name of the
+            particular instance of the first accessible columnar object
+            in the conceptual row.
+
+            The two uses of this textual convention are replaced by
+            VariablePointer and RowPointer, respectively."
+    SYNTAX       OBJECT IDENTIFIER
+
+VariablePointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A pointer to a specific object instance.  For example,
+            sysContact.0 or ifInOctets.3."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowPointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a pointer to a conceptual row.  The value is the
+            name of the instance of the first accessible columnar object
+            in the conceptual row.
+
+            For example, ifIndex.3 would point to the 3rd row in the
+            ifTable (note that if ifIndex were not-accessible, then
+            ifDescr.3 would be used instead)."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowStatus ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The RowStatus textual convention is used to manage the
+            creation and deletion of conceptual rows, and is used as the
+            value of the SYNTAX clause for the status column of a
+            conceptual row (as described in Section 7.7.1 of [2].)
+
+            The status column has six defined values:
+
+                 - `active', which indicates that the conceptual row is
+                 available for use by the managed device;
+
+                 - `notInService', which indicates that the conceptual
+                 row exists in the agent, but is unavailable for use by
+                 the managed device (see NOTE below); 'notInService' has
+                 no implication regarding the internal consistency of
+                 the row, availability of resources, or consistency with
+                 the current state of the managed device;
+
+                 - `notReady', which indicates that the conceptual row
+                 exists in the agent, but is missing information
+                 necessary in order to be available for use by the
+                 managed device (i.e., one or more required columns in
+                 the conceptual row have not been instanciated);
+
+                 - `createAndGo', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row and to have its status automatically set
+                 to active, making it available for use by the managed
+                 device;
+
+                 - `createAndWait', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row (but not make it available for use by
+                 the managed device); and,
+                 - `destroy', which is supplied by a management station
+                 wishing to delete all of the instances associated with
+                 an existing conceptual row.
+
+            Whereas five of the six values (all except `notReady') may
+            be specified in a management protocol set operation, only
+            three values will be returned in response to a management
+            protocol retrieval operation:  `notReady', `notInService' or
+            `active'.  That is, when queried, an existing conceptual row
+            has only three states:  it is either available for use by
+            the managed device (the status column has value `active');
+            it is not available for use by the managed device, though
+            the agent has sufficient information to attempt to make it
+            so (the status column has value `notInService'); or, it is
+            not available for use by the managed device, and an attempt
+            to make it so would fail because the agent has insufficient
+            information (the state column has value `notReady').
+
+                                     NOTE WELL
+
+                 This textual convention may be used for a MIB table,
+                 irrespective of whether the values of that table's
+                 conceptual rows are able to be modified while it is
+                 active, or whether its conceptual rows must be taken
+                 out of service in order to be modified.  That is, it is
+                 the responsibility of the DESCRIPTION clause of the
+                 status column to specify whether the status column must
+                 not be `active' in order for the value of some other
+                 column of the same conceptual row to be modified.  If
+                 such a specification is made, affected columns may be
+                 changed by an SNMP set PDU if the RowStatus would not
+                 be equal to `active' either immediately before or after
+                 processing the PDU.  In other words, if the PDU also
+                 contained a varbind that would change the RowStatus
+                 value, the column in question may be changed if the
+                 RowStatus was not equal to `active' as the PDU was
+                 received, or if the varbind sets the status to a value
+                 other than 'active'.
+
+            Also note that whenever any elements of a row exist, the
+            RowStatus column must also exist.
+
+            To summarize the effect of having a conceptual row with a
+            status column having a SYNTAX clause value of RowStatus,
+            consider the following state diagram:
+
+                                         STATE
+              +--------------+-----------+-------------+-------------
+              |      A       |     B     |      C      |      D
+              |              |status col.|status column|
+              |status column |    is     |      is     |status column
+    ACTION    |does not exist|  notReady | notInService|  is active
+--------------+--------------+-----------+-------------+-------------
+set status    |noError    ->D|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndGo   |inconsistent- |           |             |
+              |         Value|           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |noError  see 1|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndWait |wrongValue    |           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError
+column to     |         Value|   entValue|             |
+active        |              |           |             |
+              |              |     or    |             |
+              |              |           |             |
+              |              |see 2   ->D|see 8     ->D|          ->D
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError   ->C
+column to     |         Value|   entValue|             |
+notInService  |              |           |             |
+              |              |     or    |             |      or
+              |              |           |             |
+              |              |see 3   ->C|          ->C|see 6
+--------------+--------------+-----------+-------------+-------------
+set status    |noError       |noError    |noError      |noError   ->A
+column to     |              |           |             |      or
+destroy       |           ->A|        ->A|          ->A|see 7
+--------------+--------------+-----------+-------------+-------------
+set any other |see 4         |noError    |noError      |see 5
+column to some|              |           |             |
+value         |              |      see 1|          ->C|          ->D
+--------------+--------------+-----------+-------------+-------------
+
+            (1) goto B or C, depending on information available to the
+            agent.
+
+            (2) if other variable bindings included in the same PDU,
+            provide values for all columns which are missing but
+            required, and all columns have acceptable values, then
+            return noError and goto D.
+
+            (3) if other variable bindings included in the same PDU,
+            provide legal values for all columns which are missing but
+            required, then return noError and goto C.
+
+            (4) at the discretion of the agent, the return value may be
+            either:
+
+                 inconsistentName:  because the agent does not choose to
+                 create such an instance when the corresponding
+                 RowStatus instance does not exist, or
+
+                 inconsistentValue:  if the supplied value is
+                 inconsistent with the state of some other MIB object's
+                 value, or
+
+                 noError: because the agent chooses to create the
+                 instance.
+
+            If noError is returned, then the instance of the status
+            column must also be created, and the new state is B or C,
+            depending on the information available to the agent.  If
+            inconsistentName or inconsistentValue is returned, the row
+            remains in state A.
+
+            (5) depending on the MIB definition for the column/table,
+            either noError or inconsistentValue may be returned.
+
+            (6) the return value can indicate one of the following
+            errors:
+
+                 wrongValue: because the agent does not support
+                 notInService (e.g., an agent which does not support
+                 createAndWait), or
+
+                 inconsistentValue: because the agent is unable to take
+                 the row out of service at this time, perhaps because it
+                 is in use and cannot be de-activated.
+
+            (7) the return value can indicate the following error:
+
+                 inconsistentValue: because the agent is unable to
+                 remove the row at this time, perhaps because it is in
+                 use and cannot be de-activated.
+
+            (8) the transition to D can fail, e.g., if the values of the
+            conceptual row are inconsistent, then the error code would
+            be inconsistentValue.
+
+            NOTE: Other processing of (this and other varbinds of) the
+            set request may result in a response other than noError
+            being returned, e.g., wrongValue, noCreation, etc.
+
+                              Conceptual Row Creation
+
+            There are four potential interactions when creating a
+            conceptual row:  selecting an instance-identifier which is
+            not in use; creating the conceptual row; initializing any
+            objects for which the agent does not supply a default; and,
+            making the conceptual row available for use by the managed
+            device.
+
+            Interaction 1: Selecting an Instance-Identifier
+
+            The algorithm used to select an instance-identifier varies
+            for each conceptual row.  In some cases, the instance-
+            identifier is semantically significant, e.g., the
+            destination address of a route, and a management station
+            selects the instance-identifier according to the semantics.
+
+            In other cases, the instance-identifier is used solely to
+            distinguish conceptual rows, and a management station
+            without specific knowledge of the conceptual row might
+            examine the instances present in order to determine an
+            unused instance-identifier.  (This approach may be used, but
+            it is often highly sub-optimal; however, it is also a
+            questionable practice for a naive management station to
+            attempt conceptual row creation.)
+
+            Alternately, the MIB module which defines the conceptual row
+            might provide one or more objects which provide assistance
+            in determining an unused instance-identifier.  For example,
+            if the conceptual row is indexed by an integer-value, then
+            an object having an integer-valued SYNTAX clause might be
+            defined for such a purpose, allowing a management station to
+            issue a management protocol retrieval operation.  In order
+            to avoid unnecessary collisions between competing management
+            stations, `adjacent' retrievals of this object should be
+            different.
+
+            Finally, the management station could select a pseudo-random
+            number to use as the index.  In the event that this index
+
+            was already in use and an inconsistentValue was returned in
+            response to the management protocol set operation, the
+            management station should simply select a new pseudo-random
+            number and retry the operation.
+
+            A MIB designer should choose between the two latter
+            algorithms based on the size of the table (and therefore the
+            efficiency of each algorithm).  For tables in which a large
+            number of entries are expected, it is recommended that a MIB
+            object be defined that returns an acceptable index for
+            creation.  For tables with small numbers of entries, it is
+            recommended that the latter pseudo-random index mechanism be
+            used.
+
+            Interaction 2: Creating the Conceptual Row
+
+            Once an unused instance-identifier has been selected, the
+            management station determines if it wishes to create and
+            activate the conceptual row in one transaction or in a
+            negotiated set of interactions.
+
+            Interaction 2a: Creating and Activating the Conceptual Row
+
+            The management station must first determine the column
+            requirements, i.e., it must determine those columns for
+            which it must or must not provide values.  Depending on the
+            complexity of the table and the management station's
+            knowledge of the agent's capabilities, this determination
+            can be made locally by the management station.  Alternately,
+            the management station issues a management protocol get
+            operation to examine all columns in the conceptual row that
+            it wishes to create.  In response, for each column, there
+            are three possible outcomes:
+
+                 - a value is returned, indicating that some other
+                 management station has already created this conceptual
+                 row.  We return to interaction 1.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. For those
+                 columns to which the agent provides read-create access,
+                 the `noSuchInstance' exception tells the management
+                 station that it should supply a value for this column
+                 when the conceptual row is to be created.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            Once the column requirements have been determined, a
+            management protocol set operation is accordingly issued.
+            This operation also sets the new instance of the status
+            column to `createAndGo'.
+
+            When the agent processes the set operation, it verifies that
+            it has sufficient information to make the conceptual row
+            available for use by the managed device.  The information
+            available to the agent is provided by two sources:  the
+            management protocol set operation which creates the
+            conceptual row, and, implementation-specific defaults
+            supplied by the agent (note that an agent must provide
+            implementation-specific defaults for at least those objects
+            which it implements as read-only).  If there is sufficient
+            information available, then the conceptual row is created, a
+            `noError' response is returned, the status column is set to
+            `active', and no further interactions are necessary (i.e.,
+            interactions 3 and 4 are skipped).  If there is insufficient
+            information, then the conceptual row is not created, and the
+            set operation fails with an error of `inconsistentValue'.
+            On this error, the management station can issue a management
+            protocol retrieval operation to determine if this was
+            because it failed to specify a value for a required column,
+            or, because the selected instance of the status column
+            already existed.  In the latter case, we return to
+            interaction 1.  In the former case, the management station
+            can re-issue the set operation with the additional
+            information, or begin interaction 2 again using
+            `createAndWait' in order to negotiate creation of the
+            conceptual row.
+
+                                     NOTE WELL
+
+                 Regardless of the method used to determine the column
+                 requirements, it is possible that the management
+                 station might deem a column necessary when, in fact,
+                 the agent will not allow that particular columnar
+                 instance to be created or written.  In this case, the
+                 management protocol set operation will fail with an
+                 error such as `noCreation' or `notWritable'.  In this
+                 case, the management station decides whether it needs
+                 to be able to set a value for that particular columnar
+                 instance.  If not, the management station re-issues the
+                 management protocol set operation, but without setting
+                 a value for that particular columnar instance;
+                 otherwise, the management station aborts the row
+                 creation algorithm.
+
+            Interaction 2b: Negotiating the Creation of the Conceptual
+            Row
+
+            The management station issues a management protocol set
+            operation which sets the desired instance of the status
+            column to `createAndWait'.  If the agent is unwilling to
+            process a request of this sort, the set operation fails with
+            an error of `wrongValue'.  (As a consequence, such an agent
+            must be prepared to accept a single management protocol set
+            operation, i.e., interaction 2a above, containing all of the
+            columns indicated by its column requirements.)  Otherwise,
+            the conceptual row is created, a `noError' response is
+            returned, and the status column is immediately set to either
+            `notInService' or `notReady', depending on whether it has
+            sufficient information to (attempt to) make the conceptual
+            row available for use by the managed device.  If there is
+            sufficient information available, then the status column is
+            set to `notInService'; otherwise, if there is insufficient
+            information, then the status column is set to `notReady'.
+            Regardless, we proceed to interaction 3.
+
+            Interaction 3: Initializing non-defaulted Objects
+
+            The management station must now determine the column
+            requirements.  It issues a management protocol get operation
+            to examine all columns in the created conceptual row.  In
+            the response, for each column, there are three possible
+            outcomes:
+
+                 - a value is returned, indicating that the agent
+                 implements the object-type associated with this column
+                 and had sufficient information to provide a value.  For
+                 those columns to which the agent provides read-create
+                 access (and for which the agent allows their values to
+                 be changed after their creation), a value return tells
+                 the management station that it may issue additional
+                 management protocol set operations, if it desires, in
+                 order to change the value associated with this column.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. However,
+                 the agent does not have sufficient information to
+                 provide a value, and until a value is provided, the
+                 conceptual row may not be made available for use by the
+                 managed device.  For those columns to which the agent
+                 provides read-create access, the `noSuchInstance'
+                 exception tells the management station that it must
+                 issue additional management protocol set operations, in
+                 order to provide a value associated with this column.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            If the value associated with the status column is
+            `notReady', then the management station must first deal with
+            all `noSuchInstance' columns, if any.  Having done so, the
+            value of the status column becomes `notInService', and we
+            proceed to interaction 4.
+
+            Interaction 4: Making the Conceptual Row Available
+
+            Once the management station is satisfied with the values
+            associated with the columns of the conceptual row, it issues
+            a management protocol set operation to set the status column
+            to `active'.  If the agent has sufficient information to
+            make the conceptual row available for use by the managed
+            device, the management protocol set operation succeeds (a
+            `noError' response is returned).  Otherwise, the management
+            protocol set operation fails with an error of
+            `inconsistentValue'.
+
+                                     NOTE WELL
+
+                 A conceptual row having a status column with value
+                 `notInService' or `notReady' is unavailable to the
+                 managed device.  As such, it is possible for the
+                 managed device to create its own instances during the
+                 time between the management protocol set operation
+                 which sets the status column to `createAndWait' and the
+                 management protocol set operation which sets the status
+                 column to `active'.  In this case, when the management
+                 protocol set operation is issued to set the status
+                 column to `active', the values held in the agent
+                 supersede those used by the managed device.
+
+            If the management station is prevented from setting the
+            status column to `active' (e.g., due to management station
+            or network failure) the conceptual row will be left in the
+            `notInService' or `notReady' state, consuming resources
+            indefinitely.  The agent must detect conceptual rows that
+            have been in either state for an abnormally long period of
+            time and remove them.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate what an
+            abnormally long period of time would be.  This period of
+            time should be long enough to allow for human response time
+            (including `think time') between the creation of the
+            conceptual row and the setting of the status to `active'.
+            In the absence of such information in the DESCRIPTION
+            clause, it is suggested that this period be approximately 5
+            minutes in length.  This removal action applies not only to
+            newly-created rows, but also to previously active rows which
+            are set to, and left in, the notInService state for a
+            prolonged period exceeding that which is considered normal
+            for such a conceptual row.
+
+                             Conceptual Row Suspension
+
+            When a conceptual row is `active', the management station
+            may issue a management protocol set operation which sets the
+            instance of the status column to `notInService'.  If the
+            agent is unwilling to do so, the set operation fails with an
+            error of `wrongValue' or `inconsistentValue'.  Otherwise,
+            the conceptual row is taken out of service, and a `noError'
+            response is returned.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate under
+            what circumstances the status column should be taken out of
+            service (e.g., in order for the value of some other column
+            of the same conceptual row to be modified).
+
+                              Conceptual Row Deletion
+
+            For deletion of conceptual rows, a management protocol set
+            operation is issued which sets the instance of the status
+            column to `destroy'.  This request may be made regardless of
+            the current value of the status column (e.g., it is possible
+            to delete conceptual rows which are either `notReady',
+            `notInService' or `active'.)  If the operation succeeds,
+            then all instances associated with the conceptual row are
+            immediately removed."
+    SYNTAX       INTEGER {
+                     -- the following two values are states:
+                     -- these values may be read or written
+                     active(1),
+                     notInService(2),
+                     -- the following value is a state:
+                     -- this value may be read, but not written
+                     notReady(3),
+                     -- the following three values are
+                     -- actions: these values may be written,
+                     --   but are never read
+                     createAndGo(4),
+                     createAndWait(5),
+                     destroy(6)
+                 }
+
+TimeStamp ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The value of the sysUpTime object at which a specific
+            occurrence happened.  The specific occurrence must be
+
+            defined in the description of any object defined using this
+            type.
+
+            If sysUpTime is reset to zero as a result of a re-
+            initialization of the network management (sub)system, then
+            the values of all TimeStamp objects are also reset.
+            However, after approximately 497 days without a re-
+            initialization, the sysUpTime object will reach 2^^32-1 and
+            then increment around to zero; in this case, existing values
+            of TimeStamp objects do not change.  This can lead to
+            ambiguities in the value of TimeStamp objects."
+    SYNTAX       TimeTicks
+
+TimeInterval ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A period of time, measured in units of 0.01 seconds."
+    SYNTAX       INTEGER (0..2147483647)
+
+DateAndTime ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2d-1d-1d,1d:1d:1d.1d,1a1d:1d"
+    STATUS       current
+    DESCRIPTION
+            "A date-time specification.
+
+            field  octets  contents                  range
+            -----  ------  --------                  -----
+              1      1-2   year*                     0..65536
+              2       3    month                     1..12
+              3       4    day                       1..31
+              4       5    hour                      0..23
+              5       6    minutes                   0..59
+              6       7    seconds                   0..60
+                           (use 60 for leap-second)
+              7       8    deci-seconds              0..9
+              8       9    direction from UTC        '+' / '-'
+              9      10    hours from UTC*           0..13
+             10      11    minutes from UTC          0..59
+
+            * Notes:
+            - the value of year is in network-byte order
+            - daylight saving time in New Zealand is +13
+
+            For example, Tuesday May 26, 1992 at 1:30:15 PM EDT would be
+            displayed as:
+
+                             1992-5-26,13:30:15.0,-4:0
+
+            Note that if only local time is known, then timezone
+            information (fields 8-10) is not present."
+    SYNTAX       OCTET STRING (SIZE (8 | 11))
+
+StorageType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Describes the memory realization of a conceptual row.  A
+            row which is volatile(2) is lost upon reboot.  A row which
+            is either nonVolatile(3), permanent(4) or readOnly(5), is
+            backed up by stable storage.  A row which is permanent(4)
+            can be changed but not deleted.  A row which is readOnly(5)
+            cannot be changed nor deleted.
+
+            If the value of an object with this syntax is either
+            permanent(4) or readOnly(5), it cannot be written.
+            Conversely, if the value is either other(1), volatile(2) or
+            nonVolatile(3), it cannot be modified to be permanent(4) or
+            readOnly(5).  (All illegal modifications result in a
+            'wrongValue' error.)
+
+            Every usage of this textual convention is required to
+            specify the columnar objects which a permanent(4) row must
+            at a minimum allow to be writable."
+    SYNTAX       INTEGER {
+                     other(1),       -- eh?
+                     volatile(2),    -- e.g., in RAM
+                     nonVolatile(3), -- e.g., in NVRAM
+                     permanent(4),   -- e.g., partially in ROM
+                     readOnly(5)     -- e.g., completely in ROM
+                 }
+
+TDomain ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a kind of transport service.
+
+          Some possible values, such as snmpUDPDomain, are defined in
+          the SNMPv2-TM MIB module.  Other possible values are defined
+          in other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OBJECT IDENTIFIER
+
+TAddress ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a transport service address.
+
+          A TAddress value is always interpreted within the context of a
+          TDomain value.  Thus, each definition of a TDomain value must
+          be accompanied by a definition of a textual convention for use
+          with that TDomain.  Some possible textual conventions, such as
+          SnmpUDPAddress for snmpUDPDomain, are defined in the SNMPv2-TM
+          MIB module.  Other possible textual conventions are defined in
+          other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+END
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/source/install.sh b/SOL004/snmp_ee_vnf/helm-charts/eechart/source/install.sh
new file mode 100755
index 0000000000000000000000000000000000000000..175f4b6f9d5108e06b96585b0106d5907e9ccdb0
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/source/install.sh
@@ -0,0 +1,32 @@
+#!/bin/bash
+##
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+echo "installing libraries for snmp generator"
+
+#apt-get install -y ...
+apt-get update
+
+apt-get install -y python3-pip unzip build-essential libsnmp-dev wget curl
+curl -s https://storage.googleapis.com/golang/go1.11.8.linux-amd64.tar.gz | tar -v -C /usr/local -xz
+export PATH=$PATH:/usr/local/go/bin
+export GOPATH=/go
+
+go get github.com/go-logfmt/logfmt && go get github.com/go-kit/kit/log
+
+wget -q https://github.com/prometheus/snmp_exporter/archive/v0.17.0.tar.gz -P /tmp/ \
+&& tar -C /tmp -xf /tmp/v0.17.0.tar.gz \
+&& (cd /tmp/snmp_exporter-0.17.0/generator && go build) \
+&& cp /tmp/snmp_exporter-0.17.0/generator/generator /usr/local/bin/snmp_generator
+
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/source/vnf_ee.py b/SOL004/snmp_ee_vnf/helm-charts/eechart/source/vnf_ee.py
new file mode 100755
index 0000000000000000000000000000000000000000..a05012f78635f831a6171a08b6673106383a0fe1
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/source/vnf_ee.py
@@ -0,0 +1,69 @@
+##
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##
+
+import asyncio
+import logging
+import os
+
+
+from osm_ee.exceptions import VnfException
+
+import osm_ee.util.util_ee as util_ee
+
+
+class VnfEE:
+
+    def __init__(self, config_params):
+        self.logger = logging.getLogger('osm_ee.vnf')
+        self.config_params = config_params
+
+    async def config(self, id, params):
+        self.logger.debug("Execute action config params: {}".format(params))
+        # Config action is special, params are merged with previous config calls
+        self.config_params.update(params)
+        required_params = ["ssh-hostname"]
+        self._check_required_params(self.config_params, required_params)
+        yield "OK", "Configured"
+
+    async def sleep(self, id, params):
+        self.logger.debug("Execute action sleep, params: {}".format(params))
+
+        for i in range(3):
+            await asyncio.sleep(5)
+            self.logger.debug("Temporal result return, params: {}".format(params))
+            yield "PROCESSING", f"Processing {i} action id {id}"
+        yield "OK", f"Processed action id {id}"
+
+    async def generate_snmp(self, id, params):
+        self.logger.debug("Executing SNMP exporter configuration generation\nWith params: {}".format(params))
+
+        commands =  ("cp /app/vnf/generator/generator.yml ./",
+                     "snmp_generator generate --output-path=/etc/snmp_exporter/snmp.yml",
+                     "touch /etc/snmp_exporter/generator.yml")
+        for command in commands:
+            return_code, stdout, stderr = await util_ee.local_async_exec(command)
+            if return_code != 0:
+                yield "ERROR", "return code {}: {}".format(return_code, stderr.decode())
+                break
+        else:
+            yield "OK", stdout.decode()
+
+    @staticmethod
+    def _check_required_params(params, required_params):
+        for required_param in required_params:
+            if required_param not in params:
+                raise VnfException("Missing required param: {}".format(required_param))
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/NOTES.txt b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/NOTES.txt
new file mode 100755
index 0000000000000000000000000000000000000000..c52fc2c419ef6f4cccfb63fd93ca7379bfc04cf7
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/NOTES.txt
@@ -0,0 +1,21 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ . }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "eechart.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "eechart.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "eechart.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "eechart.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl port-forward $POD_NAME 8080:80
+{{- end }}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/_helpers.tpl b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
new file mode 100755
index 0000000000000000000000000000000000000000..d3e28e0260b8bff2fdef09046df0abaea885739c
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
@@ -0,0 +1,56 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "eechart.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "eechart.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "eechart.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Common labels
+*/}}
+{{- define "eechart.labels" -}}
+app.kubernetes.io/name: {{ include "eechart.name" . }}
+helm.sh/chart: {{ include "eechart.chart" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end -}}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "eechart.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create -}}
+    {{ default (include "eechart.fullname" .) .Values.serviceAccount.name }}
+{{- else -}}
+    {{ default "default" .Values.serviceAccount.name }}
+{{- end -}}
+{{- end -}}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/configmap.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/configmap.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..5b9634c7e1abe64c6f720f708dd5c9664e72e8cf
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/configmap.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "eechart.fullname" . }}
+data:
+{{ (.Files.Glob "source/*").AsConfig | indent 2 }}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/generator.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/generator.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..96f7e237d85cecfba6f7047c169ba09fdcb8865e
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/generator.yaml
@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower }}"
+data:
+  generator.yml: |-
+    {{ .Files.Get "snmp/generator.yml" | nindent 4}}
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/ingress.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/ingress.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..264f89091bee2ba8746edc2841c275d28fef1168
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/ingress.yaml
@@ -0,0 +1,41 @@
+{{- if .Values.ingress.enabled -}}
+{{- $fullName := include "eechart.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+{{- if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1beta1
+{{- else -}}
+apiVersion: extensions/v1beta1
+{{- end }}
+kind: Ingress
+metadata:
+  name: {{ $fullName }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+{{- if .Values.ingress.tls }}
+  tls:
+  {{- range .Values.ingress.tls }}
+    - hosts:
+      {{- range .hosts }}
+        - {{ . | quote }}
+      {{- end }}
+      secretName: {{ .secretName }}
+  {{- end }}
+{{- end }}
+  rules:
+  {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+        {{- range .paths }}
+          - path: {{ . }}
+            backend:
+              serviceName: {{ $fullName }}
+              servicePort: {{ $svcPort }}
+        {{- end }}
+  {{- end }}
+{{- end }}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/mibs.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/mibs.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e7b5eab55038ea9e0d17d7c8d0b9fc7dc15ddfe6
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/mibs.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+{{ (.Files.Glob "snmp/mibs/**").AsConfig | indent 2 }}
\ No newline at end of file
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/service.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/service.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..88d38d66a3997c6e2a96754582736cfb065da6c2
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/service.yaml
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: grpc
+      protocol: TCP
+      name: grpc
+  selector:
+    app.kubernetes.io/name: {{ include "eechart.name" . }}
+    app.kubernetes.io/instance: {{ .Release.Name }}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..be615a5f08c7b557446fa74e5e3619e47d2ee804
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
@@ -0,0 +1,8 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ template "eechart.serviceAccountName" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+{{- end -}}
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/statefulset.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..c188ad1d98bb93247c8fa0ee9132d9494f43e8ff
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
@@ -0,0 +1,60 @@
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: {{ include "eechart.fullname" . }}
+spec:
+  serviceName:  {{ include "eechart.fullname" . }} 
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ include "eechart.name" . }}
+      app.kubernetes.io/instance: {{ .Release.Name }}
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ include "eechart.name" . }}
+        app.kubernetes.io/instance: {{ .Release.Name }}
+        vnf: {{ .Values.global.osm.vnf_id | lower}}
+    spec:
+      imagePullSecrets:
+      - name: regcred 
+      serviceAccountName: {{ template "eechart.serviceAccountName" . }}
+      securityContext:
+        runAsUser: 0
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: grpc
+              containerPort: 50051
+              protocol: TCP          
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}          
+          volumeMounts:
+          - name: osm-ee
+            mountPath: /app/storage  
+          - name: osm-ee-source
+            mountPath: /app/EE/osm_ee/vnf      
+          - name: snmp-config-volume
+            mountPath: /etc/snmp_exporter
+          - name: vnf-mibs
+            mountPath: /root/.snmp/mibs
+          - name: vnf-generator
+            mountPath: /app/vnf/generator
+      volumes:      
+      - name: osm-ee-source
+        configMap: 
+          name:  {{ include "eechart.fullname" . }}
+      - name: snmp-config-volume
+        hostPath: 
+          path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+      - name: vnf-mibs
+        configMap:
+          name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+      - name: vnf-generator
+        configMap:
+          name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower}}"
+      - name: osm-ee
+        hostPath:
+          path: /var/lib/osm/osm/osm_osm_packages/_data
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..e52b7b8b2515729e582b5efbc22dc5a0bdb0f3b2
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "eechart.fullname" . }}-test-connection"
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  annotations:
+    "helm.sh/hook": test-success
+spec:
+  containers:
+    - name: wget
+      image: busybox
+      command: ['wget']
+      args:  ['{{ include "eechart.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
diff --git a/SOL004/snmp_ee_vnf/helm-charts/eechart/values.yaml b/SOL004/snmp_ee_vnf/helm-charts/eechart/values.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..7006b5df1ac6ad4972e7f9a535f26ebff21176ae
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/helm-charts/eechart/values.yaml
@@ -0,0 +1,72 @@
+global:
+  osm:
+    vnf_id: AVNFId
+
+# Default values for eechart.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: illoret/grpcee
+  tag: latest
+  pullPolicy: IfNotPresent
+
+imagePullSecrets: []
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  # Specifies whether a service account should be created
+  create: false
+  # The name of the service account to use.
+  # If not set and create is true, a name is generated using the fullname template
+  name:
+
+podSecurityContext: {}
+  # fsGroup: 2000
+
+securityContext: {}
+  # capabilities:
+  #   drop:
+  #   - ALL
+  # readOnlyRootFilesystem: true
+  # runAsNonRoot: true
+  # runAsUser: 1000
+
+service:
+  type: ClusterIP
+  port: 50050
+
+ingress:
+  enabled: false
+  annotations: {}
+    # kubernetes.io/ingress.class: nginx
+    # kubernetes.io/tls-acme: "true"
+  hosts:
+    - host: chart-example.local
+      paths: []
+
+  tls: []
+  #  - secretName: chart-example-tls
+  #    hosts:
+  #      - chart-example.local
+
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 100m
+  #   memory: 128Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
diff --git a/SOL004/snmp_ee_vnf/snmp_ee_vnfd.yaml b/SOL004/snmp_ee_vnf/snmp_ee_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..478e0322c21c07c571b5bec433835f7ac49ce228
--- /dev/null
+++ b/SOL004/snmp_ee_vnf/snmp_ee_vnfd.yaml
@@ -0,0 +1,97 @@
+vnfd:
+  description: A basic virtual router with SNMP metrics collection
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: vyos-VM
+    vdu-profile:
+    - id: vyos-VM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - execution-environment-ref: monitor
+            name: generate_snmp
+          execution-environment-list:
+          - external-connection-point-ref: vnf-mgmt-ext
+            helm-chart: eechart
+            id: monitor
+            metric-service: snmpexporter
+          id: snmp_ee-vnf
+          initial-config-primitive:
+          - execution-environment-ref: monitor
+            name: config
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: osm
+            - name: ssh-password
+              value: osm2020
+            seq: 1
+          - execution-environment-ref: monitor
+            name: generate_snmp
+            seq: 2
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: vyos-VM
+  - id: vnf-internal-ext
+    int-cpd:
+      cpd: vdu-eth1-int
+      vdu-id: vyos-VM
+  - id: vnf-external-ext
+    int-cpd:
+      cpd: vdu-eth2-int
+      vdu-id: vyos-VM
+  id: snmp_ee-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: snmp_ee-vnf
+  sw-image-desc:
+  - id: vyos-1.1.7
+    image: vyos-1.1.7
+    name: vyos-1.1.7
+  vdu:
+  - cloud-init-file: vyos-userdata
+    id: vyos-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        position: 0
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth1-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth1
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth2-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth2
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: vyos-VM
+    supplemental-boot-data:
+      boot-data-drive: true
+    sw-image-desc: vyos-1.1.7
+    virtual-compute-desc: vyos-VM-compute
+    virtual-storage-desc:
+    - vyos-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: vyos-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: vyos-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/snmp_setcomm_ee_ns/snmp_setcomm_ee_nsd.yaml b/SOL004/snmp_setcomm_ee_ns/snmp_setcomm_ee_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8576e17f7c1d4a799c392ea6553cf7de6bfb0fb2
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_ns/snmp_setcomm_ee_nsd.yaml
@@ -0,0 +1,31 @@
+nsd:
+  nsd:
+  - description: Single VyOS Router VNF with SNMP metrics
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: VyOS Router
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-internal-ext
+          virtual-link-profile-id: internal
+        - constituent-cpd-id:
+          - constituent-base-element-id: VyOS Router
+            constituent-cpd-id: vnf-external-ext
+          virtual-link-profile-id: external
+        vnfd-id: snmp_setcomm_ee-vnf
+    id: snmp_setcomm_ee-ns
+    name: snmp_setcomm_ee-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: internal
+    - id: external
+    vnfd-id:
+    - snmp_setcomm_ee-vnf
diff --git a/SOL004/snmp_setcomm_ee_vnf/cloud_init/vyos-userdata b/SOL004/snmp_setcomm_ee_vnf/cloud_init/vyos-userdata
new file mode 100644
index 0000000000000000000000000000000000000000..65a20db7d738af72bf6ce919f241c875319f5693
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/cloud_init/vyos-userdata
@@ -0,0 +1,21 @@
+#!/bin/vbash
+source /opt/vyatta/etc/functions/script-template
+# Interface Config eth0
+set interfaces ethernet eth0 address dhcp
+set interfaces ethernet eth0 description VyOS-eth0
+# Interface Config eth1
+set interfaces ethernet eth1 address 10.0.0.1/24
+set interfaces ethernet eth1 description VyOS-eth1
+# Interface Config eth2
+set interfaces ethernet eth2 address 10.1.0.1/24
+set interfaces ethernet eth2 description VyOS-eth2
+# System config
+set system host-name vyos-osmTest
+set service ssh listen-address 0.0.0.0
+set service ssh port 22
+set system login user osm authentication plaintext-password osm2020
+# SNMP
+set service snmp location "OSM Labs"
+# Save
+commit
+save
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/.helmignore b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/.helmignore
new file mode 100755
index 0000000000000000000000000000000000000000..50af0317254197a5a019f4ac2f8ecc223f93f5a7
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/.helmignore
@@ -0,0 +1,22 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/Chart.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/Chart.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..414c5f1aa1becbd34d69342874b63db8bb1cb77c
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/Chart.yaml
@@ -0,0 +1,5 @@
+apiVersion: v1
+appVersion: "1.0"
+description: OSM EE helm chart
+name: eechart
+version: 0.1.0
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore
new file mode 100644
index 0000000000000000000000000000000000000000..691fa13d6a54c577aca389fe34f4d9e237824a12
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/.helmignore
@@ -0,0 +1,23 @@
+# Patterns to ignore when building packages.
+# This supports shell glob matching, relative path matching, and
+# negation (prefixed with !). Only one pattern per line.
+.DS_Store
+# Common VCS dirs
+.git/
+.gitignore
+.bzr/
+.bzrignore
+.hg/
+.hgignore
+.svn/
+# Common backup files
+*.swp
+*.bak
+*.tmp
+*.orig
+*~
+# Various IDEs
+.project
+.idea/
+*.tmproj
+.vscode/
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..eeb867cb0b4c7dfbdb2d2a7d99391ec703b34836
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/Chart.yaml
@@ -0,0 +1,10 @@
+apiVersion: v1
+name: snmpexporter
+description: SNMP Exporter for OSM VNF
+type: application
+version: 1.0.0
+appVersion: 1.0.0
+dependencies:
+  - name: snmp-exporter
+    version: "0.17.0"
+    repository: "https://hub.docker.com/r/prom/snmp-exporter"
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
new file mode 100644
index 0000000000000000000000000000000000000000..a2aef96ec04b3c6f2e24906331d53467d7be8033
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/_helpers.tpl
@@ -0,0 +1,63 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "snmpexporter.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "snmpexporter.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "snmpexporter.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "snmpexporter.labels" -}}
+helm.sh/chart: {{ include "snmpexporter.chart" . }}
+{{ include "snmpexporter.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "snmpexporter.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "snmpexporter.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "snmpexporter.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create }}
+{{- default (include "snmpexporter.fullname" .) .Values.serviceAccount.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.name }}
+{{- end }}
+{{- end }}
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..fcf2f18159a0b6ee431b4bcffc8c02817bd79ae0
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/base-config.yaml
@@ -0,0 +1,20071 @@
+
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+  snmp.yml: |-
+    # WARNING: This file was auto-generated using snmp_exporter generator, manual changes will be lost.
+    apcups:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.4.1.318.1.1.1.12
+      - 1.3.6.1.4.1.318.1.1.1.2
+      - 1.3.6.1.4.1.318.1.1.1.3
+      - 1.3.6.1.4.1.318.1.1.1.4
+      - 1.3.6.1.4.1.318.1.1.1.7.2
+      - 1.3.6.1.4.1.318.1.1.10.2.3.2
+      - 1.3.6.1.4.1.318.1.1.26.8.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.318.1.1.1.8.1.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: upsOutletGroupStatusTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.1.1
+      - name: upsOutletGroupStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.1
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupStatusGroupState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.3
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupStatusOn
+          2: upsOutletGroupStatusOff
+          3: upsOutletGroupStatusUnknown
+      - name: upsOutletGroupStatusCommandPending
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        type: gauge
+        help: Getting this variable will return the command pending state of the outlet
+          group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.4
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsOutletGroupCommandPending
+          2: upsOutletGroupNoCommandPending
+      - name: upsOutletGroupStatusOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.5
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupStatusGroupFullState
+        oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        type: DisplayString
+        help: An ASCII string containing the 32 flags representing the current state(s)
+          of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.1.2.1.6
+        indexes:
+        - labelname: upsOutletGroupStatusIndex
+          type: gauge
+        lookups:
+        - labels:
+          - upsOutletGroupStatusIndex
+          labelname: upsOutletGroupStatusName
+          oid: 1.3.6.1.4.1.318.1.1.1.12.1.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: upsOutletGroupStatusIndex
+      - name: upsOutletGroupConfigTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.2.1
+      - name: upsOutletGroupConfigIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.1
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        type: DisplayString
+        help: The name of the outlet group. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.2
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOnDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering on when
+          the delayed on, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.3
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigPowerOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        type: gauge
+        help: The amount of time (seconds) the outlet group will delay powering off when
+          the delayed off, reboot, or shutdown command is applied - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.4
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigRebootDuration
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        type: gauge
+        help: During a reboot sequence, power is turned off and then back on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.5
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigMinReturnRuntime
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        type: gauge
+        help: In an Outlet Group shutdown sequence, the Outlet Group cycles power off
+          then on - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.6
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.7
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsOutletGroupConfigLoadShedControlSkipOffDelay
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        type: gauge
+        help: Configures whether the outlet group's off delay setting (upsOutletGroupConfigPowerOffDelay)
+          will be used in a load shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.8
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigSkipOffDelay
+          2: upsOutletGroupConfigUseOffDelay
+      - name: upsOutletGroupConfigLoadShedControlAutoRestart
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        type: gauge
+        help: Configures whether the outlet group will automatically restart after a load
+          shedding situation, where applicable. - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.9
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigAutoRestart
+          2: upsOutletGroupConfigManualRestart
+      - name: upsOutletGroupConfigLoadShedControlTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) after the
+          UPS's time on battery has exceeded the upsOutletGroupConfigLoadShedTimeOnBattery
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.10
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableTimeOnBatteryLoadShed
+          2: upsOutletGroupConfigEnableTimeOnBatteryLoadShed
+      - name: upsOutletGroupConfigLoadShedControlRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is on battery and the remaining runtime is less than the upsOutletGroupConfigLoadShedRuntimeRemaining
+          OID setting - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.11
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableRuntimeRemainingLoadShed
+          2: upsOutletGroupConfigEnableRuntimeRemainingLoadShed
+      - name: upsOutletGroupConfigLoadShedControlInOverload
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        type: gauge
+        help: Configures whether the outlet group will load shed (turn off) when the UPS
+          is in an overload condition - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.12
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupConfigDisableInOverloadLoadShed
+          2: upsOutletGroupConfigEnableInOverloadLoadShed
+      - name: upsOutletGroupConfigLoadShedTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        type: gauge
+        help: When the UPS has been on battery for more time than this value, the outlet
+          group will turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlTimeOnBattery
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.13
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupConfigLoadShedRuntimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        type: gauge
+        help: When the runtime remaining is less than this value, the outlet group will
+          turn off if this condition is enabled by the upsOutletGroupConfigLoadShedControlRuntimeRemaining
+          OID - 1.3.6.1.4.1.318.1.1.1.12.2.2.1.14
+        indexes:
+        - labelname: upsOutletGroupConfigIndex
+          type: gauge
+      - name: upsOutletGroupControlTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.1
+        type: gauge
+        help: The number of outlet groups for the UPS. - 1.3.6.1.4.1.318.1.1.1.12.3.1
+      - name: upsOutletGroupControlIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        type: gauge
+        help: The index to the outlet group entry. - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.1
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlName
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        type: DisplayString
+        help: The name of the outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.2
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+      - name: upsOutletGroupControlCommand
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        type: gauge
+        help: Getting this variable will return the outlet group state - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.3
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsOutletGroupImmediateOn
+          2: upsOutletGroupImmediateOff
+          3: upsOutletGroupImmediateRebootWithOrWithoutAC
+          4: upsOutletGroupDelayedOn
+          5: upsOutletGroupDelayedOff
+          6: upsOutletGroupDelayedRebootWithOrWithoutAC
+          7: upsOutletGroupCancelPendingCommand
+          8: upsOutletGroupControlUnknown
+          9: upsOutletGroupImmediateRebootShutdown
+          10: upsOutletGroupDelayedRebootShutdown
+      - name: upsOutletGroupControlOutletType
+        oid: 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        type: gauge
+        help: Getting this variable will return the type of outlet group - 1.3.6.1.4.1.318.1.1.1.12.3.2.1.4
+        indexes:
+        - labelname: upsOutletGroupControlIndex
+          type: gauge
+        enum_values:
+          1: upsSwitchedOutletGroup
+          2: upsMainOutletGroup
+      - name: upsBasicBatteryStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.1
+        type: gauge
+        help: The status of the UPS batteries - 1.3.6.1.4.1.318.1.1.1.2.1.1
+        enum_values:
+          1: unknown
+          2: batteryNormal
+          3: batteryLow
+          4: batteryInFaultCondition
+      - name: upsBasicBatteryTimeOnBattery
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.2
+        type: gauge
+        help: The elapsed time since the UPS has switched to battery power. - 1.3.6.1.4.1.318.1.1.1.2.1.2
+      - name: upsBasicBatteryLastReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.1.3
+        type: DisplayString
+        help: The date when the UPS system's batteries were last replaced in mm/dd/yy
+          (or yyyy) format - 1.3.6.1.4.1.318.1.1.1.2.1.3
+      - name: upsAdvBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.1
+        type: gauge
+        help: The remaining battery capacity expressed in percent of full capacity. -
+          1.3.6.1.4.1.318.1.1.1.2.2.1
+      - name: upsAdvBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.2
+        type: gauge
+        help: The current internal UPS temperature expressed in Celsius - 1.3.6.1.4.1.318.1.1.1.2.2.2
+      - name: upsAdvBatteryRunTimeRemaining
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.3
+        type: gauge
+        help: The UPS battery run time remaining before battery exhaustion. - 1.3.6.1.4.1.318.1.1.1.2.2.3
+      - name: upsAdvBatteryReplaceIndicator
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.4
+        type: gauge
+        help: Indicates whether the UPS batteries need replacing. - 1.3.6.1.4.1.318.1.1.1.2.2.4
+        enum_values:
+          1: noBatteryNeedsReplacing
+          2: batteryNeedsReplacing
+      - name: upsAdvBatteryNumOfBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.5
+        type: gauge
+        help: The number of external battery packs connected to the UPS - 1.3.6.1.4.1.318.1.1.1.2.2.5
+      - name: upsAdvBatteryNumOfBadBattPacks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.6
+        type: gauge
+        help: The number of external battery packs connected to the UPS that are defective
+          - 1.3.6.1.4.1.318.1.1.1.2.2.6
+      - name: upsAdvBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.7
+        type: gauge
+        help: The nominal battery voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.7
+      - name: upsAdvBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.8
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.8
+      - name: upsAdvBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.9
+        type: gauge
+        help: The battery current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.9
+      - name: upsAdvTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.10
+        type: gauge
+        help: The total DC current in Amps. - 1.3.6.1.4.1.318.1.1.1.2.2.10
+      - name: upsAdvBatteryFullCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.11
+        type: gauge
+        help: The full chargeable capacity of the battery which is expressed in percentage.
+          - 1.3.6.1.4.1.318.1.1.1.2.2.11
+      - name: upsAdvBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.1
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        type: gauge
+        help: The selected Battery Voltage Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.2
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        type: gauge
+        help: The actual battery bus voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.2.2.12.1.3
+        indexes:
+        - labelname: upsAdvBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.1
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        type: gauge
+        help: The selected Battery Current Polarity - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.2
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvTotalFrameDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        type: gauge
+        help: The Total DC Current of battery in Amperes. - 1.3.6.1.4.1.318.1.1.1.2.2.13.1.3
+        indexes:
+        - labelname: upsAdvTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.1
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        type: gauge
+        help: The battery frame identifier. - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.2
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        type: gauge
+        help: The selected Battery current polarity - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.3
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsAdvBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        type: gauge
+        help: The Battery current measured in Amperes - 1.3.6.1.4.1.318.1.1.1.2.2.14.1.4
+        indexes:
+        - labelname: upsAdvBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsAdvBatteryCurrentIndex
+          type: gauge
+      - name: upsAdvBatteryEstimatedChargeTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.15
+        type: gauge
+        help: The estimated remaining time required to charge the UPS to a full state
+          of charge. - 1.3.6.1.4.1.318.1.1.1.2.2.15
+      - name: upsAdvBatteryPower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.16
+        type: gauge
+        help: The measured battery power in kW. - 1.3.6.1.4.1.318.1.1.1.2.2.16
+      - name: upsAdvBatteryChargerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.17
+        type: EnumAsStateSet
+        help: The status of the battery charger - 1.3.6.1.4.1.318.1.1.1.2.2.17
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+          4: floatCharging
+          5: boostCharging
+          6: resting
+          7: notCharging
+          8: equalizationCharging
+          9: testInProgress
+          10: cyclicFloatCharging
+      - name: upsAdvBatteryInternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.19
+        type: DisplayString
+        help: The SKU of the internal battery. - 1.3.6.1.4.1.318.1.1.1.2.2.19
+      - name: upsAdvBatteryExternalSKU
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.20
+        type: DisplayString
+        help: The SKU of the external battery. - 1.3.6.1.4.1.318.1.1.1.2.2.20
+      - name: upsAdvBatteryRecommendedReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.21
+        type: DisplayString
+        help: The recommended replacement date for the battery based on the UPS internal
+          battery life algorithm. - 1.3.6.1.4.1.318.1.1.1.2.2.21
+      - name: upsAdvBatteryNominalBackupTime
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.22
+        type: gauge
+        help: Defines the runtime of the user supplied battery in minutes, when battery
+          is new. - 1.3.6.1.4.1.318.1.1.1.2.2.22
+      - name: upsAdvBatteryCondition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.23
+        type: EnumAsStateSet
+        help: Health of the battries based on the battery test. - 1.3.6.1.4.1.318.1.1.1.2.2.23
+        enum_values:
+          1: unknown
+          2: ok
+          3: weak
+          4: poor
+      - name: upsAdvBatteryChargingCurrentRestricted
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.24
+        type: EnumAsStateSet
+        help: Indicates whether battery charging current is restricted or not - 1.3.6.1.4.1.318.1.1.1.2.2.24
+        enum_values:
+          1: "yes"
+          2: "no"
+      - name: upsAdvBatteryTotalCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.25
+        type: gauge
+        help: The actual available battery capacity of the system expressed in ampere
+          hours (Ah) - 1.3.6.1.4.1.318.1.1.1.2.2.25
+      - name: upsAdvBatteryFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.26
+        type: gauge
+        help: If battery system has one common fuse for the battery system, the status
+          is given by this value - 1.3.6.1.4.1.318.1.1.1.2.2.26
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsAdvBatteryBreakerStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.27
+        type: gauge
+        help: The value indicates the aggregated status of the battery breakers in the
+          system - 1.3.6.1.4.1.318.1.1.1.2.2.27
+        enum_values:
+          1: disconnected
+          2: closed
+          3: notPresent
+      - name: upsAdvBatteryWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.2.28
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.2.28
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsHighPrecBatteryCapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.1
+        type: gauge
+        help: The remaining battery capacity expressed in tenths of percent of full capacity.
+          - 1.3.6.1.4.1.318.1.1.1.2.3.1
+      - name: upsHighPrecBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.2
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.2
+      - name: upsHighPrecBatteryNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.3
+        type: gauge
+        help: The nominal battery voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.3
+      - name: upsHighPrecBatteryActualVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.4
+        type: gauge
+        help: The actual battery bus voltage in tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.4
+      - name: upsHighPrecBatteryCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.5
+        type: gauge
+        help: The battery current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.5
+      - name: upsHighPrecTotalDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.6
+        type: gauge
+        help: The total DC current in tenths of Amps. - 1.3.6.1.4.1.318.1.1.1.2.3.6
+      - name: upsHighPrecBatteryActualVoltageTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryActualVoltagePolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        type: gauge
+        help: The selected Battery Voltage polarity - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        type: gauge
+        help: The actual battery bus voltage expressed as tenths of Volts. - 1.3.6.1.4.1.318.1.1.1.2.3.7.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryActualVoltageTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        type: gauge
+        help: The Battery Frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.1
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecTotalDCCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.2
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecTotalDCFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        type: gauge
+        help: The total DC current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.8.1.3
+        indexes:
+        - labelname: upsHighPrecTotalDCCurrentTableIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentTableIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        type: gauge
+        help: The Battery frame identifier - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryCurrentPolarity
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        type: gauge
+        help: The selected Battery Current polarity - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+        enum_values:
+          0: positive
+          1: negative
+      - name: upsHighPrecBatteryFrameCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        type: gauge
+        help: The Battery current in tenths of Amperes. - 1.3.6.1.4.1.318.1.1.1.2.3.9.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryCurrentTableIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCurrentIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.1
+      - name: upsHighPrecBatteryPackIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryCartridgeIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        type: gauge
+        help: The battery cartridge identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackSerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        type: OctetString
+        help: The battery cartridge health - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        type: DisplayString
+        help: The battery cartridge estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        type: DisplayString
+        help: The battery cartridge install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.9
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackCartridgeStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        type: OctetString
+        help: The battery cartridge status - 1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10
+        indexes:
+        - labelname: upsHighPrecBatteryPackIndex
+          type: gauge
+        - labelname: upsHighPrecBatteryCartridgeIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTableSize
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+        type: gauge
+        help: The number of entries in the upsHighPrecBatteryPacks. - 1.3.6.1.4.1.318.1.1.1.2.3.10.3
+      - name: upsHighPrecBatteryPackOnlyIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        type: gauge
+        help: The battery pack identifier. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.1
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyFirmwareRevision
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        type: DisplayString
+        help: The battery pack firmware revision. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.2
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlySerialNumber
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        type: DisplayString
+        help: The battery pack serial number. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.3
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        type: gauge
+        help: The battery pack temperature measured in 10ths of degree Celcius - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.4
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        type: OctetString
+        help: The battery status for the pack only - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        type: OctetString
+        help: The battery pack health - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.6
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyReplaceDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        type: DisplayString
+        help: The battery pack estimated battery replace date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.7
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryPackOnlyInstallDate
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        type: DisplayString
+        help: The battery pack install date. - 1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.8
+        indexes:
+        - labelname: upsHighPrecBatteryPackOnlyIndex
+          type: gauge
+      - name: upsHighPrecBatteryHealth
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.11
+        type: OctetString
+        help: The battery health - 1.3.6.1.4.1.318.1.1.1.2.3.11
+      - name: upsHighPrecActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.12
+        type: gauge
+        help: Active Power of Battery in tenths of kW - 1.3.6.1.4.1.318.1.1.1.2.3.12
+      - name: upsHighPrecExtdBatteryTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.3.13
+        type: gauge
+        help: The current internal UPS temperature expressed in tenths of degrees Celsius
+          - 1.3.6.1.4.1.318.1.1.1.2.3.13
+      - name: upsBatteryNumberOfCabinets
+        oid: 1.3.6.1.4.1.318.1.1.1.2.4
+        type: gauge
+        help: The value indicates the number of battery cabinets in total, internal and
+          external - 1.3.6.1.4.1.318.1.1.1.2.4
+      - name: upsBatteryCabinetIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        type: gauge
+        help: The Battery Cabinet identifier - 1.3.6.1.4.1.318.1.1.1.2.5.1.1
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        type: gauge
+        help: The identification number for the actual battery cabinet in the system -
+          1.3.6.1.4.1.318.1.1.1.2.5.1.2
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetWiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        type: gauge
+        help: The value indicates the wiring configuration, whether the battery is 2-wire
+          or 3-wire - 1.3.6.1.4.1.318.1.1.1.2.5.1.3
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: twoWire
+          2: threeWire
+      - name: upsBatteryCabinetVoltagePolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        type: gauge
+        help: The battery voltage - 1.3.6.1.4.1.318.1.1.1.2.5.1.4
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetVoltagePolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        type: gauge
+        help: The voltage for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.5
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity1
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        type: gauge
+        help: The battery current - 1.3.6.1.4.1.318.1.1.1.2.5.1.6
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetCurrentPolarity2
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        type: gauge
+        help: The current for the second side/half of the battery in a split battery system
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.7
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        type: gauge
+        help: The measured temperature of the battery cabinet in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.8
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        type: gauge
+        help: The highest temperature measured for the battery in the battery cabinet
+          in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.9
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        type: gauge
+        help: The lowest temperature measured for the battery in the battery cabinet in
+          tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.5.1.10
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        type: gauge
+        help: The average temperature for all the battery sensors in the battery cabinet
+          and for the battery strings, if battery strings are present - 1.3.6.1.4.1.318.1.1.1.2.5.1.11
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetFuse
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        type: gauge
+        help: If the battery cabinet has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.5.1.12
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabinetBreaker
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        type: gauge
+        help: The value indicates the battery cabinet breaker status - 1.3.6.1.4.1.318.1.1.1.2.5.1.13
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+        enum_values:
+          1: noBreaker
+          2: unknown
+          3: breakerOpen
+          4: breakerClosed
+      - name: upsBatteryCabinetNumberOfStrings
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        type: gauge
+        help: The number of battery strings in the battery cabinet - 1.3.6.1.4.1.318.1.1.1.2.5.1.14
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfVerticalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        type: gauge
+        help: The number of vertical levels or shelves for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.15
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabinetNumberOfHorizontalPositions
+        oid: 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        type: gauge
+        help: The number of horizontal positions for battery blocks/modules - 1.3.6.1.4.1.318.1.1.1.2.5.1.16
+        indexes:
+        - labelname: upsBatteryCabinetIndex
+          type: gauge
+      - name: upsBatteryCabStringIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        type: gauge
+        help: The battery cabinet string identifier - 1.3.6.1.4.1.318.1.1.1.2.6.1.1
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCabReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        type: gauge
+        help: Reference to the global battery cabinet index where the battery string is
+          placed. - 1.3.6.1.4.1.318.1.1.1.2.6.1.2
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        type: gauge
+        help: Local battery string identification index in the actual battery cabinet
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.6.1.3
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        type: gauge
+        help: The current in a battery string or battery halfstring, in tenths of Amps.
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.4
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringAverageTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        type: gauge
+        help: Temperature of the battery string or the average of the aggregated temperature
+          of each battery block/module (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.5
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMaxTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        type: gauge
+        help: The actual highest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.6
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringMinTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        type: gauge
+        help: The actual lowest battery temperature measurement for the battery blocks/modules
+          (in tenths of degrees Celcius). - 1.3.6.1.4.1.318.1.1.1.2.6.1.7
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabStringFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        type: gauge
+        help: If the battery string has a common fuse, the status is given by this value
+          - 1.3.6.1.4.1.318.1.1.1.2.6.1.8
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabStringNumberOfBlocks
+        oid: 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        type: gauge
+        help: The number of battery blocks/modules in a battery string - 1.3.6.1.4.1.318.1.1.1.2.6.1.9
+        indexes:
+        - labelname: upsBatteryCabStringIndex
+          type: gauge
+      - name: upsBatteryCabBlockIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        type: gauge
+        help: The battery cabinet block identifier - 1.3.6.1.4.1.318.1.1.1.2.7.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockStringReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        type: gauge
+        help: Reference to the specific global battery string index - 1.3.6.1.4.1.318.1.1.1.2.7.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery string
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockPresent
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        type: gauge
+        help: Value indicates if battery block/module is present in the system - 1.3.6.1.4.1.318.1.1.1.2.7.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: present
+          2: notPresent
+          3: notAvailable
+      - name: upsBatteryCabBlockType
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        type: DisplayString
+        help: Text string value, showing the vendor and model of the battery in the battery
+          block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        type: gauge
+        help: The temperature for the battery block/module in tenths of degrees Celcius
+          - 1.3.6.1.4.1.318.1.1.1.2.7.1.6
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockFuseStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        type: gauge
+        help: If the battery module has a fuse, the status is given by this value - 1.3.6.1.4.1.318.1.1.1.2.7.1.7
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+        enum_values:
+          1: fuseOpen
+          2: fuseOk
+          3: notPresent
+      - name: upsBatteryCabBlockVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        type: gauge
+        help: The voltage of the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.8
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockNumberOfCells
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        type: gauge
+        help: The number of cells in the battery block/module - 1.3.6.1.4.1.318.1.1.1.2.7.1.9
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockVerticalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        type: gauge
+        help: The vertical position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.10
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockHorizontalPosition
+        oid: 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        type: gauge
+        help: The horizontal position of the battery block/module in the actual battery
+          cabinet (E.g - 1.3.6.1.4.1.318.1.1.1.2.7.1.11
+        indexes:
+        - labelname: upsBatteryCabBlockIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        type: gauge
+        help: The battery block cell identifier - 1.3.6.1.4.1.318.1.1.1.2.8.1.1
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellReference
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        type: gauge
+        help: Reference to the specific global battery block/module index. - 1.3.6.1.4.1.318.1.1.1.2.8.1.2
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellLocalIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        type: gauge
+        help: Local battery block/module identification index in the actual battery block
+          (E.g - 1.3.6.1.4.1.318.1.1.1.2.8.1.3
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        type: gauge
+        help: The measured battery cell voltage - 1.3.6.1.4.1.318.1.1.1.2.8.1.4
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBatteryCabBlockCellTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        type: gauge
+        help: The temperature for the battery cell in tenths of degrees Celcius - 1.3.6.1.4.1.318.1.1.1.2.8.1.5
+        indexes:
+        - labelname: upsBatteryCabBlockCellIndex
+          type: gauge
+      - name: upsBasicInputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.3.1.1
+        type: gauge
+        help: The current AC input phase. - 1.3.6.1.4.1.318.1.1.1.3.1.1
+      - name: upsAdvInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.1
+        type: gauge
+        help: The current utility line voltage in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.1
+      - name: upsAdvInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.2
+        type: gauge
+        help: The maximum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.2
+      - name: upsAdvInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.3
+        type: gauge
+        help: The minimum utility line voltage in VAC over the previous 1 minute period.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.3
+      - name: upsAdvInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.4
+        type: gauge
+        help: The current input frequency to the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.4
+      - name: upsAdvInputLineFailCause
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.5
+        type: gauge
+        help: The reason for the occurrence of the last transfer to UPS battery power
+          - 1.3.6.1.4.1.318.1.1.1.3.2.5
+        enum_values:
+          1: noTransfer
+          2: highLineVoltage
+          3: brownout
+          4: blackout
+          5: smallMomentarySag
+          6: deepMomentarySag
+          7: smallMomentarySpike
+          8: largeMomentarySpike
+          9: selfTest
+          10: rateOfVoltageChange
+      - name: upsAdvInputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.6
+        type: gauge
+        help: The nominal input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.6
+      - name: upsAdvInputNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.7
+        type: gauge
+        help: The nominal input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.7
+      - name: upsAdvInputBypassNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.8
+        type: gauge
+        help: The nominal bypass input frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.3.2.8
+      - name: upsAdvInputBypassNominalVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.9
+        type: gauge
+        help: The nominal bypass input voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.3.2.9
+      - name: upsAdvInputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        type: gauge
+        help: The input identifier. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.1
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        type: gauge
+        help: The input apparent power(sum of all of the three phases) measured in kVA.
+          - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.2
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        type: gauge
+        help: The input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.3
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassVoltageTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        type: gauge
+        help: The bypass input voltage Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.4
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        type: gauge
+        help: The input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.5
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputBypassPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        type: gauge
+        help: The bypass input peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.6
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        type: gauge
+        help: The input active power measured in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.10.1.7
+        indexes:
+        - labelname: upsAdvInputStatisticsIndex
+          type: gauge
+      - name: upsAdvInputTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.11
+        type: gauge
+        help: The input total apparent power(sum of all three phases) of the UPS system
+          in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.11
+      - name: upsAdvInputTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.12
+        type: gauge
+        help: The input total active power(sum of all three phases) of the UPS system
+          in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.12
+      - name: upsAdvInputBypassTotalApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.13
+        type: gauge
+        help: The input bypass total apparent power(sum of all three phases) of the UPS
+          system in kVA. - 1.3.6.1.4.1.318.1.1.1.3.2.13
+      - name: upsAdvInputBypassTotalActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.14
+        type: gauge
+        help: The input bypass total active power(sum of all three phases) of the UPS
+          system in kW. - 1.3.6.1.4.1.318.1.1.1.3.2.14
+      - name: upsAdvInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.15
+        type: gauge
+        help: The input energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.3.2.15
+      - name: upsAdvInputDCVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.16
+        type: gauge
+        help: The DC input voltage in Volts. - 1.3.6.1.4.1.318.1.1.1.3.2.16
+      - name: upsAdvInputDCCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.3.2.17
+        type: gauge
+        help: The DC input current in Amps. - 1.3.6.1.4.1.318.1.1.1.3.2.17
+      - name: upsHighPrecInputLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.1
+        type: gauge
+        help: The current utility line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.1
+      - name: upsHighPrecInputMaxLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.2
+        type: gauge
+        help: The maximum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.2
+      - name: upsHighPrecInputMinLineVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.3
+        type: gauge
+        help: The minimum utility line voltage in tenths of VAC over the previous 1 minute
+          period. - 1.3.6.1.4.1.318.1.1.1.3.3.3
+      - name: upsHighPrecInputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.4
+        type: gauge
+        help: The current input frequency to the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.3.3.4
+      - name: upsHighPrecInputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.5
+        type: gauge
+        help: The input energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.3.3.5
+      - name: upsHighPrecInputBypassVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.6
+        type: gauge
+        help: The current bypass line voltage in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.3.3.6
+      - name: upsHighPrecInputBypassFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.3.3.7
+        type: gauge
+        help: The current input bypass frequency to the UPS system in tenths of Hz. -
+          1.3.6.1.4.1.318.1.1.1.3.3.7
+      - name: upsBasicOutputStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.1
+        type: gauge
+        help: The current state of the UPS - 1.3.6.1.4.1.318.1.1.1.4.1.1
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: hotStandby
+          15: onBatteryTest
+          16: emergencyStaticBypass
+          17: staticBypassStandby
+          18: powerSavingMode
+          19: spotMode
+          20: eConversion
+          21: chargerSpotmode
+          22: inverterSpotmode
+          23: activeLoad
+          24: batteryDischargeSpotmode
+          25: inverterStandby
+          26: chargerOnly
+      - name: upsBasicOutputPhase
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.2
+        type: gauge
+        help: The actual number of output phases in a UPS - 1.3.6.1.4.1.318.1.1.1.4.1.2
+      - name: upsBasicSystemStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.3
+        type: gauge
+        help: Current state for the whole system (UPS and surrounding breakers) - 1.3.6.1.4.1.318.1.1.1.4.1.3
+        enum_values:
+          1: unknown
+          2: onLine
+          3: onBattery
+          4: onSmartBoost
+          5: timedSleeping
+          6: softwareBypass
+          7: "off"
+          8: rebooting
+          9: switchedBypass
+          10: hardwareFailureBypass
+          11: sleepingUntilPowerReturn
+          12: onSmartTrim
+          13: ecoMode
+          14: inverter
+          15: eConversion
+          16: staticBypassStandby
+          17: efficiencyBoosterMode
+      - name: upsBasicSystemInternalTemperature
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.4
+        type: gauge
+        help: The actual internal temperature of the UPS system in Celsius. - 1.3.6.1.4.1.318.1.1.1.4.1.4
+      - name: upsBasicSystemInverterStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.5
+        type: gauge
+        help: The current state of the UPS inverter - 1.3.6.1.4.1.318.1.1.1.4.1.5
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicSystemPFCStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.6
+        type: gauge
+        help: The general status of the power factor correction (AC input stage of the
+          UPS) - 1.3.6.1.4.1.318.1.1.1.4.1.6
+        enum_values:
+          1: unknown
+          2: ok
+          3: inFaultCondition
+      - name: upsBasicOutputACwiringConfiguration
+        oid: 1.3.6.1.4.1.318.1.1.1.4.1.7
+        type: gauge
+        help: Indicates if neutral wire on output side of the UPS is used (load wired
+          line to neutral) - 1.3.6.1.4.1.318.1.1.1.4.1.7
+        enum_values:
+          1: unknown
+          2: noNeutralWiredonSystem
+          3: neutralUsedforSupplyingLoad
+      - name: upsAdvOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.1
+        type: gauge
+        help: The output voltage of the UPS system in VAC. - 1.3.6.1.4.1.318.1.1.1.4.2.1
+      - name: upsAdvOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.2
+        type: gauge
+        help: The current output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.2
+      - name: upsAdvOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.3
+        type: gauge
+        help: The current UPS load expressed in percent of rated capacity. - 1.3.6.1.4.1.318.1.1.1.4.2.3
+      - name: upsAdvOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.4
+        type: gauge
+        help: The current in amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.2.4
+      - name: upsAdvOutputRedundancy
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.5
+        type: gauge
+        help: The number of power modules which can fail or be removed without causing
+          the UPS to generate a Minimum Redundancy Lost event. - 1.3.6.1.4.1.318.1.1.1.4.2.5
+      - name: upsAdvOutputKVACapacity
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.6
+        type: gauge
+        help: The maximum load that this UPS can support - 1.3.6.1.4.1.318.1.1.1.4.2.6
+      - name: upsAdvOutputNominalFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.7
+        type: gauge
+        help: The nominal output frequency of the UPS system in Hz. - 1.3.6.1.4.1.318.1.1.1.4.2.7
+      - name: upsAdvOutputActivePower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.8
+        type: gauge
+        help: The total output active power of the UPS system in W - 1.3.6.1.4.1.318.1.1.1.4.2.8
+      - name: upsAdvOutputApparentPower
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.9
+        type: gauge
+        help: The total output apparent power of all phases of the UPS system in VA. -
+          1.3.6.1.4.1.318.1.1.1.4.2.9
+      - name: upsAdvOutputStatisticsIndex
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        type: gauge
+        help: The output identifier. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.1
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        type: gauge
+        help: The output peak current in Amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.2
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCurrentTHD
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        type: gauge
+        help: The output current Total Harmonic Distortion in percent. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.3
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputCrestFactor
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        type: gauge
+        help: The output current crest factor expressed in tenths. - 1.3.6.1.4.1.318.1.1.1.4.2.10.1.4
+        indexes:
+        - labelname: upsAdvOutputStatisticsIndex
+          type: gauge
+      - name: upsAdvOutputNeutralCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.11
+        type: gauge
+        help: The neutral current in amperes. - 1.3.6.1.4.1.318.1.1.1.4.2.11
+      - name: upsAdvOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.12
+        type: gauge
+        help: The output energy usage of the UPS in kWh. - 1.3.6.1.4.1.318.1.1.1.4.2.12
+      - name: upsAdvOutputSourceSynchronization
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.13
+        type: gauge
+        help: Indicates the synchronization source for the inverter output frequency -
+          1.3.6.1.4.1.318.1.1.1.4.2.13
+      - name: upsAdvOutputInverterFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.2.14
+        type: gauge
+        help: Output frequency in Hz measured at the output of inverter. - 1.3.6.1.4.1.318.1.1.1.4.2.14
+      - name: upsHighPrecOutputVoltage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.1
+        type: gauge
+        help: The output voltage of the UPS system in tenths of VAC. - 1.3.6.1.4.1.318.1.1.1.4.3.1
+      - name: upsHighPrecOutputFrequency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.2
+        type: gauge
+        help: The current output frequency of the UPS system in tenths of Hz. - 1.3.6.1.4.1.318.1.1.1.4.3.2
+      - name: upsHighPrecOutputLoad
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.3
+        type: gauge
+        help: The current UPS load expressed in tenths of percent of rated capacity. -
+          1.3.6.1.4.1.318.1.1.1.4.3.3
+      - name: upsHighPrecOutputCurrent
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.4
+        type: gauge
+        help: The current in tenths of amperes drawn by the load on the UPS. - 1.3.6.1.4.1.318.1.1.1.4.3.4
+      - name: upsHighPrecOutputEfficiency
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.5
+        type: gauge
+        help: The positive values represent efficiency of the UPS in tenths of percent
+          - 1.3.6.1.4.1.318.1.1.1.4.3.5
+      - name: upsHighPrecOutputEnergyUsage
+        oid: 1.3.6.1.4.1.318.1.1.1.4.3.6
+        type: gauge
+        help: The output energy usage of the UPS in hundredths of kWh. - 1.3.6.1.4.1.318.1.1.1.4.3.6
+      - name: upsAdvTestDiagnosticSchedule
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.1
+        type: gauge
+        help: The UPS system's automatic battery test schedule. - 1.3.6.1.4.1.318.1.1.1.7.2.1
+        enum_values:
+          1: unknown
+          2: biweekly
+          3: weekly
+          4: atTurnOn
+          5: never
+          6: fourWeeks
+          7: twelveWeeks
+          8: biweeklySinceLastTest
+          9: weeklySinceLastTest
+          10: eightWeeks
+          11: twentysixWeeks
+          12: fiftytwoWeeks
+      - name: upsAdvTestDiagnostics
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.2
+        type: gauge
+        help: Setting this variable to testDiagnostics(2) causes the UPS to perform a
+          diagnostic self test - 1.3.6.1.4.1.318.1.1.1.7.2.2
+        enum_values:
+          1: noTestDiagnostics
+          2: testDiagnostics
+      - name: upsAdvTestDiagnosticsResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.3
+        type: gauge
+        help: The results of the last UPS diagnostics test performed. - 1.3.6.1.4.1.318.1.1.1.7.2.3
+        enum_values:
+          1: ok
+          2: failed
+          3: invalidTest
+          4: testInProgress
+      - name: upsAdvTestLastDiagnosticsDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.4
+        type: DisplayString
+        help: The date the last UPS diagnostics test was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.4
+      - name: upsAdvTestRuntimeCalibration
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.5
+        type: gauge
+        help: Setting this variable to performCalibration(2) causes the UPS to discharge
+          to calibrate the UPS - 1.3.6.1.4.1.318.1.1.1.7.2.5
+        enum_values:
+          1: noPerformCalibration
+          2: performCalibration
+          3: cancelCurrentCalibration
+      - name: upsAdvTestCalibrationResults
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.6
+        type: gauge
+        help: The results of the last runtime calibration - 1.3.6.1.4.1.318.1.1.1.7.2.6
+        enum_values:
+          1: ok
+          2: invalidCalibration
+          3: calibrationInProgress
+          4: refused
+          5: aborted
+          6: pending
+      - name: upsAdvTestCalibrationDate
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.7
+        type: DisplayString
+        help: The date the last UPS runtime calibration was performed in mm/dd/yy format.
+          - 1.3.6.1.4.1.318.1.1.1.7.2.7
+      - name: upsAdvTestDiagnosticTime
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.8
+        type: DisplayString
+        help: The time of the day to perform automatic battery test - 1.3.6.1.4.1.318.1.1.1.7.2.8
+      - name: upsAdvTestDiagnosticDay
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.9
+        type: gauge
+        help: The day of the week to perform automatic battery test. - 1.3.6.1.4.1.318.1.1.1.7.2.9
+        enum_values:
+          1: monday
+          2: tuesday
+          3: wednesday
+          4: thursday
+          5: friday
+          6: saturday
+          7: sunday
+      - name: upsAdvTestBatteryInterval
+        oid: 1.3.6.1.4.1.318.1.1.1.7.2.10
+        type: DisplayString
+        help: The UPS system's automatic battery test period. - 1.3.6.1.4.1.318.1.1.1.7.2.10
+      - name: upsCommStatus
+        oid: 1.3.6.1.4.1.318.1.1.1.8.1
+        type: gauge
+        help: The status of agent's communication with UPS. - 1.3.6.1.4.1.318.1.1.1.8.1
+        enum_values:
+          1: ok
+          2: noComm
+      - name: iemStatusProbeNumber
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        type: gauge
+        help: The index of the probe. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.1
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeName
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        type: DisplayString
+        help: A descriptive name for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.2
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeStatus
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        type: gauge
+        help: The connected status of the probe, either disconnected(1) or connected(2).
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.3
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connected
+      - name: iemStatusProbeCurrentTemp
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        type: gauge
+        help: The current temperature reading from the probe displayed in the units shown
+          in the 'iemStatusProbeTempUnits' OID (Celsius or Fahrenheit). - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.4
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeTempUnits
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        type: gauge
+        help: The temperature scale used to display the temperature thresholds of the
+          probe, Celsius(1) or Fahrenheit(2) - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.5
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: celsius
+          2: fahrenheit
+      - name: iemStatusProbeCurrentHumid
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        type: gauge
+        help: The current humidity reading from the probe in percent relative humidity.
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.6
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: iemStatusProbeHighTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.7
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highTempViolation
+          3: disabled
+      - name: iemStatusProbeLowTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        type: gauge
+        help: The high temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.8
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowTempViolation
+          3: disabled
+      - name: iemStatusProbeHighHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        type: gauge
+        help: The high humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.9
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: highHumidViolation
+          3: disabled
+      - name: iemStatusProbeLowHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        type: gauge
+        help: The low humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.10
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: lowHumidViolation
+          3: disabled
+      - name: iemStatusProbeMaxTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        type: gauge
+        help: The max temperature violation status of the probe temperature reading -
+          1.3.6.1.4.1.318.1.1.10.2.3.2.1.11
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxTempViolation
+          3: disabled
+      - name: iemStatusProbeMinTempViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        type: gauge
+        help: The minimum temperature violation status of the probe temperature reading
+          - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.12
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minTempViolation
+          3: disabled
+      - name: iemStatusProbeMaxHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        type: gauge
+        help: The maximum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.13
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: maxHumidViolation
+          3: disabled
+      - name: iemStatusProbeMinHumidViolation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        type: gauge
+        help: The minimum humidity violation status of the probe humidity reading - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.14
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+        enum_values:
+          1: noViolation
+          2: minHumidViolation
+          3: disabled
+      - name: iemStatusProbeLocation
+        oid: 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        type: DisplayString
+        help: A descriptive location for the probe set by the user. - 1.3.6.1.4.1.318.1.1.10.2.3.2.1.15
+        indexes:
+        - labelname: iemStatusProbeNumber
+          type: gauge
+      - name: rPDU2BankStatusIndex
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        type: gauge
+        help: The index to the Rack PDU bank status table entry - 1.3.6.1.4.1.318.1.1.26.8.3.1.1
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusModule
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        type: gauge
+        help: The user-defined Rack PDU numeric ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.2
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusNumber
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        type: gauge
+        help: The numeric bank ID - 1.3.6.1.4.1.318.1.1.26.8.3.1.3
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusLoadState
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        type: EnumAsStateSet
+        help: Indicates the present load status of the Rack PDU bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.4
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+        enum_values:
+          1: lowLoad
+          2: normal
+          3: nearOverload
+          4: overload
+      - name: rPDU2BankStatusCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        type: gauge
+        help: Indicates the current draw, in tenths of Amps, of the load on the Rack PDU
+          bank being queried - 1.3.6.1.4.1.318.1.1.26.8.3.1.5
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrent
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        type: gauge
+        help: The peak current of the Rack PDU bank load in tenths of Amps - 1.3.6.1.4.1.318.1.1.26.8.3.1.6
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentTimestamp
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        type: DisplayString
+        help: Indicates the date and time the bank peak current occurred - 1.3.6.1.4.1.318.1.1.26.8.3.1.7
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      - name: rPDU2BankStatusPeakCurrentStartTime
+        oid: 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        type: DisplayString
+        help: Indicates the date and time of the last bank peak current reset - 1.3.6.1.4.1.318.1.1.26.8.3.1.8
+        indexes:
+        - labelname: rPDU2BankStatusIndex
+          type: gauge
+      version: 1
+    arista_sw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2.3.1.6
+      - 1.3.6.1.2.1.25.3.3.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.30065.3.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: aristaSwFwdIpStatsIPVersion
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        type: gauge
+        help: The IP version of this row. - 1.3.6.1.4.1.30065.3.1.1.1.1.1
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+      - name: aristaSwFwdIpStatsInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.3
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInReceives
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        type: counter
+        help: The total number of input IP datagrams received in software, including those
+          received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.4
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.5
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        type: counter
+        help: The total number of octets received in software in input IP datagrams, including
+          those received in error - 1.3.6.1.4.1.30065.3.1.1.1.1.6
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInHdrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        type: counter
+        help: The number of input IP datagrams discarded in software due to errors in
+          their IP headers, including version number mismatch, other format errors, hop
+          count exceeded, errors discovered in processing their IP options, etc - 1.3.6.1.4.1.30065.3.1.1.1.1.7
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        type: counter
+        help: The number of input IP datagrams discarded in software because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.8
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInAddrErrors
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        type: counter
+        help: The number of input IP datagrams discarded in software because the IP address
+          in their IP header's destination field was not a valid address to be received
+          at this entity - 1.3.6.1.4.1.30065.3.1.1.1.1.9
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInUnknownProtos
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        type: counter
+        help: The number of locally-addressed IP datagrams received successfully in software
+          but discarded because of an unknown or unsupported protocol - 1.3.6.1.4.1.30065.3.1.1.1.1.10
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInTruncatedPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        type: counter
+        help: The number of input IP datagrams discarded in software because the datagram
+          frame didn't carry enough data - 1.3.6.1.4.1.30065.3.1.1.1.1.11
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.12
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        type: counter
+        help: The number of input datagrams for which this entity was not their final
+          IP destination and for which this entity attempted in software to find a route
+          to forward them to that final destination - 1.3.6.1.4.1.30065.3.1.1.1.1.13
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        type: counter
+        help: The number of IP fragments received that needed to be reassembled at this
+          interface - 1.3.6.1.4.1.30065.3.1.1.1.1.14
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        type: counter
+        help: The number of IP datagrams successfully reassembled - 1.3.6.1.4.1.30065.3.1.1.1.1.15
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsReasmFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.16
+        type: counter
+        help: 'The number of failures detected by the IP re-assembly algorithm (for whatever
+          reason: timed out, errors, etc.) - 1.3.6.1.4.1.30065.3.1.1.1.1.16'
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        type: counter
+        help: The number of input IP datagrams received in software for which no problems
+          were encountered to prevent their continued processing, but were discarded (e.g.,
+          for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.17
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.18
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInDelivers
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        type: counter
+        help: The total number of datagrams successfully delivered to IP user-protocols
+          (including ICMP) - 1.3.6.1.4.1.30065.3.1.1.1.1.19
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.20
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutRequests
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        type: counter
+        help: The total number of IP datagrams that local IP user- protocols (including
+          ICMP) supplied to IP in requests for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.21
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutNoRoutes
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        type: counter
+        help: The number of locally generated IP datagrams discarded because no route
+          could be found to transmit them to their destination - 1.3.6.1.4.1.30065.3.1.1.1.1.22
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.23
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutForwDatagrams
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        type: counter
+        help: The number of datagrams for which this entity was not their final IP destination
+          and for which it was successful in finding a path to their final destination
+          in software - 1.3.6.1.4.1.30065.3.1.1.1.1.24
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutDiscards
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        type: counter
+        help: The number of output IP datagrams for which no problem was encountered to
+          prevent their transmission to their destination, but were discarded in software
+          (e.g., for lack of buffer space) - 1.3.6.1.4.1.30065.3.1.1.1.1.25
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragReqds
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        type: counter
+        help: The number of IP datagrams that would require fragmentation in order to
+          be transmitted - 1.3.6.1.4.1.30065.3.1.1.1.1.26
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragOKs
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        type: counter
+        help: The number of IP datagrams that have been successfully fragmented - 1.3.6.1.4.1.30065.3.1.1.1.1.27
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragFails
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        type: counter
+        help: The number of IP datagrams that have been discarded because they needed
+          to be fragmented but could not be - 1.3.6.1.4.1.30065.3.1.1.1.1.28
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutFragCreates
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        type: counter
+        help: The number of output datagram fragments that have been generated as a result
+          of IP fragmentation - 1.3.6.1.4.1.30065.3.1.1.1.1.29
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.30
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutTransmits
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        type: counter
+        help: The total number of IP datagrams that this entity supplied by software to
+          the lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.31
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.32
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        type: counter
+        help: The total number of octets in IP datagrams delivered by software to the
+          lower layers for transmission - 1.3.6.1.4.1.30065.3.1.1.1.1.33
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.34
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        type: counter
+        help: The number of IP multicast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.35
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.36
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        type: counter
+        help: The total number of octets received by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.37
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.38
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        type: counter
+        help: The number of IP multicast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.39
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.40
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutMcastOctets
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        type: counter
+        help: The total number of octets transmitted by software in IP multicast datagrams
+          - 1.3.6.1.4.1.30065.3.1.1.1.1.41
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.42
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCInBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        type: counter
+        help: The number of IP broadcast datagrams received by software - 1.3.6.1.4.1.30065.3.1.1.1.1.43
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.44
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsHCOutBcastPkts
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        type: counter
+        help: The number of IP broadcast datagrams transmitted by software - 1.3.6.1.4.1.30065.3.1.1.1.1.45
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsDiscontinuityTime
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this entry's counters suffered a discontinuity - 1.3.6.1.4.1.30065.3.1.1.1.1.46
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+      - name: aristaSwFwdIpStatsRefreshRate
+        oid: 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        type: gauge
+        help: The minimum reasonable polling interval for this entry - 1.3.6.1.4.1.30065.3.1.1.1.1.47
+        indexes:
+        - labelname: aristaSwFwdIpStatsIPVersion
+          type: gauge
+    cisco_wlc:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.14179.2.1.1.1.2
+      - 1.3.6.1.4.1.14179.2.1.1.1.38
+      - 1.3.6.1.4.1.14179.2.2.1.1.3
+      - 1.3.6.1.4.1.14179.2.2.13.1.3
+      - 1.3.6.1.4.1.14179.2.2.15.1.21
+      - 1.3.6.1.4.1.14179.2.2.2.1.15
+      - 1.3.6.1.4.1.14179.2.2.2.1.2
+      - 1.3.6.1.4.1.14179.2.2.2.1.4
+      - 1.3.6.1.4.1.14179.2.2.6.1
+      metrics:
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: bsnDot11EssNumberOfMobileStations
+        oid: 1.3.6.1.4.1.14179.2.1.1.1.38
+        type: counter
+        help: No of Mobile Stations currently associated with the WLAN. - 1.3.6.1.4.1.14179.2.1.1.1.38
+        indexes:
+        - labelname: bsnDot11EssIndex
+          type: gauge
+        lookups:
+        - labels:
+          - bsnDot11EssIndex
+          labelname: bsnDot11EssSsid
+          oid: 1.3.6.1.4.1.14179.2.1.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: bsnDot11EssIndex
+      - name: bsnAPIfLoadChannelUtilization
+        oid: 1.3.6.1.4.1.14179.2.2.13.1.3
+        type: gauge
+        help: Channel Utilization - 1.3.6.1.4.1.14179.2.2.13.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDBNoisePower
+        oid: 1.3.6.1.4.1.14179.2.2.15.1.21
+        type: gauge
+        help: This is the average noise power in dBm on each channel that is available
+          to Airespace AP - 1.3.6.1.4.1.14179.2.2.15.1.21
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        - labelname: bsnAPIfNoiseChannelNo
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnApIfNoOfUsers
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.15
+        type: counter
+        help: No of Users associated with this radio. - 1.3.6.1.4.1.14179.2.2.2.1.15
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfType
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.2
+        type: gauge
+        help: The type of this interface - 1.3.6.1.4.1.14179.2.2.2.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: dot11b
+          2: dot11a
+          4: uwb
+      - name: bsnAPIfPhyChannelNumber
+        oid: 1.3.6.1.4.1.14179.2.2.2.1.4
+        type: gauge
+        help: Current channel number of the AP Interface - 1.3.6.1.4.1.14179.2.2.2.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+        enum_values:
+          1: ch1
+          2: ch2
+          3: ch3
+          4: ch4
+          5: ch5
+          6: ch6
+          7: ch7
+          8: ch8
+          9: ch9
+          10: ch10
+          11: ch11
+          12: ch12
+          13: ch13
+          14: ch14
+          20: ch20
+          21: ch21
+          22: ch22
+          23: ch23
+          24: ch24
+          25: ch25
+          26: ch26
+          34: ch34
+          36: ch36
+          38: ch38
+          40: ch40
+          42: ch42
+          44: ch44
+          46: ch46
+          48: ch48
+          52: ch52
+          56: ch56
+          60: ch60
+          64: ch64
+          100: ch100
+          104: ch104
+          108: ch108
+          112: ch112
+          116: ch116
+          120: ch120
+          124: ch124
+          128: ch128
+          132: ch132
+          136: ch136
+          140: ch140
+          149: ch149
+          153: ch153
+          157: ch157
+          161: ch161
+          165: ch165
+          169: ch169
+      - name: bsnAPIfDot11TransmittedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.1
+        type: counter
+        help: This counter shall be incremented for an acknowledged MPDU with an individual
+          address in the address 1 field or an MPDU with a multicast address in the address
+          1 field of type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.1
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastTransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.2
+        type: counter
+        help: This counter shall increment only when the multicast bit is set in the destination
+          MAC address of a successfully transmitted MSDU - 1.3.6.1.4.1.14179.2.2.6.1.2
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.3
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          one or more retransmissions. - 1.3.6.1.4.1.14179.2.2.6.1.3
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MultipleRetryCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.4
+        type: counter
+        help: This counter shall increment when an MSDU is successfully transmitted after
+          more than one retransmission. - 1.3.6.1.4.1.14179.2.2.6.1.4
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FrameDuplicateCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.5
+        type: counter
+        help: This counter shall increment when a frame is received that the Sequence
+          Control field indicates is a duplicate. - 1.3.6.1.4.1.14179.2.2.6.1.5
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSSuccessCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.6
+        type: counter
+        help: This counter shall increment when a CTS is received in response to an RTS.
+          - 1.3.6.1.4.1.14179.2.2.6.1.6
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11RTSFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.7
+        type: counter
+        help: This counter shall increment when a CTS is not received in response to an
+          RTS. - 1.3.6.1.4.1.14179.2.2.6.1.7
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ACKFailureCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.8
+        type: counter
+        help: This counter shall increment when an ACK is not received when expected.
+          - 1.3.6.1.4.1.14179.2.2.6.1.8
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11ReceivedFragmentCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.9
+        type: counter
+        help: This counter shall be incremented for each successfully received MPDU of
+          type Data or Management. - 1.3.6.1.4.1.14179.2.2.6.1.9
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11MulticastReceivedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.10
+        type: counter
+        help: This counter shall increment when a MSDU is received with the multicast
+          bit set in the destination MAC address. - 1.3.6.1.4.1.14179.2.2.6.1.10
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FCSErrorCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.11
+        type: counter
+        help: This counter shall increment when an FCS error is detected in a received
+          MPDU. - 1.3.6.1.4.1.14179.2.2.6.1.11
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11TransmittedFrameCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.12
+        type: counter
+        help: This counter shall increment for each successfully transmitted MSDU. - 1.3.6.1.4.1.14179.2.2.6.1.12
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11WEPUndecryptableCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.13
+        type: counter
+        help: This counter shall increment when a frame is received with the WEP subfield
+          of the Frame Control field set to one and the WEPOn value for the key mapped
+          to the TA's MAC address indicates that the frame should not have been encrypted
+          or that frame is discarded due to the receiving STA not implementing the privacy
+          option. - 1.3.6.1.4.1.14179.2.2.6.1.13
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+      - name: bsnAPIfDot11FailedCount
+        oid: 1.3.6.1.4.1.14179.2.2.6.1.33
+        type: counter
+        help: This counter shall increment when an MSDU is not transmitted successfully
+          due to the number of transmit attempts exceeding either the bsnAPIfDot11ShortRetryLimit
+          or dot11LongRetryLimit. - 1.3.6.1.4.1.14179.2.2.6.1.33
+        indexes:
+        - labelname: bsnAPDot3MacAddress
+          type: PhysAddress48
+          fixed_size: 6
+        - labelname: bsnAPIfSlotId
+          type: gauge
+        lookups:
+        - labels:
+          - bsnAPDot3MacAddress
+          labelname: bsnAPName
+          oid: 1.3.6.1.4.1.14179.2.2.1.1.3
+          type: OctetString
+        - labels: []
+          labelname: bsnAPDot3MacAddress
+    ddwrt:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.11
+      - 1.3.6.1.4.1.2021.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laIndex
+        oid: 1.3.6.1.4.1.2021.10.1.1
+        type: gauge
+        help: reference index/row number for each observed loadave. - 1.3.6.1.4.1.2021.10.1.1
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssIndex
+        oid: 1.3.6.1.4.1.2021.11.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.11.1
+      - name: ssErrorName
+        oid: 1.3.6.1.4.1.2021.11.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.11.2
+      - name: ssSwapIn
+        oid: 1.3.6.1.4.1.2021.11.3
+        type: gauge
+        help: The average amount of memory swapped in from disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.3
+      - name: ssSwapOut
+        oid: 1.3.6.1.4.1.2021.11.4
+        type: gauge
+        help: The average amount of memory swapped out to disk, calculated over the last
+          minute. - 1.3.6.1.4.1.2021.11.4
+      - name: ssIOSent
+        oid: 1.3.6.1.4.1.2021.11.5
+        type: gauge
+        help: The average amount of data written to disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.5
+      - name: ssIOReceive
+        oid: 1.3.6.1.4.1.2021.11.6
+        type: gauge
+        help: The average amount of data read from disk or other block device, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.6
+      - name: ssSysInterrupts
+        oid: 1.3.6.1.4.1.2021.11.7
+        type: gauge
+        help: The average rate of interrupts processed (including the clock) calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.7
+      - name: ssSysContext
+        oid: 1.3.6.1.4.1.2021.11.8
+        type: gauge
+        help: The average rate of context switches, calculated over the last minute -
+          1.3.6.1.4.1.2021.11.8
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuRawUser
+        oid: 1.3.6.1.4.1.2021.11.50
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing user-level code
+          - 1.3.6.1.4.1.2021.11.50
+      - name: ssCpuRawNice
+        oid: 1.3.6.1.4.1.2021.11.51
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing reduced-priority
+          code - 1.3.6.1.4.1.2021.11.51
+      - name: ssCpuRawSystem
+        oid: 1.3.6.1.4.1.2021.11.52
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing system-level code
+          - 1.3.6.1.4.1.2021.11.52
+      - name: ssCpuRawIdle
+        oid: 1.3.6.1.4.1.2021.11.53
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent idle - 1.3.6.1.4.1.2021.11.53
+      - name: ssCpuRawWait
+        oid: 1.3.6.1.4.1.2021.11.54
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent waiting for IO - 1.3.6.1.4.1.2021.11.54
+      - name: ssCpuRawKernel
+        oid: 1.3.6.1.4.1.2021.11.55
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing kernel-level code
+          - 1.3.6.1.4.1.2021.11.55
+      - name: ssCpuRawInterrupt
+        oid: 1.3.6.1.4.1.2021.11.56
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing hardware interrupts
+          - 1.3.6.1.4.1.2021.11.56
+      - name: ssIORawSent
+        oid: 1.3.6.1.4.1.2021.11.57
+        type: counter
+        help: Number of blocks sent to a block device - 1.3.6.1.4.1.2021.11.57
+      - name: ssIORawReceived
+        oid: 1.3.6.1.4.1.2021.11.58
+        type: counter
+        help: Number of blocks received from a block device - 1.3.6.1.4.1.2021.11.58
+      - name: ssRawInterrupts
+        oid: 1.3.6.1.4.1.2021.11.59
+        type: counter
+        help: Number of interrupts processed - 1.3.6.1.4.1.2021.11.59
+      - name: ssRawContexts
+        oid: 1.3.6.1.4.1.2021.11.60
+        type: counter
+        help: Number of context switches - 1.3.6.1.4.1.2021.11.60
+      - name: ssCpuRawSoftIRQ
+        oid: 1.3.6.1.4.1.2021.11.61
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent processing software interrupts
+          - 1.3.6.1.4.1.2021.11.61
+      - name: ssRawSwapIn
+        oid: 1.3.6.1.4.1.2021.11.62
+        type: counter
+        help: Number of blocks swapped in - 1.3.6.1.4.1.2021.11.62
+      - name: ssRawSwapOut
+        oid: 1.3.6.1.4.1.2021.11.63
+        type: counter
+        help: Number of blocks swapped out - 1.3.6.1.4.1.2021.11.63
+      - name: ssCpuRawSteal
+        oid: 1.3.6.1.4.1.2021.11.64
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the hypervisor code to
+          run other VMs even though the CPU in the current VM had something runnable -
+          1.3.6.1.4.1.2021.11.64
+      - name: ssCpuRawGuest
+        oid: 1.3.6.1.4.1.2021.11.65
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a virtual
+          CPU (guest) - 1.3.6.1.4.1.2021.11.65
+      - name: ssCpuRawGuestNice
+        oid: 1.3.6.1.4.1.2021.11.66
+        type: counter
+        help: The number of 'ticks' (typically 1/100s) spent by the CPU to run a niced
+          virtual CPU (guest) - 1.3.6.1.4.1.2021.11.66
+      - name: ssCpuNumCpus
+        oid: 1.3.6.1.4.1.2021.11.67
+        type: gauge
+        help: The number of processors, as counted by the agent - 1.3.6.1.4.1.2021.11.67
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+    if_mib:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifAlias
+          oid: 1.3.6.1.2.1.31.1.1.1.18
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifDescr
+          oid: 1.3.6.1.2.1.2.2.1.2
+          type: DisplayString
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+    infrapower_pdu:
+      walk:
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.1
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.6
+      - 1.3.6.1.4.1.34550.20.2.1.1.1.7
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: pduMainLoadVoltage
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        type: DisplayString
+        help: The voltage measured on this PDU in tenth of Volts - 1.3.6.1.4.1.34550.20.2.1.1.1.13
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainLoadAmp
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        type: DisplayString
+        help: The current load measured on this PDU in tenth of Amps - 1.3.6.1.4.1.34550.20.2.1.1.1.14
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: $1.$2
+            regex: ^(?:(.*)(.))$
+      - name: pduMainActivePower
+        oid: 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        type: DisplayString
+        help: The active power consumption of this PDU in hundred-thousandth of kW - 1.3.6.1.4.1.34550.20.2.1.1.1.17
+        indexes:
+        - labelname: pduIndex
+          type: gauge
+        lookups:
+        - labels:
+          - pduIndex
+          labelname: pduName
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.6
+          type: DisplayString
+        - labels:
+          - pduIndex
+          labelname: pduLocation
+          oid: 1.3.6.1.4.1.34550.20.2.1.1.1.7
+          type: DisplayString
+        regex_extracts:
+          "":
+          - value: 0$1.$2
+            regex: ^(?:(\d*?)(\d{2}))$
+          - value: 0.0$1
+            regex: ^(?:^(\d))$
+    keepalived:
+      walk:
+      - 1.3.6.1.4.1.9586.100.5.2.1
+      - 1.3.6.1.4.1.9586.100.5.2.3
+      - 1.3.6.1.4.1.9586.100.5.3.1
+      - 1.3.6.1.4.1.9586.100.5.3.3
+      - 1.3.6.1.4.1.9586.100.5.3.4
+      metrics:
+      - name: vrrpSyncGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        type: gauge
+        help: Index of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.1
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        type: DisplayString
+        help: Name of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.2
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+      - name: vrrpSyncGroupState
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        type: gauge
+        help: Current state of the synchronisation group. - 1.3.6.1.4.1.9586.100.5.2.1.1.3
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpSyncGroupSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        type: gauge
+        help: Will SMTP alert be sent for this synchronisation group? - 1.3.6.1.4.1.9586.100.5.2.1.1.4
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        type: gauge
+        help: Will we execute notification script for this group? - 1.3.6.1.4.1.9586.100.5.2.1.1.5
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpSyncGroupTrackingWeight
+        oid: 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        type: gauge
+        help: Allow differing tracking weights for sync group members - 1.3.6.1.4.1.9586.100.5.2.1.1.10
+        indexes:
+        - labelname: vrrpSyncGroupIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceIndex
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        type: gauge
+        help: Index of the VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.1
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: static
+      - name: vrrpInstanceName
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        type: DisplayString
+        help: Name of the VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.2
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVirtualRouterId
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        type: gauge
+        help: Virtual Router ID (VRID) for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.3
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        type: gauge
+        help: Current state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.4
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceInitialState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        type: gauge
+        help: Initial state of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.5
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceWantedState
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        type: gauge
+        help: State wanted by the operator for this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.6
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: init
+          1: backup
+          2: master
+          3: fault
+          4: unknown
+          5: shutdown
+          6: deleted
+      - name: vrrpInstanceBasePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        type: gauge
+        help: Base priority (as defined in the configuration file) for this VRRP instance
+          - 1.3.6.1.4.1.9586.100.5.2.3.1.7
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceEffectivePriority
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        type: gauge
+        help: Effective priority for this VRRP instance - 1.3.6.1.4.1.9586.100.5.2.3.1.8
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceVipsStatus
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        type: gauge
+        help: Are all VIP of this VRRP instance enabled? - 1.3.6.1.4.1.9586.100.5.2.3.1.9
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: allSet
+          2: notAllSet
+      - name: vrrpInstancePrimaryInterface
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        type: DisplayString
+        help: Primary interface of this VRRP instance. - 1.3.6.1.4.1.9586.100.5.2.3.1.10
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceTrackPrimaryIf
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        type: gauge
+        help: Do we track the status of the primary interface? - 1.3.6.1.4.1.9586.100.5.2.3.1.11
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: tracked
+          2: notTracked
+      - name: vrrpInstanceAdvertisementsInt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        type: gauge
+        help: Delay in seconds between two VRRP advertisements and it is in centiseconds
+          between two VRRPV3 advertisements - 1.3.6.1.4.1.9586.100.5.2.3.1.12
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstancePreempt
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        type: gauge
+        help: Will a higher priority advertisement preempt a lower instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.13
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: preempt
+          2: noPreempt
+      - name: vrrpInstancePreemptDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        type: gauge
+        help: Delay after startup or lower priority advert received until preemption can
+          happen - 1.3.6.1.4.1.9586.100.5.2.3.1.14
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceAuthType
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        type: gauge
+        help: VRRPv2 supports authentication method to authenticate other peers - 1.3.6.1.4.1.9586.100.5.2.3.1.15
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: password
+          2: ah
+      - name: vrrpInstanceSyncGroup
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.18
+        type: DisplayString
+        help: Name of the synchronisation group this VRRP instance belongs, if any. -
+          1.3.6.1.4.1.9586.100.5.2.3.1.18
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceGarpDelay
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        type: gauge
+        help: Delay to launch gratuitous ARP (GARP). - 1.3.6.1.4.1.9586.100.5.2.3.1.19
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        type: gauge
+        help: Will SMTP alert be sent for this VRRP instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.20
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceNotifyExec
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        type: gauge
+        help: Will we execute notification script for this instance? - 1.3.6.1.4.1.9586.100.5.2.3.1.21
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: vrrpInstanceAccept
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        type: gauge
+        help: Accept allow the non-master owner to process the packets destined to VIP
+          and it is supported for only VRRPv3. - 1.3.6.1.4.1.9586.100.5.2.3.1.27
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstancePromoteSecondaries
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        type: gauge
+        help: Set promote_secondaries on interface. - 1.3.6.1.4.1.9586.100.5.2.3.1.28
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceUseLinkbeat
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        type: gauge
+        help: Use linkbeat for interface status. - 1.3.6.1.4.1.9586.100.5.2.3.1.29
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: vrrpInstanceVrrpVersion
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        type: gauge
+        help: VRRP protocol version. - 1.3.6.1.4.1.9586.100.5.2.3.1.30
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          2: vrrpv2
+          3: vrrpv3
+      - name: vrrpInstanceScriptDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        type: DisplayString
+        help: Script to execute when the instance is deleted on reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.32
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+      - name: vrrpInstanceNotifyDeleted
+        oid: 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        type: gauge
+        help: Send Deleted rather than Fault notifications if instance is deleted on config
+          reload. - 1.3.6.1.4.1.9586.100.5.2.3.1.33
+        indexes:
+        - labelname: vrrpInstanceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerGroupIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        type: gauge
+        help: Index of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.1
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerGroupName
+        oid: 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        type: DisplayString
+        help: Name of the virtual server group. - 1.3.6.1.4.1.9586.100.5.3.1.1.2
+        indexes:
+        - labelname: virtualServerGroupIndex
+          type: gauge
+      - name: virtualServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        type: gauge
+        help: Index of the virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        type: gauge
+        help: Type of virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.2
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: fwmark
+          2: ip
+          3: group
+      - name: virtualServerNameOfGroup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.3
+        type: DisplayString
+        help: If the virtual is defined from a group, this is the name of the group. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerFwMark
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        type: gauge
+        help: If the virtual server is defined from a firewall mark, this is the value
+          of the mark - 1.3.6.1.4.1.9586.100.5.3.3.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the address family
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: virtualServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        type: InetAddress
+        help: If the virtual server is defined from an IP address, this is the value of
+          the IP - 1.3.6.1.4.1.9586.100.5.3.3.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        type: gauge
+        help: If the virtual server is defined from an IP, this is the value of the port
+          to listen for requests - 1.3.6.1.4.1.9586.100.5.3.3.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerProtocol
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        type: gauge
+        help: Which transport protocol should be used for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: tcp
+          2: udp
+          3: sctp
+          4: none
+      - name: virtualServerLoadBalancingAlgo
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        type: gauge
+        help: Which load balancing algorithm (or scheduler) should be used for this virtual
+          server. - 1.3.6.1.4.1.9586.100.5.3.3.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: rr
+          2: wrr
+          3: lc
+          4: wlc
+          5: lblc
+          6: lblcr
+          7: dh
+          8: sh
+          9: sed
+          10: nq
+          11: fo
+          12: ovf
+          13: mh
+          99: unknown
+      - name: virtualServerLoadBalancingKind
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        type: gauge
+        help: Default forwarding method to use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: virtualServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        type: gauge
+        help: Current status of this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: virtualServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        type: DisplayString
+        help: Virtualhost of this server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.3.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersist
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        type: gauge
+        help: Is the virtual service persistence enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerPersistTimeout
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        type: gauge
+        help: If this virtual service is persistence, what is the timeout. - 1.3.6.1.4.1.9586.100.5.3.3.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.15
+        type: OctetString
+        help: Netmask specifying the granularity of the IPv4 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHaSuspend
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        type: gauge
+        help: If set to true(1), checks will be suspended if the IP of the virtual server
+          is currently not set. - 1.3.6.1.4.1.9586.100.5.3.3.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerOmega
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        type: gauge
+        help: Is omega mode enabled? - 1.3.6.1.4.1.9586.100.5.3.3.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerRealServersTotal
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        type: gauge
+        help: Total number of real servers for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRealServersUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        type: gauge
+        help: Real servers actually up for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        type: gauge
+        help: Quorum to get amond real servers to consider this virtual server up. - 1.3.6.1.4.1.9586.100.5.3.3.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        type: gauge
+        help: Current status of the quorum for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: met
+          2: notMet
+          3: shutdown
+      - name: virtualServerQuorumUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        type: DisplayString
+        help: Command to execute when the quorum is met. - 1.3.6.1.4.1.9586.100.5.3.3.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerQuorumDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        type: DisplayString
+        help: Command to execute when the quorum is not met. - 1.3.6.1.4.1.9586.100.5.3.3.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHysteresis
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        type: gauge
+        help: Hysteresis with respect to quorum count. - 1.3.6.1.4.1.9586.100.5.3.3.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        type: gauge
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        type: counter
+        help: Total number of incoming bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        type: counter
+        help: Total number of outgoing bytes for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        type: gauge
+        help: Current connection rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        type: gauge
+        help: Current in packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        type: gauge
+        help: Current out packet rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        type: gauge
+        help: Current incoming rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        type: gauge
+        help: Current outgoing rate for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerOPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        type: gauge
+        help: If set to true(1), One-Packet-Scheduling will be applied. - 1.3.6.1.4.1.9586.100.5.3.3.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        type: counter
+        help: Total number of connections scheduled for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        type: counter
+        help: Total number of incoming packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        type: counter
+        help: Total number of outgoing packets for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        type: gauge
+        help: Current connection rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        type: gauge
+        help: Current in packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        type: gauge
+        help: Current out packet rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        type: gauge
+        help: Current incoming rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        type: gauge
+        help: Current outgoing rate for this virtual server - 1.3.6.1.4.1.9586.100.5.3.3.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerPersistGranularity6
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.51
+        type: gauge
+        help: Netmask specifying the granularity of the IPv6 persistence mechanism. -
+          1.3.6.1.4.1.9586.100.5.3.3.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerHashed
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        type: gauge
+        help: If set to true(1), entries will be hashed. - 1.3.6.1.4.1.9586.100.5.3.3.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        type: gauge
+        help: If set to true(1), SH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        type: gauge
+        help: If set to true(1), SH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerSched3
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        type: gauge
+        help: If set to true(1), scheduler flag 3 set. - 1.3.6.1.4.1.9586.100.5.3.3.1.55
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        type: gauge
+        help: What action is performed when the real servers are down - 1.3.6.1.4.1.9586.100.5.3.3.1.56
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: virtualServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.57
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        type: gauge
+        help: Default number of seconds between retrying a checker ofter it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.3.1.58
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.59
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        type: gauge
+        help: Default wieght for each real server. - 1.3.6.1.4.1.9586.100.5.3.3.1.60
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        type: gauge
+        help: Will SMTP alert be sent for this virtual server? - 1.3.6.1.4.1.9586.100.5.3.3.1.61
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: virtualServerMHFallback
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        type: gauge
+        help: If set to true(1), MH scheduler fallback. - 1.3.6.1.4.1.9586.100.5.3.3.1.62
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerMHPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        type: gauge
+        help: If set to true(1), MH scheduler use port. - 1.3.6.1.4.1.9586.100.5.3.3.1.63
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: virtualServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.3.1.64
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerDelayBeforeRetrUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker ofter it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.3.1.65
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.3.1.66
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.3.1.67
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        type: gauge
+        help: Default forwarding tunnel type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.68
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: virtualServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        type: gauge
+        help: Default forwarding tunnel GUE port use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.69
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+      - name: virtualServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        type: gauge
+        help: Default forwarding tunnel checksum type use for this virtual server. - 1.3.6.1.4.1.9586.100.5.3.3.1.70
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+      - name: realServerIndex
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        type: gauge
+        help: Index of the real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.1
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.2
+        type: gauge
+        help: 'Type of real server: either a regular real server or a sorry server. -
+          1.3.6.1.4.1.9586.100.5.3.4.1.2'
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: regular
+          2: sorry
+      - name: realServerAddrType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        type: gauge
+        help: Address family for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.3
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: ipv4
+          2: ipv6
+          3: ipv4z
+          4: ipv6z
+          16: dns
+      - name: realServerAddress
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        type: InetAddress
+        help: IP address of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.4
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        type: gauge
+        help: Port of the service. - 1.3.6.1.4.1.9586.100.5.3.4.1.5
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatus
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        type: gauge
+        help: Status of this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.6
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: alive
+          2: dead
+      - name: realServerWeight
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        type: gauge
+        help: Weight of this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.7
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerUpperConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        type: gauge
+        help: Maximum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.8
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerLowerConnectionLimit
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        type: gauge
+        help: Minimum number of connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.9
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerActionWhenDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        type: gauge
+        help: What action is performed when this server is down - 1.3.6.1.4.1.9586.100.5.3.4.1.10
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: remove
+          2: inhibit
+      - name: realServerNotifyUp
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        type: DisplayString
+        help: Command to execute when this server becomes alive. - 1.3.6.1.4.1.9586.100.5.3.4.1.11
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerNotifyDown
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        type: DisplayString
+        help: Command to execute when this server becomes dead. - 1.3.6.1.4.1.9586.100.5.3.4.1.12
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerFailedChecks
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        type: gauge
+        help: How many failed checks for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.13
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        type: gauge
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.14
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsActiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        type: gauge
+        help: Current active connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.15
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInactiveConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        type: gauge
+        help: Current inactive connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.16
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsPersistentConns
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        type: gauge
+        help: Current persistent connections for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.17
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.18
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.19
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        type: counter
+        help: Total number of incoming bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.20
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutBytes
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        type: counter
+        help: Total number of outgoing bytes for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.21
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCps
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        type: gauge
+        help: Current connection rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.22
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        type: gauge
+        help: Current in packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.23
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        type: gauge
+        help: Current out packet rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.24
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        type: gauge
+        help: Current incoming rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.25
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPS
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        type: gauge
+        help: Current outgoing rate for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.26
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsConns64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        type: counter
+        help: Total number of connections scheduled for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.27
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsInPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        type: counter
+        help: Total number of incoming packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.28
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerStatsOutPkts64
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        type: counter
+        help: Total number of outgoing packets for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.29
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.30
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateCpsHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        type: gauge
+        help: Current connection rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.31
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.32
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        type: gauge
+        help: Current in packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.33
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.34
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutPPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        type: gauge
+        help: Current out packet rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.35
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.36
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateInBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        type: gauge
+        help: Current incoming rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.37
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSLow
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.38
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerRateOutBPSHigh
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        type: gauge
+        help: Current outgoing rate for this real server - 1.3.6.1.4.1.9586.100.5.3.4.1.39
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerForwardingMethod
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        type: gauge
+        help: Forwarding method to use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.40
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nat
+          2: dr
+          3: tun
+      - name: realServerVirtualHost
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        type: DisplayString
+        help: Virtualhost of this real server for HTTP like requests. - 1.3.6.1.4.1.9586.100.5.3.4.1.41
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerAlpha
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        type: gauge
+        help: Is alpha mode enabled? - 1.3.6.1.4.1.9586.100.5.3.4.1.42
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        type: gauge
+        help: Default number of retries of checker before marking failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.43
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayBeforeRetry
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        type: gauge
+        help: Default number of seconds between retrying a checker after it has failed.
+          - 1.3.6.1.4.1.9586.100.5.3.4.1.44
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmup
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        type: gauge
+        help: Maximum number of seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.45
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoop
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        type: gauge
+        help: Delay in seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.46
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerSmtpAlert
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        type: gauge
+        help: Will SMTP alert be sent for this real server? - 1.3.6.1.4.1.9586.100.5.3.4.1.47
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: realServerDelayBeforeRetryUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        type: gauge
+        help: Default number of micro-seconds between retrying a checker after it has
+          failed. - 1.3.6.1.4.1.9586.100.5.3.4.1.48
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerWarmupUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        type: gauge
+        help: Maximum number of micro-seconds to delay before running checker. - 1.3.6.1.4.1.9586.100.5.3.4.1.49
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerDelayLoopUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        type: gauge
+        help: Delay in micro-seconds between two checks. - 1.3.6.1.4.1.9586.100.5.3.4.1.50
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerConnTimeoutUsec
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        type: gauge
+        help: Maximum number of micro-seconds for checker to establish connection. - 1.3.6.1.4.1.9586.100.5.3.4.1.51
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelType
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        type: gauge
+        help: Forwarding tunnel type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.52
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: ipip
+          2: gue
+          3: gre
+      - name: realServerTunnelPort
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        type: gauge
+        help: Forwarding tunnel GUE port use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.53
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+      - name: realServerTunnelCsum
+        oid: 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        type: gauge
+        help: Forwarding tunnel checksum type use for this real server. - 1.3.6.1.4.1.9586.100.5.3.4.1.54
+        indexes:
+        - labelname: virtualServerIndex
+          type: gauge
+        - labelname: realServerIndex
+          type: gauge
+        enum_values:
+          1: nocsum
+          2: csum
+          3: remcsum
+    nec_ix:
+      walk:
+      - 1.3.6.1.4.1.119.2.3.84.11
+      - 1.3.6.1.4.1.119.2.3.84.12
+      - 1.3.6.1.4.1.119.2.3.84.13
+      - 1.3.6.1.4.1.119.2.3.84.2
+      - 1.3.6.1.4.1.119.2.3.84.3
+      - 1.3.6.1.4.1.119.2.3.84.6
+      - 1.3.6.1.4.1.119.2.3.84.7
+      - 1.3.6.1.4.1.119.2.3.84.8
+      - 1.3.6.1.4.1.119.2.3.84.9
+      metrics:
+      - name: picoMobileDeviceIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        type: gauge
+        help: The unique index for each Mobile module. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.1
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceVendorName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        type: DisplayString
+        help: The object of the vendor name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.2
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceName
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        type: DisplayString
+        help: The object of the device name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.3
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceProductID
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        type: DisplayString
+        help: The object of the product ID. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.4
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSoftwareVersion
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        type: DisplayString
+        help: The object of the software version. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.5
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalBar
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        type: gauge
+        help: The object of the signal bar. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.6
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalStrength
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7
+        type: gauge
+        help: 'The signal strength can be: unknown(-1) :signal strength is unknown out-range(0):signal
+          strength is 0 weak(1) :signal strength is 1 low(2) :signal strength is 2 high(3)
+          :signal strength is 3 - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.7'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          -1: unknown
+          0: out-range
+          1: weak
+          2: low
+          3: high
+      - name: picoMobileDeviceSignalQuality
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        type: DisplayString
+        help: The object of the signal quality. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.8
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceSignalElapsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        type: gauge
+        help: The object of the elapsed time after signal acquiring. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.9
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceRadioInterface
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        type: DisplayString
+        help: The object of the radio interface. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.10
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceCarrier
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        type: DisplayString
+        help: The object of the carrier name. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.11
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialerString
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        type: DisplayString
+        help: The object of the dialer string. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.12
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceDialStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13
+        type: gauge
+        help: 'The dial status can be: disconnected(0):dial status is disconnected - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.13'
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+        enum_values:
+          0: disconnected
+          1: connect
+          2: cancel
+          3: connected
+          4: postprocess
+      - name: picoMobileDeviceInRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        type: gauge
+        help: The in-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.14
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceOutRangeCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        type: gauge
+        help: The out-range statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.15
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoMobileDeviceResetCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        type: gauge
+        help: The reset device statistics. - 1.3.6.1.4.1.119.2.3.84.11.1.1.1.16
+        indexes:
+        - labelname: picoMobileDeviceIndex
+          type: gauge
+      - name: picoIPv4CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.1
+        type: gauge
+        help: The number of current IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.1
+      - name: picoIPv4CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.2
+        type: gauge
+        help: The peak value of IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.2
+      - name: picoIPv4CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.3
+        type: counter
+        help: The total count of created IPv4 cache. - 1.3.6.1.4.1.119.2.3.84.12.1.3
+      - name: picoIPv4CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.1.4
+        type: counter
+        help: The total count of IPv4 cache overflow. - 1.3.6.1.4.1.119.2.3.84.12.1.4
+      - name: picoIPv4UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.1
+        type: gauge
+        help: The number of current IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.1
+      - name: picoIPv4UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.2
+        type: gauge
+        help: The peak value of IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.2
+      - name: picoIPv4UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.3
+        type: counter
+        help: The total count of created IPv4 UFS cache - 1.3.6.1.4.1.119.2.3.84.12.2.3
+      - name: picoIPv4UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.12.2.4
+        type: counter
+        help: The total count of IPv4 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.12.2.4
+      - name: picoIPv6CacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.1
+        type: gauge
+        help: The number of current IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.1
+      - name: picoIPv6CachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.2
+        type: gauge
+        help: The peak value of IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.2
+      - name: picoIPv6CacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.3
+        type: counter
+        help: The total count of created IPv6 cache. - 1.3.6.1.4.1.119.2.3.84.13.1.3
+      - name: picoIPv6CacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.1.4
+        type: counter
+        help: The total count of IPv6 cache overflow. - 1.3.6.1.4.1.119.2.3.84.13.1.4
+      - name: picoIPv6UFSCacheEntries
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.1
+        type: gauge
+        help: The number of current IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.1
+      - name: picoIPv6UFSCachePeaks
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.2
+        type: gauge
+        help: The peak value of IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.2
+      - name: picoIPv6UFSCacheCreates
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.3
+        type: counter
+        help: The total count of created IPv6 UFS cache - 1.3.6.1.4.1.119.2.3.84.13.2.3
+      - name: picoIPv6UFSCacheOverflows
+        oid: 1.3.6.1.4.1.119.2.3.84.13.2.4
+        type: counter
+        help: The total count of IPv6 UFS cache overflow - 1.3.6.1.4.1.119.2.3.84.13.2.4
+      - name: picoCelsius
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.1
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Celsius).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.1
+      - name: picoFahrenheit
+        oid: 1.3.6.1.4.1.119.2.3.84.2.1.2
+        type: gauge
+        help: Indicates the temperature of the equipment inside, in degree (Fahrenheit).
+          - 1.3.6.1.4.1.119.2.3.84.2.1.2
+      - name: picoVoltage
+        oid: 1.3.6.1.4.1.119.2.3.84.2.2
+        type: gauge
+        help: Indicates the observed voltage, in milli-volt (mV). - 1.3.6.1.4.1.119.2.3.84.2.2
+      - name: picoFanIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        type: gauge
+        help: Unique index for each fan module. - 1.3.6.1.4.1.119.2.3.84.2.3.1.1
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoFanStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        type: gauge
+        help: Status of a fan module - 1.3.6.1.4.1.119.2.3.84.2.3.1.2
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: failure
+      - name: picoFanRpm
+        oid: 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        type: gauge
+        help: Fan speed (Revolution Per Minutes) - 1.3.6.1.4.1.119.2.3.84.2.3.1.3
+        indexes:
+        - labelname: picoFanIndex
+          type: gauge
+      - name: picoPowerSupplyIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        type: gauge
+        help: Unique index for each power supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.1
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+      - name: picoPowerSupplyType
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        type: gauge
+        help: Power supply module type. - 1.3.6.1.4.1.119.2.3.84.2.4.1.2
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: systemACPS
+          2: ieee802dot3af-PoE-ACPS
+      - name: picoPowerSupplyStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        type: gauge
+        help: Status of a Power Supply module. - 1.3.6.1.4.1.119.2.3.84.2.4.1.3
+        indexes:
+        - labelname: picoPowerSupplyIndex
+          type: gauge
+        enum_values:
+          0: notInstalled
+          1: normal
+          2: failure
+      - name: picoSchedRtUtl1Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.1
+        type: gauge
+        help: Indicates the observed system utilization for last 1 second, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.1
+      - name: picoSchedRtUtl5Sec
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.2
+        type: gauge
+        help: Indicates the observed system utilization for last 5 seconds, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.2
+      - name: picoSchedRtUtl1Min
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.3
+        type: gauge
+        help: Indicates the observed system utilization for last 1 minute, in percent
+          (%). - 1.3.6.1.4.1.119.2.3.84.2.5.3
+      - name: picoSchedRtUtl1Hour
+        oid: 1.3.6.1.4.1.119.2.3.84.2.5.4
+        type: gauge
+        help: Indicates the observed system utilization for last 1 hour, in percent (%).
+          - 1.3.6.1.4.1.119.2.3.84.2.5.4
+      - name: picoHeapSize
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.1
+        type: gauge
+        help: Indicates the observed total heap size, in bytes. - 1.3.6.1.4.1.119.2.3.84.2.6.1
+      - name: picoHeapUtil
+        oid: 1.3.6.1.4.1.119.2.3.84.2.6.2
+        type: gauge
+        help: Indicates the observed current heap utilization, in percent (%). - 1.3.6.1.4.1.119.2.3.84.2.6.2
+      - name: pipSecMibLevel
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+        type: gauge
+        help: The version of the IPsec MIB. - 1.3.6.1.4.1.119.2.3.84.3.1.1.1
+      - name: pikeGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+        type: gauge
+        help: The number of currently active IPsec Phase-1 IKE Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.1
+      - name: pikeGlobalInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+        type: counter
+        help: The total number of notifys received by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.6
+      - name: pikeGlobalInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by all currently and
+          previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.7
+      - name: pikeGlobalInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and found
+          to be contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.8
+      - name: pikeGlobalInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were received and validated
+          but were rejected by the local policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.9
+      - name: pikeGlobalInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by all currently and previously active and IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.10
+      - name: pikeGlobalOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+        type: counter
+        help: The total number of notifys sent by all currently and previously active
+          IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.14
+      - name: pikeGlobalOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.15
+      - name: pikeGlobalOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent and were flagged
+          by the peer to contain references to unrecognized security parameters - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.16
+      - name: pikeGlobalOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges which were sent, validated by
+          the peer but were rejected by the peer's policy - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.17
+      - name: pikeGlobalOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+        type: counter
+        help: The total number of IPsec Phase-2 SA delete requests sent by all currently
+          and previously active IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.18
+      - name: pikeGlobalInitTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.19
+      - name: pikeGlobalInitTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were locally initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.20
+      - name: pikeGlobalRespTunnelFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated
+          and failed to activate. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.21
+      - name: pikeGlobalAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+        type: counter
+        help: The total number of authentications which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.23
+      - name: pikeGlobalDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+        type: counter
+        help: The total number of decryptions which ended in failure by all current and
+          previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.24
+      - name: pikeGlobalHashValidFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+        type: counter
+        help: The total number of hash validations which ended in failure by all current
+          and previous IPsec Phase-1 IKE Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.25
+      - name: pikeGlobalRespTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+        type: counter
+        help: The total number of IPsec Phase-1 IKE Tunnels which were remotely initiated.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.27
+      - name: pikeGlobalInP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+        type: counter
+        help: The total number of ISAKMP security association delete requests received
+          by all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.30
+      - name: pikeGlobalOutP1SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+        type: counter
+        help: The total number of ISAKMP security association delete requests sent by
+          all currently and previously active and ISAKMP security associations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.1.31
+      - name: pikePeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.1
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.2
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.3
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikePeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.4
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.5
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        type: OctetString
+        help: The IP address of the local peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.6
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        type: OctetString
+        help: The IP address of the remote peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.7
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        type: gauge
+        help: The length of time that the peer association has existed in hundredths of
+          a second. - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.8
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikePeerActiveTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        type: gauge
+        help: The index of the active IPsec Phase-1 IKE Tunnel (pikeTunIndex in the pikeTunnelTable)
+          for this peer association - 1.3.6.1.4.1.119.2.3.84.3.1.2.2.1.9
+        indexes:
+        - labelname: pikePeerLocalType
+          type: gauge
+        - labelname: pikePeerLocalValue
+          type: DisplayString
+        - labelname: pikePeerRemoteType
+          type: gauge
+        - labelname: pikePeerRemoteValue
+          type: DisplayString
+        - labelname: pikePeerIntIndex
+          type: gauge
+      - name: pikeTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.1
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.2
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.3
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.4
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.6
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.7
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.8
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.10
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.11
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.12
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.13
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.14
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.15
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.16
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunSaRefreshThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        type: gauge
+        help: The security assoication refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.17
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.22
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.23
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.24
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.25
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.26
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.30
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.31
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.32
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.33
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.34
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+      - name: pikeTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.2.3.1.35
+        indexes:
+        - labelname: pikeTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecGlobalActiveTunnels
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+        type: gauge
+        help: The total number of currently active IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.1
+      - name: pipSecGlobalInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+        type: counter
+        help: The total number of octets received by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.3
+      - name: pipSecGlobalInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+        type: counter
+        help: The total number of packets received by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.9
+      - name: pipSecGlobalInDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+        type: counter
+        help: The total number of packets dropped during receive processing by all current
+          and previous IPsec Phase-2 Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.10
+      - name: pipSecGlobalInReplayDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.11
+      - name: pipSecGlobalInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+        type: counter
+        help: The total number of inbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.12
+      - name: pipSecGlobalInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.13
+      - name: pipSecGlobalInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+        type: counter
+        help: The total number of inbound decryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.14
+      - name: pipSecGlobalInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.15
+      - name: pipSecGlobalOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+        type: counter
+        help: The total number of octets sent by all current and previous IPsec Phase-2
+          Tunnels - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.16
+      - name: pipSecGlobalOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+        type: counter
+        help: The total number of packets sent by all current and previous IPsec Phase-2
+          Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.22
+      - name: pipSecGlobalOutDrops
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+        type: counter
+        help: The total number of packets dropped during send processing by all current
+          and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.23
+      - name: pipSecGlobalOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+        type: counter
+        help: The total number of outbound authentication's performed by all current and
+          previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.24
+      - name: pipSecGlobalOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          all current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.25
+      - name: pipSecGlobalOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+        type: counter
+        help: The total number of outbound encryption's performed by all current and previous
+          IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.26
+      - name: pipSecGlobalOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by all
+          current and previous IPsec Phase-2 Tunnels. - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.27
+      - name: pipSecGlobalNoSaFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+        type: counter
+        help: The total number of non-existent Security Assocication in failures which
+          occurred during processing of all current and previous IPsec Phase-2 Tunnels.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.1.33
+      - name: pipSecTunIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        type: gauge
+        help: The index of the associated IPsec Phase-1 IKE Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunIkeTunnelAlive
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        type: gauge
+        help: An indicator which specifies whether or not the IPsec Phase-1 IKE Tunnel
+          currently exists. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: pipSecTunLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.6
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.7
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.8
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.9
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.10
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeSizeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        type: gauge
+        help: The security association LifeSize refresh threshold in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.11
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunSaLifeTimeThreshold
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        type: gauge
+        help: The security association LifeTime refresh threshold in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.12
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.13
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunExpiredSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        type: counter
+        help: The total number of security associations which have expired. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.14
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunCurrentSaInstances
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        type: gauge
+        help: The number of security associations which are currently active or expiring.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.15
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.16
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.17
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.18
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.19
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.21
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.22
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.23
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.24
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        type: gauge
+        help: The Path MTU that has been determined for this IPsec Phase-2 tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.26
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.27
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.33
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.34
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.35
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.36
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.37
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.38
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.39
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.40
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.46
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.47
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.48
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.49
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.50
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.51
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+      - name: pipSecTunStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        type: gauge
+        help: The status of the MIB table row - 1.3.6.1.4.1.119.2.3.84.3.1.3.2.1.56
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: destroy
+      - name: pipSecSpiIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        type: gauge
+        help: The number of the SPI associated with the Phase-2 Tunnel Table - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.1
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiDirection
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        type: gauge
+        help: The direction of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.2
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: in
+          2: out
+      - name: pipSecSpiValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        type: gauge
+        help: The value of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.3
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+      - name: pipSecSpiProtocol
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        type: gauge
+        help: The protocol of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.4
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: ah
+          2: esp
+          3: ipcomp
+      - name: pipSecSpiStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        type: gauge
+        help: The status of the SPI. - 1.3.6.1.4.1.119.2.3.84.3.1.3.4.1.5
+        indexes:
+        - labelname: pipSecTunIndex
+          type: gauge
+        - labelname: pipSecSpiIndex
+          type: gauge
+        enum_values:
+          1: active
+          2: expiring
+      - name: pikeTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-1 IKE Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.1
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-1 IKE Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.2
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: localFailure
+          9: checkPointReg
+      - name: pikeTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.3
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerLocalType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        type: gauge
+        help: The type of local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.4
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerLocalValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        type: DisplayString
+        help: The value of the local peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.5
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerIntIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        type: gauge
+        help: The internal index of the local-remote peer association - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.6
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistPeerRemoteType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        type: gauge
+        help: The type of remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.7
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: idIpv4Addr
+          2: idFqdn
+          3: idDn
+          4: idIpv6Addr
+      - name: pikeTunHistPeerRemoteValue
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        type: DisplayString
+        help: The value of the remote peer identity - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.8
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.9
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-1 IKE Tunnel.
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.11
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistNegoMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        type: gauge
+        help: The negotiation mode of the IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.13
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: main
+          2: aggressive
+      - name: pikeTunHistDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        type: gauge
+        help: The Diffie Hellman Group used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.14
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pikeTunHistEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        type: gauge
+        help: The encryption algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.15
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pikeTunHistHashAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        type: gauge
+        help: The hash algorithm used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.16
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: md5
+          3: sha
+          4: sha2-256
+          5: sha2-384
+          6: sha2-512
+      - name: pikeTunHistAuthMethod
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        type: gauge
+        help: The authentication method used in IPsec Phase-1 IKE negotiations. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.17
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: preSharedKey
+          3: rsaSig
+          4: rsaEncrypt
+          5: revPublicKey
+      - name: pikeTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-1 IKE Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.18
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-1 IKE
+          tunnel was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.19
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        type: gauge
+        help: The length of time the IPsec Phase-1 IKE tunnel was been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.20
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        type: counter
+        help: The total number of notifys received by this IPsec Phase-1 IKE Tunnel. -
+          1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.26
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received by this IPsec Phase-1
+          IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.27
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were found to contain references to unrecognized security parameters. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.28
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges received on this tunnel that
+          were validated but were rejected by the local policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.29
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistInP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests received
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.30
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutNotifys
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        type: counter
+        help: The total number of notifys sent by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.34
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2Exchgs
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent by this IPsec Phase-1 IKE
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.35
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgInvalids
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          found by the peer to contain references to security parameters not recognized
+          by the peer. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.36
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2ExchgRejects
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        type: counter
+        help: The total number of IPsec Phase-2 exchanges sent on this tunnel that were
+          validated by the peer but were rejected by the peer's policy. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.37
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pikeTunHistOutP2SaDelRequests
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        type: counter
+        help: The total number of IPsec Phase-2 security association delete requests sent
+          by this IPsec Phase-1 IKE Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.2.1.1.38
+        indexes:
+        - labelname: pikeTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        type: gauge
+        help: The index of the IPsec Phase-2 Tunnel History Table - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.1
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTermReason
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        type: gauge
+        help: The reason the IPsec Phase-2 Tunnel was terminated - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.2
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: normal
+          3: operRequest
+          4: peerDelRequest
+          5: peerLost
+          6: applicationInitiated
+          7: xauthFailure
+          8: seqNumRollOver
+          9: checkPointReq
+      - name: pipSecTunHistActiveIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        type: gauge
+        help: The index of the previously active IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.3
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistIkeTunnelIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        type: gauge
+        help: The index of the associated IPsec Phase-1 Tunnel (pikeTunIndex in the pikeTunnelTable).
+          - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.4
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLocalAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        type: OctetString
+        help: The IP address of the local endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.5
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistRemoteAddr
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        type: OctetString
+        help: The IP address of the remote endpoint for the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.6
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistKeyType
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        type: gauge
+        help: The type of key used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.7
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: ike
+          2: manual
+      - name: pipSecTunHistEncapMode
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        type: gauge
+        help: The encapsulation mode used by the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.8
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: tunnel
+          2: transport
+      - name: pipSecTunHistLifeSize
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        type: gauge
+        help: The negotiated LifeSize of the IPsec Phase-2 Tunnel in kilobytes. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.9
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistLifeTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        type: gauge
+        help: The negotiated LifeTime of the IPsec Phase-2 Tunnel in seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.10
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistStartTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        type: gauge
+        help: The value of sysUpTime in hundredths of seconds when the IPsec Phase-2 Tunnel
+          was started. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.11
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistActiveTime
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        type: gauge
+        help: The length of time the IPsec Phase-2 Tunnel has been active in hundredths
+          of seconds. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.12
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistTotalRefreshes
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        type: counter
+        help: The total number of security association refreshes performed. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.13
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        type: gauge
+        help: The Diffie Hellman Group used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.15
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistInSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        type: gauge
+        help: The encryption algorithm used by the inbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.16
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistInSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        type: gauge
+        help: The authentication algorithm used by the inbound authentication header (AH)
+          security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.17
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistInSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        type: gauge
+        help: The authentication algorithm used by the inbound encapsulation security
+          protocol (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.18
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaDiffHellmanGrp
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        type: gauge
+        help: The Diffie Hellman Group used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.20
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: modp768
+          3: modp1024
+          4: modp1536
+          5: modp2048
+      - name: pipSecTunHistOutSaEncryptAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        type: gauge
+        help: The encryption algorithm used by the outbound security association of the
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.21
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: des
+          3: des3
+          4: aes
+          9: "null"
+      - name: pipSecTunHistOutSaAhAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        type: gauge
+        help: The authentication algorithm used by the outbound authentication header
+          (AH) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.22
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistOutSaEspAuthAlgo
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        type: gauge
+        help: The authentication algorithm used by the inbound ecapsulation security protocol
+          (ESP) security association of the IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.23
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+        enum_values:
+          1: none
+          2: hmacMd5
+          3: hmacSha
+          4: hmacSha2-256
+          5: hmacSha2-384
+          6: hmacSha2-512
+      - name: pipSecTunHistPmtu
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        type: gauge
+        help: The Path MTU that was determined for this IPsec Phase-2 tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.25
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        type: counter
+        help: The total number of octets received by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.26
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        type: counter
+        help: The total number of packets received by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.32
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        type: counter
+        help: The total number of packets dropped during receive processing by this IPsec
+          Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.33
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInReplayDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        type: counter
+        help: The total number of packets dropped during receive processing due to Anti-Replay
+          processing by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.34
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        type: counter
+        help: The total number of inbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.35
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        type: counter
+        help: The total number of inbound authentication's which ended in failure by this
+          IPsec Phase-2 Tunnel . - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.36
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        type: counter
+        help: The total number of inbound decryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.37
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistInDecryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        type: counter
+        help: The total number of inbound decryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.38
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutOctets
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        type: counter
+        help: The total number of octets sent by this IPsec Phase-2 Tunnel - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.39
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        type: counter
+        help: The total number of packets sent by this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.45
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutDropPkts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        type: counter
+        help: The total number of packets dropped during send processing by this IPsec
+          Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.46
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuths
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        type: counter
+        help: The total number of outbound authentication's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.47
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutAuthFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        type: counter
+        help: The total number of outbound authentication's which ended in failure by
+          this IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.48
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncrypts
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        type: counter
+        help: The total number of outbound encryption's performed by this IPsec Phase-2
+          Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.49
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: pipSecTunHistOutEncryptFails
+        oid: 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        type: counter
+        help: The total number of outbound encryption's which ended in failure by this
+          IPsec Phase-2 Tunnel. - 1.3.6.1.4.1.119.2.3.84.3.1.4.3.1.1.50
+        indexes:
+        - labelname: pipSecTunHistIndex
+          type: gauge
+      - name: picoExtIfInstalledSlot
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        type: gauge
+        help: The slot number in which the extension card was installed. - 1.3.6.1.4.1.119.2.3.84.6.1.1.1
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        type: gauge
+        help: A unique value for each extension card. - 1.3.6.1.4.1.119.2.3.84.6.1.1.2
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDescr
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        type: DisplayString
+        help: A textual string containing information about the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.3
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfUpperLayer
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        type: gauge
+        help: Index of interface to upper layers. - 1.3.6.1.4.1.119.2.3.84.6.1.1.4
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        type: gauge
+        help: The type of interface,, distinguished according to the physical/link protocol(s)
+          immediately `below' the network layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.5
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          6: ethernet-csmacd
+          62: fastEther
+      - name: picoExtIfSpeed
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second. - 1.3.6.1.4.1.119.2.3.84.6.1.1.6
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfDuplex
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        type: gauge
+        help: The current mode of this link. - 1.3.6.1.4.1.119.2.3.84.6.1.1.7
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: halfduplex
+          2: fullduplex
+      - name: picoExtIfEffectiveMtu
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        type: gauge
+        help: The size of the largest datagram which can be sent/received on the interface,
+          specified in octets. - 1.3.6.1.4.1.119.2.3.84.6.1.1.8
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfPhysicalAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        type: PhysAddress48
+        help: The interface's address at the protocol layer immediately `below' the network
+          layer in the protocol stack. - 1.3.6.1.4.1.119.2.3.84.6.1.1.9
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoExtIfAdminStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        type: gauge
+        help: The desired state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.10
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfOperStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        type: gauge
+        help: The current operational state of the interface. - 1.3.6.1.4.1.119.2.3.84.6.1.1.11
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: picoExtIfLastChange
+        oid: 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state. - 1.3.6.1.4.1.119.2.3.84.6.1.1.12
+        indexes:
+        - labelname: picoExtIfInstalledSlot
+          type: gauge
+        - labelname: picoExtIfIndex
+          type: gauge
+      - name: picoNetmonWatchgroupIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        type: gauge
+        help: Unique index for each Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.1
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupName
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        type: DisplayString
+        help: Netmon Watchgroup Name. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.2
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupSequenceNumber
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        type: gauge
+        help: Netmon Watchgroup sequence number. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.3
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNetmonWatchgroupStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        type: gauge
+        help: Status of a Netmon Watchgroup. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.4
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+        enum_values:
+          1: normal
+          2: stand
+          3: disable
+      - name: picoNetmonWatchgroupVarianceCounts
+        oid: 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        type: gauge
+        help: Netmon Watchgroup variance statistics. - 1.3.6.1.4.1.119.2.3.84.7.1.1.1.5
+        indexes:
+        - labelname: picoNetmonWatchgroupIndex
+          type: gauge
+      - name: picoNgnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN is enabled. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.1
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2
+        type: gauge
+        help: 'The mode of the NGN service can be: standard(1) :NGN service is standard
+          - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.2'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: standard
+          2: numbergate
+      - name: picoNgnIfType
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3
+        type: gauge
+        help: 'The type of the NGN interface can be: global(1) :NGN interface type is
+          global - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.3'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: global
+          2: private
+      - name: picoNgnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4
+        type: gauge
+        help: 'The state of the NGN SIP-UA register can be: notReady(1) :NGN service is
+          not Ready - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.4'
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+        enum_values:
+          1: notReady
+          2: initializing
+          3: registering
+          4: registered
+      - name: picoNgnSipServerIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        type: InetAddressIPv4
+        help: The object of the SIP server address. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.5
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnSipUri
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        type: DisplayString
+        help: The object of the SIP URI. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.6
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnUpTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        type: gauge
+        help: The time elapsed since registered. - 1.3.6.1.4.1.119.2.3.84.9.1.1.1.7
+        indexes:
+        - labelname: picoNgnIfIndex
+          type: gauge
+      - name: picoNgnVpnIfIndex
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        type: gauge
+        help: The interface index value of the interface for which NGN binding is enabled.
+          - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.1
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnStatus
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2
+        type: gauge
+        help: 'The state of the NGN SIP-UA session can be: disconnected(1):SIP session
+          is disconnected - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.2'
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+        enum_values:
+          1: disconnected
+          2: connecting
+          3: connected
+      - name: picoNgnVpnPeerAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        type: DisplayString
+        help: The object of the NGN peer address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.3
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnBandwidth
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        type: gauge
+        help: The object of the NGN session bandwidth. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.4
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnUsedTime
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        type: gauge
+        help: The time elapsed since this connected NGN session. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.5
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcIpAddress
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        type: InetAddressIPv4
+        help: The object of the NGN session SBC address. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.6
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+      - name: picoNgnVpnSbcPort
+        oid: 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        type: gauge
+        help: The object of the NGN session SBC port. - 1.3.6.1.4.1.119.2.3.84.9.1.2.1.7
+        indexes:
+        - labelname: picoNgnVpnIfIndex
+          type: gauge
+    paloalto_fw:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.1
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.25.3
+      - 1.3.6.1.4.1.25461.2.1.2.1
+      - 1.3.6.1.4.1.25461.2.1.2.3
+      - 1.3.6.1.4.1.25461.2.1.2.5
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: gauge
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: hrSystemUptime
+        oid: 1.3.6.1.2.1.25.1.1
+        type: gauge
+        help: The amount of time since this host was last initialized - 1.3.6.1.2.1.25.1.1
+      - name: hrSystemDate
+        oid: 1.3.6.1.2.1.25.1.2
+        type: DateAndTime
+        help: The host's notion of the local date and time of day. - 1.3.6.1.2.1.25.1.2
+      - name: hrSystemInitialLoadDevice
+        oid: 1.3.6.1.2.1.25.1.3
+        type: gauge
+        help: The index of the hrDeviceEntry for the device from which this host is configured
+          to load its initial operating system configuration (i.e., which operating system
+          code and/or boot parameters) - 1.3.6.1.2.1.25.1.3
+      - name: hrSystemInitialLoadParameters
+        oid: 1.3.6.1.2.1.25.1.4
+        type: OctetString
+        help: This object contains the parameters (e.g - 1.3.6.1.2.1.25.1.4
+      - name: hrSystemNumUsers
+        oid: 1.3.6.1.2.1.25.1.5
+        type: gauge
+        help: The number of user sessions for which this host is storing state information
+          - 1.3.6.1.2.1.25.1.5
+      - name: hrSystemProcesses
+        oid: 1.3.6.1.2.1.25.1.6
+        type: gauge
+        help: The number of process contexts currently loaded or running on this system.
+          - 1.3.6.1.2.1.25.1.6
+      - name: hrSystemMaxProcesses
+        oid: 1.3.6.1.2.1.25.1.7
+        type: gauge
+        help: The maximum number of process contexts this system can support - 1.3.6.1.2.1.25.1.7
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+      - name: hrDeviceIndex
+        oid: 1.3.6.1.2.1.25.3.2.1.1
+        type: gauge
+        help: A unique value for each device contained by the host - 1.3.6.1.2.1.25.3.2.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceType
+        oid: 1.3.6.1.2.1.25.3.2.1.2
+        type: OctetString
+        help: An indication of the type of device - 1.3.6.1.2.1.25.3.2.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceDescr
+        oid: 1.3.6.1.2.1.25.3.2.1.3
+        type: DisplayString
+        help: A textual description of this device, including the device's manufacturer
+          and revision, and optionally, its serial number. - 1.3.6.1.2.1.25.3.2.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceID
+        oid: 1.3.6.1.2.1.25.3.2.1.4
+        type: OctetString
+        help: The product ID for this device. - 1.3.6.1.2.1.25.3.2.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDeviceStatus
+        oid: 1.3.6.1.2.1.25.3.2.1.5
+        type: gauge
+        help: The current operational state of the device described by this row of the
+          table - 1.3.6.1.2.1.25.3.2.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: unknown
+          2: running
+          3: warning
+          4: testing
+          5: down
+      - name: hrDeviceErrors
+        oid: 1.3.6.1.2.1.25.3.2.1.6
+        type: counter
+        help: The number of errors detected on this device - 1.3.6.1.2.1.25.3.2.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorFrwID
+        oid: 1.3.6.1.2.1.25.3.3.1.1
+        type: OctetString
+        help: The product ID of the firmware associated with the processor. - 1.3.6.1.2.1.25.3.3.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrProcessorLoad
+        oid: 1.3.6.1.2.1.25.3.3.1.2
+        type: gauge
+        help: The average, over the last minute, of the percentage of time that this processor
+          was not idle - 1.3.6.1.2.1.25.3.3.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrNetworkIfIndex
+        oid: 1.3.6.1.2.1.25.3.4.1.1
+        type: gauge
+        help: The value of ifIndex which corresponds to this network device - 1.3.6.1.2.1.25.3.4.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: gauge
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: hrPrinterDetectedErrorState
+        oid: 1.3.6.1.2.1.25.3.5.1.2
+        type: OctetString
+        help: This object represents any error conditions detected by the printer - 1.3.6.1.2.1.25.3.5.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrDiskStorageAccess
+        oid: 1.3.6.1.2.1.25.3.6.1.1
+        type: gauge
+        help: An indication if this long-term storage device is readable and writable
+          or only readable - 1.3.6.1.2.1.25.3.6.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrDiskStorageMedia
+        oid: 1.3.6.1.2.1.25.3.6.1.2
+        type: gauge
+        help: An indication of the type of media used in this long- term storage device.
+          - 1.3.6.1.2.1.25.3.6.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: hardDisk
+          4: floppyDisk
+          5: opticalDiskROM
+          6: opticalDiskWORM
+          7: opticalDiskRW
+          8: ramDisk
+      - name: hrDiskStorageRemoveble
+        oid: 1.3.6.1.2.1.25.3.6.1.3
+        type: gauge
+        help: Denotes whether or not the disk media may be removed from the drive. - 1.3.6.1.2.1.25.3.6.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrDiskStorageCapacity
+        oid: 1.3.6.1.2.1.25.3.6.1.4
+        type: gauge
+        help: The total size for this long-term storage device - 1.3.6.1.2.1.25.3.6.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: hrPartitionIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.1
+        type: gauge
+        help: A unique value for each partition on this long-term storage device - 1.3.6.1.2.1.25.3.7.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionLabel
+        oid: 1.3.6.1.2.1.25.3.7.1.2
+        type: OctetString
+        help: A textual description of this partition. - 1.3.6.1.2.1.25.3.7.1.2
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionID
+        oid: 1.3.6.1.2.1.25.3.7.1.3
+        type: OctetString
+        help: A descriptor which uniquely represents this partition to the responsible
+          operating system - 1.3.6.1.2.1.25.3.7.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionSize
+        oid: 1.3.6.1.2.1.25.3.7.1.4
+        type: gauge
+        help: The size of this partition. - 1.3.6.1.2.1.25.3.7.1.4
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrPartitionFSIndex
+        oid: 1.3.6.1.2.1.25.3.7.1.5
+        type: gauge
+        help: The index of the file system mounted on this partition - 1.3.6.1.2.1.25.3.7.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: hrPartitionIndex
+          type: gauge
+      - name: hrFSIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.1
+        type: gauge
+        help: A unique value for each file system local to this host - 1.3.6.1.2.1.25.3.8.1.1
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.2
+        type: OctetString
+        help: The path name of the root of this file system. - 1.3.6.1.2.1.25.3.8.1.2
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSRemoteMountPoint
+        oid: 1.3.6.1.2.1.25.3.8.1.3
+        type: OctetString
+        help: A description of the name and/or address of the server that this file system
+          is mounted from - 1.3.6.1.2.1.25.3.8.1.3
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSType
+        oid: 1.3.6.1.2.1.25.3.8.1.4
+        type: OctetString
+        help: The value of this object identifies the type of this file system. - 1.3.6.1.2.1.25.3.8.1.4
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSAccess
+        oid: 1.3.6.1.2.1.25.3.8.1.5
+        type: gauge
+        help: An indication if this file system is logically configured by the operating
+          system to be readable and writable or only readable - 1.3.6.1.2.1.25.3.8.1.5
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: readWrite
+          2: readOnly
+      - name: hrFSBootable
+        oid: 1.3.6.1.2.1.25.3.8.1.6
+        type: gauge
+        help: A flag indicating whether this file system is bootable. - 1.3.6.1.2.1.25.3.8.1.6
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: hrFSStorageIndex
+        oid: 1.3.6.1.2.1.25.3.8.1.7
+        type: gauge
+        help: The index of the hrStorageEntry that represents information about this file
+          system - 1.3.6.1.2.1.25.3.8.1.7
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastFullBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.8
+        type: DateAndTime
+        help: The last date at which this complete file system was copied to another storage
+          device for backup - 1.3.6.1.2.1.25.3.8.1.8
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: hrFSLastPartialBackupDate
+        oid: 1.3.6.1.2.1.25.3.8.1.9
+        type: DateAndTime
+        help: The last date at which a portion of this file system was copied to another
+          storage device for backup - 1.3.6.1.2.1.25.3.8.1.9
+        indexes:
+        - labelname: hrFSIndex
+          type: gauge
+      - name: panAhoSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.1
+        type: counter
+        help: The total usage of software for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.1
+      - name: panDfaSw
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.2
+        type: counter
+        help: The total number of dfa match using software - 1.3.6.1.4.1.25461.2.1.2.1.19.2
+      - name: panFlowHostServiceAllow
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.3
+        type: counter
+        help: Device management session allowed - 1.3.6.1.4.1.25461.2.1.2.1.19.3
+      - name: panHaPathmonSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.4
+        type: counter
+        help: HA path-monitoring packets sent - 1.3.6.1.4.1.25461.2.1.2.1.19.4
+      - name: panAhoFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.5
+        type: counter
+        help: The total requests to FPGA for AHO - 1.3.6.1.4.1.25461.2.1.2.1.19.5
+      - name: panDfaFpga
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.6
+        type: counter
+        help: The total requests to FPGA for DFA - 1.3.6.1.4.1.25461.2.1.2.1.19.6
+      - name: panFpgaPkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.7
+        type: counter
+        help: The packets held because of requests to FPGA - 1.3.6.1.4.1.25461.2.1.2.1.19.7
+      - name: panFlowDosAgMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+        type: counter
+        help: Session limit reached for aggregate profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.1
+      - name: panFlowDosBlkNumEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+        type: counter
+        help: Number of entries in DOS block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.2
+      - name: panFlowDosClMaxSessLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+        type: counter
+        help: Session limit reached for classified profile, drop session - 1.3.6.1.4.1.25461.2.1.2.1.19.8.3
+      - name: panFlowDosClSyncookieAckErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.4
+        type: counter
+        help: 'TCP SYN cookies: Invalid ACKs received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.4'
+      - name: panFlowDosClSyncookieAckRcv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.5
+        type: counter
+        help: 'TCP SYN cookies: ACKs to cookies received, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.5'
+      - name: panFlowDosClSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.6
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.6'
+      - name: panFlowDosClSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.7
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, classified pro -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.7'
+      - name: panFlowDosClSyncookieSent
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.8
+        type: counter
+        help: 'TCP SYN cookies: cookies sent, classified profile - 1.3.6.1.4.1.25461.2.1.2.1.19.8.8'
+      - name: panFlowMeterVsysThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.9
+        type: counter
+        help: 'Session metering: sessions throttled by vsys configuration - 1.3.6.1.4.1.25461.2.1.2.1.19.8.9'
+      - name: panFlowPolicyDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.10
+        type: counter
+        help: 'Session setup: denied by policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.10'
+      - name: panFlowPolicyNat
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.11
+        type: counter
+        help: 'Session setup: source NAT IP/port allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.8.11'
+      - name: panFlowScanDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.12
+        type: counter
+        help: 'Session setup: denied by scan detection - 1.3.6.1.4.1.25461.2.1.2.1.19.8.12'
+      - name: panFlowDosDropIpBlocked
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.13
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration by oth -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.13'
+      - name: panFlowDosRedIcmp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.14
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.14'
+      - name: panFlowDosRedIcmp6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.15
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''icmpv6'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.15'
+      - name: panFlowDosRedIp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.16
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''other-ip'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.16'
+      - name: panFlowDosRedTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.17
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''tcp-syn'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.17'
+      - name: panFlowDosRedUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.18
+        type: counter
+        help: 'Packets dropped: Zone protection protocol ''udp'' RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.18'
+      - name: panFlowDosRuleAgBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.19
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.19'
+      - name: panFlowDosRuleAgRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.20
+        type: counter
+        help: 'Packets dropped: Activate aggregate RED threshold reached, random ear -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.20'
+      - name: panFlowDosRuleAgRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.21
+        type: counter
+        help: 'Packets dropped: Maximal aggregate RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.21'
+      - name: panFlowDosRuleDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.22
+        type: counter
+        help: 'Packets dropped: Denied action by DoS policy - 1.3.6.1.4.1.25461.2.1.2.1.19.8.22'
+      - name: panFlowDosRuleDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.23
+        type: counter
+        help: 'Packets dropped: Rate limited or IP blocked - 1.3.6.1.4.1.25461.2.1.2.1.19.8.23'
+      - name: panFlowDosRuleDropAggr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.24
+        type: counter
+        help: 'Packets dropped: due to aggregate rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.24'
+      - name: panFlowDosRuleDropClBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.25
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for cl -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.25'
+      - name: panFlowDosRuleDropClRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.26
+        type: counter
+        help: 'Packets dropped: Activate classified RED threshold reached, random ea -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.26'
+      - name: panFlowDosRuleDropClRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.27
+        type: counter
+        help: 'Packets dropped: Maximal classified RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.27'
+      - name: panFlowDosRuleDropClassified
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.28
+        type: counter
+        help: 'Packets dropped: due to classified rate limiting - 1.3.6.1.4.1.25461.2.1.2.1.19.8.28'
+      - name: panFlowDosSyncookieBlkDur
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.29
+        type: counter
+        help: 'Packets dropped: Flagged for blocking and under block duration for ag -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.29'
+      - name: panFlowDosSyncookieMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.30
+        type: counter
+        help: 'Packet dropped: SYN cookies maximum threshold reached, aggregate prof -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.30'
+      - name: panFlowDosZoneRedAct
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.31
+        type: counter
+        help: 'Packets dropped: Activate zone RED threshold reached, random early dr -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.31'
+      - name: panFlowDosZoneRedMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.32
+        type: counter
+        help: 'Packets dropped: Maximal zone RED threshold reached - 1.3.6.1.4.1.25461.2.1.2.1.19.8.32'
+      - name: panFlowDosBlkSwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+        type: counter
+        help: Number of entries in DOS Software block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.33
+      - name: panFlowDosBlkHwEntries
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+        type: counter
+        help: Number of entries in DOS Hardware block table - 1.3.6.1.4.1.25461.2.1.2.1.19.8.34
+      - name: panFlowDosSyncookieNotTcpSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN - 1.3.6.1.4.1.25461.2.1.2.1.19.8.35
+      - name: panFlowDosSyncookieNotTcpSynAck
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+        type: counter
+        help: TCP SYN cookies:TCP SYN cookie not SYN-ACK - 1.3.6.1.4.1.25461.2.1.2.1.19.8.36
+      - name: panFlowDosPfIpspoof
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-spoof' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.37
+      - name: panFlowDosPfIpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-ip-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.38
+      - name: panFlowDosPfPing0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-ping-zero-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.39
+      - name: panFlowDosPfIcmpfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-frag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.40
+      - name: panFlowDosPfIcmplpkt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-large-packet' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.41
+      - name: panFlowDosPfIcmperr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-icmp-error' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.42
+      - name: panFlowDosPfNoreplyttl
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-timeexceeded' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.43
+      - name: panFlowDosPfNoreplyneedfrag
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+        type: counter
+        help: Packets dropped:Zone protection option 'suppress-icmp-needfrag' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.44
+      - name: panFlowDosPfStrictsource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-strict-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.45
+      - name: panFlowDosPfLoosesource
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-loose-source-routing' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.46
+      - name: panFlowDosPfTimestamp
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-timestamp' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.47
+      - name: panFlowDosPfRecordroute
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-record-route' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.48
+      - name: panFlowDosPfSecurity
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-security' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.49
+      - name: panFlowDosPfSatnetid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-stream-id' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.50
+      - name: panFlowDosPfUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-unknown-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.51
+      - name: panFlowDosPfBadoption
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-malformed-option' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.52
+      - name: panFlowDosPfTcpoverlappingmismatch
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-overlapping-tcp-segment-mismatch'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.53
+      - name: panFlowDosPfStrictip
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+        type: counter
+        help: Packets dropped:Zone protection option 'strict-ip-check' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.54
+      - name: panFlowDosPfTcpsplithandshake
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-split-handshake' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.55
+      - name: panFlowDosPfTcpsyndata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-syn-with-data' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.56
+      - name: panFlowDosPfTcpsynackdata
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+        type: counter
+        help: Packets dropped:Zone protection option 'discard-tcp-synack-with-data' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.57
+      - name: panFlowDosIp6Route0
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-0' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.58
+      - name: panFlowDosIp6Route1
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-1' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.59
+      - name: panFlowDosIp6Route3
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-3' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.60
+      - name: panFlowDosIp6Route4to252
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-4-252' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.61
+      - name: panFlowDosIp6Route253
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-253' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.62
+      - name: panFlowDosIp6Route254
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-254' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.63
+      - name: panFlowDosIp6Route255
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-header-255' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.64
+      - name: panFlowDosIp6Ip4cmpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+        type: counter
+        help: Packets dropped:Zone protection option 'ipv4-compatible-address' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.65
+      - name: panFlowDosIp6Acast
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+        type: counter
+        help: Packets dropped:Zone protection option 'anycast-source' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.66
+      - name: panFlowDosIp6OptionsInvalidIPv6
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+        type: counter
+        help: Packets dropped:Zone protection option 'options-invalid-ipv6-discard' -
+          1.3.6.1.4.1.25461.2.1.2.1.19.8.67
+      - name: panFlowDosIp6Icmpv6ErrorInvalid
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+        type: counter
+        help: Packets dropped:Zone protection option 'icmpv6-too-big-small-mtu-discard'
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.8.68
+      - name: panFlowDosIp6NeedlessIpv6FragHdr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+        type: counter
+        help: Packets dropped:Zone protection option 'needless-fragment-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.69
+      - name: panFlowDosIp6RsvdSet
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+        type: counter
+        help: Packets dropped:Zone protection option 'reserved-field-set-discard' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.70
+      - name: panFlowDosIPv6ExtHdrHopByHop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+        type: counter
+        help: Packets dropped:Zone protection option 'hop-by-hop-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.71
+      - name: panFlowDosip6IPv6ExtHdrRouting
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+        type: counter
+        help: Packets dropped:Zone protection option 'routing-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.72
+      - name: panFlowDosIp6IPv6ExtHdrDestOpt
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+        type: counter
+        help: Packets dropped:Zone protection option 'dest-option-hdr' - 1.3.6.1.4.1.25461.2.1.2.1.19.8.73
+      - name: panFlowDosPbpDrop
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+        type: counter
+        help: Packets dropped:Dropped by packet buffer protection RED - 1.3.6.1.4.1.25461.2.1.2.1.19.8.74
+      - name: panFlowDosCurrSessIncrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+        type: counter
+        help: Unable to increment current session count on session create - 1.3.6.1.4.1.25461.2.1.2.1.19.8.75
+      - name: panFlowDosCurrSessDecrFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+        type: counter
+        help: Unable to decrement current session count on session delete - 1.3.6.1.4.1.25461.2.1.2.1.19.8.76
+      - name: panFlowFwdL3TtlZero
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.1
+        type: counter
+        help: 'Packets dropped: IP TTL reaches zero - 1.3.6.1.4.1.25461.2.1.2.1.19.9.1'
+      - name: panFlowMeterHostThrottle
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.2
+        type: counter
+        help: 'Session metering: sessions throttled by management session threshold -
+          1.3.6.1.4.1.25461.2.1.2.1.19.9.2'
+      - name: panFlowHostServiceDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+        type: counter
+        help: Device management session denied - 1.3.6.1.4.1.25461.2.1.2.1.19.9.3
+      - name: panFlowHostServiceUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.4
+        type: counter
+        help: 'Session discarded: unknown application to control plane - 1.3.6.1.4.1.25461.2.1.2.1.19.9.4'
+      - name: panPktAllocFailure
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+        type: counter
+        help: Packet allocation error - 1.3.6.1.4.1.25461.2.1.2.1.19.9.5
+      - name: panPktAllocFailureCos
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+        type: counter
+        help: Packet allocation error due to QoS control - 1.3.6.1.4.1.25461.2.1.2.1.19.9.6
+      - name: panSessionDiscard
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+        type: counter
+        help: Session set to discard by security policy check - 1.3.6.1.4.1.25461.2.1.2.1.19.9.7
+      - name: panFlowIpfragFragErr
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.1
+        type: counter
+        help: 'Packet dropped: IP fragmentation error - 1.3.6.1.4.1.25461.2.1.2.1.19.10.1'
+      - name: panFlowIpfragRecv
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+        type: counter
+        help: IP fragments received - 1.3.6.1.4.1.25461.2.1.2.1.19.10.2
+      - name: panTcpAllocWqeFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+        type: counter
+        help: wqe allocation failure in tcp - 1.3.6.1.4.1.25461.2.1.2.1.19.11.1
+      - name: panTcpDeny
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+        type: counter
+        help: session denied because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.2
+      - name: panTcpDropOutOfWnd
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+        type: counter
+        help: out-of-window packets dropped - 1.3.6.1.4.1.25461.2.1.2.1.19.11.3
+      - name: panTcpDropPacket
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+        type: counter
+        help: packets dropped because of failure in tcp reassembly - 1.3.6.1.4.1.25461.2.1.2.1.19.11.4
+      - name: panFlowActionClose
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+        type: counter
+        help: TCP sessions closed via injecting RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.5
+      - name: panFlowActionReset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+        type: counter
+        help: TCP clients reset via responding RST - 1.3.6.1.4.1.25461.2.1.2.1.19.11.6
+      - name: panFlowTcpNonSyn
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+        type: counter
+        help: Non-SYN TCP packets without session match - 1.3.6.1.4.1.25461.2.1.2.1.19.11.7
+      - name: panTcpExceedSegLimit
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+        type: counter
+        help: packets dropped due to the limitation on global tcp out-of-order pack -
+          1.3.6.1.4.1.25461.2.1.2.1.19.11.8
+      - name: panFlowTciGreDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+        type: counter
+        help: Total GRE sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.1
+      - name: panFlowTciGreDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+        type: counter
+        help: Total GRE sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.2
+      - name: panFlowTciGreDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+        type: counter
+        help: Total unknown tunnel inspection packets in GRE tunnel [passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.3
+      - name: panFlowTciIpsecDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+        type: counter
+        help: Total Ipsec sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.4
+      - name: panFlowTciIpsecDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+        type: counter
+        help: Total IPSEC sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.5
+      - name: panFlowTciIpsecDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+        type: counter
+        help: Total unknown tunnel inspection packets in IPSEC tunnel [passed|dropped]
+          - 1.3.6.1.4.1.25461.2.1.2.1.19.12.6
+      - name: panFlowTciGtpDecapSuccess
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+        type: counter
+        help: Total GTP sessions tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.7
+      - name: panFlowTciGtpDecapFailed
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+        type: counter
+        help: Total GTP sessions for failed tunnel inspected - 1.3.6.1.4.1.25461.2.1.2.1.19.12.8
+      - name: panFlowTciGtpDecapUnknown
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+        type: counter
+        help: Total unknown tunnel inspection packets in GTP tunnel[passed|dropped] -
+          1.3.6.1.4.1.25461.2.1.2.1.19.12.9
+      - name: panSysSwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.1
+        type: DisplayString
+        help: Full software version - 1.3.6.1.4.1.25461.2.1.2.1.1
+      - name: panSysHwVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.2
+        type: DisplayString
+        help: Hardware version of the unit. - 1.3.6.1.4.1.25461.2.1.2.1.2
+      - name: panSysSerialNumber
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.3
+        type: DisplayString
+        help: The serial number of the unit - 1.3.6.1.4.1.25461.2.1.2.1.3
+      - name: panSysTimeZoneOffset
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.4
+        type: gauge
+        help: The offset in seconds from UTC of the system's time zone - 1.3.6.1.4.1.25461.2.1.2.1.4
+      - name: panSysDaylightSaving
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.5
+        type: gauge
+        help: Whether daylight savings are in currently in effect for the system's time
+          zone. - 1.3.6.1.4.1.25461.2.1.2.1.5
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: panSysVpnClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.6
+        type: DisplayString
+        help: Currently installed VPN client package version - 1.3.6.1.4.1.25461.2.1.2.1.6
+      - name: panSysAppVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.7
+        type: DisplayString
+        help: Currently installed application definition version - 1.3.6.1.4.1.25461.2.1.2.1.7
+      - name: panSysAvVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.8
+        type: DisplayString
+        help: Currently installed antivirus version - 1.3.6.1.4.1.25461.2.1.2.1.8
+      - name: panSysThreatVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.9
+        type: DisplayString
+        help: Currently installed threat definition version - 1.3.6.1.4.1.25461.2.1.2.1.9
+      - name: panSysUrlFilteringVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.10
+        type: DisplayString
+        help: Currently installed URL filtering version - 1.3.6.1.4.1.25461.2.1.2.1.10
+      - name: panSysHAState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.11
+        type: DisplayString
+        help: Current high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.11
+      - name: panSysHAPeerState
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.12
+        type: DisplayString
+        help: Current peer high-availability state. - 1.3.6.1.4.1.25461.2.1.2.1.12
+      - name: panSysHAMode
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.13
+        type: DisplayString
+        help: Current high-availability mode (disabled, active-passive, or active-active).
+          - 1.3.6.1.4.1.25461.2.1.2.1.13
+      - name: panSysUrlFilteringDatabase
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.14
+        type: DisplayString
+        help: Current installed URL filtering database (surfcontrol, brightcloud, etc)
+          - 1.3.6.1.4.1.25461.2.1.2.1.14
+      - name: panSysGlobalProtectClientVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.15
+        type: DisplayString
+        help: Currently installed global-protect client package version - 1.3.6.1.4.1.25461.2.1.2.1.15
+      - name: panSysOpswatDatafileVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.16
+        type: DisplayString
+        help: Currently installed opswat database version - 1.3.6.1.4.1.25461.2.1.2.1.16
+      - name: panSysWildfireVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.17
+        type: DisplayString
+        help: Currently installed wildfire content version - 1.3.6.1.4.1.25461.2.1.2.1.17
+      - name: panSysWildfirePrivateCloudVersion
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.18
+        type: DisplayString
+        help: Currently installed wildfire private cloud content version - 1.3.6.1.4.1.25461.2.1.2.1.18
+      - name: panSysAppReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.20
+        type: DisplayString
+        help: Currently installed application definition release date - 1.3.6.1.4.1.25461.2.1.2.1.20
+      - name: panSysThreatReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.21
+        type: DisplayString
+        help: Currently installed threat release date - 1.3.6.1.4.1.25461.2.1.2.1.21
+      - name: panSysAvReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.22
+        type: DisplayString
+        help: Currently installed antivirus release date - 1.3.6.1.4.1.25461.2.1.2.1.22
+      - name: panSysWfReleaseDate
+        oid: 1.3.6.1.4.1.25461.2.1.2.1.23
+        type: DisplayString
+        help: Currently installed WildFire release date - 1.3.6.1.4.1.25461.2.1.2.1.23
+      - name: panSessionUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.1
+        type: gauge
+        help: Session table utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.1
+      - name: panSessionMax
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.2
+        type: gauge
+        help: Total number of sessions supported. - 1.3.6.1.4.1.25461.2.1.2.3.2
+      - name: panSessionActive
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.3
+        type: gauge
+        help: Total number of active sessions. - 1.3.6.1.4.1.25461.2.1.2.3.3
+      - name: panSessionActiveTcp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.4
+        type: gauge
+        help: Total number of active TCP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.4
+      - name: panSessionActiveUdp
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.5
+        type: gauge
+        help: Total number of active UDP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.5
+      - name: panSessionActiveICMP
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.6
+        type: gauge
+        help: Total number of active ICMP sessions. - 1.3.6.1.4.1.25461.2.1.2.3.6
+      - name: panSessionActiveSslProxy
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.7
+        type: gauge
+        help: Total number of active SSL proxy sessions. - 1.3.6.1.4.1.25461.2.1.2.3.7
+      - name: panSessionSslProxyUtilization
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.8
+        type: gauge
+        help: SSL proxy Session utilization percentage - 1.3.6.1.4.1.25461.2.1.2.3.8
+      - name: panVsysId
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        type: gauge
+        help: Vsys id - 1.3.6.1.4.1.25461.2.1.2.3.9.1.1
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        type: DisplayString
+        help: User assigned vsys name (empty string if not available) - 1.3.6.1.4.1.25461.2.1.2.3.9.1.2
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysSessionUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        type: gauge
+        help: Vsys utilization percentage, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.3
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        type: gauge
+        help: Active sessions on this Vsys - 1.3.6.1.4.1.25461.2.1.2.3.9.1.4
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysMaxSessions
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        type: gauge
+        help: Max sessions on this Vsys, if session limit is configured - 1.3.6.1.4.1.25461.2.1.2.3.9.1.5
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        type: gauge
+        help: Number of active Tcp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.6
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        type: gauge
+        help: Number of active Udp Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.7
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panVsysActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        type: gauge
+        help: Number of active Other IP Connections per second for thie vSys. - 1.3.6.1.4.1.25461.2.1.2.3.9.1.8
+        indexes:
+        - labelname: panVsysId
+          type: gauge
+      - name: panZoneName
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        type: DisplayString
+        help: Zone name for the interface - 1.3.6.1.4.1.25461.2.1.2.3.10.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        type: gauge
+        help: Number of active TCP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        type: gauge
+        help: Number of active UDP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panZoneActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        type: gauge
+        help: Number of active Other IP connections per second for this zone. - 1.3.6.1.4.1.25461.2.1.2.3.10.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifIndex
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        type: gauge
+        help: Index of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        type: DisplayString
+        help: Description (name) of the interface - 1.3.6.1.4.1.25461.2.1.2.3.11.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveTcpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        type: gauge
+        help: Number of active TCP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveUdpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        type: gauge
+        help: Number of active UDP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panIfActiveOtherIpCps
+        oid: 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        type: gauge
+        help: Number of active Other IP connections per second for this interface. - 1.3.6.1.4.1.25461.2.1.2.3.11.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: panGPGWUtilizationPct
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.1
+        type: gauge
+        help: GlobalProtect Gateway utilization percentage - 1.3.6.1.4.1.25461.2.1.2.5.1.1
+      - name: panGPGWUtilizationMaxTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.2
+        type: gauge
+        help: Max tunnels allowed - 1.3.6.1.4.1.25461.2.1.2.5.1.2
+      - name: panGPGWUtilizationActiveTunnels
+        oid: 1.3.6.1.4.1.25461.2.1.2.5.1.3
+        type: gauge
+        help: Number of active tunnels - 1.3.6.1.4.1.25461.2.1.2.5.1.3
+    printer_mib:
+      walk:
+      - 1.3.6.1.2.1.25.3.5.1.1
+      - 1.3.6.1.2.1.43.11.1.1.5
+      - 1.3.6.1.2.1.43.11.1.1.6
+      - 1.3.6.1.2.1.43.11.1.1.8
+      - 1.3.6.1.2.1.43.11.1.1.9
+      - 1.3.6.1.2.1.43.5.1.1.13
+      - 1.3.6.1.2.1.43.5.1.1.16
+      - 1.3.6.1.2.1.43.5.1.1.17
+      - 1.3.6.1.2.1.43.5.1.1.18
+      - 1.3.6.1.2.1.43.5.1.1.19
+      - 1.3.6.1.2.1.43.5.1.1.3
+      - 1.3.6.1.2.1.43.6.1.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: hrPrinterStatus
+        oid: 1.3.6.1.2.1.25.3.5.1.1
+        type: EnumAsStateSet
+        help: The current status of this printer device. - 1.3.6.1.2.1.25.3.5.1.1
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: idle
+          4: printing
+          5: warmup
+      - name: prtMarkerSuppliesType
+        oid: 1.3.6.1.2.1.43.11.1.1.5
+        type: gauge
+        help: The type of this supply. - 1.3.6.1.2.1.43.11.1.1.5
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: toner
+          4: wasteToner
+          5: ink
+          6: inkCartridge
+          7: inkRibbon
+          8: wasteInk
+          9: opc
+          10: developer
+          11: fuserOil
+          12: solidWax
+          13: ribbonWax
+          14: wasteWax
+          15: fuser
+          16: coronaWire
+          17: fuserOilWick
+          18: cleanerUnit
+          19: fuserCleaningPad
+          20: transferUnit
+          21: tonerCartridge
+          22: fuserOiler
+          23: water
+          24: wasteWater
+          25: glueWaterAdditive
+          26: wastePaper
+          27: bindingSupply
+          28: bandingSupply
+          29: stitchingWire
+          30: shrinkWrap
+          31: paperWrap
+          32: staples
+          33: inserts
+          34: covers
+          35: matteToner
+          36: matteInk
+      - name: prtMarkerSuppliesDescription
+        oid: 1.3.6.1.2.1.43.11.1.1.6
+        type: DisplayString
+        help: The description of this supply container/receptacle in the localization
+          specified by prtGeneralCurrentLocalization. - 1.3.6.1.2.1.43.11.1.1.6
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesMaxCapacity
+        oid: 1.3.6.1.2.1.43.11.1.1.8
+        type: gauge
+        help: The maximum capacity of this supply container/receptacle expressed in prtMarkerSuppliesSupplyUnit
+          - 1.3.6.1.2.1.43.11.1.1.8
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtMarkerSuppliesLevel
+        oid: 1.3.6.1.2.1.43.11.1.1.9
+        type: gauge
+        help: The current level if this supply is a container; the remaining space if
+          this supply is a receptacle - 1.3.6.1.2.1.43.11.1.1.9
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtMarkerSuppliesIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrDeviceIndex
+          - prtMarkerSuppliesIndex
+          labelname: prtMarkerSuppliesType
+          oid: 1.3.6.1.2.1.43.11.1.1.5
+          type: gauge
+      - name: prtConsoleDisable
+        oid: 1.3.6.1.2.1.43.5.1.1.13
+        type: EnumAsStateSet
+        help: This value indicates how input is (or is not) accepted from the operator
+          console - 1.3.6.1.2.1.43.5.1.1.13
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: enabled
+          4: disabled
+      - name: prtGeneralPrinterName
+        oid: 1.3.6.1.2.1.43.5.1.1.16
+        type: DisplayString
+        help: An administrator-specified name for this printer - 1.3.6.1.2.1.43.5.1.1.16
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralSerialNumber
+        oid: 1.3.6.1.2.1.43.5.1.1.17
+        type: DisplayString
+        help: A recorded serial number for this device that indexes some type device catalog
+          or inventory - 1.3.6.1.2.1.43.5.1.1.17
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertCriticalEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.18
+        type: counter
+        help: A running counter of the number of critical alert events that have been
+          recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.18
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtAlertAllEvents
+        oid: 1.3.6.1.2.1.43.5.1.1.19
+        type: counter
+        help: A running counter of the total number of alert event entries (critical and
+          non-critical) that have been recorded in the alert table - 1.3.6.1.2.1.43.5.1.1.19
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+      - name: prtGeneralReset
+        oid: 1.3.6.1.2.1.43.5.1.1.3
+        type: EnumAsStateSet
+        help: Setting this value to 'powerCycleReset', 'resetToNVRAM', or 'resetToFactoryDefaults'
+          will result in the resetting of the printer - 1.3.6.1.2.1.43.5.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        enum_values:
+          3: notResetting
+          4: powerCycleReset
+          5: resetToNVRAM
+          6: resetToFactoryDefaults
+      - name: prtCoverStatus
+        oid: 1.3.6.1.2.1.43.6.1.1.3
+        type: EnumAsStateSet
+        help: The status of this cover sub-unit. - 1.3.6.1.2.1.43.6.1.1.3
+        indexes:
+        - labelname: hrDeviceIndex
+          type: gauge
+        - labelname: prtCoverIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: unknown
+          3: coverOpen
+          4: coverClosed
+          5: interlockOpen
+          6: interlockClosed
+    raritan:
+      walk:
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.2
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+      - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+      - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.13742.4.1.3.1.5.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: outletOperationalState
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        type: EnumAsStateSet
+        help: A value for each outlet which describes the operational state of the outlet
+          - 1.3.6.1.4.1.13742.4.1.2.2.1.3
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+        enum_values:
+          -1: error
+          0: "off"
+          1: "on"
+          2: cycling
+      - name: outletWattHours
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        type: gauge
+        help: The value of the cumulative active energy for this outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.31
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        type: gauge
+        help: A unique value for the current sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.4
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletMaxCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        type: gauge
+        help: A unique value for the max - 1.3.6.1.4.1.13742.4.1.2.2.1.5
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        type: gauge
+        help: A unique value for the voltage sensor attached to the outlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.2.2.1.6
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: outletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        type: gauge
+        help: A unique value for the active power sensor attached to the outlet - 1.3.6.1.4.1.13742.4.1.2.2.1.7
+        indexes:
+        - labelname: outletIndex
+          type: gauge
+        lookups:
+        - labels:
+          - outletIndex
+          labelname: outletLabel
+          oid: 1.3.6.1.4.1.13742.4.1.2.2.1.2
+          type: DisplayString
+      - name: inletCurrent
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        type: gauge
+        help: A unique value for the current sensor attached to the inlet - 1.3.6.1.4.1.13742.4.1.20.2.1.7
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletVoltage
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        type: gauge
+        help: A unique value for the voltage sensor attached to the intlet.This value
+          is reported in millivolts (1/1000th of a volt) - 1.3.6.1.4.1.13742.4.1.20.2.1.8
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: inletActivePower
+        oid: 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        type: gauge
+        help: The active power for the inlet This value is reported in Watts. - 1.3.6.1.4.1.13742.4.1.20.2.1.9
+        indexes:
+        - labelname: inletIndex
+          type: gauge
+      - name: unitCpuTemp
+        oid: 1.3.6.1.4.1.13742.4.1.3.1.5
+        type: gauge
+        help: The value for the unit's CPU temperature sensor in tenth degrees celsius.
+          - 1.3.6.1.4.1.13742.4.1.3.1.5
+      auth:
+        community: raritan_public
+    servertech_sentry3:
+      walk:
+      - 1.3.6.1.4.1.1718.3.2.2
+      - 1.3.6.1.4.1.1718.3.2.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: infeedIndex
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.1
+        type: gauge
+        help: Index for the input feed table. - 1.3.6.1.4.1.1718.3.2.2.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.2
+        type: DisplayString
+        help: The ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedName
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.3
+        type: DisplayString
+        help: The name of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.4
+        type: Bits
+        help: The capabilities of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: failSafe
+          4: defaultOff
+          5: voltageSense
+          6: powerSense
+          7: branchOnSense
+          8: branchLoadSense
+      - name: infeedStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.5
+        type: gauge
+        help: The status of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: infeedLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.6
+        type: gauge
+        help: The status of the load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: infeedLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.7
+        type: gauge
+        help: The load measured on the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.8
+        type: gauge
+        help: The load high threshold value of the input feed line in Amps. - 1.3.6.1.4.1.1718.3.2.2.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedOutletCount
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.9
+        type: gauge
+        help: The number of controlled and/or monitored outlets on the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.10
+        type: gauge
+        help: The load capacity of the input feed line - 1.3.6.1.4.1.1718.3.2.2.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.11
+        type: gauge
+        help: The line-to-line voltage of the input feed - 1.3.6.1.4.1.1718.3.2.2.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.12
+        type: gauge
+        help: The active power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.13
+        type: gauge
+        help: The apparent power consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.14
+        type: gauge
+        help: The power factor of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.15
+        type: gauge
+        help: The crest factor for the load of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.16
+        type: gauge
+        help: The energy consumption of the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedReactance
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.17
+        type: gauge
+        help: The characterization of the phase relation between the voltage and current
+          of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        enum_values:
+          0: unknown
+          1: capacitive
+          2: inductive
+          3: resistive
+      - name: infeedPhaseVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.18
+        type: gauge
+        help: The voltage measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseCurrent
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.19
+        type: gauge
+        help: The current measured for the input feed phase - 1.3.6.1.4.1.1718.3.2.2.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.21
+        type: DisplayString
+        help: The ID of the input feed line. - 1.3.6.1.4.1.1718.3.2.2.1.21
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedLineToLineID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.22
+        type: DisplayString
+        help: The line-to-line ID of the input feed. - 1.3.6.1.4.1.1718.3.2.2.1.22
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedPhaseID
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.23
+        type: DisplayString
+        help: The ID of the input feed phase. - 1.3.6.1.4.1.1718.3.2.2.1.23
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: infeedVACapacity
+        oid: 1.3.6.1.4.1.1718.3.2.2.1.24
+        type: gauge
+        help: The apparent power capacity of the input feed circuit - 1.3.6.1.4.1.1718.3.2.2.1.24
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+      - name: outletIndex
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.1
+        type: gauge
+        help: Index for the outlet table. - 1.3.6.1.4.1.1718.3.2.3.1.1
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletID
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.2
+        type: DisplayString
+        help: The ID of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.2
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletName
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.3
+        type: DisplayString
+        help: The name of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.3
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCapabilities
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.4
+        type: Bits
+        help: The capabilities of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.4
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: onSense
+          1: loadSense
+          2: powerControl
+          3: shutdown
+          4: defaultOn
+          5: ownInfeed
+          6: fusedBranch
+          7: voltageSense
+          8: powerSense
+      - name: outletStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.5
+        type: gauge
+        help: The status of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.5
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: "off"
+          1: "on"
+          2: offWait
+          3: onWait
+          4: offError
+          5: onError
+          6: noComm
+          7: reading
+          8: offFuse
+          9: onFuse
+      - name: outletLoadStatus
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.6
+        type: gauge
+        help: The status of the load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.6
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: normal
+          1: notOn
+          2: reading
+          3: loadLow
+          4: loadHigh
+          5: overLoad
+          6: readError
+          7: noComm
+      - name: outletLoadValue
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.7
+        type: gauge
+        help: The load measured on the outlet - 1.3.6.1.4.1.1718.3.2.3.1.7
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadLowThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.8
+        type: gauge
+        help: The load low threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.8
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletLoadHighThresh
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.9
+        type: gauge
+        help: The load high threshold value of the outlet in Amps. - 1.3.6.1.4.1.1718.3.2.3.1.9
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletControlState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.10
+        type: gauge
+        help: The control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.10
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: idleOff
+          1: idleOn
+          2: wakeOff
+          3: wakeOn
+          4: "off"
+          5: "on"
+          6: lockedOff
+          7: lockedOn
+          8: reboot
+          9: shutdown
+          10: pendOn
+          11: pendOff
+          12: minimumOff
+          13: minimumOn
+          14: eventOff
+          15: eventOn
+          16: eventReboot
+          17: eventShutdown
+      - name: outletControlAction
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.11
+        type: gauge
+        help: An action to change the control state of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.11
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          0: none
+          1: "on"
+          2: "off"
+          3: reboot
+      - name: outletCapacity
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.12
+        type: gauge
+        help: The load capacity of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.12
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletVoltage
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.13
+        type: gauge
+        help: The voltage of the outlet - 1.3.6.1.4.1.1718.3.2.3.1.13
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.14
+        type: gauge
+        help: The active power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.14
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletApparentPower
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.15
+        type: gauge
+        help: The apparent power consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.15
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletPowerFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.16
+        type: gauge
+        help: The power factor of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.16
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletCrestFactor
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.17
+        type: gauge
+        help: The crest factor for the load of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.17
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletEnergy
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.18
+        type: gauge
+        help: The energy consumption of the device plugged into the outlet - 1.3.6.1.4.1.1718.3.2.3.1.18
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+      - name: outletWakeupState
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.19
+        type: gauge
+        help: The wakeup state of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.19
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+        enum_values:
+          1: last
+          2: "off"
+          3: "on"
+      - name: outletPostOnDelay
+        oid: 1.3.6.1.4.1.1718.3.2.3.1.20
+        type: gauge
+        help: The post-on delay of the outlet. - 1.3.6.1.4.1.1718.3.2.3.1.20
+        indexes:
+        - labelname: towerIndex
+          type: gauge
+        - labelname: infeedIndex
+          type: gauge
+        - labelname: outletIndex
+          type: gauge
+    synology:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.25.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.2021.10.1.2
+      - 1.3.6.1.4.1.2021.10.1.5
+      - 1.3.6.1.4.1.2021.4
+      - 1.3.6.1.4.1.6574.1
+      - 1.3.6.1.4.1.6574.101
+      - 1.3.6.1.4.1.6574.102
+      - 1.3.6.1.4.1.6574.104
+      - 1.3.6.1.4.1.6574.2
+      - 1.3.6.1.4.1.6574.3
+      - 1.3.6.1.4.1.6574.4
+      - 1.3.6.1.4.1.6574.5
+      - 1.3.6.1.4.1.6574.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      - 1.3.6.1.4.1.2021.11.10.0
+      - 1.3.6.1.4.1.2021.11.11.0
+      - 1.3.6.1.4.1.2021.11.9.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: hrMemorySize
+        oid: 1.3.6.1.2.1.25.2.2
+        type: gauge
+        help: The amount of physical read-write main memory, typically RAM, contained
+          by the host. - 1.3.6.1.2.1.25.2.2
+      - name: hrStorageIndex
+        oid: 1.3.6.1.2.1.25.2.3.1.1
+        type: gauge
+        help: A unique value for each logical storage area contained by the host. - 1.3.6.1.2.1.25.2.3.1.1
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageType
+        oid: 1.3.6.1.2.1.25.2.3.1.2
+        type: OctetString
+        help: The type of storage represented by this entry. - 1.3.6.1.2.1.25.2.3.1.2
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageDescr
+        oid: 1.3.6.1.2.1.25.2.3.1.3
+        type: DisplayString
+        help: A description of the type and instance of the storage described by this
+          entry. - 1.3.6.1.2.1.25.2.3.1.3
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationUnits
+        oid: 1.3.6.1.2.1.25.2.3.1.4
+        type: gauge
+        help: The size, in bytes, of the data objects allocated from this pool - 1.3.6.1.2.1.25.2.3.1.4
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageSize
+        oid: 1.3.6.1.2.1.25.2.3.1.5
+        type: gauge
+        help: The size of the storage represented by this entry, in units of hrStorageAllocationUnits
+          - 1.3.6.1.2.1.25.2.3.1.5
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageUsed
+        oid: 1.3.6.1.2.1.25.2.3.1.6
+        type: gauge
+        help: The amount of the storage represented by this entry that is allocated, in
+          units of hrStorageAllocationUnits. - 1.3.6.1.2.1.25.2.3.1.6
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: hrStorageAllocationFailures
+        oid: 1.3.6.1.2.1.25.2.3.1.7
+        type: counter
+        help: The number of requests for storage represented by this entry that could
+          not be honored due to not enough storage - 1.3.6.1.2.1.25.2.3.1.7
+        indexes:
+        - labelname: hrStorageIndex
+          type: gauge
+        lookups:
+        - labels:
+          - hrStorageIndex
+          labelname: hrStorageDescr
+          oid: 1.3.6.1.2.1.25.2.3.1.3
+          type: DisplayString
+        - labels: []
+          labelname: hrStorageIndex
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        lookups:
+        - labels:
+          - ifIndex
+          labelname: ifName
+          oid: 1.3.6.1.2.1.31.1.1.1.1
+          type: DisplayString
+        - labels: []
+          labelname: ifIndex
+      - name: laNames
+        oid: 1.3.6.1.4.1.2021.10.1.2
+        type: DisplayString
+        help: The list of loadave names we're watching. - 1.3.6.1.4.1.2021.10.1.2
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: laLoadInt
+        oid: 1.3.6.1.4.1.2021.10.1.5
+        type: gauge
+        help: The 1,5 and 15 minute load averages as an integer - 1.3.6.1.4.1.2021.10.1.5
+        indexes:
+        - labelname: laIndex
+          type: gauge
+        lookups:
+        - labels:
+          - laIndex
+          labelname: laNames
+          oid: 1.3.6.1.4.1.2021.10.1.2
+          type: DisplayString
+        - labels: []
+          labelname: laIndex
+      - name: ssCpuSystem
+        oid: 1.3.6.1.4.1.2021.11.10
+        type: gauge
+        help: The percentage of CPU time spent processing system-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.10
+      - name: ssCpuIdle
+        oid: 1.3.6.1.4.1.2021.11.11
+        type: gauge
+        help: The percentage of processor time spent idle, calculated over the last minute
+          - 1.3.6.1.4.1.2021.11.11
+      - name: ssCpuUser
+        oid: 1.3.6.1.4.1.2021.11.9
+        type: gauge
+        help: The percentage of CPU time spent processing user-level code, calculated
+          over the last minute - 1.3.6.1.4.1.2021.11.9
+      - name: memIndex
+        oid: 1.3.6.1.4.1.2021.4.1
+        type: gauge
+        help: Bogus Index - 1.3.6.1.4.1.2021.4.1
+      - name: memErrorName
+        oid: 1.3.6.1.4.1.2021.4.2
+        type: DisplayString
+        help: Bogus Name - 1.3.6.1.4.1.2021.4.2
+      - name: memTotalSwap
+        oid: 1.3.6.1.4.1.2021.4.3
+        type: gauge
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.3
+      - name: memAvailSwap
+        oid: 1.3.6.1.4.1.2021.4.4
+        type: gauge
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.4
+      - name: memTotalReal
+        oid: 1.3.6.1.4.1.2021.4.5
+        type: gauge
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.5
+      - name: memAvailReal
+        oid: 1.3.6.1.4.1.2021.4.6
+        type: gauge
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.6
+      - name: memTotalSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.7
+        type: gauge
+        help: The total amount of swap space or virtual memory allocated for text pages
+          on this host - 1.3.6.1.4.1.2021.4.7
+      - name: memAvailSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.8
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.8
+      - name: memTotalRealTXT
+        oid: 1.3.6.1.4.1.2021.4.9
+        type: gauge
+        help: The total amount of real/physical memory allocated for text pages on this
+          host - 1.3.6.1.4.1.2021.4.9
+      - name: memAvailRealTXT
+        oid: 1.3.6.1.4.1.2021.4.10
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.10
+      - name: memTotalFree
+        oid: 1.3.6.1.4.1.2021.4.11
+        type: gauge
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.11
+      - name: memMinimumSwap
+        oid: 1.3.6.1.4.1.2021.4.12
+        type: gauge
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.12
+      - name: memShared
+        oid: 1.3.6.1.4.1.2021.4.13
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.13
+      - name: memBuffer
+        oid: 1.3.6.1.4.1.2021.4.14
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.14
+      - name: memCached
+        oid: 1.3.6.1.4.1.2021.4.15
+        type: gauge
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.15
+      - name: memUsedSwapTXT
+        oid: 1.3.6.1.4.1.2021.4.16
+        type: gauge
+        help: The amount of swap space or virtual memory currently being used by text
+          pages on this host - 1.3.6.1.4.1.2021.4.16
+      - name: memUsedRealTXT
+        oid: 1.3.6.1.4.1.2021.4.17
+        type: gauge
+        help: The amount of real/physical memory currently being used by text pages on
+          this host - 1.3.6.1.4.1.2021.4.17
+      - name: memTotalSwapX
+        oid: 1.3.6.1.4.1.2021.4.18
+        type: counter
+        help: The total amount of swap space configured for this host. - 1.3.6.1.4.1.2021.4.18
+      - name: memAvailSwapX
+        oid: 1.3.6.1.4.1.2021.4.19
+        type: counter
+        help: The amount of swap space currently unused or available. - 1.3.6.1.4.1.2021.4.19
+      - name: memTotalRealX
+        oid: 1.3.6.1.4.1.2021.4.20
+        type: counter
+        help: The total amount of real/physical memory installed on this host. - 1.3.6.1.4.1.2021.4.20
+      - name: memAvailRealX
+        oid: 1.3.6.1.4.1.2021.4.21
+        type: counter
+        help: The amount of real/physical memory currently unused or available. - 1.3.6.1.4.1.2021.4.21
+      - name: memTotalFreeX
+        oid: 1.3.6.1.4.1.2021.4.22
+        type: counter
+        help: The total amount of memory free or available for use on this host - 1.3.6.1.4.1.2021.4.22
+      - name: memMinimumSwapX
+        oid: 1.3.6.1.4.1.2021.4.23
+        type: counter
+        help: The minimum amount of swap space expected to be kept free or available during
+          normal operation of this host - 1.3.6.1.4.1.2021.4.23
+      - name: memSharedX
+        oid: 1.3.6.1.4.1.2021.4.24
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          shared memory - 1.3.6.1.4.1.2021.4.24
+      - name: memBufferX
+        oid: 1.3.6.1.4.1.2021.4.25
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          memory buffers - 1.3.6.1.4.1.2021.4.25
+      - name: memCachedX
+        oid: 1.3.6.1.4.1.2021.4.26
+        type: counter
+        help: The total amount of real or virtual memory currently allocated for use as
+          cached memory - 1.3.6.1.4.1.2021.4.26
+      - name: memSwapError
+        oid: 1.3.6.1.4.1.2021.4.100
+        type: gauge
+        help: Indicates whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.100
+        enum_values:
+          0: noError
+          1: error
+      - name: memSwapErrorMsg
+        oid: 1.3.6.1.4.1.2021.4.101
+        type: DisplayString
+        help: Describes whether the amount of available swap space (as reported by 'memAvailSwap(4)'),
+          is less than the desired minimum (specified by 'memMinimumSwap(12)'). - 1.3.6.1.4.1.2021.4.101
+      - name: systemStatus
+        oid: 1.3.6.1.4.1.6574.1.1
+        type: gauge
+        help: Synology system status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.1
+      - name: temperature
+        oid: 1.3.6.1.4.1.6574.1.2
+        type: gauge
+        help: Synology system temperature The temperature of Disk Station uses Celsius
+          degree. - 1.3.6.1.4.1.6574.1.2
+      - name: powerStatus
+        oid: 1.3.6.1.4.1.6574.1.3
+        type: gauge
+        help: Synology power status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.3
+      - name: systemFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.1
+        type: gauge
+        help: Synology system fan status Each meanings of status represented describe
+          below - 1.3.6.1.4.1.6574.1.4.1
+      - name: cpuFanStatus
+        oid: 1.3.6.1.4.1.6574.1.4.2
+        type: gauge
+        help: Synology cpu fan status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.1.4.2
+      - name: modelName
+        oid: 1.3.6.1.4.1.6574.1.5.1
+        type: OctetString
+        help: The Model name of this NAS - 1.3.6.1.4.1.6574.1.5.1
+      - name: serialNumber
+        oid: 1.3.6.1.4.1.6574.1.5.2
+        type: OctetString
+        help: The serial number of this NAS - 1.3.6.1.4.1.6574.1.5.2
+      - name: version
+        oid: 1.3.6.1.4.1.6574.1.5.3
+        type: OctetString
+        help: The version of this DSM - 1.3.6.1.4.1.6574.1.5.3
+      - name: upgradeAvailable
+        oid: 1.3.6.1.4.1.6574.1.5.4
+        type: gauge
+        help: This oid is for checking whether there is a latest DSM can be upgraded -
+          1.3.6.1.4.1.6574.1.5.4
+      - name: storageIOIndex
+        oid: 1.3.6.1.4.1.6574.101.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.101.1.1.1
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIODevice
+        oid: 1.3.6.1.4.1.6574.101.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.101.1.1.2
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONRead
+        oid: 1.3.6.1.4.1.6574.101.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.3
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWritten
+        oid: 1.3.6.1.4.1.6574.101.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.4
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOReads
+        oid: 1.3.6.1.4.1.6574.101.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.5
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOWrites
+        oid: 1.3.6.1.4.1.6574.101.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.6
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA
+        oid: 1.3.6.1.4.1.6574.101.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.8
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA1
+        oid: 1.3.6.1.4.1.6574.101.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.9
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA5
+        oid: 1.3.6.1.4.1.6574.101.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.10
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIOLA15
+        oid: 1.3.6.1.4.1.6574.101.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.101.1.1.11
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONReadX
+        oid: 1.3.6.1.4.1.6574.101.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.101.1.1.12
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: storageIONWrittenX
+        oid: 1.3.6.1.4.1.6574.101.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.101.1.1.13
+        indexes:
+        - labelname: storageIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - storageIOIndex
+          labelname: storageIODevice
+          oid: 1.3.6.1.4.1.6574.101.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: storageIOIndex
+      - name: spaceIOIndex
+        oid: 1.3.6.1.4.1.6574.102.1.1.1
+        type: gauge
+        help: Reference index for each observed device. - 1.3.6.1.4.1.6574.102.1.1.1
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIODevice
+        oid: 1.3.6.1.4.1.6574.102.1.1.2
+        type: DisplayString
+        help: The name of the device we are counting/checking. - 1.3.6.1.4.1.6574.102.1.1.2
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONRead
+        oid: 1.3.6.1.4.1.6574.102.1.1.3
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.3
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWritten
+        oid: 1.3.6.1.4.1.6574.102.1.1.4
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.4
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOReads
+        oid: 1.3.6.1.4.1.6574.102.1.1.5
+        type: counter
+        help: The number of read accesses from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.5
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOWrites
+        oid: 1.3.6.1.4.1.6574.102.1.1.6
+        type: counter
+        help: The number of write accesses to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.6
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA
+        oid: 1.3.6.1.4.1.6574.102.1.1.8
+        type: gauge
+        help: The load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.8
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA1
+        oid: 1.3.6.1.4.1.6574.102.1.1.9
+        type: gauge
+        help: The 1 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.9
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA5
+        oid: 1.3.6.1.4.1.6574.102.1.1.10
+        type: gauge
+        help: The 5 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.10
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIOLA15
+        oid: 1.3.6.1.4.1.6574.102.1.1.11
+        type: gauge
+        help: The 15 minute average load of disk (%) - 1.3.6.1.4.1.6574.102.1.1.11
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONReadX
+        oid: 1.3.6.1.4.1.6574.102.1.1.12
+        type: counter
+        help: The number of bytes read from this device since boot. - 1.3.6.1.4.1.6574.102.1.1.12
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: spaceIONWrittenX
+        oid: 1.3.6.1.4.1.6574.102.1.1.13
+        type: counter
+        help: The number of bytes written to this device since boot. - 1.3.6.1.4.1.6574.102.1.1.13
+        indexes:
+        - labelname: spaceIOIndex
+          type: gauge
+        lookups:
+        - labels:
+          - spaceIOIndex
+          labelname: spaceIODevice
+          oid: 1.3.6.1.4.1.6574.102.1.1.2
+          type: DisplayString
+        - labels: []
+          labelname: spaceIOIndex
+      - name: iSCSILUNInfoIndex
+        oid: 1.3.6.1.4.1.6574.104.1.1.1
+        type: gauge
+        help: LUN info index - 1.3.6.1.4.1.6574.104.1.1.1
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNUUID
+        oid: 1.3.6.1.4.1.6574.104.1.1.2
+        type: OctetString
+        help: LUN uuid - 1.3.6.1.4.1.6574.104.1.1.2
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNName
+        oid: 1.3.6.1.4.1.6574.104.1.1.3
+        type: OctetString
+        help: LUN name - 1.3.6.1.4.1.6574.104.1.1.3
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.4
+        type: gauge
+        help: LUN read throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.4
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputReadLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.5
+        type: gauge
+        help: LUN read throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.5
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteHigh
+        oid: 1.3.6.1.4.1.6574.104.1.1.6
+        type: gauge
+        help: LUN write throughput over 32 bits part - 1.3.6.1.4.1.6574.104.1.1.6
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNThroughputWriteLow
+        oid: 1.3.6.1.4.1.6574.104.1.1.7
+        type: gauge
+        help: LUN write throughput in unsigned 32 bit - 1.3.6.1.4.1.6574.104.1.1.7
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.8
+        type: gauge
+        help: LUN read iops - 1.3.6.1.4.1.6574.104.1.1.8
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIopsWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.9
+        type: gauge
+        help: LUN write iops - 1.3.6.1.4.1.6574.104.1.1.9
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.10
+        type: gauge
+        help: LUN disk latency when reading - 1.3.6.1.4.1.6574.104.1.1.10
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNDiskLatencyWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.11
+        type: gauge
+        help: LUN disk latency when writing - 1.3.6.1.4.1.6574.104.1.1.11
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyTx
+        oid: 1.3.6.1.4.1.6574.104.1.1.12
+        type: gauge
+        help: LUN transfer data network latency - 1.3.6.1.4.1.6574.104.1.1.12
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNNetworkLatencyRx
+        oid: 1.3.6.1.4.1.6574.104.1.1.13
+        type: gauge
+        help: LUN receive data network latency - 1.3.6.1.4.1.6574.104.1.1.13
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeRead
+        oid: 1.3.6.1.4.1.6574.104.1.1.14
+        type: gauge
+        help: LUN average io size when reading - 1.3.6.1.4.1.6574.104.1.1.14
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNIoSizeWrite
+        oid: 1.3.6.1.4.1.6574.104.1.1.15
+        type: gauge
+        help: LUN average io size when writing - 1.3.6.1.4.1.6574.104.1.1.15
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNQueueDepth
+        oid: 1.3.6.1.4.1.6574.104.1.1.16
+        type: gauge
+        help: Num of iSCSI commands in LUN queue - 1.3.6.1.4.1.6574.104.1.1.16
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: iSCSILUNType
+        oid: 1.3.6.1.4.1.6574.104.1.1.17
+        type: OctetString
+        help: LUN type - 1.3.6.1.4.1.6574.104.1.1.17
+        indexes:
+        - labelname: iSCSILUNInfoIndex
+          type: gauge
+      - name: diskIndex
+        oid: 1.3.6.1.4.1.6574.2.1.1.1
+        type: gauge
+        help: The index of disk table - 1.3.6.1.4.1.6574.2.1.1.1
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskID
+        oid: 1.3.6.1.4.1.6574.2.1.1.2
+        type: OctetString
+        help: Synology disk ID The ID of disk is assigned by disk Station. - 1.3.6.1.4.1.6574.2.1.1.2
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskModel
+        oid: 1.3.6.1.4.1.6574.2.1.1.3
+        type: OctetString
+        help: Synology disk model name The disk model name will be showed here. - 1.3.6.1.4.1.6574.2.1.1.3
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskType
+        oid: 1.3.6.1.4.1.6574.2.1.1.4
+        type: OctetString
+        help: Synology disk type The type of disk will be showed here, including SATA,
+          SSD and so on. - 1.3.6.1.4.1.6574.2.1.1.4
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskStatus
+        oid: 1.3.6.1.4.1.6574.2.1.1.5
+        type: gauge
+        help: Synology disk status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.2.1.1.5
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: diskTemperature
+        oid: 1.3.6.1.4.1.6574.2.1.1.6
+        type: gauge
+        help: Synology disk temperature The temperature of each disk uses Celsius degree.
+          - 1.3.6.1.4.1.6574.2.1.1.6
+        indexes:
+        - labelname: diskIndex
+          type: gauge
+        lookups:
+        - labels:
+          - diskIndex
+          labelname: diskID
+          oid: 1.3.6.1.4.1.6574.2.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: diskIndex
+      - name: raidIndex
+        oid: 1.3.6.1.4.1.6574.3.1.1.1
+        type: gauge
+        help: The index of raid table - 1.3.6.1.4.1.6574.3.1.1.1
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidName
+        oid: 1.3.6.1.4.1.6574.3.1.1.2
+        type: OctetString
+        help: Synology raid name The name of each raid will be showed here. - 1.3.6.1.4.1.6574.3.1.1.2
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidStatus
+        oid: 1.3.6.1.4.1.6574.3.1.1.3
+        type: gauge
+        help: Synology Raid status Each meanings of status represented describe below
+          - 1.3.6.1.4.1.6574.3.1.1.3
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidFreeSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.4
+        type: counter
+        help: Synology raid freesize Free space in bytes. - 1.3.6.1.4.1.6574.3.1.1.4
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: raidTotalSize
+        oid: 1.3.6.1.4.1.6574.3.1.1.5
+        type: counter
+        help: Synology raid totalsize Total space in bytes. - 1.3.6.1.4.1.6574.3.1.1.5
+        indexes:
+        - labelname: raidIndex
+          type: gauge
+        lookups:
+        - labels:
+          - raidIndex
+          labelname: raidName
+          oid: 1.3.6.1.4.1.6574.3.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: raidIndex
+      - name: upsDeviceModel
+        oid: 1.3.6.1.4.1.6574.4.1.1
+        type: DisplayString
+        help: Device model - 1.3.6.1.4.1.6574.4.1.1
+      - name: upsDeviceManufacturer
+        oid: 1.3.6.1.4.1.6574.4.1.2
+        type: DisplayString
+        help: Device manufacturer - 1.3.6.1.4.1.6574.4.1.2
+      - name: upsDeviceSerial
+        oid: 1.3.6.1.4.1.6574.4.1.3
+        type: DisplayString
+        help: Device serial number. - 1.3.6.1.4.1.6574.4.1.3
+      - name: upsDeviceType
+        oid: 1.3.6.1.4.1.6574.4.1.4
+        type: DisplayString
+        help: Device type (ups, pdu, scd, psu) - 1.3.6.1.4.1.6574.4.1.4
+      - name: upsDeviceDescription
+        oid: 1.3.6.1.4.1.6574.4.1.5
+        type: DisplayString
+        help: Device description. - 1.3.6.1.4.1.6574.4.1.5
+      - name: upsDeviceContact
+        oid: 1.3.6.1.4.1.6574.4.1.6
+        type: DisplayString
+        help: Device administrator name. - 1.3.6.1.4.1.6574.4.1.6
+      - name: upsDeviceLocation
+        oid: 1.3.6.1.4.1.6574.4.1.7
+        type: DisplayString
+        help: Device physical location. - 1.3.6.1.4.1.6574.4.1.7
+      - name: upsDevicePart
+        oid: 1.3.6.1.4.1.6574.4.1.8
+        type: DisplayString
+        help: Device part number. - 1.3.6.1.4.1.6574.4.1.8
+      - name: upsDeviceMACAddr
+        oid: 1.3.6.1.4.1.6574.4.1.9
+        type: DisplayString
+        help: Physical network address of the device. - 1.3.6.1.4.1.6574.4.1.9
+      - name: upsInfoStatus
+        oid: 1.3.6.1.4.1.6574.4.2.1
+        type: DisplayString
+        help: UPS status. - 1.3.6.1.4.1.6574.4.2.1
+      - name: upsInfoAlarm
+        oid: 1.3.6.1.4.1.6574.4.2.2
+        type: DisplayString
+        help: UPS alarms - 1.3.6.1.4.1.6574.4.2.2
+      - name: upsInfoTime
+        oid: 1.3.6.1.4.1.6574.4.2.3
+        type: DisplayString
+        help: Internal UPS clock time - 1.3.6.1.4.1.6574.4.2.3
+      - name: upsInfoDate
+        oid: 1.3.6.1.4.1.6574.4.2.4
+        type: DisplayString
+        help: Internal UPS clock date - 1.3.6.1.4.1.6574.4.2.4
+      - name: upsInfoModel
+        oid: 1.3.6.1.4.1.6574.4.2.5
+        type: DisplayString
+        help: UPS model - 1.3.6.1.4.1.6574.4.2.5
+      - name: upsInfoMfrName
+        oid: 1.3.6.1.4.1.6574.4.2.6.1
+        type: DisplayString
+        help: UPS manufacturer - 1.3.6.1.4.1.6574.4.2.6.1
+      - name: upsInfoMfrDate
+        oid: 1.3.6.1.4.1.6574.4.2.6.2
+        type: DisplayString
+        help: UPS manufacturing date - 1.3.6.1.4.1.6574.4.2.6.2
+      - name: upsInfoSerial
+        oid: 1.3.6.1.4.1.6574.4.2.7
+        type: DisplayString
+        help: UPS serial number - 1.3.6.1.4.1.6574.4.2.7
+      - name: upsInfoVendorID
+        oid: 1.3.6.1.4.1.6574.4.2.8
+        type: DisplayString
+        help: Vendor ID for USB devices - 1.3.6.1.4.1.6574.4.2.8
+      - name: upsInfoProductID
+        oid: 1.3.6.1.4.1.6574.4.2.9
+        type: DisplayString
+        help: Product ID for USB devices - 1.3.6.1.4.1.6574.4.2.9
+      - name: upsInfoFirmwareName
+        oid: 1.3.6.1.4.1.6574.4.2.10.1
+        type: DisplayString
+        help: UPS firmware - 1.3.6.1.4.1.6574.4.2.10.1
+      - name: upsInfoFirmwareAux
+        oid: 1.3.6.1.4.1.6574.4.2.10.2
+        type: DisplayString
+        help: Auxiliary device firmware - 1.3.6.1.4.1.6574.4.2.10.2
+      - name: upsInfoTemperature
+        oid: 1.3.6.1.4.1.6574.4.2.11
+        type: Float
+        help: UPS temperature (degrees C) - 1.3.6.1.4.1.6574.4.2.11
+      - name: upsInfoLoadValue
+        oid: 1.3.6.1.4.1.6574.4.2.12.1
+        type: Float
+        help: Load on UPS (percent) - 1.3.6.1.4.1.6574.4.2.12.1
+      - name: upsInfoLoadHigh
+        oid: 1.3.6.1.4.1.6574.4.2.12.2
+        type: Float
+        help: Load when UPS switches to overload condition (OVER) (percent) - 1.3.6.1.4.1.6574.4.2.12.2
+      - name: upsInfoID
+        oid: 1.3.6.1.4.1.6574.4.2.13
+        type: DisplayString
+        help: UPS system identifier - 1.3.6.1.4.1.6574.4.2.13
+      - name: upsInfoDelayStart
+        oid: 1.3.6.1.4.1.6574.4.2.14.1
+        type: gauge
+        help: Interval to wait before restarting the load (seconds) - 1.3.6.1.4.1.6574.4.2.14.1
+      - name: upsInfoDelayReboot
+        oid: 1.3.6.1.4.1.6574.4.2.14.2
+        type: gauge
+        help: Interval to wait before rebooting the UPS (seconds) - 1.3.6.1.4.1.6574.4.2.14.2
+      - name: upsInfoDelayShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.14.3
+        type: gauge
+        help: Interval to wait after shutdown with delay command (seconds) - 1.3.6.1.4.1.6574.4.2.14.3
+      - name: upsInfoTimerStart
+        oid: 1.3.6.1.4.1.6574.4.2.15.1
+        type: gauge
+        help: Time before the load will be started (seconds) - 1.3.6.1.4.1.6574.4.2.15.1
+      - name: upsInfoTimerReboot
+        oid: 1.3.6.1.4.1.6574.4.2.15.2
+        type: gauge
+        help: Time before the load will be rebooted (seconds) - 1.3.6.1.4.1.6574.4.2.15.2
+      - name: upsInfoTimerShutdown
+        oid: 1.3.6.1.4.1.6574.4.2.15.3
+        type: gauge
+        help: Time before the load will be shutdown (seconds) - 1.3.6.1.4.1.6574.4.2.15.3
+      - name: upsInfoTestInterval
+        oid: 1.3.6.1.4.1.6574.4.2.16.1
+        type: gauge
+        help: Interval between self tests - 1.3.6.1.4.1.6574.4.2.16.1
+      - name: upsInfoTestResult
+        oid: 1.3.6.1.4.1.6574.4.2.16.2
+        type: DisplayString
+        help: Results of last self test - 1.3.6.1.4.1.6574.4.2.16.2
+      - name: upsInfoDisplayLanguage
+        oid: 1.3.6.1.4.1.6574.4.2.17
+        type: DisplayString
+        help: Language to use on front panel - 1.3.6.1.4.1.6574.4.2.17
+      - name: upsInfoContacts
+        oid: 1.3.6.1.4.1.6574.4.2.18
+        type: DisplayString
+        help: UPS external contact sensors - 1.3.6.1.4.1.6574.4.2.18
+      - name: upsInfoEffciency
+        oid: 1.3.6.1.4.1.6574.4.2.19
+        type: gauge
+        help: Efficiency of the UPS (ratio of the output current on the input current)
+          (percent) - 1.3.6.1.4.1.6574.4.2.19
+      - name: upsInfoPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.20.1
+        type: Float
+        help: Current value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.1
+      - name: upsInfoPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.20.2
+        type: Float
+        help: Nominal value of apparent power (Volt-Amps) - 1.3.6.1.4.1.6574.4.2.20.2
+      - name: upsInfoRealPowerValue
+        oid: 1.3.6.1.4.1.6574.4.2.21.1
+        type: Float
+        help: Current value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.1
+      - name: upsInfoRealPowerNominal
+        oid: 1.3.6.1.4.1.6574.4.2.21.2
+        type: Float
+        help: Nominal value of real power (Watts) - 1.3.6.1.4.1.6574.4.2.21.2
+      - name: upsInfoBeeperStatus
+        oid: 1.3.6.1.4.1.6574.4.2.22
+        type: DisplayString
+        help: UPS beeper status (enabled, disabled or muted) - 1.3.6.1.4.1.6574.4.2.22
+      - name: upsInfoType
+        oid: 1.3.6.1.4.1.6574.4.2.23
+        type: DisplayString
+        help: UPS type - 1.3.6.1.4.1.6574.4.2.23
+      - name: upsInfoWatchdogStatus
+        oid: 1.3.6.1.4.1.6574.4.2.24
+        type: DisplayString
+        help: UPS watchdog status (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.24
+      - name: upsInfoStartAuto
+        oid: 1.3.6.1.4.1.6574.4.2.25.1
+        type: DisplayString
+        help: UPS starts when mains is (re)applied - 1.3.6.1.4.1.6574.4.2.25.1
+      - name: upsInfoStartBattery
+        oid: 1.3.6.1.4.1.6574.4.2.25.2
+        type: DisplayString
+        help: Allow to start UPS from battery - 1.3.6.1.4.1.6574.4.2.25.2
+      - name: upsInfoStartReboot
+        oid: 1.3.6.1.4.1.6574.4.2.25.3
+        type: DisplayString
+        help: UPS coldstarts from battery (enabled or disabled) - 1.3.6.1.4.1.6574.4.2.25.3
+      - name: upsBatteryChargeValue
+        oid: 1.3.6.1.4.1.6574.4.3.1.1
+        type: Float
+        help: Battery charge - 1.3.6.1.4.1.6574.4.3.1.1
+      - name: upsBatteryChargeLow
+        oid: 1.3.6.1.4.1.6574.4.3.1.2
+        type: Float
+        help: Remaining battery level when UPS switches to LB (percent) - 1.3.6.1.4.1.6574.4.3.1.2
+      - name: upsBatteryChargeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.1.3
+        type: Float
+        help: Minimum battery level for UPS restart after power-off - 1.3.6.1.4.1.6574.4.3.1.3
+      - name: upsBatteryChargeWarning
+        oid: 1.3.6.1.4.1.6574.4.3.1.4
+        type: Float
+        help: Battery level when UPS switches to Warning state (percent) - 1.3.6.1.4.1.6574.4.3.1.4
+      - name: upsBatteryVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.3.2.1
+        type: Float
+        help: The magnitude of the present battery voltage. - 1.3.6.1.4.1.6574.4.3.2.1
+      - name: upsBatteryVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.3.2.2
+        type: Float
+        help: Nominal battery voltage. - 1.3.6.1.4.1.6574.4.3.2.2
+      - name: upsBatteryVoltageLow
+        oid: 1.3.6.1.4.1.6574.4.3.2.3
+        type: Float
+        help: Minimum battery voltage, that triggers FSD status . - 1.3.6.1.4.1.6574.4.3.2.3
+      - name: upsBatteryVoltageHigh
+        oid: 1.3.6.1.4.1.6574.4.3.2.4
+        type: Float
+        help: Maximum battery voltage (Ie battery.charge = 100). - 1.3.6.1.4.1.6574.4.3.2.4
+      - name: upsBatteryCapacity
+        oid: 1.3.6.1.4.1.6574.4.3.3
+        type: Float
+        help: Battery capacity (Ah) - 1.3.6.1.4.1.6574.4.3.3
+      - name: upsBatteryCurrent
+        oid: 1.3.6.1.4.1.6574.4.3.4
+        type: Float
+        help: The present battery current. - 1.3.6.1.4.1.6574.4.3.4
+      - name: upsBatteryTemperature
+        oid: 1.3.6.1.4.1.6574.4.3.5
+        type: Float
+        help: The ambient temperature at or near the UPS Battery casing. - 1.3.6.1.4.1.6574.4.3.5
+      - name: upsBatteryRuntimeValue
+        oid: 1.3.6.1.4.1.6574.4.3.6.1
+        type: gauge
+        help: Battery runtime (seconds) - 1.3.6.1.4.1.6574.4.3.6.1
+      - name: upsBatteryRuntimeLow
+        oid: 1.3.6.1.4.1.6574.4.3.6.2
+        type: gauge
+        help: Remaining battery runtime when UPS switches to LB (seconds) - 1.3.6.1.4.1.6574.4.3.6.2
+      - name: upsBatteryRuntimeRestart
+        oid: 1.3.6.1.4.1.6574.4.3.6.3
+        type: gauge
+        help: Minimum battery runtime for UPS restart after power-off (seconds) - 1.3.6.1.4.1.6574.4.3.6.3
+      - name: upsBatteryAlarmThreshold
+        oid: 1.3.6.1.4.1.6574.4.3.7
+        type: DisplayString
+        help: Battery alarm threshold - 1.3.6.1.4.1.6574.4.3.7
+      - name: upsBatteryDate
+        oid: 1.3.6.1.4.1.6574.4.3.8
+        type: DisplayString
+        help: Battery change date - 1.3.6.1.4.1.6574.4.3.8
+      - name: upsBatteryMfrDate
+        oid: 1.3.6.1.4.1.6574.4.3.9
+        type: DisplayString
+        help: Battery manufacturing date - 1.3.6.1.4.1.6574.4.3.9
+      - name: upsBatteryPacks
+        oid: 1.3.6.1.4.1.6574.4.3.10
+        type: gauge
+        help: Number of battery packs - 1.3.6.1.4.1.6574.4.3.10
+      - name: upsBatteryPacksBad
+        oid: 1.3.6.1.4.1.6574.4.3.11
+        type: gauge
+        help: Number of bad battery packs - 1.3.6.1.4.1.6574.4.3.11
+      - name: upsBatteryType
+        oid: 1.3.6.1.4.1.6574.4.3.12
+        type: DisplayString
+        help: Battery chemistry - 1.3.6.1.4.1.6574.4.3.12
+      - name: upsBatteryProtection
+        oid: 1.3.6.1.4.1.6574.4.3.13
+        type: DisplayString
+        help: Prevent deep discharge of battery - 1.3.6.1.4.1.6574.4.3.13
+      - name: upsBatteryEnergySave
+        oid: 1.3.6.1.4.1.6574.4.3.14
+        type: DisplayString
+        help: Switch off when running on battery and no/low load - 1.3.6.1.4.1.6574.4.3.14
+      - name: upsInputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.4.1.1
+        type: Float
+        help: Input voltage - 1.3.6.1.4.1.6574.4.4.1.1
+      - name: upsInputVoltageMax
+        oid: 1.3.6.1.4.1.6574.4.4.1.2
+        type: Float
+        help: Maximum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.2
+      - name: upsInputVoltageMin
+        oid: 1.3.6.1.4.1.6574.4.4.1.3
+        type: Float
+        help: Minimum incoming voltage seen - 1.3.6.1.4.1.6574.4.4.1.3
+      - name: upsInputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.4.1.4
+        type: Float
+        help: Nominal input voltage - 1.3.6.1.4.1.6574.4.4.1.4
+      - name: upsInputVoltageExtend
+        oid: 1.3.6.1.4.1.6574.4.4.1.5
+        type: DisplayString
+        help: Extended input voltage range - 1.3.6.1.4.1.6574.4.4.1.5
+      - name: upsInputVoltageFault
+        oid: 1.3.6.1.4.1.6574.4.4.1.6
+        type: Float
+        help: Input voltage Fault - 1.3.6.1.4.1.6574.4.4.1.6
+      - name: upsInputTransferReason
+        oid: 1.3.6.1.4.1.6574.4.4.2.1
+        type: DisplayString
+        help: Reason for last transfer to battery - 1.3.6.1.4.1.6574.4.4.2.1
+      - name: upsInputTransferLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.2
+        type: Float
+        help: Low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.2
+      - name: upsInputTransferHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.3
+        type: Float
+        help: High voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.3
+      - name: upsInputTransferLowMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.4
+        type: Float
+        help: smallest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.4
+      - name: upsInputTransferLowMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.5
+        type: Float
+        help: greatest settable low voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.5
+      - name: upsInputTransferHighMin
+        oid: 1.3.6.1.4.1.6574.4.4.2.6
+        type: Float
+        help: smallest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.6
+      - name: upsInputTransferHighMax
+        oid: 1.3.6.1.4.1.6574.4.4.2.7
+        type: Float
+        help: greatest settable high voltage transfer point - 1.3.6.1.4.1.6574.4.4.2.7
+      - name: upsInputTransferBoostLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.8
+        type: Float
+        help: Low voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.8
+      - name: upsInputTransferBoostHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.9
+        type: Float
+        help: High voltage boosting transfer point - 1.3.6.1.4.1.6574.4.4.2.9
+      - name: upsInputTransferTrimLow
+        oid: 1.3.6.1.4.1.6574.4.4.2.10
+        type: Float
+        help: Low voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.10
+      - name: upsInputTransferTrimHigh
+        oid: 1.3.6.1.4.1.6574.4.4.2.11
+        type: Float
+        help: High voltage trimming transfer point - 1.3.6.1.4.1.6574.4.4.2.11
+      - name: upsInputSensitivity
+        oid: 1.3.6.1.4.1.6574.4.4.3
+        type: DisplayString
+        help: Input power sensitivity - 1.3.6.1.4.1.6574.4.4.3
+      - name: upsInputQuality
+        oid: 1.3.6.1.4.1.6574.4.4.4
+        type: DisplayString
+        help: Input power quality - 1.3.6.1.4.1.6574.4.4.4
+      - name: upsInputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.4.5.1
+        type: Float
+        help: Input current (A) - 1.3.6.1.4.1.6574.4.4.5.1
+      - name: upsInputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.4.5.2
+        type: Float
+        help: Nominal input current (A) - 1.3.6.1.4.1.6574.4.4.5.2
+      - name: upsInputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.4.6.1
+        type: Float
+        help: Input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.1
+      - name: upsInputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.4.6.2
+        type: Float
+        help: Nominal input line frequency (Hz) - 1.3.6.1.4.1.6574.4.4.6.2
+      - name: upsInputFrequencyLow
+        oid: 1.3.6.1.4.1.6574.4.4.6.3
+        type: Float
+        help: Input line frequency low (Hz) - 1.3.6.1.4.1.6574.4.4.6.3
+      - name: upsInputFrequencyHigh
+        oid: 1.3.6.1.4.1.6574.4.4.6.4
+        type: Float
+        help: Input line frequency high (Hz) - 1.3.6.1.4.1.6574.4.4.6.4
+      - name: upsInputFrequencyExtend
+        oid: 1.3.6.1.4.1.6574.4.4.6.5
+        type: DisplayString
+        help: Extended input frequency range - 1.3.6.1.4.1.6574.4.4.6.5
+      - name: upsOutputVoltageValue
+        oid: 1.3.6.1.4.1.6574.4.5.1.1
+        type: Float
+        help: Output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.1
+      - name: upsOutputVoltageNominal
+        oid: 1.3.6.1.4.1.6574.4.5.1.2
+        type: Float
+        help: Nominal output voltage (V) - 1.3.6.1.4.1.6574.4.5.1.2
+      - name: upsOutputFrequencyValue
+        oid: 1.3.6.1.4.1.6574.4.5.2.1
+        type: Float
+        help: Output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.1
+      - name: upsOutputFrequencyNominal
+        oid: 1.3.6.1.4.1.6574.4.5.2.2
+        type: Float
+        help: Nominal output frequency (Hz) - 1.3.6.1.4.1.6574.4.5.2.2
+      - name: upsOutputCurrentValue
+        oid: 1.3.6.1.4.1.6574.4.5.3.1
+        type: Float
+        help: Output current (A) - 1.3.6.1.4.1.6574.4.5.3.1
+      - name: upsOutputCurrentNominal
+        oid: 1.3.6.1.4.1.6574.4.5.3.2
+        type: Float
+        help: Nominal output current (A) - 1.3.6.1.4.1.6574.4.5.3.2
+      - name: upsAmbientTemperatureValue
+        oid: 1.3.6.1.4.1.6574.4.6.1.1
+        type: Float
+        help: Ambient temperature (degrees C) - 1.3.6.1.4.1.6574.4.6.1.1
+      - name: upsAmbientTemperatureAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.1.2
+        type: DisplayString
+        help: Temperature alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.1.2
+      - name: upsAmbientTemperatureHigh
+        oid: 1.3.6.1.4.1.6574.4.6.1.3
+        type: Float
+        help: Temperature threshold high (degrees C) - 1.3.6.1.4.1.6574.4.6.1.3
+      - name: upsAmbientTemperatureLow
+        oid: 1.3.6.1.4.1.6574.4.6.1.4
+        type: Float
+        help: Temperature threshold low (degrees C) - 1.3.6.1.4.1.6574.4.6.1.4
+      - name: upsAmbientTemperatureMax
+        oid: 1.3.6.1.4.1.6574.4.6.1.5
+        type: Float
+        help: Maximum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.5
+      - name: upsAmbientTemperatureMin
+        oid: 1.3.6.1.4.1.6574.4.6.1.6
+        type: Float
+        help: Minimum temperature seen (degrees C) - 1.3.6.1.4.1.6574.4.6.1.6
+      - name: upsAmbientHumidityValue
+        oid: 1.3.6.1.4.1.6574.4.6.2.1
+        type: Float
+        help: Ambient relative humidity (percent) - 1.3.6.1.4.1.6574.4.6.2.1
+      - name: upsAmbientHumidityAlarm
+        oid: 1.3.6.1.4.1.6574.4.6.2.2
+        type: DisplayString
+        help: Relative humidity alarm (enabled/disabled) - 1.3.6.1.4.1.6574.4.6.2.2
+      - name: upsAmbientHumidityHigh
+        oid: 1.3.6.1.4.1.6574.4.6.2.3
+        type: Float
+        help: Relative humidity threshold high (percent) - 1.3.6.1.4.1.6574.4.6.2.3
+      - name: upsAmbientHumidityLow
+        oid: 1.3.6.1.4.1.6574.4.6.2.4
+        type: Float
+        help: Relative humidity threshold low (percent) - 1.3.6.1.4.1.6574.4.6.2.4
+      - name: upsAmbientHumidityMax
+        oid: 1.3.6.1.4.1.6574.4.6.2.5
+        type: Float
+        help: Maximum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.5
+      - name: upsAmbientHumidityMin
+        oid: 1.3.6.1.4.1.6574.4.6.2.6
+        type: Float
+        help: Minimum relative humidity seen (percent) - 1.3.6.1.4.1.6574.4.6.2.6
+      - name: upsDriverName
+        oid: 1.3.6.1.4.1.6574.4.7.1
+        type: DisplayString
+        help: Driver name - 1.3.6.1.4.1.6574.4.7.1
+      - name: upsDriverVersion
+        oid: 1.3.6.1.4.1.6574.4.7.2
+        type: DisplayString
+        help: Driver version (NUT release) - 1.3.6.1.4.1.6574.4.7.2
+      - name: upsDriverVersionData
+        oid: 1.3.6.1.4.1.6574.4.7.3
+        type: DisplayString
+        help: Driver version data - 1.3.6.1.4.1.6574.4.7.3
+      - name: upsDriverVersionInternal
+        oid: 1.3.6.1.4.1.6574.4.7.4
+        type: DisplayString
+        help: Internal driver version (if tracked separately) - 1.3.6.1.4.1.6574.4.7.4
+      - name: upsDriverPollInterval
+        oid: 1.3.6.1.4.1.6574.4.7.5
+        type: gauge
+        help: Poll interval setup in configuration file - 1.3.6.1.4.1.6574.4.7.5
+      - name: upsDriverPort
+        oid: 1.3.6.1.4.1.6574.4.7.6
+        type: DisplayString
+        help: Port setup in configuration file - 1.3.6.1.4.1.6574.4.7.6
+      - name: upsDriverPollFrequency
+        oid: 1.3.6.1.4.1.6574.4.7.7
+        type: gauge
+        help: Poll frequency - 1.3.6.1.4.1.6574.4.7.7
+      - name: upsDriverProductID
+        oid: 1.3.6.1.4.1.6574.4.7.8
+        type: DisplayString
+        help: Product ID - 1.3.6.1.4.1.6574.4.7.8
+      - name: upsDriverSnmpVersion
+        oid: 1.3.6.1.4.1.6574.4.7.9
+        type: DisplayString
+        help: Snmp version - 1.3.6.1.4.1.6574.4.7.9
+      - name: upsServerInfo
+        oid: 1.3.6.1.4.1.6574.4.8.1
+        type: DisplayString
+        help: Server information - 1.3.6.1.4.1.6574.4.8.1
+      - name: upsServerVersion
+        oid: 1.3.6.1.4.1.6574.4.8.2
+        type: DisplayString
+        help: Server version - 1.3.6.1.4.1.6574.4.8.2
+      - name: diskSMARTInfoIndex
+        oid: 1.3.6.1.4.1.6574.5.1.1.1
+        type: gauge
+        help: SMART info index - 1.3.6.1.4.1.6574.5.1.1.1
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTInfoDevName
+        oid: 1.3.6.1.4.1.6574.5.1.1.2
+        type: OctetString
+        help: SMART info device name - 1.3.6.1.4.1.6574.5.1.1.2
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrName
+        oid: 1.3.6.1.4.1.6574.5.1.1.3
+        type: OctetString
+        help: SMART attribute name - 1.3.6.1.4.1.6574.5.1.1.3
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrId
+        oid: 1.3.6.1.4.1.6574.5.1.1.4
+        type: gauge
+        help: SMART attribute ID - 1.3.6.1.4.1.6574.5.1.1.4
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrCurrent
+        oid: 1.3.6.1.4.1.6574.5.1.1.5
+        type: gauge
+        help: SMART attribute current value - 1.3.6.1.4.1.6574.5.1.1.5
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrWorst
+        oid: 1.3.6.1.4.1.6574.5.1.1.6
+        type: gauge
+        help: SMART attribute worst value - 1.3.6.1.4.1.6574.5.1.1.6
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrThreshold
+        oid: 1.3.6.1.4.1.6574.5.1.1.7
+        type: gauge
+        help: SMART attribute threshold value - 1.3.6.1.4.1.6574.5.1.1.7
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrRaw
+        oid: 1.3.6.1.4.1.6574.5.1.1.8
+        type: gauge
+        help: SMART attribute raw value - 1.3.6.1.4.1.6574.5.1.1.8
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: diskSMARTAttrStatus
+        oid: 1.3.6.1.4.1.6574.5.1.1.9
+        type: OctetString
+        help: SMART attribute status - 1.3.6.1.4.1.6574.5.1.1.9
+        indexes:
+        - labelname: diskSMARTInfoIndex
+          type: gauge
+      - name: serviceInfoIndex
+        oid: 1.3.6.1.4.1.6574.6.1.1.1
+        type: gauge
+        help: Service info index - 1.3.6.1.4.1.6574.6.1.1.1
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceName
+        oid: 1.3.6.1.4.1.6574.6.1.1.2
+        type: OctetString
+        help: Service name - 1.3.6.1.4.1.6574.6.1.1.2
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+      - name: serviceUsers
+        oid: 1.3.6.1.4.1.6574.6.1.1.3
+        type: gauge
+        help: Number of users using this service - 1.3.6.1.4.1.6574.6.1.1.3
+        indexes:
+        - labelname: serviceInfoIndex
+          type: gauge
+        lookups:
+        - labels:
+          - serviceInfoIndex
+          labelname: serviceName
+          oid: 1.3.6.1.4.1.6574.6.1.1.2
+          type: OctetString
+        - labels: []
+          labelname: serviceInfoIndex
+    ubiquiti_airfiber:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.3
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: airFiberConfigIndex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.1
+        type: gauge
+        help: Index for the airFiberConfig - 1.3.6.1.4.1.41112.1.3.1.1.1
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: radioEnable
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.2
+        type: gauge
+        help: Radio Enabled State (Enabled/Disabled) - 1.3.6.1.4.1.41112.1.3.1.1.2
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: radioLinkMode
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.3
+        type: gauge
+        help: Radio Operating Mode - 1.3.6.1.4.1.41112.1.3.1.1.3
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: master
+          2: slave
+          3: spectral
+      - name: radioDuplex
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.4
+        type: gauge
+        help: Radio Duplex Mode - 1.3.6.1.4.1.41112.1.3.1.1.4
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: halfDuplex
+          2: fullDuplex
+      - name: txFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.5
+        type: gauge
+        help: TX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.5
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.6
+        type: gauge
+        help: RX Operating frequency (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.6
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: regDomain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.7
+        type: DisplayString
+        help: Regulatory Domain - 1.3.6.1.4.1.41112.1.3.1.1.7
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: gpsSync
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.8
+        type: gauge
+        help: GPS Synchronization state (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.8
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: txPower
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.9
+        type: gauge
+        help: Radio Transmit Power Setting (dBm) - 1.3.6.1.4.1.41112.1.3.1.1.9
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxGain
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.10
+        type: gauge
+        help: Radio Receiver Gain Setting - 1.3.6.1.4.1.41112.1.3.1.1.10
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: low
+          2: high
+      - name: maxTxModRate
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.11
+        type: gauge
+        help: Maximum TX Modulation Rate - 1.3.6.1.4.1.41112.1.3.1.1.11
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: modRateControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.12
+        type: gauge
+        help: Transmit Modulation Rate Control - 1.3.6.1.4.1.41112.1.3.1.1.12
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: manual
+          2: automatic
+      - name: ethDPortLinkSpeed
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.13
+        type: gauge
+        help: Ethernet Data Port Configuration - 1.3.6.1.4.1.41112.1.3.1.1.13
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: auto
+          2: half-10Mbps
+          3: half-100Mbps
+          4: full-10Mbps
+          5: full-100Mbps
+          6: full-1000Mbps
+      - name: linkName
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.14
+        type: DisplayString
+        help: Radio Link Name - 1.3.6.1.4.1.41112.1.3.1.1.14
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: encryptKey
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.15
+        type: DisplayString
+        help: Radio Link Encryption Key - 1.3.6.1.4.1.41112.1.3.1.1.15
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethFlowControl
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.16
+        type: gauge
+        help: Ethernet DATA port Flow Control (OFF, ON) - 1.3.6.1.4.1.41112.1.3.1.1.16
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethMcastFilter
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.17
+        type: gauge
+        help: Ethernet DATA port Multicast Filter - 1.3.6.1.4.1.41112.1.3.1.1.17
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          1: "off"
+          2: "on"
+      - name: ethTrackRFLink
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.18
+        type: gauge
+        help: Enable Ethernet DATA port state to track RF Link - 1.3.6.1.4.1.41112.1.3.1.1.18
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: use-Timers
+          2: enabled
+      - name: ethLinkOffDuration
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.19
+        type: gauge
+        help: Duration (seconds) of Ethernet Link Drop when ethTrackRFLink is set to Use-Timers
+          - 1.3.6.1.4.1.41112.1.3.1.1.19
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: ethLinkOffSpacing
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.20
+        type: gauge
+        help: Spacing (seconds) of consecutive Etherenet Link Drops when ethTrackLink
+          is set to Use-Timers - 1.3.6.1.4.1.41112.1.3.1.1.20
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.21
+        type: gauge
+        help: First configured TX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.21
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency1
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.22
+        type: gauge
+        help: First configured RX Frequency (MHz) of radio. - 1.3.6.1.4.1.41112.1.3.1.1.22
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.23
+        type: gauge
+        help: Second configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.23
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency2
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.24
+        type: gauge
+        help: Second configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.24
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.25
+        type: gauge
+        help: Third configured TX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.25
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxFrequency3
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.26
+        type: gauge
+        help: Third configured RX Frequency (MHz) of radio - 1.3.6.1.4.1.41112.1.3.1.1.26
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: channelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.27
+        type: gauge
+        help: Current RF Channel Bandwidth - 1.3.6.1.4.1.41112.1.3.1.1.27
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: txChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.28
+        type: gauge
+        help: Current TX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.28
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: rxChannelWidth
+        oid: 1.3.6.1.4.1.41112.1.3.1.1.29
+        type: gauge
+        help: Current RX RF Channel Bandwidth (MHz) - 1.3.6.1.4.1.41112.1.3.1.1.29
+        indexes:
+        - labelname: airFiberConfigIndex
+          type: gauge
+      - name: airFiberStatusIndex
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.1
+        type: gauge
+        help: Index for the air0 interface - 1.3.6.1.4.1.41112.1.3.2.1.1
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: curTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.2
+        type: gauge
+        help: Current Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.2
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: radioLinkDistFt
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.3
+        type: gauge
+        help: Radio Link Distance (Feet) - 1.3.6.1.4.1.41112.1.3.2.1.3
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkDistM
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.4
+        type: gauge
+        help: Radio Link Distance (Meters) - 1.3.6.1.4.1.41112.1.3.2.1.4
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.5
+        type: gauge
+        help: Radio Receive Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.5
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: txCapacity
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.6
+        type: gauge
+        help: Radio Transmit Throughput Capacity (bits/sec) - 1.3.6.1.4.1.41112.1.3.2.1.6
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.7
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.7
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio0TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.8
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.8
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempF
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.9
+        type: gauge
+        help: Radio Chain 1 DAC Temperature (F) - 1.3.6.1.4.1.41112.1.3.2.1.9
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radio1TempC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.10
+        type: gauge
+        help: Radio Chain 0 DAC Temperature (C) - 1.3.6.1.4.1.41112.1.3.2.1.10
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.11
+        type: gauge
+        help: Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.11
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.12
+        type: gauge
+        help: Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.12
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.13
+        type: gauge
+        help: Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.13
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.14
+        type: gauge
+        help: Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.14
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: rxPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.15
+        type: gauge
+        help: Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.15
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: rxOverload1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.16
+        type: gauge
+        help: Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.16
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteTXPower
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.17
+        type: gauge
+        help: Remote Radio Transmit Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.17
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteTXModRate
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.18
+        type: gauge
+        help: Remote Transmit Modulation Rate - 1.3.6.1.4.1.41112.1.3.2.1.18
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: qPSK-SISO-1-4x
+          1: qPSK-SISO-1x
+          2: qPSK-MIMO-2x
+          3: qAM8-MIMO-3x
+          4: qAM16-MIMO-4x
+          5: qAM32-MIMO-5x
+          6: qAM64-MIMO-6x
+          7: qAM128-MIMO-7x
+          8: qAM256-MIMO-8x
+          9: qAM512-MIMO-9x
+          10: qAM1024-MIMO-10x
+          11: qAM8-SISO-1p5x
+          12: qAM16-SISO-2x
+          13: qAM32-SISO-2p5x
+          14: qAM64-SISO-3x
+          15: qAM128-SISO-3p5x
+          16: qAM256-SISO-4x
+          17: qAM512-SISO-4p5x
+          18: qAM1024-SISO-5x
+      - name: remoteRXPower0
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.19
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.19
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower0Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.20
+        type: gauge
+        help: Remote Radio Chain 0 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.20
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower0Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.21
+        type: gauge
+        help: Remote Radio Chain 0 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.21
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.22
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Level (dBm) - 1.3.6.1.4.1.41112.1.3.2.1.22
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXPower1Valid
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.23
+        type: gauge
+        help: Remote Radio Chain 1 RX Power Valid - 1.3.6.1.4.1.41112.1.3.2.1.23
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: remoteRXPower1Overload
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.24
+        type: gauge
+        help: Remote Radio Chain 1 RX Overloaded - 1.3.6.1.4.1.41112.1.3.2.1.24
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: countryCode
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.25
+        type: gauge
+        help: Configured Country Code - 1.3.6.1.4.1.41112.1.3.2.1.25
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.26
+        type: gauge
+        help: Radio Link State - 1.3.6.1.4.1.41112.1.3.2.1.26
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: ethDataPortState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.27
+        type: gauge
+        help: Ethernet Data Port State - 1.3.6.1.4.1.41112.1.3.2.1.27
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+        enum_values:
+          0: down
+          1: up
+      - name: gpsPulse
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.28
+        type: DisplayString
+        help: GPS Pulse Detected - 1.3.6.1.4.1.41112.1.3.2.1.28
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsFix
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.29
+        type: DisplayString
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.3.2.1.29
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLat
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.30
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.3.2.1.30
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsLong
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.31
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.3.2.1.31
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.32
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.3.2.1.32
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.33
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.3.2.1.33
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.34
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.3.2.1.34
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.35
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.3.2.1.35
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: gpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.36
+        type: OctetString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.3.2.1.36
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsState
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.37
+        type: DisplayString
+        help: Radio DFS State - 1.3.6.1.4.1.41112.1.3.2.1.37
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: upTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.38
+        type: gauge
+        help: Board uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.38
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dateTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.39
+        type: DisplayString
+        help: Board date and time - 1.3.6.1.4.1.41112.1.3.2.1.39
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: fwVersion
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.40
+        type: DisplayString
+        help: Board Firmware Revision - 1.3.6.1.4.1.41112.1.3.2.1.40
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteRXGain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.41
+        type: DisplayString
+        help: Remote radio Receiver Gain - 1.3.6.1.4.1.41112.1.3.2.1.41
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: radioLinkInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.42
+        type: DisplayString
+        help: Radio Link Connection Information - 1.3.6.1.4.1.41112.1.3.2.1.42
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: ethDataPortInfo
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.43
+        type: DisplayString
+        help: Ethernet Data Port Link Connection Speed - 1.3.6.1.4.1.41112.1.3.2.1.43
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: linkUpTime
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.44
+        type: gauge
+        help: Radio Link uptime (seconds) - 1.3.6.1.4.1.41112.1.3.2.1.44
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteMAC
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.45
+        type: DisplayString
+        help: Remote radio MAC Address - 1.3.6.1.4.1.41112.1.3.2.1.45
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: remoteIP
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.46
+        type: DisplayString
+        help: Remote radio IP Address - 1.3.6.1.4.1.41112.1.3.2.1.46
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDetections
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.47
+        type: gauge
+        help: Number of DFS Detections since boot - 1.3.6.1.4.1.41112.1.3.2.1.47
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsDomain
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.48
+        type: DisplayString
+        help: DFS Regulatory Domain for current TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.48
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.49
+        type: DisplayString
+        help: State of first TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.49
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.50
+        type: DisplayString
+        help: State of second TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.50
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsStateTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.51
+        type: DisplayString
+        help: State of third TX Frequency - 1.3.6.1.4.1.41112.1.3.2.1.51
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq1
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.52
+        type: gauge
+        help: Seconds remaining before first TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.52
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq2
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.53
+        type: gauge
+        help: Seconds remaining before second TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.53
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: dfsTimerTxFreq3
+        oid: 1.3.6.1.4.1.41112.1.3.2.1.54
+        type: gauge
+        help: Seconds remaining before third TX Frequency can advance to next operating
+          state - 1.3.6.1.4.1.41112.1.3.2.1.54
+        indexes:
+        - labelname: airFiberStatusIndex
+          type: gauge
+      - name: airFiberStatisticsIndex
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.1
+        type: gauge
+        help: Index for the airFiberStatus - 1.3.6.1.4.1.41112.1.3.3.1.1
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.2
+        type: counter
+        help: Eth Data Port TX Frames - 1.3.6.1.4.1.41112.1.3.3.1.2
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFramesOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.3
+        type: counter
+        help: Eth Data Port RX Frames - 1.3.6.1.4.1.41112.1.3.3.1.3
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.4
+        type: counter
+        help: Eth Data Port CRC Errors - 1.3.6.1.4.1.41112.1.3.3.1.4
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxAlignErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.5
+        type: counter
+        help: Eth Data Port Receive Alignment Errors - 1.3.6.1.4.1.41112.1.3.3.1.5
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.6
+        type: counter
+        help: Eth Data Port TX Octets - 1.3.6.1.4.1.41112.1.3.3.1.6
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOctetsOK
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.7
+        type: counter
+        help: Eth Data Port RX Octets - 1.3.6.1.4.1.41112.1.3.3.1.7
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.8
+        type: counter
+        help: Eth Data Port Pause Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.8
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxPauseFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.9
+        type: counter
+        help: Eth Data Port Pause Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.9
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.10
+        type: counter
+        help: Eth Data Port Bad Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.10
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txErroredFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.11
+        type: counter
+        help: Eth Data Port Bad Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.11
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.12
+        type: counter
+        help: Eth Data Port Unicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.12
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.13
+        type: counter
+        help: Eth Data Port Multicast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.13
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.14
+        type: counter
+        help: Eth Data Port Broadcast Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.14
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidUnicastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.15
+        type: counter
+        help: Eth Data Port Unicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.15
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidMulticastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.16
+        type: counter
+        help: Eth Data Port Multicast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.16
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txValidBroadcastFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.17
+        type: counter
+        help: Eth Data Port Broadcast Frames Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.17
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxDroppedMacErrFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.18
+        type: counter
+        help: Eth Data Port Dropped MAC Receive Errors - 1.3.6.1.4.1.41112.1.3.3.1.18
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalOctets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.19
+        type: counter
+        help: Eth Data Port Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.19
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTotalFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.20
+        type: counter
+        help: Eth Data Port Total Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.20
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxLess64ByteFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.21
+        type: counter
+        help: Eth Data Port Undersized Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.21
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxOverLengthFrames
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.22
+        type: counter
+        help: Eth Data Port Over Max Length Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.22
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx64BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.23
+        type: counter
+        help: Eth Data Port 64 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.23
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx65_127BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.24
+        type: counter
+        help: Eth Data Port 65-127 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.24
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx128_255BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.25
+        type: counter
+        help: Eth Data Port 128-256 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.25
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx256_511BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.26
+        type: counter
+        help: Eth Data Port 256-511 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.26
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx512_1023BytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.27
+        type: counter
+        help: Eth Data Port 512-1023 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.27
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1024_1518BytesPackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.28
+        type: counter
+        help: Eth Data Port 1024-1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.28
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rx1519PlusBytePackets
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.29
+        type: counter
+        help: Eth Data Port Greater Than 1518 Byte Frames Received - 1.3.6.1.4.1.41112.1.3.3.1.29
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooLongFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.30
+        type: counter
+        help: Eth Data Port Too Long Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.30
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxTooShortFrameCrcErr
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.31
+        type: counter
+        help: Eth Data Port Too Short Frame CRC Errors Received - 1.3.6.1.4.1.41112.1.3.3.1.31
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.32
+        type: counter
+        help: RF TX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.32
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.33
+        type: counter
+        help: RF TX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.33
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.34
+        type: counter
+        help: RF TX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.34
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.35
+        type: counter
+        help: RF TX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.35
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.36
+        type: counter
+        help: RF TX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.36
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.37
+        type: counter
+        help: RF TX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.37
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.38
+        type: counter
+        help: RF TX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.38
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.39
+        type: counter
+        help: RF TX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.39
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.40
+        type: counter
+        help: RF TX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.40
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.41
+        type: counter
+        help: RF TX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.41
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.42
+        type: counter
+        help: RF TX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.42
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.43
+        type: counter
+        help: RF TX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.43
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.44
+        type: counter
+        help: RF TX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.44
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.45
+        type: counter
+        help: RF TX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.45
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.46
+        type: counter
+        help: RF TX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.46
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.47
+        type: counter
+        help: RF TX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.47
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.48
+        type: counter
+        help: RF RX Octets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.48
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.49
+        type: counter
+        help: RF RX Octets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.49
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.50
+        type: counter
+        help: RF RX Octets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.50
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.51
+        type: counter
+        help: RF RX Octets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.51
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.52
+        type: counter
+        help: RF RX Octets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.52
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.53
+        type: counter
+        help: RF RX Octets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.53
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.54
+        type: counter
+        help: RF RX Octets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.54
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqosoct7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.55
+        type: counter
+        help: RF RX Octets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.55
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt0
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.56
+        type: counter
+        help: RF RX Packets QOS 0 - 1.3.6.1.4.1.41112.1.3.3.1.56
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt1
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.57
+        type: counter
+        help: RF RX Packets QOS 1 - 1.3.6.1.4.1.41112.1.3.3.1.57
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt2
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.58
+        type: counter
+        help: RF RX Packets QOS 2 - 1.3.6.1.4.1.41112.1.3.3.1.58
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt3
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.59
+        type: counter
+        help: RF RX Packets QOS 3 - 1.3.6.1.4.1.41112.1.3.3.1.59
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt4
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.60
+        type: counter
+        help: RF RX Packets QOS 4 - 1.3.6.1.4.1.41112.1.3.3.1.60
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt5
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.61
+        type: counter
+        help: RF RX Packets QOS 5 - 1.3.6.1.4.1.41112.1.3.3.1.61
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt6
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.62
+        type: counter
+        help: RF RX Packets QOS 6 - 1.3.6.1.4.1.41112.1.3.3.1.62
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxqospkt7
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.63
+        type: counter
+        help: RF RX Packets QOS 7 - 1.3.6.1.4.1.41112.1.3.3.1.63
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.64
+        type: counter
+        help: RF Total Octets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.64
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: txpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.65
+        type: counter
+        help: RF Total Packets Transmitted - 1.3.6.1.4.1.41112.1.3.3.1.65
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxoctetsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.66
+        type: counter
+        help: RF Total Octets Received - 1.3.6.1.4.1.41112.1.3.3.1.66
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      - name: rxpktsAll
+        oid: 1.3.6.1.4.1.41112.1.3.3.1.67
+        type: counter
+        help: RF Total Packets Received - 1.3.6.1.4.1.41112.1.3.3.1.67
+        indexes:
+        - labelname: airFiberStatisticsIndex
+          type: gauge
+      version: 1
+    ubiquiti_airmax:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.4
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ubntHostLocaltime
+        oid: 1.3.6.1.4.1.41112.1.4.8.1
+        type: DisplayString
+        help: Host local time - 1.3.6.1.4.1.41112.1.4.8.1
+      - name: ubntHostNetrole
+        oid: 1.3.6.1.4.1.41112.1.4.8.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.8.2
+        enum_values:
+          0: unknown
+          1: bridge
+          2: router
+          3: soho
+      - name: ubntHostCpuLoad
+        oid: 1.3.6.1.4.1.41112.1.4.8.3
+        type: gauge
+        help: Host CPU load - 1.3.6.1.4.1.41112.1.4.8.3
+      - name: ubntHostTemperature
+        oid: 1.3.6.1.4.1.41112.1.4.8.4
+        type: gauge
+        help: Host system temperature - 1.3.6.1.4.1.41112.1.4.8.4
+      - name: ubntGpsStatus
+        oid: 1.3.6.1.4.1.41112.1.4.9.1
+        type: gauge
+        help: GPS status - 1.3.6.1.4.1.41112.1.4.9.1
+        enum_values:
+          0: absent
+          1: "off"
+          2: "on"
+      - name: ubntGpsFix
+        oid: 1.3.6.1.4.1.41112.1.4.9.2
+        type: gauge
+        help: GPS Fix Obtained - 1.3.6.1.4.1.41112.1.4.9.2
+        enum_values:
+          0: unknown
+          1: nofix
+          2: fix2d
+          3: fix3d
+      - name: ubntGpsLat
+        oid: 1.3.6.1.4.1.41112.1.4.9.3
+        type: DisplayString
+        help: GPS Latitude - 1.3.6.1.4.1.41112.1.4.9.3
+      - name: ubntGpsLon
+        oid: 1.3.6.1.4.1.41112.1.4.9.4
+        type: DisplayString
+        help: GPS Longitude - 1.3.6.1.4.1.41112.1.4.9.4
+      - name: ubntGpsAltMeters
+        oid: 1.3.6.1.4.1.41112.1.4.9.5
+        type: DisplayString
+        help: GPS Altitude (m) - 1.3.6.1.4.1.41112.1.4.9.5
+      - name: ubntGpsAltFeet
+        oid: 1.3.6.1.4.1.41112.1.4.9.6
+        type: DisplayString
+        help: GPS Altitude (ft) - 1.3.6.1.4.1.41112.1.4.9.6
+      - name: ubntGpsSatsVisible
+        oid: 1.3.6.1.4.1.41112.1.4.9.7
+        type: gauge
+        help: GPS Satellites Visible - 1.3.6.1.4.1.41112.1.4.9.7
+      - name: ubntGpsSatsTracked
+        oid: 1.3.6.1.4.1.41112.1.4.9.8
+        type: gauge
+        help: GPS Satellites Tracked - 1.3.6.1.4.1.41112.1.4.9.8
+      - name: ubntGpsHDOP
+        oid: 1.3.6.1.4.1.41112.1.4.9.9
+        type: DisplayString
+        help: GPS Horizontal Dilution of Precision - 1.3.6.1.4.1.41112.1.4.9.9
+      - name: ubntRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.1
+        type: gauge
+        help: Index for the ubntRadioTable - 1.3.6.1.4.1.41112.1.4.1.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioMode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.2
+        type: gauge
+        help: Radio mode - 1.3.6.1.4.1.41112.1.4.1.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: sta
+          2: ap
+          3: aprepeater
+          4: apwds
+      - name: ubntRadioCCode
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.3
+        type: gauge
+        help: Country code - 1.3.6.1.4.1.41112.1.4.1.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioFreq
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.4
+        type: gauge
+        help: Operating frequency - 1.3.6.1.4.1.41112.1.4.1.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDfsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.5
+        type: gauge
+        help: DFS status - 1.3.6.1.4.1.41112.1.4.1.1.5
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntRadioTxPower
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.6
+        type: gauge
+        help: Transmit power - 1.3.6.1.4.1.41112.1.4.1.1.6
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioDistance
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.7
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.1.1.7
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioChainmask
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.8
+        type: gauge
+        help: Chainmask - 1.3.6.1.4.1.41112.1.4.1.1.8
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioAntenna
+        oid: 1.3.6.1.4.1.41112.1.4.1.1.9
+        type: DisplayString
+        help: Antenna - 1.3.6.1.4.1.41112.1.4.1.1.9
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+      - name: ubntRadioRssiIndex
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.1
+        type: gauge
+        help: Index for the ubntRadioRssiTable - 1.3.6.1.4.1.41112.1.4.2.1.1
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssi
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.2
+        type: gauge
+        help: Data frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.2
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiMgmt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.3
+        type: gauge
+        help: Management frames rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.3
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntRadioRssiExt
+        oid: 1.3.6.1.4.1.41112.1.4.2.1.4
+        type: gauge
+        help: Extension channel rssi per chain - 1.3.6.1.4.1.41112.1.4.2.1.4
+        indexes:
+        - labelname: ubntRadioIndex
+          type: gauge
+        - labelname: ubntRadioRssiIndex
+          type: gauge
+      - name: ubntAirMaxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.7
+        type: gauge
+        help: airMAX Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.6.1.7
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxGpsSync
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.8
+        type: gauge
+        help: airMAX GPS sync - on/off - 1.3.6.1.4.1.41112.1.4.6.1.8
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxTdd
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.9
+        type: gauge
+        help: airMAX TDD framing - on/off - 1.3.6.1.4.1.41112.1.4.6.1.9
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.1
+        type: gauge
+        help: Index for the ubntAirMaxTable - 1.3.6.1.4.1.41112.1.4.6.1.1
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.2
+        type: gauge
+        help: airMAX status - on/off - 1.3.6.1.4.1.41112.1.4.6.1.2
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirMaxQuality
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.3
+        type: gauge
+        help: airMAX quality - percentage - 1.3.6.1.4.1.41112.1.4.6.1.3
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.4
+        type: gauge
+        help: airMAX capacity - percentage - 1.3.6.1.4.1.41112.1.4.6.1.4
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+      - name: ubntAirMaxPriority
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.5
+        type: gauge
+        help: airMAX priority - none/high/low/medium - 1.3.6.1.4.1.41112.1.4.6.1.5
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          0: high
+          1: medium
+          2: low
+          3: none
+      - name: ubntAirMaxNoAck
+        oid: 1.3.6.1.4.1.41112.1.4.6.1.6
+        type: gauge
+        help: airMAX NoACK mode - on/off - 1.3.6.1.4.1.41112.1.4.6.1.6
+        indexes:
+        - labelname: ubntAirMaxIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSyncIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.1
+        type: gauge
+        help: Index for the ubntAirSyncTable - 1.3.6.1.4.1.41112.1.4.3.1.1
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncMode
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.2
+        type: gauge
+        help: airSync mode - master/slave - 1.3.6.1.4.1.41112.1.4.3.1.2
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+        enum_values:
+          0: disabled
+          1: master
+          2: slave
+      - name: ubntAirSyncCount
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.3
+        type: gauge
+        help: airSync client count - 1.3.6.1.4.1.41112.1.4.3.1.3
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncDownUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.4
+        type: gauge
+        help: airSync down utilization - 1.3.6.1.4.1.41112.1.4.3.1.4
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSyncUpUtil
+        oid: 1.3.6.1.4.1.41112.1.4.3.1.5
+        type: gauge
+        help: airSync up utilization - 1.3.6.1.4.1.41112.1.4.3.1.5
+        indexes:
+        - labelname: ubntAirSyncIfIndex
+          type: gauge
+      - name: ubntAirSelIfIndex
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.1
+        type: gauge
+        help: Index for the ubntAirSelTable - 1.3.6.1.4.1.41112.1.4.4.1.1
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntAirSelEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.2
+        type: gauge
+        help: airSelect status - on/off - 1.3.6.1.4.1.41112.1.4.4.1.2
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntAirSelInterval
+        oid: 1.3.6.1.4.1.41112.1.4.4.1.3
+        type: gauge
+        help: airSelect hop interval (miliseconds) - 1.3.6.1.4.1.41112.1.4.4.1.3
+        indexes:
+        - labelname: ubntAirSelIfIndex
+          type: gauge
+      - name: ubntWlStatIndex
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.1
+        type: gauge
+        help: Index for the ubntWlStatTable - 1.3.6.1.4.1.41112.1.4.5.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.2
+        type: DisplayString
+        help: SSID - 1.3.6.1.4.1.41112.1.4.5.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatHideSsid
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.3
+        type: gauge
+        help: Hide SSID - on/off - 1.3.6.1.4.1.41112.1.4.5.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApMac
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.4
+        type: PhysAddress48
+        help: AP MAC address - 1.3.6.1.4.1.41112.1.4.5.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSignal
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.5
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.5.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRssi
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.6
+        type: gauge
+        help: RSSI, dBm - 1.3.6.1.4.1.41112.1.4.5.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatCcq
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.7
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.5.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.8
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.5.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.9
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.5.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.10
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.5.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatSecurity
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.11
+        type: DisplayString
+        help: Wireless security mode - 1.3.6.1.4.1.41112.1.4.5.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatWdsEnabled
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.12
+        type: gauge
+        help: WDS - on/off - 1.3.6.1.4.1.41112.1.4.5.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatApRepeater
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.13
+        type: gauge
+        help: AP repeater - on/off - 1.3.6.1.4.1.41112.1.4.5.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ubntWlStatChanWidth
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.14
+        type: gauge
+        help: Channel Width - 1.3.6.1.4.1.41112.1.4.5.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntWlStatStaCount
+        oid: 1.3.6.1.4.1.41112.1.4.5.1.15
+        type: gauge
+        help: Station count - 1.3.6.1.4.1.41112.1.4.5.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+      - name: ubntStaLocalCINR
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.16
+        type: gauge
+        help: Local CINR - 1.3.6.1.4.1.41112.1.4.7.1.16
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.17
+        type: gauge
+        help: Uplink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.17
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxCapacity
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.18
+        type: gauge
+        help: Downlink Capacity in Kbps - 1.3.6.1.4.1.41112.1.4.7.1.18
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.19
+        type: gauge
+        help: Uplink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.19
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxAirtime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.20
+        type: gauge
+        help: Downlink Airtime in % multiplied by 10 - 1.3.6.1.4.1.41112.1.4.7.1.20
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxLatency
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.21
+        type: gauge
+        help: Uplink Latency in milliseconds - 1.3.6.1.4.1.41112.1.4.7.1.21
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaMac
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.1
+        type: PhysAddress48
+        help: Station MAC address - 1.3.6.1.4.1.41112.1.4.7.1.1
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaName
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.2
+        type: DisplayString
+        help: Station name - 1.3.6.1.4.1.41112.1.4.7.1.2
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaSignal
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.3
+        type: gauge
+        help: Signal strength, dBm - 1.3.6.1.4.1.41112.1.4.7.1.3
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaNoiseFloor
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.4
+        type: gauge
+        help: Noise floor - 1.3.6.1.4.1.41112.1.4.7.1.4
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaDistance
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.5
+        type: gauge
+        help: Distance - 1.3.6.1.4.1.41112.1.4.7.1.5
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaCcq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.6
+        type: gauge
+        help: CCQ in % - 1.3.6.1.4.1.41112.1.4.7.1.6
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.7
+        type: gauge
+        help: airMAX priority - 1.3.6.1.4.1.41112.1.4.7.1.7
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmq
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.8
+        type: gauge
+        help: airMAX quality - 1.3.6.1.4.1.41112.1.4.7.1.8
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaAmc
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.9
+        type: gauge
+        help: airMAX capacity - 1.3.6.1.4.1.41112.1.4.7.1.9
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaLastIp
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.10
+        type: InetAddressIPv4
+        help: Last known IP address - 1.3.6.1.4.1.41112.1.4.7.1.10
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.11
+        type: gauge
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.11
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxRate
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.12
+        type: gauge
+        help: RX rate - 1.3.6.1.4.1.41112.1.4.7.1.12
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaTxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.13
+        type: counter
+        help: TX bytes - 1.3.6.1.4.1.41112.1.4.7.1.13
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaRxBytes
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.14
+        type: counter
+        help: TX rate - 1.3.6.1.4.1.41112.1.4.7.1.14
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      - name: ubntStaConnTime
+        oid: 1.3.6.1.4.1.41112.1.4.7.1.15
+        type: gauge
+        help: Connection Time in seconds - 1.3.6.1.4.1.41112.1.4.7.1.15
+        indexes:
+        - labelname: ubntWlStatIndex
+          type: gauge
+        - labelname: ubntStaMac
+          type: PhysAddress48
+          fixed_size: 6
+      version: 1
+    ubiquiti_unifi:
+      walk:
+      - 1.3.6.1.2.1.2
+      - 1.3.6.1.2.1.31.1.1
+      - 1.3.6.1.4.1.41112.1.6
+      get:
+      - 1.3.6.1.2.1.1.3.0
+      metrics:
+      - name: sysUpTime
+        oid: 1.3.6.1.2.1.1.3
+        type: gauge
+        help: The time (in hundredths of a second) since the network management portion
+          of the system was last re-initialized. - 1.3.6.1.2.1.1.3
+      - name: ifNumber
+        oid: 1.3.6.1.2.1.2.1
+        type: gauge
+        help: The number of network interfaces (regardless of their current state) present
+          on this system. - 1.3.6.1.2.1.2.1
+      - name: ifIndex
+        oid: 1.3.6.1.2.1.2.2.1.1
+        type: gauge
+        help: A unique value, greater than zero, for each interface - 1.3.6.1.2.1.2.2.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifDescr
+        oid: 1.3.6.1.2.1.2.2.1.2
+        type: DisplayString
+        help: A textual string containing information about the interface - 1.3.6.1.2.1.2.2.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifType
+        oid: 1.3.6.1.2.1.2.2.1.3
+        type: EnumAsInfo
+        help: The type of interface - 1.3.6.1.2.1.2.2.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: other
+          2: regular1822
+          3: hdh1822
+          4: ddnX25
+          5: rfc877x25
+          6: ethernetCsmacd
+          7: iso88023Csmacd
+          8: iso88024TokenBus
+          9: iso88025TokenRing
+          10: iso88026Man
+          11: starLan
+          12: proteon10Mbit
+          13: proteon80Mbit
+          14: hyperchannel
+          15: fddi
+          16: lapb
+          17: sdlc
+          18: ds1
+          19: e1
+          20: basicISDN
+          21: primaryISDN
+          22: propPointToPointSerial
+          23: ppp
+          24: softwareLoopback
+          25: eon
+          26: ethernet3Mbit
+          27: nsip
+          28: slip
+          29: ultra
+          30: ds3
+          31: sip
+          32: frameRelay
+          33: rs232
+          34: para
+          35: arcnet
+          36: arcnetPlus
+          37: atm
+          38: miox25
+          39: sonet
+          40: x25ple
+          41: iso88022llc
+          42: localTalk
+          43: smdsDxi
+          44: frameRelayService
+          45: v35
+          46: hssi
+          47: hippi
+          48: modem
+          49: aal5
+          50: sonetPath
+          51: sonetVT
+          52: smdsIcip
+          53: propVirtual
+          54: propMultiplexor
+          55: ieee80212
+          56: fibreChannel
+          57: hippiInterface
+          58: frameRelayInterconnect
+          59: aflane8023
+          60: aflane8025
+          61: cctEmul
+          62: fastEther
+          63: isdn
+          64: v11
+          65: v36
+          66: g703at64k
+          67: g703at2mb
+          68: qllc
+          69: fastEtherFX
+          70: channel
+          71: ieee80211
+          72: ibm370parChan
+          73: escon
+          74: dlsw
+          75: isdns
+          76: isdnu
+          77: lapd
+          78: ipSwitch
+          79: rsrb
+          80: atmLogical
+          81: ds0
+          82: ds0Bundle
+          83: bsc
+          84: async
+          85: cnr
+          86: iso88025Dtr
+          87: eplrs
+          88: arap
+          89: propCnls
+          90: hostPad
+          91: termPad
+          92: frameRelayMPI
+          93: x213
+          94: adsl
+          95: radsl
+          96: sdsl
+          97: vdsl
+          98: iso88025CRFPInt
+          99: myrinet
+          100: voiceEM
+          101: voiceFXO
+          102: voiceFXS
+          103: voiceEncap
+          104: voiceOverIp
+          105: atmDxi
+          106: atmFuni
+          107: atmIma
+          108: pppMultilinkBundle
+          109: ipOverCdlc
+          110: ipOverClaw
+          111: stackToStack
+          112: virtualIpAddress
+          113: mpc
+          114: ipOverAtm
+          115: iso88025Fiber
+          116: tdlc
+          117: gigabitEthernet
+          118: hdlc
+          119: lapf
+          120: v37
+          121: x25mlp
+          122: x25huntGroup
+          123: transpHdlc
+          124: interleave
+          125: fast
+          126: ip
+          127: docsCableMaclayer
+          128: docsCableDownstream
+          129: docsCableUpstream
+          130: a12MppSwitch
+          131: tunnel
+          132: coffee
+          133: ces
+          134: atmSubInterface
+          135: l2vlan
+          136: l3ipvlan
+          137: l3ipxvlan
+          138: digitalPowerline
+          139: mediaMailOverIp
+          140: dtm
+          141: dcn
+          142: ipForward
+          143: msdsl
+          144: ieee1394
+          145: if-gsn
+          146: dvbRccMacLayer
+          147: dvbRccDownstream
+          148: dvbRccUpstream
+          149: atmVirtual
+          150: mplsTunnel
+          151: srp
+          152: voiceOverAtm
+          153: voiceOverFrameRelay
+          154: idsl
+          155: compositeLink
+          156: ss7SigLink
+          157: propWirelessP2P
+          158: frForward
+          159: rfc1483
+          160: usb
+          161: ieee8023adLag
+          162: bgppolicyaccounting
+          163: frf16MfrBundle
+          164: h323Gatekeeper
+          165: h323Proxy
+          166: mpls
+          167: mfSigLink
+          168: hdsl2
+          169: shdsl
+          170: ds1FDL
+          171: pos
+          172: dvbAsiIn
+          173: dvbAsiOut
+          174: plc
+          175: nfas
+          176: tr008
+          177: gr303RDT
+          178: gr303IDT
+          179: isup
+          180: propDocsWirelessMaclayer
+          181: propDocsWirelessDownstream
+          182: propDocsWirelessUpstream
+          183: hiperlan2
+          184: propBWAp2Mp
+          185: sonetOverheadChannel
+          186: digitalWrapperOverheadChannel
+          187: aal2
+          188: radioMAC
+          189: atmRadio
+          190: imt
+          191: mvl
+          192: reachDSL
+          193: frDlciEndPt
+          194: atmVciEndPt
+          195: opticalChannel
+          196: opticalTransport
+          197: propAtm
+          198: voiceOverCable
+          199: infiniband
+          200: teLink
+          201: q2931
+          202: virtualTg
+          203: sipTg
+          204: sipSig
+          205: docsCableUpstreamChannel
+          206: econet
+          207: pon155
+          208: pon622
+          209: bridge
+          210: linegroup
+          211: voiceEMFGD
+          212: voiceFGDEANA
+          213: voiceDID
+          214: mpegTransport
+          215: sixToFour
+          216: gtp
+          217: pdnEtherLoop1
+          218: pdnEtherLoop2
+          219: opticalChannelGroup
+          220: homepna
+          221: gfp
+          222: ciscoISLvlan
+          223: actelisMetaLOOP
+          224: fcipLink
+          225: rpr
+          226: qam
+          227: lmp
+          228: cblVectaStar
+          229: docsCableMCmtsDownstream
+          230: adsl2
+          231: macSecControlledIF
+          232: macSecUncontrolledIF
+          233: aviciOpticalEther
+          234: atmbond
+          235: voiceFGDOS
+          236: mocaVersion1
+          237: ieee80216WMAN
+          238: adsl2plus
+          239: dvbRcsMacLayer
+          240: dvbTdm
+          241: dvbRcsTdma
+          242: x86Laps
+          243: wwanPP
+          244: wwanPP2
+          245: voiceEBS
+          246: ifPwType
+          247: ilan
+          248: pip
+          249: aluELP
+          250: gpon
+          251: vdsl2
+          252: capwapDot11Profile
+          253: capwapDot11Bss
+          254: capwapWtpVirtualRadio
+          255: bits
+          256: docsCableUpstreamRfPort
+          257: cableDownstreamRfPort
+          258: vmwareVirtualNic
+          259: ieee802154
+          260: otnOdu
+          261: otnOtu
+          262: ifVfiType
+          263: g9981
+          264: g9982
+          265: g9983
+          266: aluEpon
+          267: aluEponOnu
+          268: aluEponPhysicalUni
+          269: aluEponLogicalLink
+          270: aluGponOnu
+          271: aluGponPhysicalUni
+          272: vmwareNicTeam
+          277: docsOfdmDownstream
+          278: docsOfdmaUpstream
+          279: gfast
+          280: sdci
+          281: xboxWireless
+          282: fastdsl
+          283: docsCableScte55d1FwdOob
+          284: docsCableScte55d1RetOob
+          285: docsCableScte55d2DsOob
+          286: docsCableScte55d2UsOob
+          287: docsCableNdf
+          288: docsCableNdr
+          289: ptm
+          290: ghn
+          291: otnOtsi
+          292: otnOtuc
+          293: otnOduc
+          294: otnOtsig
+          295: microwaveCarrierTermination
+          296: microwaveRadioLinkTerminal
+          297: ieee8021axDrni
+          298: ax25
+          299: ieee19061nanocom
+      - name: ifMtu
+        oid: 1.3.6.1.2.1.2.2.1.4
+        type: gauge
+        help: The size of the largest packet which can be sent/received on the interface,
+          specified in octets - 1.3.6.1.2.1.2.2.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpeed
+        oid: 1.3.6.1.2.1.2.2.1.5
+        type: gauge
+        help: An estimate of the interface's current bandwidth in bits per second - 1.3.6.1.2.1.2.2.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPhysAddress
+        oid: 1.3.6.1.2.1.2.2.1.6
+        type: PhysAddress48
+        help: The interface's address at its protocol sub-layer - 1.3.6.1.2.1.2.2.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifAdminStatus
+        oid: 1.3.6.1.2.1.2.2.1.7
+        type: gauge
+        help: The desired state of the interface - 1.3.6.1.2.1.2.2.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+      - name: ifOperStatus
+        oid: 1.3.6.1.2.1.2.2.1.8
+        type: gauge
+        help: The current operational state of the interface - 1.3.6.1.2.1.2.2.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: up
+          2: down
+          3: testing
+          4: unknown
+          5: dormant
+          6: notPresent
+          7: lowerLayerDown
+      - name: ifLastChange
+        oid: 1.3.6.1.2.1.2.2.1.9
+        type: gauge
+        help: The value of sysUpTime at the time the interface entered its current operational
+          state - 1.3.6.1.2.1.2.2.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInOctets
+        oid: 1.3.6.1.2.1.2.2.1.10
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.11
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.2.2.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.12
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast or broadcast address at this sub-layer -
+          1.3.6.1.2.1.2.2.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInDiscards
+        oid: 1.3.6.1.2.1.2.2.1.13
+        type: counter
+        help: The number of inbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being deliverable to a higher-layer
+          protocol - 1.3.6.1.2.1.2.2.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInErrors
+        oid: 1.3.6.1.2.1.2.2.1.14
+        type: counter
+        help: For packet-oriented interfaces, the number of inbound packets that contained
+          errors preventing them from being deliverable to a higher-layer protocol - 1.3.6.1.2.1.2.2.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInUnknownProtos
+        oid: 1.3.6.1.2.1.2.2.1.15
+        type: counter
+        help: For packet-oriented interfaces, the number of packets received via the interface
+          which were discarded because of an unknown or unsupported protocol - 1.3.6.1.2.1.2.2.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutOctets
+        oid: 1.3.6.1.2.1.2.2.1.16
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.2.2.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.17
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutNUcastPkts
+        oid: 1.3.6.1.2.1.2.2.1.18
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.2.2.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutDiscards
+        oid: 1.3.6.1.2.1.2.2.1.19
+        type: counter
+        help: The number of outbound packets which were chosen to be discarded even though
+          no errors had been detected to prevent their being transmitted - 1.3.6.1.2.1.2.2.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutErrors
+        oid: 1.3.6.1.2.1.2.2.1.20
+        type: counter
+        help: For packet-oriented interfaces, the number of outbound packets that could
+          not be transmitted because of errors - 1.3.6.1.2.1.2.2.1.20
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutQLen
+        oid: 1.3.6.1.2.1.2.2.1.21
+        type: gauge
+        help: The length of the output packet queue (in packets). - 1.3.6.1.2.1.2.2.1.21
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifSpecific
+        oid: 1.3.6.1.2.1.2.2.1.22
+        type: OctetString
+        help: A reference to MIB definitions specific to the particular media being used
+          to realize the interface - 1.3.6.1.2.1.2.2.1.22
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifName
+        oid: 1.3.6.1.2.1.31.1.1.1.1
+        type: DisplayString
+        help: The textual name of the interface - 1.3.6.1.2.1.31.1.1.1.1
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.2
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.2
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.3
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.3
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.4
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.4
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.5
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.5
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.6
+        type: counter
+        help: The total number of octets received on the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.6
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.7
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were not addressed to a multicast or broadcast address at this sub-layer
+          - 1.3.6.1.2.1.31.1.1.1.7
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.8
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a multicast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.8
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCInBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.9
+        type: counter
+        help: The number of packets, delivered by this sub-layer to a higher (sub-)layer,
+          which were addressed to a broadcast address at this sub-layer - 1.3.6.1.2.1.31.1.1.1.9
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutOctets
+        oid: 1.3.6.1.2.1.31.1.1.1.10
+        type: counter
+        help: The total number of octets transmitted out of the interface, including framing
+          characters - 1.3.6.1.2.1.31.1.1.1.10
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutUcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.11
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were not addressed to a multicast or broadcast address at this sub-layer,
+          including those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.11
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutMulticastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.12
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a multicast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.12
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifHCOutBroadcastPkts
+        oid: 1.3.6.1.2.1.31.1.1.1.13
+        type: counter
+        help: The total number of packets that higher-level protocols requested be transmitted,
+          and which were addressed to a broadcast address at this sub-layer, including
+          those that were discarded or not sent - 1.3.6.1.2.1.31.1.1.1.13
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifLinkUpDownTrapEnable
+        oid: 1.3.6.1.2.1.31.1.1.1.14
+        type: gauge
+        help: Indicates whether linkUp/linkDown traps should be generated for this interface
+          - 1.3.6.1.2.1.31.1.1.1.14
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: enabled
+          2: disabled
+      - name: ifHighSpeed
+        oid: 1.3.6.1.2.1.31.1.1.1.15
+        type: gauge
+        help: An estimate of the interface's current bandwidth in units of 1,000,000 bits
+          per second - 1.3.6.1.2.1.31.1.1.1.15
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifPromiscuousMode
+        oid: 1.3.6.1.2.1.31.1.1.1.16
+        type: gauge
+        help: This object has a value of false(2) if this interface only accepts packets/frames
+          that are addressed to this station - 1.3.6.1.2.1.31.1.1.1.16
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifConnectorPresent
+        oid: 1.3.6.1.2.1.31.1.1.1.17
+        type: gauge
+        help: This object has the value 'true(1)' if the interface sublayer has a physical
+          connector and the value 'false(2)' otherwise. - 1.3.6.1.2.1.31.1.1.1.17
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: ifAlias
+        oid: 1.3.6.1.2.1.31.1.1.1.18
+        type: DisplayString
+        help: This object is an 'alias' name for the interface as specified by a network
+          manager, and provides a non-volatile 'handle' for the interface - 1.3.6.1.2.1.31.1.1.1.18
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: ifCounterDiscontinuityTime
+        oid: 1.3.6.1.2.1.31.1.1.1.19
+        type: gauge
+        help: The value of sysUpTime on the most recent occasion at which any one or more
+          of this interface's counters suffered a discontinuity - 1.3.6.1.2.1.31.1.1.1.19
+        indexes:
+        - labelname: ifIndex
+          type: gauge
+      - name: unifiRadioIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.1'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioName
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.2
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.2'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.3'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.4
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.4'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.5'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuTotal
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.6
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.6'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfRx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.7
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.7'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioCuSelfTx
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.8'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiRadioOtherBss
+        oid: 1.3.6.1.4.1.41112.1.6.1.1.1.9
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.1.1.9'
+        indexes:
+        - labelname: unifiRadioIndex
+          type: gauge
+      - name: unifiVapIndex
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.1'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapBssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.2
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.2'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapCcq
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.3
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.3'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.4
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.4'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapExtChannel
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.5
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.5'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapEssId
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.6'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapName
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.7
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.7'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapNumStations
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.8
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.8'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRadio
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.9
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.9'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.10'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxCrypts
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.11
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.11'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.12'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.13'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxFrags
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.14'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.15'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.16
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.16'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.17
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.17'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxErrors
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.18
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.18'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.19
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.19'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxRetries
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.20
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.20'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapTxPower
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.21
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.21'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiVapUp
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.22
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.1.2.1.22'
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiVapUsage
+        oid: 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        type: DisplayString
+        help: guest or regular user - 1.3.6.1.4.1.41112.1.6.1.2.1.23
+        indexes:
+        - labelname: unifiVapIndex
+          type: gauge
+      - name: unifiIfIndex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.1
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.1'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfFullDuplex
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.2'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiIfIp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.3
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.3'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfMac
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.4
+        type: PhysAddress48
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.4'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfName
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.5
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.5'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.6
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.6'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.7
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.7'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.8
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.8'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxMulticast
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.9
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.9'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfRxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.10
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.10'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfSpeed
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.11
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.11'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxBytes
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.12
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.12'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxDropped
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.13
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.13'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxError
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.14
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.14'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfTxPackets
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.15
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.15'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+      - name: unifiIfUp
+        oid: 1.3.6.1.4.1.41112.1.6.2.1.1.16
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.2.1.1.16'
+        indexes:
+        - labelname: unifiIfIndex
+          type: gauge
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemIp
+        oid: 1.3.6.1.4.1.41112.1.6.3.1
+        type: InetAddressIPv4
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.1'
+      - name: unifiApSystemIsolated
+        oid: 1.3.6.1.4.1.41112.1.6.3.2
+        type: gauge
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.2'
+        enum_values:
+          1: "true"
+          2: "false"
+      - name: unifiApSystemModel
+        oid: 1.3.6.1.4.1.41112.1.6.3.3
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.3'
+      - name: unifiApSystemUplink
+        oid: 1.3.6.1.4.1.41112.1.6.3.4
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.4'
+      - name: unifiApSystemUptime
+        oid: 1.3.6.1.4.1.41112.1.6.3.5
+        type: counter
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.5'
+      - name: unifiApSystemVersion
+        oid: 1.3.6.1.4.1.41112.1.6.3.6
+        type: DisplayString
+        help: ' - 1.3.6.1.4.1.41112.1.6.3.6'
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5aef90febced06d2c3b57c4c07d7a1b9281fb269
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/deployment.yaml
@@ -0,0 +1,54 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    {{- include "snmpexporter.labels" . | nindent 4 }}
+spec:
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      {{- include "snmpexporter.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      labels:
+        {{- include "snmpexporter.selectorLabels" . | nindent 8 }}
+    spec:
+      securityContext:
+        runAsUser: 0
+      initContainers:
+        - name: init-config
+          image: busybox:1.28
+          command: ['sh', '-c', 'if [ ! -f "/etc/snmp_exporter/snmp.yml" ]; then cp /etc/snmp_exporter_init/snmp.yml /etc/snmp_exporter; fi']
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+            - name: init-config-volume
+              mountPath: /etc/snmp_exporter_init
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.version }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - containerPort: 9116
+              protocol: TCP
+          volumeMounts:
+            - name: config-volume
+              mountPath: /etc/snmp_exporter
+          livenessProbe:
+            exec:
+              command:
+                - /bin/sh
+                - -c
+                - if [ ! -f "/etc/snmp_exporter/generator.yml" ]; then exit 0; else rm -f /etc/snmp_exporter/generator.yml && exit 1; fi
+            failureThreshold: 1
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+      volumes:
+        - name: config-volume
+          hostPath: 
+            path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+        - name: init-config-volume
+          configMap:
+            name: "snmp-init-config-{{ .Values.global.osm.vnf_id | lower }}"
+          
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..6ec5fb4fb4153956026d8bbb77439ca1cf6234aa
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/templates/service.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "snmpexporter.fullname" . }}
+  labels:
+    {{- include "snmpexporter.labels" . | nindent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: 9116
+      protocol: TCP
+      name: snmp
+  selector:
+    {{- include "snmpexporter.selectorLabels" . | nindent 4 }}
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..cbe306fa4886e327d4887e771cc658d4c0a35d7c
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/charts/snmpexporter/values.yaml
@@ -0,0 +1,14 @@
+# Default values for snmpexporter.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: prom/snmp-exporter
+  version: v0.17.0
+  pullPolicy: IfNotPresent
+
+service:
+  type: ClusterIP
+  port: 80
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/prometheus-job-template.j2 b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/prometheus-job-template.j2
new file mode 100644
index 0000000000000000000000000000000000000000..f82adfc1b6fcb70ec0c1d3efd13813439af5f49b
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/prometheus-job-template.j2
@@ -0,0 +1,15 @@
+-   job_name: '{{ JOB_NAME }}'
+    static_configs:
+      - targets:
+          - {{ TARGET_IP }}
+    metrics_path: /snmp
+    params:
+        module: [ osm-snmp ] 
+    relabel_configs:
+      - source_labels: [__address__]
+        target_label: __param_target
+      - source_labels: [__param_target]
+        target_label: instance
+      - target_label: __address__
+        replacement: {{ EXPORTER_POD_IP }}:{{ EXPORTER_POD_PORT }}  # The SNMP exporter's real hostname:port.
+
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/generator.yml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/generator.yml
new file mode 100644
index 0000000000000000000000000000000000000000..5e05b82966e28e5195c6092b07322d06552f6e4f
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/generator.yml
@@ -0,0 +1,14 @@
+modules:
+  osm-snmp:
+    walk: [interfaces]
+    lookups:
+      - source_indexes: [ifIndex]
+        lookup: ifAlias
+      - source_indexes: [ifIndex]
+        lookup: ifDescr
+      - source_indexes: [ifIndex]
+        # Use OID to avoid conflict with Netscaler NS-ROOT-MIB.
+        lookup: 1.3.6.1.2.1.31.1.1.1.1 # ifName
+    auth:
+      # Community string is used with SNMP v1 and v2. Defaults to "public".
+      community: secret
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..df59fa918c37b24cd0e8eb3a450a6ed32d010cd2
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IANAifType-MIB.txt
@@ -0,0 +1,638 @@
+   IANAifType-MIB DEFINITIONS ::= BEGIN
+
+   IMPORTS
+       MODULE-IDENTITY, mib-2      FROM SNMPv2-SMI
+       TEXTUAL-CONVENTION          FROM SNMPv2-TC;
+
+   ianaifType MODULE-IDENTITY
+       LAST-UPDATED "201205170000Z"  -- May 17, 2012
+       ORGANIZATION "IANA"
+       CONTACT-INFO "        Internet Assigned Numbers Authority
+
+                     Postal: ICANN
+                             4676 Admiralty Way, Suite 330
+                             Marina del Rey, CA 90292
+
+                     Tel:    +1 310 823 9358
+                     E-Mail: iana&iana.org"
+       DESCRIPTION  "This MIB module defines the IANAifType Textual
+                     Convention, and thus the enumerated values of
+                     the ifType object defined in MIB-II's ifTable."
+
+       REVISION     "201205170000Z"  -- May 17, 2012
+       DESCRIPTION  "Registration of new IANAifType 272."
+
+       REVISION     "201201110000Z"  -- January 11, 2012
+       DESCRIPTION  "Registration of new IANAifTypes 266-271."
+
+       REVISION     "201112180000Z"  -- December 18, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 263-265."
+
+       REVISION     "201110260000Z"  -- October 26, 2011
+       DESCRIPTION  "Registration of new IANAifType 262."
+
+       REVISION     "201109070000Z"  -- September 7, 2011
+       DESCRIPTION  "Registration of new IANAifTypes 260 and 261."
+
+       REVISION     "201107220000Z"  -- July 22, 2011
+       DESCRIPTION  "Registration of new IANAifType 259."
+
+       REVISION     "201106030000Z"  -- June 03, 2011
+       DESCRIPTION  "Registration of new IANAifType 258."
+
+       REVISION     "201009210000Z"  -- September 21, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 256 and 257."
+
+       REVISION     "201007210000Z"  -- July 21, 2010
+       DESCRIPTION  "Registration of new IANAifType 255."
+
+       REVISION     "201002110000Z"  -- February 11, 2010
+       DESCRIPTION  "Registration of new IANAifType 254."
+
+       REVISION     "201002080000Z"  -- February 08, 2010
+       DESCRIPTION  "Registration of new IANAifTypes 252 and 253."
+
+       REVISION     "200905060000Z"  -- May 06, 2009
+       DESCRIPTION  "Registration of new IANAifType 251."
+
+       REVISION     "200902060000Z"  -- February 06, 2009
+       DESCRIPTION  "Registration of new IANAtunnelType 15."
+
+       REVISION     "200810090000Z"  -- October 09, 2008
+       DESCRIPTION  "Registration of new IANAifType 250."
+
+       REVISION     "200808120000Z"  -- August 12, 2008
+       DESCRIPTION  "Registration of new IANAifType 249."
+
+       REVISION     "200807220000Z"  -- July 22, 2008
+       DESCRIPTION  "Registration of new IANAifTypes 247 and 248."
+
+       REVISION     "200806240000Z"  -- June 24, 2008
+       DESCRIPTION  "Registration of new IANAifType 246."
+
+       REVISION     "200805290000Z"  -- May 29, 2008
+       DESCRIPTION  "Registration of new IANAifType 245."
+
+       REVISION     "200709130000Z"  -- September 13, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 243 and 244."
+
+       REVISION     "200705290000Z"  -- May 29, 2007
+       DESCRIPTION  "Changed the description for IANAifType 228."
+
+       REVISION     "200703080000Z"  -- March 08, 2007
+       DESCRIPTION  "Registration of new IANAifType 242."
+
+       REVISION     "200701230000Z"  -- January 23, 2007
+       DESCRIPTION  "Registration of new IANAifTypes 239, 240, and 241." 
+
+       REVISION     "200610170000Z"  -- October 17, 2006
+       DESCRIPTION  "Deprecated/Obsoleted IANAifType 230.  Registration of 
+                     IANAifType 238." 
+
+       REVISION     "200609250000Z"  -- September 25, 2006
+       DESCRIPTION  "Changed the description for IANA ifType 
+                     184 and added new IANA ifType 237."  
+
+       REVISION     "200608170000Z"  -- August 17, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     20 and 21."   
+
+       REVISION     "200608110000Z"  -- August 11, 2006
+       DESCRIPTION  "Changed the descriptions for IANAifTypes
+                     7, 11, 62, 69, and 117."   
+
+       REVISION     "200607250000Z"  -- July 25, 2006
+       DESCRIPTION  "Registration of new IANA ifType 236."
+
+       REVISION     "200606140000Z"  -- June 14, 2006
+       DESCRIPTION  "Registration of new IANA ifType 235."
+
+       REVISION     "200603310000Z"  -- March 31, 2006
+       DESCRIPTION  "Registration of new IANA ifType 234."
+
+       REVISION     "200603300000Z"  -- March 30, 2006
+       DESCRIPTION  "Registration of new IANA ifType 233."
+
+       REVISION     "200512220000Z"  -- December 22, 2005
+       DESCRIPTION  "Registration of new IANA ifTypes 231 and 232."
+
+       REVISION     "200510100000Z"  -- October 10, 2005
+       DESCRIPTION  "Registration of new IANA ifType 230."
+
+       REVISION     "200509090000Z"  -- September 09, 2005
+       DESCRIPTION  "Registration of new IANA ifType 229."
+
+       REVISION     "200505270000Z"  -- May 27, 2005
+       DESCRIPTION  "Registration of new IANA ifType 228."
+
+       REVISION     "200503030000Z"  -- March 3, 2005
+       DESCRIPTION  "Added the IANAtunnelType TC and deprecated
+	                 IANAifType sixToFour (215) per RFC4087."
+
+       REVISION     "200411220000Z"  -- November 22, 2004
+       DESCRIPTION  "Registration of new IANA ifType 227 per RFC4631."
+
+       REVISION     "200406170000Z"  -- June 17, 2004
+       DESCRIPTION  "Registration of new IANA ifType 226."
+
+       REVISION     "200405120000Z"  -- May 12, 2004
+       DESCRIPTION  "Added description for IANAifType 6, and 
+	                 changed the descriptions for IANAifTypes
+                     180, 181, and 182."
+
+       REVISION     "200405070000Z"  -- May 7, 2004
+       DESCRIPTION  "Registration of new IANAifType 225."
+
+       REVISION     "200308250000Z"  -- Aug 25, 2003
+       DESCRIPTION  "Deprecated IANAifTypes 7 and 11. Obsoleted
+                     IANAifTypes 62, 69, and 117.  ethernetCsmacd (6)
+                     should be used instead of these values"
+
+       REVISION     "200308180000Z"  -- Aug 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     224."
+
+       REVISION     "200308070000Z"  -- Aug 7, 2003
+       DESCRIPTION  "Registration of new IANAifTypes
+                     222 and 223."
+
+       REVISION     "200303180000Z"  -- Mar 18, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     221."
+
+       REVISION     "200301130000Z"  -- Jan 13, 2003
+       DESCRIPTION  "Registration of new IANAifType
+                     220."
+
+       REVISION     "200210170000Z"  -- Oct 17, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     219."
+
+       REVISION     "200207160000Z"  -- Jul 16, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     217 and 218."
+
+       REVISION     "200207100000Z"  -- Jul 10, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     215 and 216."
+
+       REVISION     "200206190000Z"  -- Jun 19, 2002
+       DESCRIPTION  "Registration of new IANAifType
+                     214."
+
+       REVISION     "200201040000Z"  -- Jan 4, 2002
+       DESCRIPTION  "Registration of new IANAifTypes
+                     211, 212 and 213."
+
+       REVISION     "200112200000Z"  -- Dec 20, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     209 and 210."
+
+       REVISION     "200111150000Z"  -- Nov 15, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     207 and 208."
+
+       REVISION     "200111060000Z"  -- Nov 6, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     206."
+
+       REVISION     "200111020000Z"  -- Nov 2, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     205."
+
+       REVISION     "200110160000Z"  -- Oct 16, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     199, 200, 201, 202, 203, and 204."
+
+       REVISION     "200109190000Z"  -- Sept 19, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     198."
+
+       REVISION     "200105110000Z"  -- May 11, 2001
+       DESCRIPTION  "Registration of new IANAifType
+                     197."
+
+       REVISION     "200101120000Z"  -- Jan 12, 2001
+       DESCRIPTION  "Registration of new IANAifTypes
+                     195 and 196."
+
+       REVISION     "200012190000Z"  -- Dec 19, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     193 and 194."
+
+       REVISION     "200012070000Z"  -- Dec 07, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     191 and 192."
+
+       REVISION     "200012040000Z"  -- Dec 04, 2000
+       DESCRIPTION  "Registration of new IANAifType
+                     190."
+
+       REVISION     "200010170000Z"  -- Oct 17, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     188 and 189."  
+
+       REVISION     "200010020000Z"  -- Oct 02, 2000
+       DESCRIPTION  "Registration of new IANAifType 187." 
+
+       REVISION     "200009010000Z"  -- Sept 01, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     184, 185, and 186."			
+
+       REVISION     "200008240000Z"  -- Aug 24, 2000
+       DESCRIPTION  "Registration of new IANAifType 183." 
+
+       REVISION     "200008230000Z"  -- Aug 23, 2000
+       DESCRIPTION  "Registration of new IANAifTypes
+                     174-182."
+
+       REVISION     "200008220000Z"  -- Aug 22, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 170,
+                     171, 172 and 173."
+
+       REVISION     "200004250000Z"  -- Apr 25, 2000
+       DESCRIPTION  "Registration of new IANAifTypes 168 and 169."       
+
+       REVISION     "200003060000Z"  -- Mar 6, 2000
+       DESCRIPTION  "Fixed a missing semi-colon in the IMPORT.
+                     Also cleaned up the REVISION log a bit.
+                     It is not complete, but from now on it will
+                     be maintained and kept up to date with each
+                     change to this MIB module."
+
+       REVISION     "199910081430Z"  -- Oct 08, 1999
+       DESCRIPTION  "Include new name assignments up to cnr(85).
+                     This is the first version available via the WWW
+                     at: ftp://ftp.isi.edu/mib/ianaiftype.mib"
+
+       REVISION     "199401310000Z"  -- Jan 31, 1994
+       DESCRIPTION  "Initial version of this MIB as published in
+                     RFC 1573."
+       ::= { mib-2 30 }
+
+   IANAifType ::= TEXTUAL-CONVENTION
+       STATUS       current
+       DESCRIPTION
+               "This data type is used as the syntax of the ifType
+               object in the (updated) definition of MIB-II's
+               ifTable.
+
+               The definition of this textual convention with the
+               addition of newly assigned values is published
+               periodically by the IANA, in either the Assigned
+               Numbers RFC, or some derivative of it specific to
+               Internet Network Management number assignments.  (The
+               latest arrangements can be obtained by contacting the
+               IANA.)
+
+               Requests for new values should be made to IANA via
+               email (iana&iana.org).
+
+               The relationship between the assignment of ifType
+               values and of OIDs to particular media-specific MIBs
+               is solely the purview of IANA and is subject to change
+               without notice.  Quite often, a media-specific MIB's
+               OID-subtree assignment within MIB-II's 'transmission'
+               subtree will be the same as its ifType value.
+               However, in some circumstances this will not be the
+               case, and implementors must not pre-assume any
+               specific relationship between ifType values and
+               transmission subtree OIDs."
+       SYNTAX  INTEGER {
+                   other(1),          -- none of the following
+                   regular1822(2),
+                   hdh1822(3),
+                   ddnX25(4),
+                   rfc877x25(5),
+                   ethernetCsmacd(6), -- for all ethernet-like interfaces,
+                                      -- regardless of speed, as per RFC3635
+                   iso88023Csmacd(7), -- Deprecated via RFC3635
+                                      -- ethernetCsmacd (6) should be used instead
+                   iso88024TokenBus(8),
+                   iso88025TokenRing(9),
+                   iso88026Man(10),
+                   starLan(11), -- Deprecated via RFC3635
+                                -- ethernetCsmacd (6) should be used instead
+                   proteon10Mbit(12),
+                   proteon80Mbit(13),
+                   hyperchannel(14),
+                   fddi(15),
+                   lapb(16),
+                   sdlc(17),
+                   ds1(18),            -- DS1-MIB
+                   e1(19),             -- Obsolete see DS1-MIB
+                   basicISDN(20),              -- no longer used
+                                               -- see also RFC2127
+                   primaryISDN(21),            -- no longer used
+                                               -- see also RFC2127
+                   propPointToPointSerial(22), -- proprietary serial
+                   ppp(23),
+                   softwareLoopback(24),
+                   eon(25),            -- CLNP over IP 
+                   ethernet3Mbit(26),
+                   nsip(27),           -- XNS over IP
+                   slip(28),           -- generic SLIP
+                   ultra(29),          -- ULTRA technologies
+                   ds3(30),            -- DS3-MIB
+                   sip(31),            -- SMDS, coffee
+                   frameRelay(32),     -- DTE only. 
+                   rs232(33),
+                   para(34),           -- parallel-port
+                   arcnet(35),         -- arcnet
+                   arcnetPlus(36),     -- arcnet plus
+                   atm(37),            -- ATM cells
+                   miox25(38),
+                   sonet(39),          -- SONET or SDH 
+                   x25ple(40),
+                   iso88022llc(41),
+                   localTalk(42),
+                   smdsDxi(43),
+                   frameRelayService(44),  -- FRNETSERV-MIB
+                   v35(45),
+                   hssi(46),
+                   hippi(47),
+                   modem(48),          -- Generic modem
+                   aal5(49),           -- AAL5 over ATM
+                   sonetPath(50),
+                   sonetVT(51),
+                   smdsIcip(52),       -- SMDS InterCarrier Interface
+                   propVirtual(53),    -- proprietary virtual/internal
+                   propMultiplexor(54),-- proprietary multiplexing
+                   ieee80212(55),      -- 100BaseVG
+                   fibreChannel(56),   -- Fibre Channel
+                   hippiInterface(57), -- HIPPI interfaces     
+                   frameRelayInterconnect(58), -- Obsolete, use either
+                                       -- frameRelay(32) or 
+                                       -- frameRelayService(44).
+                   aflane8023(59),     -- ATM Emulated LAN for 802.3
+                   aflane8025(60),     -- ATM Emulated LAN for 802.5
+                   cctEmul(61),        -- ATM Emulated circuit          
+                   fastEther(62),      -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   isdn(63),           -- ISDN and X.25           
+                   v11(64),            -- CCITT V.11/X.21             
+                   v36(65),            -- CCITT V.36                  
+                   g703at64k(66),      -- CCITT G703 at 64Kbps
+                   g703at2mb(67),      -- Obsolete see DS1-MIB
+                   qllc(68),           -- SNA QLLC                    
+                   fastEtherFX(69),    -- Obsoleted via RFC3635
+                                       -- ethernetCsmacd (6) should be used instead
+                   channel(70),        -- channel                     
+                   ieee80211(71),      -- radio spread spectrum       
+                   ibm370parChan(72),  -- IBM System 360/370 OEMI Channel
+                   escon(73),          -- IBM Enterprise Systems Connection
+                   dlsw(74),           -- Data Link Switching
+                   isdns(75),          -- ISDN S/T interface
+                   isdnu(76),          -- ISDN U interface
+                   lapd(77),           -- Link Access Protocol D
+                   ipSwitch(78),       -- IP Switching Objects
+                   rsrb(79),           -- Remote Source Route Bridging
+                   atmLogical(80),     -- ATM Logical Port
+                   ds0(81),            -- Digital Signal Level 0
+                   ds0Bundle(82),      -- group of ds0s on the same ds1
+                   bsc(83),            -- Bisynchronous Protocol
+                   async(84),          -- Asynchronous Protocol
+                   cnr(85),            -- Combat Net Radio
+                   iso88025Dtr(86),    -- ISO 802.5r DTR
+                   eplrs(87),          -- Ext Pos Loc Report Sys
+                   arap(88),           -- Appletalk Remote Access Protocol
+                   propCnls(89),       -- Proprietary Connectionless Protocol
+                   hostPad(90),        -- CCITT-ITU X.29 PAD Protocol
+                   termPad(91),        -- CCITT-ITU X.3 PAD Facility
+                   frameRelayMPI(92),  -- Multiproto Interconnect over FR
+                   x213(93),           -- CCITT-ITU X213
+                   adsl(94),           -- Asymmetric Digital Subscriber Loop
+                   radsl(95),          -- Rate-Adapt. Digital Subscriber Loop
+                   sdsl(96),           -- Symmetric Digital Subscriber Loop
+                   vdsl(97),           -- Very H-Speed Digital Subscrib. Loop
+                   iso88025CRFPInt(98), -- ISO 802.5 CRFP
+                   myrinet(99),        -- Myricom Myrinet
+                   voiceEM(100),       -- voice recEive and transMit
+                   voiceFXO(101),      -- voice Foreign Exchange Office
+                   voiceFXS(102),      -- voice Foreign Exchange Station
+                   voiceEncap(103),    -- voice encapsulation
+                   voiceOverIp(104),   -- voice over IP encapsulation
+                   atmDxi(105),        -- ATM DXI
+                   atmFuni(106),       -- ATM FUNI
+                   atmIma (107),       -- ATM IMA		   
+                   pppMultilinkBundle(108), -- PPP Multilink Bundle
+                   ipOverCdlc (109),   -- IBM ipOverCdlc
+                   ipOverClaw (110),   -- IBM Common Link Access to Workstn
+                   stackToStack (111), -- IBM stackToStack
+                   virtualIpAddress (112), -- IBM VIPA
+                   mpc (113),          -- IBM multi-protocol channel support
+                   ipOverAtm (114),    -- IBM ipOverAtm
+                   iso88025Fiber (115), -- ISO 802.5j Fiber Token Ring
+                   tdlc (116),	       -- IBM twinaxial data link control
+                   gigabitEthernet (117), -- Obsoleted via RFC3635
+                                          -- ethernetCsmacd (6) should be used instead
+                   hdlc (118),         -- HDLC
+                   lapf (119),	       -- LAP F
+                   v37 (120),	       -- V.37
+                   x25mlp (121),       -- Multi-Link Protocol
+                   x25huntGroup (122), -- X25 Hunt Group
+                   transpHdlc (123),   -- Transp HDLC
+                   interleave (124),   -- Interleave channel
+                   fast (125),         -- Fast channel
+                   ip (126),	       -- IP (for APPN HPR in IP networks)
+                   docsCableMaclayer (127),  -- CATV Mac Layer
+                   docsCableDownstream (128), -- CATV Downstream interface
+                   docsCableUpstream (129),  -- CATV Upstream interface
+                   a12MppSwitch (130), -- Avalon Parallel Processor
+                   tunnel (131),       -- Encapsulation interface
+                   coffee (132),       -- coffee pot
+                   ces (133),          -- Circuit Emulation Service
+                   atmSubInterface (134), -- ATM Sub Interface
+                   l2vlan (135),       -- Layer 2 Virtual LAN using 802.1Q
+                   l3ipvlan (136),     -- Layer 3 Virtual LAN using IP
+                   l3ipxvlan (137),    -- Layer 3 Virtual LAN using IPX
+                   digitalPowerline (138), -- IP over Power Lines	
+                   mediaMailOverIp (139), -- Multimedia Mail over IP
+                   dtm (140),        -- Dynamic syncronous Transfer Mode
+                   dcn (141),    -- Data Communications Network
+                   ipForward (142),    -- IP Forwarding Interface
+                   msdsl (143),       -- Multi-rate Symmetric DSL
+                   ieee1394 (144), -- IEEE1394 High Performance Serial Bus
+                   if-gsn (145),       --   HIPPI-6400 
+                   dvbRccMacLayer (146), -- DVB-RCC MAC Layer
+                   dvbRccDownstream (147),  -- DVB-RCC Downstream Channel
+                   dvbRccUpstream (148),  -- DVB-RCC Upstream Channel
+                   atmVirtual (149),   -- ATM Virtual Interface
+                   mplsTunnel (150),   -- MPLS Tunnel Virtual Interface
+                   srp (151),	-- Spatial Reuse Protocol	
+                   voiceOverAtm (152),  -- Voice Over ATM
+                   voiceOverFrameRelay (153),   -- Voice Over Frame Relay 
+                   idsl (154),		-- Digital Subscriber Loop over ISDN
+                   compositeLink (155),  -- Avici Composite Link Interface
+                   ss7SigLink (156),     -- SS7 Signaling Link 
+                   propWirelessP2P (157),  --  Prop. P2P wireless interface
+                   frForward (158),    -- Frame Forward Interface
+                   rfc1483 (159),	-- Multiprotocol over ATM AAL5
+                   usb (160),		-- USB Interface
+                   ieee8023adLag (161),  -- IEEE 802.3ad Link Aggregate
+                   bgppolicyaccounting (162), -- BGP Policy Accounting
+                   frf16MfrBundle (163), -- FRF .16 Multilink Frame Relay 
+                   h323Gatekeeper (164), -- H323 Gatekeeper
+                   h323Proxy (165), -- H323 Voice and Video Proxy
+                   mpls (166), -- MPLS                   
+                   mfSigLink (167), -- Multi-frequency signaling link
+                   hdsl2 (168), -- High Bit-Rate DSL - 2nd generation
+                   shdsl (169), -- Multirate HDSL2
+                   ds1FDL (170), -- Facility Data Link 4Kbps on a DS1
+                   pos (171), -- Packet over SONET/SDH Interface
+                   dvbAsiIn (172), -- DVB-ASI Input
+                   dvbAsiOut (173), -- DVB-ASI Output 
+                   plc (174), -- Power Line Communtications
+                   nfas (175), -- Non Facility Associated Signaling
+                   tr008 (176), -- TR008
+                   gr303RDT (177), -- Remote Digital Terminal
+                   gr303IDT (178), -- Integrated Digital Terminal
+                   isup (179), -- ISUP
+                   propDocsWirelessMaclayer (180), -- Cisco proprietary Maclayer
+                   propDocsWirelessDownstream (181), -- Cisco proprietary Downstream
+                   propDocsWirelessUpstream (182), -- Cisco proprietary Upstream
+                   hiperlan2 (183), -- HIPERLAN Type 2 Radio Interface
+                   propBWAp2Mp (184), -- PropBroadbandWirelessAccesspt2multipt
+                             -- use of this iftype for IEEE 802.16 WMAN
+                             -- interfaces as per IEEE Std 802.16f is
+                             -- deprecated and ifType 237 should be used instead.
+                   sonetOverheadChannel (185), -- SONET Overhead Channel
+                   digitalWrapperOverheadChannel (186), -- Digital Wrapper
+                   aal2 (187), -- ATM adaptation layer 2
+                   radioMAC (188), -- MAC layer over radio links
+                   atmRadio (189), -- ATM over radio links   
+                   imt (190), -- Inter Machine Trunks
+                   mvl (191), -- Multiple Virtual Lines DSL
+                   reachDSL (192), -- Long Reach DSL
+                   frDlciEndPt (193), -- Frame Relay DLCI End Point
+                   atmVciEndPt (194), -- ATM VCI End Point
+                   opticalChannel (195), -- Optical Channel
+                   opticalTransport (196), -- Optical Transport
+                   propAtm (197), --  Proprietary ATM       
+                   voiceOverCable (198), -- Voice Over Cable Interface
+                   infiniband (199), -- Infiniband
+                   teLink (200), -- TE Link
+                   q2931 (201), -- Q.2931
+                   virtualTg (202), -- Virtual Trunk Group
+                   sipTg (203), -- SIP Trunk Group
+                   sipSig (204), -- SIP Signaling   
+                   docsCableUpstreamChannel (205), -- CATV Upstream Channel
+                   econet (206), -- Acorn Econet
+                   pon155 (207), -- FSAN 155Mb Symetrical PON interface
+                   pon622 (208), -- FSAN622Mb Symetrical PON interface
+                   bridge (209), -- Transparent bridge interface
+                   linegroup (210), -- Interface common to multiple lines   
+                   voiceEMFGD (211), -- voice E&M Feature Group D
+                   voiceFGDEANA (212), -- voice FGD Exchange Access North American
+                   voiceDID (213), -- voice Direct Inward Dialing
+                   mpegTransport (214), -- MPEG transport interface
+                   sixToFour (215), -- 6to4 interface (DEPRECATED)
+                   gtp (216), -- GTP (GPRS Tunneling Protocol)
+                   pdnEtherLoop1 (217), -- Paradyne EtherLoop 1
+                   pdnEtherLoop2 (218), -- Paradyne EtherLoop 2
+                   opticalChannelGroup (219), -- Optical Channel Group
+                   homepna (220), -- HomePNA ITU-T G.989
+                   gfp (221), -- Generic Framing Procedure (GFP)
+                   ciscoISLvlan (222), -- Layer 2 Virtual LAN using Cisco ISL
+                   actelisMetaLOOP (223), -- Acteleis proprietary MetaLOOP High Speed Link 
+                   fcipLink (224), -- FCIP Link 
+                   rpr (225), -- Resilient Packet Ring Interface Type
+                   qam (226), -- RF Qam Interface
+                   lmp (227), -- Link Management Protocol
+                   cblVectaStar (228), -- Cambridge Broadband Networks Limited VectaStar
+                   docsCableMCmtsDownstream (229), -- CATV Modular CMTS Downstream Interface
+                   adsl2 (230), -- Asymmetric Digital Subscriber Loop Version 2 
+                                -- (DEPRECATED/OBSOLETED - please use adsl2plus 238 instead)
+                   macSecControlledIF (231), -- MACSecControlled 
+                   macSecUncontrolledIF (232), -- MACSecUncontrolled
+                   aviciOpticalEther (233), -- Avici Optical Ethernet Aggregate
+                   atmbond (234), -- atmbond
+                   voiceFGDOS (235), -- voice FGD Operator Services
+                   mocaVersion1 (236), -- MultiMedia over Coax Alliance (MoCA) Interface
+                             -- as documented in information provided privately to IANA
+                   ieee80216WMAN (237), -- IEEE 802.16 WMAN interface
+                   adsl2plus (238), -- Asymmetric Digital Subscriber Loop Version 2, 
+                                   -- Version 2 Plus and all variants
+                   dvbRcsMacLayer (239), -- DVB-RCS MAC Layer
+                   dvbTdm (240), -- DVB Satellite TDM
+                   dvbRcsTdma (241), -- DVB-RCS TDMA
+                   x86Laps (242), -- LAPS based on ITU-T X.86/Y.1323
+                   wwanPP (243), -- 3GPP WWAN
+                   wwanPP2 (244), -- 3GPP2 WWAN
+                   voiceEBS (245), -- voice P-phone EBS physical interface
+                   ifPwType (246), -- Pseudowire interface type
+                   ilan (247), -- Internal LAN on a bridge per IEEE 802.1ap
+                   pip (248), -- Provider Instance Port on a bridge per IEEE 802.1ah PBB
+                   aluELP (249), -- Alcatel-Lucent Ethernet Link Protection
+                   gpon (250), -- Gigabit-capable passive optical networks (G-PON) as per ITU-T G.948
+                   vdsl2 (251), -- Very high speed digital subscriber line Version 2 (as per ITU-T Recommendation G.993.2)
+                   capwapDot11Profile (252), -- WLAN Profile Interface
+                   capwapDot11Bss (253), -- WLAN BSS Interface
+                   capwapWtpVirtualRadio (254), -- WTP Virtual Radio Interface
+                   bits (255), -- bitsport
+                   docsCableUpstreamRfPort (256), -- DOCSIS CATV Upstream RF Port
+                   cableDownstreamRfPort (257), -- CATV downstream RF port
+                   vmwareVirtualNic (258), -- VMware Virtual Network Interface
+                   ieee802154 (259), -- IEEE 802.15.4 WPAN interface
+                   otnOdu (260), -- OTN Optical Data Unit
+                   otnOtu (261), -- OTN Optical channel Transport Unit
+                   ifVfiType (262), -- VPLS Forwarding Instance Interface Type
+                   g9981 (263), -- G.998.1 bonded interface
+                   g9982 (264), -- G.998.2 bonded interface
+                   g9983 (265), -- G.998.3 bonded interface
+                   aluEpon (266), -- Ethernet Passive Optical Networks (E-PON)
+                   aluEponOnu (267), -- EPON Optical Network Unit
+                   aluEponPhysicalUni (268), -- EPON physical User to Network interface
+                   aluEponLogicalLink (269), -- The emulation of a point-to-point link over the EPON layer
+                   aluGponOnu (270), -- GPON Optical Network Unit
+                   aluGponPhysicalUni (271), -- GPON physical User to Network interface
+                   vmwareNicTeam (272) -- VMware NIC Team
+                   }
+
+IANAtunnelType ::= TEXTUAL-CONVENTION
+    STATUS     current
+    DESCRIPTION
+            "The encapsulation method used by a tunnel. The value
+            direct indicates that a packet is encapsulated
+            directly within a normal IP header, with no
+            intermediate header, and unicast to the remote tunnel
+            endpoint (e.g., an RFC 2003 IP-in-IP tunnel, or an RFC
+            1933 IPv6-in-IPv4 tunnel). The value minimal indicates
+            that a Minimal Forwarding Header (RFC 2004) is
+            inserted between the outer header and the payload
+            packet. The value UDP indicates that the payload
+            packet is encapsulated within a normal UDP packet
+            (e.g., RFC 1234).
+
+            The values sixToFour, sixOverFour, and isatap
+            indicates that an IPv6 packet is encapsulated directly
+            within an IPv4 header, with no intermediate header,
+            and unicast to the destination determined by the 6to4,
+            6over4, or ISATAP protocol.
+
+            The remaining protocol-specific values indicate that a
+            header of the protocol of that name is inserted
+            between the outer header and the payload header.
+
+            The assignment policy for IANAtunnelType values is
+            identical to the policy for assigning IANAifType
+            values."
+    SYNTAX     INTEGER {
+                   other(1),        -- none of the following
+                   direct(2),       -- no intermediate header
+                   gre(3),          -- GRE encapsulation
+                   minimal(4),      -- Minimal encapsulation
+                   l2tp(5),         -- L2TP encapsulation
+                   pptp(6),         -- PPTP encapsulation
+                   l2f(7),          -- L2F encapsulation
+                   udp(8),          -- UDP encapsulation
+                   atmp(9),         -- ATMP encapsulation
+                   msdp(10),        -- MSDP encapsulation
+                   sixToFour(11),   -- 6to4 encapsulation
+                   sixOverFour(12), -- 6over4 encapsulation
+                   isatap(13),      -- ISATAP encapsulation
+                   teredo(14),      -- Teredo encapsulation
+                   ipHttps(15)      -- IPHTTPS
+               }
+
+   END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..7704f0c257ec0769badc84b0591c06c893e7b001
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/IF-MIB.txt
@@ -0,0 +1,1814 @@
+IF-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64,
+    Integer32, TimeTicks, mib-2,
+    NOTIFICATION-TYPE                        FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION, DisplayString,
+    PhysAddress, TruthValue, RowStatus,
+    TimeStamp, AutonomousType, TestAndIncr   FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP,
+    NOTIFICATION-GROUP                       FROM SNMPv2-CONF
+    snmpTraps                                FROM SNMPv2-MIB
+    IANAifType                               FROM IANAifType-MIB;
+
+ifMIB MODULE-IDENTITY
+    LAST-UPDATED "200006140000Z"
+    ORGANIZATION "IETF Interfaces MIB Working Group"
+    CONTACT-INFO
+            "   Keith McCloghrie
+                Cisco Systems, Inc.
+                170 West Tasman Drive
+                San Jose, CA  95134-1706
+                US
+
+                408-526-5260
+                kzm@cisco.com"
+    DESCRIPTION
+            "The MIB module to describe generic objects for network
+            interface sub-layers.  This MIB is an updated version of
+            MIB-II's ifTable, and incorporates the extensions defined in
+            RFC 1229."
+
+    REVISION      "200006140000Z"
+    DESCRIPTION
+            "Clarifications agreed upon by the Interfaces MIB WG, and
+            published as RFC 2863."
+    REVISION      "199602282155Z"
+    DESCRIPTION
+            "Revisions made by the Interfaces MIB WG, and published in
+            RFC 2233."
+    REVISION      "199311082155Z"
+    DESCRIPTION
+            "Initial revision, published as part of RFC 1573."
+    ::= { mib-2 31 }
+
+ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
+
+interfaces   OBJECT IDENTIFIER ::= { mib-2 2 }
+
+--
+-- Textual Conventions
+--
+
+-- OwnerString has the same semantics as used in RFC 1271
+
+OwnerString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       deprecated
+    DESCRIPTION
+            "This data type is used to model an administratively
+            assigned name of the owner of a resource.  This information
+            is taken from the NVT ASCII character set.  It is suggested
+            that this name contain one or more of the following: ASCII
+            form of the manager station's transport address, management
+            station name (e.g., domain name), network management
+            personnel's name, location, or phone number.  In some cases
+            the agent itself will be the owner of an entry.  In these
+            cases, this string shall be set to a string starting with
+            'agent'."
+    SYNTAX       OCTET STRING (SIZE(0..255))
+
+-- InterfaceIndex contains the semantics of ifIndex and should be used
+-- for any objects defined in other MIB modules that need these semantics.
+
+InterfaceIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface or
+            interface sub-layer in the managed system.  It is
+            recommended that values are assigned contiguously starting
+            from 1.  The value for each interface sub-layer must remain
+            constant at least from one re-initialization of the entity's
+            network management system to the next re-initialization."
+    SYNTAX       Integer32 (1..2147483647)
+
+InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+            "This textual convention is an extension of the
+            InterfaceIndex convention.  The latter defines a greater
+            than zero value used to identify an interface or interface
+            sub-layer in the managed system.  This extension permits the
+            additional value of zero.  the value zero is object-specific
+            and must therefore be defined as part of the description of
+            any object which uses this syntax.  Examples of the usage of
+            zero might include situations where interface was unknown,
+            or when none or all interfaces need to be referenced."
+    SYNTAX       Integer32 (0..2147483647)
+
+ifNumber  OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of network interfaces (regardless of their
+            current state) present on this system."
+    ::= { interfaces 1 }
+
+ifTableLastChange  OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last creation or
+            deletion of an entry in the ifTable.  If the number of
+            entries has been unchanged since the last re-initialization
+            of the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 5 }
+
+-- the Interfaces table
+
+-- The Interfaces table contains information on the entity's
+
+-- interfaces.  Each sub-layer below the internetwork-layer
+-- of a network interface is considered to be an interface.
+
+ifTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber."
+    ::= { interfaces 2 }
+
+ifEntry OBJECT-TYPE
+    SYNTAX      IfEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing management information applicable to a
+            particular interface."
+    INDEX   { ifIndex }
+    ::= { ifTable 1 }
+
+IfEntry ::=
+    SEQUENCE {
+        ifIndex                 InterfaceIndex,
+        ifDescr                 DisplayString,
+        ifType                  IANAifType,
+        ifMtu                   Integer32,
+        ifSpeed                 Gauge32,
+        ifPhysAddress           PhysAddress,
+        ifAdminStatus           INTEGER,
+        ifOperStatus            INTEGER,
+        ifLastChange            TimeTicks,
+        ifInOctets              Counter32,
+        ifInUcastPkts           Counter32,
+        ifInNUcastPkts          Counter32,  -- deprecated
+        ifInDiscards            Counter32,
+        ifInErrors              Counter32,
+        ifInUnknownProtos       Counter32,
+        ifOutOctets             Counter32,
+        ifOutUcastPkts          Counter32,
+        ifOutNUcastPkts         Counter32,  -- deprecated
+        ifOutDiscards           Counter32,
+        ifOutErrors             Counter32,
+        ifOutQLen               Gauge32,    -- deprecated
+        ifSpecific              OBJECT IDENTIFIER -- deprecated
+    }
+
+ifIndex OBJECT-TYPE
+    SYNTAX      InterfaceIndex
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A unique value, greater than zero, for each interface.  It
+            is recommended that values are assigned contiguously
+            starting from 1.  The value for each interface sub-layer
+            must remain constant at least from one re-initialization of
+            the entity's network management system to the next re-
+            initialization."
+    ::= { ifEntry 1 }
+
+ifDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual string containing information about the
+            interface.  This string should include the name of the
+            manufacturer, the product name and the version of the
+            interface hardware/software."
+    ::= { ifEntry 2 }
+
+ifType OBJECT-TYPE
+    SYNTAX      IANAifType
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The type of interface.  Additional values for ifType are
+            assigned by the Internet Assigned Numbers Authority (IANA),
+            through updating the syntax of the IANAifType textual
+            convention."
+    ::= { ifEntry 3 }
+
+ifMtu OBJECT-TYPE
+    SYNTAX      Integer32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The size of the largest packet which can be sent/received
+            on the interface, specified in octets.  For interfaces that
+            are used for transmitting network datagrams, this is the
+            size of the largest network datagram that can be sent on the
+            interface."
+    ::= { ifEntry 4 }
+
+ifSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in bits
+            per second.  For interfaces which do not vary in bandwidth
+            or for those where no accurate estimation can be made, this
+            object should contain the nominal bandwidth.  If the
+            bandwidth of the interface is greater than the maximum value
+            reportable by this object then this object should report its
+            maximum value (4,294,967,295) and ifHighSpeed must be used
+            to report the interace's speed.  For a sub-layer which has
+            no concept of bandwidth, this object should be zero."
+    ::= { ifEntry 5 }
+
+ifPhysAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The interface's address at its protocol sub-layer.  For
+            example, for an 802.x interface, this object normally
+            contains a MAC address.  The interface's media-specific MIB
+            must define the bit and byte ordering and the format of the
+            value of this object.  For interfaces which do not have such
+            an address (e.g., a serial line), this object should contain
+            an octet string of zero length."
+    ::= { ifEntry 6 }
+
+ifAdminStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),       -- ready to pass packets
+                down(2),
+                testing(3)   -- in some test mode
+            }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The desired state of the interface.  The testing(3) state
+            indicates that no operational packets can be passed.  When a
+            managed system initializes, all interfaces start with
+            ifAdminStatus in the down(2) state.  As a result of either
+            explicit management action or per configuration information
+            retained by the managed system, ifAdminStatus is then
+            changed to either the up(1) or testing(3) states (or remains
+            in the down(2) state)."
+    ::= { ifEntry 7 }
+
+ifOperStatus OBJECT-TYPE
+    SYNTAX  INTEGER {
+                up(1),        -- ready to pass packets
+                down(2),
+                testing(3),   -- in some test mode
+                unknown(4),   -- status can not be determined
+                              -- for some reason.
+                dormant(5),
+                notPresent(6),    -- some component is missing
+                lowerLayerDown(7) -- down due to state of
+                                  -- lower-layer interface(s)
+            }
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The current operational state of the interface.  The
+            testing(3) state indicates that no operational packets can
+            be passed.  If ifAdminStatus is down(2) then ifOperStatus
+            should be down(2).  If ifAdminStatus is changed to up(1)
+            then ifOperStatus should change to up(1) if the interface is
+            ready to transmit and receive network traffic; it should
+            change to dormant(5) if the interface is waiting for
+            external actions (such as a serial line waiting for an
+            incoming connection); it should remain in the down(2) state
+            if and only if there is a fault that prevents it from going
+            to the up(1) state; it should remain in the notPresent(6)
+            state if the interface has missing (typically, hardware)
+            components."
+    ::= { ifEntry 8 }
+
+ifLastChange OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime at the time the interface entered
+            its current operational state.  If the current state was
+            entered prior to the last re-initialization of the local
+            network management subsystem, then this object contains a
+            zero value."
+    ::= { ifEntry 9 }
+
+ifInOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 10 }
+
+ifInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 11 }
+
+ifInNUcastPkts OBJECT-TYPE
+    SYNTAX  Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast or
+            broadcast address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifInMulticastPkts and
+            ifInBroadcastPkts."
+    ::= { ifEntry 12 }
+
+ifInDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of inbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+
+            their being deliverable to a higher-layer protocol.  One
+            possible reason for discarding such a packet could be to
+            free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 13 }
+
+ifInErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of inbound
+            packets that contained errors preventing them from being
+            deliverable to a higher-layer protocol.  For character-
+            oriented or fixed-length interfaces, the number of inbound
+            transmission units that contained errors preventing them
+            from being deliverable to a higher-layer protocol.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 14 }
+
+ifInUnknownProtos OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of packets
+            received via the interface which were discarded because of
+            an unknown or unsupported protocol.  For character-oriented
+            or fixed-length interfaces that support protocol
+            multiplexing the number of transmission units received via
+            the interface which were discarded because of an unknown or
+            unsupported protocol.  For any interface that does not
+            support protocol multiplexing, this counter will always be
+            0.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 15 }
+
+ifOutOctets OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 16 }
+
+ifOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 17 }
+
+ifOutNUcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime.
+
+            This object is deprecated in favour of ifOutMulticastPkts
+            and ifOutBroadcastPkts."
+    ::= { ifEntry 18 }
+
+ifOutDiscards OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of outbound packets which were chosen to be
+            discarded even though no errors had been detected to prevent
+            their being transmitted.  One possible reason for discarding
+            such a packet could be to free up buffer space.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 19 }
+
+ifOutErrors OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "For packet-oriented interfaces, the number of outbound
+            packets that could not be transmitted because of errors.
+            For character-oriented or fixed-length interfaces, the
+            number of outbound transmission units that could not be
+            transmitted because of errors.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifEntry 20 }
+
+ifOutQLen OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "The length of the output packet queue (in packets)."
+    ::= { ifEntry 21 }
+
+ifSpecific OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      deprecated
+    DESCRIPTION
+            "A reference to MIB definitions specific to the particular
+            media being used to realize the interface.  It is
+
+            recommended that this value point to an instance of a MIB
+            object in the media-specific MIB, i.e., that this object
+            have the semantics associated with the InstancePointer
+            textual convention defined in RFC 2579.  In fact, it is
+            recommended that the media-specific MIB specify what value
+            ifSpecific should/can take for values of ifType.  If no MIB
+            definitions specific to the particular media are available,
+            the value should be set to the OBJECT IDENTIFIER { 0 0 }."
+    ::= { ifEntry 22 }
+
+--
+--   Extension to the interface table
+--
+-- This table replaces the ifExtnsTable table.
+--
+
+ifXTable        OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of interface entries.  The number of entries is
+            given by the value of ifNumber.  This table contains
+            additional objects for the interface table."
+    ::= { ifMIBObjects 1 }
+
+ifXEntry        OBJECT-TYPE
+    SYNTAX      IfXEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An entry containing additional management information
+            applicable to a particular interface."
+    AUGMENTS    { ifEntry }
+    ::= { ifXTable 1 }
+
+IfXEntry ::=
+    SEQUENCE {
+        ifName                  DisplayString,
+        ifInMulticastPkts       Counter32,
+        ifInBroadcastPkts       Counter32,
+        ifOutMulticastPkts      Counter32,
+        ifOutBroadcastPkts      Counter32,
+        ifHCInOctets            Counter64,
+        ifHCInUcastPkts         Counter64,
+        ifHCInMulticastPkts     Counter64,
+        ifHCInBroadcastPkts     Counter64,
+        ifHCOutOctets           Counter64,
+        ifHCOutUcastPkts        Counter64,
+        ifHCOutMulticastPkts    Counter64,
+        ifHCOutBroadcastPkts    Counter64,
+        ifLinkUpDownTrapEnable  INTEGER,
+        ifHighSpeed             Gauge32,
+        ifPromiscuousMode       TruthValue,
+        ifConnectorPresent      TruthValue,
+        ifAlias                 DisplayString,
+        ifCounterDiscontinuityTime TimeStamp
+    }
+
+ifName OBJECT-TYPE
+    SYNTAX      DisplayString
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The textual name of the interface.  The value of this
+            object should be the name of the interface as assigned by
+            the local device and should be suitable for use in commands
+            entered at the device's `console'.  This might be a text
+            name, such as `le0' or a simple port number, such as `1',
+            depending on the interface naming syntax of the device.  If
+            several entries in the ifTable together represent a single
+            interface as named by the device, then each will have the
+            same value of ifName.  Note that for an agent which responds
+            to SNMP queries concerning an interface on some other
+            (proxied) device, then the value of ifName for such an
+            interface is the proxied device's local name for it.
+
+            If there is no local name, or this object is otherwise not
+            applicable, then this object contains a zero-length string."
+    ::= { ifXEntry 1 }
+
+ifInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 2 }
+
+ifInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 3 }
+
+ifOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 4 }
+
+ifOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 5 }
+
+--
+-- High Capacity Counter objects.  These objects are all
+-- 64 bit versions of the "basic" ifTable counters.  These
+-- objects all have the same basic semantics as their 32-bit
+-- counterparts, however, their syntax has been extended
+-- to 64 bits.
+--
+
+ifHCInOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets received on the interface,
+            including framing characters.  This object is a 64-bit
+            version of ifInOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 6 }
+
+ifHCInUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were not addressed to a multicast
+            or broadcast address at this sub-layer.  This object is a
+            64-bit version of ifInUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 7 }
+
+ifHCInMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a multicast
+            address at this sub-layer.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifInMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 8 }
+
+ifHCInBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The number of packets, delivered by this sub-layer to a
+            higher (sub-)layer, which were addressed to a broadcast
+            address at this sub-layer.  This object is a 64-bit version
+            of ifInBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 9 }
+
+ifHCOutOctets OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of octets transmitted out of the
+            interface, including framing characters.  This object is a
+            64-bit version of ifOutOctets.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 10 }
+
+ifHCOutUcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were not addressed to a
+            multicast or broadcast address at this sub-layer, including
+            those that were discarded or not sent.  This object is a
+            64-bit version of ifOutUcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 11 }
+
+ifHCOutMulticastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            multicast address at this sub-layer, including those that
+            were discarded or not sent.  For a MAC layer protocol, this
+            includes both Group and Functional addresses.  This object
+            is a 64-bit version of ifOutMulticastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 12 }
+
+ifHCOutBroadcastPkts OBJECT-TYPE
+    SYNTAX      Counter64
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The total number of packets that higher-level protocols
+            requested be transmitted, and which were addressed to a
+            broadcast address at this sub-layer, including those that
+            were discarded or not sent.  This object is a 64-bit version
+            of ifOutBroadcastPkts.
+
+            Discontinuities in the value of this counter can occur at
+            re-initialization of the management system, and at other
+            times as indicated by the value of
+            ifCounterDiscontinuityTime."
+    ::= { ifXEntry 13 }
+
+ifLinkUpDownTrapEnable  OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether linkUp/linkDown traps should be generated
+            for this interface.
+
+            By default, this object should have the value enabled(1) for
+            interfaces which do not operate on 'top' of any other
+            interface (as defined in the ifStackTable), and disabled(2)
+            otherwise."
+    ::= { ifXEntry 14 }
+
+ifHighSpeed OBJECT-TYPE
+    SYNTAX      Gauge32
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "An estimate of the interface's current bandwidth in units
+            of 1,000,000 bits per second.  If this object reports a
+            value of `n' then the speed of the interface is somewhere in
+            the range of `n-500,000' to `n+499,999'.  For interfaces
+            which do not vary in bandwidth or for those where no
+            accurate estimation can be made, this object should contain
+            the nominal bandwidth.  For a sub-layer which has no concept
+            of bandwidth, this object should be zero."
+    ::= { ifXEntry 15 }
+
+ifPromiscuousMode  OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object has a value of false(2) if this interface only
+            accepts packets/frames that are addressed to this station.
+            This object has a value of true(1) when the station accepts
+            all packets/frames transmitted on the media.  The value
+            true(1) is only legal on certain types of media.  If legal,
+            setting this object to a value of true(1) may require the
+            interface to be reset before becoming effective.
+
+            The value of ifPromiscuousMode does not affect the reception
+            of broadcast and multicast packets/frames by the interface."
+    ::= { ifXEntry 16 }
+
+ifConnectorPresent   OBJECT-TYPE
+    SYNTAX      TruthValue
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "This object has the value 'true(1)' if the interface
+            sublayer has a physical connector and the value 'false(2)'
+            otherwise."
+    ::= { ifXEntry 17 }
+
+ifAlias   OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE(0..64))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "This object is an 'alias' name for the interface as
+            specified by a network manager, and provides a non-volatile
+            'handle' for the interface.
+
+            On the first instantiation of an interface, the value of
+            ifAlias associated with that interface is the zero-length
+            string.  As and when a value is written into an instance of
+            ifAlias through a network management set operation, then the
+            agent must retain the supplied value in the ifAlias instance
+            associated with the same interface for as long as that
+            interface remains instantiated, including across all re-
+            initializations/reboots of the network management system,
+            including those which result in a change of the interface's
+            ifIndex value.
+
+            An example of the value which a network manager might store
+            in this object for a WAN interface is the (Telco's) circuit
+            number/identifier of the interface.
+
+            Some agents may support write-access only for interfaces
+            having particular values of ifType.  An agent which supports
+            write access to this object is required to keep the value in
+            non-volatile storage, but it may limit the length of new
+            values depending on how much storage is already occupied by
+            the current values for other interfaces."
+    ::= { ifXEntry 18 }
+
+ifCounterDiscontinuityTime OBJECT-TYPE
+    SYNTAX      TimeStamp
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The value of sysUpTime on the most recent occasion at which
+            any one or more of this interface's counters suffered a
+            discontinuity.  The relevant counters are the specific
+            instances associated with this interface of any Counter32 or
+
+            Counter64 object contained in the ifTable or ifXTable.  If
+            no such discontinuities have occurred since the last re-
+            initialization of the local management subsystem, then this
+            object contains a zero value."
+    ::= { ifXEntry 19 }
+
+--           The Interface Stack Group
+--
+-- Implementation of this group is optional, but strongly recommended
+-- for all systems
+--
+
+ifStackTable  OBJECT-TYPE
+     SYNTAX        SEQUENCE OF IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The table containing information on the relationships
+            between the multiple sub-layers of network interfaces.  In
+            particular, it contains information on which sub-layers run
+            'on top of' which other sub-layers, where each sub-layer
+            corresponds to a conceptual row in the ifTable.  For
+            example, when the sub-layer with ifIndex value x runs over
+            the sub-layer with ifIndex value y, then this table
+            contains:
+
+              ifStackStatus.x.y=active
+
+            For each ifIndex value, I, which identifies an active
+            interface, there are always at least two instantiated rows
+            in this table associated with I.  For one of these rows, I
+            is the value of ifStackHigherLayer; for the other, I is the
+            value of ifStackLowerLayer.  (If I is not involved in
+            multiplexing, then these are the only two rows associated
+            with I.)
+
+            For example, two rows exist even for an interface which has
+            no others stacked on top or below it:
+
+              ifStackStatus.0.x=active
+              ifStackStatus.x.0=active "
+     ::= { ifMIBObjects 2 }
+
+ifStackEntry  OBJECT-TYPE
+     SYNTAX        IfStackEntry
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "Information on a particular relationship between two sub-
+            layers, specifying that one sub-layer runs on 'top' of the
+            other sub-layer.  Each sub-layer corresponds to a conceptual
+            row in the ifTable."
+     INDEX { ifStackHigherLayer, ifStackLowerLayer }
+     ::= { ifStackTable 1 }
+
+IfStackEntry ::=
+    SEQUENCE {
+        ifStackHigherLayer  InterfaceIndexOrZero,
+        ifStackLowerLayer   InterfaceIndexOrZero,
+        ifStackStatus       RowStatus
+     }
+
+ifStackHigherLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the higher sub-layer
+            of the relationship, i.e., the sub-layer which runs on 'top'
+            of the sub-layer identified by the corresponding instance of
+            ifStackLowerLayer.  If there is no higher sub-layer (below
+            the internetwork layer), then this object has the value 0."
+     ::= { ifStackEntry 1 }
+
+ifStackLowerLayer  OBJECT-TYPE
+     SYNTAX        InterfaceIndexOrZero
+     MAX-ACCESS    not-accessible
+     STATUS        current
+     DESCRIPTION
+            "The value of ifIndex corresponding to the lower sub-layer
+            of the relationship, i.e., the sub-layer which runs 'below'
+            the sub-layer identified by the corresponding instance of
+            ifStackHigherLayer.  If there is no lower sub-layer, then
+            this object has the value 0."
+     ::= { ifStackEntry 2 }
+
+ifStackStatus  OBJECT-TYPE
+    SYNTAX         RowStatus
+    MAX-ACCESS     read-create
+    STATUS         current
+    DESCRIPTION
+            "The status of the relationship between two sub-layers.
+
+            Changing the value of this object from 'active' to
+            'notInService' or 'destroy' will likely have consequences up
+            and down the interface stack.  Thus, write access to this
+            object is likely to be inappropriate for some types of
+            interfaces, and many implementations will choose not to
+            support write-access for any type of interface."
+    ::= { ifStackEntry 3 }
+
+ifStackLastChange OBJECT-TYPE
+    SYNTAX         TimeTicks
+    MAX-ACCESS     read-only
+    STATUS         current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the last change of
+            the (whole) interface stack.  A change of the interface
+            stack is defined to be any creation, deletion, or change in
+            value of any instance of ifStackStatus.  If the interface
+            stack has been unchanged since the last re-initialization of
+            the local network management subsystem, then this object
+            contains a zero value."
+    ::= { ifMIBObjects 6 }
+
+--   Generic Receive Address Table
+--
+-- This group of objects is mandatory for all types of
+-- interfaces which can receive packets/frames addressed to
+-- more than one address.
+--
+-- This table replaces the ifExtnsRcvAddr table.  The main
+-- difference is that this table makes use of the RowStatus
+-- textual convention, while ifExtnsRcvAddr did not.
+
+ifRcvAddressTable  OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "This table contains an entry for each address (broadcast,
+            multicast, or uni-cast) for which the system will receive
+            packets/frames on a particular interface, except as follows:
+
+            - for an interface operating in promiscuous mode, entries
+            are only required for those addresses for which the system
+            would receive frames were it not operating in promiscuous
+            mode.
+
+            - for 802.5 functional addresses, only one entry is
+            required, for the address which has the functional address
+            bit ANDed with the bit mask of all functional addresses for
+            which the interface will accept frames.
+
+            A system is normally able to use any unicast address which
+            corresponds to an entry in this table as a source address."
+    ::= { ifMIBObjects 4 }
+
+ifRcvAddressEntry  OBJECT-TYPE
+    SYNTAX      IfRcvAddressEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "A list of objects identifying an address for which the
+            system will accept packets/frames on the particular
+            interface identified by the index value ifIndex."
+    INDEX  { ifIndex, ifRcvAddressAddress }
+    ::= { ifRcvAddressTable 1 }
+
+IfRcvAddressEntry ::=
+    SEQUENCE {
+        ifRcvAddressAddress   PhysAddress,
+        ifRcvAddressStatus    RowStatus,
+        ifRcvAddressType      INTEGER
+    }
+
+ifRcvAddressAddress OBJECT-TYPE
+    SYNTAX      PhysAddress
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+            "An address for which the system will accept packets/frames
+            on this entry's interface."
+    ::= { ifRcvAddressEntry 1 }
+
+ifRcvAddressStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object is used to create and delete rows in the
+            ifRcvAddressTable."
+    ::= { ifRcvAddressEntry 2 }
+
+ifRcvAddressType OBJECT-TYPE
+    SYNTAX      INTEGER {
+
+                    other(1),
+                    volatile(2),
+                    nonVolatile(3)
+                }
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+            "This object has the value nonVolatile(3) for those entries
+            in the table which are valid and will not be deleted by the
+            next restart of the managed system.  Entries having the
+            value volatile(2) are valid and exist, but have not been
+            saved, so that will not exist after the next restart of the
+            managed system.  Entries having the value other(1) are valid
+            and exist but are not classified as to whether they will
+            continue to exist after the next restart."
+    DEFVAL  { volatile }
+    ::= { ifRcvAddressEntry 3 }
+
+-- definition of interface-related traps.
+
+linkDown NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkDown trap signifies that the SNMP entity, acting in
+            an agent role, has detected that the ifOperStatus object for
+            one of its communication links is about to enter the down
+            state from some other state (but not from the notPresent
+            state).  This other state is indicated by the included value
+            of ifOperStatus."
+    ::= { snmpTraps 3 }
+
+linkUp NOTIFICATION-TYPE
+    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
+    STATUS  current
+    DESCRIPTION
+            "A linkUp trap signifies that the SNMP entity, acting in an
+            agent role, has detected that the ifOperStatus object for
+            one of its communication links left the down state and
+            transitioned into some other state (but not into the
+            notPresent state).  This other state is indicated by the
+            included value of ifOperStatus."
+    ::= { snmpTraps 4 }
+
+-- conformance information
+
+ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
+
+ifGroups      OBJECT IDENTIFIER ::= { ifConformance 1 }
+ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
+
+-- compliance statements
+
+ifCompliance3 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which have
+            network interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup,
+                           linkUpDownNotificationsGroup }
+
+-- The groups:
+--        ifFixedLengthGroup
+--        ifHCFixedLengthGroup
+--        ifPacketGroup
+--        ifHCPacketGroup
+--        ifVHCPacketGroup
+-- are mutually exclusive; at most one of these groups is implemented
+-- for a particular interface.  When any of these groups is implemented
+-- for a particular interface, then ifCounterDiscontinuityGroup must
+-- also be implemented for that interface.
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces which
+            are packet-oriented, and for which the value of the
+            corresponding instance of ifSpeed is less than or equal to
+            20,000,000 bits/second."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second but less than or equal to 650,000,000
+            bits/second."
+
+        GROUP       ifVHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifCounterDiscontinuityGroup
+        DESCRIPTION
+            "This group is mandatory for those network interfaces that
+            are required to maintain counters (i.e., those for which one
+            of the ifFixedLengthGroup, ifHCFixedLengthGroup,
+            ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
+            mandatory)."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 3 }
+
+-- units of conformance
+
+ifGeneralInformationGroup    OBJECT-GROUP
+    OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName, ifNumber, ifAlias,
+              ifTableLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information applicable to
+            all network interfaces."
+    ::= { ifGroups 10 }
+
+-- the following five groups are mutually exclusive; at most
+-- one of these groups is implemented for any interface
+
+ifFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) character-oriented or fixed-length-transmission
+            network interfaces."
+    ::= { ifGroups 2 }
+
+ifHCFixedLengthGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second) character-
+            oriented or fixed-length-transmission network interfaces."
+    ::= { ifGroups 3 }
+
+ifPacketGroup    OBJECT-GROUP
+    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            non-high speed (non-high speed interfaces transmit and
+            receive at speeds less than or equal to 20,000,000
+            bits/second) packet-oriented network interfaces."
+    ::= { ifGroups 4 }
+
+ifHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            high speed (greater than 20,000,000 bits/second but less
+            than or equal to 650,000,000 bits/second) packet-oriented
+            network interfaces."
+    ::= { ifGroups 5 }
+
+ifVHCPacketGroup    OBJECT-GROUP
+    OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
+              ifHCInBroadcastPkts, ifHCOutUcastPkts,
+              ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
+              ifHCInOctets, ifHCOutOctets,
+              ifInOctets, ifOutOctets, ifInUnknownProtos,
+              ifInErrors, ifOutErrors,
+              ifMtu, ifInUcastPkts, ifInMulticastPkts,
+              ifInBroadcastPkts, ifInDiscards,
+              ifOutUcastPkts, ifOutMulticastPkts,
+              ifOutBroadcastPkts, ifOutDiscards,
+              ifPromiscuousMode }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            higher speed (greater than 650,000,000 bits/second) packet-
+            oriented network interfaces."
+    ::= { ifGroups 6 }
+
+ifRcvAddressGroup    OBJECT-GROUP
+    OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            multiple addresses which an interface receives."
+    ::= { ifGroups 7 }
+
+ifStackGroup2    OBJECT-GROUP
+    OBJECTS { ifStackStatus, ifStackLastChange }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information on the
+            layering of MIB-II interfaces."
+    ::= { ifGroups 11 }
+
+ifCounterDiscontinuityGroup  OBJECT-GROUP
+    OBJECTS { ifCounterDiscontinuityTime }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing information specific to
+            interface counter discontinuities."
+    ::= { ifGroups 13 }
+
+linkUpDownNotificationsGroup  NOTIFICATION-GROUP
+    NOTIFICATIONS { linkUp, linkDown }
+    STATUS  current
+    DESCRIPTION
+            "The notifications which indicate specific changes in the
+            value of ifOperStatus."
+    ::= { ifGroups 14 }
+
+-- Deprecated Definitions - Objects
+
+--
+--    The Interface Test Table
+--
+-- This group of objects is optional.  However, a media-specific
+
+-- MIB may make implementation of this group mandatory.
+--
+-- This table replaces the ifExtnsTestTable
+--
+
+ifTestTable   OBJECT-TYPE
+    SYNTAX      SEQUENCE OF IfTestEntry
+    MAX-ACCESS  not-accessible
+    STATUS      deprecated
+    DESCRIPTION
+            "This table contains one entry per interface.  It defines
+            objects which allow a network manager to instruct an agent
+            to test an interface for various faults.  Tests for an
+            interface are defined in the media-specific MIB for that
+            interface.  After invoking a test, the object ifTestResult
+            can be read to determine the outcome.  If an agent can not
+            perform the test, ifTestResult is set to so indicate.  The
+            object ifTestCode can be used to provide further test-
+            specific or interface-specific (or even enterprise-specific)
+            information concerning the outcome of the test.  Only one
+            test can be in progress on each interface at any one time.
+            If one test is in progress when another test is invoked, the
+            second test is rejected.  Some agents may reject a test when
+            a prior test is active on another interface.
+
+            Before starting a test, a manager-station must first obtain
+            'ownership' of the entry in the ifTestTable for the
+            interface to be tested.  This is accomplished with the
+            ifTestId and ifTestStatus objects as follows:
+
+          try_again:
+              get (ifTestId, ifTestStatus)
+              while (ifTestStatus != notInUse)
+                  /*
+                   * Loop while a test is running or some other
+                   * manager is configuring a test.
+                   */
+                  short delay
+                  get (ifTestId, ifTestStatus)
+              }
+
+              /*
+               * Is not being used right now -- let's compete
+               * to see who gets it.
+               */
+              lock_value = ifTestId
+
+              if ( set(ifTestId = lock_value, ifTestStatus = inUse,
+                       ifTestOwner = 'my-IP-address') == FAILURE)
+                  /*
+                   * Another manager got the ifTestEntry -- go
+                   * try again
+                   */
+                  goto try_again;
+
+              /*
+               * I have the lock
+               */
+              set up any test parameters.
+
+              /*
+               * This starts the test
+               */
+              set(ifTestType = test_to_run);
+
+              wait for test completion by polling ifTestResult
+
+              when test completes, agent sets ifTestResult
+                   agent also sets ifTestStatus = 'notInUse'
+
+              retrieve any additional test results, and ifTestId
+
+              if (ifTestId == lock_value+1) results are valid
+
+            A manager station first retrieves the value of the
+            appropriate ifTestId and ifTestStatus objects, periodically
+            repeating the retrieval if necessary, until the value of
+            ifTestStatus is 'notInUse'.  The manager station then tries
+            to set the same ifTestId object to the value it just
+            retrieved, the same ifTestStatus object to 'inUse', and the
+            corresponding ifTestOwner object to a value indicating
+            itself.  If the set operation succeeds then the manager has
+            obtained ownership of the ifTestEntry, and the value of the
+            ifTestId object is incremented by the agent (per the
+            semantics of TestAndIncr).  Failure of the set operation
+            indicates that some other manager has obtained ownership of
+            the ifTestEntry.
+
+            Once ownership is obtained, any test parameters can be
+            setup, and then the test is initiated by setting ifTestType.
+            On completion of the test, the agent sets ifTestStatus to
+            'notInUse'.  Once this occurs, the manager can retrieve the
+            results.  In the (rare) event that the invocation of tests
+            by two network managers were to overlap, then there would be
+            a possibility that the first test's results might be
+            overwritten by the second test's results prior to the first
+
+            results being read.  This unlikely circumstance can be
+            detected by a network manager retrieving ifTestId at the
+            same time as retrieving the test results, and ensuring that
+            the results are for the desired request.
+
+            If ifTestType is not set within an abnormally long period of
+            time after ownership is obtained, the agent should time-out
+            the manager, and reset the value of the ifTestStatus object
+            back to 'notInUse'.  It is suggested that this time-out
+            period be 5 minutes.
+
+            In general, a management station must not retransmit a
+            request to invoke a test for which it does not receive a
+            response; instead, it properly inspects an agent's MIB to
+            determine if the invocation was successful.  Only if the
+            invocation was unsuccessful, is the invocation request
+            retransmitted.
+
+            Some tests may require the interface to be taken off-line in
+            order to execute them, or may even require the agent to
+            reboot after completion of the test.  In these
+            circumstances, communication with the management station
+            invoking the test may be lost until after completion of the
+            test.  An agent is not required to support such tests.
+            However, if such tests are supported, then the agent should
+            make every effort to transmit a response to the request
+            which invoked the test prior to losing communication.  When
+            the agent is restored to normal service, the results of the
+            test are properly made available in the appropriate objects.
+            Note that this requires that the ifIndex value assigned to
+            an interface must be unchanged even if the test causes a
+            reboot.  An agent must reject any test for which it cannot,
+            perhaps due to resource constraints, make available at least
+            the minimum amount of information after that test
+            completes."
+    ::= { ifMIBObjects 3 }
+
+ifTestEntry OBJECT-TYPE
+    SYNTAX       IfTestEntry
+    MAX-ACCESS   not-accessible
+    STATUS       deprecated
+    DESCRIPTION
+            "An entry containing objects for invoking tests on an
+            interface."
+    AUGMENTS  { ifEntry }
+    ::= { ifTestTable 1 }
+
+IfTestEntry ::=
+
+    SEQUENCE {
+        ifTestId           TestAndIncr,
+        ifTestStatus       INTEGER,
+        ifTestType         AutonomousType,
+        ifTestResult       INTEGER,
+        ifTestCode         OBJECT IDENTIFIER,
+        ifTestOwner        OwnerString
+    }
+
+ifTestId         OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object identifies the current invocation of the
+            interface's test."
+    ::= { ifTestEntry 1 }
+
+ifTestStatus     OBJECT-TYPE
+    SYNTAX       INTEGER { notInUse(1), inUse(2) }
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "This object indicates whether or not some manager currently
+            has the necessary 'ownership' required to invoke a test on
+            this interface.  A write to this object is only successful
+            when it changes its value from 'notInUse(1)' to 'inUse(2)'.
+            After completion of a test, the agent resets the value back
+            to 'notInUse(1)'."
+    ::= { ifTestEntry 2 }
+
+ifTestType       OBJECT-TYPE
+    SYNTAX       AutonomousType
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "A control variable used to start and stop operator-
+            initiated interface tests.  Most OBJECT IDENTIFIER values
+            assigned to tests are defined elsewhere, in association with
+            specific types of interface.  However, this document assigns
+            a value for a full-duplex loopback test, and defines the
+            special meanings of the subject identifier:
+
+                noTest  OBJECT IDENTIFIER ::= { 0 0 }
+
+            When the value noTest is written to this object, no action
+            is taken unless a test is in progress, in which case the
+            test is aborted.  Writing any other value to this object is
+
+            only valid when no test is currently in progress, in which
+            case the indicated test is initiated.
+
+            When read, this object always returns the most recent value
+            that ifTestType was set to.  If it has not been set since
+            the last initialization of the network management subsystem
+            on the agent, a value of noTest is returned."
+    ::= { ifTestEntry 3 }
+
+ifTestResult  OBJECT-TYPE
+    SYNTAX       INTEGER {
+                     none(1),          -- no test yet requested
+                     success(2),
+                     inProgress(3),
+                     notSupported(4),
+                     unAbleToRun(5),   -- due to state of system
+                     aborted(6),
+                     failed(7)
+                 }
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains the result of the most recently
+            requested test, or the value none(1) if no tests have been
+            requested since the last reset.  Note that this facility
+            provides no provision for saving the results of one test
+            when starting another, as could be required if used by
+            multiple managers concurrently."
+    ::= { ifTestEntry 4 }
+
+ifTestCode  OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   read-only
+    STATUS       deprecated
+    DESCRIPTION
+            "This object contains a code which contains more specific
+            information on the test result, for example an error-code
+            after a failed test.  Error codes and other values this
+            object may take are specific to the type of interface and/or
+            test.  The value may have the semantics of either the
+            AutonomousType or InstancePointer textual conventions as
+            defined in RFC 2579.  The identifier:
+
+                testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
+
+            is defined for use if no additional result code is
+            available."
+    ::= { ifTestEntry 5 }
+
+ifTestOwner      OBJECT-TYPE
+    SYNTAX       OwnerString
+    MAX-ACCESS   read-write
+    STATUS       deprecated
+    DESCRIPTION
+            "The entity which currently has the 'ownership' required to
+            invoke a test on this interface."
+    ::= { ifTestEntry 6 }
+
+-- Deprecated Definitions - Groups
+
+ifGeneralGroup    OBJECT-GROUP
+    OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
+              ifAdminStatus, ifOperStatus, ifLastChange,
+              ifLinkUpDownTrapEnable, ifConnectorPresent,
+              ifHighSpeed, ifName }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects deprecated in favour of
+            ifGeneralInformationGroup."
+    ::= { ifGroups 1 }
+
+ifTestGroup    OBJECT-GROUP
+    OBJECTS { ifTestId, ifTestStatus, ifTestType,
+              ifTestResult, ifTestCode, ifTestOwner }
+    STATUS  deprecated
+    DESCRIPTION
+            "A collection of objects providing the ability to invoke
+            tests on an interface."
+    ::= { ifGroups 8 }
+
+ifStackGroup    OBJECT-GROUP
+    OBJECTS { ifStackStatus }
+    STATUS  deprecated
+    DESCRIPTION
+            "The previous collection of objects providing information on
+            the layering of MIB-II interfaces."
+    ::= { ifGroups 9 }
+
+ifOldObjectsGroup    OBJECT-GROUP
+    OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
+              ifOutQLen, ifSpecific }
+    STATUS  deprecated
+    DESCRIPTION
+            "The collection of objects deprecated from the original MIB-
+            II interfaces group."
+    ::= { ifGroups 12 }
+
+-- Deprecated Definitions - Compliance
+
+ifCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifTestGroup
+        DESCRIPTION
+            "This group is optional.  Media-specific MIBs which require
+            interface tests are strongly encouraged to use this group
+            for invoking tests and reporting results.  A medium specific
+            MIB which has mandatory tests may make implementation of
+
+            this group mandatory."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+    ::= { ifCompliances 1 }
+
+ifCompliance2 MODULE-COMPLIANCE
+    STATUS      deprecated
+    DESCRIPTION
+            "A compliance statement defined in a previous version of
+            this MIB module, for SNMP entities which have network
+            interfaces."
+
+    MODULE  -- this module
+        MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2,
+                           ifCounterDiscontinuityGroup }
+
+        GROUP       ifFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are character-oriented or transmit data in fixed-length
+            transmission units."
+
+        GROUP       ifHCFixedLengthGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are character-oriented or transmit data in fixed-
+            length transmission units, and for which the value of the
+            corresponding instance of ifSpeed is greater than 20,000,000
+            bits/second."
+
+        GROUP       ifPacketGroup
+        DESCRIPTION
+            "This group is mandatory for all network interfaces which
+            are packet-oriented."
+
+        GROUP       ifHCPacketGroup
+        DESCRIPTION
+            "This group is mandatory only for those network interfaces
+            which are packet-oriented and for which the value of the
+            corresponding instance of ifSpeed is greater than
+            650,000,000 bits/second."
+
+        GROUP       ifRcvAddressGroup
+        DESCRIPTION
+            "The applicability of this group MUST be defined by the
+            media-specific MIBs.  Media-specific MIBs must define the
+            exact meaning, use, and semantics of the addresses in this
+            group."
+
+        OBJECT      ifLinkUpDownTrapEnable
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifPromiscuousMode
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required."
+
+        OBJECT      ifStackStatus
+        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
+        MIN-ACCESS  read-only
+        DESCRIPTION
+            "Write access is not required, and only one of the six
+            enumerated values for the RowStatus textual convention need
+            be supported, specifically: active(1)."
+
+        OBJECT       ifAdminStatus
+        SYNTAX       INTEGER { up(1), down(2) }
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required, nor is support for the value
+            testing(3)."
+
+        OBJECT       ifAlias
+        MIN-ACCESS   read-only
+        DESCRIPTION
+            "Write access is not required."
+    ::= { ifCompliances 2 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..a778cba6b74249f5a1a731f1437f905946bb1f48
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/INET-ADDRESS-MIB.txt
@@ -0,0 +1,402 @@
+INET-ADDRESS-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, mib-2, Unsigned32 FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                 FROM SNMPv2-TC;
+
+inetAddressMIB MODULE-IDENTITY
+    LAST-UPDATED "200502040000Z"
+    ORGANIZATION
+        "IETF Operations and Management Area"
+    CONTACT-INFO
+        "Juergen Schoenwaelder (Editor)
+         International University Bremen
+         P.O. Box 750 561
+         28725 Bremen, Germany
+
+         Phone: +49 421 200-3587
+         EMail: j.schoenwaelder@iu-bremen.de
+
+         Send comments to <ietfmibs@ops.ietf.org>."
+    DESCRIPTION
+        "This MIB module defines textual conventions for
+         representing Internet addresses.  An Internet
+         address can be an IPv4 address, an IPv6 address,
+         or a DNS domain name.  This module also defines
+         textual conventions for Internet port numbers,
+         autonomous system numbers, and the length of an
+         Internet address prefix.
+
+         Copyright (C) The Internet Society (2005).  This version
+         of this MIB module is part of RFC 4001, see the RFC
+         itself for full legal notices."
+    REVISION     "200502040000Z"
+    DESCRIPTION
+        "Third version, published as RFC 4001.  This revision
+         introduces the InetZoneIndex, InetScopeType, and
+         InetVersion textual conventions."
+    REVISION     "200205090000Z"
+    DESCRIPTION
+        "Second version, published as RFC 3291.  This
+         revision contains several clarifications and
+         introduces several new textual conventions:
+         InetAddressPrefixLength, InetPortNumber,
+         InetAutonomousSystemNumber, InetAddressIPv4z,
+         and InetAddressIPv6z."
+    REVISION     "200006080000Z"
+    DESCRIPTION
+        "Initial version, published as RFC 2851."
+    ::= { mib-2 76 }
+
+InetAddressType ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "A value that represents a type of Internet address.
+
+         unknown(0)  An unknown address type.  This value MUST
+                     be used if the value of the corresponding
+                     InetAddress object is a zero-length string.
+                     It may also be used to indicate an IP address
+                     that is not in one of the formats defined
+                     below.
+
+         ipv4(1)     An IPv4 address as defined by the
+                     InetAddressIPv4 textual convention.
+
+         ipv6(2)     An IPv6 address as defined by the
+                     InetAddressIPv6 textual convention.
+
+         ipv4z(3)    A non-global IPv4 address including a zone
+                     index as defined by the InetAddressIPv4z
+                     textual convention.
+
+         ipv6z(4)    A non-global IPv6 address including a zone
+                     index as defined by the InetAddressIPv6z
+                     textual convention.
+
+         dns(16)     A DNS domain name as defined by the
+                     InetAddressDNS textual convention.
+
+         Each definition of a concrete InetAddressType value must be
+         accompanied by a definition of a textual convention for use
+         with that InetAddressType.
+
+         To support future extensions, the InetAddressType textual
+         convention SHOULD NOT be sub-typed in object type definitions.
+         It MAY be sub-typed in compliance statements in order to
+         require only a subset of these address types for a compliant
+         implementation.
+
+         Implementations must ensure that InetAddressType objects
+         and any dependent objects (e.g., InetAddress objects) are
+         consistent.  An inconsistentValue error must be generated
+         if an attempt to change an InetAddressType object would,
+         for example, lead to an undefined InetAddress value.  In
+
+         particular, InetAddressType/InetAddress pairs must be
+         changed together if the address type changes (e.g., from
+         ipv6(2) to ipv4(1))."
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2),
+                     ipv4z(3),
+                     ipv6z(4),
+                     dns(16)
+                 }
+
+InetAddress ::= TEXTUAL-CONVENTION
+    STATUS      current
+    DESCRIPTION
+        "Denotes a generic Internet address.
+
+         An InetAddress value is always interpreted within the context
+         of an InetAddressType value.  Every usage of the InetAddress
+         textual convention is required to specify the InetAddressType
+         object that provides the context.  It is suggested that the
+         InetAddressType object be logically registered before the
+         object(s) that use the InetAddress textual convention, if
+         they appear in the same logical row.
+
+         The value of an InetAddress object must always be
+         consistent with the value of the associated InetAddressType
+         object.  Attempts to set an InetAddress object to a value
+         inconsistent with the associated InetAddressType
+         must fail with an inconsistentValue error.
+
+         When this textual convention is used as the syntax of an
+         index object, there may be issues with the limit of 128
+         sub-identifiers specified in SMIv2, STD 58.  In this case,
+         the object definition MUST include a 'SIZE' clause to
+         limit the number of potential instance sub-identifiers;
+         otherwise the applicable constraints MUST be stated in
+         the appropriate conceptual row DESCRIPTION clauses, or
+         in the surrounding documentation if there is no single
+         DESCRIPTION clause that is appropriate."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+InetAddressIPv4 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv4 network address:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+
+         The corresponding InetAddressType value is ipv4(1).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (4))
+
+InetAddressIPv6 ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x"
+    STATUS       current
+    DESCRIPTION
+        "Represents an IPv6 network address:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+
+         The corresponding InetAddressType value is ipv6(2).
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (16))
+
+InetAddressIPv4z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1d.1d.1d.1d%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv4 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-4     IPv4 address     network-byte order
+            5-8     zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv4z(3).
+
+         The zone index (bytes 5-8) is used to disambiguate identical
+         address values on nodes that have interfaces attached to
+         different zones of the same scope.  The zone index may contain
+         the special value 0, which refers to the default zone for each
+         scope.
+
+         This textual convention SHOULD NOT be used directly in object
+
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (8))
+
+InetAddressIPv6z ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2x:2x:2x:2x:2x:2x:2x:2x%4d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a non-global IPv6 network address, together
+         with its zone index:
+
+           Octets   Contents         Encoding
+            1-16    IPv6 address     network-byte order
+           17-20    zone index       network-byte order
+
+         The corresponding InetAddressType value is ipv6z(4).
+
+         The zone index (bytes 17-20) is used to disambiguate
+         identical address values on nodes that have interfaces
+         attached to different zones of the same scope.  The zone index
+         may contain the special value 0, which refers to the default
+         zone for each scope.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (20))
+
+InetAddressDNS ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+        "Represents a DNS domain name.  The name SHOULD be fully
+         qualified whenever possible.
+
+         The corresponding InetAddressType is dns(16).
+
+         The DESCRIPTION clause of InetAddress objects that may have
+         InetAddressDNS values MUST fully describe how (and when)
+         these names are to be resolved to IP addresses.
+
+         The resolution of an InetAddressDNS value may require to
+         query multiple DNS records (e.g., A for IPv4 and AAAA for
+         IPv6).  The order of the resolution process and which DNS
+         record takes precedence depends on the configuration of the
+         resolver.
+
+         This textual convention SHOULD NOT be used directly in object
+         definitions, as it restricts addresses to a specific format.
+         However, if it is used, it MAY be used either on its own or in
+         conjunction with InetAddressType, as a pair."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+InetAddressPrefixLength ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Denotes the length of a generic Internet network address
+         prefix.  A value of n corresponds to an IP address mask
+         that has n contiguous 1-bits from the most significant
+         bit (MSB), with all other bits set to 0.
+
+         An InetAddressPrefixLength value is always interpreted within
+         the context of an InetAddressType value.  Every usage of the
+         InetAddressPrefixLength textual convention is required to
+         specify the InetAddressType object that provides the
+         context.  It is suggested that the InetAddressType object be
+         logically registered before the object(s) that use the
+         InetAddressPrefixLength textual convention, if they appear
+         in the same logical row.
+
+         InetAddressPrefixLength values larger than
+         the maximum length of an IP address for a specific
+         InetAddressType are treated as the maximum significant
+         value applicable for the InetAddressType.  The maximum
+         significant value is 32 for the InetAddressType
+         'ipv4(1)' and 'ipv4z(3)' and 128 for the InetAddressType
+         'ipv6(2)' and 'ipv6z(4)'.  The maximum significant value
+         for the InetAddressType 'dns(16)' is 0.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where the Internet network address prefix
+         is unknown or does not apply.
+
+         The upper bound of the prefix length has been chosen to
+         be consistent with the maximum size of an InetAddress."
+    SYNTAX       Unsigned32 (0..2040)
+
+InetPortNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents a 16 bit port number of an Internet transport
+
+         layer protocol.  Port numbers are assigned by IANA.  A
+         current list of all assignments is available from
+         <http://www.iana.org/>.
+
+         The value zero is object-specific and must be defined as
+         part of the description of any object that uses this
+         syntax.  Examples of the usage of zero might include
+         situations where a port number is unknown, or when the
+         value zero is used as a wildcard in a filter."
+    REFERENCE   "STD 6 (RFC 768), STD 7 (RFC 793) and RFC 2960"
+    SYNTAX       Unsigned32 (0..65535)
+
+InetAutonomousSystemNumber ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "Represents an autonomous system number that identifies an
+         Autonomous System (AS).  An AS is a set of routers under a
+         single technical administration, using an interior gateway
+         protocol and common metrics to route packets within the AS,
+         and using an exterior gateway protocol to route packets to
+         other ASes'.  IANA maintains the AS number space and has
+         delegated large parts to the regional registries.
+
+         Autonomous system numbers are currently limited to 16 bits
+         (0..65535).  There is, however, work in progress to enlarge the
+         autonomous system number space to 32 bits.  Therefore, this
+         textual convention uses an Unsigned32 value without a
+         range restriction in order to support a larger autonomous
+         system number space."
+    REFERENCE   "RFC 1771, RFC 1930"
+    SYNTAX       Unsigned32
+
+InetScopeType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+        "Represents a scope type.  This textual convention can be used
+         in cases where a MIB has to represent different scope types
+         and there is no context information, such as an InetAddress
+         object, that implicitly defines the scope type.
+
+         Note that not all possible values have been assigned yet, but
+         they may be assigned in future revisions of this specification.
+         Applications should therefore be able to deal with values
+         not yet assigned."
+    REFERENCE   "RFC 3513"
+    SYNTAX       INTEGER {
+                     -- reserved(0),
+                     interfaceLocal(1),
+                     linkLocal(2),
+                     subnetLocal(3),
+                     adminLocal(4),
+                     siteLocal(5), -- site-local unicast addresses
+                                   -- have been deprecated by RFC 3879
+                     -- unassigned(6),
+                     -- unassigned(7),
+                     organizationLocal(8),
+                     -- unassigned(9),
+                     -- unassigned(10),
+                     -- unassigned(11),
+                     -- unassigned(12),
+                     -- unassigned(13),
+                     global(14)
+                     -- reserved(15)
+                 }
+
+InetZoneIndex ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "d"
+    STATUS       current
+    DESCRIPTION
+        "A zone index identifies an instance of a zone of a
+         specific scope.
+
+         The zone index MUST disambiguate identical address
+         values.  For link-local addresses, the zone index will
+         typically be the interface index (ifIndex as defined in the
+         IF-MIB) of the interface on which the address is configured.
+
+         The zone index may contain the special value 0, which refers
+         to the default zone.  The default zone may be used in cases
+         where the valid zone index is not known (e.g., when a
+         management application has to write a link-local IPv6
+         address without knowing the interface index value).  The
+         default zone SHOULD NOT be used as an easy way out in
+         cases where the zone index for a non-global IPv6 address
+         is known."
+    REFERENCE   "RFC4007"
+    SYNTAX       Unsigned32
+
+InetVersion ::= TEXTUAL-CONVENTION
+    STATUS  current
+    DESCRIPTION
+        "A value representing a version of the IP protocol.
+
+         unknown(0)  An unknown or unspecified version of the IP
+                     protocol.
+
+         ipv4(1)     The IPv4 protocol as defined in RFC 791 (STD 5).
+
+         ipv6(2)     The IPv6 protocol as defined in RFC 2460.
+
+         Note that this textual convention SHOULD NOT be used to
+         distinguish different address types associated with IP
+         protocols.  The InetAddressType has been designed for this
+         purpose."
+    REFERENCE   "RFC 791, RFC 2460"
+    SYNTAX       INTEGER {
+                     unknown(0),
+                     ipv4(1),
+                     ipv6(2)
+                 }
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..aa273c2858406630b179ddcc5711bc9f04e56a6a
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-FRAMEWORK-MIB.txt
@@ -0,0 +1,526 @@
+SNMP-FRAMEWORK-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE,
+    OBJECT-IDENTITY,
+    snmpModules                           FROM SNMPv2-SMI
+    TEXTUAL-CONVENTION                    FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF;
+
+snmpFrameworkMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-EMail:   snmpv3@lists.tislabs.com
+                  Subscribe:  snmpv3-request@lists.tislabs.com
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  EMail:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair &
+                  Co-editor:  David Harrington
+                              Enterasys Networks
+                  postal:     35 Industrial Way
+                              P. O. Box 5005
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  phone:      +1 603-337-2614
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+                  postal:     2141 North First Street
+                              San Jose, California 95131
+                              USA
+                  EMail:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+
+                  EMail:      bwijnen@lucent.com
+                  phone:      +31 348-680-485
+                    "
+       DESCRIPTION  "The SNMP Management Architecture MIB
+
+                     Copyright (C) The Internet Society (2002). This
+                     version of this MIB module is part of RFC 3411;
+                     see the RFC itself for full legal notices.
+                    "
+
+       REVISION     "200210140000Z"         -- 14 October 2002
+       DESCRIPTION  "Changes in this revision:
+                     - Updated various administrative information.
+                     - Corrected some typos.
+                     - Corrected typo in description of SnmpEngineID
+                       that led to range overlap for 127.
+                     - Changed '255a' to '255t' in definition of
+                       SnmpAdminString to align with current SMI.
+                     - Reworded 'reserved' for value zero in
+                       DESCRIPTION of SnmpSecurityModel.
+                     - The algorithm for allocating security models
+                       should give 256 per enterprise block, rather
+                       than 255.
+                     - The example engine ID of 'abcd' is not
+                       legal. Replaced with '800002b804616263'H based
+                       on example enterprise 696, string 'abc'.
+                     - Added clarification that engineID should
+                       persist across re-initializations.
+                     This revision published as RFC 3411.
+                    "
+       REVISION     "199901190000Z"         -- 19 January 1999
+       DESCRIPTION  "Updated editors' addresses, fixed typos.
+                     Published as RFC 2571.
+                    "
+       REVISION     "199711200000Z"         -- 20 November 1997
+       DESCRIPTION  "The initial version, published in RFC 2271.
+                    "
+       ::= { snmpModules 10 }
+
+   -- Textual Conventions used in the SNMP Management Architecture ***
+
+SnmpEngineID ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+                 Objects of this type are for identification, not for
+                 addressing, even though it is possible that an
+                 address may have been used in the generation of
+                 a specific value.
+
+                 The value for this object may not be all zeros or
+                 all 'ff'H or the empty (zero length) string.
+
+                 The initial value for this object may be configured
+                 via an operator console entry or via an algorithmic
+                 function.  In the latter case, the following
+                 example algorithm is recommended.
+
+                 In cases where there are multiple engines on the
+                 same system, the use of this algorithm is NOT
+                 appropriate, as it would result in all of those
+                 engines ending up with the same ID value.
+
+                 1) The very first bit is used to indicate how the
+                    rest of the data is composed.
+
+                    0 - as defined by enterprise using former methods
+                        that existed before SNMPv3. See item 2 below.
+
+                    1 - as defined by this architecture, see item 3
+                        below.
+
+                    Note that this allows existing uses of the
+                    engineID (also known as AgentID [RFC1910]) to
+                    co-exist with any new uses.
+
+                 2) The snmpEngineID has a length of 12 octets.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The remaining eight octets are determined via
+                    one or more enterprise-specific methods. Such
+                    methods must be designed so as to maximize the
+                    possibility that the value of this object will
+                    be unique in the agent's administrative domain.
+                    For example, it may be the IP address of the SNMP
+                    entity, or the MAC address of one of the
+                    interfaces, with each address suitably padded
+                    with random octets.  If multiple methods are
+                    defined, then it is recommended that the first
+                    octet indicate the method being used and the
+                    remaining octets be a function of the method.
+
+                 3) The length of the octet string varies.
+
+                    The first four octets are set to the binary
+                    equivalent of the agent's SNMP management
+                    private enterprise number as assigned by the
+                    Internet Assigned Numbers Authority (IANA).
+                    For example, if Acme Networks has been assigned
+                    { enterprises 696 }, the first four octets would
+                    be assigned '000002b8'H.
+
+                    The very first bit is set to 1. For example, the
+                    above value for Acme Networks now changes to be
+                    '800002b8'H.
+
+                    The fifth octet indicates how the rest (6th and
+                    following octets) are formatted. The values for
+                    the fifth octet are:
+
+                      0     - reserved, unused.
+
+                      1     - IPv4 address (4 octets)
+                              lowest non-special IP address
+
+                      2     - IPv6 address (16 octets)
+                              lowest non-special IP address
+
+                      3     - MAC address (6 octets)
+                              lowest IEEE MAC address, canonical
+                              order
+
+                      4     - Text, administratively assigned
+                              Maximum remaining length 27
+
+                      5     - Octets, administratively assigned
+                              Maximum remaining length 27
+
+                      6-127 - reserved, unused
+
+                    128-255 - as defined by the enterprise
+                              Maximum remaining length 27
+                "
+    SYNTAX       OCTET STRING (SIZE(5..32))
+
+SnmpSecurityModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a
+                 Security Model of the Security Subsystem within
+                 this SNMP Management Architecture.
+
+                 The values for securityModel are allocated as
+                 follows:
+
+                 - The zero value does not identify any particular
+                   security model.
+
+                 - Values between 1 and 255, inclusive, are reserved
+                   for standards-track Security Models and are
+                   managed by the Internet Assigned Numbers Authority
+                   (IANA).
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Security Models.  An
+                   enterprise-specific securityModel value is defined
+                   to be:
+
+                   enterpriseID * 256 + security model within
+                   enterprise
+
+                   For example, the fourth Security Model defined by
+                   the enterprise whose enterpriseID is 1 would be
+                   259.
+
+                 This scheme for allocation of securityModel
+                 values allows for a maximum of 255 standards-
+                 based Security Models, and for a maximum of
+                 256 Security Models per enterprise.
+
+                 It is believed that the assignment of new
+                 securityModel values will be rare in practice
+                 because the larger the number of simultaneously
+                 utilized Security Models, the larger the
+                 chance that interoperability will suffer.
+                 Consequently, it is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+
+                 securityModels.  This limits the ability to
+                 define new proprietary implementations of Security
+                 Models to the first 8,388,608 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the securityModel value will normally
+                 require only a single byte since, in practice,
+                 the leftmost bits will be zero for most messages
+                 and sign extension is suppressed by the encoding
+                 rules.
+
+                 As of this writing, there are several values
+                 of securityModel defined for use with SNMP or
+                 reserved for use with supporting MIB objects.
+                 They are as follows:
+
+                     0  reserved for 'any'
+                     1  reserved for SNMPv1
+                     2  reserved for SNMPv2c
+                     3  User-Based Security Model (USM)
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpMessageProcessingModel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "An identifier that uniquely identifies a Message
+                 Processing Model of the Message Processing
+                 Subsystem within this SNMP Management Architecture.
+
+                 The values for messageProcessingModel are
+                 allocated as follows:
+
+                 - Values between 0 and 255, inclusive, are
+                   reserved for standards-track Message Processing
+                   Models and are managed by the Internet Assigned
+                   Numbers Authority (IANA).
+
+                 - Values greater than 255 are allocated to
+                   enterprise-specific Message Processing Models.
+                   An enterprise messageProcessingModel value is
+                   defined to be:
+
+                   enterpriseID * 256 +
+                        messageProcessingModel within enterprise
+
+                   For example, the fourth Message Processing Model
+                   defined by the enterprise whose enterpriseID
+
+                   is 1 would be 259.
+
+                 This scheme for allocating messageProcessingModel
+                 values allows for a maximum of 255 standards-
+                 based Message Processing Models, and for a
+                 maximum of 256 Message Processing Models per
+                 enterprise.
+
+                 It is believed that the assignment of new
+                 messageProcessingModel values will be rare
+                 in practice because the larger the number of
+                 simultaneously utilized Message Processing Models,
+                 the larger the chance that interoperability
+                 will suffer. It is believed that such a range
+                 will be sufficient.  In the unlikely event that
+                 the standards committee finds this number to be
+                 insufficient over time, an enterprise number
+                 can be allocated to obtain an additional 256
+                 possible values.
+
+                 Note that the most significant bit must be zero;
+                 hence, there are 23 bits allocated for various
+                 organizations to design and define non-standard
+                 messageProcessingModels.  This limits the ability
+                 to define new proprietary implementations of
+                 Message Processing Models to the first 8,388,608
+                 enterprises.
+
+                 It is worthwhile to note that, in its encoded
+                 form, the messageProcessingModel value will
+                 normally require only a single byte since, in
+                 practice, the leftmost bits will be zero for
+                 most messages and sign extension is suppressed
+                 by the encoding rules.
+
+                 As of this writing, there are several values of
+                 messageProcessingModel defined for use with SNMP.
+                 They are as follows:
+
+                     0  reserved for SNMPv1
+                     1  reserved for SNMPv2c
+                     2  reserved for SNMPv2u and SNMPv2*
+                     3  reserved for SNMPv3
+                "
+    SYNTAX       INTEGER(0 .. 2147483647)
+
+SnmpSecurityLevel ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION "A Level of Security at which SNMP messages can be
+                 sent or with which operations are being processed;
+                 in particular, one of:
+
+                   noAuthNoPriv - without authentication and
+                                  without privacy,
+                   authNoPriv   - with authentication but
+                                  without privacy,
+                   authPriv     - with authentication and
+                                  with privacy.
+
+                 These three values are ordered such that
+                 noAuthNoPriv is less than authNoPriv and
+                 authNoPriv is less than authPriv.
+                "
+    SYNTAX       INTEGER { noAuthNoPriv(1),
+                           authNoPriv(2),
+                           authPriv(3)
+                         }
+
+SnmpAdminString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION "An octet string containing administrative
+                 information, preferably in human-readable form.
+
+                 To facilitate internationalization, this
+                 information is represented using the ISO/IEC
+                 IS 10646-1 character set, encoded as an octet
+                 string using the UTF-8 transformation format
+                 described in [RFC2279].
+
+                 Since additional code points are added by
+                 amendments to the 10646 standard from time
+                 to time, implementations must be prepared to
+                 encounter any code point from 0x00000000 to
+                 0x7fffffff.  Byte sequences that do not
+                 correspond to the valid UTF-8 encoding of a
+                 code point or are outside this range are
+                 prohibited.
+
+                 The use of control codes should be avoided.
+
+                 When it is necessary to represent a newline,
+                 the control code sequence CR LF should be used.
+
+                 The use of leading or trailing white space should
+                 be avoided.
+
+                 For code points not directly supported by user
+                 interface hardware or software, an alternative
+                 means of entry and display, such as hexadecimal,
+                 may be provided.
+
+                 For information encoded in 7-bit US-ASCII,
+                 the UTF-8 encoding is identical to the
+                 US-ASCII encoding.
+
+                 UTF-8 may require multiple bytes to represent a
+                 single character / code point; thus the length
+                 of this object in octets may be different from
+                 the number of characters encoded.  Similarly,
+                 size constraints refer to the number of encoded
+                 octets, not the number of characters represented
+                 by an encoding.
+
+                 Note that when this TC is used for an object that
+                 is used or envisioned to be used as an index, then
+                 a SIZE restriction MUST be specified so that the
+                 number of sub-identifiers for any object instance
+                 does not exceed the limit of 128, as defined by
+                 [RFC3416].
+
+                 Note that the size of an SnmpAdminString object is
+                 measured in octets, not characters.
+                "
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+-- Administrative assignments ***************************************
+
+snmpFrameworkAdmin
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 1 }
+snmpFrameworkMIBObjects
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 2 }
+snmpFrameworkMIBConformance
+    OBJECT IDENTIFIER ::= { snmpFrameworkMIB 3 }
+
+-- the snmpEngine Group ********************************************
+
+snmpEngine OBJECT IDENTIFIER ::= { snmpFrameworkMIBObjects 1 }
+
+snmpEngineID     OBJECT-TYPE
+    SYNTAX       SnmpEngineID
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "An SNMP engine's administratively-unique identifier.
+
+                 This information SHOULD be stored in non-volatile
+                 storage so that it remains constant across
+                 re-initializations of the SNMP engine.
+                "
+    ::= { snmpEngine 1 }
+
+snmpEngineBoots  OBJECT-TYPE
+    SYNTAX       INTEGER (1..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of times that the SNMP engine has
+                 (re-)initialized itself since snmpEngineID
+                 was last configured.
+                "
+    ::= { snmpEngine 2 }
+
+snmpEngineTime   OBJECT-TYPE
+    SYNTAX       INTEGER (0..2147483647)
+    UNITS        "seconds"
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The number of seconds since the value of
+                 the snmpEngineBoots object last changed.
+                 When incrementing this object's value would
+                 cause it to exceed its maximum,
+                 snmpEngineBoots is incremented as if a
+                 re-initialization had occurred, and this
+                 object's value consequently reverts to zero.
+                "
+    ::= { snmpEngine 3 }
+
+snmpEngineMaxMessageSize OBJECT-TYPE
+    SYNTAX       INTEGER (484..2147483647)
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "The maximum length in octets of an SNMP message
+                 which this SNMP engine can send or receive and
+                 process, determined as the minimum of the maximum
+                 message size values supported among all of the
+                 transports available to and supported by the engine.
+                "
+    ::= { snmpEngine 4 }
+
+-- Registration Points for Authentication and Privacy Protocols **
+
+snmpAuthProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track
+                  authentication protocols used in SNMP Management
+                  Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 1 }
+
+snmpPrivProtocols OBJECT-IDENTITY
+    STATUS        current
+    DESCRIPTION  "Registration point for standards-track privacy
+                  protocols used in SNMP Management Frameworks.
+                 "
+    ::= { snmpFrameworkAdmin 2 }
+
+-- Conformance information ******************************************
+
+snmpFrameworkMIBCompliances
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 1}
+snmpFrameworkMIBGroups
+               OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 2}
+
+-- compliance statements
+
+snmpFrameworkMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP Management Framework MIB.
+                "
+    MODULE    -- this module
+        MANDATORY-GROUPS { snmpEngineGroup }
+    ::= { snmpFrameworkMIBCompliances 1 }
+
+-- units of conformance
+
+snmpEngineGroup OBJECT-GROUP
+    OBJECTS {
+              snmpEngineID,
+              snmpEngineBoots,
+              snmpEngineTime,
+              snmpEngineMaxMessageSize
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects for identifying and
+                 determining the configuration and current timeliness
+
+                 values of an SNMP engine.
+                "
+    ::= { snmpFrameworkMIBGroups 1 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..654afdd6941a473b44e10a28ecb5a5ef5937bc6d
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-TARGET-MIB.txt
@@ -0,0 +1,660 @@
+SNMP-TARGET-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY,
+    OBJECT-TYPE,
+    snmpModules,
+    Counter32,
+    Integer32
+        FROM SNMPv2-SMI
+
+    TEXTUAL-CONVENTION,
+    TDomain,
+    TAddress,
+    TimeInterval,
+    RowStatus,
+    StorageType,
+    TestAndIncr
+        FROM SNMPv2-TC
+
+    SnmpSecurityModel,
+    SnmpMessageProcessingModel,
+    SnmpSecurityLevel,
+    SnmpAdminString
+        FROM SNMP-FRAMEWORK-MIB
+
+    MODULE-COMPLIANCE,
+    OBJECT-GROUP
+        FROM SNMPv2-CONF;
+
+snmpTargetMIB MODULE-IDENTITY
+    LAST-UPDATED "200210140000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+        "WG-email:   snmpv3@lists.tislabs.com
+         Subscribe:  majordomo@lists.tislabs.com
+                     In message body:  subscribe snmpv3
+
+         Co-Chair:   Russ Mundy
+                     Network Associates Laboratories
+         Postal:     15204 Omega Drive, Suite 300
+                     Rockville, MD 20850-4601
+                     USA
+         EMail:      mundy@tislabs.com
+         Phone:      +1 301-947-7107
+
+         Co-Chair:   David Harrington
+                     Enterasys Networks
+         Postal:     35 Industrial Way
+                     P. O. Box 5004
+                     Rochester, New Hampshire 03866-5005
+                     USA
+         EMail:      dbh@enterasys.com
+         Phone:      +1 603-337-2614
+
+         Co-editor:  David B. Levi
+                     Nortel Networks
+         Postal:     3505 Kesterwood Drive
+                     Knoxville, Tennessee 37918
+         EMail:      dlevi@nortelnetworks.com
+         Phone:      +1 865 686 0432
+
+         Co-editor:  Paul Meyer
+                     Secure Computing Corporation
+         Postal:     2675 Long Lake Road
+
+                     Roseville, Minnesota 55113
+         EMail:      paul_meyer@securecomputing.com
+         Phone:      +1 651 628 1592
+
+         Co-editor:  Bob Stewart
+                     Retired"
+    DESCRIPTION
+        "This MIB module defines MIB objects which provide
+         mechanisms to remotely configure the parameters used
+         by an SNMP entity for the generation of SNMP messages.
+
+         Copyright (C) The Internet Society (2002). This
+         version of this MIB module is part of RFC 3413;
+         see the RFC itself for full legal notices.
+        "
+    REVISION    "200210140000Z"             -- 14 October 2002
+    DESCRIPTION "Fixed DISPLAY-HINTS for UTF-8 strings, fixed hex
+                 value of LF characters, clarified meaning of zero
+                 length tag values, improved tag list examples.
+                 Published as RFC 3413."
+    REVISION    "199808040000Z"             -- 4 August 1998
+    DESCRIPTION "Clarifications, published as
+                 RFC 2573."
+    REVISION    "199707140000Z"             -- 14 July 1997
+    DESCRIPTION "The initial revision, published as RFC2273."
+    ::= { snmpModules 12 }
+
+snmpTargetObjects       OBJECT IDENTIFIER ::= { snmpTargetMIB 1 }
+snmpTargetConformance   OBJECT IDENTIFIER ::= { snmpTargetMIB 3 }
+
+SnmpTagValue ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a tag value.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, and certain
+
+         control codes are not allowed as described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         Note that when this TC is used for an object that
+         is used or envisioned to be used as an index, then a
+         SIZE restriction must be specified so that the number
+         of sub-identifiers for any object instance does not
+         exceed the limit of 128, as defined by [RFC1905].
+
+         An object of this type contains a single tag value
+         which is used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+         in a tag list.  An object of this type may only
+         contain a single tag value, and so delimiter
+         characters are not allowed in a value of this type.
+
+         Note that a tag value of 0 length means that no tag is
+         defined.  In other words, a tag value of 0 length would
+         never match anything in a tag list, and would never
+         select any table entries.
+
+         Some examples of valid tag values are:
+
+             - 'acme'
+
+             - 'router'
+
+             - 'host'
+
+         The use of a tag value to select table entries is
+         application and MIB specific."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+SnmpTagList ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255t"
+    STATUS       current
+    DESCRIPTION
+        "An octet string containing a list of tag values.
+         Tag values are preferably in human-readable form.
+
+         To facilitate internationalization, this information
+         is represented using the ISO/IEC IS 10646-1 character
+         set, encoded as an octet string using the UTF-8
+         character encoding scheme described in RFC 2279.
+
+         Since additional code points are added by amendments
+         to the 10646 standard from time to time,
+         implementations must be prepared to encounter any code
+         point from 0x00000000 to 0x7fffffff.
+
+         The use of control codes should be avoided, except as
+         described below.
+
+         For code points not directly supported by user
+         interface hardware or software, an alternative means
+         of entry and display, such as hexadecimal, may be
+         provided.
+
+         For information encoded in 7-bit US-ASCII, the UTF-8
+         representation is identical to the US-ASCII encoding.
+
+         An object of this type contains a list of tag values
+         which are used to select a set of entries in a table.
+
+         A tag value is an arbitrary string of octets, but
+         may not contain a delimiter character.  Delimiter
+         characters are defined to be one of the following:
+
+             -  An ASCII space character (0x20).
+
+             -  An ASCII TAB character (0x09).
+
+             -  An ASCII carriage return (CR) character (0x0D).
+
+             -  An ASCII line feed (LF) character (0x0A).
+
+         Delimiter characters are used to separate tag values
+
+         in a tag list.  Only a single delimiter character may
+         occur between two tag values.  A tag value may not
+         have a zero length.  These constraints imply certain
+         restrictions on the contents of this object:
+
+             - There cannot be a leading or trailing delimiter
+               character.
+
+             - There cannot be multiple adjacent delimiter
+               characters.
+
+         Some examples of valid tag lists are:
+
+             - ''                        -- an empty list
+
+             - 'acme'                    -- list of one tag
+
+             - 'host router bridge'      -- list of several tags
+
+         Note that although a tag value may not have a length of
+         zero, an empty string is still valid.  This indicates
+         an empty list (i.e. there are no tag values in the list).
+
+         The use of the tag list to select table entries is
+         application and MIB specific.  Typically, an application
+         will provide one or more tag values, and any entry
+         which contains some combination of these tag values
+         will be selected."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+--
+--
+-- The snmpTargetObjects group
+--
+--
+
+snmpTargetSpinLock OBJECT-TYPE
+    SYNTAX      TestAndIncr
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+        "This object is used to facilitate modification of table
+         entries in the SNMP-TARGET-MIB module by multiple
+         managers.  In particular, it is useful when modifying
+         the value of the snmpTargetAddrTagList object.
+
+         The procedure for modifying the snmpTargetAddrTagList
+         object is as follows:
+
+             1.  Retrieve the value of snmpTargetSpinLock and
+                 of snmpTargetAddrTagList.
+
+             2.  Generate a new value for snmpTargetAddrTagList.
+
+             3.  Set the value of snmpTargetSpinLock to the
+                 retrieved value, and the value of
+                 snmpTargetAddrTagList to the new value.  If
+                 the set fails for the snmpTargetSpinLock
+                 object, go back to step 1."
+    ::= { snmpTargetObjects 1 }
+
+snmpTargetAddrTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of transport addresses to be used in the generation
+         of SNMP messages."
+    ::= { snmpTargetObjects 2 }
+
+snmpTargetAddrEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetAddrEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A transport address to be used in the generation
+         of SNMP operations.
+
+         Entries in the snmpTargetAddrTable are created and
+         deleted using the snmpTargetAddrRowStatus object."
+    INDEX { IMPLIED snmpTargetAddrName }
+    ::= { snmpTargetAddrTable 1 }
+
+SnmpTargetAddrEntry ::= SEQUENCE {
+    snmpTargetAddrName         SnmpAdminString,
+    snmpTargetAddrTDomain      TDomain,
+    snmpTargetAddrTAddress     TAddress,
+    snmpTargetAddrTimeout      TimeInterval,
+    snmpTargetAddrRetryCount   Integer32,
+    snmpTargetAddrTagList      SnmpTagList,
+    snmpTargetAddrParams       SnmpAdminString,
+    snmpTargetAddrStorageType  StorageType,
+    snmpTargetAddrRowStatus    RowStatus
+}
+
+snmpTargetAddrName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetAddrEntry."
+    ::= { snmpTargetAddrEntry 1 }
+
+snmpTargetAddrTDomain OBJECT-TYPE
+    SYNTAX      TDomain
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object indicates the transport type of the address
+         contained in the snmpTargetAddrTAddress object."
+    ::= { snmpTargetAddrEntry 2 }
+
+snmpTargetAddrTAddress OBJECT-TYPE
+    SYNTAX      TAddress
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a transport address.  The format of
+         this address depends on the value of the
+         snmpTargetAddrTDomain object."
+    ::= { snmpTargetAddrEntry 3 }
+
+snmpTargetAddrTimeout OBJECT-TYPE
+    SYNTAX      TimeInterval
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object should reflect the expected maximum round
+         trip time for communicating with the transport address
+         defined by this row.  When a message is sent to this
+         address, and a response (if one is expected) is not
+         received within this time period, an implementation
+         may assume that the response will not be delivered.
+
+         Note that the time interval that an application waits
+         for a response may actually be derived from the value
+         of this object.  The method for deriving the actual time
+         interval is implementation dependent.  One such method
+         is to derive the expected round trip time based on a
+         particular retransmission algorithm and on the number
+         of timeouts which have occurred.  The type of message may
+         also be considered when deriving expected round trip
+         times for retransmissions.  For example, if a message is
+         being sent with a securityLevel that indicates both
+
+         authentication and privacy, the derived value may be
+         increased to compensate for extra processing time spent
+         during authentication and encryption processing."
+    DEFVAL { 1500 }
+    ::= { snmpTargetAddrEntry 4 }
+
+snmpTargetAddrRetryCount OBJECT-TYPE
+    SYNTAX      Integer32 (0..255)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object specifies a default number of retries to be
+         attempted when a response is not received for a generated
+         message.  An application may provide its own retry count,
+         in which case the value of this object is ignored."
+    DEFVAL { 3 }
+    ::= { snmpTargetAddrEntry 5 }
+
+snmpTargetAddrTagList OBJECT-TYPE
+    SYNTAX      SnmpTagList
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "This object contains a list of tag values which are
+         used to select target addresses for a particular
+         operation."
+    DEFVAL { "" }
+    ::= { snmpTargetAddrEntry 6 }
+
+snmpTargetAddrParams OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The value of this object identifies an entry in the
+         snmpTargetParamsTable.  The identified entry
+         contains SNMP parameters to be used when generating
+         messages to be sent to this transport address."
+    ::= { snmpTargetAddrEntry 7 }
+
+snmpTargetAddrStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetAddrEntry 8 }
+
+snmpTargetAddrRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetAddrRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding instances of
+         snmpTargetAddrTDomain, snmpTargetAddrTAddress, and
+         snmpTargetAddrParams have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetAddrTDomain
+             - snmpTargetAddrTAddress
+         An attempt to set these objects while the value of
+         snmpTargetAddrRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetAddrEntry 9 }
+
+snmpTargetParamsTable OBJECT-TYPE
+    SYNTAX      SEQUENCE OF SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A table of SNMP target information to be used
+         in the generation of SNMP messages."
+    ::= { snmpTargetObjects 3 }
+
+snmpTargetParamsEntry OBJECT-TYPE
+    SYNTAX      SnmpTargetParamsEntry
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "A set of SNMP target information.
+
+         Entries in the snmpTargetParamsTable are created and
+         deleted using the snmpTargetParamsRowStatus object."
+    INDEX { IMPLIED snmpTargetParamsName }
+    ::= { snmpTargetParamsTable 1 }
+
+SnmpTargetParamsEntry ::= SEQUENCE {
+    snmpTargetParamsName           SnmpAdminString,
+    snmpTargetParamsMPModel        SnmpMessageProcessingModel,
+    snmpTargetParamsSecurityModel  SnmpSecurityModel,
+    snmpTargetParamsSecurityName   SnmpAdminString,
+    snmpTargetParamsSecurityLevel  SnmpSecurityLevel,
+    snmpTargetParamsStorageType    StorageType,
+    snmpTargetParamsRowStatus      RowStatus
+}
+
+snmpTargetParamsName OBJECT-TYPE
+    SYNTAX      SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS  not-accessible
+    STATUS      current
+    DESCRIPTION
+        "The locally arbitrary, but unique identifier associated
+         with this snmpTargetParamsEntry."
+    ::= { snmpTargetParamsEntry 1 }
+
+snmpTargetParamsMPModel OBJECT-TYPE
+    SYNTAX      SnmpMessageProcessingModel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Message Processing Model to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 2 }
+
+snmpTargetParamsSecurityModel OBJECT-TYPE
+    SYNTAX      SnmpSecurityModel (1..2147483647)
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Security Model to be used when generating SNMP
+          messages using this entry.  An implementation may
+          choose to return an inconsistentValue error if an
+          attempt is made to set this variable to a value
+          for a security model which the implementation does
+          not support."
+    ::= { snmpTargetParamsEntry 3 }
+
+snmpTargetParamsSecurityName OBJECT-TYPE
+    SYNTAX      SnmpAdminString
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The securityName which identifies the Principal on
+         whose behalf SNMP messages will be generated using
+         this entry."
+    ::= { snmpTargetParamsEntry 4 }
+
+snmpTargetParamsSecurityLevel OBJECT-TYPE
+    SYNTAX      SnmpSecurityLevel
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The Level of Security to be used when generating
+         SNMP messages using this entry."
+    ::= { snmpTargetParamsEntry 5 }
+
+snmpTargetParamsStorageType OBJECT-TYPE
+    SYNTAX      StorageType
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The storage type for this conceptual row.
+         Conceptual rows having the value 'permanent' need not
+         allow write-access to any columnar objects in the row."
+    DEFVAL { nonVolatile }
+    ::= { snmpTargetParamsEntry 6 }
+
+snmpTargetParamsRowStatus OBJECT-TYPE
+    SYNTAX      RowStatus
+    MAX-ACCESS  read-create
+    STATUS      current
+    DESCRIPTION
+        "The status of this conceptual row.
+
+         To create a row in this table, a manager must
+         set this object to either createAndGo(4) or
+         createAndWait(5).
+
+         Until instances of all corresponding columns are
+         appropriately configured, the value of the
+         corresponding instance of the snmpTargetParamsRowStatus
+         column is 'notReady'.
+
+         In particular, a newly created row cannot be made
+         active until the corresponding
+         snmpTargetParamsMPModel,
+         snmpTargetParamsSecurityModel,
+         snmpTargetParamsSecurityName,
+         and snmpTargetParamsSecurityLevel have all been set.
+
+         The following objects may not be modified while the
+         value of this object is active(1):
+             - snmpTargetParamsMPModel
+             - snmpTargetParamsSecurityModel
+             - snmpTargetParamsSecurityName
+             - snmpTargetParamsSecurityLevel
+         An attempt to set these objects while the value of
+         snmpTargetParamsRowStatus is active(1) will result in
+         an inconsistentValue error."
+    ::= { snmpTargetParamsEntry 7 }
+
+snmpUnavailableContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unavailable."
+    ::= { snmpTargetObjects 4 }
+
+snmpUnknownContexts OBJECT-TYPE
+    SYNTAX       Counter32
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION
+        "The total number of packets received by the SNMP
+         engine which were dropped because the context
+         contained in the message was unknown."
+    ::= { snmpTargetObjects 5 }
+
+--
+--
+-- Conformance information
+--
+--
+
+snmpTargetCompliances OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 1 }
+snmpTargetGroups      OBJECT IDENTIFIER ::=
+                                        { snmpTargetConformance 2 }
+
+--
+--
+-- Compliance statements
+
+--
+--
+
+snmpTargetCommandResponderCompliance MODULE-COMPLIANCE
+    STATUS      current
+    DESCRIPTION
+        "The compliance statement for SNMP entities which include
+         a command responder application."
+    MODULE -- This Module
+        MANDATORY-GROUPS { snmpTargetCommandResponderGroup }
+    ::= { snmpTargetCompliances 1 }
+
+snmpTargetBasicGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetSpinLock,
+        snmpTargetAddrTDomain,
+        snmpTargetAddrTAddress,
+        snmpTargetAddrTagList,
+        snmpTargetAddrParams,
+        snmpTargetAddrStorageType,
+        snmpTargetAddrRowStatus,
+        snmpTargetParamsMPModel,
+        snmpTargetParamsSecurityModel,
+        snmpTargetParamsSecurityName,
+        snmpTargetParamsSecurityLevel,
+        snmpTargetParamsStorageType,
+        snmpTargetParamsRowStatus
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing basic remote
+         configuration of management targets."
+    ::= { snmpTargetGroups 1 }
+
+snmpTargetResponseGroup OBJECT-GROUP
+    OBJECTS {
+        snmpTargetAddrTimeout,
+        snmpTargetAddrRetryCount
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects providing remote configuration
+         of management targets for applications which generate
+         SNMP messages for which a response message would be
+         expected."
+    ::= { snmpTargetGroups 2 }
+
+snmpTargetCommandResponderGroup OBJECT-GROUP
+
+    OBJECTS {
+        snmpUnavailableContexts,
+        snmpUnknownContexts
+    }
+    STATUS      current
+    DESCRIPTION
+        "A collection of objects required for command responder
+         applications, used for counting error conditions."
+    ::= { snmpTargetGroups 3 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..7244ad0afb5837e33f3d8cea9f0f19fe5f066d43
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt
@@ -0,0 +1,830 @@
+SNMP-VIEW-BASED-ACM-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF
+    MODULE-IDENTITY, OBJECT-TYPE,
+    snmpModules                           FROM SNMPv2-SMI
+    TestAndIncr,
+    RowStatus, StorageType                FROM SNMPv2-TC
+    SnmpAdminString,
+    SnmpSecurityLevel,
+    SnmpSecurityModel                     FROM SNMP-FRAMEWORK-MIB;
+
+snmpVacmMIB       MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"          -- 16 Oct 2002, midnight
+    ORGANIZATION "SNMPv3 Working Group"
+    CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
+                  Subscribe:  majordomo@lists.tislabs.com
+                              In message body:  subscribe snmpv3
+
+                  Co-Chair:   Russ Mundy
+                              Network Associates Laboratories
+                  postal:     15204 Omega Drive, Suite 300
+                              Rockville, MD 20850-4601
+                              USA
+                  email:      mundy@tislabs.com
+                  phone:      +1 301-947-7107
+
+                  Co-Chair:   David Harrington
+                              Enterasys Networks
+                  Postal:     35 Industrial Way
+                              P. O. Box 5004
+                              Rochester, New Hampshire 03866-5005
+                              USA
+                  EMail:      dbh@enterasys.com
+                  Phone:      +1 603-337-2614
+
+                  Co-editor:  Bert Wijnen
+                              Lucent Technologies
+                  postal:     Schagen 33
+                              3461 GL Linschoten
+                              Netherlands
+                  email:      bwijnen@lucent.com
+                  phone:      +31-348-480-685
+
+                  Co-editor:  Randy Presuhn
+                              BMC Software, Inc.
+
+                  postal:     2141 North First Street
+                              San Jose, CA 95131
+                              USA
+                  email:      randy_presuhn@bmc.com
+                  phone:      +1 408-546-1006
+
+                  Co-editor:  Keith McCloghrie
+                              Cisco Systems, Inc.
+                  postal:     170 West Tasman Drive
+                              San Jose, CA  95134-1706
+                              USA
+                  email:      kzm@cisco.com
+                  phone:      +1-408-526-5260
+                 "
+    DESCRIPTION  "The management information definitions for the
+                  View-based Access Control Model for SNMP.
+
+                  Copyright (C) The Internet Society (2002). This
+                  version of this MIB module is part of RFC 3415;
+                  see the RFC itself for full legal notices.
+                 "
+--  Revision history
+
+    REVISION     "200210160000Z"          -- 16 Oct 2002, midnight
+    DESCRIPTION  "Clarifications, published as RFC3415"
+
+    REVISION     "199901200000Z"          -- 20 Jan 1999, midnight
+    DESCRIPTION  "Clarifications, published as RFC2575"
+
+    REVISION     "199711200000Z"          -- 20 Nov 1997, midnight
+    DESCRIPTION  "Initial version, published as RFC2275"
+    ::= { snmpModules 16 }
+
+-- Administrative assignments ****************************************
+
+vacmMIBObjects      OBJECT IDENTIFIER ::= { snmpVacmMIB 1 }
+vacmMIBConformance  OBJECT IDENTIFIER ::= { snmpVacmMIB 2 }
+
+-- Information about Local Contexts **********************************
+
+vacmContextTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of locally available contexts.
+
+                 This table provides information to SNMP Command
+
+                 Generator applications so that they can properly
+                 configure the vacmAccessTable to control access to
+                 all contexts at the SNMP entity.
+
+                 This table may change dynamically if the SNMP entity
+                 allows that contexts are added/deleted dynamically
+                 (for instance when its configuration changes).  Such
+                 changes would happen only if the management
+                 instrumentation at that SNMP entity recognizes more
+                 (or fewer) contexts.
+
+                 The presence of entries in this table and of entries
+                 in the vacmAccessTable are independent.  That is, a
+                 context identified by an entry in this table is not
+                 necessarily referenced by any entries in the
+                 vacmAccessTable; and the context(s) referenced by an
+                 entry in the vacmAccessTable does not necessarily
+                 currently exist and thus need not be identified by an
+                 entry in this table.
+
+                 This table must be made accessible via the default
+                 context so that Command Responder applications have
+                 a standard way of retrieving the information.
+
+                 This table is read-only.  It cannot be configured via
+                 SNMP.
+                "
+    ::= { vacmMIBObjects 1 }
+
+vacmContextEntry OBJECT-TYPE
+    SYNTAX       VacmContextEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information about a particular context."
+    INDEX       {
+                  vacmContextName
+                }
+    ::= { vacmContextTable 1 }
+
+VacmContextEntry ::= SEQUENCE
+    {
+        vacmContextName SnmpAdminString
+    }
+
+vacmContextName  OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-only
+    STATUS       current
+    DESCRIPTION "A human readable name identifying a particular
+                 context at a particular SNMP entity.
+
+                 The empty contextName (zero length) represents the
+                 default context.
+                "
+    ::= { vacmContextEntry 1 }
+
+-- Information about Groups ******************************************
+
+vacmSecurityToGroupTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "This table maps a combination of securityModel and
+                 securityName into a groupName which is used to define
+                 an access control policy for a group of principals.
+                "
+    ::= { vacmMIBObjects 2 }
+
+vacmSecurityToGroupEntry OBJECT-TYPE
+    SYNTAX       VacmSecurityToGroupEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An entry in this table maps the combination of a
+                 securityModel and securityName into a groupName.
+                "
+    INDEX       {
+                  vacmSecurityModel,
+                  vacmSecurityName
+                }
+    ::= { vacmSecurityToGroupTable 1 }
+
+VacmSecurityToGroupEntry ::= SEQUENCE
+    {
+        vacmSecurityModel               SnmpSecurityModel,
+        vacmSecurityName                SnmpAdminString,
+        vacmGroupName                   SnmpAdminString,
+        vacmSecurityToGroupStorageType  StorageType,
+        vacmSecurityToGroupStatus       RowStatus
+    }
+
+vacmSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel(1..2147483647)
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The Security Model, by which the vacmSecurityName
+                 referenced by this entry is provided.
+
+                 Note, this object may not take the 'any' (0) value.
+                "
+    ::= { vacmSecurityToGroupEntry 1 }
+
+vacmSecurityName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The securityName for the principal, represented in a
+                 Security Model independent format, which is mapped by
+                 this entry to a groupName.
+                "
+    ::= { vacmSecurityToGroupEntry 2 }
+
+vacmGroupName    OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The name of the group to which this entry (e.g., the
+                 combination of securityModel and securityName)
+                 belongs.
+
+                 This groupName is used as index into the
+                 vacmAccessTable to select an access control policy.
+                 However, a value in this table does not imply that an
+                 instance with the value exists in table vacmAccesTable.
+                "
+    ::= { vacmSecurityToGroupEntry 3 }
+
+vacmSecurityToGroupStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmSecurityToGroupEntry 4 }
+
+vacmSecurityToGroupStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 Until instances of all corresponding columns are
+                 appropriately configured, the value of the
+
+                 corresponding instance of the vacmSecurityToGroupStatus
+                 column is 'notReady'.
+
+                 In particular, a newly created row cannot be made
+                 active until a value has been set for vacmGroupName.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmSecurityToGroupEntry 5 }
+
+-- Information about Access Rights ***********************************
+
+vacmAccessTable  OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The table of access rights for groups.
+
+                 Each entry is indexed by a groupName, a contextPrefix,
+                 a securityModel and a securityLevel.  To determine
+                 whether access is allowed, one entry from this table
+                 needs to be selected and the proper viewName from that
+                 entry must be used for access control checking.
+
+                 To select the proper entry, follow these steps:
+
+                 1) the set of possible matches is formed by the
+                    intersection of the following sets of entries:
+
+                      the set of entries with identical vacmGroupName
+                      the union of these two sets:
+                       - the set with identical vacmAccessContextPrefix
+                       - the set of entries with vacmAccessContextMatch
+                         value of 'prefix' and matching
+                         vacmAccessContextPrefix
+                      intersected with the union of these two sets:
+                       - the set of entries with identical
+                         vacmSecurityModel
+                       - the set of entries with vacmSecurityModel
+                         value of 'any'
+                      intersected with the set of entries with
+                      vacmAccessSecurityLevel value less than or equal
+                      to the requested securityLevel
+
+                 2) if this set has only one member, we're done
+                    otherwise, it comes down to deciding how to weight
+                    the preferences between ContextPrefixes,
+                    SecurityModels, and SecurityLevels as follows:
+                    a) if the subset of entries with securityModel
+                       matching the securityModel in the message is
+                       not empty, then discard the rest.
+                    b) if the subset of entries with
+                       vacmAccessContextPrefix matching the contextName
+                       in the message is not empty,
+                       then discard the rest
+                    c) discard all entries with ContextPrefixes shorter
+                       than the longest one remaining in the set
+                    d) select the entry with the highest securityLevel
+
+                 Please note that for securityLevel noAuthNoPriv, all
+                 groups are really equivalent since the assumption that
+                 the securityName has been authenticated does not hold.
+                "
+    ::= { vacmMIBObjects 4 }
+
+vacmAccessEntry  OBJECT-TYPE
+    SYNTAX       VacmAccessEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "An access right configured in the Local Configuration
+                 Datastore (LCD) authorizing access to an SNMP context.
+
+                 Entries in this table can use an instance value for
+                 object vacmGroupName even if no entry in table
+                 vacmAccessSecurityToGroupTable has a corresponding
+                 value for object vacmGroupName.
+                "
+    INDEX       { vacmGroupName,
+                  vacmAccessContextPrefix,
+                  vacmAccessSecurityModel,
+                  vacmAccessSecurityLevel
+                }
+    ::= { vacmAccessTable 1 }
+
+VacmAccessEntry ::= SEQUENCE
+    {
+        vacmAccessContextPrefix    SnmpAdminString,
+        vacmAccessSecurityModel    SnmpSecurityModel,
+        vacmAccessSecurityLevel    SnmpSecurityLevel,
+        vacmAccessContextMatch     INTEGER,
+        vacmAccessReadViewName     SnmpAdminString,
+        vacmAccessWriteViewName    SnmpAdminString,
+        vacmAccessNotifyViewName   SnmpAdminString,
+        vacmAccessStorageType      StorageType,
+        vacmAccessStatus           RowStatus
+    }
+
+vacmAccessContextPrefix OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, a contextName must match exactly
+                 (if the value of vacmAccessContextMatch is 'exact')
+                 or partially (if the value of vacmAccessContextMatch
+                 is 'prefix') to the value of the instance of this
+                 object.
+                "
+    ::= { vacmAccessEntry 1 }
+
+vacmAccessSecurityModel OBJECT-TYPE
+    SYNTAX       SnmpSecurityModel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "In order to gain the access rights allowed by this
+                 conceptual row, this securityModel must be in use.
+                "
+    ::= { vacmAccessEntry 2 }
+
+vacmAccessSecurityLevel OBJECT-TYPE
+    SYNTAX       SnmpSecurityLevel
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The minimum level of security required in order to
+                 gain the access rights allowed by this conceptual
+                 row.  A securityLevel of noAuthNoPriv is less than
+                 authNoPriv which in turn is less than authPriv.
+
+                 If multiple entries are equally indexed except for
+                 this vacmAccessSecurityLevel index, then the entry
+                 which has the highest value for
+                 vacmAccessSecurityLevel is selected.
+                "
+    ::= { vacmAccessEntry 3 }
+
+vacmAccessContextMatch OBJECT-TYPE
+    SYNTAX       INTEGER
+                { exact (1), -- exact match of prefix and contextName
+                  prefix (2) -- Only match to the prefix
+                }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "If the value of this object is exact(1), then all
+                 rows where the contextName exactly matches
+                 vacmAccessContextPrefix are selected.
+
+                 If the value of this object is prefix(2), then all
+                 rows where the contextName whose starting octets
+                 exactly match vacmAccessContextPrefix are selected.
+                 This allows for a simple form of wildcarding.
+                "
+    DEFVAL      { exact }
+    ::= { vacmAccessEntry 4 }
+
+vacmAccessReadViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes read access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 5 }
+
+vacmAccessWriteViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes write access.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 6 }
+
+vacmAccessNotifyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(0..32))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The value of an instance of this object identifies
+                 the MIB view of the SNMP context to which this
+                 conceptual row authorizes access for notifications.
+
+                 The identified MIB view is that one for which the
+                 vacmViewTreeFamilyViewName has the same value as the
+                 instance of this object; if the value is the empty
+                 string or if there is no active MIB view having this
+                 value of vacmViewTreeFamilyViewName, then no access
+                 is granted.
+                "
+    DEFVAL      { ''H }   -- the empty string
+    ::= { vacmAccessEntry 7 }
+
+vacmAccessStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmAccessEntry 8 }
+
+vacmAccessStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmAccessEntry 9 }
+
+-- Information about MIB views ***************************************
+
+-- Support for instance-level granularity is optional.
+--
+-- In some implementations, instance-level access control
+-- granularity may come at a high performance cost.  Managers
+-- should avoid requesting such configurations unnecessarily.
+
+vacmMIBViews     OBJECT IDENTIFIER ::= { vacmMIBObjects 5 }
+
+vacmViewSpinLock OBJECT-TYPE
+    SYNTAX       TestAndIncr
+    MAX-ACCESS   read-write
+    STATUS       current
+    DESCRIPTION "An advisory lock used to allow cooperating SNMP
+                 Command Generator applications to coordinate their
+                 use of the Set operation in creating or modifying
+                 views.
+
+                 When creating a new view or altering an existing
+                 view, it is important to understand the potential
+                 interactions with other uses of the view.  The
+                 vacmViewSpinLock should be retrieved.  The name of
+                 the view to be created should be determined to be
+                 unique by the SNMP Command Generator application by
+                 consulting the vacmViewTreeFamilyTable.  Finally,
+                 the named view may be created (Set), including the
+                 advisory lock.
+                 If another SNMP Command Generator application has
+                 altered the views in the meantime, then the spin
+                 lock's value will have changed, and so this creation
+                 will fail because it will specify the wrong value for
+                 the spin lock.
+
+                 Since this is an advisory lock, the use of this lock
+                 is not enforced.
+                "
+    ::= { vacmMIBViews 1 }
+
+vacmViewTreeFamilyTable OBJECT-TYPE
+    SYNTAX       SEQUENCE OF VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Locally held information about families of subtrees
+                 within MIB views.
+
+                 Each MIB view is defined by two sets of view subtrees:
+                   - the included view subtrees, and
+                   - the excluded view subtrees.
+                 Every such view subtree, both the included and the
+
+                 excluded ones, is defined in this table.
+
+                 To determine if a particular object instance is in
+                 a particular MIB view, compare the object instance's
+                 OBJECT IDENTIFIER with each of the MIB view's active
+                 entries in this table.  If none match, then the
+                 object instance is not in the MIB view.  If one or
+                 more match, then the object instance is included in,
+                 or excluded from, the MIB view according to the
+                 value of vacmViewTreeFamilyType in the entry whose
+                 value of vacmViewTreeFamilySubtree has the most
+                 sub-identifiers.  If multiple entries match and have
+                 the same number of sub-identifiers (when wildcarding
+                 is specified with the value of vacmViewTreeFamilyMask),
+                 then the lexicographically greatest instance of
+                 vacmViewTreeFamilyType determines the inclusion or
+                 exclusion.
+
+                 An object instance's OBJECT IDENTIFIER X matches an
+                 active entry in this table when the number of
+                 sub-identifiers in X is at least as many as in the
+                 value of vacmViewTreeFamilySubtree for the entry,
+                 and each sub-identifier in the value of
+                 vacmViewTreeFamilySubtree matches its corresponding
+                 sub-identifier in X.  Two sub-identifiers match
+                 either if the corresponding bit of the value of
+                 vacmViewTreeFamilyMask for the entry is zero (the
+                 'wild card' value), or if they are equal.
+
+                 A 'family' of subtrees is the set of subtrees defined
+                 by a particular combination of values of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask.
+
+                 In the case where no 'wild card' is defined in the
+                 vacmViewTreeFamilyMask, the family of subtrees reduces
+                 to a single subtree.
+
+                 When creating or changing MIB views, an SNMP Command
+                 Generator application should utilize the
+                 vacmViewSpinLock to try to avoid collisions.  See
+                 DESCRIPTION clause of vacmViewSpinLock.
+
+                 When creating MIB views, it is strongly advised that
+                 first the 'excluded' vacmViewTreeFamilyEntries are
+                 created and then the 'included' entries.
+
+                 When deleting MIB views, it is strongly advised that
+                 first the 'included' vacmViewTreeFamilyEntries are
+
+                 deleted and then the 'excluded' entries.
+
+                 If a create for an entry for instance-level access
+                 control is received and the implementation does not
+                 support instance-level granularity, then an
+                 inconsistentName error must be returned.
+                "
+    ::= { vacmMIBViews 2 }
+
+vacmViewTreeFamilyEntry OBJECT-TYPE
+    SYNTAX       VacmViewTreeFamilyEntry
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "Information on a particular family of view subtrees
+                 included in or excluded from a particular SNMP
+                 context's MIB view.
+
+                 Implementations must not restrict the number of
+                 families of view subtrees for a given MIB view,
+                 except as dictated by resource constraints on the
+                 overall number of entries in the
+                 vacmViewTreeFamilyTable.
+
+                 If no conceptual rows exist in this table for a given
+                 MIB view (viewName), that view may be thought of as
+                 consisting of the empty set of view subtrees.
+                "
+    INDEX       { vacmViewTreeFamilyViewName,
+                  vacmViewTreeFamilySubtree
+                }
+    ::= { vacmViewTreeFamilyTable 1 }
+
+VacmViewTreeFamilyEntry ::= SEQUENCE
+    {
+        vacmViewTreeFamilyViewName     SnmpAdminString,
+        vacmViewTreeFamilySubtree      OBJECT IDENTIFIER,
+        vacmViewTreeFamilyMask         OCTET STRING,
+        vacmViewTreeFamilyType         INTEGER,
+        vacmViewTreeFamilyStorageType  StorageType,
+        vacmViewTreeFamilyStatus       RowStatus
+    }
+
+vacmViewTreeFamilyViewName OBJECT-TYPE
+    SYNTAX       SnmpAdminString (SIZE(1..32))
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The human readable name for a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 1 }
+
+vacmViewTreeFamilySubtree OBJECT-TYPE
+    SYNTAX       OBJECT IDENTIFIER
+    MAX-ACCESS   not-accessible
+    STATUS       current
+    DESCRIPTION "The MIB subtree which when combined with the
+                 corresponding instance of vacmViewTreeFamilyMask
+                 defines a family of view subtrees.
+                "
+    ::= { vacmViewTreeFamilyEntry 2 }
+
+vacmViewTreeFamilyMask OBJECT-TYPE
+    SYNTAX       OCTET STRING (SIZE (0..16))
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The bit mask which, in combination with the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 defines a family of view subtrees.
+
+                 Each bit of this bit mask corresponds to a
+                 sub-identifier of vacmViewTreeFamilySubtree, with the
+                 most significant bit of the i-th octet of this octet
+                 string value (extended if necessary, see below)
+                 corresponding to the (8*i - 7)-th sub-identifier, and
+                 the least significant bit of the i-th octet of this
+                 octet string corresponding to the (8*i)-th
+                 sub-identifier, where i is in the range 1 through 16.
+
+                 Each bit of this bit mask specifies whether or not
+                 the corresponding sub-identifiers must match when
+                 determining if an OBJECT IDENTIFIER is in this
+                 family of view subtrees; a '1' indicates that an
+                 exact match must occur; a '0' indicates 'wild card',
+                 i.e., any sub-identifier value matches.
+
+                 Thus, the OBJECT IDENTIFIER X of an object instance
+                 is contained in a family of view subtrees if, for
+                 each sub-identifier of the value of
+                 vacmViewTreeFamilySubtree, either:
+
+                   the i-th bit of vacmViewTreeFamilyMask is 0, or
+
+                   the i-th sub-identifier of X is equal to the i-th
+                   sub-identifier of the value of
+                   vacmViewTreeFamilySubtree.
+
+                 If the value of this bit mask is M bits long and
+
+                 there are more than M sub-identifiers in the
+                 corresponding instance of vacmViewTreeFamilySubtree,
+                 then the bit mask is extended with 1's to be the
+                 required length.
+
+                 Note that when the value of this object is the
+                 zero-length string, this extension rule results in
+                 a mask of all-1's being used (i.e., no 'wild card'),
+                 and the family of view subtrees is the one view
+                 subtree uniquely identified by the corresponding
+                 instance of vacmViewTreeFamilySubtree.
+
+                 Note that masks of length greater than zero length
+                 do not need to be supported.  In this case this
+                 object is made read-only.
+                "
+    DEFVAL      { ''H }
+    ::= { vacmViewTreeFamilyEntry 3 }
+
+vacmViewTreeFamilyType OBJECT-TYPE
+    SYNTAX       INTEGER  { included(1), excluded(2) }
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "Indicates whether the corresponding instances of
+                 vacmViewTreeFamilySubtree and vacmViewTreeFamilyMask
+                 define a family of view subtrees which is included in
+                 or excluded from the MIB view.
+                "
+    DEFVAL      { included }
+    ::= { vacmViewTreeFamilyEntry 4 }
+
+vacmViewTreeFamilyStorageType OBJECT-TYPE
+    SYNTAX       StorageType
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The storage type for this conceptual row.
+
+                 Conceptual rows having the value 'permanent' need not
+                 allow write-access to any columnar objects in the row.
+                "
+    DEFVAL      { nonVolatile }
+    ::= { vacmViewTreeFamilyEntry 5 }
+
+vacmViewTreeFamilyStatus OBJECT-TYPE
+    SYNTAX       RowStatus
+    MAX-ACCESS   read-create
+    STATUS       current
+    DESCRIPTION "The status of this conceptual row.
+
+                 The  RowStatus TC [RFC2579] requires that this
+                 DESCRIPTION clause states under which circumstances
+                 other objects in this row can be modified:
+
+                 The value of this object has no effect on whether
+                 other objects in this conceptual row can be modified.
+                "
+    ::= { vacmViewTreeFamilyEntry 6 }
+
+-- Conformance information *******************************************
+
+vacmMIBCompliances  OBJECT IDENTIFIER ::= { vacmMIBConformance 1 }
+vacmMIBGroups       OBJECT IDENTIFIER ::= { vacmMIBConformance 2 }
+
+-- Compliance statements *********************************************
+
+vacmMIBCompliance MODULE-COMPLIANCE
+    STATUS       current
+    DESCRIPTION "The compliance statement for SNMP engines which
+                 implement the SNMP View-based Access Control Model
+                 configuration MIB.
+                "
+    MODULE -- this module
+        MANDATORY-GROUPS { vacmBasicGroup }
+
+        OBJECT        vacmAccessContextMatch
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessReadViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessWriteViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessNotifyViewName
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmAccessStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+
+                      vacmAccessTable is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyMask
+        WRITE-SYNTAX  OCTET STRING (SIZE (0))
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Support for configuration via SNMP of subtree
+                      families using wild-cards is not required.
+                     "
+
+        OBJECT        vacmViewTreeFamilyType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStorageType
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Write access is not required."
+
+        OBJECT        vacmViewTreeFamilyStatus
+        MIN-ACCESS    read-only
+        DESCRIPTION  "Create/delete/modify access to the
+                      vacmViewTreeFamilyTable is not required.
+                     "
+    ::= { vacmMIBCompliances 1 }
+
+-- Units of conformance **********************************************
+
+vacmBasicGroup OBJECT-GROUP
+    OBJECTS {
+              vacmContextName,
+              vacmGroupName,
+              vacmSecurityToGroupStorageType,
+              vacmSecurityToGroupStatus,
+              vacmAccessContextMatch,
+              vacmAccessReadViewName,
+              vacmAccessWriteViewName,
+              vacmAccessNotifyViewName,
+              vacmAccessStorageType,
+              vacmAccessStatus,
+              vacmViewSpinLock,
+              vacmViewTreeFamilyMask,
+              vacmViewTreeFamilyType,
+              vacmViewTreeFamilyStorageType,
+              vacmViewTreeFamilyStatus
+            }
+    STATUS       current
+    DESCRIPTION "A collection of objects providing for remote
+                 configuration of an SNMP engine which implements
+
+                 the SNMP View-based Access Control Model.
+                "
+    ::= { vacmMIBGroups 1 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt
new file mode 100755
index 0000000000000000000000000000000000000000..24a1eed95d62f81ea88c3a78017696fa05400340
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-CONF.txt
@@ -0,0 +1,322 @@
+SNMPv2-CONF DEFINITIONS ::= BEGIN
+
+IMPORTS ObjectName, NotificationName, ObjectSyntax
+                                               FROM SNMPv2-SMI;
+
+-- definitions for conformance groups
+
+OBJECT-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+    Objects ::=
+                  Object
+                | Objects "," Object
+    Object ::=
+
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- more definitions for conformance groups
+
+NOTIFICATION-GROUP MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  NotificationsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    NotificationsPart ::=
+                  "NOTIFICATIONS" "{" Notifications "}"
+    Notifications ::=
+                  Notification
+                | Notifications "," Notification
+    Notification ::=
+                  value(NotificationName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for compliance statements
+
+MODULE-COMPLIANCE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "MODULE" ModuleName
+                  MandatoryPart
+                  CompliancePart
+
+    ModuleName ::=
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+                  -- must not be empty unless contained
+                  -- in MIB Module
+                | empty
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    MandatoryPart ::=
+                  "MANDATORY-GROUPS" "{" Groups "}"
+                | empty
+
+    Groups ::=
+
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    CompliancePart ::=
+                  Compliances
+                | empty
+
+    Compliances ::=
+                  Compliance
+                | Compliances Compliance
+    Compliance ::=
+                  ComplianceGroup
+                | Object
+
+    ComplianceGroup ::=
+                  "GROUP" value(OBJECT IDENTIFIER)
+                  "DESCRIPTION" Text
+
+    Object ::=
+                  "OBJECT" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    -- must be a refinement for object's SYNTAX clause
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "MIN-ACCESS" Access
+                | empty
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+-- definitions for capabilities statements
+
+AGENT-CAPABILITIES MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "PRODUCT-RELEASE" Text
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  ModulePart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    ModulePart ::=
+                  Modules
+                | empty
+    Modules ::=
+                  Module
+                | Modules Module
+    Module ::=
+                  -- name of module --
+                  "SUPPORTS" ModuleName
+                  "INCLUDES" "{" Groups "}"
+                  VariationPart
+
+    ModuleName ::=
+
+                  -- identifier must start with uppercase letter
+                  identifier ModuleIdentifier
+    ModuleIdentifier ::=
+                  value(OBJECT IDENTIFIER)
+                | empty
+
+    Groups ::=
+                  Group
+                | Groups "," Group
+    Group ::=
+                  value(OBJECT IDENTIFIER)
+
+    VariationPart ::=
+                  Variations
+                | empty
+    Variations ::=
+                  Variation
+                | Variations Variation
+
+    Variation ::=
+                  ObjectVariation
+                | NotificationVariation
+
+    NotificationVariation ::=
+                  "VARIATION" value(NotificationName)
+                  AccessPart
+                  "DESCRIPTION" Text
+
+    ObjectVariation ::=
+                  "VARIATION" value(ObjectName)
+                  SyntaxPart
+                  WriteSyntaxPart
+                  AccessPart
+                  CreationPart
+                  DefValPart
+                  "DESCRIPTION" Text
+
+    -- must be a refinement for object's SYNTAX clause
+    SyntaxPart ::= "SYNTAX" Syntax
+                | empty
+
+    WriteSyntaxPart ::= "WRITE-SYNTAX" Syntax
+                | empty
+
+    Syntax ::=    -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::= identifier "(" number ")" -- number is nonnegative
+
+    AccessPart ::=
+                  "ACCESS" Access
+                | empty
+
+    Access ::=
+                  "not-implemented"
+                -- only "not-implemented" for notifications
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+                -- following is for backward-compatibility only
+                | "write-only"
+
+    CreationPart ::=
+                  "CREATION-REQUIRES" "{" Cells "}"
+                | empty
+    Cells ::=
+                  Cell
+                | Cells "," Cell
+    Cell ::=
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the object's syntax
+                  -- in this macro's SYNTAX clause, if present,
+                  -- or if not, in object's OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+END
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt
new file mode 100755
index 0000000000000000000000000000000000000000..8c828305e06fd4a438b62fd6dcec1f30a173af28
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-MIB.txt
@@ -0,0 +1,854 @@
+SNMPv2-MIB DEFINITIONS ::= BEGIN
+
+IMPORTS
+    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
+    TimeTicks, Counter32, snmpModules, mib-2
+        FROM SNMPv2-SMI
+    DisplayString, TestAndIncr, TimeStamp
+
+        FROM SNMPv2-TC
+    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
+        FROM SNMPv2-CONF;
+
+snmpMIB MODULE-IDENTITY
+    LAST-UPDATED "200210160000Z"
+    ORGANIZATION "IETF SNMPv3 Working Group"
+    CONTACT-INFO
+            "WG-EMail:   snmpv3@lists.tislabs.com
+             Subscribe:  snmpv3-request@lists.tislabs.com
+
+             Co-Chair:   Russ Mundy
+                         Network Associates Laboratories
+             postal:     15204 Omega Drive, Suite 300
+                         Rockville, MD 20850-4601
+                         USA
+             EMail:      mundy@tislabs.com
+             phone:      +1 301 947-7107
+
+             Co-Chair:   David Harrington
+                         Enterasys Networks
+             postal:     35 Industrial Way
+                         P. O. Box 5005
+                         Rochester, NH 03866-5005
+                         USA
+             EMail:      dbh@enterasys.com
+             phone:      +1 603 337-2614
+
+             Editor:     Randy Presuhn
+                         BMC Software, Inc.
+             postal:     2141 North First Street
+                         San Jose, CA 95131
+                         USA
+             EMail:      randy_presuhn@bmc.com
+             phone:      +1 408 546-1006"
+    DESCRIPTION
+            "The MIB module for SNMP entities.
+
+             Copyright (C) The Internet Society (2002). This
+             version of this MIB module is part of RFC 3418;
+             see the RFC itself for full legal notices.
+            "
+    REVISION      "200210160000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 3418."
+    REVISION      "199511090000Z"
+    DESCRIPTION
+            "This revision of this MIB module was published as
+             RFC 1907."
+    REVISION      "199304010000Z"
+    DESCRIPTION
+            "The initial revision of this MIB module was published
+            as RFC 1450."
+    ::= { snmpModules 1 }
+
+snmpMIBObjects OBJECT IDENTIFIER ::= { snmpMIB 1 }
+
+--  ::= { snmpMIBObjects 1 }        this OID is obsolete
+--  ::= { snmpMIBObjects 2 }        this OID is obsolete
+--  ::= { snmpMIBObjects 3 }        this OID is obsolete
+
+-- the System group
+--
+-- a collection of objects common to all managed systems.
+
+system   OBJECT IDENTIFIER ::= { mib-2 1 }
+
+sysDescr OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A textual description of the entity.  This value should
+            include the full name and version identification of
+            the system's hardware type, software operating-system,
+            and networking software."
+    ::= { system 1 }
+
+sysObjectID OBJECT-TYPE
+    SYNTAX      OBJECT IDENTIFIER
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The vendor's authoritative identification of the
+            network management subsystem contained in the entity.
+            This value is allocated within the SMI enterprises
+            subtree (1.3.6.1.4.1) and provides an easy and
+            unambiguous means for determining `what kind of box' is
+            being managed.  For example, if vendor `Flintstones,
+            Inc.' was assigned the subtree 1.3.6.1.4.1.424242,
+            it could assign the identifier 1.3.6.1.4.1.424242.1.1
+            to its `Fred Router'."
+    ::= { system 2 }
+
+sysUpTime OBJECT-TYPE
+    SYNTAX      TimeTicks
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "The time (in hundredths of a second) since the
+            network management portion of the system was last
+            re-initialized."
+    ::= { system 3 }
+
+sysContact OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The textual identification of the contact person for
+            this managed node, together with information on how
+            to contact this person.  If no contact information is
+            known, the value is the zero-length string."
+    ::= { system 4 }
+
+sysName OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "An administratively-assigned name for this managed
+            node.  By convention, this is the node's fully-qualified
+            domain name.  If the name is unknown, the value is
+            the zero-length string."
+    ::= { system 5 }
+
+sysLocation OBJECT-TYPE
+    SYNTAX      DisplayString (SIZE (0..255))
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "The physical location of this node (e.g., 'telephone
+            closet, 3rd floor').  If the location is unknown, the
+            value is the zero-length string."
+    ::= { system 6 }
+
+sysServices OBJECT-TYPE
+    SYNTAX      INTEGER (0..127)
+    MAX-ACCESS  read-only
+    STATUS      current
+    DESCRIPTION
+            "A value which indicates the set of services that this
+            entity may potentially offer.  The value is a sum.
+
+            This sum initially takes the value zero. Then, for
+            each layer, L, in the range 1 through 7, that this node
+            performs transactions for, 2 raised to (L - 1) is added
+            to the sum.  For example, a node which performs only
+            routing functions would have a value of 4 (2^(3-1)).
+            In contrast, a node which is a host offering application
+            services would have a value of 72 (2^(4-1) + 2^(7-1)).
+            Note that in the context of the Internet suite of
+            protocols, values should be calculated accordingly:
+
+                 layer      functionality
+                   1        physical (e.g., repeaters)
+                   2        datalink/subnetwork (e.g., bridges)
+                   3        internet (e.g., supports the IP)
+                   4        end-to-end  (e.g., supports the TCP)
+                   7        applications (e.g., supports the SMTP)
+
+            For systems including OSI protocols, layers 5 and 6
+            may also be counted."
+    ::= { system 7 }
+
+-- object resource information
+--
+-- a collection of objects which describe the SNMP entity's
+-- (statically and dynamically configurable) support of
+-- various MIB modules.
+
+sysORLastChange OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time of the most recent
+            change in state or value of any instance of sysORID."
+    ::= { system 8 }
+
+sysORTable OBJECT-TYPE
+    SYNTAX     SEQUENCE OF SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The (conceptual) table listing the capabilities of
+            the local SNMP application acting as a command
+            responder with respect to various MIB modules.
+            SNMP entities having dynamically-configurable support
+            of MIB modules will have a dynamically-varying number
+            of conceptual rows."
+    ::= { system 9 }
+
+sysOREntry OBJECT-TYPE
+    SYNTAX     SysOREntry
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "An entry (conceptual row) in the sysORTable."
+    INDEX      { sysORIndex }
+    ::= { sysORTable 1 }
+
+SysOREntry ::= SEQUENCE {
+    sysORIndex     INTEGER,
+    sysORID        OBJECT IDENTIFIER,
+    sysORDescr     DisplayString,
+    sysORUpTime    TimeStamp
+}
+
+sysORIndex OBJECT-TYPE
+    SYNTAX     INTEGER (1..2147483647)
+    MAX-ACCESS not-accessible
+    STATUS     current
+    DESCRIPTION
+            "The auxiliary variable used for identifying instances
+            of the columnar objects in the sysORTable."
+    ::= { sysOREntry 1 }
+
+sysORID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "An authoritative identification of a capabilities
+            statement with respect to various MIB modules supported
+            by the local SNMP application acting as a command
+            responder."
+    ::= { sysOREntry 2 }
+
+sysORDescr OBJECT-TYPE
+    SYNTAX     DisplayString
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "A textual description of the capabilities identified
+            by the corresponding instance of sysORID."
+    ::= { sysOREntry 3 }
+
+sysORUpTime OBJECT-TYPE
+    SYNTAX     TimeStamp
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The value of sysUpTime at the time this conceptual
+            row was last instantiated."
+    ::= { sysOREntry 4 }
+
+-- the SNMP group
+--
+-- a collection of objects providing basic instrumentation and
+-- control of an SNMP entity.
+
+snmp     OBJECT IDENTIFIER ::= { mib-2 11 }
+
+snmpInPkts OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of messages delivered to the SNMP
+            entity from the transport service."
+    ::= { snmp 1 }
+
+snmpInBadVersions OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of SNMP messages which were delivered
+            to the SNMP entity and were for an unsupported SNMP
+            version."
+    ::= { snmp 3 }
+
+snmpInBadCommunityNames OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example,  SNMPv1) delivered to the SNMP entity which
+           used an SNMP community name not known to said entity.
+           Also, implementations which authenticate community-based
+           SNMP messages using check(s) in addition to matching
+           the community name (for example, by also checking
+           whether the message originated from a transport address
+           allowed to use a specified community name) MAY include
+           in this value the number of messages which failed the
+           additional check(s).  It is strongly RECOMMENDED that
+
+           the documentation for any security model which is used
+           to authenticate community-based SNMP messages specify
+           the precise conditions that contribute to this value."
+    ::= { snmp 4 }
+
+snmpInBadCommunityUses OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of community-based SNMP messages (for
+           example, SNMPv1) delivered to the SNMP entity which
+           represented an SNMP operation that was not allowed for
+           the SNMP community named in the message.  The precise
+           conditions under which this counter is incremented
+           (if at all) depend on how the SNMP entity implements
+           its access control mechanism and how its applications
+           interact with that access control mechanism.  It is
+           strongly RECOMMENDED that the documentation for any
+           access control mechanism which is used to control access
+           to and visibility of MIB instrumentation specify the
+           precise conditions that contribute to this value."
+    ::= { snmp 5 }
+
+snmpInASNParseErrs OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of ASN.1 or BER errors encountered by
+            the SNMP entity when decoding received SNMP messages."
+    ::= { snmp 6 }
+
+snmpEnableAuthenTraps OBJECT-TYPE
+    SYNTAX      INTEGER { enabled(1), disabled(2) }
+    MAX-ACCESS  read-write
+    STATUS      current
+    DESCRIPTION
+            "Indicates whether the SNMP entity is permitted to
+            generate authenticationFailure traps.  The value of this
+            object overrides any configuration information; as such,
+            it provides a means whereby all authenticationFailure
+            traps may be disabled.
+
+            Note that it is strongly recommended that this object
+            be stored in non-volatile memory so that it remains
+            constant across re-initializations of the network
+            management system."
+    ::= { snmp 30 }
+
+snmpSilentDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+           "The total number of Confirmed Class PDUs (such as
+           GetRequest-PDUs, GetNextRequest-PDUs,
+           GetBulkRequest-PDUs, SetRequest-PDUs, and
+           InformRequest-PDUs) delivered to the SNMP entity which
+           were silently dropped because the size of a reply
+           containing an alternate Response Class PDU (such as a
+           Response-PDU) with an empty variable-bindings field
+           was greater than either a local constraint or the
+           maximum message size associated with the originator of
+           the request."
+    ::= { snmp 31 }
+
+snmpProxyDrops OBJECT-TYPE
+    SYNTAX     Counter32
+    MAX-ACCESS read-only
+    STATUS     current
+    DESCRIPTION
+            "The total number of Confirmed Class PDUs
+            (such as GetRequest-PDUs, GetNextRequest-PDUs,
+            GetBulkRequest-PDUs, SetRequest-PDUs, and
+            InformRequest-PDUs) delivered to the SNMP entity which
+            were silently dropped because the transmission of
+            the (possibly translated) message to a proxy target
+            failed in a manner (other than a time-out) such that
+            no Response Class PDU (such as a Response-PDU) could
+            be returned."
+    ::= { snmp 32 }
+
+-- information for notifications
+--
+-- a collection of objects which allow the SNMP entity, when
+-- supporting a notification originator application,
+-- to be configured to generate SNMPv2-Trap-PDUs.
+
+snmpTrap       OBJECT IDENTIFIER ::= { snmpMIBObjects 4 }
+
+snmpTrapOID OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the notification
+            currently being sent.  This variable occurs as
+            the second varbind in every SNMPv2-Trap-PDU and
+            InformRequest-PDU."
+    ::= { snmpTrap 1 }
+
+--  ::= { snmpTrap 2 }   this OID is obsolete
+
+snmpTrapEnterprise OBJECT-TYPE
+    SYNTAX     OBJECT IDENTIFIER
+    MAX-ACCESS accessible-for-notify
+    STATUS     current
+    DESCRIPTION
+            "The authoritative identification of the enterprise
+            associated with the trap currently being sent.  When an
+            SNMP proxy agent is mapping an RFC1157 Trap-PDU
+            into a SNMPv2-Trap-PDU, this variable occurs as the
+            last varbind."
+    ::= { snmpTrap 3 }
+
+--  ::= { snmpTrap 4 }   this OID is obsolete
+
+-- well-known traps
+
+snmpTraps      OBJECT IDENTIFIER ::= { snmpMIBObjects 5 }
+
+coldStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A coldStart trap signifies that the SNMP entity,
+            supporting a notification originator application, is
+            reinitializing itself and that its configuration may
+            have been altered."
+    ::= { snmpTraps 1 }
+
+warmStart NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "A warmStart trap signifies that the SNMP entity,
+            supporting a notification originator application,
+            is reinitializing itself such that its configuration
+            is unaltered."
+    ::= { snmpTraps 2 }
+
+-- Note the linkDown NOTIFICATION-TYPE ::= { snmpTraps 3 }
+-- and the linkUp NOTIFICATION-TYPE ::= { snmpTraps 4 }
+-- are defined in RFC 2863 [RFC2863]
+
+authenticationFailure NOTIFICATION-TYPE
+    STATUS  current
+    DESCRIPTION
+            "An authenticationFailure trap signifies that the SNMP
+             entity has received a protocol message that is not
+             properly authenticated.  While all implementations
+             of SNMP entities MAY be capable of generating this
+             trap, the snmpEnableAuthenTraps object indicates
+             whether this trap will be generated."
+    ::= { snmpTraps 5 }
+
+-- Note the egpNeighborLoss notification is defined
+-- as { snmpTraps 6 } in RFC 1213
+
+-- the set group
+--
+-- a collection of objects which allow several cooperating
+-- command generator applications to coordinate their use of the
+-- set operation.
+
+snmpSet        OBJECT IDENTIFIER ::= { snmpMIBObjects 6 }
+
+snmpSetSerialNo OBJECT-TYPE
+    SYNTAX     TestAndIncr
+    MAX-ACCESS read-write
+    STATUS     current
+    DESCRIPTION
+            "An advisory lock used to allow several cooperating
+            command generator applications to coordinate their
+            use of the SNMP set operation.
+
+            This object is used for coarse-grain coordination.
+            To achieve fine-grain coordination, one or more similar
+            objects might be defined within each MIB group, as
+            appropriate."
+    ::= { snmpSet 1 }
+
+-- conformance information
+
+snmpMIBConformance
+               OBJECT IDENTIFIER ::= { snmpMIB 2 }
+
+snmpMIBCompliances
+               OBJECT IDENTIFIER ::= { snmpMIBConformance 1 }
+snmpMIBGroups  OBJECT IDENTIFIER ::= { snmpMIBConformance 2 }
+
+-- compliance statements
+
+--    ::= { snmpMIBCompliances 1 }      this OID is obsolete
+snmpBasicCompliance MODULE-COMPLIANCE
+    STATUS  deprecated
+    DESCRIPTION
+            "The compliance statement for SNMPv2 entities which
+            implement the SNMPv2 MIB.
+
+            This compliance statement is replaced by
+            snmpBasicComplianceRev2."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMPv2 entities which
+            support community-based authentication."
+    ::= { snmpMIBCompliances 2 }
+
+snmpBasicComplianceRev2 MODULE-COMPLIANCE
+    STATUS  current
+    DESCRIPTION
+            "The compliance statement for SNMP entities which
+            implement this MIB module."
+    MODULE  -- this module
+        MANDATORY-GROUPS { snmpGroup, snmpSetGroup, systemGroup,
+                           snmpBasicNotificationsGroup }
+
+        GROUP   snmpCommunityGroup
+        DESCRIPTION
+            "This group is mandatory for SNMP entities which
+            support community-based authentication."
+
+        GROUP   snmpWarmStartNotificationGroup
+        DESCRIPTION
+            "This group is mandatory for an SNMP entity which
+            supports command responder applications, and is
+            able to reinitialize itself such that its
+            configuration is unaltered."
+    ::= { snmpMIBCompliances 3 }
+
+-- units of conformance
+
+--  ::= { snmpMIBGroups 1 }           this OID is obsolete
+--  ::= { snmpMIBGroups 2 }           this OID is obsolete
+--  ::= { snmpMIBGroups 3 }           this OID is obsolete
+
+--  ::= { snmpMIBGroups 4 }           this OID is obsolete
+
+snmpGroup OBJECT-GROUP
+    OBJECTS { snmpInPkts,
+              snmpInBadVersions,
+              snmpInASNParseErrs,
+              snmpSilentDrops,
+              snmpProxyDrops,
+              snmpEnableAuthenTraps }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            and control of an SNMP entity."
+    ::= { snmpMIBGroups 8 }
+
+snmpCommunityGroup OBJECT-GROUP
+    OBJECTS { snmpInBadCommunityNames,
+              snmpInBadCommunityUses }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects providing basic instrumentation
+            of a SNMP entity which supports community-based
+            authentication."
+    ::= { snmpMIBGroups 9 }
+
+snmpSetGroup OBJECT-GROUP
+    OBJECTS { snmpSetSerialNo }
+    STATUS  current
+    DESCRIPTION
+            "A collection of objects which allow several cooperating
+            command generator applications to coordinate their
+            use of the set operation."
+    ::= { snmpMIBGroups 5 }
+
+systemGroup OBJECT-GROUP
+    OBJECTS { sysDescr, sysObjectID, sysUpTime,
+              sysContact, sysName, sysLocation,
+              sysServices,
+              sysORLastChange, sysORID,
+              sysORUpTime, sysORDescr }
+    STATUS  current
+    DESCRIPTION
+            "The system group defines objects which are common to all
+            managed systems."
+    ::= { snmpMIBGroups 6 }
+
+snmpBasicNotificationsGroup NOTIFICATION-GROUP
+    NOTIFICATIONS { coldStart, authenticationFailure }
+    STATUS        current
+    DESCRIPTION
+       "The basic notifications implemented by an SNMP entity
+        supporting command responder applications."
+    ::= { snmpMIBGroups 7 }
+
+snmpWarmStartNotificationGroup NOTIFICATION-GROUP
+   NOTIFICATIONS { warmStart }
+   STATUS        current
+   DESCRIPTION
+     "An additional notification for an SNMP entity supporting
+     command responder applications, if it is able to reinitialize
+     itself such that its configuration is unaltered."
+  ::= { snmpMIBGroups 11 }
+
+snmpNotificationGroup OBJECT-GROUP
+    OBJECTS { snmpTrapOID, snmpTrapEnterprise }
+    STATUS  current
+    DESCRIPTION
+            "These objects are required for entities
+            which support notification originator applications."
+    ::= { snmpMIBGroups 12 }
+
+-- definitions in RFC 1213 made obsolete by the inclusion of a
+-- subset of the snmp group in this MIB
+
+snmpOutPkts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Messages which were
+            passed from the SNMP protocol entity to the
+            transport service."
+    ::= { snmp 2 }
+
+-- { snmp 7 } is not used
+
+snmpInTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `tooBig'."
+    ::= { snmp 8 }
+
+snmpInNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `noSuchName'."
+    ::= { snmp 9 }
+
+snmpInBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were
+            delivered to the SNMP protocol entity and for
+            which the value of the error-status field was
+            `badValue'."
+    ::= { snmp 10 }
+
+snmpInReadOnlys OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number valid SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `readOnly'.  It should
+            be noted that it is a protocol error to generate an
+            SNMP PDU which contains the value `readOnly' in the
+            error-status field, as such this object is provided
+            as a means of detecting incorrect implementations of
+            the SNMP."
+    ::= { snmp 11 }
+
+snmpInGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were delivered
+            to the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 12 }
+
+snmpInTotalReqVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            retrieved successfully by the SNMP protocol entity
+            as the result of receiving valid SNMP Get-Request
+            and Get-Next PDUs."
+    ::= { snmp 13 }
+
+snmpInTotalSetVars OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of MIB objects which have been
+            altered successfully by the SNMP protocol entity as
+            the result of receiving valid SNMP Set-Request PDUs."
+    ::= { snmp 14 }
+
+snmpInGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been accepted and processed by the SNMP
+            protocol entity."
+    ::= { snmp 15 }
+
+snmpInGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 16 }
+
+snmpInSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 17 }
+
+snmpInGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been accepted and processed by the SNMP protocol
+            entity."
+    ::= { snmp 18 }
+
+snmpInTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have been
+            accepted and processed by the SNMP protocol entity."
+    ::= { snmp 19 }
+
+snmpOutTooBigs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `tooBig.'"
+    ::= { snmp 20 }
+
+snmpOutNoSuchNames OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status was `noSuchName'."
+    ::= { snmp 21 }
+
+snmpOutBadValues OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `badValue'."
+    ::= { snmp 22 }
+
+-- { snmp 23 } is not used
+
+snmpOutGenErrs OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP PDUs which were generated
+            by the SNMP protocol entity and for which the value
+            of the error-status field was `genErr'."
+    ::= { snmp 24 }
+
+snmpOutGetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 25 }
+
+snmpOutGetNexts OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Next PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 26 }
+
+snmpOutSetRequests OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Set-Request PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 27 }
+
+snmpOutGetResponses OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Get-Response PDUs which
+            have been generated by the SNMP protocol entity."
+    ::= { snmp 28 }
+
+snmpOutTraps OBJECT-TYPE
+    SYNTAX      Counter32
+    MAX-ACCESS  read-only
+    STATUS      obsolete
+    DESCRIPTION
+            "The total number of SNMP Trap PDUs which have
+            been generated by the SNMP protocol entity."
+    ::= { snmp 29 }
+
+snmpObsoleteGroup OBJECT-GROUP
+    OBJECTS { snmpOutPkts, snmpInTooBigs, snmpInNoSuchNames,
+              snmpInBadValues, snmpInReadOnlys, snmpInGenErrs,
+              snmpInTotalReqVars, snmpInTotalSetVars,
+              snmpInGetRequests, snmpInGetNexts, snmpInSetRequests,
+              snmpInGetResponses, snmpInTraps, snmpOutTooBigs,
+              snmpOutNoSuchNames, snmpOutBadValues,
+              snmpOutGenErrs, snmpOutGetRequests, snmpOutGetNexts,
+              snmpOutSetRequests, snmpOutGetResponses, snmpOutTraps
+              }
+    STATUS  obsolete
+    DESCRIPTION
+            "A collection of objects from RFC 1213 made obsolete
+            by this MIB module."
+    ::= { snmpMIBGroups 10 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt
new file mode 100755
index 0000000000000000000000000000000000000000..1c01e1dfcdc559a2cca3ee57500760fd8eaeb171
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-SMI.txt
@@ -0,0 +1,344 @@
+SNMPv2-SMI DEFINITIONS ::= BEGIN
+
+-- the path to the root
+
+org            OBJECT IDENTIFIER ::= { iso 3 }  --  "iso" = 1
+dod            OBJECT IDENTIFIER ::= { org 6 }
+internet       OBJECT IDENTIFIER ::= { dod 1 }
+
+directory      OBJECT IDENTIFIER ::= { internet 1 }
+
+mgmt           OBJECT IDENTIFIER ::= { internet 2 }
+mib-2          OBJECT IDENTIFIER ::= { mgmt 1 }
+transmission   OBJECT IDENTIFIER ::= { mib-2 10 }
+
+experimental   OBJECT IDENTIFIER ::= { internet 3 }
+
+private        OBJECT IDENTIFIER ::= { internet 4 }
+enterprises    OBJECT IDENTIFIER ::= { private 1 }
+
+security       OBJECT IDENTIFIER ::= { internet 5 }
+
+snmpV2         OBJECT IDENTIFIER ::= { internet 6 }
+
+-- transport domains
+snmpDomains    OBJECT IDENTIFIER ::= { snmpV2 1 }
+
+-- transport proxies
+snmpProxys     OBJECT IDENTIFIER ::= { snmpV2 2 }
+
+-- module identities
+snmpModules    OBJECT IDENTIFIER ::= { snmpV2 3 }
+
+-- Extended UTCTime, to allow dates with four-digit years
+-- (Note that this definition of ExtUTCTime is not to be IMPORTed
+--  by MIB modules.)
+ExtUTCTime ::= OCTET STRING(SIZE(11 | 13))
+    -- format is YYMMDDHHMMZ or YYYYMMDDHHMMZ
+
+    --   where: YY   - last two digits of year (only years
+    --                 between 1900-1999)
+    --          YYYY - last four digits of the year (any year)
+    --          MM   - month (01 through 12)
+    --          DD   - day of month (01 through 31)
+    --          HH   - hours (00 through 23)
+    --          MM   - minutes (00 through 59)
+    --          Z    - denotes GMT (the ASCII character Z)
+    --
+    -- For example, "9502192015Z" and "199502192015Z" represent
+    -- 8:15pm GMT on 19 February 1995. Years after 1999 must use
+    -- the four digit year format. Years 1900-1999 may use the
+    -- two or four digit format.
+
+-- definitions for information modules
+
+MODULE-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "LAST-UPDATED" value(Update ExtUTCTime)
+                  "ORGANIZATION" Text
+                  "CONTACT-INFO" Text
+                  "DESCRIPTION" Text
+                  RevisionPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    RevisionPart ::=
+                  Revisions
+                | empty
+    Revisions ::=
+                  Revision
+                | Revisions Revision
+    Revision ::=
+                  "REVISION" value(Update ExtUTCTime)
+                  "DESCRIPTION" Text
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+OBJECT-IDENTITY MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE OBJECT IDENTIFIER)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- names of objects
+-- (Note that these definitions of ObjectName and NotificationName
+--  are not to be IMPORTed by MIB modules.)
+
+ObjectName ::=
+    OBJECT IDENTIFIER
+
+NotificationName ::=
+    OBJECT IDENTIFIER
+
+-- syntax of objects
+
+-- the "base types" defined here are:
+--   3 built-in ASN.1 types: INTEGER, OCTET STRING, OBJECT IDENTIFIER
+--   8 application-defined types: Integer32, IpAddress, Counter32,
+--              Gauge32, Unsigned32, TimeTicks, Opaque, and Counter64
+
+ObjectSyntax ::=
+    CHOICE {
+        simple
+            SimpleSyntax,
+          -- note that SEQUENCEs for conceptual tables and
+          -- rows are not mentioned here...
+
+        application-wide
+            ApplicationSyntax
+    }
+
+-- built-in ASN.1 types
+
+SimpleSyntax ::=
+    CHOICE {
+        -- INTEGERs with a more restrictive range
+        -- may also be used
+        integer-value               -- includes Integer32
+            INTEGER (-2147483648..2147483647),
+        -- OCTET STRINGs with a more restrictive size
+        -- may also be used
+        string-value
+            OCTET STRING (SIZE (0..65535)),
+        objectID-value
+            OBJECT IDENTIFIER
+    }
+
+-- indistinguishable from INTEGER, but never needs more than
+-- 32-bits for a two's complement representation
+Integer32 ::=
+        INTEGER (-2147483648..2147483647)
+
+-- application-wide types
+
+ApplicationSyntax ::=
+    CHOICE {
+        ipAddress-value
+            IpAddress,
+        counter-value
+            Counter32,
+        timeticks-value
+            TimeTicks,
+        arbitrary-value
+            Opaque,
+        big-counter-value
+            Counter64,
+        unsigned-integer-value  -- includes Gauge32
+            Unsigned32
+    }
+
+-- in network-byte order
+
+-- (this is a tagged type for historical reasons)
+IpAddress ::=
+    [APPLICATION 0]
+        IMPLICIT OCTET STRING (SIZE (4))
+
+-- this wraps
+Counter32 ::=
+    [APPLICATION 1]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- this doesn't wrap
+Gauge32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- an unsigned 32-bit quantity
+-- indistinguishable from Gauge32
+Unsigned32 ::=
+    [APPLICATION 2]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- hundredths of seconds since an epoch
+TimeTicks ::=
+    [APPLICATION 3]
+        IMPLICIT INTEGER (0..4294967295)
+
+-- for backward-compatibility only
+Opaque ::=
+    [APPLICATION 4]
+        IMPLICIT OCTET STRING
+
+-- for counters that wrap in less than one hour with only 32 bits
+Counter64 ::=
+    [APPLICATION 6]
+        IMPLICIT INTEGER (0..18446744073709551615)
+
+-- definition for objects
+
+OBJECT-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  "SYNTAX" Syntax
+                  UnitsPart
+                  "MAX-ACCESS" Access
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+                  IndexPart
+                  DefValPart
+
+    VALUE NOTATION ::=
+                  value(VALUE ObjectName)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement),
+                       -- a textual convention (or its refinement), or
+                       -- a BITS pseudo-type
+                   type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+    UnitsPart ::=
+                  "UNITS" Text
+                | empty
+
+    Access ::=
+                  "not-accessible"
+                | "accessible-for-notify"
+                | "read-only"
+                | "read-write"
+                | "read-create"
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    IndexPart ::=
+                  "INDEX"    "{" IndexTypes "}"
+                | "AUGMENTS" "{" Entry      "}"
+                | empty
+    IndexTypes ::=
+                  IndexType
+                | IndexTypes "," IndexType
+    IndexType ::=
+                  "IMPLIED" Index
+                | Index
+
+    Index ::=
+                    -- use the SYNTAX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+    Entry ::=
+                    -- use the INDEX value of the
+                    -- correspondent OBJECT-TYPE invocation
+                  value(ObjectName)
+
+    DefValPart ::= "DEFVAL" "{" Defvalue "}"
+                | empty
+
+    Defvalue ::=  -- must be valid for the type specified in
+                  -- SYNTAX clause of same OBJECT-TYPE macro
+                  value(ObjectSyntax)
+                | "{" BitsValue "}"
+
+    BitsValue ::= BitNames
+                | empty
+
+    BitNames ::=  BitName
+                | BitNames "," BitName
+
+    BitName ::= identifier
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions for notifications
+
+NOTIFICATION-TYPE MACRO ::=
+BEGIN
+    TYPE NOTATION ::=
+                  ObjectsPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+
+    VALUE NOTATION ::=
+                  value(VALUE NotificationName)
+
+    ObjectsPart ::=
+                  "OBJECTS" "{" Objects "}"
+                | empty
+    Objects ::=
+                  Object
+
+                | Objects "," Object
+    Object ::=
+                  value(ObjectName)
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in section 3.1.1
+    Text ::= value(IA5String)
+END
+
+-- definitions of administrative identifiers
+
+zeroDotZero    OBJECT-IDENTITY
+    STATUS     current
+    DESCRIPTION
+            "A value used for null identifiers."
+    ::= { 0 0 }
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt
new file mode 100755
index 0000000000000000000000000000000000000000..860bf71eeaa9a5322f5223b99b6115e59fcfbcae
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/snmp/mibs/SNMPv2-TC.txt
@@ -0,0 +1,772 @@
+SNMPv2-TC DEFINITIONS ::= BEGIN
+
+IMPORTS
+    TimeTicks         FROM SNMPv2-SMI;
+
+-- definition of textual conventions
+
+TEXTUAL-CONVENTION MACRO ::=
+
+BEGIN
+    TYPE NOTATION ::=
+                  DisplayPart
+                  "STATUS" Status
+                  "DESCRIPTION" Text
+                  ReferPart
+                  "SYNTAX" Syntax
+
+    VALUE NOTATION ::=
+                   value(VALUE Syntax)      -- adapted ASN.1
+
+    DisplayPart ::=
+                  "DISPLAY-HINT" Text
+                | empty
+
+    Status ::=
+                  "current"
+                | "deprecated"
+                | "obsolete"
+
+    ReferPart ::=
+                  "REFERENCE" Text
+                | empty
+
+    -- a character string as defined in [2]
+    Text ::= value(IA5String)
+
+    Syntax ::=   -- Must be one of the following:
+                       -- a base type (or its refinement), or
+                       -- a BITS pseudo-type
+                  type
+                | "BITS" "{" NamedBits "}"
+
+    NamedBits ::= NamedBit
+                | NamedBits "," NamedBit
+
+    NamedBit ::=  identifier "(" number ")" -- number is nonnegative
+
+END
+
+DisplayString ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "255a"
+    STATUS       current
+    DESCRIPTION
+            "Represents textual information taken from the NVT ASCII
+
+            character set, as defined in pages 4, 10-11 of RFC 854.
+
+            To summarize RFC 854, the NVT ASCII repertoire specifies:
+
+              - the use of character codes 0-127 (decimal)
+
+              - the graphics characters (32-126) are interpreted as
+                US ASCII
+
+              - NUL, LF, CR, BEL, BS, HT, VT and FF have the special
+                meanings specified in RFC 854
+
+              - the other 25 codes have no standard interpretation
+
+              - the sequence 'CR LF' means newline
+
+              - the sequence 'CR NUL' means carriage-return
+
+              - an 'LF' not preceded by a 'CR' means moving to the
+                same column on the next line.
+
+              - the sequence 'CR x' for any x other than LF or NUL is
+                illegal.  (Note that this also means that a string may
+                end with either 'CR LF' or 'CR NUL', but not with CR.)
+
+            Any object defined using this syntax may not exceed 255
+            characters in length."
+    SYNTAX       OCTET STRING (SIZE (0..255))
+
+PhysAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents media- or physical-level addresses."
+    SYNTAX       OCTET STRING
+
+MacAddress ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "1x:"
+    STATUS       current
+    DESCRIPTION
+            "Represents an 802 MAC address represented in the
+            `canonical' order defined by IEEE 802.1a, i.e., as if it
+            were transmitted least significant bit first, even though
+            802.5 (in contrast to other 802.x protocols) requires MAC
+            addresses to be transmitted most significant bit first."
+    SYNTAX       OCTET STRING (SIZE (6))
+
+TruthValue ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a boolean value."
+    SYNTAX       INTEGER { true(1), false(2) }
+
+TestAndIncr ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents integer-valued information used for atomic
+            operations.  When the management protocol is used to specify
+            that an object instance having this syntax is to be
+            modified, the new value supplied via the management protocol
+            must precisely match the value presently held by the
+            instance.  If not, the management protocol set operation
+            fails with an error of `inconsistentValue'.  Otherwise, if
+            the current value is the maximum value of 2^31-1 (2147483647
+            decimal), then the value held by the instance is wrapped to
+            zero; otherwise, the value held by the instance is
+            incremented by one.  (Note that regardless of whether the
+            management protocol set operation succeeds, the variable-
+            binding in the request and response PDUs are identical.)
+
+            The value of the ACCESS clause for objects having this
+            syntax is either `read-write' or `read-create'.  When an
+            instance of a columnar object having this syntax is created,
+            any value may be supplied via the management protocol.
+
+            When the network management portion of the system is re-
+            initialized, the value of every object instance having this
+            syntax must either be incremented from its value prior to
+            the re-initialization, or (if the value prior to the re-
+            initialization is unknown) be set to a pseudo-randomly
+            generated value."
+    SYNTAX       INTEGER (0..2147483647)
+
+AutonomousType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents an independently extensible type identification
+            value.  It may, for example, indicate a particular sub-tree
+            with further MIB definitions, or define a particular type of
+            protocol or hardware."
+    SYNTAX       OBJECT IDENTIFIER
+
+InstancePointer ::= TEXTUAL-CONVENTION
+    STATUS       obsolete
+    DESCRIPTION
+            "A pointer to either a specific instance of a MIB object or
+            a conceptual row of a MIB table in the managed device.  In
+            the latter case, by convention, it is the name of the
+            particular instance of the first accessible columnar object
+            in the conceptual row.
+
+            The two uses of this textual convention are replaced by
+            VariablePointer and RowPointer, respectively."
+    SYNTAX       OBJECT IDENTIFIER
+
+VariablePointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A pointer to a specific object instance.  For example,
+            sysContact.0 or ifInOctets.3."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowPointer ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Represents a pointer to a conceptual row.  The value is the
+            name of the instance of the first accessible columnar object
+            in the conceptual row.
+
+            For example, ifIndex.3 would point to the 3rd row in the
+            ifTable (note that if ifIndex were not-accessible, then
+            ifDescr.3 would be used instead)."
+    SYNTAX       OBJECT IDENTIFIER
+
+RowStatus ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The RowStatus textual convention is used to manage the
+            creation and deletion of conceptual rows, and is used as the
+            value of the SYNTAX clause for the status column of a
+            conceptual row (as described in Section 7.7.1 of [2].)
+
+            The status column has six defined values:
+
+                 - `active', which indicates that the conceptual row is
+                 available for use by the managed device;
+
+                 - `notInService', which indicates that the conceptual
+                 row exists in the agent, but is unavailable for use by
+                 the managed device (see NOTE below); 'notInService' has
+                 no implication regarding the internal consistency of
+                 the row, availability of resources, or consistency with
+                 the current state of the managed device;
+
+                 - `notReady', which indicates that the conceptual row
+                 exists in the agent, but is missing information
+                 necessary in order to be available for use by the
+                 managed device (i.e., one or more required columns in
+                 the conceptual row have not been instanciated);
+
+                 - `createAndGo', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row and to have its status automatically set
+                 to active, making it available for use by the managed
+                 device;
+
+                 - `createAndWait', which is supplied by a management
+                 station wishing to create a new instance of a
+                 conceptual row (but not make it available for use by
+                 the managed device); and,
+                 - `destroy', which is supplied by a management station
+                 wishing to delete all of the instances associated with
+                 an existing conceptual row.
+
+            Whereas five of the six values (all except `notReady') may
+            be specified in a management protocol set operation, only
+            three values will be returned in response to a management
+            protocol retrieval operation:  `notReady', `notInService' or
+            `active'.  That is, when queried, an existing conceptual row
+            has only three states:  it is either available for use by
+            the managed device (the status column has value `active');
+            it is not available for use by the managed device, though
+            the agent has sufficient information to attempt to make it
+            so (the status column has value `notInService'); or, it is
+            not available for use by the managed device, and an attempt
+            to make it so would fail because the agent has insufficient
+            information (the state column has value `notReady').
+
+                                     NOTE WELL
+
+                 This textual convention may be used for a MIB table,
+                 irrespective of whether the values of that table's
+                 conceptual rows are able to be modified while it is
+                 active, or whether its conceptual rows must be taken
+                 out of service in order to be modified.  That is, it is
+                 the responsibility of the DESCRIPTION clause of the
+                 status column to specify whether the status column must
+                 not be `active' in order for the value of some other
+                 column of the same conceptual row to be modified.  If
+                 such a specification is made, affected columns may be
+                 changed by an SNMP set PDU if the RowStatus would not
+                 be equal to `active' either immediately before or after
+                 processing the PDU.  In other words, if the PDU also
+                 contained a varbind that would change the RowStatus
+                 value, the column in question may be changed if the
+                 RowStatus was not equal to `active' as the PDU was
+                 received, or if the varbind sets the status to a value
+                 other than 'active'.
+
+            Also note that whenever any elements of a row exist, the
+            RowStatus column must also exist.
+
+            To summarize the effect of having a conceptual row with a
+            status column having a SYNTAX clause value of RowStatus,
+            consider the following state diagram:
+
+                                         STATE
+              +--------------+-----------+-------------+-------------
+              |      A       |     B     |      C      |      D
+              |              |status col.|status column|
+              |status column |    is     |      is     |status column
+    ACTION    |does not exist|  notReady | notInService|  is active
+--------------+--------------+-----------+-------------+-------------
+set status    |noError    ->D|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndGo   |inconsistent- |           |             |
+              |         Value|           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |noError  see 1|inconsist- |inconsistent-|inconsistent-
+column to     |       or     |   entValue|        Value|        Value
+createAndWait |wrongValue    |           |             |
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError
+column to     |         Value|   entValue|             |
+active        |              |           |             |
+              |              |     or    |             |
+              |              |           |             |
+              |              |see 2   ->D|see 8     ->D|          ->D
+--------------+--------------+-----------+-------------+-------------
+set status    |inconsistent- |inconsist- |noError      |noError   ->C
+column to     |         Value|   entValue|             |
+notInService  |              |           |             |
+              |              |     or    |             |      or
+              |              |           |             |
+              |              |see 3   ->C|          ->C|see 6
+--------------+--------------+-----------+-------------+-------------
+set status    |noError       |noError    |noError      |noError   ->A
+column to     |              |           |             |      or
+destroy       |           ->A|        ->A|          ->A|see 7
+--------------+--------------+-----------+-------------+-------------
+set any other |see 4         |noError    |noError      |see 5
+column to some|              |           |             |
+value         |              |      see 1|          ->C|          ->D
+--------------+--------------+-----------+-------------+-------------
+
+            (1) goto B or C, depending on information available to the
+            agent.
+
+            (2) if other variable bindings included in the same PDU,
+            provide values for all columns which are missing but
+            required, and all columns have acceptable values, then
+            return noError and goto D.
+
+            (3) if other variable bindings included in the same PDU,
+            provide legal values for all columns which are missing but
+            required, then return noError and goto C.
+
+            (4) at the discretion of the agent, the return value may be
+            either:
+
+                 inconsistentName:  because the agent does not choose to
+                 create such an instance when the corresponding
+                 RowStatus instance does not exist, or
+
+                 inconsistentValue:  if the supplied value is
+                 inconsistent with the state of some other MIB object's
+                 value, or
+
+                 noError: because the agent chooses to create the
+                 instance.
+
+            If noError is returned, then the instance of the status
+            column must also be created, and the new state is B or C,
+            depending on the information available to the agent.  If
+            inconsistentName or inconsistentValue is returned, the row
+            remains in state A.
+
+            (5) depending on the MIB definition for the column/table,
+            either noError or inconsistentValue may be returned.
+
+            (6) the return value can indicate one of the following
+            errors:
+
+                 wrongValue: because the agent does not support
+                 notInService (e.g., an agent which does not support
+                 createAndWait), or
+
+                 inconsistentValue: because the agent is unable to take
+                 the row out of service at this time, perhaps because it
+                 is in use and cannot be de-activated.
+
+            (7) the return value can indicate the following error:
+
+                 inconsistentValue: because the agent is unable to
+                 remove the row at this time, perhaps because it is in
+                 use and cannot be de-activated.
+
+            (8) the transition to D can fail, e.g., if the values of the
+            conceptual row are inconsistent, then the error code would
+            be inconsistentValue.
+
+            NOTE: Other processing of (this and other varbinds of) the
+            set request may result in a response other than noError
+            being returned, e.g., wrongValue, noCreation, etc.
+
+                              Conceptual Row Creation
+
+            There are four potential interactions when creating a
+            conceptual row:  selecting an instance-identifier which is
+            not in use; creating the conceptual row; initializing any
+            objects for which the agent does not supply a default; and,
+            making the conceptual row available for use by the managed
+            device.
+
+            Interaction 1: Selecting an Instance-Identifier
+
+            The algorithm used to select an instance-identifier varies
+            for each conceptual row.  In some cases, the instance-
+            identifier is semantically significant, e.g., the
+            destination address of a route, and a management station
+            selects the instance-identifier according to the semantics.
+
+            In other cases, the instance-identifier is used solely to
+            distinguish conceptual rows, and a management station
+            without specific knowledge of the conceptual row might
+            examine the instances present in order to determine an
+            unused instance-identifier.  (This approach may be used, but
+            it is often highly sub-optimal; however, it is also a
+            questionable practice for a naive management station to
+            attempt conceptual row creation.)
+
+            Alternately, the MIB module which defines the conceptual row
+            might provide one or more objects which provide assistance
+            in determining an unused instance-identifier.  For example,
+            if the conceptual row is indexed by an integer-value, then
+            an object having an integer-valued SYNTAX clause might be
+            defined for such a purpose, allowing a management station to
+            issue a management protocol retrieval operation.  In order
+            to avoid unnecessary collisions between competing management
+            stations, `adjacent' retrievals of this object should be
+            different.
+
+            Finally, the management station could select a pseudo-random
+            number to use as the index.  In the event that this index
+
+            was already in use and an inconsistentValue was returned in
+            response to the management protocol set operation, the
+            management station should simply select a new pseudo-random
+            number and retry the operation.
+
+            A MIB designer should choose between the two latter
+            algorithms based on the size of the table (and therefore the
+            efficiency of each algorithm).  For tables in which a large
+            number of entries are expected, it is recommended that a MIB
+            object be defined that returns an acceptable index for
+            creation.  For tables with small numbers of entries, it is
+            recommended that the latter pseudo-random index mechanism be
+            used.
+
+            Interaction 2: Creating the Conceptual Row
+
+            Once an unused instance-identifier has been selected, the
+            management station determines if it wishes to create and
+            activate the conceptual row in one transaction or in a
+            negotiated set of interactions.
+
+            Interaction 2a: Creating and Activating the Conceptual Row
+
+            The management station must first determine the column
+            requirements, i.e., it must determine those columns for
+            which it must or must not provide values.  Depending on the
+            complexity of the table and the management station's
+            knowledge of the agent's capabilities, this determination
+            can be made locally by the management station.  Alternately,
+            the management station issues a management protocol get
+            operation to examine all columns in the conceptual row that
+            it wishes to create.  In response, for each column, there
+            are three possible outcomes:
+
+                 - a value is returned, indicating that some other
+                 management station has already created this conceptual
+                 row.  We return to interaction 1.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. For those
+                 columns to which the agent provides read-create access,
+                 the `noSuchInstance' exception tells the management
+                 station that it should supply a value for this column
+                 when the conceptual row is to be created.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            Once the column requirements have been determined, a
+            management protocol set operation is accordingly issued.
+            This operation also sets the new instance of the status
+            column to `createAndGo'.
+
+            When the agent processes the set operation, it verifies that
+            it has sufficient information to make the conceptual row
+            available for use by the managed device.  The information
+            available to the agent is provided by two sources:  the
+            management protocol set operation which creates the
+            conceptual row, and, implementation-specific defaults
+            supplied by the agent (note that an agent must provide
+            implementation-specific defaults for at least those objects
+            which it implements as read-only).  If there is sufficient
+            information available, then the conceptual row is created, a
+            `noError' response is returned, the status column is set to
+            `active', and no further interactions are necessary (i.e.,
+            interactions 3 and 4 are skipped).  If there is insufficient
+            information, then the conceptual row is not created, and the
+            set operation fails with an error of `inconsistentValue'.
+            On this error, the management station can issue a management
+            protocol retrieval operation to determine if this was
+            because it failed to specify a value for a required column,
+            or, because the selected instance of the status column
+            already existed.  In the latter case, we return to
+            interaction 1.  In the former case, the management station
+            can re-issue the set operation with the additional
+            information, or begin interaction 2 again using
+            `createAndWait' in order to negotiate creation of the
+            conceptual row.
+
+                                     NOTE WELL
+
+                 Regardless of the method used to determine the column
+                 requirements, it is possible that the management
+                 station might deem a column necessary when, in fact,
+                 the agent will not allow that particular columnar
+                 instance to be created or written.  In this case, the
+                 management protocol set operation will fail with an
+                 error such as `noCreation' or `notWritable'.  In this
+                 case, the management station decides whether it needs
+                 to be able to set a value for that particular columnar
+                 instance.  If not, the management station re-issues the
+                 management protocol set operation, but without setting
+                 a value for that particular columnar instance;
+                 otherwise, the management station aborts the row
+                 creation algorithm.
+
+            Interaction 2b: Negotiating the Creation of the Conceptual
+            Row
+
+            The management station issues a management protocol set
+            operation which sets the desired instance of the status
+            column to `createAndWait'.  If the agent is unwilling to
+            process a request of this sort, the set operation fails with
+            an error of `wrongValue'.  (As a consequence, such an agent
+            must be prepared to accept a single management protocol set
+            operation, i.e., interaction 2a above, containing all of the
+            columns indicated by its column requirements.)  Otherwise,
+            the conceptual row is created, a `noError' response is
+            returned, and the status column is immediately set to either
+            `notInService' or `notReady', depending on whether it has
+            sufficient information to (attempt to) make the conceptual
+            row available for use by the managed device.  If there is
+            sufficient information available, then the status column is
+            set to `notInService'; otherwise, if there is insufficient
+            information, then the status column is set to `notReady'.
+            Regardless, we proceed to interaction 3.
+
+            Interaction 3: Initializing non-defaulted Objects
+
+            The management station must now determine the column
+            requirements.  It issues a management protocol get operation
+            to examine all columns in the created conceptual row.  In
+            the response, for each column, there are three possible
+            outcomes:
+
+                 - a value is returned, indicating that the agent
+                 implements the object-type associated with this column
+                 and had sufficient information to provide a value.  For
+                 those columns to which the agent provides read-create
+                 access (and for which the agent allows their values to
+                 be changed after their creation), a value return tells
+                 the management station that it may issue additional
+                 management protocol set operations, if it desires, in
+                 order to change the value associated with this column.
+
+                 - the exception `noSuchInstance' is returned,
+                 indicating that the agent implements the object-type
+                 associated with this column, and that this column in at
+                 least one conceptual row would be accessible in the MIB
+                 view used by the retrieval were it to exist. However,
+                 the agent does not have sufficient information to
+                 provide a value, and until a value is provided, the
+                 conceptual row may not be made available for use by the
+                 managed device.  For those columns to which the agent
+                 provides read-create access, the `noSuchInstance'
+                 exception tells the management station that it must
+                 issue additional management protocol set operations, in
+                 order to provide a value associated with this column.
+
+                 - the exception `noSuchObject' is returned, indicating
+                 that the agent does not implement the object-type
+                 associated with this column or that there is no
+                 conceptual row for which this column would be
+                 accessible in the MIB view used by the retrieval.  As
+                 such, the management station can not issue any
+                 management protocol set operations to create an
+                 instance of this column.
+
+            If the value associated with the status column is
+            `notReady', then the management station must first deal with
+            all `noSuchInstance' columns, if any.  Having done so, the
+            value of the status column becomes `notInService', and we
+            proceed to interaction 4.
+
+            Interaction 4: Making the Conceptual Row Available
+
+            Once the management station is satisfied with the values
+            associated with the columns of the conceptual row, it issues
+            a management protocol set operation to set the status column
+            to `active'.  If the agent has sufficient information to
+            make the conceptual row available for use by the managed
+            device, the management protocol set operation succeeds (a
+            `noError' response is returned).  Otherwise, the management
+            protocol set operation fails with an error of
+            `inconsistentValue'.
+
+                                     NOTE WELL
+
+                 A conceptual row having a status column with value
+                 `notInService' or `notReady' is unavailable to the
+                 managed device.  As such, it is possible for the
+                 managed device to create its own instances during the
+                 time between the management protocol set operation
+                 which sets the status column to `createAndWait' and the
+                 management protocol set operation which sets the status
+                 column to `active'.  In this case, when the management
+                 protocol set operation is issued to set the status
+                 column to `active', the values held in the agent
+                 supersede those used by the managed device.
+
+            If the management station is prevented from setting the
+            status column to `active' (e.g., due to management station
+            or network failure) the conceptual row will be left in the
+            `notInService' or `notReady' state, consuming resources
+            indefinitely.  The agent must detect conceptual rows that
+            have been in either state for an abnormally long period of
+            time and remove them.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate what an
+            abnormally long period of time would be.  This period of
+            time should be long enough to allow for human response time
+            (including `think time') between the creation of the
+            conceptual row and the setting of the status to `active'.
+            In the absence of such information in the DESCRIPTION
+            clause, it is suggested that this period be approximately 5
+            minutes in length.  This removal action applies not only to
+            newly-created rows, but also to previously active rows which
+            are set to, and left in, the notInService state for a
+            prolonged period exceeding that which is considered normal
+            for such a conceptual row.
+
+                             Conceptual Row Suspension
+
+            When a conceptual row is `active', the management station
+            may issue a management protocol set operation which sets the
+            instance of the status column to `notInService'.  If the
+            agent is unwilling to do so, the set operation fails with an
+            error of `wrongValue' or `inconsistentValue'.  Otherwise,
+            the conceptual row is taken out of service, and a `noError'
+            response is returned.  It is the responsibility of the
+            DESCRIPTION clause of the status column to indicate under
+            what circumstances the status column should be taken out of
+            service (e.g., in order for the value of some other column
+            of the same conceptual row to be modified).
+
+                              Conceptual Row Deletion
+
+            For deletion of conceptual rows, a management protocol set
+            operation is issued which sets the instance of the status
+            column to `destroy'.  This request may be made regardless of
+            the current value of the status column (e.g., it is possible
+            to delete conceptual rows which are either `notReady',
+            `notInService' or `active'.)  If the operation succeeds,
+            then all instances associated with the conceptual row are
+            immediately removed."
+    SYNTAX       INTEGER {
+                     -- the following two values are states:
+                     -- these values may be read or written
+                     active(1),
+                     notInService(2),
+                     -- the following value is a state:
+                     -- this value may be read, but not written
+                     notReady(3),
+                     -- the following three values are
+                     -- actions: these values may be written,
+                     --   but are never read
+                     createAndGo(4),
+                     createAndWait(5),
+                     destroy(6)
+                 }
+
+TimeStamp ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "The value of the sysUpTime object at which a specific
+            occurrence happened.  The specific occurrence must be
+
+            defined in the description of any object defined using this
+            type.
+
+            If sysUpTime is reset to zero as a result of a re-
+            initialization of the network management (sub)system, then
+            the values of all TimeStamp objects are also reset.
+            However, after approximately 497 days without a re-
+            initialization, the sysUpTime object will reach 2^^32-1 and
+            then increment around to zero; in this case, existing values
+            of TimeStamp objects do not change.  This can lead to
+            ambiguities in the value of TimeStamp objects."
+    SYNTAX       TimeTicks
+
+TimeInterval ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "A period of time, measured in units of 0.01 seconds."
+    SYNTAX       INTEGER (0..2147483647)
+
+DateAndTime ::= TEXTUAL-CONVENTION
+    DISPLAY-HINT "2d-1d-1d,1d:1d:1d.1d,1a1d:1d"
+    STATUS       current
+    DESCRIPTION
+            "A date-time specification.
+
+            field  octets  contents                  range
+            -----  ------  --------                  -----
+              1      1-2   year*                     0..65536
+              2       3    month                     1..12
+              3       4    day                       1..31
+              4       5    hour                      0..23
+              5       6    minutes                   0..59
+              6       7    seconds                   0..60
+                           (use 60 for leap-second)
+              7       8    deci-seconds              0..9
+              8       9    direction from UTC        '+' / '-'
+              9      10    hours from UTC*           0..13
+             10      11    minutes from UTC          0..59
+
+            * Notes:
+            - the value of year is in network-byte order
+            - daylight saving time in New Zealand is +13
+
+            For example, Tuesday May 26, 1992 at 1:30:15 PM EDT would be
+            displayed as:
+
+                             1992-5-26,13:30:15.0,-4:0
+
+            Note that if only local time is known, then timezone
+            information (fields 8-10) is not present."
+    SYNTAX       OCTET STRING (SIZE (8 | 11))
+
+StorageType ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+            "Describes the memory realization of a conceptual row.  A
+            row which is volatile(2) is lost upon reboot.  A row which
+            is either nonVolatile(3), permanent(4) or readOnly(5), is
+            backed up by stable storage.  A row which is permanent(4)
+            can be changed but not deleted.  A row which is readOnly(5)
+            cannot be changed nor deleted.
+
+            If the value of an object with this syntax is either
+            permanent(4) or readOnly(5), it cannot be written.
+            Conversely, if the value is either other(1), volatile(2) or
+            nonVolatile(3), it cannot be modified to be permanent(4) or
+            readOnly(5).  (All illegal modifications result in a
+            'wrongValue' error.)
+
+            Every usage of this textual convention is required to
+            specify the columnar objects which a permanent(4) row must
+            at a minimum allow to be writable."
+    SYNTAX       INTEGER {
+                     other(1),       -- eh?
+                     volatile(2),    -- e.g., in RAM
+                     nonVolatile(3), -- e.g., in NVRAM
+                     permanent(4),   -- e.g., partially in ROM
+                     readOnly(5)     -- e.g., completely in ROM
+                 }
+
+TDomain ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a kind of transport service.
+
+          Some possible values, such as snmpUDPDomain, are defined in
+          the SNMPv2-TM MIB module.  Other possible values are defined
+          in other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OBJECT IDENTIFIER
+
+TAddress ::= TEXTUAL-CONVENTION
+    STATUS       current
+    DESCRIPTION
+          "Denotes a transport service address.
+
+          A TAddress value is always interpreted within the context of a
+          TDomain value.  Thus, each definition of a TDomain value must
+          be accompanied by a definition of a textual convention for use
+          with that TDomain.  Some possible textual conventions, such as
+          SnmpUDPAddress for snmpUDPDomain, are defined in the SNMPv2-TM
+          MIB module.  Other possible textual conventions are defined in
+          other MIB modules."
+    REFERENCE    "The SNMPv2-TM MIB module is defined in RFC 1906."
+    SYNTAX       OCTET STRING (SIZE (1..255))
+
+END
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/community.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/community.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..0d5d7061f7734a6f9fc1869cdac44bd92e596318
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/community.yaml
@@ -0,0 +1,8 @@
+---
+- hosts: all
+  connection: local
+  tasks:
+  - name: change SNMP community
+    vyos_config:
+      lines:
+        - set service snmp community "{{ snmp_community }}" authorization ro
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/install.sh b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/install.sh
new file mode 100755
index 0000000000000000000000000000000000000000..9c9b05f3f14708251719f848b0ffc31a5aa5d73b
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/install.sh
@@ -0,0 +1,41 @@
+#!/bin/bash
+##
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+##
+
+echo "installing libraries for snmp generator"
+
+#apt-get install -y ...
+apt-get update
+
+# Install ansible libraries
+apt-get install -y software-properties-common
+apt-add-repository --yes --update ppa:ansible/ansible
+apt install -y ansible
+
+# Set host checking to false
+echo "host_key_checking = False" >> /etc/ansible/ansible.cfg
+
+apt-get install -y python3-pip unzip build-essential libsnmp-dev wget curl
+curl -s https://storage.googleapis.com/golang/go1.11.8.linux-amd64.tar.gz | tar -v -C /usr/local -xz
+export PATH=$PATH:/usr/local/go/bin
+export GOPATH=/go
+
+go get github.com/go-logfmt/logfmt && go get github.com/go-kit/kit/log
+
+wget -q https://github.com/prometheus/snmp_exporter/archive/v0.17.0.tar.gz -P /tmp/ \
+&& tar -C /tmp -xf /tmp/v0.17.0.tar.gz \
+&& (cd /tmp/snmp_exporter-0.17.0/generator && go build) \
+&& cp /tmp/snmp_exporter-0.17.0/generator/generator /usr/local/bin/snmp_generator
+
+
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/vnf_ee.py b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/vnf_ee.py
new file mode 100755
index 0000000000000000000000000000000000000000..6b1f48057f10aa954d64c0d07f9d9cffb074456e
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/source/vnf_ee.py
@@ -0,0 +1,94 @@
+##
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+# implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+##
+
+import asyncio
+import logging
+import os
+
+
+from osm_ee.exceptions import VnfException
+
+import osm_ee.util.util_ee as util_ee
+import osm_ee.util.util_ansible as util_ansible
+
+
+class VnfEE:
+    
+    PLAYBOOK_PATH = "/app/EE/osm_ee/vnf"
+
+    def __init__(self, config_params):
+        self.logger = logging.getLogger('osm_ee.vnf')
+        self.config_params = config_params
+
+    async def config(self, id, params):
+        self.logger.debug("Execute action config params: {}".format(params))
+        # Config action is special, params are merged with previous config calls
+        self.config_params.update(params)
+        required_params = ["ssh-hostname"]
+        self._check_required_params(self.config_params, required_params)
+        yield "OK", "Configured"
+
+    async def sleep(self, id, params):
+        self.logger.debug("Execute action sleep, params: {}".format(params))
+
+        for i in range(3):
+            await asyncio.sleep(5)
+            self.logger.debug("Temporal result return, params: {}".format(params))
+            yield "PROCESSING", f"Processing {i} action id {id}"
+        yield "OK", f"Processed action id {id}"
+
+    async def generate_snmp(self, id, params):
+        self.logger.debug("Executing SNMP exporter configuration generation\nWith params: {}".format(params))
+
+        commands =  ("cp /app/vnf/generator/generator.yml ./",
+                     "snmp_generator generate --output-path=/etc/snmp_exporter/snmp.yml",
+                     "touch /etc/snmp_exporter/generator.yml")
+        for command in commands:
+            return_code, stdout, stderr = await util_ee.local_async_exec(command)
+            if return_code != 0:
+                yield "ERROR", "return code {}: {}".format(return_code, stderr.decode())
+                break
+        else:
+            yield "OK", stdout.decode()
+            
+    async def ansible_playbook(self, id, params):
+        self.logger.debug("Execute action ansible_playbook, params: {}".format(params))
+
+        try:
+            self._check_required_params(params, ["playbook-name"])
+
+            params["ansible_user"] = self.config_params["ssh-username"]
+            params["ansible_password"] = self.config_params["ssh-password"]
+
+            inventory = self.config_params["ssh-hostname"] + ","
+
+            playbook = self.PLAYBOOK_PATH + "/" + params["playbook-name"]
+            os.environ["ANSIBLE_HOST_KEY_CHECKING"] = "False"
+            return_code, stdout, stderr = await util_ansible.execute_playbook(playbook, inventory, params)
+
+            status = "OK" if return_code == 0 else "ERROR"
+            yield status, stdout + stderr
+        except Exception as e:
+            self.logger.debug("Error executing ansible playbook: {}".format(repr(e)))
+            yield "ERROR", str(e)
+        
+
+    @staticmethod
+    def _check_required_params(params, required_params):
+        for required_param in required_params:
+            if required_param not in params:
+                raise VnfException("Missing required param: {}".format(required_param))
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/NOTES.txt b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/NOTES.txt
new file mode 100755
index 0000000000000000000000000000000000000000..c52fc2c419ef6f4cccfb63fd93ca7379bfc04cf7
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/NOTES.txt
@@ -0,0 +1,21 @@
+1. Get the application URL by running these commands:
+{{- if .Values.ingress.enabled }}
+{{- range $host := .Values.ingress.hosts }}
+  {{- range .paths }}
+  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ . }}
+  {{- end }}
+{{- end }}
+{{- else if contains "NodePort" .Values.service.type }}
+  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "eechart.fullname" . }})
+  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
+  echo http://$NODE_IP:$NODE_PORT
+{{- else if contains "LoadBalancer" .Values.service.type }}
+     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
+           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "eechart.fullname" . }}'
+  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "eechart.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
+  echo http://$SERVICE_IP:{{ .Values.service.port }}
+{{- else if contains "ClusterIP" .Values.service.type }}
+  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "eechart.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
+  echo "Visit http://127.0.0.1:8080 to use your application"
+  kubectl port-forward $POD_NAME 8080:80
+{{- end }}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/_helpers.tpl b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
new file mode 100755
index 0000000000000000000000000000000000000000..d3e28e0260b8bff2fdef09046df0abaea885739c
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/_helpers.tpl
@@ -0,0 +1,56 @@
+{{/* vim: set filetype=mustache: */}}
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "eechart.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Create a default fully qualified app name.
+We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
+If release name contains chart name it will be used as a full name.
+*/}}
+{{- define "eechart.fullname" -}}
+{{- if .Values.fullnameOverride -}}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- $name := default .Chart.Name .Values.nameOverride -}}
+{{- if contains $name .Release.Name -}}
+{{- .Release.Name | trunc 63 | trimSuffix "-" -}}
+{{- else -}}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+{{- end -}}
+{{- end -}}
+
+{{/*
+Create chart name and version as used by the chart label.
+*/}}
+{{- define "eechart.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" -}}
+{{- end -}}
+
+{{/*
+Common labels
+*/}}
+{{- define "eechart.labels" -}}
+app.kubernetes.io/name: {{ include "eechart.name" . }}
+helm.sh/chart: {{ include "eechart.chart" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end -}}
+
+{{/*
+Create the name of the service account to use
+*/}}
+{{- define "eechart.serviceAccountName" -}}
+{{- if .Values.serviceAccount.create -}}
+    {{ default (include "eechart.fullname" .) .Values.serviceAccount.name }}
+{{- else -}}
+    {{ default "default" .Values.serviceAccount.name }}
+{{- end -}}
+{{- end -}}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/configmap.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/configmap.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..5b9634c7e1abe64c6f720f708dd5c9664e72e8cf
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/configmap.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "eechart.fullname" . }}
+data:
+{{ (.Files.Glob "source/*").AsConfig | indent 2 }}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/generator.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/generator.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..96f7e237d85cecfba6f7047c169ba09fdcb8865e
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/generator.yaml
@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower }}"
+data:
+  generator.yml: |-
+    {{ .Files.Get "snmp/generator.yml" | nindent 4}}
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/ingress.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/ingress.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..264f89091bee2ba8746edc2841c275d28fef1168
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/ingress.yaml
@@ -0,0 +1,41 @@
+{{- if .Values.ingress.enabled -}}
+{{- $fullName := include "eechart.fullname" . -}}
+{{- $svcPort := .Values.service.port -}}
+{{- if semverCompare ">=1.14-0" .Capabilities.KubeVersion.GitVersion -}}
+apiVersion: networking.k8s.io/v1beta1
+{{- else -}}
+apiVersion: extensions/v1beta1
+{{- end }}
+kind: Ingress
+metadata:
+  name: {{ $fullName }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  {{- with .Values.ingress.annotations }}
+  annotations:
+    {{- toYaml . | nindent 4 }}
+  {{- end }}
+spec:
+{{- if .Values.ingress.tls }}
+  tls:
+  {{- range .Values.ingress.tls }}
+    - hosts:
+      {{- range .hosts }}
+        - {{ . | quote }}
+      {{- end }}
+      secretName: {{ .secretName }}
+  {{- end }}
+{{- end }}
+  rules:
+  {{- range .Values.ingress.hosts }}
+    - host: {{ .host | quote }}
+      http:
+        paths:
+        {{- range .paths }}
+          - path: {{ . }}
+            backend:
+              serviceName: {{ $fullName }}
+              servicePort: {{ $svcPort }}
+        {{- end }}
+  {{- end }}
+{{- end }}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/mibs.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/mibs.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..e7b5eab55038ea9e0d17d7c8d0b9fc7dc15ddfe6
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/mibs.yaml
@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+data:
+{{ (.Files.Glob "snmp/mibs/**").AsConfig | indent 2 }}
\ No newline at end of file
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/service.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/service.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..88d38d66a3997c6e2a96754582736cfb065da6c2
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/service.yaml
@@ -0,0 +1,16 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  type: {{ .Values.service.type }}
+  ports:
+    - port: {{ .Values.service.port }}
+      targetPort: grpc
+      protocol: TCP
+      name: grpc
+  selector:
+    app.kubernetes.io/name: {{ include "eechart.name" . }}
+    app.kubernetes.io/instance: {{ .Release.Name }}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..be615a5f08c7b557446fa74e5e3619e47d2ee804
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/serviceaccount.yaml
@@ -0,0 +1,8 @@
+{{- if .Values.serviceAccount.create -}}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ template "eechart.serviceAccountName" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+{{- end -}}
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/statefulset.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..1868dd86fb480df75f76427c9211475d816ca855
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/statefulset.yaml
@@ -0,0 +1,61 @@
+apiVersion: apps/v1
+kind: StatefulSet
+metadata:
+  name: {{ include "eechart.fullname" . }}
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+spec:
+  serviceName:  {{ include "eechart.fullname" . }} 
+  replicas: {{ .Values.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: {{ include "eechart.name" . }}
+      app.kubernetes.io/instance: {{ .Release.Name }}
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: {{ include "eechart.name" . }}
+        app.kubernetes.io/instance: {{ .Release.Name }}
+    spec:
+      imagePullSecrets:
+      - name: regcred 
+      serviceAccountName: {{ template "eechart.serviceAccountName" . }}
+      securityContext:
+        runAsUser: 0
+      containers:
+        - name: {{ .Chart.Name }}
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          ports:
+            - name: grpc
+              containerPort: 50051
+              protocol: TCP          
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}          
+          volumeMounts:
+          - name: osm-ee
+            mountPath: /app/storage  
+          - name: osm-ee-source
+            mountPath: /app/EE/osm_ee/vnf      
+          - name: snmp-config-volume
+            mountPath: /etc/snmp_exporter
+          - name: vnf-mibs
+            mountPath: /root/.snmp/mibs
+          - name: vnf-generator
+            mountPath: /app/vnf/generator
+      volumes:      
+      - name: osm-ee-source
+        configMap: 
+          name:  {{ include "eechart.fullname" . }}
+      - name: snmp-config-volume
+        hostPath: 
+          path: "/var/lib/osm/snmp_exporter/{{ .Values.global.osm.vnf_id | lower }}/"
+      - name: vnf-mibs
+        configMap:
+          name: "vnf-snmp-mibs-{{ .Values.global.osm.vnf_id | lower}}"
+      - name: vnf-generator
+        configMap:
+          name: "vnf-snmp-generator-{{ .Values.global.osm.vnf_id | lower}}"
+      - name: osm-ee
+        hostPath:
+          path: /var/lib/osm/osm/osm_osm_packages/_data
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..e52b7b8b2515729e582b5efbc22dc5a0bdb0f3b2
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/templates/tests/test-connection.yaml
@@ -0,0 +1,15 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: "{{ include "eechart.fullname" . }}-test-connection"
+  labels:
+{{ include "eechart.labels" . | indent 4 }}
+  annotations:
+    "helm.sh/hook": test-success
+spec:
+  containers:
+    - name: wget
+      image: busybox
+      command: ['wget']
+      args:  ['{{ include "eechart.fullname" . }}:{{ .Values.service.port }}']
+  restartPolicy: Never
diff --git a/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/values.yaml b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/values.yaml
new file mode 100755
index 0000000000000000000000000000000000000000..7006b5df1ac6ad4972e7f9a535f26ebff21176ae
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/helm-charts/eechart/values.yaml
@@ -0,0 +1,72 @@
+global:
+  osm:
+    vnf_id: AVNFId
+
+# Default values for eechart.
+# This is a YAML-formatted file.
+# Declare variables to be passed into your templates.
+
+replicaCount: 1
+
+image:
+  repository: illoret/grpcee
+  tag: latest
+  pullPolicy: IfNotPresent
+
+imagePullSecrets: []
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  # Specifies whether a service account should be created
+  create: false
+  # The name of the service account to use.
+  # If not set and create is true, a name is generated using the fullname template
+  name:
+
+podSecurityContext: {}
+  # fsGroup: 2000
+
+securityContext: {}
+  # capabilities:
+  #   drop:
+  #   - ALL
+  # readOnlyRootFilesystem: true
+  # runAsNonRoot: true
+  # runAsUser: 1000
+
+service:
+  type: ClusterIP
+  port: 50050
+
+ingress:
+  enabled: false
+  annotations: {}
+    # kubernetes.io/ingress.class: nginx
+    # kubernetes.io/tls-acme: "true"
+  hosts:
+    - host: chart-example.local
+      paths: []
+
+  tls: []
+  #  - secretName: chart-example-tls
+  #    hosts:
+  #      - chart-example.local
+
+resources: {}
+  # We usually recommend not to specify default resources and to leave this as a conscious
+  # choice for the user. This also increases chances charts run on environments with little
+  # resources, such as Minikube. If you do want to specify resources, uncomment the following
+  # lines, adjust them as necessary, and remove the curly braces after 'resources:'.
+  # limits:
+  #   cpu: 100m
+  #   memory: 128Mi
+  # requests:
+  #   cpu: 100m
+  #   memory: 128Mi
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity: {}
diff --git a/SOL004/snmp_setcomm_ee_vnf/snmp_setcomm_ee_vnfd.yaml b/SOL004/snmp_setcomm_ee_vnf/snmp_setcomm_ee_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8eceee811cf94ec2e9f03984782bc767c65c5f17
--- /dev/null
+++ b/SOL004/snmp_setcomm_ee_vnf/snmp_setcomm_ee_vnfd.yaml
@@ -0,0 +1,112 @@
+vnfd:
+  description: A basic virtual router with SNMP metrics collection
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: vyos-VM
+    vdu-profile:
+    - id: vyos-VM
+      min-number-of-instances: 1
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-primitive:
+          - execution-environment-ref: monitor
+            name: generate_snmp
+          - execution-environment-primitive: ansible_playbook
+            execution-environment-ref: monitor
+            name: ansible_playbook
+            parameter:
+            - data-type: STRING
+              default-value: playbook.yaml
+              name: playbook-name
+          execution-environment-list:
+          - external-connection-point-ref: vnf-mgmt-ext
+            helm-chart: eechart
+            id: monitor
+            metric-service: snmpexporter
+          id: snmp_setcomm_ee-vnf
+          initial-config-primitive:
+          - execution-environment-ref: monitor
+            name: config
+            parameter:
+            - name: ssh-hostname
+              value: <rw_mgmt_ip>
+            - name: ssh-username
+              value: osm
+            - name: ssh-password
+              value: osm2020
+            seq: 1
+          - execution-environment-ref: monitor
+            name: generate_snmp
+            seq: 2
+          - execution-environment-ref: monitor
+            name: ansible_playbook
+            parameter:
+            - name: playbook-name
+              value: community.yaml
+            - name: snmp_community
+              value: secret
+            seq: 3
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: vdu-eth0-int
+      vdu-id: vyos-VM
+  - id: vnf-internal-ext
+    int-cpd:
+      cpd: vdu-eth1-int
+      vdu-id: vyos-VM
+  - id: vnf-external-ext
+    int-cpd:
+      cpd: vdu-eth2-int
+      vdu-id: vyos-VM
+  id: snmp_setcomm_ee-vnf
+  mgmt-cp: vnf-mgmt-ext
+  product-name: snmp_setcomm_ee-vnf
+  sw-image-desc:
+  - id: vyos-1.1.7
+    image: vyos-1.1.7
+    name: vyos-1.1.7
+  vdu:
+  - cloud-init-file: vyos-userdata
+    id: vyos-VM
+    int-cpd:
+    - id: vdu-eth0-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth0
+        position: 0
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth1-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth1
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: vdu-eth2-int
+      virtual-network-interface-requirement:
+      - name: vdu-eth2
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: vyos-VM
+    supplemental-boot-data:
+      boot-data-drive: true
+    sw-image-desc: vyos-1.1.7
+    virtual-compute-desc: vyos-VM-compute
+    virtual-storage-desc:
+    - vyos-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: vyos-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: vyos-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/ubuntu_cloudinit_ns/README b/SOL004/ubuntu_cloudinit_ns/README
new file mode 100644
index 0000000000000000000000000000000000000000..eeb8e117ba11d728b9825f77976fc7207971d8c3
--- /dev/null
+++ b/SOL004/ubuntu_cloudinit_ns/README
@@ -0,0 +1,2 @@
+Descriptor created by OSM descriptor package generated
+Created on Mon May 27 13:17:59 UTC 2019
diff --git a/SOL004/ubuntu_cloudinit_ns/ubuntu_cloudinit_nsd.yaml b/SOL004/ubuntu_cloudinit_ns/ubuntu_cloudinit_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..ea9b4239978cd58fbdbafd47ae7f31156a7e27e7
--- /dev/null
+++ b/SOL004/ubuntu_cloudinit_ns/ubuntu_cloudinit_nsd.yaml
@@ -0,0 +1,22 @@
+nsd:
+  nsd:
+  - description: Generated by OSM package generator
+    designer: OSM
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: '1'
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: '1'
+            constituent-cpd-id: vnf-cp0-ext
+          virtual-link-profile-id: mgmtnet
+        vnfd-id: ubuntu_cloudinit-vnf
+    id: ubuntu_cloudinit-ns
+    name: ubuntu_cloudinit-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    vnfd-id:
+    - ubuntu_cloudinit-vnf
diff --git a/SOL004/ubuntu_cloudinit_vnf/README b/SOL004/ubuntu_cloudinit_vnf/README
new file mode 100644
index 0000000000000000000000000000000000000000..55a357d6ae53865bca7298288735a962fe4d3cad
--- /dev/null
+++ b/SOL004/ubuntu_cloudinit_vnf/README
@@ -0,0 +1,2 @@
+Descriptor created by OSM descriptor package generated
+Created on Mon May 27 13:11:46 UTC 2019
diff --git a/SOL004/ubuntu_cloudinit_vnf/cloud_init/cloud-init.cfg b/SOL004/ubuntu_cloudinit_vnf/cloud_init/cloud-init.cfg
new file mode 100644
index 0000000000000000000000000000000000000000..fae0cf1a8ec349186a29a2b0ed2373285044d9b8
--- /dev/null
+++ b/SOL004/ubuntu_cloudinit_vnf/cloud_init/cloud-init.cfg
@@ -0,0 +1,5 @@
+#cloud-config
+password: {{ password }}
+chpasswd: { expire: False }
+ssh_pwauth: True
+
diff --git a/SOL004/ubuntu_cloudinit_vnf/ubuntu_cloudinit_vnfd.yaml b/SOL004/ubuntu_cloudinit_vnf/ubuntu_cloudinit_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..5159b5a900b23a809e03786d4b2d60808d9b9ef2
--- /dev/null
+++ b/SOL004/ubuntu_cloudinit_vnf/ubuntu_cloudinit_vnfd.yaml
@@ -0,0 +1,50 @@
+vnfd:
+  description: Generated by OSM package generator
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: ubuntu_cloudinit-vnf-VM
+    vdu-profile:
+    - id: ubuntu_cloudinit-vnf-VM
+      min-number-of-instances: 1
+  ext-cpd:
+  - id: vnf-cp0-ext
+    int-cpd:
+      cpd: eth0-int
+      vdu-id: ubuntu_cloudinit-vnf-VM
+  id: ubuntu_cloudinit-vnf
+  mgmt-cp: vnf-cp0-ext
+  product-name: ubuntu_cloudinit-vnf
+  provider: OSM
+  sw-image-desc:
+  - id: ubuntu16.04
+    image: ubuntu16.04
+    name: ubuntu16.04
+  vdu:
+  - cloud-init-file: cloud-init.cfg
+    description: ubuntu_cloudinit-vnf-VM
+    id: ubuntu_cloudinit-vnf-VM
+    int-cpd:
+    - id: eth0-int
+      virtual-network-interface-requirement:
+      - name: eth0
+        virtual-interface:
+          type: PARAVIRT
+    name: ubuntu_cloudinit-vnf-VM
+    sw-image-desc: ubuntu16.04
+    virtual-compute-desc: ubuntu_cloudinit-vnf-VM-compute
+    virtual-storage-desc:
+    - ubuntu_cloudinit-vnf-VM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: ubuntu_cloudinit-vnf-VM-compute
+    virtual-cpu:
+      num-virtual-cpu: 2
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: ubuntu_cloudinit-vnf-VM-storage
+    size-of-storage: 10
diff --git a/SOL004/vdu_replicas_ns/icons/osm.png b/SOL004/vdu_replicas_ns/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/vdu_replicas_ns/icons/osm.png differ
diff --git a/SOL004/vdu_replicas_ns/vdu_replicas_nsd.yaml b/SOL004/vdu_replicas_ns/vdu_replicas_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a3f2599c68805730730b8228baeb1a3ce35bbe4c
--- /dev/null
+++ b/SOL004/vdu_replicas_ns/vdu_replicas_nsd.yaml
@@ -0,0 +1,37 @@
+nsd:
+  nsd:
+  - description: NS with 2 VNFs connected by datanet and mgmtnet VLs
+    df:
+    - id: default-df
+      vnf-profile:
+      - id: vnf1
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: vnf1
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: vnf1
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: vdu-replicas-vnf
+      - id: vnf2
+        virtual-link-connectivity:
+        - constituent-cpd-id:
+          - constituent-base-element-id: vnf2
+            constituent-cpd-id: vnf-mgmt-ext
+          virtual-link-profile-id: mgmtnet
+        - constituent-cpd-id:
+          - constituent-base-element-id: vnf2
+            constituent-cpd-id: vnf-data-ext
+          virtual-link-profile-id: datanet
+        vnfd-id: vdu-replicas-vnf
+    id: vdu-replicas-ns
+    name: vdu-replicas-ns
+    version: '1.0'
+    virtual-link-desc:
+    - id: mgmtnet
+      mgmt-network: true
+    - id: datanet
+    vnfd-id:
+    - vdu-replicas-vnf
diff --git a/SOL004/vdu_replicas_vnf/cloud_init/cloud-config.txt b/SOL004/vdu_replicas_vnf/cloud_init/cloud-config.txt
new file mode 100755
index 0000000000000000000000000000000000000000..5a90d5ae6291c84b3cdcc2063135e5f9ac92fd9c
--- /dev/null
+++ b/SOL004/vdu_replicas_vnf/cloud_init/cloud-config.txt
@@ -0,0 +1,30 @@
+#cloud-config
+password: osm4u
+chpasswd: { expire: False }
+ssh_pwauth: True
+
+write_files:
+-   content: |
+        # Example of jinja2 template for parsing OSM variables
+
+        I am vdu_id='{{ OSM.vdu_id }}' count_index='{{ OSM.count_index }}' ip_address='{{ OSM.ip_address|default('not set') }}'
+        Parameters:
+         ns_id: {{ OSM.ns_id }}
+         vnf_id: {{ OSM.vnf_id }}
+         member_vnf_index: {{ OSM.member_vnf_index }}
+         list of vdus:{% for vdu_id_index,vdu in OSM.vdu.items() %}
+          vdu {{ vdu_id_index }}:
+            vdu_id: {{ vdu.vdu_id }}
+            count_index: {{ vdu.count_index }}
+            ip_address: {{ vdu.ip_address|default('not set') }}
+            interfaces:{% for iface_id,iface in vdu.interfaces.items() %}
+              iface='{{ iface_id }}' ip_address='{{ iface.ip_address|default('no ip') }} mac_adress={{ iface.mac_address|default('no mac') }}'{% endfor %}
+        {% endfor %}
+
+        global variable OSM:
+        """{{ OSM|default('OSM variable is not defined') }}"""
+
+    owner: ubuntu:ubuntu
+    permissions: '0644'
+    path: /home/ubuntu/helloworld.txt
+
diff --git a/SOL004/vdu_replicas_vnf/icons/osm.png b/SOL004/vdu_replicas_vnf/icons/osm.png
new file mode 100644
index 0000000000000000000000000000000000000000..62012d2a2b491bdcd536d62c3c3c863c0d8c1b33
Binary files /dev/null and b/SOL004/vdu_replicas_vnf/icons/osm.png differ
diff --git a/SOL004/vdu_replicas_vnf/vdu_replicas_vnfd.yaml b/SOL004/vdu_replicas_vnf/vdu_replicas_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..8c7fbc1eb806723591690bd7dbb15d9014cdd962
--- /dev/null
+++ b/SOL004/vdu_replicas_vnf/vdu_replicas_vnfd.yaml
@@ -0,0 +1,130 @@
+vnfd:
+  description: A VNF with 2 replicas of vdu, internal vld and scaling
+  df:
+  - id: default-df
+    instantiation-level:
+    - id: default-instantiation-level
+      vdu-level:
+      - number-of-instances: 1
+        vdu-id: mgmtVM
+      - number-of-instances: 1
+        vdu-id: dataVM
+    scaling-aspect:
+    - aspect-delta-details:
+        deltas:
+        - id: scale_dataVM-delta
+          vdu-delta:
+          - id: dataVM
+            number-of-instances: 2
+      id: scale_dataVM
+      max-scale-level: 10
+      name: scale_dataVM
+    vdu-profile:
+    - id: mgmtVM
+      min-number-of-instances: 1
+    - id: dataVM
+      max-number-of-instances: 10
+      min-number-of-instances: 2
+    virtual-link-profile:
+    - flavour: ''
+      id: interdata
+      virtual-link-protocol-data:
+        l3-protocol-data:
+          cidr: 192.168.101.0/24
+          description: internal data
+          ip-version: ipv4
+          name: interdata-l3-protocol-data
+    lcm-operations-configuration:
+      operate-vnf-op-config:
+        day1-2:
+        - config-access:
+            ssh-access:
+              default-user: ubuntu
+              required: true
+          id: vdu-replicas-vnf
+  ext-cpd:
+  - id: vnf-mgmt-ext
+    int-cpd:
+      cpd: mgmtVM-eth0-int
+      vdu-id: mgmtVM
+  - id: vnf-data-ext
+    int-cpd:
+      cpd: dataVM-xe0-int
+      vdu-id: dataVM
+  id: vdu-replicas-vnf
+  int-virtual-link-desc:
+  - id: internal
+  - id: interdata
+  mgmt-cp: vnf-mgmt-ext
+  product-name: vdu-replicas-vnf
+  sw-image-desc:
+  - id: ubuntu18.04
+    image: ubuntu18.04
+    name: ubuntu18.04
+  vdu:
+  - cloud-init-file: cloud-config.txt
+    id: mgmtVM
+    int-cpd:
+    - id: mgmtVM-eth0-int
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: mgmtVM-eth1-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: mgmtVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    name: mgmtVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: mgmtVM-compute
+    virtual-storage-desc:
+    - mgmtVM-storage
+  - cloud-init-file: cloud-config.txt
+    id: dataVM
+    int-cpd:
+    - id: dataVM-eth0-int
+      int-virtual-link-desc: internal
+      virtual-network-interface-requirement:
+      - name: dataVM-eth0
+        position: 1
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-eth1-int
+      int-virtual-link-desc: interdata
+      virtual-network-interface-requirement:
+      - name: dataVM-eth1
+        position: 2
+        virtual-interface:
+          type: PARAVIRT
+    - id: dataVM-xe0-int
+      virtual-network-interface-requirement:
+      - name: dataVM-xe0
+        position: 3
+        virtual-interface:
+          type: PARAVIRT
+    name: dataVM
+    sw-image-desc: ubuntu18.04
+    virtual-compute-desc: dataVM-compute
+    virtual-storage-desc:
+    - dataVM-storage
+  version: '1.0'
+  virtual-compute-desc:
+  - id: mgmtVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 2.0
+  - id: dataVM-compute
+    virtual-cpu:
+      num-virtual-cpu: 1
+    virtual-memory:
+      size: 2.0
+  virtual-storage-desc:
+  - id: mgmtVM-storage
+    size-of-storage: 10
+  - id: dataVM-storage
+    size-of-storage: 10
diff --git a/SOL004/wiki_webserver_autoscale_nsd/wiki_webserver_autoscale_nsd.yaml b/SOL004/wiki_webserver_autoscale_nsd/wiki_webserver_autoscale_nsd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..995235ddd54c9f8c7c63a2fc4e14415738e55b07
--- /dev/null
+++ b/SOL004/wiki_webserver_autoscale_nsd/wiki_webserver_autoscale_nsd.yaml
@@ -0,0 +1,33 @@
+nsd:
+    nsd:
+    -   description: Scaling wiki web server with load balancer NS
+        designer: Altran
+        df:
+        -   id: default-df
+            vnf-profile:
+            -   id: '1'
+                virtual-link-connectivity:
+                -   constituent-cpd-id:
+                    -   constituent-base-element-id: '1'
+                        constituent-cpd-id: haproxy_mgmt-ext
+                    -   constituent-base-element-id: '1'
+                        constituent-cpd-id: apache_mgmt-ext
+                    virtual-link-profile-id: mgmt_vld
+                -   constituent-cpd-id:
+                    -   constituent-base-element-id: '1'
+                        constituent-cpd-id: haproxy_public-ext
+                    virtual-link-profile-id: public_vld
+                vnfd-id: wiki_webserver_autoscale_vnf
+        id: wiki_webserver_autoscale_ns
+        name: wiki_webserver_autoscale_ns
+        version: '1.0'
+        virtual-link-desc:
+        -   id: mgmt_vld
+            mgmt-network: 'true'
+            vim-network-name: mgntnet
+        -   id: public_vld
+            mgmt-network: 'true'
+            vim-network-name: osm-ext
+        vnfd-id:
+        - wiki_webserver_autoscale_vnf
+
diff --git a/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/.DS_Store b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6
Binary files /dev/null and b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/.DS_Store differ
diff --git a/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_apache b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_apache
new file mode 100644
index 0000000000000000000000000000000000000000..92dcba0c8d0cf8b602a523616c962641d103547f
--- /dev/null
+++ b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_apache
@@ -0,0 +1,5 @@
+#cloud-config
+hostname: apachevdu
+password: osm2021
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_haproxy b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_haproxy
new file mode 100644
index 0000000000000000000000000000000000000000..8995804f53e6e074d66a83e6994411977fa8fd5a
--- /dev/null
+++ b/SOL004/wiki_webserver_autoscale_vnfd/cloud_init/cloud_init_haproxy
@@ -0,0 +1,5 @@
+#cloud-config
+hostname: haproxyvdu
+password: osm2021
+chpasswd: { expire: False }
+ssh_pwauth: True
diff --git a/SOL004/wiki_webserver_autoscale_vnfd/wiki_webserver_autoscale_vnfd.yaml b/SOL004/wiki_webserver_autoscale_vnfd/wiki_webserver_autoscale_vnfd.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..7f10921e99ed2b712e84016539bfbd25fccb8278
--- /dev/null
+++ b/SOL004/wiki_webserver_autoscale_vnfd/wiki_webserver_autoscale_vnfd.yaml
@@ -0,0 +1,158 @@
+vnfd:
+    description: Scaling wiki web server with load balancer and metrics
+    df:
+    -   id: default-df
+        instantiation-level:
+        -   id: default-instantiation-level
+            vdu-level:
+            -   number-of-instances: 1
+                vdu-id: haproxy_vdu
+            -   number-of-instances: 1
+                vdu-id: apache_vdu
+        scaling-aspect:
+        -   aspect-delta-details:
+                deltas:
+                -   id: apache_vdu_autoscale-delta
+                    vdu-delta:
+                    -   id: apache_vdu
+                        number-of-instances: 1
+            id: apache_vdu_autoscale
+            max-scale-level: 10
+            name: apache_vdu_autoscale
+            scaling-policy:
+            -   cooldown-time: 180
+                name: apache_cpu_util_above_threshold
+                scaling-criteria:
+                -   name: apache_cpu_util_above_threshold
+                    scale-in-relational-operation: LT
+                    scale-in-threshold: 20
+                    scale-out-relational-operation: GT
+                    scale-out-threshold: 80
+                    vnf-monitoring-param-ref: apache_vnf_cpu_util
+                scaling-type: automatic
+                threshold-time: 10
+        vdu-profile:
+        -   id: haproxy_vdu
+            min-number-of-instances: 1
+        -   id: apache_vdu
+            max-number-of-instances: 11
+            min-number-of-instances: 1
+        virtual-link-profile:
+        -   flavour: ''
+            id: internal_services
+            virtual-link-protocol-data:
+                l3-protocol-data:
+                    cidr: 192.168.30.0/24
+                    description: Services Subnet
+                    dhcp-enabled: true
+                    gateway-ip: 192.168.30.1
+                    ip-version: ipv4
+                    name: internal_services-l3-protocol-data
+    ext-cpd:
+    -   id: haproxy_public-ext
+        int-cpd:
+            cpd: haproxy_vdu_eth1-int
+            vdu-id: haproxy_vdu
+    -   id: haproxy_mgmt-ext
+        int-cpd:
+            cpd: haproxy_vdu_eth0-int
+            vdu-id: haproxy_vdu
+    -   id: apache_mgmt-ext
+        int-cpd:
+            cpd: apache_vdu_eth0-int
+            vdu-id: apache_vdu
+    id: wiki_webserver_autoscale_vnf
+    int-virtual-link-desc:
+    -   id: internal_services
+    mgmt-cp: haproxy_mgmt-ext
+    product-name: wiki_webserver_autoscale_vnf
+    provider: Altran
+    sw-image-desc:
+    -   id: haproxy_ubuntu
+        image: haproxy_ubuntu
+        name: haproxy_ubuntu
+    -   id: apache_ubuntu
+        image: apache_ubuntu
+        name: apache_ubuntu
+    vdu:
+    -   cloud-init-file: cloud_init_haproxy
+        description: haproxy_vdu
+        id: haproxy_vdu
+        int-cpd:
+        -   id: haproxy_vdu_eth1-int
+            virtual-network-interface-requirement:
+            -   name: haproxy_vdu_eth1
+                position: 1
+                virtual-interface:
+                    type: VIRTIO
+        -   id: haproxy_vdu_eth0-int
+            virtual-network-interface-requirement:
+            -   name: haproxy_vdu_eth0
+                position: 2
+                virtual-interface:
+                    type: VIRTIO
+        -   id: haproxy_vdu_eth2-int
+            int-virtual-link-desc: internal_services
+            virtual-network-interface-requirement:
+            -   name: haproxy_vdu_eth2
+                position: 3
+                virtual-interface:
+                    type: VIRTIO
+        name: haproxy_vdu
+        sw-image-desc: haproxy_ubuntu
+        virtual-compute-desc: haproxy_vdu-compute
+        virtual-storage-desc:
+        - haproxy_vdu-storage
+    -   cloud-init-file: cloud_init_apache
+        description: apache_vdu
+        id: apache_vdu
+        int-cpd:
+        -   id: apache_vdu_eth0-int
+            virtual-network-interface-requirement:
+            -   name: apache_vdu_eth0
+                position: 1
+                virtual-interface:
+                    type: VIRTIO
+        -   id: apache_vdu_eth1-int
+            int-virtual-link-desc: internal_services
+            virtual-network-interface-requirement:
+            -   name: apache_vdu_eth1
+                position: 2
+                virtual-interface:
+                    type: VIRTIO
+        monitoring-parameter:
+        -   id: apache_vnf_cpu_util
+            name: apache_vnf_cpu_util
+            performance-metric: cpu_utilization
+        -   id: apache_vnf_memory_util
+            name: apache_vnf_memory_util
+            performance-metric: average_memory_utilization
+        -   id: apache_vnf_packets_sent
+            name: apache_vnf_packets_sent
+            performance-metric: packets_sent
+        -   id: apache_vnf_packets_received
+            name: apache_vnf_packets_received
+            performance-metric: packets_received
+        name: apache_vdu
+        sw-image-desc: apache_ubuntu
+        virtual-compute-desc: apache_vdu-compute
+        virtual-storage-desc:
+        - apache_vdu-storage
+    version: '2.1'
+    virtual-compute-desc:
+    -   id: haproxy_vdu-compute
+        virtual-cpu:
+            num-virtual-cpu: 4
+        virtual-memory:
+            size: 4.0
+    -   id: apache_vdu-compute
+        virtual-cpu:
+            num-virtual-cpu: 1
+        virtual-memory:
+            size: 1.0
+    virtual-storage-desc:
+    -   id: haproxy_vdu-storage
+        size-of-storage: 10
+    -   id: apache_vdu-storage
+        size-of-storage: 10
+